flashq 0.1.0

package/README.md

@@ -0,0 +1,283 @@
+# flashQ TypeScript SDK
+
+BullMQ-compatible API for [flashQ](https://github.com/egeominotti/flashq).
+
+## Installation
+
+```bash
+bun add flashq
+```
+
+## Quick Start
+
+```typescript
+import { Queue, Worker } from 'flashq';
+
+// Create queue
+const queue = new Queue('emails');
+
+// Add job
+await queue.add('send', { to: 'user@example.com' });
+
+// Process jobs (auto-starts)
+const worker = new Worker('emails', async (job) => {
+  console.log('Processing:', job.data);
+  return { sent: true };
+});
+```
+
+---
+
+## ⚡ Performance Benchmark: flashQ vs BullMQ
+
+> **flashQ is 3x to 10x faster than BullMQ** in real-world benchmarks.
+
+### Test Environment
+
+| Component | Version | Configuration |
+|-----------|---------|---------------|
+| **flashQ Server** | 0.1.0 | Docker with `io_uring` enabled, Rust + tokio async runtime |
+| **BullMQ** | 5.66.5 | npm package |
+| **Redis** | 7.4.7 | Docker (`redis:7-alpine`), jemalloc allocator |
+| **Bun** | 1.3.6 | TypeScript runtime |
+| **Platform** | Linux/macOS | Docker containers |
+
+### Benchmark Configuration
+
+```
+Workers:              8
+Concurrency/worker:   50
+Total concurrency:    400
+Batch size:           1,000 jobs
+Data verification:    Enabled (input === output)
+```
+
+### Results: No-op Jobs (100,000 jobs)
+
+Minimal job processing to measure pure queue overhead.
+
+| Metric | flashQ | BullMQ | Speedup |
+|--------|-------:|-------:|--------:|
+| **Push Rate** | 307,692 jobs/sec | 43,649 jobs/sec | **7.0x** |
+| **Process Rate** | 292,398 jobs/sec | 27,405 jobs/sec | **10.7x** |
+| **Total Time** | 0.67s | 5.94s | **8.9x** |
+
+### Results: CPU-Bound Jobs (100,000 jobs)
+
+Each job performs realistic CPU work:
+- JSON serialize/deserialize
+- 10x SHA256 hash rounds
+- Array sort/filter/reduce (100 elements)
+- String manipulation
+
+| Metric | flashQ | BullMQ | Speedup |
+|--------|-------:|-------:|--------:|
+| **Push Rate** | 220,751 jobs/sec | 43,422 jobs/sec | **5.1x** |
+| **Process Rate** | 62,814 jobs/sec | 23,923 jobs/sec | **2.6x** |
+| **Total Time** | 2.04s | 6.48s | **3.2x** |
+
+### Results: 1 Million Jobs (flashQ only)
+
+| Scenario | Push Rate | Process Rate | Total Time | Data Integrity |
+|----------|----------:|-------------:|-----------:|:--------------:|
+| **No-op** | 266,809/s | 262,536/s | 7.56s | ✅ 100% |
+| **CPU-bound** | 257,334/s | 65,240/s | 19.21s | ✅ 100% |
+
+### Why flashQ is Faster
+
+| Optimization | Description |
+|--------------|-------------|
+| **Rust + tokio** | Zero-cost abstractions, no GC pauses |
+| **io_uring** | Linux kernel async I/O (when available) |
+| **32 Shards** | Lock-free concurrent access via DashMap |
+| **MessagePack** | 40% smaller payloads vs JSON |
+| **Batch Operations** | Amortized network overhead |
+| **No Redis Dependency** | Direct TCP protocol, no intermediary |
+
+### Run Benchmarks
+
+```bash
+# flashQ benchmarks
+bun run examples/heavy-benchmark.ts      # No-op 100K
+bun run examples/cpu-benchmark.ts        # CPU-bound 100K
+bun run examples/million-benchmark.ts    # 1M jobs
+
+# BullMQ comparison (requires Redis)
+docker run -d -p 6379:6379 redis:7-alpine
+bun run examples/bullmq-benchmark.ts     # No-op 100K
+bun run examples/bullmq-cpu-benchmark.ts # CPU-bound 100K
+```
+
+---
+
+## Queue
+
+```typescript
+const queue = new Queue('emails', {
+  host: 'localhost',
+  port: 6789,
+});
+
+// Add single job
+await queue.add('send', data, {
+  priority: 10,
+  delay: 5000,
+  attempts: 3,
+  backoff: { type: 'exponential', delay: 1000 },
+});
+
+// Add bulk
+await queue.addBulk([
+  { name: 'send', data: { to: 'a@test.com' } },
+  { name: 'send', data: { to: 'b@test.com' }, opts: { priority: 10 } },
+]);
+
+// Control
+await queue.pause();
+await queue.resume();
+await queue.drain();      // remove waiting
+await queue.obliterate(); // remove all
+```
+
+## Worker
+
+```typescript
+// Auto-starts by default (like BullMQ)
+const worker = new Worker('emails', async (job) => {
+  return { done: true };
+}, {
+  concurrency: 10,
+});
+
+// Events
+worker.on('completed', (job, result) => {});
+worker.on('failed', (job, error) => {});
+
+// Shutdown
+await worker.close();
+```
+
+## Job Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `priority` | number | Higher = first (default: 0) |
+| `delay` | number | Delay in ms |
+| `attempts` | number | Retry count |
+| `backoff` | number \| object | Backoff config |
+| `timeout` | number | Processing timeout |
+| `jobId` | string | Custom ID |
+
+## Key-Value Storage
+
+Redis-like KV store with TTL support and batch operations.
+
+```typescript
+import { FlashQ } from 'flashq';
+
+const client = new FlashQ();
+
+// Basic operations
+await client.kvSet('user:123', { name: 'John', email: 'john@example.com' });
+const user = await client.kvGet('user:123');
+await client.kvDel('user:123');
+
+// With TTL (milliseconds)
+await client.kvSet('session:abc', { token: 'xyz' }, { ttl: 3600000 }); // 1 hour
+
+// TTL operations
+await client.kvExpire('user:123', 60000);  // Set TTL
+const ttl = await client.kvTtl('user:123'); // Get remaining TTL
+
+// Batch operations (10-100x faster!)
+await client.kvMset([
+  { key: 'user:1', value: { name: 'Alice' } },
+  { key: 'user:2', value: { name: 'Bob' } },
+  { key: 'user:3', value: { name: 'Charlie' }, ttl: 60000 },
+]);
+
+const users = await client.kvMget(['user:1', 'user:2', 'user:3']);
+
+// Pattern matching
+const userKeys = await client.kvKeys('user:*');
+const sessionKeys = await client.kvKeys('session:???');
+
+// Atomic counters
+await client.kvIncr('page:views');           // +1
+await client.kvIncr('user:123:score', 10);   // +10
+await client.kvDecr('stock:item:456');       // -1
+```
+
+### KV Performance
+
+| Operation | Throughput |
+|-----------|------------|
+| Sequential SET/GET | ~30K ops/sec |
+| **Batch MSET** | **640K ops/sec** |
+| **Batch MGET** | **1.2M ops/sec** |
+
+> Use batch operations (MSET/MGET) for best performance!
+
+## Pub/Sub
+
+Redis-like publish/subscribe messaging.
+
+```typescript
+import { FlashQ } from 'flashq';
+
+const client = new FlashQ();
+
+// Publish messages to a channel
+const receivers = await client.publish('notifications', { type: 'alert', text: 'Hello!' });
+console.log(`Message sent to ${receivers} subscribers`);
+
+// Subscribe to channels
+await client.pubsubSubscribe(['notifications', 'alerts']);
+
+// Pattern subscribe (e.g., "events:*" matches "events:user:signup")
+await client.pubsubPsubscribe(['events:*', 'logs:*']);
+
+// List active channels
+const allChannels = await client.pubsubChannels();
+const eventChannels = await client.pubsubChannels('events:*');
+
+// Get subscriber counts
+const counts = await client.pubsubNumsub(['notifications', 'alerts']);
+// [['notifications', 5], ['alerts', 2]]
+
+// Unsubscribe
+await client.pubsubUnsubscribe(['notifications']);
+await client.pubsubPunsubscribe(['events:*']);
+```
+
+## Examples
+
+```bash
+bun run examples/01-basic.ts
+```
+
+| File | Description |
+|------|-------------|
+| 01-basic.ts | Queue + Worker basics |
+| 02-job-options.ts | Priority, delay, retry |
+| 03-bulk-jobs.ts | Add multiple jobs |
+| 04-events.ts | Worker events |
+| 05-queue-control.ts | Pause, resume, drain |
+| 06-delayed.ts | Scheduled jobs |
+| 07-retry.ts | Retry with backoff |
+| 08-priority.ts | Priority ordering |
+| 09-concurrency.ts | Parallel processing |
+| 10-benchmark.ts | Basic performance test |
+| **heavy-benchmark.ts** | 100K no-op benchmark |
+| **cpu-benchmark.ts** | 100K CPU-bound benchmark |
+| **million-benchmark.ts** | 1M jobs with verification |
+| **benchmark-full.ts** | Memory + latency + throughput |
+| **bullmq-benchmark.ts** | BullMQ comparison (no-op) |
+| **bullmq-cpu-benchmark.ts** | BullMQ comparison (CPU) |
+| **bullmq-benchmark-full.ts** | BullMQ memory + latency |
+| kv-benchmark.ts | KV store benchmark |
+| pubsub-example.ts | Pub/Sub messaging |
+
+## License
+
+MIT

package/dist/client/advanced.d.ts

@@ -0,0 +1,174 @@
+/**
+ * BullMQ-like advanced operations
+ */
+import type { IFlashQClient, JobState, JobWithState } from './types';
+/**
+ * Get jobs filtered by queue and/or state with pagination.
+ *
+ * @param client - FlashQ client instance
+ * @param options - Filter options
+ * @returns Jobs and total count
+ *
+ * @example
+ * ```typescript
+ * // Get all waiting jobs
+ * const { jobs, total } = await client.getJobs({ state: 'waiting' });
+ *
+ * // Paginate results
+ * const { jobs } = await client.getJobs({ limit: 10, offset: 20 });
+ * ```
+ */
+export declare function getJobs(client: IFlashQClient, options?: {
+    queue?: string;
+    state?: JobState;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    jobs: JobWithState[];
+    total: number;
+}>;
+/**
+ * Get job counts by state for a queue.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Counts by state
+ *
+ * @example
+ * ```typescript
+ * const counts = await client.getJobCounts('emails');
+ * console.log(`Waiting: ${counts.waiting}`);
+ * console.log(`Active: ${counts.active}`);
+ * ```
+ */
+export declare function getJobCounts(client: IFlashQClient, queue: string): Promise<{
+    waiting: number;
+    active: number;
+    delayed: number;
+    completed: number;
+    failed: number;
+}>;
+/**
+ * Get total count of jobs in a queue (waiting + delayed).
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Total job count
+ *
+ * @example
+ * ```typescript
+ * const total = await client.count('emails');
+ * console.log(`${total} jobs in queue`);
+ * ```
+ */
+export declare function count(client: IFlashQClient, queue: string): Promise<number>;
+/**
+ * Clean jobs older than grace period by state.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @param grace - Grace period in ms
+ * @param state - Job state to clean
+ * @param limit - Optional max jobs to clean
+ * @returns Number of jobs cleaned
+ *
+ * @example
+ * ```typescript
+ * // Clean completed jobs older than 1 hour
+ * const cleaned = await client.clean('emails', 3600000, 'completed');
+ * ```
+ */
+export declare function clean(client: IFlashQClient, queue: string, grace: number, state: 'waiting' | 'delayed' | 'completed' | 'failed', limit?: number): Promise<number>;
+/**
+ * Drain all waiting jobs from a queue.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Number of jobs drained
+ *
+ * @example
+ * ```typescript
+ * const drained = await client.drain('emails');
+ * console.log(`Drained ${drained} jobs`);
+ * ```
+ */
+export declare function drain(client: IFlashQClient, queue: string): Promise<number>;
+/**
+ * Remove ALL data for a queue (jobs, DLQ, cron, state).
+ * Use with caution - this is destructive!
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Total items removed
+ *
+ * @example
+ * ```typescript
+ * const removed = await client.obliterate('test-queue');
+ * ```
+ */
+export declare function obliterate(client: IFlashQClient, queue: string): Promise<number>;
+/**
+ * Change job priority.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param priority - New priority (higher = processed first)
+ *
+ * @example
+ * ```typescript
+ * await client.changePriority(jobId, 100);
+ * ```
+ */
+export declare function changePriority(client: IFlashQClient, jobId: number, priority: number): Promise<void>;
+/**
+ * Move job from processing back to delayed.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param delay - Delay in ms
+ *
+ * @example
+ * ```typescript
+ * // Delay for 5 minutes
+ * await client.moveToDelayed(jobId, 300000);
+ * ```
+ */
+export declare function moveToDelayed(client: IFlashQClient, jobId: number, delay: number): Promise<void>;
+/**
+ * Promote delayed job to waiting immediately.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ *
+ * @example
+ * ```typescript
+ * await client.promote(jobId);
+ * ```
+ */
+export declare function promote(client: IFlashQClient, jobId: number): Promise<void>;
+/**
+ * Update job data.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param data - New data payload
+ *
+ * @example
+ * ```typescript
+ * await client.update(jobId, { email: 'new@example.com' });
+ * ```
+ */
+export declare function update<T = unknown>(client: IFlashQClient, jobId: number, data: T): Promise<void>;
+/**
+ * Discard job - move directly to DLQ.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ *
+ * @example
+ * ```typescript
+ * await client.discard(jobId);
+ * ```
+ */
+export declare function discard(client: IFlashQClient, jobId: number): Promise<void>;
+//# sourceMappingURL=advanced.d.ts.map

package/dist/client/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../src/client/advanced.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAO,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC;IAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBlD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAmBD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,EACrD,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CASjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,OAAO,EACtC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/client/advanced.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getJobs = getJobs;
+exports.getJobCounts = getJobCounts;
+exports.count = count;
+exports.clean = clean;
+exports.drain = drain;
+exports.obliterate = obliterate;
+exports.changePriority = changePriority;
+exports.moveToDelayed = moveToDelayed;
+exports.promote = promote;
+exports.update = update;
+exports.discard = discard;
+/**
+ * Get jobs filtered by queue and/or state with pagination.
+ *
+ * @param client - FlashQ client instance
+ * @param options - Filter options
+ * @returns Jobs and total count
+ *
+ * @example
+ * ```typescript
+ * // Get all waiting jobs
+ * const { jobs, total } = await client.getJobs({ state: 'waiting' });
+ *
+ * // Paginate results
+ * const { jobs } = await client.getJobs({ limit: 10, offset: 20 });
+ * ```
+ */
+async function getJobs(client, options = {}) {
+    const response = await client.send({
+        cmd: 'GETJOBS',
+        queue: options.queue,
+        state: options.state,
+        limit: options.limit ?? 100,
+        offset: options.offset ?? 0,
+    });
+    return {
+        jobs: response.jobs.map((j) => ({ job: j.job, state: j.state })),
+        total: response.total,
+    };
+}
+/**
+ * Get job counts by state for a queue.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Counts by state
+ *
+ * @example
+ * ```typescript
+ * const counts = await client.getJobCounts('emails');
+ * console.log(`Waiting: ${counts.waiting}`);
+ * console.log(`Active: ${counts.active}`);
+ * ```
+ */
+async function getJobCounts(client, queue) {
+    const response = await client.send({
+        cmd: 'GETJOBCOUNTS',
+        queue,
+    });
+    return {
+        waiting: response.waiting,
+        active: response.active,
+        delayed: response.delayed,
+        completed: response.completed,
+        failed: response.failed,
+    };
+}
+/**
+ * Get total count of jobs in a queue (waiting + delayed).
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Total job count
+ *
+ * @example
+ * ```typescript
+ * const total = await client.count('emails');
+ * console.log(`${total} jobs in queue`);
+ * ```
+ */
+async function count(client, queue) {
+    const response = await client.send({
+        cmd: 'COUNT',
+        queue,
+    });
+    return response.count;
+}
+/**
+ * Clean jobs older than grace period by state.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @param grace - Grace period in ms
+ * @param state - Job state to clean
+ * @param limit - Optional max jobs to clean
+ * @returns Number of jobs cleaned
+ *
+ * @example
+ * ```typescript
+ * // Clean completed jobs older than 1 hour
+ * const cleaned = await client.clean('emails', 3600000, 'completed');
+ * ```
+ */
+async function clean(client, queue, grace, state, limit) {
+    const response = await client.send({
+        cmd: 'CLEAN',
+        queue,
+        grace,
+        state,
+        limit,
+    });
+    return response.count;
+}
+/**
+ * Drain all waiting jobs from a queue.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Number of jobs drained
+ *
+ * @example
+ * ```typescript
+ * const drained = await client.drain('emails');
+ * console.log(`Drained ${drained} jobs`);
+ * ```
+ */
+async function drain(client, queue) {
+    const response = await client.send({
+        cmd: 'DRAIN',
+        queue,
+    });
+    return response.count;
+}
+/**
+ * Remove ALL data for a queue (jobs, DLQ, cron, state).
+ * Use with caution - this is destructive!
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Total items removed
+ *
+ * @example
+ * ```typescript
+ * const removed = await client.obliterate('test-queue');
+ * ```
+ */
+async function obliterate(client, queue) {
+    const response = await client.send({
+        cmd: 'OBLITERATE',
+        queue,
+    });
+    return response.count;
+}
+/**
+ * Change job priority.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param priority - New priority (higher = processed first)
+ *
+ * @example
+ * ```typescript
+ * await client.changePriority(jobId, 100);
+ * ```
+ */
+async function changePriority(client, jobId, priority) {
+    await client.send({
+        cmd: 'CHANGEPRIORITY',
+        id: jobId,
+        priority,
+    });
+}
+/**
+ * Move job from processing back to delayed.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param delay - Delay in ms
+ *
+ * @example
+ * ```typescript
+ * // Delay for 5 minutes
+ * await client.moveToDelayed(jobId, 300000);
+ * ```
+ */
+async function moveToDelayed(client, jobId, delay) {
+    await client.send({
+        cmd: 'MOVETODELAYED',
+        id: jobId,
+        delay,
+    });
+}
+/**
+ * Promote delayed job to waiting immediately.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ *
+ * @example
+ * ```typescript
+ * await client.promote(jobId);
+ * ```
+ */
+async function promote(client, jobId) {
+    await client.send({
+        cmd: 'PROMOTE',
+        id: jobId,
+    });
+}
+/**
+ * Update job data.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param data - New data payload
+ *
+ * @example
+ * ```typescript
+ * await client.update(jobId, { email: 'new@example.com' });
+ * ```
+ */
+async function update(client, jobId, data) {
+    await client.send({
+        cmd: 'UPDATEJOB',
+        id: jobId,
+        data,
+    });
+}
+/**
+ * Discard job - move directly to DLQ.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ *
+ * @example
+ * ```typescript
+ * await client.discard(jobId);
+ * ```
+ */
+async function discard(client, jobId) {
+    await client.send({
+        cmd: 'DISCARD',
+        id: jobId,
+    });
+}
+//# sourceMappingURL=advanced.js.map

package/dist/client/advanced.js.map

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