@happyvertical/jobs 0.74.8

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/worker.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport { createId } from '@happyvertical/utils';\nimport { fromConfig } from './retry.js';\nimport type {\n  Worker as IWorker,\n  Job,\n  JobHandler,\n  JobStore,\n  WorkerConfig,\n} from './types.js';\n\n/**\n * Worker events\n */\nexport interface WorkerEvents {\n  'job:started': (job: Job) => void;\n  'job:completed': (job: Job, result: unknown) => void;\n  'job:failed': (job: Job, error: Error) => void;\n  'job:retrying': (job: Job, error: Error, delay: number) => void;\n  'worker:started': () => void;\n  'worker:stopped': () => void;\n  'worker:error': (error: Error) => void;\n}\n\n/**\n * Default worker configuration\n */\nconst DEFAULT_CONFIG: Required<WorkerConfig> = {\n  id: '',\n  concurrency: 5,\n  queues: ['default'],\n  pollInterval: 1000,\n  heartbeatInterval: 30000,\n  shutdownTimeout: 30000,\n};\n\n/**\n * Job worker that processes jobs from a store\n */\nexport class JobWorker extends EventEmitter implements IWorker {\n  readonly id: string;\n  private readonly store: JobStore;\n  private readonly handler: JobHandler;\n  private readonly config: Required<WorkerConfig>;\n  private running = false;\n  private activeJobs = new Map<string, Job>();\n  private pollTimer: NodeJS.Timeout | null = null;\n  private heartbeatTimer: NodeJS.Timeout | null = null;\n  private shutdownPromise: Promise<void> | null = null;\n\n  constructor(store: JobStore, handler: JobHandler, config: WorkerConfig = {}) {\n    super();\n    this.store = store;\n    this.handler = handler;\n    this.config = {\n      ...DEFAULT_CONFIG,\n      ...config,\n      id: config.id || `worker_${createId().slice(0, 8)}`,\n    };\n    this.id = this.config.id;\n  }\n\n  /**\n   * Start processing jobs\n   */\n  async start(): Promise<void> {\n    if (this.running) return;\n\n    this.running = true;\n\n    // Subscribe to store events for push-based notifications\n    this.store.subscribe(async (event) => {\n      if (event.type === 'job.ready' && this.running) {\n        // Immediately try to dequeue when a job becomes ready\n        await this.poll();\n      }\n    });\n\n    // Start polling loop\n    this.startPolling();\n\n    // Start heartbeat loop\n    this.startHeartbeat();\n\n    this.emit('worker:started');\n  }\n\n  /**\n   * Stop processing jobs (graceful shutdown)\n   */\n  async stop(): Promise<void> {\n    if (!this.running) return;\n    if (this.shutdownPromise) return this.shutdownPromise;\n\n    this.running = false;\n\n    // Stop timers\n    if (this.pollTimer) {\n      clearTimeout(this.pollTimer);\n      this.pollTimer = null;\n    }\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = null;\n    }\n\n    // Wait for active jobs to complete (with timeout)\n    this.shutdownPromise = this.waitForActiveJobs();\n\n    try {\n      await this.shutdownPromise;\n    } finally {\n      this.shutdownPromise = null;\n      this.emit('worker:stopped');\n    }\n  }\n\n  /**\n   * Check if worker is running\n   */\n  isRunning(): boolean {\n    return this.running;\n  }\n\n  /**\n   * Get count of active jobs\n   */\n  activeJobCount(): number {\n    return this.activeJobs.size;\n  }\n\n  /**\n   * Start the polling loop\n   */\n  private startPolling(): void {\n    const scheduleNextPoll = () => {\n      if (!this.running) return;\n\n      if (!this.store.waitForUpdate) {\n        this.pollTimer = setTimeout(poll, this.config.pollInterval);\n        return;\n      }\n\n      this.pollTimer = setTimeout(() => {\n        void waitThenPoll();\n      }, 0);\n    };\n\n    const waitThenPoll = async () => {\n      try {\n        await this.store.waitForUpdate?.(this.config.pollInterval);\n      } catch (error) {\n        this.emit('worker:error', error as Error);\n      }\n\n      if (this.running) {\n        await poll();\n      }\n    };\n\n    const poll = async () => {\n      if (!this.running) return;\n\n      try {\n        await this.poll();\n      } catch (error) {\n        this.emit('worker:error', error as Error);\n      }\n\n      // Schedule next poll\n      scheduleNextPoll();\n    };\n\n    // Start immediately\n    poll();\n  }\n\n  /**\n   * Poll for and process jobs\n   */\n  private async poll(): Promise<void> {\n    // Calculate how many jobs we can take\n    const available = this.config.concurrency - this.activeJobs.size;\n    if (available <= 0) return;\n\n    // Dequeue jobs\n    const jobs = await this.store.dequeue(\n      this.config.queues,\n      available,\n      this.id,\n    );\n\n    // Process each job concurrently\n    for (const job of jobs) {\n      this.processJob(job);\n    }\n  }\n\n  /**\n   * Process a single job\n   */\n  private async processJob(job: Job): Promise<void> {\n    this.activeJobs.set(job.id, job);\n    this.emit('job:started', job);\n\n    let timeoutId: NodeJS.Timeout | null = null;\n\n    try {\n      // Set up timeout with cleanup capability\n      const timeoutPromise = new Promise<never>((_, reject) => {\n        timeoutId = setTimeout(() => {\n          reject(new Error(`Job timeout after ${job.timeout}ms`));\n        }, job.timeout);\n      });\n\n      // Execute handler with timeout\n      const result = await Promise.race([this.handler(job), timeoutPromise]);\n\n      // Job completed successfully\n      await this.store.update(job.id, {\n        status: 'completed',\n        completedAt: new Date(),\n        resultPointer: result.resultPointer ?? null,\n      });\n\n      this.emit('job:completed', job, result.result);\n    } catch (error) {\n      await this.handleJobError(job, error as Error);\n    } finally {\n      // Clean up timeout timer to prevent memory leak\n      if (timeoutId) {\n        clearTimeout(timeoutId);\n      }\n      this.activeJobs.delete(job.id);\n    }\n  }\n\n  /**\n   * Handle job execution error\n   */\n  private async handleJobError(job: Job, error: Error): Promise<void> {\n    const strategy = fromConfig(job.retryStrategy);\n    const decision = strategy.shouldRetry(job.attempts, error);\n\n    if (decision.shouldRetry && job.attempts < job.maxAttempts) {\n      // Schedule retry\n      const nextRunAt = new Date(Date.now() + decision.delay);\n\n      await this.store.update(job.id, {\n        status: 'pending',\n        lastError: error.message,\n        runAt: nextRunAt,\n        workerId: null,\n        workerHeartbeat: null,\n      });\n\n      this.emit('job:retrying', job, error, decision.delay);\n    } else {\n      // Job failed permanently\n      await this.store.update(job.id, {\n        status: 'failed',\n        completedAt: new Date(),\n        lastError: error.message,\n      });\n\n      this.emit('job:failed', job, error);\n    }\n  }\n\n  /**\n   * Start heartbeat loop to keep jobs alive\n   */\n  private startHeartbeat(): void {\n    this.heartbeatTimer = setInterval(async () => {\n      for (const [jobId] of this.activeJobs) {\n        try {\n          await this.store.heartbeat(jobId, this.id);\n        } catch (error) {\n          // Log heartbeat errors but don't interrupt job processing\n          console.warn(`Heartbeat failed for job ${jobId}:`, error);\n        }\n      }\n    }, this.config.heartbeatInterval);\n  }\n\n  /**\n   * Wait for active jobs to complete with timeout\n   */\n  private async waitForActiveJobs(): Promise<void> {\n    if (this.activeJobs.size === 0) return;\n\n    return new Promise((resolve) => {\n      const checkInterval = setInterval(() => {\n        if (this.activeJobs.size === 0) {\n          clearInterval(checkInterval);\n          clearTimeout(timeout);\n          resolve();\n        }\n      }, 100);\n\n      const timeout = setTimeout(() => {\n        clearInterval(checkInterval);\n        console.warn(\n          `Shutdown timeout: ${this.activeJobs.size} jobs still active`,\n        );\n        resolve();\n      }, this.config.shutdownTimeout);\n    });\n  }\n}\n\n/**\n * Create a job worker\n */\nexport function createWorker(\n  store: JobStore,\n  handler: JobHandler,\n  config?: WorkerConfig,\n): JobWorker {\n  return new JobWorker(store, handler, config);\n}\n"],"names":[],"mappings":"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"}

package/dist/retry.d.ts

@@ -0,0 +1,84 @@
+import { RetryDecision, RetryStrategy, RetryStrategyConfig } from './types.js';
+/**
+ * Options for exponential backoff retry strategy
+ */
+export interface ExponentialBackoffOptions {
+    /** Initial delay in milliseconds (default: 1000) */
+    initialDelay?: number;
+    /** Maximum delay in milliseconds (default: 300000 = 5 minutes) */
+    maxDelay?: number;
+    /** Multiplier for each attempt (default: 2) */
+    multiplier?: number;
+    /** Add random jitter to prevent thundering herd (default: true) */
+    jitter?: boolean;
+    /** Maximum attempts (optional, can also be set on job) */
+    maxAttempts?: number;
+}
+/**
+ * Options for linear retry strategy
+ */
+export interface LinearBackoffOptions {
+    /** Fixed delay between retries in milliseconds (default: 5000) */
+    delay?: number;
+    /** Maximum attempts (optional) */
+    maxAttempts?: number;
+}
+/**
+ * Custom retry decision function
+ */
+export type CustomRetryFn = (attempt: number, error: Error) => RetryDecision;
+/**
+ * Create an exponential backoff retry strategy
+ *
+ * @example
+ * ```typescript
+ * const strategy = exponential({
+ *   initialDelay: 1000,
+ *   maxDelay: 300000,
+ *   multiplier: 2,
+ *   jitter: true,
+ * });
+ * ```
+ */
+export declare function exponential(options?: ExponentialBackoffOptions): RetryStrategy;
+/**
+ * Create a linear retry strategy with fixed delay
+ *
+ * @example
+ * ```typescript
+ * const strategy = linear({ delay: 5000 });
+ * ```
+ */
+export declare function linear(options?: LinearBackoffOptions): RetryStrategy;
+/**
+ * Create a custom retry strategy
+ *
+ * @example
+ * ```typescript
+ * const strategy = custom((attempt, error) => {
+ *   if (error.message.includes('RATE_LIMITED')) {
+ *     return { shouldRetry: true, delay: 60000 };
+ *   }
+ *   return { shouldRetry: attempt < 3, delay: attempt * 1000 };
+ * });
+ * ```
+ */
+export declare function custom(fn: CustomRetryFn): RetryStrategy;
+/**
+ * Create a no-retry strategy
+ *
+ * @example
+ * ```typescript
+ * const strategy = noRetry();
+ * ```
+ */
+export declare function noRetry(): RetryStrategy;
+/**
+ * Reconstruct a retry strategy from its config
+ */
+export declare function fromConfig(config: RetryStrategyConfig): RetryStrategy;
+/**
+ * Default retry strategy
+ */
+export declare const DEFAULT_RETRY_STRATEGY: RetryStrategy;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA0DD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmCD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC;AAiD7E;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,OAAO,CAAC,EAAE,yBAAyB,GAClC,aAAa,CAEf;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAEpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,aAAa,GAAG,aAAa,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,IAAI,aAAa,CAEvC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAkBrE;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,eAKjC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,311 @@
+/**
+ * Job status enum
+ */
+export type JobStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Timeout behavior when a job exceeds its timeout
+ */
+export type TimeoutBehavior = 'fail' | 'kill' | 'warn';
+/**
+ * Priority levels for jobs
+ */
+export type JobPriority = 'low' | 'normal' | 'high' | 'critical';
+/**
+ * Retry strategy configuration
+ */
+export interface RetryStrategyConfig {
+    type: 'exponential' | 'linear' | 'custom';
+    config: Record<string, unknown>;
+}
+/**
+ * Result of a retry strategy calculation
+ */
+export interface RetryDecision {
+    shouldRetry: boolean;
+    delay: number;
+}
+/**
+ * Retry strategy interface
+ */
+export interface RetryStrategy {
+    /**
+     * Determine whether to retry and how long to wait
+     * @param attempt Current attempt number (1-based)
+     * @param error The error that caused the failure
+     */
+    shouldRetry(attempt: number, error: Error): RetryDecision;
+    /**
+     * Serialize the strategy for storage
+     */
+    toConfig(): RetryStrategyConfig;
+}
+/**
+ * Job payload - what work to execute
+ */
+export interface JobPayload {
+    /** The type of object (e.g., 'Document', 'Agent') */
+    objectType: string;
+    /** Instance ID (null for singleton/static methods) */
+    objectId: string | null;
+    /** Method name to execute */
+    method: string;
+    /** Arguments to pass to the method */
+    args: Record<string, unknown>;
+}
+/**
+ * Core job interface
+ */
+export interface Job {
+    /** Unique job identifier */
+    id: string;
+    /** Queue name this job belongs to */
+    queue: string;
+    /** The work to execute */
+    payload: JobPayload;
+    /** Current job status */
+    status: JobStatus;
+    /** Priority (higher = more important) */
+    priority: number;
+    /** Number of execution attempts */
+    attempts: number;
+    /** Maximum attempts before giving up */
+    maxAttempts: number;
+    /** When to run the job (for delayed jobs) */
+    runAt: Date;
+    /** When the job started executing */
+    startedAt: Date | null;
+    /** When the job completed/failed */
+    completedAt: Date | null;
+    /** Timeout in milliseconds */
+    timeout: number;
+    /** What to do when timeout is exceeded */
+    timeoutBehavior: TimeoutBehavior;
+    /** Last error message if failed */
+    lastError: string | null;
+    /** URI pointer to result storage */
+    resultPointer: string | null;
+    /** Retry strategy configuration */
+    retryStrategy: RetryStrategyConfig;
+    /** Worker ID currently processing this job */
+    workerId: string | null;
+    /** Last heartbeat from worker */
+    workerHeartbeat: Date | null;
+    /** When the job was created */
+    createdAt: Date;
+    /** When the job was last updated */
+    updatedAt: Date;
+}
+/**
+ * Options for creating a new job
+ */
+export interface JobCreateOptions {
+    /** Queue name (default: 'default') */
+    queue?: string;
+    /** Job payload */
+    payload: JobPayload;
+    /** Priority level or number */
+    priority?: JobPriority | number;
+    /** When to run (default: now) */
+    runAt?: Date;
+    /** Maximum attempts (default: 3) */
+    maxAttempts?: number;
+    /** Timeout in ms (default: 300000) */
+    timeout?: number;
+    /** Timeout behavior (default: 'fail') */
+    timeoutBehavior?: TimeoutBehavior;
+    /** Retry strategy */
+    retryStrategy?: RetryStrategy | RetryStrategyConfig;
+}
+/**
+ * Filter options for listing jobs
+ */
+export interface JobFilter {
+    /** Filter by queue */
+    queue?: string;
+    /** Filter by status */
+    status?: JobStatus | JobStatus[];
+    /** Filter by object type */
+    objectType?: string;
+    /** Filter by method */
+    method?: string;
+    /** Jobs created after this date */
+    createdAfter?: Date;
+    /** Jobs created before this date */
+    createdBefore?: Date;
+    /** Maximum number of jobs to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Order by field */
+    orderBy?: 'createdAt' | 'runAt' | 'priority' | 'attempts';
+    /** Order direction */
+    orderDir?: 'asc' | 'desc';
+}
+/**
+ * Options for job cleanup
+ */
+export interface CleanupOptions {
+    /** Delete completed jobs older than this */
+    completedBefore?: Date;
+    /** Delete failed jobs older than this */
+    failedBefore?: Date;
+    /** Delete cancelled jobs older than this */
+    cancelledBefore?: Date;
+    /** Maximum jobs to delete in one operation */
+    limit?: number;
+}
+/**
+ * Job event types
+ */
+export type JobEventType = 'job.created' | 'job.ready' | 'job.started' | 'job.completed' | 'job.failed' | 'job.cancelled' | 'job.retrying';
+/**
+ * Job event payload
+ */
+export interface JobEvent {
+    type: JobEventType;
+    job: Job;
+    timestamp: Date;
+    /** Error details for failed events */
+    error?: string;
+    /** Result pointer for completed events */
+    resultPointer?: string;
+}
+/**
+ * Job event listener callback
+ */
+export type JobEventListener = (event: JobEvent) => void | Promise<void>;
+/**
+ * Unsubscribe function returned by subscribe
+ */
+export type Unsubscribe = () => void;
+/**
+ * Job handle returned from enqueue operations
+ */
+export interface JobHandle {
+    /** Job ID */
+    id: string;
+    /** Get current job status */
+    status(): Promise<JobStatus>;
+    /** Get full job details */
+    get(): Promise<Job | null>;
+    /** Wait for job completion */
+    wait(options?: {
+        timeout?: number;
+    }): Promise<unknown>;
+    /** Cancel the job */
+    cancel(): Promise<void>;
+}
+/**
+ * Abstract job store interface that adapters implement
+ */
+export interface JobStore {
+    /**
+     * Initialize the store (create tables, etc.)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Enqueue a new job
+     */
+    enqueue(options: JobCreateOptions): Promise<Job>;
+    /**
+     * Dequeue jobs ready for processing
+     * @param queues Queue names to dequeue from (in priority order)
+     * @param limit Maximum jobs to dequeue
+     * @param workerId Worker ID claiming the jobs
+     */
+    dequeue(queues: string[], limit: number, workerId: string): Promise<Job[]>;
+    /**
+     * Update a job
+     */
+    update(id: string, updates: Partial<Job>): Promise<Job>;
+    /**
+     * Get a job by ID
+     */
+    get(id: string): Promise<Job | null>;
+    /**
+     * List jobs with filtering
+     */
+    list(filter: JobFilter): Promise<Job[]>;
+    /**
+     * Cancel a job
+     */
+    cancel(id: string): Promise<void>;
+    /**
+     * Clean up old jobs
+     */
+    cleanup(options: CleanupOptions): Promise<number>;
+    /**
+     * Subscribe to job events
+     */
+    subscribe(listener: JobEventListener): Unsubscribe;
+    /**
+     * Wait for a store-level update signal, if the adapter supports one.
+     * Adapters without push notifications may omit this and rely on polling.
+     */
+    waitForUpdate?(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Update worker heartbeat for a job
+     */
+    heartbeat(jobId: string, workerId: string): Promise<void>;
+    /**
+     * Get queue statistics
+     */
+    stats(queue?: string): Promise<QueueStats>;
+    /**
+     * Close the store and release resources
+     */
+    close(): Promise<void>;
+}
+/**
+ * Queue statistics
+ */
+export interface QueueStats {
+    pending: number;
+    running: number;
+    completed: number;
+    failed: number;
+    cancelled: number;
+    avgDuration: number | null;
+}
+/**
+ * Worker configuration
+ */
+export interface WorkerConfig {
+    /** Unique worker ID */
+    id?: string;
+    /** Number of concurrent jobs */
+    concurrency?: number;
+    /** Queues to process (in priority order) */
+    queues?: string[];
+    /** Poll interval for non-push stores (ms) */
+    pollInterval?: number;
+    /** Heartbeat interval (ms) */
+    heartbeatInterval?: number;
+    /** Shutdown timeout (ms) */
+    shutdownTimeout?: number;
+}
+/**
+ * Job handler function
+ */
+export type JobHandler = (job: Job) => Promise<{
+    result?: unknown;
+    resultPointer?: string;
+}>;
+/**
+ * Worker interface
+ */
+export interface Worker {
+    /** Worker ID */
+    id: string;
+    /** Start processing jobs */
+    start(): Promise<void>;
+    /** Stop processing jobs (graceful shutdown) */
+    stop(): Promise<void>;
+    /** Check if worker is running */
+    isRunning(): boolean;
+    /** Register event listener */
+    on(event: string, listener: (...args: unknown[]) => void): void;
+    /** Remove event listener */
+    off(event: string, listener: (...args: unknown[]) => void): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/worker.d.ts

@@ -0,0 +1,74 @@
+import { EventEmitter } from 'node:events';
+import { Worker as IWorker, Job, JobHandler, JobStore, WorkerConfig } from './types.js';
+/**
+ * Worker events
+ */
+export interface WorkerEvents {
+    'job:started': (job: Job) => void;
+    'job:completed': (job: Job, result: unknown) => void;
+    'job:failed': (job: Job, error: Error) => void;
+    'job:retrying': (job: Job, error: Error, delay: number) => void;
+    'worker:started': () => void;
+    'worker:stopped': () => void;
+    'worker:error': (error: Error) => void;
+}
+/**
+ * Job worker that processes jobs from a store
+ */
+export declare class JobWorker extends EventEmitter implements IWorker {
+    readonly id: string;
+    private readonly store;
+    private readonly handler;
+    private readonly config;
+    private running;
+    private activeJobs;
+    private pollTimer;
+    private heartbeatTimer;
+    private shutdownPromise;
+    constructor(store: JobStore, handler: JobHandler, config?: WorkerConfig);
+    /**
+     * Start processing jobs
+     */
+    start(): Promise<void>;
+    /**
+     * Stop processing jobs (graceful shutdown)
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if worker is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get count of active jobs
+     */
+    activeJobCount(): number;
+    /**
+     * Start the polling loop
+     */
+    private startPolling;
+    /**
+     * Poll for and process jobs
+     */
+    private poll;
+    /**
+     * Process a single job
+     */
+    private processJob;
+    /**
+     * Handle job execution error
+     */
+    private handleJobError;
+    /**
+     * Start heartbeat loop to keep jobs alive
+     */
+    private startHeartbeat;
+    /**
+     * Wait for active jobs to complete with timeout
+     */
+    private waitForActiveJobs;
+}
+/**
+ * Create a job worker
+ */
+export declare function createWorker(store: JobStore, handler: JobHandler, config?: WorkerConfig): JobWorker;
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EACV,MAAM,IAAI,OAAO,EACjB,GAAG,EACH,UAAU,EACV,QAAQ,EACR,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAClC,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/C,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC;AAcD;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAa,YAAW,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAA8B;gBAEzC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAE,YAAiB;IAY3E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2CpB;;OAEG;YACW,IAAI;IAkBlB;;OAEG;YACW,UAAU;IAoCxB;;OAEG;YACW,cAAc;IA6B5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;YACW,iBAAiB;CAqBhC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,UAAU,EACnB,MAAM,CAAC,EAAE,YAAY,GACpB,SAAS,CAEX"}

package/metadata.json

@@ -0,0 +1,34 @@
+{
+  "name": "@happyvertical/jobs",
+  "path": "packages/jobs",
+  "position": {
+    "index": 16,
+    "count": 30
+  },
+  "description": "Job queue abstraction with multiple backend adapters (SQLite, PostgreSQL, Bull, SQS)",
+  "provides": [
+    "Job queue abstraction with multiple backend adapters (SQLite, PostgreSQL, Bull, SQS)"
+  ],
+  "implements": [],
+  "requires": {
+    "workspace": [
+      "@happyvertical/sql",
+      "@happyvertical/utils"
+    ],
+    "externalHappyVertical": [],
+    "external": [
+      "@aws-sdk/client-sqs",
+      "@google-cloud/tasks",
+      "bull",
+      "bullmq"
+    ]
+  },
+  "dependents": [],
+  "stability": {
+    "level": "stable",
+    "reason": "Primary package surface is described as implemented and production-oriented."
+  },
+  "keywords": [
+    "jobs"
+  ]
+}

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@happyvertical/jobs",
+  "version": "0.74.8",
+  "description": "Job queue abstraction with multiple backend adapters (SQLite, PostgreSQL, Bull, SQS)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "AGENT.md",
+    "metadata.json"
+  ],
+  "bin": {
+    "have-jobs-context": "./dist/cli/claude-context.js"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/sdk.git",
+    "directory": "packages/jobs"
+  },
+  "bugs": {
+    "url": "https://github.com/happyvertical/sdk/issues"
+  },
+  "homepage": "https://github.com/happyvertical/sdk/tree/main/packages/jobs#readme",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./sqlite": {
+      "import": "./dist/adapters/sqlite.js",
+      "types": "./dist/adapters/sqlite.d.ts"
+    },
+    "./postgres": {
+      "import": "./dist/adapters/postgres.js",
+      "types": "./dist/adapters/postgres.d.ts"
+    },
+    "./bull": {
+      "import": "./dist/adapters/bull.js",
+      "types": "./dist/adapters/bull.d.ts"
+    },
+    "./bullmq": {
+      "import": "./dist/adapters/bullmq.js",
+      "types": "./dist/adapters/bullmq.d.ts"
+    },
+    "./sqs": {
+      "import": "./dist/adapters/sqs.js",
+      "types": "./dist/adapters/sqs.d.ts"
+    },
+    "./cloud-tasks": {
+      "import": "./dist/adapters/cloud-tasks.js",
+      "types": "./dist/adapters/cloud-tasks.d.ts"
+    }
+  },
+  "keywords": [
+    "jobs",
+    "queue",
+    "background",
+    "worker",
+    "task"
+  ],
+  "author": "willgriffin@gmail.com",
+  "license": "ISC",
+  "dependencies": {
+    "@happyvertical/sql": "0.74.8",
+    "@happyvertical/utils": "0.74.8"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-sqs": "^3.1034.0",
+    "@google-cloud/tasks": "^6.2.1",
+    "@types/bull": "^4.10.4",
+    "@types/node": "25.0.10",
+    "bull": "^4.16.5",
+    "bullmq": "^5.76.0",
+    "typescript": "^5.9.3",
+    "vite": "7.3.2",
+    "vite-plugin-dts": "4.5.4",
+    "vitest": "^4.1.5"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-sqs": ">=3.1034.0",
+    "@google-cloud/tasks": ">=4.1.0",
+    "bull": ">=4.16.5",
+    "bullmq": ">=5.76.0"
+  },
+  "peerDependenciesMeta": {
+    "bull": {
+      "optional": true
+    },
+    "bullmq": {
+      "optional": true
+    },
+    "@aws-sdk/client-sqs": {
+      "optional": true
+    },
+    "@google-cloud/tasks": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "test": "npx vitest run",
+    "test:watch": "npx vitest",
+    "build": "vite build",
+    "build:watch": "vite build --watch",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "dev": "npm run build:watch & npm run test:watch"
+  }
+}