@zintrust/queue-cloudflare 2.4.1 → 2.4.2

package/dist/CloudflareJobStore.d.ts

@@ -1,4 +1,4 @@
-import type { CloudflareJobOptions, CloudflareFlowInput, CloudflareFlowResult, CloudflareQueueJob, CloudflareQueueMetrics, CloudflareQueueState, CloudflareQueueStateConfig, CloudflareRepeatableRow } from './types.js';
+import type { CloudflareFlowInput, CloudflareFlowResult, CloudflareJobOptions, CloudflareQueueJob, CloudflareQueueMetrics, CloudflareQueueState, CloudflareQueueStateConfig, CloudflareRepeatableRow } from './types.js';
 type CreateJobInput<T = unknown> = {
     queueName: string;
     name: string;

package/dist/CloudflareJobStore.js

@@ -1,3 +1,10 @@
+/* eslint-disable no-await-in-loop, complexity, max-lines-per-function */
+/* eslint-disable no-negated-condition, no-nested-ternary, no-restricted-syntax */
+/* eslint-disable @typescript-eslint/explicit-function-return-type */
+/* sonarqube-disable cognitive-complexity, no-nested-conditional, no-nested-ternary */
+/* sonarqube-disable no-negated-condition, S3776 */
+/* Sequential processing required, complex functions by design */
+import { ErrorFactory } from '@zintrust/core/errors';
 import { generateUuid } from '@zintrust/core/utils';
 const nowIso = () => new Date().toISOString();
 const serialize = (value) => JSON.stringify(value ?? null);
@@ -35,7 +42,7 @@ const resolveTarget = (config) => {
     const d1 = env?.[bindingName];
     if (d1 !== undefined && typeof d1.prepare === 'function')
         return { kind: 'd1', db: d1 };
-    throw new Error(`Cloudflare queue state store requires a D1 binding (${bindingName}) or ZinTrust database`);
+    throw ErrorFactory.createConfigError(`Cloudflare queue state store requires a D1 binding (${bindingName}) or ZinTrust database`);
 };
 const resolveKv = (config) => {
     if (config?.kv !== undefined)
@@ -47,20 +54,29 @@ const resolveKv = (config) => {
 };
 const queryRows = async (target, sql, params = []) => {
     if (target.kind === 'd1') {
-        const result = await target.db.prepare(sql).bind(...params).all();
+        const result = await target.db
+            .prepare(sql)
+            .bind(...params)
+            .all();
         return result.results ?? [];
     }
     return (await target.db.query(sql, params));
 };
 const queryOne = async (target, sql, params = []) => {
     if (target.kind === 'd1') {
-        return await target.db.prepare(sql).bind(...params).first();
+        return await target.db
+            .prepare(sql)
+            .bind(...params)
+            .first();
     }
     return (await target.db.queryOne(sql, params)) ?? null;
 };
 const execute = async (target, sql, params = []) => {
     if (target.kind === 'd1') {
-        await target.db.prepare(sql).bind(...params).run();
+        await target.db
+            .prepare(sql)
+            .bind(...params)
+            .run();
         return;
     }
     await target.db.execute(sql, params);
@@ -78,7 +94,7 @@ const toJob = (row, store) => {
         progress: deserialize(row.progress),
         result: deserialize(row.result),
         error: deserialize(row.error),
-        opts: (deserialize(row.opts) ?? {}),
+        opts: deserialize(row.opts) ?? {},
         availableAt: row.available_at,
         createdAt: row.created_at,
         updatedAt: row.updated_at,
@@ -366,10 +382,7 @@ function createCloudflareJobStore(config) {
             await execute(target, 'UPDATE cf_queue_repeatables SET run_count = ?, next_run_at = ?, active = ?, updated_at = ? WHERE id = ?', [runCount, nextRunAt, shouldDeactivate ? 0 : 1, nowIso(), row.id]);
         },
         async removeRepeatable(id) {
-            await execute(target, 'UPDATE cf_queue_repeatables SET active = 0, updated_at = ? WHERE id = ?', [
-                nowIso(),
-                id,
-            ]);
+            await execute(target, 'UPDATE cf_queue_repeatables SET active = 0, updated_at = ? WHERE id = ?', [nowIso(), id]);
         },
         async createFlow(input) {
             const parent = await store.createJob({

package/dist/CloudflareQueueConsumer.d.ts

@@ -25,8 +25,8 @@ export type CloudflareQueueConsumerConfig<T = unknown, TResult = unknown> = {
 };
 export declare const CloudflareQueueConsumer: Readonly<{
     create: <T = unknown, TResult = unknown>(config: CloudflareQueueConsumerConfig<T, TResult>) => {
-        processMessage(message: CloudflareMessageLike, batchQueueName?: string): Promise<void>;
-        processBatch(batch: CloudflareBatchLike): Promise<void>;
+        processMessage: (message: CloudflareMessageLike, batchQueueName?: string) => Promise<void>;
+        processBatch: (batch: CloudflareBatchLike) => Promise<void>;
     };
     createDeadLetter(input: {
         queueName?: string;

package/dist/CloudflareQueueConsumer.js

@@ -4,22 +4,23 @@ const isEnvelope = (value) => {
         value.protocol === 'zintrust.cf.queue.v1' &&
         typeof value.jobId === 'string');
 };
-const resolveCoordinator = (config, queueName) => {
-    const direct = config?.coordinator;
-    if (direct?.getByName !== undefined)
-        return direct.getByName(queueName ?? 'default');
-    if (direct?.idFromName !== undefined && direct.get !== undefined) {
-        return direct.get(direct.idFromName(queueName ?? 'default'));
+const getCoordinatorFromStub = (stub, queueName) => {
+    if (stub?.getByName !== undefined)
+        return stub.getByName(queueName);
+    if (stub?.idFromName !== undefined && stub.get !== undefined) {
+        return stub.get(stub.idFromName(queueName));
     }
+    return null;
+};
+const resolveCoordinator = (config, queueName = 'default') => {
+    const direct = config?.coordinator;
+    const fromDirect = getCoordinatorFromStub(direct, queueName);
+    if (fromDirect !== null)
+        return fromDirect;
     const env = globalThis.env;
     const bindingName = config?.coordinatorBindingName ?? 'QUEUE_COORDINATOR';
     const binding = env?.[bindingName];
-    if (binding?.getByName !== undefined)
-        return binding.getByName(queueName ?? 'default');
-    if (binding?.idFromName !== undefined && binding.get !== undefined) {
-        return binding.get(binding.idFromName(queueName ?? 'default'));
-    }
-    return null;
+    return getCoordinatorFromStub(binding, queueName);
 };
 const resolveWorkerId = (config) => {
     return config?.workerId ?? 'queue-cloudflare-worker';
@@ -43,40 +44,124 @@ const serializeError = (error) => {
         return { name: error.name, message: error.message, stack: error.stack };
     return error;
 };
+const createProcessorContext = (config, queueName, job, coordinator, message) => ({
+    job,
+    attempt: message.attempts,
+    updateProgress: async (progress) => {
+        await config.store.updateProgress(queueName, job.id, progress);
+    },
+    log: async (logMessage, data) => {
+        await config.store.recordLog(queueName, job.id, 'info', logMessage, data);
+    },
+    heartbeat: async () => {
+        await coordinator?.heartbeat?.({
+            queueName,
+            jobId: job.id,
+            workerId: resolveWorkerId(config.state),
+            ttlMs: config.state?.heartbeatTtlMs ?? 60_000,
+        });
+        await config.store.updateState({
+            queueName,
+            jobId: job.id,
+            state: 'active',
+        });
+    },
+});
+const handleJobSuccess = async (config, queueName, job, result, coordinator, message) => {
+    await config.store.updateState({
+        queueName,
+        jobId: job.id,
+        state: 'completed',
+        result,
+    });
+    const releasedParents = await config.store.markFlowChildCompleted(queueName, job.id);
+    for (const parent of releasedParents) {
+        await config.queue?.enqueue(parent.queueName, toEnvelope(parent));
+        await config.store.markDispatched(parent.queueName, parent.id);
+    }
+    await config.store.applyRetention(queueName, job.id, 'completed');
+    await coordinator?.releaseLease?.({
+        queueName,
+        jobId: job.id,
+        workerId: resolveWorkerId(config.state),
+        ttlMs: config.state?.heartbeatTtlMs ?? 60_000,
+    });
+    message.ack();
+};
+const handleJobFailure = async (config, queueName, job, error, coordinator, message) => {
+    const exhausted = job.attemptsMade + 1 >= job.maxAttempts;
+    await config.store.updateState({
+        queueName,
+        jobId: job.id,
+        state: exhausted ? 'failed' : 'retrying',
+        error: serializeError(error),
+    });
+    if (exhausted) {
+        await config.store.applyRetention(queueName, job.id, 'failed');
+        await coordinator?.releaseLease?.({
+            queueName,
+            jobId: job.id,
+            workerId: resolveWorkerId(config.state),
+            ttlMs: config.state?.heartbeatTtlMs ?? 60_000,
+        });
+        message.ack();
+        return;
+    }
+    message.retry({
+        delaySeconds: resolveRetryDelay(job, message.attempts, config.retryDelaySeconds ?? 30),
+    });
+};
+const resolveEnvelope = (message, configQueueName, batchQueueName) => {
+    if (isEnvelope(message.body))
+        return message.body;
+    return {
+        protocol: 'zintrust.cf.queue.v1',
+        jobId: message.id,
+        queueName: configQueueName ?? batchQueueName ?? 'default',
+        name: 'default',
+        attempt: message.attempts,
+        availableAt: new Date().toISOString(),
+    };
+};
+const shouldSkipProcessing = async (coordinator, retryDelaySeconds, message) => {
+    if ((await coordinator?.isPaused?.()) === true) {
+        message.retry({ delaySeconds: retryDelaySeconds });
+        return true;
+    }
+    return false;
+};
+const acquireJobLease = async (coordinator, queueName, jobId, workerId, ttlMs, retryDelaySeconds, message) => {
+    const lease = await coordinator?.acquireLease?.({
+        queueName,
+        jobId,
+        workerId,
+        ttlMs,
+    });
+    if (lease !== undefined && !lease.acquired) {
+        message.retry({ delaySeconds: retryDelaySeconds });
+        return false;
+    }
+    return true;
+};
 const createConsumer = (config) => {
     return {
         async processMessage(message, batchQueueName) {
-            const envelope = isEnvelope(message.body)
-                ? message.body
-                : {
-                    protocol: 'zintrust.cf.queue.v1',
-                    jobId: message.id,
-                    queueName: config.queueName ?? batchQueueName ?? 'default',
-                    name: 'default',
-                    attempt: message.attempts,
-                    availableAt: new Date().toISOString(),
-                };
+            const envelope = resolveEnvelope(message, config.queueName, batchQueueName);
             const queueName = config.queueName ?? envelope.queueName;
             const coordinator = resolveCoordinator(config.state, queueName);
-            if ((await coordinator?.isPaused?.()) === true) {
-                message.retry({ delaySeconds: config.retryDelaySeconds ?? 30 });
+            const retryDelaySeconds = config.retryDelaySeconds ?? 30;
+            if (await shouldSkipProcessing(coordinator, retryDelaySeconds, message))
                 return;
-            }
             const job = await config.store.getJob(queueName, envelope.jobId);
             if (job === null || job.state === 'canceled') {
                 message.ack();
                 return;
             }
-            const lease = await coordinator?.acquireLease?.({
-                queueName,
-                jobId: job.id,
-                workerId: resolveWorkerId(config.state),
-                ttlMs: config.state?.heartbeatTtlMs ?? 60_000,
-            });
-            if (lease !== undefined && !lease.acquired) {
-                message.retry({ delaySeconds: config.retryDelaySeconds ?? 30 });
+            const workerId = resolveWorkerId(config.state);
+            const ttlMs = config.state?.heartbeatTtlMs ?? 60_000;
+            const leaseAcquired = await acquireJobLease(coordinator, queueName, job.id, workerId, ttlMs, retryDelaySeconds, message);
+            if (!leaseAcquired)
                 return;
-            }
             await config.store.updateState({
                 queueName,
                 jobId: job.id,
@@ -84,71 +169,12 @@ const createConsumer = (config) => {
                 incrementAttempts: true,
             });
             try {
-                const result = await config.processor(job.data, {
-                    job,
-                    attempt: message.attempts,
-                    updateProgress: async (progress) => {
-                        await config.store.updateProgress(queueName, job.id, progress);
-                    },
-                    log: async (logMessage, data) => {
-                        await config.store.recordLog(queueName, job.id, 'info', logMessage, data);
-                    },
-                    heartbeat: async () => {
-                        await coordinator?.heartbeat?.({
-                            queueName,
-                            jobId: job.id,
-                            workerId: resolveWorkerId(config.state),
-                            ttlMs: config.state?.heartbeatTtlMs ?? 60_000,
-                        });
-                        await config.store.updateState({
-                            queueName,
-                            jobId: job.id,
-                            state: 'active',
-                        });
-                    },
-                });
-                await config.store.updateState({
-                    queueName,
-                    jobId: job.id,
-                    state: 'completed',
-                    result,
-                });
-                const releasedParents = await config.store.markFlowChildCompleted(queueName, job.id);
-                for (const parent of releasedParents) {
-                    await config.queue?.enqueue(parent.queueName, toEnvelope(parent));
-                    await config.store.markDispatched(parent.queueName, parent.id);
-                }
-                await config.store.applyRetention(queueName, job.id, 'completed');
-                await coordinator?.releaseLease?.({
-                    queueName,
-                    jobId: job.id,
-                    workerId: resolveWorkerId(config.state),
-                    ttlMs: config.state?.heartbeatTtlMs ?? 60_000,
-                });
-                message.ack();
+                const context = createProcessorContext(config, queueName, job, coordinator, message);
+                const result = await config.processor(job.data, context);
+                await handleJobSuccess(config, queueName, job, result, coordinator, message);
             }
             catch (error) {
-                const exhausted = job.attemptsMade + 1 >= job.maxAttempts;
-                await config.store.updateState({
-                    queueName,
-                    jobId: job.id,
-                    state: exhausted ? 'failed' : 'retrying',
-                    error: serializeError(error),
-                });
-                if (exhausted) {
-                    await config.store.applyRetention(queueName, job.id, 'failed');
-                    await coordinator?.releaseLease?.({
-                        queueName,
-                        jobId: job.id,
-                        workerId: resolveWorkerId(config.state),
-                        ttlMs: config.state?.heartbeatTtlMs ?? 60_000,
-                    });
-                    message.ack();
-                    return;
-                }
-                message.retry({
-                    delaySeconds: resolveRetryDelay(job, message.attempts, config.retryDelaySeconds ?? 30),
-                });
+                await handleJobFailure(config, queueName, job, error, coordinator, message);
             }
         },
         async processBatch(batch) {

package/dist/CloudflareQueueCoordinator.js

@@ -1,6 +1,7 @@
 const leaseKey = (queueName, jobId) => `lease:${queueName}:${jobId}`;
 const pausedKey = (queueName) => `paused:${queueName}`;
 const rateLimitKey = (key) => `rate:${key}`;
+// eslint-disable-next-line no-restricted-syntax
 export class CloudflareQueueCoordinator {
     state;
     constructor(state) {

package/dist/CloudflareQueueMigrator.js

@@ -10,13 +10,9 @@ export const CloudflareQueueMigrator = Object.freeze({
     statements: cloudflareQueueMigrationStatements,
     rollbackStatements: cloudflareQueueRollbackStatements,
     async up(target) {
-        for (const statement of cloudflareQueueMigrationStatements) {
-            await runStatement(target, statement);
-        }
+        await Promise.all(cloudflareQueueMigrationStatements.map((statement) => runStatement(target, statement)));
     },
     async down(target) {
-        for (const statement of cloudflareQueueRollbackStatements) {
-            await runStatement(target, statement);
-        }
+        await Promise.all(cloudflareQueueRollbackStatements.map((statement) => runStatement(target, statement)));
     },
 });

package/dist/CloudflareQueueScheduler.d.ts

@@ -12,10 +12,10 @@ export type CloudflareQueueSchedulerConfig = {
 };
 export declare const CloudflareQueueScheduler: Readonly<{
     create: (config: CloudflareQueueSchedulerConfig) => {
-        dispatchDueJobs(): Promise<number>;
-        dispatchRepeatables(): Promise<number>;
-        reconcileStalled(): Promise<number>;
-        run(): Promise<{
+        dispatchDueJobs: () => Promise<number>;
+        dispatchRepeatables: () => Promise<number>;
+        reconcileStalled: () => Promise<number>;
+        run: () => Promise<{
             jobs: number;
             repeatables: number;
         }>;
@@ -27,10 +27,10 @@ export declare const CloudflareQueueScheduler: Readonly<{
         queue: SchedulerQueueApi;
         batchSize?: number;
     }): {
-        dispatchDueJobs(): Promise<number>;
-        dispatchRepeatables(): Promise<number>;
-        reconcileStalled(): Promise<number>;
-        run(): Promise<{
+        dispatchDueJobs: () => Promise<number>;
+        dispatchRepeatables: () => Promise<number>;
+        reconcileStalled: () => Promise<number>;
+        run: () => Promise<{
             jobs: number;
             repeatables: number;
         }>;

package/dist/CloudflareQueueScheduler.js

@@ -6,20 +6,61 @@ const toEnvelope = (input) => ({
     attempt: input.attempt,
     availableAt: input.availableAt,
 });
+const dispatchJob = async (config, job) => {
+    await config.queue.enqueue(config.queueName, toEnvelope({
+        queueName: job.queueName,
+        jobId: job.id,
+        name: job.name,
+        attempt: job.attemptsMade,
+        availableAt: job.availableAt,
+    }));
+    await config.store.markDispatched(job.queueName, job.id);
+};
+const dispatchRepeatable = async (config, row) => {
+    const payload = JSON.parse(row.payload);
+    const job = await config.store.createJob({
+        queueName: row.queue_name,
+        name: row.name,
+        data: payload,
+    });
+    await config.queue.enqueue(row.queue_name, toEnvelope({
+        queueName: row.queue_name,
+        jobId: job.id,
+        name: row.name,
+        attempt: 0,
+        availableAt: job.availableAt,
+    }));
+    await config.store.markDispatched(job.queueName, job.id);
+    await config.store.updateRepeatableAfterRun(row);
+};
+const retryStalledJob = async (config, job) => {
+    await config.store.updateState({
+        queueName: job.queueName,
+        jobId: job.id,
+        state: 'stalled',
+    });
+    await config.store.updateState({
+        queueName: job.queueName,
+        jobId: job.id,
+        state: 'retrying',
+        availableAt: new Date().toISOString(),
+    });
+    await config.queue.enqueue(job.queueName, toEnvelope({
+        queueName: job.queueName,
+        jobId: job.id,
+        name: job.name,
+        attempt: job.attemptsMade,
+        availableAt: job.availableAt,
+    }));
+    await config.store.markDispatched(job.queueName, job.id);
+};
 const createScheduler = (config) => {
     return {
         async dispatchDueJobs() {
             const jobs = await config.store.getDueJobs(config.queueName, config.batchSize);
             let dispatched = 0;
             for (const job of jobs) {
-                await config.queue.enqueue(config.queueName, toEnvelope({
-                    queueName: job.queueName,
-                    jobId: job.id,
-                    name: job.name,
-                    attempt: job.attemptsMade,
-                    availableAt: job.availableAt,
-                }));
-                await config.store.markDispatched(job.queueName, job.id);
+                await dispatchJob(config, job);
                 dispatched += 1;
             }
             return dispatched;
@@ -28,21 +69,7 @@ const createScheduler = (config) => {
             const rows = await config.store.getDueRepeatables(config.batchSize);
             let dispatched = 0;
             for (const row of rows) {
-                const payload = JSON.parse(row.payload);
-                const job = await config.store.createJob({
-                    queueName: row.queue_name,
-                    name: row.name,
-                    data: payload,
-                });
-                await config.queue.enqueue(row.queue_name, toEnvelope({
-                    queueName: row.queue_name,
-                    jobId: job.id,
-                    name: row.name,
-                    attempt: 0,
-                    availableAt: job.availableAt,
-                }));
-                await config.store.markDispatched(job.queueName, job.id);
-                await config.store.updateRepeatableAfterRun(row);
+                await dispatchRepeatable(config, row);
                 dispatched += 1;
             }
             return dispatched;
@@ -51,25 +78,7 @@ const createScheduler = (config) => {
             const stalled = await config.store.getStalledJobs(config.queueName, config.stalledAfterMs ?? 60_000, config.batchSize);
             let retried = 0;
             for (const job of stalled) {
-                await config.store.updateState({
-                    queueName: job.queueName,
-                    jobId: job.id,
-                    state: 'stalled',
-                });
-                await config.store.updateState({
-                    queueName: job.queueName,
-                    jobId: job.id,
-                    state: 'retrying',
-                    availableAt: new Date().toISOString(),
-                });
-                await config.queue.enqueue(job.queueName, toEnvelope({
-                    queueName: job.queueName,
-                    jobId: job.id,
-                    name: job.name,
-                    attempt: job.attemptsMade,
-                    availableAt: job.availableAt,
-                }));
-                await config.store.markDispatched(job.queueName, job.id);
+                await retryStalledJob(config, job);
                 retried += 1;
             }
             return retried;

package/dist/build-manifest.json

@@ -0,0 +1,161 @@
+{
+  "name": "@zintrust/queue-cloudflare",
+  "version": "2.4.1",
+  "buildDate": "2026-06-11T20:48:26.547Z",
+  "buildEnvironment": {
+    "node": "v22.22.1",
+    "platform": "darwin",
+    "arch": "arm64"
+  },
+  "git": {
+    "commit": "5a1a7000",
+    "branch": "release"
+  },
+  "package": {
+    "engines": {
+      "node": ">=20.0.0"
+    },
+    "dependencies": [],
+    "peerDependencies": [
+      "@zintrust/core"
+    ]
+  },
+  "files": {
+    "CloudflareJobStore.d.ts": {
+      "size": 2901,
+      "sha256": "906d0a4ede39894eec99e2da4215b701947a3717696ad5735947ad6a672c078f"
+    },
+    "CloudflareJobStore.js": {
+      "size": 20661,
+      "sha256": "6226a96500b6fc01117624cea84d2211fc7ec916bdd9221adaa42c08974f8893"
+    },
+    "CloudflareQueueConsumer.d.ts": {
+      "size": 1411,
+      "sha256": "9a1a5d9b19f46811403c9b23e9b2ce7c15fee03505de0e0fd54950f9518e93af"
+    },
+    "CloudflareQueueConsumer.js": {
+      "size": 7714,
+      "sha256": "da6b078b05d8e3a57b5e19fc4c325a01ef21c6350e6bc4687c42aa6752ffb2fc"
+    },
+    "CloudflareQueueCoordinator.d.ts": {
+      "size": 898,
+      "sha256": "93e028ce222f7dbf9c17640e2a23620dbb24d1f545bfd7dcd739f97132f2aea1"
+    },
+    "CloudflareQueueCoordinator.js": {
+      "size": 2541,
+      "sha256": "2025c203e84adac03a9db753326bc4d97b4540eef3ee29ab1f1fd729959ff178"
+    },
+    "CloudflareQueueMigrator.d.ts": {
+      "size": 481,
+      "sha256": "462f69b84e99a67cdc4867effd9aafd4153562683889e4e54b4249d0ff89fd0c"
+    },
+    "CloudflareQueueMigrator.js": {
+      "size": 821,
+      "sha256": "6a5b9d17795f17b1b6d3a944cf665352f315ba5cbb29939ac5f4bc746676fa81"
+    },
+    "CloudflareQueueScheduler.d.ts": {
+      "size": 1373,
+      "sha256": "561bfd82597e6171f6a02accec7b7eaaf05a415d03c36806622326cbb3319338"
+    },
+    "CloudflareQueueScheduler.js": {
+      "size": 3751,
+      "sha256": "2574729f296c5470d9d2e2a8f2a750f0e2a504bc5c2fa72551c03aec58250475"
+    },
+    "cli/MigrateCloudflareQueueCommand.d.ts": {
+      "size": 279,
+      "sha256": "7053823798a95d919634e449a1a61bc872ea78e2a72d438fd60b9775457f30e8"
+    },
+    "cli/MigrateCloudflareQueueCommand.js": {
+      "size": 2214,
+      "sha256": "b0283c36ab377249b28fde4118fdc07dfcecfe56e0e60c5efa293fcdfc90cd69"
+    },
+    "cli-register.d.ts": {
+      "size": 265,
+      "sha256": "6816103b5a0b5a76bcf10b9e33f8405f42911a9d0f46c9b28b9af8cd2fac1671"
+    },
+    "cli-register.js": {
+      "size": 799,
+      "sha256": "1b2d4af1ba820e9d4ade4981dd6ad66cd7497b4d57847755c6272422871bd8aa"
+    },
+    "index.d.ts": {
+      "size": 3797,
+      "sha256": "716eceb48e844c1bbc80b63c73a40495dd88bf95ab3a8b332791efcd87fb0aa5"
+    },
+    "index.js": {
+      "size": 19749,
+      "sha256": "4f36fc2b0caa6eb99a4199a23493f14ead410e76f6b57b909919e6c0e3155f70"
+    },
+    "migrationSql.d.ts": {
+      "size": 151,
+      "sha256": "fe04e08b27af1d72c0a7a5f53c1a7344a74b76bca6828dbcaab4aad9bf11121c"
+    },
+    "migrationSql.js": {
+      "size": 4000,
+      "sha256": "5771630205e8a1f6ff8a40de13ed410f78ebc3948aa95635f043560c7027056d"
+    },
+    "migrations/20260608000001_create_cloudflare_queue_jobs_table.d.ts": {
+      "size": 210,
+      "sha256": "37a4d000493f61c93bcccd7d6253beda0112f656c4c57ba1415d69fcd86f12f8"
+    },
+    "migrations/20260608000001_create_cloudflare_queue_jobs_table.js": {
+      "size": 1589,
+      "sha256": "3da5123da3fbf5d3a297d916b030f62022e854a81451e1421c582c18eac92f97"
+    },
+    "migrations/20260608000002_create_cloudflare_queue_job_events_table.d.ts": {
+      "size": 210,
+      "sha256": "37a4d000493f61c93bcccd7d6253beda0112f656c4c57ba1415d69fcd86f12f8"
+    },
+    "migrations/20260608000002_create_cloudflare_queue_job_events_table.js": {
+      "size": 772,
+      "sha256": "824e2c98ae5d58255d7a5b489e89000464c362b650f25634513720980748ee73"
+    },
+    "migrations/20260608000003_create_cloudflare_queue_job_logs_table.d.ts": {
+      "size": 210,
+      "sha256": "37a4d000493f61c93bcccd7d6253beda0112f656c4c57ba1415d69fcd86f12f8"
+    },
+    "migrations/20260608000003_create_cloudflare_queue_job_logs_table.js": {
+      "size": 803,
+      "sha256": "0731df82ab7d7368bafb8a7c1bf13eb50bf45569302a387b977e333c49d225f6"
+    },
+    "migrations/20260608000004_create_cloudflare_queue_repeatables_table.d.ts": {
+      "size": 210,
+      "sha256": "37a4d000493f61c93bcccd7d6253beda0112f656c4c57ba1415d69fcd86f12f8"
+    },
+    "migrations/20260608000004_create_cloudflare_queue_repeatables_table.js": {
+      "size": 1117,
+      "sha256": "0b43fb6196bb0725fcd304cd13a91be17da78711ee39731b882b64be21227030"
+    },
+    "migrations/20260608000005_create_cloudflare_queue_flow_dependencies_table.d.ts": {
+      "size": 210,
+      "sha256": "37a4d000493f61c93bcccd7d6253beda0112f656c4c57ba1415d69fcd86f12f8"
+    },
+    "migrations/20260608000005_create_cloudflare_queue_flow_dependencies_table.js": {
+      "size": 846,
+      "sha256": "cbc981e809d3d7e1c14ef02b198bae30751f58c689c80cada42795c200b200dd"
+    },
+    "migrations/index.d.ts": {
+      "size": 194,
+      "sha256": "4865154f5157c6af231010ffabfb6939df98804fee48de0725b54dd55214eafb"
+    },
+    "migrations/index.js": {
+      "size": 673,
+      "sha256": "fbfc44a57c6f53e5e7778a4e4e4cc8476a7f85e7369b62ad48d14839cd0c60e2"
+    },
+    "register.d.ts": {
+      "size": 175,
+      "sha256": "b6f999615d49ceb0acc6b07221e6a77a45d00348b702ab0650ebdb79c19f7b20"
+    },
+    "register.js": {
+      "size": 601,
+      "sha256": "e880096f4f293f3f4586e6ec8c4162773617574dfb8dc0f081b1b11fee2a793c"
+    },
+    "types.d.ts": {
+      "size": 7286,
+      "sha256": "229f59486e848824998d4a58bfac55cebaf05b069fcb97d5bd23e7577e0bbe39"
+    },
+    "types.js": {
+      "size": 11,
+      "sha256": "8e609bb71c20b858c77f0e9f90bb1319db8477b13f9f965f1a1e18524bf50881"
+    }
+  }
+}

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import { CloudflareQueueConsumer } from './CloudflareQueueConsumer.js';
-import type { CloudflareJobOptions, CloudflareFlowInput, CloudflareFlowResult, CloudflareQueueConfig, CloudflareQueueJob, CloudflareQueueMetrics, CloudflareQueueProcessor, CloudflareQueueState, QueueMessage } from './types.js';
-export type { CloudflareJobOptions, CloudflareFlowInput, CloudflareFlowResult, CloudflareQueueBackoff, CloudflareQueueBinding, CloudflareQueueConfig, CloudflareQueueContentType, CloudflareQueueEnvelope, CloudflareQueueJob, CloudflareQueueMetrics, CloudflareQueueProcessor, CloudflareQueueProcessorContext, CloudflareQueueState, CloudflareQueueStateConfig, CloudflareQueueRetention, CloudflareRepeatOptions, QueueMessage, } from './types.js';
+import type { CloudflareFlowInput, CloudflareFlowResult, CloudflareJobOptions, CloudflareQueueConfig, CloudflareQueueJob, CloudflareQueueMetrics, CloudflareQueueProcessor, CloudflareQueueState, QueueMessage } from './types.js';
 export { CloudflareJobStore } from './CloudflareJobStore.js';
 export { CloudflareQueueConsumer } from './CloudflareQueueConsumer.js';
 export { CloudflareQueueCoordinator } from './CloudflareQueueCoordinator.js';
 export { CloudflareQueueMigrator } from './CloudflareQueueMigrator.js';
 export { CloudflareQueueScheduler } from './CloudflareQueueScheduler.js';
+export type { CloudflareFlowInput, CloudflareFlowResult, CloudflareJobOptions, CloudflareQueueBackoff, CloudflareQueueBinding, CloudflareQueueConfig, CloudflareQueueContentType, CloudflareQueueEnvelope, CloudflareQueueJob, CloudflareQueueMetrics, CloudflareQueueProcessor, CloudflareQueueProcessorContext, CloudflareQueueRetention, CloudflareQueueState, CloudflareQueueStateConfig, CloudflareRepeatOptions, QueueMessage, } from './types.js';
 type CloudflareQueueDriver = {
     enqueue<T = unknown>(queue: string, payload: T): Promise<string>;
     dequeue<T = unknown>(queue: string): Promise<QueueMessage<T> | undefined>;

package/dist/index.js

@@ -1,7 +1,9 @@
+/* eslint-disable no-await-in-loop, complexity */
+/* Sequential processing required for queue operations, some functions are complex by design */
 import { Cloudflare } from '@zintrust/core/cloudflare';
 import { ErrorFactory } from '@zintrust/core/errors';
 import { generateUuid } from '@zintrust/core/utils';
-import { CloudflareJobStore } from './CloudflareJobStore.js';
+import { CloudflareJobStore, } from './CloudflareJobStore.js';
 import { CloudflareQueueConsumer } from './CloudflareQueueConsumer.js';
 import { CloudflareQueueMigrator } from './CloudflareQueueMigrator.js';
 import { CloudflareQueueScheduler } from './CloudflareQueueScheduler.js';
@@ -125,8 +127,10 @@ const apiFetch = async (queue, config, path, init) => {
     const text = await response.text();
     const parsed = text === '' ? {} : JSON.parse(text);
     if (!response.ok || parsed.success === false) {
-        const message = parsed.errors?.map((error) => error.message).filter(Boolean).join('; ') ||
-            `Cloudflare Queues API error (${response.status})`;
+        const message = parsed.errors
+            ?.map((error) => error.message)
+            .filter(Boolean)
+            .join('; ') || `Cloudflare Queues API error (${response.status})`;
         throw ErrorFactory.createConnectionError(message, { status: response.status, body: parsed });
     }
     return (parsed.result ?? parsed);
@@ -215,7 +219,9 @@ const createDequeue = (state, config) => async (queue) => {
         body: JSON.stringify(body),
     });
     state.lastBacklogCount =
-        pulled.message_backlog_count ?? pulled.metadata?.metrics?.backlog_count ?? state.lastBacklogCount;
+        pulled.message_backlog_count ??
+            pulled.metadata?.metrics?.backlog_count ??
+            state.lastBacklogCount;
     const message = pulled.messages?.[0];
     if (message === undefined)
         return undefined;
@@ -290,6 +296,7 @@ const delayOptions = (options) => {
     const delaySeconds = Math.max(0, Math.floor((options?.delay ?? 0) / 1000));
     return delaySeconds > 0 ? { delaySeconds } : undefined;
 };
+// eslint-disable-next-line max-lines-per-function -- Complex driver with many methods
 function createCloudflareQueueDriver(config) {
     const state = { leases: new Map() };
     const rawSender = sendRaw(config);
@@ -424,7 +431,13 @@ function createCloudflareQueueDriver(config) {
             await getStore().clean(queue, states, olderThanMs);
         },
         async upsertJobScheduler(queue, name, data, repeat, id) {
-            return await getStore().upsertRepeatable({ id, queueName: queue, name, data, options: repeat });
+            return await getStore().upsertRepeatable({
+                id,
+                queueName: queue,
+                name,
+                data,
+                options: repeat,
+            });
         },
         async removeJobScheduler(id) {
             await getStore().removeRepeatable(id);
@@ -433,10 +446,12 @@ function createCloudflareQueueDriver(config) {
             return await CloudflareQueueScheduler.create({
                 queueName: queue,
                 store: getStore(),
-                queue: { enqueue: async (queueName, payload) => {
+                queue: {
+                    enqueue: async (queueName, payload) => {
                         await rawSender(queueName, payload);
                         return generateUuid();
-                    } },
+                    },
+                },
                 batchSize: limit,
             }).run();
         },
@@ -444,10 +459,12 @@ function createCloudflareQueueDriver(config) {
             return await CloudflareQueueScheduler.create({
                 queueName: queue,
                 store: getStore(),
-                queue: { enqueue: async (queueName, payload) => {
+                queue: {
+                    enqueue: async (queueName, payload) => {
                         await rawSender(queueName, payload);
                         return generateUuid();
-                    } },
+                    },
+                },
                 batchSize: limit,
                 stalledAfterMs: olderThanMs,
             }).reconcileStalled();
@@ -472,9 +489,11 @@ function createCloudflareQueueDriver(config) {
                 store: getStore(),
                 processor,
                 state: config?.state,
-                queue: { enqueue: async (queueName, payload) => {
-                        await rawSender(queueName, payload);
-                    } },
+                queue: {
+                    enqueue: async (targetQueue, payload) => {
+                        await rawSender(targetQueue, payload);
+                    },
+                },
             });
         },
         async migrateState() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/queue-cloudflare",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "Cloudflare Queues driver for ZinTrust.",
   "private": false,
   "type": "module",