@rcpooley/concord 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 +318 -0
- package/bin/concord.service +69 -0
- package/dist/age.d.ts +20 -0
- package/dist/age.d.ts.map +1 -0
- package/dist/age.js +58 -0
- package/dist/age.js.map +1 -0
- package/dist/cli/main.d.ts +3 -0
- package/dist/cli/main.d.ts.map +1 -0
- package/dist/cli/main.js +301 -0
- package/dist/cli/main.js.map +1 -0
- package/dist/daemon.d.ts +4 -0
- package/dist/daemon.d.ts.map +1 -0
- package/dist/daemon.js +394 -0
- package/dist/daemon.js.map +1 -0
- package/dist/eval-config.d.ts +2 -0
- package/dist/eval-config.d.ts.map +1 -0
- package/dist/eval-config.js +45 -0
- package/dist/eval-config.js.map +1 -0
- package/dist/exec.d.ts +168 -0
- package/dist/exec.d.ts.map +1 -0
- package/dist/exec.js +313 -0
- package/dist/exec.js.map +1 -0
- package/dist/git.d.ts +59 -0
- package/dist/git.d.ts.map +1 -0
- package/dist/git.js +265 -0
- package/dist/git.js.map +1 -0
- package/dist/hook.d.ts +37 -0
- package/dist/hook.d.ts.map +1 -0
- package/dist/hook.js +89 -0
- package/dist/hook.js.map +1 -0
- package/dist/index.d.ts +18 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +15 -0
- package/dist/index.js.map +1 -0
- package/dist/init.d.ts +76 -0
- package/dist/init.d.ts.map +1 -0
- package/dist/init.js +236 -0
- package/dist/init.js.map +1 -0
- package/dist/loader.d.ts +35 -0
- package/dist/loader.d.ts.map +1 -0
- package/dist/loader.js +230 -0
- package/dist/loader.js.map +1 -0
- package/dist/module.d.ts +116 -0
- package/dist/module.d.ts.map +1 -0
- package/dist/module.js +100 -0
- package/dist/module.js.map +1 -0
- package/dist/modules/apt/index.d.ts +45 -0
- package/dist/modules/apt/index.d.ts.map +1 -0
- package/dist/modules/apt/index.js +249 -0
- package/dist/modules/apt/index.js.map +1 -0
- package/dist/modules/apt/schema.d.ts +63 -0
- package/dist/modules/apt/schema.d.ts.map +1 -0
- package/dist/modules/apt/schema.js +75 -0
- package/dist/modules/apt/schema.js.map +1 -0
- package/dist/modules/checkout/index.d.ts +88 -0
- package/dist/modules/checkout/index.d.ts.map +1 -0
- package/dist/modules/checkout/index.js +382 -0
- package/dist/modules/checkout/index.js.map +1 -0
- package/dist/modules/checkout/schema.d.ts +52 -0
- package/dist/modules/checkout/schema.d.ts.map +1 -0
- package/dist/modules/checkout/schema.js +132 -0
- package/dist/modules/checkout/schema.js.map +1 -0
- package/dist/modules/cloudflare/api.d.ts +64 -0
- package/dist/modules/cloudflare/api.d.ts.map +1 -0
- package/dist/modules/cloudflare/api.js +98 -0
- package/dist/modules/cloudflare/api.js.map +1 -0
- package/dist/modules/cloudflare/index.d.ts +74 -0
- package/dist/modules/cloudflare/index.d.ts.map +1 -0
- package/dist/modules/cloudflare/index.js +374 -0
- package/dist/modules/cloudflare/index.js.map +1 -0
- package/dist/modules/cloudflare/schema.d.ts +62 -0
- package/dist/modules/cloudflare/schema.d.ts.map +1 -0
- package/dist/modules/cloudflare/schema.js +85 -0
- package/dist/modules/cloudflare/schema.js.map +1 -0
- package/dist/modules/docker/index.d.ts +83 -0
- package/dist/modules/docker/index.d.ts.map +1 -0
- package/dist/modules/docker/index.js +470 -0
- package/dist/modules/docker/index.js.map +1 -0
- package/dist/modules/docker/registry.d.ts +35 -0
- package/dist/modules/docker/registry.d.ts.map +1 -0
- package/dist/modules/docker/registry.js +95 -0
- package/dist/modules/docker/registry.js.map +1 -0
- package/dist/modules/docker/render.d.ts +45 -0
- package/dist/modules/docker/render.d.ts.map +1 -0
- package/dist/modules/docker/render.js +162 -0
- package/dist/modules/docker/render.js.map +1 -0
- package/dist/modules/docker/schema.d.ts +231 -0
- package/dist/modules/docker/schema.d.ts.map +1 -0
- package/dist/modules/docker/schema.js +335 -0
- package/dist/modules/docker/schema.js.map +1 -0
- package/dist/modules/docker/sweeper.d.ts +64 -0
- package/dist/modules/docker/sweeper.d.ts.map +1 -0
- package/dist/modules/docker/sweeper.js +94 -0
- package/dist/modules/docker/sweeper.js.map +1 -0
- package/dist/modules/file/index.d.ts +79 -0
- package/dist/modules/file/index.d.ts.map +1 -0
- package/dist/modules/file/index.js +305 -0
- package/dist/modules/file/index.js.map +1 -0
- package/dist/modules/file/schema.d.ts +45 -0
- package/dist/modules/file/schema.d.ts.map +1 -0
- package/dist/modules/file/schema.js +114 -0
- package/dist/modules/file/schema.js.map +1 -0
- package/dist/modules/index.d.ts +20 -0
- package/dist/modules/index.d.ts.map +1 -0
- package/dist/modules/index.js +11 -0
- package/dist/modules/index.js.map +1 -0
- package/dist/modules/porkbun/api.d.ts +36 -0
- package/dist/modules/porkbun/api.d.ts.map +1 -0
- package/dist/modules/porkbun/api.js +62 -0
- package/dist/modules/porkbun/api.js.map +1 -0
- package/dist/modules/porkbun/index.d.ts +50 -0
- package/dist/modules/porkbun/index.d.ts.map +1 -0
- package/dist/modules/porkbun/index.js +236 -0
- package/dist/modules/porkbun/index.js.map +1 -0
- package/dist/modules/porkbun/schema.d.ts +38 -0
- package/dist/modules/porkbun/schema.d.ts.map +1 -0
- package/dist/modules/porkbun/schema.js +39 -0
- package/dist/modules/porkbun/schema.js.map +1 -0
- package/dist/modules/script/index.d.ts +43 -0
- package/dist/modules/script/index.d.ts.map +1 -0
- package/dist/modules/script/index.js +116 -0
- package/dist/modules/script/index.js.map +1 -0
- package/dist/modules/script/schema.d.ts +25 -0
- package/dist/modules/script/schema.d.ts.map +1 -0
- package/dist/modules/script/schema.js +63 -0
- package/dist/modules/script/schema.js.map +1 -0
- package/dist/modules/systemd/index.d.ts +93 -0
- package/dist/modules/systemd/index.d.ts.map +1 -0
- package/dist/modules/systemd/index.js +394 -0
- package/dist/modules/systemd/index.js.map +1 -0
- package/dist/modules/systemd/render.d.ts +41 -0
- package/dist/modules/systemd/render.d.ts.map +1 -0
- package/dist/modules/systemd/render.js +252 -0
- package/dist/modules/systemd/render.js.map +1 -0
- package/dist/modules/systemd/schema.d.ts +293 -0
- package/dist/modules/systemd/schema.d.ts.map +1 -0
- package/dist/modules/systemd/schema.js +302 -0
- package/dist/modules/systemd/schema.js.map +1 -0
- package/dist/modules/systemd/sweeper.d.ts +31 -0
- package/dist/modules/systemd/sweeper.d.ts.map +1 -0
- package/dist/modules/systemd/sweeper.js +77 -0
- package/dist/modules/systemd/sweeper.js.map +1 -0
- package/dist/plans.d.ts +132 -0
- package/dist/plans.d.ts.map +1 -0
- package/dist/plans.js +315 -0
- package/dist/plans.js.map +1 -0
- package/dist/records.d.ts +37 -0
- package/dist/records.d.ts.map +1 -0
- package/dist/records.js +100 -0
- package/dist/records.js.map +1 -0
- package/dist/registry.d.ts +38 -0
- package/dist/registry.d.ts.map +1 -0
- package/dist/registry.js +31 -0
- package/dist/registry.js.map +1 -0
- package/dist/runner.d.ts +48 -0
- package/dist/runner.d.ts.map +1 -0
- package/dist/runner.js +150 -0
- package/dist/runner.js.map +1 -0
- package/dist/scheduler.d.ts +36 -0
- package/dist/scheduler.d.ts.map +1 -0
- package/dist/scheduler.js +77 -0
- package/dist/scheduler.js.map +1 -0
- package/dist/schema.d.ts +762 -0
- package/dist/schema.d.ts.map +1 -0
- package/dist/schema.js +185 -0
- package/dist/schema.js.map +1 -0
- package/dist/secret.d.ts +24 -0
- package/dist/secret.d.ts.map +1 -0
- package/dist/secret.js +3 -0
- package/dist/secret.js.map +1 -0
- package/dist/ui.d.ts +62 -0
- package/dist/ui.d.ts.map +1 -0
- package/dist/ui.js +288 -0
- package/dist/ui.js.map +1 -0
- package/package.json +57 -0
package/dist/runner.js
ADDED
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
import { mkdirSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { SecretResolver } from './age.js';
|
|
4
|
+
import { LocalExec, SshExec } from './exec.js';
|
|
5
|
+
export async function run(opts) {
|
|
6
|
+
const resolver = new SecretResolver(opts.ageKey);
|
|
7
|
+
// One Exec per host, built once and shared: an SshExec holds a multiplexed
|
|
8
|
+
// connection, so building per module would throw that away.
|
|
9
|
+
const execs = new Map();
|
|
10
|
+
const closers = [];
|
|
11
|
+
const execFor = async (hostName) => {
|
|
12
|
+
if (!hostName)
|
|
13
|
+
return execs.get('') ?? (execs.set('', new LocalExec('local')), execs.get(''));
|
|
14
|
+
const cached = execs.get(hostName);
|
|
15
|
+
if (cached)
|
|
16
|
+
return cached;
|
|
17
|
+
const h = opts.hosts?.[hostName];
|
|
18
|
+
if (!h)
|
|
19
|
+
throw new Error(`no host "${hostName}" in the hosts registry`);
|
|
20
|
+
const made = h.transport === 'local'
|
|
21
|
+
? new LocalExec(hostName)
|
|
22
|
+
: new SshExec({
|
|
23
|
+
host: hostName,
|
|
24
|
+
ip: h.ip,
|
|
25
|
+
user: h.user,
|
|
26
|
+
...(h.port !== undefined ? { port: h.port } : {}),
|
|
27
|
+
...(h.key ? { key: await resolver.resolve(h.key) } : {}),
|
|
28
|
+
});
|
|
29
|
+
if (made instanceof SshExec)
|
|
30
|
+
closers.push(() => made.close());
|
|
31
|
+
execs.set(hostName, made);
|
|
32
|
+
return made;
|
|
33
|
+
};
|
|
34
|
+
const warnings = [];
|
|
35
|
+
const baseRuntime = {
|
|
36
|
+
resolveSecret: (s) => resolver.resolve(s),
|
|
37
|
+
log: opts.log,
|
|
38
|
+
settings: opts.settings ?? {},
|
|
39
|
+
warn: (scope, message) => {
|
|
40
|
+
warnings.push({ scope, message });
|
|
41
|
+
opts.log(scope, `WARNING: ${message}`);
|
|
42
|
+
},
|
|
43
|
+
configDir: opts.configDir,
|
|
44
|
+
stateDir: (moduleId) => {
|
|
45
|
+
const dir = join(opts.stateRoot, moduleId);
|
|
46
|
+
mkdirSync(dir, { recursive: true });
|
|
47
|
+
return dir;
|
|
48
|
+
},
|
|
49
|
+
};
|
|
50
|
+
const results = [];
|
|
51
|
+
let failed = false;
|
|
52
|
+
// Fixed order: the order declared in the config array.
|
|
53
|
+
//
|
|
54
|
+
// A failure ABORTS the run — every later module is left unevaluated. Modules
|
|
55
|
+
// in the host bootstrap chain are a genuine dependency chain (apt -> file ->
|
|
56
|
+
// systemd -> compose), so continuing past a failure would run `compose`
|
|
57
|
+
// against a Docker that `systemd` just failed to start: two errors, one
|
|
58
|
+
// cause, and the second one misleading. Aborting means every module can trust
|
|
59
|
+
// that everything declared above it converged.
|
|
60
|
+
//
|
|
61
|
+
// This is also why no `dependsOn` graph is needed — array order IS the
|
|
62
|
+
// dependency, which puts the ordering rule in one obvious place.
|
|
63
|
+
// Hosts that are declared optional and did not answer. On a machine that
|
|
64
|
+
// sleeps (a laptop), a closed lid fails the run, and with
|
|
65
|
+
// abort-on-failure that stops every later module. A permanently red reconcile
|
|
66
|
+
// stops being read, which is worse than skipping a sleeping machine.
|
|
67
|
+
const unreachable = new Set();
|
|
68
|
+
for (const [i, m] of opts.modules.entries()) {
|
|
69
|
+
const hostName = m.host;
|
|
70
|
+
const scope = hostName ? `${m.kind}:${m.id}@${hostName}` : `${m.kind}:${m.id}`;
|
|
71
|
+
const result = {
|
|
72
|
+
id: m.id,
|
|
73
|
+
kind: m.kind,
|
|
74
|
+
...(hostName ? { host: hostName } : {}),
|
|
75
|
+
ops: [],
|
|
76
|
+
applied: false,
|
|
77
|
+
};
|
|
78
|
+
try {
|
|
79
|
+
if (hostName && unreachable.has(hostName)) {
|
|
80
|
+
opts.log(scope, `skipped — host ${hostName} unreachable and declared skipIfUnreachable`);
|
|
81
|
+
result.unreachable = true;
|
|
82
|
+
results.push(result);
|
|
83
|
+
continue;
|
|
84
|
+
}
|
|
85
|
+
const hostExec = await execFor(hostName);
|
|
86
|
+
// Whether an unreachable host skips or fails is the HOST's property —
|
|
87
|
+
// a machine that sleeps does so for of every module targeting them.
|
|
88
|
+
if (hostName && opts.hosts[hostName]?.skipIfUnreachable && !hostExec.reachable()) {
|
|
89
|
+
unreachable.add(hostName);
|
|
90
|
+
opts.log(scope, `skipped — host ${hostName} unreachable and declared skipIfUnreachable`);
|
|
91
|
+
result.unreachable = true;
|
|
92
|
+
results.push(result);
|
|
93
|
+
continue;
|
|
94
|
+
}
|
|
95
|
+
m.attachRuntime({
|
|
96
|
+
...baseRuntime,
|
|
97
|
+
exec: hostExec,
|
|
98
|
+
...(hostName ? { hostName } : {}),
|
|
99
|
+
});
|
|
100
|
+
const [actual, desired] = await Promise.all([m.read(), m.desired()]);
|
|
101
|
+
const ops = m.diff(actual, desired);
|
|
102
|
+
result.ops = ops;
|
|
103
|
+
if (ops.length === 0) {
|
|
104
|
+
opts.log(scope, 'no changes');
|
|
105
|
+
}
|
|
106
|
+
else {
|
|
107
|
+
for (const op of ops)
|
|
108
|
+
opts.log(scope, ` [${op.kind}] ${op.summary}`);
|
|
109
|
+
opts.log(scope, `${ops.length} change(s) planned`);
|
|
110
|
+
if (opts.apply) {
|
|
111
|
+
await m.apply(ops);
|
|
112
|
+
result.applied = true;
|
|
113
|
+
opts.log(scope, `applied ${ops.length} change(s)`);
|
|
114
|
+
}
|
|
115
|
+
else {
|
|
116
|
+
opts.log(scope, 'plan only — not applying');
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
catch (err) {
|
|
121
|
+
failed = true;
|
|
122
|
+
result.error = err instanceof Error ? err.message : String(err);
|
|
123
|
+
opts.log(scope, `ERROR: ${result.error}`);
|
|
124
|
+
results.push(result);
|
|
125
|
+
closers.forEach((c) => c());
|
|
126
|
+
// Abort in plan mode too: a module that could not read produces no valid
|
|
127
|
+
// plan, so every plan below it is computed against state that may never
|
|
128
|
+
// have existed. A confident-looking wrong plan is worse than no plan.
|
|
129
|
+
return {
|
|
130
|
+
modules: results,
|
|
131
|
+
totalOps: results.reduce((n, r) => n + r.ops.length, 0),
|
|
132
|
+
failed,
|
|
133
|
+
skipped: opts.modules.slice(i + 1).map((s) => `${s.kind}:${s.id}`),
|
|
134
|
+
unreachable: results.filter((r) => r.unreachable).map((r) => `${r.kind}:${r.id}`),
|
|
135
|
+
warnings,
|
|
136
|
+
};
|
|
137
|
+
}
|
|
138
|
+
results.push(result);
|
|
139
|
+
}
|
|
140
|
+
closers.forEach((c) => c());
|
|
141
|
+
return {
|
|
142
|
+
modules: results,
|
|
143
|
+
totalOps: results.reduce((n, r) => n + r.ops.length, 0),
|
|
144
|
+
failed,
|
|
145
|
+
skipped: [],
|
|
146
|
+
unreachable: results.filter((r) => r.unreachable).map((r) => `${r.kind}:${r.id}`),
|
|
147
|
+
warnings,
|
|
148
|
+
};
|
|
149
|
+
}
|
|
150
|
+
//# sourceMappingURL=runner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* When the daemon reconciles, and how overlapping requests are resolved.
|
|
3
|
+
*
|
|
4
|
+
* Split out from the daemon so the interesting part — what happens when a
|
|
5
|
+
* trigger arrives mid-run — is testable without starting a process, opening a
|
|
6
|
+
* socket, or waiting fifteen minutes.
|
|
7
|
+
*/
|
|
8
|
+
export declare class Scheduler {
|
|
9
|
+
#private;
|
|
10
|
+
get running(): boolean;
|
|
11
|
+
get stopping(): boolean;
|
|
12
|
+
/**
|
|
13
|
+
* Ask for a reconcile.
|
|
14
|
+
*
|
|
15
|
+
* COALESCING, not queueing: ten requests during one run produce exactly one
|
|
16
|
+
* extra run. The mechanism this replaces had the opposite failure —
|
|
17
|
+
* `systemctl start` on an already-active unit is a silent no-op, so a trigger
|
|
18
|
+
* arriving mid-run was simply lost, and you waited for the next tick.
|
|
19
|
+
*/
|
|
20
|
+
request(): 'started' | 'queued';
|
|
21
|
+
/** Stop after the current cycle. Cuts any sleep short. */
|
|
22
|
+
stop(): void;
|
|
23
|
+
/**
|
|
24
|
+
* Run one cycle with the in-flight flag held.
|
|
25
|
+
*
|
|
26
|
+
* Deliberately does NOT catch: the daemon decides what a failure means and
|
|
27
|
+
* logs it. A scheduler that swallowed errors would make "the loop kept going"
|
|
28
|
+
* and "the reconcile succeeded" indistinguishable.
|
|
29
|
+
*/
|
|
30
|
+
cycle(fn: () => Promise<void>): Promise<void>;
|
|
31
|
+
/** True at most once per set of mid-run requests, and clears the flag. */
|
|
32
|
+
takeRerun(): boolean;
|
|
33
|
+
/** Resolves after `seconds`, or early on request()/stop(). */
|
|
34
|
+
sleep(seconds: number): Promise<void>;
|
|
35
|
+
}
|
|
36
|
+
//# sourceMappingURL=scheduler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,SAAS;;IAMpB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;;OAOG;IACH,OAAO,IAAI,SAAS,GAAG,QAAQ;IAS/B,0DAA0D;IAC1D,IAAI,IAAI,IAAI;IAKZ;;;;;;OAMG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD,0EAA0E;IAC1E,SAAS,IAAI,OAAO;IAMpB,8DAA8D;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAatC"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* When the daemon reconciles, and how overlapping requests are resolved.
|
|
3
|
+
*
|
|
4
|
+
* Split out from the daemon so the interesting part — what happens when a
|
|
5
|
+
* trigger arrives mid-run — is testable without starting a process, opening a
|
|
6
|
+
* socket, or waiting fifteen minutes.
|
|
7
|
+
*/
|
|
8
|
+
export class Scheduler {
|
|
9
|
+
#running = false;
|
|
10
|
+
#rerun = false;
|
|
11
|
+
#stopping = false;
|
|
12
|
+
#wake = null;
|
|
13
|
+
get running() {
|
|
14
|
+
return this.#running;
|
|
15
|
+
}
|
|
16
|
+
get stopping() {
|
|
17
|
+
return this.#stopping;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Ask for a reconcile.
|
|
21
|
+
*
|
|
22
|
+
* COALESCING, not queueing: ten requests during one run produce exactly one
|
|
23
|
+
* extra run. The mechanism this replaces had the opposite failure —
|
|
24
|
+
* `systemctl start` on an already-active unit is a silent no-op, so a trigger
|
|
25
|
+
* arriving mid-run was simply lost, and you waited for the next tick.
|
|
26
|
+
*/
|
|
27
|
+
request() {
|
|
28
|
+
if (this.#running) {
|
|
29
|
+
this.#rerun = true;
|
|
30
|
+
return 'queued';
|
|
31
|
+
}
|
|
32
|
+
this.#wake?.();
|
|
33
|
+
return 'started';
|
|
34
|
+
}
|
|
35
|
+
/** Stop after the current cycle. Cuts any sleep short. */
|
|
36
|
+
stop() {
|
|
37
|
+
this.#stopping = true;
|
|
38
|
+
this.#wake?.();
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Run one cycle with the in-flight flag held.
|
|
42
|
+
*
|
|
43
|
+
* Deliberately does NOT catch: the daemon decides what a failure means and
|
|
44
|
+
* logs it. A scheduler that swallowed errors would make "the loop kept going"
|
|
45
|
+
* and "the reconcile succeeded" indistinguishable.
|
|
46
|
+
*/
|
|
47
|
+
async cycle(fn) {
|
|
48
|
+
this.#running = true;
|
|
49
|
+
try {
|
|
50
|
+
await fn();
|
|
51
|
+
}
|
|
52
|
+
finally {
|
|
53
|
+
this.#running = false;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
/** True at most once per set of mid-run requests, and clears the flag. */
|
|
57
|
+
takeRerun() {
|
|
58
|
+
const r = this.#rerun;
|
|
59
|
+
this.#rerun = false;
|
|
60
|
+
return r;
|
|
61
|
+
}
|
|
62
|
+
/** Resolves after `seconds`, or early on request()/stop(). */
|
|
63
|
+
sleep(seconds) {
|
|
64
|
+
return new Promise((resolve) => {
|
|
65
|
+
const timer = setTimeout(() => {
|
|
66
|
+
this.#wake = null;
|
|
67
|
+
resolve();
|
|
68
|
+
}, seconds * 1000);
|
|
69
|
+
this.#wake = () => {
|
|
70
|
+
clearTimeout(timer);
|
|
71
|
+
this.#wake = null;
|
|
72
|
+
resolve();
|
|
73
|
+
};
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=scheduler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IACpB,QAAQ,GAAG,KAAK,CAAA;IAChB,MAAM,GAAG,KAAK,CAAA;IACd,SAAS,GAAG,KAAK,CAAA;IACjB,KAAK,GAAwB,IAAI,CAAA;IAEjC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,EAAE,CAAA;QACd,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,0DAA0D;IAC1D,IAAI;QACF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,IAAI,CAAC,KAAK,EAAE,EAAE,CAAA;IAChB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,EAAuB;QACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,CAAA;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACvB,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,SAAS;QACP,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAA;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,OAAe;QACnB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;gBACjB,OAAO,EAAE,CAAA;YACX,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAA;YAClB,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE;gBAChB,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;gBACjB,OAAO,EAAE,CAAA;YACX,CAAC,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;CACF"}
|