@niscorp/strata 0.1.6 → 0.1.8

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 (56) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/DESIGN.md +11 -5
  3. package/README.md +56 -14
  4. package/dist/check/index.cjs +7 -7
  5. package/dist/check/index.js +2 -2
  6. package/dist/{chunk-IHYBGLNW.cjs → chunk-564JCO6Q.cjs} +8 -8
  7. package/dist/chunk-564JCO6Q.cjs.map +1 -0
  8. package/dist/{chunk-ATHZ7HT5.cjs → chunk-7PBIGCLL.cjs} +2 -2
  9. package/dist/chunk-7PBIGCLL.cjs.map +1 -0
  10. package/dist/{chunk-WU3OJHVZ.js → chunk-DGS4XJQQ.js} +4 -4
  11. package/dist/chunk-DGS4XJQQ.js.map +1 -0
  12. package/dist/{chunk-OLDORFOQ.js → chunk-FNMGVPSA.js} +4 -4
  13. package/dist/chunk-FNMGVPSA.js.map +1 -0
  14. package/dist/{chunk-YXFEJJMC.cjs → chunk-FSEUYRLN.cjs} +15 -15
  15. package/dist/chunk-FSEUYRLN.cjs.map +1 -0
  16. package/dist/{chunk-CL5DF2IQ.cjs → chunk-KYNER7UU.cjs} +18 -7
  17. package/dist/chunk-KYNER7UU.cjs.map +1 -0
  18. package/dist/{chunk-5KTXEN43.js → chunk-PAMQMFBK.js} +15 -4
  19. package/dist/chunk-PAMQMFBK.js.map +1 -0
  20. package/dist/{chunk-4BLHBVSC.js → chunk-SH6BBA2X.js} +3 -3
  21. package/dist/chunk-SH6BBA2X.js.map +1 -0
  22. package/dist/{chunk-AKKWEXO2.js → chunk-STNFHBNR.js} +2 -2
  23. package/dist/chunk-STNFHBNR.js.map +1 -0
  24. package/dist/{chunk-KNBS3AJZ.cjs → chunk-SYU7NKZR.cjs} +4 -4
  25. package/dist/chunk-SYU7NKZR.cjs.map +1 -0
  26. package/dist/index.cjs +21 -21
  27. package/dist/index.cjs.map +1 -1
  28. package/dist/index.d.cts +1 -1
  29. package/dist/index.d.ts +1 -1
  30. package/dist/index.js +3 -3
  31. package/dist/index.js.map +1 -1
  32. package/dist/node/index.cjs +11 -11
  33. package/dist/node/index.cjs.map +1 -1
  34. package/dist/node/index.js +5 -5
  35. package/dist/node/index.js.map +1 -1
  36. package/dist/{plan-mFmdh0qT.d.ts → plan-BMZJUCZ1.d.ts} +6 -3
  37. package/dist/{plan-CxuteSH1.d.cts → plan-Bq_Q2x5r.d.cts} +6 -3
  38. package/dist/postgres/index.cjs +36 -23
  39. package/dist/postgres/index.cjs.map +1 -1
  40. package/dist/postgres/index.d.cts +7 -3
  41. package/dist/postgres/index.d.ts +7 -3
  42. package/dist/postgres/index.js +25 -12
  43. package/dist/postgres/index.js.map +1 -1
  44. package/dist/upgrade/index.cjs +7 -7
  45. package/dist/upgrade/index.js +3 -3
  46. package/package.json +1 -1
  47. package/dist/chunk-4BLHBVSC.js.map +0 -1
  48. package/dist/chunk-5KTXEN43.js.map +0 -1
  49. package/dist/chunk-AKKWEXO2.js.map +0 -1
  50. package/dist/chunk-ATHZ7HT5.cjs.map +0 -1
  51. package/dist/chunk-CL5DF2IQ.cjs.map +0 -1
  52. package/dist/chunk-IHYBGLNW.cjs.map +0 -1
  53. package/dist/chunk-KNBS3AJZ.cjs.map +0 -1
  54. package/dist/chunk-OLDORFOQ.js.map +0 -1
  55. package/dist/chunk-WU3OJHVZ.js.map +0 -1
  56. package/dist/chunk-YXFEJJMC.cjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/postgres/index.ts"],"names":["StrataError","planMigrations","prepare","refuseProblems"],"mappings":"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","file":"index.cjs","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
+ {"version":3,"sources":["../../src/postgres/index.ts"],"names":["StrataError","planMigrations","prepare","refuseProblems"],"mappings":"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","file":"index.cjs","sourcesContent":["import { prepare, planMigrations, refuseProblems, type LedgerRow, type Plan, type PlanOptions, type PreparedMigration, type PreparedSequence } from '../plan';\nimport type { Sequence } from '../schema';\nimport type { UpgradeResult, Upgrader } from '../documents';\nimport { StrataError } from '../errors';\n\n// `query` and `transaction` are called on the object that has them, never taken\n// off it first: a driver's own object (a PGlite, a `pg` client) has them as\n// methods that reach for `this`.\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 table?: string;\n schema?: string;\n};\n\nexport type MigrateGuard = (tx: { query: StrataQuery }, run: { applied: readonly PreparedMigration[] }) => Promise<readonly string[]>;\n\nexport type MigrateOptions = LedgerOptions &\n PlanOptions & {\n mode?: 'apply' | 'verify';\n guard?: MigrateGuard;\n dryRun?: boolean;\n lockTimeoutMs?: number;\n statementTimeoutMs?: number;\n };\n\nconst LOCK_TIMEOUT_MS = 10_000;\nconst STATEMENT_TIMEOUT_MS = 3_600_000;\n\nexport type MigrateReport = {\n applied: readonly PreparedMigration[];\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\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\nexport const status = async (pool: StrataPool, sequences: readonly Sequence[], options: LedgerOptions & PlanOptions = {}): Promise<Plan> =>\n planMigrations(await prepare(sequences), await readLedger(pool, options), 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\nconst refusePending = (plan: Plan): void => {\n if (plan.pending.length === 0) return;\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\nexport const migrate = async (pool: StrataPool, sequences: readonly Sequence[], options: MigrateOptions = {}): Promise<MigrateReport> => {\n const prepared = await prepare(sequences);\n refuseGrammars(prepared);\n // Read before anything is locked or created: on a database that is up to\n // date a run is a read, which a role without DDL rights can make.\n const read = planMigrations(prepared, await readLedger(pool, options), options);\n refuseProblems(read);\n if (options.mode === 'verify') {\n refusePending(read);\n return { applied: [], plan: read };\n }\n if (read.pending.length === 0 && options.guard === undefined && options.dryRun !== true) return { applied: [], plan: read };\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, which is what rolls a transaction back in\n // every pool. 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 wait for another run is bounded by the statement timeout alone: a\n // lock timeout, the pool's or the run's own, would cut it short.\n await tx.query(\"SELECT set_config('statement_timeout', $1, true)\", [`${options.statementTimeoutMs ?? STATEMENT_TIMEOUT_MS}ms`]);\n await tx.query(\"SELECT set_config('lock_timeout', '0', true)\");\n // The lock before the ledger's DDL: two processes creating the ledger at\n // once would race in the catalog before either reached a row.\n await tx.query('SELECT pg_advisory_xact_lock(hashtext($1))', [`strata:${qualified}`]);\n await tx.query(\"SELECT set_config('lock_timeout', $1, true)\", [`${options.lockTimeoutMs ?? LOCK_TIMEOUT_MS}ms`]);\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), options);\n refuseProblems(plan);\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, { applied });\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\nexport type DocumentStore = {\n table: string;\n schema?: string;\n column: string;\n stamp: string;\n kind: string;\n key: readonly string[];\n};\n\nexport type StoreReport = {\n total: number;\n upgraded: number;\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,4 +1,4 @@
1
- import { a as PreparedMigration, P as Plan, L as LedgerRow } from '../plan-CxuteSH1.cjs';
1
+ import { b as PreparedMigration, a as PlanOptions, P as Plan, L as LedgerRow } from '../plan-Bq_Q2x5r.cjs';
2
2
  import { a as Sequence, n as Upgrader } from '../documents-BjlM94Ea.cjs';
3
3
  import 'zod';
4
4
 
@@ -17,11 +17,15 @@ type LedgerOptions = {
17
17
  };
18
18
  type MigrateGuard = (tx: {
19
19
  query: StrataQuery;
20
+ }, run: {
21
+ applied: readonly PreparedMigration[];
20
22
  }) => Promise<readonly string[]>;
21
- type MigrateOptions = LedgerOptions & {
23
+ type MigrateOptions = LedgerOptions & PlanOptions & {
22
24
  mode?: 'apply' | 'verify';
23
25
  guard?: MigrateGuard;
24
26
  dryRun?: boolean;
27
+ lockTimeoutMs?: number;
28
+ statementTimeoutMs?: number;
25
29
  };
26
30
  type MigrateReport = {
27
31
  applied: readonly PreparedMigration[];
@@ -29,7 +33,7 @@ type MigrateReport = {
29
33
  };
30
34
  declare const ledgerDdl: (options?: LedgerOptions) => string;
31
35
  declare const readLedger: (pool: StrataPool, options?: LedgerOptions) => Promise<LedgerRow[]>;
32
- declare const status: (pool: StrataPool, sequences: readonly Sequence[], options?: LedgerOptions) => Promise<Plan>;
36
+ declare const status: (pool: StrataPool, sequences: readonly Sequence[], options?: LedgerOptions & PlanOptions) => Promise<Plan>;
33
37
  declare const migrate: (pool: StrataPool, sequences: readonly Sequence[], options?: MigrateOptions) => Promise<MigrateReport>;
34
38
  type DocumentStore = {
35
39
  table: string;
@@ -1,4 +1,4 @@
1
- import { a as PreparedMigration, P as Plan, L as LedgerRow } from '../plan-mFmdh0qT.js';
1
+ import { b as PreparedMigration, a as PlanOptions, P as Plan, L as LedgerRow } from '../plan-BMZJUCZ1.js';
2
2
  import { a as Sequence, n as Upgrader } from '../documents-BjlM94Ea.js';
3
3
  import 'zod';
4
4
 
@@ -17,11 +17,15 @@ type LedgerOptions = {
17
17
  };
18
18
  type MigrateGuard = (tx: {
19
19
  query: StrataQuery;
20
+ }, run: {
21
+ applied: readonly PreparedMigration[];
20
22
  }) => Promise<readonly string[]>;
21
- type MigrateOptions = LedgerOptions & {
23
+ type MigrateOptions = LedgerOptions & PlanOptions & {
22
24
  mode?: 'apply' | 'verify';
23
25
  guard?: MigrateGuard;
24
26
  dryRun?: boolean;
27
+ lockTimeoutMs?: number;
28
+ statementTimeoutMs?: number;
25
29
  };
26
30
  type MigrateReport = {
27
31
  applied: readonly PreparedMigration[];
@@ -29,7 +33,7 @@ type MigrateReport = {
29
33
  };
30
34
  declare const ledgerDdl: (options?: LedgerOptions) => string;
31
35
  declare const readLedger: (pool: StrataPool, options?: LedgerOptions) => Promise<LedgerRow[]>;
32
- declare const status: (pool: StrataPool, sequences: readonly Sequence[], options?: LedgerOptions) => Promise<Plan>;
36
+ declare const status: (pool: StrataPool, sequences: readonly Sequence[], options?: LedgerOptions & PlanOptions) => Promise<Plan>;
33
37
  declare const migrate: (pool: StrataPool, sequences: readonly Sequence[], options?: MigrateOptions) => Promise<MigrateReport>;
34
38
  type DocumentStore = {
35
39
  table: string;
@@ -1,7 +1,9 @@
1
- import { planMigrations, prepare, refuseProblems } from '../chunk-5KTXEN43.js';
2
- import { StrataError } from '../chunk-AKKWEXO2.js';
1
+ import { planMigrations, prepare, refuseProblems } from '../chunk-PAMQMFBK.js';
2
+ import { StrataError } from '../chunk-STNFHBNR.js';
3
3
 
4
4
  // src/postgres/index.ts
5
+ var LOCK_TIMEOUT_MS = 1e4;
6
+ var STATEMENT_TIMEOUT_MS = 36e5;
5
7
  var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
6
8
  var quote = (name, label) => {
7
9
  if (!IDENT.test(name)) throw new StrataError("INVALID_SEQUENCE", `The ledger ${label} "${name}" is not a plain identifier.`);
@@ -40,7 +42,7 @@ var readLedger = async (pool, options = {}) => {
40
42
  if (rows[0]?.["present"] !== true) return [];
41
43
  return readRows(pool, qualified);
42
44
  };
43
- var status = async (pool, sequences, options = {}) => planMigrations(await prepare(sequences), await readLedger(pool, options));
45
+ var status = async (pool, sequences, options = {}) => planMigrations(await prepare(sequences), await readLedger(pool, options), options);
44
46
  var refuseGrammars = (prepared) => {
45
47
  const grammars = prepared.filter((s) => s.grammar);
46
48
  if (grammars.length > 0) {
@@ -51,9 +53,24 @@ var refuseGrammars = (prepared) => {
51
53
  );
52
54
  }
53
55
  };
56
+ var refusePending = (plan) => {
57
+ if (plan.pending.length === 0) return;
58
+ throw new StrataError(
59
+ "PENDING",
60
+ `${plan.pending.length} migration${plan.pending.length === 1 ? " is" : "s are"} not applied, and this boot only verifies. Run the migrations first.`,
61
+ plan.pending.map((m) => `${m.ref} ${m.description}`)
62
+ );
63
+ };
54
64
  var migrate = async (pool, sequences, options = {}) => {
55
65
  const prepared = await prepare(sequences);
56
66
  refuseGrammars(prepared);
67
+ const read = planMigrations(prepared, await readLedger(pool, options), options);
68
+ refuseProblems(read);
69
+ if (options.mode === "verify") {
70
+ refusePending(read);
71
+ return { applied: [], plan: read };
72
+ }
73
+ if (read.pending.length === 0 && options.guard === void 0 && options.dryRun !== true) return { applied: [], plan: read };
57
74
  if (pool.transaction === void 0) {
58
75
  throw new StrataError(
59
76
  "NO_TRANSACTION",
@@ -64,18 +81,14 @@ var migrate = async (pool, sequences, options = {}) => {
64
81
  const dryRunEnd = new Error("strata: dry run");
65
82
  let dryRunReport;
66
83
  const run = pool.transaction(async (tx) => {
84
+ await tx.query("SELECT set_config('statement_timeout', $1, true)", [`${options.statementTimeoutMs ?? STATEMENT_TIMEOUT_MS}ms`]);
85
+ await tx.query("SELECT set_config('lock_timeout', '0', true)");
67
86
  await tx.query("SELECT pg_advisory_xact_lock(hashtext($1))", [`strata:${qualified}`]);
87
+ await tx.query("SELECT set_config('lock_timeout', $1, true)", [`${options.lockTimeoutMs ?? LOCK_TIMEOUT_MS}ms`]);
68
88
  if (schema !== void 0) await tx.query(`CREATE SCHEMA IF NOT EXISTS ${schema}`);
69
89
  await tx.query(ledgerDdl(options));
70
- const plan = planMigrations(prepared, await readRows(tx, qualified));
90
+ const plan = planMigrations(prepared, await readRows(tx, qualified), options);
71
91
  refuseProblems(plan);
72
- if (options.mode === "verify" && plan.pending.length > 0) {
73
- throw new StrataError(
74
- "PENDING",
75
- `${plan.pending.length} migration${plan.pending.length === 1 ? " is" : "s are"} not applied, and this boot only verifies. Run the migrations first.`,
76
- plan.pending.map((m) => `${m.ref} ${m.description}`)
77
- );
78
- }
79
92
  const applied = [];
80
93
  for (const migration of plan.pending) {
81
94
  for (const [index, step] of migration.steps.entries()) {
@@ -99,7 +112,7 @@ var migrate = async (pool, sequences, options = {}) => {
99
112
  ]);
100
113
  applied.push(migration);
101
114
  }
102
- const reasons = options.guard === void 0 ? [] : await options.guard(tx);
115
+ const reasons = options.guard === void 0 ? [] : await options.guard(tx, { applied });
103
116
  if (reasons.length > 0) {
104
117
  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);
105
118
  }
@@ -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.\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
+ {"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 PlanOptions, type PreparedMigration, type PreparedSequence } from '../plan';\nimport type { Sequence } from '../schema';\nimport type { UpgradeResult, Upgrader } from '../documents';\nimport { StrataError } from '../errors';\n\n// `query` and `transaction` are called on the object that has them, never taken\n// off it first: a driver's own object (a PGlite, a `pg` client) has them as\n// methods that reach for `this`.\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 table?: string;\n schema?: string;\n};\n\nexport type MigrateGuard = (tx: { query: StrataQuery }, run: { applied: readonly PreparedMigration[] }) => Promise<readonly string[]>;\n\nexport type MigrateOptions = LedgerOptions &\n PlanOptions & {\n mode?: 'apply' | 'verify';\n guard?: MigrateGuard;\n dryRun?: boolean;\n lockTimeoutMs?: number;\n statementTimeoutMs?: number;\n };\n\nconst LOCK_TIMEOUT_MS = 10_000;\nconst STATEMENT_TIMEOUT_MS = 3_600_000;\n\nexport type MigrateReport = {\n applied: readonly PreparedMigration[];\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\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\nexport const status = async (pool: StrataPool, sequences: readonly Sequence[], options: LedgerOptions & PlanOptions = {}): Promise<Plan> =>\n planMigrations(await prepare(sequences), await readLedger(pool, options), 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\nconst refusePending = (plan: Plan): void => {\n if (plan.pending.length === 0) return;\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\nexport const migrate = async (pool: StrataPool, sequences: readonly Sequence[], options: MigrateOptions = {}): Promise<MigrateReport> => {\n const prepared = await prepare(sequences);\n refuseGrammars(prepared);\n // Read before anything is locked or created: on a database that is up to\n // date a run is a read, which a role without DDL rights can make.\n const read = planMigrations(prepared, await readLedger(pool, options), options);\n refuseProblems(read);\n if (options.mode === 'verify') {\n refusePending(read);\n return { applied: [], plan: read };\n }\n if (read.pending.length === 0 && options.guard === undefined && options.dryRun !== true) return { applied: [], plan: read };\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, which is what rolls a transaction back in\n // every pool. 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 wait for another run is bounded by the statement timeout alone: a\n // lock timeout, the pool's or the run's own, would cut it short.\n await tx.query(\"SELECT set_config('statement_timeout', $1, true)\", [`${options.statementTimeoutMs ?? STATEMENT_TIMEOUT_MS}ms`]);\n await tx.query(\"SELECT set_config('lock_timeout', '0', true)\");\n // The lock before the ledger's DDL: two processes creating the ledger at\n // once would race in the catalog before either reached a row.\n await tx.query('SELECT pg_advisory_xact_lock(hashtext($1))', [`strata:${qualified}`]);\n await tx.query(\"SELECT set_config('lock_timeout', $1, true)\", [`${options.lockTimeoutMs ?? LOCK_TIMEOUT_MS}ms`]);\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), options);\n refuseProblems(plan);\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, { applied });\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\nexport type DocumentStore = {\n table: string;\n schema?: string;\n column: string;\n stamp: string;\n kind: string;\n key: readonly string[];\n};\n\nexport type StoreReport = {\n total: number;\n upgraded: number;\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,26 +1,26 @@
1
1
  'use strict';
2
2
 
3
- var chunkIHYBGLNW_cjs = require('../chunk-IHYBGLNW.cjs');
4
- require('../chunk-KNBS3AJZ.cjs');
5
- require('../chunk-ATHZ7HT5.cjs');
3
+ var chunk564JCO6Q_cjs = require('../chunk-564JCO6Q.cjs');
4
+ require('../chunk-SYU7NKZR.cjs');
5
+ require('../chunk-7PBIGCLL.cjs');
6
6
 
7
7
 
8
8
 
9
9
  Object.defineProperty(exports, "changedStrings", {
10
10
  enumerable: true,
11
- get: function () { return chunkIHYBGLNW_cjs.changedStrings; }
11
+ get: function () { return chunk564JCO6Q_cjs.changedStrings; }
12
12
  });
13
13
  Object.defineProperty(exports, "planSourceUpgrade", {
14
14
  enumerable: true,
15
- get: function () { return chunkIHYBGLNW_cjs.planSourceUpgrade; }
15
+ get: function () { return chunk564JCO6Q_cjs.planSourceUpgrade; }
16
16
  });
17
17
  Object.defineProperty(exports, "renderReport", {
18
18
  enumerable: true,
19
- get: function () { return chunkIHYBGLNW_cjs.renderReport; }
19
+ get: function () { return chunk564JCO6Q_cjs.renderReport; }
20
20
  });
21
21
  Object.defineProperty(exports, "verifySourceUpgrade", {
22
22
  enumerable: true,
23
- get: function () { return chunkIHYBGLNW_cjs.verifySourceUpgrade; }
23
+ get: function () { return chunk564JCO6Q_cjs.verifySourceUpgrade; }
24
24
  });
25
25
  //# sourceMappingURL=index.cjs.map
26
26
  //# sourceMappingURL=index.cjs.map
@@ -1,5 +1,5 @@
1
- export { changedStrings, planSourceUpgrade, renderReport, verifySourceUpgrade } from '../chunk-WU3OJHVZ.js';
2
- import '../chunk-4BLHBVSC.js';
3
- import '../chunk-AKKWEXO2.js';
1
+ export { changedStrings, planSourceUpgrade, renderReport, verifySourceUpgrade } from '../chunk-DGS4XJQQ.js';
2
+ import '../chunk-SH6BBA2X.js';
3
+ import '../chunk-STNFHBNR.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.6",
3
+ "version": "0.1.8",
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": {
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/check/index.ts"],"names":["key"],"mappings":"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","file":"chunk-4BLHBVSC.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`) — all but a tuple's `prefixItems`,\n// see `diffPositions`; a document's arrays by position — `layout.children[1]` is\n// 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 const before = a[key];\n const after = b[key];\n if (!(key in a)) out.push(`+ ${at}`);\n else if (!(key in b)) out.push(`- ${at}`);\n else if (sets && key === 'prefixItems' && Array.isArray(before) && Array.isArray(after)) diffPositions(before, after, at, out, limit, canon);\n else diffLines(before, after, 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// A tuple's `prefixItems` is the one schema array that is a SEQUENCE: position\n// is the grammar, so [string, number] and [number, string] are different tuples\n// and a document valid for one is not for the other. Compared place by place;\n// what sits IN a place is a schema again, its own arrays sets as ever.\nconst diffPositions = (a: readonly unknown[], b: readonly unknown[], path: string, out: string[], limit: number, canon: (v: unknown) => unknown): void => {\n for (let i = 0; i < Math.max(a.length, b.length); i += 1) {\n if (out.length >= limit) return;\n if (i >= a.length) out.push(`+ ${path}[${i}]`);\n else if (i >= b.length) out.push(`- ${path}[${i}]`);\n else diffLines(a[i], b[i], `${path}[${i}]`, out, limit, canon, true);\n }\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"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/schema.ts","../src/checksum.ts","../src/plan.ts"],"names":[],"mappings":"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","file":"chunk-5KTXEN43.js","sourcesContent":["import { z } from 'zod';\n\n// ═══════════════════════════════════════════════════════════════\n// The grammar of a migration.\n//\n// A SEQUENCE is an append-only list of migrations owned by one grammar owner —\n// a package's tables (`nisc.vex.cache`), a package's documents (`nisc.nova`,\n// later), an app's own (`midas.app`). A migration's number is its POSITION, so\n// the sequence's version is its length: nobody bumps a number, you append.\n//\n// Sequences are data. They are authored in TS for type-checking, but nothing\n// here is a function, so a sequence can be stored, shipped and inspected like\n// every other nisc artifact — and is parsed at the boundary like one.\n// ═══════════════════════════════════════════════════════════════\n\n// Namespaced, lowercase: `<owner>.<name>[.<name>…]`. The owner prefix keeps two\n// packages (or a package and an app) from ever claiming the same sequence.\nexport const SEQUENCE_ID = /^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$/;\n\n// `<sequence>/<n>` — how a migration is named everywhere: the ledger, a\n// dependency, an error.\nexport const MIGRATION_REF = /^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+\\/[1-9][0-9]*$/;\n\n// A document kind, named by its owner: `<sequence>/<kind>`, e.g.\n// \"nisc.nova/layout\". The kind part is a plain lowercase word.\nexport const KIND_NAME = /^[a-z][a-z0-9-]*$/;\nexport const KIND_REF = /^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+\\/[a-z][a-z0-9-]*$/;\n\n// Where, inside a document, another document sits. Dot-separated keys, with\n// two wildcards that say WHICH shape they cross — `children[]` is every item of\n// the array at `children`, `endpoints.*` every value of the record at\n// `endpoints`. Kept apart on purpose: nova's `children` is a single node OR an\n// array, and one wildcard for both would read a lone node's `props` as layouts.\nexport const EMBED_PATH = /^([A-Za-z_$][\\w$]*|\\*)(\\[\\])?(\\.([A-Za-z_$][\\w$]*|\\*)(\\[\\])?)*$/;\n\nexport const SqlStepSchema = z\n .object({\n kind: z.literal('sql'),\n sql: z\n .string()\n .min(1)\n .describe(\n 'ONE SQL statement. A driver that prepares statements (PGlite, pg with parameters) refuses a string ' +\n 'carrying several — split them into steps rather than joining them with semicolons.',\n ),\n })\n .strict()\n .describe('A statement run against the database, inside the migration transaction.');\n\nexport const DocumentStepSchema = z\n .object({\n kind: z.literal('document'),\n at: z\n .string()\n .regex(KIND_REF)\n .describe('The kind of document this step rewrites, e.g. \"nisc.nova/layout\" — wherever one sits, at any depth.'),\n transform: z\n .unknown()\n .describe(\n 'A transform config (Prism) run by the injected evaluator over { document, path }: `document` is ONE document of ' +\n 'the `at` kind, `path` where it sits. It returns that document rewritten. Nested documents are found by the ' +\n 'grammar\\'s embeddings and rewritten on their own, deepest first — a transform only ever sees one flat node.',\n ),\n })\n .strict()\n .describe('A rewrite of stored JSON documents of one kind.');\n\nexport const StepSchema = z.discriminatedUnion('kind', [SqlStepSchema, DocumentStepSchema]);\n\nexport const DocumentKindSchema = z\n .object({\n embeds: z\n .record(z.string().regex(EMBED_PATH), z.string().regex(KIND_REF))\n .optional()\n .describe('Where other documents sit inside this one: path → the kind found there (possibly this kind itself).'),\n })\n .strict();\n\nexport const MigrationSchema = z\n .object({\n description: z\n .string()\n .min(1)\n .describe('One sentence: what this migration does. It is the changelog line and the ledger\\'s description.'),\n steps: z\n .array(StepSchema)\n .describe(\n 'Applied in order, in the same transaction as every other pending migration. Empty is a MARKER: ' +\n 'the version moves and nothing runs — how an addition to a strict grammar tells older readers to refuse.',\n ),\n dependsOn: z\n .array(z.string().regex(MIGRATION_REF))\n .optional()\n .describe('Migrations of OTHER sequences that must be applied first, each as \"<sequence>/<n>\".'),\n })\n .strict();\n\nexport const SequenceSchema = z\n .object({\n id: z.string().regex(SEQUENCE_ID).describe('Namespaced and lowercase, e.g. \"nisc.vex.cache\" or \"midas.app\".'),\n documents: z\n .record(z.string().regex(KIND_NAME), DocumentKindSchema)\n .optional()\n .describe('The document kinds this sequence owns (a GRAMMAR sequence), each named \"<id>/<kind>\" elsewhere.'),\n migrations: z\n .array(MigrationSchema)\n .describe('Append-only. A migration is numbered by its position (from 1); the sequence\\'s version is its length.'),\n })\n .strict()\n // TWO KINDS OF OWNER. A table sequence (sql steps) is recorded per DATABASE,\n // in its ledger. A grammar sequence (document steps) is tracked per DOCUMENT,\n // by the stamp the document carries — because documents travel: an add-on\n // built on older code submits older documents to a newer host. One sequence\n // cannot be both; the two versions would mean different things.\n .superRefine((sequence, ctx) => {\n const kinds = new Set(sequence.migrations.flatMap((m) => m.steps.map((s) => s.kind)));\n if (kinds.has('sql') && (kinds.has('document') || sequence.documents !== undefined)) {\n ctx.addIssue({\n code: 'custom',\n message: 'A sequence either owns tables (sql steps) or documents (document steps and `documents`), not both.',\n });\n }\n });\n\nexport type SqlStep = z.infer<typeof SqlStepSchema>;\nexport type DocumentStep = z.infer<typeof DocumentStepSchema>;\nexport type DocumentKind = z.infer<typeof DocumentKindSchema>;\nexport type Step = z.infer<typeof StepSchema>;\nexport type Migration = z.infer<typeof MigrationSchema>;\nexport type Sequence = z.infer<typeof SequenceSchema>;\n","import type { Migration } from './schema';\n\n// ═══════════════════════════════════════════════════════════════\n// What a migration DID, as a hash — the ledger's proof that the code still says\n// what the database ran.\n//\n// Over the steps only. The description is prose: fixing a typo in it must not\n// read as an edited migration. `dependsOn` orders, it does not act. The steps\n// are the effect, and changing an applied step is the one thing that has to\n// be refused — the database already holds the old effect.\n//\n// For the same reason a step's SQL is hashed without its full-line comments\n// (`-- …` on a line of its own) and without trailing whitespace: a migration\n// can carry its documentation verbatim, and rewording it is not an edit.\n//\n// WebCrypto (SHA-256), which Node ≥ 22 and every browser carry as\n// `crypto.subtle` — the same primitive Prism fingerprints with, so strata runs\n// unchanged in a server, a test and the showroom page.\n// ═══════════════════════════════════════════════════════════════\n\n// Sorted keys, recursively: the same value always serializes the same way,\n// whatever order its object literal was written in.\nconst canonical = (value: unknown): string => {\n if (Array.isArray(value)) return `[${value.map(canonical).join(',')}]`;\n if (value !== null && typeof value === 'object') {\n const entries = Object.entries(value)\n .filter(([, v]) => v !== undefined)\n .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`).join(',')}}`;\n }\n return JSON.stringify(value);\n};\n\nconst effectOf = (sql: string): string =>\n sql\n .split('\\n')\n .filter((line) => !line.trimStart().startsWith('--'))\n .map((line) => line.trimEnd())\n .join('\\n')\n .trim();\n\nexport const checksumOf = async (migration: Migration): Promise<string> => {\n const steps = migration.steps.map((step) => (step.kind === 'sql' ? { ...step, sql: effectOf(step.sql) } : step));\n const bytes = new TextEncoder().encode(canonical(steps));\n const digest = await crypto.subtle.digest('SHA-256', bytes);\n return Array.from(new Uint8Array(digest), (b) => b.toString(16).padStart(2, '0')).join('');\n};\n","import { SequenceSchema, type DocumentKind, type Sequence, type Step } from './schema';\nimport { checksumOf } from './checksum';\nimport { StrataError, type StrataErrorCode } from './errors';\n\n// ═══════════════════════════════════════════════════════════════\n// The plan — what the code says, against what the database has run.\n//\n// Pure: sequences and ledger rows in, a plan out. No database, no clock. The\n// postgres runner reads the ledger, calls this, and applies what it says; a\n// showroom page or a CI check can call it with a ledger it made up.\n// ═══════════════════════════════════════════════════════════════\n\n// A migration the code declares, numbered and hashed.\nexport type PreparedMigration = {\n sequence: string;\n n: number;\n ref: string;\n description: string;\n checksum: string;\n steps: readonly Step[];\n dependsOn: readonly string[];\n};\n\nexport type PreparedSequence = {\n id: string;\n // A grammar sequence owns documents (tracked by stamps); otherwise it owns\n // tables (tracked by a database's ledger). See SequenceSchema.\n grammar: boolean;\n documents: Readonly<Record<string, DocumentKind>>;\n migrations: readonly PreparedMigration[];\n};\n\n// One row of the ledger, as a runner read it back.\nexport type LedgerRow = { sequence: string; n: number; checksum: string; description: string; appliedAt: string };\n\nexport type Problem = { code: Exclude<StrataErrorCode, 'PENDING' | 'STEP_FAILED' | 'DOES_NOT_FIT' | 'NO_TRANSACTION' | 'UNKNOWN_KIND' | 'WRONG_OWNER'>; detail: string };\n\nexport type Plan = {\n // Already run, per sequence this code knows: how far each one is.\n applied: Readonly<Record<string, number>>;\n // To run, in the order they must run.\n pending: readonly PreparedMigration[];\n // Anything that makes applying unsafe. A plan with problems is never applied.\n problems: readonly Problem[];\n};\n\nconst refOf = (sequence: string, n: number): string => `${sequence}/${n}`;\n\n// Parse, number and hash. Async only for the hash (WebCrypto).\nexport const prepare = async (sequences: readonly Sequence[]): Promise<readonly PreparedSequence[]> => {\n const seen = new Set<string>();\n const prepared: PreparedSequence[] = [];\n for (const input of sequences) {\n const parsed = SequenceSchema.safeParse(input);\n if (!parsed.success) {\n const issues = parsed.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`);\n throw new StrataError('INVALID_SEQUENCE', `A sequence does not parse${typeof input.id === 'string' ? ` (\"${input.id}\")` : ''}.`, issues);\n }\n const sequence = parsed.data;\n if (seen.has(sequence.id)) {\n throw new StrataError('INVALID_SEQUENCE', `Two sequences are both called \"${sequence.id}\" — a sequence id names one owner.`);\n }\n seen.add(sequence.id);\n const migrations: PreparedMigration[] = [];\n for (const [index, migration] of sequence.migrations.entries()) {\n const n = index + 1;\n migrations.push({\n sequence: sequence.id,\n n,\n ref: refOf(sequence.id, n),\n description: migration.description,\n checksum: await checksumOf(migration),\n steps: migration.steps,\n dependsOn: migration.dependsOn ?? [],\n });\n }\n const grammar = sequence.documents !== undefined || sequence.migrations.some((m) => m.steps.some((s) => s.kind === 'document'));\n prepared.push({ id: sequence.id, grammar, documents: sequence.documents ?? {}, migrations });\n }\n return prepared;\n};\n\n// Order: walk the sequences in the order given, and let each run as far as its\n// dependencies allow before moving on; repeat until nothing moves. The same\n// input always yields the same order, and a sequence's own migrations stay\n// together unless a dependency splits them. Shared by the ledger's plan and a\n// document's upgrade, so both order the same migrations the same way.\nexport const orderPending = (\n queues: readonly { waiting: readonly PreparedMigration[] }[],\n alreadyDone: ReadonlySet<string>,\n): { pending: PreparedMigration[]; stuck: PreparedMigration[] } => {\n const done = new Set(alreadyDone);\n const waiting = queues.map((q) => [...q.waiting]);\n const pending: PreparedMigration[] = [];\n let moved = true;\n while (moved) {\n moved = false;\n for (const queue of waiting) {\n for (let head = queue[0]; head !== undefined; head = queue[0]) {\n if (!head.dependsOn.every((d) => done.has(d))) break;\n pending.push(head);\n done.add(head.ref);\n queue.shift();\n moved = true;\n }\n }\n }\n return { pending, stuck: waiting.flat() };\n};\n\nexport const planMigrations = (sequences: readonly PreparedSequence[], ledger: readonly LedgerRow[]): Plan => {\n const problems: Problem[] = [];\n const applied: Record<string, number> = {};\n const done = new Set(ledger.map((row) => refOf(row.sequence, row.n)));\n const byRef = new Map(ledger.map((row) => [refOf(row.sequence, row.n), row]));\n\n const queues: { id: string; waiting: PreparedMigration[] }[] = [];\n for (const sequence of sequences) {\n const rows = ledger.filter((row) => row.sequence === sequence.id);\n applied[sequence.id] = rows.length;\n\n // The database ran migrations this code has never seen: newer code migrated\n // it. Applying ours on top would be guessing — refuse.\n const beyond = rows.filter((row) => row.n > sequence.migrations.length);\n if (beyond.length > 0) {\n problems.push({\n code: 'TOO_NEW',\n detail: `${sequence.id}: the database is at ${Math.max(...rows.map((r) => r.n))}, this code knows ${sequence.migrations.length} — it was migrated by newer code.`,\n });\n }\n\n const waiting: PreparedMigration[] = [];\n for (const migration of sequence.migrations) {\n const row = byRef.get(migration.ref);\n if (row === undefined) {\n waiting.push(migration);\n } else if (row.checksum !== migration.checksum) {\n problems.push({\n code: 'EDITED',\n detail: `${migration.ref} (\"${migration.description}\") was applied ${row.appliedAt} and its steps have changed since. An applied migration is history — append a new one.`,\n });\n }\n }\n // A hole: something later ran, something earlier did not. The ledger was\n // written by hand, or by a different ordering of the same sequence.\n const firstWaiting = waiting[0];\n if (firstWaiting !== undefined && rows.some((row) => row.n > firstWaiting.n)) {\n problems.push({ code: 'EDITED', detail: `${sequence.id}: ${firstWaiting.ref} never ran, but a later migration of the sequence did.` });\n }\n queues.push({ id: sequence.id, waiting });\n }\n\n // Every dependency must be satisfiable by the ledger or by this plan.\n const provided = new Set(sequences.flatMap((s) => s.migrations.map((m) => m.ref)));\n for (const { waiting } of queues) {\n for (const migration of waiting) {\n for (const dependency of migration.dependsOn) {\n if (!done.has(dependency) && !provided.has(dependency)) {\n problems.push({ code: 'UNKNOWN_DEPENDENCY', detail: `${migration.ref} depends on ${dependency}, which nothing provides and the database has not run.` });\n }\n }\n }\n }\n\n const { pending, stuck } = orderPending(queues, done);\n if (stuck.length > 0 && !problems.some((p) => p.code === 'UNKNOWN_DEPENDENCY')) {\n problems.push({ code: 'CYCLE', detail: `These wait on each other and can never run: ${stuck.map((m) => m.ref).join(', ')}.` });\n }\n\n return { applied, pending, problems };\n};\n\n// Throw the plan's problems as one error, named by the first.\nexport const refuseProblems = (plan: Plan): void => {\n const first = plan.problems[0];\n if (first === undefined) return;\n throw new StrataError(first.code, 'The migrations cannot be applied safely.', plan.problems.map((p) => `${p.code}: ${p.detail}`));\n};\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":";AA4BO,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","file":"chunk-AKKWEXO2.js","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 run's guard said the result does not fit; the whole run was rolled back.\n | 'DOES_NOT_FIT'\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"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":";;;AA4BO,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","file":"chunk-ATHZ7HT5.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 run's guard said the result does not fit; the whole run was rolled back.\n | 'DOES_NOT_FIT'\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"]}