@typed-sql/postgres 1.0.0-rc.0 → 2.0.0-rc.1

package/CHANGELOG.md

@@ -1,5 +1,135 @@
 # @typed-sql/postgres
 
+## 2.0.0-rc.1
+
+### Patch Changes
+
+- Publish the coherent 2.0.0-rc.1 release-candidate train.
+
+## 2.0.0-rc.0
+
+### Major Changes
+
+- 29afc3d: Add conservative semantic primary/replica routing over application-owned databases, scoped
+  read-after-write pinning, explicit role requirements, stable unsafe-route errors, dialect runtime
+  semantic resolvers, and bounded abortable transaction retry policies with native PostgreSQL and
+  MySQL error classifiers. Parse and classify dialect locking reads so uncertain or affine work
+  always fails closed to primary.
+- 6a7ae58: Add opt-in live query verification through grammar-owned PostgreSQL PREPARE and MySQL
+  COM_STMT_PREPARE adapters, bounded neutral comparison, deterministic secret-free proof artifacts,
+  offline cache validation, explicit unsupported classifications, CLI workflows, real database E2E,
+  and performance budgets.
+- b06fd0a: Add grammar-neutral optional adapter capability discovery, typed PostgreSQL COPY import and export
+  through application-owned `pg-copy-streams`, and typed MySQL LOAD DATA import through mysql2's
+  application-owned infile stream. Bulk transfers preserve ordinary `INSERT` parameter evidence,
+  enforce structural row stability, apply bounded backpressure, support cancellation and progress,
+  and integrate with transaction ownership and conservative connection cleanup.
+- 3050209: Add the dialect contract v4 semantic query evidence foundation. PostgreSQL and MySQL now report operation, dependencies, cardinality, volatility, locking, connection affinity, and required capabilities; compiler results add deterministic query and structural-variant fingerprints and conservatively merged source-mapped semantics. Schema snapshots can record function volatility, and the AST package exposes a neutral statement walker for grammar implementations.
+- 1b054b6: Add an adapter-neutral, redacted database observation lifecycle for queries, cardinality contracts,
+  batches, PostgreSQL pipelines, streams, cancellation, and nested transactions. Runtime fingerprints
+  correlate with compiler structural variants while SQL, parameter values, connection configuration,
+  and driver causes remain excluded by default. Publish the optional OpenTelemetry bridge with current
+  database semantic conventions and explicit high-cardinality or exception-capture opt-ins.
+- 87189c3: Add grammar-neutral `all`, `one`, and `maybeOne` execution with exact row types, stable cardinality
+  and cancellation errors, explicit adapter capabilities, AbortSignal support, and absolute deadlines.
+  The pg and mysql2 adapters conservatively discard interrupted connections, including transaction
+  leases, while the existing uncontrolled `execute` path remains unchanged.
+- e654fae: Add opt-in Standard Schema V1 result validation with compile-time output compatibility, immutable
+  query attachment, sync and async validators, redacted fingerprinted errors, and consistent decoded-row
+  handling across buffered cardinality methods, batches, PostgreSQL pipelines, streams, and transactions.
+- b2ec119: Add opt-in, grammar-neutral query-plan governance with PostgreSQL and MySQL structured EXPLAIN
+  adapters, transient application-owned samples, redacted fingerprint-keyed artifacts, absolute and
+  comparable regression budgets, explicit uncertainty, CLI capture and review, documentation, and
+  performance coverage.
+
+### Patch Changes
+
+- Updated dependencies [29afc3d]
+- Updated dependencies [3f063f6]
+- Updated dependencies [6a7ae58]
+- Updated dependencies [af27a0e]
+- Updated dependencies [b06fd0a]
+- Updated dependencies [3050209]
+- Updated dependencies [1b054b6]
+- Updated dependencies [b4f1b6e]
+- Updated dependencies [87189c3]
+- Updated dependencies [e654fae]
+- Updated dependencies [b2ec119]
+  - @typed-sql/ast@2.0.0-rc.0
+  - @typed-sql/core@2.0.0-rc.0
+  - @typed-sql/schema@2.0.0-rc.0
+
+## 1.0.0
+
+### Major Changes
+
+- 7ca256b: Release the first public typed-sql beta: exact TypeScript 7 row inference from static PostgreSQL and
+  MySQL, versioned schema introspection, application-owned drivers, config-driven grammar plugins,
+  CLI verification, editor language-server integration, versioned diagnostics, bounded parsing, and
+  real-database plus packed-tarball verification.
+
+### Minor Changes
+
+- eb16de7: Add grammar-neutral stream and ordered-result type contracts, and add lazy prepared-query factories to the PostgreSQL and MySQL runtime adapters. Prepared factories retain exact query types, validate stable SQL shapes, and remain available inside nested transactions.
+- eb16de7: Add lazy, exactly typed query streams to the PostgreSQL and MySQL runtime adapters. PostgreSQL
+  uses an application-owned optional `pg-cursor` installation for bounded cursor reads. MySQL uses
+  mysql2's execute-protocol stream and shared decoder plan. Both adapters enforce deterministic
+  cleanup, transaction ownership, and positive safe-integer batch sizes.
+- eb16de7: Add a grammar-neutral validated query-batch type and ordered, exactly typed query batches to the
+  PostgreSQL and MySQL runtime adapters. Non-empty root batches execute sequentially on one leased
+  connection, transaction batches reuse their transaction connection, and empty batches avoid
+  connection acquisition. Batch execution preserves prepared metadata and adapter codecs, stops at
+  the first failure, and rejects transaction work that escapes its callback.
+- b6389e4: Add an exactly typed PostgreSQL `pipeline()` capability backed by node-postgres's documented opt-in pipeline mode. Pipelines lease one client, dispatch independent queries before awaiting their results, preserve tuple order and prepared metadata, settle every in-flight query before cleanup, and integrate with transaction rollback and non-escape guarantees without changing sequential `batch()` semantics.
+
+### Patch Changes
+
+- b6389e4: Cache immutable SQL rendering skeletons for prepared query factories so repeated calls only bind changing values while still rejecting structural drift before driver dispatch.
+- eb16de7: Own in-flight transaction executions through settlement so unawaited work can never race commit, savepoint release, rollback, or connection release.
+
+  The PostgreSQL adapter now also rejects pg's client-side `query_timeout` option because it can settle before the connection is safe to reuse. Root batches discard checked-out clients after query rejection, while caught transaction query, batch, and stream failures force rollback and discard the lease. Use PostgreSQL's server-enforced `statement_timeout` for statement deadlines.
+- eb16de7: Allow adapters to retain enriched capabilities in transaction callbacks and nested transactions
+  through a self-typed core database contract. Transaction cleanup now also preserves the original
+  operation error when rollback or connection-release cleanup fails.
+- 1563a7a: Declare and enforce the 1.0 package stability boundary. Core SQL, compiler, schema, config, AST,
+  PostgreSQL, MySQL, and CLI packages form the stable train; the TypeScript preview bridge and
+  language server remain explicitly experimental. Freeze public entrypoints and query type contracts,
+  and remove internal compiler/type helpers from stable package-root exports before 1.0.
+- 9dd6bc4: Finalize dialect contract version 3 with explicit identifier quoting and grammar-owned capability
+  declarations. Accept third-party snapshot dialects, validate grammar versions, and document the
+  public grammar-authoring and conformance workflow.
+- 16e2475: Prove npm trusted publishing and provenance after the initial registry bootstrap.
+- 642cebd: Prove and document runtime codec fidelity against live PostgreSQL and MySQL values. PostgreSQL now
+  delegates non-policy OIDs to the installed pg parser table, MySQL maps BIT to Uint8Array, and the
+  mysql2 adapter rejects pool settings that would contradict its type policy.
+- 3e2c75c: Infer ordered query parameter tuples and let TypeScript reject interpolation values that do not
+  match their SQL context. Dialect contract version 2 adds explicit parameter analysis; unresolved
+  positions remain `unknown`. Add typed nullable predicate composition through `sql.fragment()`,
+  `sql.and()`, `sql.or()`, `sql.where()`, and `sql.append()` while preserving row and parameter tuples.
+  Direct append fragments are grammar-analyzed cumulatively against their static base, so TypeScript
+  rejects fragment interpolation values that disagree with the referenced database columns.
+  Add `sql.empty` and SQL-template-native conditional structural fragments. The compiler analyzes
+  complete branch variants, preserves literal boolean-dependent result rows, and type-checks nested
+  fragment parameters without adding a query-builder DSL. Bound independent structural expansion at
+  64 variants by default, correlate repeated conditions, merge diagnostics and fragment expectations
+  across variants, and fail closed on incompatible contexts. Share indexed catalog and conservative
+  parameter-resolution primitives across grammars, harden cooked-template scanning, and add runtime,
+  resolver, scanner, and structural performance gates.
+- Updated dependencies [eb16de7]
+- Updated dependencies [b6389e4]
+- Updated dependencies [eb16de7]
+- Updated dependencies [b6389e4]
+- Updated dependencies [eb16de7]
+- Updated dependencies [1563a7a]
+- Updated dependencies [9dd6bc4]
+- Updated dependencies [7ca256b]
+- Updated dependencies [16e2475]
+- Updated dependencies [69c7d87]
+- Updated dependencies [3e2c75c]
+  - @typed-sql/core@1.0.0
+  - @typed-sql/ast@1.0.0
+  - @typed-sql/schema@1.0.0
+
 ## 1.0.0-rc.0
 
 ### Patch Changes

package/README.md

@@ -1,95 +1,87 @@
 # @typed-sql/postgres
 
-PostgreSQL grammar, catalog introspection, exact result inference, type policy, runtime codecs, and
-an optional application-owned `pg` adapter for [typed-sql](https://github.com/Lojhan/typed-sql).
+The stable PostgreSQL grammar for [typed-sql](https://github.com/Lojhan/typed-sql), including
+catalog introspection, row and parameter inference, type policy, runtime codecs, and an optional
+application-owned `pg` adapter, native live verifier, and structured-plan inspector.
 
 ```sh
-pnpm add @typed-sql/core@next @typed-sql/postgres@next pg
-pnpm add -D @typed-sql/cli@next typescript@7.0.2
+pnpm add @typed-sql/core @typed-sql/postgres pg
+pnpm add -D @typed-sql/cli typescript@7.0.2
 ```
 
-`pg` is intentionally not a dependency or peer dependency of this package. Your application chooses
-its driver version, pool configuration, and lifecycle; the adapter loads it only when you import
-`@typed-sql/postgres/pg`.
+`pg` is loaded only through `@typed-sql/postgres/pg`; it is not a dependency or peer dependency of
+the grammar. Applications that stream rows also install the optional application-owned cursor:
 
-## Configure and generate
-
-```ts
-import { defineConfig } from "@typed-sql/core";
-import { postgres, typePolicy } from "@typed-sql/postgres";
-import { pg } from "@typed-sql/postgres/pg";
-
-export default defineConfig({
-  dialect: postgres({ typePolicy }),
-  schema: {
-    file: "generated/db/schema.json",
-    provider: pg({
-      connectionString: () => process.env.DATABASE_URL!,
-      schemas: ["public"],
-      typePolicy,
-    }),
-  },
-  outDir: "generated/db",
-  projects: ["tsconfig.json"],
-  typePolicy,
-});
+```sh
+pnpm add pg-cursor
 ```
 
+Applications that use PostgreSQL COPY also install its optional application-owned stream:
+
 ```sh
-pnpm exec typed-sql generate
+pnpm add pg-copy-streams
 ```
 
-## Query and execute
-
 ```ts
-import { sql, typePolicy } from "@typed-sql/postgres";
+import { requireAdapterCapability } from "@typed-sql/core";
+import { postgresCopy, sql, typePolicy } from "@typed-sql/postgres";
 import { createPgDatabase } from "@typed-sql/postgres/pg";
 
 const query = sql`
-  SELECT account.id, account.email, account.status, project.budget
+  SELECT account.id, account.email, project.budget
   FROM users AS account
   LEFT JOIN projects AS project ON project.owner_id = account.id
-  ORDER BY account.id
 `;
 
 const database = await createPgDatabase({
   connectionString: process.env.DATABASE_URL!,
+  poolConfig: { pipeline: true },
   typePolicy,
+  copyStreamsImporter: () => import("pg-copy-streams"),
+  // observer: createOpenTelemetryObserver(),
 });
 
+// pipeline() requires the application-owned pg 8.23.0 or newer.
+
 const rows = await database.execute(query);
-// readonly {
-//   id: bigint;
-//   email: string;
-//   status: "active" | "suspended";
-//   budget: string | null;
-// }[]
+
+const accountById = database.prepare("account-by-id", (id: bigint) => sql`
+  SELECT account.id, account.email
+  FROM users AS account
+  WHERE account.id = ${id}
+`);
+
+const [selectedAccounts, allAccounts] = await database.batch([accountById(42n), query]);
+const [pipelinedAccount, pipelinedAll] = await database.pipeline([accountById(42n), query]);
+
+for await (const account of database.stream(accountById(42n), { batchSize: 500 })) {
+  // account retains the query's inferred row type
+}
+
+const copy = requireAdapterCapability(database, postgresCopy);
+await copy.copyFrom(
+  (account: { readonly id: bigint; readonly email: string }) =>
+    sql`INSERT INTO users (id, email) VALUES (${account.id}, ${account.email})`,
+  accounts,
+);
 ```
 
-The default lossless policy maps PostgreSQL `bigint` to `bigint`, `numeric` to `string`, temporal
-types to `Date`, JSON to `unknown`, enums to literal unions, arrays recursively, and `bytea` to
-`Uint8Array`. Per-query parsers do not mutate `pg` globals and delegate non-policy OIDs to the
-installed driver's native parser table. See the tested
-[runtime codec matrix](https://github.com/Lojhan/typed-sql/blob/main/docs/CODEC_FIDELITY.md#postgresql-and-pg).
-
-## Supported SQL
-
-| Surface | Status | Notes |
-| --- | --- | --- |
-| Static tagged templates | Supported | Imports and aliases from `@typed-sql/postgres` are recognized. |
-| `SELECT`, `DISTINCT`, `DISTINCT ON` | Supported | Static row-shape inference. |
-| Tables, schemas, aliases and stars | Supported | Catalog lookup, ambiguity checks and `USING` column merging. |
-| Inner and outer joins | Supported | Outer-join nullability propagates into result columns. |
-| CTEs and derived/correlated/scalar subqueries | Supported | Recursive CTEs and unsafe scalar/IN arity diagnose. |
-| Grouping, aggregates and windows | Supported | Includes common aggregates, `FILTER`, named and inline windows. |
-| Expressions, `CASE`, casts and `$n` parameters | Supported | Parameters infer from columns, casts, DML targets, ranges, limits, and catalog functions; ambiguous positions remain `unknown`. |
-| Arrays, enums, domains, JSON and catalog functions | Supported | Known types and function name/arity are validated. |
-| `INSERT`, `UPDATE`, `DELETE`, `RETURNING` | Supported | Commands without `RETURNING` infer `Query<never, Parameters>`. |
-| Set operations and `WITHIN GROUP` | Not supported | Fail safely during parsing. |
-| Dynamic SQL or identifiers | No static inference | Use runtime values and `sql.ident()` explicitly. |
-
-A feature not marked supported produces a diagnostic or `Query<unknown>`; it never receives an
-optimistic row type. Introspection covers tables, views, columns, defaults, server version, arrays,
-enums, domains and user functions.
+The package root exports `sql`, `postgres`, and the PostgreSQL type policy. The `/pg` entrypoint
+exports the schema provider, execution adapter, `createPgLiveVerifier`, and `createPgPlanInspector`;
+`/runtime` exposes driver-neutral PostgreSQL rendering and codecs.
+
+The root also exports `createPostgresRoutedDatabase`, the runtime semantic resolver, and the native
+transaction retry classifier. These compose application-owned adapters without installing or
+creating `pg` pools.
+
+Read the [PostgreSQL grammar guide](https://github.com/Lojhan/typed-sql/blob/main/docs/dialects/postgresql.md),
+[execution guide](https://github.com/Lojhan/typed-sql/blob/main/docs/guides/execution.md),
+[bulk data guide](https://github.com/Lojhan/typed-sql/blob/main/docs/guides/bulk-data.md),
+[observability guide](https://github.com/Lojhan/typed-sql/blob/main/docs/guides/observability.md),
+[live verification guide](https://github.com/Lojhan/typed-sql/blob/main/docs/guides/live-verification.md),
+[query plan governance guide](https://github.com/Lojhan/typed-sql/blob/main/docs/guides/query-plan-governance.md),
+[routing and retry guide](https://github.com/Lojhan/typed-sql/blob/main/docs/guides/routing-and-retries.md),
+[configuration](https://github.com/Lojhan/typed-sql/blob/main/docs/getting-started/configuration.md), and
+[database type mappings](https://github.com/Lojhan/typed-sql/blob/main/docs/reference/type-mappings.md).
 
 MIT © typed-sql contributors

package/dist/packages/postgres/src/bulk.d.ts

@@ -0,0 +1,30 @@
+import { type ExecutionOptions, type Query, type QueryStream } from "@typed-sql/core";
+export interface PostgresCopyProgress {
+    readonly rows: number;
+    readonly bytes: number;
+}
+export interface PostgresCopyResult extends PostgresCopyProgress {
+}
+export interface PostgresCopyFromOptions extends ExecutionOptions {
+    /** Preferred encoded chunk size. One unusually wide row may exceed it. */
+    readonly chunkBytes?: number;
+    readonly onProgress?: (progress: PostgresCopyProgress) => void;
+}
+export interface PostgresCopyToOptions extends ExecutionOptions {
+}
+export interface PostgresCopyTransport {
+    copyFrom(statement: string, chunks: AsyncIterable<Uint8Array>, options: ExecutionOptions): Promise<void>;
+    copyTo(statement: string, options: ExecutionOptions): QueryStream<Uint8Array>;
+}
+export interface PostgresCopyCapability {
+    /**
+     * Compiles one ordinary typed single-row INSERT factory into COPY FROM STDIN.
+     * Every later row must preserve the first query's exact structural shape.
+     */
+    copyFrom<Input, Row, Params extends readonly unknown[]>(rowQuery: (input: Input) => Query<Row, Params>, rows: Iterable<Input> | AsyncIterable<Input>, options?: PostgresCopyFromOptions): Promise<PostgresCopyResult>;
+    /** Streams raw PostgreSQL CSV bytes for a static typed SELECT query. */
+    copyTo<Row>(query: Query<Row, readonly []>, options?: PostgresCopyToOptions): QueryStream<Uint8Array>;
+}
+export declare const postgresCopy: import("@typed-sql/core").AdapterCapability<PostgresCopyCapability>;
+export declare function createPostgresCopyCapability(transport: PostgresCopyTransport): PostgresCopyCapability;
+//# sourceMappingURL=bulk.d.ts.map

package/dist/packages/postgres/src/bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../../../src/bulk.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,KAAK,EAEV,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AAOzB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;CAAG;AAEnE,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;CAAG;AAElE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,SAAS,OAAO,EAAE,EACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,EAC9C,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,EAC5C,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B,wEAAwE;IACxE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;CACvG;AAED,eAAO,MAAM,YAAY,qEAAmE,CAAC;AAqH7F,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,qBAAqB,GAAG,sBAAsB,CA2GrG"}

package/dist/packages/postgres/src/bulk.js

@@ -0,0 +1,228 @@
+import { parseStatement } from "@typed-sql/ast";
+import { bindQueryRenderSkeleton, compileQueryRenderSkeleton, defineAdapterCapability, QueryCancelledError, } from "@typed-sql/core";
+const postgresRenderer = Object.freeze({
+    placeholder: (index) => `$${index}`,
+    quoteIdentifier: (name) => `"${name.replaceAll('"', '""')}"`,
+});
+export const postgresCopy = defineAdapterCapability("postgres.copy");
+const encoder = new TextEncoder();
+const DEFAULT_CHUNK_BYTES = 64 * 1_024;
+function quoteIdentifier(value) {
+    return postgresRenderer.quoteIdentifier(value);
+}
+function postgresArrayElement(value) {
+    if (value === null || value === undefined)
+        return "NULL";
+    if (Array.isArray(value))
+        return postgresArray(value);
+    const encoded = postgresTextValue(value);
+    return `"${encoded.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+}
+function postgresArray(value) {
+    return `{${value.map(postgresArrayElement).join(",")}}`;
+}
+function postgresTextValue(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "bigint" || typeof value === "boolean")
+        return String(value);
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new RangeError("PostgreSQL COPY cannot encode non-finite numbers");
+        return String(value);
+    }
+    if (value instanceof Date) {
+        if (Number.isNaN(value.getTime()))
+            throw new RangeError("PostgreSQL COPY cannot encode an invalid Date");
+        return value.toISOString();
+    }
+    if (value instanceof Uint8Array)
+        return `\\x${Buffer.from(value).toString("hex")}`;
+    if (Array.isArray(value))
+        return postgresArray(value);
+    if (typeof value === "object" && value !== null)
+        return JSON.stringify(value);
+    throw new TypeError(`PostgreSQL COPY cannot encode ${typeof value} values`);
+}
+function csvField(value) {
+    if (value === null || value === undefined)
+        return "";
+    return `"${postgresTextValue(value).replaceAll('"', '""')}"`;
+}
+function csvRow(values) {
+    return encoder.encode(`${values.map(csvField).join(",")}\n`);
+}
+function chunkSize(value) {
+    const resolved = value ?? DEFAULT_CHUNK_BYTES;
+    if (!Number.isSafeInteger(resolved) || resolved <= 0) {
+        throw new RangeError("PostgreSQL COPY chunkBytes must be a positive safe integer");
+    }
+    return resolved;
+}
+function copyFromStatement(text, parameterCount) {
+    const statement = parseStatement(text);
+    if (statement.kind !== "insert" ||
+        statement.with !== undefined ||
+        statement.table.alias !== undefined ||
+        statement.source.kind !== "values" ||
+        statement.source.rows.length !== 1 ||
+        statement.returning.length !== 0 ||
+        statement.columns.length === 0) {
+        throw new TypeError("PostgreSQL COPY requires a plain single-row INSERT with an explicit column list, one VALUES row, and no RETURNING clause");
+    }
+    const values = statement.source.rows[0];
+    if (values.length !== statement.columns.length ||
+        values.length !== parameterCount ||
+        values.some((expression, index) => expression.kind !== "parameter" || expression.index !== index + 1)) {
+        throw new TypeError("PostgreSQL COPY INSERT values must be one ordered parameter per target column");
+    }
+    const table = `${statement.table.schema === undefined ? "" : `${quoteIdentifier(statement.table.schema.name)}.`}${quoteIdentifier(statement.table.name.name)}`;
+    const columns = statement.columns.map(({ name }) => quoteIdentifier(name)).join(", ");
+    return `COPY ${table} (${columns}) FROM STDIN WITH (FORMAT csv)`;
+}
+function copyToStatement(query) {
+    const { rendered } = compileQueryRenderSkeleton(query, postgresRenderer);
+    if (rendered.values.length !== 0)
+        throw new TypeError("PostgreSQL COPY TO accepts only static queries without parameters");
+    const text = rendered.text.trim().replace(/;\s*$/u, "");
+    if (parseStatement(text).kind !== "select") {
+        throw new TypeError("PostgreSQL COPY TO requires a SELECT query");
+    }
+    return `COPY (${text}) TO STDOUT WITH (FORMAT csv)`;
+}
+function cancelled(signal) {
+    if (signal?.aborted === true)
+        throw new QueryCancelledError("signal", { cause: signal.reason });
+}
+function asyncIterator(values) {
+    if (Symbol.asyncIterator in Object(values))
+        return values[Symbol.asyncIterator]();
+    const iterator = values[Symbol.iterator]();
+    return {
+        next: async () => iterator.next(),
+        ...(iterator.return === undefined ? {} : { return: async () => iterator.return() }),
+    };
+}
+function concatenate(chunks, length) {
+    if (chunks.length === 1)
+        return chunks[0];
+    const result = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return result;
+}
+export function createPostgresCopyCapability(transport) {
+    return Object.freeze({
+        async copyFrom(rowQuery, rows, options = {}) {
+            const preferredChunkBytes = chunkSize(options.chunkBytes);
+            cancelled(options.signal);
+            const iterator = asyncIterator(rows);
+            let iteratorClosed = false;
+            const closeIterator = async () => {
+                if (iteratorClosed || iterator.return === undefined)
+                    return;
+                iteratorClosed = true;
+                await iterator.return();
+            };
+            let first;
+            try {
+                first = await iterator.next();
+            }
+            catch (error) {
+                try {
+                    await closeIterator();
+                }
+                catch {
+                    /* Preserve the producer failure. */
+                }
+                throw error;
+            }
+            if (first.done === true)
+                return Object.freeze({ rows: 0, bytes: 0 });
+            let firstQuery;
+            let compiled;
+            let statement;
+            try {
+                firstQuery = rowQuery(first.value);
+                compiled = compileQueryRenderSkeleton(firstQuery, postgresRenderer);
+                statement = copyFromStatement(compiled.rendered.text, compiled.rendered.values.length);
+            }
+            catch (error) {
+                try {
+                    await closeIterator();
+                }
+                catch {
+                    /* Preserve the query compilation failure. */
+                }
+                throw error;
+            }
+            let rowCount = 0;
+            let byteCount = 0;
+            let inputComplete = false;
+            const chunks = (async function* () {
+                let pending = [];
+                let pendingBytes = 0;
+                let current = first;
+                try {
+                    while (current.done !== true) {
+                        cancelled(options.signal);
+                        const query = rowCount === 0 ? firstQuery : rowQuery(current.value);
+                        const rendered = rowCount === 0 ? compiled.rendered : bindQueryRenderSkeleton(query, compiled.skeleton);
+                        if (rendered === undefined) {
+                            throw new TypeError("PostgreSQL COPY row query changed its structural SQL shape");
+                        }
+                        const encoded = csvRow(rendered.values);
+                        if (pendingBytes > 0 && pendingBytes + encoded.byteLength > preferredChunkBytes) {
+                            const chunk = concatenate(pending, pendingBytes);
+                            byteCount += chunk.byteLength;
+                            options.onProgress?.(Object.freeze({ rows: rowCount, bytes: byteCount }));
+                            yield chunk;
+                            pending = [];
+                            pendingBytes = 0;
+                        }
+                        pending.push(encoded);
+                        pendingBytes += encoded.byteLength;
+                        rowCount += 1;
+                        current = await iterator.next();
+                    }
+                    inputComplete = true;
+                    if (pendingBytes > 0) {
+                        const chunk = concatenate(pending, pendingBytes);
+                        byteCount += chunk.byteLength;
+                        options.onProgress?.(Object.freeze({ rows: rowCount, bytes: byteCount }));
+                        yield chunk;
+                    }
+                }
+                finally {
+                    if (current.done !== true)
+                        await closeIterator();
+                }
+            })();
+            try {
+                await transport.copyFrom(statement, chunks, options);
+            }
+            catch (error) {
+                if (!inputComplete) {
+                    try {
+                        await closeIterator();
+                    }
+                    catch {
+                        /* Preserve the transport, producer, or database failure. */
+                    }
+                }
+                throw error;
+            }
+            if (!inputComplete)
+                await closeIterator();
+            return Object.freeze({ rows: rowCount, bytes: byteCount });
+        },
+        copyTo(query, options = {}) {
+            cancelled(options.signal);
+            return transport.copyTo(copyToStatement(query), options);
+        },
+    });
+}
+//# sourceMappingURL=bulk.js.map

package/dist/packages/postgres/src/bulk.js.map

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

package/dist/packages/postgres/src/index.d.ts

@@ -1,7 +1,9 @@
 import { type DialectPlugin } from "@typed-sql/core";
 import { type SchemaSnapshot } from "@typed-sql/schema";
 import { type PostgresTypePolicy } from "./type-policy.js";
-export declare const POSTGRES_DIALECT_VERSION = "1.0.0";
+export type { PostgresCopyCapability, PostgresCopyFromOptions, PostgresCopyProgress, PostgresCopyResult, PostgresCopyToOptions, } from "./bulk.js";
+export { postgresCopy } from "./bulk.js";
+export { POSTGRES_DIALECT_VERSION } from "./version.js";
 export type PostgresSchemaSnapshot = SchemaSnapshot & {
     readonly dialect: "postgres";
 };
@@ -14,6 +16,8 @@ export type { SchemaSnapshot } from "@typed-sql/schema";
 export { parseSchemaSnapshot } from "@typed-sql/schema";
 export type { PostgresDriverImporter, PostgresDriverModule, PostgresIntrospectionClient, PostgresIntrospectionPool, PostgresQueryable, PostgresQueryResult, PostgresSchemaProviderOptions, } from "./provider.js";
 export { introspectPostgres, loadPostgresDriver, PostgresSchemaProvider, postgresCatalogQueries } from "./provider.js";
+export type { PostgresQuerySemanticResolverOptions, PostgresRoutedDatabaseOptions } from "./routing.js";
+export { createPostgresQuerySemanticResolver, createPostgresRoutedDatabase, isPostgresRetryableTransactionError, } from "./routing.js";
 export type { PostgresTypePolicy } from "./type-policy.js";
 export { defaultPostgresTypePolicy, defaultPostgresTypePolicy as typePolicy, isKnownPostgresType, mapPostgresType, } from "./type-policy.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/postgres/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtF,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAEhD,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AACvF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C;AAyBD,wBAAgB,QAAQ,CACtB,OAAO,GAAE,sBAA2B,GACnC,aAAa,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CA8B3D;AAED,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvH,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,yBAAyB,EACzB,yBAAyB,IAAI,UAAU,EACvC,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,aAAa,EAAyB,MAAM,iBAAiB,CAAC;AACtG,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtF,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AACvF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CAC1C;AA0BD,wBAAgB,QAAQ,CACtB,OAAO,GAAE,sBAA2B,GACnC,aAAa,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAsC3D;AAED,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvH,YAAY,EAAE,oCAAoC,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AACxG,OAAO,EACL,mCAAmC,EACnC,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,yBAAyB,EACzB,yBAAyB,IAAI,UAAU,EACvC,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}