@seanhogg/builderforce-webcontainers 2026.10.2 → 2026.10.4

package/dist/node/protocol.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Messages between the page (the process host, which owns the master file
+ * system and the port table) and one process Worker. Everything is plain
+ * structured-clone data; file contents travel as strings or bytes.
+ */
+import type { FileContent, HttpRequestData, HttpResponseData } from '@seanhogg/builderforce-webcontainers-core';
+export type FsOp = {
+    op: 'write';
+    path: string;
+    content: FileContent;
+} | {
+    op: 'remove';
+    path: string;
+} | {
+    op: 'mkdir';
+    path: string;
+};
+export interface StartMessage {
+    type: 'start';
+    pid: number;
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    terminal?: {
+        cols: number;
+        rows: number;
+    };
+    files: Array<[string, FileContent]>;
+    dirs: string[];
+    /** Ports already listening anywhere in the runtime (so `listen` can fail fast with EADDRINUSE). */
+    ports: number[];
+    /** `/__bfwc/<id>/` on the preview origin, for `serverUrl`. */
+    previewOrigin: string;
+    previewBase: string;
+    previewUrl?: string;
+    registry?: string;
+    /** Use Cache Storage for npm tarballs. */
+    packageCache: boolean;
+}
+/** page → worker */
+export type HostToWorker = StartMessage | {
+    type: 'stdin';
+    data: string | null;
+} | {
+    type: 'kill';
+    signal: string;
+} | {
+    type: 'resize';
+    cols: number;
+    rows: number;
+} | {
+    type: 'fs';
+    ops: FsOp[];
+} | {
+    type: 'ports';
+    open: number[];
+    closed: number[];
+} | {
+    type: 'child-out';
+    childId: number;
+    stream: 'stdout' | 'stderr';
+    data: string;
+} | {
+    type: 'child-exit';
+    childId: number;
+    code: number;
+} | {
+    type: 'child-error';
+    childId: number;
+    code: string;
+    message: string;
+} | {
+    type: 'http-request';
+    reqId: number;
+    port: number;
+    request: HttpRequestData;
+} | {
+    type: 'loopback-response';
+    reqId: number;
+    response: HttpResponseData | null;
+};
+/** worker → page */
+export type WorkerToHost = {
+    type: 'stdout' | 'stderr';
+    data: string;
+} | {
+    type: 'exit';
+    code: number;
+} | {
+    type: 'fs';
+    ops: FsOp[];
+} | {
+    type: 'spawn';
+    childId: number;
+    command: string;
+    args: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    terminal?: {
+        cols: number;
+        rows: number;
+    };
+} | {
+    type: 'child-stdin';
+    childId: number;
+    data: string | null;
+} | {
+    type: 'child-kill';
+    childId: number;
+    signal: string;
+} | {
+    type: 'child-resize';
+    childId: number;
+    cols: number;
+    rows: number;
+} | {
+    type: 'listen';
+    port: number;
+} | {
+    type: 'unlisten';
+    port: number;
+} | {
+    type: 'http-response';
+    reqId: number;
+    response: HttpResponseData;
+} | {
+    type: 'loopback';
+    reqId: number;
+    port: number;
+    request: HttpRequestData;
+} | {
+    type: 'server-ready';
+    port: number;
+    url: string;
+};
+/** The preview-relative URL a virtual server on `port` is reachable at. */
+export declare function portPath(previewBase: string, port: number): string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/node/protocol.d.ts.map

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

package/dist/node/protocol.js

@@ -0,0 +1,5 @@
+/** The preview-relative URL a virtual server on `port` is reachable at. */
+export function portPath(previewBase, port) {
+    return `${previewBase}__port/${port}/`;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/node/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/node/protocol.ts"],"names":[],"mappings":"AA2DA,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,IAAY;IACxD,OAAO,GAAG,WAAW,UAAU,IAAI,GAAG,CAAC;AACzC,CAAC"}