@marinoscar/platform-cli 0.1.0-next.23 → 0.1.0-next.25
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/CHANGELOG.md +40 -0
- package/README.md +4 -3
- package/dist/engine/commands/node.d.ts.map +1 -1
- package/dist/engine/commands/node.js +73 -6
- package/dist/engine/commands/node.js.map +1 -1
- package/dist/engine/conformance.d.ts +3 -0
- package/dist/engine/conformance.d.ts.map +1 -1
- package/dist/engine/conformance.js +7 -0
- package/dist/engine/conformance.js.map +1 -1
- package/dist/engine/create-cli.d.ts +21 -0
- package/dist/engine/create-cli.d.ts.map +1 -1
- package/dist/engine/create-cli.js +11 -0
- package/dist/engine/create-cli.js.map +1 -1
- package/dist/engine/index.d.ts +26 -3
- package/dist/engine/index.d.ts.map +1 -1
- package/dist/engine/index.js +13 -1
- package/dist/engine/index.js.map +1 -1
- package/dist/engine/node/capabilities.d.ts +199 -4
- package/dist/engine/node/capabilities.d.ts.map +1 -1
- package/dist/engine/node/capabilities.js +292 -11
- package/dist/engine/node/capabilities.js.map +1 -1
- package/dist/engine/node/daemon-channels.d.ts +66 -0
- package/dist/engine/node/daemon-channels.d.ts.map +1 -0
- package/dist/engine/node/daemon-channels.js +65 -0
- package/dist/engine/node/daemon-channels.js.map +1 -0
- package/dist/engine/node/daemon.d.ts.map +1 -1
- package/dist/engine/node/daemon.js +52 -0
- package/dist/engine/node/daemon.js.map +1 -1
- package/dist/engine/node/doctor.d.ts +2 -0
- package/dist/engine/node/doctor.d.ts.map +1 -1
- package/dist/engine/node/doctor.js +56 -3
- package/dist/engine/node/doctor.js.map +1 -1
- package/dist/engine/node/executors/credential-hygiene.d.ts +1 -1
- package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -1
- package/dist/engine/node/executors/credential-hygiene.js +23 -2
- package/dist/engine/node/executors/credential-hygiene.js.map +1 -1
- package/dist/engine/node/executors/index.d.ts +52 -7
- package/dist/engine/node/executors/index.d.ts.map +1 -1
- package/dist/engine/node/executors/index.js +14 -0
- package/dist/engine/node/executors/index.js.map +1 -1
- package/dist/engine/node/executors/registry.d.ts.map +1 -1
- package/dist/engine/node/executors/registry.js +13 -2
- package/dist/engine/node/executors/registry.js.map +1 -1
- package/dist/engine/node/install-deps.d.ts +164 -6
- package/dist/engine/node/install-deps.d.ts.map +1 -1
- package/dist/engine/node/install-deps.js +251 -9
- package/dist/engine/node/install-deps.js.map +1 -1
- package/dist/engine/node/ipc-protocol.d.ts +49 -2
- package/dist/engine/node/ipc-protocol.d.ts.map +1 -1
- package/dist/engine/node/ipc-protocol.js +39 -0
- package/dist/engine/node/ipc-protocol.js.map +1 -1
- package/dist/engine/node/lifecycle.js +2 -1
- package/dist/engine/node/lifecycle.js.map +1 -1
- package/dist/engine/node/logger.d.ts +13 -0
- package/dist/engine/node/logger.d.ts.map +1 -1
- package/dist/engine/node/logger.js.map +1 -1
- package/dist/engine/node/memory-watchdog.d.ts +11 -0
- package/dist/engine/node/memory-watchdog.d.ts.map +1 -1
- package/dist/engine/node/memory-watchdog.js +28 -4
- package/dist/engine/node/memory-watchdog.js.map +1 -1
- package/dist/engine/node/models.d.ts +195 -0
- package/dist/engine/node/models.d.ts.map +1 -0
- package/dist/engine/node/models.js +379 -0
- package/dist/engine/node/models.js.map +1 -0
- package/dist/engine/node/node-dashboard-source.d.ts +46 -19
- package/dist/engine/node/node-dashboard-source.d.ts.map +1 -1
- package/dist/engine/node/node-dashboard-source.js +70 -102
- package/dist/engine/node/node-dashboard-source.js.map +1 -1
- package/dist/engine/node/node-engine.d.ts +20 -2
- package/dist/engine/node/node-engine.d.ts.map +1 -1
- package/dist/engine/node/node-engine.js +99 -11
- package/dist/engine/node/node-engine.js.map +1 -1
- package/dist/engine/node/runtime-state.d.ts +24 -0
- package/dist/engine/node/runtime-state.d.ts.map +1 -0
- package/dist/engine/node/runtime-state.js +19 -0
- package/dist/engine/node/runtime-state.js.map +1 -0
- package/dist/engine/node/runtime-tuning.d.ts +111 -2
- package/dist/engine/node/runtime-tuning.d.ts.map +1 -1
- package/dist/engine/node/runtime-tuning.js +133 -4
- package/dist/engine/node/runtime-tuning.js.map +1 -1
- package/dist/engine/node/service.d.ts.map +1 -1
- package/dist/engine/node/service.js +4 -0
- package/dist/engine/node/service.js.map +1 -1
- package/dist/engine/node/start.d.ts +7 -0
- package/dist/engine/node/start.d.ts.map +1 -1
- package/dist/engine/node/start.js +71 -3
- package/dist/engine/node/start.js.map +1 -1
- package/dist/engine/node/worker-env-aliases.d.ts +39 -0
- package/dist/engine/node/worker-env-aliases.d.ts.map +1 -0
- package/dist/engine/node/worker-env-aliases.js +126 -0
- package/dist/engine/node/worker-env-aliases.js.map +1 -0
- package/dist/engine/node/worker-env-table.d.ts.map +1 -1
- package/dist/engine/node/worker-env-table.js +4 -1
- package/dist/engine/node/worker-env-table.js.map +1 -1
- package/dist/engine/node/worker-env.d.ts +18 -1
- package/dist/engine/node/worker-env.d.ts.map +1 -1
- package/dist/engine/node/worker-env.js +13 -0
- package/dist/engine/node/worker-env.js.map +1 -1
- package/dist/engine/registries.d.ts.map +1 -1
- package/dist/engine/registries.js +7 -0
- package/dist/engine/registries.js.map +1 -1
- package/dist/engine/tui/app.d.ts.map +1 -1
- package/dist/engine/tui/app.js +15 -2
- package/dist/engine/tui/app.js.map +1 -1
- package/dist/engine/tui/builtin-screens.d.ts.map +1 -1
- package/dist/engine/tui/builtin-screens.js +6 -0
- package/dist/engine/tui/builtin-screens.js.map +1 -1
- package/dist/engine/tui/conformance.d.ts +143 -0
- package/dist/engine/tui/conformance.d.ts.map +1 -0
- package/dist/engine/tui/conformance.js +423 -0
- package/dist/engine/tui/conformance.js.map +1 -0
- package/dist/engine/tui/dashboard/index.d.ts +8 -0
- package/dist/engine/tui/dashboard/index.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/index.js +5 -0
- package/dist/engine/tui/dashboard/index.js.map +1 -0
- package/dist/engine/tui/dashboard/jobs-insights.d.ts +145 -0
- package/dist/engine/tui/dashboard/jobs-insights.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/jobs-insights.js +63 -0
- package/dist/engine/tui/dashboard/jobs-insights.js.map +1 -0
- package/dist/engine/tui/dashboard/node-embedded.d.ts +33 -0
- package/dist/engine/tui/dashboard/node-embedded.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/node-embedded.js +81 -0
- package/dist/engine/tui/dashboard/node-embedded.js.map +1 -0
- package/dist/engine/tui/dashboard/source.d.ts +274 -0
- package/dist/engine/tui/dashboard/source.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/source.js +351 -0
- package/dist/engine/tui/dashboard/source.js.map +1 -0
- package/dist/engine/tui/dashboard/use-dashboard.d.ts +23 -0
- package/dist/engine/tui/dashboard/use-dashboard.d.ts.map +1 -0
- package/dist/engine/tui/dashboard/use-dashboard.js +32 -0
- package/dist/engine/tui/dashboard/use-dashboard.js.map +1 -0
- package/dist/engine/tui/layout.d.ts +20 -0
- package/dist/engine/tui/layout.d.ts.map +1 -1
- package/dist/engine/tui/layout.js +7 -0
- package/dist/engine/tui/layout.js.map +1 -1
- package/dist/engine/tui/menu-registry.d.ts +124 -0
- package/dist/engine/tui/menu-registry.d.ts.map +1 -0
- package/dist/engine/tui/menu-registry.js +151 -0
- package/dist/engine/tui/menu-registry.js.map +1 -0
- package/dist/engine/tui/menu-tree.d.ts +179 -0
- package/dist/engine/tui/menu-tree.d.ts.map +1 -0
- package/dist/engine/tui/menu-tree.js +250 -0
- package/dist/engine/tui/menu-tree.js.map +1 -0
- package/dist/engine/tui/screen-registry.d.ts +1 -1
- package/dist/engine/tui/screen-registry.d.ts.map +1 -1
- package/dist/engine/tui/screen-registry.js +2 -1
- package/dist/engine/tui/screen-registry.js.map +1 -1
- package/dist/engine/tui/screens/jobs.d.ts +12 -0
- package/dist/engine/tui/screens/jobs.d.ts.map +1 -0
- package/dist/engine/tui/screens/jobs.js +72 -0
- package/dist/engine/tui/screens/jobs.js.map +1 -0
- package/dist/engine/tui/screens/menu.d.ts +4 -1
- package/dist/engine/tui/screens/menu.d.ts.map +1 -1
- package/dist/engine/tui/screens/menu.js +85 -22
- package/dist/engine/tui/screens/menu.js.map +1 -1
- package/dist/engine/tui/screens/node.d.ts.map +1 -1
- package/dist/engine/tui/screens/node.js +82 -37
- package/dist/engine/tui/screens/node.js.map +1 -1
- package/dist/engine/tui/screens/not-logged-in.d.ts +12 -0
- package/dist/engine/tui/screens/not-logged-in.d.ts.map +1 -0
- package/dist/engine/tui/screens/not-logged-in.js +14 -0
- package/dist/engine/tui/screens/not-logged-in.js.map +1 -0
- package/dist/engine/tui/scroll-box.d.ts +15 -0
- package/dist/engine/tui/scroll-box.d.ts.map +1 -1
- package/dist/engine/tui/scroll-box.js +10 -0
- package/dist/engine/tui/scroll-box.js.map +1 -1
- package/dist/engine/tui/testing/feeds.d.ts +58 -0
- package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
- package/dist/engine/tui/testing/feeds.js +67 -0
- package/dist/engine/tui/testing/feeds.js.map +1 -0
- package/dist/engine/tui/testing/harness.d.ts +241 -0
- package/dist/engine/tui/testing/harness.d.ts.map +1 -0
- package/dist/engine/tui/testing/harness.js +332 -0
- package/dist/engine/tui/testing/harness.js.map +1 -0
- package/dist/engine/tui/ui/active-items.d.ts +40 -0
- package/dist/engine/tui/ui/active-items.d.ts.map +1 -0
- package/dist/engine/tui/ui/active-items.js +38 -0
- package/dist/engine/tui/ui/active-items.js.map +1 -0
- package/dist/engine/tui/ui/event-log.d.ts +58 -0
- package/dist/engine/tui/ui/event-log.d.ts.map +1 -0
- package/dist/engine/tui/ui/event-log.js +32 -0
- package/dist/engine/tui/ui/event-log.js.map +1 -0
- package/dist/engine/tui/ui/index.d.ts +20 -0
- package/dist/engine/tui/ui/index.d.ts.map +1 -0
- package/dist/engine/tui/ui/index.js +14 -0
- package/dist/engine/tui/ui/index.js.map +1 -0
- package/dist/engine/tui/ui/meter-legend.d.ts +26 -0
- package/dist/engine/tui/ui/meter-legend.d.ts.map +1 -0
- package/dist/engine/tui/ui/meter-legend.js +25 -0
- package/dist/engine/tui/ui/meter-legend.js.map +1 -0
- package/dist/engine/tui/ui/run-summary.d.ts +58 -0
- package/dist/engine/tui/ui/run-summary.d.ts.map +1 -0
- package/dist/engine/tui/ui/run-summary.js +29 -0
- package/dist/engine/tui/ui/run-summary.js.map +1 -0
- package/dist/engine/tui/ui/segment-meter.d.ts +72 -0
- package/dist/engine/tui/ui/segment-meter.d.ts.map +1 -0
- package/dist/engine/tui/ui/segment-meter.js +128 -0
- package/dist/engine/tui/ui/segment-meter.js.map +1 -0
- package/dist/engine/tui/ui/status-line.d.ts +42 -0
- package/dist/engine/tui/ui/status-line.d.ts.map +1 -0
- package/dist/engine/tui/ui/status-line.js +35 -0
- package/dist/engine/tui/ui/status-line.js.map +1 -0
- package/dist/engine/tui/ui/tone.d.ts +46 -0
- package/dist/engine/tui/ui/tone.d.ts.map +1 -0
- package/dist/engine/tui/ui/tone.js +48 -0
- package/dist/engine/tui/ui/tone.js.map +1 -0
- package/dist/node/index.d.ts +2 -2
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/index.js +1 -1
- package/dist/node/index.js.map +1 -1
- package/dist/testing/index.d.ts +2 -2
- package/dist/testing/index.d.ts.map +1 -1
- package/dist/testing/index.js +1 -1
- package/dist/testing/index.js.map +1 -1
- package/dist/tui/index.d.ts +2 -2
- package/dist/tui/index.d.ts.map +1 -1
- package/dist/tui/index.js +1 -1
- package/dist/tui/index.js.map +1 -1
- package/dist/tui/testing/index.d.ts +5 -0
- package/dist/tui/testing/index.d.ts.map +1 -0
- package/dist/tui/testing/index.js +12 -0
- package/dist/tui/testing/index.js.map +1 -0
- package/dist/tui/ui/index.d.ts +2 -0
- package/dist/tui/ui/index.d.ts.map +1 -0
- package/dist/tui/ui/index.js +10 -0
- package/dist/tui/ui/index.js.map +1 -0
- package/package.json +16 -3
|
@@ -1,27 +1,58 @@
|
|
|
1
1
|
export type StepOutcome = 'skipped' | 'installed' | 'failed' | 'unsupported';
|
|
2
|
+
/**
|
|
3
|
+
* The operating system an install step runs on.
|
|
4
|
+
*
|
|
5
|
+
* @stability experimental
|
|
6
|
+
*/
|
|
2
7
|
export interface DistroInfo {
|
|
3
8
|
/** `ubuntu`, `debian`, `alpine`, `darwin`, `win32`, or `unknown`. */
|
|
4
9
|
id: string;
|
|
10
|
+
/** `VERSION_ID` from `/etc/os-release`, when known. */
|
|
5
11
|
versionId: string | undefined;
|
|
12
|
+
/** The package-manager family; `unknown` means a step reports `unsupported`. */
|
|
6
13
|
family: 'debian' | 'rhel' | 'alpine' | 'darwin' | 'windows' | 'unknown';
|
|
7
14
|
}
|
|
15
|
+
/**
|
|
16
|
+
* What an install step is handed.
|
|
17
|
+
*
|
|
18
|
+
* @stability experimental
|
|
19
|
+
*/
|
|
8
20
|
export interface InstallContext {
|
|
21
|
+
/** The detected operating system. */
|
|
9
22
|
distro: DistroInfo;
|
|
23
|
+
/** True under `--dry-run`: `install` must not mutate. */
|
|
10
24
|
dryRun: boolean;
|
|
25
|
+
/** The worker state directory. */
|
|
11
26
|
stateDir: string;
|
|
12
|
-
|
|
27
|
+
/** Runs a command to completion with inherited stdio; rejects on a non-zero exit. */
|
|
28
|
+
run: (command: string, args: string[]) => void | Promise<void>;
|
|
29
|
+
/**
|
|
30
|
+
* Runs a command quietly and resolves with its stdout; rejects on a non-zero
|
|
31
|
+
* exit or a missing binary. For asking a question (`dpkg -s`, `docker ps`),
|
|
32
|
+
* never for changing anything.
|
|
33
|
+
*/
|
|
34
|
+
capture: (command: string, args: string[]) => Promise<string>;
|
|
35
|
+
/** Writes a line to the install output. */
|
|
13
36
|
log: (message: string) => void;
|
|
14
37
|
}
|
|
38
|
+
/**
|
|
39
|
+
* One thing `node install-deps` can check and install.
|
|
40
|
+
*
|
|
41
|
+
* @stability experimental
|
|
42
|
+
*/
|
|
15
43
|
export interface InstallStep {
|
|
44
|
+
/** A stable id, the value `--only` takes. */
|
|
16
45
|
id: string;
|
|
46
|
+
/** Shown in the report. */
|
|
17
47
|
label: string;
|
|
18
48
|
/** Escalation is declared up front so the plan can announce it. */
|
|
19
49
|
requiresSudo?: boolean | undefined;
|
|
20
50
|
/** Can this step run at all here? Returning false yields `unsupported`. */
|
|
21
|
-
supported(context: InstallContext): boolean
|
|
51
|
+
supported(context: InstallContext): boolean | Promise<boolean>;
|
|
22
52
|
/** Already satisfied? Returning true yields `skipped`. */
|
|
23
|
-
detect(context: InstallContext): boolean
|
|
24
|
-
install
|
|
53
|
+
detect(context: InstallContext): boolean | Promise<boolean>;
|
|
54
|
+
/** Do the install. May be async: a download or a container health poll is. */
|
|
55
|
+
install(context: InstallContext): void | Promise<void>;
|
|
25
56
|
}
|
|
26
57
|
export interface StepResult {
|
|
27
58
|
id: string;
|
|
@@ -35,6 +66,10 @@ export interface StepResult {
|
|
|
35
66
|
* Best effort by construction: a distro nobody anticipated yields `unknown`,
|
|
36
67
|
* and every step that cares reports `unsupported` rather than guessing a
|
|
37
68
|
* package manager and running it.
|
|
69
|
+
*
|
|
70
|
+
* @param options - test seams: the platform and the `os-release` text.
|
|
71
|
+
* @returns the distro id, version and package-manager family.
|
|
72
|
+
* @stability experimental
|
|
38
73
|
*/
|
|
39
74
|
export declare function detectDistro(options?: {
|
|
40
75
|
platform?: NodeJS.Platform | undefined;
|
|
@@ -49,10 +84,15 @@ export declare function detectDistro(options?: {
|
|
|
49
84
|
export declare const DEFAULT_INSTALL_STEPS: InstallStep[];
|
|
50
85
|
export interface InstallDepsOptions {
|
|
51
86
|
stateDir: string;
|
|
87
|
+
/** Replaces the default-plus-registered steps entirely. Tests, mostly. */
|
|
52
88
|
steps?: InstallStep[] | undefined;
|
|
89
|
+
/** Run only these step ids (the `--only` flag). An unknown id is an error. */
|
|
90
|
+
only?: readonly string[] | undefined;
|
|
91
|
+
/** Test seam for {@link InstallContext.capture}. */
|
|
92
|
+
capture?: ((command: string, args: string[]) => Promise<string>) | undefined;
|
|
53
93
|
dryRun?: boolean | undefined;
|
|
54
94
|
distro?: DistroInfo | undefined;
|
|
55
|
-
run?: ((command: string, args: string[]) => void) | undefined;
|
|
95
|
+
run?: ((command: string, args: string[]) => void | Promise<void>) | undefined;
|
|
56
96
|
log?: ((message: string) => void) | undefined;
|
|
57
97
|
}
|
|
58
98
|
export interface InstallDepsReport {
|
|
@@ -68,6 +108,124 @@ export interface InstallDepsReport {
|
|
|
68
108
|
* `--dry-run` PERFORMS NO MUTATION: `detect` still runs (it is read-only and
|
|
69
109
|
* is what makes the plan accurate), `install` does not.
|
|
70
110
|
*/
|
|
71
|
-
export declare function runInstallDeps(options: InstallDepsOptions): InstallDepsReport
|
|
111
|
+
export declare function runInstallDeps(options: InstallDepsOptions): Promise<InstallDepsReport>;
|
|
72
112
|
export declare function formatInstallReport(report: InstallDepsReport): string;
|
|
113
|
+
/**
|
|
114
|
+
* An install step as an app registers it.
|
|
115
|
+
*
|
|
116
|
+
* @stability experimental
|
|
117
|
+
*/
|
|
118
|
+
export type RegisteredInstallStep = InstallStep & {
|
|
119
|
+
/**
|
|
120
|
+
* Sort key among the registered steps (ascending, default 0). The built-in
|
|
121
|
+
* steps always run first. Equal keys keep registration order.
|
|
122
|
+
*/
|
|
123
|
+
order?: number | undefined;
|
|
124
|
+
/**
|
|
125
|
+
* Run immediately after the step with this id (a built-in or another
|
|
126
|
+
* registered step) instead of by `order`. Several steps after the same id
|
|
127
|
+
* keep registration order.
|
|
128
|
+
*/
|
|
129
|
+
after?: string | undefined;
|
|
130
|
+
};
|
|
131
|
+
/**
|
|
132
|
+
* Declares a step `node install-deps` runs after the built-in ones. Call it at
|
|
133
|
+
* module scope, before the node command runs (the module that holds your
|
|
134
|
+
* `createCli({ nodeExecutors })` is the natural place).
|
|
135
|
+
*
|
|
136
|
+
* A step is idempotent by contract: `detect` says whether it is already
|
|
137
|
+
* satisfied (then the outcome is `skipped`), `install` does the work, and
|
|
138
|
+
* `--dry-run` runs `detect` only. A step needing `sudo` sets `requiresSudo` so
|
|
139
|
+
* the plan announces it, and runs its commands through
|
|
140
|
+
* {@link runWithSudoAnnounced}.
|
|
141
|
+
*
|
|
142
|
+
* @param step - the step, with an optional `order` or `after` placement.
|
|
143
|
+
* @throws Error when the id is malformed or already taken (by a built-in or an earlier registration).
|
|
144
|
+
*
|
|
145
|
+
* @example
|
|
146
|
+
* ```ts
|
|
147
|
+
* registerInstallStep({
|
|
148
|
+
* id: 'transcoder',
|
|
149
|
+
* label: 'Media transcoder',
|
|
150
|
+
* requiresSudo: true,
|
|
151
|
+
* supported: (ctx) => ctx.distro.family === 'debian',
|
|
152
|
+
* detect: (ctx) => ctx.capture('ffmpeg', ['-version']).then(() => true, () => false),
|
|
153
|
+
* install: (ctx) => ensureAptPackages(['ffmpeg'], ctx),
|
|
154
|
+
* });
|
|
155
|
+
* ```
|
|
156
|
+
*
|
|
157
|
+
* @extensionPoint registry
|
|
158
|
+
* @stability experimental
|
|
159
|
+
*/
|
|
160
|
+
export declare function registerInstallStep(step: RegisteredInstallStep): void;
|
|
161
|
+
/**
|
|
162
|
+
* The steps `node install-deps` runs: the built-ins, then the registered steps.
|
|
163
|
+
* Throws when a step names an `after` id that does not exist, or the `after`
|
|
164
|
+
* links form a cycle.
|
|
165
|
+
*
|
|
166
|
+
* @returns the steps in execution order.
|
|
167
|
+
* @stability experimental
|
|
168
|
+
*/
|
|
169
|
+
export declare function listInstallSteps(): InstallStep[];
|
|
170
|
+
/** Removes one registered step. Tests only. @internal */
|
|
171
|
+
export declare function removeInstallStepForTests(id: string): void;
|
|
172
|
+
/** Removes every registered step. Tests only (`resetCliRegistriesForTests` calls it). @internal */
|
|
173
|
+
export declare function resetInstallStepRegistryForTests(): void;
|
|
174
|
+
/**
|
|
175
|
+
* Runs one privileged command: announced first, never run in `--dry-run`, and
|
|
176
|
+
* run without `sudo` when the process is already root.
|
|
177
|
+
*
|
|
178
|
+
* @param command - the executable to elevate (`apt-get`).
|
|
179
|
+
* @param args - its arguments.
|
|
180
|
+
* @param context - the step's context.
|
|
181
|
+
* @stability experimental
|
|
182
|
+
*/
|
|
183
|
+
export declare function runWithSudoAnnounced(command: string, args: string[], context: InstallContext): Promise<void>;
|
|
184
|
+
/**
|
|
185
|
+
* Installs the Debian-family packages that are not installed yet, with one
|
|
186
|
+
* announced `apt-get install -y`. Nothing runs when all are present, and
|
|
187
|
+
* nothing in `--dry-run`.
|
|
188
|
+
*
|
|
189
|
+
* @param names - package names (`['ffmpeg']`).
|
|
190
|
+
* @param context - the step's context.
|
|
191
|
+
* @returns the packages that were (or, in a dry run, would be) installed.
|
|
192
|
+
* @throws Error on a non-Debian distro or a malformed package name.
|
|
193
|
+
* @stability experimental
|
|
194
|
+
*/
|
|
195
|
+
export declare function ensureAptPackages(names: readonly string[], context: InstallContext): Promise<string[]>;
|
|
196
|
+
/**
|
|
197
|
+
* What {@link ensureDockerContainer} manages.
|
|
198
|
+
*
|
|
199
|
+
* @stability experimental
|
|
200
|
+
*/
|
|
201
|
+
export interface DockerContainerSpec {
|
|
202
|
+
/** Container name. */
|
|
203
|
+
name: string;
|
|
204
|
+
/** Image reference, supplied by the app. */
|
|
205
|
+
image: string;
|
|
206
|
+
/** Extra `docker run` arguments (ports, env, volumes), placed before the image. */
|
|
207
|
+
args?: readonly string[] | undefined;
|
|
208
|
+
/** Returns true once the container works (an HTTP probe, say). Polled after a start. */
|
|
209
|
+
verify?: ((context: InstallContext) => boolean | Promise<boolean>) | undefined;
|
|
210
|
+
/** Polls of `verify`. Default 20. */
|
|
211
|
+
verifyAttempts?: number | undefined;
|
|
212
|
+
/** Wait between polls. Default 2000 ms. */
|
|
213
|
+
verifyIntervalMs?: number | undefined;
|
|
214
|
+
/** Run docker through `sudo`. Default false. */
|
|
215
|
+
sudo?: boolean | undefined;
|
|
216
|
+
/** Test seam for the wait between polls. */
|
|
217
|
+
sleep?: ((ms: number) => Promise<void>) | undefined;
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* Makes a container exist, run and (when `verify` is given) answer: starts a
|
|
221
|
+
* stopped one, creates a missing one with `--restart unless-stopped`, and
|
|
222
|
+
* polls `verify` up to 20 times 2 s apart.
|
|
223
|
+
*
|
|
224
|
+
* @param spec - the container.
|
|
225
|
+
* @param context - the step's context.
|
|
226
|
+
* @returns what it did: `running` (already up), `started`, `created`, or `planned` (dry run).
|
|
227
|
+
* @throws Error when docker is missing, the name or image is malformed, or `verify` never passes.
|
|
228
|
+
* @stability experimental
|
|
229
|
+
*/
|
|
230
|
+
export declare function ensureDockerContainer(spec: DockerContainerSpec, context: InstallContext): Promise<'running' | 'started' | 'created' | 'planned'>;
|
|
73
231
|
//# sourceMappingURL=install-deps.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"install-deps.d.ts","sourceRoot":"","sources":["../../../src/engine/node/install-deps.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACzE;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/
|
|
1
|
+
{"version":3,"file":"install-deps.d.ts","sourceRoot":"","sources":["../../../src/engine/node/install-deps.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { execFile, spawn } from 'node:child_process';
|
|
2
2
|
import { mkdirSync, readFileSync } from 'node:fs';
|
|
3
3
|
import { cliName } from '../identity.js';
|
|
4
4
|
import { isWritable } from './capabilities.js';
|
|
@@ -8,6 +8,10 @@ import { isWritable } from './capabilities.js';
|
|
|
8
8
|
* Best effort by construction: a distro nobody anticipated yields `unknown`,
|
|
9
9
|
* and every step that cares reports `unsupported` rather than guessing a
|
|
10
10
|
* package manager and running it.
|
|
11
|
+
*
|
|
12
|
+
* @param options - test seams: the platform and the `os-release` text.
|
|
13
|
+
* @returns the distro id, version and package-manager family.
|
|
14
|
+
* @stability experimental
|
|
11
15
|
*/
|
|
12
16
|
export function detectDistro(options) {
|
|
13
17
|
const plat = options?.platform ?? process.platform;
|
|
@@ -82,8 +86,9 @@ export const DEFAULT_INSTALL_STEPS = [
|
|
|
82
86
|
* `--dry-run` PERFORMS NO MUTATION: `detect` still runs (it is read-only and
|
|
83
87
|
* is what makes the plan accurate), `install` does not.
|
|
84
88
|
*/
|
|
85
|
-
export function runInstallDeps(options) {
|
|
86
|
-
const
|
|
89
|
+
export async function runInstallDeps(options) {
|
|
90
|
+
const all = options.steps ?? listInstallSteps();
|
|
91
|
+
const steps = selectInstallSteps(all, options.only);
|
|
87
92
|
const dryRun = options.dryRun === true;
|
|
88
93
|
const log = options.log ?? (() => { });
|
|
89
94
|
const distro = options.distro ?? detectDistro();
|
|
@@ -92,9 +97,8 @@ export function runInstallDeps(options) {
|
|
|
92
97
|
dryRun,
|
|
93
98
|
stateDir: options.stateDir,
|
|
94
99
|
run: options.run ??
|
|
95
|
-
((command, args) =>
|
|
96
|
-
|
|
97
|
-
}),
|
|
100
|
+
((command, args) => runInherited(command, args)),
|
|
101
|
+
capture: options.capture ?? captureStdout,
|
|
98
102
|
log,
|
|
99
103
|
};
|
|
100
104
|
const escalating = steps.filter((step) => step.requiresSudo === true);
|
|
@@ -104,13 +108,21 @@ export function runInstallDeps(options) {
|
|
|
104
108
|
}
|
|
105
109
|
const results = [];
|
|
106
110
|
for (const step of steps) {
|
|
107
|
-
|
|
111
|
+
let supported;
|
|
112
|
+
try {
|
|
113
|
+
supported = await step.supported(context);
|
|
114
|
+
}
|
|
115
|
+
catch (error) {
|
|
116
|
+
results.push({ id: step.id, label: step.label, outcome: 'failed', detail: messageOf(error) });
|
|
117
|
+
continue;
|
|
118
|
+
}
|
|
119
|
+
if (!supported) {
|
|
108
120
|
results.push({ id: step.id, label: step.label, outcome: 'unsupported', detail: `Not supported on ${distro.id}` });
|
|
109
121
|
continue;
|
|
110
122
|
}
|
|
111
123
|
let satisfied;
|
|
112
124
|
try {
|
|
113
|
-
satisfied = step.detect(context);
|
|
125
|
+
satisfied = await step.detect(context);
|
|
114
126
|
}
|
|
115
127
|
catch (error) {
|
|
116
128
|
results.push({ id: step.id, label: step.label, outcome: 'failed', detail: messageOf(error) });
|
|
@@ -125,7 +137,7 @@ export function runInstallDeps(options) {
|
|
|
125
137
|
continue;
|
|
126
138
|
}
|
|
127
139
|
try {
|
|
128
|
-
step.install(context);
|
|
140
|
+
await step.install(context);
|
|
129
141
|
results.push({ id: step.id, label: step.label, outcome: 'installed' });
|
|
130
142
|
}
|
|
131
143
|
catch (error) {
|
|
@@ -144,7 +156,237 @@ export function formatInstallReport(report) {
|
|
|
144
156
|
}
|
|
145
157
|
return `${lines.join('\n')}\n`;
|
|
146
158
|
}
|
|
159
|
+
function captureStdout(command, args) {
|
|
160
|
+
return new Promise((resolve, reject) => {
|
|
161
|
+
execFile(command, args, { encoding: 'utf8', timeout: 30_000, maxBuffer: 1024 * 1024 }, (error, stdout) => {
|
|
162
|
+
if (error !== null)
|
|
163
|
+
reject(error);
|
|
164
|
+
else
|
|
165
|
+
resolve(stdout);
|
|
166
|
+
});
|
|
167
|
+
});
|
|
168
|
+
}
|
|
169
|
+
/** Runs a command with inherited stdio, rejecting on a spawn error or a non-zero exit. */
|
|
170
|
+
function runInherited(command, args) {
|
|
171
|
+
return new Promise((resolve, reject) => {
|
|
172
|
+
const child = spawn(command, args, { stdio: 'inherit' });
|
|
173
|
+
child.once('error', reject);
|
|
174
|
+
child.once('exit', (code, signal) => {
|
|
175
|
+
if (code === 0)
|
|
176
|
+
resolve();
|
|
177
|
+
else
|
|
178
|
+
reject(new Error(`${command} ${args.join(' ')} exited with ${code === null ? `signal ${String(signal)}` : `code ${code}`}`));
|
|
179
|
+
});
|
|
180
|
+
});
|
|
181
|
+
}
|
|
147
182
|
function messageOf(error) {
|
|
148
183
|
return error instanceof Error ? error.message : String(error);
|
|
149
184
|
}
|
|
185
|
+
const STEP_ID_PATTERN = /^[a-z][a-z0-9._-]{0,63}$/;
|
|
186
|
+
const registeredSteps = [];
|
|
187
|
+
/**
|
|
188
|
+
* Declares a step `node install-deps` runs after the built-in ones. Call it at
|
|
189
|
+
* module scope, before the node command runs (the module that holds your
|
|
190
|
+
* `createCli({ nodeExecutors })` is the natural place).
|
|
191
|
+
*
|
|
192
|
+
* A step is idempotent by contract: `detect` says whether it is already
|
|
193
|
+
* satisfied (then the outcome is `skipped`), `install` does the work, and
|
|
194
|
+
* `--dry-run` runs `detect` only. A step needing `sudo` sets `requiresSudo` so
|
|
195
|
+
* the plan announces it, and runs its commands through
|
|
196
|
+
* {@link runWithSudoAnnounced}.
|
|
197
|
+
*
|
|
198
|
+
* @param step - the step, with an optional `order` or `after` placement.
|
|
199
|
+
* @throws Error when the id is malformed or already taken (by a built-in or an earlier registration).
|
|
200
|
+
*
|
|
201
|
+
* @example
|
|
202
|
+
* ```ts
|
|
203
|
+
* registerInstallStep({
|
|
204
|
+
* id: 'transcoder',
|
|
205
|
+
* label: 'Media transcoder',
|
|
206
|
+
* requiresSudo: true,
|
|
207
|
+
* supported: (ctx) => ctx.distro.family === 'debian',
|
|
208
|
+
* detect: (ctx) => ctx.capture('ffmpeg', ['-version']).then(() => true, () => false),
|
|
209
|
+
* install: (ctx) => ensureAptPackages(['ffmpeg'], ctx),
|
|
210
|
+
* });
|
|
211
|
+
* ```
|
|
212
|
+
*
|
|
213
|
+
* @extensionPoint registry
|
|
214
|
+
* @stability experimental
|
|
215
|
+
*/
|
|
216
|
+
export function registerInstallStep(step) {
|
|
217
|
+
if (typeof step?.id !== 'string' || !STEP_ID_PATTERN.test(step.id)) {
|
|
218
|
+
throw new Error(`registerInstallStep: "${String(step?.id)}" is not a valid step id (${STEP_ID_PATTERN}).`);
|
|
219
|
+
}
|
|
220
|
+
if (typeof step.label !== 'string' || step.label.trim() === '')
|
|
221
|
+
throw new Error(`registerInstallStep("${step.id}"): a label is required.`);
|
|
222
|
+
for (const fn of ['supported', 'detect', 'install']) {
|
|
223
|
+
if (typeof step[fn] !== 'function')
|
|
224
|
+
throw new Error(`registerInstallStep("${step.id}"): "${fn}" must be a function.`);
|
|
225
|
+
}
|
|
226
|
+
if (step.order !== undefined && !Number.isFinite(step.order))
|
|
227
|
+
throw new Error(`registerInstallStep("${step.id}"): order must be a finite number.`);
|
|
228
|
+
if (DEFAULT_INSTALL_STEPS.some((existing) => existing.id === step.id) || registeredSteps.some((existing) => existing.id === step.id)) {
|
|
229
|
+
throw new Error(`registerInstallStep: a step with id "${step.id}" is already registered.`);
|
|
230
|
+
}
|
|
231
|
+
registeredSteps.push(step);
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* The steps `node install-deps` runs: the built-ins, then the registered steps.
|
|
235
|
+
* Throws when a step names an `after` id that does not exist, or the `after`
|
|
236
|
+
* links form a cycle.
|
|
237
|
+
*
|
|
238
|
+
* @returns the steps in execution order.
|
|
239
|
+
* @stability experimental
|
|
240
|
+
*/
|
|
241
|
+
export function listInstallSteps() {
|
|
242
|
+
const placed = [...DEFAULT_INSTALL_STEPS];
|
|
243
|
+
const byOrder = registeredSteps
|
|
244
|
+
.filter((step) => step.after === undefined)
|
|
245
|
+
.map((step, index) => ({ step, index }))
|
|
246
|
+
.sort((a, b) => (a.step.order ?? 0) - (b.step.order ?? 0) || a.index - b.index)
|
|
247
|
+
.map((entry) => entry.step);
|
|
248
|
+
placed.push(...byOrder);
|
|
249
|
+
let pending = registeredSteps.filter((step) => step.after !== undefined);
|
|
250
|
+
while (pending.length > 0) {
|
|
251
|
+
const next = [];
|
|
252
|
+
for (const step of pending) {
|
|
253
|
+
let at = placed.findIndex((candidate) => candidate.id === step.after);
|
|
254
|
+
if (at === -1) {
|
|
255
|
+
next.push(step);
|
|
256
|
+
continue;
|
|
257
|
+
}
|
|
258
|
+
// Keep several steps that follow the same id in registration order.
|
|
259
|
+
while (placed[at + 1] !== undefined && registeredSteps.some((other) => other.after === step.after && other.id === placed[at + 1]?.id))
|
|
260
|
+
at += 1;
|
|
261
|
+
placed.splice(at + 1, 0, step);
|
|
262
|
+
}
|
|
263
|
+
if (next.length === pending.length) {
|
|
264
|
+
const stuck = next.map((step) => `${step.id} (after ${String(step.after)})`).join(', ');
|
|
265
|
+
throw new Error(`Install steps cannot be ordered: ${stuck}. Each "after" must name an existing step, without a cycle.`);
|
|
266
|
+
}
|
|
267
|
+
pending = next;
|
|
268
|
+
}
|
|
269
|
+
return placed;
|
|
270
|
+
}
|
|
271
|
+
function selectInstallSteps(steps, only) {
|
|
272
|
+
if (only === undefined || only.length === 0)
|
|
273
|
+
return steps;
|
|
274
|
+
const known = new Set(steps.map((step) => step.id));
|
|
275
|
+
const unknown = only.filter((id) => !known.has(id));
|
|
276
|
+
if (unknown.length > 0) {
|
|
277
|
+
throw new Error(`Unknown install step${unknown.length > 1 ? 's' : ''}: ${unknown.join(', ')}. Known steps: ${[...known].join(', ')}.`);
|
|
278
|
+
}
|
|
279
|
+
const wanted = new Set(only);
|
|
280
|
+
return steps.filter((step) => wanted.has(step.id));
|
|
281
|
+
}
|
|
282
|
+
/** Removes one registered step. Tests only. @internal */
|
|
283
|
+
export function removeInstallStepForTests(id) {
|
|
284
|
+
const at = registeredSteps.findIndex((step) => step.id === id);
|
|
285
|
+
if (at !== -1)
|
|
286
|
+
registeredSteps.splice(at, 1);
|
|
287
|
+
}
|
|
288
|
+
/** Removes every registered step. Tests only (`resetCliRegistriesForTests` calls it). @internal */
|
|
289
|
+
export function resetInstallStepRegistryForTests() {
|
|
290
|
+
registeredSteps.length = 0;
|
|
291
|
+
}
|
|
292
|
+
/**
|
|
293
|
+
* Runs one privileged command: announced first, never run in `--dry-run`, and
|
|
294
|
+
* run without `sudo` when the process is already root.
|
|
295
|
+
*
|
|
296
|
+
* @param command - the executable to elevate (`apt-get`).
|
|
297
|
+
* @param args - its arguments.
|
|
298
|
+
* @param context - the step's context.
|
|
299
|
+
* @stability experimental
|
|
300
|
+
*/
|
|
301
|
+
export async function runWithSudoAnnounced(command, args, context) {
|
|
302
|
+
const isRoot = typeof process.getuid === 'function' && process.getuid() === 0;
|
|
303
|
+
const line = `${isRoot ? '' : 'sudo '}${command} ${args.join(' ')}`.trim();
|
|
304
|
+
if (context.dryRun) {
|
|
305
|
+
context.log(`Would run: ${line}`);
|
|
306
|
+
return;
|
|
307
|
+
}
|
|
308
|
+
context.log(`Running: ${line}`);
|
|
309
|
+
await (isRoot ? context.run(command, args) : context.run('sudo', [command, ...args]));
|
|
310
|
+
}
|
|
311
|
+
const APT_PACKAGE_PATTERN = /^[a-z0-9][a-z0-9+.-]{0,99}$/;
|
|
312
|
+
/**
|
|
313
|
+
* Installs the Debian-family packages that are not installed yet, with one
|
|
314
|
+
* announced `apt-get install -y`. Nothing runs when all are present, and
|
|
315
|
+
* nothing in `--dry-run`.
|
|
316
|
+
*
|
|
317
|
+
* @param names - package names (`['ffmpeg']`).
|
|
318
|
+
* @param context - the step's context.
|
|
319
|
+
* @returns the packages that were (or, in a dry run, would be) installed.
|
|
320
|
+
* @throws Error on a non-Debian distro or a malformed package name.
|
|
321
|
+
* @stability experimental
|
|
322
|
+
*/
|
|
323
|
+
export async function ensureAptPackages(names, context) {
|
|
324
|
+
if (context.distro.family !== 'debian') {
|
|
325
|
+
throw new Error(`apt packages (${names.join(', ')}) can only be installed on a Debian-family system; this is ${context.distro.id}.`);
|
|
326
|
+
}
|
|
327
|
+
for (const name of names) {
|
|
328
|
+
if (!APT_PACKAGE_PATTERN.test(name))
|
|
329
|
+
throw new Error(`"${name}" is not a valid apt package name.`);
|
|
330
|
+
}
|
|
331
|
+
const missing = [];
|
|
332
|
+
for (const name of names) {
|
|
333
|
+
const installed = await context.capture('dpkg', ['-s', name]).then((out) => /^Status:.*\binstall ok installed\b/m.test(out), () => false);
|
|
334
|
+
if (!installed)
|
|
335
|
+
missing.push(name);
|
|
336
|
+
}
|
|
337
|
+
if (missing.length === 0)
|
|
338
|
+
return [];
|
|
339
|
+
await runWithSudoAnnounced('apt-get', ['install', '-y', ...missing], context);
|
|
340
|
+
return missing;
|
|
341
|
+
}
|
|
342
|
+
const DOCKER_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/;
|
|
343
|
+
/**
|
|
344
|
+
* Makes a container exist, run and (when `verify` is given) answer: starts a
|
|
345
|
+
* stopped one, creates a missing one with `--restart unless-stopped`, and
|
|
346
|
+
* polls `verify` up to 20 times 2 s apart.
|
|
347
|
+
*
|
|
348
|
+
* @param spec - the container.
|
|
349
|
+
* @param context - the step's context.
|
|
350
|
+
* @returns what it did: `running` (already up), `started`, `created`, or `planned` (dry run).
|
|
351
|
+
* @throws Error when docker is missing, the name or image is malformed, or `verify` never passes.
|
|
352
|
+
* @stability experimental
|
|
353
|
+
*/
|
|
354
|
+
export async function ensureDockerContainer(spec, context) {
|
|
355
|
+
if (!DOCKER_NAME_PATTERN.test(spec.name))
|
|
356
|
+
throw new Error(`"${spec.name}" is not a valid container name.`);
|
|
357
|
+
if (spec.image.trim() === '' || spec.image.startsWith('-'))
|
|
358
|
+
throw new Error(`"${spec.image}" is not a valid image reference.`);
|
|
359
|
+
await context.capture('docker', ['--version']).catch(() => {
|
|
360
|
+
throw new Error('Docker is not installed or not on PATH.');
|
|
361
|
+
});
|
|
362
|
+
const state = (await context.capture('docker', ['inspect', '-f', '{{.State.Running}}', spec.name]).catch(() => 'absent')).trim();
|
|
363
|
+
const docker = (args) => (spec.sudo === true ? runWithSudoAnnounced('docker', args, context) : Promise.resolve(context.run('docker', args)));
|
|
364
|
+
let outcome = 'running';
|
|
365
|
+
if (state !== 'true') {
|
|
366
|
+
if (context.dryRun) {
|
|
367
|
+
context.log(`Would ${state === 'false' ? 'start' : 'create'} container ${spec.name} (dry run)`);
|
|
368
|
+
return 'planned';
|
|
369
|
+
}
|
|
370
|
+
if (state === 'false') {
|
|
371
|
+
await docker(['start', spec.name]);
|
|
372
|
+
outcome = 'started';
|
|
373
|
+
}
|
|
374
|
+
else {
|
|
375
|
+
await docker(['run', '-d', '--name', spec.name, '--restart', 'unless-stopped', ...(spec.args ?? []), spec.image]);
|
|
376
|
+
outcome = 'created';
|
|
377
|
+
}
|
|
378
|
+
}
|
|
379
|
+
if (spec.verify !== undefined) {
|
|
380
|
+
const attempts = spec.verifyAttempts ?? 20;
|
|
381
|
+
const sleep = spec.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
|
|
382
|
+
for (let attempt = 1; attempt <= attempts; attempt += 1) {
|
|
383
|
+
if (await Promise.resolve(spec.verify(context)).catch(() => false))
|
|
384
|
+
return outcome;
|
|
385
|
+
if (attempt < attempts)
|
|
386
|
+
await sleep(spec.verifyIntervalMs ?? 2000);
|
|
387
|
+
}
|
|
388
|
+
throw new Error(`Container ${spec.name} did not become healthy after ${attempts} checks.`);
|
|
389
|
+
}
|
|
390
|
+
return outcome;
|
|
391
|
+
}
|
|
150
392
|
//# sourceMappingURL=install-deps.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"install-deps.js","sourceRoot":"","sources":["../../../src/engine/node/install-deps.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"install-deps.js","sourceRoot":"","sources":["../../../src/engine/node/install-deps.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,16 +1,48 @@
|
|
|
1
1
|
import type { NodeEngineEvent, NodeSnapshot } from './node-events.js';
|
|
2
2
|
import type { LogRecord } from './logger.js';
|
|
3
|
-
/**
|
|
4
|
-
export
|
|
3
|
+
/** The channel of the built-in worker engine. A frame with no `channel` is on it. */
|
|
4
|
+
export declare const NODE_CHANNEL = "node";
|
|
5
|
+
/**
|
|
6
|
+
* Server → client, for the built-in worker engine (the `node` channel).
|
|
7
|
+
*
|
|
8
|
+
* `channel` is optional and, when present, is `node`: an absent field IS the
|
|
9
|
+
* node channel, so a daemon that predates channels and a client that predates
|
|
10
|
+
* them keep interoperating, and a new daemon never writes the field for its
|
|
11
|
+
* own engine.
|
|
12
|
+
*/
|
|
13
|
+
export type NodeChannelMessage = {
|
|
5
14
|
type: 'snapshot';
|
|
6
15
|
snapshot: NodeSnapshot;
|
|
16
|
+
channel?: typeof NODE_CHANNEL;
|
|
7
17
|
} | {
|
|
8
18
|
type: 'log-tail';
|
|
9
19
|
lines: LogRecord[];
|
|
20
|
+
channel?: typeof NODE_CHANNEL;
|
|
10
21
|
} | {
|
|
11
22
|
type: 'event';
|
|
12
23
|
event: NodeEngineEvent;
|
|
24
|
+
channel?: typeof NODE_CHANNEL;
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* Server → client, for a second engine an app published with
|
|
28
|
+
* `registerDaemonChannel`. The payloads are the app's own, so they are
|
|
29
|
+
* `unknown` here and validated by the dashboard reducer that reads them.
|
|
30
|
+
*/
|
|
31
|
+
export type AppChannelMessage = {
|
|
32
|
+
type: 'snapshot';
|
|
33
|
+
snapshot: unknown;
|
|
34
|
+
channel: string;
|
|
35
|
+
} | {
|
|
36
|
+
type: 'log-tail';
|
|
37
|
+
lines: LogRecord[];
|
|
38
|
+
channel: string;
|
|
13
39
|
} | {
|
|
40
|
+
type: 'event';
|
|
41
|
+
event: unknown;
|
|
42
|
+
channel: string;
|
|
43
|
+
};
|
|
44
|
+
/** Server → client. */
|
|
45
|
+
export type DaemonMessage = NodeChannelMessage | AppChannelMessage | {
|
|
14
46
|
type: 'ack';
|
|
15
47
|
command: string;
|
|
16
48
|
detail?: unknown;
|
|
@@ -18,6 +50,21 @@ export type DaemonMessage = {
|
|
|
18
50
|
type: 'error';
|
|
19
51
|
message: string;
|
|
20
52
|
};
|
|
53
|
+
/**
|
|
54
|
+
* The channel a frame belongs to: its `channel` field, else `node`.
|
|
55
|
+
*
|
|
56
|
+
* `ack` and `error` frames answer a command and belong to no channel; they
|
|
57
|
+
* read as `node`, which is where they always went.
|
|
58
|
+
*/
|
|
59
|
+
export declare function messageChannel(message: {
|
|
60
|
+
channel?: string | undefined;
|
|
61
|
+
}): string;
|
|
62
|
+
/** Narrows to the worker engine's snapshot frame: type `snapshot` on the `node` channel. */
|
|
63
|
+
export declare function isNodeSnapshotMessage(message: DaemonMessage): message is Extract<NodeChannelMessage, {
|
|
64
|
+
type: 'snapshot';
|
|
65
|
+
}>;
|
|
66
|
+
/** A channel id an app may register: lowercase, digits, hyphens; `node` is the built-in's. */
|
|
67
|
+
export declare const CHANNEL_ID_PATTERN: RegExp;
|
|
21
68
|
/** Client → server. */
|
|
22
69
|
export type ClientCommand = {
|
|
23
70
|
type: 'status';
|