@bull-board/metrics 0.0.0 → 8.3.0

package/README.md

@@ -0,0 +1,83 @@
+# @bull-board/metrics
+
+> Status: Beta. The API and Redis storage layout may still change in a minor release while the feature settles. It is safe to run (opt-in, and it only writes its own namespaced keys), but pin an exact version if you depend on the storage format.
+
+Opt-in long-retention historical job metrics for [bull-board](https://github.com/felixmosh/bull-board).
+
+Snapshots native BullMQ per-minute metrics into long-retention Redis buckets and exposes a
+`MetricsHistoryProvider` that feeds bull-board's history charts. Everything is opt-in: the core
+`@bull-board/api` stays stateless.
+
+## Precondition
+
+Your BullMQ workers must have native metrics enabled, with a window large enough to survive any
+recorder downtime, for example:
+
+    new Worker(name, processor, {
+      connection,
+      metrics: { maxDataPoints: MetricsTime.ONE_WEEK },
+    });
+
+## Usage
+
+    import { MetricsRecorder, RedisMetricsHistoryProvider } from '@bull-board/metrics';
+
+    // In your always-on worker/app process:
+    const recorder = new MetricsRecorder({
+      queues: [new BullMQAdapter(queue)],
+      connection,
+      retentionDays: 90,
+    });
+    recorder.start();
+
+    // Where you build the board:
+    createBullBoard({
+      queues,
+      serverAdapter,
+      options: { historyProvider: new RedisMetricsHistoryProvider({ connection }) },
+    });
+
+On shutdown, call `recorder.stop()` and `provider.disconnect()`. Both only close the Redis connection if the recorder/provider opened it internally, so it's a safe no-op if you passed in your own `Redis` instance.
+
+Timestamps and buckets are UTC.
+
+## Storage
+
+Every key lives under `bull-board:metrics:`. Each snapshot is written at three resolutions at once, each with its own retention, because they cost very different amounts:
+
+| Tier | Default retention | Size per busy day, per queue and metric |
+| --- | --- | --- |
+| Minute | 7 days | ~72 KB |
+| Hour | 90 days | ~0.3 KB |
+| Day | 90 days | ~15 bytes |
+
+At the defaults that's roughly 1.1 MB for a queue busy every minute of every day across both metrics, and far less for a bursty one. Minutes with no activity are never written, so the footprint follows how busy a queue is, not how long it has been recording.
+
+    const recorder = new MetricsRecorder({
+      queues,
+      connection,
+      retention: { minutes: 7, hours: 90, days: 90 },
+    });
+
+The minute window is the one worth tuning: it holds essentially all the bytes, and it doubles as the recorder's catch-up window after downtime. `retentionDays: N` still works and sets the hourly and daily windows, leaving the minute window at its default.
+
+Retention is enforced by Redis. Day-scoped keys expire on their own TTL; the daily totals hashes are trimmed to the window as each new day rolls in.
+
+## Inspecting and clearing history
+
+    import { MetricsHistoryAdmin } from '@bull-board/metrics';
+
+    const admin = new MetricsHistoryAdmin({ connection });
+
+    await admin.stats();                          // bytes per tier and per queue, day range
+    await admin.purge();                          // delete everything
+    await admin.purge({ queue: 'mailer' });       // delete one queue
+    await admin.purge({ before: '2026-06-01' });  // delete anything older than a day
+
+Both are `SCAN`-driven and confined to this package's namespace, so they never block Redis and never touch BullMQ's own keys. Purging a single queue also subtracts it from the cross-queue rollup. Call `admin.disconnect()` when done.
+
+`RedisMetricsHistoryProvider` exposes the same two operations to the board, which turns them into a storage panel on the Metrics history page with a confirmation before anything is deleted.
+
+## Scope
+
+The shipped bull-board UI reads daily rollups. `getHistory` also supports hourly granularity for custom consumers (via the core's `/api/metrics/history` endpoint), though the built-in charts don't use it.

package/dist/HistoryAdmin.d.ts

@@ -0,0 +1,119 @@
+import { Redis, type RedisOptions } from 'ioredis';
+export interface TierStats {
+    keys: number;
+    /** Sum of `MEMORY USAGE` over this tier's keys, in bytes. */
+    bytes: number;
+}
+export interface HistoryQueueStats {
+    /** Queue name, or `__global__` for the cross-queue rollup. */
+    queue: string;
+    keys: number;
+    bytes: number;
+    /** Recorded minute buckets, the tier that drives storage size. */
+    minutes: number;
+    /** Days covered by a minute or hour hash, ascending. */
+    days: string[];
+    /** Where this queue's bytes actually sit, so a footprint can be diagnosed. */
+    tiers: Record<HistoryTier, TierStats>;
+}
+export interface HistoryStats {
+    keys: number;
+    bytes: number;
+    minutes: number;
+    oldestDay: string | null;
+    newestDay: string | null;
+    tiers: Record<HistoryTier, TierStats>;
+    queues: HistoryQueueStats[];
+}
+export interface PurgeOptions {
+    /** Limit the purge to one queue. Omit to purge every queue plus the global rollup. */
+    queue?: string;
+    /** Only drop days strictly before this date (UTC). Omit to drop everything in scope. */
+    before?: Date | string;
+}
+export interface PurgeResult {
+    keysDeleted: number;
+    /** Day fields removed from totals hashes. */
+    fieldsDeleted: number;
+}
+export interface MetricsHistoryAdminOptions {
+    connection: RedisOptions | Redis;
+}
+export type HistoryTier = 'minute' | 'hour' | 'day';
+interface ParsedKey {
+    queue: string;
+    metric: string;
+    tier: HistoryTier;
+    /** ISO day the key covers, `null` for the daily totals hash. */
+    day: string | null;
+}
+/**
+ * Parses the three key shapes from the right, because queue names may themselves contain
+ * colons:
+ *
+ *   <ns>:<queue>:<metric>:<day>         minute buckets
+ *   <ns>:<queue>:<metric>:hour:<day>    hourly rollup
+ *   <ns>:<queue>:<metric>:totals        daily totals
+ *
+ * The metric segment is checked against the known set, so a queue named `hour` or one
+ * ending in `:completed` still resolves correctly. Anything that doesn't fit returns null
+ * and is then reported but never deleted, so a stray key can't be destroyed by accident.
+ */
+export declare function parseHistoryKey(key: string): ParsedKey | null;
+/**
+ * Inspection and cleanup for the Redis keys written by `MetricsRecorder`.
+ *
+ * Every operation is confined to the `bull-board:metrics:` namespace and driven by SCAN,
+ * so it never blocks Redis and never touches BullMQ's own keys. Deletes use UNLINK.
+ */
+export declare class MetricsHistoryAdmin {
+    private readonly redis;
+    private readonly ownsRedis;
+    constructor(opts: MetricsHistoryAdminOptions);
+    disconnect(): void;
+    /**
+     * Per-queue footprint of the stored history.
+     *
+     * Every key has to be measured individually, since only `MEMORY USAGE` knows what a hash
+     * really costs. Issuing those one at a time would mean a round trip per key, which at a
+     * 90-day retention across a dozen queues runs into the thousands, so the measurements go
+     * out in pipelined batches instead. Still an ops-scale call rather than a hot path: it
+     * reads the whole namespace, so it belongs behind a debug endpoint, not a poll.
+     */
+    stats(): Promise<HistoryStats>;
+    /**
+     * Size and entry count for each key, in pipelined batches so the cost is a handful of
+     * round trips rather than one per key. A key that expires between the scan and the
+     * measurement simply reads as zero rather than failing the whole call.
+     */
+    private measure;
+    /**
+     * Deletes recorded history. Purging a single queue also subtracts that queue's minutes
+     * from the global rollup, so the cross-queue chart stays correct instead of keeping the
+     * removed queue's throughput folded into it forever.
+     */
+    purge(opts?: PurgeOptions): Promise<PurgeResult>;
+    /**
+     * Removes one queue's buckets from the matching global key, so the cross-queue series
+     * reflects the queues that are left rather than keeping the removed queue folded in.
+     * Each tier is corrected from its own source key, because the tiers have independent
+     * retention and the minute hash may already be gone while the hourly one survives.
+     * Fields that drain to zero are dropped: the recorder never writes a zero bucket, so a
+     * leftover zero would read as recorded-but-idle instead of not recorded.
+     * Returns the number of global keys it deleted.
+     */
+    private subtractDayFromGlobal;
+    /**
+     * Same idea for the daily rollup: the global totals hash is the sum of the per-queue
+     * totals hashes, so it is corrected from those rather than re-derived from day hashes,
+     * which may already have expired. Returns the number of global fields it removed.
+     */
+    private subtractTotalsFromGlobal;
+    /**
+     * SCAN over the namespace. SCAN may hand back the same key on more than one cursor
+     * iteration, which would double-count in `stats()`, so emissions are de-duped here.
+     * The set is bounded by queues x metrics x retention days.
+     */
+    private scan;
+}
+export {};

package/dist/HistoryAdmin.js

@@ -0,0 +1,325 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsHistoryAdmin = void 0;
+exports.parseHistoryKey = parseHistoryKey;
+const ioredis_1 = require("ioredis");
+const keys_1 = require("./keys");
+const SCAN_COUNT = 500;
+const BATCH = 256;
+/** Keys per pipelined `stats()` batch. Each key costs two commands. */
+const MEASURE_BATCH = 250;
+const DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+const METRICS = ['completed', 'failed'];
+/**
+ * Parses the three key shapes from the right, because queue names may themselves contain
+ * colons:
+ *
+ *   <ns>:<queue>:<metric>:<day>         minute buckets
+ *   <ns>:<queue>:<metric>:hour:<day>    hourly rollup
+ *   <ns>:<queue>:<metric>:totals        daily totals
+ *
+ * The metric segment is checked against the known set, so a queue named `hour` or one
+ * ending in `:completed` still resolves correctly. Anything that doesn't fit returns null
+ * and is then reported but never deleted, so a stray key can't be destroyed by accident.
+ */
+function parseHistoryKey(key) {
+    const prefix = `${keys_1.NAMESPACE}:`;
+    if (!key.startsWith(prefix)) {
+        return null;
+    }
+    const parts = key.slice(prefix.length).split(':');
+    if (parts.length < 3) {
+        return null;
+    }
+    const last = parts[parts.length - 1];
+    if (last === 'totals' && METRICS.includes(parts[parts.length - 2])) {
+        const queue = parts.slice(0, -2).join(':');
+        return queue ? { queue, metric: parts[parts.length - 2], tier: 'day', day: null } : null;
+    }
+    if (!DAY_PATTERN.test(last)) {
+        return null;
+    }
+    if (parts.length >= 4 && parts[parts.length - 2] === keys_1.HOUR_TIER) {
+        const metric = parts[parts.length - 3];
+        const queue = parts.slice(0, -3).join(':');
+        return queue && METRICS.includes(metric) ? { queue, metric, tier: 'hour', day: last } : null;
+    }
+    const metric = parts[parts.length - 2];
+    const queue = parts.slice(0, -2).join(':');
+    return queue && METRICS.includes(metric) ? { queue, metric, tier: 'minute', day: last } : null;
+}
+function emptyTiers() {
+    return {
+        minute: { keys: 0, bytes: 0 },
+        hour: { keys: 0, bytes: 0 },
+        day: { keys: 0, bytes: 0 },
+    };
+}
+/** The global rollup key mirroring a per-queue key, same tier and same day. */
+function globalKeyFor(parsed) {
+    if (parsed.day === null) {
+        return (0, keys_1.totalsHashKey)(keys_1.GLOBAL_QUEUE, parsed.metric);
+    }
+    return parsed.tier === 'hour'
+        ? (0, keys_1.hourHashKey)(keys_1.GLOBAL_QUEUE, parsed.metric, parsed.day)
+        : (0, keys_1.dayHashKey)(keys_1.GLOBAL_QUEUE, parsed.metric, parsed.day);
+}
+function toDay(value) {
+    if (typeof value === 'string') {
+        if (!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);
+}
+/**
+ * Inspection and cleanup for the Redis keys written by `MetricsRecorder`.
+ *
+ * Every operation is confined to the `bull-board:metrics:` namespace and driven by SCAN,
+ * so it never blocks Redis and never touches BullMQ's own keys. Deletes use UNLINK.
+ */
+class MetricsHistoryAdmin {
+    constructor(opts) {
+        if (opts.connection instanceof ioredis_1.Redis) {
+            this.redis = opts.connection;
+            this.ownsRedis = false;
+        }
+        else {
+            this.redis = new ioredis_1.Redis(opts.connection);
+            this.ownsRedis = true;
+        }
+    }
+    disconnect() {
+        if (this.ownsRedis) {
+            this.redis.disconnect();
+        }
+    }
+    /**
+     * Per-queue footprint of the stored history.
+     *
+     * Every key has to be measured individually, since only `MEMORY USAGE` knows what a hash
+     * really costs. Issuing those one at a time would mean a round trip per key, which at a
+     * 90-day retention across a dozen queues runs into the thousands, so the measurements go
+     * out in pipelined batches instead. Still an ops-scale call rather than a hot path: it
+     * reads the whole namespace, so it belongs behind a debug endpoint, not a poll.
+     */
+    async stats() {
+        var _a;
+        const byQueue = new Map();
+        const tiers = emptyTiers();
+        let keys = 0;
+        let bytes = 0;
+        let minutes = 0;
+        let oldestDay = null;
+        let newestDay = null;
+        const found = [];
+        for await (const key of this.scan()) {
+            const parsed = parseHistoryKey(key);
+            if (parsed) {
+                found.push({ key, parsed });
+            }
+        }
+        const measurements = await this.measure(found.map((item) => item.key));
+        for (const [index, { parsed }] of found.entries()) {
+            const { size, len } = measurements[index];
+            const entry = (_a = byQueue.get(parsed.queue)) !== null && _a !== void 0 ? _a : {
+                queue: parsed.queue,
+                keys: 0,
+                bytes: 0,
+                minutes: 0,
+                days: [],
+                tiers: emptyTiers(),
+            };
+            entry.keys += 1;
+            entry.bytes += size;
+            entry.tiers[parsed.tier].keys += 1;
+            entry.tiers[parsed.tier].bytes += size;
+            keys += 1;
+            bytes += size;
+            tiers[parsed.tier].keys += 1;
+            tiers[parsed.tier].bytes += size;
+            if (parsed.tier === 'minute') {
+                entry.minutes += len;
+                minutes += len;
+            }
+            if (parsed.day) {
+                entry.days.push(parsed.day);
+                if (oldestDay === null || parsed.day < oldestDay) {
+                    oldestDay = parsed.day;
+                }
+                if (newestDay === null || parsed.day > newestDay) {
+                    newestDay = parsed.day;
+                }
+            }
+            byQueue.set(parsed.queue, entry);
+        }
+        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 };
+    }
+    /**
+     * Size and entry count for each key, in pipelined batches so the cost is a handful of
+     * round trips rather than one per key. A key that expires between the scan and the
+     * measurement simply reads as zero rather than failing the whole call.
+     */
+    async measure(keys) {
+        var _a, _b, _c, _d;
+        const out = [];
+        for (let i = 0; i < keys.length; i += MEASURE_BATCH) {
+            const chunk = keys.slice(i, i + MEASURE_BATCH);
+            const pipeline = this.redis.pipeline();
+            for (const key of chunk) {
+                pipeline.memory('USAGE', key);
+                pipeline.hlen(key);
+            }
+            const res = await pipeline.exec();
+            for (let j = 0; j < chunk.length; j++) {
+                out.push({
+                    size: Number((_b = (_a = res === null || res === void 0 ? void 0 : res[j * 2]) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : 0) || 0,
+                    len: Number((_d = (_c = res === null || res === void 0 ? void 0 : res[j * 2 + 1]) === null || _c === void 0 ? void 0 : _c[1]) !== null && _d !== void 0 ? _d : 0) || 0,
+                });
+            }
+        }
+        return out;
+    }
+    /**
+     * Deletes recorded history. Purging a single queue also subtracts that queue's minutes
+     * from the global rollup, so the cross-queue chart stays correct instead of keeping the
+     * removed queue's throughput folded into it forever.
+     */
+    async purge(opts = {}) {
+        const before = opts.before === undefined ? null : toDay(opts.before);
+        const result = { keysDeleted: 0, fieldsDeleted: 0 };
+        const dayKeys = [];
+        const totalsKeys = [];
+        for await (const key of this.scan()) {
+            const parsed = parseHistoryKey(key);
+            if (!parsed) {
+                continue;
+            }
+            if (opts.queue !== undefined && parsed.queue !== opts.queue) {
+                continue;
+            }
+            if (parsed.day === null) {
+                totalsKeys.push({ key, parsed });
+            }
+            else if (before === null || parsed.day < before) {
+                dayKeys.push({ key, parsed });
+            }
+        }
+        // Rewriting the global rollup only makes sense when a single queue is being removed:
+        // a full purge drops the global keys outright, along with everything else.
+        const adjustGlobal = opts.queue !== undefined && opts.queue !== keys_1.GLOBAL_QUEUE;
+        for (const { key, parsed } of dayKeys) {
+            if (adjustGlobal) {
+                result.keysDeleted += await this.subtractDayFromGlobal(key, parsed);
+            }
+            result.keysDeleted += await this.redis.unlink(key);
+        }
+        for (const { key, parsed } of totalsKeys) {
+            const stale = (await this.redis.hkeys(key)).filter((day) => before === null || day < before);
+            if (adjustGlobal && stale.length > 0) {
+                const totals = await this.redis.hmget(key, ...stale);
+                result.fieldsDeleted += await this.subtractTotalsFromGlobal(parsed.metric, stale, totals);
+            }
+            if (before === null) {
+                result.keysDeleted += await this.redis.unlink(key);
+                continue;
+            }
+            for (let i = 0; i < stale.length; i += BATCH) {
+                result.fieldsDeleted += await this.redis.hdel(key, ...stale.slice(i, i + BATCH));
+            }
+            if ((await this.redis.hlen(key)) === 0) {
+                result.keysDeleted += await this.redis.unlink(key);
+            }
+        }
+        return result;
+    }
+    /**
+     * Removes one queue's buckets from the matching global key, so the cross-queue series
+     * reflects the queues that are left rather than keeping the removed queue folded in.
+     * Each tier is corrected from its own source key, because the tiers have independent
+     * retention and the minute hash may already be gone while the hourly one survives.
+     * Fields that drain to zero are dropped: the recorder never writes a zero bucket, so a
+     * leftover zero would read as recorded-but-idle instead of not recorded.
+     * Returns the number of global keys it deleted.
+     */
+    async subtractDayFromGlobal(key, parsed) {
+        if (parsed.day === null) {
+            return 0;
+        }
+        const minutes = await this.redis.hgetall(key);
+        const globalDay = globalKeyFor(parsed);
+        const pipeline = this.redis.multi();
+        const touched = [];
+        for (const field of Object.keys(minutes)) {
+            const value = Number(minutes[field]) || 0;
+            if (value === 0) {
+                continue;
+            }
+            touched.push(field);
+            pipeline.hincrby(globalDay, field, -value);
+        }
+        if (touched.length === 0) {
+            return 0;
+        }
+        const res = await pipeline.exec();
+        const drained = touched.filter((_, i) => { var _a, _b; return Number((_b = (_a = res === null || res === void 0 ? void 0 : res[i]) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : 0) <= 0; });
+        for (let i = 0; i < drained.length; i += BATCH) {
+            await this.redis.hdel(globalDay, ...drained.slice(i, i + BATCH));
+        }
+        return (await this.redis.hlen(globalDay)) === 0 ? await this.redis.unlink(globalDay) : 0;
+    }
+    /**
+     * Same idea for the daily rollup: the global totals hash is the sum of the per-queue
+     * totals hashes, so it is corrected from those rather than re-derived from day hashes,
+     * which may already have expired. Returns the number of global fields it removed.
+     */
+    async subtractTotalsFromGlobal(metric, days, values) {
+        const globalTotals = (0, keys_1.totalsHashKey)(keys_1.GLOBAL_QUEUE, metric);
+        const pipeline = this.redis.multi();
+        const touched = [];
+        days.forEach((day, i) => {
+            const value = Number(values[i]) || 0;
+            if (value === 0) {
+                return;
+            }
+            touched.push(day);
+            pipeline.hincrby(globalTotals, day, -value);
+        });
+        if (touched.length === 0) {
+            return 0;
+        }
+        const res = await pipeline.exec();
+        const drained = touched.filter((_, i) => { var _a, _b; return Number((_b = (_a = res === null || res === void 0 ? void 0 : res[i]) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : 0) <= 0; });
+        let removed = 0;
+        for (let i = 0; i < drained.length; i += BATCH) {
+            removed += await this.redis.hdel(globalTotals, ...drained.slice(i, i + BATCH));
+        }
+        return removed;
+    }
+    /**
+     * SCAN over the namespace. SCAN may hand back the same key on more than one cursor
+     * iteration, which would double-count in `stats()`, so emissions are de-duped here.
+     * The set is bounded by queues x metrics x retention days.
+     */
+    async *scan() {
+        const seen = new Set();
+        let cursor = '0';
+        do {
+            const [next, batch] = await this.redis.scan(cursor, 'MATCH', `${keys_1.NAMESPACE}:*`, 'COUNT', SCAN_COUNT);
+            cursor = next;
+            for (const key of batch) {
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    yield key;
+                }
+            }
+        } while (cursor !== '0');
+    }
+}
+exports.MetricsHistoryAdmin = MetricsHistoryAdmin;
+//# sourceMappingURL=HistoryAdmin.js.map

package/dist/HistoryAdmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryAdmin.js","sourceRoot":"","sources":["../src/HistoryAdmin.ts"],"names":[],"mappings":";;;AA8EA,0CA0BC;AAxGD,qCAAmD;AACnD,iCAAoG;AAEpG,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,KAAK,GAAG,GAAG,CAAC;AAClB,uEAAuE;AACvE,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAC1C,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AA0DxC;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,MAAM,GAAG,GAAG,gBAAS,GAAG,CAAC;IAC/B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,gBAAS,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/F,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACjG,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;QACL,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;QAC7B,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;QAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAS,YAAY,CAAC,MAAiB;IACrC,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,IAAA,oBAAa,EAAC,mBAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM;QAC3B,CAAC,CAAC,IAAA,kBAAW,EAAC,mBAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;QACtD,CAAC,CAAC,IAAA,iBAAU,EAAC,mBAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,KAAK,CAAC,KAAoB;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,6CAA6C,KAAK,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAa,mBAAmB;IAI9B,YAAY,IAAgC;QAC1C,IAAI,IAAI,CAAC,UAAU,YAAY,eAAK,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,GAAG,IAAI,eAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK;;QACT,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;QACrD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,IAAI,SAAS,GAAkB,IAAI,CAAC;QAEpC,MAAM,KAAK,GAAyC,EAAE,CAAC;QACvD,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEvE,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YAE1C,MAAM,KAAK,GAAG,MAAA,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAI;gBACzC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,EAAE;gBACR,KAAK,EAAE,UAAU,EAAE;aACpB,CAAC;YACF,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;YAChB,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC;YACpB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YACnC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;YACvC,IAAI,IAAI,CAAC,CAAC;YACV,KAAK,IAAI,IAAI,CAAC;YACd,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;YAC7B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;YAEjC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC;gBACrB,OAAO,IAAI,GAAG,CAAC;YACjB,CAAC;YACD,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC5B,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC;oBACjD,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC;gBACzB,CAAC;gBACD,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC;oBACjD,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACvE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,OAAO,CAAC,IAAc;;QAClC,MAAM,GAAG,GAAoC,EAAE,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACvC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,MAAM,CAAC,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAG,CAAC,GAAG,CAAC,CAAC,0CAAG,CAAC,CAAC,mCAAI,CAAC,CAAC,IAAI,CAAC;oBACzC,GAAG,EAAE,MAAM,CAAC,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,0CAAG,CAAC,CAAC,mCAAI,CAAC,CAAC,IAAI,CAAC;iBAC7C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,OAAqB,EAAE;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,MAAM,MAAM,GAAgB,EAAE,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QACjE,MAAM,OAAO,GAAyC,EAAE,CAAC;QACzD,MAAM,UAAU,GAAyC,EAAE,CAAC;QAE5D,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC5D,SAAS;YACX,CAAC;YACD,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;gBACxB,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YACnC,CAAC;iBAAM,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,GAAG,MAAM,EAAE,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,qFAAqF;QACrF,2EAA2E;QAC3E,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,mBAAY,CAAC;QAE7E,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACtC,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,CAAC,WAAW,IAAI,MAAM,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,CAAC,WAAW,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC;YAC7F,IAAI,YAAY,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;gBACrD,MAAM,CAAC,aAAa,IAAI,MAAM,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5F,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,CAAC,WAAW,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACnD,SAAS;YACX,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;gBAC7C,MAAM,CAAC,aAAa,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;YACnF,CAAC;YACD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,WAAW,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,qBAAqB,CAAC,GAAW,EAAE,MAAiB;QAChE,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,eAAC,OAAA,MAAM,CAAC,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAG,CAAC,CAAC,0CAAG,CAAC,CAAC,mCAAI,CAAC,CAAC,IAAI,CAAC,CAAA,EAAA,CAAC,CAAC;QAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAC/C,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,wBAAwB,CACpC,MAAc,EACd,IAAc,EACd,MAAyB;QAEzB,MAAM,YAAY,GAAG,IAAA,oBAAa,EAAC,mBAAY,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,eAAC,OAAA,MAAM,CAAC,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAG,CAAC,CAAC,0CAAG,CAAC,CAAC,mCAAI,CAAC,CAAC,IAAI,CAAC,CAAA,EAAA,CAAC,CAAC;QAC1E,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAC/C,OAAO,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,CAAC,IAAI;QACjB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACF,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CACzC,MAAM,EACN,OAAO,EACP,GAAG,gBAAS,IAAI,EAChB,OAAO,EACP,UAAU,CACX,CAAC;YACF,MAAM,GAAG,IAAI,CAAC;YACd,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAC3B,CAAC;CACF;AA3QD,kDA2QC"}

package/dist/HistoryStore.d.ts

@@ -0,0 +1,34 @@
+import type { Redis } from 'ioredis';
+export interface Retention {
+    /** Days of minute-level detail. Doubles as the recorder's catch-up window. */
+    minutes: number;
+    /** Days of hourly rollup. */
+    hours: number;
+    /** Days of daily totals, which is what the shipped charts read. */
+    days: number;
+}
+export declare class HistoryStore {
+    private readonly redis;
+    readonly retention: Retention;
+    constructor(opts: {
+        redis: Redis;
+        retention: Retention;
+    });
+    upsertMinute(queue: string, metric: string, minute: number, value: number): Promise<void>;
+    /**
+     * Raw HMGET of the totals hash: `null` means the day was never recorded, a present
+     * string (including `'0'`) means it was. Distinguishing "missing" from "stored zero"
+     * matters for callers deciding between empty history vs. a zero-backfilled series.
+     */
+    readDailyTotalsRaw(queue: string, metric: string, days: string[]): Promise<(string | null)[]>;
+    readDayMinutes(queue: string, metric: string, day: string): Promise<Record<string, number>>;
+    /**
+     * Hourly buckets for one day, keyed by absolute hour index.
+     *
+     * Falls back to folding the minute hash when the hourly rollup is absent, which covers
+     * days recorded before the rollup existed. Once those minute hashes age out, the days
+     * they cover are already outside the minute window anyway.
+     */
+    readDayHours(queue: string, metric: string, day: string): Promise<Record<string, number>>;
+    private readNumericHash;
+}

package/dist/HistoryStore.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HistoryStore = void 0;
+const keys_1 = require("./keys");
+/**
+ * Atomic, idempotent upsert of one minute bucket into all three resolutions at once.
+ *
+ * KEYS[1] queue minute hash     ARGV[1] minute field   ARGV[5] minute-tier ttl seconds
+ * KEYS[2] queue hour hash       ARGV[2] hour field     ARGV[6] hour-tier ttl seconds
+ * KEYS[3] queue totals hash     ARGV[3] day field      ARGV[7] day-tier ttl seconds
+ * KEYS[4] global minute hash    ARGV[4] value          ARGV[8] oldest day to keep
+ * KEYS[5] global hour hash
+ * KEYS[6] global totals hash
+ *
+ * The minute hash is the ledger the whole thing is built on: `delta` is the difference
+ * against the value already stored there, so re-snapshotting an overlapping window (a
+ * restart, or a second recorder process) applies a delta of zero and the coarser tiers
+ * never double-count. Rolling up on write rather than compacting later keeps that property:
+ * one script, one delta, every resolution consistent, nothing to schedule or resume.
+ *
+ * Retention is per tier. Day-scoped keys fall off on their own, since their TTL is only
+ * refreshed while that day is being written, so each dies its tier's retention after the
+ * day it holds. The totals hashes are written every day, so their TTL keeps rolling forward
+ * and they would otherwise grow a field per day forever; they are trimmed here instead.
+ * Day fields are ISO `YYYY-MM-DD`, which sorts lexicographically, so a plain string compare
+ * against the cutoff is enough. Trimming only runs on the first write of a new day, which
+ * is about once a day per queue.
+ */
+const UPSERT_MINUTE = `
+local function trim(key, cutoff)
+  local fields = redis.call('HKEYS', key)
+  local stale = {}
+  for i = 1, #fields do
+    if fields[i] < cutoff then
+      stale[#stale + 1] = fields[i]
+      if #stale == 256 then
+        redis.call('HDEL', key, unpack(stale))
+        stale = {}
+      end
+    end
+  end
+  if #stale > 0 then
+    redis.call('HDEL', key, unpack(stale))
+  end
+end
+
+local old = tonumber(redis.call('HGET', KEYS[1], ARGV[1]) or '0')
+local val = tonumber(ARGV[4])
+if val == old then
+  return 0
+end
+local delta = val - old
+local newDay = redis.call('HEXISTS', KEYS[3], ARGV[3]) == 0
+redis.call('HSET', KEYS[1], ARGV[1], val)
+redis.call('HINCRBY', KEYS[2], ARGV[2], delta)
+redis.call('HINCRBY', KEYS[3], ARGV[3], delta)
+redis.call('HINCRBY', KEYS[4], ARGV[1], delta)
+redis.call('HINCRBY', KEYS[5], ARGV[2], delta)
+redis.call('HINCRBY', KEYS[6], ARGV[3], delta)
+redis.call('EXPIRE', KEYS[1], ARGV[5])
+redis.call('EXPIRE', KEYS[2], ARGV[6])
+redis.call('EXPIRE', KEYS[3], ARGV[7])
+redis.call('EXPIRE', KEYS[4], ARGV[5])
+redis.call('EXPIRE', KEYS[5], ARGV[6])
+redis.call('EXPIRE', KEYS[6], ARGV[7])
+if newDay then
+  trim(KEYS[3], ARGV[8])
+  trim(KEYS[6], ARGV[8])
+end
+return delta
+`;
+const SECONDS_PER_DAY = 86400;
+function ttl(days) {
+    return String(Math.max(1, Math.floor(days * SECONDS_PER_DAY)));
+}
+class HistoryStore {
+    constructor(opts) {
+        this.redis = opts.redis;
+        this.retention = {
+            minutes: Math.max(1, Math.floor(opts.retention.minutes)),
+            hours: Math.max(1, Math.floor(opts.retention.hours)),
+            days: Math.max(1, Math.floor(opts.retention.days)),
+        };
+    }
+    async upsertMinute(queue, metric, minute, value) {
+        const day = (0, keys_1.minuteToDay)(minute);
+        await this.redis.eval(UPSERT_MINUTE, 6, (0, keys_1.dayHashKey)(queue, metric, day), (0, keys_1.hourHashKey)(queue, metric, day), (0, keys_1.totalsHashKey)(queue, metric), (0, keys_1.dayHashKey)(keys_1.GLOBAL_QUEUE, metric, day), (0, keys_1.hourHashKey)(keys_1.GLOBAL_QUEUE, metric, day), (0, keys_1.totalsHashKey)(keys_1.GLOBAL_QUEUE, metric), String(minute), String((0, keys_1.minuteToHour)(minute)), day, String(value), ttl(this.retention.minutes), ttl(this.retention.hours), ttl(this.retention.days), (0, keys_1.shiftDay)(day, -this.retention.days));
+    }
+    /**
+     * Raw HMGET of the totals hash: `null` means the day was never recorded, a present
+     * string (including `'0'`) means it was. Distinguishing "missing" from "stored zero"
+     * matters for callers deciding between empty history vs. a zero-backfilled series.
+     */
+    async readDailyTotalsRaw(queue, metric, days) {
+        if (days.length === 0) {
+            return [];
+        }
+        // Pass `days` as a single array (ioredis flattens one level internally) instead of
+        // spreading it: spreading blows the JS argument-count limit for large ranges
+        // ("Maximum call stack size exceeded"). The cast works around ioredis's types only
+        // declaring the spread overload; kept as a method call to preserve `this` binding.
+        const redis = this.redis;
+        return redis.hmget((0, keys_1.totalsHashKey)(queue, metric), days);
+    }
+    async readDayMinutes(queue, metric, day) {
+        return this.readNumericHash((0, keys_1.dayHashKey)(queue, metric, day));
+    }
+    /**
+     * Hourly buckets for one day, keyed by absolute hour index.
+     *
+     * Falls back to folding the minute hash when the hourly rollup is absent, which covers
+     * days recorded before the rollup existed. Once those minute hashes age out, the days
+     * they cover are already outside the minute window anyway.
+     */
+    async readDayHours(queue, metric, day) {
+        var _a;
+        const hours = await this.readNumericHash((0, keys_1.hourHashKey)(queue, metric, day));
+        if (Object.keys(hours).length > 0) {
+            return hours;
+        }
+        const minutes = await this.readDayMinutes(queue, metric, day);
+        const folded = {};
+        for (const field of Object.keys(minutes)) {
+            const hour = String((0, keys_1.minuteToHour)(Number(field)));
+            folded[hour] = ((_a = folded[hour]) !== null && _a !== void 0 ? _a : 0) + minutes[field];
+        }
+        return folded;
+    }
+    async readNumericHash(key) {
+        const raw = await this.redis.hgetall(key);
+        const out = {};
+        for (const field of Object.keys(raw)) {
+            out[field] = Number(raw[field]) || 0;
+        }
+        return out;
+    }
+}
+exports.HistoryStore = HistoryStore;
+//# sourceMappingURL=HistoryStore.js.map

package/dist/HistoryStore.js.map

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

package/dist/MetricsRecorder.d.ts

@@ -0,0 +1,51 @@
+import type { BaseAdapter } from '@bull-board/api/baseAdapter';
+import { Redis, type RedisOptions } from 'ioredis';
+import { type Retention } from './HistoryStore';
+/**
+ * Minute detail is the expensive tier by two orders of magnitude, so it defaults to a week
+ * rather than the full window: long enough to match the recommended `MetricsTime.ONE_WEEK`
+ * worker buffer, so the recorder can be down for a week and still catch up completely.
+ * The hourly and daily rollups are cheap enough to keep for the whole window.
+ */
+export declare const DEFAULT_RETENTION: Retention;
+export interface MetricsRecorderOptions {
+    queues: BaseAdapter[];
+    connection: RedisOptions | Redis;
+    /** Per-resolution retention in days. Unspecified tiers fall back to the defaults. */
+    retention?: Partial<Retention>;
+    /**
+     * Shorthand that sets the daily and hourly windows. Minute retention stays at its
+     * default unless raised explicitly, since that is the tier that drives storage size.
+     */
+    retentionDays?: number;
+    snapshotIntervalMs?: number;
+}
+export declare function resolveRetention(opts: {
+    retention?: Partial<Retention>;
+    retentionDays?: number;
+}): Retention;
+export declare class MetricsRecorder {
+    private readonly queues;
+    private readonly store;
+    private readonly redis;
+    private readonly ownsRedis;
+    private readonly intervalMs;
+    private readonly lastMinute;
+    private timer;
+    private running;
+    constructor(opts: MetricsRecorderOptions);
+    get retention(): Retention;
+    start(): void;
+    stop(): void;
+    snapshot(): Promise<void>;
+    /**
+     * Incrementally copies BullMQ's per-minute ring buffer into long-retention storage.
+     * `seenUpTo` is a per-(queue, metric) watermark of the newest minute already written.
+     * getMetrics() returns points newest-first, so we walk from the newest and stop at the
+     * first minute we've already stored: everything past it is older and stored too. Fresh
+     * minutes are upserted (safe against overlapping windows across ticks), then the
+     * watermark advances. So the first tick backfills the buffer and every later tick only
+     * writes the minutes that appeared since.
+     */
+    private snapshotOne;
+}

package/dist/MetricsRecorder.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsRecorder = exports.DEFAULT_RETENTION = void 0;
+exports.resolveRetention = resolveRetention;
+const ioredis_1 = require("ioredis");
+const dataMapping_1 = require("./dataMapping");
+const HistoryStore_1 = require("./HistoryStore");
+const METRICS = ['completed', 'failed'];
+const MS_PER_MINUTE = 60000;
+const MINUTES_PER_DAY = 1440;
+/**
+ * Minute detail is the expensive tier by two orders of magnitude, so it defaults to a week
+ * rather than the full window: long enough to match the recommended `MetricsTime.ONE_WEEK`
+ * worker buffer, so the recorder can be down for a week and still catch up completely.
+ * The hourly and daily rollups are cheap enough to keep for the whole window.
+ */
+exports.DEFAULT_RETENTION = { minutes: 7, hours: 90, days: 90 };
+function resolveRetention(opts) {
+    const base = opts.retentionDays === undefined
+        ? exports.DEFAULT_RETENTION
+        : {
+            minutes: Math.min(exports.DEFAULT_RETENTION.minutes, opts.retentionDays),
+            hours: opts.retentionDays,
+            days: opts.retentionDays,
+        };
+    return { ...base, ...opts.retention };
+}
+class MetricsRecorder {
+    constructor(opts) {
+        var _a;
+        this.lastMinute = new Map();
+        this.timer = null;
+        this.running = false;
+        this.queues = opts.queues;
+        this.intervalMs = (_a = opts.snapshotIntervalMs) !== null && _a !== void 0 ? _a : 60000;
+        if (opts.connection instanceof ioredis_1.Redis) {
+            this.redis = opts.connection;
+            this.ownsRedis = false;
+        }
+        else {
+            this.redis = new ioredis_1.Redis(opts.connection);
+            this.ownsRedis = true;
+        }
+        this.store = new HistoryStore_1.HistoryStore({ redis: this.redis, retention: resolveRetention(opts) });
+    }
+    get retention() {
+        return this.store.retention;
+    }
+    start() {
+        if (this.timer) {
+            return;
+        }
+        this.timer = setInterval(() => {
+            void this.snapshot();
+        }, this.intervalMs);
+        // Do not keep the event loop alive solely for the recorder.
+        if (typeof this.timer.unref === 'function') {
+            this.timer.unref();
+        }
+        void this.snapshot();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (this.ownsRedis) {
+            this.redis.disconnect();
+        }
+    }
+    async snapshot() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        try {
+            for (const adapter of this.queues) {
+                const name = adapter.getName();
+                for (const metric of METRICS) {
+                    await this.snapshotOne(adapter, name, metric);
+                }
+            }
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    /**
+     * Incrementally copies BullMQ's per-minute ring buffer into long-retention storage.
+     * `seenUpTo` is a per-(queue, metric) watermark of the newest minute already written.
+     * getMetrics() returns points newest-first, so we walk from the newest and stop at the
+     * first minute we've already stored: everything past it is older and stored too. Fresh
+     * minutes are upserted (safe against overlapping windows across ticks), then the
+     * watermark advances. So the first tick backfills the buffer and every later tick only
+     * writes the minutes that appeared since.
+     */
+    async snapshotOne(adapter, name, metric) {
+        var _a;
+        const cursorKey = `${name}:${metric}`;
+        const seenUpTo = (_a = this.lastMinute.get(cursorKey)) !== null && _a !== void 0 ? _a : -1;
+        const metrics = await adapter.getMetrics(metric).catch(() => null);
+        const points = (0, dataMapping_1.metricsToMinutePoints)(metrics);
+        if (points.length === 0) {
+            return;
+        }
+        // Correctness guard, not an optimization. Idempotency comes from the minute hash
+        // holding the previously written value, so a minute whose hash has already expired
+        // would look brand new and be added to the hourly and daily rollups a second time.
+        // That can only happen when the worker's metrics buffer reaches further back than the
+        // minute window (say a two-week buffer against a one-week window) and the recorder
+        // restarts, losing its in-memory watermark. Refusing to write past the window closes
+        // it. Nothing is lost that could have been retained anyway.
+        const oldestWritable = Math.floor(Date.now() / MS_PER_MINUTE) - this.store.retention.minutes * MINUTES_PER_DAY;
+        let newest = seenUpTo;
+        for (const point of points) {
+            if (point.minute <= seenUpTo) {
+                break; // points are newest-first; everything older is already stored
+            }
+            if (point.minute < oldestWritable) {
+                break; // ...and everything past here is older still
+            }
+            await this.store.upsertMinute(name, metric, point.minute, point.value);
+            if (point.minute > newest) {
+                newest = point.minute;
+            }
+        }
+        this.lastMinute.set(cursorKey, newest);
+    }
+}
+exports.MetricsRecorder = MetricsRecorder;
+//# sourceMappingURL=MetricsRecorder.js.map

package/dist/MetricsRecorder.js.map

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

package/dist/RedisMetricsHistoryProvider.d.ts

@@ -0,0 +1,24 @@
+import type { MetricsHistoryPoint, MetricsHistoryProvider, MetricsHistoryQuery } from '@bull-board/api/typings/app';
+import { Redis, type RedisOptions } from 'ioredis';
+import { type HistoryStats, type PurgeOptions, type PurgeResult } from './HistoryAdmin';
+import { type Retention } from './HistoryStore';
+export interface RedisMetricsHistoryProviderOptions {
+    connection: RedisOptions | Redis;
+    /** Should mirror the recorder's retention. Only used to bound the query span. */
+    retention?: Partial<Retention>;
+    retentionDays?: number;
+}
+export declare class RedisMetricsHistoryProvider implements MetricsHistoryProvider {
+    private readonly store;
+    private readonly admin;
+    private readonly redis;
+    private readonly ownsRedis;
+    private readonly retentionDays;
+    constructor(opts: RedisMetricsHistoryProviderOptions);
+    disconnect(): void;
+    /** Backs the board's storage panel. See MetricsHistoryAdmin.stats. */
+    getUsage(): Promise<HistoryStats>;
+    /** Backs the board's "clear history" action. See MetricsHistoryAdmin.purge. */
+    purge(options?: PurgeOptions): Promise<PurgeResult>;
+    getHistory(query: MetricsHistoryQuery): Promise<MetricsHistoryPoint[]>;
+}

package/dist/RedisMetricsHistoryProvider.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisMetricsHistoryProvider = void 0;
+const ioredis_1 = require("ioredis");
+const HistoryAdmin_1 = require("./HistoryAdmin");
+const HistoryStore_1 = require("./HistoryStore");
+const keys_1 = require("./keys");
+const MetricsRecorder_1 = require("./MetricsRecorder");
+const MS_PER_HOUR = 3600000;
+class RedisMetricsHistoryProvider {
+    constructor(opts) {
+        if (opts.connection instanceof ioredis_1.Redis) {
+            this.redis = opts.connection;
+            this.ownsRedis = false;
+        }
+        else {
+            this.redis = new ioredis_1.Redis(opts.connection);
+            this.ownsRedis = true;
+        }
+        const retention = (0, MetricsRecorder_1.resolveRetention)(opts);
+        this.retentionDays = retention.days;
+        this.store = new HistoryStore_1.HistoryStore({ redis: this.redis, retention });
+        this.admin = new HistoryAdmin_1.MetricsHistoryAdmin({ connection: this.redis });
+    }
+    disconnect() {
+        if (this.ownsRedis) {
+            this.redis.disconnect();
+        }
+    }
+    /** Backs the board's storage panel. See MetricsHistoryAdmin.stats. */
+    async getUsage() {
+        return this.admin.stats();
+    }
+    /** Backs the board's "clear history" action. See MetricsHistoryAdmin.purge. */
+    async purge(options = {}) {
+        return this.admin.purge(options);
+    }
+    async getHistory(query) {
+        var _a, _b;
+        const queue = (_a = query.queue) !== null && _a !== void 0 ? _a : keys_1.GLOBAL_QUEUE;
+        // Clamp the span to the retention window so an unbounded `from` (e.g. 0) can't make
+        // dayRange produce an unbounded number of day buckets -- older data doesn't exist anyway.
+        const maxSpanMs = (this.retentionDays + 1) * 86400000;
+        const from = Math.max(query.from, query.to - maxSpanMs);
+        const days = (0, keys_1.dayRange)(from, query.to);
+        if (query.granularity === 'day') {
+            const rawTotals = await this.store.readDailyTotalsRaw(queue, query.metric, days);
+            // Empty history only when no day in range was ever recorded (all fields missing).
+            // A day with a stored '0' still counts as recorded -- otherwise the UI's empty
+            // state would be unreachable once any data exists.
+            if (rawTotals.every((value) => value == null)) {
+                return [];
+            }
+            const totals = {};
+            days.forEach((day, i) => {
+                totals[day] = Number(rawTotals[i]) || 0;
+            });
+            return days
+                .map((day) => { var _a; return ({ ts: (0, keys_1.dayToStartMs)(day), value: (_a = totals[day]) !== null && _a !== void 0 ? _a : 0 }); })
+                .filter((p) => p.ts >= dayFloor(query.from) && p.ts <= query.to);
+        }
+        const hourBuckets = new Map();
+        const dayHours = await Promise.all(days.map((day) => this.store.readDayHours(queue, query.metric, day)));
+        for (const hours of dayHours) {
+            for (const field of Object.keys(hours)) {
+                const ts = Number(field) * MS_PER_HOUR;
+                if (ts < query.from || ts > query.to) {
+                    continue;
+                }
+                hourBuckets.set(ts, ((_b = hourBuckets.get(ts)) !== null && _b !== void 0 ? _b : 0) + hours[field]);
+            }
+        }
+        return [...hourBuckets.entries()]
+            .map(([ts, value]) => ({ ts, value }))
+            .sort((a, b) => a.ts - b.ts);
+    }
+}
+exports.RedisMetricsHistoryProvider = RedisMetricsHistoryProvider;
+function dayFloor(ms) {
+    const d = new Date(ms);
+    return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
+}
+//# sourceMappingURL=RedisMetricsHistoryProvider.js.map

package/dist/RedisMetricsHistoryProvider.js.map

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

package/dist/dataMapping.d.ts

@@ -0,0 +1,12 @@
+import type { QueueMetrics } from '@bull-board/api/typings/app';
+export interface MinutePoint {
+    /** Absolute minute index: Math.floor(timestampMs / 60000). */
+    minute: number;
+    value: number;
+}
+/**
+ * Maps BullMQ's getMetrics() data (newest-first) to (minute, value) points.
+ * data[i] -> minute index floor(prevTS/60000) - 1 - i. The in-progress current
+ * minute is never present in data, so every point returned here is immutable.
+ */
+export declare function metricsToMinutePoints(metrics: QueueMetrics | null | undefined): MinutePoint[];

package/dist/dataMapping.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metricsToMinutePoints = metricsToMinutePoints;
+const MS_PER_MINUTE = 60000;
+/**
+ * Maps BullMQ's getMetrics() data (newest-first) to (minute, value) points.
+ * data[i] -> minute index floor(prevTS/60000) - 1 - i. The in-progress current
+ * minute is never present in data, so every point returned here is immutable.
+ */
+function metricsToMinutePoints(metrics) {
+    var _a, _b;
+    if (!metrics || !metrics.data || metrics.data.length === 0) {
+        return [];
+    }
+    const prevTS = (_b = (_a = metrics.meta) === null || _a === void 0 ? void 0 : _a.prevTS) !== null && _b !== void 0 ? _b : 0;
+    const newestMinute = Math.floor(prevTS / MS_PER_MINUTE) - 1;
+    const points = [];
+    for (let i = 0; i < metrics.data.length; i++) {
+        const minute = newestMinute - i;
+        if (minute < 0) {
+            break;
+        }
+        points.push({ minute, value: Number(metrics.data[i]) || 0 });
+    }
+    return points;
+}
+//# sourceMappingURL=dataMapping.js.map

package/dist/dataMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataMapping.js","sourceRoot":"","sources":["../src/dataMapping.ts"],"names":[],"mappings":";;AAeA,sDAgBC;AAvBD,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,OAAwC;;IAC5E,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,MAAA,MAAA,OAAO,CAAC,IAAI,0CAAE,MAAM,mCAAI,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,YAAY,GAAG,CAAC,CAAC;QAChC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM;QACR,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { MetricsHistoryAdmin } from './HistoryAdmin';
+export type { HistoryQueueStats, HistoryStats, MetricsHistoryAdminOptions, PurgeOptions, PurgeResult, } from './HistoryAdmin';
+export { MetricsRecorder } from './MetricsRecorder';
+export type { MetricsRecorderOptions } from './MetricsRecorder';
+export { RedisMetricsHistoryProvider } from './RedisMetricsHistoryProvider';
+export type { RedisMetricsHistoryProviderOptions } from './RedisMetricsHistoryProvider';

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisMetricsHistoryProvider = exports.MetricsRecorder = exports.MetricsHistoryAdmin = void 0;
+var HistoryAdmin_1 = require("./HistoryAdmin");
+Object.defineProperty(exports, "MetricsHistoryAdmin", { enumerable: true, get: function () { return HistoryAdmin_1.MetricsHistoryAdmin; } });
+var MetricsRecorder_1 = require("./MetricsRecorder");
+Object.defineProperty(exports, "MetricsRecorder", { enumerable: true, get: function () { return MetricsRecorder_1.MetricsRecorder; } });
+var RedisMetricsHistoryProvider_1 = require("./RedisMetricsHistoryProvider");
+Object.defineProperty(exports, "RedisMetricsHistoryProvider", { enumerable: true, get: function () { return RedisMetricsHistoryProvider_1.RedisMetricsHistoryProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAAqD;AAA5C,mHAAA,mBAAmB,OAAA;AAQ5B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAExB,6EAA4E;AAAnE,0IAAA,2BAA2B,OAAA"}

package/dist/keys.d.ts

@@ -0,0 +1,13 @@
+export declare const NAMESPACE = "bull-board:metrics";
+export declare const GLOBAL_QUEUE = "__global__";
+/** Marks the hourly rollup key so it can't be mistaken for a minute-level day hash. */
+export declare const HOUR_TIER = "hour";
+export declare function minuteToDay(minute: number): string;
+/** Absolute hour index, the hourly counterpart of the absolute minute index. */
+export declare function minuteToHour(minute: number): number;
+export declare function dayHashKey(queue: string, metric: string, day: string): string;
+export declare function hourHashKey(queue: string, metric: string, day: string): string;
+export declare function totalsHashKey(queue: string, metric: string): string;
+export declare function shiftDay(day: string, offsetDays: number): string;
+export declare function dayToStartMs(day: string): number;
+export declare function dayRange(fromMs: number, toMs: number): string[];

package/dist/keys.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HOUR_TIER = exports.GLOBAL_QUEUE = exports.NAMESPACE = void 0;
+exports.minuteToDay = minuteToDay;
+exports.minuteToHour = minuteToHour;
+exports.dayHashKey = dayHashKey;
+exports.hourHashKey = hourHashKey;
+exports.totalsHashKey = totalsHashKey;
+exports.shiftDay = shiftDay;
+exports.dayToStartMs = dayToStartMs;
+exports.dayRange = dayRange;
+exports.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';
+const MS_PER_MINUTE = 60000;
+const MS_PER_DAY = 86400000;
+const MINUTES_PER_HOUR = 60;
+function pad(n) {
+    return n < 10 ? `0${n}` : String(n);
+}
+function msToDay(ms) {
+    const d = new Date(ms);
+    return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+}
+function minuteToDay(minute) {
+    return msToDay(minute * MS_PER_MINUTE);
+}
+/** Absolute hour index, the hourly counterpart of the absolute minute index. */
+function minuteToHour(minute) {
+    return Math.floor(minute / MINUTES_PER_HOUR);
+}
+function dayHashKey(queue, metric, day) {
+    return `${exports.NAMESPACE}:${queue}:${metric}:${day}`;
+}
+function hourHashKey(queue, metric, day) {
+    return `${exports.NAMESPACE}:${queue}:${metric}:${exports.HOUR_TIER}:${day}`;
+}
+function totalsHashKey(queue, metric) {
+    return `${exports.NAMESPACE}:${queue}:${metric}:totals`;
+}
+function shiftDay(day, offsetDays) {
+    return msToDay(dayToStartMs(day) + offsetDays * MS_PER_DAY);
+}
+function dayToStartMs(day) {
+    const [y, m, d] = day.split('-').map(Number);
+    return Date.UTC(y, m - 1, d);
+}
+function dayRange(fromMs, toMs) {
+    const days = [];
+    let cursor = Date.UTC(new Date(fromMs).getUTCFullYear(), new Date(fromMs).getUTCMonth(), new Date(fromMs).getUTCDate());
+    const end = toMs;
+    while (cursor <= end) {
+        days.push(msToDay(cursor));
+        cursor += MS_PER_DAY;
+    }
+    return days;
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":";;;AAkBA,kCAEC;AAGD,oCAEC;AAED,gCAEC;AAED,kCAEC;AAED,sCAEC;AAED,4BAEC;AAED,oCAGC;AAED,4BAaC;AA7DY,QAAA,SAAS,GAAG,oBAAoB,CAAC;AACjC,QAAA,YAAY,GAAG,YAAY,CAAC;AACzC,uFAAuF;AAC1E,QAAA,SAAS,GAAG,MAAM,CAAC;AAEhC,MAAM,aAAa,GAAG,KAAK,CAAC;AAC5B,MAAM,UAAU,GAAG,QAAQ,CAAC;AAC5B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,OAAO,CAAC,EAAU;IACzB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,OAAO,GAAG,CAAC,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,SAAgB,WAAW,CAAC,MAAc;IACxC,OAAO,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;AACzC,CAAC;AAED,gFAAgF;AAChF,SAAgB,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa,EAAE,MAAc,EAAE,GAAW;IACnE,OAAO,GAAG,iBAAS,IAAI,KAAK,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;AAClD,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,GAAW;IACpE,OAAO,GAAG,iBAAS,IAAI,KAAK,IAAI,MAAM,IAAI,iBAAS,IAAI,GAAG,EAAE,CAAC;AAC/D,CAAC;AAED,SAAgB,aAAa,CAAC,KAAa,EAAE,MAAc;IACzD,OAAO,GAAG,iBAAS,IAAI,KAAK,IAAI,MAAM,SAAS,CAAC;AAClD,CAAC;AAED,SAAgB,QAAQ,CAAC,GAAW,EAAE,UAAkB;IACtD,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,SAAgB,YAAY,CAAC,GAAW;IACtC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,SAAgB,QAAQ,CAAC,MAAc,EAAE,IAAY;IACnD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CACnB,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE,EACjC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAC9B,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAC9B,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC;IACjB,OAAO,MAAM,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,UAAU,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,7 +1,49 @@
 {
   "name": "@bull-board/metrics",
-  "version": "0.0.0",
-  "description": "Stub package for npm trusted publishing setup",
-  "main": "index.js",
-  "publishConfig": { "access": "public" }
+  "version": "8.3.0",
+  "description": "Opt-in long-retention historical job metrics recorder and provider for bull-board.",
+  "keywords": [
+    "bull",
+    "bullmq",
+    "dashboard",
+    "metrics",
+    "history",
+    "queue",
+    "redis"
+  ],
+  "license": "MIT",
+  "author": "felixmosh",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/felixmosh/bull-board.git",
+    "directory": "packages/metrics"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "yarn clean && tsc",
+    "clean": "rm -rf dist",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@bull-board/api": "8.3.0"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.20.0",
+    "bullmq": "^5.80.9",
+    "ioredis": "^5.11.1",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.11",
+    "typescript": "^5.9.3"
+  }
 }

package/index.js

@@ -1 +0,0 @@
-module.exports = {};