@atscript/db-postgres 0.1.127 → 0.1.128

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})`;
@@ -321,14 +322,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 +378,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 +612,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 +642,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 +652,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 +824,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,
@@ -867,8 +969,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 +1009,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";
 
@@ -103,9 +103,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,7 +166,26 @@ 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[]>;
@@ -171,6 +200,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";
 
@@ -103,9 +103,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,7 +166,26 @@ 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[]>;
@@ -171,6 +200,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})`;
@@ -320,14 +321,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 +377,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 +611,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 +641,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 +651,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 +823,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,
@@ -866,8 +968,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 +1008,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.128",
   "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-sql-tools": "^0.1.128",
+    "@atscript/db": "^0.1.128"
   },
   "peerDependenciesMeta": {
     "pg": {