@niscorp/strata 0.1.1 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/CHANGELOG.md +83 -0
  2. package/DESIGN.md +7 -3
  3. package/README.md +19 -4
  4. package/dist/check/index.cjs +23 -217
  5. package/dist/check/index.cjs.map +1 -1
  6. package/dist/check/index.js +2 -2
  7. package/dist/{chunk-MY3TGSV3.js → chunk-4BLHBVSC.js} +15 -4
  8. package/dist/chunk-4BLHBVSC.js.map +1 -0
  9. package/dist/{chunk-U5CPF4LQ.js → chunk-5KTXEN43.js} +3 -3
  10. package/dist/{chunk-U5CPF4LQ.js.map → chunk-5KTXEN43.js.map} +1 -1
  11. package/dist/{chunk-EGFF63GA.js → chunk-AKKWEXO2.js} +2 -2
  12. package/dist/{chunk-EGFF63GA.js.map → chunk-AKKWEXO2.js.map} +1 -1
  13. package/dist/chunk-ATHZ7HT5.cjs +18 -0
  14. package/dist/chunk-ATHZ7HT5.cjs.map +1 -0
  15. package/dist/chunk-CL5DF2IQ.cjs +192 -0
  16. package/dist/chunk-CL5DF2IQ.cjs.map +1 -0
  17. package/dist/chunk-IHYBGLNW.cjs +161 -0
  18. package/dist/chunk-IHYBGLNW.cjs.map +1 -0
  19. package/dist/chunk-KNBS3AJZ.cjs +223 -0
  20. package/dist/chunk-KNBS3AJZ.cjs.map +1 -0
  21. package/dist/{chunk-ICWKTTKN.js → chunk-OLDORFOQ.js} +12 -7
  22. package/dist/chunk-OLDORFOQ.js.map +1 -0
  23. package/dist/{chunk-HMT7HHFJ.js → chunk-WU3OJHVZ.js} +4 -4
  24. package/dist/{chunk-HMT7HHFJ.js.map → chunk-WU3OJHVZ.js.map} +1 -1
  25. package/dist/chunk-YXFEJJMC.cjs +136 -0
  26. package/dist/chunk-YXFEJJMC.cjs.map +1 -0
  27. package/dist/index.cjs +75 -325
  28. package/dist/index.cjs.map +1 -1
  29. package/dist/index.d.cts +1 -1
  30. package/dist/index.d.ts +1 -1
  31. package/dist/index.js +3 -3
  32. package/dist/node/index.cjs +14 -477
  33. package/dist/node/index.cjs.map +1 -1
  34. package/dist/node/index.js +5 -5
  35. package/dist/{plan-BEIlXVUt.d.cts → plan-CxuteSH1.d.cts} +2 -2
  36. package/dist/{plan-BAewc8DG.d.ts → plan-mFmdh0qT.d.ts} +2 -2
  37. package/dist/postgres/index.cjs +36 -206
  38. package/dist/postgres/index.cjs.map +1 -1
  39. package/dist/postgres/index.d.cts +7 -2
  40. package/dist/postgres/index.d.ts +7 -2
  41. package/dist/postgres/index.js +24 -12
  42. package/dist/postgres/index.js.map +1 -1
  43. package/dist/upgrade/index.cjs +19 -229
  44. package/dist/upgrade/index.cjs.map +1 -1
  45. package/dist/upgrade/index.js +3 -3
  46. package/package.json +3 -2
  47. package/dist/chunk-ICWKTTKN.js.map +0 -1
  48. package/dist/chunk-MY3TGSV3.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/postgres/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { prepare, planMigrations, refuseProblems, type LedgerRow, type Plan, type PreparedMigration, type PreparedSequence } from '../plan';\nimport type { Sequence } from '../schema';\nimport type { UpgradeResult, Upgrader } from '../documents';\nimport { StrataError } from '../errors';\n\n// ═══════════════════════════════════════════════════════════════\n// @niscorp/strata/postgres — the ledger, and the one path DDL takes.\n//\n// A run is ONE TRANSACTION under an advisory lock: take the lock, make sure the\n// ledger exists, read it, plan against it, apply every pending step and record\n// each migration as it lands. Anything throws, nothing happened — Postgres DDL\n// is transactional, so a half-migrated database is not a state this can leave.\n// Two processes booting at once serialize on the lock; the second finds the\n// work done.\n//\n// The ledger's own table is the only statement strata runs outside a ledger —\n// the base case, the way every migration system has one.\n// ═══════════════════════════════════════════════════════════════\n\n// The pool shape nisc passes everywhere (vex's PgPool, a PGlite shim, a `pg`\n// pool wrapped to check a client out per transaction). Structural — strata\n// depends on no driver.\nexport type StrataQuery = (text: string, values?: unknown[]) => Promise<{ rows: Record<string, unknown>[] }>;\nexport type StrataPool = {\n query: StrataQuery;\n transaction?: <T>(fn: (tx: { query: StrataQuery }) => Promise<T>) => Promise<T>;\n};\n\nexport type LedgerOptions = {\n // Default `strata_ledger`, in the connection's current schema — beside the\n // app's own tables.\n table?: string;\n schema?: string;\n};\n\nexport type MigrateOptions = LedgerOptions & {\n // `apply` (default): run what is pending. `verify`: refuse if anything is —\n // a production boot that expects a deploy step to have migrated already.\n mode?: 'apply' | 'verify';\n};\n\nexport type MigrateReport = {\n // What this run applied, in order.\n applied: readonly PreparedMigration[];\n // The plan it acted on (per-sequence positions before the run).\n plan: Plan;\n};\n\nconst IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst quote = (name: string, label: string): string => {\n if (!IDENT.test(name)) throw new StrataError('INVALID_SEQUENCE', `The ledger ${label} \"${name}\" is not a plain identifier.`);\n return `\"${name}\"`;\n};\n\nconst ledgerNameOf = (options: LedgerOptions): { qualified: string; schema: string | undefined } => {\n const table = quote(options.table ?? 'strata_ledger', 'table');\n const schema = options.schema === undefined ? undefined : quote(options.schema, 'schema');\n return { qualified: schema === undefined ? table : `${schema}.${table}`, schema };\n};\n\nexport const ledgerDdl = (options: LedgerOptions = {}): string => {\n const { qualified } = ledgerNameOf(options);\n return `CREATE TABLE IF NOT EXISTS ${qualified} (\n sequence text NOT NULL,\n n integer NOT NULL,\n description text NOT NULL,\n checksum text NOT NULL,\n applied_at timestamptz NOT NULL DEFAULT now(),\n PRIMARY KEY (sequence, n)\n)`;\n};\n\nconst text = (value: unknown): string => (value instanceof Date ? value.toISOString() : String(value));\n\nconst readRows = async (query: StrataQuery, qualified: string): Promise<LedgerRow[]> => {\n const { rows } = await query(`SELECT sequence, n, checksum, description, applied_at FROM ${qualified} ORDER BY sequence, n`);\n return rows.map((row) => ({\n sequence: text(row['sequence']),\n n: Number(row['n']),\n checksum: text(row['checksum']),\n description: text(row['description']),\n appliedAt: text(row['applied_at']),\n }));\n};\n\n// The ledger as it stands — read-only, no lock, no table created. A database\n// that has never been migrated has an empty ledger.\nexport const readLedger = async (pool: StrataPool, options: LedgerOptions = {}): Promise<LedgerRow[]> => {\n const { qualified } = ledgerNameOf(options);\n const { rows } = await pool.query('SELECT to_regclass($1) IS NOT NULL AS present', [qualified]);\n if (rows[0]?.['present'] !== true) return [];\n return readRows(pool.query, qualified);\n};\n\n// What `migrate` would do, without doing it — for a boot report, a CI check, a\n// page that shows the ledger.\nexport const status = async (pool: StrataPool, sequences: readonly Sequence[], options: LedgerOptions = {}): Promise<Plan> =>\n planMigrations(await prepare(sequences), await readLedger(pool, options));\n\nconst refuseGrammars = (prepared: readonly PreparedSequence[]): void => {\n const grammars = prepared.filter((s) => s.grammar);\n if (grammars.length > 0) {\n throw new StrataError(\n 'WRONG_OWNER',\n 'These sequences own documents, not tables: a document carries its own stamp and is upgraded where it is read (`createUpgrader`, `upgradeStore`) — never recorded in a database\\'s ledger.',\n grammars.map((s) => s.id),\n );\n }\n};\n\nexport const migrate = async (pool: StrataPool, sequences: readonly Sequence[], options: MigrateOptions = {}): Promise<MigrateReport> => {\n const prepared = await prepare(sequences);\n refuseGrammars(prepared);\n const { transaction } = pool;\n if (transaction === undefined) {\n throw new StrataError(\n 'NO_TRANSACTION',\n 'This pool cannot run a transaction, and a migration run must land whole or not at all. ' +\n 'Pass a pool with `transaction` (vex\\'s PGlite pool has one; wrap a `pg` Pool so it checks a client out per transaction).',\n );\n }\n const { qualified, schema } = ledgerNameOf(options);\n\n return transaction(async (tx) => {\n // The lock first: two processes creating the ledger at once would race in\n // the catalog before either reached a row.\n await tx.query('SELECT pg_advisory_xact_lock(hashtext($1))', [`strata:${qualified}`]);\n if (schema !== undefined) await tx.query(`CREATE SCHEMA IF NOT EXISTS ${schema}`);\n await tx.query(ledgerDdl(options));\n\n const plan = planMigrations(prepared, await readRows(tx.query, qualified));\n refuseProblems(plan);\n if (options.mode === 'verify' && plan.pending.length > 0) {\n throw new StrataError(\n 'PENDING',\n `${plan.pending.length} migration${plan.pending.length === 1 ? ' is' : 's are'} not applied, and this boot only verifies. Run the migrations first.`,\n plan.pending.map((m) => `${m.ref} ${m.description}`),\n );\n }\n\n const applied: PreparedMigration[] = [];\n for (const migration of plan.pending) {\n for (const [index, step] of migration.steps.entries()) {\n // Only table sequences reach the ledger (refuseGrammars above).\n if (step.kind !== 'sql') continue;\n try {\n await tx.query(step.sql);\n } catch (cause) {\n throw new StrataError(\n 'STEP_FAILED',\n `${migration.ref} (\"${migration.description}\") failed at step ${index + 1} of ${migration.steps.length}. Nothing from this run was applied.`,\n [cause instanceof Error ? cause.message : String(cause), step.sql.length > 300 ? `${step.sql.slice(0, 300)}…` : step.sql],\n { cause },\n );\n }\n }\n await tx.query(`INSERT INTO ${qualified} (sequence, n, description, checksum) VALUES ($1, $2, $3, $4)`, [\n migration.sequence,\n migration.n,\n migration.description,\n migration.checksum,\n ]);\n applied.push(migration);\n }\n return { applied, plan };\n });\n};\n\n// ═══════════════════════════════════════════════════════════════\n// Stores — tables whose rows hold documents.\n//\n// A store names where the documents live: the table, the jsonb column holding\n// each document, the jsonb column holding its stamp, the kind every document\n// in it is, and the key that identifies a row. The table itself (and its stamp\n// column) is its owner's, created by the owner's TABLE sequence; strata only\n// reads and rewrites rows.\n//\n// `upgradeStore` brings every row that is behind up to the code, in one\n// transaction, and writes each back with a current stamp. A row written by\n// newer code refuses the whole run (TOO_NEW) — the same answer the ledger\n// gives, one row at a time. Read paths that cannot wait for a boot upgrade the\n// row they read with the same upgrader; this is the pass that makes that rare.\n// ═══════════════════════════════════════════════════════════════\n\nexport type DocumentStore = {\n table: string;\n schema?: string;\n // The jsonb column holding the document.\n column: string;\n // The jsonb column holding the document's stamp (`{}` means \"before stamps\").\n stamp: string;\n // Every document in this store is of this kind, e.g. \"nisc.nova/action\".\n kind: string;\n // The columns that identify a row.\n key: readonly string[];\n};\n\nexport type StoreReport = {\n // Rows read, and rows that were behind and rewritten.\n total: number;\n upgraded: number;\n // Per migration ref, how many rows it rewrote.\n applied: Readonly<Record<string, number>>;\n};\n\nexport const upgradeStore = async (pool: StrataPool, store: DocumentStore, upgrader: Upgrader): Promise<StoreReport> => {\n const { transaction } = pool;\n if (transaction === undefined) {\n throw new StrataError('NO_TRANSACTION', 'Rewriting a store must land whole or not at all; this pool cannot run a transaction.');\n }\n const table = store.schema === undefined ? quote(store.table, 'table') : `${quote(store.schema, 'schema')}.${quote(store.table, 'table')}`;\n const column = quote(store.column, 'column');\n const stamp = quote(store.stamp, 'column');\n const keys = store.key.map((k) => quote(k, 'column'));\n if (keys.length === 0) throw new StrataError('INVALID_SEQUENCE', `The store ${store.table} names no key columns.`);\n\n return transaction(async (tx) => {\n const { rows } = await tx.query(`SELECT ${[...keys, column, stamp].join(', ')} FROM ${table} FOR UPDATE`);\n const applied: Record<string, number> = {};\n let upgraded = 0;\n for (const row of rows) {\n const given = row[store.stamp];\n const rowStamp = typeof given === 'object' && given !== null && !Array.isArray(given) ? Object.fromEntries(Object.entries(given).map(([k, v]) => [k, Number(v)])) : {};\n const where = store.key.map((k) => `${k}=${JSON.stringify(row[k])}`).join(', ');\n let result: UpgradeResult;\n try {\n if (!upgrader.behind(rowStamp)) continue;\n result = upgrader.upgrade(row[store.column], { kind: store.kind, stamp: rowStamp });\n } catch (cause) {\n if (cause instanceof StrataError) {\n throw new StrataError(cause.code, `${store.table} (${where}): ${cause.message.split('\\n')[0] ?? ''}`, cause.details, { cause });\n }\n throw cause;\n }\n await tx.query(\n `UPDATE ${table} SET ${column} = $1::jsonb, ${stamp} = $2::jsonb WHERE ${keys.map((k, i) => `${k} = $${i + 3}`).join(' AND ')}`,\n [JSON.stringify(result.document), JSON.stringify(result.stamp), ...store.key.map((k) => row[k])],\n );\n upgraded += 1;\n for (const ref of result.applied) applied[ref] = (applied[ref] ?? 0) + 1;\n }\n return { total: rows.length, upgraded, applied };\n });\n};\n"]}
1
+ {"version":3,"sources":["../../src/postgres/index.ts"],"names":[],"mappings":";;;;AAgEA,IAAM,KAAA,GAAQ,0BAAA;AACd,IAAM,KAAA,GAAQ,CAAC,IAAA,EAAc,KAAA,KAA0B;AACrD,EAAA,IAAI,CAAC,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA,EAAG,MAAM,IAAI,WAAA,CAAY,kBAAA,EAAoB,CAAA,WAAA,EAAc,KAAK,CAAA,EAAA,EAAK,IAAI,CAAA,4BAAA,CAA8B,CAAA;AAC3H,EAAA,OAAO,IAAI,IAAI,CAAA,CAAA,CAAA;AACjB,CAAA;AAEA,IAAM,YAAA,GAAe,CAAC,OAAA,KAA8E;AAClG,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,OAAA,CAAQ,KAAA,IAAS,iBAAiB,OAAO,CAAA;AAC7D,EAAA,MAAM,MAAA,GAAS,QAAQ,MAAA,KAAW,MAAA,GAAY,SAAY,KAAA,CAAM,OAAA,CAAQ,QAAQ,QAAQ,CAAA;AACxF,EAAA,OAAO,EAAE,SAAA,EAAW,MAAA,KAAW,MAAA,GAAY,KAAA,GAAQ,GAAG,MAAM,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,EAAI,MAAA,EAAO;AAClF,CAAA;AAEO,IAAM,SAAA,GAAY,CAAC,OAAA,GAAyB,EAAC,KAAc;AAChE,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,YAAA,CAAa,OAAO,CAAA;AAC1C,EAAA,OAAO,8BAA8B,SAAS,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA,CAAA;AAQhD;AAEA,IAAM,IAAA,GAAO,CAAC,KAAA,KAA4B,KAAA,YAAiB,OAAO,KAAA,CAAM,WAAA,EAAY,GAAI,MAAA,CAAO,KAAK,CAAA;AAEpG,IAAM,QAAA,GAAW,OAAO,EAAA,EAA4B,SAAA,KAA4C;AAC9F,EAAA,MAAM,EAAE,MAAK,GAAI,MAAM,GAAG,KAAA,CAAM,CAAA,2DAAA,EAA8D,SAAS,CAAA,qBAAA,CAAuB,CAAA;AAC9H,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,IACxB,QAAA,EAAU,IAAA,CAAK,GAAA,CAAI,UAAU,CAAC,CAAA;AAAA,IAC9B,CAAA,EAAG,MAAA,CAAO,GAAA,CAAI,GAAG,CAAC,CAAA;AAAA,IAClB,QAAA,EAAU,IAAA,CAAK,GAAA,CAAI,UAAU,CAAC,CAAA;AAAA,IAC9B,WAAA,EAAa,IAAA,CAAK,GAAA,CAAI,aAAa,CAAC,CAAA;AAAA,IACpC,SAAA,EAAW,IAAA,CAAK,GAAA,CAAI,YAAY,CAAC;AAAA,GACnC,CAAE,CAAA;AACJ,CAAA;AAIO,IAAM,UAAA,GAAa,OAAO,IAAA,EAAkB,OAAA,GAAyB,EAAC,KAA4B;AACvG,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,YAAA,CAAa,OAAO,CAAA;AAC1C,EAAA,MAAM,EAAE,MAAK,GAAI,MAAM,KAAK,KAAA,CAAM,+CAAA,EAAiD,CAAC,SAAS,CAAC,CAAA;AAC9F,EAAA,IAAI,KAAK,CAAC,CAAA,GAAI,SAAS,CAAA,KAAM,IAAA,SAAa,EAAC;AAC3C,EAAA,OAAO,QAAA,CAAS,MAAM,SAAS,CAAA;AACjC;AAIO,IAAM,SAAS,OAAO,IAAA,EAAkB,SAAA,EAAgC,OAAA,GAAyB,EAAC,KACvG,cAAA,CAAe,MAAM,OAAA,CAAQ,SAAS,CAAA,EAAG,MAAM,UAAA,CAAW,IAAA,EAAM,OAAO,CAAC;AAE1E,IAAM,cAAA,GAAiB,CAAC,QAAA,KAAgD;AACtE,EAAA,MAAM,WAAW,QAAA,CAAS,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,OAAO,CAAA;AACjD,EAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AACvB,IAAA,MAAM,IAAI,WAAA;AAAA,MACR,aAAA;AAAA,MACA,+LAAA;AAAA,MACA,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,EAAE;AAAA,KAC1B;AAAA,EACF;AACF,CAAA;AAEO,IAAM,UAAU,OAAO,IAAA,EAAkB,SAAA,EAAgC,OAAA,GAA0B,EAAC,KAA8B;AACvI,EAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,SAAS,CAAA;AACxC,EAAA,cAAA,CAAe,QAAQ,CAAA;AACvB,EAAA,IAAI,IAAA,CAAK,gBAAgB,MAAA,EAAW;AAClC,IAAA,MAAM,IAAI,WAAA;AAAA,MACR,gBAAA;AAAA,MACA;AAAA,KAEF;AAAA,EACF;AACA,EAAA,MAAM,EAAE,SAAA,EAAW,MAAA,EAAO,GAAI,aAAa,OAAO,CAAA;AAGlD,EAAA,MAAM,SAAA,GAAY,IAAI,KAAA,CAAM,iBAAiB,CAAA;AAC7C,EAAA,IAAI,YAAA;AAEJ,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,WAAA,CAAY,OAAO,EAAA,KAAO;AAGzC,IAAA,MAAM,GAAG,KAAA,CAAM,4CAAA,EAA8C,CAAC,CAAA,OAAA,EAAU,SAAS,EAAE,CAAC,CAAA;AACpF,IAAA,IAAI,WAAW,MAAA,EAAW,MAAM,GAAG,KAAA,CAAM,CAAA,4BAAA,EAA+B,MAAM,CAAA,CAAE,CAAA;AAChF,IAAA,MAAM,EAAA,CAAG,KAAA,CAAM,SAAA,CAAU,OAAO,CAAC,CAAA;AAEjC,IAAA,MAAM,OAAO,cAAA,CAAe,QAAA,EAAU,MAAM,QAAA,CAAS,EAAA,EAAI,SAAS,CAAC,CAAA;AACnE,IAAA,cAAA,CAAe,IAAI,CAAA;AACnB,IAAA,IAAI,QAAQ,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,OAAA,CAAQ,SAAS,CAAA,EAAG;AACxD,MAAA,MAAM,IAAI,WAAA;AAAA,QACR,SAAA;AAAA,QACA,CAAA,EAAG,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,UAAA,EAAa,KAAK,OAAA,CAAQ,MAAA,KAAW,CAAA,GAAI,KAAA,GAAQ,OAAO,CAAA,oEAAA,CAAA;AAAA,QAC9E,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,GAAG,CAAA,EAAA,EAAK,CAAA,CAAE,WAAW,CAAA,CAAE;AAAA,OACtD;AAAA,IACF;AAEA,IAAA,MAAM,UAA+B,EAAC;AACtC,IAAA,KAAA,MAAW,SAAA,IAAa,KAAK,OAAA,EAAS;AACpC,MAAA,KAAA,MAAW,CAAC,KAAA,EAAO,IAAI,KAAK,SAAA,CAAU,KAAA,CAAM,SAAQ,EAAG;AAErD,QAAA,IAAI,IAAA,CAAK,SAAS,KAAA,EAAO;AACzB,QAAA,IAAI;AACF,UAAA,MAAM,EAAA,CAAG,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAAA,QACzB,SAAS,KAAA,EAAO;AACd,UAAA,MAAM,IAAI,WAAA;AAAA,YACR,aAAA;AAAA,YACA,CAAA,EAAG,SAAA,CAAU,GAAG,CAAA,GAAA,EAAM,SAAA,CAAU,WAAW,CAAA,kBAAA,EAAqB,KAAA,GAAQ,CAAC,CAAA,IAAA,EAAO,SAAA,CAAU,KAAA,CAAM,MAAM,CAAA,oCAAA,CAAA;AAAA,YACtG,CAAC,iBAAiB,KAAA,GAAQ,KAAA,CAAM,UAAU,MAAA,CAAO,KAAK,GAAG,IAAA,CAAK,GAAA,CAAI,SAAS,GAAA,GAAM,CAAA,EAAG,KAAK,GAAA,CAAI,KAAA,CAAM,GAAG,GAAG,CAAC,CAAA,MAAA,CAAA,GAAM,IAAA,CAAK,GAAG,CAAA;AAAA,YACxH,EAAE,KAAA;AAAM,WACV;AAAA,QACF;AAAA,MACF;AACA,MAAA,MAAM,EAAA,CAAG,KAAA,CAAM,CAAA,YAAA,EAAe,SAAS,CAAA,6DAAA,CAAA,EAAiE;AAAA,QACtG,SAAA,CAAU,QAAA;AAAA,QACV,SAAA,CAAU,CAAA;AAAA,QACV,SAAA,CAAU,WAAA;AAAA,QACV,SAAA,CAAU;AAAA,OACX,CAAA;AACD,MAAA,OAAA,CAAQ,KAAK,SAAS,CAAA;AAAA,IACxB;AAEA,IAAA,MAAM,OAAA,GAAU,QAAQ,KAAA,KAAU,MAAA,GAAY,EAAC,GAAI,MAAM,OAAA,CAAQ,KAAA,CAAM,EAAE,CAAA;AACzE,IAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACtB,MAAA,MAAM,IAAI,WAAA,CAAY,cAAA,EAAgB,6FAAA,EAA+F,OAAO,CAAA;AAAA,IAC9I;AACA,IAAA,IAAI,OAAA,CAAQ,WAAW,IAAA,EAAM;AAC3B,MAAA,YAAA,GAAe,EAAE,SAAS,IAAA,EAAK;AAC/B,MAAA,MAAM,SAAA;AAAA,IACR;AACA,IAAA,OAAO,EAAE,SAAS,IAAA,EAAK;AAAA,EACzB,CAAC,CAAA;AAED,EAAA,OAAO,GAAA,CAAI,KAAA,CAAM,CAAC,KAAA,KAAmB;AACnC,IAAA,IAAI,KAAA,KAAU,SAAA,IAAa,YAAA,KAAiB,MAAA,EAAW,OAAO,YAAA;AAC9D,IAAA,MAAM,KAAA;AAAA,EACR,CAAC,CAAA;AACH;AAuCO,IAAM,YAAA,GAAe,OAAO,IAAA,EAAkB,KAAA,EAAsB,QAAA,KAA6C;AACtH,EAAA,IAAI,IAAA,CAAK,gBAAgB,MAAA,EAAW;AAClC,IAAA,MAAM,IAAI,WAAA,CAAY,gBAAA,EAAkB,sFAAsF,CAAA;AAAA,EAChI;AACA,EAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,KAAW,MAAA,GAAY,MAAM,KAAA,CAAM,KAAA,EAAO,OAAO,CAAA,GAAI,CAAA,EAAG,MAAM,KAAA,CAAM,MAAA,EAAQ,QAAQ,CAAC,CAAA,CAAA,EAAI,MAAM,KAAA,CAAM,KAAA,EAAO,OAAO,CAAC,CAAA,CAAA;AACxI,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,KAAA,CAAM,MAAA,EAAQ,QAAQ,CAAA;AAC3C,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,KAAA,EAAO,QAAQ,CAAA;AACzC,EAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,GAAA,CAAI,CAAC,CAAA,KAAM,KAAA,CAAM,CAAA,EAAG,QAAQ,CAAC,CAAA;AACpD,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,MAAM,IAAI,YAAY,kBAAA,EAAoB,CAAA,UAAA,EAAa,KAAA,CAAM,KAAK,CAAA,sBAAA,CAAwB,CAAA;AAEjH,EAAA,OAAO,IAAA,CAAK,WAAA,CAAY,OAAO,EAAA,KAAO;AACpC,IAAA,MAAM,EAAE,IAAA,EAAK,GAAI,MAAM,EAAA,CAAG,KAAA,CAAM,UAAU,CAAC,GAAG,IAAA,EAAM,MAAA,EAAQ,KAAK,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,MAAA,EAAS,KAAK,CAAA,WAAA,CAAa,CAAA;AACxG,IAAA,MAAM,UAAkC,EAAC;AACzC,IAAA,IAAI,QAAA,GAAW,CAAA;AACf,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,KAAA,CAAM,KAAK,CAAA;AAC7B,MAAA,MAAM,QAAA,GAAW,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,IAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,MAAA,CAAO,YAAY,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM,CAAC,CAAA,EAAG,MAAA,CAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAC;AACrK,MAAA,MAAM,QAAQ,KAAA,CAAM,GAAA,CAAI,IAAI,CAAC,CAAA,KAAM,GAAG,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,SAAA,CAAU,IAAI,CAAC,CAAC,CAAC,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAC9E,MAAA,IAAI,MAAA;AACJ,MAAA,IAAI;AACF,QAAA,IAAI,CAAC,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAA,EAAG;AAChC,QAAA,MAAA,GAAS,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,MAAM,CAAA,EAAG,EAAE,IAAA,EAAM,KAAA,CAAM,IAAA,EAAM,KAAA,EAAO,QAAA,EAAU,CAAA;AAAA,MACpF,SAAS,KAAA,EAAO;AACd,QAAA,IAAI,iBAAiB,WAAA,EAAa;AAChC,UAAA,MAAM,IAAI,YAAY,KAAA,CAAM,IAAA,EAAM,GAAG,KAAA,CAAM,KAAK,CAAA,EAAA,EAAK,KAAK,CAAA,GAAA,EAAM,KAAA,CAAM,QAAQ,KAAA,CAAM,IAAI,CAAA,CAAE,CAAC,CAAA,IAAK,EAAE,IAAI,KAAA,CAAM,OAAA,EAAS,EAAE,KAAA,EAAO,CAAA;AAAA,QAChI;AACA,QAAA,MAAM,KAAA;AAAA,MACR;AACA,MAAA,MAAM,EAAA,CAAG,KAAA;AAAA,QACP,CAAA,OAAA,EAAU,KAAK,CAAA,KAAA,EAAQ,MAAM,iBAAiB,KAAK,CAAA,mBAAA,EAAsB,KAAK,GAAA,CAAI,CAAC,GAAG,CAAA,KAAM,CAAA,EAAG,CAAC,CAAA,IAAA,EAAO,CAAA,GAAI,CAAC,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,OAAO,CAAC,CAAA,CAAA;AAAA,QAC7H,CAAC,KAAK,SAAA,CAAU,MAAA,CAAO,QAAQ,CAAA,EAAG,IAAA,CAAK,UAAU,MAAA,CAAO,KAAK,GAAG,GAAG,KAAA,CAAM,IAAI,GAAA,CAAI,CAAC,MAAM,GAAA,CAAI,CAAC,CAAC,CAAC;AAAA,OACjG;AACA,MAAA,QAAA,IAAY,CAAA;AACZ,MAAA,KAAA,MAAW,GAAA,IAAO,OAAO,OAAA,EAAS,OAAA,CAAQ,GAAG,CAAA,GAAA,CAAK,OAAA,CAAQ,GAAG,CAAA,IAAK,CAAA,IAAK,CAAA;AAAA,IACzE;AACA,IAAA,OAAO,EAAE,KAAA,EAAO,IAAA,CAAK,MAAA,EAAQ,UAAU,OAAA,EAAQ;AAAA,EACjD,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["import { prepare, planMigrations, refuseProblems, type LedgerRow, type Plan, type PreparedMigration, type PreparedSequence } from '../plan';\nimport type { Sequence } from '../schema';\nimport type { UpgradeResult, Upgrader } from '../documents';\nimport { StrataError } from '../errors';\n\n// ═══════════════════════════════════════════════════════════════\n// @niscorp/strata/postgres — the ledger, and the one path DDL takes.\n//\n// A run is ONE TRANSACTION under an advisory lock: take the lock, make sure the\n// ledger exists, read it, plan against it, apply every pending step and record\n// each migration as it lands. Anything throws, nothing happened — Postgres DDL\n// is transactional, so a half-migrated database is not a state this can leave.\n// Two processes booting at once serialize on the lock; the second finds the\n// work done.\n//\n// The ledger's own table is the only statement strata runs outside a ledger —\n// the base case, the way every migration system has one.\n// ═══════════════════════════════════════════════════════════════\n\n// The pool shape nisc passes everywhere (vex's PgPool, a PGlite shim, a `pg`\n// pool wrapped to check a client out per transaction). Structural — strata\n// depends on no driver.\n//\n// `query` and `transaction` are called ON the object that has them, never\n// taken off it first. A driver's own object (a PGlite, a `pg` client handed\n// through as the transaction) has them as methods that reach for `this`; taken\n// off, they fail inside the driver on a property nobody here has heard of.\nexport type StrataQuery = (text: string, values?: unknown[]) => Promise<{ rows: Record<string, unknown>[] }>;\nexport type StrataPool = {\n query: StrataQuery;\n transaction?: <T>(fn: (tx: { query: StrataQuery }) => Promise<T>) => Promise<T>;\n};\n\nexport type LedgerOptions = {\n // Default `strata_ledger`, in the connection's current schema — beside the\n // app's own tables.\n table?: string;\n schema?: string;\n};\n\n// What a host asks of a run before it may land: called inside the run's\n// transaction, after the last pending step — when nothing was pending too.\n// Every sentence it returns refuses the run (DOES_NOT_FIT) — and since\n// nothing has been committed, nothing happened. strata does not know what is\n// being asked; the host does.\nexport type MigrateGuard = (tx: { query: StrataQuery }) => Promise<readonly string[]>;\n\nexport type MigrateOptions = LedgerOptions & {\n // `apply` (default): run what is pending. `verify`: refuse if anything is —\n // a production boot that expects a deploy step to have migrated already.\n mode?: 'apply' | 'verify';\n guard?: MigrateGuard;\n // The whole run, guard included, then rolled back: the report says what\n // WOULD be applied. It takes the locks a real run takes, for as long.\n dryRun?: boolean;\n};\n\nexport type MigrateReport = {\n // What this run applied, in order.\n applied: readonly PreparedMigration[];\n // The plan it acted on (per-sequence positions before the run).\n plan: Plan;\n};\n\nconst IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst quote = (name: string, label: string): string => {\n if (!IDENT.test(name)) throw new StrataError('INVALID_SEQUENCE', `The ledger ${label} \"${name}\" is not a plain identifier.`);\n return `\"${name}\"`;\n};\n\nconst ledgerNameOf = (options: LedgerOptions): { qualified: string; schema: string | undefined } => {\n const table = quote(options.table ?? 'strata_ledger', 'table');\n const schema = options.schema === undefined ? undefined : quote(options.schema, 'schema');\n return { qualified: schema === undefined ? table : `${schema}.${table}`, schema };\n};\n\nexport const ledgerDdl = (options: LedgerOptions = {}): string => {\n const { qualified } = ledgerNameOf(options);\n return `CREATE TABLE IF NOT EXISTS ${qualified} (\n sequence text NOT NULL,\n n integer NOT NULL,\n description text NOT NULL,\n checksum text NOT NULL,\n applied_at timestamptz NOT NULL DEFAULT now(),\n PRIMARY KEY (sequence, n)\n)`;\n};\n\nconst text = (value: unknown): string => (value instanceof Date ? value.toISOString() : String(value));\n\nconst readRows = async (on: { query: StrataQuery }, qualified: string): Promise<LedgerRow[]> => {\n const { rows } = await on.query(`SELECT sequence, n, checksum, description, applied_at FROM ${qualified} ORDER BY sequence, n`);\n return rows.map((row) => ({\n sequence: text(row['sequence']),\n n: Number(row['n']),\n checksum: text(row['checksum']),\n description: text(row['description']),\n appliedAt: text(row['applied_at']),\n }));\n};\n\n// The ledger as it stands — read-only, no lock, no table created. A database\n// that has never been migrated has an empty ledger.\nexport const readLedger = async (pool: StrataPool, options: LedgerOptions = {}): Promise<LedgerRow[]> => {\n const { qualified } = ledgerNameOf(options);\n const { rows } = await pool.query('SELECT to_regclass($1) IS NOT NULL AS present', [qualified]);\n if (rows[0]?.['present'] !== true) return [];\n return readRows(pool, qualified);\n};\n\n// What `migrate` would do, without doing it — for a boot report, a CI check, a\n// page that shows the ledger.\nexport const status = async (pool: StrataPool, sequences: readonly Sequence[], options: LedgerOptions = {}): Promise<Plan> =>\n planMigrations(await prepare(sequences), await readLedger(pool, options));\n\nconst refuseGrammars = (prepared: readonly PreparedSequence[]): void => {\n const grammars = prepared.filter((s) => s.grammar);\n if (grammars.length > 0) {\n throw new StrataError(\n 'WRONG_OWNER',\n 'These sequences own documents, not tables: a document carries its own stamp and is upgraded where it is read (`createUpgrader`, `upgradeStore`) — never recorded in a database\\'s ledger.',\n grammars.map((s) => s.id),\n );\n }\n};\n\nexport const migrate = async (pool: StrataPool, sequences: readonly Sequence[], options: MigrateOptions = {}): Promise<MigrateReport> => {\n const prepared = await prepare(sequences);\n refuseGrammars(prepared);\n if (pool.transaction === undefined) {\n throw new StrataError(\n 'NO_TRANSACTION',\n 'This pool cannot run a transaction, and a migration run must land whole or not at all. ' +\n 'Pass a pool with `transaction` (vex\\'s PGlite pool has one; wrap a `pg` Pool so it checks a client out per transaction).',\n );\n }\n const { qualified, schema } = ledgerNameOf(options);\n // A dry run leaves by throwing: that is what rolls a transaction back in\n // every pool there is. This is the throw, told apart by being this object.\n const dryRunEnd = new Error('strata: dry run');\n let dryRunReport: MigrateReport | undefined;\n\n const run = pool.transaction(async (tx) => {\n // The lock first: two processes creating the ledger at once would race in\n // the catalog before either reached a row.\n await tx.query('SELECT pg_advisory_xact_lock(hashtext($1))', [`strata:${qualified}`]);\n if (schema !== undefined) await tx.query(`CREATE SCHEMA IF NOT EXISTS ${schema}`);\n await tx.query(ledgerDdl(options));\n\n const plan = planMigrations(prepared, await readRows(tx, qualified));\n refuseProblems(plan);\n if (options.mode === 'verify' && plan.pending.length > 0) {\n throw new StrataError(\n 'PENDING',\n `${plan.pending.length} migration${plan.pending.length === 1 ? ' is' : 's are'} not applied, and this boot only verifies. Run the migrations first.`,\n plan.pending.map((m) => `${m.ref} ${m.description}`),\n );\n }\n\n const applied: PreparedMigration[] = [];\n for (const migration of plan.pending) {\n for (const [index, step] of migration.steps.entries()) {\n // Only table sequences reach the ledger (refuseGrammars above).\n if (step.kind !== 'sql') continue;\n try {\n await tx.query(step.sql);\n } catch (cause) {\n throw new StrataError(\n 'STEP_FAILED',\n `${migration.ref} (\"${migration.description}\") failed at step ${index + 1} of ${migration.steps.length}. Nothing from this run was applied.`,\n [cause instanceof Error ? cause.message : String(cause), step.sql.length > 300 ? `${step.sql.slice(0, 300)}…` : step.sql],\n { cause },\n );\n }\n }\n await tx.query(`INSERT INTO ${qualified} (sequence, n, description, checksum) VALUES ($1, $2, $3, $4)`, [\n migration.sequence,\n migration.n,\n migration.description,\n migration.checksum,\n ]);\n applied.push(migration);\n }\n\n const reasons = options.guard === undefined ? [] : await options.guard(tx);\n if (reasons.length > 0) {\n throw new StrataError('DOES_NOT_FIT', 'What this run leaves does not fit what has to run on it. Nothing from this run was applied.', reasons);\n }\n if (options.dryRun === true) {\n dryRunReport = { applied, plan };\n throw dryRunEnd;\n }\n return { applied, plan };\n });\n\n return run.catch((error: unknown) => {\n if (error === dryRunEnd && dryRunReport !== undefined) return dryRunReport;\n throw error;\n });\n};\n\n// ═══════════════════════════════════════════════════════════════\n// Stores — tables whose rows hold documents.\n//\n// A store names where the documents live: the table, the jsonb column holding\n// each document, the jsonb column holding its stamp, the kind every document\n// in it is, and the key that identifies a row. The table itself (and its stamp\n// column) is its owner's, created by the owner's TABLE sequence; strata only\n// reads and rewrites rows.\n//\n// `upgradeStore` brings every row that is behind up to the code, in one\n// transaction, and writes each back with a current stamp. A row written by\n// newer code refuses the whole run (TOO_NEW) — the same answer the ledger\n// gives, one row at a time. Read paths that cannot wait for a boot upgrade the\n// row they read with the same upgrader; this is the pass that makes that rare.\n// ═══════════════════════════════════════════════════════════════\n\nexport type DocumentStore = {\n table: string;\n schema?: string;\n // The jsonb column holding the document.\n column: string;\n // The jsonb column holding the document's stamp (`{}` means \"before stamps\").\n stamp: string;\n // Every document in this store is of this kind, e.g. \"nisc.nova/action\".\n kind: string;\n // The columns that identify a row.\n key: readonly string[];\n};\n\nexport type StoreReport = {\n // Rows read, and rows that were behind and rewritten.\n total: number;\n upgraded: number;\n // Per migration ref, how many rows it rewrote.\n applied: Readonly<Record<string, number>>;\n};\n\nexport const upgradeStore = async (pool: StrataPool, store: DocumentStore, upgrader: Upgrader): Promise<StoreReport> => {\n if (pool.transaction === undefined) {\n throw new StrataError('NO_TRANSACTION', 'Rewriting a store must land whole or not at all; this pool cannot run a transaction.');\n }\n const table = store.schema === undefined ? quote(store.table, 'table') : `${quote(store.schema, 'schema')}.${quote(store.table, 'table')}`;\n const column = quote(store.column, 'column');\n const stamp = quote(store.stamp, 'column');\n const keys = store.key.map((k) => quote(k, 'column'));\n if (keys.length === 0) throw new StrataError('INVALID_SEQUENCE', `The store ${store.table} names no key columns.`);\n\n return pool.transaction(async (tx) => {\n const { rows } = await tx.query(`SELECT ${[...keys, column, stamp].join(', ')} FROM ${table} FOR UPDATE`);\n const applied: Record<string, number> = {};\n let upgraded = 0;\n for (const row of rows) {\n const given = row[store.stamp];\n const rowStamp = typeof given === 'object' && given !== null && !Array.isArray(given) ? Object.fromEntries(Object.entries(given).map(([k, v]) => [k, Number(v)])) : {};\n const where = store.key.map((k) => `${k}=${JSON.stringify(row[k])}`).join(', ');\n let result: UpgradeResult;\n try {\n if (!upgrader.behind(rowStamp)) continue;\n result = upgrader.upgrade(row[store.column], { kind: store.kind, stamp: rowStamp });\n } catch (cause) {\n if (cause instanceof StrataError) {\n throw new StrataError(cause.code, `${store.table} (${where}): ${cause.message.split('\\n')[0] ?? ''}`, cause.details, { cause });\n }\n throw cause;\n }\n await tx.query(\n `UPDATE ${table} SET ${column} = $1::jsonb, ${stamp} = $2::jsonb WHERE ${keys.map((k, i) => `${k} = $${i + 3}`).join(' AND ')}`,\n [JSON.stringify(result.document), JSON.stringify(result.stamp), ...store.key.map((k) => row[k])],\n );\n upgraded += 1;\n for (const ref of result.applied) applied[ref] = (applied[ref] ?? 0) + 1;\n }\n return { total: rows.length, upgraded, applied };\n });\n};\n"]}
@@ -1,236 +1,26 @@
1
1
  'use strict';
2
2
 
3
- // src/errors.ts
4
- var StrataError = class extends Error {
5
- code;
6
- details;
7
- constructor(code, message, details = [], options) {
8
- super(details.length > 0 ? `${message}
9
- ${details.map((d) => ` ${d}`).join("\n")}` : message, options);
10
- this.name = "StrataError";
11
- this.code = code;
12
- this.details = details;
13
- }
14
- };
3
+ var chunkIHYBGLNW_cjs = require('../chunk-IHYBGLNW.cjs');
4
+ require('../chunk-KNBS3AJZ.cjs');
5
+ require('../chunk-ATHZ7HT5.cjs');
15
6
 
16
- // src/check/index.ts
17
- var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
18
- var byKey = ([a], [b]) => a < b ? -1 : a > b ? 1 : 0;
19
- var sortKeys = (value) => {
20
- if (Array.isArray(value)) return value.map(sortKeys);
21
- if (!isRecord(value)) return value;
22
- return Object.fromEntries(Object.entries(value).sort(byKey).map(([k, v]) => [k, sortKeys(v)]));
23
- };
24
- var NAMED = /* @__PURE__ */ new Set(["properties", "patternProperties", "$defs", "definitions", "dependentSchemas"]);
25
- var DATA = /* @__PURE__ */ new Set(["const", "enum", "default", "examples"]);
26
- var normalize = (value) => {
27
- if (Array.isArray(value)) return value.map(normalize);
28
- if (!isRecord(value)) return value;
29
- return Object.fromEntries(
30
- Object.entries(value).filter(([key]) => key !== "description" && key !== "$schema").sort(byKey).map(([key, v]) => [key, NAMED.has(key) && isRecord(v) ? namedSchemas(v, normalize) : DATA.has(key) ? sortKeys(v) : normalize(v)])
31
- );
32
- };
33
- var namedSchemas = (map, each) => Object.fromEntries(Object.entries(map).sort(byKey).map(([name, schema]) => [name, each(schema)]));
34
- var diffLines = (a, b, path, out, limit, canon = normalize, sets = true) => {
35
- if (out.length >= limit) return;
36
- if (JSON.stringify(a) === JSON.stringify(b)) return;
37
- if (isRecord(a) && isRecord(b)) {
38
- for (const key of [.../* @__PURE__ */ new Set([...Object.keys(a), ...Object.keys(b)])].sort()) {
39
- const at = path === "" ? key : `${path}.${key}`;
40
- if (!(key in a)) out.push(`+ ${at}`);
41
- else if (!(key in b)) out.push(`- ${at}`);
42
- else diffLines(a[key], b[key], at, out, limit, canon, sets);
43
- if (out.length >= limit) return;
44
- }
45
- return;
46
- }
47
- if (Array.isArray(a) && Array.isArray(b) && !sets && a.length === b.length) {
48
- a.forEach((item, i) => diffLines(item, b[i], `${path}[${i}]`, out, limit, canon, sets));
49
- return;
50
- }
51
- if (Array.isArray(a) && Array.isArray(b)) {
52
- const text = (v) => JSON.stringify(canon(v));
53
- const label = (v) => isRecord(v) && isRecord(v["properties"]) ? Object.keys(v["properties"]).join(",") : (text(v) ?? "").slice(0, 50);
54
- const onlyA = a.filter((x) => !b.some((y) => text(y) === text(x)));
55
- const onlyB = b.filter((y) => !a.some((x) => text(x) === text(y)));
56
- const byLabel = new Map(onlyB.map((y) => [label(y), y]));
57
- for (const x of onlyA) {
58
- const partner = byLabel.get(label(x));
59
- if (partner !== void 0) {
60
- diffLines(x, partner, `${path}[${label(x)}]`, out, limit, canon, sets);
61
- byLabel.delete(label(x));
62
- } else {
63
- out.push(`- ${path}[${label(x)}]`);
64
- }
65
- if (out.length >= limit) return;
66
- }
67
- for (const [name] of byLabel) {
68
- out.push(`+ ${path}[${name}]`);
69
- if (out.length >= limit) return;
70
- }
71
- return;
72
- }
73
- out.push(`~ ${path || "(root)"}: ${JSON.stringify(a)?.slice(0, 60)} \u2192 ${JSON.stringify(b)?.slice(0, 60)}`);
74
- };
75
- var diffJson = (a, b, limit = 20) => {
76
- const out = [];
77
- diffLines(a, b, "", out, limit, sortKeys, false);
78
- return out;
79
- };
80
7
 
81
- // src/upgrade/index.ts
82
- var keyOf = (doc) => `${doc.kind}:${doc.id}`;
83
- var sortKeys2 = (value) => {
84
- if (Array.isArray(value)) return value.map(sortKeys2);
85
- if (typeof value !== "object" || value === null) return value;
86
- return Object.fromEntries(Object.entries(value).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([k, v]) => [k, sortKeys2(v)]));
87
- };
88
- var sameJson = (a, b) => JSON.stringify(sortKeys2(a)) === JSON.stringify(sortKeys2(b));
89
- var changedStrings = (before, after) => {
90
- const found = /* @__PURE__ */ new Set();
91
- const visit = (a, b) => {
92
- if (JSON.stringify(a) === JSON.stringify(b)) return;
93
- if (typeof a === "string") {
94
- found.add(a);
95
- return;
96
- }
97
- if (Array.isArray(a)) {
98
- a.forEach((item, i) => visit(item, Array.isArray(b) ? b[i] : void 0));
99
- return;
100
- }
101
- if (typeof a === "object" && a !== null) {
102
- for (const [k, v] of Object.entries(a)) visit(v, typeof b === "object" && b !== null && !Array.isArray(b) ? Reflect.get(b, k) : void 0);
103
- }
104
- };
105
- visit(before, after);
106
- return [...found].filter((s) => s.length >= 4);
107
- };
108
- var planSourceUpgrade = async (options) => {
109
- const { upgrader, stamp, documents, schemas, describe } = options;
110
- const seen = /* @__PURE__ */ new Set();
111
- const planned = [];
112
- const untouched = [];
113
- const problems = [];
114
- for (const doc of documents) {
115
- const key = keyOf(doc);
116
- if (seen.has(key)) throw new StrataError("INVALID_SEQUENCE", `Two artifacts are both ${key} \u2014 an artifact needs one identity to be planned.`);
117
- seen.add(key);
118
- const result = upgrader.upgrade(doc.document, { kind: doc.kind, stamp });
119
- if (sameJson(result.document, doc.document)) {
120
- untouched.push(key);
121
- continue;
122
- }
123
- planned.push({
124
- kind: doc.kind,
125
- id: doc.id,
126
- ...doc.file === void 0 ? {} : { file: doc.file },
127
- applied: result.applied,
128
- changes: diffJson(doc.document, result.document),
129
- expected: result.document
130
- });
131
- const schema = schemas?.[doc.kind];
132
- if (schema !== void 0) {
133
- const checked = await schema["~standard"].validate(result.document);
134
- if (checked.issues !== void 0) {
135
- problems.push(`${key}: the migrated artifact does not pass ${doc.kind}'s current schema \u2014 ${checked.issues.slice(0, 2).map((i) => i.message).join("; ")}`);
136
- }
137
- }
138
- }
139
- const from = stamp;
140
- const to = upgrader.stamp;
141
- const migrations = Object.entries(to).flatMap(
142
- ([id, n]) => Array.from({ length: Math.max(0, n - (from[id] ?? 0)) }, (_, i) => `${id}/${(from[id] ?? 0) + i + 1}`)
143
- );
144
- return {
145
- from,
146
- to,
147
- migrations: migrations.map((ref) => ({ ref, description: describe(ref) })),
148
- documents: planned.sort((a, b) => keyOf(a) < keyOf(b) ? -1 : 1),
149
- untouched: untouched.sort(),
150
- problems
151
- };
152
- };
153
- var verifySourceUpgrade = (options) => {
154
- const { plan, upgrader, documents } = options;
155
- const now = new Map(documents.map((d) => [keyOf(d), d]));
156
- const lines = [];
157
- for (const want of plan.documents) {
158
- const key = keyOf(want);
159
- const got = now.get(key);
160
- if (got === void 0) {
161
- lines.push({ ok: false, text: `${key} is gone \u2014 the plan expected it rewritten, not removed` });
162
- } else if (sameJson(got.document, want.expected)) {
163
- lines.push({ ok: true, text: `${key} matches its migrated JSON` });
164
- } else {
165
- lines.push({ ok: false, text: `${key} does not match its migrated JSON yet`, detail: diffJson(got.document, want.expected, 12) });
166
- }
167
- }
168
- for (const key of plan.untouched) {
169
- const got = now.get(key);
170
- if (got === void 0) {
171
- lines.push({ ok: false, text: `${key} is gone \u2014 no migration asked for that` });
172
- continue;
173
- }
174
- const again = upgrader.upgrade(got.document, { kind: got.kind, stamp: plan.from });
175
- if (!sameJson(again.document, got.document)) {
176
- lines.push({ ok: false, text: `${key} was not in the plan, but the migrations would change it now`, detail: diffJson(got.document, again.document, 12) });
177
- }
178
- }
179
- const known = /* @__PURE__ */ new Set([...plan.documents.map(keyOf), ...plan.untouched]);
180
- for (const key of now.keys()) {
181
- if (!known.has(key)) lines.push({ ok: false, text: `${key} is new since the plan \u2014 plan again so it is checked too` });
182
- }
183
- const ok = lines.every((l) => l.ok);
184
- if (ok) lines.push({ ok: true, text: `${plan.untouched.length} artifact(s) no migration touches, still untouched` });
185
- return { ok, lines };
186
- };
187
- var renderReport = (plan, expectedPathOf) => {
188
- const stamp = (s) => Object.entries(s).map(([k, v]) => `${k} ${v}`).join(", ");
189
- const out = [
190
- "# strata upgrade",
191
- "",
192
- `The source is written at **${stamp(plan.from)}**; the installed grammars are at **${stamp(plan.to)}**.`,
193
- "",
194
- "## Migrations",
195
- "",
196
- ...plan.migrations.map((m) => `- \`${m.ref}\` \u2014 ${m.description}`),
197
- ""
198
- ];
199
- if (plan.problems.length > 0) {
200
- out.push("## Stop: a migration is wrong", "", "These artifacts would not pass their current schema after migrating \u2014 no edit can make `verify` pass. Fix the migration, then plan again.", "", ...plan.problems.map((p) => `- ${p}`), "");
201
- }
202
- if (plan.documents.length === 0) {
203
- out.push("## Nothing to edit", "", `No artifact changes (${plan.untouched.length} checked). Run \`verify\` to move the lock.`, "");
204
- } else {
205
- out.push(
206
- `## ${plan.documents.length} artifact(s) to edit`,
207
- "",
208
- "Edit each so that it serialises to EXACTLY its expected JSON (key order aside) \u2014 then run `verify`. Only what is listed changes; every other artifact must stay as it is.",
209
- ""
210
- );
211
- for (const doc of plan.documents) {
212
- out.push(
213
- `### \`${doc.id}\` (${doc.kind})`,
214
- "",
215
- doc.file === void 0 ? "" : `- **File:** \`${doc.file}\``,
216
- doc.lookIn === void 0 || doc.lookIn.length === 0 ? "" : `- **Look in:** ${doc.lookIn.map((f) => `\`${f}\``).join(", ")} \u2014 where the changing values are written`,
217
- `- **Migrations:** ${doc.applied.map((r) => `\`${r}\``).join(", ")}`,
218
- `- **Expected JSON:** \`${expectedPathOf(doc)}\``,
219
- "- **Changes:**",
220
- "",
221
- "```",
222
- ...doc.changes,
223
- "```",
224
- ""
225
- );
226
- }
227
- }
228
- return out.filter((line, i, all) => !(line === "" && all[i - 1] === "")).join("\n");
229
- };
230
8
 
231
- exports.changedStrings = changedStrings;
232
- exports.planSourceUpgrade = planSourceUpgrade;
233
- exports.renderReport = renderReport;
234
- exports.verifySourceUpgrade = verifySourceUpgrade;
9
+ Object.defineProperty(exports, "changedStrings", {
10
+ enumerable: true,
11
+ get: function () { return chunkIHYBGLNW_cjs.changedStrings; }
12
+ });
13
+ Object.defineProperty(exports, "planSourceUpgrade", {
14
+ enumerable: true,
15
+ get: function () { return chunkIHYBGLNW_cjs.planSourceUpgrade; }
16
+ });
17
+ Object.defineProperty(exports, "renderReport", {
18
+ enumerable: true,
19
+ get: function () { return chunkIHYBGLNW_cjs.renderReport; }
20
+ });
21
+ Object.defineProperty(exports, "verifySourceUpgrade", {
22
+ enumerable: true,
23
+ get: function () { return chunkIHYBGLNW_cjs.verifySourceUpgrade; }
24
+ });
235
25
  //# sourceMappingURL=index.cjs.map
236
26
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/errors.ts","../../src/check/index.ts","../../src/upgrade/index.ts"],"names":["sortKeys"],"mappings":";;;AA0BO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA,EAC5B,IAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,IAAA,EAAuB,OAAA,EAAiB,OAAA,GAA6B,IAAI,OAAA,EAA+B;AAClH,IAAA,KAAA,CAAM,OAAA,CAAQ,MAAA,GAAS,CAAA,GAAI,CAAA,EAAG,OAAO;AAAA,EAAK,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAA,EAAK,CAAC,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,GAAK,SAAS,OAAO,CAAA;AACtG,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AACF,CAAA;;;ACKA,IAAM,QAAA,GAAW,CAAC,KAAA,KAChB,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,IAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA;AAErE,IAAM,KAAA,GAAQ,CAAC,CAAC,CAAC,CAAA,EAAsB,CAAC,CAAC,CAAA,KAAkC,CAAA,GAAI,CAAA,GAAI,EAAA,GAAK,CAAA,GAAI,IAAI,CAAA,GAAI,CAAA;AAIpG,IAAM,QAAA,GAAW,CAAC,KAAA,KAA4B;AAC5C,EAAA,IAAI,MAAM,OAAA,CAAQ,KAAK,GAAG,OAAO,KAAA,CAAM,IAAI,QAAQ,CAAA;AACnD,EAAA,IAAI,CAAC,QAAA,CAAS,KAAK,CAAA,EAAG,OAAO,KAAA;AAC7B,EAAA,OAAO,MAAA,CAAO,YAAY,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,IAAA,CAAK,KAAK,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM,CAAC,GAAG,QAAA,CAAS,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/F,CAAA;AAKA,IAAM,KAAA,uBAAY,GAAA,CAAI,CAAC,cAAc,mBAAA,EAAqB,OAAA,EAAS,aAAA,EAAe,kBAAkB,CAAC,CAAA;AACrG,IAAM,IAAA,uBAAW,GAAA,CAAI,CAAC,SAAS,MAAA,EAAQ,SAAA,EAAW,UAAU,CAAC,CAAA;AAM7D,IAAM,SAAA,GAAY,CAAC,KAAA,KAA4B;AAC7C,EAAA,IAAI,MAAM,OAAA,CAAQ,KAAK,GAAG,OAAO,KAAA,CAAM,IAAI,SAAS,CAAA;AACpD,EAAA,IAAI,CAAC,QAAA,CAAS,KAAK,CAAA,EAAG,OAAO,KAAA;AAC7B,EAAA,OAAO,MAAA,CAAO,WAAA;AAAA,IACZ,MAAA,CAAO,QAAQ,KAAK,CAAA,CACjB,OAAO,CAAC,CAAC,GAAG,CAAA,KAAM,GAAA,KAAQ,iBAAiB,GAAA,KAAQ,SAAS,EAC5D,IAAA,CAAK,KAAK,EACV,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,CAAC,CAAA,KAAM,CAAC,GAAA,EAAK,KAAA,CAAM,IAAI,GAAG,CAAA,IAAK,SAAS,CAAC,CAAA,GAAI,aAAa,CAAA,EAAG,SAAS,IAAI,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA,GAAI,QAAA,CAAS,CAAC,CAAA,GAAI,SAAA,CAAU,CAAC,CAAC,CAAC;AAAA,GACrI;AACF,CAAA;AAGA,IAAM,YAAA,GAAe,CAAC,GAAA,EAA8B,IAAA,KAClD,MAAA,CAAO,YAAY,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,EAAE,GAAA,CAAI,CAAC,CAAC,IAAA,EAAM,MAAM,CAAA,KAAM,CAAC,IAAA,EAAM,IAAA,CAAK,MAAM,CAAC,CAAC,CAAC,CAAA;AA+BlG,IAAM,SAAA,GAAY,CAAC,CAAA,EAAY,CAAA,EAAY,IAAA,EAAc,KAAe,KAAA,EAAe,KAAA,GAAiC,SAAA,EAAW,IAAA,GAAO,IAAA,KAAe;AACvJ,EAAA,IAAI,GAAA,CAAI,UAAU,KAAA,EAAO;AACzB,EAAA,IAAI,KAAK,SAAA,CAAU,CAAC,MAAM,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA,EAAG;AAC7C,EAAA,IAAI,QAAA,CAAS,CAAC,CAAA,IAAK,QAAA,CAAS,CAAC,CAAA,EAAG;AAC9B,IAAA,KAAA,MAAW,GAAA,IAAO,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAG,OAAO,IAAA,CAAK,CAAC,GAAG,GAAG,MAAA,CAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA,CAAE,MAAK,EAAG;AAC7E,MAAA,MAAM,KAAK,IAAA,KAAS,EAAA,GAAK,MAAM,CAAA,EAAG,IAAI,IAAI,GAAG,CAAA,CAAA;AAC7C,MAAA,IAAI,EAAE,GAAA,IAAO,CAAA,CAAA,MAAQ,IAAA,CAAK,CAAA,EAAA,EAAK,EAAE,CAAA,CAAE,CAAA;AAAA,WAAA,IAC1B,EAAE,GAAA,IAAO,CAAA,CAAA,MAAQ,IAAA,CAAK,CAAA,EAAA,EAAK,EAAE,CAAA,CAAE,CAAA;AAAA,WACnC,SAAA,CAAU,CAAA,CAAE,GAAG,CAAA,EAAG,CAAA,CAAE,GAAG,CAAA,EAAG,EAAA,EAAI,GAAA,EAAK,KAAA,EAAO,KAAA,EAAO,IAAI,CAAA;AAC1D,MAAA,IAAI,GAAA,CAAI,UAAU,KAAA,EAAO;AAAA,IAC3B;AACA,IAAA;AAAA,EACF;AACA,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,IAAK,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,IAAK,CAAC,IAAA,IAAQ,CAAA,CAAE,MAAA,KAAW,EAAE,MAAA,EAAQ;AAC1E,IAAA,CAAA,CAAE,QAAQ,CAAC,IAAA,EAAM,MAAM,SAAA,CAAU,IAAA,EAAM,EAAE,CAAC,CAAA,EAAG,CAAA,EAAG,IAAI,IAAI,CAAC,CAAA,CAAA,CAAA,EAAK,KAAK,KAAA,EAAO,KAAA,EAAO,IAAI,CAAC,CAAA;AACtF,IAAA;AAAA,EACF;AACA,EAAA,IAAI,MAAM,OAAA,CAAQ,CAAC,KAAK,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,EAAG;AAMxC,IAAA,MAAM,OAAO,CAAC,CAAA,KAAuB,KAAK,SAAA,CAAU,KAAA,CAAM,CAAC,CAAC,CAAA;AAC5D,IAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,KACb,QAAA,CAAS,CAAC,CAAA,IAAK,QAAA,CAAS,CAAA,CAAE,YAAY,CAAC,CAAA,GAAI,MAAA,CAAO,IAAA,CAAK,EAAE,YAAY,CAAC,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA,GAAA,CAAK,IAAA,CAAK,CAAC,CAAA,IAAK,EAAA,EAAI,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA;AACjH,IAAA,MAAM,QAAQ,CAAA,CAAE,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA,KAAM,KAAK,CAAC,CAAA,KAAM,IAAA,CAAK,CAAC,CAAC,CAAC,CAAA;AACjE,IAAA,MAAM,QAAQ,CAAA,CAAE,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA,KAAM,KAAK,CAAC,CAAA,KAAM,IAAA,CAAK,CAAC,CAAC,CAAC,CAAA;AACjE,IAAA,MAAM,OAAA,GAAU,IAAI,GAAA,CAAI,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,KAAA,CAAM,CAAC,CAAA,EAAG,CAAC,CAAC,CAAC,CAAA;AACvD,IAAA,KAAA,MAAW,KAAK,KAAA,EAAO;AACrB,MAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,CAAC,CAAC,CAAA;AACpC,MAAA,IAAI,YAAY,MAAA,EAAW;AACzB,QAAA,SAAA,CAAU,CAAA,EAAG,OAAA,EAAS,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA,CAAA,EAAK,GAAA,EAAK,KAAA,EAAO,KAAA,EAAO,IAAI,CAAA;AACrE,QAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAC,CAAC,CAAA;AAAA,MACzB,CAAA,MAAO;AACL,QAAA,GAAA,CAAI,KAAK,CAAA,EAAA,EAAK,IAAI,IAAI,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,MACnC;AACA,MAAA,IAAI,GAAA,CAAI,UAAU,KAAA,EAAO;AAAA,IAC3B;AACA,IAAA,KAAA,MAAW,CAAC,IAAI,CAAA,IAAK,OAAA,EAAS;AAC5B,MAAA,GAAA,CAAI,IAAA,CAAK,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,CAAG,CAAA;AAC7B,MAAA,IAAI,GAAA,CAAI,UAAU,KAAA,EAAO;AAAA,IAC3B;AACA,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,IAAA,CAAK,KAAK,IAAA,IAAQ,QAAQ,KAAK,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA,EAAG,KAAA,CAAM,CAAA,EAAG,EAAE,CAAC,CAAA,QAAA,EAAM,KAAK,SAAA,CAAU,CAAC,GAAG,KAAA,CAAM,CAAA,EAAG,EAAE,CAAC,CAAA,CAAE,CAAA;AAC3G,CAAA;AA4IO,IAAM,QAAA,GAAW,CAAC,CAAA,EAAY,CAAA,EAAY,QAAQ,EAAA,KAAiB;AACxE,EAAA,MAAM,MAAgB,EAAC;AACvB,EAAA,SAAA,CAAU,GAAG,CAAA,EAAG,EAAA,EAAI,GAAA,EAAK,KAAA,EAAO,UAAU,KAAK,CAAA;AAC/C,EAAA,OAAO,GAAA;AACT,CAAA;;;ACrPA,IAAM,KAAA,GAAQ,CAAC,GAAA,KAA8C,CAAA,EAAG,IAAI,IAAI,CAAA,CAAA,EAAI,IAAI,EAAE,CAAA,CAAA;AAElF,IAAMA,SAAAA,GAAW,CAAC,KAAA,KAA4B;AAC5C,EAAA,IAAI,MAAM,OAAA,CAAQ,KAAK,GAAG,OAAO,KAAA,CAAM,IAAIA,SAAQ,CAAA;AACnD,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAM,OAAO,KAAA;AACxD,EAAA,OAAO,MAAA,CAAO,WAAA,CAAY,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,IAAA,CAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAO,IAAI,CAAA,GAAI,EAAA,GAAK,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAE,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM,CAAC,CAAA,EAAGA,SAAAA,CAAS,CAAC,CAAC,CAAC,CAAC,CAAA;AACpI,CAAA;AAEA,IAAM,QAAA,GAAW,CAAC,CAAA,EAAY,CAAA,KAAwB,KAAK,SAAA,CAAUA,SAAAA,CAAS,CAAC,CAAC,CAAA,KAAM,IAAA,CAAK,SAAA,CAAUA,SAAAA,CAAS,CAAC,CAAC,CAAA;AAIzG,IAAM,cAAA,GAAiB,CAAC,MAAA,EAAiB,KAAA,KAA6B;AAC3E,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAY;AAC9B,EAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,EAAY,CAAA,KAAqB;AAC9C,IAAA,IAAI,KAAK,SAAA,CAAU,CAAC,MAAM,IAAA,CAAK,SAAA,CAAU,CAAC,CAAA,EAAG;AAC7C,IAAA,IAAI,OAAO,MAAM,QAAA,EAAU;AACzB,MAAA,KAAA,CAAM,IAAI,CAAC,CAAA;AACX,MAAA;AAAA,IACF;AACA,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,EAAG;AACpB,MAAA,CAAA,CAAE,OAAA,CAAQ,CAAC,IAAA,EAAM,CAAA,KAAM,MAAM,IAAA,EAAM,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,GAAI,CAAA,CAAE,CAAC,CAAA,GAAI,MAAS,CAAC,CAAA;AACvE,MAAA;AAAA,IACF;AACA,IAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,CAAA,KAAM,IAAA,EAAM;AACvC,MAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,CAAA,IAAK,MAAA,CAAO,QAAQ,CAAC,CAAA,EAAG,KAAA,CAAM,CAAA,EAAG,OAAO,CAAA,KAAM,YAAY,CAAA,KAAM,IAAA,IAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,GAAI,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAG,CAAC,CAAA,GAAI,MAAS,CAAA;AAAA,IAC3I;AAAA,EACF,CAAA;AACA,EAAA,KAAA,CAAM,QAAQ,KAAK,CAAA;AACnB,EAAA,OAAO,CAAC,GAAG,KAAK,CAAA,CAAE,OAAO,CAAC,CAAA,KAAM,CAAA,CAAE,MAAA,IAAU,CAAC,CAAA;AAC/C;AAEO,IAAM,iBAAA,GAAoB,OAAO,OAAA,KAQb;AACzB,EAAA,MAAM,EAAE,QAAA,EAAU,KAAA,EAAO,SAAA,EAAW,OAAA,EAAS,UAAS,GAAI,OAAA;AAC1D,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,MAAM,UAA6B,EAAC;AACpC,EAAA,MAAM,YAAsB,EAAC;AAC7B,EAAA,MAAM,WAAqB,EAAC;AAE5B,EAAA,KAAA,MAAW,OAAO,SAAA,EAAW;AAC3B,IAAA,MAAM,GAAA,GAAM,MAAM,GAAG,CAAA;AACrB,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA,EAAG,MAAM,IAAI,WAAA,CAAY,kBAAA,EAAoB,CAAA,uBAAA,EAA0B,GAAG,CAAA,qDAAA,CAAkD,CAAA;AAC5I,IAAA,IAAA,CAAK,IAAI,GAAG,CAAA;AACZ,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,QAAA,EAAU,EAAE,IAAA,EAAM,GAAA,CAAI,IAAA,EAAM,KAAA,EAAO,CAAA;AACvE,IAAA,IAAI,QAAA,CAAS,MAAA,CAAO,QAAA,EAAU,GAAA,CAAI,QAAQ,CAAA,EAAG;AAC3C,MAAA,SAAA,CAAU,KAAK,GAAG,CAAA;AAClB,MAAA;AAAA,IACF;AACA,IAAA,OAAA,CAAQ,IAAA,CAAK;AAAA,MACX,MAAM,GAAA,CAAI,IAAA;AAAA,MACV,IAAI,GAAA,CAAI,EAAA;AAAA,MACR,GAAI,IAAI,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,GAAA,CAAI,IAAA,EAAK;AAAA,MACnD,SAAS,MAAA,CAAO,OAAA;AAAA,MAChB,OAAA,EAAS,QAAA,CAAS,GAAA,CAAI,QAAA,EAAU,OAAO,QAAQ,CAAA;AAAA,MAC/C,UAAU,MAAA,CAAO;AAAA,KAClB,CAAA;AACD,IAAA,MAAM,MAAA,GAAS,OAAA,GAAU,GAAA,CAAI,IAAI,CAAA;AACjC,IAAA,IAAI,WAAW,MAAA,EAAW;AACxB,MAAA,MAAM,UAAU,MAAM,MAAA,CAAO,WAAW,CAAA,CAAE,QAAA,CAAS,OAAO,QAAQ,CAAA;AAClE,MAAA,IAAI,OAAA,CAAQ,WAAW,MAAA,EAAW;AAChC,QAAA,QAAA,CAAS,IAAA,CAAK,GAAG,GAAG,CAAA,sCAAA,EAAyC,IAAI,IAAI,CAAA,yBAAA,EAAuB,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,MAC3J;AAAA,IACF;AAAA,EACF;AAIA,EAAA,MAAM,IAAA,GAAO,KAAA;AACb,EAAA,MAAM,KAAK,QAAA,CAAS,KAAA;AACpB,EAAA,MAAM,UAAA,GAAa,MAAA,CAAO,OAAA,CAAQ,EAAE,CAAA,CAAE,OAAA;AAAA,IAAQ,CAAC,CAAC,EAAA,EAAI,CAAC,CAAA,KACnD,KAAA,CAAM,IAAA,CAAK,EAAE,MAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAK,IAAA,CAAK,EAAE,CAAA,IAAK,CAAA,CAAE,CAAA,EAAE,EAAG,CAAC,CAAA,EAAG,MAAM,CAAA,EAAG,EAAE,CAAA,CAAA,EAAA,CAAK,IAAA,CAAK,EAAE,CAAA,IAAK,CAAA,IAAK,CAAA,GAAI,CAAC,CAAA,CAAE;AAAA,GACvG;AACA,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,EAAA;AAAA,IACA,UAAA,EAAY,UAAA,CAAW,GAAA,CAAI,CAAC,GAAA,MAAS,EAAE,GAAA,EAAK,WAAA,EAAa,QAAA,CAAS,GAAG,CAAA,EAAE,CAAE,CAAA;AAAA,IACzE,SAAA,EAAW,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAO,KAAA,CAAM,CAAC,CAAA,GAAI,KAAA,CAAM,CAAC,CAAA,GAAI,KAAK,CAAE,CAAA;AAAA,IAChE,SAAA,EAAW,UAAU,IAAA,EAAK;AAAA,IAC1B;AAAA,GACF;AACF;AAUO,IAAM,mBAAA,GAAsB,CAAC,OAAA,KAA0G;AAC5I,EAAA,MAAM,EAAE,IAAA,EAAM,QAAA,EAAU,SAAA,EAAU,GAAI,OAAA;AACtC,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,SAAA,CAAU,GAAA,CAAI,CAAC,CAAA,KAAM,CAAC,KAAA,CAAM,CAAC,CAAA,EAAG,CAAC,CAAC,CAAC,CAAA;AACvD,EAAA,MAAM,QAAqE,EAAC;AAE5E,EAAA,KAAA,MAAW,IAAA,IAAQ,KAAK,SAAA,EAAW;AACjC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAI,CAAA;AACtB,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,CAAI,GAAG,CAAA;AACvB,IAAA,IAAI,QAAQ,MAAA,EAAW;AACrB,MAAA,KAAA,CAAM,IAAA,CAAK,EAAE,EAAA,EAAI,KAAA,EAAO,MAAM,CAAA,EAAG,GAAG,+DAA0D,CAAA;AAAA,IAChG,WAAW,QAAA,CAAS,GAAA,CAAI,QAAA,EAAU,IAAA,CAAK,QAAQ,CAAA,EAAG;AAChD,MAAA,KAAA,CAAM,IAAA,CAAK,EAAE,EAAA,EAAI,IAAA,EAAM,MAAM,CAAA,EAAG,GAAG,8BAA8B,CAAA;AAAA,IACnE,CAAA,MAAO;AACL,MAAA,KAAA,CAAM,KAAK,EAAE,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,GAAG,GAAG,CAAA,qCAAA,CAAA,EAAyC,MAAA,EAAQ,QAAA,CAAS,IAAI,QAAA,EAAU,IAAA,CAAK,QAAA,EAAU,EAAE,GAAG,CAAA;AAAA,IAClI;AAAA,EACF;AACA,EAAA,KAAA,MAAW,GAAA,IAAO,KAAK,SAAA,EAAW;AAChC,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,CAAI,GAAG,CAAA;AACvB,IAAA,IAAI,QAAQ,MAAA,EAAW;AACrB,MAAA,KAAA,CAAM,IAAA,CAAK,EAAE,EAAA,EAAI,KAAA,EAAO,MAAM,CAAA,EAAG,GAAG,+CAA0C,CAAA;AAC9E,MAAA;AAAA,IACF;AACA,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,QAAA,EAAU,EAAE,IAAA,EAAM,GAAA,CAAI,IAAA,EAAM,KAAA,EAAO,IAAA,CAAK,IAAA,EAAM,CAAA;AACjF,IAAA,IAAI,CAAC,QAAA,CAAS,KAAA,CAAM,QAAA,EAAU,GAAA,CAAI,QAAQ,CAAA,EAAG;AAC3C,MAAA,KAAA,CAAM,KAAK,EAAE,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,GAAG,GAAG,CAAA,4DAAA,CAAA,EAAgE,MAAA,EAAQ,QAAA,CAAS,IAAI,QAAA,EAAU,KAAA,CAAM,QAAA,EAAU,EAAE,GAAG,CAAA;AAAA,IAC1J;AAAA,EACF;AACA,EAAA,MAAM,KAAA,mBAAQ,IAAI,GAAA,CAAI,CAAC,GAAG,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA,EAAG,GAAG,IAAA,CAAK,SAAS,CAAC,CAAA;AACvE,EAAA,KAAA,MAAW,GAAA,IAAO,GAAA,CAAI,IAAA,EAAK,EAAG;AAC5B,IAAA,IAAI,CAAC,KAAA,CAAM,GAAA,CAAI,GAAG,GAAG,KAAA,CAAM,IAAA,CAAK,EAAE,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,CAAA,EAAG,GAAG,iEAA4D,CAAA;AAAA,EACvH;AACA,EAAA,MAAM,KAAK,KAAA,CAAM,KAAA,CAAM,CAAC,CAAA,KAAM,EAAE,EAAE,CAAA;AAClC,EAAA,IAAI,EAAA,EAAI,KAAA,CAAM,IAAA,CAAK,EAAE,EAAA,EAAI,IAAA,EAAM,IAAA,EAAM,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA,kDAAA,CAAA,EAAsD,CAAA;AACnH,EAAA,OAAO,EAAE,IAAI,KAAA,EAAM;AACrB;AAGO,IAAM,YAAA,GAAe,CAAC,IAAA,EAAkB,cAAA,KAA6D;AAC1G,EAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,KAAqB,MAAA,CAAO,QAAQ,CAAC,CAAA,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA,KAAM,GAAG,CAAC,CAAA,CAAA,EAAI,CAAC,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAC5F,EAAA,MAAM,GAAA,GAAgB;AAAA,IACpB,kBAAA;AAAA,IACA,EAAA;AAAA,IACA,CAAA,2BAAA,EAA8B,MAAM,IAAA,CAAK,IAAI,CAAC,CAAA,oCAAA,EAAuC,KAAA,CAAM,IAAA,CAAK,EAAE,CAAC,CAAA,GAAA,CAAA;AAAA,IACnG,EAAA;AAAA,IACA,eAAA;AAAA,IACA,EAAA;AAAA,IACA,GAAG,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,IAAA,EAAO,CAAA,CAAE,GAAG,CAAA,UAAA,EAAQ,CAAA,CAAE,WAAW,CAAA,CAAE,CAAA;AAAA,IACjE;AAAA,GACF;AACA,EAAA,IAAI,IAAA,CAAK,QAAA,CAAS,MAAA,GAAS,CAAA,EAAG;AAC5B,IAAA,GAAA,CAAI,IAAA,CAAK,+BAAA,EAAiC,EAAA,EAAI,gJAAA,EAA6I,IAAI,GAAG,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAA,EAAK,CAAC,CAAA,CAAE,GAAG,EAAE,CAAA;AAAA,EAC1O;AACA,EAAA,IAAI,IAAA,CAAK,SAAA,CAAU,MAAA,KAAW,CAAA,EAAG;AAC/B,IAAA,GAAA,CAAI,IAAA,CAAK,sBAAsB,EAAA,EAAI,CAAA,qBAAA,EAAwB,KAAK,SAAA,CAAU,MAAM,+CAA+C,EAAE,CAAA;AAAA,EACnI,CAAA,MAAO;AACL,IAAA,GAAA,CAAI,IAAA;AAAA,MACF,CAAA,GAAA,EAAM,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA,oBAAA,CAAA;AAAA,MAC3B,EAAA;AAAA,MACA,gLAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,KAAA,MAAW,GAAA,IAAO,KAAK,SAAA,EAAW;AAChC,MAAA,GAAA,CAAI,IAAA;AAAA,QAAK,CAAA,MAAA,EAAS,GAAA,CAAI,EAAE,CAAA,IAAA,EAAO,IAAI,IAAI,CAAA,CAAA,CAAA;AAAA,QAAK,EAAA;AAAA,QAAI,IAAI,IAAA,KAAS,MAAA,GAAY,EAAA,GAAK,CAAA,cAAA,EAAiB,IAAI,IAAI,CAAA,EAAA,CAAA;AAAA,QACrG,GAAA,CAAI,WAAW,MAAA,IAAa,GAAA,CAAI,OAAO,MAAA,KAAW,CAAA,GAAI,KAAK,CAAA,eAAA,EAAkB,GAAA,CAAI,OAAO,GAAA,CAAI,CAAC,MAAM,CAAA,EAAA,EAAK,CAAC,IAAI,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,6CAAA,CAAA;AAAA,QAA4C,CAAA,kBAAA,EAAqB,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAA,EAAK,CAAC,CAAA,EAAA,CAAI,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AAAA,QAAI,CAAA,uBAAA,EAA0B,cAAA,CAAe,GAAG,CAAC,CAAA,EAAA,CAAA;AAAA,QAAM,gBAAA;AAAA,QAAkB,EAAA;AAAA,QAAI,KAAA;AAAA,QAAO,GAAG,GAAA,CAAI,OAAA;AAAA,QAAS,KAAA;AAAA,QAAO;AAAA,OAAE;AAAA,IACxV;AAAA,EACF;AACA,EAAA,OAAO,IAAI,MAAA,CAAO,CAAC,IAAA,EAAM,CAAA,EAAG,QAAQ,EAAE,IAAA,KAAS,EAAA,IAAM,GAAA,CAAI,IAAI,CAAC,CAAA,KAAM,EAAA,CAAG,CAAA,CAAE,KAAK,IAAI,CAAA;AACpF","file":"index.cjs","sourcesContent":["// Every refusal strata makes, by name. The message is a sentence for a person;\n// the code is for the program that has to decide what to do about it.\nexport type StrataErrorCode =\n // A sequence failed its schema, or two sequences share an id.\n | 'INVALID_SEQUENCE'\n // An applied migration's steps no longer match what the code says it ran.\n | 'EDITED'\n // The database has migrations of a sequence this code does not know yet —\n // it was migrated by newer code.\n | 'TOO_NEW'\n // A `dependsOn` names a migration nobody provides and the ledger lacks.\n | 'UNKNOWN_DEPENDENCY'\n // Pending migrations wait on each other.\n | 'CYCLE'\n // Verify mode found work to do.\n | 'PENDING'\n // A step threw; the whole run was rolled back.\n | 'STEP_FAILED'\n // The pool cannot hold one connection for a transaction.\n | 'NO_TRANSACTION'\n // A document kind nobody declares — as the root being upgraded, a step's\n // `at`, or an embedding's target.\n | 'UNKNOWN_KIND'\n // A grammar sequence handed to the ledger, or a table sequence to upgrade().\n | 'WRONG_OWNER';\n\nexport class StrataError extends Error {\n readonly code: StrataErrorCode;\n readonly details: readonly string[];\n\n constructor(code: StrataErrorCode, message: string, details: readonly string[] = [], options?: { cause?: unknown }) {\n super(details.length > 0 ? `${message}\\n${details.map((d) => ` ${d}`).join('\\n')}` : message, options);\n this.name = 'StrataError';\n this.code = code;\n this.details = details;\n }\n}\n","import type { Sequence } from '../schema';\nimport type { Stamp, Upgrader } from '../documents';\nimport { StrataError } from '../errors';\n\n// ═══════════════════════════════════════════════════════════════\n// @niscorp/strata/check — the gate a grammar change has to pass.\n//\n// Two questions, both mechanical:\n//\n// 1. SNAPSHOT — did a kind's schema change without the grammar gaining a\n// migration? Each kind's JSON Schema, taken through the schema's OWN\n// Standard JSON Schema hook, is recorded per grammar version. Same version,\n// different schema: something changed that older readers were never told.\n// Append a migration (an empty marker is enough for an addition — strict\n// readers still have to refuse the newer documents), then record the new\n// version.\n//\n// 2. CORPUS — does every real document ever captured, at the stamp it was\n// captured at, still upgrade to the current grammar and pass the current\n// strict schema? This is the judge: a snapshot only says something moved,\n// the corpus says whether old documents survive it. No JSON Schema diff\n// tool is trusted to decide compatibility.\n//\n// Pure: no files, no process. A host reads and writes snapshots where it keeps\n// them (nisc's own live in the repo's `strata/` directory).\n// ═══════════════════════════════════════════════════════════════\n\ntype Issue = { message: string; path?: readonly (PropertyKey | { key: PropertyKey })[] };\ntype StandardResult = { value: unknown; issues?: undefined } | { issues: readonly Issue[] };\n\n// Any validator implementing Standard Schema + Standard JSON Schema (Zod ≥ 4.2,\n// Valibot, ArkType). Structural: strata depends on none of them.\nexport type GrammarSchema = {\n '~standard': {\n validate: (value: unknown) => StandardResult | Promise<StandardResult>;\n jsonSchema: { input: (options: { target: string }) => Record<string, unknown> };\n };\n};\n\nexport type Snapshot = { sequence: string; version: number; kinds: Readonly<Record<string, unknown>> };\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst byKey = ([a]: [string, unknown], [b]: [string, unknown]): number => (a < b ? -1 : a > b ? 1 : 0);\n\n// Sorted keys, nothing else — for documents, where every key (a `description`\n// too) is content, and for a snapshot file, which keeps what the validator wrote.\nconst sortKeys = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(sortKeys);\n if (!isRecord(value)) return value;\n return Object.fromEntries(Object.entries(value).sort(byKey).map(([k, v]) => [k, sortKeys(v)]));\n};\n\n// Where a schema's keys are NAMES, not keywords — a field called `description`\n// or an op called `$ref` is grammar — and where its values are instance data\n// rather than schemas.\nconst NAMED = new Set(['properties', 'patternProperties', '$defs', 'definitions', 'dependentSchemas']);\nconst DATA = new Set(['const', 'enum', 'default', 'examples']);\n\n// A schema without its prose: the `description` KEYWORD is documentation, and\n// rewording a `.describe()` must not demand a migration. `$schema` is the same\n// everywhere. Applied when comparing, never to what is recorded — so what the\n// gate ignores can change without touching a snapshot file.\nconst normalize = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(normalize);\n if (!isRecord(value)) return value;\n return Object.fromEntries(\n Object.entries(value)\n .filter(([key]) => key !== 'description' && key !== '$schema')\n .sort(byKey)\n .map(([key, v]) => [key, NAMED.has(key) && isRecord(v) ? namedSchemas(v, normalize) : DATA.has(key) ? sortKeys(v) : normalize(v)]),\n );\n};\n\n// A name → schema map, each schema through `each`, the names untouched.\nconst namedSchemas = (map: Record<string, unknown>, each: (schema: unknown) => unknown): Record<string, unknown> =>\n Object.fromEntries(Object.entries(map).sort(byKey).map(([name, schema]) => [name, each(schema)]));\n\n// The grammar as it stands: every kind it declares, as JSON Schema — as the\n// validator wrote it, keys sorted. `schemas` must cover exactly the sequence's\n// kinds — a kind without a schema cannot be checked, and a schema without a\n// kind belongs to some other grammar.\nexport const snapshotOf = (sequence: Sequence, schemas: Readonly<Record<string, GrammarSchema>>): Snapshot => {\n const declared = Object.keys(sequence.documents ?? {}).map((k) => `${sequence.id}/${k}`);\n const given = Object.keys(schemas);\n const missing = declared.filter((k) => !given.includes(k));\n const extra = given.filter((k) => !declared.includes(k));\n if (missing.length > 0 || extra.length > 0) {\n throw new StrataError('UNKNOWN_KIND', `The schemas for ${sequence.id} do not match its kinds.`, [\n ...missing.map((k) => `no schema for ${k}`),\n ...extra.map((k) => `${k} is not a kind of ${sequence.id}`),\n ]);\n }\n const kinds: Record<string, unknown> = {};\n for (const kind of [...declared].sort()) {\n const schema = schemas[kind];\n if (schema !== undefined) kinds[kind] = sortKeys(schema['~standard'].jsonSchema.input({ target: 'draft-2020-12' }));\n }\n return { sequence: sequence.id, version: sequence.migrations.length, kinds };\n};\n\n// Stable text for a snapshot file: sorted keys, two-space indent, newline.\nexport const snapshotText = (snapshot: Snapshot): string => `${JSON.stringify(sortKeys(snapshot), null, 2)}\n`;\n\n// Schema arrays are compared as sets (`sets`); a document's arrays by position —\n// `layout.children[1]` is how a person finds the thing that changed.\nconst diffLines = (a: unknown, b: unknown, path: string, out: string[], limit: number, canon: (v: unknown) => unknown = normalize, sets = true): void => {\n if (out.length >= limit) return;\n if (JSON.stringify(a) === JSON.stringify(b)) return;\n if (isRecord(a) && isRecord(b)) {\n for (const key of [...new Set([...Object.keys(a), ...Object.keys(b)])].sort()) {\n const at = path === '' ? key : `${path}.${key}`;\n if (!(key in a)) out.push(`+ ${at}`);\n else if (!(key in b)) out.push(`- ${at}`);\n else diffLines(a[key], b[key], at, out, limit, canon, sets);\n if (out.length >= limit) return;\n }\n return;\n }\n if (Array.isArray(a) && Array.isArray(b) && !sets && a.length === b.length) {\n a.forEach((item, i) => diffLines(item, b[i], `${path}[${i}]`, out, limit, canon, sets));\n return;\n }\n if (Array.isArray(a) && Array.isArray(b)) {\n // Schema arrays are SETS more often than sequences — a union's `anyOf`, a\n // `required` list, an `enum` — and one added branch shifts every index\n // after it. Match elements by what they describe (an object schema by its\n // property names — for Prism's union, the op), report the ones on one side\n // only, and diff the ones that changed in place.\n const text = (v: unknown): string => JSON.stringify(canon(v));\n const label = (v: unknown): string =>\n isRecord(v) && isRecord(v['properties']) ? Object.keys(v['properties']).join(',') : (text(v) ?? '').slice(0, 50);\n const onlyA = a.filter((x) => !b.some((y) => text(y) === text(x)));\n const onlyB = b.filter((y) => !a.some((x) => text(x) === text(y)));\n const byLabel = new Map(onlyB.map((y) => [label(y), y]));\n for (const x of onlyA) {\n const partner = byLabel.get(label(x));\n if (partner !== undefined) {\n diffLines(x, partner, `${path}[${label(x)}]`, out, limit, canon, sets);\n byLabel.delete(label(x));\n } else {\n out.push(`- ${path}[${label(x)}]`);\n }\n if (out.length >= limit) return;\n }\n for (const [name] of byLabel) {\n out.push(`+ ${path}[${name}]`);\n if (out.length >= limit) return;\n }\n return;\n }\n out.push(`~ ${path || '(root)'}: ${JSON.stringify(a)?.slice(0, 60)} → ${JSON.stringify(b)?.slice(0, 60)}`);\n};\n\n// ── canonical form ──────────────────────────────────────────────\n//\n// A snapshot records what the validator WROTE, and validators spell one schema\n// many ways: they name and inline definitions as they please (zod numbers them\n// in visit order, and 4.3 and 4.4 visit differently), write a described\n// reference as `allOf: [{ $ref }]` or as `$ref`, and a union of bare types as\n// `anyOf: [{ type }, …]` or `type: […]`. None of that is the grammar, so a\n// comparison reads both sides in one spelling: every definition inlined unless\n// it is recursive, the recursive ones renamed by first use, and every schema\n// identity above written one way. A snapshot FILE stays what the validator\n// wrote — only the comparison is canonical.\n\nconst REF_PREFIX = /^#\\/(\\$defs|definitions)\\//;\n\n// One spelling for the equivalences the node itself can show.\nconst respell = (value: Record<string, unknown>): Record<string, unknown> => {\n let node = value;\n const anyOf = node['anyOf'];\n if (!('type' in node) && Array.isArray(anyOf) && anyOf.length > 0 && anyOf.every((m) => isRecord(m) && Object.keys(m).length === 1 && typeof m['type'] === 'string')) {\n const { anyOf: _union, ...rest } = node;\n node = { ...rest, type: anyOf.map((m) => (isRecord(m) ? m['type'] : undefined)) };\n }\n const type = node['type'];\n if (Array.isArray(type)) {\n const types = [...new Set(type.map(String))].sort();\n node = { ...node, type: types.length === 1 ? types[0] : types };\n }\n const allOf = node['allOf'];\n const only: unknown = Array.isArray(allOf) && allOf.length === 1 ? allOf[0] : undefined;\n if (!('$ref' in node) && isRecord(only) && Object.keys(only).length === 1 && typeof only['$ref'] === 'string') {\n const { allOf: _wrapper, ...rest } = node;\n node = { ...rest, $ref: only['$ref'] };\n }\n return node;\n};\n\n// A schema node's own children — keyword values, and each schema of a name\n// map — but never the names, and never instance data.\nconst schemaChildren = (node: Record<string, unknown>): unknown[] =>\n Object.entries(node).flatMap(([key, child]) =>\n key === '$ref' || DATA.has(key) ? [] : NAMED.has(key) && isRecord(child) ? Object.values(child) : [child],\n );\n\nconst canonical = (recorded: unknown): unknown => {\n const schema = normalize(recorded);\n if (!isRecord(schema)) return schema;\n const defs: Record<string, unknown> = {\n ...(isRecord(schema['definitions']) ? schema['definitions'] : {}),\n ...(isRecord(schema['$defs']) ? schema['$defs'] : {}),\n };\n const { $defs: _defs, definitions: _definitions, ...body } = schema;\n const target = (ref: string): { key: string; node: unknown } =>\n ref === '#' ? { key: '#', node: body } : { key: ref, node: defs[ref.replace(REF_PREFIX, '')] };\n\n // Which targets are reached from inside their own expansion: those, and\n // only those, stay definitions.\n const recursive = new Set<string>();\n const findCycles = (value: unknown, stack: readonly string[]): void => {\n if (Array.isArray(value)) {\n for (const item of value) findCycles(item, stack);\n return;\n }\n if (!isRecord(value)) return;\n const node = respell(value);\n for (const child of schemaChildren(node)) findCycles(child, stack);\n const ref = node['$ref'];\n if (typeof ref !== 'string') return;\n const { key, node: next } = target(ref);\n if (stack.includes(key)) recursive.add(key);\n else findCycles(next, [...stack, key]);\n };\n findCycles(body, ['#']);\n\n const names = new Map<string, string>();\n const named: Record<string, unknown> = {};\n const nameOf = (key: string, node: unknown): string => {\n const known = names.get(key);\n if (known !== undefined) return known;\n const name = `d${names.size}`;\n names.set(key, name);\n named[name] = emit(node);\n return name;\n };\n const emit = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(emit);\n if (!isRecord(value)) return value;\n const node = respell(value);\n const rest: Record<string, unknown> = Object.fromEntries(\n Object.entries(node)\n .filter(([key]) => key !== '$ref')\n .sort(byKey)\n .map(([key, child]) => [key, NAMED.has(key) && isRecord(child) ? namedSchemas(child, emit) : DATA.has(key) ? child : emit(child)]),\n );\n const ref = node['$ref'];\n if (typeof ref !== 'string') return rest;\n const { key, node: next } = target(ref);\n const referred = recursive.has(key) ? { $ref: `#/$defs/${nameOf(key, next)}` } : emit(next);\n return Object.keys(rest).length > 0 ? { ...rest, allOf: [referred] } : referred;\n };\n\n const root = recursive.has('#') ? { $ref: `#/$defs/${nameOf('#', body)}` } : emit(body);\n return Object.keys(named).length === 0 ? root : sortKeys({ ...(isRecord(root) ? root : { allOf: [root] }), $defs: named });\n};\n\nexport type SnapshotComparison =\n | { status: 'same' }\n | { status: 'missing' }\n | { status: 'changed'; changes: readonly { kind: string; lines: readonly string[] }[] };\n\n// `recorded` is the snapshot kept for the grammar's CURRENT version (or\n// undefined if none was kept). Changed means: a migration is owed. Both sides\n// are read in canonical form, so a validator's respelling is not a change.\nexport const compareSnapshot = (recorded: Snapshot | undefined, current: Snapshot): SnapshotComparison => {\n if (recorded === undefined) return { status: 'missing' };\n const changes: { kind: string; lines: string[] }[] = [];\n for (const kind of [...new Set([...Object.keys(recorded.kinds), ...Object.keys(current.kinds)])].sort()) {\n const lines: string[] = [];\n if (!(kind in recorded.kinds)) lines.push('+ (a new kind)');\n else if (!(kind in current.kinds)) lines.push('- (the kind is gone)');\n else diffLines(canonical(recorded.kinds[kind]), canonical(current.kinds[kind]), '', lines, 12);\n if (lines.length > 0) changes.push({ kind, lines });\n }\n return changes.length === 0 ? { status: 'same' } : { status: 'changed', changes };\n};\n\n// ── the corpus ──────────────────────────────────────────────────\n\nexport type CorpusDocument = { id: string; kind: string; stamp: Stamp; document: unknown };\nexport type CorpusFailure = { id: string; kind: string; reason: string };\nexport type CorpusReport = { passed: number; failures: readonly CorpusFailure[] };\n\nconst issueText = (issue: Issue): string => {\n const path = (issue.path ?? []).map((p) => (typeof p === 'object' ? String(p.key) : String(p))).join('.');\n return `${path === '' ? '' : `${path}: `}${issue.message}`;\n};\n\n// What differs between two JSON values, as short lines (`+ a.b`, `- c`,\n// `~ d: 1 → 2`) — for a report a person or an agent acts on.\nexport const diffJson = (a: unknown, b: unknown, limit = 20): string[] => {\n const out: string[] = [];\n diffLines(a, b, '', out, limit, sortKeys, false);\n return out;\n};\n\n// Every document, upgraded from its stamp, must pass the current schema of its kind.\nexport const checkCorpus = async (\n upgrader: Upgrader,\n schemas: Readonly<Record<string, GrammarSchema>>,\n documents: readonly CorpusDocument[],\n): Promise<CorpusReport> => {\n const failures: CorpusFailure[] = [];\n let passed = 0;\n for (const doc of documents) {\n const schema = schemas[doc.kind];\n if (schema === undefined) {\n failures.push({ id: doc.id, kind: doc.kind, reason: `no schema for ${doc.kind}` });\n continue;\n }\n let upgraded: unknown;\n try {\n upgraded = upgrader.upgrade(doc.document, { kind: doc.kind, stamp: doc.stamp }).document;\n } catch (error) {\n failures.push({ id: doc.id, kind: doc.kind, reason: error instanceof Error ? error.message.split('\\n')[0] ?? error.message : String(error) });\n continue;\n }\n const result = await schema['~standard'].validate(upgraded);\n if (result.issues !== undefined) {\n failures.push({ id: doc.id, kind: doc.kind, reason: result.issues.slice(0, 3).map(issueText).join('; ') });\n } else {\n passed += 1;\n }\n }\n return { passed, failures };\n};\n","import type { Stamp, Upgrader } from '../documents';\nimport { diffJson, type GrammarSchema } from '../check';\nimport { StrataError } from '../errors';\n\n// ═══════════════════════════════════════════════════════════════\n// @niscorp/strata/upgrade — artifacts in an app's SOURCE, brought forward.\n//\n// Rows and submissions are upgraded where they are read. Source files are\n// different: they are TypeScript, written by people, and rewriting them by\n// machine means a codemod that would have to understand every way a person\n// can write an object. So strata does not edit them. It works out, from the\n// migrations, EXACTLY what each artifact must become — and then checks that\n// whoever did the editing (a person, an agent) landed on it, byte for byte.\n//\n// plan the lock says the source is written at stamp S; the installed\n// grammars are ahead. Every artifact is upgraded from S: the ones\n// that change get their expected JSON and a diff; the rest are noted.\n// (edit) anyone — the report says which artifact, which migration, what\n// changes, and where the expected JSON is.\n// verify the edited source, read again: every planned artifact equals its\n// expected JSON; every other one is still one no migration touches.\n// Then — and only then — the lock moves.\n//\n// Pure: documents in, plans out. `@niscorp/strata/node` does the files.\n// ═══════════════════════════════════════════════════════════════\n\nexport type SourceDocument = { kind: string; id: string; document: unknown; file?: string };\n\nexport type PlannedDocument = {\n kind: string;\n id: string;\n file?: string;\n // Files that contain what changes — the artifact's own file names only where\n // its id is written; the layout it imports is often where the edit goes.\n lookIn?: readonly string[];\n applied: readonly string[];\n changes: readonly string[];\n expected: unknown;\n};\n\nexport type SourcePlan = {\n from: Stamp;\n to: Stamp;\n migrations: readonly { ref: string; description: string }[];\n // Artifacts the migrations change — the whole to-do list.\n documents: readonly PlannedDocument[];\n // Artifacts no pending migration touches (by kind:id) — verify checks they stay that way.\n untouched: readonly string[];\n // An expected document that does not pass its kind's current schema: the\n // MIGRATION is wrong, and no edit could make verify pass. Fix it first.\n problems: readonly string[];\n};\n\nconst keyOf = (doc: { kind: string; id: string }): string => `${doc.kind}:${doc.id}`;\n\nconst sortKeys = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(sortKeys);\n if (typeof value !== 'object' || value === null) return value;\n return Object.fromEntries(Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)).map(([k, v]) => [k, sortKeys(v)]));\n};\n// Equal as JSON: key order is how a person happened to write the object, not content.\nconst sameJson = (a: unknown, b: unknown): boolean => JSON.stringify(sortKeys(a)) === JSON.stringify(sortKeys(b));\n\n// The string values a migration removes or rewrites — what to search the\n// source for to find where an edit goes.\nexport const changedStrings = (before: unknown, after: unknown): string[] => {\n const found = new Set<string>();\n const visit = (a: unknown, b: unknown): void => {\n if (JSON.stringify(a) === JSON.stringify(b)) return;\n if (typeof a === 'string') {\n found.add(a);\n return;\n }\n if (Array.isArray(a)) {\n a.forEach((item, i) => visit(item, Array.isArray(b) ? b[i] : undefined));\n return;\n }\n if (typeof a === 'object' && a !== null) {\n for (const [k, v] of Object.entries(a)) visit(v, typeof b === 'object' && b !== null && !Array.isArray(b) ? Reflect.get(b, k) : undefined);\n }\n };\n visit(before, after);\n return [...found].filter((s) => s.length >= 4);\n};\n\nexport const planSourceUpgrade = async (options: {\n upgrader: Upgrader;\n stamp: Stamp;\n documents: readonly SourceDocument[];\n schemas?: Readonly<Record<string, GrammarSchema>>;\n // Every migration the upgrader would run from `stamp`, for the report — the\n // host passes the grammar sequences' descriptions.\n describe: (ref: string) => string;\n}): Promise<SourcePlan> => {\n const { upgrader, stamp, documents, schemas, describe } = options;\n const seen = new Set<string>();\n const planned: PlannedDocument[] = [];\n const untouched: string[] = [];\n const problems: string[] = [];\n\n for (const doc of documents) {\n const key = keyOf(doc);\n if (seen.has(key)) throw new StrataError('INVALID_SEQUENCE', `Two artifacts are both ${key} — an artifact needs one identity to be planned.`);\n seen.add(key);\n const result = upgrader.upgrade(doc.document, { kind: doc.kind, stamp });\n if (sameJson(result.document, doc.document)) {\n untouched.push(key);\n continue;\n }\n planned.push({\n kind: doc.kind,\n id: doc.id,\n ...(doc.file === undefined ? {} : { file: doc.file }),\n applied: result.applied,\n changes: diffJson(doc.document, result.document),\n expected: result.document,\n });\n const schema = schemas?.[doc.kind];\n if (schema !== undefined) {\n const checked = await schema['~standard'].validate(result.document);\n if (checked.issues !== undefined) {\n problems.push(`${key}: the migrated artifact does not pass ${doc.kind}'s current schema — ${checked.issues.slice(0, 2).map((i) => i.message).join('; ')}`);\n }\n }\n }\n\n // Every migration between the lock and the installed grammars — markers\n // included, which change no artifact but still move the version.\n const from = stamp;\n const to = upgrader.stamp;\n const migrations = Object.entries(to).flatMap(([id, n]) =>\n Array.from({ length: Math.max(0, n - (from[id] ?? 0)) }, (_, i) => `${id}/${(from[id] ?? 0) + i + 1}`),\n );\n return {\n from,\n to,\n migrations: migrations.map((ref) => ({ ref, description: describe(ref) })),\n documents: planned.sort((a, b) => (keyOf(a) < keyOf(b) ? -1 : 1)),\n untouched: untouched.sort(),\n problems,\n };\n};\n\nexport type VerifyResult = {\n ok: boolean;\n lines: readonly { ok: boolean; text: string; detail?: readonly string[] }[];\n};\n\n// The edited source against the plan. `upgrader` still reads from the plan's\n// `from` stamp: an artifact the plan left untouched must still be one no\n// pending migration would change.\nexport const verifySourceUpgrade = (options: { plan: SourcePlan; upgrader: Upgrader; documents: readonly SourceDocument[] }): VerifyResult => {\n const { plan, upgrader, documents } = options;\n const now = new Map(documents.map((d) => [keyOf(d), d]));\n const lines: { ok: boolean; text: string; detail?: readonly string[] }[] = [];\n\n for (const want of plan.documents) {\n const key = keyOf(want);\n const got = now.get(key);\n if (got === undefined) {\n lines.push({ ok: false, text: `${key} is gone — the plan expected it rewritten, not removed` });\n } else if (sameJson(got.document, want.expected)) {\n lines.push({ ok: true, text: `${key} matches its migrated JSON` });\n } else {\n lines.push({ ok: false, text: `${key} does not match its migrated JSON yet`, detail: diffJson(got.document, want.expected, 12) });\n }\n }\n for (const key of plan.untouched) {\n const got = now.get(key);\n if (got === undefined) {\n lines.push({ ok: false, text: `${key} is gone — no migration asked for that` });\n continue;\n }\n const again = upgrader.upgrade(got.document, { kind: got.kind, stamp: plan.from });\n if (!sameJson(again.document, got.document)) {\n lines.push({ ok: false, text: `${key} was not in the plan, but the migrations would change it now`, detail: diffJson(got.document, again.document, 12) });\n }\n }\n const known = new Set([...plan.documents.map(keyOf), ...plan.untouched]);\n for (const key of now.keys()) {\n if (!known.has(key)) lines.push({ ok: false, text: `${key} is new since the plan — plan again so it is checked too` });\n }\n const ok = lines.every((l) => l.ok);\n if (ok) lines.push({ ok: true, text: `${plan.untouched.length} artifact(s) no migration touches, still untouched` });\n return { ok, lines };\n};\n\n// The report a person — or an agent — works from.\nexport const renderReport = (plan: SourcePlan, expectedPathOf: (doc: PlannedDocument) => string): string => {\n const stamp = (s: Stamp): string => Object.entries(s).map(([k, v]) => `${k} ${v}`).join(', ');\n const out: string[] = [\n '# strata upgrade',\n '',\n `The source is written at **${stamp(plan.from)}**; the installed grammars are at **${stamp(plan.to)}**.`,\n '',\n '## Migrations',\n '',\n ...plan.migrations.map((m) => `- \\`${m.ref}\\` — ${m.description}`),\n '',\n ];\n if (plan.problems.length > 0) {\n out.push('## Stop: a migration is wrong', '', 'These artifacts would not pass their current schema after migrating — no edit can make `verify` pass. Fix the migration, then plan again.', '', ...plan.problems.map((p) => `- ${p}`), '');\n }\n if (plan.documents.length === 0) {\n out.push('## Nothing to edit', '', `No artifact changes (${plan.untouched.length} checked). Run \\`verify\\` to move the lock.`, '');\n } else {\n out.push(\n `## ${plan.documents.length} artifact(s) to edit`,\n '',\n 'Edit each so that it serialises to EXACTLY its expected JSON (key order aside) — then run `verify`. Only what is listed changes; every other artifact must stay as it is.',\n '',\n );\n for (const doc of plan.documents) {\n out.push(`### \\`${doc.id}\\` (${doc.kind})`, '', doc.file === undefined ? '' : `- **File:** \\`${doc.file}\\``,\n doc.lookIn === undefined || doc.lookIn.length === 0 ? '' : `- **Look in:** ${doc.lookIn.map((f) => `\\`${f}\\``).join(', ')} — where the changing values are written`, `- **Migrations:** ${doc.applied.map((r) => `\\`${r}\\``).join(', ')}`, `- **Expected JSON:** \\`${expectedPathOf(doc)}\\``, '- **Changes:**', '', '```', ...doc.changes, '```', '');\n }\n }\n return out.filter((line, i, all) => !(line === '' && all[i - 1] === '')).join('\\n');\n};\n"]}
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
@@ -1,5 +1,5 @@
1
- export { changedStrings, planSourceUpgrade, renderReport, verifySourceUpgrade } from '../chunk-HMT7HHFJ.js';
2
- import '../chunk-MY3TGSV3.js';
3
- import '../chunk-EGFF63GA.js';
1
+ export { changedStrings, planSourceUpgrade, renderReport, verifySourceUpgrade } from '../chunk-WU3OJHVZ.js';
2
+ import '../chunk-4BLHBVSC.js';
3
+ import '../chunk-AKKWEXO2.js';
4
4
  //# sourceMappingURL=index.js.map
5
5
  //# sourceMappingURL=index.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@niscorp/strata",
3
- "version": "0.1.1",
3
+ "version": "0.1.4",
4
4
  "description": "Migrations for nisc — one ledger for the tables a database holds and the documents stored in them, applied in order, recorded once, refused when edited.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -60,7 +60,8 @@
60
60
  "types": "./dist/node/index.d.cts",
61
61
  "default": "./dist/node/index.cjs"
62
62
  }
63
- }
63
+ },
64
+ "./package.json": "./package.json"
64
65
  },
65
66
  "files": [
66
67
  "dist",
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/documents.ts"],"names":[],"mappings":"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","file":"chunk-ICWKTTKN.js","sourcesContent":["import { prepare, orderPending, type PreparedMigration, type PreparedSequence } from './plan';\nimport type { DocumentKind, Sequence } from './schema';\nimport { StrataError } from './errors';\n\n// ═══════════════════════════════════════════════════════════════\n// Documents — the JSON a grammar describes, wherever it is kept.\n//\n// A document carries a STAMP: for each grammar sequence, how far along that\n// sequence the writer was (`{ \"nisc.nova\": 3, \"nisc.prism\": 1 }`). Upgrading\n// runs every document migration the stamp has not seen, in the ledger's order,\n// and hands back the document with a current stamp. The same function serves a\n// row read at boot, a submission at intake and a file in an app's source tree:\n// the document does not care where it was kept.\n//\n// NESTING IS THE GRAMMAR'S, NOT THE MIGRATION'S. A kind declares where other\n// documents sit inside it (its embeddings: nova's layout holds layouts at\n// `children`, `children[]`, `then`, `else`, `do`; an action holds a layout and\n// Prism configs). The walker finds every document of a step's kind at any\n// depth and rewrites each on its own, deepest first. A transform only ever sees\n// ONE node — so migrations stay flat, and a Prism config can express them\n// without recursion of its own.\n// ═══════════════════════════════════════════════════════════════\n\nexport type Stamp = Readonly<Record<string, number>>;\n\n// Where a document sits: the path from the root (keys and indexes) and its kind.\nexport type Location = { path: readonly (string | number)[]; kind: string; value: Record<string, unknown> };\n\n// The injected evaluator — nova's `transform` socket, the same shape: under moss\n// it is Prism's `evaluate`, and a migration runs exactly the way an endpoint does.\nexport type Transform = (config: unknown, source: unknown) => unknown;\n\nexport type UpgradeResult = {\n document: Record<string, unknown>;\n stamp: Stamp;\n // What ran, in order — empty when the document was already current.\n applied: readonly string[];\n};\n\nexport type Upgrader = {\n // The stamp a document written NOW carries.\n stamp: Stamp;\n upgrade: (document: unknown, options: { kind: string; stamp?: Stamp | null }) => UpgradeResult;\n // Every document inside `document` (itself included), by kind — what the\n // walker sees. For a page that shows it, and for a check that asserts it.\n locate: (document: unknown, kind: string) => Location[];\n // Is a document at this stamp behind the code (true), current (false)? Throws\n // TOO_NEW if it is ahead.\n behind: (stamp: Stamp | null | undefined) => boolean;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst pathText = (path: readonly (string | number)[]): string =>\n path.reduce<string>((text, key) => (typeof key === 'number' ? `${text}[${key}]` : text === '' ? key : `${text}.${key}`), '');\n\n// One embedding pattern, applied to one value: every (relative path, value)\n// the pattern reaches. `key` descends, `*` crosses a record's values, and a\n// `[]` suffix crosses the array found there.\nconst reach = (value: unknown, pattern: string): { path: (string | number)[]; value: unknown }[] => {\n let frontier: { path: (string | number)[]; value: unknown }[] = [{ path: [], value }];\n for (const segment of pattern.split('.')) {\n const array = segment.endsWith('[]');\n const key = array ? segment.slice(0, -2) : segment;\n const next: { path: (string | number)[]; value: unknown }[] = [];\n for (const at of frontier) {\n if (!isRecord(at.value)) continue;\n const found: { path: (string | number)[]; value: unknown }[] =\n key === '*'\n ? Object.entries(at.value).map(([k, v]) => ({ path: [...at.path, k], value: v }))\n : key in at.value\n ? [{ path: [...at.path, key], value: at.value[key] }]\n : [];\n for (const f of found) {\n if (!array) next.push(f);\n else if (Array.isArray(f.value)) f.value.forEach((item, i) => next.push({ path: [...f.path, i], value: item }));\n }\n }\n frontier = next;\n }\n return frontier;\n};\n\nconst getAt = (root: unknown, path: readonly (string | number)[]): unknown =>\n path.reduce<unknown>((at, key) => {\n if (typeof key === 'number') return Array.isArray(at) ? at[key] : undefined;\n return isRecord(at) ? at[key] : undefined;\n }, root);\n\nconst setAt = (root: unknown, path: readonly (string | number)[], value: unknown): unknown => {\n const [head, ...rest] = path;\n if (head === undefined) return value;\n if (typeof head === 'number' && Array.isArray(root)) return root.map((item, i) => (i === head ? setAt(item, rest, value) : item));\n if (typeof head === 'string' && isRecord(root)) return { ...root, [head]: setAt(root[head], rest, value) };\n return root;\n};\n\nexport const createUpgrader = async (sequences: readonly Sequence[], options: { transform: Transform }): Promise<Upgrader> => {\n const prepared = await prepare(sequences);\n const tables = prepared.filter((s) => !s.grammar);\n if (tables.length > 0) {\n throw new StrataError(\n 'WRONG_OWNER',\n 'Documents are upgraded by grammar sequences; these own tables and belong to a database\\'s ledger (`migrate`).',\n tables.map((s) => s.id),\n );\n }\n const grammars: readonly PreparedSequence[] = prepared;\n\n const kinds = new Map<string, DocumentKind>();\n for (const sequence of grammars) {\n for (const [name, kind] of Object.entries(sequence.documents)) kinds.set(`${sequence.id}/${name}`, kind);\n }\n const unknown = [\n ...grammars.flatMap((s) => s.migrations.flatMap((m) => m.steps.flatMap((step) => (step.kind === 'document' && !kinds.has(step.at) ? [`${m.ref} rewrites ${step.at}`] : [])))),\n ...[...kinds].flatMap(([ref, kind]) => Object.entries(kind.embeds ?? {}).flatMap(([path, target]) => (kinds.has(target) ? [] : [`${ref} embeds ${target} at ${path}`]))),\n ];\n if (unknown.length > 0) throw new StrataError('UNKNOWN_KIND', 'A document kind is named that no sequence declares.', unknown);\n\n const stamp: Stamp = Object.fromEntries(grammars.map((s) => [s.id, s.migrations.length]));\n\n const locate = (document: unknown, kind: string): Location[] => {\n if (!kinds.has(kind)) throw new StrataError('UNKNOWN_KIND', `No sequence declares the document kind \"${kind}\".`, [...kinds.keys()]);\n const found: Location[] = [];\n const visit = (value: unknown, at: string, path: (string | number)[]): void => {\n if (!isRecord(value)) return;\n found.push({ path, kind: at, value });\n for (const [pattern, target] of Object.entries(kinds.get(at)?.embeds ?? {})) {\n for (const hit of reach(value, pattern)) visit(hit.value, target, [...path, ...hit.path]);\n }\n };\n visit(document, kind, []);\n return found;\n };\n\n const positionOf = (given: Stamp | null | undefined, id: string): number => given?.[id] ?? 0;\n\n const behind = (given: Stamp | null | undefined): boolean => {\n const ahead = grammars.filter((s) => positionOf(given, s.id) > s.migrations.length);\n if (ahead.length > 0) {\n throw new StrataError(\n 'TOO_NEW',\n 'This document was written by newer code than this — reading it would be guessing.',\n ahead.map((s) => `${s.id}: the document is at ${positionOf(given, s.id)}, this code knows ${s.migrations.length}`),\n );\n }\n return grammars.some((s) => positionOf(given, s.id) < s.migrations.length);\n };\n\n const upgrade = (document: unknown, { kind, stamp: given }: { kind: string; stamp?: Stamp | null }): UpgradeResult => {\n if (!isRecord(document)) throw new StrataError('STEP_FAILED', `A ${kind} document must be a JSON object.`);\n if (!kinds.has(kind)) throw new StrataError('UNKNOWN_KIND', `No sequence declares the document kind \"${kind}\".`, [...kinds.keys()]);\n if (!behind(given)) return { document, stamp, applied: [] };\n\n // What this document has seen: everything up to its stamp, per sequence.\n // A sequence it has never heard of starts at 0 — a document written before\n // a grammar existed simply has none of its migrations yet.\n const done = new Set(grammars.flatMap((s) => s.migrations.filter((m) => m.n <= positionOf(given, s.id)).map((m) => m.ref)));\n const { pending, stuck } = orderPending(\n grammars.map((s) => ({ waiting: s.migrations.filter((m) => !done.has(m.ref)) })),\n done,\n );\n if (stuck.length > 0) throw new StrataError('CYCLE', 'Document migrations wait on each other and can never run.', stuck.map((m) => m.ref));\n\n let current: Record<string, unknown> = document;\n const applied: string[] = [];\n const runStep = (migration: PreparedMigration, at: string, transform: unknown): void => {\n // Deepest first: a parent's rewrite sees its children already rewritten,\n // and replacing a child never moves the path to its parent.\n const targets = locate(current, kind)\n .filter((l) => l.kind === at)\n .sort((a, b) => b.path.length - a.path.length);\n for (const target of targets) {\n // The value NOW, not when the targets were found: a child rewritten a\n // moment ago lives in `current`, and the parent must see — and keep — it.\n const value = getAt(current, target.path);\n let rewritten: unknown;\n try {\n rewritten = options.transform(transform, { document: value, path: pathText(target.path) });\n } catch (cause) {\n throw new StrataError(\n 'STEP_FAILED',\n `${migration.ref} (\"${migration.description}\") failed on the ${at} at ${pathText(target.path) || '(root)'}.`,\n [cause instanceof Error ? cause.message : String(cause)],\n { cause },\n );\n }\n if (!isRecord(rewritten)) {\n throw new StrataError('STEP_FAILED', `${migration.ref} turned the ${at} at ${pathText(target.path) || '(root)'} into something that is not a document.`, [\n JSON.stringify(rewritten)?.slice(0, 200) ?? String(rewritten),\n ]);\n }\n const next = setAt(current, target.path, rewritten);\n if (isRecord(next)) current = next;\n }\n };\n for (const migration of pending) {\n for (const step of migration.steps) if (step.kind === 'document') runStep(migration, step.at, step.transform);\n applied.push(migration.ref);\n }\n return { document: current, stamp, applied };\n };\n\n return { stamp, upgrade, locate, behind };\n};\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/check/index.ts"],"names":["key"],"mappings":"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","file":"chunk-MY3TGSV3.js","sourcesContent":["import type { Sequence } from '../schema';\nimport type { Stamp, Upgrader } from '../documents';\nimport { StrataError } from '../errors';\n\n// ═══════════════════════════════════════════════════════════════\n// @niscorp/strata/check — the gate a grammar change has to pass.\n//\n// Two questions, both mechanical:\n//\n// 1. SNAPSHOT — did a kind's schema change without the grammar gaining a\n// migration? Each kind's JSON Schema, taken through the schema's OWN\n// Standard JSON Schema hook, is recorded per grammar version. Same version,\n// different schema: something changed that older readers were never told.\n// Append a migration (an empty marker is enough for an addition — strict\n// readers still have to refuse the newer documents), then record the new\n// version.\n//\n// 2. CORPUS — does every real document ever captured, at the stamp it was\n// captured at, still upgrade to the current grammar and pass the current\n// strict schema? This is the judge: a snapshot only says something moved,\n// the corpus says whether old documents survive it. No JSON Schema diff\n// tool is trusted to decide compatibility.\n//\n// Pure: no files, no process. A host reads and writes snapshots where it keeps\n// them (nisc's own live in the repo's `strata/` directory).\n// ═══════════════════════════════════════════════════════════════\n\ntype Issue = { message: string; path?: readonly (PropertyKey | { key: PropertyKey })[] };\ntype StandardResult = { value: unknown; issues?: undefined } | { issues: readonly Issue[] };\n\n// Any validator implementing Standard Schema + Standard JSON Schema (Zod ≥ 4.2,\n// Valibot, ArkType). Structural: strata depends on none of them.\nexport type GrammarSchema = {\n '~standard': {\n validate: (value: unknown) => StandardResult | Promise<StandardResult>;\n jsonSchema: { input: (options: { target: string }) => Record<string, unknown> };\n };\n};\n\nexport type Snapshot = { sequence: string; version: number; kinds: Readonly<Record<string, unknown>> };\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst byKey = ([a]: [string, unknown], [b]: [string, unknown]): number => (a < b ? -1 : a > b ? 1 : 0);\n\n// Sorted keys, nothing else — for documents, where every key (a `description`\n// too) is content, and for a snapshot file, which keeps what the validator wrote.\nconst sortKeys = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(sortKeys);\n if (!isRecord(value)) return value;\n return Object.fromEntries(Object.entries(value).sort(byKey).map(([k, v]) => [k, sortKeys(v)]));\n};\n\n// Where a schema's keys are NAMES, not keywords — a field called `description`\n// or an op called `$ref` is grammar — and where its values are instance data\n// rather than schemas.\nconst NAMED = new Set(['properties', 'patternProperties', '$defs', 'definitions', 'dependentSchemas']);\nconst DATA = new Set(['const', 'enum', 'default', 'examples']);\n\n// A schema without its prose: the `description` KEYWORD is documentation, and\n// rewording a `.describe()` must not demand a migration. `$schema` is the same\n// everywhere. Applied when comparing, never to what is recorded — so what the\n// gate ignores can change without touching a snapshot file.\nconst normalize = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(normalize);\n if (!isRecord(value)) return value;\n return Object.fromEntries(\n Object.entries(value)\n .filter(([key]) => key !== 'description' && key !== '$schema')\n .sort(byKey)\n .map(([key, v]) => [key, NAMED.has(key) && isRecord(v) ? namedSchemas(v, normalize) : DATA.has(key) ? sortKeys(v) : normalize(v)]),\n );\n};\n\n// A name → schema map, each schema through `each`, the names untouched.\nconst namedSchemas = (map: Record<string, unknown>, each: (schema: unknown) => unknown): Record<string, unknown> =>\n Object.fromEntries(Object.entries(map).sort(byKey).map(([name, schema]) => [name, each(schema)]));\n\n// The grammar as it stands: every kind it declares, as JSON Schema — as the\n// validator wrote it, keys sorted. `schemas` must cover exactly the sequence's\n// kinds — a kind without a schema cannot be checked, and a schema without a\n// kind belongs to some other grammar.\nexport const snapshotOf = (sequence: Sequence, schemas: Readonly<Record<string, GrammarSchema>>): Snapshot => {\n const declared = Object.keys(sequence.documents ?? {}).map((k) => `${sequence.id}/${k}`);\n const given = Object.keys(schemas);\n const missing = declared.filter((k) => !given.includes(k));\n const extra = given.filter((k) => !declared.includes(k));\n if (missing.length > 0 || extra.length > 0) {\n throw new StrataError('UNKNOWN_KIND', `The schemas for ${sequence.id} do not match its kinds.`, [\n ...missing.map((k) => `no schema for ${k}`),\n ...extra.map((k) => `${k} is not a kind of ${sequence.id}`),\n ]);\n }\n const kinds: Record<string, unknown> = {};\n for (const kind of [...declared].sort()) {\n const schema = schemas[kind];\n if (schema !== undefined) kinds[kind] = sortKeys(schema['~standard'].jsonSchema.input({ target: 'draft-2020-12' }));\n }\n return { sequence: sequence.id, version: sequence.migrations.length, kinds };\n};\n\n// Stable text for a snapshot file: sorted keys, two-space indent, newline.\nexport const snapshotText = (snapshot: Snapshot): string => `${JSON.stringify(sortKeys(snapshot), null, 2)}\n`;\n\n// Schema arrays are compared as sets (`sets`); a document's arrays by position —\n// `layout.children[1]` is how a person finds the thing that changed.\nconst diffLines = (a: unknown, b: unknown, path: string, out: string[], limit: number, canon: (v: unknown) => unknown = normalize, sets = true): void => {\n if (out.length >= limit) return;\n if (JSON.stringify(a) === JSON.stringify(b)) return;\n if (isRecord(a) && isRecord(b)) {\n for (const key of [...new Set([...Object.keys(a), ...Object.keys(b)])].sort()) {\n const at = path === '' ? key : `${path}.${key}`;\n if (!(key in a)) out.push(`+ ${at}`);\n else if (!(key in b)) out.push(`- ${at}`);\n else diffLines(a[key], b[key], at, out, limit, canon, sets);\n if (out.length >= limit) return;\n }\n return;\n }\n if (Array.isArray(a) && Array.isArray(b) && !sets && a.length === b.length) {\n a.forEach((item, i) => diffLines(item, b[i], `${path}[${i}]`, out, limit, canon, sets));\n return;\n }\n if (Array.isArray(a) && Array.isArray(b)) {\n // Schema arrays are SETS more often than sequences — a union's `anyOf`, a\n // `required` list, an `enum` — and one added branch shifts every index\n // after it. Match elements by what they describe (an object schema by its\n // property names — for Prism's union, the op), report the ones on one side\n // only, and diff the ones that changed in place.\n const text = (v: unknown): string => JSON.stringify(canon(v));\n const label = (v: unknown): string =>\n isRecord(v) && isRecord(v['properties']) ? Object.keys(v['properties']).join(',') : (text(v) ?? '').slice(0, 50);\n const onlyA = a.filter((x) => !b.some((y) => text(y) === text(x)));\n const onlyB = b.filter((y) => !a.some((x) => text(x) === text(y)));\n const byLabel = new Map(onlyB.map((y) => [label(y), y]));\n for (const x of onlyA) {\n const partner = byLabel.get(label(x));\n if (partner !== undefined) {\n diffLines(x, partner, `${path}[${label(x)}]`, out, limit, canon, sets);\n byLabel.delete(label(x));\n } else {\n out.push(`- ${path}[${label(x)}]`);\n }\n if (out.length >= limit) return;\n }\n for (const [name] of byLabel) {\n out.push(`+ ${path}[${name}]`);\n if (out.length >= limit) return;\n }\n return;\n }\n out.push(`~ ${path || '(root)'}: ${JSON.stringify(a)?.slice(0, 60)} → ${JSON.stringify(b)?.slice(0, 60)}`);\n};\n\n// ── canonical form ──────────────────────────────────────────────\n//\n// A snapshot records what the validator WROTE, and validators spell one schema\n// many ways: they name and inline definitions as they please (zod numbers them\n// in visit order, and 4.3 and 4.4 visit differently), write a described\n// reference as `allOf: [{ $ref }]` or as `$ref`, and a union of bare types as\n// `anyOf: [{ type }, …]` or `type: […]`. None of that is the grammar, so a\n// comparison reads both sides in one spelling: every definition inlined unless\n// it is recursive, the recursive ones renamed by first use, and every schema\n// identity above written one way. A snapshot FILE stays what the validator\n// wrote — only the comparison is canonical.\n\nconst REF_PREFIX = /^#\\/(\\$defs|definitions)\\//;\n\n// One spelling for the equivalences the node itself can show.\nconst respell = (value: Record<string, unknown>): Record<string, unknown> => {\n let node = value;\n const anyOf = node['anyOf'];\n if (!('type' in node) && Array.isArray(anyOf) && anyOf.length > 0 && anyOf.every((m) => isRecord(m) && Object.keys(m).length === 1 && typeof m['type'] === 'string')) {\n const { anyOf: _union, ...rest } = node;\n node = { ...rest, type: anyOf.map((m) => (isRecord(m) ? m['type'] : undefined)) };\n }\n const type = node['type'];\n if (Array.isArray(type)) {\n const types = [...new Set(type.map(String))].sort();\n node = { ...node, type: types.length === 1 ? types[0] : types };\n }\n const allOf = node['allOf'];\n const only: unknown = Array.isArray(allOf) && allOf.length === 1 ? allOf[0] : undefined;\n if (!('$ref' in node) && isRecord(only) && Object.keys(only).length === 1 && typeof only['$ref'] === 'string') {\n const { allOf: _wrapper, ...rest } = node;\n node = { ...rest, $ref: only['$ref'] };\n }\n return node;\n};\n\n// A schema node's own children — keyword values, and each schema of a name\n// map — but never the names, and never instance data.\nconst schemaChildren = (node: Record<string, unknown>): unknown[] =>\n Object.entries(node).flatMap(([key, child]) =>\n key === '$ref' || DATA.has(key) ? [] : NAMED.has(key) && isRecord(child) ? Object.values(child) : [child],\n );\n\nconst canonical = (recorded: unknown): unknown => {\n const schema = normalize(recorded);\n if (!isRecord(schema)) return schema;\n const defs: Record<string, unknown> = {\n ...(isRecord(schema['definitions']) ? schema['definitions'] : {}),\n ...(isRecord(schema['$defs']) ? schema['$defs'] : {}),\n };\n const { $defs: _defs, definitions: _definitions, ...body } = schema;\n const target = (ref: string): { key: string; node: unknown } =>\n ref === '#' ? { key: '#', node: body } : { key: ref, node: defs[ref.replace(REF_PREFIX, '')] };\n\n // Which targets are reached from inside their own expansion: those, and\n // only those, stay definitions.\n const recursive = new Set<string>();\n const findCycles = (value: unknown, stack: readonly string[]): void => {\n if (Array.isArray(value)) {\n for (const item of value) findCycles(item, stack);\n return;\n }\n if (!isRecord(value)) return;\n const node = respell(value);\n for (const child of schemaChildren(node)) findCycles(child, stack);\n const ref = node['$ref'];\n if (typeof ref !== 'string') return;\n const { key, node: next } = target(ref);\n if (stack.includes(key)) recursive.add(key);\n else findCycles(next, [...stack, key]);\n };\n findCycles(body, ['#']);\n\n const names = new Map<string, string>();\n const named: Record<string, unknown> = {};\n const nameOf = (key: string, node: unknown): string => {\n const known = names.get(key);\n if (known !== undefined) return known;\n const name = `d${names.size}`;\n names.set(key, name);\n named[name] = emit(node);\n return name;\n };\n const emit = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(emit);\n if (!isRecord(value)) return value;\n const node = respell(value);\n const rest: Record<string, unknown> = Object.fromEntries(\n Object.entries(node)\n .filter(([key]) => key !== '$ref')\n .sort(byKey)\n .map(([key, child]) => [key, NAMED.has(key) && isRecord(child) ? namedSchemas(child, emit) : DATA.has(key) ? child : emit(child)]),\n );\n const ref = node['$ref'];\n if (typeof ref !== 'string') return rest;\n const { key, node: next } = target(ref);\n const referred = recursive.has(key) ? { $ref: `#/$defs/${nameOf(key, next)}` } : emit(next);\n return Object.keys(rest).length > 0 ? { ...rest, allOf: [referred] } : referred;\n };\n\n const root = recursive.has('#') ? { $ref: `#/$defs/${nameOf('#', body)}` } : emit(body);\n return Object.keys(named).length === 0 ? root : sortKeys({ ...(isRecord(root) ? root : { allOf: [root] }), $defs: named });\n};\n\nexport type SnapshotComparison =\n | { status: 'same' }\n | { status: 'missing' }\n | { status: 'changed'; changes: readonly { kind: string; lines: readonly string[] }[] };\n\n// `recorded` is the snapshot kept for the grammar's CURRENT version (or\n// undefined if none was kept). Changed means: a migration is owed. Both sides\n// are read in canonical form, so a validator's respelling is not a change.\nexport const compareSnapshot = (recorded: Snapshot | undefined, current: Snapshot): SnapshotComparison => {\n if (recorded === undefined) return { status: 'missing' };\n const changes: { kind: string; lines: string[] }[] = [];\n for (const kind of [...new Set([...Object.keys(recorded.kinds), ...Object.keys(current.kinds)])].sort()) {\n const lines: string[] = [];\n if (!(kind in recorded.kinds)) lines.push('+ (a new kind)');\n else if (!(kind in current.kinds)) lines.push('- (the kind is gone)');\n else diffLines(canonical(recorded.kinds[kind]), canonical(current.kinds[kind]), '', lines, 12);\n if (lines.length > 0) changes.push({ kind, lines });\n }\n return changes.length === 0 ? { status: 'same' } : { status: 'changed', changes };\n};\n\n// ── the corpus ──────────────────────────────────────────────────\n\nexport type CorpusDocument = { id: string; kind: string; stamp: Stamp; document: unknown };\nexport type CorpusFailure = { id: string; kind: string; reason: string };\nexport type CorpusReport = { passed: number; failures: readonly CorpusFailure[] };\n\nconst issueText = (issue: Issue): string => {\n const path = (issue.path ?? []).map((p) => (typeof p === 'object' ? String(p.key) : String(p))).join('.');\n return `${path === '' ? '' : `${path}: `}${issue.message}`;\n};\n\n// What differs between two JSON values, as short lines (`+ a.b`, `- c`,\n// `~ d: 1 → 2`) — for a report a person or an agent acts on.\nexport const diffJson = (a: unknown, b: unknown, limit = 20): string[] => {\n const out: string[] = [];\n diffLines(a, b, '', out, limit, sortKeys, false);\n return out;\n};\n\n// Every document, upgraded from its stamp, must pass the current schema of its kind.\nexport const checkCorpus = async (\n upgrader: Upgrader,\n schemas: Readonly<Record<string, GrammarSchema>>,\n documents: readonly CorpusDocument[],\n): Promise<CorpusReport> => {\n const failures: CorpusFailure[] = [];\n let passed = 0;\n for (const doc of documents) {\n const schema = schemas[doc.kind];\n if (schema === undefined) {\n failures.push({ id: doc.id, kind: doc.kind, reason: `no schema for ${doc.kind}` });\n continue;\n }\n let upgraded: unknown;\n try {\n upgraded = upgrader.upgrade(doc.document, { kind: doc.kind, stamp: doc.stamp }).document;\n } catch (error) {\n failures.push({ id: doc.id, kind: doc.kind, reason: error instanceof Error ? error.message.split('\\n')[0] ?? error.message : String(error) });\n continue;\n }\n const result = await schema['~standard'].validate(upgraded);\n if (result.issues !== undefined) {\n failures.push({ id: doc.id, kind: doc.kind, reason: result.issues.slice(0, 3).map(issueText).join('; ') });\n } else {\n passed += 1;\n }\n }\n return { passed, failures };\n};\n"]}