@modularizer/plat 0.15.0 → 0.16.0

package/dist/bridge/cli.d.ts

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

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

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

package/dist/bridge/cli.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * plat-bridge — CLI for the HTTP⇄WebRTC bridge.
+ *
+ * Usage:
+ *   plat-bridge --name <css-name> --upstream <http-url>
+ *               [--mqtt <broker-url>] [--topic <mqtt-topic>]
+ *               [--bridge-name <name>] [--trust-client-forwarded]
+ *               [--no-forwarded-headers]
+ *               [--allow-methods GET,POST] [--allow-paths "^/v1/.*"]
+ *               [--request-timeout-ms 30000]
+ */
+import { createHTTPBridge } from './index.js';
+function parseArgs(argv) {
+    const out = {
+        trustClientForwarded: false,
+        noForwardedHeaders: false,
+        help: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = () => argv[++i];
+        switch (arg) {
+            case '--name':
+                out.name = next();
+                break;
+            case '--upstream':
+                out.upstream = next();
+                break;
+            case '--mqtt':
+                out.mqtt = next();
+                break;
+            case '--topic':
+                out.topic = next();
+                break;
+            case '--bridge-name':
+                out.bridgeName = next();
+                break;
+            case '--trust-client-forwarded':
+                out.trustClientForwarded = true;
+                break;
+            case '--no-forwarded-headers':
+                out.noForwardedHeaders = true;
+                break;
+            case '--allow-methods': {
+                const val = next();
+                if (val !== undefined) {
+                    out.allowMethods = val.split(',').map((m) => m.trim());
+                }
+                break;
+            }
+            case '--allow-paths': {
+                if (!out.allowPaths)
+                    out.allowPaths = [];
+                const val = next();
+                if (val !== undefined) {
+                    out.allowPaths.push(val);
+                }
+                break;
+            }
+            case '--request-timeout-ms':
+                out.requestTimeoutMs = Number(next());
+                break;
+            case '-h':
+            case '--help':
+                out.help = true;
+                break;
+            default:
+                process.stderr.write(`plat-bridge: unknown argument ${arg}\n`);
+                process.exit(2);
+        }
+    }
+    return out;
+}
+function printHelp() {
+    process.stdout.write(`plat-bridge — forward css:// WebRTC requests to an HTTP upstream\n\n`
+        + `Usage: plat-bridge --name <css-name> --upstream <http-url> [options]\n\n`
+        + `Required:\n`
+        + `  --name <name>          css:// name this bridge serves as\n`
+        + `  --upstream <url>       HTTP base URL to forward to\n\n`
+        + `Signaling:\n`
+        + `  --mqtt <url>           MQTT broker URL (default: public EMQX broker)\n`
+        + `  --topic <name>         MQTT topic\n\n`
+        + `Forwarding:\n`
+        + `  --bridge-name <name>        X-Forwarded-By label (default: --name)\n`
+        + `  --trust-client-forwarded    Preserve and append to client X-Forwarded-For\n`
+        + `  --no-forwarded-headers      Disable X-Forwarded-* / Forwarded injection\n`
+        + `  --allow-methods GET,POST    Comma-separated method allowlist\n`
+        + `  --allow-paths <regex>       Repeatable path allowlist regex\n`
+        + `  --request-timeout-ms <n>    Upstream request timeout (default: 30000)\n`);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        printHelp();
+        return;
+    }
+    if (!args.name || !args.upstream) {
+        process.stderr.write('plat-bridge: --name and --upstream are required (use --help)\n');
+        process.exit(2);
+    }
+    const bridge = createHTTPBridge({
+        name: args.name,
+        upstream: args.upstream,
+        mqttBroker: args.mqtt,
+        mqttTopic: args.topic,
+        bridgeName: args.bridgeName,
+        trustClientForwarded: args.trustClientForwarded,
+        disableForwardedHeaders: args.noForwardedHeaders,
+        allowMethods: args.allowMethods,
+        allowPaths: args.allowPaths,
+        requestTimeoutMs: args.requestTimeoutMs,
+    });
+    await bridge.start();
+    process.stdout.write(`plat-bridge listening on ${bridge.cssUrl} → ${args.upstream}\n`);
+    const shutdown = async (signal) => {
+        process.stdout.write(`\nplat-bridge: received ${signal}, stopping…\n`);
+        await bridge.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch((error) => {
+    process.stderr.write(`plat-bridge: fatal: ${error?.stack ?? error?.message ?? error}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/bridge/cli.js.map

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

package/dist/bridge/http-forwarder.d.ts

@@ -0,0 +1,51 @@
+import { type ClientSideServerInstanceInfo } from '../client-side-server/protocol';
+import type { ClientSideServerRequestHandler } from '../client-side-server/mqtt-webrtc';
+export interface HTTPForwarderOptions {
+    /** Base URL of the upstream HTTP server (e.g. "http://localhost:8080"). */
+    upstream?: string;
+    /**
+     * How to determine the upstream origin for each request.
+     * - `fixed`: always use `upstream`
+     * - `request-origin`: use the incoming requestOrigin
+     * - `intercept-origin`: use the incoming interceptOrigin, falling back to requestOrigin
+     */
+    upstreamMode?: 'fixed' | 'request-origin' | 'intercept-origin';
+    /**
+     * How request paths are applied to the resolved upstream base.
+     * - `origin-root`: keep browser URL semantics (`/foo` targets origin root)
+     * - `route-base`: prefix leading-slash paths with intercepted route base (e.g. `/maps`)
+     */
+    pathBaseMode?: 'origin-root' | 'route-base';
+    /** css:// name the bridge is reachable at (e.g. "my-api"). */
+    cssName: string;
+    /** Identifier used in X-Forwarded-By / Forwarded by=. Defaults to cssName. */
+    bridgeName?: string;
+    /** If true, append to a client-supplied X-Forwarded-For / Forwarded rather than overwrite. */
+    trustClientForwarded?: boolean;
+    /**
+     * If true, skip all X-Forwarded-* / Forwarded header injection.
+     * Default: true, because the browser-side bridge should preserve the
+     * incoming HTTP request as closely as the platform allows.
+     */
+    disableForwardedHeaders?: boolean;
+    /** Optional method allowlist (e.g. ['GET', 'POST']); others return 405. */
+    allowMethods?: string[];
+    /** Optional path allowlist (regex); non-matching requests return 403. */
+    allowPaths?: (RegExp | string)[];
+    /** Returned from getServerInfo() — surfaced on MQTT announcements. */
+    instanceInfo?: ClientSideServerInstanceInfo;
+    /**
+     * fetch implementation. Defaults to the global `fetch`. Override for
+     * tests or to use `undici` directly.
+     */
+    fetchImpl?: typeof fetch;
+    /**
+     * Time a single upstream request is allowed to take, in milliseconds.
+     * Default: 30s.
+     */
+    requestTimeoutMs?: number;
+    /** Optional logger for bridge activity. Accepts `console.log` directly. */
+    logger?: (...args: unknown[]) => void;
+}
+export declare function createHTTPForwarder(options: HTTPForwarderOptions): ClientSideServerRequestHandler;
+//# sourceMappingURL=http-forwarder.d.ts.map

package/dist/bridge/http-forwarder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-forwarder.d.ts","sourceRoot":"","sources":["../../src/bridge/http-forwarder.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,4BAA4B,EAKlC,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAA;AAcvF,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,kBAAkB,CAAA;IAC9D;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,GAAG,YAAY,CAAA;IAC3C,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,yEAAyE;IACzE,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAChC,sEAAsE;IACtE,YAAY,CAAC,EAAE,4BAA4B,CAAA;IAC3C;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACtC;AAuCD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,8BAA8B,CAkDjG"}