@weifuwujs/tasks 0.9.0

package/dist/stores/redis.js

@@ -0,0 +1,340 @@
+import { randomUUID } from 'node:crypto';
+const DEFAULT_MAX_ATTEMPTS = 5;
+/**
+ * claim 单段 Lua：回收过期锁 → 按 runAt 领取（attempts+1、进 processing），同一 EVAL 内完成。
+ *
+ * KEYS：data / idem / ready / processing / done
+ * ARGV：now(ms) / cutoff(ms) / nowIso / workerId / limit / names（`*`=不过滤，否则 JSON 数组，`[]`=全部拒绝）
+ *
+ * 时钟由 ARGV 传入（Lua 内不得取 TIME），保证契约可注入确定性时钟。
+ */
+const CLAIM_LUA = `
+local dataKey, idemKey, readyKey, procKey, doneKey = KEYS[1], KEYS[2], KEYS[3], KEYS[4], KEYS[5]
+local now, cutoff = tonumber(ARGV[1]), tonumber(ARGV[2])
+local nowIso, worker, limit = ARGV[3], ARGV[4], tonumber(ARGV[5])
+local filter = ARGV[6]
+
+local function allowed(name)
+  if filter == '*' then return true end
+  local names = cjson.decode(filter)
+  if names == nil or names == cjson.null or #names == 0 then return false end
+  for _, n in ipairs(names) do
+    if n == name then return true end
+  end
+  return false
+end
+
+local candidates = {}
+local expired = redis.call('ZRANGEBYSCORE', procKey, '-inf', cutoff)
+for _, id in ipairs(expired) do
+  local json = redis.call('HGET', dataKey, id)
+  if json then
+    local task = cjson.decode(json)
+    if task.attempts >= task.maxAttempts then
+      task.status = 'dead'
+      task.lockedBy = cjson.null
+      task.lockedAt = cjson.null
+      task.lastError = 'visibility timeout exceeded'
+      task.updatedAt = nowIso
+      task.updatedAtMs = now
+      redis.call('HSET', dataKey, id, cjson.encode(task))
+      redis.call('ZREM', procKey, id)
+      redis.call('ZADD', doneKey, now, id)
+    else
+      task.status = 'pending'
+      task.lockedBy = cjson.null
+      task.lockedAt = cjson.null
+      task.updatedAt = nowIso
+      task.updatedAtMs = now
+      redis.call('HSET', dataKey, id, cjson.encode(task))
+      redis.call('ZREM', procKey, id)
+      redis.call('ZADD', readyKey, tonumber(task.runAtMs), id)
+      candidates[#candidates + 1] = id
+    end
+  else
+    redis.call('ZREM', procKey, id)
+  end
+end
+
+local ready = redis.call('ZRANGEBYSCORE', readyKey, '-inf', now)
+for _, id in ipairs(ready) do
+  candidates[#candidates + 1] = id
+end
+
+local out = {}
+for _, id in ipairs(candidates) do
+  if #out >= limit then break end
+  local json = redis.call('HGET', dataKey, id)
+  if json then
+    local task = cjson.decode(json)
+    if task.status == 'pending' and tonumber(task.runAtMs) <= now and allowed(task.name) then
+      task.status = 'running'
+      task.lockedBy = worker
+      task.lockedAt = nowIso
+      task.attempts = task.attempts + 1
+      task.updatedAt = nowIso
+      task.updatedAtMs = now
+      redis.call('HSET', dataKey, id, cjson.encode(task))
+      redis.call('ZREM', readyKey, id)
+      redis.call('ZADD', procKey, now, id)
+      out[#out + 1] = cjson.encode(task)
+    end
+  end
+end
+return out
+`;
+function toStored(task) {
+    return {
+        ...task,
+        runAt: task.runAt.toISOString(),
+        runAtMs: task.runAt.getTime(),
+        lockedAt: task.lockedAt ? task.lockedAt.toISOString() : null,
+        createdAt: task.createdAt.toISOString(),
+        createdAtMs: task.createdAt.getTime(),
+        updatedAt: task.updatedAt.toISOString(),
+        updatedAtMs: task.updatedAt.getTime(),
+    };
+}
+function toTask(stored) {
+    return {
+        id: stored.id,
+        name: stored.name,
+        payload: stored.payload,
+        runAt: new Date(stored.runAt),
+        attempts: stored.attempts,
+        maxAttempts: stored.maxAttempts,
+        status: stored.status,
+        lockedBy: stored.lockedBy ?? null,
+        lockedAt: stored.lockedAt ? new Date(stored.lockedAt) : null,
+        idempotencyKey: stored.idempotencyKey ?? null,
+        lastError: stored.lastError ?? null,
+        createdAt: new Date(stored.createdAt),
+        updatedAt: new Date(stored.updatedAt),
+    };
+}
+/**
+ * redis 驱动（ZSET + Lua，复用 `ctx.redis` 同一客户端）。
+ *
+ * ```ts
+ * redisTaskStore('redis://…', { prefix: 'tasks' })
+ * redisTaskStore(ctx.redis)   // 注入已有客户端（不负责 close）
+ * ```
+ */
+export function redisTaskStore(urlOrRedis, options = {}) {
+    const injected = typeof urlOrRedis === 'object' && urlOrRedis !== null
+        ? urlOrRedis
+        : null;
+    const { prefix = 'tasks', ...redisOptions } = options;
+    const keys = {
+        data: `${prefix}:data`,
+        idem: `${prefix}:idem`,
+        ready: `${prefix}:ready`,
+        processing: `${prefix}:processing`,
+        done: `${prefix}:done`,
+    };
+    let client = injected ? Promise.resolve(injected) : null;
+    const redis = () => {
+        client ??= (async () => {
+            const { default: RedisClient } = (await import('ioredis'));
+            if (typeof urlOrRedis === 'string')
+                return new RedisClient(urlOrRedis, redisOptions);
+            if (process.env.REDIS_URL)
+                return new RedisClient(process.env.REDIS_URL, redisOptions);
+            return new RedisClient(redisOptions);
+        })();
+        return client;
+    };
+    const read = async (db, id) => {
+        const json = await db.hget(keys.data, id);
+        return json ? JSON.parse(json) : null;
+    };
+    const write = async (db, stored) => {
+        await db.hset(keys.data, stored.id, JSON.stringify(stored));
+    };
+    const flagDone = async (db, stored, now) => {
+        await db.zrem(keys.processing, stored.id);
+        await db.zadd(keys.done, String(now.getTime()), stored.id);
+    };
+    const store = {
+        async migrate() {
+            // redis 无 schema：键在首次写入时自动出现
+        },
+        async close() {
+            if (!client || injected)
+                return;
+            const db = await client;
+            client = null;
+            await db.quit();
+        },
+        async enqueue(input) {
+            const db = await redis();
+            const now = new Date();
+            const id = randomUUID();
+            const key = input.idempotencyKey;
+            if (key) {
+                const won = await db.hsetnx(keys.idem, key, id);
+                if (won === 0) {
+                    const existingId = await db.hget(keys.idem, key);
+                    const existing = existingId ? await read(db, existingId) : null;
+                    if (existing)
+                        return { task: toTask(existing), created: false };
+                    // 幂等键在但数据缺失（写入窗口崩溃）：以本次为准恢复
+                    await db.hset(keys.idem, key, id);
+                }
+            }
+            const task = {
+                id,
+                name: input.name,
+                payload: input.payload ?? null,
+                runAt: input.runAt ?? now,
+                attempts: 0,
+                maxAttempts: input.maxAttempts ?? DEFAULT_MAX_ATTEMPTS,
+                status: 'pending',
+                lockedBy: null,
+                lockedAt: null,
+                idempotencyKey: key ?? null,
+                lastError: null,
+                createdAt: now,
+                updatedAt: now,
+            };
+            const stored = toStored(task);
+            await write(db, stored);
+            await db.zadd(keys.ready, String(stored.runAtMs), id);
+            return { task, created: true };
+        },
+        async claim(claimOptions) {
+            const db = await redis();
+            const now = claimOptions.now;
+            const namesArg = claimOptions.names === undefined
+                ? '*'
+                : JSON.stringify(claimOptions.names);
+            const raw = (await db.eval(CLAIM_LUA, 5, keys.data, keys.idem, keys.ready, keys.processing, keys.done, String(now.getTime()), String(now.getTime() - claimOptions.visibilityTimeoutMs), now.toISOString(), claimOptions.workerId, String(Math.max(0, claimOptions.limit)), namesArg));
+            return raw.map((json) => toTask(JSON.parse(json)));
+        },
+        async complete(id, now) {
+            const db = await redis();
+            const stored = await read(db, id);
+            if (!stored)
+                return;
+            stored.status = 'done';
+            stored.lockedBy = null;
+            stored.lockedAt = null;
+            stored.updatedAt = now.toISOString();
+            stored.updatedAtMs = now.getTime();
+            await write(db, stored);
+            await flagDone(db, stored, now);
+        },
+        async fail(id, input, now) {
+            const db = await redis();
+            const stored = await read(db, id);
+            if (!stored)
+                return;
+            stored.lockedBy = null;
+            stored.lockedAt = null;
+            stored.lastError = input.error;
+            stored.updatedAt = now.toISOString();
+            stored.updatedAtMs = now.getTime();
+            if (input.retryAt) {
+                stored.status = 'pending';
+                stored.runAt = input.retryAt.toISOString();
+                stored.runAtMs = input.retryAt.getTime();
+                await write(db, stored);
+                await db.zrem(keys.processing, id);
+                await db.zadd(keys.ready, String(stored.runAtMs), id);
+            }
+            else {
+                stored.status = 'dead';
+                await write(db, stored);
+                await flagDone(db, stored, now);
+            }
+        },
+        async release(id, runAt, now) {
+            const db = await redis();
+            const stored = await read(db, id);
+            if (!stored)
+                return;
+            stored.status = 'pending';
+            stored.runAt = runAt.toISOString();
+            stored.runAtMs = runAt.getTime();
+            stored.lockedBy = null;
+            stored.lockedAt = null;
+            stored.updatedAt = now.toISOString();
+            stored.updatedAtMs = now.getTime();
+            await write(db, stored);
+            await db.zrem(keys.processing, id);
+            await db.zadd(keys.ready, String(stored.runAtMs), id);
+        },
+        async retry(id, now) {
+            const db = await redis();
+            const stored = await read(db, id);
+            if (!stored || stored.status !== 'dead')
+                return false;
+            stored.status = 'pending';
+            stored.attempts = 0;
+            stored.runAt = now.toISOString();
+            stored.runAtMs = now.getTime();
+            stored.lockedBy = null;
+            stored.lockedAt = null;
+            stored.lastError = null;
+            stored.updatedAt = now.toISOString();
+            stored.updatedAtMs = now.getTime();
+            await write(db, stored);
+            await db.zrem(keys.done, id);
+            await db.zrem(keys.processing, id);
+            await db.zadd(keys.ready, String(stored.runAtMs), id);
+            return true;
+        },
+        async get(id) {
+            const stored = await read(await redis(), id);
+            return stored ? toTask(stored) : null;
+        },
+        async list(filter = {}) {
+            const db = await redis();
+            const values = await db.hvals(keys.data);
+            let tasks = values.map((json) => toTask(JSON.parse(json)));
+            if (filter.statuses && filter.statuses.length > 0) {
+                const wanted = new Set(filter.statuses);
+                tasks = tasks.filter((task) => wanted.has(task.status));
+            }
+            if (filter.name)
+                tasks = tasks.filter((task) => task.name === filter.name);
+            tasks.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+            return filter.limit !== undefined ? tasks.slice(0, filter.limit) : tasks;
+        },
+        async prune(pruneOptions) {
+            const db = await redis();
+            const statuses = pruneOptions.statuses ?? ['done', 'dead'];
+            const threshold = pruneOptions.now.getTime() - pruneOptions.olderThanMs;
+            const ids = (await db.zrangebyscore(keys.done, '-inf', String(threshold)));
+            let removed = 0;
+            for (const id of ids) {
+                const stored = await read(db, id);
+                if (!stored || !statuses.includes(stored.status))
+                    continue;
+                if (stored.idempotencyKey)
+                    await db.hdel(keys.idem, stored.idempotencyKey);
+                await db.hdel(keys.data, id);
+                await db.zrem(keys.done, id);
+                await db.zrem(keys.ready, id);
+                await db.zrem(keys.processing, id);
+                removed += 1;
+            }
+            return removed;
+        },
+        async pendingNames(now) {
+            const db = await redis();
+            const ids = (await db.zrangebyscore(keys.ready, '-inf', String(now.getTime())));
+            if (ids.length === 0)
+                return [];
+            const values = (await db.hmget(keys.data, ...ids));
+            const names = new Set();
+            for (const json of values) {
+                if (json)
+                    names.add(JSON.parse(json).name);
+            }
+            return [...names];
+        },
+    };
+    return store;
+}
+//# sourceMappingURL=redis.js.map

package/dist/stores/redis.js.map

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

package/dist/stores/sqlite.d.ts

@@ -0,0 +1,13 @@
+import { DatabaseSync } from 'node:sqlite';
+import type { TaskStore } from '../types.ts';
+export interface SqliteTaskStore extends TaskStore {
+    readonly db: DatabaseSync;
+    migrate(): Promise<void>;
+    close(): void;
+}
+/**
+ * sqlite 驱动（`node:sqlite`，零依赖）。构造自动迁移，迁移幂等；
+ * `:memory:` 用于测试；**单进程**语义（多进程不承诺，文档写明）。
+ */
+export declare function sqliteTaskStore(path?: string): SqliteTaskStore;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/stores/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/stores/sqlite.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAQV,SAAS,EACV,MAAM,aAAa,CAAA;AA8EpB,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAA;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAkB,GAAG,eAAe,CA0MvE"}

package/dist/stores/sqlite.js

@@ -0,0 +1,216 @@
+import { randomUUID } from 'node:crypto';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+const DEFAULT_MAX_ATTEMPTS = 5;
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS tasks (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  run_at TEXT NOT NULL,
+  attempts INTEGER NOT NULL DEFAULT 0,
+  max_attempts INTEGER NOT NULL DEFAULT 5,
+  status TEXT NOT NULL,
+  locked_by TEXT,
+  locked_at TEXT,
+  idempotency_key TEXT UNIQUE,
+  last_error TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS tasks_due_idx ON tasks(status, run_at);
+CREATE INDEX IF NOT EXISTS tasks_name_idx ON tasks(name);
+`;
+function toTask(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        payload: JSON.parse(row.payload),
+        runAt: new Date(row.run_at),
+        attempts: row.attempts,
+        maxAttempts: row.max_attempts,
+        status: row.status,
+        lockedBy: row.locked_by,
+        lockedAt: row.locked_at ? new Date(row.locked_at) : null,
+        idempotencyKey: row.idempotency_key,
+        lastError: row.last_error,
+        createdAt: new Date(row.created_at),
+        updatedAt: new Date(row.updated_at),
+    };
+}
+function applyMigrations(db) {
+    db.exec('CREATE TABLE IF NOT EXISTS task_migrations (version INTEGER PRIMARY KEY, applied_at TEXT NOT NULL)');
+    const applied = db
+        .prepare('SELECT version FROM task_migrations WHERE version = ?')
+        .get(1);
+    if (applied)
+        return;
+    db.exec('BEGIN');
+    try {
+        db.exec(SCHEMA);
+        db.prepare('INSERT INTO task_migrations (version, applied_at) VALUES (?, ?)').run(1, new Date().toISOString());
+        db.exec('COMMIT');
+    }
+    catch (error) {
+        db.exec('ROLLBACK');
+        throw error;
+    }
+}
+/**
+ * sqlite 驱动（`node:sqlite`，零依赖）。构造自动迁移，迁移幂等；
+ * `:memory:` 用于测试；**单进程**语义（多进程不承诺，文档写明）。
+ */
+export function sqliteTaskStore(path = 'data/tasks.db') {
+    if (path !== ':memory:')
+        mkdirSync(dirname(path), { recursive: true });
+    const db = new DatabaseSync(path);
+    applyMigrations(db);
+    const store = {
+        db,
+        async migrate() {
+            applyMigrations(db);
+        },
+        close() {
+            db.close();
+        },
+        async enqueue(input) {
+            const timestamp = new Date().toISOString();
+            const key = input.idempotencyKey ?? null;
+            const id = randomUUID();
+            try {
+                db.prepare(`INSERT INTO tasks (id, name, payload, run_at, attempts, max_attempts, status,
+             locked_by, locked_at, idempotency_key, last_error, created_at, updated_at)
+           VALUES (?, ?, ?, ?, 0, ?, 'pending', NULL, NULL, ?, NULL, ?, ?)`).run(id, input.name, JSON.stringify(input.payload ?? null), (input.runAt ?? new Date()).toISOString(), input.maxAttempts ?? DEFAULT_MAX_ATTEMPTS, key, timestamp, timestamp);
+            }
+            catch (error) {
+                if (key && /UNIQUE/i.test(String(error))) {
+                    const existing = db
+                        .prepare('SELECT * FROM tasks WHERE idempotency_key = ?')
+                        .get(key);
+                    if (existing)
+                        return { task: toTask(existing), created: false };
+                }
+                throw error;
+            }
+            const row = db.prepare('SELECT * FROM tasks WHERE id = ?').get(id);
+            return { task: toTask(row), created: true };
+        },
+        async claim(options) {
+            const nowIso = options.now.toISOString();
+            const cutoff = new Date(options.now.getTime() - options.visibilityTimeoutMs).toISOString();
+            db.exec('BEGIN IMMEDIATE');
+            try {
+                // 1) 锁过期回收：达上限置 dead；否则回 pending 重领
+                const expired = db
+                    .prepare("SELECT * FROM tasks WHERE status = 'running' AND locked_at <= ?")
+                    .all(cutoff);
+                for (const row of expired) {
+                    if (row.attempts >= row.max_attempts) {
+                        db.prepare(`UPDATE tasks SET status = 'dead', last_error = 'visibility timeout exceeded',
+                 locked_by = NULL, locked_at = NULL, updated_at = ? WHERE id = ?`).run(nowIso, row.id);
+                    }
+                    else {
+                        db.prepare(`UPDATE tasks SET status = 'pending', locked_by = NULL, locked_at = NULL,
+                 updated_at = ? WHERE id = ?`).run(nowIso, row.id);
+                    }
+                }
+                // 2) 取到期任务（可选按 handler 名过滤）
+                const names = options.names;
+                const nameClause = names && names.length > 0
+                    ? `AND name IN (${names.map(() => '?').join(', ')})`
+                    : names && names.length === 0
+                        ? 'AND 0'
+                        : '';
+                const due = db
+                    .prepare(`SELECT id FROM tasks WHERE status = 'pending' AND run_at <= ? ${nameClause}
+             ORDER BY run_at LIMIT ?`)
+                    .all(nowIso, ...(names ?? []), Math.max(0, options.limit));
+                const claimed = [];
+                for (const { id } of due) {
+                    const result = db
+                        .prepare(`UPDATE tasks SET status = 'running', locked_by = ?, locked_at = ?,
+                 attempts = attempts + 1, updated_at = ? WHERE id = ? AND status = 'pending'`)
+                        .run(options.workerId, nowIso, nowIso, id);
+                    if (Number(result.changes) !== 1)
+                        continue;
+                    const row = db.prepare('SELECT * FROM tasks WHERE id = ?').get(id);
+                    claimed.push(toTask(row));
+                }
+                db.exec('COMMIT');
+                return claimed;
+            }
+            catch (error) {
+                db.exec('ROLLBACK');
+                throw error;
+            }
+        },
+        async complete(id, now) {
+            db.prepare(`UPDATE tasks SET status = 'done', locked_by = NULL, locked_at = NULL,
+           updated_at = ? WHERE id = ?`).run(now.toISOString(), id);
+        },
+        async fail(id, input, now) {
+            if (input.retryAt) {
+                db.prepare(`UPDATE tasks SET status = 'pending', run_at = ?, last_error = ?,
+             locked_by = NULL, locked_at = NULL, updated_at = ? WHERE id = ?`).run(input.retryAt.toISOString(), input.error, now.toISOString(), id);
+            }
+            else {
+                db.prepare(`UPDATE tasks SET status = 'dead', last_error = ?,
+             locked_by = NULL, locked_at = NULL, updated_at = ? WHERE id = ?`).run(input.error, now.toISOString(), id);
+            }
+        },
+        async release(id, runAt, now) {
+            db.prepare(`UPDATE tasks SET status = 'pending', run_at = ?, locked_by = NULL,
+           locked_at = NULL, updated_at = ? WHERE id = ?`).run(runAt.toISOString(), now.toISOString(), id);
+        },
+        async retry(id, now) {
+            const result = db
+                .prepare(`UPDATE tasks SET status = 'pending', run_at = ?, attempts = 0,
+             locked_by = NULL, locked_at = NULL, updated_at = ?
+           WHERE id = ? AND status = 'dead'`)
+                .run(now.toISOString(), now.toISOString(), id);
+            return Number(result.changes) === 1;
+        },
+        async get(id) {
+            const row = db.prepare('SELECT * FROM tasks WHERE id = ?').get(id);
+            return row ? toTask(row) : null;
+        },
+        async list(filter = {}) {
+            const clauses = [];
+            const params = [];
+            if (filter.statuses && filter.statuses.length > 0) {
+                clauses.push(`status IN (${filter.statuses.map(() => '?').join(', ')})`);
+                params.push(...filter.statuses);
+            }
+            if (filter.name) {
+                clauses.push('name = ?');
+                params.push(filter.name);
+            }
+            const where = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
+            const limit = filter.limit !== undefined ? 'LIMIT ?' : '';
+            if (filter.limit !== undefined)
+                params.push(filter.limit);
+            const rows = db
+                .prepare(`SELECT * FROM tasks ${where} ORDER BY created_at ${limit}`)
+                .all(...params);
+            return rows.map(toTask);
+        },
+        async prune(options) {
+            const statuses = options.statuses ?? ['done', 'dead'];
+            const threshold = new Date(options.now.getTime() - options.olderThanMs).toISOString();
+            const result = db
+                .prepare(`DELETE FROM tasks WHERE status IN (${statuses.map(() => '?').join(', ')})
+             AND updated_at <= ?`)
+                .run(...statuses, threshold);
+            return Number(result.changes);
+        },
+        async pendingNames(now) {
+            const rows = db
+                .prepare("SELECT DISTINCT name FROM tasks WHERE status = 'pending' AND run_at <= ?")
+                .all(now.toISOString());
+            return rows.map((row) => row.name);
+        },
+    };
+    return store;
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/stores/sqlite.js.map

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

package/dist/tasks.d.ts

@@ -0,0 +1,11 @@
+import type { CreateTasksOptions, Tasks } from './types.ts';
+/**
+ * 任务队列：handler 注册在进程内，库里只存 `name + payload`。
+ *
+ * - 至少一次：claim → 执行 → complete；崩溃后锁过期自动回队重跑；
+ * - 未知 handler：不领取（保持 pending）并告警一次；改名遗留用 CLI `tasks prune`；
+ * - 周期任务 `every`：首次立即到期，完成后排下一次（宕机后 catch-up）；
+ * - 注入时钟 + runOnce/drain：测试不 sleep。
+ */
+export declare function createTasks(options: CreateTasksOptions): Tasks;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAQlB,KAAK,EACN,MAAM,YAAY,CAAA;AAEnB;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,KAAK,CA+N9D"}