@decaf-ts/for-http 0.3.38 → 0.3.39

package/lib/stream/ServerEventConnector.cjs

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerEventConnector = void 0;
+const event_source_plus_1 = require("event-source-plus");
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+class ServerEventConnector {
+    static { this.cache = new Map(); }
+    static get(url) {
+        if (this.cache.has(url))
+            return this.cache.get(url);
+        throw new Error(`Server event connector not found for URL '${url}'. Did you forget to call open()?`);
+    }
+    static open(url) {
+        if (this.cache.has(url))
+            return this.cache.get(url);
+        const connector = new ServerEventConnector(url);
+        this.cache.set(url, connector);
+        return this.cache.get(url);
+    }
+    static parseReceivedEvent(raw) {
+        try {
+            const data = typeof raw === "string" ? JSON.parse(raw) : raw;
+            if (!Array.isArray(data) || data.length < 3)
+                return null;
+            const [eventName, operationKey, objectId, rawPayload] = data;
+            if (typeof eventName !== "string")
+                return null;
+            const payload = typeof rawPayload === "string"
+                ? decorator_validation_1.Serialization.deserialize(rawPayload)
+                : rawPayload;
+            return [eventName, String(operationKey), objectId, payload];
+        }
+        catch {
+            return null;
+        }
+    }
+    constructor(url) {
+        this.url = url;
+        this.listeners = new Set();
+    }
+    isOpen() {
+        return this.es !== undefined;
+    }
+    close() {
+        if (!this.es)
+            return;
+        if (this.listeners.size > 0)
+            return;
+        // Close and drop from cache.
+        try {
+            this.controller?.abort();
+        }
+        finally {
+            this.controller = undefined;
+            this.es = undefined;
+            this.listeners.clear();
+            ServerEventConnector.cache.delete(this.url);
+            console.log(`EventSourcePlus close for ${this.url}`);
+        }
+    }
+    /**
+     * Increments refCount and ensures EventSource is created.
+     * This method must be called only on the shared singleton instance.
+     */
+    startListening(handlers, headers) {
+        if (this.es)
+            return; // already listening. TODO: Add log
+        const url = this.url;
+        this.es = new event_source_plus_1.EventSourcePlus(url, {
+            headers,
+            credentials: "include",
+        });
+        this.controller = this.es.listen({
+            onResponse: () => {
+                console.log("EventSourcePlus connected");
+            },
+            onRequestError: ({ error }) => {
+                console.log("EventSourcePlus request error:", error);
+                handlers.onError(String(error?.message ?? error));
+            },
+            onResponseError: ({ response }) => {
+                console.log("EventSourcePlus response error:", response);
+                handlers.onError(`HTTP ${response.status}`);
+            },
+            onMessage: (message) => {
+                const raw = message && typeof message === "object" && "data" in message
+                    ? message.data
+                    : message;
+                const event = ServerEventConnector.parseReceivedEvent(raw);
+                if (!event)
+                    return;
+                handlers.onEvent(event);
+            },
+        });
+        setInterval(() => {
+            this.close();
+        }, 30000);
+    }
+    addListener(handlers) {
+        this.listeners.add(handlers);
+    }
+    removeListener(handlers) {
+        this.listeners.delete(handlers);
+    }
+}
+exports.ServerEventConnector = ServerEventConnector;
+//# sourceMappingURL=ServerEventConnector.js.map

package/lib/stream/ServerEventConnector.d.ts

@@ -0,0 +1,22 @@
+import { EventHandlers } from "./types";
+export declare class ServerEventConnector {
+    private readonly url;
+    private static readonly cache;
+    static get(url: string): ServerEventConnector;
+    static open(url: string): ServerEventConnector;
+    private static parseReceivedEvent;
+    /** Shared connection state (cached singleton instance). */
+    private es?;
+    private controller?;
+    private listeners;
+    constructor(url: string);
+    isOpen(): boolean;
+    close(): void;
+    /**
+     * Increments refCount and ensures EventSource is created.
+     * This method must be called only on the shared singleton instance.
+     */
+    startListening(handlers: EventHandlers, headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>)): void;
+    private addListener;
+    private removeListener;
+}

package/lib/stream/ServerEventConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerEventConnector.js","sourceRoot":"","sources":["../../src/stream/ServerEventConnector.ts"],"names":[],"mappings":";;;AACA,yDAAoD;AACpD,yEAA+D;AAE/D,MAAa,oBAAoB;aACP,UAAK,GAAG,IAAI,GAAG,EAAgC,AAA1C,CAA2C;IAExE,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAyB,CAAC;QAE5E,MAAM,IAAI,KAAK,CACb,6CAA6C,GAAG,mCAAmC,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAW;QACrB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAyB,CAAC;QAE5E,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAyB,CAAC;IACrD,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,GAAY;QAC5C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAEzD,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;YAC7D,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAE/C,MAAM,OAAO,GACX,OAAO,UAAU,KAAK,QAAQ;gBAC5B,CAAC,CAAC,oCAAa,CAAC,WAAW,CAAC,UAAU,CAAC;gBACvC,CAAC,CAAC,UAAU,CAAC;YAEjB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAQD,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;QAFhC,cAAS,GAAuB,IAAI,GAAG,EAAE,CAAC;IAEP,CAAC;IAE5C,MAAM;QACJ,OAAO,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;IAC/B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO;QAErB,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO;QAEpC,6BAA6B;QAC7B,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC5B,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACvB,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,cAAc,CACZ,QAAuB,EACvB,OAEoE;QAEpE,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,mCAAmC;QAExD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAErB,IAAI,CAAC,EAAE,GAAG,IAAI,mCAAe,CAAC,GAAG,EAAE;YACjC,OAAO;YACP,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;YAC/B,UAAU,EAAE,GAAG,EAAE;gBACf,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YAC3C,CAAC;YACD,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC5B,OAAO,CAAC,GAAG,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;gBACrD,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAE,KAAa,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,eAAe,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;gBAChC,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,QAAQ,CAAC,CAAC;gBACzD,QAAQ,CAAC,OAAO,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,SAAS,EAAE,CAAC,OAAY,EAAE,EAAE;gBAC1B,MAAM,GAAG,GACP,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,IAAI,OAAO;oBACzD,CAAC,CAAC,OAAO,CAAC,IAAI;oBACd,CAAC,CAAC,OAAO,CAAC;gBAEd,MAAM,KAAK,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;gBAC3D,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACnB,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;SACF,CAAC,CAAC;QAEH,WAAW,CAAC,GAAG,EAAE;YACf,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAEO,WAAW,CAAC,QAAuB;QACzC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAEO,cAAc,CAAC,QAAuB;QAC5C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;;AAzHH,oDA0HC"}

package/lib/stream/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ServerEventConnector.cjs"), exports);
+__exportStar(require("./types.cjs"), exports);
+//# sourceMappingURL=index.js.map

package/lib/stream/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./ServerEventConnector";
+export * from "./types";

package/lib/stream/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAAuC;AACvC,8CAAwB"}

package/lib/stream/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/stream/types.d.ts

@@ -0,0 +1,11 @@
+import { BulkCrudOperationKeys, OperationKeys } from "@decaf-ts/db-decorators";
+export type ServerEvent = readonly [
+    modelName: string,
+    operation: OperationKeys | BulkCrudOperationKeys | string,
+    id: string,
+    payload: any
+];
+export type EventHandlers = {
+    onEvent: ([tableName, operation, id]: ServerEvent) => void;
+    onError: (err: unknown) => void;
+};

package/lib/stream/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/stream/types.ts"],"names":[],"mappings":""}

package/lib/types.d.ts

@@ -12,6 +12,7 @@ export type HttpConfig = {
     protocol: "http" | "https";
     host: string;
     parsers?: ResponseParser[];
+    eventsListenerPath?: string;
 };
 /**
  * @description HTTP flags interface

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/for-http",
-  "version": "0.3.38",
+  "version": "0.3.39",
   "description": "http wrappers for decaf-ts",
   "type": "module",
   "exports": {
@@ -91,6 +91,7 @@
     "@decaf-ts/injectable-decorators": "latest",
     "@decaf-ts/logging": "latest",
     "@decaf-ts/transactional-decorators": "latest",
-    "axios": "^1.13.2"
+    "axios": "^1.13.2",
+    "event-source-plus": "^0.1.15"
   }
 }