prefix-safe-json 0.1.0 → 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,156 @@
+/** Standard JSON value type. */
+export type JsonValue = string | number | boolean | null | JsonObject | JsonArray;
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type JsonArray = JsonValue[];
+/** Why the LLM stream ended. */
+export type StreamEndReason = "complete" | "length" | "network_error" | "provider_error" | "cancelled" | "unknown";
+/** Returned by `push()` after feeding a chunk. */
+export interface PushResult {
+    /** Number of bytes accepted from this chunk. */
+    acceptedBytes: number;
+    /** Number of semantic events emitted during this push. */
+    emittedEvents: number;
+    /** Current syntactic status of the document. */
+    syntax: SyntaxStatus;
+    /** If true, the parser will not accept further input. */
+    terminal: boolean;
+}
+export type SyntaxStatus = "empty" | "incomplete" | "root_complete" | "invalid";
+/** Immutable snapshot of parser state. */
+export interface ParserSnapshot {
+    /** Whether we are still collecting or the stream is finished. */
+    phase: "collecting" | "finished";
+    /** Current syntactic status. */
+    syntax: SyntaxStatus;
+    /** JSON value built from only fully-committed fields. */
+    stableValue?: JsonValue;
+    /** Whether the root JSON container has been closed. */
+    rootComplete: boolean;
+    /**
+     * Whether the parsed result is safe for tool execution.
+     * True only when root is complete, stream finished normally,
+     * no pending tokens, no fatal diagnostics, no duplicate keys,
+     * and no structural/lossy repairs.
+     */
+    executable: boolean;
+    /** Tokens still awaiting more data. */
+    pending: readonly PendingToken[];
+    /** Repairs applied (populated at finish). */
+    repairs: readonly RepairAction[];
+    /** All diagnostics emitted so far. */
+    diagnostics: readonly Diagnostic[];
+    /** Total bytes received via push(). */
+    receivedBytes: number;
+    /** Bytes successfully consumed by the parser. */
+    consumedBytes: number;
+}
+/** A value that is in-progress and not yet committed. */
+export interface PendingToken {
+    type: "string" | "number" | "literal" | "unicode_escape" | "surrogate" | "object_key";
+    path: string;
+    buffered: string;
+    byteOffset: number;
+}
+/** Describes a deterministic repair applied at stream end. */
+export interface RepairAction {
+    code: string;
+    byteRange: readonly [number, number];
+    impact: "representation_preserving" | "root_preserving" | "structural" | "lossy";
+    description: string;
+}
+/** Structured parse diagnostic. */
+export interface Diagnostic {
+    code: string;
+    severity: "info" | "warning" | "error" | "fatal";
+    byteOffset: number;
+    path?: string;
+    recoverable: boolean;
+    message: string;
+}
+export type ParserEvent = ValueCommittedEvent | ContainerClosedEvent | RepairAppliedEvent | DiagnosticEvent | DocumentCompleteEvent | StreamFinishedEvent;
+export interface ValueCommittedEvent {
+    type: "value_committed";
+    sequence: number;
+    path: string;
+    operation: "add";
+    value: JsonValue;
+    byteRange: readonly [number, number];
+}
+export interface ContainerClosedEvent {
+    type: "container_closed";
+    sequence: number;
+    path: string;
+    container: "object" | "array";
+}
+export interface RepairAppliedEvent {
+    type: "repair_applied";
+    sequence: number;
+    repair: RepairAction;
+}
+export interface DiagnosticEvent {
+    type: "diagnostic";
+    sequence: number;
+    diagnostic: Diagnostic;
+}
+export interface DocumentCompleteEvent {
+    type: "document_complete";
+    sequence: number;
+    executable: boolean;
+}
+export interface StreamFinishedEvent {
+    type: "stream_finished";
+    sequence: number;
+    outcome: "valid" | "truncated" | "salvaged" | "invalid";
+}
+/** Returned by `finish()`. */
+export interface FinalResult {
+    /** Final syntactic status. */
+    syntax: SyntaxStatus;
+    /** Overall parse outcome. */
+    outcome: "valid" | "truncated" | "salvaged" | "invalid";
+    /** JSON value from committed fields only. */
+    stableValue?: JsonValue;
+    /** Whether the result is safe for tool execution. */
+    executable: boolean;
+    /** All repairs applied during finalization. */
+    repairs: readonly RepairAction[];
+    /** All diagnostics. */
+    diagnostics: readonly Diagnostic[];
+    /** Total received bytes. */
+    receivedBytes: number;
+    /** Consumed bytes. */
+    consumedBytes: number;
+}
+/** The incremental parser API. */
+export interface IncrementalJsonParser {
+    /** Feed a chunk of data. */
+    push(chunk: string | Uint8Array): PushResult;
+    /** Get a snapshot of the current parser state. */
+    snapshot(): ParserSnapshot;
+    /** Drain and return all unconsumed events, clearing the queue. */
+    drainEvents(): readonly ParserEvent[];
+    /** Signal stream completion. Must be called exactly once. */
+    finish(meta?: {
+        reason?: StreamEndReason;
+        providerReason?: string;
+    }): FinalResult;
+}
+export interface RepairOptions {
+    readonly rawControlCharacters: "reject" | "escape";
+    readonly trailingData: "reject" | "isolate";
+    readonly closeContainersAtFinish: "disabled" | "safe-only";
+}
+export interface ParserOptions {
+    limits?: Partial<ParserLimits>;
+    repairs?: Partial<RepairOptions>;
+}
+export interface ParserLimits {
+    maxInputBytes: number;
+    maxDepth: number;
+    maxStringBytes: number;
+    maxQueuedEvents: number;
+    maxTrailingDataBytes: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Public Types for prefix-safe-json
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E"}

package/dist/utf8/decoder.d.ts

@@ -0,0 +1,53 @@
+/** Result of decoding a chunk of bytes. */
+export interface DecodeResult {
+    /** Decoded code points as a string. */
+    text: string;
+    /** Number of bytes consumed (may be less than input if trailing incomplete sequence). */
+    consumed: number;
+    /** Errors encountered during decoding. */
+    errors: Utf8Error[];
+    /** True if BOM was detected and stripped during this chunk. */
+    strippedBom: boolean;
+}
+export interface Utf8Error {
+    kind: "invalid_start_byte" | "invalid_continuation" | "overlong" | "out_of_range";
+    byteOffset: number;
+}
+/**
+ * Incremental UTF-8 decoder that handles multi-byte characters
+ * split across chunk boundaries.
+ */
+export declare class Utf8Decoder {
+    /** Pending bytes from an incomplete multi-byte sequence. */
+    private pending;
+    /** Expected total length of the current multi-byte sequence. */
+    private pendingExpected;
+    /** Total bytes processed across all push() calls. */
+    private totalOffset;
+    private bomBuffer;
+    private checkedForBom;
+    /**
+     * Decode a chunk of bytes, returning decoded text and any errors.
+     * Incomplete trailing multi-byte sequences are buffered for the next call.
+     */
+    decode(bytes: Uint8Array): DecodeResult;
+    /**
+     * Check if there are buffered incomplete bytes.
+     */
+    hasIncomplete(): boolean;
+    /**
+     * Get the byte offset where the incomplete sequence started.
+     */
+    incompleteByteOffset(): number;
+    /**
+     * Decode a complete multi-byte UTF-8 sequence into a code point.
+     * Returns an error for invalid continuation, overlong, or out-of-range sequences.
+     */
+    private decodeSequence;
+}
+/**
+ * Convert a string to its UTF-8 byte representation.
+ * Utility for tests and string-mode push().
+ */
+export declare function stringToUtf8(str: string): Uint8Array;
+//# sourceMappingURL=decoder.d.ts.map

package/dist/utf8/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/utf8/decoder.ts"],"names":[],"mappings":"AAeA,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EACA,oBAAoB,GACpB,sBAAsB,GACtB,UAAU,GACV,cAAc,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,4DAA4D;IAC5D,OAAO,CAAC,OAAO,CAAgB;IAC/B,gEAAgE;IAChE,OAAO,CAAC,eAAe,CAAK;IAC5B,qDAAqD;IACrD,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,aAAa,CAAS;IAE9B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY;IAyMvC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAK9B;;;OAGG;IACH,OAAO,CAAC,cAAc;CA6DvB;AAoBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAGpD"}

package/dist/utf8/decoder.js

@@ -0,0 +1,323 @@
+// ---------------------------------------------------------------------------
+// Incremental UTF-8 Decoder
+// ---------------------------------------------------------------------------
+//
+// Processes Uint8Array chunks and yields code points one at a time.
+// Handles multi-byte characters split across chunk boundaries by buffering
+// incomplete trailing bytes until the next push().
+//
+// Design decisions:
+//   - Does NOT silently replace invalid bytes with U+FFFD
+//   - Rejects overlong encodings
+//   - Reports invalid continuation bytes
+//   - Truncated sequences at finish() are reportable
+// ---------------------------------------------------------------------------
+/**
+ * Incremental UTF-8 decoder that handles multi-byte characters
+ * split across chunk boundaries.
+ */
+export class Utf8Decoder {
+    /** Pending bytes from an incomplete multi-byte sequence. */
+    pending = [];
+    /** Expected total length of the current multi-byte sequence. */
+    pendingExpected = 0;
+    /** Total bytes processed across all push() calls. */
+    totalOffset = 0;
+    bomBuffer = [];
+    checkedForBom = false;
+    /**
+     * Decode a chunk of bytes, returning decoded text and any errors.
+     * Incomplete trailing multi-byte sequences are buffered for the next call.
+     */
+    decode(bytes) {
+        const errors = [];
+        const codePoints = [];
+        let strippedBom = false;
+        let i = 0;
+        // Handle BOM check at the very beginning of the stream
+        if (!this.checkedForBom) {
+            while (this.bomBuffer.length < 3 && i < bytes.length) {
+                this.bomBuffer.push(bytes[i]);
+                i++;
+            }
+            const isBomPrefix = (this.bomBuffer[0] === 0xef) &&
+                (this.bomBuffer.length < 2 || this.bomBuffer[1] === 0xbb) &&
+                (this.bomBuffer.length < 3 || this.bomBuffer[2] === 0xbf);
+            if (isBomPrefix && this.bomBuffer.length < 3) {
+                // Still possibly a BOM, wait for more data
+                return { text: "", consumed: i, errors, strippedBom: false };
+            }
+            this.checkedForBom = true;
+            let bufferToProcess = new Uint8Array();
+            if (this.bomBuffer.length >= 3 &&
+                this.bomBuffer[0] === 0xef &&
+                this.bomBuffer[1] === 0xbb &&
+                this.bomBuffer[2] === 0xbf) {
+                strippedBom = true;
+                this.totalOffset += 3;
+                // The remaining bytes in bomBuffer (if any) need to be processed
+                const remainingInBomBuffer = this.bomBuffer.slice(3);
+                const remainingInBytes = bytes.slice(i);
+                bufferToProcess = new Uint8Array(remainingInBomBuffer.length + remainingInBytes.length);
+                bufferToProcess.set(remainingInBomBuffer);
+                bufferToProcess.set(remainingInBytes, remainingInBomBuffer.length);
+            }
+            else {
+                // Not a BOM. Process the whole bomBuffer + remaining bytes.
+                const remainingInBytes = bytes.slice(i);
+                bufferToProcess = new Uint8Array(this.bomBuffer.length + remainingInBytes.length);
+                bufferToProcess.set(this.bomBuffer);
+                bufferToProcess.set(remainingInBytes, this.bomBuffer.length);
+            }
+            // Reset i and swap bytes to the reconstructed buffer
+            i = 0;
+            bytes = bufferToProcess;
+        }
+        const startOffset = this.totalOffset;
+        // If we have pending bytes from a previous chunk, try to complete the sequence
+        if (this.pending.length > 0) {
+            let brokenByInvalidContinuation = false;
+            while (i < bytes.length && this.pending.length < this.pendingExpected) {
+                const b = bytes[i];
+                if ((b & 0xc0) !== 0x80) {
+                    // Not a valid continuation byte — the pending sequence is broken
+                    errors.push({
+                        kind: "invalid_continuation",
+                        byteOffset: startOffset - this.pending.length,
+                    });
+                    this.pending = [];
+                    this.pendingExpected = 0;
+                    brokenByInvalidContinuation = true;
+                    // Don't consume this byte — it might be a valid start byte
+                    break;
+                }
+                this.pending.push(b);
+                i++;
+                this.totalOffset++;
+            }
+            // brokenByInvalidContinuation resets pending.length/pendingExpected to
+            // the same value (0), which would otherwise make the check below
+            // read as "0 of 0 bytes needed - sequence complete" and spuriously
+            // decode an empty byte array, producing a second, bogus diagnostic
+            // alongside the invalid_continuation one already pushed above.
+            if (!brokenByInvalidContinuation && this.pending.length === this.pendingExpected) {
+                // We have a complete sequence — decode it
+                const result = this.decodeSequence(this.pending, startOffset - (this.pending.length - (i - 0)));
+                if (result.error) {
+                    errors.push(result.error);
+                }
+                else {
+                    codePoints.push(result.codePoint);
+                }
+                this.pending = [];
+                this.pendingExpected = 0;
+            }
+            else if (!brokenByInvalidContinuation && i >= bytes.length) {
+                // Still incomplete — wait for more data
+                const consumed = this.totalOffset - startOffset;
+                return { text: "", consumed, errors, strippedBom };
+            }
+        }
+        // Process remaining bytes
+        while (i < bytes.length) {
+            const b = bytes[i];
+            const seqOffset = this.totalOffset;
+            if (b <= 0x7f) {
+                // Single-byte ASCII
+                codePoints.push(b);
+                i++;
+                this.totalOffset++;
+            }
+            else if ((b & 0xe0) === 0xc0) {
+                // 2-byte sequence
+                const needed = 2;
+                if (i + needed <= bytes.length) {
+                    const seq = [b, bytes[i + 1]];
+                    const result = this.decodeSequence(seq, seqOffset);
+                    if (result.error) {
+                        errors.push(result.error);
+                        i++;
+                        this.totalOffset++;
+                    }
+                    else {
+                        codePoints.push(result.codePoint);
+                        i += needed;
+                        this.totalOffset += needed;
+                    }
+                }
+                else {
+                    // Incomplete at end of chunk — buffer it
+                    this.pendingExpected = needed;
+                    this.pending = [];
+                    for (let j = i; j < bytes.length; j++) {
+                        this.pending.push(bytes[j]);
+                    }
+                    this.totalOffset += bytes.length - i;
+                    i = bytes.length;
+                }
+            }
+            else if ((b & 0xf0) === 0xe0) {
+                // 3-byte sequence
+                const needed = 3;
+                if (i + needed <= bytes.length) {
+                    const seq = [b, bytes[i + 1], bytes[i + 2]];
+                    const result = this.decodeSequence(seq, seqOffset);
+                    if (result.error) {
+                        errors.push(result.error);
+                        i++;
+                        this.totalOffset++;
+                    }
+                    else {
+                        codePoints.push(result.codePoint);
+                        i += needed;
+                        this.totalOffset += needed;
+                    }
+                }
+                else {
+                    this.pendingExpected = needed;
+                    this.pending = [];
+                    for (let j = i; j < bytes.length; j++) {
+                        this.pending.push(bytes[j]);
+                    }
+                    this.totalOffset += bytes.length - i;
+                    i = bytes.length;
+                }
+            }
+            else if ((b & 0xf8) === 0xf0) {
+                // 4-byte sequence
+                const needed = 4;
+                if (i + needed <= bytes.length) {
+                    const seq = [b, bytes[i + 1], bytes[i + 2], bytes[i + 3]];
+                    const result = this.decodeSequence(seq, seqOffset);
+                    if (result.error) {
+                        errors.push(result.error);
+                        i++;
+                        this.totalOffset++;
+                    }
+                    else {
+                        codePoints.push(result.codePoint);
+                        i += needed;
+                        this.totalOffset += needed;
+                    }
+                }
+                else {
+                    this.pendingExpected = needed;
+                    this.pending = [];
+                    for (let j = i; j < bytes.length; j++) {
+                        this.pending.push(bytes[j]);
+                    }
+                    this.totalOffset += bytes.length - i;
+                    i = bytes.length;
+                }
+            }
+            else {
+                // Invalid start byte (0x80-0xBF or 0xF8+)
+                errors.push({
+                    kind: "invalid_start_byte",
+                    byteOffset: seqOffset,
+                });
+                i++;
+                this.totalOffset++;
+            }
+        }
+        const text = codePointsToString(codePoints);
+        const consumed = this.totalOffset - startOffset;
+        return { text, consumed, errors, strippedBom };
+    }
+    /**
+     * Check if there are buffered incomplete bytes.
+     */
+    hasIncomplete() {
+        return this.pending.length > 0;
+    }
+    /**
+     * Get the byte offset where the incomplete sequence started.
+     */
+    incompleteByteOffset() {
+        return this.totalOffset - this.pending.length;
+    }
+    /**
+     * Decode a complete multi-byte UTF-8 sequence into a code point.
+     * Returns an error for invalid continuation, overlong, or out-of-range sequences.
+     */
+    decodeSequence(seq, offset) {
+        const len = seq.length;
+        // Validate continuation bytes
+        for (let i = 1; i < len; i++) {
+            if ((seq[i] & 0xc0) !== 0x80) {
+                return {
+                    codePoint: 0,
+                    error: { kind: "invalid_continuation", byteOffset: offset },
+                };
+            }
+        }
+        let codePoint;
+        let minCodePoint;
+        if (len === 2) {
+            codePoint = ((seq[0] & 0x1f) << 6) | (seq[1] & 0x3f);
+            minCodePoint = 0x80;
+        }
+        else if (len === 3) {
+            codePoint =
+                ((seq[0] & 0x0f) << 12) |
+                    ((seq[1] & 0x3f) << 6) |
+                    (seq[2] & 0x3f);
+            minCodePoint = 0x800;
+        }
+        else {
+            // len === 4
+            codePoint =
+                ((seq[0] & 0x07) << 18) |
+                    ((seq[1] & 0x3f) << 12) |
+                    ((seq[2] & 0x3f) << 6) |
+                    (seq[3] & 0x3f);
+            minCodePoint = 0x10000;
+        }
+        // Check overlong encoding
+        if (codePoint < minCodePoint) {
+            return {
+                codePoint: 0,
+                error: { kind: "overlong", byteOffset: offset },
+            };
+        }
+        // Check valid Unicode range. Surrogate halves (U+D800-U+DFFF) are not
+        // valid Unicode scalar values and must never appear directly encoded in
+        // UTF-8 (RFC 3629) - they exist only as a UTF-16 encoding artifact. A
+        // 3-byte sequence can arithmetically land in this range (e.g. ED A0 80
+        // decodes to U+D800) without tripping the overlong or >0x10FFFF checks,
+        // so it needs its own check.
+        if (codePoint > 0x10ffff || (codePoint >= 0xd800 && codePoint <= 0xdfff)) {
+            return {
+                codePoint: 0,
+                error: { kind: "out_of_range", byteOffset: offset },
+            };
+        }
+        return { codePoint };
+    }
+}
+/**
+ * Build a string from an array of code points without spreading the whole
+ * array as call arguments — a single-call spread hits engine argument-count
+ * limits (RangeError: Maximum call stack size exceeded) once codePoints
+ * grows past roughly 100k entries, which a single large push() can trigger.
+ */
+function codePointsToString(codePoints) {
+    const CHUNK_SIZE = 8192;
+    if (codePoints.length <= CHUNK_SIZE) {
+        return String.fromCodePoint(...codePoints);
+    }
+    let text = "";
+    for (let i = 0; i < codePoints.length; i += CHUNK_SIZE) {
+        text += String.fromCodePoint(...codePoints.slice(i, i + CHUNK_SIZE));
+    }
+    return text;
+}
+/**
+ * Convert a string to its UTF-8 byte representation.
+ * Utility for tests and string-mode push().
+ */
+export function stringToUtf8(str) {
+    const encoder = new TextEncoder();
+    return encoder.encode(str);
+}
+//# sourceMappingURL=decoder.js.map

package/dist/utf8/decoder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prefix-safe-json",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Fail-closed execution integrity for streamed LLM tool calls — reject truncated or unconfirmed arguments before side effects",
   "keywords": [
     "json",
@@ -17,6 +17,7 @@
   ],
   "license": "MIT OR Apache-2.0",
   "type": "module",
+  "sideEffects": false,
   "repository": {
     "type": "git",
     "url": "git+https://github.com/canblmz1/prefix-safe-json.git"