@powerhousedao/shared 6.0.2-staging.6 → 6.0.2-staging.7

package/dist/clis/index.mjs

@@ -1,10 +1,9 @@
 import { createRequire } from "node:module";
 import { array, boolean, command, flag, multioption, number, oneOf, option, optional, positional, rest, restPositionals, string } from "cmd-ts";
-import { AGENTS, detect, resolveCommand } from "package-manager-detector";
+import { AGENTS as AGENTS$1 } from "package-manager-detector/constants";
 import { homedir } from "node:os";
 import path, { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { esmExternalRequirePlugin } from "rolldown/plugins";
 import chalk from "chalk";
 import fsPromises, { mkdir, stat, writeFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
@@ -114,6 +113,7 @@ function getConfig(path = "./powerhouse.config.json") {
 }
 //#endregion
 //#region clis/args/common.ts
+const AGENTS = AGENTS$1;
 const debugArgs = { debug: flag({
 	type: optional(boolean),
 	long: "debug",
@@ -277,10 +277,10 @@ const commonArgs = {
 	...debugArgs
 };
 const commonServerArgs = {
-	host: flag({
-		type: optional(boolean),
+	host: option({
+		type: optional(string),
 		long: "host",
-		description: "Expose the server to the network"
+		description: "Expose the server to the network. Pass an IP (e.g. 0.0.0.0) to bind to a specific address."
 	}),
 	open: flag({
 		type: optional(boolean),
@@ -338,13 +338,6 @@ const accessTokenArgs = {
 	...debugArgs
 };
 //#endregion
-//#region clis/args/code.ts
-const codeArgs = { rest: restPositionals({
-	type: string,
-	displayName: "args",
-	description: "Optional prompt or subcommand to forward to ph-clint."
-}) };
-//#endregion
 //#region clis/args/connect.ts
 const connectStudioArgs = {
 	port: option({
@@ -566,6 +559,12 @@ const installArgs = {
 		long: "local",
 		description: "Also install packages into node_modules (marks them as provider: \"local\" so they get bundled into ph connect build)"
 	}),
+	allowBuild: multioption({
+		type: array(string),
+		long: "allow-build",
+		description: "A list of package names that are allowed to run postinstall scripts during installation.",
+		defaultValue: () => []
+	}),
 	...packageManagerArgs,
 	...debugArgs
 };
@@ -610,6 +609,11 @@ const loginArgs = {
 //#endregion
 //#region clis/args/migrate.ts
 const migrateArgs = {
+	versionPositional: positional({
+		type: optional(string),
+		displayName: "version",
+		description: "The version to migrate to. Accepts a valid semver version or `staging`, `dev`, `latest`."
+	}),
 	version: option({
 		long: "version",
 		short: "v",
@@ -618,6 +622,12 @@ const migrateArgs = {
 		defaultValue: () => "latest",
 		defaultValueIsSerializable: true
 	}),
+	force: flag({
+		type: optional(boolean),
+		long: "force",
+		short: "f",
+		description: "Run migrate from the bundled codegen even if the target version cannot be resolved from the npm registry or differs from the installed ph-cli version."
+	}),
 	...debugArgs
 };
 //#endregion
@@ -635,6 +645,24 @@ const publishArgs = {
 	})
 };
 //#endregion
+//#region clis/args/registry.ts
+const DEFAULT_REGISTRY_LOGIN_EXPIRY = "30d";
+const registryLoginArgs = {
+	registry: option({
+		type: optional(string),
+		long: "registry",
+		description: "Registry URL to log in to (overrides PH_REGISTRY_URL and powerhouse.config.json)"
+	}),
+	expiry: option({
+		type: string,
+		long: "expiry",
+		defaultValue: () => "30d",
+		description: "Token expiry — formats: '7d' (days), '24h' (hours), '3600' (seconds).",
+		defaultValueIsSerializable: true
+	}),
+	...debugArgs
+};
+//#endregion
 //#region clis/args/switchboard.ts
 const switchboardArgs = {
 	...vetraSwitchboardArgs,
@@ -774,97 +802,132 @@ const vetraArgs = {
 	...vetraSwitchboardArgs
 };
 //#endregion
+//#region clis/command-names.ts
+const phCliCommandNames = [
+	"generate",
+	"vetra",
+	"connect",
+	"build",
+	"publish",
+	"list",
+	"l",
+	"access-token",
+	"registry-login",
+	"inspect",
+	"is",
+	"migrate",
+	"switchboard",
+	"reactor",
+	"login",
+	"logout",
+	"install",
+	"add",
+	"i",
+	"uninstall",
+	"remove"
+];
+//#endregion
 //#region clis/args/help.ts
+function helpCommand(config) {
+	const aliases = config.aliases ?? [];
+	return Object.assign(command({
+		...config,
+		aliases: [...aliases]
+	}), {
+		name: config.name,
+		aliases
+	});
+}
 const phCliHelpCommands = {
-	generate: command({
+	generate: helpCommand({
 		name: "generate",
 		args: generateArgs,
 		description: "Generate powerhouse code",
 		handler: () => {}
 	}),
-	vetra: command({
+	vetra: helpCommand({
 		name: "vetra",
 		args: vetraArgs,
 		description: "Starts Vetra development environment with switchboard, reactor, and connect",
 		handler: () => {}
 	}),
-	connect: command({
+	connect: helpCommand({
 		name: "connect",
 		args: connectArgs,
 		description: "Powerhouse Connect commands",
 		handler: () => {}
 	}),
-	build: command({
+	build: helpCommand({
 		name: "build",
 		args: debugArgs,
 		description: "Build your project for publishing to the registry",
 		handler: () => {}
 	}),
-	code: command({
-		name: "code",
-		args: codeArgs,
-		description: "Open the Powerhouse coding agent (REPL backed by Mastra)",
-		handler: () => {}
-	}),
-	publish: command({
+	publish: helpCommand({
 		name: "publish",
 		args: publishArgs,
 		description: "Publish a package to the Powerhouse registry",
 		handler: () => {}
 	}),
-	list: command({
+	list: helpCommand({
 		name: "list",
 		aliases: ["l"],
 		args: listArgs,
 		description: "List installed packages",
 		handler: () => {}
 	}),
-	"access-token": command({
+	"access-token": helpCommand({
 		name: "access-token",
 		args: accessTokenArgs,
 		description: "Generate a bearer token for API authentication",
 		handler: () => {}
 	}),
-	inspect: command({
+	"registry-login": helpCommand({
+		name: "registry-login",
+		args: registryLoginArgs,
+		description: "Log in to a Powerhouse registry (writes a Renown bearer token to ~/.npmrc)",
+		handler: () => {}
+	}),
+	inspect: helpCommand({
 		name: "inspect",
 		aliases: ["is"],
 		args: inspectArgs,
 		description: "Inspect a package",
 		handler: () => {}
 	}),
-	migrate: command({
+	migrate: helpCommand({
 		name: "migrate",
 		args: migrateArgs,
 		description: "Run migrations",
 		handler: () => {}
 	}),
-	switchboard: command({
+	switchboard: helpCommand({
 		name: "switchboard",
 		aliases: ["reactor"],
 		args: switchboardArgs,
 		description: "Starts local Switchboard",
 		handler: () => {}
 	}),
-	login: command({
+	login: helpCommand({
 		name: "login",
 		args: loginArgs,
 		description: "Authenticate with Renown using your Ethereum wallet",
 		handler: () => {}
 	}),
-	logout: command({
+	logout: helpCommand({
 		name: "logout",
 		args: loginArgs,
 		description: "Deletes an existing session created with 'ph login'",
 		handler: () => {}
 	}),
-	install: command({
+	install: helpCommand({
 		name: "install",
 		aliases: ["add", "i"],
 		args: installArgs,
 		description: "Install a Powerhouse dependency",
 		handler: () => {}
 	}),
-	uninstall: command({
+	uninstall: helpCommand({
 		name: "uninstall",
 		aliases: ["remove"],
 		args: uninstallArgs,
@@ -872,9 +935,6 @@ const phCliHelpCommands = {
 		handler: () => {}
 	})
 };
-const phCliCommandNames = Object.values(phCliHelpCommands).flatMap((cmd) => {
-	return [cmd.name, ...cmd.aliases ?? []];
-});
 //#endregion
 //#region clis/args/init.ts
 const initArgs = {
@@ -958,88 +1018,6 @@ const unpublishArgs = {
 	})
 };
 //#endregion
-//#region clis/build-config.ts
-const entry = [
-	"index.ts",
-	"document-models/index.ts",
-	"document-models/*/index.ts",
-	"document-models/*/module.ts",
-	"editors/index.ts",
-	"editors/*/index.ts",
-	"editors/*/module.ts",
-	"subgraphs/index.ts",
-	"subgraphs/*/index.ts",
-	"processors/index.ts",
-	"processors/*/index.ts"
-];
-const alwaysBundle = ["**"];
-const reactExternals = [
-	"react",
-	"react-dom",
-	"react/jsx-runtime",
-	"react-dom/client"
-];
-const nodeNeverBundle = [
-	"@powerhousedao/connect",
-	"@powerhousedao/ph-cli",
-	"react",
-	"react-dom",
-	"react/jsx-runtime",
-	"react-dom/client",
-	"tailwindcss",
-	"vitest",
-	"tsdown",
-	"@tailwindcss/cli",
-	"@vitejs/plugin-react",
-	"@testing-library/jest-dom",
-	"@testing-library/react",
-	"@testing-library/user-event",
-	"@types/node",
-	"@types/react",
-	"@types/react-dom",
-	"@electric-sql/pglite",
-	"@electric-sql/pglite-tools"
-];
-const browserNeverBundle = [...nodeNeverBundle, "@powerhousedao/reactor-api"];
-const copy = [{
-	from: "powerhouse.manifest.json",
-	to: "dist"
-}];
-const config = false;
-const clean$1 = true;
-const dts = true;
-const sourcemap = true;
-const browserBuildConfig = {
-	entry,
-	deps: {
-		alwaysBundle,
-		neverBundle: browserNeverBundle
-	},
-	platform: "browser",
-	copy,
-	config,
-	clean: clean$1,
-	dts,
-	sourcemap,
-	plugins: [esmExternalRequirePlugin({
-		external: reactExternals,
-		skipDuplicateCheck: true
-	})],
-	inputOptions: { experimental: { resolveNewUrlToAsset: true } }
-};
-const nodeBuildConfig = {
-	entry,
-	deps: {
-		alwaysBundle,
-		neverBundle: nodeNeverBundle
-	},
-	platform: "node",
-	config,
-	clean: clean$1,
-	dts,
-	sourcemap
-};
-//#endregion
 //#region ../../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js
 var require_picocolors = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	let p = process || {}, argv = p.argv || [], env = p.env || {};
@@ -6864,9 +6842,11 @@ async function getGlobalPowerhouseProjectDirPath() {
 	return POWERHOUSE_GLOBAL_DIR;
 }
 async function getPackageManagerAtPowerhouseProjectDirPath(projectDirPath) {
+	const { detect } = await import("package-manager-detector");
 	return (await detect({ cwd: projectDirPath }))?.agent;
 }
-function getPowerhouseProjectInstallCommand(packageManagerAgent, args = []) {
+async function getPowerhouseProjectInstallCommand(packageManagerAgent, args = []) {
+	const { resolveCommand } = await import("package-manager-detector");
 	const resolvedCommand = resolveCommand(packageManagerAgent, "install", args);
 	if (!resolvedCommand) {
 		console.warn(`Failed to get install command in project directory, calling back to 'npm install'`);
@@ -6878,6 +6858,7 @@ function getPowerhouseProjectInstallCommand(packageManagerAgent, args = []) {
 async function getPowerhouseProjectUninstallCommand(projectDirPath, args = []) {
 	const agent = await getPackageManagerAtPowerhouseProjectDirPath(projectDirPath);
 	if (!agent) console.warn(`Failed to detect package manager in project directory, falling back to 'npm' as package manager.`);
+	const { resolveCommand } = await import("package-manager-detector");
 	const resolvedCommand = resolveCommand(agent ?? "npm", "uninstall", args);
 	if (!resolvedCommand) {
 		console.warn(`Failed to get uninstall command in project directory, calling back to 'npm uninstall'`);
@@ -7080,16 +7061,15 @@ function scrubEvent(event) {
 	} catch {}
 	return event;
 }
-let initialized = false;
 /**
 * Initializes Sentry for CLI error reporting if telemetry is enabled.
 * Safe to call multiple times; only the first call takes effect.
 */
 async function initCliTelemetry(opts) {
-	if (initialized) return;
 	if (!await resolveTelemetryConsent()) return;
-	const Sentry = await import("@sentry/node");
-	Sentry.init({
+	const Sentry = await import("@sentry/node-core/light");
+	const os = await import("node:os");
+	const sentryClient = Sentry.init({
 		dsn: SENTRY_DSN,
 		release: opts.release,
 		environment: process.env.NODE_ENV || "production",
@@ -7106,19 +7086,56 @@ async function initCliTelemetry(opts) {
 	});
 	Sentry.setTag("cli_name", opts.cliName);
 	if (opts.release) Sentry.setTag("cli_version", opts.release);
-	initialized = true;
-}
-/**
-* Captures an error (if telemetry is initialized) and flushes before the
-* caller calls process.exit(). Safe no-op when telemetry is disabled.
-*/
-async function captureCliError(err) {
-	if (!initialized) return;
-	try {
-		const Sentry = await import("@sentry/node");
-		Sentry.captureException(err);
-		await Sentry.flush(2e3);
-	} catch {}
+	Sentry.setTag("os", process.platform);
+	Sentry.setTag("arch", process.arch);
+	Sentry.setTag("node_version", process.version);
+	Sentry.setTag("ci", String(Boolean(process.env.CI)));
+	Sentry.setTag("tty", String(Boolean(process.stdin.isTTY)));
+	Sentry.setContext("runtime", {
+		name: "node",
+		version: process.version
+	});
+	Sentry.setContext("os", {
+		name: process.platform,
+		version: os.release()
+	});
+	Sentry.setContext("device", { arch: process.arch });
+	if (!sentryClient) return;
+	return {
+		attachInvocationContext(info) {
+			const argv = info.argv.map(scrubString);
+			const flagNames = info.argv.filter((a) => a.startsWith("-")).map((a) => a.split("=")[0]);
+			if (info.command) Sentry.setTag("command", info.command);
+			if (info.subcommand) Sentry.setTag("subcommand", info.subcommand);
+			if (info.pm) Sentry.setTag("pm", info.pm);
+			Sentry.setContext("invocation", {
+				command: info.command,
+				subcommand: info.subcommand,
+				argv,
+				flag_names: flagNames,
+				argv_count: argv.length,
+				cwd: info.cwd ? scrubString(info.cwd) : void 0
+			});
+			Sentry.addBreadcrumb({
+				category: "cli",
+				level: "info",
+				message: "cli invoked",
+				data: {
+					command: info.command,
+					pm: info.pm,
+					tty: Boolean(process.stdin.isTTY),
+					ci: Boolean(process.env.CI)
+				}
+			});
+		},
+		captureCliError: async (err, captureOpts) => {
+			try {
+				Sentry.setTag("error_kind", captureOpts?.kind ?? "crash");
+				sentryClient.captureException(err);
+				await sentryClient.flush(2e3);
+			} catch {}
+		}
+	};
 }
 /**
 * Explicitly set telemetry consent (used by `ph telemetry on|off`).
@@ -7255,6 +7272,7 @@ function buildPnpmLink(packageName, monorepoPath) {
 }
 //#endregion
 //#region clis/utils.ts
+var import_lt = /* @__PURE__ */ __toESM(require_lt(), 1);
 var NodeVersionError = class extends Error {
 	constructor(currentVersion, minimumVersion) {
 		super(`Node version ${minimumVersion} or higher is required. Current version: ${currentVersion}`);
@@ -7266,9 +7284,9 @@ var NodeVersionError = class extends Error {
 };
 function assertNodeVersion(nodeVersion = process.versions.node) {
 	if (!nodeVersion) return;
-	if ((0, import_semver.lt)(nodeVersion, "24.0.0")) throw new NodeVersionError(nodeVersion, MINIMUM_NODE_VERSION);
+	if ((0, import_lt.default)(nodeVersion, "24.0.0")) throw new NodeVersionError(nodeVersion, MINIMUM_NODE_VERSION);
 }
 //#endregion
-export { DEFAULT_CONFIG, DEFAULT_CONNECT_OUTDIR, DEFAULT_CONNECT_PREVIEW_PORT, DEFAULT_CONNECT_STUDIO_PORT, DEFAULT_EXPIRY_DAYS, DEFAULT_EXPIRY_SECONDS, DEFAULT_REGISTRY_URL, DEFAULT_RENOWN_URL, DEFAULT_SWITCHBOARD_PORT, DEFAULT_TIMEOUT, DEFAULT_VETRA_CONNECT_PORT, DEFAULT_VETRA_DRIVE_ID, DRIVES_PRESERVE_STRATEGIES, HOME_DIR, LOG_LEVELS, MINIMUM_NODE_VERSION, NodeVersionError, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, SECONDS_IN_DAY, SERVICE_ACTIONS, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, accessTokenArgs, assertNodeVersion, browserBuildConfig, buildArgs, captureCliError, codeArgs, commonArgs, commonServerArgs, connectArgs, connectBasePath, connectBuildArgs, connectPreviewArgs, connectStudioArgs, debugArgs, defaultDrivesUrl, directoryExists, directoryExistsSync, disableLocalPackages, drivesPreserveStrategy, fetchNpmVersionFromRegistryForTag, fetchPackageVersionFromNpmRegistry, fileExists, fileExistsSync, force, generateArgs, getConfig, getGlobalPowerhouseProjectDirPath, getLocalPowerhouseProjectDirPath, getPackageManagerAtPowerhouseProjectDirPath, getPackageManagerCommand, getPackageNameFromPackageJson, getPackageVersionFromPackageJson, getPhCliVersionInfo, getPhCmdVersionInfo, getPowerhouseProjectInfo, getPowerhouseProjectInstallCommand, getPowerhouseProjectUninstallCommand, getTagFromVersion, getTelemetryStatus, handleMutuallyExclusiveOptions, https, httpsCertFile, httpsKeyFile, initArgs, initCliTelemetry, inspectArgs, installArgs, isDirectory, isFile, isPowerhouseProject, listArgs, localPackage, logLevel, logVersionUpdate, loginArgs, makeDependenciesWithVersions, makeVersionedDependencies, migrateArgs, nodeBuildConfig, packageManagerArgs, packages, parsePackageManager, parsePackageVersion, parseTag, phCliCommandNames, phCliHelpCommands, publishArgs, resolveTelemetryConsent, runCmd, runUseLocal, serviceArgs, setTelemetryConsent, spawnAsync, switchboardArgs, uninstallArgs, unpublishArgs, vetraArgs, vetraSwitchboardArgs, writeFileEnsuringDir };
+export { AGENTS, DEFAULT_CONFIG, DEFAULT_CONNECT_OUTDIR, DEFAULT_CONNECT_PREVIEW_PORT, DEFAULT_CONNECT_STUDIO_PORT, DEFAULT_EXPIRY_DAYS, DEFAULT_EXPIRY_SECONDS, DEFAULT_REGISTRY_LOGIN_EXPIRY, DEFAULT_REGISTRY_URL, DEFAULT_RENOWN_URL, DEFAULT_SWITCHBOARD_PORT, DEFAULT_TIMEOUT, DEFAULT_VETRA_CONNECT_PORT, DEFAULT_VETRA_DRIVE_ID, DRIVES_PRESERVE_STRATEGIES, HOME_DIR, LOG_LEVELS, MINIMUM_NODE_VERSION, NodeVersionError, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, SECONDS_IN_DAY, SERVICE_ACTIONS, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, accessTokenArgs, assertNodeVersion, buildArgs, commonArgs, commonServerArgs, connectArgs, connectBasePath, connectBuildArgs, connectPreviewArgs, connectStudioArgs, debugArgs, defaultDrivesUrl, directoryExists, directoryExistsSync, disableLocalPackages, drivesPreserveStrategy, fetchNpmVersionFromRegistryForTag, fetchPackageVersionFromNpmRegistry, fileExists, fileExistsSync, force, generateArgs, getConfig, getGlobalPowerhouseProjectDirPath, getLocalPowerhouseProjectDirPath, getPackageManagerAtPowerhouseProjectDirPath, getPackageManagerCommand, getPackageNameFromPackageJson, getPackageVersionFromPackageJson, getPhCliVersionInfo, getPhCmdVersionInfo, getPowerhouseProjectInfo, getPowerhouseProjectInstallCommand, getPowerhouseProjectUninstallCommand, getTagFromVersion, getTelemetryStatus, handleMutuallyExclusiveOptions, https, httpsCertFile, httpsKeyFile, initArgs, initCliTelemetry, inspectArgs, installArgs, isDirectory, isFile, isPowerhouseProject, listArgs, localPackage, logLevel, logVersionUpdate, loginArgs, makeDependenciesWithVersions, makeVersionedDependencies, migrateArgs, packageManagerArgs, packages, parsePackageManager, parsePackageVersion, parseTag, phCliCommandNames, phCliHelpCommands, publishArgs, registryLoginArgs, resolveTelemetryConsent, runCmd, runUseLocal, serviceArgs, setTelemetryConsent, spawnAsync, switchboardArgs, uninstallArgs, unpublishArgs, vetraArgs, vetraSwitchboardArgs, writeFileEnsuringDir };
 
 //# sourceMappingURL=index.mjs.map