@sammorrowdrums/mcpi-protocol 0.85.0-bootstrap.0

package/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/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/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/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/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/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACN,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,YAAY,GAEZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAEN,mBAAmB,EACnB,gBAAgB,EAEhB,mBAAmB,GACnB,MAAM,cAAc,CAAC;AAEtB,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACjD,YAAY,OAAe,EAAE,MAAgB,EAAE;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAAA,CACtC;CACD;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,gBAAgB,GAAG,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,EAAU,EAAW;IAC1G,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC;IACjD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5G,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,CAAC;QACJ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QAChG,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QACpE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACrF,CAAC;YAAS,CAAC;QACV,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AAAA,CACD;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAiB;IACjE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,uBAAuB,CAAC,iCAAiC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACb;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAiB;IACjE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,uBAAuB,CAAC,iCAAiC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACb;AAED,SAAS,mBAAmB,CAAC,KAAc,EAAU;IACpD,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,qBAAqB,CAAC;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC;AAAA,CACzF;AAED,SAAS,qBAAqB,CAC7B,KAAQ,EACR,KAAgC,EAChC,IAAY,EACZ,OAA6B,EAChB;IACb,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC;QACJ,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,wBAAwB,CAAC;QAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;QACpF,mBAAmB,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,uBAAuB;YAAE,MAAM,KAAK,CAAC;QAC1D,MAAM,IAAI,uBAAuB,CAAC,oBAAoB,IAAI,sBAAsB,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;AAAA,CACD;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,OAAsB,EAAE,OAA6B,EAAc;IACtG,OAAO,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAAA,CAC7E;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,OAAsB,EAAE,OAA6B,EAAc;IACtG,OAAO,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAAA,CAC7E;AAED,MAAM,uBAAuB;IACpB,MAAM,GAAG,KAAK,CAAC;IACN,MAAM,CAAe;IACrB,IAAI,CAAS;IACb,cAAc,CAAS;IACvB,KAAK,CAA4B;IAElD,YAAY,IAAY,EAAE,KAAgC,EAAE,OAA6B,EAAE;QAC1F,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,wBAAwB,CAAC;QAC1E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAAA,CACnB;IAED,IAAI,CAAC,KAAiB,EAAO;QAC5B,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,IAAI,CAAC,IAAI,6BAA6B,CAAC,CAAC;QAC9F,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAQ,EAAE,CAAC;YACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;YACtF,CAAC;YACD,OAAO,QAAQ,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,KAAK,YAAY,uBAAuB;gBAAE,MAAM,KAAK,CAAC;YAC1D,MAAM,IAAI,uBAAuB,CAAC,WAAW,IAAI,CAAC,IAAI,oBAAoB,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzG,CAAC;IAAA,CACD;IAED,GAAG,GAAS;QACX,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,uBAAuB,CAAC,GAAG,IAAI,CAAC,IAAI,6BAA6B,CAAC,CAAC;QAC9F,IAAI,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,IAAI,uBAAuB,CAAC,WAAW,IAAI,CAAC,IAAI,sBAAsB,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3G,CAAC;IAAA,CACD;CACD;AAED,kEAAkE;AAClE,MAAM,OAAO,oBAAoB;IACf,OAAO,CAAyC;IAEjE,YAAY,OAA6B,EAAE;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAAA,CAClF;IAED,IAAI,CAAC,KAAiB,EAAmB;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAAA,CAChC;IAED,GAAG,GAAS;QACX,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAAA,CACnB;CACD;AAED,kEAAkE;AAClE,MAAM,OAAO,oBAAoB;IACf,OAAO,CAAyC;IAEjE,YAAY,OAA6B,EAAE;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,uBAAuB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAAA,CAClF;IAED,IAAI,CAAC,KAAiB,EAAmB;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAAA,CAChC;IAED,GAAG,GAAS;QACX,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAAA,CACnB;CACD;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA6B,EAAwB;IAC/F,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAA,CACzC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA6B,EAAwB;IAC/F,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAA,CACzC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAe,EAAsC;IAC/F,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,gBAAgB,CAAC;AAAA,CACjE","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/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/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"]}

package/dist/framing.js

@@ -0,0 +1,155 @@
+const FRAME_HEADER_LENGTH = 4;
+const MAX_UINT32 = 0xffff_ffff;
+const PAYLOAD_BLOCK_SIZE = 64 * 1024;
+/** Default upper bound for one framed CBOR payload. */
+export const DEFAULT_MAX_FRAME_LENGTH = 16 * 1024 * 1024;
+export class FrameError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FrameError";
+    }
+}
+function resolveMaxFrameLength(options) {
+    const value = options?.maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;
+    if (!Number.isSafeInteger(value) || value < 0 || value > MAX_UINT32) {
+        throw new RangeError(`maxFrameLength must be an integer between 0 and ${MAX_UINT32}`);
+    }
+    return value;
+}
+/** Prefixes a payload with its unsigned 32-bit big-endian byte length. */
+export function encodeFrame(payload) {
+    if (!(payload instanceof Uint8Array))
+        throw new TypeError("Frame payload must be a Uint8Array");
+    if (payload.byteLength > MAX_UINT32)
+        throw new RangeError("Frame payload exceeds the unsigned 32-bit length limit");
+    const frame = new Uint8Array(FRAME_HEADER_LENGTH + payload.byteLength);
+    const length = payload.byteLength;
+    frame[0] = length >>> 24;
+    frame[1] = length >>> 16;
+    frame[2] = length >>> 8;
+    frame[3] = length;
+    frame.set(payload, FRAME_HEADER_LENGTH);
+    return frame;
+}
+/** Validates that bytes contain exactly one complete frame within the configured limit. */
+export function assertCompleteFrame(frame, options) {
+    if (!(frame instanceof Uint8Array))
+        throw new TypeError("Frame must be a Uint8Array");
+    if (frame.byteLength < FRAME_HEADER_LENGTH)
+        throw new FrameError("Frame does not contain a complete length prefix");
+    const length = frame[0] * 0x1_000_000 + frame[1] * 0x1_0000 + frame[2] * 0x100 + frame[3];
+    const maxFrameLength = resolveMaxFrameLength(options);
+    if (length > maxFrameLength) {
+        throw new FrameError(`Frame length ${length} exceeds configured limit of ${maxFrameLength}`);
+    }
+    if (frame.byteLength !== FRAME_HEADER_LENGTH + length) {
+        throw new FrameError("Frame must contain exactly one complete payload");
+    }
+}
+/** Incrementally splits arbitrary byte chunks into length-prefixed payloads. */
+export class FrameDecoder {
+    header = new Uint8Array(FRAME_HEADER_LENGTH);
+    headerLength = 0;
+    maxFrameLength;
+    payloadBlocks = [];
+    currentPayloadBlock;
+    currentPayloadBlockLength = 0;
+    expectedPayloadLength;
+    payloadLength = 0;
+    state = "open";
+    constructor(options) {
+        this.maxFrameLength = resolveMaxFrameLength(options);
+    }
+    push(chunk) {
+        if (this.state === "ended")
+            throw new FrameError("Frame decoder has ended");
+        if (this.state === "failed")
+            throw new FrameError("Frame decoder has failed");
+        if (!(chunk instanceof Uint8Array))
+            throw new TypeError("Frame chunk must be a Uint8Array");
+        const frames = [];
+        let chunkOffset = 0;
+        while (chunkOffset < chunk.byteLength) {
+            if (this.expectedPayloadLength === undefined) {
+                const headerBytes = Math.min(FRAME_HEADER_LENGTH - this.headerLength, chunk.byteLength - chunkOffset);
+                this.header.set(chunk.subarray(chunkOffset, chunkOffset + headerBytes), this.headerLength);
+                this.headerLength += headerBytes;
+                chunkOffset += headerBytes;
+                if (this.headerLength < FRAME_HEADER_LENGTH)
+                    continue;
+                const frameLength = this.header[0] * 0x1_000_000 + this.header[1] * 0x1_0000 + this.header[2] * 0x100 + this.header[3];
+                this.headerLength = 0;
+                if (frameLength > this.maxFrameLength) {
+                    this.fail(`Frame length ${frameLength} exceeds configured limit of ${this.maxFrameLength}`);
+                }
+                if (frameLength === 0) {
+                    frames.push(new Uint8Array());
+                    continue;
+                }
+                this.expectedPayloadLength = frameLength;
+                this.payloadBlocks = [];
+                this.currentPayloadBlock = undefined;
+                this.currentPayloadBlockLength = 0;
+                this.payloadLength = 0;
+            }
+            const expectedPayloadLength = this.expectedPayloadLength;
+            if (expectedPayloadLength === undefined)
+                continue;
+            while (chunkOffset < chunk.byteLength && this.payloadLength < expectedPayloadLength) {
+                let block = this.currentPayloadBlock;
+                if (!block || this.currentPayloadBlockLength === block.byteLength) {
+                    block = new Uint8Array(Math.min(PAYLOAD_BLOCK_SIZE, expectedPayloadLength - this.payloadLength));
+                    this.payloadBlocks.push(block);
+                    this.currentPayloadBlock = block;
+                    this.currentPayloadBlockLength = 0;
+                }
+                const payloadBytes = Math.min(block.byteLength - this.currentPayloadBlockLength, chunk.byteLength - chunkOffset);
+                block.set(chunk.subarray(chunkOffset, chunkOffset + payloadBytes), this.currentPayloadBlockLength);
+                this.currentPayloadBlockLength += payloadBytes;
+                this.payloadLength += payloadBytes;
+                chunkOffset += payloadBytes;
+            }
+            if (this.payloadLength === expectedPayloadLength) {
+                if (this.payloadBlocks.length === 1) {
+                    frames.push(this.payloadBlocks[0]);
+                }
+                else {
+                    const payload = new Uint8Array(expectedPayloadLength);
+                    let offset = 0;
+                    for (const payloadBlock of this.payloadBlocks) {
+                        payload.set(payloadBlock, offset);
+                        offset += payloadBlock.byteLength;
+                    }
+                    frames.push(payload);
+                }
+                this.payloadBlocks = [];
+                this.currentPayloadBlock = undefined;
+                this.currentPayloadBlockLength = 0;
+                this.expectedPayloadLength = undefined;
+                this.payloadLength = 0;
+            }
+        }
+        return frames;
+    }
+    end() {
+        if (this.state === "ended")
+            throw new FrameError("Frame decoder has ended");
+        if (this.state === "failed")
+            throw new FrameError("Frame decoder has failed");
+        if (this.headerLength !== 0 || this.expectedPayloadLength !== undefined) {
+            this.fail("Truncated frame at end of stream");
+        }
+        this.state = "ended";
+    }
+    fail(message) {
+        this.state = "failed";
+        this.headerLength = 0;
+        this.payloadBlocks = [];
+        this.currentPayloadBlock = undefined;
+        this.currentPayloadBlockLength = 0;
+        this.expectedPayloadLength = undefined;
+        this.payloadLength = 0;
+        throw new FrameError(message);
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/framing.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./cbor/index.ts";
+export * from "./codec.ts";
+export * from "./framing.ts";
+export * from "./schemas.ts";
+//# 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,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC","sourcesContent":["export * from \"./cbor/index.ts\";\nexport * from \"./codec.ts\";\nexport * from \"./framing.ts\";\nexport * from \"./schemas.ts\";\n"]}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./cbor/index.js";
+export * from "./codec.js";
+export * from "./framing.js";
+export * from "./schemas.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,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC","sourcesContent":["export * from \"./cbor/index.ts\";\nexport * from \"./codec.ts\";\nexport * from \"./framing.ts\";\nexport * from \"./schemas.ts\";\n"]}