@argos-js/queue 0.0.0-stage → 0.1.1

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Argos-JS Team
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,161 @@
1
- # Temporary Holding Version
1
+ # @argos-js/queue
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Event-driven asynchronous job queue with transactional adapters, concurrency controls, backoff retries, and graceful shutdown for the **Argos-JS** framework.
4
+
5
+ ---
6
+
7
+ ## Features
8
+
9
+ - **Strict Conceptual Separation:** Dedicated purely to event-driven, on-demand jobs (emails, webhooks, heavy background processing).
10
+ - **Zero External Required Dependencies:** Out-of-the-box support for `MemoryAdapter` (in-memory, testing, development) and `DatabaseAdapter` (`@argos-js/data` transactional with `SELECT ... FOR UPDATE SKIP LOCKED` on PostgreSQL/MySQL, or atomic transactions on SQLite).
11
+ - **Pluggable Architecture:** Ready for future native Rust engines, ArgosDB, or optional Redis drivers without forcing BullMQ or Redis.
12
+ - **Type-Safe Job Definitions:** `defineJob<TPayload>()` with inferred payload typing and cooperative `JobContext` (`jobId`, `attempt`, `signal`, `progress`).
13
+ - **Cooperative Graceful Shutdown:** Listens to `SIGTERM`/`SIGINT`, propagates `AbortSignal` to active jobs, and drains running tasks before terminating.
14
+ - **Configurable Backoff Retries:** Supports exponential and fixed backoff strategies.
15
+
16
+ ---
17
+
18
+ ## Installation
19
+
20
+ ```bash
21
+ pnpm add @argos-js/queue
22
+ ```
23
+
24
+ ---
25
+
26
+ ## Quick Start
27
+
28
+ ### 1. Defining a Job
29
+
30
+ ```typescript
31
+ import { defineJob } from '@argos-js/queue';
32
+
33
+ export interface SendWelcomeEmailPayload {
34
+ to: string;
35
+ name: string;
36
+ }
37
+
38
+ export const sendWelcomeEmailJob = defineJob<SendWelcomeEmailPayload>({
39
+ name: 'send-welcome-email',
40
+ attempts: 3,
41
+ backoff: {
42
+ type: 'exponential',
43
+ delayMs: 1000, // 1s, 2s, 4s...
44
+ },
45
+ handler: async (payload, context) => {
46
+ console.log(`[Job ${context.jobId}] Attempt ${context.attempt} sending email to ${payload.to}`);
47
+
48
+ // Cooperative cancellation check
49
+ if (context.signal.aborted) {
50
+ throw new Error('Worker is shutting down');
51
+ }
52
+
53
+ await context.progress(25);
54
+ // Send email logic...
55
+ await context.progress(100);
56
+ },
57
+ });
58
+ ```
59
+
60
+ ### 2. Dispatching a Job
61
+
62
+ ```typescript
63
+ // Dispatch immediately
64
+ const jobId = await sendWelcomeEmailJob.dispatch({
65
+ to: 'alice@example.com',
66
+ name: 'Alice',
67
+ });
68
+
69
+ // Dispatch with delay or specific queue
70
+ const delayedJobId = await sendWelcomeEmailJob.dispatch(
71
+ { to: 'bob@example.com', name: 'Bob' },
72
+ { delayMs: 60000, queue: 'high-priority' }
73
+ );
74
+ ```
75
+
76
+ ### 3. Running a Queue Worker
77
+
78
+ ```typescript
79
+ import { QueueWorker, DatabaseAdapter, setDefaultQueueAdapter } from '@argos-js/queue';
80
+ import { createDatabase } from '@argos-js/data';
81
+
82
+ // Optional: Use persistent database adapter
83
+ const db = createDatabase({
84
+ driver: 'postgres',
85
+ connectionString: process.env.DATABASE_URL,
86
+ });
87
+
88
+ const adapter = new DatabaseAdapter(db);
89
+ setDefaultQueueAdapter(adapter);
90
+
91
+ const worker = new QueueWorker({
92
+ concurrency: 4,
93
+ queues: ['high-priority', 'default'],
94
+ adapter,
95
+ });
96
+
97
+ // Setup SIGTERM / SIGINT graceful handling
98
+ worker.setupSignalHandlers();
99
+
100
+ await worker.start();
101
+ ```
102
+
103
+ ---
104
+
105
+ ## CLI Management
106
+
107
+ The official Argos CLI provides semantic commands to control queue workers:
108
+
109
+ ```bash
110
+ # Start queue workers
111
+ argos queue start --workers=4 --queues=high,default
112
+
113
+ # Check queue status (pending, processing, completed, failed)
114
+ argos queue status
115
+
116
+ # Clear jobs from a specific queue
117
+ argos queue clear default
118
+ ```
119
+
120
+ ---
121
+
122
+ ## Production Deployment
123
+
124
+ ### Systemd Service (`/etc/systemd/system/argos-queue.service`)
125
+
126
+ ```ini
127
+ [Unit]
128
+ Description=Argos-JS Background Queue Worker
129
+ After=network.target
130
+
131
+ [Service]
132
+ Type=simple
133
+ User=argos
134
+ WorkingDirectory=/var/www/my-argos-app
135
+ Environment=NODE_ENV=production
136
+ ExecStart=/usr/bin/node ./dist/app/index.js --worker
137
+ Restart=always
138
+ RestartSec=5
139
+ KillSignal=SIGTERM
140
+ TimeoutStopSec=30
141
+
142
+ [Install]
143
+ WantedBy=multi-user.target
144
+ ```
145
+
146
+ ### Docker Container
147
+
148
+ ```dockerfile
149
+ FROM node:20-alpine AS runner
150
+ WORKDIR /app
151
+
152
+ COPY package.json pnpm-lock.yaml ./
153
+ RUN npm install -g pnpm && pnpm install --prod
154
+
155
+ COPY dist ./dist
156
+
157
+ ENV NODE_ENV=production
158
+ STOPSIGNAL SIGTERM
159
+
160
+ CMD ["node", "./node_modules/@argos-js/cli/bin/argos.js", "queue", "start", "--workers=4"]
161
+ ```
@@ -0,0 +1,34 @@
1
+ import type { DatabaseClient } from '@argos-js/data';
2
+ import type { QueueAdapter, QueuedJobItem, QueueStatusSummary } from './types.js';
3
+ export declare class MemoryAdapter implements QueueAdapter {
4
+ private jobs;
5
+ enqueue(item: QueuedJobItem): Promise<void>;
6
+ fetchNext(queues: string[], concurrency: number): Promise<QueuedJobItem[]>;
7
+ ack(jobId: string): Promise<void>;
8
+ fail(jobId: string, error: unknown, retryAt?: Date): Promise<void>;
9
+ updateProgress(jobId: string, percent: number): Promise<void>;
10
+ clear(queue?: string): Promise<number>;
11
+ status(queue?: string): Promise<QueueStatusSummary>;
12
+ close(): Promise<void>;
13
+ }
14
+ export declare class DatabaseAdapter implements QueueAdapter {
15
+ private client;
16
+ private tableName;
17
+ private initialized;
18
+ constructor(client: DatabaseClient, options?: {
19
+ tableName?: string;
20
+ });
21
+ ensureSchema(): Promise<void>;
22
+ enqueue(item: QueuedJobItem): Promise<void>;
23
+ fetchNext(queues: string[], concurrency: number): Promise<QueuedJobItem[]>;
24
+ ack(jobId: string): Promise<void>;
25
+ fail(jobId: string, error: unknown, retryAt?: Date): Promise<void>;
26
+ updateProgress(jobId: string, percent: number): Promise<void>;
27
+ clear(queue?: string): Promise<number>;
28
+ status(queue?: string): Promise<QueueStatusSummary>;
29
+ close(): Promise<void>;
30
+ private rowToItem;
31
+ }
32
+ export declare function getDefaultQueueAdapter(): QueueAdapter;
33
+ export declare function setDefaultQueueAdapter(adapter: QueueAdapter): void;
34
+ //# sourceMappingURL=adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElF,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,IAAI,CAAuB;IAEtB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAoB1E,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWtC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiBnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC;AAED,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAOvD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA8E7B,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC3C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAwE1E,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IActC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqCnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,OAAO,CAAC,SAAS;CA8BlB;AAID,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAElE"}
@@ -0,0 +1,394 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DatabaseAdapter = exports.MemoryAdapter = void 0;
4
+ exports.getDefaultQueueAdapter = getDefaultQueueAdapter;
5
+ exports.setDefaultQueueAdapter = setDefaultQueueAdapter;
6
+ class MemoryAdapter {
7
+ jobs = [];
8
+ async enqueue(item) {
9
+ this.jobs.push({
10
+ ...item,
11
+ payload: JSON.parse(JSON.stringify(item.payload)),
12
+ });
13
+ }
14
+ async fetchNext(queues, concurrency) {
15
+ const now = Date.now();
16
+ const eligible = this.jobs.filter((job) => queues.includes(job.queue) &&
17
+ job.status === 'pending' &&
18
+ job.availableAt.getTime() <= now);
19
+ eligible.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
20
+ const selected = eligible.slice(0, concurrency);
21
+ for (const job of selected) {
22
+ job.status = 'processing';
23
+ job.processedAt = new Date();
24
+ }
25
+ return selected.map((j) => ({ ...j, payload: JSON.parse(JSON.stringify(j.payload)) }));
26
+ }
27
+ async ack(jobId) {
28
+ const job = this.jobs.find((j) => j.id === jobId);
29
+ if (job) {
30
+ job.status = 'completed';
31
+ job.completedAt = new Date();
32
+ }
33
+ }
34
+ async fail(jobId, error, retryAt) {
35
+ const job = this.jobs.find((j) => j.id === jobId);
36
+ if (job) {
37
+ job.attempts += 1;
38
+ job.error = error instanceof Error ? error.message : String(error);
39
+ if (retryAt) {
40
+ job.status = 'pending';
41
+ job.availableAt = retryAt;
42
+ job.processedAt = undefined;
43
+ }
44
+ else {
45
+ job.status = 'failed';
46
+ job.completedAt = new Date();
47
+ }
48
+ }
49
+ }
50
+ async updateProgress(jobId, percent) {
51
+ const job = this.jobs.find((j) => j.id === jobId);
52
+ if (job) {
53
+ job.progress = percent;
54
+ }
55
+ }
56
+ async clear(queue) {
57
+ if (queue) {
58
+ const before = this.jobs.length;
59
+ this.jobs = this.jobs.filter((j) => j.queue !== queue);
60
+ return before - this.jobs.length;
61
+ }
62
+ const count = this.jobs.length;
63
+ this.jobs = [];
64
+ return count;
65
+ }
66
+ async status(queue) {
67
+ const target = queue ? this.jobs.filter((j) => j.queue === queue) : this.jobs;
68
+ const pending = target.filter((j) => j.status === 'pending').length;
69
+ const processing = target.filter((j) => j.status === 'processing').length;
70
+ const completed = target.filter((j) => j.status === 'completed').length;
71
+ const failed = target.filter((j) => j.status === 'failed').length;
72
+ return {
73
+ queue,
74
+ pending,
75
+ processing,
76
+ completed,
77
+ failed,
78
+ total: target.length,
79
+ };
80
+ }
81
+ async close() {
82
+ this.jobs = [];
83
+ }
84
+ }
85
+ exports.MemoryAdapter = MemoryAdapter;
86
+ class DatabaseAdapter {
87
+ client;
88
+ tableName = '_argos_jobs';
89
+ initialized = false;
90
+ constructor(client, options) {
91
+ this.client = client;
92
+ if (options?.tableName) {
93
+ this.tableName = options.tableName;
94
+ }
95
+ }
96
+ async ensureSchema() {
97
+ if (this.initialized)
98
+ return;
99
+ const driver = this.client.driverName.toLowerCase();
100
+ const isPg = driver.includes('postgres') || driver === 'pg';
101
+ const isMysql = driver.includes('mysql');
102
+ if (isPg) {
103
+ await this.client.execute(`
104
+ CREATE TABLE IF NOT EXISTS ${this.tableName} (
105
+ id VARCHAR(64) PRIMARY KEY,
106
+ name VARCHAR(255) NOT NULL,
107
+ queue VARCHAR(100) NOT NULL DEFAULT 'default',
108
+ payload TEXT NOT NULL,
109
+ attempts INT NOT NULL DEFAULT 0,
110
+ max_attempts INT NOT NULL DEFAULT 3,
111
+ backoff_type VARCHAR(32) DEFAULT 'fixed',
112
+ backoff_delay_ms INT DEFAULT 1000,
113
+ status VARCHAR(32) NOT NULL DEFAULT 'pending',
114
+ error TEXT,
115
+ progress REAL DEFAULT 0,
116
+ created_at BIGINT NOT NULL,
117
+ available_at BIGINT NOT NULL,
118
+ processed_at BIGINT,
119
+ completed_at BIGINT
120
+ );
121
+ CREATE INDEX IF NOT EXISTS idx_argos_jobs_lookup ON ${this.tableName} (queue, status, available_at);
122
+ `);
123
+ }
124
+ else if (isMysql) {
125
+ await this.client.execute(`
126
+ CREATE TABLE IF NOT EXISTS ${this.tableName} (
127
+ id VARCHAR(64) PRIMARY KEY,
128
+ name VARCHAR(255) NOT NULL,
129
+ queue VARCHAR(100) NOT NULL DEFAULT 'default',
130
+ payload LONGTEXT NOT NULL,
131
+ attempts INT NOT NULL DEFAULT 0,
132
+ max_attempts INT NOT NULL DEFAULT 3,
133
+ backoff_type VARCHAR(32) DEFAULT 'fixed',
134
+ backoff_delay_ms INT DEFAULT 1000,
135
+ status VARCHAR(32) NOT NULL DEFAULT 'pending',
136
+ error TEXT,
137
+ progress FLOAT DEFAULT 0,
138
+ created_at BIGINT NOT NULL,
139
+ available_at BIGINT NOT NULL,
140
+ processed_at BIGINT,
141
+ completed_at BIGINT,
142
+ INDEX idx_argos_jobs_lookup (queue, status, available_at)
143
+ );
144
+ `);
145
+ }
146
+ else {
147
+ // SQLite
148
+ await this.client.execute(`
149
+ CREATE TABLE IF NOT EXISTS ${this.tableName} (
150
+ id TEXT PRIMARY KEY,
151
+ name TEXT NOT NULL,
152
+ queue TEXT NOT NULL DEFAULT 'default',
153
+ payload TEXT NOT NULL,
154
+ attempts INTEGER NOT NULL DEFAULT 0,
155
+ max_attempts INTEGER NOT NULL DEFAULT 3,
156
+ backoff_type TEXT DEFAULT 'fixed',
157
+ backoff_delay_ms INTEGER DEFAULT 1000,
158
+ status TEXT NOT NULL DEFAULT 'pending',
159
+ error TEXT,
160
+ progress REAL DEFAULT 0,
161
+ created_at INTEGER NOT NULL,
162
+ available_at INTEGER NOT NULL,
163
+ processed_at INTEGER,
164
+ completed_at INTEGER
165
+ );
166
+ `);
167
+ await this.client.execute(`
168
+ CREATE INDEX IF NOT EXISTS idx_argos_jobs_lookup ON ${this.tableName} (queue, status, available_at);
169
+ `);
170
+ }
171
+ this.initialized = true;
172
+ }
173
+ async enqueue(item) {
174
+ await this.ensureSchema();
175
+ const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
176
+ const params = [
177
+ item.id,
178
+ item.name,
179
+ item.queue,
180
+ JSON.stringify(item.payload),
181
+ item.attempts,
182
+ item.maxAttempts,
183
+ item.backoff?.type || 'fixed',
184
+ item.backoff?.delayMs || 1000,
185
+ item.status,
186
+ item.error ?? null,
187
+ item.progress ?? 0,
188
+ item.createdAt.getTime(),
189
+ item.availableAt.getTime(),
190
+ item.processedAt ? item.processedAt.getTime() : null,
191
+ item.completedAt ? item.completedAt.getTime() : null,
192
+ ];
193
+ const placeholders = isPg
194
+ ? params.map((_, i) => `$${i + 1}`).join(', ')
195
+ : params.map(() => '?').join(', ');
196
+ const sql = `
197
+ INSERT INTO ${this.tableName} (
198
+ id, name, queue, payload, attempts, max_attempts,
199
+ backoff_type, backoff_delay_ms, status, error, progress,
200
+ created_at, available_at, processed_at, completed_at
201
+ ) VALUES (${placeholders})
202
+ `;
203
+ await this.client.execute(sql, params);
204
+ }
205
+ async fetchNext(queues, concurrency) {
206
+ if (concurrency <= 0 || queues.length === 0)
207
+ return [];
208
+ await this.ensureSchema();
209
+ const driver = this.client.driverName.toLowerCase();
210
+ const isPg = driver.includes('postgres') || driver === 'pg';
211
+ const isMysql = driver.includes('mysql');
212
+ const now = Date.now();
213
+ return await this.client.transaction(async (trx) => {
214
+ let rows = [];
215
+ if (isPg) {
216
+ const queueParams = queues.map((_, i) => `$${i + 1}`).join(', ');
217
+ const timeParam = `$${queues.length + 1}`;
218
+ const limitParam = `$${queues.length + 2}`;
219
+ const selectSql = `
220
+ SELECT * FROM ${this.tableName}
221
+ WHERE queue IN (${queueParams}) AND status = 'pending' AND available_at <= ${timeParam}
222
+ ORDER BY created_at ASC
223
+ LIMIT ${limitParam}
224
+ FOR UPDATE SKIP LOCKED
225
+ `;
226
+ const res = await trx.execute(selectSql, [...queues, now, concurrency]);
227
+ rows = res.rows;
228
+ }
229
+ else if (isMysql) {
230
+ const queueParams = queues.map(() => '?').join(', ');
231
+ const selectSql = `
232
+ SELECT * FROM ${this.tableName}
233
+ WHERE queue IN (${queueParams}) AND status = 'pending' AND available_at <= ?
234
+ ORDER BY created_at ASC
235
+ LIMIT ?
236
+ FOR UPDATE SKIP LOCKED
237
+ `;
238
+ const res = await trx.execute(selectSql, [...queues, now, concurrency]);
239
+ rows = res.rows;
240
+ }
241
+ else {
242
+ // SQLite
243
+ const queueParams = queues.map(() => '?').join(', ');
244
+ const selectSql = `
245
+ SELECT * FROM ${this.tableName}
246
+ WHERE queue IN (${queueParams}) AND status = 'pending' AND available_at <= ?
247
+ ORDER BY created_at ASC
248
+ LIMIT ?
249
+ `;
250
+ const res = await trx.execute(selectSql, [...queues, now, concurrency]);
251
+ rows = res.rows;
252
+ }
253
+ if (!rows || rows.length === 0) {
254
+ return [];
255
+ }
256
+ const ids = rows.map((r) => r.id);
257
+ if (isPg) {
258
+ const idPlaceholders = ids.map((_, i) => `$${i + 2}`).join(', ');
259
+ await trx.execute(`UPDATE ${this.tableName} SET status = 'processing', processed_at = $1 WHERE id IN (${idPlaceholders})`, [now, ...ids]);
260
+ }
261
+ else {
262
+ const idPlaceholders = ids.map(() => '?').join(', ');
263
+ await trx.execute(`UPDATE ${this.tableName} SET status = 'processing', processed_at = ? WHERE id IN (${idPlaceholders})`, [now, ...ids]);
264
+ }
265
+ return rows.map((r) => this.rowToItem(r));
266
+ });
267
+ }
268
+ async ack(jobId) {
269
+ await this.ensureSchema();
270
+ const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
271
+ const now = Date.now();
272
+ const sql = isPg
273
+ ? `UPDATE ${this.tableName} SET status = 'completed', completed_at = $1 WHERE id = $2`
274
+ : `UPDATE ${this.tableName} SET status = 'completed', completed_at = ? WHERE id = ?`;
275
+ await this.client.execute(sql, [now, jobId]);
276
+ }
277
+ async fail(jobId, error, retryAt) {
278
+ await this.ensureSchema();
279
+ const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
280
+ const errMessage = error instanceof Error ? error.message : String(error);
281
+ const now = Date.now();
282
+ if (retryAt) {
283
+ const sql = isPg
284
+ ? `UPDATE ${this.tableName} SET status = 'pending', attempts = attempts + 1, error = $1, available_at = $2, processed_at = NULL WHERE id = $3`
285
+ : `UPDATE ${this.tableName} SET status = 'pending', attempts = attempts + 1, error = ?, available_at = ?, processed_at = NULL WHERE id = ?`;
286
+ await this.client.execute(sql, [errMessage, retryAt.getTime(), jobId]);
287
+ }
288
+ else {
289
+ const sql = isPg
290
+ ? `UPDATE ${this.tableName} SET status = 'failed', attempts = attempts + 1, error = $1, completed_at = $2 WHERE id = $3`
291
+ : `UPDATE ${this.tableName} SET status = 'failed', attempts = attempts + 1, error = ?, completed_at = ? WHERE id = ?`;
292
+ await this.client.execute(sql, [errMessage, now, jobId]);
293
+ }
294
+ }
295
+ async updateProgress(jobId, percent) {
296
+ await this.ensureSchema();
297
+ const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
298
+ const sql = isPg
299
+ ? `UPDATE ${this.tableName} SET progress = $1 WHERE id = $2`
300
+ : `UPDATE ${this.tableName} SET progress = ? WHERE id = ?`;
301
+ await this.client.execute(sql, [percent, jobId]);
302
+ }
303
+ async clear(queue) {
304
+ await this.ensureSchema();
305
+ const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
306
+ if (queue) {
307
+ const sql = isPg
308
+ ? `DELETE FROM ${this.tableName} WHERE queue = $1`
309
+ : `DELETE FROM ${this.tableName} WHERE queue = ?`;
310
+ const res = await this.client.execute(sql, [queue]);
311
+ return res.rowCount ?? 0;
312
+ }
313
+ const res = await this.client.execute(`DELETE FROM ${this.tableName}`);
314
+ return res.rowCount ?? 0;
315
+ }
316
+ async status(queue) {
317
+ await this.ensureSchema();
318
+ const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
319
+ let sql = `SELECT status, COUNT(*) as count FROM ${this.tableName} GROUP BY status`;
320
+ let params = [];
321
+ if (queue) {
322
+ sql = isPg
323
+ ? `SELECT status, COUNT(*) as count FROM ${this.tableName} WHERE queue = $1 GROUP BY status`
324
+ : `SELECT status, COUNT(*) as count FROM ${this.tableName} WHERE queue = ? GROUP BY status`;
325
+ params = [queue];
326
+ }
327
+ const res = await this.client.execute(sql, params);
328
+ let pending = 0;
329
+ let processing = 0;
330
+ let completed = 0;
331
+ let failed = 0;
332
+ for (const row of res.rows) {
333
+ const cnt = Number(row.count) || 0;
334
+ if (row.status === 'pending')
335
+ pending = cnt;
336
+ else if (row.status === 'processing')
337
+ processing = cnt;
338
+ else if (row.status === 'completed')
339
+ completed = cnt;
340
+ else if (row.status === 'failed')
341
+ failed = cnt;
342
+ }
343
+ return {
344
+ queue,
345
+ pending,
346
+ processing,
347
+ completed,
348
+ failed,
349
+ total: pending + processing + completed + failed,
350
+ };
351
+ }
352
+ async close() {
353
+ // client disconnect can be managed by application lifecycle
354
+ }
355
+ rowToItem(row) {
356
+ let payload = row.payload;
357
+ if (typeof payload === 'string') {
358
+ try {
359
+ payload = JSON.parse(payload);
360
+ }
361
+ catch { }
362
+ }
363
+ return {
364
+ id: String(row.id),
365
+ name: String(row.name),
366
+ queue: String(row.queue),
367
+ payload,
368
+ attempts: Number(row.attempts),
369
+ maxAttempts: Number(row.max_attempts),
370
+ backoff: row.backoff_type
371
+ ? {
372
+ type: row.backoff_type,
373
+ delayMs: Number(row.backoff_delay_ms),
374
+ }
375
+ : undefined,
376
+ status: row.status,
377
+ error: row.error ?? undefined,
378
+ progress: row.progress !== null && row.progress !== undefined ? Number(row.progress) : undefined,
379
+ createdAt: new Date(Number(row.created_at)),
380
+ availableAt: new Date(Number(row.available_at)),
381
+ processedAt: row.processed_at ? new Date(Number(row.processed_at)) : undefined,
382
+ completedAt: row.completed_at ? new Date(Number(row.completed_at)) : undefined,
383
+ };
384
+ }
385
+ }
386
+ exports.DatabaseAdapter = DatabaseAdapter;
387
+ let defaultAdapter = new MemoryAdapter();
388
+ function getDefaultQueueAdapter() {
389
+ return defaultAdapter;
390
+ }
391
+ function setDefaultQueueAdapter(adapter) {
392
+ defaultAdapter = adapter;
393
+ }
394
+ //# sourceMappingURL=adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";;;AAuaA,wDAEC;AAED,wDAEC;AA1aD,MAAa,aAAa;IAChB,IAAI,GAAoB,EAAE,CAAC;IAE5B,KAAK,CAAC,OAAO,CAAC,IAAmB;QACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACb,GAAG,IAAI;YACP,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SAClD,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,MAAgB,EAAE,WAAmB;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAC/B,CAAC,GAAG,EAAE,EAAE,CACN,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;YAC1B,GAAG,CAAC,MAAM,KAAK,SAAS;YACxB,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,GAAG,CACnC,CAAC;QAEF,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAEhD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC;YAC1B,GAAG,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzF,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,KAAa;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;QAClD,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;YACzB,GAAG,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,KAAc,EAAE,OAAc;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;QAClD,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;YAClB,GAAG,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;gBACvB,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;gBAC1B,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;gBACtB,GAAG,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,OAAe;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;QAClD,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC;QACzB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,KAAc;QAC/B,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;YACvD,OAAO,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,KAAc;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QACpE,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC;QAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QAElE,OAAO;YACL,KAAK;YACL,OAAO;YACP,UAAU;YACV,SAAS;YACT,MAAM;YACN,KAAK,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,CAAC;CACF;AA5FD,sCA4FC;AAED,MAAa,eAAe;IAClB,MAAM,CAAiB;IACvB,SAAS,GAAG,aAAa,CAAC;IAC1B,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,MAAsB,EAAE,OAAgC;QAClE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACrC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,YAAY;QACvB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC;QAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;qCACK,IAAI,CAAC,SAAS;;;;;;;;;;;;;;;;;8DAiBW,IAAI,CAAC,SAAS;OACrE,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;qCACK,IAAI,CAAC,SAAS;;;;;;;;;;;;;;;;;;OAkB5C,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,SAAS;YACT,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;qCACK,IAAI,CAAC,SAAS;;;;;;;;;;;;;;;;;OAiB5C,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;8DAC8B,IAAI,CAAC,SAAS;OACrE,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAmB;QACtC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;QAC5F,MAAM,MAAM,GAAG;YACb,IAAI,CAAC,EAAE;YACP,IAAI,CAAC,IAAI;YACT,IAAI,CAAC,KAAK;YACV,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,QAAQ;YACb,IAAI,CAAC,WAAW;YAChB,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,OAAO;YAC7B,IAAI,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI;YAC7B,IAAI,CAAC,MAAM;YACX,IAAI,CAAC,KAAK,IAAI,IAAI;YAClB,IAAI,CAAC,QAAQ,IAAI,CAAC;YAClB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;YACxB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE;YAC1B,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;YACpD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;SACrD,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI;YACvB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG;oBACI,IAAI,CAAC,SAAS;;;;kBAIhB,YAAY;KACzB,CAAC;QAEF,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,MAAgB,EAAE,WAAmB;QAC1D,IAAI,WAAW,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC;QAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACjD,IAAI,IAAI,GAAU,EAAE,CAAC;YAErB,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjE,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,SAAS,GAAG;0BACA,IAAI,CAAC,SAAS;4BACZ,WAAW,gDAAgD,SAAS;;kBAE9E,UAAU;;SAEnB,CAAC;gBACF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;gBACxE,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YAClB,CAAC;iBAAM,IAAI,OAAO,EAAE,CAAC;gBACnB,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,SAAS,GAAG;0BACA,IAAI,CAAC,SAAS;4BACZ,WAAW;;;;SAI9B,CAAC;gBACF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;gBACxE,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,SAAS;gBACT,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,SAAS,GAAG;0BACA,IAAI,CAAC,SAAS;4BACZ,WAAW;;;SAG9B,CAAC;gBACF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;gBACxE,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YAClB,CAAC;YAED,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjE,MAAM,GAAG,CAAC,OAAO,CACf,UAAU,IAAI,CAAC,SAAS,8DAA8D,cAAc,GAAG,EACvG,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CACd,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,GAAG,CAAC,OAAO,CACf,UAAU,IAAI,CAAC,SAAS,6DAA6D,cAAc,GAAG,EACtG,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CACd,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,KAAa;QAC5B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;QAC5F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI;YACd,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,4DAA4D;YACtF,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,0DAA0D,CAAC;QACvF,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,KAAc,EAAE,OAAc;QAC7D,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;QAC5F,MAAM,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI;gBACd,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,oHAAoH;gBAC9I,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,iHAAiH,CAAC;YAC9I,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QACzE,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,IAAI;gBACd,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,8FAA8F;gBACxH,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,2FAA2F,CAAC;YACxH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,OAAe;QACxD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;QAC5F,MAAM,GAAG,GAAG,IAAI;YACd,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,kCAAkC;YAC5D,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,gCAAgC,CAAC;QAC7D,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,KAAc;QAC/B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;QAC5F,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,IAAI;gBACd,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,mBAAmB;gBAClD,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,kBAAkB,CAAC;YACpD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YACpD,OAAO,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACvE,OAAO,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,KAAc;QAChC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;QAC5F,IAAI,GAAG,GAAG,yCAAyC,IAAI,CAAC,SAAS,kBAAkB,CAAC;QACpF,IAAI,MAAM,GAAU,EAAE,CAAC;QAEvB,IAAI,KAAK,EAAE,CAAC;YACV,GAAG,GAAG,IAAI;gBACR,CAAC,CAAC,yCAAyC,IAAI,CAAC,SAAS,mCAAmC;gBAC5F,CAAC,CAAC,yCAAyC,IAAI,CAAC,SAAS,kCAAkC,CAAC;YAC9F,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAA6C,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/F,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,GAAG,GAAG,CAAC;iBACvC,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY;gBAAE,UAAU,GAAG,GAAG,CAAC;iBAClD,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;gBAAE,SAAS,GAAG,GAAG,CAAC;iBAChD,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;gBAAE,MAAM,GAAG,GAAG,CAAC;QACjD,CAAC;QAED,OAAO;YACL,KAAK;YACL,OAAO;YACP,UAAU;YACV,SAAS;YACT,MAAM;YACN,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM;SACjD,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,4DAA4D;IAC9D,CAAC;IAEO,SAAS,CAAC,GAAQ;QACxB,IAAI,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QAED,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YACtB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YACxB,OAAO;YACP,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC9B,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;YACrC,OAAO,EAAE,GAAG,CAAC,YAAY;gBACvB,CAAC,CAAC;oBACE,IAAI,EAAE,GAAG,CAAC,YAAuC;oBACjD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;iBACtC;gBACH,CAAC,CAAC,SAAS;YACb,MAAM,EAAE,GAAG,CAAC,MAAa;YACzB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;YAC7B,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;YAChG,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC3C,WAAW,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC/C,WAAW,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;YAC9E,WAAW,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;SAC/E,CAAC;IACJ,CAAC;CACF;AAlUD,0CAkUC;AAED,IAAI,cAAc,GAAiB,IAAI,aAAa,EAAE,CAAC;AAEvD,SAAgB,sBAAsB;IACpC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,SAAgB,sBAAsB,CAAC,OAAqB;IAC1D,cAAc,GAAG,OAAO,CAAC;AAC3B,CAAC"}
@@ -0,0 +1,6 @@
1
+ export * from './types.js';
2
+ export * from './adapter.js';
3
+ export * from './job.js';
4
+ export * from './worker.js';
5
+ export * from './native-bridge.js';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,22 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./types.js"), exports);
18
+ __exportStar(require("./adapter.js"), exports);
19
+ __exportStar(require("./job.js"), exports);
20
+ __exportStar(require("./worker.js"), exports);
21
+ __exportStar(require("./native-bridge.js"), exports);
22
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,+CAA6B;AAC7B,2CAAyB;AACzB,8CAA4B;AAC5B,qDAAmC"}
package/dist/job.d.ts ADDED
@@ -0,0 +1,12 @@
1
+ import type { JobDefinition, JobInstance } from './types.js';
2
+ declare class GlobalJobRegistry {
3
+ private jobs;
4
+ register<T>(job: JobInstance<T>): void;
5
+ get<T = any>(name: string): JobInstance<T> | undefined;
6
+ getAll(): JobInstance<any>[];
7
+ clear(): void;
8
+ }
9
+ export declare const JobRegistry: GlobalJobRegistry;
10
+ export declare function defineJob<TPayload = any>(options: JobDefinition<TPayload>): JobInstance<TPayload>;
11
+ export {};
12
+ //# sourceMappingURL=job.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EAEb,WAAW,EAEZ,MAAM,YAAY,CAAC;AAGpB,cAAM,iBAAiB;IACrB,OAAO,CAAC,IAAI,CAAuC;IAE5C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAItC,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAItD,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE;IAI5B,KAAK,IAAI,IAAI;CAGrB;AAED,eAAO,MAAM,WAAW,mBAA0B,CAAC;AAEnD,wBAAgB,SAAS,CAAC,QAAQ,GAAG,GAAG,EACtC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,GAC/B,WAAW,CAAC,QAAQ,CAAC,CAiCvB"}
package/dist/job.js ADDED
@@ -0,0 +1,54 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.JobRegistry = void 0;
4
+ exports.defineJob = defineJob;
5
+ const node_crypto_1 = require("node:crypto");
6
+ const adapter_js_1 = require("./adapter.js");
7
+ class GlobalJobRegistry {
8
+ jobs = new Map();
9
+ register(job) {
10
+ this.jobs.set(job.name, job);
11
+ }
12
+ get(name) {
13
+ return this.jobs.get(name);
14
+ }
15
+ getAll() {
16
+ return Array.from(this.jobs.values());
17
+ }
18
+ clear() {
19
+ this.jobs.clear();
20
+ }
21
+ }
22
+ exports.JobRegistry = new GlobalJobRegistry();
23
+ function defineJob(options) {
24
+ const instance = {
25
+ definition: options,
26
+ name: options.name,
27
+ async dispatch(payload, dispatchOptions) {
28
+ const adapter = (0, adapter_js_1.getDefaultQueueAdapter)();
29
+ const now = Date.now();
30
+ const delayMs = dispatchOptions?.delayMs ?? 0;
31
+ const jobId = node_crypto_1.randomUUID ? (0, node_crypto_1.randomUUID)() : `job_${now}_${Math.random().toString(36).slice(2, 8)}`;
32
+ const item = {
33
+ id: jobId,
34
+ name: options.name,
35
+ queue: dispatchOptions?.queue ?? options.options?.queue ?? options.queue ?? 'default',
36
+ payload,
37
+ attempts: 0,
38
+ maxAttempts: dispatchOptions?.attempts ?? options.options?.attempts ?? options.attempts ?? 3,
39
+ backoff: dispatchOptions?.backoff ?? options.options?.backoff ?? options.backoff ?? {
40
+ type: 'exponential',
41
+ delayMs: 1000,
42
+ },
43
+ status: 'pending',
44
+ createdAt: new Date(now),
45
+ availableAt: new Date(now + delayMs),
46
+ };
47
+ await adapter.enqueue(item);
48
+ return jobId;
49
+ },
50
+ };
51
+ exports.JobRegistry.register(instance);
52
+ return instance;
53
+ }
54
+ //# sourceMappingURL=job.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"job.js","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":";;;AA+BA,8BAmCC;AAlED,6CAAyC;AAOzC,6CAAsD;AAEtD,MAAM,iBAAiB;IACb,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE5C,QAAQ,CAAI,GAAmB;QACpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAEM,GAAG,CAAU,IAAY;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAEM,MAAM;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF;AAEY,QAAA,WAAW,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAEnD,SAAgB,SAAS,CACvB,OAAgC;IAEhC,MAAM,QAAQ,GAA0B;QACtC,UAAU,EAAE,OAAO;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,CAAC,QAAQ,CAAC,OAAiB,EAAE,eAAoC;YACpE,MAAM,OAAO,GAAG,IAAA,mCAAsB,GAAE,CAAC;YACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,eAAe,EAAE,OAAO,IAAI,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,wBAAU,CAAC,CAAC,CAAC,IAAA,wBAAU,GAAE,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAEjG,MAAM,IAAI,GAA4B;gBACpC,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,eAAe,EAAE,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,SAAS;gBACrF,OAAO;gBACP,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,eAAe,EAAE,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC;gBAC5F,OAAO,EAAE,eAAe,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,IAAI;oBAClF,IAAI,EAAE,aAAa;oBACnB,OAAO,EAAE,IAAI;iBACd;gBACD,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC;gBACxB,WAAW,EAAE,IAAI,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC;aACrC,CAAC;YAEF,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;IAEF,mBAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC"}
@@ -0,0 +1,26 @@
1
+ export interface NativeQueueBindingModule {
2
+ NativeLockManager?: new () => {
3
+ acquireLock(key: string, ttlMs: number): boolean;
4
+ acquire_lock?(key: string, ttlMs: number): boolean;
5
+ releaseLock(key: string): boolean;
6
+ release_lock?(key: string): boolean;
7
+ isLocked(key: string): boolean;
8
+ is_locked?(key: string): boolean;
9
+ cleanExpired?(): number;
10
+ destroy?(): void;
11
+ };
12
+ }
13
+ /**
14
+ * Attempts to load native bindings for the queue engine.
15
+ * Returns null if native engine is absent or disabled via ARGOS_DISABLE_NATIVE=true.
16
+ */
17
+ export declare function loadQueueNativeBindings(): NativeQueueBindingModule | null;
18
+ /**
19
+ * Checks whether native queue bindings are available.
20
+ */
21
+ export declare function hasQueueNativeBindings(): boolean;
22
+ /**
23
+ * Creates an instance of the native lock manager if available, or returns null.
24
+ */
25
+ export declare function createNativeLockManager(): any | null;
26
+ //# sourceMappingURL=native-bridge.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"native-bridge.d.ts","sourceRoot":"","sources":["../src/native-bridge.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,CAAC,EAAE,UAAU;QAC5B,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QACjD,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QACnD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAClC,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/B,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QACjC,YAAY,CAAC,IAAI,MAAM,CAAC;QACxB,OAAO,CAAC,IAAI,IAAI,CAAC;KAClB,CAAC;CACH;AAKD;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,wBAAwB,GAAG,IAAI,CA2DzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,GAAG,GAAG,IAAI,CAUpD"}
@@ -0,0 +1,91 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.loadQueueNativeBindings = loadQueueNativeBindings;
4
+ exports.hasQueueNativeBindings = hasQueueNativeBindings;
5
+ exports.createNativeLockManager = createNativeLockManager;
6
+ const node_module_1 = require("node:module");
7
+ const node_fs_1 = require("node:fs");
8
+ const node_path_1 = require("node:path");
9
+ let cachedQueueBindings = null;
10
+ let queueBindingsAttempted = false;
11
+ /**
12
+ * Attempts to load native bindings for the queue engine.
13
+ * Returns null if native engine is absent or disabled via ARGOS_DISABLE_NATIVE=true.
14
+ */
15
+ function loadQueueNativeBindings() {
16
+ if (process.env.ARGOS_DISABLE_NATIVE === 'true') {
17
+ return null;
18
+ }
19
+ if (queueBindingsAttempted) {
20
+ return cachedQueueBindings;
21
+ }
22
+ queueBindingsAttempted = true;
23
+ const candidateNames = [
24
+ '@argos-js/argox-core',
25
+ '@argos-js/native',
26
+ ];
27
+ let req;
28
+ if (typeof require !== 'undefined') {
29
+ req = require;
30
+ }
31
+ else {
32
+ req = (0, node_module_1.createRequire)((0, node_path_1.resolve)(process.cwd(), 'dummy.js'));
33
+ }
34
+ for (const name of candidateNames) {
35
+ try {
36
+ const mod = req(name);
37
+ if (mod && mod.NativeLockManager) {
38
+ cachedQueueBindings = mod;
39
+ return cachedQueueBindings;
40
+ }
41
+ }
42
+ catch {
43
+ // Continue
44
+ }
45
+ }
46
+ const cwd = process.cwd();
47
+ const candidatePaths = [
48
+ (0, node_path_1.resolve)(cwd, 'crates/argox-core/index.js'),
49
+ (0, node_path_1.resolve)(cwd, '../../crates/argox-core/index.js'),
50
+ (0, node_path_1.resolve)(cwd, '../crates/argox-core/index.js'),
51
+ (0, node_path_1.resolve)(cwd, 'crates/argox-core/index.node'),
52
+ (0, node_path_1.resolve)(cwd, '../../crates/argox-core/index.node'),
53
+ ];
54
+ for (const path of candidatePaths) {
55
+ if ((0, node_fs_1.existsSync)(path)) {
56
+ try {
57
+ const mod = req(path);
58
+ if (mod && mod.NativeLockManager) {
59
+ cachedQueueBindings = mod;
60
+ return cachedQueueBindings;
61
+ }
62
+ }
63
+ catch {
64
+ // Continue
65
+ }
66
+ }
67
+ }
68
+ return null;
69
+ }
70
+ /**
71
+ * Checks whether native queue bindings are available.
72
+ */
73
+ function hasQueueNativeBindings() {
74
+ return loadQueueNativeBindings() !== null;
75
+ }
76
+ /**
77
+ * Creates an instance of the native lock manager if available, or returns null.
78
+ */
79
+ function createNativeLockManager() {
80
+ const bindings = loadQueueNativeBindings();
81
+ if (bindings?.NativeLockManager) {
82
+ try {
83
+ return new bindings.NativeLockManager();
84
+ }
85
+ catch {
86
+ return null;
87
+ }
88
+ }
89
+ return null;
90
+ }
91
+ //# sourceMappingURL=native-bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"native-bridge.js","sourceRoot":"","sources":["../src/native-bridge.ts"],"names":[],"mappings":";;AAwBA,0DA2DC;AAKD,wDAEC;AAKD,0DAUC;AAzGD,6CAA4C;AAC5C,qCAAqC;AACrC,yCAAoC;AAepC,IAAI,mBAAmB,GAAoC,IAAI,CAAC;AAChE,IAAI,sBAAsB,GAAG,KAAK,CAAC;AAEnC;;;GAGG;AACH,SAAgB,uBAAuB;IACrC,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,sBAAsB,EAAE,CAAC;QAC3B,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,sBAAsB,GAAG,IAAI,CAAC;IAE9B,MAAM,cAAc,GAAG;QACrB,sBAAsB;QACtB,kBAAkB;KACnB,CAAC;IAEF,IAAI,GAAgB,CAAC;IACrB,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,GAAG,GAAG,OAAO,CAAC;IAChB,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,IAAA,2BAAa,EAAC,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;gBACjC,mBAAmB,GAAG,GAAG,CAAC;gBAC1B,OAAO,mBAAmB,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,cAAc,GAAG;QACrB,IAAA,mBAAO,EAAC,GAAG,EAAE,4BAA4B,CAAC;QAC1C,IAAA,mBAAO,EAAC,GAAG,EAAE,kCAAkC,CAAC;QAChD,IAAA,mBAAO,EAAC,GAAG,EAAE,+BAA+B,CAAC;QAC7C,IAAA,mBAAO,EAAC,GAAG,EAAE,8BAA8B,CAAC;QAC5C,IAAA,mBAAO,EAAC,GAAG,EAAE,oCAAoC,CAAC;KACnD,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,IAAA,oBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;gBACtB,IAAI,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;oBACjC,mBAAmB,GAAG,GAAG,CAAC;oBAC1B,OAAO,mBAAmB,CAAC;gBAC7B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB;IACpC,OAAO,uBAAuB,EAAE,KAAK,IAAI,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB;IACrC,MAAM,QAAQ,GAAG,uBAAuB,EAAE,CAAC;IAC3C,IAAI,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,77 @@
1
+ export type BackoffType = 'fixed' | 'exponential';
2
+ export interface JobBackoff {
3
+ type: BackoffType;
4
+ delayMs: number;
5
+ }
6
+ export interface JobContext {
7
+ jobId: string;
8
+ attempt: number;
9
+ signal: AbortSignal;
10
+ progress: (percent: number) => Promise<void>;
11
+ }
12
+ export interface JobOptions {
13
+ queue?: string | undefined;
14
+ attempts?: number | undefined;
15
+ backoff?: JobBackoff | undefined;
16
+ }
17
+ export interface JobDefinition<TPayload = any> {
18
+ name: string;
19
+ queue?: string | undefined;
20
+ attempts?: number | undefined;
21
+ backoff?: JobBackoff | undefined;
22
+ options?: JobOptions | undefined;
23
+ handler: (payload: TPayload, context: JobContext) => Promise<void>;
24
+ }
25
+ export interface JobDispatchOptions {
26
+ queue?: string | undefined;
27
+ delayMs?: number | undefined;
28
+ attempts?: number | undefined;
29
+ backoff?: JobBackoff | undefined;
30
+ }
31
+ export interface JobInstance<TPayload = any> {
32
+ readonly definition: JobDefinition<TPayload>;
33
+ readonly name: string;
34
+ dispatch(payload: TPayload, options?: JobDispatchOptions): Promise<string>;
35
+ }
36
+ export type JobStatus = 'pending' | 'processing' | 'completed' | 'failed';
37
+ export interface QueuedJobItem<TPayload = any> {
38
+ id: string;
39
+ name: string;
40
+ queue: string;
41
+ payload: TPayload;
42
+ attempts: number;
43
+ maxAttempts: number;
44
+ backoff?: JobBackoff | undefined;
45
+ status: JobStatus;
46
+ error?: string | undefined;
47
+ progress?: number | undefined;
48
+ createdAt: Date;
49
+ availableAt: Date;
50
+ processedAt?: Date | undefined;
51
+ completedAt?: Date | undefined;
52
+ }
53
+ export interface QueueStatusSummary {
54
+ queue?: string | undefined;
55
+ pending: number;
56
+ processing: number;
57
+ completed: number;
58
+ failed: number;
59
+ total: number;
60
+ }
61
+ export interface QueueAdapter {
62
+ enqueue(item: QueuedJobItem): Promise<void>;
63
+ fetchNext(queues: string[], concurrency: number): Promise<QueuedJobItem[]>;
64
+ ack(jobId: string): Promise<void>;
65
+ fail(jobId: string, error: unknown, retryAt?: Date): Promise<void>;
66
+ updateProgress?(jobId: string, percent: number): Promise<void>;
67
+ clear(queue?: string): Promise<number>;
68
+ status(queue?: string): Promise<QueueStatusSummary>;
69
+ close?(): Promise<void>;
70
+ }
71
+ export interface QueueWorkerOptions {
72
+ concurrency?: number | undefined;
73
+ queues?: string[] | undefined;
74
+ adapter?: QueueAdapter | undefined;
75
+ pollIntervalMs?: number | undefined;
76
+ }
77
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,29 @@
1
+ import { EventEmitter } from 'node:events';
2
+ import type { QueueAdapter, QueuedJobItem, QueueWorkerOptions } from './types.js';
3
+ export interface ActiveJobHandle {
4
+ item: QueuedJobItem;
5
+ controller: AbortController;
6
+ promise: Promise<void>;
7
+ }
8
+ export declare class QueueWorker extends EventEmitter {
9
+ readonly concurrency: number;
10
+ readonly queues: string[];
11
+ readonly adapter: QueueAdapter;
12
+ readonly pollIntervalMs: number;
13
+ private isRunning;
14
+ private isShuttingDown;
15
+ private loopPromise;
16
+ private activeJobs;
17
+ private signalCleanup;
18
+ constructor(options?: QueueWorkerOptions);
19
+ get running(): boolean;
20
+ get activeCount(): number;
21
+ start(): Promise<void>;
22
+ private runLoop;
23
+ private dispatchJob;
24
+ private executeJob;
25
+ stop(): Promise<void>;
26
+ setupSignalHandlers(): void;
27
+ private sleep;
28
+ }
29
+ //# sourceMappingURL=worker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjC,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,SAAgB,cAAc,EAAE,MAAM,CAAC;IAEvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,CAAC,EAAE,kBAAkB;IAQxC,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,WAAW,IAAI,MAAM,CAE/B;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAUrB,OAAO;IA0BrB,OAAO,CAAC,WAAW;YAaL,UAAU;IA0DX,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC3B,mBAAmB,IAAI,IAAI;IAqBlC,OAAO,CAAC,KAAK;CAGd"}
package/dist/worker.js ADDED
@@ -0,0 +1,174 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.QueueWorker = void 0;
4
+ const node_events_1 = require("node:events");
5
+ const adapter_js_1 = require("./adapter.js");
6
+ const job_js_1 = require("./job.js");
7
+ class QueueWorker extends node_events_1.EventEmitter {
8
+ concurrency;
9
+ queues;
10
+ adapter;
11
+ pollIntervalMs;
12
+ isRunning = false;
13
+ isShuttingDown = false;
14
+ loopPromise = null;
15
+ activeJobs = new Map();
16
+ signalCleanup = null;
17
+ constructor(options) {
18
+ super();
19
+ this.concurrency = options?.concurrency ?? 4;
20
+ this.queues = options?.queues && options.queues.length > 0 ? options.queues : ['default'];
21
+ this.adapter = options?.adapter ?? (0, adapter_js_1.getDefaultQueueAdapter)();
22
+ this.pollIntervalMs = options?.pollIntervalMs ?? 100;
23
+ }
24
+ get running() {
25
+ return this.isRunning;
26
+ }
27
+ get activeCount() {
28
+ return this.activeJobs.size;
29
+ }
30
+ async start() {
31
+ if (this.isRunning)
32
+ return;
33
+ this.isRunning = true;
34
+ this.isShuttingDown = false;
35
+ this.emit('worker:started', { concurrency: this.concurrency, queues: this.queues });
36
+ this.loopPromise = this.runLoop();
37
+ }
38
+ async runLoop() {
39
+ while (this.isRunning && !this.isShuttingDown) {
40
+ try {
41
+ const availableSlots = this.concurrency - this.activeJobs.size;
42
+ if (availableSlots > 0) {
43
+ const items = await this.adapter.fetchNext(this.queues, availableSlots);
44
+ if (items && items.length > 0) {
45
+ for (const item of items) {
46
+ this.dispatchJob(item);
47
+ }
48
+ }
49
+ else {
50
+ await this.sleep(this.pollIntervalMs);
51
+ }
52
+ }
53
+ else {
54
+ // All slots busy, wait a short poll interval
55
+ await this.sleep(this.pollIntervalMs);
56
+ }
57
+ }
58
+ catch (error) {
59
+ this.emit('worker:error', error);
60
+ await this.sleep(this.pollIntervalMs);
61
+ }
62
+ }
63
+ }
64
+ dispatchJob(item) {
65
+ const controller = new AbortController();
66
+ const jobPromise = this.executeJob(item, controller).finally(() => {
67
+ this.activeJobs.delete(item.id);
68
+ });
69
+ this.activeJobs.set(item.id, {
70
+ item,
71
+ controller,
72
+ promise: jobPromise,
73
+ });
74
+ }
75
+ async executeJob(item, controller) {
76
+ const jobInstance = job_js_1.JobRegistry.get(item.name);
77
+ const attempt = item.attempts + 1;
78
+ if (!jobInstance) {
79
+ const err = new Error(`No job definition found registered for name "${item.name}"`);
80
+ await this.adapter.fail(item.id, err);
81
+ this.emit('job:failed', { item, error: err, attempt });
82
+ return;
83
+ }
84
+ const context = {
85
+ jobId: item.id,
86
+ attempt,
87
+ signal: controller.signal,
88
+ progress: async (percent) => {
89
+ if (this.adapter.updateProgress) {
90
+ await this.adapter.updateProgress(item.id, percent);
91
+ }
92
+ this.emit('job:progress', { jobId: item.id, percent });
93
+ },
94
+ };
95
+ this.emit('job:started', { item, attempt });
96
+ try {
97
+ await jobInstance.definition.handler(item.payload, context);
98
+ await this.adapter.ack(item.id);
99
+ this.emit('job:completed', { item, attempt });
100
+ }
101
+ catch (error) {
102
+ if (controller.signal.aborted && this.isShuttingDown) {
103
+ // Interrupted cooperatively during shutdown: reschedule for pending without burning an attempt
104
+ await this.adapter.fail(item.id, new Error('Job execution aborted due to worker shutdown'), new Date());
105
+ this.emit('job:aborted', { item, attempt, error });
106
+ return;
107
+ }
108
+ const nextAttempt = attempt;
109
+ const willRetry = nextAttempt < item.maxAttempts;
110
+ if (willRetry) {
111
+ const backoff = item.backoff ?? { type: 'exponential', delayMs: 1000 };
112
+ const delayMs = backoff.type === 'exponential'
113
+ ? (backoff.delayMs || 1000) * Math.pow(2, item.attempts)
114
+ : (backoff.delayMs || 1000);
115
+ const retryAt = new Date(Date.now() + delayMs);
116
+ await this.adapter.fail(item.id, error, retryAt);
117
+ this.emit('job:retry', { item, attempt: nextAttempt, retryAt, error });
118
+ }
119
+ else {
120
+ await this.adapter.fail(item.id, error);
121
+ this.emit('job:failed', { item, attempt: nextAttempt, error });
122
+ }
123
+ }
124
+ }
125
+ async stop() {
126
+ if (!this.isRunning && !this.isShuttingDown)
127
+ return;
128
+ this.isShuttingDown = true;
129
+ this.isRunning = false;
130
+ this.emit('worker:stopping', { activeJobs: this.activeJobs.size });
131
+ // 1. Trigger cooperative cancellation on all active jobs
132
+ for (const [, handle] of this.activeJobs) {
133
+ try {
134
+ handle.controller.abort(new Error('Queue worker is shutting down'));
135
+ }
136
+ catch { }
137
+ }
138
+ // 2. Wait for all active job executions to settle
139
+ const activePromises = Array.from(this.activeJobs.values()).map((h) => h.promise);
140
+ await Promise.allSettled(activePromises);
141
+ // 3. Wait for the main loop to terminate
142
+ if (this.loopPromise) {
143
+ await this.loopPromise.catch(() => { });
144
+ this.loopPromise = null;
145
+ }
146
+ if (this.signalCleanup) {
147
+ this.signalCleanup();
148
+ this.signalCleanup = null;
149
+ }
150
+ this.emit('worker:stopped');
151
+ }
152
+ setupSignalHandlers() {
153
+ if (this.signalCleanup)
154
+ return;
155
+ const onSignal = async (signal) => {
156
+ this.emit('worker:signal', signal);
157
+ await this.stop();
158
+ process.exit(0);
159
+ };
160
+ const sigintHandler = () => void onSignal('SIGINT');
161
+ const sigtermHandler = () => void onSignal('SIGTERM');
162
+ process.once('SIGINT', sigintHandler);
163
+ process.once('SIGTERM', sigtermHandler);
164
+ this.signalCleanup = () => {
165
+ process.removeListener('SIGINT', sigintHandler);
166
+ process.removeListener('SIGTERM', sigtermHandler);
167
+ };
168
+ }
169
+ sleep(ms) {
170
+ return new Promise((resolve) => setTimeout(resolve, ms));
171
+ }
172
+ }
173
+ exports.QueueWorker = QueueWorker;
174
+ //# sourceMappingURL=worker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAO3C,6CAAsD;AACtD,qCAAuC;AAQvC,MAAa,WAAY,SAAQ,0BAAY;IAC3B,WAAW,CAAS;IACpB,MAAM,CAAW;IACjB,OAAO,CAAe;IACtB,cAAc,CAAS;IAE/B,SAAS,GAAG,KAAK,CAAC;IAClB,cAAc,GAAG,KAAK,CAAC;IACvB,WAAW,GAAyB,IAAI,CAAC;IACzC,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IAChD,aAAa,GAAwB,IAAI,CAAC;IAElD,YAAY,OAA4B;QACtC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC1F,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAA,mCAAsB,GAAE,CAAC;QAC5D,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,GAAG,CAAC;IACvD,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAE3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAEpF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAE/D,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;oBAExE,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;4BACzB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;wBACzB,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBACxC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,6CAA6C;oBAC7C,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;gBACjC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,IAAmB;QACrC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAChE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;YAC3B,IAAI;YACJ,UAAU;YACV,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAmB,EAAE,UAA2B;QACvE,MAAM,WAAW,GAAG,oBAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,gDAAgD,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACpF,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAe;YAC1B,KAAK,EAAE,IAAI,CAAC,EAAE;YACd,OAAO;YACP,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,QAAQ,EAAE,KAAK,EAAE,OAAe,EAAE,EAAE;gBAClC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;oBAChC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACtD,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;SACF,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE5D,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrD,+FAA+F;gBAC/F,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,KAAK,CAAC,8CAA8C,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;gBACxG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,CAAC;YAC5B,MAAM,SAAS,GAAG,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YAEjD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACvE,MAAM,OAAO,GACX,OAAO,CAAC,IAAI,KAAK,aAAa;oBAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC;oBACxD,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;gBAEhC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;gBAC/C,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;gBACjD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACzE,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QAEpD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAEnE,yDAAyD;QACzD,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QAED,kDAAkD;QAClD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAEzC,yCAAyC;QACzC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9B,CAAC;IAEM,mBAAmB;QACxB,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO;QAE/B,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YACxC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEtD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAExC,IAAI,CAAC,aAAa,GAAG,GAAG,EAAE;YACxB,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;YAChD,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACpD,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF;AA/LD,kCA+LC"}
package/package.json CHANGED
@@ -1,6 +1,37 @@
1
1
  {
2
2
  "name": "@argos-js/queue",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.1",
4
+ "description": "Event-driven asynchronous job queue with transactional adapters and concurrency controls for Argos-JS",
5
+ "main": "./dist/index.js",
6
+ "types": "./dist/index.d.ts",
7
+ "exports": {
8
+ ".": {
9
+ "import": "./dist/index.js",
10
+ "require": "./dist/index.js",
11
+ "types": "./dist/index.d.ts"
12
+ }
13
+ },
14
+ "dependencies": {
15
+ "@argos-js/core": "0.1.1",
16
+ "@argos-js/data": "0.1.1"
17
+ },
18
+ "devDependencies": {
19
+ "@types/node": "^20.11.0",
20
+ "tsx": "^4.7.0",
21
+ "typescript": "^5.4.0"
22
+ },
23
+ "license": "MIT",
24
+ "files": [
25
+ "dist",
26
+ "README.md",
27
+ "LICENSE"
28
+ ],
29
+ "optionalDependencies": {
30
+ "@argos-js/argox-core": "0.1.1"
31
+ },
32
+ "scripts": {
33
+ "build": "tsc",
34
+ "dev": "tsc --watch",
35
+ "test": "tsx test/queue.spec.ts"
36
+ }
6
37
  }