@zyno-io/dk-server-foundation 26.216.430

package/dist/src/srpc/SrpcClient.js

@@ -0,0 +1,445 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SrpcClient = exports.__ΩSrpcClientOptions = void 0;
+const tslib_1 = require("tslib");
+const __ΩError = ['name', 'message', 'stack', 'Error', 'P&4!&4"&4#8Mw$y'];
+const __ΩNonNullable = ['T', 'NonNullable', 'b!Pe"!PMKw"y'];
+function __assignType(fn, args) {
+    fn.__type = args;
+    return fn;
+}
+/*@ts-ignore*/
+var { __ΩLoggerInterface } = require('@deepkit/logger');
+const crypto_1 = require("crypto");
+const lodash_1 = require("lodash");
+const ws_1 = tslib_1.__importDefault(require("ws"));
+const resolver_1 = require("../app/resolver");
+const helpers_1 = require("../helpers");
+const services_1 = require("../services");
+const telemetry_1 = require("../telemetry");
+const SrpcByteStream_1 = require("./SrpcByteStream");
+/*@ts-ignore*/
+var { __ΩRequestKeys, __ΩIQueuedRequest, __ΩBaseMessage, __ΩSrpcMessageFns, __ΩSrpcMeta, __ΩHandlerRequestData, __ΩResponseData, __ΩRequestData } = require('./types');
+const __ΩSrpcClientOptions = ['enableReconnect', 'SrpcClientOptions', 'P)4!8Mw"y'];
+exports.__ΩSrpcClientOptions = __ΩSrpcClientOptions;
+class SrpcClient {
+    constructor(logger, uri, 
+    /** ts-proto generated ClientMessage type with encode/decode */
+    clientMessage, 
+    /** ts-proto generated ServerMessage type with encode/decode */
+    serverMessage, clientId, clientMeta, clientSecret, clientOptions) {
+        this.logger = logger;
+        this.uri = uri;
+        this.clientId = clientId;
+        this.clientMeta = clientMeta;
+        this.clientSecret = clientSecret;
+        this.streamConnectionHandlers = (Set.Ω = [['', 'P$/!']], new Set());
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.streamMessageHandlers = (Map.Ω = [[() => __ΩRequestKeys, '!o!"'], ['resultType', 'data', '', 'handler', 'P&4!P"2""`/#4$M']], new Map());
+        this.streamDisconnectionHandlers = (Set.Ω = [['', 'P$/!']], new Set());
+        this.requestQueue = (Map.Ω = [['&'], [() => __ΩIQueuedRequest, 'n!']], new Map());
+        this.intentionalDisconnect = false;
+        this.streamId = '';
+        this.isConnected = false;
+        ////////////////////////////////////////
+        // Byte Stream Support
+        this.byteStream = {
+            parentStreamId: '',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            write: __assignType((streamId, chunk) => {
+                return this.writeMessage({ byteStreamOperation: { streamId, write: { chunk } } });
+            }, ['streamId', 'chunk', '', 'P\'2!"2""/#']),
+            finish: __assignType((streamId) => {
+                this.writeMessage({ byteStreamOperation: { streamId, finish: {} } });
+            }, ['streamId', '', 'P\'2!"/"']),
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            destroy: __assignType((streamId, err) => {
+                this.writeMessage({ byteStreamOperation: { streamId, destroy: { error: err ? String(err) : undefined } } });
+            }, ['streamId', 'err', '', 'P\'2!"2"8"/#']),
+            attachDisconnectHandler: __assignType((handler) => {
+                this.ws?.on('close', handler);
+            }, ['', 'handler', 'PP$/!2""/!']),
+            detachDisconnectHandler: __assignType((handler) => {
+                this.ws?.off('close', handler);
+            }, ['', 'handler', 'PP$/!2""/!']),
+            getBufferedAmount: () => {
+                return this.ws?.bufferedAmount ?? 0;
+            }
+        };
+        this.enableReconnect = clientOptions?.enableReconnect !== false;
+        this.outboundType = clientMessage;
+        this.inboundType = serverMessage;
+    }
+    ////////////////////////////////////////
+    // Connection Management
+    connect() {
+        if (this.ws) {
+            this.intentionalDisconnect = true;
+            this.ws.close();
+            this.ws = undefined;
+        }
+        this.intentionalDisconnect = false;
+        this.logger.info('Connecting...');
+        this.streamId = (0, helpers_1.uuid7)();
+        this.byteStream.parentStreamId = this.streamId;
+        SrpcByteStream_1.SrpcByteStream.init(this, { startId: 1, step: 2 });
+        const wsUrl = this.generateWsUrl();
+        const ws = new ws_1.default(wsUrl);
+        ws.binaryType = 'nodebuffer';
+        const connectTimeout = setTimeout(() => {
+            this.logger.warn('Connection timeout');
+            ws.close();
+            this.queueReconnect();
+        }, 10_000);
+        const clearConnectTimeout = (0, lodash_1.once)(() => clearTimeout(connectTimeout));
+        ws.once('open', () => {
+            if (this.ws !== ws)
+                return;
+            this.logger.debug('WebSocket connection opened, waiting for server ping');
+        });
+        ws.once('message', __assignType((data) => this.handleInitialHandshake(ws, data, clearConnectTimeout), ['data', '', 'P!2!"/"']));
+        ws.on('close', __assignType((code, reason) => this.handleClose(ws, code, reason, clearConnectTimeout), ['code', 'reason', '', 'P"2!"2""/#']));
+        ws.on('error', __assignType((err) => this.handleError(ws, err, clearConnectTimeout), [() => __ΩError, 'err', '', 'Pn!2""/#']));
+        this.ws = ws;
+    }
+    disconnect() {
+        this.enableReconnect = false;
+        this.intentionalDisconnect = true;
+        if (this.reconnectionTimeout) {
+            clearTimeout(this.reconnectionTimeout);
+            this.reconnectionTimeout = undefined;
+        }
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = undefined;
+        }
+        if (this.ws) {
+            this.ws.close(1000, 'Client disconnect');
+        }
+    }
+    /**
+     * Trigger an immediate connection health check.
+     * Sends a ping and expects a pong before the next scheduled ping interval,
+     * otherwise the connection will be reset due to pong timeout.
+     */
+    triggerConnectionCheck() {
+        if (!this.isConnected)
+            return;
+        this.logger.debug('Triggering connection check');
+        this.lastPongMs = Date.now() - 20_000;
+        this.writeMessage({ pingPong: {} });
+    }
+    ////////////////////////////////////////
+    // Connection Handlers
+    handleInitialHandshake(ws, data, clearConnectTimeout) {
+        if (this.ws !== ws)
+            return;
+        clearConnectTimeout();
+        const message = this.decodeMessage(data);
+        if (!message) {
+            this.logger.warn('Failed to decode initial message');
+            ws.close();
+            return;
+        }
+        if (!message.pingPong) {
+            this.logger.warn('Expected pingPong as first message, got:', message);
+            ws.close();
+            return;
+        }
+        this.lastPongMs = Date.now();
+        this.writeMessage({ pingPong: {} });
+        this.logger.info('Stream established');
+        this.isConnected = true;
+        this.pingInterval = setInterval(() => this.doPingPong(), 55_000);
+        this.streamConnectionHandlers.forEach(__assignType(handler => handler(), ['handler', '', 'P"2!"/"']));
+        ws.on('message', __assignType(async (msgData) => this.handleMessage(msgData), ['msgData', '', 'P!2!"/"']));
+    }
+    handleClose(ws, code, reason, clearConnectTimeout) {
+        if (ws !== this.ws)
+            return;
+        clearConnectTimeout();
+        if (this.intentionalDisconnect) {
+            this.logger.debug('WebSocket closed by client');
+        }
+        else {
+            this.logger.info('Stream ended', { code, reason: String(reason) });
+        }
+        this.handleDisconnect();
+    }
+    handleError(ws, err, clearConnectTimeout) {
+        if (ws !== this.ws)
+            return;
+        clearConnectTimeout();
+        if (!this.intentionalDisconnect) {
+            this.logger.warn('WebSocket error', err);
+        }
+        ws.terminate();
+        this.handleDisconnect();
+    }
+    handleDisconnect() {
+        if (this.reconnectionTimeout) {
+            return;
+        }
+        if (this.enableReconnect) {
+            this.queueReconnect();
+        }
+        clearInterval(this.pingInterval);
+        this.pingInterval = undefined;
+        const wasConnected = this.isConnected;
+        this.isConnected = false;
+        this.ws = undefined;
+        if (wasConnected) {
+            this.streamDisconnectionHandlers.forEach(__assignType(handler => handler(), ['handler', '', 'P"2!"/"']));
+        }
+        for (const queueItem of this.requestQueue.values()) {
+            queueItem.reject(new Error('Disconnected'));
+        }
+        this.requestQueue.clear();
+    }
+    queueReconnect() {
+        if (!this.enableReconnect) {
+            return;
+        }
+        this.reconnectionTimeout = setTimeout(() => {
+            this.reconnectionTimeout = undefined;
+            this.connect();
+        }, 1000);
+    }
+    doPingPong() {
+        if ((this.lastPongMs ?? 0) < Date.now() - 75_000) {
+            this.logger.warn('Pong timeout');
+            this.ws?.close(4001, 'Pong timeout');
+            return;
+        }
+        this.writeMessage({ pingPong: {} });
+    }
+    ////////////////////////////////////////
+    // Message Handling
+    async handleMessage(data) {
+        const message = this.decodeMessage(data);
+        if (!message) {
+            this.logger.warn('Failed to decode message');
+            return;
+        }
+        if (message.pingPong) {
+            this.lastPongMs = Date.now();
+            return;
+        }
+        if (message.byteStreamOperation) {
+            return this.handleByteStreamOperation(message.byteStreamOperation);
+        }
+        const { requestId, reply } = message;
+        this.logger.debug('Server message received', { requestId, reply, error: !!message.error });
+        if (!requestId) {
+            this.logger.warn('Protocol error: missing request ID, terminating connection');
+            this.ws?.close(4002, 'Invalid request ID');
+            return;
+        }
+        if (reply) {
+            return this.handleReply(requestId, message);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await this.handleServerRequest(requestId, message);
+    }
+    handleByteStreamOperation(op) {
+        if (op.write) {
+            return SrpcByteStream_1.SrpcByteStream.writeReceiver(this, op.streamId, op.write.chunk);
+        }
+        if (op.finish) {
+            return SrpcByteStream_1.SrpcByteStream.finishReceiver(this, op.streamId);
+        }
+        if (op.destroy) {
+            return SrpcByteStream_1.SrpcByteStream.destroySubstream(this, op.streamId, op.destroy.error);
+        }
+    }
+    handleReply(requestId, message) {
+        const queueItem = this.requestQueue.get(requestId);
+        if (!queueItem) {
+            this.logger.warn('Protocol error: unknown request ID for reply, terminating connection', { requestId });
+            this.ws?.close(4003, 'Unknown request ID');
+            return;
+        }
+        this.requestQueue.delete(requestId);
+        if (message.error) {
+            return queueItem.reject(message.error);
+        }
+        return queueItem.resolve(message);
+    }
+    async handleServerRequest(requestId, message) {
+        for (const key of this.streamMessageHandlers.keys()) {
+            if (message[key]) {
+                const logMeta = { requestId, requestType: key, traceId: message.trace?.traceId };
+                const response = await (0, telemetry_1.withRemoteSpan)('srpc:handleServerRequest', message.trace, { requestId, requestType: key }, () => (0, services_1.withLoggerContext)({ srpc: logMeta }, async () => {
+                    try {
+                        this.logger.info('Server request received');
+                        const handlerMeta = this.streamMessageHandlers.get(key);
+                        const result = await handlerMeta.handler(message[key]);
+                        this.logger.info('Server request processed');
+                        return {
+                            [handlerMeta.resultType]: result
+                        };
+                    }
+                    catch (err) {
+                        this.logger.warn('Server request failed', err);
+                        throw err;
+                    }
+                }));
+                this.writeMessage({ requestId, reply: true, ...response });
+                return;
+            }
+        }
+        this.logger.error('Unhandled message type', { requestId });
+        this.writeMessage({ requestId, reply: true, error: 'Unhandled message type' });
+    }
+    ////////////////////////////////////////
+    // Protocol Helpers
+    generateWsUrl() {
+        const authv = 1;
+        const appv = '0.0.0'; // todo: autodetect
+        const ts = Date.now();
+        const cid = this.clientId;
+        const signable = `${authv}\n${appv}\n${ts}\n${this.streamId}\n${cid}\n`;
+        const secret = this.clientSecret ?? (0, resolver_1.getAppConfig)().SRPC_AUTH_SECRET;
+        if (!secret)
+            throw new Error('SRPC_AUTH_SECRET is not configured.');
+        const signature = (0, crypto_1.createHmac)('sha256', secret).update(signable).digest('hex');
+        const params = new URLSearchParams({
+            authv: String(authv),
+            appv,
+            ts: String(ts),
+            id: this.streamId,
+            cid,
+            signature
+        });
+        if (this.clientMeta) {
+            for (const [key, value] of Object.entries(this.clientMeta)) {
+                params.set(`m--${key}`, String(value));
+            }
+        }
+        const baseUri = this.uri.startsWith('ws://') || this.uri.startsWith('wss://') ? this.uri : `ws://${this.uri}`;
+        const url = new URL(baseUri);
+        url.search = params.toString();
+        return url.toString();
+    }
+    decodeMessage(data) {
+        try {
+            return this.inboundType.decode(data);
+        }
+        catch (err) {
+            this.logger.error('Failed to decode message', { err: String(err) });
+            return null;
+        }
+    }
+    writeMessage(message) {
+        if (!this.ws || this.ws.readyState !== ws_1.default.OPEN) {
+            return false;
+        }
+        try {
+            const encoded = this.outboundType.encode(message).finish();
+            this.ws.send(encoded);
+            return true;
+        }
+        catch (err) {
+            this.logger.error('Failed to encode/send message', { err: String(err) });
+            return false;
+        }
+    }
+    ////////////////////////////////////////
+    // Public API
+    registerConnectionHandler(handler) {
+        this.streamConnectionHandlers.add(handler);
+    }
+    /**
+     * Register a handler for server requests (downstream/server-initiated).
+     * @example client.registerMessageHandler('dNotify', async (data) => ({ acknowledged: true }))
+     */
+    registerMessageHandler(prefix, handler) {
+        const actionType = `${prefix}Request`;
+        const resultType = `${prefix}Response`;
+        this.streamMessageHandlers.set(actionType, {
+            resultType,
+            handler
+        });
+    }
+    registerDisconnectHandler(handler) {
+        this.streamDisconnectionHandlers.add(handler);
+    }
+    /**
+     * Invoke a server method.
+     * @example client.invoke('uEcho', { message: 'hello' })
+     */
+    invoke(prefix, data, timeoutMs = 30_000) {
+        const requestType = `${prefix}Request`;
+        const resultType = `${prefix}Response`;
+        const requestId = (0, helpers_1.uuid7)();
+        const traceContext = (0, telemetry_1.getTraceContext)();
+        const trace = traceContext ? { traceId: traceContext.traceId, spanId: traceContext.spanId, traceFlags: traceContext.traceFlags } : undefined;
+        return (0, telemetry_1.withSpan)('srpc:invokeServer', { requestType }, () => (0, services_1.withLoggerContext)({ srpc: { requestId, requestType, traceId: trace?.traceId } }, async () => {
+            this.logger.info('Requesting server invocation');
+            let timeoutHandle;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const responsePromise = (Promise.Ω = [['"']], new Promise(__assignType((resolve, reject) => {
+                    this.requestQueue.set(requestId, {
+                        exp: Date.now() + timeoutMs,
+                        resolve,
+                        reject
+                    });
+                    const sent = this.writeMessage({ requestId, trace, [requestType]: data });
+                    if (!sent) {
+                        this.requestQueue.delete(requestId);
+                        reject(new Error('Failed to send request: not connected'));
+                    }
+                }, ['resolve', 'reject', '', 'P"2!"2""/#'])));
+                const timeoutPromise = (Promise.Ω = [['!']], new Promise(__assignType((_, reject) => {
+                    timeoutHandle = setTimeout(() => {
+                        if (this.requestQueue.has(requestId)) {
+                            this.requestQueue.delete(requestId);
+                            reject(new Error(`Request timeout after ${timeoutMs}ms`));
+                        }
+                    }, timeoutMs);
+                }, ['_', 'reject', '', 'P"2!"2""/#'])));
+                const result = await Promise.race([responsePromise, timeoutPromise]);
+                clearTimeout(timeoutHandle);
+                // Use null check instead of `in` for consistency with ts-proto field materialization
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                if (result[resultType] == null) {
+                    throw new Error('Invalid response from server');
+                }
+                this.logger.info('Server invocation completed');
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return result[resultType];
+            }
+            catch (err) {
+                clearTimeout(timeoutHandle);
+                this.logger.warn('Server invocation failed', err);
+                throw err;
+            }
+        }));
+    }
+}
+exports.SrpcClient = SrpcClient;
+SrpcClient.__type = [() => __ΩBaseMessage, 'TClientInput', () => __ΩBaseMessage, 'TServerOutput', () => ws_1.default, 'ws', () => __ΩSrpcMessageFns, 'outboundType', () => __ΩSrpcMessageFns, 'inboundType', 'streamConnectionHandlers', function () { return (Set.Ω = [['', 'P$/!']], new Set()); }, 'streamMessageHandlers', function () { return (Map.Ω = [[() => __ΩRequestKeys, '!o!"'], ['resultType', 'data', '', 'handler', 'P&4!P"2""`/#4$M']], new Map()); }, 'streamDisconnectionHandlers', function () { return (Set.Ω = [['', 'P$/!']], new Set()); }, 'reconnectionTimeout', 'pingInterval', 'lastPongMs', 'requestQueue', function () { return (Map.Ω = [['&'], [() => __ΩIQueuedRequest, 'n!']], new Map()); }, 'enableReconnect', 'intentionalDisconnect', function () { return false; }, 'streamId', function () { return ''; }, 'isConnected', function () { return false; }, () => __ΩLoggerInterface, 'logger', 'uri', () => __ΩSrpcMessageFns, 'clientMessage', () => __ΩSrpcMessageFns, 'serverMessage', 'clientId', () => __ΩSrpcMeta, 'clientMeta', 'clientSecret', () => __ΩSrpcClientOptions, 'clientOptions', 'constructor', 'connect', 'disconnect', 'triggerConnectionCheck', () => ws_1.default, 'data', '', 'clearConnectTimeout', 'handleInitialHandshake', () => ws_1.default, 'code', 'reason', 'handleClose', () => ws_1.default, () => __ΩError, 'err', 'handleError', 'handleDisconnect', 'queueReconnect', 'doPingPong', 'handleMessage', () => __ΩNonNullable, "byteStreamOperation", 'op', 'handleByteStreamOperation', 'requestId', () => __ΩBaseMessage, 'message', 'handleReply', () => __ΩBaseMessage, 'handleServerRequest', 'generateWsUrl', () => __ΩBaseMessage, 'decodeMessage', () => __ΩBaseMessage, 'writeMessage', 'byteStream', function () { return {
+        parentStreamId: '',
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        write: __assignType((streamId, chunk) => {
+            return this.writeMessage({ byteStreamOperation: { streamId, write: { chunk } } });
+        }, ['streamId', 'chunk', '', 'P\'2!"2""/#']),
+        finish: __assignType((streamId) => {
+            this.writeMessage({ byteStreamOperation: { streamId, finish: {} } });
+        }, ['streamId', '', 'P\'2!"/"']),
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        destroy: __assignType((streamId, err) => {
+            this.writeMessage({ byteStreamOperation: { streamId, destroy: { error: err ? String(err) : undefined } } });
+        }, ['streamId', 'err', '', 'P\'2!"2"8"/#']),
+        attachDisconnectHandler: __assignType((handler) => {
+            this.ws?.on('close', handler);
+        }, ['', 'handler', 'PP$/!2""/!']),
+        detachDisconnectHandler: __assignType((handler) => {
+            this.ws?.off('close', handler);
+        }, ['', 'handler', 'PP$/!2""/!']),
+        getBufferedAmount: () => {
+            return this.ws?.bufferedAmount ?? 0;
+        }
+    }; }, 'handler', 'registerConnectionHandler', 'prefix', () => __ΩHandlerRequestData, () => __ΩResponseData, 'registerMessageHandler', 'registerDisconnectHandler', () => __ΩRequestData, 'timeoutMs', () => __ΩResponseData, 'invoke', 'SrpcClient', 'n!c"n#c$P7%3&8;e!!o\'"3(;e!"o)"3*;!3+;>,!3-;>.!3/;>0!318;!328;\'338;!34;>5)36;)37;>8&39;>:)3;><Pn=2>;&2?;e"!o@"2Ae""oB"2C&2D;nE2F8;&2G8;nH2I8"0JP"0KP"0LP"0MPP7N2&!2OP$/P2Q"0R;PP7S2&\'2TP!&J2UP$/P2Q"0V;PP7W2&nX2YP$/P2Q"0Z;P"0[;P"0\\;P"0];P!2O"0^;Pe"".`fo_"2a"0b;P&2cPe#"ndK2e"0f;P&2cPe#"ngK2e$`0h;P&0i;P!2OPPe$"njK,J0k;Pnl2e)0m;!3n>oPP$/P2p"0qP"2rPe#""os#2Oe#!"ot#`/P2p"0uPP$/P2p"0vP"2re"!"ow#2O"2xe"""oy#`0z5w{'];
+//# sourceMappingURL=SrpcClient.js.map

package/dist/src/srpc/SrpcClient.js.map

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

package/dist/src/srpc/SrpcServer.d.ts

@@ -0,0 +1,80 @@
+import { IncomingMessage } from 'http';
+import { BaseMessage, HandlerRequestData, InvokePrefixes, ISrpcServerOptions, RequestData, ResponseData, SrpcDisconnectCause, SrpcMeta, SrpcStream, TSrpcMessageHandlerFnOrClass } from './types';
+/**
+ * Monkey-patches `httpServer.emit` so that once an upgrade listener claims
+ * a socket (by setting UpgradeClaimedSymbol), no further listeners are
+ * invoked.  This prevents consumer @AutoStart services from destroying
+ * sockets that an SrpcServer is already handling.
+ *
+ * Also installs a low-priority fallback that destroys any socket not
+ * claimed by any handler (via setImmediate, after all sync work).
+ */
+export declare function installUpgradeClaimHandling(httpServer: import('http').Server): void;
+/**
+ * Returns `true` if the given socket has already been claimed by an
+ * upgrade handler (via `markUpgradeClaimed`).
+ */
+export declare function isUpgradeClaimed(socket: import('net').Socket): boolean;
+/**
+ * Mark a socket as claimed so that `installUpgradeClaimHandling`'s
+ * patched emit stops propagating the `'upgrade'` event to subsequent
+ * listeners.  SrpcServer calls this automatically; consumer apps with
+ * their own WebSocket upgrade logic can call it to participate in the
+ * same claim protocol.
+ */
+export declare function markUpgradeClaimed(socket: import('net').Socket): void;
+export declare class SrpcServer<TMeta extends SrpcMeta = SrpcMeta, TClientOutput extends BaseMessage = BaseMessage, TServerOutput extends BaseMessage = BaseMessage> {
+    private options;
+    private standardSrpcAuthKey?;
+    private authClockDriftMs;
+    private useRealIpHeader;
+    private logger;
+    private wsServer;
+    private httpServer;
+    private upgradeHandler;
+    private inboundType;
+    private outboundType;
+    private clientAuthorizer?;
+    private clientKeyFetcher?;
+    private streamConnectionHandlers;
+    private streamMessageHandlers;
+    private streamDisconnectionHandlers;
+    private inactivityCheckInterval;
+    readonly streamsById: Map<string, SrpcStream<TMeta>>;
+    readonly streamsByClientId: Map<string, SrpcStream<TMeta>>;
+    constructor(options: ISrpcServerOptions<TClientOutput, TServerOutput>);
+    private verifyClient;
+    private attachConnection;
+    private handleWsMessage;
+    private write;
+    private writeToStream;
+    private closeStreamWithError;
+    private validateClientAuth;
+    private fetchClientKey;
+    setClientAuthorizer(authorizer: (metadata: SrpcMeta, req: IncomingMessage) => Promise<boolean | SrpcMeta>): void;
+    setClientKeyFetcher(fetcher: (clientId: string) => Promise<false | string>): void;
+    close(): void;
+    private handleStreamEstablished;
+    private handleStreamDisconnected;
+    private handleStreamError;
+    private terminateInactiveStreams;
+    private cleanupStream;
+    private handleStreamDataReceived;
+    private handleByteSubstreamOperation;
+    private handleClientRequest;
+    private runMessageHandler;
+    registerConnectionHandler(handler: (stream: SrpcStream<TMeta>) => void): void;
+    /**
+     * Register a handler for client requests.
+     * @example server.registerMessageHandler('uEcho', async (stream, data) => ({ message: `Echo: ${data.message}` }))
+     */
+    registerMessageHandler<P extends InvokePrefixes<TClientOutput, TServerOutput>>(prefix: P, handler: TSrpcMessageHandlerFnOrClass<SrpcStream<TMeta>, HandlerRequestData<TClientOutput, P>, ResponseData<TServerOutput, P>>): void;
+    registerDisconnectHandler(handler: (stream: SrpcStream<TMeta>, cause: SrpcDisconnectCause) => void): void;
+    /**
+     * Invoke a client method.
+     * @example server.invoke(stream, 'dNotify', { notification: 'hello' })
+     */
+    invoke<P extends InvokePrefixes<TServerOutput, TClientOutput>>(stream: SrpcStream<TMeta>, prefix: P, data: RequestData<TServerOutput, P>, timeoutMs?: number): Promise<ResponseData<TClientOutput, P>>;
+    static createInvoke<TM extends SrpcMeta, TCO extends BaseMessage, TSO extends BaseMessage>(instanceFn: () => SrpcServer<TM, TCO, TSO>): SrpcServer<TM, TCO, TSO>['invoke'];
+}
+//# sourceMappingURL=SrpcServer.d.ts.map

package/dist/src/srpc/SrpcServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SrpcServer.d.ts","sourceRoot":"","sources":["../../../src/srpc/SrpcServer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAQvC,OAAO,EACH,WAAW,EACX,kBAAkB,EAClB,cAAc,EAGd,kBAAkB,EAElB,WAAW,EAEX,YAAY,EACZ,mBAAmB,EAGnB,QAAQ,EACR,UAAU,EACV,4BAA4B,EAC/B,MAAM,SAAS,CAAC;AAOjB;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,OAAO,MAAM,EAAE,MAAM,QAgC5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,IAAI,CAGrE;AAED,qBAAa,UAAU,CACnB,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACjC,aAAa,SAAS,WAAW,GAAG,WAAW,EAC/C,aAAa,SAAS,WAAW,GAAG,WAAW;IA6BnC,OAAO,CAAC,OAAO;IA3B3B,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAU;IAEjC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,UAAU,CAAwB;IAE1C,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,YAAY,CAAgC;IAEpD,OAAO,CAAC,gBAAgB,CAAC,CAA4E;IACrG,OAAO,CAAC,gBAAgB,CAAC,CAAgD;IACzE,OAAO,CAAC,wBAAwB,CAAkD;IAElF,OAAO,CAAC,qBAAqB,CAIzB;IACJ,OAAO,CAAC,2BAA2B,CAA8E;IACjH,OAAO,CAAC,uBAAuB,CAAiC;IAEhE,SAAgB,WAAW,iCAAwC;IACnE,SAAgB,iBAAiB,iCAAwC;gBAErD,OAAO,EAAE,kBAAkB,CAAC,aAAa,EAAE,aAAa,CAAC;IA+D7E,OAAO,CAAC,YAAY;IA8DpB,OAAO,CAAC,gBAAgB;IAgExB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,oBAAoB;YAOd,kBAAkB;YAoClB,cAAc;IAQ5B,mBAAmB,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC;IAIzG,mBAAmB,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC;IAI1E,KAAK;IAYL,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,wBAAwB;IA2DhC,OAAO,CAAC,4BAA4B;YActB,mBAAmB;YA8BnB,iBAAiB;IAa/B,yBAAyB,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI;IAItE;;;OAGG;IACH,sBAAsB,CAAC,CAAC,SAAS,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,EACzE,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,4BAA4B,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAUlI,yBAAyB,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,mBAAmB,KAAK,IAAI;IAIlG;;;OAGG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,EACzD,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,EACzB,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,EACnC,SAAS,SAAS,GACnB,OAAO,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IA6C1C,MAAM,CAAC,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EACrF,UAAU,EAAE,MAAM,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAC3C,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;CASxC"}