@zmdb/postgres 1.0.0-beta.1

package/README.md

@@ -0,0 +1,111 @@
+# @zmdb/postgres
+
+The PostgreSQL vertical owns the immutable `postgres` dialect, its migration hooks and catalog introspector, and the `postgresDriver` adapter. The shared query compiler comes from `@zmdb/sql`;
+repository and driver contracts come from `@zmdb/orm`. `postgresVertical` pairs this dialect with its driver factory.
+
+## Install
+
+```bash
+yarn add @zmdb/postgres@1.0.0-beta.1 @zmdb/sql@1.0.0-beta.1 @zmdb/migrations@1.0.0-beta.1 pg@^8.23.0
+```
+
+For the TypeScript snippets, install the declaration inputs used by the packed consumer:
+
+```bash
+yarn add --dev typescript@7.0.2 @types/node@26.4.1 @types/pg@8.23.1
+```
+
+Use Node.js 26+ and ESM. Keep the required `@zmdb/sql` and `@zmdb/orm` peers aligned with this package's version; npm resolves those peers. An application already using `zmdb` adds its selected
+database package and client rather than replacing the product facade.
+
+`pg` is an optional peer in package metadata because callers supply the structural client. Install it explicitly for this node-postgres recipe; importing the vertical itself does not import the SDK or
+create a pool.
+
+## Configure
+
+The snippets below are successive steps in one module.
+
+```ts
+import { Pool } from 'pg';
+import { postgres, postgresDriver } from '@zmdb/postgres';
+
+const client = new Pool({ connectionString: process.env.DATABASE_URL });
+const driver = postgresDriver(client);
+```
+
+The application owns the client and closes it with `await client.end()` in a `finally` block after its work. Hosted services that accept this client's protocol are connection recipes, not additional
+official database packages or automatically qualified server variants.
+
+## Compile
+
+```ts
+import { createQueryCompiler } from '@zmdb/sql';
+
+const compiler = createQueryCompiler(postgres);
+const query = compiler.selectFrom('users').where('id', '=', 7).compile();
+```
+
+Compilation is pure: the result carries SQL text and a separate parameter array. It does not create the `users` table or open a connection.
+
+## Migrate
+
+Use `postgres.migrations.emitUp(operation)` to obtain this database's DDL and `postgres.migrations.connection(driver)` to create its migration connection. Pass reviewed migration records to `up` and
+`down` from `@zmdb/migrations`; transactional behavior follows the capability table below. The [complete installed workflow](../../fixtures/consumer-database-publication/runtime.mjs) creates a fresh
+table, applies and rolls back its migration, and closes the supplied client.
+
+## Introspect
+
+```ts
+const snapshot = await postgres.introspector.snapshot(driver);
+```
+
+The snapshot comes from the selected database's real catalog through the same driver. `postgresIntrospector` is also exported directly. Introspection and generated DDL use this vertical's semantics.
+
+## Execute
+
+```ts
+const rows = await driver.execute(query);
+```
+
+Run this after migrating or otherwise creating the table. Use `driver.transaction(async transaction => ...)` for a pinned transactional driver; the application decides whether to retry. Query values
+travel as parameters, not SQL string interpolation.
+
+## Capabilities
+
+These entries describe `postgres.capabilities`; a true entry can still require the client support described below.
+
+| Capability                            | Advertised support |
+| ------------------------------------- | ------------------ |
+| INSERT/upsert/UPDATE/DELETE returning | yes                |
+| Transactional DDL                     | yes                |
+| Schemas                               | yes                |
+| Sequences                             | yes                |
+| Generated columns                     | yes                |
+| Partial indexes                       | yes                |
+| Foreign keys                          | yes                |
+| Row-level security                    | yes                |
+| Streaming                             | yes                |
+| Server-side cancellation              | yes                |
+
+## Refusals and ownership
+
+Cursor streaming requires a queryable that can check out a client. Server-side cancellation additionally requires an independent queryable through `PgOptions.cancelVia`; the basic pool example does
+not enable it. Retrying a transaction is explicit and reruns its callback, so keep non-idempotent external effects outside that callback.
+
+PostgreSQL owns the parent dialect. Its public `postgresFamilyDriver`, `postgresFamilyIntrospector` and `postgresFamilyMigrations` let `@zmdb/cockroach` supply its own dialect and overrides. The
+dependency points from CockroachDB to PostgreSQL; the parent does not install or inspect its child.
+
+`postgresOutboxMigration(version)` provides the PostgreSQL outbox table, defaults and partial pending index as an ordinary migration.
+
+## Testing evidence
+
+The [database publication qualification](../../fixtures/consumer-database-publication) builds real npm archives and installs this selected package in an independent consumer. Its public workflow
+covers strict declarations, package/client ownership, parameterized CRUD, transaction rollback, migration application/rollback and catalog introspection. The
+[PostgreSQL consumer](../../fixtures/database-postgres) adds the database-specific capability and refusal checks.
+
+Issue [#676](https://github.com/ambasta/zmdb/issues/676) records the completed installed workflows. Those observations are scoped to their recorded clients and servers; they do not certify every
+compatible hosted service. Qualification reports identify their source, archive and server inputs. See the [PostgreSQL guide](../../docs-site/content/dialect-postgres.md) for the detailed contract.
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later) — see [LICENSE](./LICENSE).

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+import { type DialectTypeMap } from '@zmdb/sql';
+export declare const POSTGRES_TYPES: DialectTypeMap;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,eAAO,MAAM,cAAc,EAAE,cAW3B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,14 @@
+import {} from '@zmdb/sql';
+export const POSTGRES_TYPES = Object.freeze({
+    serial: 'SERIAL',
+    integer: 'INTEGER',
+    bigint: 'BIGINT',
+    numeric: 'NUMERIC',
+    text: 'TEXT',
+    varchar: 'VARCHAR',
+    boolean: 'BOOLEAN',
+    timestamp: 'TIMESTAMPTZ',
+    json: 'JSONB',
+    jsonEnum: 'TEXT',
+});
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,MAAM,WAAW,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAmB,MAAM,CAAC,MAAM,CAAC;IAC1D,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,aAAa;IACxB,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,MAAM;CACjB,CAAC,CAAC"}

package/dist/driver.d.ts

@@ -0,0 +1,27 @@
+import { type TransactionalDriver } from '@zmdb/orm';
+import { type SqlDialect } from '@zmdb/sql';
+export interface PgQueryable {
+    query(text: string, params?: readonly unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+    }>;
+    query(config: {
+        readonly name?: string;
+        readonly queryMode?: 'extended';
+        readonly text: string;
+        readonly values?: readonly unknown[];
+    }): Promise<{
+        rows: Record<string, unknown>[];
+    }>;
+    connect?(): Promise<PgConnection>;
+}
+export interface PgConnection extends PgQueryable {
+    release?(): void;
+}
+export interface PgOptions {
+    readonly prepared?: boolean;
+    readonly maxCacheSize?: number;
+    /** A queryable guaranteed to use a connection other than the running backend. */
+    readonly cancelVia?: PgQueryable;
+}
+export declare function postgresFamilyDriver<Name extends string>(dialect: SqlDialect<Name>, client: PgQueryable, options?: PgOptions): TransactionalDriver<Name>;
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/F,KAAK,CAAC,MAAM,EAAE;QACZ,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;QAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;KACtC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC;CAClC;AAiBD,wBAAgB,oBAAoB,CAAC,IAAI,SAAS,MAAM,EACtD,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,EACzB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,SAAS,GAClB,mBAAmB,CAAC,IAAI,CAAC,CAE3B"}

package/dist/driver.js

@@ -0,0 +1,266 @@
+import {} from '@zmdb/orm';
+import {} from '@zmdb/sql';
+export function postgresFamilyDriver(dialect, client, options) {
+    return createPostgresDriver(dialect, client, options, false, new WeakMap());
+}
+function createPostgresDriver(dialect, client, options, pinned, preparedStates) {
+    const prepared = options?.prepared ?? false;
+    const maxCacheSize = options?.maxCacheSize ?? 1000;
+    if (!Number.isSafeInteger(maxCacheSize) || maxCacheSize < 0) {
+        throw new RangeError('maxCacheSize must be a non-negative safe integer');
+    }
+    let cursorSequence = 0;
+    const stateFor = (target) => {
+        const current = preparedStates.get(target);
+        if (current !== undefined)
+            return current;
+        const created = { names: new Map(), sequence: 0 };
+        preparedStates.set(target, created);
+        return created;
+    };
+    const preparedName = async (target, text) => {
+        const preparedState = stateFor(target);
+        const cached = maxCacheSize > 0 ? preparedState.names.get(text) : undefined;
+        if (cached !== undefined) {
+            preparedState.names.delete(text);
+            preparedState.names.set(text, cached);
+            return cached;
+        }
+        const name = `zmdb_${(preparedState.sequence++).toString(36)}`;
+        if (maxCacheSize > 0) {
+            if (preparedState.names.size >= maxCacheSize) {
+                const oldestSql = preparedState.names.keys().next().value;
+                if (oldestSql !== undefined) {
+                    const oldestName = preparedState.names.get(oldestSql);
+                    preparedState.names.delete(oldestSql);
+                    if (oldestName !== undefined)
+                        await target.query(`DEALLOCATE ${oldestName}`);
+                }
+            }
+            preparedState.names.set(text, name);
+        }
+        return name;
+    };
+    const executeOn = async (target, query) => {
+        const result = !prepared
+            ? await target.query(query.text, query.parameters)
+            : maxCacheSize === 0
+                ? await target.query({
+                    queryMode: 'extended',
+                    text: query.text,
+                    values: query.parameters,
+                })
+                : await target.query({
+                    name: await preparedName(target, query.text),
+                    text: query.text,
+                    values: query.parameters,
+                });
+        return result.rows;
+    };
+    const driver = {
+        dialect,
+        async execute(query, executeOptions) {
+            const signal = executeOptions?.signal;
+            signal?.throwIfAborted();
+            const cancelVia = options?.cancelVia;
+            if (signal === undefined || cancelVia === undefined) {
+                const ownsPreparedConnection = prepared && !pinned && isPool(client);
+                const target = ownsPreparedConnection ? await client.connect() : client;
+                try {
+                    const rows = await executeOn(target, query);
+                    signal?.throwIfAborted();
+                    return rows;
+                }
+                finally {
+                    if (ownsPreparedConnection)
+                        release(target);
+                }
+            }
+            const ownsConnection = !pinned && isPool(client);
+            const connection = ownsConnection ? await client.connect() : client;
+            try {
+                signal.throwIfAborted();
+                const pid = await backendPid(connection);
+                signal.throwIfAborted();
+                const removeAbort = forwardAbort(signal, pid, cancelVia);
+                try {
+                    const rows = await executeOn(connection, query);
+                    signal.throwIfAborted();
+                    return rows;
+                }
+                catch (error) {
+                    if (signal.aborted)
+                        signal.throwIfAborted();
+                    throw error;
+                }
+                finally {
+                    removeAbort();
+                }
+            }
+            finally {
+                if (ownsConnection)
+                    release(connection);
+            }
+        },
+        ...(pinned || isPool(client)
+            ? {
+                stream(query, executeOptions) {
+                    return streamPostgres(client, query, executeOptions, options?.cancelVia, pinned, `zmdb_${(cursorSequence++).toString(36)}`);
+                },
+            }
+            : {}),
+        async transaction(run) {
+            if (!isPool(client)) {
+                return runTransaction(dialect, client, options, preparedStates, run);
+            }
+            const connection = await client.connect();
+            try {
+                return await runTransaction(dialect, connection, options, preparedStates, run);
+            }
+            finally {
+                connection.release();
+            }
+        },
+    };
+    return driver;
+}
+async function runTransaction(dialect, connection, options, preparedStates, run) {
+    const transactionDriver = createPostgresDriver(dialect, connection, options, true, preparedStates);
+    await connection.query('BEGIN');
+    try {
+        const result = await run(transactionDriver);
+        await connection.query('COMMIT');
+        return result;
+    }
+    catch (error) {
+        await connection.query('ROLLBACK');
+        throw error;
+    }
+}
+async function backendPid(connection) {
+    const result = await connection.query('SELECT pg_backend_pid() AS pid');
+    const pid = result.rows[0]?.['pid'];
+    if (typeof pid !== 'number' || !Number.isInteger(pid) || pid <= 0) {
+        throw new Error('postgresDriver could not read a valid pg_backend_pid()');
+    }
+    return pid;
+}
+function forwardAbort(signal, pid, cancelVia) {
+    let sent = false;
+    const cancel = () => {
+        if (sent)
+            return;
+        sent = true;
+        void cancelVia.query('SELECT pg_cancel_backend($1)', [pid]).catch(() => { });
+    };
+    signal.addEventListener('abort', cancel, { once: true });
+    if (signal.aborted)
+        cancel();
+    return () => signal.removeEventListener('abort', cancel);
+}
+function streamPostgres(client, query, options, cancelVia, pinned, cursorName) {
+    const batchSize = options?.batchSize ?? 100;
+    if (!Number.isSafeInteger(batchSize) || batchSize <= 0) {
+        throw new RangeError('batchSize must be a positive safe integer');
+    }
+    return {
+        [Symbol.asyncIterator]() {
+            let cleanupFailure;
+            const generator = (async function* () {
+                const signal = options?.signal;
+                signal?.throwIfAborted();
+                const ownsConnection = !pinned && isPool(client);
+                const connection = ownsConnection ? await client.connect() : client;
+                let transactionOpen = false;
+                let cursorOpen = false;
+                let bodyFailure;
+                let removeAbort = () => { };
+                try {
+                    signal?.throwIfAborted();
+                    const pid = await backendPid(connection);
+                    if (signal !== undefined && cancelVia !== undefined) {
+                        removeAbort = forwardAbort(signal, pid, cancelVia);
+                    }
+                    signal?.throwIfAborted();
+                    if (ownsConnection) {
+                        await connection.query('BEGIN');
+                        transactionOpen = true;
+                    }
+                    await connection.query({
+                        text: `DECLARE "${cursorName}" NO SCROLL CURSOR FOR ${query.text}`,
+                        values: query.parameters,
+                    });
+                    cursorOpen = true;
+                    while (true) {
+                        signal?.throwIfAborted();
+                        const fetched = await connection.query(`FETCH FORWARD ${batchSize} FROM "${cursorName}"`);
+                        signal?.throwIfAborted();
+                        if (fetched.rows.length === 0)
+                            break;
+                        for (const row of fetched.rows) {
+                            signal?.throwIfAborted();
+                            yield row;
+                        }
+                    }
+                }
+                catch (error) {
+                    bodyFailure = signal?.aborted === true ? signal.reason : error;
+                }
+                finally {
+                    removeAbort();
+                    if (cursorOpen) {
+                        try {
+                            await connection.query(`CLOSE "${cursorName}"`);
+                        }
+                        catch (error) {
+                            cleanupFailure ??= error;
+                        }
+                    }
+                    if (transactionOpen) {
+                        try {
+                            await connection.query(bodyFailure === undefined && cleanupFailure === undefined ? 'COMMIT' : 'ROLLBACK');
+                        }
+                        catch (error) {
+                            cleanupFailure ??= error;
+                            try {
+                                await connection.query('ROLLBACK');
+                            }
+                            catch (rollbackError) {
+                                cleanupFailure ??= rollbackError;
+                            }
+                        }
+                    }
+                    if (ownsConnection)
+                        release(connection);
+                }
+                if (bodyFailure !== undefined)
+                    throw bodyFailure;
+                if (cleanupFailure !== undefined)
+                    throw cleanupFailure;
+            })();
+            return {
+                next: () => generator.next(),
+                async return() {
+                    const result = await generator.return(undefined);
+                    if (cleanupFailure !== undefined)
+                        throw cleanupFailure;
+                    return result;
+                },
+                throw: error => generator.throw(error),
+            };
+        },
+    };
+}
+function release(connection) {
+    const method = Reflect.get(connection, 'release');
+    if (typeof method === 'function')
+        Reflect.apply(method, connection, []);
+}
+function isPool(client) {
+    return (typeof client.connect === 'function' &&
+        'totalCount' in client &&
+        typeof client.totalCount === 'number' &&
+        'idleCount' in client &&
+        typeof client.idleCount === 'number');
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { type DatabaseVertical, type TransactionalDriver } from '@zmdb/orm';
+import { type SqlDialect } from '@zmdb/sql';
+import { postgresFamilyDriver, type PgConnection, type PgOptions, type PgQueryable } from './driver.js';
+import { postgresFamilyIntrospector, type PostgresCatalogOverrides } from './introspect.js';
+import { postgresFamilyMigrations, type PostgresMigrationOptions } from './migrations.js';
+export type { PgConnection, PgOptions, PgQueryable, PostgresCatalogOverrides, PostgresMigrationOptions };
+export { postgresFamilyDriver, postgresFamilyIntrospector, postgresFamilyMigrations };
+export { POSTGRES_OUTBOX_TABLE, postgresOutboxMigration, postgresOutboxPendingIndexDdl, postgresOutboxTableDdl, } from './outbox.js';
+export declare const postgresIntrospector: import("@zmdb/sql").Introspector<"postgres">;
+export declare const postgres: SqlDialect<'postgres'>;
+export declare function postgresDriver(client: PgQueryable, options?: PgOptions): TransactionalDriver<'postgres'>;
+export declare const postgresVertical: DatabaseVertical<'postgres', PgQueryable, PgOptions>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,0BAA0B,EAAE,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE1F,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,CAAC;AACzG,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,CAAC;AACtF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAyDrB,eAAO,MAAM,oBAAoB,8CAAyC,CAAC;AAE3E,eAAO,MAAM,QAAQ,EAAE,UAAU,CAAC,UAAU,CAe1C,CAAC;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAExG;AAED,eAAO,MAAM,gBAAgB,EAAE,gBAAgB,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,CAGhF,CAAC"}

package/dist/index.js

@@ -0,0 +1,86 @@
+import {} from '@zmdb/orm';
+import { defineSqlDialect, } from '@zmdb/sql';
+import { POSTGRES_TYPES } from './constants.js';
+import { postgresFamilyDriver } from './driver.js';
+import { postgresFamilyIntrospector } from './introspect.js';
+import { postgresFamilyMigrations } from './migrations.js';
+export { postgresFamilyDriver, postgresFamilyIntrospector, postgresFamilyMigrations };
+export { POSTGRES_OUTBOX_TABLE, postgresOutboxMigration, postgresOutboxPendingIndexDdl, postgresOutboxTableDdl, } from './outbox.js';
+const UNMAPPED_OPERATOR_TOKEN = /^(?!.*--)[A-Za-z@<>=!~*&|?-]{1,4}$/;
+const POSTGRES_QUOTE = ['"', '"'];
+Object.freeze(POSTGRES_QUOTE);
+const traits = Object.freeze({
+    placeholder: 'numbered',
+    quote: POSTGRES_QUOTE,
+    paginate: ({ limit, offset }) => {
+        let text = '';
+        if (limit !== undefined)
+            text += ` LIMIT ${limit}`;
+        if (offset !== undefined)
+            text += ` OFFSET ${offset}`;
+        return text;
+    },
+    paginationRequiresOrder: false,
+    rowValueIn: true,
+    returning: Object.freeze({
+        insert: 'suffix',
+        upsert: 'suffix',
+        update: 'suffix',
+        delete: 'suffix',
+    }),
+    upsert: 'onConflict',
+    fts: 'tsvector',
+    concat: 'operator',
+    booleanNot: 'not',
+    types: POSTGRES_TYPES,
+    paramLimit: 60_000,
+    retryableCodes: Object.freeze(['40001', '40P01']),
+    acceptsOperator: (operator) => operator === '#>' || operator === '#>>' || UNMAPPED_OPERATOR_TOKEN.test(operator),
+    functions: true,
+    procedures: true,
+    tableFunctions: true,
+    vectorDistance: true,
+    spatialPredicates: true,
+});
+const capabilities = Object.freeze({
+    returning: Object.freeze({
+        insert: true,
+        upsert: true,
+        update: true,
+        delete: true,
+    }),
+    transactionalDdl: true,
+    schemas: true,
+    sequences: true,
+    generatedColumns: true,
+    partialIndexes: true,
+    foreignKeys: true,
+    rowLevelSecurity: true,
+    streaming: true,
+    cancellation: true,
+});
+export const postgresIntrospector = postgresFamilyIntrospector('postgres');
+export const postgres = defineSqlDialect({
+    name: 'postgres',
+    family: 'postgres',
+    telemetrySystem: 'postgresql',
+    traits,
+    capabilities,
+    migrations: postgresFamilyMigrations('postgres'),
+    introspector: postgresIntrospector,
+    outbox: Object.freeze({
+        createTable: 'CREATE TABLE',
+        pendingIndex: 'filtered',
+        epochLiteral: "'1970-01-01T00:00:00.000Z'",
+        createdAtDefault: 'CURRENT_TIMESTAMP',
+        boundedTextType: () => 'TEXT',
+    }),
+});
+export function postgresDriver(client, options) {
+    return postgresFamilyDriver(postgres, client, options);
+}
+export const postgresVertical = Object.freeze({
+    dialect: postgres,
+    driver: postgresDriver,
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/introspect.d.ts

@@ -0,0 +1,8 @@
+import type { SchemaSnapshot } from '@zmdb/migrations';
+import type { CatalogSchemaSnapshot, IntrospectionDriver, Introspector, IntrospectOptions } from '@zmdb/migrations/introspect/runtime';
+export interface PostgresCatalogOverrides {
+    readonly snapshot?: (parent: (driver: IntrospectionDriver, options?: IntrospectOptions) => Promise<CatalogSchemaSnapshot>, driver: IntrospectionDriver, options?: IntrospectOptions) => Promise<CatalogSchemaSnapshot>;
+    readonly normalizeForDrift?: (parent: (snapshot: CatalogSchemaSnapshot, role: 'live' | 'declared') => SchemaSnapshot, snapshot: CatalogSchemaSnapshot, role: 'live' | 'declared') => SchemaSnapshot;
+}
+export declare function postgresFamilyIntrospector<Name extends string>(name: Name, overrides?: PostgresCatalogOverrides): Introspector<Name>;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../src/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAKV,qBAAqB,EAGrB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EAElB,MAAM,qCAAqC,CAAC;AAG7C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAClB,MAAM,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,qBAAqB,CAAC,EACpG,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,KAAK,cAAc,EACtF,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,MAAM,GAAG,UAAU,KACtB,cAAc,CAAC;CACrB;AAolBD,wBAAgB,0BAA0B,CAAC,IAAI,SAAS,MAAM,EAC5D,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,wBAA6B,GACvC,YAAY,CAAC,IAAI,CAAC,CAkBpB"}