@voltro/cli 0.25.0 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/CHANGELOG.md +541 -0
  2. package/dist/apiBuild-BrjrVJJh.js +2 -0
  3. package/dist/{apiBuild-BqhCSytw.js → apiBuild-D22_EpoR.js} +2 -2
  4. package/dist/bin.js +3 -3
  5. package/dist/{commands-7EmYJ9Xg.js → commands-jBX8no1I.js} +185 -84
  6. package/dist/dbCommand-DrzXimKf.js +2 -0
  7. package/dist/{dbCommand-FUU12FvD.js → dbCommand-uuNCrFAb.js} +238 -238
  8. package/dist/{dev-BvHT7WZa.js → dev-DNkso403.js} +1 -1
  9. package/dist/{dev-MacSQ1Ll.js → dev-DcbIJrWg.js} +2036 -1775
  10. package/dist/{frameworkTableAssembly-Cw5zJz6n.js → frameworkTableAssembly-BwHU9Euq.js} +10 -6
  11. package/dist/frameworkTableAssembly-lrjZtk0G.js +2 -0
  12. package/dist/index.js +1 -1
  13. package/dist/{inspect-DuLUrZp9.js → inspect-CUCCzw2I.js} +6 -3
  14. package/dist/inspect-gt8bq-Tz.js +2 -0
  15. package/dist/{inspectMetrics-EQwH7BI4.js → inspectMetrics-BU90mvJN.js} +1 -1
  16. package/dist/{manifestBuild-Dneq4_Jx.js → manifestBuild-BnzAxp2O.js} +1 -1
  17. package/dist/manifestBuild-ifczArzr.js +2 -0
  18. package/dist/serveCommand-DfkisVWP.js +1310 -0
  19. package/dist/serveEntry.js +2 -2
  20. package/dist/{start-C-ZWSDpg.js → start-BGXIf6zT.js} +2 -2
  21. package/dist/startEntry.js +2 -2
  22. package/package.json +17 -17
  23. package/templates/AGENTS.md +1 -1
  24. package/templates/agent-docs/_index.md +1 -1
  25. package/templates/agent-docs/data.md +254 -2
  26. package/templates/agent-docs/database/schema.md +47 -0
  27. package/templates/agent-docs/deployment.md +19 -0
  28. package/templates/agent-docs/plugins.md +53 -3
  29. package/templates/agent-docs/whats-new.md +128 -294
  30. package/templates/agent-docs/workflows.md +116 -22
  31. package/templates/apps/api-ai/package.json +7 -7
  32. package/templates/apps/api-auth/package.json +8 -8
  33. package/templates/apps/api-backend/package.json +7 -7
  34. package/templates/apps/api-backend-deactivation/package.json +7 -7
  35. package/templates/apps/api-backend-mail/package.json +8 -8
  36. package/templates/apps/api-backend-mariadb/package.json +9 -9
  37. package/templates/apps/api-backend-storage/package.json +8 -8
  38. package/templates/apps/api-data-advanced/package.json +8 -8
  39. package/templates/apps/api-durable/package.json +8 -8
  40. package/templates/apps/api-feature-flags/package.json +9 -9
  41. package/templates/apps/api-governance/package.json +8 -8
  42. package/templates/apps/api-kv/package.json +8 -8
  43. package/templates/apps/api-moderation/package.json +8 -8
  44. package/templates/apps/api-observability/package.json +8 -8
  45. package/templates/apps/api-ratelimit/package.json +8 -8
  46. package/templates/apps/api-rbac/package.json +8 -8
  47. package/templates/apps/api-rest/package.json +7 -7
  48. package/templates/apps/api-saas/package.json +11 -11
  49. package/templates/apps/api-search/package.json +8 -8
  50. package/templates/apps/api-versioning/package.json +8 -8
  51. package/templates/apps/api-webhooks/package.json +9 -9
  52. package/templates/apps/changelog/package.json +6 -6
  53. package/templates/apps/edge-functions/package.json +2 -2
  54. package/templates/apps/frontend-admin/package.json +8 -8
  55. package/templates/apps/frontend-app/package.json +8 -8
  56. package/templates/apps/frontend-blank/package.json +7 -7
  57. package/templates/apps/frontend-contact/package.json +7 -7
  58. package/templates/apps/frontend-dashboard/package.json +7 -7
  59. package/templates/apps/frontend-docs/package.json +7 -7
  60. package/templates/apps/frontend-i18n/package.json +6 -6
  61. package/templates/apps/frontend-landing/package.json +7 -7
  62. package/templates/apps/frontend-spa/package.json +7 -7
  63. package/templates/apps/frontend-ssr/package.json +7 -7
  64. package/templates/apps/frontend-ssr-api/package.json +8 -8
  65. package/templates/apps/frontend-static-blog/package.json +6 -6
  66. package/dist/apiBuild-N1R4V792.js +0 -2
  67. package/dist/dbCommand-CIrdFLp9.js +0 -2
  68. package/dist/frameworkTableAssembly-BsnCKzQ6.js +0 -2
  69. package/dist/inspect-C9gjHwBk.js +0 -2
  70. package/dist/manifestBuild-BVwS1Z_6.js +0 -2
  71. package/dist/serveCommand-5ZFiNO1R.js +0 -1241
@@ -1,6 +1,6 @@
1
1
  import { i as e, n as t, r as n, s as r, t as i } from "./seedRunner-D6eu-u5U.js";
2
2
  import { n as a } from "./appModuleLoader-C9r9mxZt.js";
3
- import { t as o } from "./frameworkTableAssembly-Cw5zJz6n.js";
3
+ import { t as o } from "./frameworkTableAssembly-BwHU9Euq.js";
4
4
  import { _ as s } from "./fileConventions-3bffWssN.js";
5
5
  import { a as c, n as l, t as u } from "./cliArgs-qdZSElM3.js";
6
6
  import { basename as d, join as f, relative as p, resolve as m } from "node:path";
@@ -10,17 +10,17 @@ import { createLogger as _ } from "@voltro/logger";
10
10
  import { promises as v, writeSync as y } from "node:fs";
11
11
  import { InMemoryDataStore as ee } from "@voltro/runtime";
12
12
  import { SqlClient as b } from "@effect/sql";
13
- import { actorsTable as te, frameworkTables as x, isMigrationDefinition as S, quoteIdent as ne, registerCoreTables as re } from "@voltro/database";
14
- import { createHash as ie } from "node:crypto";
15
- import { DEFAULT_CDC_CHANNEL as ae, applyPlan as C, applySchema as w, assessRollingDeployGate as oe, declaredSnapshot as se, destructiveScope as ce, detectReactiveTriggerDrift as le, fingerprintSchema as T, ignoreTablesFromEnv as E, introspectSchema as D, pendingFileMigrationIds as ue, planMigrations as O, reactiveTriggerRepairSql as de, rollbackFileBasedMigration as fe, rollingDeployUnsafeOps as pe, runFileBasedMigrations as me, shortFingerprint as k, squashMigrationPlans as he, unblockLossy as ge } from "@voltro/database/sql";
13
+ import { actorsTable as te, frameworkTables as x, isMigrationDefinition as ne, quoteIdent as re, registerCoreTables as ie } from "@voltro/database";
14
+ import { createHash as ae } from "node:crypto";
15
+ import { DEFAULT_CDC_CHANNEL as oe, applyPlan as S, applySchema as C, assessRollingDeployGate as se, declaredSnapshot as ce, destructiveScope as le, detectReactiveTriggerDrift as ue, fingerprintSchema as w, ignoreTablesFromEnv as T, introspectSchema as de, pendingFileMigrationIds as fe, planMigrations as E, reactiveTriggerRepairSql as pe, rollbackFileBasedMigration as me, rollingDeployUnsafeOps as he, runFileBasedMigrations as ge, shortFingerprint as D, squashMigrationPlans as _e, unblockLossy as ve } from "@voltro/database/sql";
16
16
  //#region src/cliError.ts
17
- var _e = class extends Error {
17
+ var ye = class extends Error {
18
18
  isCliError = !0;
19
19
  code;
20
20
  constructor(e, t = 1) {
21
21
  super(e), this.name = "CliError", this.code = t;
22
22
  }
23
- }, ve = (e) => typeof e == "object" && !!e && e.isCliError === !0, ye = (e) => typeof e != "string", be = (e, t, n, r) => {
23
+ }, be = (e) => typeof e == "object" && !!e && e.isCliError === !0, xe = (e) => typeof e != "string", Se = (e, t, n, r) => {
24
24
  let i = [], a = new Map(t.map((e) => [e.name, e])), o = new Map(n.map((e) => [e.name, e])), s = new Set(e.leaveUnset ?? []);
25
25
  r > 0 && i.push({
26
26
  kind: "target-not-empty",
@@ -37,7 +37,7 @@ var _e = class extends Error {
37
37
  });
38
38
  continue;
39
39
  }
40
- if (ye(n)) {
40
+ if (xe(n)) {
41
41
  c.push({
42
42
  target: t,
43
43
  source: n.expr,
@@ -80,23 +80,23 @@ var _e = class extends Error {
80
80
  remintIds: f,
81
81
  fatal: i.some((e) => e.fatal)
82
82
  };
83
- }, xe = (e, t) => [
83
+ }, Ce = (e, t) => [
84
84
  `back up '${e.from}' to a restorable dump`,
85
85
  `copy rows: INSERT INTO ${e.into} (${t.assignments.map((e) => e.target).join(", ")}) SELECT … FROM ${e.from}`,
86
86
  ...t.remintIds ? ["record old id → new id in a translation table", `rewrite every reference to '${e.from}', JSON columns included`] : [],
87
87
  "verify: row counts match and a sample round-trips",
88
88
  `drop '${e.from}' — LAST, and only after the verify`
89
- ], Se = (e, t, n) => {
89
+ ], we = (e, t, n) => {
90
90
  let r = [`adopt · ${e.from} (${n} row(s)) → ${e.into}`, ""];
91
91
  for (let e of t.assignments) r.push(` ${e.target.padEnd(24)} ← ${e.raw ? `${e.source} (raw)` : e.source}`);
92
92
  t.problems.length > 0 && r.push("");
93
93
  for (let e of t.problems) r.push(` ${e.fatal ? "✗" : "⚠"} ${e.detail}`);
94
94
  if (r.push(""), t.fatal) return r.push(" REFUSED — fix the problems above. Nothing was written."), r;
95
95
  r.push(" would run, in this order:");
96
- for (let [n, i] of xe(e, t).entries()) r.push(` ${n + 1}. ${i}`);
96
+ for (let [n, i] of Ce(e, t).entries()) r.push(` ${n + 1}. ${i}`);
97
97
  return r;
98
- }, Ce = (e) => e === "mysql" || e === "mariadb" ? (e) => `\`${e}\`` : e === "mssql" ? (e) => `[${e}]` : (e) => `"${e}"`, A = (e) => `${e}__adopt_snapshot`, we = (e, t, n, r, i) => {
99
- let a = Ce(n), o = A(e.from), s = t.assignments.map((e) => e.target), c = t.assignments.map((e) => e.raw ? e.source : a(e.source));
98
+ }, Te = (e) => e === "mysql" || e === "mariadb" ? (e) => `\`${e}\`` : e === "mssql" ? (e) => `[${e}]` : (e) => `"${e}"`, O = (e) => `${e}__adopt_snapshot`, Ee = (e, t, n, r, i) => {
99
+ let a = Te(n), o = O(e.from), s = t.assignments.map((e) => e.target), c = t.assignments.map((e) => e.raw ? e.source : a(e.source));
100
100
  return i !== void 0 && (s.unshift(r), c.unshift(i)), {
101
101
  snapshot: n === "mssql" ? `SELECT * INTO ${a(o)} FROM ${a(e.from)}` : `CREATE TABLE ${a(o)} AS SELECT * FROM ${a(e.from)}`,
102
102
  copy: `INSERT INTO ${a(e.into)} (${s.map(a).join(", ")}) SELECT ${c.join(", ")} FROM ${a(e.from)}`,
@@ -106,18 +106,18 @@ var _e = class extends Error {
106
106
  drop: `DROP TABLE ${a(e.from)}`,
107
107
  dropSnapshot: `DROP TABLE ${a(o)}`
108
108
  };
109
- }, j = (e) => {
109
+ }, k = (e) => {
110
110
  let t = e[0];
111
111
  if (t === void 0) return 0;
112
112
  let n = t.n ?? t.N ?? Object.values(t)[0];
113
113
  return Number(n ?? 0);
114
- }, Te = async (e, t, n, r, i, a, o = {}) => {
114
+ }, De = async (e, t, n, r, i, a, o = {}) => {
115
115
  if (t.fatal) throw Error("adopt: the plan was refused — nothing was run");
116
- let s = we(e, t, n, r, i), c = A(e.from), l = j(await a(s.verifySource));
116
+ let s = Ee(e, t, n, r, i), c = O(e.from), l = k(await a(s.verifySource));
117
117
  await a(s.snapshot);
118
118
  for (let e of s.translations) await a(e);
119
119
  await a(s.copy);
120
- let u = j(await a(s.verifyTarget));
120
+ let u = k(await a(s.verifyTarget));
121
121
  return u === l ? o.keepSource === !0 ? {
122
122
  copied: u,
123
123
  sourceRows: l,
@@ -137,7 +137,7 @@ var _e = class extends Error {
137
137
  snapshotTable: c,
138
138
  sourceDropped: !1
139
139
  };
140
- }, M = /\.migration\.ts$/, N = async (e, t) => {
140
+ }, A = /\.migration\.ts$/, j = async (e, t) => {
141
141
  let n = [];
142
142
  for (let r of e) {
143
143
  let e;
@@ -147,7 +147,7 @@ var _e = class extends Error {
147
147
  t.warn("migration: failed to import", { file: r }, e);
148
148
  continue;
149
149
  }
150
- let i = (e.default && S(e.default) ? e.default : void 0) ?? Object.values(e).find(S);
150
+ let i = (e.default && ne(e.default) ? e.default : void 0) ?? Object.values(e).find(ne);
151
151
  if (!i) {
152
152
  t.warn("migration: no defineMigration export", { file: r });
153
153
  continue;
@@ -157,7 +157,7 @@ var _e = class extends Error {
157
157
  idInFile: i.id,
158
158
  idFromFile: d(r).replace(/\.migration\.ts$/, "")
159
159
  });
160
- let a = await v.readFile(r, "utf8").catch(() => ""), o = ie("sha256").update(a).digest("hex").slice(0, 16);
160
+ let a = await v.readFile(r, "utf8").catch(() => ""), o = ae("sha256").update(a).digest("hex").slice(0, 16);
161
161
  n.push({
162
162
  file: r,
163
163
  definition: i,
@@ -165,13 +165,13 @@ var _e = class extends Error {
165
165
  });
166
166
  }
167
167
  return [...n].sort((e, t) => e.definition.id < t.definition.id ? -1 : 1);
168
- }, P = (e) => {
168
+ }, M = (e) => {
169
169
  let t = (process.env.DB_DIALECT ?? "postgres").toLowerCase(), n = t === "memory" ? "postgres" : t;
170
- return g.runPromise(w(x, n).pipe(g.provide(e)));
171
- }, F = (e) => g.runPromise(g.gen(function* () {
170
+ return g.runPromise(C(x, n).pipe(g.provide(e)));
171
+ }, N = (e) => g.runPromise(g.gen(function* () {
172
172
  let e = yield* (yield* b.SqlClient)`SELECT id, status, hash, "appliedAt" FROM "_voltro_migrations"`.pipe(g.orElseSucceed(() => []));
173
173
  return new Map(e.map((e) => [e.id, e]));
174
- }).pipe(g.provide(e))), I = (e, t) => g.runPromise(g.gen(function* () {
174
+ }).pipe(g.provide(e))), P = (e, t) => g.runPromise(g.gen(function* () {
175
175
  yield* (yield* b.SqlClient)`
176
176
  INSERT INTO "_voltro_migrations"
177
177
  (id, name, hash, status, "appliedAt", "durationMs", "errorMessage", "errorStack")
@@ -187,14 +187,14 @@ var _e = class extends Error {
187
187
  "errorStack" = EXCLUDED."errorStack",
188
188
  "updatedAt" = now()
189
189
  `;
190
- }).pipe(g.provide(e))), Ee = async (e, t, n) => {
190
+ }).pipe(g.provide(e))), Oe = async (e, t, n) => {
191
191
  if (e.length === 0) return {
192
192
  applied: [],
193
193
  failed: null,
194
194
  skipped: []
195
195
  };
196
- await P(t);
197
- let r = await F(t), i = [], a = [], o = null;
196
+ await M(t);
197
+ let r = await N(t), i = [], a = [], o = null;
198
198
  for (let s of e) {
199
199
  let e = r.get(s.definition.id);
200
200
  if (e && e.status === "applied") {
@@ -215,7 +215,7 @@ var _e = class extends Error {
215
215
  name: s.definition.name
216
216
  });
217
217
  let c = Date.now(), l = [];
218
- await I(t, {
218
+ await P(t, {
219
219
  id: s.definition.id,
220
220
  name: s.definition.name,
221
221
  hash: s.hash,
@@ -256,7 +256,7 @@ var _e = class extends Error {
256
256
  ...a.stack ? { stack: a.stack } : {}
257
257
  }
258
258
  };
259
- o = f, i.push(f), await I(t, {
259
+ o = f, i.push(f), await P(t, {
260
260
  id: s.definition.id,
261
261
  name: s.definition.name,
262
262
  hash: s.hash,
@@ -275,7 +275,7 @@ var _e = class extends Error {
275
275
  status: "applied",
276
276
  durationMs: Date.now() - c,
277
277
  steps: l
278
- }), await I(t, {
278
+ }), await P(t, {
279
279
  id: s.definition.id,
280
280
  name: s.definition.name,
281
281
  hash: s.hash,
@@ -295,9 +295,9 @@ var _e = class extends Error {
295
295
  failed: o,
296
296
  skipped: a
297
297
  };
298
- }, De = async (e, t, n, r = {}) => {
299
- await P(t);
300
- let i = await F(t), a = e.filter((e) => i.get(e.definition.id)?.status === "applied");
298
+ }, ke = async (e, t, n, r = {}) => {
299
+ await M(t);
300
+ let i = await N(t), a = e.filter((e) => i.get(e.definition.id)?.status === "applied");
301
301
  if (a.length === 0) return n.info("migration: nothing to roll back"), {
302
302
  applied: [],
303
303
  failed: null,
@@ -350,7 +350,7 @@ var _e = class extends Error {
350
350
  status: "applied",
351
351
  durationMs: Date.now() - r,
352
352
  steps: i
353
- }), await I(t, {
353
+ }), await P(t, {
354
354
  id: e.definition.id,
355
355
  name: e.definition.name,
356
356
  hash: e.hash,
@@ -366,9 +366,9 @@ var _e = class extends Error {
366
366
  failed: c,
367
367
  skipped: []
368
368
  };
369
- }, L = async (e, t) => {
370
- await P(t);
371
- let n = await F(t);
369
+ }, F = async (e, t) => {
370
+ await M(t);
371
+ let n = await N(t);
372
372
  return e.map((e) => {
373
373
  let t = n.get(e.definition.id);
374
374
  return t ? {
@@ -385,7 +385,7 @@ var _e = class extends Error {
385
385
  hashMatches: !0
386
386
  };
387
387
  });
388
- }, R = (e) => {
388
+ }, I = (e) => {
389
389
  if (!e.failed) return "";
390
390
  let t = e.failed, n = [
391
391
  `✗ Migration failed: ${t.migrationId} / step '${t.error?.stepName ?? "?"}'`,
@@ -398,7 +398,7 @@ var _e = class extends Error {
398
398
  ""
399
399
  ];
400
400
  return e.applied.length > 0 && n.unshift("", `(${e.applied.length} migration(s) applied successfully before the failure.)`), n.join("\n");
401
- }, z = _({ scope: "voltro:db" }), Oe = /* @__PURE__ */ new Set([
401
+ }, L = _({ scope: "voltro:db" }), Ae = /* @__PURE__ */ new Set([
402
402
  "node_modules",
403
403
  "dist",
404
404
  "build",
@@ -406,17 +406,17 @@ var _e = class extends Error {
406
406
  ".vite",
407
407
  ".next",
408
408
  ".git"
409
- ]), B = async (e, t) => {
409
+ ]), R = async (e, t) => {
410
410
  let n = [], r = async (e) => {
411
411
  let i = await v.readdir(e, { withFileTypes: !0 }).catch(() => []);
412
412
  for (let a of i) {
413
- if (Oe.has(a.name)) continue;
413
+ if (Ae.has(a.name)) continue;
414
414
  let i = f(e, a.name);
415
415
  a.isDirectory() ? await r(i) : a.isFile() && t.test(a.name) && n.push(i);
416
416
  }
417
417
  };
418
418
  return await r(e), n;
419
- }, V = (e) => m(e.find((e) => !e.startsWith("-")) ?? process.cwd()), H = () => {
419
+ }, z = (e) => m(e.find((e) => !e.startsWith("-")) ?? process.cwd()), B = () => {
420
420
  let e = process.env.DB_MAX_CONNECTIONS ?? process.env.PG_MAX_CONNECTIONS, t = e !== void 0 && e !== "" ? Number(e) : NaN, n = Number.isInteger(t) && t > 0 ? { maxConnections: t } : {}, r = process.env.DB_SCHEMA, i = r && r.length > 0 ? { schema: r } : {}, a = process.env.DB_DIRECT_URL ?? process.env.DB_MIGRATE_URL ?? process.env.DB_URL ?? process.env.DB_PRIMARY_URL;
421
421
  return a ? {
422
422
  url: a,
@@ -431,63 +431,63 @@ var _e = class extends Error {
431
431
  ...n,
432
432
  ...i
433
433
  };
434
- }, U = (e) => {
434
+ }, V = (e) => {
435
435
  let t = e;
436
436
  if (typeof t != "object" || !t) return !1;
437
437
  if (t.code === "ERR_OUT_OF_RANGE" || t.cause?.code === "ERR_OUT_OF_RANGE") return !0;
438
438
  let n = `${t.message ?? ""} ${t.cause?.message ?? ""} ${t.stack ?? ""}`;
439
439
  return /ERR_OUT_OF_RANGE|out of range/i.test(n) && /pg-protocol|parseDataRow|buffer-reader|BufferReader/i.test(n);
440
- }, W = "Live-DB introspection got a corrupt / misaligned response from the database. This happens when `voltro db plan` / `apply` / `drift` / `migrate` runs through a connection POOLER (Supabase Supavisor / PgBouncer) on a LARGE schema — the pooler mis-frames a big catalog response. The introspection already batches by table to keep responses small; if a batch still trips it:\n 1. Lower the batch: set `VOLTRO_INTROSPECT_BATCH` to a smaller number of tables (default 20 — try 5 or 1). This keeps `db plan` on the normal pooler, no direct connection needed.\n 2. Or use a DIRECT (non-pooler) connection: set `DB_DIRECT_URL` (or `DB_MIGRATE_URL`) to the direct database URL — the runtime keeps `DB_URL`, so only the migration path is affected. (Supabase: direct = `db.<project-ref>.supabase.co` [IPv6-only on newer projects]; pooler = `aws-0-<region>.pooler.supabase.com`.)", G = () => {
440
+ }, H = "Live-DB introspection got a corrupt / misaligned response from the database. This happens when `voltro db plan` / `apply` / `drift` / `migrate` runs through a connection POOLER (Supabase Supavisor / PgBouncer) on a LARGE schema — the pooler mis-frames a big catalog response. The introspection already batches by table to keep responses small; if a batch still trips it:\n 1. Lower the batch: set `VOLTRO_INTROSPECT_BATCH` to a smaller number of tables (default 20 — try 5 or 1). This keeps `db plan` on the normal pooler, no direct connection needed.\n 2. Or use a DIRECT (non-pooler) connection: set `DB_DIRECT_URL` (or `DB_MIGRATE_URL`) to the direct database URL — the runtime keeps `DB_URL`, so only the migration path is affected. (Supabase: direct = `db.<project-ref>.supabase.co` [IPv6-only on newer projects]; pooler = `aws-0-<region>.pooler.supabase.com`.)", U = () => {
441
441
  let e = (process.env.DB_DIALECT ?? "postgres").toLowerCase();
442
- if (e === "memory") throw new _e("voltro db: subcommands require a real dialect, not DB_DIALECT=memory.");
442
+ if (e === "memory") throw new ye("voltro db: subcommands require a real dialect, not DB_DIALECT=memory.");
443
443
  return e;
444
- }, K = async () => (await r(G())).makeSqlLayer(H()), ke = async (e) => {
445
- let t = V(e), n = e.includes("--dry-run"), r = await N(await B(t, M), z);
446
- if (r.length === 0) return z.info("no migrations found", { root: t }), 0;
444
+ }, W = (e) => re(e, U()), G = (e) => e === "mysql" || e === "mariadb" ? "table_schema = DATABASE()" : e === "mssql" ? "table_schema = SCHEMA_NAME()" : "table_schema = 'public'", K = async () => (await r(U())).makeSqlLayer(B()), je = async (e) => {
445
+ let t = z(e), n = e.includes("--dry-run"), r = await j(await R(t, A), L);
446
+ if (r.length === 0) return L.info("no migrations found", { root: t }), 0;
447
447
  if (n) {
448
448
  let e = /* @__PURE__ */ new Set();
449
449
  try {
450
- let t = await L(r, await K());
450
+ let t = await F(r, await K());
451
451
  e = new Set(t.filter((e) => e.status === "applied").map((e) => e.id));
452
452
  } catch {
453
- z.warn("migrate --dry-run: could not read the migration ledger — showing ALL as pending");
453
+ L.warn("migrate --dry-run: could not read the migration ledger — showing ALL as pending");
454
454
  }
455
455
  let t = r.filter((t) => !e.has(t.definition.id));
456
- if (t.length === 0) return z.info("migrate --dry-run: nothing pending — every migration is applied"), 0;
457
- z.info(`migrate --dry-run: ${t.length} pending (nothing applied)`);
456
+ if (t.length === 0) return L.info("migrate --dry-run: nothing pending — every migration is applied"), 0;
457
+ L.info(`migrate --dry-run: ${t.length} pending (nothing applied)`);
458
458
  for (let e of t) console.log(` pending ${e.definition.id}`);
459
459
  return 0;
460
460
  }
461
- let i = await Ee(r, await K(), z);
462
- return i.failed ? (process.stderr.write(R(i) + "\n"), 1) : (z.info("migrate complete", {
461
+ let i = await Oe(r, await K(), L);
462
+ return i.failed ? (process.stderr.write(I(i) + "\n"), 1) : (L.info("migrate complete", {
463
463
  applied: i.applied.length,
464
464
  skipped: i.skipped.length
465
465
  }), 0);
466
- }, Ae = async (e) => {
467
- let t = V(e), n = l(e, "--to"), r = await N(await B(t, M), z);
468
- if (r.length === 0) return z.info("no migrations found", { root: t }), 0;
469
- let i = await De(r, await K(), z, n ? { to: n } : {});
470
- return i.failed ? (process.stderr.write(R(i) + "\n"), 1) : (z.info("rollback complete", { reverted: i.applied.length }), 0);
471
- }, je = async (e) => {
472
- let t = await N(await B(V(e), M), z);
466
+ }, Me = async (e) => {
467
+ let t = z(e), n = l(e, "--to"), r = await j(await R(t, A), L);
468
+ if (r.length === 0) return L.info("no migrations found", { root: t }), 0;
469
+ let i = await ke(r, await K(), L, n ? { to: n } : {});
470
+ return i.failed ? (process.stderr.write(I(i) + "\n"), 1) : (L.info("rollback complete", { reverted: i.applied.length }), 0);
471
+ }, Ne = async (e) => {
472
+ let t = await j(await R(z(e), A), L);
473
473
  if (t.length === 0) return console.log("no migrations found"), 0;
474
- let n = await L(t, await K());
474
+ let n = await F(t, await K());
475
475
  for (let e of n) {
476
476
  let t = e.status === "applied" ? "✓" : e.status === "failed" ? "✗" : e.status === "reverted" ? "↩" : "·", n = e.hashMatches ? "" : " (hash drift!)", r = e.appliedAt ? ` @ ${e.appliedAt.toISOString()}` : "";
477
477
  console.log(` ${t} ${e.id} [${e.status}] ${e.name}${r}${n}`);
478
478
  }
479
479
  return 0;
480
- }, Me = async (e) => {
480
+ }, Pe = async (e) => {
481
481
  let t = (l(e, "--store") ?? process.env.DB_DIALECT ?? "postgres").toLowerCase();
482
- if (t === "memory") return z.warn("voltro db seed: using in-memory store (explicit opt-in via --store memory / DB_DIALECT=memory)"), z.warn(" rows written by this run will NOT persist beyond the process. set DB_DIALECT=postgres or unset to seed the real DB."), {
482
+ if (t === "memory") return L.warn("voltro db seed: using in-memory store (explicit opt-in via --store memory / DB_DIALECT=memory)"), L.warn(" rows written by this run will NOT persist beyond the process. set DB_DIALECT=postgres or unset to seed the real DB."), {
483
483
  store: new ee(),
484
484
  dispose: async () => {},
485
485
  dialectId: "memory"
486
486
  };
487
487
  let n = await r(t);
488
- z.info(`voltro db seed: target store=${n.id} — rows will persist`);
488
+ L.info(`voltro db seed: target store=${n.id} — rows will persist`);
489
489
  let i = await n.makeStore({
490
- sqlLayer: n.makeSqlLayer(H()),
490
+ sqlLayer: n.makeSqlLayer(B()),
491
491
  changeStrategy: "inline"
492
492
  }), a = i;
493
493
  return {
@@ -497,77 +497,77 @@ var _e = class extends Error {
497
497
  },
498
498
  dialectId: n.id
499
499
  };
500
- }, Ne = async (r) => {
501
- let a = V(r), o = l(r, "--id"), s = l(r, "--lifecycle"), c = await t(await B(a, i), z);
502
- if (c.length === 0) return z.info("no seeds found", { root: a }), 0;
503
- let { store: u, dispose: d, dialectId: f } = await Me(r);
500
+ }, Fe = async (r) => {
501
+ let a = z(r), o = l(r, "--id"), s = l(r, "--lifecycle"), c = await t(await R(a, i), L);
502
+ if (c.length === 0) return L.info("no seeds found", { root: a }), 0;
503
+ let { store: u, dispose: d, dialectId: f } = await Pe(r);
504
504
  try {
505
- return o ? +((await e(c, o, u, z)).status === "failed") : +((await n((s ? c.filter((e) => e.definition.lifecycle === s) : c.filter((e) => e.definition.lifecycle === "boot")).map((e) => ({
505
+ return o ? +((await e(c, o, u, L)).status === "failed") : +((await n((s ? c.filter((e) => e.definition.lifecycle === s) : c.filter((e) => e.definition.lifecycle === "boot")).map((e) => ({
506
506
  ...e,
507
507
  definition: {
508
508
  ...e.definition,
509
509
  lifecycle: "boot"
510
510
  }
511
- })), u, z, { force: !0 })).filter((e) => e.status === "failed").length > 0);
511
+ })), u, L, { force: !0 })).filter((e) => e.status === "failed").length > 0);
512
512
  } finally {
513
513
  await d().catch((e) => {
514
- z.warn("voltro db seed: store dispose failed", { error: String(e) });
514
+ L.warn("voltro db seed: store dispose failed", { error: String(e) });
515
515
  });
516
516
  }
517
- }, Pe = (e) => typeof e == "object" && !!e && "tableName" in e && "fields" in e && typeof e.tableName == "string", Fe = async (e) => {
518
- let t = await B(e, s), n = [];
517
+ }, Ie = (e) => typeof e == "object" && !!e && "tableName" in e && "fields" in e && typeof e.tableName == "string", Le = async (e) => {
518
+ let t = await R(e, s), n = [];
519
519
  for (let r of t) {
520
520
  let t;
521
521
  try {
522
522
  t = await import(h(r).href);
523
523
  } catch (t) {
524
- z.warn("db: failed to import schema file", {
524
+ L.warn("db: failed to import schema file", {
525
525
  file: p(e, r),
526
526
  error: String(t)
527
527
  });
528
528
  continue;
529
529
  }
530
- for (let e of Object.values(t)) Pe(e) && n.push(e);
530
+ for (let e of Object.values(t)) Ie(e) && n.push(e);
531
531
  }
532
532
  return n;
533
- }, Ie = (e) => {
533
+ }, Re = (e) => {
534
534
  let t = new Map(e.map((e) => [e.tableName, e]));
535
535
  t.has("actors") || t.set("actors", te);
536
536
  let n = t.get("actors"), r = t.get("tenants");
537
- return re({
537
+ return ie({
538
538
  actors: () => n,
539
539
  ...r === void 0 ? {} : { tenants: () => r }
540
540
  }), [...t.values()];
541
- }, Le = (e) => {
541
+ }, ze = (e) => {
542
542
  let t = /* @__PURE__ */ new Map();
543
543
  for (let n of e) {
544
544
  let e = n.tableName;
545
545
  e !== void 0 && !t.has(e) && t.set(e, n);
546
546
  }
547
547
  return [...t.values()];
548
- }, Re = (e) => {
549
- let t = ce(process.env.VOLTRO_DESTRUCTIVE_OK);
548
+ }, Be = (e) => {
549
+ let t = le(process.env.VOLTRO_DESTRUCTIVE_OK);
550
550
  if (t === void 0 || !e.operations.filter((e) => e.blocked).every((e) => e.classification === "lossy")) return {
551
551
  plan: e,
552
552
  acknowledged: !1
553
553
  };
554
- let n = ge(e, t);
554
+ let n = ve(e, t);
555
555
  return {
556
556
  plan: n,
557
557
  acknowledged: !n.operations.some((e) => e.blocked)
558
558
  };
559
559
  }, q = async (e, t) => g.runPromise(t.pipe(g.provide(e))), J = async (e) => {
560
560
  try {
561
- return await q(e, b.SqlClient.pipe(g.flatMap(D)));
561
+ return await q(e, b.SqlClient.pipe(g.flatMap(de)));
562
562
  } catch (e) {
563
563
  let t = String(e?.message ?? e);
564
- if (U(e) || /connection error/i.test(t)) {
565
- let n = /* @__PURE__ */ Error(`${W}\n\nOriginal error: ${t}`);
564
+ if (V(e) || /connection error/i.test(t)) {
565
+ let n = /* @__PURE__ */ Error(`${H}\n\nOriginal error: ${t}`);
566
566
  throw n.cause = e, n;
567
567
  }
568
568
  throw e;
569
569
  }
570
- }, ze = {
570
+ }, Ve = {
571
571
  safe: "\x1B[32m✓\x1B[0m",
572
572
  "needs-default": "\x1B[32m⊕\x1B[0m",
573
573
  "needs-backfill": "\x1B[33m⊕\x1B[0m",
@@ -575,7 +575,7 @@ var _e = class extends Error {
575
575
  lossy: "\x1B[31m✗\x1B[0m",
576
576
  "online-required": "\x1B[36m◷\x1B[0m",
577
577
  "multi-step": "\x1B[35m⇉\x1B[0m"
578
- }, Be = (e) => {
578
+ }, He = (e) => {
579
579
  let t = e.op, n;
580
580
  switch (t.kind) {
581
581
  case "create-table":
@@ -639,9 +639,9 @@ var _e = class extends Error {
639
639
  n = `ALTER TABLE ${t.table} DROP CHECK ${t.column}`;
640
640
  break;
641
641
  }
642
- let r = ze[e.classification], i = e.reason ? ` # ${e.reason}` : "", a = e.blocked ? `\n ! ${e.blocked.fix}` : "";
642
+ let r = Ve[e.classification], i = e.reason ? ` # ${e.reason}` : "", a = e.blocked ? `\n ! ${e.blocked.fix}` : "";
643
643
  return ` ${r} ${n}${i}${a}`;
644
- }, Ve = async (e, t) => {
644
+ }, Ue = async (e, t) => {
645
645
  let n = e.operations.filter((e) => e.classification === "needs-default" && e.op.kind === "add-column");
646
646
  if (n.length === 0) return;
647
647
  let r = [];
@@ -650,7 +650,7 @@ var _e = class extends Error {
650
650
  if (i === void 0 || a === void 0) continue;
651
651
  let o = 0;
652
652
  try {
653
- let e = await q(t, b.SqlClient.pipe(g.flatMap((e) => e.unsafe(`SELECT COUNT(*) AS n FROM ${ne(i, G())}`))));
653
+ let e = await q(t, b.SqlClient.pipe(g.flatMap((e) => e.unsafe(`SELECT COUNT(*) AS n FROM ${re(i, U())}`))));
654
654
  o = Number(Object.values(e[0] ?? { n: 0 })[0] ?? 0);
655
655
  } catch {
656
656
  continue;
@@ -663,14 +663,14 @@ var _e = class extends Error {
663
663
  console.log(" (the shape is correct either way — this is the VALUE a state diff cannot know)");
664
664
  }
665
665
  }, Y = async (e, t) => {
666
- if (G() !== "postgres") return;
667
- let n = ae, r;
666
+ if (U() !== "postgres") return;
667
+ let n = oe, r;
668
668
  try {
669
- r = await q(t, b.SqlClient.pipe(g.flatMap((t) => le(t, e, n))));
669
+ r = await q(t, b.SqlClient.pipe(g.flatMap((t) => ue(t, e, n))));
670
670
  } catch {
671
671
  return;
672
672
  }
673
- let i = de({
673
+ let i = pe({
674
674
  tables: e,
675
675
  dialect: "postgres",
676
676
  missing: r.missing,
@@ -678,10 +678,10 @@ var _e = class extends Error {
678
678
  channel: n
679
679
  });
680
680
  if (i.length === 0) return;
681
- z.info(`db apply: installing change triggers on ${r.missing.length} table(s)` + (r.stale.length > 0 ? `, removing ${r.stale.length} stale one(s)` : ""));
681
+ L.info(`db apply: installing change triggers on ${r.missing.length} table(s)` + (r.stale.length > 0 ? `, removing ${r.stale.length} stale one(s)` : ""));
682
682
  let a = 0;
683
683
  for (let e of i) await q(t, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(e)))), a += 1;
684
- z.info(`db apply: change triggers converged (${a} statement(s))`, {
684
+ L.info(`db apply: change triggers converged (${a} statement(s))`, {
685
685
  installed: r.missing.length,
686
686
  removed: r.stale.length
687
687
  });
@@ -691,40 +691,40 @@ var _e = class extends Error {
691
691
  console.log(" (schema is up to date)\n");
692
692
  return;
693
693
  }
694
- for (let t of e.operations) console.log(Be(t));
695
- console.log(), console.log(` safe: ${t.safe} needs-default: ${t.needsDefault} needs-backfill: ${t.needsBackfill}`), console.log(` rename: ${t.needsRenameAnnotation} lossy: ${t.lossy} blocked: ${t.blocked}`), console.log(` fingerprint: ${e.fromFingerprint.slice(0, 16)} → ${e.toFingerprint.slice(0, 16)}\n`), He(e);
696
- }, He = (e) => {
697
- let t = pe(e.operations);
694
+ for (let t of e.operations) console.log(He(t));
695
+ console.log(), console.log(` safe: ${t.safe} needs-default: ${t.needsDefault} needs-backfill: ${t.needsBackfill}`), console.log(` rename: ${t.needsRenameAnnotation} lossy: ${t.lossy} blocked: ${t.blocked}`), console.log(` fingerprint: ${e.fromFingerprint.slice(0, 16)} → ${e.toFingerprint.slice(0, 16)}\n`), We(e);
696
+ }, We = (e) => {
697
+ let t = he(e.operations);
698
698
  if (t.length !== 0) {
699
699
  console.log(` ⚠ ${t.length} operation(s) UNSAFE under a rolling deploy`), console.log(" (old + new instances overlap → old code breaks against the new schema):");
700
700
  for (let e of t) console.log(` • ${e.op.op.kind}: ${e.reason}`), console.log(` → ${e.remedy}`);
701
701
  console.log(" Deploy with a maintenance window / scale-to-zero, or split into"), console.log(" expand → deploy → contract. See docs: deployment/production-hardening.\n");
702
702
  }
703
- }, Ue = (e, t) => {
704
- let n = oe({
703
+ }, Ge = (e, t) => {
704
+ let n = se({
705
705
  enabled: process.env.VOLTRO_ROLLING_DEPLOY === "1",
706
706
  forced: t.includes("--force"),
707
- unsafeCount: pe(e.operations).length
707
+ unsafeCount: he(e.operations).length
708
708
  });
709
- return n.refuse ? (z.error(`db apply: ${n.message}`), !0) : (n.warnForced && z.warn(`db apply: ${n.message}`), !1);
710
- }, We = (e) => {
709
+ return n.refuse ? (L.error(`db apply: ${n.message}`), !0) : (n.warnForced && L.warn(`db apply: ${n.message}`), !1);
710
+ }, Ke = (e) => {
711
711
  let t = l(e, "--online-after") ?? process.env.VOLTRO_ONLINE_THRESHOLD;
712
712
  if (t === void 0) return;
713
713
  let n = Number(t);
714
714
  if (!Number.isInteger(n) || n < 0) throw Error(`--online-after / VOLTRO_ONLINE_THRESHOLD must be a non-negative integer, got "${t}"`);
715
715
  return n;
716
716
  }, Z = async (e) => {
717
- let t = await Fe(e);
717
+ let t = await Le(e);
718
718
  if (t.length === 0) return;
719
719
  let n = await o({ root: e });
720
- return Ie(Le([
720
+ return Re(ze([
721
721
  ...t,
722
722
  ...x,
723
723
  ...n
724
724
  ]));
725
- }, Ge = async (e) => {
726
- let t = We(e), n = V(e), r = await Z(n);
727
- if (r === void 0) return z.warn("db plan: no schema files found", {
725
+ }, qe = async (e) => {
726
+ let t = Ke(e), n = z(e), r = await Z(n);
727
+ if (r === void 0) return L.warn("db plan: no schema files found", {
728
728
  root: n,
729
729
  hint: "looked for *.entity.ts / *.schema.ts / schema.ts"
730
730
  }), 1;
@@ -734,114 +734,114 @@ var _e = class extends Error {
734
734
  a && (o.authorization = `Bearer ${a}`);
735
735
  try {
736
736
  let e = n.endsWith("/_voltro/inspect/migrations") ? n : `${n.replace(/\/+$/, "")}/_voltro/inspect/migrations`, i = await fetch(e, { headers: o });
737
- if (!i.ok) return z.error(`db plan --against: remote returned ${i.status}`, { url: e }), 1;
737
+ if (!i.ok) return L.error(`db plan --against: remote returned ${i.status}`, { url: e }), 1;
738
738
  let a = (await i.json()).drift?.liveSnapshot;
739
- if (!a) return z.error("db plan --against: remote inspect payload missing drift.liveSnapshot", { url: e }), 1;
740
- let s = O({
739
+ if (!a) return L.error("db plan --against: remote inspect payload missing drift.liveSnapshot", { url: e }), 1;
740
+ let s = E({
741
741
  declared: r,
742
742
  live: a,
743
- dialect: G(),
744
- ...E(),
743
+ dialect: U(),
744
+ ...T(),
745
745
  ...t === void 0 ? {} : { onlineAfter: t }
746
746
  });
747
747
  return console.log(`\n[--against ${e}] — diff vs remote live schema:\n`), X(s), s.summary.blocked > 0 ? 2 : 0;
748
748
  } catch (e) {
749
- return z.error(`db plan --against: ${e.message}`), 1;
749
+ return L.error(`db plan --against: ${e.message}`), 1;
750
750
  }
751
751
  }
752
- let a = O({
752
+ let a = E({
753
753
  declared: r,
754
754
  live: await J(await K()),
755
- dialect: G(),
756
- ...E(),
755
+ dialect: U(),
756
+ ...T(),
757
757
  ...t === void 0 ? {} : { onlineAfter: t }
758
758
  });
759
759
  return e.includes("--json") ? (y(1, `${JSON.stringify(a, null, 2)}\n`), a.summary.blocked > 0 ? 2 : 0) : (X(a), a.summary.blocked > 0 ? 2 : 0);
760
- }, Ke = async (e, t, n) => {
760
+ }, Je = async (e, t, n) => {
761
761
  let r;
762
762
  try {
763
763
  let t = await v.readFile(m(e), "utf8");
764
764
  r = JSON.parse(t);
765
765
  } catch (t) {
766
- return z.error(`db apply --plan: cannot read/parse plan file '${e}': ${t.message}`), 1;
766
+ return L.error(`db apply --plan: cannot read/parse plan file '${e}': ${t.message}`), 1;
767
767
  }
768
- if (!Array.isArray(r?.operations) || typeof r?.fromFingerprint != "string" || typeof r?.toFingerprint != "string") return z.error(`db apply --plan: '${e}' is not a valid plan file (expected the output of \`voltro db plan --json\`).`), 1;
768
+ if (!Array.isArray(r?.operations) || typeof r?.fromFingerprint != "string" || typeof r?.toFingerprint != "string") return L.error(`db apply --plan: '${e}' is not a valid plan file (expected the output of \`voltro db plan --json\`).`), 1;
769
769
  let i = await Z(n);
770
- if (i === void 0) return z.warn("db apply --plan: no schema files found", { root: n }), 1;
770
+ if (i === void 0) return L.warn("db apply --plan: no schema files found", { root: n }), 1;
771
771
  let a = await K();
772
- await q(a, w(x, G()));
773
- let o = await q(a, b.SqlClient.pipe(g.flatMap((e) => ue(e, n)))).catch(() => []);
774
- if (o.length > 0) return z.error(`db apply --plan: refusing — ${o.length} pending file-based migration(s).`), console.error(` ${o.join("\n ")}`), console.error(""), console.error(" These perform the changes a state diff cannot infer, so they change the shape"), console.error(" this plan was computed against. Apply them and regenerate the plan:"), console.error(""), console.error(" voltro db files ."), console.error(" voltro db plan --json > plan.json"), console.error(" voltro db apply --plan plan.json"), 1;
775
- let s = O({
772
+ await q(a, C(x, U()));
773
+ let o = await q(a, b.SqlClient.pipe(g.flatMap((e) => fe(e, n)))).catch(() => []);
774
+ if (o.length > 0) return L.error(`db apply --plan: refusing — ${o.length} pending file-based migration(s).`), console.error(` ${o.join("\n ")}`), console.error(""), console.error(" These perform the changes a state diff cannot infer, so they change the shape"), console.error(" this plan was computed against. Apply them and regenerate the plan:"), console.error(""), console.error(" voltro db files ."), console.error(" voltro db plan --json > plan.json"), console.error(" voltro db apply --plan plan.json"), 1;
775
+ let s = E({
776
776
  declared: i,
777
777
  live: await J(a),
778
- dialect: G(),
779
- ...E()
778
+ dialect: U(),
779
+ ...T()
780
780
  });
781
- if (s.fromFingerprint !== r.fromFingerprint) return z.error("db apply --plan: refusing — the live schema has drifted since this plan was generated."), console.error(` plan.from=${r.fromFingerprint.slice(0, 16)} live=${s.fromFingerprint.slice(0, 16)}`), console.error(" Regenerate against the current live schema: `voltro db plan --json > plan.json`"), 2;
782
- if (s.toFingerprint !== r.toFingerprint) return z.error("db apply --plan: refusing — the declared schema differs from what this plan targets."), console.error(` plan.to=${r.toFingerprint.slice(0, 16)} declared=${s.toFingerprint.slice(0, 16)}`), console.error(" The schema files changed since the plan was generated. Regenerate the plan."), 2;
783
- let c = Re(s), u = c.plan;
784
- if (u.summary.blocked > 0 && !c.acknowledged) return X(u), z.error(`db apply --plan: refusing — ${s.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (z.error(" VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), z.error(" `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
785
- if (c.acknowledged && z.warn("db apply --plan: proceeding with acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)"), Ue(u, t)) return 2;
786
- if (u.operations.length === 0) return z.info("db apply --plan: schema is up to date — nothing to apply"), await Y(i, a), 0;
781
+ if (s.fromFingerprint !== r.fromFingerprint) return L.error("db apply --plan: refusing — the live schema has drifted since this plan was generated."), console.error(` plan.from=${r.fromFingerprint.slice(0, 16)} live=${s.fromFingerprint.slice(0, 16)}`), console.error(" Regenerate against the current live schema: `voltro db plan --json > plan.json`"), 2;
782
+ if (s.toFingerprint !== r.toFingerprint) return L.error("db apply --plan: refusing — the declared schema differs from what this plan targets."), console.error(` plan.to=${r.toFingerprint.slice(0, 16)} declared=${s.toFingerprint.slice(0, 16)}`), console.error(" The schema files changed since the plan was generated. Regenerate the plan."), 2;
783
+ let c = Be(s), u = c.plan;
784
+ if (u.summary.blocked > 0 && !c.acknowledged) return X(u), L.error(`db apply --plan: refusing — ${s.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (L.error(" VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), L.error(" `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
785
+ if (c.acknowledged && L.warn("db apply --plan: proceeding with acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)"), Ge(u, t)) return 2;
786
+ if (u.operations.length === 0) return L.info("db apply --plan: schema is up to date — no DDL to apply (change triggers are reconciled separately below)"), await Y(i, a), 0;
787
787
  X(u);
788
- let d = (process.env.NODE_ENV ?? "dev").toLowerCase(), f = l(t, "--note"), p = await q(a, b.SqlClient.pipe(g.flatMap((e) => C(e, u, {
788
+ let d = (process.env.NODE_ENV ?? "dev").toLowerCase(), f = l(t, "--note"), p = await q(a, b.SqlClient.pipe(g.flatMap((e) => S(e, u, {
789
789
  declared: i,
790
790
  appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:plan",
791
791
  environment: d === "production" ? "prod" : d === "staging" ? "staging" : "dev",
792
792
  source: "file",
793
793
  ...f ? { notes: f } : {},
794
- replan: () => g.promise(() => J(a)).pipe(g.map((e) => O({
794
+ replan: () => g.promise(() => J(a)).pipe(g.map((e) => E({
795
795
  declared: i,
796
796
  live: e,
797
- dialect: G(),
798
- ...E()
797
+ dialect: U(),
798
+ ...T()
799
799
  })))
800
800
  }))));
801
- return z.info(`db apply --plan: applied ${p.appliedOps} op(s) in ${p.durationMs}ms`, {
801
+ return L.info(`db apply --plan: applied ${p.appliedOps} op(s) in ${p.durationMs}ms`, {
802
802
  id: p.id,
803
803
  fingerprint: p.fingerprint.slice(0, 16)
804
804
  }), await Y(i, a), 0;
805
- }, qe = async (e) => {
806
- let t = V(e), n = We(e), r = l(e, "--plan");
807
- if (r) return Ke(r, e, t);
808
- if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return z.error("voltro db apply: refusing — auto-apply on prod is not allowed."), console.error("In production, schema changes go through `voltro db plan --json > plan.json`"), console.error("then `voltro db apply --plan plan.json` as an explicit step in your deploy pipeline."), 3;
805
+ }, Ye = async (e) => {
806
+ let t = z(e), n = Ke(e), r = l(e, "--plan");
807
+ if (r) return Je(r, e, t);
808
+ if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return L.error("voltro db apply: refusing — auto-apply on prod is not allowed."), console.error("In production, schema changes go through `voltro db plan --json > plan.json`"), console.error("then `voltro db apply --plan plan.json` as an explicit step in your deploy pipeline."), 3;
809
809
  let i = await Z(t);
810
- if (i === void 0) return z.warn("db apply: no schema files found", { root: t }), 1;
811
- let a = await K(), o = await nt(t, a);
812
- if ("failed" in o) return z.error("db apply: a file-based migration FAILED — the schema diff was NOT run"), console.error(o.failed), console.error("Fix the migration and re-run. `voltro db files` runs them alone."), 1;
813
- await q(a, w(x, G()));
814
- let s = O({
810
+ if (i === void 0) return L.warn("db apply: no schema files found", { root: t }), 1;
811
+ let a = await K(), o = await it(t, a);
812
+ if ("failed" in o) return L.error("db apply: a file-based migration FAILED — the schema diff was NOT run"), console.error(o.failed), console.error("Fix the migration and re-run. `voltro db files` runs them alone."), 1;
813
+ await q(a, C(x, U()));
814
+ let s = E({
815
815
  declared: i,
816
816
  live: await J(a),
817
- dialect: G(),
818
- ...E(),
817
+ dialect: U(),
818
+ ...T(),
819
819
  ...n === void 0 ? {} : { onlineAfter: n }
820
820
  });
821
- X(s), await Ve(s, a);
822
- let c = Re(s), u = c.plan;
823
- if (u.summary.blocked > 0 && !c.acknowledged) return z.error(`db apply: refusing — ${u.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (z.error(" VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), z.error(" `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
824
- if (c.acknowledged && z.warn(`db apply: proceeding with ${s.summary.blocked} acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)`), Ue(u, e)) return 2;
825
- if (u.operations.length === 0) return z.info("db apply: schema is up to date — nothing to apply"), await Qe(a), l(e, "--note") !== void 0 && (z.warn("db apply: --note was ignored — an empty plan writes no history row to attach it to."), console.error("To record that the CURRENT live schema is the accepted baseline, use `voltro db drift --accept`.")), await Y(i, a), 0;
826
- let d = l(e, "--note"), f = await q(a, b.SqlClient.pipe(g.flatMap((e) => C(e, u, {
821
+ X(s), await Ue(s, a);
822
+ let c = Be(s), u = c.plan;
823
+ if (u.summary.blocked > 0 && !c.acknowledged) return L.error(`db apply: refusing — ${u.summary.blocked} blocked operation(s). See the fix hints above.`), process.env.VOLTRO_DESTRUCTIVE_OK !== void 0 && (L.error(" VOLTRO_DESTRUCTIVE_OK is set but did not cover this plan — it only relaxes"), L.error(" `lossy` operations, and only the tables it names. Anything else stays refused.")), 2;
824
+ if (c.acknowledged && L.warn(`db apply: proceeding with ${s.summary.blocked} acknowledged lossy operation(s) (VOLTRO_DESTRUCTIVE_OK)`), Ge(u, e)) return 2;
825
+ if (u.operations.length === 0) return L.info("db apply: schema is up to date — no DDL to apply (change triggers are reconciled separately below)"), await et(a), l(e, "--note") !== void 0 && (L.warn("db apply: --note was ignored — an empty plan writes no history row to attach it to."), console.error("To record that the CURRENT live schema is the accepted baseline, use `voltro db drift --accept`.")), await Y(i, a), 0;
826
+ let d = l(e, "--note"), f = await q(a, b.SqlClient.pipe(g.flatMap((e) => S(e, u, {
827
827
  declared: i,
828
828
  appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user",
829
829
  environment: (process.env.NODE_ENV ?? "dev").toLowerCase() === "staging" ? "staging" : "dev",
830
830
  source: "auto-diff",
831
831
  ...d ? { notes: d } : {},
832
- replan: () => g.promise(() => J(a)).pipe(g.map((e) => O({
832
+ replan: () => g.promise(() => J(a)).pipe(g.map((e) => E({
833
833
  declared: i,
834
834
  live: e,
835
- dialect: G(),
836
- ...E(),
835
+ dialect: U(),
836
+ ...T(),
837
837
  ...n === void 0 ? {} : { onlineAfter: n }
838
838
  })))
839
839
  }))));
840
- return z.info(`db apply: applied ${f.appliedOps} op(s) in ${f.durationMs}ms`, {
840
+ return L.info(`db apply: applied ${f.appliedOps} op(s) in ${f.durationMs}ms`, {
841
841
  id: f.id,
842
842
  fingerprint: f.fingerprint.slice(0, 16)
843
843
  }), await Y(i, a), 0;
844
- }, Je = async (e) => {
844
+ }, Xe = async (e) => {
845
845
  let t = Math.max(1, Number(l(e, "--limit") ?? "20")), n = await q(await K(), b.SqlClient.pipe(g.flatMap((e) => e`
846
846
  SELECT ${e("id")}, ${e("fingerprint")}, ${e("operations")},
847
847
  ${e("appliedBy")}, ${e("environment")}, ${e("source")},
@@ -850,17 +850,17 @@ var _e = class extends Error {
850
850
  ORDER BY ${e("appliedAt")} DESC
851
851
  LIMIT ${t}
852
852
  `)));
853
- if (n.length === 0) return z.info("db plans: no planner-based migrations applied yet"), console.log("Run `voltro db apply` after a schema change to start a plan history."), 0;
853
+ if (n.length === 0) return L.info("db plans: no planner-based migrations applied yet"), console.log("Run `voltro db apply` after a schema change to start a plan history."), 0;
854
854
  console.log(`\n${n.length} plan${n.length === 1 ? "" : "s"} (newest first):\n`);
855
855
  for (let e of n) {
856
856
  let t = 0;
857
857
  try {
858
- t = JSON.parse($e(e.operations)).length;
858
+ t = JSON.parse(tt(e.operations)).length;
859
859
  } catch {}
860
- console.log(` ${e.id} fp=${k(e.fingerprint)} env=${e.environment} src=${e.source} ${t} op(s) ${e.durationMs}ms ${Q(e.appliedAt)} by=${e.appliedBy}`), e.notes && console.log(` [2mnote: ${e.notes}[0m`);
860
+ console.log(` ${e.id} fp=${D(e.fingerprint)} env=${e.environment} src=${e.source} ${t} op(s) ${e.durationMs}ms ${Q(e.appliedAt)} by=${e.appliedBy}`), e.notes && console.log(` [2mnote: ${e.notes}[0m`);
861
861
  }
862
862
  return console.log(), 0;
863
- }, Ye = async (e) => {
863
+ }, Ze = async (e) => {
864
864
  let t = e[0];
865
865
  if (!t) return console.error("voltro db restore-snapshot <plan-id>"), console.error(" Renames soft-dropped columns/tables from a plan back to their original names."), console.error(" Requires the plan to have been applied with VOLTRO_SOFT_DROP=1."), 2;
866
866
  let n = await K(), r = await q(n, b.SqlClient.pipe(g.flatMap((e) => e`SELECT ${e("id")}, ${e("operations")}
@@ -868,7 +868,7 @@ var _e = class extends Error {
868
868
  if (r.length === 0) return console.error(`restore-snapshot: plan '${t}' not found`), 1;
869
869
  let i;
870
870
  try {
871
- i = JSON.parse($e(r[0].operations));
871
+ i = JSON.parse(tt(r[0].operations));
872
872
  } catch {
873
873
  return console.error(`restore-snapshot: plan '${t}' has corrupted operations JSON`), 1;
874
874
  }
@@ -884,7 +884,7 @@ var _e = class extends Error {
884
884
  for (let e of a) {
885
885
  let t = await q(n, b.SqlClient.pipe(g.flatMap((t) => t`
886
886
  SELECT column_name FROM information_schema.columns
887
- WHERE table_schema = 'public'
887
+ WHERE ${t.unsafe(G(U()))}
888
888
  AND table_name = ${e.table}
889
889
  AND column_name LIKE ${e.column + "__dropped_%"}
890
890
  ORDER BY column_name DESC LIMIT 1
@@ -894,13 +894,13 @@ var _e = class extends Error {
894
894
  continue;
895
895
  }
896
896
  let r = t[0].column_name;
897
- await q(n, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${e.table}" RENAME COLUMN "${r}" TO "${e.column}"`)))), s++, console.log(` ↩ restored ${e.table}.${e.column} (from ${r})`);
897
+ await q(n, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE ${W(e.table)} RENAME COLUMN ${W(r)} TO ${W(e.column)}`)))), s++, console.log(` ↩ restored ${e.table}.${e.column} (from ${r})`);
898
898
  }
899
899
  let c = 0;
900
900
  for (let e of o) {
901
901
  let t = await q(n, b.SqlClient.pipe(g.flatMap((t) => t`
902
902
  SELECT table_name FROM information_schema.tables
903
- WHERE table_schema = 'public'
903
+ WHERE ${t.unsafe(G(U()))}
904
904
  AND table_name LIKE ${e.table + "__dropped_%"}
905
905
  ORDER BY table_name DESC LIMIT 1
906
906
  `)));
@@ -909,56 +909,56 @@ var _e = class extends Error {
909
909
  continue;
910
910
  }
911
911
  let r = t[0].table_name;
912
- await q(n, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${r}" RENAME TO "${e.table}"`)))), c++, console.log(` ↩ restored table ${e.table} (from ${r})`);
912
+ await q(n, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE ${W(r)} RENAME TO ${W(e.table)}`)))), c++, console.log(` ↩ restored table ${e.table} (from ${r})`);
913
913
  }
914
914
  return console.log(`\n✓ restored ${s} column(s) + ${c} table(s) from plan '${t}'\n`), 0;
915
- }, Xe = async (e) => {
915
+ }, Qe = async (e) => {
916
916
  let t = l(e, "--before");
917
917
  if (!t) return console.error("voltro db gc-snapshots --before <date> [--dry-run]"), console.error(" Permanently drops soft-dropped columns/tables (<name>__dropped_<ts>) older than <date>."), console.error(" <date> is ISO — e.g. 2026-01-01 or 2026-01-01T00:00:00Z. NOT reversible."), 2;
918
918
  let n = t.replace(/[^0-9]/g, "");
919
919
  if (n.length < 8) return console.error(`gc-snapshots: --before must be at least a full date (YYYY-MM-DD), got "${t}"`), 2;
920
920
  let r = (n + "00000000000000").slice(0, 14), i = e.includes("--dry-run"), a = await K(), o = await q(a, b.SqlClient.pipe(g.flatMap((e) => e`
921
921
  SELECT table_name, column_name FROM information_schema.columns
922
- WHERE table_schema = 'public' AND column_name LIKE ${"%__dropped_%"}
922
+ WHERE ${e.unsafe(G(U()))} AND column_name LIKE ${"%__dropped_%"}
923
923
  `))), s = await q(a, b.SqlClient.pipe(g.flatMap((e) => e`
924
924
  SELECT table_name FROM information_schema.tables
925
- WHERE table_schema = 'public' AND table_name LIKE ${"%__dropped_%"}
925
+ WHERE ${e.unsafe(G(U()))} AND table_name LIKE ${"%__dropped_%"}
926
926
  `))), c = (e) => {
927
927
  let t = /__dropped_(\d{14})$/.exec(e);
928
928
  return t ? t[1] : null;
929
929
  }, u = 0;
930
930
  for (let e of o) {
931
931
  let t = c(e.column_name);
932
- t === null || t >= r || (console.log(` ${i ? "[dry-run] would drop column" : "dropping column"} ${e.table_name}.${e.column_name}`), i || await q(a, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE "${e.table_name}" DROP COLUMN "${e.column_name}"`)))), u++);
932
+ t === null || t >= r || (console.log(` ${i ? "[dry-run] would drop column" : "dropping column"} ${e.table_name}.${e.column_name}`), i || await q(a, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`ALTER TABLE ${W(e.table_name)} DROP COLUMN ${W(e.column_name)}`)))), u++);
933
933
  }
934
934
  for (let e of s) {
935
935
  let t = c(e.table_name);
936
- t === null || t >= r || (console.log(` ${i ? "[dry-run] would drop table" : "dropping table"} ${e.table_name}`), i || await q(a, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`DROP TABLE "${e.table_name}"`)))), u++);
936
+ t === null || t >= r || (console.log(` ${i ? "[dry-run] would drop table" : "dropping table"} ${e.table_name}`), i || await q(a, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(`DROP TABLE ${W(e.table_name)}`)))), u++);
937
937
  }
938
938
  return console.log(`\n${i ? `[dry-run] ${u} snapshot(s) would be dropped` : `✓ dropped ${u} snapshot(s)`} (older than ${r}).\n`), 0;
939
- }, Ze = async (e) => {
939
+ }, $e = async (e) => {
940
940
  let t = l(e, "--before");
941
941
  if (!t) return console.error("voltro db squash --before <iso-date> [--note \"<text>\"]"), 2;
942
942
  let n = t;
943
943
  if (Number.isNaN(new Date(n).getTime())) return console.error(`voltro db squash: --before '${n}' is not a valid ISO date`), 2;
944
- let r = l(e, "--note"), i = V(e), a = await Z(i);
945
- if (a === void 0) return z.warn("db squash: no schema files found", { root: i }), 1;
946
- let o = T(se(a)), s = await K();
944
+ let r = l(e, "--note"), i = z(e), a = await Z(i);
945
+ if (a === void 0) return L.warn("db squash: no schema files found", { root: i }), 1;
946
+ let o = w(ce(a)), s = await K();
947
947
  try {
948
- let e = await q(s, he({
948
+ let e = await q(s, _e({
949
949
  before: n,
950
950
  fingerprint: o,
951
951
  appliedBy: process.env.USER ?? "cli",
952
952
  environment: process.env.NODE_ENV === "production" ? "prod" : "dev",
953
953
  ...r === void 0 ? {} : { note: r }
954
954
  }));
955
- return console.log(`\n✓ squashed ${e.squashedCount} migration plan(s)\n snapshot id: ${e.snapshotId}\n fingerprint: ${k(e.snapshotFingerprint)}\n`), 0;
955
+ return console.log(`\n✓ squashed ${e.squashedCount} migration plan(s)\n snapshot id: ${e.snapshotId}\n fingerprint: ${D(e.snapshotFingerprint)}\n`), 0;
956
956
  } catch (e) {
957
957
  return console.error(`squash refused: ${e.message}`), 1;
958
958
  }
959
- }, Qe = async (e) => {
959
+ }, et = async (e) => {
960
960
  try {
961
- let t = T(await J(e));
961
+ let t = w(await J(e));
962
962
  await q(e, b.SqlClient.pipe(g.flatMap((e) => e`
963
963
  UPDATE ${e("_voltro_migration_plans")}
964
964
  SET ${e("liveFingerprint")} = ${t}
@@ -971,7 +971,7 @@ var _e = class extends Error {
971
971
  AND ${e("liveFingerprint")} IS NULL
972
972
  `)));
973
973
  } catch {}
974
- }, $e = (e) => typeof e == "string" ? e : e == null ? "" : JSON.stringify(e), Q = (e) => e instanceof Date ? e.toISOString() : String(e ?? ""), et = (e) => e === void 0 ? {
974
+ }, tt = (e) => typeof e == "string" ? e : e == null ? "" : JSON.stringify(e), Q = (e) => e instanceof Date ? e.toISOString() : String(e ?? ""), nt = (e) => e === void 0 ? {
975
975
  accept: !1,
976
976
  reason: "no-declared-schema"
977
977
  } : e > 0 ? {
@@ -980,34 +980,34 @@ var _e = class extends Error {
980
980
  } : {
981
981
  accept: !0,
982
982
  reason: "converged"
983
- }, tt = async (e) => {
983
+ }, rt = async (e) => {
984
984
  let t = e.includes("--accept"), n = await K(), r = await q(n, b.SqlClient.pipe(g.flatMap((e) => e`
985
985
  SELECT * FROM ${e("_voltro_migration_plans")}
986
986
  ORDER BY ${e("appliedAt")} DESC
987
987
  LIMIT 1
988
- `))), i = await J(n), a = T(i);
989
- if (r.length === 0) return z.info("db drift: no _voltro_migration_plans rows yet"), console.log(`live user-schema fingerprint: ${k(a)}`), console.log("No baseline to compare against. Run `voltro db apply` to lock in the current state."), 0;
988
+ `))), i = await J(n), a = w(i);
989
+ if (r.length === 0) return L.info("db drift: no _voltro_migration_plans rows yet"), console.log(`live user-schema fingerprint: ${D(a)}`), console.log("No baseline to compare against. Run `voltro db apply` to lock in the current state."), 0;
990
990
  let o = r[0];
991
- if (o.liveFingerprint === null || o.liveFingerprint === void 0) return z.warn("db drift: no drift baseline recorded yet — cannot compare"), console.log(), console.log(` last applied: ${o.id} at ${Q(o.appliedAt)}`), console.log(` live now: ${k(a)}`), console.log(), console.log("That row was written before the framework recorded a live-schema baseline,"), console.log("and the value it does carry is the DECLARED snapshot's hash — not comparable"), console.log("with a live one. Run `voltro db apply` once to establish the baseline (a no-op"), console.log("apply backfills it too); use `voltro db plan` meanwhile, which compares declared"), console.log("against live directly."), console.log(), console.log("Exit code 3 — NOT 0. \"Did not compare\" is not \"clean\", and a gate on the exit"), console.log("code has to be able to tell them apart."), 3;
992
- if (o.liveFingerprint === a) return z.info(`db drift: live matches last applied (${k(a)})`), 0;
991
+ if (o.liveFingerprint === null || o.liveFingerprint === void 0) return L.warn("db drift: no drift baseline recorded yet — cannot compare"), console.log(), console.log(` last applied: ${o.id} at ${Q(o.appliedAt)}`), console.log(` live now: ${D(a)}`), console.log(), console.log("That row was written before the framework recorded a live-schema baseline,"), console.log("and the value it does carry is the DECLARED snapshot's hash — not comparable"), console.log("with a live one. Run `voltro db apply` once to establish the baseline (a no-op"), console.log("apply backfills it too); use `voltro db plan` meanwhile, which compares declared"), console.log("against live directly."), console.log(), console.log("Exit code 3 — NOT 0. \"Did not compare\" is not \"clean\", and a gate on the exit"), console.log("code has to be able to tell them apart."), 3;
992
+ if (o.liveFingerprint === a) return L.info(`db drift: live matches last applied (${D(a)})`), 0;
993
993
  let s = await (async () => {
994
994
  try {
995
- let t = await Z(V(e));
996
- return t === void 0 ? void 0 : O({
995
+ let t = await Z(z(e));
996
+ return t === void 0 ? void 0 : E({
997
997
  declared: t,
998
998
  live: i,
999
- dialect: G(),
1000
- ...E()
999
+ dialect: U(),
1000
+ ...T()
1001
1001
  }).operations;
1002
1002
  } catch {
1003
1003
  return;
1004
1004
  }
1005
1005
  })();
1006
1006
  if (t) {
1007
- let e = et(s?.length);
1008
- if (e.reason === "no-declared-schema") return z.error("db drift --accept: no schema files found — cannot verify the live schema is current."), 1;
1007
+ let e = nt(s?.length);
1008
+ if (e.reason === "no-declared-schema") return L.error("db drift --accept: no schema files found — cannot verify the live schema is current."), 1;
1009
1009
  if (!e.accept && s !== void 0) {
1010
- z.error(`db drift --accept: refusing — ${s.length} operation(s) still pending against your declared schema.`), console.log();
1010
+ L.error(`db drift --accept: refusing — ${s.length} operation(s) still pending against your declared schema.`), console.log();
1011
1011
  for (let e of s.slice(0, 10)) console.log(` - ${e.op.kind} ${"table" in e.op ? `[${e.op.table}]` : ""}`);
1012
1012
  return s.length > 10 && console.log(` … and ${s.length - 10} more`), console.log(), console.log("`--accept` records the CURRENT live schema as the applied baseline. It is for a"), console.log("change that already landed out of band and left the schema correct — not for one"), console.log("that has not landed. Run `voltro db apply` instead; it writes a real baseline."), 4;
1013
1013
  }
@@ -1020,43 +1020,43 @@ var _e = class extends Error {
1020
1020
  ORDER BY ${e("appliedAt")} DESC LIMIT 1
1021
1021
  ) AS ${e("newest")}
1022
1022
  )
1023
- `))), z.info(`db drift: accepted the live schema as the baseline (${k(a)})`), console.log(), console.log("`voltro db plan` reports 0 operations against this schema, so the live state already"), console.log("matches your declaration — only the ledger did not know. It does now."), console.log(), console.log("No history entry was invented: the latest row's baseline was updated in place,"), console.log("because no migration ran."), 0;
1023
+ `))), L.info(`db drift: accepted the live schema as the baseline (${D(a)})`), console.log(), console.log("`voltro db plan` reports 0 operations against this schema, so the live state already"), console.log("matches your declaration — only the ledger did not know. It does now."), console.log(), console.log("No history entry was invented: the latest row's baseline was updated in place,"), console.log("because no migration ran."), 0;
1024
1024
  }
1025
- return z.error("db drift: live schema DIVERGED from last applied state"), console.log(), console.log(` baseline: ${k(o.liveFingerprint)} at ${Q(o.appliedAt)} (${o.id})`), console.log(` live now: ${k(a)}`), console.log(), console.log("Something changed the live schema after the last apply. This command can see"), console.log("THAT it changed, not what or who — the fingerprints are hashes, not a diff."), console.log(), s === void 0 ? (console.log("No schema files found here, so the declared side could not be compared."), console.log("Run `voltro db plan` from your project root for the actual difference."), 4) : s.length === 0 ? (console.log("Your DECLARED schema is already satisfied — `voltro db plan` reports 0 operations"), console.log("against this database. So the live schema is not wrong, only unrecorded: something"), console.log("applied a change without going through the planner (a hand-run ALTER, a DBA"), console.log("window, a restored dump), or it touched a table your code does not declare."), console.log(), console.log("If that was deliberate and the schema is right, record it:"), console.log(), console.log(" voltro db drift --accept"), console.log(), console.log("It updates the latest ledger row's baseline to the live schema and invents no"), console.log("history entry. Drift then measures from here."), 4) : (console.log(`\`voltro db plan\` reports ${s.length} operation(s) still pending against your`), console.log("declared schema, so this is not merely an unrecorded change — run it for the diff,"), console.log("then `voltro db apply`, which writes a fresh baseline of its own."), 4);
1026
- }, nt = async (e, t) => {
1025
+ return L.error("db drift: live schema DIVERGED from last applied state"), console.log(), console.log(` baseline: ${D(o.liveFingerprint)} at ${Q(o.appliedAt)} (${o.id})`), console.log(` live now: ${D(a)}`), console.log(), console.log("Something changed the live schema after the last apply. This command can see"), console.log("THAT it changed, not what or who — the fingerprints are hashes, not a diff."), console.log(), s === void 0 ? (console.log("No schema files found here, so the declared side could not be compared."), console.log("Run `voltro db plan` from your project root for the actual difference."), 4) : s.length === 0 ? (console.log("Your DECLARED schema is already satisfied — `voltro db plan` reports 0 operations"), console.log("against this database. So the live schema is not wrong, only unrecorded: something"), console.log("applied a change without going through the planner (a hand-run ALTER, a DBA"), console.log("window, a restored dump), or it touched a table your code does not declare."), console.log(), console.log("If that was deliberate and the schema is right, record it:"), console.log(), console.log(" voltro db drift --accept"), console.log(), console.log("It updates the latest ledger row's baseline to the live schema and invents no"), console.log("history entry. Drift then measures from here."), 4) : (console.log(`\`voltro db plan\` reports ${s.length} operation(s) still pending against your`), console.log("declared schema, so this is not merely an unrecorded change — run it for the diff,"), console.log("then `voltro db apply`, which writes a fresh baseline of its own."), 4);
1026
+ }, it = async (e, t) => {
1027
1027
  let n = (process.env.NODE_ENV ?? "").toLowerCase() === "production" ? "prod" : (process.env.NODE_ENV ?? "").toLowerCase() === "staging" ? "staging" : "dev";
1028
1028
  try {
1029
- let r = await q(t, b.SqlClient.pipe(g.flatMap((t) => me(t, {
1029
+ let r = await q(t, b.SqlClient.pipe(g.flatMap((t) => ge(t, {
1030
1030
  projectRoot: e,
1031
1031
  env: n,
1032
1032
  appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user"
1033
1033
  }))));
1034
- return r.applied.length > 0 && z.info(`db apply: applied ${r.applied.length} pending file-based migration(s) first`, { applied: r.applied.map((e) => `${e.id} (${e.durationMs}ms)`) }), { applied: r.applied.length };
1034
+ return r.applied.length > 0 && L.info(`db apply: applied ${r.applied.length} pending file-based migration(s) first`, { applied: r.applied.map((e) => `${e.id} (${e.durationMs}ms)`) }), { applied: r.applied.length };
1035
1035
  } catch (e) {
1036
1036
  return { failed: e };
1037
1037
  }
1038
- }, rt = async (e) => {
1039
- let t = V(e), n = await K(), r = (process.env.NODE_ENV ?? "").toLowerCase() === "production" ? "prod" : (process.env.NODE_ENV ?? "").toLowerCase() === "staging" ? "staging" : "dev";
1040
- await q(n, w(x, G()));
1041
- let i = await q(n, b.SqlClient.pipe(g.flatMap((e) => me(e, {
1038
+ }, at = async (e) => {
1039
+ let t = z(e), n = await K(), r = (process.env.NODE_ENV ?? "").toLowerCase() === "production" ? "prod" : (process.env.NODE_ENV ?? "").toLowerCase() === "staging" ? "staging" : "dev";
1040
+ await q(n, C(x, U()));
1041
+ let i = await q(n, b.SqlClient.pipe(g.flatMap((e) => ge(e, {
1042
1042
  projectRoot: t,
1043
1043
  env: r,
1044
1044
  appliedBy: process.env.USER ? `cli:${process.env.USER}` : "cli:user"
1045
1045
  }))));
1046
- return i.applied.length === 0 ? (z.info(`db files: no pending file-based migrations (${i.skipped.length} already applied)`), 0) : (z.info(`db files: applied ${i.applied.length} migration(s)`, {
1046
+ return i.applied.length === 0 ? (L.info(`db files: no pending file-based migrations (${i.skipped.length} already applied)`), 0) : (L.info(`db files: applied ${i.applied.length} migration(s)`, {
1047
1047
  applied: i.applied.map((e) => `${e.id} (${e.durationMs}ms)`),
1048
1048
  skipped: i.skipped.length
1049
1049
  }), 0);
1050
- }, it = async (e) => {
1051
- let t = V(e), n = e.find((e) => !e.startsWith("--"));
1052
- if (!n) return z.error("voltro db rollback-file <migration-id>"), 2;
1053
- if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return z.error("voltro db rollback-file: refusing on prod — schema rollback runs as an explicit deploy step."), 3;
1054
- let r = await q(await K(), b.SqlClient.pipe(g.flatMap((e) => fe(e, {
1050
+ }, ot = async (e) => {
1051
+ let t = z(e), n = e.find((e) => !e.startsWith("--"));
1052
+ if (!n) return L.error("voltro db rollback-file <migration-id>"), 2;
1053
+ if ((process.env.NODE_ENV ?? "").toLowerCase() === "production") return L.error("voltro db rollback-file: refusing on prod — schema rollback runs as an explicit deploy step."), 3;
1054
+ let r = await q(await K(), b.SqlClient.pipe(g.flatMap((e) => me(e, {
1055
1055
  projectRoot: t,
1056
1056
  id: n
1057
1057
  }))));
1058
- return z.info(`db rollback-file: rolled back ${r.id} in ${r.durationMs}ms`), 0;
1059
- }, at = () => {
1058
+ return L.info(`db rollback-file: rolled back ${r.id} in ${r.durationMs}ms`), 0;
1059
+ }, st = () => {
1060
1060
  let e = /* @__PURE__ */ new Date();
1061
1061
  return [
1062
1062
  e.getUTCFullYear(),
@@ -1066,7 +1066,7 @@ var _e = class extends Error {
1066
1066
  String(e.getUTCMinutes()).padStart(2, "0"),
1067
1067
  String(e.getUTCSeconds()).padStart(2, "0")
1068
1068
  ].join("");
1069
- }, ot = (e) => e.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "migration", st = (e, t) => `import { defineMigration, SqlClient } from '@voltro/database'
1069
+ }, ct = (e) => e.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "migration", lt = (e, t) => `import { defineMigration, SqlClient } from '@voltro/database'
1070
1070
  import { Effect } from 'effect'
1071
1071
 
1072
1072
  // A hand-written migration. Reach for this when the DECLARATIVE differ can't
@@ -1099,23 +1099,23 @@ export default defineMigration({
1099
1099
  ],
1100
1100
  })
1101
1101
  `, $ = {
1102
- plan: Ge,
1103
- apply: qe,
1104
- plans: Je,
1105
- drift: tt,
1106
- files: rt,
1107
- "rollback-file": it,
1108
- migrate: ke,
1109
- rollback: Ae,
1110
- status: je,
1111
- seed: Ne,
1102
+ plan: qe,
1103
+ apply: Ye,
1104
+ plans: Xe,
1105
+ drift: rt,
1106
+ files: at,
1107
+ "rollback-file": ot,
1108
+ migrate: je,
1109
+ rollback: Me,
1110
+ status: Ne,
1111
+ seed: Fe,
1112
1112
  generate: async (e) => {
1113
- let { value: t, rest: n } = c(e, "--root"), { value: r, rest: i } = c(n, "--name"), a = t ? m(t) : process.cwd(), o = ot(r ?? u(i) ?? "migration"), s = `${at()}_${o}`, l = f(a, "migrations"), d = f(l, `${s}.migration.ts`);
1114
- return await v.mkdir(l, { recursive: !0 }), await v.writeFile(d, st(s, o), "utf8"), z.info(`created ${p(a, d)}`), console.error("Fill in the apply/undo steps, then run `voltro db migrate` (rollback with `voltro db rollback`)."), console.error("For a plain schema shape change you may not need this — `voltro db apply` diffs declared vs live."), 0;
1113
+ let { value: t, rest: n } = c(e, "--root"), { value: r, rest: i } = c(n, "--name"), a = t ? m(t) : process.cwd(), o = ct(r ?? u(i) ?? "migration"), s = `${st()}_${o}`, l = f(a, "migrations"), d = f(l, `${s}.migration.ts`);
1114
+ return await v.mkdir(l, { recursive: !0 }), await v.writeFile(d, lt(s, o), "utf8"), L.info(`created ${p(a, d)}`), console.error("Fill in the apply/undo steps, then run `voltro db migrate` (rollback with `voltro db rollback`)."), console.error("For a plain schema shape change you may not need this — `voltro db apply` diffs declared vs live."), 0;
1115
1115
  },
1116
- squash: Ze,
1117
- "restore-snapshot": Ye,
1118
- "gc-snapshots": Xe,
1116
+ squash: $e,
1117
+ "restore-snapshot": Ze,
1118
+ "gc-snapshots": Qe,
1119
1119
  adopt: async (e) => {
1120
1120
  let t = (t) => {
1121
1121
  let n = e.indexOf(`--${t}`);
@@ -1129,21 +1129,21 @@ export default defineMigration({
1129
1129
  into: r,
1130
1130
  map: o.map,
1131
1131
  ...o.leaveUnset ? { leaveUnset: o.leaveUnset } : {}
1132
- }, c = G(), l = await K(), u = await q(l, b.SqlClient.pipe(g.flatMap(D))), d = (e) => u.tables.find((t) => t.name === e)?.columns.map((e) => ({
1132
+ }, c = U(), l = await K(), u = await q(l, b.SqlClient.pipe(g.flatMap(de))), d = (e) => u.tables.find((t) => t.name === e)?.columns.map((e) => ({
1133
1133
  name: e.name,
1134
1134
  nullable: e.nullable,
1135
1135
  hasDefault: e.defaultValue !== void 0 && e.defaultValue !== null
1136
1136
  })), f = d(n), p = d(r);
1137
1137
  if (f === void 0) return console.error(`voltro db adopt: '${n}' does not exist in the database`), 1;
1138
1138
  if (p === void 0) return console.error(`voltro db adopt: '${r}' does not exist in the database — boot once so the plugin's table is created`), 1;
1139
- let h = async (e) => await q(l, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(e)))), _ = async (e) => Number(Object.values((await h(`SELECT COUNT(*) AS n FROM "${e}"`))[0] ?? { n: 0 })[0] ?? 0), v = be(s, f, p, await _(r));
1140
- for (let e of Se(s, v, await _(n))) console.log(e);
1139
+ let h = async (e) => await q(l, b.SqlClient.pipe(g.flatMap((t) => t.unsafe(e)))), _ = async (e) => Number(Object.values((await h(`SELECT COUNT(*) AS n FROM "${e}"`))[0] ?? { n: 0 })[0] ?? 0), v = Se(s, f, p, await _(r));
1140
+ for (let e of we(s, v, await _(n))) console.log(e);
1141
1141
  if (v.fatal) return 1;
1142
1142
  if (!e.includes("--apply")) return console.log(""), console.log(" (dry run — nothing written. Re-run with --apply.)"), 0;
1143
- let y = await Te(s, v, c, "id", void 0, h, { keepSource: e.includes("--keep-source") });
1143
+ let y = await De(s, v, c, "id", void 0, h, { keepSource: e.includes("--keep-source") });
1144
1144
  return console.log(""), console.log(` copied ${y.copied}/${y.sourceRows} row(s)`), console.log(` snapshot: ${y.snapshotTable} — restore from here, then drop it yourself`), y.verified ? (console.log(y.sourceDropped ? ` dropped ${n}` : ` ${n} left in place (--keep-source)`), 0) : (console.error(" ✗ counts DIFFER — the source was NOT dropped. Compare the two tables before doing anything else."), 1);
1145
1145
  }
1146
- }, ct = async (e) => {
1146
+ }, ut = async (e) => {
1147
1147
  let [t, ...n] = e;
1148
1148
  if (!t) {
1149
1149
  console.error("voltro db <subcommand> [args]"), console.error("subcommands:");
@@ -1152,9 +1152,9 @@ export default defineMigration({
1152
1152
  }
1153
1153
  let r = $[t];
1154
1154
  if (!r) return console.error(`voltro db: unknown subcommand '${t}'`), 2;
1155
- (process.env.DB_DIRECT_URL !== void 0 || process.env.DB_MIGRATE_URL !== void 0) && z.info("using a DIRECT (non-pooler) connection for the db-command path (DB_DIRECT_URL/DB_MIGRATE_URL set)");
1155
+ (process.env.DB_DIRECT_URL !== void 0 || process.env.DB_MIGRATE_URL !== void 0) && L.info("using a DIRECT (non-pooler) connection for the db-command path (DB_DIRECT_URL/DB_MIGRATE_URL set)");
1156
1156
  let i = (e) => {
1157
- U(e) ? z.error(W) : console.error(e), process.exit(1);
1157
+ V(e) ? L.error(H) : console.error(e), process.exit(1);
1158
1158
  };
1159
1159
  process.on("uncaughtException", i);
1160
1160
  try {
@@ -1164,4 +1164,4 @@ export default defineMigration({
1164
1164
  }
1165
1165
  };
1166
1166
  //#endregion
1167
- export { Ie as a, _e as c, et as i, ve as l, H as n, U as o, Fe as r, ct as s, W as t };
1167
+ export { Re as a, ye as c, nt as i, be as l, B as n, V as o, Le as r, ut as s, H as t };