@dudousxd/nestjs-telescope-bullmq 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,78 @@
+# @dudousxd/nestjs-telescope-bullmq
+
+## 1.0.0
+
+### Minor Changes
+
+- [`73b50ad`](https://github.com/DavideCarvalho/nestjs-telescope/commit/73b50ad00193127271fdec36ad080d2858045922) - Add the BullMQ job watcher (`@dudousxd/nestjs-telescope-bullmq`). It discovers
+  `@nestjs/bullmq` `WorkerHost` processors and wraps each job in a `'queue'` batch,
+  capturing job outcome/duration/attempts and correlating the queries and
+  exceptions a job emits to that job. Core now imports `DiscoveryModule` so
+  discovery-based watchers can resolve `DiscoveryService`, and the canonical
+  `JobContent` gains `id` and `maxAttempts`.
+
+- [`a9f517c`](https://github.com/DavideCarvalho/nestjs-telescope/commit/a9f517c076461aef55cfb90d072ec38427ace91b) - Add gated queue **mutation** endpoints on top of the live-queue reads. The core
+  controller now exposes `POST /telescope/api/queues/live/:driver/:queue/jobs/:id/:action`
+  (`retry` / `remove` / `promote`) and `POST .../actions/:action` (`retry-all`,
+  `redrive`), each carrying `:action` so a single `TelescopeActionGuard` authorizes
+  them uniformly.
+
+  Mutations are **default-deny**: they run behind a new `authorizeAction` option
+  _in addition to_ the read `authorizer`, and the guard fails closed. Without an
+  `authorizeAction` callback every mutation returns `403` — even for callers the
+  read authorizer already trusts. `authorizeAction(ctx, { driver, queue, action,
+jobId?, state? })` opts in; returning falsy or throwing denies.
+
+  `BullMqQueueManager` implements `retry` / `remove` / `promote` / `retryAll`
+  against the real BullMQ `Job.retry()` / `Job.remove()` / `Job.promote()` and
+  `Queue.retryJobs()` APIs (`retryAll` returns the pre-action count for the state).
+  `redrive` remains SQS-only and returns `405` on the bullmq driver.
+
+- [`9d8eb65`](https://github.com/DavideCarvalho/nestjs-telescope/commit/9d8eb6562a7584801d5aa8b74491091f0fade5f9) - Let operators **enqueue (send) a new job/message** onto a queue from the dashboard.
+
+  Core adds an optional `enqueue?(queue, payload, opts, ctx)` method to the
+  `QueueManager` SPI and a new `POST /telescope/api/queues/live/:driver/:queue/enqueue`
+  route. Unlike the other mutations it carries a JSON body (`{ name?, payload }`),
+  so it lives on its own path rather than under `:action` — but it flows through the
+  same default-deny `TelescopeActionGuard` as `retry` / `remove` / `redrive`: the
+  guard recovers the `enqueue` action from the request path, so without an
+  `authorizeAction` callback it returns `403`. The route returns `400` when the
+  payload is absent and `404` when the driver is unknown or doesn't implement
+  `enqueue`. `enqueue` is added to `QUEUE_ACTIONS` and advertised in the
+  `/queues/live` `actionsByDriver` capabilities when a manager implements it.
+
+  `BullMqQueueManager` implements `enqueue` via the real `Queue.add(name, data)`
+  (defaulting the name to `manual`), returning the new job id.
+
+  The UI gains an "Send message" form on the queue console — shown only when the
+  selected driver advertises `enqueue` and mutations are enabled. It parses the
+  payload textarea as JSON (invalid JSON surfaces inline without calling the API),
+  posts via a new `queueEnqueue` client method, and on success confirms and
+  refreshes the queue counts/jobs. A `403` surfaces inline as "Not authorized".
+
+- [`418f1f0`](https://github.com/DavideCarvalho/nestjs-telescope/commit/418f1f0421948b40b25f845441a716fa4c6655c2) - Add a driver-agnostic live-queue read layer. Core gains the `QueueManager` SPI
+  (`QueueManager`, `QueueManagerContext`, `QueueManagerRegistry`) and its DTO types
+  (`QueueState`, `QueueCounts`, `QueueSummary`, `QueueJob`, `QueueJobDetail`,
+  `JobPage`), wired through a `queueManagers` option on `TelescopeModule.forRoot`
+  and surfaced as read endpoints under the existing authorizer:
+  `GET /telescope/api/queues/live`, `…/live/:driver/:queue/counts`,
+  `…/live/:driver/:queue/jobs?state=`, and `…/live/:driver/:queue/jobs/:id`.
+
+  `@dudousxd/nestjs-telescope-bullmq` adds `BullMqQueueManager`, which discovers
+  `@nestjs/bullmq` `Queue` instances via `DiscoveryService` (duck-typed, optional
+  explicit allow-list) and reads them through the BullMQ `Queue` API to report
+  live counts, the jobs in each list, and per-job detail. Job payloads are passed
+  through core redaction before leaving the server. Reads only this phase — queue
+  actions (retry/remove/promote/redrive) land in Phase 2.
+
+- [`de29d2f`](https://github.com/DavideCarvalho/nestjs-telescope/commit/de29d2f519b1f25bc702c9dcc737d99b4751c8c9) - Add Horizon-style queue metrics. A new `GET /telescope/api/queues?window=1h`
+  endpoint aggregates captured `job` entries into per-queue throughput, runtime
+  and wait-time percentiles, and failure rate (`QueueMetricsService` +
+  `aggregateQueueMetrics`). The BullMQ watcher now captures `waitMs`
+  (`processedOn − enqueue`) on each job, and the canonical `JobContent` gains a
+  `waitMs` field. `durationToMs` is extracted as a shared, exported util.
+
+### Patch Changes
+
+- Updated dependencies [[`73b50ad`](https://github.com/DavideCarvalho/nestjs-telescope/commit/73b50ad00193127271fdec36ad080d2858045922), [`9126bb0`](https://github.com/DavideCarvalho/nestjs-telescope/commit/9126bb04777cdaec6af3b0a1c5fe6f91d055ce82), [`1f00e62`](https://github.com/DavideCarvalho/nestjs-telescope/commit/1f00e62c8e60482b64251813680a5f866ef1619a), [`090cd1f`](https://github.com/DavideCarvalho/nestjs-telescope/commit/090cd1ff871dbe46c1c877a26f90496550b5304c), [`b7326b3`](https://github.com/DavideCarvalho/nestjs-telescope/commit/b7326b33d8d55b5f1ac5de4256f5e1980278699e), [`bfc0e26`](https://github.com/DavideCarvalho/nestjs-telescope/commit/bfc0e268388b5563d05c24e4de6ff99c74d1201a), [`7797a2a`](https://github.com/DavideCarvalho/nestjs-telescope/commit/7797a2a1554aff49bb59f5ca1b204974a7e04a41), [`6817fe6`](https://github.com/DavideCarvalho/nestjs-telescope/commit/6817fe62775b1ff847fdb1038d3298e7709569e0), [`20ceb87`](https://github.com/DavideCarvalho/nestjs-telescope/commit/20ceb878cd4495dfbc7a3c71d882ae216a633757), [`1dd4db0`](https://github.com/DavideCarvalho/nestjs-telescope/commit/1dd4db0f3cd46d04b35ac112343cfb424c2d3190), [`a9f517c`](https://github.com/DavideCarvalho/nestjs-telescope/commit/a9f517c076461aef55cfb90d072ec38427ace91b), [`9d8eb65`](https://github.com/DavideCarvalho/nestjs-telescope/commit/9d8eb6562a7584801d5aa8b74491091f0fade5f9), [`418f1f0`](https://github.com/DavideCarvalho/nestjs-telescope/commit/418f1f0421948b40b25f845441a716fa4c6655c2), [`e76980d`](https://github.com/DavideCarvalho/nestjs-telescope/commit/e76980ddd7ee740f1b337a422a98ca98d97a007e), [`80c8f97`](https://github.com/DavideCarvalho/nestjs-telescope/commit/80c8f9769c8ab9ee724635086740910bc4d44ea3), [`e14ac60`](https://github.com/DavideCarvalho/nestjs-telescope/commit/e14ac603551372fc3767c63a349c509582b5e6ab), [`6fa0946`](https://github.com/DavideCarvalho/nestjs-telescope/commit/6fa0946f5543868704864af2e32793eb448ac827), [`d507547`](https://github.com/DavideCarvalho/nestjs-telescope/commit/d507547df3c13e76e90b8a97c4e3e1d8aef25bd1), [`affd07e`](https://github.com/DavideCarvalho/nestjs-telescope/commit/affd07e4cb9ee85cfabaabed424833e8c638d04a), [`6a4d8d5`](https://github.com/DavideCarvalho/nestjs-telescope/commit/6a4d8d56321d3840fe64e646130ccfdafcfb1bdd), [`c1f1ec9`](https://github.com/DavideCarvalho/nestjs-telescope/commit/c1f1ec903d470d6b884924e2713de305b61b7481), [`cad6dae`](https://github.com/DavideCarvalho/nestjs-telescope/commit/cad6dae0dba4f22e476d78c23ce2f74f7f6848e4), [`c8596c8`](https://github.com/DavideCarvalho/nestjs-telescope/commit/c8596c85712880cb235e8cce059a1d93d339e9bd), [`c4222b1`](https://github.com/DavideCarvalho/nestjs-telescope/commit/c4222b16ef4c0fc9c61694eb67033f03369ff24e), [`de29d2f`](https://github.com/DavideCarvalho/nestjs-telescope/commit/de29d2f519b1f25bc702c9dcc737d99b4751c8c9), [`10a3bc2`](https://github.com/DavideCarvalho/nestjs-telescope/commit/10a3bc224f6e0b1a237e1e7631acad70493b4c12), [`abde392`](https://github.com/DavideCarvalho/nestjs-telescope/commit/abde39264effb31b0524cc4fa89a335276c8dccb), [`8ff32a2`](https://github.com/DavideCarvalho/nestjs-telescope/commit/8ff32a2cc95775224eea3377460d91674dfda47f), [`5f2eddd`](https://github.com/DavideCarvalho/nestjs-telescope/commit/5f2eddd0ed5d72bf1de323b45870d7ddcaf64349), [`b14a201`](https://github.com/DavideCarvalho/nestjs-telescope/commit/b14a20175eae3d3017e8cbc068d367a03f634175), [`a90ef56`](https://github.com/DavideCarvalho/nestjs-telescope/commit/a90ef569ba12484bece07d8de2045e13ff2ff528), [`593bcc8`](https://github.com/DavideCarvalho/nestjs-telescope/commit/593bcc85ad6558040c62ba66bd1e5e0cbe5a6ac7), [`7b6636b`](https://github.com/DavideCarvalho/nestjs-telescope/commit/7b6636b54438427cd53ea0cbedd186b77d807169), [`e64f35a`](https://github.com/DavideCarvalho/nestjs-telescope/commit/e64f35a1bb7cae15b2ef24404888463d04f81eef), [`4892ef6`](https://github.com/DavideCarvalho/nestjs-telescope/commit/4892ef61e45e5486d34c7ec82764e6767fe8233d)]:
+  - @dudousxd/nestjs-telescope@1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Davi Carvalho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,145 @@
+# @dudousxd/nestjs-telescope-bullmq
+
+BullMQ job watcher for [`@dudousxd/nestjs-telescope`](../../README.md). Captures
+every job (id, name, queue, outcome, duration, attempts) and correlates the
+queries and exceptions a job emits to that job's batch.
+
+## Install
+
+```bash
+pnpm add @dudousxd/nestjs-telescope-bullmq
+```
+
+Peer deps: `@dudousxd/nestjs-telescope`, `@nestjs/bullmq`, `bullmq`,
+`@nestjs/common`, `@nestjs/core`, `reflect-metadata`.
+
+## Usage
+
+Add the watcher to `TelescopeModule`. No host wiring is required — the watcher
+discovers your `@Processor` (`WorkerHost`) classes and instruments them
+automatically.
+
+```ts
+import { TelescopeModule } from '@dudousxd/nestjs-telescope';
+import { BullMqJobWatcher } from '@dudousxd/nestjs-telescope-bullmq';
+
+@Module({
+  imports: [
+    TelescopeModule.forRoot({
+      watchers: [new BullMqJobWatcher({ slowMs: 1000 })],
+    }),
+    // ...your BullModule.registerQueue(...) and @Processor classes
+  ],
+})
+export class AppModule {}
+```
+
+Each processed job becomes a `job` entry with `origin: 'queue'`. Queries and
+exceptions emitted while the job runs share the job's `batchId`, so opening a
+job in the dashboard shows everything it caused.
+
+With these entries captured, the core endpoint
+`GET /telescope/api/queues?window=1h` reports per-queue throughput, runtime and
+wait-time percentiles, and failure rate (wait time = `processedOn − enqueue`).
+
+## Live queue reads (`BullMqQueueManager`)
+
+The watcher above records *what jobs did*. `BullMqQueueManager` is the
+complementary read side: it browses your queues' **current** state directly via
+the BullMQ `Queue` API (counts, paused flag, and the jobs sitting in each list),
+so the dashboard can show live queue depth and inspect individual jobs.
+
+It is a `QueueManager`, passed via the `queueManagers` option (not `watchers`).
+At bootstrap it discovers every `@nestjs/bullmq` `Queue` instance in the Nest
+container through `DiscoveryService` (duck-typed — no extra wiring):
+
+```ts
+import { TelescopeModule } from '@dudousxd/nestjs-telescope';
+import { BullMqQueueManager } from '@dudousxd/nestjs-telescope-bullmq';
+
+@Module({
+  imports: [
+    TelescopeModule.forRoot({
+      queueManagers: [new BullMqQueueManager()],
+    }),
+    BullModule.forRoot({ connection }),
+    BullModule.registerQueue({ name: 'mail' }),
+  ],
+})
+export class AppModule {}
+```
+
+Pass an explicit allow-list to expose only some queues:
+`new BullMqQueueManager(['mail', 'reports'])`.
+
+This surfaces these read endpoints on the core controller, under the **existing
+Telescope authorizer** (same gate as the rest of the dashboard):
+
+| Method & path | Returns |
+|---------------|---------|
+| `GET /telescope/api/queues/live` | `{ queues: QueueSummary[] }` across all drivers — name, per-state counts, `isPaused`. |
+| `GET /telescope/api/queues/live/bullmq/:queue/counts` | `QueueCounts` for one queue. |
+| `GET /telescope/api/queues/live/bullmq/:queue/jobs?state=&cursor=&limit=` | A `JobPage` of jobs in `state` (`waiting`/`active`/`delayed`/`failed`/`completed`/`paused`); `nextCursor` paginates. |
+| `GET /telescope/api/queues/live/bullmq/:queue/jobs/:id` | A `QueueJobDetail` (adds redacted `data`, `opts`, `stacktrace`, `returnValue`). |
+
+Job payloads (`data`) are passed through core redaction before they leave the
+server, so secret-keyed fields (e.g. `password`, `token`) are masked.
+
+## Queue actions (mutations)
+
+`BullMqQueueManager` also implements the action side of the `QueueManager` SPI —
+`retry`, `remove`, `promote`, and `retryAll` — backed by the real BullMQ
+`Job.retry()` / `Job.remove()` / `Job.promote()` and `Queue.retryJobs()` APIs.
+These surface as **POST** endpoints on the core controller:
+
+| Method & path | Effect |
+|---------------|--------|
+| `POST /telescope/api/queues/live/bullmq/:queue/jobs/:id/retry` | Re-queue a failed (or completed) job. |
+| `POST /telescope/api/queues/live/bullmq/:queue/jobs/:id/remove` | Delete a job. |
+| `POST /telescope/api/queues/live/bullmq/:queue/jobs/:id/promote` | Promote a delayed job to run now. |
+| `POST /telescope/api/queues/live/bullmq/:queue/actions/retry-all?state=failed` | Bulk re-queue every job in `state`; responds `{ ok: true, count }` (the pre-action count). |
+
+`redrive` is **SQS-only** and is not implemented by `BullMqQueueManager`; calling
+`.../actions/redrive` against the bullmq driver returns `405 Method Not Allowed`.
+
+### Enabling mutations — `authorizeAction` (default-deny)
+
+Mutations are **denied by default**. They run behind a second guard
+(`TelescopeActionGuard`) on top of the read `authorizer`, and that guard fails
+closed: **without an `authorizeAction` callback, every mutation endpoint returns
+`403`** — even for callers the read `authorizer` already trusts. Opt in by
+supplying `authorizeAction` on `TelescopeModule.forRoot`:
+
+```ts
+TelescopeModule.forRoot({
+  // Reads (browse queues/jobs) — the existing gate:
+  authorizer: (ctx) => isAdmin(ctx.request),
+  // Mutations (retry/remove/promote/retry-all) — separate, default-deny:
+  authorizeAction: (ctx, action) => {
+    // action: { driver, queue, action, jobId?, state? }
+    return canMutateQueues(ctx.request);
+  },
+  queueManagers: [new BullMqQueueManager()],
+});
+```
+
+`authorizeAction` receives the same `AuthorizerContext` plus a typed
+`QueueActionRequest` describing the requested mutation. Returning a falsy value —
+or throwing — denies the request (`403`). Keep it strictly narrower than your
+read gate: browsing a queue should not imply the right to drain it.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `slowMs` | `1000` | Jobs taking at least this long get a `slow` tag. |
+| `includeJobData` | `true` | Capture `job.data` as the entry payload (core redaction still applies). |
+| `clock` | wall clock | Injectable time source (for tests). |
+
+## Not included
+
+This watcher captures per-job entries; the aggregate queue metrics above are
+computed in core from those entries (`GET /telescope/api/queues`). Broader health
+rollups — N+1 insights, slowest request/query/job, top exceptions, and a visual
+dashboard — are the concern of `@dudousxd/nestjs-telescope-pulse` and
+`@dudousxd/nestjs-telescope-ui`, not this watcher.

package/dist/bull-mq-queue-manager.d.ts

@@ -0,0 +1,30 @@
+import type { JobPage, QueueCounts, QueueJobDetail, QueueManager, QueueManagerContext, QueueState, QueueSummary } from '@dudousxd/nestjs-telescope';
+export declare class BullMqQueueManager implements QueueManager {
+    private readonly queueNames?;
+    readonly driver = "bullmq";
+    private queues;
+    private redact;
+    /** @param queueNames optional explicit allow-list; default = auto-discover all. */
+    constructor(queueNames?: string[] | undefined);
+    init(ctx: QueueManagerContext): void;
+    private requireQueue;
+    private countsFor;
+    listQueues(): Promise<QueueSummary[]>;
+    counts(queue: string): Promise<QueueCounts>;
+    listJobs(queue: string, state: QueueState, page: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<JobPage>;
+    getJob(queue: string, id: string): Promise<QueueJobDetail | null>;
+    retry(queue: string, id: string): Promise<void>;
+    remove(queue: string, id: string): Promise<void>;
+    promote(queue: string, id: string): Promise<void>;
+    enqueue(queue: string, payload: unknown, opts: {
+        name?: string;
+    }): Promise<{
+        id: string | null;
+    }>;
+    retryAll(queue: string, state: QueueState): Promise<number>;
+    private toJob;
+}
+//# sourceMappingURL=bull-mq-queue-manager.d.ts.map

package/dist/bull-mq-queue-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-mq-queue-manager.d.ts","sourceRoot":"","sources":["../src/bull-mq-queue-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EAEX,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,YAAY,EACb,MAAM,4BAA4B,CAAC;AAuDpC,qBAAa,kBAAmB,YAAW,YAAY;IAMzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IALxC,QAAQ,CAAC,MAAM,YAAY;IAC3B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAAiD;IAE/D,mFAAmF;gBACtD,UAAU,CAAC,EAAE,MAAM,EAAE,YAAA;IAElD,IAAI,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAUpC,OAAO,CAAC,YAAY;YAMN,SAAS;IAmBjB,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAW3C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIrC,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxC,OAAO,CAAC,OAAO,CAAC;IAYb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAajE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,OAAO,CACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACtB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAS3B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IASjE,OAAO,CAAC,KAAK;CAcd"}

package/dist/bull-mq-queue-manager.js

@@ -0,0 +1,155 @@
+import { DiscoveryService } from '@nestjs/core';
+import { discoverQueues, hasJobOps } from './queue-discovery.js';
+// BullMQ list names accepted by Queue.getJobs()/getJobCounts(). 'waiting' maps
+// to the internal 'wait' list (BullMQ also accepts 'waiting' as an alias, but
+// 'wait' is the canonical list name). 'paused' jobs live in their own list.
+// Verified against bullmq@5.78.0 (JobType = JobState | 'paused' | 'repeat' | 'wait').
+const STATE_TO_BULL = {
+    waiting: 'wait',
+    active: 'active',
+    delayed: 'delayed',
+    failed: 'failed',
+    completed: 'completed',
+    paused: 'paused',
+};
+const DEFAULT_LIMIT = 50;
+function isBullJobLike(value) {
+    return typeof value === 'object' && value !== null;
+}
+function readMaxAttempts(opts) {
+    if (typeof opts === 'object' && opts !== null) {
+        const attempts = opts.attempts;
+        if (typeof attempts === 'number')
+            return attempts;
+    }
+    return null;
+}
+/** Best-effort state for a single fetched job (detail view, non-critical). */
+function deriveState(job) {
+    if (job.finishedOn != null) {
+        return job.failedReason != null ? 'failed' : 'completed';
+    }
+    if (job.processedOn != null)
+        return 'active';
+    return 'waiting';
+}
+export class BullMqQueueManager {
+    queueNames;
+    driver = 'bullmq';
+    queues = new Map();
+    redact = (value) => value;
+    /** @param queueNames optional explicit allow-list; default = auto-discover all. */
+    constructor(queueNames) {
+        this.queueNames = queueNames;
+    }
+    init(ctx) {
+        this.redact = ctx.redact;
+        const discovery = ctx.moduleRef.get(DiscoveryService, { strict: false });
+        for (const queue of discoverQueues(discovery)) {
+            if (!this.queueNames || this.queueNames.includes(queue.name)) {
+                this.queues.set(queue.name, queue);
+            }
+        }
+    }
+    requireQueue(queue) {
+        const found = this.queues.get(queue);
+        if (!found)
+            throw new Error(`Unknown bullmq queue: ${queue}`);
+        return found;
+    }
+    async countsFor(queue) {
+        const counts = await queue.getJobCounts('waiting', 'active', 'delayed', 'failed', 'completed', 'paused');
+        return {
+            waiting: counts.waiting ?? 0,
+            active: counts.active ?? 0,
+            delayed: counts.delayed ?? 0,
+            failed: counts.failed ?? 0,
+            completed: counts.completed ?? 0,
+            paused: counts.paused ?? 0,
+        };
+    }
+    async listQueues() {
+        return Promise.all([...this.queues.values()].map(async (queue) => ({
+            driver: this.driver,
+            queue: queue.name,
+            counts: await this.countsFor(queue),
+            isPaused: await queue.isPaused(),
+        })));
+    }
+    counts(queue) {
+        return this.countsFor(this.requireQueue(queue));
+    }
+    async listJobs(queue, state, page) {
+        const target = this.requireQueue(queue);
+        const limit = page.limit && page.limit > 0 ? page.limit : DEFAULT_LIMIT;
+        const start = page.cursor ? Math.max(0, Number.parseInt(page.cursor, 10) || 0) : 0;
+        // Fetch one extra (end inclusive: start..start+limit) to detect a next page.
+        const raw = await target.getJobs(STATE_TO_BULL[state], start, start + limit, false);
+        const bullJobs = raw.filter(isBullJobLike);
+        const jobs = bullJobs.slice(0, limit).map((job) => this.toJob(job, state));
+        const nextCursor = bullJobs.length > limit ? String(start + limit) : null;
+        return { jobs, nextCursor, total: null };
+    }
+    async getJob(queue, id) {
+        const raw = await this.requireQueue(queue).getJob(id);
+        if (!isBullJobLike(raw))
+            return null;
+        const base = this.toJob(raw, deriveState(raw));
+        return {
+            ...base,
+            data: this.redact(raw.data),
+            opts: raw.opts ?? null,
+            stacktrace: Array.isArray(raw.stacktrace) ? raw.stacktrace : null,
+            returnValue: raw.returnvalue ?? null,
+        };
+    }
+    async retry(queue, id) {
+        const job = await this.requireQueue(queue).getJob(id);
+        if (!hasJobOps(job))
+            throw new Error(`Job ${id} not found in ${queue}`);
+        await job.retry();
+    }
+    async remove(queue, id) {
+        const job = await this.requireQueue(queue).getJob(id);
+        if (!hasJobOps(job))
+            throw new Error(`Job ${id} not found in ${queue}`);
+        await job.remove();
+    }
+    async promote(queue, id) {
+        const job = await this.requireQueue(queue).getJob(id);
+        if (!hasJobOps(job))
+            throw new Error(`Job ${id} not found in ${queue}`);
+        await job.promote();
+    }
+    async enqueue(queue, payload, opts) {
+        const target = this.requireQueue(queue);
+        if (typeof target.add !== 'function') {
+            throw new Error(`bullmq queue ${queue} cannot enqueue`);
+        }
+        const job = await target.add(opts.name ?? 'manual', payload);
+        return { id: job.id ?? null };
+    }
+    async retryAll(queue, state) {
+        const target = this.requireQueue(queue);
+        const before = (await this.countsFor(target))[state] ?? 0;
+        if (typeof target.retryJobs === 'function') {
+            await target.retryJobs({ state: STATE_TO_BULL[state] });
+        }
+        return before;
+    }
+    toJob(job, state) {
+        return {
+            id: String(job.id ?? ''),
+            name: job.name ?? '',
+            state,
+            attemptsMade: job.attemptsMade ?? 0,
+            maxAttempts: readMaxAttempts(job.opts),
+            timestamp: job.timestamp ?? null,
+            processedOn: job.processedOn ?? null,
+            finishedOn: job.finishedOn ?? null,
+            failedReason: job.failedReason ?? null,
+            progress: typeof job.progress === 'number' ? job.progress : null,
+        };
+    }
+}
+//# sourceMappingURL=bull-mq-queue-manager.js.map

package/dist/bull-mq-queue-manager.js.map

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

package/dist/bullmq-job.watcher.d.ts

@@ -0,0 +1,52 @@
+import { type Watcher, type WatcherContext } from '@dudousxd/nestjs-telescope';
+export interface BullMqJobWatcherOptions {
+    /** Jobs whose processing time is >= this (ms) get a 'slow' tag. Default 1000. */
+    slowMs?: number;
+    /** Capture `job.data` as the entry payload. Default true (core redaction applies). */
+    includeJobData?: boolean;
+    /** Time source; injectable for tests. Default wall clock. */
+    clock?: {
+        now(): number;
+    };
+}
+/**
+ * Captures BullMQ jobs and correlates each job's queries/exceptions to its batch.
+ *
+ * ## How it works
+ * At registration the watcher uses NestJS `DiscoveryService` to find every
+ * `WorkerHost` provider and replaces its subclass-prototype `process` method
+ * with a wrapper that runs the original inside `ctx.runInBatch('queue', ...)`.
+ *
+ * `@nestjs/bullmq` resolves `instance.process(job, token)` at call-time per job
+ * (to support request-scoped processors), and jobs only run after the app has
+ * bootstrapped -- so a prototype patch applied during `register()` (which the
+ * registrar invokes at `onApplicationBootstrap`) always precedes the first job.
+ *
+ * The wrapper never swallows the host's error: on failure it records a `failed`
+ * job entry and re-throws so BullMQ's own retry/lifecycle is unaffected.
+ *
+ * @remarks
+ * Processor detection uses `instanceof WorkerHost`. If the host application
+ * resolves two distinct copies of `@nestjs/bullmq` in its module tree,
+ * processors from the other copy won't match and will be left un-instrumented
+ * (surfaced only by the "no processors found" warning). A single, deduped
+ * `@nestjs/bullmq` is assumed.
+ */
+export declare class BullMqJobWatcher implements Watcher {
+    readonly type: "job";
+    private readonly logger;
+    private readonly slowMs;
+    private readonly includeJobData;
+    private readonly clock;
+    /** Prototypes already patched, so shared prototypes wrap exactly once. */
+    private readonly patched;
+    constructor(options?: BullMqJobWatcherOptions);
+    register(ctx: WatcherContext): Promise<void>;
+    private patchProcess;
+    /** Build + hand a job entry to the Recorder, swallowing any failure. Core's
+     *  record() is already non-throwing; this double-guard keeps the watcher safe
+     *  even against a custom or regressed WatcherContext, so recording can never
+     *  alter the host job's outcome. */
+    private safeRecord;
+}
+//# sourceMappingURL=bullmq-job.watcher.d.ts.map

package/dist/bullmq-job.watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq-job.watcher.d.ts","sourceRoot":"","sources":["../src/bullmq-job.watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAMpC,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6DAA6D;IAC7D,KAAK,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAA;KAAE,CAAC;CAC3B;AAWD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,gBAAiB,YAAW,OAAO;IAC9C,QAAQ,CAAC,IAAI,QAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,GAAE,uBAA4B;IAM3C,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBlD,OAAO,CAAC,YAAY;IA0BpB;;;wCAGoC;IACpC,OAAO,CAAC,UAAU;CA8BnB"}

package/dist/bullmq-job.watcher.js

@@ -0,0 +1,125 @@
+// packages/bullmq/src/bullmq-job.watcher.ts
+import { EntryType, } from '@dudousxd/nestjs-telescope';
+import { WorkerHost } from '@nestjs/bullmq';
+import { Logger } from '@nestjs/common';
+import { DiscoveryService } from '@nestjs/core';
+import { buildJobContent } from './job-content.js';
+/** Narrow an unknown BullMQ job to the structural `JobLike` we read. Every field
+ *  is accessed defensively in `buildJobContent`, so a non-object degrades to {}. */
+function toJobLike(job) {
+    return typeof job === 'object' && job !== null ? job : {};
+}
+/**
+ * Captures BullMQ jobs and correlates each job's queries/exceptions to its batch.
+ *
+ * ## How it works
+ * At registration the watcher uses NestJS `DiscoveryService` to find every
+ * `WorkerHost` provider and replaces its subclass-prototype `process` method
+ * with a wrapper that runs the original inside `ctx.runInBatch('queue', ...)`.
+ *
+ * `@nestjs/bullmq` resolves `instance.process(job, token)` at call-time per job
+ * (to support request-scoped processors), and jobs only run after the app has
+ * bootstrapped -- so a prototype patch applied during `register()` (which the
+ * registrar invokes at `onApplicationBootstrap`) always precedes the first job.
+ *
+ * The wrapper never swallows the host's error: on failure it records a `failed`
+ * job entry and re-throws so BullMQ's own retry/lifecycle is unaffected.
+ *
+ * @remarks
+ * Processor detection uses `instanceof WorkerHost`. If the host application
+ * resolves two distinct copies of `@nestjs/bullmq` in its module tree,
+ * processors from the other copy won't match and will be left un-instrumented
+ * (surfaced only by the "no processors found" warning). A single, deduped
+ * `@nestjs/bullmq` is assumed.
+ */
+export class BullMqJobWatcher {
+    type = EntryType.Job;
+    logger = new Logger(BullMqJobWatcher.name);
+    slowMs;
+    includeJobData;
+    clock;
+    /** Prototypes already patched, so shared prototypes wrap exactly once. */
+    patched = new WeakSet();
+    constructor(options = {}) {
+        this.slowMs = options.slowMs ?? 1000;
+        this.includeJobData = options.includeJobData ?? true;
+        this.clock = options.clock ?? { now: () => Date.now() };
+    }
+    async register(ctx) {
+        const discovery = ctx.moduleRef.get(DiscoveryService, { strict: false });
+        let count = 0;
+        for (const wrapper of discovery.getProviders()) {
+            const instance = wrapper.instance;
+            if (!(instance instanceof WorkerHost))
+                continue;
+            const proto = Object.getPrototypeOf(instance);
+            if (this.patched.has(proto))
+                continue;
+            this.patched.add(proto);
+            this.patchProcess(proto, ctx);
+            count++;
+        }
+        if (count === 0) {
+            this.logger.warn('BullMqJobWatcher: no @Processor (WorkerHost) providers found. ' +
+                'Jobs will not be captured. Ensure your processors are registered before Telescope bootstraps.');
+        }
+        else {
+            this.logger.log(`BullMqJobWatcher: instrumented ${count} processor class(es).`);
+        }
+    }
+    patchProcess(proto, ctx) {
+        const original = proto.process;
+        if (typeof original !== 'function')
+            return;
+        const watcher = this;
+        proto.process = function patchedProcess(job, token) {
+            return ctx.runInBatch('queue', async () => {
+                const startedAt = watcher.clock.now();
+                try {
+                    const result = await original.call(this, job, token);
+                    // safeRecord never throws, so a telescope failure cannot turn a
+                    // successful job into a failed one.
+                    watcher.safeRecord(ctx, job, 'completed', watcher.clock.now() - startedAt, undefined);
+                    return result;
+                }
+                catch (error) {
+                    watcher.safeRecord(ctx, job, 'failed', watcher.clock.now() - startedAt, error);
+                    throw error; // never swallow the host's error
+                }
+            });
+        };
+    }
+    /** Build + hand a job entry to the Recorder, swallowing any failure. Core's
+     *  record() is already non-throwing; this double-guard keeps the watcher safe
+     *  even against a custom or regressed WatcherContext, so recording can never
+     *  alter the host job's outcome. */
+    safeRecord(ctx, job, status, durationMs, error) {
+        try {
+            const content = buildJobContent(toJobLike(job), status, error, this.includeJobData);
+            const familyHash = [content.queue, content.name].filter(Boolean).join(':') || null;
+            const tags = [];
+            if (content.queue)
+                tags.push(`queue:${content.queue}`);
+            if (content.name)
+                tags.push(`job:${content.name}`);
+            if (status === 'failed')
+                tags.push('failed');
+            if (durationMs >= this.slowMs)
+                tags.push('slow');
+            const input = {
+                type: EntryType.Job,
+                content,
+                familyHash,
+                durationMs,
+            };
+            if (tags.length > 0)
+                input.tags = tags;
+            ctx.record(input);
+        }
+        catch (recordError) {
+            const message = recordError instanceof Error ? recordError.message : String(recordError);
+            this.logger.error(`BullMqJobWatcher: failed to record job entry: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=bullmq-job.watcher.js.map

package/dist/bullmq-job.watcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { BullMqJobWatcher } from './bullmq-job.watcher.js';
+export type { BullMqJobWatcherOptions } from './bullmq-job.watcher.js';
+export { buildJobContent } from './job-content.js';
+export type { JobLike, JobStatus } from './job-content.js';
+export { BullMqQueueManager } from './bull-mq-queue-manager.js';
+export { discoverQueues, isQueueLike } from './queue-discovery.js';
+export type { QueueLike } from './queue-discovery.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// packages/bullmq/src/index.ts
+export { BullMqJobWatcher } from './bullmq-job.watcher.js';
+export { buildJobContent } from './job-content.js';
+export { BullMqQueueManager } from './bull-mq-queue-manager.js';
+export { discoverQueues, isQueueLike } from './queue-discovery.js';
+//# 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,+BAA+B;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/job-content.d.ts

@@ -0,0 +1,25 @@
+import type { JobContent } from '@dudousxd/nestjs-telescope';
+/** The subset of a BullMQ `Job` this watcher reads. Kept structural so the
+ *  content builder needs no bullmq runtime import and is trivially testable. */
+export interface JobLike {
+    id?: string | number;
+    name?: string;
+    queueName?: string;
+    attemptsMade?: number;
+    opts?: {
+        attempts?: number;
+    };
+    data?: unknown;
+    /** Epoch ms when the job was enqueued (BullMQ `Job.timestamp`). */
+    timestamp?: number;
+    /** Epoch ms when the worker began processing (BullMQ `Job.processedOn`). */
+    processedOn?: number;
+}
+/** The outcomes this watcher records (a subset of core JobContent['status']). */
+export type JobStatus = 'completed' | 'failed';
+/** Normalize a BullMQ job + outcome into the canonical core `JobContent`.
+ *  Redaction of `payload` is applied centrally by the core Recorder, not here.
+ *  When `includeData` is false the payload is nulled (the field stays present
+ *  so the persisted shape is stable). */
+export declare function buildJobContent(job: JobLike, status: JobStatus, error: unknown, includeData: boolean): JobContent;
+//# sourceMappingURL=job-content.d.ts.map

package/dist/job-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-content.d.ts","sourceRoot":"","sources":["../src/job-content.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;gFACgF;AAChF,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAa/C;;;yCAGyC;AACzC,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,GACnB,UAAU,CAYZ"}

package/dist/job-content.js

@@ -0,0 +1,28 @@
+function failureMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function waitMsOf(job) {
+    return typeof job.processedOn === 'number' && typeof job.timestamp === 'number'
+        ? job.processedOn - job.timestamp
+        : null;
+}
+/** Normalize a BullMQ job + outcome into the canonical core `JobContent`.
+ *  Redaction of `payload` is applied centrally by the core Recorder, not here.
+ *  When `includeData` is false the payload is nulled (the field stays present
+ *  so the persisted shape is stable). */
+export function buildJobContent(job, status, error, includeData) {
+    return {
+        id: job.id != null ? String(job.id) : null,
+        name: job.name ?? '',
+        queue: job.queueName ?? '',
+        payload: includeData ? (job.data ?? null) : null,
+        status,
+        attempts: typeof job.attemptsMade === 'number' ? job.attemptsMade : 0,
+        maxAttempts: typeof job.opts?.attempts === 'number' ? job.opts.attempts : null,
+        waitMs: waitMsOf(job),
+        failureReason: status === 'failed' ? failureMessage(error) : null,
+    };
+}
+//# sourceMappingURL=job-content.js.map

package/dist/job-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-content.js","sourceRoot":"","sources":["../src/job-content.ts"],"names":[],"mappings":"AAqBA,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,QAAQ,CAAC,GAAY;IAC5B,OAAO,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAC7E,CAAC,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS;QACjC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED;;;yCAGyC;AACzC,MAAM,UAAU,eAAe,CAC7B,GAAY,EACZ,MAAiB,EACjB,KAAc,EACd,WAAoB;IAEpB,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QAC1C,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;QACpB,KAAK,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC1B,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QAChD,MAAM;QACN,QAAQ,EAAE,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrE,WAAW,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QAC9E,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC;QACrB,aAAa,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;KAClE,CAAC;AACJ,CAAC"}

package/dist/queue-discovery.d.ts

@@ -0,0 +1,36 @@
+import type { DiscoveryService } from '@nestjs/core';
+/**
+ * A duck-typed BullMQ `Queue`. We avoid importing `bullmq`'s `Queue` at runtime
+ * (and even type-only) so this helper works whether or not the consumer's
+ * esbuild/tsc setup emits the dependency — structural matching is enough to
+ * read queues through the public getter API.
+ */
+export interface QueueLike {
+    name: string;
+    getJobCounts(...types: string[]): Promise<Record<string, number>>;
+    getJobs(types: string | string[], start?: number, end?: number, asc?: boolean): Promise<unknown[]>;
+    getJob(id: string): Promise<unknown>;
+    isPaused(): Promise<boolean>;
+    retryJobs?(opts: {
+        state?: string;
+        count?: number;
+    }): Promise<void>;
+    add?(name: string, data: unknown, opts?: unknown): Promise<{
+        id?: string | null;
+    }>;
+}
+/**
+ * Structural shape of the bullmq `Job` mutation API we drive. We never import
+ * `Job` from bullmq; a single structural guard keeps the manager honest about
+ * what a fetched job must expose before we mutate it.
+ */
+export interface JobOps {
+    retry(state?: string): Promise<void>;
+    remove(): Promise<void>;
+    promote(): Promise<void>;
+}
+export declare function hasJobOps(value: unknown): value is JobOps;
+export declare function isQueueLike(value: unknown): value is QueueLike;
+/** Find all BullMQ Queue instances registered in the Nest container. */
+export declare function discoverQueues(discovery: DiscoveryService): QueueLike[];
+//# sourceMappingURL=queue-discovery.d.ts.map

package/dist/queue-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-discovery.d.ts","sourceRoot":"","sources":["../src/queue-discovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE,OAAO,CACL,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACtB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAG7B,SAAS,CAAC,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACpF;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQzD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAU9D;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,EAAE,CASvE"}

package/dist/queue-discovery.js

@@ -0,0 +1,30 @@
+export function hasJobOps(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.retry === 'function' &&
+        typeof candidate.remove === 'function' &&
+        typeof candidate.promote === 'function');
+}
+export function isQueueLike(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.name === 'string' &&
+        typeof candidate.getJobCounts === 'function' &&
+        typeof candidate.getJobs === 'function' &&
+        typeof candidate.getJob === 'function' &&
+        typeof candidate.isPaused === 'function');
+}
+/** Find all BullMQ Queue instances registered in the Nest container. */
+export function discoverQueues(discovery) {
+    const found = new Map();
+    for (const wrapper of discovery.getProviders()) {
+        const instance = wrapper.instance;
+        if (isQueueLike(instance) && !found.has(instance.name)) {
+            found.set(instance.name, instance);
+        }
+    }
+    return [...found.values()];
+}
+//# sourceMappingURL=queue-discovery.js.map

package/dist/queue-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-discovery.js","sourceRoot":"","sources":["../src/queue-discovery.ts"],"names":[],"mappings":"AAqCA,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,OAAO,CACL,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU;QACrC,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU;QACtC,OAAO,SAAS,CAAC,OAAO,KAAK,UAAU,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,OAAO,CACL,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU;QAC5C,OAAO,SAAS,CAAC,OAAO,KAAK,UAAU;QACvC,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU;QACtC,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU,CACzC,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,SAA2B;IACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC3C,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,YAAY,EAAE,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@dudousxd/nestjs-telescope-bullmq",
+  "version": "1.0.0",
+  "description": "BullMQ job watcher for @dudousxd/nestjs-telescope.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DavideCarvalho/nestjs-telescope.git",
+    "directory": "packages/bullmq"
+  },
+  "author": "Davi Carvalho <davi@goflip.ai>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "peerDependencies": {
+    "@nestjs/bullmq": ">=10.0.0",
+    "@nestjs/common": ">=10.0.0",
+    "@nestjs/core": ">=10.0.0",
+    "bullmq": ">=5.0.0",
+    "reflect-metadata": ">=0.1.13",
+    "@dudousxd/nestjs-telescope": "1.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/bullmq": "^11.0.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "@types/node": "^20.0.0",
+    "@types/supertest": "^6.0.2",
+    "bullmq": "^5.0.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "supertest": "^7.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0",
+    "@dudousxd/nestjs-telescope": "1.0.0",
+    "@dudousxd/nestjs-telescope-testing": "1.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "nestjs",
+    "telescope",
+    "bullmq",
+    "queue",
+    "jobs",
+    "observability"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}