covara 0.0.1 → 0.6.0

package/dist/storage/types.d.ts

@@ -0,0 +1,75 @@
+import { Readable } from "node:stream";
+export interface FileMetadata {
+    key: string;
+    filename: string;
+    mimeType: string;
+    size: number;
+    createdAt: Date;
+    updatedAt?: Date;
+    etag?: string;
+    contentEncoding?: string;
+    customMetadata?: Record<string, string>;
+}
+export interface UploadOptions {
+    filename?: string;
+    mimeType?: string;
+    contentEncoding?: string;
+    cacheControl?: string;
+    customMetadata?: Record<string, string>;
+}
+export interface UploadResult {
+    key: string;
+    url?: string;
+    etag?: string;
+    size: number;
+}
+export interface PresignedUrlOptions {
+    expiresIn?: number;
+    contentType?: string;
+    contentLength?: number;
+    metadata?: Record<string, string>;
+}
+export interface PresignedUploadResult {
+    url: string;
+    fields?: Record<string, string>;
+    key: string;
+    expiresAt: Date;
+}
+export interface StorageAdapter {
+    upload(key: string, data: Buffer | Readable, options?: UploadOptions): Promise<UploadResult>;
+    download(key: string): Promise<Buffer>;
+    downloadStream(key: string): Promise<Readable>;
+    delete(key: string): Promise<void>;
+    deleteMany(keys: string[]): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    getMetadata(key: string): Promise<FileMetadata | null>;
+    getUrl(key: string): string | null;
+    getDownloadUrl(key: string, options?: PresignedUrlOptions): Promise<string | null>;
+    getUploadUrl(key: string, options?: PresignedUrlOptions): Promise<PresignedUploadResult | null>;
+    supportsPresignedUrls(): boolean;
+}
+export interface LocalStorageConfig {
+    basePath: string;
+    baseUrl?: string;
+    createDirectories?: boolean;
+}
+export interface S3StorageConfig {
+    bucket: string;
+    region?: string;
+    endpoint?: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    forcePathStyle?: boolean;
+    presignedUrlExpiry?: number;
+}
+export interface StorageConfig {
+    type: "memory" | "local" | "s3" | "r2";
+    local?: LocalStorageConfig;
+    s3?: S3StorageConfig;
+    r2?: unknown;
+}
+export declare const setGlobalStorage: (storage: StorageAdapter) => void;
+export declare const getGlobalStorage: () => StorageAdapter;
+export declare const hasGlobalStorage: () => boolean;
+export declare const clearGlobalStorage: () => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,QAAQ,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEnC,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1B,YAAY,CACV,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAEzC,qBAAqB,IAAI,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,EAAE,CAAC,EAAE,eAAe,CAAC;IACrB,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAID,eAAO,MAAM,gBAAgB,GAAI,SAAS,cAAc,KAAG,IAE1D,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAO,cAOnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAO,OAEnC,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAC"}

package/dist/storage/types.js

@@ -0,0 +1,17 @@
+let globalStorage = null;
+export const setGlobalStorage = (storage) => {
+    globalStorage = storage;
+};
+export const getGlobalStorage = () => {
+    if (!globalStorage) {
+        throw new Error("Storage not initialized. Call setGlobalStorage() or initializeStorage() first.");
+    }
+    return globalStorage;
+};
+export const hasGlobalStorage = () => {
+    return globalStorage !== null;
+};
+export const clearGlobalStorage = () => {
+    globalStorage = null;
+};
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAoGA,IAAI,aAAa,GAA0B,IAAI,CAAC;AAEhD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAuB,EAAQ,EAAE;IAChE,aAAa,GAAG,OAAO,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAmB,EAAE;IACnD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC5C,OAAO,aAAa,KAAK,IAAI,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAS,EAAE;IAC3C,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC,CAAC"}

package/dist/storage/validation.d.ts

@@ -0,0 +1,11 @@
+export interface UploadValidationOptions {
+    maxSize?: number;
+    allowedTypes?: string[];
+    blockedTypes?: string[];
+}
+export interface UploadValidationInput {
+    contentType?: string;
+    size?: number;
+}
+export declare const validateUpload: (input: UploadValidationInput, options: UploadValidationOptions) => void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/storage/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/storage/validation.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAeD,eAAO,MAAM,cAAc,GACzB,OAAO,qBAAqB,EAC5B,SAAS,uBAAuB,KAC/B,IAoCF,CAAC"}

package/dist/storage/validation.js

@@ -0,0 +1,38 @@
+import { ValidationError } from "../resource/error.js";
+const matchesPattern = (contentType, pattern) => {
+    if (pattern === contentType)
+        return true;
+    if (pattern.endsWith("/*")) {
+        const prefix = pattern.slice(0, -1);
+        return contentType.startsWith(prefix);
+    }
+    return false;
+};
+const matchesAny = (contentType, patterns) => {
+    return patterns.some((pattern) => matchesPattern(contentType, pattern));
+};
+export const validateUpload = (input, options) => {
+    const { contentType, size } = input;
+    const { maxSize, allowedTypes, blockedTypes } = options;
+    if (typeof maxSize === "number" && typeof size === "number" && size > maxSize) {
+        throw new ValidationError(`File too large. Maximum size: ${maxSize} bytes`, { maxSize, size });
+    }
+    const normalizedType = contentType?.split(";")[0].trim().toLowerCase();
+    if (blockedTypes && blockedTypes.length > 0) {
+        if (!normalizedType) {
+            throw new ValidationError("Content type is required", { blockedTypes });
+        }
+        if (matchesAny(normalizedType, blockedTypes.map((t) => t.toLowerCase()))) {
+            throw new ValidationError(`File type not allowed: ${normalizedType}`, { contentType: normalizedType, blockedTypes });
+        }
+    }
+    if (allowedTypes && allowedTypes.length > 0) {
+        if (!normalizedType) {
+            throw new ValidationError("Content type is required", { allowedTypes });
+        }
+        if (!matchesAny(normalizedType, allowedTypes.map((t) => t.toLowerCase()))) {
+            throw new ValidationError(`File type not allowed. Allowed types: ${allowedTypes.join(", ")}`, { contentType: normalizedType, allowedTypes });
+        }
+    }
+};
+//# sourceMappingURL=validation.js.map

package/dist/storage/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/storage/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAanD,MAAM,cAAc,GAAG,CAAC,WAAmB,EAAE,OAAe,EAAW,EAAE;IACvE,IAAI,OAAO,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAE,QAAkB,EAAW,EAAE;IACtE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAA4B,EAC5B,OAAgC,EAC1B,EAAE;IACR,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACpC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAExD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,GAAG,OAAO,EAAE,CAAC;QAC9E,MAAM,IAAI,eAAe,CACvB,iCAAiC,OAAO,QAAQ,EAChD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEvE,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,UAAU,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,eAAe,CACvB,0BAA0B,cAAc,EAAE,EAC1C,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,CAC9C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,eAAe,CACvB,yCAAyC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAClE,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,CAC9C,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/tasks/cloudflare-queues.d.ts

@@ -0,0 +1,63 @@
+import { KVAdapter } from "../kv/types.js";
+import { TaskDefinition, ScheduleOptions } from "./types.js";
+import { TaskRegistry } from "./scheduler.js";
+import { DeadLetterQueueOptions } from "./dlq.js";
+export interface QueueSendOptions {
+    delaySeconds?: number;
+    contentType?: string;
+}
+export interface QueueBindingLike<TBody = unknown> {
+    send(message: TBody, options?: QueueSendOptions): Promise<void>;
+    sendBatch?(messages: Iterable<{
+        body: TBody;
+        options?: QueueSendOptions;
+    }>): Promise<void>;
+}
+export interface QueueMessageLike<TBody = unknown> {
+    readonly id: string;
+    readonly timestamp: Date;
+    readonly body: TBody;
+    readonly attempts?: number;
+    ack(): void;
+    retry(options?: {
+        delaySeconds?: number;
+    }): void;
+}
+export interface MessageBatchLike<TBody = unknown> {
+    readonly queue: string;
+    readonly messages: QueueMessageLike<TBody>[];
+    ackAll?(): void;
+    retryAll?(options?: {
+        delaySeconds?: number;
+    }): void;
+}
+export interface QueueTaskMessage<TInput = unknown> {
+    taskId: string;
+    name: string;
+    input: TInput;
+    attempt: number;
+    maxAttempts: number;
+    priority: number;
+    scheduledFor: number;
+    createdAt: number;
+    idempotencyKey?: string;
+    originalTaskId?: string;
+    replayCount?: number;
+}
+export interface CloudflareQueueProducer {
+    enqueue<TInput>(task: TaskDefinition<TInput>, input: TInput, options?: ScheduleOptions): Promise<string>;
+    enqueueBatch<TInput>(task: TaskDefinition<TInput>, inputs: TInput[], options?: ScheduleOptions): Promise<string[]>;
+}
+export declare const createCloudflareQueueProducer: (binding: QueueBindingLike<QueueTaskMessage>) => CloudflareQueueProducer;
+export interface QueueConsumerConfig {
+    kv: KVAdapter;
+    registry: TaskRegistry;
+    workerId?: string;
+    db?: unknown;
+    onDlqEnqueue?: DeadLetterQueueOptions["onDlqEnqueue"];
+}
+export interface QueueConsumer<TInput = unknown> {
+    process(batch: MessageBatchLike<QueueTaskMessage<TInput>>): Promise<void>;
+}
+export declare const createQueueConsumer: (config: QueueConsumerConfig) => QueueConsumer;
+//# sourceMappingURL=cloudflare-queues.d.ts.map

package/dist/tasks/cloudflare-queues.d.ts.map

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

package/dist/tasks/cloudflare-queues.js

@@ -0,0 +1,172 @@
+import { createTaskStorage } from "./storage.js";
+import { createDeadLetterQueue } from "./dlq.js";
+import { calculateBackoff, shouldRetry } from "./retry.js";
+import { createIdempotencyStore, DEFAULT_IDEMPOTENCY_RETENTION_MS, } from "./idempotency.js";
+import { DEFAULT_RESULT_TTL_MS } from "./worker.js";
+const buildMessage = (task, input, options) => {
+    const now = Date.now();
+    const scheduledFor = options?.at?.getTime() ?? now + (options?.delay ?? 0);
+    return {
+        taskId: crypto.randomUUID(),
+        name: task.name,
+        input,
+        attempt: 0,
+        maxAttempts: task.retry?.maxAttempts ?? 3,
+        priority: options?.priority ?? task.priority ?? 50,
+        scheduledFor,
+        createdAt: now,
+        ...(options?.idempotencyKey ?? task.idempotencyKey?.(input)
+            ? {
+                idempotencyKey: options?.idempotencyKey ?? task.idempotencyKey?.(input),
+            }
+            : {}),
+    };
+};
+const delaySecondsFor = (message) => {
+    const diff = message.scheduledFor - Date.now();
+    if (diff <= 0)
+        return undefined;
+    return Math.ceil(diff / 1000);
+};
+export const createCloudflareQueueProducer = (binding) => ({
+    async enqueue(task, input, options) {
+        const message = buildMessage(task, input, options);
+        const delaySeconds = delaySecondsFor(message);
+        await binding.send(message, delaySeconds !== undefined ? { delaySeconds } : undefined);
+        return message.taskId;
+    },
+    async enqueueBatch(task, inputs, options) {
+        const messages = inputs.map((input) => buildMessage(task, input, options));
+        if (binding.sendBatch) {
+            await binding.sendBatch(messages.map((message) => {
+                const delaySeconds = delaySecondsFor(message);
+                return {
+                    body: message,
+                    ...(delaySeconds !== undefined ? { options: { delaySeconds } } : {}),
+                };
+            }));
+        }
+        else {
+            for (const message of messages) {
+                const delaySeconds = delaySecondsFor(message);
+                await binding.send(message, delaySeconds !== undefined ? { delaySeconds } : undefined);
+            }
+        }
+        return messages.map((message) => message.taskId);
+    },
+});
+const toTask = (message) => ({
+    id: message.taskId,
+    name: message.name,
+    input: message.input,
+    status: "running",
+    priority: message.priority,
+    createdAt: message.createdAt,
+    scheduledFor: message.scheduledFor,
+    attempt: message.attempt,
+    maxAttempts: message.maxAttempts,
+    ...(message.idempotencyKey !== undefined && {
+        idempotencyKey: message.idempotencyKey,
+    }),
+    ...(message.originalTaskId !== undefined && {
+        originalTaskId: message.originalTaskId,
+    }),
+    ...(message.replayCount !== undefined && { replayCount: message.replayCount }),
+});
+export const createQueueConsumer = (config) => {
+    const { kv, registry } = config;
+    const workerId = config.workerId ?? "cf-queue-consumer";
+    const storage = createTaskStorage(kv);
+    const idempotencyStore = createIdempotencyStore(kv);
+    const dlq = createDeadLetterQueue(kv, async () => {
+        throw new Error("Queue consumer DLQ entries are not auto-requeued");
+    }, { onDlqEnqueue: config.onDlqEnqueue });
+    const runMessage = async (message) => {
+        const payload = message.body;
+        const definition = registry.get(payload.name);
+        const task = toTask(payload);
+        const attemptNumber = message.attempts ?? payload.attempt + 1;
+        if (!definition) {
+            await storage.store({ ...task, status: "pending" });
+            await dlq.add({ ...task, attempt: attemptNumber }, `Unknown task type: ${payload.name}`);
+            message.ack();
+            return;
+        }
+        const retryConfig = definition.retry ?? {};
+        const maxAttempts = payload.maxAttempts;
+        const idempotencyKey = payload.idempotencyKey;
+        const retentionMs = definition.idempotencyRetentionMs ?? DEFAULT_IDEMPOTENCY_RETENTION_MS;
+        const resultTtlMs = definition.resultTtlMs ?? DEFAULT_RESULT_TTL_MS;
+        await storage.store({ ...task, status: "running", startedAt: Date.now() });
+        try {
+            if (idempotencyKey) {
+                const completed = await idempotencyStore.getCompleted(idempotencyKey);
+                if (completed) {
+                    await storage.updateStatus(task.id, "running", "completed", {
+                        result: completed.result,
+                        completedAt: Date.now(),
+                        resultExpiresAt: Date.now() + resultTtlMs,
+                    });
+                    message.ack();
+                    return;
+                }
+            }
+            const controller = new AbortController();
+            const ctx = {
+                taskId: task.id,
+                attempt: attemptNumber,
+                scheduledAt: new Date(task.scheduledFor),
+                startedAt: new Date(),
+                workerId,
+                signal: controller.signal,
+                db: config.db,
+                reportProgress: async (percent, msg) => {
+                    await storage.setProgress(task.id, {
+                        percent: Math.max(0, Math.min(100, percent)),
+                        ...(msg !== undefined && { message: msg }),
+                        updatedAt: Date.now(),
+                    });
+                },
+            };
+            const timeoutMs = definition.timeout ?? 30000;
+            const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error("Task timeout")), timeoutMs));
+            const result = await Promise.race([
+                definition.handler(ctx, payload.input),
+                timeoutPromise,
+            ]);
+            if (idempotencyKey) {
+                await idempotencyStore.markCompleted(idempotencyKey, { taskId: task.id, result, completedAt: Date.now() }, retentionMs);
+            }
+            await storage.updateStatus(task.id, "running", "completed", {
+                result,
+                completedAt: Date.now(),
+                resultExpiresAt: Date.now() + resultTtlMs,
+            });
+            message.ack();
+        }
+        catch (error) {
+            const err = error;
+            if (shouldRetry(err, attemptNumber, maxAttempts, retryConfig)) {
+                const backoff = calculateBackoff(attemptNumber, retryConfig);
+                await storage.updateStatus(task.id, "running", "scheduled", {
+                    attempt: attemptNumber,
+                    lastError: err.message,
+                    workerId: undefined,
+                });
+                message.retry({ delaySeconds: Math.ceil(backoff / 1000) });
+            }
+            else {
+                await dlq.add({ ...task, attempt: attemptNumber }, err.message);
+                message.ack();
+            }
+        }
+    };
+    return {
+        async process(batch) {
+            for (const message of batch.messages) {
+                await runMessage(message);
+            }
+        },
+    };
+};
+//# sourceMappingURL=cloudflare-queues.js.map

package/dist/tasks/cloudflare-queues.js.map

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

package/dist/tasks/concurrency.d.ts

@@ -0,0 +1,8 @@
+import { KVAdapter } from "../kv/types.js";
+export interface ConcurrencyLimiter {
+    tryReserve(taskName: string, maxConcurrency: number): Promise<boolean>;
+    release(taskName: string): Promise<void>;
+    getRunning(taskName: string): Promise<number>;
+}
+export declare const createConcurrencyLimiter: (kv: KVAdapter) => ConcurrencyLimiter;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/tasks/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/tasks/concurrency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,wBAAwB,GACnC,IAAI,SAAS,KACZ,kBA4BD,CAAC"}

package/dist/tasks/concurrency.js

@@ -0,0 +1,27 @@
+const RUNNING_COUNT_PREFIX = "covara:tasks:concurrency:";
+export const createConcurrencyLimiter = (kv) => ({
+    async tryReserve(taskName, maxConcurrency) {
+        if (maxConcurrency <= 0)
+            return true;
+        const key = `${RUNNING_COUNT_PREFIX}${taskName}`;
+        const count = await kv.incr(key);
+        if (count > maxConcurrency) {
+            await kv.decr(key);
+            return false;
+        }
+        return true;
+    },
+    async release(taskName) {
+        const key = `${RUNNING_COUNT_PREFIX}${taskName}`;
+        const count = await kv.decr(key);
+        if (count < 0) {
+            await kv.set(key, "0");
+        }
+    },
+    async getRunning(taskName) {
+        const key = `${RUNNING_COUNT_PREFIX}${taskName}`;
+        const raw = await kv.get(key);
+        return raw ? parseInt(raw, 10) : 0;
+    },
+});
+//# sourceMappingURL=concurrency.js.map

package/dist/tasks/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/tasks/concurrency.ts"],"names":[],"mappings":"AAEA,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAQzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,EAAa,EACO,EAAE,CAAC,CAAC;IACxB,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,cAAsB;QAEtB,IAAI,cAAc,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,MAAM,GAAG,GAAG,GAAG,oBAAoB,GAAG,QAAQ,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;YAC3B,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,MAAM,GAAG,GAAG,GAAG,oBAAoB,GAAG,QAAQ,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,GAAG,GAAG,GAAG,oBAAoB,GAAG,QAAQ,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;CACF,CAAC,CAAC"}

package/dist/tasks/define.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { TaskDefinition, RetryConfig, DebounceConfig } from "./types.js";
+export interface DefineTaskOptions<TInput, TOutput> {
+    name: string;
+    input?: z.ZodSchema<TInput>;
+    output?: z.ZodSchema<TOutput>;
+    handler: (ctx: {
+        taskId: string;
+        attempt: number;
+        workerId: string;
+        signal: AbortSignal;
+        scheduledAt: Date;
+        startedAt: Date;
+    }, input: TInput) => Promise<TOutput>;
+    retry?: RetryConfig;
+    timeout?: number;
+    priority?: number;
+    maxConcurrency?: number;
+    debounce?: DebounceConfig;
+    idempotencyKey?: (input: TInput) => string;
+    idempotencyRetentionMs?: number;
+    resultTtlMs?: number;
+}
+export declare const defineTask: <TInput = unknown, TOutput = unknown>(options: DefineTaskOptions<TInput, TOutput>) => TaskDefinition<TInput, TOutput>;
+//# sourceMappingURL=define.d.ts.map

package/dist/tasks/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/tasks/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEtE,MAAM,WAAW,iBAAiB,CAAC,MAAM,EAAE,OAAO;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,CACP,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,EACnH,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,UAAU,GAAI,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC5D,SAAS,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1C,cAAc,CAAC,MAAM,EAAE,OAAO,CAehC,CAAC"}

package/dist/tasks/define.js

@@ -0,0 +1,17 @@
+export const defineTask = (options) => {
+    return {
+        name: options.name,
+        input: options.input,
+        output: options.output,
+        handler: options.handler,
+        retry: options.retry,
+        timeout: options.timeout,
+        priority: options.priority,
+        maxConcurrency: options.maxConcurrency,
+        debounce: options.debounce,
+        idempotencyKey: options.idempotencyKey,
+        idempotencyRetentionMs: options.idempotencyRetentionMs,
+        resultTtlMs: options.resultTtlMs,
+    };
+};
+//# sourceMappingURL=define.js.map

package/dist/tasks/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/tasks/define.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAA2C,EACV,EAAE;IACnC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;QACtD,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC,CAAC"}

package/dist/tasks/dlq.d.ts

@@ -0,0 +1,29 @@
+import { KVAdapter } from "../kv/types.js";
+import { Task, DeadLetterEntry, DlqMetrics } from "./types.js";
+export interface DlqReplayAuditEntry {
+    originalTaskId: string;
+    newTaskId: string;
+    replayedAt: number;
+    replayedBy?: string;
+    replayCount: number;
+}
+export interface DlqRetryAllOptions {
+    limit?: number;
+    replayedBy?: string;
+}
+export interface DeadLetterQueueOptions {
+    onDlqEnqueue?: (entry: DeadLetterEntry) => void | Promise<void>;
+}
+export interface DeadLetterQueue {
+    add(task: Task, reason: string): Promise<void>;
+    list(limit?: number, offset?: number): Promise<DeadLetterEntry[]>;
+    get(taskId: string): Promise<DeadLetterEntry | null>;
+    retry(taskId: string, replayedBy?: string): Promise<string | null>;
+    retryAll(options?: DlqRetryAllOptions): Promise<number>;
+    purge(olderThanMs?: number): Promise<number>;
+    count(): Promise<number>;
+    metrics(): Promise<DlqMetrics>;
+    audit(limit?: number): Promise<DlqReplayAuditEntry[]>;
+}
+export declare const createDeadLetterQueue: (kv: KVAdapter, requeue: (task: Task) => Promise<string>, options?: DeadLetterQueueOptions) => DeadLetterQueue;
+//# sourceMappingURL=dlq.d.ts.map

package/dist/tasks/dlq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.d.ts","sourceRoot":"","sources":["../../src/tasks/dlq.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAuC5D,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACrD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,qBAAqB,GAChC,IAAI,SAAS,EACb,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,EACxC,UAAS,sBAA2B,KACnC,eA4KF,CAAC"}