@powerhousedao/shared 6.0.0-staging.3 → 6.0.0

package/dist/connect/index.d.ts

@@ -1,2 +1,378 @@
-export * from "./env-config.js";
+import { z } from "zod";
+
+//#region connect/env-config.d.ts
+/**
+ * Build-time configuration schema
+ */
+declare const buildEnvSchema: z.ZodObject<{
+  PH_CONFIG_PATH: z.ZodOptional<z.ZodString>;
+  PH_PACKAGES: z.ZodOptional<z.ZodString>;
+  PH_LOCAL_PACKAGE: z.ZodOptional<z.ZodString>;
+  PH_DISABLE_LOCAL_PACKAGE: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_WATCH_TIMEOUT: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+  PH_SENTRY_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
+  PH_SENTRY_ORG: z.ZodOptional<z.ZodString>;
+  PH_SENTRY_PROJECT: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Complete runtime environment schema (all PH_CONNECT_* vars)
+ */
+declare const runtimeEnvSchema: z.ZodObject<{
+  PH_CONNECT_VERSION: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+    debug: "debug";
+    info: "info";
+    warn: "warn";
+    error: "error";
+  }>>;
+  PH_CONNECT_REQUIRES_HARD_REFRESH: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_WARN_OUTDATED_APP: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_STUDIO_MODE: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_BASE_PATH: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_DEFAULT_DRIVES_URL: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_PACKAGES: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_PACKAGES_REGISTRY: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_DRIVES_PRESERVE_STRATEGY: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_VERSION_CHECK_INTERVAL: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+  PH_CONNECT_CLI_VERSION: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+  PH_CONNECT_DISABLE_ADD_DRIVE: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_SEARCH_BAR_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_ENABLED_EDITORS: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_DISABLED_EDITORS: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_GA_TRACKING_ID: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_PUBLIC_DRIVES_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_CLOUD_DRIVES_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_LOCAL_DRIVES_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_ANALYTICS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_ANALYTICS_DATABASE_NAME: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DIFF_ANALYTICS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DRIVE_ANALYTICS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_SENTRY_RELEASE: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_SENTRY_DSN: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_SENTRY_ENV: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_SENTRY_TRACING_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_RENOWN_URL: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_RENOWN_NETWORK_ID: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_RENOWN_CHAIN_ID: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+}, z.core.$strip>;
+/**
+ * Complete environment schema (build + runtime)
+ */
+declare const connectEnvSchema: z.ZodObject<{
+  PH_CONFIG_PATH: z.ZodOptional<z.ZodString>;
+  PH_PACKAGES: z.ZodOptional<z.ZodString>;
+  PH_LOCAL_PACKAGE: z.ZodOptional<z.ZodString>;
+  PH_DISABLE_LOCAL_PACKAGE: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_WATCH_TIMEOUT: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+  PH_SENTRY_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
+  PH_SENTRY_ORG: z.ZodOptional<z.ZodString>;
+  PH_SENTRY_PROJECT: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_VERSION: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+    debug: "debug";
+    info: "info";
+    warn: "warn";
+    error: "error";
+  }>>;
+  PH_CONNECT_REQUIRES_HARD_REFRESH: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_WARN_OUTDATED_APP: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_STUDIO_MODE: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_BASE_PATH: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_DEFAULT_DRIVES_URL: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_PACKAGES: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_PACKAGES_REGISTRY: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_DRIVES_PRESERVE_STRATEGY: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_VERSION_CHECK_INTERVAL: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+  PH_CONNECT_CLI_VERSION: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+  PH_CONNECT_DISABLE_ADD_DRIVE: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_SEARCH_BAR_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_ENABLED_EDITORS: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_DISABLED_EDITORS: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_GA_TRACKING_ID: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_PUBLIC_DRIVES_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_CLOUD_DRIVES_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_LOCAL_DRIVES_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_ANALYTICS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_ANALYTICS_DATABASE_NAME: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DIFF_ANALYTICS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_DRIVE_ANALYTICS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_SENTRY_RELEASE: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_SENTRY_DSN: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_SENTRY_ENV: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_SENTRY_TRACING_ENABLED: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+  PH_CONNECT_RENOWN_URL: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_RENOWN_NETWORK_ID: z.ZodDefault<z.ZodString>;
+  PH_CONNECT_RENOWN_CHAIN_ID: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>>;
+}, z.core.$strip>;
+/**
+ * Inferred TypeScript types from schemas
+ */
+type ConnectBuildEnv = z.infer<typeof buildEnvSchema>;
+type ConnectRuntimeEnv = z.infer<typeof runtimeEnvSchema>;
+type ConnectEnv = z.infer<typeof connectEnvSchema>;
+/**
+ * Options for loading environment variables
+ */
+interface LoadEnvOptions {
+  /**
+   * Environment variables from process.env (highest priority)
+   */
+  processEnv?: Record<string, string | undefined>;
+  /**
+   * Environment variables from .env file (lowest priority)
+   */
+  fileEnv?: Record<string, string | undefined>;
+}
+/**
+ * Loads and validates environment variables with priority:
+ * 1. process.env (highest)
+ * 2. options
+ * 3. fileEnv
+ * 4. defaults from schema (lowest)
+ *
+ * @param options - Environment sources in priority order
+ * @returns Validated and typed environment configuration
+ */
+declare function loadConnectEnv(options?: LoadEnvOptions): ConnectEnv;
+/**
+ * Loads only runtime environment variables
+ *
+ * @param options - Environment sources in priority order
+ * @returns Validated runtime environment configuration
+ */
+declare function loadRuntimeEnv(options?: LoadEnvOptions): ConnectRuntimeEnv;
+/**
+ * Loads only build-time environment variables
+ *
+ * @param options - Environment sources in priority order
+ * @returns Validated build environment configuration
+ */
+declare function loadBuildEnv(options?: LoadEnvOptions): ConnectBuildEnv;
+/**
+ * Safely sets Connect environment variables with validation.
+ * Invalid values will log a warning and be skipped.
+ *
+ * @param values - Type-safe object with key-value pairs to set
+ *
+ * @example
+ * ```ts
+ * setConnectEnv({
+ *   PH_CONNECT_LOG_LEVEL: "debug",
+ *   PH_CONNECT_VERSION: "1.2.3",
+ *   PH_CONNECT_STUDIO_MODE: true,
+ * });
+ * ```
+ */
+declare function setConnectEnv(values: Partial<ConnectEnv>): void;
+/**
+ * Normalizes a base path to ensure it:
+ * - Starts with a forward slash (/)
+ * - Ends with a forward slash (/)
+ * - Has no relative path prefix (.)
+ *
+ * @param basePath - The base path to normalize
+ * @returns The normalized base path
+ *
+ * @example
+ * normalizeBasePath('/app') // '/app/'
+ * normalizeBasePath('./app/') // '/app/'
+ * normalizeBasePath('app') // '/app/'
+ * normalizeBasePath('/') // '/'
+ * normalizeBasePath('') // '/'
+ */
+declare function normalizeBasePath(basePath: string): string;
+//#endregion
+export { ConnectBuildEnv, ConnectEnv, ConnectRuntimeEnv, LoadEnvOptions, connectEnvSchema, loadBuildEnv, loadConnectEnv, loadRuntimeEnv, normalizeBasePath, runtimeEnvSchema, setConnectEnv };
 //# sourceMappingURL=index.d.ts.map

package/dist/connect/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../connect/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../connect/env-config.ts"],"mappings":";;;;;AAAwB;cA4BlB,cAAA,EAAc,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;cA2YP,gBAAA,EAAgB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAUhB,gBAAA,EAAgB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKjB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,cAAA;AAAA,KACjC,iBAAA,GAAoB,CAAA,CAAE,KAAA,QAAa,gBAAA;AAAA,KACnC,UAAA,GAAa,CAAA,CAAE,KAAA,QAAa,gBAAA;;;;UASvB,cAAA;;;;EAIf,UAAA,GAAa,MAAA;;;;EAIb,OAAA,GAAU,MAAA;AAAA;;;;;;;;;;;iBAmEI,cAAA,CAAe,OAAA,GAAS,cAAA,GAAsB,UAAA;;;;;;;iBAgB9C,cAAA,CACd,OAAA,GAAS,cAAA,GACR,iBAAA;;;;;;;iBAYa,YAAA,CAAa,OAAA,GAAS,cAAA,GAAsB,eAAA;;;;;;;;;;;;;;;;iBAqB5C,aAAA,CAAc,MAAA,EAAQ,OAAA,CAAQ,UAAA;;;;;;;;;;;;;;;;;iBA4C9B,iBAAA,CAAkB,QAAA"}

package/dist/connect/index.js

@@ -1,2 +1,254 @@
-export * from "./env-config.js";
+import { z } from "zod";
+//#region connect/env-config.ts
+/**
+* Coerces string values to boolean.
+* Accepts: "true", "false", true, false
+*/
+const booleanString = z.union([z.boolean(), z.enum(["true", "false"])]).transform((val) => {
+	if (typeof val === "boolean") return val;
+	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
+*/
+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)
+});
+/**
+* Drives configuration schema
+*/
+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),
+	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);
+/**
+* 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)
+*/
+const runtimeEnvSchema = appConfigSchema.extend(featureFlagsSchema.shape).extend(drivesConfigSchema.shape).extend(processorsConfigSchema.shape).extend(sentryConfigSchema.shape).extend(renownConfigSchema.shape);
+/**
+* Complete environment schema (build + runtime)
+*/
+const connectEnvSchema = buildEnvSchema.extend(runtimeEnvSchema.shape);
+/**
+* Internal helper to merge environment sources with priority.
+* Validates each value and falls back to next priority if invalid.
+*/
+function mergeEnvSources(options, keys, schema) {
+	const { processEnv = {}, fileEnv = {} } = options;
+	const merged = {};
+	for (const key of keys) {
+		const sources = [{
+			name: "process.env",
+			value: processEnv[key]
+		}, {
+			name: "fileEnv",
+			value: fileEnv[key]
+		}];
+		for (const source of sources) {
+			const value = source.value;
+			if (value === void 0 || value === "") continue;
+			try {
+				const fieldSchema = schema.shape[key];
+				if (fieldSchema) {
+					fieldSchema.parse(value);
+					merged[key] = value;
+					break;
+				}
+				console.warn(`Unknown environment variable: '${key}'`);
+				merged[key] = value;
+				break;
+			} catch {
+				const valueStr = value === null ? "null" : typeof value === "object" ? JSON.stringify(value) : value;
+				console.warn(`Invalid value for ${key} from ${source.name}: ${valueStr}. Trying next source.`);
+			}
+		}
+	}
+	return merged;
+}
+/**
+* Loads and validates environment variables with priority:
+* 1. process.env (highest)
+* 2. options
+* 3. fileEnv
+* 4. defaults from schema (lowest)
+*
+* @param options - Environment sources in priority order
+* @returns Validated and typed environment configuration
+*/
+function loadConnectEnv(options = {}) {
+	const merged = mergeEnvSources(options, new Set([...Object.keys(buildEnvSchema.shape), ...Object.keys(runtimeEnvSchema.shape)]), connectEnvSchema);
+	return connectEnvSchema.parse(merged);
+}
+/**
+* Loads only runtime environment variables
+*
+* @param options - Environment sources in priority order
+* @returns Validated runtime environment configuration
+*/
+function loadRuntimeEnv(options = {}) {
+	const merged = mergeEnvSources(options, new Set(Object.keys(runtimeEnvSchema.shape)), runtimeEnvSchema);
+	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.
+*
+* @param values - Type-safe object with key-value pairs to set
+*
+* @example
+* ```ts
+* setConnectEnv({
+*   PH_CONNECT_LOG_LEVEL: "debug",
+*   PH_CONNECT_VERSION: "1.2.3",
+*   PH_CONNECT_STUDIO_MODE: true,
+* });
+* ```
+*/
+function setConnectEnv(values) {
+	for (const [key, value] of Object.entries(values)) {
+		const fieldSchema = connectEnvSchema.shape[key];
+		if (!fieldSchema) {
+			console.warn(`Unknown environment variable: ${key}. Variable not set. Valid keys: ${Object.keys(connectEnvSchema.shape).join(", ")}`);
+			continue;
+		}
+		try {
+			fieldSchema.parse(value);
+			process.env[key] = String(value);
+		} catch (error) {
+			console.warn(`Invalid value for ${key}: ${String(value)}. Validation failed.`, error);
+		}
+	}
+}
+/**
+* Normalizes a base path to ensure it:
+* - Starts with a forward slash (/)
+* - Ends with a forward slash (/)
+* - Has no relative path prefix (.)
+*
+* @param basePath - The base path to normalize
+* @returns The normalized base path
+*
+* @example
+* normalizeBasePath('/app') // '/app/'
+* normalizeBasePath('./app/') // '/app/'
+* normalizeBasePath('app') // '/app/'
+* normalizeBasePath('/') // '/'
+* normalizeBasePath('') // '/'
+*/
+function normalizeBasePath(basePath) {
+	if (!basePath) return "/";
+	let normalized = basePath;
+	if (normalized.startsWith(".")) normalized = normalized.slice(1);
+	if (!normalized.startsWith("/")) normalized = `/${normalized}`;
+	if (!normalized.endsWith("/")) normalized = `${normalized}/`;
+	return normalized;
+}
+//#endregion
+export { connectEnvSchema, loadBuildEnv, loadConnectEnv, loadRuntimeEnv, normalizeBasePath, runtimeEnvSchema, setConnectEnv };
+
 //# sourceMappingURL=index.js.map