@argos-js/routine 0.0.0-stage → 0.1.0
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 +21 -0
- package/README.md +159 -2
- package/dist/cron.d.ts +3 -0
- package/dist/cron.d.ts.map +1 -0
- package/dist/cron.js +79 -0
- package/dist/cron.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +23 -0
- package/dist/index.js.map +1 -0
- package/dist/lock-manager.d.ts +37 -0
- package/dist/lock-manager.d.ts.map +1 -0
- package/dist/lock-manager.js +195 -0
- package/dist/lock-manager.js.map +1 -0
- package/dist/native-bridge.d.ts +61 -0
- package/dist/native-bridge.d.ts.map +1 -0
- package/dist/native-bridge.js +180 -0
- package/dist/native-bridge.js.map +1 -0
- package/dist/routine-builder.d.ts +31 -0
- package/dist/routine-builder.d.ts.map +1 -0
- package/dist/routine-builder.js +120 -0
- package/dist/routine-builder.js.map +1 -0
- package/dist/runner.d.ts +25 -0
- package/dist/runner.d.ts.map +1 -0
- package/dist/runner.js +222 -0
- package/dist/runner.js.map +1 -0
- package/dist/types.d.ts +45 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +3 -0
- package/dist/types.js.map +1 -0
- package/package.json +33 -3
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,160 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @argos-js/routine
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Time-oriented periodic routine scheduling with atomic locks and concurrency protection for the **Argos-JS** framework.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- **Strict Conceptual Separation:** Dedicated exclusively to time-based schedules (periodic maintenance, synchronization, reports, backups).
|
|
10
|
+
- **Distributed Concurrency Semantics:** Built-in atomic locking via `.lock({ ttl: '10m' })` and its direct alias `.preventOverlap()`.
|
|
11
|
+
- **Silent Skipping:** When a routine is currently running and locked, subsequent executions are discarded silently rather than piling up.
|
|
12
|
+
- **Immediate Lock Release:** Locks are immediately released in `finally` blocks upon completion or failure (never waiting for TTL to elapse).
|
|
13
|
+
- **Deadlock Protection:** If a node or process crashes mid-execution, locks auto-expire after TTL to prevent infinite deadlocks.
|
|
14
|
+
- **Zero External Required Dependencies:** Works with `MemoryLockAdapter` (testing/dev) and `DatabaseLockAdapter` (`@argos-js/data` transactional locks).
|
|
15
|
+
- **Queue Integration:** Direct dispatching to `@argos-js/queue` with `.dispatch(job, payload)`.
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Installation
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
pnpm add @argos-js/routine @argos-js/queue
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Quick Start
|
|
28
|
+
|
|
29
|
+
### 1. Defining Routines
|
|
30
|
+
|
|
31
|
+
```typescript
|
|
32
|
+
import { routine } from '@argos-js/routine';
|
|
33
|
+
import { cleanupLogsJob } from './jobs/cleanup.job.js';
|
|
34
|
+
|
|
35
|
+
// 1. Routine with preventOverlap (default 10m TTL)
|
|
36
|
+
routine('generate-hourly-metrics')
|
|
37
|
+
.hourly()
|
|
38
|
+
.preventOverlap()
|
|
39
|
+
.run(async (context) => {
|
|
40
|
+
console.log(`[Routine ${context.routineName}] Running metrics compilation for ${context.scheduledTime}`);
|
|
41
|
+
// Compiling metrics...
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
// 2. Routine running on interval with custom TTL
|
|
45
|
+
routine('sync-external-inventory')
|
|
46
|
+
.every('5m')
|
|
47
|
+
.lock({ ttl: '15m' })
|
|
48
|
+
.run(async (context) => {
|
|
49
|
+
// Inventory sync logic...
|
|
50
|
+
});
|
|
51
|
+
|
|
52
|
+
// 3. Routine running daily at specific time
|
|
53
|
+
routine('database-backup')
|
|
54
|
+
.dailyAt('03:00')
|
|
55
|
+
.preventOverlap({ ttl: '1h' })
|
|
56
|
+
.run(async (context) => {
|
|
57
|
+
// Perform automated backup...
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
// 4. Routine dispatching an asynchronous queue job
|
|
61
|
+
routine('daily-disk-cleanup')
|
|
62
|
+
.dailyAt('04:00')
|
|
63
|
+
.dispatch(cleanupLogsJob, { olderThanDays: 30 });
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### 2. Running the Routine Daemon
|
|
67
|
+
|
|
68
|
+
```typescript
|
|
69
|
+
import { RoutineRunner, DatabaseLockAdapter, LockManager, setDefaultLockManager } from '@argos-js/routine';
|
|
70
|
+
import { createDatabase } from '@argos-js/data';
|
|
71
|
+
|
|
72
|
+
// Optional: Use database-backed locks for multi-instance distributed deployments
|
|
73
|
+
const db = createDatabase({
|
|
74
|
+
driver: 'postgres',
|
|
75
|
+
connectionString: process.env.DATABASE_URL,
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
const lockManager = new LockManager(new DatabaseLockAdapter(db));
|
|
79
|
+
setDefaultLockManager(lockManager);
|
|
80
|
+
|
|
81
|
+
const runner = new RoutineRunner({
|
|
82
|
+
resolutionMs: 1000, // 1-second resolution loop
|
|
83
|
+
lockManager,
|
|
84
|
+
});
|
|
85
|
+
|
|
86
|
+
// Setup SIGTERM / SIGINT graceful handling
|
|
87
|
+
runner.setupSignalHandlers();
|
|
88
|
+
|
|
89
|
+
await runner.start();
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## CLI Management
|
|
95
|
+
|
|
96
|
+
The official Argos CLI provides semantic commands to control routines:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
# Start routine runner daemon
|
|
100
|
+
argos routine start
|
|
101
|
+
|
|
102
|
+
# List all registered routines, schedules, and lock status
|
|
103
|
+
argos routine list
|
|
104
|
+
|
|
105
|
+
# Manually trigger a routine immediately (bypasses schedule, respects locks)
|
|
106
|
+
argos routine run generate-hourly-metrics
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Unified Daemon
|
|
112
|
+
|
|
113
|
+
In containers or single-instance setups, run both queue workers and the routine runner in the same unified daemon:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
argos daemon start --workers=4
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Production Deployment
|
|
122
|
+
|
|
123
|
+
### Systemd Service (`/etc/systemd/system/argos-routine.service`)
|
|
124
|
+
|
|
125
|
+
```ini
|
|
126
|
+
[Unit]
|
|
127
|
+
Description=Argos-JS Periodic Routine Runner
|
|
128
|
+
After=network.target
|
|
129
|
+
|
|
130
|
+
[Service]
|
|
131
|
+
Type=simple
|
|
132
|
+
User=argos
|
|
133
|
+
WorkingDirectory=/var/www/my-argos-app
|
|
134
|
+
Environment=NODE_ENV=production
|
|
135
|
+
ExecStart=/usr/bin/node ./dist/app/index.js --routine
|
|
136
|
+
Restart=always
|
|
137
|
+
RestartSec=5
|
|
138
|
+
KillSignal=SIGTERM
|
|
139
|
+
TimeoutStopSec=30
|
|
140
|
+
|
|
141
|
+
[Install]
|
|
142
|
+
WantedBy=multi-user.target
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Docker Container (Unified Daemon)
|
|
146
|
+
|
|
147
|
+
```dockerfile
|
|
148
|
+
FROM node:20-alpine AS runner
|
|
149
|
+
WORKDIR /app
|
|
150
|
+
|
|
151
|
+
COPY package.json pnpm-lock.yaml ./
|
|
152
|
+
RUN npm install -g pnpm && pnpm install --prod
|
|
153
|
+
|
|
154
|
+
COPY dist ./dist
|
|
155
|
+
|
|
156
|
+
ENV NODE_ENV=production
|
|
157
|
+
STOPSIGNAL SIGTERM
|
|
158
|
+
|
|
159
|
+
CMD ["node", "./node_modules/@argos-js/cli/bin/argos.js", "daemon", "start", "--workers=4"]
|
|
160
|
+
```
|
package/dist/cron.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA8CtE;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,OAAO,CAwBhF"}
|
package/dist/cron.js
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.matchesCronField = matchesCronField;
|
|
4
|
+
exports.matchesCron = matchesCron;
|
|
5
|
+
function matchesCronField(field, value) {
|
|
6
|
+
if (field === '*')
|
|
7
|
+
return true;
|
|
8
|
+
const parts = field.split(',');
|
|
9
|
+
for (const part of parts) {
|
|
10
|
+
if (part === '*')
|
|
11
|
+
return true;
|
|
12
|
+
// Step: */5 or 1-30/5
|
|
13
|
+
if (part.includes('/')) {
|
|
14
|
+
const [rangePart, stepStr] = part.split('/');
|
|
15
|
+
const step = parseInt(stepStr, 10);
|
|
16
|
+
if (Number.isNaN(step) || step <= 0)
|
|
17
|
+
return false;
|
|
18
|
+
if (rangePart === '*' || rangePart === '') {
|
|
19
|
+
if (value % step === 0)
|
|
20
|
+
return true;
|
|
21
|
+
}
|
|
22
|
+
else if (rangePart.includes('-')) {
|
|
23
|
+
const [minStr, maxStr] = rangePart.split('-');
|
|
24
|
+
const min = parseInt(minStr, 10);
|
|
25
|
+
const max = parseInt(maxStr, 10);
|
|
26
|
+
if (value >= min && value <= max && (value - min) % step === 0) {
|
|
27
|
+
return true;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
else {
|
|
31
|
+
const base = parseInt(rangePart, 10);
|
|
32
|
+
if (value >= base && (value - base) % step === 0) {
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
continue;
|
|
37
|
+
}
|
|
38
|
+
// Range: 1-5
|
|
39
|
+
if (part.includes('-')) {
|
|
40
|
+
const [minStr, maxStr] = part.split('-');
|
|
41
|
+
const min = parseInt(minStr, 10);
|
|
42
|
+
const max = parseInt(maxStr, 10);
|
|
43
|
+
if (value >= min && value <= max)
|
|
44
|
+
return true;
|
|
45
|
+
continue;
|
|
46
|
+
}
|
|
47
|
+
// Exact number
|
|
48
|
+
const target = parseInt(part, 10);
|
|
49
|
+
if (!Number.isNaN(target) && target === value)
|
|
50
|
+
return true;
|
|
51
|
+
}
|
|
52
|
+
return false;
|
|
53
|
+
}
|
|
54
|
+
function matchesCron(expression, date = new Date()) {
|
|
55
|
+
const fields = expression.trim().split(/\s+/);
|
|
56
|
+
if (fields.length !== 5) {
|
|
57
|
+
throw new Error(`[Argos Routine] Invalid cron expression: "${expression}". Expected 5 fields (minute hour day-of-month month day-of-week).`);
|
|
58
|
+
}
|
|
59
|
+
const [minField, hourField, domField, monthField, dowField] = fields;
|
|
60
|
+
const minute = date.getMinutes();
|
|
61
|
+
const hour = date.getHours();
|
|
62
|
+
const dayOfMonth = date.getDate();
|
|
63
|
+
const month = date.getMonth() + 1; // 1-12
|
|
64
|
+
const dayOfWeek = date.getDay(); // 0-6
|
|
65
|
+
if (!matchesCronField(minField, minute))
|
|
66
|
+
return false;
|
|
67
|
+
if (!matchesCronField(hourField, hour))
|
|
68
|
+
return false;
|
|
69
|
+
if (!matchesCronField(domField, dayOfMonth))
|
|
70
|
+
return false;
|
|
71
|
+
if (!matchesCronField(monthField, month))
|
|
72
|
+
return false;
|
|
73
|
+
// Day of week (allow 7 as Sunday alias for 0)
|
|
74
|
+
const matchesDow = matchesCronField(dowField, dayOfWeek) || (dayOfWeek === 0 && matchesCronField(dowField, 7));
|
|
75
|
+
if (!matchesDow)
|
|
76
|
+
return false;
|
|
77
|
+
return true;
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=cron.js.map
|
package/dist/cron.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cron.js","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
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("./cron.js"), exports);
|
|
19
|
+
__exportStar(require("./lock-manager.js"), exports);
|
|
20
|
+
__exportStar(require("./routine-builder.js"), exports);
|
|
21
|
+
__exportStar(require("./runner.js"), exports);
|
|
22
|
+
__exportStar(require("./native-bridge.js"), exports);
|
|
23
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,4CAA0B;AAC1B,oDAAkC;AAClC,uDAAqC;AACrC,8CAA4B;AAC5B,qDAAmC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { DatabaseClient } from '@argos-js/data';
|
|
2
|
+
import type { LockAdapter } from './types.js';
|
|
3
|
+
import { createDefaultLockAdapter, NativeLockAdapter } from './native-bridge.js';
|
|
4
|
+
export declare function parseDurationToMs(duration: string | number): number;
|
|
5
|
+
export declare class MemoryLockAdapter implements LockAdapter {
|
|
6
|
+
private locks;
|
|
7
|
+
acquire(key: string, ttlMs: number): Promise<boolean>;
|
|
8
|
+
release(key: string): Promise<void>;
|
|
9
|
+
isLocked(key: string): Promise<boolean>;
|
|
10
|
+
clear(): Promise<void>;
|
|
11
|
+
}
|
|
12
|
+
export declare class DatabaseLockAdapter implements LockAdapter {
|
|
13
|
+
private client;
|
|
14
|
+
private tableName;
|
|
15
|
+
private initialized;
|
|
16
|
+
constructor(client: DatabaseClient, options?: {
|
|
17
|
+
tableName?: string;
|
|
18
|
+
});
|
|
19
|
+
ensureSchema(): Promise<void>;
|
|
20
|
+
acquire(key: string, ttlMs: number): Promise<boolean>;
|
|
21
|
+
release(key: string): Promise<void>;
|
|
22
|
+
isLocked(key: string): Promise<boolean>;
|
|
23
|
+
clear(): Promise<void>;
|
|
24
|
+
}
|
|
25
|
+
export { NativeLockAdapter, createDefaultLockAdapter };
|
|
26
|
+
export declare class LockManager implements LockAdapter {
|
|
27
|
+
private adapter;
|
|
28
|
+
constructor(adapter?: LockAdapter);
|
|
29
|
+
acquire(key: string, ttl: string | number): Promise<boolean>;
|
|
30
|
+
release(key: string): Promise<void>;
|
|
31
|
+
isLocked(key: string): Promise<boolean>;
|
|
32
|
+
clear(): Promise<void>;
|
|
33
|
+
getAdapter(): LockAdapter;
|
|
34
|
+
}
|
|
35
|
+
export declare function getDefaultLockManager(): LockManager;
|
|
36
|
+
export declare function setDefaultLockManager(manager: LockManager): void;
|
|
37
|
+
//# sourceMappingURL=lock-manager.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../src/lock-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CA8BnE;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,KAAK,CAAgE;IAEhE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAerD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAA0B;IAC3C,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;IAqC7B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBrD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASnC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAIpC;AAED,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;AAEvD,qBAAa,WAAY,YAAW,WAAW;IAC7C,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,CAAC,EAAE,WAAW;IAIpB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5D,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,UAAU,IAAI,WAAW;CAGjC;AAID,wBAAgB,qBAAqB,IAAI,WAAW,CAEnD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAEhE"}
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.LockManager = exports.createDefaultLockAdapter = exports.NativeLockAdapter = exports.DatabaseLockAdapter = exports.MemoryLockAdapter = void 0;
|
|
4
|
+
exports.parseDurationToMs = parseDurationToMs;
|
|
5
|
+
exports.getDefaultLockManager = getDefaultLockManager;
|
|
6
|
+
exports.setDefaultLockManager = setDefaultLockManager;
|
|
7
|
+
const native_bridge_js_1 = require("./native-bridge.js");
|
|
8
|
+
Object.defineProperty(exports, "createDefaultLockAdapter", { enumerable: true, get: function () { return native_bridge_js_1.createDefaultLockAdapter; } });
|
|
9
|
+
Object.defineProperty(exports, "NativeLockAdapter", { enumerable: true, get: function () { return native_bridge_js_1.NativeLockAdapter; } });
|
|
10
|
+
function parseDurationToMs(duration) {
|
|
11
|
+
if (typeof duration === 'number') {
|
|
12
|
+
return duration;
|
|
13
|
+
}
|
|
14
|
+
const trimmed = duration.trim().toLowerCase();
|
|
15
|
+
const match = trimmed.match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)?$/);
|
|
16
|
+
if (!match) {
|
|
17
|
+
const parsed = Number(duration);
|
|
18
|
+
if (!Number.isNaN(parsed))
|
|
19
|
+
return parsed;
|
|
20
|
+
throw new Error(`[Argos Routine] Invalid duration format: "${duration}". Expected format like "10m", "30s", "1h", or milliseconds.`);
|
|
21
|
+
}
|
|
22
|
+
const value = parseFloat(match[1]);
|
|
23
|
+
const unit = match[2] || 'ms';
|
|
24
|
+
switch (unit) {
|
|
25
|
+
case 'ms':
|
|
26
|
+
return Math.round(value);
|
|
27
|
+
case 's':
|
|
28
|
+
return Math.round(value * 1000);
|
|
29
|
+
case 'm':
|
|
30
|
+
return Math.round(value * 60 * 1000);
|
|
31
|
+
case 'h':
|
|
32
|
+
return Math.round(value * 60 * 60 * 1000);
|
|
33
|
+
case 'd':
|
|
34
|
+
return Math.round(value * 24 * 60 * 60 * 1000);
|
|
35
|
+
default:
|
|
36
|
+
return Math.round(value);
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
class MemoryLockAdapter {
|
|
40
|
+
locks = new Map();
|
|
41
|
+
async acquire(key, ttlMs) {
|
|
42
|
+
const now = Date.now();
|
|
43
|
+
const current = this.locks.get(key);
|
|
44
|
+
if (current && current.expiresAt > now) {
|
|
45
|
+
return false;
|
|
46
|
+
}
|
|
47
|
+
this.locks.set(key, {
|
|
48
|
+
expiresAt: now + ttlMs,
|
|
49
|
+
acquiredAt: now,
|
|
50
|
+
});
|
|
51
|
+
return true;
|
|
52
|
+
}
|
|
53
|
+
async release(key) {
|
|
54
|
+
this.locks.delete(key);
|
|
55
|
+
}
|
|
56
|
+
async isLocked(key) {
|
|
57
|
+
const now = Date.now();
|
|
58
|
+
const current = this.locks.get(key);
|
|
59
|
+
if (!current)
|
|
60
|
+
return false;
|
|
61
|
+
if (current.expiresAt <= now) {
|
|
62
|
+
this.locks.delete(key);
|
|
63
|
+
return false;
|
|
64
|
+
}
|
|
65
|
+
return true;
|
|
66
|
+
}
|
|
67
|
+
async clear() {
|
|
68
|
+
this.locks.clear();
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
exports.MemoryLockAdapter = MemoryLockAdapter;
|
|
72
|
+
class DatabaseLockAdapter {
|
|
73
|
+
client;
|
|
74
|
+
tableName = '_argos_routine_locks';
|
|
75
|
+
initialized = false;
|
|
76
|
+
constructor(client, options) {
|
|
77
|
+
this.client = client;
|
|
78
|
+
if (options?.tableName) {
|
|
79
|
+
this.tableName = options.tableName;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
async ensureSchema() {
|
|
83
|
+
if (this.initialized)
|
|
84
|
+
return;
|
|
85
|
+
const driver = this.client.driverName.toLowerCase();
|
|
86
|
+
const isPg = driver.includes('postgres') || driver === 'pg';
|
|
87
|
+
const isMysql = driver.includes('mysql');
|
|
88
|
+
if (isPg) {
|
|
89
|
+
await this.client.execute(`
|
|
90
|
+
CREATE TABLE IF NOT EXISTS ${this.tableName} (
|
|
91
|
+
key VARCHAR(255) PRIMARY KEY,
|
|
92
|
+
expires_at BIGINT NOT NULL,
|
|
93
|
+
acquired_at BIGINT NOT NULL
|
|
94
|
+
);
|
|
95
|
+
`);
|
|
96
|
+
}
|
|
97
|
+
else if (isMysql) {
|
|
98
|
+
await this.client.execute(`
|
|
99
|
+
CREATE TABLE IF NOT EXISTS ${this.tableName} (
|
|
100
|
+
\`key\` VARCHAR(255) PRIMARY KEY,
|
|
101
|
+
expires_at BIGINT NOT NULL,
|
|
102
|
+
acquired_at BIGINT NOT NULL
|
|
103
|
+
);
|
|
104
|
+
`);
|
|
105
|
+
}
|
|
106
|
+
else {
|
|
107
|
+
// SQLite
|
|
108
|
+
await this.client.execute(`
|
|
109
|
+
CREATE TABLE IF NOT EXISTS ${this.tableName} (
|
|
110
|
+
key TEXT PRIMARY KEY,
|
|
111
|
+
expires_at INTEGER NOT NULL,
|
|
112
|
+
acquired_at INTEGER NOT NULL
|
|
113
|
+
);
|
|
114
|
+
`);
|
|
115
|
+
}
|
|
116
|
+
this.initialized = true;
|
|
117
|
+
}
|
|
118
|
+
async acquire(key, ttlMs) {
|
|
119
|
+
await this.ensureSchema();
|
|
120
|
+
const now = Date.now();
|
|
121
|
+
const expiresAt = now + ttlMs;
|
|
122
|
+
const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
|
|
123
|
+
try {
|
|
124
|
+
// Clean up expired lock for this key first
|
|
125
|
+
const cleanSql = isPg
|
|
126
|
+
? `DELETE FROM ${this.tableName} WHERE key = $1 AND expires_at <= $2`
|
|
127
|
+
: `DELETE FROM ${this.tableName} WHERE key = ? AND expires_at <= ?`;
|
|
128
|
+
await this.client.execute(cleanSql, [key, now]);
|
|
129
|
+
// Attempt atomic insert
|
|
130
|
+
const insertSql = isPg
|
|
131
|
+
? `INSERT INTO ${this.tableName} (key, expires_at, acquired_at) VALUES ($1, $2, $3)`
|
|
132
|
+
: `INSERT INTO ${this.tableName} (key, expires_at, acquired_at) VALUES (?, ?, ?)`;
|
|
133
|
+
await this.client.execute(insertSql, [key, expiresAt, now]);
|
|
134
|
+
return true;
|
|
135
|
+
}
|
|
136
|
+
catch {
|
|
137
|
+
// Unique constraint violation or conflicting insert
|
|
138
|
+
return false;
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
async release(key) {
|
|
142
|
+
await this.ensureSchema();
|
|
143
|
+
const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
|
|
144
|
+
const sql = isPg
|
|
145
|
+
? `DELETE FROM ${this.tableName} WHERE key = $1`
|
|
146
|
+
: `DELETE FROM ${this.tableName} WHERE key = ?`;
|
|
147
|
+
await this.client.execute(sql, [key]);
|
|
148
|
+
}
|
|
149
|
+
async isLocked(key) {
|
|
150
|
+
await this.ensureSchema();
|
|
151
|
+
const now = Date.now();
|
|
152
|
+
const isPg = this.client.driverName.includes('postgres') || this.client.driverName === 'pg';
|
|
153
|
+
const sql = isPg
|
|
154
|
+
? `SELECT expires_at FROM ${this.tableName} WHERE key = $1 AND expires_at > $2`
|
|
155
|
+
: `SELECT expires_at FROM ${this.tableName} WHERE key = ? AND expires_at > ?`;
|
|
156
|
+
const res = await this.client.execute(sql, [key, now]);
|
|
157
|
+
return res.rows.length > 0;
|
|
158
|
+
}
|
|
159
|
+
async clear() {
|
|
160
|
+
await this.ensureSchema();
|
|
161
|
+
await this.client.execute(`DELETE FROM ${this.tableName}`);
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
exports.DatabaseLockAdapter = DatabaseLockAdapter;
|
|
165
|
+
class LockManager {
|
|
166
|
+
adapter;
|
|
167
|
+
constructor(adapter) {
|
|
168
|
+
this.adapter = adapter ?? (0, native_bridge_js_1.createDefaultLockAdapter)();
|
|
169
|
+
}
|
|
170
|
+
async acquire(key, ttl) {
|
|
171
|
+
const ttlMs = parseDurationToMs(ttl);
|
|
172
|
+
return this.adapter.acquire(key, ttlMs);
|
|
173
|
+
}
|
|
174
|
+
async release(key) {
|
|
175
|
+
return this.adapter.release(key);
|
|
176
|
+
}
|
|
177
|
+
async isLocked(key) {
|
|
178
|
+
return this.adapter.isLocked(key);
|
|
179
|
+
}
|
|
180
|
+
async clear() {
|
|
181
|
+
return this.adapter.clear();
|
|
182
|
+
}
|
|
183
|
+
getAdapter() {
|
|
184
|
+
return this.adapter;
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
exports.LockManager = LockManager;
|
|
188
|
+
let defaultLockManager = new LockManager();
|
|
189
|
+
function getDefaultLockManager() {
|
|
190
|
+
return defaultLockManager;
|
|
191
|
+
}
|
|
192
|
+
function setDefaultLockManager(manager) {
|
|
193
|
+
defaultLockManager = manager;
|
|
194
|
+
}
|
|
195
|
+
//# sourceMappingURL=lock-manager.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lock-manager.js","sourceRoot":"","sources":["../src/lock-manager.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import type { LockAdapter } from './types.js';
|
|
2
|
+
export interface NativeBindingModule {
|
|
3
|
+
NativeLockManager?: new () => {
|
|
4
|
+
acquireLock(key: string, ttlMs: number): boolean;
|
|
5
|
+
acquire_lock?(key: string, ttlMs: number): boolean;
|
|
6
|
+
releaseLock(key: string): boolean;
|
|
7
|
+
release_lock?(key: string): boolean;
|
|
8
|
+
isLocked(key: string): boolean;
|
|
9
|
+
is_locked?(key: string): boolean;
|
|
10
|
+
cleanExpired?(): number;
|
|
11
|
+
destroy?(): void;
|
|
12
|
+
};
|
|
13
|
+
NativePrecisionTicker?: new () => {
|
|
14
|
+
start(intervalMs: number, callback: (timestamp: number) => void): boolean;
|
|
15
|
+
stop(): void;
|
|
16
|
+
isActive(): boolean;
|
|
17
|
+
};
|
|
18
|
+
startPrecisionTicker?: (intervalMs: number, callback: (timestamp: number) => void) => {
|
|
19
|
+
stop(): void;
|
|
20
|
+
isActive?(): boolean;
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Attempts to dynamically load native bindings from argox-core.
|
|
25
|
+
* Returns null if native bindings are not available, unsupported on the platform,
|
|
26
|
+
* or explicitly disabled via ARGOS_DISABLE_NATIVE=true.
|
|
27
|
+
*/
|
|
28
|
+
export declare function loadNativeBindings(): NativeBindingModule | null;
|
|
29
|
+
/**
|
|
30
|
+
* Resets the cached native bindings (useful for unit tests simulating fallback).
|
|
31
|
+
*/
|
|
32
|
+
export declare function resetNativeBindingsCache(): void;
|
|
33
|
+
/**
|
|
34
|
+
* Checks whether native bindings are currently loaded and functional.
|
|
35
|
+
*/
|
|
36
|
+
export declare function isNativeAvailable(): boolean;
|
|
37
|
+
/**
|
|
38
|
+
* Lock adapter that delegates atomic lock management directly to the Rust NativeLockManager.
|
|
39
|
+
*/
|
|
40
|
+
export declare class NativeLockAdapter implements LockAdapter {
|
|
41
|
+
private native;
|
|
42
|
+
constructor(nativeManagerInstance?: any);
|
|
43
|
+
acquire(key: string, ttlMs: number): Promise<boolean>;
|
|
44
|
+
release(key: string): Promise<void>;
|
|
45
|
+
isLocked(key: string): Promise<boolean>;
|
|
46
|
+
clear(): Promise<void>;
|
|
47
|
+
destroy(): void;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Creates the default lock adapter: returns NativeLockAdapter if native engine is available,
|
|
51
|
+
* otherwise falls back gracefully to MemoryLockAdapter.
|
|
52
|
+
*/
|
|
53
|
+
export declare function createDefaultLockAdapter(): LockAdapter;
|
|
54
|
+
/**
|
|
55
|
+
* Starts a native precision ticker if available.
|
|
56
|
+
* Returns an object with stop() or null if native ticker is not available.
|
|
57
|
+
*/
|
|
58
|
+
export declare function createPrecisionTicker(intervalMs: number, callback: (timestamp: number) => void): {
|
|
59
|
+
stop(): void;
|
|
60
|
+
} | null;
|
|
61
|
+
//# 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":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,mBAAmB;IAClC,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;IACF,qBAAqB,CAAC,EAAE,UAAU;QAChC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;QAC1E,IAAI,IAAI,IAAI,CAAC;QACb,QAAQ,IAAI,OAAO,CAAC;KACrB,CAAC;IACF,oBAAoB,CAAC,EAAE,CACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,KAClC;QACH,IAAI,IAAI,IAAI,CAAC;QACb,QAAQ,CAAC,IAAI,OAAO,CAAC;KACtB,CAAC;CACH;AAKD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,GAAG,IAAI,CA6D/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAM;gBAER,qBAAqB,CAAC,EAAE,GAAG;IAY1B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,OAAO,IAAI,IAAI;CAKvB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAUtD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACpC;IAAE,IAAI,IAAI,IAAI,CAAA;CAAE,GAAG,IAAI,CAazB"}
|