@bridgekitux/relay 0.2.0

package/README.md

@@ -0,0 +1,109 @@
+# @bridgekitux/relay
+
+Protocol-proxy relay runtime for BridgeKit.
+
+This package is for the "proxy protocols, not libraries" path. Instead of reimplementing MongoDB, PostgreSQL, Redis, or other driver APIs, BridgeKit can expose local relay ports that forward raw TCP bytes through approved BridgeKit `tcp.stream` capabilities.
+
+## TCP relay
+
+```ts
+import { bridgekit } from '@bridgekitux/client';
+import { startTcpRelay } from '@bridgekitux/relay';
+
+await bridgekit.connect({ manifest });
+
+const relay = await startTcpRelay({
+  client: bridgekit,
+  resourceId: 'local-mongodb',
+  listen: { host: 'localhost', port: 27017 }
+});
+
+console.log(relay.url); // tcp://localhost:27017
+```
+
+Then normal drivers can target the relay port where the runtime supports local TCP connections.
+
+```env
+MONGODB_URI=mongodb://localhost:27017/stacktest
+DATABASE_URL=postgres://user:pass@localhost:5432/app
+```
+
+In production, swap environment variables to real infrastructure. The application code can keep using normal drivers.
+
+## Manifest relays
+
+`bridgekit.config.json` can declare relay listeners:
+
+```json
+{
+  "name": "driver-compatible-demo",
+  "runtime": "node",
+  "requires": {
+    "services": [
+      { "id": "local-mongodb", "type": "tcp", "permissions": ["stream"] }
+    ]
+  },
+  "relays": [
+    {
+      "id": "mongo-driver-port",
+      "type": "tcp",
+      "resourceId": "local-mongodb",
+      "protocol": "mongodb",
+      "listen": { "host": "localhost", "port": 27017 },
+      "options": { "keepAlive": true, "noDelay": true }
+    }
+  ]
+}
+```
+
+Start all relays in the manifest:
+
+```ts
+import { connectAndStartTcpRelays } from '@bridgekitux/relay';
+
+const bridge = await connectAndStartTcpRelays({
+  manifestPath: 'bridgekit.config.json',
+  agentUrl: 'ws://localhost:7777/bridgekit'
+});
+
+console.log(bridge.relays.map((relay) => relay.url));
+```
+
+CLI:
+
+```bash
+bridgekit-relay start --manifest bridgekit.config.json --agent-url ws://localhost:7777/bridgekit
+```
+
+## WebContainer backend companion
+
+Backend:
+
+```ts
+import { BridgeKitClient } from '@bridgekitux/client';
+import { startTcpRelaysFromManifest } from '@bridgekitux/relay';
+import { startWebContainerBridgeServer } from '@bridgekitux/relay/webcontainer-node';
+import manifest from './bridgekit.config.json' assert { type: 'json' };
+
+const bridgeServer = await startWebContainerBridgeServer({ host: 'localhost', port: 8787 });
+const bridgekit = new BridgeKitClient({ transport: bridgeServer.transport, manifest });
+
+await bridgekit.connect();
+await startTcpRelaysFromManifest({ manifest, client: bridgekit });
+```
+
+Browser companion page:
+
+```ts
+import { createWebContainerRelayCompanion } from '@bridgekitux/relay/webcontainer-browser';
+
+createWebContainerRelayCompanion({
+  backendUrl: 'ws://localhost:8787/bridgekit-relay'
+});
+```
+
+## Notes
+
+- Relay declarations map to `tcp.stream` permission requests.
+- `tcp.stream` frames use `binaryBase64` for binary-safe protocol bytes.
+- Raw TCP relay access is powerful; approve only named resources you trust for the current session.

package/dist/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}

package/dist/src/cli.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+import { connectAndStartTcpRelays } from './index.js';
+function parseArgs(argv) {
+    const options = { manifestPath: 'bridgekit.config.json' };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === 'start')
+            continue;
+        if (arg === '--manifest' || arg === '-m') {
+            const value = argv[index + 1];
+            if (!value)
+                throw new Error(`${arg} requires a path`);
+            options.manifestPath = value;
+            index += 1;
+            continue;
+        }
+        if (arg === '--agent-url' || arg === '--bridge-url') {
+            const value = argv[index + 1];
+            if (!value)
+                throw new Error(`${arg} requires a WebSocket URL`);
+            options.agentUrl = value;
+            index += 1;
+            continue;
+        }
+        if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    return options;
+}
+function printHelp() {
+    console.log(`BridgeKit relay
+
+Usage:
+  bridgekit-relay start [--manifest bridgekit.config.json] [--agent-url ws://localhost:7777/bridgekit]
+
+Starts TCP protocol-proxy relays declared in bridgekit.config.json relays[].
+Normal drivers can then connect to the relay listen ports while BridgeKit forwards bytes through approved tcp.stream resources.
+`);
+}
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    const connected = await connectAndStartTcpRelays({ manifestPath: options.manifestPath, agentUrl: options.agentUrl });
+    if (connected.relays.length === 0) {
+        console.log(`No TCP relays declared in ${options.manifestPath}.`);
+        connected.client.close();
+        return;
+    }
+    console.log(`BridgeKit relay started ${connected.relays.length} relay(s) from ${options.manifestPath}:`);
+    for (const relay of connected.relays) {
+        const label = relay.id ? `${relay.id} -> ${relay.resourceId}` : relay.resourceId;
+        const protocol = relay.protocol ? ` (${relay.protocol})` : '';
+        console.log(`- ${label}${protocol}: ${relay.url}`);
+    }
+    console.log('Press Ctrl+C to stop.');
+    await new Promise((resolve) => {
+        const shutdown = () => {
+            void connected.close().finally(resolve);
+        };
+        process.once('SIGINT', shutdown);
+        process.once('SIGTERM', shutdown);
+    });
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,57 @@
+import { type BridgeKitClient, type BridgeKitNodeConnectOptions } from '@bridgekitux/client';
+import { type BridgeKitManifest } from '@bridgekitux/protocol';
+export interface TcpRelayListenOptions {
+    host?: string;
+    port: number;
+}
+export interface TcpRelayOptions {
+    /** Optional relay declaration ID from bridgekit.config.json. */
+    id?: string;
+    /** Approved BridgeKit TCP resource ID. */
+    resourceId: string;
+    /** Optional developer hint such as mongodb, postgres, mysql, redis, http, https, or custom. */
+    protocol?: string;
+    /** Local/WebContainer listener. */
+    listen: TcpRelayListenOptions;
+    /** Connected BridgeKit client. Defaults to the exported singleton. */
+    client?: BridgeKitClient;
+    /** Optional timeout passed to the BridgeKit TCP stream capability. */
+    timeoutMs?: number;
+    /** Optional idle timeout passed to the BridgeKit TCP stream capability. */
+    idleTimeoutMs?: number;
+    /** Enable TCP keepalive for the upstream BridgeKit stream where supported. */
+    keepAlive?: boolean;
+    /** Disable Nagle for low-latency protocol drivers. Defaults to true. */
+    noDelay?: boolean;
+}
+export interface StartedTcpRelay {
+    id?: string;
+    resourceId: string;
+    protocol?: string;
+    host: string;
+    port: number;
+    url: string;
+    close(): Promise<void>;
+}
+export interface StartTcpRelaysFromManifestOptions {
+    /** Inline manifest. If omitted, `manifestPath` is loaded from disk. */
+    manifest?: BridgeKitManifest | unknown;
+    /** Manifest file path. Defaults to `bridgekit.config.json`. */
+    manifestPath?: string;
+    /** Connected BridgeKit client. Defaults to the exported singleton. */
+    client?: BridgeKitClient;
+}
+export interface ConnectAndStartTcpRelaysOptions extends StartTcpRelaysFromManifestOptions, Pick<BridgeKitNodeConnectOptions, 'agentUrl' | 'bridgeUrl' | 'pairingTimeoutMs' | 'pollIntervalMs'> {
+}
+export interface ConnectedTcpRelays {
+    client: BridgeKitClient;
+    manifest: BridgeKitManifest;
+    relays: StartedTcpRelay[];
+    close(): Promise<void>;
+}
+export declare function startTcpRelay(options: TcpRelayOptions): Promise<StartedTcpRelay>;
+export declare function startTcpRelays(relays: TcpRelayOptions[]): Promise<StartedTcpRelay[]>;
+export declare function tcpRelayOptionsFromManifest(input: BridgeKitManifest | unknown, client?: BridgeKitClient): TcpRelayOptions[];
+export declare function startTcpRelaysFromManifest(options?: StartTcpRelaysFromManifestOptions): Promise<StartedTcpRelay[]>;
+export declare function connectAndStartTcpRelays(options?: ConnectAndStartTcpRelaysOptions): Promise<ConnectedTcpRelays>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAEjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAoB,KAAK,iBAAiB,EAAiC,MAAM,uBAAuB,CAAC;AAEhH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,sEAAsE;IACtE,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,iCAAiC;IAChD,uEAAuE;IACvE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC;IACvC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,+BAAgC,SAAQ,iCAAiC,EAAE,IAAI,CAAC,2BAA2B,EAAE,UAAU,GAAG,WAAW,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;CAAG;AAElM,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAyBtF;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAS1F;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,EAAE,MAAM,GAAE,eAA2B,GAAG,eAAe,EAAE,CAetI;AAED,wBAAsB,0BAA0B,CAAC,OAAO,GAAE,iCAAsC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAG5H;AAED,wBAAsB,wBAAwB,CAAC,OAAO,GAAE,+BAAoC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgCzH"}

package/dist/src/index.js

@@ -0,0 +1,149 @@
+import { createServer } from 'node:net';
+import { bridgekit, connectBridgeKitNode, loadBridgeKitManifestFromFile } from '@bridgekitux/client';
+import { validateManifest } from '@bridgekitux/protocol';
+export async function startTcpRelay(options) {
+    const client = options.client ?? bridgekit;
+    const host = options.listen.host ?? 'localhost';
+    const requestedPort = options.listen.port;
+    const server = createServer((socket) => {
+        void handleSocket(socket, options, client);
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(requestedPort, host, () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    const port = typeof address === 'object' && address ? address.port : requestedPort;
+    return {
+        id: options.id,
+        resourceId: options.resourceId,
+        protocol: options.protocol,
+        host,
+        port,
+        url: `tcp://${host}:${port}`,
+        close: () => closeServer(server)
+    };
+}
+export async function startTcpRelays(relays) {
+    const started = [];
+    try {
+        for (const relay of relays)
+            started.push(await startTcpRelay(relay));
+        return started;
+    }
+    catch (error) {
+        await Promise.allSettled(started.map((relay) => relay.close()));
+        throw error;
+    }
+}
+export function tcpRelayOptionsFromManifest(input, client = bridgekit) {
+    const manifest = validateManifest(input);
+    return (manifest.relays ?? [])
+        .filter((relay) => relay.type === 'tcp')
+        .map((relay) => ({
+        id: relay.id,
+        resourceId: relay.resourceId,
+        protocol: relay.protocol,
+        listen: relay.listen,
+        client,
+        timeoutMs: relay.options?.timeoutMs,
+        idleTimeoutMs: relay.options?.idleTimeoutMs,
+        keepAlive: relay.options?.keepAlive,
+        noDelay: relay.options?.noDelay
+    }));
+}
+export async function startTcpRelaysFromManifest(options = {}) {
+    const manifest = validateManifest(options.manifest ?? await loadBridgeKitManifestFromFile(options.manifestPath ?? 'bridgekit.config.json'));
+    return startTcpRelays(tcpRelayOptionsFromManifest(manifest, options.client ?? bridgekit));
+}
+export async function connectAndStartTcpRelays(options = {}) {
+    const client = options.client ?? bridgekit;
+    const manifest = validateManifest(options.manifest ?? await loadBridgeKitManifestFromFile(options.manifestPath ?? 'bridgekit.config.json'));
+    const relayOptions = tcpRelayOptionsFromManifest(manifest, client);
+    if (relayOptions.length === 0) {
+        return {
+            client,
+            manifest,
+            relays: [],
+            close: async () => client.close()
+        };
+    }
+    if (!client.state.connected) {
+        await connectBridgeKitNode({
+            client,
+            manifest,
+            agentUrl: options.agentUrl,
+            bridgeUrl: options.bridgeUrl,
+            pairingTimeoutMs: options.pairingTimeoutMs,
+            pollIntervalMs: options.pollIntervalMs
+        });
+    }
+    const relays = await startTcpRelays(relayOptions);
+    return {
+        client,
+        manifest,
+        relays,
+        close: async () => {
+            await Promise.allSettled(relays.map((relay) => relay.close()));
+            client.close();
+        }
+    };
+}
+async function handleSocket(socket, options, client) {
+    socket.pause();
+    let subscription;
+    let closed = false;
+    const closeBoth = () => {
+        if (closed)
+            return;
+        closed = true;
+        socket.destroy();
+        void subscription?.unsubscribe().catch(() => undefined);
+    };
+    try {
+        subscription = await client.tcp(options.resourceId).stream({
+            encoding: 'utf8',
+            timeoutMs: options.timeoutMs,
+            idleTimeoutMs: options.idleTimeoutMs,
+            keepAlive: options.keepAlive,
+            noDelay: options.noDelay ?? true
+        }, (event) => {
+            const data = event.data;
+            if (event.event === 'tcp.data') {
+                const payload = data?.binaryBase64 ? Buffer.from(data.binaryBase64, 'base64') : Buffer.from(data?.chunk ?? '', 'utf8');
+                if (payload.length > 0 && !socket.destroyed)
+                    socket.write(payload);
+                return;
+            }
+            if (event.event === 'tcp.end') {
+                if (!socket.destroyed)
+                    socket.end();
+                return;
+            }
+            if (event.event === 'tcp.close' || event.event === 'tcp.error' || event.event === 'tcp.timeout') {
+                closeBoth();
+            }
+        });
+        socket.on('data', (chunk) => {
+            void subscription.send(undefined, { binaryBase64: chunk.toString('base64') }).catch(closeBoth);
+        });
+        socket.on('end', () => {
+            void subscription.end().catch(() => undefined);
+        });
+        socket.on('error', closeBoth);
+        socket.on('close', closeBoth);
+        socket.resume();
+    }
+    catch {
+        closeBoth();
+    }
+}
+function closeServer(server) {
+    return new Promise((resolve) => {
+        server.close(() => resolve());
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/webcontainer-browser.d.ts

@@ -0,0 +1,13 @@
+export interface WebContainerRelayCompanionOptions {
+    /** WebSocket URL served by the WebContainer/backend relay process. */
+    backendUrl?: string;
+    /** Target origin for window.postMessage to the BridgeKit extension/host bridge. Defaults to current origin. */
+    targetOrigin?: string;
+    /** Reconnect delay for the backend companion socket. Defaults to 1000ms. */
+    reconnectMs?: number;
+}
+export interface WebContainerRelayCompanionController {
+    close(): void;
+}
+export declare function createWebContainerRelayCompanion(options?: WebContainerRelayCompanionOptions): WebContainerRelayCompanionController;
+//# sourceMappingURL=webcontainer-browser.d.ts.map

package/dist/src/webcontainer-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webcontainer-browser.d.ts","sourceRoot":"","sources":["../../src/webcontainer-browser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iCAAiC;IAChD,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+GAA+G;IAC/G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oCAAoC;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAWD,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,iCAAsC,GAAG,oCAAoC,CAyEtI"}

package/dist/src/webcontainer-browser.js

@@ -0,0 +1,85 @@
+import { parseMessage, toBridgeKitError } from '@bridgekitux/protocol';
+const BACKEND_SOURCE = 'bridgekit-webcontainer-backend';
+const COMPANION_SOURCE = 'bridgekit-webcontainer-companion';
+export function createWebContainerRelayCompanion(options = {}) {
+    if (typeof window === 'undefined')
+        throw new Error('createWebContainerRelayCompanion() must run in a browser page');
+    const targetOrigin = options.targetOrigin ?? window.location.origin;
+    const backendUrl = options.backendUrl ?? defaultBackendUrl();
+    const reconnectMs = options.reconnectMs ?? 1_000;
+    let socket;
+    let reconnectTimer;
+    let closed = false;
+    function connect() {
+        if (closed)
+            return;
+        socket = new WebSocket(backendUrl);
+        socket.addEventListener('open', () => {
+            window.postMessage({ source: 'bridgekit-client', type: 'bridgekit.detect' }, targetOrigin);
+        });
+        socket.addEventListener('message', (event) => handleBackendMessage(event.data));
+        socket.addEventListener('close', scheduleReconnect);
+        socket.addEventListener('error', scheduleReconnect);
+    }
+    function scheduleReconnect() {
+        if (closed || reconnectTimer)
+            return;
+        reconnectTimer = setTimeout(() => {
+            reconnectTimer = undefined;
+            connect();
+        }, reconnectMs);
+    }
+    function handleBackendMessage(raw) {
+        let message;
+        try {
+            const envelope = JSON.parse(String(raw));
+            if (!envelope || envelope.source !== BACKEND_SOURCE || envelope.type !== 'bridgekit.request')
+                return;
+            message = parseMessage(envelope.message);
+        }
+        catch (error) {
+            sendToBackend({
+                protocolVersion: '0.1.0',
+                type: 'bridgekit.response',
+                error: toBridgeKitError(error)
+            });
+            return;
+        }
+        window.postMessage({ source: 'bridgekit-client', type: 'bridgekit.request', message }, targetOrigin);
+    }
+    function handleWindowMessage(event) {
+        if (event.origin !== targetOrigin)
+            return;
+        const data = event.data;
+        if (!data || data.source !== 'bridgekit-bridge')
+            return;
+        if (data.type !== 'bridgekit.response' && data.type !== 'bridgekit.event')
+            return;
+        sendToBackend(data.message);
+    }
+    function sendToBackend(message) {
+        if (!socket || socket.readyState !== WebSocket.OPEN)
+            return;
+        socket.send(JSON.stringify({
+            source: COMPANION_SOURCE,
+            type: 'bridgekit.forward',
+            message
+        }));
+    }
+    window.addEventListener('message', handleWindowMessage);
+    connect();
+    return {
+        close() {
+            closed = true;
+            if (reconnectTimer)
+                clearTimeout(reconnectTimer);
+            window.removeEventListener('message', handleWindowMessage);
+            socket?.close();
+        }
+    };
+}
+function defaultBackendUrl() {
+    const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+    return `${protocol}//${window.location.hostname}:8787/bridgekit-relay`;
+}
+//# sourceMappingURL=webcontainer-browser.js.map

package/dist/src/webcontainer-browser.js.map

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

package/dist/src/webcontainer-node.d.ts

@@ -0,0 +1,20 @@
+import type { AddressInfo } from 'node:net';
+import type { BridgeTransport } from '@bridgekitux/client';
+export interface WebContainerBridgeServerOptions {
+    host?: string;
+    port?: number;
+    path?: string;
+    requestTimeoutMs?: number;
+    companionTimeoutMs?: number;
+}
+export interface StartedWebContainerBridgeServer {
+    host: string;
+    port: number;
+    path: string;
+    url: string;
+    transport: BridgeTransport;
+    close(): Promise<void>;
+}
+export declare function startWebContainerBridgeServer(options?: WebContainerBridgeServerOptions): Promise<StartedWebContainerBridgeServer>;
+export declare function getWebContainerBridgeServerAddress(server: StartedWebContainerBridgeServer): AddressInfo;
+//# sourceMappingURL=webcontainer-node.d.ts.map

package/dist/src/webcontainer-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webcontainer-node.d.ts","sourceRoot":"","sources":["../../src/webcontainer-node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAU5C,OAAO,KAAK,EAA0B,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEnF,MAAM,WAAW,+BAA+B;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAWD,wBAAsB,6BAA6B,CAAC,OAAO,GAAE,+BAAoC,GAAG,OAAO,CAAC,+BAA+B,CAAC,CA+H3I;AAWD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,+BAA+B,GAAG,WAAW,CAEvG"}

package/dist/src/webcontainer-node.js

@@ -0,0 +1,148 @@
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { WebSocketServer, WebSocket } from 'ws';
+import { createMessage, parseMessage, toBridgeKitError } from '@bridgekitux/protocol';
+const BACKEND_SOURCE = 'bridgekit-webcontainer-backend';
+const COMPANION_SOURCE = 'bridgekit-webcontainer-companion';
+export async function startWebContainerBridgeServer(options = {}) {
+    const host = options.host ?? 'localhost';
+    const requestedPort = options.port ?? 8787;
+    const path = options.path ?? '/bridgekit-relay';
+    const httpServer = createServer();
+    const wsServer = new WebSocketServer({ server: httpServer, path });
+    const companions = new Set();
+    const pending = new Map();
+    const eventListeners = new Set();
+    const companionWaiters = new Set();
+    wsServer.on('connection', (socket) => {
+        companions.add(socket);
+        for (const resolve of companionWaiters)
+            resolve();
+        companionWaiters.clear();
+        socket.on('message', (raw) => handleCompanionMessage(raw));
+        socket.on('close', () => companions.delete(socket));
+    });
+    await new Promise((resolve, reject) => {
+        httpServer.once('error', reject);
+        httpServer.listen(requestedPort, host, () => {
+            httpServer.off('error', reject);
+            resolve();
+        });
+    });
+    const address = httpServer.address();
+    const port = typeof address === 'object' && address ? address.port : requestedPort;
+    const url = `ws://${host}:${port}${path}`;
+    function activeCompanion() {
+        return [...companions].find((socket) => socket.readyState === WebSocket.OPEN);
+    }
+    async function waitForCompanion(timeoutMs = options.companionTimeoutMs ?? 30_000) {
+        if (activeCompanion())
+            return;
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                companionWaiters.delete(onCompanion);
+                reject(new Error(`BridgeKit WebContainer companion did not connect within ${timeoutMs}ms`));
+            }, timeoutMs);
+            const onCompanion = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            companionWaiters.add(onCompanion);
+        });
+    }
+    function sendToCompanion(message) {
+        const companion = activeCompanion();
+        if (!companion)
+            throw new Error('BridgeKit WebContainer companion is not connected');
+        companion.send(JSON.stringify({ source: BACKEND_SOURCE, type: 'bridgekit.request', message }));
+    }
+    function handleCompanionMessage(raw) {
+        let message;
+        try {
+            const envelope = JSON.parse(raw.toString());
+            if (!envelope || envelope.source !== COMPANION_SOURCE)
+                return;
+            message = parseMessage(envelope.message);
+        }
+        catch (error) {
+            const bridgeError = toBridgeKitError(error);
+            for (const pendingRequest of pending.values())
+                pendingRequest.reject(Object.assign(new Error(bridgeError.message), { bridgeKit: bridgeError }));
+            pending.clear();
+            return;
+        }
+        if (message.type === 'event') {
+            for (const listener of eventListeners)
+                listener(message.payload);
+            return;
+        }
+        if (!message.id)
+            return;
+        const pendingRequest = pending.get(message.id);
+        if (!pendingRequest)
+            return;
+        clearTimeout(pendingRequest.timer);
+        pending.delete(message.id);
+        if (message.error)
+            pendingRequest.reject(Object.assign(new Error(message.error.message), { bridgeKit: message.error }));
+        else
+            pendingRequest.resolve(message);
+    }
+    const transport = {
+        kind: 'host-page',
+        connect: () => waitForCompanion(),
+        request: async (type, payload) => {
+            await waitForCompanion();
+            const id = `bk_wc_${Date.now()}_${randomUUID()}`;
+            const message = createMessage(type, payload, id);
+            return new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    pending.delete(id);
+                    reject(new Error(`BridgeKit WebContainer bridge request timed out: ${type}`));
+                }, options.requestTimeoutMs ?? 30_000);
+                pending.set(id, { resolve: resolve, reject, timer });
+                try {
+                    sendToCompanion(message);
+                }
+                catch (error) {
+                    clearTimeout(timer);
+                    pending.delete(id);
+                    reject(error instanceof Error ? error : new Error(String(error)));
+                }
+            });
+        },
+        onEvent: (listener) => {
+            eventListeners.add(listener);
+            return () => eventListeners.delete(listener);
+        },
+        close: () => {
+            for (const pendingRequest of pending.values()) {
+                clearTimeout(pendingRequest.timer);
+                pendingRequest.reject(new Error('BridgeKit WebContainer bridge transport closed'));
+            }
+            pending.clear();
+            for (const companion of companions)
+                companion.close();
+        }
+    };
+    return {
+        host,
+        port,
+        path,
+        url,
+        transport,
+        close: () => closeServer(httpServer, wsServer, transport)
+    };
+}
+function closeServer(httpServer, wsServer, transport) {
+    transport.close();
+    return new Promise((resolve) => {
+        wsServer.close(() => {
+            httpServer.close(() => resolve());
+        });
+    });
+}
+export function getWebContainerBridgeServerAddress(server) {
+    return { address: server.host, family: 'IPv4', port: server.port };
+}
+//# sourceMappingURL=webcontainer-node.js.map

package/dist/src/webcontainer-node.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@bridgekitux/relay",
+  "version": "0.2.0",
+  "license": "Apache-2.0",
+  "description": "BridgeKit protocol proxy relay runtime for local/WebContainer development.",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./webcontainer-node": {
+      "types": "./dist/src/webcontainer-node.d.ts",
+      "import": "./dist/src/webcontainer-node.js"
+    },
+    "./webcontainer-browser": {
+      "types": "./dist/src/webcontainer-browser.d.ts",
+      "import": "./dist/src/webcontainer-browser.js"
+    }
+  },
+  "bin": {
+    "bridgekit-relay": "dist/src/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "node --test dist/test/*.test.js"
+  },
+  "dependencies": {
+    "@bridgekitux/client": "0.2.0",
+    "@bridgekitux/protocol": "0.2.0",
+    "ws": "^8.21.0"
+  },
+  "devDependencies": {
+    "@bridgekitux/agent": "0.2.0"
+  },
+  "files": [
+    "dist/src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "bridgekit",
+    "relay",
+    "tcp-proxy",
+    "webcontainer",
+    "sandbox",
+    "protocol-proxy"
+  ]
+}