glasswork 0.12.0 → 0.12.2

package/dist/jobs/job-service.d.ts

@@ -0,0 +1,44 @@
+import type { Duration, EnqueueResult, JobDefinition, QueueDriver } from './types.js';
+export interface JobServiceConfig {
+    /** Default queue name when a job does not specify one */
+    defaultQueue?: string;
+    /** Override the payload size limit (defaults to 256KB) */
+    maxPayloadBytes?: number;
+}
+export interface JobServiceHooks {
+    /** Called after a job is successfully enqueued */
+    onEnqueued?: <TPayload>(job: JobDefinition<TPayload>, payload: TPayload, result: EnqueueResult) => Promise<void> | void;
+}
+/**
+ * Service responsible for enqueuing jobs.
+ */
+export declare class JobService {
+    private readonly driver;
+    private readonly hooks?;
+    private readonly defaultQueue;
+    private readonly maxPayloadBytes;
+    constructor(driver: QueueDriver, config?: JobServiceConfig, hooks?: JobServiceHooks | undefined);
+    /**
+     * Enqueue a job for immediate processing.
+     */
+    enqueue<TPayload>(job: JobDefinition<TPayload>, payload: TPayload): Promise<EnqueueResult>;
+    /**
+     * Enqueue a job to run after a delay.
+     */
+    enqueueIn<TPayload>(job: JobDefinition<TPayload>, payload: TPayload, delay: Duration): Promise<EnqueueResult>;
+    /**
+     * Enqueue a job to run at a specific time.
+     */
+    enqueueAt<TPayload>(job: JobDefinition<TPayload>, payload: TPayload, at: Date): Promise<EnqueueResult>;
+    /**
+     * Enqueue multiple jobs sequentially.
+     */
+    enqueueBatch<TPayload>(jobs: Array<{
+        job: JobDefinition<TPayload>;
+        payload: TPayload;
+    }>): Promise<EnqueueResult[]>;
+    private validatePayload;
+    private validatePayloadSize;
+    private getJobId;
+}
+//# sourceMappingURL=job-service.d.ts.map

package/dist/jobs/job-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-service.d.ts","sourceRoot":"","sources":["../../src/jobs/job-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAKtF,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,UAAU,CAAC,EAAE,CAAC,QAAQ,EACpB,GAAG,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC5B,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,aAAa,KAClB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,UAAU;IAKnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IANzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAGtB,MAAM,EAAE,WAAW,EACpC,MAAM,GAAE,gBAAqB,EACZ,KAAK,CAAC,EAAE,eAAe,YAAA;IAM1C;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBhG;;OAEG;IACG,SAAS,CAAC,QAAQ,EACtB,GAAG,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC5B,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,aAAa,CAAC;IA0BzB;;OAEG;IACG,SAAS,CAAC,QAAQ,EACtB,GAAG,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC5B,OAAO,EAAE,QAAQ,EACjB,EAAE,EAAE,IAAI,GACP,OAAO,CAAC,aAAa,CAAC;IA0BzB;;OAEG;IACG,YAAY,CAAC,QAAQ,EACzB,IAAI,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QAAC,OAAO,EAAE,QAAQ,CAAA;KAAE,CAAC,GAC/D,OAAO,CAAC,aAAa,EAAE,CAAC;IAI3B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/jobs/job-service.js

@@ -0,0 +1,105 @@
+import { safeParse } from 'valibot';
+import { InvalidJobPayloadError, PayloadTooLargeError } from './errors.js';
+import { calculatePayloadSizeBytes, durationToSeconds } from './utils.js';
+const DEFAULT_MAX_PAYLOAD_BYTES = 256 * 1024; // 256KB
+/**
+ * Service responsible for enqueuing jobs.
+ */
+export class JobService {
+    driver;
+    hooks;
+    defaultQueue;
+    maxPayloadBytes;
+    constructor(driver, config = {}, hooks) {
+        this.driver = driver;
+        this.hooks = hooks;
+        this.defaultQueue = config.defaultQueue ?? 'default';
+        this.maxPayloadBytes = config.maxPayloadBytes ?? DEFAULT_MAX_PAYLOAD_BYTES;
+    }
+    /**
+     * Enqueue a job for immediate processing.
+     */
+    async enqueue(job, payload) {
+        this.validatePayload(job, payload);
+        this.validatePayloadSize(payload);
+        const queue = job.queue ?? this.defaultQueue;
+        const jobId = this.getJobId(job, payload);
+        const result = await this.driver.enqueue({
+            jobName: job.name,
+            payload,
+            queue,
+            jobId,
+        });
+        await this.hooks?.onEnqueued?.(job, payload, result);
+        return result;
+    }
+    /**
+     * Enqueue a job to run after a delay.
+     */
+    async enqueueIn(job, payload, delay) {
+        this.validatePayload(job, payload);
+        this.validatePayloadSize(payload);
+        if (!this.driver.enqueueIn) {
+            const seconds = durationToSeconds(delay);
+            return this.enqueueAt(job, payload, new Date(Date.now() + seconds * 1000));
+        }
+        const queue = job.queue ?? this.defaultQueue;
+        const jobId = this.getJobId(job, payload);
+        const result = await this.driver.enqueueIn({
+            jobName: job.name,
+            payload,
+            queue,
+            jobId,
+        }, delay);
+        await this.hooks?.onEnqueued?.(job, payload, result);
+        return result;
+    }
+    /**
+     * Enqueue a job to run at a specific time.
+     */
+    async enqueueAt(job, payload, at) {
+        this.validatePayload(job, payload);
+        this.validatePayloadSize(payload);
+        if (!this.driver.enqueueAt) {
+            const delaySeconds = Math.max(0, Math.floor((at.getTime() - Date.now()) / 1000));
+            return this.enqueueIn(job, payload, delaySeconds);
+        }
+        const queue = job.queue ?? this.defaultQueue;
+        const jobId = this.getJobId(job, payload);
+        const result = await this.driver.enqueueAt({
+            jobName: job.name,
+            payload,
+            queue,
+            jobId,
+        }, at);
+        await this.hooks?.onEnqueued?.(job, payload, result);
+        return result;
+    }
+    /**
+     * Enqueue multiple jobs sequentially.
+     */
+    async enqueueBatch(jobs) {
+        return Promise.all(jobs.map(({ job, payload }) => this.enqueue(job, payload)));
+    }
+    validatePayload(job, payload) {
+        if (job.schema) {
+            const result = safeParse(job.schema, payload);
+            if (!result.success) {
+                throw new InvalidJobPayloadError(job.name, result.issues);
+            }
+        }
+    }
+    validatePayloadSize(payload) {
+        const sizeBytes = calculatePayloadSizeBytes(payload);
+        if (sizeBytes > this.maxPayloadBytes) {
+            throw new PayloadTooLargeError(sizeBytes, this.maxPayloadBytes);
+        }
+    }
+    getJobId(job, payload) {
+        if (job.unique) {
+            return job.unique.key(payload);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=job-service.js.map

package/dist/jobs/job-service.js.map

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

package/dist/jobs/periodic-job.d.ts

@@ -0,0 +1,6 @@
+import type { JobDefinition } from './types.js';
+/**
+ * Define a periodic job (typically triggered by EventBridge).
+ */
+export declare function definePeriodicJob(config: Pick<JobDefinition<undefined>, 'name' | 'queue' | 'handler'>): JobDefinition<undefined>;
+//# sourceMappingURL=periodic-job.d.ts.map

package/dist/jobs/periodic-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodic-job.d.ts","sourceRoot":"","sources":["../../src/jobs/periodic-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GACnE,aAAa,CAAC,SAAS,CAAC,CAM1B"}

package/dist/jobs/periodic-job.js

@@ -0,0 +1,11 @@
+/**
+ * Define a periodic job (typically triggered by EventBridge).
+ */
+export function definePeriodicJob(config) {
+    return {
+        name: config.name,
+        queue: config.queue,
+        handler: config.handler,
+    };
+}
+//# sourceMappingURL=periodic-job.js.map

package/dist/jobs/periodic-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"periodic-job.js","sourceRoot":"","sources":["../../src/jobs/periodic-job.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAoE;IAEpE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC"}

package/dist/jobs/schedule-constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared constants for job scheduling metadata.
+ */
+export declare const RUN_AT_METADATA_KEY = "__glassworkRunAt";
+/**
+ * SQS supports a maximum delay of 15 minutes (900 seconds).
+ */
+export declare const MAX_SQS_DELAY_SECONDS: number;
+//# sourceMappingURL=schedule-constants.d.ts.map

package/dist/jobs/schedule-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-constants.d.ts","sourceRoot":"","sources":["../../src/jobs/schedule-constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAU,CAAC"}

package/dist/jobs/schedule-constants.js

@@ -0,0 +1,9 @@
+/**
+ * Shared constants for job scheduling metadata.
+ */
+export const RUN_AT_METADATA_KEY = '__glassworkRunAt';
+/**
+ * SQS supports a maximum delay of 15 minutes (900 seconds).
+ */
+export const MAX_SQS_DELAY_SECONDS = 15 * 60;
+//# sourceMappingURL=schedule-constants.js.map

package/dist/jobs/schedule-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-constants.js","sourceRoot":"","sources":["../../src/jobs/schedule-constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,EAAE,CAAC"}

package/dist/jobs/scheduler.d.ts

@@ -0,0 +1,17 @@
+import type { Logger } from '../utils/logger.js';
+import type { QueueDriver } from './types.js';
+export interface SchedulerConfig {
+    tableName: string;
+    driver: QueueDriver;
+    region: string;
+    endpoint?: string;
+    logger?: Logger;
+}
+/**
+ * Create a scheduler handler that reads due jobs from DynamoDB and enqueues them.
+ * Intended to be triggered every minute (e.g., with EventBridge Scheduler).
+ */
+export declare function createSchedulerHandler(config: SchedulerConfig): () => Promise<{
+    dispatched: number;
+}>;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/jobs/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/jobs/scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe;;GAkD7D"}

package/dist/jobs/scheduler.js

@@ -0,0 +1,47 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DeleteCommand, DynamoDBDocumentClient, QueryCommand } from '@aws-sdk/lib-dynamodb';
+import { createLogger } from '../utils/logger.js';
+/**
+ * Create a scheduler handler that reads due jobs from DynamoDB and enqueues them.
+ * Intended to be triggered every minute (e.g., with EventBridge Scheduler).
+ */
+export function createSchedulerHandler(config) {
+    const logger = config.logger ?? createLogger('JobScheduler');
+    const ddbClient = new DynamoDBClient({
+        region: config.region,
+        ...(config.endpoint && { endpoint: config.endpoint }),
+    });
+    const docClient = DynamoDBDocumentClient.from(ddbClient);
+    return async () => {
+        const partition = `SCHEDULED#${new Date().toISOString().slice(0, 16)}`;
+        const result = await docClient.send(new QueryCommand({
+            TableName: config.tableName,
+            KeyConditionExpression: 'pk = :pk',
+            ExpressionAttributeValues: { ':pk': partition },
+        }));
+        if (!result.Items || result.Items.length === 0) {
+            return { dispatched: 0 };
+        }
+        let dispatched = 0;
+        for (const item of result.Items) {
+            const jobName = item.jobName;
+            const payload = JSON.parse(item.payload);
+            const queue = item.queue ?? 'default';
+            const jobId = item.sk;
+            await config.driver.enqueue({
+                jobName,
+                payload,
+                queue,
+                jobId,
+            });
+            await docClient.send(new DeleteCommand({
+                TableName: config.tableName,
+                Key: { pk: partition, sk: jobId },
+            }));
+            dispatched += 1;
+        }
+        logger.info('Dispatched scheduled jobs', { dispatched });
+        return { dispatched };
+    };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/jobs/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/jobs/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWlD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAuB;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,YAAY,CAAC,cAAc,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEzD,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,SAAS,GAAG,aAAa,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAEvE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CACjC,IAAI,YAAY,CAAC;YACf,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,sBAAsB,EAAE,UAAU;YAClC,yBAAyB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;SAChD,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAiB,CAAC,CAAC;YACnD,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,SAAS,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,EAAY,CAAC;YAEhC,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC1B,OAAO;gBACP,OAAO;gBACP,KAAK;gBACL,KAAK;aACN,CAAC,CAAC;YAEH,MAAM,SAAS,CAAC,IAAI,CAClB,IAAI,aAAa,CAAC;gBAChB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE;aAClC,CAAC,CACH,CAAC;YAEF,UAAU,IAAI,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACzD,OAAO,EAAE,UAAU,EAAE,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC"}

package/dist/jobs/types.d.ts

@@ -0,0 +1,156 @@
+import type { BaseIssue, BaseSchema } from 'valibot';
+import type { Logger } from '../utils/logger.js';
+/**
+ * Duration expressed as human-readable string (e.g. "5m") or seconds as number.
+ */
+export type Duration = string | number;
+/**
+ * Retry configuration for jobs.
+ * Phase 1 does not implement retries but the shape is defined for forward compatibility.
+ */
+export interface RetryConfig {
+    /** Maximum retry attempts (default: 3) */
+    maxAttempts?: number;
+    /** Backoff strategy (default: exponential) */
+    backoff?: 'exponential' | 'linear' | 'fixed';
+    /** Initial delay between retries (default: 30s) */
+    initialDelay?: Duration;
+    /** Maximum delay cap (default: 1h) */
+    maxDelay?: Duration;
+    /** Whether to apply jitter to backoff timing (default: true) */
+    jitter?: boolean;
+}
+/**
+ * Execution context passed to job handlers.
+ */
+export interface JobContext {
+    /** DI container services (shaped by user module) */
+    services: Record<string, unknown>;
+    /** Job identifier */
+    jobId: string;
+    /** Current attempt number (starts at 1) */
+    attemptNumber: number;
+    /** Timestamp when the job was enqueued */
+    enqueuedAt: Date;
+    /** Optional logger scoped to the job */
+    logger?: Logger;
+}
+/**
+ * Job handler signature.
+ */
+export type JobHandler<TPayload> = (payload: TPayload, context: JobContext) => Promise<void> | void;
+/**
+ * Job definition with optional schema validation and retry configuration.
+ */
+export interface JobDefinition<TPayload> {
+    /** Unique job name */
+    name: string;
+    /** Target queue (default resolved by JobService) */
+    queue?: string;
+    /**
+     * Dead-letter queue name for operational documentation.
+     * Configure the actual DLQ/redrive policy in your queue infrastructure
+     * (e.g., SQS redrive policy pointing the primary queue to this DLQ).
+     */
+    deadLetterQueue?: string;
+    /** Optional payload schema for validation */
+    schema?: BaseSchema<TPayload, TPayload, BaseIssue<unknown>>;
+    /** Retry behavior (future phases) */
+    retry?: RetryConfig;
+    /**
+     * Optional uniqueness constraint. Intended for FIFO queues.
+     * The deduplication key should be stable for the same logical job.
+     */
+    unique?: {
+        key: (payload: TPayload) => string;
+        /** Deduplication window (advisory; FIFO queues cap at 5 minutes) */
+        window?: Duration;
+    };
+    /** Handler invoked by the worker */
+    handler: JobHandler<TPayload>;
+}
+/**
+ * Job message sent to a queue.
+ */
+export interface JobMessage {
+    /** Job type identifier */
+    jobName: string;
+    /** Serialized job payload */
+    payload: unknown;
+    /** Queue to use (default resolved by JobService/driver) */
+    queue?: string;
+    /** Optional client-provided job ID */
+    jobId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Result returned after enqueuing a job.
+ */
+export interface EnqueueResult {
+    /** Queue-assigned message ID */
+    messageId: string;
+    /** Generated or provided job ID */
+    jobId: string;
+}
+/**
+ * Options for receiving jobs from a queue.
+ */
+export interface ReceiveOptions {
+    /** Queue name to poll */
+    queue?: string;
+    /** Visibility timeout in seconds */
+    visibilityTimeout?: number;
+    /** Maximum number of messages to receive */
+    maxMessages?: number;
+    /** Long polling wait time in seconds */
+    waitTimeSeconds?: number;
+}
+/**
+ * Job representation when received from a driver.
+ */
+export interface ReceivedJob {
+    /** Parsed message */
+    message: JobMessage & {
+        jobId: string;
+    };
+    /** Driver-specific receipt handle */
+    receiptHandle?: string;
+    /** Raw driver payload */
+    raw?: unknown;
+}
+/**
+ * Queue driver interface.
+ *
+ * Methods beyond `enqueue` are placeholders for later phases and may throw
+ * until implemented by a driver.
+ */
+export interface QueueDriver {
+    /** Driver name for logging/debugging */
+    readonly name: string;
+    /**
+     * Enqueue a job for immediate processing.
+     */
+    enqueue(message: JobMessage): Promise<EnqueueResult>;
+    /**
+     * Enqueue a job for processing at a specific time.
+     */
+    enqueueAt?(message: JobMessage, at: Date): Promise<EnqueueResult>;
+    /**
+     * Enqueue a job for processing after a delay.
+     */
+    enqueueIn?(message: JobMessage, delay: Duration): Promise<EnqueueResult>;
+    /**
+     * Receive jobs from the queue (for worker processing).
+     */
+    receive?(options?: ReceiveOptions): Promise<ReceivedJob[]>;
+    /**
+     * Acknowledge successful job completion.
+     */
+    ack?(job: ReceivedJob): Promise<void>;
+    /**
+     * Reject a job (will be retried or sent to DLQ).
+     */
+    nack?(job: ReceivedJob, error?: Error): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/jobs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/jobs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":""}

package/dist/jobs/utils.d.ts

@@ -0,0 +1,24 @@
+import type { Duration } from './types.js';
+/**
+ * Generate a unique job identifier.
+ */
+export declare function generateJobId(): string;
+/**
+ * Calculate the size of a payload once serialized.
+ */
+export declare function calculatePayloadSizeBytes(payload: unknown): number;
+/**
+ * Parse a duration value into seconds.
+ * Supports number (seconds) or string like "5m", "30s", "1h", "1d".
+ */
+export declare function durationToSeconds(duration: Duration): number;
+/**
+ * Simple exponential backoff with optional jitter.
+ */
+export declare function computeBackoffSeconds(attemptNumber: number, config: {
+    baseDelaySeconds: number;
+    maxDelaySeconds?: number;
+    strategy?: 'exponential' | 'linear' | 'fixed';
+    jitter?: boolean;
+}): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/jobs/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/jobs/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA2B5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE;IACN,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,MAAM,CAoBR"}

package/dist/jobs/utils.js

@@ -0,0 +1,69 @@
+import { randomUUID } from 'node:crypto';
+/**
+ * Generate a unique job identifier.
+ */
+export function generateJobId() {
+    if (typeof randomUUID === 'function') {
+        return randomUUID();
+    }
+    return `job-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}
+/**
+ * Calculate the size of a payload once serialized.
+ */
+export function calculatePayloadSizeBytes(payload) {
+    const serialized = JSON.stringify(payload);
+    const encoded = new TextEncoder().encode(serialized ?? 'null');
+    return encoded.length;
+}
+/**
+ * Parse a duration value into seconds.
+ * Supports number (seconds) or string like "5m", "30s", "1h", "1d".
+ */
+export function durationToSeconds(duration) {
+    if (typeof duration === 'number') {
+        return duration;
+    }
+    const trimmed = duration.trim();
+    const match = /^(\d+(?:\.\d+)?)([smhd]?)$/i.exec(trimmed);
+    if (!match) {
+        throw new Error(`Invalid duration format: "${duration}"`);
+    }
+    const value = Number.parseFloat(match[1]);
+    const unit = match[2].toLowerCase();
+    switch (unit) {
+        case 's':
+        case '':
+            return value;
+        case 'm':
+            return value * 60;
+        case 'h':
+            return value * 60 * 60;
+        case 'd':
+            return value * 60 * 60 * 24;
+        default:
+            throw new Error(`Unsupported duration unit: "${unit}"`);
+    }
+}
+/**
+ * Simple exponential backoff with optional jitter.
+ */
+export function computeBackoffSeconds(attemptNumber, config) {
+    const { baseDelaySeconds, maxDelaySeconds, strategy = 'exponential', jitter = true } = config;
+    let delay = baseDelaySeconds;
+    if (strategy === 'exponential') {
+        delay = baseDelaySeconds * 2 ** (attemptNumber - 1);
+    }
+    else if (strategy === 'linear') {
+        delay = baseDelaySeconds * attemptNumber;
+    }
+    if (maxDelaySeconds) {
+        delay = Math.min(delay, maxDelaySeconds);
+    }
+    if (jitter) {
+        const random = Math.random();
+        delay = delay * (0.5 + random / 2); // between 0.5x and 1x
+    }
+    return Math.max(0, Math.floor(delay));
+}
+//# sourceMappingURL=utils.js.map

package/dist/jobs/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/jobs/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG,CAAC;QACT,KAAK,EAAE;YACL,OAAO,KAAK,CAAC;QACf,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QACzB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC9B;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,MAKC;IAED,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,QAAQ,GAAG,aAAa,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAE9F,IAAI,KAAK,GAAG,gBAAgB,CAAC;IAC7B,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC/B,KAAK,GAAG,gBAAgB,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,KAAK,GAAG,gBAAgB,GAAG,aAAa,CAAC;IAC3C,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,KAAK,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAC5D,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/jobs/worker.d.ts

@@ -0,0 +1,36 @@
+import type { Context, EventBridgeEvent, SQSEvent } from 'aws-lambda';
+import type { ModuleConfig } from '../core/types.js';
+import { type Logger } from '../utils/logger.js';
+import type { JobContext, QueueDriver } from './types.js';
+interface WorkerHooks {
+    onJobStart?: (job: JobExecution, context: JobContext) => Promise<void> | void;
+    onJobComplete?: (job: JobExecution, context: JobContext) => Promise<void> | void;
+    onJobFailed?: (job: JobExecution, context: JobContext, error: Error) => Promise<void> | void;
+    onJobDeadLetter?: (job: JobExecution, context: JobContext, error: Error) => Promise<void> | void;
+}
+export interface WorkerConfig {
+    module: ModuleConfig;
+    driver?: QueueDriver;
+    hooks?: WorkerHooks;
+    logger?: Logger;
+}
+export interface JobExecution {
+    jobId: string;
+    jobName: string;
+    payload: unknown;
+    attemptNumber: number;
+    enqueuedAt: Date;
+    metadata?: Record<string, string>;
+}
+/**
+ * Bootstrap a worker Lambda handler for processing jobs.
+ */
+export declare function bootstrapWorker(config: WorkerConfig): (event: SQSEvent | EventBridgeEvent<string, unknown> | Record<string, unknown>, _ctx?: Context) => Promise<{
+    batchItemFailures: import("aws-lambda").SQSBatchItemFailure[];
+    success?: undefined;
+} | {
+    success: boolean;
+    batchItemFailures?: undefined;
+}>;
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/jobs/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAoB,QAAQ,EAAa,MAAM,YAAY,CAAC;AAGnG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI/D,OAAO,KAAK,EAAE,UAAU,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9E,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjF,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7F,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClG;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAUD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,IAKhD,OAAO,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7E,OAAO,OAAO;;;;;;GA4CjB"}