prefix-safe-json 0.0.1-alpha.0

package/dist/semantic/snapshot.js

@@ -0,0 +1,228 @@
+// ---------------------------------------------------------------------------
+// Snapshot builder — constructs stableValue from committed events
+// ---------------------------------------------------------------------------
+/**
+ * Maintains the stable value by processing committed events.
+ * Only committed values appear in the stable value.
+ */
+export class SnapshotBuilder {
+    root = undefined;
+    hasRoot = false;
+    /**
+     * Maps each open container's grammar frame to its corresponding node in
+     * the stable-value tree, so a newly-opened child container can attach
+     * directly to its parent in O(1) via initContainerForFrame() instead of
+     * re-parsing a JSON Pointer path string and re-walking from the root on
+     * every single container open (see initContainerForFrame).
+     */
+    frameNodes = new WeakMap();
+    /**
+     * Process a value_committed event and integrate it into the stable value.
+     */
+    processEvent(event) {
+        if (event.type !== "value_committed")
+            return;
+        const { path, value } = event;
+        // Parse the JSON Pointer path to navigate to the parent
+        const segments = parsePointer(path);
+        if (segments.length === 0)
+            return;
+        // Ensure root exists
+        if (!this.hasRoot) {
+            // We need a container at root — determine from the first segment
+            // This shouldn't happen if events are emitted correctly,
+            // because container events come before child value events.
+            return;
+        }
+        const parentSegments = segments.slice(0, -1);
+        const lastSegment = segments[segments.length - 1];
+        if (lastSegment === undefined)
+            return;
+        let target = this.root;
+        for (const seg of parentSegments) {
+            if (target === null || target === undefined)
+                return;
+            if (typeof target === "object" && !Array.isArray(target)) {
+                target = target[seg];
+            }
+            else if (Array.isArray(target)) {
+                const idx = parseInt(seg, 10);
+                if (isNaN(idx))
+                    return;
+                target = target[idx];
+            }
+            else {
+                return; // Can't navigate into scalar
+            }
+        }
+        if (target === null || target === undefined)
+            return;
+        if (typeof target === "object" && !Array.isArray(target)) {
+            safeSet(target, lastSegment, value);
+        }
+        else if (Array.isArray(target)) {
+            const idx = parseInt(lastSegment, 10);
+            if (!isNaN(idx)) {
+                target[idx] = value;
+            }
+        }
+    }
+    /**
+     * Initialize the root as an object container.
+     * `frame` is registered so child containers can find it in O(1).
+     */
+    initRootObject(frame) {
+        if (!this.hasRoot) {
+            this.root = {};
+            this.hasRoot = true;
+        }
+        if (frame)
+            this.frameNodes.set(frame, this.root);
+    }
+    /**
+     * Initialize the root as an array container.
+     * `frame` is registered so child containers can find it in O(1).
+     */
+    initRootArray(frame) {
+        if (!this.hasRoot) {
+            this.root = [];
+            this.hasRoot = true;
+        }
+        if (frame)
+            this.frameNodes.set(frame, this.root);
+    }
+    /**
+     * Initialize a nested container for the given (already-pushed) grammar
+     * frame, attaching it directly to its parent's node.
+     *
+     * Uses frame._parent/_segment (see grammar/frame.ts) plus the frameNodes
+     * map instead of re-parsing frame.path and walking the tree from the
+     * root on every call — that walk is O(depth), and calling it once for
+     * every one of N nested containers made opening N levels cost O(N^2)
+     * total, independent of the grammar-stack path-string fix.
+     */
+    initContainerForFrame(frame, type) {
+        if (!this.hasRoot)
+            return;
+        const parent = frame._parent;
+        const segment = frame._segment;
+        if (!parent || segment === null || segment === undefined)
+            return;
+        const parentNode = this.frameNodes.get(parent);
+        if (parentNode === undefined || parentNode === null)
+            return;
+        const newContainer = type === "object" ? {} : [];
+        if (typeof parentNode === "object" && !Array.isArray(parentNode)) {
+            safeSet(parentNode, segment, newContainer);
+        }
+        else if (Array.isArray(parentNode)) {
+            const idx = typeof segment === "number" ? segment : parseInt(segment, 10);
+            if (!isNaN(idx)) {
+                parentNode[idx] = newContainer;
+            }
+        }
+        else {
+            return;
+        }
+        this.frameNodes.set(frame, newContainer);
+    }
+    /**
+     * Get a deep clone of the current stable value.
+     */
+    getStableValue() {
+        if (!this.hasRoot)
+            return undefined;
+        return deepClone(this.root);
+    }
+    get hasRootValue() {
+        return this.hasRoot;
+    }
+}
+/**
+ * Parse a JSON Pointer string into segments.
+ * Handles ~0 (~) and ~1 (/) unescaping.
+ */
+function parsePointer(pointer) {
+    if (pointer === "")
+        return [];
+    if (!pointer.startsWith("/"))
+        return [];
+    return pointer
+        .slice(1)
+        .split("/")
+        .map((seg) => seg.replace(/~1/g, "/").replace(/~0/g, "~"));
+}
+/**
+ * Assign a JSON-derived key onto a plain object without going through the
+ * inherited `__proto__` accessor. Bracket assignment (obj[key] = value) on a
+ * plain object silently reassigns the object's prototype instead of creating
+ * an own property when key === "__proto__", which makes that field vanish
+ * from Object.keys()/JSON.stringify(). defineProperty always creates a real
+ * own data property, matching native JSON.parse's behavior for such keys.
+ */
+function safeSet(obj, key, value) {
+    Object.defineProperty(obj, key, {
+        value,
+        writable: true,
+        enumerable: true,
+        configurable: true,
+    });
+}
+/**
+ * Deep clone a JSON value.
+ * Iterative (explicit work-stack) rather than recursive: a recursive
+ * implementation overflows the JS call stack around ~5000 levels of nesting,
+ * well below values maxDepth's type otherwise permits.
+ */
+function deepClone(value) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    const root = Array.isArray(value) ? [] : {};
+    const stack = [
+        { src: value, dst: root },
+    ];
+    while (stack.length > 0) {
+        const frame = stack.pop();
+        if (!frame)
+            continue;
+        const { src, dst } = frame;
+        if (Array.isArray(src)) {
+            const dstArr = dst;
+            for (let i = 0; i < src.length; i++) {
+                const child = src[i];
+                if (child !== null && typeof child === "object") {
+                    const childClone = Array.isArray(child) ? [] : {};
+                    dstArr[i] = childClone;
+                    stack.push({
+                        src: child,
+                        dst: childClone,
+                    });
+                }
+                else {
+                    dstArr[i] = child;
+                }
+            }
+        }
+        else {
+            const srcObj = src;
+            const dstObj = dst;
+            for (const key of Object.keys(srcObj)) {
+                const child = srcObj[key];
+                if (child !== null && typeof child === "object") {
+                    const childClone = Array.isArray(child) ? [] : {};
+                    safeSet(dstObj, key, childClone);
+                    stack.push({
+                        src: child,
+                        dst: childClone,
+                    });
+                }
+                else {
+                    safeSet(dstObj, key, child);
+                }
+            }
+        }
+    }
+    return root;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/semantic/snapshot.js.map

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

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;CAwDvB;AAoBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAGpD"}