@grest-ts/websocket 0.0.5

package/dist/src/server/GGWebSocketSchema.startServer.js

@@ -0,0 +1,80 @@
+/**
+ * Server extension for WebSocketSchema - adds startServer and register methods
+ * This file should only be imported in server (Node.js) context
+ */
+import { GGWebSocketSchema } from "../schema/GGWebSocketSchema.js";
+import { GGSocketServer } from "./GGSocketServer.js";
+import { GGLocator } from "@grest-ts/locator";
+import { GG_HTTP_SERVER } from "@grest-ts/http";
+GGWebSocketSchema.prototype.startServer = function (onConnection, config) {
+    const contract = this.contract;
+    if (!contract) {
+        throw new Error(`WebSocketSchema "${this.name}" has no contract.`);
+    }
+    const normalizedPath = this.path.startsWith('/') ? this.path : '/' + this.path;
+    const schemaName = this.name;
+    const http = config.http ?? GGLocator.getScope().get(GG_HTTP_SERVER);
+    // @TODO We might want some lookup here based on path/middlewares etc. If I use same socket for multiple paths, we need to reuse also same GGSocketServer.
+    const socketServer = new GGSocketServer(http, {
+        apiName: schemaName,
+        path: normalizedPath,
+        middlewares: [...this.middlewares, ...(config?.middlewares ?? [])]
+    });
+    socketServer.onConnection((socket) => {
+        const clientToServerContract = contract.clientToServer;
+        const serverToClientContract = contract.serverToClient;
+        const incoming = {
+            on(handlers) {
+                const impl = {};
+                for (const methodName of Object.keys(clientToServerContract.methods)) {
+                    const methodDef = clientToServerContract.methods[methodName];
+                    const params = methodDef.params;
+                    impl[methodName] = (data) => {
+                        // If method has params info, unpack data object to positional args
+                        if (params && params.length > 0 && data && typeof data === 'object') {
+                            const args = params.map((p) => data[p.name]);
+                            return handlers[methodName](...args);
+                        }
+                        // Single or no parameter - pass directly
+                        return handlers[methodName](data);
+                    };
+                }
+                const incomingInstance = clientToServerContract.implement(impl);
+                for (const methodName of Object.keys(clientToServerContract.methods)) {
+                    socket.registerHandler({
+                        path: `${schemaName}.${methodName}`,
+                        handler: incomingInstance[methodName]
+                    });
+                }
+            }
+        };
+        const impl = {};
+        for (const methodName of Object.keys(serverToClientContract.methods)) {
+            const method = serverToClientContract.methods[methodName];
+            const expectsResponse = 'success' in method;
+            impl[methodName] = (data) => {
+                return socket.send(`${schemaName}.${methodName}`, data, expectsResponse);
+            };
+        }
+        const outgoingInstance = serverToClientContract.implement(impl);
+        outgoingInstance.onClose = (callback) => {
+            socket.onClose(callback);
+        };
+        onConnection(incoming, outgoingInstance);
+    });
+    return socketServer;
+};
+GGWebSocketSchema.prototype.register = function (onConnection, config) {
+    let httpServer = config?.http;
+    if (!httpServer) {
+        httpServer = GGLocator.getScope().get(GG_HTTP_SERVER);
+    }
+    if (!httpServer) {
+        throw new Error(`No HTTP server found. Make sure to register GGHttpServerAdapter in the scope or pass it via config`);
+    }
+    this.startServer(onConnection, {
+        http: httpServer,
+        middlewares: config?.middlewares
+    });
+};
+//# sourceMappingURL=GGWebSocketSchema.startServer.js.map

package/dist/src/server/GGWebSocketSchema.startServer.js.map

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

package/dist/src/server/GG_WS_CONNECTION.d.ts

@@ -0,0 +1,12 @@
+import { GGContextKey } from "@grest-ts/context";
+declare const IsWsConnectionContext: import("@grest-ts/schema").ObjectSchema<{
+    path: string;
+    port?: number;
+}>;
+export type WsConnectionContext = typeof IsWsConnectionContext.infer;
+export declare const GG_WS_CONNECTION: GGContextKey<{
+    path: string;
+    port?: number;
+}>;
+export {};
+//# sourceMappingURL=GG_WS_CONNECTION.d.ts.map

package/dist/src/server/GG_WS_CONNECTION.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GG_WS_CONNECTION.d.ts","sourceRoot":"","sources":["../../../src/server/GG_WS_CONNECTION.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAG/C,QAAA,MAAM,qBAAqB;;;EAGzB,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,qBAAqB,CAAC,KAAK,CAAC;AAErE,eAAO,MAAM,gBAAgB;;;EAAgF,CAAC"}

package/dist/src/server/GG_WS_CONNECTION.js

@@ -0,0 +1,8 @@
+import { GGContextKey } from "@grest-ts/context";
+import { IsNumber, IsObject, IsString } from "@grest-ts/schema";
+const IsWsConnectionContext = IsObject({
+    port: IsNumber.orUndefined,
+    path: IsString
+});
+export const GG_WS_CONNECTION = new GGContextKey('ws-connection', IsWsConnectionContext);
+//# sourceMappingURL=GG_WS_CONNECTION.js.map

package/dist/src/server/GG_WS_CONNECTION.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GG_WS_CONNECTION.js","sourceRoot":"","sources":["../../../src/server/GG_WS_CONNECTION.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAE9D,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IACnC,IAAI,EAAE,QAAQ,CAAC,WAAW;IAC1B,IAAI,EAAE,QAAQ;CACjB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAsB,eAAe,EAAE,qBAAqB,CAAC,CAAC"}

package/dist/src/server/GG_WS_MESSAGE.d.ts

@@ -0,0 +1,10 @@
+import { GGContextKey } from "@grest-ts/context";
+declare const IsWsMessageContext: import("@grest-ts/schema").ObjectSchema<{
+    path: string;
+}>;
+export type WsMessageContext = typeof IsWsMessageContext.infer;
+export declare const GG_WS_MESSAGE: GGContextKey<{
+    path: string;
+}>;
+export {};
+//# sourceMappingURL=GG_WS_MESSAGE.d.ts.map

package/dist/src/server/GG_WS_MESSAGE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GG_WS_MESSAGE.d.ts","sourceRoot":"","sources":["../../../src/server/GG_WS_MESSAGE.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAG/C,QAAA,MAAM,kBAAkB;;EAEtB,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAE/D,eAAO,MAAM,aAAa;;EAAuE,CAAC"}

package/dist/src/server/GG_WS_MESSAGE.js

@@ -0,0 +1,7 @@
+import { GGContextKey } from "@grest-ts/context";
+import { IsObject, IsString } from "@grest-ts/schema";
+const IsWsMessageContext = IsObject({
+    path: IsString
+});
+export const GG_WS_MESSAGE = new GGContextKey('ws-message', IsWsMessageContext);
+//# sourceMappingURL=GG_WS_MESSAGE.js.map

package/dist/src/server/GG_WS_MESSAGE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GG_WS_MESSAGE.js","sourceRoot":"","sources":["../../../src/server/GG_WS_MESSAGE.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,QAAQ,EAAE,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAEpD,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IAChC,IAAI,EAAE,QAAQ;CACjB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,YAAY,CAAmB,YAAY,EAAE,kBAAkB,CAAC,CAAC"}

package/dist/src/socket/GGSocket.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Unified WebSocket implementation for both client and server
+ * Handles messaging only - context is set from effects at connection time
+ */
+import { SocketAdapter } from "./SocketAdapter";
+import { GGPromise } from "@grest-ts/schema";
+import { GGContext } from "@grest-ts/context";
+/**
+ * Handler configuration for socket messages.
+ * Handler is expected to be already wrapped with contract validation.
+ */
+export interface SocketHandlerConfig {
+    path: string;
+    handler: (data?: any) => GGPromise<any, any> | Promise<any> | void;
+}
+export interface GGSocketConfig {
+    apiName?: string;
+    socketPath?: string;
+    /** Optional wrapper that runs handlers in the context established at connection time */
+    connectionContext?: GGContext;
+}
+export declare class GGSocket {
+    private readonly socket;
+    private readonly handlers;
+    private readonly pendingRequests;
+    private unknownMessageHandler?;
+    private isActive;
+    private isCleanedUp;
+    private tearingDownPromise;
+    private readonly onTearDownCallbacks;
+    private readonly onCloseCallbacks;
+    private readonly onErrorCallbacks;
+    private readonly apiName;
+    private readonly socketPath;
+    private readonly connectionContext;
+    constructor(socket: SocketAdapter, config?: GGSocketConfig);
+    private handleIncomingMessage;
+    private handleMissingRoute;
+    private sendResponse;
+    private handleFireAndForgetResult;
+    /**
+     * Send a message over the socket (raw transport).
+     * Data is expected to be already validated by the contract layer.
+     *
+     * @param path - The message path/route
+     * @param body - The message data (already validated)
+     * @param expectsResponse - Whether to wait for a response
+     */
+    send(path: string, body: any, expectsResponse: boolean): Promise<any>;
+    private recordInMetric;
+    private recordOutMetric;
+    registerHandler(config: SocketHandlerConfig): void;
+    unregisterHandler(path: string): void;
+    setUnknownMessageHandler(handler: (path: string, data: any) => void): void;
+    onError(onError: (error: Error) => void): this;
+    onTearDown(onClosing: () => Promise<void>): this;
+    onClose(onClose: () => void): this;
+    /**
+     * Get the number of pending outgoing requests
+     */
+    get pendingRequestCount(): number;
+    /**
+     * Starts the socket closing process gracefully.
+     * 1. First waits for pending outgoing requests to complete (up to pendingRequestsTimeoutMs)
+     * 2. Then runs user teardown handlers
+     * 3. Finally closes the socket
+     *
+     * @param pendingRequestsTimeoutMs - Max time to wait for pending requests (default: 5000ms)
+     * @param callbacksTimeoutMs - Max time to wait for teardown callbacks (default: 5000ms)
+     */
+    teardown(pendingRequestsTimeoutMs?: number, callbacksTimeoutMs?: number): Promise<void>;
+    /**
+     * Run all teardown callbacks concurrently with a timeout.
+     */
+    private runTeardownCallbacks;
+    /**
+     * Immediately closes the socket.
+     */
+    close(): void;
+}
+//# sourceMappingURL=GGSocket.d.ts.map

package/dist/src/socket/GGSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGSocket.d.ts","sourceRoot":"","sources":["../../../src/socket/GGSocket.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAK9C,OAAO,EAAQ,SAAS,EAAgC,MAAM,kBAAkB,CAAC;AAGjF,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAG5C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,SAAS,CAAC;CACjC;AAQD,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACxE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAE5D,OAAO,CAAC,qBAAqB,CAAC,CAAoC;IAElE,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAAgB;IAE1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IACtE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IAGtE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAY;gBAElC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,cAAc;YA8D5C,qBAAqB;IA4BnC,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,yBAAyB;IAcjC;;;;;;;OAOG;IACU,IAAI,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,eAAe,EAAE,OAAO,GACzB,OAAO,CAAC,GAAG,CAAC;IA2Bf,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;IAahB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIlD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,wBAAwB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAQ1E,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAK9C,UAAU,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAKhD,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IASzC;;OAEG;IACH,IAAW,mBAAmB,IAAI,MAAM,CAEvC;IAED;;;;;;;;OAQG;IACU,QAAQ,CAAC,wBAAwB,GAAE,MAAa,EAAE,kBAAkB,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhH;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;OAEG;IACI,KAAK,IAAI,IAAI;CAWvB"}

package/dist/src/socket/GGSocket.js

@@ -0,0 +1,315 @@
+/**
+ * Unified WebSocket implementation for both client and server
+ * Handles messaging only - context is set from effects at connection time
+ */
+import { Message, MessageType } from "./SocketMessage.js";
+import { PendingRequestsMap } from "./utils/PendingRequestsMap.js";
+import { GG_WS_MESSAGE } from "../server/GG_WS_MESSAGE.js";
+import { GGWebSocketMetrics } from "../server/GGWebSocketMetrics.js";
+import { GGLog } from "@grest-ts/logger";
+import { ERROR, ROUTE_NOT_FOUND, SERVER_ERROR } from "@grest-ts/schema";
+import { GG_METRICS } from "@grest-ts/metrics";
+import { GGLocator } from "@grest-ts/locator";
+import { GGContext } from "@grest-ts/context";
+import { GG_TRACE } from "@grest-ts/trace";
+export class GGSocket {
+    socket;
+    handlers = new Map();
+    pendingRequests = new PendingRequestsMap();
+    unknownMessageHandler;
+    isActive = true;
+    isCleanedUp = false;
+    tearingDownPromise;
+    onTearDownCallbacks = [];
+    onCloseCallbacks = [];
+    onErrorCallbacks = [];
+    // Metrics labels (optional - set when created by server)
+    apiName;
+    socketPath;
+    connectionContext;
+    constructor(socket, config) {
+        this.socket = socket;
+        this.apiName = config?.apiName ?? 'unknown';
+        this.socketPath = config?.socketPath ?? 'unknown';
+        // Default to passthrough if no context wrapper provided
+        this.connectionContext = config?.connectionContext ?? new GGContext('__unnamed_GGSocket_context');
+        // Capture contexts at construction - socket events lose AsyncLocalStorage context
+        const scope = GGLocator.getScope();
+        this.socket.onMessage(async (data) => {
+            scope.ensureEntered();
+            const context = new GGContext("ws-message", this.connectionContext);
+            await context.run(async () => {
+                GG_TRACE.init();
+                const msg = Message.parse(data);
+                if (!msg) {
+                    return;
+                }
+                if (this.isActive) {
+                    if (msg.type === MessageType.MSG || msg.type === MessageType.REQ) {
+                        GG_WS_MESSAGE.set({ path: msg.path });
+                        await this.handleIncomingMessage(msg);
+                    }
+                    else if (msg.type === MessageType.RES) {
+                        this.pendingRequests.resolve(msg.id, msg.data);
+                    }
+                }
+            });
+        });
+        this.socket.onClose(() => {
+            scope.ensureEntered();
+            this.connectionContext.run(() => {
+                this.isActive = false;
+                if (!this.isCleanedUp) {
+                    this.isCleanedUp = true;
+                    this.pendingRequests.rejectAll(new SERVER_ERROR({ displayMessage: "Socket connection closed!" }));
+                    this.onCloseCallbacks.forEach((onClose) => {
+                        try {
+                            onClose?.();
+                        }
+                        catch (e) {
+                            this.onErrorCallbacks.forEach(cb => cb(e));
+                        }
+                    });
+                }
+            });
+        });
+        this.socket.onError((error) => {
+            scope.ensureEntered();
+            this.connectionContext.run(() => {
+                this.onErrorCallbacks.forEach(cb => cb(error));
+            });
+        });
+    }
+    // --------------------------------------------------------------------------------------
+    // Incoming message handling
+    // --------------------------------------------------------------------------------------
+    async handleIncomingMessage(msg) {
+        const startTime = performance.now();
+        const labels = { api: this.apiName, path: this.socketPath, method: msg.path };
+        const expectsResponse = msg.type === MessageType.REQ;
+        try {
+            const handlerDef = this.handlers.get(msg.path);
+            if (!handlerDef) {
+                this.handleMissingRoute(msg, labels, startTime, expectsResponse);
+                return;
+            }
+            // Handler returns GGPromise - use asResult() to get OK | ERROR
+            const ggPromise = handlerDef.handler(msg.data);
+            const res = await ggPromise.asResult();
+            if (expectsResponse) {
+                this.sendResponse(msg, res, labels, startTime);
+            }
+            else {
+                this.handleFireAndForgetResult(res, labels, startTime);
+            }
+        }
+        catch (error) {
+            GGLog.error(this, error);
+            this.onErrorCallbacks.forEach(cb => cb(error));
+        }
+    }
+    handleMissingRoute(msg, labels, startTime, expectsResponse) {
+        if (expectsResponse) {
+            const error = new ROUTE_NOT_FOUND({ displayMessage: "Route not found: " + msg.path });
+            GGLog.error(this, error);
+            this.sendResponse(msg, error, labels, startTime);
+        }
+        else {
+            if (this.unknownMessageHandler) {
+                this.unknownMessageHandler(msg.path, msg.data);
+            }
+            else {
+                GGLog.warn(this, 'Unknown method ' + msg.path);
+            }
+            this.recordInMetric(labels, 'ROUTE_NOT_FOUND', startTime);
+        }
+    }
+    sendResponse(msg, res, labels, startTime) {
+        const isError = res instanceof ERROR || (res && res.success === false);
+        const resultType = isError ? res.type : 'OK';
+        // res is OK_JSON or ERROR - send as-is (it's already in the right format)
+        const data = isError && res instanceof ERROR ? res.toJSON() : res;
+        this.recordInMetric(labels, resultType, startTime);
+        try {
+            this.socket.send(Message.create(MessageType.RES, msg.path, msg.id, data));
+        }
+        catch (error) {
+            GGLog.error(this, "ERROR_SENDING_RESPONSE", ERROR.fromUnknown(error));
+        }
+    }
+    handleFireAndForgetResult(res, labels, startTime) {
+        const isError = res instanceof ERROR || (res && res.success === false);
+        if (isError) {
+            this.recordInMetric(labels, res.type, startTime);
+            this.onErrorCallbacks.forEach(cb => cb(res));
+        }
+        else {
+            this.recordInMetric(labels, 'OK', startTime);
+        }
+    }
+    // --------------------------------------------------------------------------------------
+    // Outgoing message handling
+    // --------------------------------------------------------------------------------------
+    /**
+     * Send a message over the socket (raw transport).
+     * Data is expected to be already validated by the contract layer.
+     *
+     * @param path - The message path/route
+     * @param body - The message data (already validated)
+     * @param expectsResponse - Whether to wait for a response
+     */
+    async send(path, body, expectsResponse) {
+        const labels = { api: this.apiName, path: this.socketPath, method: path };
+        const startTime = performance.now();
+        if (!this.isActive) {
+            this.recordOutMetric(labels, 'CONNECTION_CLOSED');
+            throw new Error('Cannot send: WebSocket is not connected');
+        }
+        if (expectsResponse) {
+            return this.pendingRequests.create(path, 30000, async (id, waitForResponse) => {
+                this.socket.send(Message.create(MessageType.REQ, path, id, body));
+                const result = await waitForResponse;
+                const resultType = result?.success === true ? 'OK' : (result?.type ?? 'SERVER_ERROR');
+                this.recordOutMetric(labels, resultType, startTime);
+                return result;
+            });
+        }
+        else {
+            this.socket.send(Message.create(MessageType.MSG, path, "", body));
+            this.recordOutMetric(labels, 'OK');
+        }
+    }
+    // --------------------------------------------------------------------------------------
+    // Metrics helpers
+    // --------------------------------------------------------------------------------------
+    recordInMetric(labels, result, startTime) {
+        if (GG_METRICS.has()) {
+            GGWebSocketMetrics.requests.inc(1, { ...labels, result });
+            if (startTime !== undefined) {
+                GGWebSocketMetrics.requestDuration.observe(performance.now() - startTime, labels);
+            }
+        }
+    }
+    recordOutMetric(labels, result, startTime) {
+        if (GG_METRICS.has()) {
+            GGWebSocketMetrics.outRequests.inc(1, { ...labels, result });
+            if (startTime !== undefined) {
+                GGWebSocketMetrics.outRequestDuration.observe(performance.now() - startTime, labels);
+            }
+        }
+    }
+    // --------------------------------------------------------------------------------------
+    // Handler registration
+    // --------------------------------------------------------------------------------------
+    registerHandler(config) {
+        this.handlers.set(config.path, config);
+    }
+    unregisterHandler(path) {
+        this.handlers.delete(path);
+    }
+    setUnknownMessageHandler(handler) {
+        this.unknownMessageHandler = handler;
+    }
+    // --------------------------------------------------------------------------------------
+    // Lifecycle callbacks
+    // --------------------------------------------------------------------------------------
+    onError(onError) {
+        this.onErrorCallbacks.push(onError);
+        return this;
+    }
+    onTearDown(onClosing) {
+        this.onTearDownCallbacks.push(onClosing);
+        return this;
+    }
+    onClose(onClose) {
+        this.onCloseCallbacks.push(onClose);
+        return this;
+    }
+    // --------------------------------------------------------------------------------------
+    // Teardown
+    // --------------------------------------------------------------------------------------
+    /**
+     * Get the number of pending outgoing requests
+     */
+    get pendingRequestCount() {
+        return this.pendingRequests.size;
+    }
+    /**
+     * Starts the socket closing process gracefully.
+     * 1. First waits for pending outgoing requests to complete (up to pendingRequestsTimeoutMs)
+     * 2. Then runs user teardown handlers
+     * 3. Finally closes the socket
+     *
+     * @param pendingRequestsTimeoutMs - Max time to wait for pending requests (default: 5000ms)
+     * @param callbacksTimeoutMs - Max time to wait for teardown callbacks (default: 5000ms)
+     */
+    async teardown(pendingRequestsTimeoutMs = 5000, callbacksTimeoutMs = 5000) {
+        if (this.tearingDownPromise) {
+            GGLog.warn(this, 'Already tearing down!');
+            return this.tearingDownPromise;
+        }
+        GGLog.debug(this, 'Teardown started');
+        this.tearingDownPromise = (async () => {
+            // Step 1: Wait for pending outgoing requests to complete
+            if (this.pendingRequests.hasPending()) {
+                GGLog.debug(this, `Waiting for ${this.pendingRequests.size} pending request(s) to complete...`);
+                await this.pendingRequests.waitForPending(pendingRequestsTimeoutMs);
+                if (this.pendingRequests.hasPending()) {
+                    GGLog.warn(this, `Timeout waiting for pending requests, ${this.pendingRequests.size} request(s) still pending`);
+                }
+            }
+            // Step 2: Run user teardown callbacks with timeout
+            await this.runTeardownCallbacks(callbacksTimeoutMs);
+            // Step 3: Close the socket
+            this.close();
+        })();
+        return this.tearingDownPromise;
+    }
+    /**
+     * Run all teardown callbacks concurrently with a timeout.
+     */
+    runTeardownCallbacks(timeoutMs) {
+        if (this.onTearDownCallbacks.length === 0) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            let remaining = this.onTearDownCallbacks.length;
+            let resolved = false;
+            const finish = () => {
+                if (!resolved) {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    resolve();
+                }
+            };
+            const timeout = setTimeout(() => {
+                GGLog.warn(this, `Teardown timeout - ${remaining} callback(s) still pending after ${timeoutMs}ms`);
+                finish();
+            }, timeoutMs);
+            for (const callback of this.onTearDownCallbacks) {
+                callback()
+                    .catch((err) => GGLog.error(this, 'Error in teardown callback', err))
+                    .finally(() => {
+                    remaining--;
+                    if (remaining === 0)
+                        finish();
+                });
+            }
+        });
+    }
+    /**
+     * Immediately closes the socket.
+     */
+    close() {
+        if (this.isActive) {
+            this.isActive = false;
+            try {
+                this.socket.close();
+            }
+            catch (e) {
+                // Ignore close errors
+            }
+        }
+    }
+}
+//# sourceMappingURL=GGSocket.js.map

package/dist/src/socket/GGSocket.js.map

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

package/dist/src/socket/SocketAdapter.d.ts

@@ -0,0 +1,13 @@
+export interface SocketAdapter {
+    send(message: string): void;
+    close(): void;
+    onOpen(handler: () => void): void;
+    onMessage(handler: (data: string) => void): void;
+    onClose(handler: () => void): void;
+    onError(handler: (error: Error) => void): void;
+    offOpen(handler: () => void): void;
+    offMessage(handler: (data: string) => void): void;
+    offClose(handler: () => void): void;
+    offError(handler: (error: Error) => void): void;
+}
+//# sourceMappingURL=SocketAdapter.d.ts.map

package/dist/src/socket/SocketAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketAdapter.d.ts","sourceRoot":"","sources":["../../../src/socket/SocketAdapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,KAAK,IAAI,IAAI,CAAC;IAEd,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAElC,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAEjD,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAEnC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAE/C,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAEnC,UAAU,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAElD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAEpC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;CACnD"}

package/dist/src/socket/SocketAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SocketAdapter.js.map

package/dist/src/socket/SocketAdapter.js.map

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

package/dist/src/socket/SocketMessage.d.ts

@@ -0,0 +1,47 @@
+import { tPendingMessageId } from "./utils/PendingRequestsMap";
+import { OK_JSON } from "@grest-ts/schema";
+export declare const DELIMITER = ":";
+export declare enum MessageType {
+    HANDSHAKE = "h",// Handshake request (client -> server with headers)
+    HANDSHAKE_OK = "k",// Handshake success (server -> client)
+    HANDSHAKE_ERR = "x",// Handshake error (server -> client)
+    MSG = "m",// Regular message (send-and-forget)
+    REQ = "r",// Request (expects response)
+    RES = "s"
+}
+export interface SocketMessage {
+    type: MessageType;
+    path: string;
+    data?: any;
+}
+export interface HandshakeMessage extends SocketMessage {
+    type: MessageType.HANDSHAKE;
+    data: Record<string, string>;
+}
+export interface HandshakeOkMessage extends SocketMessage {
+    type: MessageType.HANDSHAKE_OK;
+}
+export interface HandshakeErrMessage extends SocketMessage {
+    type: MessageType.HANDSHAKE_ERR;
+    data: any;
+}
+export interface RegularMessage extends SocketMessage {
+    type: MessageType.MSG;
+    data?: any;
+}
+export interface RequestMessage extends SocketMessage {
+    type: MessageType.REQ;
+    id: tPendingMessageId;
+    data?: any;
+}
+export interface ResponseMessage extends SocketMessage {
+    type: MessageType.RES;
+    id: tPendingMessageId;
+    data: OK_JSON<any>;
+}
+export type AnyMessage = HandshakeMessage | HandshakeOkMessage | HandshakeErrMessage | RegularMessage | RequestMessage | ResponseMessage;
+export declare class Message {
+    static create(type: MessageType, path: string, id: tPendingMessageId | "", data: any): string;
+    static parse(msg: unknown): AnyMessage | undefined;
+}
+//# sourceMappingURL=SocketMessage.d.ts.map

package/dist/src/socket/SocketMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketMessage.d.ts","sourceRoot":"","sources":["../../../src/socket/SocketMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAC,OAAO,EAAC,MAAM,kBAAkB,CAAC;AAEzC,eAAO,MAAM,SAAS,MAAM,CAAA;AAG5B,oBAAY,WAAW;IACnB,SAAS,MAAM,CAAI,oDAAoD;IACvE,YAAY,MAAM,CAAE,uCAAuC;IAC3D,aAAa,MAAM,CAAE,qCAAqC;IAC1D,GAAG,MAAM,CAAU,oCAAoC;IACvD,GAAG,MAAM,CAAU,6BAA6B;IAChD,GAAG,MAAM;CACZ;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACnD,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACrD,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC;CAClC;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACtD,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC;IAChC,IAAI,EAAE,GAAG,CAAC;CACb;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACjD,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC;IACtB,IAAI,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACjD,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC;IACtB,EAAE,EAAE,iBAAiB,CAAC;IACtB,IAAI,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IAClD,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC;IACtB,EAAE,EAAE,iBAAiB,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,CAAC;AAEzI,qBAAa,OAAO;WAEF,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM;WAKtF,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS;CAmC5D"}