@powerhousedao/shared 6.2.2-dev.70 → 6.2.2-dev.72

package/dist/clis/index.mjs

@@ -4,6 +4,7 @@ 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 dotenv from "dotenv";
 import chalk from "chalk";
 import fsPromises, { mkdir, stat, writeFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
@@ -67,6 +68,10 @@ const DEFAULT_CONNECT_OUTDIR = ".ph/connect-build/dist/";
 const DEFAULT_RENOWN_URL = "https://www.renown.id";
 const DEFAULT_REGISTRY_URL = "https://registry.vetra.io";
 const DEFAULT_SWITCHBOARD_PORT = 4001;
+const PROJECT_PORT_BAND_SIZE = 1e3;
+const PROJECT_PORT_BAND_SWITCHBOARD = 7e3;
+const PROJECT_PORT_BAND_STUDIO = 6e3;
+const PROJECT_PORT_BAND_VETRA_CONNECT = 2e3;
 const DEFAULT_VETRA_DRIVE_ID = "vetra";
 const MINIMUM_NODE_VERSION = "24.0.0";
 const PH_BIN = "ph-cli-legacy";
@@ -1081,22 +1086,71 @@ const uninstallArgs = {
 	...debugArgs
 };
 //#endregion
+//#region clis/project-env.ts
+let loadedFor;
+/**
+* Load the project's `.env.local` and `.env` into `process.env`.
+*
+* `dotenv` never overwrites a variable that is already set, so loading
+* `.env.local` first and `.env` second produces the precedence the CLI
+* documents: a real `process.env` value beats `.env.local`, which beats
+* `.env`. One `process.env` lookup afterwards therefore covers all three
+* sources.
+*
+* Idempotent per directory — CLI argument defaults call it lazily and may
+* call it more than once per process.
+*/
+function loadProjectEnv(cwd = process.cwd()) {
+	if (loadedFor === cwd) return;
+	loadedFor = cwd;
+	dotenv.config({ path: join(cwd, ".env.local") });
+	dotenv.config({ path: join(cwd, ".env") });
+}
+/**
+* Read an environment variable as a TCP port.
+*
+* Anything that is not a plain integer in 1-65535 is ignored rather than
+* throwing: a typo in `.env` should fall through to the next source in the
+* precedence chain, not break the CLI.
+*/
+function readPortEnv(name) {
+	const raw = process.env[name]?.trim();
+	if (!raw || !/^\d+$/.test(raw)) return void 0;
+	const port = Number(raw);
+	if (port < 1 || port > 65535) return void 0;
+	return port;
+}
+//#endregion
 //#region clis/args/vetra.ts
+/**
+* Resolve the Vetra Switchboard port.
+*
+* Precedence: CLI flag (cmd-ts applies that above this function) →
+* `process.env` → `.env.local` → `.env` → `powerhouse.config.json` →
+* constant. `loadProjectEnv` folds the two files into `process.env` without
+* clobbering anything already set, so a single lookup covers the middle three.
+*/
+function resolveSwitchboardPortDefault() {
+	loadProjectEnv();
+	return readPortEnv("PH_SWITCHBOARD_PORT") ?? getConfig().reactor?.port ?? 4001;
+}
+/** Resolve the Vetra Connect port through the same chain. */
+function resolveConnectPortDefault() {
+	loadProjectEnv();
+	return readPortEnv("PH_VETRA_CONNECT_PORT") ?? getConfig().vetra?.connectPort ?? 3001;
+}
 const vetraArgs = {
 	switchboardPort: option({
 		type: number,
 		long: "switchboard-port",
 		description: "port to use for the Vetra Switchboard",
-		defaultValue: () => {
-			return getConfig().reactor?.port ?? 4001;
-		}
+		defaultValue: resolveSwitchboardPortDefault
 	}),
 	connectPort: option({
 		type: number,
 		long: "connect-port",
 		description: "port to use for the Vetra Connect",
-		defaultValue: () => DEFAULT_VETRA_CONNECT_PORT,
-		defaultValueIsSerializable: true
+		defaultValue: resolveConnectPortDefault
 	}),
 	remoteDrive: option({
 		type: optional(string),
@@ -8342,11 +8396,14 @@ const sourceConfigSchema = {
 		vetra: {
 			type: "object",
 			additionalProperties: false,
-			required: ["driveId", "driveUrl"],
 			description: "Vetra integration coordinates.",
 			properties: {
 				driveId: { type: "string" },
-				driveUrl: { type: "string" }
+				driveUrl: { type: "string" },
+				connectPort: {
+					type: "integer",
+					description: "Port `ph vetra`'s Connect dev server listens on. Assigned per project by `ph init`. Overridden by PH_VETRA_CONNECT_PORT or --connect-port."
+				}
 			}
 		},
 		packageRegistryUrl: {
@@ -8391,6 +8448,6 @@ function assertNodeVersion(nodeVersion = process.versions.node) {
 	if ((0, import_lt.default)(nodeVersion, "24.0.0")) throw new NodeVersionError(nodeVersion, MINIMUM_NODE_VERSION);
 }
 //#endregion
-export { AGENTS, ANALYTICS_ENGINE_CORE_PACKAGE, BOILERPLATE_ALLOWED_BUILDS, BOILERPLATE_PNPM_OVERRIDES, 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, FEATURE_DEPENDENCIES, GRAPHQL_PACKAGE, GRAPHQL_TAG_PACKAGE, HOME_DIR, LEGACY_LINT_FORMAT_DEPENDENCIES, LEGACY_LINT_FORMAT_FILES, LOG_LEVELS, MINIMUM_NODE_VERSION, NodeVersionError, PEER_EXTERNAL_DEPENDENCIES, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, REACTOR_API_PACKAGE, SECONDS_IN_DAY, SERVICE_ACTIONS, SOURCE_CONFIG_SCHEMA_ID, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, VERSIONED_PEER_DEPENDENCIES, accessTokenArgs, assertNodeVersion, buildArgs, commonArgs, commonServerArgs, connectArgs, connectBasePath, connectBuildArgs, connectConfigArgs, connectPreviewArgs, connectStudioArgs, debugArgs, defaultDrivesUrl, defaultManifest, directoryExists, directoryExistsSync, disableLocalPackages, drivesPreserveStrategy, externalDependencies, externalDevDependencies, 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, injectPnpmAllowBuilds, inspectArgs, installArgs, isDirectory, isFile, isPowerhouseProject, listArgs, localPackage, logLevel, logVersionUpdate, loginArgs, makeDependenciesWithVersions, makeVersionedDependencies, makeVersionedDependenciesMap, migrateArgs, packageJsonExports, packageManagerArgs, packageScripts, packages, parsePackageManager, parsePackageVersion, parseTag, phCliCommandNames, phCliHelpCommands, publishArgs, registryLoginArgs, renownNamespace, renownSwitchboardUrl, resolveTelemetryConsent, runCmd, runUseLocal, serviceArgs, setTelemetryConsent, sourceConfigSchema, spawnAsync, switchboardArgs, uninstallArgs, unpublishArgs, vetraArgs, vetraSwitchboardArgs, writeFileEnsuringDir };
+export { AGENTS, ANALYTICS_ENGINE_CORE_PACKAGE, BOILERPLATE_ALLOWED_BUILDS, BOILERPLATE_PNPM_OVERRIDES, 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, FEATURE_DEPENDENCIES, GRAPHQL_PACKAGE, GRAPHQL_TAG_PACKAGE, HOME_DIR, LEGACY_LINT_FORMAT_DEPENDENCIES, LEGACY_LINT_FORMAT_FILES, LOG_LEVELS, MINIMUM_NODE_VERSION, NodeVersionError, PEER_EXTERNAL_DEPENDENCIES, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, PROJECT_PORT_BAND_SIZE, PROJECT_PORT_BAND_STUDIO, PROJECT_PORT_BAND_SWITCHBOARD, PROJECT_PORT_BAND_VETRA_CONNECT, REACTOR_API_PACKAGE, SECONDS_IN_DAY, SERVICE_ACTIONS, SOURCE_CONFIG_SCHEMA_ID, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, VERSIONED_PEER_DEPENDENCIES, accessTokenArgs, assertNodeVersion, buildArgs, commonArgs, commonServerArgs, connectArgs, connectBasePath, connectBuildArgs, connectConfigArgs, connectPreviewArgs, connectStudioArgs, debugArgs, defaultDrivesUrl, defaultManifest, directoryExists, directoryExistsSync, disableLocalPackages, drivesPreserveStrategy, externalDependencies, externalDevDependencies, 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, injectPnpmAllowBuilds, inspectArgs, installArgs, isDirectory, isFile, isPowerhouseProject, listArgs, localPackage, logLevel, logVersionUpdate, loginArgs, makeDependenciesWithVersions, makeVersionedDependencies, makeVersionedDependenciesMap, migrateArgs, packageJsonExports, packageManagerArgs, packageScripts, packages, parsePackageManager, parsePackageVersion, parseTag, phCliCommandNames, phCliHelpCommands, publishArgs, registryLoginArgs, renownNamespace, renownSwitchboardUrl, resolveConnectPortDefault, resolveSwitchboardPortDefault, resolveTelemetryConsent, runCmd, runUseLocal, serviceArgs, setTelemetryConsent, sourceConfigSchema, spawnAsync, switchboardArgs, uninstallArgs, unpublishArgs, vetraArgs, vetraSwitchboardArgs, writeFileEnsuringDir };
 
 //# sourceMappingURL=index.mjs.map