@powerhousedao/shared 6.2.2-dev.7 → 6.2.2-dev.71

package/dist/clis/project-env.d.mts

@@ -0,0 +1,27 @@
+//#region clis/project-env.d.ts
+/**
+ * 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.
+ */
+declare function loadProjectEnv(cwd?: string): void;
+/** Test seam: forget which directory has already been loaded. */
+declare function resetProjectEnvForTests(): void;
+/**
+ * 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.
+ */
+declare function readPortEnv(name: string): number | undefined;
+//#endregion
+export { loadProjectEnv, readPortEnv, resetProjectEnvForTests };
+//# sourceMappingURL=project-env.d.mts.map

package/dist/clis/project-env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-env.d.mts","names":[],"sources":["../../clis/project-env.ts"],"mappings":";;AAiBA;;;;;AAUA;;;;;AAWA;iBArBgB,cAAA,CAAe,GAAA;;iBAUf,uBAAA,CAAA;;;;;;;;iBAWA,WAAA,CAAY,IAAA"}

package/dist/clis/project-env.mjs

@@ -0,0 +1,44 @@
+import { join } from "node:path";
+import dotenv from "dotenv";
+//#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") });
+}
+/** Test seam: forget which directory has already been loaded. */
+function resetProjectEnvForTests() {
+	loadedFor = void 0;
+}
+/**
+* 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
+export { loadProjectEnv, readPortEnv, resetProjectEnvForTests };
+
+//# sourceMappingURL=project-env.mjs.map

package/dist/clis/project-env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-env.mjs","names":[],"sources":["../../clis/project-env.ts"],"sourcesContent":["import dotenv from \"dotenv\";\nimport { join } from \"node:path\";\n\nlet loadedFor: string | undefined;\n\n/**\n * Load the project's `.env.local` and `.env` into `process.env`.\n *\n * `dotenv` never overwrites a variable that is already set, so loading\n * `.env.local` first and `.env` second produces the precedence the CLI\n * documents: a real `process.env` value beats `.env.local`, which beats\n * `.env`. One `process.env` lookup afterwards therefore covers all three\n * sources.\n *\n * Idempotent per directory — CLI argument defaults call it lazily and may\n * call it more than once per process.\n */\nexport function loadProjectEnv(cwd: string = process.cwd()): void {\n  if (loadedFor === cwd) return;\n  loadedFor = cwd;\n  // dotenv 16 logs nothing for a missing file, so no suppression option is\n  // needed here (and none exists before dotenv 17).\n  dotenv.config({ path: join(cwd, \".env.local\") });\n  dotenv.config({ path: join(cwd, \".env\") });\n}\n\n/** Test seam: forget which directory has already been loaded. */\nexport function resetProjectEnvForTests(): void {\n  loadedFor = undefined;\n}\n\n/**\n * Read an environment variable as a TCP port.\n *\n * Anything that is not a plain integer in 1-65535 is ignored rather than\n * throwing: a typo in `.env` should fall through to the next source in the\n * precedence chain, not break the CLI.\n */\nexport function readPortEnv(name: string): number | undefined {\n  const raw = process.env[name]?.trim();\n  if (!raw || !/^\\d+$/.test(raw)) return undefined;\n  const port = Number(raw);\n  if (port < 1 || port > 65535) return undefined;\n  return port;\n}\n"],"mappings":";;;AAGA,IAAI;;;;;;;;;;;;;AAcJ,SAAgB,eAAe,MAAc,QAAQ,KAAK,EAAQ;AAChE,KAAI,cAAc,IAAK;AACvB,aAAY;AAGZ,QAAO,OAAO,EAAE,MAAM,KAAK,KAAK,aAAa,EAAE,CAAC;AAChD,QAAO,OAAO,EAAE,MAAM,KAAK,KAAK,OAAO,EAAE,CAAC;;;AAI5C,SAAgB,0BAAgC;AAC9C,aAAY,KAAA;;;;;;;;;AAUd,SAAgB,YAAY,MAAkC;CAC5D,MAAM,MAAM,QAAQ,IAAI,OAAO,MAAM;AACrC,KAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAE,QAAO,KAAA;CACvC,MAAM,OAAO,OAAO,IAAI;AACxB,KAAI,OAAO,KAAK,OAAO,MAAO,QAAO,KAAA;AACrC,QAAO"}

package/dist/clis/project-ports.d.mts

@@ -0,0 +1,40 @@
+//#region clis/project-ports.d.ts
+type ProjectPorts = {
+  switchboardPort: number;
+  studioPort: number;
+  vetraConnectPort: number;
+};
+/**
+ * Offsets whose derived port would land on something a developer machine
+ * plausibly already holds. Skipped rather than assigned, so a project never
+ * starts life needing a port override.
+ *
+ * Two sources: ports the Powerhouse repos themselves reference inside these
+ * bands, and well-known services. Being generous here is nearly free — the
+ * whole list costs 83 of 1000 offsets.
+ */
+declare const PROJECT_PORT_DENYLIST: ReadonlySet<number>;
+/**
+ * Derive a project's dev-server port triple from its package name.
+ *
+ * Name-derived rather than path-derived on purpose: the switchboard port is
+ * written literally into the project's committed `.mcp.json`, because an MCP
+ * client resolves that file at session start and cannot read the project
+ * config or `.env`. A path-derived value would differ on every machine that
+ * clones the repo.
+ *
+ * The three ports share one offset, so a project's numbers end in the same
+ * three digits (`my-package` gets 7834 / 6834 / 2834). When any of the three
+ * would hit {@link PROJECT_PORT_DENYLIST}, the offset advances deterministically
+ * until all three are clear — so the result stays reproducible from the name
+ * alone.
+ */
+declare function deriveProjectPorts(projectName: string): ProjectPorts;
+/** Every port this scheme can hand out, for cross-checking against other tools. */
+declare function projectPortBands(): {
+  from: number;
+  to: number;
+}[];
+//#endregion
+export { PROJECT_PORT_DENYLIST, ProjectPorts, deriveProjectPorts, projectPortBands };
+//# sourceMappingURL=project-ports.d.mts.map

package/dist/clis/project-ports.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-ports.d.mts","names":[],"sources":["../../clis/project-ports.ts"],"mappings":";KAQY,YAAA;EACV,eAAA;EACA,UAAA;EACA,gBAAA;AAAA;;;;;;AAsBF;;;;cAAa,qBAAA,EAAuB,WAAA;AAuDpC;;;;;AAsBA;;;;;;;;;;AAtBA,iBAAgB,kBAAA,CAAmB,WAAA,WAAsB,YAAA;;iBAsBzC,gBAAA,CAAA;EAAsB,IAAA;EAAc,EAAA;AAAA"}

package/dist/clis/project-ports.mjs

@@ -0,0 +1,90 @@
+import { PROJECT_PORT_BAND_SIZE, PROJECT_PORT_BAND_STUDIO, PROJECT_PORT_BAND_SWITCHBOARD, PROJECT_PORT_BAND_VETRA_CONNECT } from "./constants.mjs";
+import fnv1a from "@sindresorhus/fnv1a";
+//#region clis/project-ports.ts
+const BANDS = [
+	PROJECT_PORT_BAND_SWITCHBOARD,
+	PROJECT_PORT_BAND_STUDIO,
+	PROJECT_PORT_BAND_VETRA_CONNECT
+];
+function inclusive(from, to) {
+	return Array.from({ length: to - from + 1 }, (_, i) => from + i);
+}
+/**
+* Offsets whose derived port would land on something a developer machine
+* plausibly already holds. Skipped rather than assigned, so a project never
+* starts life needing a port override.
+*
+* Two sources: ports the Powerhouse repos themselves reference inside these
+* bands, and well-known services. Being generous here is nearly free — the
+* whole list costs 83 of 1000 offsets.
+*/
+const PROJECT_PORT_DENYLIST = new Set([
+	2e3,
+	2049,
+	2181,
+	2222,
+	2375,
+	2376,
+	2377,
+	2483,
+	2484,
+	...inclusive(6e3, 6063),
+	6006,
+	6060,
+	6100,
+	6200,
+	6300,
+	6500,
+	6379,
+	6443,
+	6666,
+	6667,
+	7e3,
+	7001,
+	7077,
+	7474,
+	7687,
+	7777
+]);
+function portsForOffset(offset) {
+	return {
+		switchboardPort: PROJECT_PORT_BAND_SWITCHBOARD + offset,
+		studioPort: PROJECT_PORT_BAND_STUDIO + offset,
+		vetraConnectPort: PROJECT_PORT_BAND_VETRA_CONNECT + offset
+	};
+}
+/**
+* Derive a project's dev-server port triple from its package name.
+*
+* Name-derived rather than path-derived on purpose: the switchboard port is
+* written literally into the project's committed `.mcp.json`, because an MCP
+* client resolves that file at session start and cannot read the project
+* config or `.env`. A path-derived value would differ on every machine that
+* clones the repo.
+*
+* The three ports share one offset, so a project's numbers end in the same
+* three digits (`my-package` gets 7834 / 6834 / 2834). When any of the three
+* would hit {@link PROJECT_PORT_DENYLIST}, the offset advances deterministically
+* until all three are clear — so the result stays reproducible from the name
+* alone.
+*/
+function deriveProjectPorts(projectName) {
+	if (!projectName.trim()) throw new Error("A project name is required to derive project ports.");
+	const start = Number(fnv1a(projectName, { size: 32 }) % BigInt(PROJECT_PORT_BAND_SIZE));
+	for (let step = 0; step < PROJECT_PORT_BAND_SIZE; step++) {
+		const ports = portsForOffset((start + step) % PROJECT_PORT_BAND_SIZE);
+		if (!Object.values(ports).some((port) => PROJECT_PORT_DENYLIST.has(port))) return ports;
+	}
+	throw new Error(`No free port offset for project "${projectName}" — every offset in the ${PROJECT_PORT_BAND_SIZE}-wide band is denied.`);
+}
+/** Every port this scheme can hand out, for cross-checking against other tools. */
+function projectPortBands() {
+	return BANDS.map((base) => ({
+		from: base,
+		to: base + PROJECT_PORT_BAND_SIZE - 1
+	}));
+}
+//#endregion
+export { PROJECT_PORT_DENYLIST, deriveProjectPorts, projectPortBands };
+
+//# sourceMappingURL=project-ports.mjs.map

package/dist/clis/project-ports.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-ports.mjs","names":[],"sources":["../../clis/project-ports.ts"],"sourcesContent":["import fnv1a from \"@sindresorhus/fnv1a\";\nimport {\n  PROJECT_PORT_BAND_SIZE,\n  PROJECT_PORT_BAND_STUDIO,\n  PROJECT_PORT_BAND_SWITCHBOARD,\n  PROJECT_PORT_BAND_VETRA_CONNECT,\n} from \"./constants.js\";\n\nexport type ProjectPorts = {\n  switchboardPort: number;\n  studioPort: number;\n  vetraConnectPort: number;\n};\n\nconst BANDS = [\n  PROJECT_PORT_BAND_SWITCHBOARD,\n  PROJECT_PORT_BAND_STUDIO,\n  PROJECT_PORT_BAND_VETRA_CONNECT,\n] as const;\n\nfunction inclusive(from: number, to: number): number[] {\n  return Array.from({ length: to - from + 1 }, (_, i) => from + i);\n}\n\n/**\n * Offsets whose derived port would land on something a developer machine\n * plausibly already holds. Skipped rather than assigned, so a project never\n * starts life needing a port override.\n *\n * Two sources: ports the Powerhouse repos themselves reference inside these\n * bands, and well-known services. Being generous here is nearly free — the\n * whole list costs 83 of 1000 offsets.\n */\nexport const PROJECT_PORT_DENYLIST: ReadonlySet<number> = new Set<number>([\n  // 2000 band\n  2000, // Cisco SCCP\n  2049, // NFS\n  2181, // ZooKeeper\n  2222, // alternate SSH\n  2375,\n  2376,\n  2377, // Docker daemon and Swarm\n  2483,\n  2484, // Oracle DB\n  // 6000 band\n  ...inclusive(6000, 6063), // X11 TCP listeners\n  6006, // Storybook / TensorBoard\n  6060, // Go pprof\n  6100,\n  6200,\n  6300,\n  6500, // referenced elsewhere in the Powerhouse repos\n  6379, // Redis\n  6443, // Kubernetes API server\n  6666,\n  6667, // IRC\n  // 7000 band\n  7000,\n  7001, // macOS AirPlay receiver / Cassandra\n  7077, // Spark\n  7474,\n  7687, // Neo4j HTTP and Bolt\n  7777, // referenced elsewhere in the Powerhouse repos\n]);\n\nfunction portsForOffset(offset: number): ProjectPorts {\n  return {\n    switchboardPort: PROJECT_PORT_BAND_SWITCHBOARD + offset,\n    studioPort: PROJECT_PORT_BAND_STUDIO + offset,\n    vetraConnectPort: PROJECT_PORT_BAND_VETRA_CONNECT + offset,\n  };\n}\n\n/**\n * Derive a project's dev-server port triple from its package name.\n *\n * Name-derived rather than path-derived on purpose: the switchboard port is\n * written literally into the project's committed `.mcp.json`, because an MCP\n * client resolves that file at session start and cannot read the project\n * config or `.env`. A path-derived value would differ on every machine that\n * clones the repo.\n *\n * The three ports share one offset, so a project's numbers end in the same\n * three digits (`my-package` gets 7834 / 6834 / 2834). When any of the three\n * would hit {@link PROJECT_PORT_DENYLIST}, the offset advances deterministically\n * until all three are clear — so the result stays reproducible from the name\n * alone.\n */\nexport function deriveProjectPorts(projectName: string): ProjectPorts {\n  if (!projectName.trim()) {\n    throw new Error(\"A project name is required to derive project ports.\");\n  }\n  const start = Number(\n    fnv1a(projectName, { size: 32 }) % BigInt(PROJECT_PORT_BAND_SIZE),\n  );\n  for (let step = 0; step < PROJECT_PORT_BAND_SIZE; step++) {\n    const offset = (start + step) % PROJECT_PORT_BAND_SIZE;\n    const ports = portsForOffset(offset);\n    if (!Object.values(ports).some((port) => PROJECT_PORT_DENYLIST.has(port))) {\n      return ports;\n    }\n  }\n  // Unreachable: the denylist covers far fewer offsets than the band holds.\n  throw new Error(\n    `No free port offset for project \"${projectName}\" — every offset in the ` +\n      `${PROJECT_PORT_BAND_SIZE}-wide band is denied.`,\n  );\n}\n\n/** Every port this scheme can hand out, for cross-checking against other tools. */\nexport function projectPortBands(): { from: number; to: number }[] {\n  return BANDS.map((base) => ({\n    from: base,\n    to: base + PROJECT_PORT_BAND_SIZE - 1,\n  }));\n}\n"],"mappings":";;;AAcA,MAAM,QAAQ;CACZ;CACA;CACA;CACD;AAED,SAAS,UAAU,MAAc,IAAsB;AACrD,QAAO,MAAM,KAAK,EAAE,QAAQ,KAAK,OAAO,GAAG,GAAG,GAAG,MAAM,OAAO,EAAE;;;;;;;;;;;AAYlE,MAAa,wBAA6C,IAAI,IAAY;CAExE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,GAAG,UAAU,KAAM,KAAK;CACxB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAS,eAAe,QAA8B;AACpD,QAAO;EACL,iBAAiB,gCAAgC;EACjD,YAAY,2BAA2B;EACvC,kBAAkB,kCAAkC;EACrD;;;;;;;;;;;;;;;;;AAkBH,SAAgB,mBAAmB,aAAmC;AACpE,KAAI,CAAC,YAAY,MAAM,CACrB,OAAM,IAAI,MAAM,sDAAsD;CAExE,MAAM,QAAQ,OACZ,MAAM,aAAa,EAAE,MAAM,IAAI,CAAC,GAAG,OAAO,uBAAuB,CAClE;AACD,MAAK,IAAI,OAAO,GAAG,OAAO,wBAAwB,QAAQ;EAExD,MAAM,QAAQ,gBADE,QAAQ,QAAQ,uBACI;AACpC,MAAI,CAAC,OAAO,OAAO,MAAM,CAAC,MAAM,SAAS,sBAAsB,IAAI,KAAK,CAAC,CACvE,QAAO;;AAIX,OAAM,IAAI,MACR,oCAAoC,YAAY,0BAC3C,uBAAuB,uBAC7B;;;AAIH,SAAgB,mBAAmD;AACjE,QAAO,MAAM,KAAK,UAAU;EAC1B,MAAM;EACN,IAAI,OAAO,yBAAyB;EACrC,EAAE"}

package/dist/{config-loader-19K8n4DO.js → config-loader-Dw3syw7r.js}

@@ -1,17 +1,7 @@
 import { isPlainObject } from "remeda";
 //#region connect/runtime-config.ts
-/**
-* Default values for every Connect-relevant field. Merged with the
-* `connect.*` block of whatever `powerhouse.config.json` Connect is pointed
-* at, so the SPA never has to guard against undefined fields.
-*
-* Scoped to fields Connect actually reads at runtime — build-time concerns
-* (studio port, switchboard port, reactor.*, auth.*) live in the source
-* config but are not Connect's business and not represented here.
-*
-* Single source of truth for defaults across Connect's runtime read (via
-* ConfigLoader merge), the dist emitter, and the codegen scaffold template.
-*/
+/** Defaults for every field Connect reads at runtime, merged into the
+* `connect.*` block at boot; also the dist emitter's and the scaffold's base. */
 const DEFAULT_CONNECT_CONFIG = {
 	branding: {
 		appName: "Powerhouse Connect",
@@ -56,7 +46,13 @@ const DEFAULT_CONNECT_CONFIG = {
 	instance: {
 		namespace: null,
 		reactorWorker: false
-	}
+	},
+	reactor: { featureFlags: {
+		documentDecisions: false,
+		authEnforcement: false,
+		authGroups: false,
+		authConditions: false
+	} }
 };
 function buildRuntimeConfig(source, projectInfo) {
 	const result = {
@@ -147,4 +143,4 @@ var ConfigLoader = class {
 //#endregion
 export { buildRuntimeConfig as i, deepMerge as n, DEFAULT_CONNECT_CONFIG as r, ConfigLoader as t };
 
-//# sourceMappingURL=config-loader-19K8n4DO.js.map
+//# sourceMappingURL=config-loader-Dw3syw7r.js.map

package/dist/config-loader-Dw3syw7r.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader-Dw3syw7r.js","names":[],"sources":["../connect/runtime-config.ts","../connect/config-loader.ts"],"sourcesContent":["import type {\n  PHConnectRuntimeConfig,\n  PowerhouseConfig,\n  PowerhousePackage,\n} from \"../clis/types.js\";\n\nexport type RuntimePowerhouseConfig = {\n  schemaVersion: 2;\n  packages: PowerhousePackage[];\n  packageRegistryUrl?: string;\n  localPackage: { name: string; version: string } | null;\n  connect: PHConnectRuntimeConfig;\n};\n\n/** Defaults for every field Connect reads at runtime, merged into the\n * `connect.*` block at boot; also the dist emitter's and the scaffold's base. */\nexport const DEFAULT_CONNECT_CONFIG: PHConnectRuntimeConfig = {\n  branding: {\n    appName: \"Powerhouse Connect\",\n    homeBackground: null,\n  },\n  app: {\n    logLevel: \"info\",\n    basePath: \"/\",\n    offline: true,\n    studioMode: false,\n  },\n  packages: {\n    externalEnabled: true,\n    liveReload: false,\n  },\n  drives: {\n    allowAddDrive: true,\n    defaultDrives: [],\n    sections: {\n      remote: { enabled: true, allowAdd: true, allowDelete: true },\n      local: { enabled: true, allowAdd: true, allowDelete: true },\n    },\n  },\n  renown: {\n    url: \"https://www.renown.id\",\n    networkId: \"eip155\",\n    chainId: 1,\n  },\n  sentry: {\n    // `dsn: null` is the disabled-Sentry state — the SPA never loads the\n    // Sentry SDK chunk. Override via `ph connect config --sentry-dsn ...`\n    // or by including `connect.sentry.dsn` in PH_CONNECT_CONFIG_JSON.\n    dsn: null,\n    env: \"dev\",\n    tracing: false,\n  },\n  instance: {\n    namespace: null,\n    reactorWorker: false,\n  },\n  reactor: {\n    featureFlags: {\n      documentDecisions: false,\n      authEnforcement: false,\n      authGroups: false,\n      authConditions: false,\n    },\n  },\n};\n\nexport function buildRuntimeConfig(\n  source: Pick<PowerhouseConfig, \"packages\" | \"connect\" | \"packageRegistryUrl\">,\n  projectInfo: { name: string; version: string } | null,\n): RuntimePowerhouseConfig {\n  const result: RuntimePowerhouseConfig = {\n    schemaVersion: 2,\n    packages: source.packages ?? [],\n    localPackage: projectInfo,\n    connect: source.connect ?? {},\n  };\n  if (\n    typeof source.packageRegistryUrl === \"string\" &&\n    source.packageRegistryUrl !== \"\"\n  ) {\n    result.packageRegistryUrl = source.packageRegistryUrl;\n  }\n  return result;\n}\n","// Environment-neutral config loader. Wraps a `ConfigAdapter` (the IO layer)\n// with in-process caching and deep-merge-with-defaults reads.\n//\n// No validation. The loader trusts that whatever bytes the adapter returns\n// can be merged into the default Connect config; missing or partial fields\n// fall back to DEFAULT_CONNECT_CONFIG, so the SPA always sees a complete\n// `connect.*` block.\n//\n// Top-level fields outside `connect.*` (e.g. `studio.port` in the source\n// powerhouse.config.json) pass through untouched on both read and write.\n// They're not Connect's concern, but a write-back round-trip preserves\n// them so editing tools don't accidentally drop them.\n\nimport { isPlainObject } from \"remeda\";\nimport type { PHConnectRuntimeConfig } from \"../clis/types.js\";\nimport { DEFAULT_CONNECT_CONFIG } from \"./runtime-config.js\";\n\n/** Recursive Partial. Arrays are leaves — `write({ packages: [...] })`\n * replaces the array, it doesn't merge. */\nexport type DeepPartial<T> =\n  T extends Array<infer U>\n    ? Array<U>\n    : T extends object\n      ? { [K in keyof T]?: DeepPartial<T[K]> }\n      : T;\n\n/**\n * Shape returned by `ConfigLoader.read()`. The loader is Connect-scoped:\n * it guarantees `connect` is present and fully populated from\n * DEFAULT_CONNECT_CONFIG, but lets any other top-level fields pass\n * through unchanged so source-config-only fields (studio, reactor, auth,\n * documentModelsDir, etc.) survive a read+write round-trip.\n */\nexport type ConfigShape = Record<string, unknown> & {\n  connect: PHConnectRuntimeConfig;\n};\n\n/**\n * Abstract IO layer for `powerhouse.config.json`.\n *\n * Implementations decide where bytes come from and go to. The shipped\n * adapter is `JsonConfigAdapter` (reads via fetch in the browser, fs in\n * Node; writes via fs in Node, throws in the browser). Future adapters\n * (remote-JSON, GraphQL) plug in without changing the loader or any\n * consumer.\n */\nexport interface ConfigAdapter {\n  /** Read raw JSON-parsed payload from the backing store. */\n  read(): Promise<unknown>;\n  /** Persist a fully-formed config. */\n  write(next: ConfigShape): Promise<void>;\n  /** Human-readable description used in errors and logs. */\n  readonly source: string;\n}\n\n/**\n * Deep-merge `patch` into `base`. Object fields recurse; arrays and\n * primitives replace. `undefined` in patch leaves the base value\n * untouched (no unset). `null` in patch overwrites with null.\n *\n * Exported for unit tests; consumers use ConfigLoader.write() which\n * applies this internally.\n */\nexport function deepMerge<T>(base: T, patch: DeepPartial<T>): T {\n  if (!isPlainObject(base) || !isPlainObject(patch)) {\n    return patch as T;\n  }\n  const result: Record<string, unknown> = { ...base };\n  for (const [key, patchValue] of Object.entries(patch)) {\n    if (patchValue === undefined) continue;\n    const baseValue = result[key];\n    if (isPlainObject(baseValue) && isPlainObject(patchValue)) {\n      result[key] = deepMerge(\n        baseValue,\n        patchValue as DeepPartial<typeof baseValue>,\n      );\n    } else {\n      result[key] = patchValue;\n    }\n  }\n  return result as T;\n}\n\n/**\n * Pluggable loader on top of a `ConfigAdapter`.\n *\n * Responsibilities:\n *  - merge-with-defaults on read (so consumers never see a partial connect block)\n *  - in-process caching (call `invalidate()` to force re-read)\n *  - deep-merge for partial writes; writes the merged whole back through the adapter\n *\n * The cache is module-instance scoped — every `new ConfigLoader(...)` has\n * its own cache. The browser SPA constructs the loader once at boot; the\n * CLI typically constructs a fresh loader per command.\n */\nexport class ConfigLoader {\n  private cache: ConfigShape | undefined;\n\n  constructor(\n    private readonly adapter: ConfigAdapter,\n    private readonly defaults: PHConnectRuntimeConfig = DEFAULT_CONNECT_CONFIG,\n  ) {}\n\n  /** Returns the config with the default connect block merged in.\n   * Cached after the first successful call. */\n  async read(): Promise<ConfigShape> {\n    if (this.cache) return this.cache;\n    const raw = await this.adapter.read();\n    const obj = isPlainObject(raw) ? raw : {};\n    const connectRaw = isPlainObject(obj.connect) ? obj.connect : {};\n    this.cache = {\n      ...obj,\n      connect: deepMerge(\n        this.defaults,\n        connectRaw as DeepPartial<PHConnectRuntimeConfig>,\n      ),\n    };\n    return this.cache;\n  }\n\n  /**\n   * Returns the cached config synchronously. Throws if `read()` has not\n   * resolved yet — matches Connect's `getRuntimeConfig()` shape.\n   */\n  getCached(): ConfigShape {\n    if (!this.cache) {\n      throw new Error(\n        `ConfigLoader (${this.adapter.source}): cache empty; call read() first.`,\n      );\n    }\n    return this.cache;\n  }\n\n  /** Drop the in-memory cache. Next `read()` re-fetches from the adapter. */\n  invalidate(): void {\n    this.cache = undefined;\n  }\n\n  /**\n   * Deep-merge `patch` into the current config and persist via the adapter.\n   * Returns the new full config (also updates the cache). Arrays in `patch`\n   * replace — they do NOT append.\n   */\n  async write(patch: DeepPartial<ConfigShape>): Promise<ConfigShape> {\n    const current = await this.read();\n    const next = deepMerge(current, patch);\n    await this.adapter.write(next);\n    this.cache = next;\n    return next;\n  }\n}\n"],"mappings":";;;;AAgBA,MAAa,yBAAiD;CAC5D,UAAU;EACR,SAAS;EACT,gBAAgB;EACjB;CACD,KAAK;EACH,UAAU;EACV,UAAU;EACV,SAAS;EACT,YAAY;EACb;CACD,UAAU;EACR,iBAAiB;EACjB,YAAY;EACb;CACD,QAAQ;EACN,eAAe;EACf,eAAe,EAAE;EACjB,UAAU;GACR,QAAQ;IAAE,SAAS;IAAM,UAAU;IAAM,aAAa;IAAM;GAC5D,OAAO;IAAE,SAAS;IAAM,UAAU;IAAM,aAAa;IAAM;GAC5D;EACF;CACD,QAAQ;EACN,KAAK;EACL,WAAW;EACX,SAAS;EACV;CACD,QAAQ;EAIN,KAAK;EACL,KAAK;EACL,SAAS;EACV;CACD,UAAU;EACR,WAAW;EACX,eAAe;EAChB;CACD,SAAS,EACP,cAAc;EACZ,mBAAmB;EACnB,iBAAiB;EACjB,YAAY;EACZ,gBAAgB;EACjB,EACF;CACF;AAED,SAAgB,mBACd,QACA,aACyB;CACzB,MAAM,SAAkC;EACtC,eAAe;EACf,UAAU,OAAO,YAAY,EAAE;EAC/B,cAAc;EACd,SAAS,OAAO,WAAW,EAAE;EAC9B;AACD,KACE,OAAO,OAAO,uBAAuB,YACrC,OAAO,uBAAuB,GAE9B,QAAO,qBAAqB,OAAO;AAErC,QAAO;;;;;;;;;;;;ACnBT,SAAgB,UAAa,MAAS,OAA0B;AAC9D,KAAI,CAAC,cAAc,KAAK,IAAI,CAAC,cAAc,MAAM,CAC/C,QAAO;CAET,MAAM,SAAkC,EAAE,GAAG,MAAM;AACnD,MAAK,MAAM,CAAC,KAAK,eAAe,OAAO,QAAQ,MAAM,EAAE;AACrD,MAAI,eAAe,KAAA,EAAW;EAC9B,MAAM,YAAY,OAAO;AACzB,MAAI,cAAc,UAAU,IAAI,cAAc,WAAW,CACvD,QAAO,OAAO,UACZ,WACA,WACD;MAED,QAAO,OAAO;;AAGlB,QAAO;;;;;;;;;;;;;;AAeT,IAAa,eAAb,MAA0B;CACxB;CAEA,YACE,SACA,WAAoD,wBACpD;AAFiB,OAAA,UAAA;AACA,OAAA,WAAA;;;;CAKnB,MAAM,OAA6B;AACjC,MAAI,KAAK,MAAO,QAAO,KAAK;EAC5B,MAAM,MAAM,MAAM,KAAK,QAAQ,MAAM;EACrC,MAAM,MAAM,cAAc,IAAI,GAAG,MAAM,EAAE;EACzC,MAAM,aAAa,cAAc,IAAI,QAAQ,GAAG,IAAI,UAAU,EAAE;AAChE,OAAK,QAAQ;GACX,GAAG;GACH,SAAS,UACP,KAAK,UACL,WACD;GACF;AACD,SAAO,KAAK;;;;;;CAOd,YAAyB;AACvB,MAAI,CAAC,KAAK,MACR,OAAM,IAAI,MACR,iBAAiB,KAAK,QAAQ,OAAO,oCACtC;AAEH,SAAO,KAAK;;;CAId,aAAmB;AACjB,OAAK,QAAQ,KAAA;;;;;;;CAQf,MAAM,MAAM,OAAuD;EAEjE,MAAM,OAAO,UADG,MAAM,KAAK,MAAM,EACD,MAAM;AACtC,QAAM,KAAK,QAAQ,MAAM,KAAK;AAC9B,OAAK,QAAQ;AACb,SAAO"}

package/dist/connect/config-loader.d.ts

@@ -1,4 +1,5 @@
-import { m as PHConnectRuntimeConfig } from "../types-D0NNBVGA.js";
+import { w as PHConnectRuntimeConfig } from "../types-BWwUHbmn.js";
+
 //#region connect/config-loader.d.ts
 /** Recursive Partial. Arrays are leaves — `write({ packages: [...] })`
  * replaces the array, it doesn't merge. */

package/dist/connect/config-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.ts","names":[],"sources":["../../connect/config-loader.ts"],"mappings":";;;;KAmBY,WAAA,MACV,CAAA,SAAU,KAAA,YACN,KAAA,CAAM,CAAA,IACN,CAAA,gCACgB,CAAA,IAAK,WAAA,CAAY,CAAA,CAAE,CAAA,OACjC,CAAA;;;;;;;;KASI,WAAA,GAAc,MAAA;EACxB,OAAA,EAAS,sBAAA;AAAA;;;;;;;;;;UAYM,aAAA;EAvBN;EAyBT,IAAA,IAAQ,OAAA;EAzBiB;EA2BzB,KAAA,CAAM,IAAA,EAAM,WAAA,GAAc,OAAA;EA3Ba;EAAA,SA6B9B,MAAA;AAAA;;AAnBX;;;;;;;iBA8BgB,SAAA,GAAA,CAAa,IAAA,EAAM,CAAA,EAAG,KAAA,EAAO,WAAA,CAAY,CAAA,IAAK,CAAA;;AAjB9D;;;;;;;;;;;cAiDa,YAAA;EAAA,iBAIQ,OAAA;EAAA,iBACA,QAAA;EAAA,QAJX,KAAA;cAGW,OAAA,EAAS,aAAA,EACT,QAAA,GAAU,sBAAA;EAhDd;AAWjB;EA0CQ,IAAA,CAAA,GAAQ,OAAA,CAAQ,WAAA;EA1CC;;;;EA6DvB,SAAA,CAAA,GAAa,WAAA;EA7DgD;EAuE7D,UAAA,CAAA;EAvEwB;;;;;EAgFlB,KAAA,CAAM,KAAA,EAAO,WAAA,CAAY,WAAA,IAAe,OAAA,CAAQ,WAAA;AAAA"}
+{"version":3,"file":"config-loader.d.ts","names":[],"sources":["../../connect/config-loader.ts"],"mappings":";;;;;KAmBY,WAAA,MACV,CAAA,SAAU,KAAA,YACN,KAAA,CAAM,CAAA,IACN,CAAA,gCACgB,CAAA,IAAK,WAAA,CAAY,CAAA,CAAE,CAAA,OACjC,CAAA;;;;;;;;KASI,WAAA,GAAc,MAAA;EACxB,OAAA,EAAS,sBAAA;AAAA;;;;;;;;;;UAYM,aAAA;EAvBK;EAyBpB,IAAA,IAAQ,OAAA;EAzB6B;EA2BrC,KAAA,CAAM,IAAA,EAAM,WAAA,GAAc,OAAA;EA1BpB;EAAA,SA4BG,MAAA;AAAA;AAnBX;;;;;;;;AAAA,iBA8BgB,SAAA,GAAA,CAAa,IAAA,EAAM,CAAA,EAAG,KAAA,EAAO,WAAA,CAAY,CAAA,IAAK,CAAA;AAjB9D;;;;;;;;;;;;AAAA,cAiDa,YAAA;EAAA,iBAIQ,OAAA;EAAA,iBACA,QAAA;EAAA,QAJX,KAAA;cAGW,OAAA,EAAS,aAAA,EACT,QAAA,GAAU,sBAAA;EArCf;;EA0CR,IAAA,CAAA,GAAQ,OAAA,CAAQ,WAAA;EA1CW;;;;EA6DjC,SAAA,CAAA,GAAa,WAAA;EA7DgD;EAuE7D,UAAA,CAAA;EAvEiC;;;;;EAgF3B,KAAA,CAAM,KAAA,EAAO,WAAA,CAAY,WAAA,IAAe,OAAA,CAAQ,WAAA;AAAA"}

package/dist/connect/config-loader.js

@@ -1,2 +1,2 @@
-import { n as deepMerge, t as ConfigLoader } from "../config-loader-19K8n4DO.js";
+import { n as deepMerge, t as ConfigLoader } from "../config-loader-Dw3syw7r.js";
 export { ConfigLoader, deepMerge };