@niscorp/strata 0.1.9 → 0.2.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.
- package/CHANGELOG.md +34 -0
- package/DESIGN.md +4 -0
- package/README.md +47 -8
- package/dist/check/index.cjs +6 -6
- package/dist/check/index.js +1 -1
- package/dist/{chunk-SH6BBA2X.js → chunk-2G3DFR6P.js} +13 -11
- package/dist/chunk-2G3DFR6P.js.map +1 -0
- package/dist/{chunk-FSEUYRLN.cjs → chunk-FMXFHYU2.cjs} +15 -6
- package/dist/chunk-FMXFHYU2.cjs.map +1 -0
- package/dist/{chunk-SYU7NKZR.cjs → chunk-HTW4IEBC.cjs} +13 -11
- package/dist/chunk-HTW4IEBC.cjs.map +1 -0
- package/dist/{chunk-564JCO6Q.cjs → chunk-I2CR5CBI.cjs} +17 -13
- package/dist/chunk-I2CR5CBI.cjs.map +1 -0
- package/dist/{chunk-FNMGVPSA.js → chunk-LJAB5G5Y.js} +13 -4
- package/dist/chunk-LJAB5G5Y.js.map +1 -0
- package/dist/{chunk-DGS4XJQQ.js → chunk-QDZYRBRP.js} +14 -11
- package/dist/chunk-QDZYRBRP.js.map +1 -0
- package/dist/{chunk-KYNER7UU.cjs → chunk-SJNHLIKR.cjs} +4 -3
- package/dist/chunk-SJNHLIKR.cjs.map +1 -0
- package/dist/{chunk-PAMQMFBK.js → chunk-YCQ6LS7X.js} +4 -3
- package/dist/chunk-YCQ6LS7X.js.map +1 -0
- package/dist/index.cjs +19 -19
- package/dist/index.js +2 -2
- package/dist/node/index.cjs +178 -89
- package/dist/node/index.cjs.map +1 -1
- package/dist/node/index.js +180 -91
- package/dist/node/index.js.map +1 -1
- package/dist/postgres/index.cjs +26 -11
- package/dist/postgres/index.cjs.map +1 -1
- package/dist/postgres/index.d.cts +1 -0
- package/dist/postgres/index.d.ts +1 -0
- package/dist/postgres/index.js +20 -5
- package/dist/postgres/index.js.map +1 -1
- package/dist/upgrade/index.cjs +6 -6
- package/dist/upgrade/index.js +2 -2
- package/package.json +1 -1
- package/dist/chunk-564JCO6Q.cjs.map +0 -1
- package/dist/chunk-DGS4XJQQ.js.map +0 -1
- package/dist/chunk-FNMGVPSA.js.map +0 -1
- package/dist/chunk-FSEUYRLN.cjs.map +0 -1
- package/dist/chunk-KYNER7UU.cjs.map +0 -1
- package/dist/chunk-PAMQMFBK.js.map +0 -1
- package/dist/chunk-SH6BBA2X.js.map +0 -1
- package/dist/chunk-SYU7NKZR.cjs.map +0 -1
package/dist/postgres/index.d.ts
CHANGED
|
@@ -47,6 +47,7 @@ type StoreReport = {
|
|
|
47
47
|
total: number;
|
|
48
48
|
upgraded: number;
|
|
49
49
|
applied: Readonly<Record<string, number>>;
|
|
50
|
+
unread?: readonly string[];
|
|
50
51
|
};
|
|
51
52
|
declare const upgradeStore: (pool: StrataPool, store: DocumentStore, upgrader: Upgrader) => Promise<StoreReport>;
|
|
52
53
|
|
package/dist/postgres/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { planMigrations, prepare, refuseProblems } from '../chunk-
|
|
1
|
+
import { planMigrations, prepare, refuseProblems } from '../chunk-YCQ6LS7X.js';
|
|
2
2
|
import { StrataError } from '../chunk-STNFHBNR.js';
|
|
3
3
|
|
|
4
4
|
// src/postgres/index.ts
|
|
@@ -136,18 +136,33 @@ var upgradeStore = async (pool, store, upgrader) => {
|
|
|
136
136
|
const stamp = quote(store.stamp, "column");
|
|
137
137
|
const keys = store.key.map((k) => quote(k, "column"));
|
|
138
138
|
if (keys.length === 0) throw new StrataError("INVALID_SEQUENCE", `The store ${store.table} names no key columns.`);
|
|
139
|
+
const byKey = keys.map((k, i) => `${k} = $${i + 1}`).join(" AND ");
|
|
139
140
|
return pool.transaction(async (tx) => {
|
|
140
|
-
const { rows } = await tx.query(`SELECT ${[...keys,
|
|
141
|
+
const { rows } = await tx.query(`SELECT ${[...keys, stamp].join(", ")} FROM ${table} FOR UPDATE`);
|
|
141
142
|
const applied = {};
|
|
143
|
+
const unread = [];
|
|
142
144
|
let upgraded = 0;
|
|
143
145
|
for (const row of rows) {
|
|
144
146
|
const given = row[store.stamp];
|
|
145
|
-
const rowStamp = typeof given === "object" && given !== null && !Array.isArray(given) ? Object.fromEntries(Object.entries(given).map(([k, v]) => [k, Number(v)])) : {};
|
|
146
147
|
const where = store.key.map((k) => `${k}=${JSON.stringify(row[k])}`).join(", ");
|
|
148
|
+
if (given !== null && given !== void 0 && (typeof given !== "object" || Array.isArray(given))) {
|
|
149
|
+
unread.push(where);
|
|
150
|
+
continue;
|
|
151
|
+
}
|
|
152
|
+
const rowStamp = given === null || given === void 0 ? {} : Object.fromEntries(Object.entries(given).map(([k, v]) => [k, Number(v)]));
|
|
153
|
+
if (Object.keys(upgrader.stamp).some((id) => Number.isNaN(rowStamp[id]))) {
|
|
154
|
+
unread.push(where);
|
|
155
|
+
continue;
|
|
156
|
+
}
|
|
147
157
|
let result;
|
|
148
158
|
try {
|
|
149
159
|
if (!upgrader.behind(rowStamp)) continue;
|
|
150
|
-
|
|
160
|
+
const [current] = (await tx.query(`SELECT ${column} FROM ${table} WHERE ${byKey}`, store.key.map((k) => row[k]))).rows;
|
|
161
|
+
if (current === void 0) {
|
|
162
|
+
unread.push(where);
|
|
163
|
+
continue;
|
|
164
|
+
}
|
|
165
|
+
result = upgrader.upgrade(current[store.column], { kind: store.kind, stamp: rowStamp });
|
|
151
166
|
} catch (cause) {
|
|
152
167
|
if (cause instanceof StrataError) {
|
|
153
168
|
throw new StrataError(cause.code, `${store.table} (${where}): ${cause.message.split("\n")[0] ?? ""}`, cause.details, { cause });
|
|
@@ -161,7 +176,7 @@ var upgradeStore = async (pool, store, upgrader) => {
|
|
|
161
176
|
upgraded += 1;
|
|
162
177
|
for (const ref of result.applied) applied[ref] = (applied[ref] ?? 0) + 1;
|
|
163
178
|
}
|
|
164
|
-
return { total: rows.length, upgraded, applied };
|
|
179
|
+
return unread.length === 0 ? { total: rows.length, upgraded, applied } : { total: rows.length, upgraded, applied, unread };
|
|
165
180
|
});
|
|
166
181
|
};
|
|
167
182
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/postgres/index.ts"],"names":[],"mappings":";;;;AA8BA,IAAM,eAAA,GAAkB,GAAA;AACxB,IAAM,oBAAA,GAAuB,IAAA;AAO7B,IAAM,KAAA,GAAQ,0BAAA;AACd,IAAM,KAAA,GAAQ,CAAC,IAAA,EAAc,KAAA,KAA0B;AACrD,EAAA,IAAI,CAAC,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA,EAAG,MAAM,IAAI,WAAA,CAAY,kBAAA,EAAoB,CAAA,WAAA,EAAc,KAAK,CAAA,EAAA,EAAK,IAAI,CAAA,4BAAA,CAA8B,CAAA;AAC3H,EAAA,OAAO,IAAI,IAAI,CAAA,CAAA,CAAA;AACjB,CAAA;AAEA,IAAM,YAAA,GAAe,CAAC,OAAA,KAA8E;AAClG,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,OAAA,CAAQ,KAAA,IAAS,iBAAiB,OAAO,CAAA;AAC7D,EAAA,MAAM,MAAA,GAAS,QAAQ,MAAA,KAAW,MAAA,GAAY,SAAY,KAAA,CAAM,OAAA,CAAQ,QAAQ,QAAQ,CAAA;AACxF,EAAA,OAAO,EAAE,SAAA,EAAW,MAAA,KAAW,MAAA,GAAY,KAAA,GAAQ,GAAG,MAAM,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,EAAI,MAAA,EAAO;AAClF,CAAA;AAEO,IAAM,SAAA,GAAY,CAAC,OAAA,GAAyB,EAAC,KAAc;AAChE,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,YAAA,CAAa,OAAO,CAAA;AAC1C,EAAA,OAAO,8BAA8B,SAAS,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA,CAAA;AAQhD;AAEA,IAAM,IAAA,GAAO,CAAC,KAAA,KAA4B,KAAA,YAAiB,OAAO,KAAA,CAAM,WAAA,EAAY,GAAI,MAAA,CAAO,KAAK,CAAA;AAEpG,IAAM,QAAA,GAAW,OAAO,EAAA,EAA4B,SAAA,KAA4C;AAC9F,EAAA,MAAM,EAAE,MAAK,GAAI,MAAM,GAAG,KAAA,CAAM,CAAA,2DAAA,EAA8D,SAAS,CAAA,qBAAA,CAAuB,CAAA;AAC9H,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,IACxB,QAAA,EAAU,IAAA,CAAK,GAAA,CAAI,UAAU,CAAC,CAAA;AAAA,IAC9B,CAAA,EAAG,MAAA,CAAO,GAAA,CAAI,GAAG,CAAC,CAAA;AAAA,IAClB,QAAA,EAAU,IAAA,CAAK,GAAA,CAAI,UAAU,CAAC,CAAA;AAAA,IAC9B,WAAA,EAAa,IAAA,CAAK,GAAA,CAAI,aAAa,CAAC,CAAA;AAAA,IACpC,SAAA,EAAW,IAAA,CAAK,GAAA,CAAI,YAAY,CAAC;AAAA,GACnC,CAAE,CAAA;AACJ,CAAA;AAEO,IAAM,UAAA,GAAa,OAAO,IAAA,EAAkB,OAAA,GAAyB,EAAC,KAA4B;AACvG,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,YAAA,CAAa,OAAO,CAAA;AAC1C,EAAA,MAAM,EAAE,MAAK,GAAI,MAAM,KAAK,KAAA,CAAM,+CAAA,EAAiD,CAAC,SAAS,CAAC,CAAA;AAC9F,EAAA,IAAI,KAAK,CAAC,CAAA,GAAI,SAAS,CAAA,KAAM,IAAA,SAAa,EAAC;AAC3C,EAAA,OAAO,QAAA,CAAS,MAAM,SAAS,CAAA;AACjC;AAEO,IAAM,SAAS,OAAO,IAAA,EAAkB,SAAA,EAAgC,OAAA,GAAuC,EAAC,KACrH,cAAA,CAAe,MAAM,OAAA,CAAQ,SAAS,CAAA,EAAG,MAAM,WAAW,IAAA,EAAM,OAAO,GAAG,OAAO;AAEnF,IAAM,cAAA,GAAiB,CAAC,QAAA,KAAgD;AACtE,EAAA,MAAM,WAAW,QAAA,CAAS,MAAA,CAAO,CAAC,CAAA,KAAM,EAAE,OAAO,CAAA;AACjD,EAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AACvB,IAAA,MAAM,IAAI,WAAA;AAAA,MACR,aAAA;AAAA,MACA,+LAAA;AAAA,MACA,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,EAAE;AAAA,KAC1B;AAAA,EACF;AACF,CAAA;AAEA,IAAM,aAAA,GAAgB,CAAC,IAAA,KAAqB;AAC1C,EAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG;AAC/B,EAAA,MAAM,IAAI,WAAA;AAAA,IACR,SAAA;AAAA,IACA,CAAA,EAAG,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,UAAA,EAAa,KAAK,OAAA,CAAQ,MAAA,KAAW,CAAA,GAAI,KAAA,GAAQ,OAAO,CAAA,oEAAA,CAAA;AAAA,IAC9E,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,GAAG,CAAA,EAAA,EAAK,CAAA,CAAE,WAAW,CAAA,CAAE;AAAA,GACtD;AACF,CAAA;AAEO,IAAM,UAAU,OAAO,IAAA,EAAkB,SAAA,EAAgC,OAAA,GAA0B,EAAC,KAA8B;AACvI,EAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,SAAS,CAAA;AACxC,EAAA,cAAA,CAAe,QAAQ,CAAA;AAGvB,EAAA,MAAM,IAAA,GAAO,eAAe,QAAA,EAAU,MAAM,WAAW,IAAA,EAAM,OAAO,GAAG,OAAO,CAAA;AAC9E,EAAA,cAAA,CAAe,IAAI,CAAA;AACnB,EAAA,IAAI,OAAA,CAAQ,SAAS,QAAA,EAAU;AAC7B,IAAA,aAAA,CAAc,IAAI,CAAA;AAClB,IAAA,OAAO,EAAE,OAAA,EAAS,EAAC,EAAG,MAAM,IAAA,EAAK;AAAA,EACnC;AACA,EAAA,IAAI,KAAK,OAAA,CAAQ,MAAA,KAAW,CAAA,IAAK,OAAA,CAAQ,UAAU,MAAA,IAAa,OAAA,CAAQ,MAAA,KAAW,IAAA,SAAa,EAAE,OAAA,EAAS,EAAC,EAAG,MAAM,IAAA,EAAK;AAC1H,EAAA,IAAI,IAAA,CAAK,gBAAgB,MAAA,EAAW;AAClC,IAAA,MAAM,IAAI,WAAA;AAAA,MACR,gBAAA;AAAA,MACA;AAAA,KAEF;AAAA,EACF;AACA,EAAA,MAAM,EAAE,SAAA,EAAW,MAAA,EAAO,GAAI,aAAa,OAAO,CAAA;AAGlD,EAAA,MAAM,SAAA,GAAY,IAAI,KAAA,CAAM,iBAAiB,CAAA;AAC7C,EAAA,IAAI,YAAA;AAEJ,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,WAAA,CAAY,OAAO,EAAA,KAAO;AAGzC,IAAA,MAAM,EAAA,CAAG,MAAM,kDAAA,EAAoD,CAAC,GAAG,OAAA,CAAQ,kBAAA,IAAsB,oBAAoB,CAAA,EAAA,CAAI,CAAC,CAAA;AAC9H,IAAA,MAAM,EAAA,CAAG,MAAM,8CAA8C,CAAA;AAG7D,IAAA,MAAM,GAAG,KAAA,CAAM,4CAAA,EAA8C,CAAC,CAAA,OAAA,EAAU,SAAS,EAAE,CAAC,CAAA;AACpF,IAAA,MAAM,EAAA,CAAG,MAAM,6CAAA,EAA+C,CAAC,GAAG,OAAA,CAAQ,aAAA,IAAiB,eAAe,CAAA,EAAA,CAAI,CAAC,CAAA;AAC/G,IAAA,IAAI,WAAW,MAAA,EAAW,MAAM,GAAG,KAAA,CAAM,CAAA,4BAAA,EAA+B,MAAM,CAAA,CAAE,CAAA;AAChF,IAAA,MAAM,EAAA,CAAG,KAAA,CAAM,SAAA,CAAU,OAAO,CAAC,CAAA;AAEjC,IAAA,MAAM,IAAA,GAAO,eAAe,QAAA,EAAU,MAAM,SAAS,EAAA,EAAI,SAAS,GAAG,OAAO,CAAA;AAC5E,IAAA,cAAA,CAAe,IAAI,CAAA;AAEnB,IAAA,MAAM,UAA+B,EAAC;AACtC,IAAA,KAAA,MAAW,SAAA,IAAa,KAAK,OAAA,EAAS;AACpC,MAAA,KAAA,MAAW,CAAC,KAAA,EAAO,IAAI,KAAK,SAAA,CAAU,KAAA,CAAM,SAAQ,EAAG;AAErD,QAAA,IAAI,IAAA,CAAK,SAAS,KAAA,EAAO;AACzB,QAAA,IAAI;AACF,UAAA,MAAM,EAAA,CAAG,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAAA,QACzB,SAAS,KAAA,EAAO;AACd,UAAA,MAAM,IAAI,WAAA;AAAA,YACR,aAAA;AAAA,YACA,CAAA,EAAG,SAAA,CAAU,GAAG,CAAA,GAAA,EAAM,SAAA,CAAU,WAAW,CAAA,kBAAA,EAAqB,KAAA,GAAQ,CAAC,CAAA,IAAA,EAAO,SAAA,CAAU,KAAA,CAAM,MAAM,CAAA,oCAAA,CAAA;AAAA,YACtG,CAAC,iBAAiB,KAAA,GAAQ,KAAA,CAAM,UAAU,MAAA,CAAO,KAAK,GAAG,IAAA,CAAK,GAAA,CAAI,SAAS,GAAA,GAAM,CAAA,EAAG,KAAK,GAAA,CAAI,KAAA,CAAM,GAAG,GAAG,CAAC,CAAA,MAAA,CAAA,GAAM,IAAA,CAAK,GAAG,CAAA;AAAA,YACxH,EAAE,KAAA;AAAM,WACV;AAAA,QACF;AAAA,MACF;AACA,MAAA,MAAM,EAAA,CAAG,KAAA,CAAM,CAAA,YAAA,EAAe,SAAS,CAAA,6DAAA,CAAA,EAAiE;AAAA,QACtG,SAAA,CAAU,QAAA;AAAA,QACV,SAAA,CAAU,CAAA;AAAA,QACV,SAAA,CAAU,WAAA;AAAA,QACV,SAAA,CAAU;AAAA,OACX,CAAA;AACD,MAAA,OAAA,CAAQ,KAAK,SAAS,CAAA;AAAA,IACxB;AAEA,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,KAAA,KAAU,MAAA,GAAY,EAAC,GAAI,MAAM,OAAA,CAAQ,KAAA,CAAM,EAAA,EAAI,EAAE,OAAA,EAAS,CAAA;AACtF,IAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACtB,MAAA,MAAM,IAAI,WAAA,CAAY,cAAA,EAAgB,6FAAA,EAA+F,OAAO,CAAA;AAAA,IAC9I;AACA,IAAA,IAAI,OAAA,CAAQ,WAAW,IAAA,EAAM;AAC3B,MAAA,YAAA,GAAe,EAAE,SAAS,IAAA,EAAK;AAC/B,MAAA,MAAM,SAAA;AAAA,IACR;AACA,IAAA,OAAO,EAAE,SAAS,IAAA,EAAK;AAAA,EACzB,CAAC,CAAA;AAED,EAAA,OAAO,GAAA,CAAI,KAAA,CAAM,CAAC,KAAA,KAAmB;AACnC,IAAA,IAAI,KAAA,KAAU,SAAA,IAAa,YAAA,KAAiB,MAAA,EAAW,OAAO,YAAA;AAC9D,IAAA,MAAM,KAAA;AAAA,EACR,CAAC,CAAA;AACH;AAiBO,IAAM,YAAA,GAAe,OAAO,IAAA,EAAkB,KAAA,EAAsB,QAAA,KAA6C;AACtH,EAAA,IAAI,IAAA,CAAK,gBAAgB,MAAA,EAAW;AAClC,IAAA,MAAM,IAAI,WAAA,CAAY,gBAAA,EAAkB,sFAAsF,CAAA;AAAA,EAChI;AACA,EAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,KAAW,MAAA,GAAY,MAAM,KAAA,CAAM,KAAA,EAAO,OAAO,CAAA,GAAI,CAAA,EAAG,MAAM,KAAA,CAAM,MAAA,EAAQ,QAAQ,CAAC,CAAA,CAAA,EAAI,MAAM,KAAA,CAAM,KAAA,EAAO,OAAO,CAAC,CAAA,CAAA;AACxI,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,KAAA,CAAM,MAAA,EAAQ,QAAQ,CAAA;AAC3C,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,KAAA,EAAO,QAAQ,CAAA;AACzC,EAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,GAAA,CAAI,CAAC,CAAA,KAAM,KAAA,CAAM,CAAA,EAAG,QAAQ,CAAC,CAAA;AACpD,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,MAAM,IAAI,YAAY,kBAAA,EAAoB,CAAA,UAAA,EAAa,KAAA,CAAM,KAAK,CAAA,sBAAA,CAAwB,CAAA;AAEjH,EAAA,OAAO,IAAA,CAAK,WAAA,CAAY,OAAO,EAAA,KAAO;AACpC,IAAA,MAAM,EAAE,IAAA,EAAK,GAAI,MAAM,EAAA,CAAG,KAAA,CAAM,UAAU,CAAC,GAAG,IAAA,EAAM,MAAA,EAAQ,KAAK,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,MAAA,EAAS,KAAK,CAAA,WAAA,CAAa,CAAA;AACxG,IAAA,MAAM,UAAkC,EAAC;AACzC,IAAA,IAAI,QAAA,GAAW,CAAA;AACf,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,KAAA,CAAM,KAAK,CAAA;AAC7B,MAAA,MAAM,QAAA,GAAW,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,IAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,MAAA,CAAO,YAAY,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM,CAAC,CAAA,EAAG,MAAA,CAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAC;AACrK,MAAA,MAAM,QAAQ,KAAA,CAAM,GAAA,CAAI,IAAI,CAAC,CAAA,KAAM,GAAG,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,SAAA,CAAU,IAAI,CAAC,CAAC,CAAC,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAC9E,MAAA,IAAI,MAAA;AACJ,MAAA,IAAI;AACF,QAAA,IAAI,CAAC,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAA,EAAG;AAChC,QAAA,MAAA,GAAS,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,MAAM,CAAA,EAAG,EAAE,IAAA,EAAM,KAAA,CAAM,IAAA,EAAM,KAAA,EAAO,QAAA,EAAU,CAAA;AAAA,MACpF,SAAS,KAAA,EAAO;AACd,QAAA,IAAI,iBAAiB,WAAA,EAAa;AAChC,UAAA,MAAM,IAAI,YAAY,KAAA,CAAM,IAAA,EAAM,GAAG,KAAA,CAAM,KAAK,CAAA,EAAA,EAAK,KAAK,CAAA,GAAA,EAAM,KAAA,CAAM,QAAQ,KAAA,CAAM,IAAI,CAAA,CAAE,CAAC,CAAA,IAAK,EAAE,IAAI,KAAA,CAAM,OAAA,EAAS,EAAE,KAAA,EAAO,CAAA;AAAA,QAChI;AACA,QAAA,MAAM,KAAA;AAAA,MACR;AACA,MAAA,MAAM,EAAA,CAAG,KAAA;AAAA,QACP,CAAA,OAAA,EAAU,KAAK,CAAA,KAAA,EAAQ,MAAM,iBAAiB,KAAK,CAAA,mBAAA,EAAsB,KAAK,GAAA,CAAI,CAAC,GAAG,CAAA,KAAM,CAAA,EAAG,CAAC,CAAA,IAAA,EAAO,CAAA,GAAI,CAAC,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,OAAO,CAAC,CAAA,CAAA;AAAA,QAC7H,CAAC,KAAK,SAAA,CAAU,MAAA,CAAO,QAAQ,CAAA,EAAG,IAAA,CAAK,UAAU,MAAA,CAAO,KAAK,GAAG,GAAG,KAAA,CAAM,IAAI,GAAA,CAAI,CAAC,MAAM,GAAA,CAAI,CAAC,CAAC,CAAC;AAAA,OACjG;AACA,MAAA,QAAA,IAAY,CAAA;AACZ,MAAA,KAAA,MAAW,GAAA,IAAO,OAAO,OAAA,EAAS,OAAA,CAAQ,GAAG,CAAA,GAAA,CAAK,OAAA,CAAQ,GAAG,CAAA,IAAK,CAAA,IAAK,CAAA;AAAA,IACzE;AACA,IAAA,OAAO,EAAE,KAAA,EAAO,IAAA,CAAK,MAAA,EAAQ,UAAU,OAAA,EAAQ;AAAA,EACjD,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["import { prepare, planMigrations, refuseProblems, type LedgerRow, type Plan, type 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
|
+
{"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 unread?: readonly string[];\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 // Every row is locked, but only its key and stamp are read with the lock; a behind row's document is read\n // by its key, one at a time.\n const byKey = keys.map((k, i) => `${k} = $${i + 1}`).join(' AND ');\n return pool.transaction(async (tx) => {\n const { rows } = await tx.query(`SELECT ${[...keys, stamp].join(', ')} FROM ${table} FOR UPDATE`);\n const applied: Record<string, number> = {};\n const unread: string[] = [];\n let upgraded = 0;\n for (const row of rows) {\n const given = row[store.stamp];\n const where = store.key.map((k) => `${k}=${JSON.stringify(row[k])}`).join(', ');\n // Null is no stamp. Anything else that is not an object (a text column's string) cannot be read as one.\n if (given !== null && given !== undefined && (typeof given !== 'object' || Array.isArray(given))) {\n unread.push(where);\n continue;\n }\n const rowStamp = given === null || given === undefined ? {} : Object.fromEntries(Object.entries(given).map(([k, v]) => [k, Number(v)]));\n if (Object.keys(upgrader.stamp).some((id) => Number.isNaN(rowStamp[id]))) {\n unread.push(where);\n continue;\n }\n let result: UpgradeResult;\n try {\n if (!upgrader.behind(rowStamp)) continue;\n // A key the driver does not hand back exactly as stored (a timestamptz with microseconds) finds no row;\n // an update by it would have changed nothing either.\n const [current] = (await tx.query(`SELECT ${column} FROM ${table} WHERE ${byKey}`, store.key.map((k) => row[k]))).rows;\n if (current === undefined) {\n unread.push(where);\n continue;\n }\n result = upgrader.upgrade(current[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 unread.length === 0 ? { total: rows.length, upgraded, applied } : { total: rows.length, upgraded, applied, unread };\n });\n};\n"]}
|
package/dist/upgrade/index.cjs
CHANGED
|
@@ -1,26 +1,26 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var
|
|
4
|
-
require('../chunk-
|
|
3
|
+
var chunkI2CR5CBI_cjs = require('../chunk-I2CR5CBI.cjs');
|
|
4
|
+
require('../chunk-HTW4IEBC.cjs');
|
|
5
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
|
|
11
|
+
get: function () { return chunkI2CR5CBI_cjs.changedStrings; }
|
|
12
12
|
});
|
|
13
13
|
Object.defineProperty(exports, "planSourceUpgrade", {
|
|
14
14
|
enumerable: true,
|
|
15
|
-
get: function () { return
|
|
15
|
+
get: function () { return chunkI2CR5CBI_cjs.planSourceUpgrade; }
|
|
16
16
|
});
|
|
17
17
|
Object.defineProperty(exports, "renderReport", {
|
|
18
18
|
enumerable: true,
|
|
19
|
-
get: function () { return
|
|
19
|
+
get: function () { return chunkI2CR5CBI_cjs.renderReport; }
|
|
20
20
|
});
|
|
21
21
|
Object.defineProperty(exports, "verifySourceUpgrade", {
|
|
22
22
|
enumerable: true,
|
|
23
|
-
get: function () { return
|
|
23
|
+
get: function () { return chunkI2CR5CBI_cjs.verifySourceUpgrade; }
|
|
24
24
|
});
|
|
25
25
|
//# sourceMappingURL=index.cjs.map
|
|
26
26
|
//# sourceMappingURL=index.cjs.map
|
package/dist/upgrade/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
export { changedStrings, planSourceUpgrade, renderReport, verifySourceUpgrade } from '../chunk-
|
|
2
|
-
import '../chunk-
|
|
1
|
+
export { changedStrings, planSourceUpgrade, renderReport, verifySourceUpgrade } from '../chunk-QDZYRBRP.js';
|
|
2
|
+
import '../chunk-2G3DFR6P.js';
|
|
3
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.
|
|
3
|
+
"version": "0.2.0",
|
|
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/upgrade/index.ts"],"names":["StrataError","diffJson"],"mappings":"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","file":"chunk-564JCO6Q.cjs","sourcesContent":["import type { Stamp, Upgrader } from '../documents';\nimport { diffJson, type GrammarSchema } from '../check';\nimport { StrataError } from '../errors';\n\nexport type SourceDocument = { kind: string; id: string; document: unknown; file?: string };\n\nexport type PlannedDocument = {\n kind: string;\n id: string;\n file?: string;\n lookIn?: readonly string[];\n applied: readonly string[];\n changes: readonly string[];\n expected: unknown;\n};\n\nexport type SourcePlan = {\n from: Stamp;\n to: Stamp;\n migrations: readonly { ref: string; description: string }[];\n documents: readonly PlannedDocument[];\n untouched: readonly string[];\n problems: readonly string[];\n};\n\nconst keyOf = (doc: { kind: string; id: string }): string => `${doc.kind}:${doc.id}`;\n\nconst sortKeys = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(sortKeys);\n if (typeof value !== 'object' || value === null) return value;\n return Object.fromEntries(Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)).map(([k, v]) => [k, sortKeys(v)]));\n};\nconst sameJson = (a: unknown, b: unknown): boolean => JSON.stringify(sortKeys(a)) === JSON.stringify(sortKeys(b));\n\nexport const changedStrings = (before: unknown, after: unknown): string[] => {\n const found = new Set<string>();\n const visit = (a: unknown, b: unknown): void => {\n if (JSON.stringify(a) === JSON.stringify(b)) return;\n if (typeof a === 'string') {\n found.add(a);\n return;\n }\n if (Array.isArray(a)) {\n a.forEach((item, i) => visit(item, Array.isArray(b) ? b[i] : undefined));\n return;\n }\n if (typeof a === 'object' && a !== null) {\n for (const [k, v] of Object.entries(a)) visit(v, typeof b === 'object' && b !== null && !Array.isArray(b) ? Reflect.get(b, k) : undefined);\n }\n };\n visit(before, after);\n return [...found].filter((s) => s.length >= 4);\n};\n\nexport const planSourceUpgrade = async (options: {\n upgrader: Upgrader;\n stamp: Stamp;\n documents: readonly SourceDocument[];\n schemas?: Readonly<Record<string, GrammarSchema>>;\n describe: (ref: string) => string;\n}): Promise<SourcePlan> => {\n const { upgrader, stamp, documents, schemas, describe } = options;\n const seen = new Set<string>();\n const planned: PlannedDocument[] = [];\n const untouched: string[] = [];\n const problems: string[] = [];\n\n for (const doc of documents) {\n const key = keyOf(doc);\n if (seen.has(key)) throw new StrataError('INVALID_SEQUENCE', `Two artifacts are both ${key} — an artifact needs one identity to be planned.`);\n seen.add(key);\n const result = upgrader.upgrade(doc.document, { kind: doc.kind, stamp });\n if (sameJson(result.document, doc.document)) {\n untouched.push(key);\n continue;\n }\n planned.push({\n kind: doc.kind,\n id: doc.id,\n ...(doc.file === undefined ? {} : { file: doc.file }),\n applied: result.applied,\n changes: diffJson(doc.document, result.document),\n expected: result.document,\n });\n const schema = schemas?.[doc.kind];\n if (schema !== undefined) {\n const checked = await schema['~standard'].validate(result.document);\n if (checked.issues !== undefined) {\n problems.push(`${key}: the migrated artifact does not pass ${doc.kind}'s current schema — ${checked.issues.slice(0, 2).map((i) => i.message).join('; ')}`);\n }\n }\n }\n\n const from = stamp;\n const to = upgrader.stamp;\n const migrations = Object.entries(to).flatMap(([id, n]) =>\n Array.from({ length: Math.max(0, n - (from[id] ?? 0)) }, (_, i) => `${id}/${(from[id] ?? 0) + i + 1}`),\n );\n return {\n from,\n to,\n migrations: migrations.map((ref) => ({ ref, description: describe(ref) })),\n documents: planned.sort((a, b) => (keyOf(a) < keyOf(b) ? -1 : 1)),\n untouched: untouched.sort(),\n problems,\n };\n};\n\nexport type VerifyResult = {\n ok: boolean;\n lines: readonly { ok: boolean; text: string; detail?: readonly string[] }[];\n};\n\nexport const verifySourceUpgrade = (options: { plan: SourcePlan; upgrader: Upgrader; documents: readonly SourceDocument[] }): VerifyResult => {\n const { plan, upgrader, documents } = options;\n const now = new Map(documents.map((d) => [keyOf(d), d]));\n const lines: { ok: boolean; text: string; detail?: readonly string[] }[] = [];\n\n for (const want of plan.documents) {\n const key = keyOf(want);\n const got = now.get(key);\n if (got === undefined) {\n lines.push({ ok: false, text: `${key} is gone — the plan expected it rewritten, not removed` });\n } else if (sameJson(got.document, want.expected)) {\n lines.push({ ok: true, text: `${key} matches its migrated JSON` });\n } else {\n lines.push({ ok: false, text: `${key} does not match its migrated JSON yet`, detail: diffJson(got.document, want.expected, 12) });\n }\n }\n for (const key of plan.untouched) {\n const got = now.get(key);\n if (got === undefined) {\n lines.push({ ok: false, text: `${key} is gone — no migration asked for that` });\n continue;\n }\n const again = upgrader.upgrade(got.document, { kind: got.kind, stamp: plan.from });\n if (!sameJson(again.document, got.document)) {\n lines.push({ ok: false, text: `${key} was not in the plan, but the migrations would change it now`, detail: diffJson(got.document, again.document, 12) });\n }\n }\n const known = new Set([...plan.documents.map(keyOf), ...plan.untouched]);\n for (const key of now.keys()) {\n if (!known.has(key)) lines.push({ ok: false, text: `${key} is new since the plan — plan again so it is checked too` });\n }\n const ok = lines.every((l) => l.ok);\n if (ok) lines.push({ ok: true, text: `${plan.untouched.length} artifact(s) no migration touches, still untouched` });\n return { ok, lines };\n};\n\nexport const renderReport = (plan: SourcePlan, expectedPathOf: (doc: PlannedDocument) => string): string => {\n const stamp = (s: Stamp): string => Object.entries(s).map(([k, v]) => `${k} ${v}`).join(', ');\n const out: string[] = [\n '# strata upgrade',\n '',\n `The source is written at **${stamp(plan.from)}**; the installed grammars are at **${stamp(plan.to)}**.`,\n '',\n '## Migrations',\n '',\n ...plan.migrations.map((m) => `- \\`${m.ref}\\` — ${m.description}`),\n '',\n ];\n if (plan.problems.length > 0) {\n out.push('## Stop: a migration is wrong', '', 'These artifacts would not pass their current schema after migrating — no edit can make `verify` pass. Fix the migration, then plan again.', '', ...plan.problems.map((p) => `- ${p}`), '');\n }\n if (plan.documents.length === 0) {\n out.push('## Nothing to edit', '', `No artifact changes (${plan.untouched.length} checked). Run \\`verify\\` to move the lock.`, '');\n } else {\n out.push(\n `## ${plan.documents.length} artifact(s) to edit`,\n '',\n 'Edit each so that it serialises to EXACTLY its expected JSON (key order aside) — then run `verify`. Only what is listed changes; every other artifact must stay as it is.',\n '',\n );\n for (const doc of plan.documents) {\n out.push(`### \\`${doc.id}\\` (${doc.kind})`, '', doc.file === undefined ? '' : `- **File:** \\`${doc.file}\\``,\n doc.lookIn === undefined || doc.lookIn.length === 0 ? '' : `- **Look in:** ${doc.lookIn.map((f) => `\\`${f}\\``).join(', ')} — where the changing values are written`, `- **Migrations:** ${doc.applied.map((r) => `\\`${r}\\``).join(', ')}`, `- **Expected JSON:** \\`${expectedPathOf(doc)}\\``, '- **Changes:**', '', '```', ...doc.changes, '```', '');\n }\n }\n return out.filter((line, i, all) => !(line === '' && all[i - 1] === '')).join('\\n');\n};\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/upgrade/index.ts"],"names":[],"mappings":"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","file":"chunk-DGS4XJQQ.js","sourcesContent":["import type { Stamp, Upgrader } from '../documents';\nimport { diffJson, type GrammarSchema } from '../check';\nimport { StrataError } from '../errors';\n\nexport type SourceDocument = { kind: string; id: string; document: unknown; file?: string };\n\nexport type PlannedDocument = {\n kind: string;\n id: string;\n file?: string;\n lookIn?: readonly string[];\n applied: readonly string[];\n changes: readonly string[];\n expected: unknown;\n};\n\nexport type SourcePlan = {\n from: Stamp;\n to: Stamp;\n migrations: readonly { ref: string; description: string }[];\n documents: readonly PlannedDocument[];\n untouched: readonly string[];\n problems: readonly string[];\n};\n\nconst keyOf = (doc: { kind: string; id: string }): string => `${doc.kind}:${doc.id}`;\n\nconst sortKeys = (value: unknown): unknown => {\n if (Array.isArray(value)) return value.map(sortKeys);\n if (typeof value !== 'object' || value === null) return value;\n return Object.fromEntries(Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)).map(([k, v]) => [k, sortKeys(v)]));\n};\nconst sameJson = (a: unknown, b: unknown): boolean => JSON.stringify(sortKeys(a)) === JSON.stringify(sortKeys(b));\n\nexport const changedStrings = (before: unknown, after: unknown): string[] => {\n const found = new Set<string>();\n const visit = (a: unknown, b: unknown): void => {\n if (JSON.stringify(a) === JSON.stringify(b)) return;\n if (typeof a === 'string') {\n found.add(a);\n return;\n }\n if (Array.isArray(a)) {\n a.forEach((item, i) => visit(item, Array.isArray(b) ? b[i] : undefined));\n return;\n }\n if (typeof a === 'object' && a !== null) {\n for (const [k, v] of Object.entries(a)) visit(v, typeof b === 'object' && b !== null && !Array.isArray(b) ? Reflect.get(b, k) : undefined);\n }\n };\n visit(before, after);\n return [...found].filter((s) => s.length >= 4);\n};\n\nexport const planSourceUpgrade = async (options: {\n upgrader: Upgrader;\n stamp: Stamp;\n documents: readonly SourceDocument[];\n schemas?: Readonly<Record<string, GrammarSchema>>;\n describe: (ref: string) => string;\n}): Promise<SourcePlan> => {\n const { upgrader, stamp, documents, schemas, describe } = options;\n const seen = new Set<string>();\n const planned: PlannedDocument[] = [];\n const untouched: string[] = [];\n const problems: string[] = [];\n\n for (const doc of documents) {\n const key = keyOf(doc);\n if (seen.has(key)) throw new StrataError('INVALID_SEQUENCE', `Two artifacts are both ${key} — an artifact needs one identity to be planned.`);\n seen.add(key);\n const result = upgrader.upgrade(doc.document, { kind: doc.kind, stamp });\n if (sameJson(result.document, doc.document)) {\n untouched.push(key);\n continue;\n }\n planned.push({\n kind: doc.kind,\n id: doc.id,\n ...(doc.file === undefined ? {} : { file: doc.file }),\n applied: result.applied,\n changes: diffJson(doc.document, result.document),\n expected: result.document,\n });\n const schema = schemas?.[doc.kind];\n if (schema !== undefined) {\n const checked = await schema['~standard'].validate(result.document);\n if (checked.issues !== undefined) {\n problems.push(`${key}: the migrated artifact does not pass ${doc.kind}'s current schema — ${checked.issues.slice(0, 2).map((i) => i.message).join('; ')}`);\n }\n }\n }\n\n const from = stamp;\n const to = upgrader.stamp;\n const migrations = Object.entries(to).flatMap(([id, n]) =>\n Array.from({ length: Math.max(0, n - (from[id] ?? 0)) }, (_, i) => `${id}/${(from[id] ?? 0) + i + 1}`),\n );\n return {\n from,\n to,\n migrations: migrations.map((ref) => ({ ref, description: describe(ref) })),\n documents: planned.sort((a, b) => (keyOf(a) < keyOf(b) ? -1 : 1)),\n untouched: untouched.sort(),\n problems,\n };\n};\n\nexport type VerifyResult = {\n ok: boolean;\n lines: readonly { ok: boolean; text: string; detail?: readonly string[] }[];\n};\n\nexport const verifySourceUpgrade = (options: { plan: SourcePlan; upgrader: Upgrader; documents: readonly SourceDocument[] }): VerifyResult => {\n const { plan, upgrader, documents } = options;\n const now = new Map(documents.map((d) => [keyOf(d), d]));\n const lines: { ok: boolean; text: string; detail?: readonly string[] }[] = [];\n\n for (const want of plan.documents) {\n const key = keyOf(want);\n const got = now.get(key);\n if (got === undefined) {\n lines.push({ ok: false, text: `${key} is gone — the plan expected it rewritten, not removed` });\n } else if (sameJson(got.document, want.expected)) {\n lines.push({ ok: true, text: `${key} matches its migrated JSON` });\n } else {\n lines.push({ ok: false, text: `${key} does not match its migrated JSON yet`, detail: diffJson(got.document, want.expected, 12) });\n }\n }\n for (const key of plan.untouched) {\n const got = now.get(key);\n if (got === undefined) {\n lines.push({ ok: false, text: `${key} is gone — no migration asked for that` });\n continue;\n }\n const again = upgrader.upgrade(got.document, { kind: got.kind, stamp: plan.from });\n if (!sameJson(again.document, got.document)) {\n lines.push({ ok: false, text: `${key} was not in the plan, but the migrations would change it now`, detail: diffJson(got.document, again.document, 12) });\n }\n }\n const known = new Set([...plan.documents.map(keyOf), ...plan.untouched]);\n for (const key of now.keys()) {\n if (!known.has(key)) lines.push({ ok: false, text: `${key} is new since the plan — plan again so it is checked too` });\n }\n const ok = lines.every((l) => l.ok);\n if (ok) lines.push({ ok: true, text: `${plan.untouched.length} artifact(s) no migration touches, still untouched` });\n return { ok, lines };\n};\n\nexport const renderReport = (plan: SourcePlan, expectedPathOf: (doc: PlannedDocument) => string): string => {\n const stamp = (s: Stamp): string => Object.entries(s).map(([k, v]) => `${k} ${v}`).join(', ');\n const out: string[] = [\n '# strata upgrade',\n '',\n `The source is written at **${stamp(plan.from)}**; the installed grammars are at **${stamp(plan.to)}**.`,\n '',\n '## Migrations',\n '',\n ...plan.migrations.map((m) => `- \\`${m.ref}\\` — ${m.description}`),\n '',\n ];\n if (plan.problems.length > 0) {\n out.push('## Stop: a migration is wrong', '', 'These artifacts would not pass their current schema after migrating — no edit can make `verify` pass. Fix the migration, then plan again.', '', ...plan.problems.map((p) => `- ${p}`), '');\n }\n if (plan.documents.length === 0) {\n out.push('## Nothing to edit', '', `No artifact changes (${plan.untouched.length} checked). Run \\`verify\\` to move the lock.`, '');\n } else {\n out.push(\n `## ${plan.documents.length} artifact(s) to edit`,\n '',\n 'Edit each so that it serialises to EXACTLY its expected JSON (key order aside) — then run `verify`. Only what is listed changes; every other artifact must stay as it is.',\n '',\n );\n for (const doc of plan.documents) {\n out.push(`### \\`${doc.id}\\` (${doc.kind})`, '', doc.file === undefined ? '' : `- **File:** \\`${doc.file}\\``,\n doc.lookIn === undefined || doc.lookIn.length === 0 ? '' : `- **Look in:** ${doc.lookIn.map((f) => `\\`${f}\\``).join(', ')} — where the changing values are written`, `- **Migrations:** ${doc.applied.map((r) => `\\`${r}\\``).join(', ')}`, `- **Expected JSON:** \\`${expectedPathOf(doc)}\\``, '- **Changes:**', '', '```', ...doc.changes, '```', '');\n }\n }\n return out.filter((line, i, all) => !(line === '' && all[i - 1] === '')).join('\\n');\n};\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/documents.ts"],"names":[],"mappings":"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","file":"chunk-FNMGVPSA.js","sourcesContent":["import { prepare, orderPending, type PreparedMigration, type PreparedSequence } from './plan';\nimport type { DocumentKind, Sequence } from './schema';\nimport { StrataError } from './errors';\n\nexport type Stamp = Readonly<Record<string, number>>;\n\nexport type Location = { path: readonly (string | number)[]; kind: string; value: Record<string, unknown> };\n\nexport type Transform = (config: unknown, source: unknown) => unknown;\n\nexport type UpgradeResult = {\n document: Record<string, unknown>;\n stamp: Stamp;\n applied: readonly string[];\n};\n\nexport type Upgrader = {\n stamp: Stamp;\n upgrade: (document: unknown, options: { kind: string; stamp?: Stamp | null }) => UpgradeResult;\n locate: (document: unknown, kind: string) => Location[];\n behind: (stamp: Stamp | null | undefined) => boolean;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst pathText = (path: readonly (string | number)[]): string =>\n path.reduce<string>((text, key) => (typeof key === 'number' ? `${text}[${key}]` : text === '' ? key : `${text}.${key}`), '');\n\nconst reach = (value: unknown, pattern: string): { path: (string | number)[]; value: unknown }[] => {\n let frontier: { path: (string | number)[]; value: unknown }[] = [{ path: [], value }];\n for (const segment of pattern.split('.')) {\n const array = segment.endsWith('[]');\n const key = array ? segment.slice(0, -2) : segment;\n const next: { path: (string | number)[]; value: unknown }[] = [];\n for (const at of frontier) {\n if (!isRecord(at.value)) continue;\n const found: { path: (string | number)[]; value: unknown }[] =\n key === '*'\n ? Object.entries(at.value).map(([k, v]) => ({ path: [...at.path, k], value: v }))\n : key in at.value\n ? [{ path: [...at.path, key], value: at.value[key] }]\n : [];\n for (const f of found) {\n if (!array) next.push(f);\n else if (Array.isArray(f.value)) f.value.forEach((item, i) => next.push({ path: [...f.path, i], value: item }));\n }\n }\n frontier = next;\n }\n return frontier;\n};\n\nconst getAt = (root: unknown, path: readonly (string | number)[]): unknown =>\n path.reduce<unknown>((at, key) => {\n if (typeof key === 'number') return Array.isArray(at) ? at[key] : undefined;\n return isRecord(at) ? at[key] : undefined;\n }, root);\n\nconst setAt = (root: unknown, path: readonly (string | number)[], value: unknown): unknown => {\n const [head, ...rest] = path;\n if (head === undefined) return value;\n if (typeof head === 'number' && Array.isArray(root)) return root.map((item, i) => (i === head ? setAt(item, rest, value) : item));\n if (typeof head === 'string' && isRecord(root)) return { ...root, [head]: setAt(root[head], rest, value) };\n return root;\n};\n\nexport const createUpgrader = async (sequences: readonly Sequence[], options: { transform: Transform }): Promise<Upgrader> => {\n const prepared = await prepare(sequences);\n const tables = prepared.filter((s) => !s.grammar);\n if (tables.length > 0) {\n throw new StrataError(\n 'WRONG_OWNER',\n 'Documents are upgraded by grammar sequences; these own tables and belong to a database\\'s ledger (`migrate`). If one of them is a grammar, declare its `documents` — a sequence with no `documents` and no document step is read as owning tables.',\n tables.map((s) => s.id),\n );\n }\n const grammars: readonly PreparedSequence[] = prepared;\n\n const kinds = new Map<string, DocumentKind>();\n for (const sequence of grammars) {\n for (const [name, kind] of Object.entries(sequence.documents)) kinds.set(`${sequence.id}/${name}`, kind);\n }\n const unknown = [\n ...grammars.flatMap((s) => s.migrations.flatMap((m) => m.steps.flatMap((step) => (step.kind === 'document' && !kinds.has(step.at) ? [`${m.ref} rewrites ${step.at}`] : [])))),\n ...[...kinds].flatMap(([ref, kind]) => Object.entries(kind.embeds ?? {}).flatMap(([path, target]) => (kinds.has(target) ? [] : [`${ref} embeds ${target} at ${path}`]))),\n ];\n if (unknown.length > 0) throw new StrataError('UNKNOWN_KIND', 'A document kind is named that no sequence declares.', unknown);\n\n const stamp: Stamp = Object.fromEntries(grammars.map((s) => [s.id, s.migrations.length]));\n\n // The document's entries for grammars this code was not given are kept:\n // dropping them would let code that has the grammar run its migrations over\n // the document a second time.\n const ownIds = new Set(grammars.map((s) => s.id));\n const stampAfter = (given: Stamp | null | undefined): Stamp => {\n const others = Object.entries(given ?? {}).filter(([id]) => !ownIds.has(id));\n return others.length === 0 ? stamp : { ...stamp, ...Object.fromEntries(others) };\n };\n\n const locate = (document: unknown, kind: string): Location[] => {\n if (!kinds.has(kind)) throw new StrataError('UNKNOWN_KIND', `No sequence declares the document kind \"${kind}\".`, [...kinds.keys()]);\n const found: Location[] = [];\n const visit = (value: unknown, at: string, path: (string | number)[]): void => {\n if (!isRecord(value)) return;\n found.push({ path, kind: at, value });\n for (const [pattern, target] of Object.entries(kinds.get(at)?.embeds ?? {})) {\n for (const hit of reach(value, pattern)) visit(hit.value, target, [...path, ...hit.path]);\n }\n };\n visit(document, kind, []);\n return found;\n };\n\n const positionOf = (given: Stamp | null | undefined, id: string): number => given?.[id] ?? 0;\n\n const behind = (given: Stamp | null | undefined): boolean => {\n const ahead = grammars.filter((s) => positionOf(given, s.id) > s.migrations.length);\n if (ahead.length > 0) {\n throw new StrataError(\n 'TOO_NEW',\n 'This document was written by newer code than this — reading it would be guessing.',\n ahead.map((s) => `${s.id}: the document is at ${positionOf(given, s.id)}, this code knows ${s.migrations.length}`),\n );\n }\n return grammars.some((s) => positionOf(given, s.id) < s.migrations.length);\n };\n\n const upgrade = (document: unknown, { kind, stamp: given }: { kind: string; stamp?: Stamp | null }): UpgradeResult => {\n if (!isRecord(document)) throw new StrataError('STEP_FAILED', `A ${kind} document must be a JSON object.`);\n if (!kinds.has(kind)) throw new StrataError('UNKNOWN_KIND', `No sequence declares the document kind \"${kind}\".`, [...kinds.keys()]);\n if (!behind(given)) return { document, stamp: stampAfter(given), applied: [] };\n\n const done = new Set(grammars.flatMap((s) => s.migrations.filter((m) => m.n <= positionOf(given, s.id)).map((m) => m.ref)));\n const { pending, stuck } = orderPending(\n grammars.map((s) => ({ waiting: s.migrations.filter((m) => !done.has(m.ref)) })),\n done,\n );\n if (stuck.length > 0) throw new StrataError('CYCLE', 'Document migrations wait on each other and can never run.', stuck.map((m) => m.ref));\n\n let current: Record<string, unknown> = document;\n const applied: string[] = [];\n const runStep = (migration: PreparedMigration, at: string, transform: unknown): void => {\n // Deepest first: a parent's rewrite sees its children already rewritten,\n // and replacing a child never moves the path to its parent.\n const targets = locate(current, kind)\n .filter((l) => l.kind === at)\n .sort((a, b) => b.path.length - a.path.length);\n for (const target of targets) {\n // Read from `current`, not `target.value`: a child rewritten a moment\n // ago lives in `current`, and the parent must see and keep it.\n const value = getAt(current, target.path);\n let rewritten: unknown;\n try {\n rewritten = options.transform(transform, { document: value, path: pathText(target.path) });\n } catch (cause) {\n throw new StrataError(\n 'STEP_FAILED',\n `${migration.ref} (\"${migration.description}\") failed on the ${at} at ${pathText(target.path) || '(root)'}.`,\n [cause instanceof Error ? cause.message : String(cause)],\n { cause },\n );\n }\n if (!isRecord(rewritten)) {\n throw new StrataError('STEP_FAILED', `${migration.ref} turned the ${at} at ${pathText(target.path) || '(root)'} into something that is not a document.`, [\n JSON.stringify(rewritten)?.slice(0, 200) ?? String(rewritten),\n ]);\n }\n const next = setAt(current, target.path, rewritten);\n if (isRecord(next)) current = next;\n }\n };\n for (const migration of pending) {\n for (const step of migration.steps) if (step.kind === 'document') runStep(migration, step.at, step.transform);\n applied.push(migration.ref);\n }\n return { document: current, stamp: stampAfter(given), applied };\n };\n\n return { stamp, upgrade, locate, behind };\n};\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/documents.ts"],"names":["prepare","StrataError","orderPending"],"mappings":"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","file":"chunk-FSEUYRLN.cjs","sourcesContent":["import { prepare, orderPending, type PreparedMigration, type PreparedSequence } from './plan';\nimport type { DocumentKind, Sequence } from './schema';\nimport { StrataError } from './errors';\n\nexport type Stamp = Readonly<Record<string, number>>;\n\nexport type Location = { path: readonly (string | number)[]; kind: string; value: Record<string, unknown> };\n\nexport type Transform = (config: unknown, source: unknown) => unknown;\n\nexport type UpgradeResult = {\n document: Record<string, unknown>;\n stamp: Stamp;\n applied: readonly string[];\n};\n\nexport type Upgrader = {\n stamp: Stamp;\n upgrade: (document: unknown, options: { kind: string; stamp?: Stamp | null }) => UpgradeResult;\n locate: (document: unknown, kind: string) => Location[];\n behind: (stamp: Stamp | null | undefined) => boolean;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst pathText = (path: readonly (string | number)[]): string =>\n path.reduce<string>((text, key) => (typeof key === 'number' ? `${text}[${key}]` : text === '' ? key : `${text}.${key}`), '');\n\nconst reach = (value: unknown, pattern: string): { path: (string | number)[]; value: unknown }[] => {\n let frontier: { path: (string | number)[]; value: unknown }[] = [{ path: [], value }];\n for (const segment of pattern.split('.')) {\n const array = segment.endsWith('[]');\n const key = array ? segment.slice(0, -2) : segment;\n const next: { path: (string | number)[]; value: unknown }[] = [];\n for (const at of frontier) {\n if (!isRecord(at.value)) continue;\n const found: { path: (string | number)[]; value: unknown }[] =\n key === '*'\n ? Object.entries(at.value).map(([k, v]) => ({ path: [...at.path, k], value: v }))\n : key in at.value\n ? [{ path: [...at.path, key], value: at.value[key] }]\n : [];\n for (const f of found) {\n if (!array) next.push(f);\n else if (Array.isArray(f.value)) f.value.forEach((item, i) => next.push({ path: [...f.path, i], value: item }));\n }\n }\n frontier = next;\n }\n return frontier;\n};\n\nconst getAt = (root: unknown, path: readonly (string | number)[]): unknown =>\n path.reduce<unknown>((at, key) => {\n if (typeof key === 'number') return Array.isArray(at) ? at[key] : undefined;\n return isRecord(at) ? at[key] : undefined;\n }, root);\n\nconst setAt = (root: unknown, path: readonly (string | number)[], value: unknown): unknown => {\n const [head, ...rest] = path;\n if (head === undefined) return value;\n if (typeof head === 'number' && Array.isArray(root)) return root.map((item, i) => (i === head ? setAt(item, rest, value) : item));\n if (typeof head === 'string' && isRecord(root)) return { ...root, [head]: setAt(root[head], rest, value) };\n return root;\n};\n\nexport const createUpgrader = async (sequences: readonly Sequence[], options: { transform: Transform }): Promise<Upgrader> => {\n const prepared = await prepare(sequences);\n const tables = prepared.filter((s) => !s.grammar);\n if (tables.length > 0) {\n throw new StrataError(\n 'WRONG_OWNER',\n 'Documents are upgraded by grammar sequences; these own tables and belong to a database\\'s ledger (`migrate`). If one of them is a grammar, declare its `documents` — a sequence with no `documents` and no document step is read as owning tables.',\n tables.map((s) => s.id),\n );\n }\n const grammars: readonly PreparedSequence[] = prepared;\n\n const kinds = new Map<string, DocumentKind>();\n for (const sequence of grammars) {\n for (const [name, kind] of Object.entries(sequence.documents)) kinds.set(`${sequence.id}/${name}`, kind);\n }\n const unknown = [\n ...grammars.flatMap((s) => s.migrations.flatMap((m) => m.steps.flatMap((step) => (step.kind === 'document' && !kinds.has(step.at) ? [`${m.ref} rewrites ${step.at}`] : [])))),\n ...[...kinds].flatMap(([ref, kind]) => Object.entries(kind.embeds ?? {}).flatMap(([path, target]) => (kinds.has(target) ? [] : [`${ref} embeds ${target} at ${path}`]))),\n ];\n if (unknown.length > 0) throw new StrataError('UNKNOWN_KIND', 'A document kind is named that no sequence declares.', unknown);\n\n const stamp: Stamp = Object.fromEntries(grammars.map((s) => [s.id, s.migrations.length]));\n\n // The document's entries for grammars this code was not given are kept:\n // dropping them would let code that has the grammar run its migrations over\n // the document a second time.\n const ownIds = new Set(grammars.map((s) => s.id));\n const stampAfter = (given: Stamp | null | undefined): Stamp => {\n const others = Object.entries(given ?? {}).filter(([id]) => !ownIds.has(id));\n return others.length === 0 ? stamp : { ...stamp, ...Object.fromEntries(others) };\n };\n\n const locate = (document: unknown, kind: string): Location[] => {\n if (!kinds.has(kind)) throw new StrataError('UNKNOWN_KIND', `No sequence declares the document kind \"${kind}\".`, [...kinds.keys()]);\n const found: Location[] = [];\n const visit = (value: unknown, at: string, path: (string | number)[]): void => {\n if (!isRecord(value)) return;\n found.push({ path, kind: at, value });\n for (const [pattern, target] of Object.entries(kinds.get(at)?.embeds ?? {})) {\n for (const hit of reach(value, pattern)) visit(hit.value, target, [...path, ...hit.path]);\n }\n };\n visit(document, kind, []);\n return found;\n };\n\n const positionOf = (given: Stamp | null | undefined, id: string): number => given?.[id] ?? 0;\n\n const behind = (given: Stamp | null | undefined): boolean => {\n const ahead = grammars.filter((s) => positionOf(given, s.id) > s.migrations.length);\n if (ahead.length > 0) {\n throw new StrataError(\n 'TOO_NEW',\n 'This document was written by newer code than this — reading it would be guessing.',\n ahead.map((s) => `${s.id}: the document is at ${positionOf(given, s.id)}, this code knows ${s.migrations.length}`),\n );\n }\n return grammars.some((s) => positionOf(given, s.id) < s.migrations.length);\n };\n\n const upgrade = (document: unknown, { kind, stamp: given }: { kind: string; stamp?: Stamp | null }): UpgradeResult => {\n if (!isRecord(document)) throw new StrataError('STEP_FAILED', `A ${kind} document must be a JSON object.`);\n if (!kinds.has(kind)) throw new StrataError('UNKNOWN_KIND', `No sequence declares the document kind \"${kind}\".`, [...kinds.keys()]);\n if (!behind(given)) return { document, stamp: stampAfter(given), applied: [] };\n\n const done = new Set(grammars.flatMap((s) => s.migrations.filter((m) => m.n <= positionOf(given, s.id)).map((m) => m.ref)));\n const { pending, stuck } = orderPending(\n grammars.map((s) => ({ waiting: s.migrations.filter((m) => !done.has(m.ref)) })),\n done,\n );\n if (stuck.length > 0) throw new StrataError('CYCLE', 'Document migrations wait on each other and can never run.', stuck.map((m) => m.ref));\n\n let current: Record<string, unknown> = document;\n const applied: string[] = [];\n const runStep = (migration: PreparedMigration, at: string, transform: unknown): void => {\n // Deepest first: a parent's rewrite sees its children already rewritten,\n // and replacing a child never moves the path to its parent.\n const targets = locate(current, kind)\n .filter((l) => l.kind === at)\n .sort((a, b) => b.path.length - a.path.length);\n for (const target of targets) {\n // Read from `current`, not `target.value`: a child rewritten a moment\n // ago lives in `current`, and the parent must see and keep it.\n const value = getAt(current, target.path);\n let rewritten: unknown;\n try {\n rewritten = options.transform(transform, { document: value, path: pathText(target.path) });\n } catch (cause) {\n throw new StrataError(\n 'STEP_FAILED',\n `${migration.ref} (\"${migration.description}\") failed on the ${at} at ${pathText(target.path) || '(root)'}.`,\n [cause instanceof Error ? cause.message : String(cause)],\n { cause },\n );\n }\n if (!isRecord(rewritten)) {\n throw new StrataError('STEP_FAILED', `${migration.ref} turned the ${at} at ${pathText(target.path) || '(root)'} into something that is not a document.`, [\n JSON.stringify(rewritten)?.slice(0, 200) ?? String(rewritten),\n ]);\n }\n const next = setAt(current, target.path, rewritten);\n if (isRecord(next)) current = next;\n }\n };\n for (const migration of pending) {\n for (const step of migration.steps) if (step.kind === 'document') runStep(migration, step.at, step.transform);\n applied.push(migration.ref);\n }\n return { document: current, stamp: stampAfter(given), applied };\n };\n\n return { stamp, upgrade, locate, behind };\n};\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/schema.ts","../src/checksum.ts","../src/plan.ts"],"names":["z","StrataError"],"mappings":";;;;;AAEO,IAAM,WAAA,GAAc;AAEpB,IAAM,aAAA,GAAgB;AAEtB,IAAM,SAAA,GAAY;AAClB,IAAM,QAAA,GAAW;AAKjB,IAAM,UAAA,GAAa;AAEnB,IAAM,aAAA,GAAgBA,MAC1B,MAAA,CAAO;AAAA,EACN,IAAA,EAAMA,KAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAAA,EACrB,KAAKA,KAAA,CACF,MAAA,EAAO,CACP,GAAA,CAAI,CAAC,CAAA,CACL,QAAA;AAAA,IACC;AAAA;AAGN,CAAC,CAAA,CACA,MAAA,EAAO,CACP,QAAA,CAAS,yEAAyE;AAE9E,IAAM,kBAAA,GAAqBA,MAC/B,MAAA,CAAO;AAAA,EACN,IAAA,EAAMA,KAAA,CAAE,OAAA,CAAQ,UAAU,CAAA;AAAA,EAC1B,EAAA,EAAIA,MACD,MAAA,EAAO,CACP,MAAM,QAAQ,CAAA,CACd,SAAS,0GAAqG,CAAA;AAAA,EACjH,SAAA,EAAWA,KAAA,CACR,OAAA,EAAQ,CACR,QAAA;AAAA,IACC;AAAA;AAIN,CAAC,CAAA,CACA,MAAA,EAAO,CACP,QAAA,CAAS,iDAAiD;AAEtD,IAAM,aAAaA,KAAA,CAAE,kBAAA,CAAmB,QAAQ,CAAC,aAAA,EAAe,kBAAkB,CAAC;AAEnF,IAAM,kBAAA,GAAqBA,MAC/B,MAAA,CAAO;AAAA,EACN,QAAQA,KAAA,CACL,MAAA,CAAOA,MAAE,MAAA,EAAO,CAAE,MAAM,UAAU,CAAA,EAAGA,MAAE,MAAA,EAAO,CAAE,MAAM,QAAQ,CAAC,EAC/D,QAAA,EAAS,CACT,SAAS,0GAAqG;AACnH,CAAC,EACA,MAAA;AAEI,IAAM,eAAA,GAAkBA,MAC5B,MAAA,CAAO;AAAA,EACN,WAAA,EAAaA,MACV,MAAA,EAAO,CACP,IAAI,CAAC,CAAA,CACL,SAAS,gGAAiG,CAAA;AAAA,EAC7G,KAAA,EAAOA,KAAA,CACJ,KAAA,CAAM,UAAU,CAAA,CAChB,QAAA;AAAA,IACC;AAAA,GAEF;AAAA,EACF,SAAA,EAAWA,KAAA,CACR,KAAA,CAAMA,KAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,aAAa,CAAC,CAAA,CACrC,QAAA,EAAS,CACT,SAAS,qFAAqF;AACnG,CAAC,EACA,MAAA;AAEI,IAAM,cAAA,GAAiBA,MAC3B,MAAA,CAAO;AAAA,EACN,EAAA,EAAIA,MAAE,MAAA,EAAO,CAAE,MAAM,WAAW,CAAA,CAAE,SAAS,iEAAiE,CAAA;AAAA,EAC5G,SAAA,EAAWA,KAAA,CACR,MAAA,CAAOA,KAAA,CAAE,QAAO,CAAE,KAAA,CAAM,SAAS,CAAA,EAAG,kBAAkB,CAAA,CACtD,QAAA,EAAS,CACT,SAAS,iGAAiG,CAAA;AAAA,EAC7G,YAAYA,KAAA,CACT,KAAA,CAAM,eAAe,CAAA,CACrB,SAAS,sGAAuG;AACrH,CAAC,EACA,MAAA,EAAO,CAGP,WAAA,CAAY,CAAC,UAAU,GAAA,KAAQ;AAC9B,EAAA,MAAM,QAAQ,IAAI,GAAA,CAAI,QAAA,CAAS,UAAA,CAAW,QAAQ,CAAC,CAAA,KAAM,CAAA,CAAE,KAAA,CAAM,IAAI,CAAC,CAAA,KAAM,CAAA,CAAE,IAAI,CAAC,CAAC,CAAA;AACpF,EAAA,IAAI,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,KAAM,KAAA,CAAM,IAAI,UAAU,CAAA,IAAK,QAAA,CAAS,SAAA,KAAc,MAAA,CAAA,EAAY;AACnF,IAAA,GAAA,CAAI,QAAA,CAAS;AAAA,MACX,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS;AAAA,KACV,CAAA;AAAA,EACH;AACF,CAAC;;;AChGH,IAAM,SAAA,GAAY,CAAC,KAAA,KAA2B;AAC5C,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG,OAAO,CAAA,CAAA,EAAI,KAAA,CAAM,GAAA,CAAI,SAAS,CAAA,CAAE,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA,CAAA;AACnE,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,QAAA,EAAU;AAC/C,IAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,CACjC,MAAA,CAAO,CAAC,GAAG,CAAC,CAAA,KAAM,CAAA,KAAM,MAAS,CAAA,CACjC,IAAA,CAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAO,CAAA,GAAI,CAAA,GAAI,EAAA,GAAK,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAE,CAAA;AAClD,IAAA,OAAO,CAAA,CAAA,EAAI,QAAQ,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,MAAM,CAAA,EAAG,IAAA,CAAK,UAAU,CAAC,CAAC,IAAI,SAAA,CAAU,CAAC,CAAC,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA,CAAA;AAAA,EACtF;AACA,EAAA,OAAO,IAAA,CAAK,UAAU,KAAK,CAAA;AAC7B,CAAA;AAEA,IAAM,QAAA,GAAW,CAAC,GAAA,KAChB,GAAA,CACG,KAAA,CAAM,IAAI,CAAA,CACV,MAAA,CAAO,CAAC,IAAA,KAAS,CAAC,IAAA,CAAK,SAAA,EAAU,CAAE,UAAA,CAAW,IAAI,CAAC,CAAA,CACnD,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,OAAA,EAAS,CAAA,CAC5B,IAAA,CAAK,IAAI,CAAA,CACT,IAAA,EAAK;AAEH,IAAM,UAAA,GAAa,OAAO,SAAA,KAA0C;AACzE,EAAA,MAAM,QAAQ,SAAA,CAAU,KAAA,CAAM,IAAI,CAAC,IAAA,KAAU,KAAK,IAAA,KAAS,KAAA,GAAQ,EAAE,GAAG,MAAM,GAAA,EAAK,QAAA,CAAS,KAAK,GAAG,CAAA,KAAM,IAAK,CAAA;AAC/G,EAAA,MAAM,QAAQ,IAAI,WAAA,GAAc,MAAA,CAAO,SAAA,CAAU,KAAK,CAAC,CAAA;AACvD,EAAA,MAAM,SAAS,MAAM,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,WAAW,KAAK,CAAA;AAC1D,EAAA,OAAO,MAAM,IAAA,CAAK,IAAI,WAAW,MAAM,CAAA,EAAG,CAAC,CAAA,KAAM,CAAA,CAAE,QAAA,CAAS,EAAE,EAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAE,KAAK,EAAE,CAAA;AAC3F;;;ACKA,IAAM,QAAQ,CAAC,QAAA,EAAkB,MAAsB,CAAA,EAAG,QAAQ,IAAI,CAAC,CAAA,CAAA;AAEhE,IAAM,OAAA,GAAU,OAAO,SAAA,KAAyE;AACrG,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,MAAM,WAA+B,EAAC;AACtC,EAAA,KAAA,MAAW,SAAS,SAAA,EAAW;AAC7B,IAAA,MAAM,MAAA,GAAS,cAAA,CAAe,SAAA,CAAU,KAAK,CAAA;AAC7C,IAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,MAAA,MAAM,SAAS,MAAA,CAAO,KAAA,CAAM,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAA,IAAK,QAAQ,CAAA,EAAA,EAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA;AAC7F,MAAA,MAAM,IAAIC,6BAAA,CAAY,kBAAA,EAAoB,CAAA,yBAAA,EAA4B,OAAO,KAAA,CAAM,EAAA,KAAO,QAAA,GAAW,CAAA,GAAA,EAAM,KAAA,CAAM,EAAE,CAAA,EAAA,CAAA,GAAO,EAAE,KAAK,MAAM,CAAA;AAAA,IACzI;AACA,IAAA,MAAM,WAAW,MAAA,CAAO,IAAA;AACxB,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,QAAA,CAAS,EAAE,CAAA,EAAG;AACzB,MAAA,MAAM,IAAIA,6BAAA,CAAY,kBAAA,EAAoB,CAAA,+BAAA,EAAkC,QAAA,CAAS,EAAE,CAAA,uCAAA,CAAoC,CAAA;AAAA,IAC7H;AACA,IAAA,IAAA,CAAK,GAAA,CAAI,SAAS,EAAE,CAAA;AACpB,IAAA,MAAM,aAAkC,EAAC;AACzC,IAAA,KAAA,MAAW,CAAC,KAAA,EAAO,SAAS,KAAK,QAAA,CAAS,UAAA,CAAW,SAAQ,EAAG;AAC9D,MAAA,MAAM,IAAI,KAAA,GAAQ,CAAA;AAClB,MAAA,UAAA,CAAW,IAAA,CAAK;AAAA,QACd,UAAU,QAAA,CAAS,EAAA;AAAA,QACnB,CAAA;AAAA,QACA,GAAA,EAAK,KAAA,CAAM,QAAA,CAAS,EAAA,EAAI,CAAC,CAAA;AAAA,QACzB,aAAa,SAAA,CAAU,WAAA;AAAA,QACvB,QAAA,EAAU,MAAM,UAAA,CAAW,SAAS,CAAA;AAAA,QACpC,OAAO,SAAA,CAAU,KAAA;AAAA,QACjB,SAAA,EAAW,SAAA,CAAU,SAAA,IAAa;AAAC,OACpC,CAAA;AAAA,IACH;AACA,IAAA,MAAM,UAAU,QAAA,CAAS,SAAA,KAAc,MAAA,IAAa,QAAA,CAAS,WAAW,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,IAAA,CAAK,CAAC,MAAM,CAAA,CAAE,IAAA,KAAS,UAAU,CAAC,CAAA;AAC9H,IAAA,QAAA,CAAS,IAAA,CAAK,EAAE,EAAA,EAAI,QAAA,CAAS,EAAA,EAAI,OAAA,EAAS,SAAA,EAAW,QAAA,CAAS,SAAA,IAAa,EAAC,EAAG,UAAA,EAAY,CAAA;AAAA,EAC7F;AACA,EAAA,OAAO,QAAA;AACT;AAEO,IAAM,YAAA,GAAe,CAC1B,MAAA,EACA,WAAA,KACiE;AACjE,EAAA,MAAM,IAAA,GAAO,IAAI,GAAA,CAAI,WAAW,CAAA;AAChC,EAAA,MAAM,OAAA,GAAU,OAAO,GAAA,CAAI,CAAC,MAAM,CAAC,GAAG,CAAA,CAAE,OAAO,CAAC,CAAA;AAChD,EAAA,MAAM,UAA+B,EAAC;AACtC,EAAA,IAAI,KAAA,GAAQ,IAAA;AACZ,EAAA,OAAO,KAAA,EAAO;AACZ,IAAA,KAAA,GAAQ,KAAA;AACR,IAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,MAAA,KAAA,IAAS,IAAA,GAAO,MAAM,CAAC,CAAA,EAAG,SAAS,MAAA,EAAW,IAAA,GAAO,KAAA,CAAM,CAAC,CAAA,EAAG;AAC7D,QAAA,IAAI,CAAC,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,CAAC,MAAM,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG;AAC/C,QAAA,OAAA,CAAQ,KAAK,IAAI,CAAA;AACjB,QAAA,IAAA,CAAK,GAAA,CAAI,KAAK,GAAG,CAAA;AACjB,QAAA,KAAA,CAAM,KAAA,EAAM;AACZ,QAAA,KAAA,GAAQ,IAAA;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACA,EAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,OAAA,CAAQ,MAAK,EAAE;AAC1C;AAOO,IAAM,iBAAiB,CAAC,SAAA,EAAwC,MAAA,EAA8B,OAAA,GAAuB,EAAC,KAAY;AACvI,EAAA,MAAM,WAAsB,EAAC;AAC7B,EAAA,MAAM,UAAkC,EAAC;AACzC,EAAA,MAAM,IAAA,GAAO,IAAI,GAAA,CAAI,MAAA,CAAO,GAAA,CAAI,CAAC,GAAA,KAAQ,KAAA,CAAM,GAAA,CAAI,QAAA,EAAU,GAAA,CAAI,CAAC,CAAC,CAAC,CAAA;AACpE,EAAA,MAAM,QAAQ,IAAI,GAAA,CAAI,MAAA,CAAO,GAAA,CAAI,CAAC,GAAA,KAAQ,CAAC,KAAA,CAAM,GAAA,CAAI,UAAU,GAAA,CAAI,CAAC,CAAA,EAAG,GAAG,CAAC,CAAC,CAAA;AAE5E,EAAA,MAAM,SAAyD,EAAC;AAChE,EAAA,KAAA,MAAW,YAAY,SAAA,EAAW;AAChC,IAAA,MAAM,IAAA,GAAO,OAAO,MAAA,CAAO,CAAC,QAAQ,GAAA,CAAI,QAAA,KAAa,SAAS,EAAE,CAAA;AAChE,IAAA,OAAA,CAAQ,QAAA,CAAS,EAAE,CAAA,GAAI,IAAA,CAAK,MAAA;AAE5B,IAAA,MAAM,MAAA,GAAS,KAAK,MAAA,CAAO,CAAC,QAAQ,GAAA,CAAI,CAAA,GAAI,QAAA,CAAS,UAAA,CAAW,MAAM,CAAA;AACtE,IAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,MAAA,QAAA,CAAS,IAAA,CAAK;AAAA,QACZ,IAAA,EAAM,SAAA;AAAA,QACN,QAAQ,CAAA,EAAG,QAAA,CAAS,EAAE,CAAA,qBAAA,EAAwB,IAAA,CAAK,IAAI,GAAG,IAAA,CAAK,IAAI,CAAC,CAAA,KAAM,EAAE,CAAC,CAAC,CAAC,CAAA,kBAAA,EAAqB,QAAA,CAAS,WAAW,MAAM,CAAA,sCAAA;AAAA,OAC/H,CAAA;AAAA,IACH;AAEA,IAAA,MAAM,UAA+B,EAAC;AACtC,IAAA,KAAA,MAAW,SAAA,IAAa,SAAS,UAAA,EAAY;AAC3C,MAAA,MAAM,GAAA,GAAM,KAAA,CAAM,GAAA,CAAI,SAAA,CAAU,GAAG,CAAA;AACnC,MAAA,IAAI,QAAQ,MAAA,EAAW;AACrB,QAAA,OAAA,CAAQ,KAAK,SAAS,CAAA;AAAA,MACxB,CAAA,MAAA,IAAW,GAAA,CAAI,QAAA,KAAa,SAAA,CAAU,QAAA,EAAU;AAC9C,QAAA,QAAA,CAAS,IAAA,CAAK;AAAA,UACZ,IAAA,EAAM,QAAA;AAAA,UACN,MAAA,EAAQ,GAAG,SAAA,CAAU,GAAG,MAAM,SAAA,CAAU,WAAW,CAAA,eAAA,EAAkB,GAAA,CAAI,SAAS,CAAA,2FAAA;AAAA,SACnF,CAAA;AAAA,MACH;AAAA,IACF;AACA,IAAA,MAAM,YAAA,GAAe,QAAQ,CAAC,CAAA;AAC9B,IAAA,IAAI,YAAA,KAAiB,MAAA,IAAa,IAAA,CAAK,IAAA,CAAK,CAAC,QAAQ,GAAA,CAAI,CAAA,GAAI,YAAA,CAAa,CAAC,CAAA,EAAG;AAC5E,MAAA,QAAA,CAAS,IAAA,CAAK,EAAE,IAAA,EAAM,QAAA,EAAU,MAAA,EAAQ,CAAA,EAAG,QAAA,CAAS,EAAE,CAAA,EAAA,EAAK,YAAA,CAAa,GAAG,CAAA,sDAAA,CAAA,EAA0D,CAAA;AAAA,IACvI;AACA,IAAA,MAAA,CAAO,KAAK,EAAE,EAAA,EAAI,QAAA,CAAS,EAAA,EAAI,SAAS,CAAA;AAAA,EAC1C;AAEA,EAAA,IAAI,OAAA,CAAQ,aAAa,IAAA,EAAM;AAC7B,IAAA,MAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,SAAA,CAAU,IAAI,CAAC,CAAA,KAAM,CAAA,CAAE,EAAE,CAAC,CAAA;AAChD,IAAA,MAAM,OAAA,GAAU,CAAC,GAAG,IAAI,IAAI,MAAA,CAAO,GAAA,CAAI,CAAC,GAAA,KAAQ,GAAA,CAAI,QAAQ,CAAC,CAAC,EAAE,MAAA,CAAO,CAAC,OAAO,CAAC,KAAA,CAAM,GAAA,CAAI,EAAE,CAAC,CAAA;AAC7F,IAAA,KAAA,MAAW,MAAM,OAAA,EAAS;AACxB,MAAA,MAAM,KAAA,GAAQ,OAAO,MAAA,CAAO,CAAC,QAAQ,GAAA,CAAI,QAAA,KAAa,EAAE,CAAA,CAAE,MAAA;AAC1D,MAAA,QAAA,CAAS,IAAA,CAAK;AAAA,QACZ,IAAA,EAAM,kBAAA;AAAA,QACN,MAAA,EACE,GAAG,EAAE,CAAA,uBAAA,EAA0B,KAAK,CAAA,iBAAA,EAAoB,KAAA,KAAU,CAAA,GAAI,EAAA,GAAK,GAAG,CAAA,0MAAA;AAAA,OAGjF,CAAA;AAAA,IACH;AAAA,EACF;AAEA,EAAA,MAAM,QAAA,GAAW,IAAI,GAAA,CAAI,SAAA,CAAU,QAAQ,CAAC,CAAA,KAAM,CAAA,CAAE,UAAA,CAAW,IAAI,CAAC,CAAA,KAAM,CAAA,CAAE,GAAG,CAAC,CAAC,CAAA;AACjF,EAAA,KAAA,MAAW,EAAE,OAAA,EAAQ,IAAK,MAAA,EAAQ;AAChC,IAAA,KAAA,MAAW,aAAa,OAAA,EAAS;AAC/B,MAAA,KAAA,MAAW,UAAA,IAAc,UAAU,SAAA,EAAW;AAC5C,QAAA,IAAI,CAAC,KAAK,GAAA,CAAI,UAAU,KAAK,CAAC,QAAA,CAAS,GAAA,CAAI,UAAU,CAAA,EAAG;AACtD,UAAA,QAAA,CAAS,IAAA,CAAK,EAAE,IAAA,EAAM,oBAAA,EAAsB,MAAA,EAAQ,CAAA,EAAG,SAAA,CAAU,GAAG,CAAA,YAAA,EAAe,UAAU,CAAA,sDAAA,CAAA,EAA0D,CAAA;AAAA,QACzJ;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,EAAE,OAAA,EAAS,KAAA,EAAM,GAAI,YAAA,CAAa,QAAQ,IAAI,CAAA;AACpD,EAAA,IAAI,KAAA,CAAM,MAAA,GAAS,CAAA,IAAK,CAAC,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,KAAS,oBAAoB,CAAA,EAAG;AAC9E,IAAA,QAAA,CAAS,KAAK,EAAE,IAAA,EAAM,OAAA,EAAS,MAAA,EAAQ,+CAA+C,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,KAAM,EAAE,GAAG,CAAA,CAAE,KAAK,IAAI,CAAC,KAAK,CAAA;AAAA,EAC/H;AAEA,EAAA,OAAO,EAAE,OAAA,EAAS,OAAA,EAAS,QAAA,EAAS;AACtC;AAEO,IAAM,cAAA,GAAiB,CAAC,IAAA,KAAqB;AAClD,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,QAAA,CAAS,CAAC,CAAA;AAC7B,EAAA,IAAI,UAAU,MAAA,EAAW;AACzB,EAAA,MAAM,IAAIA,6BAAA,CAAY,KAAA,CAAM,IAAA,EAAM,0CAAA,EAA4C,KAAK,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM,GAAG,CAAA,CAAE,IAAI,KAAK,CAAA,CAAE,MAAM,EAAE,CAAC,CAAA;AAClI","file":"chunk-KYNER7UU.cjs","sourcesContent":["import { z } from 'zod';\n\nexport const SEQUENCE_ID = /^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$/;\n\nexport const MIGRATION_REF = /^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+\\/[1-9][0-9]*$/;\n\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// `children[]` crosses the array at `children`, `endpoints.*` the record at\n// `endpoints`. Two wildcards, not one: nova's `children` is a single node or an\n// array, and one 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 // Not both: a table sequence's version is recorded per database, a grammar\n // sequence's per document (its stamp), and one number cannot be both.\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\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\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 grammar: boolean;\n documents: Readonly<Record<string, DocumentKind>>;\n migrations: readonly PreparedMigration[];\n};\n\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 applied: Readonly<Record<string, number>>;\n pending: readonly PreparedMigration[];\n problems: readonly Problem[];\n};\n\nconst refOf = (sequence: string, n: number): string => `${sequence}/${n}`;\n\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\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 type PlanOptions = {\n // The sequences given are every sequence the ledger may record.\n complete?: boolean;\n};\n\nexport const planMigrations = (sequences: readonly PreparedSequence[], ledger: readonly LedgerRow[], options: PlanOptions = {}): 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 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 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 if (options.complete === true) {\n const named = new Set(sequences.map((s) => s.id));\n const unknown = [...new Set(ledger.map((row) => row.sequence))].filter((id) => !named.has(id));\n for (const id of unknown) {\n const count = ledger.filter((row) => row.sequence === id).length;\n problems.push({\n code: 'UNKNOWN_SEQUENCE',\n detail:\n `${id}: the database records ${count} of its migration${count === 1 ? '' : 's'} and no code names it. ` +\n 'A sequence that has run stays in the code — to remove its tables, append a migration that drops them. ' +\n 'One app per database schema: two apps sharing a schema share one ledger.',\n });\n }\n }\n\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\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/schema.ts","../src/checksum.ts","../src/plan.ts"],"names":[],"mappings":"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","file":"chunk-PAMQMFBK.js","sourcesContent":["import { z } from 'zod';\n\nexport const SEQUENCE_ID = /^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$/;\n\nexport const MIGRATION_REF = /^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+\\/[1-9][0-9]*$/;\n\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// `children[]` crosses the array at `children`, `endpoints.*` the record at\n// `endpoints`. Two wildcards, not one: nova's `children` is a single node or an\n// array, and one 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 // Not both: a table sequence's version is recorded per database, a grammar\n // sequence's per document (its stamp), and one number cannot be both.\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\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\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 grammar: boolean;\n documents: Readonly<Record<string, DocumentKind>>;\n migrations: readonly PreparedMigration[];\n};\n\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 applied: Readonly<Record<string, number>>;\n pending: readonly PreparedMigration[];\n problems: readonly Problem[];\n};\n\nconst refOf = (sequence: string, n: number): string => `${sequence}/${n}`;\n\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\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 type PlanOptions = {\n // The sequences given are every sequence the ledger may record.\n complete?: boolean;\n};\n\nexport const planMigrations = (sequences: readonly PreparedSequence[], ledger: readonly LedgerRow[], options: PlanOptions = {}): 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 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 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 if (options.complete === true) {\n const named = new Set(sequences.map((s) => s.id));\n const unknown = [...new Set(ledger.map((row) => row.sequence))].filter((id) => !named.has(id));\n for (const id of unknown) {\n const count = ledger.filter((row) => row.sequence === id).length;\n problems.push({\n code: 'UNKNOWN_SEQUENCE',\n detail:\n `${id}: the database records ${count} of its migration${count === 1 ? '' : 's'} and no code names it. ` +\n 'A sequence that has run stays in the code — to remove its tables, append a migration that drops them. ' +\n 'One app per database schema: two apps sharing a schema share one ledger.',\n });\n }\n }\n\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\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/check/index.ts"],"names":["key"],"mappings":"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","file":"chunk-SH6BBA2X.js","sourcesContent":["import type { Sequence } from '../schema';\nimport type { Stamp, Upgrader } from '../documents';\nimport { StrataError } from '../errors';\n\ntype Issue = { message: string; path?: readonly (PropertyKey | { key: PropertyKey })[] };\ntype StandardResult = { value: unknown; issues?: undefined } | { issues: readonly Issue[] };\n\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\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// Under NAMED the keys are names, not keywords: a field called `description` or\n// an op called `$ref` is grammar. Under DATA the values are instance data, not schemas.\nconst NAMED = new Set(['properties', 'patternProperties', '$defs', 'definitions', 'dependentSchemas']);\nconst DATA = new Set(['const', 'enum', 'default', 'examples']);\n\n// Applied when comparing, never to what is recorded: what the gate ignores can\n// then 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\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\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\nexport const snapshotText = (snapshot: Snapshot): string => `${JSON.stringify(sortKeys(snapshot), null, 2)}\n`;\n\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 (`anyOf`, `required`,\n // `enum`), and one added branch shifts every index after it: elements are\n // matched by what they describe, an object schema by its property names.\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\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// Validators spell one schema many ways: they name and inline definitions as\n// they please, write a described reference as `allOf: [{ $ref }]` or as `$ref`,\n// and a union of bare types as `anyOf` or as `type: […]`. A comparison reads\n// both sides in one spelling.\nconst REF_PREFIX = /^#\\/(\\$defs|definitions)\\//;\n\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\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 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\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\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\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\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"]}
|