@powerhousedao/shared 6.1.0-staging.0 → 6.2.0-dev.0

package/dist/config-loader-DORViRnN.js

@@ -0,0 +1,144 @@
+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.
+*/
+const DEFAULT_CONNECT_CONFIG = {
+	branding: {
+		appName: "Powerhouse Connect",
+		homeBackground: null
+	},
+	app: {
+		logLevel: "info",
+		basePath: "/"
+	},
+	packages: {
+		externalEnabled: true,
+		liveReload: false
+	},
+	drives: {
+		allowAddDrive: true,
+		defaultDrives: [],
+		sections: {
+			remote: {
+				enabled: true,
+				allowAdd: true,
+				allowDelete: true
+			},
+			local: {
+				enabled: true,
+				allowAdd: true,
+				allowDelete: true
+			}
+		}
+	},
+	renown: {
+		url: "https://www.renown.id",
+		networkId: "eip155",
+		chainId: 1
+	},
+	sentry: {
+		dsn: null,
+		env: "dev",
+		tracing: false
+	}
+};
+function buildRuntimeConfig(source, projectInfo) {
+	const result = {
+		schemaVersion: 2,
+		packages: source.packages ?? [],
+		localPackage: projectInfo,
+		connect: source.connect ?? {}
+	};
+	if (typeof source.packageRegistryUrl === "string" && source.packageRegistryUrl !== "") result.packageRegistryUrl = source.packageRegistryUrl;
+	return result;
+}
+//#endregion
+//#region connect/config-loader.ts
+/**
+* Deep-merge `patch` into `base`. Object fields recurse; arrays and
+* primitives replace. `undefined` in patch leaves the base value
+* untouched (no unset). `null` in patch overwrites with null.
+*
+* Exported for unit tests; consumers use ConfigLoader.write() which
+* applies this internally.
+*/
+function deepMerge(base, patch) {
+	if (!isPlainObject(base) || !isPlainObject(patch)) return patch;
+	const result = { ...base };
+	for (const [key, patchValue] of Object.entries(patch)) {
+		if (patchValue === void 0) continue;
+		const baseValue = result[key];
+		if (isPlainObject(baseValue) && isPlainObject(patchValue)) result[key] = deepMerge(baseValue, patchValue);
+		else result[key] = patchValue;
+	}
+	return result;
+}
+/**
+* Pluggable loader on top of a `ConfigAdapter`.
+*
+* Responsibilities:
+*  - merge-with-defaults on read (so consumers never see a partial connect block)
+*  - in-process caching (call `invalidate()` to force re-read)
+*  - deep-merge for partial writes; writes the merged whole back through the adapter
+*
+* The cache is module-instance scoped — every `new ConfigLoader(...)` has
+* its own cache. The browser SPA constructs the loader once at boot; the
+* CLI typically constructs a fresh loader per command.
+*/
+var ConfigLoader = class {
+	cache;
+	constructor(adapter, defaults = DEFAULT_CONNECT_CONFIG) {
+		this.adapter = adapter;
+		this.defaults = defaults;
+	}
+	/** Returns the config with the default connect block merged in.
+	* Cached after the first successful call. */
+	async read() {
+		if (this.cache) return this.cache;
+		const raw = await this.adapter.read();
+		const obj = isPlainObject(raw) ? raw : {};
+		const connectRaw = isPlainObject(obj.connect) ? obj.connect : {};
+		this.cache = {
+			...obj,
+			connect: deepMerge(this.defaults, connectRaw)
+		};
+		return this.cache;
+	}
+	/**
+	* Returns the cached config synchronously. Throws if `read()` has not
+	* resolved yet — matches Connect's `getRuntimeConfig()` shape.
+	*/
+	getCached() {
+		if (!this.cache) throw new Error(`ConfigLoader (${this.adapter.source}): cache empty; call read() first.`);
+		return this.cache;
+	}
+	/** Drop the in-memory cache. Next `read()` re-fetches from the adapter. */
+	invalidate() {
+		this.cache = void 0;
+	}
+	/**
+	* Deep-merge `patch` into the current config and persist via the adapter.
+	* Returns the new full config (also updates the cache). Arrays in `patch`
+	* replace — they do NOT append.
+	*/
+	async write(patch) {
+		const next = deepMerge(await this.read(), patch);
+		await this.adapter.write(next);
+		this.cache = next;
+		return next;
+	}
+};
+//#endregion
+export { buildRuntimeConfig as i, deepMerge as n, DEFAULT_CONNECT_CONFIG as r, ConfigLoader as t };
+
+//# sourceMappingURL=config-loader-DORViRnN.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader-DORViRnN.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/**\n * Default values for every Connect-relevant field. Merged with the\n * `connect.*` block of whatever `powerhouse.config.json` Connect is pointed\n * at, so the SPA never has to guard against undefined fields.\n *\n * Scoped to fields Connect actually reads at runtime — build-time concerns\n * (studio port, switchboard port, reactor.*, auth.*) live in the source\n * config but are not Connect's business and not represented here.\n *\n * Single source of truth for defaults across Connect's runtime read (via\n * ConfigLoader merge), the dist emitter, and the codegen scaffold template.\n */\nexport const DEFAULT_CONNECT_CONFIG: PHConnectRuntimeConfig = {\n  branding: {\n    appName: \"Powerhouse Connect\",\n    homeBackground: null,\n  },\n  app: {\n    logLevel: \"info\",\n    basePath: \"/\",\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};\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":";;;;;;;;;;;;;;AA0BA,MAAa,yBAAiD;CAC5D,UAAU;EACR,SAAS;EACT,gBAAgB;EACjB;CACD,KAAK;EACH,UAAU;EACV,UAAU;EACX;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;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;;;;;;;;;;;;ACfT,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

@@ -0,0 +1,78 @@
+import { p as PHConnectRuntimeConfig } from "../types-Daq_zHP_.js";
+//#region connect/config-loader.d.ts
+/** Recursive Partial. Arrays are leaves — `write({ packages: [...] })`
+ * replaces the array, it doesn't merge. */
+type DeepPartial<T> = T extends Array<infer U> ? Array<U> : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T;
+/**
+ * Shape returned by `ConfigLoader.read()`. The loader is Connect-scoped:
+ * it guarantees `connect` is present and fully populated from
+ * DEFAULT_CONNECT_CONFIG, but lets any other top-level fields pass
+ * through unchanged so source-config-only fields (studio, reactor, auth,
+ * documentModelsDir, etc.) survive a read+write round-trip.
+ */
+type ConfigShape = Record<string, unknown> & {
+  connect: PHConnectRuntimeConfig;
+};
+/**
+ * Abstract IO layer for `powerhouse.config.json`.
+ *
+ * Implementations decide where bytes come from and go to. The shipped
+ * adapter is `JsonConfigAdapter` (reads via fetch in the browser, fs in
+ * Node; writes via fs in Node, throws in the browser). Future adapters
+ * (remote-JSON, GraphQL) plug in without changing the loader or any
+ * consumer.
+ */
+interface ConfigAdapter {
+  /** Read raw JSON-parsed payload from the backing store. */
+  read(): Promise<unknown>;
+  /** Persist a fully-formed config. */
+  write(next: ConfigShape): Promise<void>;
+  /** Human-readable description used in errors and logs. */
+  readonly source: string;
+}
+/**
+ * Deep-merge `patch` into `base`. Object fields recurse; arrays and
+ * primitives replace. `undefined` in patch leaves the base value
+ * untouched (no unset). `null` in patch overwrites with null.
+ *
+ * Exported for unit tests; consumers use ConfigLoader.write() which
+ * applies this internally.
+ */
+declare function deepMerge<T>(base: T, patch: DeepPartial<T>): T;
+/**
+ * Pluggable loader on top of a `ConfigAdapter`.
+ *
+ * Responsibilities:
+ *  - merge-with-defaults on read (so consumers never see a partial connect block)
+ *  - in-process caching (call `invalidate()` to force re-read)
+ *  - deep-merge for partial writes; writes the merged whole back through the adapter
+ *
+ * The cache is module-instance scoped — every `new ConfigLoader(...)` has
+ * its own cache. The browser SPA constructs the loader once at boot; the
+ * CLI typically constructs a fresh loader per command.
+ */
+declare class ConfigLoader {
+  private readonly adapter;
+  private readonly defaults;
+  private cache;
+  constructor(adapter: ConfigAdapter, defaults?: PHConnectRuntimeConfig);
+  /** Returns the config with the default connect block merged in.
+   * Cached after the first successful call. */
+  read(): Promise<ConfigShape>;
+  /**
+   * Returns the cached config synchronously. Throws if `read()` has not
+   * resolved yet — matches Connect's `getRuntimeConfig()` shape.
+   */
+  getCached(): ConfigShape;
+  /** Drop the in-memory cache. Next `read()` re-fetches from the adapter. */
+  invalidate(): void;
+  /**
+   * Deep-merge `patch` into the current config and persist via the adapter.
+   * Returns the new full config (also updates the cache). Arrays in `patch`
+   * replace — they do NOT append.
+   */
+  write(patch: DeepPartial<ConfigShape>): Promise<ConfigShape>;
+}
+//#endregion
+export { ConfigAdapter, ConfigLoader, ConfigShape, DeepPartial, deepMerge };
+//# sourceMappingURL=config-loader.d.ts.map

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

@@ -0,0 +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"}

package/dist/connect/config-loader.js

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