@powerhousedao/ph-run 6.2.3-dev.98 → 6.3.0-dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/dist/{classic-args-BYccyIIC.mjs → classic-args-BJMDXYLJ.mjs} +11 -5
  2. package/dist/{classic-args-BYccyIIC.mjs.map → classic-args-BJMDXYLJ.mjs.map} +1 -1
  3. package/dist/{classic-args-Dm0_3O5p.d.mts → classic-args-BKI4gEVD.d.mts} +4 -2
  4. package/dist/{classic-args-Dm0_3O5p.d.mts.map → classic-args-BKI4gEVD.d.mts.map} +1 -1
  5. package/dist/cli.mjs +9 -8
  6. package/dist/cli.mjs.map +1 -1
  7. package/dist/{connect-serve-1WAi0KJL.mjs → connect-serve-TZFWyrHe.mjs} +10 -5
  8. package/dist/connect-serve-TZFWyrHe.mjs.map +1 -0
  9. package/dist/{connect-serve-COWXf_41.d.mts → connect-serve-kfNeXmO2.d.mts} +5 -2
  10. package/dist/connect-serve-kfNeXmO2.d.mts.map +1 -0
  11. package/dist/{member-config-Bs3yOT6y.mjs → member-config-BvlBqovs.mjs} +5 -4
  12. package/dist/member-config-BvlBqovs.mjs.map +1 -0
  13. package/dist/observability-CrfdAtHw.mjs +25 -0
  14. package/dist/observability-CrfdAtHw.mjs.map +1 -0
  15. package/dist/runner-args-DduJxV1b.mjs +74 -0
  16. package/dist/runner-args-DduJxV1b.mjs.map +1 -0
  17. package/dist/runners/connect.d.mts +48 -3
  18. package/dist/runners/connect.d.mts.map +1 -1
  19. package/dist/runners/connect.mjs +76 -14
  20. package/dist/runners/connect.mjs.map +1 -1
  21. package/dist/runners/member-config.d.mts +30 -0
  22. package/dist/runners/member-config.d.mts.map +1 -1
  23. package/dist/runners/member-config.mjs +3 -3
  24. package/dist/runners/switchboard.d.mts +126 -1
  25. package/dist/runners/switchboard.d.mts.map +1 -1
  26. package/dist/runners/switchboard.mjs +96 -13
  27. package/dist/runners/switchboard.mjs.map +1 -1
  28. package/dist/services/classic-args.d.mts +2 -2
  29. package/dist/services/classic-args.mjs +4 -4
  30. package/dist/services/connect-serve.d.mts +1 -1
  31. package/dist/services/connect-serve.mjs +3 -3
  32. package/dist/services/connect-server.d.mts +5 -4
  33. package/dist/services/connect-server.d.mts.map +1 -1
  34. package/dist/services/connect-server.mjs +14 -6
  35. package/dist/services/connect-server.mjs.map +1 -1
  36. package/dist/services/run/start-run.d.mts +7 -1
  37. package/dist/services/run/start-run.d.mts.map +1 -1
  38. package/dist/services/run/start-run.mjs +3 -3
  39. package/dist/services/switchboard.d.mts +1 -1
  40. package/dist/{start-run-DWn2cVyi.mjs → start-run-DUfxuOde.mjs} +38 -19
  41. package/dist/start-run-DUfxuOde.mjs.map +1 -0
  42. package/dist/superseded-config-bNn_JyUj.mjs +31 -0
  43. package/dist/superseded-config-bNn_JyUj.mjs.map +1 -0
  44. package/package.json +7 -7
  45. package/dist/connect-serve-1WAi0KJL.mjs.map +0 -1
  46. package/dist/connect-serve-COWXf_41.d.mts.map +0 -1
  47. package/dist/member-config-Bs3yOT6y.mjs.map +0 -1
  48. package/dist/start-run-DWn2cVyi.mjs.map +0 -1
  49. package/dist/superseded-config-CpHrCuNq.mjs +0 -53
  50. package/dist/superseded-config-CpHrCuNq.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"connect-server.mjs","sources":["../../src/services/connect-server.ts"],"sourcesContent":["import { isHtmlNavigation } from \"@powerhousedao/shared/connect/origin-placeholder\";\nimport { existsSync } from \"node:fs\";\nimport {\n createServer,\n request as httpRequest,\n type IncomingMessage,\n type Server,\n type ServerResponse,\n} from \"node:http\";\nimport { request as httpsRequest } from \"node:https\";\nimport net, { type Socket } from \"node:net\";\nimport path from \"node:path\";\nimport type { Duplex } from \"node:stream\";\nimport tls from \"node:tls\";\nimport sirv from \"sirv\";\nimport type { ConnectPreviewArgs } from \"./classic-args.js\";\nimport {\n assertConnectBuild,\n cacheHeaders,\n connectBaseOf,\n isProxiedRequest,\n overrideFromEnv,\n precompressedAssets,\n serveOverrideStep,\n shellSwapFor,\n type ConnectMiddleware,\n type ConnectServeOverride,\n} from \"./connect-serve.js\";\n\n/**\n * Serves a built Connect with what a running app has anyway. The other way to\n * serve it is `vite preview`, which brings a bundler, Tailwind and Babel to a\n * job that reads files from a folder. This does what that does for a build,\n * step for step, apart from compressing responses: this server's traffic stays\n * on the computer, where compressing is only slower.\n */\n\nexport interface ConnectServer {\n resolvedUrls: { local: string[]; network: string[] };\n close(): Promise<void>;\n}\n\n/** The hosts a browser may reach this by: a rebinding attack needs a name. */\nexport function isAllowedHost(hostHeader: string | undefined): boolean {\n if (!hostHeader) return false;\n const name = hostHeader.replace(/:\\d+$/, \"\").replace(/^\\[|\\]$/g, \"\");\n return (\n name === \"localhost\" || name.endsWith(\".localhost\") || net.isIP(name) !== 0\n );\n}\n\nconst hostCheck: ConnectMiddleware = (req, res, next) => {\n if (isAllowedHost(req.headers.host)) {\n next();\n return;\n }\n res.writeHead(403, { \"content-type\": \"text/plain\" });\n res.end(`This host (${req.headers.host}) is not allowed.`);\n};\n\nconst openCors: ConnectMiddleware = (req, res, next) => {\n res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n if (req.method !== \"OPTIONS\") {\n next();\n return;\n }\n res.setHeader(\n \"Access-Control-Allow-Methods\",\n \"GET,HEAD,PUT,PATCH,POST,DELETE\",\n );\n const asked = req.headers[\"access-control-request-headers\"];\n if (asked) {\n res.setHeader(\"Access-Control-Allow-Headers\", asked);\n res.setHeader(\"Vary\", \"Access-Control-Request-Headers\");\n }\n res.writeHead(204, { \"Content-Length\": \"0\" });\n res.end();\n};\n\n/** Requests outside the base: the root goes to it, anything else is a 404. */\nfunction baseStep(base: string): ConnectMiddleware {\n return (req, res, next) => {\n if (base === \"/\") {\n next();\n return;\n }\n const url = req.url ?? \"/\";\n const pathname = url.split(\"?\")[0];\n if (pathname.startsWith(base)) {\n req.url = `/${url.slice(base.length)}`;\n next();\n return;\n }\n if (pathname === \"/\" || pathname === \"/index.html\") {\n res.writeHead(302, { Location: base + url.slice(pathname.length) });\n res.end();\n return;\n }\n res.writeHead(404, { \"content-type\": \"text/plain\" });\n res.end(`This server's base is ${base}.`);\n };\n}\n\n/** Sends the switchboard's paths to it, leaving the Host header as the browser\n * sent it: the switchboard builds the URLs it hands out from that. */\nfunction proxyStep(target: URL): ConnectMiddleware {\n const request = target.protocol === \"https:\" ? httpsRequest : httpRequest;\n return (req, res, next) => {\n const url = req.url ?? \"/\";\n if (!isProxiedRequest(url.split(\"?\")[0], req.headers.accept)) {\n next();\n return;\n }\n const upstream = request(\n {\n hostname: target.hostname,\n port: target.port,\n method: req.method,\n path: url,\n headers: req.headers,\n },\n (answer) => {\n res.writeHead(answer.statusCode ?? 502, answer.headers);\n answer.pipe(res);\n },\n );\n upstream.on(\"error\", () => {\n if (!res.headersSent) res.writeHead(502);\n res.end();\n });\n // A subscription stream ends when its reader leaves.\n res.on(\"close\", () => upstream.destroy());\n req.pipe(upstream);\n };\n}\n\nfunction upgradeRequestOf(req: IncomingMessage): string {\n const headers: string[] = [];\n for (let i = 0; i < req.rawHeaders.length; i += 2) {\n headers.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);\n }\n return `${req.method} ${req.url} HTTP/${req.httpVersion}\\r\\n${headers.join(\"\\r\\n\")}\\r\\n\\r\\n`;\n}\n\n/** GraphQL's subscriptions. Its one websocket path, as a socket joined to the\n * same socket at the switchboard: everything past the handshake is theirs. */\nfunction proxyUpgrade(\n target: URL,\n req: IncomingMessage,\n socket: Duplex,\n head: Buffer,\n) {\n const pathname = (req.url ?? \"/\").split(\"?\")[0];\n const isGraphql = pathname === \"/graphql\" || pathname.startsWith(\"/graphql/\");\n if (!isGraphql || !isAllowedHost(req.headers.host)) {\n socket.destroy();\n return;\n }\n const secure = target.protocol === \"https:\";\n const port = Number(target.port || (secure ? 443 : 80));\n const upstream: Socket = secure\n ? tls.connect(port, target.hostname, { servername: target.hostname })\n : net.connect(port, target.hostname);\n const drop = () => {\n upstream.destroy();\n socket.destroy();\n };\n upstream.once(secure ? \"secureConnect\" : \"connect\", () => {\n upstream.write(upgradeRequestOf(req));\n if (head.length > 0) upstream.write(head);\n upstream.pipe(socket);\n socket.pipe(upstream);\n });\n upstream.on(\"error\", drop);\n upstream.on(\"close\", drop);\n socket.on(\"error\", drop);\n socket.on(\"close\", drop);\n}\n\n/** The file for a request: as it is, or for a page, the app that routes it. */\nfunction assetsStep(outDir: string): ConnectMiddleware {\n const serve = sirv(outDir, { dev: true, etag: true, extensions: [] });\n return (req, res, next) => {\n serve(req, res, () => {\n const accept = req.headers.accept;\n const wantsPage =\n (req.method === \"GET\" || req.method === \"HEAD\") &&\n (!accept || isHtmlNavigation(accept) || accept.includes(\"*/*\"));\n if (!wantsPage || !existsSync(path.join(outDir, \"index.html\"))) {\n next();\n return;\n }\n req.url = \"/index.html\";\n serve(req, res, next);\n });\n };\n}\n\nfunction inOrder(steps: readonly ConnectMiddleware[]) {\n return (req: IncomingMessage, res: ServerResponse) => {\n const run = (index: number) => {\n const step = steps.at(index);\n if (index >= steps.length || !step) {\n res.writeHead(404);\n res.end();\n return;\n }\n step(req, res, () => run(index + 1));\n };\n run(0);\n };\n}\n\n/** Binds `port`, or under no `strictPort` the next one free. */\nfunction listen(\n server: Server,\n port: number,\n host: string | undefined,\n strictPort: boolean | undefined,\n): Promise<number> {\n return new Promise((resolve, reject) => {\n const attempt = (candidate: number) => {\n const onError = (error: NodeJS.ErrnoException) => {\n server.off(\"listening\", onListening);\n if (error.code !== \"EADDRINUSE\") reject(error);\n else if (strictPort) {\n reject(new Error(`Port ${candidate} is already in use`));\n } else attempt(candidate + 1);\n };\n const onListening = () => {\n server.off(\"error\", onError);\n resolve(candidate);\n };\n server.once(\"error\", onError);\n server.once(\"listening\", onListening);\n server.listen(candidate, host);\n };\n attempt(port);\n });\n}\n\nexport async function runConnectServer(\n args: ConnectPreviewArgs,\n serveOverride?: ConnectServeOverride,\n dirname = process.cwd(),\n {\n proxy,\n }: {\n /** The switchboard origin whose paths this server proxies (runner.proxy). */\n proxy?: string;\n } = {},\n): Promise<ConnectServer> {\n serveOverride ??= overrideFromEnv();\n const outDir = path.resolve(dirname, args.outDir);\n assertConnectBuild(args.outDir, outDir, dirname);\n const base = connectBaseOf(args, outDir, dirname);\n const target = proxy ? new URL(new URL(proxy).origin) : undefined;\n\n const server = createServer(\n inOrder([\n cacheHeaders(outDir, base),\n precompressedAssets(outDir, base),\n ...(serveOverride\n ? [\n serveOverrideStep(\n outDir,\n serveOverride,\n base,\n shellSwapFor(outDir, serveOverride, base),\n target !== undefined,\n ),\n ]\n : []),\n openCors,\n hostCheck,\n ...(target ? [proxyStep(target)] : []),\n baseStep(base),\n assetsStep(outDir),\n ]),\n );\n\n // Past an upgrade Node stops tracking the socket, so this has to.\n const upgraded = new Set<Duplex>();\n if (target) {\n server.on(\"upgrade\", (req, socket, head) => {\n upgraded.add(socket);\n socket.once(\"close\", () => upgraded.delete(socket));\n proxyUpgrade(target, req, socket, head);\n });\n }\n\n const port = await listen(server, args.port, args.host, args.strictPort);\n const shown = args.host?.includes(\":\") ? `[${args.host}]` : args.host;\n const url = `http://${shown ?? \"localhost\"}:${port}${base}`;\n if (args.printUrls) console.log(` ➜ Local: ${url}`);\n return {\n resolvedUrls: { local: [url], network: [] },\n close: () =>\n new Promise((resolve, reject) => {\n server.close((error) => (error ? reject(error) : resolve()));\n server.closeAllConnections();\n for (const socket of upgraded) socket.destroy();\n }),\n };\n}\n"],"names":["request","httpsRequest","httpRequest"],"mappings":"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","debug_id":"5e8d8724-35d4-59a8-b0be-fd13032d99f5"}
1
+ {"version":3,"file":"connect-server.mjs","sources":["../../src/services/connect-server.ts"],"sourcesContent":["import { isHtmlNavigation } from \"@powerhousedao/shared/connect/origin-placeholder\";\nimport { existsSync } from \"node:fs\";\nimport {\n createServer,\n request as httpRequest,\n type IncomingMessage,\n type Server,\n type ServerResponse,\n} from \"node:http\";\nimport { request as httpsRequest } from \"node:https\";\nimport net, { type Socket } from \"node:net\";\nimport path from \"node:path\";\nimport type { Duplex } from \"node:stream\";\nimport tls from \"node:tls\";\nimport sirv from \"sirv\";\nimport type { ConnectPreviewArgs } from \"./classic-args.js\";\nimport {\n assertConnectBuild,\n cacheHeaders,\n connectBaseOf,\n isProxiedRequest,\n overrideFromEnv,\n precompressedAssets,\n serveOverrideStep,\n shellSwapFor,\n type ConnectMiddleware,\n type ConnectServeOverride,\n} from \"./connect-serve.js\";\n\n/**\n * Serves a built Connect with what a running app has anyway. The other way to\n * serve it is `vite preview`, which brings a bundler, Tailwind and Babel to a\n * job that reads files from a folder. This does what that does for a build,\n * step for step, apart from compressing responses: this server's traffic stays\n * on the computer, where compressing is only slower.\n */\n\nexport interface ConnectServer {\n resolvedUrls: { local: string[]; network: string[] };\n close(): Promise<void>;\n}\n\n/** The public name a deployment serves this under, in the variable\n * `vite preview` reads for the same purpose. */\nconst ADDITIONAL_HOST_ENV = \"__VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS\";\n\n/** The hosts a browser may reach this by: a rebinding attack needs a name.\n * This computer's own names, and the one name the environment adds. */\nexport function isAllowedHost(\n hostHeader: string | undefined,\n env: Record<string, string | undefined> = process.env,\n): boolean {\n if (!hostHeader) return false;\n const name = hostHeader.replace(/:\\d+$/, \"\").replace(/^\\[|\\]$/g, \"\");\n if (\n name === \"localhost\" ||\n name.endsWith(\".localhost\") ||\n net.isIP(name) !== 0\n ) {\n return true;\n }\n const added = env[ADDITIONAL_HOST_ENV]?.trim().toLowerCase();\n if (!added) return false;\n const asked = name.toLowerCase();\n // as vite: a leading dot takes the domain and its subdomains\n return added.startsWith(\".\")\n ? asked === added.slice(1) || asked.endsWith(added)\n : asked === added;\n}\n\nconst hostCheck: ConnectMiddleware = (req, res, next) => {\n if (isAllowedHost(req.headers.host)) {\n next();\n return;\n }\n res.writeHead(403, { \"content-type\": \"text/plain\" });\n res.end(`This host (${req.headers.host}) is not allowed.`);\n};\n\nconst openCors: ConnectMiddleware = (req, res, next) => {\n res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n if (req.method !== \"OPTIONS\") {\n next();\n return;\n }\n res.setHeader(\n \"Access-Control-Allow-Methods\",\n \"GET,HEAD,PUT,PATCH,POST,DELETE\",\n );\n const asked = req.headers[\"access-control-request-headers\"];\n if (asked) {\n res.setHeader(\"Access-Control-Allow-Headers\", asked);\n res.setHeader(\"Vary\", \"Access-Control-Request-Headers\");\n }\n res.writeHead(204, { \"Content-Length\": \"0\" });\n res.end();\n};\n\n/** Requests outside the base: the root goes to it, anything else is a 404. */\nfunction baseStep(base: string): ConnectMiddleware {\n return (req, res, next) => {\n if (base === \"/\") {\n next();\n return;\n }\n const url = req.url ?? \"/\";\n const pathname = url.split(\"?\")[0];\n if (pathname.startsWith(base)) {\n req.url = `/${url.slice(base.length)}`;\n next();\n return;\n }\n if (pathname === \"/\" || pathname === \"/index.html\") {\n res.writeHead(302, { Location: base + url.slice(pathname.length) });\n res.end();\n return;\n }\n res.writeHead(404, { \"content-type\": \"text/plain\" });\n res.end(`This server's base is ${base}.`);\n };\n}\n\n/** Sends the switchboard's paths to it, leaving the Host header as the browser\n * sent it: the switchboard builds the URLs it hands out from that. */\nfunction proxyStep(target: URL): ConnectMiddleware {\n const request = target.protocol === \"https:\" ? httpsRequest : httpRequest;\n return (req, res, next) => {\n const url = req.url ?? \"/\";\n if (!isProxiedRequest(url.split(\"?\")[0], req.headers.accept)) {\n next();\n return;\n }\n const upstream = request(\n {\n hostname: target.hostname,\n port: target.port,\n method: req.method,\n path: url,\n headers: req.headers,\n },\n (answer) => {\n res.writeHead(answer.statusCode ?? 502, answer.headers);\n answer.pipe(res);\n },\n );\n upstream.on(\"error\", () => {\n if (!res.headersSent) res.writeHead(502);\n res.end();\n });\n // A subscription stream ends when its reader leaves.\n res.on(\"close\", () => upstream.destroy());\n req.pipe(upstream);\n };\n}\n\nfunction upgradeRequestOf(req: IncomingMessage): string {\n const headers: string[] = [];\n for (let i = 0; i < req.rawHeaders.length; i += 2) {\n headers.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);\n }\n return `${req.method} ${req.url} HTTP/${req.httpVersion}\\r\\n${headers.join(\"\\r\\n\")}\\r\\n\\r\\n`;\n}\n\n/** GraphQL's subscriptions. Its one websocket path, as a socket joined to the\n * same socket at the switchboard: everything past the handshake is theirs. */\nfunction proxyUpgrade(\n target: URL,\n req: IncomingMessage,\n socket: Duplex,\n head: Buffer,\n) {\n const pathname = (req.url ?? \"/\").split(\"?\")[0];\n const isGraphql = pathname === \"/graphql\" || pathname.startsWith(\"/graphql/\");\n if (!isGraphql || !isAllowedHost(req.headers.host)) {\n socket.destroy();\n return;\n }\n const secure = target.protocol === \"https:\";\n const port = Number(target.port || (secure ? 443 : 80));\n const upstream: Socket = secure\n ? tls.connect(port, target.hostname, { servername: target.hostname })\n : net.connect(port, target.hostname);\n const drop = () => {\n upstream.destroy();\n socket.destroy();\n };\n upstream.once(secure ? \"secureConnect\" : \"connect\", () => {\n upstream.write(upgradeRequestOf(req));\n if (head.length > 0) upstream.write(head);\n upstream.pipe(socket);\n socket.pipe(upstream);\n });\n upstream.on(\"error\", drop);\n upstream.on(\"close\", drop);\n socket.on(\"error\", drop);\n socket.on(\"close\", drop);\n}\n\n/** The file for a request: as it is, or for a page, the app that routes it. */\nfunction assetsStep(outDir: string): ConnectMiddleware {\n const serve = sirv(outDir, { dev: true, etag: true, extensions: [] });\n return (req, res, next) => {\n serve(req, res, () => {\n const accept = req.headers.accept;\n const wantsPage =\n (req.method === \"GET\" || req.method === \"HEAD\") &&\n (!accept || isHtmlNavigation(accept) || accept.includes(\"*/*\"));\n if (!wantsPage || !existsSync(path.join(outDir, \"index.html\"))) {\n next();\n return;\n }\n req.url = \"/index.html\";\n serve(req, res, next);\n });\n };\n}\n\nfunction inOrder(steps: readonly ConnectMiddleware[]) {\n return (req: IncomingMessage, res: ServerResponse) => {\n const run = (index: number) => {\n const step = steps.at(index);\n if (index >= steps.length || !step) {\n res.writeHead(404);\n res.end();\n return;\n }\n step(req, res, () => run(index + 1));\n };\n run(0);\n };\n}\n\n/** Binds `port`, or under no `strictPort` the next one free. */\nfunction listen(\n server: Server,\n port: number,\n host: string | undefined,\n strictPort: boolean | undefined,\n): Promise<number> {\n return new Promise((resolve, reject) => {\n const attempt = (candidate: number) => {\n const onError = (error: NodeJS.ErrnoException) => {\n server.off(\"listening\", onListening);\n if (error.code !== \"EADDRINUSE\") reject(error);\n else if (strictPort) {\n reject(new Error(`Port ${candidate} is already in use`));\n } else attempt(candidate + 1);\n };\n const onListening = () => {\n server.off(\"error\", onError);\n resolve(candidate);\n };\n server.once(\"error\", onError);\n server.once(\"listening\", onListening);\n server.listen(candidate, host);\n };\n attempt(port);\n });\n}\n\nexport async function runConnectServer(\n args: ConnectPreviewArgs,\n serveOverride?: ConnectServeOverride,\n dirname = process.cwd(),\n {\n proxy,\n }: {\n /** The switchboard origin whose paths this server proxies (runner.proxy). */\n proxy?: string;\n } = {},\n): Promise<ConnectServer> {\n serveOverride ??= overrideFromEnv();\n const outDir = path.resolve(dirname, args.outDir);\n assertConnectBuild(args.outDir, outDir, dirname);\n const base = connectBaseOf(args, outDir, dirname);\n const target = proxy ? new URL(new URL(proxy).origin) : undefined;\n\n const server = createServer(\n inOrder([\n cacheHeaders(outDir, base),\n precompressedAssets(outDir, base),\n ...(serveOverride\n ? [\n serveOverrideStep(\n outDir,\n serveOverride,\n base,\n shellSwapFor(outDir, serveOverride, base),\n target !== undefined,\n ),\n ]\n : []),\n openCors,\n hostCheck,\n ...(target ? [proxyStep(target)] : []),\n baseStep(base),\n assetsStep(outDir),\n ]),\n );\n\n // Past an upgrade Node stops tracking the socket, so this has to.\n const upgraded = new Set<Duplex>();\n if (target) {\n server.on(\"upgrade\", (req, socket, head) => {\n upgraded.add(socket);\n socket.once(\"close\", () => upgraded.delete(socket));\n proxyUpgrade(target, req, socket, head);\n });\n }\n\n const port = await listen(server, args.port, args.host, args.strictPort);\n const shown = args.host?.includes(\":\") ? `[${args.host}]` : args.host;\n const url = `http://${shown ?? \"localhost\"}:${port}${base}`;\n if (args.printUrls) console.log(` ➜ Local: ${url}`);\n return {\n resolvedUrls: { local: [url], network: [] },\n close: () =>\n new Promise((resolve, reject) => {\n server.close((error) => (error ? reject(error) : resolve()));\n server.closeAllConnections();\n for (const socket of upgraded) socket.destroy();\n }),\n };\n}\n"],"names":["request","httpsRequest","httpRequest"],"mappings":"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","debug_id":"033dc401-9c8e-5a4c-804a-1bd41290dfa9"}
@@ -4,6 +4,8 @@ export interface StartRunArgs {
4
4
  verb?: string;
5
5
  projectRoot?: string;
6
6
  debug?: boolean;
7
+ /** What follows `ph run <host> [verb]`: the runner's own arguments. */
8
+ argv?: string[];
7
9
  }
8
10
  /**
9
11
  * `ph run <host> [verb]`: dispatch the verb (default `run`) of the host's
@@ -16,12 +18,16 @@ export interface StartRunArgs {
16
18
  * the producers' live run records, `$env` from this process, the
17
19
  * `${userData}` sugar), resolved validation, then the verb with the parsed
18
20
  * host. A compound runner gets its declared host: its members resolve their
19
- * own tokens as they start.
21
+ * own tokens as they start. Ahead of all of it, observability loads when the
22
+ * env configures it (services/observability.ts).
20
23
  *
21
24
  * A reactor runner that exports `outputsSchema` has its handle's outputs
22
25
  * published in a v2 `.ph/run/<name>.json` record once ready; this is the only
23
26
  * standalone writer (mastra included). Compounds write their own record with
24
27
  * the members in it; one-shot verbs (`build`) return nothing and write none.
28
+ *
29
+ * Store verbs (`migrate`, `migrate-status`, `reset`) resolve like `run`, so
30
+ * they address the stores `run` opens, but take no lock and write no record.
25
31
  */
26
32
  export declare function startRun(args: StartRunArgs): Promise<unknown>;
27
33
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"start-run.d.mts","names":[],"sources":["../../../src/services/run/start-run.ts"],"mappings":";iBAuBiB;EACf;EACA;EACA;EACA;;;;;;;;;;;;;;;;;;;;wBAqBoB,SAAS,MAAM,eAAe"}
1
+ {"version":3,"file":"start-run.d.mts","names":[],"sources":["../../../src/services/run/start-run.ts"],"mappings":";iBA2BiB;EACf;EACA;EACA;EACA;;EAEA;;;;;;;;;;;;;;;;;;;;;;;;wBAyBoB,SAAS,MAAM,eAAe"}
@@ -1,4 +1,4 @@
1
- import { t as startRun } from "../../start-run-DWn2cVyi.mjs";
1
+ import { t as startRun } from "../../start-run-DUfxuOde.mjs";
2
2
  export { startRun };
3
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4d9babd5-02e7-5e34-b46e-b34d1e0350b5")}catch(e){}}();
4
- //# debugId=4d9babd5-02e7-5e34-b46e-b34d1e0350b5
3
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="080f07a4-5dc5-59f8-8354-a5d7ef85959a")}catch(e){}}();
4
+ //# debugId=080f07a4-5dc5-59f8-8354-a5d7ef85959a
@@ -1,4 +1,4 @@
1
- import { n as SwitchboardArgs } from "../classic-args-Dm0_3O5p.mjs";
1
+ import { n as SwitchboardArgs } from "../classic-args-BKI4gEVD.mjs";
2
2
  import { ResolvedPlugin } from "@powerhousedao/host-core";
3
3
  import { SwitchboardConfigInput } from "@powerhousedao/switchboard/config";
4
4
  import { addDefaultDrive } from "@powerhousedao/switchboard/utils";
@@ -1,6 +1,6 @@
1
1
 
2
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a803084f-2032-5068-a22f-4875a78cd073")}catch(e){}}();
3
- import { ONE_SHOT_VERBS, clearRunRecord, getVerb, isSchemaLike, loadHost, loadProducers, outputRefsOf, probeRun, processResolveEnv, producerOutputsSchemas, readProjectName, readRunRecord, resolveHostOutputs, resolveRunnerModule, runRecordOutputSource, toStartedHandle, validateDeclaredHost, validateHost, writeRunRecord } from "@powerhousedao/host-core";
2
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="36fe1082-219d-5821-8060-2d3182e61f3b")}catch(e){}}();
3
+ import { ONE_SHOT_VERBS, RunnerError, STORE_VERBS, checkRunnerArgv, clearRunRecord, emptyMaps, getVerb, isSchemaLike, loadHost, loadProducers, outputRefsOf, probeRun, processResolveEnv, producerOutputsSchemas, readProjectName, readRunRecord, resolveHostOutputs, resolveRunnerModule, runRecordOutputSource, toStartedHandle, validateDeclaredHost, validateHost, writeRunRecord } from "@powerhousedao/host-core";
4
4
  //#region src/services/run/start-run.ts
5
5
  /**
6
6
  * `ph run <host> [verb]`: dispatch the verb (default `run`) of the host's
@@ -13,22 +13,32 @@ import { ONE_SHOT_VERBS, clearRunRecord, getVerb, isSchemaLike, loadHost, loadPr
13
13
  * the producers' live run records, `$env` from this process, the
14
14
  * `${userData}` sugar), resolved validation, then the verb with the parsed
15
15
  * host. A compound runner gets its declared host: its members resolve their
16
- * own tokens as they start.
16
+ * own tokens as they start. Ahead of all of it, observability loads when the
17
+ * env configures it (services/observability.ts).
17
18
  *
18
19
  * A reactor runner that exports `outputsSchema` has its handle's outputs
19
20
  * published in a v2 `.ph/run/<name>.json` record once ready; this is the only
20
21
  * standalone writer (mastra included). Compounds write their own record with
21
22
  * the members in it; one-shot verbs (`build`) return nothing and write none.
23
+ *
24
+ * Store verbs (`migrate`, `migrate-status`, `reset`) resolve like `run`, so
25
+ * they address the stores `run` opens, but take no lock and write no record.
22
26
  */
23
27
  async function startRun(args) {
28
+ if (!ONE_SHOT_VERBS.has(args.verb ?? "run")) {
29
+ const { loadObservability } = await import("./observability-CrfdAtHw.mjs");
30
+ await loadObservability();
31
+ }
24
32
  if (ONE_SHOT_VERBS.has(args.verb ?? "run")) process.env.NODE_ENV ??= "production";
25
33
  const projectRoot = args.projectRoot ?? process.cwd();
26
34
  const loaded = await loadHost(projectRoot, args.host);
27
- const { warnSupersededConfigKeys } = await import("./superseded-config-CpHrCuNq.mjs");
35
+ const { warnSupersededConfigKeys } = await import("./superseded-config-bNn_JyUj.mjs");
28
36
  warnSupersededConfigKeys(projectRoot);
29
37
  const specifier = loaded.host.runner.module;
30
38
  const runner = await resolveRunnerModule(projectRoot, specifier);
31
39
  const verb = args.verb ?? "run";
40
+ const storeVerb = STORE_VERBS.has(verb);
41
+ if (storeVerb && runner.kind === "compound") throw new RunnerError(`${loaded.host.name} is a compound host, and "${verb}" works on the stores of one reactor host.`, `Run it on the member that has them, e.g. \`ph run switchboard ${verb}\`.`);
32
42
  const fn = getVerb(runner, specifier, verb);
33
43
  const file = loaded.file;
34
44
  if (args.debug) console.log({
@@ -38,22 +48,35 @@ async function startRun(args) {
38
48
  });
39
49
  if (runner.kind === "compound") {
40
50
  validateDeclaredHost(runner, specifier, loaded.host, file);
41
- return fn(validateHost(runner, specifier, loaded.host, file, { tokens: "allow" }), {
51
+ const host = validateHost(runner, specifier, loaded.host, file, { tokens: "allow" });
52
+ const argv = args.argv ?? [];
53
+ return fn(host, {
42
54
  projectRoot,
43
55
  verb,
44
- env: process.env
56
+ env: process.env,
57
+ ...argv.length > 0 ? { argv } : {}
45
58
  });
46
59
  }
60
+ const argv = checkRunnerArgv(args.argv ?? [], {
61
+ host: args.host,
62
+ runner: specifier,
63
+ schema: runner.argsSchema
64
+ });
65
+ const ctx = {
66
+ projectRoot,
67
+ verb,
68
+ env: process.env,
69
+ ...argv.length > 0 ? { argv } : {}
70
+ };
47
71
  const projectName = readProjectName(projectRoot);
48
72
  const producers = await loadProducers(projectRoot, outputRefsOf(loaded.host));
49
73
  validateDeclaredHost(runner, specifier, loaded.host, file, { outputsSchemaOf: producerOutputsSchemas(producers) });
50
- if (ONE_SHOT_VERBS.has(verb)) return fn(validateHost(runner, specifier, loaded.host, file, { tokens: "allow" }), {
51
- projectRoot,
52
- verb,
53
- env: process.env
54
- });
74
+ if (ONE_SHOT_VERBS.has(verb)) {
75
+ const host = validateHost(runner, specifier, loaded.host, file, { tokens: "allow" });
76
+ return fn(emptyMaps(host, loaded.host), ctx);
77
+ }
55
78
  const publishes = isSchemaLike(runner.outputsSchema);
56
- if (publishes) assertNotRunning(projectRoot, loaded.host.name, projectName);
79
+ if (publishes && (!storeVerb || verb === "reset")) assertNotRunning(projectRoot, loaded.host.name, projectName);
57
80
  const resolved = resolveHostOutputs(loaded.host, {
58
81
  outputs: runRecordOutputSource(projectRoot, {
59
82
  consumer: args.host,
@@ -63,11 +86,7 @@ async function startRun(args) {
63
86
  ...processResolveEnv(projectRoot),
64
87
  where: `hosts/${args.host}/host.js`
65
88
  });
66
- const result = await fn(validateHost(runner, specifier, resolved, file), {
67
- projectRoot,
68
- verb,
69
- env: process.env
70
- });
89
+ const result = await fn(validateHost(runner, specifier, resolved, file), ctx);
71
90
  if (publishes && result !== void 0 && result !== null) await publishOutputs(runner, result, {
72
91
  projectRoot,
73
92
  projectName,
@@ -121,5 +140,5 @@ async function publishOutputs(runner, result, target) {
121
140
  //#endregion
122
141
  export { startRun as t };
123
142
 
124
- //# sourceMappingURL=start-run-DWn2cVyi.mjs.map
125
- //# debugId=a803084f-2032-5068-a22f-4875a78cd073
143
+ //# sourceMappingURL=start-run-DUfxuOde.mjs.map
144
+ //# debugId=36fe1082-219d-5821-8060-2d3182e61f3b
@@ -0,0 +1 @@
1
+ {"version":3,"file":"start-run-DUfxuOde.mjs","sources":["../src/services/run/start-run.ts"],"sourcesContent":["import {\n checkRunnerArgv,\n clearRunRecord,\n emptyMaps,\n getVerb,\n isSchemaLike,\n loadHost,\n loadProducers,\n ONE_SHOT_VERBS,\n outputRefsOf,\n probeRun,\n processResolveEnv,\n producerOutputsSchemas,\n readProjectName,\n readRunRecord,\n resolveHostOutputs,\n resolveRunnerModule,\n runRecordOutputSource,\n RunnerError,\n STORE_VERBS,\n toStartedHandle,\n validateDeclaredHost,\n validateHost,\n writeRunRecord,\n type RunnerModule,\n} from \"@powerhousedao/host-core\";\n\nexport interface StartRunArgs {\n host: string;\n verb?: string;\n projectRoot?: string;\n debug?: boolean;\n /** What follows `ph run <host> [verb]`: the runner's own arguments. */\n argv?: string[];\n}\n\n/**\n * `ph run <host> [verb]`: dispatch the verb (default `run`) of the host's\n * declared runner. There is deliberately no type→runner registry — what a\n * host does is written in its own file.\n *\n * The pipeline (typed-host-configs 3.5): declared validation (token shapes,\n * `$output` paths against the producers' outputsSchemas, the runner's\n * declaredHostSchema), the live-instance lock, resolution (`$output` from\n * the producers' live run records, `$env` from this process, the\n * `${userData}` sugar), resolved validation, then the verb with the parsed\n * host. A compound runner gets its declared host: its members resolve their\n * own tokens as they start. Ahead of all of it, observability loads when the\n * env configures it (services/observability.ts).\n *\n * A reactor runner that exports `outputsSchema` has its handle's outputs\n * published in a v2 `.ph/run/<name>.json` record once ready; this is the only\n * standalone writer (mastra included). Compounds write their own record with\n * the members in it; one-shot verbs (`build`) return nothing and write none.\n *\n * Store verbs (`migrate`, `migrate-status`, `reset`) resolve like `run`, so\n * they address the stores `run` opens, but take no lock and write no record.\n */\nexport async function startRun(args: StartRunArgs): Promise<unknown> {\n // Before the host loads: loading it can import its runner and plugins, and\n // OpenTelemetry only patches http/express/pg/graphql that load after it.\n // Decided on the env, since reading the host is what must come second.\n if (!ONE_SHOT_VERBS.has(args.verb ?? \"run\")) {\n const { loadObservability } = await import(\"../observability.js\");\n await loadObservability();\n }\n // Loading a host loads its plugins, and React settles on its development or\n // production build the first time it's loaded. `vite build` sets NODE_ENV only\n // after that, so a build would run one half of React with the other half's\n // renderer (TypeError: dispatcher.getOwner is not a function).\n if (ONE_SHOT_VERBS.has(args.verb ?? \"run\")) {\n process.env.NODE_ENV ??= \"production\";\n }\n const projectRoot = args.projectRoot ?? process.cwd();\n const loaded = await loadHost(projectRoot, args.host);\n const { warnSupersededConfigKeys } = await import(\"./superseded-config.js\");\n warnSupersededConfigKeys(projectRoot);\n const specifier = loaded.host.runner.module;\n const runner = await resolveRunnerModule(projectRoot, specifier);\n const verb = args.verb ?? \"run\";\n const storeVerb = STORE_VERBS.has(verb);\n if (storeVerb && runner.kind === \"compound\") {\n throw new RunnerError(\n `${loaded.host.name} is a compound host, and \"${verb}\" works on the stores of one reactor host.`,\n `Run it on the member that has them, e.g. \\`ph run switchboard ${verb}\\`.`,\n );\n }\n const fn = getVerb(runner, specifier, verb);\n const file = loaded.file;\n if (args.debug) {\n console.log({ host: loaded.host.name, runner: specifier, verb });\n }\n\n if (runner.kind === \"compound\") {\n validateDeclaredHost(runner, specifier, loaded.host, file);\n const host = validateHost(runner, specifier, loaded.host, file, {\n tokens: \"allow\",\n });\n // Unchecked here: the compound hands each member the ones it accepts.\n const argv = args.argv ?? [];\n return fn(host, {\n projectRoot,\n verb,\n env: process.env,\n ...(argv.length > 0 ? { argv } : {}),\n });\n }\n\n // Before anything starts: an argument the runner does not accept fails.\n const argv = checkRunnerArgv(args.argv ?? [], {\n host: args.host,\n runner: specifier,\n schema: runner.argsSchema,\n });\n const ctx = {\n projectRoot,\n verb,\n env: process.env,\n ...(argv.length > 0 ? { argv } : {}),\n };\n const projectName = readProjectName(projectRoot);\n const producers = await loadProducers(projectRoot, outputRefsOf(loaded.host));\n validateDeclaredHost(runner, specifier, loaded.host, file, {\n outputsSchemaOf: producerOutputsSchemas(producers),\n });\n const oneShot = ONE_SHOT_VERBS.has(verb);\n if (oneShot) {\n // `build` reads no other host's outputs: no producer needs to run.\n const host = validateHost(runner, specifier, loaded.host, file, {\n tokens: \"allow\",\n });\n return fn(emptyMaps(host, loaded.host), ctx);\n }\n const publishes = isSchemaLike(runner.outputsSchema);\n // Before the verb starts anything: a second live instance would take\n // over the first one's record (and clear it on exit).\n // A store verb starts no instance: it neither takes nor trips the lock.\n // Except `reset`, which would delete the stores under a live one.\n if (publishes && (!storeVerb || verb === \"reset\")) {\n assertNotRunning(projectRoot, loaded.host.name, projectName);\n }\n const resolved = resolveHostOutputs(loaded.host, {\n outputs: runRecordOutputSource(projectRoot, {\n consumer: args.host,\n producers,\n projectName,\n }),\n ...processResolveEnv(projectRoot),\n where: `hosts/${args.host}/host.js`,\n });\n const host = validateHost(runner, specifier, resolved, file);\n const result = await fn(host, ctx);\n if (publishes && result !== undefined && result !== null) {\n await publishOutputs(runner, result, {\n projectRoot,\n projectName,\n hostName: loaded.host.name,\n specifier,\n verb,\n });\n }\n return result;\n}\n\nfunction assertNotRunning(\n projectRoot: string,\n hostName: string,\n projectName: string,\n): void {\n const probe = probeRun(projectRoot, hostName, projectName);\n if (probe.status === \"live\" && probe.record.pid !== process.pid) {\n throw new Error(\n `${hostName} is already running for this project (pid ${probe.record.pid}). Stop it before starting another.`,\n );\n }\n if (probe.status === \"foreign\") {\n throw new Error(\n `.ph/run/${hostName}.json describes a live \"${probe.record.projectName}\", but this project is \"${projectName}\". Refusing to start a second instance.`,\n );\n }\n}\n\ninterface PublishTarget {\n projectRoot: string;\n projectName: string;\n hostName: string;\n specifier: string;\n verb: string;\n}\n\n/** Await `ready`, validate the outputs, write the v2 record and clear it on\n * exit. A handle that never gets ready or reports invalid outputs is shut\n * down before the error propagates. */\nasync function publishOutputs(\n runner: RunnerModule,\n result: unknown,\n target: PublishTarget,\n): Promise<void> {\n const where = `${target.specifier} ${target.verb}`;\n const handle = toStartedHandle(result, where);\n const name = target.projectName;\n let outputs: unknown;\n try {\n if (!isSchemaLike(runner.outputsSchema)) return;\n // Checked again after the start: an instance that started meanwhile.\n assertNotRunning(target.projectRoot, target.hostName, name);\n if (handle.ready) await handle.ready;\n const parsed = runner.outputsSchema.safeParse(handle.outputs);\n if (!parsed.success) {\n const issues = parsed.error.issues\n .map(\n (issue) =>\n ` - ${issue.path.map(String).join(\".\") || \"<root>\"}: ${issue.message}`,\n )\n .join(\"\\n\");\n throw new Error(\n `${where} reported outputs that fail its outputsSchema:\\n${issues}`,\n );\n }\n outputs = parsed.data;\n } catch (error) {\n await handle.shutdown?.();\n throw error;\n }\n\n writeRunRecord(target.projectRoot, {\n version: 2,\n host: target.hostName,\n projectName: name,\n kind: \"reactor\",\n verb: target.verb,\n pid: process.pid,\n startedAt: new Date().toISOString(),\n outputs: outputs as Record<string, unknown>,\n });\n // No SIGINT/SIGTERM handler: the switchboard reactor's own handler kills\n // the reactor before draining the api, and a parallel shutdown() would\n // break that order. Without an exit event the record keeps a dead pid,\n // which probeRun reports as stale.\n process.on(\"exit\", () => {\n if (readRunRecord(target.projectRoot, target.hostName)?.pid === process.pid)\n clearRunRecord(target.projectRoot, target.hostName);\n });\n}\n"],"names":[],"mappings":"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","debug_id":"36fe1082-219d-5821-8060-2d3182e61f3b"}
@@ -0,0 +1,31 @@
1
+
2
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="bc13d92d-3dff-51bc-ae9d-e4671f1f4495")}catch(e){}}();
3
+ import { DEPRECATIONS_REMOVED_IN, formatDeprecation, presentConfigKeys, supersededConfigKeys } from "@powerhousedao/shared/clis/deprecations";
4
+ import path from "node:path";
5
+ import fs from "node:fs";
6
+ //#region src/services/run/superseded-config.ts
7
+ /**
8
+ * P2.7: with hosts/ active, the powerhouse.config.json keys of the shared
9
+ * `supersededConfigKeys` table are superseded by host.js structure and the
10
+ * run path ignores them; each present key warns ONCE per run, naming its new
11
+ * home and the release that refuses it.
12
+ */
13
+ /** Warn once per run for each superseded key present in the project config.
14
+ * Returns the warned keys (for tests). Never throws: a malformed config is
15
+ * the loader's problem, not the warner's. */
16
+ function warnSupersededConfigKeys(projectRoot, warn = console.warn) {
17
+ let config;
18
+ try {
19
+ config = JSON.parse(fs.readFileSync(path.join(projectRoot, "powerhouse.config.json"), "utf8"));
20
+ } catch {
21
+ return [];
22
+ }
23
+ const warned = presentConfigKeys(config, Object.keys(supersededConfigKeys));
24
+ for (const key of warned) warn(formatDeprecation(`powerhouse.config.json "${key}" is ignored by \`ph run\` and is an error in ${DEPRECATIONS_REMOVED_IN}. Set ${supersededConfigKeys[key]} and remove the key.`));
25
+ return warned;
26
+ }
27
+ //#endregion
28
+ export { warnSupersededConfigKeys };
29
+
30
+ //# sourceMappingURL=superseded-config-bNn_JyUj.mjs.map
31
+ //# debugId=bc13d92d-3dff-51bc-ae9d-e4671f1f4495
@@ -0,0 +1 @@
1
+ {"version":3,"file":"superseded-config-bNn_JyUj.mjs","sources":["../src/services/run/superseded-config.ts"],"sourcesContent":["import {\n DEPRECATIONS_REMOVED_IN,\n formatDeprecation,\n presentConfigKeys,\n supersededConfigKeys,\n} from \"@powerhousedao/shared/clis/deprecations\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * P2.7: with hosts/ active, the powerhouse.config.json keys of the shared\n * `supersededConfigKeys` table are superseded by host.js structure and the\n * run path ignores them; each present key warns ONCE per run, naming its new\n * home and the release that refuses it.\n */\n\n/** Warn once per run for each superseded key present in the project config.\n * Returns the warned keys (for tests). Never throws: a malformed config is\n * the loader's problem, not the warner's. */\nexport function warnSupersededConfigKeys(\n projectRoot: string,\n warn: (message: string) => void = console.warn,\n): string[] {\n let config: unknown;\n try {\n config = JSON.parse(\n fs.readFileSync(path.join(projectRoot, \"powerhouse.config.json\"), \"utf8\"),\n );\n } catch {\n return [];\n }\n const warned = presentConfigKeys(config, Object.keys(supersededConfigKeys));\n for (const key of warned) {\n warn(\n formatDeprecation(\n `powerhouse.config.json \"${key}\" is ignored by \\`ph run\\` and is an error in ${DEPRECATIONS_REMOVED_IN}. ` +\n `Set ${supersededConfigKeys[key]} and remove the key.`,\n ),\n );\n }\n return warned;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAmBA,SAAgB,yBACd,aACA,OAAkC,QAAQ,MAChC;CACV,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MACZ,GAAG,aAAa,KAAK,KAAK,aAAa,wBAAwB,GAAG,MAAM,CAC1E;CACF,QAAQ;EACN,OAAO,CAAC;CACV;CACA,MAAM,SAAS,kBAAkB,QAAQ,OAAO,KAAK,oBAAoB,CAAC;CAC1E,KAAK,MAAM,OAAO,QAChB,KACE,kBACE,2BAA2B,IAAI,gDAAgD,wBAAwB,QAC9F,qBAAqB,KAAK,qBACrC,CACF;CAEF,OAAO;AACT","debug_id":"bc13d92d-3dff-51bc-ae9d-e4671f1f4495"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@powerhousedao/ph-run",
3
- "version": "6.2.3-dev.98",
3
+ "version": "6.3.0-dev.1",
4
4
  "description": "Runs a project's hosts, with none of the tools that build one",
5
5
  "license": "AGPL-3.0-only",
6
6
  "type": "module",
@@ -72,13 +72,13 @@
72
72
  "dist"
73
73
  ],
74
74
  "dependencies": {
75
- "@powerhousedao/config": "6.2.3-dev.98",
76
- "@powerhousedao/host-core": "6.2.3-dev.98",
77
- "@powerhousedao/reactor": "6.2.3-dev.98",
78
- "@powerhousedao/shared": "6.2.3-dev.98",
79
- "@powerhousedao/switchboard": "6.2.3-dev.98",
75
+ "@powerhousedao/config": "6.3.0-dev.1",
76
+ "@powerhousedao/host-core": "6.3.0-dev.1",
77
+ "@powerhousedao/reactor": "6.3.0-dev.1",
78
+ "@powerhousedao/shared": "6.3.0-dev.1",
79
+ "@powerhousedao/switchboard": "6.3.0-dev.1",
80
80
  "cmd-ts": "0.15.0",
81
- "document-model": "6.2.3-dev.98",
81
+ "document-model": "6.3.0-dev.1",
82
82
  "dotenv": "16.4.7",
83
83
  "sirv": "^3.0.2",
84
84
  "zod": "^4.5.4"
@@ -1 +0,0 @@
1
- {"version":3,"file":"connect-serve-1WAi0KJL.mjs","sources":["../src/services/connect-serve.ts"],"sourcesContent":["import { getConfig } from \"@powerhousedao/config/node\";\nimport {\n DEFAULT_CONNECT_OUTDIR,\n type PHConnectRuntimeConfig,\n} from \"@powerhousedao/shared/clis\";\nimport { deepMerge, normalizeBasePath } from \"@powerhousedao/shared/connect\";\nimport {\n APP_SHELLS_FILE,\n appShellVariant,\n appShellVariantOf,\n readShellPluginsIn,\n swapAppShell,\n withShellAppName,\n type AppShells,\n} from \"@powerhousedao/shared/connect/app-shell\";\nimport {\n isHtmlNavigation,\n isSwitchboardProxyPath,\n} from \"@powerhousedao/shared/connect/origin-placeholder\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport path from \"node:path\";\nimport sirv from \"sirv\";\nimport type { ConnectPreviewArgs } from \"./classic-args.js\";\n\n/**\n * Runtime shaping for a served (built) Connect, desktop shape: the compound\n * projects the live switchboard's drive into the connect member's config, and\n * this override makes the STATIC dist serve it — the built\n * powerhouse.config.json is baked, so without this the drive injection never\n * reaches the SPA. `cspRegistrySync` additionally patches the baked CSP's\n * script-src with the runtime registry (the build bakes the CSP for the\n * registry it was built against; setting the registry at run time breaks that\n * coupling and every package import gets blocked otherwise).\n */\nexport interface ConnectServeOverride {\n connect?: PHConnectRuntimeConfig;\n cspRegistrySync?: boolean;\n /** Overrides the baked top-level packageRegistryUrl in the served config. */\n packageRegistryUrl?: string;\n}\n\n/**\n * The env contract a supervisor can drive the preview with — the same\n * variables the Docker entrypoint and clint's service manager already speak:\n * PH_CONNECT_DEFAULT_DRIVES_URL (comma-separated drive urls, injected into\n * drives.defaultDrives), PH_CONNECT_DRIVES_PRESERVE_STRATEGY, and\n * PH_CONNECT_PACKAGES_REGISTRY (runtime registry: served config + baked-CSP\n * patch). Lets `ph connect preview` replace hand-rolled static servers\n * (clint's connect-server, the ph-win sidecar) without losing injection.\n */\nexport function overrideFromEnv(\n env: Record<string, string | undefined> = process.env,\n): ConnectServeOverride | undefined {\n const drivesUrl = env.PH_CONNECT_DEFAULT_DRIVES_URL;\n const registry = env.PH_CONNECT_PACKAGES_REGISTRY;\n if (!drivesUrl && !registry) return undefined;\n const override: ConnectServeOverride = {};\n if (drivesUrl) {\n override.connect = {\n drives: {\n defaultDrives: drivesUrl\n .split(\",\")\n .map((s) => s.trim())\n .filter(Boolean)\n .map((url) => ({ url, name: null, icon: null })),\n preserveStrategy:\n env.PH_CONNECT_DRIVES_PRESERVE_STRATEGY ?? \"preserve-all\",\n },\n } as PHConnectRuntimeConfig;\n }\n if (registry) {\n override.packageRegistryUrl = registry;\n override.cspRegistrySync = true;\n }\n return override;\n}\n\nfunction mergedConfigBody(\n outDir: string,\n override: ConnectServeOverride,\n): string {\n const file = path.join(outDir, \"powerhouse.config.json\");\n const baked = existsSync(file)\n ? (JSON.parse(readFileSync(file, \"utf8\")) as Record<string, unknown>)\n : {};\n const connect = override.connect\n ? deepMerge(\n (baked.connect ?? {}) as PHConnectRuntimeConfig,\n override.connect,\n )\n : baked.connect;\n return JSON.stringify({\n ...baked,\n connect,\n ...(override.packageRegistryUrl\n ? { packageRegistryUrl: override.packageRegistryUrl }\n : {}),\n });\n}\n\n/**\n * Append the registry origin to the baked CSP's script-src. The attribute\n * value is HTML-escaped (every CSP keyword is `&#39;`-quoted, which contains a\n * semicolon), so decode before touching directives and re-escape after —\n * ported from the ph-win-desktop sidecar, which this path replaces.\n */\nexport function patchCspScriptSrc(html: string, registryUrl: string): string {\n return html.replace(\n /(<meta\\s+http-equiv=\"Content-Security-Policy\"\\s+content=\")([^\"]*)(\")/i,\n (_match, open: string, escaped: string, close: string) => {\n const policy = escaped.replace(/&amp;/g, \"&\").replace(/&#39;/g, \"'\");\n if (policy.includes(registryUrl)) return open + escaped + close;\n const patched = policy.replace(\n /script-src\\s+([^;]*)/i,\n (_directive, sources: string) =>\n `script-src ${sources.trim()} ${registryUrl}`,\n );\n const reEscaped = patched.replace(/&/g, \"&amp;\").replace(/'/g, \"&#39;\");\n return open + reEscaped + close;\n },\n );\n}\n\n// The serve base: an explicit `--base`, else the basePath the dist was built with.\nexport function resolvePreviewBase(\n argBase: string | undefined,\n outDirAbs: string,\n): string | undefined {\n if (argBase && argBase !== \"/\") return normalizeBasePath(argBase);\n try {\n const built = JSON.parse(\n readFileSync(path.join(outDirAbs, \"powerhouse.config.json\"), \"utf8\"),\n ) as { connect?: { app?: { basePath?: unknown } } };\n const basePath = built.connect?.app?.basePath;\n if (typeof basePath === \"string\" && basePath) {\n return normalizeBasePath(basePath);\n }\n } catch {\n // no readable dist config\n }\n return undefined;\n}\n\n// `pathname` relative to the deploy base (\"/\" + rest), or itself when outside it.\nexport function stripBase(pathname: string, base: string): string {\n return base !== \"/\" && pathname.startsWith(base)\n ? `/${pathname.slice(base.length)}`\n : pathname;\n}\n\n/** The steps both Connect servers run, in the order they run them. */\nexport type ConnectMiddleware = (\n req: IncomingMessage,\n res: ServerResponse,\n next: () => void,\n) => void;\n\nconst IMMUTABLE = \"public, max-age=31536000, immutable\";\n\nconst HASHED_DIRS = [\"/assets/\", \"/fonts/\", \"/__reactor_worker__/assets/\"];\n\n// Content-addressed output (hashed names, or a `v` query on the worker's), as in the nginx image.\nexport function previewCacheControl(\n pathname: string,\n search: string,\n): string | undefined {\n if (HASHED_DIRS.some((dir) => pathname.startsWith(dir))) return IMMUTABLE;\n if (pathname.startsWith(\"/__vendor__/\")) {\n return /\\/(shared-deps|import-map)\\.js(on)?$/.test(pathname)\n ? \"no-cache\"\n : IMMUTABLE;\n }\n if (pathname.startsWith(\"/__react__/\")) return IMMUTABLE;\n if (pathname.startsWith(\"/__reactor_worker__/\")) {\n return new URLSearchParams(search).has(\"v\") ? IMMUTABLE : \"no-cache\";\n }\n return undefined;\n}\n\nexport function cacheHeaders(outDir: string, base: string): ConnectMiddleware {\n return (req, res, next) => {\n const [rawPath, search = \"\"] = (req.url ?? \"/\").split(\"?\");\n const rel = stripBase(rawPath, base);\n let value = previewCacheControl(rel, search);\n // A cached 404 would outlive the next deploy.\n if (value === IMMUTABLE && !existsSync(path.join(outDir, rel))) {\n value = undefined;\n }\n if (value) res.setHeader(\"Cache-Control\", value);\n next();\n };\n}\n\ntype HtmlTransform = (html: string) => string;\n\n/** The dist's shell for the served config: its composition's variant and its app name. */\nexport function shellSwapFor(\n outDir: string,\n override: ConnectServeOverride,\n base = \"/\",\n): HtmlTransform | undefined {\n const composition = override.connect?.composition;\n const renamed = override.connect?.branding?.appName !== undefined;\n if (!composition && !renamed) return undefined;\n const file = path.join(outDir, APP_SHELLS_FILE);\n // The manifest the build copied from the Connect it used.\n const variant =\n composition && appShellVariant(composition, readShellPluginsIn(outDir));\n const shell =\n variant && existsSync(file)\n ? (JSON.parse(readFileSync(file, \"utf8\")) as AppShells)[variant]\n : undefined;\n // The name the app will title itself with: the served (baked + override) config's.\n const appName = (\n JSON.parse(mergedConfigBody(outDir, override)) as {\n connect?: { branding?: { appName?: string } };\n }\n ).connect?.branding?.appName;\n return (html) =>\n shell && appShellVariantOf(html) !== variant\n ? swapAppShell(html, shell, base, appName)\n : withShellAppName(html, appName);\n}\n\n/**\n * Whether a request on a proxying server belongs to the switchboard: its\n * paths go to the proxy, untouched, except a browser navigation under `/d/`\n * (Connect's own drive routes), as switchboardProxy splits them.\n */\nexport function isProxiedRequest(urlPath: string, accept: string | undefined) {\n if (!isSwitchboardProxyPath(urlPath)) return false;\n return !(urlPath.startsWith(\"/d/\") && isHtmlNavigation(accept));\n}\n\nexport function serveOverrideStep(\n outDir: string,\n override: ConnectServeOverride,\n base = \"/\",\n swapShell?: HtmlTransform,\n proxied = false,\n): ConnectMiddleware {\n return (req, res, next) => {\n const urlPath = stripBase((req.url ?? \"/\").split(\"?\")[0], base);\n if (urlPath === \"/powerhouse.config.json\") {\n res.writeHead(200, {\n \"content-type\": \"application/json; charset=utf-8\",\n \"cache-control\": \"no-store\",\n });\n res.end(mergedConfigBody(outDir, override));\n return;\n }\n // The switchboard's paths are the proxy's, which runs after this:\n // served the SPA shell instead, /graphql would never reach it.\n if (proxied && isProxiedRequest(urlPath, req.headers.accept)) {\n next();\n return;\n }\n // index.html and extensionless SPA routes get the CSP patch.\n const isHtml =\n urlPath === \"/\" ||\n urlPath.endsWith(\"/index.html\") ||\n !path.extname(urlPath);\n if ((override.cspRegistrySync || swapShell) && isHtml) {\n const file = path.join(outDir, \"index.html\");\n if (existsSync(file)) {\n let html = readFileSync(file, \"utf8\");\n if (override.cspRegistrySync) {\n const merged = JSON.parse(mergedConfigBody(outDir, override)) as {\n packageRegistryUrl?: string;\n };\n const registry = merged.packageRegistryUrl;\n if (registry) html = patchCspScriptSrc(html, registry);\n }\n if (swapShell) html = swapShell(html);\n res.writeHead(200, {\n \"content-type\": \"text/html; charset=utf-8\",\n \"cache-control\": \"no-store\",\n });\n res.end(html);\n return;\n }\n }\n next();\n };\n}\n\n/** Extensions whose files have `.gz` siblings. */\nexport const PRECOMPRESS_EXTENSIONS = [\".wasm\", \".data\"] as const;\n\nconst PRECOMPRESSED_TYPES: Record<string, string> = {\n \".wasm\": \"application/wasm\",\n \".data\": \"application/octet-stream\",\n};\n\n// Serves the build's `.gz` siblings of wasm/data, which the main sirv ignores.\nexport function precompressedAssets(\n outDir: string,\n base = \"/\",\n): ConnectMiddleware {\n const serve = sirv(outDir, {\n dev: true,\n etag: true,\n gzip: true,\n extensions: [],\n setHeaders(res, pathname) {\n res.setHeader(\n \"Content-Type\",\n PRECOMPRESSED_TYPES[path.extname(pathname)],\n );\n },\n });\n return (req, res, next) => {\n const url = req.url ?? \"/\";\n const [rawPath, search] = url.split(\"?\");\n const rel = stripBase(rawPath, base);\n // Ranges are byte offsets into the identity body: leave them to the server.\n if (\n !(PRECOMPRESS_EXTENSIONS as readonly string[]).includes(\n path.extname(rel),\n ) ||\n req.headers.range ||\n (base !== \"/\" && rel === rawPath)\n ) {\n next();\n return;\n }\n req.url = search === undefined ? rel : `${rel}?${search}`;\n serve(req, res, () => {\n req.url = url;\n next();\n });\n };\n}\n\n/** Throws, naming the missing file and the build, when `outDirAbs` holds no build. */\nexport function assertConnectBuild(\n outDirArg: string,\n outDirAbs: string,\n dirname: string,\n): void {\n const file = path.join(outDirAbs, \"index.html\");\n if (existsSync(file)) return;\n const relative = path.relative(dirname, file);\n const shown = (\n relative === \"..\" ||\n relative.startsWith(`..${path.sep}`) ||\n path.isAbsolute(relative)\n ? file\n : relative\n )\n .split(path.sep)\n .join(\"/\");\n // A default build, maybe another project's (a monitor copy serves its source's).\n const project = path.resolve(outDirAbs, \"../../..\");\n const build =\n path.resolve(project, DEFAULT_CONNECT_OUTDIR) !== outDirAbs\n ? `\\`ph connect build --outDir ${JSON.stringify(outDirArg)}\\``\n : project === path.resolve(dirname)\n ? \"`ph connect build`\"\n : `\\`ph connect build\\` in ${project.split(path.sep).join(\"/\")}`;\n throw new Error(\n `No Connect build to serve: ${shown} is missing. Build it first with ${build}, or \\`ph run <host> build\\` for a host's Connect.`,\n );\n}\n\n/** The served base: `--base`, else what the dist or the project was built with. */\nexport function connectBaseOf(\n args: Pick<ConnectPreviewArgs, \"connectBasePath\">,\n outDirAbs: string,\n dirname: string,\n): string {\n // Serving a dist needs only its base, not the build's plugin stack.\n const sourceBasePath = getConfig(path.join(dirname, \"powerhouse.config.json\"))\n .connect?.app?.basePath;\n return (\n resolvePreviewBase(args.connectBasePath, outDirAbs) ??\n (sourceBasePath ? normalizeBasePath(sourceBasePath) : \"/\")\n );\n}\n"],"names":[],"mappings":"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","debug_id":"152aac10-515c-55ef-9f11-64c6a3fbff77"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"connect-serve-COWXf_41.d.mts","names":[],"sources":["../src/services/connect-serve.ts"],"mappings":";;;;;;;;;;;;;;UAmCiB;EACf,UAAU;EACV;;EAEA;;;;;;;;;;;iBAYc,gBACd,MAAK,qCACJ;;;;;;;iBAsDa,kBAAkB,cAAc;iBAkBhC,mBACd,6BACA;iBAkBc,UAAU,kBAAkB;;KAOhC,qBACV,KAAK,iBACL,KAAK,gBACL;iBAQc,oBACd,kBACA;iBAec,aAAa,gBAAgB,eAAe;KAcvD,iBAAiB;;iBAGN,aACd,gBACA,UAAU,sBACV,gBACC;;;;;;iBA6Ba,iBAAiB,iBAAiB;iBAKlC,kBACd,gBACA,UAAU,sBACV,eACA,YAAY,eACZ,oBACC;;cA+CU;iBAQG,oBACd,gBACA,gBACC;;iBAqCa,mBACd,mBACA,mBACA;;iBA4Bc,cACd,MAAM,KAAK,wCACX,mBACA"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"member-config-Bs3yOT6y.mjs","sources":["../src/runners/member-config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n assertProtocolConsistency,\n primaryBackend,\n protocolEnv,\n reactorBlockToSwitchboardConfig,\n type ReactorConfig,\n} from \"@powerhousedao/host-core\";\nimport {\n mergeSwitchboardConfig,\n switchboardConfigLayerSchema,\n type SwitchboardConfigInput,\n} from \"@powerhousedao/switchboard/config\";\nimport {\n envNamesBeforeProjectEnv,\n isDotenvDisabled,\n} from \"@powerhousedao/shared/clis/project-env\";\nimport type { ILogger } from \"document-model\";\nimport dotenv from \"dotenv\";\n\ntype Env = Readonly<Record<string, string | undefined>>;\n\n/** The operator's env, split by where each value came from. */\nexport interface MemberEnv {\n /** Set by the shell: wins over the host file. */\n shell: Env;\n /** Only in the project `.env`: the host file's keys win over these. */\n dotenv: Env;\n}\n\n// The server's dotenv.config() ignores a file it cannot read.\nfunction readDotenv(cwd: string): Record<string, string> {\n try {\n return dotenv.parse(fs.readFileSync(path.join(cwd, \".env\")));\n } catch {\n return {};\n }\n}\n\nconst shellNamesByEnv = new WeakMap<object, ReadonlySet<string>>();\n\n/** Records which names of `env` the shell set, before a `.env` loads into it. */\nexport function rememberShellNames(env: Env, names: Iterable<string>): void {\n shellNamesByEnv.set(env, new Set(names));\n}\n\n// Taken the first time an env is seen: before the first member's server\n// import loads the .env into it, and reused for every later member.\nfunction shellNamesOf(env: Env): ReadonlySet<string> {\n let names = shellNamesByEnv.get(env);\n if (!names) {\n names =\n (env === process.env ? envNamesBeforeProjectEnv() : undefined) ??\n new Set(Object.keys(env));\n shellNamesByEnv.set(env, names);\n }\n return names;\n}\n\n/**\n * Splits `env` into the shell's values and the `.env` the switchboard server\n * loads from `cwd` (the same file). A name the shell set stays the shell's,\n * whatever the file says.\n */\nexport function memberEnvOf(env: Env, cwd: string = process.cwd()): MemberEnv {\n const file = isDotenvDisabled({ ...env }) ? {} : readDotenv(cwd);\n const shellNames = shellNamesOf(env);\n const shell: Record<string, string | undefined> = {};\n for (const [name, value] of Object.entries(env)) {\n if (file[name] === undefined || shellNames.has(name)) shell[name] = value;\n }\n const fromFile: Record<string, string> = {};\n for (const [name, value] of Object.entries(file)) {\n if (!shellNames.has(name)) fromFile[name] = value;\n }\n return { shell, dotenv: fromFile };\n}\n\n/** The env vars the block sets, which a `.env` value does not override. */\nfunction blockEnvNames(reactor: ReactorConfig | undefined): string[] {\n const block = reactorBlockToSwitchboardConfig(reactor);\n return [\n ...Object.keys(protocolEnv(reactor?.protocol)),\n ...(block.packages?.dynamic ? [\"DYNAMIC_MODEL_LOADING\"] : []),\n ...(block.features ? [\"PH_WORKFLOWS_ENABLED\"] : []),\n ];\n}\n\n/** `config.switchboard`: a member's own switchboard config. The omitted keys\n * live in the reactor block (storage, protocol, dynamic packages) or the\n * runner (port, dev verb, drives, plugins), or are process-wide or not JSON. */\nexport const memberSwitchboardConfigSchema = switchboardConfigLayerSchema([\n \"logLevel\",\n \"server.port\",\n \"server.dev\",\n \"storage.reactor\",\n \"storage.readModel\",\n \"protocol\",\n \"telemetry\",\n \"packages.dynamic\",\n \"drive\",\n \"remoteDrives\",\n \"features.pluginHost\",\n \"processorConfig\",\n]);\n\nexport interface SwitchboardMember {\n reactor?: ReactorConfig;\n config?: { switchboard?: SwitchboardConfigInput };\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return (\n typeof value === \"object\" &&\n value !== null &&\n Object.getPrototypeOf(value) === Object.prototype\n );\n}\n\n/** The dotted keys both layers set. */\nexport function overlappingKeys(\n a: Record<string, unknown>,\n b: Record<string, unknown>,\n path = \"\",\n): string[] {\n return Object.entries(b).flatMap(([key, value]) => {\n const other = a[key];\n if (value === undefined || other === undefined) return [];\n const at = path ? `${path}.${key}` : key;\n return isPlainObject(value) && isPlainObject(other)\n ? overlappingKeys(other, value, at)\n : [at];\n });\n}\n\n/** Each `config.switchboard` key the reactor block already sets. */\nexport function reactorBlockConflicts(member: SwitchboardMember): string[] {\n const own = member.config?.switchboard;\n if (!own) return [];\n return overlappingKeys(\n reactorBlockToSwitchboardConfig(member.reactor) as Record<string, unknown>,\n own as Record<string, unknown>,\n ).map(\n (key) =>\n `config.switchboard.${key} is also set by the reactor block; set it in one place.`,\n );\n}\n\n/**\n * The deprecation notice for a block whose `readModel.url` still names the\n * reactor store too: nothing else names the store, as it did when\n * readModel.url rode `dbPath`.\n */\nexport function readModelAsReactorStore(\n reactor: ReactorConfig | undefined,\n env: Env,\n hostFileLabel: string,\n): { url: string; warning: string } | undefined {\n const storage = reactorBlockToSwitchboardConfig(reactor).storage;\n const url = storage?.readModel?.url;\n if (\n !url ||\n storage.reactor ||\n env.PH_REACTOR_DATABASE_URL !== undefined ||\n env.PH_SWITCHBOARD_DATABASE_URL !== undefined\n ) {\n return undefined;\n }\n return {\n url,\n warning:\n `${hostFileLabel}: reactor readModel.url (${url}) also holds the reactor store, because no storage names one. ` +\n \"This is deprecated: set the backend's storage explicitly (the same Postgres url, or a path dataDir).\",\n };\n}\n\n/**\n * The member's switchboard config under the runner's own arguments: its\n * reactor block, then `config.switchboard`, then the env over both, mapped\n * once as the server read it (the shell over the `.env`, whose values for the\n * block's own vars are dropped). The block keeps the precedence it had as\n * set-if-absent env and `dbPath`: only a shell PH_REACTOR_DATABASE_URL\n * overrides its store, and no env var overrides its read model. Writes nothing.\n */\nexport async function memberSwitchboardConfig(\n member: SwitchboardMember,\n env: MemberEnv,\n options: {\n pluginHost: boolean;\n logger?: ILogger;\n /** Under everything else: values no flag or host file set. */\n defaults?: SwitchboardConfigInput;\n },\n): Promise<SwitchboardConfigInput> {\n // Lazy: the env mapping loads reactor-api, which the runner module must not.\n const { switchboardConfigFromEnv } =\n await import(\"@powerhousedao/switchboard/config/env\");\n const block = reactorBlockToSwitchboardConfig(member.reactor);\n const legacy = readModelAsReactorStore(member.reactor, env.shell, \"\");\n if (legacy) {\n block.storage = { ...block.storage, reactor: { url: legacy.url } };\n }\n // One env, as the server read it: the .env under the block's own vars,\n // the shell over both.\n const dotenvValues: Record<string, string | undefined> = { ...env.dotenv };\n for (const name of blockEnvNames(member.reactor)) delete dotenvValues[name];\n const fromEnv = switchboardConfigFromEnv(\n { ...dotenvValues, ...env.shell },\n { logger: options.logger },\n );\n const storage = { ...fromEnv.storage };\n if (\n block.storage?.reactor &&\n env.shell.PH_REACTOR_DATABASE_URL === undefined\n ) {\n delete storage.reactor;\n }\n if (block.storage?.readModel) delete storage.readModel;\n return mergeSwitchboardConfig(\n options.defaults ?? {},\n block,\n member.config?.switchboard ?? {},\n { ...fromEnv, storage },\n // A declared composition turns the plugin host on, whatever the env says.\n options.pluginHost ? { features: { pluginHost: true } } : {},\n );\n}\n\n/** A Postgres store no url names: the server would use a folder instead. */\nexport function missingPostgresUrl(\n reactor: ReactorConfig | undefined,\n config: SwitchboardConfigInput,\n hostFileLabel: string,\n): string | undefined {\n if (primaryBackend(reactor)?.storage?.kind !== \"postgres\") return undefined;\n if (config.storage?.reactor?.url) return undefined;\n return `${hostFileLabel}: the reactor's storage is Postgres, but nothing names the database. Set the backend's storage.url, or PH_REACTOR_DATABASE_URL.`;\n}\n\n/**\n * Fails when the operator's env contradicts the member's protocol block, then\n * creates the block's path-storage dir (the server's own mkdir is not\n * recursive).\n */\nexport function prepareMemberStorage(\n reactor: ReactorConfig | undefined,\n env: Env,\n hostFileLabel: string,\n): void {\n assertProtocolConsistency(reactor?.protocol, { ...env }, hostFileLabel);\n const storage = primaryBackend(reactor)?.storage;\n if (storage?.kind !== \"path\" || !storage.dataDir) return;\n // `ph run` resolves `$env` and the `${userData}` sugar before the verb;\n // an unresolved one here would mkdir a literal \"${userData}\" folder.\n if (/\\$\\{(userData|projectRoot)\\}/.test(storage.dataDir)) {\n throw new Error(\n `${hostFileLabel}: storage.dataDir \"${storage.dataDir}\" was not resolved; resolve the host (resolveHostOutputs) before starting it.`,\n );\n }\n fs.mkdirSync(storage.dataDir, { recursive: true });\n}\n\n/** The verb owns dev mode; `runner.dev` is the host-file spelling of it. */\nexport function switchboardDevMode(\n devVerb: boolean,\n runner: { dev?: boolean },\n): boolean {\n return devVerb || runner.dev === true;\n}\n"],"names":[],"mappings":"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","debug_id":"b275fe92-4897-57b6-a224-4881b6d414db"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"start-run-DWn2cVyi.mjs","sources":["../src/services/run/start-run.ts"],"sourcesContent":["import {\n clearRunRecord,\n getVerb,\n isSchemaLike,\n loadHost,\n loadProducers,\n ONE_SHOT_VERBS,\n outputRefsOf,\n probeRun,\n processResolveEnv,\n producerOutputsSchemas,\n readProjectName,\n readRunRecord,\n resolveHostOutputs,\n resolveRunnerModule,\n runRecordOutputSource,\n toStartedHandle,\n validateDeclaredHost,\n validateHost,\n writeRunRecord,\n type RunnerModule,\n} from \"@powerhousedao/host-core\";\n\nexport interface StartRunArgs {\n host: string;\n verb?: string;\n projectRoot?: string;\n debug?: boolean;\n}\n\n/**\n * `ph run <host> [verb]`: dispatch the verb (default `run`) of the host's\n * declared runner. There is deliberately no type→runner registry — what a\n * host does is written in its own file.\n *\n * The pipeline (typed-host-configs 3.5): declared validation (token shapes,\n * `$output` paths against the producers' outputsSchemas, the runner's\n * declaredHostSchema), the live-instance lock, resolution (`$output` from\n * the producers' live run records, `$env` from this process, the\n * `${userData}` sugar), resolved validation, then the verb with the parsed\n * host. A compound runner gets its declared host: its members resolve their\n * own tokens as they start.\n *\n * A reactor runner that exports `outputsSchema` has its handle's outputs\n * published in a v2 `.ph/run/<name>.json` record once ready; this is the only\n * standalone writer (mastra included). Compounds write their own record with\n * the members in it; one-shot verbs (`build`) return nothing and write none.\n */\nexport async function startRun(args: StartRunArgs): Promise<unknown> {\n // Loading a host loads its plugins, and React settles on its development or\n // production build the first time it's loaded. `vite build` sets NODE_ENV only\n // after that, so a build would run one half of React with the other half's\n // renderer (TypeError: dispatcher.getOwner is not a function).\n if (ONE_SHOT_VERBS.has(args.verb ?? \"run\")) {\n process.env.NODE_ENV ??= \"production\";\n }\n const projectRoot = args.projectRoot ?? process.cwd();\n const loaded = await loadHost(projectRoot, args.host);\n const { warnSupersededConfigKeys } = await import(\"./superseded-config.js\");\n warnSupersededConfigKeys(projectRoot);\n const specifier = loaded.host.runner.module;\n const runner = await resolveRunnerModule(projectRoot, specifier);\n const verb = args.verb ?? \"run\";\n const fn = getVerb(runner, specifier, verb);\n const file = loaded.file;\n if (args.debug) {\n console.log({ host: loaded.host.name, runner: specifier, verb });\n }\n\n if (runner.kind === \"compound\") {\n validateDeclaredHost(runner, specifier, loaded.host, file);\n const host = validateHost(runner, specifier, loaded.host, file, {\n tokens: \"allow\",\n });\n return fn(host, { projectRoot, verb, env: process.env });\n }\n\n const projectName = readProjectName(projectRoot);\n const producers = await loadProducers(projectRoot, outputRefsOf(loaded.host));\n validateDeclaredHost(runner, specifier, loaded.host, file, {\n outputsSchemaOf: producerOutputsSchemas(producers),\n });\n const oneShot = ONE_SHOT_VERBS.has(verb);\n if (oneShot) {\n // `build` reads no other host's outputs: no producer needs to run.\n const host = validateHost(runner, specifier, loaded.host, file, {\n tokens: \"allow\",\n });\n return fn(host, { projectRoot, verb, env: process.env });\n }\n const publishes = isSchemaLike(runner.outputsSchema);\n // Before the verb starts anything: a second live instance would take\n // over the first one's record (and clear it on exit).\n if (publishes) assertNotRunning(projectRoot, loaded.host.name, projectName);\n const resolved = resolveHostOutputs(loaded.host, {\n outputs: runRecordOutputSource(projectRoot, {\n consumer: args.host,\n producers,\n projectName,\n }),\n ...processResolveEnv(projectRoot),\n where: `hosts/${args.host}/host.js`,\n });\n const host = validateHost(runner, specifier, resolved, file);\n const result = await fn(host, { projectRoot, verb, env: process.env });\n if (publishes && result !== undefined && result !== null) {\n await publishOutputs(runner, result, {\n projectRoot,\n projectName,\n hostName: loaded.host.name,\n specifier,\n verb,\n });\n }\n return result;\n}\n\nfunction assertNotRunning(\n projectRoot: string,\n hostName: string,\n projectName: string,\n): void {\n const probe = probeRun(projectRoot, hostName, projectName);\n if (probe.status === \"live\" && probe.record.pid !== process.pid) {\n throw new Error(\n `${hostName} is already running for this project (pid ${probe.record.pid}). Stop it before starting another.`,\n );\n }\n if (probe.status === \"foreign\") {\n throw new Error(\n `.ph/run/${hostName}.json describes a live \"${probe.record.projectName}\", but this project is \"${projectName}\". Refusing to start a second instance.`,\n );\n }\n}\n\ninterface PublishTarget {\n projectRoot: string;\n projectName: string;\n hostName: string;\n specifier: string;\n verb: string;\n}\n\n/** Await `ready`, validate the outputs, write the v2 record and clear it on\n * exit. A handle that never gets ready or reports invalid outputs is shut\n * down before the error propagates. */\nasync function publishOutputs(\n runner: RunnerModule,\n result: unknown,\n target: PublishTarget,\n): Promise<void> {\n const where = `${target.specifier} ${target.verb}`;\n const handle = toStartedHandle(result, where);\n const name = target.projectName;\n let outputs: unknown;\n try {\n if (!isSchemaLike(runner.outputsSchema)) return;\n // Checked again after the start: an instance that started meanwhile.\n assertNotRunning(target.projectRoot, target.hostName, name);\n if (handle.ready) await handle.ready;\n const parsed = runner.outputsSchema.safeParse(handle.outputs);\n if (!parsed.success) {\n const issues = parsed.error.issues\n .map(\n (issue) =>\n ` - ${issue.path.map(String).join(\".\") || \"<root>\"}: ${issue.message}`,\n )\n .join(\"\\n\");\n throw new Error(\n `${where} reported outputs that fail its outputsSchema:\\n${issues}`,\n );\n }\n outputs = parsed.data;\n } catch (error) {\n await handle.shutdown?.();\n throw error;\n }\n\n writeRunRecord(target.projectRoot, {\n version: 2,\n host: target.hostName,\n projectName: name,\n kind: \"reactor\",\n verb: target.verb,\n pid: process.pid,\n startedAt: new Date().toISOString(),\n outputs: outputs as Record<string, unknown>,\n });\n // No SIGINT/SIGTERM handler: the switchboard reactor's own handler kills\n // the reactor before draining the api, and a parallel shutdown() would\n // break that order. Without an exit event the record keeps a dead pid,\n // which probeRun reports as stale.\n process.on(\"exit\", () => {\n if (readRunRecord(target.projectRoot, target.hostName)?.pid === process.pid)\n clearRunRecord(target.projectRoot, target.hostName);\n });\n}\n"],"names":[],"mappings":"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","debug_id":"a803084f-2032-5068-a22f-4875a78cd073"}
@@ -1,53 +0,0 @@
1
-
2
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9af619e6-270e-547b-9b87-014cced19b9f")}catch(e){}}();
3
- import path from "node:path";
4
- import fs from "node:fs";
5
- //#region src/services/run/superseded-config.ts
6
- /**
7
- * P2.7 — the fixed legacy→hosts mapping table. With hosts/ active, these
8
- * powerhouse.config.json keys are superseded by host.js structure and the run
9
- * path ignores them; each present key warns ONCE per run, naming its new home.
10
- *
11
- * Keys the scaffolded host files REFERENCE (studio.port, reactor.port,
12
- * vetra.connectPort, assistant.port, and the WHOLE connect.* block — handed to the runtime
13
- * unchanged, connect.instance.* included) are expected to remain and are
14
- * deliberately absent from this table.
15
- */
16
- const SUPERSEDED = {
17
- "studio.host": "hosts/connect/host.js → runner.host",
18
- "studio.https": "hosts/connect/host.js → runner.https",
19
- "studio.openBrowser": "hosts/connect/host.js → runner.openBrowser",
20
- "reactor.https": "hosts/switchboard/host.js → runner.https",
21
- "reactor.storage": "hosts/switchboard/host.js → reactor.backends.<name>.storage",
22
- "switchboard.database.url": "hosts/switchboard/host.js → reactor.backends.<name>.storage.url"
23
- };
24
- function lookup(config, dottedKey) {
25
- let cursor = config;
26
- for (const part of dottedKey.split(".")) {
27
- if (cursor === null || typeof cursor !== "object") return void 0;
28
- cursor = cursor[part];
29
- }
30
- return cursor;
31
- }
32
- /** Warn once per run for each superseded key present in the project config.
33
- * Returns the warned keys (for tests). Never throws — a malformed config is
34
- * the loader's problem, not the warner's. */
35
- function warnSupersededConfigKeys(projectRoot, warn = console.warn) {
36
- let config;
37
- try {
38
- config = JSON.parse(fs.readFileSync(path.join(projectRoot, "powerhouse.config.json"), "utf8"));
39
- } catch {
40
- return [];
41
- }
42
- const warned = [];
43
- for (const [key, newHome] of Object.entries(SUPERSEDED)) if (lookup(config, key) !== void 0) {
44
- warned.push(key);
45
- warn(`[ph run] powerhouse.config.json "${key}" is ignored in hosts projects — its home is now ${newHome}.`);
46
- }
47
- return warned;
48
- }
49
- //#endregion
50
- export { warnSupersededConfigKeys };
51
-
52
- //# sourceMappingURL=superseded-config-CpHrCuNq.mjs.map
53
- //# debugId=9af619e6-270e-547b-9b87-014cced19b9f
@@ -1 +0,0 @@
1
- {"version":3,"file":"superseded-config-CpHrCuNq.mjs","sources":["../src/services/run/superseded-config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * P2.7 — the fixed legacy→hosts mapping table. With hosts/ active, these\n * powerhouse.config.json keys are superseded by host.js structure and the run\n * path ignores them; each present key warns ONCE per run, naming its new home.\n *\n * Keys the scaffolded host files REFERENCE (studio.port, reactor.port,\n * vetra.connectPort, assistant.port, and the WHOLE connect.* block — handed to the runtime\n * unchanged, connect.instance.* included) are expected to remain and are\n * deliberately absent from this table.\n */\nconst SUPERSEDED: Record<string, string> = {\n \"studio.host\": \"hosts/connect/host.js → runner.host\",\n \"studio.https\": \"hosts/connect/host.js → runner.https\",\n \"studio.openBrowser\": \"hosts/connect/host.js → runner.openBrowser\",\n \"reactor.https\": \"hosts/switchboard/host.js → runner.https\",\n \"reactor.storage\":\n \"hosts/switchboard/host.js → reactor.backends.<name>.storage\",\n \"switchboard.database.url\":\n \"hosts/switchboard/host.js → reactor.backends.<name>.storage.url\",\n};\n\nfunction lookup(config: unknown, dottedKey: string): unknown {\n let cursor: unknown = config;\n for (const part of dottedKey.split(\".\")) {\n if (cursor === null || typeof cursor !== \"object\") return undefined;\n cursor = (cursor as Record<string, unknown>)[part];\n }\n return cursor;\n}\n\n/** Warn once per run for each superseded key present in the project config.\n * Returns the warned keys (for tests). Never throws — a malformed config is\n * the loader's problem, not the warner's. */\nexport function warnSupersededConfigKeys(\n projectRoot: string,\n warn: (message: string) => void = console.warn,\n): string[] {\n let config: unknown;\n try {\n config = JSON.parse(\n fs.readFileSync(path.join(projectRoot, \"powerhouse.config.json\"), \"utf8\"),\n );\n } catch {\n return [];\n }\n const warned: string[] = [];\n for (const [key, newHome] of Object.entries(SUPERSEDED)) {\n if (lookup(config, key) !== undefined) {\n warned.push(key);\n warn(\n `[ph run] powerhouse.config.json \"${key}\" is ignored in hosts projects — ` +\n `its home is now ${newHome}.`,\n );\n }\n }\n return warned;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAaA,MAAM,aAAqC;CACzC,eAAe;CACf,gBAAgB;CAChB,sBAAsB;CACtB,iBAAiB;CACjB,mBACE;CACF,4BACE;AACJ;AAEA,SAAS,OAAO,QAAiB,WAA4B;CAC3D,IAAI,SAAkB;CACtB,KAAK,MAAM,QAAQ,UAAU,MAAM,GAAG,GAAG;EACvC,IAAI,WAAW,QAAQ,OAAO,WAAW,UAAU,OAAO,KAAA;EAC1D,SAAU,OAAmC;CAC/C;CACA,OAAO;AACT;;;;AAKA,SAAgB,yBACd,aACA,OAAkC,QAAQ,MAChC;CACV,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MACZ,GAAG,aAAa,KAAK,KAAK,aAAa,wBAAwB,GAAG,MAAM,CAC1E;CACF,QAAQ;EACN,OAAO,CAAC;CACV;CACA,MAAM,SAAmB,CAAC;CAC1B,KAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,UAAU,GACpD,IAAI,OAAO,QAAQ,GAAG,MAAM,KAAA,GAAW;EACrC,OAAO,KAAK,GAAG;EACf,KACE,oCAAoC,IAAI,mDACnB,QAAQ,EAC/B;CACF;CAEF,OAAO;AACT","debug_id":"9af619e6-270e-547b-9b87-014cced19b9f"}