workmatic 1.0.0 → 1.0.2

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../node_modules/tsup/assets/cjs_shims.js","../src/database.ts","../src/client.ts","../src/utils.ts","../src/worker.ts","../src/dashboard.ts"],"sourcesContent":["/**\n * Workmatic - A persistent job queue for Node.js\n * \n * @packageDocumentation\n */\n\n// Main exports\nexport { createDatabase } from './database.js';\nexport { createClient } from './client.js';\nexport { createWorker } from './worker.js';\nexport { createDashboard, createDashboardMiddleware } from './dashboard.js';\n\n// Utility exports\nexport { defaultBackoff, validatePayload } from './utils.js';\n\n// Type exports\nexport type {\n  // Core types\n  Job,\n  JobStatus,\n  JobStats,\n  ClaimedJob,\n  \n  // Options\n  AddJobOptions,\n  AddJobResult,\n  DatabaseOptions,\n  ClientOptions,\n  WorkerOptions,\n  DashboardOptions,\n  DashboardMiddlewareOptions,\n  BackoffFunction,\n  JobProcessor,\n  \n  // Interfaces\n  WorkmaticClient,\n  WorkmaticWorker,\n  WorkmaticDashboard,\n  DashboardMiddleware,\n  WorkmaticDb,\n  WorkmaticDatabase,\n  WorkmaticJobsTable,\n} from './types.js';\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","import Database from 'better-sqlite3';\nimport { Kysely, SqliteDialect } from 'kysely';\nimport type { WorkmaticDatabase, WorkmaticDb, DatabaseOptions } from './types.js';\n\n/**\n * Create and initialize the workmatic database\n * \n * @param options - Database options\n * @returns Kysely database instance\n * \n * @example\n * ```ts\n * // Using a file path\n * const db = createDatabase({ filename: './jobs.db' });\n * \n * // Using an existing better-sqlite3 instance\n * import Database from 'better-sqlite3';\n * const sqlite = new Database('./jobs.db');\n * const db = createDatabase({ db: sqlite });\n * \n * // In-memory database (for testing)\n * const db = createDatabase({ filename: ':memory:' });\n * ```\n */\nexport function createDatabase(options: DatabaseOptions = {}): WorkmaticDb {\n  let sqliteDb: Database.Database;\n\n  if (options.db) {\n    sqliteDb = options.db;\n  } else {\n    const filename = options.filename ?? ':memory:';\n    sqliteDb = new Database(filename);\n  }\n\n  // Set pragmas for performance and safety\n  sqliteDb.pragma('journal_mode = WAL');\n  sqliteDb.pragma('synchronous = NORMAL');\n  sqliteDb.pragma('busy_timeout = 5000');\n\n  // Create Kysely instance\n  const db = new Kysely<WorkmaticDatabase>({\n    dialect: new SqliteDialect({\n      database: sqliteDb,\n    }),\n  });\n\n  // Create schema synchronously using better-sqlite3 directly\n  createSchema(sqliteDb);\n\n  return db;\n}\n\n/**\n * Create the database schema if it doesn't exist\n */\nfunction createSchema(db: Database.Database): void {\n  // Create the jobs table\n  db.exec(`\n    CREATE TABLE IF NOT EXISTS workmatic_jobs (\n      id INTEGER PRIMARY KEY AUTOINCREMENT,\n      public_id TEXT UNIQUE NOT NULL,\n      queue TEXT NOT NULL,\n      payload TEXT NOT NULL,\n      status TEXT NOT NULL DEFAULT 'ready',\n      priority INTEGER NOT NULL DEFAULT 0,\n      run_at INTEGER NOT NULL,\n      attempts INTEGER NOT NULL DEFAULT 0,\n      max_attempts INTEGER NOT NULL DEFAULT 3,\n      lease_until INTEGER NOT NULL DEFAULT 0,\n      created_at INTEGER NOT NULL,\n      updated_at INTEGER NOT NULL,\n      last_error TEXT\n    )\n  `);\n\n  // Create composite index for efficient job claiming\n  // (queue, status, run_at, priority, id)\n  db.exec(`\n    CREATE INDEX IF NOT EXISTS idx_workmatic_jobs_claim \n    ON workmatic_jobs (queue, status, run_at, priority, id)\n  `);\n\n  // Create index for lease expiration checking\n  // (status, lease_until)\n  db.exec(`\n    CREATE INDEX IF NOT EXISTS idx_workmatic_jobs_lease \n    ON workmatic_jobs (status, lease_until)\n  `);\n\n  // Create settings table for queue-level settings (pause state, etc.)\n  db.exec(`\n    CREATE TABLE IF NOT EXISTS workmatic_settings (\n      queue TEXT PRIMARY KEY,\n      paused INTEGER NOT NULL DEFAULT 0,\n      updated_at INTEGER NOT NULL\n    )\n  `);\n}\n\n/**\n * Get the underlying better-sqlite3 database instance from a Kysely instance\n * This is useful for advanced operations or testing\n */\nexport function getUnderlyingDb(db: WorkmaticDb): Database.Database {\n  // Access the internal database through the dialect\n  // This is a bit hacky but necessary for some operations\n  const dialect = (db as any).getExecutor().adapter.db;\n  return dialect;\n}\n","import { nanoid } from 'nanoid';\nimport { sql } from 'kysely';\nimport type {\n  WorkmaticDb,\n  ClientOptions,\n  WorkmaticClient,\n  AddJobOptions,\n  AddJobResult,\n  JobStats,\n  JobStatus,\n} from './types.js';\nimport { validatePayload, now } from './utils.js';\n\n/**\n * Create a job queue client for adding jobs\n * \n * @param options - Client options\n * @returns Client instance\n * \n * @example\n * ```ts\n * const client = createClient({ db });\n * \n * // Add a simple job\n * const result = await client.add({ email: 'user@example.com' });\n * console.log(result.id); // Job public ID\n * \n * // Add a job with options\n * await client.add(\n *   { userId: 123 },\n *   { priority: 1, delayMs: 5000, maxAttempts: 5 }\n * );\n * \n * // Get queue statistics\n * const stats = await client.stats();\n * console.log(stats); // { ready: 5, running: 2, done: 100, ... }\n * ```\n */\nexport function createClient(options: ClientOptions): WorkmaticClient {\n  const { db, queue = 'default' } = options;\n\n  if (!db) {\n    throw new Error('Database instance is required');\n  }\n\n  return {\n    /**\n     * Add a job to the queue\n     */\n    async add<TPayload = unknown>(\n      payload: TPayload,\n      opts: AddJobOptions = {}\n    ): Promise<AddJobResult> {\n      const {\n        priority = 0,\n        delayMs = 0,\n        maxAttempts = 3,\n      } = opts;\n\n      // Validate and serialize payload\n      const payloadJson = validatePayload(payload);\n      \n      // Generate unique public ID\n      const publicId = nanoid();\n      \n      const timestamp = now();\n      const runAt = timestamp + delayMs;\n\n      // Insert job\n      await db\n        .insertInto('workmatic_jobs')\n        .values({\n          public_id: publicId,\n          queue,\n          payload: payloadJson,\n          status: 'ready',\n          priority,\n          run_at: runAt,\n          attempts: 0,\n          max_attempts: maxAttempts,\n          lease_until: 0,\n          created_at: timestamp,\n          updated_at: timestamp,\n          last_error: null,\n        })\n        .execute();\n\n      return { ok: true, id: publicId };\n    },\n\n    /**\n     * Get job statistics for the queue\n     */\n    async stats(): Promise<JobStats> {\n      const result = await db\n        .selectFrom('workmatic_jobs')\n        .select([\n          'status',\n          sql<number>`count(*)`.as('count'),\n        ])\n        .where('queue', '=', queue)\n        .groupBy('status')\n        .execute();\n\n      const stats: JobStats = {\n        ready: 0,\n        running: 0,\n        done: 0,\n        failed: 0,\n        dead: 0,\n        total: 0,\n      };\n\n      for (const row of result) {\n        const status = row.status as JobStatus;\n        const count = Number(row.count);\n        if (status in stats) {\n          stats[status] = count;\n        }\n        stats.total += count;\n      }\n\n      return stats;\n    },\n  };\n}\n","import type { BackoffFunction } from './types.js';\n\n/**\n * Default exponential backoff function\n * Returns delay in milliseconds: 1000 * 2^attempts\n * \n * @param attempts - Number of failed attempts\n * @returns Delay in milliseconds\n * \n * @example\n * ```ts\n * defaultBackoff(0) // 1000ms (1 second)\n * defaultBackoff(1) // 2000ms (2 seconds)\n * defaultBackoff(2) // 4000ms (4 seconds)\n * defaultBackoff(3) // 8000ms (8 seconds)\n * ```\n */\nexport const defaultBackoff: BackoffFunction = (attempts: number): number => {\n  return 1000 * Math.pow(2, attempts);\n};\n\n/**\n * Validate that a payload is JSON-serializable\n * \n * @param payload - The payload to validate\n * @throws Error if payload cannot be serialized to JSON\n * @returns The JSON string representation\n */\nexport function validatePayload(payload: unknown): string {\n  try {\n    return JSON.stringify(payload);\n  } catch (error) {\n    throw new Error(\n      `Payload is not JSON-serializable: ${error instanceof Error ? error.message : 'Unknown error'}`\n    );\n  }\n}\n\n/**\n * Parse a JSON payload safely\n * \n * @param json - JSON string to parse\n * @returns Parsed payload\n * @throws Error if JSON is invalid\n */\nexport function parsePayload<T = unknown>(json: string): T {\n  try {\n    return JSON.parse(json) as T;\n  } catch (error) {\n    throw new Error(\n      `Invalid JSON payload: ${error instanceof Error ? error.message : 'Unknown error'}`\n    );\n  }\n}\n\n/**\n * Sleep for a specified duration\n * \n * @param ms - Duration in milliseconds\n * @returns Promise that resolves after the duration\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Get current timestamp in milliseconds\n */\nexport function now(): number {\n  return Date.now();\n}\n","import fastq from 'fastq';\nimport type { queueAsPromised } from 'fastq';\nimport { sql } from 'kysely';\nimport type {\n  WorkmaticDb,\n  WorkerOptions,\n  WorkmaticWorker,\n  JobProcessor,\n  JobStats,\n  JobStatus,\n  Job,\n  ClaimedJob,\n} from './types.js';\nimport { defaultBackoff, parsePayload, sleep, now } from './utils.js';\n\n/**\n * Create a job queue worker for processing jobs\n * \n * @param options - Worker options\n * @returns Worker instance\n * \n * @example\n * ```ts\n * const worker = createWorker({ db, concurrency: 4 });\n * \n * // Set the processor function\n * worker.process(async (job) => {\n *   console.log('Processing job:', job.id);\n *   await sendEmail(job.payload.email);\n * });\n * \n * // Start processing\n * worker.start();\n * \n * // Later, gracefully stop\n * await worker.stop();\n * ```\n */\nexport function createWorker(options: WorkerOptions): WorkmaticWorker {\n  const {\n    db,\n    queue = 'default',\n    concurrency = 1,\n    leaseMs = 30000,\n    pollMs = 1000,\n    timeoutMs,\n    backoff = defaultBackoff,\n  } = options;\n\n  if (!db) {\n    throw new Error('Database instance is required');\n  }\n\n  // State\n  let running = false;\n  let paused = false;\n  let processor: JobProcessor<any> | null = null;\n  let pumpTimeout: NodeJS.Timeout | null = null;\n  let fastqQueue: queueAsPromised<ClaimedJob, void> | null = null;\n\n  /**\n   * Requeue jobs with expired leases\n   */\n  async function requeueExpiredLeases(): Promise<number> {\n    const timestamp = now();\n\n    const result = await db\n      .updateTable('workmatic_jobs')\n      .set({\n        status: 'ready',\n        lease_until: 0,\n        updated_at: timestamp,\n      })\n      .where('status', '=', 'running')\n      .where('lease_until', '<', timestamp)\n      .where('lease_until', '>', 0)\n      .execute();\n\n    return Number(result[0]?.numUpdatedRows ?? 0);\n  }\n\n  /**\n   * Claim a batch of jobs for processing\n   */\n  async function claimBatch(limit: number): Promise<ClaimedJob[]> {\n    const timestamp = now();\n    const leaseUntil = timestamp + leaseMs;\n\n    // Use a transaction to ensure atomic claim\n    return await db.transaction().execute(async (trx) => {\n      // Select eligible jobs\n      const jobs = await trx\n        .selectFrom('workmatic_jobs')\n        .select(['id', 'public_id', 'queue', 'payload', 'attempts', 'max_attempts'])\n        .where('queue', '=', queue)\n        .where('status', '=', 'ready')\n        .where('run_at', '<=', timestamp)\n        .orderBy('priority', 'asc')\n        .orderBy('id', 'asc')\n        .limit(limit)\n        .execute();\n\n      if (jobs.length === 0) {\n        return [];\n      }\n\n      // Get the IDs of claimed jobs\n      const jobIds = jobs.map(j => j.id);\n\n      // Update them to running status\n      await trx\n        .updateTable('workmatic_jobs')\n        .set({\n          status: 'running',\n          lease_until: leaseUntil,\n          updated_at: timestamp,\n        })\n        .where('id', 'in', jobIds)\n        .execute();\n\n      return jobs;\n    });\n  }\n\n  /**\n   * Mark a job as completed\n   */\n  async function markDone(jobId: number): Promise<void> {\n    await db\n      .updateTable('workmatic_jobs')\n      .set({\n        status: 'done',\n        lease_until: 0,\n        updated_at: now(),\n      })\n      .where('id', '=', jobId)\n      .execute();\n  }\n\n  /**\n   * Handle job failure\n   */\n  async function markFailed(\n    jobId: number,\n    attempts: number,\n    maxAttempts: number,\n    error: Error\n  ): Promise<void> {\n    const timestamp = now();\n    const newAttempts = attempts + 1;\n    const errorMessage = error.message || String(error);\n\n    if (newAttempts < maxAttempts) {\n      // Retry: set back to ready with backoff delay\n      const runAt = timestamp + backoff(newAttempts);\n      \n      await db\n        .updateTable('workmatic_jobs')\n        .set({\n          status: 'ready',\n          attempts: newAttempts,\n          run_at: runAt,\n          lease_until: 0,\n          last_error: errorMessage,\n          updated_at: timestamp,\n        })\n        .where('id', '=', jobId)\n        .execute();\n    } else {\n      // Max attempts reached: mark as dead\n      await db\n        .updateTable('workmatic_jobs')\n        .set({\n          status: 'dead',\n          attempts: newAttempts,\n          lease_until: 0,\n          last_error: errorMessage,\n          updated_at: timestamp,\n        })\n        .where('id', '=', jobId)\n        .execute();\n    }\n  }\n\n  /**\n   * Run a promise with timeout\n   */\n  async function withTimeout<T>(\n    promise: Promise<T>,\n    ms: number,\n    jobId: string\n  ): Promise<T> {\n    let timeoutId: NodeJS.Timeout;\n    \n    const timeoutPromise = new Promise<never>((_, reject) => {\n      timeoutId = setTimeout(() => {\n        reject(new Error(`Job ${jobId} timed out after ${ms}ms`));\n      }, ms);\n    });\n\n    try {\n      return await Promise.race([promise, timeoutPromise]);\n    } finally {\n      clearTimeout(timeoutId!);\n    }\n  }\n\n  /**\n   * Process a single job\n   */\n  async function processJob(claimedJob: ClaimedJob): Promise<void> {\n    if (!processor) {\n      throw new Error('No processor set');\n    }\n\n    // Parse payload and create job object\n    const payload = parsePayload(claimedJob.payload);\n    const job: Job = {\n      id: claimedJob.public_id,\n      queue: claimedJob.queue,\n      payload,\n      status: 'running',\n      priority: 0, // Not needed for processing\n      attempts: claimedJob.attempts,\n      maxAttempts: claimedJob.max_attempts,\n      createdAt: 0, // Not needed for processing\n      lastError: null,\n    };\n\n    try {\n      // Run processor with optional timeout\n      if (timeoutMs) {\n        await withTimeout(processor(job), timeoutMs, job.id);\n      } else {\n        await processor(job);\n      }\n      await markDone(claimedJob.id);\n    } catch (error) {\n      await markFailed(\n        claimedJob.id,\n        claimedJob.attempts,\n        claimedJob.max_attempts,\n        error instanceof Error ? error : new Error(String(error))\n      );\n    }\n  }\n\n  /**\n   * Check if queue is paused in database (for CLI control)\n   */\n  async function isQueuePausedInDb(): Promise<boolean> {\n    const setting = await db\n      .selectFrom('workmatic_settings')\n      .select('paused')\n      .where('queue', '=', queue)\n      .executeTakeFirst();\n    \n    return setting?.paused === 1;\n  }\n\n  /**\n   * Main pump loop\n   */\n  async function pump(): Promise<void> {\n    if (!running) {\n      return;\n    }\n\n    // Check both in-memory pause and database pause (for CLI control)\n    if (paused) {\n      pumpTimeout = setTimeout(pump, pollMs);\n      return;\n    }\n\n    try {\n      // Check database pause state (allows CLI to pause running workers)\n      const dbPaused = await isQueuePausedInDb();\n      if (dbPaused) {\n        pumpTimeout = setTimeout(pump, pollMs);\n        return;\n      }\n\n      // Requeue expired leases\n      await requeueExpiredLeases();\n\n      // Claim a batch of jobs\n      const batchSize = concurrency * 2;\n      const jobs = await claimBatch(batchSize);\n\n      if (jobs.length > 0) {\n        // Push jobs into fastq\n        for (const job of jobs) {\n          fastqQueue!.push(job);\n        }\n        // Immediately pump again\n        pumpTimeout = setTimeout(pump, 0);\n      } else {\n        // No jobs, wait before polling again\n        pumpTimeout = setTimeout(pump, pollMs);\n      }\n    } catch (error) {\n      // Log error and continue\n      console.error('[workmatic] Pump error:', error);\n      pumpTimeout = setTimeout(pump, pollMs);\n    }\n  }\n\n  // Create the worker object\n  const worker: WorkmaticWorker = {\n    process<TPayload = unknown>(fn: JobProcessor<TPayload>): void {\n      processor = fn as JobProcessor<any>;\n    },\n\n    start(): void {\n      if (running) {\n        return;\n      }\n\n      if (!processor) {\n        throw new Error('No processor set. Call process() before start()');\n      }\n\n      running = true;\n      paused = false;\n\n      // Create fastq queue\n      fastqQueue = fastq.promise(processJob, concurrency);\n\n      // Start pump loop\n      pump();\n    },\n\n    async stop(): Promise<void> {\n      if (!running) {\n        return;\n      }\n\n      running = false;\n\n      // Clear pump timeout\n      if (pumpTimeout) {\n        clearTimeout(pumpTimeout);\n        pumpTimeout = null;\n      }\n\n      // Wait for fastq to drain\n      if (fastqQueue) {\n        await fastqQueue.drained();\n        fastqQueue = null;\n      }\n    },\n\n    pause(): void {\n      paused = true;\n    },\n\n    resume(): void {\n      paused = false;\n    },\n\n    async stats(): Promise<JobStats> {\n      const result = await db\n        .selectFrom('workmatic_jobs')\n        .select([\n          'status',\n          sql<number>`count(*)`.as('count'),\n        ])\n        .where('queue', '=', queue)\n        .groupBy('status')\n        .execute();\n\n      const stats: JobStats = {\n        ready: 0,\n        running: 0,\n        done: 0,\n        failed: 0,\n        dead: 0,\n        total: 0,\n      };\n\n      for (const row of result) {\n        const status = row.status as JobStatus;\n        const count = Number(row.count);\n        if (status in stats) {\n          stats[status] = count;\n        }\n        stats.total += count;\n      }\n\n      return stats;\n    },\n\n    get isRunning(): boolean {\n      return running;\n    },\n\n    get isPaused(): boolean {\n      return paused;\n    },\n\n    get queue(): string {\n      return queue;\n    },\n  };\n\n  return worker;\n}\n","import { createServer, IncomingMessage, ServerResponse } from 'http';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\nimport { readFile } from 'fs/promises';\nimport { sql } from 'kysely';\nimport type {\n  WorkmaticDb,\n  DashboardOptions,\n  DashboardMiddlewareOptions,\n  WorkmaticDashboard,\n  WorkmaticWorker,\n  DashboardMiddleware,\n  JobStats,\n  JobStatus,\n} from './types.js';\n\n// Get the directory of this module for static file serving\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Content types for static files\nconst CONTENT_TYPES: Record<string, string> = {\n  '.html': 'text/html; charset=utf-8',\n  '.css': 'text/css; charset=utf-8',\n  '.js': 'application/javascript; charset=utf-8',\n  '.json': 'application/json; charset=utf-8',\n};\n\n/**\n * Create the core request handler (shared between standalone and middleware)\n */\nfunction createRequestHandler(\n  db: WorkmaticDb,\n  workerMap: Map<string, WorkmaticWorker>,\n  basePath: string = ''\n) {\n  /**\n   * Send JSON response\n   */\n  function sendJson(res: ServerResponse, data: unknown, status = 200): void {\n    res.writeHead(status, { 'Content-Type': 'application/json' });\n    res.end(JSON.stringify(data));\n  }\n\n  /**\n   * Send error response\n   */\n  function sendError(res: ServerResponse, message: string, status = 500): void {\n    sendJson(res, { error: message }, status);\n  }\n\n  /**\n   * Parse URL query parameters\n   */\n  function parseQuery(url: string): URLSearchParams {\n    const queryIndex = url.indexOf('?');\n    if (queryIndex === -1) return new URLSearchParams();\n    return new URLSearchParams(url.slice(queryIndex + 1));\n  }\n\n  /**\n   * Get path from URL (removing basePath prefix)\n   */\n  function getPath(url: string): string {\n    const queryIndex = url.indexOf('?');\n    let path = queryIndex === -1 ? url : url.slice(0, queryIndex);\n    \n    // Remove basePath prefix if present\n    if (basePath && path.startsWith(basePath)) {\n      path = path.slice(basePath.length) || '/';\n    }\n    \n    return path;\n  }\n\n  /**\n   * API: Get jobs list\n   */\n  async function handleGetJobs(req: IncomingMessage, res: ServerResponse): Promise<void> {\n    const query = parseQuery(req.url || '');\n    const queueFilter = query.get('queue');\n    const statusFilter = query.get('status') as JobStatus | null;\n    const limit = Math.min(parseInt(query.get('limit') || '50', 10), 100);\n    const offset = parseInt(query.get('offset') || '0', 10);\n\n    let queryBuilder = db\n      .selectFrom('workmatic_jobs')\n      .select([\n        'public_id',\n        'queue',\n        'payload',\n        'status',\n        'priority',\n        'attempts',\n        'max_attempts',\n        'run_at',\n        'created_at',\n        'updated_at',\n        'last_error',\n      ])\n      .orderBy('created_at', 'desc')\n      .limit(limit)\n      .offset(offset);\n\n    if (queueFilter) {\n      queryBuilder = queryBuilder.where('queue', '=', queueFilter);\n    }\n    if (statusFilter) {\n      queryBuilder = queryBuilder.where('status', '=', statusFilter);\n    }\n\n    const jobs = await queryBuilder.execute();\n\n    // Transform to API format\n    const apiJobs = jobs.map(job => ({\n      id: job.public_id,\n      queue: job.queue,\n      payload: JSON.parse(job.payload),\n      status: job.status,\n      priority: job.priority,\n      attempts: job.attempts,\n      maxAttempts: job.max_attempts,\n      runAt: job.run_at,\n      createdAt: job.created_at,\n      updatedAt: job.updated_at,\n      lastError: job.last_error,\n    }));\n\n    sendJson(res, { jobs: apiJobs, limit, offset });\n  }\n\n  /**\n   * API: Get statistics\n   */\n  async function handleGetStats(req: IncomingMessage, res: ServerResponse): Promise<void> {\n    const query = parseQuery(req.url || '');\n    const queueFilter = query.get('queue');\n\n    // Get counts by status\n    let statsQuery = db\n      .selectFrom('workmatic_jobs')\n      .select([\n        'status',\n        sql<number>`count(*)`.as('count'),\n      ])\n      .groupBy('status');\n\n    if (queueFilter) {\n      statsQuery = statsQuery.where('queue', '=', queueFilter);\n    }\n\n    const statusCounts = await statsQuery.execute();\n\n    const stats: JobStats = {\n      ready: 0,\n      running: 0,\n      done: 0,\n      failed: 0,\n      dead: 0,\n      total: 0,\n    };\n\n    for (const row of statusCounts) {\n      const status = row.status as JobStatus;\n      const count = Number(row.count);\n      if (status in stats) {\n        stats[status] = count;\n      }\n      stats.total += count;\n    }\n\n    // Get queue list\n    const queuesResult = await db\n      .selectFrom('workmatic_jobs')\n      .select('queue')\n      .groupBy('queue')\n      .execute();\n\n    const queues = queuesResult.map(q => q.queue);\n\n    // Get worker status\n    const workersStatus = Array.from(workerMap.entries()).map(([queue, worker]) => ({\n      queue,\n      running: worker.isRunning,\n      paused: worker.isPaused,\n    }));\n\n    sendJson(res, { stats, queues, workers: workersStatus });\n  }\n\n  /**\n   * API: Get single job by ID\n   */\n  async function handleGetJob(req: IncomingMessage, res: ServerResponse, publicId: string): Promise<void> {\n    const job = await db\n      .selectFrom('workmatic_jobs')\n      .select([\n        'public_id',\n        'queue',\n        'payload',\n        'status',\n        'priority',\n        'attempts',\n        'max_attempts',\n        'run_at',\n        'lease_until',\n        'created_at',\n        'updated_at',\n        'last_error',\n      ])\n      .where('public_id', '=', publicId)\n      .executeTakeFirst();\n\n    if (!job) {\n      return sendError(res, 'Job not found', 404);\n    }\n\n    sendJson(res, {\n      id: job.public_id,\n      queue: job.queue,\n      payload: JSON.parse(job.payload),\n      status: job.status,\n      priority: job.priority,\n      attempts: job.attempts,\n      maxAttempts: job.max_attempts,\n      runAt: job.run_at,\n      leaseUntil: job.lease_until,\n      createdAt: job.created_at,\n      updatedAt: job.updated_at,\n      lastError: job.last_error,\n    });\n  }\n\n  /**\n   * API: Pause worker\n   */\n  async function handlePauseWorker(res: ServerResponse, queue: string): Promise<void> {\n    const worker = workerMap.get(queue);\n    if (!worker) {\n      return sendError(res, `Worker for queue '${queue}' not found`, 404);\n    }\n    worker.pause();\n    sendJson(res, { ok: true, queue, paused: true });\n  }\n\n  /**\n   * API: Resume worker\n   */\n  async function handleResumeWorker(res: ServerResponse, queue: string): Promise<void> {\n    const worker = workerMap.get(queue);\n    if (!worker) {\n      return sendError(res, `Worker for queue '${queue}' not found`, 404);\n    }\n    worker.resume();\n    sendJson(res, { ok: true, queue, paused: false });\n  }\n\n  /**\n   * Serve static files from the dashboard directory\n   */\n  async function serveStatic(res: ServerResponse, filePath: string): Promise<void> {\n    // Navigate from dist/dashboard.js to dashboard/ directory\n    const dashboardDir = join(__dirname, '..', 'dashboard');\n    const fullPath = join(dashboardDir, filePath);\n    \n    // Determine content type\n    const ext = filePath.substring(filePath.lastIndexOf('.')) || '.html';\n    const contentType = CONTENT_TYPES[ext] || 'application/octet-stream';\n\n    try {\n      const content = await readFile(fullPath, 'utf-8');\n      res.writeHead(200, { 'Content-Type': contentType });\n      res.end(content);\n    } catch (error) {\n      sendError(res, 'Not found', 404);\n    }\n  }\n\n  /**\n   * Main request handler\n   */\n  return async function handleRequest(\n    req: IncomingMessage,\n    res: ServerResponse,\n    next?: () => void\n  ): Promise<boolean> {\n    const path = getPath(req.url || '/');\n\n    // Check if this request is for the dashboard\n    const fullUrl = req.url || '/';\n    if (basePath && !fullUrl.startsWith(basePath)) {\n      // Not our route, call next middleware if available\n      if (next) next();\n      return false;\n    }\n\n    // CORS headers\n    res.setHeader('Access-Control-Allow-Origin', '*');\n    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');\n    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');\n\n    if (req.method === 'OPTIONS') {\n      res.writeHead(204);\n      res.end();\n      return true;\n    }\n\n    try {\n      // API routes\n      if (path === '/api/jobs' && req.method === 'GET') {\n        await handleGetJobs(req, res);\n        return true;\n      }\n\n      if (path === '/api/stats' && req.method === 'GET') {\n        await handleGetStats(req, res);\n        return true;\n      }\n\n      // Single job: /api/jobs/:id\n      const jobMatch = path.match(/^\\/api\\/jobs\\/([^/]+)$/);\n      if (jobMatch && req.method === 'GET') {\n        await handleGetJob(req, res, jobMatch[1]);\n        return true;\n      }\n\n      // Pause worker: /api/workers/:queue/pause\n      const pauseMatch = path.match(/^\\/api\\/workers\\/([^/]+)\\/pause$/);\n      if (pauseMatch && req.method === 'POST') {\n        await handlePauseWorker(res, pauseMatch[1]);\n        return true;\n      }\n\n      // Resume worker: /api/workers/:queue/resume\n      const resumeMatch = path.match(/^\\/api\\/workers\\/([^/]+)\\/resume$/);\n      if (resumeMatch && req.method === 'POST') {\n        await handleResumeWorker(res, resumeMatch[1]);\n        return true;\n      }\n\n      // Static files\n      if (path === '/' || path === '/index.html') {\n        await serveStatic(res, 'index.html');\n        return true;\n      }\n      if (path === '/style.css') {\n        await serveStatic(res, 'style.css');\n        return true;\n      }\n      if (path === '/app.js') {\n        await serveStatic(res, 'app.js');\n        return true;\n      }\n\n      // 404 for unknown routes under our basePath\n      sendError(res, 'Not found', 404);\n      return true;\n    } catch (error) {\n      console.error('[workmatic] Dashboard error:', error);\n      sendError(res, 'Internal server error', 500);\n      return true;\n    }\n  };\n}\n\n/**\n * Create a dashboard HTTP server for monitoring and controlling the job queue\n * \n * @param options - Dashboard options\n * @returns Dashboard instance\n * \n * @example\n * ```ts\n * const dashboard = createDashboard({ \n *   db, \n *   port: 3000,\n *   workers: [worker1, worker2] \n * });\n * \n * console.log(`Dashboard running at http://localhost:${dashboard.port}`);\n * \n * // Later, close the server\n * await dashboard.close();\n * ```\n */\nexport function createDashboard(options: DashboardOptions): WorkmaticDashboard {\n  const {\n    db,\n    port = 3000,\n    workers = [],\n  } = options;\n\n  if (!db) {\n    throw new Error('Database instance is required');\n  }\n\n  // Worker registry by queue name\n  const workerMap = new Map<string, WorkmaticWorker>();\n  for (const worker of workers) {\n    workerMap.set(worker.queue, worker);\n  }\n\n  const handleRequest = createRequestHandler(db, workerMap);\n\n  // Create and start HTTP server\n  const server = createServer((req, res) => {\n    handleRequest(req, res).catch(error => {\n      console.error('[workmatic] Unhandled error:', error);\n      res.writeHead(500, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ error: 'Internal server error' }));\n    });\n  });\n\n  server.listen(port);\n\n  return {\n    async close(): Promise<void> {\n      return new Promise((resolve, reject) => {\n        server.close((err) => {\n          if (err) reject(err);\n          else resolve();\n        });\n      });\n    },\n\n    get port(): number {\n      return port;\n    },\n  };\n}\n\n/**\n * Create an Express-compatible middleware for the dashboard\n * \n * @param options - Middleware options\n * @returns Express middleware function\n * \n * @example\n * ```ts\n * import express from 'express';\n * import { createDashboardMiddleware } from 'workmatic';\n * \n * const app = express();\n * \n * // Mount dashboard at /workmatic\n * app.use(createDashboardMiddleware({ \n *   db,\n *   basePath: '/workmatic',\n *   workers: [worker] \n * }));\n * \n * app.listen(3000);\n * // Dashboard available at http://localhost:3000/workmatic\n * ```\n */\nexport function createDashboardMiddleware(options: DashboardMiddlewareOptions): DashboardMiddleware {\n  const {\n    db,\n    workers = [],\n    basePath = '',\n  } = options;\n\n  if (!db) {\n    throw new Error('Database instance is required');\n  }\n\n  // Worker registry by queue name\n  const workerMap = new Map<string, WorkmaticWorker>();\n  for (const worker of workers) {\n    workerMap.set(worker.queue, worker);\n  }\n\n  const handleRequest = createRequestHandler(db, workerMap, basePath);\n\n  return (req, res, next) => {\n    handleRequest(req, res, next).catch(error => {\n      console.error('[workmatic] Unhandled error:', error);\n      if (next) {\n        next();\n      } else {\n        res.writeHead(500, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify({ error: 'Internal server error' }));\n      }\n    });\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKA,IAAM,mBAAmB,MACvB,OAAO,aAAa,cAChB,IAAI,IAAI,QAAQ,UAAU,EAAE,EAAE,OAC7B,SAAS,iBAAiB,SAAS,cAAc,QAAQ,YAAY,MAAM,WAC1E,SAAS,cAAc,MACvB,IAAI,IAAI,WAAW,SAAS,OAAO,EAAE;AAEtC,IAAM,gBAAgC,iCAAiB;;;ACZ9D,4BAAqB;AACrB,oBAAsC;AAuB/B,SAAS,eAAe,UAA2B,CAAC,GAAgB;AACzE,MAAI;AAEJ,MAAI,QAAQ,IAAI;AACd,eAAW,QAAQ;AAAA,EACrB,OAAO;AACL,UAAM,WAAW,QAAQ,YAAY;AACrC,eAAW,IAAI,sBAAAA,QAAS,QAAQ;AAAA,EAClC;AAGA,WAAS,OAAO,oBAAoB;AACpC,WAAS,OAAO,sBAAsB;AACtC,WAAS,OAAO,qBAAqB;AAGrC,QAAM,KAAK,IAAI,qBAA0B;AAAA,IACvC,SAAS,IAAI,4BAAc;AAAA,MACzB,UAAU;AAAA,IACZ,CAAC;AAAA,EACH,CAAC;AAGD,eAAa,QAAQ;AAErB,SAAO;AACT;AAKA,SAAS,aAAa,IAA6B;AAEjD,KAAG,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAgBP;AAID,KAAG,KAAK;AAAA;AAAA;AAAA,GAGP;AAID,KAAG,KAAK;AAAA;AAAA;AAAA,GAGP;AAGD,KAAG,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAMP;AACH;;;ACjGA,oBAAuB;AACvB,IAAAC,iBAAoB;;;ACgBb,IAAM,iBAAkC,CAAC,aAA6B;AAC3E,SAAO,MAAO,KAAK,IAAI,GAAG,QAAQ;AACpC;AASO,SAAS,gBAAgB,SAA0B;AACxD,MAAI;AACF,WAAO,KAAK,UAAU,OAAO;AAAA,EAC/B,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,qCAAqC,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,IAC/F;AAAA,EACF;AACF;AASO,SAAS,aAA0B,MAAiB;AACzD,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,IACnF;AAAA,EACF;AACF;AAeO,SAAS,MAAc;AAC5B,SAAO,KAAK,IAAI;AAClB;;;ADhCO,SAAS,aAAa,SAAyC;AACpE,QAAM,EAAE,IAAI,QAAQ,UAAU,IAAI;AAElC,MAAI,CAAC,IAAI;AACP,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AAEA,SAAO;AAAA;AAAA;AAAA;AAAA,IAIL,MAAM,IACJ,SACA,OAAsB,CAAC,GACA;AACvB,YAAM;AAAA,QACJ,WAAW;AAAA,QACX,UAAU;AAAA,QACV,cAAc;AAAA,MAChB,IAAI;AAGJ,YAAM,cAAc,gBAAgB,OAAO;AAG3C,YAAM,eAAW,sBAAO;AAExB,YAAM,YAAY,IAAI;AACtB,YAAM,QAAQ,YAAY;AAG1B,YAAM,GACH,WAAW,gBAAgB,EAC3B,OAAO;AAAA,QACN,WAAW;AAAA,QACX;AAAA,QACA,SAAS;AAAA,QACT,QAAQ;AAAA,QACR;AAAA,QACA,QAAQ;AAAA,QACR,UAAU;AAAA,QACV,cAAc;AAAA,QACd,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,YAAY;AAAA,QACZ,YAAY;AAAA,MACd,CAAC,EACA,QAAQ;AAEX,aAAO,EAAE,IAAI,MAAM,IAAI,SAAS;AAAA,IAClC;AAAA;AAAA;AAAA;AAAA,IAKA,MAAM,QAA2B;AAC/B,YAAM,SAAS,MAAM,GAClB,WAAW,gBAAgB,EAC3B,OAAO;AAAA,QACN;AAAA,QACA,6BAAsB,GAAG,OAAO;AAAA,MAClC,CAAC,EACA,MAAM,SAAS,KAAK,KAAK,EACzB,QAAQ,QAAQ,EAChB,QAAQ;AAEX,YAAM,QAAkB;AAAA,QACtB,OAAO;AAAA,QACP,SAAS;AAAA,QACT,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,OAAO;AAAA,MACT;AAEA,iBAAW,OAAO,QAAQ;AACxB,cAAM,SAAS,IAAI;AACnB,cAAM,QAAQ,OAAO,IAAI,KAAK;AAC9B,YAAI,UAAU,OAAO;AACnB,gBAAM,MAAM,IAAI;AAAA,QAClB;AACA,cAAM,SAAS;AAAA,MACjB;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;AE7HA,mBAAkB;AAElB,IAAAC,iBAAoB;AAoCb,SAAS,aAAa,SAAyC;AACpE,QAAM;AAAA,IACJ;AAAA,IACA,QAAQ;AAAA,IACR,cAAc;AAAA,IACd,UAAU;AAAA,IACV,SAAS;AAAA,IACT;AAAA,IACA,UAAU;AAAA,EACZ,IAAI;AAEJ,MAAI,CAAC,IAAI;AACP,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AAGA,MAAI,UAAU;AACd,MAAI,SAAS;AACb,MAAI,YAAsC;AAC1C,MAAI,cAAqC;AACzC,MAAI,aAAuD;AAK3D,iBAAe,uBAAwC;AACrD,UAAM,YAAY,IAAI;AAEtB,UAAM,SAAS,MAAM,GAClB,YAAY,gBAAgB,EAC5B,IAAI;AAAA,MACH,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,YAAY;AAAA,IACd,CAAC,EACA,MAAM,UAAU,KAAK,SAAS,EAC9B,MAAM,eAAe,KAAK,SAAS,EACnC,MAAM,eAAe,KAAK,CAAC,EAC3B,QAAQ;AAEX,WAAO,OAAO,OAAO,CAAC,GAAG,kBAAkB,CAAC;AAAA,EAC9C;AAKA,iBAAe,WAAW,OAAsC;AAC9D,UAAM,YAAY,IAAI;AACtB,UAAM,aAAa,YAAY;AAG/B,WAAO,MAAM,GAAG,YAAY,EAAE,QAAQ,OAAO,QAAQ;AAEnD,YAAM,OAAO,MAAM,IAChB,WAAW,gBAAgB,EAC3B,OAAO,CAAC,MAAM,aAAa,SAAS,WAAW,YAAY,cAAc,CAAC,EAC1E,MAAM,SAAS,KAAK,KAAK,EACzB,MAAM,UAAU,KAAK,OAAO,EAC5B,MAAM,UAAU,MAAM,SAAS,EAC/B,QAAQ,YAAY,KAAK,EACzB,QAAQ,MAAM,KAAK,EACnB,MAAM,KAAK,EACX,QAAQ;AAEX,UAAI,KAAK,WAAW,GAAG;AACrB,eAAO,CAAC;AAAA,MACV;AAGA,YAAM,SAAS,KAAK,IAAI,OAAK,EAAE,EAAE;AAGjC,YAAM,IACH,YAAY,gBAAgB,EAC5B,IAAI;AAAA,QACH,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,YAAY;AAAA,MACd,CAAC,EACA,MAAM,MAAM,MAAM,MAAM,EACxB,QAAQ;AAEX,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAKA,iBAAe,SAAS,OAA8B;AACpD,UAAM,GACH,YAAY,gBAAgB,EAC5B,IAAI;AAAA,MACH,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,YAAY,IAAI;AAAA,IAClB,CAAC,EACA,MAAM,MAAM,KAAK,KAAK,EACtB,QAAQ;AAAA,EACb;AAKA,iBAAe,WACb,OACA,UACA,aACA,OACe;AACf,UAAM,YAAY,IAAI;AACtB,UAAM,cAAc,WAAW;AAC/B,UAAM,eAAe,MAAM,WAAW,OAAO,KAAK;AAElD,QAAI,cAAc,aAAa;AAE7B,YAAM,QAAQ,YAAY,QAAQ,WAAW;AAE7C,YAAM,GACH,YAAY,gBAAgB,EAC5B,IAAI;AAAA,QACH,QAAQ;AAAA,QACR,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,YAAY;AAAA,MACd,CAAC,EACA,MAAM,MAAM,KAAK,KAAK,EACtB,QAAQ;AAAA,IACb,OAAO;AAEL,YAAM,GACH,YAAY,gBAAgB,EAC5B,IAAI;AAAA,QACH,QAAQ;AAAA,QACR,UAAU;AAAA,QACV,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,YAAY;AAAA,MACd,CAAC,EACA,MAAM,MAAM,KAAK,KAAK,EACtB,QAAQ;AAAA,IACb;AAAA,EACF;AAKA,iBAAe,YACb,SACA,IACA,OACY;AACZ,QAAI;AAEJ,UAAM,iBAAiB,IAAI,QAAe,CAAC,GAAG,WAAW;AACvD,kBAAY,WAAW,MAAM;AAC3B,eAAO,IAAI,MAAM,OAAO,KAAK,oBAAoB,EAAE,IAAI,CAAC;AAAA,MAC1D,GAAG,EAAE;AAAA,IACP,CAAC;AAED,QAAI;AACF,aAAO,MAAM,QAAQ,KAAK,CAAC,SAAS,cAAc,CAAC;AAAA,IACrD,UAAE;AACA,mBAAa,SAAU;AAAA,IACzB;AAAA,EACF;AAKA,iBAAe,WAAW,YAAuC;AAC/D,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,kBAAkB;AAAA,IACpC;AAGA,UAAM,UAAU,aAAa,WAAW,OAAO;AAC/C,UAAM,MAAW;AAAA,MACf,IAAI,WAAW;AAAA,MACf,OAAO,WAAW;AAAA,MAClB;AAAA,MACA,QAAQ;AAAA,MACR,UAAU;AAAA;AAAA,MACV,UAAU,WAAW;AAAA,MACrB,aAAa,WAAW;AAAA,MACxB,WAAW;AAAA;AAAA,MACX,WAAW;AAAA,IACb;AAEA,QAAI;AAEF,UAAI,WAAW;AACb,cAAM,YAAY,UAAU,GAAG,GAAG,WAAW,IAAI,EAAE;AAAA,MACrD,OAAO;AACL,cAAM,UAAU,GAAG;AAAA,MACrB;AACA,YAAM,SAAS,WAAW,EAAE;AAAA,IAC9B,SAAS,OAAO;AACd,YAAM;AAAA,QACJ,WAAW;AAAA,QACX,WAAW;AAAA,QACX,WAAW;AAAA,QACX,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,MAC1D;AAAA,IACF;AAAA,EACF;AAKA,iBAAe,oBAAsC;AACnD,UAAM,UAAU,MAAM,GACnB,WAAW,oBAAoB,EAC/B,OAAO,QAAQ,EACf,MAAM,SAAS,KAAK,KAAK,EACzB,iBAAiB;AAEpB,WAAO,SAAS,WAAW;AAAA,EAC7B;AAKA,iBAAe,OAAsB;AACnC,QAAI,CAAC,SAAS;AACZ;AAAA,IACF;AAGA,QAAI,QAAQ;AACV,oBAAc,WAAW,MAAM,MAAM;AACrC;AAAA,IACF;AAEA,QAAI;AAEF,YAAM,WAAW,MAAM,kBAAkB;AACzC,UAAI,UAAU;AACZ,sBAAc,WAAW,MAAM,MAAM;AACrC;AAAA,MACF;AAGA,YAAM,qBAAqB;AAG3B,YAAM,YAAY,cAAc;AAChC,YAAM,OAAO,MAAM,WAAW,SAAS;AAEvC,UAAI,KAAK,SAAS,GAAG;AAEnB,mBAAW,OAAO,MAAM;AACtB,qBAAY,KAAK,GAAG;AAAA,QACtB;AAEA,sBAAc,WAAW,MAAM,CAAC;AAAA,MAClC,OAAO;AAEL,sBAAc,WAAW,MAAM,MAAM;AAAA,MACvC;AAAA,IACF,SAAS,OAAO;AAEd,cAAQ,MAAM,2BAA2B,KAAK;AAC9C,oBAAc,WAAW,MAAM,MAAM;AAAA,IACvC;AAAA,EACF;AAGA,QAAM,SAA0B;AAAA,IAC9B,QAA4B,IAAkC;AAC5D,kBAAY;AAAA,IACd;AAAA,IAEA,QAAc;AACZ,UAAI,SAAS;AACX;AAAA,MACF;AAEA,UAAI,CAAC,WAAW;AACd,cAAM,IAAI,MAAM,iDAAiD;AAAA,MACnE;AAEA,gBAAU;AACV,eAAS;AAGT,mBAAa,aAAAC,QAAM,QAAQ,YAAY,WAAW;AAGlD,WAAK;AAAA,IACP;AAAA,IAEA,MAAM,OAAsB;AAC1B,UAAI,CAAC,SAAS;AACZ;AAAA,MACF;AAEA,gBAAU;AAGV,UAAI,aAAa;AACf,qBAAa,WAAW;AACxB,sBAAc;AAAA,MAChB;AAGA,UAAI,YAAY;AACd,cAAM,WAAW,QAAQ;AACzB,qBAAa;AAAA,MACf;AAAA,IACF;AAAA,IAEA,QAAc;AACZ,eAAS;AAAA,IACX;AAAA,IAEA,SAAe;AACb,eAAS;AAAA,IACX;AAAA,IAEA,MAAM,QAA2B;AAC/B,YAAM,SAAS,MAAM,GAClB,WAAW,gBAAgB,EAC3B,OAAO;AAAA,QACN;AAAA,QACA,6BAAsB,GAAG,OAAO;AAAA,MAClC,CAAC,EACA,MAAM,SAAS,KAAK,KAAK,EACzB,QAAQ,QAAQ,EAChB,QAAQ;AAEX,YAAM,QAAkB;AAAA,QACtB,OAAO;AAAA,QACP,SAAS;AAAA,QACT,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,OAAO;AAAA,MACT;AAEA,iBAAW,OAAO,QAAQ;AACxB,cAAM,SAAS,IAAI;AACnB,cAAM,QAAQ,OAAO,IAAI,KAAK;AAC9B,YAAI,UAAU,OAAO;AACnB,gBAAM,MAAM,IAAI;AAAA,QAClB;AACA,cAAM,SAAS;AAAA,MACjB;AAEA,aAAO;AAAA,IACT;AAAA,IAEA,IAAI,YAAqB;AACvB,aAAO;AAAA,IACT;AAAA,IAEA,IAAI,WAAoB;AACtB,aAAO;AAAA,IACT;AAAA,IAEA,IAAI,QAAgB;AAClB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;;;ACtZA,kBAA8D;AAC9D,iBAA8B;AAC9B,kBAA8B;AAC9B,sBAAyB;AACzB,IAAAC,iBAAoB;AAapB,IAAMC,kBAAa,0BAAc,aAAe;AAChD,IAAM,gBAAY,qBAAQA,WAAU;AAGpC,IAAM,gBAAwC;AAAA,EAC5C,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AACX;AAKA,SAAS,qBACP,IACA,WACA,WAAmB,IACnB;AAIA,WAAS,SAAS,KAAqB,MAAe,SAAS,KAAW;AACxE,QAAI,UAAU,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC;AAC5D,QAAI,IAAI,KAAK,UAAU,IAAI,CAAC;AAAA,EAC9B;AAKA,WAAS,UAAU,KAAqB,SAAiB,SAAS,KAAW;AAC3E,aAAS,KAAK,EAAE,OAAO,QAAQ,GAAG,MAAM;AAAA,EAC1C;AAKA,WAAS,WAAW,KAA8B;AAChD,UAAM,aAAa,IAAI,QAAQ,GAAG;AAClC,QAAI,eAAe,GAAI,QAAO,IAAI,gBAAgB;AAClD,WAAO,IAAI,gBAAgB,IAAI,MAAM,aAAa,CAAC,CAAC;AAAA,EACtD;AAKA,WAAS,QAAQ,KAAqB;AACpC,UAAM,aAAa,IAAI,QAAQ,GAAG;AAClC,QAAI,OAAO,eAAe,KAAK,MAAM,IAAI,MAAM,GAAG,UAAU;AAG5D,QAAI,YAAY,KAAK,WAAW,QAAQ,GAAG;AACzC,aAAO,KAAK,MAAM,SAAS,MAAM,KAAK;AAAA,IACxC;AAEA,WAAO;AAAA,EACT;AAKA,iBAAe,cAAc,KAAsB,KAAoC;AACrF,UAAM,QAAQ,WAAW,IAAI,OAAO,EAAE;AACtC,UAAM,cAAc,MAAM,IAAI,OAAO;AACrC,UAAM,eAAe,MAAM,IAAI,QAAQ;AACvC,UAAM,QAAQ,KAAK,IAAI,SAAS,MAAM,IAAI,OAAO,KAAK,MAAM,EAAE,GAAG,GAAG;AACpE,UAAM,SAAS,SAAS,MAAM,IAAI,QAAQ,KAAK,KAAK,EAAE;AAEtD,QAAI,eAAe,GAChB,WAAW,gBAAgB,EAC3B,OAAO;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC,EACA,QAAQ,cAAc,MAAM,EAC5B,MAAM,KAAK,EACX,OAAO,MAAM;AAEhB,QAAI,aAAa;AACf,qBAAe,aAAa,MAAM,SAAS,KAAK,WAAW;AAAA,IAC7D;AACA,QAAI,cAAc;AAChB,qBAAe,aAAa,MAAM,UAAU,KAAK,YAAY;AAAA,IAC/D;AAEA,UAAM,OAAO,MAAM,aAAa,QAAQ;AAGxC,UAAM,UAAU,KAAK,IAAI,UAAQ;AAAA,MAC/B,IAAI,IAAI;AAAA,MACR,OAAO,IAAI;AAAA,MACX,SAAS,KAAK,MAAM,IAAI,OAAO;AAAA,MAC/B,QAAQ,IAAI;AAAA,MACZ,UAAU,IAAI;AAAA,MACd,UAAU,IAAI;AAAA,MACd,aAAa,IAAI;AAAA,MACjB,OAAO,IAAI;AAAA,MACX,WAAW,IAAI;AAAA,MACf,WAAW,IAAI;AAAA,MACf,WAAW,IAAI;AAAA,IACjB,EAAE;AAEF,aAAS,KAAK,EAAE,MAAM,SAAS,OAAO,OAAO,CAAC;AAAA,EAChD;AAKA,iBAAe,eAAe,KAAsB,KAAoC;AACtF,UAAM,QAAQ,WAAW,IAAI,OAAO,EAAE;AACtC,UAAM,cAAc,MAAM,IAAI,OAAO;AAGrC,QAAI,aAAa,GACd,WAAW,gBAAgB,EAC3B,OAAO;AAAA,MACN;AAAA,MACA,6BAAsB,GAAG,OAAO;AAAA,IAClC,CAAC,EACA,QAAQ,QAAQ;AAEnB,QAAI,aAAa;AACf,mBAAa,WAAW,MAAM,SAAS,KAAK,WAAW;AAAA,IACzD;AAEA,UAAM,eAAe,MAAM,WAAW,QAAQ;AAE9C,UAAM,QAAkB;AAAA,MACtB,OAAO;AAAA,MACP,SAAS;AAAA,MACT,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,OAAO;AAAA,IACT;AAEA,eAAW,OAAO,cAAc;AAC9B,YAAM,SAAS,IAAI;AACnB,YAAM,QAAQ,OAAO,IAAI,KAAK;AAC9B,UAAI,UAAU,OAAO;AACnB,cAAM,MAAM,IAAI;AAAA,MAClB;AACA,YAAM,SAAS;AAAA,IACjB;AAGA,UAAM,eAAe,MAAM,GACxB,WAAW,gBAAgB,EAC3B,OAAO,OAAO,EACd,QAAQ,OAAO,EACf,QAAQ;AAEX,UAAM,SAAS,aAAa,IAAI,OAAK,EAAE,KAAK;AAG5C,UAAM,gBAAgB,MAAM,KAAK,UAAU,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,MAAM,OAAO;AAAA,MAC9E;AAAA,MACA,SAAS,OAAO;AAAA,MAChB,QAAQ,OAAO;AAAA,IACjB,EAAE;AAEF,aAAS,KAAK,EAAE,OAAO,QAAQ,SAAS,cAAc,CAAC;AAAA,EACzD;AAKA,iBAAe,aAAa,KAAsB,KAAqB,UAAiC;AACtG,UAAM,MAAM,MAAM,GACf,WAAW,gBAAgB,EAC3B,OAAO;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC,EACA,MAAM,aAAa,KAAK,QAAQ,EAChC,iBAAiB;AAEpB,QAAI,CAAC,KAAK;AACR,aAAO,UAAU,KAAK,iBAAiB,GAAG;AAAA,IAC5C;AAEA,aAAS,KAAK;AAAA,MACZ,IAAI,IAAI;AAAA,MACR,OAAO,IAAI;AAAA,MACX,SAAS,KAAK,MAAM,IAAI,OAAO;AAAA,MAC/B,QAAQ,IAAI;AAAA,MACZ,UAAU,IAAI;AAAA,MACd,UAAU,IAAI;AAAA,MACd,aAAa,IAAI;AAAA,MACjB,OAAO,IAAI;AAAA,MACX,YAAY,IAAI;AAAA,MAChB,WAAW,IAAI;AAAA,MACf,WAAW,IAAI;AAAA,MACf,WAAW,IAAI;AAAA,IACjB,CAAC;AAAA,EACH;AAKA,iBAAe,kBAAkB,KAAqB,OAA8B;AAClF,UAAM,SAAS,UAAU,IAAI,KAAK;AAClC,QAAI,CAAC,QAAQ;AACX,aAAO,UAAU,KAAK,qBAAqB,KAAK,eAAe,GAAG;AAAA,IACpE;AACA,WAAO,MAAM;AACb,aAAS,KAAK,EAAE,IAAI,MAAM,OAAO,QAAQ,KAAK,CAAC;AAAA,EACjD;AAKA,iBAAe,mBAAmB,KAAqB,OAA8B;AACnF,UAAM,SAAS,UAAU,IAAI,KAAK;AAClC,QAAI,CAAC,QAAQ;AACX,aAAO,UAAU,KAAK,qBAAqB,KAAK,eAAe,GAAG;AAAA,IACpE;AACA,WAAO,OAAO;AACd,aAAS,KAAK,EAAE,IAAI,MAAM,OAAO,QAAQ,MAAM,CAAC;AAAA,EAClD;AAKA,iBAAe,YAAY,KAAqB,UAAiC;AAE/E,UAAM,mBAAe,kBAAK,WAAW,MAAM,WAAW;AACtD,UAAM,eAAW,kBAAK,cAAc,QAAQ;AAG5C,UAAM,MAAM,SAAS,UAAU,SAAS,YAAY,GAAG,CAAC,KAAK;AAC7D,UAAM,cAAc,cAAc,GAAG,KAAK;AAE1C,QAAI;AACF,YAAM,UAAU,UAAM,0BAAS,UAAU,OAAO;AAChD,UAAI,UAAU,KAAK,EAAE,gBAAgB,YAAY,CAAC;AAClD,UAAI,IAAI,OAAO;AAAA,IACjB,SAAS,OAAO;AACd,gBAAU,KAAK,aAAa,GAAG;AAAA,IACjC;AAAA,EACF;AAKA,SAAO,eAAe,cACpB,KACA,KACA,MACkB;AAClB,UAAM,OAAO,QAAQ,IAAI,OAAO,GAAG;AAGnC,UAAM,UAAU,IAAI,OAAO;AAC3B,QAAI,YAAY,CAAC,QAAQ,WAAW,QAAQ,GAAG;AAE7C,UAAI,KAAM,MAAK;AACf,aAAO;AAAA,IACT;AAGA,QAAI,UAAU,+BAA+B,GAAG;AAChD,QAAI,UAAU,gCAAgC,oBAAoB;AAClE,QAAI,UAAU,gCAAgC,cAAc;AAE5D,QAAI,IAAI,WAAW,WAAW;AAC5B,UAAI,UAAU,GAAG;AACjB,UAAI,IAAI;AACR,aAAO;AAAA,IACT;AAEA,QAAI;AAEF,UAAI,SAAS,eAAe,IAAI,WAAW,OAAO;AAChD,cAAM,cAAc,KAAK,GAAG;AAC5B,eAAO;AAAA,MACT;AAEA,UAAI,SAAS,gBAAgB,IAAI,WAAW,OAAO;AACjD,cAAM,eAAe,KAAK,GAAG;AAC7B,eAAO;AAAA,MACT;AAGA,YAAM,WAAW,KAAK,MAAM,wBAAwB;AACpD,UAAI,YAAY,IAAI,WAAW,OAAO;AACpC,cAAM,aAAa,KAAK,KAAK,SAAS,CAAC,CAAC;AACxC,eAAO;AAAA,MACT;AAGA,YAAM,aAAa,KAAK,MAAM,kCAAkC;AAChE,UAAI,cAAc,IAAI,WAAW,QAAQ;AACvC,cAAM,kBAAkB,KAAK,WAAW,CAAC,CAAC;AAC1C,eAAO;AAAA,MACT;AAGA,YAAM,cAAc,KAAK,MAAM,mCAAmC;AAClE,UAAI,eAAe,IAAI,WAAW,QAAQ;AACxC,cAAM,mBAAmB,KAAK,YAAY,CAAC,CAAC;AAC5C,eAAO;AAAA,MACT;AAGA,UAAI,SAAS,OAAO,SAAS,eAAe;AAC1C,cAAM,YAAY,KAAK,YAAY;AACnC,eAAO;AAAA,MACT;AACA,UAAI,SAAS,cAAc;AACzB,cAAM,YAAY,KAAK,WAAW;AAClC,eAAO;AAAA,MACT;AACA,UAAI,SAAS,WAAW;AACtB,cAAM,YAAY,KAAK,QAAQ;AAC/B,eAAO;AAAA,MACT;AAGA,gBAAU,KAAK,aAAa,GAAG;AAC/B,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ,MAAM,gCAAgC,KAAK;AACnD,gBAAU,KAAK,yBAAyB,GAAG;AAC3C,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAsBO,SAAS,gBAAgB,SAA+C;AAC7E,QAAM;AAAA,IACJ;AAAA,IACA,OAAO;AAAA,IACP,UAAU,CAAC;AAAA,EACb,IAAI;AAEJ,MAAI,CAAC,IAAI;AACP,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AAGA,QAAM,YAAY,oBAAI,IAA6B;AACnD,aAAW,UAAU,SAAS;AAC5B,cAAU,IAAI,OAAO,OAAO,MAAM;AAAA,EACpC;AAEA,QAAM,gBAAgB,qBAAqB,IAAI,SAAS;AAGxD,QAAM,aAAS,0BAAa,CAAC,KAAK,QAAQ;AACxC,kBAAc,KAAK,GAAG,EAAE,MAAM,WAAS;AACrC,cAAQ,MAAM,gCAAgC,KAAK;AACnD,UAAI,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC;AACzD,UAAI,IAAI,KAAK,UAAU,EAAE,OAAO,wBAAwB,CAAC,CAAC;AAAA,IAC5D,CAAC;AAAA,EACH,CAAC;AAED,SAAO,OAAO,IAAI;AAElB,SAAO;AAAA,IACL,MAAM,QAAuB;AAC3B,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,eAAO,MAAM,CAAC,QAAQ;AACpB,cAAI,IAAK,QAAO,GAAG;AAAA,cACd,SAAQ;AAAA,QACf,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAAA,IAEA,IAAI,OAAe;AACjB,aAAO;AAAA,IACT;AAAA,EACF;AACF;AA0BO,SAAS,0BAA0B,SAA0D;AAClG,QAAM;AAAA,IACJ;AAAA,IACA,UAAU,CAAC;AAAA,IACX,WAAW;AAAA,EACb,IAAI;AAEJ,MAAI,CAAC,IAAI;AACP,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AAGA,QAAM,YAAY,oBAAI,IAA6B;AACnD,aAAW,UAAU,SAAS;AAC5B,cAAU,IAAI,OAAO,OAAO,MAAM;AAAA,EACpC;AAEA,QAAM,gBAAgB,qBAAqB,IAAI,WAAW,QAAQ;AAElE,SAAO,CAAC,KAAK,KAAK,SAAS;AACzB,kBAAc,KAAK,KAAK,IAAI,EAAE,MAAM,WAAS;AAC3C,cAAQ,MAAM,gCAAgC,KAAK;AACnD,UAAI,MAAM;AACR,aAAK;AAAA,MACP,OAAO;AACL,YAAI,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC;AACzD,YAAI,IAAI,KAAK,UAAU,EAAE,OAAO,wBAAwB,CAAC,CAAC;AAAA,MAC5D;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":["Database","import_kysely","import_kysely","fastq","import_kysely","__filename"]}

package/dist/index.d.cts

@@ -0,0 +1,368 @@
+import * as http from 'http';
+import * as better_sqlite3 from 'better-sqlite3';
+import { Kysely, Generated } from 'kysely';
+
+/**
+ * Job status types
+ */
+type JobStatus = 'ready' | 'running' | 'done' | 'failed' | 'dead';
+/**
+ * Database table schema for workmatic_jobs
+ */
+interface WorkmaticJobsTable {
+    id: Generated<number>;
+    public_id: string;
+    queue: string;
+    payload: string;
+    status: JobStatus;
+    priority: number;
+    run_at: number;
+    attempts: number;
+    max_attempts: number;
+    lease_until: number;
+    created_at: number;
+    updated_at: number;
+    last_error: string | null;
+}
+/**
+ * Database table schema for workmatic_settings
+ */
+interface WorkmaticSettingsTable {
+    queue: string;
+    paused: number;
+    updated_at: number;
+}
+/**
+ * Kysely database schema
+ */
+interface WorkmaticDatabase {
+    workmatic_jobs: WorkmaticJobsTable;
+    workmatic_settings: WorkmaticSettingsTable;
+}
+/**
+ * Kysely database instance type
+ */
+type WorkmaticDb = Kysely<WorkmaticDatabase>;
+/**
+ * Job representation returned to users
+ */
+interface Job<TPayload = unknown> {
+    /** Unique public identifier (nanoid) */
+    id: string;
+    /** Queue name */
+    queue: string;
+    /** Job payload */
+    payload: TPayload;
+    /** Current status */
+    status: JobStatus;
+    /** Priority (lower = higher priority) */
+    priority: number;
+    /** Number of attempts made */
+    attempts: number;
+    /** Maximum allowed attempts */
+    maxAttempts: number;
+    /** When the job was created (unix ms) */
+    createdAt: number;
+    /** Last error message if failed */
+    lastError: string | null;
+}
+/**
+ * Options for adding a job
+ */
+interface AddJobOptions {
+    /** Job priority (lower = higher priority). Default: 0 */
+    priority?: number;
+    /** Delay before job becomes available (ms). Default: 0 */
+    delayMs?: number;
+    /** Maximum retry attempts. Default: 3 */
+    maxAttempts?: number;
+}
+/**
+ * Result of adding a job
+ */
+interface AddJobResult {
+    ok: true;
+    id: string;
+}
+/**
+ * Options for creating a database
+ */
+interface DatabaseOptions {
+    /** Existing better-sqlite3 Database instance */
+    db?: better_sqlite3.Database;
+    /** Path to SQLite database file (ignored if db is provided) */
+    filename?: string;
+}
+/**
+ * Options for creating a client
+ */
+interface ClientOptions {
+    /** Kysely database instance */
+    db: WorkmaticDb;
+    /** Queue name. Default: 'default' */
+    queue?: string;
+}
+/**
+ * Backoff function type
+ */
+type BackoffFunction = (attempts: number) => number;
+/**
+ * Options for creating a worker
+ */
+interface WorkerOptions {
+    /** Kysely database instance */
+    db: WorkmaticDb;
+    /** Queue name. Default: 'default' */
+    queue?: string;
+    /** Number of concurrent job processors. Default: 1 */
+    concurrency?: number;
+    /** Lease duration in ms. Default: 30000 */
+    leaseMs?: number;
+    /** Poll interval in ms when no jobs available. Default: 1000 */
+    pollMs?: number;
+    /** Job execution timeout in ms. Default: undefined (no timeout) */
+    timeoutMs?: number;
+    /** Backoff function for retries. Default: exponential */
+    backoff?: BackoffFunction;
+}
+/**
+ * Job processor function type
+ */
+type JobProcessor<TPayload = unknown> = (job: Job<TPayload>) => Promise<void>;
+/**
+ * Stats by status
+ */
+interface JobStats {
+    ready: number;
+    running: number;
+    done: number;
+    failed: number;
+    dead: number;
+    total: number;
+}
+/**
+ * Client interface
+ */
+interface WorkmaticClient {
+    /** Add a job to the queue */
+    add<TPayload = unknown>(payload: TPayload, options?: AddJobOptions): Promise<AddJobResult>;
+    /** Get job statistics */
+    stats(): Promise<JobStats>;
+}
+/**
+ * Worker interface
+ */
+interface WorkmaticWorker {
+    /** Set the job processor function */
+    process<TPayload = unknown>(fn: JobProcessor<TPayload>): void;
+    /** Start processing jobs */
+    start(): void;
+    /** Stop processing jobs (drains current jobs) */
+    stop(): Promise<void>;
+    /** Pause processing (stops claiming new jobs) */
+    pause(): void;
+    /** Resume processing */
+    resume(): void;
+    /** Get job statistics */
+    stats(): Promise<JobStats>;
+    /** Check if worker is running */
+    readonly isRunning: boolean;
+    /** Check if worker is paused */
+    readonly isPaused: boolean;
+    /** Queue name */
+    readonly queue: string;
+}
+/**
+ * Options for creating a dashboard
+ */
+interface DashboardOptions {
+    /** Kysely database instance */
+    db: WorkmaticDb;
+    /** HTTP server port. Default: 3000 */
+    port?: number;
+    /** Worker instances to control */
+    workers?: WorkmaticWorker[];
+}
+/**
+ * Options for creating dashboard middleware
+ */
+interface DashboardMiddlewareOptions {
+    /** Kysely database instance */
+    db: WorkmaticDb;
+    /** Worker instances to control */
+    workers?: WorkmaticWorker[];
+    /** Base path for mounting (e.g., '/workmatic'). Default: '' */
+    basePath?: string;
+}
+/**
+ * Express-compatible request handler
+ */
+type DashboardMiddleware = (req: http.IncomingMessage, res: http.ServerResponse, next?: () => void) => void;
+/**
+ * Dashboard interface
+ */
+interface WorkmaticDashboard {
+    /** Close the dashboard server */
+    close(): Promise<void>;
+    /** Server port */
+    readonly port: number;
+}
+/**
+ * Internal job representation from database
+ */
+interface ClaimedJob {
+    id: number;
+    public_id: string;
+    queue: string;
+    payload: string;
+    attempts: number;
+    max_attempts: number;
+}
+
+/**
+ * Create and initialize the workmatic database
+ *
+ * @param options - Database options
+ * @returns Kysely database instance
+ *
+ * @example
+ * ```ts
+ * // Using a file path
+ * const db = createDatabase({ filename: './jobs.db' });
+ *
+ * // Using an existing better-sqlite3 instance
+ * import Database from 'better-sqlite3';
+ * const sqlite = new Database('./jobs.db');
+ * const db = createDatabase({ db: sqlite });
+ *
+ * // In-memory database (for testing)
+ * const db = createDatabase({ filename: ':memory:' });
+ * ```
+ */
+declare function createDatabase(options?: DatabaseOptions): WorkmaticDb;
+
+/**
+ * Create a job queue client for adding jobs
+ *
+ * @param options - Client options
+ * @returns Client instance
+ *
+ * @example
+ * ```ts
+ * const client = createClient({ db });
+ *
+ * // Add a simple job
+ * const result = await client.add({ email: 'user@example.com' });
+ * console.log(result.id); // Job public ID
+ *
+ * // Add a job with options
+ * await client.add(
+ *   { userId: 123 },
+ *   { priority: 1, delayMs: 5000, maxAttempts: 5 }
+ * );
+ *
+ * // Get queue statistics
+ * const stats = await client.stats();
+ * console.log(stats); // { ready: 5, running: 2, done: 100, ... }
+ * ```
+ */
+declare function createClient(options: ClientOptions): WorkmaticClient;
+
+/**
+ * Create a job queue worker for processing jobs
+ *
+ * @param options - Worker options
+ * @returns Worker instance
+ *
+ * @example
+ * ```ts
+ * const worker = createWorker({ db, concurrency: 4 });
+ *
+ * // Set the processor function
+ * worker.process(async (job) => {
+ *   console.log('Processing job:', job.id);
+ *   await sendEmail(job.payload.email);
+ * });
+ *
+ * // Start processing
+ * worker.start();
+ *
+ * // Later, gracefully stop
+ * await worker.stop();
+ * ```
+ */
+declare function createWorker(options: WorkerOptions): WorkmaticWorker;
+
+/**
+ * Create a dashboard HTTP server for monitoring and controlling the job queue
+ *
+ * @param options - Dashboard options
+ * @returns Dashboard instance
+ *
+ * @example
+ * ```ts
+ * const dashboard = createDashboard({
+ *   db,
+ *   port: 3000,
+ *   workers: [worker1, worker2]
+ * });
+ *
+ * console.log(`Dashboard running at http://localhost:${dashboard.port}`);
+ *
+ * // Later, close the server
+ * await dashboard.close();
+ * ```
+ */
+declare function createDashboard(options: DashboardOptions): WorkmaticDashboard;
+/**
+ * Create an Express-compatible middleware for the dashboard
+ *
+ * @param options - Middleware options
+ * @returns Express middleware function
+ *
+ * @example
+ * ```ts
+ * import express from 'express';
+ * import { createDashboardMiddleware } from 'workmatic';
+ *
+ * const app = express();
+ *
+ * // Mount dashboard at /workmatic
+ * app.use(createDashboardMiddleware({
+ *   db,
+ *   basePath: '/workmatic',
+ *   workers: [worker]
+ * }));
+ *
+ * app.listen(3000);
+ * // Dashboard available at http://localhost:3000/workmatic
+ * ```
+ */
+declare function createDashboardMiddleware(options: DashboardMiddlewareOptions): DashboardMiddleware;
+
+/**
+ * Default exponential backoff function
+ * Returns delay in milliseconds: 1000 * 2^attempts
+ *
+ * @param attempts - Number of failed attempts
+ * @returns Delay in milliseconds
+ *
+ * @example
+ * ```ts
+ * defaultBackoff(0) // 1000ms (1 second)
+ * defaultBackoff(1) // 2000ms (2 seconds)
+ * defaultBackoff(2) // 4000ms (4 seconds)
+ * defaultBackoff(3) // 8000ms (8 seconds)
+ * ```
+ */
+declare const defaultBackoff: BackoffFunction;
+/**
+ * Validate that a payload is JSON-serializable
+ *
+ * @param payload - The payload to validate
+ * @throws Error if payload cannot be serialized to JSON
+ * @returns The JSON string representation
+ */
+declare function validatePayload(payload: unknown): string;
+
+export { type AddJobOptions, type AddJobResult, type BackoffFunction, type ClaimedJob, type ClientOptions, type DashboardMiddleware, type DashboardMiddlewareOptions, type DashboardOptions, type DatabaseOptions, type Job, type JobProcessor, type JobStats, type JobStatus, type WorkerOptions, type WorkmaticClient, type WorkmaticDashboard, type WorkmaticDatabase, type WorkmaticDb, type WorkmaticJobsTable, type WorkmaticWorker, createClient, createDashboard, createDashboardMiddleware, createDatabase, createWorker, defaultBackoff, validatePayload };