@prisma-next/driver-postgres 0.3.0-pr.94.3 → 0.3.0-pr.94.4

package/dist/control.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"control.mjs","names":["client: Client","postgresDriverDescriptor: ControlDriverDescriptor<'sql', 'postgres', PostgresControlDriver>"],"sources":["../src/exports/control.ts"],"sourcesContent":["import { errorRuntime } from '@prisma-next/core-control-plane/errors';\nimport type {\n  ControlDriverDescriptor,\n  ControlDriverInstance,\n} from '@prisma-next/core-control-plane/types';\nimport { SqlQueryError } from '@prisma-next/sql-errors';\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   * @deprecated Use targetId instead\n   */\n  readonly target = '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            ...(typeof code !== 'undefined' ? { code } : {}),\n            ...redacted,\n          },\n        });\n      }\n    },\n  };\n\nexport default postgresDriverDescriptor;\n"],"mappings":";;;;;;;;;;;AAeA,IAAa,wBAAb,MAAuF;CACrF,AAAS,WAAW;CACpB,AAAS,WAAW;;;;CAIpB,AAAS,SAAS;CAElB,YAAY,AAAiBA,QAAgB;EAAhB;;CAE7B,MAAM,MACJ,KACA,QACmC;AACnC,MAAI;AAEF,UAAO,EAAE,OADM,MAAM,KAAK,OAAO,MAAM,KAAK,OAAgC,EACtD,MAAe;WAC9B,OAAO;AACd,SAAM,iBAAiB,MAAM;;;CAIjC,MAAM,QAAuB;AAC3B,QAAM,KAAK,OAAO,KAAK;;;;;;AAO3B,MAAMC,2BACJ;CACE,GAAG;CACH,MAAM,OAAO,KAA6C;EACxD,MAAM,SAAS,IAAI,OAAO,EAAE,kBAAkB,KAAK,CAAC;AACpD,MAAI;AACF,SAAM,OAAO,SAAS;AACtB,UAAO,IAAI,sBAAsB,OAAO;WACjC,OAAO;GACd,MAAM,aAAa,iBAAiB,MAAM;GAC1C,MAAM,WAAW,kBAAkB,IAAI;AACvC,OAAI;AACF,UAAM,OAAO,KAAK;WACZ;GAIR,MAAM,mBAAmB,cAAc,GAAG,WAAW,GAAG,WAAW,WAAW;GAC9E,MAAM,YACJ,WAAW,cAAc,WAAW,QAC/B,WAAW,MAA6B,OACzC;GACN,MAAM,OAAO,oBAAoB;AAEjC,SAAM,aAAa,8BAA8B;IAC/C,KAAK,WAAW;IAChB,KAAK;IACL,MAAM;KACJ,GAAI,OAAO,SAAS,cAAc,EAAE,MAAM,GAAG,EAAE;KAC/C,GAAG;KACJ;IACF,CAAC;;;CAGP;AAEH,sBAAe"}
+{"version":3,"file":"control.mjs","names":["client: Client","postgresDriverDescriptor: ControlDriverDescriptor<'sql', 'postgres', PostgresControlDriver>"],"sources":["../src/exports/control.ts"],"sourcesContent":["import { errorRuntime } from '@prisma-next/core-control-plane/errors';\nimport type {\n  ControlDriverDescriptor,\n  ControlDriverInstance,\n} from '@prisma-next/core-control-plane/types';\nimport { SqlQueryError } from '@prisma-next/sql-errors';\nimport { redactDatabaseUrl } from '@prisma-next/utils/redact-db-url';\nimport { Client } from 'pg';\nimport { postgresDriverDescriptorMeta } from '../core/descriptor-meta.ts';\nimport { normalizePgError } from '../normalize-error.ts';\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   * @deprecated Use targetId instead\n   */\n  readonly target = '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            ...(typeof code !== 'undefined' ? { code } : {}),\n            ...redacted,\n          },\n        });\n      }\n    },\n  };\n\nexport default postgresDriverDescriptor;\n"],"mappings":";;;;;;;;;;;AAeA,IAAa,wBAAb,MAAuF;CACrF,AAAS,WAAW;CACpB,AAAS,WAAW;;;;CAIpB,AAAS,SAAS;CAElB,YAAY,AAAiBA,QAAgB;EAAhB;;CAE7B,MAAM,MACJ,KACA,QACmC;AACnC,MAAI;AAEF,UAAO,EAAE,OADM,MAAM,KAAK,OAAO,MAAM,KAAK,OAAgC,EACtD,MAAe;WAC9B,OAAO;AACd,SAAM,iBAAiB,MAAM;;;CAIjC,MAAM,QAAuB;AAC3B,QAAM,KAAK,OAAO,KAAK;;;;;;AAO3B,MAAMC,2BACJ;CACE,GAAG;CACH,MAAM,OAAO,KAA6C;EACxD,MAAM,SAAS,IAAI,OAAO,EAAE,kBAAkB,KAAK,CAAC;AACpD,MAAI;AACF,SAAM,OAAO,SAAS;AACtB,UAAO,IAAI,sBAAsB,OAAO;WACjC,OAAO;GACd,MAAM,aAAa,iBAAiB,MAAM;GAC1C,MAAM,WAAW,kBAAkB,IAAI;AACvC,OAAI;AACF,UAAM,OAAO,KAAK;WACZ;GAIR,MAAM,mBAAmB,cAAc,GAAG,WAAW,GAAG,WAAW,WAAW;GAC9E,MAAM,YACJ,WAAW,cAAc,WAAW,QAC/B,WAAW,MAA6B,OACzC;GACN,MAAM,OAAO,oBAAoB;AAEjC,SAAM,aAAa,8BAA8B;IAC/C,KAAK,WAAW;IAChB,KAAK;IACL,MAAM;KACJ,GAAI,OAAO,SAAS,cAAc,EAAE,MAAM,GAAG,EAAE;KAC/C,GAAG;KACJ;IACF,CAAC;;;CAGP;AAEH,sBAAe"}

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":["error: unknown","postgresRuntimeDriverDescriptor: RuntimeDriverDescriptor<\n  'sql',\n  'postgres',\n  PostgresRuntimeDriver\n>"],"sources":["../src/callback-to-promise.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 {\n  SqlDriver,\n  SqlExecuteRequest,\n  SqlExplainResult,\n  SqlQueryResult,\n} from '@prisma-next/sql-relational-core/ast';\nimport type {\n  Client,\n  QueryResult as PgQueryResult,\n  PoolClient,\n  Pool as PoolType,\n  QueryResultRow,\n} from 'pg';\nimport { Pool } from 'pg';\nimport Cursor from 'pg-cursor';\nimport { callbackToPromise } from './callback-to-promise';\nimport { isAlreadyConnectedError, isPostgresError, normalizePgError } from './normalize-error';\n\nexport type QueryResult<T extends QueryResultRow = QueryResultRow> = PgQueryResult<T>;\n\nexport interface PostgresDriverOptions {\n  readonly connect: { client: Client } | { pool: PoolType };\n  readonly cursor?:\n    | {\n        readonly batchSize?: number;\n        readonly disabled?: boolean;\n      }\n    | undefined;\n}\n\nconst DEFAULT_BATCH_SIZE = 100;\n\nclass PostgresDriverImpl implements SqlDriver {\n  private readonly pool: PoolType | undefined;\n  private readonly directClient: Client | undefined;\n  private readonly cursorBatchSize: number;\n  private readonly cursorDisabled: boolean;\n\n  constructor(options: PostgresDriverOptions) {\n    if ('client' in options.connect) {\n      this.directClient = options.connect.client;\n    } else if ('pool' in options.connect) {\n      this.pool = options.connect.pool;\n    } else {\n      throw new Error('PostgresDriver requires a pool or client');\n    }\n\n    this.cursorBatchSize = options.cursor?.batchSize ?? DEFAULT_BATCH_SIZE;\n    this.cursorDisabled = options.cursor?.disabled ?? false;\n  }\n\n  async connect(): Promise<void> {\n    // No-op: caller controls connecting the underlying client or pool\n  }\n\n  async *execute<Row = Record<string, unknown>>(request: SqlExecuteRequest): AsyncIterable<Row> {\n    const client = await this.acquireClient();\n    try {\n      if (!this.cursorDisabled) {\n        try {\n          for await (const row of this.executeWithCursor(client, request.sql, request.params)) {\n            yield row as Row;\n          }\n          return;\n        } catch (cursorError) {\n          if (!(cursorError instanceof Error)) {\n            throw cursorError;\n          }\n          // Check if this is a pg error - if so, normalize and throw\n          // Otherwise, fall back to buffered mode for cursor-specific errors\n          if (isPostgresError(cursorError)) {\n            throw normalizePgError(cursorError);\n          }\n          // Not a pg error - cursor-specific error, fall back to buffered mode\n        }\n      }\n\n      for await (const row of this.executeBuffered(client, request.sql, request.params)) {\n        yield row as Row;\n      }\n    } catch (error) {\n      throw normalizePgError(error);\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  async explain(request: SqlExecuteRequest): Promise<SqlExplainResult> {\n    const text = `EXPLAIN (FORMAT JSON) ${request.sql}`;\n    const client = await this.acquireClient();\n    try {\n      const result = await client.query(text, request.params as unknown[] | undefined);\n      return { rows: result.rows as ReadonlyArray<Record<string, unknown>> };\n    } catch (error) {\n      throw normalizePgError(error);\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.query(sql, params as unknown[] | undefined);\n      return result as unknown as SqlQueryResult<Row>;\n    } catch (error) {\n      throw normalizePgError(error);\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.pool) {\n      // Check if pool is already closed to avoid \"Called end on pool more than once\" error\n      // pg Pool has an 'ended' property that indicates if the pool has been closed\n      if (!(this.pool as { ended?: boolean }).ended) {\n        await this.pool.end();\n      }\n    }\n    if (this.directClient) {\n      const client = this.directClient as Client & { _ending?: boolean };\n      if (!client._ending) {\n        await client.end();\n      }\n    }\n  }\n\n  private async acquireClient(): Promise<PoolClient | Client> {\n    if (this.pool) {\n      return this.pool.connect();\n    }\n    if (this.directClient) {\n      // Check if client is already connected before attempting to connect\n      // This prevents hanging when the database only supports a single connection\n      // pg's Client has internal connection state that we can check\n      const client = this.directClient as Client & {\n        _ending?: boolean;\n        _connection?: unknown;\n      };\n      const isConnected =\n        client._connection !== undefined && client._connection !== null && !client._ending;\n\n      // Only connect if not already connected\n      // If caller provided a connected client (e.g., in tests), use it as-is\n      if (!isConnected) {\n        try {\n          await this.directClient.connect();\n        } catch (error: unknown) {\n          // If already connected, pg throws an error - ignore it and proceed\n          // Re-throw other errors (actual connection failures)\n          if (!isAlreadyConnectedError(error)) {\n            throw error;\n          }\n        }\n      }\n      return this.directClient;\n    }\n    throw new Error('PostgresDriver requires a pool or client');\n  }\n\n  private async releaseClient(client: PoolClient | Client): Promise<void> {\n    if (this.pool) {\n      (client as PoolClient).release();\n    }\n  }\n\n  private async *executeWithCursor(\n    client: PoolClient | Client,\n    sql: string,\n    params: readonly unknown[] | undefined,\n  ): AsyncIterable<Record<string, unknown>> {\n    const cursor = client.query(new Cursor(sql, params as unknown[] | undefined));\n\n    try {\n      while (true) {\n        const rows = await readCursor(cursor, this.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  ): AsyncIterable<Record<string, unknown>> {\n    const result = await client.query(sql, params as unknown[] | undefined);\n    for (const row of result.rows as Record<string, unknown>[]) {\n      yield row;\n    }\n  }\n}\n\nexport interface CreatePostgresDriverOptions {\n  readonly cursor?: PostgresDriverOptions['cursor'];\n  readonly poolFactory?: typeof Pool;\n}\n\nexport function createPostgresDriver(\n  connectionString: string,\n  options?: CreatePostgresDriverOptions,\n): SqlDriver {\n  const PoolImpl: typeof Pool = options?.poolFactory ?? Pool;\n  const pool = new PoolImpl({ connectionString });\n  return new PostgresDriverImpl({\n    connect: { pool },\n    cursor: options?.cursor,\n  });\n}\n\nexport function createPostgresDriverFromOptions(options: PostgresDriverOptions): SqlDriver {\n  return new PostgresDriverImpl(options);\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","import type {\n  RuntimeDriverDescriptor,\n  RuntimeDriverInstance,\n} from '@prisma-next/core-execution-plane/types';\nimport type { SqlDriver } from '@prisma-next/sql-relational-core/ast';\nimport { postgresDriverDescriptorMeta } from '../core/descriptor-meta';\nimport type { PostgresDriverOptions } from '../postgres-driver';\nimport { createPostgresDriverFromOptions } from '../postgres-driver';\n\n/**\n * Postgres runtime driver instance interface.\n * SqlDriver provides SQL-specific methods (execute, explain, close).\n * RuntimeDriverInstance provides target identification (familyId, targetId).\n * We use intersection type to combine both interfaces.\n */\nexport type PostgresRuntimeDriver = RuntimeDriverInstance<'sql', 'postgres'> & SqlDriver;\n\n/**\n * Postgres driver descriptor for runtime plane.\n */\nconst postgresRuntimeDriverDescriptor: RuntimeDriverDescriptor<\n  'sql',\n  'postgres',\n  PostgresRuntimeDriver\n> = {\n  ...postgresDriverDescriptorMeta,\n  create(options: PostgresDriverOptions): PostgresRuntimeDriver {\n    return createPostgresDriverFromOptions(options) as PostgresRuntimeDriver;\n  },\n};\n\nexport default postgresRuntimeDriverDescriptor;\nexport type {\n  CreatePostgresDriverOptions,\n  PostgresDriverOptions,\n  QueryResult,\n} from '../postgres-driver';\nexport { createPostgresDriver, createPostgresDriverFromOptions } from '../postgres-driver';\n"],"mappings":"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"}
+{"version":3,"file":"runtime.mjs","names":["error: unknown","postgresRuntimeDriverDescriptor: RuntimeDriverDescriptor<\n  'sql',\n  'postgres',\n  PostgresRuntimeDriver\n>"],"sources":["../src/callback-to-promise.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 {\n  SqlDriver,\n  SqlExecuteRequest,\n  SqlExplainResult,\n  SqlQueryResult,\n} from '@prisma-next/sql-relational-core/ast';\nimport type {\n  Client,\n  QueryResult as PgQueryResult,\n  PoolClient,\n  Pool as PoolType,\n  QueryResultRow,\n} from 'pg';\nimport { Pool } from 'pg';\nimport Cursor from 'pg-cursor';\nimport { callbackToPromise } from './callback-to-promise.ts';\nimport { isAlreadyConnectedError, isPostgresError, normalizePgError } from './normalize-error.ts';\n\nexport type QueryResult<T extends QueryResultRow = QueryResultRow> = PgQueryResult<T>;\n\nexport interface PostgresDriverOptions {\n  readonly connect: { client: Client } | { pool: PoolType };\n  readonly cursor?:\n    | {\n        readonly batchSize?: number;\n        readonly disabled?: boolean;\n      }\n    | undefined;\n}\n\nconst DEFAULT_BATCH_SIZE = 100;\n\nclass PostgresDriverImpl implements SqlDriver {\n  private readonly pool: PoolType | undefined;\n  private readonly directClient: Client | undefined;\n  private readonly cursorBatchSize: number;\n  private readonly cursorDisabled: boolean;\n\n  constructor(options: PostgresDriverOptions) {\n    if ('client' in options.connect) {\n      this.directClient = options.connect.client;\n    } else if ('pool' in options.connect) {\n      this.pool = options.connect.pool;\n    } else {\n      throw new Error('PostgresDriver requires a pool or client');\n    }\n\n    this.cursorBatchSize = options.cursor?.batchSize ?? DEFAULT_BATCH_SIZE;\n    this.cursorDisabled = options.cursor?.disabled ?? false;\n  }\n\n  async connect(): Promise<void> {\n    // No-op: caller controls connecting the underlying client or pool\n  }\n\n  async *execute<Row = Record<string, unknown>>(request: SqlExecuteRequest): AsyncIterable<Row> {\n    const client = await this.acquireClient();\n    try {\n      if (!this.cursorDisabled) {\n        try {\n          for await (const row of this.executeWithCursor(client, request.sql, request.params)) {\n            yield row as Row;\n          }\n          return;\n        } catch (cursorError) {\n          if (!(cursorError instanceof Error)) {\n            throw cursorError;\n          }\n          // Check if this is a pg error - if so, normalize and throw\n          // Otherwise, fall back to buffered mode for cursor-specific errors\n          if (isPostgresError(cursorError)) {\n            throw normalizePgError(cursorError);\n          }\n          // Not a pg error - cursor-specific error, fall back to buffered mode\n        }\n      }\n\n      for await (const row of this.executeBuffered(client, request.sql, request.params)) {\n        yield row as Row;\n      }\n    } catch (error) {\n      throw normalizePgError(error);\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  async explain(request: SqlExecuteRequest): Promise<SqlExplainResult> {\n    const text = `EXPLAIN (FORMAT JSON) ${request.sql}`;\n    const client = await this.acquireClient();\n    try {\n      const result = await client.query(text, request.params as unknown[] | undefined);\n      return { rows: result.rows as ReadonlyArray<Record<string, unknown>> };\n    } catch (error) {\n      throw normalizePgError(error);\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.query(sql, params as unknown[] | undefined);\n      return result as unknown as SqlQueryResult<Row>;\n    } catch (error) {\n      throw normalizePgError(error);\n    } finally {\n      await this.releaseClient(client);\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.pool) {\n      // Check if pool is already closed to avoid \"Called end on pool more than once\" error\n      // pg Pool has an 'ended' property that indicates if the pool has been closed\n      if (!(this.pool as { ended?: boolean }).ended) {\n        await this.pool.end();\n      }\n    }\n    if (this.directClient) {\n      const client = this.directClient as Client & { _ending?: boolean };\n      if (!client._ending) {\n        await client.end();\n      }\n    }\n  }\n\n  private async acquireClient(): Promise<PoolClient | Client> {\n    if (this.pool) {\n      return this.pool.connect();\n    }\n    if (this.directClient) {\n      // Check if client is already connected before attempting to connect\n      // This prevents hanging when the database only supports a single connection\n      // pg's Client has internal connection state that we can check\n      const client = this.directClient as Client & {\n        _ending?: boolean;\n        _connection?: unknown;\n      };\n      const isConnected =\n        client._connection !== undefined && client._connection !== null && !client._ending;\n\n      // Only connect if not already connected\n      // If caller provided a connected client (e.g., in tests), use it as-is\n      if (!isConnected) {\n        try {\n          await this.directClient.connect();\n        } catch (error: unknown) {\n          // If already connected, pg throws an error - ignore it and proceed\n          // Re-throw other errors (actual connection failures)\n          if (!isAlreadyConnectedError(error)) {\n            throw error;\n          }\n        }\n      }\n      return this.directClient;\n    }\n    throw new Error('PostgresDriver requires a pool or client');\n  }\n\n  private async releaseClient(client: PoolClient | Client): Promise<void> {\n    if (this.pool) {\n      (client as PoolClient).release();\n    }\n  }\n\n  private async *executeWithCursor(\n    client: PoolClient | Client,\n    sql: string,\n    params: readonly unknown[] | undefined,\n  ): AsyncIterable<Record<string, unknown>> {\n    const cursor = client.query(new Cursor(sql, params as unknown[] | undefined));\n\n    try {\n      while (true) {\n        const rows = await readCursor(cursor, this.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  ): AsyncIterable<Record<string, unknown>> {\n    const result = await client.query(sql, params as unknown[] | undefined);\n    for (const row of result.rows as Record<string, unknown>[]) {\n      yield row;\n    }\n  }\n}\n\nexport interface CreatePostgresDriverOptions {\n  readonly cursor?: PostgresDriverOptions['cursor'];\n  readonly poolFactory?: typeof Pool;\n}\n\nexport function createPostgresDriver(\n  connectionString: string,\n  options?: CreatePostgresDriverOptions,\n): SqlDriver {\n  const PoolImpl: typeof Pool = options?.poolFactory ?? Pool;\n  const pool = new PoolImpl({ connectionString });\n  return new PostgresDriverImpl({\n    connect: { pool },\n    cursor: options?.cursor,\n  });\n}\n\nexport function createPostgresDriverFromOptions(options: PostgresDriverOptions): SqlDriver {\n  return new PostgresDriverImpl(options);\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","import type {\n  RuntimeDriverDescriptor,\n  RuntimeDriverInstance,\n} from '@prisma-next/core-execution-plane/types';\nimport type { SqlDriver } from '@prisma-next/sql-relational-core/ast';\nimport { postgresDriverDescriptorMeta } from '../core/descriptor-meta.ts';\nimport type { PostgresDriverOptions } from '../postgres-driver.ts';\nimport { createPostgresDriverFromOptions } from '../postgres-driver.ts';\n\n/**\n * Postgres runtime driver instance interface.\n * SqlDriver provides SQL-specific methods (execute, explain, close).\n * RuntimeDriverInstance provides target identification (familyId, targetId).\n * We use intersection type to combine both interfaces.\n */\nexport type PostgresRuntimeDriver = RuntimeDriverInstance<'sql', 'postgres'> & SqlDriver;\n\n/**\n * Postgres driver descriptor for runtime plane.\n */\nconst postgresRuntimeDriverDescriptor: RuntimeDriverDescriptor<\n  'sql',\n  'postgres',\n  PostgresRuntimeDriver\n> = {\n  ...postgresDriverDescriptorMeta,\n  create(options: PostgresDriverOptions): PostgresRuntimeDriver {\n    return createPostgresDriverFromOptions(options) as PostgresRuntimeDriver;\n  },\n};\n\nexport default postgresRuntimeDriverDescriptor;\nexport type {\n  CreatePostgresDriverOptions,\n  PostgresDriverOptions,\n  QueryResult,\n} from '../postgres-driver.ts';\nexport { createPostgresDriver, createPostgresDriverFromOptions } from '../postgres-driver.ts';\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma-next/driver-postgres",
-  "version": "0.3.0-pr.94.3",
+  "version": "0.3.0-pr.94.4",
   "type": "module",
   "sideEffects": false,
   "engines": {
@@ -10,14 +10,14 @@
     "arktype": "^2.0.0",
     "pg": "8.16.3",
     "pg-cursor": "^2.10.5",
-    "@prisma-next/contract": "0.3.0-pr.94.3",
-    "@prisma-next/core-control-plane": "0.3.0-pr.94.3",
-    "@prisma-next/core-execution-plane": "0.3.0-pr.94.3",
-    "@prisma-next/sql-contract": "0.3.0-pr.94.3",
-    "@prisma-next/sql-errors": "0.3.0-pr.94.3",
-    "@prisma-next/sql-relational-core": "0.3.0-pr.94.3",
-    "@prisma-next/sql-operations": "0.3.0-pr.94.3",
-    "@prisma-next/utils": "0.3.0-pr.94.3"
+    "@prisma-next/contract": "0.3.0-pr.94.4",
+    "@prisma-next/core-control-plane": "0.3.0-pr.94.4",
+    "@prisma-next/core-execution-plane": "0.3.0-pr.94.4",
+    "@prisma-next/sql-contract": "0.3.0-pr.94.4",
+    "@prisma-next/sql-errors": "0.3.0-pr.94.4",
+    "@prisma-next/sql-operations": "0.3.0-pr.94.4",
+    "@prisma-next/sql-relational-core": "0.3.0-pr.94.4",
+    "@prisma-next/utils": "0.3.0-pr.94.4"
   },
   "devDependencies": {
     "@types/pg": "8.16.0",
@@ -26,9 +26,9 @@
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.16",
-    "@prisma-next/test-utils": "0.0.1",
     "@prisma-next/tsconfig": "0.0.0",
-    "@prisma-next/tsdown": "0.0.0"
+    "@prisma-next/tsdown": "0.0.0",
+    "@prisma-next/test-utils": "0.0.1"
   },
   "files": [
     "dist",

package/src/exports/control.ts

@@ -6,8 +6,8 @@ import type {
 import { SqlQueryError } from '@prisma-next/sql-errors';
 import { redactDatabaseUrl } from '@prisma-next/utils/redact-db-url';
 import { Client } from 'pg';
-import { postgresDriverDescriptorMeta } from '../core/descriptor-meta';
-import { normalizePgError } from '../normalize-error';
+import { postgresDriverDescriptorMeta } from '../core/descriptor-meta.ts';
+import { normalizePgError } from '../normalize-error.ts';
 
 /**
  * Postgres control driver instance for control-plane operations.

package/src/exports/runtime.ts

@@ -3,9 +3,9 @@ import type {
   RuntimeDriverInstance,
 } from '@prisma-next/core-execution-plane/types';
 import type { SqlDriver } from '@prisma-next/sql-relational-core/ast';
-import { postgresDriverDescriptorMeta } from '../core/descriptor-meta';
-import type { PostgresDriverOptions } from '../postgres-driver';
-import { createPostgresDriverFromOptions } from '../postgres-driver';
+import { postgresDriverDescriptorMeta } from '../core/descriptor-meta.ts';
+import type { PostgresDriverOptions } from '../postgres-driver.ts';
+import { createPostgresDriverFromOptions } from '../postgres-driver.ts';
 
 /**
  * Postgres runtime driver instance interface.
@@ -34,5 +34,5 @@ export type {
   CreatePostgresDriverOptions,
   PostgresDriverOptions,
   QueryResult,
-} from '../postgres-driver';
-export { createPostgresDriver, createPostgresDriverFromOptions } from '../postgres-driver';
+} from '../postgres-driver.ts';
+export { createPostgresDriver, createPostgresDriverFromOptions } from '../postgres-driver.ts';

package/src/postgres-driver.ts

@@ -13,8 +13,8 @@ import type {
 } from 'pg';
 import { Pool } from 'pg';
 import Cursor from 'pg-cursor';
-import { callbackToPromise } from './callback-to-promise';
-import { isAlreadyConnectedError, isPostgresError, normalizePgError } from './normalize-error';
+import { callbackToPromise } from './callback-to-promise.ts';
+import { isAlreadyConnectedError, isPostgresError, normalizePgError } from './normalize-error.ts';
 
 export type QueryResult<T extends QueryResultRow = QueryResultRow> = PgQueryResult<T>;