@worker-manager/metrics 1.0.0 → 1.1.0

package/dist/keys.js

@@ -1,17 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HOUR_TIER = exports.GLOBAL_QUEUE = exports.DEFAULT_NAMESPACE = void 0;
+exports.DAY_PATTERN = exports.HOUR_TIER = exports.GLOBAL_QUEUE = exports.DEFAULT_NAMESPACE = void 0;
+exports.msToDay = msToDay;
 exports.minuteToDay = minuteToDay;
 exports.minuteToHour = minuteToHour;
 exports.shiftDay = shiftDay;
 exports.dayToStartMs = dayToStartMs;
+exports.dayToIndex = dayToIndex;
+exports.indexToDay = indexToDay;
 exports.dayRange = dayRange;
 exports.resolveNamespace = resolveNamespace;
 exports.metricsKeys = metricsKeys;
+exports.toDay = toDay;
 exports.DEFAULT_NAMESPACE = 'bull-board:metrics';
 exports.GLOBAL_QUEUE = '__global__';
 /** Marks the hourly rollup key so it can't be mistaken for a minute-level day hash. */
 exports.HOUR_TIER = 'hour';
+exports.DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
 const MS_PER_MINUTE = 60000;
 const MS_PER_DAY = 86400000;
 const MINUTES_PER_HOUR = 60;
@@ -36,6 +41,13 @@ function dayToStartMs(day) {
     const [y, m, d] = day.split('-').map(Number);
     return Date.UTC(y, m - 1, d);
 }
+/** Days since the epoch, the integer form of an ISO day that SQL buckets use. */
+function dayToIndex(day) {
+    return Math.floor(dayToStartMs(day) / MS_PER_DAY);
+}
+function indexToDay(index) {
+    return msToDay(index * MS_PER_DAY);
+}
 function dayRange(fromMs, toMs) {
     const days = [];
     let cursor = Date.UTC(new Date(fromMs).getUTCFullYear(), new Date(fromMs).getUTCMonth(), new Date(fromMs).getUTCDate());
@@ -73,4 +85,14 @@ function metricsKeys(namespace) {
         scanPattern: `${namespace}:*`,
     };
 }
+/** An ISO `YYYY-MM-DD` day, validated, from a day string or a Date (UTC). */
+function toDay(value) {
+    if (typeof value === 'string') {
+        if (!exports.DAY_PATTERN.test(value)) {
+            throw new Error(`Expected a YYYY-MM-DD day or a Date, got "${value}"`);
+        }
+        return value;
+    }
+    return value.toISOString().slice(0, 10);
+}
 //# sourceMappingURL=keys.js.map

package/dist/keys.js.map

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

package/dist/postgres/PostgresMetricsHistoryProvider.d.ts

@@ -0,0 +1,37 @@
+import type { Retention } from '../store';
+import { StoreHistoryProvider } from '../StoreHistoryProvider';
+import type { PostgresConnection } from './connection';
+import { PostgresMetricsStore } from './PostgresMetricsStore';
+interface RetentionOptions {
+    /** Should mirror the recorder's retention. Only used to bound the query span. */
+    retention?: Partial<Retention>;
+    retentionDays?: number;
+}
+export type PostgresMetricsHistoryProviderOptions = RetentionOptions & ({
+    /** A `pg.Pool`, a node-postgres pool config, or a connection string. */
+    connection: PostgresConnection;
+    /** Must match the recorder's store. See `PostgresMetricsStoreOptions`. */
+    schema?: string;
+    tablePrefix?: string;
+    /** See `PostgresMetricsStoreOptions.migrate`. */
+    migrate?: boolean;
+    onError?: (error: Error) => void;
+    store?: never;
+} | {
+    /** A store shared with the recorder. Left open on `disconnect()`. */
+    store: PostgresMetricsStore;
+    connection?: never;
+    schema?: never;
+    tablePrefix?: never;
+    migrate?: never;
+    onError?: never;
+});
+/** Serves the board's history charts and storage panel from the PostgreSQL store. */
+export declare class PostgresMetricsHistoryProvider extends StoreHistoryProvider {
+    readonly store: PostgresMetricsStore;
+    private readonly ownsStore;
+    constructor(opts: PostgresMetricsHistoryProviderOptions);
+    /** Ends the pool behind a store this provider built. A store or pool handed in is left open. */
+    disconnect(): Promise<void>;
+}
+export {};

package/dist/postgres/PostgresMetricsHistoryProvider.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresMetricsHistoryProvider = void 0;
+const MetricsRecorder_1 = require("../MetricsRecorder");
+const StoreHistoryProvider_1 = require("../StoreHistoryProvider");
+const PostgresMetricsStore_1 = require("./PostgresMetricsStore");
+/** Serves the board's history charts and storage panel from the PostgreSQL store. */
+class PostgresMetricsHistoryProvider extends StoreHistoryProvider_1.StoreHistoryProvider {
+    constructor(opts) {
+        var _a;
+        const store = (_a = opts.store) !== null && _a !== void 0 ? _a : new PostgresMetricsStore_1.PostgresMetricsStore({
+            connection: opts.connection,
+            schema: opts.schema,
+            tablePrefix: opts.tablePrefix,
+            migrate: opts.migrate,
+            onError: opts.onError,
+        });
+        super(store, (0, MetricsRecorder_1.resolveRetention)(opts));
+        this.store = store;
+        this.ownsStore = !opts.store;
+    }
+    /** Ends the pool behind a store this provider built. A store or pool handed in is left open. */
+    async disconnect() {
+        if (this.ownsStore) {
+            await this.store.close();
+        }
+    }
+}
+exports.PostgresMetricsHistoryProvider = PostgresMetricsHistoryProvider;
+//# sourceMappingURL=PostgresMetricsHistoryProvider.js.map

package/dist/postgres/PostgresMetricsHistoryProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresMetricsHistoryProvider.js","sourceRoot":"","sources":["../../src/postgres/PostgresMetricsHistoryProvider.ts"],"names":[],"mappings":";;;AAAA,wDAAsD;AAEtD,kEAA+D;AAE/D,iEAA8D;AAgC9D,qFAAqF;AACrF,MAAa,8BAA+B,SAAQ,2CAAoB;IAItE,YAAY,IAA2C;;QACrD,MAAM,KAAK,GACT,MAAA,IAAI,CAAC,KAAK,mCACV,IAAI,2CAAoB,CAAC;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QACL,KAAK,CAAC,KAAK,EAAE,IAAA,kCAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,gGAAgG;IAChG,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAzBD,wEAyBC"}

package/dist/postgres/PostgresMetricsStore.d.ts

@@ -0,0 +1,65 @@
+import type { CounterStore, HistoryAdministration, LatencyStorage, MetricsStore, Retention } from '../store';
+import { type PgPool, type PostgresConnection } from './connection';
+import { type MetricsTables } from './schema';
+export interface PostgresMetricsStoreOptions {
+    /** A `pg.Pool`, a node-postgres pool config, or a connection string. */
+    connection: PostgresConnection;
+    /**
+     * Schema holding the tables. Defaults to a `schema` key on a pool config (so the object
+     * given to BullMQ's PostgreSQL backend can be reused), then to `public`. Created on
+     * migration when missing.
+     */
+    schema?: string;
+    /** Prepended to every table name. Defaults to `bull_board_metrics_`. */
+    tablePrefix?: string;
+    /**
+     * Create or upgrade the tables before the first query. Off by default, in which case the
+     * first query checks the schema version instead and fails with instructions when the tables
+     * are missing: in deployments where the application role has no DDL rights, run
+     * `migratePostgresMetrics()` from a deploy step.
+     */
+    migrate?: boolean;
+    /**
+     * Errors from idle pooled connections of a pool this store created (a server restart, a
+     * dropped connection). Without a listener node-postgres would crash the process on them.
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * History in PostgreSQL, for boards whose queues live on BullMQ's PostgreSQL backend and have
+ * no Redis at all. Same tiers, retention, rollup and idempotency as the Redis store; see the
+ * package README for the schema and sizing.
+ */
+export declare class PostgresMetricsStore implements MetricsStore {
+    readonly pool: PgPool;
+    readonly tables: MetricsTables;
+    readonly jobClient: null;
+    private readonly owned;
+    private readonly shouldMigrate;
+    private readiness;
+    private closed;
+    private readonly ctx;
+    constructor(opts: PostgresMetricsStoreOptions);
+    /** Creates or upgrades the tables now. Idempotent and safe to race. */
+    migrate(): Promise<void>;
+    /**
+     * Memoized, but not on failure: a database that was unreachable at startup is retried on
+     * the next query instead of poisoning the store for the life of the process.
+     */
+    ready(): Promise<void>;
+    counterStore(retention: Retention): CounterStore;
+    latencyStore(retention: Retention): LatencyStorage;
+    administration(): HistoryAdministration;
+    /** Ends the pool if this store created it. A pool handed in is left to its owner. */
+    close(): Promise<void>;
+}
+export interface MigratePostgresMetricsOptions {
+    connection: PostgresConnection;
+    schema?: string;
+    tablePrefix?: string;
+}
+/**
+ * Deploy-step form of `migrate: true`: creates or upgrades the metrics tables and returns.
+ * A pool handed in is left open; one built from a config or string is ended afterwards.
+ */
+export declare function migratePostgresMetrics(opts: MigratePostgresMetricsOptions): Promise<void>;

package/dist/postgres/PostgresMetricsStore.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresMetricsStore = void 0;
+exports.migratePostgresMetrics = migratePostgresMetrics;
+const admin_1 = require("./admin");
+const connection_1 = require("./connection");
+const schema_1 = require("./schema");
+const stores_1 = require("./stores");
+/**
+ * History in PostgreSQL, for boards whose queues live on BullMQ's PostgreSQL backend and have
+ * no Redis at all. Same tiers, retention, rollup and idempotency as the Redis store; see the
+ * package README for the schema and sizing.
+ */
+class PostgresMetricsStore {
+    constructor(opts) {
+        var _a, _b, _c;
+        this.jobClient = null;
+        this.readiness = null;
+        this.closed = false;
+        const { pool, owned, schema } = (0, connection_1.resolvePool)(opts.connection, opts.onError);
+        this.pool = pool;
+        this.owned = owned;
+        try {
+            this.tables = (0, schema_1.metricsTables)((_b = (_a = opts.schema) !== null && _a !== void 0 ? _a : schema) !== null && _b !== void 0 ? _b : schema_1.DEFAULT_SCHEMA, (_c = opts.tablePrefix) !== null && _c !== void 0 ? _c : schema_1.DEFAULT_TABLE_PREFIX);
+        }
+        catch (error) {
+            if (owned) {
+                void pool.end().catch(() => undefined);
+            }
+            throw error;
+        }
+        this.shouldMigrate = opts.migrate === true;
+        this.ctx = { pool: this.pool, tables: this.tables, ready: () => this.ready() };
+    }
+    /** Creates or upgrades the tables now. Idempotent and safe to race. */
+    async migrate() {
+        await (0, schema_1.runMigrations)(this.pool, this.tables);
+        this.readiness = Promise.resolve();
+    }
+    /**
+     * Memoized, but not on failure: a database that was unreachable at startup is retried on
+     * the next query instead of poisoning the store for the life of the process.
+     */
+    ready() {
+        if (!this.readiness) {
+            const attempt = this.shouldMigrate
+                ? (0, schema_1.runMigrations)(this.pool, this.tables).then(() => undefined)
+                : (0, schema_1.assertMigrated)(this.pool, this.tables);
+            this.readiness = attempt.catch((error) => {
+                this.readiness = null;
+                throw error;
+            });
+        }
+        return this.readiness;
+    }
+    counterStore(retention) {
+        return new stores_1.PostgresCounterStore(this.ctx, retention);
+    }
+    latencyStore(retention) {
+        return new stores_1.PostgresLatencyStore(this.ctx, retention);
+    }
+    administration() {
+        return new admin_1.PostgresHistoryAdmin(this.ctx);
+    }
+    /** Ends the pool if this store created it. A pool handed in is left to its owner. */
+    async close() {
+        if (this.owned && !this.closed) {
+            this.closed = true;
+            await this.pool.end();
+        }
+        this.closed = true;
+    }
+}
+exports.PostgresMetricsStore = PostgresMetricsStore;
+/**
+ * Deploy-step form of `migrate: true`: creates or upgrades the metrics tables and returns.
+ * A pool handed in is left open; one built from a config or string is ended afterwards.
+ */
+async function migratePostgresMetrics(opts) {
+    const store = new PostgresMetricsStore(opts);
+    try {
+        await store.migrate();
+    }
+    finally {
+        await store.close();
+    }
+}
+//# sourceMappingURL=PostgresMetricsStore.js.map

package/dist/postgres/PostgresMetricsStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresMetricsStore.js","sourceRoot":"","sources":["../../src/postgres/PostgresMetricsStore.ts"],"names":[],"mappings":";;;AAsIA,wDAOC;AAtID,mCAA+C;AAC/C,6CAAiF;AAEjF,qCAOkB;AAClB,qCAAsE;AA2BtE;;;;GAIG;AACH,MAAa,oBAAoB;IAU/B,YAAY,IAAiC;;QAPpC,cAAS,GAAG,IAAI,CAAC;QAGlB,cAAS,GAAyB,IAAI,CAAC;QACvC,WAAM,GAAG,KAAK,CAAC;QAIrB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAA,wBAAW,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,IAAA,sBAAa,EACzB,MAAA,MAAA,IAAI,CAAC,MAAM,mCAAI,MAAM,mCAAI,uBAAc,EACvC,MAAA,IAAI,CAAC,WAAW,mCAAI,6BAAoB,CACzC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;QAC3C,IAAI,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;IACjF,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,OAAO;QACX,MAAM,IAAA,sBAAa,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa;gBAChC,CAAC,CAAC,IAAA,sBAAa,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;gBAC7D,CAAC,CAAC,IAAA,uBAAc,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACvC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,YAAY,CAAC,SAAoB;QAC/B,OAAO,IAAI,6BAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,YAAY,CAAC,SAAoB;QAC/B,OAAO,IAAI,6BAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,4BAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF;AAxED,oDAwEC;AAQD;;;GAGG;AACI,KAAK,UAAU,sBAAsB,CAAC,IAAmC;IAC9E,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/postgres/admin.d.ts

@@ -0,0 +1,31 @@
+import type { HistoryStats, PurgeOptions, PurgeResult } from '../HistoryAdmin';
+import type { HistoryAdministration } from '../store';
+import { type PgContext } from './context';
+/**
+ * `stats()` and `purge()` over the PostgreSQL tables, reported in the same shape as the Redis
+ * admin so the board's storage panel reads either one:
+ *
+ * - `keys` counts rows. A Redis key is a whole hash of buckets; a row here is one bucket, so
+ *   the numbers are larger for the same history and only comparable within one backend.
+ * - `bytes` is the tables' real on-disk footprint, `pg_total_relation_size` (heap, TOAST and
+ *   indexes), apportioned to queues and tiers by each row's `pg_column_size`. The parts add up
+ *   to what the tables occupy, rather than to the smaller sum of raw row sizes. Dead tuples
+ *   awaiting vacuum count until autovacuum reclaims them, as they do on disk.
+ * - `minutes` counts minute-tier rows, which is the same number as the Redis minute fields.
+ */
+export declare class PostgresHistoryAdmin implements HistoryAdministration {
+    private readonly ctx;
+    constructor(ctx: PgContext);
+    stats(): Promise<HistoryStats>;
+    /**
+     * One transaction. Purging a single queue first subtracts its completed and failed rows
+     * from the matching `__global__` rows, tier by tier, and drops the global rows that drain to
+     * zero or below, exactly as the Redis admin does; the latency rollups keep the queue's share
+     * until retention drops it, for the same reason (see `SUMMABLE_METRICS` there).
+     *
+     * `keysDeleted` counts minute and hour rows, the rows a Redis day-scoped key holds;
+     * `fieldsDeleted` counts day rows, the Redis totals-hash fields. Both include drained global
+     * rows.
+     */
+    purge(opts?: PurgeOptions): Promise<PurgeResult>;
+}

package/dist/postgres/admin.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresHistoryAdmin = void 0;
+const keys_1 = require("../keys");
+const context_1 = require("./context");
+/** Same reasoning as the Redis admin: only plain sums can have one queue's share taken out. */
+const SUMMABLE_METRICS = ['completed', 'failed'];
+function emptyTiers() {
+    return {
+        minute: { keys: 0, bytes: 0 },
+        hour: { keys: 0, bytes: 0 },
+        day: { keys: 0, bytes: 0 },
+    };
+}
+/**
+ * The day a row covers, as a SQL expression over its `tier` and `bucket` columns. `null` for
+ * the day tier, matching the Redis admin, where only minute and hour hashes carry a day.
+ */
+const ROW_DAY = `CASE tier WHEN 'minute' THEN bucket / 1440 WHEN 'hour' THEN bucket / 24 END`;
+/**
+ * `stats()` and `purge()` over the PostgreSQL tables, reported in the same shape as the Redis
+ * admin so the board's storage panel reads either one:
+ *
+ * - `keys` counts rows. A Redis key is a whole hash of buckets; a row here is one bucket, so
+ *   the numbers are larger for the same history and only comparable within one backend.
+ * - `bytes` is the tables' real on-disk footprint, `pg_total_relation_size` (heap, TOAST and
+ *   indexes), apportioned to queues and tiers by each row's `pg_column_size`. The parts add up
+ *   to what the tables occupy, rather than to the smaller sum of raw row sizes. Dead tuples
+ *   awaiting vacuum count until autovacuum reclaims them, as they do on disk.
+ * - `minutes` counts minute-tier rows, which is the same number as the Redis minute fields.
+ */
+class PostgresHistoryAdmin {
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async stats() {
+        await this.ctx.ready();
+        const { counters, histograms } = this.ctx.tables;
+        const [groups, days] = await Promise.all([
+            this.ctx.pool.query(`WITH sized AS (
+           SELECT 'counters' AS tbl, queue, tier,
+                  count(*) AS rows, sum(pg_column_size(c.*))::float8 AS size
+             FROM ${counters} c GROUP BY queue, tier
+           UNION ALL
+           SELECT 'histograms', queue, tier,
+                  count(*), sum(pg_column_size(h.*))::float8
+             FROM ${histograms} h GROUP BY queue, tier
+         )
+         SELECT s.queue, s.tier, s.rows,
+                CASE WHEN t.size > 0
+                     THEN round(s.size / t.size * t.bytes)
+                     ELSE 0 END AS bytes
+           FROM sized s
+           JOIN (SELECT tbl, sum(size) AS size,
+                        CASE tbl WHEN 'counters' THEN pg_total_relation_size($1::regclass)
+                                 ELSE pg_total_relation_size($2::regclass) END AS bytes
+                   FROM sized GROUP BY tbl) t ON t.tbl = s.tbl`, [counters, histograms]),
+            this.ctx.pool.query(`SELECT DISTINCT queue, ${ROW_DAY} AS day FROM ${counters} WHERE tier <> 'day'
+         UNION
+         SELECT DISTINCT queue, ${ROW_DAY} FROM ${histograms} WHERE tier <> 'day'`),
+        ]);
+        const byQueue = new Map();
+        const entry = (queue) => {
+            let found = byQueue.get(queue);
+            if (!found) {
+                found = { queue, keys: 0, bytes: 0, minutes: 0, days: [], tiers: emptyTiers() };
+                byQueue.set(queue, found);
+            }
+            return found;
+        };
+        const tiers = emptyTiers();
+        let keys = 0;
+        let bytes = 0;
+        let minutes = 0;
+        for (const row of groups.rows) {
+            const tier = row.tier;
+            const rows = Number(row.rows);
+            const size = Number(row.bytes);
+            const queue = entry(row.queue);
+            queue.keys += rows;
+            queue.bytes += size;
+            queue.tiers[tier].keys += rows;
+            queue.tiers[tier].bytes += size;
+            tiers[tier].keys += rows;
+            tiers[tier].bytes += size;
+            keys += rows;
+            bytes += size;
+            if (tier === 'minute') {
+                queue.minutes += rows;
+                minutes += rows;
+            }
+        }
+        let oldestDay = null;
+        let newestDay = null;
+        for (const row of days.rows) {
+            const day = (0, keys_1.indexToDay)(Number(row.day));
+            entry(row.queue).days.push(day);
+            if (oldestDay === null || day < oldestDay) {
+                oldestDay = day;
+            }
+            if (newestDay === null || day > newestDay) {
+                newestDay = day;
+            }
+        }
+        const queues = [...byQueue.values()].sort((a, b) => b.bytes - a.bytes);
+        for (const queue of queues) {
+            queue.days = [...new Set(queue.days)].sort();
+        }
+        return { keys, bytes, minutes, oldestDay, newestDay, tiers, queues };
+    }
+    /**
+     * One transaction. Purging a single queue first subtracts its completed and failed rows
+     * from the matching `__global__` rows, tier by tier, and drops the global rows that drain to
+     * zero or below, exactly as the Redis admin does; the latency rollups keep the queue's share
+     * until retention drops it, for the same reason (see `SUMMABLE_METRICS` there).
+     *
+     * `keysDeleted` counts minute and hour rows, the rows a Redis day-scoped key holds;
+     * `fieldsDeleted` counts day rows, the Redis totals-hash fields. Both include drained global
+     * rows.
+     */
+    async purge(opts = {}) {
+        var _a;
+        const before = opts.before === undefined ? null : (0, keys_1.dayToIndex)((0, keys_1.toDay)(opts.before));
+        const queue = (_a = opts.queue) !== null && _a !== void 0 ? _a : null;
+        const adjustGlobal = queue !== null && queue !== keys_1.GLOBAL_QUEUE;
+        const { counters, histograms } = this.ctx.tables;
+        const scope = `($1::text IS NULL OR queue = $1)
+      AND ($2::bigint IS NULL OR coalesce(${ROW_DAY}, bucket) < $2)`;
+        return (0, context_1.inTransaction)(this.ctx, async (client) => {
+            const result = { keysDeleted: 0, fieldsDeleted: 0 };
+            const tally = (tier, count) => {
+                if (tier === 'day') {
+                    result.fieldsDeleted += count;
+                }
+                else {
+                    result.keysDeleted += count;
+                }
+            };
+            const { rows: removed } = await client.query(`WITH doomed AS (
+           DELETE FROM ${counters} WHERE ${scope}
+           RETURNING metric, tier, bucket, value
+         ),
+         drained AS (
+           UPDATE ${counters} g SET value = g.value - d.value
+             FROM doomed d
+            WHERE $3 AND g.queue = $4 AND g.metric = d.metric AND g.tier = d.tier
+              AND g.bucket = d.bucket AND d.metric = ANY($5::text[]) AND d.value <> 0
+           RETURNING g.metric, g.tier, g.bucket, g.value
+         )
+         SELECT 'doomed' AS kind, tier, count(*) AS n, NULL::text[] AS metrics,
+                NULL::bigint[] AS buckets
+           FROM doomed GROUP BY tier
+         UNION ALL
+         SELECT 'drained', tier, count(*), array_agg(metric), array_agg(bucket)
+           FROM drained WHERE value <= 0 GROUP BY tier`, [queue, before, adjustGlobal, keys_1.GLOBAL_QUEUE, SUMMABLE_METRICS]);
+            for (const row of removed) {
+                if (row.kind === 'doomed') {
+                    tally(row.tier, Number(row.n));
+                    continue;
+                }
+                // The recorder never writes a zero bucket, so a leftover zero would read as
+                // recorded-but-idle instead of not recorded.
+                const { rowCount } = await client.query(`DELETE FROM ${counters} g
+             USING unnest($2::text[], $3::bigint[]) AS d(metric, bucket)
+            WHERE g.queue = $1 AND g.tier = $4 AND g.metric = d.metric AND g.bucket = d.bucket`, [keys_1.GLOBAL_QUEUE, row.metrics, row.buckets, row.tier]);
+                tally(row.tier, rowCount !== null && rowCount !== void 0 ? rowCount : 0);
+            }
+            const { rows: latency } = await client.query(`WITH doomed AS (DELETE FROM ${histograms} WHERE ${scope} RETURNING tier)
+         SELECT tier, count(*) AS n FROM doomed GROUP BY tier`, [queue, before]);
+            for (const row of latency) {
+                tally(row.tier, Number(row.n));
+            }
+            return result;
+        });
+    }
+}
+exports.PostgresHistoryAdmin = PostgresHistoryAdmin;
+//# sourceMappingURL=admin.js.map

package/dist/postgres/admin.js.map

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

package/dist/postgres/connection.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The slice of node-postgres this package uses, declared structurally so that the published
+ * types never name `pg`: a Redis-only install has neither `pg` nor `@types/pg`, and must not
+ * need them to compile.
+ */
+export interface PgQueryResult {
+    rows: Record<string, any>[];
+    rowCount?: number | null;
+}
+export interface PgQueryable {
+    query(text: string, values?: unknown[]): Promise<PgQueryResult>;
+}
+export interface PgPoolClient extends PgQueryable {
+    release(error?: Error | boolean): void;
+}
+/** A `pg.Pool`, or anything shaped like one. */
+export interface PgPool extends PgQueryable {
+    connect(): Promise<PgPoolClient>;
+    end(): Promise<void>;
+    on?(event: 'error', listener: (error: Error) => void): unknown;
+}
+/**
+ * A node-postgres pool config (`connectionString`, `host`, `max`, `ssl`, ...). A `schema` key
+ * is accepted too, so the object handed to BullMQ's PostgreSQL backend can be reused as is;
+ * it is lifted out rather than passed to the pool.
+ */
+export interface PostgresPoolConfig {
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string | (() => string | Promise<string>);
+    database?: string;
+    max?: number;
+    schema?: string;
+    [option: string]: unknown;
+}
+/**
+ * Mirrors the ergonomics of BullMQ v6's PostgreSQL connection option: an existing pool, a
+ * pool config, or a connection string.
+ */
+export type PostgresConnection = PgPool | PostgresPoolConfig | string;
+/**
+ * Schema names and table prefixes end up inside DDL, where they cannot be bound as
+ * parameters, so they are held to plain identifiers and always quoted.
+ */
+export declare function quoteIdentifier(name: string): string;
+export declare function isPool(connection: unknown): connection is PgPool;
+export declare function resolvePool(connection: PostgresConnection, onError?: (error: Error) => void): {
+    pool: PgPool;
+    owned: boolean;
+    schema: string | undefined;
+};

package/dist/postgres/connection.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quoteIdentifier = quoteIdentifier;
+exports.isPool = isPool;
+exports.resolvePool = resolvePool;
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+ * Schema names and table prefixes end up inside DDL, where they cannot be bound as
+ * parameters, so they are held to plain identifiers and always quoted.
+ */
+function quoteIdentifier(name) {
+    if (!IDENTIFIER.test(name) || name.length > 63) {
+        throw new Error(`Invalid PostgreSQL identifier ${JSON.stringify(name)}: use letters, digits and ` +
+            'underscores, starting with a letter or underscore, at most 63 characters.');
+    }
+    return `"${name}"`;
+}
+function isPool(connection) {
+    const candidate = connection;
+    return (!!candidate &&
+        typeof candidate.connect === 'function' &&
+        typeof candidate.query === 'function' &&
+        typeof candidate.end === 'function');
+}
+/**
+ * `pg` is an optional peer dependency, so it is required only here, on the first PostgreSQL
+ * store that has to build its own pool. Handing in a pool never loads it.
+ */
+function loadPg() {
+    try {
+        // oxlint-disable-next-line typescript/no-require-imports
+        return require('pg');
+    }
+    catch {
+        throw new Error("PostgreSQL metrics storage needs the optional 'pg' package. Install it with " +
+            '`npm install pg`, or pass an existing pg.Pool as `connection`.');
+    }
+}
+function resolvePool(connection, onError) {
+    var _a;
+    if (isPool(connection)) {
+        return { pool: connection, owned: false, schema: undefined };
+    }
+    const { schema, ...config } = typeof connection === 'string'
+        ? { connectionString: connection }
+        : connection;
+    const { Pool } = loadPg();
+    const pool = new Pool(config);
+    // node-postgres emits `error` for a pooled client that dies while idle (a server restart, a
+    // dropped connection). Unhandled, that event takes the whole process down with it.
+    (_a = pool.on) === null || _a === void 0 ? void 0 : _a.call(pool, 'error', (error) => onError === null || onError === void 0 ? void 0 : onError(error));
+    return { pool, owned: true, schema };
+}
+//# sourceMappingURL=connection.js.map

package/dist/postgres/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/postgres/connection.ts"],"names":[],"mappings":";;AAsDA,0CAQC;AAED,wBAQC;AAkBD,kCAiBC;AA3DD,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAE9C;;;GAGG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,4BAA4B;YAC/E,2EAA2E,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,IAAI,GAAG,CAAC;AACrB,CAAC;AAED,SAAgB,MAAM,CAAC,UAAmB;IACxC,MAAM,SAAS,GAAG,UAAoC,CAAC;IACvD,OAAO,CACL,CAAC,CAAC,SAAS;QACX,OAAO,SAAS,CAAC,OAAO,KAAK,UAAU;QACvC,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU;QACrC,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,CACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM;IACb,IAAI,CAAC;QACH,yDAAyD;QACzD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,8EAA8E;YAC5E,gEAAgE,CACnE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAgB,WAAW,CACzB,UAA8B,EAC9B,OAAgC;;IAEhC,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GACzB,OAAO,UAAU,KAAK,QAAQ;QAC5B,CAAC,CAAE,EAAE,gBAAgB,EAAE,UAAU,EAAyB;QAC1D,CAAC,CAAC,UAAU,CAAC;IACjB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,4FAA4F;IAC5F,mFAAmF;IACnF,MAAA,IAAI,CAAC,EAAE,qDAAG,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,KAAK,CAAC,CAAC,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC"}