@atscript/db-postgres 0.1.153 → 0.1.154

package/dist/index.cjs

@@ -2361,6 +2361,10 @@ function createCustomTypes(pgTypes) {
 		return pgTypes.getTypeParser(oid, format);
 	} };
 }
+/** The warning logged for a pool client whose connection broke (`57P01`, `ECONNRESET`, …). */
+function lostConnectionMessage(err, where) {
+	return `[atscript/db-postgres] ${where} pool connection lost (${err.code ?? err.name}): ${err.message}`;
+}
 /**
 * {@link TPgDriver} implementation backed by `pg` (node-postgres).
 *
@@ -2387,6 +2391,12 @@ function createCustomTypes(pgTypes) {
 * const driver = new PgDriver(pool)
 * ```
 *
+* A broken pool connection (a terminated backend, failover, network reset) is
+* logged through `options.logger` instead of crashing the process (since
+* 0.1.154): idle clients of a pool the driver creates, and clients checked out
+* for a transaction. A pre-created `pg.Pool` is the caller's — attach your own
+* `pool.on('error', …)` listener, or an idle client's error crashes the process.
+*
 * Requires `pg` to be installed:
 * ```bash
 * pnpm add pg
@@ -2395,7 +2405,9 @@ function createCustomTypes(pgTypes) {
 var PgDriver = class {
 	pool;
 	poolInit;
-	constructor(poolOrConfig) {
+	logger;
+	constructor(poolOrConfig, options = {}) {
+		this.logger = options.logger ?? console;
 		if (typeof poolOrConfig === "object" && typeof poolOrConfig.query === "function") this.pool = poolOrConfig;
 		else this.poolInit = import("pg").then((pg) => {
 			const Pool = pg.default?.Pool ?? pg.Pool;
@@ -2409,6 +2421,7 @@ var PgDriver = class {
 				...poolOrConfig,
 				types: customTypes
 			});
+			this.pool.on("error", (err) => this.logger.warn(lostConnectionMessage(err, "idle")));
 			return this.pool;
 		});
 	}
@@ -2433,6 +2446,13 @@ var PgDriver = class {
 	}
 	async getConnection() {
 		const client = await (await this.getPool()).connect();
+		let lost;
+		const onError = (err) => {
+			if (lost) return;
+			lost = err;
+			this.logger.warn(lostConnectionMessage(err, "checked-out"));
+		};
+		client.on("error", onError);
 		return {
 			async run(sql, params) {
 				const result = await client.query(sql, sanitizeParams(params));
@@ -2451,7 +2471,8 @@ var PgDriver = class {
 				await client.query(sql);
 			},
 			release() {
-				client.release();
+				client.removeListener("error", onError);
+				client.release(lost);
 			}
 		};
 	}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreOptions, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateOptions, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TPrimaryKeyChange, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
+import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreOptions, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateOptions, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TPrimaryKeyChange, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
 import { TMetadataMap } from "@atscript/typescript/utils";
 import { TFilterVisitorOptions, TSqlFragment } from "@atscript/db-sql-tools";
 
@@ -442,6 +442,14 @@ declare class PostgresAdapter extends BaseDbAdapter {
 }
 //#endregion
 //#region src/pg-driver.d.ts
+/** Options of {@link PgDriver}. */
+interface TPgDriverOptions {
+  /**
+   * Receives a warning when a pool connection breaks — a terminated backend,
+   * failover or network reset (default `console`). See {@link PgDriver}.
+   */
+  logger?: Pick<TGenericLogger, "warn">;
+}
 /**
  * {@link TPgDriver} implementation backed by `pg` (node-postgres).
  *
@@ -468,6 +476,12 @@ declare class PostgresAdapter extends BaseDbAdapter {
  * const driver = new PgDriver(pool)
  * ```
  *
+ * A broken pool connection (a terminated backend, failover, network reset) is
+ * logged through `options.logger` instead of crashing the process (since
+ * 0.1.154): idle clients of a pool the driver creates, and clients checked out
+ * for a transaction. A pre-created `pg.Pool` is the caller's — attach your own
+ * `pool.on('error', …)` listener, or an idle client's error crashes the process.
+ *
  * Requires `pg` to be installed:
  * ```bash
  * pnpm add pg
@@ -476,7 +490,8 @@ declare class PostgresAdapter extends BaseDbAdapter {
 declare class PgDriver implements TPgDriver {
   private pool;
   private poolInit;
-  constructor(poolOrConfig: string | import("pg").Pool | import("pg").PoolConfig);
+  private readonly logger;
+  constructor(poolOrConfig: string | import("pg").Pool | import("pg").PoolConfig, options?: TPgDriverOptions);
   private getPool;
   run(sql: string, params?: unknown[]): Promise<TPgRunResult>;
   all<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
@@ -517,4 +532,4 @@ declare function buildWhere(filter: FilterExpr, opts?: TFilterVisitorOptions): T
  */
 declare function createAdapter(uri: string, options?: Record<string, unknown>): DbSpace;
 //#endregion
-export { PgDriver, PostgresAdapter, type TPgConnection, type TPgDriver, type TPgRunResult, type TSqlFragment, buildWhere, createAdapter };
+export { PgDriver, PostgresAdapter, type TPgConnection, type TPgDriver, type TPgDriverOptions, type TPgRunResult, type TSqlFragment, buildWhere, createAdapter };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreOptions, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateOptions, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TPrimaryKeyChange, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
+import { AggregateFn, BaseDbAdapter, BucketUnit, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertIgnoreOptions, TDbInsertIgnoreSlot, TDbInsertManyResult, TDbInsertResult, TDbObjectKind, TDbUpdateOptions, TDbUpdateResult, TEnsureTableOptions, TExistingColumn, TFieldOps, TGenericLogger, TPrimaryKeyChange, TReferencingForeignKey, TSearchIndexInfo, TSyncColumnResult, TValueFormatterPair, TViewCapability } from "@atscript/db";
 import { TFilterVisitorOptions, TSqlFragment } from "@atscript/db-sql-tools";
 import { TMetadataMap } from "@atscript/typescript/utils";
 
@@ -442,6 +442,14 @@ declare class PostgresAdapter extends BaseDbAdapter {
 }
 //#endregion
 //#region src/pg-driver.d.ts
+/** Options of {@link PgDriver}. */
+interface TPgDriverOptions {
+  /**
+   * Receives a warning when a pool connection breaks — a terminated backend,
+   * failover or network reset (default `console`). See {@link PgDriver}.
+   */
+  logger?: Pick<TGenericLogger, "warn">;
+}
 /**
  * {@link TPgDriver} implementation backed by `pg` (node-postgres).
  *
@@ -468,6 +476,12 @@ declare class PostgresAdapter extends BaseDbAdapter {
  * const driver = new PgDriver(pool)
  * ```
  *
+ * A broken pool connection (a terminated backend, failover, network reset) is
+ * logged through `options.logger` instead of crashing the process (since
+ * 0.1.154): idle clients of a pool the driver creates, and clients checked out
+ * for a transaction. A pre-created `pg.Pool` is the caller's — attach your own
+ * `pool.on('error', …)` listener, or an idle client's error crashes the process.
+ *
  * Requires `pg` to be installed:
  * ```bash
  * pnpm add pg
@@ -476,7 +490,8 @@ declare class PostgresAdapter extends BaseDbAdapter {
 declare class PgDriver implements TPgDriver {
   private pool;
   private poolInit;
-  constructor(poolOrConfig: string | import("pg").Pool | import("pg").PoolConfig);
+  private readonly logger;
+  constructor(poolOrConfig: string | import("pg").Pool | import("pg").PoolConfig, options?: TPgDriverOptions);
   private getPool;
   run(sql: string, params?: unknown[]): Promise<TPgRunResult>;
   all<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
@@ -517,4 +532,4 @@ declare function buildWhere(filter: FilterExpr, opts?: TFilterVisitorOptions): T
  */
 declare function createAdapter(uri: string, options?: Record<string, unknown>): DbSpace;
 //#endregion
-export { PgDriver, PostgresAdapter, type TPgConnection, type TPgDriver, type TPgRunResult, type TSqlFragment, buildWhere, createAdapter };
+export { PgDriver, PostgresAdapter, type TPgConnection, type TPgDriver, type TPgDriverOptions, type TPgRunResult, type TSqlFragment, buildWhere, createAdapter };

package/dist/index.mjs

@@ -2360,6 +2360,10 @@ function createCustomTypes(pgTypes) {
 		return pgTypes.getTypeParser(oid, format);
 	} };
 }
+/** The warning logged for a pool client whose connection broke (`57P01`, `ECONNRESET`, …). */
+function lostConnectionMessage(err, where) {
+	return `[atscript/db-postgres] ${where} pool connection lost (${err.code ?? err.name}): ${err.message}`;
+}
 /**
 * {@link TPgDriver} implementation backed by `pg` (node-postgres).
 *
@@ -2386,6 +2390,12 @@ function createCustomTypes(pgTypes) {
 * const driver = new PgDriver(pool)
 * ```
 *
+* A broken pool connection (a terminated backend, failover, network reset) is
+* logged through `options.logger` instead of crashing the process (since
+* 0.1.154): idle clients of a pool the driver creates, and clients checked out
+* for a transaction. A pre-created `pg.Pool` is the caller's — attach your own
+* `pool.on('error', …)` listener, or an idle client's error crashes the process.
+*
 * Requires `pg` to be installed:
 * ```bash
 * pnpm add pg
@@ -2394,7 +2404,9 @@ function createCustomTypes(pgTypes) {
 var PgDriver = class {
 	pool;
 	poolInit;
-	constructor(poolOrConfig) {
+	logger;
+	constructor(poolOrConfig, options = {}) {
+		this.logger = options.logger ?? console;
 		if (typeof poolOrConfig === "object" && typeof poolOrConfig.query === "function") this.pool = poolOrConfig;
 		else this.poolInit = import("pg").then((pg) => {
 			const Pool = pg.default?.Pool ?? pg.Pool;
@@ -2408,6 +2420,7 @@ var PgDriver = class {
 				...poolOrConfig,
 				types: customTypes
 			});
+			this.pool.on("error", (err) => this.logger.warn(lostConnectionMessage(err, "idle")));
 			return this.pool;
 		});
 	}
@@ -2432,6 +2445,13 @@ var PgDriver = class {
 	}
 	async getConnection() {
 		const client = await (await this.getPool()).connect();
+		let lost;
+		const onError = (err) => {
+			if (lost) return;
+			lost = err;
+			this.logger.warn(lostConnectionMessage(err, "checked-out"));
+		};
+		client.on("error", onError);
 		return {
 			async run(sql, params) {
 				const result = await client.query(sql, sanitizeParams(params));
@@ -2450,7 +2470,8 @@ var PgDriver = class {
 				await client.query(sql);
 			},
 			release() {
-				client.release();
+				client.removeListener("error", onError);
+				client.release(lost);
 			}
 		};
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-postgres",
-  "version": "0.1.153",
+  "version": "0.1.154",
   "description": "PostgreSQL adapter for @atscript/db with pg (node-postgres) driver support.",
   "keywords": [
     "atscript",
@@ -55,8 +55,8 @@
     "@atscript/typescript": "^0.1.103",
     "@uniqu/core": "^0.1.15",
     "pg": ">=8.0.0",
-    "@atscript/db-sql-tools": "^0.1.153",
-    "@atscript/db": "^0.1.153"
+    "@atscript/db": "^0.1.154",
+    "@atscript/db-sql-tools": "^0.1.154"
   },
   "peerDependenciesMeta": {
     "pg": {