@zyno-io/ts-server-foundation 26.712.36

package/dist/src/services/mesh-client/mesh-client-registry.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeshClientRegistry = void 0;
+let _MeshClientRegistryMetadata_1;
+class MeshClientRegistry {
+    nodeId;
+    backend;
+    constructor(nodeId, backend) {
+        this.nodeId = nodeId;
+        this.backend = backend;
+    }
+    async register(clientId, metadata, allowSupersede) {
+        return this.backend.register(clientId, this.nodeId, metadata, allowSupersede);
+    }
+    async reserve(clientId, metadata, allowSupersede) {
+        return this.backend.reserve(clientId, this.nodeId, metadata, allowSupersede);
+    }
+    async activate(clientId, metadata) {
+        return this.backend.activate(clientId, this.nodeId, metadata);
+    }
+    async unregister(clientId) {
+        return this.backend.unregister(clientId, this.nodeId);
+    }
+    async updateMetadata(clientId, metadata) {
+        return this.backend.updateMetadata(clientId, this.nodeId, metadata);
+    }
+    async getClient(clientId) {
+        return this.backend.getClient(clientId);
+    }
+    async listClients() {
+        return this.backend.listClients();
+    }
+    async listClientsForNode(nodeId) {
+        return this.backend.listClientsForNode(nodeId ?? this.nodeId);
+    }
+    async cleanupNode(nodeId) {
+        return this.backend.cleanupNode(nodeId ?? this.nodeId);
+    }
+    static __tsfType = _MeshClientRegistryMetadata_1 = ({ kind: 16, name: "MeshClientRegistry", typeName: "MeshClientRegistry", classType: () => MeshClientRegistry, properties: [], methods: [{ name: "register", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "metadata", type: { kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }, optional: false, default: false }, { name: "allowSupersede", type: { kind: 8 }, optional: true, default: false }], returnType: { kind: 22, type: { kind: 12, types: [{ kind: 2, typeName: "{ status: 'ok'; supersededNodeId: number | null }\n    // ownerNodeId can be null if the owning client disappears during\n    // the Redis conflict/readback race." }, { kind: 18, types: [{ kind: 20, name: "status", type: { kind: 10, literal: "conflict" }, optional: false }, { kind: 20, name: "ownerNodeId", type: { kind: 12, types: [{ kind: 7 }, { kind: 5 }] }, optional: false }] }], typeName: "RegisterResult" } } }, { name: "reserve", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "metadata", type: { kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }, optional: false, default: false }, { name: "allowSupersede", type: { kind: 8 }, optional: true, default: false }], returnType: { kind: 22, type: { kind: 12, types: [{ kind: 2, typeName: "{ status: 'ok'; supersededNodeId: number | null }\n    // ownerNodeId can be null if the owning client disappears during\n    // the Redis conflict/readback race." }, { kind: 18, types: [{ kind: 20, name: "status", type: { kind: 10, literal: "conflict" }, optional: false }, { kind: 20, name: "ownerNodeId", type: { kind: 12, types: [{ kind: 7 }, { kind: 5 }] }, optional: false }] }], typeName: "RegisterResult" } } }, { name: "activate", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "metadata", type: { kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 8 } } }, { name: "unregister", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 8 } } }, { name: "updateMetadata", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "metadata", type: { kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 8 } } }, { name: "getClient", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 12, types: [{ kind: 16, typeName: "RegisteredClient", classType: () => (typeof require !== "undefined" ? require("./types").RegisteredClient : undefined), typeArguments: [{ kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }] }, { kind: 4 }] } } }, { name: "listClients", parameters: [], returnType: { kind: 22, type: { kind: 14, type: { kind: 16, typeName: "RegisteredClient", classType: () => (typeof require !== "undefined" ? require("./types").RegisteredClient : undefined), typeArguments: [{ kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }] } } } }, { name: "listClientsForNode", parameters: [{ name: "nodeId", type: { kind: 7 }, optional: true, default: false }], returnType: { kind: 22, type: { kind: 14, type: { kind: 16, typeName: "RegisteredClient", classType: () => (typeof require !== "undefined" ? require("./types").RegisteredClient : undefined), typeArguments: [{ kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }] } } } }, { name: "cleanupNode", parameters: [{ name: "nodeId", type: { kind: 7 }, optional: true, default: false }], returnType: { kind: 22, type: { kind: 14, type: { kind: 16, typeName: "RegisteredClient", classType: () => (typeof require !== "undefined" ? require("./types").RegisteredClient : undefined), typeArguments: [{ kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }] } } } }], hasConstructor: true, constructorParameters: [{ name: "nodeId", type: { kind: 7 }, optional: false, default: false }, { name: "backend", type: { kind: 16, typeName: "MeshClientRegistryBackend", classType: () => (typeof require !== "undefined" ? require("./types").MeshClientRegistryBackend : undefined), typeArguments: [{ kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }] }, optional: false, default: false }] });
+}
+exports.MeshClientRegistry = MeshClientRegistry;
+_MeshClientRegistryMetadata_1.classType = MeshClientRegistry;
+MeshClientRegistry.__tsfType = _MeshClientRegistryMetadata_1;
+//# sourceMappingURL=mesh-client-registry.js.map

package/dist/src/services/mesh-client/mesh-client-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-client-registry.js","sourceRoot":"","sources":["../../../../src/services/mesh-client/mesh-client-registry.ts"],"names":[],"mappings":";;;;AAEA;IAEgB,MAAM;IACN,OAAO;IAFnB,YACY,MAAc,EACd,OAAyC;sBADzC,MAAM;uBACN,OAAO;IAChB,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,QAAe,EAAE,cAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,QAAe,EAAE,cAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,QAAe;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,QAAe;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,MAAe;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAe;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;;CACJ"}

package/dist/src/services/mesh-client/mesh-client-service.d.ts

@@ -0,0 +1,88 @@
+import { MeshService, type MeshBroadcastMap, type MeshBroadcastOptions, type MeshServiceOptions } from '../mesh';
+import { MeshClientRegistry } from './mesh-client-registry';
+import { type MeshClientRegistryBackend, type RegisteredClient } from './types';
+type ForwardRequest = {
+    clientId: string;
+    type: string;
+    data: unknown;
+    timeoutMs?: number;
+};
+type ForwardResponse = {
+    data?: unknown;
+    error?: string;
+    errorName?: string;
+};
+type KickClientRequest = {
+    clientId: string;
+};
+type KickClientResponse = {
+    kicked: boolean;
+};
+type UpdateMetaRequest = {
+    clientId: string;
+    metadata: unknown;
+};
+type UpdateMetaResponse = {
+    updated: boolean;
+};
+type ForwardMessages = {
+    forward: {
+        request: ForwardRequest;
+        response: ForwardResponse;
+    };
+    kickClient: {
+        request: KickClientRequest;
+        response: KickClientResponse;
+    };
+    updateMeta: {
+        request: UpdateMetaRequest;
+        response: UpdateMetaResponse;
+    };
+};
+export interface MeshClientServiceOptions<TMeta> {
+    key: string;
+    meshOptions?: MeshServiceOptions;
+    registryBackend?: MeshClientRegistryBackend<TMeta>;
+    clientInvokeFn: (clientId: string, type: string, data: unknown, timeoutMs?: number) => Promise<unknown>;
+    clientUpdateMetaFn?: (clientId: string, metadata: TMeta) => boolean;
+}
+export declare class MeshClientService<TMeta, TBroadcasts extends MeshBroadcastMap = {}> {
+    /** @internal */
+    readonly mesh: MeshService<ForwardMessages, TBroadcasts>;
+    private logger;
+    private registry;
+    private backend;
+    private clientInvokeFn;
+    private clientUpdateMetaFn;
+    private nodeCleanedUpCallbacks;
+    private clientSupersededCallbacks;
+    constructor(options: MeshClientServiceOptions<TMeta>);
+    onNodeClientsOrphaned(cb: (nodeId: number, orphaned: RegisteredClient<TMeta>[]) => void | Promise<void>): void;
+    onClientSuperseded(cb: (clientId: string) => void | Promise<void>): void;
+    get instanceId(): number;
+    get clientRegistry(): MeshClientRegistry<TMeta>;
+    private running;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Register a client on this node. Returns true if registered, false if
+     * another node owns the client and `allowSupersede` is false (conflict).
+     */
+    registerClient(clientId: string, metadata: TMeta, allowSupersede?: boolean): Promise<boolean>;
+    /**
+     * Reserve ownership of a clientId without exposing it for lookup/invoke
+     * until activation completes.
+     */
+    reserveClient(clientId: string, metadata: TMeta, allowSupersede?: boolean): Promise<boolean>;
+    /**
+     * Promote a same-node reservation to an active, discoverable client.
+     */
+    activateClient(clientId: string, metadata: TMeta): Promise<boolean>;
+    unregisterClient(clientId: string): Promise<boolean>;
+    updateClientMetadata(clientId: string, metadata: TMeta): Promise<boolean>;
+    registerBroadcastHandler<K extends keyof TBroadcasts & string>(type: K, handler: (data: TBroadcasts[K], senderInstanceId: number) => void | Promise<void>): void;
+    broadcast<K extends keyof TBroadcasts & string>(type: K, data: TBroadcasts[K], options?: MeshBroadcastOptions): Promise<void>;
+    invoke(clientId: string, type: string, data: unknown, timeoutMs?: number): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=mesh-client-service.d.ts.map

package/dist/src/services/mesh-client/mesh-client-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-client-service.d.ts","sourceRoot":"","sources":["../../../../src/services/mesh-client/mesh-client-service.ts"],"names":[],"mappings":"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"}

package/dist/src/services/mesh-client/mesh-client-service.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = exports.MeshClientService = void 0;
+const logger_1 = require("../logger");
+const mesh_1 = require("../mesh");
+const mesh_client_redis_registry_1 = require("./mesh-client-redis-registry");
+const mesh_client_registry_1 = require("./mesh-client-registry");
+const types_1 = require("./types");
+let _MeshClientServiceMetadata_1;
+// --- MeshClientService ---
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+class MeshClientService {
+    // Exposed for MeshSrpcServer to access internals
+    /** @internal */
+    mesh;
+    logger = (0, logger_1.createLogger)(this);
+    registry;
+    backend;
+    clientInvokeFn;
+    clientUpdateMetaFn;
+    nodeCleanedUpCallbacks = [];
+    clientSupersededCallbacks = [];
+    constructor(options) {
+        this.backend = options.registryBackend ?? new mesh_client_redis_registry_1.MeshClientRedisRegistry(`_mc:${options.key}`);
+        this.clientInvokeFn = options.clientInvokeFn;
+        this.clientUpdateMetaFn = options.clientUpdateMetaFn;
+        this.mesh = new mesh_1.MeshService(`_mc:${options.key}`, options.meshOptions);
+        this.mesh.registerHandler('forward', async (req) => {
+            try {
+                const result = await this.clientInvokeFn(req.clientId, req.type, req.data, req.timeoutMs);
+                return { data: result };
+            }
+            catch (err) {
+                return {
+                    error: err instanceof Error ? err.message : String(err),
+                    errorName: err instanceof Error ? err.name : undefined
+                };
+            }
+        });
+        this.mesh.registerHandler('kickClient', async (req) => {
+            let kicked = false;
+            for (const cb of this.clientSupersededCallbacks) {
+                try {
+                    await cb(req.clientId);
+                    kicked = true;
+                }
+                catch (err) {
+                    this.logger.warn('client superseded callback error', { err, clientId: req.clientId });
+                }
+            }
+            return { kicked };
+        });
+        this.mesh.registerHandler('updateMeta', async (req) => {
+            const metadata = req.metadata;
+            if (this.clientUpdateMetaFn && !this.clientUpdateMetaFn(req.clientId, metadata))
+                return { updated: false };
+            return { updated: await this.registry.updateMetadata(req.clientId, metadata) };
+        });
+        this.mesh.setNodeCleanedUpCallback(async (nodeId) => {
+            const orphaned = await this.backend.cleanupNode(nodeId);
+            if (orphaned.length > 0) {
+                for (const cb of this.nodeCleanedUpCallbacks) {
+                    try {
+                        await cb(nodeId, orphaned);
+                    }
+                    catch (err) {
+                        this.logger.warn('node cleanup callback error', { err, nodeId });
+                    }
+                }
+            }
+        });
+        // Placeholder registry - will be re-created in start() with the real instanceId
+        this.registry = new mesh_client_registry_1.MeshClientRegistry(0, this.backend);
+    }
+    onNodeClientsOrphaned(cb) {
+        this.nodeCleanedUpCallbacks.push(cb);
+    }
+    onClientSuperseded(cb) {
+        this.clientSupersededCallbacks.push(cb);
+    }
+    get instanceId() {
+        return this.mesh.instanceId;
+    }
+    get clientRegistry() {
+        return this.registry;
+    }
+    running = false;
+    async start() {
+        await this.mesh.start();
+        this.registry = new mesh_client_registry_1.MeshClientRegistry(this.mesh.instanceId, this.backend);
+        this.running = true;
+    }
+    async stop() {
+        this.running = false;
+        try {
+            // Clean up our own clients
+            if (this.mesh.instanceId !== 0) {
+                await this.registry.cleanupNode();
+            }
+        }
+        finally {
+            await this.mesh.stop();
+        }
+    }
+    /**
+     * Register a client on this node. Returns true if registered, false if
+     * another node owns the client and `allowSupersede` is false (conflict).
+     */
+    async registerClient(clientId, metadata, allowSupersede = true) {
+        if (!this.running)
+            return true;
+        const result = await this.registry.register(clientId, metadata, allowSupersede);
+        if (result.status === 'conflict') {
+            return false;
+        }
+        if (result.supersededNodeId !== null) {
+            this.mesh.invoke(result.supersededNodeId, 'kickClient', { clientId }).catch(err => {
+                this.logger.warn('failed to kick superseded client', {
+                    err,
+                    clientId,
+                    supersededNodeId: result.supersededNodeId
+                });
+            });
+        }
+        return true;
+    }
+    /**
+     * Reserve ownership of a clientId without exposing it for lookup/invoke
+     * until activation completes.
+     */
+    async reserveClient(clientId, metadata, allowSupersede = true) {
+        if (!this.running)
+            return true;
+        const result = await this.registry.reserve(clientId, metadata, allowSupersede);
+        if (result.status === 'conflict') {
+            return false;
+        }
+        if (result.supersededNodeId !== null) {
+            this.mesh.invoke(result.supersededNodeId, 'kickClient', { clientId }).catch(err => {
+                this.logger.warn('failed to kick superseded client', {
+                    err,
+                    clientId,
+                    supersededNodeId: result.supersededNodeId
+                });
+            });
+        }
+        return true;
+    }
+    /**
+     * Promote a same-node reservation to an active, discoverable client.
+     */
+    async activateClient(clientId, metadata) {
+        if (!this.running)
+            return false;
+        return this.registry.activate(clientId, metadata);
+    }
+    async unregisterClient(clientId) {
+        if (!this.running)
+            return false;
+        return this.registry.unregister(clientId);
+    }
+    async updateClientMetadata(clientId, metadata) {
+        if (!this.running)
+            return false;
+        const client = await this.registry.getClient(clientId);
+        if (!client)
+            return false;
+        // Local - apply to stream.meta and update registry directly.
+        if (client.nodeId === this.mesh.instanceId) {
+            if (this.clientUpdateMetaFn && !this.clientUpdateMetaFn(clientId, metadata))
+                return false;
+            return this.registry.updateMetadata(clientId, metadata);
+        }
+        // Remote - route through mesh to the owning node
+        try {
+            const response = await this.mesh.invoke(client.nodeId, 'updateMeta', { clientId, metadata });
+            return response.updated;
+        }
+        catch (err) {
+            this.logger.warn('cross-pod metadata update failed', {
+                err,
+                clientId,
+                targetNodeId: client.nodeId
+            });
+            return false;
+        }
+    }
+    registerBroadcastHandler(type, handler) {
+        this.mesh.registerBroadcastHandler(type, handler);
+    }
+    async broadcast(type, data, options) {
+        return this.mesh.broadcast(type, data, options);
+    }
+    async invoke(clientId, type, data, timeoutMs) {
+        if (!this.running) {
+            throw new types_1.ClientNotFoundError(clientId);
+        }
+        const client = await this.registry.getClient(clientId);
+        if (!client) {
+            throw new types_1.ClientNotFoundError(clientId);
+        }
+        // Local delivery
+        if (client.nodeId === this.mesh.instanceId) {
+            return this.clientInvokeFn(clientId, type, data, timeoutMs);
+        }
+        // Remote delivery via mesh
+        const response = await this.mesh.invoke(client.nodeId, 'forward', { clientId, type, data, timeoutMs }, timeoutMs);
+        if (response.error !== undefined) {
+            if (response.errorName === 'ClientDisconnectedError') {
+                throw new types_1.ClientDisconnectedError(clientId);
+            }
+            throw new types_1.ClientInvocationError(response.error);
+        }
+        return response.data;
+    }
+    static __tsfType = _MeshClientServiceMetadata_1 = ({ kind: 16, name: "MeshClientService", typeName: "MeshClientService", classType: () => MeshClientService, properties: [{ name: "mesh", type: { kind: 16, typeName: "MeshService", classType: () => (typeof require !== "undefined" ? require("../mesh").MeshService : undefined), typeArguments: [{ kind: 18, types: [{ kind: 20, name: "forward", type: { kind: 18, types: [{ kind: 20, name: "request", type: { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }, { kind: 20, name: "type", type: { kind: 6 }, optional: false }, { kind: 20, name: "data", type: { kind: 2 }, optional: false }, { kind: 20, name: "timeoutMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }], typeName: "ForwardRequest" }, optional: false }, { kind: 20, name: "response", type: { kind: 18, types: [{ kind: 20, name: "data", type: { kind: 12, types: [{ kind: 2 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "error", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "errorName", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }], typeName: "ForwardResponse" }, optional: false }] }, optional: false }, { kind: 20, name: "kickClient", type: { kind: 18, types: [{ kind: 20, name: "request", type: { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }], typeName: "KickClientRequest" }, optional: false }, { kind: 20, name: "response", type: { kind: 18, types: [{ kind: 20, name: "kicked", type: { kind: 8 }, optional: false }], typeName: "KickClientResponse" }, optional: false }] }, optional: false }, { kind: 20, name: "updateMeta", type: { kind: 18, types: [{ kind: 20, name: "request", type: { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }, { kind: 20, name: "metadata", type: { kind: 2 }, optional: false }], typeName: "UpdateMetaRequest" }, optional: false }, { kind: 20, name: "response", type: { kind: 18, types: [{ kind: 20, name: "updated", type: { kind: 8 }, optional: false }], typeName: "UpdateMetaResponse" }, optional: false }] }, optional: false }], typeName: "ForwardMessages" }, { kind: 16, typeName: "TBroadcasts", classType: () => (typeof TBroadcasts !== "undefined" ? TBroadcasts : (typeof exports !== "undefined" ? exports.TBroadcasts : undefined)) }] }, optional: false }], methods: [{ name: "onNodeClientsOrphaned", parameters: [{ name: "cb", type: { kind: 2, typeName: "(nodeId: number, orphaned: RegisteredClient<TMeta>[]) => void | Promise<void>" }, optional: false, default: false }], returnType: { kind: 3 } }, { name: "onClientSuperseded", parameters: [{ name: "cb", type: { kind: 2, typeName: "(clientId: string) => void | Promise<void>" }, optional: false, default: false }], returnType: { kind: 3 } }, { name: "start", parameters: [], returnType: { kind: 22, type: { kind: 3 } } }, { name: "stop", parameters: [], returnType: { kind: 22, type: { kind: 3 } } }, { name: "registerClient", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "metadata", type: { kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }, optional: false, default: false }, { name: "allowSupersede", type: { kind: 2 }, optional: true, default: true }], returnType: { kind: 22, type: { kind: 8 } }, description: "Register a client on this node. Returns true if registered, false if another node owns the client and `allowSupersede` is false (conflict)." }, { name: "reserveClient", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "metadata", type: { kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }, optional: false, default: false }, { name: "allowSupersede", type: { kind: 2 }, optional: true, default: true }], returnType: { kind: 22, type: { kind: 8 } }, description: "Reserve ownership of a clientId without exposing it for lookup/invoke until activation completes." }, { name: "activateClient", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "metadata", type: { kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 8 } }, description: "Promote a same-node reservation to an active, discoverable client." }, { name: "unregisterClient", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 8 } } }, { name: "updateClientMetadata", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "metadata", type: { kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 8 } } }, { name: "registerBroadcastHandler", parameters: [{ name: "type", type: { kind: 2, typeName: "K" }, optional: false, default: false }, { name: "handler", type: { kind: 2, typeName: "(data: TBroadcasts[K], senderInstanceId: number) => void | Promise<void>" }, optional: false, default: false }], returnType: { kind: 3 } }, { name: "broadcast", parameters: [{ name: "type", type: { kind: 2, typeName: "K" }, optional: false, default: false }, { name: "data", type: { kind: 2, typeName: "TBroadcasts[K]" }, optional: false, default: false }, { name: "options", type: { kind: 18, typeName: "MeshBroadcastOptions", types: [{ kind: 20, name: "skipSelf", type: { kind: 12, types: [{ kind: 8 }, { kind: 4 }] }, optional: true }] }, optional: true, default: false }], returnType: { kind: 22, type: { kind: 3 } } }, { name: "invoke", parameters: [{ name: "clientId", type: { kind: 6 }, optional: false, default: false }, { name: "type", type: { kind: 6 }, optional: false, default: false }, { name: "data", type: { kind: 2 }, optional: false, default: false }, { name: "timeoutMs", type: { kind: 7 }, optional: true, default: false }], returnType: { kind: 22, type: { kind: 2 } } }], hasConstructor: true, constructorParameters: [{ name: "options", type: { kind: 16, typeName: "MeshClientServiceOptions", classType: () => (typeof MeshClientServiceOptions !== "undefined" ? MeshClientServiceOptions : (typeof exports !== "undefined" ? exports.MeshClientServiceOptions : undefined)), typeArguments: [{ kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }] }, optional: false, default: false }] });
+}
+exports.MeshClientService = MeshClientService;
+_MeshClientServiceMetadata_1.classType = MeshClientService;
+MeshClientService.__tsfType = _MeshClientServiceMetadata_1;
+exports.__tsfTypeAliases = ({ "ForwardMessages": { kind: 18, types: [{ kind: 20, name: "forward", type: { kind: 18, types: [{ kind: 20, name: "request", type: { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }, { kind: 20, name: "type", type: { kind: 6 }, optional: false }, { kind: 20, name: "data", type: { kind: 2 }, optional: false }, { kind: 20, name: "timeoutMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }], typeName: "ForwardRequest" }, optional: false }, { kind: 20, name: "response", type: { kind: 18, types: [{ kind: 20, name: "data", type: { kind: 12, types: [{ kind: 2 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "error", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "errorName", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }], typeName: "ForwardResponse" }, optional: false }] }, optional: false }, { kind: 20, name: "kickClient", type: { kind: 18, types: [{ kind: 20, name: "request", type: { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }], typeName: "KickClientRequest" }, optional: false }, { kind: 20, name: "response", type: { kind: 18, types: [{ kind: 20, name: "kicked", type: { kind: 8 }, optional: false }], typeName: "KickClientResponse" }, optional: false }] }, optional: false }, { kind: 20, name: "updateMeta", type: { kind: 18, types: [{ kind: 20, name: "request", type: { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }, { kind: 20, name: "metadata", type: { kind: 2 }, optional: false }], typeName: "UpdateMetaRequest" }, optional: false }, { kind: 20, name: "response", type: { kind: 18, types: [{ kind: 20, name: "updated", type: { kind: 8 }, optional: false }], typeName: "UpdateMetaResponse" }, optional: false }] }, optional: false }], typeName: "ForwardMessages" }, "ForwardRequest": { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }, { kind: 20, name: "type", type: { kind: 6 }, optional: false }, { kind: 20, name: "data", type: { kind: 2 }, optional: false }, { kind: 20, name: "timeoutMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }], typeName: "ForwardRequest" }, "ForwardResponse": { kind: 18, types: [{ kind: 20, name: "data", type: { kind: 12, types: [{ kind: 2 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "error", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "errorName", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }], typeName: "ForwardResponse" }, "KickClientRequest": { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }], typeName: "KickClientRequest" }, "KickClientResponse": { kind: 18, types: [{ kind: 20, name: "kicked", type: { kind: 8 }, optional: false }], typeName: "KickClientResponse" }, "MeshClientServiceOptions": { kind: 18, typeName: "MeshClientServiceOptions", types: [{ kind: 20, name: "key", type: { kind: 6 }, optional: false }, { kind: 20, name: "meshOptions", type: { kind: 12, types: [{ kind: 18, typeName: "MeshServiceOptions", types: [{ kind: 20, name: "heartbeatIntervalMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "nodeTtlMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "requestTimeoutMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "leaderOptions", type: { kind: 12, types: [{ kind: 18, typeName: "LeaderServiceOptions", types: [{ kind: 20, name: "ttlMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "renewalIntervalMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "retryDelayMs", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }] }, { kind: 4 }] }, optional: true }] }, { kind: 4 }] }, optional: true }, { kind: 20, name: "registryBackend", type: { kind: 12, types: [{ kind: 16, typeName: "MeshClientRegistryBackend", classType: () => (typeof require !== "undefined" ? require("./types").MeshClientRegistryBackend : undefined), typeArguments: [{ kind: 16, typeName: "TMeta", classType: () => (typeof TMeta !== "undefined" ? TMeta : (typeof exports !== "undefined" ? exports.TMeta : undefined)) }] }, { kind: 4 }] }, optional: true }, { kind: 20, name: "clientInvokeFn", type: { kind: 2, typeName: "(clientId: string, type: string, data: unknown, timeoutMs?: number) => Promise<unknown>" }, optional: false }, { kind: 20, name: "clientUpdateMetaFn", type: { kind: 12, types: [{ kind: 2, typeName: "(clientId: string, metadata: TMeta) => boolean" }, { kind: 4 }] }, optional: true }] }, "UpdateMetaRequest": { kind: 18, types: [{ kind: 20, name: "clientId", type: { kind: 6 }, optional: false }, { kind: 20, name: "metadata", type: { kind: 2 }, optional: false }], typeName: "UpdateMetaRequest" }, "UpdateMetaResponse": { kind: 18, types: [{ kind: 20, name: "updated", type: { kind: 8 }, optional: false }], typeName: "UpdateMetaResponse" } });
+//# sourceMappingURL=mesh-client-service.js.map

package/dist/src/services/mesh-client/mesh-client-service.js.map

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

package/dist/src/services/mesh-client/mesh-srpc-server.d.ts

@@ -0,0 +1,95 @@
+import type { BaseMessage, ISrpcServerOptions, SrpcDisconnectCause, SrpcMeta, SrpcStream } from '../../srpc/types';
+import type { MeshBroadcastMap, MeshBroadcastOptions, MeshServiceOptions } from '../mesh';
+import { SrpcServer } from '../../srpc/SrpcServer';
+import { MeshClientRegistry } from './mesh-client-registry';
+import { type MeshClientRegistryBackend, type RegisteredClient } from './types';
+export interface MeshSrpcServerOptions<TMeta, TRegistryMeta = TMeta> {
+    meshKey: string;
+    meshOptions?: MeshServiceOptions;
+    registryBackend?: MeshClientRegistryBackend<TRegistryMeta>;
+    extractMetadata?: (stream: SrpcStream<TMeta>) => TRegistryMeta;
+}
+export declare class MeshSrpcServer<TMeta extends SrpcMeta = SrpcMeta, TClientOutput extends BaseMessage = BaseMessage, TServerOutput extends BaseMessage = BaseMessage, TRegistryMeta = TMeta, TBroadcasts extends MeshBroadcastMap = {}> extends SrpcServer<TMeta, TClientOutput, TServerOutput> {
+    private meshClientService;
+    private meshLogger;
+    private extractMetadataFn?;
+    private connectedCallbacks;
+    private disconnectedCallbacks;
+    private orphanedCallbacks;
+    private clientMetadata;
+    private lifecycleConnectedStreams;
+    private clientRegistryChains;
+    private clientCallbackChains;
+    private pendingSyncs;
+    constructor(options: ISrpcServerOptions<TClientOutput, TServerOutput> & MeshSrpcServerOptions<TMeta, TRegistryMeta>);
+    /**
+     * Defers stream activation until mesh reservation succeeds.
+     * Installs meta proxy and reserves the client atomically in Redis
+     * (respecting allowSupersede for v2), all serialized in the per-client
+     * registry chain. Reserved clients remain hidden from lookup/invoke until
+     * onStreamActivated promotes them to active.
+     *
+     * If registration returns a conflict, cleanupStream is called
+     * (which fires onStreamDisconnected and drains the queue) so
+     * no connection handlers or RPCs ever run on the rejected stream.
+     */
+    protected postEstablishCheck(stream: SrpcStream<TMeta>): Promise<boolean>;
+    private extractMeta;
+    private static readonly PROXIED;
+    /**
+     * Install a Proxy on stream.meta that schedules a microtask-debounced
+     * sync to Redis whenever any property is mutated.
+     *
+     * This means handler code, connection handlers, and external code
+     * (e.g. FreeSwitch controller) can all mutate stream.meta directly
+     * and the mesh registry stays in sync - no manual sync calls needed.
+     *
+     * **Limitation:** Only top-level property mutations are tracked.
+     * Nested mutations (e.g. `stream.meta.user.name = 'Bob'`) do NOT
+     * trigger a sync. For nested metadata, either reassign the top-level
+     * property (`stream.meta.user = { ...stream.meta.user, name: 'Bob' }`)
+     * or call `updateClientMetadata()` explicitly.
+     */
+    private installMetaProxy;
+    /**
+     * Schedule a microtask-debounced sync for a client.
+     * Multiple synchronous mutations are batched into a single sync.
+     */
+    private scheduleSyncStreamMeta;
+    protected onStreamConnected(stream: SrpcStream<TMeta>): Promise<void>;
+    protected onStreamActivated(stream: SrpcStream<TMeta>): Promise<void>;
+    protected onStreamDisconnected(stream: SrpcStream<TMeta>, cause: SrpcDisconnectCause): void;
+    /**
+     * Sync the current stream.meta to the mesh registry.
+     * Called automatically by the meta proxy's microtask debounce.
+     * Routed through enqueueClientRegistry so updates are serialized
+     * after initial registration (prevents lost updates if registration
+     * hasn't completed yet).
+     */
+    private syncStreamMeta;
+    private enqueueClientRegistry;
+    private enqueueClientCallback;
+    get meshInstanceId(): number;
+    get clientRegistry(): MeshClientRegistry<TRegistryMeta>;
+    /**
+     * Update metadata for a client, regardless of which node owns it.
+     * Routes through the mesh to the owning node so that stream.meta
+     * reflects the change immediately and the proxy auto-syncs to Redis.
+     * For local streams, you can also mutate stream.meta directly.
+     */
+    updateClientMetadata(clientId: string, metadata: TRegistryMeta): Promise<boolean>;
+    onClientConnected(handler: (clientId: string, metadata: TRegistryMeta) => void | Promise<void>): void;
+    onClientDisconnected(handler: (clientId: string, metadata: TRegistryMeta) => void | Promise<void>): void;
+    onNodeClientsOrphaned(handler: (nodeId: number, clients: RegisteredClient<TRegistryMeta>[]) => void | Promise<void>): void;
+    registerBroadcastHandler<K extends keyof TBroadcasts & string>(type: K, handler: (data: TBroadcasts[K], senderInstanceId: number) => void | Promise<void>): void;
+    broadcast<K extends keyof TBroadcasts & string>(type: K, data: TBroadcasts[K], options?: MeshBroadcastOptions): Promise<void>;
+    /**
+     * Invoke a client method across any node in the mesh.
+     * Overloaded: when called with a stream, delegates to SrpcServer.invoke.
+     * When called with a clientId string, routes through the mesh.
+     */
+    invoke(streamOrClientId: SrpcStream<TMeta> | string, prefix: any, data: any, timeoutMs?: number): Promise<any>;
+    meshStart(): Promise<void>;
+    meshStop(): Promise<void>;
+}
+//# sourceMappingURL=mesh-srpc-server.d.ts.map

package/dist/src/services/mesh-client/mesh-srpc-server.d.ts.map

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