@codemarc/blt 1.10.1 → 1.10.2

package/README.md

@@ -11,6 +11,7 @@
 - **Bucket**: Supabase storage — list buckets, list/upload/download files, get URLs
 - **Cleanup**: Remove generated SQL/instance files, clean infrequently used YAML tags
 - **Data**: Read-only pull of live menu graph into versioned snapshots; apply to a dev database
+- **Db**: Run ad-hoc SQL strings or `.sql` files; compare schemas between trailz envs
 - **Deploy**: Deploy schema/data from SQL files, run a single SQL file
 - **Env**: Decrypt trailz `.trailz/env/env.<name>.bin` to `.env` via smash (`blt env get`; expands `$VAR` by default; requires `SMASH_KEY`)
 - **Image**: WebP conversion, sharpening, color manipulation, and enhancement
@@ -74,6 +75,7 @@ blt deploy schema
 | `blt bucket`  | names, list, upload, download, url, clear  |
 | `blt cleanup` | generated, tags                            |
 | `blt data`    | Pull / apply instance data snapshots       |
+| `blt db`      | sql, run, dump, patch (schema tools)         |
 | `blt deploy`  | Schema, data, sql file                     |
 | `blt env`     | get (decrypt trailz env to `.env`)         |
 | `blt image`   | Convert, sharpen, enhance, recolor         |
@@ -394,6 +396,87 @@ blt build data my_instance
 
 ---
 
+## Db Commands
+
+Ad-hoc SQL against the load database (`BLT_DATA_LOAD_URL` or `SUPABASE_CONNECTION_STRING`).
+
+### `blt db sql <query>`
+
+Execute a SQL string.
+
+```bash
+blt db sql "SELECT count(*) FROM settings"
+blt db sql "SELECT * FROM settings LIMIT 5" --format json
+blt db sql "SELECT * FROM settings LIMIT 5" --format jsonl
+blt db sql "SELECT name,role FROM profiles LIMIT 5" --format jsonl | jq -c 'select(.role == "manager")'
+blt db sql "SELECT * FROM settings LIMIT 5" --format toon
+blt db sql "SELECT * FROM settings LIMIT 5" --format csv > settings.csv
+blt db sql "UPDATE settings SET props = props WHERE false" --verbose
+```
+
+**Options:**
+
+- `-f, --format <format>` — Result format for SELECT queries: `table` (default), `json`, `jsonl`, `toon`, or `csv`
+- `--verbose` — Execute each statement separately with progress labels
+
+### `blt db run <file>`
+
+Execute a `.sql` file.
+
+```bash
+blt db run ./scripts/my-migration.sql
+blt db run ./dist/bltcore-v1.0.0.sql --verbose
+```
+
+**Options:**
+
+- `--verbose` — Log each SQL statement as it runs
+
+### `blt db dump <env>`
+
+Dump the schema from a single trailz environment (name from `blt env list`).
+
+```bash
+cd data
+blt db dump laf
+blt db dump laf --schema public --dir ./diff
+```
+
+Writes `<env>.sql` (e.g. `laf.sql`) and `manifest.json` under `--dir` (default `diff`).
+
+**Options:**
+
+- `-s, --schema <name>` — Postgres schema to dump (default: `public`)
+- `--dir <path>` — Output directory (default: `diff`)
+
+### `blt db patch <source-env> <target-env>`
+
+Generate a single roll-forward patch SQL file from **source** (desired schema) to **target** (database to update). Does **not** apply the patch — review the file, then run it with `blt db run`.
+
+Names come from `blt env list`; paths ending in `.sql` reuse an existing dump.
+
+```bash
+cd data
+blt db patch laf test1
+blt db patch diff/laf.sql test1
+blt db patch laf test1 --schema public,auth --name p1.sql --dir ./diff
+blt db run ./diff/p1.sql
+```
+
+**`.sql` endpoints:** when either side is a file, Docker loads the dump(s) into temporary Postgres so `supabase db diff` can run.
+
+**Options:**
+
+- `-s, --schema <schemas>` — Comma-separated Postgres schemas (default: `public`)
+- `-n, --name <file>` — Patch SQL filename (default: `patch.sql`)
+- `--dir <path>` — Output directory (default: `diff`)
+
+**Prerequisites:** `SMASH_KEY` (for env endpoints), trailz env bundles at `.trailz/env/env.<name>.bin`, [Supabase CLI](https://supabase.com/docs/guides/cli) on `PATH`, and **Docker** when either side is a `.sql` file path.
+
+Generated SQL is evidence for review — not auto-approved production SQL. Prefer direct Postgres URLs (port 5432) in env bundles when pooler URLs cause patch timeouts.
+
+---
+
 ## Deploy Commands
 
 ### `blt deploy schema [name]`

package/dist/blt

@@ -5,6 +5,7 @@ import bucketCommand from "./commands/bucket";
 import buildCommand from "./commands/build";
 import cleanupCommand from "./commands/cleanup";
 // import dataCommand from "./commands/data";
+import dbCommand from "./commands/db";
 import deployCommand from "./commands/deploy";
 import envCommand from "./commands/env";
 import imageCommand from "./commands/image";
@@ -35,6 +36,7 @@ bucketCommand(program);
 buildCommand(program);
 cleanupCommand(program);
 // dataCommand(program);
+dbCommand(program);
 deployCommand(program);
 envCommand(program);
 imageCommand(program);

package/dist/blt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blt.d.ts","sourceRoot":"","sources":["../src/blt.ts"],"names":[],"mappings":";AA4BA,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C"}
+{"version":3,"file":"blt.d.ts","sourceRoot":"","sources":["../src/blt.ts"],"names":[],"mappings":";AA6BA,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C"}

package/dist/blt.js.map

@@ -1 +1 @@
-{"version":3,"file":"blt.js","sourceRoot":"","sources":["../src/blt.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAC5C,OAAO,cAAc,MAAM,oBAAoB,CAAC;AAChD,6CAA6C;AAC7C,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAC5C,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,eAAe,MAAM,qBAAqB,CAAC;AAClD,OAAO,cAAc,MAAM,oBAAoB,CAAC;AAChD,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,eAAe,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAG,IAAI,EAAE,cAAc,CAAC,CAAC;AAE/D,MAAM,UAAU,iBAAiB;IAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;KACjB,OAAO,CAAC,iBAAiB,EAAE,CAAC;KAC5B,WAAW,CAAC,cAAc,CAAC,CAAC;AAE5B,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,wBAAwB;AACxB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,eAAe,CAAC,OAAO,CAAC,CAAC;AAE3B,uCAAuC;AACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AACD,OAAO,CAAC,GAAG,EAAE,CAAC"}
+{"version":3,"file":"blt.js","sourceRoot":"","sources":["../src/blt.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAC5C,OAAO,cAAc,MAAM,oBAAoB,CAAC;AAChD,6CAA6C;AAC7C,OAAO,SAAS,MAAM,eAAe,CAAC;AACtC,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAC5C,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,eAAe,MAAM,qBAAqB,CAAC;AAClD,OAAO,cAAc,MAAM,oBAAoB,CAAC;AAChD,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,eAAe,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAG,IAAI,EAAE,cAAc,CAAC,CAAC;AAE/D,MAAM,UAAU,iBAAiB;IAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;KACjB,OAAO,CAAC,iBAAiB,EAAE,CAAC;KAC5B,WAAW,CAAC,cAAc,CAAC,CAAC;AAE5B,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,wBAAwB;AACxB,SAAS,CAAC,OAAO,CAAC,CAAC;AACnB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,eAAe,CAAC,OAAO,CAAC,CAAC;AAE3B,uCAAuC;AACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACtB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AACD,OAAO,CAAC,GAAG,EAAE,CAAC"}

package/dist/commands/db/diff-endpoint.d.ts

@@ -0,0 +1,16 @@
+import type { Logger } from "@caporal/core";
+export type DiffEndpoint = {
+    kind: "env";
+    spec: string;
+    dbUrl: string;
+} | {
+    kind: "file";
+    spec: string;
+    path: string;
+};
+export declare function isSqlFileSpec(spec: string): boolean;
+export declare function resolveSqlFilePath(spec: string, cwd: string, logger: Logger): string;
+export declare function resolveDiffEndpoint(spec: string, logger: Logger, cwd: string): DiffEndpoint;
+/** Copy an existing dump into the diff output dir when it is not already there. */
+export declare function materializeDumpArtifact(sourcePath: string, artifactPath: string, logger: Logger): string;
+//# sourceMappingURL=diff-endpoint.d.ts.map

package/dist/commands/db/diff-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-endpoint.d.ts","sourceRoot":"","sources":["../../../src/commands/db/diff-endpoint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,MAAM,YAAY,GACrB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOpF;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACT,YAAY,CAcd;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CACtC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACZ,MAAM,CAQR"}

package/dist/commands/db/diff-endpoint.js

@@ -0,0 +1,39 @@
+import { copyFileSync, existsSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { resolveTrailzConnectionString } from "./env-url";
+export function isSqlFileSpec(spec) {
+    return /\.sql$/i.test(spec.trim());
+}
+export function resolveSqlFilePath(spec, cwd, logger) {
+    const path = isAbsolute(spec) ? spec : resolve(cwd, spec);
+    if (!existsSync(path)) {
+        logger.error(`SQL file not found: ${path}`);
+        process.exit(1);
+    }
+    return path;
+}
+export function resolveDiffEndpoint(spec, logger, cwd) {
+    if (isSqlFileSpec(spec)) {
+        return {
+            kind: "file",
+            spec,
+            path: resolveSqlFilePath(spec, cwd, logger),
+        };
+    }
+    return {
+        kind: "env",
+        spec,
+        dbUrl: resolveTrailzConnectionString(spec, logger, cwd),
+    };
+}
+/** Copy an existing dump into the diff output dir when it is not already there. */
+export function materializeDumpArtifact(sourcePath, artifactPath, logger) {
+    if (resolve(sourcePath) === resolve(artifactPath)) {
+        logger.info(`Using existing dump: ${sourcePath}`);
+        return sourcePath;
+    }
+    copyFileSync(sourcePath, artifactPath);
+    logger.info(`Copied ${sourcePath} → ${artifactPath}`);
+    return artifactPath;
+}
+//# sourceMappingURL=diff-endpoint.js.map

package/dist/commands/db/diff-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-endpoint.js","sourceRoot":"","sources":["../../../src/commands/db/diff-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAM1D,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,GAAW,EAAE,MAAc;IAC3E,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAClC,IAAY,EACZ,MAAc,EACd,GAAW;IAEX,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO;YACN,IAAI,EAAE,MAAM;YACZ,IAAI;YACJ,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC;SAC3C,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,EAAE,KAAK;QACX,IAAI;QACJ,KAAK,EAAE,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC;KACvD,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,uBAAuB,CACtC,UAAkB,EAClB,YAAoB,EACpB,MAAc;IAEd,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,YAAY,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,UAAU,UAAU,MAAM,YAAY,EAAE,CAAC,CAAC;IACtD,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/dist/commands/db/diff.d.ts

@@ -0,0 +1,37 @@
+import type { Logger } from "@caporal/core";
+export type DbDiffOptions = {
+    sourceEnv: string;
+    targetEnv: string;
+    schema: string;
+    dir: string;
+    cwd?: string;
+};
+export type DiffArtifactKey = "source.sql" | "target.sql" | "rollforward.sql" | "rollback.sql";
+export type DiffManifest = {
+    generatedAt: string;
+    source: {
+        kind: "env" | "file";
+        spec: string;
+    };
+    target: {
+        kind: "env" | "file";
+        spec: string;
+    };
+    schema: string;
+    dir: string;
+    connections: {
+        source: string;
+        target: string;
+    };
+    artifacts: Partial<Record<DiffArtifactKey, {
+        path: string;
+        bytes: number;
+    }>>;
+    notes: string[];
+};
+export declare function buildDiffPlan(sourceUrl: string, targetUrl: string, schema: string, outDir: string): {
+    rollforward: string[];
+    rollback: string[];
+};
+export declare function dbDiff(opts: DbDiffOptions, logger: Logger): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/db/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/commands/db/diff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAoB5C,MAAM,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,eAAe,GACxB,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,cAAc,CAAC;AAElB,MAAM,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;IACF,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7E,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,wBAAgB,aAAa,CAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;;;EAgBd;AA4CD,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgH/E"}

package/dist/commands/db/diff.js

@@ -0,0 +1,123 @@
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { runCommand } from "../app/shell";
+import { redactedDbUrl } from "../data/helpers";
+import { materializeDumpArtifact, resolveDiffEndpoint, } from "./diff-endpoint";
+import { resolveSchemaUrlsForDiff } from "./schema-loader";
+import { buildSupabaseDiffArgs, ensureOutDir, fileBytes, prependHeader, requireSupabaseCli, resolveOutDir, runSchemaDump, sqlFileHeader, } from "./supabase-schema";
+export function buildDiffPlan(sourceUrl, targetUrl, schema, outDir) {
+    return {
+        rollforward: buildSupabaseDiffArgs(targetUrl, sourceUrl, schema, join(outDir, "rollforward.sql")),
+        rollback: buildSupabaseDiffArgs(sourceUrl, targetUrl, schema, join(outDir, "rollback.sql")),
+    };
+}
+function connectionLabel(endpoint) {
+    return endpoint.kind === "env"
+        ? redactedDbUrl(endpoint.dbUrl)
+        : endpoint.path;
+}
+function prepareDumpArtifact(endpoint, artifactPath, otherSpec, opts, generatedAt, logger, cwd, side) {
+    const header = sqlFileHeader({
+        command: "diff",
+        kind: "dump",
+        env: endpoint.spec,
+        otherEnv: otherSpec,
+        schema: opts.schema,
+        generatedAt,
+    });
+    if (endpoint.kind === "file") {
+        materializeDumpArtifact(endpoint.path, artifactPath, logger);
+        prependHeader(artifactPath, header);
+        return;
+    }
+    runSchemaDump({
+        dbUrl: endpoint.dbUrl,
+        schema: opts.schema,
+        outputFile: artifactPath,
+        header,
+        logger,
+        cwd,
+        label: side === "source" ? "Dumping source schema…" : "Dumping target schema…",
+    });
+}
+export async function dbDiff(opts, logger) {
+    const cwd = opts.cwd ?? process.cwd();
+    const outDir = resolveOutDir(opts.dir, cwd);
+    const generatedAt = new Date().toISOString();
+    if (opts.sourceEnv === opts.targetEnv) {
+        logger.error("Source and target must differ.");
+        process.exit(1);
+    }
+    requireSupabaseCli(logger);
+    ensureOutDir(outDir, logger);
+    logger.info(`Schema: ${opts.schema}`);
+    const source = resolveDiffEndpoint(opts.sourceEnv, logger, cwd);
+    const target = resolveDiffEndpoint(opts.targetEnv, logger, cwd);
+    const sourceArtifact = join(outDir, "source.sql");
+    const targetArtifact = join(outDir, "target.sql");
+    prepareDumpArtifact(source, sourceArtifact, opts.targetEnv, opts, generatedAt, logger, cwd, "source");
+    prepareDumpArtifact(target, targetArtifact, opts.sourceEnv, opts, generatedAt, logger, cwd, "target");
+    const { sourceUrl, targetUrl, cleanup } = resolveSchemaUrlsForDiff({
+        source: source.kind === "env"
+            ? { kind: "env", dbUrl: source.dbUrl }
+            : { kind: "file", path: sourceArtifact },
+        target: target.kind === "env"
+            ? { kind: "env", dbUrl: target.dbUrl }
+            : { kind: "file", path: targetArtifact },
+        logger,
+    });
+    try {
+        const plan = buildDiffPlan(sourceUrl, targetUrl, opts.schema, outDir);
+        const diffHeader = (kind) => sqlFileHeader({
+            command: "diff",
+            kind,
+            env: opts.sourceEnv,
+            otherEnv: opts.targetEnv,
+            schema: opts.schema,
+            generatedAt,
+        });
+        logger.info("Generating roll-forward SQL (target → source)…");
+        runCommand("supabase", plan.rollforward, logger, { cwd });
+        prependHeader(join(outDir, "rollforward.sql"), diffHeader("rollforward"));
+        logger.info("Generating rollback SQL (source → target)…");
+        runCommand("supabase", plan.rollback, logger, { cwd });
+        prependHeader(join(outDir, "rollback.sql"), diffHeader("rollback"));
+    }
+    finally {
+        cleanup();
+    }
+    const artifacts = {};
+    for (const key of [
+        "source.sql",
+        "target.sql",
+        "rollforward.sql",
+        "rollback.sql",
+    ]) {
+        const path = join(outDir, key);
+        artifacts[key] = { path, bytes: fileBytes(path) };
+    }
+    const manifest = {
+        generatedAt,
+        source: { kind: source.kind, spec: source.spec },
+        target: { kind: target.kind, spec: target.spec },
+        schema: opts.schema,
+        dir: outDir,
+        connections: {
+            source: connectionLabel(source),
+            target: connectionLabel(target),
+        },
+        artifacts,
+        notes: [
+            "Review rollforward.sql before applying to the target database.",
+            "Rollback SQL may include destructive DDL — review before use.",
+            ".sql file endpoints skip re-dump; existing files are copied to source.sql / target.sql when needed.",
+            "Docker is used to load .sql files for supabase db diff when a side is not a live env URL.",
+            "Prefer direct Postgres URLs (port 5432) when pooler URLs cause dump/diff timeouts.",
+        ],
+    };
+    const manifestPath = join(outDir, "manifest.json");
+    writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    logger.info(`Wrote ${manifestPath}`);
+    logger.info("Done. Review rollforward.sql and rollback.sql before applying.");
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/db/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/commands/db/diff.ts"],"names":[],"mappings":"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"}

package/dist/commands/db/dump.d.ts

@@ -0,0 +1,23 @@
+import type { Logger } from "@caporal/core";
+export type DbDumpOptions = {
+    env: string;
+    schema: string;
+    dir: string;
+    cwd?: string;
+};
+export type DumpManifest = {
+    generatedAt: string;
+    env: string;
+    schema: string;
+    dir: string;
+    connection: string;
+    artifacts: {
+        [fileName: string]: {
+            path: string;
+            bytes: number;
+        };
+    };
+};
+export declare function dumpFileName(envName: string): string;
+export declare function dbDump(opts: DbDumpOptions, logger: Logger): Promise<void>;
+//# sourceMappingURL=dump.d.ts.map

package/dist/commands/db/dump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump.d.ts","sourceRoot":"","sources":["../../../src/commands/db/dump.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAY5C,MAAM,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QACV,CAAC,QAAQ,EAAE,MAAM,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD,CAAC;CACF,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C/E"}

package/dist/commands/db/dump.js

@@ -0,0 +1,49 @@
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { redactedDbUrl } from "../data/helpers";
+import { resolveTrailzConnectionString } from "./env-url";
+import { ensureOutDir, fileBytes, requireSupabaseCli, resolveOutDir, runSchemaDump, sqlFileHeader, } from "./supabase-schema";
+export function dumpFileName(envName) {
+    return `${envName}.sql`;
+}
+export async function dbDump(opts, logger) {
+    const cwd = opts.cwd ?? process.cwd();
+    const outDir = resolveOutDir(opts.dir, cwd);
+    const generatedAt = new Date().toISOString();
+    const fileName = dumpFileName(opts.env);
+    const outputFile = join(outDir, fileName);
+    requireSupabaseCli(logger);
+    ensureOutDir(outDir, logger);
+    logger.info(`Schema: ${opts.schema}`);
+    const dbUrl = resolveTrailzConnectionString(opts.env, logger, cwd);
+    runSchemaDump({
+        dbUrl,
+        schema: opts.schema,
+        outputFile,
+        header: sqlFileHeader({
+            command: "dump",
+            kind: "dump",
+            env: opts.env,
+            schema: opts.schema,
+            generatedAt,
+        }),
+        logger,
+        cwd,
+        label: `Dumping ${opts.env} schema…`,
+    });
+    const manifest = {
+        generatedAt,
+        env: opts.env,
+        schema: opts.schema,
+        dir: outDir,
+        connection: redactedDbUrl(dbUrl),
+        artifacts: {
+            [fileName]: { path: outputFile, bytes: fileBytes(outputFile) },
+        },
+    };
+    const manifestPath = join(outDir, "manifest.json");
+    writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    logger.info(`Wrote ${outputFile}`);
+    logger.info(`Wrote ${manifestPath}`);
+}
+//# sourceMappingURL=dump.js.map

package/dist/commands/db/dump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump.js","sourceRoot":"","sources":["../../../src/commands/db/dump.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EACN,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,GACb,MAAM,mBAAmB,CAAC;AAoB3B,MAAM,UAAU,YAAY,CAAC,OAAe;IAC3C,OAAO,GAAG,OAAO,MAAM,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAmB,EAAE,MAAc;IAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE1C,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAEtC,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnE,aAAa,CAAC;QACb,KAAK;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU;QACV,MAAM,EAAE,aAAa,CAAC;YACrB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW;SACX,CAAC;QACF,MAAM;QACN,GAAG;QACH,KAAK,EAAE,WAAW,IAAI,CAAC,GAAG,UAAU;KACpC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAiB;QAC9B,WAAW;QACX,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,EAAE,MAAM;QACX,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC;QAChC,SAAS,EAAE;YACV,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE;SAC9D;KACD,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnD,aAAa,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/commands/db/env-url.d.ts

@@ -0,0 +1,4 @@
+import type { Logger } from "@caporal/core";
+/** Decrypt a trailz env bundle and return `SUPABASE_CONNECTION_STRING`. */
+export declare function resolveTrailzConnectionString(envName: string, logger: Logger, cwd?: string): string;
+//# sourceMappingURL=env-url.d.ts.map

package/dist/commands/db/env-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-url.d.ts","sourceRoot":"","sources":["../../../src/commands/db/env-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAY5C,2EAA2E;AAC3E,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAAsB,GACzB,MAAM,CAiCR"}

package/dist/commands/db/env-url.js

@@ -0,0 +1,34 @@
+import { ensureAppEnv, parseDotEnvAssignments, resolveTrailzEnvPaths, } from "../app/env-check";
+import { decryptTrailzEnvBase } from "../app/env-decrypt";
+import { redactedDbUrl } from "../data/helpers";
+import { readTrailzKeysExpansionContext } from "../notify/keys";
+const NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+/** Decrypt a trailz env bundle and return `SUPABASE_CONNECTION_STRING`. */
+export function resolveTrailzConnectionString(envName, logger, cwd = process.cwd()) {
+    if (!NAME_RE.test(envName)) {
+        logger.error(`Invalid environment name "${envName}": use one segment (letters, numbers, . _ -).`);
+        process.exit(1);
+    }
+    ensureAppEnv({ envName, cwd, logger, trailzOnly: true });
+    const resolved = resolveTrailzEnvPaths(cwd, envName);
+    if (!resolved) {
+        logger.error(`Trailz env bundle not found for "${envName}"`);
+        process.exit(1);
+    }
+    const keysContext = readTrailzKeysExpansionContext({ cwd });
+    const body = decryptTrailzEnvBase(resolved.basePath, {
+        cwd,
+        expand: true,
+        expansionContext: keysContext,
+    });
+    const parsed = parseDotEnvAssignments(body);
+    const url = parsed.SUPABASE_CONNECTION_STRING;
+    if (!url) {
+        logger.error(`SUPABASE_CONNECTION_STRING not found in trailz env "${envName}".\n` +
+            `  Run: blt env get ${envName} and verify the bundle contents.`);
+        process.exit(1);
+    }
+    logger.info(`Resolved ${envName} → ${redactedDbUrl(url)}`);
+    return url;
+}
+//# sourceMappingURL=env-url.js.map

package/dist/commands/db/env-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-url.js","sourceRoot":"","sources":["../../../src/commands/db/env-url.ts"],"names":[],"mappings":"AACA,OAAO,EACN,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,OAAO,GAAG,8BAA8B,CAAC;AAE/C,2EAA2E;AAC3E,MAAM,UAAU,6BAA6B,CAC5C,OAAe,EACf,MAAc,EACd,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CACX,6BAA6B,OAAO,+CAA+C,CACnF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,OAAO,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,8BAA8B,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE;QACpD,GAAG;QACH,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,WAAW;KAC7B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,0BAA0B,CAAC;IAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,CACX,uDAAuD,OAAO,MAAM;YACnE,sBAAsB,OAAO,kCAAkC,CAChE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,MAAM,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/commands/db/patch.d.ts

@@ -0,0 +1,14 @@
+import type { Logger } from "@caporal/core";
+export type DbPatchOptions = {
+    sourceEnv: string;
+    targetEnv: string;
+    schema: string;
+    name: string;
+    dir: string;
+    cwd?: string;
+};
+export declare const DEFAULT_PATCH_NAME = "patch.sql";
+/** Roll-forward diff args: apply to target so it matches source. */
+export declare function buildPatchArgs(sourceUrl: string, targetUrl: string, schema: string, outputFile: string): string[];
+export declare function dbPatch(opts: DbPatchOptions, logger: Logger): Promise<void>;
+//# sourceMappingURL=patch.d.ts.map

package/dist/commands/db/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../src/commands/db/patch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAe5C,MAAM,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,oEAAoE;AACpE,wBAAgB,cAAc,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAChB,MAAM,EAAE,CAEV;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DjF"}

package/dist/commands/db/patch.js

@@ -0,0 +1,58 @@
+import { join } from "node:path";
+import { runCommand } from "../app/shell";
+import { resolveDiffEndpoint } from "./diff-endpoint";
+import { resolveSchemaUrlsForDiff } from "./schema-loader";
+import { buildSupabaseDiffArgs, ensureOutDir, fileBytes, normalizeSchemaOption, prependHeader, requireSupabaseCli, resolveOutDir, sqlFileHeader, } from "./supabase-schema";
+export const DEFAULT_PATCH_NAME = "patch.sql";
+/** Roll-forward diff args: apply to target so it matches source. */
+export function buildPatchArgs(sourceUrl, targetUrl, schema, outputFile) {
+    return buildSupabaseDiffArgs(targetUrl, sourceUrl, schema, outputFile);
+}
+export async function dbPatch(opts, logger) {
+    const cwd = opts.cwd ?? process.cwd();
+    const outDir = resolveOutDir(opts.dir, cwd);
+    const schema = normalizeSchemaOption(opts.schema);
+    const generatedAt = new Date().toISOString();
+    const outputFile = join(outDir, opts.name);
+    if (!schema) {
+        logger.error("At least one schema is required (e.g. --schema public or public,auth).");
+        process.exit(1);
+    }
+    if (opts.sourceEnv === opts.targetEnv) {
+        logger.error("Source and target must differ.");
+        process.exit(1);
+    }
+    requireSupabaseCli(logger);
+    ensureOutDir(outDir, logger);
+    logger.info(`Schema: ${schema}`);
+    const source = resolveDiffEndpoint(opts.sourceEnv, logger, cwd);
+    const target = resolveDiffEndpoint(opts.targetEnv, logger, cwd);
+    const { sourceUrl, targetUrl, cleanup } = resolveSchemaUrlsForDiff({
+        source: source.kind === "env"
+            ? { kind: "env", dbUrl: source.dbUrl }
+            : { kind: "file", path: source.path },
+        target: target.kind === "env"
+            ? { kind: "env", dbUrl: target.dbUrl }
+            : { kind: "file", path: target.path },
+        logger,
+    });
+    try {
+        logger.info("Generating patch SQL (target → source)…");
+        runCommand("supabase", buildPatchArgs(sourceUrl, targetUrl, schema, outputFile), logger, { cwd });
+        prependHeader(outputFile, sqlFileHeader({
+            command: "patch",
+            kind: "patch",
+            env: opts.sourceEnv,
+            otherEnv: opts.targetEnv,
+            schema,
+            generatedAt,
+        }));
+    }
+    finally {
+        cleanup();
+    }
+    const bytes = fileBytes(outputFile);
+    logger.info(`Wrote ${outputFile} (${bytes} bytes)`);
+    logger.info(`Apply when ready: blt db run ${outputFile}`);
+}
+//# sourceMappingURL=patch.js.map

package/dist/commands/db/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../src/commands/db/patch.ts"],"names":[],"mappings":"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"}

package/dist/commands/db/run.d.ts

@@ -0,0 +1,4 @@
+import type { Logger } from "@caporal/core";
+import { type RunSqlOptions } from "../../lib/database-runner";
+export declare function dbRun(filePath: string, options: RunSqlOptions, logger: Logger): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/db/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/db/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE3E,wBAAsB,KAAK,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/commands/db/run.js

@@ -0,0 +1,19 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { runSqlFile } from "../../lib/database-runner";
+export async function dbRun(filePath, options, logger) {
+    const resolved = resolve(filePath);
+    if (!existsSync(resolved)) {
+        logger.error(`SQL file not found: ${resolved}`);
+        process.exit(1);
+    }
+    try {
+        await runSqlFile(resolved, undefined, options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to run SQL file: ${message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/db/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/commands/db/run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAsB,MAAM,2BAA2B,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,KAAK,CAC1B,QAAgB,EAChB,OAAsB,EACtB,MAAc;IAEd,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACF,CAAC"}