@webiny/api-websockets-standalone 0.0.0-unstable.0156a4c312

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Webiny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @webiny/api-websockets-standalone
+
+> [!NOTE]
+> This package is part of the [Webiny](https://www.webiny.com) monorepo.
+> It’s **included in every Webiny project by default** and is not meant to be used as a standalone package.
+
+📘 **Documentation:** [https://www.webiny.com/docs](https://www.webiny.com/docs)
+
+---
+
+_This README file is automatically generated during the publish process._

package/WebsocketsStandaloneFeature.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Per-request real-time transport for the standalone server: registers `ServerWebsocketsTransport`,
+ * overriding the domain's NullWebsocketsTransport. Resolves the shared connection manager + adapter
+ * from the root (registered there as singletons by the handler). Exposed as a Feature so the handler's
+ * `transports` wiring reads uniformly (`WebsocketsStandaloneFeature.register(c)`).
+ */
+export declare const WebsocketsStandaloneFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/WebsocketsStandaloneFeature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { ServerWebsocketsTransport } from "./transport/ServerWebsocketsTransport.js";
+const WebsocketsStandaloneFeature = createFeature({
+    name: "WebsocketsServer",
+    register (container) {
+        container.register(ServerWebsocketsTransport);
+    }
+});
+export { WebsocketsStandaloneFeature };
+
+//# sourceMappingURL=WebsocketsStandaloneFeature.js.map

package/WebsocketsStandaloneFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebsocketsStandaloneFeature.js","sources":["../src/WebsocketsStandaloneFeature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { ServerWebsocketsTransport } from \"~/transport/ServerWebsocketsTransport.js\";\n\n/**\n * Per-request real-time transport for the standalone server: registers `ServerWebsocketsTransport`,\n * overriding the domain's NullWebsocketsTransport. Resolves the shared connection manager + adapter\n * from the root (registered there as singletons by the handler). Exposed as a Feature so the handler's\n * `transports` wiring reads uniformly (`WebsocketsStandaloneFeature.register(c)`).\n */\nexport const WebsocketsStandaloneFeature = createFeature({\n    name: \"WebsocketsServer\",\n    register(container) {\n        container.register(ServerWebsocketsTransport);\n    }\n});\n"],"names":["WebsocketsStandaloneFeature","createFeature","container","ServerWebsocketsTransport"],"mappings":";;AASO,MAAMA,8BAA8BC,cAAc;IACrD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/adapter/NodeWsAdapter.d.ts

@@ -0,0 +1,27 @@
+import type { Server as HttpServer } from "node:http";
+import type { IncomingMessage } from "node:http";
+import type { Duplex } from "node:stream";
+import { WebSocket } from "ws";
+import { WebsocketsServerAdapter } from "./abstractions.js";
+declare class NodeWsAdapterImpl implements WebsocketsServerAdapter.Interface<WebSocket> {
+    private wss;
+    private pingTimer;
+    private readonly answered;
+    private pingInterval;
+    static withPingInterval(pingInterval: number): NodeWsAdapterImpl;
+    private getWss;
+    start(_server: HttpServer): void;
+    handleUpgrade(request: IncomingMessage, socket: Duplex, head: Buffer): void;
+    stop(): Promise<void>;
+    private pingAll;
+    onConnection(cb: (socket: WebSocket, request: import("node:http").IncomingMessage) => void): void;
+    onMessage(socket: WebSocket, cb: (data: Buffer) => void): void;
+    onClose(socket: WebSocket, cb: (code: number, reason: Buffer) => void): void;
+    onError(socket: WebSocket, cb: (error: Error) => void): void;
+    send(socket: WebSocket, data: string): Promise<void>;
+    close(socket: WebSocket, code?: number, reason?: string): void;
+}
+export { NodeWsAdapterImpl };
+export declare const NodeWsAdapter: typeof NodeWsAdapterImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IWebsocketsServerAdapter<unknown>>;
+};

package/adapter/NodeWsAdapter.js

@@ -0,0 +1,111 @@
+import { WebSocket, WebSocketServer } from "ws";
+import { WebsocketsServerAdapter } from "./abstractions.js";
+const MAX_PAYLOAD_BYTES = 65536;
+const SERVICE_RESTART = 1012;
+const CLOSE_WAIT_MS = 1000;
+const PING_INTERVAL_MS = 30000;
+const closeForRestart = (client)=>new Promise((resolve)=>{
+        if (client.readyState === WebSocket.CLOSED) return void resolve();
+        const timer = setTimeout(()=>{
+            client.terminate();
+        }, CLOSE_WAIT_MS);
+        client.once("close", ()=>{
+            clearTimeout(timer);
+            resolve();
+        });
+        client.close(SERVICE_RESTART, "Server restarting");
+    });
+class NodeWsAdapterImpl {
+    static withPingInterval(pingInterval) {
+        const adapter = new NodeWsAdapterImpl();
+        adapter.pingInterval = pingInterval;
+        return adapter;
+    }
+    getWss() {
+        if (!this.wss) throw new Error("WebSocketServer has not been started. Call start() first.");
+        return this.wss;
+    }
+    start(_server) {
+        if (this.wss) return;
+        const wss = new WebSocketServer({
+            noServer: true,
+            maxPayload: MAX_PAYLOAD_BYTES
+        });
+        wss.on("connection", (socket)=>{
+            this.answered.add(socket);
+            socket.on("pong", ()=>{
+                this.answered.add(socket);
+            });
+        });
+        this.wss = wss;
+        this.pingTimer = setInterval(()=>{
+            this.pingAll(wss);
+        }, this.pingInterval);
+    }
+    handleUpgrade(request, socket, head) {
+        this.getWss().handleUpgrade(request, socket, head, (ws)=>{
+            this.getWss().emit("connection", ws, request);
+        });
+    }
+    async stop() {
+        const wss = this.wss;
+        if (!wss) return;
+        this.wss = void 0;
+        clearInterval(this.pingTimer);
+        const clients = [
+            ...wss.clients
+        ];
+        const closing = clients.map(closeForRestart);
+        await Promise.all(closing);
+        await new Promise((resolve, reject)=>{
+            wss.close((err)=>{
+                if (err) return void reject(err);
+                resolve();
+            });
+        });
+    }
+    pingAll(wss) {
+        for (const socket of wss.clients){
+            if (!this.answered.has(socket)) {
+                socket.terminate();
+                continue;
+            }
+            this.answered.delete(socket);
+            if (socket.readyState === WebSocket.OPEN) socket.ping();
+        }
+    }
+    onConnection(cb) {
+        this.getWss().on("connection", cb);
+    }
+    onMessage(socket, cb) {
+        socket.on("message", cb);
+    }
+    onClose(socket, cb) {
+        socket.on("close", cb);
+    }
+    onError(socket, cb) {
+        socket.on("error", cb);
+    }
+    send(socket, data) {
+        return new Promise((resolve, reject)=>{
+            socket.send(data, (err)=>{
+                if (err) return void reject(err);
+                resolve();
+            });
+        });
+    }
+    close(socket, code, reason) {
+        socket.close(code, reason);
+    }
+    constructor(){
+        this.answered = new WeakSet();
+        this.pingInterval = PING_INTERVAL_MS;
+    }
+}
+const NodeWsAdapter = WebsocketsServerAdapter.createImplementation({
+    implementation: NodeWsAdapterImpl,
+    dependencies: []
+});
+export { NodeWsAdapter, NodeWsAdapterImpl };
+
+//# sourceMappingURL=NodeWsAdapter.js.map

package/adapter/NodeWsAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter/NodeWsAdapter.js","sources":["../../src/adapter/NodeWsAdapter.ts"],"sourcesContent":["import type { Server as HttpServer } from \"node:http\";\nimport type { IncomingMessage } from \"node:http\";\nimport type { Duplex } from \"node:stream\";\nimport { WebSocketServer } from \"ws\";\nimport { WebSocket } from \"ws\";\nimport { WebsocketsServerAdapter } from \"./abstractions.js\";\n\n/*\n * Clients only send small JSON envelopes (a ping carrying a token). The `ws` default is 100 MiB,\n * which any client, authenticated or not, could make the server buffer per message.\n */\nconst MAX_PAYLOAD_BYTES = 64 * 1024;\n\n/*\n * Sent to every client when the server stops. 1012 means \"service restart\": the client reconnects,\n * and behind a load balancer it reaches a process that is still up.\n */\nconst SERVICE_RESTART = 1012;\n\n// How long a client gets to answer the close before its socket is cut.\nconst CLOSE_WAIT_MS = 1000;\n\n/*\n * How often every open socket gets a WebSocket ping frame. Proxies and load balancers close a\n * connection that carries nothing for a while (60 seconds by default on nginx and AWS ALB), and the\n * admin's own ping comes only every 5 minutes. Browsers answer ping frames by themselves; no client\n * code is involved, and nothing is written to the registry.\n */\nconst PING_INTERVAL_MS = 30_000;\n\n/*\n * Closes the socket with `SERVICE_RESTART` and resolves once it is closed. A client that has not\n * answered within `CLOSE_WAIT_MS` (a frozen tab, a dead network) is cut.\n */\nconst closeForRestart = (client: WebSocket): Promise<void> => {\n    return new Promise(resolve => {\n        if (client.readyState === WebSocket.CLOSED) {\n            resolve();\n            return;\n        }\n        const timer = setTimeout(() => {\n            client.terminate();\n        }, CLOSE_WAIT_MS);\n        client.once(\"close\", () => {\n            clearTimeout(timer);\n            resolve();\n        });\n        client.close(SERVICE_RESTART, \"Server restarting\");\n    });\n};\n\nclass NodeWsAdapterImpl implements WebsocketsServerAdapter.Interface<WebSocket> {\n    private wss: WebSocketServer | undefined;\n    private pingTimer: ReturnType<typeof setInterval> | undefined;\n    // Sockets that answered the last ping, or connected since it was sent.\n    private readonly answered = new WeakSet<WebSocket>();\n\n    private pingInterval = PING_INTERVAL_MS;\n\n    /*\n     * An adapter that pings more often, for tests. The constructor takes nothing: DI builds this class\n     * with no dependencies.\n     */\n    public static withPingInterval(pingInterval: number): NodeWsAdapterImpl {\n        const adapter = new NodeWsAdapterImpl();\n        adapter.pingInterval = pingInterval;\n        return adapter;\n    }\n\n    private getWss(): WebSocketServer {\n        if (!this.wss) {\n            throw new Error(\"WebSocketServer has not been started. Call start() first.\");\n        }\n        return this.wss;\n    }\n\n    /* The server param is kept for interface compliance but not used —\n       the HTTP upgrade event is handled externally via handleUpgrade(). */\n    public start(_server: HttpServer): void {\n        // Already started: a second server and timer would be left running, unreachable by stop().\n        if (this.wss) {\n            return;\n        }\n        const wss = new WebSocketServer({ noServer: true, maxPayload: MAX_PAYLOAD_BYTES });\n        wss.on(\"connection\", socket => {\n            this.answered.add(socket);\n            socket.on(\"pong\", () => {\n                this.answered.add(socket);\n            });\n        });\n        this.wss = wss;\n        this.pingTimer = setInterval(() => {\n            this.pingAll(wss);\n        }, this.pingInterval);\n    }\n\n    public handleUpgrade(request: IncomingMessage, socket: Duplex, head: Buffer): void {\n        this.getWss().handleUpgrade(request, socket, head, ws => {\n            this.getWss().emit(\"connection\", ws, request);\n        });\n    }\n\n    // Safe to call again: a stopped adapter has nothing left to close.\n    public async stop(): Promise<void> {\n        const wss = this.wss;\n        if (!wss) {\n            return;\n        }\n        this.wss = undefined;\n        clearInterval(this.pingTimer);\n\n        const clients = [...wss.clients];\n        const closing = clients.map(closeForRestart);\n        await Promise.all(closing);\n\n        await new Promise<void>((resolve, reject) => {\n            wss.close(err => {\n                if (err) {\n                    reject(err);\n                    return;\n                }\n                resolve();\n            });\n        });\n    }\n\n    /*\n     * Pings every open socket. One that has not answered the previous ping within a whole interval is\n     * gone without having closed (a laptop asleep, a dropped network), so it is cut; its close\n     * handler then removes the connection.\n     */\n    private pingAll(wss: WebSocketServer): void {\n        for (const socket of wss.clients) {\n            if (!this.answered.has(socket)) {\n                socket.terminate();\n                continue;\n            }\n            this.answered.delete(socket);\n            if (socket.readyState === WebSocket.OPEN) {\n                socket.ping();\n            }\n        }\n    }\n\n    public onConnection(\n        cb: (socket: WebSocket, request: import(\"node:http\").IncomingMessage) => void\n    ): void {\n        this.getWss().on(\"connection\", cb);\n    }\n\n    public onMessage(socket: WebSocket, cb: (data: Buffer) => void): void {\n        socket.on(\"message\", cb);\n    }\n\n    public onClose(socket: WebSocket, cb: (code: number, reason: Buffer) => void): void {\n        socket.on(\"close\", cb);\n    }\n\n    public onError(socket: WebSocket, cb: (error: Error) => void): void {\n        socket.on(\"error\", cb);\n    }\n\n    public send(socket: WebSocket, data: string): Promise<void> {\n        return new Promise((resolve, reject) => {\n            socket.send(data, err => {\n                if (err) {\n                    reject(err);\n                    return;\n                }\n                resolve();\n            });\n        });\n    }\n\n    public close(socket: WebSocket, code?: number, reason?: string): void {\n        socket.close(code, reason);\n    }\n}\n\nexport { NodeWsAdapterImpl };\n\nexport const NodeWsAdapter = WebsocketsServerAdapter.createImplementation({\n    implementation: NodeWsAdapterImpl,\n    dependencies: []\n});\n"],"names":["MAX_PAYLOAD_BYTES","SERVICE_RESTART","CLOSE_WAIT_MS","PING_INTERVAL_MS","closeForRestart","client","Promise","resolve","WebSocket","timer","setTimeout","clearTimeout","NodeWsAdapterImpl","pingInterval","adapter","Error","_server","wss","WebSocketServer","socket","setInterval","request","head","ws","undefined","clearInterval","clients","closing","reject","err","cb","data","code","reason","WeakSet","NodeWsAdapter","WebsocketsServerAdapter"],"mappings":"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"}

package/adapter/abstractions.d.ts

@@ -0,0 +1,18 @@
+import type { Server as HttpServer } from "node:http";
+import type { IncomingMessage } from "node:http";
+import type { Duplex } from "node:stream";
+export interface IWebsocketsServerAdapter<TSocket> {
+    start(server: HttpServer): void;
+    stop(): Promise<void>;
+    onConnection(cb: (socket: TSocket, request: IncomingMessage) => void): void;
+    onMessage(socket: TSocket, cb: (data: Buffer) => void): void;
+    onClose(socket: TSocket, cb: (code: number, reason: Buffer) => void): void;
+    onError(socket: TSocket, cb: (error: Error) => void): void;
+    send(socket: TSocket, data: string): Promise<void>;
+    close(socket: TSocket, code?: number, reason?: string): void;
+    handleUpgrade(request: IncomingMessage, socket: Duplex, head: Buffer): void;
+}
+export declare const WebsocketsServerAdapter: import("@webiny/di").Abstraction<IWebsocketsServerAdapter<unknown>>;
+export declare namespace WebsocketsServerAdapter {
+    type Interface<TSocket> = IWebsocketsServerAdapter<TSocket>;
+}

package/adapter/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const WebsocketsServerAdapter = createAbstraction("WebsocketsServerAdapter");
+export { WebsocketsServerAdapter };
+
+//# sourceMappingURL=abstractions.js.map

package/adapter/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter/abstractions.js","sources":["../../src/adapter/abstractions.ts"],"sourcesContent":["import type { Server as HttpServer } from \"node:http\";\nimport type { IncomingMessage } from \"node:http\";\nimport type { Duplex } from \"node:stream\";\nimport { createAbstraction } from \"@webiny/feature/api\";\n\nexport interface IWebsocketsServerAdapter<TSocket> {\n    start(server: HttpServer): void;\n    stop(): Promise<void>;\n    onConnection(cb: (socket: TSocket, request: IncomingMessage) => void): void;\n    onMessage(socket: TSocket, cb: (data: Buffer) => void): void;\n    onClose(socket: TSocket, cb: (code: number, reason: Buffer) => void): void;\n    onError(socket: TSocket, cb: (error: Error) => void): void;\n    send(socket: TSocket, data: string): Promise<void>;\n    close(socket: TSocket, code?: number, reason?: string): void;\n    handleUpgrade(request: IncomingMessage, socket: Duplex, head: Buffer): void;\n}\n\nexport const WebsocketsServerAdapter =\n    createAbstraction<IWebsocketsServerAdapter<unknown>>(\"WebsocketsServerAdapter\");\n\nexport namespace WebsocketsServerAdapter {\n    export type Interface<TSocket> = IWebsocketsServerAdapter<TSocket>;\n}\n"],"names":["WebsocketsServerAdapter","createAbstraction"],"mappings":";AAiBO,MAAMA,0BACTC,kBAAqD"}

package/adapter/types.d.ts

@@ -0,0 +1,2 @@
+import type { WebSocket } from "ws";
+export type NodeSocket = WebSocket;

package/bus/InProcessMessageBus.d.ts

@@ -0,0 +1,11 @@
+import { WebsocketsMessageBus } from "./abstractions.js";
+declare class InProcessMessageBusImpl implements WebsocketsMessageBus.Interface {
+    private readonly handlers;
+    publish(owner: string, message: WebsocketsMessageBus.Message): Promise<void>;
+    subscribe(owner: string, handler: WebsocketsMessageBus.Handler): Promise<void>;
+    close(): Promise<void>;
+}
+export { InProcessMessageBusImpl };
+export declare const InProcessMessageBus: typeof InProcessMessageBusImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IWebsocketsMessageBus>;
+};

package/bus/InProcessMessageBus.js

@@ -0,0 +1,24 @@
+import { WebsocketsMessageBus } from "./abstractions.js";
+class InProcessMessageBusImpl {
+    async publish(owner, message) {
+        const handler = this.handlers.get(owner);
+        if (!handler) return;
+        await handler(message);
+    }
+    async subscribe(owner, handler) {
+        this.handlers.set(owner, handler);
+    }
+    async close() {
+        this.handlers.clear();
+    }
+    constructor(){
+        this.handlers = new Map();
+    }
+}
+const InProcessMessageBus = WebsocketsMessageBus.createImplementation({
+    implementation: InProcessMessageBusImpl,
+    dependencies: []
+});
+export { InProcessMessageBus, InProcessMessageBusImpl };
+
+//# sourceMappingURL=InProcessMessageBus.js.map

package/bus/InProcessMessageBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus/InProcessMessageBus.js","sources":["../../src/bus/InProcessMessageBus.ts"],"sourcesContent":["import { WebsocketsMessageBus } from \"./abstractions.js\";\n\n/*\n * The bus for a single process, and the default. Every socket is in this process, so the only\n * listener it can reach is its own. Rows another process wrote, such as this process's predecessor\n * before a restart, name an owner nobody listens for here; those messages are dropped and the rows\n * are left to the heartbeat's stale cleanup.\n */\nclass InProcessMessageBusImpl implements WebsocketsMessageBus.Interface {\n    private readonly handlers = new Map<string, WebsocketsMessageBus.Handler>();\n\n    public async publish(owner: string, message: WebsocketsMessageBus.Message): Promise<void> {\n        const handler = this.handlers.get(owner);\n        if (!handler) {\n            return;\n        }\n        await handler(message);\n    }\n\n    public async subscribe(owner: string, handler: WebsocketsMessageBus.Handler): Promise<void> {\n        this.handlers.set(owner, handler);\n    }\n\n    public async close(): Promise<void> {\n        this.handlers.clear();\n    }\n}\n\nexport { InProcessMessageBusImpl };\n\nexport const InProcessMessageBus = WebsocketsMessageBus.createImplementation({\n    implementation: InProcessMessageBusImpl,\n    dependencies: []\n});\n"],"names":["InProcessMessageBusImpl","owner","message","handler","Map","InProcessMessageBus","WebsocketsMessageBus"],"mappings":";AAQA,MAAMA;IAGF,MAAa,QAAQC,KAAa,EAAEC,OAAqC,EAAiB;QACtF,MAAMC,UAAU,IAAI,CAAC,QAAQ,CAAC,GAAG,CAACF;QAClC,IAAI,CAACE,SACD;QAEJ,MAAMA,QAAQD;IAClB;IAEA,MAAa,UAAUD,KAAa,EAAEE,OAAqC,EAAiB;QACxF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAACF,OAAOE;IAC7B;IAEA,MAAa,QAAuB;QAChC,IAAI,CAAC,QAAQ,CAAC,KAAK;IACvB;;aAhBiB,QAAQ,GAAG,IAAIC;;AAiBpC;AAIO,MAAMC,sBAAsBC,qBAAqB,oBAAoB,CAAC;IACzE,gBAAgBN;IAChB,cAAc,EAAE;AACpB"}

package/bus/abstractions.d.ts

@@ -0,0 +1,30 @@
+import type { GenericRecord } from "@webiny/api/types.js";
+export interface IWebsocketsBusSendMessage {
+    action: "send";
+    connectionIds: string[];
+    data: GenericRecord;
+}
+export interface IWebsocketsBusDisconnectMessage {
+    action: "disconnect";
+    connectionIds: string[];
+}
+export type IWebsocketsBusMessage = IWebsocketsBusSendMessage | IWebsocketsBusDisconnectMessage;
+export type IWebsocketsBusHandler = (message: IWebsocketsBusMessage) => Promise<void>;
+/**
+ * Carries a send or a disconnect to the process that holds the sockets. Each process listens on its
+ * own channel, named after its `ProcessOwner` id, and other processes publish to it.
+ *
+ * Delivery is at most once and nothing is queued: a message for a process that is not listening is
+ * dropped, as a push to a reconnecting client is on AWS.
+ */
+export interface IWebsocketsMessageBus {
+    publish(owner: string, message: IWebsocketsBusMessage): Promise<void>;
+    subscribe(owner: string, handler: IWebsocketsBusHandler): Promise<void>;
+    close(): Promise<void>;
+}
+export declare const WebsocketsMessageBus: import("@webiny/di").Abstraction<IWebsocketsMessageBus>;
+export declare namespace WebsocketsMessageBus {
+    type Interface = IWebsocketsMessageBus;
+    type Message = IWebsocketsBusMessage;
+    type Handler = IWebsocketsBusHandler;
+}

package/bus/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const WebsocketsMessageBus = createAbstraction("Websockets/MessageBus");
+export { WebsocketsMessageBus };
+
+//# sourceMappingURL=abstractions.js.map

package/bus/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus/abstractions.js","sources":["../../src/bus/abstractions.ts"],"sourcesContent":["import type { GenericRecord } from \"@webiny/api/types.js\";\nimport { createAbstraction } from \"@webiny/feature/api\";\n\nexport interface IWebsocketsBusSendMessage {\n    action: \"send\";\n    connectionIds: string[];\n    data: GenericRecord;\n}\n\nexport interface IWebsocketsBusDisconnectMessage {\n    action: \"disconnect\";\n    connectionIds: string[];\n}\n\nexport type IWebsocketsBusMessage = IWebsocketsBusSendMessage | IWebsocketsBusDisconnectMessage;\n\nexport type IWebsocketsBusHandler = (message: IWebsocketsBusMessage) => Promise<void>;\n\n/**\n * Carries a send or a disconnect to the process that holds the sockets. Each process listens on its\n * own channel, named after its `ProcessOwner` id, and other processes publish to it.\n *\n * Delivery is at most once and nothing is queued: a message for a process that is not listening is\n * dropped, as a push to a reconnecting client is on AWS.\n */\nexport interface IWebsocketsMessageBus {\n    publish(owner: string, message: IWebsocketsBusMessage): Promise<void>;\n    subscribe(owner: string, handler: IWebsocketsBusHandler): Promise<void>;\n    close(): Promise<void>;\n}\n\nexport const WebsocketsMessageBus =\n    createAbstraction<IWebsocketsMessageBus>(\"Websockets/MessageBus\");\n\nexport namespace WebsocketsMessageBus {\n    export type Interface = IWebsocketsMessageBus;\n    export type Message = IWebsocketsBusMessage;\n    export type Handler = IWebsocketsBusHandler;\n}\n"],"names":["WebsocketsMessageBus","createAbstraction"],"mappings":";AA+BO,MAAMA,uBACTC,kBAAyC"}

package/bus/createBusMessageHandler.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from "@webiny/api-core/features/logger/abstractions.js";
+import type { WebsocketsConnectionManager } from "../connectionManager/abstractions.js";
+import type { WebsocketsServerAdapter } from "../adapter/abstractions.js";
+import type { WebsocketsMessageBus } from "./abstractions.js";
+export interface ICreateBusMessageHandlerParams {
+    connectionManager: WebsocketsConnectionManager.Interface<unknown>;
+    adapter: WebsocketsServerAdapter.Interface<unknown>;
+    logger: Logger.Interface;
+}
+export declare const createBusMessageHandler: (params: ICreateBusMessageHandlerParams) => WebsocketsMessageBus.Handler;

package/bus/createBusMessageHandler.js

@@ -0,0 +1,20 @@
+import { sendToLocalSockets } from "../delivery/sendToLocalSockets.js";
+import { disconnectLocalSockets } from "../delivery/disconnectLocalSockets.js";
+const createBusMessageHandler = (params)=>{
+    const { connectionManager } = params;
+    return async (message)=>{
+        let missing;
+        missing = "send" === message.action ? await sendToLocalSockets({
+            ...params,
+            connectionIds: message.connectionIds,
+            data: message.data
+        }) : await disconnectLocalSockets({
+            ...params,
+            connectionIds: message.connectionIds
+        });
+        for (const connectionId of missing)await connectionManager.remove(connectionId);
+    };
+};
+export { createBusMessageHandler };
+
+//# sourceMappingURL=createBusMessageHandler.js.map

package/bus/createBusMessageHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus/createBusMessageHandler.js","sources":["../../src/bus/createBusMessageHandler.ts"],"sourcesContent":["import type { Logger } from \"@webiny/api-core/features/logger/abstractions.js\";\nimport type { WebsocketsConnectionManager } from \"~/connectionManager/abstractions.js\";\nimport type { WebsocketsServerAdapter } from \"~/adapter/abstractions.js\";\nimport type { WebsocketsMessageBus } from \"./abstractions.js\";\nimport { sendToLocalSockets } from \"~/delivery/sendToLocalSockets.js\";\nimport { disconnectLocalSockets } from \"~/delivery/disconnectLocalSockets.js\";\n\nexport interface ICreateBusMessageHandlerParams {\n    connectionManager: WebsocketsConnectionManager.Interface<unknown>;\n    adapter: WebsocketsServerAdapter.Interface<unknown>;\n    logger: Logger.Interface;\n}\n\n/*\n * Handles what other processes publish to this one: sends and disconnects for sockets this process\n * holds. Messages arrive here only for connections this process owns, so one with no socket left is\n * gone, and its connection is removed.\n */\nexport const createBusMessageHandler = (\n    params: ICreateBusMessageHandlerParams\n): WebsocketsMessageBus.Handler => {\n    const { connectionManager } = params;\n    return async message => {\n        let missing: string[];\n        if (message.action === \"send\") {\n            missing = await sendToLocalSockets({\n                ...params,\n                connectionIds: message.connectionIds,\n                data: message.data\n            });\n        } else {\n            missing = await disconnectLocalSockets({\n                ...params,\n                connectionIds: message.connectionIds\n            });\n        }\n        for (const connectionId of missing) {\n            await connectionManager.remove(connectionId);\n        }\n    };\n};\n"],"names":["createBusMessageHandler","params","connectionManager","message","missing","sendToLocalSockets","disconnectLocalSockets","connectionId"],"mappings":";;AAkBO,MAAMA,0BAA0B,CACnCC;IAEA,MAAM,EAAEC,iBAAiB,EAAE,GAAGD;IAC9B,OAAO,OAAME;QACT,IAAIC;QAEAA,UADAD,AAAmB,WAAnBA,QAAQ,MAAM,GACJ,MAAME,mBAAmB;YAC/B,GAAGJ,MAAM;YACT,eAAeE,QAAQ,aAAa;YACpC,MAAMA,QAAQ,IAAI;QACtB,KAEU,MAAMG,uBAAuB;YACnC,GAAGL,MAAM;YACT,eAAeE,QAAQ,aAAa;QACxC;QAEJ,KAAK,MAAMI,gBAAgBH,QACvB,MAAMF,kBAAkB,MAAM,CAACK;IAEvC;AACJ"}

package/connectionManager/ServerConnectionManager.d.ts

@@ -0,0 +1,21 @@
+import { ConnectionRegistry } from "@webiny/api-websockets/exports/api.js";
+import { ProcessOwner } from "@webiny/event-handler-standalone";
+import { WebsocketsConnectionManager } from "./abstractions.js";
+export declare class ServerConnectionManagerImpl implements WebsocketsConnectionManager.Interface<unknown> {
+    private readonly registry;
+    private readonly owner;
+    private readonly sockets;
+    private readonly metadata;
+    constructor(registry: ConnectionRegistry.Interface, owner: ProcessOwner.Interface);
+    add(params: WebsocketsConnectionManager.AddParams<unknown>): Promise<void>;
+    remove(connectionId: string): Promise<void>;
+    groupByOwner(connectionIds: string[]): Promise<Map<string, string[]>>;
+    getSocket(connectionId: string): unknown | undefined;
+    getMetadata(connectionId: string): WebsocketsConnectionManager.ConnectionMetadata | undefined;
+    updateLastSeen(connectionId: string): Promise<void>;
+    cleanup(maxAge: number): Promise<string[]>;
+    getActiveConnectionIds(): string[];
+}
+export declare const ServerConnectionManager: typeof ServerConnectionManagerImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IWebsocketsConnectionManager<unknown>>;
+};

package/connectionManager/ServerConnectionManager.js

@@ -0,0 +1,85 @@
+import { ConnectionRegistry } from "@webiny/api-websockets/exports/api.js";
+import { ProcessOwner } from "@webiny/event-handler-standalone";
+import { WebsocketsConnectionManager } from "./abstractions.js";
+class ServerConnectionManagerImpl {
+    constructor(registry, owner){
+        this.registry = registry;
+        this.owner = owner;
+        this.sockets = new Map();
+        this.metadata = new Map();
+    }
+    async add(params) {
+        this.sockets.set(params.connectionId, params.socket);
+        this.metadata.set(params.connectionId, {
+            connectionId: params.connectionId,
+            endpoint: params.endpoint,
+            connectedAt: params.connectedAt,
+            host: params.host,
+            headers: params.headers
+        });
+        await this.registry.register({
+            connectionId: params.connectionId,
+            identity: params.identity,
+            tenant: params.tenant,
+            endpoint: params.endpoint,
+            connectedOn: new Date(params.connectedAt).toISOString(),
+            owner: this.owner.id
+        });
+    }
+    async remove(connectionId) {
+        this.sockets.delete(connectionId);
+        this.metadata.delete(connectionId);
+        try {
+            await this.registry.unregister({
+                connectionId
+            });
+        } catch (err) {
+            if ("CONNECTION_NOT_FOUND" === err.code) return;
+            throw err;
+        }
+    }
+    async groupByOwner(connectionIds) {
+        const byOwner = new Map();
+        if (0 === connectionIds.length) return byOwner;
+        const connections = await this.registry.listViaConnections(connectionIds);
+        for (const connection of connections){
+            if (!connection.owner) continue;
+            const group = byOwner.get(connection.owner) ?? [];
+            group.push(connection.connectionId);
+            byOwner.set(connection.owner, group);
+        }
+        return byOwner;
+    }
+    getSocket(connectionId) {
+        return this.sockets.get(connectionId);
+    }
+    getMetadata(connectionId) {
+        return this.metadata.get(connectionId);
+    }
+    async updateLastSeen(connectionId) {
+        await this.registry.updateLastSeen(connectionId);
+    }
+    async cleanup(maxAge) {
+        const olderThan = new Date(Date.now() - maxAge);
+        const stale = await this.registry.listStale(olderThan);
+        const removed = [];
+        for (const entry of stale){
+            await this.remove(entry.connectionId);
+            removed.push(entry.connectionId);
+        }
+        return removed;
+    }
+    getActiveConnectionIds() {
+        return Array.from(this.sockets.keys());
+    }
+}
+const ServerConnectionManager = WebsocketsConnectionManager.createImplementation({
+    implementation: ServerConnectionManagerImpl,
+    dependencies: [
+        ConnectionRegistry,
+        ProcessOwner
+    ]
+});
+export { ServerConnectionManager, ServerConnectionManagerImpl };
+
+//# sourceMappingURL=ServerConnectionManager.js.map

package/connectionManager/ServerConnectionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionManager/ServerConnectionManager.js","sources":["../../src/connectionManager/ServerConnectionManager.ts"],"sourcesContent":["import { ConnectionRegistry } from \"@webiny/api-websockets/exports/api.js\";\nimport { ProcessOwner } from \"@webiny/event-handler-standalone\";\nimport { WebsocketsConnectionManager } from \"./abstractions.js\";\n\nexport class ServerConnectionManagerImpl implements WebsocketsConnectionManager.Interface<unknown> {\n    private readonly sockets = new Map<string, unknown>();\n    private readonly metadata = new Map<string, WebsocketsConnectionManager.ConnectionMetadata>();\n\n    public constructor(\n        private readonly registry: ConnectionRegistry.Interface,\n        private readonly owner: ProcessOwner.Interface\n    ) {}\n\n    public async add(params: WebsocketsConnectionManager.AddParams<unknown>): Promise<void> {\n        this.sockets.set(params.connectionId, params.socket);\n        this.metadata.set(params.connectionId, {\n            connectionId: params.connectionId,\n            endpoint: params.endpoint,\n            connectedAt: params.connectedAt,\n            host: params.host,\n            headers: params.headers\n        });\n\n        // Save the connection to the shared registry. This is what lets the server later push a\n        // message to a specific user — e.g. when a background task finishes and calls\n        // SendToIdentity. That flow looks connections up in the registry by identity id to get their\n        // connection ids, then comes back here to fetch each live socket by connection id and send.\n        // The in-memory map above only answers \"socket for this connection id?\" — it can't be\n        // searched by identity, so without this registry row a targeted send finds nobody. The\n        // registry stores `connectedOn` as an ISO string (it compares connections against a recency\n        // cutoff), so we convert the epoch-ms `connectedAt`.\n        await this.registry.register({\n            connectionId: params.connectionId,\n            identity: params.identity,\n            tenant: params.tenant,\n            endpoint: params.endpoint,\n            connectedOn: new Date(params.connectedAt).toISOString(),\n            owner: this.owner.id\n        });\n    }\n\n    public async remove(connectionId: string): Promise<void> {\n        this.sockets.delete(connectionId);\n        this.metadata.delete(connectionId);\n        try {\n            await this.registry.unregister({ connectionId });\n        } catch (err) {\n            if ((err as any).code === \"CONNECTION_NOT_FOUND\") {\n                return;\n            }\n            throw err;\n        }\n    }\n\n    /*\n     * The process holding each of these connections, for connections this process has no socket for.\n     * Rows without an owner are left out: nobody can say who holds them, so they wait for the\n     * heartbeat's stale cleanup.\n     */\n    public async groupByOwner(connectionIds: string[]): Promise<Map<string, string[]>> {\n        const byOwner = new Map<string, string[]>();\n        if (connectionIds.length === 0) {\n            return byOwner;\n        }\n        const connections = await this.registry.listViaConnections(connectionIds);\n        for (const connection of connections) {\n            if (!connection.owner) {\n                continue;\n            }\n            const group = byOwner.get(connection.owner) ?? [];\n            group.push(connection.connectionId);\n            byOwner.set(connection.owner, group);\n        }\n        return byOwner;\n    }\n\n    public getSocket(connectionId: string): unknown | undefined {\n        return this.sockets.get(connectionId);\n    }\n\n    public getMetadata(\n        connectionId: string\n    ): WebsocketsConnectionManager.ConnectionMetadata | undefined {\n        return this.metadata.get(connectionId);\n    }\n\n    public async updateLastSeen(connectionId: string): Promise<void> {\n        await this.registry.updateLastSeen(connectionId);\n    }\n\n    public async cleanup(maxAge: number): Promise<string[]> {\n        const olderThan = new Date(Date.now() - maxAge);\n        const stale = await this.registry.listStale(olderThan);\n        const removed: string[] = [];\n        for (const entry of stale) {\n            await this.remove(entry.connectionId);\n            removed.push(entry.connectionId);\n        }\n        return removed;\n    }\n\n    public getActiveConnectionIds(): string[] {\n        return Array.from(this.sockets.keys());\n    }\n}\n\nexport const ServerConnectionManager = WebsocketsConnectionManager.createImplementation({\n    implementation: ServerConnectionManagerImpl,\n    dependencies: [ConnectionRegistry, ProcessOwner]\n});\n"],"names":["ServerConnectionManagerImpl","registry","owner","Map","params","Date","connectionId","err","connectionIds","byOwner","connections","connection","group","maxAge","olderThan","stale","removed","entry","Array","ServerConnectionManager","WebsocketsConnectionManager","ConnectionRegistry","ProcessOwner"],"mappings":";;;AAIO,MAAMA;IAIT,YACqBC,QAAsC,EACtCC,KAA6B,CAChD;aAFmBD,QAAQ,GAARA;aACAC,KAAK,GAALA;aALJ,OAAO,GAAG,IAAIC;aACd,QAAQ,GAAG,IAAIA;IAK7B;IAEH,MAAa,IAAIC,MAAsD,EAAiB;QACpF,IAAI,CAAC,OAAO,CAAC,GAAG,CAACA,OAAO,YAAY,EAAEA,OAAO,MAAM;QACnD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAACA,OAAO,YAAY,EAAE;YACnC,cAAcA,OAAO,YAAY;YACjC,UAAUA,OAAO,QAAQ;YACzB,aAAaA,OAAO,WAAW;YAC/B,MAAMA,OAAO,IAAI;YACjB,SAASA,OAAO,OAAO;QAC3B;QAUA,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACzB,cAAcA,OAAO,YAAY;YACjC,UAAUA,OAAO,QAAQ;YACzB,QAAQA,OAAO,MAAM;YACrB,UAAUA,OAAO,QAAQ;YACzB,aAAa,IAAIC,KAAKD,OAAO,WAAW,EAAE,WAAW;YACrD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE;QACxB;IACJ;IAEA,MAAa,OAAOE,YAAoB,EAAiB;QACrD,IAAI,CAAC,OAAO,CAAC,MAAM,CAACA;QACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAACA;QACrB,IAAI;YACA,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAEA;YAAa;QAClD,EAAE,OAAOC,KAAK;YACV,IAAKA,AAAqB,2BAArBA,IAAY,IAAI,EACjB;YAEJ,MAAMA;QACV;IACJ;IAOA,MAAa,aAAaC,aAAuB,EAAkC;QAC/E,MAAMC,UAAU,IAAIN;QACpB,IAAIK,AAAyB,MAAzBA,cAAc,MAAM,EACpB,OAAOC;QAEX,MAAMC,cAAc,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAACF;QAC3D,KAAK,MAAMG,cAAcD,YAAa;YAClC,IAAI,CAACC,WAAW,KAAK,EACjB;YAEJ,MAAMC,QAAQH,QAAQ,GAAG,CAACE,WAAW,KAAK,KAAK,EAAE;YACjDC,MAAM,IAAI,CAACD,WAAW,YAAY;YAClCF,QAAQ,GAAG,CAACE,WAAW,KAAK,EAAEC;QAClC;QACA,OAAOH;IACX;IAEO,UAAUH,YAAoB,EAAuB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAACA;IAC5B;IAEO,YACHA,YAAoB,EACsC;QAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAACA;IAC7B;IAEA,MAAa,eAAeA,YAAoB,EAAiB;QAC7D,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAACA;IACvC;IAEA,MAAa,QAAQO,MAAc,EAAqB;QACpD,MAAMC,YAAY,IAAIT,KAAKA,KAAK,GAAG,KAAKQ;QACxC,MAAME,QAAQ,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAACD;QAC5C,MAAME,UAAoB,EAAE;QAC5B,KAAK,MAAMC,SAASF,MAAO;YACvB,MAAM,IAAI,CAAC,MAAM,CAACE,MAAM,YAAY;YACpCD,QAAQ,IAAI,CAACC,MAAM,YAAY;QACnC;QACA,OAAOD;IACX;IAEO,yBAAmC;QACtC,OAAOE,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;IACvC;AACJ;AAEO,MAAMC,0BAA0BC,4BAA4B,oBAAoB,CAAC;IACpF,gBAAgBpB;IAChB,cAAc;QAACqB;QAAoBC;KAAa;AACpD"}

package/connectionManager/abstractions.d.ts

@@ -0,0 +1,34 @@
+import { ConnectionRegistry } from "@webiny/api-websockets/exports/api.js";
+export interface IWebsocketsConnectionManagerAddParams<TSocket> {
+    connectionId: string;
+    socket: TSocket;
+    endpoint: string;
+    identity: ConnectionRegistry.Identity;
+    tenant: string;
+    connectedAt: number;
+    host: string;
+    headers: Record<string, string>;
+}
+export interface IWebsocketsConnectionManagerMetadata {
+    connectionId: string;
+    endpoint: string;
+    connectedAt: number;
+    host: string;
+    headers: Record<string, string>;
+}
+export interface IWebsocketsConnectionManager<TSocket> {
+    add(params: IWebsocketsConnectionManagerAddParams<TSocket>): Promise<void>;
+    remove(connectionId: string): Promise<void>;
+    groupByOwner(connectionIds: string[]): Promise<Map<string, string[]>>;
+    getSocket(connectionId: string): TSocket | undefined;
+    getMetadata(connectionId: string): IWebsocketsConnectionManagerMetadata | undefined;
+    updateLastSeen(connectionId: string): Promise<void>;
+    cleanup(maxAge: number): Promise<string[]>;
+    getActiveConnectionIds(): string[];
+}
+export declare const WebsocketsConnectionManager: import("@webiny/di").Abstraction<IWebsocketsConnectionManager<unknown>>;
+export declare namespace WebsocketsConnectionManager {
+    type Interface<TSocket> = IWebsocketsConnectionManager<TSocket>;
+    type AddParams<TSocket> = IWebsocketsConnectionManagerAddParams<TSocket>;
+    type ConnectionMetadata = IWebsocketsConnectionManagerMetadata;
+}

package/connectionManager/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const WebsocketsConnectionManager = createAbstraction("WebsocketsConnectionManager");
+export { WebsocketsConnectionManager };
+
+//# sourceMappingURL=abstractions.js.map

package/connectionManager/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionManager/abstractions.js","sources":["../../src/connectionManager/abstractions.ts"],"sourcesContent":["import { ConnectionRegistry } from \"@webiny/api-websockets/exports/api.js\";\nimport { createAbstraction } from \"@webiny/feature/api\";\n\nexport interface IWebsocketsConnectionManagerAddParams<TSocket> {\n    connectionId: string;\n    socket: TSocket;\n    endpoint: string;\n    identity: ConnectionRegistry.Identity;\n    tenant: string;\n    connectedAt: number;\n    host: string;\n    headers: Record<string, string>;\n}\n\nexport interface IWebsocketsConnectionManagerMetadata {\n    connectionId: string;\n    endpoint: string;\n    connectedAt: number;\n    host: string;\n    headers: Record<string, string>;\n}\n\nexport interface IWebsocketsConnectionManager<TSocket> {\n    add(params: IWebsocketsConnectionManagerAddParams<TSocket>): Promise<void>;\n    remove(connectionId: string): Promise<void>;\n    groupByOwner(connectionIds: string[]): Promise<Map<string, string[]>>;\n    getSocket(connectionId: string): TSocket | undefined;\n    getMetadata(connectionId: string): IWebsocketsConnectionManagerMetadata | undefined;\n    updateLastSeen(connectionId: string): Promise<void>;\n    cleanup(maxAge: number): Promise<string[]>;\n    getActiveConnectionIds(): string[];\n}\n\nexport const WebsocketsConnectionManager = createAbstraction<IWebsocketsConnectionManager<unknown>>(\n    \"WebsocketsConnectionManager\"\n);\n\nexport namespace WebsocketsConnectionManager {\n    export type Interface<TSocket> = IWebsocketsConnectionManager<TSocket>;\n    export type AddParams<TSocket> = IWebsocketsConnectionManagerAddParams<TSocket>;\n    export type ConnectionMetadata = IWebsocketsConnectionManagerMetadata;\n}\n"],"names":["WebsocketsConnectionManager","createAbstraction"],"mappings":";AAiCO,MAAMA,8BAA8BC,kBACvC"}

package/delivery/disconnectLocalSockets.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from "@webiny/api-core/features/logger/abstractions.js";
+import type { WebsocketsConnectionManager } from "../connectionManager/abstractions.js";
+import type { WebsocketsServerAdapter } from "../adapter/abstractions.js";
+export interface IDisconnectLocalSocketsParams {
+    connectionManager: WebsocketsConnectionManager.Interface<unknown>;
+    adapter: WebsocketsServerAdapter.Interface<unknown>;
+    logger: Logger.Interface;
+    connectionIds: string[];
+}
+export declare const disconnectLocalSockets: (params: IDisconnectLocalSocketsParams) => Promise<string[]>;

package/delivery/disconnectLocalSockets.js

@@ -0,0 +1,24 @@
+const disconnectLocalSockets = async (params)=>{
+    const { connectionManager, adapter, logger, connectionIds } = params;
+    const missing = [];
+    for (const connectionId of connectionIds){
+        const socket = connectionManager.getSocket(connectionId);
+        if (void 0 === socket) {
+            missing.push(connectionId);
+            continue;
+        }
+        try {
+            adapter.close(socket);
+            await connectionManager.remove(connectionId);
+        } catch (error) {
+            logger.error({
+                error,
+                connectionId
+            }, "[websockets] could not disconnect a connection");
+        }
+    }
+    return missing;
+};
+export { disconnectLocalSockets };
+
+//# sourceMappingURL=disconnectLocalSockets.js.map

package/delivery/disconnectLocalSockets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery/disconnectLocalSockets.js","sources":["../../src/delivery/disconnectLocalSockets.ts"],"sourcesContent":["import type { Logger } from \"@webiny/api-core/features/logger/abstractions.js\";\nimport type { WebsocketsConnectionManager } from \"~/connectionManager/abstractions.js\";\nimport type { WebsocketsServerAdapter } from \"~/adapter/abstractions.js\";\n\nexport interface IDisconnectLocalSocketsParams {\n    connectionManager: WebsocketsConnectionManager.Interface<unknown>;\n    adapter: WebsocketsServerAdapter.Interface<unknown>;\n    logger: Logger.Interface;\n    connectionIds: string[];\n}\n\n/*\n * Closes each socket this process holds, removes its connection, and returns the ids it holds no\n * socket for. A failed close is logged and the others go on.\n */\nexport const disconnectLocalSockets = async (\n    params: IDisconnectLocalSocketsParams\n): Promise<string[]> => {\n    const { connectionManager, adapter, logger, connectionIds } = params;\n    const missing: string[] = [];\n    for (const connectionId of connectionIds) {\n        const socket = connectionManager.getSocket(connectionId);\n        if (socket === undefined) {\n            missing.push(connectionId);\n            continue;\n        }\n        try {\n            adapter.close(socket);\n            await connectionManager.remove(connectionId);\n        } catch (error) {\n            logger.error({ error, connectionId }, \"[websockets] could not disconnect a connection\");\n        }\n    }\n    return missing;\n};\n"],"names":["disconnectLocalSockets","params","connectionManager","adapter","logger","connectionIds","missing","connectionId","socket","undefined","error"],"mappings":"AAeO,MAAMA,yBAAyB,OAClCC;IAEA,MAAM,EAAEC,iBAAiB,EAAEC,OAAO,EAAEC,MAAM,EAAEC,aAAa,EAAE,GAAGJ;IAC9D,MAAMK,UAAoB,EAAE;IAC5B,KAAK,MAAMC,gBAAgBF,cAAe;QACtC,MAAMG,SAASN,kBAAkB,SAAS,CAACK;QAC3C,IAAIC,AAAWC,WAAXD,QAAsB;YACtBF,QAAQ,IAAI,CAACC;YACb;QACJ;QACA,IAAI;YACAJ,QAAQ,KAAK,CAACK;YACd,MAAMN,kBAAkB,MAAM,CAACK;QACnC,EAAE,OAAOG,OAAO;YACZN,OAAO,KAAK,CAAC;gBAAEM;gBAAOH;YAAa,GAAG;QAC1C;IACJ;IACA,OAAOD;AACX"}

package/delivery/sendToLocalSockets.d.ts

@@ -0,0 +1,12 @@
+import type { GenericRecord } from "@webiny/api/types.js";
+import type { Logger } from "@webiny/api-core/features/logger/abstractions.js";
+import type { WebsocketsConnectionManager } from "../connectionManager/abstractions.js";
+import type { WebsocketsServerAdapter } from "../adapter/abstractions.js";
+export interface ISendToLocalSocketsParams {
+    connectionManager: WebsocketsConnectionManager.Interface<unknown>;
+    adapter: WebsocketsServerAdapter.Interface<unknown>;
+    logger: Logger.Interface;
+    connectionIds: string[];
+    data: GenericRecord;
+}
+export declare const sendToLocalSockets: (params: ISendToLocalSocketsParams) => Promise<string[]>;