bunqueue 2.8.0 → 2.8.2

package/dist/cli/output.js

@@ -23,16 +23,63 @@ function color(text, colorCode) {
 function str(value, fallback = '') {
     if (value === null || value === undefined)
         return fallback;
+    if (typeof value === 'string')
+        return value;
     if (typeof value === 'object')
         return JSON.stringify(value);
-    return String(value);
+    // value is narrowed to number | boolean | bigint | symbol | function — all have a defined toString.
+    return value.toString();
+}
+/**
+ * Derive a job's state from its fields when not explicitly provided.
+ * The server-side Job domain object doesn't carry an explicit `state` field
+ * (state is tracked separately in jobIndex), so responses like PULL omit it.
+ *
+ * Used only as a display fallback when the response includes a Job object
+ * but no explicit state. Conservative: errs toward 'unknown' rather than
+ * guessing 'active' for a job that may actually be in DLQ/failed/stalled.
+ *   - explicit state field present → use it
+ *   - completedAt → completed
+ *   - attempts >= maxAttempts && no completedAt → likely failed / DLQ → unknown
+ *   - startedAt && !completedAt → likely active, but not certain → unknown
+ *     for the most common pull-response case the caller (PULL) knows it's
+ *     active and will pass `state` explicitly in future iterations
+ *   - runAt > now → delayed
+ *   - else → waiting
+ */
+function deriveJobState(job) {
+    if (typeof job.state === 'string' && job.state.length > 0)
+        return job.state;
+    const completedAt = typeof job.completedAt === 'number' ? job.completedAt : 0;
+    const startedAt = typeof job.startedAt === 'number' ? job.startedAt : 0;
+    const attempts = typeof job.attempts === 'number' ? job.attempts : 0;
+    const maxAttempts = typeof job.maxAttempts === 'number' ? job.maxAttempts : 0;
+    const runAt = typeof job.runAt === 'number' ? job.runAt : 0;
+    if (completedAt > 0)
+        return 'completed';
+    // A job whose retries are exhausted with no completion is in DLQ. We can't
+    // tell from timestamps alone whether it's there or merely retrying, so
+    // surface 'unknown' rather than confidently print 'active'.
+    if (maxAttempts > 0 && attempts >= maxAttempts && startedAt > 0)
+        return 'unknown';
+    if (startedAt > 0)
+        return 'active';
+    if (runAt > Date.now())
+        return 'delayed';
+    // If we have zero signal at all (no timestamps, no state), fall back to
+    // 'unknown' rather than confidently print 'waiting'. Real responses from
+    // the server include a `runAt` (set at push time), so 'waiting' inference
+    // still triggers for real waiting jobs.
+    if (runAt === 0 && startedAt === 0 && completedAt === 0)
+        return 'unknown';
+    return 'waiting';
 }
 /** Format a job object for display */
 function formatJob(job) {
     const lines = [
         `${color('Job:', colors.bold)} ${str(job.id)}`,
         `  Queue:      ${str(job.queue)}`,
-        `  State:      ${str(job.state, 'unknown')}`,
+        `  State:      ${deriveJobState(job)}`,
         `  Priority:   ${str(job.priority)}`,
         `  Attempts:   ${str(job.attempts)}/${str(job.maxAttempts)}`,
         `  Data:       ${JSON.stringify(job.data)}`,
@@ -224,16 +271,27 @@ function formatCollection(r, command) {
     return null;
 }
 /** Format a successful response based on its content */
-function formatSuccess(response, command) {
+function formatSuccess(response, command, subcommand) {
     // Unwrap nested data wrapper (server wraps workers, webhooks, logs, metrics in {data: {...}})
     const r = unwrap(response);
     // Job created
     if ('id' in r && typeof r.id === 'string' && command === 'push') {
         return color(`Job created: ${r.id}`, colors.green);
     }
-    // Batch jobs created
+    // Batch jobs IDs returned. Wording depends on command + subcommand.
     if ('ids' in r && Array.isArray(r.ids)) {
-        return color(`Created ${r.ids.length} jobs: ${r.ids.join(', ')}`, colors.green);
+        const n = r.ids.length;
+        const idsStr = r.ids.join(', ');
+        let verb = 'Affected';
+        if (command === 'push')
+            verb = 'Created';
+        else if (command === 'queue') {
+            verb = subcommand === 'drain' ? 'Drained' : 'Cleaned';
+        }
+        else if (command === 'dlq') {
+            verb = subcommand === 'retry' ? 'Retried' : subcommand === 'purge' ? 'Purged' : 'Affected';
+        }
+        return color(`${verb} ${n} jobs${idsStr ? ': ' + idsStr : ''}`, colors.green);
     }
     // Try collection/list formats
     const collection = formatCollection(r, command);
@@ -245,9 +303,13 @@ function formatSuccess(response, command) {
     // State
     if ('state' in r)
         return `State: ${str(r.state)}`;
-    // Result
-    if ('result' in r)
+    // Result. undefined → no result stored yet (job not completed or removeOnComplete).
+    if ('result' in r) {
+        if (r.result === undefined || r.result === null) {
+            return color('No result available (job not completed or result was removed)', colors.yellow);
+        }
         return `Result: ${JSON.stringify(r.result, null, 2)}`;
+    }
     // Progress
     if ('progress' in r) {
         const msg = r.message ? ` - ${str(r.message)}` : '';
@@ -268,14 +330,14 @@ function formatSuccess(response, command) {
     return color('OK', colors.green);
 }
 /** Main output formatter */
-export function formatOutput(response, command, asJson) {
+export function formatOutput(response, command, asJson, subcommand) {
     if (asJson) {
         return JSON.stringify(response, null, 2);
     }
     if (!response.ok) {
         return formatError(str(response.error, 'Unknown error'), false);
     }
-    return formatSuccess(response, command);
+    return formatSuccess(response, command, subcommand);
 }
 /** Format error message */
 export function formatError(message, asJson) {
@@ -284,4 +346,3 @@ export function formatError(message, asJson) {
     }
     return color(`Error: ${message}`, colors.red);
 }
-//# sourceMappingURL=output.js.map

package/dist/client/bunqueue/aging.d.ts

@@ -13,4 +13,3 @@ export declare class PriorityAger<T = unknown> {
     private tick;
     destroy(): void;
 }
-//# sourceMappingURL=aging.d.ts.map

package/dist/client/bunqueue/aging.js

@@ -50,4 +50,3 @@ export class PriorityAger {
         }
     }
 }
-//# sourceMappingURL=aging.js.map

package/dist/client/bunqueue/batch.d.ts

@@ -14,4 +14,3 @@ export declare class BatchAccumulator<T = unknown, R = unknown> {
     flush(): void;
     destroy(): void;
 }
-//# sourceMappingURL=batch.d.ts.map

package/dist/client/bunqueue/batch.js

@@ -11,7 +11,7 @@ export class BatchAccumulator {
     }
     /** Build a Processor that buffers jobs into batches */
     buildProcessor() {
-        return ((job) => {
+        return (job) => {
             return new Promise((resolve, reject) => {
                 this.buffer.push({ job, resolve, reject });
                 if (this.buffer.length >= this.config.size) {
@@ -24,7 +24,7 @@ export class BatchAccumulator {
                     }, timeout);
                 }
             });
-        });
+        };
     }
     flush() {
         if (this.timer) {
@@ -57,4 +57,3 @@ export class BatchAccumulator {
         }
     }
 }
-//# sourceMappingURL=batch.js.map

package/dist/client/bunqueue/cancellation.d.ts

@@ -17,4 +17,3 @@ export declare class CancellationManager {
     /** Cancel all and clear */
     destroyAll(): void;
 }
-//# sourceMappingURL=cancellation.d.ts.map

package/dist/client/bunqueue/cancellation.js

@@ -45,4 +45,3 @@ export class CancellationManager {
         this.controllers.clear();
     }
 }
-//# sourceMappingURL=cancellation.js.map

package/dist/client/bunqueue/circuitBreaker.d.ts

@@ -18,4 +18,3 @@ export declare class WorkerCircuitBreaker {
     reset(): void;
     destroy(): void;
 }
-//# sourceMappingURL=circuitBreaker.d.ts.map

package/dist/client/bunqueue/circuitBreaker.js

@@ -65,4 +65,3 @@ export class WorkerCircuitBreaker {
         }
     }
 }
-//# sourceMappingURL=circuitBreaker.js.map

package/dist/client/bunqueue/dedupDebounce.d.ts

@@ -10,4 +10,3 @@ export declare class DedupDebounceMerger {
     get active(): boolean;
     merge(name: string, opts?: JobOptions, data?: unknown): JobOptions | undefined;
 }
-//# sourceMappingURL=dedupDebounce.d.ts.map

package/dist/client/bunqueue/dedupDebounce.js

@@ -33,4 +33,3 @@ export class DedupDebounceMerger {
         return merged;
     }
 }
-//# sourceMappingURL=dedupDebounce.js.map

package/dist/client/bunqueue/dlqRateLimit.d.ts

@@ -16,4 +16,3 @@ export declare class DlqRateLimitManager<T = unknown> {
     setGlobalRateLimit(max: number, duration?: number): void;
     removeGlobalRateLimit(): void;
 }
-//# sourceMappingURL=dlqRateLimit.d.ts.map

package/dist/client/bunqueue/dlqRateLimit.js

@@ -34,4 +34,3 @@ export class DlqRateLimitManager {
         this.queue.removeGlobalRateLimit();
     }
 }
-//# sourceMappingURL=dlqRateLimit.js.map

package/dist/client/bunqueue/retry.d.ts

@@ -6,4 +6,3 @@ import type { RetryConfig, RetryStrategy } from './types';
 export declare function calculateBackoff(strategy: RetryStrategy, attempt: number, baseDelay: number, error: Error, config: RetryConfig): number;
 /** Execute a function with retry logic */
 export declare function executeWithRetry<R>(fn: () => Promise<R>, config: RetryConfig): Promise<R>;
-//# sourceMappingURL=retry.d.ts.map

package/dist/client/bunqueue/retry.js

@@ -52,4 +52,3 @@ export function executeWithRetry(fn, config) {
     };
     return attempt(1);
 }
-//# sourceMappingURL=retry.js.map

package/dist/client/bunqueue/triggers.d.ts

@@ -15,4 +15,3 @@ export declare class TriggerManager<T = unknown, R = unknown> {
     private ensureActive;
     private fire;
 }
-//# sourceMappingURL=triggers.d.ts.map

package/dist/client/bunqueue/triggers.js

@@ -39,4 +39,3 @@ export class TriggerManager {
         }
     }
 }
-//# sourceMappingURL=triggers.js.map

package/dist/client/bunqueue/ttl.d.ts

@@ -15,4 +15,3 @@ export declare class TtlChecker {
     /** Set TTL for a specific job name */
     setNameTtl(jobName: string, ttlMs: number): void;
 }
-//# sourceMappingURL=ttl.d.ts.map

package/dist/client/bunqueue/ttl.js

@@ -28,4 +28,3 @@ export class TtlChecker {
         this.config.perName[jobName] = ttlMs;
     }
 }
-//# sourceMappingURL=ttl.js.map

package/dist/client/bunqueue/types.d.ts

@@ -145,4 +145,3 @@ export interface BunqueueOptions<T = unknown, R = unknown> {
      */
     prefixKey?: string;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/client/bunqueue/types.js

@@ -2,4 +2,3 @@
  * Bunqueue Simple Mode — Type definitions
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/client/bunqueue.d.ts

@@ -84,4 +84,3 @@ export declare class Bunqueue<T = unknown, R = unknown> {
     isPaused(): boolean;
     isClosed(): boolean;
 }
-//# sourceMappingURL=bunqueue.d.ts.map

package/dist/client/bunqueue.js

@@ -49,7 +49,7 @@ export class Bunqueue {
         }
         // eslint-disable-next-line @typescript-eslint/no-this-alias
         const self = this;
-        const wrappedProcessor = ((job) => self.processJob(job));
+        const wrappedProcessor = (job) => self.processJob(job);
         this.queue = new Queue(name, this.buildQueueOpts(opts));
         this.worker = new Worker(name, wrappedProcessor, this.buildWorkerOpts(opts));
         // DLQ & Rate Limit manager
@@ -66,12 +66,12 @@ export class Bunqueue {
     }
     buildRouteProcessor(routes) {
         const routeMap = routes;
-        return ((job) => {
+        return (job) => {
             const handler = routeMap[job.name];
             if (!handler)
                 throw new Error(`No route for job "${job.name}" in queue "${this.name}"`);
             return handler(job);
-        });
+        };
     }
     buildQueueOpts(opts) {
         return {
@@ -277,4 +277,3 @@ export class Bunqueue {
         return this.worker.isClosed();
     }
 }
-//# sourceMappingURL=bunqueue.js.map

package/dist/client/errors.d.ts

@@ -18,4 +18,3 @@ export declare class UnrecoverableError extends Error {
 export declare class DelayedError extends Error {
     constructor(message?: string);
 }
-//# sourceMappingURL=errors.d.ts.map

package/dist/client/errors.js

@@ -24,4 +24,3 @@ export class DelayedError extends Error {
         this.name = 'DelayedError';
     }
 }
-//# sourceMappingURL=errors.js.map

package/dist/client/events.d.ts

@@ -132,4 +132,3 @@ export declare class QueueEvents<R = unknown, P = unknown> extends EventEmitter
     /** Close the event listener and remove all listeners */
     close(): void;
 }
-//# sourceMappingURL=events.d.ts.map

package/dist/client/events.js

@@ -149,4 +149,3 @@ export class QueueEvents extends EventEmitter {
         this.removeAllListeners();
     }
 }
-//# sourceMappingURL=events.js.map

package/dist/client/flow.d.ts

@@ -77,4 +77,3 @@ export declare class FlowProducer extends EventEmitter {
     private addFlowNode;
     private addTreeNode;
 }
-//# sourceMappingURL=flow.d.ts.map

package/dist/client/flow.js

@@ -249,12 +249,14 @@ export class FlowProducer extends EventEmitter {
     buildCallbacks(queueName) {
         const ctx = { name: queueName, embedded: this.embedded, tcp: this.tcp };
         return {
+            embedded: this.embedded,
+            tcp: this.tcp,
             updateData: (id, data) => managementOps.updateJobData(ctx, id, data),
             updateProgress: (id, progress) => managementOps.updateJobProgress(ctx, id, progress),
             log: (id, msg) => managementOps.addJobLog(ctx, id, msg).then(() => { }),
             promote: (id) => managementOps.promoteJob(ctx, id),
             remove: (id) => managementOps.removeAsync(ctx, id),
-            changePriority: (id, p) => managementOps.changeJobPriority(ctx, id, { priority: p }),
+            changePriority: (id, opts) => managementOps.changeJobPriority(ctx, id, opts),
             changeDelay: (id, d) => managementOps.changeJobDelay(ctx, id, d),
             clearLogs: (id) => managementOps.clearJobLogs(ctx, id),
             retry: (id) => managementOps.retryJob(ctx, id),
@@ -370,4 +372,3 @@ export class FlowProducer extends EventEmitter {
         return id;
     }
 }
-//# sourceMappingURL=flow.js.map

package/dist/client/flowJobFactory.d.ts

@@ -3,14 +3,21 @@
  * Creates simple Job objects for FlowProducer results
  */
 import type { Job } from './types';
+import type { TcpConnectionPool } from './tcpPool';
 /** Callbacks for flow job mutation operations */
 export interface FlowJobCallbacks {
+    /** Execution mode — enables full method wiring when provided */
+    embedded?: boolean;
+    tcp?: TcpConnectionPool | null;
     updateData?: (id: string, data: unknown) => Promise<void>;
     updateProgress?: (id: string, progress: number | object) => Promise<void>;
     log?: (id: string, message: string) => Promise<void>;
     promote?: (id: string) => Promise<void>;
     remove?: (id: string) => Promise<void>;
-    changePriority?: (id: string, priority: number) => Promise<void>;
+    changePriority?: (id: string, opts: {
+        priority: number;
+        lifo?: boolean;
+    }) => Promise<void>;
     changeDelay?: (id: string, delay: number) => Promise<void>;
     clearLogs?: (id: string) => Promise<void>;
     retry?: (id: string) => Promise<void>;
@@ -20,4 +27,3 @@ export interface FlowJobCallbacks {
 export declare function extractUserDataFromInternal(data: Record<string, unknown>): unknown;
 /** Create a simple Job object for flow results */
 export declare function createFlowJobObject<T>(id: string, name: string, data: T, queueName: string, callbacks?: FlowJobCallbacks): Job<T>;
-//# sourceMappingURL=flowJobFactory.d.ts.map