@atscript/db-postgres 0.1.127 → 0.1.129

package/dist/index.cjs

@@ -241,6 +241,7 @@ function buildCreateTable(table, fields, foreignKeys, options) {
 		colDefs.push(`PRIMARY KEY (${pkCols})`);
 	}
 	if (foreignKeys) for (const fk of foreignKeys.values()) {
+		if (options?.deferForeignKeysTo?.has(fk.targetTable)) continue;
 		const localCols = fk.fields.map((f) => qi(f)).join(", ");
 		const targetCols = fk.targetFields.map((f) => qi(f)).join(", ");
 		let constraint = `FOREIGN KEY (${localCols}) REFERENCES ${qi(fk.targetTable)} (${targetCols})`;
@@ -299,6 +300,40 @@ function parseCount(value) {
 * const users = space.getTable(UsersType)
 * ```
 */
+/** The suffix PostgreSQL gives an auto-named constraint of each `pg_constraint.contype`. */
+const PG_CONSTRAINT_LABELS = {
+	p: "pkey",
+	u: "key",
+	f: "fkey",
+	n: "not_null"
+};
+/** UTF-8 byte length of `s`. */
+function byteLength(s) {
+	return Buffer.byteLength(s, "utf8");
+}
+/** Cuts `s` to at most `bytes` UTF-8 bytes (whole characters only). */
+function truncateBytes(s, bytes) {
+	let out = s;
+	while (byteLength(out) > bytes) out = out.slice(0, -1);
+	return out;
+}
+/**
+* The name PostgreSQL generates for an unnamed constraint (`makeObjectName`):
+* `<table>_<columns joined by _>_<label>`, with the table and column parts
+* shortened — the longer one first — until the whole fits 63 bytes
+* (`NAMEDATALEN - 1`). Used to recognise and to rename the recreated table's
+* constraints. Ignores the `1`, `2`, … suffix PostgreSQL appends on a clash.
+*/
+function pgObjectName(table, columns, label) {
+	const name2 = columns.join("_");
+	const avail = 63 - (label.length + 1 + (name2 ? 1 : 0));
+	let n1 = byteLength(table);
+	let n2 = byteLength(name2);
+	while (n1 + n2 > avail) if (n1 > n2) n1--;
+	else n2--;
+	const head = truncateBytes(table, n1);
+	return name2 ? `${head}_${truncateBytes(name2, n2)}_${label}` : `${head}_${label}`;
+}
 var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 	driver;
 	supportsColumnModify = true;
@@ -321,14 +356,28 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 	_vectorFields = /* @__PURE__ */ new Map();
 	/** Default similarity thresholds per vector field (from @db.search.vector.threshold). */
 	_vectorThresholds = /* @__PURE__ */ new Map();
-	/** Schema name for queries (null falls through to 'public'). */
+	/**
+	* Schema name for catalog queries and qualification — `@db.schema` of the
+	* bound table, or `null` (→ `'public'`, the same default the bound path
+	* uses) when the table declares none or the adapter is an administrative
+	* one with no readable (the name-taking schema-sync primitives run on such
+	* an adapter).
+	*/
 	get _schema() {
-		return this._table.schema ?? null;
+		return this._table?.schema ?? null;
 	}
 	constructor(driver) {
 		super();
 		this.driver = driver;
 	}
+	/** Every adapter over this pool shares one transaction (since 0.1.128). */
+	_transactionOwner() {
+		return this.driver;
+	}
+	/** The dedicated connection of this pool's open transaction, if any. */
+	_txConnection() {
+		return this._getTransactionState();
+	}
 	async _beginTransaction() {
 		const conn = await this.driver.getConnection();
 		try {
@@ -363,7 +412,7 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 	* otherwise the pool-based driver.
 	*/
 	_exec() {
-		return this._getTransactionState() ?? this.driver;
+		return this._txConnection() ?? this.driver;
 	}
 	/** PostgreSQL enforces FK constraints natively. */
 	supportsNativeForeignKeys() {
@@ -597,7 +646,8 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 		};
 	}
 	async replaceOne(filter, data, expectedVersion) {
-		return this.updateOne(filter, data, void 0, expectedVersion);
+		const full = (0, _atscript_db_sql_tools.fillReplacePayload)(data, (0, _atscript_db_sql_tools.replaceColumnsFor)(this._table.fieldDescriptors, this.nativeDefaultFns()), this._table.versionColumn);
+		return this.updateOne(filter, full, void 0, expectedVersion);
 	}
 	async replaceMany(filter, data) {
 		return this.updateMany(filter, data);
@@ -626,7 +676,7 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 	_hasGeoPointFields() {
 		return this._table.fieldDescriptors.some((fd) => fd.isGeoPoint && !fd.encrypted);
 	}
-	async ensureTable() {
+	async ensureTable(opts) {
 		if (this._nocaseColumns.size > 0 && !this._citextProvisioned) try {
 			await this._exec().exec("CREATE EXTENSION IF NOT EXISTS citext");
 			this._citextProvisioned = true;
@@ -636,15 +686,89 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 		}
 		await this.prepareTypeMapper();
 		if (this._schema) await this._exec().exec(`CREATE SCHEMA IF NOT EXISTS ${qi(this._schema)}`);
-		if (this._table instanceof _atscript_db.AtscriptDbView) return this._ensureView();
+		if (this._table.isView) return this._ensureView();
 		const sql = buildCreateTable(this.resolveTableName(), this._table.fieldDescriptors, this._table.foreignKeys, {
 			incrementFields: this._incrementFields,
 			autoIncrementStart: this._autoIncrementStart,
-			typeMapper: (field) => this.typeMapper(field)
+			typeMapper: (field) => this.typeMapper(field),
+			deferForeignKeysTo: opts?.deferForeignKeysTo
 		});
 		this._log(sql);
 		await this._exec().exec(sql);
 	}
+	/** `schema.name` when the adapter targets a named schema. */
+	_qualify(name) {
+		return quoteTableName(this._schema ? `${this._schema}.${name}` : name);
+	}
+	async hasRows(tableName) {
+		const sql = `SELECT EXISTS (SELECT 1 FROM ${tableName ? this._qualify(tableName) : quoteTableName(this.resolveTableName())}) AS "present"`;
+		this._log(sql);
+		return (await this._exec().get(sql, []))?.present ?? false;
+	}
+	/**
+	* Live foreign keys referencing `tableName`, via `pg_constraint` — exact for
+	* composite keys (`conkey`/`confkey` are positionally aligned, unlike the
+	* `key_column_usage` ordinal join).
+	*/
+	async getReferencingForeignKeys(tableName) {
+		return (await this._exec().all(`SELECT cl.relname AS table_name, c.conname AS constraint_name,
+              (SELECT array_agg(a.attname::text ORDER BY k.ord)
+               FROM unnest(c.conkey) WITH ORDINALITY AS k(attnum, ord)
+               JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = k.attnum) AS columns,
+              (SELECT array_agg(a.attname::text ORDER BY k.ord)
+               FROM unnest(c.confkey) WITH ORDINALITY AS k(attnum, ord)
+               JOIN pg_attribute a ON a.attrelid = c.confrelid AND a.attnum = k.attnum) AS ref_columns
+       FROM pg_constraint c
+       JOIN pg_class cl ON cl.oid = c.conrelid
+       JOIN pg_class rcl ON rcl.oid = c.confrelid
+       JOIN pg_namespace rn ON rn.oid = rcl.relnamespace
+       WHERE c.contype = 'f' AND rcl.relname = $1 AND rn.nspname = COALESCE($2, 'public')
+       ORDER BY cl.relname, c.conname`, [tableName, this._schema])).map((r) => ({
+			table: r.table_name,
+			fields: r.columns ?? [],
+			targetFields: r.ref_columns ?? []
+		}));
+	}
+	async getObjectKind(name) {
+		switch ((await this._exec().get(`SELECT c.relkind FROM pg_class c
+       JOIN pg_namespace n ON n.oid = c.relnamespace
+       WHERE c.relname = $1 AND n.nspname = COALESCE($2, 'public')
+         AND c.relkind IN ('r', 'p', 'v', 'm')`, [name, this._schema]))?.relkind) {
+			case "r":
+			case "p": return "table";
+			case "v": return "view";
+			case "m": return "materialized";
+			default: return;
+		}
+	}
+	/** One multi-table `DROP TABLE a, b` — PostgreSQL resolves the mutual FKs inside the set. No CASCADE. */
+	async dropTablesByName(tableNames) {
+		if (tableNames.length === 0) return;
+		const ddl = `DROP TABLE IF EXISTS ${tableNames.map((n) => this._qualify(n)).join(", ")}`;
+		this._log(ddl);
+		await this._exec().exec(ddl);
+	}
+	/**
+	* `ALTER TABLE … DROP CONSTRAINT <pk>, ADD PRIMARY KEY (…)` in ONE statement
+	* (atomic). Called on an empty table only; `ADD PRIMARY KEY` makes the new
+	* key columns NOT NULL. A demoted identity column is handled by the
+	* `defaultChanged` diff (`DROP IDENTITY`).
+	*/
+	async rebuildPrimaryKey(change) {
+		const clauses = [];
+		if (change.from.length > 0) {
+			const row = await this._exec().get(`SELECT c.conname FROM pg_constraint c
+         JOIN pg_class cl ON cl.oid = c.conrelid
+         JOIN pg_namespace n ON n.oid = cl.relnamespace
+         WHERE c.contype = 'p' AND cl.relname = $1 AND n.nspname = COALESCE($2, 'public')`, [this._table.tableName, this._schema]);
+			if (row?.conname) clauses.push(`DROP CONSTRAINT ${qi(row.conname)}`);
+		}
+		if (change.to.length > 0) clauses.push(`ADD PRIMARY KEY (${change.to.map((c) => qi(c)).join(", ")})`);
+		if (clauses.length === 0) return;
+		const ddl = `ALTER TABLE ${quoteTableName(this.resolveTableName())} ${clauses.join(", ")}`;
+		this._log(ddl);
+		await this._exec().exec(ddl);
+	}
 	async _ensureView() {
 		const view = this._table;
 		const sql = buildCreateView(this.resolveTableName(), view.viewPlan, view.getViewColumnMappings(), (ref) => view.resolveFieldRef(ref, qi));
@@ -734,15 +858,27 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 			this._log(ddl);
 			await this._exec().exec(ddl);
 		}
-		for (const { field } of diff.defaultChanged ?? []) {
-			let ddl;
-			if (field.defaultValue?.kind === "value") ddl = `ALTER TABLE ${quoteTableName(tableName)} ALTER COLUMN ${qi(field.physicalName)} SET DEFAULT ${defaultValueToSqlLiteral(field.designType, field.defaultValue.value)}`;
-			else if (field.defaultValue?.kind === "fn") {
-				const fnExpr = field.defaultValue.fn === "now" ? "(extract(epoch from now()) * 1000)::bigint" : field.defaultValue.fn === "uuid" ? "gen_random_uuid()" : `${field.defaultValue.fn}()`;
-				ddl = `ALTER TABLE ${quoteTableName(tableName)} ALTER COLUMN ${qi(field.physicalName)} SET DEFAULT ${fnExpr}`;
-			} else ddl = `ALTER TABLE ${quoteTableName(tableName)} ALTER COLUMN ${qi(field.physicalName)} DROP DEFAULT`;
-			this._log(ddl);
-			await this._exec().exec(ddl);
+		for (const { field, oldDefault } of diff.defaultChanged ?? []) {
+			const col = `ALTER TABLE ${quoteTableName(tableName)} ALTER COLUMN ${qi(field.physicalName)}`;
+			const wasIdentity = oldDefault === "fn:increment";
+			const statements = [];
+			if (field.defaultValue?.kind === "fn" && field.defaultValue.fn === "increment") {
+				if (!wasIdentity) {
+					if (oldDefault !== void 0) statements.push(`${col} DROP DEFAULT`);
+					statements.push(`${col} SET NOT NULL`, `${col} ADD GENERATED BY DEFAULT AS IDENTITY`);
+				}
+			} else {
+				if (wasIdentity) statements.push(`${col} DROP IDENTITY IF EXISTS`);
+				if (field.defaultValue?.kind === "value") statements.push(`${col} SET DEFAULT ${defaultValueToSqlLiteral(field.designType, field.defaultValue.value)}`);
+				else if (field.defaultValue?.kind === "fn") {
+					const fnExpr = field.defaultValue.fn === "now" ? "(extract(epoch from now()) * 1000)::bigint" : "gen_random_uuid()";
+					statements.push(`${col} SET DEFAULT ${fnExpr}`);
+				} else if (!wasIdentity) statements.push(`${col} DROP DEFAULT`);
+			}
+			for (const ddl of statements) {
+				this._log(ddl);
+				await this._exec().exec(ddl);
+			}
 		}
 		return {
 			added,
@@ -767,14 +903,18 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
            ON kcu.constraint_name = tc.constraint_name AND kcu.table_schema = tc.table_schema
          JOIN information_schema.key_column_usage kcur
            ON kcur.constraint_name = rc.unique_constraint_name AND kcur.table_schema = rc.unique_constraint_schema
-              AND kcur.ordinal_position = kcu.ordinal_position
+              AND kcur.ordinal_position = kcu.position_in_unique_constraint
          WHERE rc.unique_constraint_schema = COALESCE($1, 'public')
            AND rc.unique_constraint_name IN (
              SELECT constraint_name FROM information_schema.table_constraints
-             WHERE table_name = $2 AND table_schema = COALESCE($1, 'public') AND constraint_type = 'PRIMARY KEY'
-           )`, [schema, this._table.tableName]);
+             WHERE table_name = $2 AND table_schema = COALESCE($1, 'public')
+               AND constraint_type IN ('PRIMARY KEY', 'UNIQUE')
+           )
+         ORDER BY tc.table_schema, tc.table_name, tc.constraint_name, kcu.ordinal_position`, [schema, this._table.tableName]);
 			const fkByName = /* @__PURE__ */ new Map();
+			const ownSchema = schema ?? "public";
 			for (const fk of fkRefs) {
+				if (fk.table_schema === ownSchema && fk.table_name === this._table.tableName) continue;
 				let entry = fkByName.get(fk.constraint_name);
 				if (!entry) {
 					entry = {
@@ -798,7 +938,8 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 			const createSql = buildCreateTable(tempName, this._table.fieldDescriptors, this._table.foreignKeys, {
 				incrementFields: this._incrementFields,
 				autoIncrementStart: this._autoIncrementStart,
-				typeMapper: (field) => this.typeMapper(field)
+				typeMapper: (field) => this.typeMapper(field),
+				deferForeignKeysTo: new Set([this._table.tableName])
 			});
 			this._log(createSql);
 			await conn.exec(createSql);
@@ -823,13 +964,16 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 				this._log(copySql);
 				await conn.exec(copySql);
 			}
-			await conn.exec(`DROP TABLE IF EXISTS ${quoteTableName(tableName)} CASCADE`);
+			const dropSql = `DROP TABLE IF EXISTS ${quoteTableName(tableName)}`;
+			this._log(dropSql);
+			await conn.exec(dropSql);
 			await conn.exec(`ALTER TABLE ${quoteTableName(tempName)} RENAME TO ${qi(this._table.tableName)}`);
+			await this._renameTempConstraints(conn, baseTempName);
 			const resolvedTable = this.resolveTableName();
-			for (const [, fk] of fkByName) {
+			for (const [name, fk] of fkByName) {
 				const localCols = fk.cols.map((c) => qi(c)).join(", ");
 				const refCols = fk.refCols.map((c) => qi(c)).join(", ");
-				let ddl = `ALTER TABLE ${qi(fk.schema)}.${qi(fk.table)} ADD FOREIGN KEY (${localCols}) REFERENCES ${quoteTableName(resolvedTable)} (${refCols})`;
+				let ddl = `ALTER TABLE ${qi(fk.schema)}.${qi(fk.table)} ADD CONSTRAINT ${qi(name)} FOREIGN KEY (${localCols}) REFERENCES ${quoteTableName(resolvedTable)} (${refCols})`;
 				if (fk.onDelete !== "NO ACTION") ddl += ` ON DELETE ${fk.onDelete}`;
 				if (fk.onUpdate !== "NO ACTION") ddl += ` ON UPDATE ${fk.onUpdate}`;
 				this._log(ddl);
@@ -839,11 +983,59 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 			await this._resetIdentitySequences();
 		} catch (err) {
 			await conn.exec("ROLLBACK").catch(() => {});
+			const detail = err.detail;
+			if (err instanceof Error && typeof detail === "string" && detail.length > 0) err.message = `${err.message} — ${detail}`;
 			throw err;
 		} finally {
 			conn.release();
 		}
 	}
+	/**
+	* Renames the recreated table's auto-named constraints from the temp
+	* table's names to the final table's: `<tmp>_pkey` → `<table>_pkey`,
+	* `<tmp>_<cols>_fkey` → `<table>_<cols>_fkey`, and so on. Runs inside the
+	* recreate transaction, after the RENAME. A constraint is recognised by
+	* its kind and columns — its name equals the one PostgreSQL generates for
+	* the temp table ({@link pgObjectName}, 63-byte truncation included) — so
+	* a long table name matches too. A target name already taken (a primary /
+	* unique constraint's index shares its name with every relation in the
+	* schema; other kinds with the table's constraints) is skipped and logged.
+	*/
+	async _renameTempConstraints(conn, baseTempName) {
+		const table = this._table.tableName;
+		const rows = await conn.all(`SELECT c.conname, c.contype,
+              (SELECT array_agg(a.attname::text ORDER BY k.ord)
+               FROM unnest(c.conkey) WITH ORDINALITY AS k(attnum, ord)
+               JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = k.attnum) AS columns
+       FROM pg_constraint c
+       JOIN pg_class cl ON cl.oid = c.conrelid
+       JOIN pg_namespace n ON n.oid = cl.relnamespace
+       WHERE cl.relname = $1 AND n.nspname = COALESCE($2, 'public')
+       ORDER BY c.conname`, [table, this._schema]);
+		const taken = new Set(rows.map((r) => r.conname));
+		for (const { conname, contype, columns } of rows) {
+			const label = PG_CONSTRAINT_LABELS[contype];
+			if (!label) continue;
+			const cols = contype === "p" ? [] : columns ?? [];
+			if (conname !== pgObjectName(baseTempName, cols, label)) continue;
+			const target = pgObjectName(table, cols, label);
+			if (target === conname) continue;
+			if (contype === "p" || contype === "u" ? await this._relationExists(conn, target) : taken.has(target)) {
+				this._log(`-- constraint "${conname}" keeps its name: "${target}" already exists`);
+				continue;
+			}
+			const ddl = `ALTER TABLE ${quoteTableName(this.resolveTableName())} RENAME CONSTRAINT ${qi(conname)} TO ${qi(target)}`;
+			this._log(ddl);
+			await conn.exec(ddl);
+			taken.add(target);
+		}
+	}
+	/** Whether a relation (table, index, view, …) named `name` exists in this adapter's schema. */
+	async _relationExists(conn, name) {
+		return (await conn.get(`SELECT true AS present FROM pg_class c
+       JOIN pg_namespace n ON n.oid = c.relnamespace
+       WHERE c.relname = $1 AND n.nspname = COALESCE($2, 'public')`, [name, this._schema]))?.present ?? false;
+	}
 	async afterSyncTable() {
 		await this._resetIdentitySequences();
 	}
@@ -867,8 +1059,14 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 	async tableExists() {
 		return (await this._exec().get(`SELECT EXISTS (SELECT 1 FROM information_schema.tables WHERE table_name = $1 AND table_schema = COALESCE($2, 'public')) AS "exists"`, [this._table.tableName, this._schema]))?.exists ?? false;
 	}
+	/**
+	* No CASCADE: when something outside the sync inventory (a user view, an
+	* unmanaged FK) still depends on the table PostgreSQL refuses, and schema
+	* sync reports that as an error entry instead of silently dropping the
+	* dependents.
+	*/
 	async dropTable() {
-		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(this.resolveTableName())} CASCADE`;
+		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(this.resolveTableName())}`;
 		this._log(ddl);
 		await this._exec().exec(ddl);
 	}
@@ -901,7 +1099,7 @@ var PostgresAdapter = class PostgresAdapter extends _atscript_db.BaseDbAdapter {
 		}
 	}
 	async dropTableByName(tableName) {
-		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(tableName)} CASCADE`;
+		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(tableName)}`;
 		this._log(ddl);
 		await this._exec().exec(ddl);
 	}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertManyResult, TDbInsertResult, TDbUpdateResult, TExistingColumn, TFieldOps, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair } from "@atscript/db";
+import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TPrimaryKeyChange, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair } from "@atscript/db";
 import { TMetadataMap } from "@atscript/typescript/utils";
 import { TSqlFragment } from "@atscript/db-sql-tools";
 
@@ -69,22 +69,6 @@ interface TPgConnection {
 }
 //#endregion
 //#region src/postgres-adapter.d.ts
-/**
- * PostgreSQL adapter for {@link AtscriptDbTable}.
- *
- * Accepts any {@link TPgDriver} implementation — the actual PostgreSQL driver
- * is fully swappable (pg Pool, custom implementations, etc.).
- *
- * Usage:
- * ```typescript
- * import { PgDriver, PostgresAdapter } from '@atscript/db-postgres'
- * import { DbSpace } from '@atscript/db'
- *
- * const driver = new PgDriver('postgresql://user@localhost:5432/mydb')
- * const space = new DbSpace(() => new PostgresAdapter(driver))
- * const users = space.getTable(UsersType)
- * ```
- */
 declare class PostgresAdapter extends BaseDbAdapter {
   protected readonly driver: TPgDriver;
   supportsColumnModify: boolean;
@@ -103,9 +87,19 @@ declare class PostgresAdapter extends BaseDbAdapter {
   private _vectorFields;
   /** Default similarity thresholds per vector field (from @db.search.vector.threshold). */
   private _vectorThresholds;
-  /** Schema name for queries (null falls through to 'public'). */
+  /**
+   * Schema name for catalog queries and qualification — `@db.schema` of the
+   * bound table, or `null` (→ `'public'`, the same default the bound path
+   * uses) when the table declares none or the adapter is an administrative
+   * one with no readable (the name-taking schema-sync primitives run on such
+   * an adapter).
+   */
   private get _schema();
   constructor(driver: TPgDriver);
+  /** Every adapter over this pool shares one transaction (since 0.1.128). */
+  protected _transactionOwner(): unknown;
+  /** The dedicated connection of this pool's open transaction, if any. */
+  private _txConnection;
   protected _beginTransaction(): Promise<TPgConnection>;
   protected _commitTransaction(state: unknown): Promise<void>;
   protected _rollbackTransaction(state: unknown): Promise<void>;
@@ -156,12 +150,45 @@ declare class PostgresAdapter extends BaseDbAdapter {
   prepareTypeMapper(): Promise<void>;
   /** Whether the table declares any `db.geoPoint` fields (unencrypted). */
   private _hasGeoPointFields;
-  ensureTable(): Promise<void>;
+  ensureTable(opts?: TEnsureTableOptions): Promise<void>;
+  /** `schema.name` when the adapter targets a named schema. */
+  private _qualify;
+  hasRows(tableName?: string): Promise<boolean>;
+  /**
+   * Live foreign keys referencing `tableName`, via `pg_constraint` — exact for
+   * composite keys (`conkey`/`confkey` are positionally aligned, unlike the
+   * `key_column_usage` ordinal join).
+   */
+  getReferencingForeignKeys(tableName: string): Promise<TReferencingForeignKey[]>;
+  getObjectKind(name: string): Promise<TDbObjectKind | undefined>;
+  /** One multi-table `DROP TABLE a, b` — PostgreSQL resolves the mutual FKs inside the set. No CASCADE. */
+  dropTablesByName(tableNames: string[]): Promise<void>;
+  /**
+   * `ALTER TABLE … DROP CONSTRAINT <pk>, ADD PRIMARY KEY (…)` in ONE statement
+   * (atomic). Called on an empty table only; `ADD PRIMARY KEY` makes the new
+   * key columns NOT NULL. A demoted identity column is handled by the
+   * `defaultChanged` diff (`DROP IDENTITY`).
+   */
+  rebuildPrimaryKey(change: TPrimaryKeyChange): Promise<void>;
   private _ensureView;
   getExistingColumns(): Promise<TExistingColumn[]>;
   getExistingColumnsForTable(tableName: string): Promise<TExistingColumn[]>;
   syncColumns(diff: TColumnDiff): Promise<TSyncColumnResult>;
   recreateTable(): Promise<void>;
+  /**
+   * Renames the recreated table's auto-named constraints from the temp
+   * table's names to the final table's: `<tmp>_pkey` → `<table>_pkey`,
+   * `<tmp>_<cols>_fkey` → `<table>_<cols>_fkey`, and so on. Runs inside the
+   * recreate transaction, after the RENAME. A constraint is recognised by
+   * its kind and columns — its name equals the one PostgreSQL generates for
+   * the temp table ({@link pgObjectName}, 63-byte truncation included) — so
+   * a long table name matches too. A target name already taken (a primary /
+   * unique constraint's index shares its name with every relation in the
+   * schema; other kinds with the table's constraints) is skipped and logged.
+   */
+  private _renameTempConstraints;
+  /** Whether a relation (table, index, view, …) named `name` exists in this adapter's schema. */
+  private _relationExists;
   afterSyncTable(): Promise<void>;
   /**
    * Resets IDENTITY sequences to MAX(column) so that the next auto-generated
@@ -171,6 +198,12 @@ declare class PostgresAdapter extends BaseDbAdapter {
    */
   private _resetIdentitySequences;
   tableExists(): Promise<boolean>;
+  /**
+   * No CASCADE: when something outside the sync inventory (a user view, an
+   * unmanaged FK) still depends on the table PostgreSQL refuses, and schema
+   * sync reports that as an error entry instead of silently dropping the
+   * dependents.
+   */
   dropTable(): Promise<void>;
   dropColumns(columns: string[]): Promise<void>;
   dropIndexesForColumns(columns: string[]): Promise<void>;

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertManyResult, TDbInsertResult, TDbUpdateResult, TExistingColumn, TFieldOps, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair } from "@atscript/db";
+import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TPrimaryKeyChange, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair } from "@atscript/db";
 import { TSqlFragment } from "@atscript/db-sql-tools";
 import { TMetadataMap } from "@atscript/typescript/utils";
 
@@ -69,22 +69,6 @@ interface TPgConnection {
 }
 //#endregion
 //#region src/postgres-adapter.d.ts
-/**
- * PostgreSQL adapter for {@link AtscriptDbTable}.
- *
- * Accepts any {@link TPgDriver} implementation — the actual PostgreSQL driver
- * is fully swappable (pg Pool, custom implementations, etc.).
- *
- * Usage:
- * ```typescript
- * import { PgDriver, PostgresAdapter } from '@atscript/db-postgres'
- * import { DbSpace } from '@atscript/db'
- *
- * const driver = new PgDriver('postgresql://user@localhost:5432/mydb')
- * const space = new DbSpace(() => new PostgresAdapter(driver))
- * const users = space.getTable(UsersType)
- * ```
- */
 declare class PostgresAdapter extends BaseDbAdapter {
   protected readonly driver: TPgDriver;
   supportsColumnModify: boolean;
@@ -103,9 +87,19 @@ declare class PostgresAdapter extends BaseDbAdapter {
   private _vectorFields;
   /** Default similarity thresholds per vector field (from @db.search.vector.threshold). */
   private _vectorThresholds;
-  /** Schema name for queries (null falls through to 'public'). */
+  /**
+   * Schema name for catalog queries and qualification — `@db.schema` of the
+   * bound table, or `null` (→ `'public'`, the same default the bound path
+   * uses) when the table declares none or the adapter is an administrative
+   * one with no readable (the name-taking schema-sync primitives run on such
+   * an adapter).
+   */
   private get _schema();
   constructor(driver: TPgDriver);
+  /** Every adapter over this pool shares one transaction (since 0.1.128). */
+  protected _transactionOwner(): unknown;
+  /** The dedicated connection of this pool's open transaction, if any. */
+  private _txConnection;
   protected _beginTransaction(): Promise<TPgConnection>;
   protected _commitTransaction(state: unknown): Promise<void>;
   protected _rollbackTransaction(state: unknown): Promise<void>;
@@ -156,12 +150,45 @@ declare class PostgresAdapter extends BaseDbAdapter {
   prepareTypeMapper(): Promise<void>;
   /** Whether the table declares any `db.geoPoint` fields (unencrypted). */
   private _hasGeoPointFields;
-  ensureTable(): Promise<void>;
+  ensureTable(opts?: TEnsureTableOptions): Promise<void>;
+  /** `schema.name` when the adapter targets a named schema. */
+  private _qualify;
+  hasRows(tableName?: string): Promise<boolean>;
+  /**
+   * Live foreign keys referencing `tableName`, via `pg_constraint` — exact for
+   * composite keys (`conkey`/`confkey` are positionally aligned, unlike the
+   * `key_column_usage` ordinal join).
+   */
+  getReferencingForeignKeys(tableName: string): Promise<TReferencingForeignKey[]>;
+  getObjectKind(name: string): Promise<TDbObjectKind | undefined>;
+  /** One multi-table `DROP TABLE a, b` — PostgreSQL resolves the mutual FKs inside the set. No CASCADE. */
+  dropTablesByName(tableNames: string[]): Promise<void>;
+  /**
+   * `ALTER TABLE … DROP CONSTRAINT <pk>, ADD PRIMARY KEY (…)` in ONE statement
+   * (atomic). Called on an empty table only; `ADD PRIMARY KEY` makes the new
+   * key columns NOT NULL. A demoted identity column is handled by the
+   * `defaultChanged` diff (`DROP IDENTITY`).
+   */
+  rebuildPrimaryKey(change: TPrimaryKeyChange): Promise<void>;
   private _ensureView;
   getExistingColumns(): Promise<TExistingColumn[]>;
   getExistingColumnsForTable(tableName: string): Promise<TExistingColumn[]>;
   syncColumns(diff: TColumnDiff): Promise<TSyncColumnResult>;
   recreateTable(): Promise<void>;
+  /**
+   * Renames the recreated table's auto-named constraints from the temp
+   * table's names to the final table's: `<tmp>_pkey` → `<table>_pkey`,
+   * `<tmp>_<cols>_fkey` → `<table>_<cols>_fkey`, and so on. Runs inside the
+   * recreate transaction, after the RENAME. A constraint is recognised by
+   * its kind and columns — its name equals the one PostgreSQL generates for
+   * the temp table ({@link pgObjectName}, 63-byte truncation included) — so
+   * a long table name matches too. A target name already taken (a primary /
+   * unique constraint's index shares its name with every relation in the
+   * schema; other kinds with the table's constraints) is skipped and logged.
+   */
+  private _renameTempConstraints;
+  /** Whether a relation (table, index, view, …) named `name` exists in this adapter's schema. */
+  private _relationExists;
   afterSyncTable(): Promise<void>;
   /**
    * Resets IDENTITY sequences to MAX(column) so that the next auto-generated
@@ -171,6 +198,12 @@ declare class PostgresAdapter extends BaseDbAdapter {
    */
   private _resetIdentitySequences;
   tableExists(): Promise<boolean>;
+  /**
+   * No CASCADE: when something outside the sync inventory (a user view, an
+   * unmanaged FK) still depends on the table PostgreSQL refuses, and schema
+   * sync reports that as an error entry instead of silently dropping the
+   * dependents.
+   */
   dropTable(): Promise<void>;
   dropColumns(columns: string[]): Promise<void>;
   dropIndexesForColumns(columns: string[]): Promise<void>;

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { AtscriptDbView, BaseDbAdapter, DbError, DbSpace } from "@atscript/db";
-import { buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildSelect, buildUpdate, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, finalizeParams, geoWindowFromControls, normalizeGeoPointValue, parseRegexString, refActionToSql, renameGeoDistance } from "@atscript/db-sql-tools";
+import { BaseDbAdapter, DbError, DbSpace } from "@atscript/db";
+import { buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildSelect, buildUpdate, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, fillReplacePayload, finalizeParams, geoWindowFromControls, normalizeGeoPointValue, parseRegexString, refActionToSql, renameGeoDistance, replaceColumnsFor } from "@atscript/db-sql-tools";
 //#region src/sql-builder.ts
 /**
 * PostgreSQL-aware default value for a given design type.
@@ -240,6 +240,7 @@ function buildCreateTable(table, fields, foreignKeys, options) {
 		colDefs.push(`PRIMARY KEY (${pkCols})`);
 	}
 	if (foreignKeys) for (const fk of foreignKeys.values()) {
+		if (options?.deferForeignKeysTo?.has(fk.targetTable)) continue;
 		const localCols = fk.fields.map((f) => qi(f)).join(", ");
 		const targetCols = fk.targetFields.map((f) => qi(f)).join(", ");
 		let constraint = `FOREIGN KEY (${localCols}) REFERENCES ${qi(fk.targetTable)} (${targetCols})`;
@@ -298,6 +299,40 @@ function parseCount(value) {
 * const users = space.getTable(UsersType)
 * ```
 */
+/** The suffix PostgreSQL gives an auto-named constraint of each `pg_constraint.contype`. */
+const PG_CONSTRAINT_LABELS = {
+	p: "pkey",
+	u: "key",
+	f: "fkey",
+	n: "not_null"
+};
+/** UTF-8 byte length of `s`. */
+function byteLength(s) {
+	return Buffer.byteLength(s, "utf8");
+}
+/** Cuts `s` to at most `bytes` UTF-8 bytes (whole characters only). */
+function truncateBytes(s, bytes) {
+	let out = s;
+	while (byteLength(out) > bytes) out = out.slice(0, -1);
+	return out;
+}
+/**
+* The name PostgreSQL generates for an unnamed constraint (`makeObjectName`):
+* `<table>_<columns joined by _>_<label>`, with the table and column parts
+* shortened — the longer one first — until the whole fits 63 bytes
+* (`NAMEDATALEN - 1`). Used to recognise and to rename the recreated table's
+* constraints. Ignores the `1`, `2`, … suffix PostgreSQL appends on a clash.
+*/
+function pgObjectName(table, columns, label) {
+	const name2 = columns.join("_");
+	const avail = 63 - (label.length + 1 + (name2 ? 1 : 0));
+	let n1 = byteLength(table);
+	let n2 = byteLength(name2);
+	while (n1 + n2 > avail) if (n1 > n2) n1--;
+	else n2--;
+	const head = truncateBytes(table, n1);
+	return name2 ? `${head}_${truncateBytes(name2, n2)}_${label}` : `${head}_${label}`;
+}
 var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 	driver;
 	supportsColumnModify = true;
@@ -320,14 +355,28 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 	_vectorFields = /* @__PURE__ */ new Map();
 	/** Default similarity thresholds per vector field (from @db.search.vector.threshold). */
 	_vectorThresholds = /* @__PURE__ */ new Map();
-	/** Schema name for queries (null falls through to 'public'). */
+	/**
+	* Schema name for catalog queries and qualification — `@db.schema` of the
+	* bound table, or `null` (→ `'public'`, the same default the bound path
+	* uses) when the table declares none or the adapter is an administrative
+	* one with no readable (the name-taking schema-sync primitives run on such
+	* an adapter).
+	*/
 	get _schema() {
-		return this._table.schema ?? null;
+		return this._table?.schema ?? null;
 	}
 	constructor(driver) {
 		super();
 		this.driver = driver;
 	}
+	/** Every adapter over this pool shares one transaction (since 0.1.128). */
+	_transactionOwner() {
+		return this.driver;
+	}
+	/** The dedicated connection of this pool's open transaction, if any. */
+	_txConnection() {
+		return this._getTransactionState();
+	}
 	async _beginTransaction() {
 		const conn = await this.driver.getConnection();
 		try {
@@ -362,7 +411,7 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 	* otherwise the pool-based driver.
 	*/
 	_exec() {
-		return this._getTransactionState() ?? this.driver;
+		return this._txConnection() ?? this.driver;
 	}
 	/** PostgreSQL enforces FK constraints natively. */
 	supportsNativeForeignKeys() {
@@ -596,7 +645,8 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 		};
 	}
 	async replaceOne(filter, data, expectedVersion) {
-		return this.updateOne(filter, data, void 0, expectedVersion);
+		const full = fillReplacePayload(data, replaceColumnsFor(this._table.fieldDescriptors, this.nativeDefaultFns()), this._table.versionColumn);
+		return this.updateOne(filter, full, void 0, expectedVersion);
 	}
 	async replaceMany(filter, data) {
 		return this.updateMany(filter, data);
@@ -625,7 +675,7 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 	_hasGeoPointFields() {
 		return this._table.fieldDescriptors.some((fd) => fd.isGeoPoint && !fd.encrypted);
 	}
-	async ensureTable() {
+	async ensureTable(opts) {
 		if (this._nocaseColumns.size > 0 && !this._citextProvisioned) try {
 			await this._exec().exec("CREATE EXTENSION IF NOT EXISTS citext");
 			this._citextProvisioned = true;
@@ -635,15 +685,89 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 		}
 		await this.prepareTypeMapper();
 		if (this._schema) await this._exec().exec(`CREATE SCHEMA IF NOT EXISTS ${qi(this._schema)}`);
-		if (this._table instanceof AtscriptDbView) return this._ensureView();
+		if (this._table.isView) return this._ensureView();
 		const sql = buildCreateTable(this.resolveTableName(), this._table.fieldDescriptors, this._table.foreignKeys, {
 			incrementFields: this._incrementFields,
 			autoIncrementStart: this._autoIncrementStart,
-			typeMapper: (field) => this.typeMapper(field)
+			typeMapper: (field) => this.typeMapper(field),
+			deferForeignKeysTo: opts?.deferForeignKeysTo
 		});
 		this._log(sql);
 		await this._exec().exec(sql);
 	}
+	/** `schema.name` when the adapter targets a named schema. */
+	_qualify(name) {
+		return quoteTableName(this._schema ? `${this._schema}.${name}` : name);
+	}
+	async hasRows(tableName) {
+		const sql = `SELECT EXISTS (SELECT 1 FROM ${tableName ? this._qualify(tableName) : quoteTableName(this.resolveTableName())}) AS "present"`;
+		this._log(sql);
+		return (await this._exec().get(sql, []))?.present ?? false;
+	}
+	/**
+	* Live foreign keys referencing `tableName`, via `pg_constraint` — exact for
+	* composite keys (`conkey`/`confkey` are positionally aligned, unlike the
+	* `key_column_usage` ordinal join).
+	*/
+	async getReferencingForeignKeys(tableName) {
+		return (await this._exec().all(`SELECT cl.relname AS table_name, c.conname AS constraint_name,
+              (SELECT array_agg(a.attname::text ORDER BY k.ord)
+               FROM unnest(c.conkey) WITH ORDINALITY AS k(attnum, ord)
+               JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = k.attnum) AS columns,
+              (SELECT array_agg(a.attname::text ORDER BY k.ord)
+               FROM unnest(c.confkey) WITH ORDINALITY AS k(attnum, ord)
+               JOIN pg_attribute a ON a.attrelid = c.confrelid AND a.attnum = k.attnum) AS ref_columns
+       FROM pg_constraint c
+       JOIN pg_class cl ON cl.oid = c.conrelid
+       JOIN pg_class rcl ON rcl.oid = c.confrelid
+       JOIN pg_namespace rn ON rn.oid = rcl.relnamespace
+       WHERE c.contype = 'f' AND rcl.relname = $1 AND rn.nspname = COALESCE($2, 'public')
+       ORDER BY cl.relname, c.conname`, [tableName, this._schema])).map((r) => ({
+			table: r.table_name,
+			fields: r.columns ?? [],
+			targetFields: r.ref_columns ?? []
+		}));
+	}
+	async getObjectKind(name) {
+		switch ((await this._exec().get(`SELECT c.relkind FROM pg_class c
+       JOIN pg_namespace n ON n.oid = c.relnamespace
+       WHERE c.relname = $1 AND n.nspname = COALESCE($2, 'public')
+         AND c.relkind IN ('r', 'p', 'v', 'm')`, [name, this._schema]))?.relkind) {
+			case "r":
+			case "p": return "table";
+			case "v": return "view";
+			case "m": return "materialized";
+			default: return;
+		}
+	}
+	/** One multi-table `DROP TABLE a, b` — PostgreSQL resolves the mutual FKs inside the set. No CASCADE. */
+	async dropTablesByName(tableNames) {
+		if (tableNames.length === 0) return;
+		const ddl = `DROP TABLE IF EXISTS ${tableNames.map((n) => this._qualify(n)).join(", ")}`;
+		this._log(ddl);
+		await this._exec().exec(ddl);
+	}
+	/**
+	* `ALTER TABLE … DROP CONSTRAINT <pk>, ADD PRIMARY KEY (…)` in ONE statement
+	* (atomic). Called on an empty table only; `ADD PRIMARY KEY` makes the new
+	* key columns NOT NULL. A demoted identity column is handled by the
+	* `defaultChanged` diff (`DROP IDENTITY`).
+	*/
+	async rebuildPrimaryKey(change) {
+		const clauses = [];
+		if (change.from.length > 0) {
+			const row = await this._exec().get(`SELECT c.conname FROM pg_constraint c
+         JOIN pg_class cl ON cl.oid = c.conrelid
+         JOIN pg_namespace n ON n.oid = cl.relnamespace
+         WHERE c.contype = 'p' AND cl.relname = $1 AND n.nspname = COALESCE($2, 'public')`, [this._table.tableName, this._schema]);
+			if (row?.conname) clauses.push(`DROP CONSTRAINT ${qi(row.conname)}`);
+		}
+		if (change.to.length > 0) clauses.push(`ADD PRIMARY KEY (${change.to.map((c) => qi(c)).join(", ")})`);
+		if (clauses.length === 0) return;
+		const ddl = `ALTER TABLE ${quoteTableName(this.resolveTableName())} ${clauses.join(", ")}`;
+		this._log(ddl);
+		await this._exec().exec(ddl);
+	}
 	async _ensureView() {
 		const view = this._table;
 		const sql = buildCreateView$1(this.resolveTableName(), view.viewPlan, view.getViewColumnMappings(), (ref) => view.resolveFieldRef(ref, qi));
@@ -733,15 +857,27 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 			this._log(ddl);
 			await this._exec().exec(ddl);
 		}
-		for (const { field } of diff.defaultChanged ?? []) {
-			let ddl;
-			if (field.defaultValue?.kind === "value") ddl = `ALTER TABLE ${quoteTableName(tableName)} ALTER COLUMN ${qi(field.physicalName)} SET DEFAULT ${defaultValueToSqlLiteral$1(field.designType, field.defaultValue.value)}`;
-			else if (field.defaultValue?.kind === "fn") {
-				const fnExpr = field.defaultValue.fn === "now" ? "(extract(epoch from now()) * 1000)::bigint" : field.defaultValue.fn === "uuid" ? "gen_random_uuid()" : `${field.defaultValue.fn}()`;
-				ddl = `ALTER TABLE ${quoteTableName(tableName)} ALTER COLUMN ${qi(field.physicalName)} SET DEFAULT ${fnExpr}`;
-			} else ddl = `ALTER TABLE ${quoteTableName(tableName)} ALTER COLUMN ${qi(field.physicalName)} DROP DEFAULT`;
-			this._log(ddl);
-			await this._exec().exec(ddl);
+		for (const { field, oldDefault } of diff.defaultChanged ?? []) {
+			const col = `ALTER TABLE ${quoteTableName(tableName)} ALTER COLUMN ${qi(field.physicalName)}`;
+			const wasIdentity = oldDefault === "fn:increment";
+			const statements = [];
+			if (field.defaultValue?.kind === "fn" && field.defaultValue.fn === "increment") {
+				if (!wasIdentity) {
+					if (oldDefault !== void 0) statements.push(`${col} DROP DEFAULT`);
+					statements.push(`${col} SET NOT NULL`, `${col} ADD GENERATED BY DEFAULT AS IDENTITY`);
+				}
+			} else {
+				if (wasIdentity) statements.push(`${col} DROP IDENTITY IF EXISTS`);
+				if (field.defaultValue?.kind === "value") statements.push(`${col} SET DEFAULT ${defaultValueToSqlLiteral$1(field.designType, field.defaultValue.value)}`);
+				else if (field.defaultValue?.kind === "fn") {
+					const fnExpr = field.defaultValue.fn === "now" ? "(extract(epoch from now()) * 1000)::bigint" : "gen_random_uuid()";
+					statements.push(`${col} SET DEFAULT ${fnExpr}`);
+				} else if (!wasIdentity) statements.push(`${col} DROP DEFAULT`);
+			}
+			for (const ddl of statements) {
+				this._log(ddl);
+				await this._exec().exec(ddl);
+			}
 		}
 		return {
 			added,
@@ -766,14 +902,18 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
            ON kcu.constraint_name = tc.constraint_name AND kcu.table_schema = tc.table_schema
          JOIN information_schema.key_column_usage kcur
            ON kcur.constraint_name = rc.unique_constraint_name AND kcur.table_schema = rc.unique_constraint_schema
-              AND kcur.ordinal_position = kcu.ordinal_position
+              AND kcur.ordinal_position = kcu.position_in_unique_constraint
          WHERE rc.unique_constraint_schema = COALESCE($1, 'public')
            AND rc.unique_constraint_name IN (
              SELECT constraint_name FROM information_schema.table_constraints
-             WHERE table_name = $2 AND table_schema = COALESCE($1, 'public') AND constraint_type = 'PRIMARY KEY'
-           )`, [schema, this._table.tableName]);
+             WHERE table_name = $2 AND table_schema = COALESCE($1, 'public')
+               AND constraint_type IN ('PRIMARY KEY', 'UNIQUE')
+           )
+         ORDER BY tc.table_schema, tc.table_name, tc.constraint_name, kcu.ordinal_position`, [schema, this._table.tableName]);
 			const fkByName = /* @__PURE__ */ new Map();
+			const ownSchema = schema ?? "public";
 			for (const fk of fkRefs) {
+				if (fk.table_schema === ownSchema && fk.table_name === this._table.tableName) continue;
 				let entry = fkByName.get(fk.constraint_name);
 				if (!entry) {
 					entry = {
@@ -797,7 +937,8 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 			const createSql = buildCreateTable(tempName, this._table.fieldDescriptors, this._table.foreignKeys, {
 				incrementFields: this._incrementFields,
 				autoIncrementStart: this._autoIncrementStart,
-				typeMapper: (field) => this.typeMapper(field)
+				typeMapper: (field) => this.typeMapper(field),
+				deferForeignKeysTo: new Set([this._table.tableName])
 			});
 			this._log(createSql);
 			await conn.exec(createSql);
@@ -822,13 +963,16 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 				this._log(copySql);
 				await conn.exec(copySql);
 			}
-			await conn.exec(`DROP TABLE IF EXISTS ${quoteTableName(tableName)} CASCADE`);
+			const dropSql = `DROP TABLE IF EXISTS ${quoteTableName(tableName)}`;
+			this._log(dropSql);
+			await conn.exec(dropSql);
 			await conn.exec(`ALTER TABLE ${quoteTableName(tempName)} RENAME TO ${qi(this._table.tableName)}`);
+			await this._renameTempConstraints(conn, baseTempName);
 			const resolvedTable = this.resolveTableName();
-			for (const [, fk] of fkByName) {
+			for (const [name, fk] of fkByName) {
 				const localCols = fk.cols.map((c) => qi(c)).join(", ");
 				const refCols = fk.refCols.map((c) => qi(c)).join(", ");
-				let ddl = `ALTER TABLE ${qi(fk.schema)}.${qi(fk.table)} ADD FOREIGN KEY (${localCols}) REFERENCES ${quoteTableName(resolvedTable)} (${refCols})`;
+				let ddl = `ALTER TABLE ${qi(fk.schema)}.${qi(fk.table)} ADD CONSTRAINT ${qi(name)} FOREIGN KEY (${localCols}) REFERENCES ${quoteTableName(resolvedTable)} (${refCols})`;
 				if (fk.onDelete !== "NO ACTION") ddl += ` ON DELETE ${fk.onDelete}`;
 				if (fk.onUpdate !== "NO ACTION") ddl += ` ON UPDATE ${fk.onUpdate}`;
 				this._log(ddl);
@@ -838,11 +982,59 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 			await this._resetIdentitySequences();
 		} catch (err) {
 			await conn.exec("ROLLBACK").catch(() => {});
+			const detail = err.detail;
+			if (err instanceof Error && typeof detail === "string" && detail.length > 0) err.message = `${err.message} — ${detail}`;
 			throw err;
 		} finally {
 			conn.release();
 		}
 	}
+	/**
+	* Renames the recreated table's auto-named constraints from the temp
+	* table's names to the final table's: `<tmp>_pkey` → `<table>_pkey`,
+	* `<tmp>_<cols>_fkey` → `<table>_<cols>_fkey`, and so on. Runs inside the
+	* recreate transaction, after the RENAME. A constraint is recognised by
+	* its kind and columns — its name equals the one PostgreSQL generates for
+	* the temp table ({@link pgObjectName}, 63-byte truncation included) — so
+	* a long table name matches too. A target name already taken (a primary /
+	* unique constraint's index shares its name with every relation in the
+	* schema; other kinds with the table's constraints) is skipped and logged.
+	*/
+	async _renameTempConstraints(conn, baseTempName) {
+		const table = this._table.tableName;
+		const rows = await conn.all(`SELECT c.conname, c.contype,
+              (SELECT array_agg(a.attname::text ORDER BY k.ord)
+               FROM unnest(c.conkey) WITH ORDINALITY AS k(attnum, ord)
+               JOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = k.attnum) AS columns
+       FROM pg_constraint c
+       JOIN pg_class cl ON cl.oid = c.conrelid
+       JOIN pg_namespace n ON n.oid = cl.relnamespace
+       WHERE cl.relname = $1 AND n.nspname = COALESCE($2, 'public')
+       ORDER BY c.conname`, [table, this._schema]);
+		const taken = new Set(rows.map((r) => r.conname));
+		for (const { conname, contype, columns } of rows) {
+			const label = PG_CONSTRAINT_LABELS[contype];
+			if (!label) continue;
+			const cols = contype === "p" ? [] : columns ?? [];
+			if (conname !== pgObjectName(baseTempName, cols, label)) continue;
+			const target = pgObjectName(table, cols, label);
+			if (target === conname) continue;
+			if (contype === "p" || contype === "u" ? await this._relationExists(conn, target) : taken.has(target)) {
+				this._log(`-- constraint "${conname}" keeps its name: "${target}" already exists`);
+				continue;
+			}
+			const ddl = `ALTER TABLE ${quoteTableName(this.resolveTableName())} RENAME CONSTRAINT ${qi(conname)} TO ${qi(target)}`;
+			this._log(ddl);
+			await conn.exec(ddl);
+			taken.add(target);
+		}
+	}
+	/** Whether a relation (table, index, view, …) named `name` exists in this adapter's schema. */
+	async _relationExists(conn, name) {
+		return (await conn.get(`SELECT true AS present FROM pg_class c
+       JOIN pg_namespace n ON n.oid = c.relnamespace
+       WHERE c.relname = $1 AND n.nspname = COALESCE($2, 'public')`, [name, this._schema]))?.present ?? false;
+	}
 	async afterSyncTable() {
 		await this._resetIdentitySequences();
 	}
@@ -866,8 +1058,14 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 	async tableExists() {
 		return (await this._exec().get(`SELECT EXISTS (SELECT 1 FROM information_schema.tables WHERE table_name = $1 AND table_schema = COALESCE($2, 'public')) AS "exists"`, [this._table.tableName, this._schema]))?.exists ?? false;
 	}
+	/**
+	* No CASCADE: when something outside the sync inventory (a user view, an
+	* unmanaged FK) still depends on the table PostgreSQL refuses, and schema
+	* sync reports that as an error entry instead of silently dropping the
+	* dependents.
+	*/
 	async dropTable() {
-		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(this.resolveTableName())} CASCADE`;
+		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(this.resolveTableName())}`;
 		this._log(ddl);
 		await this._exec().exec(ddl);
 	}
@@ -900,7 +1098,7 @@ var PostgresAdapter = class PostgresAdapter extends BaseDbAdapter {
 		}
 	}
 	async dropTableByName(tableName) {
-		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(tableName)} CASCADE`;
+		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(tableName)}`;
 		this._log(ddl);
 		await this._exec().exec(ddl);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-postgres",
-  "version": "0.1.127",
+  "version": "0.1.129",
   "description": "PostgreSQL adapter for @atscript/db with pg (node-postgres) driver support.",
   "keywords": [
     "atscript",
@@ -43,20 +43,20 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.89",
-    "@atscript/typescript": "^0.1.89",
+    "@atscript/core": "^0.1.92",
+    "@atscript/typescript": "^0.1.92",
     "@types/pg": "^8.11.0",
-    "@uniqu/core": "^0.1.7",
+    "@uniqu/core": "^0.1.8",
     "pg": "^8.13.0",
-    "unplugin-atscript": "^0.1.89"
+    "unplugin-atscript": "^0.1.92"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.89",
-    "@atscript/typescript": "^0.1.89",
-    "@uniqu/core": "^0.1.7",
+    "@atscript/core": "^0.1.92",
+    "@atscript/typescript": "^0.1.92",
+    "@uniqu/core": "^0.1.8",
     "pg": ">=8.0.0",
-    "@atscript/db": "^0.1.127",
-    "@atscript/db-sql-tools": "^0.1.127"
+    "@atscript/db": "^0.1.129",
+    "@atscript/db-sql-tools": "^0.1.129"
   },
   "peerDependenciesMeta": {
     "pg": {