@rapidrest/service-core 1.0.0-rc.13 → 1.0.0-rc.16

package/dist/lib/security/{ACLRouteMongo.js → BaseACLRoute.js}

@@ -10,13 +10,54 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-import { AccessControlListMongo } from "./AccessControlListMongo.js";
 import { ACLAction } from "./AccessControlList.js";
 import { ApiError, UserUtils } from "@rapidrest/core";
 import { ApiErrorMessages } from "../ApiErrors.js";
-import { Before, Model, Param, Query, Request, Response, Route, User } from "../decorators/RouteDecorators.js";
+import { Before, Param, Query, Request, Response, User } from "../decorators/RouteDecorators.js";
 import { CRUDRoute } from "../routes/CRUDRoute.js";
-let ACLRouteMongo = class ACLRouteMongo extends CRUDRoute {
+/**
+ * The `BaseACLRoute` class provides a base set of endpoints for managing Access Control List records.
+ *
+ * Exposed endpoints:
+ *
+ * | Name | HTTP Method | What it does |
+ * | --- | --- | --- |
+ * | `count` | `HEAD /` | Counts the number of ACLs matching the provided set of criteria in the request's query parameters. Returns the count as the value of the `Content-Length` header. |
+ * | `create` | `POST /` | Adds one or more new ACLs to the datastore. |
+ * | `delete` | `DELETE /:id` | Removes an existing ACL from the datastore. |
+ * | `exists` | `HEAD /:id` | Checks if the ACL with the given ID exists in the datastore. Sets `Content-Length` header to `1` if the ACL exists, otherwise `0`. |
+ * | `find` | `GET /` | Returns all ACLs matching the provided set of criteria in the request's query parameters. |
+ * | `findById` | `GET /:id` | Returns a single ACL with a specified unique identifier. |
+ * | `truncate` | `DELETE /` | Removes all ACLs from the datastore. |
+ * | `update` | `PUT /:id` | Modifies an existing ACL in the datastore. |
+ * | `updateBulk` | `PUT /` | Modifies multiple existing ACLs in the datastore. |
+ * | `updateProperty` | `PUT /:id/:property` | Modifies an single property of the given name of an existing ACL in the datastore. |
+ *
+ * !!Note!! that the `BaseACLRoute` is not automatically registered with a server by default. You must create
+ * your own class that extends `BaseACLRoute` and apply the desired base path with `@Route()`.
+ *
+ * @example
+ * ```ts
+ * import { AccessControlListMongo, BaseACLRoute, RouteDecorators } from "@rapidrest/service-core";
+ * const { Model, Route } = RouteDecorators;
+ *
+ * @Model(AccessControlListMongo)
+ * @Route("/acls")
+ * export class ACLRoute extends BaseACLRoute<AccessControlListMongo> {}
+ * ```
+ * @example
+ * ```ts
+ * import { AccessControlListSQL, BaseACLRoute, RouteDecorators } from "@rapidrest/service-core";
+ * const { Model, Route } = RouteDecorators;
+ *
+ * @Model(AccessControlListSQL)
+ * @Route("/acls")
+ * export class ACLRoute extends BaseACLRoute<AccessControlListSQL> {}
+ * ```
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class BaseACLRoute extends CRUDRoute {
     async checkPerms(params, user) {
         if (!user) {
             throw new ApiError(ApiErrorMessages.AUTH_REQUIRED, 401, ApiErrorMessages.AUTH_REQUIRED);
@@ -83,26 +124,26 @@ let ACLRouteMongo = class ACLRouteMongo extends CRUDRoute {
     updateBulk(obj, req, user) {
         return super.updateBulk(obj, req, user);
     }
-};
+}
 __decorate([
     __param(0, Param()),
     __param(1, User),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "checkPerms", null);
+], BaseACLRoute.prototype, "checkPerms", null);
 __decorate([
     __param(0, Param("id")),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [String]),
     __metadata("design:returntype", void 0)
-], ACLRouteMongo.prototype, "checkNotDefault", null);
+], BaseACLRoute.prototype, "checkNotDefault", null);
 __decorate([
     __param(1, User),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Array, Object]),
     __metadata("design:returntype", void 0)
-], ACLRouteMongo.prototype, "checkPermsBulk", null);
+], BaseACLRoute.prototype, "checkPermsBulk", null);
 __decorate([
     Before("checkPerms"),
     __param(0, Param()),
@@ -112,7 +153,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "count", null);
+], BaseACLRoute.prototype, "count", null);
 __decorate([
     Before("checkPerms"),
     __param(1, Request),
@@ -120,7 +161,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "create", null);
+], BaseACLRoute.prototype, "create", null);
 __decorate([
     Before(["checkPerms", "checkNotDefault"]),
     __param(0, Param("id")),
@@ -131,7 +172,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [String, Object, Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "delete", null);
+], BaseACLRoute.prototype, "delete", null);
 __decorate([
     Before("checkPerms"),
     __param(0, Param("id")),
@@ -141,7 +182,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [String, Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "exists", null);
+], BaseACLRoute.prototype, "exists", null);
 __decorate([
     Before("checkPerms"),
     __param(0, Param()),
@@ -150,7 +191,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "find", null);
+], BaseACLRoute.prototype, "find", null);
 __decorate([
     Before("checkPerms"),
     __param(0, Param("id")),
@@ -159,7 +200,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [String, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "findById", null);
+], BaseACLRoute.prototype, "findById", null);
 __decorate([
     Before("checkPerms"),
     __param(0, Param()),
@@ -168,7 +209,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "truncate", null);
+], BaseACLRoute.prototype, "truncate", null);
 __decorate([
     Before(["checkPerms", "checkNotDefault"]),
     __param(0, Param("id")),
@@ -177,7 +218,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [String, Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "update", null);
+], BaseACLRoute.prototype, "update", null);
 __decorate([
     Before("checkPerms"),
     __param(0, Param("id")),
@@ -186,7 +227,7 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [String, String, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "updateProperty", null);
+], BaseACLRoute.prototype, "updateProperty", null);
 __decorate([
     Before("checkPermsBulk"),
     __param(1, Request),
@@ -194,10 +235,5 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Array, Object, Object]),
     __metadata("design:returntype", Promise)
-], ACLRouteMongo.prototype, "updateBulk", null);
-ACLRouteMongo = __decorate([
-    Model(AccessControlListMongo),
-    Route("/acls")
-], ACLRouteMongo);
-export { ACLRouteMongo };
-//# sourceMappingURL=ACLRouteMongo.js.map
+], BaseACLRoute.prototype, "updateBulk", null);
+//# sourceMappingURL=BaseACLRoute.js.map

package/dist/lib/security/BaseACLRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseACLRoute.js","sourceRoot":"","sources":["../../../src/security/BaseACLRoute.ts"],"names":[],"mappings":"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"}

package/dist/lib/security/index.js

@@ -1,3 +1,6 @@
 export * from "./AccessControlList.js";
+export * from "./AccessControlListMongo.js";
+export * from "./AccessControlListSQL.js";
 export * from "./ACLUtils.js";
+export * from "./BaseACLRoute.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/security/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/security/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/security/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/dist/lib/test/request.js

@@ -42,8 +42,12 @@ export function request(app) {
                 return chain;
             },
             then(onFulfilled, onRejected) {
-                // Auto-set Content-Type for JSON object bodies
-                if (body !== undefined && typeof body === "object" && !Buffer.isBuffer(body)) {
+                // Auto-set Content-Type for JSON bodies. Buffers are sent verbatim. Everything else (objects,
+                // numbers, booleans, and strings — which callers pre-encode as JSON, e.g. `.send('"foo"')`) is
+                // treated as JSON: axios's default transform only auto-serializes plain objects, leaves strings
+                // untouched but defaults their Content-Type to form-urlencoded, and hands numbers/booleans straight
+                // to the HTTP adapter, which rejects anything that isn't a string/Buffer/Stream.
+                if (body !== undefined && !Buffer.isBuffer(body)) {
                     hdrs["content-type"] = hdrs["content-type"] || "application/json";
                 }
                 return axios

package/dist/lib/test/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/test/request.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/test/request.ts"],"names":[],"mappings":"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"}

package/dist/types/Server.d.ts

@@ -1,12 +1,28 @@
 import * as prom from "prom-client";
 import "reflect-metadata";
 import { ConnectionManager } from "./database/ConnectionManager.js";
+import { ClassLoader } from "@rapidrest/core";
 import { ObjectFactory } from "./ObjectFactory.js";
 import { BackgroundServiceManager } from "./BackgroundServiceManager.js";
 import { RouteUtils } from "./routes/RouteUtils.js";
 import { OpenApiSpec } from "./OpenApiSpec.js";
 import { EventListenerManager } from "./EventListenerManager.js";
 import { HttpRouter } from "./http/Router.js";
+/**
+ * The configuration options to use when constructing a new Server instance.
+ */
+export interface ServerOptions {
+    /** The nconf-compatible configuration object to initialize the server with. */
+    config: any;
+    /** The base file system path that models and routes will be searched from. Default is `.` */
+    basePath?: string;
+    /** The logging utility to use for outputing to console/file. Default is `Logger()` from `@rapidrest/core`. */
+    logger?: any;
+    /** The ClassLoader used to scan the source for all exported classes. */
+    classLoader?: ClassLoader;
+    /** The object factory to use for automatic dependency injection (IOC). */
+    objectFactory?: ObjectFactory;
+}
 /**
  * Provides an HTTP server utilizing uWebSockets.js. The server automatically registers all routes, and
  * establishes database connections for all configured data stores. Additionally provides automatic authentication
@@ -124,6 +140,8 @@ export declare class Server {
     protected readonly config?: any;
     /** The manager for handling database connections. */
     protected connectionManager?: ConnectionManager;
+    /** The ClassLoader used to scan the source for all exported classes. */
+    protected classLoader: ClassLoader;
     /** The manager for handling events. */
     protected eventListenerManager?: EventListenerManager;
     /** The logging utility to use when outputing to console/file. */
@@ -141,14 +159,11 @@ export declare class Server {
     protected metricFailedRequests: prom.Counter<string>;
     protected metricTotalRequests: prom.Counter<string>;
     /**
-     * Creates a new instance of Server with the specified defaults.
+     * Creates a new instance of Server with the specified default options.
      *
-     * @param {any} config The nconf-compatible configuration object to initialize the server with.
-     * @param {string} basePath The base file system path that models and routes will be searched from.
-     * @param {Logger} logger The logging utility to use for outputing to console/file.
-     * @param objectFactory The object factory to use for automatic dependency injection (IOC).
+     * @param options The configuration options to apply for this server.
      */
-    constructor(config: any, basePath?: string, logger?: any, objectFactory?: ObjectFactory);
+    constructor(options: ServerOptions);
     /**
      * Returns the HTTP router instance.
      */

package/dist/types/decorators/DocDecorators.d.ts

@@ -67,3 +67,12 @@ export declare function Returns(types?: any | any[]): (target: any, propertyKey:
  * becomes `[[Array, MyClass]]`).
  */
 export declare function TypeInfo(types?: any | any[]): (target: any, propertyKey: string) => void;
+/**
+ * Retrieves the typing information of a class property or function, preferring the richer description provided by
+ * `@TypeInfo` and falling back to TypeScript's own `design:type` reflection metadata when `@TypeInfo` was not
+ * applied.
+ *
+ * @param target The class prototype (or class, for static members) to retrieve type information for.
+ * @param propertyKey The name of the property or function to retrieve type information for.
+ */
+export declare function getTypeInfo(target: any, propertyKey: string): any;

package/dist/types/decorators/PersistenceDecorators.d.ts

@@ -26,6 +26,13 @@ export interface ColumnOptions {
     primary?: boolean;
     /** Set to `true` if the column stores a MongoDB `ObjectId` value. */
     isObjectId?: boolean;
+    /**
+     * Explicitly declares the SQL column type, overriding the type that would otherwise be inferred from
+     * TypeScript's reflected property type. Required whenever the design-time type cannot be reliably inferred,
+     * such as nullable/union-typed properties (which TypeScript reflects as `Object`) or properties whose value is
+     * a complex/nested structure that has no direct SQL column equivalent (e.g. `"simple-json"`).
+     */
+    type?: string | Function;
 }
 /**
  * The set of options to use when declaring a persistent class type via the `@Entity` decorator.

package/dist/types/routes/BaseAdminRoute.d.ts

@@ -0,0 +1,59 @@
+import { JWTUser } from "@rapidrest/core";
+import { Redis } from "ioredis";
+import Transport from "winston-transport";
+import { type UWSWebSocketShim } from "../http/WebSocket.js";
+/**
+ * Implements a Winston transport that pipes incoming log messages to a configured redis pubsub channel.
+ */
+export declare class RedisTransport extends Transport {
+    private channel;
+    private redis;
+    constructor(opts: any);
+    close(): void;
+    log(info: any, next: Function): any;
+}
+/**
+ * The `BaseAdminRoute` class provides a base set of endpoints that gives trusted users the ability to perform common adminstrative actions
+ * with the server.
+ *
+ * Exposed endpoints:
+ *
+ * | Name | HTTP Method | What it does |
+ * | --- | --- | --- |
+ * | `clearCache` | `GET /<base_path>/clear-cache` | Clears the Redis-based cache system. |
+ * | `logs` | `UPGRADE /<base_path>/logs` | Live tail the service logs |
+ * | `getReleaseNotes` | `GET /<base_path>/release-notes` | Retrieve the server release notes. |
+ * | `restart` | `GET /<base_path>/restart` | ` Restart the server |
+ *
+ * !!Note!! that the `BaseAdminRoute` is not automatically registered with a server by default. You must create
+ * your own class that extends `AdminRoute` and apply the desired base path with `@Route()`.
+ *
+ * @example
+ * ```ts
+ * import { BaseAdminRoute, RouteDecorators } from "@rapidrest/service-core";
+ * const { Route } = RouteDecorators;
+ *
+ * @Route("/admin")
+ * export class AdminRoute extends BaseAdminRoute {}
+ * ```
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export declare class BaseAdminRoute {
+    /** A map of user uid's to active sockets. */
+    protected activeSockets: Map<string, any[]>;
+    protected cacheClient?: Redis;
+    protected cacheConnConfig: any;
+    protected logger: any;
+    protected logsConnConfig: any;
+    protected redisClient?: Redis;
+    /** The underlying ReleaseNotes specification. */
+    protected releaseNotes?: string;
+    protected serviceName?: string;
+    protected trustedRoles: string[];
+    protected init(): Promise<void>;
+    clearCache(user?: JWTUser): Promise<void>;
+    logs(socket: UWSWebSocketShim, user: JWTUser): Promise<void>;
+    getReleaseNotes(user?: JWTUser): string | undefined;
+    restart(user?: JWTUser): void;
+}

package/dist/types/routes/BaseMetricsRoute.d.ts

@@ -0,0 +1,37 @@
+import * as prom from "prom-client";
+import { JWTUser } from "@rapidrest/core";
+/**
+ * The `BaseMetricsRoute` class provides a base set of endpoints for exposing Prometheus metrics.
+ *
+ * Exposed endpoints:
+ *
+ * | Name | HTTP Method | What it does |
+ * | --- | --- | --- |
+ * | `getMetrics` | `GET /<base_path>` | Returns all Prometheus metrics gathered by the system |
+ * | `getSingleMetric` | `GET /<base_path>/:metric` | Returns a single Prometheus metric with the given name |
+ *
+ * Services that wish to provide metrics to be exposed via this route can register them using the global registry
+ * from the provided `prom-client` dependency. See the `prom-client` documentation for more details.
+ *
+ * !!Note!! that the `BaseMetricsRoute` is not automatically registered with a server by default. You must create
+ * your own class that extends `AdminRoute` and apply the desired base path with `@Route()`.
+ *
+ * @example
+ * ```ts
+ * import { BaseMetricsRoute, RouteDecorators } from "@rapidrest/service-core";
+ * const { Route } = RouteDecorators;
+ *
+ * @Route("/metrics")
+ * export class MetricsRoute extends BaseMetricsRoute {}
+ * ```
+ */
+export declare class BaseMetricsRoute {
+    protected metricsConfig: {
+        authRequired: boolean;
+    };
+    protected registry: prom.Registry;
+    protected trustedRoles: string[];
+    constructor();
+    getMetrics(user?: JWTUser): Promise<string>;
+    getSingleMetric(metric: any, user?: JWTUser): Promise<string>;
+}

package/dist/types/routes/BaseOpenAPIRoute.d.ts

@@ -0,0 +1,33 @@
+import { OpenApiSpec } from "../OpenApiSpec.js";
+/**
+ * The `BaseOpenAPIRoute` class provides a base set of endpoints exposing the server's OpenAPI specification.
+ *
+ * Exposed endpoints:
+ *
+ * | Name | HTTP Method | What it does |
+ * | --- | --- | --- |
+ * | `getHTML` | `GET /<base_path>` | Swagger UI HTML (loads swagger-ui-dist from CDN) |
+ * | `getJSON` | `GET /<base_path>/json` | raw OpenAPI specification as JSON |
+ * | `getYAML` | `GET /<base_path>/yaml` | raw OpenAPI specification as YAML |
+ *
+ * !!Note!! that the `BaseAdminRoute` is not automatically registered with a server by default. You must create
+ * your own class that extends `AdminRoute` and apply the desired base path with `@Route()`.
+ *
+ * @example
+ * ```ts
+ * import { BaseOpenAPIRoute, RouteDecorators } from "@rapidrest/service-core";
+ * const { Route } = RouteDecorators;
+ *
+ * @Route("/openapi")
+ * export class OpenAPIRoute extends BaseOpenAPIRoute {}
+ * ```
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export declare class BaseOpenAPIRoute {
+    /** The underlying OpenAPI specification. */
+    protected apiSpec: OpenApiSpec;
+    getHTML(): string;
+    getJSON(): any;
+    getYAML(): string;
+}

package/dist/types/routes/BasePushRoute.d.ts

@@ -0,0 +1,39 @@
+import ws from "ws";
+/**
+ * The `BasePushRoute` class provides a base set of endpoints for implement client push notifications.
+ *
+ * Exposed endpoints:
+ *
+ * | Name | HTTP Method | What it does |
+ * | --- | --- | --- |
+ * | `connect` | `UPGRADE /<base_path>/connect` | Establishes a connection to the push notification system. |
+ * | `send` | `POST /<base_path>/:id` | Sends a push notification message to the channel with the given id |
+ *
+ * !!Note!! that the `BasePushRoute` is not automatically registered with a server by default. You must create
+ * your own class that extends `AdminRoute` and apply the desired base path with `@Route()`.
+ *
+ * @example
+ * ```ts
+ * import { BasePushRoute, RouteDecorators } from "@rapidrest/service-core";
+ * const { Route } = RouteDecorators;
+ *
+ * @Route("/push")
+ * export class PushRoute extends BasePushRoute {}
+ * ```
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export declare class BasePushRoute {
+    private aclUtils?;
+    /** A map of active socket connections to users.  */
+    private activeSocks;
+    /** A map of active subscription uids to users. */
+    private activeSubs;
+    private logger;
+    private redisConfig;
+    /** A persistent redis client used to publish outgoing push messages. */
+    private redisPub?;
+    private init;
+    connect(sock: ws, user: any): Promise<void>;
+    send(id: string, msg: any, user: any): Promise<void>;
+}

package/dist/types/routes/BaseStatusRoute.d.ts

@@ -0,0 +1,37 @@
+import { StatusExtraData } from "../models/StatusExtraData.js";
+/**
+ * The `BaseStatusRoute` class provides a base set of endpoints exposing status metadata information about the server.
+ *
+ * Included Metadata:
+ * | Name | Description |
+ * | --- | --- |
+ * | `name` | The name of the server (e.g. `petstore_example`) |
+ * | `time` | The current UTC timestamp of the server |
+ * | `version` | The release version of the server. (e.g. `1.0.0`) |
+ *
+ * Exposed endpoints:
+ *
+ * | Name | HTTP Method | What it does |
+ * | --- | --- | --- |
+ * | `get` | `GET /<base_path>` | Returns the server's status metadata |
+ *
+ * !!Note!! that the `BaseAdminRoute` is not automatically registered with a server by default. You must create
+ * your own class that extends `AdminRoute` and apply the desired base path with `@Route()`.
+ *
+ * @example
+ * ```ts
+ * import { BaseStatusRoute, RouteDecorators } from "@rapidrest/service-core";
+ * const { Route } = RouteDecorators;
+ *
+ * @Route("/status")
+ * export class StatusRoute extends BaseStatusRoute {}
+ * ```
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export declare class BaseStatusRoute {
+    protected serviceName: any;
+    protected serviceVersion: any;
+    protected statusExtraData: StatusExtraData | undefined;
+    get(): any;
+}

package/dist/types/routes/CRUDRoute.d.ts

@@ -13,16 +13,19 @@ import { ModelRoute, UpdateObject } from "./ModelRoute.js";
  * is enabled these handlers will still validate permissions appropriately.
  *
  * Included Endpoints:
- * * `count` [`HEAD /`]: Counts the number of objects matching the provided set of criteria in the request's query parameters. Returns the count as the value of the `Content-Length` header.
- * * `create` [`POST /`]- Adds one or more new objects to the datastore.
- * * `delete` [`DELETE /:id`]: Removes an existing object from the datastore.
- * * `exists` [`HEAD /:id`]: Checks if the object with the given ID exists in the datastore. Sets `Content-Length` header to `1` if the object exists, otherwise `0`.
- * * `find` [`GET /`]: Returns all objects matching the provided set of criteria in the request's query parameters.
- * * `findById` [`GET /:id`]: Returns a single object with a specified unique identifier.
- * * `truncate` [`DELETE /`]: Removes all objects from the datastore.
- * * `update` [`PUT /:id`]: Modifies an existing object in the datastore.
- * * `updateBulk` [`PUT /`]: Modifies multiple existing objects in the datastore.
- * * `updateProperty` [`PUT /:id/:property`]: Modifies an single property of the given name of an existing object in the datastore.
+ *
+ * | Name | HTTP Method | What it does |
+ * | --- | --- | --- |
+ * | `count` | `HEAD /` | Counts the number of objects matching the provided set of criteria in the request's query parameters. Returns the count as the value of the `Content-Length` header. |
+ * | `create` | `POST /` | Adds one or more new objects to the datastore. |
+ * | `delete` | `DELETE /:id` | Removes an existing object from the datastore. |
+ * | `exists` | `HEAD /:id` | Checks if the object with the given ID exists in the datastore. Sets `Content-Length` header to `1` if the object exists, otherwise `0`. |
+ * | `find` | `GET /` | Returns all objects matching the provided set of criteria in the request's query parameters. |
+ * | `findById` | `GET /:id` | Returns a single object with a specified unique identifier. |
+ * | `truncate` | `DELETE /` | Removes all objects from the datastore. |
+ * | `update` | `PUT /:id` | Modifies an existing object in the datastore. |
+ * | `updateBulk` | `PUT /` | Modifies multiple existing objects in the datastore. |
+ * | `updateProperty` | `PUT /:id/:property` | Modifies an single property of the given name of an existing object in the datastore. |
  *
  * @author Jean-Philippe Steinmetz
  */

package/dist/types/routes/index.d.ts

@@ -1,7 +1,8 @@
-export * from "./AdminRoute.js";
+export * from "./BaseAdminRoute.js";
+export * from "./BaseMetricsRoute.js";
+export * from "./BaseOpenAPIRoute.js";
+export * from "./BasePushRoute.js";
+export * from "./BaseStatusRoute.js";
 export * from "./CRUDRoute.js";
-export * from "./MetricsRoute.js";
 export * from "./ModelRoute.js";
-export * from "./OpenAPIRoute.js";
 export * from "./RouteUtils.js";
-export * from "./StatusRoute.js";

package/dist/types/security/ACLUtils.d.ts

@@ -45,7 +45,7 @@ export declare class ACLUtils {
      * @param entityId The unique identifier of the ACL to retrieve.
      * @param parentUids The list of already found parent UIDs. This is used to break circular dependencies.
      */
-    findACL(entityId: string, parentUids?: string[], reqCache?: Map<string, AccessControlList | null>): Promise<AccessControlList | null>;
+    findACL(entityId: string, parentUids?: string[], reqCache?: Map<string, AccessControlList | undefined>): Promise<AccessControlList | undefined>;
     /**
      * Deletes the ACL with the given identifier from the database.
      * @param uid The unique identifier of the ACL to remove.

package/dist/types/security/AccessControlList.d.ts

@@ -90,7 +90,7 @@ export interface AccessControlList {
     /**
      * The parent access control list that this instance inherits permissions from.
      */
-    parent?: AccessControlList | null;
+    parent?: AccessControlList;
     /**
      * The universally unique identifier of the parent `AccessControlList` that this object will inherit permissions
      * from.

package/dist/types/security/AccessControlListMongo.d.ts

@@ -18,7 +18,7 @@ export declare class ACLRecordMongo implements ACLRecord {
  */
 export declare class AccessControlListMongo extends BaseMongoEntity implements AccessControlList {
     parent?: AccessControlList;
-    parentUid?: string | undefined;
+    parentUid?: string;
     records: ACLRecordMongo[];
     constructor(other?: any);
 }

package/dist/types/security/AccessControlListSQL.d.ts

@@ -18,7 +18,7 @@ export declare class ACLRecordSQL implements ACLRecord {
  */
 export declare class AccessControlListSQL extends BaseEntity implements AccessControlList {
     parent?: AccessControlList;
-    parentUid?: string | undefined;
+    parentUid?: string;
     records: ACLRecordSQL[];
     constructor(other?: any);
 }