@abloatai/transaction 0.37.0

package/dist/utils/asyncIterator.js

@@ -0,0 +1,136 @@
+/**
+ * Turns a callback-based subscription into an async iterable that yields the
+ * latest snapshot each time the source changes. You supply two functions:
+ * `subscribe(listener)`, which registers your listener and returns a teardown
+ * function, and `getSnapshot()`, which reads the current value. On every change
+ * notification the iterator calls `getSnapshot()` and hands the result to the
+ * consumer's `for await` loop; when the loop ends, the iterator runs the
+ * teardown function.
+ *
+ * Because each notification yields the current snapshot rather than a specific
+ * event, bursts coalesce harmlessly — a consumer that falls behind still ends up
+ * with the freshest value. The queue is unbounded, so a consumer that never
+ * advances lets memory grow without limit. When individual events matter and
+ * must not be dropped, use {@link asyncIteratorFromEvents} instead.
+ *
+ * Each call to the factory creates an independent iterator with its own
+ * subscription. Two `for await` loops over the same source each observe every
+ * change; they do not take values from one another.
+ */
+/**
+ * Turns a callback-based subscription into an async iterable that yields each
+ * discrete event, in order, with none dropped. You supply a single
+ * `subscribe(push)` function: it registers your producer and returns a teardown
+ * function, and your producer calls `push(value)` once per event. The consumer's
+ * `for await` loop receives every pushed value.
+ *
+ * This is the counterpart to {@link asyncIteratorFrom}. Reach for that one when
+ * you only need the latest state and coalescing bursts is fine; reach for this
+ * one when every event is significant — for example a stream of change deltas
+ * where skipping one would lose data. The queue is unbounded, so a consumer that
+ * stops advancing lets memory grow without limit.
+ */
+export function asyncIteratorFromEvents(subscribe) {
+    const queue = [];
+    const resolvers = [];
+    let done = false;
+    const push = (value) => {
+        if (done)
+            return;
+        const resolver = resolvers.shift();
+        if (resolver) {
+            resolver({ value, done: false });
+        }
+        else {
+            queue.push(value);
+        }
+    };
+    const unsubscribe = subscribe(push);
+    const finish = () => {
+        done = true;
+        unsubscribe();
+        for (const r of resolvers)
+            r({ value: undefined, done: true });
+        resolvers.length = 0;
+        queue.length = 0;
+        return { value: undefined, done: true };
+    };
+    return {
+        async next() {
+            if (done)
+                return { value: undefined, done: true };
+            if (queue.length > 0) {
+                return { value: queue.shift(), done: false };
+            }
+            return new Promise((resolve) => {
+                resolvers.push(resolve);
+            });
+        },
+        async return() {
+            return finish();
+        },
+        async throw(err) {
+            finish();
+            throw err;
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+}
+export function asyncIteratorFrom(subscribe, getSnapshot) {
+    const queue = [];
+    // Pending `next()` callers waiting for a value. Empty when the
+    // consumer is keeping up; holds 0-or-1 resolver when they're
+    // awaiting. We never hold more than one at a time — a consumer
+    // that calls `next()` twice without awaiting the first breaks
+    // the async-iterator contract.
+    const resolvers = [];
+    let done = false;
+    const push = () => {
+        if (done)
+            return;
+        const value = getSnapshot();
+        const resolver = resolvers.shift();
+        if (resolver) {
+            resolver({ value, done: false });
+        }
+        else {
+            queue.push(value);
+        }
+    };
+    const unsubscribe = subscribe(push);
+    const finish = () => {
+        done = true;
+        unsubscribe();
+        // Resolve any dangling readers so their awaits don't leak.
+        for (const r of resolvers)
+            r({ value: undefined, done: true });
+        resolvers.length = 0;
+        queue.length = 0;
+        return { value: undefined, done: true };
+    };
+    return {
+        async next() {
+            if (done)
+                return { value: undefined, done: true };
+            if (queue.length > 0) {
+                return { value: queue.shift(), done: false };
+            }
+            return new Promise((resolve) => {
+                resolvers.push(resolve);
+            });
+        },
+        async return() {
+            return finish();
+        },
+        async throw(err) {
+            finish();
+            throw err;
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+}
+//# sourceMappingURL=asyncIterator.js.map

package/dist/utils/asyncIterator.js.map

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

package/dist/utils/duration.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Parses a duration into milliseconds. A duration is either a number of seconds
+ * or a string with a unit suffix — milliseconds, seconds, minutes, or hours:
+ *
+ *   - `'500ms'` → 500 ms
+ *   - `'30s'`   → 30 000 ms
+ *   - `'3m'`    → 180 000 ms
+ *   - `'24h'`   → 86 400 000 ms
+ *
+ * A bare number is interpreted as seconds rather than milliseconds, matching the
+ * `ttlSeconds` fields used throughout the SDK, so a numeric caller and a string
+ * caller can pass the same field interchangeably. {@link toMs} returns
+ * milliseconds; {@link toSeconds} returns whole seconds.
+ */
+import { z } from 'zod';
+export type Duration = number | `${number}ms` | `${number}s` | `${number}m` | `${number}h`;
+/**
+ * The same grammar as a boundary schema, so a duration crossing the wire is
+ * checked against the parser that will read it rather than against a second
+ * description of it.
+ *
+ * The regex is shared with {@link toMs} deliberately: `z.toJSONSchema` emits it
+ * as a `pattern`, which is how a non-TypeScript caller learns the grammar at
+ * all. A union of `number | string` — which is what this used to be on the
+ * claim bodies — publishes as "some number or some string" and leaves the units
+ * to be guessed.
+ */
+export declare const durationSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+/**
+ * Parses a duration and returns the equivalent number of milliseconds. Accepts
+ * either a bare number, interpreted as seconds, or a unit-suffixed string such
+ * as `'500ms'`, `'30s'`, `'3m'`, or `'24h'`. Throws an
+ * {@link AbloValidationError} with code `duration_invalid` when a string does
+ * not match a supported unit.
+ *
+ * Two doors, one implementation. {@link toMs} takes the narrow {@link Duration}
+ * template type, so an SDK caller writing a literal gets the unit checked at
+ * compile time. {@link parseDurationMs} takes the widened `string | number` that
+ * {@link durationSchema} infers — the shape a value has after it crossed the
+ * wire and was validated at the boundary. Neither is a cast of the other, and
+ * neither carries its own copy of the grammar.
+ */
+export declare function toMs(input: Duration): number;
+/**
+ * {@link toMs} for a value that arrived over the wire, where the type system
+ * knows only `string | number` because that is what the boundary schema infers.
+ */
+export declare function parseDurationMs(input: string | number): number;
+/** Parses a duration like {@link toMs} but returns whole seconds, rounding down. */
+export declare function toSeconds(input: Duration): number;
+//# sourceMappingURL=duration.d.ts.map

package/dist/utils/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/utils/duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,GAAG,MAAM,IAAI,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,CAAC;AAI3F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,iDAKzB,CAAC;AASH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAa9D;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEjD"}

package/dist/utils/duration.js

@@ -0,0 +1,78 @@
+/**
+ * Parses a duration into milliseconds. A duration is either a number of seconds
+ * or a string with a unit suffix — milliseconds, seconds, minutes, or hours:
+ *
+ *   - `'500ms'` → 500 ms
+ *   - `'30s'`   → 30 000 ms
+ *   - `'3m'`    → 180 000 ms
+ *   - `'24h'`   → 86 400 000 ms
+ *
+ * A bare number is interpreted as seconds rather than milliseconds, matching the
+ * `ttlSeconds` fields used throughout the SDK, so a numeric caller and a string
+ * caller can pass the same field interchangeably. {@link toMs} returns
+ * milliseconds; {@link toSeconds} returns whole seconds.
+ */
+import { z } from 'zod';
+import { AbloValidationError } from '../errors.js';
+const PATTERN = /^(\d+(?:\.\d+)?)(ms|s|m|h)$/;
+/**
+ * The same grammar as a boundary schema, so a duration crossing the wire is
+ * checked against the parser that will read it rather than against a second
+ * description of it.
+ *
+ * The regex is shared with {@link toMs} deliberately: `z.toJSONSchema` emits it
+ * as a `pattern`, which is how a non-TypeScript caller learns the grammar at
+ * all. A union of `number | string` — which is what this used to be on the
+ * claim bodies — publishes as "some number or some string" and leaves the units
+ * to be guessed.
+ */
+export const durationSchema = z.union([
+    z.number().positive(),
+    z.string().regex(PATTERN, {
+        message: 'expected a duration such as "500ms", "30s", "3m" or "24h"',
+    }),
+]);
+const UNIT_MS = {
+    ms: 1,
+    s: 1_000,
+    m: 60_000,
+    h: 3_600_000,
+};
+/**
+ * Parses a duration and returns the equivalent number of milliseconds. Accepts
+ * either a bare number, interpreted as seconds, or a unit-suffixed string such
+ * as `'500ms'`, `'30s'`, `'3m'`, or `'24h'`. Throws an
+ * {@link AbloValidationError} with code `duration_invalid` when a string does
+ * not match a supported unit.
+ *
+ * Two doors, one implementation. {@link toMs} takes the narrow {@link Duration}
+ * template type, so an SDK caller writing a literal gets the unit checked at
+ * compile time. {@link parseDurationMs} takes the widened `string | number` that
+ * {@link durationSchema} infers — the shape a value has after it crossed the
+ * wire and was validated at the boundary. Neither is a cast of the other, and
+ * neither carries its own copy of the grammar.
+ */
+export function toMs(input) {
+    return parseDurationMs(input);
+}
+/**
+ * {@link toMs} for a value that arrived over the wire, where the type system
+ * knows only `string | number` because that is what the boundary schema infers.
+ */
+export function parseDurationMs(input) {
+    if (typeof input === 'number')
+        return input * 1_000;
+    const match = PATTERN.exec(input);
+    if (!match) {
+        throw new AbloValidationError(`Invalid duration "${input}" — expected number (seconds) or ` +
+            `a string like "500ms" | "30s" | "3m" | "24h".`, { code: 'duration_invalid' });
+    }
+    const value = Number(match[1]);
+    const unit = match[2];
+    return value * UNIT_MS[unit];
+}
+/** Parses a duration like {@link toMs} but returns whole seconds, rounding down. */
+export function toSeconds(input) {
+    return Math.floor(toMs(input) / 1_000);
+}
+//# sourceMappingURL=duration.js.map

package/dist/utils/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/utils/duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAInD,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrB,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE;QACxB,OAAO,EAAE,2DAA2D;KACrE,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,OAAO,GAA2C;IACtD,EAAE,EAAE,CAAC;IACL,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,SAAS;CACb,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,IAAI,CAAC,KAAe;IAClC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,GAAG,KAAK,CAAC;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAC3B,qBAAqB,KAAK,mCAAmC;YAC3D,+CAA+C,EACjD,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAC7B,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAA2B,CAAC;IAChD,OAAO,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,KAAe;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/utils/json.d.ts

@@ -0,0 +1,58 @@
+/**
+ * json.ts — key-order-insensitive comparison helpers for JSON-shaped values.
+ *
+ * Why this exists as a first-class, exported util:
+ *
+ * A `field.json()` value may be backed by a Postgres `jsonb` column, and **jsonb
+ * does not preserve object key order** (it reorders keys by length, then
+ * bytewise, and drops insignificant whitespace — see
+ * https://www.postgresql.org/docs/current/datatype-json.html). So a document an
+ * app wrote as `{type,text}` streams back in a delta as `{text,type}`: the same
+ * value, a different serialization.
+ *
+ * That bites any app that reconciles an Ablo row against an *external* state
+ * container it doesn't control — a rich-text editor (Tiptap/ProseMirror/Slate),
+ * a `useState`, a form buffer. The natural guard, `JSON.stringify(remote) ===
+ * JSON.stringify(local)`, is silently wrong because the two sides serialize keys
+ * in different orders, so it never matches — and the app re-applies the remote
+ * value on every render, clobbering in-flight edits and fighting the cursor.
+ *
+ * The fix is to compare order-insensitively. `deepEqual` does structural
+ * equality directly; `stableStringify` produces a canonical string (recursively
+ * sorted keys) for when you need a stable cache key / dependency value. The SDK
+ * already uses `deepEqual` internally for store-level echo detection; this
+ * module makes the same guarantee available to app authors so they don't each
+ * reinvent it.
+ *
+ * (If you need byte-exact key order preserved end-to-end, store the field in a
+ * `text` column instead of `jsonb` — Ablo's adaptive codec serializes verbatim
+ * there, matching Postgres's `json` type behavior.)
+ */
+import type { JsonValue } from '../types/streams.js';
+/**
+ * Takes an immutable, plain snapshot at a JSON persistence/wire boundary.
+ *
+ * Traversal intentionally creates fresh objects and arrays instead of relying
+ * on a framework-specific unwrapping API. That makes Proxy-wrapped plain data
+ * (including MobX observables) safe for IndexedDB's structured-clone algorithm
+ * while keeping the settlement core independent of any reactive framework.
+ *
+ * The accepted contract is deliberately narrower than `JSON.stringify`:
+ * values that JSON would silently corrupt (`NaN` to `null`, `Map` to `{}`) or
+ * cannot encode are rejected with a stable, path-aware validation error.
+ * Valid dates retain normal JSON semantics and become ISO strings. Undefined
+ * object properties are omitted for compatibility with optional object keys;
+ * root/array `undefined` and sparse arrays are rejected rather than becoming
+ * an ambiguous `null`.
+ */
+export declare function snapshotJsonValue(value: unknown, path?: string): JsonValue;
+/** Structural equality for JSON-shaped values (scalars, arrays, plain objects); key order is ignored. */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Canonical JSON serialization: recursively sorts object keys so two values that
+ * differ only in key order (e.g. a jsonb round-trip) produce the same string.
+ * Use this when you need a comparable/cacheable string rather than a boolean —
+ * e.g. an echo guard or a `useEffect`/`useMemo` dependency.
+ */
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/utils/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAM,GAAG,SAAS,CAOvE;AA4KD,yGAAyG;AACzG,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA0BzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/utils/json.js

@@ -0,0 +1,277 @@
+/**
+ * json.ts — key-order-insensitive comparison helpers for JSON-shaped values.
+ *
+ * Why this exists as a first-class, exported util:
+ *
+ * A `field.json()` value may be backed by a Postgres `jsonb` column, and **jsonb
+ * does not preserve object key order** (it reorders keys by length, then
+ * bytewise, and drops insignificant whitespace — see
+ * https://www.postgresql.org/docs/current/datatype-json.html). So a document an
+ * app wrote as `{type,text}` streams back in a delta as `{text,type}`: the same
+ * value, a different serialization.
+ *
+ * That bites any app that reconciles an Ablo row against an *external* state
+ * container it doesn't control — a rich-text editor (Tiptap/ProseMirror/Slate),
+ * a `useState`, a form buffer. The natural guard, `JSON.stringify(remote) ===
+ * JSON.stringify(local)`, is silently wrong because the two sides serialize keys
+ * in different orders, so it never matches — and the app re-applies the remote
+ * value on every render, clobbering in-flight edits and fighting the cursor.
+ *
+ * The fix is to compare order-insensitively. `deepEqual` does structural
+ * equality directly; `stableStringify` produces a canonical string (recursively
+ * sorted keys) for when you need a stable cache key / dependency value. The SDK
+ * already uses `deepEqual` internally for store-level echo detection; this
+ * module makes the same guarantee available to app authors so they don't each
+ * reinvent it.
+ *
+ * (If you need byte-exact key order preserved end-to-end, store the field in a
+ * `text` column instead of `jsonb` — Ablo's adaptive codec serializes verbatim
+ * there, matching Postgres's `json` type behavior.)
+ */
+import { AbloValidationError } from '../errors.js';
+/**
+ * Takes an immutable, plain snapshot at a JSON persistence/wire boundary.
+ *
+ * Traversal intentionally creates fresh objects and arrays instead of relying
+ * on a framework-specific unwrapping API. That makes Proxy-wrapped plain data
+ * (including MobX observables) safe for IndexedDB's structured-clone algorithm
+ * while keeping the settlement core independent of any reactive framework.
+ *
+ * The accepted contract is deliberately narrower than `JSON.stringify`:
+ * values that JSON would silently corrupt (`NaN` to `null`, `Map` to `{}`) or
+ * cannot encode are rejected with a stable, path-aware validation error.
+ * Valid dates retain normal JSON semantics and become ISO strings. Undefined
+ * object properties are omitted for compatibility with optional object keys;
+ * root/array `undefined` and sparse arrays are rejected rather than becoming
+ * an ambiguous `null`.
+ */
+export function snapshotJsonValue(value, path = '$') {
+    try {
+        return snapshotJsonNode(value, path, new WeakMap());
+    }
+    catch (error) {
+        if (error instanceof AbloValidationError)
+            throw error;
+        throw invalidJsonValue(path, 'could not be read safely', value, error);
+    }
+}
+function snapshotJsonNode(value, path, active) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw invalidJsonValue(path, 'must be a finite number', value);
+        }
+        return Object.is(value, -0) ? 0 : value;
+    }
+    if (value === undefined) {
+        throw invalidJsonValue(path, 'cannot be undefined here', value);
+    }
+    if (typeof value === 'bigint') {
+        throw invalidJsonValue(path, 'cannot be a bigint', value);
+    }
+    if (typeof value === 'function') {
+        throw invalidJsonValue(path, 'cannot be a function', value);
+    }
+    if (typeof value === 'symbol') {
+        throw invalidJsonValue(path, 'cannot be a symbol', value);
+    }
+    if (value instanceof Date) {
+        const timestamp = value.getTime();
+        if (!Number.isFinite(timestamp)) {
+            throw invalidJsonValue(path, 'cannot be an invalid Date', value);
+        }
+        return value.toISOString();
+    }
+    if (Array.isArray(value)) {
+        const firstPath = active.get(value);
+        if (firstPath !== undefined) {
+            throw invalidJsonValue(path, `forms a cycle back to ${firstPath}`, value);
+        }
+        active.set(value, path);
+        try {
+            const output = [];
+            for (let index = 0; index < value.length; index += 1) {
+                const itemPath = `${path}[${index}]`;
+                if (!(index in value)) {
+                    throw invalidJsonValue(itemPath, 'cannot be a sparse array hole', undefined);
+                }
+                output.push(snapshotJsonNode(value[index], itemPath, active));
+            }
+            return Object.freeze(output);
+        }
+        finally {
+            active.delete(value);
+        }
+    }
+    const object = value;
+    const firstPath = active.get(object);
+    if (firstPath !== undefined) {
+        throw invalidJsonValue(path, `forms a cycle back to ${firstPath}`, value);
+    }
+    let prototype;
+    try {
+        prototype = Object.getPrototypeOf(object);
+    }
+    catch (cause) {
+        throw invalidJsonValue(path, 'has an unreadable prototype', value, cause);
+    }
+    if (prototype !== null) {
+        const constructorDescriptor = Object.getOwnPropertyDescriptor(prototype, 'constructor');
+        const constructor = constructorDescriptor?.value;
+        if (typeof constructor !== 'function' || constructor.name !== 'Object') {
+            throw invalidJsonValue(path, 'must be a plain object', value);
+        }
+    }
+    active.set(object, path);
+    try {
+        let keys;
+        try {
+            keys = Reflect.ownKeys(object);
+        }
+        catch (cause) {
+            throw invalidJsonValue(path, 'has unreadable keys', value, cause);
+        }
+        for (const key of keys) {
+            if (typeof key !== 'symbol')
+                continue;
+            let enumerable = false;
+            try {
+                enumerable = Object.getOwnPropertyDescriptor(object, key)?.enumerable === true;
+            }
+            catch (cause) {
+                throw invalidJsonValue(path, 'has an unreadable symbol property', value, cause);
+            }
+            if (enumerable) {
+                throw invalidJsonValue(path, 'cannot contain enumerable symbol keys', value);
+            }
+        }
+        const output = {};
+        for (const key of keys) {
+            if (typeof key !== 'string')
+                continue;
+            let descriptor;
+            try {
+                descriptor = Object.getOwnPropertyDescriptor(object, key);
+            }
+            catch (cause) {
+                throw invalidJsonValue(jsonPath(path, key), 'has an unreadable property', value, cause);
+            }
+            if (!descriptor?.enumerable)
+                continue;
+            let child;
+            try {
+                child = Reflect.get(object, key);
+            }
+            catch (cause) {
+                throw invalidJsonValue(jsonPath(path, key), 'could not be read', value, cause);
+            }
+            // Matches JSON object semantics for optional fields without allowing
+            // undefined to become null inside arrays.
+            if (child === undefined)
+                continue;
+            Object.defineProperty(output, key, {
+                configurable: true,
+                enumerable: true,
+                value: snapshotJsonNode(child, jsonPath(path, key), active),
+                writable: true,
+            });
+        }
+        return Object.freeze(output);
+    }
+    finally {
+        active.delete(object);
+    }
+}
+function jsonPath(parent, key) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)
+        ? `${parent}.${key}`
+        : `${parent}[${JSON.stringify(key)}]`;
+}
+function invalidJsonValue(path, reason, value, cause) {
+    const valueType = jsonValueType(value);
+    return new AbloValidationError(`Write payload ${path} ${reason}.`, {
+        code: 'write_payload_invalid',
+        param: path,
+        details: { path, reason, valueType },
+        ...(cause !== undefined ? { cause } : {}),
+    });
+}
+function jsonValueType(value) {
+    if (value === null)
+        return 'null';
+    try {
+        if (Array.isArray(value))
+            return 'array';
+        if (value instanceof Date)
+            return 'Date';
+        if (typeof value === 'object') {
+            const name = Reflect.get(value, 'constructor')?.name;
+            return typeof name === 'string' ? name : 'object';
+        }
+    }
+    catch {
+        return typeof value;
+    }
+    return typeof value;
+}
+/** Structural equality for JSON-shaped values (scalars, arrays, plain objects); key order is ignored. */
+export function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null || typeof a !== 'object' || typeof b !== 'object') {
+        return false;
+    }
+    const aArr = Array.isArray(a);
+    if (aArr !== Array.isArray(b))
+        return false;
+    if (aArr) {
+        const av = a;
+        const bv = b;
+        if (av.length !== bv.length)
+            return false;
+        for (let i = 0; i < av.length; i++) {
+            if (!deepEqual(av[i], bv[i]))
+                return false;
+        }
+        return true;
+    }
+    const ao = a;
+    const bo = b;
+    const ak = Object.keys(ao);
+    const bk = Object.keys(bo);
+    if (ak.length !== bk.length)
+        return false;
+    for (const k of ak) {
+        if (!Object.prototype.hasOwnProperty.call(bo, k))
+            return false;
+        if (!deepEqual(ao[k], bo[k]))
+            return false;
+    }
+    return true;
+}
+/**
+ * Canonical JSON serialization: recursively sorts object keys so two values that
+ * differ only in key order (e.g. a jsonb round-trip) produce the same string.
+ * Use this when you need a comparable/cacheable string rather than a boolean —
+ * e.g. an echo guard or a `useEffect`/`useMemo` dependency.
+ */
+export function stableStringify(value) {
+    return JSON.stringify(sortKeysDeep(value));
+}
+function sortKeysDeep(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeysDeep);
+    if (value && typeof value === 'object') {
+        const source = value;
+        return Object.keys(source)
+            .sort()
+            .reduce((acc, key) => {
+            acc[key] = sortKeysDeep(source[key]);
+            return acc;
+        }, {});
+    }
+    return value;
+}
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

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