feat: expose Prisma driver timeout options

Author: jmgasper

packages/challenge-prisma-client/README.md

@@ -16,6 +16,19 @@ const activeCount = await client.challenge.count({
 await client.$disconnect();
 ```
 
+Callers that need bounded database work can pass PostgreSQL pool settings
+without constructing the Prisma 7 adapter themselves:
+
+```ts
+const client = createChallengePrismaClient(databaseUrl, {
+  driverOptions: {
+    connectionTimeoutMillis: 5000,
+    query_timeout: 5000,
+    statement_timeout: 5000,
+  },
+});
+```
+
 The client connects lazily. Applications own its lifecycle and must disconnect
 it during shutdown. An empty or non-string connection URL raises `TypeError`;
 Prisma reports its normal configuration and database errors during creation or

packages/challenge-prisma-client/factory.test.js

@@ -37,3 +37,32 @@ test('rejects an empty Challenge database connection string', () => {
     /Challenge database connection string is required/,
   );
 });
+
+/**
+ * Verifies driver timeout options reach the factory-owned PostgreSQL adapter
+ * without being forwarded as invalid generated PrismaClient options.
+ *
+ * @returns {Promise<void>} Resolves after the client is disconnected.
+ * @throws AssertionError when the adapter does not retain the driver options.
+ */
+test('passes bounded driver options to the PostgreSQL adapter', async () => {
+  const client = createChallengePrismaClient(
+    'postgresql://user:password@localhost:5432/challenges?schema=challenge',
+    {
+      driverOptions: {
+        connectionTimeoutMillis: 2500,
+        query_timeout: 4000,
+        statement_timeout: 4000,
+      },
+    },
+  );
+
+  assert.deepEqual(client._engineConfig.adapter.config, {
+    connectionString:
+      'postgresql://user:password@localhost:5432/challenges?schema=challenge',
+    connectionTimeoutMillis: 2500,
+    query_timeout: 4000,
+    statement_timeout: 4000,
+  });
+  await client.$disconnect();
+});

packages/challenge-prisma-client/index.d.ts

@@ -1,19 +1,23 @@
 export * from './generated';
 
 import { Prisma, PrismaClient } from './generated';
+import type { PoolConfig } from 'pg';
 
 /** Options accepted by the Challenge API external-client factory. */
 export type ChallengePrismaClientOptions = Omit<
   Prisma.PrismaClientOptions,
   'adapter' | 'accelerateUrl'
->;
+> & {
+  /** PostgreSQL driver pool settings such as connection/query timeouts. */
+  driverOptions?: Omit<PoolConfig, 'connectionString'>;
+};
 
 /**
  * Creates a lazily connected Prisma client for the Challenge API database.
  *
  * @param connectionString PostgreSQL URL, including an optional Prisma
  * `schema` query parameter.
- * @param options Optional Prisma logging, transaction, and omit settings.
+ * @param options Optional Prisma settings and PostgreSQL driver pool settings.
  * @returns A challenge-schema Prisma client. The caller owns its lifecycle and
  * must call `$disconnect()` during shutdown.
  * @throws TypeError when `connectionString` is not a non-empty string. Prisma

packages/challenge-prisma-client/index.js

@@ -29,9 +29,11 @@ function getPostgresSchema(connectionString) {
  * setup and connection-string schema handling inside this package.
  *
  * @param {string} connectionString PostgreSQL URL for the challenge database.
- * @param {import('./generated').Prisma.PrismaClientOptions} [options] Optional
- * Prisma logging, transaction, and omit settings. The factory owns `adapter`
- * and `accelerateUrl`, so any JavaScript values supplied for them are ignored.
+ * @param {import('./generated').Prisma.PrismaClientOptions &
+ * {driverOptions?: import('pg').PoolConfig}} [options] Optional Prisma logging,
+ * transaction, and omit settings plus PostgreSQL pool/timeout settings. The
+ * factory owns `adapter`, `accelerateUrl`, and the driver connection string, so
+ * JavaScript values supplied for them are ignored.
  * @returns {import('./generated').PrismaClient} A lazily connected challenge
  * Prisma client. The caller must invoke `$disconnect()` during shutdown.
  * @throws {TypeError} When `connectionString` is not a non-empty string.
@@ -43,13 +45,16 @@ function createChallengePrismaClient(connectionString, options = {}) {
     throw new TypeError('Challenge database connection string is required');
   }
 
-  const clientOptions = { ...options };
+  const { driverOptions: suppliedDriverOptions = {}, ...clientOptions } =
+    options;
+  const driverOptions = { ...suppliedDriverOptions };
   delete clientOptions.adapter;
   delete clientOptions.accelerateUrl;
+  delete driverOptions.connectionString;
 
   const schema = getPostgresSchema(connectionString);
   const adapter = new PrismaPg(
-    { connectionString },
+    { ...driverOptions, connectionString },
     schema ? { schema } : undefined,
   );