pipecircuit 0.0.1

package/README.md

@@ -0,0 +1,11 @@
+# pipecircuit
+
+Browser fittings and Postcard program boundaries for Rust-first Pipecircuit
+applications.
+
+The authoritative program remains Rust. This package provides transferable
+Web Worker transport, strict packed framing, and command-specific TypeScript
+outcome inference for generated Postcard contracts.
+
+See the [Pipecircuit repository](https://github.com/KenAKAFrosty/pipecircuit-scaffold/tree/main/libraries/browser)
+for the Rust crate, architecture, and Green Room example.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { MAXIMUM_PACKED_FRAME_PAYLOAD_BYTE_LENGTH, PACKED_FRAME_HEADER_BYTE_LENGTH, PackedFrameError, } from "./packed_frame.js";
+export { Pipe, type TransportTo } from "./pipe.js";
+export { PostcardPipe, PostcardPipeError, type DecodedPostcard, type PostcardContractCodec, type PostcardOutcomeFor, type PostcardPipeFailure, type TaggedPostcardValue, } from "./postcard.js";
+export { TransferableWebWorkerFitting, WorkerTransportError, installTransferableWebWorkerProgram, type PackedByteProgram, type TransferableWebWorkerEvidence, type TransferableWorkerEndpoint, type TransferableWorkerScope, type WorkerTransportFailure, } from "./web_worker.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wCAAwC,EACxC,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,mCAAmC,EACnC,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { MAXIMUM_PACKED_FRAME_PAYLOAD_BYTE_LENGTH, PACKED_FRAME_HEADER_BYTE_LENGTH, PackedFrameError, } from "./packed_frame.js";
+export { Pipe } from "./pipe.js";
+export { PostcardPipe, PostcardPipeError, } from "./postcard.js";
+export { TransferableWebWorkerFitting, WorkerTransportError, installTransferableWebWorkerProgram, } from "./web_worker.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wCAAwC,EACxC,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AACnD,OAAO,EACL,YAAY,EACZ,iBAAiB,GAMlB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,mCAAmC,GAMpC,MAAM,iBAAiB,CAAC"}

package/dist/packed_frame.d.ts

@@ -0,0 +1,25 @@
+export declare const MAXIMUM_PACKED_FRAME_PAYLOAD_BYTE_LENGTH: number;
+export declare const PACKED_FRAME_HEADER_BYTE_LENGTH = 16;
+export type PackedFrameFailure = "invalid-buffer" | "frame-too-short" | "invalid-magic" | "unsupported-revision" | "invalid-kind" | "invalid-request-id" | "payload-too-long" | "payload-length-mismatch";
+export declare class PackedFrameError extends Error {
+    readonly failure: PackedFrameFailure;
+    constructor(failure: PackedFrameFailure);
+}
+export declare function encodeRequestFrame(requestId: number, payload: Uint8Array<ArrayBufferLike>): ArrayBuffer;
+export declare function decodeRequestFrame(value: unknown): {
+    readonly buffer: ArrayBuffer;
+    readonly requestId: number;
+    readonly payload: Uint8Array<ArrayBuffer>;
+};
+export declare function encodeResponseFrame(requestId: number, payload: Uint8Array<ArrayBufferLike>, reusable: ArrayBuffer): ArrayBuffer;
+export declare function decodeResponseFrame(value: unknown): {
+    readonly requestId: number;
+    readonly payload: Uint8Array<ArrayBuffer>;
+};
+export declare function encodeFailureFrame(requestId: number, failure: string, reusable: ArrayBuffer): ArrayBuffer;
+export declare function decodeFailureFrame(value: unknown): {
+    readonly requestId: number;
+    readonly failure: string;
+};
+export declare function decodeFrameKind(value: unknown): "response" | "failure";
+//# sourceMappingURL=packed_frame.d.ts.map

package/dist/packed_frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packed_frame.d.ts","sourceRoot":"","sources":["../src/packed_frame.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wCAAwC,QAAqB,CAAC;AAO3E,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAQlD,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,sBAAsB,GACtB,cAAc,GACd,oBAAoB,GACpB,kBAAkB,GAClB,yBAAyB,CAAC;AAE9B,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAE5C,YAAmB,OAAO,EAAE,kBAAkB,EAI7C;CACF;AAmGD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,CAAC,eAAe,CAAC,GACnC,WAAW,CAOb;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAClD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;CAC3C,CAUA;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,CAAC,eAAe,CAAC,EACpC,QAAQ,EAAE,WAAW,GACpB,WAAW,CAQb;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;CAC3C,CASA;AAKD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,GACpB,WAAW,CASb;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CASA;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAUtE"}

package/dist/packed_frame.js

@@ -0,0 +1,144 @@
+const PACKED_FRAME_MAGIC = 0x50495045;
+const PACKED_FRAME_REVISION = 1;
+const MAXIMUM_REQUEST_ID = 0xffff_ffff;
+export const MAXIMUM_PACKED_FRAME_PAYLOAD_BYTE_LENGTH = 16 * 1_024 * 1_024;
+const MAGIC_OFFSET = 0;
+const REVISION_OFFSET = 4;
+const KIND_OFFSET = 6;
+const REQUEST_ID_OFFSET = 8;
+const PAYLOAD_BYTE_LENGTH_OFFSET = 12;
+export const PACKED_FRAME_HEADER_BYTE_LENGTH = 16;
+var PackedFrameKind;
+(function (PackedFrameKind) {
+    PackedFrameKind[PackedFrameKind["Request"] = 1] = "Request";
+    PackedFrameKind[PackedFrameKind["Response"] = 2] = "Response";
+    PackedFrameKind[PackedFrameKind["Failure"] = 3] = "Failure";
+})(PackedFrameKind || (PackedFrameKind = {}));
+export class PackedFrameError extends Error {
+    failure;
+    constructor(failure) {
+        super(failure);
+        this.name = "PackedFrameError";
+        this.failure = failure;
+    }
+}
+function validateRequestId(requestId) {
+    if (!Number.isInteger(requestId) ||
+        requestId <= 0 ||
+        requestId > MAXIMUM_REQUEST_ID) {
+        throw new PackedFrameError("invalid-request-id");
+    }
+}
+function validatePayloadByteLength(payloadByteLength) {
+    if (!Number.isSafeInteger(payloadByteLength) ||
+        payloadByteLength < 0 ||
+        payloadByteLength > MAXIMUM_PACKED_FRAME_PAYLOAD_BYTE_LENGTH) {
+        throw new PackedFrameError("payload-too-long");
+    }
+}
+function encodeFrame(requestId, kind, payloadByteLength, encodePayload, reusable) {
+    validateRequestId(requestId);
+    validatePayloadByteLength(payloadByteLength);
+    const frameByteLength = PACKED_FRAME_HEADER_BYTE_LENGTH + payloadByteLength;
+    const buffer = reusable?.byteLength === frameByteLength
+        ? reusable
+        : new ArrayBuffer(frameByteLength);
+    const header = new DataView(buffer, 0, PACKED_FRAME_HEADER_BYTE_LENGTH);
+    header.setUint32(MAGIC_OFFSET, PACKED_FRAME_MAGIC);
+    header.setUint16(REVISION_OFFSET, PACKED_FRAME_REVISION);
+    header.setUint16(KIND_OFFSET, kind);
+    header.setUint32(REQUEST_ID_OFFSET, requestId);
+    header.setUint32(PAYLOAD_BYTE_LENGTH_OFFSET, payloadByteLength);
+    encodePayload(new Uint8Array(buffer, PACKED_FRAME_HEADER_BYTE_LENGTH, payloadByteLength));
+    return buffer;
+}
+function decodeFrame(value) {
+    if (!(value instanceof ArrayBuffer)) {
+        throw new PackedFrameError("invalid-buffer");
+    }
+    if (value.byteLength < PACKED_FRAME_HEADER_BYTE_LENGTH) {
+        throw new PackedFrameError("frame-too-short");
+    }
+    const header = new DataView(value, 0, PACKED_FRAME_HEADER_BYTE_LENGTH);
+    if (header.getUint32(MAGIC_OFFSET) !== PACKED_FRAME_MAGIC) {
+        throw new PackedFrameError("invalid-magic");
+    }
+    if (header.getUint16(REVISION_OFFSET) !== PACKED_FRAME_REVISION) {
+        throw new PackedFrameError("unsupported-revision");
+    }
+    const kind = header.getUint16(KIND_OFFSET);
+    if (kind !== PackedFrameKind.Request &&
+        kind !== PackedFrameKind.Response &&
+        kind !== PackedFrameKind.Failure) {
+        throw new PackedFrameError("invalid-kind");
+    }
+    const requestId = header.getUint32(REQUEST_ID_OFFSET);
+    validateRequestId(requestId);
+    const payloadByteLength = header.getUint32(PAYLOAD_BYTE_LENGTH_OFFSET);
+    validatePayloadByteLength(payloadByteLength);
+    if (value.byteLength !==
+        PACKED_FRAME_HEADER_BYTE_LENGTH + payloadByteLength) {
+        throw new PackedFrameError("payload-length-mismatch");
+    }
+    return {
+        buffer: value,
+        requestId,
+        kind,
+        payload: new Uint8Array(value, PACKED_FRAME_HEADER_BYTE_LENGTH, payloadByteLength),
+    };
+}
+export function encodeRequestFrame(requestId, payload) {
+    return encodeFrame(requestId, PackedFrameKind.Request, payload.byteLength, (destination) => destination.set(payload));
+}
+export function decodeRequestFrame(value) {
+    const frame = decodeFrame(value);
+    if (frame.kind !== PackedFrameKind.Request) {
+        throw new PackedFrameError("invalid-kind");
+    }
+    return {
+        buffer: frame.buffer,
+        requestId: frame.requestId,
+        payload: frame.payload,
+    };
+}
+export function encodeResponseFrame(requestId, payload, reusable) {
+    return encodeFrame(requestId, PackedFrameKind.Response, payload.byteLength, (destination) => destination.set(payload), reusable);
+}
+export function decodeResponseFrame(value) {
+    const frame = decodeFrame(value);
+    if (frame.kind !== PackedFrameKind.Response) {
+        throw new PackedFrameError("invalid-kind");
+    }
+    return {
+        requestId: frame.requestId,
+        payload: frame.payload,
+    };
+}
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder();
+export function encodeFailureFrame(requestId, failure, reusable) {
+    const payload = textEncoder.encode(failure);
+    return encodeFrame(requestId, PackedFrameKind.Failure, payload.byteLength, (destination) => destination.set(payload), reusable);
+}
+export function decodeFailureFrame(value) {
+    const frame = decodeFrame(value);
+    if (frame.kind !== PackedFrameKind.Failure) {
+        throw new PackedFrameError("invalid-kind");
+    }
+    return {
+        requestId: frame.requestId,
+        failure: textDecoder.decode(frame.payload),
+    };
+}
+export function decodeFrameKind(value) {
+    const frame = decodeFrame(value);
+    switch (frame.kind) {
+        case PackedFrameKind.Response:
+            return "response";
+        case PackedFrameKind.Failure:
+            return "failure";
+        case PackedFrameKind.Request:
+            throw new PackedFrameError("invalid-kind");
+    }
+}
+//# sourceMappingURL=packed_frame.js.map

package/dist/packed_frame.js.map

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

package/dist/pipe.d.ts

@@ -0,0 +1,11 @@
+export interface TransportTo<Input, Output> {
+    send(input: Input): Promise<Output>;
+    close(): void;
+}
+export declare class Pipe<Input, Output> {
+    #private;
+    constructor(transport: TransportTo<Input, Output>);
+    send(input: Input): Promise<Output>;
+    close(): void;
+}
+//# sourceMappingURL=pipe.d.ts.map

package/dist/pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../src/pipe.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW,CAAC,KAAK,EAAE,MAAM;IACxC,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,qBAAa,IAAI,CAAC,KAAK,EAAE,MAAM;;IAG7B,YAAmB,SAAS,EAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,EAEvD;IAEM,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAEzC;IAEM,KAAK,IAAI,IAAI,CAEnB;CACF"}

package/dist/pipe.js

@@ -0,0 +1,13 @@
+export class Pipe {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    send(input) {
+        return this.#transport.send(input);
+    }
+    close() {
+        this.#transport.close();
+    }
+}
+//# sourceMappingURL=pipe.js.map

package/dist/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../src/pipe.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,IAAI;IACN,UAAU,CAA6B;IAEhD,YAAmB,SAAqC;QACtD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAEM,IAAI,CAAC,KAAY;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/postcard.d.ts

@@ -0,0 +1,32 @@
+import type { Pipe } from "./pipe.js";
+export type DecodedPostcard<Value> = Value extends bigint ? bigint | number : Value extends object ? {
+    [Key in keyof Value]: DecodedPostcard<Value[Key]>;
+} : Value;
+export type TaggedPostcardValue = {
+    readonly tag: PropertyKey;
+    readonly value?: unknown;
+};
+export type PostcardOutcomeFor<Command extends TaggedPostcardValue, Outcome extends TaggedPostcardValue> = DecodedPostcard<Extract<Outcome, {
+    tag: Command["tag"];
+}> extends {
+    value: infer Value;
+} ? Value : undefined>;
+export interface PostcardContractCodec<Command extends TaggedPostcardValue, Outcome extends TaggedPostcardValue> {
+    encode(command: Command): Uint8Array<ArrayBufferLike>;
+    decode(bytes: Uint8Array<ArrayBuffer>): {
+        readonly value: DecodedPostcard<Outcome>;
+        readonly remainder: Uint8Array<ArrayBufferLike>;
+    };
+}
+export type PostcardPipeFailure = "invalid-command" | "invalid-outcome" | "trailing-outcome-bytes" | "unexpected-outcome";
+export declare class PostcardPipeError extends Error {
+    readonly failure: PostcardPipeFailure;
+    constructor(failure: PostcardPipeFailure, cause?: unknown);
+}
+export declare class PostcardPipe<Command extends TaggedPostcardValue, Outcome extends TaggedPostcardValue> {
+    #private;
+    constructor(pipe: Pipe<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, codec: PostcardContractCodec<Command, Outcome>);
+    exchange<const Input extends Command>(command: Input): Promise<PostcardOutcomeFor<Input, Outcome>>;
+    close(): void;
+}
+//# sourceMappingURL=postcard.d.ts.map

package/dist/postcard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcard.d.ts","sourceRoot":"","sources":["../src/postcard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,eAAe,CAAC,KAAK,IAAI,KAAK,SAAS,MAAM,GACrD,MAAM,GAAG,MAAM,GACf,KAAK,SAAS,MAAM,GAClB;KAAG,GAAG,IAAI,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;CAAE,GACrD,KAAK,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAC5B,OAAO,SAAS,mBAAmB,EACnC,OAAO,SAAS,mBAAmB,IACjC,eAAe,CACjB,OAAO,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;CAAE,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,KAAK,CAAA;CAAE,GACpE,KAAK,GACL,SAAS,CACd,CAAC;AAEF,MAAM,WAAW,qBAAqB,CACpC,OAAO,SAAS,mBAAmB,EACnC,OAAO,SAAS,mBAAmB;IAEnC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG;QACtC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;QACzC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;KACjD,CAAC;CACH;AAED,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,iBAAiB,GACjB,wBAAwB,GACxB,oBAAoB,CAAC;AAEzB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,OAAO,EAAE,mBAAmB,CAAC;IAE7C,YAAmB,OAAO,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,OAAO,EAI/D;CACF;AAED,qBAAa,YAAY,CACvB,OAAO,SAAS,mBAAmB,EACnC,OAAO,SAAS,mBAAmB;;IAKnC,YACE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,EAC5D,KAAK,EAAE,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,EAI/C;IAEY,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,OAAO,EAC/C,OAAO,EAAE,KAAK,GACb,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAuB7C;IAEM,KAAK,IAAI,IAAI,CAEnB;CACF"}

package/dist/postcard.js

@@ -0,0 +1,52 @@
+export class PostcardPipeError extends Error {
+    failure;
+    constructor(failure, cause) {
+        super(failure, { cause });
+        this.name = "PostcardPipeError";
+        this.failure = failure;
+    }
+}
+export class PostcardPipe {
+    #pipe;
+    #codec;
+    constructor(pipe, codec) {
+        this.#pipe = pipe;
+        this.#codec = codec;
+    }
+    async exchange(command) {
+        let encoded;
+        try {
+            encoded = this.#codec.encode(command);
+        }
+        catch (cause) {
+            throw new PostcardPipeError("invalid-command", cause);
+        }
+        const response = await this.#pipe.send(transferableBytes(encoded));
+        try {
+            const decoded = this.#codec.decode(response);
+            if (decoded.remainder.byteLength !== 0) {
+                throw new PostcardPipeError("trailing-outcome-bytes");
+            }
+            if (decoded.value.tag !== command.tag) {
+                throw new PostcardPipeError("unexpected-outcome");
+            }
+            return decoded.value.value;
+        }
+        catch (cause) {
+            if (cause instanceof PostcardPipeError) {
+                throw cause;
+            }
+            throw new PostcardPipeError("invalid-outcome", cause);
+        }
+    }
+    close() {
+        this.#pipe.close();
+    }
+}
+function transferableBytes(bytes) {
+    if (bytes.buffer instanceof ArrayBuffer) {
+        return new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    }
+    return Uint8Array.from(bytes);
+}
+//# sourceMappingURL=postcard.js.map

package/dist/postcard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcard.js","sourceRoot":"","sources":["../src/postcard.ts"],"names":[],"mappings":"AAuCA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1B,OAAO,CAAsB;IAE7C,YAAmB,OAA4B,EAAE,KAAe;QAC9D,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IAId,KAAK,CAAyD;IAC9D,MAAM,CAA0C;IAEzD,YACE,IAA4D,EAC5D,KAA8C;QAE9C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,QAAQ,CACnB,OAAc;QAEd,IAAI,OAAoC,CAAC;QACzC,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,iBAAiB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,OAAO,CAAC,SAAS,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;gBACtC,MAAM,IAAI,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,OAAO,CAAC,KAAK,CAAC,KAA2C,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;gBACvC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,iBAAiB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED,SAAS,iBAAiB,CACxB,KAAkC;IAElC,IAAI,KAAK,CAAC,MAAM,YAAY,WAAW,EAAE,CAAC;QACxC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/web_worker.d.ts

@@ -0,0 +1,36 @@
+import type { TransportTo } from "./pipe.js";
+export interface TransferableWorkerEndpoint {
+    postMessage(message: unknown, transfer: Transferable[]): void;
+    addEventListener(type: "message", listener: (event: MessageEvent<unknown>) => void): void;
+    addEventListener(type: "error", listener: (event: ErrorEvent) => void): void;
+    addEventListener(type: "messageerror", listener: (event: MessageEvent<unknown>) => void): void;
+    terminate(): void;
+}
+export interface TransferableWorkerScope {
+    postMessage(message: unknown, transfer: Transferable[]): void;
+    addEventListener(type: "message", listener: (event: MessageEvent<unknown>) => void): void;
+}
+export interface PackedByteProgram {
+    exchange(input: Uint8Array<ArrayBuffer>): Uint8Array<ArrayBufferLike> | Promise<Uint8Array<ArrayBufferLike>>;
+}
+export type WorkerTransportFailure = "backpressured" | "closed" | "worker-error" | "message-error" | "protocol-error" | "remote-failure";
+export declare class WorkerTransportError extends Error {
+    readonly failure: WorkerTransportFailure;
+    constructor(failure: WorkerTransportFailure, detail?: string);
+}
+export type TransferableWebWorkerEvidence = {
+    readonly sentMessageCount: number;
+    readonly receivedMessageCount: number;
+    readonly sentByteCount: number;
+    readonly receivedByteCount: number;
+    readonly detachedOutboundBufferCount: number;
+};
+export declare class TransferableWebWorkerFitting implements TransportTo<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>> {
+    #private;
+    constructor(worker: TransferableWorkerEndpoint, maximumPendingRequestCount: number);
+    send(input: Uint8Array<ArrayBuffer>): Promise<Uint8Array<ArrayBuffer>>;
+    close(): void;
+    evidence(): TransferableWebWorkerEvidence;
+}
+export declare function installTransferableWebWorkerProgram(scope: TransferableWorkerScope, program: PackedByteProgram): void;
+//# sourceMappingURL=web_worker.d.ts.map

package/dist/web_worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_worker.d.ts","sourceRoot":"","sources":["../src/web_worker.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC9D,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,IAAI,GAC/C,IAAI,CAAC;IACR,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7E,gBAAgB,CACd,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,IAAI,GAC/C,IAAI,CAAC;IACR,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC9D,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,IAAI,GAC/C,IAAI,CAAC;CACT;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CACN,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,GAE5B,UAAU,CAAC,eAAe,CAAC,GAC3B,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,sBAAsB,GAC9B,eAAe,GACf,QAAQ,GACR,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAgB,OAAO,EAAE,sBAAsB,CAAC;IAEhD,YAAmB,OAAO,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,MAAM,EAIlE;CACF;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;CAC9C,CAAC;AAOF,qBAAa,4BACX,YACE,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;;IAgB/D,YACE,MAAM,EAAE,0BAA0B,EAClC,0BAA0B,EAAE,MAAM,EAkBnC;IAEM,IAAI,CACT,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CA8BlC;IAEM,KAAK,IAAI,IAAI,CAEnB;IAEM,QAAQ,IAAI,6BAA6B,CAQ/C;CAoEF;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAoCN"}

package/dist/web_worker.js

@@ -0,0 +1,157 @@
+import { decodeFailureFrame, decodeFrameKind, decodeRequestFrame, decodeResponseFrame, encodeFailureFrame, encodeRequestFrame, encodeResponseFrame, } from "./packed_frame.js";
+export class WorkerTransportError extends Error {
+    failure;
+    constructor(failure, detail) {
+        super(detail === undefined ? failure : `${failure}: ${detail}`);
+        this.name = "WorkerTransportError";
+        this.failure = failure;
+    }
+}
+export class TransferableWebWorkerFitting {
+    #worker;
+    #maximumPendingRequestCount;
+    #pending = new Map();
+    #nextRequestId = 1;
+    #closed = false;
+    #sentMessageCount = 0;
+    #receivedMessageCount = 0;
+    #sentByteCount = 0;
+    #receivedByteCount = 0;
+    #detachedOutboundBufferCount = 0;
+    constructor(worker, maximumPendingRequestCount) {
+        if (!Number.isSafeInteger(maximumPendingRequestCount) ||
+            maximumPendingRequestCount <= 0 ||
+            maximumPendingRequestCount > 0xffff_ffff) {
+            throw new RangeError("maximumPendingRequestCount must be positive");
+        }
+        this.#worker = worker;
+        this.#maximumPendingRequestCount = maximumPendingRequestCount;
+        worker.addEventListener("message", (event) => this.#receive(event.data));
+        worker.addEventListener("error", (event) => {
+            this.#closeWith(new WorkerTransportError("worker-error", event.message));
+        });
+        worker.addEventListener("messageerror", () => {
+            this.#closeWith(new WorkerTransportError("message-error"));
+        });
+    }
+    send(input) {
+        if (this.#closed) {
+            return Promise.reject(new WorkerTransportError("closed"));
+        }
+        if (this.#pending.size >= this.#maximumPendingRequestCount) {
+            return Promise.reject(new WorkerTransportError("backpressured"));
+        }
+        const requestId = this.#takeRequestId();
+        const frame = encodeRequestFrame(requestId, input);
+        const frameByteLength = frame.byteLength;
+        return new Promise((resolve, reject) => {
+            this.#pending.set(requestId, { resolve, reject });
+            try {
+                this.#worker.postMessage(frame, [frame]);
+            }
+            catch (error) {
+                this.#pending.delete(requestId);
+                reject(new WorkerTransportError("worker-error", error instanceof Error ? error.message : String(error)));
+                return;
+            }
+            this.#sentMessageCount += 1;
+            this.#sentByteCount += frameByteLength;
+            if (frame.byteLength === 0) {
+                this.#detachedOutboundBufferCount += 1;
+            }
+        });
+    }
+    close() {
+        this.#closeWith(new WorkerTransportError("closed"));
+    }
+    evidence() {
+        return {
+            sentMessageCount: this.#sentMessageCount,
+            receivedMessageCount: this.#receivedMessageCount,
+            sentByteCount: this.#sentByteCount,
+            receivedByteCount: this.#receivedByteCount,
+            detachedOutboundBufferCount: this.#detachedOutboundBufferCount,
+        };
+    }
+    #takeRequestId() {
+        for (;;) {
+            const requestId = this.#nextRequestId;
+            this.#nextRequestId = requestId === 0xffff_ffff ? 1 : requestId + 1;
+            if (!this.#pending.has(requestId)) {
+                return requestId;
+            }
+        }
+    }
+    #receive(value) {
+        if (this.#closed) {
+            return;
+        }
+        if (!(value instanceof ArrayBuffer)) {
+            this.#closeWith(new WorkerTransportError("protocol-error"));
+            return;
+        }
+        this.#receivedMessageCount += 1;
+        this.#receivedByteCount += value.byteLength;
+        try {
+            const kind = decodeFrameKind(value);
+            if (kind === "response") {
+                const response = decodeResponseFrame(value);
+                const pending = this.#pending.get(response.requestId);
+                if (pending === undefined) {
+                    this.#closeWith(new WorkerTransportError("protocol-error"));
+                    return;
+                }
+                this.#pending.delete(response.requestId);
+                pending.resolve(response.payload);
+                return;
+            }
+            const failure = decodeFailureFrame(value);
+            const pending = this.#pending.get(failure.requestId);
+            if (pending === undefined) {
+                this.#closeWith(new WorkerTransportError("protocol-error"));
+                return;
+            }
+            this.#pending.delete(failure.requestId);
+            pending.reject(new WorkerTransportError("remote-failure", failure.failure));
+        }
+        catch (error) {
+            this.#closeWith(new WorkerTransportError("protocol-error", error instanceof Error ? error.message : String(error)));
+        }
+    }
+    #failAll(reason) {
+        for (const pending of this.#pending.values()) {
+            pending.reject(reason);
+        }
+        this.#pending.clear();
+    }
+    #closeWith(reason) {
+        if (this.#closed) {
+            return;
+        }
+        this.#closed = true;
+        this.#worker.terminate();
+        this.#failAll(reason);
+    }
+}
+export function installTransferableWebWorkerProgram(scope, program) {
+    scope.addEventListener("message", (event) => {
+        const request = decodeRequestFrame(event.data);
+        let exchange;
+        try {
+            exchange = program.exchange(request.payload);
+        }
+        catch (reason) {
+            const response = encodeFailureFrame(request.requestId, reason instanceof Error ? reason.message : String(reason), request.buffer);
+            scope.postMessage(response, [response]);
+            return;
+        }
+        void Promise.resolve(exchange).then((output) => {
+            const response = encodeResponseFrame(request.requestId, output, request.buffer);
+            scope.postMessage(response, [response]);
+        }, (reason) => {
+            const response = encodeFailureFrame(request.requestId, reason instanceof Error ? reason.message : String(reason), request.buffer);
+            scope.postMessage(response, [response]);
+        });
+    });
+}
+//# sourceMappingURL=web_worker.js.map

package/dist/web_worker.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "pipecircuit",
+  "version": "0.0.1",
+  "description": "Browser fittings and Postcard program boundaries for Pipecircuit",
+  "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KenAKAFrosty/pipecircuit-scaffold.git",
+    "directory": "libraries/browser/typescript"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "check": "tsc --noEmit",
+    "prepublishOnly": "npm run check && npm test && npm run build",
+    "prepare": "npm run build",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "vitest": "5.0.2"
+  }
+}