@rapidrest/service-core 1.0.0-beta.4 → 1.0.0-beta.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/lib/Server.js +10 -10
- package/dist/lib/Server.js.map +1 -1
- package/dist/lib/auth/JWTStrategy.js +2 -1
- package/dist/lib/auth/JWTStrategy.js.map +1 -1
- package/dist/lib/http/Adapters.js +31 -20
- package/dist/lib/http/Adapters.js.map +1 -1
- package/dist/lib/http/Router.js +11 -4
- package/dist/lib/http/Router.js.map +1 -1
- package/dist/lib/routes/RouteUtils.js +10 -12
- package/dist/lib/routes/RouteUtils.js.map +1 -1
- package/dist/lib/security/ACLUtils.js +19 -3
- package/dist/lib/security/ACLUtils.js.map +1 -1
- package/dist/types/auth/JWTStrategy.d.ts +1 -0
- package/dist/types/security/ACLUtils.d.ts +1 -1
- package/docs/reference/@rapidrest/namespaces/DatabaseDecorators/functions/MongoRepository.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DatabaseDecorators/functions/RedisConnection.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DatabaseDecorators/functions/Repository.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/Default.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/Description.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/Document.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/Example.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/Format.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/Returns.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/Summary.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/Tags.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/functions/TypeInfo.md +1 -1
- package/docs/reference/@rapidrest/namespaces/DocDecorators/interfaces/DocumentsData.md +7 -7
- package/docs/reference/@rapidrest/namespaces/EventDecorators/functions/EventListener.md +1 -1
- package/docs/reference/@rapidrest/namespaces/EventDecorators/functions/OnEvent.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/functions/Cache.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/functions/ChildEntity.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/functions/DataStore.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/functions/Identifier.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/functions/Protect.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/functions/Reference.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/functions/Shard.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/functions/TrackChanges.md +1 -1
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/interfaces/PendingTypeOrmColumn.md +5 -5
- package/docs/reference/@rapidrest/namespaces/ModelDecorators/variables/pendingTypeOrmColumns.md +1 -1
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/functions/Column.md +1 -1
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/functions/Entity.md +1 -1
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/functions/Index.md +3 -3
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/functions/PrimaryColumn.md +1 -1
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/functions/Unique.md +3 -3
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/functions/getColumnMetadata.md +1 -1
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/functions/getEntityName.md +1 -1
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/functions/getIndexMetadata.md +1 -1
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/interfaces/ColumnInfo.md +4 -4
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/interfaces/ColumnOptions.md +5 -5
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/interfaces/IndexInfo.md +4 -4
- package/docs/reference/@rapidrest/namespaces/PersistenceDecorators/interfaces/IndexOptions.md +5 -5
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/After.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Auth.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/AuthResult.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Before.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/ContentType.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Delete.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Get.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Head.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Header.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Method.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Model.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Options.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Param.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Patch.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Post.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Protect.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Put.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Query.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Request.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/RequiresRole.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Response.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Route.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Socket.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/User.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/Validate.md +1 -1
- package/docs/reference/@rapidrest/namespaces/RouteDecorators/functions/WebSocket.md +1 -1
- package/docs/reference/classes/ACLUtils.md +14 -10
- package/docs/reference/classes/AdminRoute.md +3 -3
- package/docs/reference/classes/AuthMiddleware.md +6 -6
- package/docs/reference/classes/BackgroundService.md +8 -8
- package/docs/reference/classes/BackgroundServiceManager.md +7 -7
- package/docs/reference/classes/BaseEntity.md +6 -6
- package/docs/reference/classes/BaseMongoEntity.md +7 -7
- package/docs/reference/classes/BasicStrategy.md +5 -5
- package/docs/reference/classes/BasicStrategyOptions.md +7 -7
- package/docs/reference/classes/BulkError.md +3 -3
- package/docs/reference/classes/ConnectionManager.md +4 -4
- package/docs/reference/classes/EventListenerManager.md +5 -5
- package/docs/reference/classes/HttpRouter.md +16 -16
- package/docs/reference/classes/JWTStrategy.md +10 -10
- package/docs/reference/classes/JWTStrategyOptions.md +10 -10
- package/docs/reference/classes/MetricsRoute.md +2 -2
- package/docs/reference/classes/ModelRoute.md +26 -26
- package/docs/reference/classes/ModelUtils.md +10 -10
- package/docs/reference/classes/MongoConnection.md +12 -12
- package/docs/reference/classes/MongoRepository.md +17 -17
- package/docs/reference/classes/MongoSchemaSync.md +3 -3
- package/docs/reference/classes/NetUtils.md +3 -3
- package/docs/reference/classes/NotificationUtils.md +3 -3
- package/docs/reference/classes/ObjectFactory.md +3 -3
- package/docs/reference/classes/OpenAPIRoute.md +5 -5
- package/docs/reference/classes/OpenApiSpec.md +45 -45
- package/docs/reference/classes/RecoverableBaseEntity.md +7 -7
- package/docs/reference/classes/RecoverableBaseMongoEntity.md +8 -8
- package/docs/reference/classes/RedisTransport.md +4 -4
- package/docs/reference/classes/RepoUtils.md +28 -28
- package/docs/reference/classes/RouteUtils.md +9 -9
- package/docs/reference/classes/Server.md +89 -89
- package/docs/reference/classes/SimpleEntity.md +3 -3
- package/docs/reference/classes/SimpleMongoEntity.md +4 -4
- package/docs/reference/classes/StatusExtraData.md +4 -4
- package/docs/reference/classes/StatusRoute.md +1 -1
- package/docs/reference/classes/UWSRequest.md +17 -17
- package/docs/reference/classes/UWSResponse.md +15 -15
- package/docs/reference/classes/UWSWebSocketShim.md +5 -5
- package/docs/reference/enumerations/ACLAction.md +7 -7
- package/docs/reference/enumerations/ApiErrorMessages.md +15 -15
- package/docs/reference/enumerations/ApiErrors.md +15 -15
- package/docs/reference/functions/createWebSocketStream.md +1 -1
- package/docs/reference/functions/isSqlDataSource.md +1 -1
- package/docs/reference/functions/readBody.md +3 -3
- package/docs/reference/functions/resolveCollectionName.md +1 -1
- package/docs/reference/functions/runChain.md +1 -1
- package/docs/reference/functions/snakeCase.md +1 -1
- package/docs/reference/interfaces/ACLRecord.md +8 -8
- package/docs/reference/interfaces/AccessControlList.md +5 -5
- package/docs/reference/interfaces/AuthResult.md +5 -5
- package/docs/reference/interfaces/AuthStrategy.md +4 -4
- package/docs/reference/interfaces/CreateRequestOptions.md +9 -9
- package/docs/reference/interfaces/DeleteRequestOptions.md +11 -11
- package/docs/reference/interfaces/FindRequestOptions.md +10 -10
- package/docs/reference/interfaces/HttpRequest.md +15 -15
- package/docs/reference/interfaces/HttpResponse.md +11 -11
- package/docs/reference/interfaces/JWTAuthResult.md +9 -9
- package/docs/reference/interfaces/RepoCreateOptions.md +7 -7
- package/docs/reference/interfaces/RepoDeleteOptions.md +9 -9
- package/docs/reference/interfaces/RepoFindOptions.md +11 -11
- package/docs/reference/interfaces/RepoOperationOptions.md +6 -6
- package/docs/reference/interfaces/RepoUpdateOptions.md +8 -8
- package/docs/reference/interfaces/RequestOptions.md +8 -8
- package/docs/reference/interfaces/RequestWS.md +17 -17
- package/docs/reference/interfaces/TruncateRequestOptions.md +13 -13
- package/docs/reference/interfaces/UpdateRequestOptions.md +11 -11
- package/docs/reference/type-aliases/ErrorHandler.md +1 -1
- package/docs/reference/type-aliases/NextFunction.md +1 -1
- package/docs/reference/type-aliases/OneOrMany.md +1 -1
- package/docs/reference/type-aliases/OneOrNull.md +1 -1
- package/docs/reference/type-aliases/PartialBaseEntity.md +1 -1
- package/docs/reference/type-aliases/PartialSimpleEntity.md +1 -1
- package/docs/reference/type-aliases/RequestHandler.md +1 -1
- package/docs/reference/type-aliases/UpdateObject.md +1 -1
- package/docs/reference/type-aliases/WsUpgradeAuth.md +1 -1
- package/docs/reference/type-aliases/WsUpgradeAuthResult.md +5 -5
- package/package.json +129 -125
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Auth**(`strategies`, `require?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:33](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:33](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L33)
|
|
12
12
|
|
|
13
13
|
Applies PassportJS authentication to the decorated route or method for the provided strategy or list of strategies
|
|
14
14
|
should be attempted before processing the route.
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **AuthResult**(`target`, `propertyKey`, `index`): `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:45](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:45](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L45)
|
|
12
12
|
|
|
13
13
|
Injects the authenticated authentication result as the value of the decorated argument.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Before**(`func`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:56](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:56](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L56)
|
|
12
12
|
|
|
13
13
|
Indicates a provided function or list of functions to execute *before* the decorated function.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **ContentType**(`type`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:73](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:73](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L73)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function will return content encoded with the specified content type.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Delete**(`path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:86](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:86](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L86)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming `DELETE` requests at the given sub-path.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Get**(`path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:95](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:95](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L95)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming `GET` requests at the given sub-path.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Head**(`path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:104](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:104](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L104)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming `HEAD` requests at the given sub-path.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Header**(`name`): (`target`, `propertyKey`, `index`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:113](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:113](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L113)
|
|
12
12
|
|
|
13
13
|
Injects the value of the specified request header with the given name as the value of the decorated argument.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Method**(`method`, `path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:127](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:127](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L127)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming HTTP requests for the specified HTTP method(s) at the given sub-path.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Model**(`type`): \<`T`\>(`constructor`) => \{(...`args`): `(Anonymous class)`\<`T`\>; `modelClass`: `any`; `prototype`: `(Anonymous class)`\<`any`\>; \} & `T`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:150](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:150](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L150)
|
|
12
12
|
|
|
13
13
|
Indicates that the class utilizes is a manager for the specified class type.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Options**(`path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:164](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:164](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L164)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming `OPTIONS` requests at the given sub-path.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Param**(`name?`): (`target`, `propertyKey`, `index`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:174](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:174](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L174)
|
|
12
12
|
|
|
13
13
|
Injects the value of the specified URI parameter with the given name as the value of the decorated argument. If no
|
|
14
14
|
name is specified the entire request parameter will be injected.
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Patch**(`path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:187](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:187](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L187)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming `PATCH` requests at the given sub-path.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Post**(`path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:196](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:196](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L196)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming `POST` requests at the given sub-path.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Protect**(`acl?`): (`target`, `propertyKey?`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:222](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:222](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L222)
|
|
12
12
|
|
|
13
13
|
Apply this to any route handler class or an individual route handler function to indicate that it should be
|
|
14
14
|
protected by the AccessControlList security system. The `acl` parameter specifies the ACL governing access
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Put**(`path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:205](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:205](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L205)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming `PUT` requests at the given sub-path.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Query**(`name?`): (`target`, `propertyKey`, `index`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:265](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:265](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L265)
|
|
12
12
|
|
|
13
13
|
Injects the value of the specified query parameter with the given name as the value of the decorated argument. If
|
|
14
14
|
no name is specified the entire request query will be injected.
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Request**(`target`, `propertyKey`, `index`): `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:276](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:276](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L276)
|
|
12
12
|
|
|
13
13
|
Injects the Express request object as the value of the decorated argument.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **RequiresRole**(`roles`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:297](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:297](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L297)
|
|
12
12
|
|
|
13
13
|
Indicates that the client must be an authenticated user with at least one of the specified role(s) to process the
|
|
14
14
|
request.
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Response**(`target`, `propertyKey`, `index`): `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:285](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:285](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L285)
|
|
12
12
|
|
|
13
13
|
Injects the Express response object as the value of the decorated argument.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Route**(`paths`): (`target`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:310](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:310](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L310)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated class contains Express route definitions.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Socket**(`target`, `propertyKey`, `index`): `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:323](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:323](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L323)
|
|
12
12
|
|
|
13
13
|
Injects the underlying Socket object associated with the request as the value of the decorated argument.
|
|
14
14
|
When the handler function is for a WebSocket request, the returned socket will be the newly established
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **User**(`target`, `propertyKey`, `index`): `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:332](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:332](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L332)
|
|
12
12
|
|
|
13
13
|
Injects the authenticated user object as the value of the decorated argument.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **Validate**(`func`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:343](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:343](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L343)
|
|
12
12
|
|
|
13
13
|
Indicates a validation function to execute in order to verify an incoming requests payload.
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
> **WebSocket**(`path?`): (`target`, `propertyKey`, `descriptor`) => `void`
|
|
10
10
|
|
|
11
|
-
Defined in: [src/decorators/RouteDecorators.ts:356](https://github.com/rapidrest/service-core/blob/
|
|
11
|
+
Defined in: [src/decorators/RouteDecorators.ts:356](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/decorators/RouteDecorators.ts#L356)
|
|
12
12
|
|
|
13
13
|
Indicates that the decorated function handles incoming `WebSocket` upgrade requests at the given sub-path.
|
|
14
14
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
# Class: ACLUtils
|
|
8
8
|
|
|
9
|
-
Defined in: [src/security/ACLUtils.ts:22](https://github.com/rapidrest/service-core/blob/
|
|
9
|
+
Defined in: [src/security/ACLUtils.ts:22](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L22)
|
|
10
10
|
|
|
11
11
|
Common utility functions for working with `AccessControlList` objects and validating user permissions.
|
|
12
12
|
|
|
@@ -26,7 +26,7 @@ Common utility functions for working with `AccessControlList` objects and valida
|
|
|
26
26
|
|
|
27
27
|
> **checkRequestPerms**(`uid`, `user`, `req`): `Promise`\<`boolean`\>
|
|
28
28
|
|
|
29
|
-
Defined in: [src/security/ACLUtils.ts:73](https://github.com/rapidrest/service-core/blob/
|
|
29
|
+
Defined in: [src/security/ACLUtils.ts:73](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L73)
|
|
30
30
|
|
|
31
31
|
Validates that the user has permission to perform the request operation against the URL path for the
|
|
32
32
|
provided request. If ACLUtils has not been initialized or the `acl` datastore has not been configured
|
|
@@ -60,9 +60,9 @@ The request whose URL path and method will be verified.
|
|
|
60
60
|
|
|
61
61
|
### findACL()
|
|
62
62
|
|
|
63
|
-
> **findACL**(`entityId`, `parentUids?`): `Promise`\<[`AccessControlList`](../interfaces/AccessControlList.md) \| `null`\>
|
|
63
|
+
> **findACL**(`entityId`, `parentUids?`, `reqCache?`): `Promise`\<[`AccessControlList`](../interfaces/AccessControlList.md) \| `null`\>
|
|
64
64
|
|
|
65
|
-
Defined in: [src/security/ACLUtils.ts:
|
|
65
|
+
Defined in: [src/security/ACLUtils.ts:202](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L202)
|
|
66
66
|
|
|
67
67
|
Retrieves the access control list with the associated identifier and populates the parent(s).
|
|
68
68
|
|
|
@@ -80,6 +80,10 @@ The unique identifier of the ACL to retrieve.
|
|
|
80
80
|
|
|
81
81
|
The list of already found parent UIDs. This is used to break circular dependencies.
|
|
82
82
|
|
|
83
|
+
##### reqCache?
|
|
84
|
+
|
|
85
|
+
`Map`\<`string`, [`AccessControlList`](../interfaces/AccessControlList.md) \| `null`\>
|
|
86
|
+
|
|
83
87
|
#### Returns
|
|
84
88
|
|
|
85
89
|
`Promise`\<[`AccessControlList`](../interfaces/AccessControlList.md) \| `null`\>
|
|
@@ -90,7 +94,7 @@ The list of already found parent UIDs. This is used to break circular dependenci
|
|
|
90
94
|
|
|
91
95
|
> **getRecord**(`acl`, `user`): [`ACLRecord`](../interfaces/ACLRecord.md) \| `null`
|
|
92
96
|
|
|
93
|
-
Defined in: [src/security/ACLUtils.ts:
|
|
97
|
+
Defined in: [src/security/ACLUtils.ts:482](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L482)
|
|
94
98
|
|
|
95
99
|
Retrieves the first available record in the provided ACL associated with the provided user.
|
|
96
100
|
|
|
@@ -120,7 +124,7 @@ The ACL record associated with the given user if found, otherwise `undefined`.
|
|
|
120
124
|
|
|
121
125
|
> **hasPermission**(`user`, `acl`, `action`): `Promise`\<`boolean`\>
|
|
122
126
|
|
|
123
|
-
Defined in: [src/security/ACLUtils.ts:
|
|
127
|
+
Defined in: [src/security/ACLUtils.ts:134](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L134)
|
|
124
128
|
|
|
125
129
|
Validates that the user has permission to perform the provided action using the given access control list.
|
|
126
130
|
|
|
@@ -156,7 +160,7 @@ The action that the user desires permission for.
|
|
|
156
160
|
|
|
157
161
|
> **populateParent**(`acl`, `parentUids?`): `Promise`\<`void`\>
|
|
158
162
|
|
|
159
|
-
Defined in: [src/security/ACLUtils.ts:
|
|
163
|
+
Defined in: [src/security/ACLUtils.ts:502](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L502)
|
|
160
164
|
|
|
161
165
|
Attempts to retrieve the parent access control list for the given ACL object.
|
|
162
166
|
|
|
@@ -184,7 +188,7 @@ The list of already found parent UIDs. This is used to break circular dependenci
|
|
|
184
188
|
|
|
185
189
|
> **removeACL**(`uid`): `Promise`\<`void`\>
|
|
186
190
|
|
|
187
|
-
Defined in: [src/security/ACLUtils.ts:
|
|
191
|
+
Defined in: [src/security/ACLUtils.ts:270](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L270)
|
|
188
192
|
|
|
189
193
|
Deletes the ACL with the given identifier from the database.
|
|
190
194
|
|
|
@@ -206,7 +210,7 @@ The unique identifier of the ACL to remove.
|
|
|
206
210
|
|
|
207
211
|
> **saveACL**(`acl`): `Promise`\<[`AccessControlList`](../interfaces/AccessControlList.md) \| `null`\>
|
|
208
212
|
|
|
209
|
-
Defined in: [src/security/ACLUtils.ts:
|
|
213
|
+
Defined in: [src/security/ACLUtils.ts:356](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L356)
|
|
210
214
|
|
|
211
215
|
Stores the given access control list into the ACL database.
|
|
212
216
|
|
|
@@ -230,7 +234,7 @@ Returns the ACL that was stored in the database.
|
|
|
230
234
|
|
|
231
235
|
> **saveDefaultACL**(`acl`): `Promise`\<[`AccessControlList`](../interfaces/AccessControlList.md) \| `null`\>
|
|
232
236
|
|
|
233
|
-
Defined in: [src/security/ACLUtils.ts:
|
|
237
|
+
Defined in: [src/security/ACLUtils.ts:422](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/security/ACLUtils.ts#L422)
|
|
234
238
|
|
|
235
239
|
Stores the given default access control list into the ACL database. A default ACL is a special type of ACL
|
|
236
240
|
that is primarily defined and maintained within the code but allows for user-specific overrides. To accomplish
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
# Class: AdminRoute
|
|
8
8
|
|
|
9
|
-
Defined in: [src/routes/AdminRoute.ts:50](https://github.com/rapidrest/service-core/blob/
|
|
9
|
+
Defined in: [src/routes/AdminRoute.ts:50](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/routes/AdminRoute.ts#L50)
|
|
10
10
|
|
|
11
11
|
The `AdminRoute` provides a default `/admin` endpoint that gives trusted users the following abilities:
|
|
12
12
|
|
|
@@ -26,7 +26,7 @@ Jean-Philippe Steinmetz
|
|
|
26
26
|
|
|
27
27
|
> **new AdminRoute**(`releaseNotes`): `AdminRoute`
|
|
28
28
|
|
|
29
|
-
Defined in: [src/routes/AdminRoute.ts:82](https://github.com/rapidrest/service-core/blob/
|
|
29
|
+
Defined in: [src/routes/AdminRoute.ts:82](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/routes/AdminRoute.ts#L82)
|
|
30
30
|
|
|
31
31
|
Constructs a new `ReleaseNotesRoute` object with the specified defaults.
|
|
32
32
|
|
|
@@ -48,4 +48,4 @@ The ReleaseNotes specification object to serve.
|
|
|
48
48
|
|
|
49
49
|
> `protected` `optional` **cacheClient?**: `Redis`
|
|
50
50
|
|
|
51
|
-
Defined in: [src/routes/AdminRoute.ts:55](https://github.com/rapidrest/service-core/blob/
|
|
51
|
+
Defined in: [src/routes/AdminRoute.ts:55](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/routes/AdminRoute.ts#L55)
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
# Class: AuthMiddleware
|
|
8
8
|
|
|
9
|
-
Defined in: [src/auth/AuthMiddleware.ts:19](https://github.com/rapidrest/service-core/blob/
|
|
9
|
+
Defined in: [src/auth/AuthMiddleware.ts:19](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/auth/AuthMiddleware.ts#L19)
|
|
10
10
|
|
|
11
11
|
A set of common utilities for performing authentication using one or more strategies.
|
|
12
12
|
|
|
@@ -30,7 +30,7 @@ Jean-Philippe Steinmetz <rapidrests@gmail.com>
|
|
|
30
30
|
|
|
31
31
|
> `readonly` **strategies**: `Map`\<`string`, [`AuthStrategy`](../interfaces/AuthStrategy.md)\>
|
|
32
32
|
|
|
33
|
-
Defined in: [src/auth/AuthMiddleware.ts:30](https://github.com/rapidrest/service-core/blob/
|
|
33
|
+
Defined in: [src/auth/AuthMiddleware.ts:30](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/auth/AuthMiddleware.ts#L30)
|
|
34
34
|
|
|
35
35
|
The authentication strategies that have been registered.
|
|
36
36
|
|
|
@@ -40,7 +40,7 @@ The authentication strategies that have been registered.
|
|
|
40
40
|
|
|
41
41
|
> **authenticate**(`strategies`, `req`, `res?`, `required?`): `Promise`\<[`AuthResult`](../interfaces/AuthResult.md) \| `undefined`\>
|
|
42
42
|
|
|
43
|
-
Defined in: [src/auth/AuthMiddleware.ts:54](https://github.com/rapidrest/service-core/blob/
|
|
43
|
+
Defined in: [src/auth/AuthMiddleware.ts:54](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/auth/AuthMiddleware.ts#L54)
|
|
44
44
|
|
|
45
45
|
Performs authentication of the given request using one of the provided strategies.
|
|
46
46
|
|
|
@@ -80,7 +80,7 @@ Set to `true` to if authentication is required to pass, otherwise set to `false`
|
|
|
80
80
|
|
|
81
81
|
> **authenticateSync**(`strategies`, `req`, `res?`, `required?`): [`AuthResult`](../interfaces/AuthResult.md) \| `undefined`
|
|
82
82
|
|
|
83
|
-
Defined in: [src/auth/AuthMiddleware.ts:92](https://github.com/rapidrest/service-core/blob/
|
|
83
|
+
Defined in: [src/auth/AuthMiddleware.ts:92](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/auth/AuthMiddleware.ts#L92)
|
|
84
84
|
|
|
85
85
|
Performs authentication of the given request using one of the provided strategies.
|
|
86
86
|
|
|
@@ -122,7 +122,7 @@ Set to `true` to if authentication is required to pass, otherwise set to `false`
|
|
|
122
122
|
|
|
123
123
|
> **authWebSocket**(`required`): [`RequestHandler`](../type-aliases/RequestHandler.md)
|
|
124
124
|
|
|
125
|
-
Defined in: [src/auth/AuthMiddleware.ts:133](https://github.com/rapidrest/service-core/blob/
|
|
125
|
+
Defined in: [src/auth/AuthMiddleware.ts:133](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/auth/AuthMiddleware.ts#L133)
|
|
126
126
|
|
|
127
127
|
Returns a request handler function that will perform authentication of a websocket connection. Authentication
|
|
128
128
|
can be handled in two ways:
|
|
@@ -150,7 +150,7 @@ Set to `true` to indicate that auth is required, otherwise `false`.
|
|
|
150
150
|
|
|
151
151
|
> **register**(`name`, `strategy`): `void`
|
|
152
152
|
|
|
153
|
-
Defined in: [src/auth/AuthMiddleware.ts:277](https://github.com/rapidrest/service-core/blob/
|
|
153
|
+
Defined in: [src/auth/AuthMiddleware.ts:277](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/auth/AuthMiddleware.ts#L277)
|
|
154
154
|
|
|
155
155
|
Registers the provided authentication strategy to be used
|
|
156
156
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
# Abstract Class: BackgroundService
|
|
8
8
|
|
|
9
|
-
Defined in: [src/BackgroundService.ts:10](https://github.com/rapidrest/service-core/blob/
|
|
9
|
+
Defined in: [src/BackgroundService.ts:10](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundService.ts#L10)
|
|
10
10
|
|
|
11
11
|
The `BackgroundService` is an abstract base class for defining scheduled background services. A background service
|
|
12
12
|
executes in the background once on startup or on a set schedule (like a cron job) and performs additional processing.
|
|
@@ -21,7 +21,7 @@ Jean-Philippe Steinmetz <rapidrests@gmail.com>
|
|
|
21
21
|
|
|
22
22
|
> **new BackgroundService**(`config`, `logger`): `BackgroundService`
|
|
23
23
|
|
|
24
|
-
Defined in: [src/BackgroundService.ts:16](https://github.com/rapidrest/service-core/blob/
|
|
24
|
+
Defined in: [src/BackgroundService.ts:16](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundService.ts#L16)
|
|
25
25
|
|
|
26
26
|
#### Parameters
|
|
27
27
|
|
|
@@ -43,7 +43,7 @@ Defined in: [src/BackgroundService.ts:16](https://github.com/rapidrest/service-c
|
|
|
43
43
|
|
|
44
44
|
> `protected` **config**: `any`
|
|
45
45
|
|
|
46
|
-
Defined in: [src/BackgroundService.ts:12](https://github.com/rapidrest/service-core/blob/
|
|
46
|
+
Defined in: [src/BackgroundService.ts:12](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundService.ts#L12)
|
|
47
47
|
|
|
48
48
|
The global application configuration that the service can reference.
|
|
49
49
|
|
|
@@ -53,7 +53,7 @@ The global application configuration that the service can reference.
|
|
|
53
53
|
|
|
54
54
|
> `protected` **logger**: `any`
|
|
55
55
|
|
|
56
|
-
Defined in: [src/BackgroundService.ts:14](https://github.com/rapidrest/service-core/blob/
|
|
56
|
+
Defined in: [src/BackgroundService.ts:14](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundService.ts#L14)
|
|
57
57
|
|
|
58
58
|
The logging utility to use.
|
|
59
59
|
|
|
@@ -65,7 +65,7 @@ The logging utility to use.
|
|
|
65
65
|
|
|
66
66
|
> **get** `abstract` **schedule**(): `string` \| `undefined`
|
|
67
67
|
|
|
68
|
-
Defined in: [src/BackgroundService.ts:25](https://github.com/rapidrest/service-core/blob/
|
|
68
|
+
Defined in: [src/BackgroundService.ts:25](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundService.ts#L25)
|
|
69
69
|
|
|
70
70
|
Returns the desired execution interval that this service should be scheduled with. If `undefined` is returned
|
|
71
71
|
the service is executed only once.
|
|
@@ -80,7 +80,7 @@ the service is executed only once.
|
|
|
80
80
|
|
|
81
81
|
> `abstract` **run**(): `void` \| `Promise`\<`void`\>
|
|
82
82
|
|
|
83
|
-
Defined in: [src/BackgroundService.ts:30](https://github.com/rapidrest/service-core/blob/
|
|
83
|
+
Defined in: [src/BackgroundService.ts:30](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundService.ts#L30)
|
|
84
84
|
|
|
85
85
|
The processing function to execute at each scheduled interval.
|
|
86
86
|
|
|
@@ -94,7 +94,7 @@ The processing function to execute at each scheduled interval.
|
|
|
94
94
|
|
|
95
95
|
> `abstract` **start**(): `void` \| `Promise`\<`void`\>
|
|
96
96
|
|
|
97
|
-
Defined in: [src/BackgroundService.ts:35](https://github.com/rapidrest/service-core/blob/
|
|
97
|
+
Defined in: [src/BackgroundService.ts:35](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundService.ts#L35)
|
|
98
98
|
|
|
99
99
|
Initializes the background service with any defaults.
|
|
100
100
|
|
|
@@ -108,7 +108,7 @@ Initializes the background service with any defaults.
|
|
|
108
108
|
|
|
109
109
|
> `abstract` **stop**(): `void` \| `Promise`\<`void`\>
|
|
110
110
|
|
|
111
|
-
Defined in: [src/BackgroundService.ts:40](https://github.com/rapidrest/service-core/blob/
|
|
111
|
+
Defined in: [src/BackgroundService.ts:40](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundService.ts#L40)
|
|
112
112
|
|
|
113
113
|
Shuts down the background allowing the service to complete any outstanding tasks.
|
|
114
114
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
# Class: BackgroundServiceManager
|
|
8
8
|
|
|
9
|
-
Defined in: [src/BackgroundServiceManager.ts:35](https://github.com/rapidrest/service-core/blob/
|
|
9
|
+
Defined in: [src/BackgroundServiceManager.ts:35](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundServiceManager.ts#L35)
|
|
10
10
|
|
|
11
11
|
The `BackgroundServiceManager` manages all configured background services in the application. It is responsible for
|
|
12
12
|
initializing the jobs, scheduling them and performing any related shutdown tasks. See the `BackgroundService`
|
|
@@ -43,7 +43,7 @@ Jean-Philippe Steinmetz <rapidrests@gmail.com>
|
|
|
43
43
|
|
|
44
44
|
> **new BackgroundServiceManager**(`objectFactory`, `classes`, `config`, `logger`): `BackgroundServiceManager`
|
|
45
45
|
|
|
46
|
-
Defined in: [src/BackgroundServiceManager.ts:43](https://github.com/rapidrest/service-core/blob/
|
|
46
|
+
Defined in: [src/BackgroundServiceManager.ts:43](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundServiceManager.ts#L43)
|
|
47
47
|
|
|
48
48
|
#### Parameters
|
|
49
49
|
|
|
@@ -71,7 +71,7 @@ Defined in: [src/BackgroundServiceManager.ts:43](https://github.com/rapidrest/se
|
|
|
71
71
|
|
|
72
72
|
> **getService**(`name`): [`BackgroundService`](BackgroundService.md) \| `undefined`
|
|
73
73
|
|
|
74
|
-
Defined in: [src/BackgroundServiceManager.ts:55](https://github.com/rapidrest/service-core/blob/
|
|
74
|
+
Defined in: [src/BackgroundServiceManager.ts:55](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundServiceManager.ts#L55)
|
|
75
75
|
|
|
76
76
|
Returns the service instance with the given name.
|
|
77
77
|
|
|
@@ -93,7 +93,7 @@ The name of the background service to retrieve.
|
|
|
93
93
|
|
|
94
94
|
> **start**(`serviceName`, `clazz?`, ...`args`): `Promise`\<`void`\>
|
|
95
95
|
|
|
96
|
-
Defined in: [src/BackgroundServiceManager.ts:81](https://github.com/rapidrest/service-core/blob/
|
|
96
|
+
Defined in: [src/BackgroundServiceManager.ts:81](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundServiceManager.ts#L81)
|
|
97
97
|
|
|
98
98
|
Starts the background service with the given name.
|
|
99
99
|
|
|
@@ -127,7 +127,7 @@ The list of arguments to pass into the service constructor
|
|
|
127
127
|
|
|
128
128
|
> **startAll**(): `Promise`\<`void`\>
|
|
129
129
|
|
|
130
|
-
Defined in: [src/BackgroundServiceManager.ts:62](https://github.com/rapidrest/service-core/blob/
|
|
130
|
+
Defined in: [src/BackgroundServiceManager.ts:62](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundServiceManager.ts#L62)
|
|
131
131
|
|
|
132
132
|
Starts all configured background services.
|
|
133
133
|
|
|
@@ -141,7 +141,7 @@ Starts all configured background services.
|
|
|
141
141
|
|
|
142
142
|
> **stop**(`serviceName`): `Promise`\<`void`\>
|
|
143
143
|
|
|
144
|
-
Defined in: [src/BackgroundServiceManager.ts:139](https://github.com/rapidrest/service-core/blob/
|
|
144
|
+
Defined in: [src/BackgroundServiceManager.ts:139](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundServiceManager.ts#L139)
|
|
145
145
|
|
|
146
146
|
Stops the background service with the given name.
|
|
147
147
|
|
|
@@ -163,7 +163,7 @@ The name of the background service to stop.
|
|
|
163
163
|
|
|
164
164
|
> **stopAll**(): `Promise`\<`void`\>
|
|
165
165
|
|
|
166
|
-
Defined in: [src/BackgroundServiceManager.ts:124](https://github.com/rapidrest/service-core/blob/
|
|
166
|
+
Defined in: [src/BackgroundServiceManager.ts:124](https://github.com/rapidrest/service-core/blob/4fdd657d7d387d4147d06ef5e46206995e846a87/src/BackgroundServiceManager.ts#L124)
|
|
167
167
|
|
|
168
168
|
Stops all currently active background services that are owned by the manager.
|
|
169
169
|
|