@adminiumjs/adminium 0.1.0-rc.1

package/dist/crud/undo.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Undo-token pattern (08-server-api.md §2.7.3): mutations execute
+ * immediately; before-images are captured in the same transaction; the
+ * reply carries a single-use `undo_<ulid>` token; `POST /data/undo/:token`
+ * runs compensating writes.
+ *
+ * Memory + meta hybrid: the live token index is in-process (single-process
+ * topologies per 08 §6) keyed by SHA-256 of the token; the full undo
+ * payload also lands in the audit row (`changes.undo`) for tamper-evidence
+ * and post-mortems. Tokens expire after 60 s (§2.7.3 step 2).
+ */
+import type { Row } from './mask.js';
+export declare const UNDO_TTL_MS = 60000;
+export type UndoAction = 'create' | 'update' | 'delete';
+export interface UndoEntry {
+    auditId: string | null;
+    /** Only the issuing user may undo (§2.7.3 step 4). */
+    userId: string;
+    connectionId: string;
+    /** Snapshot table id, e.g. `public.orders`. */
+    tableId: string;
+    action: UndoAction;
+    pkColumns: string[];
+    /** Row images before the mutation (empty for create). */
+    before: Row[];
+    /** Row images after the mutation (conflict detection + create deletion). */
+    after: Row[];
+    /** Update undo: the column set to compare + restore ([] = all columns). */
+    changedColumns: string[];
+    expiresAt: number;
+}
+export interface IssuedUndo {
+    token: string;
+    entry: UndoEntry;
+}
+export type UndoConsumeResult = {
+    status: 'ok';
+    entry: UndoEntry;
+} | {
+    status: 'expired';
+} | {
+    status: 'unknown';
+};
+export declare class UndoStore {
+    #private;
+    constructor(now?: () => number);
+    issue(entry: Omit<UndoEntry, 'expiresAt'>, ttlMs?: number): IssuedUndo;
+    /** Single-use: any consume removes the token (expired ones report 410-able state). */
+    consume(token: string): UndoConsumeResult;
+    /** Expired entries linger briefly so `consume` can answer 410 instead of 404. */
+    static readonly SWEEP_GRACE_MS: number;
+    get size(): number;
+}
+export declare function rowsEqual(a: Row, b: Row, columns: string[]): boolean;
+//# sourceMappingURL=undo.d.ts.map

package/dist/crud/undo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo.d.ts","sourceRoot":"","sources":["../../src/crud/undo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,eAAO,MAAM,WAAW,QAAS,CAAC;AAElC,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yDAAyD;IACzD,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,4EAA4E;IAC5E,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,2EAA2E;IAC3E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;CAClB;AAMD,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B,qBAAa,SAAS;;gBAIR,GAAG,GAAE,MAAM,MAAiB;IAIxC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,KAAK,GAAE,MAAoB,GAAG,UAAU;IAQnF,sFAAsF;IACtF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB;IASzC,iFAAiF;IACjF,MAAM,CAAC,QAAQ,CAAC,cAAc,SAAe;IAS7C,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAYD,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAMpE"}

package/dist/crud/undo.js

@@ -0,0 +1,74 @@
+/**
+ * Undo-token pattern (08-server-api.md §2.7.3): mutations execute
+ * immediately; before-images are captured in the same transaction; the
+ * reply carries a single-use `undo_<ulid>` token; `POST /data/undo/:token`
+ * runs compensating writes.
+ *
+ * Memory + meta hybrid: the live token index is in-process (single-process
+ * topologies per 08 §6) keyed by SHA-256 of the token; the full undo
+ * payload also lands in the audit row (`changes.undo`) for tamper-evidence
+ * and post-mortems. Tokens expire after 60 s (§2.7.3 step 2).
+ */
+var _a;
+import { createHash, randomBytes } from 'node:crypto';
+export const UNDO_TTL_MS = 60_000;
+function hashToken(token) {
+    return createHash('sha256').update(token).digest('hex');
+}
+export class UndoStore {
+    #entries = new Map();
+    #now;
+    constructor(now = Date.now) {
+        this.#now = now;
+    }
+    issue(entry, ttlMs = UNDO_TTL_MS) {
+        this.#sweep();
+        const token = `undo_${randomBytes(16).toString('hex')}`;
+        const stored = { ...entry, expiresAt: this.#now() + ttlMs };
+        this.#entries.set(hashToken(token), stored);
+        return { token, entry: stored };
+    }
+    /** Single-use: any consume removes the token (expired ones report 410-able state). */
+    consume(token) {
+        const key = hashToken(token);
+        const entry = this.#entries.get(key);
+        if (entry === undefined)
+            return { status: 'unknown' };
+        this.#entries.delete(key);
+        if (entry.expiresAt < this.#now())
+            return { status: 'expired' };
+        return { status: 'ok', entry };
+    }
+    /** Expired entries linger briefly so `consume` can answer 410 instead of 404. */
+    static SWEEP_GRACE_MS = 10 * 60_000;
+    #sweep() {
+        const cutoff = this.#now() - _a.SWEEP_GRACE_MS;
+        for (const [key, entry] of this.#entries) {
+            if (entry.expiresAt < cutoff)
+                this.#entries.delete(key);
+        }
+    }
+    get size() {
+        return this.#entries.size;
+    }
+}
+_a = UndoStore;
+/**
+ * Value-normalizing row comparison for the unchanged-since-mutation check
+ * (§2.7.3 step 4). Dates round-trip as ISO strings; bigints as strings.
+ */
+function normalize(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'bigint')
+        return value.toString();
+    return value;
+}
+export function rowsEqual(a, b, columns) {
+    return columns.every((column) => {
+        const va = normalize(a[column]);
+        const vb = normalize(b[column]);
+        return JSON.stringify(va) === JSON.stringify(vb);
+    });
+}
+//# sourceMappingURL=undo.js.map

package/dist/crud/undo.js.map

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

package/dist/data-io/coerce.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Import-time type coercion (M7-T07): CSV cells are strings; the effective
+ * schema's `logicalType` says what the column wants. Coercion is strict —
+ * a cell that does not parse is a per-row validation issue, never a silent
+ * NULL or NaN — with the two §11.1 auto-resolutions the wizard advertises:
+ * surrounding whitespace is trimmed, and empty cells map to NULL for
+ * nullable columns.
+ */
+import type { ResolvedColumn } from '../crud/identifiers.js';
+export interface CoercionIssue {
+    /** 1-based data-row number (header excluded). */
+    row: number;
+    column: string;
+    code: 'REQUIRED' | 'BAD_NUMBER' | 'BAD_BOOLEAN' | 'BAD_DATE' | 'BAD_JSON';
+    message: string;
+    value: string;
+}
+export type CoercionResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    code: CoercionIssue['code'];
+    message: string;
+};
+/** Coerce one trimmed CSV cell for `column`. Empty cell ⇒ NULL when nullable. */
+export declare function coerceCell(raw: string, column: ResolvedColumn): CoercionResult;
+//# sourceMappingURL=coerce.d.ts.map

package/dist/data-io/coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../src/data-io/coerce.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA2ChE,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,cAAc,CAmE9E"}

package/dist/data-io/coerce.js

@@ -0,0 +1,123 @@
+/**
+ * Import-time type coercion (M7-T07): CSV cells are strings; the effective
+ * schema's `logicalType` says what the column wants. Coercion is strict —
+ * a cell that does not parse is a per-row validation issue, never a silent
+ * NULL or NaN — with the two §11.1 auto-resolutions the wizard advertises:
+ * surrounding whitespace is trimmed, and empty cells map to NULL for
+ * nullable columns.
+ */
+const TRUE_WORDS = new Set(['true', 't', '1', 'yes', 'y', 'on']);
+const FALSE_WORDS = new Set(['false', 'f', '0', 'no', 'n', 'off']);
+/** Plain decimal notation only — `Number()` alone would accept 0x/0b/0o literals. */
+const DECIMAL_RE = /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/;
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const ISO_NAIVE_RE = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d+)?)?$/;
+const ISO_ZONED_RE = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:?\d{2})$/i;
+/**
+ * ISO-only date/timestamp parsing. Bare `Date.parse` reads naive forms
+ * (`2024-03-15 10:00`) and locale forms (`03/15/2024`) as SERVER-LOCAL time,
+ * silently shifting the calendar day/wall clock on any non-UTC server — so:
+ * naive ISO forms are pinned to UTC (wall time preserved), zoned forms keep
+ * their explicit offset, and everything else (locale-ambiguous) is rejected
+ * as a per-row issue per the module's strict-never-silent contract.
+ */
+function isoDateTimeOf(text) {
+    let candidate = null;
+    let expectDay = null;
+    if (ISO_DATE_RE.test(text)) {
+        candidate = `${text}T00:00:00Z`;
+        expectDay = text;
+    }
+    else if (ISO_NAIVE_RE.test(text)) {
+        candidate = `${text.replace(' ', 'T')}Z`;
+        expectDay = text.slice(0, 10);
+    }
+    else if (ISO_ZONED_RE.test(text)) {
+        candidate = text.replace(' ', 'T');
+    }
+    if (candidate === null)
+        return null;
+    const ms = Date.parse(candidate);
+    if (Number.isNaN(ms))
+        return null;
+    const iso = new Date(ms).toISOString();
+    // V8 leniently ROLLS out-of-range days (Feb 30 → Mar 1) instead of failing —
+    // a silent rewrite, so a naive date that does not round-trip is an issue.
+    // (Zoned inputs legitimately shift days when normalized to UTC — exempt.)
+    if (expectDay !== null && iso.slice(0, 10) !== expectDay)
+        return null;
+    return iso;
+}
+/** Coerce one trimmed CSV cell for `column`. Empty cell ⇒ NULL when nullable. */
+export function coerceCell(raw, column) {
+    const text = raw.trim();
+    if (text === '') {
+        if (column.nullable)
+            return { ok: true, value: null };
+        return { ok: false, code: 'REQUIRED', message: `${column.name} is required` };
+    }
+    switch (column.logicalType) {
+        case 'integer':
+        case 'bigint': {
+            if (!/^[+-]?\d+$/.test(text)) {
+                return { ok: false, code: 'BAD_NUMBER', message: `${JSON.stringify(text)} is not an integer` };
+            }
+            const value = Number(text);
+            if (!Number.isSafeInteger(value)) {
+                // Out of double range — hand the digits through as-is (PG bigint).
+                return { ok: true, value: text };
+            }
+            return { ok: true, value };
+        }
+        case 'decimal':
+        case 'float': {
+            // Regex-gated like the integer branch: `Number('0x1f')` is 31, and a
+            // stray hex/binary/octal cell must surface as an issue, not a value.
+            if (!DECIMAL_RE.test(text)) {
+                return { ok: false, code: 'BAD_NUMBER', message: `${JSON.stringify(text)} is not a number` };
+            }
+            const value = Number(text);
+            if (!Number.isFinite(value)) {
+                return { ok: false, code: 'BAD_NUMBER', message: `${JSON.stringify(text)} is not a number` };
+            }
+            return { ok: true, value };
+        }
+        case 'boolean': {
+            const word = text.toLowerCase();
+            if (TRUE_WORDS.has(word))
+                return { ok: true, value: true };
+            if (FALSE_WORDS.has(word))
+                return { ok: true, value: false };
+            return { ok: false, code: 'BAD_BOOLEAN', message: `${JSON.stringify(text)} is not a boolean` };
+        }
+        case 'date':
+        case 'timestamp':
+        case 'timestamptz': {
+            const iso = isoDateTimeOf(text);
+            if (iso === null) {
+                return {
+                    ok: false,
+                    code: 'BAD_DATE',
+                    message: `${JSON.stringify(text)} is not an ISO date (use YYYY-MM-DD[ HH:mm[:ss]][Z])`,
+                };
+            }
+            // §11.1 auto-resolution: normalize to ISO; `date` keeps the date part.
+            return { ok: true, value: column.logicalType === 'date' ? iso.slice(0, 10) : iso };
+        }
+        case 'json': {
+            try {
+                JSON.parse(text);
+                return { ok: true, value: text };
+            }
+            catch {
+                return { ok: false, code: 'BAD_JSON', message: `${column.name} is not valid JSON` };
+            }
+        }
+        // text / varchar / uuid / enum / interval / time / inet / geometry /
+        // binary / unknown: pass the string through — the database is the
+        // authority on the exotic types, and its error becomes the row issue.
+        default:
+            return { ok: true, value: text };
+    }
+}
+//# sourceMappingURL=coerce.js.map

package/dist/data-io/coerce.js.map

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

package/dist/data-io/csv.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Hand-rolled RFC 4180 CSV (M7-T07) — no dependency exists in this repo and
+ * none is added (the workplan's "hand-roll" instruction).
+ *
+ * SERIALIZER decisions (unit-tested in data-io-csv.test.ts):
+ * - Fields are quoted only when they contain a comma, a double quote, CR or
+ *   LF; embedded quotes double (`"" `), per RFC 4180 §2.5–2.7.
+ * - Records join with CRLF (RFC 4180 §2.1); the final record also ends with
+ *   CRLF so concatenating exports remains valid CSV.
+ * - BOM: exports are prefixed with U+FEFF (`EXPORT_BOM`). Excel — the primary
+ *   consumer of a "Download CSV" button — mis-decodes unmarked UTF-8 as
+ *   Windows-1252; every other consumer tolerates the BOM. The parser strips
+ *   it, so Adminium round-trips its own artifacts byte-exactly.
+ * - null/undefined serialize as the empty field; the importer's coercion maps
+ *   the empty field back to NULL for nullable columns. This is lossy for
+ *   empty-string-vs-null on purpose: CSV has no NULL literal.
+ *
+ * PARSER: a streaming state machine — `write(chunk)` may be called with
+ * arbitrary splits (even mid-quote); rows are emitted as soon as complete.
+ * Handles quoted fields, doubled quotes, multiline cells, CRLF/LF/CR line
+ * ends, and a leading BOM.
+ */
+export declare const EXPORT_BOM = "\uFEFF";
+export declare const CRLF = "\r\n";
+/** One value → one RFC 4180 field. */
+export declare function serializeCsvField(value: unknown): string;
+/** One row → one CRLF-terminated record. */
+export declare function serializeCsvRow(values: readonly unknown[]): string;
+export interface CsvParser {
+    /** Feed a chunk (any split point); returns the rows completed by it. */
+    write(chunk: string): string[][];
+    /** Flush the trailing row (no final newline case). */
+    end(): string[][];
+}
+export declare function createCsvParser(): CsvParser;
+/** Whole-string convenience over the streaming parser. */
+export declare function parseCsv(text: string): string[][];
+//# sourceMappingURL=csv.d.ts.map

package/dist/data-io/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/data-io/csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,UAAU,WAAM,CAAC;AAC9B,eAAO,MAAM,IAAI,SAAS,CAAC;AAI3B,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQxD;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAElE;AAID,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;IACjC,sDAAsD;IACtD,GAAG,IAAI,MAAM,EAAE,EAAE,CAAC;CACnB;AAED,wBAAgB,eAAe,IAAI,SAAS,CAuF3C;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAGjD"}

package/dist/data-io/csv.js

@@ -0,0 +1,138 @@
+/**
+ * Hand-rolled RFC 4180 CSV (M7-T07) — no dependency exists in this repo and
+ * none is added (the workplan's "hand-roll" instruction).
+ *
+ * SERIALIZER decisions (unit-tested in data-io-csv.test.ts):
+ * - Fields are quoted only when they contain a comma, a double quote, CR or
+ *   LF; embedded quotes double (`"" `), per RFC 4180 §2.5–2.7.
+ * - Records join with CRLF (RFC 4180 §2.1); the final record also ends with
+ *   CRLF so concatenating exports remains valid CSV.
+ * - BOM: exports are prefixed with U+FEFF (`EXPORT_BOM`). Excel — the primary
+ *   consumer of a "Download CSV" button — mis-decodes unmarked UTF-8 as
+ *   Windows-1252; every other consumer tolerates the BOM. The parser strips
+ *   it, so Adminium round-trips its own artifacts byte-exactly.
+ * - null/undefined serialize as the empty field; the importer's coercion maps
+ *   the empty field back to NULL for nullable columns. This is lossy for
+ *   empty-string-vs-null on purpose: CSV has no NULL literal.
+ *
+ * PARSER: a streaming state machine — `write(chunk)` may be called with
+ * arbitrary splits (even mid-quote); rows are emitted as soon as complete.
+ * Handles quoted fields, doubled quotes, multiline cells, CRLF/LF/CR line
+ * ends, and a leading BOM.
+ */
+export const EXPORT_BOM = '';
+export const CRLF = '\r\n';
+const NEEDS_QUOTING = /[",\r\n]/;
+/** One value → one RFC 4180 field. */
+export function serializeCsvField(value) {
+    if (value === null || value === undefined)
+        return '';
+    let text;
+    if (value instanceof Date)
+        text = value.toISOString();
+    else if (typeof value === 'object')
+        text = JSON.stringify(value);
+    else
+        text = String(value);
+    if (NEEDS_QUOTING.test(text))
+        return `"${text.replaceAll('"', '""')}"`;
+    return text;
+}
+/** One row → one CRLF-terminated record. */
+export function serializeCsvRow(values) {
+    return values.map(serializeCsvField).join(',') + CRLF;
+}
+export function createCsvParser() {
+    let field = '';
+    let row = [];
+    let inQuotes = false;
+    /** Just saw a closing quote — next char decides doubled-quote vs end. */
+    let quoteEnded = false;
+    /** Just saw a CR — swallow one following LF. */
+    let afterCr = false;
+    let first = true;
+    let sawAny = false;
+    function endField() {
+        row.push(field);
+        field = '';
+        quoteEnded = false;
+    }
+    function endRow(out) {
+        endField();
+        out.push(row);
+        row = [];
+    }
+    function write(chunk) {
+        const out = [];
+        let text = chunk;
+        if (first) {
+            if (text.startsWith(EXPORT_BOM))
+                text = text.slice(EXPORT_BOM.length);
+            if (text.length > 0)
+                first = false;
+        }
+        for (const ch of text) {
+            sawAny = true;
+            if (afterCr) {
+                afterCr = false;
+                if (ch === '\n')
+                    continue; // CRLF — LF already handled by the CR
+            }
+            if (inQuotes) {
+                if (quoteEnded) {
+                    if (ch === '"') {
+                        field += '"'; // doubled quote
+                        quoteEnded = false;
+                        continue;
+                    }
+                    inQuotes = false;
+                    quoteEnded = false;
+                    // fall through: ch closes/continues the field unquoted
+                }
+                else if (ch === '"') {
+                    quoteEnded = true;
+                    continue;
+                }
+                else {
+                    field += ch;
+                    continue;
+                }
+            }
+            if (ch === '"' && field.length === 0) {
+                inQuotes = true;
+                continue;
+            }
+            if (ch === ',') {
+                endField();
+                continue;
+            }
+            if (ch === '\n') {
+                endRow(out);
+                continue;
+            }
+            if (ch === '\r') {
+                endRow(out);
+                afterCr = true;
+                continue;
+            }
+            field += ch;
+        }
+        return out;
+    }
+    function end() {
+        const out = [];
+        // A trailing unterminated quote is treated as a terminated field (lenient).
+        if (field.length > 0 || row.length > 0 || (sawAny && inQuotes)) {
+            endRow(out);
+            inQuotes = false;
+        }
+        return out;
+    }
+    return { write, end };
+}
+/** Whole-string convenience over the streaming parser. */
+export function parseCsv(text) {
+    const parser = createCsvParser();
+    return [...parser.write(text), ...parser.end()];
+}
+//# sourceMappingURL=csv.js.map

package/dist/data-io/csv.js.map

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

package/dist/data-io/snapshot-view.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Out-of-request SnapshotView loading (M7-T07): the export/import jobs and
+ * routes need the same snapshot-allowlisted identifier resolution the data
+ * routes use (08 §7 item 1), but run outside `dataRoutes`' request-scoped
+ * cache. Same recipe: latest snapshot + active overrides → effective model.
+ */
+import { type MetaDb } from '@adminium/meta';
+import { SnapshotView } from '../crud/identifiers.js';
+export declare function loadSnapshotView(meta: MetaDb, connectionId: string): Promise<SnapshotView>;
+//# sourceMappingURL=snapshot-view.d.ts.map

package/dist/data-io/snapshot-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-view.d.ts","sourceRoot":"","sources":["../../src/data-io/snapshot-view.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgC,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI3E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAOhG"}

package/dist/data-io/snapshot-view.js

@@ -0,0 +1,19 @@
+/**
+ * Out-of-request SnapshotView loading (M7-T07): the export/import jobs and
+ * routes need the same snapshot-allowlisted identifier resolution the data
+ * routes use (08 §7 item 1), but run outside `dataRoutes`' request-scoped
+ * cache. Same recipe: latest snapshot + active overrides → effective model.
+ */
+import { overridesRepo, snapshotsRepo } from '@adminium/meta';
+import { applyOverrides } from '../connections/effective-schema.js';
+import { SnapshotView } from '../crud/identifiers.js';
+import { NotFoundError } from '../errors.js';
+export async function loadSnapshotView(meta, connectionId) {
+    const snapshot = await snapshotsRepo(meta).latest(connectionId);
+    if (snapshot === null) {
+        throw new NotFoundError('No schema snapshot — introspect the connection first.', { connectionId });
+    }
+    const active = await overridesRepo(meta).listForConnection(connectionId, { status: 'active' });
+    return new SnapshotView(connectionId, applyOverrides(snapshot.schema, active));
+}
+//# sourceMappingURL=snapshot-view.js.map

package/dist/data-io/snapshot-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-view.js","sourceRoot":"","sources":["../../src/data-io/snapshot-view.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAe,MAAM,gBAAgB,CAAC;AAG3E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,YAAoB;IACvE,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAChE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,aAAa,CAAC,uDAAuD,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/F,OAAO,IAAI,YAAY,CAAC,YAAY,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAuB,EAAE,MAAM,CAAC,CAAC,CAAC;AAClG,CAAC"}

package/dist/desktop/demo-seed.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Is the §6 demo database available in this build (11-electron.md §6 step 2
+ * card 4)?
+ *
+ * ─── ONE PREDICATE, TWO CALLERS, AND THAT IS THE ENTIRE POINT ────────────────
+ *
+ * `compose.ts` decides whether to REGISTER `POST /desktop/demo-database`;
+ * `routes/system/handlers.ts` reports `desktopDemo` on `GET /system/info`, which
+ * is what the first-run wizard gates its fourth source card on. Those two must
+ * answer identically or the product lies in one of two directions: a card that
+ * 404s when clicked, or a card that explains it is unavailable while the route
+ * sits there working.
+ *
+ * Both conditions are load-bearing, and `compose.ts` already says why: the
+ * runtime, because self-host and Docker have no demo; the script path, because a
+ * desktop boot without `ADMINIUM_DEMO_SEED_SCRIPT` has nothing to run. This
+ * module exists so neither caller can restate them and get one wrong.
+ */
+import type { Env } from '../config/env.js';
+export declare function demoSeedScriptPath(env: Env): string | null;
+/** True ⇔ `POST /api/v1/desktop/demo-database` is mounted on this process. */
+export declare function demoSeedAvailable(env: Env): boolean;
+//# sourceMappingURL=demo-seed.d.ts.map

package/dist/desktop/demo-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-seed.d.ts","sourceRoot":"","sources":["../../src/desktop/demo-seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAE5C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAG1D;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAEnD"}

package/dist/desktop/demo-seed.js

@@ -0,0 +1,28 @@
+/**
+ * Is the §6 demo database available in this build (11-electron.md §6 step 2
+ * card 4)?
+ *
+ * ─── ONE PREDICATE, TWO CALLERS, AND THAT IS THE ENTIRE POINT ────────────────
+ *
+ * `compose.ts` decides whether to REGISTER `POST /desktop/demo-database`;
+ * `routes/system/handlers.ts` reports `desktopDemo` on `GET /system/info`, which
+ * is what the first-run wizard gates its fourth source card on. Those two must
+ * answer identically or the product lies in one of two directions: a card that
+ * 404s when clicked, or a card that explains it is unavailable while the route
+ * sits there working.
+ *
+ * Both conditions are load-bearing, and `compose.ts` already says why: the
+ * runtime, because self-host and Docker have no demo; the script path, because a
+ * desktop boot without `ADMINIUM_DEMO_SEED_SCRIPT` has nothing to run. This
+ * module exists so neither caller can restate them and get one wrong.
+ */
+export function demoSeedScriptPath(env) {
+    if (env.ADMINIUM_RUNTIME !== 'desktop')
+        return null;
+    return env.ADMINIUM_DEMO_SEED_SCRIPT ?? null;
+}
+/** True ⇔ `POST /api/v1/desktop/demo-database` is mounted on this process. */
+export function demoSeedAvailable(env) {
+    return demoSeedScriptPath(env) !== null;
+}
+//# sourceMappingURL=demo-seed.js.map

package/dist/desktop/demo-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-seed.js","sourceRoot":"","sources":["../../src/desktop/demo-seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IACzC,IAAI,GAAG,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,GAAG,CAAC,yBAAyB,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,GAAQ;IACxC,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAC1C,CAAC"}