@modularizer/plat 0.7.0 → 0.9.0

package/dist/client-side-server/mqtt-webrtc.d.ts

@@ -1,13 +1,70 @@
 import { type IClientOptions } from 'mqtt';
 import type { OpenAPIClientTransportPlugin } from '../client/transport-plugin';
 import { type ClientSideServerChannel } from './channel';
-import { type ClientSideServerAuthorityServer, type ClientSideServerExportedKeyPair, type ClientSideServerSignedAuthorityRecord, type ClientSideServerStorageLike, type ClientSideServerTrustedServerRecord } from './identity';
-import { type ClientSideServerPeerMessage } from './protocol';
+import { type ClientSideServerAuthorityServer, type ClientSideServerExportedKeyPair, type ClientSideServerPublicIdentity, type ClientSideServerSignedAuthorityRecord, type ClientSideServerStorageLike, type ClientSideServerTrustedServerRecord } from './identity';
+import { type ClientSideServerInstanceInfo, type ClientSideServerPeerMessage } from './protocol';
 import { type ClientSideServerAddress } from './signaling';
 import type { PLATClientSideServer } from './server';
 export declare const DEFAULT_CLIENT_SIDE_SERVER_MQTT_BROKER = "wss://broker.emqx.io:8084/mqtt";
 export declare const DEFAULT_CLIENT_SIDE_SERVER_MQTT_TOPIC = "mrtchat/plat-css";
 export declare const DEFAULT_CLIENT_SIDE_SERVER_ICE_SERVERS: RTCIceServer[];
+export interface ClientSideServerWorkerInfo {
+    weight?: number;
+    suggestedWorkerCount?: number;
+    currentClients?: number;
+    acceptingNewClients?: boolean;
+    loadBalancing?: ClientSideServerLoadBalancingPreferences;
+}
+export interface ClientSideServerLoadBalancingPreferences {
+    strategy?: 'weighted-random' | 'round-robin' | 'least-connections' | 'none';
+    maxClientsPerInstance?: number;
+}
+export interface ClientSideServerWorkerPoolOptions {
+    maxActiveWorkers?: number;
+    maxStandbyWorkers?: number;
+    maxTotalConnections?: number;
+    rediscoveryThreshold?: number;
+    discoveryTimeoutMs?: number;
+    passiveDiscovery?: boolean;
+    rankCandidates?: (candidates: ClientSideServerDiscoveryCandidate[]) => ClientSideServerDiscoveryCandidate[];
+    assignWeights?: (workers: ClientSideServerWorkerState[]) => void;
+    routingStrategy?: 'weighted-random' | 'round-robin' | 'least-pending' | 'primary-with-fallback';
+    healthCheckIntervalMs?: number;
+    healthCheckTimeoutMs?: number;
+}
+export interface ClientSideServerDiscoveryCandidate {
+    instanceId: string;
+    serverName: string;
+    identity: ClientSideServerPublicIdentity;
+    authorityRecord?: ClientSideServerSignedAuthorityRecord;
+    mqttChallengeVerified: boolean;
+    workerInfo: ClientSideServerWorkerInfo;
+    instanceInfo?: ClientSideServerInstanceInfo;
+    discoveredAt: number;
+    alreadyConnected: boolean;
+}
+export interface ClientSideServerDiscoveryResult {
+    serverName: string;
+    candidates: ClientSideServerDiscoveryCandidate[];
+    discoveredAt: number;
+}
+export interface ClientSideServerWorkerState {
+    instanceId: string;
+    session: ClientSideServerPeerSession;
+    identity: ClientSideServerPublicIdentity;
+    authorityRecord?: ClientSideServerSignedAuthorityRecord;
+    status: 'connecting' | 'verifying' | 'active' | 'standby' | 'draining' | 'failed' | 'closed';
+    weight: number;
+    serverAdvertisedWeight: number;
+    authorityVerified: boolean;
+    pendingRequests: number;
+    totalRequests: number;
+    totalErrors: number;
+    connectedAt: number;
+    lastRequestAt?: number;
+    lastErrorAt?: number;
+    lastPongAt?: number;
+}
 export interface ClientSideServerMQTTWebRTCOptions {
     mqttBroker?: string;
     mqttTopic?: string;
@@ -17,10 +74,19 @@ export interface ClientSideServerMQTTWebRTCOptions {
     announceIntervalMs?: number;
     clientIdPrefix?: string;
     identity?: ClientSideServerIdentityOptions;
+    workerPool?: ClientSideServerWorkerPoolOptions;
+    requirePrivateChallenge?: boolean;
 }
 export interface ClientSideServerMQTTWebRTCServerOptions extends ClientSideServerMQTTWebRTCOptions {
     serverName: string;
     server: PLATClientSideServer;
+    workerInfo?: ClientSideServerWorkerInfo;
+    /**
+     * Override or supplement the instance info from the PLATClientSideServer.
+     * If not provided, instance info is read from the server's own options.
+     * `openapiHash` and `serverStartedAt` are always auto-computed.
+     */
+    instanceInfo?: ClientSideServerInstanceInfo;
 }
 export interface ClientSideServerIdentityOptions {
     keyPair?: ClientSideServerExportedKeyPair;
@@ -43,6 +109,7 @@ export interface ClientSideServerPeerSession extends ClientSideServerChannel {
     readonly connectionId: string;
     readonly peerId: string;
     readonly connectedAt: number;
+    readonly identity?: ClientSideServerPublicIdentity;
     isOpen(): boolean;
     sendPeer(event: string, data?: unknown): Promise<void>;
     subscribePeer(listener: (message: ClientSideServerPeerMessage) => void | Promise<void>): () => void;
@@ -55,23 +122,37 @@ export interface ClientSideServerPeerPool {
 export declare class ClientSideServerMQTTWebRTCServer {
     private options;
     private mqtt?;
-    private readonly serverInstanceId;
+    readonly serverInstanceId: string;
     private readonly unsubscribeByConnection;
     private readonly peers;
     private readonly pendingCandidates;
+    private readonly channels;
     private announceTimer?;
     private identityKeyPair?;
     private publicIdentity?;
+    private clientCount;
+    private resolvedInstanceInfo?;
     constructor(options: ClientSideServerMQTTWebRTCServerOptions);
     get connectionUrl(): string;
     start(): Promise<void>;
     stop(): Promise<void>;
     private announce;
     private onMessage;
+    private respondToDiscover;
+    private buildResolvedInstanceInfo;
+    private buildWorkerInfo;
+    private handleControlMessage;
+    drain(): Promise<void>;
     private acceptOffer;
     private ensureIdentity;
 }
 export declare function createClientSideServerMQTTWebRTCTransportPlugin(options?: ClientSideServerMQTTWebRTCOptions): OpenAPIClientTransportPlugin;
 export declare function createClientSideServerMQTTWebRTCPeerPool(options?: ClientSideServerMQTTWebRTCOptions): ClientSideServerPeerPool;
+export declare function discoverClientSideServers(serverName: string, options?: ClientSideServerMQTTWebRTCOptions): Promise<ClientSideServerDiscoveryResult>;
+export declare function connectFirstDiscovery(address: ClientSideServerAddress, options: ClientSideServerMQTTWebRTCOptions): Promise<{
+    primary: ClientSideServerPeerSession;
+    discovery: Promise<ClientSideServerDiscoveryResult>;
+}>;
+export declare function createClientSideServerMQTTWebRTCPeerSession(address: ClientSideServerAddress, options: ClientSideServerMQTTWebRTCOptions, targetInstanceId?: string): Promise<ClientSideServerPeerSession>;
 export declare function createClientSideServerMQTTWebRTCServer(options: ClientSideServerMQTTWebRTCServerOptions): ClientSideServerMQTTWebRTCServer;
 //# sourceMappingURL=mqtt-webrtc.d.ts.map

package/dist/client-side-server/mqtt-webrtc.d.ts.map

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

package/dist/client-side-server/mqtt-webrtc.js

@@ -22,9 +22,12 @@ export class ClientSideServerMQTTWebRTCServer {
     unsubscribeByConnection = new Map();
     peers = new Map();
     pendingCandidates = new Map();
+    channels = new Map();
     announceTimer;
     identityKeyPair;
     publicIdentity;
+    clientCount = 0;
+    resolvedInstanceInfo;
     constructor(options) {
         this.options = options;
         this.serverInstanceId = `${options.serverName}:${randomId('server')}`;
@@ -41,6 +44,8 @@ export class ClientSideServerMQTTWebRTCServer {
             void this.onMessage(payload);
         });
         await subscribe(this.mqtt, this.options.mqttTopic ?? DEFAULT_CLIENT_SIDE_SERVER_MQTT_TOPIC);
+        // Compute and cache instance info (includes openapi hash) before first announce
+        this.resolvedInstanceInfo = await this.buildResolvedInstanceInfo();
         await this.announce();
         const intervalMs = this.options.announceIntervalMs ?? 30_000;
         this.announceTimer = setInterval(() => {
@@ -75,6 +80,7 @@ export class ClientSideServerMQTTWebRTCServer {
             serverName: this.options.serverName,
             identity: this.publicIdentity,
             authorityRecord: this.options.identity?.authorityRecord,
+            instanceInfo: this.resolvedInstanceInfo,
             at: Date.now(),
         });
     }
@@ -84,7 +90,14 @@ export class ClientSideServerMQTTWebRTCServer {
             return;
         if (message.targetId && message.targetId !== this.options.serverName && message.targetId !== this.serverInstanceId)
             return;
-        if (message.kind === 'offer' && message.targetId === this.options.serverName && message.connectionId && message.description) {
+        if (message.kind === 'discover' && message.targetId === this.options.serverName && message.challengeNonce) {
+            await this.respondToDiscover(message);
+            return;
+        }
+        if (message.kind === 'offer'
+            && (message.targetId === this.options.serverName || message.targetId === this.serverInstanceId)
+            && message.connectionId
+            && message.description) {
             await this.acceptOffer(message);
             return;
         }
@@ -103,6 +116,100 @@ export class ClientSideServerMQTTWebRTCServer {
             }
         }
     }
+    async respondToDiscover(message) {
+        if (!this.mqtt || !message.challengeNonce)
+            return;
+        await this.ensureIdentity();
+        const challengeString = buildClientSideServerIdentityChallenge({
+            serverName: this.options.serverName,
+            connectionId: this.serverInstanceId,
+            challengeNonce: message.challengeNonce,
+        });
+        const challengeSignature = await signClientSideServerChallenge(this.identityKeyPair, challengeString);
+        await publish(this.mqtt, this.options.mqttTopic ?? DEFAULT_CLIENT_SIDE_SERVER_MQTT_TOPIC, {
+            protocol: 'plat-css-v1',
+            kind: 'announce',
+            senderId: this.serverInstanceId,
+            serverName: this.options.serverName,
+            identity: this.publicIdentity,
+            authorityRecord: this.options.identity?.authorityRecord,
+            challengeNonce: message.challengeNonce,
+            challengeSignature,
+            workerInfo: this.buildWorkerInfo(),
+            instanceInfo: this.resolvedInstanceInfo,
+            at: Date.now(),
+        });
+    }
+    async buildResolvedInstanceInfo() {
+        // Merge: options.instanceInfo (user override) > server.getServerInfo() (auto-computed)
+        const serverInfo = await this.options.server.getServerInfo();
+        return {
+            ...serverInfo,
+            ...(this.options.instanceInfo ?? {}),
+            // Always override openapiHash and serverStartedAt with freshly computed values
+            openapiHash: this.options.instanceInfo?.openapiHash ?? serverInfo.openapiHash,
+            serverStartedAt: Date.now(),
+        };
+    }
+    buildWorkerInfo() {
+        const base = this.options.workerInfo;
+        return {
+            weight: base?.weight,
+            suggestedWorkerCount: base?.suggestedWorkerCount,
+            currentClients: this.clientCount,
+            acceptingNewClients: base?.acceptingNewClients,
+            loadBalancing: base?.loadBalancing,
+        };
+    }
+    async handleControlMessage(msg, channel, connectionId) {
+        if (!('platcss' in msg))
+            return;
+        const control = msg;
+        if (control.platcss === 'ping') {
+            await channel.send({ platcss: 'pong', ts: control.ts });
+            return;
+        }
+        if (control.platcss === 'private-challenge') {
+            const req = control;
+            if (req.challengeNonce.includes('-mqtt')) {
+                return;
+            }
+            await this.ensureIdentity();
+            const challengeString = buildClientSideServerIdentityChallenge({
+                serverName: this.options.serverName,
+                connectionId,
+                challengeNonce: req.challengeNonce,
+            });
+            const sig = await signClientSideServerChallenge(this.identityKeyPair, challengeString);
+            await channel.send({
+                platcss: 'private-challenge-response',
+                challengeNonce: req.challengeNonce,
+                challengeSignature: sig,
+                identity: this.publicIdentity,
+                authorityRecord: this.options.identity?.authorityRecord,
+            });
+        }
+    }
+    async drain() {
+        if (this.options.workerInfo) {
+            this.options.workerInfo.acceptingNewClients = false;
+        }
+        if (this.mqtt) {
+            await publish(this.mqtt, this.options.mqttTopic ?? DEFAULT_CLIENT_SIDE_SERVER_MQTT_TOPIC, {
+                protocol: 'plat-css-v1',
+                kind: 'announce',
+                senderId: this.serverInstanceId,
+                serverName: this.options.serverName,
+                identity: this.publicIdentity,
+                workerInfo: { ...this.buildWorkerInfo(), acceptingNewClients: false },
+                instanceInfo: this.resolvedInstanceInfo,
+                at: Date.now(),
+            });
+        }
+        for (const channel of this.channels.values()) {
+            await channel.send({ platcss: 'drain' });
+        }
+    }
     async acceptOffer(message) {
         if (!this.mqtt || !message.connectionId || !message.description)
             return;
@@ -133,12 +240,23 @@ export class ClientSideServerMQTTWebRTCServer {
             }
         };
         peer.ondatachannel = (event) => {
-            const unsubscribe = this.options.server.serveChannel(createRTCDataChannelAdapter(event.channel));
-            this.unsubscribeByConnection.set(message.connectionId, unsubscribe);
-            event.channel.addEventListener('close', () => {
-                unsubscribe();
-                this.unsubscribeByConnection.delete(message.connectionId);
-            }, { once: true });
+            const channel = createRTCDataChannelAdapter(event.channel);
+            const connId = message.connectionId;
+            const controlUnsubscribe = channel.subscribe(async (msg) => {
+                await this.handleControlMessage(msg, channel, connId);
+            });
+            const serveUnsubscribe = this.options.server.serveChannel(channel);
+            this.channels.set(connId, channel);
+            this.clientCount++;
+            const cleanup = () => {
+                controlUnsubscribe();
+                serveUnsubscribe();
+                this.channels.delete(connId);
+                this.clientCount--;
+                this.unsubscribeByConnection.delete(connId);
+            };
+            this.unsubscribeByConnection.set(connId, cleanup);
+            event.channel.addEventListener('close', cleanup, { once: true });
         };
         await peer.setRemoteDescription(new RTCSessionDescription(message.description));
         for (const candidate of this.pendingCandidates.get(message.connectionId) ?? []) {
@@ -188,6 +306,26 @@ export function createClientSideServerMQTTWebRTCTransportPlugin(options = {}) {
     return createClientSideServerMQTTWebRTCTransportPluginInternal(options);
 }
 function createClientSideServerMQTTWebRTCTransportPluginInternal(options) {
+    const useMultiWorker = options.workerPool
+        && ((options.workerPool.maxActiveWorkers ?? 1) > 1 || (options.workerPool.maxStandbyWorkers ?? 0) > 0);
+    if (useMultiWorker) {
+        let multiPoolPromise;
+        const getPool = () => {
+            multiPoolPromise ??= import('./worker-pool').then((mod) => mod.createClientSideServerMultiWorkerPool(options));
+            return multiPoolPromise;
+        };
+        return createClientSideServerTransportPlugin({
+            connect: async ({ address }) => {
+                const pool = await getPool();
+                const session = await pool.connect(address);
+                return {
+                    send: (message) => session.send(message),
+                    subscribe: (listener) => session.subscribe(listener),
+                    close: () => undefined,
+                };
+            },
+        });
+    }
     const pool = createClientSideServerMQTTWebRTCPeerPool(options);
     return createClientSideServerTransportPlugin({
         connect: async ({ address }) => {
@@ -250,7 +388,118 @@ function createClientSideServerMQTTWebRTCPeerPoolInternal(options) {
         },
     };
 }
-async function createClientSideServerMQTTWebRTCPeerSession(address, options) {
+export async function discoverClientSideServers(serverName, options = {}) {
+    const mqttClient = await connectToBroker(options);
+    const topic = options.mqttTopic ?? DEFAULT_CLIENT_SIDE_SERVER_MQTT_TOPIC;
+    const peerId = `${options.clientIdPrefix ?? 'client'}:${randomId('discover')}`;
+    const challengeNonce = randomId('challenge') + '-mqtt';
+    const timeoutMs = options.workerPool?.discoveryTimeoutMs ?? 3000;
+    const candidates = [];
+    await subscribe(mqttClient, topic);
+    const onMessage = async (_topic, payload) => {
+        const message = parseSignalingMessage(payload);
+        if (!message || message.senderId === peerId)
+            return;
+        if (message.kind !== 'announce')
+            return;
+        if (message.serverName !== serverName)
+            return;
+        if (message.challengeNonce && message.challengeNonce !== challengeNonce)
+            return;
+        let mqttChallengeVerified = false;
+        if (message.challengeNonce === challengeNonce && message.challengeSignature && message.identity) {
+            const challengeString = buildClientSideServerIdentityChallenge({
+                serverName,
+                connectionId: message.senderId,
+                challengeNonce,
+            });
+            mqttChallengeVerified = await verifyClientSideServerChallenge(message.identity.publicKeyJwk, challengeString, message.challengeSignature);
+        }
+        if (message.authorityRecord && options.identity?.authority?.publicKeyJwk) {
+            const authorityOk = await verifySignedClientSideServerAuthorityRecord(message.authorityRecord, options.identity.authority.publicKeyJwk);
+            if (!authorityOk)
+                return;
+        }
+        const existing = candidates.find((c) => c.instanceId === message.senderId);
+        if (existing)
+            return;
+        candidates.push({
+            instanceId: message.senderId,
+            serverName,
+            identity: message.identity,
+            authorityRecord: message.authorityRecord,
+            mqttChallengeVerified,
+            workerInfo: {
+                weight: message.workerInfo?.weight ?? 3,
+                suggestedWorkerCount: message.workerInfo?.suggestedWorkerCount,
+                currentClients: message.workerInfo?.currentClients ?? 0,
+                acceptingNewClients: message.workerInfo?.acceptingNewClients ?? true,
+                loadBalancing: message.workerInfo?.loadBalancing,
+            },
+            instanceInfo: message.instanceInfo,
+            discoveredAt: Date.now(),
+            alreadyConnected: false,
+        });
+    };
+    mqttClient.on('message', onMessage);
+    await publish(mqttClient, topic, {
+        protocol: 'plat-css-v1',
+        kind: 'discover',
+        senderId: peerId,
+        targetId: serverName,
+        challengeNonce,
+        at: Date.now(),
+    });
+    await new Promise((resolve) => setTimeout(resolve, timeoutMs));
+    mqttClient.off('message', onMessage);
+    await endClient(mqttClient);
+    return {
+        serverName,
+        candidates: defaultRankCandidates(candidates, options),
+        discoveredAt: Date.now(),
+    };
+}
+function defaultRankCandidates(candidates, options) {
+    if (options.workerPool?.rankCandidates) {
+        return options.workerPool.rankCandidates(candidates);
+    }
+    const accepting = candidates.filter((c) => c.workerInfo.acceptingNewClients !== false);
+    const pool = accepting.length > 0 ? accepting : candidates;
+    return pool.sort((a, b) => {
+        const aAuth = a.authorityRecord ? 1 : 0;
+        const bAuth = b.authorityRecord ? 1 : 0;
+        if (bAuth !== aAuth)
+            return bAuth - aAuth;
+        const aMqtt = a.mqttChallengeVerified ? 1 : 0;
+        const bMqtt = b.mqttChallengeVerified ? 1 : 0;
+        if (bMqtt !== aMqtt)
+            return bMqtt - aMqtt;
+        const aWeight = a.workerInfo.weight ?? 3;
+        const bWeight = b.workerInfo.weight ?? 3;
+        if (bWeight !== aWeight)
+            return bWeight - aWeight;
+        const aClients = a.workerInfo.currentClients ?? 0;
+        const bClients = b.workerInfo.currentClients ?? 0;
+        return aClients - bClients;
+    });
+}
+export async function connectFirstDiscovery(address, options) {
+    const primaryPromise = createClientSideServerMQTTWebRTCPeerSession(address, options);
+    const discovery = discoverClientSideServers(address.serverName, options).then((result) => {
+        return primaryPromise.then((primary) => {
+            for (const candidate of result.candidates) {
+                if (candidate.identity && primary.identity
+                    && clientSideServerPublicKeysEqual(candidate.identity.publicKeyJwk, primary.identity.publicKeyJwk)) {
+                    candidate.alreadyConnected = true;
+                }
+            }
+            return result;
+        }).catch(() => result);
+    });
+    const primary = await primaryPromise;
+    return { primary, discovery };
+}
+export async function createClientSideServerMQTTWebRTCPeerSession(address, options, targetInstanceId) {
     const webrtc = await resolveClientWebRTCImplementation();
     const mqtt = await connectToBroker(options);
     const topic = options.mqttTopic ?? DEFAULT_CLIENT_SIDE_SERVER_MQTT_TOPIC;
@@ -267,6 +516,8 @@ async function createClientSideServerMQTTWebRTCPeerSession(address, options) {
     const pendingCandidates = [];
     const expectedIdentity = await resolveExpectedServerIdentity(address.serverName, options.identity);
     let open = true;
+    let answerApplied = false;
+    let serverIdentity;
     await subscribe(mqtt, topic);
     const onMessage = async (_topic, payload) => {
         const message = parseSignalingMessage(payload);
@@ -274,6 +525,9 @@ async function createClientSideServerMQTTWebRTCPeerSession(address, options) {
             return;
         }
         if (message.kind === 'answer' && message.description) {
+            if (answerApplied)
+                return;
+            answerApplied = true;
             await verifyServerIdentityForAnswer({
                 serverName: address.serverName,
                 connectionId,
@@ -282,6 +536,7 @@ async function createClientSideServerMQTTWebRTCPeerSession(address, options) {
                 optionsIdentity: options.identity,
                 expectedIdentity,
             });
+            serverIdentity = message.identity;
             await peer.setRemoteDescription(webrtc.createSessionDescription(message.description));
             if (!expectedIdentity && message.authorityRecord && options.identity?.authority?.publicKeyJwk) {
                 const trusted = await trustClientSideServerFromAuthorityRecord(message.authorityRecord, options.identity.authority.publicKeyJwk, {
@@ -317,6 +572,7 @@ async function createClientSideServerMQTTWebRTCPeerSession(address, options) {
     };
     mqtt.on('message', onMessage);
     cleanupCallbacks.push(() => mqtt.off('message', onMessage));
+    const offerTarget = targetInstanceId ?? address.serverName;
     peer.onicecandidate = (event) => {
         if (!event.candidate)
             return;
@@ -324,7 +580,7 @@ async function createClientSideServerMQTTWebRTCPeerSession(address, options) {
             protocol: 'plat-css-v1',
             kind: 'ice',
             senderId: peerId,
-            targetId: address.serverName,
+            targetId: offerTarget,
             connectionId,
             candidate: webrtc.serializeIceCandidate(event.candidate),
             at: Date.now(),
@@ -350,7 +606,7 @@ async function createClientSideServerMQTTWebRTCPeerSession(address, options) {
         protocol: 'plat-css-v1',
         kind: 'offer',
         senderId: peerId,
-        targetId: address.serverName,
+        targetId: offerTarget,
         serverName: address.serverName,
         connectionId,
         description: offer,
@@ -370,6 +626,7 @@ async function createClientSideServerMQTTWebRTCPeerSession(address, options) {
         connectionId,
         peerId,
         connectedAt: Date.now(),
+        identity: serverIdentity,
         isOpen: () => open && dataChannel.readyState === 'open',
         async sendPeer(event, data) {
             await channel.send({