@powerhousedao/shared 6.2.3-dev.5 → 6.2.3-dev.51

package/dist/clis/build-pieces.mjs

@@ -0,0 +1,549 @@
+import { o as buildPieceBuildConfig, t as PIECE_ENTRY_GLOB } from "./build-config-HbYUSZS1.mjs";
+import { isBuiltin } from "node:module";
+import { tmpdir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+//#region clis/external-deps.mts
+const createDetectionCache = () => ({
+	files: /* @__PURE__ */ new Map(),
+	wasm: /* @__PURE__ */ new Map()
+});
+const NODE_MODULES = `${sep}node_modules${sep}`;
+/** `file` relative to `root`, with forward slashes on every platform. */
+function projectPath(root, file) {
+	return relative(root, file).split(sep).join("/");
+}
+const samePath = (file) => process.platform === "win32" ? file.toLowerCase() : file;
+function packageNameOf(specifier) {
+	if (specifier.startsWith(".") || isAbsolute(specifier)) return void 0;
+	const parts = specifier.split("/");
+	return (specifier.startsWith("@") ? parts.slice(0, 2).join("/") : parts[0]) || void 0;
+}
+function packageRootOf(file) {
+	const at = file.lastIndexOf(NODE_MODULES);
+	if (at < 0) return void 0;
+	const rest = file.slice(at + NODE_MODULES.length).split(sep);
+	const depth = rest[0]?.startsWith("@") ? 2 : 1;
+	if (rest.length <= depth) return void 0;
+	return join(file.slice(0, at + NODE_MODULES.length), ...rest.slice(0, depth));
+}
+function readPackageJson(root) {
+	try {
+		return JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+	} catch {
+		return;
+	}
+}
+function requires(importerRoot, importedRoot) {
+	const importer = readPackageJson(importerRoot);
+	const name = readPackageJson(importedRoot)?.name;
+	if (!importer || !name) return false;
+	return importer.dependencies?.[name] !== void 0 || importer.optionalDependencies?.[name] !== void 0;
+}
+function wasmIn(root, cache) {
+	if (cache?.wasm.has(root)) return cache.wasm.get(root);
+	const found = scanForWasm(root);
+	cache?.wasm.set(root, found);
+	return found;
+}
+function scanForWasm(root) {
+	try {
+		const found = readdirSync(root, {
+			recursive: true,
+			encoding: "utf8"
+		}).find((file) => file.endsWith(".wasm") && !file.split(sep).includes("node_modules"));
+		return found && join(root, found);
+	} catch {
+		return;
+	}
+}
+/** The first file `entry` cannot load without that a bundle cannot carry. */
+async function findRequiredFile(entry, trace, cache) {
+	const { fileList, reasons } = await trace(entry);
+	const start = samePath(realpathSync(entry));
+	const candidates = [...fileList].filter((file) => file.endsWith(".node")).map((file) => ({
+		file,
+		kind: "native",
+		from: file
+	}));
+	{
+		const traced = /* @__PURE__ */ new Map();
+		for (const file of fileList) {
+			const root = packageRootOf(file);
+			if (root && !traced.has(root) && /\.[cm]?js$/.test(file)) traced.set(root, file);
+		}
+		const tracedWasm = [...fileList].filter((file) => file.endsWith(".wasm"));
+		for (const [root, from] of traced) {
+			const file = tracedWasm.find((wasm) => packageRootOf(wasm) === root) ?? wasmIn(root, cache);
+			if (file) candidates.push({
+				file,
+				kind: "wasm",
+				from
+			});
+		}
+	}
+	for (const { from, ...required } of candidates) {
+		const seen = /* @__PURE__ */ new Set([from]);
+		const queue = [from];
+		while (queue.length > 0) {
+			const file = queue.shift();
+			if (samePath(file) === start) return required;
+			for (const parent of reasons.get(file)?.parents ?? []) {
+				if (seen.has(parent)) continue;
+				const fromRoot = packageRootOf(parent);
+				const toRoot = packageRootOf(file);
+				if (fromRoot !== toRoot && (!fromRoot || !toRoot || !requires(fromRoot, toRoot))) continue;
+				seen.add(parent);
+				queue.push(parent);
+			}
+		}
+	}
+}
+/** Keeps each package the code imports that needs such a file out of the bundle. */
+function externalDepsPlugin(trace, found, options = {}) {
+	const cache = options.cache ?? createDetectionCache();
+	const root = options.root ?? process.cwd();
+	const show = (file) => projectPath(root, file);
+	const inDir = (id, dirs = []) => dirs.some((dir) => show(id).startsWith(`${dir}/`));
+	const detect = (id) => {
+		let verdict = cache.files.get(id);
+		if (!verdict) {
+			verdict = findRequiredFile(id, trace, cache);
+			cache.files.set(id, verdict);
+		}
+		return verdict;
+	};
+	return {
+		name: "powerhouse:external-deps",
+		async resolveId(source, importer, extra) {
+			if (!importer || importer.includes(NODE_MODULES)) return null;
+			if (isBuiltin(source) || inDir(importer, options.ignoreDirs)) return null;
+			const name = packageNameOf(source);
+			if (!name) return null;
+			const resolved = await this.resolve(source, importer, {
+				...extra,
+				skipSelf: true
+			});
+			if (!resolved || resolved.external) return null;
+			const required = await detect(resolved.id);
+			const pkgRoot = packageRootOf(resolved.id);
+			const version = pkgRoot ? readPackageJson(pkgRoot)?.version : void 0;
+			if (!required || !version) return null;
+			const what = required.kind === "native" ? `the native addon ${show(required.file)}` : `the WebAssembly module ${show(required.file)}`;
+			if (options.browser) {
+				if (required.kind === "wasm") return null;
+				throw new Error(`${show(importer)} imports ${name}, which needs ${what}. Native code cannot run in the browser: import it only from subgraphs, switchboard processors or pieces.`);
+			}
+			if (inDir(importer, options.forbidDirs)) throw new Error(`${show(importer)} imports ${name}, which needs ${what}. Document models run in Connect and on every host: use it from a subgraph, processor or piece instead.`);
+			if (!found.has(name)) found.set(name, {
+				name,
+				version,
+				...required,
+				importer
+			});
+			return {
+				id: source,
+				external: true
+			};
+		}
+	};
+}
+/**
+* The detected packages `pkg` does not install for its consumers: anything
+* outside dependencies, optionalDependencies and peerDependencies.
+*/
+function undeclaredExternalDependencies(found, pkg) {
+	return [...found].filter((dep) => pkg.dependencies?.[dep.name] === void 0 && pkg.optionalDependencies?.[dep.name] === void 0 && pkg.peerDependencies?.[dep.name] === void 0);
+}
+/** name -> version, sorted by name. */
+function externalDependencyVersions(found) {
+	return Object.fromEntries([...found].sort((a, b) => a.name.localeCompare(b.name)).map((dep) => [dep.name, dep.version]));
+}
+//#endregion
+//#region clis/build-pieces.mts
+const toPosix = (p) => p.split(sep).join("/");
+function statSafe(p) {
+	try {
+		return statSync(p);
+	} catch {
+		return null;
+	}
+}
+function expandEntryGlobs(root, globs) {
+	const files = /* @__PURE__ */ new Set();
+	for (const pattern of globs) {
+		const segments = pattern.split("/").filter(Boolean);
+		let dirs = [root];
+		for (const seg of segments) {
+			const next = [];
+			for (const d of dirs) {
+				if (!statSafe(d)?.isDirectory()) continue;
+				if (seg === "*") for (const e of readdirSync(d, { withFileTypes: true })) next.push(join(d, e.name));
+				else next.push(join(d, seg));
+			}
+			dirs = next;
+		}
+		for (const f of dirs) if (statSafe(f)?.isFile()) files.add(f);
+	}
+	return [...files];
+}
+function planPieces(projectRoot, outDir) {
+	return expandEntryGlobs(projectRoot, [PIECE_ENTRY_GLOB]).map((file) => {
+		const dir = basename(dirname(file));
+		return {
+			dir,
+			entry: relative(projectRoot, file),
+			outDir: join(outDir, "node", "pieces", dir)
+		};
+	}).sort((a, b) => a.dir < b.dir ? -1 : a.dir > b.dir ? 1 : 0);
+}
+function createJsonReplacer() {
+	const ancestors = [];
+	return function replace(_key, value) {
+		if (typeof value === "function" || value === void 0) return void 0;
+		if (typeof value === "bigint") return value.toString();
+		if (typeof value !== "object" || value === null) return value;
+		while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();
+		if (ancestors.includes(value)) return void 0;
+		ancestors.push(value);
+		return value;
+	};
+}
+const DESCRIBE_HELPERS = `
+const isRecord = (value) => typeof value === "object" && value !== null;
+
+function findPiece(mod) {
+  const candidates = [
+    ...Object.values(mod),
+    ...(isRecord(mod.default) ? Object.values(mod.default) : []),
+    mod.default,
+  ];
+  for (const candidate of candidates) {
+    if (isRecord(candidate) && candidate.constructor?.name === "Piece") {
+      return candidate;
+    }
+  }
+  for (const candidate of candidates) {
+    if (
+      isRecord(candidate) &&
+      typeof candidate.displayName === "string" &&
+      (isRecord(candidate.actions) ||
+        typeof candidate.actions === "function" ||
+        typeof candidate.getAction === "function")
+    ) {
+      return candidate;
+    }
+  }
+  return undefined;
+}
+
+function describePiece(piece) {
+  if (typeof piece.metadata === "function") return piece.metadata();
+  const call = (value) => (typeof value === "function" ? value.call(piece) : value);
+  return {
+    displayName: piece.displayName,
+    logoUrl: piece.logoUrl,
+    description: piece.description,
+    authors: piece.authors,
+    categories: piece.categories,
+    auth: piece.auth,
+    minimumSupportedRelease: piece.minimumSupportedRelease,
+    maximumSupportedRelease: piece.maximumSupportedRelease,
+    deprecated: piece.deprecated,
+    actions: call(piece.actions) ?? {},
+    triggers: call(piece.triggers) ?? {},
+  };
+}
+
+function createJsonReplacer() {
+  const ancestors = [];
+  return function replace(_key, value) {
+    if (typeof value === "function" || value === undefined) return undefined;
+    if (typeof value === "bigint") return value.toString();
+    if (typeof value !== "object" || value === null) return value;
+    while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();
+    if (ancestors.includes(value)) return undefined;
+    ancestors.push(value);
+    return value;
+  };
+}
+`;
+const DESCRIBE_SCRIPT = `
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const job = JSON.parse(readFileSync(process.argv[2], "utf8"));
+${DESCRIBE_HELPERS}
+// Says why the child gave up in the one place the parent always reads, so a
+// failure reports the cause and never the text of this script.
+function fail(message) {
+  writeFileSync(job.outFile, JSON.stringify({ fatal: message }));
+  process.exit(1);
+}
+
+// The module to load for a list entry; a bundle names its own main.
+function entryFile(piece) {
+  const declared = piece.entry ?? piece.bundle;
+  if (typeof declared !== "string") return undefined;
+  const path = isAbsolute(declared) ? declared : join(job.projectRoot, declared);
+  if (piece.entry) return path;
+  const pkgFile = join(path, "package.json");
+  if (!existsSync(pkgFile)) return undefined;
+  const pkg = JSON.parse(readFileSync(pkgFile, "utf8"));
+  return join(path, typeof pkg.main === "string" ? pkg.main : "index.mjs");
+}
+
+let listModule;
+try {
+  listModule = await import(pathToFileURL(job.listPath).href);
+} catch (error) {
+  fail(job.listPath + " threw on import: " + (error instanceof Error ? error.message : String(error)));
+}
+const list = listModule.pieces ?? listModule.default;
+if (!Array.isArray(list)) {
+  fail(job.listPath + ' exports no "pieces" array');
+}
+
+const out = { list, pieces: [], errors: [] };
+for (const piece of list) {
+  const file = entryFile(piece);
+  // A missing file is the parent's to report, with the message it owns.
+  if (!file || !existsSync(file)) continue;
+  try {
+    const mod = await import(pathToFileURL(file).href);
+    const found = findPiece(mod);
+    if (!found) {
+      throw new Error(
+        "no Piece export found in " + file + "; exports: " + Object.keys(mod).join(", "),
+      );
+    }
+    const metadata = JSON.parse(JSON.stringify(describePiece(found), createJsonReplacer()));
+    out.pieces.push({ name: piece.name, metadata });
+  } catch (error) {
+    out.errors.push({
+      name: piece.name,
+      message: error instanceof Error ? error.message : String(error),
+    });
+  }
+}
+writeFileSync(job.outFile, JSON.stringify(out, createJsonReplacer()));
+`;
+function childFailure(error, outFile) {
+	try {
+		const answer = JSON.parse(readFileSync(outFile, "utf8"));
+		if (typeof answer.fatal === "string") return answer.fatal;
+	} catch {}
+	const { status, signal } = error;
+	if (signal) return `the describe child was killed by ${signal}`;
+	return `the describe child exited with code ${status ?? "unknown"}`;
+}
+function describePieces(projectRoot, listPath) {
+	const dir = mkdtempSync(join(tmpdir(), "ph-build-pieces-"));
+	const rel = toPosix(relative(projectRoot, listPath));
+	try {
+		const jobFile = join(dir, "job.json");
+		const scriptFile = join(dir, "describe.mjs");
+		const outFile = join(dir, "describe.json");
+		writeFileSync(scriptFile, DESCRIBE_SCRIPT);
+		writeFileSync(jobFile, JSON.stringify({
+			projectRoot,
+			listPath,
+			outFile
+		}));
+		try {
+			execFileSync(process.execPath, [scriptFile, jobFile], {
+				timeout: 6e4,
+				stdio: "inherit"
+			});
+		} catch (error) {
+			throw new Error(`pieces: could not load ${rel}: ${childFailure(error, outFile)}`, { cause: error });
+		}
+		return JSON.parse(readFileSync(outFile, "utf8"));
+	} finally {
+		rmSync(dir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+function resolvePieceLocation(piece, projectRoot, outDir) {
+	const declared = piece.entry ?? piece.bundle;
+	if (typeof declared !== "string" || declared === "") throw new Error(`pieces: "${piece.name}" declares neither an entry nor a bundle`);
+	const path = isAbsolute(declared) ? declared : join(projectRoot, declared);
+	const form = piece.entry ? "entry" : "bundle";
+	if (!(form === "entry" ? statSafe(path)?.isFile() : statSafe(join(path, "package.json"))?.isFile())) throw new Error(`pieces: "${piece.name}" declares ${declared}, which is missing`);
+	const dir = form === "entry" ? dirname(path) : path;
+	const piecesRoot = resolve(projectRoot, outDir, "node", "pieces");
+	const inside = relative(piecesRoot, dir);
+	if (inside === "" || inside.startsWith("..") || isAbsolute(inside)) {
+		const expected = toPosix(join(outDir, "node", "pieces"));
+		throw new Error(`pieces: "${piece.name}" declares ${declared}, which is outside ${expected}/; a piece is built to ${expected}/<dir>/index.mjs and its entry must point there`);
+	}
+	return form === "entry" ? {
+		dir,
+		entryFile: path,
+		form
+	} : {
+		dir,
+		form
+	};
+}
+function pieceListPath(target) {
+	return resolve(target.projectRoot, target.outDir, "node", "pieces", "index.mjs");
+}
+function assertPiecesOutDir(target) {
+	if (target.pieces.length === 0 || target.outDir === "dist") return;
+	throw new Error(`pieces: --out-dir ${target.outDir} cannot hold pieces; a piece is loaded from dist/node/pieces/<name> by the host, so a package that ships pieces builds to dist`);
+}
+function assertPieceVersion(piece, pkg) {
+	if ("version" in piece) throw new Error(`pieces: "${piece.name}" declares version ${String(piece.version)}; a piece takes its package's version (${pkg.version}), so remove "version" from pieces/index.ts`);
+}
+function piecePackageJson(options) {
+	return {
+		name: options.name,
+		version: options.version,
+		description: options.description ?? "",
+		type: "module",
+		main: options.main,
+		...options.license ? { license: options.license } : {},
+		dependencies: options.dependencies ?? {}
+	};
+}
+function bundlePackageJson(dir, version) {
+	return {
+		...JSON.parse(readFileSync(join(dir, "package.json"), "utf8")),
+		version
+	};
+}
+function pieceDescriptor(piece, version, metadata) {
+	const { name: _name, version: _version, ...rest } = metadata;
+	return {
+		name: piece.name,
+		version,
+		...rest
+	};
+}
+function enrichManifestPieces(manifest, built) {
+	const byId = new Map(built.map((piece) => [piece.name, piece]));
+	const toModule = (piece) => ({
+		id: piece.name,
+		name: piece.displayName ?? piece.name,
+		version: piece.version,
+		...piece.description ? { description: piece.description } : {},
+		bundle: piece.bundle,
+		descriptor: piece.descriptor
+	});
+	const unbuilt = [];
+	const seen = /* @__PURE__ */ new Set();
+	const pieces = (manifest.pieces ?? []).map((entry) => {
+		const hit = byId.get(entry.id);
+		if (!hit) {
+			unbuilt.push(entry.id);
+			return entry;
+		}
+		seen.add(entry.id);
+		return toModule(hit);
+	});
+	for (const piece of built) if (!seen.has(piece.name)) pieces.push(toModule(piece));
+	return {
+		manifest: {
+			...manifest,
+			pieces
+		},
+		unbuilt
+	};
+}
+const count = (record) => typeof record === "object" && record !== null ? Object.keys(record).length : 0;
+async function buildPieces(target, pkg, options) {
+	const { projectRoot, outDir } = target;
+	assertPiecesOutDir(target);
+	const externalByDir = /* @__PURE__ */ new Map();
+	for (const piece of target.pieces) {
+		console.log(`\n▶ Building piece ${piece.dir}...`);
+		const outDir = resolve(projectRoot, piece.outDir);
+		const external = /* @__PURE__ */ new Map();
+		await options.bundle(buildPieceBuildConfig({
+			entry: resolve(projectRoot, piece.entry),
+			outDir,
+			...options.trace ? { plugins: [externalDepsPlugin(options.trace, external, {
+				root: projectRoot,
+				...options.cache ? { cache: options.cache } : {}
+			})] } : {}
+		}));
+		for (const dep of external.values()) console.log(`piece ${piece.dir}: ${dep.name}@${dep.version} stays external, it needs ${projectPath(projectRoot, dep.file)}`);
+		externalByDir.set(outDir, external);
+	}
+	const listPath = pieceListPath(target);
+	if (!existsSync(listPath)) throw new Error(`pieces: ${toPosix(relative(projectRoot, listPath))} was not built; pieces/index.ts must export the list of pieces this package ships`);
+	const described = describePieces(projectRoot, listPath);
+	const built = [];
+	const listedDirs = /* @__PURE__ */ new Set();
+	for (const piece of described.list) {
+		const location = resolvePieceLocation(piece, projectRoot, outDir);
+		assertPieceVersion(piece, pkg);
+		const failure = described.errors.find((e) => e.name === piece.name);
+		if (failure) throw new Error(`pieces: "${piece.name}" could not be described: ${failure.message}`);
+		const found = described.pieces.find((p) => p.name === piece.name);
+		if (!found) throw new Error(`pieces: "${piece.name}" was not described`);
+		const metadata = found.metadata;
+		const relDir = toPosix(relative(projectRoot, location.dir));
+		listedDirs.add(relDir);
+		writeFileSync(join(location.dir, "descriptor.json"), JSON.stringify(pieceDescriptor(piece, pkg.version, metadata), createJsonReplacer(), 2) + "\n");
+		const piecePackage = location.form === "entry" && location.entryFile ? piecePackageJson({
+			name: piece.name,
+			version: pkg.version,
+			description: metadata.description,
+			main: relative(location.dir, location.entryFile),
+			license: pkg.license,
+			dependencies: externalDependencyVersions(externalByDir.get(resolve(location.dir))?.values() ?? [])
+		}) : bundlePackageJson(location.dir, pkg.version);
+		writeFileSync(join(location.dir, "package.json"), JSON.stringify(piecePackage, null, 2) + "\n");
+		console.log(`piece: ${piece.name}@${pkg.version} -> ${relDir} (${count(metadata.actions)} actions, ${count(metadata.triggers)} triggers)`);
+		built.push({
+			name: piece.name,
+			version: pkg.version,
+			displayName: metadata.displayName,
+			description: metadata.description,
+			bundle: relDir,
+			descriptor: `${relDir}/descriptor.json`
+		});
+	}
+	warnUnlistedPieces(target.pieces, listedDirs);
+	return built;
+}
+function warnUnlistedPieces(planned, listedDirs) {
+	for (const piece of planned) if (!listedDirs.has(toPosix(piece.outDir))) console.warn(`⚠ pieces: pieces/${piece.dir} was built but pieces/index.ts does not list it; a host will not find it`);
+}
+function syncDistManifest(target, built, externalDependencies = {}) {
+	const { projectRoot, outDir } = target;
+	const source = join(projectRoot, "powerhouse.manifest.json");
+	const copy = resolve(projectRoot, outDir, "powerhouse.manifest.json");
+	const shipsPieces = existsSync(pieceListPath(target));
+	const shipsExternal = Object.keys(externalDependencies).length > 0;
+	if (!existsSync(source)) {
+		if (shipsPieces) console.warn("⚠ no powerhouse.manifest.json; pieces will not be listed");
+		if (shipsExternal) console.warn("⚠ no powerhouse.manifest.json; external dependencies will not be listed");
+		return;
+	}
+	mkdirSync(dirname(copy), { recursive: true });
+	copyFileSync(source, copy);
+	if (!shipsPieces && !shipsExternal) return copy;
+	let manifest = JSON.parse(readFileSync(copy, "utf8"));
+	if (shipsPieces) {
+		const enriched = enrichManifestPieces(manifest, built);
+		for (const id of enriched.unbuilt) console.warn(`⚠ manifest lists piece "${id}" but nothing built it`);
+		manifest = enriched.manifest;
+	}
+	if (shipsExternal) manifest = {
+		...manifest,
+		externalDependencies
+	};
+	writeFileSync(copy, JSON.stringify(manifest, null, 2) + "\n");
+	return copy;
+}
+//#endregion
+export { DESCRIBE_HELPERS, DESCRIBE_SCRIPT, assertPieceVersion, assertPiecesOutDir, buildPieces, bundlePackageJson, createDetectionCache, createJsonReplacer, describePieces, enrichManifestPieces, expandEntryGlobs, externalDependencyVersions, externalDepsPlugin, findRequiredFile, pieceDescriptor, pieceListPath, piecePackageJson, planPieces, projectPath, resolvePieceLocation, statSafe, syncDistManifest, undeclaredExternalDependencies };
+
+//# sourceMappingURL=build-pieces.mjs.map

package/dist/clis/build-pieces.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-pieces.mjs","names":[],"sources":["../../clis/external-deps.mts","../../clis/build-pieces.mts"],"sourcesContent":["// External dependencies: a package whose code needs a native addon or a\n// WebAssembly module cannot be inlined, so it stays a bare import the host installs.\nimport { readdirSync, readFileSync, realpathSync } from \"node:fs\";\nimport { isBuiltin } from \"node:module\";\nimport { isAbsolute, join, relative, sep } from \"node:path\";\nimport type { InlineConfig } from \"tsdown\";\n\n/** The files one module needs at run time, and why each was included. */\nexport type FileTrace = {\n  /** Absolute paths. */\n  fileList: Set<string>;\n  /** Absolute path -> the absolute paths of the files that pulled it in. */\n  reasons: Map<string, { parents: Set<string> }>;\n};\n\n/** Traces one file: @vercel/nft's nodeFileTrace, handed in by the CLI. */\nexport type TraceFiles = (file: string) => Promise<FileTrace>;\n\n/** A file the bundle cannot carry: a native addon or a WebAssembly module. */\nexport type RequiredFile = { file: string; kind: \"native\" | \"wasm\" };\n\nexport type ExternalDependency = RequiredFile & {\n  name: string;\n  version: string;\n  /** The first of the package's own files seen importing it. */\n  importer?: string;\n};\n\n/** What one `ph build` learns about packages, shared by all of its builds. */\nexport type DetectionCache = {\n  files: Map<string, Promise<RequiredFile | undefined>>;\n  wasm: Map<string, string | undefined>;\n};\n\nexport const createDetectionCache = (): DetectionCache => ({\n  files: new Map(),\n  wasm: new Map(),\n});\n\nexport type ExternalDepsPluginOptions = {\n  /** The project root the dirs below are relative to. */\n  root?: string;\n  /** Browser build: a native package fails it; WebAssembly is bundled. */\n  browser?: boolean;\n  /** Dirs whose imports the bundler handles as usual: code no host runs. */\n  ignoreDirs?: string[];\n  /** Dirs that may not import a native or WebAssembly package. */\n  forbidDirs?: string[];\n  cache?: DetectionCache;\n};\n\ntype Plugin = NonNullable<InlineConfig[\"plugins\"]>;\n\ntype PackageJson = {\n  name?: string;\n  version?: string;\n  dependencies?: Record<string, string>;\n  optionalDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n};\n\nconst NODE_MODULES = `${sep}node_modules${sep}`;\n\n/** `file` relative to `root`, with forward slashes on every platform. */\nexport function projectPath(root: string, file: string): string {\n  return relative(root, file).split(sep).join(\"/\");\n}\n\n// Windows paths compare case-insensitively, drive letter included.\nconst samePath = (file: string) =>\n  process.platform === \"win32\" ? file.toLowerCase() : file;\n\n// \"@scope/name/sub\" -> \"@scope/name\", \"name/sub\" -> \"name\".\nexport function packageNameOf(specifier: string): string | undefined {\n  if (specifier.startsWith(\".\") || isAbsolute(specifier)) return undefined;\n  const parts = specifier.split(\"/\");\n  const name = specifier.startsWith(\"@\")\n    ? parts.slice(0, 2).join(\"/\")\n    : parts[0];\n  return name || undefined;\n}\n\n// The root of the installed package a file belongs to, if it is in one.\nexport function packageRootOf(file: string): string | undefined {\n  const at = file.lastIndexOf(NODE_MODULES);\n  if (at < 0) return undefined;\n  const rest = file.slice(at + NODE_MODULES.length).split(sep);\n  const depth = rest[0]?.startsWith(\"@\") ? 2 : 1;\n  if (rest.length <= depth) return undefined;\n  return join(file.slice(0, at + NODE_MODULES.length), ...rest.slice(0, depth));\n}\n\nfunction readPackageJson(root: string): PackageJson | undefined {\n  try {\n    return JSON.parse(\n      readFileSync(join(root, \"package.json\"), \"utf8\"),\n    ) as PackageJson;\n  } catch {\n    return undefined;\n  }\n}\n\n// Only links the importer requires count: an optional peer such as\n// ws -> bufferutil is a speed-up the importer runs without.\nfunction requires(importerRoot: string, importedRoot: string): boolean {\n  const importer = readPackageJson(importerRoot);\n  const name = readPackageJson(importedRoot)?.name;\n  if (!importer || !name) return false;\n  return (\n    importer.dependencies?.[name] !== undefined ||\n    importer.optionalDependencies?.[name] !== undefined\n  );\n}\n\n// The first .wasm file in a package's own files. Presence is enough: most\n// packages compute the path or let their caller pass it, so a trace misses it.\nfunction wasmIn(root: string, cache?: DetectionCache): string | undefined {\n  if (cache?.wasm.has(root)) return cache.wasm.get(root);\n  const found = scanForWasm(root);\n  cache?.wasm.set(root, found);\n  return found;\n}\n\nfunction scanForWasm(root: string): string | undefined {\n  try {\n    const found = readdirSync(root, { recursive: true, encoding: \"utf8\" }).find(\n      (file) =>\n        file.endsWith(\".wasm\") && !file.split(sep).includes(\"node_modules\"),\n    );\n    return found && join(root, found);\n  } catch {\n    return undefined;\n  }\n}\n\n/** The first file `entry` cannot load without that a bundle cannot carry. */\nexport async function findRequiredFile(\n  entry: string,\n  trace: TraceFiles,\n  cache?: DetectionCache,\n): Promise<RequiredFile | undefined> {\n  const { fileList, reasons } = await trace(entry);\n  // A tracer reports real paths, and the entry may sit behind a symlink.\n  const start = samePath(realpathSync(entry));\n  // What to report, and the traced file the walk back to the entry starts at.\n  const candidates: (RequiredFile & { from: string })[] = [...fileList]\n    .filter((file) => file.endsWith(\".node\"))\n    .map((file) => ({ file, kind: \"native\" as const, from: file }));\n  {\n    const traced = new Map<string, string>();\n    for (const file of fileList) {\n      const root = packageRootOf(file);\n      if (root && !traced.has(root) && /\\.[cm]?js$/.test(file)) {\n        traced.set(root, file);\n      }\n    }\n    const tracedWasm = [...fileList].filter((file) => file.endsWith(\".wasm\"));\n    for (const [root, from] of traced) {\n      const file =\n        tracedWasm.find((wasm) => packageRootOf(wasm) === root) ??\n        wasmIn(root, cache);\n      if (file) candidates.push({ file, kind: \"wasm\", from });\n    }\n  }\n  for (const { from, ...required } of candidates) {\n    // Back to the entry, crossing into a parent's package only when that\n    // package requires the one being left.\n    const seen = new Set([from]);\n    const queue = [from];\n    while (queue.length > 0) {\n      const file = queue.shift()!;\n      if (samePath(file) === start) return required;\n      for (const parent of reasons.get(file)?.parents ?? []) {\n        if (seen.has(parent)) continue;\n        const fromRoot = packageRootOf(parent);\n        const toRoot = packageRootOf(file);\n        if (\n          fromRoot !== toRoot &&\n          (!fromRoot || !toRoot || !requires(fromRoot, toRoot))\n        ) {\n          continue;\n        }\n        seen.add(parent);\n        queue.push(parent);\n      }\n    }\n  }\n  return undefined;\n}\n\n/** Keeps each package the code imports that needs such a file out of the bundle. */\nexport function externalDepsPlugin(\n  trace: TraceFiles,\n  found: Map<string, ExternalDependency>,\n  options: ExternalDepsPluginOptions = {},\n): Plugin {\n  const cache = options.cache ?? createDetectionCache();\n  const root = options.root ?? process.cwd();\n  const show = (file: string) => projectPath(root, file);\n  const inDir = (id: string, dirs: string[] = []) =>\n    dirs.some((dir) => show(id).startsWith(`${dir}/`));\n  // By resolved file: a package's subpaths can differ in what they load.\n  const detect = (id: string) => {\n    let verdict = cache.files.get(id);\n    if (!verdict) {\n      verdict = findRequiredFile(id, trace, cache);\n      cache.files.set(id, verdict);\n    }\n    return verdict;\n  };\n  return {\n    name: \"powerhouse:external-deps\",\n    async resolveId(source, importer, extra) {\n      // The project's own imports only: whatever a dependency pulls in goes\n      // wherever that dependency goes.\n      if (!importer || importer.includes(NODE_MODULES)) return null;\n      if (isBuiltin(source) || inDir(importer, options.ignoreDirs)) return null;\n      const name = packageNameOf(source);\n      if (!name) return null;\n      const resolved = await this.resolve(source, importer, {\n        ...extra,\n        skipSelf: true,\n      });\n      if (!resolved || resolved.external) return null;\n      const required = await detect(resolved.id);\n      const pkgRoot = packageRootOf(resolved.id);\n      const version = pkgRoot ? readPackageJson(pkgRoot)?.version : undefined;\n      if (!required || !version) return null;\n      const what =\n        required.kind === \"native\"\n          ? `the native addon ${show(required.file)}`\n          : `the WebAssembly module ${show(required.file)}`;\n      if (options.browser) {\n        if (required.kind === \"wasm\") return null;\n        throw new Error(\n          `${show(importer)} imports ${name}, which needs ${what}. ` +\n            \"Native code cannot run in the browser: import it only from subgraphs, switchboard processors or pieces.\",\n        );\n      }\n      if (inDir(importer, options.forbidDirs)) {\n        throw new Error(\n          `${show(importer)} imports ${name}, which needs ${what}. ` +\n            \"Document models run in Connect and on every host: use it from a subgraph, processor or piece instead.\",\n        );\n      }\n      if (!found.has(name)) {\n        found.set(name, { name, version, ...required, importer });\n      }\n      return { id: source, external: true };\n    },\n  };\n}\n\n/**\n * The detected packages `pkg` does not install for its consumers: anything\n * outside dependencies, optionalDependencies and peerDependencies.\n */\nexport function undeclaredExternalDependencies(\n  found: Iterable<ExternalDependency>,\n  pkg: Partial<\n    Record<\n      \"dependencies\" | \"optionalDependencies\" | \"peerDependencies\",\n      Partial<Record<string, string>>\n    >\n  >,\n): ExternalDependency[] {\n  return [...found].filter(\n    (dep) =>\n      pkg.dependencies?.[dep.name] === undefined &&\n      pkg.optionalDependencies?.[dep.name] === undefined &&\n      pkg.peerDependencies?.[dep.name] === undefined,\n  );\n}\n\n/** name -> version, sorted by name. */\nexport function externalDependencyVersions(\n  found: Iterable<ExternalDependency>,\n): Record<string, string> {\n  return Object.fromEntries(\n    [...found]\n      .sort((a, b) => a.name.localeCompare(b.name))\n      .map((dep) => [dep.name, dep.version]),\n  );\n}\n","// The pieces half of a package build: find and bundle each piece whole, load\n// it once in a child process to learn what it is, and write what a host reads.\nimport { execFileSync } from \"node:child_process\";\nimport {\n  copyFileSync,\n  existsSync,\n  mkdirSync,\n  mkdtempSync,\n  readdirSync,\n  readFileSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport {\n  basename,\n  dirname,\n  isAbsolute,\n  join,\n  relative,\n  resolve,\n  sep,\n} from \"node:path\";\nimport type { InlineConfig } from \"tsdown\";\nimport type { Manifest, PieceModule } from \"../document-model/types.js\";\nimport { buildPieceBuildConfig, PIECE_ENTRY_GLOB } from \"./build-config.mjs\";\nimport {\n  externalDependencyVersions,\n  externalDepsPlugin,\n  projectPath,\n  type DetectionCache,\n  type ExternalDependency,\n  type TraceFiles,\n} from \"./external-deps.mjs\";\n\nexport {\n  createDetectionCache,\n  projectPath,\n  findRequiredFile,\n  externalDependencyVersions,\n  externalDepsPlugin,\n  undeclaredExternalDependencies,\n} from \"./external-deps.mjs\";\nexport type {\n  DetectionCache,\n  FileTrace,\n  ExternalDependency,\n  ExternalDepsPluginOptions,\n  TraceFiles,\n} from \"./external-deps.mjs\";\n\nexport type PiecePlan = {\n  /** The directory under pieces/, and so under <outDir>/node/pieces. */\n  dir: string;\n  /** Source entry, relative to the project root: pieces/<dir>/index.ts. */\n  entry: string;\n  /** Where the piece lands, relative to the project root. */\n  outDir: string;\n};\n\n// What buildPieces needs to know about the package it works in: where it is,\n// where it builds to, and which pieces the plan found.\nexport type PieceBuildTarget = {\n  projectRoot: string;\n  outDir: string;\n  pieces: PiecePlan[];\n};\n\n// One entry of pieces/index.ts, as @powerhousedao/pieces-framework declares it.\n// Declared here so the build needs no dependency on a package meant for pieces.\nexport type PackagePiece = {\n  name: string;\n  entry?: string;\n  bundle?: string;\n};\n\n// What a piece says about itself, in the framework's PieceMetadata shape.\n// Read from the built piece, so nothing in the build has to know the framework.\nexport type PieceMetadata = Record<string, unknown> & {\n  displayName?: string;\n  description?: string;\n  actions?: Record<string, unknown>;\n  triggers?: Record<string, unknown>;\n};\n\nexport type DescribedPiece = {\n  name: string;\n  metadata: PieceMetadata;\n};\n\nexport type DescribeResult = {\n  list: PackagePiece[];\n  pieces: DescribedPiece[];\n  errors: { name: string; message: string }[];\n};\n\nexport type BuiltPiece = {\n  name: string;\n  version: string;\n  displayName?: string;\n  description?: string;\n  /** Piece directory, relative to the project root, `/` separated. */\n  bundle: string;\n  /** The descriptor inside it, relative to the project root, `/` separated. */\n  descriptor: string;\n};\n\nexport type PackageIdentity = {\n  name: string;\n  version: string;\n  license?: string;\n};\n\nexport type PieceBuildOptions = {\n  /** The bundler: tsdown's `build`, handed in so this module never loads it. */\n  bundle: (config: InlineConfig) => Promise<unknown>;\n  /** Traces a module's run-time files; without it nothing is kept external. */\n  trace?: TraceFiles;\n  cache?: DetectionCache;\n};\n\nconst toPosix = (p: string) => p.split(sep).join(\"/\");\n\nexport function statSafe(p: string) {\n  try {\n    return statSync(p);\n  } catch {\n    return null;\n  }\n}\n\n// Expand entry globs (single-`*` segments only — the shape `browserEntry`\n// uses) against files on disk, resolving against `root`.\nexport function expandEntryGlobs(root: string, globs: string[]): string[] {\n  const files = new Set<string>();\n  for (const pattern of globs) {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let dirs = [root];\n    for (const seg of segments) {\n      const next: string[] = [];\n      for (const d of dirs) {\n        if (!statSafe(d)?.isDirectory()) continue;\n        if (seg === \"*\") {\n          for (const e of readdirSync(d, { withFileTypes: true })) {\n            next.push(join(d, e.name));\n          }\n        } else {\n          next.push(join(d, seg));\n        }\n      }\n      dirs = next;\n    }\n    for (const f of dirs) {\n      if (statSafe(f)?.isFile()) files.add(f);\n    }\n  }\n  return [...files];\n}\n\n// The pieces a project holds, one per pieces/<dir>/index.ts, sorted by dir so\n// a build log and a manifest read the same from one run to the next.\nexport function planPieces(projectRoot: string, outDir: string): PiecePlan[] {\n  return expandEntryGlobs(projectRoot, [PIECE_ENTRY_GLOB])\n    .map((file) => {\n      const dir = basename(dirname(file));\n      return {\n        dir,\n        entry: relative(projectRoot, file),\n        outDir: join(outDir, \"node\", \"pieces\", dir),\n      };\n    })\n    .sort((a, b) => (a.dir < b.dir ? -1 : a.dir > b.dir ? 1 : 0));\n}\n\n// A JSON.stringify replacer that makes a piece's metadata serializable: props\n// carry resolvers, defaults may be class instances, and a schema may cycle.\nexport function createJsonReplacer() {\n  const ancestors: object[] = [];\n  return function replace(this: unknown, _key: string, value: unknown) {\n    if (typeof value === \"function\" || value === undefined) return undefined;\n    if (typeof value === \"bigint\") return value.toString();\n    if (typeof value !== \"object\" || value === null) return value;\n    // `this` is the holder, so popping back to it leaves the current path.\n    while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();\n    if (ancestors.includes(value)) return undefined;\n    ancestors.push(value);\n    return value;\n  };\n}\n\n// The half of the child script that needs nothing from the job: a test\n// evaluates this text on its own, so neither copy can drift from the other.\n\n// `constructor?.name`: a module may export an Object.create(null), and the\n// real piece is usually beside it in the same module.\nexport const DESCRIBE_HELPERS = `\nconst isRecord = (value) => typeof value === \"object\" && value !== null;\n\nfunction findPiece(mod) {\n  const candidates = [\n    ...Object.values(mod),\n    ...(isRecord(mod.default) ? Object.values(mod.default) : []),\n    mod.default,\n  ];\n  for (const candidate of candidates) {\n    if (isRecord(candidate) && candidate.constructor?.name === \"Piece\") {\n      return candidate;\n    }\n  }\n  for (const candidate of candidates) {\n    if (\n      isRecord(candidate) &&\n      typeof candidate.displayName === \"string\" &&\n      (isRecord(candidate.actions) ||\n        typeof candidate.actions === \"function\" ||\n        typeof candidate.getAction === \"function\")\n    ) {\n      return candidate;\n    }\n  }\n  return undefined;\n}\n\nfunction describePiece(piece) {\n  if (typeof piece.metadata === \"function\") return piece.metadata();\n  const call = (value) => (typeof value === \"function\" ? value.call(piece) : value);\n  return {\n    displayName: piece.displayName,\n    logoUrl: piece.logoUrl,\n    description: piece.description,\n    authors: piece.authors,\n    categories: piece.categories,\n    auth: piece.auth,\n    minimumSupportedRelease: piece.minimumSupportedRelease,\n    maximumSupportedRelease: piece.maximumSupportedRelease,\n    deprecated: piece.deprecated,\n    actions: call(piece.actions) ?? {},\n    triggers: call(piece.triggers) ?? {},\n  };\n}\n\nfunction createJsonReplacer() {\n  const ancestors = [];\n  return function replace(_key, value) {\n    if (typeof value === \"function\" || value === undefined) return undefined;\n    if (typeof value === \"bigint\") return value.toString();\n    if (typeof value !== \"object\" || value === null) return value;\n    while (ancestors.length > 0 && ancestors.at(-1) !== this) ancestors.pop();\n    if (ancestors.includes(value)) return undefined;\n    ancestors.push(value);\n    return value;\n  };\n}\n`;\n\n// Runs in a child node process: loading a piece runs piece-authored top-level\n// code, and the runtime describes pieces in a worker for the same reason.\n\n// A string so it works from `src` under bun or tsx as well as from `dist`. It\n// answers through a file, leaving both its streams to the piece.\nexport const DESCRIBE_SCRIPT = `\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { isAbsolute, join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nconst job = JSON.parse(readFileSync(process.argv[2], \"utf8\"));\n${DESCRIBE_HELPERS}\n// Says why the child gave up in the one place the parent always reads, so a\n// failure reports the cause and never the text of this script.\nfunction fail(message) {\n  writeFileSync(job.outFile, JSON.stringify({ fatal: message }));\n  process.exit(1);\n}\n\n// The module to load for a list entry; a bundle names its own main.\nfunction entryFile(piece) {\n  const declared = piece.entry ?? piece.bundle;\n  if (typeof declared !== \"string\") return undefined;\n  const path = isAbsolute(declared) ? declared : join(job.projectRoot, declared);\n  if (piece.entry) return path;\n  const pkgFile = join(path, \"package.json\");\n  if (!existsSync(pkgFile)) return undefined;\n  const pkg = JSON.parse(readFileSync(pkgFile, \"utf8\"));\n  return join(path, typeof pkg.main === \"string\" ? pkg.main : \"index.mjs\");\n}\n\nlet listModule;\ntry {\n  listModule = await import(pathToFileURL(job.listPath).href);\n} catch (error) {\n  fail(job.listPath + \" threw on import: \" + (error instanceof Error ? error.message : String(error)));\n}\nconst list = listModule.pieces ?? listModule.default;\nif (!Array.isArray(list)) {\n  fail(job.listPath + ' exports no \"pieces\" array');\n}\n\nconst out = { list, pieces: [], errors: [] };\nfor (const piece of list) {\n  const file = entryFile(piece);\n  // A missing file is the parent's to report, with the message it owns.\n  if (!file || !existsSync(file)) continue;\n  try {\n    const mod = await import(pathToFileURL(file).href);\n    const found = findPiece(mod);\n    if (!found) {\n      throw new Error(\n        \"no Piece export found in \" + file + \"; exports: \" + Object.keys(mod).join(\", \"),\n      );\n    }\n    const metadata = JSON.parse(JSON.stringify(describePiece(found), createJsonReplacer()));\n    out.pieces.push({ name: piece.name, metadata });\n  } catch (error) {\n    out.errors.push({\n      name: piece.name,\n      message: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\nwriteFileSync(job.outFile, JSON.stringify(out, createJsonReplacer()));\n`;\n\n// What the child said went wrong, if it got that far, and otherwise how it\n// died: an exit status, never the whole script an `Error.message` carries.\nfunction childFailure(error: unknown, outFile: string): string {\n  try {\n    const answer = JSON.parse(readFileSync(outFile, \"utf8\")) as {\n      fatal?: unknown;\n    };\n    if (typeof answer.fatal === \"string\") return answer.fatal;\n  } catch {\n    // no answer on disk: fall through to the exit status\n  }\n  const { status, signal } = error as {\n    status?: number | null;\n    signal?: string | null;\n  };\n  if (signal) return `the describe child was killed by ${signal}`;\n  return `the describe child exited with code ${status ?? \"unknown\"}`;\n}\n\n// Load the built list and every piece it names in a child process and return\n// what they say about themselves. Throws when the list itself cannot be read.\n\n// Both of the child's streams are the parent's, so a piece that prints at\n// import time is heard rather than mixed into the answer.\nexport function describePieces(\n  projectRoot: string,\n  listPath: string,\n): DescribeResult {\n  const dir = mkdtempSync(join(tmpdir(), \"ph-build-pieces-\"));\n  const rel = toPosix(relative(projectRoot, listPath));\n  try {\n    const jobFile = join(dir, \"job.json\");\n    const scriptFile = join(dir, \"describe.mjs\");\n    const outFile = join(dir, \"describe.json\");\n    writeFileSync(scriptFile, DESCRIBE_SCRIPT);\n    writeFileSync(jobFile, JSON.stringify({ projectRoot, listPath, outFile }));\n    try {\n      execFileSync(process.execPath, [scriptFile, jobFile], {\n        timeout: 60_000,\n        stdio: \"inherit\",\n      });\n    } catch (error) {\n      throw new Error(\n        `pieces: could not load ${rel}: ${childFailure(error, outFile)}`,\n        { cause: error },\n      );\n    }\n    return JSON.parse(readFileSync(outFile, \"utf8\")) as DescribeResult;\n  } finally {\n    rmSync(dir, { recursive: true, force: true });\n  }\n}\n\nexport type PieceLocation = {\n  /** The piece directory, absolute. */\n  dir: string;\n  /** The module file, absolute; unset for a bundle, whose package.json names it. */\n  entryFile?: string;\n  form: \"entry\" | \"bundle\";\n};\n\n// Where a list entry says its built piece is, checked against the disk: a\n// listed piece nobody built would otherwise fail much later, in a host.\nexport function resolvePieceLocation(\n  piece: PackagePiece,\n  projectRoot: string,\n  outDir: string,\n): PieceLocation {\n  const declared = piece.entry ?? piece.bundle;\n  if (typeof declared !== \"string\" || declared === \"\") {\n    throw new Error(\n      `pieces: \"${piece.name}\" declares neither an entry nor a bundle`,\n    );\n  }\n  const path = isAbsolute(declared) ? declared : join(projectRoot, declared);\n  const form = piece.entry ? \"entry\" : \"bundle\";\n  const present =\n    form === \"entry\"\n      ? statSafe(path)?.isFile()\n      : statSafe(join(path, \"package.json\"))?.isFile();\n  if (!present) {\n    throw new Error(\n      `pieces: \"${piece.name}\" declares ${declared}, which is missing`,\n    );\n  }\n  const dir = form === \"entry\" ? dirname(path) : path;\n  // Both forms, not just `entry`: a descriptor.json is written into this\n  // directory, and outside outDir that lands in tracked source.\n  const piecesRoot = resolve(projectRoot, outDir, \"node\", \"pieces\");\n  const inside = relative(piecesRoot, dir);\n  if (inside === \"\" || inside.startsWith(\"..\") || isAbsolute(inside)) {\n    const expected = toPosix(join(outDir, \"node\", \"pieces\"));\n    throw new Error(\n      `pieces: \"${piece.name}\" declares ${declared}, which is outside ${expected}/; ` +\n        `a piece is built to ${expected}/<dir>/index.mjs and its entry must point there`,\n    );\n  }\n  return form === \"entry\" ? { dir, entryFile: path, form } : { dir, form };\n}\n\n// Where the node build leaves the list of pieces a package ships. Its presence\n// on disk, not a pieces/<dir> in the source, is what says a package has them.\nexport function pieceListPath(target: {\n  projectRoot: string;\n  outDir: string;\n}): string {\n  return resolve(\n    target.projectRoot,\n    target.outDir,\n    \"node\",\n    \"pieces\",\n    \"index.mjs\",\n  );\n}\n\n// `dist` is not a default here but a contract: a host reads a piece from\n// dist/node/pieces/<name>, and a list entry names that path literally.\nexport function assertPiecesOutDir(target: {\n  outDir: string;\n  pieces: PiecePlan[];\n}): void {\n  if (target.pieces.length === 0 || target.outDir === \"dist\") return;\n  throw new Error(\n    `pieces: --out-dir ${target.outDir} cannot hold pieces; a piece is loaded from ` +\n      `dist/node/pieces/<name> by the host, so a package that ships pieces builds to dist`,\n  );\n}\n\n// A piece's version is its package's, written by the build; a list entry that\n// declares one is refused, so `name@version` always names one tarball.\nexport function assertPieceVersion(\n  piece: PackagePiece,\n  pkg: PackageIdentity,\n): void {\n  if (\"version\" in piece) {\n    throw new Error(\n      `pieces: \"${piece.name}\" declares version ${String(piece.version)}; a piece takes its package's version (${pkg.version}), so remove \"version\" from pieces/index.ts`,\n    );\n  }\n}\n\n// The package.json written beside a piece built from an `entry`, giving the\n// directory npm-bundle shape so a registry can serve it on its own.\nexport function piecePackageJson(options: {\n  name: string;\n  version: string;\n  description?: string;\n  main: string;\n  license?: string;\n  dependencies?: Record<string, string>;\n}): Record<string, unknown> {\n  return {\n    name: options.name,\n    version: options.version,\n    description: options.description ?? \"\",\n    type: \"module\",\n    main: options.main,\n    ...(options.license ? { license: options.license } : {}),\n    // Only external packages: everything else is inlined, and a host installs\n    // what is listed here before it loads the piece.\n    dependencies: options.dependencies ?? {},\n  };\n}\n\n// A prebuilt bundle's own package.json, restamped with the package's version.\nexport function bundlePackageJson(\n  dir: string,\n  version: string,\n): Record<string, unknown> {\n  const current = JSON.parse(\n    readFileSync(join(dir, \"package.json\"), \"utf8\"),\n  ) as Record<string, unknown>;\n  return { ...current, version };\n}\n\n// The descriptor written beside a piece: the list's name, the package's version,\n// then whatever the piece said about itself, in the framework's PieceMetadata shape.\nexport function pieceDescriptor(\n  piece: PackagePiece,\n  version: string,\n  metadata: PieceMetadata,\n): Record<string, unknown> {\n  const { name: _name, version: _version, ...rest } = metadata;\n  return { name: piece.name, version, ...rest };\n}\n\n// The manifest's `pieces` with what the build learned: a built piece replaces\n// the source entry with its id in place, or is appended at the end.\n\n// A source entry nothing built is kept as it is and returned as `unbuilt`,\n// for the caller to warn about.\nexport function enrichManifestPieces(\n  manifest: Manifest,\n  built: BuiltPiece[],\n): { manifest: Manifest; unbuilt: string[] } {\n  const byId = new Map(built.map((piece) => [piece.name, piece]));\n  const toModule = (piece: BuiltPiece): PieceModule => ({\n    id: piece.name,\n    name: piece.displayName ?? piece.name,\n    version: piece.version,\n    ...(piece.description ? { description: piece.description } : {}),\n    bundle: piece.bundle,\n    descriptor: piece.descriptor,\n  });\n  const unbuilt: string[] = [];\n  const seen = new Set<string>();\n  const pieces: PieceModule[] = (manifest.pieces ?? []).map((entry) => {\n    const hit = byId.get(entry.id);\n    if (!hit) {\n      unbuilt.push(entry.id);\n      return entry;\n    }\n    seen.add(entry.id);\n    return toModule(hit);\n  });\n  for (const piece of built) {\n    if (!seen.has(piece.name)) pieces.push(toModule(piece));\n  }\n  return { manifest: { ...manifest, pieces }, unbuilt };\n}\n\nconst count = (record: unknown) =>\n  typeof record === \"object\" && record !== null\n    ? Object.keys(record).length\n    : 0;\n\n// Build every planned piece, then read the built list and describe what it\n// names. Returns what was built, for the manifest.\nexport async function buildPieces(\n  target: PieceBuildTarget,\n  pkg: PackageIdentity,\n  options: PieceBuildOptions,\n): Promise<BuiltPiece[]> {\n  const { projectRoot, outDir } = target;\n  assertPiecesOutDir(target);\n  // resolve, not join: an absolute --out-dir is what the browser and node\n  // steps hand tsdown, and joining it onto the project root mangles it.\n  const externalByDir = new Map<string, Map<string, ExternalDependency>>();\n  for (const piece of target.pieces) {\n    console.log(`\\n▶ Building piece ${piece.dir}...`);\n    const outDir = resolve(projectRoot, piece.outDir);\n    const external = new Map<string, ExternalDependency>();\n    await options.bundle(\n      buildPieceBuildConfig({\n        entry: resolve(projectRoot, piece.entry),\n        outDir,\n        ...(options.trace\n          ? {\n              plugins: [\n                externalDepsPlugin(options.trace, external, {\n                  root: projectRoot,\n                  ...(options.cache ? { cache: options.cache } : {}),\n                }),\n              ],\n            }\n          : {}),\n      }),\n    );\n    for (const dep of external.values()) {\n      console.log(\n        `piece ${piece.dir}: ${dep.name}@${dep.version} stays external, it needs ${projectPath(projectRoot, dep.file)}`,\n      );\n    }\n    externalByDir.set(outDir, external);\n  }\n\n  // The list is the source of truth for names; a package that\n  // built pieces without a list has nothing a host could read.\n  const listPath = pieceListPath(target);\n  if (!existsSync(listPath)) {\n    throw new Error(\n      `pieces: ${toPosix(relative(projectRoot, listPath))} was not built; ` +\n        `pieces/index.ts must export the list of pieces this package ships`,\n    );\n  }\n  const described = describePieces(projectRoot, listPath);\n\n  const built: BuiltPiece[] = [];\n  const listedDirs = new Set<string>();\n  for (const piece of described.list) {\n    const location = resolvePieceLocation(piece, projectRoot, outDir);\n    assertPieceVersion(piece, pkg);\n    const failure = described.errors.find((e) => e.name === piece.name);\n    if (failure) {\n      throw new Error(\n        `pieces: \"${piece.name}\" could not be described: ${failure.message}`,\n      );\n    }\n    const found = described.pieces.find((p) => p.name === piece.name);\n    if (!found) {\n      throw new Error(`pieces: \"${piece.name}\" was not described`);\n    }\n    const metadata = found.metadata;\n    const relDir = toPosix(relative(projectRoot, location.dir));\n    listedDirs.add(relDir);\n\n    writeFileSync(\n      join(location.dir, \"descriptor.json\"),\n      JSON.stringify(\n        pieceDescriptor(piece, pkg.version, metadata),\n        createJsonReplacer(),\n        2,\n      ) + \"\\n\",\n    );\n    const piecePackage =\n      location.form === \"entry\" && location.entryFile\n        ? piecePackageJson({\n            name: piece.name,\n            version: pkg.version,\n            description: metadata.description,\n            main: relative(location.dir, location.entryFile),\n            license: pkg.license,\n            dependencies: externalDependencyVersions(\n              externalByDir.get(resolve(location.dir))?.values() ?? [],\n            ),\n          })\n        : bundlePackageJson(location.dir, pkg.version);\n    writeFileSync(\n      join(location.dir, \"package.json\"),\n      JSON.stringify(piecePackage, null, 2) + \"\\n\",\n    );\n    console.log(\n      `piece: ${piece.name}@${pkg.version} -> ${relDir} ` +\n        `(${count(metadata.actions)} actions, ${count(metadata.triggers)} triggers)`,\n    );\n    built.push({\n      name: piece.name,\n      version: pkg.version,\n      displayName: metadata.displayName,\n      description: metadata.description,\n      bundle: relDir,\n      descriptor: `${relDir}/descriptor.json`,\n    });\n  }\n\n  warnUnlistedPieces(target.pieces, listedDirs);\n  return built;\n}\n\n// A built piece no list entry points into ships without a host ever finding it.\nfunction warnUnlistedPieces(\n  planned: PiecePlan[],\n  listedDirs: Set<string>,\n): void {\n  for (const piece of planned) {\n    if (!listedDirs.has(toPosix(piece.outDir))) {\n      console.warn(\n        `⚠ pieces: pieces/${piece.dir} was built but pieces/index.ts does not list it; a host will not find it`,\n      );\n    }\n  }\n}\n\n// Make sure the manifest ships under outDir (tsdown copies it only in the\n// browser build) and, when pieces were built, list them in that copy.\n\n// Always copied afresh: only <outDir>/node is cleaned by the builds, so a copy\n// left by the last build would otherwise outlive an edit to the source.\n\n// The source file is never written. Returns the path of the copy, if any.\nexport function syncDistManifest(\n  target: PieceBuildTarget,\n  built: BuiltPiece[],\n  externalDependencies: Record<string, string> = {},\n): string | undefined {\n  const { projectRoot, outDir } = target;\n  const source = join(projectRoot, \"powerhouse.manifest.json\");\n  // resolve, not join: an absolute --out-dir is a location, not a suffix.\n  const copy = resolve(projectRoot, outDir, \"powerhouse.manifest.json\");\n  // The built list, not the source plan: a package whose pieces are all\n  // `bundle:` entries has no pieces/<dir> and still ships pieces.\n  const shipsPieces = existsSync(pieceListPath(target));\n  const shipsExternal = Object.keys(externalDependencies).length > 0;\n  if (!existsSync(source)) {\n    if (shipsPieces) {\n      console.warn(\"⚠ no powerhouse.manifest.json; pieces will not be listed\");\n    }\n    if (shipsExternal) {\n      console.warn(\n        \"⚠ no powerhouse.manifest.json; external dependencies will not be listed\",\n      );\n    }\n    return undefined;\n  }\n  mkdirSync(dirname(copy), { recursive: true });\n  copyFileSync(source, copy);\n  if (!shipsPieces && !shipsExternal) return copy;\n\n  let manifest = JSON.parse(readFileSync(copy, \"utf8\")) as Manifest;\n  if (shipsPieces) {\n    const enriched = enrichManifestPieces(manifest, built);\n    for (const id of enriched.unbuilt) {\n      console.warn(`⚠ manifest lists piece \"${id}\" but nothing built it`);\n    }\n    manifest = enriched.manifest;\n  }\n  if (shipsExternal) manifest = { ...manifest, externalDependencies };\n  writeFileSync(copy, JSON.stringify(manifest, null, 2) + \"\\n\");\n  return copy;\n}\n"],"mappings":"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"}

package/dist/clis/command-names.d.mts

@@ -1,5 +1,5 @@
 //#region clis/command-names.d.ts
-declare const phCliCommandNames: readonly ["generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
+export declare const phCliCommandNames: readonly ["generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
 //#endregion
-export { phCliCommandNames };
+export {};
 //# sourceMappingURL=command-names.d.mts.map