@vibeorm/migrate 2.4.0 → 2.6.0

package/README.md

@@ -52,6 +52,8 @@ await applyMigrations({ executor, migrations: [migration], dialect: "postgres" }
 const live = await pull({ executor, dialect: "postgres" });
 ```
 
+Objects another tool owns are declared as plain `ExternalObjectOwner` data. `parseExternalObjects` validates declarations without a database, `inspectExternalObjects({ executor, dialect, external })` resolves them against the catalog, and `push` accepts that resolution as `external`; `applyMigrations` takes the plain declarations as `external` and resolves them under its lock. PostgreSQL and PGlite only. See [external objects](https://github.com/vibeorm/vibeorm/blob/master/docs/migrations.md#objects-owned-by-another-tool-external).
+
 `SqlExecutor` calls must all reach the same database session — the engine issues `BEGIN`/`COMMIT`, `PRAGMA` and advisory-lock statements through it. Pool-backed executors must pin one connection for the whole operation.
 
 ## Links

package/dist/artifact-probe.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Server-normalized definition check for PRESENT extension artifacts on
+ * PostgreSQL. The chain's SQL-first history carries no authored snapshot to
+ * compare declarations against, and predicting the catalog's spelling of an
+ * artifact (`pg_get_indexdef` renders `("street"::pdb.edge_ngram(1, 12))` as
+ * `(("street")::pdb.edge_ngram('1', '12'))`) would be a textual guess. So the
+ * server spells both sides: the object's catalog facts as they are, then again
+ * after the artifact's own drop + create ran inside a savepoint that is rolled
+ * back. A differing definition is a real change — a bm25 tokenizer, a
+ * tsvector expression, an hnsw option — never a formatting artifact.
+ *
+ * Meant for the replay shadow inside the caller's rollback probe transaction:
+ * its tables are empty, so the probe create is instant. It must NEVER be
+ * followed by a real create in the same session: ParadeDB caches tokenizer
+ * typmods per backend, a typmod first minted inside the rolled-back savepoint
+ * stays in that cache while its `paradedb._typmod_cache` row is gone, and an
+ * index built afterwards from the cached id is unreadable from every other
+ * connection ("should not fail to load typmod: Spi(InvalidPosition)"). The
+ * shadow session ends after planning; the live push planner rebuilds for real
+ * (`rebuildArtifacts`) instead of probing.
+ */
+import type { ExtensionArtifact } from "@vibeorm/schema";
+import type { SqlExecutor } from "./types.ts";
+/** An artifact the plan drops and creates again, with the statements that put its previous definition back when the catalog can spell them. */
+export type RebuiltArtifact = {
+    readonly artifact: ExtensionArtifact;
+    /** Absent when the previous definition cannot be restored automatically (a generated column, a trigger). */
+    readonly restore?: readonly string[];
+};
+/**
+ * Probe every given artifact (all present, all on PostgreSQL) and return the
+ * ones whose catalog definition differs from what their create statements
+ * produce. Index rebuilds carry the catalog's own `CREATE INDEX` spelling as
+ * their restore statement — valid DDL, the way pg_dump emits it.
+ */
+export declare function probeChangedArtifacts(params: {
+    executor: SqlExecutor;
+    namespace: string;
+    artifacts: readonly ExtensionArtifact[];
+}): Promise<RebuiltArtifact[]>;
+//# sourceMappingURL=artifact-probe.d.ts.map

package/dist/artifact-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-probe.d.ts","sourceRoot":"","sources":["../src/artifact-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,+IAA+I;AAC/I,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,4GAA4G;IAC5G,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC;AAIF;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACzC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAuB7B"}

package/dist/compare-sqlite-primary-key.d.ts

@@ -1,5 +1,5 @@
 import type { MigrationStateReport } from "./inspect-objects.ts";
-/** Accept only proven single INTEGER NOT NULL key syntax changes; retain every other difference. */
+/** Accept only proven table layout and single INTEGER NOT NULL key syntax changes; retain every other difference. */
 export declare function compareSqlitePrimaryKeyRepresentations(params: {
     report: MigrationStateReport;
 }): MigrationStateReport;

package/dist/compare-sqlite-primary-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compare-sqlite-primary-key.d.ts","sourceRoot":"","sources":["../src/compare-sqlite-primary-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAwB,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAmDvF,oGAAoG;AACpG,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAAG,oBAAoB,CAoBrH"}
+{"version":3,"file":"compare-sqlite-primary-key.d.ts","sourceRoot":"","sources":["../src/compare-sqlite-primary-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAwB,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAwDvF,qHAAqH;AACrH,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAAG,oBAAoB,CAqBrH"}

package/dist/ddl/mysql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/ddl/mysql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAMjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf,GAAG,MAAM,EAAE,CA2DX"}
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/ddl/mysql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAMjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf,GAAG,MAAM,EAAE,CA6DX"}

package/dist/ddl/postgres.d.ts

@@ -9,7 +9,7 @@
  *   no sequence-name coupling; postgres ≥10 and pglite both support it) — not
  *   SERIAL. The introspector maps identity columns back to autoincrement.
  * - DROP TABLE is restricted; the differ drops dependent foreign keys first.
- * - Core table, enum and index identities always target the public namespace.
+ * - Explicit namespaces qualify identifiers; omitted steps retain public DDL.
  * - scalar→array type changes carry the LEARNINGS `USING CASE WHEN col IS NULL
  *   THEN NULL ELSE ARRAY[col] END` repair clause (postgres cannot implicit-cast).
  * - `ALTER TYPE ... ADD VALUE IF NOT EXISTS` appends at the end of the enum

package/dist/ddl/rls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rls.d.ts","sourceRoot":"","sources":["../../src/ddl/rls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAElE;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,EAAE,CAgBxE;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAMrF;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CACjC,GAAG,aAAa,EAAE,CAuDlB;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,OAAO,CAElE;AAED,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAmBzF;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAEvF;AAED,+FAA+F;AAC/F,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IAAE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAOnI"}
+{"version":3,"file":"rls.d.ts","sourceRoot":"","sources":["../../src/ddl/rls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAElE;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,EAAE,CAgBxE;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAerF;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CACjC,GAAG,aAAa,EAAE,CA0DlB;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,OAAO,CAElE;AAED,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAmBzF;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAEvF;AAED,+FAA+F;AAC/F,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IAAE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAOnI"}

package/dist/ddl/sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/ddl/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAGH,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAajE,OAAO,KAAK,EAAe,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK3E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACjD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;CACpH,GAAG,MAAM,EAAE,CA8NX;AAiED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,GAAG;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAUjD;AAED,iFAAiF;AACjF,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/ddl/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAGH,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAajE,OAAO,KAAK,EAAe,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK3E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACjD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;CACpH,GAAG,MAAM,EAAE,CAkOX;AAiED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,GAAG;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAUjD;AAED,iFAAiF;AACjF,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB"}

package/dist/differ.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../src/differ.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAU,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAOjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAqB,aAAa,EAAE,MAAM,YAAY,CAAC;AAsCnE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CACnC,GAAG,aAAa,EAAE,CAoFlB"}
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../src/differ.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAU,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAOjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAqB,aAAa,EAAE,MAAM,YAAY,CAAC;AAuCnE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CACnC,GAAG,aAAa,EAAE,CA8FlB"}

package/dist/down.d.ts

@@ -17,11 +17,17 @@
  *
  * Extension artifacts: object artifacts the up migration created (columns,
  * indexes, shadow tables, triggers) are dropped by the down migration via
- * their own `drop` SQL. `CREATE EXTENSION`-class artifacts are never dropped
- * — other database objects may depend on the extension — and are reported in
- * `skipped` instead.
+ * their own `drop` SQL; artifacts the up migration REBUILT (a changed
+ * definition) are dropped and created again from the previous declarations.
+ * `CREATE EXTENSION`-class artifacts are never dropped — other database
+ * objects may depend on the extension — and are reported in `skipped`
+ * instead. "Created by the up migration" is decided against the unstripped
+ * physical state when the caller has one, otherwise against the previous
+ * authored declarations: an artifact both schemas declare existed before.
  */
 import type { Dialect, SchemaIR, VibeExtension } from "@vibeorm/schema";
+import type { InstalledExtensionState } from "./extensions.ts";
+import type { RebuiltArtifact } from "./artifact-probe.ts";
 /** A generated down migration: reverse SQL plus what could NOT be reversed. */
 export type DownMigrationFile = {
     /** Actual rollback declaration, including retained enum values and nullable re-added columns. */
@@ -55,5 +61,17 @@ export declare function generateDownMigration(params: {
     dialect?: Dialect;
     /** Configured extension instances — their up-created artifacts are dropped. */
     extensions?: readonly VibeExtension[];
+    /**
+     * Unstripped physical state before the up migration (live generation). It
+     * decides which artifacts the up migration created; a stripped `from` would
+     * claim every one of them. Defaults to the previous declarations' artifacts.
+     */
+    physical?: SchemaIR;
+    /** Owners `physical` cannot show (installed postgres extensions, triggers), probed live beside it. */
+    installed?: InstalledExtensionState;
+    /** The last authored schema the artifacts were generated from; defaults to `from`. */
+    previousDeclarations?: SchemaIR;
+    /** The up plan's own rebuild list (live generation, `SchemaMigrationPlan.rebuiltArtifacts`); computed from the declarations when absent. */
+    rebuilt?: readonly RebuiltArtifact[];
 }): DownMigrationFile;
 //# sourceMappingURL=down.d.ts.map

package/dist/down.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../src/down.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAU,QAAQ,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAahF,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAqEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CACvC,GAAG,iBAAiB,CAyEpB"}
+{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../src/down.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAU,QAAQ,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAYhF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAwEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sGAAsG;IACtG,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,sFAAsF;IACtF,oBAAoB,CAAC,EAAE,QAAQ,CAAC;IAChC,4IAA4I;IAC5I,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACtC,GAAG,iBAAiB,CA+FpB"}

package/dist/enum-values.d.ts

@@ -14,6 +14,7 @@ import type { Dialect, EnumIR, FieldIR } from "@vibeorm/schema";
  */
 export declare function resolveEnumValues(params: {
     name: string;
+    namespace?: string;
     enums: ReadonlyMap<string, EnumIR>;
 }): readonly string[] | undefined;
 /** Storage transitions are detected on physical fields, after normalization. */

package/dist/enum-values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enum-values.d.ts","sourceRoot":"","sources":["../src/enum-values.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAQhC;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAGtF;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAaxI"}
+{"version":3,"file":"enum-values.d.ts","sourceRoot":"","sources":["../src/enum-values.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAQhC;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAGtF;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAaxI"}

package/dist/exclusions.d.ts

@@ -6,6 +6,7 @@ import type { MigrationObjectState } from "./inspect-objects.ts";
 export declare function deparseExclusion(params: {
     executor: SqlExecutor;
     table: string;
+    namespace?: string;
     definition: string;
 }): Promise<string>;
 /** Establish definition equivalence before the pure differ sees catalog SQL. */

package/dist/exclusions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exclusions.d.ts","sourceRoot":"","sources":["../src/exclusions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAe,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAA4B,MAAM,sBAAsB,CAAC;AAE3F,6GAA6G;AAC7G,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAY5H;AAED,gFAAgF;AAChF,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuBpN;AAED,+FAA+F;AAC/F,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgBjJ"}
+{"version":3,"file":"exclusions.d.ts","sourceRoot":"","sources":["../src/exclusions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAe,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAA4B,MAAM,sBAAsB,CAAC;AAE3F,6GAA6G;AAC7G,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAYhJ;AAED,gFAAgF;AAChF,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuBpN;AAED,+FAA+F;AAC/F,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgBjJ"}

package/dist/extensions.d.ts

@@ -14,24 +14,46 @@
  *      checking the introspected IR for their owners (columns, indexes,
  *      tables by name); non-introspectable owners (postgres extensions,
  *      triggers) rely on their idempotent IF NOT EXISTS forms and always run.
+ *   4. `planChangedArtifacts` decides which PRESENT artifacts must be dropped
+ *      and created again because their definition changed since the last
+ *      authored schema — `IF NOT EXISTS` would keep the old object silently.
  *
  * Removing a declaration does NOT auto-drop its artifacts (mirrors the v1
  * phantom-join-table precedent) — `drop` SQL is carried for tooling, not
  * scheduled by push.
  */
 import type { Dialect, ExtensionArtifact, SchemaIR, VibeExtension } from "@vibeorm/schema";
+import type { MigrationFile } from "./types.ts";
+/** The object artifacts one extension contributed, in its own order. */
+export type ArtifactGroup = {
+    readonly extension: string;
+    readonly objects: readonly ExtensionArtifact[];
+};
 /** Artifacts of every configured extension for this schema, in order. */
 export type CollectedArtifacts = {
     /** CREATE EXTENSION-class artifacts — run BEFORE the core diff SQL. */
     readonly setup: readonly ExtensionArtifact[];
     /** Object artifacts (columns, indexes, shadow tables, triggers) — run AFTER. */
     readonly objects: readonly ExtensionArtifact[];
+    /** `objects`, grouped by the extension that contributed them (rebuild scope). */
+    readonly groups: readonly ArtifactGroup[];
 };
 export declare function collectExtensionArtifacts(params: {
     schema: SchemaIR;
     dialect: Dialect;
     extensions: readonly VibeExtension[];
 }): CollectedArtifacts;
+/**
+ * The last authored schema in a migration chain — the declarations its newest
+ * snapshot-bearing migration was generated from. Only extension declarations
+ * are read from it (`planChangedArtifacts`), never physical expectations, so
+ * an ordinary SQL successor does not disqualify it the way it disqualifies a
+ * deployed desired state: a hand-written index change after the snapshot is
+ * at worst rebuilt once more, visibly, in reviewed SQL.
+ */
+export declare function lastDeclaredSchema(params: {
+    migrations: readonly MigrationFile[];
+}): SchemaIR | undefined;
 /**
  * Remove extension-owned objects from an INTROSPECTED SchemaIR so the core
  * differ never sees them (they are neither dropped nor re-created by it).
@@ -71,4 +93,34 @@ export declare function probeInstalledExtensionState(params: {
 export declare function artifactCreateSql(params: {
     artifacts: readonly ExtensionArtifact[];
 }): string[];
+/**
+ * Present object artifacts whose definition changed since the previously
+ * authored schema. The same extension code renders both sides, so only a real
+ * declaration, column or option change differs — and for such a change an
+ * idempotent `CREATE … IF NOT EXISTS` keeps the OLD object silently (a bm25
+ * index its old tokenizer, a tsvector column its old weights, an hnsw index
+ * its old `m`). Those artifacts are dropped and created again.
+ *
+ * Two sources say "changed": the previous authored declarations, when the
+ * caller has them, and `probed` — artifacts a server-side probe found to
+ * differ from their own create statements (`probeChangedArtifacts`).
+ *
+ * A rebuilt COLUMN takes the same extension's indexes and triggers on that
+ * table with it: dropping a generated column drops the index on it, whose own
+ * text is unchanged. The rebuild never touches CREATE EXTENSION-class
+ * artifacts (dropping an extension drops everything depending on it),
+ * artifacts in `missing` (their create runs anyway and their drop may not be
+ * idempotent) or artifacts whose owner moved (a renamed index is left to
+ * presence planning and the core differ's unmanaged-removal review).
+ */
+export declare function planChangedArtifacts(params: {
+    previous?: CollectedArtifacts;
+    current: CollectedArtifacts;
+    missing: readonly ExtensionArtifact[];
+    probed?: readonly ExtensionArtifact[];
+}): ExtensionArtifact[];
+/** Drops of a rebuild, newest artifact first, so a dependent index goes before its column. */
+export declare function artifactDropSql(params: {
+    artifacts: readonly ExtensionArtifact[];
+}): string[];
 //# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EAEjB,QAAQ,EACR,aAAa,EACd,MAAM,iBAAiB,CAAC;AAIzB,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CACtC,GAAG,kBAAkB,CAwBrB;AAkBD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACzC,GAAG,QAAQ,CAyCX;AAID,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAAG;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,YAAY,EAAE,QAAQ,CAAC;IACvB,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC,SAAS,CAAC,EAAE,uBAAuB,CAAC;CACrC,GAAG,iBAAiB,EAAE,CA8BtB;AAED,iFAAiF;AACjF,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,QAAQ,EAAE,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACnG,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACzC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAiBnC;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACzC,GAAG,MAAM,EAAE,CAEX"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"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"}

package/dist/external-dependencies.d.ts

@@ -0,0 +1,37 @@
+import type { Dialect, SqlObjectIdentity } from "@vibeorm/schema";
+import type { ExternalDependentTarget } from "@vibeorm/sql";
+import type { ExternalObjectResolution } from "./external-objects.ts";
+import type { MigrationStep, SqlExecutor } from "./types.ts";
+/** An application object a planned step drops or retypes, with the identity reported on refusal. */
+export type ExternalDependencyTarget = ExternalDependentTarget & {
+    readonly dependency: SqlObjectIdentity;
+};
+/**
+ * Application objects whose planned change can break another owner's objects:
+ * dropped enums, tables, join tables, views and columns, and retyped columns.
+ * Additive steps, enum value additions and nullability/default changes keep
+ * every existing dependent valid; enum value removal is refused by the differ.
+ */
+export declare function externalDependencyTargets(params: {
+    steps: readonly MigrationStep[];
+    namespace: string;
+}): readonly ExternalDependencyTarget[];
+/**
+ * Refuse when any catalog dependent of a target belongs to an external owner.
+ * Application, unmanaged and unattributable dependents (casts) are left to the
+ * existing unmanaged-removal checks and to PostgreSQL's RESTRICT drops.
+ */
+export declare function assertNoExternalDependents(params: {
+    external: ExternalObjectResolution;
+    targets: readonly ExternalDependencyTarget[];
+    rows: readonly Record<string, unknown>[];
+}): void;
+/** Read catalog dependents of the planned drops/retypes and refuse external ones before any DDL. */
+export declare function refuseExternalDependents(params: {
+    executor: SqlExecutor;
+    dialect: Dialect;
+    external: ExternalObjectResolution;
+    steps: readonly MigrationStep[];
+    namespace: string;
+}): Promise<void>;
+//# sourceMappingURL=external-dependencies.d.ts.map

package/dist/external-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-dependencies.d.ts","sourceRoot":"","sources":["../src/external-dependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,oGAAoG;AACpG,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAI5G;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,wBAAwB,EAAE,CAY7I;AA4CD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,wBAAwB,CAAC;IAAC,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CAAE,GAAG,IAAI,CAevL;AAED,oGAAoG;AACpG,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzM"}

package/dist/external-objects.d.ts

@@ -0,0 +1,122 @@
+import type { Dialect, QualifiedSqlName, SchemaIR, SqlObjectIdentity } from "@vibeorm/schema";
+import type { CatalogObject } from "./inventory.ts";
+import type { DesiredState } from "./desired-state.ts";
+import type { SqlExecutor } from "./types.ts";
+/** Plain-data ownership of a namespace or named public relations/routines. */
+export type ExternalObjectOwner = {
+    readonly owner: string;
+    readonly schema: string;
+    readonly tables?: never;
+    readonly partitions?: never;
+    readonly functions?: never;
+} | {
+    readonly owner: string;
+    readonly schema?: never;
+    readonly tables?: readonly string[];
+    readonly partitions?: readonly {
+        readonly parent: string;
+        readonly pattern: string;
+    }[];
+    readonly functions?: readonly string[];
+};
+/** Validate config and regular-expression syntax without opening a database. */
+export declare function parseExternalObjects(params: {
+    value: unknown;
+    dialect?: Dialect;
+}): Promise<readonly ExternalObjectOwner[]>;
+/** Catalog edges retain their exact endpoints, including other namespaces. */
+export type ExternalOwnershipCatalog = {
+    readonly namespaces: readonly string[];
+    readonly inventory: readonly CatalogObject[];
+    readonly inheritance: readonly {
+        readonly parent: QualifiedSqlName;
+        readonly child: QualifiedSqlName;
+    }[];
+    readonly ownedSequences: readonly {
+        readonly table: QualifiedSqlName;
+        readonly sequence: QualifiedSqlName;
+    }[];
+    readonly foreignKeys: readonly {
+        readonly table: QualifiedSqlName;
+        readonly target: QualifiedSqlName;
+        readonly name: string;
+    }[];
+    readonly coverageGaps?: readonly Record<string, unknown>[];
+};
+/** Ordinary routine declarations report missing names without inventing a signature. */
+export type MissingExternalObject = {
+    readonly kind: "namespace";
+    readonly name: string;
+} | {
+    readonly kind: "table" | "function";
+    readonly name: QualifiedSqlName;
+};
+/** Exclusion is an ownership report, never structural verification of another tool's objects. */
+export type ExternalOwnerReport = {
+    readonly owner: string;
+    readonly state: "excluded";
+    readonly count: number;
+    readonly identities: readonly SqlObjectIdentity[];
+    readonly missing: readonly MissingExternalObject[];
+};
+type OwnedName = {
+    readonly owner: string;
+    readonly name: QualifiedSqlName;
+};
+/** Keep full observations beside comparison-only ownership closure. */
+export type ExternalObjectResolution = {
+    readonly declarations: readonly ExternalObjectOwner[];
+    readonly catalog: ExternalOwnershipCatalog;
+    readonly inventory: readonly CatalogObject[];
+    readonly owners: readonly ExternalOwnerReport[];
+    readonly identities: readonly SqlObjectIdentity[];
+    readonly tables: readonly OwnedName[];
+    readonly sequences: readonly OwnedName[];
+};
+/** Match exact qualified ownership, including missing declarations and full-name patterns. */
+export declare function externalObjectOwner(params: {
+    identity: SqlObjectIdentity;
+    external: ExternalObjectResolution;
+}): string | undefined;
+/** Resolve validated plain declarations from complete catalog observations, without DDL. */
+export declare function resolveExternalObjectOwnership(params: {
+    external: readonly ExternalObjectOwner[];
+    catalog: ExternalOwnershipCatalog;
+    dialect: Dialect;
+}): ExternalObjectResolution;
+/** Read all ownership edges and retain unfiltered inventory for dependency safety. */
+export declare function inspectExternalObjects(params: {
+    executor: SqlExecutor;
+    dialect: Dialect;
+    external: readonly ExternalObjectOwner[];
+    inventory?: readonly CatalogObject[];
+}): Promise<ExternalObjectResolution>;
+/** Refuse app/module/external collisions even when the target object does not yet exist. */
+export declare function assertExternalOwnershipClaims(params: {
+    external: ExternalObjectResolution;
+    identities: readonly SqlObjectIdentity[];
+}): void;
+/** Comparison-only projection; shared enum types do not follow a named table. */
+export declare function projectExternalSchema(params: {
+    schema: SchemaIR;
+    external: ExternalObjectResolution;
+}): SchemaIR;
+/** Do not mutate checksum-bound state while surrendering comparison ownership. */
+export declare function projectExternalState(params: {
+    state: DesiredState;
+    external: ExternalObjectResolution;
+}): DesiredState;
+/** Drop external identities from comparisons only; resolution keeps the original inventory. */
+export declare function projectExternalInventory(params: {
+    inventory: readonly CatalogObject[];
+    external: ExternalObjectResolution;
+}): readonly CatalogObject[];
+/** Exempt namespace placement only; every non-external layout/definition gap remains visible. */
+export declare function migrationCoverageGaps(params: {
+    gaps: readonly Record<string, unknown>[];
+    namespace: string;
+    namespaces: readonly string[];
+    external?: ExternalObjectResolution;
+}): readonly Record<string, unknown>[];
+export {};
+//# sourceMappingURL=external-objects.d.ts.map

package/dist/external-objects.d.ts.map

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

package/dist/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAoC5E,iFAAiF;AACjF,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA6B7G"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAoC5E,iFAAiF;AACjF,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAgC7G"}