@modularizer/plat-client 0.4.0

package/dist/client-side-server/protocol.js

@@ -0,0 +1,13 @@
+export function isClientSideServerPeerMessage(message) {
+    return 'platcss' in message && message.platcss === 'peer';
+}
+export function isClientSideServerRequestMessage(message) {
+    return 'jsonrpc' in message && 'method' in message && 'path' in message;
+}
+export function isClientSideServerEventMessage(message) {
+    return 'jsonrpc' in message && 'event' in message && message.ok === true;
+}
+export function isClientSideServerResponseMessage(message) {
+    return 'jsonrpc' in message && 'ok' in message && !('event' in message) && !('method' in message);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/client-side-server/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../typescript/src/client-side-server/protocol.ts"],"names":[],"mappings":"AA4DA,MAAM,UAAU,6BAA6B,CAAC,OAAgC;IAC5E,OAAO,SAAS,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,OAAgC;IAC/E,OAAO,SAAS,IAAI,OAAO,IAAI,QAAQ,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAgC;IAC7E,OAAO,SAAS,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,CAAA;AAC1E,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAAgC;IAEhC,OAAO,SAAS,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAA;AACnG,CAAC"}

package/dist/client-side-server/runtime.d.ts

@@ -0,0 +1,57 @@
+import { OpenAPIClient } from '../client/openapi-client';
+import type { OpenAPISpec } from '../types/openapi';
+import { type ClientSideServerMQTTWebRTCOptions, type ClientSideServerMQTTWebRTCServer } from './mqtt-webrtc';
+import { type PLATClientSideServer } from './server';
+import type { ClientSideServerSourceAnalysis } from './source-analysis';
+type ControllerClass = new () => any;
+export interface ClientSideServerDefinition {
+    serverName: string;
+    controllers: ControllerClass[];
+}
+export interface ClientSideServerSourceModule {
+    controllers?: ControllerClass[];
+    clientSideServer?: ClientSideServerDefinition;
+    default?: ControllerClass[] | ClientSideServerDefinition | {
+        controllers?: ControllerClass[];
+    };
+}
+export interface StartClientSideServerFromSourceOptions extends ClientSideServerMQTTWebRTCOptions {
+    serverName?: string;
+    undecoratedMode?: 'GET' | 'POST' | 'private';
+    source: string;
+    transpile?: (source: string) => string | Promise<string>;
+    analyzeSource?: (source: string) => ClientSideServerSourceAnalysis | Promise<ClientSideServerSourceAnalysis>;
+    onRequest?: (direction: 'request' | 'response', payload: unknown) => void;
+}
+export interface StartedClientSideServer {
+    server: PLATClientSideServer;
+    signaler: ClientSideServerMQTTWebRTCServer;
+    connectionUrl: string;
+    openapi: Record<string, any>;
+    stop(): Promise<void>;
+}
+export declare function startClientSideServerFromSource(options: StartClientSideServerFromSourceOptions): Promise<StartedClientSideServer>;
+export declare function serveClientSideServer(serverName: string, controllers: ControllerClass[]): ClientSideServerDefinition;
+export interface ConnectClientSideServerOptions extends ClientSideServerMQTTWebRTCOptions {
+    baseUrl: string;
+}
+export declare function connectClientSideServer(options: ConnectClientSideServerOptions): Promise<{
+    client: OpenAPIClient;
+    openapi: OpenAPISpec;
+}>;
+export interface RetryLoopOptions {
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    runImmediately?: boolean;
+    resetDelayOnSuccess?: boolean;
+    onError?: (error: unknown, nextDelayMs: number) => void;
+    onSuccess?: () => void;
+}
+export interface RetryLoopHandle {
+    stop(): void;
+    triggerNow(): void;
+}
+export declare function startRetryLoop(task: () => Promise<void> | void, options?: RetryLoopOptions): RetryLoopHandle;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/client-side-server/runtime.d.ts.map

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

package/dist/client-side-server/runtime.js

@@ -0,0 +1,188 @@
+import { OpenAPIClient } from '../client/openapi-client.js';
+import { ensureRouteMeta } from '../spec/metadata.js';
+import { createClientSideServerMQTTWebRTCServer, createClientSideServerMQTTWebRTCTransportPlugin, } from './mqtt-webrtc.js';
+import { createClientSideServer } from './server.js';
+import { fetchClientSideServerOpenAPI } from './bootstrap.js';
+export async function startClientSideServerFromSource(options) {
+    const compiled = options.transpile
+        ? await options.transpile(options.source)
+        : options.source;
+    const moduleUrl = URL.createObjectURL(new Blob([compiled], { type: 'text/javascript' }));
+    let loaded;
+    try {
+        loaded = await import(/* @vite-ignore */ moduleUrl);
+    }
+    finally {
+        URL.revokeObjectURL(moduleUrl);
+    }
+    const definition = resolveClientSideServerDefinition(loaded, options.serverName);
+    const analysis = options.analyzeSource ? await options.analyzeSource(options.source) : undefined;
+    if (analysis) {
+        applySourceAnalysisToControllers(definition.controllers, analysis);
+    }
+    const server = createClientSideServer({
+        undecoratedMode: options.undecoratedMode,
+    }, ...definition.controllers);
+    if (options.onRequest) {
+        const originalHandle = server.handleMessage.bind(server);
+        server.handleMessage = async (message, channel) => {
+            options.onRequest?.('request', message);
+            await originalHandle(message, {
+                ...channel,
+                send: async (payload) => {
+                    options.onRequest?.('response', payload);
+                    await channel.send(payload);
+                },
+            });
+        };
+    }
+    const signaler = createClientSideServerMQTTWebRTCServer({
+        server,
+        serverName: definition.serverName,
+        mqttBroker: options.mqttBroker,
+        mqttTopic: options.mqttTopic,
+        mqttOptions: options.mqttOptions,
+        iceServers: options.iceServers,
+        connectionTimeoutMs: options.connectionTimeoutMs,
+        announceIntervalMs: options.announceIntervalMs,
+        clientIdPrefix: options.clientIdPrefix,
+    });
+    await signaler.start();
+    return {
+        server,
+        signaler,
+        connectionUrl: signaler.connectionUrl,
+        openapi: server.openapi,
+        stop: async () => {
+            await signaler.stop();
+        },
+    };
+}
+export function serveClientSideServer(serverName, controllers) {
+    return { serverName, controllers };
+}
+export async function connectClientSideServer(options) {
+    const transportPlugin = createClientSideServerMQTTWebRTCTransportPlugin(options);
+    const openapi = await fetchClientSideServerOpenAPI(options.baseUrl, transportPlugin);
+    const client = new OpenAPIClient(openapi, {
+        baseUrl: options.baseUrl,
+        transportPlugins: [transportPlugin],
+    });
+    return { client, openapi };
+}
+export function startRetryLoop(task, options = {}) {
+    const initialDelayMs = options.initialDelayMs ?? 2_000;
+    const maxDelayMs = options.maxDelayMs ?? 30_000;
+    const backoffMultiplier = options.backoffMultiplier ?? 1.8;
+    const resetDelayOnSuccess = options.resetDelayOnSuccess ?? true;
+    let nextDelayMs = initialDelayMs;
+    let timer = null;
+    let stopped = false;
+    let running = false;
+    const clear = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    const schedule = (delayMs) => {
+        if (stopped)
+            return;
+        clear();
+        timer = setTimeout(() => {
+            void run();
+        }, delayMs);
+    };
+    const run = async () => {
+        if (stopped || running)
+            return;
+        running = true;
+        try {
+            await task();
+            options.onSuccess?.();
+            if (resetDelayOnSuccess) {
+                nextDelayMs = initialDelayMs;
+            }
+            schedule(initialDelayMs);
+        }
+        catch (error) {
+            options.onError?.(error, nextDelayMs);
+            schedule(nextDelayMs);
+            nextDelayMs = Math.min(maxDelayMs, Math.ceil(nextDelayMs * backoffMultiplier));
+        }
+        finally {
+            running = false;
+        }
+    };
+    if (options.runImmediately ?? true) {
+        void run();
+    }
+    else {
+        schedule(initialDelayMs);
+    }
+    return {
+        stop() {
+            stopped = true;
+            clear();
+        },
+        triggerNow() {
+            if (stopped)
+                return;
+            clear();
+            void run();
+        },
+    };
+}
+function resolveClientSideServerDefinition(module, fallbackServerName) {
+    if (module.clientSideServer)
+        return module.clientSideServer;
+    if (module.default && isClientSideServerDefinition(module.default)) {
+        return module.default;
+    }
+    const controllers = resolveControllers(module);
+    if (fallbackServerName) {
+        return { serverName: fallbackServerName, controllers };
+    }
+    throw new Error('Expected the source module to define a server name with serveClientSideServer(name, controllers)');
+}
+function resolveControllers(module) {
+    if (Array.isArray(module.controllers))
+        return module.controllers;
+    if (Array.isArray(module.default))
+        return module.default;
+    if (module.default && 'controllers' in module.default && Array.isArray(module.default.controllers)) {
+        return module.default.controllers;
+    }
+    throw new Error('Expected the source module to export controllers or a serveClientSideServer(...) definition');
+}
+function isClientSideServerDefinition(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && typeof value.serverName === 'string'
+        && Array.isArray(value.controllers));
+}
+function applySourceAnalysisToControllers(controllers, analysis) {
+    const analysisByController = new Map(analysis.controllers.map((controller) => [controller.name, controller]));
+    for (const controller of controllers) {
+        const controllerAnalysis = analysisByController.get(controller.name);
+        if (!controllerAnalysis)
+            continue;
+        const methods = new Map(controllerAnalysis.methods.map((method) => [method.name, method]));
+        for (const [methodName, methodAnalysis] of methods.entries()) {
+            const routeMeta = ensureRouteMeta(controller, methodName);
+            if (methodAnalysis.summary) {
+                routeMeta.summary = methodAnalysis.summary;
+            }
+            if (methodAnalysis.description) {
+                routeMeta.description = methodAnalysis.description;
+            }
+            if (methodAnalysis.inputSchema) {
+                routeMeta.inputSchema = methodAnalysis.inputSchema;
+            }
+            if (methodAnalysis.outputSchema) {
+                routeMeta.outputSchema = methodAnalysis.outputSchema;
+            }
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/client-side-server/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../typescript/src/client-side-server/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EACL,sCAAsC,EACtC,+CAA+C,GAGhD,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,sBAAsB,EAA6B,MAAM,UAAU,CAAA;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAiC1D,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAA+C;IAE/C,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS;QAChC,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;QACzC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IAElB,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAA;IACxF,IAAI,MAAoC,CAAA;IAExC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAiC,CAAA;IACrF,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,UAAU,GAAG,iCAAiC,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAChG,IAAI,QAAQ,EAAE,CAAC;QACb,gCAAgC,CAAC,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACpE,CAAC;IACD,MAAM,MAAM,GAAG,sBAAsB,CAAC;QACpC,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAA;IAE7B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACxD,MAAM,CAAC,aAAa,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YAChD,OAAO,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YACvC,MAAM,cAAc,CAAC,OAAO,EAAE;gBAC5B,GAAG,OAAO;gBACV,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACtB,OAAO,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;oBACxC,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBAC7B,CAAC;aACF,CAAC,CAAA;QACJ,CAAC,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,sCAAsC,CAAC;QACtD,MAAM;QACN,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAA;IAEF,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;IAEtB,OAAO;QACL,MAAM;QACN,QAAQ;QACR,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QACvB,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,WAA8B;IAE9B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAA;AACpC,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuC;IAKvC,MAAM,eAAe,GAAG,+CAA+C,CAAC,OAAO,CAAC,CAAA;IAChF,MAAM,OAAO,GAAG,MAAM,4BAA4B,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAgB,CAAA;IACnG,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,gBAAgB,EAAE,CAAC,eAAe,CAAC;KACpC,CAAC,CAAA;IACF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAC5B,CAAC;AAiBD,MAAM,UAAU,cAAc,CAC5B,IAAgC,EAChC,UAA4B,EAAE;IAE9B,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAA;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAA;IAC/C,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,GAAG,CAAA;IAC1D,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,IAAI,CAAA;IAC/D,IAAI,WAAW,GAAG,cAAc,CAAA;IAChC,IAAI,KAAK,GAAyC,IAAI,CAAA;IACtD,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,KAAK,GAAG,IAAI,CAAA;QACd,CAAC;IACH,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,EAAE;QACnC,IAAI,OAAO;YAAE,OAAM;QACnB,KAAK,EAAE,CAAA;QACP,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,EAAE,CAAA;QACZ,CAAC,EAAE,OAAO,CAAC,CAAA;IACb,CAAC,CAAA;IAED,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;QACrB,IAAI,OAAO,IAAI,OAAO;YAAE,OAAM;QAC9B,OAAO,GAAG,IAAI,CAAA;QACd,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAA;YACZ,OAAO,CAAC,SAAS,EAAE,EAAE,CAAA;YACrB,IAAI,mBAAmB,EAAE,CAAC;gBACxB,WAAW,GAAG,cAAc,CAAA;YAC9B,CAAC;YACD,QAAQ,CAAC,cAAc,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;YACrC,QAAQ,CAAC,WAAW,CAAC,CAAA;YACrB,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,iBAAiB,CAAC,CAAC,CAAA;QAChF,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,KAAK,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;IAED,IAAI,OAAO,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;QACnC,KAAK,GAAG,EAAE,CAAA;IACZ,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,cAAc,CAAC,CAAA;IAC1B,CAAC;IAED,OAAO;QACL,IAAI;YACF,OAAO,GAAG,IAAI,CAAA;YACd,KAAK,EAAE,CAAA;QACT,CAAC;QACD,UAAU;YACR,IAAI,OAAO;gBAAE,OAAM;YACnB,KAAK,EAAE,CAAA;YACP,KAAK,GAAG,EAAE,CAAA;QACZ,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,iCAAiC,CACxC,MAAoC,EACpC,kBAA2B;IAE3B,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,MAAM,CAAC,gBAAgB,CAAA;IAE3D,IAAI,MAAM,CAAC,OAAO,IAAI,4BAA4B,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACnE,OAAO,MAAM,CAAC,OAAO,CAAA;IACvB,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAC9C,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,CAAA;IACxD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAA;AACrH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAoC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAC,WAAW,CAAA;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAA;IACxD,IAAI,MAAM,CAAC,OAAO,IAAI,aAAa,IAAI,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACnG,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAA;IACnC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6FAA6F,CAAC,CAAA;AAChH,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAc;IAClD,OAAO,OAAO,CACZ,KAAK;WACF,OAAO,KAAK,KAAK,QAAQ;WACzB,OAAQ,KAAoC,CAAC,UAAU,KAAK,QAAQ;WACpE,KAAK,CAAC,OAAO,CAAE,KAAoC,CAAC,WAAW,CAAC,CACpE,CAAA;AACH,CAAC;AAED,SAAS,gCAAgC,CACvC,WAA8B,EAC9B,QAAwC;IAExC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAClC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAU,CAAC,CACjF,CAAA;IAED,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QACpE,IAAI,CAAC,kBAAkB;YAAE,SAAQ;QAEjC,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAU,CAAC,CAC3E,CAAA;QAED,KAAK,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7D,MAAM,SAAS,GAAG,eAAe,CAAC,UAAsB,EAAE,UAAU,CAAC,CAAA;YACrE,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC3B,SAAS,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAA;YAC5C,CAAC;YACD,IAAI,cAAc,CAAC,WAAW,EAAE,CAAC;gBAC/B,SAAS,CAAC,WAAW,GAAG,cAAc,CAAC,WAAW,CAAA;YACpD,CAAC;YACD,IAAI,cAAc,CAAC,WAAW,EAAE,CAAC;gBAC/B,SAAS,CAAC,WAAW,GAAG,cAAc,CAAC,WAAkB,CAAA;YAC3D,CAAC;YACD,IAAI,cAAc,CAAC,YAAY,EAAE,CAAC;gBAChC,SAAS,CAAC,YAAY,GAAG,cAAc,CAAC,YAAmB,CAAA;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,75 @@
+import { type AuthMode, type CacheController, type RateLimitConfigs, type RateLimitController, type RouteContext, type TokenLimitConfigs, type TokenLimitController, type ToolDefinition } from '../types';
+import type { OpenAPIInfo } from '../types/openapi';
+import type { PLATServerResolvedOperation } from '../server/transports';
+import { type Logger } from '../logging';
+import type { PLATAuthorityServerOptions } from '../server/authority-server';
+import type { ClientSideServerChannel } from './channel';
+import type { ClientSideServerMessage, ClientSideServerRequest } from './protocol';
+export interface ClientSideServerOptions {
+    undecoratedMode?: 'GET' | 'POST' | 'private';
+    errorExposure?: 'none' | 'message' | 'full';
+    allowedMethodPrefixes?: '*' | string[];
+    disAllowedMethodPrefixes?: string[];
+    paramCoercions?: Record<string, string>;
+    disAllowedParams?: string[];
+    serializers?: Record<string, (value: any) => unknown>;
+    openapiInfo?: OpenAPIInfo;
+    auth?: {
+        verify(mode: AuthMode, req: any, ctx: RouteContext): Promise<any> | any;
+    };
+    defaultAuth?: AuthMode;
+    rateLimit?: {
+        controller?: RateLimitController;
+        configs?: RateLimitConfigs;
+    };
+    tokenLimit?: {
+        controller?: TokenLimitController;
+        configs?: TokenLimitConfigs;
+    };
+    cache?: {
+        controller?: CacheController;
+    };
+    authorityServer?: false | PLATAuthorityServerOptions;
+    logger?: Logger;
+    onRequest?: (request: ClientSideServerRequest, ctx: RouteContext) => void | Promise<void>;
+    onResponse?: (request: ClientSideServerRequest, ctx: RouteContext, result: unknown) => void | Promise<void>;
+    onError?: (request: ClientSideServerRequest, ctx: RouteContext, error: Error) => void | Promise<void>;
+    onChannelOpen?: (channel: ClientSideServerChannel) => void | Promise<void>;
+    onChannelClose?: (channel: ClientSideServerChannel) => void | Promise<void>;
+    middleware?: ClientSideServerMiddleware[];
+}
+export interface ClientSideServerMiddlewareContext {
+    request: ClientSideServerRequest;
+    operation: PLATServerResolvedOperation;
+    ctx: RouteContext;
+    input: Record<string, any>;
+    logger: Logger;
+}
+export type ClientSideServerMiddleware = (context: ClientSideServerMiddlewareContext, next: () => Promise<unknown>) => Promise<unknown> | unknown;
+export declare class PLATClientSideServer {
+    private options;
+    private routes;
+    private toolsStore;
+    private operationRegistry;
+    private registeredMethodNames;
+    private registeredControllerNames;
+    private core;
+    private openapiCache?;
+    private logger;
+    private middleware;
+    constructor(options?: ClientSideServerOptions, ...ControllerClasses: (new () => any)[]);
+    register(...ControllerClasses: (new () => any)[]): this;
+    use(middleware: ClientSideServerMiddleware): this;
+    get tools(): ToolDefinition[];
+    get openapi(): Record<string, any>;
+    handleMessage(message: ClientSideServerMessage, channel: ClientSideServerChannel): Promise<void>;
+    serveChannel(channel: ClientSideServerChannel): () => void;
+    private executeOperation;
+    private executeOperationWithPolicies;
+    private buildErrorPayload;
+    private runMiddlewareChain;
+    private serializeValue;
+    private generateOpenAPISpec;
+}
+export declare function createClientSideServer(options?: ClientSideServerOptions, ...ControllerClasses: (new () => any)[]): PLATClientSideServer;
+//# sourceMappingURL=server.d.ts.map

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

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