@insiderfinance/totalfinance 0.1.0

package/modules/core/dist/calendar.js

@@ -0,0 +1,301 @@
+/**
+ * Calendar interface, rules engine, and tiny calendars (spec §7.3, §22.4).
+ *
+ * Core owns the *machinery* (the interface, roll/observance rules, holiday-rule generators, and the
+ * `createRuleCalendar` factory) and two tiny calendars that need no holiday datasets (`alwaysOpen`,
+ * `weekendsOnly`). Exchange-specific holiday *data* lives in `@insiderfinance/totalfinance/calendars`, so core never
+ * bundles exchange datasets.
+ */
+import { isoDateToEpochMs, parseIsoDate } from './dates.js';
+import { ConfigurationError, ErrorCode, InputError } from './errors.js';
+import { ensureKnownKeys, requireArgumentObject } from './invariants.js';
+const MS_PER_DAY = 86_400_000;
+/**
+ * Business-day arithmetic cap: |n| beyond a million business days (~4,000 years) is a bug —
+ * typically an accidental epoch or an unconverted millisecond count — not a request.
+ */
+const MAX_BUSINESS_DAY_STEPS = 1_000_000;
+// ---- date helpers (UTC, no clock reads) ----
+function pad(n) {
+    return String(n).padStart(2, '0');
+}
+function formatEpoch(ms) {
+    const d = new Date(ms);
+    // Pad the year too: years 0–999 must format as ISO `0099-…`, not a malformed `99-…`.
+    return `${String(d.getUTCFullYear()).padStart(4, '0')}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+}
+/**
+ * A `Date` probe at UTC midnight built via `setUTCFullYear`, so years 0000–0099 stay literal —
+ * `Date.UTC` would remap them into 1900–1999 (the legacy two-digit convention) and silently
+ * corrupt day-of-week and month-length reads for ancient dates.
+ */
+function utcProbe(year, monthIndex, day) {
+    const d = new Date(0);
+    d.setUTCFullYear(year, monthIndex, day);
+    return d;
+}
+/** Day of week for an ISO date. */
+export function dayOfWeek(date) {
+    return new Date(isoDateToEpochMs(date)).getUTCDay();
+}
+/** Add `n` calendar days to an ISO date. */
+export function addDays(date, days) {
+    return formatEpoch(isoDateToEpochMs(date) + days * MS_PER_DAY);
+}
+/** Compose an ISO date from components. */
+export function ymd(year, month, day) {
+    return `${year}-${pad(month)}-${pad(day)}`;
+}
+// ---- holiday-rule generators ----
+/**
+ * The `occurrence`-th (1-based) `weekday` of a month, e.g. 3rd Monday of January. Returns `null`
+ * when the month has no such occurrence (e.g. a 5th Friday in a 4-Friday February) — the same
+ * "not observed" channel {@link HolidayRule} already speaks — rather than fabricating an
+ * impossible date like `2026-02-34`.
+ */
+export function nthWeekdayOfMonth(year, month, weekday, occurrence) {
+    if (!Number.isSafeInteger(occurrence) || occurrence < 1) {
+        throw new InputError(`nthWeekdayOfMonth: occurrence must be an integer >= 1 (1st, 2nd, 3rd, …). Received ${String(occurrence)}.`, { code: ErrorCode.InputOutOfRange, context: { field: 'occurrence', value: occurrence } });
+    }
+    const firstDow = utcProbe(year, month - 1, 1).getUTCDay();
+    const day = 1 + ((weekday - firstDow + 7) % 7) + (occurrence - 1) * 7;
+    // Day 0 of the NEXT month is the last day of this one.
+    const daysInMonth = utcProbe(year, month, 0).getUTCDate();
+    if (day > daysInMonth)
+        return null;
+    return ymd(year, month, day);
+}
+/** The last `weekday` of a month, e.g. last Monday of May. */
+export function lastWeekdayOfMonth(year, month, weekday) {
+    const lastDay = utcProbe(year, month, 0).getUTCDate();
+    const lastDow = utcProbe(year, month - 1, lastDay).getUTCDay();
+    const day = lastDay - ((lastDow - weekday + 7) % 7);
+    return ymd(year, month, day);
+}
+/** Apply the US observance rule: Saturday → preceding Friday, Sunday → following Monday. */
+export function observedHoliday(year, month, day) {
+    const dow = utcProbe(year, month - 1, day).getUTCDay();
+    if (dow === 6)
+        return addDays(ymd(year, month, day), -1);
+    if (dow === 0)
+        return addDays(ymd(year, month, day), 1);
+    return ymd(year, month, day);
+}
+/** Easter Sunday via the Anonymous Gregorian algorithm (Computus). */
+export function easterSunday(year) {
+    const a = year % 19;
+    const b = Math.floor(year / 100);
+    const c = year % 100;
+    const d = Math.floor(b / 4);
+    const e = b % 4;
+    const f = Math.floor((b + 8) / 25);
+    const g = Math.floor((b - f + 1) / 3);
+    const h = (19 * a + b - d - g + 15) % 30;
+    const i = Math.floor(c / 4);
+    const k = c % 4;
+    const l = (32 + 2 * e + 2 * i - h - k) % 7;
+    const m = Math.floor((a + 11 * h + 22 * l) / 451);
+    const month = Math.floor((h + l - 7 * m + 114) / 31);
+    const day = ((h + l - 7 * m + 114) % 31) + 1;
+    return { month, day };
+}
+/** Good Friday (two days before Easter Sunday). */
+export function goodFriday(year) {
+    const e = easterSunday(year);
+    return addDays(ymd(year, e.month, e.day), -2);
+}
+/**
+ * Build a `Calendar` from rules. Holiday/half-day sets are computed lazily per year and cached.
+ *
+ * The config is SNAPSHOTTED at construction — rule arrays, closures, weekend days, and the session
+ * object are copied — so mutating the caller's config (or a shared exported rules array) later can
+ * never make one calendar answer the same question two ways across warm and cold cache years.
+ */
+export function createRuleCalendar(config) {
+    requireArgumentObject('createRuleCalendar', 'config', config);
+    ensureKnownKeys('createRuleCalendar', 'config', config, [
+        'name',
+        'version',
+        'timezone',
+        'weekendDays',
+        'session',
+        'holidayRules',
+        'halfDayRules',
+        'closures',
+    ]);
+    for (const field of ['name', 'version', 'timezone']) {
+        const value = config[field];
+        if (typeof value !== 'string' || value.length === 0) {
+            throw new InputError(`createRuleCalendar: ${field} must be a non-empty string. Received ${value === null ? 'null' : value === undefined ? 'undefined' : typeof value}.`, {
+                code: value === undefined ? ErrorCode.InputMissingField : ErrorCode.InputWrongType,
+                context: { field },
+            });
+        }
+    }
+    requireArgumentObject('createRuleCalendar', 'session', config.session);
+    ensureKnownKeys('createRuleCalendar', 'session', config.session, [
+        'open',
+        'close',
+        'halfDayClose',
+    ]);
+    for (const clockField of ['open', 'close']) {
+        const clockValue = config.session[clockField];
+        if (typeof clockValue !== 'string' || clockValue.length === 0) {
+            throw new InputError(`createRuleCalendar: session.${clockField} must be an HH:MM string. Received ${clockValue === null ? 'null' : clockValue === undefined ? 'undefined' : typeof clockValue}.`, {
+                code: clockValue === undefined ? ErrorCode.InputMissingField : ErrorCode.InputWrongType,
+                context: { field: `session.${clockField}` },
+            });
+        }
+    }
+    const halfDayClose = config.session['halfDayClose'];
+    if (halfDayClose !== undefined &&
+        (typeof halfDayClose !== 'string' || halfDayClose.length === 0)) {
+        throw new InputError(`createRuleCalendar: session.halfDayClose must be an HH:MM string when provided. Received ${halfDayClose === null ? 'null' : typeof halfDayClose}.`, { code: ErrorCode.InputWrongType, context: { field: 'session.halfDayClose' } });
+    }
+    for (const field of ['weekendDays', 'holidayRules', 'halfDayRules', 'closures']) {
+        const v = config[field];
+        if (v !== undefined && !Array.isArray(v)) {
+            throw new InputError(`createRuleCalendar: ${field} must be an array when provided. Received ${v === null ? 'null' : typeof v}.`, { code: ErrorCode.InputWrongType, context: { field } });
+        }
+    }
+    const weekend = new Set(config.weekendDays ?? [0, 6]);
+    // A weekend covering all 7 weekdays leaves no candidate business day: nextBusinessDay /
+    // addBusinessDays would scan forever. Reject the contradiction at construction, loudly.
+    // Counted over the REAL weekdays (0–6), so an out-of-range entry cannot fake a full week.
+    if (![0, 1, 2, 3, 4, 5, 6].some((d) => !weekend.has(d))) {
+        throw new ConfigurationError(`createRuleCalendar: "${config.name}" has no business days — all 7 are in weekendDays. Leave one open (closures/holidayRules express full closures).`, {
+            code: ErrorCode.InputOutOfRange,
+            context: { calendar: config.name, weekendDays: config.weekendDays },
+        });
+    }
+    const closures = new Set(config.closures ?? []);
+    const holidayRules = [...(config.holidayRules ?? [])];
+    const halfDayRules = [...(config.halfDayRules ?? [])];
+    const sessionHours = { ...config.session };
+    const holidayCache = new Map();
+    const halfDayCache = new Map();
+    const datesFor = (cache, rules, year) => {
+        let set = cache.get(year);
+        if (!set) {
+            set = new Set();
+            const prefix = `${year}-`;
+            // Evaluate the neighbouring years too: an observed-holiday rule can resolve a date INTO an
+            // adjacent year (e.g. a Saturday holiday observed on the preceding Friday, or a New-Year rule
+            // that lands on Dec 31). Keep only the results that fall in the queried year.
+            for (const y of [year - 1, year, year + 1]) {
+                for (const rule of rules) {
+                    const date = rule(y);
+                    if (date !== null && date.startsWith(prefix))
+                        set.add(date);
+                }
+            }
+            cache.set(year, set);
+        }
+        return set;
+    };
+    const isHoliday = (date) => {
+        const { year } = parseIsoDate(date);
+        return closures.has(date) || datesFor(holidayCache, holidayRules, year).has(date);
+    };
+    const isWeekend = (date) => weekend.has(dayOfWeek(date));
+    const isBusinessDay = (date) => !isWeekend(date) && !isHoliday(date);
+    const isHalfDay = (date) => {
+        if (!isBusinessDay(date))
+            return false;
+        const { year } = parseIsoDate(date);
+        return datesFor(halfDayCache, halfDayRules, year).has(date);
+    };
+    /** Scan day-by-day in `step` direction to the next business day (one mirror-image scan, not two). */
+    const scan = (date, step) => {
+        let d = addDays(date, step);
+        while (!isBusinessDay(d))
+            d = addDays(d, step);
+        return d;
+    };
+    const nextBusinessDay = (date) => scan(date, 1);
+    const previousBusinessDay = (date) => scan(date, -1);
+    const addBusinessDays = (date, n) => {
+        // Integer-only: Infinity would loop forever (Infinity - 1 === Infinity), a fractional n would
+        // silently round, and NaN would silently return the input date.
+        if (!Number.isInteger(n)) {
+            throw new InputError(`addBusinessDays: n must be an integer number of business days, got ${n}.`, { code: ErrorCode.InputOutOfRange, context: { businessDays: n } });
+        }
+        if (Math.abs(n) > MAX_BUSINESS_DAY_STEPS) {
+            throw new InputError(`addBusinessDays: |n| must be <= ${MAX_BUSINESS_DAY_STEPS} business days, got ${n} — a timestamp passed as a day count?`, { code: ErrorCode.InputOutOfRange, context: { businessDays: n } });
+        }
+        if (n === 0)
+            return date;
+        const step = n > 0 ? 1 : -1;
+        let remaining = Math.abs(n);
+        let d = date;
+        while (remaining-- > 0)
+            d = scan(d, step);
+        return d;
+    };
+    const businessDaysBetween = (from, to) => {
+        const fromMs = isoDateToEpochMs(from);
+        const toMs = isoDateToEpochMs(to);
+        if (fromMs === toMs)
+            return 0;
+        const sign = toMs > fromMs ? 1 : -1;
+        let count = 0;
+        let d = from;
+        while (d !== to) {
+            d = addDays(d, sign);
+            if (isBusinessDay(d))
+                count += sign;
+        }
+        return count;
+    };
+    const session = (date) => {
+        const business = isBusinessDay(date);
+        const half = business && isHalfDay(date);
+        if (!business)
+            return { date, isBusinessDay: false, isHalfDay: false };
+        return {
+            date,
+            isBusinessDay: true,
+            isHalfDay: half,
+            // Read the construction-time snapshot — a later mutation of the caller's config object must
+            // not change what a warm calendar reports.
+            open: sessionHours.open,
+            close: half ? (sessionHours.halfDayClose ?? sessionHours.close) : sessionHours.close,
+        };
+    };
+    return {
+        name: config.name,
+        version: config.version,
+        timezone: config.timezone,
+        isBusinessDay,
+        isHoliday,
+        isHalfDay,
+        nextBusinessDay,
+        previousBusinessDay,
+        addBusinessDays,
+        businessDaysBetween,
+        session,
+    };
+}
+/** A 24/7 calendar (every day is a business day) — e.g. crypto. */
+export const alwaysOpen = createRuleCalendar({
+    name: 'ALWAYS_OPEN',
+    version: '1.0.0',
+    timezone: 'UTC',
+    weekendDays: [],
+    session: { open: '00:00', close: '24:00' },
+});
+/** A calendar whose only non-business days are weekends. */
+export const weekendsOnly = createRuleCalendar({
+    name: 'WEEKENDS_ONLY',
+    version: '1.0.0',
+    timezone: 'UTC',
+    session: { open: '00:00', close: '24:00' },
+});
+/**
+ * Define a custom calendar (spec §22.4 extension API). A thin wrapper over `createRuleCalendar` so
+ * the extension surface is stable even if the engine evolves.
+ */
+export function defineCalendar(config) {
+    return createRuleCalendar(config);
+}
+//# sourceMappingURL=calendar.js.map

package/modules/core/dist/calendar.js.map

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

package/modules/core/dist/canonical-json.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Canonical JSON — the ONE serialized form the artifact spine hashes and stores (Gate B).
+ *
+ * Lives at the core root (not under `artifacts/`) because it is a GENERIC serialization utility
+ * with two independent consumers: the artifact spine (hashing/storage) and the Gate C pricing
+ * conformance kit (complete-result comparison). Moved out of `artifacts/` 2026-08-23 (second
+ * external review): while it sat there, `pricing.ts` had to import from the artifacts directory
+ * to compare canonical results, contradicting pricing's documented "never imports the artifacts
+ * layer" rule. `@insiderfinance/totalfinance/core/artifacts` still re-exports everything here, so the public
+ * surface did not move; the core root entrypoint deliberately does NOT re-export it (hot-path
+ * bundles stay serialization-free).
+ *
+ * Two different key orders, or `-0` versus `0`, are the SAME logical value; a content hash that
+ * distinguishes them is a dedup and replay bug. So hashing never runs on `JSON.stringify` output —
+ * it runs on this canonical form, whose rules are few and exact:
+ *
+ * - object keys sort by UTF-16 code unit at every depth; `undefined` members are omitted;
+ * - numbers print via `JSON.stringify` (the ES2020 shortest round-trip form — deterministic across
+ *   engines), with `-0` folded to `0` because JSON cannot carry the sign bit;
+ * - non-finite numbers use the library-wide wrapper grammar `{ nonFinite: 'NaN' | 'Infinity' |
+ *   '-Infinity' }` — the SAME encoding `@insiderfinance/totalfinance/technical-analysis` stamps into stream snapshots,
+ *   so a TA state nested inside a saved artifact round-trips losslessly (`JSON.stringify(NaN)` is
+ *   `null`, and a `null` in a numeric slot reads as `0` downstream — the exact silent-wrong-number
+ *   class this library exists to refuse);
+ * - strings escape per well-formed `JSON.stringify` (ES2019: lone surrogates escaped) — spec-fixed,
+ *   so the bytes are engine-independent;
+ * - everything else is REFUSED with a teaching error. A `Date`, `Map`, `Set`, typed array, class
+ *   instance, `bigint`, or function has no single honest JSON meaning, and guessing one here would
+ *   bake the guess into every content hash forever. `toJSON` methods are deliberately NOT invoked:
+ *   a hash that depends on hidden prototype behavior is not reproducible from the data.
+ *
+ * The wrapper object is RESERVED vocabulary: caller data may not itself contain a literal
+ * `{ nonFinite: '…' }` member, and the serializer refuses one rather than letting it decode into a
+ * number it never was. (TA cannot make this check — its state trees are opaque and arrive
+ * pre-encoded — so it documents the reservation instead; at this boundary the input is caller data
+ * and the refusal is enforceable.)
+ *
+ * `CANONICAL_JSON_VERSION` names these rules. Envelope schema versions govern SHAPES; this constant
+ * governs the SERIALIZATION of any shape, and a future rule change (there is no planned one) would
+ * bump it and re-key every hash — explicitly, never silently.
+ */
+/** The canonicalization rules above, as a versioned public fact. */
+export declare const CANONICAL_JSON_VERSION = 1;
+/** How a non-finite number is carried through JSON — one grammar, library-wide. */
+export interface NonFiniteNumber {
+    nonFinite: 'NaN' | 'Infinity' | '-Infinity';
+}
+/** Exact wrapper test: a plain object whose ONLY member is a valid `nonFinite` tag. */
+export declare function isNonFiniteNumber(value: unknown): value is NonFiniteNumber;
+/**
+ * Serialize a JSON-safe value to its ONE canonical string. Deterministic: the same logical value —
+ * whatever key order, whatever `-0`s — always yields the same bytes, which is what makes
+ * `contentHash` an identity rather than a formatting accident.
+ */
+export declare function canonicalJsonOf(value: unknown): string;
+/**
+ * Parse a canonical (or any) JSON text back to the runtime value, decoding every non-finite wrapper
+ * to its number. The inverse of {@link canonicalJsonOf}: `fromCanonicalJson(canonicalJsonOf(x))`
+ * deep-equals `x` (with `-0` read back as `0` — the one disclosed loss), and
+ * `canonicalJsonOf(fromCanonicalJson(text))` returns `text` unchanged for canonical `text`.
+ */
+export declare function fromCanonicalJson(text: string): unknown;
+//# sourceMappingURL=canonical-json.d.ts.map

package/modules/core/dist/canonical-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.d.ts","sourceRoot":"","sources":["../src/canonical-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC;CAC7C;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAU1E;AAyKD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAuBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoBvD"}

package/modules/core/dist/canonical-json.js

@@ -0,0 +1,241 @@
+/**
+ * Canonical JSON — the ONE serialized form the artifact spine hashes and stores (Gate B).
+ *
+ * Lives at the core root (not under `artifacts/`) because it is a GENERIC serialization utility
+ * with two independent consumers: the artifact spine (hashing/storage) and the Gate C pricing
+ * conformance kit (complete-result comparison). Moved out of `artifacts/` 2026-08-23 (second
+ * external review): while it sat there, `pricing.ts` had to import from the artifacts directory
+ * to compare canonical results, contradicting pricing's documented "never imports the artifacts
+ * layer" rule. `@insiderfinance/totalfinance/core/artifacts` still re-exports everything here, so the public
+ * surface did not move; the core root entrypoint deliberately does NOT re-export it (hot-path
+ * bundles stay serialization-free).
+ *
+ * Two different key orders, or `-0` versus `0`, are the SAME logical value; a content hash that
+ * distinguishes them is a dedup and replay bug. So hashing never runs on `JSON.stringify` output —
+ * it runs on this canonical form, whose rules are few and exact:
+ *
+ * - object keys sort by UTF-16 code unit at every depth; `undefined` members are omitted;
+ * - numbers print via `JSON.stringify` (the ES2020 shortest round-trip form — deterministic across
+ *   engines), with `-0` folded to `0` because JSON cannot carry the sign bit;
+ * - non-finite numbers use the library-wide wrapper grammar `{ nonFinite: 'NaN' | 'Infinity' |
+ *   '-Infinity' }` — the SAME encoding `@insiderfinance/totalfinance/technical-analysis` stamps into stream snapshots,
+ *   so a TA state nested inside a saved artifact round-trips losslessly (`JSON.stringify(NaN)` is
+ *   `null`, and a `null` in a numeric slot reads as `0` downstream — the exact silent-wrong-number
+ *   class this library exists to refuse);
+ * - strings escape per well-formed `JSON.stringify` (ES2019: lone surrogates escaped) — spec-fixed,
+ *   so the bytes are engine-independent;
+ * - everything else is REFUSED with a teaching error. A `Date`, `Map`, `Set`, typed array, class
+ *   instance, `bigint`, or function has no single honest JSON meaning, and guessing one here would
+ *   bake the guess into every content hash forever. `toJSON` methods are deliberately NOT invoked:
+ *   a hash that depends on hidden prototype behavior is not reproducible from the data.
+ *
+ * The wrapper object is RESERVED vocabulary: caller data may not itself contain a literal
+ * `{ nonFinite: '…' }` member, and the serializer refuses one rather than letting it decode into a
+ * number it never was. (TA cannot make this check — its state trees are opaque and arrive
+ * pre-encoded — so it documents the reservation instead; at this boundary the input is caller data
+ * and the refusal is enforceable.)
+ *
+ * `CANONICAL_JSON_VERSION` names these rules. Envelope schema versions govern SHAPES; this constant
+ * governs the SERIALIZATION of any shape, and a future rule change (there is no planned one) would
+ * bump it and re-key every hash — explicitly, never silently.
+ */
+import { ErrorCode, InputError } from './errors.js';
+/** The canonicalization rules above, as a versioned public fact. */
+export const CANONICAL_JSON_VERSION = 1;
+/** Exact wrapper test: a plain object whose ONLY member is a valid `nonFinite` tag. */
+export function isNonFiniteNumber(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    if (!isPlainObject(value))
+        return false;
+    const keys = Reflect.ownKeys(value);
+    if (keys.length !== 1 || keys[0] !== 'nonFinite')
+        return false;
+    const descriptor = Object.getOwnPropertyDescriptor(value, 'nonFinite');
+    if (descriptor === undefined || !descriptor.enumerable || !('value' in descriptor))
+        return false;
+    const tag = descriptor.value;
+    if (tag !== 'NaN' && tag !== 'Infinity' && tag !== '-Infinity')
+        return false;
+    return true;
+}
+function decodeNonFinite(value) {
+    return value.nonFinite === 'NaN'
+        ? Number.NaN
+        : value.nonFinite === 'Infinity'
+            ? Number.POSITIVE_INFINITY
+            : Number.NEGATIVE_INFINITY;
+}
+/** Is this a data object this serializer owns — `{}`-prototype or `null`-prototype only? */
+function isPlainObject(value) {
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/** One refusal voice for every unsupported value, with the path that locates it. */
+function unsupportedValue(path, received, hint) {
+    return new InputError(`canonicalJsonOf: ${path === '' ? 'value' : path} is ${received}, which has no canonical JSON form — ${hint}`, {
+        code: ErrorCode.SerializationUnsupportedValue,
+        context: { path: path === '' ? '(root)' : path, received },
+    });
+}
+/** Describe a class without invoking a caller-provided `constructor`/`name` accessor. */
+function storedConstructorName(value) {
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype === null)
+        return undefined;
+    const constructor = Object.getOwnPropertyDescriptor(prototype, 'constructor');
+    if (constructor === undefined ||
+        !('value' in constructor) ||
+        typeof constructor.value !== 'function') {
+        return undefined;
+    }
+    const name = Object.getOwnPropertyDescriptor(constructor.value, 'name');
+    return name !== undefined &&
+        'value' in name &&
+        typeof name.value === 'string' &&
+        name.value !== ''
+        ? name.value
+        : undefined;
+}
+function serialize(value, path) {
+    if (value === null)
+        return 'null';
+    switch (typeof value) {
+        case 'boolean':
+            return value ? 'true' : 'false';
+        case 'number':
+            if (!Number.isFinite(value)) {
+                return Number.isNaN(value)
+                    ? '{"nonFinite":"NaN"}'
+                    : value > 0
+                        ? '{"nonFinite":"Infinity"}'
+                        : '{"nonFinite":"-Infinity"}';
+            }
+            // JSON has no negative zero; folding it here keeps `0` and `-0` one hash.
+            return JSON.stringify(value === 0 ? 0 : value);
+        case 'string':
+            return JSON.stringify(value);
+        case 'bigint':
+            throw unsupportedValue(path, 'a bigint', 'convert it to a number or a decimal string first.');
+        case 'function':
+            throw unsupportedValue(path, 'a function', 'artifacts carry data, never behavior — serialize its result instead.');
+        case 'symbol':
+            throw unsupportedValue(path, 'a symbol', 'symbols cannot cross a serialization boundary.');
+        case 'undefined':
+            // Reachable only as an ARRAY element — object members are filtered before recursion.
+            throw unsupportedValue(path, 'undefined inside an array', 'JSON.stringify would silently write null there; use null explicitly if you mean an absent slot.');
+        case 'object':
+            break;
+    }
+    const object = value;
+    if (Array.isArray(object)) {
+        if (Object.getPrototypeOf(object) !== Array.prototype) {
+            throw unsupportedValue(path, 'an Array subclass or custom-prototype array', 'pass a plain dense data array.');
+        }
+        const parts = [];
+        for (let i = 0; i < object.length; i++) {
+            const descriptor = Object.getOwnPropertyDescriptor(object, String(i));
+            if (descriptor === undefined || !descriptor.enumerable || !('value' in descriptor)) {
+                throw unsupportedValue(`${path}[${i}]`, 'a missing or accessor-backed array element', 'canonical arrays must be dense stored data; use an explicit value (including null) at every index.');
+            }
+            parts.push(serialize(descriptor.value, `${path}[${i}]`));
+        }
+        for (const key of Reflect.ownKeys(object)) {
+            if (key === 'length')
+                continue;
+            const index = typeof key === 'string' && /^(0|[1-9][0-9]*)$/.test(key) ? Number(key) : -1;
+            if (!Number.isSafeInteger(index) || index < 0 || index >= object.length) {
+                throw unsupportedValue(path, `an array with non-index member ${String(key)}`, 'canonical arrays contain only their dense indexed elements.');
+            }
+        }
+        return `[${parts.join(',')}]`;
+    }
+    if (!isPlainObject(object)) {
+        const constructorName = storedConstructorName(object);
+        const received = constructorName === undefined
+            ? 'a custom-prototype object'
+            : `an instance of ${constructorName}`;
+        const hint = object instanceof Date
+            ? 'pass epoch milliseconds (EpochMs) — TotalFinance dates are numbers, resolved once via resolveAsOf.'
+            : object instanceof Map || object instanceof Set
+                ? 'convert it to a plain object or array explicitly.'
+                : ArrayBuffer.isView(object)
+                    ? 'convert it to a plain array; a lossless columnar (Arrow) mapping is reserved, not implemented (Gate B).'
+                    : 'serialize class instances through their own explicit contract, then pass the plain data.';
+        throw unsupportedValue(path, received, hint);
+    }
+    if (isNonFiniteNumber(object)) {
+        throw unsupportedValue(path, `a literal { nonFinite: '${object.nonFinite}' } object`, 'that shape is the RESERVED encoding of a non-finite number — pass the number itself (NaN/Infinity) and it will be encoded.');
+    }
+    const members = new Map();
+    for (const key of Reflect.ownKeys(object)) {
+        const descriptor = Object.getOwnPropertyDescriptor(object, key);
+        if (typeof key !== 'string' ||
+            descriptor === undefined ||
+            !descriptor.enumerable ||
+            !('value' in descriptor)) {
+            throw unsupportedValue(path, 'an object with an accessor, hidden member, or symbol key', 'canonical objects contain enumerable string-keyed stored data only.');
+        }
+        if (descriptor.value !== undefined)
+            members.set(key, descriptor.value);
+    }
+    const keys = [...members.keys()].sort();
+    const parts = [];
+    for (const key of keys) {
+        parts.push(`${JSON.stringify(key)}:${serialize(members.get(key), path === '' ? key : `${path}.${key}`)}`);
+    }
+    return `{${parts.join(',')}}`;
+}
+/**
+ * Serialize a JSON-safe value to its ONE canonical string. Deterministic: the same logical value —
+ * whatever key order, whatever `-0`s — always yields the same bytes, which is what makes
+ * `contentHash` an identity rather than a formatting accident.
+ */
+export function canonicalJsonOf(value) {
+    return serialize(value, '');
+}
+function decodeTree(value) {
+    if (isNonFiniteNumber(value))
+        return decodeNonFinite(value);
+    if (Array.isArray(value))
+        return value.map((element) => decodeTree(element));
+    if (value !== null && typeof value === 'object') {
+        const out = {};
+        for (const [key, member] of Object.entries(value)) {
+            // `out['__proto__'] = member` invokes Object.prototype's legacy setter instead of creating
+            // a JSON field. Define the own enumerable member explicitly so every valid JSON key survives
+            // the canonical round trip and no decoded artifact can mutate an object's prototype.
+            Object.defineProperty(out, key, {
+                configurable: true,
+                enumerable: true,
+                value: decodeTree(member),
+                writable: true,
+            });
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * Parse a canonical (or any) JSON text back to the runtime value, decoding every non-finite wrapper
+ * to its number. The inverse of {@link canonicalJsonOf}: `fromCanonicalJson(canonicalJsonOf(x))`
+ * deep-equals `x` (with `-0` read back as `0` — the one disclosed loss), and
+ * `canonicalJsonOf(fromCanonicalJson(text))` returns `text` unchanged for canonical `text`.
+ */
+export function fromCanonicalJson(text) {
+    if (typeof text !== 'string') {
+        throw new InputError(`fromCanonicalJson: text must be a JSON string, got ${text === null ? 'null' : typeof text}.`, {
+            code: ErrorCode.InputWrongType,
+            context: { received: text === null ? 'null' : typeof text },
+        });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new InputError(`fromCanonicalJson: text is not valid JSON — ${error instanceof Error ? error.message : String(error)}`, { code: ErrorCode.SerializationUnsupportedValue, context: { textPrefix: text.slice(0, 80) } });
+    }
+    return decodeTree(parsed);
+}
+//# sourceMappingURL=canonical-json.js.map

package/modules/core/dist/canonical-json.js.map

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