bunqueue 1.0.7 → 1.0.8

package/dist/cli/commands/webhook.js

@@ -0,0 +1,78 @@
+/**
+ * Webhook Command Builders
+ * Webhook management operations
+ */
+import { parseArgs } from 'node:util';
+import { CommandError, requireArg } from './types';
+/** Valid webhook events */
+const VALID_EVENTS = [
+    'job.completed',
+    'job.failed',
+    'job.progress',
+    'job.active',
+    'job.waiting',
+    'job.delayed',
+];
+/** Build a webhook subcommand */
+export function buildWebhookCommand(args) {
+    const subcommand = args[0];
+    const subArgs = args.slice(1);
+    switch (subcommand) {
+        case 'list':
+            return { cmd: 'ListWebhooks' };
+        case 'add':
+            return buildAddWebhook(subArgs);
+        case 'remove':
+            return buildRemoveWebhook(subArgs);
+        default:
+            throw new CommandError(`Unknown webhook subcommand: ${subcommand}. Use: list, add, remove`);
+    }
+}
+function buildAddWebhook(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        options: {
+            events: { type: 'string', short: 'e' },
+            queue: { type: 'string', short: 'q' },
+            secret: { type: 'string', short: 's' },
+        },
+        allowPositionals: true,
+        strict: false,
+    });
+    const url = requireArg(positionals, 0, 'url');
+    if (!values.events) {
+        throw new CommandError(`--events (-e) is required (comma-separated). Valid events: ${VALID_EVENTS.join(', ')}`);
+    }
+    const events = values.events.split(',').filter(Boolean);
+    if (events.length === 0) {
+        throw new CommandError('At least one event must be specified');
+    }
+    // Validate events
+    for (const event of events) {
+        if (!VALID_EVENTS.includes(event)) {
+            throw new CommandError(`Invalid event: ${event}. Valid events: ${VALID_EVENTS.join(', ')}`);
+        }
+    }
+    // Validate URL
+    try {
+        new URL(url);
+    }
+    catch {
+        throw new CommandError(`Invalid URL: ${url}`);
+    }
+    const cmd = {
+        cmd: 'AddWebhook',
+        url,
+        events,
+    };
+    if (values.queue)
+        cmd.queue = values.queue;
+    if (values.secret)
+        cmd.secret = values.secret;
+    return cmd;
+}
+function buildRemoveWebhook(args) {
+    const webhookId = requireArg(args, 0, 'webhookId');
+    return { cmd: 'RemoveWebhook', webhookId };
+}
+//# sourceMappingURL=webhook.js.map

package/dist/cli/commands/webhook.js.map

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

package/dist/cli/commands/worker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Worker Command Builders
+ * Worker management operations
+ */
+/** Build a worker subcommand */
+export declare function buildWorkerCommand(args: string[]): Record<string, unknown>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/cli/commands/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,gCAAgC;AAChC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgB1E"}

package/dist/cli/commands/worker.js

@@ -0,0 +1,49 @@
+/**
+ * Worker Command Builders
+ * Worker management operations
+ */
+import { parseArgs } from 'node:util';
+import { CommandError, requireArg } from './types';
+/** Build a worker subcommand */
+export function buildWorkerCommand(args) {
+    const subcommand = args[0];
+    const subArgs = args.slice(1);
+    switch (subcommand) {
+        case 'list':
+            return { cmd: 'ListWorkers' };
+        case 'register':
+            return buildRegisterWorker(subArgs);
+        case 'unregister':
+            return buildUnregisterWorker(subArgs);
+        default:
+            throw new CommandError(`Unknown worker subcommand: ${subcommand}. Use: list, register, unregister`);
+    }
+}
+function buildRegisterWorker(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        options: {
+            queues: { type: 'string', short: 'q' },
+        },
+        allowPositionals: true,
+        strict: false,
+    });
+    const name = requireArg(positionals, 0, 'name');
+    if (!values.queues) {
+        throw new CommandError('--queues (-q) is required (comma-separated queue names)');
+    }
+    const queues = values.queues.split(',').filter(Boolean);
+    if (queues.length === 0) {
+        throw new CommandError('At least one queue must be specified');
+    }
+    return {
+        cmd: 'RegisterWorker',
+        name,
+        queues,
+    };
+}
+function buildUnregisterWorker(args) {
+    const workerId = requireArg(args, 0, 'workerId');
+    return { cmd: 'UnregisterWorker', workerId };
+}
+//# sourceMappingURL=worker.js.map

package/dist/cli/commands/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/cli/commands/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD,gCAAgC;AAChC,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE9B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;QAChC,KAAK,UAAU;YACb,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACtC,KAAK,YAAY;YACf,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACxC;YACE,MAAM,IAAI,YAAY,CACpB,8BAA8B,UAAU,mCAAmC,CAC5E,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAc;IACzC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI;QACJ,OAAO,EAAE;YACP,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;SACvC;QACD,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CAAC,yDAAyD,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,MAAM,GAAI,MAAM,CAAC,MAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC,sCAAsC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO;QACL,GAAG,EAAE,gBAAgB;QACrB,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAc;IAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACjD,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC"}

package/dist/cli/help.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLI Help Text Generator
+ */
+/** Print version information */
+export declare function printVersion(version: string): void;
+/** Print main help */
+export declare function printHelp(): void;
+/** Print server help */
+export declare function printServerHelp(): void;
+/** Print push command help */
+export declare function printPushHelp(): void;
+/** Print cron add help */
+export declare function printCronAddHelp(): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gCAAgC;AAChC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,sBAAsB;AACtB,wBAAgB,SAAS,IAAI,IAAI,CAyFhC;AAED,wBAAwB;AACxB,wBAAgB,eAAe,IAAI,IAAI,CAmBtC;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,IAAI,IAAI,CA+BpC;AAED,0BAA0B;AAC1B,wBAAgB,gBAAgB,IAAI,IAAI,CAqBvC"}

package/dist/cli/help.js

@@ -0,0 +1,176 @@
+/**
+ * CLI Help Text Generator
+ */
+/** Print version information */
+export function printVersion(version) {
+    console.log(`bunqueue v${version}`);
+}
+/** Print main help */
+export function printHelp() {
+    console.log(`
+bunqueue - High-performance job queue server for Bun
+
+USAGE:
+  bunqueue [command] [options]
+
+SERVER MODE:
+  bunqueue                        Start server with default settings
+  bunqueue start [options]        Start server with options
+
+CORE COMMANDS:
+  push <queue> <data> [opts]      Push a job to a queue
+  pull <queue> [--timeout ms]     Pull the next job from a queue
+  ack <id> [--result json]        Acknowledge job completion
+  fail <id> [--error message]     Mark job as failed
+
+JOB COMMANDS:
+  job get <id>                    Get job details
+  job state <id>                  Get job state
+  job result <id>                 Get job result
+  job cancel <id>                 Cancel a job
+  job progress <id> <n> [--msg]   Update job progress (0-100)
+  job update <id> <data>          Update job data
+  job priority <id> <n>           Change job priority
+  job promote <id>                Promote delayed job to waiting
+  job delay <id> <ms>             Move active job to delayed
+  job discard <id>                Discard job to DLQ
+  job logs <id>                   Get job logs
+  job log <id> <message>          Add log entry to job
+
+QUEUE COMMANDS:
+  queue list                      List all queues
+  queue pause <queue>             Pause queue processing
+  queue resume <queue>            Resume queue processing
+  queue drain <queue>             Remove all waiting jobs
+  queue obliterate <queue>        Remove all queue data
+  queue clean <q> --grace <ms>    Clean old jobs
+  queue count <queue>             Count jobs in queue
+  queue jobs <queue> [--state s]  List jobs in queue
+
+RATE LIMITING:
+  rate-limit set <queue> <n>      Set rate limit (jobs/second)
+  rate-limit clear <queue>        Clear rate limit
+  concurrency set <queue> <n>     Set concurrency limit
+  concurrency clear <queue>       Clear concurrency limit
+
+DLQ COMMANDS:
+  dlq list <queue> [--count n]    List DLQ jobs
+  dlq retry <queue> [--id jobId]  Retry DLQ jobs
+  dlq purge <queue>               Purge DLQ
+
+CRON COMMANDS:
+  cron list                       List cron jobs
+  cron add <name> [options]       Add cron job
+  cron delete <name>              Delete cron job
+
+WORKER COMMANDS:
+  worker list                     List registered workers
+  worker register <name> -q q1,q2 Register a worker
+  worker unregister <id>          Unregister a worker
+
+WEBHOOK COMMANDS:
+  webhook list                    List webhooks
+  webhook add <url> [options]     Add webhook
+  webhook remove <id>             Remove webhook
+
+MONITORING:
+  stats                           Show server statistics
+  metrics                         Show Prometheus metrics
+  health                          Health check
+
+GLOBAL OPTIONS:
+  -H, --host <host>               Server host (default: localhost)
+  -p, --port <port>               TCP port (default: 6789)
+  -t, --token <token>             Authentication token
+  --json                          Output as JSON
+  --help                          Show help
+  --version                       Show version
+
+EXAMPLES:
+  bunqueue start --tcp-port 6789
+  bunqueue push emails '{"to":"user@test.com"}'
+  bunqueue push emails '{"id":1}' --priority 10 --delay 5000
+  bunqueue pull emails --timeout 5000
+  bunqueue job get 12345
+  bunqueue queue list
+  bunqueue stats --json
+`);
+}
+/** Print server help */
+export function printServerHelp() {
+    console.log(`
+Usage: bunqueue start [options]
+
+Start the bunQ server.
+
+Options:
+  --tcp-port <port>     TCP server port (default: 6789, env: TCP_PORT)
+  --http-port <port>    HTTP server port (default: 6790, env: HTTP_PORT)
+  --host <host>         Bind address (default: 0.0.0.0, env: HOST)
+  --data-path <path>    SQLite database path (env: DATA_PATH)
+  --auth-tokens <list>  Comma-separated auth tokens (env: AUTH_TOKENS)
+  --help                Show this help
+
+Examples:
+  bunqueue start
+  bunqueue start --tcp-port 7000 --http-port 7001
+  bunqueue start --data-path ./data/queue.db
+`);
+}
+/** Print push command help */
+export function printPushHelp() {
+    console.log(`
+Usage: bunqueue push <queue> <data> [options]
+
+Push a job to a queue.
+
+Arguments:
+  queue                 Queue name
+  data                  Job data as JSON string
+
+Options:
+  -P, --priority <n>    Job priority (higher = processed first)
+  -d, --delay <ms>      Delay before processing
+  --max-attempts <n>    Maximum retry attempts (default: 3)
+  --backoff <ms>        Backoff between retries (default: 1000)
+  --ttl <ms>            Time to live
+  --timeout <ms>        Processing timeout
+  -u, --unique-key <k>  Unique key for deduplication
+  --job-id <id>         Custom job ID
+  --depends-on <ids>    Comma-separated dependency job IDs
+  --tags <tags>         Comma-separated tags
+  -g, --group-id <id>   Group ID
+  --lifo                Last-in-first-out ordering
+  --remove-on-complete  Remove job after completion
+  --remove-on-fail      Remove job after final failure
+
+Examples:
+  bunqueue push emails '{"to":"user@test.com"}'
+  bunqueue push tasks '{"action":"sync"}' --priority 10
+  bunqueue push jobs '{"id":1}' --delay 60000 --max-attempts 5
+`);
+}
+/** Print cron add help */
+export function printCronAddHelp() {
+    console.log(`
+Usage: bunqueue cron add <name> [options]
+
+Add a cron job.
+
+Arguments:
+  name                  Cron job name (unique identifier)
+
+Options:
+  -q, --queue <queue>   Target queue (required)
+  -d, --data <json>     Job data as JSON (required)
+  -s, --schedule <exp>  Cron expression (e.g., "0 * * * *")
+  -e, --every <ms>      Repeat interval in milliseconds
+  -P, --priority <n>    Job priority
+  --max-limit <n>       Maximum executions (0 = unlimited)
+
+Examples:
+  bunqueue cron add hourly-cleanup -q maintenance -d '{"task":"cleanup"}' -s "0 * * * *"
+  bunqueue cron add health-check -q monitoring -d '{}' -e 60000
+`);
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gCAAgC;AAChC,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuFb,CAAC,CAAC;AACH,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;CAiBb,CAAC,CAAC;AACH,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Bb,CAAC,CAAC;AACH,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;CAmBb,CAAC,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env bun
+/**
+ * bunqueue CLI Entry Point
+ * Routes to server or client mode based on arguments
+ */
+/** Main CLI entry */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAoEH,qBAAqB;AACrB,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA2C1C"}

package/dist/cli/index.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env bun
+/**
+ * bunqueue CLI Entry Point
+ * Routes to server or client mode based on arguments
+ */
+import { runServer } from './commands/server';
+import { executeCommand } from './client';
+import { printHelp, printVersion } from './help';
+/** Version from package.json */
+const VERSION = '1.0.7';
+/** Parse global options from process.argv */
+function parseGlobalOptions() {
+    const allArgs = process.argv.slice(2);
+    // Extract global options manually to preserve subcommand flags
+    let host = 'localhost';
+    let port = 6789;
+    let token;
+    let json = false;
+    let help = false;
+    let version = false;
+    const commandArgs = [];
+    let i = 0;
+    while (i < allArgs.length) {
+        const arg = allArgs[i];
+        if (arg === '--host' || arg === '-H') {
+            host = allArgs[++i] ?? 'localhost';
+        }
+        else if (arg === '--port' || arg === '-p') {
+            port = parseInt(allArgs[++i] ?? '6789', 10);
+        }
+        else if (arg === '--token' || arg === '-t') {
+            token = allArgs[++i];
+        }
+        else if (arg === '--json') {
+            json = true;
+        }
+        else if (arg === '--help') {
+            help = true;
+        }
+        else if (arg === '--version') {
+            version = true;
+        }
+        else if (arg.startsWith('--host=')) {
+            host = arg.slice(7);
+        }
+        else if (arg.startsWith('--port=')) {
+            port = parseInt(arg.slice(7), 10);
+        }
+        else if (arg.startsWith('--token=')) {
+            token = arg.slice(8);
+        }
+        else {
+            // Not a global option, pass to command
+            commandArgs.push(arg);
+        }
+        i++;
+    }
+    return {
+        options: { host, port, token, json, help, version },
+        commandArgs,
+    };
+}
+/** Main CLI entry */
+export async function main() {
+    const { options, commandArgs } = parseGlobalOptions();
+    // Handle --version
+    if (options.version) {
+        printVersion(VERSION);
+        process.exit(0);
+    }
+    // Handle --help with no command
+    if (options.help && commandArgs.length === 0) {
+        printHelp();
+        process.exit(0);
+    }
+    // Get the command (first positional argument)
+    const command = commandArgs[0];
+    // No command or 'start' = server mode
+    if (!command || command === 'start') {
+        const serverArgs = command === 'start' ? commandArgs.slice(1) : commandArgs;
+        await runServer(serverArgs, options.help);
+        return;
+    }
+    // Help for specific command
+    if (options.help) {
+        // Could add command-specific help here
+        printHelp();
+        process.exit(0);
+    }
+    // Client mode - execute command against server
+    try {
+        await executeCommand(command, commandArgs.slice(1), options);
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            console.error(`Error: ${err.message}`);
+        }
+        else {
+            console.error('Unknown error occurred');
+        }
+        process.exit(1);
+    }
+}
+// Run if this is the main module
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/output.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI Output Formatting
+ * Formats command responses for terminal display
+ */
+/** Main output formatter */
+export declare function formatOutput(response: Record<string, unknown>, command: string, asJson: boolean): string;
+/** Format error message */
+export declare function formatError(message: string, asJson: boolean): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAySH,4BAA4B;AAC5B,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GACd,MAAM,CAUR;AAED,2BAA2B;AAC3B,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAKpE"}