@daniel156161/prism 0.2.76 → 0.2.81

package/node_modules/@earendil-works/pi-protocol/dist/cbor/encoder.js

@@ -0,0 +1,201 @@
+import { CborError, MAX_UINT32, resolveOptions, textDecoder, textEncoder, UINT32_BASE, } from "./options.js";
+class CborWriter {
+    buffer;
+    offset = 0;
+    maxByteLength;
+    constructor(maxByteLength) {
+        this.maxByteLength = maxByteLength;
+        this.buffer = new Uint8Array(Math.min(256, maxByteLength));
+    }
+    writeByte(value) {
+        this.ensureCapacity(1);
+        this.buffer[this.offset] = value;
+        this.offset++;
+    }
+    writeBytes(bytes) {
+        this.ensureCapacity(bytes.byteLength);
+        this.buffer.set(bytes, this.offset);
+        this.offset += bytes.byteLength;
+    }
+    writeUint16(value) {
+        this.ensureCapacity(2);
+        this.buffer[this.offset] = value >>> 8;
+        this.buffer[this.offset + 1] = value;
+        this.offset += 2;
+    }
+    writeUint32(value) {
+        this.ensureCapacity(4);
+        this.buffer[this.offset] = value >>> 24;
+        this.buffer[this.offset + 1] = value >>> 16;
+        this.buffer[this.offset + 2] = value >>> 8;
+        this.buffer[this.offset + 3] = value;
+        this.offset += 4;
+    }
+    writeUint64(value) {
+        const high = Math.floor(value / UINT32_BASE);
+        const low = value - high * UINT32_BASE;
+        this.writeUint32(high);
+        this.writeUint32(low);
+    }
+    writeFloat64(value) {
+        this.ensureCapacity(9);
+        this.buffer[this.offset] = 0xfb;
+        new DataView(this.buffer.buffer).setFloat64(this.offset + 1, value, false);
+        this.offset += 9;
+    }
+    finish() {
+        return this.buffer.slice(0, this.offset);
+    }
+    ensureCapacity(additionalBytes) {
+        const required = this.offset + additionalBytes;
+        if (required > this.maxByteLength) {
+            throw new CborError(`CBOR byte length exceeds configured limit of ${this.maxByteLength}`);
+        }
+        if (required <= this.buffer.byteLength)
+            return;
+        let capacity = Math.max(1, this.buffer.byteLength);
+        while (capacity < required)
+            capacity = Math.min(this.maxByteLength, Math.max(required, capacity * 2));
+        const expanded = new Uint8Array(capacity);
+        expanded.set(this.buffer);
+        this.buffer = expanded;
+    }
+}
+function writeArgument(writer, majorType, value) {
+    const prefix = majorType << 5;
+    if (value < 24) {
+        writer.writeByte(prefix | value);
+    }
+    else if (value <= 0xff) {
+        writer.writeByte(prefix | 24);
+        writer.writeByte(value);
+    }
+    else if (value <= 0xffff) {
+        writer.writeByte(prefix | 25);
+        writer.writeUint16(value);
+    }
+    else if (value <= MAX_UINT32) {
+        writer.writeByte(prefix | 26);
+        writer.writeUint32(value);
+    }
+    else {
+        writer.writeByte(prefix | 27);
+        writer.writeUint64(value);
+    }
+}
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function encodeText(writer, value, options) {
+    const bytes = textEncoder.encode(value);
+    if (bytes.byteLength > options.maxByteLength) {
+        throw new CborError(`CBOR text string length exceeds configured limit of ${options.maxByteLength}`);
+    }
+    if (textDecoder.decode(bytes) !== value)
+        throw new CborError("CBOR text strings must contain valid Unicode scalar values");
+    writeArgument(writer, 3, bytes.byteLength);
+    writer.writeBytes(bytes);
+}
+function encodeValue(writer, value, options, depth, ancestors) {
+    if (depth > options.maxDepth)
+        throw new CborError(`CBOR nesting depth exceeds configured limit of ${options.maxDepth}`);
+    if (value === null) {
+        writer.writeByte(0xf6);
+        return;
+    }
+    if (typeof value === "boolean") {
+        writer.writeByte(value ? 0xf5 : 0xf4);
+        return;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new CborError("CBOR numbers must be finite");
+        if (Number.isInteger(value) && !Object.is(value, -0)) {
+            if (!Number.isSafeInteger(value))
+                throw new CborError("CBOR integers must be safe JavaScript integers");
+            if (value >= 0)
+                writeArgument(writer, 0, value);
+            else
+                writeArgument(writer, 1, -1 - value);
+        }
+        else {
+            writer.writeFloat64(value);
+        }
+        return;
+    }
+    if (typeof value === "string") {
+        encodeText(writer, value, options);
+        return;
+    }
+    if (value instanceof Uint8Array) {
+        if (value.byteLength > options.maxByteLength) {
+            throw new CborError(`CBOR byte string length exceeds configured limit of ${options.maxByteLength}`);
+        }
+        writeArgument(writer, 2, value.byteLength);
+        writer.writeBytes(value);
+        return;
+    }
+    if (Array.isArray(value)) {
+        if (ancestors.has(value))
+            throw new CborError("CBOR values must not contain cycles");
+        if (value.length > options.maxContainerLength) {
+            throw new CborError(`CBOR array length exceeds configured limit of ${options.maxContainerLength}`);
+        }
+        ancestors.add(value);
+        try {
+            writeArgument(writer, 4, value.length);
+            for (let index = 0; index < value.length; index++) {
+                if (!Object.hasOwn(value, index) || value[index] === undefined) {
+                    throw new CborError("CBOR arrays must not contain holes or undefined values");
+                }
+                encodeValue(writer, value[index], options, depth + 1, ancestors);
+            }
+        }
+        finally {
+            ancestors.delete(value);
+        }
+        return;
+    }
+    if (isPlainObject(value)) {
+        if (ancestors.has(value))
+            throw new CborError("CBOR values must not contain cycles");
+        for (const symbol of Object.getOwnPropertySymbols(value)) {
+            if (Object.prototype.propertyIsEnumerable.call(value, symbol)) {
+                throw new CborError("CBOR map keys must be strings");
+            }
+        }
+        const entries = [];
+        for (const key of Object.keys(value)) {
+            const entryValue = value[key];
+            if (entryValue !== undefined)
+                entries.push([key, entryValue]);
+        }
+        if (entries.length > options.maxContainerLength) {
+            throw new CborError(`CBOR map length exceeds configured limit of ${options.maxContainerLength}`);
+        }
+        ancestors.add(value);
+        try {
+            writeArgument(writer, 5, entries.length);
+            for (const [key, entryValue] of entries) {
+                encodeText(writer, key, options);
+                encodeValue(writer, entryValue, options, depth + 1, ancestors);
+            }
+        }
+        finally {
+            ancestors.delete(value);
+        }
+        return;
+    }
+    throw new CborError(`Unsupported CBOR value type: ${typeof value}`);
+}
+/** Encodes the protocol's strict, definite-length RFC 8949 subset. */
+export function encodeCbor(value, options) {
+    const resolved = resolveOptions(options);
+    const writer = new CborWriter(resolved.maxByteLength);
+    encodeValue(writer, value, resolved, 0, new Set());
+    return writer.finish();
+}
+//# sourceMappingURL=encoder.js.map

package/node_modules/@earendil-works/pi-protocol/dist/cbor/encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/cbor/encoder.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tCborError,\n\ttype CborOptions,\n\tMAX_UINT32,\n\ttype ResolvedCborOptions,\n\tresolveOptions,\n\ttextDecoder,\n\ttextEncoder,\n\tUINT32_BASE,\n} from \"./options.ts\";\n\nclass CborWriter {\n\tprivate buffer: Uint8Array;\n\tprivate offset = 0;\n\tprivate readonly maxByteLength: number;\n\n\tconstructor(maxByteLength: number) {\n\t\tthis.maxByteLength = maxByteLength;\n\t\tthis.buffer = new Uint8Array(Math.min(256, maxByteLength));\n\t}\n\n\twriteByte(value: number): void {\n\t\tthis.ensureCapacity(1);\n\t\tthis.buffer[this.offset] = value;\n\t\tthis.offset++;\n\t}\n\n\twriteBytes(bytes: Uint8Array): void {\n\t\tthis.ensureCapacity(bytes.byteLength);\n\t\tthis.buffer.set(bytes, this.offset);\n\t\tthis.offset += bytes.byteLength;\n\t}\n\n\twriteUint16(value: number): void {\n\t\tthis.ensureCapacity(2);\n\t\tthis.buffer[this.offset] = value >>> 8;\n\t\tthis.buffer[this.offset + 1] = value;\n\t\tthis.offset += 2;\n\t}\n\n\twriteUint32(value: number): void {\n\t\tthis.ensureCapacity(4);\n\t\tthis.buffer[this.offset] = value >>> 24;\n\t\tthis.buffer[this.offset + 1] = value >>> 16;\n\t\tthis.buffer[this.offset + 2] = value >>> 8;\n\t\tthis.buffer[this.offset + 3] = value;\n\t\tthis.offset += 4;\n\t}\n\n\twriteUint64(value: number): void {\n\t\tconst high = Math.floor(value / UINT32_BASE);\n\t\tconst low = value - high * UINT32_BASE;\n\t\tthis.writeUint32(high);\n\t\tthis.writeUint32(low);\n\t}\n\n\twriteFloat64(value: number): void {\n\t\tthis.ensureCapacity(9);\n\t\tthis.buffer[this.offset] = 0xfb;\n\t\tnew DataView(this.buffer.buffer).setFloat64(this.offset + 1, value, false);\n\t\tthis.offset += 9;\n\t}\n\n\tfinish(): Uint8Array {\n\t\treturn this.buffer.slice(0, this.offset);\n\t}\n\n\tprivate ensureCapacity(additionalBytes: number): void {\n\t\tconst required = this.offset + additionalBytes;\n\t\tif (required > this.maxByteLength) {\n\t\t\tthrow new CborError(`CBOR byte length exceeds configured limit of ${this.maxByteLength}`);\n\t\t}\n\t\tif (required <= this.buffer.byteLength) return;\n\n\t\tlet capacity = Math.max(1, this.buffer.byteLength);\n\t\twhile (capacity < required) capacity = Math.min(this.maxByteLength, Math.max(required, capacity * 2));\n\t\tconst expanded = new Uint8Array(capacity);\n\t\texpanded.set(this.buffer);\n\t\tthis.buffer = expanded;\n\t}\n}\n\nfunction writeArgument(writer: CborWriter, majorType: number, value: number): void {\n\tconst prefix = majorType << 5;\n\tif (value < 24) {\n\t\twriter.writeByte(prefix | value);\n\t} else if (value <= 0xff) {\n\t\twriter.writeByte(prefix | 24);\n\t\twriter.writeByte(value);\n\t} else if (value <= 0xffff) {\n\t\twriter.writeByte(prefix | 25);\n\t\twriter.writeUint16(value);\n\t} else if (value <= MAX_UINT32) {\n\t\twriter.writeByte(prefix | 26);\n\t\twriter.writeUint32(value);\n\t} else {\n\t\twriter.writeByte(prefix | 27);\n\t\twriter.writeUint64(value);\n\t}\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\tif (typeof value !== \"object\" || value === null) return false;\n\tconst prototype = Object.getPrototypeOf(value);\n\treturn prototype === Object.prototype || prototype === null;\n}\n\nfunction encodeText(writer: CborWriter, value: string, options: ResolvedCborOptions): void {\n\tconst bytes = textEncoder.encode(value);\n\tif (bytes.byteLength > options.maxByteLength) {\n\t\tthrow new CborError(`CBOR text string length exceeds configured limit of ${options.maxByteLength}`);\n\t}\n\tif (textDecoder.decode(bytes) !== value)\n\t\tthrow new CborError(\"CBOR text strings must contain valid Unicode scalar values\");\n\twriteArgument(writer, 3, bytes.byteLength);\n\twriter.writeBytes(bytes);\n}\n\nfunction encodeValue(\n\twriter: CborWriter,\n\tvalue: unknown,\n\toptions: ResolvedCborOptions,\n\tdepth: number,\n\tancestors: Set<object>,\n): void {\n\tif (depth > options.maxDepth)\n\t\tthrow new CborError(`CBOR nesting depth exceeds configured limit of ${options.maxDepth}`);\n\n\tif (value === null) {\n\t\twriter.writeByte(0xf6);\n\t\treturn;\n\t}\n\tif (typeof value === \"boolean\") {\n\t\twriter.writeByte(value ? 0xf5 : 0xf4);\n\t\treturn;\n\t}\n\tif (typeof value === \"number\") {\n\t\tif (!Number.isFinite(value)) throw new CborError(\"CBOR numbers must be finite\");\n\t\tif (Number.isInteger(value) && !Object.is(value, -0)) {\n\t\t\tif (!Number.isSafeInteger(value)) throw new CborError(\"CBOR integers must be safe JavaScript integers\");\n\t\t\tif (value >= 0) writeArgument(writer, 0, value);\n\t\t\telse writeArgument(writer, 1, -1 - value);\n\t\t} else {\n\t\t\twriter.writeFloat64(value);\n\t\t}\n\t\treturn;\n\t}\n\tif (typeof value === \"string\") {\n\t\tencodeText(writer, value, options);\n\t\treturn;\n\t}\n\tif (value instanceof Uint8Array) {\n\t\tif (value.byteLength > options.maxByteLength) {\n\t\t\tthrow new CborError(`CBOR byte string length exceeds configured limit of ${options.maxByteLength}`);\n\t\t}\n\t\twriteArgument(writer, 2, value.byteLength);\n\t\twriter.writeBytes(value);\n\t\treturn;\n\t}\n\tif (Array.isArray(value)) {\n\t\tif (ancestors.has(value)) throw new CborError(\"CBOR values must not contain cycles\");\n\t\tif (value.length > options.maxContainerLength) {\n\t\t\tthrow new CborError(`CBOR array length exceeds configured limit of ${options.maxContainerLength}`);\n\t\t}\n\t\tancestors.add(value);\n\t\ttry {\n\t\t\twriteArgument(writer, 4, value.length);\n\t\t\tfor (let index = 0; index < value.length; index++) {\n\t\t\t\tif (!Object.hasOwn(value, index) || value[index] === undefined) {\n\t\t\t\t\tthrow new CborError(\"CBOR arrays must not contain holes or undefined values\");\n\t\t\t\t}\n\t\t\t\tencodeValue(writer, value[index], options, depth + 1, ancestors);\n\t\t\t}\n\t\t} finally {\n\t\t\tancestors.delete(value);\n\t\t}\n\t\treturn;\n\t}\n\tif (isPlainObject(value)) {\n\t\tif (ancestors.has(value)) throw new CborError(\"CBOR values must not contain cycles\");\n\t\tfor (const symbol of Object.getOwnPropertySymbols(value)) {\n\t\t\tif (Object.prototype.propertyIsEnumerable.call(value, symbol)) {\n\t\t\t\tthrow new CborError(\"CBOR map keys must be strings\");\n\t\t\t}\n\t\t}\n\t\tconst entries: Array<readonly [string, unknown]> = [];\n\t\tfor (const key of Object.keys(value)) {\n\t\t\tconst entryValue = value[key];\n\t\t\tif (entryValue !== undefined) entries.push([key, entryValue]);\n\t\t}\n\t\tif (entries.length > options.maxContainerLength) {\n\t\t\tthrow new CborError(`CBOR map length exceeds configured limit of ${options.maxContainerLength}`);\n\t\t}\n\t\tancestors.add(value);\n\t\ttry {\n\t\t\twriteArgument(writer, 5, entries.length);\n\t\t\tfor (const [key, entryValue] of entries) {\n\t\t\t\tencodeText(writer, key, options);\n\t\t\t\tencodeValue(writer, entryValue, options, depth + 1, ancestors);\n\t\t\t}\n\t\t} finally {\n\t\t\tancestors.delete(value);\n\t\t}\n\t\treturn;\n\t}\n\n\tthrow new CborError(`Unsupported CBOR value type: ${typeof value}`);\n}\n\n/** Encodes the protocol's strict, definite-length RFC 8949 subset. */\nexport function encodeCbor(value: unknown, options?: CborOptions): Uint8Array {\n\tconst resolved = resolveOptions(options);\n\tconst writer = new CborWriter(resolved.maxByteLength);\n\tencodeValue(writer, value, resolved, 0, new Set<object>());\n\treturn writer.finish();\n}\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/cbor/index.d.ts

@@ -0,0 +1,4 @@
+export { decodeCbor } from "./decoder.ts";
+export { encodeCbor } from "./encoder.ts";
+export { CborError, type CborOptions, DEFAULT_MAX_CBOR_BYTE_LENGTH, DEFAULT_MAX_CBOR_CONTAINER_LENGTH, DEFAULT_MAX_CBOR_DEPTH, } from "./options.ts";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@earendil-works/pi-protocol/dist/cbor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cbor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACN,SAAS,EACT,KAAK,WAAW,EAChB,4BAA4B,EAC5B,iCAAiC,EACjC,sBAAsB,GACtB,MAAM,cAAc,CAAC","sourcesContent":["export { decodeCbor } from \"./decoder.ts\";\nexport { encodeCbor } from \"./encoder.ts\";\nexport {\n\tCborError,\n\ttype CborOptions,\n\tDEFAULT_MAX_CBOR_BYTE_LENGTH,\n\tDEFAULT_MAX_CBOR_CONTAINER_LENGTH,\n\tDEFAULT_MAX_CBOR_DEPTH,\n} from \"./options.ts\";\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/cbor/index.js

@@ -0,0 +1,4 @@
+export { decodeCbor } from "./decoder.js";
+export { encodeCbor } from "./encoder.js";
+export { CborError, DEFAULT_MAX_CBOR_BYTE_LENGTH, DEFAULT_MAX_CBOR_CONTAINER_LENGTH, DEFAULT_MAX_CBOR_DEPTH, } from "./options.js";
+//# sourceMappingURL=index.js.map

package/node_modules/@earendil-works/pi-protocol/dist/cbor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cbor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACN,SAAS,EAET,4BAA4B,EAC5B,iCAAiC,EACjC,sBAAsB,GACtB,MAAM,cAAc,CAAC","sourcesContent":["export { decodeCbor } from \"./decoder.ts\";\nexport { encodeCbor } from \"./encoder.ts\";\nexport {\n\tCborError,\n\ttype CborOptions,\n\tDEFAULT_MAX_CBOR_BYTE_LENGTH,\n\tDEFAULT_MAX_CBOR_CONTAINER_LENGTH,\n\tDEFAULT_MAX_CBOR_DEPTH,\n} from \"./options.ts\";\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/cbor/options.d.ts

@@ -0,0 +1,26 @@
+export declare const UINT32_BASE = 4294967296;
+export declare const MAX_UINT32 = 4294967295;
+/** Safe defaults for untrusted protocol payloads. */
+export declare const DEFAULT_MAX_CBOR_BYTE_LENGTH: number;
+export declare const DEFAULT_MAX_CBOR_CONTAINER_LENGTH = 1000000;
+export declare const DEFAULT_MAX_CBOR_DEPTH = 64;
+export interface CborOptions {
+    /** Maximum encoded input/output bytes and maximum byte/text string length. */
+    maxByteLength?: number;
+    /** Maximum number of elements in an array or entries in a map. */
+    maxContainerLength?: number;
+    /** Maximum recursive item depth. */
+    maxDepth?: number;
+}
+export interface ResolvedCborOptions {
+    maxByteLength: number;
+    maxContainerLength: number;
+    maxDepth: number;
+}
+export declare class CborError extends Error {
+    constructor(message: string);
+}
+export declare const textEncoder: import("util").TextEncoder;
+export declare const textDecoder: import("util").TextDecoder;
+export declare function resolveOptions(options: CborOptions | undefined): ResolvedCborOptions;
+//# sourceMappingURL=options.d.ts.map

package/node_modules/@earendil-works/pi-protocol/dist/cbor/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/cbor/options.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,aAAgB,CAAC;AACzC,eAAO,MAAM,UAAU,aAAc,CAAC;AAGtC,qDAAqD;AACrD,eAAO,MAAM,4BAA4B,QAAmB,CAAC;AAC7D,eAAO,MAAM,iCAAiC,UAAY,CAAC;AAC3D,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC3B,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,SAAU,SAAQ,KAAK;IACnC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,eAAO,MAAM,WAAW,4BAAoB,CAAC;AAC7C,eAAO,MAAM,WAAW,4BAA6D,CAAC;AAStF,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,mBAAmB,CAUpF","sourcesContent":["export const UINT32_BASE = 0x1_0000_0000;\nexport const MAX_UINT32 = 0xffff_ffff;\nconst MAX_CONFIGURED_DEPTH = 512;\n\n/** Safe defaults for untrusted protocol payloads. */\nexport const DEFAULT_MAX_CBOR_BYTE_LENGTH = 16 * 1024 * 1024;\nexport const DEFAULT_MAX_CBOR_CONTAINER_LENGTH = 1_000_000;\nexport const DEFAULT_MAX_CBOR_DEPTH = 64;\n\nexport interface CborOptions {\n\t/** Maximum encoded input/output bytes and maximum byte/text string length. */\n\tmaxByteLength?: number;\n\t/** Maximum number of elements in an array or entries in a map. */\n\tmaxContainerLength?: number;\n\t/** Maximum recursive item depth. */\n\tmaxDepth?: number;\n}\n\nexport interface ResolvedCborOptions {\n\tmaxByteLength: number;\n\tmaxContainerLength: number;\n\tmaxDepth: number;\n}\n\nexport class CborError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"CborError\";\n\t}\n}\n\nexport const textEncoder = new TextEncoder();\nexport const textDecoder = new TextDecoder(\"utf-8\", { fatal: true, ignoreBOM: true });\n\nfunction resolveLimit(name: string, value: number, maximum: number): number {\n\tif (!Number.isSafeInteger(value) || value < 0 || value > maximum) {\n\t\tthrow new RangeError(`${name} must be an integer between 0 and ${maximum}`);\n\t}\n\treturn value;\n}\n\nexport function resolveOptions(options: CborOptions | undefined): ResolvedCborOptions {\n\treturn {\n\t\tmaxByteLength: resolveLimit(\"maxByteLength\", options?.maxByteLength ?? DEFAULT_MAX_CBOR_BYTE_LENGTH, MAX_UINT32),\n\t\tmaxContainerLength: resolveLimit(\n\t\t\t\"maxContainerLength\",\n\t\t\toptions?.maxContainerLength ?? DEFAULT_MAX_CBOR_CONTAINER_LENGTH,\n\t\t\tMAX_UINT32,\n\t\t),\n\t\tmaxDepth: resolveLimit(\"maxDepth\", options?.maxDepth ?? DEFAULT_MAX_CBOR_DEPTH, MAX_CONFIGURED_DEPTH),\n\t};\n}\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/cbor/options.js

@@ -0,0 +1,29 @@
+export const UINT32_BASE = 0x1_0000_0000;
+export const MAX_UINT32 = 0xffff_ffff;
+const MAX_CONFIGURED_DEPTH = 512;
+/** Safe defaults for untrusted protocol payloads. */
+export const DEFAULT_MAX_CBOR_BYTE_LENGTH = 16 * 1024 * 1024;
+export const DEFAULT_MAX_CBOR_CONTAINER_LENGTH = 1_000_000;
+export const DEFAULT_MAX_CBOR_DEPTH = 64;
+export class CborError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CborError";
+    }
+}
+export const textEncoder = new TextEncoder();
+export const textDecoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+function resolveLimit(name, value, maximum) {
+    if (!Number.isSafeInteger(value) || value < 0 || value > maximum) {
+        throw new RangeError(`${name} must be an integer between 0 and ${maximum}`);
+    }
+    return value;
+}
+export function resolveOptions(options) {
+    return {
+        maxByteLength: resolveLimit("maxByteLength", options?.maxByteLength ?? DEFAULT_MAX_CBOR_BYTE_LENGTH, MAX_UINT32),
+        maxContainerLength: resolveLimit("maxContainerLength", options?.maxContainerLength ?? DEFAULT_MAX_CBOR_CONTAINER_LENGTH, MAX_UINT32),
+        maxDepth: resolveLimit("maxDepth", options?.maxDepth ?? DEFAULT_MAX_CBOR_DEPTH, MAX_CONFIGURED_DEPTH),
+    };
+}
+//# sourceMappingURL=options.js.map

package/node_modules/@earendil-works/pi-protocol/dist/cbor/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/cbor/options.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;AACtC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,qDAAqD;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7D,MAAM,CAAC,MAAM,iCAAiC,GAAG,SAAS,CAAC;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAiBzC,MAAM,OAAO,SAAU,SAAQ,KAAK;IACnC,YAAY,OAAe,EAAE;QAC5B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAAA,CACxB;CACD;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAEtF,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa,EAAE,OAAe,EAAU;IAC3E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QAClE,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,qCAAqC,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACb;AAED,MAAM,UAAU,cAAc,CAAC,OAAgC,EAAuB;IACrF,OAAO;QACN,aAAa,EAAE,YAAY,CAAC,eAAe,EAAE,OAAO,EAAE,aAAa,IAAI,4BAA4B,EAAE,UAAU,CAAC;QAChH,kBAAkB,EAAE,YAAY,CAC/B,oBAAoB,EACpB,OAAO,EAAE,kBAAkB,IAAI,iCAAiC,EAChE,UAAU,CACV;QACD,QAAQ,EAAE,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,oBAAoB,CAAC;KACrG,CAAC;AAAA,CACF","sourcesContent":["export const UINT32_BASE = 0x1_0000_0000;\nexport const MAX_UINT32 = 0xffff_ffff;\nconst MAX_CONFIGURED_DEPTH = 512;\n\n/** Safe defaults for untrusted protocol payloads. */\nexport const DEFAULT_MAX_CBOR_BYTE_LENGTH = 16 * 1024 * 1024;\nexport const DEFAULT_MAX_CBOR_CONTAINER_LENGTH = 1_000_000;\nexport const DEFAULT_MAX_CBOR_DEPTH = 64;\n\nexport interface CborOptions {\n\t/** Maximum encoded input/output bytes and maximum byte/text string length. */\n\tmaxByteLength?: number;\n\t/** Maximum number of elements in an array or entries in a map. */\n\tmaxContainerLength?: number;\n\t/** Maximum recursive item depth. */\n\tmaxDepth?: number;\n}\n\nexport interface ResolvedCborOptions {\n\tmaxByteLength: number;\n\tmaxContainerLength: number;\n\tmaxDepth: number;\n}\n\nexport class CborError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"CborError\";\n\t}\n}\n\nexport const textEncoder = new TextEncoder();\nexport const textDecoder = new TextDecoder(\"utf-8\", { fatal: true, ignoreBOM: true });\n\nfunction resolveLimit(name: string, value: number, maximum: number): number {\n\tif (!Number.isSafeInteger(value) || value < 0 || value > maximum) {\n\t\tthrow new RangeError(`${name} must be an integer between 0 and ${maximum}`);\n\t}\n\treturn value;\n}\n\nexport function resolveOptions(options: CborOptions | undefined): ResolvedCborOptions {\n\treturn {\n\t\tmaxByteLength: resolveLimit(\"maxByteLength\", options?.maxByteLength ?? DEFAULT_MAX_CBOR_BYTE_LENGTH, MAX_UINT32),\n\t\tmaxContainerLength: resolveLimit(\n\t\t\t\"maxContainerLength\",\n\t\t\toptions?.maxContainerLength ?? DEFAULT_MAX_CBOR_CONTAINER_LENGTH,\n\t\t\tMAX_UINT32,\n\t\t),\n\t\tmaxDepth: resolveLimit(\"maxDepth\", options?.maxDepth ?? DEFAULT_MAX_CBOR_DEPTH, MAX_CONFIGURED_DEPTH),\n\t};\n}\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/codec.d.ts

@@ -0,0 +1,29 @@
+import { type FrameDecoderOptions } from "./framing.ts";
+import { type ClientMessage, PROTOCOL_VERSION, type ServerMessage } from "./schemas.ts";
+export declare class ProtocolValidationError extends Error {
+    constructor(message: string, _value?: unknown);
+}
+export declare function parseClientMessage(value: unknown): ClientMessage;
+export declare function parseServerMessage(value: unknown): ServerMessage;
+/** Validates and encodes one complete length-prefixed client message. */
+export declare function encodeClientMessage(message: ClientMessage, options?: FrameDecoderOptions): Uint8Array;
+/** Validates and encodes one complete length-prefixed server message. */
+export declare function encodeServerMessage(message: ServerMessage, options?: FrameDecoderOptions): Uint8Array;
+/** Incrementally decodes and validates framed client messages. */
+export declare class ClientMessageDecoder {
+    private readonly decoder;
+    constructor(options?: FrameDecoderOptions);
+    push(chunk: Uint8Array): ClientMessage[];
+    end(): void;
+}
+/** Incrementally decodes and validates framed server messages. */
+export declare class ServerMessageDecoder {
+    private readonly decoder;
+    constructor(options?: FrameDecoderOptions);
+    push(chunk: Uint8Array): ServerMessage[];
+    end(): void;
+}
+export declare function createClientMessageDecoder(options?: FrameDecoderOptions): ClientMessageDecoder;
+export declare function createServerMessageDecoder(options?: FrameDecoderOptions): ServerMessageDecoder;
+export declare function isSupportedProtocolVersion(version: number): version is typeof PROTOCOL_VERSION;
+//# sourceMappingURL=codec.d.ts.map

package/node_modules/@earendil-works/pi-protocol/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAEA,OAAO,EAKN,KAAK,mBAAmB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,KAAK,aAAa,EAElB,gBAAgB,EAChB,KAAK,aAAa,EAElB,MAAM,cAAc,CAAC;AAEtB,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAG5C;CACD;AAkBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAKhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAKhE;AAyBD,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,UAAU,CAErG;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,UAAU,CAErG;AA0CD,kEAAkE;AAClE,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,YAAY,OAAO,CAAC,EAAE,mBAAmB,EAExC;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,EAAE,CAEvC;IAED,GAAG,IAAI,IAAI,CAEV;CACD;AAED,kEAAkE;AAClE,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,YAAY,OAAO,CAAC,EAAE,mBAAmB,EAExC;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,EAAE,CAEvC;IAED,GAAG,IAAI,IAAI,CAEV;CACD;AAED,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAE9F;AAED,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAE9F;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,OAAO,gBAAgB,CAE9F","sourcesContent":["import { Check } from \"typebox/value\";\nimport { decodeCbor, encodeCbor } from \"./cbor/index.ts\";\nimport {\n\tassertCompleteFrame,\n\tDEFAULT_MAX_FRAME_LENGTH,\n\tencodeFrame,\n\tFrameDecoder,\n\ttype FrameDecoderOptions,\n} from \"./framing.ts\";\nimport {\n\ttype ClientMessage,\n\tClientMessageSchema,\n\tPROTOCOL_VERSION,\n\ttype ServerMessage,\n\tServerMessageSchema,\n} from \"./schemas.ts\";\n\nexport class ProtocolValidationError extends Error {\n\tconstructor(message: string, _value?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"ProtocolValidationError\";\n\t}\n}\n\nfunction isProtocolValue(value: unknown, optionalProperty = false, ancestors = new Set<object>()): boolean {\n\tif (value === undefined) return optionalProperty;\n\tif (value === null || typeof value === \"boolean\" || typeof value === \"number\" || typeof value === \"string\") {\n\t\treturn true;\n\t}\n\tif (typeof value !== \"object\" || ancestors.has(value)) return false;\n\tancestors.add(value);\n\ttry {\n\t\tif (Array.isArray(value)) return value.every((item) => isProtocolValue(item, false, ancestors));\n\t\tif (Object.getPrototypeOf(value) !== Object.prototype) return false;\n\t\treturn Object.values(value).every((item) => isProtocolValue(item, true, ancestors));\n\t} finally {\n\t\tancestors.delete(value);\n\t}\n}\n\nexport function parseClientMessage(value: unknown): ClientMessage {\n\tif (!isProtocolValue(value) || !Check(ClientMessageSchema, value)) {\n\t\tthrow new ProtocolValidationError(\"Invalid client protocol message\");\n\t}\n\treturn value;\n}\n\nexport function parseServerMessage(value: unknown): ServerMessage {\n\tif (!isProtocolValue(value) || !Check(ServerMessageSchema, value)) {\n\t\tthrow new ProtocolValidationError(\"Invalid server protocol message\");\n\t}\n\treturn value;\n}\n\nfunction boundedErrorMessage(error: unknown): string {\n\tif (!(error instanceof Error)) return \"Unknown codec error\";\n\treturn error.message.length <= 500 ? error.message : `${error.message.slice(0, 497)}...`;\n}\n\nfunction encodeProtocolMessage<T>(\n\tvalue: T,\n\tparse: (candidate: unknown) => T,\n\tkind: string,\n\toptions?: FrameDecoderOptions,\n): Uint8Array {\n\tconst validated = parse(value);\n\ttry {\n\t\tconst maxFrameLength = options?.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;\n\t\tconst frame = encodeFrame(encodeCbor(validated, { maxByteLength: maxFrameLength }));\n\t\tassertCompleteFrame(frame, { maxFrameLength });\n\t\treturn frame;\n\t} catch (error) {\n\t\tif (error instanceof ProtocolValidationError) throw error;\n\t\tthrow new ProtocolValidationError(`Unable to encode ${kind} protocol message: ${boundedErrorMessage(error)}`);\n\t}\n}\n\n/** Validates and encodes one complete length-prefixed client message. */\nexport function encodeClientMessage(message: ClientMessage, options?: FrameDecoderOptions): Uint8Array {\n\treturn encodeProtocolMessage(message, parseClientMessage, \"client\", options);\n}\n\n/** Validates and encodes one complete length-prefixed server message. */\nexport function encodeServerMessage(message: ServerMessage, options?: FrameDecoderOptions): Uint8Array {\n\treturn encodeProtocolMessage(message, parseServerMessage, \"server\", options);\n}\n\nclass ValidatedMessageDecoder<T> {\n\tprivate failed = false;\n\tprivate readonly frames: FrameDecoder;\n\tprivate readonly kind: string;\n\tprivate readonly maxFrameLength: number;\n\tprivate readonly parse: (candidate: unknown) => T;\n\n\tconstructor(kind: string, parse: (candidate: unknown) => T, options?: FrameDecoderOptions) {\n\t\tthis.frames = new FrameDecoder(options);\n\t\tthis.kind = kind;\n\t\tthis.maxFrameLength = options?.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;\n\t\tthis.parse = parse;\n\t}\n\n\tpush(chunk: Uint8Array): T[] {\n\t\tif (this.failed) throw new ProtocolValidationError(`${this.kind} message decoder has failed`);\n\t\ttry {\n\t\t\tconst messages: T[] = [];\n\t\t\tfor (const frame of this.frames.push(chunk)) {\n\t\t\t\tmessages.push(this.parse(decodeCbor(frame, { maxByteLength: this.maxFrameLength })));\n\t\t\t}\n\t\t\treturn messages;\n\t\t} catch (error) {\n\t\t\tthis.failed = true;\n\t\t\tif (error instanceof ProtocolValidationError) throw error;\n\t\t\tthrow new ProtocolValidationError(`Invalid ${this.kind} protocol frame: ${boundedErrorMessage(error)}`);\n\t\t}\n\t}\n\n\tend(): void {\n\t\tif (this.failed) throw new ProtocolValidationError(`${this.kind} message decoder has failed`);\n\t\ttry {\n\t\t\tthis.frames.end();\n\t\t} catch (error) {\n\t\t\tthis.failed = true;\n\t\t\tthrow new ProtocolValidationError(`Invalid ${this.kind} protocol framing: ${boundedErrorMessage(error)}`);\n\t\t}\n\t}\n}\n\n/** Incrementally decodes and validates framed client messages. */\nexport class ClientMessageDecoder {\n\tprivate readonly decoder: ValidatedMessageDecoder<ClientMessage>;\n\n\tconstructor(options?: FrameDecoderOptions) {\n\t\tthis.decoder = new ValidatedMessageDecoder(\"client\", parseClientMessage, options);\n\t}\n\n\tpush(chunk: Uint8Array): ClientMessage[] {\n\t\treturn this.decoder.push(chunk);\n\t}\n\n\tend(): void {\n\t\tthis.decoder.end();\n\t}\n}\n\n/** Incrementally decodes and validates framed server messages. */\nexport class ServerMessageDecoder {\n\tprivate readonly decoder: ValidatedMessageDecoder<ServerMessage>;\n\n\tconstructor(options?: FrameDecoderOptions) {\n\t\tthis.decoder = new ValidatedMessageDecoder(\"server\", parseServerMessage, options);\n\t}\n\n\tpush(chunk: Uint8Array): ServerMessage[] {\n\t\treturn this.decoder.push(chunk);\n\t}\n\n\tend(): void {\n\t\tthis.decoder.end();\n\t}\n}\n\nexport function createClientMessageDecoder(options?: FrameDecoderOptions): ClientMessageDecoder {\n\treturn new ClientMessageDecoder(options);\n}\n\nexport function createServerMessageDecoder(options?: FrameDecoderOptions): ServerMessageDecoder {\n\treturn new ServerMessageDecoder(options);\n}\n\nexport function isSupportedProtocolVersion(version: number): version is typeof PROTOCOL_VERSION {\n\treturn Number.isInteger(version) && version === PROTOCOL_VERSION;\n}\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/codec.js

@@ -0,0 +1,146 @@
+import { Check } from "typebox/value";
+import { decodeCbor, encodeCbor } from "./cbor/index.js";
+import { assertCompleteFrame, DEFAULT_MAX_FRAME_LENGTH, encodeFrame, FrameDecoder, } from "./framing.js";
+import { ClientMessageSchema, PROTOCOL_VERSION, ServerMessageSchema, } from "./schemas.js";
+export class ProtocolValidationError extends Error {
+    constructor(message, _value) {
+        super(message);
+        this.name = "ProtocolValidationError";
+    }
+}
+function isProtocolValue(value, optionalProperty = false, ancestors = new Set()) {
+    if (value === undefined)
+        return optionalProperty;
+    if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") {
+        return true;
+    }
+    if (typeof value !== "object" || ancestors.has(value))
+        return false;
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value))
+            return value.every((item) => isProtocolValue(item, false, ancestors));
+        if (Object.getPrototypeOf(value) !== Object.prototype)
+            return false;
+        return Object.values(value).every((item) => isProtocolValue(item, true, ancestors));
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+export function parseClientMessage(value) {
+    if (!isProtocolValue(value) || !Check(ClientMessageSchema, value)) {
+        throw new ProtocolValidationError("Invalid client protocol message");
+    }
+    return value;
+}
+export function parseServerMessage(value) {
+    if (!isProtocolValue(value) || !Check(ServerMessageSchema, value)) {
+        throw new ProtocolValidationError("Invalid server protocol message");
+    }
+    return value;
+}
+function boundedErrorMessage(error) {
+    if (!(error instanceof Error))
+        return "Unknown codec error";
+    return error.message.length <= 500 ? error.message : `${error.message.slice(0, 497)}...`;
+}
+function encodeProtocolMessage(value, parse, kind, options) {
+    const validated = parse(value);
+    try {
+        const maxFrameLength = options?.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;
+        const frame = encodeFrame(encodeCbor(validated, { maxByteLength: maxFrameLength }));
+        assertCompleteFrame(frame, { maxFrameLength });
+        return frame;
+    }
+    catch (error) {
+        if (error instanceof ProtocolValidationError)
+            throw error;
+        throw new ProtocolValidationError(`Unable to encode ${kind} protocol message: ${boundedErrorMessage(error)}`);
+    }
+}
+/** Validates and encodes one complete length-prefixed client message. */
+export function encodeClientMessage(message, options) {
+    return encodeProtocolMessage(message, parseClientMessage, "client", options);
+}
+/** Validates and encodes one complete length-prefixed server message. */
+export function encodeServerMessage(message, options) {
+    return encodeProtocolMessage(message, parseServerMessage, "server", options);
+}
+class ValidatedMessageDecoder {
+    failed = false;
+    frames;
+    kind;
+    maxFrameLength;
+    parse;
+    constructor(kind, parse, options) {
+        this.frames = new FrameDecoder(options);
+        this.kind = kind;
+        this.maxFrameLength = options?.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;
+        this.parse = parse;
+    }
+    push(chunk) {
+        if (this.failed)
+            throw new ProtocolValidationError(`${this.kind} message decoder has failed`);
+        try {
+            const messages = [];
+            for (const frame of this.frames.push(chunk)) {
+                messages.push(this.parse(decodeCbor(frame, { maxByteLength: this.maxFrameLength })));
+            }
+            return messages;
+        }
+        catch (error) {
+            this.failed = true;
+            if (error instanceof ProtocolValidationError)
+                throw error;
+            throw new ProtocolValidationError(`Invalid ${this.kind} protocol frame: ${boundedErrorMessage(error)}`);
+        }
+    }
+    end() {
+        if (this.failed)
+            throw new ProtocolValidationError(`${this.kind} message decoder has failed`);
+        try {
+            this.frames.end();
+        }
+        catch (error) {
+            this.failed = true;
+            throw new ProtocolValidationError(`Invalid ${this.kind} protocol framing: ${boundedErrorMessage(error)}`);
+        }
+    }
+}
+/** Incrementally decodes and validates framed client messages. */
+export class ClientMessageDecoder {
+    decoder;
+    constructor(options) {
+        this.decoder = new ValidatedMessageDecoder("client", parseClientMessage, options);
+    }
+    push(chunk) {
+        return this.decoder.push(chunk);
+    }
+    end() {
+        this.decoder.end();
+    }
+}
+/** Incrementally decodes and validates framed server messages. */
+export class ServerMessageDecoder {
+    decoder;
+    constructor(options) {
+        this.decoder = new ValidatedMessageDecoder("server", parseServerMessage, options);
+    }
+    push(chunk) {
+        return this.decoder.push(chunk);
+    }
+    end() {
+        this.decoder.end();
+    }
+}
+export function createClientMessageDecoder(options) {
+    return new ClientMessageDecoder(options);
+}
+export function createServerMessageDecoder(options) {
+    return new ServerMessageDecoder(options);
+}
+export function isSupportedProtocolVersion(version) {
+    return Number.isInteger(version) && version === PROTOCOL_VERSION;
+}
+//# sourceMappingURL=codec.js.map

package/node_modules/@earendil-works/pi-protocol/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"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","sourcesContent":["import { Check } from \"typebox/value\";\nimport { decodeCbor, encodeCbor } from \"./cbor/index.ts\";\nimport {\n\tassertCompleteFrame,\n\tDEFAULT_MAX_FRAME_LENGTH,\n\tencodeFrame,\n\tFrameDecoder,\n\ttype FrameDecoderOptions,\n} from \"./framing.ts\";\nimport {\n\ttype ClientMessage,\n\tClientMessageSchema,\n\tPROTOCOL_VERSION,\n\ttype ServerMessage,\n\tServerMessageSchema,\n} from \"./schemas.ts\";\n\nexport class ProtocolValidationError extends Error {\n\tconstructor(message: string, _value?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"ProtocolValidationError\";\n\t}\n}\n\nfunction isProtocolValue(value: unknown, optionalProperty = false, ancestors = new Set<object>()): boolean {\n\tif (value === undefined) return optionalProperty;\n\tif (value === null || typeof value === \"boolean\" || typeof value === \"number\" || typeof value === \"string\") {\n\t\treturn true;\n\t}\n\tif (typeof value !== \"object\" || ancestors.has(value)) return false;\n\tancestors.add(value);\n\ttry {\n\t\tif (Array.isArray(value)) return value.every((item) => isProtocolValue(item, false, ancestors));\n\t\tif (Object.getPrototypeOf(value) !== Object.prototype) return false;\n\t\treturn Object.values(value).every((item) => isProtocolValue(item, true, ancestors));\n\t} finally {\n\t\tancestors.delete(value);\n\t}\n}\n\nexport function parseClientMessage(value: unknown): ClientMessage {\n\tif (!isProtocolValue(value) || !Check(ClientMessageSchema, value)) {\n\t\tthrow new ProtocolValidationError(\"Invalid client protocol message\");\n\t}\n\treturn value;\n}\n\nexport function parseServerMessage(value: unknown): ServerMessage {\n\tif (!isProtocolValue(value) || !Check(ServerMessageSchema, value)) {\n\t\tthrow new ProtocolValidationError(\"Invalid server protocol message\");\n\t}\n\treturn value;\n}\n\nfunction boundedErrorMessage(error: unknown): string {\n\tif (!(error instanceof Error)) return \"Unknown codec error\";\n\treturn error.message.length <= 500 ? error.message : `${error.message.slice(0, 497)}...`;\n}\n\nfunction encodeProtocolMessage<T>(\n\tvalue: T,\n\tparse: (candidate: unknown) => T,\n\tkind: string,\n\toptions?: FrameDecoderOptions,\n): Uint8Array {\n\tconst validated = parse(value);\n\ttry {\n\t\tconst maxFrameLength = options?.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;\n\t\tconst frame = encodeFrame(encodeCbor(validated, { maxByteLength: maxFrameLength }));\n\t\tassertCompleteFrame(frame, { maxFrameLength });\n\t\treturn frame;\n\t} catch (error) {\n\t\tif (error instanceof ProtocolValidationError) throw error;\n\t\tthrow new ProtocolValidationError(`Unable to encode ${kind} protocol message: ${boundedErrorMessage(error)}`);\n\t}\n}\n\n/** Validates and encodes one complete length-prefixed client message. */\nexport function encodeClientMessage(message: ClientMessage, options?: FrameDecoderOptions): Uint8Array {\n\treturn encodeProtocolMessage(message, parseClientMessage, \"client\", options);\n}\n\n/** Validates and encodes one complete length-prefixed server message. */\nexport function encodeServerMessage(message: ServerMessage, options?: FrameDecoderOptions): Uint8Array {\n\treturn encodeProtocolMessage(message, parseServerMessage, \"server\", options);\n}\n\nclass ValidatedMessageDecoder<T> {\n\tprivate failed = false;\n\tprivate readonly frames: FrameDecoder;\n\tprivate readonly kind: string;\n\tprivate readonly maxFrameLength: number;\n\tprivate readonly parse: (candidate: unknown) => T;\n\n\tconstructor(kind: string, parse: (candidate: unknown) => T, options?: FrameDecoderOptions) {\n\t\tthis.frames = new FrameDecoder(options);\n\t\tthis.kind = kind;\n\t\tthis.maxFrameLength = options?.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;\n\t\tthis.parse = parse;\n\t}\n\n\tpush(chunk: Uint8Array): T[] {\n\t\tif (this.failed) throw new ProtocolValidationError(`${this.kind} message decoder has failed`);\n\t\ttry {\n\t\t\tconst messages: T[] = [];\n\t\t\tfor (const frame of this.frames.push(chunk)) {\n\t\t\t\tmessages.push(this.parse(decodeCbor(frame, { maxByteLength: this.maxFrameLength })));\n\t\t\t}\n\t\t\treturn messages;\n\t\t} catch (error) {\n\t\t\tthis.failed = true;\n\t\t\tif (error instanceof ProtocolValidationError) throw error;\n\t\t\tthrow new ProtocolValidationError(`Invalid ${this.kind} protocol frame: ${boundedErrorMessage(error)}`);\n\t\t}\n\t}\n\n\tend(): void {\n\t\tif (this.failed) throw new ProtocolValidationError(`${this.kind} message decoder has failed`);\n\t\ttry {\n\t\t\tthis.frames.end();\n\t\t} catch (error) {\n\t\t\tthis.failed = true;\n\t\t\tthrow new ProtocolValidationError(`Invalid ${this.kind} protocol framing: ${boundedErrorMessage(error)}`);\n\t\t}\n\t}\n}\n\n/** Incrementally decodes and validates framed client messages. */\nexport class ClientMessageDecoder {\n\tprivate readonly decoder: ValidatedMessageDecoder<ClientMessage>;\n\n\tconstructor(options?: FrameDecoderOptions) {\n\t\tthis.decoder = new ValidatedMessageDecoder(\"client\", parseClientMessage, options);\n\t}\n\n\tpush(chunk: Uint8Array): ClientMessage[] {\n\t\treturn this.decoder.push(chunk);\n\t}\n\n\tend(): void {\n\t\tthis.decoder.end();\n\t}\n}\n\n/** Incrementally decodes and validates framed server messages. */\nexport class ServerMessageDecoder {\n\tprivate readonly decoder: ValidatedMessageDecoder<ServerMessage>;\n\n\tconstructor(options?: FrameDecoderOptions) {\n\t\tthis.decoder = new ValidatedMessageDecoder(\"server\", parseServerMessage, options);\n\t}\n\n\tpush(chunk: Uint8Array): ServerMessage[] {\n\t\treturn this.decoder.push(chunk);\n\t}\n\n\tend(): void {\n\t\tthis.decoder.end();\n\t}\n}\n\nexport function createClientMessageDecoder(options?: FrameDecoderOptions): ClientMessageDecoder {\n\treturn new ClientMessageDecoder(options);\n}\n\nexport function createServerMessageDecoder(options?: FrameDecoderOptions): ServerMessageDecoder {\n\treturn new ServerMessageDecoder(options);\n}\n\nexport function isSupportedProtocolVersion(version: number): version is typeof PROTOCOL_VERSION {\n\treturn Number.isInteger(version) && version === PROTOCOL_VERSION;\n}\n"]}

package/node_modules/@earendil-works/pi-protocol/dist/framing.d.ts

@@ -0,0 +1,29 @@
+/** Default upper bound for one framed CBOR payload. */
+export declare const DEFAULT_MAX_FRAME_LENGTH: number;
+export interface FrameDecoderOptions {
+    maxFrameLength?: number;
+}
+export declare class FrameError extends Error {
+    constructor(message: string);
+}
+/** Prefixes a payload with its unsigned 32-bit big-endian byte length. */
+export declare function encodeFrame(payload: Uint8Array): Uint8Array;
+/** Validates that bytes contain exactly one complete frame within the configured limit. */
+export declare function assertCompleteFrame(frame: Uint8Array, options?: FrameDecoderOptions): void;
+/** Incrementally splits arbitrary byte chunks into length-prefixed payloads. */
+export declare class FrameDecoder {
+    private readonly header;
+    private headerLength;
+    private readonly maxFrameLength;
+    private payloadBlocks;
+    private currentPayloadBlock;
+    private currentPayloadBlockLength;
+    private expectedPayloadLength;
+    private payloadLength;
+    private state;
+    constructor(options?: FrameDecoderOptions);
+    push(chunk: Uint8Array): Uint8Array[];
+    end(): void;
+    private fail;
+}
+//# sourceMappingURL=framing.d.ts.map

package/node_modules/@earendil-works/pi-protocol/dist/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../src/framing.ts"],"names":[],"mappings":"AAIA,uDAAuD;AACvD,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAW,SAAQ,KAAK;IACpC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAUD,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAW3D;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAW1F;AAID,gFAAgF;AAChF,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,mBAAmB,CAAyB;IACpD,OAAO,CAAC,yBAAyB,CAAK;IACtC,OAAO,CAAC,qBAAqB,CAAqB;IAClD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAwB;IAErC,YAAY,OAAO,CAAC,EAAE,mBAAmB,EAExC;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,CAuEpC;IAED,GAAG,IAAI,IAAI,CAOV;IAED,OAAO,CAAC,IAAI;CAUZ","sourcesContent":["const FRAME_HEADER_LENGTH = 4;\nconst MAX_UINT32 = 0xffff_ffff;\nconst PAYLOAD_BLOCK_SIZE = 64 * 1024;\n\n/** Default upper bound for one framed CBOR payload. */\nexport const DEFAULT_MAX_FRAME_LENGTH = 16 * 1024 * 1024;\n\nexport interface FrameDecoderOptions {\n\tmaxFrameLength?: number;\n}\n\nexport class FrameError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"FrameError\";\n\t}\n}\n\nfunction resolveMaxFrameLength(options: FrameDecoderOptions | undefined): number {\n\tconst value = options?.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;\n\tif (!Number.isSafeInteger(value) || value < 0 || value > MAX_UINT32) {\n\t\tthrow new RangeError(`maxFrameLength must be an integer between 0 and ${MAX_UINT32}`);\n\t}\n\treturn value;\n}\n\n/** Prefixes a payload with its unsigned 32-bit big-endian byte length. */\nexport function encodeFrame(payload: Uint8Array): Uint8Array {\n\tif (!(payload instanceof Uint8Array)) throw new TypeError(\"Frame payload must be a Uint8Array\");\n\tif (payload.byteLength > MAX_UINT32) throw new RangeError(\"Frame payload exceeds the unsigned 32-bit length limit\");\n\tconst frame = new Uint8Array(FRAME_HEADER_LENGTH + payload.byteLength);\n\tconst length = payload.byteLength;\n\tframe[0] = length >>> 24;\n\tframe[1] = length >>> 16;\n\tframe[2] = length >>> 8;\n\tframe[3] = length;\n\tframe.set(payload, FRAME_HEADER_LENGTH);\n\treturn frame;\n}\n\n/** Validates that bytes contain exactly one complete frame within the configured limit. */\nexport function assertCompleteFrame(frame: Uint8Array, options?: FrameDecoderOptions): void {\n\tif (!(frame instanceof Uint8Array)) throw new TypeError(\"Frame must be a Uint8Array\");\n\tif (frame.byteLength < FRAME_HEADER_LENGTH) throw new FrameError(\"Frame does not contain a complete length prefix\");\n\tconst length = frame[0]! * 0x1_000_000 + frame[1]! * 0x1_0000 + frame[2]! * 0x100 + frame[3]!;\n\tconst maxFrameLength = resolveMaxFrameLength(options);\n\tif (length > maxFrameLength) {\n\t\tthrow new FrameError(`Frame length ${length} exceeds configured limit of ${maxFrameLength}`);\n\t}\n\tif (frame.byteLength !== FRAME_HEADER_LENGTH + length) {\n\t\tthrow new FrameError(\"Frame must contain exactly one complete payload\");\n\t}\n}\n\ntype DecoderState = \"open\" | \"ended\" | \"failed\";\n\n/** Incrementally splits arbitrary byte chunks into length-prefixed payloads. */\nexport class FrameDecoder {\n\tprivate readonly header = new Uint8Array(FRAME_HEADER_LENGTH);\n\tprivate headerLength = 0;\n\tprivate readonly maxFrameLength: number;\n\tprivate payloadBlocks: Uint8Array[] = [];\n\tprivate currentPayloadBlock: Uint8Array | undefined;\n\tprivate currentPayloadBlockLength = 0;\n\tprivate expectedPayloadLength: number | undefined;\n\tprivate payloadLength = 0;\n\tprivate state: DecoderState = \"open\";\n\n\tconstructor(options?: FrameDecoderOptions) {\n\t\tthis.maxFrameLength = resolveMaxFrameLength(options);\n\t}\n\n\tpush(chunk: Uint8Array): Uint8Array[] {\n\t\tif (this.state === \"ended\") throw new FrameError(\"Frame decoder has ended\");\n\t\tif (this.state === \"failed\") throw new FrameError(\"Frame decoder has failed\");\n\t\tif (!(chunk instanceof Uint8Array)) throw new TypeError(\"Frame chunk must be a Uint8Array\");\n\n\t\tconst frames: Uint8Array[] = [];\n\t\tlet chunkOffset = 0;\n\t\twhile (chunkOffset < chunk.byteLength) {\n\t\t\tif (this.expectedPayloadLength === undefined) {\n\t\t\t\tconst headerBytes = Math.min(FRAME_HEADER_LENGTH - this.headerLength, chunk.byteLength - chunkOffset);\n\t\t\t\tthis.header.set(chunk.subarray(chunkOffset, chunkOffset + headerBytes), this.headerLength);\n\t\t\t\tthis.headerLength += headerBytes;\n\t\t\t\tchunkOffset += headerBytes;\n\t\t\t\tif (this.headerLength < FRAME_HEADER_LENGTH) continue;\n\n\t\t\t\tconst frameLength =\n\t\t\t\t\tthis.header[0]! * 0x1_000_000 + this.header[1]! * 0x1_0000 + this.header[2]! * 0x100 + this.header[3]!;\n\t\t\t\tthis.headerLength = 0;\n\t\t\t\tif (frameLength > this.maxFrameLength) {\n\t\t\t\t\tthis.fail(`Frame length ${frameLength} exceeds configured limit of ${this.maxFrameLength}`);\n\t\t\t\t}\n\t\t\t\tif (frameLength === 0) {\n\t\t\t\t\tframes.push(new Uint8Array());\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tthis.expectedPayloadLength = frameLength;\n\t\t\t\tthis.payloadBlocks = [];\n\t\t\t\tthis.currentPayloadBlock = undefined;\n\t\t\t\tthis.currentPayloadBlockLength = 0;\n\t\t\t\tthis.payloadLength = 0;\n\t\t\t}\n\n\t\t\tconst expectedPayloadLength = this.expectedPayloadLength;\n\t\t\tif (expectedPayloadLength === undefined) continue;\n\t\t\twhile (chunkOffset < chunk.byteLength && this.payloadLength < expectedPayloadLength) {\n\t\t\t\tlet block = this.currentPayloadBlock;\n\t\t\t\tif (!block || this.currentPayloadBlockLength === block.byteLength) {\n\t\t\t\t\tblock = new Uint8Array(Math.min(PAYLOAD_BLOCK_SIZE, expectedPayloadLength - this.payloadLength));\n\t\t\t\t\tthis.payloadBlocks.push(block);\n\t\t\t\t\tthis.currentPayloadBlock = block;\n\t\t\t\t\tthis.currentPayloadBlockLength = 0;\n\t\t\t\t}\n\t\t\t\tconst payloadBytes = Math.min(\n\t\t\t\t\tblock.byteLength - this.currentPayloadBlockLength,\n\t\t\t\t\tchunk.byteLength - chunkOffset,\n\t\t\t\t);\n\t\t\t\tblock.set(chunk.subarray(chunkOffset, chunkOffset + payloadBytes), this.currentPayloadBlockLength);\n\t\t\t\tthis.currentPayloadBlockLength += payloadBytes;\n\t\t\t\tthis.payloadLength += payloadBytes;\n\t\t\t\tchunkOffset += payloadBytes;\n\t\t\t}\n\t\t\tif (this.payloadLength === expectedPayloadLength) {\n\t\t\t\tif (this.payloadBlocks.length === 1) {\n\t\t\t\t\tframes.push(this.payloadBlocks[0]!);\n\t\t\t\t} else {\n\t\t\t\t\tconst payload = new Uint8Array(expectedPayloadLength);\n\t\t\t\t\tlet offset = 0;\n\t\t\t\t\tfor (const payloadBlock of this.payloadBlocks) {\n\t\t\t\t\t\tpayload.set(payloadBlock, offset);\n\t\t\t\t\t\toffset += payloadBlock.byteLength;\n\t\t\t\t\t}\n\t\t\t\t\tframes.push(payload);\n\t\t\t\t}\n\t\t\t\tthis.payloadBlocks = [];\n\t\t\t\tthis.currentPayloadBlock = undefined;\n\t\t\t\tthis.currentPayloadBlockLength = 0;\n\t\t\t\tthis.expectedPayloadLength = undefined;\n\t\t\t\tthis.payloadLength = 0;\n\t\t\t}\n\t\t}\n\t\treturn frames;\n\t}\n\n\tend(): void {\n\t\tif (this.state === \"ended\") throw new FrameError(\"Frame decoder has ended\");\n\t\tif (this.state === \"failed\") throw new FrameError(\"Frame decoder has failed\");\n\t\tif (this.headerLength !== 0 || this.expectedPayloadLength !== undefined) {\n\t\t\tthis.fail(\"Truncated frame at end of stream\");\n\t\t}\n\t\tthis.state = \"ended\";\n\t}\n\n\tprivate fail(message: string): never {\n\t\tthis.state = \"failed\";\n\t\tthis.headerLength = 0;\n\t\tthis.payloadBlocks = [];\n\t\tthis.currentPayloadBlock = undefined;\n\t\tthis.currentPayloadBlockLength = 0;\n\t\tthis.expectedPayloadLength = undefined;\n\t\tthis.payloadLength = 0;\n\t\tthrow new FrameError(message);\n\t}\n}\n"]}