@warlock.js/cascade 5.24.0 → 5.26.0

package/esm/drivers/postgres/postgres-driver.d.mts

@@ -148,6 +148,8 @@ declare class PostgresDriver implements DriverContract {
    * @param listener - Callback function to invoke
    */
   on(event: string, listener: DriverEventListener): void;
+  /** Remove a previously registered driver event listener. */
+  off(event: string, listener: DriverEventListener): void;
   /**
    * Serialize data for storage in PostgreSQL.
    *
@@ -493,6 +495,13 @@ declare class PostgresDriver implements DriverContract {
    */
   private recordColumnTypes;
   query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<PostgresQueryResult<T>>;
+  /** Execute SQL and emit its public query event when the event is observed. */
+  private executePostgresQuery;
+  /**
+   * Emit a `query` event. An observer is never allowed to fail the query it
+   * observes, so a throwing listener is swallowed here.
+   */
+  private emitQueryEvent;
   /**
    * Emit an event to all registered listeners.
    *

package/esm/drivers/postgres/postgres-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-driver.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/postgres-driver.ts"],"mappings":"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"}
+{"version":3,"file":"postgres-driver.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/postgres-driver.ts"],"mappings":"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"}

package/esm/drivers/postgres/postgres-driver.mjs

@@ -309,6 +309,13 @@ var PostgresDriver = class {
 		if (!this._eventListeners.has(event)) this._eventListeners.set(event, /* @__PURE__ */ new Set());
 		this._eventListeners.get(event).add(listener);
 	}
+	/** Remove a previously registered driver event listener. */
+	off(event, listener) {
+		const listeners = this._eventListeners.get(event);
+		if (!listeners) return;
+		listeners.delete(listener);
+		if (listeners.size === 0) this._eventListeners.delete(event);
+	}
 	/**
 	* Serialize data for storage in PostgreSQL.
 	*
@@ -810,12 +817,12 @@ var PostgresDriver = class {
 			if (options?.isolationLevel) beginSql += ` ISOLATION LEVEL ${options.isolationLevel.toUpperCase()}`;
 			if (options?.readOnly) beginSql += " READ ONLY";
 			if (options?.deferrable) beginSql += " DEFERRABLE";
-			await client.query(beginSql);
+			await this.executePostgresQuery(() => client.query(beginSql), beginSql);
 			transactionStarted = true;
-			for (const [name, value] of settings) await client.query("SELECT set_config($1, $2, true)", [name, String(value)]);
+			for (const [name, value] of settings) await this.executePostgresQuery(() => client.query("SELECT set_config($1, $2, true)", [name, String(value)]), "SELECT set_config($1, $2, true)", [name, String(value)]);
 		} catch (error) {
 			if (transactionStarted) try {
-				await client.query("ROLLBACK");
+				await this.executePostgresQuery(() => client.query("ROLLBACK"), "ROLLBACK");
 			} catch {}
 			client.release(error instanceof Error ? error : new Error(String(error)));
 			throw error;
@@ -824,7 +831,7 @@ var PostgresDriver = class {
 			context: client,
 			commit: async () => {
 				try {
-					await client.query("COMMIT");
+					await this.executePostgresQuery(() => client.query("COMMIT"), "COMMIT");
 				} catch (error) {
 					client.release(error instanceof Error ? error : new Error(String(error)));
 					throw error;
@@ -833,7 +840,7 @@ var PostgresDriver = class {
 			},
 			rollback: async () => {
 				try {
-					await client.query("ROLLBACK");
+					await this.executePostgresQuery(() => client.query("ROLLBACK"), "ROLLBACK");
 				} catch (error) {
 					client.release(error instanceof Error ? error : new Error(String(error)));
 					throw error;
@@ -1066,8 +1073,8 @@ var PostgresDriver = class {
 					paramCount: params.length
 				}
 			});
-			if (txClient) result = await txClient.query(sql, params);
-			else result = await this.pool.query(sql, params);
+			if (txClient) result = await this.executePostgresQuery(() => txClient.query(sql, params), sql, params);
+			else result = await this.executePostgresQuery(() => this.pool.query(sql, params), sql, params);
 			if (this.config.logging) {
 				const duration = (performance.now() - startTime).toFixed(2);
 				log.success({
@@ -1100,6 +1107,47 @@ var PostgresDriver = class {
 			throw error;
 		}
 	}
+	/** Execute SQL and emit its public query event when the event is observed. */
+	async executePostgresQuery(execute, sql, bindings = []) {
+		if (!this._eventListeners.get("query")?.size) return execute();
+		const started = performance.now();
+		const startedAt = performance.timeOrigin + started;
+		let result;
+		try {
+			result = await execute();
+		} catch (error) {
+			this.emitQueryEvent({
+				connection: this.name,
+				driver: "postgres",
+				sql,
+				bindings,
+				durationMs: performance.now() - started,
+				startedAt,
+				error
+			});
+			throw error;
+		}
+		const event = {
+			connection: this.name,
+			driver: "postgres",
+			sql,
+			bindings,
+			durationMs: performance.now() - started,
+			startedAt
+		};
+		if (typeof result.rowCount === "number") event.rowCount = result.rowCount;
+		this.emitQueryEvent(event);
+		return result;
+	}
+	/**
+	* Emit a `query` event. An observer is never allowed to fail the query it
+	* observes, so a throwing listener is swallowed here.
+	*/
+	emitQueryEvent(event) {
+		try {
+			this.emit("query", event);
+		} catch {}
+	}
 	/**
 	* Emit an event to all registered listeners.
 	*