@dbsp/adapter-pgsql 3.3.0 → 3.5.0

package/README.md

@@ -36,6 +36,8 @@ Compile SQL without a database connection — useful for CLI tooling, CI plan in
 import { createOrm, eq } from '@dbsp/core';
 import { createPgsqlCompileOnlyAdapter } from '@dbsp/adapter-pgsql';
 
+// This is a connectionless PgsqlAdapter: dump() works; database operations
+// refuse at runtime until you instead construct createPgsqlAdapter(pool).
 const adapter = createPgsqlCompileOnlyAdapter();
 const orm = createOrm({ schema: db, adapter });
 const { sql, params } = orm.select('users').where(eq('active', true)).dump();
@@ -51,7 +53,7 @@ const { sql, params } = orm.select('users').where(eq('active', true)).dump();
 - **Parameterized queries** — All user values use `$N` positional parameters; no SQL injection surface
 - **Identifier quoting** — All table/column/schema names are double-quoted automatically
 - **AST-based compiler** — SQL is built from the plan AST, never from string templates
-- **DDL provisioning** — `compareSchemata()` + `generateDDL()` with 12-phase topological sort
+- **DDL provisioning** — pure model-to-model `compareSchemata()` + `generateDDL()` with 12-phase topological sort; use live `comparePgsqlDatabaseSchema()` when provisioning from an introspected PostgreSQL database
 - **Schema migrations** — `generateMigrationSQL()` with UP/DOWN sections and destructive-change safety gate
 - **Schema introspection** — Reflect live database structure back into `ModelIR`
 - **Row-Level Security** — `rlsEnabled` + `policies[]` on `TableIR`, compiled to `CREATE POLICY` DDL