@powerhousedao/desktop 6.2.3-dev.69 → 6.2.3-dev.71
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/dist/index.d.mts +65 -0
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +19 -2
- package/dist/index.mjs.map +1 -1
- package/dist/runner.d.mts +311 -106
- package/dist/runner.d.mts.map +1 -1
- package/dist/runner.mjs +100 -31
- package/dist/runner.mjs.map +1 -1
- package/dist/{shell-DbRGck6R.mjs → shell-CfgLhSXp.mjs} +284 -21
- package/dist/shell-CfgLhSXp.mjs.map +1 -0
- package/package.json +5 -3
- package/dist/shell-DbRGck6R.mjs.map +0 -1
package/dist/runner.mjs
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
|
-
import { S as loadAppJson, _ as bundleStack, d as runTauriIcon, f as tauriBundlesForHost, g as projectShell, i as shellEnv, l as preflightOrThrow, m as ICON_SOURCE, o as detectToolchain, p as tauriSpawn, r as resolveShell, s as fetchNodeSidecar, t as launchShell, v as APP_JSON_FILE } from "./shell-
|
|
1
|
+
import { S as loadAppJson, _ as bundleStack, d as runTauriIcon, f as tauriBundlesForHost, g as projectShell, i as shellEnv, l as preflightOrThrow, m as ICON_SOURCE, o as detectToolchain, p as tauriSpawn, r as resolveShell, s as fetchNodeSidecar, t as launchShell, v as APP_JSON_FILE } from "./shell-CfgLhSXp.mjs";
|
|
2
2
|
import fs from "node:fs";
|
|
3
3
|
import path from "node:path";
|
|
4
|
+
import { z } from "zod";
|
|
4
5
|
import { spawn, spawnSync } from "node:child_process";
|
|
5
|
-
import {
|
|
6
|
+
import { compoundWiringSchema, getVerb, loadHost, refineStartOrder, resolveRunnerModule, validateHost } from "@powerhousedao/host-core";
|
|
7
|
+
import { defineHostSchemas } from "@powerhousedao/host-core/schema";
|
|
6
8
|
//#region src/runner.ts
|
|
7
9
|
/**
|
|
8
10
|
* @powerhousedao/desktop/runner.
|
|
@@ -25,7 +27,60 @@ import { compoundHostSchema, getVerb, loadHost, resolveRunnerModule, validateHos
|
|
|
25
27
|
* (headless) needs none of it.
|
|
26
28
|
*/
|
|
27
29
|
const kind = "compound";
|
|
28
|
-
|
|
30
|
+
/** The verbs this runner exports (`shellMode` is a helper). */
|
|
31
|
+
const verbs = [
|
|
32
|
+
"run",
|
|
33
|
+
"serve",
|
|
34
|
+
"dev",
|
|
35
|
+
"build"
|
|
36
|
+
];
|
|
37
|
+
/** `runner.shell`: a prebuilt or hand-maintained shell (mode 2). Mirrors
|
|
38
|
+
* `ShellOptions` (shell.ts); a type test pins the two together. */
|
|
39
|
+
const shellOptionsSchema = z.strictObject({
|
|
40
|
+
/** Path to a ph-win-desktop checkout (absolute or project-relative). */
|
|
41
|
+
project: z.string().min(1).optional(),
|
|
42
|
+
window: z.strictObject({
|
|
43
|
+
title: z.string().optional(),
|
|
44
|
+
width: z.number().int().positive().optional(),
|
|
45
|
+
height: z.number().int().positive().optional()
|
|
46
|
+
}).optional(),
|
|
47
|
+
tray: z.boolean().optional(),
|
|
48
|
+
fileAssociations: z.array(z.string().min(1)).optional()
|
|
49
|
+
});
|
|
50
|
+
/**
|
|
51
|
+
* The desktop host, from one definition in two forms: DECLARED (what host.js
|
|
52
|
+
* authors write) and RESOLVED (what the verbs receive). The runner adds no
|
|
53
|
+
* token-able fields of its own; the forms differ in host-core's base blocks
|
|
54
|
+
* (member wrappers' reactor URLs and the like).
|
|
55
|
+
*/
|
|
56
|
+
const schemas = defineHostSchemas((base) => {
|
|
57
|
+
/** The desktop runner's own `runner` options, on top of the common base. */
|
|
58
|
+
const desktopRunnerOptionsSchema = base.runnerBaseSchema.extend({
|
|
59
|
+
shell: shellOptionsSchema.optional(),
|
|
60
|
+
/** build: vendor ph-cli into the staged stack (default true). */
|
|
61
|
+
vendorStack: z.boolean().optional(),
|
|
62
|
+
/** build: the ph-cli version/tag to vendor (default "dev"). */
|
|
63
|
+
phCliVersion: z.string().min(1).optional(),
|
|
64
|
+
/** build: full install spec override (e.g. a pnpm-pack tarball path)
|
|
65
|
+
* for a ph-cli not yet on the registry. */
|
|
66
|
+
phCliSpec: z.string().min(1).optional()
|
|
67
|
+
}).strict();
|
|
68
|
+
/** The generic compound's wiring config plus the shell and packaging
|
|
69
|
+
* options. Extend the unrefined base, refine last (zod refuses to extend
|
|
70
|
+
* a refined object). */
|
|
71
|
+
return base.compoundHostSchema.extend({
|
|
72
|
+
runner: desktopRunnerOptionsSchema,
|
|
73
|
+
config: compoundWiringSchema.optional()
|
|
74
|
+
}).superRefine(refineStartOrder);
|
|
75
|
+
});
|
|
76
|
+
/** Declared form: what a host file may contain before resolution. */
|
|
77
|
+
const declaredHostSchema = schemas.declaredHostSchema;
|
|
78
|
+
/** Resolved form: what the verbs receive (and `validateHost` checks). */
|
|
79
|
+
const hostSchema = schemas.hostSchema;
|
|
80
|
+
/** The desktop compound produces nothing of its own: what its members
|
|
81
|
+
* produce stays with the members (the compound's handles, the run record's
|
|
82
|
+
* `members`). */
|
|
83
|
+
const outputsSchema = z.strictObject({});
|
|
29
84
|
async function compoundModule() {
|
|
30
85
|
return import("@powerhousedao/host-core/runners/compound");
|
|
31
86
|
}
|
|
@@ -35,19 +90,38 @@ function hostDirOf(host, ctx) {
|
|
|
35
90
|
}
|
|
36
91
|
/** The connect member's port — the shell's readiness probe and window URL. */
|
|
37
92
|
async function connectPort(host, ctx) {
|
|
38
|
-
const
|
|
39
|
-
for (const wrapper of Object.values(children)) {
|
|
93
|
+
for (const wrapper of Object.values(host.children)) {
|
|
40
94
|
if (wrapper.host !== "connect") continue;
|
|
41
|
-
if (
|
|
95
|
+
if (wrapper.runner?.port !== void 0) return wrapper.runner.port;
|
|
42
96
|
const member = await loadHost(ctx.projectRoot, wrapper.host);
|
|
43
97
|
if (typeof member.host.runner.port === "number") return member.host.runner.port;
|
|
44
98
|
}
|
|
45
99
|
throw new Error(`hosts/${host.name}: no connect member with a resolvable runner.port — the shell needs it for its readiness probe and window URL.`);
|
|
46
100
|
}
|
|
47
101
|
async function run(host, ctx) {
|
|
48
|
-
|
|
102
|
+
const started = await (await compoundModule()).run(host, ctx);
|
|
103
|
+
return {
|
|
104
|
+
outputs: outputsSchema.parse({}),
|
|
105
|
+
ready: Promise.resolve(),
|
|
106
|
+
shutdown: started.shutdown
|
|
107
|
+
};
|
|
49
108
|
}
|
|
50
109
|
const serve = run;
|
|
110
|
+
/** The handle for a launched shell process: `ready` once it is spawned. */
|
|
111
|
+
function shellHandle(child) {
|
|
112
|
+
const exited = new Promise((resolve) => child.once("exit", () => resolve()));
|
|
113
|
+
return {
|
|
114
|
+
outputs: outputsSchema.parse({}),
|
|
115
|
+
ready: Promise.resolve(),
|
|
116
|
+
exited,
|
|
117
|
+
shutdown: () => {
|
|
118
|
+
try {
|
|
119
|
+
child.kill();
|
|
120
|
+
} catch {}
|
|
121
|
+
return Promise.resolve();
|
|
122
|
+
}
|
|
123
|
+
};
|
|
124
|
+
}
|
|
51
125
|
/** Which shell backs this host's native window (D7.d source order):
|
|
52
126
|
* an explicit `runner.shell.project`, else the app.json-generated shell,
|
|
53
127
|
* else the PH_DESKTOP_SHELL escape hatch. */
|
|
@@ -97,50 +171,43 @@ async function dev(host, ctx) {
|
|
|
97
171
|
const tauri = preflightOrThrow(detectToolchain(ctx.projectRoot), host.name);
|
|
98
172
|
provisionShell(shellDir, tauri, changed);
|
|
99
173
|
console.log(`[${host.name}] launching the generated desktop shell '${binName}' (${tauri.via}: cargo tauri dev) — stack via ph run ${host.name}, window at http://127.0.0.1:${port}/`);
|
|
100
|
-
|
|
101
|
-
return {
|
|
102
|
-
ready: new Promise((resolve) => child.once("exit", () => resolve())),
|
|
103
|
-
shutdown: () => {
|
|
104
|
-
try {
|
|
105
|
-
child.kill();
|
|
106
|
-
} catch {}
|
|
107
|
-
}
|
|
108
|
-
};
|
|
174
|
+
return shellHandle(spawnTauri(tauri, ["dev"], shellDir, envVars));
|
|
109
175
|
}
|
|
110
176
|
const options = host.runner;
|
|
111
177
|
const shell = resolveShell(ctx.projectRoot, options.shell, ctx.env);
|
|
112
178
|
console.log(`[${host.name}] launching the desktop shell (${shell.exe ? shell.exe : "pnpm tauri dev"}) — stack via ph run ${host.name}, window at http://127.0.0.1:${port}/`);
|
|
113
|
-
|
|
114
|
-
return {
|
|
115
|
-
ready: new Promise((resolve) => child.once("exit", () => resolve())),
|
|
116
|
-
shutdown: () => {
|
|
117
|
-
try {
|
|
118
|
-
child.kill();
|
|
119
|
-
} catch {}
|
|
120
|
-
}
|
|
121
|
-
};
|
|
179
|
+
return shellHandle(launchShell(shell, envVars, options.shell));
|
|
122
180
|
}
|
|
123
181
|
/** Forward `build` to members that export it (packaging builds what is
|
|
124
182
|
* buildable — unlike the generic compound's uniform fail-loud forwarding). */
|
|
125
183
|
async function buildMembers(host, ctx) {
|
|
126
|
-
const
|
|
127
|
-
for (const [name, wrapper] of Object.entries(children)) {
|
|
184
|
+
for (const [name, wrapper] of Object.entries(host.children)) {
|
|
128
185
|
const member = await loadHost(ctx.projectRoot, wrapper.host);
|
|
129
186
|
const specifier = member.host.runner.module;
|
|
130
187
|
const runner = await resolveRunnerModule(ctx.projectRoot, specifier);
|
|
131
|
-
validateHost(runner, specifier, member.host, `hosts/${wrapper.host}/host.js
|
|
188
|
+
const validated = validateHost(runner, specifier, member.host, `hosts/${wrapper.host}/host.js`, { tokens: "allow" });
|
|
132
189
|
if (typeof runner.build !== "function") {
|
|
133
190
|
console.log(`[${host.name}] build: ${name} (${wrapper.host}) exports no build — skipped (packaging builds what is buildable)`);
|
|
134
191
|
continue;
|
|
135
192
|
}
|
|
136
193
|
const fn = getVerb(runner, specifier, "build");
|
|
137
194
|
console.log(`[${host.name}] build → ${name} (${wrapper.host})`);
|
|
138
|
-
await fn(
|
|
195
|
+
await fn(validated, {
|
|
139
196
|
...ctx,
|
|
140
|
-
verb: "build"
|
|
197
|
+
verb: "build",
|
|
198
|
+
parent: {
|
|
199
|
+
host: host.name,
|
|
200
|
+
verb: ctx.verb
|
|
201
|
+
}
|
|
141
202
|
});
|
|
142
203
|
}
|
|
143
204
|
}
|
|
205
|
+
/** PH_DESKTOP_LOCAL_PACKAGES: tarballs to vendor in place of the registry's
|
|
206
|
+
* (a machine path, so an env var rather than a host-file option). */
|
|
207
|
+
function localPackagesDir(ctx) {
|
|
208
|
+
const dir = ctx.env.PH_DESKTOP_LOCAL_PACKAGES;
|
|
209
|
+
return dir ? path.resolve(ctx.projectRoot, dir) : void 0;
|
|
210
|
+
}
|
|
144
211
|
/** build = members' builds + the shippable stack + the native installer. */
|
|
145
212
|
async function build(host, ctx) {
|
|
146
213
|
await buildMembers(host, ctx);
|
|
@@ -164,6 +231,7 @@ async function build(host, ctx) {
|
|
|
164
231
|
vendor: runnerOptions.vendorStack,
|
|
165
232
|
phCliVersion: runnerOptions.phCliVersion,
|
|
166
233
|
phCliSpec: runnerOptions.phCliSpec ?? ctx.env.PH_DESKTOP_PHCLI_SPEC,
|
|
234
|
+
localPackagesDir: localPackagesDir(ctx),
|
|
167
235
|
connectPort: port,
|
|
168
236
|
excludeDirs: [shellDir]
|
|
169
237
|
});
|
|
@@ -191,6 +259,7 @@ async function build(host, ctx) {
|
|
|
191
259
|
vendor: runnerOptions.vendorStack,
|
|
192
260
|
phCliVersion: runnerOptions.phCliVersion,
|
|
193
261
|
phCliSpec: runnerOptions.phCliSpec ?? ctx.env.PH_DESKTOP_PHCLI_SPEC,
|
|
262
|
+
localPackagesDir: localPackagesDir(ctx),
|
|
194
263
|
connectPort: port
|
|
195
264
|
});
|
|
196
265
|
console.log(`[${host.name}] stack staged at ${result.stackDir}${result.vendored ? " (ph-cli vendored)" : ""} — the shell runs it with no environment (resources fallback).`);
|
|
@@ -207,6 +276,6 @@ function spawnSyncTauri(tauri, subcommand, shellDir) {
|
|
|
207
276
|
}).status ?? 1;
|
|
208
277
|
}
|
|
209
278
|
//#endregion
|
|
210
|
-
export { build, dev, hostSchema, kind, run, serve, shellMode };
|
|
279
|
+
export { build, declaredHostSchema, dev, hostSchema, kind, outputsSchema, run, serve, shellMode, shellOptionsSchema, verbs };
|
|
211
280
|
|
|
212
281
|
//# sourceMappingURL=runner.mjs.map
|
package/dist/runner.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runner.mjs","names":[],"sources":["../src/runner.ts"],"sourcesContent":["import { spawn, spawnSync } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n compoundHostSchema,\n getVerb,\n loadHost,\n resolveRunnerModule,\n validateHost,\n type HostDefinition,\n type RunnerContext,\n} from \"@powerhousedao/host-core\";\nimport { APP_JSON_FILE, loadAppJson } from \"./app-json.js\";\nimport { bundleStack } from \"./bundle-stack.js\";\nimport { ICON_SOURCE, projectShell } from \"./shell-project.js\";\nimport {\n detectToolchain,\n fetchNodeSidecar,\n preflightOrThrow,\n runTauriIcon,\n tauriBundlesForHost,\n tauriSpawn,\n type TauriCommand,\n} from \"./shell-toolchain.js\";\nimport {\n launchShell,\n resolveShell,\n shellEnv,\n type ShellOptions,\n} from \"./shell.js\";\n\n/**\n * @powerhousedao/desktop/runner.\n *\n * - `run`/`serve`: the headless stack — byte-identical delegation to\n * host-core's generic compound (phase-3 semantics unchanged).\n * - `dev`: the NATIVE window. Mode 1 (phase 7) is the default — a builder\n * ships under THEIR identity by editing `hosts/<host>/app.json` and never\n * writing Rust: the runner projects app.json into a generated `tauri-shell/`\n * that depends on the published `ph-desktop-shell` crate, provisions the\n * native toolchain's compile-time inputs (node sidecar + icon set), and runs\n * `cargo tauri dev`. An explicit `runner.shell.project` (or PH_DESKTOP_SHELL)\n * still selects a prebuilt/hand-maintained shell instead.\n * - `build`: the PACKAGING verb — members' builds (where exported), then the\n * shippable stack staged into the shell + `cargo tauri build` with\n * host-appropriate installer targets (nsis / app+dmg / deb+appimage).\n *\n * The native toolchain is required ONLY for dev/build; a missing cargo or\n * Tauri CLI fails with install guidance (see shell-toolchain). `ph run <host>`\n * (headless) needs none of it.\n */\n\nexport const kind = \"compound\";\n\nexport const hostSchema = compoundHostSchema;\n\ninterface DesktopRunnerOptions {\n shell?: ShellOptions;\n /** build: vendor ph-cli into the staged stack (default true). */\n vendorStack?: boolean;\n /** build: the ph-cli version/tag to vendor (default \"dev\"). */\n phCliVersion?: string;\n /** build: full install spec override (e.g. a pnpm-pack tarball path) for a\n * ph-cli not yet on the registry. */\n phCliSpec?: string;\n}\n\ninterface ChildWrapper {\n host: string;\n runner?: { port?: number; defaultVerb?: string } & Record<string, unknown>;\n}\n\nasync function compoundModule() {\n return import(\"@powerhousedao/host-core/runners/compound\");\n}\n\n/** hosts/<host>/ — where app.json lives and the generated shell is written. */\nfunction hostDirOf(host: HostDefinition, ctx: RunnerContext): string {\n return path.join(ctx.projectRoot, \"hosts\", host.name);\n}\n\n/** The connect member's port — the shell's readiness probe and window URL. */\nasync function connectPort(\n host: HostDefinition,\n ctx: RunnerContext,\n): Promise<number> {\n const children = (host.children ?? {}) as Record<string, ChildWrapper>;\n for (const wrapper of Object.values(children)) {\n if (wrapper.host !== \"connect\") continue;\n if (typeof wrapper.runner?.port === \"number\") return wrapper.runner.port;\n const member = await loadHost(ctx.projectRoot, wrapper.host);\n if (typeof member.host.runner.port === \"number\") {\n return member.host.runner.port;\n }\n }\n throw new Error(\n `hosts/${host.name}: no connect member with a resolvable runner.port — ` +\n `the shell needs it for its readiness probe and window URL.`,\n );\n}\n\nexport async function run(host: HostDefinition, ctx: RunnerContext) {\n const compound = await compoundModule();\n return compound.run(host, ctx);\n}\n\nexport const serve = run;\n\nexport interface ShellHandle {\n /** Resolves when the shell window exits — the runner's keep-alive. */\n ready: Promise<void>;\n shutdown: () => void;\n}\n\n/** Which shell backs this host's native window (D7.d source order):\n * an explicit `runner.shell.project`, else the app.json-generated shell,\n * else the PH_DESKTOP_SHELL escape hatch. */\nexport function shellMode(\n host: HostDefinition,\n ctx: RunnerContext,\n): \"external-project\" | \"generated\" | \"external-env\" | \"none\" {\n const options = host.runner as { shell?: ShellOptions };\n if (options.shell?.project) return \"external-project\";\n if (fs.existsSync(path.join(hostDirOf(host, ctx), APP_JSON_FILE))) {\n return \"generated\";\n }\n if (ctx.env.PH_DESKTOP_SHELL) return \"external-env\";\n return \"none\";\n}\n\n/** Fetch the node sidecar + (re)generate the icon set — both are tauri-build\n * COMPILE-TIME inputs (externalBin; icon.ico for the Windows resource),\n * confirmed against a live cargo check. Icon regen only when app-icon.png\n * changed or the set is absent. */\nfunction provisionShell(\n shellDir: string,\n tauri: TauriCommand,\n iconChanged: boolean,\n): void {\n fetchNodeSidecar(shellDir);\n const iconIco = path.join(shellDir, \"icons\", \"icon.ico\");\n if (iconChanged || !fs.existsSync(iconIco)) {\n runTauriIcon(tauri, shellDir, ICON_SOURCE);\n }\n}\n\n/** Spawn a `<tauri> <subcommand>` in the generated shell with the uniform-\n * runners env trio wired in. */\nfunction spawnTauri(\n tauri: TauriCommand,\n subcommand: string[],\n shellDir: string,\n envVars: Record<string, string>,\n) {\n const { command, args, shell } = tauriSpawn(tauri, subcommand);\n return spawn(command, args, {\n cwd: shellDir,\n env: { ...process.env, ...envVars },\n stdio: \"inherit\",\n shell,\n windowsHide: true,\n });\n}\n\nexport async function dev(\n host: HostDefinition,\n ctx: RunnerContext,\n): Promise<ShellHandle> {\n const mode = shellMode(host, ctx);\n if (mode === \"none\") {\n throw new Error(\n `hosts/${host.name}: no desktop shell to run — add ${APP_JSON_FILE} ` +\n `(run \\`ph generate desktop-shell\\`) for a builder-owned identity, set ` +\n `runner.shell.project to a prebuilt shell, or export PH_DESKTOP_SHELL.`,\n );\n }\n\n const port = await connectPort(host, ctx);\n const envVars = shellEnv(ctx.projectRoot, port, ctx.env);\n\n if (mode === \"generated\") {\n const hostDir = hostDirOf(host, ctx);\n const app = loadAppJson(hostDir);\n const { shellDir, binName, changed } = projectShell({\n hostDir,\n app,\n connectPort: port,\n });\n const tauri = preflightOrThrow(detectToolchain(ctx.projectRoot), host.name);\n provisionShell(shellDir, tauri, changed);\n console.log(\n `[${host.name}] launching the generated desktop shell '${binName}' ` +\n `(${tauri.via}: cargo tauri dev) — stack via ph run ${host.name}, ` +\n `window at http://127.0.0.1:${port}/`,\n );\n const child = spawnTauri(tauri, [\"dev\"], shellDir, envVars);\n const exited = new Promise<void>((resolve) =>\n child.once(\"exit\", () => resolve()),\n );\n return {\n ready: exited,\n shutdown: () => {\n try {\n child.kill();\n } catch {\n // already gone\n }\n },\n };\n }\n\n // external-project / external-env: a prebuilt or hand-maintained shell.\n const options = host.runner as { shell?: ShellOptions };\n const shell = resolveShell(ctx.projectRoot, options.shell, ctx.env);\n console.log(\n `[${host.name}] launching the desktop shell ` +\n `(${shell.exe ? shell.exe : \"pnpm tauri dev\"}) — stack via ` +\n `ph run ${host.name}, window at http://127.0.0.1:${port}/`,\n );\n const child = launchShell(shell, envVars, options.shell);\n const exited = new Promise<void>((resolve) =>\n child.once(\"exit\", () => resolve()),\n );\n return {\n ready: exited,\n shutdown: () => {\n try {\n child.kill();\n } catch {\n // already gone\n }\n },\n };\n}\n\n/** Forward `build` to members that export it (packaging builds what is\n * buildable — unlike the generic compound's uniform fail-loud forwarding). */\nasync function buildMembers(\n host: HostDefinition,\n ctx: RunnerContext,\n): Promise<void> {\n const children = (host.children ?? {}) as Record<string, ChildWrapper>;\n for (const [name, wrapper] of Object.entries(children)) {\n const member = await loadHost(ctx.projectRoot, wrapper.host);\n const specifier = member.host.runner.module;\n const runner = await resolveRunnerModule(ctx.projectRoot, specifier);\n validateHost(\n runner,\n specifier,\n member.host,\n `hosts/${wrapper.host}/host.js`,\n );\n if (typeof (runner as Record<string, unknown>).build !== \"function\") {\n console.log(\n `[${host.name}] build: ${name} (${wrapper.host}) exports no build — skipped (packaging builds what is buildable)`,\n );\n continue;\n }\n const fn = getVerb(runner, specifier, \"build\");\n console.log(`[${host.name}] build → ${name} (${wrapper.host})`);\n await fn(member.host, { ...ctx, verb: \"build\" });\n }\n}\n\n/** build = members' builds + the shippable stack + the native installer. */\nexport async function build(\n host: HostDefinition,\n ctx: RunnerContext,\n): Promise<void> {\n await buildMembers(host, ctx);\n\n const runnerOptions = host.runner as DesktopRunnerOptions &\n HostDefinition[\"runner\"];\n const mode = shellMode(host, ctx);\n const port = await connectPort(host, ctx);\n\n if (mode === \"generated\") {\n const hostDir = hostDirOf(host, ctx);\n const app = loadAppJson(hostDir);\n const { shellDir, binName, changed } = projectShell({\n hostDir,\n app,\n connectPort: port,\n });\n const tauri = preflightOrThrow(detectToolchain(ctx.projectRoot), host.name);\n provisionShell(shellDir, tauri, changed);\n\n console.log(`[${host.name}] staging the stack into ${shellDir}…`);\n const staged = bundleStack({\n projectRoot: ctx.projectRoot,\n shellProjectDir: shellDir,\n vendor: runnerOptions.vendorStack,\n phCliVersion: runnerOptions.phCliVersion,\n phCliSpec: runnerOptions.phCliSpec ?? ctx.env.PH_DESKTOP_PHCLI_SPEC,\n connectPort: port,\n // the generated shell lives under hosts/ — never stage it into itself\n excludeDirs: [shellDir],\n });\n console.log(\n `[${host.name}] stack staged at ${staged.stackDir}` +\n `${staged.vendored ? \" (ph-cli vendored)\" : \"\"}.`,\n );\n\n const bundles = tauriBundlesForHost();\n console.log(\n `[${host.name}] building '${binName}' (${tauri.via}: cargo tauri ` +\n `build --bundles ${bundles.join(\",\")})…`,\n );\n const result = spawnSyncTauri(\n tauri,\n [\"build\", \"--bundles\", bundles.join(\",\")],\n shellDir,\n );\n if (result !== 0) {\n throw new Error(\n `hosts/${host.name}: \\`cargo tauri build\\` failed (exit ${result}).`,\n );\n }\n console.log(\n `[${host.name}] desktop app built — installers under ` +\n `${path.join(shellDir, \"target\", \"release\", \"bundle\")}.`,\n );\n return;\n }\n\n // external-project / external-env: stage into the prebuilt shell (phase 6).\n if (mode === \"none\") {\n console.log(\n `[${host.name}] build: no shell configured — members built; shell ` +\n `packaging skipped (add ${APP_JSON_FILE} or set runner.shell.project).`,\n );\n return;\n }\n const shell = resolveShell(ctx.projectRoot, runnerOptions.shell, ctx.env);\n console.log(`[${host.name}] staging the stack into ${shell.projectDir}…`);\n const result = bundleStack({\n projectRoot: ctx.projectRoot,\n shellProjectDir: shell.projectDir,\n vendor: runnerOptions.vendorStack,\n phCliVersion: runnerOptions.phCliVersion,\n phCliSpec: runnerOptions.phCliSpec ?? ctx.env.PH_DESKTOP_PHCLI_SPEC,\n connectPort: port,\n });\n console.log(\n `[${host.name}] stack staged at ${result.stackDir}` +\n `${result.vendored ? \" (ph-cli vendored)\" : \"\"} — the shell runs it with ` +\n `no environment (resources fallback).`,\n );\n}\n\n/** Synchronous `<tauri> <subcommand>` — build blocks until the installer is\n * produced. Returns the exit code. */\nfunction spawnSyncTauri(\n tauri: TauriCommand,\n subcommand: string[],\n shellDir: string,\n): number {\n const { command, args, shell } = tauriSpawn(tauri, subcommand);\n const r = spawnSync(command, args, {\n cwd: shellDir,\n stdio: \"inherit\",\n shell,\n windowsHide: true,\n });\n return r.status ?? 1;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"runner.mjs","names":[],"sources":["../src/runner.ts"],"sourcesContent":["import { spawn, spawnSync, type ChildProcess } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n compoundWiringSchema,\n getVerb,\n loadHost,\n refineStartOrder,\n resolveRunnerModule,\n validateHost,\n type RunnerContext,\n type RunnerHandle,\n} from \"@powerhousedao/host-core\";\nimport { defineHostSchemas } from \"@powerhousedao/host-core/schema\";\nimport { z } from \"zod\";\nimport { APP_JSON_FILE, loadAppJson } from \"./app-json.js\";\nimport { bundleStack } from \"./bundle-stack.js\";\nimport { ICON_SOURCE, projectShell } from \"./shell-project.js\";\nimport {\n detectToolchain,\n fetchNodeSidecar,\n preflightOrThrow,\n runTauriIcon,\n tauriBundlesForHost,\n tauriSpawn,\n type TauriCommand,\n} from \"./shell-toolchain.js\";\nimport { launchShell, resolveShell, shellEnv } from \"./shell.js\";\n\n/**\n * @powerhousedao/desktop/runner.\n *\n * - `run`/`serve`: the headless stack — byte-identical delegation to\n * host-core's generic compound (phase-3 semantics unchanged).\n * - `dev`: the NATIVE window. Mode 1 (phase 7) is the default — a builder\n * ships under THEIR identity by editing `hosts/<host>/app.json` and never\n * writing Rust: the runner projects app.json into a generated `tauri-shell/`\n * that depends on the published `ph-desktop-shell` crate, provisions the\n * native toolchain's compile-time inputs (node sidecar + icon set), and runs\n * `cargo tauri dev`. An explicit `runner.shell.project` (or PH_DESKTOP_SHELL)\n * still selects a prebuilt/hand-maintained shell instead.\n * - `build`: the PACKAGING verb — members' builds (where exported), then the\n * shippable stack staged into the shell + `cargo tauri build` with\n * host-appropriate installer targets (nsis / app+dmg / deb+appimage).\n *\n * The native toolchain is required ONLY for dev/build; a missing cargo or\n * Tauri CLI fails with install guidance (see shell-toolchain). `ph run <host>`\n * (headless) needs none of it.\n */\n\nexport const kind = \"compound\";\n\n/** The verbs this runner exports (`shellMode` is a helper). */\nexport const verbs = [\"run\", \"serve\", \"dev\", \"build\"] as const;\n\n/** `runner.shell`: a prebuilt or hand-maintained shell (mode 2). Mirrors\n * `ShellOptions` (shell.ts); a type test pins the two together. */\nexport const shellOptionsSchema = z.strictObject({\n /** Path to a ph-win-desktop checkout (absolute or project-relative). */\n project: z.string().min(1).optional(),\n window: z\n .strictObject({\n title: z.string().optional(),\n width: z.number().int().positive().optional(),\n height: z.number().int().positive().optional(),\n })\n .optional(),\n tray: z.boolean().optional(),\n fileAssociations: z.array(z.string().min(1)).optional(),\n});\n\n/**\n * The desktop host, from one definition in two forms: DECLARED (what host.js\n * authors write) and RESOLVED (what the verbs receive). The runner adds no\n * token-able fields of its own; the forms differ in host-core's base blocks\n * (member wrappers' reactor URLs and the like).\n */\nconst schemas = defineHostSchemas((base) => {\n /** The desktop runner's own `runner` options, on top of the common base. */\n const desktopRunnerOptionsSchema = base.runnerBaseSchema\n .extend({\n shell: shellOptionsSchema.optional(),\n /** build: vendor ph-cli into the staged stack (default true). */\n vendorStack: z.boolean().optional(),\n /** build: the ph-cli version/tag to vendor (default \"dev\"). */\n phCliVersion: z.string().min(1).optional(),\n /** build: full install spec override (e.g. a pnpm-pack tarball path)\n * for a ph-cli not yet on the registry. */\n phCliSpec: z.string().min(1).optional(),\n })\n .strict();\n\n /** The generic compound's wiring config plus the shell and packaging\n * options. Extend the unrefined base, refine last (zod refuses to extend\n * a refined object). */\n return base.compoundHostSchema\n .extend({\n runner: desktopRunnerOptionsSchema,\n config: compoundWiringSchema.optional(),\n })\n .superRefine(refineStartOrder);\n});\n\n/** Declared form: what a host file may contain before resolution. */\nexport const declaredHostSchema = schemas.declaredHostSchema;\n/** Resolved form: what the verbs receive (and `validateHost` checks). */\nexport const hostSchema = schemas.hostSchema;\n\n/** What a desktop host.js author writes. */\nexport type DesktopHostInput = z.input<typeof declaredHostSchema>;\n/** What the verbs receive. */\nexport type DesktopHost = z.output<typeof hostSchema>;\n\n/** The desktop compound produces nothing of its own: what its members\n * produce stays with the members (the compound's handles, the run record's\n * `members`). */\nexport const outputsSchema = z.strictObject({});\n\nexport type DesktopOutputs = z.infer<typeof outputsSchema>;\n\ndeclare global {\n interface PHHostRunners {\n \"@powerhousedao/desktop/runner\": {\n host: DesktopHostInput;\n outputs: DesktopOutputs;\n };\n }\n}\n\nexport type DesktopHandle = RunnerHandle<DesktopOutputs>;\n\nasync function compoundModule() {\n return import(\"@powerhousedao/host-core/runners/compound\");\n}\n\n/** hosts/<host>/ — where app.json lives and the generated shell is written. */\nfunction hostDirOf(\n host: Pick<DesktopHost, \"name\">,\n ctx: RunnerContext,\n): string {\n return path.join(ctx.projectRoot, \"hosts\", host.name);\n}\n\n/** The connect member's port — the shell's readiness probe and window URL. */\nasync function connectPort(\n host: DesktopHost,\n ctx: RunnerContext,\n): Promise<number> {\n for (const wrapper of Object.values(host.children)) {\n if (wrapper.host !== \"connect\") continue;\n if (wrapper.runner?.port !== undefined) return wrapper.runner.port;\n const member = await loadHost(ctx.projectRoot, wrapper.host);\n if (typeof member.host.runner.port === \"number\") {\n return member.host.runner.port;\n }\n }\n throw new Error(\n `hosts/${host.name}: no connect member with a resolvable runner.port — ` +\n `the shell needs it for its readiness probe and window URL.`,\n );\n}\n\nexport async function run(\n host: DesktopHost,\n ctx: RunnerContext,\n): Promise<DesktopHandle> {\n const compound = await compoundModule();\n const started = await compound.run(host, ctx);\n return {\n outputs: outputsSchema.parse({}),\n // runCompound has already awaited every member's readiness.\n ready: Promise.resolve(),\n shutdown: started.shutdown,\n };\n}\n\nexport const serve = run;\n\nexport interface ShellHandle extends DesktopHandle {\n /** Resolves when the shell window exits — the runner's keep-alive. */\n exited: Promise<void>;\n}\n\n/** The handle for a launched shell process: `ready` once it is spawned. */\nfunction shellHandle(child: ChildProcess): ShellHandle {\n const exited = new Promise<void>((resolve) =>\n child.once(\"exit\", () => resolve()),\n );\n return {\n outputs: outputsSchema.parse({}),\n ready: Promise.resolve(),\n exited,\n shutdown: () => {\n try {\n child.kill();\n } catch {\n // already gone\n }\n return Promise.resolve();\n },\n };\n}\n\n/** Which shell backs this host's native window (D7.d source order):\n * an explicit `runner.shell.project`, else the app.json-generated shell,\n * else the PH_DESKTOP_SHELL escape hatch. */\nexport function shellMode(\n host: Pick<DesktopHost, \"name\" | \"runner\">,\n ctx: RunnerContext,\n): \"external-project\" | \"generated\" | \"external-env\" | \"none\" {\n if (host.runner.shell?.project) return \"external-project\";\n if (fs.existsSync(path.join(hostDirOf(host, ctx), APP_JSON_FILE))) {\n return \"generated\";\n }\n if (ctx.env.PH_DESKTOP_SHELL) return \"external-env\";\n return \"none\";\n}\n\n/** Fetch the node sidecar + (re)generate the icon set — both are tauri-build\n * COMPILE-TIME inputs (externalBin; icon.ico for the Windows resource),\n * confirmed against a live cargo check. Icon regen only when app-icon.png\n * changed or the set is absent. */\nfunction provisionShell(\n shellDir: string,\n tauri: TauriCommand,\n iconChanged: boolean,\n): void {\n fetchNodeSidecar(shellDir);\n const iconIco = path.join(shellDir, \"icons\", \"icon.ico\");\n if (iconChanged || !fs.existsSync(iconIco)) {\n runTauriIcon(tauri, shellDir, ICON_SOURCE);\n }\n}\n\n/** Spawn a `<tauri> <subcommand>` in the generated shell with the uniform-\n * runners env trio wired in. */\nfunction spawnTauri(\n tauri: TauriCommand,\n subcommand: string[],\n shellDir: string,\n envVars: Record<string, string>,\n) {\n const { command, args, shell } = tauriSpawn(tauri, subcommand);\n return spawn(command, args, {\n cwd: shellDir,\n env: { ...process.env, ...envVars },\n stdio: \"inherit\",\n shell,\n windowsHide: true,\n });\n}\n\nexport async function dev(\n host: DesktopHost,\n ctx: RunnerContext,\n): Promise<ShellHandle> {\n const mode = shellMode(host, ctx);\n if (mode === \"none\") {\n throw new Error(\n `hosts/${host.name}: no desktop shell to run — add ${APP_JSON_FILE} ` +\n `(run \\`ph generate desktop-shell\\`) for a builder-owned identity, set ` +\n `runner.shell.project to a prebuilt shell, or export PH_DESKTOP_SHELL.`,\n );\n }\n\n const port = await connectPort(host, ctx);\n const envVars = shellEnv(ctx.projectRoot, port, ctx.env);\n\n if (mode === \"generated\") {\n const hostDir = hostDirOf(host, ctx);\n const app = loadAppJson(hostDir);\n const { shellDir, binName, changed } = projectShell({\n hostDir,\n app,\n connectPort: port,\n });\n const tauri = preflightOrThrow(detectToolchain(ctx.projectRoot), host.name);\n provisionShell(shellDir, tauri, changed);\n console.log(\n `[${host.name}] launching the generated desktop shell '${binName}' ` +\n `(${tauri.via}: cargo tauri dev) — stack via ph run ${host.name}, ` +\n `window at http://127.0.0.1:${port}/`,\n );\n return shellHandle(spawnTauri(tauri, [\"dev\"], shellDir, envVars));\n }\n\n // external-project / external-env: a prebuilt or hand-maintained shell.\n const options = host.runner;\n const shell = resolveShell(ctx.projectRoot, options.shell, ctx.env);\n console.log(\n `[${host.name}] launching the desktop shell ` +\n `(${shell.exe ? shell.exe : \"pnpm tauri dev\"}) — stack via ` +\n `ph run ${host.name}, window at http://127.0.0.1:${port}/`,\n );\n return shellHandle(launchShell(shell, envVars, options.shell));\n}\n\n/** Forward `build` to members that export it (packaging builds what is\n * buildable — unlike the generic compound's uniform fail-loud forwarding). */\nasync function buildMembers(\n host: DesktopHost,\n ctx: RunnerContext,\n): Promise<void> {\n for (const [name, wrapper] of Object.entries(host.children)) {\n const member = await loadHost(ctx.projectRoot, wrapper.host);\n const specifier = member.host.runner.module;\n const runner = await resolveRunnerModule(ctx.projectRoot, specifier);\n const validated = validateHost(\n runner,\n specifier,\n member.host,\n `hosts/${wrapper.host}/host.js`,\n // build is one-shot: it needs no other member's outputs, so a declared\n // $output stays a token (as in the generic compound).\n { tokens: \"allow\" },\n );\n if (typeof runner.build !== \"function\") {\n console.log(\n `[${host.name}] build: ${name} (${wrapper.host}) exports no build — skipped (packaging builds what is buildable)`,\n );\n continue;\n }\n const fn = getVerb(runner, specifier, \"build\");\n console.log(`[${host.name}] build → ${name} (${wrapper.host})`);\n await fn(validated, {\n ...ctx,\n verb: \"build\",\n parent: { host: host.name, verb: ctx.verb },\n });\n }\n}\n\n/** PH_DESKTOP_LOCAL_PACKAGES: tarballs to vendor in place of the registry's\n * (a machine path, so an env var rather than a host-file option). */\nfunction localPackagesDir(ctx: RunnerContext): string | undefined {\n const dir = ctx.env.PH_DESKTOP_LOCAL_PACKAGES;\n return dir ? path.resolve(ctx.projectRoot, dir) : undefined;\n}\n\n/** build = members' builds + the shippable stack + the native installer. */\nexport async function build(\n host: DesktopHost,\n ctx: RunnerContext,\n): Promise<void> {\n await buildMembers(host, ctx);\n\n const runnerOptions = host.runner;\n const mode = shellMode(host, ctx);\n const port = await connectPort(host, ctx);\n\n if (mode === \"generated\") {\n const hostDir = hostDirOf(host, ctx);\n const app = loadAppJson(hostDir);\n const { shellDir, binName, changed } = projectShell({\n hostDir,\n app,\n connectPort: port,\n });\n const tauri = preflightOrThrow(detectToolchain(ctx.projectRoot), host.name);\n provisionShell(shellDir, tauri, changed);\n\n console.log(`[${host.name}] staging the stack into ${shellDir}…`);\n const staged = bundleStack({\n projectRoot: ctx.projectRoot,\n shellProjectDir: shellDir,\n vendor: runnerOptions.vendorStack,\n phCliVersion: runnerOptions.phCliVersion,\n phCliSpec: runnerOptions.phCliSpec ?? ctx.env.PH_DESKTOP_PHCLI_SPEC,\n localPackagesDir: localPackagesDir(ctx),\n connectPort: port,\n // the generated shell lives under hosts/ — never stage it into itself\n excludeDirs: [shellDir],\n });\n console.log(\n `[${host.name}] stack staged at ${staged.stackDir}` +\n `${staged.vendored ? \" (ph-cli vendored)\" : \"\"}.`,\n );\n\n const bundles = tauriBundlesForHost();\n console.log(\n `[${host.name}] building '${binName}' (${tauri.via}: cargo tauri ` +\n `build --bundles ${bundles.join(\",\")})…`,\n );\n const result = spawnSyncTauri(\n tauri,\n [\"build\", \"--bundles\", bundles.join(\",\")],\n shellDir,\n );\n if (result !== 0) {\n throw new Error(\n `hosts/${host.name}: \\`cargo tauri build\\` failed (exit ${result}).`,\n );\n }\n console.log(\n `[${host.name}] desktop app built — installers under ` +\n `${path.join(shellDir, \"target\", \"release\", \"bundle\")}.`,\n );\n return;\n }\n\n // external-project / external-env: stage into the prebuilt shell (phase 6).\n if (mode === \"none\") {\n console.log(\n `[${host.name}] build: no shell configured — members built; shell ` +\n `packaging skipped (add ${APP_JSON_FILE} or set runner.shell.project).`,\n );\n return;\n }\n const shell = resolveShell(ctx.projectRoot, runnerOptions.shell, ctx.env);\n console.log(`[${host.name}] staging the stack into ${shell.projectDir}…`);\n const result = bundleStack({\n projectRoot: ctx.projectRoot,\n shellProjectDir: shell.projectDir,\n vendor: runnerOptions.vendorStack,\n phCliVersion: runnerOptions.phCliVersion,\n phCliSpec: runnerOptions.phCliSpec ?? ctx.env.PH_DESKTOP_PHCLI_SPEC,\n localPackagesDir: localPackagesDir(ctx),\n connectPort: port,\n });\n console.log(\n `[${host.name}] stack staged at ${result.stackDir}` +\n `${result.vendored ? \" (ph-cli vendored)\" : \"\"} — the shell runs it with ` +\n `no environment (resources fallback).`,\n );\n}\n\n/** Synchronous `<tauri> <subcommand>` — build blocks until the installer is\n * produced. Returns the exit code. */\nfunction spawnSyncTauri(\n tauri: TauriCommand,\n subcommand: string[],\n shellDir: string,\n): number {\n const { command, args, shell } = tauriSpawn(tauri, subcommand);\n const r = spawnSync(command, args, {\n cwd: shellDir,\n stdio: \"inherit\",\n shell,\n windowsHide: true,\n });\n return r.status ?? 1;\n}\n"],"mappings":"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"}
|