@happyvertical/jobs 0.74.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/AGENT.md +33 -0
  2. package/LICENSE +7 -0
  3. package/dist/adapters/bull.d.ts +103 -0
  4. package/dist/adapters/bull.d.ts.map +1 -0
  5. package/dist/adapters/bull.js +349 -0
  6. package/dist/adapters/bull.js.map +1 -0
  7. package/dist/adapters/bullmq.d.ts +85 -0
  8. package/dist/adapters/bullmq.d.ts.map +1 -0
  9. package/dist/adapters/bullmq.js +391 -0
  10. package/dist/adapters/bullmq.js.map +1 -0
  11. package/dist/adapters/cloud-tasks.d.ts +110 -0
  12. package/dist/adapters/cloud-tasks.d.ts.map +1 -0
  13. package/dist/adapters/cloud-tasks.js +336 -0
  14. package/dist/adapters/cloud-tasks.js.map +1 -0
  15. package/dist/adapters/postgres.d.ts +55 -0
  16. package/dist/adapters/postgres.d.ts.map +1 -0
  17. package/dist/adapters/postgres.js +437 -0
  18. package/dist/adapters/postgres.js.map +1 -0
  19. package/dist/adapters/sqlite.d.ts +44 -0
  20. package/dist/adapters/sqlite.d.ts.map +1 -0
  21. package/dist/adapters/sqlite.js +323 -0
  22. package/dist/adapters/sqlite.js.map +1 -0
  23. package/dist/adapters/sqs.d.ts +112 -0
  24. package/dist/adapters/sqs.d.ts.map +1 -0
  25. package/dist/adapters/sqs.js +411 -0
  26. package/dist/adapters/sqs.js.map +1 -0
  27. package/dist/base-store.d.ts +69 -0
  28. package/dist/base-store.d.ts.map +1 -0
  29. package/dist/chunks/base-store-DlNksWvQ.js +324 -0
  30. package/dist/chunks/base-store-DlNksWvQ.js.map +1 -0
  31. package/dist/cli/claude-context.d.ts +3 -0
  32. package/dist/cli/claude-context.d.ts.map +1 -0
  33. package/dist/cli/claude-context.js +21 -0
  34. package/dist/cli/claude-context.js.map +1 -0
  35. package/dist/index.d.ts +16 -0
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +252 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/retry.d.ts +84 -0
  40. package/dist/retry.d.ts.map +1 -0
  41. package/dist/types.d.ts +311 -0
  42. package/dist/types.d.ts.map +1 -0
  43. package/dist/worker.d.ts +74 -0
  44. package/dist/worker.d.ts.map +1 -0
  45. package/metadata.json +34 -0
  46. package/package.json +114 -0
@@ -0,0 +1,411 @@
1
+ import { createId } from "@happyvertical/utils";
2
+ import { B as BaseJobStore, p as priorityToNumber } from "../chunks/base-store-DlNksWvQ.js";
3
+ class SQSJobStore extends BaseJobStore {
4
+ config;
5
+ client = null;
6
+ // biome-ignore lint/style/useNamingConvention: AWS SDK module reference
7
+ awsSdkModule = null;
8
+ queueUrls = /* @__PURE__ */ new Map();
9
+ // In-memory state tracking for jobs that have been dequeued
10
+ jobStates = /* @__PURE__ */ new Map();
11
+ constructor(config) {
12
+ super();
13
+ this.config = {
14
+ visibilityTimeout: 300,
15
+ // 5 minutes default
16
+ messageRetentionDays: 4,
17
+ useFifo: false,
18
+ ...config
19
+ };
20
+ }
21
+ /**
22
+ * Initialize the store - dynamically imports AWS SDK
23
+ */
24
+ async initialize() {
25
+ if (this.initialized) return;
26
+ try {
27
+ this.awsSdkModule = await import("@aws-sdk/client-sqs");
28
+ } catch {
29
+ throw new Error(
30
+ "AWS SDK is required for SQSJobStore. Install it with: npm install @aws-sdk/client-sqs"
31
+ );
32
+ }
33
+ this.client = new this.awsSdkModule.SQSClient({
34
+ region: this.config.region,
35
+ credentials: this.config.credentials
36
+ });
37
+ this.initialized = true;
38
+ }
39
+ /**
40
+ * Get or create queue URL for a queue name
41
+ */
42
+ getQueueUrl(queueName) {
43
+ if (!this.queueUrls.has(queueName)) {
44
+ const suffix = this.config.useFifo ? ".fifo" : "";
45
+ this.queueUrls.set(
46
+ queueName,
47
+ `${this.config.queueUrlPrefix}${queueName}${suffix}`
48
+ );
49
+ }
50
+ return this.queueUrls.get(queueName);
51
+ }
52
+ /**
53
+ * Convert SQS message to Job format
54
+ */
55
+ sqsMessageToJob(message, queueName) {
56
+ if (!message.Body) return null;
57
+ try {
58
+ const data = JSON.parse(message.Body);
59
+ const now = /* @__PURE__ */ new Date();
60
+ const state = this.jobStates.get(data.id);
61
+ if (state) {
62
+ state.receiptHandle = message.ReceiptHandle;
63
+ return state.job;
64
+ }
65
+ const job = {
66
+ id: data.id,
67
+ queue: queueName,
68
+ payload: data.payload,
69
+ status: "pending",
70
+ priority: data.priority,
71
+ attempts: Number(message.Attributes?.ApproximateReceiveCount ?? 0),
72
+ maxAttempts: data.maxAttempts,
73
+ runAt: new Date(data.runAt),
74
+ startedAt: null,
75
+ completedAt: null,
76
+ timeout: data.timeout,
77
+ timeoutBehavior: data.timeoutBehavior,
78
+ lastError: null,
79
+ resultPointer: null,
80
+ retryStrategy: data.retryStrategy,
81
+ workerId: null,
82
+ workerHeartbeat: null,
83
+ createdAt: new Date(data.createdAt),
84
+ updatedAt: now
85
+ };
86
+ this.jobStates.set(data.id, {
87
+ job,
88
+ receiptHandle: message.ReceiptHandle
89
+ });
90
+ return job;
91
+ } catch {
92
+ return null;
93
+ }
94
+ }
95
+ /**
96
+ * Enqueue a new job
97
+ */
98
+ async enqueue(options) {
99
+ if (!this.initialized || !this.client || !this.awsSdkModule) {
100
+ throw new Error("SQSJobStore not initialized");
101
+ }
102
+ const queueName = options.queue ?? "default";
103
+ const queueUrl = this.getQueueUrl(queueName);
104
+ const now = /* @__PURE__ */ new Date();
105
+ const jobId = createId();
106
+ const jobData = {
107
+ id: jobId,
108
+ queue: queueName,
109
+ payload: options.payload,
110
+ priority: priorityToNumber(options.priority),
111
+ maxAttempts: options.maxAttempts ?? 3,
112
+ timeout: options.timeout ?? 3e5,
113
+ timeoutBehavior: options.timeoutBehavior ?? "fail",
114
+ retryStrategy: options.retryStrategy && "toConfig" in options.retryStrategy ? options.retryStrategy.toConfig() : options.retryStrategy ?? {
115
+ type: "exponential",
116
+ config: { initialDelay: 1e3, multiplier: 2 }
117
+ },
118
+ runAt: (options.runAt ?? now).toISOString(),
119
+ createdAt: now.toISOString()
120
+ };
121
+ const messageParams = {
122
+ QueueUrl: queueUrl,
123
+ MessageBody: JSON.stringify(jobData),
124
+ // Use delay for scheduled jobs (max 15 minutes in SQS)
125
+ DelaySeconds: options.runAt ? Math.min(
126
+ 900,
127
+ Math.max(
128
+ 0,
129
+ Math.floor((options.runAt.getTime() - now.getTime()) / 1e3)
130
+ )
131
+ ) : void 0
132
+ };
133
+ if (this.config.useFifo) {
134
+ messageParams.MessageGroupId = queueName;
135
+ messageParams.MessageDeduplicationId = jobId;
136
+ }
137
+ await this.client.send(
138
+ new this.awsSdkModule.SendMessageCommand(messageParams)
139
+ );
140
+ const job = {
141
+ id: jobId,
142
+ queue: queueName,
143
+ payload: options.payload,
144
+ status: "pending",
145
+ priority: priorityToNumber(options.priority),
146
+ attempts: 0,
147
+ maxAttempts: options.maxAttempts ?? 3,
148
+ runAt: options.runAt ?? now,
149
+ startedAt: null,
150
+ completedAt: null,
151
+ timeout: options.timeout ?? 3e5,
152
+ timeoutBehavior: options.timeoutBehavior ?? "fail",
153
+ lastError: null,
154
+ resultPointer: null,
155
+ retryStrategy: jobData.retryStrategy,
156
+ workerId: null,
157
+ workerHeartbeat: null,
158
+ createdAt: now,
159
+ updatedAt: now
160
+ };
161
+ this.jobStates.set(jobId, { job });
162
+ await this.emitEvent("job.created", job);
163
+ return job;
164
+ }
165
+ /**
166
+ * Dequeue jobs ready for processing
167
+ */
168
+ async dequeue(queues, limit, workerId) {
169
+ if (!this.initialized || !this.client || !this.awsSdkModule) {
170
+ throw new Error("SQSJobStore not initialized");
171
+ }
172
+ const jobs = [];
173
+ for (const queueName of queues) {
174
+ if (jobs.length >= limit) break;
175
+ const queueUrl = this.getQueueUrl(queueName);
176
+ const result = await this.client.send(
177
+ new this.awsSdkModule.ReceiveMessageCommand({
178
+ QueueUrl: queueUrl,
179
+ MaxNumberOfMessages: Math.min(10, limit - jobs.length),
180
+ // SQS max is 10
181
+ VisibilityTimeout: this.config.visibilityTimeout,
182
+ MessageSystemAttributeNames: ["ApproximateReceiveCount"],
183
+ WaitTimeSeconds: 0
184
+ // Short poll for compatibility
185
+ })
186
+ );
187
+ if (result.Messages) {
188
+ for (const message of result.Messages) {
189
+ const job = this.sqsMessageToJob(message, queueName);
190
+ if (job) {
191
+ job.status = "running";
192
+ job.workerId = workerId;
193
+ job.startedAt = /* @__PURE__ */ new Date();
194
+ jobs.push(job);
195
+ await this.emitEvent("job.started", job);
196
+ }
197
+ }
198
+ }
199
+ }
200
+ return jobs;
201
+ }
202
+ /**
203
+ * Update a job - NOT SUPPORTED in SQS (messages are immutable)
204
+ */
205
+ async update(_id, _updates) {
206
+ throw new Error(
207
+ "SQS does not support updating jobs. Messages are immutable. Consider using DynamoDB alongside SQS for full job state tracking."
208
+ );
209
+ }
210
+ /**
211
+ * Get a job by ID (from in-memory state only)
212
+ */
213
+ async get(id) {
214
+ const state = this.jobStates.get(id);
215
+ return state?.job ?? null;
216
+ }
217
+ /**
218
+ * List jobs with filtering
219
+ * Note: SQS doesn't support efficient listing - this only returns in-memory state
220
+ */
221
+ async list(filter) {
222
+ const jobs = [];
223
+ const limit = filter.limit ?? 100;
224
+ for (const state of this.jobStates.values()) {
225
+ const job = state.job;
226
+ if (filter.queue && job.queue !== filter.queue) continue;
227
+ if (filter.status) {
228
+ const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
229
+ if (!statuses.includes(job.status)) continue;
230
+ }
231
+ if (filter.objectType && job.payload.objectType !== filter.objectType)
232
+ continue;
233
+ if (filter.method && job.payload.method !== filter.method) continue;
234
+ if (filter.createdAfter && job.createdAt < filter.createdAfter) continue;
235
+ if (filter.createdBefore && job.createdAt > filter.createdBefore)
236
+ continue;
237
+ jobs.push(job);
238
+ if (jobs.length >= limit) break;
239
+ }
240
+ return jobs;
241
+ }
242
+ /**
243
+ * Cancel a job by deleting its message from SQS
244
+ */
245
+ async cancel(id) {
246
+ if (!this.initialized || !this.client || !this.awsSdkModule) {
247
+ throw new Error("SQSJobStore not initialized");
248
+ }
249
+ const state = this.jobStates.get(id);
250
+ if (!state) {
251
+ throw new Error(`Job ${id} not found or not yet received from queue`);
252
+ }
253
+ if (!state.receiptHandle) {
254
+ throw new Error(
255
+ `Job ${id} has no receipt handle - cannot delete from SQS`
256
+ );
257
+ }
258
+ const queueUrl = this.getQueueUrl(state.job.queue);
259
+ await this.client.send(
260
+ new this.awsSdkModule.DeleteMessageCommand({
261
+ QueueUrl: queueUrl,
262
+ ReceiptHandle: state.receiptHandle
263
+ })
264
+ );
265
+ state.job.status = "cancelled";
266
+ state.job.completedAt = /* @__PURE__ */ new Date();
267
+ await this.emitEvent("job.cancelled", state.job);
268
+ }
269
+ /**
270
+ * Mark job as completed
271
+ */
272
+ async markCompleted(id, resultPointer) {
273
+ if (!this.initialized || !this.client || !this.awsSdkModule) {
274
+ throw new Error("SQSJobStore not initialized");
275
+ }
276
+ const state = this.jobStates.get(id);
277
+ if (!state || !state.receiptHandle) {
278
+ throw new Error(`Job ${id} not found or has no receipt handle`);
279
+ }
280
+ const queueUrl = this.getQueueUrl(state.job.queue);
281
+ await this.client.send(
282
+ new this.awsSdkModule.DeleteMessageCommand({
283
+ QueueUrl: queueUrl,
284
+ ReceiptHandle: state.receiptHandle
285
+ })
286
+ );
287
+ state.job.status = "completed";
288
+ state.job.completedAt = /* @__PURE__ */ new Date();
289
+ state.job.resultPointer = resultPointer ?? null;
290
+ await this.emitEvent("job.completed", state.job, { resultPointer });
291
+ }
292
+ /**
293
+ * Mark job as failed
294
+ */
295
+ async markFailed(id, error) {
296
+ const state = this.jobStates.get(id);
297
+ if (!state) {
298
+ throw new Error(`Job ${id} not found`);
299
+ }
300
+ state.job.status = "failed";
301
+ state.job.completedAt = /* @__PURE__ */ new Date();
302
+ state.job.lastError = error;
303
+ await this.emitEvent("job.failed", state.job, { error });
304
+ }
305
+ /**
306
+ * Clean up old jobs from in-memory state
307
+ * Note: SQS handles message retention automatically
308
+ */
309
+ async cleanup(options) {
310
+ let cleaned = 0;
311
+ for (const [id, state] of this.jobStates) {
312
+ const { job } = state;
313
+ if (options.completedBefore && job.status === "completed" && job.completedAt && job.completedAt < options.completedBefore) {
314
+ this.jobStates.delete(id);
315
+ cleaned++;
316
+ continue;
317
+ }
318
+ if (options.failedBefore && job.status === "failed" && job.completedAt && job.completedAt < options.failedBefore) {
319
+ this.jobStates.delete(id);
320
+ cleaned++;
321
+ continue;
322
+ }
323
+ if (options.cancelledBefore && job.status === "cancelled" && job.completedAt && job.completedAt < options.cancelledBefore) {
324
+ this.jobStates.delete(id);
325
+ cleaned++;
326
+ continue;
327
+ }
328
+ if (options.limit && cleaned >= options.limit) break;
329
+ }
330
+ return cleaned;
331
+ }
332
+ /**
333
+ * Update visibility timeout for a job (extends processing time)
334
+ */
335
+ async heartbeat(jobId, _workerId) {
336
+ if (!this.initialized || !this.client || !this.awsSdkModule) {
337
+ throw new Error("SQSJobStore not initialized");
338
+ }
339
+ const state = this.jobStates.get(jobId);
340
+ if (!state || !state.receiptHandle) {
341
+ return;
342
+ }
343
+ const queueUrl = this.getQueueUrl(state.job.queue);
344
+ await this.client.send(
345
+ new this.awsSdkModule.ChangeMessageVisibilityCommand({
346
+ QueueUrl: queueUrl,
347
+ ReceiptHandle: state.receiptHandle,
348
+ VisibilityTimeout: this.config.visibilityTimeout
349
+ })
350
+ );
351
+ state.job.workerHeartbeat = /* @__PURE__ */ new Date();
352
+ }
353
+ /**
354
+ * Get queue statistics
355
+ */
356
+ async stats(queue) {
357
+ if (!this.initialized || !this.client || !this.awsSdkModule) {
358
+ throw new Error("SQSJobStore not initialized");
359
+ }
360
+ const totals = {
361
+ pending: 0,
362
+ running: 0,
363
+ completed: 0,
364
+ failed: 0,
365
+ cancelled: 0,
366
+ avgDuration: null
367
+ };
368
+ for (const state of this.jobStates.values()) {
369
+ if (queue && state.job.queue !== queue) continue;
370
+ switch (state.job.status) {
371
+ case "pending":
372
+ totals.pending++;
373
+ break;
374
+ case "running":
375
+ totals.running++;
376
+ break;
377
+ case "completed":
378
+ totals.completed++;
379
+ break;
380
+ case "failed":
381
+ totals.failed++;
382
+ break;
383
+ case "cancelled":
384
+ totals.cancelled++;
385
+ break;
386
+ }
387
+ }
388
+ return totals;
389
+ }
390
+ /**
391
+ * Close the SQS client
392
+ */
393
+ async close() {
394
+ if (this.client) {
395
+ this.client.destroy();
396
+ this.client = null;
397
+ }
398
+ this.jobStates.clear();
399
+ this.queueUrls.clear();
400
+ this.initialized = false;
401
+ }
402
+ }
403
+ function createSQSJobStore(config) {
404
+ return new SQSJobStore(config);
405
+ }
406
+ export {
407
+ SQSJobStore,
408
+ createSQSJobStore,
409
+ SQSJobStore as default
410
+ };
411
+ //# sourceMappingURL=sqs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sqs.js","sources":["../../src/adapters/sqs.ts"],"sourcesContent":["/**\n * AWS SQS Job Store Adapter\n *\n * Uses AWS SQS for cloud-based job storage with automatic scaling.\n * SQS provides managed message queuing with features like\n * visibility timeout, dead letter queues, and FIFO ordering.\n *\n * @example\n * ```typescript\n * import { SQSJobStore } from '@happyvertical/jobs/adapters/sqs';\n *\n * const store = new SQSJobStore({\n * region: 'us-east-1',\n * queueUrlPrefix: 'https://sqs.us-east-1.amazonaws.com/123456789/myapp-',\n * // Or use credentials explicitly\n * credentials: {\n * accessKeyId: 'AKIA...',\n * secretAccessKey: '...',\n * },\n * });\n *\n * await store.initialize();\n * ```\n *\n * Note: This adapter requires the `@aws-sdk/client-sqs` package as a peer dependency.\n * Install it with: npm install @aws-sdk/client-sqs\n *\n * Important: SQS has some limitations for job storage:\n * - Jobs cannot be updated after enqueue (SQS messages are immutable)\n * - Job listing is limited (SQS doesn't support efficient listing)\n * - Cleanup is automatic via message retention policy\n * - Use DynamoDB alongside SQS for full job tracking if needed\n */\n\nimport type { Message, SQSClient as SQSClientType } from '@aws-sdk/client-sqs';\nimport { createId } from '@happyvertical/utils';\nimport { BaseJobStore, priorityToNumber } from '../base-store.js';\nimport type {\n CleanupOptions,\n Job,\n JobCreateOptions,\n JobFilter,\n QueueStats,\n} from '../types.js';\n\n/**\n * AWS credentials configuration\n */\nexport interface AWSCredentials {\n accessKeyId: string;\n secretAccessKey: string;\n sessionToken?: string;\n}\n\n/**\n * SQS adapter configuration\n */\nexport interface SQSJobStoreConfig {\n /** AWS region */\n region?: string;\n /** AWS credentials (optional - uses default chain if not provided) */\n credentials?: AWSCredentials;\n /** Queue URL prefix (queues will be named {prefix}{queueName}) */\n queueUrlPrefix: string;\n /** Default visibility timeout in seconds */\n visibilityTimeout?: number;\n /** Message retention in days (1-14, default: 4) */\n messageRetentionDays?: number;\n /** Use FIFO queues for ordering guarantees */\n useFifo?: boolean;\n}\n\n/**\n * Job data stored in SQS message body\n */\ninterface SQSJobData {\n id: string;\n queue: string;\n payload: Job['payload'];\n priority: number;\n maxAttempts: number;\n timeout: number;\n timeoutBehavior: Job['timeoutBehavior'];\n retryStrategy: Job['retryStrategy'];\n runAt: string;\n createdAt: string;\n}\n\n/**\n * In-memory job state tracking (SQS messages are immutable)\n */\ninterface JobState {\n job: Job;\n receiptHandle?: string;\n}\n\n/**\n * SQS-based job store implementation\n *\n * Note: SQS has limitations that make some operations different:\n * - `update()` throws error (messages are immutable)\n * - `list()` only returns pending jobs from SQS\n * - `cancel()` requires the job to have been dequeued first\n * - For full job tracking, consider using DynamoDB alongside SQS\n */\nexport class SQSJobStore extends BaseJobStore {\n private config: SQSJobStoreConfig;\n private client: SQSClientType | null = null;\n // biome-ignore lint/style/useNamingConvention: AWS SDK module reference\n private awsSdkModule: typeof import('@aws-sdk/client-sqs') | null = null;\n private queueUrls: Map<string, string> = new Map();\n // In-memory state tracking for jobs that have been dequeued\n private jobStates: Map<string, JobState> = new Map();\n\n constructor(config: SQSJobStoreConfig) {\n super();\n this.config = {\n visibilityTimeout: 300, // 5 minutes default\n messageRetentionDays: 4,\n useFifo: false,\n ...config,\n };\n }\n\n /**\n * Initialize the store - dynamically imports AWS SDK\n */\n async initialize(): Promise<void> {\n if (this.initialized) return;\n\n try {\n // Dynamic import to avoid requiring AWS SDK as a hard dependency\n this.awsSdkModule = await import('@aws-sdk/client-sqs');\n } catch {\n throw new Error(\n 'AWS SDK is required for SQSJobStore. Install it with: npm install @aws-sdk/client-sqs',\n );\n }\n\n this.client = new this.awsSdkModule.SQSClient({\n region: this.config.region,\n credentials: this.config.credentials,\n });\n\n this.initialized = true;\n }\n\n /**\n * Get or create queue URL for a queue name\n */\n private getQueueUrl(queueName: string): string {\n if (!this.queueUrls.has(queueName)) {\n const suffix = this.config.useFifo ? '.fifo' : '';\n this.queueUrls.set(\n queueName,\n `${this.config.queueUrlPrefix}${queueName}${suffix}`,\n );\n }\n return this.queueUrls.get(queueName)!;\n }\n\n /**\n * Convert SQS message to Job format\n */\n private sqsMessageToJob(message: Message, queueName: string): Job | null {\n if (!message.Body) return null;\n\n try {\n const data: SQSJobData = JSON.parse(message.Body);\n const now = new Date();\n\n // Check if we have state for this job\n const state = this.jobStates.get(data.id);\n if (state) {\n // Update receipt handle\n state.receiptHandle = message.ReceiptHandle;\n return state.job;\n }\n\n const job: Job = {\n id: data.id,\n queue: queueName,\n payload: data.payload,\n status: 'pending',\n priority: data.priority,\n attempts: Number(message.Attributes?.ApproximateReceiveCount ?? 0),\n maxAttempts: data.maxAttempts,\n runAt: new Date(data.runAt),\n startedAt: null,\n completedAt: null,\n timeout: data.timeout,\n timeoutBehavior: data.timeoutBehavior,\n lastError: null,\n resultPointer: null,\n retryStrategy: data.retryStrategy,\n workerId: null,\n workerHeartbeat: null,\n createdAt: new Date(data.createdAt),\n updatedAt: now,\n };\n\n // Store state with receipt handle\n this.jobStates.set(data.id, {\n job,\n receiptHandle: message.ReceiptHandle,\n });\n\n return job;\n } catch {\n return null;\n }\n }\n\n /**\n * Enqueue a new job\n */\n async enqueue(options: JobCreateOptions): Promise<Job> {\n if (!this.initialized || !this.client || !this.awsSdkModule) {\n throw new Error('SQSJobStore not initialized');\n }\n\n const queueName = options.queue ?? 'default';\n const queueUrl = this.getQueueUrl(queueName);\n const now = new Date();\n const jobId = createId();\n\n const jobData: SQSJobData = {\n id: jobId,\n queue: queueName,\n payload: options.payload,\n priority: priorityToNumber(options.priority),\n maxAttempts: options.maxAttempts ?? 3,\n timeout: options.timeout ?? 300000,\n timeoutBehavior: options.timeoutBehavior ?? 'fail',\n retryStrategy:\n options.retryStrategy && 'toConfig' in options.retryStrategy\n ? options.retryStrategy.toConfig()\n : ((options.retryStrategy as Job['retryStrategy']) ?? {\n type: 'exponential',\n config: { initialDelay: 1000, multiplier: 2 },\n }),\n runAt: (options.runAt ?? now).toISOString(),\n createdAt: now.toISOString(),\n };\n\n const messageParams: import('@aws-sdk/client-sqs').SendMessageCommandInput =\n {\n QueueUrl: queueUrl,\n MessageBody: JSON.stringify(jobData),\n // Use delay for scheduled jobs (max 15 minutes in SQS)\n DelaySeconds: options.runAt\n ? Math.min(\n 900,\n Math.max(\n 0,\n Math.floor((options.runAt.getTime() - now.getTime()) / 1000),\n ),\n )\n : undefined,\n };\n\n // Add FIFO-specific parameters\n if (this.config.useFifo) {\n messageParams.MessageGroupId = queueName;\n messageParams.MessageDeduplicationId = jobId;\n }\n\n await this.client.send(\n new this.awsSdkModule.SendMessageCommand(messageParams),\n );\n\n const job: Job = {\n id: jobId,\n queue: queueName,\n payload: options.payload,\n status: 'pending',\n priority: priorityToNumber(options.priority),\n attempts: 0,\n maxAttempts: options.maxAttempts ?? 3,\n runAt: options.runAt ?? now,\n startedAt: null,\n completedAt: null,\n timeout: options.timeout ?? 300000,\n timeoutBehavior: options.timeoutBehavior ?? 'fail',\n lastError: null,\n resultPointer: null,\n retryStrategy: jobData.retryStrategy,\n workerId: null,\n workerHeartbeat: null,\n createdAt: now,\n updatedAt: now,\n };\n\n // Store job state\n this.jobStates.set(jobId, { job });\n\n await this.emitEvent('job.created', job);\n return job;\n }\n\n /**\n * Dequeue jobs ready for processing\n */\n async dequeue(\n queues: string[],\n limit: number,\n workerId: string,\n ): Promise<Job[]> {\n if (!this.initialized || !this.client || !this.awsSdkModule) {\n throw new Error('SQSJobStore not initialized');\n }\n\n const jobs: Job[] = [];\n\n for (const queueName of queues) {\n if (jobs.length >= limit) break;\n\n const queueUrl = this.getQueueUrl(queueName);\n\n const result = await this.client.send(\n new this.awsSdkModule.ReceiveMessageCommand({\n QueueUrl: queueUrl,\n MaxNumberOfMessages: Math.min(10, limit - jobs.length), // SQS max is 10\n VisibilityTimeout: this.config.visibilityTimeout,\n MessageSystemAttributeNames: ['ApproximateReceiveCount'],\n WaitTimeSeconds: 0, // Short poll for compatibility\n }),\n );\n\n if (result.Messages) {\n for (const message of result.Messages) {\n const job = this.sqsMessageToJob(message, queueName);\n if (job) {\n job.status = 'running';\n job.workerId = workerId;\n job.startedAt = new Date();\n jobs.push(job);\n\n await this.emitEvent('job.started', job);\n }\n }\n }\n }\n\n return jobs;\n }\n\n /**\n * Update a job - NOT SUPPORTED in SQS (messages are immutable)\n */\n async update(_id: string, _updates: Partial<Job>): Promise<Job> {\n throw new Error(\n 'SQS does not support updating jobs. Messages are immutable. ' +\n 'Consider using DynamoDB alongside SQS for full job state tracking.',\n );\n }\n\n /**\n * Get a job by ID (from in-memory state only)\n */\n async get(id: string): Promise<Job | null> {\n const state = this.jobStates.get(id);\n return state?.job ?? null;\n }\n\n /**\n * List jobs with filtering\n * Note: SQS doesn't support efficient listing - this only returns in-memory state\n */\n async list(filter: JobFilter): Promise<Job[]> {\n const jobs: Job[] = [];\n const limit = filter.limit ?? 100;\n\n for (const state of this.jobStates.values()) {\n const job = state.job;\n\n // Apply filters\n if (filter.queue && job.queue !== filter.queue) continue;\n if (filter.status) {\n const statuses = Array.isArray(filter.status)\n ? filter.status\n : [filter.status];\n if (!statuses.includes(job.status)) continue;\n }\n if (filter.objectType && job.payload.objectType !== filter.objectType)\n continue;\n if (filter.method && job.payload.method !== filter.method) continue;\n if (filter.createdAfter && job.createdAt < filter.createdAfter) continue;\n if (filter.createdBefore && job.createdAt > filter.createdBefore)\n continue;\n\n jobs.push(job);\n if (jobs.length >= limit) break;\n }\n\n return jobs;\n }\n\n /**\n * Cancel a job by deleting its message from SQS\n */\n async cancel(id: string): Promise<void> {\n if (!this.initialized || !this.client || !this.awsSdkModule) {\n throw new Error('SQSJobStore not initialized');\n }\n\n const state = this.jobStates.get(id);\n if (!state) {\n throw new Error(`Job ${id} not found or not yet received from queue`);\n }\n\n if (!state.receiptHandle) {\n throw new Error(\n `Job ${id} has no receipt handle - cannot delete from SQS`,\n );\n }\n\n const queueUrl = this.getQueueUrl(state.job.queue);\n\n await this.client.send(\n new this.awsSdkModule.DeleteMessageCommand({\n QueueUrl: queueUrl,\n ReceiptHandle: state.receiptHandle,\n }),\n );\n\n state.job.status = 'cancelled';\n state.job.completedAt = new Date();\n\n await this.emitEvent('job.cancelled', state.job);\n }\n\n /**\n * Mark job as completed\n */\n async markCompleted(id: string, resultPointer?: string): Promise<void> {\n if (!this.initialized || !this.client || !this.awsSdkModule) {\n throw new Error('SQSJobStore not initialized');\n }\n\n const state = this.jobStates.get(id);\n if (!state || !state.receiptHandle) {\n throw new Error(`Job ${id} not found or has no receipt handle`);\n }\n\n const queueUrl = this.getQueueUrl(state.job.queue);\n\n // Delete message from queue (marks as processed)\n await this.client.send(\n new this.awsSdkModule.DeleteMessageCommand({\n QueueUrl: queueUrl,\n ReceiptHandle: state.receiptHandle,\n }),\n );\n\n state.job.status = 'completed';\n state.job.completedAt = new Date();\n state.job.resultPointer = resultPointer ?? null;\n\n await this.emitEvent('job.completed', state.job, { resultPointer });\n }\n\n /**\n * Mark job as failed\n */\n async markFailed(id: string, error: string): Promise<void> {\n const state = this.jobStates.get(id);\n if (!state) {\n throw new Error(`Job ${id} not found`);\n }\n\n state.job.status = 'failed';\n state.job.completedAt = new Date();\n state.job.lastError = error;\n\n // Message will become visible again after visibility timeout\n // or go to DLQ if configured\n\n await this.emitEvent('job.failed', state.job, { error });\n }\n\n /**\n * Clean up old jobs from in-memory state\n * Note: SQS handles message retention automatically\n */\n async cleanup(options: CleanupOptions): Promise<number> {\n let cleaned = 0;\n\n for (const [id, state] of this.jobStates) {\n const { job } = state;\n\n if (\n options.completedBefore &&\n job.status === 'completed' &&\n job.completedAt &&\n job.completedAt < options.completedBefore\n ) {\n this.jobStates.delete(id);\n cleaned++;\n continue;\n }\n\n if (\n options.failedBefore &&\n job.status === 'failed' &&\n job.completedAt &&\n job.completedAt < options.failedBefore\n ) {\n this.jobStates.delete(id);\n cleaned++;\n continue;\n }\n\n if (\n options.cancelledBefore &&\n job.status === 'cancelled' &&\n job.completedAt &&\n job.completedAt < options.cancelledBefore\n ) {\n this.jobStates.delete(id);\n cleaned++;\n continue;\n }\n\n if (options.limit && cleaned >= options.limit) break;\n }\n\n return cleaned;\n }\n\n /**\n * Update visibility timeout for a job (extends processing time)\n */\n async heartbeat(jobId: string, _workerId: string): Promise<void> {\n if (!this.initialized || !this.client || !this.awsSdkModule) {\n throw new Error('SQSJobStore not initialized');\n }\n\n const state = this.jobStates.get(jobId);\n if (!state || !state.receiptHandle) {\n return; // Job not found or no receipt handle\n }\n\n const queueUrl = this.getQueueUrl(state.job.queue);\n\n await this.client.send(\n new this.awsSdkModule.ChangeMessageVisibilityCommand({\n QueueUrl: queueUrl,\n ReceiptHandle: state.receiptHandle,\n VisibilityTimeout: this.config.visibilityTimeout,\n }),\n );\n\n state.job.workerHeartbeat = new Date();\n }\n\n /**\n * Get queue statistics\n */\n async stats(queue?: string): Promise<QueueStats> {\n if (!this.initialized || !this.client || !this.awsSdkModule) {\n throw new Error('SQSJobStore not initialized');\n }\n\n const totals: QueueStats = {\n pending: 0,\n running: 0,\n completed: 0,\n failed: 0,\n cancelled: 0,\n avgDuration: null,\n };\n\n // Count from in-memory state\n for (const state of this.jobStates.values()) {\n if (queue && state.job.queue !== queue) continue;\n\n switch (state.job.status) {\n case 'pending':\n totals.pending++;\n break;\n case 'running':\n totals.running++;\n break;\n case 'completed':\n totals.completed++;\n break;\n case 'failed':\n totals.failed++;\n break;\n case 'cancelled':\n totals.cancelled++;\n break;\n }\n }\n\n return totals;\n }\n\n /**\n * Close the SQS client\n */\n async close(): Promise<void> {\n if (this.client) {\n this.client.destroy();\n this.client = null;\n }\n this.jobStates.clear();\n this.queueUrls.clear();\n this.initialized = false;\n }\n}\n\n/**\n * Create an SQS job store instance\n */\nexport function createSQSJobStore(config: SQSJobStoreConfig): SQSJobStore {\n return new SQSJobStore(config);\n}\n\nexport default SQSJobStore;\n"],"names":[],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ import { CleanupOptions, Job, JobCreateOptions, JobEventListener, JobEventType, JobFilter, JobPriority, JobStore, QueueStats } from './types.js';
2
+ /**
3
+ * Validate table name to prevent SQL injection
4
+ * @throws Error if table name contains invalid characters
5
+ */
6
+ export declare function validateTableName(tableName: string): string;
7
+ /**
8
+ * Convert priority string to number
9
+ */
10
+ export declare function priorityToNumber(priority: JobPriority | number | undefined): number;
11
+ /**
12
+ * Base job store with common functionality
13
+ */
14
+ export declare abstract class BaseJobStore implements JobStore {
15
+ protected listeners: Set<JobEventListener>;
16
+ protected initialized: boolean;
17
+ /**
18
+ * Initialize the store - must be implemented by subclasses
19
+ */
20
+ abstract initialize(): Promise<void>;
21
+ /**
22
+ * Create a new job record
23
+ */
24
+ protected createJobRecord(options: JobCreateOptions): Job;
25
+ /**
26
+ * Emit a job event to all listeners
27
+ */
28
+ protected emitEvent(type: JobEventType, job: Job, extra?: {
29
+ error?: string;
30
+ resultPointer?: string;
31
+ }): Promise<void>;
32
+ /**
33
+ * Subscribe to job events
34
+ */
35
+ subscribe(listener: JobEventListener): () => void;
36
+ /**
37
+ * Build WHERE clause for filters
38
+ */
39
+ protected buildFilterWhere(filter: JobFilter): {
40
+ where: string;
41
+ params: unknown[];
42
+ };
43
+ /**
44
+ * Build ORDER BY clause for filters
45
+ */
46
+ protected buildOrderBy(filter: JobFilter): string;
47
+ /**
48
+ * Build LIMIT/OFFSET clause
49
+ */
50
+ protected buildLimitOffset(filter: JobFilter): {
51
+ clause: string;
52
+ params: unknown[];
53
+ };
54
+ /**
55
+ * Parse a job row from the database
56
+ */
57
+ protected parseJobRow(row: Record<string, unknown>): Job;
58
+ abstract enqueue(options: JobCreateOptions): Promise<Job>;
59
+ abstract dequeue(queues: string[], limit: number, workerId: string): Promise<Job[]>;
60
+ abstract update(id: string, updates: Partial<Job>): Promise<Job>;
61
+ abstract get(id: string): Promise<Job | null>;
62
+ abstract list(filter: JobFilter): Promise<Job[]>;
63
+ abstract cancel(id: string): Promise<void>;
64
+ abstract cleanup(options: CleanupOptions): Promise<number>;
65
+ abstract heartbeat(jobId: string, workerId: string): Promise<void>;
66
+ abstract stats(queue?: string): Promise<QueueStats>;
67
+ abstract close(): Promise<void>;
68
+ }
69
+ //# sourceMappingURL=base-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base-store.d.ts","sourceRoot":"","sources":["../src/base-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,GAAG,EACH,gBAAgB,EAEhB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EAEX,MAAM,YAAY,CAAC;AAOpB;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAa3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GACzC,MAAM,CAcR;AAED;;GAEG;AACH,8BAAsB,YAAa,YAAW,QAAQ;IACpD,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAa;IACvD,SAAS,CAAC,WAAW,UAAS;IAE9B;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,GAAG;IA+BzD;;OAEG;cACa,SAAS,CACvB,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,GAAG,EACR,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,IAAI,CAAC;IAiBhB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAOjD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG;QAC7C,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,OAAO,EAAE,CAAC;KACnB;IA8CD;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM;IAcjD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG;QAC7C,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,EAAE,CAAC;KACnB;IAiBD;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG;IAiCxD,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IACzD,QAAQ,CAAC,OAAO,CACd,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,EAAE,CAAC;IACjB,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAClE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IACnD,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAChC"}