@prisma-next/driver-postgres 0.12.0 → 0.13.0-dev.1

package/dist/control.d.mts

@@ -1,12 +1,9 @@
 import { Client } from "pg";
-import { ControlDriverDescriptor, ControlDriverInstance } from "@prisma-next/framework-components/control";
+import { ControlDriverDescriptor } from "@prisma-next/framework-components/control";
+import { SqlControlDriverInstance } from "@prisma-next/sql-contract/types";
 
 //#region src/exports/control.d.ts
-/**
- * Postgres control driver instance for control-plane operations.
- * Implements ControlDriverInstance<'sql', 'postgres'> for database queries.
- */
-declare class PostgresControlDriver implements ControlDriverInstance<'sql', 'postgres'> {
+declare class PostgresControlDriver implements SqlControlDriverInstance<'postgres'> {
   private readonly client;
   readonly familyId: "sql";
   readonly targetId: "postgres";

package/dist/control.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"control.d.mts","names":[],"sources":["../src/exports/control.ts"],"mappings":";;;;;;AAgBA;;cAAa,qBAAA,YAAiC,qBAAA;EAAA,iBAIf,MAAA;EAAA,SAHpB,QAAA;EAAA,SACA,QAAA;cAEoB,MAAA,EAAQ,MAAA;EAE/B,KAAA,OAAY,MAAA,kBAAA,CAChB,GAAA,UACA,MAAA,wBACC,OAAA;IAAA,SAAmB,IAAA,EAAM,GAAA;EAAA;EAStB,KAAA,CAAA,GAAS,OAAA;AAAA;;;;cAQX,wBAAA,EAA0B,uBAAuB,oBAAoB,qBAAA"}
+{"version":3,"file":"control.d.mts","names":[],"sources":["../src/exports/control.ts"],"mappings":";;;;;cAUa,qBAAA,YAAiC,wBAAA;EAAA,iBAIf,MAAA;EAAA,SAHpB,QAAA;EAAA,SACA,QAAA;cAEoB,MAAA,EAAQ,MAAA;EAE/B,KAAA,OAAY,MAAA,mBAChB,GAAA,UACA,MAAA,wBACC,OAAA;IAAA,SAAmB,IAAA,EAAM,GAAA;EAAA;EAStB,KAAA,IAAS,OAAA;AAAA;;;;cAQX,wBAAA,EAA0B,uBAAuB,oBAAoB,qBAAA"}

package/dist/control.mjs

@@ -1,14 +1,10 @@
-import { i as postgresDriverDescriptorMeta, r as normalizePgError } from "./normalize-error-DHkbdIrm.mjs";
+import { i as postgresDriverDescriptorMeta, r as normalizePgError } from "./normalize-error-DnabvDFD.mjs";
 import { errorRuntime } from "@prisma-next/errors/execution";
 import { SqlQueryError } from "@prisma-next/sql-errors";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { redactDatabaseUrl } from "@prisma-next/utils/redact-db-url";
 import { Client } from "pg";
 //#region src/exports/control.ts
-/**
-* Postgres control driver instance for control-plane operations.
-* Implements ControlDriverInstance<'sql', 'postgres'> for database queries.
-*/
 var PostgresControlDriver = class {
 	client;
 	familyId = "sql";

package/dist/control.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"control.mjs","names":[],"sources":["../src/exports/control.ts"],"sourcesContent":["import { errorRuntime } from '@prisma-next/errors/execution';\nimport type {\n  ControlDriverDescriptor,\n  ControlDriverInstance,\n} from '@prisma-next/framework-components/control';\nimport { SqlQueryError } from '@prisma-next/sql-errors';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { redactDatabaseUrl } from '@prisma-next/utils/redact-db-url';\nimport { Client } from 'pg';\nimport { postgresDriverDescriptorMeta } from '../core/descriptor-meta';\nimport { normalizePgError } from '../normalize-error';\n\n/**\n * Postgres control driver instance for control-plane operations.\n * Implements ControlDriverInstance<'sql', 'postgres'> for database queries.\n */\nexport class PostgresControlDriver implements ControlDriverInstance<'sql', 'postgres'> {\n  readonly familyId = 'sql' as const;\n  readonly targetId = 'postgres' as const;\n\n  constructor(private readonly client: Client) {}\n\n  async query<Row = Record<string, unknown>>(\n    sql: string,\n    params?: readonly unknown[],\n  ): Promise<{ readonly rows: Row[] }> {\n    try {\n      const result = await this.client.query(sql, params as unknown[] | undefined);\n      return { rows: result.rows as Row[] };\n    } catch (error) {\n      throw normalizePgError(error);\n    }\n  }\n\n  async close(): Promise<void> {\n    await this.client.end();\n  }\n}\n\n/**\n * Postgres driver descriptor for CLI config.\n */\nconst postgresDriverDescriptor: ControlDriverDescriptor<'sql', 'postgres', PostgresControlDriver> =\n  {\n    ...postgresDriverDescriptorMeta,\n    async create(url: string): Promise<PostgresControlDriver> {\n      const client = new Client({ connectionString: url });\n      try {\n        await client.connect();\n        return new PostgresControlDriver(client);\n      } catch (error) {\n        const normalized = normalizePgError(error);\n        const redacted = redactDatabaseUrl(url);\n        try {\n          await client.end();\n        } catch {\n          // ignore\n        }\n\n        const codeFromSqlState = SqlQueryError.is(normalized) ? normalized.sqlState : undefined;\n        const causeCode =\n          'cause' in normalized && normalized.cause\n            ? (normalized.cause as { code?: unknown }).code\n            : undefined;\n        const code = codeFromSqlState ?? causeCode;\n\n        throw errorRuntime('Database connection failed', {\n          why: normalized.message,\n          fix: 'Verify the database URL, ensure the database is reachable, and confirm credentials/permissions',\n          meta: {\n            ...ifDefined('code', code),\n            ...redacted,\n          },\n        });\n      }\n    },\n  };\n\nexport default postgresDriverDescriptor;\n"],"mappings":";;;;;;;;;;;AAgBA,IAAa,wBAAb,MAAuF;CAIxD;CAH7B,WAAoB;CACpB,WAAoB;CAEpB,YAAY,QAAiC;EAAhB,KAAA,SAAA;CAAiB;CAE9C,MAAM,MACJ,KACA,QACmC;EACnC,IAAI;GAEF,OAAO,EAAE,OAAM,MADM,KAAK,OAAO,MAAM,KAAK,MAA+B,GACrD,KAAc;EACtC,SAAS,OAAO;GACd,MAAM,iBAAiB,KAAK;EAC9B;CACF;CAEA,MAAM,QAAuB;EAC3B,MAAM,KAAK,OAAO,IAAI;CACxB;AACF;;;;AAKA,MAAM,2BACJ;CACE,GAAG;CACH,MAAM,OAAO,KAA6C;EACxD,MAAM,SAAS,IAAI,OAAO,EAAE,kBAAkB,IAAI,CAAC;EACnD,IAAI;GACF,MAAM,OAAO,QAAQ;GACrB,OAAO,IAAI,sBAAsB,MAAM;EACzC,SAAS,OAAO;GACd,MAAM,aAAa,iBAAiB,KAAK;GACzC,MAAM,WAAW,kBAAkB,GAAG;GACtC,IAAI;IACF,MAAM,OAAO,IAAI;GACnB,QAAQ,CAER;GAEA,MAAM,mBAAmB,cAAc,GAAG,UAAU,IAAI,WAAW,WAAW,KAAA;GAC9E,MAAM,YACJ,WAAW,cAAc,WAAW,QAC/B,WAAW,MAA6B,OACzC,KAAA;GACN,MAAM,OAAO,oBAAoB;GAEjC,MAAM,aAAa,8BAA8B;IAC/C,KAAK,WAAW;IAChB,KAAK;IACL,MAAM;KACJ,GAAG,UAAU,QAAQ,IAAI;KACzB,GAAG;IACL;GACF,CAAC;EACH;CACF;AACF"}
+{"version":3,"file":"control.mjs","names":[],"sources":["../src/exports/control.ts"],"sourcesContent":["import { errorRuntime } from '@prisma-next/errors/execution';\nimport type { ControlDriverDescriptor } from '@prisma-next/framework-components/control';\nimport type { SqlControlDriverInstance } from '@prisma-next/sql-contract/types';\nimport { SqlQueryError } from '@prisma-next/sql-errors';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { redactDatabaseUrl } from '@prisma-next/utils/redact-db-url';\nimport { Client } from 'pg';\nimport { postgresDriverDescriptorMeta } from '../core/descriptor-meta';\nimport { normalizePgError } from '../normalize-error';\n\nexport class PostgresControlDriver implements SqlControlDriverInstance<'postgres'> {\n  readonly familyId = 'sql' as const;\n  readonly targetId = 'postgres' as const;\n\n  constructor(private readonly client: Client) {}\n\n  async query<Row = Record<string, unknown>>(\n    sql: string,\n    params?: readonly unknown[],\n  ): Promise<{ readonly rows: Row[] }> {\n    try {\n      const result = await this.client.query(sql, params as unknown[] | undefined);\n      return { rows: result.rows as Row[] };\n    } catch (error) {\n      throw normalizePgError(error);\n    }\n  }\n\n  async close(): Promise<void> {\n    await this.client.end();\n  }\n}\n\n/**\n * Postgres driver descriptor for CLI config.\n */\nconst postgresDriverDescriptor: ControlDriverDescriptor<'sql', 'postgres', PostgresControlDriver> =\n  {\n    ...postgresDriverDescriptorMeta,\n    async create(url: string): Promise<PostgresControlDriver> {\n      const client = new Client({ connectionString: url });\n      try {\n        await client.connect();\n        return new PostgresControlDriver(client);\n      } catch (error) {\n        const normalized = normalizePgError(error);\n        const redacted = redactDatabaseUrl(url);\n        try {\n          await client.end();\n        } catch {\n          // ignore\n        }\n\n        const codeFromSqlState = SqlQueryError.is(normalized) ? normalized.sqlState : undefined;\n        const causeCode =\n          'cause' in normalized && normalized.cause\n            ? (normalized.cause as { code?: unknown }).code\n            : undefined;\n        const code = codeFromSqlState ?? causeCode;\n\n        throw errorRuntime('Database connection failed', {\n          why: normalized.message,\n          fix: 'Verify the database URL, ensure the database is reachable, and confirm credentials/permissions',\n          meta: {\n            ...ifDefined('code', code),\n            ...redacted,\n          },\n        });\n      }\n    },\n  };\n\nexport default postgresDriverDescriptor;\n"],"mappings":";;;;;;;AAUA,IAAa,wBAAb,MAAmF;CAIpD;CAH7B,WAAoB;CACpB,WAAoB;CAEpB,YAAY,QAAiC;EAAhB,KAAA,SAAA;CAAiB;CAE9C,MAAM,MACJ,KACA,QACmC;EACnC,IAAI;GAEF,OAAO,EAAE,OAAM,MADM,KAAK,OAAO,MAAM,KAAK,MAA+B,EAAA,CACrD,KAAc;EACtC,SAAS,OAAO;GACd,MAAM,iBAAiB,KAAK;EAC9B;CACF;CAEA,MAAM,QAAuB;EAC3B,MAAM,KAAK,OAAO,IAAI;CACxB;AACF;;;;AAKA,MAAM,2BACJ;CACE,GAAG;CACH,MAAM,OAAO,KAA6C;EACxD,MAAM,SAAS,IAAI,OAAO,EAAE,kBAAkB,IAAI,CAAC;EACnD,IAAI;GACF,MAAM,OAAO,QAAQ;GACrB,OAAO,IAAI,sBAAsB,MAAM;EACzC,SAAS,OAAO;GACd,MAAM,aAAa,iBAAiB,KAAK;GACzC,MAAM,WAAW,kBAAkB,GAAG;GACtC,IAAI;IACF,MAAM,OAAO,IAAI;GACnB,QAAQ,CAER;GAEA,MAAM,mBAAmB,cAAc,GAAG,UAAU,IAAI,WAAW,WAAW,KAAA;GAC9E,MAAM,YACJ,WAAW,cAAc,WAAW,QAC/B,WAAW,MAA6B,OACzC,KAAA;GACN,MAAM,OAAO,oBAAoB;GAEjC,MAAM,aAAa,8BAA8B;IAC/C,KAAK,WAAW;IAChB,KAAK;IACL,MAAM;KACJ,GAAG,UAAU,QAAQ,IAAI;KACzB,GAAG;IACL;GACF,CAAC;EACH;CACF;AACF"}

package/dist/{normalize-error-DHkbdIrm.mjs → normalize-error-DnabvDFD.mjs}

@@ -120,4 +120,4 @@ function normalizePgError(error) {
 //#endregion
 export { postgresDriverDescriptorMeta as i, isPostgresError as n, normalizePgError as r, isAlreadyConnectedError as t };
 
-//# sourceMappingURL=normalize-error-DHkbdIrm.mjs.map
+//# sourceMappingURL=normalize-error-DnabvDFD.mjs.map

package/dist/{normalize-error-DHkbdIrm.mjs.map → normalize-error-DnabvDFD.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"normalize-error-DHkbdIrm.mjs","names":[],"sources":["../src/core/descriptor-meta.ts","../src/normalize-error.ts"],"sourcesContent":["export const postgresDriverDescriptorMeta = {\n  kind: 'driver',\n  familyId: 'sql',\n  targetId: 'postgres',\n  id: 'postgres',\n  version: '0.0.1',\n  capabilities: {},\n} as const;\n","import { SqlConnectionError, SqlQueryError } from '@prisma-next/sql-errors';\n\n/**\n * Postgres error shape from the pg library.\n *\n * Note: The pg library doesn't export a DatabaseError type or interface, but errors\n * thrown by pg.query() and pg.Client have this shape at runtime. We define this\n * interface to match the actual runtime structure documented in the pg library\n * (https://github.com/brianc/node-postgres/blob/master/packages/pg/lib/errors.js).\n *\n * The @types/pg package also doesn't provide comprehensive error type definitions,\n * so we define our own interface based on the runtime error properties.\n */\ninterface PostgresError extends Error {\n  readonly code?: string;\n  readonly constraint?: string;\n  readonly table?: string;\n  readonly column?: string;\n  readonly detail?: string;\n  readonly hint?: string;\n  readonly position?: string;\n  readonly internalPosition?: string;\n  readonly internalQuery?: string;\n  readonly where?: string;\n  readonly schema?: string;\n  readonly file?: string;\n  readonly line?: string;\n  readonly routine?: string;\n}\n\n/**\n * Checks if an error is a connection-related error.\n */\nfunction isConnectionError(error: Error): boolean {\n  const code = (error as { code?: string }).code;\n  if (code) {\n    // Node.js error codes for connection issues\n    if (\n      code === 'ECONNRESET' ||\n      code === 'ETIMEDOUT' ||\n      code === 'ECONNREFUSED' ||\n      code === 'ENOTFOUND' ||\n      code === 'EHOSTUNREACH'\n    ) {\n      return true;\n    }\n  }\n\n  // Check error message for connection-related strings\n  const message = error.message.toLowerCase();\n  if (\n    message.includes('connection terminated') ||\n    message.includes('connection closed') ||\n    message.includes('connection refused') ||\n    message.includes('connection timeout') ||\n    message.includes('connection reset')\n  ) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Checks if a connection error is transient (might succeed on retry).\n */\nfunction isTransientConnectionError(error: Error): boolean {\n  const code = (error as { code?: string }).code;\n  if (code) {\n    // Timeouts and connection resets are often transient\n    if (code === 'ETIMEDOUT' || code === 'ECONNRESET') {\n      return true;\n    }\n    // Connection refused is usually not transient (server is down)\n    if (code === 'ECONNREFUSED') {\n      return false;\n    }\n  }\n\n  const message = error.message.toLowerCase();\n  if (message.includes('timeout') || message.includes('connection reset')) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * PostgreSQL-specific error properties that indicate an error originated from pg library.\n * These properties are not present on Node.js system errors.\n * Excludes generic properties like 'detail', 'file', 'line', and 'position' that could appear on any error.\n */\nconst PG_ERROR_PROPERTIES = [\n  'constraint',\n  'table',\n  'column',\n  'hint',\n  'internalPosition',\n  'internalQuery',\n  'where',\n  'schema',\n  'routine',\n] as const;\n\n/**\n * Type predicate to check if an error is a Postgres error from the pg library.\n *\n * Distinguishes pg library errors from Node.js system errors by checking for:\n * - SQLSTATE codes (5-character alphanumeric codes like '23505', '42601')\n * - pg-specific properties (constraint, table, column, hint, etc.) that Node.js errors don't have\n *\n * Node.js system errors (ECONNREFUSED, ETIMEDOUT, etc.) are excluded to prevent false positives.\n */\nexport function isPostgresError(error: unknown): error is PostgresError {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  const pgError = error as PostgresError;\n\n  // Check for SQLSTATE code (5-character alphanumeric) - primary indicator of pg errors\n  if (pgError.code && isPostgresSqlState(pgError.code)) {\n    return true;\n  }\n\n  // Check for pg-specific properties that Node.js system errors don't have\n  // These properties indicate the error originated from pg library query execution\n  return PG_ERROR_PROPERTIES.some((prop) => pgError[prop] !== undefined);\n}\n\n/**\n * Checks if an error is an \"already connected\" error from pg.Client.connect().\n * When calling connect() on an already-connected client, pg throws an error that can be safely ignored.\n */\nexport function isAlreadyConnectedError(error: unknown): error is Error {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  const message = error.message.toLowerCase();\n  return message.includes('already') && message.includes('connected');\n}\n\n/**\n * Checks if an error code is a Postgres SQLSTATE (5-character alphanumeric code).\n * SQLSTATE codes are standardized SQL error codes (e.g., '23505' for unique violation).\n */\nfunction isPostgresSqlState(code: string | undefined): boolean {\n  if (!code) {\n    return false;\n  }\n  // Postgres SQLSTATE codes are 5-character alphanumeric strings\n  // Examples: '23505' (unique violation), '42501' (insufficient privilege), '42601' (syntax error)\n  return /^[A-Z0-9]{5}$/.test(code);\n}\n\n/**\n * Normalizes a Postgres error into a SQL-shared error type.\n *\n * - Postgres SQLSTATE errors (5-char codes like '23505') → SqlQueryError\n * - Connection errors (ECONNRESET, ETIMEDOUT, etc.) → SqlConnectionError\n * - Unknown errors → returns the original error as-is\n *\n * The original error is preserved via Error.cause to maintain stack traces.\n *\n * @param error - The error to normalize (typically from pg library)\n * @returns SqlQueryError for query-related failures\n * @returns SqlConnectionError for connection-related failures\n * @returns The original error if it cannot be normalized\n */\nexport function normalizePgError(error: unknown): SqlQueryError | SqlConnectionError | Error {\n  if (!(error instanceof Error)) {\n    // Wrap non-Error values in an Error object\n    return new Error(String(error));\n  }\n\n  const pgError = error as PostgresError;\n\n  // Check for Postgres SQLSTATE (query errors)\n  if (isPostgresSqlState(pgError.code)) {\n    // isPostgresSqlState ensures code is defined and is a valid SQLSTATE\n    // biome-ignore lint/style/noNonNullAssertion: isPostgresSqlState guarantees code is defined\n    const sqlState = pgError.code!;\n    const options: {\n      cause: Error;\n      sqlState: string;\n      constraint?: string;\n      table?: string;\n      column?: string;\n      detail?: string;\n    } = {\n      cause: error,\n      sqlState,\n    };\n    if (pgError.constraint !== undefined) {\n      options.constraint = pgError.constraint;\n    }\n    if (pgError.table !== undefined) {\n      options.table = pgError.table;\n    }\n    if (pgError.column !== undefined) {\n      options.column = pgError.column;\n    }\n    if (pgError.detail !== undefined) {\n      options.detail = pgError.detail;\n    }\n    return new SqlQueryError(error.message, options);\n  }\n\n  // Check for connection errors\n  if (isConnectionError(error)) {\n    return new SqlConnectionError(error.message, {\n      cause: error,\n      transient: isTransientConnectionError(error),\n    });\n  }\n\n  // Unknown error - return as-is to preserve original error and stack trace\n  return error;\n}\n"],"mappings":";;AAAA,MAAa,+BAA+B;CAC1C,MAAM;CACN,UAAU;CACV,UAAU;CACV,IAAI;CACJ,SAAS;CACT,cAAc,CAAC;AACjB;;;;;;AC0BA,SAAS,kBAAkB,OAAuB;CAChD,MAAM,OAAQ,MAA4B;CAC1C,IAAI;MAGA,SAAS,gBACT,SAAS,eACT,SAAS,kBACT,SAAS,eACT,SAAS,gBAET,OAAO;CAAA;CAKX,MAAM,UAAU,MAAM,QAAQ,YAAY;CAC1C,IACE,QAAQ,SAAS,uBAAuB,KACxC,QAAQ,SAAS,mBAAmB,KACpC,QAAQ,SAAS,oBAAoB,KACrC,QAAQ,SAAS,oBAAoB,KACrC,QAAQ,SAAS,kBAAkB,GAEnC,OAAO;CAGT,OAAO;AACT;;;;AAKA,SAAS,2BAA2B,OAAuB;CACzD,MAAM,OAAQ,MAA4B;CAC1C,IAAI,MAAM;EAER,IAAI,SAAS,eAAe,SAAS,cACnC,OAAO;EAGT,IAAI,SAAS,gBACX,OAAO;CAEX;CAEA,MAAM,UAAU,MAAM,QAAQ,YAAY;CAC1C,IAAI,QAAQ,SAAS,SAAS,KAAK,QAAQ,SAAS,kBAAkB,GACpE,OAAO;CAGT,OAAO;AACT;;;;;;AAOA,MAAM,sBAAsB;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;;;AAWA,SAAgB,gBAAgB,OAAwC;CACtE,IAAI,EAAE,iBAAiB,QACrB,OAAO;CAGT,MAAM,UAAU;CAGhB,IAAI,QAAQ,QAAQ,mBAAmB,QAAQ,IAAI,GACjD,OAAO;CAKT,OAAO,oBAAoB,MAAM,SAAS,QAAQ,UAAU,KAAA,CAAS;AACvE;;;;;AAMA,SAAgB,wBAAwB,OAAgC;CACtE,IAAI,EAAE,iBAAiB,QACrB,OAAO;CAET,MAAM,UAAU,MAAM,QAAQ,YAAY;CAC1C,OAAO,QAAQ,SAAS,SAAS,KAAK,QAAQ,SAAS,WAAW;AACpE;;;;;AAMA,SAAS,mBAAmB,MAAmC;CAC7D,IAAI,CAAC,MACH,OAAO;CAIT,OAAO,gBAAgB,KAAK,IAAI;AAClC;;;;;;;;;;;;;;;AAgBA,SAAgB,iBAAiB,OAA4D;CAC3F,IAAI,EAAE,iBAAiB,QAErB,OAAO,IAAI,MAAM,OAAO,KAAK,CAAC;CAGhC,MAAM,UAAU;CAGhB,IAAI,mBAAmB,QAAQ,IAAI,GAAG;EAIpC,MAAM,UAOF;GACF,OAAO;GACP,UAVe,QAAQ;EAWzB;EACA,IAAI,QAAQ,eAAe,KAAA,GACzB,QAAQ,aAAa,QAAQ;EAE/B,IAAI,QAAQ,UAAU,KAAA,GACpB,QAAQ,QAAQ,QAAQ;EAE1B,IAAI,QAAQ,WAAW,KAAA,GACrB,QAAQ,SAAS,QAAQ;EAE3B,IAAI,QAAQ,WAAW,KAAA,GACrB,QAAQ,SAAS,QAAQ;EAE3B,OAAO,IAAI,cAAc,MAAM,SAAS,OAAO;CACjD;CAGA,IAAI,kBAAkB,KAAK,GACzB,OAAO,IAAI,mBAAmB,MAAM,SAAS;EAC3C,OAAO;EACP,WAAW,2BAA2B,KAAK;CAC7C,CAAC;CAIH,OAAO;AACT"}
+{"version":3,"file":"normalize-error-DnabvDFD.mjs","names":[],"sources":["../src/core/descriptor-meta.ts","../src/normalize-error.ts"],"sourcesContent":["export const postgresDriverDescriptorMeta = {\n  kind: 'driver',\n  familyId: 'sql',\n  targetId: 'postgres',\n  id: 'postgres',\n  version: '0.0.1',\n  capabilities: {},\n} as const;\n","import { SqlConnectionError, SqlQueryError } from '@prisma-next/sql-errors';\n\n/**\n * Postgres error shape from the pg library.\n *\n * Note: The pg library doesn't export a DatabaseError type or interface, but errors\n * thrown by pg.query() and pg.Client have this shape at runtime. We define this\n * interface to match the actual runtime structure documented in the pg library\n * (https://github.com/brianc/node-postgres/blob/master/packages/pg/lib/errors.js).\n *\n * The @types/pg package also doesn't provide comprehensive error type definitions,\n * so we define our own interface based on the runtime error properties.\n */\ninterface PostgresError extends Error {\n  readonly code?: string;\n  readonly constraint?: string;\n  readonly table?: string;\n  readonly column?: string;\n  readonly detail?: string;\n  readonly hint?: string;\n  readonly position?: string;\n  readonly internalPosition?: string;\n  readonly internalQuery?: string;\n  readonly where?: string;\n  readonly schema?: string;\n  readonly file?: string;\n  readonly line?: string;\n  readonly routine?: string;\n}\n\n/**\n * Checks if an error is a connection-related error.\n */\nfunction isConnectionError(error: Error): boolean {\n  const code = (error as { code?: string }).code;\n  if (code) {\n    // Node.js error codes for connection issues\n    if (\n      code === 'ECONNRESET' ||\n      code === 'ETIMEDOUT' ||\n      code === 'ECONNREFUSED' ||\n      code === 'ENOTFOUND' ||\n      code === 'EHOSTUNREACH'\n    ) {\n      return true;\n    }\n  }\n\n  // Check error message for connection-related strings\n  const message = error.message.toLowerCase();\n  if (\n    message.includes('connection terminated') ||\n    message.includes('connection closed') ||\n    message.includes('connection refused') ||\n    message.includes('connection timeout') ||\n    message.includes('connection reset')\n  ) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Checks if a connection error is transient (might succeed on retry).\n */\nfunction isTransientConnectionError(error: Error): boolean {\n  const code = (error as { code?: string }).code;\n  if (code) {\n    // Timeouts and connection resets are often transient\n    if (code === 'ETIMEDOUT' || code === 'ECONNRESET') {\n      return true;\n    }\n    // Connection refused is usually not transient (server is down)\n    if (code === 'ECONNREFUSED') {\n      return false;\n    }\n  }\n\n  const message = error.message.toLowerCase();\n  if (message.includes('timeout') || message.includes('connection reset')) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * PostgreSQL-specific error properties that indicate an error originated from pg library.\n * These properties are not present on Node.js system errors.\n * Excludes generic properties like 'detail', 'file', 'line', and 'position' that could appear on any error.\n */\nconst PG_ERROR_PROPERTIES = [\n  'constraint',\n  'table',\n  'column',\n  'hint',\n  'internalPosition',\n  'internalQuery',\n  'where',\n  'schema',\n  'routine',\n] as const;\n\n/**\n * Type predicate to check if an error is a Postgres error from the pg library.\n *\n * Distinguishes pg library errors from Node.js system errors by checking for:\n * - SQLSTATE codes (5-character alphanumeric codes like '23505', '42601')\n * - pg-specific properties (constraint, table, column, hint, etc.) that Node.js errors don't have\n *\n * Node.js system errors (ECONNREFUSED, ETIMEDOUT, etc.) are excluded to prevent false positives.\n */\nexport function isPostgresError(error: unknown): error is PostgresError {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  const pgError = error as PostgresError;\n\n  // Check for SQLSTATE code (5-character alphanumeric) - primary indicator of pg errors\n  if (pgError.code && isPostgresSqlState(pgError.code)) {\n    return true;\n  }\n\n  // Check for pg-specific properties that Node.js system errors don't have\n  // These properties indicate the error originated from pg library query execution\n  return PG_ERROR_PROPERTIES.some((prop) => pgError[prop] !== undefined);\n}\n\n/**\n * Checks if an error is an \"already connected\" error from pg.Client.connect().\n * When calling connect() on an already-connected client, pg throws an error that can be safely ignored.\n */\nexport function isAlreadyConnectedError(error: unknown): error is Error {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  const message = error.message.toLowerCase();\n  return message.includes('already') && message.includes('connected');\n}\n\n/**\n * Checks if an error code is a Postgres SQLSTATE (5-character alphanumeric code).\n * SQLSTATE codes are standardized SQL error codes (e.g., '23505' for unique violation).\n */\nfunction isPostgresSqlState(code: string | undefined): boolean {\n  if (!code) {\n    return false;\n  }\n  // Postgres SQLSTATE codes are 5-character alphanumeric strings\n  // Examples: '23505' (unique violation), '42501' (insufficient privilege), '42601' (syntax error)\n  return /^[A-Z0-9]{5}$/.test(code);\n}\n\n/**\n * Normalizes a Postgres error into a SQL-shared error type.\n *\n * - Postgres SQLSTATE errors (5-char codes like '23505') → SqlQueryError\n * - Connection errors (ECONNRESET, ETIMEDOUT, etc.) → SqlConnectionError\n * - Unknown errors → returns the original error as-is\n *\n * The original error is preserved via Error.cause to maintain stack traces.\n *\n * @param error - The error to normalize (typically from pg library)\n * @returns SqlQueryError for query-related failures\n * @returns SqlConnectionError for connection-related failures\n * @returns The original error if it cannot be normalized\n */\nexport function normalizePgError(error: unknown): SqlQueryError | SqlConnectionError | Error {\n  if (!(error instanceof Error)) {\n    // Wrap non-Error values in an Error object\n    return new Error(String(error));\n  }\n\n  const pgError = error as PostgresError;\n\n  // Check for Postgres SQLSTATE (query errors)\n  if (isPostgresSqlState(pgError.code)) {\n    // isPostgresSqlState ensures code is defined and is a valid SQLSTATE\n    // biome-ignore lint/style/noNonNullAssertion: isPostgresSqlState guarantees code is defined\n    const sqlState = pgError.code!;\n    const options: {\n      cause: Error;\n      sqlState: string;\n      constraint?: string;\n      table?: string;\n      column?: string;\n      detail?: string;\n    } = {\n      cause: error,\n      sqlState,\n    };\n    if (pgError.constraint !== undefined) {\n      options.constraint = pgError.constraint;\n    }\n    if (pgError.table !== undefined) {\n      options.table = pgError.table;\n    }\n    if (pgError.column !== undefined) {\n      options.column = pgError.column;\n    }\n    if (pgError.detail !== undefined) {\n      options.detail = pgError.detail;\n    }\n    return new SqlQueryError(error.message, options);\n  }\n\n  // Check for connection errors\n  if (isConnectionError(error)) {\n    return new SqlConnectionError(error.message, {\n      cause: error,\n      transient: isTransientConnectionError(error),\n    });\n  }\n\n  // Unknown error - return as-is to preserve original error and stack trace\n  return error;\n}\n"],"mappings":";;AAAA,MAAa,+BAA+B;CAC1C,MAAM;CACN,UAAU;CACV,UAAU;CACV,IAAI;CACJ,SAAS;CACT,cAAc,CAAC;AACjB;;;;;;AC0BA,SAAS,kBAAkB,OAAuB;CAChD,MAAM,OAAQ,MAA4B;CAC1C,IAAI;MAGA,SAAS,gBACT,SAAS,eACT,SAAS,kBACT,SAAS,eACT,SAAS,gBAET,OAAO;CAAA;CAKX,MAAM,UAAU,MAAM,QAAQ,YAAY;CAC1C,IACE,QAAQ,SAAS,uBAAuB,KACxC,QAAQ,SAAS,mBAAmB,KACpC,QAAQ,SAAS,oBAAoB,KACrC,QAAQ,SAAS,oBAAoB,KACrC,QAAQ,SAAS,kBAAkB,GAEnC,OAAO;CAGT,OAAO;AACT;;;;AAKA,SAAS,2BAA2B,OAAuB;CACzD,MAAM,OAAQ,MAA4B;CAC1C,IAAI,MAAM;EAER,IAAI,SAAS,eAAe,SAAS,cACnC,OAAO;EAGT,IAAI,SAAS,gBACX,OAAO;CAEX;CAEA,MAAM,UAAU,MAAM,QAAQ,YAAY;CAC1C,IAAI,QAAQ,SAAS,SAAS,KAAK,QAAQ,SAAS,kBAAkB,GACpE,OAAO;CAGT,OAAO;AACT;;;;;;AAOA,MAAM,sBAAsB;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;;;AAWA,SAAgB,gBAAgB,OAAwC;CACtE,IAAI,EAAE,iBAAiB,QACrB,OAAO;CAGT,MAAM,UAAU;CAGhB,IAAI,QAAQ,QAAQ,mBAAmB,QAAQ,IAAI,GACjD,OAAO;CAKT,OAAO,oBAAoB,MAAM,SAAS,QAAQ,UAAU,KAAA,CAAS;AACvE;;;;;AAMA,SAAgB,wBAAwB,OAAgC;CACtE,IAAI,EAAE,iBAAiB,QACrB,OAAO;CAET,MAAM,UAAU,MAAM,QAAQ,YAAY;CAC1C,OAAO,QAAQ,SAAS,SAAS,KAAK,QAAQ,SAAS,WAAW;AACpE;;;;;AAMA,SAAS,mBAAmB,MAAmC;CAC7D,IAAI,CAAC,MACH,OAAO;CAIT,OAAO,gBAAgB,KAAK,IAAI;AAClC;;;;;;;;;;;;;;;AAgBA,SAAgB,iBAAiB,OAA4D;CAC3F,IAAI,EAAE,iBAAiB,QAErB,OAAO,IAAI,MAAM,OAAO,KAAK,CAAC;CAGhC,MAAM,UAAU;CAGhB,IAAI,mBAAmB,QAAQ,IAAI,GAAG;EAIpC,MAAM,UAOF;GACF,OAAO;GACP,UAVe,QAAQ;EAWzB;EACA,IAAI,QAAQ,eAAe,KAAA,GACzB,QAAQ,aAAa,QAAQ;EAE/B,IAAI,QAAQ,UAAU,KAAA,GACpB,QAAQ,QAAQ,QAAQ;EAE1B,IAAI,QAAQ,WAAW,KAAA,GACrB,QAAQ,SAAS,QAAQ;EAE3B,IAAI,QAAQ,WAAW,KAAA,GACrB,QAAQ,SAAS,QAAQ;EAE3B,OAAO,IAAI,cAAc,MAAM,SAAS,OAAO;CACjD;CAGA,IAAI,kBAAkB,KAAK,GACzB,OAAO,IAAI,mBAAmB,MAAM,SAAS;EAC3C,OAAO;EACP,WAAW,2BAA2B,KAAK;CAC7C,CAAC;CAIH,OAAO;AACT"}

package/dist/runtime.mjs

@@ -1,4 +1,4 @@
-import { i as postgresDriverDescriptorMeta, n as isPostgresError, r as normalizePgError, t as isAlreadyConnectedError } from "./normalize-error-DHkbdIrm.mjs";
+import { i as postgresDriverDescriptorMeta, n as isPostgresError, r as normalizePgError, t as isAlreadyConnectedError } from "./normalize-error-DnabvDFD.mjs";
 import { Pool } from "pg";
 import Cursor from "pg-cursor";
 //#region src/callback-to-promise.ts

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":["#queue","#connection","#onRelease","#onDestroy","#closed","#connectionMutex","#closeWhileHoldingLease","#connected","#connectPromise","#cursorOpts","#preparedStatements","#delegate","#closed","#requireDelegate","#wrapConnection"],"sources":["../src/callback-to-promise.ts","../src/named-cursor.ts","../src/postgres-driver.ts","../src/exports/runtime.ts"],"sourcesContent":["/**\n * Wraps a Node-style callback function into a Promise.\n * Supports both (err) => void and (err, result) => void patterns.\n */\nexport function callbackToPromise(\n  fn: (callback: (err: Error | null | undefined) => void) => void,\n): Promise<void>;\nexport function callbackToPromise<T>(\n  fn: (callback: (err: Error | null | undefined, result: T) => void) => void,\n): Promise<T>;\nexport function callbackToPromise<T = void>(\n  fn: (callback: (err: Error | null | undefined, result?: T) => void) => void,\n): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    fn((err, result) => {\n      if (err) {\n        reject(err);\n        return;\n      }\n      resolve(result as T);\n    });\n  });\n}\n","import type { BindConfig, Connection, QueryParse } from 'pg';\nimport Cursor from 'pg-cursor';\n\nlet nextNamedPortalId = 1;\n\nexport interface NamedCursorOptions<Row> {\n  readonly name: string;\n  readonly text: string;\n  readonly values: readonly unknown[];\n  readonly config?: ConstructorParameters<typeof Cursor<Row>>[2];\n}\n\n// `parsedStatements` is set on the Connection by pg.Client, not by Connection\n// itself, so it isn't declared on @types/pg's `Connection`.\ntype ConnectionWithStatementCache = Connection & {\n  readonly parsedStatements: Record<string, string>;\n};\n\n// pg-cursor's runtime instance shape. @types/pg-cursor only declares the\n// constructor + submit/read/close, so the fields pg-cursor sets on `this` and\n// its handlers consume have to be re-declared here.\ninterface CursorInstanceFields {\n  state: 'initialized' | 'submitted' | 'idle' | 'busy' | 'done' | 'error';\n  connection: Connection | null;\n  text: string;\n  values: ReadonlyArray<unknown> | null;\n  _portal: string;\n  _conf: { types?: { getTypeParser: (oid: number, format?: string) => unknown } };\n  _result: { _getTypeParser?: unknown };\n  _ifNoData: () => void;\n  _rowDescription: () => void;\n}\n\n/** Streaming cursor for a server-side named prepared statement. */\nexport class NamedCursor<Row = Record<string, unknown>> extends Cursor<Row> {\n  readonly name: string;\n\n  constructor(opts: NamedCursorOptions<Row>) {\n    super(opts.text, [...opts.values], opts.config);\n    this.name = opts.name;\n    // Cursor declares `submit` as a property, not a class method, so\n    // `override submit() {}` at the class level conflicts. Replace the\n    // field on this instance instead.\n    this.submit = this.submitNamed;\n  }\n\n  private submitNamed(connection: Connection): void {\n    const self = this as unknown as CursorInstanceFields;\n    const conn = connection as ConnectionWithStatementCache;\n\n    self.state = 'submitted';\n    self.connection = conn;\n    self._portal = `np_${nextNamedPortalId++}`;\n\n    if (!conn.parsedStatements[this.name]) {\n      // QueryParse types `types` as required; pg's runtime accepts an empty\n      // array (server infers parameter types).\n      const parseMessage: QueryParse = { text: self.text, name: this.name, types: [] };\n      conn.parse(parseMessage, true);\n    }\n\n    // pg-cursor's constructor pre-maps values via prepareValue, so the array\n    // here is already wire-ready; the cast bridges pg-cursor's loose `any[]`\n    // to BindConfig's stricter union.\n    const bindMessage: BindConfig = {\n      portal: self._portal,\n      statement: this.name,\n      values: (self.values ?? []) as BindConfig['values'],\n    };\n    conn.bind(bindMessage, true);\n\n    conn.describe({ type: 'P', name: self._portal }, true);\n    conn.flush();\n\n    if (self._conf.types) {\n      self._result._getTypeParser = self._conf.types.getTypeParser;\n    }\n\n    conn.once('noData', self._ifNoData);\n    conn.once('rowDescription', self._rowDescription);\n  }\n}\n","import type {\n  PreparedExecuteRequest,\n  SqlConnection,\n  SqlDriver,\n  SqlDriverState,\n  SqlExecuteRequest,\n  SqlExplainResult,\n  SqlQueryable,\n  SqlQueryResult,\n  SqlTransaction,\n} from '@prisma-next/sql-relational-core/ast';\nimport type {\n  Client,\n  QueryResult as PgQueryResult,\n  PoolClient,\n  Pool as PoolType,\n  QueryConfig,\n  QueryResultRow,\n} from 'pg';\nimport { Pool } from 'pg';\nimport Cursor from 'pg-cursor';\nimport { callbackToPromise } from './callback-to-promise';\nimport { NamedCursor } from './named-cursor';\nimport { isAlreadyConnectedError, isPostgresError, normalizePgError } from './normalize-error';\n\nexport type QueryResult<T extends QueryResultRow = QueryResultRow> = PgQueryResult<T>;\n\nexport type PostgresBinding =\n  | { readonly kind: 'url'; readonly url: string }\n  | { readonly kind: 'pgPool'; readonly pool: PoolType }\n  | { readonly kind: 'pgClient'; readonly client: Client };\n\nexport interface PostgresCursorOptions {\n  readonly batchSize?: number;\n  readonly disabled?: boolean;\n}\n\ninterface PostgresDriverOptions {\n  readonly connect: { client: Client } | { pool: PoolType };\n  readonly cursor?: PostgresCursorOptions | undefined;\n  /**\n   * Use server-side prepared statements for `executePrepared`. Default\n   * `true`. Set `false` when running behind a transaction-mode pooler that\n   * does not support session-scoped prepared statements (e.g. PgBouncer\n   * transaction mode).\n   */\n  readonly preparedStatements?: boolean | undefined;\n}\n\nexport type PostgresDriverCreateOptions = Omit<PostgresDriverOptions, 'connect'>;\n\nconst DEFAULT_BATCH_SIZE = 100;\nconst DEFAULT_PREPARED_STATEMENTS = true;\n\ntype CursorOptions =\n  | { readonly cursorDisabled: true }\n  | { readonly cursorBatchSize: number; readonly cursorDisabled: false };\n\ninterface HandleAllocator {\n  mint(): string;\n}\n\nfunction createHandleAllocator(): HandleAllocator {\n  // Driver-scoped so a single PreparedStatement reused across multiple\n  // Connections/Transactions of the same driver always sees one handle.\n  let next = 1;\n  return {\n    mint: () => `pn_${next++}`,\n  };\n}\n\ntype ConnectionOptions = CursorOptions & {\n  readonly preparedStatementsEnabled: boolean;\n  readonly handleAllocator: HandleAllocator;\n};\n\nfunction buildConnectionOptions(options: PostgresDriverOptions): ConnectionOptions {\n  const cursorOptions: CursorOptions = options.cursor?.disabled\n    ? { cursorDisabled: true }\n    : {\n        cursorBatchSize: options.cursor?.batchSize ?? DEFAULT_BATCH_SIZE,\n        cursorDisabled: false,\n      };\n  return {\n    ...cursorOptions,\n    preparedStatementsEnabled: options.preparedStatements ?? DEFAULT_PREPARED_STATEMENTS,\n    handleAllocator: createHandleAllocator(),\n  };\n}\n\nfunction isStalePreparedStatementError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  const code = (error as { code?: string }).code;\n  // 26000 — invalid_sql_statement_name (server lost the named statement,\n  //         e.g. after DEALLOCATE ALL).\n  // 0A000 — cached plan invalidated by DDL (row shape changed).\n  return code === '26000' || code === '0A000';\n}\n\nclass AsyncMutex {\n  #queue = Promise.resolve();\n\n  async lock(): Promise<() => void> {\n    const previous = this.#queue;\n    let releaseLock: (() => void) | undefined;\n    this.#queue = new Promise<void>((resolve) => {\n      releaseLock = resolve;\n    });\n    await previous;\n    return () => {\n      releaseLock?.();\n      releaseLock = undefined;\n    };\n  }\n}\n\nabstract class PostgresQueryable<C extends PoolClient | Client = PoolClient | Client>\n  implements SqlQueryable\n{\n  abstract acquireClient(): Promise<C>;\n  abstract releaseClient(client: C): Promise<void>;\n\n  protected readonly options: ConnectionOptions;\n\n  constructor(options: ConnectionOptions) {\n    this.options = options;\n  }\n\n  async *execute<Row = Record<string, unknown>>(request: SqlExecuteRequest): AsyncIterable<Row> {\n    try {\n      yield* this.runQuery<Row>(request);\n    } catch (error) {\n      throw normalizePgError(error);\n    }\n  }\n\n  async *executePrepared<Row = Record<string, unknown>>(\n    request: PreparedExecuteRequest,\n  ): AsyncIterable<Row> {\n    if (!this.options.preparedStatementsEnabled) {\n      // Skip server-side prepare entirely; route as a regular ad-hoc execute.\n      yield* this.execute<Row>(request);\n      return;\n    }\n\n    let handle = request.handle.get();\n    if (handle === undefined) {\n      handle = this.options.handleAllocator.mint();\n      request.handle.set(handle);\n    }\n\n    yield* this.withStaleHandleRetry<Row>(request, handle as string, (h) =>\n      this.runQuery<Row>(request, h),\n    );\n  }\n\n  private async *withStaleHandleRetry<Row>(\n    request: PreparedExecuteRequest,\n    handle: string,\n    attempt: (handle: string) => AsyncIterable<Row>,\n  ): AsyncIterable<Row> {\n    let yielded = false;\n    try {\n      for await (const row of attempt(handle)) {\n        yielded = true;\n        yield row;\n      }\n      return;\n    } catch (error) {\n      // If a row was already yielded, the error came from mid-stream and a\n      // retry would re-yield prior rows to the consumer.\n      if (yielded || !isStalePreparedStatementError(error)) {\n        throw normalizePgError(error);\n      }\n      // pg's parsedStatements still records the old name; only a fresh name\n      // forces pg to re-Parse on this Client.\n      const retryHandle = this.options.handleAllocator.mint();\n      request.handle.set(retryHandle);\n      try {\n        yield* attempt(retryHandle);\n      } catch (retryError) {\n        throw normalizePgError(retryError);\n      }\n    }\n  }\n\n  // Errors propagate as raw pg errors so the caller can read SQLSTATE before\n  // normalising (the prepared-statement retry layer needs the original code).\n  private async *runQuery<Row>(request: SqlExecuteRequest, name?: string): AsyncIterable<Row> {\n    const client = await this.acquireClient();\n    try {\n      if (!this.options.cursorDisabled) {\n        try {\n          for await (const row of this.executeWithCursor(\n            client,\n            request.sql,\n            request.params,\n            this.options.cursorBatchSize,\n            name,\n          )) {\n            yield row as Row;\n          }\n          return;\n        } catch (cursorError) {\n          // Non-pg cursor-specific errors fall through to the buffered path;\n          // real pg errors propagate.\n          if (!(cursorError instanceof Error) || isPostgresError(cursorError)) {\n            throw cursorError;\n          }\n        }\n      }\n\n      for await (const row of this.executeBuffered(client, request.sql, request.params, name)) {\n        yield row as Row;\n      }\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  async explain(request: SqlExecuteRequest): Promise<SqlExplainResult> {\n    // SQL is generated by Prisma Next planners (or validated raw paths), so\n    // EXPLAIN prefixing preserves the same statement semantics.\n    const text = `EXPLAIN (FORMAT JSON) ${request.sql}`;\n    const client = await this.acquireClient();\n    try {\n      const result = await client\n        .query(text, request.params as unknown[] | undefined)\n        .catch(rethrowNormalizedError);\n      return { rows: result.rows as ReadonlyArray<Record<string, unknown>> };\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  async query<Row = Record<string, unknown>>(\n    sql: string,\n    params?: readonly unknown[],\n  ): Promise<SqlQueryResult<Row>> {\n    const client = await this.acquireClient();\n    try {\n      const result = await client\n        .query(sql, params as unknown[] | undefined)\n        .catch(rethrowNormalizedError);\n      return result as unknown as SqlQueryResult<Row>;\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  private async *executeWithCursor(\n    client: PoolClient | Client,\n    sql: string,\n    params: readonly unknown[] | undefined,\n    cursorBatchSize: number,\n    name?: string,\n  ): AsyncIterable<Record<string, unknown>> {\n    const values = (params ?? []) as unknown[];\n    const cursor = client.query(\n      name === undefined ? new Cursor(sql, values) : new NamedCursor({ name, text: sql, values }),\n    );\n\n    try {\n      while (true) {\n        const rows = await readCursor(cursor, cursorBatchSize);\n        if (rows.length === 0) {\n          break;\n        }\n\n        for (const row of rows) {\n          yield row;\n        }\n      }\n    } finally {\n      await closeCursor(cursor);\n    }\n  }\n\n  private async *executeBuffered(\n    client: PoolClient | Client,\n    sql: string,\n    params: readonly unknown[] | undefined,\n    name?: string,\n  ): AsyncIterable<Record<string, unknown>> {\n    const config: QueryConfig = { name, text: sql, values: (params ?? []) as unknown[] };\n    const result = await client.query(config);\n    for (const row of result.rows as Record<string, unknown>[]) {\n      yield row;\n    }\n  }\n}\n\nclass PostgresConnectionImpl extends PostgresQueryable implements SqlConnection {\n  #connection: PoolClient | Client;\n  #onRelease: (() => void) | undefined;\n  #onDestroy: ((reason: unknown) => Promise<void> | void) | undefined;\n\n  constructor(\n    connection: PoolClient | Client,\n    options: ConnectionOptions,\n    onRelease?: () => void,\n    onDestroy?: (reason: unknown) => Promise<void> | void,\n  ) {\n    super(options);\n    this.#connection = connection;\n    this.#onRelease = onRelease;\n    this.#onDestroy = onDestroy;\n  }\n\n  override acquireClient(): Promise<PoolClient | Client> {\n    return Promise.resolve(this.#connection);\n  }\n\n  override releaseClient(_client: PoolClient | Client): Promise<void> {\n    return Promise.resolve();\n  }\n\n  async beginTransaction(): Promise<SqlTransaction> {\n    await this.#connection.query('BEGIN').catch(rethrowNormalizedError);\n    return new PostgresTransactionImpl(this.#connection, this.options);\n  }\n\n  async release(): Promise<void> {\n    const conn = this.#connection;\n    if ('release' in conn) {\n      conn.release();\n    }\n    const onRelease = this.#onRelease;\n    this.#onRelease = undefined;\n    this.#onDestroy = undefined;\n    onRelease?.();\n  }\n\n  async destroy(reason?: unknown): Promise<void> {\n    const onDestroy = this.#onDestroy;\n    const onRelease = this.#onRelease;\n    this.#onDestroy = undefined;\n    this.#onRelease = undefined;\n\n    const conn = this.#connection;\n    if ('release' in conn) {\n      // Pass a truthy Error to pg's PoolClient.release so the pool evicts the\n      // client instead of returning it for reuse. A connection that reaches\n      // destroy() is in an indeterminate state (failed rollback/commit, etc.)\n      // and must not be handed back to another caller. The Error value is\n      // surfaced on pg-pool's 'release' event as advisory context; pg-pool\n      // itself only uses its truthiness for the eviction decision.\n      const releaseArg: Error =\n        reason instanceof Error ? reason : new Error('Connection destroyed');\n      conn.release(releaseArg);\n    }\n\n    if (onDestroy) {\n      await onDestroy(reason);\n    } else {\n      onRelease?.();\n    }\n  }\n}\n\nclass PostgresTransactionImpl extends PostgresQueryable implements SqlTransaction {\n  #connection: PoolClient | Client;\n\n  constructor(connection: PoolClient | Client, options: ConnectionOptions) {\n    super(options);\n    this.#connection = connection;\n  }\n\n  override acquireClient(): Promise<PoolClient | Client> {\n    return Promise.resolve(this.#connection);\n  }\n\n  override releaseClient(_client: PoolClient | Client): Promise<void> {\n    return Promise.resolve();\n  }\n\n  async commit(): Promise<void> {\n    await this.#connection.query('COMMIT').catch(rethrowNormalizedError);\n  }\n\n  async rollback(): Promise<void> {\n    await this.#connection.query('ROLLBACK').catch(rethrowNormalizedError);\n  }\n}\n\nclass PostgresPoolDriverImpl\n  extends PostgresQueryable<PoolClient>\n  implements SqlDriver<PostgresBinding>\n{\n  private readonly pool: PoolType;\n  #closed = false;\n\n  constructor(options: PostgresDriverOptions & { connect: { pool: PoolType } }) {\n    super(buildConnectionOptions(options));\n    this.pool = options.connect.pool;\n  }\n\n  get state(): SqlDriverState {\n    return this.#closed ? 'closed' : 'connected';\n  }\n\n  // Bound drivers are created via createBoundDriverFromBinding with pool already\n  // configured; connect is intentionally no-op.\n  async connect(_binding: PostgresBinding): Promise<void> {}\n\n  async acquireConnection(): Promise<SqlConnection> {\n    const client = await this.acquireClient();\n    return new PostgresConnectionImpl(client, this.options);\n  }\n\n  async close(): Promise<void> {\n    if (this.#closed) {\n      return;\n    }\n    this.#closed = true;\n    await this.pool.end();\n  }\n\n  async acquireClient(): Promise<PoolClient> {\n    return this.pool.connect();\n  }\n\n  async releaseClient(client: PoolClient): Promise<void> {\n    client.release();\n  }\n}\n\nclass PostgresDirectDriverImpl\n  extends PostgresQueryable<Client>\n  implements SqlDriver<PostgresBinding>\n{\n  private readonly directClient: Client;\n  readonly #connectionMutex = new AsyncMutex();\n  #closed = false;\n  #connected = false;\n  #connectPromise: Promise<void> | undefined;\n\n  constructor(options: PostgresDriverOptions & { connect: { client: Client } }) {\n    super(buildConnectionOptions(options));\n    this.directClient = options.connect.client;\n  }\n\n  get state(): SqlDriverState {\n    return this.#closed ? 'closed' : 'connected';\n  }\n\n  // Bound drivers are created via createBoundDriverFromBinding with client already\n  // configured; connect is intentionally no-op.\n  async connect(_binding: PostgresBinding): Promise<void> {}\n\n  async acquireConnection(): Promise<SqlConnection> {\n    const releaseLease = await this.#connectionMutex.lock();\n    try {\n      const client = await this.acquireClient();\n      return new PostgresConnectionImpl(\n        client,\n        this.options,\n        releaseLease,\n        // A direct driver has a single underlying socket, so a destroyed\n        // connection means the driver itself is no longer usable. Tear down\n        // the driver while still holding the lease so that any\n        // acquireConnection() queued on #connectionMutex only observes the\n        // driver after .end() has completed and #closed is set — preventing\n        // a concurrent caller from reusing a socket that is already being\n        // closed. The lease is released in a finally so a failing .end()\n        // cannot leave the mutex permanently held.\n        async () => {\n          try {\n            await this.#closeWhileHoldingLease();\n          } finally {\n            releaseLease();\n          }\n        },\n      );\n    } catch (error) {\n      releaseLease();\n      throw error;\n    }\n  }\n\n  async close(): Promise<void> {\n    const releaseLease = await this.#connectionMutex.lock();\n    try {\n      await this.#closeWhileHoldingLease();\n    } finally {\n      releaseLease();\n    }\n  }\n\n  async #closeWhileHoldingLease(): Promise<void> {\n    if (this.#closed) {\n      return;\n    }\n    this.#closed = true;\n    await this.directClient.end();\n    this.#connected = false;\n  }\n\n  async acquireClient(): Promise<Client> {\n    if (this.#connected) {\n      return this.directClient;\n    }\n    if (this.#connectPromise !== undefined) {\n      await this.#connectPromise;\n      return this.directClient;\n    }\n\n    this.#connectPromise = (async () => {\n      try {\n        await this.directClient.connect();\n      } catch (error: unknown) {\n        if (!isAlreadyConnectedError(error)) {\n          throw error;\n        }\n      } finally {\n        this.#connectPromise = undefined;\n      }\n      this.#connected = true;\n    })();\n    await this.#connectPromise;\n\n    return this.directClient;\n  }\n\n  async releaseClient(_client: Client): Promise<void> {}\n}\n\nexport function createBoundDriverFromBinding(\n  binding: PostgresBinding,\n  cursorOpts: PostgresDriverCreateOptions['cursor'],\n  extraOpts?: Pick<PostgresDriverCreateOptions, 'preparedStatements'>,\n): SqlDriver<PostgresBinding> {\n  const preparedStatements = extraOpts?.preparedStatements;\n  switch (binding.kind) {\n    case 'url': {\n      const pool = new Pool({\n        connectionString: binding.url,\n        connectionTimeoutMillis: 20_000,\n        idleTimeoutMillis: 30_000,\n      });\n      return new PostgresPoolDriverImpl({\n        connect: { pool },\n        cursor: cursorOpts,\n        preparedStatements,\n      });\n    }\n    case 'pgPool':\n      return new PostgresPoolDriverImpl({\n        connect: { pool: binding.pool },\n        cursor: cursorOpts,\n        preparedStatements,\n      });\n    case 'pgClient':\n      return new PostgresDirectDriverImpl({\n        connect: { client: binding.client },\n        cursor: cursorOpts,\n        preparedStatements,\n      });\n  }\n}\n\nfunction readCursor<Row>(cursor: Cursor<Row>, size: number): Promise<Row[]> {\n  return callbackToPromise<Row[]>((cb) => {\n    cursor.read(size, (err, rows) => cb(err, rows));\n  });\n}\n\nfunction closeCursor(cursor: Cursor<unknown>): Promise<void> {\n  return callbackToPromise((cb) => cursor.close(cb));\n}\n\nfunction rethrowNormalizedError(error: unknown): never {\n  throw normalizePgError(error);\n}\n","import type {\n  RuntimeDriverDescriptor,\n  RuntimeDriverInstance,\n} from '@prisma-next/framework-components/execution';\nimport type {\n  PreparedExecuteRequest,\n  SqlConnection,\n  SqlDriver,\n  SqlExecuteRequest,\n  SqlExplainResult,\n  SqlQueryResult,\n} from '@prisma-next/sql-relational-core/ast';\nimport { postgresDriverDescriptorMeta } from '../core/descriptor-meta';\nimport {\n  createBoundDriverFromBinding,\n  type PostgresBinding,\n  type PostgresDriverCreateOptions,\n} from '../postgres-driver';\n\nexport type PostgresRuntimeDriver = RuntimeDriverInstance<'sql', 'postgres'> &\n  SqlDriver<PostgresBinding>;\n\nconst USE_BEFORE_CONNECT_MESSAGE =\n  'Postgres driver not connected. Call connect(binding) before acquireConnection or execute.';\nconst ALREADY_CONNECTED_MESSAGE =\n  'Postgres driver already connected. Call close() before reconnecting with a new binding.';\n\ninterface DriverRuntimeError extends Error {\n  readonly code: 'DRIVER.NOT_CONNECTED' | 'DRIVER.ALREADY_CONNECTED';\n  readonly category: 'RUNTIME';\n  readonly severity: 'error';\n  readonly details?: Record<string, unknown>;\n}\n\nfunction driverError(\n  code: DriverRuntimeError['code'],\n  message: string,\n  details?: Record<string, unknown>,\n): DriverRuntimeError {\n  const error = new Error(message) as DriverRuntimeError;\n  Object.defineProperty(error, 'name', {\n    value: 'RuntimeError',\n    configurable: true,\n  });\n  return Object.assign(error, {\n    code,\n    category: 'RUNTIME' as const,\n    severity: 'error' as const,\n    message,\n    details,\n  });\n}\n\nfunction unboundExecute<Row>(): AsyncIterable<Row> {\n  return {\n    [Symbol.asyncIterator]() {\n      return {\n        async next() {\n          throw driverError('DRIVER.NOT_CONNECTED', USE_BEFORE_CONNECT_MESSAGE);\n        },\n      };\n    },\n  };\n}\n\nclass PostgresUnboundDriverImpl implements PostgresRuntimeDriver {\n  readonly familyId = 'sql' as const;\n  readonly targetId = 'postgres' as const;\n\n  #delegate: SqlDriver<PostgresBinding> | null = null;\n  #closed = false;\n  #cursorOpts: PostgresDriverCreateOptions['cursor'];\n  #preparedStatements: PostgresDriverCreateOptions['preparedStatements'];\n\n  constructor(options?: PostgresDriverCreateOptions) {\n    this.#cursorOpts = options?.cursor;\n    this.#preparedStatements = options?.preparedStatements;\n  }\n\n  get state(): 'unbound' | 'connected' | 'closed' {\n    if (this.#delegate !== null) {\n      return 'connected';\n    }\n    if (this.#closed) {\n      return 'closed';\n    }\n    return 'unbound';\n  }\n\n  #requireDelegate(): SqlDriver<PostgresBinding> {\n    const delegate = this.#delegate;\n    if (delegate === null) {\n      throw driverError('DRIVER.NOT_CONNECTED', USE_BEFORE_CONNECT_MESSAGE);\n    }\n    return delegate;\n  }\n\n  async connect(binding: PostgresBinding): Promise<void> {\n    if (this.#delegate !== null) {\n      throw driverError('DRIVER.ALREADY_CONNECTED', ALREADY_CONNECTED_MESSAGE, {\n        bindingKind: binding.kind,\n      });\n    }\n    this.#delegate = createBoundDriverFromBinding(binding, this.#cursorOpts, {\n      preparedStatements: this.#preparedStatements,\n    });\n    this.#closed = false;\n  }\n\n  async acquireConnection(): Promise<SqlConnection> {\n    const delegate = this.#requireDelegate();\n    const connection = await delegate.acquireConnection();\n    return this.#wrapConnection(connection, delegate);\n  }\n\n  /**\n   * Wraps an acquired connection so that teardown paths which close the\n   * underlying delegate (notably `destroy()` on a pgClient binding, where\n   * the single socket means a destroyed connection invalidates the driver)\n   * also reset our own `#delegate` reference. Without this, a failed\n   * transaction rollback would leave the outer unbound wrapper reporting\n   * `connected` while routing subsequent work to an already-ended delegate.\n   */\n  #wrapConnection(connection: SqlConnection, delegate: SqlDriver<PostgresBinding>): SqlConnection {\n    const syncDelegateState = (): void => {\n      if (this.#delegate === delegate && delegate.state === 'closed') {\n        this.#delegate = null;\n        this.#closed = true;\n      }\n    };\n    const wrapped: SqlConnection = {\n      beginTransaction: connection.beginTransaction.bind(connection),\n      execute: connection.execute.bind(connection),\n      executePrepared: connection.executePrepared.bind(connection),\n      query: connection.query.bind(connection),\n      release: async () => {\n        try {\n          await connection.release();\n        } finally {\n          syncDelegateState();\n        }\n      },\n      destroy: async (reason?: unknown) => {\n        try {\n          await connection.destroy(reason);\n        } finally {\n          syncDelegateState();\n        }\n      },\n    };\n    if (connection.explain) {\n      wrapped.explain = connection.explain.bind(connection);\n    }\n    return wrapped;\n  }\n\n  async close(): Promise<void> {\n    const delegate = this.#delegate;\n    if (delegate !== null) {\n      this.#delegate = null;\n      await delegate.close();\n    }\n    this.#closed = true;\n  }\n\n  execute<Row = Record<string, unknown>>(request: SqlExecuteRequest): AsyncIterable<Row> {\n    const delegate = this.#delegate;\n    if (delegate === null) {\n      return unboundExecute<Row>();\n    }\n    return delegate.execute<Row>(request);\n  }\n\n  executePrepared<Row = Record<string, unknown>>(\n    request: PreparedExecuteRequest,\n  ): AsyncIterable<Row> {\n    const delegate = this.#delegate;\n    if (delegate === null) {\n      return unboundExecute<Row>();\n    }\n    return delegate.executePrepared<Row>(request);\n  }\n\n  async explain(request: SqlExecuteRequest): Promise<SqlExplainResult> {\n    const delegate = this.#requireDelegate();\n    const explain = delegate.explain;\n    if (explain === undefined) {\n      throw driverError('DRIVER.NOT_CONNECTED', USE_BEFORE_CONNECT_MESSAGE);\n    }\n    return explain.call(delegate, request);\n  }\n\n  async query<Row = Record<string, unknown>>(\n    sql: string,\n    params?: readonly unknown[],\n  ): Promise<SqlQueryResult<Row>> {\n    const delegate = this.#requireDelegate();\n    return delegate.query<Row>(sql, params);\n  }\n}\n\nconst postgresRuntimeDriverDescriptor: RuntimeDriverDescriptor<\n  'sql',\n  'postgres',\n  PostgresDriverCreateOptions,\n  PostgresRuntimeDriver\n> = {\n  ...postgresDriverDescriptorMeta,\n  create(options?: PostgresDriverCreateOptions): PostgresRuntimeDriver {\n    return new PostgresUnboundDriverImpl(options);\n  },\n};\n\nexport default postgresRuntimeDriverDescriptor;\nexport type {\n  PostgresBinding,\n  PostgresDriverCreateOptions,\n  QueryResult,\n} from '../postgres-driver';\n"],"mappings":"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"}
+{"version":3,"file":"runtime.mjs","names":["#queue","#connection","#onRelease","#onDestroy","#closed","#connectionMutex","#closeWhileHoldingLease","#connected","#connectPromise","#cursorOpts","#preparedStatements","#delegate","#closed","#requireDelegate","#wrapConnection"],"sources":["../src/callback-to-promise.ts","../src/named-cursor.ts","../src/postgres-driver.ts","../src/exports/runtime.ts"],"sourcesContent":["/**\n * Wraps a Node-style callback function into a Promise.\n * Supports both (err) => void and (err, result) => void patterns.\n */\nexport function callbackToPromise(\n  fn: (callback: (err: Error | null | undefined) => void) => void,\n): Promise<void>;\nexport function callbackToPromise<T>(\n  fn: (callback: (err: Error | null | undefined, result: T) => void) => void,\n): Promise<T>;\nexport function callbackToPromise<T = void>(\n  fn: (callback: (err: Error | null | undefined, result?: T) => void) => void,\n): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    fn((err, result) => {\n      if (err) {\n        reject(err);\n        return;\n      }\n      resolve(result as T);\n    });\n  });\n}\n","import type { BindConfig, Connection, QueryParse } from 'pg';\nimport Cursor from 'pg-cursor';\n\nlet nextNamedPortalId = 1;\n\nexport interface NamedCursorOptions<Row> {\n  readonly name: string;\n  readonly text: string;\n  readonly values: readonly unknown[];\n  readonly config?: ConstructorParameters<typeof Cursor<Row>>[2];\n}\n\n// `parsedStatements` is set on the Connection by pg.Client, not by Connection\n// itself, so it isn't declared on @types/pg's `Connection`.\ntype ConnectionWithStatementCache = Connection & {\n  readonly parsedStatements: Record<string, string>;\n};\n\n// pg-cursor's runtime instance shape. @types/pg-cursor only declares the\n// constructor + submit/read/close, so the fields pg-cursor sets on `this` and\n// its handlers consume have to be re-declared here.\ninterface CursorInstanceFields {\n  state: 'initialized' | 'submitted' | 'idle' | 'busy' | 'done' | 'error';\n  connection: Connection | null;\n  text: string;\n  values: ReadonlyArray<unknown> | null;\n  _portal: string;\n  _conf: { types?: { getTypeParser: (oid: number, format?: string) => unknown } };\n  _result: { _getTypeParser?: unknown };\n  _ifNoData: () => void;\n  _rowDescription: () => void;\n}\n\n/** Streaming cursor for a server-side named prepared statement. */\nexport class NamedCursor<Row = Record<string, unknown>> extends Cursor<Row> {\n  readonly name: string;\n\n  constructor(opts: NamedCursorOptions<Row>) {\n    super(opts.text, [...opts.values], opts.config);\n    this.name = opts.name;\n    // Cursor declares `submit` as a property, not a class method, so\n    // `override submit() {}` at the class level conflicts. Replace the\n    // field on this instance instead.\n    this.submit = this.submitNamed;\n  }\n\n  private submitNamed(connection: Connection): void {\n    const self = this as unknown as CursorInstanceFields;\n    const conn = connection as ConnectionWithStatementCache;\n\n    self.state = 'submitted';\n    self.connection = conn;\n    self._portal = `np_${nextNamedPortalId++}`;\n\n    if (!conn.parsedStatements[this.name]) {\n      // QueryParse types `types` as required; pg's runtime accepts an empty\n      // array (server infers parameter types).\n      const parseMessage: QueryParse = { text: self.text, name: this.name, types: [] };\n      conn.parse(parseMessage, true);\n    }\n\n    // pg-cursor's constructor pre-maps values via prepareValue, so the array\n    // here is already wire-ready; the cast bridges pg-cursor's loose `any[]`\n    // to BindConfig's stricter union.\n    const bindMessage: BindConfig = {\n      portal: self._portal,\n      statement: this.name,\n      values: (self.values ?? []) as BindConfig['values'],\n    };\n    conn.bind(bindMessage, true);\n\n    conn.describe({ type: 'P', name: self._portal }, true);\n    conn.flush();\n\n    if (self._conf.types) {\n      self._result._getTypeParser = self._conf.types.getTypeParser;\n    }\n\n    conn.once('noData', self._ifNoData);\n    conn.once('rowDescription', self._rowDescription);\n  }\n}\n","import type {\n  PreparedExecuteRequest,\n  SqlConnection,\n  SqlDriver,\n  SqlDriverState,\n  SqlExecuteRequest,\n  SqlExplainResult,\n  SqlQueryable,\n  SqlQueryResult,\n  SqlTransaction,\n} from '@prisma-next/sql-relational-core/ast';\nimport type {\n  Client,\n  QueryResult as PgQueryResult,\n  PoolClient,\n  Pool as PoolType,\n  QueryConfig,\n  QueryResultRow,\n} from 'pg';\nimport { Pool } from 'pg';\nimport Cursor from 'pg-cursor';\nimport { callbackToPromise } from './callback-to-promise';\nimport { NamedCursor } from './named-cursor';\nimport { isAlreadyConnectedError, isPostgresError, normalizePgError } from './normalize-error';\n\nexport type QueryResult<T extends QueryResultRow = QueryResultRow> = PgQueryResult<T>;\n\nexport type PostgresBinding =\n  | { readonly kind: 'url'; readonly url: string }\n  | { readonly kind: 'pgPool'; readonly pool: PoolType }\n  | { readonly kind: 'pgClient'; readonly client: Client };\n\nexport interface PostgresCursorOptions {\n  readonly batchSize?: number;\n  readonly disabled?: boolean;\n}\n\ninterface PostgresDriverOptions {\n  readonly connect: { client: Client } | { pool: PoolType };\n  readonly cursor?: PostgresCursorOptions | undefined;\n  /**\n   * Use server-side prepared statements for `executePrepared`. Default\n   * `true`. Set `false` when running behind a transaction-mode pooler that\n   * does not support session-scoped prepared statements (e.g. PgBouncer\n   * transaction mode).\n   */\n  readonly preparedStatements?: boolean | undefined;\n}\n\nexport type PostgresDriverCreateOptions = Omit<PostgresDriverOptions, 'connect'>;\n\nconst DEFAULT_BATCH_SIZE = 100;\nconst DEFAULT_PREPARED_STATEMENTS = true;\n\ntype CursorOptions =\n  | { readonly cursorDisabled: true }\n  | { readonly cursorBatchSize: number; readonly cursorDisabled: false };\n\ninterface HandleAllocator {\n  mint(): string;\n}\n\nfunction createHandleAllocator(): HandleAllocator {\n  // Driver-scoped so a single PreparedStatement reused across multiple\n  // Connections/Transactions of the same driver always sees one handle.\n  let next = 1;\n  return {\n    mint: () => `pn_${next++}`,\n  };\n}\n\ntype ConnectionOptions = CursorOptions & {\n  readonly preparedStatementsEnabled: boolean;\n  readonly handleAllocator: HandleAllocator;\n};\n\nfunction buildConnectionOptions(options: PostgresDriverOptions): ConnectionOptions {\n  const cursorOptions: CursorOptions = options.cursor?.disabled\n    ? { cursorDisabled: true }\n    : {\n        cursorBatchSize: options.cursor?.batchSize ?? DEFAULT_BATCH_SIZE,\n        cursorDisabled: false,\n      };\n  return {\n    ...cursorOptions,\n    preparedStatementsEnabled: options.preparedStatements ?? DEFAULT_PREPARED_STATEMENTS,\n    handleAllocator: createHandleAllocator(),\n  };\n}\n\nfunction isStalePreparedStatementError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  const code = (error as { code?: string }).code;\n  // 26000 — invalid_sql_statement_name (server lost the named statement,\n  //         e.g. after DEALLOCATE ALL).\n  // 0A000 — cached plan invalidated by DDL (row shape changed).\n  return code === '26000' || code === '0A000';\n}\n\nclass AsyncMutex {\n  #queue = Promise.resolve();\n\n  async lock(): Promise<() => void> {\n    const previous = this.#queue;\n    let releaseLock: (() => void) | undefined;\n    this.#queue = new Promise<void>((resolve) => {\n      releaseLock = resolve;\n    });\n    await previous;\n    return () => {\n      releaseLock?.();\n      releaseLock = undefined;\n    };\n  }\n}\n\nabstract class PostgresQueryable<C extends PoolClient | Client = PoolClient | Client>\n  implements SqlQueryable\n{\n  abstract acquireClient(): Promise<C>;\n  abstract releaseClient(client: C): Promise<void>;\n\n  protected readonly options: ConnectionOptions;\n\n  constructor(options: ConnectionOptions) {\n    this.options = options;\n  }\n\n  async *execute<Row = Record<string, unknown>>(request: SqlExecuteRequest): AsyncIterable<Row> {\n    try {\n      yield* this.runQuery<Row>(request);\n    } catch (error) {\n      throw normalizePgError(error);\n    }\n  }\n\n  async *executePrepared<Row = Record<string, unknown>>(\n    request: PreparedExecuteRequest,\n  ): AsyncIterable<Row> {\n    if (!this.options.preparedStatementsEnabled) {\n      // Skip server-side prepare entirely; route as a regular ad-hoc execute.\n      yield* this.execute<Row>(request);\n      return;\n    }\n\n    let handle = request.handle.get();\n    if (handle === undefined) {\n      handle = this.options.handleAllocator.mint();\n      request.handle.set(handle);\n    }\n\n    yield* this.withStaleHandleRetry<Row>(request, handle as string, (h) =>\n      this.runQuery<Row>(request, h),\n    );\n  }\n\n  private async *withStaleHandleRetry<Row>(\n    request: PreparedExecuteRequest,\n    handle: string,\n    attempt: (handle: string) => AsyncIterable<Row>,\n  ): AsyncIterable<Row> {\n    let yielded = false;\n    try {\n      for await (const row of attempt(handle)) {\n        yielded = true;\n        yield row;\n      }\n      return;\n    } catch (error) {\n      // If a row was already yielded, the error came from mid-stream and a\n      // retry would re-yield prior rows to the consumer.\n      if (yielded || !isStalePreparedStatementError(error)) {\n        throw normalizePgError(error);\n      }\n      // pg's parsedStatements still records the old name; only a fresh name\n      // forces pg to re-Parse on this Client.\n      const retryHandle = this.options.handleAllocator.mint();\n      request.handle.set(retryHandle);\n      try {\n        yield* attempt(retryHandle);\n      } catch (retryError) {\n        throw normalizePgError(retryError);\n      }\n    }\n  }\n\n  // Errors propagate as raw pg errors so the caller can read SQLSTATE before\n  // normalising (the prepared-statement retry layer needs the original code).\n  private async *runQuery<Row>(request: SqlExecuteRequest, name?: string): AsyncIterable<Row> {\n    const client = await this.acquireClient();\n    try {\n      if (!this.options.cursorDisabled) {\n        try {\n          for await (const row of this.executeWithCursor(\n            client,\n            request.sql,\n            request.params,\n            this.options.cursorBatchSize,\n            name,\n          )) {\n            yield row as Row;\n          }\n          return;\n        } catch (cursorError) {\n          // Non-pg cursor-specific errors fall through to the buffered path;\n          // real pg errors propagate.\n          if (!(cursorError instanceof Error) || isPostgresError(cursorError)) {\n            throw cursorError;\n          }\n        }\n      }\n\n      for await (const row of this.executeBuffered(client, request.sql, request.params, name)) {\n        yield row as Row;\n      }\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  async explain(request: SqlExecuteRequest): Promise<SqlExplainResult> {\n    // SQL is generated by Prisma Next planners (or validated raw paths), so\n    // EXPLAIN prefixing preserves the same statement semantics.\n    const text = `EXPLAIN (FORMAT JSON) ${request.sql}`;\n    const client = await this.acquireClient();\n    try {\n      const result = await client\n        .query(text, request.params as unknown[] | undefined)\n        .catch(rethrowNormalizedError);\n      return { rows: result.rows as ReadonlyArray<Record<string, unknown>> };\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  async query<Row = Record<string, unknown>>(\n    sql: string,\n    params?: readonly unknown[],\n  ): Promise<SqlQueryResult<Row>> {\n    const client = await this.acquireClient();\n    try {\n      const result = await client\n        .query(sql, params as unknown[] | undefined)\n        .catch(rethrowNormalizedError);\n      return result as unknown as SqlQueryResult<Row>;\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  private async *executeWithCursor(\n    client: PoolClient | Client,\n    sql: string,\n    params: readonly unknown[] | undefined,\n    cursorBatchSize: number,\n    name?: string,\n  ): AsyncIterable<Record<string, unknown>> {\n    const values = (params ?? []) as unknown[];\n    const cursor = client.query(\n      name === undefined ? new Cursor(sql, values) : new NamedCursor({ name, text: sql, values }),\n    );\n\n    try {\n      while (true) {\n        const rows = await readCursor(cursor, cursorBatchSize);\n        if (rows.length === 0) {\n          break;\n        }\n\n        for (const row of rows) {\n          yield row;\n        }\n      }\n    } finally {\n      await closeCursor(cursor);\n    }\n  }\n\n  private async *executeBuffered(\n    client: PoolClient | Client,\n    sql: string,\n    params: readonly unknown[] | undefined,\n    name?: string,\n  ): AsyncIterable<Record<string, unknown>> {\n    const config: QueryConfig = { name, text: sql, values: (params ?? []) as unknown[] };\n    const result = await client.query(config);\n    for (const row of result.rows as Record<string, unknown>[]) {\n      yield row;\n    }\n  }\n}\n\nclass PostgresConnectionImpl extends PostgresQueryable implements SqlConnection {\n  #connection: PoolClient | Client;\n  #onRelease: (() => void) | undefined;\n  #onDestroy: ((reason: unknown) => Promise<void> | void) | undefined;\n\n  constructor(\n    connection: PoolClient | Client,\n    options: ConnectionOptions,\n    onRelease?: () => void,\n    onDestroy?: (reason: unknown) => Promise<void> | void,\n  ) {\n    super(options);\n    this.#connection = connection;\n    this.#onRelease = onRelease;\n    this.#onDestroy = onDestroy;\n  }\n\n  override acquireClient(): Promise<PoolClient | Client> {\n    return Promise.resolve(this.#connection);\n  }\n\n  override releaseClient(_client: PoolClient | Client): Promise<void> {\n    return Promise.resolve();\n  }\n\n  async beginTransaction(): Promise<SqlTransaction> {\n    await this.#connection.query('BEGIN').catch(rethrowNormalizedError);\n    return new PostgresTransactionImpl(this.#connection, this.options);\n  }\n\n  async release(): Promise<void> {\n    const conn = this.#connection;\n    if ('release' in conn) {\n      conn.release();\n    }\n    const onRelease = this.#onRelease;\n    this.#onRelease = undefined;\n    this.#onDestroy = undefined;\n    onRelease?.();\n  }\n\n  async destroy(reason?: unknown): Promise<void> {\n    const onDestroy = this.#onDestroy;\n    const onRelease = this.#onRelease;\n    this.#onDestroy = undefined;\n    this.#onRelease = undefined;\n\n    const conn = this.#connection;\n    if ('release' in conn) {\n      // Pass a truthy Error to pg's PoolClient.release so the pool evicts the\n      // client instead of returning it for reuse. A connection that reaches\n      // destroy() is in an indeterminate state (failed rollback/commit, etc.)\n      // and must not be handed back to another caller. The Error value is\n      // surfaced on pg-pool's 'release' event as advisory context; pg-pool\n      // itself only uses its truthiness for the eviction decision.\n      const releaseArg: Error =\n        reason instanceof Error ? reason : new Error('Connection destroyed');\n      conn.release(releaseArg);\n    }\n\n    if (onDestroy) {\n      await onDestroy(reason);\n    } else {\n      onRelease?.();\n    }\n  }\n}\n\nclass PostgresTransactionImpl extends PostgresQueryable implements SqlTransaction {\n  #connection: PoolClient | Client;\n\n  constructor(connection: PoolClient | Client, options: ConnectionOptions) {\n    super(options);\n    this.#connection = connection;\n  }\n\n  override acquireClient(): Promise<PoolClient | Client> {\n    return Promise.resolve(this.#connection);\n  }\n\n  override releaseClient(_client: PoolClient | Client): Promise<void> {\n    return Promise.resolve();\n  }\n\n  async commit(): Promise<void> {\n    await this.#connection.query('COMMIT').catch(rethrowNormalizedError);\n  }\n\n  async rollback(): Promise<void> {\n    await this.#connection.query('ROLLBACK').catch(rethrowNormalizedError);\n  }\n}\n\nclass PostgresPoolDriverImpl\n  extends PostgresQueryable<PoolClient>\n  implements SqlDriver<PostgresBinding>\n{\n  private readonly pool: PoolType;\n  #closed = false;\n\n  constructor(options: PostgresDriverOptions & { connect: { pool: PoolType } }) {\n    super(buildConnectionOptions(options));\n    this.pool = options.connect.pool;\n  }\n\n  get state(): SqlDriverState {\n    return this.#closed ? 'closed' : 'connected';\n  }\n\n  // Bound drivers are created via createBoundDriverFromBinding with pool already\n  // configured; connect is intentionally no-op.\n  async connect(_binding: PostgresBinding): Promise<void> {}\n\n  async acquireConnection(): Promise<SqlConnection> {\n    const client = await this.acquireClient();\n    return new PostgresConnectionImpl(client, this.options);\n  }\n\n  async close(): Promise<void> {\n    if (this.#closed) {\n      return;\n    }\n    this.#closed = true;\n    await this.pool.end();\n  }\n\n  async acquireClient(): Promise<PoolClient> {\n    return this.pool.connect();\n  }\n\n  async releaseClient(client: PoolClient): Promise<void> {\n    client.release();\n  }\n}\n\nclass PostgresDirectDriverImpl\n  extends PostgresQueryable<Client>\n  implements SqlDriver<PostgresBinding>\n{\n  private readonly directClient: Client;\n  readonly #connectionMutex = new AsyncMutex();\n  #closed = false;\n  #connected = false;\n  #connectPromise: Promise<void> | undefined;\n\n  constructor(options: PostgresDriverOptions & { connect: { client: Client } }) {\n    super(buildConnectionOptions(options));\n    this.directClient = options.connect.client;\n  }\n\n  get state(): SqlDriverState {\n    return this.#closed ? 'closed' : 'connected';\n  }\n\n  // Bound drivers are created via createBoundDriverFromBinding with client already\n  // configured; connect is intentionally no-op.\n  async connect(_binding: PostgresBinding): Promise<void> {}\n\n  async acquireConnection(): Promise<SqlConnection> {\n    const releaseLease = await this.#connectionMutex.lock();\n    try {\n      const client = await this.acquireClient();\n      return new PostgresConnectionImpl(\n        client,\n        this.options,\n        releaseLease,\n        // A direct driver has a single underlying socket, so a destroyed\n        // connection means the driver itself is no longer usable. Tear down\n        // the driver while still holding the lease so that any\n        // acquireConnection() queued on #connectionMutex only observes the\n        // driver after .end() has completed and #closed is set — preventing\n        // a concurrent caller from reusing a socket that is already being\n        // closed. The lease is released in a finally so a failing .end()\n        // cannot leave the mutex permanently held.\n        async () => {\n          try {\n            await this.#closeWhileHoldingLease();\n          } finally {\n            releaseLease();\n          }\n        },\n      );\n    } catch (error) {\n      releaseLease();\n      throw error;\n    }\n  }\n\n  async close(): Promise<void> {\n    const releaseLease = await this.#connectionMutex.lock();\n    try {\n      await this.#closeWhileHoldingLease();\n    } finally {\n      releaseLease();\n    }\n  }\n\n  async #closeWhileHoldingLease(): Promise<void> {\n    if (this.#closed) {\n      return;\n    }\n    this.#closed = true;\n    await this.directClient.end();\n    this.#connected = false;\n  }\n\n  async acquireClient(): Promise<Client> {\n    if (this.#connected) {\n      return this.directClient;\n    }\n    if (this.#connectPromise !== undefined) {\n      await this.#connectPromise;\n      return this.directClient;\n    }\n\n    this.#connectPromise = (async () => {\n      try {\n        await this.directClient.connect();\n      } catch (error: unknown) {\n        if (!isAlreadyConnectedError(error)) {\n          throw error;\n        }\n      } finally {\n        this.#connectPromise = undefined;\n      }\n      this.#connected = true;\n    })();\n    await this.#connectPromise;\n\n    return this.directClient;\n  }\n\n  async releaseClient(_client: Client): Promise<void> {}\n}\n\nexport function createBoundDriverFromBinding(\n  binding: PostgresBinding,\n  cursorOpts: PostgresDriverCreateOptions['cursor'],\n  extraOpts?: Pick<PostgresDriverCreateOptions, 'preparedStatements'>,\n): SqlDriver<PostgresBinding> {\n  const preparedStatements = extraOpts?.preparedStatements;\n  switch (binding.kind) {\n    case 'url': {\n      const pool = new Pool({\n        connectionString: binding.url,\n        connectionTimeoutMillis: 20_000,\n        idleTimeoutMillis: 30_000,\n      });\n      return new PostgresPoolDriverImpl({\n        connect: { pool },\n        cursor: cursorOpts,\n        preparedStatements,\n      });\n    }\n    case 'pgPool':\n      return new PostgresPoolDriverImpl({\n        connect: { pool: binding.pool },\n        cursor: cursorOpts,\n        preparedStatements,\n      });\n    case 'pgClient':\n      return new PostgresDirectDriverImpl({\n        connect: { client: binding.client },\n        cursor: cursorOpts,\n        preparedStatements,\n      });\n  }\n}\n\nfunction readCursor<Row>(cursor: Cursor<Row>, size: number): Promise<Row[]> {\n  return callbackToPromise<Row[]>((cb) => {\n    cursor.read(size, (err, rows) => cb(err, rows));\n  });\n}\n\nfunction closeCursor(cursor: Cursor<unknown>): Promise<void> {\n  return callbackToPromise((cb) => cursor.close(cb));\n}\n\nfunction rethrowNormalizedError(error: unknown): never {\n  throw normalizePgError(error);\n}\n","import type {\n  RuntimeDriverDescriptor,\n  RuntimeDriverInstance,\n} from '@prisma-next/framework-components/execution';\nimport type {\n  PreparedExecuteRequest,\n  SqlConnection,\n  SqlDriver,\n  SqlExecuteRequest,\n  SqlExplainResult,\n  SqlQueryResult,\n} from '@prisma-next/sql-relational-core/ast';\nimport { postgresDriverDescriptorMeta } from '../core/descriptor-meta';\nimport {\n  createBoundDriverFromBinding,\n  type PostgresBinding,\n  type PostgresDriverCreateOptions,\n} from '../postgres-driver';\n\nexport type PostgresRuntimeDriver = RuntimeDriverInstance<'sql', 'postgres'> &\n  SqlDriver<PostgresBinding>;\n\nconst USE_BEFORE_CONNECT_MESSAGE =\n  'Postgres driver not connected. Call connect(binding) before acquireConnection or execute.';\nconst ALREADY_CONNECTED_MESSAGE =\n  'Postgres driver already connected. Call close() before reconnecting with a new binding.';\n\ninterface DriverRuntimeError extends Error {\n  readonly code: 'DRIVER.NOT_CONNECTED' | 'DRIVER.ALREADY_CONNECTED';\n  readonly category: 'RUNTIME';\n  readonly severity: 'error';\n  readonly details?: Record<string, unknown>;\n}\n\nfunction driverError(\n  code: DriverRuntimeError['code'],\n  message: string,\n  details?: Record<string, unknown>,\n): DriverRuntimeError {\n  const error = new Error(message) as DriverRuntimeError;\n  Object.defineProperty(error, 'name', {\n    value: 'RuntimeError',\n    configurable: true,\n  });\n  return Object.assign(error, {\n    code,\n    category: 'RUNTIME' as const,\n    severity: 'error' as const,\n    message,\n    details,\n  });\n}\n\nfunction unboundExecute<Row>(): AsyncIterable<Row> {\n  return {\n    [Symbol.asyncIterator]() {\n      return {\n        async next() {\n          throw driverError('DRIVER.NOT_CONNECTED', USE_BEFORE_CONNECT_MESSAGE);\n        },\n      };\n    },\n  };\n}\n\nclass PostgresUnboundDriverImpl implements PostgresRuntimeDriver {\n  readonly familyId = 'sql' as const;\n  readonly targetId = 'postgres' as const;\n\n  #delegate: SqlDriver<PostgresBinding> | null = null;\n  #closed = false;\n  #cursorOpts: PostgresDriverCreateOptions['cursor'];\n  #preparedStatements: PostgresDriverCreateOptions['preparedStatements'];\n\n  constructor(options?: PostgresDriverCreateOptions) {\n    this.#cursorOpts = options?.cursor;\n    this.#preparedStatements = options?.preparedStatements;\n  }\n\n  get state(): 'unbound' | 'connected' | 'closed' {\n    if (this.#delegate !== null) {\n      return 'connected';\n    }\n    if (this.#closed) {\n      return 'closed';\n    }\n    return 'unbound';\n  }\n\n  #requireDelegate(): SqlDriver<PostgresBinding> {\n    const delegate = this.#delegate;\n    if (delegate === null) {\n      throw driverError('DRIVER.NOT_CONNECTED', USE_BEFORE_CONNECT_MESSAGE);\n    }\n    return delegate;\n  }\n\n  async connect(binding: PostgresBinding): Promise<void> {\n    if (this.#delegate !== null) {\n      throw driverError('DRIVER.ALREADY_CONNECTED', ALREADY_CONNECTED_MESSAGE, {\n        bindingKind: binding.kind,\n      });\n    }\n    this.#delegate = createBoundDriverFromBinding(binding, this.#cursorOpts, {\n      preparedStatements: this.#preparedStatements,\n    });\n    this.#closed = false;\n  }\n\n  async acquireConnection(): Promise<SqlConnection> {\n    const delegate = this.#requireDelegate();\n    const connection = await delegate.acquireConnection();\n    return this.#wrapConnection(connection, delegate);\n  }\n\n  /**\n   * Wraps an acquired connection so that teardown paths which close the\n   * underlying delegate (notably `destroy()` on a pgClient binding, where\n   * the single socket means a destroyed connection invalidates the driver)\n   * also reset our own `#delegate` reference. Without this, a failed\n   * transaction rollback would leave the outer unbound wrapper reporting\n   * `connected` while routing subsequent work to an already-ended delegate.\n   */\n  #wrapConnection(connection: SqlConnection, delegate: SqlDriver<PostgresBinding>): SqlConnection {\n    const syncDelegateState = (): void => {\n      if (this.#delegate === delegate && delegate.state === 'closed') {\n        this.#delegate = null;\n        this.#closed = true;\n      }\n    };\n    const wrapped: SqlConnection = {\n      beginTransaction: connection.beginTransaction.bind(connection),\n      execute: connection.execute.bind(connection),\n      executePrepared: connection.executePrepared.bind(connection),\n      query: connection.query.bind(connection),\n      release: async () => {\n        try {\n          await connection.release();\n        } finally {\n          syncDelegateState();\n        }\n      },\n      destroy: async (reason?: unknown) => {\n        try {\n          await connection.destroy(reason);\n        } finally {\n          syncDelegateState();\n        }\n      },\n    };\n    if (connection.explain) {\n      wrapped.explain = connection.explain.bind(connection);\n    }\n    return wrapped;\n  }\n\n  async close(): Promise<void> {\n    const delegate = this.#delegate;\n    if (delegate !== null) {\n      this.#delegate = null;\n      await delegate.close();\n    }\n    this.#closed = true;\n  }\n\n  execute<Row = Record<string, unknown>>(request: SqlExecuteRequest): AsyncIterable<Row> {\n    const delegate = this.#delegate;\n    if (delegate === null) {\n      return unboundExecute<Row>();\n    }\n    return delegate.execute<Row>(request);\n  }\n\n  executePrepared<Row = Record<string, unknown>>(\n    request: PreparedExecuteRequest,\n  ): AsyncIterable<Row> {\n    const delegate = this.#delegate;\n    if (delegate === null) {\n      return unboundExecute<Row>();\n    }\n    return delegate.executePrepared<Row>(request);\n  }\n\n  async explain(request: SqlExecuteRequest): Promise<SqlExplainResult> {\n    const delegate = this.#requireDelegate();\n    const explain = delegate.explain;\n    if (explain === undefined) {\n      throw driverError('DRIVER.NOT_CONNECTED', USE_BEFORE_CONNECT_MESSAGE);\n    }\n    return explain.call(delegate, request);\n  }\n\n  async query<Row = Record<string, unknown>>(\n    sql: string,\n    params?: readonly unknown[],\n  ): Promise<SqlQueryResult<Row>> {\n    const delegate = this.#requireDelegate();\n    return delegate.query<Row>(sql, params);\n  }\n}\n\nconst postgresRuntimeDriverDescriptor: RuntimeDriverDescriptor<\n  'sql',\n  'postgres',\n  PostgresDriverCreateOptions,\n  PostgresRuntimeDriver\n> = {\n  ...postgresDriverDescriptorMeta,\n  create(options?: PostgresDriverCreateOptions): PostgresRuntimeDriver {\n    return new PostgresUnboundDriverImpl(options);\n  },\n};\n\nexport default postgresRuntimeDriverDescriptor;\nexport type {\n  PostgresBinding,\n  PostgresDriverCreateOptions,\n  QueryResult,\n} from '../postgres-driver';\n"],"mappings":";;;;AAUA,SAAgB,kBACd,IACY;CACZ,OAAO,IAAI,SAAY,SAAS,WAAW;EACzC,IAAI,KAAK,WAAW;GAClB,IAAI,KAAK;IACP,OAAO,GAAG;IACV;GACF;GACA,QAAQ,MAAW;EACrB,CAAC;CACH,CAAC;AACH;;;ACnBA,IAAI,oBAAoB;;AA+BxB,IAAa,cAAb,cAAgE,OAAY;CAC1E;CAEA,YAAY,MAA+B;EACzC,MAAM,KAAK,MAAM,CAAC,GAAG,KAAK,MAAM,GAAG,KAAK,MAAM;EAC9C,KAAK,OAAO,KAAK;EAIjB,KAAK,SAAS,KAAK;CACrB;CAEA,YAAoB,YAA8B;EAChD,MAAM,OAAO;EACb,MAAM,OAAO;EAEb,KAAK,QAAQ;EACb,KAAK,aAAa;EAClB,KAAK,UAAU,MAAM;EAErB,IAAI,CAAC,KAAK,iBAAiB,KAAK,OAAO;GAGrC,MAAM,eAA2B;IAAE,MAAM,KAAK;IAAM,MAAM,KAAK;IAAM,OAAO,CAAC;GAAE;GAC/E,KAAK,MAAM,cAAc,IAAI;EAC/B;EAKA,MAAM,cAA0B;GAC9B,QAAQ,KAAK;GACb,WAAW,KAAK;GAChB,QAAS,KAAK,UAAU,CAAC;EAC3B;EACA,KAAK,KAAK,aAAa,IAAI;EAE3B,KAAK,SAAS;GAAE,MAAM;GAAK,MAAM,KAAK;EAAQ,GAAG,IAAI;EACrD,KAAK,MAAM;EAEX,IAAI,KAAK,MAAM,OACb,KAAK,QAAQ,iBAAiB,KAAK,MAAM,MAAM;EAGjD,KAAK,KAAK,UAAU,KAAK,SAAS;EAClC,KAAK,KAAK,kBAAkB,KAAK,eAAe;CAClD;AACF;;;AC9BA,MAAM,qBAAqB;AAC3B,MAAM,8BAA8B;AAUpC,SAAS,wBAAyC;CAGhD,IAAI,OAAO;CACX,OAAO,EACL,YAAY,MAAM,SACpB;AACF;AAOA,SAAS,uBAAuB,SAAmD;CAOjF,OAAO;EACL,GAPmC,QAAQ,QAAQ,WACjD,EAAE,gBAAgB,KAAK,IACvB;GACE,iBAAiB,QAAQ,QAAQ,aAAa;GAC9C,gBAAgB;EAClB;EAGF,2BAA2B,QAAQ,sBAAsB;EACzD,iBAAiB,sBAAsB;CACzC;AACF;AAEA,SAAS,8BAA8B,OAAyB;CAC9D,IAAI,EAAE,iBAAiB,QACrB,OAAO;CAET,MAAM,OAAQ,MAA4B;CAI1C,OAAO,SAAS,WAAW,SAAS;AACtC;AAEA,IAAM,aAAN,MAAiB;CACf,SAAS,QAAQ,QAAQ;CAEzB,MAAM,OAA4B;EAChC,MAAM,WAAW,KAAKA;EACtB,IAAI;EACJ,KAAKA,SAAS,IAAI,SAAe,YAAY;GAC3C,cAAc;EAChB,CAAC;EACD,MAAM;EACN,aAAa;GACX,cAAc;GACd,cAAc,KAAA;EAChB;CACF;AACF;AAEA,IAAe,oBAAf,MAEA;CAIE;CAEA,YAAY,SAA4B;EACtC,KAAK,UAAU;CACjB;CAEA,OAAO,QAAuC,SAAgD;EAC5F,IAAI;GACF,OAAO,KAAK,SAAc,OAAO;EACnC,SAAS,OAAO;GACd,MAAM,iBAAiB,KAAK;EAC9B;CACF;CAEA,OAAO,gBACL,SACoB;EACpB,IAAI,CAAC,KAAK,QAAQ,2BAA2B;GAE3C,OAAO,KAAK,QAAa,OAAO;GAChC;EACF;EAEA,IAAI,SAAS,QAAQ,OAAO,IAAI;EAChC,IAAI,WAAW,KAAA,GAAW;GACxB,SAAS,KAAK,QAAQ,gBAAgB,KAAK;GAC3C,QAAQ,OAAO,IAAI,MAAM;EAC3B;EAEA,OAAO,KAAK,qBAA0B,SAAS,SAAmB,MAChE,KAAK,SAAc,SAAS,CAAC,CAC/B;CACF;CAEA,OAAe,qBACb,SACA,QACA,SACoB;EACpB,IAAI,UAAU;EACd,IAAI;GACF,WAAW,MAAM,OAAO,QAAQ,MAAM,GAAG;IACvC,UAAU;IACV,MAAM;GACR;GACA;EACF,SAAS,OAAO;GAGd,IAAI,WAAW,CAAC,8BAA8B,KAAK,GACjD,MAAM,iBAAiB,KAAK;GAI9B,MAAM,cAAc,KAAK,QAAQ,gBAAgB,KAAK;GACtD,QAAQ,OAAO,IAAI,WAAW;GAC9B,IAAI;IACF,OAAO,QAAQ,WAAW;GAC5B,SAAS,YAAY;IACnB,MAAM,iBAAiB,UAAU;GACnC;EACF;CACF;CAIA,OAAe,SAAc,SAA4B,MAAmC;EAC1F,MAAM,SAAS,MAAM,KAAK,cAAc;EACxC,IAAI;GACF,IAAI,CAAC,KAAK,QAAQ,gBAChB,IAAI;IACF,WAAW,MAAM,OAAO,KAAK,kBAC3B,QACA,QAAQ,KACR,QAAQ,QACR,KAAK,QAAQ,iBACb,IACF,GACE,MAAM;IAER;GACF,SAAS,aAAa;IAGpB,IAAI,EAAE,uBAAuB,UAAU,gBAAgB,WAAW,GAChE,MAAM;GAEV;GAGF,WAAW,MAAM,OAAO,KAAK,gBAAgB,QAAQ,QAAQ,KAAK,QAAQ,QAAQ,IAAI,GACpF,MAAM;EAEV,UAAU;GACR,MAAM,KAAK,cAAc,MAAM;EACjC;CACF;CAEA,MAAM,QAAQ,SAAuD;EAGnE,MAAM,OAAO,yBAAyB,QAAQ;EAC9C,MAAM,SAAS,MAAM,KAAK,cAAc;EACxC,IAAI;GAIF,OAAO,EAAE,OAAM,MAHM,OAClB,MAAM,MAAM,QAAQ,MAA+B,CAAC,CACpD,MAAM,sBAAsB,EAAA,CACT,KAA+C;EACvE,UAAU;GACR,MAAM,KAAK,cAAc,MAAM;EACjC;CACF;CAEA,MAAM,MACJ,KACA,QAC8B;EAC9B,MAAM,SAAS,MAAM,KAAK,cAAc;EACxC,IAAI;GAIF,OAAO,MAHc,OAClB,MAAM,KAAK,MAA+B,CAAC,CAC3C,MAAM,sBAAsB;EAEjC,UAAU;GACR,MAAM,KAAK,cAAc,MAAM;EACjC;CACF;CAEA,OAAe,kBACb,QACA,KACA,QACA,iBACA,MACwC;EACxC,MAAM,SAAU,UAAU,CAAC;EAC3B,MAAM,SAAS,OAAO,MACpB,SAAS,KAAA,IAAY,IAAI,OAAO,KAAK,MAAM,IAAI,IAAI,YAAY;GAAE;GAAM,MAAM;GAAK;EAAO,CAAC,CAC5F;EAEA,IAAI;GACF,OAAO,MAAM;IACX,MAAM,OAAO,MAAM,WAAW,QAAQ,eAAe;IACrD,IAAI,KAAK,WAAW,GAClB;IAGF,KAAK,MAAM,OAAO,MAChB,MAAM;GAEV;EACF,UAAU;GACR,MAAM,YAAY,MAAM;EAC1B;CACF;CAEA,OAAe,gBACb,QACA,KACA,QACA,MACwC;EACxC,MAAM,SAAsB;GAAE;GAAM,MAAM;GAAK,QAAS,UAAU,CAAC;EAAgB;EACnF,MAAM,SAAS,MAAM,OAAO,MAAM,MAAM;EACxC,KAAK,MAAM,OAAO,OAAO,MACvB,MAAM;CAEV;AACF;AAEA,IAAM,yBAAN,cAAqC,kBAA2C;CAC9E;CACA;CACA;CAEA,YACE,YACA,SACA,WACA,WACA;EACA,MAAM,OAAO;EACb,KAAKC,cAAc;EACnB,KAAKC,aAAa;EAClB,KAAKC,aAAa;CACpB;CAEA,gBAAuD;EACrD,OAAO,QAAQ,QAAQ,KAAKF,WAAW;CACzC;CAEA,cAAuB,SAA6C;EAClE,OAAO,QAAQ,QAAQ;CACzB;CAEA,MAAM,mBAA4C;EAChD,MAAM,KAAKA,YAAY,MAAM,OAAO,CAAC,CAAC,MAAM,sBAAsB;EAClE,OAAO,IAAI,wBAAwB,KAAKA,aAAa,KAAK,OAAO;CACnE;CAEA,MAAM,UAAyB;EAC7B,MAAM,OAAO,KAAKA;EAClB,IAAI,aAAa,MACf,KAAK,QAAQ;EAEf,MAAM,YAAY,KAAKC;EACvB,KAAKA,aAAa,KAAA;EAClB,KAAKC,aAAa,KAAA;EAClB,YAAY;CACd;CAEA,MAAM,QAAQ,QAAiC;EAC7C,MAAM,YAAY,KAAKA;EACvB,MAAM,YAAY,KAAKD;EACvB,KAAKC,aAAa,KAAA;EAClB,KAAKD,aAAa,KAAA;EAElB,MAAM,OAAO,KAAKD;EAClB,IAAI,aAAa,MAAM;GAOrB,MAAM,aACJ,kBAAkB,QAAQ,yBAAS,IAAI,MAAM,sBAAsB;GACrE,KAAK,QAAQ,UAAU;EACzB;EAEA,IAAI,WACF,MAAM,UAAU,MAAM;OAEtB,YAAY;CAEhB;AACF;AAEA,IAAM,0BAAN,cAAsC,kBAA4C;CAChF;CAEA,YAAY,YAAiC,SAA4B;EACvE,MAAM,OAAO;EACb,KAAKA,cAAc;CACrB;CAEA,gBAAuD;EACrD,OAAO,QAAQ,QAAQ,KAAKA,WAAW;CACzC;CAEA,cAAuB,SAA6C;EAClE,OAAO,QAAQ,QAAQ;CACzB;CAEA,MAAM,SAAwB;EAC5B,MAAM,KAAKA,YAAY,MAAM,QAAQ,CAAC,CAAC,MAAM,sBAAsB;CACrE;CAEA,MAAM,WAA0B;EAC9B,MAAM,KAAKA,YAAY,MAAM,UAAU,CAAC,CAAC,MAAM,sBAAsB;CACvE;AACF;AAEA,IAAM,yBAAN,cACU,kBAEV;CACE;CACA,UAAU;CAEV,YAAY,SAAkE;EAC5E,MAAM,uBAAuB,OAAO,CAAC;EACrC,KAAK,OAAO,QAAQ,QAAQ;CAC9B;CAEA,IAAI,QAAwB;EAC1B,OAAO,KAAKG,UAAU,WAAW;CACnC;CAIA,MAAM,QAAQ,UAA0C,CAAC;CAEzD,MAAM,oBAA4C;EAEhD,OAAO,IAAI,uBAAuB,MADb,KAAK,cAAc,GACE,KAAK,OAAO;CACxD;CAEA,MAAM,QAAuB;EAC3B,IAAI,KAAKA,SACP;EAEF,KAAKA,UAAU;EACf,MAAM,KAAK,KAAK,IAAI;CACtB;CAEA,MAAM,gBAAqC;EACzC,OAAO,KAAK,KAAK,QAAQ;CAC3B;CAEA,MAAM,cAAc,QAAmC;EACrD,OAAO,QAAQ;CACjB;AACF;AAEA,IAAM,2BAAN,cACU,kBAEV;CACE;CACA,mBAA4B,IAAI,WAAW;CAC3C,UAAU;CACV,aAAa;CACb;CAEA,YAAY,SAAkE;EAC5E,MAAM,uBAAuB,OAAO,CAAC;EACrC,KAAK,eAAe,QAAQ,QAAQ;CACtC;CAEA,IAAI,QAAwB;EAC1B,OAAO,KAAKA,UAAU,WAAW;CACnC;CAIA,MAAM,QAAQ,UAA0C,CAAC;CAEzD,MAAM,oBAA4C;EAChD,MAAM,eAAe,MAAM,KAAKC,iBAAiB,KAAK;EACtD,IAAI;GAEF,OAAO,IAAI,uBACT,MAFmB,KAAK,cAAc,GAGtC,KAAK,SACL,cASA,YAAY;IACV,IAAI;KACF,MAAM,KAAKC,wBAAwB;IACrC,UAAU;KACR,aAAa;IACf;GACF,CACF;EACF,SAAS,OAAO;GACd,aAAa;GACb,MAAM;EACR;CACF;CAEA,MAAM,QAAuB;EAC3B,MAAM,eAAe,MAAM,KAAKD,iBAAiB,KAAK;EACtD,IAAI;GACF,MAAM,KAAKC,wBAAwB;EACrC,UAAU;GACR,aAAa;EACf;CACF;CAEA,MAAMA,0BAAyC;EAC7C,IAAI,KAAKF,SACP;EAEF,KAAKA,UAAU;EACf,MAAM,KAAK,aAAa,IAAI;EAC5B,KAAKG,aAAa;CACpB;CAEA,MAAM,gBAAiC;EACrC,IAAI,KAAKA,YACP,OAAO,KAAK;EAEd,IAAI,KAAKC,oBAAoB,KAAA,GAAW;GACtC,MAAM,KAAKA;GACX,OAAO,KAAK;EACd;EAEA,KAAKA,mBAAmB,YAAY;GAClC,IAAI;IACF,MAAM,KAAK,aAAa,QAAQ;GAClC,SAAS,OAAgB;IACvB,IAAI,CAAC,wBAAwB,KAAK,GAChC,MAAM;GAEV,UAAU;IACR,KAAKA,kBAAkB,KAAA;GACzB;GACA,KAAKD,aAAa;EACpB,EAAA,CAAG;EACH,MAAM,KAAKC;EAEX,OAAO,KAAK;CACd;CAEA,MAAM,cAAc,SAAgC,CAAC;AACvD;AAEA,SAAgB,6BACd,SACA,YACA,WAC4B;CAC5B,MAAM,qBAAqB,WAAW;CACtC,QAAQ,QAAQ,MAAhB;EACE,KAAK,OAMH,OAAO,IAAI,uBAAuB;GAChC,SAAS,EAAE,MAAA,IANI,KAAK;IACpB,kBAAkB,QAAQ;IAC1B,yBAAyB;IACzB,mBAAmB;GACrB,CAEgB,EAAE;GAChB,QAAQ;GACR;EACF,CAAC;EAEH,KAAK,UACH,OAAO,IAAI,uBAAuB;GAChC,SAAS,EAAE,MAAM,QAAQ,KAAK;GAC9B,QAAQ;GACR;EACF,CAAC;EACH,KAAK,YACH,OAAO,IAAI,yBAAyB;GAClC,SAAS,EAAE,QAAQ,QAAQ,OAAO;GAClC,QAAQ;GACR;EACF,CAAC;CACL;AACF;AAEA,SAAS,WAAgB,QAAqB,MAA8B;CAC1E,OAAO,mBAA0B,OAAO;EACtC,OAAO,KAAK,OAAO,KAAK,SAAS,GAAG,KAAK,IAAI,CAAC;CAChD,CAAC;AACH;AAEA,SAAS,YAAY,QAAwC;CAC3D,OAAO,mBAAmB,OAAO,OAAO,MAAM,EAAE,CAAC;AACnD;AAEA,SAAS,uBAAuB,OAAuB;CACrD,MAAM,iBAAiB,KAAK;AAC9B;;;ACziBA,MAAM,6BACJ;AACF,MAAM,4BACJ;AASF,SAAS,YACP,MACA,SACA,SACoB;CACpB,MAAM,QAAQ,IAAI,MAAM,OAAO;CAC/B,OAAO,eAAe,OAAO,QAAQ;EACnC,OAAO;EACP,cAAc;CAChB,CAAC;CACD,OAAO,OAAO,OAAO,OAAO;EAC1B;EACA,UAAU;EACV,UAAU;EACV;EACA;CACF,CAAC;AACH;AAEA,SAAS,iBAA0C;CACjD,OAAO,EACL,CAAC,OAAO,iBAAiB;EACvB,OAAO,EACL,MAAM,OAAO;GACX,MAAM,YAAY,wBAAwB,0BAA0B;EACtE,EACF;CACF,EACF;AACF;AAEA,IAAM,4BAAN,MAAiE;CAC/D,WAAoB;CACpB,WAAoB;CAEpB,YAA+C;CAC/C,UAAU;CACV;CACA;CAEA,YAAY,SAAuC;EACjD,KAAKC,cAAc,SAAS;EAC5B,KAAKC,sBAAsB,SAAS;CACtC;CAEA,IAAI,QAA4C;EAC9C,IAAI,KAAKC,cAAc,MACrB,OAAO;EAET,IAAI,KAAKC,SACP,OAAO;EAET,OAAO;CACT;CAEA,mBAA+C;EAC7C,MAAM,WAAW,KAAKD;EACtB,IAAI,aAAa,MACf,MAAM,YAAY,wBAAwB,0BAA0B;EAEtE,OAAO;CACT;CAEA,MAAM,QAAQ,SAAyC;EACrD,IAAI,KAAKA,cAAc,MACrB,MAAM,YAAY,4BAA4B,2BAA2B,EACvE,aAAa,QAAQ,KACvB,CAAC;EAEH,KAAKA,YAAY,6BAA6B,SAAS,KAAKF,aAAa,EACvE,oBAAoB,KAAKC,oBAC3B,CAAC;EACD,KAAKE,UAAU;CACjB;CAEA,MAAM,oBAA4C;EAChD,MAAM,WAAW,KAAKC,iBAAiB;EACvC,MAAM,aAAa,MAAM,SAAS,kBAAkB;EACpD,OAAO,KAAKC,gBAAgB,YAAY,QAAQ;CAClD;;;;;;;;;CAUA,gBAAgB,YAA2B,UAAqD;EAC9F,MAAM,0BAAgC;GACpC,IAAI,KAAKH,cAAc,YAAY,SAAS,UAAU,UAAU;IAC9D,KAAKA,YAAY;IACjB,KAAKC,UAAU;GACjB;EACF;EACA,MAAM,UAAyB;GAC7B,kBAAkB,WAAW,iBAAiB,KAAK,UAAU;GAC7D,SAAS,WAAW,QAAQ,KAAK,UAAU;GAC3C,iBAAiB,WAAW,gBAAgB,KAAK,UAAU;GAC3D,OAAO,WAAW,MAAM,KAAK,UAAU;GACvC,SAAS,YAAY;IACnB,IAAI;KACF,MAAM,WAAW,QAAQ;IAC3B,UAAU;KACR,kBAAkB;IACpB;GACF;GACA,SAAS,OAAO,WAAqB;IACnC,IAAI;KACF,MAAM,WAAW,QAAQ,MAAM;IACjC,UAAU;KACR,kBAAkB;IACpB;GACF;EACF;EACA,IAAI,WAAW,SACb,QAAQ,UAAU,WAAW,QAAQ,KAAK,UAAU;EAEtD,OAAO;CACT;CAEA,MAAM,QAAuB;EAC3B,MAAM,WAAW,KAAKD;EACtB,IAAI,aAAa,MAAM;GACrB,KAAKA,YAAY;GACjB,MAAM,SAAS,MAAM;EACvB;EACA,KAAKC,UAAU;CACjB;CAEA,QAAuC,SAAgD;EACrF,MAAM,WAAW,KAAKD;EACtB,IAAI,aAAa,MACf,OAAO,eAAoB;EAE7B,OAAO,SAAS,QAAa,OAAO;CACtC;CAEA,gBACE,SACoB;EACpB,MAAM,WAAW,KAAKA;EACtB,IAAI,aAAa,MACf,OAAO,eAAoB;EAE7B,OAAO,SAAS,gBAAqB,OAAO;CAC9C;CAEA,MAAM,QAAQ,SAAuD;EACnE,MAAM,WAAW,KAAKE,iBAAiB;EACvC,MAAM,UAAU,SAAS;EACzB,IAAI,YAAY,KAAA,GACd,MAAM,YAAY,wBAAwB,0BAA0B;EAEtE,OAAO,QAAQ,KAAK,UAAU,OAAO;CACvC;CAEA,MAAM,MACJ,KACA,QAC8B;EAE9B,OADiB,KAAKA,iBACR,CAAC,CAAC,MAAW,KAAK,MAAM;CACxC;AACF;AAEA,MAAM,kCAKF;CACF,GAAG;CACH,OAAO,SAA8D;EACnE,OAAO,IAAI,0BAA0B,OAAO;CAC9C;AACF"}

package/package.json

@@ -1,32 +1,32 @@
 {
   "name": "@prisma-next/driver-postgres",
-  "version": "0.12.0",
+  "version": "0.13.0-dev.1",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "dependencies": {
-    "@prisma-next/contract": "0.12.0",
-    "@prisma-next/errors": "0.12.0",
-    "@prisma-next/framework-components": "0.12.0",
-    "@prisma-next/sql-contract": "0.12.0",
-    "@prisma-next/sql-errors": "0.12.0",
-    "@prisma-next/sql-operations": "0.12.0",
-    "@prisma-next/sql-relational-core": "0.12.0",
-    "@prisma-next/utils": "0.12.0",
+    "@prisma-next/contract": "0.13.0-dev.1",
+    "@prisma-next/errors": "0.13.0-dev.1",
+    "@prisma-next/framework-components": "0.13.0-dev.1",
+    "@prisma-next/sql-contract": "0.13.0-dev.1",
+    "@prisma-next/sql-errors": "0.13.0-dev.1",
+    "@prisma-next/sql-operations": "0.13.0-dev.1",
+    "@prisma-next/sql-relational-core": "0.13.0-dev.1",
+    "@prisma-next/utils": "0.13.0-dev.1",
     "arktype": "^2.2.0",
-    "pg": "8.20.0",
-    "pg-cursor": "^2.19.0"
+    "pg": "8.21.0",
+    "pg-cursor": "^2.20.0"
   },
   "devDependencies": {
-    "@prisma-next/test-utils": "0.12.0",
-    "@prisma-next/tsconfig": "0.12.0",
+    "@prisma-next/test-utils": "0.13.0-dev.1",
+    "@prisma-next/tsconfig": "0.13.0-dev.1",
     "@types/pg": "8.20.0",
     "@types/pg-cursor": "^2.4.6",
     "pg-mem": "^3.0.5",
-    "@prisma-next/tsdown": "0.12.0",
-    "tsdown": "0.22.0",
+    "@prisma-next/tsdown": "0.13.0-dev.1",
+    "tsdown": "0.22.1",
     "typescript": "5.9.3",
-    "vitest": "4.1.6"
+    "vitest": "4.1.8"
   },
   "peerDependencies": {
     "typescript": ">=5.9"

package/src/exports/control.ts

@@ -1,8 +1,6 @@
 import { errorRuntime } from '@prisma-next/errors/execution';
-import type {
-  ControlDriverDescriptor,
-  ControlDriverInstance,
-} from '@prisma-next/framework-components/control';
+import type { ControlDriverDescriptor } from '@prisma-next/framework-components/control';
+import type { SqlControlDriverInstance } from '@prisma-next/sql-contract/types';
 import { SqlQueryError } from '@prisma-next/sql-errors';
 import { ifDefined } from '@prisma-next/utils/defined';
 import { redactDatabaseUrl } from '@prisma-next/utils/redact-db-url';
@@ -10,11 +8,7 @@ import { Client } from 'pg';
 import { postgresDriverDescriptorMeta } from '../core/descriptor-meta';
 import { normalizePgError } from '../normalize-error';
 
-/**
- * Postgres control driver instance for control-plane operations.
- * Implements ControlDriverInstance<'sql', 'postgres'> for database queries.
- */
-export class PostgresControlDriver implements ControlDriverInstance<'sql', 'postgres'> {
+export class PostgresControlDriver implements SqlControlDriverInstance<'postgres'> {
   readonly familyId = 'sql' as const;
   readonly targetId = 'postgres' as const;