@rapidrest/service-core 1.0.0-beta.1

package/dist/lib/http/WebSocket.js

@@ -0,0 +1,82 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+///////////////////////////////////////////////////////////////////////////////
+import { EventEmitter } from "events";
+import { Duplex } from "stream";
+/**
+ * Wraps a uWS `WebSocket` handle and exposes an EventEmitter-based API compatible
+ * with what route handlers (e.g. `AdminRoute`) expect.
+ *
+ * uWS WebSockets fire events via behavior callbacks on the route, not on the socket
+ * object itself. This shim bridges that gap by:
+ * - Forwarding `message` / `close` events from the route behavior to this emitter.
+ * - Exposing `send(data, cb?)` and `close(code?, reason?)` that delegate to uWS.
+ *
+ * The Router's `ws()` implementation stores the shim in `ws.getUserData()` so that
+ * behavior callbacks can call `shim.emit(...)`.
+ */
+export class UWSWebSocketShim extends EventEmitter {
+    constructor(ws) {
+        super();
+        this.readyState = 1; // OPEN
+        this._ws = ws;
+    }
+    /**
+     * Sends data over the WebSocket connection.
+     * @param data The data to send.
+     * @param cb Optional callback invoked on completion or error.
+     */
+    send(data, cb) {
+        try {
+            const ok = this._ws.send(typeof data === "string" ? data : Buffer.from(data), typeof data !== "string");
+            if (cb)
+                cb(ok ? undefined : new Error("uWS backpressure: send failed"));
+        }
+        catch (err) {
+            if (cb)
+                cb(err);
+        }
+    }
+    /**
+     * Closes the WebSocket connection with an optional code and reason.
+     */
+    close(code, reason) {
+        try {
+            this._ws.end(code, reason);
+        }
+        catch {
+            // Socket may already be closed
+        }
+    }
+}
+/**
+ * Creates a Node.js `Duplex` stream from a `UWSWebSocketShim`, compatible with the
+ * `createWebSocketStream` API from the `ws` library.
+ *
+ * Incoming WebSocket messages are pushed as readable data; writes to the stream are
+ * forwarded as WebSocket messages.
+ */
+export function createWebSocketStream(shim) {
+    const duplex = new Duplex({
+        read() { return; },
+        write(chunk, _encoding, callback) {
+            shim.send(chunk, (err) => callback(err));
+        },
+        final(callback) {
+            shim.close(1000);
+            callback();
+        },
+    });
+    shim.on("message", (data) => {
+        duplex.push(data);
+    });
+    shim.on("close", () => {
+        duplex.push(null);
+        duplex.destroy();
+    });
+    duplex.on("close", () => {
+        shim.close(1000);
+    });
+    return duplex;
+}
+//# sourceMappingURL=WebSocket.js.map

package/dist/lib/http/WebSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocket.js","sourceRoot":"","sources":["../../../src/http/WebSocket.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAuBhC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAI9C,YAAY,EAAkB;QAC1B,KAAK,EAAE,CAAC;QAHL,eAAU,GAAW,CAAC,CAAC,CAAC,OAAO;QAIlC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAC,IAAS,EAAE,EAA0B;QAC7C,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CACpB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EACnD,OAAO,IAAI,KAAK,QAAQ,CAC3B,CAAC;YACF,IAAI,EAAE;gBAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,IAAI,EAAE;gBAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAa,EAAE,MAAe;QACvC,IAAI,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACL,+BAA+B;QACnC,CAAC;IACL,CAAC;CACJ;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAsB;IACxD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACtB,IAAI,KAAK,OAAO,CAAC,CAAC;QAClB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ;YAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,CAAC,QAAQ;YACV,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjB,QAAQ,EAAE,CAAC;QACf,CAAC;KACJ,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAS,EAAE,EAAE;QAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAClB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/lib/http/index.js

@@ -0,0 +1,4 @@
+export { UWSRequest, UWSResponse, readBody } from "./Adapters.js";
+export { HttpRouter, runChain } from "./Router.js";
+export { UWSWebSocketShim, createWebSocketStream } from "./WebSocket.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/http/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/http/types.js

@@ -0,0 +1,5 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+///////////////////////////////////////////////////////////////////////////////
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/http/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/http/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,+EAA+E"}

package/dist/lib/index.js

@@ -0,0 +1,18 @@
+export * from "./ApiErrors.js";
+export * from "./BackgroundService.js";
+export * from "./BackgroundServiceManager.js";
+export * from "./BulkError.js";
+export * from "./EventListenerManager.js";
+export * from "./NetUtils.js";
+export * from "./NotificationUtils.js";
+export * from "./ObjectFactory.js";
+export * from "./OpenApiSpec.js";
+export * from "./Server.js";
+export * from "./Types.js";
+export * from "./database/index.js";
+export * from "./decorators/index.js";
+export * from "./models/index.js";
+export * from "./auth/index.js";
+export * from "./routes/index.js";
+export * from "./security/index.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/lib/models/BaseEntity.js

@@ -0,0 +1,83 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+///////////////////////////////////////////////////////////////////////////////
+import { Default, Description } from "../decorators/DocDecorators.js";
+import { Identifier } from "../decorators/ModelDecorators.js";
+import { Column, Index, PrimaryColumn } from "../decorators/PersistenceDecorators.js";
+import * as uuid from "uuid";
+/**
+ * Provides a common base class for all entity's that will be persisted to a datastore.
+ *
+ * Note that the `@CreateDateColumn`, `@UpdateDateColumn`, and `@VersionColumn` decorators from TypeORM are not supported
+ * because they are not implemented in TypeORM's MongoDB support. They are instead implemented directly by this
+ * library as part of `ModelRoute`.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class BaseEntity {
+    constructor(other) {
+        /**
+         * The universally unique identifier of the entity.
+         */
+        this.uid = uuid.v4();
+        /**
+         * The date and time that the entity was created.
+         */
+        this.dateCreated = new Date();
+        /**
+         * The date and time that the entity was last modified.
+         */
+        this.dateModified = new Date();
+        /**
+         * The optimistic lock version.
+         */
+        this.version = 0;
+        if (other) {
+            this.uid = "uid" in other && other.uid !== undefined ? other.uid : this.uid;
+            this.dateCreated =
+                typeof other.dateCreated === "string"
+                    ? new Date(other.dateCreated)
+                    : other.dateCreated || this.dateCreated;
+            this.dateModified =
+                typeof other.dateModified === "string"
+                    ? new Date(other.dateModified)
+                    : other.dateModified || this.dateModified;
+            this.version = "version" in other && other.version !== undefined ? other.version : this.version;
+        }
+    }
+}
+__decorate([
+    Description("The universally unique identifier of the entity."),
+    Default("randomUUID()"),
+    Identifier,
+    Index("uid", { unique: true }),
+    PrimaryColumn(),
+    __metadata("design:type", String)
+], BaseEntity.prototype, "uid", void 0);
+__decorate([
+    Description("The date and time that the entity was created."),
+    Default("new Date()"),
+    Column(),
+    __metadata("design:type", Date)
+], BaseEntity.prototype, "dateCreated", void 0);
+__decorate([
+    Description("The date and time that the entity was last modified."),
+    Default("new Date()"),
+    Column(),
+    __metadata("design:type", Date)
+], BaseEntity.prototype, "dateModified", void 0);
+__decorate([
+    Description("The optimistic lock version."),
+    Column(),
+    __metadata("design:type", Number)
+], BaseEntity.prototype, "version", void 0);
+//# sourceMappingURL=BaseEntity.js.map

package/dist/lib/models/BaseEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseEntity.js","sourceRoot":"","sources":["../../../src/models/BaseEntity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,+EAA+E;AAC/E,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,OAAgB,UAAU;IAkC5B,YAAY,KAA2B;QAjCvC;;WAEG;QAMI,QAAG,GAAW,IAAI,CAAC,EAAE,EAAE,CAAC;QAE/B;;WAEG;QAII,gBAAW,GAAS,IAAI,IAAI,EAAE,CAAC;QAEtC;;WAEG;QAII,iBAAY,GAAS,IAAI,IAAI,EAAE,CAAC;QAEvC;;WAEG;QAGI,YAAO,GAAW,CAAC,CAAC;QAGvB,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,GAAG,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAC5E,IAAI,CAAC,WAAW;gBACZ,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;oBACjC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;oBAC7B,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC;YAChD,IAAI,CAAC,YAAY;gBACb,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;oBAClC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;oBAC9B,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC;YAClD,IAAI,CAAC,OAAO,GAAG,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QACpG,CAAC;IACL,CAAC;CACJ;AAvCU;IALN,WAAW,CAAC,kDAAkD,CAAC;IAC/D,OAAO,CAAC,cAAc,CAAC;IACvB,UAAU;IACV,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC9B,aAAa,EAAE;;uCACe;AAQxB;IAHN,WAAW,CAAC,gDAAgD,CAAC;IAC7D,OAAO,CAAC,YAAY,CAAC;IACrB,MAAM,EAAE;8BACW,IAAI;+CAAc;AAQ/B;IAHN,WAAW,CAAC,sDAAsD,CAAC;IACnE,OAAO,CAAC,YAAY,CAAC;IACrB,MAAM,EAAE;8BACY,IAAI;gDAAc;AAOhC;IAFN,WAAW,CAAC,8BAA8B,CAAC;IAC3C,MAAM,EAAE;;2CACkB"}

package/dist/lib/models/BaseMongoEntity.js

@@ -0,0 +1,40 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz. All rights reserved.
+///////////////////////////////////////////////////////////////////////////////
+import { Column } from "../decorators/PersistenceDecorators.js";
+import { BaseEntity } from "./BaseEntity.js";
+import { ObjectId } from "mongodb";
+import { ObjectDecorators } from "@rapidrest/core";
+const { Nullable } = ObjectDecorators;
+/**
+ * Provides a common base class for all entity's that will be persisted in a MongoDB database.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class BaseMongoEntity extends BaseEntity {
+    constructor(other) {
+        super(other);
+        if (other) {
+            this._id = other._id
+                ? typeof other._id === "string" || typeof other._id === "number"
+                    ? new ObjectId(String(other._id))
+                    : other._id
+                : this._id;
+        }
+    }
+}
+__decorate([
+    Column({ isObjectId: true }),
+    Nullable,
+    __metadata("design:type", Object)
+], BaseMongoEntity.prototype, "_id", void 0);
+//# sourceMappingURL=BaseMongoEntity.js.map

package/dist/lib/models/BaseMongoEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseMongoEntity.js","sourceRoot":"","sources":["../../../src/models/BaseMongoEntity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,+EAA+E;AAC/E,wEAAwE;AACxE,+EAA+E;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,wCAAwC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC;AAEtC;;;;GAIG;AACH,MAAM,OAAgB,eAAgB,SAAQ,UAAU;IAQpD,YAAY,KAAgC;QACxC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEb,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG;gBAChB,CAAC,CAAC,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;oBAC5D,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACjC,CAAC,CAAC,KAAK,CAAC,GAAG;gBACf,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACnB,CAAC;IACL,CAAC;CACJ;AAbU;IAFN,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC5B,QAAQ;;4CACQ"}