@argos-js/routine 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 +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 +35 -3
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.NativeLockAdapter = void 0;
|
|
4
|
+
exports.loadNativeBindings = loadNativeBindings;
|
|
5
|
+
exports.resetNativeBindingsCache = resetNativeBindingsCache;
|
|
6
|
+
exports.isNativeAvailable = isNativeAvailable;
|
|
7
|
+
exports.createDefaultLockAdapter = createDefaultLockAdapter;
|
|
8
|
+
exports.createPrecisionTicker = createPrecisionTicker;
|
|
9
|
+
const node_module_1 = require("node:module");
|
|
10
|
+
const node_fs_1 = require("node:fs");
|
|
11
|
+
const node_path_1 = require("node:path");
|
|
12
|
+
const lock_manager_js_1 = require("./lock-manager.js");
|
|
13
|
+
let cachedBindings = null;
|
|
14
|
+
let bindingsAttempted = false;
|
|
15
|
+
/**
|
|
16
|
+
* Attempts to dynamically load native bindings from argox-core.
|
|
17
|
+
* Returns null if native bindings are not available, unsupported on the platform,
|
|
18
|
+
* or explicitly disabled via ARGOS_DISABLE_NATIVE=true.
|
|
19
|
+
*/
|
|
20
|
+
function loadNativeBindings() {
|
|
21
|
+
if (process.env.ARGOS_DISABLE_NATIVE === 'true') {
|
|
22
|
+
return null;
|
|
23
|
+
}
|
|
24
|
+
if (bindingsAttempted) {
|
|
25
|
+
return cachedBindings;
|
|
26
|
+
}
|
|
27
|
+
bindingsAttempted = true;
|
|
28
|
+
// 1. Try standard module resolution
|
|
29
|
+
const candidateNames = [
|
|
30
|
+
'@argos-js/argox-core',
|
|
31
|
+
'@argos-js/native',
|
|
32
|
+
];
|
|
33
|
+
let req;
|
|
34
|
+
if (typeof require !== 'undefined') {
|
|
35
|
+
req = require;
|
|
36
|
+
}
|
|
37
|
+
else {
|
|
38
|
+
req = (0, node_module_1.createRequire)((0, node_path_1.resolve)(process.cwd(), 'dummy.js'));
|
|
39
|
+
}
|
|
40
|
+
for (const name of candidateNames) {
|
|
41
|
+
try {
|
|
42
|
+
const mod = req(name);
|
|
43
|
+
if (mod && (mod.NativeLockManager || mod.startPrecisionTicker)) {
|
|
44
|
+
cachedBindings = mod;
|
|
45
|
+
return cachedBindings;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
// Continue to next candidate
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
// 2. Try relative monorepo paths if running in workspace development
|
|
53
|
+
const cwd = process.cwd();
|
|
54
|
+
const candidatePaths = [
|
|
55
|
+
(0, node_path_1.resolve)(cwd, 'crates/argox-core/index.js'),
|
|
56
|
+
(0, node_path_1.resolve)(cwd, '../../crates/argox-core/index.js'),
|
|
57
|
+
(0, node_path_1.resolve)(cwd, '../crates/argox-core/index.js'),
|
|
58
|
+
(0, node_path_1.resolve)(cwd, 'crates/argox-core/index.node'),
|
|
59
|
+
(0, node_path_1.resolve)(cwd, '../../crates/argox-core/index.node'),
|
|
60
|
+
];
|
|
61
|
+
for (const path of candidatePaths) {
|
|
62
|
+
if ((0, node_fs_1.existsSync)(path)) {
|
|
63
|
+
try {
|
|
64
|
+
const mod = req(path);
|
|
65
|
+
if (mod && (mod.NativeLockManager || mod.startPrecisionTicker)) {
|
|
66
|
+
cachedBindings = mod;
|
|
67
|
+
return cachedBindings;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
catch {
|
|
71
|
+
// Continue
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
return null;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Resets the cached native bindings (useful for unit tests simulating fallback).
|
|
79
|
+
*/
|
|
80
|
+
function resetNativeBindingsCache() {
|
|
81
|
+
cachedBindings = null;
|
|
82
|
+
bindingsAttempted = false;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Checks whether native bindings are currently loaded and functional.
|
|
86
|
+
*/
|
|
87
|
+
function isNativeAvailable() {
|
|
88
|
+
return loadNativeBindings() !== null;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Lock adapter that delegates atomic lock management directly to the Rust NativeLockManager.
|
|
92
|
+
*/
|
|
93
|
+
class NativeLockAdapter {
|
|
94
|
+
native;
|
|
95
|
+
constructor(nativeManagerInstance) {
|
|
96
|
+
if (nativeManagerInstance) {
|
|
97
|
+
this.native = nativeManagerInstance;
|
|
98
|
+
}
|
|
99
|
+
else {
|
|
100
|
+
const bindings = loadNativeBindings();
|
|
101
|
+
if (!bindings?.NativeLockManager) {
|
|
102
|
+
throw new Error('[Argos Routine] NativeLockManager is not available in native bindings.');
|
|
103
|
+
}
|
|
104
|
+
this.native = new bindings.NativeLockManager();
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
async acquire(key, ttlMs) {
|
|
108
|
+
if (typeof this.native.acquireLock === 'function') {
|
|
109
|
+
return this.native.acquireLock(key, ttlMs);
|
|
110
|
+
}
|
|
111
|
+
if (typeof this.native.acquire_lock === 'function') {
|
|
112
|
+
return this.native.acquire_lock(key, ttlMs);
|
|
113
|
+
}
|
|
114
|
+
return false;
|
|
115
|
+
}
|
|
116
|
+
async release(key) {
|
|
117
|
+
if (typeof this.native.releaseLock === 'function') {
|
|
118
|
+
this.native.releaseLock(key);
|
|
119
|
+
}
|
|
120
|
+
else if (typeof this.native.release_lock === 'function') {
|
|
121
|
+
this.native.release_lock(key);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
async isLocked(key) {
|
|
125
|
+
if (typeof this.native.isLocked === 'function') {
|
|
126
|
+
return this.native.isLocked(key);
|
|
127
|
+
}
|
|
128
|
+
if (typeof this.native.is_locked === 'function') {
|
|
129
|
+
return this.native.is_locked(key);
|
|
130
|
+
}
|
|
131
|
+
return false;
|
|
132
|
+
}
|
|
133
|
+
async clear() {
|
|
134
|
+
if (typeof this.native.cleanExpired === 'function') {
|
|
135
|
+
this.native.cleanExpired();
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
destroy() {
|
|
139
|
+
if (typeof this.native.destroy === 'function') {
|
|
140
|
+
this.native.destroy();
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
exports.NativeLockAdapter = NativeLockAdapter;
|
|
145
|
+
/**
|
|
146
|
+
* Creates the default lock adapter: returns NativeLockAdapter if native engine is available,
|
|
147
|
+
* otherwise falls back gracefully to MemoryLockAdapter.
|
|
148
|
+
*/
|
|
149
|
+
function createDefaultLockAdapter() {
|
|
150
|
+
const bindings = loadNativeBindings();
|
|
151
|
+
if (bindings?.NativeLockManager) {
|
|
152
|
+
try {
|
|
153
|
+
return new NativeLockAdapter();
|
|
154
|
+
}
|
|
155
|
+
catch {
|
|
156
|
+
// Fallback
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
return new lock_manager_js_1.MemoryLockAdapter();
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Starts a native precision ticker if available.
|
|
163
|
+
* Returns an object with stop() or null if native ticker is not available.
|
|
164
|
+
*/
|
|
165
|
+
function createPrecisionTicker(intervalMs, callback) {
|
|
166
|
+
const bindings = loadNativeBindings();
|
|
167
|
+
if (typeof bindings?.startPrecisionTicker === 'function') {
|
|
168
|
+
try {
|
|
169
|
+
const ticker = bindings.startPrecisionTicker(intervalMs, callback);
|
|
170
|
+
return {
|
|
171
|
+
stop: () => ticker.stop(),
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
catch {
|
|
175
|
+
return null;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
return null;
|
|
179
|
+
}
|
|
180
|
+
//# sourceMappingURL=native-bridge.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"native-bridge.js","sourceRoot":"","sources":["../src/native-bridge.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { JobInstance } from '@argos-js/queue';
|
|
2
|
+
import type { RoutineContext, RoutineDefinition } from './types.js';
|
|
3
|
+
declare class GlobalRoutineRegistry {
|
|
4
|
+
private routines;
|
|
5
|
+
register(routine: RoutineDefinition): void;
|
|
6
|
+
get(name: string): RoutineDefinition | undefined;
|
|
7
|
+
getAll(): RoutineDefinition[];
|
|
8
|
+
clear(): void;
|
|
9
|
+
}
|
|
10
|
+
export declare const RoutineRegistry: GlobalRoutineRegistry;
|
|
11
|
+
export declare class RoutineBuilder {
|
|
12
|
+
readonly name: string;
|
|
13
|
+
private scheduleConfig?;
|
|
14
|
+
private lockConfig?;
|
|
15
|
+
constructor(name: string);
|
|
16
|
+
every(interval: string): this;
|
|
17
|
+
dailyAt(time: string): this;
|
|
18
|
+
hourly(): this;
|
|
19
|
+
cron(expression: string): this;
|
|
20
|
+
lock(options: {
|
|
21
|
+
ttl: string | number;
|
|
22
|
+
}): this;
|
|
23
|
+
preventOverlap(options?: {
|
|
24
|
+
ttl?: string | number;
|
|
25
|
+
}): this;
|
|
26
|
+
run(handler: (context: RoutineContext) => Promise<void>): RoutineDefinition;
|
|
27
|
+
dispatch<TPayload = any>(job: JobInstance<TPayload>, payload?: TPayload): RoutineDefinition;
|
|
28
|
+
}
|
|
29
|
+
export declare function routine(name: string): RoutineBuilder;
|
|
30
|
+
export {};
|
|
31
|
+
//# sourceMappingURL=routine-builder.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"routine-builder.d.ts","sourceRoot":"","sources":["../src/routine-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAGpB,cAAM,qBAAqB;IACzB,OAAO,CAAC,QAAQ,CAAwC;IAEjD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,MAAM,IAAI,iBAAiB,EAAE;IAI7B,KAAK,IAAI,IAAI;CAGrB;AAED,eAAO,MAAM,eAAe,uBAA8B,CAAC;AAE3D,qBAAa,cAAc;IACzB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,cAAc,CAAC,CAA8B;IACrD,OAAO,CAAC,UAAU,CAAC,CAAiC;gBAExC,IAAI,EAAE,MAAM;IAOjB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAoB3B,MAAM,IAAI,IAAI;IAQd,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAS9B,IAAI,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI;IAS7C,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI;IAKzD,GAAG,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,iBAAiB;IAgB3E,QAAQ,CAAC,QAAQ,GAAG,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,iBAAiB;CAkBnG;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEpD"}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.RoutineBuilder = exports.RoutineRegistry = void 0;
|
|
4
|
+
exports.routine = routine;
|
|
5
|
+
const lock_manager_js_1 = require("./lock-manager.js");
|
|
6
|
+
class GlobalRoutineRegistry {
|
|
7
|
+
routines = new Map();
|
|
8
|
+
register(routine) {
|
|
9
|
+
this.routines.set(routine.name, routine);
|
|
10
|
+
}
|
|
11
|
+
get(name) {
|
|
12
|
+
return this.routines.get(name);
|
|
13
|
+
}
|
|
14
|
+
getAll() {
|
|
15
|
+
return Array.from(this.routines.values());
|
|
16
|
+
}
|
|
17
|
+
clear() {
|
|
18
|
+
this.routines.clear();
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
exports.RoutineRegistry = new GlobalRoutineRegistry();
|
|
22
|
+
class RoutineBuilder {
|
|
23
|
+
name;
|
|
24
|
+
scheduleConfig;
|
|
25
|
+
lockConfig;
|
|
26
|
+
constructor(name) {
|
|
27
|
+
if (!name || !name.trim()) {
|
|
28
|
+
throw new Error('[Argos Routine] Routine name cannot be empty.');
|
|
29
|
+
}
|
|
30
|
+
this.name = name.trim();
|
|
31
|
+
}
|
|
32
|
+
every(interval) {
|
|
33
|
+
const intervalMs = (0, lock_manager_js_1.parseDurationToMs)(interval);
|
|
34
|
+
this.scheduleConfig = {
|
|
35
|
+
type: 'interval',
|
|
36
|
+
value: interval,
|
|
37
|
+
intervalMs,
|
|
38
|
+
};
|
|
39
|
+
return this;
|
|
40
|
+
}
|
|
41
|
+
dailyAt(time) {
|
|
42
|
+
const trimmed = time.trim();
|
|
43
|
+
const parts = trimmed.split(':');
|
|
44
|
+
if (parts.length !== 2) {
|
|
45
|
+
throw new Error(`[Argos Routine] Invalid time format for dailyAt: "${time}". Expected format "HH:mm" (e.g. "03:00").`);
|
|
46
|
+
}
|
|
47
|
+
const hour = parseInt(parts[0], 10);
|
|
48
|
+
const minute = parseInt(parts[1], 10);
|
|
49
|
+
if (Number.isNaN(hour) || hour < 0 || hour > 23 || Number.isNaN(minute) || minute < 0 || minute > 59) {
|
|
50
|
+
throw new Error(`[Argos Routine] Invalid hour or minute in dailyAt("${time}"). Must be between 00:00 and 23:59.`);
|
|
51
|
+
}
|
|
52
|
+
this.scheduleConfig = {
|
|
53
|
+
type: 'dailyAt',
|
|
54
|
+
value: trimmed,
|
|
55
|
+
dailyTime: { hour, minute },
|
|
56
|
+
};
|
|
57
|
+
return this;
|
|
58
|
+
}
|
|
59
|
+
hourly() {
|
|
60
|
+
this.scheduleConfig = {
|
|
61
|
+
type: 'hourly',
|
|
62
|
+
value: 'hourly',
|
|
63
|
+
};
|
|
64
|
+
return this;
|
|
65
|
+
}
|
|
66
|
+
cron(expression) {
|
|
67
|
+
this.scheduleConfig = {
|
|
68
|
+
type: 'cron',
|
|
69
|
+
value: expression,
|
|
70
|
+
cronExpression: expression,
|
|
71
|
+
};
|
|
72
|
+
return this;
|
|
73
|
+
}
|
|
74
|
+
lock(options) {
|
|
75
|
+
const ttlMs = (0, lock_manager_js_1.parseDurationToMs)(options.ttl);
|
|
76
|
+
this.lockConfig = {
|
|
77
|
+
ttl: options.ttl,
|
|
78
|
+
ttlMs,
|
|
79
|
+
};
|
|
80
|
+
return this;
|
|
81
|
+
}
|
|
82
|
+
preventOverlap(options) {
|
|
83
|
+
const ttl = options?.ttl ?? '10m';
|
|
84
|
+
return this.lock({ ttl });
|
|
85
|
+
}
|
|
86
|
+
run(handler) {
|
|
87
|
+
if (!this.scheduleConfig) {
|
|
88
|
+
throw new Error(`[Argos Routine] Schedule not specified for routine "${this.name}". Call .every(), .dailyAt(), .hourly(), or .cron() before .run().`);
|
|
89
|
+
}
|
|
90
|
+
const definition = {
|
|
91
|
+
name: this.name,
|
|
92
|
+
schedule: this.scheduleConfig,
|
|
93
|
+
lockOptions: this.lockConfig,
|
|
94
|
+
handler,
|
|
95
|
+
};
|
|
96
|
+
exports.RoutineRegistry.register(definition);
|
|
97
|
+
return definition;
|
|
98
|
+
}
|
|
99
|
+
dispatch(job, payload) {
|
|
100
|
+
if (!this.scheduleConfig) {
|
|
101
|
+
throw new Error(`[Argos Routine] Schedule not specified for routine "${this.name}". Call .every(), .dailyAt(), .hourly(), or .cron() before .dispatch().`);
|
|
102
|
+
}
|
|
103
|
+
const definition = {
|
|
104
|
+
name: this.name,
|
|
105
|
+
schedule: this.scheduleConfig,
|
|
106
|
+
lockOptions: this.lockConfig,
|
|
107
|
+
dispatchJob: {
|
|
108
|
+
job,
|
|
109
|
+
payload,
|
|
110
|
+
},
|
|
111
|
+
};
|
|
112
|
+
exports.RoutineRegistry.register(definition);
|
|
113
|
+
return definition;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
exports.RoutineBuilder = RoutineBuilder;
|
|
117
|
+
function routine(name) {
|
|
118
|
+
return new RoutineBuilder(name);
|
|
119
|
+
}
|
|
120
|
+
//# sourceMappingURL=routine-builder.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"routine-builder.js","sourceRoot":"","sources":["../src/routine-builder.ts"],"names":[],"mappings":"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"}
|
package/dist/runner.d.ts
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { EventEmitter } from 'node:events';
|
|
2
|
+
import type { RoutineDefinition, RoutineRunnerOptions } from './types.js';
|
|
3
|
+
import { LockManager } from './lock-manager.js';
|
|
4
|
+
export declare class RoutineRunner extends EventEmitter {
|
|
5
|
+
readonly resolutionMs: number;
|
|
6
|
+
readonly lockManager: LockManager;
|
|
7
|
+
private isRunning;
|
|
8
|
+
private isShuttingDown;
|
|
9
|
+
private loopTimer;
|
|
10
|
+
private nativeTicker;
|
|
11
|
+
private activeExecutions;
|
|
12
|
+
private signalCleanup;
|
|
13
|
+
constructor(options?: RoutineRunnerOptions);
|
|
14
|
+
get running(): boolean;
|
|
15
|
+
get isNativeTickerActive(): boolean;
|
|
16
|
+
start(): Promise<void>;
|
|
17
|
+
private scheduleTick;
|
|
18
|
+
tick(now?: number): Promise<void>;
|
|
19
|
+
isEligible(routine: RoutineDefinition, now: number): boolean;
|
|
20
|
+
executeRoutine(routine: RoutineDefinition, now?: number): Promise<boolean>;
|
|
21
|
+
runOnce(name: string): Promise<boolean>;
|
|
22
|
+
stop(): Promise<void>;
|
|
23
|
+
setupSignalHandlers(): void;
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=runner.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAEV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAyB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIvE,qBAAa,aAAc,SAAQ,YAAY;IAC7C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,WAAW,EAAE,WAAW,CAAC;IAEzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,CAAC,EAAE,oBAAoB;IAM1C,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,oBAAoB,IAAI,OAAO,CAEzC;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BnC,OAAO,CAAC,YAAY;IASP,IAAI,CAAC,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAqCtD,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8DtF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B3B,mBAAmB,IAAI,IAAI;CAoBnC"}
|
package/dist/runner.js
ADDED
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.RoutineRunner = void 0;
|
|
4
|
+
const node_events_1 = require("node:events");
|
|
5
|
+
const node_crypto_1 = require("node:crypto");
|
|
6
|
+
const cron_js_1 = require("./cron.js");
|
|
7
|
+
const lock_manager_js_1 = require("./lock-manager.js");
|
|
8
|
+
const routine_builder_js_1 = require("./routine-builder.js");
|
|
9
|
+
const native_bridge_js_1 = require("./native-bridge.js");
|
|
10
|
+
class RoutineRunner extends node_events_1.EventEmitter {
|
|
11
|
+
resolutionMs;
|
|
12
|
+
lockManager;
|
|
13
|
+
isRunning = false;
|
|
14
|
+
isShuttingDown = false;
|
|
15
|
+
loopTimer = null;
|
|
16
|
+
nativeTicker = null;
|
|
17
|
+
activeExecutions = new Set();
|
|
18
|
+
signalCleanup = null;
|
|
19
|
+
constructor(options) {
|
|
20
|
+
super();
|
|
21
|
+
this.resolutionMs = options?.resolutionMs ?? 1000;
|
|
22
|
+
this.lockManager = options?.lockManager ?? (0, lock_manager_js_1.getDefaultLockManager)();
|
|
23
|
+
}
|
|
24
|
+
get running() {
|
|
25
|
+
return this.isRunning;
|
|
26
|
+
}
|
|
27
|
+
get isNativeTickerActive() {
|
|
28
|
+
return this.nativeTicker !== null;
|
|
29
|
+
}
|
|
30
|
+
async start() {
|
|
31
|
+
if (this.isRunning)
|
|
32
|
+
return;
|
|
33
|
+
this.isRunning = true;
|
|
34
|
+
this.isShuttingDown = false;
|
|
35
|
+
const now = Date.now();
|
|
36
|
+
for (const routine of routine_builder_js_1.RoutineRegistry.getAll()) {
|
|
37
|
+
if (routine.lastRunAt === undefined) {
|
|
38
|
+
routine.lastRunAt = now;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
this.emit('runner:started', { routinesCount: routine_builder_js_1.RoutineRegistry.getAll().length });
|
|
42
|
+
// Try starting high-precision native ticker via Tokio runtime
|
|
43
|
+
const nativeTicker = (0, native_bridge_js_1.createPrecisionTicker)(this.resolutionMs, (ts) => {
|
|
44
|
+
if (this.isRunning && !this.isShuttingDown) {
|
|
45
|
+
this.tick(ts);
|
|
46
|
+
}
|
|
47
|
+
});
|
|
48
|
+
if (nativeTicker) {
|
|
49
|
+
this.nativeTicker = nativeTicker;
|
|
50
|
+
}
|
|
51
|
+
else {
|
|
52
|
+
this.scheduleTick();
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
scheduleTick() {
|
|
56
|
+
if (!this.isRunning || this.isShuttingDown)
|
|
57
|
+
return;
|
|
58
|
+
this.loopTimer = setTimeout(async () => {
|
|
59
|
+
await this.tick();
|
|
60
|
+
this.scheduleTick();
|
|
61
|
+
}, this.resolutionMs);
|
|
62
|
+
}
|
|
63
|
+
async tick(now = Date.now()) {
|
|
64
|
+
const routines = routine_builder_js_1.RoutineRegistry.getAll();
|
|
65
|
+
const eligible = [];
|
|
66
|
+
for (const r of routines) {
|
|
67
|
+
if (this.isEligible(r, now)) {
|
|
68
|
+
eligible.push(r);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
if (eligible.length === 0)
|
|
72
|
+
return;
|
|
73
|
+
const promises = eligible.map((routine) => this.executeRoutine(routine, now));
|
|
74
|
+
await Promise.allSettled(promises);
|
|
75
|
+
}
|
|
76
|
+
isEligible(routine, now) {
|
|
77
|
+
const date = new Date(now);
|
|
78
|
+
const schedule = routine.schedule;
|
|
79
|
+
switch (schedule.type) {
|
|
80
|
+
case 'interval': {
|
|
81
|
+
const intervalMs = schedule.intervalMs ?? 60000;
|
|
82
|
+
const last = routine.lastRunAt ?? 0;
|
|
83
|
+
return now - last >= intervalMs;
|
|
84
|
+
}
|
|
85
|
+
case 'dailyAt': {
|
|
86
|
+
if (!schedule.dailyTime)
|
|
87
|
+
return false;
|
|
88
|
+
const matchesTime = date.getHours() === schedule.dailyTime.hour &&
|
|
89
|
+
date.getMinutes() === schedule.dailyTime.minute;
|
|
90
|
+
if (!matchesTime)
|
|
91
|
+
return false;
|
|
92
|
+
const dayKey = `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}`;
|
|
93
|
+
return routine.lastRunKey !== dayKey;
|
|
94
|
+
}
|
|
95
|
+
case 'hourly': {
|
|
96
|
+
if (date.getMinutes() !== 0)
|
|
97
|
+
return false;
|
|
98
|
+
const hourKey = `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}-${date.getHours()}`;
|
|
99
|
+
return routine.lastRunKey !== hourKey;
|
|
100
|
+
}
|
|
101
|
+
case 'cron': {
|
|
102
|
+
if (!schedule.cronExpression)
|
|
103
|
+
return false;
|
|
104
|
+
if (!(0, cron_js_1.matchesCron)(schedule.cronExpression, date))
|
|
105
|
+
return false;
|
|
106
|
+
const minuteKey = `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}-${date.getHours()}-${date.getMinutes()}`;
|
|
107
|
+
return routine.lastRunKey !== minuteKey;
|
|
108
|
+
}
|
|
109
|
+
default:
|
|
110
|
+
return false;
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
async executeRoutine(routine, now = Date.now()) {
|
|
114
|
+
const lockKey = `routine:${routine.name}`;
|
|
115
|
+
const hasLock = Boolean(routine.lockOptions);
|
|
116
|
+
let acquiredLock = false;
|
|
117
|
+
if (hasLock) {
|
|
118
|
+
acquiredLock = await this.lockManager.acquire(lockKey, routine.lockOptions.ttlMs);
|
|
119
|
+
if (!acquiredLock) {
|
|
120
|
+
// Silently skip if locked
|
|
121
|
+
this.emit('routine:skipped', { name: routine.name, reason: 'lock_held' });
|
|
122
|
+
return false;
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
const executionPromise = (async () => {
|
|
126
|
+
const executionId = node_crypto_1.randomUUID ? (0, node_crypto_1.randomUUID)() : `exec_${now}_${Math.random().toString(36).slice(2, 8)}`;
|
|
127
|
+
const context = {
|
|
128
|
+
routineName: routine.name,
|
|
129
|
+
scheduledTime: new Date(now),
|
|
130
|
+
executionId,
|
|
131
|
+
};
|
|
132
|
+
this.emit('routine:started', { name: routine.name, executionId });
|
|
133
|
+
try {
|
|
134
|
+
if (routine.dispatchJob) {
|
|
135
|
+
await routine.dispatchJob.job.dispatch(routine.dispatchJob.payload);
|
|
136
|
+
}
|
|
137
|
+
else if (routine.handler) {
|
|
138
|
+
await routine.handler(context);
|
|
139
|
+
}
|
|
140
|
+
this.emit('routine:completed', { name: routine.name, executionId });
|
|
141
|
+
}
|
|
142
|
+
catch (error) {
|
|
143
|
+
this.emit('routine:failed', { name: routine.name, executionId, error });
|
|
144
|
+
}
|
|
145
|
+
finally {
|
|
146
|
+
// Update routine runtime timestamps
|
|
147
|
+
routine.lastRunAt = Date.now();
|
|
148
|
+
const date = new Date(now);
|
|
149
|
+
if (routine.schedule.type === 'dailyAt') {
|
|
150
|
+
routine.lastRunKey = `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}`;
|
|
151
|
+
}
|
|
152
|
+
else if (routine.schedule.type === 'hourly') {
|
|
153
|
+
routine.lastRunKey = `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}-${date.getHours()}`;
|
|
154
|
+
}
|
|
155
|
+
else if (routine.schedule.type === 'cron') {
|
|
156
|
+
routine.lastRunKey = `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}-${date.getHours()}-${date.getMinutes()}`;
|
|
157
|
+
}
|
|
158
|
+
// Always release lock immediately in finally block
|
|
159
|
+
if (hasLock && acquiredLock) {
|
|
160
|
+
await this.lockManager.release(lockKey);
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
})();
|
|
164
|
+
this.activeExecutions.add(executionPromise);
|
|
165
|
+
executionPromise.finally(() => {
|
|
166
|
+
this.activeExecutions.delete(executionPromise);
|
|
167
|
+
});
|
|
168
|
+
await executionPromise;
|
|
169
|
+
return true;
|
|
170
|
+
}
|
|
171
|
+
async runOnce(name) {
|
|
172
|
+
const target = routine_builder_js_1.RoutineRegistry.get(name);
|
|
173
|
+
if (!target) {
|
|
174
|
+
throw new Error(`[Argos Routine] Routine "${name}" not found in registry.`);
|
|
175
|
+
}
|
|
176
|
+
return await this.executeRoutine(target, Date.now());
|
|
177
|
+
}
|
|
178
|
+
async stop() {
|
|
179
|
+
if (!this.isRunning && !this.isShuttingDown)
|
|
180
|
+
return;
|
|
181
|
+
this.isShuttingDown = true;
|
|
182
|
+
this.isRunning = false;
|
|
183
|
+
if (this.nativeTicker) {
|
|
184
|
+
try {
|
|
185
|
+
this.nativeTicker.stop();
|
|
186
|
+
}
|
|
187
|
+
catch { }
|
|
188
|
+
this.nativeTicker = null;
|
|
189
|
+
}
|
|
190
|
+
if (this.loopTimer) {
|
|
191
|
+
clearTimeout(this.loopTimer);
|
|
192
|
+
this.loopTimer = null;
|
|
193
|
+
}
|
|
194
|
+
this.emit('runner:stopping', { activeCount: this.activeExecutions.size });
|
|
195
|
+
// Wait for all currently executing routines to complete
|
|
196
|
+
await Promise.allSettled(Array.from(this.activeExecutions));
|
|
197
|
+
if (this.signalCleanup) {
|
|
198
|
+
this.signalCleanup();
|
|
199
|
+
this.signalCleanup = null;
|
|
200
|
+
}
|
|
201
|
+
this.emit('runner:stopped');
|
|
202
|
+
}
|
|
203
|
+
setupSignalHandlers() {
|
|
204
|
+
if (this.signalCleanup)
|
|
205
|
+
return;
|
|
206
|
+
const onSignal = async (signal) => {
|
|
207
|
+
this.emit('runner:signal', signal);
|
|
208
|
+
await this.stop();
|
|
209
|
+
process.exit(0);
|
|
210
|
+
};
|
|
211
|
+
const sigintHandler = () => void onSignal('SIGINT');
|
|
212
|
+
const sigtermHandler = () => void onSignal('SIGTERM');
|
|
213
|
+
process.once('SIGINT', sigintHandler);
|
|
214
|
+
process.once('SIGTERM', sigtermHandler);
|
|
215
|
+
this.signalCleanup = () => {
|
|
216
|
+
process.removeListener('SIGINT', sigintHandler);
|
|
217
|
+
process.removeListener('SIGTERM', sigtermHandler);
|
|
218
|
+
};
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
exports.RoutineRunner = RoutineRunner;
|
|
222
|
+
//# sourceMappingURL=runner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { JobInstance } from '@argos-js/queue';
|
|
2
|
+
export interface RoutineContext {
|
|
3
|
+
routineName: string;
|
|
4
|
+
scheduledTime: Date;
|
|
5
|
+
executionId: string;
|
|
6
|
+
signal?: AbortSignal | undefined;
|
|
7
|
+
}
|
|
8
|
+
export type RoutineScheduleType = 'interval' | 'dailyAt' | 'hourly' | 'cron';
|
|
9
|
+
export interface RoutineSchedule {
|
|
10
|
+
type: RoutineScheduleType;
|
|
11
|
+
value: string;
|
|
12
|
+
intervalMs?: number | undefined;
|
|
13
|
+
dailyTime?: {
|
|
14
|
+
hour: number;
|
|
15
|
+
minute: number;
|
|
16
|
+
} | undefined;
|
|
17
|
+
cronExpression?: string | undefined;
|
|
18
|
+
}
|
|
19
|
+
export interface RoutineLockOptions {
|
|
20
|
+
ttl: string | number;
|
|
21
|
+
ttlMs: number;
|
|
22
|
+
}
|
|
23
|
+
export interface RoutineDefinition {
|
|
24
|
+
name: string;
|
|
25
|
+
schedule: RoutineSchedule;
|
|
26
|
+
lockOptions?: RoutineLockOptions | undefined;
|
|
27
|
+
handler?: ((context: RoutineContext) => Promise<void>) | undefined;
|
|
28
|
+
dispatchJob?: {
|
|
29
|
+
job: JobInstance<any>;
|
|
30
|
+
payload: any;
|
|
31
|
+
} | undefined;
|
|
32
|
+
lastRunAt?: number | undefined;
|
|
33
|
+
lastRunKey?: string | undefined;
|
|
34
|
+
}
|
|
35
|
+
export interface LockAdapter {
|
|
36
|
+
acquire(key: string, ttlMs: number): Promise<boolean>;
|
|
37
|
+
release(key: string): Promise<void>;
|
|
38
|
+
isLocked(key: string): Promise<boolean>;
|
|
39
|
+
clear(): Promise<void>;
|
|
40
|
+
}
|
|
41
|
+
export interface RoutineRunnerOptions {
|
|
42
|
+
resolutionMs?: number | undefined;
|
|
43
|
+
lockManager?: LockAdapter | undefined;
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACzD,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACnE,WAAW,CAAC,EAAE;QACZ,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,EAAE,GAAG,CAAC;KACd,GAAG,SAAS,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACvC"}
|