@modularizer/plat 0.7.0 → 0.9.0

package/dist/client-side-server/plat-service-worker.js

@@ -0,0 +1,292 @@
+/**
+ * plat-service-worker: Universal HTTP interception via Service Worker
+ *
+ * Registers a Service Worker that intercepts ALL fetch events (fetch, XHR,
+ * resource elements, forms, everything) and routes them through the plat channel.
+ *
+ * This is the lowest-level interception point in the browser and eliminates the
+ * need for monkey-patching fetch, XHR, EventSource, Worker, forms, etc.
+ */
+/**
+ * Install the plat bridge via Service Worker.
+ * This is the recommended approach—it intercepts all HTTP requests at the
+ * browser's network layer.
+ *
+ * Requires the Service Worker to be available as a static file or via a server endpoint.
+ * Returns a handle to unregister the Service Worker.
+ * Throws if Service Workers are not supported or registration fails.
+ */
+export async function installServiceWorkerBridge(_channel, options) {
+    if (!navigator.serviceWorker) {
+        throw new Error('Service Workers not supported in this browser. ' +
+            'Ensure HTTPS or localhost is enabled.');
+    }
+    const scope = options?.scope ?? '/';
+    const workerUrl = options?.workerUrl ?? '/plat-service-worker.js';
+    try {
+        const registration = await navigator.serviceWorker.register(workerUrl, { scope });
+        if (registration.waiting) {
+            registration.waiting.postMessage({ type: 'PLAT_SKIP_WAITING' });
+        }
+        await navigator.serviceWorker.ready;
+        if (!navigator.serviceWorker.controller) {
+            await waitForController(1200);
+        }
+        return {
+            async unregister() {
+                await registration.unregister();
+            },
+        };
+    }
+    catch (err) {
+        throw new Error(`Failed to register Service Worker at ${workerUrl}: ` +
+            (err instanceof Error ? err.message : String(err)));
+    }
+}
+/**
+ * Generate the complete Service Worker code as a string.
+ * This is what you'd serve as /plat-service-worker.js or similar.
+ *
+ * The worker communicates with the main thread via postMessage to fetch requests.
+ */
+export function generateServiceWorkerCode() {
+    return `(${serviceWorkerRuntime.toString()})()`;
+}
+function waitForController(timeoutMs) {
+    if (navigator.serviceWorker.controller)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        let done = false;
+        const complete = () => {
+            if (done)
+                return;
+            done = true;
+            navigator.serviceWorker.removeEventListener('controllerchange', onChange);
+            clearTimeout(timer);
+            resolve();
+        };
+        const onChange = () => complete();
+        const timer = setTimeout(() => complete(), timeoutMs);
+        navigator.serviceWorker.addEventListener('controllerchange', onChange);
+    });
+}
+/**
+ * The Service Worker runtime—runs in the worker context.
+ * Must be self-contained (no external dependencies).
+ * Communicates with main thread via postMessage to route requests through platFetch.
+ */
+function serviceWorkerRuntime() {
+    // Interception logic (matches main thread)
+    function shouldIntercept(url) {
+        if (url.startsWith('data:') || url.startsWith('blob:') || url.startsWith('javascript:'))
+            return false;
+        if (url.startsWith('css://'))
+            return true;
+        try {
+            const parsed = new URL(url, self.location.href);
+            return parsed.origin === self.location.origin;
+        }
+        catch {
+            return false;
+        }
+    }
+    function normalizePath(url) {
+        if (url.startsWith('css://')) {
+            try {
+                const parsed = new URL(url.replace('css://', 'http://'));
+                return `${parsed.pathname}${parsed.search}`;
+            }
+            catch {
+                return url;
+            }
+        }
+        if (url.startsWith('/'))
+            return url;
+        try {
+            const parsed = new URL(url, self.location.href);
+            return `${parsed.pathname}${parsed.search}`;
+        }
+        catch {
+            return '/' + url;
+        }
+    }
+    // Map request IDs to pending responses
+    const pending = new Map();
+    function randomId() {
+        return `sw-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+    }
+    function bytesToBase64(bytes) {
+        const chunk = 0x8000;
+        let binary = '';
+        for (let i = 0; i < bytes.length; i += chunk) {
+            binary += String.fromCharCode(...bytes.subarray(i, i + chunk));
+        }
+        return btoa(binary);
+    }
+    async function readRequestBodyAsBase64(req) {
+        if (req.method === 'GET' || req.method === 'HEAD')
+            return undefined;
+        const buf = await req.arrayBuffer();
+        if (buf.byteLength === 0)
+            return undefined;
+        return bytesToBase64(new Uint8Array(buf));
+    }
+    function fromBridgeBody(msg) {
+        if (msg.bodyEncoding === 'none')
+            return msg.body ?? null;
+        if (!msg.body)
+            return null;
+        const binaryStr = atob(msg.body);
+        const bytes = new Uint8Array(binaryStr.length);
+        for (let i = 0; i < binaryStr.length; i++)
+            bytes[i] = binaryStr.charCodeAt(i);
+        return bytes;
+    }
+    async function resolveClientForRequest(clientId) {
+        // @ts-ignore - Service Worker clients API
+        if (clientId) {
+            // @ts-ignore - Service Worker clients API
+            const target = await self.clients.get(clientId);
+            if (target)
+                return target;
+        }
+        // @ts-ignore - Service Worker clients API
+        const all = await self.clients.matchAll({ type: 'window', includeUncontrolled: true });
+        return all[0];
+    }
+    // Listen for responses from main thread
+    // @ts-ignore - Service Worker event
+    self.addEventListener('message', (event) => {
+        if (event.data?.type === 'PLAT_SKIP_WAITING') {
+            // @ts-ignore - Service Worker global API
+            self.skipWaiting();
+            return;
+        }
+        const msg = event.data;
+        if (msg.type === 'PLAT_RESPONSE') {
+            const p = pending.get(msg.id);
+            if (p) {
+                pending.delete(msg.id);
+                if (msg.error) {
+                    p.reject(new Error(msg.error));
+                }
+                else {
+                    p.resolve(msg);
+                }
+            }
+        }
+    });
+    // Intercept all fetch events
+    // @ts-ignore - Service Worker event
+    self.addEventListener('fetch', (event) => {
+        const url = event.request.url;
+        if (!shouldIntercept(url))
+            return;
+        const path = normalizePath(url);
+        const method = event.request.method;
+        const headers = {};
+        event.request.headers.forEach((value, key) => {
+            headers[key.toLowerCase()] = value;
+        });
+        event.respondWith((async () => {
+            try {
+                const body = await readRequestBodyAsBase64(event.request.clone());
+                // Send request to main thread and wait for response
+                const id = randomId();
+                const target = await resolveClientForRequest(event.clientId);
+                if (!target) {
+                    throw new Error('No client available to handle request');
+                }
+                const responsePromise = new Promise((resolve, reject) => {
+                    pending.set(id, { resolve, reject });
+                });
+                const msg = {
+                    type: 'PLAT_REQUEST',
+                    id,
+                    clientId: event.clientId,
+                    method,
+                    path,
+                    headers,
+                    bodyEncoding: body ? 'base64' : 'none',
+                    body,
+                };
+                target.postMessage(msg);
+                // Wait for response with timeout
+                const responseData = (await Promise.race([
+                    responsePromise,
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Service Worker request timeout')), 30000)),
+                ]).finally(() => {
+                    pending.delete(id);
+                }));
+                if (responseData.error) {
+                    throw new Error(responseData.error);
+                }
+                const responseBody = fromBridgeBody(responseData);
+                return new Response(responseBody, {
+                    status: responseData.status,
+                    statusText: responseData.statusText,
+                    headers: new Headers(responseData.headers),
+                });
+            }
+            catch (err) {
+                // Clear any orphaned pending entries if this request failed before response.
+                // No-op if already removed.
+                // (request ids are unique per request)
+                const message = err instanceof Error ? err.message : String(err);
+                return new Response(`[Service Worker] ${message}`, {
+                    status: 500,
+                    statusText: 'Internal Server Error',
+                    headers: { 'content-type': 'text/plain' },
+                });
+            }
+        })());
+    });
+    // Claim all clients
+    // @ts-ignore - Service Worker event
+    self.addEventListener('activate', (event) => {
+        // @ts-ignore - Service Worker clients API
+        event.waitUntil(self.clients.claim());
+    });
+    // @ts-ignore - Service Worker event
+    self.addEventListener('install', () => {
+        // @ts-ignore - Service Worker global API
+        self.skipWaiting();
+    });
+}
+// ── Shared helpers ───────────────────────────────────────────────────────────
+function shouldIntercept(url) {
+    if (url.startsWith('data:') || url.startsWith('blob:') || url.startsWith('javascript:'))
+        return false;
+    if (url.startsWith('/') || !url.includes('://'))
+        return true;
+    if (url.startsWith('css://'))
+        return true;
+    try {
+        const parsed = new URL(url, window.location.href);
+        return parsed.origin === window.location.origin;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizePath(url) {
+    if (url.startsWith('css://')) {
+        try {
+            const parsed = new URL(url.replace('css://', 'http://'));
+            return `${parsed.pathname}${parsed.search}`;
+        }
+        catch {
+            return url;
+        }
+    }
+    if (url.startsWith('/'))
+        return url;
+    try {
+        const parsed = new URL(url, typeof window !== 'undefined' ? window.location.href : 'http://localhost/');
+        return `${parsed.pathname}${parsed.search}`;
+    }
+    catch {
+        return '/' + url;
+    }
+}
+//# sourceMappingURL=plat-service-worker.js.map

package/dist/client-side-server/plat-service-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plat-service-worker.js","sourceRoot":"","sources":["../../src/client-side-server/plat-service-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,QAAiC,EACjC,OAAgD;IAEhD,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,iDAAiD;YACjD,uCAAuC,CACxC,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,GAAG,CAAA;IACnC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,yBAAyB,CAAA;IAEjE,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QACjF,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAA;QACjE,CAAC;QAED,MAAM,SAAS,CAAC,aAAa,CAAC,KAAK,CAAA;QAEnC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC/B,CAAC;QAED,OAAO;YACL,KAAK,CAAC,UAAU;gBACd,MAAM,YAAY,CAAC,UAAU,EAAE,CAAA;YACjC,CAAC;SACF,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wCAAwC,SAAS,IAAI;YACrD,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACnD,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAA;AACjD,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,IAAI,SAAS,CAAC,aAAa,CAAC,UAAU;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAChE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,GAAG,KAAK,CAAA;QAChB,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,IAAI;gBAAE,OAAM;YAChB,IAAI,GAAG,IAAI,CAAA;YACX,SAAS,CAAC,aAAa,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAA;YACzE,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,EAAE,CAAA;QACX,CAAC,CAAA;QACD,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAA;QACrD,SAAS,CAAC,aAAa,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB;IA0B3B,2CAA2C;IAC3C,SAAS,eAAe,CAAC,GAAW;QAClC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,KAAK,CAAA;QACrG,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAA;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC/C,OAAO,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAA;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,SAAS,aAAa,CAAC,GAAW;QAChC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAA;gBACxD,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;YAC7C,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,GAAG,CAAA;YAAC,CAAC;QACxB,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAA;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC/C,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,GAAG,GAAG,CAAA;QAClB,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqE,CAAA;IAE5F,SAAS,QAAQ;QACf,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;IACtE,CAAC;IAED,SAAS,aAAa,CAAC,KAAiB;QACtC,MAAM,KAAK,GAAG,MAAM,CAAA;QACpB,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAC7C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAA;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;IACrB,CAAC;IAED,KAAK,UAAU,uBAAuB,CAAC,GAAY;QACjD,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,SAAS,CAAA;QACnE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAA;QACnC,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QAC1C,OAAO,aAAa,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,SAAS,cAAc,CAAC,GAAwB;QAC9C,IAAI,GAAG,CAAC,YAAY,KAAK,MAAM;YAAE,OAAO,GAAG,CAAC,IAAI,IAAI,IAAI,CAAA;QACxD,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,OAAO,IAAI,CAAA;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC7E,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,UAAU,uBAAuB,CAAC,QAAiB;QACtD,0CAA0C;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,0CAA0C;YAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAC/C,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAA;QAC3B,CAAC;QACD,0CAA0C;QAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAA;QACtF,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;IACf,CAAC;IAED,wCAAwC;IACxC,oCAAoC;IACpC,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAU,EAAE,EAAE;QAC9C,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,mBAAmB,EAAE,CAAC;YAC7C,yCAAyC;YACzC,IAAI,CAAC,WAAW,EAAE,CAAA;YAClB,OAAM;QACR,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,IAA2B,CAAA;QAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC7B,IAAI,CAAC,EAAE,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACtB,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;oBACd,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;gBAChC,CAAC;qBAAM,CAAC;oBACN,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,6BAA6B;IAC7B,oCAAoC;IACpC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAU,EAAE,EAAE;QAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAA;QAC7B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;YAAE,OAAM;QAEjC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAA;QACnC,MAAM,OAAO,GAA2B,EAAE,CAAA;QAC1C,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAa,EAAE,GAAW,EAAE,EAAE;YAC3D,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAA;QACpC,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,WAAW,CACf,CAAC,KAAK,IAAI,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;gBAEjE,oDAAoD;gBACpD,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAA;gBACrB,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;gBAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;gBAC1D,CAAC;gBAED,MAAM,eAAe,GAAG,IAAI,OAAO,CAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBAC3D,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;gBACtC,CAAC,CAAC,CAAA;gBAEF,MAAM,GAAG,GAAuB;oBAC9B,IAAI,EAAE,cAAc;oBACpB,EAAE;oBACF,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,MAAM;oBACN,IAAI;oBACJ,OAAO;oBACP,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;oBACtC,IAAI;iBACL,CAAA;gBACD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;gBAEvB,iCAAiC;gBACjC,MAAM,YAAY,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC;oBACvC,eAAe;oBACf,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CACxB,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,EAAE,KAAK,CAAC,CAC7E;iBACF,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;oBACd,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBACpB,CAAC,CAAC,CAAwB,CAAA;gBAE1B,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;gBACrC,CAAC;gBAED,MAAM,YAAY,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;gBAEjD,OAAO,IAAI,QAAQ,CAAC,YAAY,EAAE;oBAChC,MAAM,EAAE,YAAY,CAAC,MAAM;oBAC3B,UAAU,EAAE,YAAY,CAAC,UAAU;oBACnC,OAAO,EAAE,IAAI,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC;iBAC3C,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,6EAA6E;gBAC7E,4BAA4B;gBAC5B,uCAAuC;gBACvC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAChE,OAAO,IAAI,QAAQ,CAAC,oBAAoB,OAAO,EAAE,EAAE;oBACjD,MAAM,EAAE,GAAG;oBACX,UAAU,EAAE,uBAAuB;oBACnC,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE;iBAC1C,CAAC,CAAA;YACJ,CAAC;QACH,CAAC,CAAC,EAAE,CACL,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,oBAAoB;IACpB,oCAAoC;IACpC,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,KAAU,EAAE,EAAE;QAC/C,0CAA0C;QAC1C,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,oCAAoC;IACpC,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE;QACpC,yCAAyC;QACzC,IAAI,CAAC,WAAW,EAAE,CAAA;IACpB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,gFAAgF;AAEhF,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAA;IACrG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC5D,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACjD,OAAO,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAA;YACxD,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;QAC7C,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,GAAG,CAAA;QAAC,CAAC;IACxB,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAA;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAA;QACvG,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,GAAG,GAAG,CAAA;IAClB,CAAC;AACH,CAAC"}

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

@@ -1,4 +1,46 @@
 import type { PLATRPCEventKind } from '../rpc';
+/**
+ * Version and identity metadata that a server publishes about itself.
+ * All fields are optional — servers populate what they know.
+ * `openapiHash` and `serverStartedAt` are auto-computed; the rest are user-supplied.
+ */
+export interface ClientSideServerInstanceInfo {
+    /** Semantic version string, e.g. "1.2.3" or "2026-04-07". */
+    version?: string;
+    /** Commit hash, build hash, or any content-identifier for the server code. */
+    versionHash?: string;
+    /**
+     * SHA-256 hex digest of the server's openapi.json (computed automatically
+     * from the generated spec; stable for the same set of controllers and options).
+     */
+    openapiHash?: string;
+    /** Unix timestamp (ms) when the server code / deployment was last updated. */
+    updatedAt?: number;
+    /** Unix timestamp (ms) when this server instance started (auto-set on start). */
+    serverStartedAt?: number;
+}
+export type ServiceWorkerBridgeBodyEncoding = 'none' | 'base64';
+export interface ServiceWorkerBridgeRequestMessage {
+    type: 'PLAT_REQUEST';
+    id: string;
+    clientId?: string;
+    method: string;
+    path: string;
+    headers: Record<string, string>;
+    bodyEncoding: ServiceWorkerBridgeBodyEncoding;
+    body?: string;
+}
+export interface ServiceWorkerBridgeResponseMessage {
+    type: 'PLAT_RESPONSE';
+    id: string;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    bodyEncoding: ServiceWorkerBridgeBodyEncoding;
+    body?: string;
+    error?: string;
+    errorCode?: 'timeout' | 'no-client' | 'upstream-failed' | 'bad-response';
+}
 export interface ClientSideServerRequest {
     jsonrpc: '2.0';
     id: string;
@@ -39,10 +81,35 @@ export interface ClientSideServerPeerMessage {
     fromPeerId?: string;
     fromServerName?: string;
 }
+export interface ClientSideServerPingMessage {
+    platcss: 'ping';
+    ts: number;
+}
+export interface ClientSideServerPongMessage {
+    platcss: 'pong';
+    ts: number;
+}
+export interface ClientSideServerDrainMessage {
+    platcss: 'drain';
+}
+export interface ClientSideServerPrivateChallengeRequest {
+    platcss: 'private-challenge';
+    challengeNonce: string;
+    clientIdentity?: import('./identity').ClientSideServerPublicIdentity;
+}
+export interface ClientSideServerPrivateChallengeResponse {
+    platcss: 'private-challenge-response';
+    challengeNonce: string;
+    challengeSignature: string;
+    identity: import('./identity').ClientSideServerPublicIdentity;
+    authorityRecord?: import('./identity').ClientSideServerSignedAuthorityRecord;
+}
+export type ClientSideServerControlMessage = ClientSideServerPingMessage | ClientSideServerPongMessage | ClientSideServerDrainMessage | ClientSideServerPrivateChallengeRequest | ClientSideServerPrivateChallengeResponse;
 export type ClientSideServerResponse = ClientSideServerSuccessResponse | ClientSideServerErrorResponse;
 export type ClientSideServerRPCMessage = ClientSideServerRequest | ClientSideServerResponse | ClientSideServerEventMessage;
-export type ClientSideServerMessage = ClientSideServerRPCMessage | ClientSideServerPeerMessage;
+export type ClientSideServerMessage = ClientSideServerRPCMessage | ClientSideServerPeerMessage | ClientSideServerControlMessage;
 export declare function isClientSideServerPeerMessage(message: ClientSideServerMessage): message is ClientSideServerPeerMessage;
+export declare function isClientSideServerControlMessage(message: ClientSideServerMessage): message is ClientSideServerControlMessage;
 export declare function isClientSideServerRequestMessage(message: ClientSideServerMessage): message is ClientSideServerRequest;
 export declare function isClientSideServerEventMessage(message: ClientSideServerMessage): message is ClientSideServerEventMessage;
 export declare function isClientSideServerResponseMessage(message: ClientSideServerMessage): message is ClientSideServerResponse;

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

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/client-side-server/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAE9C,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,CAAA;CACF;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,gBAAgB,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,wBAAwB,GAChC,+BAA+B,GAC/B,6BAA6B,CAAA;AAEjC,MAAM,MAAM,0BAA0B,GAClC,uBAAuB,GACvB,wBAAwB,GACxB,4BAA4B,CAAA;AAEhC,MAAM,MAAM,uBAAuB,GAC/B,0BAA0B,GAC1B,2BAA2B,CAAA;AAE/B,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,IAAI,2BAA2B,CAEtH;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,IAAI,uBAAuB,CAErH;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,IAAI,4BAA4B,CAExH;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,IAAI,wBAAwB,CAErC"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/client-side-server/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAE9C;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,MAAM,+BAA+B,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE/D,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,cAAc,CAAA;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,YAAY,EAAE,+BAA+B,CAAA;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,eAAe,CAAA;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,YAAY,EAAE,+BAA+B,CAAA;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,iBAAiB,GAAG,cAAc,CAAA;CACzE;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,CAAA;CACF;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,gBAAgB,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,mBAAmB,CAAA;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,OAAO,YAAY,EAAE,8BAA8B,CAAA;CACrE;AAED,MAAM,WAAW,wCAAwC;IACvD,OAAO,EAAE,4BAA4B,CAAA;IACrC,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,OAAO,YAAY,EAAE,8BAA8B,CAAA;IAC7D,eAAe,CAAC,EAAE,OAAO,YAAY,EAAE,qCAAqC,CAAA;CAC7E;AAED,MAAM,MAAM,8BAA8B,GACtC,2BAA2B,GAC3B,2BAA2B,GAC3B,4BAA4B,GAC5B,uCAAuC,GACvC,wCAAwC,CAAA;AAE5C,MAAM,MAAM,wBAAwB,GAChC,+BAA+B,GAC/B,6BAA6B,CAAA;AAEjC,MAAM,MAAM,0BAA0B,GAClC,uBAAuB,GACvB,wBAAwB,GACxB,4BAA4B,CAAA;AAEhC,MAAM,MAAM,uBAAuB,GAC/B,0BAA0B,GAC1B,2BAA2B,GAC3B,8BAA8B,CAAA;AAElC,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,IAAI,2BAA2B,CAEtH;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,IAAI,8BAA8B,CAK5H;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,IAAI,uBAAuB,CAErH;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,IAAI,4BAA4B,CAExH;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,IAAI,wBAAwB,CAErC"}

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

@@ -1,6 +1,13 @@
 export function isClientSideServerPeerMessage(message) {
     return 'platcss' in message && message.platcss === 'peer';
 }
+export function isClientSideServerControlMessage(message) {
+    if (!('platcss' in message))
+        return false;
+    const kind = message.platcss;
+    return kind === 'ping' || kind === 'pong' || kind === 'drain'
+        || kind === 'private-challenge' || kind === 'private-challenge-response';
+}
 export function isClientSideServerRequestMessage(message) {
     return 'jsonrpc' in message && 'method' in message && 'path' in message;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../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"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/client-side-server/protocol.ts"],"names":[],"mappings":"AA8IA,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,IAAI,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC;QAAE,OAAO,KAAK,CAAA;IACzC,MAAM,IAAI,GAAI,OAAe,CAAC,OAAO,CAAA;IACrC,OAAO,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO;WACxD,IAAI,KAAK,mBAAmB,IAAI,IAAI,KAAK,4BAA4B,CAAA;AAC5E,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

@@ -1,6 +1,6 @@
 import { OpenAPIClient } from '../client/openapi-client';
 import type { OpenAPISpec } from '../types/openapi';
-import { type ClientSideServerMQTTWebRTCOptions, type ClientSideServerMQTTWebRTCServer } from './mqtt-webrtc';
+import { type ClientSideServerMQTTWebRTCOptions, type ClientSideServerMQTTWebRTCServer, type ClientSideServerWorkerInfo } from './mqtt-webrtc';
 import { type PLATClientSideServer } from './server';
 import { type ClientSideServerSourceAnalysis, type TypeScriptLike } from './source-analysis';
 type ControllerClass = new () => any;
@@ -18,6 +18,12 @@ export interface ClientSideServerSourceModule {
 export interface StartClientSideServerFromSourceOptions extends ClientSideServerMQTTWebRTCOptions {
     serverName?: string;
     undecoratedMode?: 'GET' | 'POST' | 'private';
+    workerInfo?: ClientSideServerWorkerInfo;
+    /**
+     * Version / identity metadata published in MQTT announces and via the `/server-info` endpoint.
+     * `openapiHash` and `serverStartedAt` are auto-computed; the rest are user-supplied.
+     */
+    instanceInfo?: import('./protocol').ClientSideServerInstanceInfo;
     source: string | Record<string, string>;
     /**
      * Optional: specify which file is the entry point when using multiple source files.
@@ -64,6 +70,8 @@ export declare function runClientSideServer(source: Record<string, string>, opti
 export declare const runClientSideServerFromSource: typeof runClientSideServer;
 export declare function startClientSideServerFromSource(options: StartClientSideServerFromSourceOptions): Promise<StartedClientSideServer>;
 export declare function serveClientSideServer(serverName: string, controllers: ControllerClass[]): ClientSideServerDefinition;
+/** Server-style alias for defining a client-side server module. */
+export declare const serveServer: typeof serveClientSideServer;
 export interface ConnectClientSideServerOptions extends ClientSideServerMQTTWebRTCOptions {
     baseUrl: string;
 }
@@ -71,6 +79,13 @@ export declare function connectClientSideServer(options: ConnectClientSideServer
     client: OpenAPIClient;
     openapi: OpenAPISpec;
 }>;
+/** Server-style alias for connecting to a server endpoint (css:// or http(s)://). */
+export declare const connectServer: typeof connectClientSideServer;
+/**
+ * Server-style alias for starting a client-side server from source.
+ * Mirrors the common `startServer(...)` naming across runtimes.
+ */
+export declare const startServer: typeof runClientSideServer;
 export interface RetryLoopOptions {
     initialDelayMs?: number;
     maxDelayMs?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/client-side-server/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAGL,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EACtC,MAAM,eAAe,CAAA;AACtB,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAE5E,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAE1B,KAAK,eAAe,GAAG,UAAU,GAAG,CAAA;AAEpC,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,eAAe,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;IAC/B,gBAAgB,CAAC,EAAE,0BAA0B,CAAA;IAC7C,OAAO,CAAC,EAAE,eAAe,EAAE,GAAG,0BAA0B,GAAG;QAAE,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE,CAAA;CAC/F;AAED,MAAM,WAAW,sCAAuC,SAAQ,iCAAiC;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtG,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,8BAA8B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAA;IAC1J,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC1E;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,QAAQ,EAAE,gCAAgC,CAAA;IAC1C,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,sCAAsC,EACtC,QAAQ,GAAG,WAAW,GAAG,eAAe,CACzC,GAAG;IACF,sFAAsF;IACtF,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtG,kFAAkF;IAClF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,8BAA8B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAA;CAC3J,CAAA;AAED,yDAAyD;AACzD,MAAM,MAAM,oCAAoC,GAAG,0BAA0B,CAAA;AAE7E;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,uBAAuB,CAAC,CAAA;AACnC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,0BAA0B,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,uBAAuB,CAAC,CAAA;AAsCnC,kDAAkD;AAClD,eAAO,MAAM,6BAA6B,4BAAsB,CAAA;AAgBhE,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,uBAAuB,CAAC,CAwElC;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,eAAe,EAAE,GAC7B,0BAA0B,CAE5B;AAGD,MAAM,WAAW,8BAA+B,SAAQ,iCAAiC;IACvF,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC;IACT,MAAM,EAAE,aAAa,CAAA;IACrB,OAAO,EAAE,WAAW,CAAA;CACrB,CAAC,CAQD;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;IACvD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,IAAI,CAAA;IACZ,UAAU,IAAI,IAAI,CAAA;CACnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAChC,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CA6DjB;AAsCD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,eAAe,EAAE,EAC9B,QAAQ,EAAE,8BAA8B,GACvC,IAAI,CA6BN;AAED,wBAAgB,2CAA2C,CACzD,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,WAAW,EAAE,eAAe,EAAE,EAC9B,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,8BAA8B,CAMhC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/client-side-server/runtime.ts"],"names":[],"mappings":"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"}

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

@@ -9,9 +9,11 @@ export async function runClientSideServer(source, options = {}) {
     const { transpile: customTranspile, analyzeSource: customAnalyze, ...rest } = options;
     const undecoratedMode = rest.undecoratedMode ?? 'POST';
     const entryPoint = options.sourceEntryPoint;
+    const normalizedSource = normalizeClientSideSourceImports(source);
     const defaultTranspile = (src, ep) => {
-        if (typeof src === 'string') {
-            return ts.transpileModule(src, {
+        const normalized = normalizeClientSideSourceImports(src);
+        if (typeof normalized === 'string') {
+            return ts.transpileModule(normalized, {
                 compilerOptions: {
                     module: ts.ModuleKind.ESNext,
                     target: ts.ScriptTarget.ES2022,
@@ -19,17 +21,18 @@ export async function runClientSideServer(source, options = {}) {
                 },
             }).outputText;
         }
-        return transpileMultipleFiles(src, ts, ep);
+        return transpileMultipleFiles(normalized, ts, ep);
     };
     const defaultAnalyze = (src, ep) => {
-        if (typeof src === 'string') {
-            return analyzeClientSideServerSource(ts, src, { undecoratedMode });
+        const normalized = normalizeClientSideSourceImports(src);
+        if (typeof normalized === 'string') {
+            return analyzeClientSideServerSource(ts, normalized, { undecoratedMode });
         }
-        return analyzeClientSideServerMultipleFiles(ts, src, { undecoratedMode, entryPoint: ep });
+        return analyzeClientSideServerMultipleFiles(ts, normalized, { undecoratedMode, entryPoint: ep });
     };
     return startClientSideServerFromSource({
         ...rest,
-        source,
+        source: normalizedSource,
         sourceEntryPoint: entryPoint,
         transpile: customTranspile ?? defaultTranspile,
         analyzeSource: customAnalyze ?? defaultAnalyze,
@@ -52,16 +55,17 @@ function transpileSource(source, entryPoint) {
     }
 }
 export async function startClientSideServerFromSource(options) {
+    const normalizedSource = normalizeClientSideSourceImports(options.source);
     const compiled = await (options.transpile
-        ? options.transpile(options.source, options.sourceEntryPoint)
-        : Promise.resolve(transpileSource(options.source, options.sourceEntryPoint)));
+        ? options.transpile(normalizedSource, options.sourceEntryPoint)
+        : Promise.resolve(transpileSource(normalizedSource, options.sourceEntryPoint)));
     const analysis = await (options.analyzeSource
-        ? options.analyzeSource(options.source, options.sourceEntryPoint)
-        : Promise.resolve(typeof options.source === 'string'
-            ? analyzeClientSideServerSource(ts, options.source, {
+        ? options.analyzeSource(normalizedSource, options.sourceEntryPoint)
+        : Promise.resolve(typeof normalizedSource === 'string'
+            ? analyzeClientSideServerSource(ts, normalizedSource, {
                 undecoratedMode: options.undecoratedMode ?? 'POST',
             })
-            : analyzeClientSideServerMultipleFiles(ts, options.source, {
+            : analyzeClientSideServerMultipleFiles(ts, normalizedSource, {
                 undecoratedMode: options.undecoratedMode ?? 'POST',
                 entryPoint: options.sourceEntryPoint,
             })));
@@ -79,6 +83,7 @@ export async function startClientSideServerFromSource(options) {
     }
     const server = createClientSideServer({
         undecoratedMode: options.undecoratedMode,
+        instanceInfo: options.instanceInfo,
     }, ...definition.controllers);
     if (options.onRequest) {
         const originalHandle = server.handleMessage.bind(server);
@@ -103,6 +108,9 @@ export async function startClientSideServerFromSource(options) {
         connectionTimeoutMs: options.connectionTimeoutMs,
         announceIntervalMs: options.announceIntervalMs,
         clientIdPrefix: options.clientIdPrefix,
+        identity: options.identity,
+        workerInfo: options.workerInfo,
+        instanceInfo: options.instanceInfo,
     });
     await signaler.start();
     return {
@@ -115,9 +123,22 @@ export async function startClientSideServerFromSource(options) {
         },
     };
 }
+function normalizeClientSideSourceImports(source) {
+    const rewrite = (value) => value
+        // Browser runtime expects plat-client package specifiers for blob-module execution.
+        .replaceAll('@modularizer/plat/', '@modularizer/plat-client/')
+        // Legacy short static alias often pasted from old docs/snippets.
+        .replaceAll('"plat/static"', '"@modularizer/plat-client/static"')
+        .replaceAll("'plat/static'", "'@modularizer/plat-client/static'");
+    if (typeof source === 'string')
+        return rewrite(source);
+    return Object.fromEntries(Object.entries(source).map(([k, v]) => [k, rewrite(v)]));
+}
 export function serveClientSideServer(serverName, controllers) {
     return { serverName, controllers };
 }
+/** Server-style alias for defining a client-side server module. */
+export const serveServer = serveClientSideServer;
 export async function connectClientSideServer(options) {
     const transportPlugin = createClientSideServerMQTTWebRTCTransportPlugin(options);
     const openapi = await fetchClientSideServerOpenAPI(options.baseUrl, transportPlugin);
@@ -127,6 +148,13 @@ export async function connectClientSideServer(options) {
     });
     return { client, openapi };
 }
+/** Server-style alias for connecting to a server endpoint (css:// or http(s)://). */
+export const connectServer = connectClientSideServer;
+/**
+ * Server-style alias for starting a client-side server from source.
+ * Mirrors the common `startServer(...)` naming across runtimes.
+ */
+export const startServer = runClientSideServer;
 export function startRetryLoop(task, options = {}) {
     const initialDelayMs = options.initialDelayMs ?? 2_000;
     const maxDelayMs = options.maxDelayMs ?? 30_000;