@niscorp/strata 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/DESIGN.md +208 -0
  2. package/LICENSE +202 -0
  3. package/README.md +195 -0
  4. package/dist/check/index.cjs +223 -0
  5. package/dist/check/index.cjs.map +1 -0
  6. package/dist/check/index.d.cts +63 -0
  7. package/dist/check/index.d.ts +63 -0
  8. package/dist/check/index.js +4 -0
  9. package/dist/check/index.js.map +1 -0
  10. package/dist/chunk-EGFF63GA.js +16 -0
  11. package/dist/chunk-EGFF63GA.js.map +1 -0
  12. package/dist/chunk-HMT7HHFJ.js +156 -0
  13. package/dist/chunk-HMT7HHFJ.js.map +1 -0
  14. package/dist/chunk-ICWKTTKN.js +129 -0
  15. package/dist/chunk-ICWKTTKN.js.map +1 -0
  16. package/dist/chunk-MY3TGSV3.js +206 -0
  17. package/dist/chunk-MY3TGSV3.js.map +1 -0
  18. package/dist/chunk-U5CPF4LQ.js +175 -0
  19. package/dist/chunk-U5CPF4LQ.js.map +1 -0
  20. package/dist/documents-BjlM94Ea.d.cts +90 -0
  21. package/dist/documents-BjlM94Ea.d.ts +90 -0
  22. package/dist/index.cjs +370 -0
  23. package/dist/index.cjs.map +1 -0
  24. package/dist/index.d.cts +16 -0
  25. package/dist/index.d.ts +16 -0
  26. package/dist/index.js +42 -0
  27. package/dist/index.js.map +1 -0
  28. package/dist/node/index.cjs +629 -0
  29. package/dist/node/index.cjs.map +1 -0
  30. package/dist/node/index.d.cts +19 -0
  31. package/dist/node/index.d.ts +19 -0
  32. package/dist/node/index.js +164 -0
  33. package/dist/node/index.js.map +1 -0
  34. package/dist/plan-BAewc8DG.d.ts +53 -0
  35. package/dist/plan-BEIlXVUt.d.cts +53 -0
  36. package/dist/postgres/index.cjs +333 -0
  37. package/dist/postgres/index.cjs.map +1 -0
  38. package/dist/postgres/index.d.cts +44 -0
  39. package/dist/postgres/index.d.ts +44 -0
  40. package/dist/postgres/index.js +145 -0
  41. package/dist/postgres/index.js.map +1 -0
  42. package/dist/upgrade/index.cjs +236 -0
  43. package/dist/upgrade/index.cjs.map +1 -0
  44. package/dist/upgrade/index.d.cts +54 -0
  45. package/dist/upgrade/index.d.ts +54 -0
  46. package/dist/upgrade/index.js +5 -0
  47. package/dist/upgrade/index.js.map +1 -0
  48. package/package.json +94 -0
@@ -0,0 +1,175 @@
1
+ import { StrataError } from './chunk-EGFF63GA.js';
2
+ import { z } from 'zod';
3
+
4
+ var SEQUENCE_ID = /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+$/;
5
+ var MIGRATION_REF = /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+\/[1-9][0-9]*$/;
6
+ var KIND_NAME = /^[a-z][a-z0-9-]*$/;
7
+ var KIND_REF = /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+\/[a-z][a-z0-9-]*$/;
8
+ var EMBED_PATH = /^([A-Za-z_$][\w$]*|\*)(\[\])?(\.([A-Za-z_$][\w$]*|\*)(\[\])?)*$/;
9
+ var SqlStepSchema = z.object({
10
+ kind: z.literal("sql"),
11
+ sql: z.string().min(1).describe(
12
+ "ONE SQL statement. A driver that prepares statements (PGlite, pg with parameters) refuses a string carrying several \u2014 split them into steps rather than joining them with semicolons."
13
+ )
14
+ }).strict().describe("A statement run against the database, inside the migration transaction.");
15
+ var DocumentStepSchema = z.object({
16
+ kind: z.literal("document"),
17
+ at: z.string().regex(KIND_REF).describe('The kind of document this step rewrites, e.g. "nisc.nova/layout" \u2014 wherever one sits, at any depth.'),
18
+ transform: z.unknown().describe(
19
+ "A transform config (Prism) run by the injected evaluator over { document, path }: `document` is ONE document of the `at` kind, `path` where it sits. It returns that document rewritten. Nested documents are found by the grammar's embeddings and rewritten on their own, deepest first \u2014 a transform only ever sees one flat node."
20
+ )
21
+ }).strict().describe("A rewrite of stored JSON documents of one kind.");
22
+ var StepSchema = z.discriminatedUnion("kind", [SqlStepSchema, DocumentStepSchema]);
23
+ var DocumentKindSchema = z.object({
24
+ embeds: z.record(z.string().regex(EMBED_PATH), z.string().regex(KIND_REF)).optional().describe("Where other documents sit inside this one: path \u2192 the kind found there (possibly this kind itself).")
25
+ }).strict();
26
+ var MigrationSchema = z.object({
27
+ description: z.string().min(1).describe("One sentence: what this migration does. It is the changelog line and the ledger's description."),
28
+ steps: z.array(StepSchema).describe(
29
+ "Applied in order, in the same transaction as every other pending migration. Empty is a MARKER: the version moves and nothing runs \u2014 how an addition to a strict grammar tells older readers to refuse."
30
+ ),
31
+ dependsOn: z.array(z.string().regex(MIGRATION_REF)).optional().describe('Migrations of OTHER sequences that must be applied first, each as "<sequence>/<n>".')
32
+ }).strict();
33
+ var SequenceSchema = z.object({
34
+ id: z.string().regex(SEQUENCE_ID).describe('Namespaced and lowercase, e.g. "nisc.vex.cache" or "midas.app".'),
35
+ documents: z.record(z.string().regex(KIND_NAME), DocumentKindSchema).optional().describe('The document kinds this sequence owns (a GRAMMAR sequence), each named "<id>/<kind>" elsewhere.'),
36
+ migrations: z.array(MigrationSchema).describe("Append-only. A migration is numbered by its position (from 1); the sequence's version is its length.")
37
+ }).strict().superRefine((sequence, ctx) => {
38
+ const kinds = new Set(sequence.migrations.flatMap((m) => m.steps.map((s) => s.kind)));
39
+ if (kinds.has("sql") && (kinds.has("document") || sequence.documents !== void 0)) {
40
+ ctx.addIssue({
41
+ code: "custom",
42
+ message: "A sequence either owns tables (sql steps) or documents (document steps and `documents`), not both."
43
+ });
44
+ }
45
+ });
46
+
47
+ // src/checksum.ts
48
+ var canonical = (value) => {
49
+ if (Array.isArray(value)) return `[${value.map(canonical).join(",")}]`;
50
+ if (value !== null && typeof value === "object") {
51
+ const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
52
+ return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`).join(",")}}`;
53
+ }
54
+ return JSON.stringify(value);
55
+ };
56
+ var effectOf = (sql) => sql.split("\n").filter((line) => !line.trimStart().startsWith("--")).map((line) => line.trimEnd()).join("\n").trim();
57
+ var checksumOf = async (migration) => {
58
+ const steps = migration.steps.map((step) => step.kind === "sql" ? { ...step, sql: effectOf(step.sql) } : step);
59
+ const bytes = new TextEncoder().encode(canonical(steps));
60
+ const digest = await crypto.subtle.digest("SHA-256", bytes);
61
+ return Array.from(new Uint8Array(digest), (b) => b.toString(16).padStart(2, "0")).join("");
62
+ };
63
+
64
+ // src/plan.ts
65
+ var refOf = (sequence, n) => `${sequence}/${n}`;
66
+ var prepare = async (sequences) => {
67
+ const seen = /* @__PURE__ */ new Set();
68
+ const prepared = [];
69
+ for (const input of sequences) {
70
+ const parsed = SequenceSchema.safeParse(input);
71
+ if (!parsed.success) {
72
+ const issues = parsed.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`);
73
+ throw new StrataError("INVALID_SEQUENCE", `A sequence does not parse${typeof input.id === "string" ? ` ("${input.id}")` : ""}.`, issues);
74
+ }
75
+ const sequence = parsed.data;
76
+ if (seen.has(sequence.id)) {
77
+ throw new StrataError("INVALID_SEQUENCE", `Two sequences are both called "${sequence.id}" \u2014 a sequence id names one owner.`);
78
+ }
79
+ seen.add(sequence.id);
80
+ const migrations = [];
81
+ for (const [index, migration] of sequence.migrations.entries()) {
82
+ const n = index + 1;
83
+ migrations.push({
84
+ sequence: sequence.id,
85
+ n,
86
+ ref: refOf(sequence.id, n),
87
+ description: migration.description,
88
+ checksum: await checksumOf(migration),
89
+ steps: migration.steps,
90
+ dependsOn: migration.dependsOn ?? []
91
+ });
92
+ }
93
+ const grammar = sequence.documents !== void 0 || sequence.migrations.some((m) => m.steps.some((s) => s.kind === "document"));
94
+ prepared.push({ id: sequence.id, grammar, documents: sequence.documents ?? {}, migrations });
95
+ }
96
+ return prepared;
97
+ };
98
+ var orderPending = (queues, alreadyDone) => {
99
+ const done = new Set(alreadyDone);
100
+ const waiting = queues.map((q) => [...q.waiting]);
101
+ const pending = [];
102
+ let moved = true;
103
+ while (moved) {
104
+ moved = false;
105
+ for (const queue of waiting) {
106
+ for (let head = queue[0]; head !== void 0; head = queue[0]) {
107
+ if (!head.dependsOn.every((d) => done.has(d))) break;
108
+ pending.push(head);
109
+ done.add(head.ref);
110
+ queue.shift();
111
+ moved = true;
112
+ }
113
+ }
114
+ }
115
+ return { pending, stuck: waiting.flat() };
116
+ };
117
+ var planMigrations = (sequences, ledger) => {
118
+ const problems = [];
119
+ const applied = {};
120
+ const done = new Set(ledger.map((row) => refOf(row.sequence, row.n)));
121
+ const byRef = new Map(ledger.map((row) => [refOf(row.sequence, row.n), row]));
122
+ const queues = [];
123
+ for (const sequence of sequences) {
124
+ const rows = ledger.filter((row) => row.sequence === sequence.id);
125
+ applied[sequence.id] = rows.length;
126
+ const beyond = rows.filter((row) => row.n > sequence.migrations.length);
127
+ if (beyond.length > 0) {
128
+ problems.push({
129
+ code: "TOO_NEW",
130
+ detail: `${sequence.id}: the database is at ${Math.max(...rows.map((r) => r.n))}, this code knows ${sequence.migrations.length} \u2014 it was migrated by newer code.`
131
+ });
132
+ }
133
+ const waiting = [];
134
+ for (const migration of sequence.migrations) {
135
+ const row = byRef.get(migration.ref);
136
+ if (row === void 0) {
137
+ waiting.push(migration);
138
+ } else if (row.checksum !== migration.checksum) {
139
+ problems.push({
140
+ code: "EDITED",
141
+ detail: `${migration.ref} ("${migration.description}") was applied ${row.appliedAt} and its steps have changed since. An applied migration is history \u2014 append a new one.`
142
+ });
143
+ }
144
+ }
145
+ const firstWaiting = waiting[0];
146
+ if (firstWaiting !== void 0 && rows.some((row) => row.n > firstWaiting.n)) {
147
+ problems.push({ code: "EDITED", detail: `${sequence.id}: ${firstWaiting.ref} never ran, but a later migration of the sequence did.` });
148
+ }
149
+ queues.push({ id: sequence.id, waiting });
150
+ }
151
+ const provided = new Set(sequences.flatMap((s) => s.migrations.map((m) => m.ref)));
152
+ for (const { waiting } of queues) {
153
+ for (const migration of waiting) {
154
+ for (const dependency of migration.dependsOn) {
155
+ if (!done.has(dependency) && !provided.has(dependency)) {
156
+ problems.push({ code: "UNKNOWN_DEPENDENCY", detail: `${migration.ref} depends on ${dependency}, which nothing provides and the database has not run.` });
157
+ }
158
+ }
159
+ }
160
+ }
161
+ const { pending, stuck } = orderPending(queues, done);
162
+ if (stuck.length > 0 && !problems.some((p) => p.code === "UNKNOWN_DEPENDENCY")) {
163
+ problems.push({ code: "CYCLE", detail: `These wait on each other and can never run: ${stuck.map((m) => m.ref).join(", ")}.` });
164
+ }
165
+ return { applied, pending, problems };
166
+ };
167
+ var refuseProblems = (plan) => {
168
+ const first = plan.problems[0];
169
+ if (first === void 0) return;
170
+ throw new StrataError(first.code, "The migrations cannot be applied safely.", plan.problems.map((p) => `${p.code}: ${p.detail}`));
171
+ };
172
+
173
+ export { DocumentKindSchema, DocumentStepSchema, EMBED_PATH, KIND_NAME, KIND_REF, MIGRATION_REF, MigrationSchema, SEQUENCE_ID, SequenceSchema, SqlStepSchema, StepSchema, checksumOf, orderPending, planMigrations, prepare, refuseProblems };
174
+ //# sourceMappingURL=chunk-U5CPF4LQ.js.map
175
+ //# sourceMappingURL=chunk-U5CPF4LQ.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/schema.ts","../src/checksum.ts","../src/plan.ts"],"names":[],"mappings":"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","file":"chunk-U5CPF4LQ.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' | '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"]}
@@ -0,0 +1,90 @@
1
+ import { z } from 'zod';
2
+
3
+ declare const SEQUENCE_ID: RegExp;
4
+ declare const MIGRATION_REF: RegExp;
5
+ declare const KIND_NAME: RegExp;
6
+ declare const KIND_REF: RegExp;
7
+ declare const EMBED_PATH: RegExp;
8
+ declare const SqlStepSchema: z.ZodObject<{
9
+ kind: z.ZodLiteral<"sql">;
10
+ sql: z.ZodString;
11
+ }, z.core.$strict>;
12
+ declare const DocumentStepSchema: z.ZodObject<{
13
+ kind: z.ZodLiteral<"document">;
14
+ at: z.ZodString;
15
+ transform: z.ZodUnknown;
16
+ }, z.core.$strict>;
17
+ declare const StepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
18
+ kind: z.ZodLiteral<"sql">;
19
+ sql: z.ZodString;
20
+ }, z.core.$strict>, z.ZodObject<{
21
+ kind: z.ZodLiteral<"document">;
22
+ at: z.ZodString;
23
+ transform: z.ZodUnknown;
24
+ }, z.core.$strict>], "kind">;
25
+ declare const DocumentKindSchema: z.ZodObject<{
26
+ embeds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
27
+ }, z.core.$strict>;
28
+ declare const MigrationSchema: z.ZodObject<{
29
+ description: z.ZodString;
30
+ steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
31
+ kind: z.ZodLiteral<"sql">;
32
+ sql: z.ZodString;
33
+ }, z.core.$strict>, z.ZodObject<{
34
+ kind: z.ZodLiteral<"document">;
35
+ at: z.ZodString;
36
+ transform: z.ZodUnknown;
37
+ }, z.core.$strict>], "kind">>;
38
+ dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
39
+ }, z.core.$strict>;
40
+ declare const SequenceSchema: z.ZodObject<{
41
+ id: z.ZodString;
42
+ documents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
43
+ embeds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
44
+ }, z.core.$strict>>>;
45
+ migrations: z.ZodArray<z.ZodObject<{
46
+ description: z.ZodString;
47
+ steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
48
+ kind: z.ZodLiteral<"sql">;
49
+ sql: z.ZodString;
50
+ }, z.core.$strict>, z.ZodObject<{
51
+ kind: z.ZodLiteral<"document">;
52
+ at: z.ZodString;
53
+ transform: z.ZodUnknown;
54
+ }, z.core.$strict>], "kind">>;
55
+ dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
56
+ }, z.core.$strict>>;
57
+ }, z.core.$strict>;
58
+ type SqlStep = z.infer<typeof SqlStepSchema>;
59
+ type DocumentStep = z.infer<typeof DocumentStepSchema>;
60
+ type DocumentKind = z.infer<typeof DocumentKindSchema>;
61
+ type Step = z.infer<typeof StepSchema>;
62
+ type Migration = z.infer<typeof MigrationSchema>;
63
+ type Sequence = z.infer<typeof SequenceSchema>;
64
+
65
+ type Stamp = Readonly<Record<string, number>>;
66
+ type Location = {
67
+ path: readonly (string | number)[];
68
+ kind: string;
69
+ value: Record<string, unknown>;
70
+ };
71
+ type Transform = (config: unknown, source: unknown) => unknown;
72
+ type UpgradeResult = {
73
+ document: Record<string, unknown>;
74
+ stamp: Stamp;
75
+ applied: readonly string[];
76
+ };
77
+ type Upgrader = {
78
+ stamp: Stamp;
79
+ upgrade: (document: unknown, options: {
80
+ kind: string;
81
+ stamp?: Stamp | null;
82
+ }) => UpgradeResult;
83
+ locate: (document: unknown, kind: string) => Location[];
84
+ behind: (stamp: Stamp | null | undefined) => boolean;
85
+ };
86
+ declare const createUpgrader: (sequences: readonly Sequence[], options: {
87
+ transform: Transform;
88
+ }) => Promise<Upgrader>;
89
+
90
+ export { type DocumentKind as D, EMBED_PATH as E, KIND_NAME as K, type Location as L, type Migration as M, type SqlStep as S, type Transform as T, type UpgradeResult as U, type Sequence as a, DocumentKindSchema as b, type DocumentStep as c, DocumentStepSchema as d, KIND_REF as e, MIGRATION_REF as f, MigrationSchema as g, SEQUENCE_ID as h, SequenceSchema as i, SqlStepSchema as j, type Stamp as k, type Step as l, StepSchema as m, type Upgrader as n, createUpgrader as o };
@@ -0,0 +1,90 @@
1
+ import { z } from 'zod';
2
+
3
+ declare const SEQUENCE_ID: RegExp;
4
+ declare const MIGRATION_REF: RegExp;
5
+ declare const KIND_NAME: RegExp;
6
+ declare const KIND_REF: RegExp;
7
+ declare const EMBED_PATH: RegExp;
8
+ declare const SqlStepSchema: z.ZodObject<{
9
+ kind: z.ZodLiteral<"sql">;
10
+ sql: z.ZodString;
11
+ }, z.core.$strict>;
12
+ declare const DocumentStepSchema: z.ZodObject<{
13
+ kind: z.ZodLiteral<"document">;
14
+ at: z.ZodString;
15
+ transform: z.ZodUnknown;
16
+ }, z.core.$strict>;
17
+ declare const StepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
18
+ kind: z.ZodLiteral<"sql">;
19
+ sql: z.ZodString;
20
+ }, z.core.$strict>, z.ZodObject<{
21
+ kind: z.ZodLiteral<"document">;
22
+ at: z.ZodString;
23
+ transform: z.ZodUnknown;
24
+ }, z.core.$strict>], "kind">;
25
+ declare const DocumentKindSchema: z.ZodObject<{
26
+ embeds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
27
+ }, z.core.$strict>;
28
+ declare const MigrationSchema: z.ZodObject<{
29
+ description: z.ZodString;
30
+ steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
31
+ kind: z.ZodLiteral<"sql">;
32
+ sql: z.ZodString;
33
+ }, z.core.$strict>, z.ZodObject<{
34
+ kind: z.ZodLiteral<"document">;
35
+ at: z.ZodString;
36
+ transform: z.ZodUnknown;
37
+ }, z.core.$strict>], "kind">>;
38
+ dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
39
+ }, z.core.$strict>;
40
+ declare const SequenceSchema: z.ZodObject<{
41
+ id: z.ZodString;
42
+ documents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
43
+ embeds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
44
+ }, z.core.$strict>>>;
45
+ migrations: z.ZodArray<z.ZodObject<{
46
+ description: z.ZodString;
47
+ steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
48
+ kind: z.ZodLiteral<"sql">;
49
+ sql: z.ZodString;
50
+ }, z.core.$strict>, z.ZodObject<{
51
+ kind: z.ZodLiteral<"document">;
52
+ at: z.ZodString;
53
+ transform: z.ZodUnknown;
54
+ }, z.core.$strict>], "kind">>;
55
+ dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
56
+ }, z.core.$strict>>;
57
+ }, z.core.$strict>;
58
+ type SqlStep = z.infer<typeof SqlStepSchema>;
59
+ type DocumentStep = z.infer<typeof DocumentStepSchema>;
60
+ type DocumentKind = z.infer<typeof DocumentKindSchema>;
61
+ type Step = z.infer<typeof StepSchema>;
62
+ type Migration = z.infer<typeof MigrationSchema>;
63
+ type Sequence = z.infer<typeof SequenceSchema>;
64
+
65
+ type Stamp = Readonly<Record<string, number>>;
66
+ type Location = {
67
+ path: readonly (string | number)[];
68
+ kind: string;
69
+ value: Record<string, unknown>;
70
+ };
71
+ type Transform = (config: unknown, source: unknown) => unknown;
72
+ type UpgradeResult = {
73
+ document: Record<string, unknown>;
74
+ stamp: Stamp;
75
+ applied: readonly string[];
76
+ };
77
+ type Upgrader = {
78
+ stamp: Stamp;
79
+ upgrade: (document: unknown, options: {
80
+ kind: string;
81
+ stamp?: Stamp | null;
82
+ }) => UpgradeResult;
83
+ locate: (document: unknown, kind: string) => Location[];
84
+ behind: (stamp: Stamp | null | undefined) => boolean;
85
+ };
86
+ declare const createUpgrader: (sequences: readonly Sequence[], options: {
87
+ transform: Transform;
88
+ }) => Promise<Upgrader>;
89
+
90
+ export { type DocumentKind as D, EMBED_PATH as E, KIND_NAME as K, type Location as L, type Migration as M, type SqlStep as S, type Transform as T, type UpgradeResult as U, type Sequence as a, DocumentKindSchema as b, type DocumentStep as c, DocumentStepSchema as d, KIND_REF as e, MIGRATION_REF as f, MigrationSchema as g, SEQUENCE_ID as h, SequenceSchema as i, SqlStepSchema as j, type Stamp as k, type Step as l, StepSchema as m, type Upgrader as n, createUpgrader as o };