Merge remote-tracking branch 'upstream/develop' into feat/maintenance-page
This commit is contained in:
commit
f48b769baa
6 files changed
+56
-222
No files matched your search
@@ -1,16 +1,22 @@
|
|||||||
import axios from "axios";
|
import axios from "axios";
|
||||||
const BASE_URL = import.meta.env.VITE_APP_API_BASE_URL;
|
const BASE_URL = import.meta.env.VITE_APP_API_BASE_URL;
|
||||||
const FALLBACK_BASE_URL = "http://localhost:5000/api/v1";
|
const FALLBACK_BASE_URL = "http://localhost:5000/api/v1";
|
||||||
|
import { clearAuthState } from "../Features/Auth/authSlice";
|
||||||
|
import { clearUptimeMonitorState } from "../Features/UptimeMonitors/uptimeMonitorsSlice";
|
||||||
import { logger } from "./Logger";
|
import { logger } from "./Logger";
|
||||||
class NetworkService {
|
class NetworkService {
|
||||||
constructor(store) {
|
constructor(store, dispatch, navigate) {
|
||||||
this.store = store;
|
this.store = store;
|
||||||
|
this.dispatch = dispatch;
|
||||||
|
this.navigate = navigate;
|
||||||
let baseURL = BASE_URL;
|
let baseURL = BASE_URL;
|
||||||
this.axiosInstance = axios.create();
|
this.axiosInstance = axios.create();
|
||||||
this.setBaseUrl(baseURL);
|
this.setBaseUrl(baseURL);
|
||||||
this.unsubscribe = store.subscribe(() => {
|
this.unsubscribe = store.subscribe(() => {
|
||||||
const state = store.getState();
|
const state = store.getState();
|
||||||
if (BASE_URL === undefined && state.settings.apiBaseUrl) {
|
if (BASE_URL !== undefined) {
|
||||||
|
baseURL = BASE_URL;
|
||||||
|
} else if (state?.settings?.apiBaseUrl ?? null) {
|
||||||
baseURL = state.settings.apiBaseUrl;
|
baseURL = state.settings.apiBaseUrl;
|
||||||
} else {
|
} else {
|
||||||
baseURL = FALLBACK_BASE_URL;
|
baseURL = FALLBACK_BASE_URL;
|
||||||
@@ -20,9 +26,10 @@ class NetworkService {
|
|||||||
this.axiosInstance.interceptors.response.use(
|
this.axiosInstance.interceptors.response.use(
|
||||||
(response) => response,
|
(response) => response,
|
||||||
(error) => {
|
(error) => {
|
||||||
logger.error(error);
|
|
||||||
if (error.response && error.response.status === 401) {
|
if (error.response && error.response.status === 401) {
|
||||||
logger.error("Invalid token received");
|
dispatch(clearAuthState());
|
||||||
|
dispatch(clearUptimeMonitorState());
|
||||||
|
navigate("/login");
|
||||||
}
|
}
|
||||||
return Promise.reject(error);
|
return Promise.reject(error);
|
||||||
}
|
}
|
||||||
@@ -750,3 +757,10 @@ class NetworkService {
|
|||||||
}
|
}
|
||||||
|
|
||||||
export default NetworkService;
|
export default NetworkService;
|
||||||
|
|
||||||
|
let networkService;
|
||||||
|
|
||||||
|
export const setNetworkService = (service) => {
|
||||||
|
networkService = service;
|
||||||
|
};
|
||||||
|
export { networkService };
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
import { useDispatch } from "react-redux";
|
||||||
|
import { useNavigate } from "react-router";
|
||||||
|
import { setNetworkService } from "./NetworkService";
|
||||||
|
import NetworkService from "./NetworkService";
|
||||||
|
import { store } from "../store";
|
||||||
|
|
||||||
|
const NetworkServiceProvider = ({ children }) => {
|
||||||
|
const dispatch = useDispatch();
|
||||||
|
const navigate = useNavigate();
|
||||||
|
const networkService = new NetworkService(store, dispatch, navigate);
|
||||||
|
setNetworkService(networkService);
|
||||||
|
return children;
|
||||||
|
};
|
||||||
|
|
||||||
|
export default NetworkServiceProvider;
|
||||||
+8
-5
@@ -1,18 +1,21 @@
|
|||||||
import React from "react";
|
|
||||||
import ReactDOM from "react-dom/client";
|
import ReactDOM from "react-dom/client";
|
||||||
import App from "./App.jsx";
|
import App from "./App.jsx";
|
||||||
import "./index.css";
|
import "./index.css";
|
||||||
import { BrowserRouter as Router, HashRouter } from "react-router-dom";
|
import { BrowserRouter as Router } from "react-router-dom";
|
||||||
import { Provider } from "react-redux";
|
import { Provider } from "react-redux";
|
||||||
import { persistor, store } from "./store";
|
import { persistor, store } from "./store";
|
||||||
import { PersistGate } from "redux-persist/integration/react";
|
import { PersistGate } from "redux-persist/integration/react";
|
||||||
import NetworkService from "./Utils/NetworkService.js";
|
import NetworkServiceProvider from "./Utils/NetworkServiceProvider.jsx";
|
||||||
export const networkService = new NetworkService(store);
|
import { networkService } from "./Utils/NetworkService";
|
||||||
|
export { networkService };
|
||||||
|
|
||||||
ReactDOM.createRoot(document.getElementById("root")).render(
|
ReactDOM.createRoot(document.getElementById("root")).render(
|
||||||
<Provider store={store}>
|
<Provider store={store}>
|
||||||
<PersistGate loading={null} persistor={persistor}>
|
<PersistGate loading={null} persistor={persistor}>
|
||||||
<Router>
|
<Router>
|
||||||
<App />
|
<NetworkServiceProvider>
|
||||||
|
<App />
|
||||||
|
</NetworkServiceProvider>
|
||||||
</Router>
|
</Router>
|
||||||
</PersistGate>
|
</PersistGate>
|
||||||
</Provider>
|
</Provider>
|
||||||
|
|||||||
@@ -19,7 +19,15 @@ BlueWave Uptime is an open source server monitoring application used to track th
|
|||||||
|
|
||||||
See [BlueWave Uptime](https://uptime-demo.bluewavelabs.ca/) in action. The username is uptimedemo@demo.com and the password is Demouser1!
|
See [BlueWave Uptime](https://uptime-demo.bluewavelabs.ca/) in action. The username is uptimedemo@demo.com and the password is Demouser1!
|
||||||
|
|
||||||
## Questions & Ideas
|
## User's guide
|
||||||
|
|
||||||
|
Usage instructions can be found [here](https://bluewavelabs.gitbook.io/uptime-manager).
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
See installation instructions in [Uptime Manager documentation portal](https://bluewavelabs.gitbook.io/uptime-manager/quickstart).
|
||||||
|
|
||||||
|
## Questions & ideas
|
||||||
|
|
||||||
We've just launched our [Discussions](https://github.com/bluewave-labs/bluewave-uptime/discussions) page! Feel free to ask questions or share your ideas—we'd love to hear from you!
|
We've just launched our [Discussions](https://github.com/bluewave-labs/bluewave-uptime/discussions) page! Feel free to ask questions or share your ideas—we'd love to hear from you!
|
||||||
|
|
||||||
@@ -78,215 +86,3 @@ Also check other developer and contributor-friendly projects of BlueWave:
|
|||||||
- [BlueWave DataRoom](https://github.com/bluewave-labs/bluewave-dataroom)
|
- [BlueWave DataRoom](https://github.com/bluewave-labs/bluewave-dataroom)
|
||||||
- [VerifyWise](https://github.com/bluewave-labs/verifywise)
|
- [VerifyWise](https://github.com/bluewave-labs/verifywise)
|
||||||
|
|
||||||
## Getting Started
|
|
||||||
|
|
||||||
- Clone this repository to your local machine
|
|
||||||
|
|
||||||
1. [Quickstart for Users](#user-quickstart)
|
|
||||||
2. [Quickstart for Developers](#dev-quickstart)
|
|
||||||
3. [Manual Install](#manual-install)
|
|
||||||
|
|
||||||
- [Install Client](#install-client)
|
|
||||||
- [Environment](#env-vars-client)
|
|
||||||
- [Start Client](#start-client)
|
|
||||||
- [Install Server](#install-server)
|
|
||||||
- [Environment](#env-vars-server)
|
|
||||||
- [Database](#databases)
|
|
||||||
- [(Optional) Dockerised Databases](#optional-docker-databases)
|
|
||||||
- [Start Server](#start-server)
|
|
||||||
|
|
||||||
4. [API Documentation](#api-documentation)
|
|
||||||
5. [Error Handling](#error-handling)
|
|
||||||
6. [Contributors](#contributors)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## <u> Quickstart for Users</u><a id="user-quickstart"></a>
|
|
||||||
|
|
||||||
1. Download our [Docker Compose File](/Docker/dist/docker-compose.yaml)
|
|
||||||
2. Run `docker compose up` to start the application
|
|
||||||
3. Application is running at `http://localhost`
|
|
||||||
|
|
||||||
## <u>Quickstart for Developers</u> <a id="dev-quickstart"></a>
|
|
||||||
|
|
||||||
<span style="color: red; font-weight: bold;">MAKE SURE YOU CD TO THE SPECIFIED DIRECTORIES AS PATHS IN COMMANDS ARE RELATIVE</span>
|
|
||||||
|
|
||||||
### Cloning and Initial Setup
|
|
||||||
|
|
||||||
1. Clone this repository
|
|
||||||
2. Checkout the `develop` branch `git checkout develop`
|
|
||||||
|
|
||||||
### Docker Images Setup
|
|
||||||
|
|
||||||
3. <span style="color: red; font-weight: bold;">CD</span> to the `Docker/dev` directory
|
|
||||||
4. Run `docker run -d -p 6379:6379 -v $(pwd)/redis/data:/data --name uptime_redis uptime_redis`
|
|
||||||
5. Run `docker run -d -p 27017:27017 -v $(pwd)/mongo/data:/data/db --name uptime_database_mongo uptime_database_mongo`
|
|
||||||
|
|
||||||
### Server Setup
|
|
||||||
|
|
||||||
6. <span style="color: red; font-weight: bold;">CD</span> to `Server` directory, run `npm install`
|
|
||||||
7. While in `Server` directory, create a `.env` file with the [required environmental variables](#env-vars-server)
|
|
||||||
8. While in the `Server` directory, run `npm run dev`
|
|
||||||
|
|
||||||
### Client Setup
|
|
||||||
|
|
||||||
9. <span style="color: red; font-weight: bold;">CD</span> to `Client` directory `run npm install`
|
|
||||||
10. While in the `Client` directory, create a `.env` file with the [required environmental variables](#env-vars-client)
|
|
||||||
11. While in the `Client` cirectory run `npm run dev`
|
|
||||||
|
|
||||||
### Access Application
|
|
||||||
|
|
||||||
12. Client is running at `localhost:5173`
|
|
||||||
13. Server is running at `localhost:5000`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## <u>Manual Install</u> <a id="manual-install"></a>
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Client Installation<a id="install-client"></a>
|
|
||||||
|
|
||||||
1. Change directory to the `Client` directory
|
|
||||||
2. Install all dependencies by running `npm install`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Environmental Variables <a id="env-vars-client"></a>
|
|
||||||
|
|
||||||
| ENV Variable Name | Required/Optional | Type | Description | Accepted Values |
|
|
||||||
| --------------------- | ----------------- | --------- | ------------------ | ---------------------------------- |
|
|
||||||
| VITE_APP_API_BASE_URL | Required | `string` | Base URL of server | {host}/api/v1 |
|
|
||||||
| VITE_APP_LOG_LEVEL | Optional | `string` | Log level | `"none"`\|`"error"` \| `"warn"` \| |
|
|
||||||
| VITE_APP_DEMO | Optional | `boolean` | Demo server or not | `true`\|`false` \| |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Starting Development Server<a id="start-client"></a>
|
|
||||||
|
|
||||||
1. Run `npm run dev` to start the development server.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Server Installation<a id="install-server"></a>
|
|
||||||
|
|
||||||
1. Change directory to the `Server` directory
|
|
||||||
2. Install all dependencies by running `npm install`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Environmental Variables <a id="env-vars-server"></a>
|
|
||||||
|
|
||||||
Configure the server with the following environmental variables:
|
|
||||||
|
|
||||||
| ENV Variable Name | Required/Optional | Type | Description | Accepted Values |
|
|
||||||
| --------------------- | ----------------- | --------- | ---------------------------------------- | ------------------------------------------------ |
|
|
||||||
| CLIENT_HOST | Required | `string` | Frontend Host | |
|
|
||||||
| JWT_SECRET | Required | `string` | JWT secret | |
|
|
||||||
| DB_TYPE | Optional | `string` | Specify DB to use | `MongoDB \| FakeDB` |
|
|
||||||
| DB_CONNECTION_STRING | Required | `string` | Specifies URL for MongoDB Database | |
|
|
||||||
| PORT | Optional | `integer` | Specifies Port for Server | |
|
|
||||||
| LOGIN_PAGE_URL | Required | `string` | Login url to be used in emailing service | |
|
|
||||||
| REDIS_HOST | Required | `string` | Host address for Redis database | |
|
|
||||||
| REDIS_PORT | Required | `integer` | Port for Redis database | |
|
|
||||||
| TOKEN_TTL | Optional | `string` | Time for token to live | In vercel/ms format https://github.com/vercel/ms |
|
|
||||||
| PAGESPEED_API_KEY | Optional | `string` | API Key for PageSpeed requests | |
|
|
||||||
| SYSTEM_EMAIL_HOST | Required | `string` | Host to send System Emails From | |
|
|
||||||
| SYSTEM_EMAIL_PORT | Required | `number` | Port for System Email Host | |
|
|
||||||
| SYSTEM_EMAIL_ADDRESS | Required | `string` | System Email Address | |
|
|
||||||
| SYSTEM_EMAIL_PASSWORD | Required | `string` | System Email Password | |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Databases <a id="databases"></a>
|
|
||||||
|
|
||||||
This project requires two databases:
|
|
||||||
|
|
||||||
1. **Main Application Database:** The project uses MongoDB for its primary database, with a MongoDB Docker image provided for easy setup.
|
|
||||||
2. **Redis for Queue Management:** A Redis database is used for the PingService’s queue system, and a Redis Docker image is included for deployment.
|
|
||||||
|
|
||||||
You may use the included Dockerfiles to spin up databases quickly if you wish.
|
|
||||||
|
|
||||||
#### (Optional) Dockerised Databases <a id="optional-docker-databases"></a>
|
|
||||||
|
|
||||||
Dockerfiles for the server and databases are located in the `Docker` directory
|
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary><b>MongoDB Image</b></summary>
|
|
||||||
|
|
||||||
Location: `Docker/mongoDB.Dockerfile`
|
|
||||||
|
|
||||||
The `Docker/mongo/data` directory should be mounted to the MongoDB container in order to persist data.
|
|
||||||
|
|
||||||
From the `Docker` directory run
|
|
||||||
|
|
||||||
1. Build the image: `docker build -f mongoDB.Dockerfile -t uptime_database_mongo .`
|
|
||||||
2. Run the docker image: `docker run -d -p 27017:27017 -v $(pwd)/mongo/data:/data/db --name uptime_database_mongo uptime_database_mongo`
|
|
||||||
|
|
||||||
</details>
|
|
||||||
<details>
|
|
||||||
<summary><b>Redis Image</b></summary>
|
|
||||||
|
|
||||||
Location `Docker/redis.Dockerfile`
|
|
||||||
|
|
||||||
the `Docker/redis/data` directory should be mounted to the Redis container in order to persist data.
|
|
||||||
|
|
||||||
From the `Docker` directory run
|
|
||||||
|
|
||||||
1. Build the image: `docker build -f redis.Dockerfile -t uptime_redis .`
|
|
||||||
2. Run the image: `docker run -d -p 6379:6379 -v $(pwd)/redis/data:/data --name uptime_redis uptime_redis`
|
|
||||||
</details>
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Starting the Development Server <a id="start-server"></a>
|
|
||||||
|
|
||||||
- run `npm run dev` to start the development server
|
|
||||||
|
|
||||||
OR
|
|
||||||
|
|
||||||
- run `node index.js` to start server
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## <u>API Documentation</u><a id="api-documentation"></a>
|
|
||||||
|
|
||||||
Our API is documented in accordance with the [OpenAPI spec](https://www.openapis.org/).
|
|
||||||
|
|
||||||
You can see the documentation on your local development server at [http://localhost:{port}/api-docs](htt>>p://localhost:5000/api-docs)
|
|
||||||
|
|
||||||
You can also view the documentation on our demo server at [https://uptime-demo.bluewavelabs.ca/api-docs](https://uptime-demo.bluewavelabs.ca/api-docs)
|
|
||||||
|
|
||||||
## <u>Error handling</u>
|
|
||||||
|
|
||||||
Errors are returned in a standard format:
|
|
||||||
|
|
||||||
`{"success": false, "msg": "No token provided"}`
|
|
||||||
|
|
||||||
Errors are handled by error handling middleware and should be thrown with the following parameters
|
|
||||||
|
|
||||||
| Name | Type | Default | Notes |
|
|
||||||
| ------- | --------- | ---------------------- | ------------------------------------ |
|
|
||||||
| status | `integer` | 500 | Standard HTTP codes |
|
|
||||||
| message | `string` | "Something went wrong" | An error message |
|
|
||||||
| service | `string` | "Unknown Service" | Name of service that threw the error |
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
```
|
|
||||||
const myRoute = async(req, res, next) => {
|
|
||||||
try{
|
|
||||||
const result = myRiskyOperationHere();
|
|
||||||
}
|
|
||||||
catch(error){
|
|
||||||
error.status = 404
|
|
||||||
error.message = "Resource not found"
|
|
||||||
error.service = service name
|
|
||||||
next(error)
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
Errors should not be handled at the controller level and should be left to the middleware to handle.
|
|
||||||
@@ -38,6 +38,11 @@ const verifyJWT = (req, res, next) => {
|
|||||||
const { jwtSecret } = req.settingsService.getSettings();
|
const { jwtSecret } = req.settingsService.getSettings();
|
||||||
jwt.verify(parsedToken, jwtSecret, (err, decoded) => {
|
jwt.verify(parsedToken, jwtSecret, (err, decoded) => {
|
||||||
if (err) {
|
if (err) {
|
||||||
|
if (err.name === "TokenExpiredError") {
|
||||||
|
res
|
||||||
|
.status(401)
|
||||||
|
.json({ success: false, msg: errorMessages.EXPIRED_AUTH_TOKEN });
|
||||||
|
}
|
||||||
return res
|
return res
|
||||||
.status(401)
|
.status(401)
|
||||||
.json({ success: false, msg: errorMessages.INVALID_AUTH_TOKEN });
|
.json({ success: false, msg: errorMessages.INVALID_AUTH_TOKEN });
|
||||||
|
|||||||
@@ -12,6 +12,7 @@ const errorMessages = {
|
|||||||
UNKNOWN_SERVICE: "Unknown service",
|
UNKNOWN_SERVICE: "Unknown service",
|
||||||
NO_AUTH_TOKEN: "No auth token provided",
|
NO_AUTH_TOKEN: "No auth token provided",
|
||||||
INVALID_AUTH_TOKEN: "Invalid auth token",
|
INVALID_AUTH_TOKEN: "Invalid auth token",
|
||||||
|
EXPIRED_AUTH_TOKEN: "Token expired",
|
||||||
|
|
||||||
//Ownership Middleware
|
//Ownership Middleware
|
||||||
VERIFY_OWNER_NOT_FOUND: "Document not found",
|
VERIFY_OWNER_NOT_FOUND: "Document not found",
|
||||||
|
|||||||
Reference in new issue
Block a user