@worker-manager/metrics 1.1.0 → 9.10.1

package/dist/postgres/PostgresMetricsStore.js

@@ -1,88 +0,0 @@
-"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

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

package/dist/postgres/admin.d.ts

@@ -1,31 +0,0 @@
-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

@@ -1,178 +0,0 @@
-"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

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

package/dist/postgres/connection.d.ts

@@ -1,53 +0,0 @@
-/**
- * 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

@@ -1,54 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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"}

package/dist/postgres/context.d.ts

@@ -1,29 +0,0 @@
-import type { Retention } from '../store';
-import type { PgPool, PgPoolClient } from './connection';
-import type { MetricsTables } from './schema';
-/** What the PostgreSQL stores share: one pool, one set of tables, one readiness gate. */
-export interface PgContext {
-    pool: PgPool;
-    tables: MetricsTables;
-    /** Resolves once the tables are there, migrating first when the store was asked to. */
-    ready(): Promise<void>;
-}
-export declare function inTransaction<T>(ctx: PgContext, work: (client: PgPoolClient) => Promise<T>): Promise<T>;
-export declare function normalizeRetention(retention: Retention): Retention;
-/**
- * The SQL counterpart of the Redis TTLs and totals trimming: every tier drops the days older
- * than its own retention, counted back from `day`.
- *
- * Anchored on the day being written rather than on the wall clock, exactly as the Redis
- * scripts trim against the day of the write, and run by each writer on its first write and
- * then on the first write of every new day, so about once a day per process. The deletes
- * are range scans on the `(tier, bucket)` indexes. Sampler state past its expiry goes too:
- * a watermark outliving its queue is the unbounded-storage failure this package avoids.
- */
-export declare class RetentionPruner {
-    private readonly ctx;
-    private readonly retention;
-    private prunedFor;
-    constructor(ctx: PgContext, retention: Retention);
-    afterWrite(day: string): Promise<void>;
-}

package/dist/postgres/context.js

@@ -1,76 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RetentionPruner = void 0;
-exports.inTransaction = inTransaction;
-exports.normalizeRetention = normalizeRetention;
-const keys_1 = require("../keys");
-const MINUTES_PER_DAY = 1440;
-const HOURS_PER_DAY = 24;
-async function inTransaction(ctx, work) {
-    await ctx.ready();
-    const client = await ctx.pool.connect();
-    try {
-        await client.query('BEGIN');
-        try {
-            const result = await work(client);
-            await client.query('COMMIT');
-            return result;
-        }
-        catch (error) {
-            await client.query('ROLLBACK').catch(() => undefined);
-            throw error;
-        }
-    }
-    finally {
-        client.release();
-    }
-}
-function normalizeRetention(retention) {
-    return {
-        minutes: Math.max(1, Math.floor(retention.minutes)),
-        hours: Math.max(1, Math.floor(retention.hours)),
-        days: Math.max(1, Math.floor(retention.days)),
-    };
-}
-/**
- * The SQL counterpart of the Redis TTLs and totals trimming: every tier drops the days older
- * than its own retention, counted back from `day`.
- *
- * Anchored on the day being written rather than on the wall clock, exactly as the Redis
- * scripts trim against the day of the write, and run by each writer on its first write and
- * then on the first write of every new day, so about once a day per process. The deletes
- * are range scans on the `(tier, bucket)` indexes. Sampler state past its expiry goes too:
- * a watermark outliving its queue is the unbounded-storage failure this package avoids.
- */
-class RetentionPruner {
-    constructor(ctx, retention) {
-        this.ctx = ctx;
-        this.retention = retention;
-        this.prunedFor = null;
-    }
-    async afterWrite(day) {
-        if (this.prunedFor !== null && day <= this.prunedFor) {
-            return;
-        }
-        this.prunedFor = day;
-        const { counters, histograms, samplerState } = this.ctx.tables;
-        const minuteCutoff = (0, keys_1.dayToIndex)((0, keys_1.shiftDay)(day, -this.retention.minutes)) * MINUTES_PER_DAY;
-        const hourCutoff = (0, keys_1.dayToIndex)((0, keys_1.shiftDay)(day, -this.retention.hours)) * HOURS_PER_DAY;
-        const dayCutoff = (0, keys_1.dayToIndex)((0, keys_1.shiftDay)(day, -this.retention.days));
-        try {
-            await this.ctx.pool.query(`DELETE FROM ${counters}
-          WHERE (tier = 'minute' AND bucket < $1)
-             OR (tier = 'hour' AND bucket < $2)
-             OR (tier = 'day' AND bucket < $3)`, [minuteCutoff, hourCutoff, dayCutoff]);
-            await this.ctx.pool.query(`DELETE FROM ${histograms}
-          WHERE (tier = 'hour' AND bucket < $1) OR (tier = 'day' AND bucket < $2)`, [hourCutoff, dayCutoff]);
-            await this.ctx.pool.query(`DELETE FROM ${samplerState} WHERE expires_at <= now()`);
-        }
-        catch (error) {
-            this.prunedFor = null; // retried on the next write instead of waiting a day
-            throw error;
-        }
-    }
-}
-exports.RetentionPruner = RetentionPruner;
-//# sourceMappingURL=context.js.map

package/dist/postgres/context.js.map

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

package/dist/postgres/schema.d.ts

@@ -1,26 +0,0 @@
-import { type PgPool } from './connection';
-export declare const DEFAULT_SCHEMA = "public";
-/** The SQL twin of the Redis namespace `bull-board:metrics`. */
-export declare const DEFAULT_TABLE_PREFIX = "bull_board_metrics_";
-export declare const SCHEMA_VERSION = 1;
-export interface MetricsTables {
-    schema: string;
-    prefix: string;
-    /** Schema-qualified, quoted names, ready to splice into SQL or cast to `regclass`. */
-    meta: string;
-    counters: string;
-    histograms: string;
-    samplerState: string;
-}
-export declare function metricsTables(schema: string, prefix: string): MetricsTables;
-/**
- * Creates or upgrades the metrics tables. Idempotent, and safe to run from several processes
- * at once: the whole upgrade is one transaction behind an advisory lock scoped to this
- * schema and prefix, so a second migrator waits and then finds nothing left to do.
- *
- * The schema is created only when it does not exist yet, since `CREATE SCHEMA IF NOT EXISTS`
- * still demands the database-level CREATE privilege that an application role often lacks.
- */
-export declare function runMigrations(pool: PgPool, tables: MetricsTables): Promise<number>;
-/** Throws unless the tables exist at the version this build writes. */
-export declare function assertMigrated(pool: PgPool, tables: MetricsTables): Promise<void>;