@agendajs/postgres-backend 2.0.0 → 3.0.1

package/README.md

@@ -155,6 +155,44 @@ CREATE INDEX agenda_jobs_next_run_at_idx
   ON agenda_jobs (next_run_at) WHERE next_run_at IS NOT NULL;
 ```
 
+## Job Logging
+
+PostgresBackend includes a built-in `PostgresJobLogger` that stores structured job lifecycle events in a dedicated table (`agenda_logs` by default). The logger is lightweight and only creates its table on first use.
+
+### Automatic Usage
+
+When you enable logging in Agenda, the backend's built-in logger is used automatically:
+
+```typescript
+const agenda = new Agenda({
+  backend: new PostgresBackend({ connectionString: 'postgresql://...' }),
+  logging: true  // Uses PostgresJobLogger automatically
+});
+```
+
+### Standalone Usage
+
+You can also use `PostgresJobLogger` independently — for example, to log to PostgreSQL while using a different backend for storage:
+
+```typescript
+import { PostgresJobLogger } from '@agendajs/postgres-backend';
+import { Pool } from 'pg';
+
+const logger = new PostgresJobLogger({
+  pool: new Pool({ connectionString: 'postgresql://...' }),
+  logTableName: 'agenda_logs'       // Optional: table name (default: 'agenda_logs')
+});
+
+// Use with any backend
+import { MongoBackend } from '@agendajs/mongo-backend';
+const agenda = new Agenda({
+  backend: new MongoBackend({ mongo: db }),
+  logging: logger
+});
+```
+
+See the [Agenda README](https://github.com/agenda/agenda#persistent-job-logging) for full logging documentation.
+
 ## Manual Schema Management
 
 If you prefer to manage the schema yourself (set `ensureSchema: false`):

package/dist/PostgresBackend.d.ts

@@ -1,4 +1,4 @@
-import type { AgendaBackend, JobRepository, NotificationChannel } from 'agenda';
+import type { AgendaBackend, JobRepository, NotificationChannel, JobLogger } from 'agenda';
 import type { PostgresBackendConfig } from './types.js';
 /**
  * PostgreSQL backend for Agenda
@@ -41,6 +41,7 @@ export declare class PostgresBackend implements AgendaBackend {
     readonly name = "PostgreSQL";
     private _repository;
     private _notificationChannel?;
+    private _logger;
     private config;
     private _ownsConnection;
     constructor(config: PostgresBackendConfig);
@@ -53,6 +54,11 @@ export declare class PostgresBackend implements AgendaBackend {
      * True if created from connectionString/poolConfig, false if pool was passed in.
      */
     get ownsConnection(): boolean;
+    /**
+     * The job logger for persistent event logging.
+     * Always available; Agenda decides whether to activate it via its `logging` config.
+     */
+    get logger(): JobLogger;
     /**
      * The notification channel for real-time notifications via LISTEN/NOTIFY
      * Returns undefined if notifications are disabled

package/dist/PostgresBackend.js

@@ -1,5 +1,6 @@
 import debug from 'debug';
 import { PostgresJobRepository } from './PostgresJobRepository.js';
+import { PostgresJobLogger } from './PostgresJobLogger.js';
 import { PostgresNotificationChannel } from './PostgresNotificationChannel.js';
 const log = debug('agenda:postgres:backend');
 /**
@@ -43,6 +44,7 @@ export class PostgresBackend {
     name = 'PostgreSQL';
     _repository;
     _notificationChannel;
+    _logger;
     config;
     _ownsConnection;
     constructor(config) {
@@ -60,6 +62,11 @@ export class PostgresBackend {
                 }
             });
         }
+        // Always create the logger (lightweight; only initializes on first use when Agenda activates it)
+        this._logger = new PostgresJobLogger({
+            tableName: config.logTableName,
+            ensureSchema: config.ensureSchema
+        });
         log('PostgresBackend created with config: %O', {
             tableName: config.tableName || 'agenda_jobs',
             channelName: config.channelName || 'agenda_jobs',
@@ -81,6 +88,13 @@ export class PostgresBackend {
     get ownsConnection() {
         return this._ownsConnection;
     }
+    /**
+     * The job logger for persistent event logging.
+     * Always available; Agenda decides whether to activate it via its `logging` config.
+     */
+    get logger() {
+        return this._logger;
+    }
     /**
      * The notification channel for real-time notifications via LISTEN/NOTIFY
      * Returns undefined if notifications are disabled
@@ -103,6 +117,8 @@ export class PostgresBackend {
         if (this._notificationChannel) {
             this._notificationChannel.setPool(this._repository.getPool());
         }
+        // Initialize the job logger with the shared pool
+        await this._logger.setPool(this._repository.getPool());
         // Note: notification channel is connected by Agenda.start()
         // when it's needed, so we don't connect it here
         log('PostgresBackend connected');

package/dist/PostgresBackend.js.map

@@ -1 +1 @@
-{"version":3,"file":"PostgresBackend.js","sourceRoot":"","sources":["../src/PostgresBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAG/E,MAAM,GAAG,GAAG,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,eAAe;IAClB,IAAI,GAAG,YAAY,CAAC;IAErB,WAAW,CAAwB;IACnC,oBAAoB,CAA+B;IACnD,MAAM,CAAwB;IAC9B,eAAe,CAAU;IAEjC,YAAY,MAA6B;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,6DAA6D;QAC7D,IAAI,CAAC,eAAe,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAEpC,oBAAoB;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAErD,gDAAgD;QAChD,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;YAClC,IAAI,CAAC,oBAAoB,GAAG,IAAI,2BAA2B,CAAC;gBAC3D,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE;oBACV,OAAO,EAAE,IAAI;iBACb;aACD,CAAC,CAAC;QACJ,CAAC;QAED,GAAG,CAAC,yCAAyC,EAAE;YAC9C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,aAAa;YAC5C,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,aAAa;YAChD,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI;YACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,KAAK;YAC1D,cAAc,EAAE,IAAI,CAAC,eAAe;SACpC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,cAAc;QACjB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,IAAI,mBAAmB;QACtB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO;QACZ,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAElC,qDAAqD;QACrD,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAEjC,wDAAwD;QACxD,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/B,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,4DAA4D;QAC5D,gDAAgD;QAEhD,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACf,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAErC,wDAAwD;QACxD,mDAAmD;QACnD,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAEpC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IACrC,CAAC;CACD"}
+{"version":3,"file":"PostgresBackend.js","sourceRoot":"","sources":["../src/PostgresBackend.ts"],"names":[],"mappings":"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"}

package/dist/PostgresJobLogger.d.ts

@@ -0,0 +1,57 @@
+import type { Pool } from 'pg';
+import type { JobLogger, JobLogEntry, JobLogQuery, JobLogQueryResult } from 'agenda';
+/**
+ * SQL schema for the job logs table.
+ */
+export declare function getCreateLogsTableSQL(tableName: string): string;
+/**
+ * SQL indexes for the job logs table.
+ */
+export declare function getCreateLogsIndexesSQL(tableName: string): string[];
+/**
+ * PostgreSQL implementation of JobLogger.
+ * Stores job lifecycle events in a dedicated PostgreSQL table.
+ *
+ * @example
+ * ```typescript
+ * // Via backend (automatic connection sharing):
+ * import { PostgresBackend } from '@agendajs/postgres-backend';
+ *
+ * const backend = new PostgresBackend({
+ *   connectionString: 'postgresql://...',
+ *   logging: true // enables PostgresJobLogger with 'agenda_logs' table
+ * });
+ *
+ * // Standalone (e.g., log to Postgres while using Mongo for storage):
+ * import { PostgresJobLogger } from '@agendajs/postgres-backend';
+ * import { Pool } from 'pg';
+ *
+ * const logger = new PostgresJobLogger({ pool: new Pool({ connectionString: '...' }) });
+ * const agenda = new Agenda({
+ *   backend: new MongoBackend({ address: 'mongodb://...' }),
+ *   logging: logger
+ * });
+ * ```
+ */
+export declare class PostgresJobLogger implements JobLogger {
+    private pool;
+    private readonly tableName;
+    private readonly ensureSchema;
+    private initialized;
+    constructor(options?: {
+        pool?: Pool;
+        tableName?: string;
+        ensureSchema?: boolean;
+    } | string);
+    /**
+     * Set the pool and initialize the table schema.
+     * Called by PostgresBackend after the repository connects,
+     * or automatically when a pool is provided in the constructor.
+     */
+    setPool(pool: Pool): Promise<void>;
+    private ensureInitialized;
+    log(entry: Omit<JobLogEntry, '_id'>): Promise<void>;
+    getLogs(query?: JobLogQuery): Promise<JobLogQueryResult>;
+    clearLogs(query?: JobLogQuery): Promise<number>;
+    private buildWhere;
+}

package/dist/PostgresJobLogger.js

@@ -0,0 +1,224 @@
+import debug from 'debug';
+const log = debug('agenda:postgres:logger');
+/**
+ * SQL schema for the job logs table.
+ */
+export function getCreateLogsTableSQL(tableName) {
+    return `
+		CREATE TABLE IF NOT EXISTS "${tableName}" (
+			id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+			timestamp TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+			level VARCHAR(10) NOT NULL,
+			event VARCHAR(30) NOT NULL,
+			job_id VARCHAR(255),
+			job_name VARCHAR(255) NOT NULL,
+			message TEXT NOT NULL,
+			duration INTEGER,
+			error TEXT,
+			fail_count INTEGER,
+			retry_delay INTEGER,
+			retry_attempt INTEGER,
+			agenda_name VARCHAR(255),
+			meta JSONB
+		);
+	`;
+}
+/**
+ * SQL indexes for the job logs table.
+ */
+export function getCreateLogsIndexesSQL(tableName) {
+    return [
+        `CREATE INDEX IF NOT EXISTS "${tableName}_timestamp_idx"
+		 ON "${tableName}" (timestamp DESC)`,
+        `CREATE INDEX IF NOT EXISTS "${tableName}_job_id_idx"
+		 ON "${tableName}" (job_id, timestamp DESC)`,
+        `CREATE INDEX IF NOT EXISTS "${tableName}_job_name_idx"
+		 ON "${tableName}" (job_name, timestamp DESC)`
+    ];
+}
+/**
+ * PostgreSQL implementation of JobLogger.
+ * Stores job lifecycle events in a dedicated PostgreSQL table.
+ *
+ * @example
+ * ```typescript
+ * // Via backend (automatic connection sharing):
+ * import { PostgresBackend } from '@agendajs/postgres-backend';
+ *
+ * const backend = new PostgresBackend({
+ *   connectionString: 'postgresql://...',
+ *   logging: true // enables PostgresJobLogger with 'agenda_logs' table
+ * });
+ *
+ * // Standalone (e.g., log to Postgres while using Mongo for storage):
+ * import { PostgresJobLogger } from '@agendajs/postgres-backend';
+ * import { Pool } from 'pg';
+ *
+ * const logger = new PostgresJobLogger({ pool: new Pool({ connectionString: '...' }) });
+ * const agenda = new Agenda({
+ *   backend: new MongoBackend({ address: 'mongodb://...' }),
+ *   logging: logger
+ * });
+ * ```
+ */
+export class PostgresJobLogger {
+    pool;
+    tableName;
+    ensureSchema;
+    initialized = false;
+    constructor(options) {
+        if (typeof options === 'string') {
+            // Legacy: constructor(tableName)
+            this.tableName = options;
+            this.ensureSchema = true;
+        }
+        else {
+            this.tableName = options?.tableName ?? 'agenda_logs';
+            this.ensureSchema = options?.ensureSchema ?? true;
+            if (options?.pool) {
+                this.pool = options.pool;
+            }
+        }
+    }
+    /**
+     * Set the pool and initialize the table schema.
+     * Called by PostgresBackend after the repository connects,
+     * or automatically when a pool is provided in the constructor.
+     */
+    async setPool(pool) {
+        this.pool = pool;
+        await this.ensureInitialized();
+    }
+    async ensureInitialized() {
+        if (this.initialized || !this.pool || !this.ensureSchema)
+            return;
+        this.initialized = true;
+        log('creating schema for %s table', this.tableName);
+        const client = await this.pool.connect();
+        try {
+            await client.query(getCreateLogsTableSQL(this.tableName));
+            for (const sql of getCreateLogsIndexesSQL(this.tableName)) {
+                await client.query(sql);
+            }
+            log('schema created for %s table', this.tableName);
+        }
+        finally {
+            client.release();
+        }
+    }
+    async log(entry) {
+        if (!this.pool) {
+            log('pool not initialized, skipping log entry');
+            return;
+        }
+        await this.ensureInitialized();
+        await this.pool.query(`INSERT INTO "${this.tableName}"
+			 (timestamp, level, event, job_id, job_name, message, duration, error, fail_count, retry_delay, retry_attempt, agenda_name, meta)
+			 VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13)`, [
+            entry.timestamp,
+            entry.level,
+            entry.event,
+            entry.jobId ?? null,
+            entry.jobName,
+            entry.message,
+            entry.duration ?? null,
+            entry.error ?? null,
+            entry.failCount ?? null,
+            entry.retryDelay ?? null,
+            entry.retryAttempt ?? null,
+            entry.agendaName ?? null,
+            entry.meta ? JSON.stringify(entry.meta) : null
+        ]);
+    }
+    async getLogs(query) {
+        if (!this.pool) {
+            return { entries: [], total: 0 };
+        }
+        const { where, params } = this.buildWhere(query);
+        const sort = query?.sort === 'asc' ? 'ASC' : 'DESC';
+        const limit = query?.limit ?? 50;
+        const offset = query?.offset ?? 0;
+        const entriesQuery = `
+			SELECT * FROM "${this.tableName}"
+			${where}
+			ORDER BY timestamp ${sort}
+			LIMIT $${params.length + 1} OFFSET $${params.length + 2}
+		`;
+        const countQuery = `SELECT COUNT(*)::int as total FROM "${this.tableName}" ${where}`;
+        const [entriesResult, countResult] = await Promise.all([
+            this.pool.query(entriesQuery, [...params, limit, offset]),
+            this.pool.query(countQuery, params)
+        ]);
+        const entries = entriesResult.rows.map(row => ({
+            _id: row.id,
+            timestamp: row.timestamp,
+            level: row.level,
+            event: row.event,
+            jobId: row.job_id ?? undefined,
+            jobName: row.job_name,
+            message: row.message,
+            duration: row.duration ?? undefined,
+            error: row.error ?? undefined,
+            failCount: row.fail_count ?? undefined,
+            retryDelay: row.retry_delay ?? undefined,
+            retryAttempt: row.retry_attempt ?? undefined,
+            agendaName: row.agenda_name ?? undefined,
+            meta: row.meta ?? undefined
+        }));
+        return { entries, total: countResult.rows[0].total };
+    }
+    async clearLogs(query) {
+        if (!this.pool) {
+            return 0;
+        }
+        const { where, params } = this.buildWhere(query);
+        const result = await this.pool.query(`DELETE FROM "${this.tableName}" ${where}`, params);
+        return result.rowCount ?? 0;
+    }
+    buildWhere(query) {
+        if (!query)
+            return { where: '', params: [] };
+        const conditions = [];
+        const params = [];
+        let paramIndex = 1;
+        if (query.jobId) {
+            conditions.push(`job_id = $${paramIndex++}`);
+            params.push(query.jobId);
+        }
+        if (query.jobName) {
+            conditions.push(`job_name = $${paramIndex++}`);
+            params.push(query.jobName);
+        }
+        if (query.level) {
+            if (Array.isArray(query.level)) {
+                conditions.push(`level = ANY($${paramIndex++})`);
+                params.push(query.level);
+            }
+            else {
+                conditions.push(`level = $${paramIndex++}`);
+                params.push(query.level);
+            }
+        }
+        if (query.event) {
+            if (Array.isArray(query.event)) {
+                conditions.push(`event = ANY($${paramIndex++})`);
+                params.push(query.event);
+            }
+            else {
+                conditions.push(`event = $${paramIndex++}`);
+                params.push(query.event);
+            }
+        }
+        if (query.from) {
+            conditions.push(`timestamp >= $${paramIndex++}`);
+            params.push(query.from);
+        }
+        if (query.to) {
+            conditions.push(`timestamp <= $${paramIndex++}`);
+            params.push(query.to);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        return { where, params };
+    }
+}
+//# sourceMappingURL=PostgresJobLogger.js.map

package/dist/PostgresJobLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresJobLogger.js","sourceRoot":"","sources":["../src/PostgresJobLogger.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -26,7 +26,9 @@
  */
 export { PostgresBackend } from './PostgresBackend.js';
 export { PostgresJobRepository } from './PostgresJobRepository.js';
+export { PostgresJobLogger } from './PostgresJobLogger.js';
 export { PostgresNotificationChannel } from './PostgresNotificationChannel.js';
 export type { PostgresBackendConfig, PostgresJobRow } from './types.js';
 export type { PostgresNotificationChannelConfig } from './PostgresNotificationChannel.js';
 export { getCreateTableSQL, getCreateIndexesSQL, getDropTableSQL, getUpdateTimestampTriggerSQL } from './schema.js';
+export { getCreateLogsTableSQL, getCreateLogsIndexesSQL } from './PostgresJobLogger.js';

package/dist/index.js

@@ -26,7 +26,9 @@
  */
 export { PostgresBackend } from './PostgresBackend.js';
 export { PostgresJobRepository } from './PostgresJobRepository.js';
+export { PostgresJobLogger } from './PostgresJobLogger.js';
 export { PostgresNotificationChannel } from './PostgresNotificationChannel.js';
 // Re-export schema utilities for advanced use cases
 export { getCreateTableSQL, getCreateIndexesSQL, getDropTableSQL, getUpdateTimestampTriggerSQL } from './schema.js';
+export { getCreateLogsTableSQL, getCreateLogsIndexesSQL } from './PostgresJobLogger.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAK/E,oDAAoD;AACpD,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,4BAA4B,EAC5B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAK/E,oDAAoD;AACpD,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,4BAA4B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types.d.ts

@@ -23,6 +23,8 @@ export interface PostgresBackendConfig {
     };
     /** Disable LISTEN/NOTIFY notification channel (default: false) */
     disableNotifications?: boolean;
+    /** Table name for log entries (default: 'agenda_logs'). */
+    logTableName?: string;
 }
 /**
  * Internal row type matching PostgreSQL column names

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agendajs/postgres-backend",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "PostgreSQL backend for Agenda job scheduler with LISTEN/NOTIFY support",
   "type": "module",
   "main": "dist/index.js",
@@ -43,7 +43,7 @@
     "pg": "^8.13.0"
   },
   "peerDependencies": {
-    "agenda": "6.1.0"
+    "agenda": "6.2.1"
   },
   "devDependencies": {
     "@types/debug": "^4.1.12",
@@ -52,7 +52,7 @@
     "@vitest/coverage-v8": "^3.1.0",
     "tsx": "^4.21.0",
     "vitest": "^3.1.0",
-    "agenda": "6.1.0"
+    "agenda": "6.2.1"
   },
   "scripts": {
     "build": "tsc -b",