@powerhousedao/shared 6.1.0 → 6.2.0-dev.0

package/dist/connect/index.js

@@ -1,3 +1,5 @@
+import { i as buildRuntimeConfig, n as deepMerge, r as DEFAULT_CONNECT_CONFIG, t as ConfigLoader } from "../config-loader-DORViRnN.js";
+import { JsonConfigAdapter } from "./json-adapter.js";
 import { z } from "zod";
 //#region connect/env-config.ts
 /**
@@ -9,97 +11,39 @@ const booleanString = z.union([z.boolean(), z.enum(["true", "false"])]).transfor
 	return val === "true";
 });
 /**
-* Coerces string values to number.
-*/
-const numberString = z.union([z.number(), z.string()]).transform((val) => {
-	if (typeof val === "number") return val;
-	return parseInt(val, 10);
-});
-/**
 * Build-time configuration schema
 */
 const buildEnvSchema = z.object({
-	PH_CONFIG_PATH: z.string().optional(),
 	PH_PACKAGES: z.string().optional(),
 	PH_LOCAL_PACKAGE: z.string().optional(),
-	PH_DISABLE_LOCAL_PACKAGE: booleanString.default(false),
-	PH_WATCH_TIMEOUT: numberString.default(300),
 	PH_SENTRY_AUTH_TOKEN: z.string().optional(),
 	PH_SENTRY_ORG: z.string().optional(),
 	PH_SENTRY_PROJECT: z.string().optional()
 });
 /**
-* Application configuration schema
+* Connect runtime values (anything in `PHConnectRuntimeConfig`) are NOT
+* settable from env vars. They live in `powerhouse.config.json` and are
+* overridden via `ph connect build --<field>` or `ph connect config
+* --<field>`.
+*
+* What stays env-driven below is non-runtime: build metadata, Sentry
+* credentials, analytics processor toggles, etc.
 */
 const appConfigSchema = z.object({
 	PH_CONNECT_VERSION: z.string().default("unknown"),
-	PH_CONNECT_LOG_LEVEL: z.enum([
-		"debug",
-		"info",
-		"warn",
-		"error"
-	]).default("info"),
-	PH_CONNECT_REQUIRES_HARD_REFRESH: booleanString.default(true),
-	PH_CONNECT_WARN_OUTDATED_APP: booleanString.default(false),
-	PH_CONNECT_STUDIO_MODE: booleanString.default(false),
-	PH_CONNECT_BASE_PATH: z.string().optional(),
-	PH_CONNECT_DEFAULT_DRIVES_URL: z.string().optional(),
-	PH_CONNECT_PACKAGES: z.string().optional(),
-	PH_CONNECT_PACKAGES_REGISTRY: z.string().optional(),
-	PH_CONNECT_DRIVES_PRESERVE_STRATEGY: z.string().optional(),
-	PH_CONNECT_VERSION_CHECK_INTERVAL: numberString.default(3600 * 1e3),
-	PH_CONNECT_CLI_VERSION: z.string().optional(),
-	PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE: numberString.default(50)
-});
-/**
-* Feature flags and UI configuration schema
-*/
-const featureFlagsSchema = z.object({
-	PH_CONNECT_DISABLE_ADD_DRIVE: booleanString.default(false),
-	PH_CONNECT_SEARCH_BAR_ENABLED: booleanString.default(false),
-	PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS: booleanString.default(true),
-	PH_CONNECT_ENABLED_EDITORS: z.string().optional(),
-	PH_CONNECT_DISABLED_EDITORS: z.string().default("powerhouse/document-drive"),
-	PH_CONNECT_GA_TRACKING_ID: z.string().optional(),
-	PH_CONNECT_EXTERNAL_PACKAGES_DISABLED: booleanString.default(false)
+	PH_CONNECT_CLI_VERSION: z.string().optional()
 });
 /**
-* Drives configuration schema
+* Analytics processor configuration schema. These are non-runtime feature
+* toggles for the analytics subsystem — they don't live in the runtime
+* schema and stay env-driven.
 */
-const drivesConfigSchema = z.object({
-	PH_CONNECT_PUBLIC_DRIVES_ENABLED: booleanString.default(true),
-	PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES: booleanString.default(false),
-	PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES: booleanString.default(false),
-	PH_CONNECT_CLOUD_DRIVES_ENABLED: booleanString.default(true),
-	PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES: booleanString.default(false),
-	PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES: booleanString.default(false),
-	PH_CONNECT_LOCAL_DRIVES_ENABLED: booleanString.default(true),
-	PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES: booleanString.default(false),
-	PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES: booleanString.default(false)
-});
-/**
-* Analytics processor configuration schema
-*/
-const analyticsProcessorsConfigSchema = z.object({
-	PH_CONNECT_ANALYTICS_ENABLED: booleanString.default(true),
-	PH_CONNECT_ANALYTICS_DATABASE_NAME: z.string().optional(),
-	PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED: booleanString.default(true),
+const processorsConfigSchema = z.object({
 	PH_CONNECT_DIFF_ANALYTICS_ENABLED: booleanString.default(false),
 	PH_CONNECT_DRIVE_ANALYTICS_ENABLED: booleanString.default(true),
 	PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: booleanString.default(true)
 });
 /**
-* Relational DB processor configuration schema
-*/
-const relationalProcessorsConfigSchema = z.object({
-	PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED: booleanString.default(true),
-	PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED: booleanString.default(true)
-});
-const processorsConfigSchema = z.object({
-	PH_CONNECT_PROCESSORS_ENABLED: booleanString.default(true),
-	PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: booleanString.default(true)
-}).extend(analyticsProcessorsConfigSchema.shape).extend(relationalProcessorsConfigSchema.shape);
-/**
 * OpenPanel analytics configuration schema
 */
 const openPanelConfigSchema = z.object({
@@ -109,26 +53,11 @@ const openPanelConfigSchema = z.object({
 	PH_CONNECT_OPENPANEL_TRACK_OPERATIONS: booleanString.default(true)
 });
 /**
-* Sentry error tracking configuration schema
-*/
-const sentryConfigSchema = z.object({
-	PH_CONNECT_SENTRY_RELEASE: z.string().optional(),
-	PH_CONNECT_SENTRY_DSN: z.string().optional(),
-	PH_CONNECT_SENTRY_ENV: z.string().default("dev"),
-	PH_CONNECT_SENTRY_TRACING_ENABLED: booleanString.default(false)
-});
-/**
-* Renown authentication configuration schema
-*/
-const renownConfigSchema = z.object({
-	PH_CONNECT_RENOWN_URL: z.string().default("https://www.renown.id"),
-	PH_CONNECT_RENOWN_NETWORK_ID: z.string().default("eip155"),
-	PH_CONNECT_RENOWN_CHAIN_ID: numberString.default(1)
-});
-/**
-* Complete runtime environment schema (all PH_CONNECT_* vars)
+* Complete runtime environment schema (all PH_CONNECT_* vars). Only
+* build-metadata + analytics-processor toggles live here; all Connect
+* runtime config lives in `powerhouse.config.json`.
 */
-const runtimeEnvSchema = appConfigSchema.extend(featureFlagsSchema.shape).extend(drivesConfigSchema.shape).extend(processorsConfigSchema.shape).extend(openPanelConfigSchema.shape).extend(sentryConfigSchema.shape).extend(renownConfigSchema.shape);
+const runtimeEnvSchema = appConfigSchema.extend(processorsConfigSchema.shape).extend(openPanelConfigSchema.shape);
 /**
 * Complete environment schema (build + runtime)
 */
@@ -172,9 +101,8 @@ function mergeEnvSources(options, keys, schema) {
 /**
 * Loads and validates environment variables with priority:
 * 1. process.env (highest)
-* 2. options
-* 3. fileEnv
-* 4. defaults from schema (lowest)
+* 2. fileEnv
+* 3. defaults from schema (lowest)
 *
 * @param options - Environment sources in priority order
 * @returns Validated and typed environment configuration
@@ -184,7 +112,9 @@ function loadConnectEnv(options = {}) {
 	return connectEnvSchema.parse(merged);
 }
 /**
-* Loads only runtime environment variables
+* Loads only runtime environment variables (build metadata + Sentry +
+* analytics-processor toggles — everything in the Connect runtime schema
+* is sourced from powerhouse.config.json, not env).
 *
 * @param options - Environment sources in priority order
 * @returns Validated runtime environment configuration
@@ -194,16 +124,6 @@ function loadRuntimeEnv(options = {}) {
 	return runtimeEnvSchema.parse(merged);
 }
 /**
-* Loads only build-time environment variables
-*
-* @param options - Environment sources in priority order
-* @returns Validated build environment configuration
-*/
-function loadBuildEnv(options = {}) {
-	const merged = mergeEnvSources(options, new Set(Object.keys(buildEnvSchema.shape)), buildEnvSchema);
-	return buildEnvSchema.parse(merged);
-}
-/**
 * Safely sets Connect environment variables with validation.
 * Invalid values will log a warning and be skipped.
 *
@@ -212,9 +132,8 @@ function loadBuildEnv(options = {}) {
 * @example
 * ```ts
 * setConnectEnv({
-*   PH_CONNECT_LOG_LEVEL: "debug",
 *   PH_CONNECT_VERSION: "1.2.3",
-*   PH_CONNECT_STUDIO_MODE: true,
+*   PH_CONNECT_SENTRY_DSN: "https://…",
 * });
 * ```
 */
@@ -257,7 +176,240 @@ function normalizeBasePath(basePath) {
 	if (!normalized.endsWith("/")) normalized = `${normalized}/`;
 	return normalized;
 }
+/**
+* Base storage namespace for a Connect instance served at the root of an
+* origin. Kept as a literal so root deployments resolve to a byte-identical
+* value with no migration.
+*/
+const ROOT_STORAGE_NAMESPACE = "reactor";
+/**
+* Derives the origin-scoped storage namespace from a Connect base path.
+*
+* Connect instances served under different path prefixes of the same origin
+* (e.g. behind a reverse proxy) otherwise share all origin-scoped browser
+* storage (PGlite data dirs, IndexedDB). This produces a deterministic,
+* collision-free namespace per distinct prefix that is valid as an
+* IndexedDB database name.
+*
+* - root base path ("/" or unset) -> "reactor" (byte-identical to the legacy
+*   key, so existing root deployments keep their data with zero migration)
+* - any non-root base path -> "reactor--<slug>", e.g.
+*   "/reactor-project/vetra-studio/" -> "reactor--reactor-project-vetra-studio"
+*
+* @param basePath - The Connect base path (env.PH_CONNECT_BASE_PATH ||
+*   import.meta.env.BASE_URL); normalized internally.
+* @returns The storage namespace.
+*
+* @example
+* getStorageNamespace('/') // 'reactor'
+* getStorageNamespace('/reactor-project/vetra-studio/') // 'reactor--reactor-project-vetra-studio'
+*/
+function getStorageNamespace(basePath) {
+	const normalized = normalizeBasePath(basePath);
+	if (normalized === "/") return ROOT_STORAGE_NAMESPACE;
+	return `${ROOT_STORAGE_NAMESPACE}--${normalized.slice(1, -1).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "default"}`;
+}
+//#endregion
+//#region connect/schema-fragments.ts
+const powerhousePackageSchema = {
+	type: "object",
+	additionalProperties: false,
+	required: ["packageName"],
+	properties: {
+		packageName: {
+			type: "string",
+			description: "Fully qualified npm package name (e.g. @scope/name)."
+		},
+		version: {
+			type: "string",
+			description: "Exact version (registry providers) or omit to take latest."
+		},
+		provider: {
+			type: "string",
+			enum: [
+				"npm",
+				"github",
+				"local",
+				"registry"
+			],
+			description: "Where Connect should resolve the package from at runtime."
+		},
+		url: {
+			type: "string",
+			description: "Override URL for non-registry providers (e.g. github tarball)."
+		}
+	}
+};
+const driveSectionSchema = {
+	type: "object",
+	additionalProperties: false,
+	description: "Visibility and add/delete affordances for a drive section in the sidebar.",
+	properties: {
+		enabled: {
+			type: "boolean",
+			description: "When false, the section is hidden in the sidebar.",
+			default: true
+		},
+		allowAdd: {
+			type: "boolean",
+			description: "When false, the section's 'add drive' affordance is hidden.",
+			default: true
+		},
+		allowDelete: {
+			type: "boolean",
+			description: "When false, drives in this section cannot be deleted from the UI.",
+			default: true
+		}
+	}
+};
+const phConnectRuntimeConfigSchema = {
+	type: "object",
+	additionalProperties: false,
+	description: "Connect-specific UI customisations. All fields optional; omit the section entirely for default behaviour.",
+	properties: {
+		branding: {
+			type: "object",
+			additionalProperties: false,
+			description: "App identity and visual branding.",
+			properties: {
+				appName: {
+					type: "string",
+					description: "Browser tab title and any in-app brand text. Defaults to 'Powerhouse Connect'."
+				},
+				homeBackground: {
+					type: ["string", "null"],
+					description: "Hero image on the empty home screen. URL or path to override; null or omitted uses the bundled default image."
+				}
+			}
+		},
+		app: {
+			type: "object",
+			additionalProperties: false,
+			description: "Top-level Connect application behaviour.",
+			properties: {
+				logLevel: {
+					type: "string",
+					enum: [
+						"debug",
+						"info",
+						"warn",
+						"error"
+					],
+					description: "Log level applied by Connect's logger at boot. Affects browser-side output only.",
+					default: "info"
+				},
+				basePath: {
+					type: "string",
+					description: "Base path Connect is mounted under (e.g. '/connect' for subpath deploys). Normalised at runtime to start and end with '/'. Defaults to the build-time BASE_URL.",
+					default: "/"
+				}
+			}
+		},
+		packages: {
+			type: "object",
+			additionalProperties: false,
+			description: "Runtime behaviour for the Connect package manager (separate from top-level `packages[]`, which lists which packages to load).",
+			properties: {
+				externalEnabled: {
+					type: "boolean",
+					description: "When false, Connect refuses to load any package that wasn't bundled at build time. Affirmative replacement for the legacy PH_CONNECT_EXTERNAL_PACKAGES_DISABLED env var.",
+					default: true
+				},
+				liveReload: {
+					type: "boolean",
+					description: "When true, Connect subscribes to the static-mode `/__packages` SSE channel so live publishes flow into the running tab without a page reload. Only works under hosting that serves this channel (e.g. ph-clint static mode).",
+					default: false
+				}
+			}
+		},
+		drives: {
+			type: "object",
+			additionalProperties: false,
+			description: "Default-drive and add-drive UI behaviour.",
+			properties: {
+				allowAddDrive: {
+					type: "boolean",
+					description: "When false, the SPA hides the 'add drive' affordance entirely (top-level). Per-section overrides live in `sections.{remote,local}.allowAdd`.",
+					default: true
+				},
+				defaultDrives: {
+					type: "array",
+					description: "Drives the SPA auto-connects to on first load. Each must specify a URL; name and icon are optional overrides.",
+					default: [],
+					items: {
+						type: "object",
+						additionalProperties: false,
+						required: ["url"],
+						properties: {
+							url: { type: "string" },
+							name: { type: ["string", "null"] },
+							icon: { type: ["string", "null"] }
+						}
+					}
+				},
+				preserveStrategy: {
+					type: "string",
+					enum: ["preserve-all", "preserve-by-url-and-detach"],
+					description: "Strategy applied when defaultDrives change between deploys. 'preserve-all' keeps user-added drives untouched; 'preserve-by-url-and-detach' detaches removed default drives. No schema default — opt-in only."
+				},
+				sections: {
+					type: "object",
+					additionalProperties: false,
+					description: "Per-section visibility and affordance toggles. `remote` covers what was historically split into 'public' + 'cloud'; `local` is browser-local drives.",
+					properties: {
+						remote: driveSectionSchema,
+						local: driveSectionSchema
+					}
+				}
+			}
+		},
+		renown: {
+			type: "object",
+			additionalProperties: false,
+			description: "Renown identity / authentication coordinates.",
+			properties: {
+				url: {
+					type: "string",
+					description: "Renown auth service URL.",
+					default: "https://www.renown.id"
+				},
+				networkId: {
+					type: "string",
+					description: "CAIP-2 network namespace (e.g. 'eip155').",
+					default: "eip155"
+				},
+				chainId: {
+					type: "number",
+					description: "CAIP-2 chain reference within the network namespace.",
+					default: 1
+				}
+			}
+		},
+		sentry: {
+			type: "object",
+			additionalProperties: false,
+			description: "Sentry error-tracking coordinates. Set `dsn` to enable Sentry; leave `dsn` null to disable. The Sentry release tag stays build-time (stamped via Vite's `define` from WORKSPACE_VERSION) so it always matches the sourcemaps uploaded by CI.",
+			properties: {
+				dsn: {
+					type: ["string", "null"],
+					description: "Sentry DSN URL. `null` disables Sentry entirely; the SPA never loads the Sentry SDK chunk.",
+					default: null
+				},
+				env: {
+					type: "string",
+					description: "Sentry environment label, surfaced as the `environment` tag on every event.",
+					default: "dev"
+				},
+				tracing: {
+					type: "boolean",
+					description: "Enable Sentry performance tracing.",
+					default: false
+				}
+			}
+		}
+	}
+};
 //#endregion
-export { connectEnvSchema, loadBuildEnv, loadConnectEnv, loadRuntimeEnv, normalizeBasePath, runtimeEnvSchema, setConnectEnv };
+export { ConfigLoader, DEFAULT_CONNECT_CONFIG, JsonConfigAdapter, ROOT_STORAGE_NAMESPACE, buildRuntimeConfig, connectEnvSchema, deepMerge, getStorageNamespace, loadConnectEnv, loadRuntimeEnv, normalizeBasePath, phConnectRuntimeConfigSchema, powerhousePackageSchema, runtimeEnvSchema, setConnectEnv };
 
 //# sourceMappingURL=index.js.map

package/dist/connect/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../connect/env-config.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Coerces string values to boolean.\n * Accepts: \"true\", \"false\", true, false\n */\nconst booleanString = z\n  .union([z.boolean(), z.enum([\"true\", \"false\"])])\n  .transform((val) => {\n    if (typeof val === \"boolean\") return val;\n    return val === \"true\";\n  });\n\n/**\n * Coerces string values to number.\n */\nconst numberString = z.union([z.number(), z.string()]).transform((val) => {\n  if (typeof val === \"number\") return val;\n  return parseInt(val, 10);\n});\n\n// ============================================================================\n// Build-time Environment Variables\n// ============================================================================\n\n/**\n * Build-time configuration schema\n */\nconst buildEnvSchema = z.object({\n  /**\n   * Path to powerhouse config file\n   * @default \"powerhouse.config.json\"\n   */\n  PH_CONFIG_PATH: z.string().optional(),\n\n  /**\n   * Comma-separated list of package names to load\n   * @example \"package1,package2\"\n   */\n  PH_PACKAGES: z.string().optional(),\n\n  /**\n   * Path to local package to load during development\n   */\n  PH_LOCAL_PACKAGE: z.string().optional(),\n\n  /**\n   * Disable loading of local package\n   * @default false\n   */\n  PH_DISABLE_LOCAL_PACKAGE: booleanString.default(false),\n\n  /**\n   * Amount of time to wait before a file is considered changed\n   * @default 300\n   */\n  PH_WATCH_TIMEOUT: numberString.default(300),\n\n  /**\n   * Sentry authentication token for uploading source maps\n   */\n  PH_SENTRY_AUTH_TOKEN: z.string().optional(),\n\n  /**\n   * Sentry organization slug\n   */\n  PH_SENTRY_ORG: z.string().optional(),\n\n  /**\n   * Sentry project slug\n   */\n  PH_SENTRY_PROJECT: z.string().optional(),\n});\n\n// ============================================================================\n// Application Configuration\n// ============================================================================\n\n/**\n * Application configuration schema\n */\nconst appConfigSchema = z.object({\n  /**\n   * Application version number\n   * @default \"unknown\"\n   */\n  PH_CONNECT_VERSION: z.string().default(\"unknown\"),\n\n  /**\n   * Log level for the application\n   * @default \"info\"\n   */\n  PH_CONNECT_LOG_LEVEL: z\n    .enum([\"debug\", \"info\", \"warn\", \"error\"])\n    .default(\"info\"),\n\n  /**\n   * Whether app requires hard refresh on updates\n   * @default true\n   */\n  PH_CONNECT_REQUIRES_HARD_REFRESH: booleanString.default(true),\n\n  /**\n   * Show warning when app version is outdated\n   * @default false\n   */\n  PH_CONNECT_WARN_OUTDATED_APP: booleanString.default(false),\n\n  /**\n   * Enable studio mode features\n   * @default false\n   */\n  PH_CONNECT_STUDIO_MODE: booleanString.default(false),\n\n  /**\n   * Base path for the Connect router, defaults to import.meta.env.BASE_URL\n   */\n  PH_CONNECT_BASE_PATH: z.string().optional(),\n\n  /**\n   * Default drives URL to load on startup\n   */\n  PH_CONNECT_DEFAULT_DRIVES_URL: z.string().optional(),\n  /*\n   * Names of packages to load in connect\n   */\n  PH_CONNECT_PACKAGES: z.string().optional(),\n  /**\n   * URL(s) of the packages registry CDN endpoint.\n   * Supports comma-separated URLs for multiple registries.\n   * @example \"http://localhost:8080/-/cdn/\"\n   * @example \"https://registry.powerhouse.io/-/cdn/,http://localhost:8080/-/cdn/\"\n   */\n  PH_CONNECT_PACKAGES_REGISTRY: z.string().optional(),\n\n  /**\n   * Strategy for preserving drives\n   */\n  PH_CONNECT_DRIVES_PRESERVE_STRATEGY: z.string().optional(),\n\n  /**\n   * Interval in milliseconds to check for version updates\n   * @default 3600000 (1 hour)\n   */\n  PH_CONNECT_VERSION_CHECK_INTERVAL: numberString.default(60 * 60 * 1000),\n\n  /**\n   * CLI version number\n   */\n  PH_CONNECT_CLI_VERSION: z.string().optional(),\n\n  /**\n   * Chunk size for file upload operations\n   * @default 50\n   */\n  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE: numberString.default(50),\n});\n\n// ============================================================================\n// Feature Flags & UI Configuration\n// ============================================================================\n\n/**\n * Feature flags and UI configuration schema\n */\nconst featureFlagsSchema = z.object({\n  /**\n   * Hide the \"Add Drive\" button completely\n   * @default false\n   */\n  PH_CONNECT_DISABLE_ADD_DRIVE: booleanString.default(false),\n\n  /**\n   * Show search bar in the UI\n   * @default false\n   */\n  PH_CONNECT_SEARCH_BAR_ENABLED: booleanString.default(false),\n\n  /**\n   * Hide document model selection in settings\n   * @default true\n   */\n  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS:\n    booleanString.default(true),\n\n  /**\n   * Comma-separated list of enabled editor types\n   * Use \"*\" to enable all editors\n   * @example \"editor1,editor2\" or \"*\"\n   */\n  PH_CONNECT_ENABLED_EDITORS: z.string().optional(),\n\n  /**\n   * Comma-separated list of disabled editor types\n   * @default \"powerhouse/document-drive\"\n   */\n  PH_CONNECT_DISABLED_EDITORS: z.string().default(\"powerhouse/document-drive\"),\n\n  /**\n   * Google Analytics tracking ID\n   */\n  PH_CONNECT_GA_TRACKING_ID: z.string().optional(),\n\n  /**\n   * Disable loading of external packages\n   * @default false\n   */\n  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED: booleanString.default(false),\n});\n\n// ============================================================================\n// Drives Configuration\n// ============================================================================\n\n/**\n * Drives configuration schema\n */\nconst drivesConfigSchema = z.object({\n  /**\n   * Enable public drives section\n   * @default true\n   */\n  PH_CONNECT_PUBLIC_DRIVES_ENABLED: booleanString.default(true),\n\n  /**\n   * Allow adding public drives\n   * @default true\n   */\n  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES: booleanString.default(false),\n\n  /**\n   * Allow deleting public drives\n   * @default true\n   */\n  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES: booleanString.default(false),\n\n  /**\n   * Enable cloud drives section\n   * @default true\n   */\n  PH_CONNECT_CLOUD_DRIVES_ENABLED: booleanString.default(true),\n\n  /**\n   * Allow adding cloud drives\n   * @default true\n   */\n  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES: booleanString.default(false),\n\n  /**\n   * Allow deleting cloud drives\n   * @default true\n   */\n  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES: booleanString.default(false),\n\n  /**\n   * Enable local drives section\n   * @default true\n   */\n  PH_CONNECT_LOCAL_DRIVES_ENABLED: booleanString.default(true),\n\n  /**\n   * Allow adding local drives\n   * @default true\n   */\n  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES: booleanString.default(false),\n\n  /**\n   * Allow deleting local drives\n   * @default true\n   */\n  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES: booleanString.default(false),\n});\n\n// ============================================================================\n// Analytics Processor Configuration\n// ============================================================================\n\n/**\n * Analytics processor configuration schema\n */\nconst analyticsProcessorsConfigSchema = z.object({\n  /**\n   * Enable analytics\n   * @default true\n   */\n  PH_CONNECT_ANALYTICS_ENABLED: booleanString.default(true),\n\n  /**\n   * Name of the analytics database\n   * Defaults to basename + \":analytics\"\n   */\n  PH_CONNECT_ANALYTICS_DATABASE_NAME: z.string().optional(),\n\n  /**\n   * Disable analytics database worker\n   * @default false\n   */\n  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED: booleanString.default(true),\n\n  /**\n   * Enable diff analytics tracking\n   * @default false\n   */\n  PH_CONNECT_DIFF_ANALYTICS_ENABLED: booleanString.default(false),\n\n  /**\n   * Enable drive analytics tracking\n   * @default true\n   */\n  PH_CONNECT_DRIVE_ANALYTICS_ENABLED: booleanString.default(true),\n\n  /**\n   * Enable external analytics processors\n   * @default true\n   */\n  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: booleanString.default(true),\n});\n\n/**\n * Relational DB processor configuration schema\n */\nconst relationalProcessorsConfigSchema = z.object({\n  /**\n   * Enable relational processors\n   * @default true\n   */\n  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED: booleanString.default(true),\n\n  /**\n   * Enable external relational processors\n   * @default true\n   */\n  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED:\n    booleanString.default(true),\n});\n\n/**\n * External processors configuration schema\n */\nconst processorsBaseConfigSchema = z.object({\n  /**\n   * Enable processors\n   * @default true\n   */\n  PH_CONNECT_PROCESSORS_ENABLED: booleanString.default(true),\n\n  /**\n   * Enable external processors\n   * @default true\n   */\n  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: booleanString.default(true),\n});\n\nconst processorsConfigSchema = processorsBaseConfigSchema\n  .extend(analyticsProcessorsConfigSchema.shape)\n  .extend(relationalProcessorsConfigSchema.shape);\n\n// ============================================================================\n// OpenPanel Configuration\n// ============================================================================\n\n/**\n * OpenPanel analytics configuration schema\n */\nconst openPanelConfigSchema = z.object({\n  /**\n   * OpenPanel client ID. When unset, the OpenPanel subsystem is a no-op.\n   */\n  PH_CONNECT_OPENPANEL_CLIENT_ID: z.string().optional(),\n\n  /**\n   * OpenPanel API URL override. Defaults to the OpenPanel cloud when unset.\n   */\n  PH_CONNECT_OPENPANEL_API_URL: z.string().optional(),\n\n  /**\n   * Track UI events via the useOpenPanel() hook\n   * @default true\n   */\n  PH_CONNECT_OPENPANEL_TRACK_UI_EVENTS: booleanString.default(true),\n\n  /**\n   * Track document operations via the OpenPanel processor\n   * @default true\n   */\n  PH_CONNECT_OPENPANEL_TRACK_OPERATIONS: booleanString.default(true),\n});\n\n// ============================================================================\n// Sentry Configuration\n// ============================================================================\n\n/**\n * Sentry error tracking configuration schema\n */\nconst sentryConfigSchema = z.object({\n  /**\n   * Sentry release identifier\n   * Defaults to app version\n   */\n  PH_CONNECT_SENTRY_RELEASE: z.string().optional(),\n\n  /**\n   * Sentry DSN for error reporting\n   */\n  PH_CONNECT_SENTRY_DSN: z.string().optional(),\n\n  /**\n   * Sentry environment name\n   * @default \"prod\"\n   */\n  PH_CONNECT_SENTRY_ENV: z.string().default(\"dev\"),\n\n  /**\n   * Enable Sentry performance tracing\n   * @default false\n   */\n  PH_CONNECT_SENTRY_TRACING_ENABLED: booleanString.default(false),\n});\n\n// ============================================================================\n// Renown Configuration\n// ============================================================================\n\n/**\n * Renown authentication configuration schema\n */\nconst renownConfigSchema = z.object({\n  /**\n   * Renown authentication service URL\n   * @default \"https://www.renown.id\"\n   */\n  PH_CONNECT_RENOWN_URL: z.string().default(\"https://www.renown.id\"),\n\n  /**\n   * Renown network ID\n   * @default \"eip155\"\n   */\n  PH_CONNECT_RENOWN_NETWORK_ID: z.string().default(\"eip155\"),\n\n  /**\n   * Renown chain ID\n   * @default 1\n   */\n  PH_CONNECT_RENOWN_CHAIN_ID: numberString.default(1),\n});\n\n// ============================================================================\n// Combined Schemas\n// ============================================================================\n\n/**\n * Complete runtime environment schema (all PH_CONNECT_* vars)\n */\nexport const runtimeEnvSchema = appConfigSchema\n  .extend(featureFlagsSchema.shape)\n  .extend(drivesConfigSchema.shape)\n  .extend(processorsConfigSchema.shape)\n  .extend(openPanelConfigSchema.shape)\n  .extend(sentryConfigSchema.shape)\n  .extend(renownConfigSchema.shape);\n\n/**\n * Complete environment schema (build + runtime)\n */\nexport const connectEnvSchema = buildEnvSchema.extend(runtimeEnvSchema.shape);\n\n/**\n * Inferred TypeScript types from schemas\n */\nexport type ConnectBuildEnv = z.infer<typeof buildEnvSchema>;\nexport type ConnectRuntimeEnv = z.infer<typeof runtimeEnvSchema>;\nexport type ConnectEnv = z.infer<typeof connectEnvSchema>;\n\n// ============================================================================\n// Environment Loading Functions\n// ============================================================================\n\n/**\n * Options for loading environment variables\n */\nexport interface LoadEnvOptions {\n  /**\n   * Environment variables from process.env (highest priority)\n   */\n  processEnv?: Record<string, string | undefined>;\n  /**\n   * Environment variables from .env file (lowest priority)\n   */\n  fileEnv?: Record<string, string | undefined>;\n}\n\n/**\n * Internal helper to merge environment sources with priority.\n * Validates each value and falls back to next priority if invalid.\n */\nfunction mergeEnvSources(\n  options: LoadEnvOptions,\n  keys: Set<string>,\n  schema: z.ZodObject<Record<string, z.ZodTypeAny>>,\n): Record<string, unknown> {\n  const { processEnv = {}, fileEnv = {} } = options;\n  const merged: Record<string, unknown> = {};\n\n  // Apply priority: fileEnv < optionsEnv < processEnv\n  for (const key of keys) {\n    const sources = [\n      { name: \"process.env\", value: processEnv[key] },\n      { name: \"fileEnv\", value: fileEnv[key] },\n    ];\n\n    // Try each source in priority order\n    for (const source of sources) {\n      const value = source.value;\n      if (value === undefined || value === \"\") continue;\n\n      // Try to validate just this field\n      try {\n        const fieldSchema = schema.shape[key];\n        if (fieldSchema) {\n          fieldSchema.parse(value);\n          merged[key] = value;\n          break; // Successfully validated, use this value\n        }\n        // No schema for this key, accept it\n        console.warn(`Unknown environment variable: '${key}'`);\n        merged[key] = value;\n        break;\n      } catch {\n        // Validation failed, log warning and try next source\n        const valueStr =\n          value === null\n            ? \"null\"\n            : typeof value === \"object\"\n              ? JSON.stringify(value)\n              : (value as string);\n        console.warn(\n          `Invalid value for ${key} from ${source.name}: ${valueStr}. Trying next source.`,\n        );\n      }\n    }\n  }\n\n  return merged;\n}\n\n/**\n * Loads and validates environment variables with priority:\n * 1. process.env (highest)\n * 2. options\n * 3. fileEnv\n * 4. defaults from schema (lowest)\n *\n * @param options - Environment sources in priority order\n * @returns Validated and typed environment configuration\n */\nexport function loadConnectEnv(options: LoadEnvOptions = {}): ConnectEnv {\n  const allKeys = new Set([\n    ...Object.keys(buildEnvSchema.shape),\n    ...Object.keys(runtimeEnvSchema.shape),\n  ]);\n\n  const merged = mergeEnvSources(options, allKeys, connectEnvSchema);\n  return connectEnvSchema.parse(merged);\n}\n\n/**\n * Loads only runtime environment variables\n *\n * @param options - Environment sources in priority order\n * @returns Validated runtime environment configuration\n */\nexport function loadRuntimeEnv(\n  options: LoadEnvOptions = {},\n): ConnectRuntimeEnv {\n  const allKeys = new Set(Object.keys(runtimeEnvSchema.shape));\n  const merged = mergeEnvSources(options, allKeys, runtimeEnvSchema);\n  return runtimeEnvSchema.parse(merged);\n}\n\n/**\n * Loads only build-time environment variables\n *\n * @param options - Environment sources in priority order\n * @returns Validated build environment configuration\n */\nexport function loadBuildEnv(options: LoadEnvOptions = {}): ConnectBuildEnv {\n  const allKeys = new Set(Object.keys(buildEnvSchema.shape));\n  const merged = mergeEnvSources(options, allKeys, buildEnvSchema);\n  return buildEnvSchema.parse(merged);\n}\n\n/**\n * Safely sets Connect environment variables with validation.\n * Invalid values will log a warning and be skipped.\n *\n * @param values - Type-safe object with key-value pairs to set\n *\n * @example\n * ```ts\n * setConnectEnv({\n *   PH_CONNECT_LOG_LEVEL: \"debug\",\n *   PH_CONNECT_VERSION: \"1.2.3\",\n *   PH_CONNECT_STUDIO_MODE: true,\n * });\n * ```\n */\nexport function setConnectEnv(values: Partial<ConnectEnv>): void {\n  for (const [key, value] of Object.entries(values)) {\n    // Check if key exists in schema\n    const fieldSchema =\n      connectEnvSchema.shape[key as keyof typeof connectEnvSchema.shape];\n\n    if (!fieldSchema) {\n      console.warn(\n        `Unknown environment variable: ${key}. Variable not set. Valid keys: ${Object.keys(connectEnvSchema.shape).join(\", \")}`,\n      );\n      continue;\n    }\n\n    try {\n      // Validate the value\n      fieldSchema.parse(value);\n\n      // Set the value (convert to string for process.env compatibility)\n      process.env[key] = String(value);\n    } catch (error) {\n      console.warn(\n        `Invalid value for ${key}: ${String(value)}. Validation failed.`,\n        error,\n      );\n    }\n  }\n}\n\n/**\n * Normalizes a base path to ensure it:\n * - Starts with a forward slash (/)\n * - Ends with a forward slash (/)\n * - Has no relative path prefix (.)\n *\n * @param basePath - The base path to normalize\n * @returns The normalized base path\n *\n * @example\n * normalizeBasePath('/app') // '/app/'\n * normalizeBasePath('./app/') // '/app/'\n * normalizeBasePath('app') // '/app/'\n * normalizeBasePath('/') // '/'\n * normalizeBasePath('') // '/'\n */\nexport function normalizeBasePath(basePath: string): string {\n  if (!basePath) {\n    return \"/\";\n  }\n\n  let normalized = basePath;\n\n  // Remove relative path prefix\n  if (normalized.startsWith(\".\")) {\n    normalized = normalized.slice(1);\n  }\n\n  // Ensure it starts with a forward slash\n  if (!normalized.startsWith(\"/\")) {\n    normalized = `/${normalized}`;\n  }\n\n  // Ensure it ends with a forward slash\n  if (!normalized.endsWith(\"/\")) {\n    normalized = `${normalized}/`;\n  }\n\n  return normalized;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../connect/env-config.ts","../../connect/schema-fragments.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Coerces string values to boolean.\n * Accepts: \"true\", \"false\", true, false\n */\nconst booleanString = z\n  .union([z.boolean(), z.enum([\"true\", \"false\"])])\n  .transform((val) => {\n    if (typeof val === \"boolean\") return val;\n    return val === \"true\";\n  });\n\n// ============================================================================\n// Build-time Environment Variables\n// ============================================================================\n\n/**\n * Build-time configuration schema\n */\nconst buildEnvSchema = z.object({\n  /**\n   * Comma-separated list of package names to load\n   * @example \"package1,package2\"\n   */\n  PH_PACKAGES: z.string().optional(),\n\n  /**\n   * Path to local package to load during development\n   */\n  PH_LOCAL_PACKAGE: z.string().optional(),\n\n  /**\n   * Sentry authentication token for uploading source maps\n   */\n  PH_SENTRY_AUTH_TOKEN: z.string().optional(),\n\n  /**\n   * Sentry organization slug\n   */\n  PH_SENTRY_ORG: z.string().optional(),\n\n  /**\n   * Sentry project slug\n   */\n  PH_SENTRY_PROJECT: z.string().optional(),\n});\n\n// ============================================================================\n// Application Configuration (build metadata only)\n// ============================================================================\n\n/**\n * Connect runtime values (anything in `PHConnectRuntimeConfig`) are NOT\n * settable from env vars. They live in `powerhouse.config.json` and are\n * overridden via `ph connect build --<field>` or `ph connect config\n * --<field>`.\n *\n * What stays env-driven below is non-runtime: build metadata, Sentry\n * credentials, analytics processor toggles, etc.\n */\nconst appConfigSchema = z.object({\n  /**\n   * Application version number (build metadata stamp)\n   * @default \"unknown\"\n   */\n  PH_CONNECT_VERSION: z.string().default(\"unknown\"),\n\n  /**\n   * CLI version number (build metadata stamp)\n   */\n  PH_CONNECT_CLI_VERSION: z.string().optional(),\n});\n\n// ============================================================================\n// Analytics Processor Configuration\n// ============================================================================\n\n/**\n * Analytics processor configuration schema. These are non-runtime feature\n * toggles for the analytics subsystem — they don't live in the runtime\n * schema and stay env-driven.\n */\nconst processorsConfigSchema = z.object({\n  /**\n   * Enable diff analytics tracking\n   * @default false\n   */\n  PH_CONNECT_DIFF_ANALYTICS_ENABLED: booleanString.default(false),\n\n  /**\n   * Enable drive analytics tracking\n   * @default true\n   */\n  PH_CONNECT_DRIVE_ANALYTICS_ENABLED: booleanString.default(true),\n\n  /**\n   * Enable external analytics processors\n   * @default true\n   */\n  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: booleanString.default(true),\n});\n\n// ============================================================================\n// OpenPanel Configuration\n// ============================================================================\n\n/**\n * OpenPanel analytics configuration schema\n */\nconst openPanelConfigSchema = z.object({\n  /**\n   * OpenPanel client ID. When unset, the OpenPanel subsystem is a no-op.\n   */\n  PH_CONNECT_OPENPANEL_CLIENT_ID: z.string().optional(),\n\n  /**\n   * OpenPanel API URL override. Defaults to the OpenPanel cloud when unset.\n   */\n  PH_CONNECT_OPENPANEL_API_URL: z.string().optional(),\n\n  /**\n   * Track UI events via the useOpenPanel() hook\n   * @default true\n   */\n  PH_CONNECT_OPENPANEL_TRACK_UI_EVENTS: booleanString.default(true),\n\n  /**\n   * Track document operations via the OpenPanel processor\n   * @default true\n   */\n  PH_CONNECT_OPENPANEL_TRACK_OPERATIONS: booleanString.default(true),\n});\n\n// ============================================================================\n// Combined Schemas\n// ============================================================================\n\n/**\n * Complete runtime environment schema (all PH_CONNECT_* vars). Only\n * build-metadata + analytics-processor toggles live here; all Connect\n * runtime config lives in `powerhouse.config.json`.\n */\nexport const runtimeEnvSchema = appConfigSchema\n  .extend(processorsConfigSchema.shape)\n  .extend(openPanelConfigSchema.shape);\n\n/**\n * Complete environment schema (build + runtime)\n */\nexport const connectEnvSchema = buildEnvSchema.extend(runtimeEnvSchema.shape);\n\n/**\n * Inferred TypeScript types from schemas\n */\nexport type ConnectBuildEnv = z.infer<typeof buildEnvSchema>;\nexport type ConnectRuntimeEnv = z.infer<typeof runtimeEnvSchema>;\nexport type ConnectEnv = z.infer<typeof connectEnvSchema>;\n\n// ============================================================================\n// Environment Loading Functions\n// ============================================================================\n\n/**\n * Options for loading environment variables\n */\nexport interface LoadEnvOptions {\n  /**\n   * Environment variables from process.env (highest priority)\n   */\n  processEnv?: Record<string, string | undefined>;\n  /**\n   * Environment variables from .env file (lowest priority)\n   */\n  fileEnv?: Record<string, string | undefined>;\n}\n\n/**\n * Internal helper to merge environment sources with priority.\n * Validates each value and falls back to next priority if invalid.\n */\nfunction mergeEnvSources(\n  options: LoadEnvOptions,\n  keys: Set<string>,\n  schema: z.ZodObject<Record<string, z.ZodTypeAny>>,\n): Record<string, unknown> {\n  const { processEnv = {}, fileEnv = {} } = options;\n  const merged: Record<string, unknown> = {};\n\n  // Apply priority: fileEnv < processEnv\n  for (const key of keys) {\n    const sources = [\n      { name: \"process.env\", value: processEnv[key] },\n      { name: \"fileEnv\", value: fileEnv[key] },\n    ];\n\n    // Try each source in priority order\n    for (const source of sources) {\n      const value = source.value;\n      if (value === undefined || value === \"\") continue;\n\n      // Try to validate just this field\n      try {\n        const fieldSchema = schema.shape[key];\n        if (fieldSchema) {\n          fieldSchema.parse(value);\n          merged[key] = value;\n          break; // Successfully validated, use this value\n        }\n        // No schema for this key, accept it\n        console.warn(`Unknown environment variable: '${key}'`);\n        merged[key] = value;\n        break;\n      } catch {\n        // Validation failed, log warning and try next source\n        const valueStr =\n          value === null\n            ? \"null\"\n            : typeof value === \"object\"\n              ? JSON.stringify(value)\n              : (value as string);\n        console.warn(\n          `Invalid value for ${key} from ${source.name}: ${valueStr}. Trying next source.`,\n        );\n      }\n    }\n  }\n\n  return merged;\n}\n\n/**\n * Loads and validates environment variables with priority:\n * 1. process.env (highest)\n * 2. fileEnv\n * 3. defaults from schema (lowest)\n *\n * @param options - Environment sources in priority order\n * @returns Validated and typed environment configuration\n */\nexport function loadConnectEnv(options: LoadEnvOptions = {}): ConnectEnv {\n  const allKeys = new Set([\n    ...Object.keys(buildEnvSchema.shape),\n    ...Object.keys(runtimeEnvSchema.shape),\n  ]);\n\n  const merged = mergeEnvSources(options, allKeys, connectEnvSchema);\n  return connectEnvSchema.parse(merged);\n}\n\n/**\n * Loads only runtime environment variables (build metadata + Sentry +\n * analytics-processor toggles — everything in the Connect runtime schema\n * is sourced from powerhouse.config.json, not env).\n *\n * @param options - Environment sources in priority order\n * @returns Validated runtime environment configuration\n */\nexport function loadRuntimeEnv(\n  options: LoadEnvOptions = {},\n): ConnectRuntimeEnv {\n  const allKeys = new Set(Object.keys(runtimeEnvSchema.shape));\n  const merged = mergeEnvSources(options, allKeys, runtimeEnvSchema);\n  return runtimeEnvSchema.parse(merged);\n}\n\n/**\n * Safely sets Connect environment variables with validation.\n * Invalid values will log a warning and be skipped.\n *\n * @param values - Type-safe object with key-value pairs to set\n *\n * @example\n * ```ts\n * setConnectEnv({\n *   PH_CONNECT_VERSION: \"1.2.3\",\n *   PH_CONNECT_SENTRY_DSN: \"https://…\",\n * });\n * ```\n */\nexport function setConnectEnv(values: Partial<ConnectEnv>): void {\n  for (const [key, value] of Object.entries(values)) {\n    // Check if key exists in schema\n    const fieldSchema =\n      connectEnvSchema.shape[key as keyof typeof connectEnvSchema.shape];\n\n    if (!fieldSchema) {\n      console.warn(\n        `Unknown environment variable: ${key}. Variable not set. Valid keys: ${Object.keys(connectEnvSchema.shape).join(\", \")}`,\n      );\n      continue;\n    }\n\n    try {\n      // Validate the value\n      fieldSchema.parse(value);\n\n      // Set the value (convert to string for process.env compatibility)\n      process.env[key] = String(value);\n    } catch (error) {\n      console.warn(\n        `Invalid value for ${key}: ${String(value)}. Validation failed.`,\n        error,\n      );\n    }\n  }\n}\n\n/**\n * Normalizes a base path to ensure it:\n * - Starts with a forward slash (/)\n * - Ends with a forward slash (/)\n * - Has no relative path prefix (.)\n *\n * @param basePath - The base path to normalize\n * @returns The normalized base path\n *\n * @example\n * normalizeBasePath('/app') // '/app/'\n * normalizeBasePath('./app/') // '/app/'\n * normalizeBasePath('app') // '/app/'\n * normalizeBasePath('/') // '/'\n * normalizeBasePath('') // '/'\n */\nexport function normalizeBasePath(basePath: string): string {\n  if (!basePath) {\n    return \"/\";\n  }\n\n  let normalized = basePath;\n\n  // Remove relative path prefix\n  if (normalized.startsWith(\".\")) {\n    normalized = normalized.slice(1);\n  }\n\n  // Ensure it starts with a forward slash\n  if (!normalized.startsWith(\"/\")) {\n    normalized = `/${normalized}`;\n  }\n\n  // Ensure it ends with a forward slash\n  if (!normalized.endsWith(\"/\")) {\n    normalized = `${normalized}/`;\n  }\n\n  return normalized;\n}\n\n/**\n * Base storage namespace for a Connect instance served at the root of an\n * origin. Kept as a literal so root deployments resolve to a byte-identical\n * value with no migration.\n */\nexport const ROOT_STORAGE_NAMESPACE = \"reactor\";\n\n/**\n * Derives the origin-scoped storage namespace from a Connect base path.\n *\n * Connect instances served under different path prefixes of the same origin\n * (e.g. behind a reverse proxy) otherwise share all origin-scoped browser\n * storage (PGlite data dirs, IndexedDB). This produces a deterministic,\n * collision-free namespace per distinct prefix that is valid as an\n * IndexedDB database name.\n *\n * - root base path (\"/\" or unset) -> \"reactor\" (byte-identical to the legacy\n *   key, so existing root deployments keep their data with zero migration)\n * - any non-root base path -> \"reactor--<slug>\", e.g.\n *   \"/reactor-project/vetra-studio/\" -> \"reactor--reactor-project-vetra-studio\"\n *\n * @param basePath - The Connect base path (env.PH_CONNECT_BASE_PATH ||\n *   import.meta.env.BASE_URL); normalized internally.\n * @returns The storage namespace.\n *\n * @example\n * getStorageNamespace('/') // 'reactor'\n * getStorageNamespace('/reactor-project/vetra-studio/') // 'reactor--reactor-project-vetra-studio'\n */\nexport function getStorageNamespace(basePath: string): string {\n  const normalized = normalizeBasePath(basePath);\n  if (normalized === \"/\") {\n    return ROOT_STORAGE_NAMESPACE;\n  }\n  const slug = normalized\n    .slice(1, -1)\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  // A non-root base path whose slug normalizes to nothing (e.g. \"/-/\") must\n  // not collapse into the root namespace and share its storage.\n  return `${ROOT_STORAGE_NAMESPACE}--${slug || \"default\"}`;\n}\n","// Single source of truth for JSON Schema shapes shared between the source\n// PowerhouseConfig schema (packages/shared/clis/source-config-schema.ts) and\n// the runtime RuntimePowerhouseConfig schema\n// (packages/builder-tools/connect-utils/runtime-config-schema.ts).\n//\n// When a shared shape changes, edit it here — both schemas pick it up.\n\nexport const powerhousePackageSchema = {\n  type: \"object\",\n  additionalProperties: false,\n  required: [\"packageName\"],\n  properties: {\n    packageName: {\n      type: \"string\",\n      description: \"Fully qualified npm package name (e.g. @scope/name).\",\n    },\n    version: {\n      type: \"string\",\n      description: \"Exact version (registry providers) or omit to take latest.\",\n    },\n    provider: {\n      type: \"string\",\n      enum: [\"npm\", \"github\", \"local\", \"registry\"],\n      description: \"Where Connect should resolve the package from at runtime.\",\n    },\n    url: {\n      type: \"string\",\n      description:\n        \"Override URL for non-registry providers (e.g. github tarball).\",\n    },\n  },\n} as const;\n\n// Reusable shape for `connect.drives.sections.{remote,local}` — three\n// affirmative-named toggles per section. The legacy public+cloud sections\n// have been collapsed into a single `remote`.\nconst driveSectionSchema = {\n  type: \"object\",\n  additionalProperties: false,\n  description:\n    \"Visibility and add/delete affordances for a drive section in the sidebar.\",\n  properties: {\n    enabled: {\n      type: \"boolean\",\n      description: \"When false, the section is hidden in the sidebar.\",\n      default: true,\n    },\n    allowAdd: {\n      type: \"boolean\",\n      description:\n        \"When false, the section's 'add drive' affordance is hidden.\",\n      default: true,\n    },\n    allowDelete: {\n      type: \"boolean\",\n      description:\n        \"When false, drives in this section cannot be deleted from the UI.\",\n      default: true,\n    },\n  },\n} as const;\n\nexport const phConnectRuntimeConfigSchema = {\n  type: \"object\",\n  additionalProperties: false,\n  description:\n    \"Connect-specific UI customisations. All fields optional; omit the section entirely for default behaviour.\",\n  properties: {\n    branding: {\n      type: \"object\",\n      additionalProperties: false,\n      description: \"App identity and visual branding.\",\n      properties: {\n        appName: {\n          type: \"string\",\n          description:\n            \"Browser tab title and any in-app brand text. Defaults to 'Powerhouse Connect'.\",\n        },\n        homeBackground: {\n          type: [\"string\", \"null\"],\n          description:\n            \"Hero image on the empty home screen. URL or path to override; null or omitted uses the bundled default image.\",\n        },\n      },\n    },\n    app: {\n      type: \"object\",\n      additionalProperties: false,\n      description: \"Top-level Connect application behaviour.\",\n      properties: {\n        logLevel: {\n          type: \"string\",\n          enum: [\"debug\", \"info\", \"warn\", \"error\"],\n          description:\n            \"Log level applied by Connect's logger at boot. Affects browser-side output only.\",\n          default: \"info\",\n        },\n        basePath: {\n          type: \"string\",\n          description:\n            \"Base path Connect is mounted under (e.g. '/connect' for subpath deploys). Normalised at runtime to start and end with '/'. Defaults to the build-time BASE_URL.\",\n          default: \"/\",\n        },\n      },\n    },\n    packages: {\n      type: \"object\",\n      additionalProperties: false,\n      description:\n        \"Runtime behaviour for the Connect package manager (separate from top-level `packages[]`, which lists which packages to load).\",\n      properties: {\n        externalEnabled: {\n          type: \"boolean\",\n          description:\n            \"When false, Connect refuses to load any package that wasn't bundled at build time. Affirmative replacement for the legacy PH_CONNECT_EXTERNAL_PACKAGES_DISABLED env var.\",\n          default: true,\n        },\n        liveReload: {\n          type: \"boolean\",\n          description:\n            \"When true, Connect subscribes to the static-mode `/__packages` SSE channel so live publishes flow into the running tab without a page reload. Only works under hosting that serves this channel (e.g. ph-clint static mode).\",\n          default: false,\n        },\n      },\n    },\n    drives: {\n      type: \"object\",\n      additionalProperties: false,\n      description: \"Default-drive and add-drive UI behaviour.\",\n      properties: {\n        allowAddDrive: {\n          type: \"boolean\",\n          description:\n            \"When false, the SPA hides the 'add drive' affordance entirely (top-level). Per-section overrides live in `sections.{remote,local}.allowAdd`.\",\n          default: true,\n        },\n        defaultDrives: {\n          type: \"array\",\n          description:\n            \"Drives the SPA auto-connects to on first load. Each must specify a URL; name and icon are optional overrides.\",\n          default: [],\n          items: {\n            type: \"object\",\n            additionalProperties: false,\n            required: [\"url\"],\n            properties: {\n              url: { type: \"string\" },\n              name: { type: [\"string\", \"null\"] },\n              icon: { type: [\"string\", \"null\"] },\n            },\n          },\n        },\n        preserveStrategy: {\n          type: \"string\",\n          enum: [\"preserve-all\", \"preserve-by-url-and-detach\"],\n          description:\n            \"Strategy applied when defaultDrives change between deploys. 'preserve-all' keeps user-added drives untouched; 'preserve-by-url-and-detach' detaches removed default drives. No schema default — opt-in only.\",\n        },\n        sections: {\n          type: \"object\",\n          additionalProperties: false,\n          description:\n            \"Per-section visibility and affordance toggles. `remote` covers what was historically split into 'public' + 'cloud'; `local` is browser-local drives.\",\n          properties: {\n            remote: driveSectionSchema,\n            local: driveSectionSchema,\n          },\n        },\n      },\n    },\n    renown: {\n      type: \"object\",\n      additionalProperties: false,\n      description: \"Renown identity / authentication coordinates.\",\n      properties: {\n        url: {\n          type: \"string\",\n          description: \"Renown auth service URL.\",\n          default: \"https://www.renown.id\",\n        },\n        networkId: {\n          type: \"string\",\n          description: \"CAIP-2 network namespace (e.g. 'eip155').\",\n          default: \"eip155\",\n        },\n        chainId: {\n          type: \"number\",\n          description: \"CAIP-2 chain reference within the network namespace.\",\n          default: 1,\n        },\n      },\n    },\n    sentry: {\n      type: \"object\",\n      additionalProperties: false,\n      description:\n        \"Sentry error-tracking coordinates. Set `dsn` to enable Sentry; leave `dsn` null to disable. The Sentry release tag stays build-time (stamped via Vite's `define` from WORKSPACE_VERSION) so it always matches the sourcemaps uploaded by CI.\",\n      properties: {\n        dsn: {\n          type: [\"string\", \"null\"],\n          description:\n            \"Sentry DSN URL. `null` disables Sentry entirely; the SPA never loads the Sentry SDK chunk.\",\n          default: null,\n        },\n        env: {\n          type: \"string\",\n          description:\n            \"Sentry environment label, surfaced as the `environment` tag on every event.\",\n          default: \"dev\",\n        },\n        tracing: {\n          type: \"boolean\",\n          description: \"Enable Sentry performance tracing.\",\n          default: false,\n        },\n      },\n    },\n  },\n} as const;\n"],"mappings":";;;;;;;;AAMA,MAAM,gBAAgB,EACnB,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,QAAQ,QAAQ,CAAC,CAAC,CAAC,CAC/C,WAAW,QAAQ;AAClB,KAAI,OAAO,QAAQ,UAAW,QAAO;AACrC,QAAO,QAAQ;EACf;;;;AASJ,MAAM,iBAAiB,EAAE,OAAO;CAK9B,aAAa,EAAE,QAAQ,CAAC,UAAU;CAKlC,kBAAkB,EAAE,QAAQ,CAAC,UAAU;CAKvC,sBAAsB,EAAE,QAAQ,CAAC,UAAU;CAK3C,eAAe,EAAE,QAAQ,CAAC,UAAU;CAKpC,mBAAmB,EAAE,QAAQ,CAAC,UAAU;CACzC,CAAC;;;;;;;;;;AAeF,MAAM,kBAAkB,EAAE,OAAO;CAK/B,oBAAoB,EAAE,QAAQ,CAAC,QAAQ,UAAU;CAKjD,wBAAwB,EAAE,QAAQ,CAAC,UAAU;CAC9C,CAAC;;;;;;AAWF,MAAM,yBAAyB,EAAE,OAAO;CAKtC,mCAAmC,cAAc,QAAQ,MAAM;CAM/D,oCAAoC,cAAc,QAAQ,KAAK;CAM/D,kDAAkD,cAAc,QAAQ,KAAK;CAC9E,CAAC;;;;AASF,MAAM,wBAAwB,EAAE,OAAO;CAIrC,gCAAgC,EAAE,QAAQ,CAAC,UAAU;CAKrD,8BAA8B,EAAE,QAAQ,CAAC,UAAU;CAMnD,sCAAsC,cAAc,QAAQ,KAAK;CAMjE,uCAAuC,cAAc,QAAQ,KAAK;CACnE,CAAC;;;;;;AAWF,MAAa,mBAAmB,gBAC7B,OAAO,uBAAuB,MAAM,CACpC,OAAO,sBAAsB,MAAM;;;;AAKtC,MAAa,mBAAmB,eAAe,OAAO,iBAAiB,MAAM;;;;;AA+B7E,SAAS,gBACP,SACA,MACA,QACyB;CACzB,MAAM,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,KAAK;CAC1C,MAAM,SAAkC,EAAE;AAG1C,MAAK,MAAM,OAAO,MAAM;EACtB,MAAM,UAAU,CACd;GAAE,MAAM;GAAe,OAAO,WAAW;GAAM,EAC/C;GAAE,MAAM;GAAW,OAAO,QAAQ;GAAM,CACzC;AAGD,OAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,QAAQ,OAAO;AACrB,OAAI,UAAU,KAAA,KAAa,UAAU,GAAI;AAGzC,OAAI;IACF,MAAM,cAAc,OAAO,MAAM;AACjC,QAAI,aAAa;AACf,iBAAY,MAAM,MAAM;AACxB,YAAO,OAAO;AACd;;AAGF,YAAQ,KAAK,kCAAkC,IAAI,GAAG;AACtD,WAAO,OAAO;AACd;WACM;IAEN,MAAM,WACJ,UAAU,OACN,SACA,OAAO,UAAU,WACf,KAAK,UAAU,MAAM,GACpB;AACT,YAAQ,KACN,qBAAqB,IAAI,QAAQ,OAAO,KAAK,IAAI,SAAS,uBAC3D;;;;AAKP,QAAO;;;;;;;;;;;AAYT,SAAgB,eAAe,UAA0B,EAAE,EAAc;CAMvE,MAAM,SAAS,gBAAgB,SALf,IAAI,IAAI,CACtB,GAAG,OAAO,KAAK,eAAe,MAAM,EACpC,GAAG,OAAO,KAAK,iBAAiB,MAAM,CACvC,CAAC,EAE+C,iBAAiB;AAClE,QAAO,iBAAiB,MAAM,OAAO;;;;;;;;;;AAWvC,SAAgB,eACd,UAA0B,EAAE,EACT;CAEnB,MAAM,SAAS,gBAAgB,SADf,IAAI,IAAI,OAAO,KAAK,iBAAiB,MAAM,CAAC,EACX,iBAAiB;AAClE,QAAO,iBAAiB,MAAM,OAAO;;;;;;;;;;;;;;;;AAiBvC,SAAgB,cAAc,QAAmC;AAC/D,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,EAAE;EAEjD,MAAM,cACJ,iBAAiB,MAAM;AAEzB,MAAI,CAAC,aAAa;AAChB,WAAQ,KACN,iCAAiC,IAAI,kCAAkC,OAAO,KAAK,iBAAiB,MAAM,CAAC,KAAK,KAAK,GACtH;AACD;;AAGF,MAAI;AAEF,eAAY,MAAM,MAAM;AAGxB,WAAQ,IAAI,OAAO,OAAO,MAAM;WACzB,OAAO;AACd,WAAQ,KACN,qBAAqB,IAAI,IAAI,OAAO,MAAM,CAAC,uBAC3C,MACD;;;;;;;;;;;;;;;;;;;;AAqBP,SAAgB,kBAAkB,UAA0B;AAC1D,KAAI,CAAC,SACH,QAAO;CAGT,IAAI,aAAa;AAGjB,KAAI,WAAW,WAAW,IAAI,CAC5B,cAAa,WAAW,MAAM,EAAE;AAIlC,KAAI,CAAC,WAAW,WAAW,IAAI,CAC7B,cAAa,IAAI;AAInB,KAAI,CAAC,WAAW,SAAS,IAAI,CAC3B,cAAa,GAAG,WAAW;AAG7B,QAAO;;;;;;;AAQT,MAAa,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;AAwBtC,SAAgB,oBAAoB,UAA0B;CAC5D,MAAM,aAAa,kBAAkB,SAAS;AAC9C,KAAI,eAAe,IACjB,QAAO;AAST,QAAO,GAAG,uBAAuB,IAPpB,WACV,MAAM,GAAG,GAAG,CACZ,aAAa,CACb,QAAQ,eAAe,IAAI,CAC3B,QAAQ,YAAY,GAAG,IAGmB;;;;AC/X/C,MAAa,0BAA0B;CACrC,MAAM;CACN,sBAAsB;CACtB,UAAU,CAAC,cAAc;CACzB,YAAY;EACV,aAAa;GACX,MAAM;GACN,aAAa;GACd;EACD,SAAS;GACP,MAAM;GACN,aAAa;GACd;EACD,UAAU;GACR,MAAM;GACN,MAAM;IAAC;IAAO;IAAU;IAAS;IAAW;GAC5C,aAAa;GACd;EACD,KAAK;GACH,MAAM;GACN,aACE;GACH;EACF;CACF;AAKD,MAAM,qBAAqB;CACzB,MAAM;CACN,sBAAsB;CACtB,aACE;CACF,YAAY;EACV,SAAS;GACP,MAAM;GACN,aAAa;GACb,SAAS;GACV;EACD,UAAU;GACR,MAAM;GACN,aACE;GACF,SAAS;GACV;EACD,aAAa;GACX,MAAM;GACN,aACE;GACF,SAAS;GACV;EACF;CACF;AAED,MAAa,+BAA+B;CAC1C,MAAM;CACN,sBAAsB;CACtB,aACE;CACF,YAAY;EACV,UAAU;GACR,MAAM;GACN,sBAAsB;GACtB,aAAa;GACb,YAAY;IACV,SAAS;KACP,MAAM;KACN,aACE;KACH;IACD,gBAAgB;KACd,MAAM,CAAC,UAAU,OAAO;KACxB,aACE;KACH;IACF;GACF;EACD,KAAK;GACH,MAAM;GACN,sBAAsB;GACtB,aAAa;GACb,YAAY;IACV,UAAU;KACR,MAAM;KACN,MAAM;MAAC;MAAS;MAAQ;MAAQ;MAAQ;KACxC,aACE;KACF,SAAS;KACV;IACD,UAAU;KACR,MAAM;KACN,aACE;KACF,SAAS;KACV;IACF;GACF;EACD,UAAU;GACR,MAAM;GACN,sBAAsB;GACtB,aACE;GACF,YAAY;IACV,iBAAiB;KACf,MAAM;KACN,aACE;KACF,SAAS;KACV;IACD,YAAY;KACV,MAAM;KACN,aACE;KACF,SAAS;KACV;IACF;GACF;EACD,QAAQ;GACN,MAAM;GACN,sBAAsB;GACtB,aAAa;GACb,YAAY;IACV,eAAe;KACb,MAAM;KACN,aACE;KACF,SAAS;KACV;IACD,eAAe;KACb,MAAM;KACN,aACE;KACF,SAAS,EAAE;KACX,OAAO;MACL,MAAM;MACN,sBAAsB;MACtB,UAAU,CAAC,MAAM;MACjB,YAAY;OACV,KAAK,EAAE,MAAM,UAAU;OACvB,MAAM,EAAE,MAAM,CAAC,UAAU,OAAO,EAAE;OAClC,MAAM,EAAE,MAAM,CAAC,UAAU,OAAO,EAAE;OACnC;MACF;KACF;IACD,kBAAkB;KAChB,MAAM;KACN,MAAM,CAAC,gBAAgB,6BAA6B;KACpD,aACE;KACH;IACD,UAAU;KACR,MAAM;KACN,sBAAsB;KACtB,aACE;KACF,YAAY;MACV,QAAQ;MACR,OAAO;MACR;KACF;IACF;GACF;EACD,QAAQ;GACN,MAAM;GACN,sBAAsB;GACtB,aAAa;GACb,YAAY;IACV,KAAK;KACH,MAAM;KACN,aAAa;KACb,SAAS;KACV;IACD,WAAW;KACT,MAAM;KACN,aAAa;KACb,SAAS;KACV;IACD,SAAS;KACP,MAAM;KACN,aAAa;KACb,SAAS;KACV;IACF;GACF;EACD,QAAQ;GACN,MAAM;GACN,sBAAsB;GACtB,aACE;GACF,YAAY;IACV,KAAK;KACH,MAAM,CAAC,UAAU,OAAO;KACxB,aACE;KACF,SAAS;KACV;IACD,KAAK;KACH,MAAM;KACN,aACE;KACF,SAAS;KACV;IACD,SAAS;KACP,MAAM;KACN,aAAa;KACb,SAAS;KACV;IACF;GACF;EACF;CACF"}

package/dist/connect/json-adapter.d.ts

@@ -0,0 +1,24 @@
+import { ConfigAdapter, ConfigShape } from "./config-loader.js";
+
+//#region connect/json-adapter.d.ts
+type JsonConfigAdapterOptions = {
+  /**
+   * URL or filesystem path to the JSON file.
+   *
+   * Defaults to "powerhouse.config.json" (relative). In the browser the
+   * relative URL resolves against the page's base URL; in Node it resolves
+   * against the process working directory. CLI callers should pass an
+   * absolute path discovered via project-root detection.
+   */
+  path?: string;
+};
+declare class JsonConfigAdapter implements ConfigAdapter {
+  readonly source: string;
+  private readonly path;
+  constructor(options?: JsonConfigAdapterOptions);
+  read(): Promise<unknown>;
+  write(next: ConfigShape): Promise<void>;
+}
+//#endregion
+export { JsonConfigAdapter, JsonConfigAdapterOptions };
+//# sourceMappingURL=json-adapter.d.ts.map

package/dist/connect/json-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-adapter.d.ts","names":[],"sources":["../../connect/json-adapter.ts"],"mappings":";;;KAgBY,wBAAA;;;;AAAZ;;;;;EASE,IAAA;AAAA;AAAA,cAGW,iBAAA,YAA6B,aAAA;EAAA,SAC/B,MAAA;EAAA,iBACQ,IAAA;cAEL,OAAA,GAAS,wBAAA;EAKf,IAAA,CAAA,GAAQ,OAAA;EAeR,KAAA,CAAM,IAAA,EAAM,WAAA,GAAc,OAAA;AAAA"}

package/dist/connect/json-adapter.js

@@ -0,0 +1,28 @@
+//#region connect/json-adapter.ts
+var JsonConfigAdapter = class {
+	source;
+	path;
+	constructor(options = {}) {
+		this.path = options.path ?? "powerhouse.config.json";
+		this.source = `json:${this.path}`;
+	}
+	async read() {
+		if (typeof window !== "undefined") {
+			const res = await fetch(this.path);
+			if (!res.ok) throw new Error(`JsonConfigAdapter: failed to fetch ${this.path}: ${res.status} ${res.statusText}`);
+			return await res.json();
+		}
+		const { readFile } = await import("node:fs/promises");
+		const raw = await readFile(this.path, "utf-8");
+		return JSON.parse(raw);
+	}
+	async write(next) {
+		const fs = await import("node:fs/promises").catch(() => null);
+		if (!fs) throw new Error("JsonConfigAdapter: writes require the Node filesystem (node:fs/promises is unavailable in this environment).");
+		await fs.writeFile(this.path, `${JSON.stringify(next, null, 2)}\n`, "utf-8");
+	}
+};
+//#endregion
+export { JsonConfigAdapter };
+
+//# sourceMappingURL=json-adapter.js.map

package/dist/connect/json-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-adapter.js","names":[],"sources":["../../connect/json-adapter.ts"],"sourcesContent":["// Single JSON-file adapter that works in both browser and Node.\n//\n// - read(): in the browser uses `fetch` (resolves the path against the page's\n//   base URL); in Node dynamically imports `node:fs/promises` and reads from\n//   disk. The dynamic import keeps `node:fs` out of the browser bundle's\n//   static import graph — bundlers see no top-level Node imports, so the\n//   adapter can be re-exported safely from the shared barrel.\n//\n// - write(): always writes to the local filesystem. Only the Node CLI ever\n//   calls write — the browser SPA cannot mutate a static file served from\n//   the deployed origin. If `write()` is called in the browser the dynamic\n//   import of `node:fs/promises` resolves to undefined and we throw with an\n//   actionable message.\n\nimport type { ConfigAdapter, ConfigShape } from \"./config-loader.js\";\n\nexport type JsonConfigAdapterOptions = {\n  /**\n   * URL or filesystem path to the JSON file.\n   *\n   * Defaults to \"powerhouse.config.json\" (relative). In the browser the\n   * relative URL resolves against the page's base URL; in Node it resolves\n   * against the process working directory. CLI callers should pass an\n   * absolute path discovered via project-root detection.\n   */\n  path?: string;\n};\n\nexport class JsonConfigAdapter implements ConfigAdapter {\n  readonly source: string;\n  private readonly path: string;\n\n  constructor(options: JsonConfigAdapterOptions = {}) {\n    this.path = options.path ?? \"powerhouse.config.json\";\n    this.source = `json:${this.path}`;\n  }\n\n  async read(): Promise<unknown> {\n    if (typeof window !== \"undefined\") {\n      const res = await fetch(this.path);\n      if (!res.ok) {\n        throw new Error(\n          `JsonConfigAdapter: failed to fetch ${this.path}: ${res.status} ${res.statusText}`,\n        );\n      }\n      return (await res.json()) as unknown;\n    }\n    const { readFile } = await import(\"node:fs/promises\");\n    const raw = await readFile(this.path, \"utf-8\");\n    return JSON.parse(raw) as unknown;\n  }\n\n  async write(next: ConfigShape): Promise<void> {\n    const fs = await import(\"node:fs/promises\").catch(() => null);\n    if (!fs) {\n      throw new Error(\n        \"JsonConfigAdapter: writes require the Node filesystem (node:fs/promises is unavailable in this environment).\",\n      );\n    }\n    await fs.writeFile(\n      this.path,\n      `${JSON.stringify(next, null, 2)}\\n`,\n      \"utf-8\",\n    );\n  }\n}\n"],"mappings":";AA4BA,IAAa,oBAAb,MAAwD;CACtD;CACA;CAEA,YAAY,UAAoC,EAAE,EAAE;AAClD,OAAK,OAAO,QAAQ,QAAQ;AAC5B,OAAK,SAAS,QAAQ,KAAK;;CAG7B,MAAM,OAAyB;AAC7B,MAAI,OAAO,WAAW,aAAa;GACjC,MAAM,MAAM,MAAM,MAAM,KAAK,KAAK;AAClC,OAAI,CAAC,IAAI,GACP,OAAM,IAAI,MACR,sCAAsC,KAAK,KAAK,IAAI,IAAI,OAAO,GAAG,IAAI,aACvE;AAEH,UAAQ,MAAM,IAAI,MAAM;;EAE1B,MAAM,EAAE,aAAa,MAAM,OAAO;EAClC,MAAM,MAAM,MAAM,SAAS,KAAK,MAAM,QAAQ;AAC9C,SAAO,KAAK,MAAM,IAAI;;CAGxB,MAAM,MAAM,MAAkC;EAC5C,MAAM,KAAK,MAAM,OAAO,oBAAoB,YAAY,KAAK;AAC7D,MAAI,CAAC,GACH,OAAM,IAAI,MACR,+GACD;AAEH,QAAM,GAAG,UACP,KAAK,MACL,GAAG,KAAK,UAAU,MAAM,MAAM,EAAE,CAAC,KACjC,QACD"}

package/dist/{constants-xNwF0jSl.d.ts → constants-C_EQX4DY.d.ts}

@@ -5,4 +5,4 @@ declare const APPS_DEPENDENCIES: string[];
 declare const ALL_POWERHOUSE_DEPENDENCIES: string[];
 //#endregion
 export { PACKAGES_DEPENDENCIES as i, APPS_DEPENDENCIES as n, CLIS_DEPENDENCIES as r, ALL_POWERHOUSE_DEPENDENCIES as t };
-//# sourceMappingURL=constants-xNwF0jSl.d.ts.map
+//# sourceMappingURL=constants-C_EQX4DY.d.ts.map

package/dist/constants-C_EQX4DY.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-C_EQX4DY.d.ts","names":[],"sources":["../constants.ts"],"mappings":";cAAa,qBAAA;AAAA,cA6BA,iBAAA;AAAA,cACA,iBAAA;AAAA,cAKA,2BAAA"}

package/dist/constants.d.ts

@@ -1,2 +1,2 @@
-import { i as PACKAGES_DEPENDENCIES, n as APPS_DEPENDENCIES, r as CLIS_DEPENDENCIES, t as ALL_POWERHOUSE_DEPENDENCIES } from "./constants-xNwF0jSl.js";
+import { i as PACKAGES_DEPENDENCIES, n as APPS_DEPENDENCIES, r as CLIS_DEPENDENCIES, t as ALL_POWERHOUSE_DEPENDENCIES } from "./constants-C_EQX4DY.js";
 export { ALL_POWERHOUSE_DEPENDENCIES, APPS_DEPENDENCIES, CLIS_DEPENDENCIES, PACKAGES_DEPENDENCIES };