@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.
Files changed (227) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +4 -3
  3. package/dist/engine/commands/node.d.ts.map +1 -1
  4. package/dist/engine/commands/node.js +73 -6
  5. package/dist/engine/commands/node.js.map +1 -1
  6. package/dist/engine/conformance.d.ts +3 -0
  7. package/dist/engine/conformance.d.ts.map +1 -1
  8. package/dist/engine/conformance.js +7 -0
  9. package/dist/engine/conformance.js.map +1 -1
  10. package/dist/engine/create-cli.d.ts +21 -0
  11. package/dist/engine/create-cli.d.ts.map +1 -1
  12. package/dist/engine/create-cli.js +11 -0
  13. package/dist/engine/create-cli.js.map +1 -1
  14. package/dist/engine/index.d.ts +26 -3
  15. package/dist/engine/index.d.ts.map +1 -1
  16. package/dist/engine/index.js +13 -1
  17. package/dist/engine/index.js.map +1 -1
  18. package/dist/engine/node/capabilities.d.ts +199 -4
  19. package/dist/engine/node/capabilities.d.ts.map +1 -1
  20. package/dist/engine/node/capabilities.js +292 -11
  21. package/dist/engine/node/capabilities.js.map +1 -1
  22. package/dist/engine/node/daemon-channels.d.ts +66 -0
  23. package/dist/engine/node/daemon-channels.d.ts.map +1 -0
  24. package/dist/engine/node/daemon-channels.js +65 -0
  25. package/dist/engine/node/daemon-channels.js.map +1 -0
  26. package/dist/engine/node/daemon.d.ts.map +1 -1
  27. package/dist/engine/node/daemon.js +52 -0
  28. package/dist/engine/node/daemon.js.map +1 -1
  29. package/dist/engine/node/doctor.d.ts +2 -0
  30. package/dist/engine/node/doctor.d.ts.map +1 -1
  31. package/dist/engine/node/doctor.js +56 -3
  32. package/dist/engine/node/doctor.js.map +1 -1
  33. package/dist/engine/node/executors/credential-hygiene.d.ts +1 -1
  34. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -1
  35. package/dist/engine/node/executors/credential-hygiene.js +23 -2
  36. package/dist/engine/node/executors/credential-hygiene.js.map +1 -1
  37. package/dist/engine/node/executors/index.d.ts +52 -7
  38. package/dist/engine/node/executors/index.d.ts.map +1 -1
  39. package/dist/engine/node/executors/index.js +14 -0
  40. package/dist/engine/node/executors/index.js.map +1 -1
  41. package/dist/engine/node/executors/registry.d.ts.map +1 -1
  42. package/dist/engine/node/executors/registry.js +13 -2
  43. package/dist/engine/node/executors/registry.js.map +1 -1
  44. package/dist/engine/node/install-deps.d.ts +164 -6
  45. package/dist/engine/node/install-deps.d.ts.map +1 -1
  46. package/dist/engine/node/install-deps.js +251 -9
  47. package/dist/engine/node/install-deps.js.map +1 -1
  48. package/dist/engine/node/ipc-protocol.d.ts +49 -2
  49. package/dist/engine/node/ipc-protocol.d.ts.map +1 -1
  50. package/dist/engine/node/ipc-protocol.js +39 -0
  51. package/dist/engine/node/ipc-protocol.js.map +1 -1
  52. package/dist/engine/node/lifecycle.js +2 -1
  53. package/dist/engine/node/lifecycle.js.map +1 -1
  54. package/dist/engine/node/logger.d.ts +13 -0
  55. package/dist/engine/node/logger.d.ts.map +1 -1
  56. package/dist/engine/node/logger.js.map +1 -1
  57. package/dist/engine/node/memory-watchdog.d.ts +11 -0
  58. package/dist/engine/node/memory-watchdog.d.ts.map +1 -1
  59. package/dist/engine/node/memory-watchdog.js +28 -4
  60. package/dist/engine/node/memory-watchdog.js.map +1 -1
  61. package/dist/engine/node/models.d.ts +195 -0
  62. package/dist/engine/node/models.d.ts.map +1 -0
  63. package/dist/engine/node/models.js +379 -0
  64. package/dist/engine/node/models.js.map +1 -0
  65. package/dist/engine/node/node-dashboard-source.d.ts +46 -19
  66. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -1
  67. package/dist/engine/node/node-dashboard-source.js +70 -102
  68. package/dist/engine/node/node-dashboard-source.js.map +1 -1
  69. package/dist/engine/node/node-engine.d.ts +20 -2
  70. package/dist/engine/node/node-engine.d.ts.map +1 -1
  71. package/dist/engine/node/node-engine.js +99 -11
  72. package/dist/engine/node/node-engine.js.map +1 -1
  73. package/dist/engine/node/runtime-state.d.ts +24 -0
  74. package/dist/engine/node/runtime-state.d.ts.map +1 -0
  75. package/dist/engine/node/runtime-state.js +19 -0
  76. package/dist/engine/node/runtime-state.js.map +1 -0
  77. package/dist/engine/node/runtime-tuning.d.ts +111 -2
  78. package/dist/engine/node/runtime-tuning.d.ts.map +1 -1
  79. package/dist/engine/node/runtime-tuning.js +133 -4
  80. package/dist/engine/node/runtime-tuning.js.map +1 -1
  81. package/dist/engine/node/service.d.ts.map +1 -1
  82. package/dist/engine/node/service.js +4 -0
  83. package/dist/engine/node/service.js.map +1 -1
  84. package/dist/engine/node/start.d.ts +7 -0
  85. package/dist/engine/node/start.d.ts.map +1 -1
  86. package/dist/engine/node/start.js +71 -3
  87. package/dist/engine/node/start.js.map +1 -1
  88. package/dist/engine/node/worker-env-aliases.d.ts +39 -0
  89. package/dist/engine/node/worker-env-aliases.d.ts.map +1 -0
  90. package/dist/engine/node/worker-env-aliases.js +126 -0
  91. package/dist/engine/node/worker-env-aliases.js.map +1 -0
  92. package/dist/engine/node/worker-env-table.d.ts.map +1 -1
  93. package/dist/engine/node/worker-env-table.js +4 -1
  94. package/dist/engine/node/worker-env-table.js.map +1 -1
  95. package/dist/engine/node/worker-env.d.ts +18 -1
  96. package/dist/engine/node/worker-env.d.ts.map +1 -1
  97. package/dist/engine/node/worker-env.js +13 -0
  98. package/dist/engine/node/worker-env.js.map +1 -1
  99. package/dist/engine/registries.d.ts.map +1 -1
  100. package/dist/engine/registries.js +7 -0
  101. package/dist/engine/registries.js.map +1 -1
  102. package/dist/engine/tui/app.d.ts.map +1 -1
  103. package/dist/engine/tui/app.js +15 -2
  104. package/dist/engine/tui/app.js.map +1 -1
  105. package/dist/engine/tui/builtin-screens.d.ts.map +1 -1
  106. package/dist/engine/tui/builtin-screens.js +6 -0
  107. package/dist/engine/tui/builtin-screens.js.map +1 -1
  108. package/dist/engine/tui/conformance.d.ts +143 -0
  109. package/dist/engine/tui/conformance.d.ts.map +1 -0
  110. package/dist/engine/tui/conformance.js +423 -0
  111. package/dist/engine/tui/conformance.js.map +1 -0
  112. package/dist/engine/tui/dashboard/index.d.ts +8 -0
  113. package/dist/engine/tui/dashboard/index.d.ts.map +1 -0
  114. package/dist/engine/tui/dashboard/index.js +5 -0
  115. package/dist/engine/tui/dashboard/index.js.map +1 -0
  116. package/dist/engine/tui/dashboard/jobs-insights.d.ts +145 -0
  117. package/dist/engine/tui/dashboard/jobs-insights.d.ts.map +1 -0
  118. package/dist/engine/tui/dashboard/jobs-insights.js +63 -0
  119. package/dist/engine/tui/dashboard/jobs-insights.js.map +1 -0
  120. package/dist/engine/tui/dashboard/node-embedded.d.ts +33 -0
  121. package/dist/engine/tui/dashboard/node-embedded.d.ts.map +1 -0
  122. package/dist/engine/tui/dashboard/node-embedded.js +81 -0
  123. package/dist/engine/tui/dashboard/node-embedded.js.map +1 -0
  124. package/dist/engine/tui/dashboard/source.d.ts +274 -0
  125. package/dist/engine/tui/dashboard/source.d.ts.map +1 -0
  126. package/dist/engine/tui/dashboard/source.js +351 -0
  127. package/dist/engine/tui/dashboard/source.js.map +1 -0
  128. package/dist/engine/tui/dashboard/use-dashboard.d.ts +23 -0
  129. package/dist/engine/tui/dashboard/use-dashboard.d.ts.map +1 -0
  130. package/dist/engine/tui/dashboard/use-dashboard.js +32 -0
  131. package/dist/engine/tui/dashboard/use-dashboard.js.map +1 -0
  132. package/dist/engine/tui/layout.d.ts +20 -0
  133. package/dist/engine/tui/layout.d.ts.map +1 -1
  134. package/dist/engine/tui/layout.js +7 -0
  135. package/dist/engine/tui/layout.js.map +1 -1
  136. package/dist/engine/tui/menu-registry.d.ts +124 -0
  137. package/dist/engine/tui/menu-registry.d.ts.map +1 -0
  138. package/dist/engine/tui/menu-registry.js +151 -0
  139. package/dist/engine/tui/menu-registry.js.map +1 -0
  140. package/dist/engine/tui/menu-tree.d.ts +179 -0
  141. package/dist/engine/tui/menu-tree.d.ts.map +1 -0
  142. package/dist/engine/tui/menu-tree.js +250 -0
  143. package/dist/engine/tui/menu-tree.js.map +1 -0
  144. package/dist/engine/tui/screen-registry.d.ts +1 -1
  145. package/dist/engine/tui/screen-registry.d.ts.map +1 -1
  146. package/dist/engine/tui/screen-registry.js +2 -1
  147. package/dist/engine/tui/screen-registry.js.map +1 -1
  148. package/dist/engine/tui/screens/jobs.d.ts +12 -0
  149. package/dist/engine/tui/screens/jobs.d.ts.map +1 -0
  150. package/dist/engine/tui/screens/jobs.js +72 -0
  151. package/dist/engine/tui/screens/jobs.js.map +1 -0
  152. package/dist/engine/tui/screens/menu.d.ts +4 -1
  153. package/dist/engine/tui/screens/menu.d.ts.map +1 -1
  154. package/dist/engine/tui/screens/menu.js +85 -22
  155. package/dist/engine/tui/screens/menu.js.map +1 -1
  156. package/dist/engine/tui/screens/node.d.ts.map +1 -1
  157. package/dist/engine/tui/screens/node.js +82 -37
  158. package/dist/engine/tui/screens/node.js.map +1 -1
  159. package/dist/engine/tui/screens/not-logged-in.d.ts +12 -0
  160. package/dist/engine/tui/screens/not-logged-in.d.ts.map +1 -0
  161. package/dist/engine/tui/screens/not-logged-in.js +14 -0
  162. package/dist/engine/tui/screens/not-logged-in.js.map +1 -0
  163. package/dist/engine/tui/scroll-box.d.ts +15 -0
  164. package/dist/engine/tui/scroll-box.d.ts.map +1 -1
  165. package/dist/engine/tui/scroll-box.js +10 -0
  166. package/dist/engine/tui/scroll-box.js.map +1 -1
  167. package/dist/engine/tui/testing/feeds.d.ts +58 -0
  168. package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
  169. package/dist/engine/tui/testing/feeds.js +67 -0
  170. package/dist/engine/tui/testing/feeds.js.map +1 -0
  171. package/dist/engine/tui/testing/harness.d.ts +241 -0
  172. package/dist/engine/tui/testing/harness.d.ts.map +1 -0
  173. package/dist/engine/tui/testing/harness.js +332 -0
  174. package/dist/engine/tui/testing/harness.js.map +1 -0
  175. package/dist/engine/tui/ui/active-items.d.ts +40 -0
  176. package/dist/engine/tui/ui/active-items.d.ts.map +1 -0
  177. package/dist/engine/tui/ui/active-items.js +38 -0
  178. package/dist/engine/tui/ui/active-items.js.map +1 -0
  179. package/dist/engine/tui/ui/event-log.d.ts +58 -0
  180. package/dist/engine/tui/ui/event-log.d.ts.map +1 -0
  181. package/dist/engine/tui/ui/event-log.js +32 -0
  182. package/dist/engine/tui/ui/event-log.js.map +1 -0
  183. package/dist/engine/tui/ui/index.d.ts +20 -0
  184. package/dist/engine/tui/ui/index.d.ts.map +1 -0
  185. package/dist/engine/tui/ui/index.js +14 -0
  186. package/dist/engine/tui/ui/index.js.map +1 -0
  187. package/dist/engine/tui/ui/meter-legend.d.ts +26 -0
  188. package/dist/engine/tui/ui/meter-legend.d.ts.map +1 -0
  189. package/dist/engine/tui/ui/meter-legend.js +25 -0
  190. package/dist/engine/tui/ui/meter-legend.js.map +1 -0
  191. package/dist/engine/tui/ui/run-summary.d.ts +58 -0
  192. package/dist/engine/tui/ui/run-summary.d.ts.map +1 -0
  193. package/dist/engine/tui/ui/run-summary.js +29 -0
  194. package/dist/engine/tui/ui/run-summary.js.map +1 -0
  195. package/dist/engine/tui/ui/segment-meter.d.ts +72 -0
  196. package/dist/engine/tui/ui/segment-meter.d.ts.map +1 -0
  197. package/dist/engine/tui/ui/segment-meter.js +128 -0
  198. package/dist/engine/tui/ui/segment-meter.js.map +1 -0
  199. package/dist/engine/tui/ui/status-line.d.ts +42 -0
  200. package/dist/engine/tui/ui/status-line.d.ts.map +1 -0
  201. package/dist/engine/tui/ui/status-line.js +35 -0
  202. package/dist/engine/tui/ui/status-line.js.map +1 -0
  203. package/dist/engine/tui/ui/tone.d.ts +46 -0
  204. package/dist/engine/tui/ui/tone.d.ts.map +1 -0
  205. package/dist/engine/tui/ui/tone.js +48 -0
  206. package/dist/engine/tui/ui/tone.js.map +1 -0
  207. package/dist/node/index.d.ts +2 -2
  208. package/dist/node/index.d.ts.map +1 -1
  209. package/dist/node/index.js +1 -1
  210. package/dist/node/index.js.map +1 -1
  211. package/dist/testing/index.d.ts +2 -2
  212. package/dist/testing/index.d.ts.map +1 -1
  213. package/dist/testing/index.js +1 -1
  214. package/dist/testing/index.js.map +1 -1
  215. package/dist/tui/index.d.ts +2 -2
  216. package/dist/tui/index.d.ts.map +1 -1
  217. package/dist/tui/index.js +1 -1
  218. package/dist/tui/index.js.map +1 -1
  219. package/dist/tui/testing/index.d.ts +5 -0
  220. package/dist/tui/testing/index.d.ts.map +1 -0
  221. package/dist/tui/testing/index.js +12 -0
  222. package/dist/tui/testing/index.js.map +1 -0
  223. package/dist/tui/ui/index.d.ts +2 -0
  224. package/dist/tui/ui/index.d.ts.map +1 -0
  225. package/dist/tui/ui/index.js +10 -0
  226. package/dist/tui/ui/index.js.map +1 -0
  227. 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
- run: (command: string, args: string[]) => void;
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(context: InstallContext): void;
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/C,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,2EAA2E;IAC3E,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IAC5C,0DAA0D;IAC1D,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IACzC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,UAAU,CAiC7H;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,EA4B9C,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9D,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,gEAAgE;IAChE,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA6D7E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAQrE"}
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 { execFileSync } from 'node:child_process';
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 steps = options.steps ?? DEFAULT_INSTALL_STEPS;
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
- execFileSync(command, args, { stdio: 'inherit' });
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
- if (!step.supported(context)) {
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":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA2F/C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,OAAoF;IAC/G,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACtF,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAEvF,IAAI,OAAO,GAAG,OAAO,EAAE,SAAS,CAAC;IACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,GAAG,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACpE,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAyB,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC;QACjE,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC;YACnC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;gBACvB,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,SAAS,CAAC;IAElB,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkB;IAClD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,wBAAwB;QAC/B,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC;QACjD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,IAAI,OAAO,CAAC,MAAM;gBAAE,OAAO;YAC3B,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;KACF;IACD;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,qBAAqB;QAC5B,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;YAC9E,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,qEAAqE;YACrE,wEAAwE;YACxE,sEAAsE;YACtE,MAAM,IAAI,KAAK,CACb,QAAQ,OAAO,EAAE,+BAA+B,OAAO,CAAC,QAAQ,CAAC,IAAI,2CAA2C,CACjH,CAAC;QACJ,CAAC;KACF;CACF,CAAC;AAwBF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA2B;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,gBAAgB,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;IAEhD,MAAM,OAAO,GAAmB;QAC9B,MAAM;QACN,MAAM;QACN,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EACD,OAAO,CAAC,GAAG;YACX,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,aAAa;QACzC,GAAG;KACJ,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC;IACtE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,GAAG,CACD,0BAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACxE,yCAAyC,CAC5C,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAkB,CAAC;QACvB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9F,SAAS;QACX,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAClH,SAAS;QACX,CAAC;QAED,IAAI,SAAkB,CAAC;QACvB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9F,SAAS;QACX,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;YAClG,SAAS;QACX,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAC;YAC1G,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,MAAM,KAAK,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACtJ,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1H,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,IAAc;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACvG,IAAI,KAAK,KAAK,IAAI;gBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;gBAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,SAAS,YAAY,CAAC,OAAe,EAAE,IAAc;IACnD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAClC,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACpI,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAoCD,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD,MAAM,eAAe,GAA4B,EAAE,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA2B;IAC7D,IAAI,OAAO,IAAI,EAAE,EAAE,KAAK,QAAQ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,6BAA6B,eAAe,IAAI,CAAC,CAAC;IAC7G,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IAC3I,KAAK,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QAC7D,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,EAAE,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IACxH,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,EAAE,oCAAoC,CAAC,CAAC;IACnJ,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACrI,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IAC7F,CAAC;IACD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAkB,CAAC,GAAG,qBAAqB,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,eAAe;SAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SAC9E,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IAExB,IAAI,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IACzE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;YACtE,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;gBACd,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,oEAAoE;YACpE,OAAO,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,SAAS,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;gBAAE,EAAE,IAAI,CAAC,CAAC;YAC/I,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,WAAW,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxF,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,6DAA6D,CAAC,CAAC;QAC1H,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAoB,EAAE,IAAmC;IACnF,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzI,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,yBAAyB,CAAC,EAAU;IAClD,MAAM,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/D,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,gCAAgC;IAC9C,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe,EAAE,IAAc,EAAE,OAAuB;IACjG,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IAC3E,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,mBAAmB,GAAG,6BAA6B,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAwB,EAAE,OAAuB;IACvF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,8DAA8D,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACvI,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,oCAAoC,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAChE,CAAC,GAAG,EAAE,EAAE,CAAC,qCAAqC,CAAC,IAAI,CAAC,GAAG,CAAC,EACxD,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;QACF,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,oBAAoB,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9E,OAAO,OAAO,CAAC;AACjB,CAAC;AA0BD,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAyB,EACzB,OAAuB;IAEvB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAC;IAC3G,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,mCAAmC,CAAC,CAAC;IAC/H,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACxD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,CACZ,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAC1G,CAAC,IAAI,EAAE,CAAC;IAET,MAAM,MAAM,GAAG,CAAC,IAAc,EAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEtK,IAAI,OAAO,GAAsC,SAAS,CAAC;IAC3D,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,cAAc,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC;YAChG,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,MAAM,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACnC,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAClH,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACtG,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACxD,IAAI,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC;YACnF,IAAI,OAAO,GAAG,QAAQ;gBAAE,MAAM,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,IAAI,iCAAiC,QAAQ,UAAU,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -1,16 +1,48 @@
1
1
  import type { NodeEngineEvent, NodeSnapshot } from './node-events.js';
2
2
  import type { LogRecord } from './logger.js';
3
- /** Server → client. */
4
- export type DaemonMessage = {
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';