@nifrajs/core 2.0.0 → 2.2.0

package/dist/transport-codec-rich.js

@@ -0,0 +1,14 @@
+import { parse as parseWire, stringify as stringifyWire } from "./wire.js";
+export function richWireCodec(options = {}) {
+    const limits = Object.freeze({ ...(options.limits ?? {}) });
+    return Object.freeze({
+        id: "wire",
+        version: 1,
+        mediaType: "application/vnd.nifra.wire+json;v=1",
+        encode: stringifyWire,
+        decode(text) {
+            return parseWire(text, limits);
+        },
+    });
+}
+//# sourceMappingURL=transport-codec-rich.js.map

package/dist/transport-codec-rich.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-codec-rich.js","sourceRoot":"","sources":["../src/transport-codec-rich.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAyB,MAAM,WAAW,CAAA;AAMjG,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM;QACV,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,qCAAqC;QAChD,MAAM,EAAE,aAAa;QACrB,MAAM,CAAC,IAAY;YACjB,OAAO,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAChC,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/transport-codec.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Versioned, bounded codecs shared by HTTP bodies, loader streams, and WebSocket frames. Plain JSON
+ * remains the zero-configuration fast path; rich wire is explicit and preserves non-JSON values.
+ */
+export interface TransportDecodeOptions {
+    readonly maxBytes?: number;
+}
+export interface TransportCodec {
+    readonly id: string;
+    readonly version: number;
+    readonly mediaType: string;
+    encode(value: unknown): string;
+    decode(text: string): unknown;
+}
+export declare class TransportCodecError extends TypeError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare const plainJsonCodec: TransportCodec;
+export interface TransportCodecRegistry {
+    readonly fallback: TransportCodec;
+    forContentType(contentType: string | null): TransportCodec;
+    negotiate(accept: string | null): TransportCodec;
+    byIdentity(id: string, version: number): TransportCodec;
+}
+export declare function createTransportCodecRegistry(codecs: readonly TransportCodec[], fallback?: TransportCodec): TransportCodecRegistry;
+export declare const defaultTransportCodecs: TransportCodecRegistry;
+export declare function encodeTransportResponse(value: unknown, codec?: TransportCodec, init?: ResponseInit): Response;
+export declare function decodeTransportResponse(response: Response, registry?: TransportCodecRegistry, options?: TransportDecodeOptions): Promise<unknown>;
+export declare function encodeTransportFrame(value: unknown, codec?: TransportCodec): string;
+export declare function decodeTransportFrame(frame: string, registry?: TransportCodecRegistry, options?: TransportDecodeOptions): unknown;
+//# sourceMappingURL=transport-codec.d.ts.map

package/dist/transport-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-codec.d.ts","sourceRoot":"","sources":["../src/transport-codec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC9B;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAsCD,eAAO,MAAM,cAAc,EAAE,cAY3B,CAAA;AAEF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAAA;IAC1D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAAA;IAChD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAA;CACxD;AAUD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,QAAQ,GAAE,cAA+B,GACxC,sBAAsB,CA0ExB;AAED,eAAO,MAAM,sBAAsB,EAAE,sBAEnC,CAAA;AAEF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,cAA+B,EACtC,IAAI,GAAE,YAAiB,GACtB,QAAQ,CAKV;AA8CD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,GAAE,sBAA+C,EACzD,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAQlB;AAQD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,cAA+B,GACrC,MAAM,CAER;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,sBAA+C,EACzD,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAsBT"}

package/dist/transport-codec.js

@@ -0,0 +1,214 @@
+/**
+ * Versioned, bounded codecs shared by HTTP bodies, loader streams, and WebSocket frames. Plain JSON
+ * remains the zero-configuration fast path; rich wire is explicit and preserves non-JSON values.
+ */
+const DEFAULT_MAX_BYTES = 16 * 1024 * 1024;
+const TOKEN = /^[a-z][a-z0-9_.-]{0,63}$/;
+export class TransportCodecError extends TypeError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "TransportCodecError";
+    }
+}
+/**
+ * Run a decode step and normalize whatever it throws into {@link TransportCodecError}.
+ *
+ * Decoding is the one place this module touches attacker-controlled bytes, and the primitives it
+ * delegates to raise their own native types — `JSON.parse` throws `SyntaxError`, a BYO codec throws
+ * whatever it likes. Every other failure here is a `TransportCodecError`, so letting those escape
+ * would mean a malformed payload — the single most likely hostile input — is the one case that slips
+ * past a caller catching the documented error type. The original is kept as `cause`, so the parse
+ * failure stays diagnosable; a codec already speaking the contract is re-thrown untouched.
+ */
+function decodeOrThrow(decode, message) {
+    try {
+        return decode();
+    }
+    catch (cause) {
+        if (cause instanceof TransportCodecError)
+            throw cause;
+        throw new TransportCodecError(message, { cause });
+    }
+}
+function maxBytesOf(options) {
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 0)
+        throw new RangeError("transport maxBytes must be a non-negative safe integer");
+    return maxBytes;
+}
+function byteLength(text) {
+    return new TextEncoder().encode(text).byteLength;
+}
+function assertBounded(text, options) {
+    if (byteLength(text) > maxBytesOf(options)) {
+        throw new TransportCodecError("transport payload exceeds maxBytes");
+    }
+}
+export const plainJsonCodec = Object.freeze({
+    id: "json",
+    version: 1,
+    mediaType: "application/json",
+    encode(value) {
+        const encoded = JSON.stringify(value);
+        if (encoded === undefined)
+            throw new TransportCodecError("value is not JSON serializable");
+        return encoded;
+    },
+    decode(text) {
+        return JSON.parse(text);
+    },
+});
+function canonicalMediaType(value) {
+    return value
+        .split(";")
+        .map((part) => part.trim().toLowerCase())
+        .filter(Boolean)
+        .join(";");
+}
+export function createTransportCodecRegistry(codecs, fallback = plainJsonCodec) {
+    if (codecs.length === 0)
+        throw new TypeError("transport codec registry cannot be empty");
+    const byMedia = new Map();
+    const byId = new Map();
+    for (const codec of codecs) {
+        if (!TOKEN.test(codec.id))
+            throw new TypeError("transport codec id is invalid");
+        if (!Number.isSafeInteger(codec.version) || codec.version < 1)
+            throw new TypeError("transport codec version must be a positive safe integer");
+        if (typeof codec.encode !== "function" || typeof codec.decode !== "function")
+            throw new TypeError("transport codec must provide encode and decode");
+        const media = canonicalMediaType(codec.mediaType);
+        const identity = `${codec.id}@${codec.version}`;
+        if (byMedia.has(media) || byId.has(identity))
+            throw new TypeError("duplicate transport codec registration");
+        byMedia.set(media, codec);
+        byId.set(identity, codec);
+    }
+    if (!byId.has(`${fallback.id}@${fallback.version}`))
+        throw new TypeError("transport fallback must be registered");
+    const forContentType = (contentType) => {
+        if (contentType === null || contentType.trim() === "")
+            return fallback;
+        const canonical = canonicalMediaType(contentType);
+        const direct = byMedia.get(canonical);
+        if (direct !== undefined)
+            return direct;
+        const base = canonical.split(";")[0];
+        if (base === "application/json") {
+            const json = byId.get("json@1");
+            if (json !== undefined)
+                return json;
+        }
+        throw new TransportCodecError(`unsupported transport content type: ${contentType}`);
+    };
+    return Object.freeze({
+        fallback,
+        forContentType,
+        negotiate(accept) {
+            if (accept === null || accept.trim() === "" || accept.trim() === "*/*")
+                return fallback;
+            const candidates = accept
+                .split(",")
+                .map((candidate) => {
+                const quality = /;\s*q=([01](?:\.\d+)?)\s*$/iu.exec(candidate);
+                const q = quality === null ? 1 : Number(quality[1]);
+                return {
+                    media: quality === null ? candidate.trim() : candidate.slice(0, quality.index).trim(),
+                    q,
+                };
+            })
+                .filter((candidate) => Number.isFinite(candidate.q) && candidate.q > 0 && candidate.q <= 1)
+                .sort((a, b) => b.q - a.q);
+            for (const candidate of candidates) {
+                try {
+                    return forContentType(candidate.media);
+                }
+                catch {
+                    // Try the next advertised representation.
+                }
+            }
+            throw new TransportCodecError("no acceptable transport codec");
+        },
+        byIdentity(id, version) {
+            const codec = byId.get(`${id}@${version}`);
+            if (codec === undefined)
+                throw new TransportCodecError(`unsupported transport codec: ${id}@${version}`);
+            return codec;
+        },
+    });
+}
+export const defaultTransportCodecs = createTransportCodecRegistry([
+    plainJsonCodec,
+]);
+export function encodeTransportResponse(value, codec = plainJsonCodec, init = {}) {
+    const headers = new Headers(init.headers);
+    headers.set("content-type", codec.mediaType);
+    headers.set("vary", appendVary(headers.get("vary"), "accept"));
+    return new Response(codec.encode(value), { ...init, headers });
+}
+function appendVary(current, name) {
+    if (current === null || current.trim() === "")
+        return name;
+    const values = current.split(",").map((value) => value.trim().toLowerCase());
+    return values.includes(name.toLowerCase()) ? current : `${current}, ${name}`;
+}
+async function readBoundedText(response, options) {
+    const maxBytes = maxBytesOf(options);
+    const declared = response.headers.get("content-length");
+    if (declared !== null && /^\d+$/u.test(declared) && Number(declared) > maxBytes)
+        throw new TransportCodecError("transport payload exceeds maxBytes");
+    if (response.body === null)
+        return "";
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            total += value.byteLength;
+            if (!Number.isSafeInteger(total) || total > maxBytes) {
+                await reader.cancel();
+                throw new TransportCodecError("transport payload exceeds maxBytes");
+            }
+            chunks.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return decodeOrThrow(() => new TextDecoder("utf-8", { fatal: true }).decode(bytes), "transport payload is not valid UTF-8");
+}
+export async function decodeTransportResponse(response, registry = defaultTransportCodecs, options = {}) {
+    const codec = registry.forContentType(response.headers.get("content-type"));
+    const text = await readBoundedText(response, options);
+    if (text === "")
+        return undefined;
+    return decodeOrThrow(() => codec.decode(text), `malformed transport body for codec ${codec.id}@${codec.version}`);
+}
+export function encodeTransportFrame(value, codec = plainJsonCodec) {
+    return JSON.stringify({ codec: codec.id, version: codec.version, payload: codec.encode(value) });
+}
+export function decodeTransportFrame(frame, registry = defaultTransportCodecs, options = {}) {
+    assertBounded(frame, options);
+    const envelope = decodeOrThrow(() => JSON.parse(frame), "malformed transport frame");
+    if (envelope === null ||
+        typeof envelope !== "object" ||
+        typeof envelope.codec !== "string" ||
+        !Number.isSafeInteger(envelope.version) ||
+        typeof envelope.payload !== "string") {
+        throw new TransportCodecError("malformed transport frame");
+    }
+    const payload = envelope.payload;
+    assertBounded(payload, options);
+    const codec = registry.byIdentity(envelope.codec, envelope.version);
+    return decodeOrThrow(() => codec.decode(payload), `malformed transport frame payload for codec ${codec.id}@${codec.version}`);
+}
+//# sourceMappingURL=transport-codec.js.map

package/dist/transport-codec.js.map

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

package/dist/transport-plugin.d.ts

@@ -0,0 +1,3 @@
+/** Opt-in server integration for versioned transport codecs. */
+export { transportCodecs } from "./server/transport-lane.js";
+//# sourceMappingURL=transport-plugin.d.ts.map

package/dist/transport-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-plugin.d.ts","sourceRoot":"","sources":["../src/transport-plugin.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/transport-plugin.js

@@ -0,0 +1,3 @@
+/** Opt-in server integration for versioned transport codecs. */
+export { transportCodecs } from "./server/transport-lane.js";
+//# sourceMappingURL=transport-plugin.js.map

package/dist/transport-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-plugin.js","sourceRoot":"","sources":["../src/transport-plugin.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/wire.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Rich-type wire codec: round-trips values that plain JSON silently drops or corrupts, across any
+ * JSON transport (RPC bodies, loader payloads, WebSocket frames).
+ *
+ * `JSON.stringify` turns `undefined` into a missing key, `Date` into a lossy string, `NaN`/`Infinity`
+ * into `null`, loses `-0`, and throws on `BigInt` - and it has no notion of `Map`, `Set`, `RegExp`,
+ * `URL`, `ArrayBuffer`, or typed arrays. It also flattens a shared reference into two copies and throws
+ * on a cycle. A typed client that infers `Date` from the server type then receives a `string` at runtime
+ * is exactly the drift this framework exists to remove. `encode` maps a value to a JSON-safe structure
+ * that `decode` reconstructs exactly - including cycles and preserved reference identity; `stringify` /
+ * `parse` are the drop-in `JSON.*` equivalents.
+ *
+ * The wire form is `{ r, n }`: `r` is the root (an inline value or a `ref`), `n` is a flat table of
+ * container/rich nodes addressed by index. Because every object is interned in `n` and referenced by
+ * index, a shared object is encoded once (and decodes to a single shared instance), and a cycle is a
+ * back-reference rather than infinite recursion. Functions and symbols are rejected, never silently
+ * dropped. Decoding validates every tag and index, so a malformed payload throws {@link WireDecodeError}
+ * rather than producing a corrupt value.
+ *
+ * Not covered by design (matches `JSON`): class identity (a class instance decodes to a plain object
+ * carrying its own enumerable properties), non-enumerable and symbol keys, and getters (read once).
+ */
+/** The JSON-safe encoded form produced by {@link encode} and consumed by {@link decode}. */
+export interface Wire {
+    /** The root value: an inline primitive/scalar, or a `{ [TAG]: "ref", i }` into {@link Wire.n}. */
+    readonly r: unknown;
+    /** Interned container and rich-type nodes, addressed by index from `ref`s. */
+    readonly n: readonly unknown[];
+}
+/** Resource limits applied while reconstructing transport-controlled wire data. */
+export interface WireDecodeLimits {
+    /** Maximum number of interned nodes. Default 10,000. */
+    readonly maxNodes?: number;
+    /** Maximum nesting depth across containers and references. Default 256. */
+    readonly maxDepth?: number;
+    /** Maximum total object/array/map/set entries visited. Default 100,000. */
+    readonly maxCollectionEntries?: number;
+    /** Maximum UTF-8 string plus decoded binary bytes materialized. Default 16 MiB. */
+    readonly maxDecodedBytes?: number;
+}
+export declare const DEFAULT_WIRE_DECODE_LIMITS: Readonly<Required<WireDecodeLimits>>;
+/** Thrown by {@link encode} for a value it will not encode (a function or a symbol). */
+export declare class WireEncodeError extends TypeError {
+    constructor(message: string);
+}
+/** Thrown by {@link decode} for a wire value carrying an unknown tag, a bad index, or malformed shape. */
+export declare class WireDecodeError extends TypeError {
+    constructor(message: string);
+}
+/** Encode any supported value into a JSON-safe {@link Wire} form. */
+export declare function encode(value: unknown): Wire;
+/** Reconstruct the original value from a {@link Wire} form produced by {@link encode}. */
+export declare function decode(wire: Wire, limits?: WireDecodeLimits): unknown;
+/** `encode` + `JSON.stringify` in one call - the rich-type equivalent of `JSON.stringify`. */
+export declare function stringify(value: unknown): string;
+/** `JSON.parse` + `decode` in one call - the rich-type equivalent of `JSON.parse`. */
+export declare function parse(text: string, limits?: WireDecodeLimits): unknown;
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,4FAA4F;AAC5F,MAAM,WAAW,IAAI;IACnB,kGAAkG;IAClG,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAA;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;CAC/B;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,mFAAmF;IACnF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAK1E,CAAA;AAEF,wFAAwF;AACxF,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,0GAA0G;AAC1G,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM;CAI5B;AA4DD,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAwC3C;AAsCD,0FAA0F;AAC1F,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,gBAAqB,GAAG,OAAO,CA6NzE;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,sFAAsF;AACtF,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,gBAAqB,GAAG,OAAO,CAE1E"}