@powerhousedao/shared 6.2.3-dev.3 → 6.2.3-dev.31

package/dist/clis/types-CMFHKrgv.d.mts

@@ -0,0 +1,528 @@
+import "mutative";
+import "luxon";
+import { z } from "zod";
+import "cmd-ts/dist/cjs/argparser.js";
+import "package-manager-detector";
+import "kysely";
+//#region clis/constants.d.ts
+declare const SERVICE_ACTIONS: readonly ["start", "stop", "status", "setup", "restart"];
+declare const SECONDS_IN_DAY: number;
+declare const DEFAULT_EXPIRY_DAYS = 7;
+declare const DEFAULT_EXPIRY_SECONDS: number;
+declare const DRIVES_PRESERVE_STRATEGIES: readonly ["preserve-all", "preserve-by-url-and-detach"];
+declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error", "verbose"];
+declare const DEFAULT_TIMEOUT: 300;
+declare const DEFAULT_CONNECT_STUDIO_PORT: 3000;
+declare const DEFAULT_VETRA_CONNECT_PORT: 3001;
+declare const DEFAULT_CONNECT_PREVIEW_PORT: 4173;
+declare const DEFAULT_CONNECT_OUTDIR: ".ph/connect-build/dist/";
+declare const DEFAULT_RENOWN_URL: "https://www.renown.id";
+declare const DEFAULT_REGISTRY_URL: "https://registry.vetra.io";
+declare const DEFAULT_SWITCHBOARD_PORT: 4001;
+declare const PROJECT_PORT_BAND_SIZE: 1000;
+declare const PROJECT_PORT_BAND_SWITCHBOARD: 7000;
+declare const PROJECT_PORT_BAND_STUDIO: 6000;
+declare const PROJECT_PORT_BAND_VETRA_CONNECT: 2000;
+declare const DEFAULT_VETRA_DRIVE_ID: "vetra";
+declare const MINIMUM_NODE_VERSION: "24.0.0";
+declare const PH_BIN: "ph-cli-legacy";
+declare const POWERHOUSE_CONFIG_FILE: "powerhouse.config.json";
+declare const PH_GLOBAL_DIR_NAME: ".ph";
+declare const PH_GLOBAL_PROJECT_NAME: ".ph";
+declare const HOME_DIR: string;
+declare const POWERHOUSE_GLOBAL_DIR: string;
+declare const VERSIONED_PEER_DEPENDENCIES: string[];
+declare const REACTOR_API_PACKAGE = "@powerhousedao/reactor-api";
+declare const ANALYTICS_ENGINE_CORE_PACKAGE = "@powerhousedao/analytics-engine-core";
+declare const GRAPHQL_PACKAGE = "graphql";
+declare const GRAPHQL_TAG_PACKAGE = "graphql-tag";
+declare const PIECES_FRAMEWORK_PACKAGE = "@powerhousedao/pieces-framework";
+declare const PEER_EXTERNAL_DEPENDENCIES: {
+  readonly graphql: {
+    readonly peer: "^16";
+    readonly dev: "16.12.0";
+  };
+  readonly "graphql-tag": {
+    readonly peer: "^2";
+    readonly dev: "2.12.6";
+  };
+  readonly react: {
+    readonly peer: "^19";
+    readonly dev: "19.2.6";
+  };
+  readonly "react-dom": {
+    readonly peer: "^19";
+    readonly dev: "19.2.6";
+  };
+  readonly zod: {
+    readonly peer: "^4";
+    readonly dev: "4.3.6";
+  };
+};
+declare const FEATURE_DEPENDENCIES: {
+  readonly analyticsProcessor: {
+    readonly peerVersioned: readonly ["@powerhousedao/analytics-engine-core"];
+    readonly peerExternal: {};
+    readonly devVersioned: readonly [];
+  };
+  readonly piece: {
+    readonly peerVersioned: readonly [];
+    readonly peerExternal: {};
+    readonly devVersioned: readonly ["@powerhousedao/pieces-framework"];
+  };
+};
+declare const VERSIONED_DEPENDENCIES: string[];
+declare const BOILERPLATE_ALLOWED_BUILDS: readonly ["@apollo/protobufjs", "@datadog/pprof", "@parcel/watcher", "@reown/appkit", "bufferutil", "esbuild", "keccak", "protobufjs", "utf-8-validate"];
+declare const BOILERPLATE_DEPENDENCY_OVERRIDES: {
+  readonly "date-fns": "4.3.0";
+  readonly vite: "8.0.14";
+  readonly rolldown: "1.0.2";
+};
+declare const VERSIONED_DEV_DEPENDENCIES: string[];
+declare const packageJsonExports: {
+  readonly ".": {
+    readonly types: "./dist/types/index.d.ts";
+    readonly browser: "./dist/browser/index.js";
+    readonly node: "./dist/node/index.mjs";
+  };
+  readonly "./reactor": {
+    readonly types: "./dist/types/reactor/index.d.ts";
+    readonly browser: "./dist/browser/reactor/index.js";
+  };
+  readonly "./document-models": {
+    readonly types: "./dist/types/document-models/index.d.ts";
+    readonly browser: "./dist/browser/document-models/index.js";
+    readonly node: "./dist/node/document-models/index.mjs";
+  };
+  readonly "./document-models/*": {
+    readonly types: "./dist/types/document-models/*/index.d.ts";
+    readonly browser: "./dist/browser/document-models/*/index.js";
+    readonly node: "./dist/node/document-models/*/index.mjs";
+  };
+  readonly "./editors": {
+    readonly types: "./dist/types/editors/index.d.ts";
+    readonly browser: "./dist/browser/editors/index.js";
+    readonly node: "./dist/node/editors/index.mjs";
+  };
+  readonly "./editors/*": {
+    readonly types: "./dist/types/editors/*/editor.d.ts";
+    readonly browser: "./dist/browser/editors/*/editor.js";
+    readonly node: "./dist/node/editors/*/editor.mjs";
+  };
+  readonly "./subgraphs": {
+    readonly types: "./dist/types/subgraphs/index.d.ts";
+    readonly browser: "./dist/browser/subgraphs/index.js";
+    readonly node: "./dist/node/subgraphs/index.mjs";
+  };
+  readonly "./processors": {
+    readonly types: "./dist/types/processors/index.d.ts";
+    readonly browser: "./dist/browser/processors/index.js";
+    readonly node: "./dist/node/processors/index.mjs";
+  };
+  readonly "./pieces": {
+    readonly types: "./dist/types/pieces/index.d.ts";
+    readonly node: "./dist/node/pieces/index.mjs";
+  };
+  readonly "./pieces/*": {
+    readonly types: "./dist/types/pieces/*/index.d.ts";
+    readonly node: "./dist/node/pieces/*/index.mjs";
+  };
+  readonly "./manifest": "./dist/powerhouse.manifest.json";
+  readonly "./style.css": "./dist/style.css";
+};
+declare const packageScripts: {
+  readonly "test:watch": "vitest";
+  readonly lint: "oxlint --type-aware --type-check";
+  readonly "lint:fix": "oxlint --type-aware --type-check --fix";
+  readonly format: "oxfmt";
+  readonly "format:check": "oxfmt --check";
+  readonly tsc: "tsc";
+  readonly "tsc:watch": "tsc --watch";
+  readonly generate: "ph-cli generate";
+  readonly connect: "ph-cli connect";
+  readonly build: "ph-cli build";
+  readonly reactor: "ph-cli reactor";
+  readonly service: "ph-cli service";
+  readonly vetra: "ph-cli vetra";
+  readonly "service-startup": "bash ./node_modules/@powerhousedao/ph-cli/dist/scripts/service-startup.sh";
+  readonly "service-unstartup": "bash ./node_modules/@powerhousedao/ph-cli/dist/scripts/service-unstartup.sh";
+};
+declare const externalDependencies: {};
+declare const LEGACY_LINT_FORMAT_DEPENDENCIES: readonly ["@eslint/js", "eslint", "eslint-config-prettier", "eslint-plugin-prettier", "eslint-plugin-react", "eslint-plugin-react-hooks", "globals", "prettier", "typescript-eslint"];
+declare const LEGACY_LINT_FORMAT_FILES: readonly ["eslint.config.js", "eslint.config.mjs", "eslint.config.cjs", "eslint.config.ts", ".eslintrc", ".eslintrc.js", ".eslintrc.cjs", ".eslintrc.json", ".eslintrc.yml", ".eslintrc.yaml", ".eslintignore", ".prettierrc", ".prettierrc.js", ".prettierrc.cjs", ".prettierrc.json", ".prettierrc.yml", ".prettierrc.yaml", "prettier.config.js", "prettier.config.cjs", "prettier.config.mjs", ".prettierignore"];
+declare const externalDevDependencies: {
+  readonly "@electric-sql/pglite": "0.3.15";
+  readonly "@electric-sql/pglite-tools": "0.2.20";
+  readonly "@powerhousedao/document-engineering": "1.40.5";
+  readonly "@tailwindcss/cli": "^4.1.18";
+  readonly "@tailwindcss/vite": "^4.1.18";
+  readonly "@types/node": "^24.9.2";
+  readonly "@types/react": "^19.2.3";
+  readonly "@types/react-dom": "^19.2.3";
+  readonly "@vitejs/plugin-react": "^6.0.1";
+  readonly "@vitest/coverage-v8": "4.1.1";
+  readonly oxfmt: "0.68.0";
+  readonly oxlint: "1.70.0";
+  readonly "oxlint-tsgolint": "0.23.0";
+  readonly tailwindcss: "^4.1.16";
+  readonly typescript: "~7.0.2";
+  readonly vite: "^8.0.10";
+  readonly "vite-tsconfig-paths": "6.1.1";
+  readonly vitest: "4.1.1";
+};
+declare const defaultManifest: Manifest;
+declare const DEFAULT_CONFIG: PowerhouseConfig;
+//#endregion
+//#region clis/types.d.ts
+type DrivePreserveStrategies = typeof DRIVES_PRESERVE_STRATEGIES;
+type DrivePreserveStrategy = DrivePreserveStrategies[number];
+type LogLevels = typeof LOG_LEVELS;
+type LogLevel = LogLevels[number];
+type PHPackageProvider = "npm" | "github" | "local" | "registry";
+type PowerhousePackage = {
+  packageName: string;
+  version?: string;
+  provider?: PHPackageProvider;
+  url?: string;
+};
+type PHConnectBranding = {
+  appName?: string;
+  homeBackground?: string | null;
+};
+type PHConnectDefaultDriveRemote = {
+  url: string;
+  name?: string | null;
+  icon?: string | null;
+};
+type PHConnectDefaultDriveLocal = {
+  /** Discriminator: this entry is a local drive created on first boot. */
+  local: true;
+  /** Stable drive id; the drive is not re-created on later boots. */
+  id: string;
+  name?: string | null;
+  icon?: string | null;
+  /** Drive app (preferred editor) to open on the drive. */
+  app?: string;
+};
+type PHConnectDefaultDrive = PHConnectDefaultDriveRemote | PHConnectDefaultDriveLocal;
+type PHConnectDriveSection = {
+  enabled?: boolean;
+  allowAdd?: boolean;
+  allowDelete?: boolean;
+};
+type PHConnectDriveSections = {
+  remote?: PHConnectDriveSection;
+  local?: PHConnectDriveSection;
+};
+type PHConnectDrives = {
+  allowAddDrive?: boolean;
+  defaultDrives?: PHConnectDefaultDrive[];
+  preserveStrategy?: DrivePreserveStrategy;
+  sections?: PHConnectDriveSections;
+};
+type PHConnectApp = {
+  logLevel?: "debug" | "info" | "warn" | "error";
+  basePath?: string;
+  offline?: boolean;
+  studioMode?: boolean;
+  workflowsEnabled?: boolean;
+};
+type PHConnectAi = {
+  /** Enables the in-browser AI assistant (chat FAB + window). Off by default. */
+  assistantEnabled?: boolean;
+};
+type PHConnectPackages = {
+  externalEnabled?: boolean;
+  /** Subscribe to the static-mode `/__packages` SSE channel for live reload. */
+  liveReload?: boolean;
+};
+type PHRenownRainbowAdapterConfig = {
+  /** WalletConnect project id; required for the rainbow adapter to function. */
+  walletConnectProjectId?: string;
+  /** Optional Infura project id used to build RPC transports. */
+  infuraProjectId?: string;
+};
+type PHRenownPrivyAdapterConfig = {
+  /** Privy application id; required for the privy adapter to function. */
+  appId?: string;
+  /** Optional Privy client id. */
+  clientId?: string;
+  /** Login methods this adapter offers; defaults per adapter when omitted. */
+  methods?: string[];
+};
+type PHConnectRenownAdapters = {
+  rainbow?: PHRenownRainbowAdapterConfig;
+  privy?: PHRenownPrivyAdapterConfig;
+};
+type PHConnectRenown = {
+  url?: string;
+  networkId?: string;
+  chainId?: number;
+  /** Renown localStorage namespace; share it across Connects to share login. */
+  namespace?: string;
+  /** Switchboard GraphQL URL; when set, enables in-page (no-redirect) auth. */
+  switchboardUrl?: string;
+  /** Per-adapter wallet config; presence of a key enables that adapter. */
+  adapters?: PHConnectRenownAdapters;
+};
+type PHConnectSentry = {
+  /** Sentry DSN URL. `null` disables Sentry entirely. */
+  dsn?: string | null;
+  /** Sentry environment label. */
+  env?: string;
+  /** Enable Sentry performance tracing. */
+  tracing?: boolean;
+};
+type PHConnectInstance = {
+  namespace: string | null;
+  reactorWorker: boolean;
+};
+/** Each flag implies its predecessors, and must match the fleet Connect syncs
+ * with or the two compute different replay outcomes. */
+type PHConnectReactorFeatureFlags = {
+  /** Decide writes from the document stream instead of the meta cache. */
+  documentDecisions?: boolean;
+  /** Enforce the auth scope's policy at admission, replay, and read. */
+  authEnforcement?: boolean;
+  /** Let `{ group }` principals match, via the group documents' rosters. */
+  authGroups?: boolean;
+  /** Evaluate `where` / `match` conditions on grants. */
+  authConditions?: boolean;
+};
+type PHConnectReactor = {
+  featureFlags?: PHConnectReactorFeatureFlags;
+  /** What new documents are created as; `legacy` while peers predate v2-required documents. */
+  createSignaturePolicy?: "legacy" | "v2-required";
+};
+/**
+ * A URL-matching pattern for a service-worker runtime-caching rule, in
+ * JSON-serialisable form. A plain string is handed to Workbox verbatim (exact
+ * URL or same-origin path match). `{ source, flags }` is reconstructed into a
+ * `RegExp` at build time — use it for prefix/suffix/origin matches (e.g.
+ * `{ source: "^https://api\\.acme\\.io/" }`). Function-valued patterns aren't
+ * expressible here; regex covers the realistic package cases.
+ */
+type PHConnectPwaUrlPattern = string | {
+  source: string;
+  flags?: string;
+};
+type PHConnectPwaCacheStrategy = "CacheFirst" | "CacheOnly" | "NetworkFirst" | "NetworkOnly" | "StaleWhileRevalidate";
+/** Serialisable subset of a Workbox `RuntimeCaching` rule. */
+type PHConnectPwaRuntimeCaching = {
+  urlPattern: PHConnectPwaUrlPattern;
+  handler: PHConnectPwaCacheStrategy;
+  method?: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "PATCH";
+  options?: {
+    cacheName?: string;
+    /** Seconds a NetworkFirst rule waits for the network before falling back
+     * to the cache. */
+    networkTimeoutSeconds?: number;
+    expiration?: {
+      maxEntries?: number;
+      maxAgeSeconds?: number;
+    };
+    cacheableResponse?: {
+      statuses?: number[];
+      headers?: Record<string, string>;
+    };
+  };
+};
+type PHConnectPwaIcon = {
+  src: string;
+  sizes?: string;
+  type?: string;
+  purpose?: string;
+};
+/**
+ * A File Handling API entry a package or project contributes: the OS-level
+ * file types the installed Connect PWA offers to open. There is deliberately
+ * no `action` field — consuming launched files requires runtime code that
+ * lives in Connect itself, so every handler (built-in or contributed) opens
+ * at Connect's app root, injected at build time.
+ */
+type PHConnectPwaFileHandler = {
+  /** MIME type → file extensions (each must start with "."). */
+  accept: Record<string, string[]>;
+  /** OS-level file-type icons. */
+  icons?: PHConnectPwaIcon[];
+  launch_type?: "single-client" | "multiple-clients";
+};
+/** Web-app-manifest fields a package or project may override. */
+type PHConnectPwaManifest = {
+  name?: string;
+  short_name?: string;
+  description?: string;
+  theme_color?: string;
+  background_color?: string;
+  display?: "fullscreen" | "standalone" | "minimal-ui" | "browser";
+  start_url?: string;
+  scope?: string;
+  icons?: PHConnectPwaIcon[];
+  /** Extra file associations, appended after Connect's built-in `.phd`/`.phdm` handler. */
+  file_handlers?: PHConnectPwaFileHandler[];
+  /** How the OS launches the app for handled files/links. */
+  launch_handler?: {
+    client_mode: "auto" | "focus-existing" | "navigate-existing" | "navigate-new";
+  };
+  /** App-store-style categories. NOT authored under `connect.pwa` — derived at
+   * build/runtime from the `category` field of every contributing
+   * `powerhouse.manifest.json` (project + packages), unioned across them. */
+  categories?: string[];
+};
+/**
+ * PWA / service-worker overrides contributed by a package or the project.
+ * Layered on top of Connect's hardcoded PWA defaults at build time. Scalar
+ * fields deep-merge (later layer wins); every array member — the manifest
+ * arrays (`icons`, `file_handlers`, and the derived `categories`) plus the
+ * top-level `globPatterns`, `globIgnores`, `runtimeCaching` and
+ * `navigateFallbackDenylist` — is additive (concatenated/unioned);
+ * `maximumFileSizeToCacheInBytes` takes the max across contributors.
+ * Precedence: defaults < package fragments < project config.
+ */
+type PHConnectPwa = {
+  manifest?: PHConnectPwaManifest;
+  /** Extra Workbox precache globs, unioned with the built-in patterns. */
+  globPatterns?: string[];
+  /** Extra Workbox precache ignore globs, unioned with the built-in list. */
+  globIgnores?: string[];
+  /** Raise the precache file-size ceiling; the max across contributors wins. */
+  maximumFileSizeToCacheInBytes?: number;
+  /** Additional runtime-caching rules, appended after the built-in rules. */
+  runtimeCaching?: PHConnectPwaRuntimeCaching[];
+  /** Extra SPA-fallback denylist patterns, unioned with the built-in list. */
+  navigateFallbackDenylist?: PHConnectPwaUrlPattern[];
+};
+type PHConnectRuntimeConfig = {
+  branding?: PHConnectBranding;
+  app?: PHConnectApp;
+  ai?: PHConnectAi;
+  packages?: PHConnectPackages;
+  drives?: PHConnectDrives;
+  renown?: PHConnectRenown;
+  sentry?: PHConnectSentry;
+  instance?: PHConnectInstance;
+  reactor?: PHConnectReactor;
+  pwa?: PHConnectPwa;
+};
+/** Which Renown instance a reactor authenticates against, server-side. */
+type PHReactorRenown = {
+  /** "self" reads this reactor's own renown read model; "remote" (default)
+   * queries a Renown or Switchboard instance. */
+  source?: "remote" | "self";
+  /** Renown base URL; also the instance this reactor's own identity uses. */
+  url?: string;
+  /** Switchboard GraphQL endpoint to read credentials from directly. */
+  switchboardUrl?: string;
+};
+type PowerhouseConfig = {
+  logLevel: LogLevel;
+  documentModelsDir: string;
+  editorsDir: string;
+  processorsDir: string;
+  subgraphsDir: string;
+  importScriptsDir: string;
+  skipFormat: boolean;
+  interactive?: boolean;
+  watch?: boolean;
+  reactor?: {
+    port?: number;
+    https?: undefined | boolean | {
+      keyPath: string;
+      certPath: string;
+    };
+    storage?: {
+      type: "filesystem" | "memory" | "postgres" | "browser";
+      filesystemPath?: string;
+      postgresUrl?: string;
+    };
+  };
+  auth?: {
+    enabled?: boolean;
+    admins: string[];
+    renown?: PHReactorRenown;
+  };
+  switchboard?: {
+    database?: {
+      url?: string;
+    };
+    port?: number;
+  };
+  studio?: {
+    port?: number;
+    host?: string;
+    https: boolean;
+    openBrowser?: boolean;
+  };
+  packages?: PowerhousePackage[];
+  vetra?: {
+    driveId?: string;
+    driveUrl?: string;
+    connectPort?: number;
+  };
+  workflows?: {
+    enabled?: boolean;
+  };
+  packageRegistryUrl?: string;
+  connect?: PHConnectRuntimeConfig;
+};
+//#endregion
+//#region document-model/schemas.d.ts
+declare const ManifestSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  category: z.ZodOptional<z.ZodString>;
+  image: z.ZodOptional<z.ZodString>;
+  publisher: z.ZodOptional<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  documentModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  apps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  editors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  processors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  subgraphs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  pieces: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    version: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    bundle: z.ZodOptional<z.ZodString>;
+    descriptor: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  config: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"var">, z.ZodLiteral<"secret">]>;
+    description: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  pwa: z.ZodOptional<z.ZodType<PHConnectPwa, unknown, z.core.$ZodTypeInternals<PHConnectPwa, unknown>>>;
+}, z.core.$strip>;
+//#endregion
+//#region document-model/types.d.ts
+type Manifest = z.infer<typeof ManifestSchema>;
+//#endregion
+export { PIECES_FRAMEWORK_PACKAGE as A, VERSIONED_DEPENDENCIES as B, LEGACY_LINT_FORMAT_FILES as C, PH_BIN as D, PEER_EXTERNAL_DEPENDENCIES as E, PROJECT_PORT_BAND_SWITCHBOARD as F, externalDevDependencies as G, VERSIONED_PEER_DEPENDENCIES as H, PROJECT_PORT_BAND_VETRA_CONNECT as I, packageJsonExports as K, REACTOR_API_PACKAGE as L, POWERHOUSE_GLOBAL_DIR as M, PROJECT_PORT_BAND_SIZE as N, PH_GLOBAL_DIR_NAME as O, PROJECT_PORT_BAND_STUDIO as P, SECONDS_IN_DAY as R, LEGACY_LINT_FORMAT_DEPENDENCIES as S, MINIMUM_NODE_VERSION as T, defaultManifest as U, VERSIONED_DEV_DEPENDENCIES as V, externalDependencies as W, DRIVES_PRESERVE_STRATEGIES as _, DEFAULT_CONFIG as a, GRAPHQL_TAG_PACKAGE as b, DEFAULT_CONNECT_STUDIO_PORT as c, DEFAULT_REGISTRY_URL as d, DEFAULT_RENOWN_URL as f, DEFAULT_VETRA_DRIVE_ID as g, DEFAULT_VETRA_CONNECT_PORT as h, BOILERPLATE_DEPENDENCY_OVERRIDES as i, POWERHOUSE_CONFIG_FILE as j, PH_GLOBAL_PROJECT_NAME as k, DEFAULT_EXPIRY_DAYS as l, DEFAULT_TIMEOUT as m, ANALYTICS_ENGINE_CORE_PACKAGE as n, DEFAULT_CONNECT_OUTDIR as o, DEFAULT_SWITCHBOARD_PORT as p, packageScripts as q, BOILERPLATE_ALLOWED_BUILDS as r, DEFAULT_CONNECT_PREVIEW_PORT as s, Manifest as t, DEFAULT_EXPIRY_SECONDS as u, FEATURE_DEPENDENCIES as v, LOG_LEVELS as w, HOME_DIR as x, GRAPHQL_PACKAGE as y, SERVICE_ACTIONS as z };
+export {};
+//# sourceMappingURL=types-CMFHKrgv.d.mts.map

package/dist/clis/types-CMFHKrgv.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CMFHKrgv.d.mts","names":[],"sources":["../../clis/constants.ts","../../clis/types.ts","../../document-model/schemas.ts","../../document-model/types.ts"],"mappings":";;;;;;;cAKa;cAQA;cACA;cACA;cAEA;cAKA;cAQA;cAEA;cAEA;cAEA;cAEA;cAEA;cAEA;cAEA;cAqBA;cACA;cACA;cACA;cAEA;cAEA;cACA;cACA;cACA;cAEA;cAEA;cAEA;cAGA;cAOA;cACA;cAEA;cACA;cACA;cAQA;;aACU;aAAa;;;aACT;aAAY;;;aAC5B;aAAa;;;aACP;aAAa;;;aACrB;aAAY;;;cAKR;;aAET;aACA;aACA;;;aAKA;aACA;aACA;;;cAWS;cAUA;cAiBA;WACC;WACN;WACI;;cAGC;cAQA;WACX;aACE;aACA;aACA;;WAEF;aACE;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAKF;aACE;aACA;;WAEF;aACE;aACA;;WAEF;WACA;;cAGW;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WAEA;;cAIW;cAIA;cAcA;cAwBA;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;cAGW,iBAAiB;cAuBjB,gBAAgB;;;KCxUjB,iCAAiC;KACjC,wBAAwB;KACxB,mBAAmB;KACnB,WAAW;KAOX;KAGA;EACV;EACA;EACA,WAAW;EACX;;KAGU;EACV;EACA;;KAGU;EACV;EACA;EACA;;KAGU;;EAEV;;EAEA;EACA;EACA;;EAEA;;KAGU,wBACR,8BACA;KAEQ;EACV;EACA;EACA;;KAGU;EACV,SAAS;EACT,QAAQ;;KAGE;EACV;EACA,gBAAgB;EAChB,mBAAmB;EACnB,WAAW;;KAGD;EACV;EACA;EACA;EAGA;EAKA;;KAGU;;EAEV;;KAGU;EACV;;EAEA;;KAGU;;EAEV;;EAEA;;KAGU;;EAEV;;EAEA;;EAEA;;KAGU;EACV,UAAU;EACV,QAAQ;;KAGE;EACV;EACA;EACA;;EAEA;;EAEA;;EAEA,WAAW;;KAGD;;EAEV;;EAEA;;EAEA;;KAGU;EACV;EACA;;;;KAKU;;EAEV;;EAEA;;EAEA;;EAEA;;KAGU;EACV,eAAe;;EAEf;;;;;;;;;;KAWU;EAEN;EAAgB;;KAEV;;KAQA;EACV,YAAY;EACZ,SAAS;EACT;EACA;IACE;;;IAGA;IACA;MAAe;MAAqB;;IACpC;MACE;MACA,UAAU;;;;KAKJ;EACV;EACA;EACA;EACA;;;;;;;;;KAUU;;EAEV,QAAQ;;EAER,QAAQ;EACR;;;KAIU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;EAER,gBAAgB;;EAEhB;IACE;;;;;EASF;;;;;;;;;;;;KAaU;EACV,WAAW;;EAEX;;EAEA;;EAEA;;EAEA,iBAAiB;;EAEjB,2BAA2B;;KAGjB;EACV,WAAW;EACX,MAAM;EACN,KAAK;EACL,WAAW;EACX,SAAS;EACT,SAAS;EACT,SAAS;EACT,WAAW;EACX,UAAU;EACV,MAAM;;;KAII;;;EAGV;;EAEA;;EAEA;;KAGU;EAEV,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;IACE;IACA;MAIM;MACA;;IAEN;MACE;MACA;MACA;;;EAGJ;IACE;IACA;IACA,SAAS;;EAEX;IACE;MACE;;IAEF;;EAEF;IACE;IACA;IACA;IACA;;EAEF,WAAW;EACX;IACE;IACA;IACA;;EAIF;IACE;;EAEF;EACA,UAAU;;;;cC2fC,gBAAc,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiBzB,EAAA,KAAA;;;KC+zBU,WAAW,EAAE,aAAa"}

package/dist/clis/utils.d.mts

@@ -5,15 +5,15 @@
  * `strict-dep-builds=true` default doesn't prompt for approval during the
  * outer dlx download. No-op for other package managers or non-dlx commands.
  */
-declare function injectPnpmAllowBuilds(pm: string, resolved: {
+export declare function injectPnpmAllowBuilds(pm: string, resolved: {
   command: string;
   args: string[];
 }): void;
-declare class NodeVersionError extends Error {
+export declare class NodeVersionError extends Error {
   constructor(currentVersion: string, minimumVersion: string);
   static isError(error: unknown): error is NodeVersionError;
 }
-declare function assertNodeVersion(nodeVersion?: string): void;
+export declare function assertNodeVersion(nodeVersion?: string): void;
 //#endregion
-export { NodeVersionError, assertNodeVersion, injectPnpmAllowBuilds };
+export {};
 //# sourceMappingURL=utils.d.mts.map

package/dist/clis/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../../clis/utils.ts"],"mappings":";;AAaA;;;;;iBAAgB,qBAAA,CACd,EAAA,UACA,QAAA;EAAY,OAAA;EAAiB,IAAA;AAAA;AAAA,cAOlB,gBAAA,SAAyB,KAAA;cACxB,cAAA,UAAwB,cAAA;EAAA,OAO7B,OAAA,CAAQ,KAAA,YAAiB,KAAA,IAAS,gBAAA;AAAA;AAAA,iBAK3B,iBAAA,CAAkB,WAAA"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../clis/utils.ts"],"mappings":";;;;;;;wBAagB,sBACd,YACA;EAAY;EAAiB;;qBAOlB,yBAAyB;EACpC,YAAY,wBAAwB;SAO7B,QAAQ,iBAAiB,SAAS;;wBAK3B,kBAAkB"}

package/dist/clis/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","names":[],"sources":["../../clis/utils.ts"],"sourcesContent":["// Sub-path: this module loads on the cold path of every CLI invocation.\nimport lt from \"semver/functions/lt.js\";\nimport {\n  BOILERPLATE_ALLOWED_BUILDS,\n  MINIMUM_NODE_VERSION,\n} from \"./constants.js\";\n\n/**\n * Mutates a resolved `pnpm dlx ...` command to add one `--allow-build=<pkg>`\n * flag per package in {@link BOILERPLATE_ALLOWED_BUILDS}, so pnpm 11's\n * `strict-dep-builds=true` default doesn't prompt for approval during the\n * outer dlx download. No-op for other package managers or non-dlx commands.\n */\nexport function injectPnpmAllowBuilds(\n  pm: string,\n  resolved: { command: string; args: string[] },\n): void {\n  if (pm !== \"pnpm\" || resolved.args[0] !== \"dlx\") return;\n  const flags = BOILERPLATE_ALLOWED_BUILDS.map((pkg) => `--allow-build=${pkg}`);\n  resolved.args = [resolved.args[0], ...flags, ...resolved.args.slice(1)];\n}\n\nexport class NodeVersionError extends Error {\n  constructor(currentVersion: string, minimumVersion: string) {\n    super(\n      `Node version ${minimumVersion} or higher is required. Current version: ${currentVersion}`,\n    );\n    this.name = \"NodeVersionError\";\n  }\n\n  static isError(error: unknown): error is NodeVersionError {\n    return error instanceof Error && error.name === \"NodeVersionError\";\n  }\n}\n\nexport function assertNodeVersion(nodeVersion = process.versions.node) {\n  if (!nodeVersion) return;\n\n  if (lt(nodeVersion, MINIMUM_NODE_VERSION)) {\n    throw new NodeVersionError(nodeVersion, MINIMUM_NODE_VERSION);\n  }\n}\n"],"mappings":";;;;;;;;;AAaA,SAAgB,sBACd,IACA,UACM;AACN,KAAI,OAAO,UAAU,SAAS,KAAK,OAAO,MAAO;CACjD,MAAM,QAAQ,2BAA2B,KAAK,QAAQ,iBAAiB,MAAM;AAC7E,UAAS,OAAO;EAAC,SAAS,KAAK;EAAI,GAAG;EAAO,GAAG,SAAS,KAAK,MAAM,EAAE;EAAC;;AAGzE,IAAa,mBAAb,cAAsC,MAAM;CAC1C,YAAY,gBAAwB,gBAAwB;AAC1D,QACE,gBAAgB,eAAe,2CAA2C,iBAC3E;AACD,OAAK,OAAO;;CAGd,OAAO,QAAQ,OAA2C;AACxD,SAAO,iBAAiB,SAAS,MAAM,SAAS;;;AAIpD,SAAgB,kBAAkB,cAAc,QAAQ,SAAS,MAAM;AACrE,KAAI,CAAC,YAAa;AAElB,KAAI,GAAG,aAAA,SAAkC,CACvC,OAAM,IAAI,iBAAiB,aAAa,qBAAqB"}
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../clis/utils.ts"],"sourcesContent":["// Sub-path: this module loads on the cold path of every CLI invocation.\nimport lt from \"semver/functions/lt.js\";\nimport {\n  BOILERPLATE_ALLOWED_BUILDS,\n  MINIMUM_NODE_VERSION,\n} from \"./constants.js\";\n\n/**\n * Mutates a resolved `pnpm dlx ...` command to add one `--allow-build=<pkg>`\n * flag per package in {@link BOILERPLATE_ALLOWED_BUILDS}, so pnpm 11's\n * `strict-dep-builds=true` default doesn't prompt for approval during the\n * outer dlx download. No-op for other package managers or non-dlx commands.\n */\nexport function injectPnpmAllowBuilds(\n  pm: string,\n  resolved: { command: string; args: string[] },\n): void {\n  if (pm !== \"pnpm\" || resolved.args[0] !== \"dlx\") return;\n  const flags = BOILERPLATE_ALLOWED_BUILDS.map((pkg) => `--allow-build=${pkg}`);\n  resolved.args = [resolved.args[0], ...flags, ...resolved.args.slice(1)];\n}\n\nexport class NodeVersionError extends Error {\n  constructor(currentVersion: string, minimumVersion: string) {\n    super(\n      `Node version ${minimumVersion} or higher is required. Current version: ${currentVersion}`,\n    );\n    this.name = \"NodeVersionError\";\n  }\n\n  static isError(error: unknown): error is NodeVersionError {\n    return error instanceof Error && error.name === \"NodeVersionError\";\n  }\n}\n\nexport function assertNodeVersion(nodeVersion = process.versions.node) {\n  if (!nodeVersion) return;\n\n  if (lt(nodeVersion, MINIMUM_NODE_VERSION)) {\n    throw new NodeVersionError(nodeVersion, MINIMUM_NODE_VERSION);\n  }\n}\n"],"mappings":";;;;;;;;;AAaA,SAAgB,sBACd,IACA,UACM;CACN,IAAI,OAAO,UAAU,SAAS,KAAK,OAAO,OAAO;CACjD,MAAM,QAAQ,2BAA2B,KAAK,QAAQ,iBAAiB,KAAK;CAC5E,SAAS,OAAO;EAAC,SAAS,KAAK;EAAI,GAAG;EAAO,GAAG,SAAS,KAAK,MAAM,CAAC;CAAC;AACxE;AAEA,IAAa,mBAAb,cAAsC,MAAM;CAC1C,YAAY,gBAAwB,gBAAwB;EAC1D,MACE,gBAAgB,eAAe,2CAA2C,gBAC5E;EACA,KAAK,OAAO;CACd;CAEA,OAAO,QAAQ,OAA2C;EACxD,OAAO,iBAAiB,SAAS,MAAM,SAAS;CAClD;AACF;AAEA,SAAgB,kBAAkB,cAAc,QAAQ,SAAS,MAAM;CACrE,IAAI,CAAC,aAAa;CAElB,IAAI,GAAG,aAAA,QAAiC,GACtC,MAAM,IAAI,iBAAiB,aAAa,oBAAoB;AAEhE"}

package/dist/{config-loader-B845Hidf.js → config-loader-CWQxMERh.js}

@@ -48,12 +48,15 @@ const DEFAULT_CONNECT_CONFIG = {
 		namespace: null,
 		reactorWorker: false
 	},
-	reactor: { featureFlags: {
-		documentDecisions: false,
-		authEnforcement: false,
-		authGroups: false,
-		authConditions: false
-	} }
+	reactor: {
+		featureFlags: {
+			documentDecisions: false,
+			authEnforcement: false,
+			authGroups: false,
+			authConditions: false
+		},
+		createSignaturePolicy: "v2-required"
+	}
 };
 function buildRuntimeConfig(source, projectInfo) {
 	const result = {
@@ -87,6 +90,15 @@ function deepMerge(base, patch) {
 	return result;
 }
 /**
+* The effective `connect.*` block of a source `powerhouse.config.json`:
+* defaults < project-wide settings Connect follows < `connect.*`. So
+* `connect.app.workflowsEnabled` falls back to `workflows.enabled`, and
+* wins when set.
+*/
+function resolveSourceConnect(source, defaults = DEFAULT_CONNECT_CONFIG) {
+	return deepMerge(deepMerge(defaults, { app: { workflowsEnabled: source.workflows?.enabled } }), source.connect ?? {});
+}
+/**
 * Pluggable loader on top of a `ConfigAdapter`.
 *
 * Responsibilities:
@@ -99,6 +111,8 @@ function deepMerge(base, patch) {
 * CLI typically constructs a fresh loader per command.
 */
 var ConfigLoader = class {
+	adapter;
+	defaults;
 	cache;
 	constructor(adapter, defaults = DEFAULT_CONNECT_CONFIG) {
 		this.adapter = adapter;
@@ -142,6 +156,6 @@ var ConfigLoader = class {
 	}
 };
 //#endregion
-export { buildRuntimeConfig as i, deepMerge as n, DEFAULT_CONNECT_CONFIG as r, ConfigLoader as t };
+export { buildRuntimeConfig as a, DEFAULT_CONNECT_CONFIG as i, deepMerge as n, resolveSourceConnect as r, ConfigLoader as t };
 
-//# sourceMappingURL=config-loader-B845Hidf.js.map
+//# sourceMappingURL=config-loader-CWQxMERh.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader-CWQxMERh.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  ai: {\n    assistantEnabled: 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    createSignaturePolicy: \"v2-required\",\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 {\n  PHConnectRuntimeConfig,\n  PowerhouseConfig,\n} 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 * The effective `connect.*` block of a source `powerhouse.config.json`:\n * defaults < project-wide settings Connect follows < `connect.*`. So\n * `connect.app.workflowsEnabled` falls back to `workflows.enabled`, and\n * wins when set.\n */\nexport function resolveSourceConnect(\n  source: Pick<PowerhouseConfig, \"connect\" | \"workflows\">,\n  defaults: PHConnectRuntimeConfig = DEFAULT_CONNECT_CONFIG,\n): PHConnectRuntimeConfig {\n  const projectWide = deepMerge(defaults, {\n    app: { workflowsEnabled: source.workflows?.enabled },\n  });\n  return deepMerge(projectWide, source.connect ?? {});\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;CAClB;CACA,KAAK;EACH,UAAU;EACV,UAAU;EACV,SAAS;EACT,YAAY;CACd;CACA,IAAI,EACF,kBAAkB,MACpB;CACA,UAAU;EACR,iBAAiB;EACjB,YAAY;CACd;CACA,QAAQ;EACN,eAAe;EACf,eAAe,CAAC;EAChB,UAAU;GACR,QAAQ;IAAE,SAAS;IAAM,UAAU;IAAM,aAAa;GAAK;GAC3D,OAAO;IAAE,SAAS;IAAM,UAAU;IAAM,aAAa;GAAK;EAC5D;CACF;CACA,QAAQ;EACN,KAAK;EACL,WAAW;EACX,SAAS;CACX;CACA,QAAQ;EAIN,KAAK;EACL,KAAK;EACL,SAAS;CACX;CACA,UAAU;EACR,WAAW;EACX,eAAe;CACjB;CACA,SAAS;EACP,cAAc;GACZ,mBAAmB;GACnB,iBAAiB;GACjB,YAAY;GACZ,gBAAgB;EAClB;EACA,uBAAuB;CACzB;AACF;AAEA,SAAgB,mBACd,QACA,aACyB;CACzB,MAAM,SAAkC;EACtC,eAAe;EACf,UAAU,OAAO,YAAY,CAAC;EAC9B,cAAc;EACd,SAAS,OAAO,WAAW,CAAC;CAC9B;CACA,IACE,OAAO,OAAO,uBAAuB,YACrC,OAAO,uBAAuB,IAE9B,OAAO,qBAAqB,OAAO;CAErC,OAAO;AACT;;;;;;;;;;;ACrBA,SAAgB,UAAa,MAAS,OAA0B;CAC9D,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc,KAAK,GAC9C,OAAO;CAET,MAAM,SAAkC,EAAE,GAAG,KAAK;CAClD,KAAK,MAAM,CAAC,KAAK,eAAe,OAAO,QAAQ,KAAK,GAAG;EACrD,IAAI,eAAe,KAAA,GAAW;EAC9B,MAAM,YAAY,OAAO;EACzB,IAAI,cAAc,SAAS,KAAK,cAAc,UAAU,GACtD,OAAO,OAAO,UACZ,WACA,UACF;OAEA,OAAO,OAAO;CAElB;CACA,OAAO;AACT;;;;;;;AAQA,SAAgB,qBACd,QACA,WAAmC,wBACX;CAIxB,OAAO,UAHa,UAAU,UAAU,EACtC,KAAK,EAAE,kBAAkB,OAAO,WAAW,QAAQ,EACrD,CAC2B,GAAG,OAAO,WAAW,CAAC,CAAC;AACpD;;;;;;;;;;;;;AAcA,IAAa,eAAb,MAA0B;CAIL;CACA;CAJnB;CAEA,YACE,SACA,WAAoD,wBACpD;EAFiB,KAAA,UAAA;EACA,KAAA,WAAA;CAChB;;;CAIH,MAAM,OAA6B;EACjC,IAAI,KAAK,OAAO,OAAO,KAAK;EAC5B,MAAM,MAAM,MAAM,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC;EACxC,MAAM,aAAa,cAAc,IAAI,OAAO,IAAI,IAAI,UAAU,CAAC;EAC/D,KAAK,QAAQ;GACX,GAAG;GACH,SAAS,UACP,KAAK,UACL,UACF;EACF;EACA,OAAO,KAAK;CACd;;;;;CAMA,YAAyB;EACvB,IAAI,CAAC,KAAK,OACR,MAAM,IAAI,MACR,iBAAiB,KAAK,QAAQ,OAAO,mCACvC;EAEF,OAAO,KAAK;CACd;;CAGA,aAAmB;EACjB,KAAK,QAAQ,KAAA;CACf;;;;;;CAOA,MAAM,MAAM,OAAuD;EAEjE,MAAM,OAAO,UAAU,MADD,KAAK,KAAK,GACA,KAAK;EACrC,MAAM,KAAK,QAAQ,MAAM,IAAI;EAC7B,KAAK,QAAQ;EACb,OAAO;CACT;AACF"}