@open-mercato/queue 0.6.8-develop.6948.1.8369fc4c97 → 0.6.8-develop.6958.1.6696e8db69

package/dist/strategies/local.js

@@ -17,6 +17,7 @@ function payloadMatchesScope(payload, scope) {
   return true;
 }
 const DEFAULT_POLL_INTERVAL = 1e3;
+const DEFAULT_FALLBACK_POLL_INTERVAL = 5e3;
 const DEFAULT_LOCAL_QUEUE_BASE_DIR = ".mercato/queue";
 const DEFAULT_MAX_ATTEMPTS = 3;
 const RETRY_BACKOFF_BASE_MS = 1e3;
@@ -39,8 +40,15 @@ function createLocalQueue(name, options) {
   const logger = packageLogger.child({ queue: name });
   const concurrency = options?.concurrency ?? 1;
   const pollInterval = options?.pollInterval ?? DEFAULT_POLL_INTERVAL;
+  const fallbackPollInterval = Math.max(pollInterval, DEFAULT_FALLBACK_POLL_INTERVAL);
   let pollingTimer = null;
+  let queuedPollTimer = null;
+  let queueWatcher = null;
+  let queueWatcherIdentity = null;
+  let watcherRefreshChain = Promise.resolve();
+  let hasQueuedJobs = false;
   let isProcessing = false;
+  let pollRequested = false;
   let activeHandler = null;
   const inFlightJobIds = /* @__PURE__ */ new Set();
   let fileOpChain = Promise.resolve();
@@ -265,6 +273,7 @@ function createLocalQueue(name, options) {
       const jobsRead = await readQueue();
       return { state: stateRead, jobs: jobsRead };
     });
+    hasQueuedJobs = jobs.length > 0;
     const pendingJobs = jobs.filter((job) => {
       if (!job.availableAt) return true;
       return new Date(job.availableAt).getTime() <= Date.now();
@@ -321,6 +330,7 @@ function createLocalQueue(name, options) {
           const currentJobs = await readQueue();
           const updatedJobs = currentJobs.filter((j) => !completedJobIds.has(j.id) && !deadJobIds.has(j.id)).map((j) => retryUpdates.get(j.id) ?? j);
           await writeQueue(updatedJobs);
+          hasQueuedJobs = updatedJobs.length > 0;
           const newState = {
             lastProcessedId: lastJobId,
             completedCount: (state.completedCount ?? 0) + processed,
@@ -336,28 +346,106 @@ function createLocalQueue(name, options) {
       }
     }
   }
-  async function pollAndProcess() {
-    if (isProcessing || !activeHandler) return;
+  async function pollAndProcess(rethrow = false) {
+    if (!activeHandler) return;
+    if (isProcessing) {
+      pollRequested = true;
+      return;
+    }
     isProcessing = true;
     try {
-      await processBatch(activeHandler);
+      do {
+        pollRequested = false;
+        const handler = activeHandler;
+        if (!handler) break;
+        await processBatch(handler);
+      } while (pollRequested);
     } catch (error) {
+      if (rethrow) throw error;
       logger.error("Polling error", { err: error });
     } finally {
       isProcessing = false;
+      scheduleQueuedPoll();
+    }
+  }
+  function scheduleQueuedPoll() {
+    if (!activeHandler || !hasQueuedJobs) {
+      if (queuedPollTimer) {
+        clearTimeout(queuedPollTimer);
+        queuedPollTimer = null;
+      }
+      return;
+    }
+    if (queuedPollTimer) return;
+    queuedPollTimer = setTimeout(() => {
+      queuedPollTimer = null;
+      void pollAndProcess();
+    }, pollInterval);
+  }
+  function closeQueueWatcher() {
+    if (queueWatcher) {
+      queueWatcher.close();
+      queueWatcher = null;
     }
+    queueWatcherIdentity = null;
+  }
+  function refreshQueueWatcher() {
+    const refresh = watcherRefreshChain.then(async () => {
+      if (!activeHandler) return;
+      try {
+        await ensureDir();
+        const stats = await fsp.stat(queueFile);
+        const nextIdentity = { device: stats.dev, inode: stats.ino };
+        if (queueWatcher && queueWatcherIdentity?.device === nextIdentity.device && queueWatcherIdentity.inode === nextIdentity.inode) {
+          return;
+        }
+        closeQueueWatcher();
+        const watcher = fs.watch(queueFile, (eventType) => {
+          if (eventType === "rename") {
+            queueWatcherIdentity = null;
+            void refreshQueueWatcher();
+          }
+          void pollAndProcess();
+        });
+        watcher.on("error", (err) => {
+          logger.error("Queue watch error; fallback polling remains active", { err });
+          if (queueWatcher === watcher) {
+            closeQueueWatcher();
+          }
+        });
+        if (!activeHandler) {
+          watcher.close();
+          return;
+        }
+        queueWatcher = watcher;
+        queueWatcherIdentity = nextIdentity;
+      } catch (err) {
+        logger.error("Failed to watch queue file; fallback polling remains active", { err });
+      }
+    });
+    watcherRefreshChain = refresh.catch(() => void 0);
+    return refresh;
   }
   async function process(handler, options2) {
     if (options2?.limit) {
       return processBatch(handler, options2);
     }
+    if (activeHandler) {
+      await close();
+    }
     activeHandler = handler;
-    await processBatch(handler);
+    try {
+      await refreshQueueWatcher();
+      await pollAndProcess(true);
+    } catch (error) {
+      await close();
+      throw error;
+    }
     pollingTimer = setInterval(() => {
-      pollAndProcess().catch((err) => {
+      refreshQueueWatcher().then(() => pollAndProcess()).catch((err) => {
         logger.error("Poll cycle error", { err });
       });
-    }, pollInterval);
+    }, fallbackPollInterval);
     logger.info("Worker started", { concurrency });
     return { processed: -1, failed: -1, lastJobId: void 0 };
   }
@@ -366,6 +454,8 @@ function createLocalQueue(name, options) {
       const jobs = await readQueue();
       const removed = jobs.length;
       await writeQueue([]);
+      hasQueuedJobs = false;
+      scheduleQueuedPoll();
       const state = await readState();
       await writeState({
         completedCount: state.completedCount,
@@ -382,15 +472,22 @@ function createLocalQueue(name, options) {
       if (removed > 0) {
         await writeQueue(retainedJobs);
       }
+      hasQueuedJobs = retainedJobs.length > 0;
+      scheduleQueuedPoll();
       return { removed };
     });
   }
   async function close() {
+    activeHandler = null;
+    if (queuedPollTimer) {
+      clearTimeout(queuedPollTimer);
+      queuedPollTimer = null;
+    }
+    closeQueueWatcher();
     if (pollingTimer) {
       clearInterval(pollingTimer);
       pollingTimer = null;
     }
-    activeHandler = null;
     const SHUTDOWN_TIMEOUT = 5e3;
     const startTime = Date.now();
     while (isProcessing) {

package/dist/strategies/local.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/strategies/local.ts"],
-  "sourcesContent": ["import fs from 'node:fs'\nimport path from 'node:path'\nimport crypto from 'node:crypto'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport type { Queue, QueuedJob, JobHandler, LocalQueueOptions, ProcessOptions, ProcessResult, EnqueueOptions, QueueJobScope } from '../types'\nimport { attachTraceMetadata, runJobInTrace } from '../tracing'\n\nconst packageLogger = createLogger('queue')\n\ntype LocalState = {\n  lastProcessedId?: string\n  completedCount?: number\n  failedCount?: number\n}\n\ntype StoredJob<T> = QueuedJob<T> & {\n  availableAt?: string\n  attemptCount?: number\n}\n\nfunction payloadMatchesScope(payload: unknown, scope: QueueJobScope): boolean {\n  if (!payload || typeof payload !== 'object') return false\n  const scopedPayload = payload as { tenantId?: unknown; organizationId?: unknown; jobType?: unknown }\n  if (scopedPayload.tenantId !== scope.tenantId) return false\n  if (scope.organizationId !== undefined) {\n    if ((scopedPayload.organizationId ?? null) !== scope.organizationId) return false\n  }\n  if (scope.jobTypes?.length) {\n    return typeof scopedPayload.jobType === 'string' && scope.jobTypes.includes(scopedPayload.jobType)\n  }\n  return true\n}\n\n/** Default polling interval in milliseconds */\nconst DEFAULT_POLL_INTERVAL = 1000\nconst DEFAULT_LOCAL_QUEUE_BASE_DIR = '.mercato/queue'\nconst DEFAULT_MAX_ATTEMPTS = 3\nconst RETRY_BACKOFF_BASE_MS = 1000\n\n/**\n * Cross-process lock tuning. A held lock only ever spans local file I/O \u2014 job\n * handlers run outside it \u2014 so realistic hold times are milliseconds and the\n * stale threshold sits orders of magnitude above them. It exists solely so a\n * process that dies mid-segment cannot wedge the queue forever. A holder that\n * was merely suspended rather than dead can still be reclaimed, which is why\n * every acquisition carries an owner token and releases only its own lock.\n */\nconst LOCK_STALE_MS = 15_000\nconst LOCK_ACQUIRE_TIMEOUT_MS = 30_000\nconst LOCK_RETRY_MIN_MS = 2\nconst LOCK_RETRY_MAX_MS = 20\nconst RENAME_MAX_RETRIES = 5\nconst RENAME_RETRY_BASE_MS = 10\n\nconst fsp = fs.promises\n\n/**\n * Creates a file-based local queue.\n *\n * Jobs are stored in JSON files within a directory structure:\n * - `.mercato/queue/<name>/queue.json` - Array of queued jobs\n * - `.mercato/queue/<name>/state.json` - Processing state (last processed ID)\n *\n * **Limitations:**\n * - Jobs are processed sequentially (concurrency option is for logging/compatibility only)\n * - Not suitable for production: there is no dead-letter store, no throughput\n *   beyond one job at a time, and every operation rewrites the whole queue file\n *\n * Multiple processes MAY share a queue directory, which is the default\n * development topology: the dev worker runs in its own process alongside the\n * Next.js server. What that buys you, and what it does not:\n *\n * - **Safe** \u2014 concurrent producers. Every read-modify-write segment takes the\n *   `queue.lock` directory lock and every persist swaps the file in with an\n *   atomic rename, so the file cannot be torn, no enqueue is lost to a\n *   concurrent one, and a reader always observes one complete document.\n *   Writers contend, though, so throughput degrades as processes are added.\n * - **NOT safe** \u2014 concurrent consumers. `process()` deliberately runs job\n *   handlers outside the lock, so two worker processes polling the same queue\n *   would both claim the same pending jobs and execute them twice. There is no\n *   per-job lease. Run exactly one worker process per queue; use the `async`\n *   strategy when you need more than one.\n *\n * Failed jobs are retried up to `DEFAULT_MAX_ATTEMPTS` times with exponential backoff.\n * **This strategy keeps no failed-job store**: once attempts are exhausted the job is\n * removed from `queue.json` and only counted in `state.failedCount`, so the payload is\n * lost and the failure survives solely as an error log line. The `async` strategy keeps\n * only a bounded inspection window: `removeOnFail: 1000` retains the most recent 1000\n * failures and removes older ones as later failures arrive. Workflows that require\n * no-loss persistence must write their own durable record before enqueueing, regardless\n * of strategy.\n *\n * `DEFAULT_MAX_ATTEMPTS` is a module constant, not a per-job option \u2014 callers cannot\n * request a different attempt count. (`async` likewise hard-codes `attempts: 3`.)\n * See the retry handling in `process()` below.\n *\n * All file I/O is asynchronous (`fs.promises.*`) so queue operations do not\n * block the Node.js event loop. A per-queue promise chain serializes\n * read-modify-write sequences within one instance, and the `queue.lock`\n * directory lock extends that serialization across instances and processes.\n *\n * @template T - The payload type for jobs\n * @param name - Queue name (used for directory naming)\n * @param options - Local queue options\n */\nexport function createLocalQueue<T = unknown>(\n  name: string,\n  options?: LocalQueueOptions\n): Queue<T> {\n  const nodeProcess = (globalThis as typeof globalThis & { process?: NodeJS.Process }).process\n  const queueBaseDirFromEnv = nodeProcess?.env?.QUEUE_BASE_DIR\n  const baseDir = options?.baseDir\n    ?? path.resolve(queueBaseDirFromEnv || DEFAULT_LOCAL_QUEUE_BASE_DIR)\n  const queueDir = path.join(baseDir, name)\n  const queueFile = path.join(queueDir, 'queue.json')\n  const stateFile = path.join(queueDir, 'state.json')\n  const lockDir = path.join(queueDir, 'queue.lock')\n  const lockOwnerFile = path.join(lockDir, 'owner')\n  const logger = packageLogger.child({ queue: name })\n  // Note: concurrency is stored for logging/compatibility but jobs are processed sequentially\n  const concurrency = options?.concurrency ?? 1\n  const pollInterval = options?.pollInterval ?? DEFAULT_POLL_INTERVAL\n\n  // Worker state for continuous polling\n  let pollingTimer: ReturnType<typeof setInterval> | null = null\n  let isProcessing = false\n  let activeHandler: JobHandler<T> | null = null\n  const inFlightJobIds = new Set<string>()\n\n  // Per-queue mutex. Serializes read-modify-write segments so async fs calls\n  // cannot interleave and clobber each other's writes. It only covers this\n  // instance, so it also guarantees at most one outstanding `queue.lock`\n  // acquisition per instance \u2014 the directory lock below is not reentrant.\n  let fileOpChain: Promise<unknown> = Promise.resolve()\n  function withFileLock<R>(fn: () => Promise<R>): Promise<R> {\n    const run = fileOpChain.then(\n      () => runExclusively(fn),\n      () => runExclusively(fn),\n    )\n    fileOpChain = run.then(\n      () => undefined,\n      () => undefined,\n    )\n    return run\n  }\n\n  /**\n   * Runs `fn` while holding the cross-process `queue.lock`, so read-modify-write\n   * segments issued by other queue instances \u2014 in this process or another one \u2014\n   * cannot interleave with it.\n   */\n  async function runExclusively<R>(fn: () => Promise<R>): Promise<R> {\n    await ensureDir()\n    const release = await acquireDirectoryLock()\n    try {\n      return await fn()\n    } finally {\n      await release()\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // File Operations\n  // -------------------------------------------------------------------------\n\n  function sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => { setTimeout(resolve, ms) })\n  }\n\n  async function lockHeldForMs(): Promise<number | null> {\n    try {\n      const stats = await fsp.stat(lockDir)\n      return Date.now() - stats.mtimeMs\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Reclaims a lock whose holder died. The rename is the serialization point:\n   * only one racer can move `queue.lock` aside, so two processes cannot both\n   * decide a stale lock is theirs to clear and then both create a fresh one.\n   */\n  async function reclaimStaleLock(heldForMs: number): Promise<void> {\n    const reclaimedPath = `${lockDir}.stale.${crypto.randomUUID()}`\n    try {\n      await fsp.rename(lockDir, reclaimedPath)\n    } catch {\n      return\n    }\n    logger.warn('Reclaimed a stale queue lock', { lockDir, heldForMs })\n    await fsp.rm(reclaimedPath, { recursive: true, force: true }).catch(() => {})\n  }\n\n  async function readLockOwner(): Promise<string | null> {\n    try {\n      return await fsp.readFile(lockOwnerFile, 'utf8')\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Releases the lock only when this acquisition still owns it. A holder that\n   * was suspended past `LOCK_STALE_MS` has had its lock reclaimed *and\n   * replaced* by whoever reclaimed it, so an unconditional removal here would\n   * delete the successor's lock and let a third caller into the critical\n   * section alongside it. A missing or mismatched token means someone else owns\n   * the path now, and the correct action is to leave it alone.\n   */\n  async function releaseDirectoryLock(token: string): Promise<void> {\n    if (await readLockOwner() !== token) return\n    await fsp.rm(lockDir, { recursive: true, force: true }).catch(() => {})\n  }\n\n  /**\n   * Acquires the cross-process advisory lock for this queue directory.\n   * `mkdir` without `recursive` is an atomic exclusive create on every platform\n   * Node.js supports, which makes it the portable primitive here \u2014 no runtime\n   * dependency, and no reliance on advisory `flock` semantics. The owner token\n   * written into the directory is what lets the release distinguish this\n   * acquisition from a successor's.\n   */\n  async function acquireDirectoryLock(): Promise<() => Promise<void>> {\n    const deadline = Date.now() + LOCK_ACQUIRE_TIMEOUT_MS\n\n    for (;;) {\n      let acquired = false\n      try {\n        await fsp.mkdir(lockDir)\n        acquired = true\n      } catch (e: unknown) {\n        const error = e as NodeJS.ErrnoException\n        if (error.code !== 'EEXIST') throw error\n      }\n\n      if (acquired) {\n        const token = crypto.randomUUID()\n        try {\n          await fsp.writeFile(lockOwnerFile, token, 'utf8')\n        } catch (error: unknown) {\n          await fsp.rm(lockDir, { recursive: true, force: true }).catch(() => {})\n          throw error\n        }\n        return () => releaseDirectoryLock(token)\n      }\n\n      const heldForMs = await lockHeldForMs()\n      if (heldForMs !== null && heldForMs > LOCK_STALE_MS) {\n        await reclaimStaleLock(heldForMs)\n        continue\n      }\n\n      if (Date.now() >= deadline) {\n        throw new Error(\n          `[internal] Timed out after ${LOCK_ACQUIRE_TIMEOUT_MS}ms waiting for the queue lock at ${lockDir}`,\n        )\n      }\n\n      const jitter = LOCK_RETRY_MIN_MS + Math.random() * (LOCK_RETRY_MAX_MS - LOCK_RETRY_MIN_MS)\n      await sleep(jitter)\n    }\n  }\n\n  /**\n   * Persists `content` by writing a unique sibling temp file and renaming it\n   * onto `targetFile`. `rename` within a directory is atomic, so a concurrent\n   * reader sees either the previous document or the new one in full \u2014 never the\n   * torn result of a truncate-then-write.\n   */\n  async function writeFileAtomic(targetFile: string, content: string): Promise<void> {\n    const tempFile = `${targetFile}.${crypto.randomUUID()}.tmp`\n    try {\n      await fsp.writeFile(tempFile, content, 'utf8')\n      await renameWithContentionRetry(tempFile, targetFile)\n    } catch (error: unknown) {\n      await fsp.rm(tempFile, { force: true }).catch(() => {})\n      throw error\n    }\n  }\n\n  /**\n   * Windows rejects a rename onto a file another process currently has open,\n   * so retry briefly on the contention codes it raises. POSIX renames replace\n   * the target unconditionally and take the first attempt.\n   */\n  async function renameWithContentionRetry(fromFile: string, toFile: string): Promise<void> {\n    const contentionCodes = new Set(['EPERM', 'EBUSY', 'EACCES'])\n    for (let attempt = 0; ; attempt++) {\n      try {\n        await fsp.rename(fromFile, toFile)\n        return\n      } catch (e: unknown) {\n        const error = e as NodeJS.ErrnoException\n        if (attempt >= RENAME_MAX_RETRIES || !error.code || !contentionCodes.has(error.code)) throw error\n        await sleep(RENAME_RETRY_BASE_MS * (attempt + 1))\n      }\n    }\n  }\n\n  async function ensureDir(): Promise<void> {\n    try {\n      await fsp.mkdir(queueDir, { recursive: true })\n    } catch (e: unknown) {\n      const error = e as NodeJS.ErrnoException\n      if (error.code !== 'EEXIST') throw error\n    }\n\n    // Initialize queue file with exclusive create flag\n    try {\n      await fsp.writeFile(queueFile, '[]', { encoding: 'utf8', flag: 'wx' })\n    } catch (e: unknown) {\n      const error = e as NodeJS.ErrnoException\n      if (error.code !== 'EEXIST') throw error\n    }\n\n    // Initialize state file with exclusive create flag\n    try {\n      await fsp.writeFile(stateFile, '{}', { encoding: 'utf8', flag: 'wx' })\n    } catch (e: unknown) {\n      const error = e as NodeJS.ErrnoException\n      if (error.code !== 'EEXIST') throw error\n    }\n  }\n\n  /**\n   * Moves an unparsable queue file aside so its jobs stay recoverable. The\n   * caller is expected to surface the failure rather than continue on an empty\n   * queue: silently recreating `queue.json` here is what turned an unreadable\n   * file into permanent, unreported job loss.\n   */\n  async function quarantineCorruptedQueueFile(): Promise<string | null> {\n    const backupFile = path.join(queueDir, `queue.corrupted.${Date.now()}.${crypto.randomUUID()}.json`)\n    try {\n      await fsp.rename(queueFile, backupFile)\n      return backupFile\n    } catch (e: unknown) {\n      logger.error('Failed to quarantine the corrupted queue file', { err: e as Error })\n      return null\n    }\n  }\n\n  async function readQueue(): Promise<StoredJob<T>[]> {\n    await ensureDir()\n    let content: string\n\n    try {\n      content = await fsp.readFile(queueFile, 'utf8')\n    } catch (error: unknown) {\n      const readError = error as NodeJS.ErrnoException\n      if (readError.code === 'ENOENT') {\n        return []\n      }\n      logger.error('Failed to read queue file', { err: readError })\n      throw new Error(`Queue file unreadable: ${readError.message}`)\n    }\n\n    try {\n      const parsed = JSON.parse(content) as unknown\n\n      if (!Array.isArray(parsed)) {\n        throw new Error('Queue file must contain a JSON array')\n      }\n\n      return parsed as StoredJob<T>[]\n    } catch (error: unknown) {\n      const parseError = error as Error\n      logger.error('Failed to parse queue file', { err: parseError })\n      const backupFile = await quarantineCorruptedQueueFile()\n      if (backupFile) {\n        logger.error('Quarantined corrupted queue file; its jobs are recoverable from the backup', { backupFile })\n      }\n      const recoveryHint = backupFile\n        ? `has been quarantined as ${backupFile}`\n        : 'could not be quarantined and was left in place'\n      throw new Error(\n        `[internal] Queue file ${queueFile} was unparsable and ${recoveryHint}: ${parseError.message}`,\n      )\n    }\n  }\n\n  async function writeQueue(jobs: StoredJob<T>[]): Promise<void> {\n    await ensureDir()\n    await writeFileAtomic(queueFile, JSON.stringify(jobs, null, 2))\n  }\n\n  async function readState(): Promise<LocalState> {\n    await ensureDir()\n    try {\n      const content = await fsp.readFile(stateFile, 'utf8')\n      return JSON.parse(content) as LocalState\n    } catch {\n      return {}\n    }\n  }\n\n  async function writeState(state: LocalState): Promise<void> {\n    await ensureDir()\n    await writeFileAtomic(stateFile, JSON.stringify(state, null, 2))\n  }\n\n  function generateId(): string {\n    return crypto.randomUUID()\n  }\n\n  // -------------------------------------------------------------------------\n  // Queue Implementation\n  // -------------------------------------------------------------------------\n\n  async function enqueue(data: T, options?: EnqueueOptions): Promise<string> {\n    const availableAt = options?.delayMs && options.delayMs > 0\n      ? new Date(Date.now() + options.delayMs).toISOString()\n      : undefined\n    const metadata = attachTraceMetadata(undefined)\n    const job: StoredJob<T> = {\n      id: generateId(),\n      payload: data,\n      createdAt: new Date().toISOString(),\n      ...(availableAt ? { availableAt } : {}),\n      ...(metadata ? { metadata } : {}),\n    }\n    await withFileLock(async () => {\n      const jobs = await readQueue()\n      jobs.push(job)\n      await writeQueue(jobs)\n    })\n    return job.id\n  }\n\n  /**\n   * Process pending jobs in a single batch (internal helper).\n   */\n  async function processBatch(\n    handler: JobHandler<T>,\n    options?: ProcessOptions\n  ): Promise<ProcessResult> {\n    const { state, jobs } = await withFileLock(async () => {\n      const stateRead = await readState()\n      const jobsRead = await readQueue()\n      return { state: stateRead, jobs: jobsRead }\n    })\n\n    const pendingJobs = jobs.filter((job) => {\n      if (!job.availableAt) return true\n      return new Date(job.availableAt).getTime() <= Date.now()\n    })\n    const jobsToProcess = options?.limit\n      ? pendingJobs.slice(0, options.limit)\n      : pendingJobs\n\n    for (const job of jobsToProcess) {\n      inFlightJobIds.add(job.id)\n    }\n\n    let processed = 0\n    let failed = 0\n    let lastJobId: string | undefined\n    const completedJobIds = new Set<string>()\n    const deadJobIds = new Set<string>()\n    const retryUpdates = new Map<string, StoredJob<T>>()\n\n    try {\n      for (const job of jobsToProcess) {\n        const attemptNumber = (job.attemptCount ?? 0) + 1\n        try {\n          await runJobInTrace(name, job.metadata, () =>\n            Promise.resolve(\n              handler(job, {\n                jobId: job.id,\n                attemptNumber,\n                queueName: name,\n              })\n            )\n          )\n          processed++\n          lastJobId = job.id\n          completedJobIds.add(job.id)\n          logger.info('Job completed', { jobId: job.id })\n        } catch (error) {\n          logger.error('Job failed', { jobId: job.id, attemptNumber, maxAttempts: DEFAULT_MAX_ATTEMPTS, err: error })\n          failed++\n          lastJobId = job.id\n          if (attemptNumber >= DEFAULT_MAX_ATTEMPTS) {\n            logger.error('Job exhausted all attempts; dropping it (no dead-letter store)', { jobId: job.id, maxAttempts: DEFAULT_MAX_ATTEMPTS })\n            deadJobIds.add(job.id)\n          } else {\n            const backoffMs = RETRY_BACKOFF_BASE_MS * Math.pow(2, attemptNumber - 1)\n            retryUpdates.set(job.id, {\n              ...job,\n              attemptCount: attemptNumber,\n              availableAt: new Date(Date.now() + backoffMs).toISOString(),\n            })\n          }\n        }\n      }\n\n      const hasChanges = completedJobIds.size > 0 || deadJobIds.size > 0 || retryUpdates.size > 0\n      if (hasChanges) {\n        await withFileLock(async () => {\n          // Re-read so jobs enqueued during handler execution are preserved.\n          const currentJobs = await readQueue()\n          const updatedJobs = currentJobs\n            .filter((j) => !completedJobIds.has(j.id) && !deadJobIds.has(j.id))\n            .map((j) => retryUpdates.get(j.id) ?? j)\n          await writeQueue(updatedJobs)\n\n          const newState: LocalState = {\n            lastProcessedId: lastJobId,\n            completedCount: (state.completedCount ?? 0) + processed,\n            failedCount: (state.failedCount ?? 0) + deadJobIds.size,\n          }\n          await writeState(newState)\n        })\n      }\n\n      return { processed, failed, lastJobId }\n    } finally {\n      for (const job of jobsToProcess) {\n        inFlightJobIds.delete(job.id)\n      }\n    }\n  }\n\n  /**\n   * Poll for and process new jobs.\n   */\n  async function pollAndProcess(): Promise<void> {\n    // Skip if already processing to avoid concurrent file access\n    if (isProcessing || !activeHandler) return\n\n    isProcessing = true\n    try {\n      await processBatch(activeHandler)\n    } catch (error) {\n      logger.error('Polling error', { err: error })\n    } finally {\n      isProcessing = false\n    }\n  }\n\n  async function process(\n    handler: JobHandler<T>,\n    options?: ProcessOptions\n  ): Promise<ProcessResult> {\n    // If limit is specified, do a single batch (backward compatibility)\n    if (options?.limit) {\n      return processBatch(handler, options)\n    }\n\n    // Start continuous polling mode (like BullMQ Worker)\n    activeHandler = handler\n\n    // Process any pending jobs immediately\n    await processBatch(handler)\n\n    // Start polling interval for new jobs\n    pollingTimer = setInterval(() => {\n      pollAndProcess().catch((err) => {\n        logger.error('Poll cycle error', { err })\n      })\n    }, pollInterval)\n\n    logger.info('Worker started', { concurrency })\n\n    // Return sentinel value indicating continuous worker mode (like async strategy)\n    return { processed: -1, failed: -1, lastJobId: undefined }\n  }\n\n  async function clear(): Promise<{ removed: number }> {\n    return withFileLock(async () => {\n      const jobs = await readQueue()\n      const removed = jobs.length\n      await writeQueue([])\n      // Reset state but preserve counts for historical tracking\n      const state = await readState()\n      await writeState({\n        completedCount: state.completedCount,\n        failedCount: state.failedCount,\n      })\n      return { removed }\n    })\n  }\n\n  async function removeQueuedJobsByScope(scope: QueueJobScope): Promise<{ removed: number }> {\n    return withFileLock(async () => {\n      const jobs = await readQueue()\n      const retainedJobs = jobs.filter((job) => inFlightJobIds.has(job.id) || !payloadMatchesScope(job.payload, scope))\n      const removed = jobs.length - retainedJobs.length\n      if (removed > 0) {\n        await writeQueue(retainedJobs)\n      }\n      return { removed }\n    })\n  }\n\n  async function close(): Promise<void> {\n    // Stop polling timer\n    if (pollingTimer) {\n      clearInterval(pollingTimer)\n      pollingTimer = null\n    }\n    activeHandler = null\n\n    // Wait for any in-progress processing to complete (with timeout)\n    const SHUTDOWN_TIMEOUT = 5000\n    const startTime = Date.now()\n\n    while (isProcessing) {\n      if (Date.now() - startTime > SHUTDOWN_TIMEOUT) {\n        logger.warn('Force closing after shutdown timeout', { timeoutMs: SHUTDOWN_TIMEOUT })\n        break\n      }\n      await new Promise((resolve) => setTimeout(resolve, 50))\n    }\n  }\n\n  async function getJobCounts(): Promise<{\n    waiting: number\n    active: number\n    completed: number\n    failed: number\n  }> {\n    return withFileLock(async () => {\n      const state = await readState()\n      const jobs = await readQueue()\n\n      return {\n        waiting: jobs.length, // All jobs in queue are waiting (processed ones are removed)\n        active: 0, // Local strategy doesn't track active jobs\n        completed: state.completedCount ?? 0,\n        failed: state.failedCount ?? 0,\n      }\n    })\n  }\n\n  return {\n    name,\n    strategy: 'local',\n    enqueue,\n    process,\n    clear,\n    removeQueuedJobsByScope,\n    close,\n    getJobCounts,\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import fs from 'node:fs'\nimport path from 'node:path'\nimport crypto from 'node:crypto'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport type { Queue, QueuedJob, JobHandler, LocalQueueOptions, ProcessOptions, ProcessResult, EnqueueOptions, QueueJobScope } from '../types'\nimport { attachTraceMetadata, runJobInTrace } from '../tracing'\n\nconst packageLogger = createLogger('queue')\n\ntype LocalState = {\n  lastProcessedId?: string\n  completedCount?: number\n  failedCount?: number\n}\n\ntype StoredJob<T> = QueuedJob<T> & {\n  availableAt?: string\n  attemptCount?: number\n}\n\ntype QueueFileIdentity = {\n  device: number\n  inode: number\n}\n\nfunction payloadMatchesScope(payload: unknown, scope: QueueJobScope): boolean {\n  if (!payload || typeof payload !== 'object') return false\n  const scopedPayload = payload as { tenantId?: unknown; organizationId?: unknown; jobType?: unknown }\n  if (scopedPayload.tenantId !== scope.tenantId) return false\n  if (scope.organizationId !== undefined) {\n    if ((scopedPayload.organizationId ?? null) !== scope.organizationId) return false\n  }\n  if (scope.jobTypes?.length) {\n    return typeof scopedPayload.jobType === 'string' && scope.jobTypes.includes(scopedPayload.jobType)\n  }\n  return true\n}\n\n/** Polling interval while delayed or retrying work remains queued. */\nconst DEFAULT_POLL_INTERVAL = 1000\n/** Idle safety interval for missed filesystem watcher events. */\nconst DEFAULT_FALLBACK_POLL_INTERVAL = 5000\nconst DEFAULT_LOCAL_QUEUE_BASE_DIR = '.mercato/queue'\nconst DEFAULT_MAX_ATTEMPTS = 3\nconst RETRY_BACKOFF_BASE_MS = 1000\n\n/**\n * Cross-process lock tuning. A held lock only ever spans local file I/O \u2014 job\n * handlers run outside it \u2014 so realistic hold times are milliseconds and the\n * stale threshold sits orders of magnitude above them. It exists solely so a\n * process that dies mid-segment cannot wedge the queue forever. A holder that\n * was merely suspended rather than dead can still be reclaimed, which is why\n * every acquisition carries an owner token and releases only its own lock.\n */\nconst LOCK_STALE_MS = 15_000\nconst LOCK_ACQUIRE_TIMEOUT_MS = 30_000\nconst LOCK_RETRY_MIN_MS = 2\nconst LOCK_RETRY_MAX_MS = 20\nconst RENAME_MAX_RETRIES = 5\nconst RENAME_RETRY_BASE_MS = 10\n\nconst fsp = fs.promises\n\n/**\n * Creates a file-based local queue.\n *\n * Jobs are stored in JSON files within a directory structure:\n * - `.mercato/queue/<name>/queue.json` - Array of queued jobs\n * - `.mercato/queue/<name>/state.json` - Processing state (last processed ID)\n *\n * **Limitations:**\n * - Jobs are processed sequentially (concurrency option is for logging/compatibility only)\n * - Not suitable for production: there is no dead-letter store, no throughput\n *   beyond one job at a time, and every operation rewrites the whole queue file\n *\n * Multiple processes MAY share a queue directory, which is the default\n * development topology: the dev worker runs in its own process alongside the\n * Next.js server. What that buys you, and what it does not:\n *\n * - **Safe** \u2014 concurrent producers. Every read-modify-write segment takes the\n *   `queue.lock` directory lock and every persist swaps the file in with an\n *   atomic rename, so the file cannot be torn, no enqueue is lost to a\n *   concurrent one, and a reader always observes one complete document.\n *   Writers contend, though, so throughput degrades as processes are added.\n * - **NOT safe** \u2014 concurrent consumers. `process()` deliberately runs job\n *   handlers outside the lock, so two worker processes polling the same queue\n *   would both claim the same pending jobs and execute them twice. There is no\n *   per-job lease. Run exactly one worker process per queue; use the `async`\n *   strategy when you need more than one.\n *\n * Failed jobs are retried up to `DEFAULT_MAX_ATTEMPTS` times with exponential backoff.\n * **This strategy keeps no failed-job store**: once attempts are exhausted the job is\n * removed from `queue.json` and only counted in `state.failedCount`, so the payload is\n * lost and the failure survives solely as an error log line. The `async` strategy keeps\n * only a bounded inspection window: `removeOnFail: 1000` retains the most recent 1000\n * failures and removes older ones as later failures arrive. Workflows that require\n * no-loss persistence must write their own durable record before enqueueing, regardless\n * of strategy.\n *\n * `DEFAULT_MAX_ATTEMPTS` is a module constant, not a per-job option \u2014 callers cannot\n * request a different attempt count. (`async` likewise hard-codes `attempts: 3`.)\n * See the retry handling in `process()` below.\n *\n * All file I/O is asynchronous (`fs.promises.*`) so queue operations do not\n * block the Node.js event loop. A per-queue promise chain serializes\n * read-modify-write sequences within one instance, and the `queue.lock`\n * directory lock extends that serialization across instances and processes.\n *\n * @template T - The payload type for jobs\n * @param name - Queue name (used for directory naming)\n * @param options - Local queue options\n */\nexport function createLocalQueue<T = unknown>(\n  name: string,\n  options?: LocalQueueOptions\n): Queue<T> {\n  const nodeProcess = (globalThis as typeof globalThis & { process?: NodeJS.Process }).process\n  const queueBaseDirFromEnv = nodeProcess?.env?.QUEUE_BASE_DIR\n  const baseDir = options?.baseDir\n    ?? path.resolve(queueBaseDirFromEnv || DEFAULT_LOCAL_QUEUE_BASE_DIR)\n  const queueDir = path.join(baseDir, name)\n  const queueFile = path.join(queueDir, 'queue.json')\n  const stateFile = path.join(queueDir, 'state.json')\n  const lockDir = path.join(queueDir, 'queue.lock')\n  const lockOwnerFile = path.join(lockDir, 'owner')\n  const logger = packageLogger.child({ queue: name })\n  // Note: concurrency is stored for logging/compatibility but jobs are processed sequentially\n  const concurrency = options?.concurrency ?? 1\n  const pollInterval = options?.pollInterval ?? DEFAULT_POLL_INTERVAL\n  const fallbackPollInterval = Math.max(pollInterval, DEFAULT_FALLBACK_POLL_INTERVAL)\n\n  // Worker state for continuous polling\n  let pollingTimer: ReturnType<typeof setInterval> | null = null\n  let queuedPollTimer: ReturnType<typeof setTimeout> | null = null\n  let queueWatcher: fs.FSWatcher | null = null\n  let queueWatcherIdentity: QueueFileIdentity | null = null\n  let watcherRefreshChain: Promise<void> = Promise.resolve()\n  let hasQueuedJobs = false\n  let isProcessing = false\n  let pollRequested = false\n  let activeHandler: JobHandler<T> | null = null\n  const inFlightJobIds = new Set<string>()\n\n  // Per-queue mutex. Serializes read-modify-write segments so async fs calls\n  // cannot interleave and clobber each other's writes. It only covers this\n  // instance, so it also guarantees at most one outstanding `queue.lock`\n  // acquisition per instance \u2014 the directory lock below is not reentrant.\n  let fileOpChain: Promise<unknown> = Promise.resolve()\n  function withFileLock<R>(fn: () => Promise<R>): Promise<R> {\n    const run = fileOpChain.then(\n      () => runExclusively(fn),\n      () => runExclusively(fn),\n    )\n    fileOpChain = run.then(\n      () => undefined,\n      () => undefined,\n    )\n    return run\n  }\n\n  /**\n   * Runs `fn` while holding the cross-process `queue.lock`, so read-modify-write\n   * segments issued by other queue instances \u2014 in this process or another one \u2014\n   * cannot interleave with it.\n   */\n  async function runExclusively<R>(fn: () => Promise<R>): Promise<R> {\n    await ensureDir()\n    const release = await acquireDirectoryLock()\n    try {\n      return await fn()\n    } finally {\n      await release()\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // File Operations\n  // -------------------------------------------------------------------------\n\n  function sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => { setTimeout(resolve, ms) })\n  }\n\n  async function lockHeldForMs(): Promise<number | null> {\n    try {\n      const stats = await fsp.stat(lockDir)\n      return Date.now() - stats.mtimeMs\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Reclaims a lock whose holder died. The rename is the serialization point:\n   * only one racer can move `queue.lock` aside, so two processes cannot both\n   * decide a stale lock is theirs to clear and then both create a fresh one.\n   */\n  async function reclaimStaleLock(heldForMs: number): Promise<void> {\n    const reclaimedPath = `${lockDir}.stale.${crypto.randomUUID()}`\n    try {\n      await fsp.rename(lockDir, reclaimedPath)\n    } catch {\n      return\n    }\n    logger.warn('Reclaimed a stale queue lock', { lockDir, heldForMs })\n    await fsp.rm(reclaimedPath, { recursive: true, force: true }).catch(() => {})\n  }\n\n  async function readLockOwner(): Promise<string | null> {\n    try {\n      return await fsp.readFile(lockOwnerFile, 'utf8')\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Releases the lock only when this acquisition still owns it. A holder that\n   * was suspended past `LOCK_STALE_MS` has had its lock reclaimed *and\n   * replaced* by whoever reclaimed it, so an unconditional removal here would\n   * delete the successor's lock and let a third caller into the critical\n   * section alongside it. A missing or mismatched token means someone else owns\n   * the path now, and the correct action is to leave it alone.\n   */\n  async function releaseDirectoryLock(token: string): Promise<void> {\n    if (await readLockOwner() !== token) return\n    await fsp.rm(lockDir, { recursive: true, force: true }).catch(() => {})\n  }\n\n  /**\n   * Acquires the cross-process advisory lock for this queue directory.\n   * `mkdir` without `recursive` is an atomic exclusive create on every platform\n   * Node.js supports, which makes it the portable primitive here \u2014 no runtime\n   * dependency, and no reliance on advisory `flock` semantics. The owner token\n   * written into the directory is what lets the release distinguish this\n   * acquisition from a successor's.\n   */\n  async function acquireDirectoryLock(): Promise<() => Promise<void>> {\n    const deadline = Date.now() + LOCK_ACQUIRE_TIMEOUT_MS\n\n    for (;;) {\n      let acquired = false\n      try {\n        await fsp.mkdir(lockDir)\n        acquired = true\n      } catch (e: unknown) {\n        const error = e as NodeJS.ErrnoException\n        if (error.code !== 'EEXIST') throw error\n      }\n\n      if (acquired) {\n        const token = crypto.randomUUID()\n        try {\n          await fsp.writeFile(lockOwnerFile, token, 'utf8')\n        } catch (error: unknown) {\n          await fsp.rm(lockDir, { recursive: true, force: true }).catch(() => {})\n          throw error\n        }\n        return () => releaseDirectoryLock(token)\n      }\n\n      const heldForMs = await lockHeldForMs()\n      if (heldForMs !== null && heldForMs > LOCK_STALE_MS) {\n        await reclaimStaleLock(heldForMs)\n        continue\n      }\n\n      if (Date.now() >= deadline) {\n        throw new Error(\n          `[internal] Timed out after ${LOCK_ACQUIRE_TIMEOUT_MS}ms waiting for the queue lock at ${lockDir}`,\n        )\n      }\n\n      const jitter = LOCK_RETRY_MIN_MS + Math.random() * (LOCK_RETRY_MAX_MS - LOCK_RETRY_MIN_MS)\n      await sleep(jitter)\n    }\n  }\n\n  /**\n   * Persists `content` by writing a unique sibling temp file and renaming it\n   * onto `targetFile`. `rename` within a directory is atomic, so a concurrent\n   * reader sees either the previous document or the new one in full \u2014 never the\n   * torn result of a truncate-then-write.\n   */\n  async function writeFileAtomic(targetFile: string, content: string): Promise<void> {\n    const tempFile = `${targetFile}.${crypto.randomUUID()}.tmp`\n    try {\n      await fsp.writeFile(tempFile, content, 'utf8')\n      await renameWithContentionRetry(tempFile, targetFile)\n    } catch (error: unknown) {\n      await fsp.rm(tempFile, { force: true }).catch(() => {})\n      throw error\n    }\n  }\n\n  /**\n   * Windows rejects a rename onto a file another process currently has open,\n   * so retry briefly on the contention codes it raises. POSIX renames replace\n   * the target unconditionally and take the first attempt.\n   */\n  async function renameWithContentionRetry(fromFile: string, toFile: string): Promise<void> {\n    const contentionCodes = new Set(['EPERM', 'EBUSY', 'EACCES'])\n    for (let attempt = 0; ; attempt++) {\n      try {\n        await fsp.rename(fromFile, toFile)\n        return\n      } catch (e: unknown) {\n        const error = e as NodeJS.ErrnoException\n        if (attempt >= RENAME_MAX_RETRIES || !error.code || !contentionCodes.has(error.code)) throw error\n        await sleep(RENAME_RETRY_BASE_MS * (attempt + 1))\n      }\n    }\n  }\n\n  async function ensureDir(): Promise<void> {\n    try {\n      await fsp.mkdir(queueDir, { recursive: true })\n    } catch (e: unknown) {\n      const error = e as NodeJS.ErrnoException\n      if (error.code !== 'EEXIST') throw error\n    }\n\n    // Initialize queue file with exclusive create flag\n    try {\n      await fsp.writeFile(queueFile, '[]', { encoding: 'utf8', flag: 'wx' })\n    } catch (e: unknown) {\n      const error = e as NodeJS.ErrnoException\n      if (error.code !== 'EEXIST') throw error\n    }\n\n    // Initialize state file with exclusive create flag\n    try {\n      await fsp.writeFile(stateFile, '{}', { encoding: 'utf8', flag: 'wx' })\n    } catch (e: unknown) {\n      const error = e as NodeJS.ErrnoException\n      if (error.code !== 'EEXIST') throw error\n    }\n  }\n\n  /**\n   * Moves an unparsable queue file aside so its jobs stay recoverable. The\n   * caller is expected to surface the failure rather than continue on an empty\n   * queue: silently recreating `queue.json` here is what turned an unreadable\n   * file into permanent, unreported job loss.\n   */\n  async function quarantineCorruptedQueueFile(): Promise<string | null> {\n    const backupFile = path.join(queueDir, `queue.corrupted.${Date.now()}.${crypto.randomUUID()}.json`)\n    try {\n      await fsp.rename(queueFile, backupFile)\n      return backupFile\n    } catch (e: unknown) {\n      logger.error('Failed to quarantine the corrupted queue file', { err: e as Error })\n      return null\n    }\n  }\n\n  async function readQueue(): Promise<StoredJob<T>[]> {\n    await ensureDir()\n    let content: string\n\n    try {\n      content = await fsp.readFile(queueFile, 'utf8')\n    } catch (error: unknown) {\n      const readError = error as NodeJS.ErrnoException\n      if (readError.code === 'ENOENT') {\n        return []\n      }\n      logger.error('Failed to read queue file', { err: readError })\n      throw new Error(`Queue file unreadable: ${readError.message}`)\n    }\n\n    try {\n      const parsed = JSON.parse(content) as unknown\n\n      if (!Array.isArray(parsed)) {\n        throw new Error('Queue file must contain a JSON array')\n      }\n\n      return parsed as StoredJob<T>[]\n    } catch (error: unknown) {\n      const parseError = error as Error\n      logger.error('Failed to parse queue file', { err: parseError })\n      const backupFile = await quarantineCorruptedQueueFile()\n      if (backupFile) {\n        logger.error('Quarantined corrupted queue file; its jobs are recoverable from the backup', { backupFile })\n      }\n      const recoveryHint = backupFile\n        ? `has been quarantined as ${backupFile}`\n        : 'could not be quarantined and was left in place'\n      throw new Error(\n        `[internal] Queue file ${queueFile} was unparsable and ${recoveryHint}: ${parseError.message}`,\n      )\n    }\n  }\n\n  async function writeQueue(jobs: StoredJob<T>[]): Promise<void> {\n    await ensureDir()\n    await writeFileAtomic(queueFile, JSON.stringify(jobs, null, 2))\n  }\n\n  async function readState(): Promise<LocalState> {\n    await ensureDir()\n    try {\n      const content = await fsp.readFile(stateFile, 'utf8')\n      return JSON.parse(content) as LocalState\n    } catch {\n      return {}\n    }\n  }\n\n  async function writeState(state: LocalState): Promise<void> {\n    await ensureDir()\n    await writeFileAtomic(stateFile, JSON.stringify(state, null, 2))\n  }\n\n  function generateId(): string {\n    return crypto.randomUUID()\n  }\n\n  // -------------------------------------------------------------------------\n  // Queue Implementation\n  // -------------------------------------------------------------------------\n\n  async function enqueue(data: T, options?: EnqueueOptions): Promise<string> {\n    const availableAt = options?.delayMs && options.delayMs > 0\n      ? new Date(Date.now() + options.delayMs).toISOString()\n      : undefined\n    const metadata = attachTraceMetadata(undefined)\n    const job: StoredJob<T> = {\n      id: generateId(),\n      payload: data,\n      createdAt: new Date().toISOString(),\n      ...(availableAt ? { availableAt } : {}),\n      ...(metadata ? { metadata } : {}),\n    }\n    await withFileLock(async () => {\n      const jobs = await readQueue()\n      jobs.push(job)\n      await writeQueue(jobs)\n    })\n    return job.id\n  }\n\n  /**\n   * Process pending jobs in a single batch (internal helper).\n   */\n  async function processBatch(\n    handler: JobHandler<T>,\n    options?: ProcessOptions\n  ): Promise<ProcessResult> {\n    const { state, jobs } = await withFileLock(async () => {\n      const stateRead = await readState()\n      const jobsRead = await readQueue()\n      return { state: stateRead, jobs: jobsRead }\n    })\n    hasQueuedJobs = jobs.length > 0\n\n    const pendingJobs = jobs.filter((job) => {\n      if (!job.availableAt) return true\n      return new Date(job.availableAt).getTime() <= Date.now()\n    })\n    const jobsToProcess = options?.limit\n      ? pendingJobs.slice(0, options.limit)\n      : pendingJobs\n\n    for (const job of jobsToProcess) {\n      inFlightJobIds.add(job.id)\n    }\n\n    let processed = 0\n    let failed = 0\n    let lastJobId: string | undefined\n    const completedJobIds = new Set<string>()\n    const deadJobIds = new Set<string>()\n    const retryUpdates = new Map<string, StoredJob<T>>()\n\n    try {\n      for (const job of jobsToProcess) {\n        const attemptNumber = (job.attemptCount ?? 0) + 1\n        try {\n          await runJobInTrace(name, job.metadata, () =>\n            Promise.resolve(\n              handler(job, {\n                jobId: job.id,\n                attemptNumber,\n                queueName: name,\n              })\n            )\n          )\n          processed++\n          lastJobId = job.id\n          completedJobIds.add(job.id)\n          logger.info('Job completed', { jobId: job.id })\n        } catch (error) {\n          logger.error('Job failed', { jobId: job.id, attemptNumber, maxAttempts: DEFAULT_MAX_ATTEMPTS, err: error })\n          failed++\n          lastJobId = job.id\n          if (attemptNumber >= DEFAULT_MAX_ATTEMPTS) {\n            logger.error('Job exhausted all attempts; dropping it (no dead-letter store)', { jobId: job.id, maxAttempts: DEFAULT_MAX_ATTEMPTS })\n            deadJobIds.add(job.id)\n          } else {\n            const backoffMs = RETRY_BACKOFF_BASE_MS * Math.pow(2, attemptNumber - 1)\n            retryUpdates.set(job.id, {\n              ...job,\n              attemptCount: attemptNumber,\n              availableAt: new Date(Date.now() + backoffMs).toISOString(),\n            })\n          }\n        }\n      }\n\n      const hasChanges = completedJobIds.size > 0 || deadJobIds.size > 0 || retryUpdates.size > 0\n      if (hasChanges) {\n        await withFileLock(async () => {\n          // Re-read so jobs enqueued during handler execution are preserved.\n          const currentJobs = await readQueue()\n          const updatedJobs = currentJobs\n            .filter((j) => !completedJobIds.has(j.id) && !deadJobIds.has(j.id))\n            .map((j) => retryUpdates.get(j.id) ?? j)\n          await writeQueue(updatedJobs)\n          hasQueuedJobs = updatedJobs.length > 0\n\n          const newState: LocalState = {\n            lastProcessedId: lastJobId,\n            completedCount: (state.completedCount ?? 0) + processed,\n            failedCount: (state.failedCount ?? 0) + deadJobIds.size,\n          }\n          await writeState(newState)\n        })\n      }\n\n      return { processed, failed, lastJobId }\n    } finally {\n      for (const job of jobsToProcess) {\n        inFlightJobIds.delete(job.id)\n      }\n    }\n  }\n\n  /**\n   * Poll for and process new jobs.\n   */\n  async function pollAndProcess(rethrow = false): Promise<void> {\n    if (!activeHandler) return\n    if (isProcessing) {\n      pollRequested = true\n      return\n    }\n\n    isProcessing = true\n    try {\n      do {\n        pollRequested = false\n        const handler = activeHandler\n        if (!handler) break\n        await processBatch(handler)\n      } while (pollRequested)\n    } catch (error) {\n      if (rethrow) throw error\n      logger.error('Polling error', { err: error })\n    } finally {\n      isProcessing = false\n      scheduleQueuedPoll()\n    }\n  }\n\n  function scheduleQueuedPoll(): void {\n    if (!activeHandler || !hasQueuedJobs) {\n      if (queuedPollTimer) {\n        clearTimeout(queuedPollTimer)\n        queuedPollTimer = null\n      }\n      return\n    }\n    if (queuedPollTimer) return\n    queuedPollTimer = setTimeout(() => {\n      queuedPollTimer = null\n      void pollAndProcess()\n    }, pollInterval)\n  }\n\n  function closeQueueWatcher(): void {\n    if (queueWatcher) {\n      queueWatcher.close()\n      queueWatcher = null\n    }\n    queueWatcherIdentity = null\n  }\n\n  function refreshQueueWatcher(): Promise<void> {\n    const refresh = watcherRefreshChain.then(async () => {\n      if (!activeHandler) return\n      try {\n        await ensureDir()\n        const stats = await fsp.stat(queueFile)\n        const nextIdentity = { device: stats.dev, inode: stats.ino }\n        if (\n          queueWatcher\n          && queueWatcherIdentity?.device === nextIdentity.device\n          && queueWatcherIdentity.inode === nextIdentity.inode\n        ) {\n          return\n        }\n\n        closeQueueWatcher()\n        const watcher = fs.watch(queueFile, (eventType) => {\n          if (eventType === 'rename') {\n            queueWatcherIdentity = null\n            void refreshQueueWatcher()\n          }\n          void pollAndProcess()\n        })\n        watcher.on('error', (err) => {\n          logger.error('Queue watch error; fallback polling remains active', { err })\n          if (queueWatcher === watcher) {\n            closeQueueWatcher()\n          }\n        })\n        if (!activeHandler) {\n          watcher.close()\n          return\n        }\n        queueWatcher = watcher\n        queueWatcherIdentity = nextIdentity\n      } catch (err) {\n        logger.error('Failed to watch queue file; fallback polling remains active', { err })\n      }\n    })\n    watcherRefreshChain = refresh.catch(() => undefined)\n    return refresh\n  }\n\n  async function process(\n    handler: JobHandler<T>,\n    options?: ProcessOptions\n  ): Promise<ProcessResult> {\n    // If limit is specified, do a single batch (backward compatibility)\n    if (options?.limit) {\n      return processBatch(handler, options)\n    }\n\n    if (activeHandler) {\n      await close()\n    }\n\n    // Start continuous polling mode (like BullMQ Worker)\n    activeHandler = handler\n\n    try {\n      await refreshQueueWatcher()\n      await pollAndProcess(true)\n    } catch (error) {\n      await close()\n      throw error\n    }\n\n    pollingTimer = setInterval(() => {\n      refreshQueueWatcher().then(() => pollAndProcess()).catch((err) => {\n        logger.error('Poll cycle error', { err })\n      })\n    }, fallbackPollInterval)\n\n    logger.info('Worker started', { concurrency })\n\n    // Return sentinel value indicating continuous worker mode (like async strategy)\n    return { processed: -1, failed: -1, lastJobId: undefined }\n  }\n\n  async function clear(): Promise<{ removed: number }> {\n    return withFileLock(async () => {\n      const jobs = await readQueue()\n      const removed = jobs.length\n      await writeQueue([])\n      hasQueuedJobs = false\n      scheduleQueuedPoll()\n      // Reset state but preserve counts for historical tracking\n      const state = await readState()\n      await writeState({\n        completedCount: state.completedCount,\n        failedCount: state.failedCount,\n      })\n      return { removed }\n    })\n  }\n\n  async function removeQueuedJobsByScope(scope: QueueJobScope): Promise<{ removed: number }> {\n    return withFileLock(async () => {\n      const jobs = await readQueue()\n      const retainedJobs = jobs.filter((job) => inFlightJobIds.has(job.id) || !payloadMatchesScope(job.payload, scope))\n      const removed = jobs.length - retainedJobs.length\n      if (removed > 0) {\n        await writeQueue(retainedJobs)\n      }\n      hasQueuedJobs = retainedJobs.length > 0\n      scheduleQueuedPoll()\n      return { removed }\n    })\n  }\n\n  async function close(): Promise<void> {\n    activeHandler = null\n    if (queuedPollTimer) {\n      clearTimeout(queuedPollTimer)\n      queuedPollTimer = null\n    }\n    closeQueueWatcher()\n\n    // Stop polling timer\n    if (pollingTimer) {\n      clearInterval(pollingTimer)\n      pollingTimer = null\n    }\n    // Wait for any in-progress processing to complete (with timeout)\n    const SHUTDOWN_TIMEOUT = 5000\n    const startTime = Date.now()\n\n    while (isProcessing) {\n      if (Date.now() - startTime > SHUTDOWN_TIMEOUT) {\n        logger.warn('Force closing after shutdown timeout', { timeoutMs: SHUTDOWN_TIMEOUT })\n        break\n      }\n      await new Promise((resolve) => setTimeout(resolve, 50))\n    }\n  }\n\n  async function getJobCounts(): Promise<{\n    waiting: number\n    active: number\n    completed: number\n    failed: number\n  }> {\n    return withFileLock(async () => {\n      const state = await readState()\n      const jobs = await readQueue()\n\n      return {\n        waiting: jobs.length, // All jobs in queue are waiting (processed ones are removed)\n        active: 0, // Local strategy doesn't track active jobs\n        completed: state.completedCount ?? 0,\n        failed: state.failedCount ?? 0,\n      }\n    })\n  }\n\n  return {\n    name,\n    strategy: 'local',\n    enqueue,\n    process,\n    clear,\n    removeQueuedJobsByScope,\n    close,\n    getJobCounts,\n  }\n}\n"],
+  "mappings": "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",
   "names": ["options"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/queue",
-  "version": "0.6.8-develop.6948.1.8369fc4c97",
+  "version": "0.6.8-develop.6958.1.6696e8db69",
   "license": "MIT",
   "description": "Multi-strategy job queue with local and BullMQ support",
   "type": "module",
@@ -56,8 +56,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@open-mercato/shared": "0.6.8-develop.6948.1.8369fc4c97",
-    "@open-mercato/telemetry": "0.6.8-develop.6948.1.8369fc4c97"
+    "@open-mercato/shared": "0.6.8-develop.6958.1.6696e8db69",
+    "@open-mercato/telemetry": "0.6.8-develop.6958.1.6696e8db69"
   },
   "repository": {
     "type": "git",

package/src/__tests__/local.strategy.test.ts

@@ -22,6 +22,29 @@ const queueLoggerError = createLogger('queue').error as jest.Mock
 
 function readJson(p: string) { return JSON.parse(fs.readFileSync(p, 'utf8')) }
 
+async function within<T>(promise: Promise<T>, timeoutMs: number): Promise<T> {
+  let timeout: ReturnType<typeof setTimeout> | undefined
+  try {
+    return await Promise.race([
+      promise,
+      new Promise<T>((_resolve, reject) => {
+        timeout = setTimeout(() => reject(new Error(`[internal] Timed out after ${timeoutMs}ms`)), timeoutMs)
+      }),
+    ])
+  } finally {
+    if (timeout) clearTimeout(timeout)
+  }
+}
+
+function createWatcherStub(): fs.FSWatcher {
+  const watcher = {
+    close: jest.fn(),
+    on: jest.fn(),
+  }
+  watcher.on.mockReturnValue(watcher)
+  return watcher as unknown as fs.FSWatcher
+}
+
 async function waitUntil(condition: () => boolean, timeoutMs = 5000): Promise<void> {
   const deadline = Date.now() + timeoutMs
   while (!condition()) {
@@ -622,4 +645,350 @@ describe('Queue - local strategy', () => {
 
     await queue.close()
   })
+
+  test('continuous workers process new jobs without waiting for the polling interval', async () => {
+    const baseDir = path.join(tmp, 'event-wakeup')
+    const producer = createQueue<{ value: number }>('event-wakeup', 'local', { baseDir })
+    const consumer = createQueue<{ value: number }>('event-wakeup', 'local', { baseDir })
+    let resolveProcessed!: (value: number) => void
+    const processed = new Promise<number>((resolve) => {
+      resolveProcessed = resolve
+    })
+
+    try {
+      await consumer.process((job) => {
+        resolveProcessed(job.payload.value)
+      })
+
+      await producer.enqueue({ value: 42 })
+
+      await expect(within(processed, 800)).resolves.toBe(42)
+    } finally {
+      await consumer.close()
+      await producer.close()
+    }
+  })
+
+  test('idle continuous workers do not poll at the queued-work default interval', async () => {
+    jest.useFakeTimers()
+    const baseDir = path.join(tmp, 'idle-default')
+    const queueFile = path.join(baseDir, 'idle-default', 'queue.json')
+    const watcher = createWatcherStub()
+    const watchSpy = jest.spyOn(fs, 'watch').mockReturnValue(watcher)
+    const readFileSpy = jest.spyOn(fs.promises, 'readFile')
+    const consumer = createQueue<{ value: number }>('idle-default', 'local', { baseDir })
+
+    try {
+      await consumer.process(() => {})
+      readFileSpy.mockClear()
+
+      await jest.advanceTimersByTimeAsync(1500)
+      jest.useRealTimers()
+      await new Promise((resolve) => setTimeout(resolve, 50))
+
+      const queueReads = readFileSpy.mock.calls.filter(([filePath]) => String(filePath) === queueFile)
+      expect(queueReads).toHaveLength(0)
+    } finally {
+      jest.useRealTimers()
+      await consumer.close()
+      readFileSpy.mockRestore()
+      watchSpy.mockRestore()
+    }
+  })
+
+  test('custom queued-work polling keeps the idle safety interval', async () => {
+    jest.useFakeTimers()
+    const baseDir = path.join(tmp, 'idle-custom')
+    const queueFile = path.join(baseDir, 'idle-custom', 'queue.json')
+    const watcher = createWatcherStub()
+    const watchSpy = jest.spyOn(fs, 'watch').mockReturnValue(watcher)
+    const readFileSpy = jest.spyOn(fs.promises, 'readFile')
+    const consumer = createQueue<{ value: number }>('idle-custom', 'local', {
+      baseDir,
+      pollInterval: 50,
+    })
+
+    try {
+      await consumer.process(() => {})
+      readFileSpy.mockClear()
+
+      await jest.advanceTimersByTimeAsync(500)
+      jest.useRealTimers()
+      await new Promise((resolve) => setTimeout(resolve, 50))
+
+      const queueReads = readFileSpy.mock.calls.filter(([filePath]) => String(filePath) === queueFile)
+      expect(queueReads).toHaveLength(0)
+    } finally {
+      jest.useRealTimers()
+      await consumer.close()
+      readFileSpy.mockRestore()
+      watchSpy.mockRestore()
+    }
+  })
+
+  test('continuous workers re-arm filesystem wake-ups after the queue directory is recreated', async () => {
+    jest.useFakeTimers()
+    const baseDir = path.join(tmp, 'recreated-queue')
+    const movedDir = path.join(tmp, 'moved-queue')
+    const consumer = createQueue<{ value: number }>('recreated-queue', 'local', { baseDir })
+    let resolveRecovered!: (value: number) => void
+    const recovered = new Promise<number>((resolve) => {
+      resolveRecovered = resolve
+    })
+    let resolveEventDriven!: (value: number) => void
+    const eventDriven = new Promise<number>((resolve) => {
+      resolveEventDriven = resolve
+    })
+
+    try {
+      await consumer.process((job) => {
+        if (job.payload.value === 7) {
+          resolveRecovered(job.payload.value)
+          return
+        }
+        resolveEventDriven(job.payload.value)
+      })
+      fs.renameSync(baseDir, movedDir)
+      const producer = createQueue<{ value: number }>('recreated-queue', 'local', { baseDir })
+
+      try {
+        await producer.enqueue({ value: 7 })
+        const recoveredWithinFallback = within(recovered, 5500)
+        await jest.advanceTimersByTimeAsync(5000)
+        await expect(recoveredWithinFallback).resolves.toBe(7)
+
+        jest.useRealTimers()
+        await within((async () => {
+          while (true) {
+            const counts = await consumer.getJobCounts()
+            if (counts.completed === 1 && counts.waiting === 0) break
+            await new Promise((resolve) => setTimeout(resolve, 10))
+          }
+        })(), 800)
+        await producer.enqueue({ value: 8 })
+        await expect(within(eventDriven, 800)).resolves.toBe(8)
+      } finally {
+        await producer.close()
+      }
+    } finally {
+      jest.useRealTimers()
+      await consumer.close()
+    }
+  })
+
+  test('clear cancels queued-work polling after draining the queue', async () => {
+    jest.useFakeTimers()
+    const baseDir = path.join(tmp, 'clear-queued-poll')
+    const queueFile = path.join(baseDir, 'clear-queued-poll', 'queue.json')
+    const watcher = createWatcherStub()
+    const watchSpy = jest.spyOn(fs, 'watch').mockReturnValue(watcher)
+    const readFileSpy = jest.spyOn(fs.promises, 'readFile')
+    const consumer = createQueue<{ value: number }>('clear-queued-poll', 'local', { baseDir })
+
+    try {
+      await consumer.enqueue({ value: 1 }, { delayMs: 10_000 })
+      await consumer.process(() => {})
+      await consumer.clear()
+      readFileSpy.mockClear()
+
+      await jest.advanceTimersByTimeAsync(1000)
+      jest.useRealTimers()
+      await new Promise((resolve) => setTimeout(resolve, 50))
+
+      const queueReads = readFileSpy.mock.calls.filter(([filePath]) => String(filePath) === queueFile)
+      expect(queueReads).toHaveLength(0)
+    } finally {
+      jest.useRealTimers()
+      await consumer.close()
+      readFileSpy.mockRestore()
+      watchSpy.mockRestore()
+    }
+  })
+
+  test('scoped removal cancels queued-work polling after draining the queue', async () => {
+    jest.useFakeTimers()
+    const baseDir = path.join(tmp, 'scoped-remove-queued-poll')
+    const queueFile = path.join(baseDir, 'scoped-remove-queued-poll', 'queue.json')
+    const watcher = createWatcherStub()
+    const watchSpy = jest.spyOn(fs, 'watch').mockReturnValue(watcher)
+    const readFileSpy = jest.spyOn(fs.promises, 'readFile')
+    const consumer = createQueue<{ tenantId: string; value: number }>('scoped-remove-queued-poll', 'local', { baseDir })
+
+    try {
+      await consumer.enqueue({ tenantId: 'tenant-1', value: 1 }, { delayMs: 10_000 })
+      await consumer.process(() => {})
+      await consumer.removeQueuedJobsByScope!({ tenantId: 'tenant-1' })
+      readFileSpy.mockClear()
+
+      await jest.advanceTimersByTimeAsync(1000)
+      jest.useRealTimers()
+      await new Promise((resolve) => setTimeout(resolve, 50))
+
+      const queueReads = readFileSpy.mock.calls.filter(([filePath]) => String(filePath) === queueFile)
+      expect(queueReads).toHaveLength(0)
+    } finally {
+      jest.useRealTimers()
+      await consumer.close()
+      readFileSpy.mockRestore()
+      watchSpy.mockRestore()
+    }
+  })
+
+  test('continuous processing survives a transient watcher stat failure', async () => {
+    const baseDir = path.join(tmp, 'watcher-stat-failure')
+    const consumer = createQueue<{ value: number }>('watcher-stat-failure', 'local', { baseDir })
+    const processed: number[] = []
+
+    await consumer.enqueue({ value: 1 })
+    const statError = Object.assign(new Error('Queue file temporarily unavailable'), { code: 'ENOENT' })
+    const statSpy = jest.spyOn(fs.promises, 'stat').mockRejectedValueOnce(statError)
+
+    try {
+      await expect(consumer.process((job) => {
+        processed.push(job.payload.value)
+      })).resolves.toEqual({ processed: -1, failed: -1, lastJobId: undefined })
+      expect(processed).toEqual([1])
+    } finally {
+      await consumer.close()
+      statSpy.mockRestore()
+    }
+  })
+
+  test('continuous processing falls back to polling when watcher setup fails', async () => {
+    const baseDir = path.join(tmp, 'watcher-setup-failure')
+    const consumer = createQueue<{ value: number }>('watcher-setup-failure', 'local', { baseDir })
+    const processed: number[] = []
+    const watchSpy = jest.spyOn(fs, 'watch').mockImplementation(() => {
+      throw new Error('Filesystem watching unavailable')
+    })
+
+    try {
+      await consumer.enqueue({ value: 1 })
+      await expect(consumer.process((job) => {
+        processed.push(job.payload.value)
+      })).resolves.toEqual({ processed: -1, failed: -1, lastJobId: undefined })
+      expect(processed).toEqual([1])
+    } finally {
+      await consumer.close()
+      watchSpy.mockRestore()
+    }
+  })
+
+  test('restarting continuous processing closes the previous watcher', async () => {
+    jest.useFakeTimers()
+    const firstWatcher = createWatcherStub()
+    const secondWatcher = createWatcherStub()
+    const watchSpy = jest.spyOn(fs, 'watch')
+      .mockReturnValueOnce(firstWatcher)
+      .mockReturnValueOnce(secondWatcher)
+    const consumer = createQueue<{ value: number }>('restart-worker', 'local', {
+      baseDir: path.join(tmp, 'restart-worker'),
+    })
+
+    try {
+      await consumer.process(() => {})
+      await consumer.process(() => {})
+
+      expect(firstWatcher.close).toHaveBeenCalledTimes(1)
+    } finally {
+      jest.useRealTimers()
+      await consumer.close()
+      firstWatcher.close()
+      secondWatcher.close()
+      watchSpy.mockRestore()
+    }
+  })
+
+  test('continuous processing rejects when its initial queue read fails', async () => {
+    const baseDir = path.join(tmp, 'initial-read-failure')
+    const queueFile = path.join(baseDir, 'initial-read-failure', 'queue.json')
+    const consumer = createQueue<{ value: number }>('initial-read-failure', 'local', { baseDir })
+    const actualReadFile = fs.promises.readFile
+
+    await consumer.enqueue({ value: 1 })
+    const readFileSpy = jest.spyOn(fs.promises, 'readFile').mockImplementation(async (filePath, ...args) => {
+      if (String(filePath) === queueFile) {
+        throw Object.assign(new Error('Permission denied'), { code: 'EACCES' })
+      }
+      return actualReadFile(filePath, ...args)
+    })
+    queueLoggerError.mockClear()
+
+    try {
+      await expect(consumer.process(() => {})).rejects.toThrow('Queue file unreadable')
+      expect(queueLoggerError).not.toHaveBeenCalledWith('Polling error', expect.anything())
+    } finally {
+      await consumer.close()
+      readFileSpy.mockRestore()
+    }
+  })
+
+  test('continuous workers keep polling while delayed jobs remain queued', async () => {
+    const baseDir = path.join(tmp, 'delayed-queue')
+    const producer = createQueue<{ value: number }>('delayed-queue', 'local', { baseDir })
+    const consumer = createQueue<{ value: number }>('delayed-queue', 'local', { baseDir })
+    let resolveProcessed!: (value: number) => void
+    const processed = new Promise<number>((resolve) => {
+      resolveProcessed = resolve
+    })
+
+    try {
+      await producer.enqueue({ value: 9 }, { delayMs: 250 })
+      await consumer.process((job) => {
+        resolveProcessed(job.payload.value)
+      })
+
+      await expect(within(processed, 1800)).resolves.toBe(9)
+    } finally {
+      await consumer.close()
+      await producer.close()
+    }
+  })
+
+  test('continuous workers retain wake-ups received during an active batch', async () => {
+    const baseDir = path.join(tmp, 'active-batch')
+    const producer = createQueue<{ value: number }>('active-batch', 'local', {
+      baseDir,
+      pollInterval: 5000,
+    })
+    const consumer = createQueue<{ value: number }>('active-batch', 'local', {
+      baseDir,
+      pollInterval: 5000,
+    })
+    let resolveFirstStarted!: () => void
+    const firstStarted = new Promise<void>((resolve) => {
+      resolveFirstStarted = resolve
+    })
+    let releaseFirst!: () => void
+    const firstRelease = new Promise<void>((resolve) => {
+      releaseFirst = resolve
+    })
+    let resolveSecondProcessed!: (value: number) => void
+    const secondProcessed = new Promise<number>((resolve) => {
+      resolveSecondProcessed = resolve
+    })
+
+    try {
+      await consumer.process(async (job) => {
+        if (job.payload.value === 1) {
+          resolveFirstStarted()
+          await firstRelease
+          return
+        }
+        resolveSecondProcessed(job.payload.value)
+      })
+
+      await producer.enqueue({ value: 1 })
+      await within(firstStarted, 800)
+      await producer.enqueue({ value: 2 })
+      releaseFirst()
+
+      await expect(within(secondProcessed, 800)).resolves.toBe(2)
+    } finally {
+      releaseFirst()
+      await consumer.close()
+      await producer.close()
+    }
+  })
+
 })

package/src/strategies/local.ts

@@ -18,6 +18,11 @@ type StoredJob<T> = QueuedJob<T> & {
   attemptCount?: number
 }
 
+type QueueFileIdentity = {
+  device: number
+  inode: number
+}
+
 function payloadMatchesScope(payload: unknown, scope: QueueJobScope): boolean {
   if (!payload || typeof payload !== 'object') return false
   const scopedPayload = payload as { tenantId?: unknown; organizationId?: unknown; jobType?: unknown }
@@ -31,8 +36,10 @@ function payloadMatchesScope(payload: unknown, scope: QueueJobScope): boolean {
   return true
 }
 
-/** Default polling interval in milliseconds */
+/** Polling interval while delayed or retrying work remains queued. */
 const DEFAULT_POLL_INTERVAL = 1000
+/** Idle safety interval for missed filesystem watcher events. */
+const DEFAULT_FALLBACK_POLL_INTERVAL = 5000
 const DEFAULT_LOCAL_QUEUE_BASE_DIR = '.mercato/queue'
 const DEFAULT_MAX_ATTEMPTS = 3
 const RETRY_BACKOFF_BASE_MS = 1000
@@ -120,10 +127,17 @@ export function createLocalQueue<T = unknown>(
   // Note: concurrency is stored for logging/compatibility but jobs are processed sequentially
   const concurrency = options?.concurrency ?? 1
   const pollInterval = options?.pollInterval ?? DEFAULT_POLL_INTERVAL
+  const fallbackPollInterval = Math.max(pollInterval, DEFAULT_FALLBACK_POLL_INTERVAL)
 
   // Worker state for continuous polling
   let pollingTimer: ReturnType<typeof setInterval> | null = null
+  let queuedPollTimer: ReturnType<typeof setTimeout> | null = null
+  let queueWatcher: fs.FSWatcher | null = null
+  let queueWatcherIdentity: QueueFileIdentity | null = null
+  let watcherRefreshChain: Promise<void> = Promise.resolve()
+  let hasQueuedJobs = false
   let isProcessing = false
+  let pollRequested = false
   let activeHandler: JobHandler<T> | null = null
   const inFlightJobIds = new Set<string>()
 
@@ -439,6 +453,7 @@ export function createLocalQueue<T = unknown>(
       const jobsRead = await readQueue()
       return { state: stateRead, jobs: jobsRead }
     })
+    hasQueuedJobs = jobs.length > 0
 
     const pendingJobs = jobs.filter((job) => {
       if (!job.availableAt) return true
@@ -503,6 +518,7 @@ export function createLocalQueue<T = unknown>(
             .filter((j) => !completedJobIds.has(j.id) && !deadJobIds.has(j.id))
             .map((j) => retryUpdates.get(j.id) ?? j)
           await writeQueue(updatedJobs)
+          hasQueuedJobs = updatedJobs.length > 0
 
           const newState: LocalState = {
             lastProcessedId: lastJobId,
@@ -524,18 +540,94 @@ export function createLocalQueue<T = unknown>(
   /**
    * Poll for and process new jobs.
    */
-  async function pollAndProcess(): Promise<void> {
-    // Skip if already processing to avoid concurrent file access
-    if (isProcessing || !activeHandler) return
+  async function pollAndProcess(rethrow = false): Promise<void> {
+    if (!activeHandler) return
+    if (isProcessing) {
+      pollRequested = true
+      return
+    }
 
     isProcessing = true
     try {
-      await processBatch(activeHandler)
+      do {
+        pollRequested = false
+        const handler = activeHandler
+        if (!handler) break
+        await processBatch(handler)
+      } while (pollRequested)
     } catch (error) {
+      if (rethrow) throw error
       logger.error('Polling error', { err: error })
     } finally {
       isProcessing = false
+      scheduleQueuedPoll()
+    }
+  }
+
+  function scheduleQueuedPoll(): void {
+    if (!activeHandler || !hasQueuedJobs) {
+      if (queuedPollTimer) {
+        clearTimeout(queuedPollTimer)
+        queuedPollTimer = null
+      }
+      return
     }
+    if (queuedPollTimer) return
+    queuedPollTimer = setTimeout(() => {
+      queuedPollTimer = null
+      void pollAndProcess()
+    }, pollInterval)
+  }
+
+  function closeQueueWatcher(): void {
+    if (queueWatcher) {
+      queueWatcher.close()
+      queueWatcher = null
+    }
+    queueWatcherIdentity = null
+  }
+
+  function refreshQueueWatcher(): Promise<void> {
+    const refresh = watcherRefreshChain.then(async () => {
+      if (!activeHandler) return
+      try {
+        await ensureDir()
+        const stats = await fsp.stat(queueFile)
+        const nextIdentity = { device: stats.dev, inode: stats.ino }
+        if (
+          queueWatcher
+          && queueWatcherIdentity?.device === nextIdentity.device
+          && queueWatcherIdentity.inode === nextIdentity.inode
+        ) {
+          return
+        }
+
+        closeQueueWatcher()
+        const watcher = fs.watch(queueFile, (eventType) => {
+          if (eventType === 'rename') {
+            queueWatcherIdentity = null
+            void refreshQueueWatcher()
+          }
+          void pollAndProcess()
+        })
+        watcher.on('error', (err) => {
+          logger.error('Queue watch error; fallback polling remains active', { err })
+          if (queueWatcher === watcher) {
+            closeQueueWatcher()
+          }
+        })
+        if (!activeHandler) {
+          watcher.close()
+          return
+        }
+        queueWatcher = watcher
+        queueWatcherIdentity = nextIdentity
+      } catch (err) {
+        logger.error('Failed to watch queue file; fallback polling remains active', { err })
+      }
+    })
+    watcherRefreshChain = refresh.catch(() => undefined)
+    return refresh
   }
 
   async function process(
@@ -547,18 +639,26 @@ export function createLocalQueue<T = unknown>(
       return processBatch(handler, options)
     }
 
+    if (activeHandler) {
+      await close()
+    }
+
     // Start continuous polling mode (like BullMQ Worker)
     activeHandler = handler
 
-    // Process any pending jobs immediately
-    await processBatch(handler)
+    try {
+      await refreshQueueWatcher()
+      await pollAndProcess(true)
+    } catch (error) {
+      await close()
+      throw error
+    }
 
-    // Start polling interval for new jobs
     pollingTimer = setInterval(() => {
-      pollAndProcess().catch((err) => {
+      refreshQueueWatcher().then(() => pollAndProcess()).catch((err) => {
         logger.error('Poll cycle error', { err })
       })
-    }, pollInterval)
+    }, fallbackPollInterval)
 
     logger.info('Worker started', { concurrency })
 
@@ -571,6 +671,8 @@ export function createLocalQueue<T = unknown>(
       const jobs = await readQueue()
       const removed = jobs.length
       await writeQueue([])
+      hasQueuedJobs = false
+      scheduleQueuedPoll()
       // Reset state but preserve counts for historical tracking
       const state = await readState()
       await writeState({
@@ -589,18 +691,25 @@ export function createLocalQueue<T = unknown>(
       if (removed > 0) {
         await writeQueue(retainedJobs)
       }
+      hasQueuedJobs = retainedJobs.length > 0
+      scheduleQueuedPoll()
       return { removed }
     })
   }
 
   async function close(): Promise<void> {
+    activeHandler = null
+    if (queuedPollTimer) {
+      clearTimeout(queuedPollTimer)
+      queuedPollTimer = null
+    }
+    closeQueueWatcher()
+
     // Stop polling timer
     if (pollingTimer) {
       clearInterval(pollingTimer)
       pollingTimer = null
     }
-    activeHandler = null
-
     // Wait for any in-progress processing to complete (with timeout)
     const SHUTDOWN_TIMEOUT = 5000
     const startTime = Date.now()

package/src/types.ts

@@ -59,7 +59,7 @@ export type LocalQueueOptions = {
   baseDir?: string
   /** Number of concurrent job processors. Defaults to 1 */
   concurrency?: number
-  /** Polling interval in milliseconds for continuous processing. Defaults to 1000 */
+  /** Polling interval in milliseconds while work is queued. Idle safety polling uses at least 5000 ms. Defaults to 1000. */
   pollInterval?: number
 }