@powerhousedao/shared 6.0.0-dev.196 → 6.0.0-dev.197

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../connect/env-config.ts"],"mappings":";;;;;AAA2B;cA4BrB,cAAA,EAAc,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;EAAA;;;;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2YP,gBAAA,EAAgB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAA7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;AAxBZ;;;;;;iBA2FgB,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"}
+{"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,4 +1,4 @@
-import { z } from "zod/v3";
+import { z } from "zod";
 //#region connect/env-config.ts
 /**
 * Coerces string values to boolean.
@@ -98,7 +98,7 @@ const relationalProcessorsConfigSchema = z.object({
 const processorsConfigSchema = z.object({
 	PH_CONNECT_PROCESSORS_ENABLED: booleanString.default(true),
 	PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: booleanString.default(true)
-}).merge(analyticsProcessorsConfigSchema).merge(relationalProcessorsConfigSchema);
+}).extend(analyticsProcessorsConfigSchema.shape).extend(relationalProcessorsConfigSchema.shape);
 /**
 * Sentry error tracking configuration schema
 */
@@ -119,11 +119,11 @@ const renownConfigSchema = z.object({
 /**
 * Complete runtime environment schema (all PH_CONNECT_* vars)
 */
-const runtimeEnvSchema = appConfigSchema.merge(featureFlagsSchema).merge(drivesConfigSchema).merge(processorsConfigSchema).merge(sentryConfigSchema).merge(renownConfigSchema);
+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.merge(runtimeEnvSchema);
+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.

package/dist/connect/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../connect/env-config.ts"],"sourcesContent":["import { z } from \"zod/v3\";\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  .merge(analyticsProcessorsConfigSchema)\n  .merge(relationalProcessorsConfigSchema);\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  .merge(featureFlagsSchema)\n  .merge(drivesConfigSchema)\n  .merge(processorsConfigSchema)\n  .merge(sentryConfigSchema)\n  .merge(renownConfigSchema);\n\n/**\n * Complete environment schema (build + runtime)\n */\nexport const connectEnvSchema = buildEnvSchema.merge(runtimeEnvSchema);\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<z.ZodRawShape>,\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"],"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// 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(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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"}

package/dist/registry/index.d.ts

@@ -35,6 +35,26 @@ interface NpmPublishResult {
  * Uses spawn with args array to avoid shell injection.
  */
 declare function npmPublish(options: NpmPublishOptions): Promise<NpmPublishResult>;
+interface NpmUnpublishOptions {
+  /** Registry URL to unpublish from. */
+  registryUrl: string;
+  /** Working directory (project root). */
+  cwd: string;
+  /** Package spec: `<name>` (whole package) or `<name>@<version>` (single version). */
+  spec: string;
+  /** Additional arguments forwarded to npm unpublish. */
+  args?: string[];
+}
+interface NpmUnpublishResult {
+  /** stdout from npm unpublish. */
+  stdout: string;
+}
+/**
+ * Run `npm unpublish` against the given registry.
+ * Always passes `--force` because npm otherwise refuses to unpublish packages
+ * older than 72h (a public-npmjs safeguard that doesn't apply to private registries).
+ */
+declare function npmUnpublish(options: NpmUnpublishOptions): Promise<NpmUnpublishResult>;
 //#endregion
-export { DEFAULT_REGISTRY_URL, NpmPublishOptions, NpmPublishResult, PackageInfo, RegistryPackage, RegistryPackageList, RegistryPackageMap, RegistryPackageSource, RegistryPackageStatus, ResolveRegistryUrlOptions, checkNpmAuth, npmPublish, resolveRegistryUrl };
+export { DEFAULT_REGISTRY_URL, NpmPublishOptions, NpmPublishResult, NpmUnpublishOptions, NpmUnpublishResult, PackageInfo, RegistryPackage, RegistryPackageList, RegistryPackageMap, RegistryPackageSource, RegistryPackageStatus, ResolveRegistryUrlOptions, checkNpmAuth, npmPublish, npmUnpublish, resolveRegistryUrl };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../registry/registry.ts"],"mappings":";;;UAUiB,yBAAA;;EAEf,QAAA;;EAEA,WAAA;EAJwC;EAMxC,GAAA,GAAM,MAAA;AAAA;;;;iBAMQ,kBAAA,CAAmB,OAAA,EAAS,yBAAA;;;AAA5C;;iBAiBsB,YAAA,CAAa,WAAA,WAAsB,OAAA;AAAA,UAIxC,iBAAA;EArBoD;EAuBnE,WAAA;EANgC;EAQhC,GAAA;EARiC;EAUjC,IAAA;AAAA;AAAA,UAGe,gBAAA;;EAEf,MAAA;AAAA;;;;;iBAOoB,UAAA,CACpB,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,gBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../registry/registry.ts"],"mappings":";;;UAUiB,yBAAA;;EAEf,QAAA;;EAEA,WAAA;EAJwC;EAMxC,GAAA,GAAM,MAAA;AAAA;;;;iBAMQ,kBAAA,CAAmB,OAAA,EAAS,yBAAA;;;AAA5C;;iBAiBsB,YAAA,CAAa,WAAA,WAAsB,OAAA;AAAA,UAIxC,iBAAA;EArBoD;EAuBnE,WAAA;EANgC;EAQhC,GAAA;EARiC;EAUjC,IAAA;AAAA;AAAA,UAGe,gBAAA;;EAEf,MAAA;AAAA;;;;;iBAOoB,UAAA,CACpB,OAAA,EAAS,iBAAA,GACR,OAAA,CAAQ,gBAAA;AAAA,UAOM,mBAAA;;EAEf,WAAA;EAlBM;EAoBN,GAAA;EAb8B;EAe9B,IAAA;EAdS;EAgBT,IAAA;AAAA;AAAA,UAGe,kBAAA;EAlBP;EAoBR,MAAA;AAAA;;;;;AAbF;iBAqBsB,YAAA,CACpB,OAAA,EAAS,mBAAA,GACR,OAAA,CAAQ,kBAAA"}

package/dist/registry/index.js

@@ -94,7 +94,23 @@ async function npmPublish(options) {
 		...args
 	], { cwd }) };
 }
+/**
+* Run `npm unpublish` against the given registry.
+* Always passes `--force` because npm otherwise refuses to unpublish packages
+* older than 72h (a public-npmjs safeguard that doesn't apply to private registries).
+*/
+async function npmUnpublish(options) {
+	const { registryUrl, cwd, spec, args = [] } = options;
+	return { stdout: await spawnAsync("npm", [
+		"unpublish",
+		spec,
+		"--registry",
+		registryUrl,
+		"--force",
+		...args
+	], { cwd }) };
+}
 //#endregion
-export { DEFAULT_REGISTRY_URL, checkNpmAuth, npmPublish, resolveRegistryUrl };
+export { DEFAULT_REGISTRY_URL, checkNpmAuth, npmPublish, npmUnpublish, resolveRegistryUrl };
 
 //# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../clis/constants.ts","../../clis/file-system/get-config.ts","../../clis/file-system/spawn-async.ts","../../registry/registry.ts"],"sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { PowerhouseConfig } from \"./types.js\";\n\nexport const SERVICE_ACTIONS = [\n  \"start\",\n  \"stop\",\n  \"status\",\n  \"setup\",\n  \"restart\",\n] as const;\n\nexport const SECONDS_IN_DAY = 24 * 60 * 60;\nexport const DEFAULT_EXPIRY_DAYS = 7;\nexport const DEFAULT_EXPIRY_SECONDS = DEFAULT_EXPIRY_DAYS * SECONDS_IN_DAY;\n\nexport const DRIVES_PRESERVE_STRATEGIES = [\n  \"preserve-all\",\n  \"preserve-by-url-and-detach\",\n] as const;\n\nexport const LOG_LEVELS = [\n  \"debug\",\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"verbose\",\n] as const;\n\nexport const DEFAULT_TIMEOUT = 300 as const;\n\nexport const DEFAULT_CONNECT_STUDIO_PORT = 3000 as const;\n\nexport const DEFAULT_VETRA_CONNECT_PORT = 3001 as const;\n\nexport const DEFAULT_CONNECT_PREVIEW_PORT = 4173 as const;\n\nexport const DEFAULT_CONNECT_OUTDIR = \".ph/connect-build/dist/\" as const;\n\nexport const DEFAULT_RENOWN_URL = \"https://www.renown.id\" as const;\n\nexport const DEFAULT_REGISTRY_URL = \"https://registry.dev.vetra.io\" as const;\n\nexport const DEFAULT_SWITCHBOARD_PORT = 4001 as const;\n\nexport const DEFAULT_VETRA_DRIVE_ID = \"vetra\" as const;\n\nexport const MINIMUM_NODE_VERSION = \"24.0.0\" as const;\nexport const PH_BIN = \"ph-cli-legacy\" as const;\nexport const POWERHOUSE_CONFIG_FILE = \"powerhouse.config.json\" as const;\nexport const PH_GLOBAL_DIR_NAME = \".ph\" as const;\n// Keep PH_GLOBAL_PROJECT_NAME for backwards compatibility\nexport const PH_GLOBAL_PROJECT_NAME = PH_GLOBAL_DIR_NAME;\n\nexport const HOME_DIR = homedir();\n\nexport const POWERHOUSE_GLOBAL_DIR = join(HOME_DIR, PH_GLOBAL_DIR_NAME);\n\nexport const VERSIONED_DEPENDENCIES = [\n  \"document-model\",\n  \"@powerhousedao/design-system\",\n  \"@powerhousedao/reactor-api\",\n  \"@powerhousedao/reactor-browser\",\n  \"@powerhousedao/connect\",\n  \"@powerhousedao/shared\",\n  \"@powerhousedao/analytics-engine-core\",\n];\n\nexport const VERSIONED_DEV_DEPENDENCIES = [\n  \"@powerhousedao/ph-cli\",\n  \"@powerhousedao/reactor\",\n];\n\nconst DEFAULT_DOCUMENT_MODELS_DIR = \"./document-models\";\nconst DEFAULT_EDITORS_DIR = \"./editors\";\nconst DEFAULT_PROCESSORS_DIR = \"./processors\";\nconst DEFAULT_SUBGRAPHS_DIR = \"./subgraphs\";\nconst DEFAULT_IMPORT_SCRIPTS_DIR = \"./scripts\";\nconst DEFAULT_SKIP_FORMAT = false;\nconst DEFAULT_LOG_LEVEL = \"info\";\n\nexport const DEFAULT_CONFIG: PowerhouseConfig = {\n  documentModelsDir: DEFAULT_DOCUMENT_MODELS_DIR,\n  editorsDir: DEFAULT_EDITORS_DIR,\n  processorsDir: DEFAULT_PROCESSORS_DIR,\n  subgraphsDir: DEFAULT_SUBGRAPHS_DIR,\n  importScriptsDir: DEFAULT_IMPORT_SCRIPTS_DIR,\n  skipFormat: DEFAULT_SKIP_FORMAT,\n  logLevel: DEFAULT_LOG_LEVEL,\n  auth: {\n    enabled: false,\n    admins: [],\n  },\n};\n","import { readFileSync } from \"node:fs\";\nimport { DEFAULT_CONFIG } from \"../constants.js\";\nimport type { PowerhouseConfig } from \"../types.js\";\n\nexport function getConfig(path = \"./powerhouse.config.json\") {\n  let config: PowerhouseConfig = { ...DEFAULT_CONFIG };\n  try {\n    const configStr = readFileSync(path, \"utf-8\");\n    const userConfig = JSON.parse(configStr) as PowerhouseConfig;\n    config = { ...config, ...userConfig };\n  } catch {\n    // console.warn(\"No powerhouse.config.json found, using defaults\");\n  }\n\n  return config;\n}\n","import { spawn } from \"node:child_process\";\n\nexport function spawnAsync(\n  command: string,\n  args: string[],\n  options: {\n    cwd?: string;\n    env?: NodeJS.ProcessEnv;\n  } = {},\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const cmd =\n      process.platform === \"win32\" && command === \"npm\" ? \"npm.cmd\" : command;\n\n    const child = spawn(cmd, args, {\n      cwd: options.cwd,\n      env: options.env,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n\n    let stdout = \"\";\n    let stderr = \"\";\n\n    child.stdout.on(\"data\", (d: Buffer) => {\n      stdout += d.toString();\n    });\n\n    child.stderr.on(\"data\", (d: Buffer) => {\n      stderr += d.toString();\n    });\n\n    child.on(\"error\", reject);\n\n    child.on(\"close\", (code) => {\n      if (code === 0) {\n        resolve(stdout.trim());\n      } else {\n        reject(\n          new Error(stderr.trim() || `${command} exited with code ${code}`),\n        );\n      }\n    });\n  });\n}\n","import { join } from \"node:path\";\nimport {\n  DEFAULT_REGISTRY_URL,\n  POWERHOUSE_CONFIG_FILE,\n} from \"../clis/constants.js\";\nimport { getConfig } from \"../clis/file-system/get-config.js\";\nimport { spawnAsync } from \"../clis/file-system/spawn-async.js\";\n\nexport { DEFAULT_REGISTRY_URL } from \"../clis/constants.js\";\n\nexport interface ResolveRegistryUrlOptions {\n  /** Explicit registry URL (e.g. from --registry flag). Highest priority. */\n  registry?: string;\n  /** Project path to read powerhouse.config.json from. */\n  projectPath: string;\n  /** Environment variables. Defaults to process.env. */\n  env?: Record<string, string | undefined>;\n}\n\n/**\n * Resolve the registry URL with priority: flag > env > config > default.\n */\nexport function resolveRegistryUrl(options: ResolveRegistryUrlOptions): string {\n  const { registry, projectPath, env = process.env } = options;\n  const configPath = join(projectPath, POWERHOUSE_CONFIG_FILE);\n  const config = getConfig(configPath);\n\n  return (\n    registry ??\n    env.PH_REGISTRY_URL ??\n    config.packageRegistryUrl ??\n    DEFAULT_REGISTRY_URL\n  );\n}\n\n/**\n * Check if the user is authenticated with the given npm registry.\n * Returns the username on success, throws on failure.\n */\nexport async function checkNpmAuth(registryUrl: string): Promise<string> {\n  return spawnAsync(\"npm\", [\"whoami\", \"--registry\", registryUrl]);\n}\n\nexport interface NpmPublishOptions {\n  /** Registry URL to publish to. */\n  registryUrl: string;\n  /** Working directory (project root). */\n  cwd: string;\n  /** Additional arguments forwarded to npm publish. */\n  args?: string[];\n}\n\nexport interface NpmPublishResult {\n  /** stdout from npm publish. */\n  stdout: string;\n}\n\n/**\n * Run `npm publish` against the given registry.\n * Uses spawn with args array to avoid shell injection.\n */\nexport async function npmPublish(\n  options: NpmPublishOptions,\n): Promise<NpmPublishResult> {\n  const { registryUrl, cwd, args = [] } = options;\n  const npmArgs = [\"publish\", \"--registry\", registryUrl, ...args];\n  const stdout = await spawnAsync(\"npm\", npmArgs, { cwd });\n  return { stdout };\n}\n"],"mappings":";;;;AAyCA,MAAa,uBAAuB;AAQpC,MAAa,yBAAyB;AAOD,KAFb,SAAS,EAES,MAA6B;AAyBvE,MAAa,iBAAmC;CAC9C,mBATkC;CAUlC,YAT0B;CAU1B,eAT6B;CAU7B,cAT4B;CAU5B,kBATiC;CAUjC,YAT0B;CAU1B,UATwB;CAUxB,MAAM;EACJ,SAAS;EACT,QAAQ,EAAE;EACX;CACF;;;ACzFD,SAAgB,UAAU,OAAO,4BAA4B;CAC3D,IAAI,SAA2B,EAAE,GAAG,gBAAgB;AACpD,KAAI;EACF,MAAM,YAAY,aAAa,MAAM,QAAQ;EAC7C,MAAM,aAAa,KAAK,MAAM,UAAU;AACxC,WAAS;GAAE,GAAG;GAAQ,GAAG;GAAY;SAC/B;AAIR,QAAO;;;;ACZT,SAAgB,WACd,SACA,MACA,UAGI,EAAE,EACW;AACjB,QAAO,IAAI,SAAS,SAAS,WAAW;EAItC,MAAM,QAAQ,MAFZ,QAAQ,aAAa,WAAW,YAAY,QAAQ,YAAY,SAEzC,MAAM;GAC7B,KAAK,QAAQ;GACb,KAAK,QAAQ;GACb,OAAO;IAAC;IAAU;IAAQ;IAAO;GAClC,CAAC;EAEF,IAAI,SAAS;EACb,IAAI,SAAS;AAEb,QAAM,OAAO,GAAG,SAAS,MAAc;AACrC,aAAU,EAAE,UAAU;IACtB;AAEF,QAAM,OAAO,GAAG,SAAS,MAAc;AACrC,aAAU,EAAE,UAAU;IACtB;AAEF,QAAM,GAAG,SAAS,OAAO;AAEzB,QAAM,GAAG,UAAU,SAAS;AAC1B,OAAI,SAAS,EACX,SAAQ,OAAO,MAAM,CAAC;OAEtB,QACE,IAAI,MAAM,OAAO,MAAM,IAAI,GAAG,QAAQ,oBAAoB,OAAO,CAClE;IAEH;GACF;;;;;;;ACpBJ,SAAgB,mBAAmB,SAA4C;CAC7E,MAAM,EAAE,UAAU,aAAa,MAAM,QAAQ,QAAQ;CAErD,MAAM,SAAS,UADI,KAAK,aAAa,uBAAuB,CACxB;AAEpC,QACE,YACA,IAAI,mBACJ,OAAO,sBAAA;;;;;;AASX,eAAsB,aAAa,aAAsC;AACvE,QAAO,WAAW,OAAO;EAAC;EAAU;EAAc;EAAY,CAAC;;;;;;AAqBjE,eAAsB,WACpB,SAC2B;CAC3B,MAAM,EAAE,aAAa,KAAK,OAAO,EAAE,KAAK;AAGxC,QAAO,EAAE,QADM,MAAM,WAAW,OADhB;EAAC;EAAW;EAAc;EAAa,GAAG;EAAK,EACf,EAAE,KAAK,CAAC,EACvC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../clis/constants.ts","../../clis/file-system/get-config.ts","../../clis/file-system/spawn-async.ts","../../registry/registry.ts"],"sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { PowerhouseConfig } from \"./types.js\";\n\nexport const SERVICE_ACTIONS = [\n  \"start\",\n  \"stop\",\n  \"status\",\n  \"setup\",\n  \"restart\",\n] as const;\n\nexport const SECONDS_IN_DAY = 24 * 60 * 60;\nexport const DEFAULT_EXPIRY_DAYS = 7;\nexport const DEFAULT_EXPIRY_SECONDS = DEFAULT_EXPIRY_DAYS * SECONDS_IN_DAY;\n\nexport const DRIVES_PRESERVE_STRATEGIES = [\n  \"preserve-all\",\n  \"preserve-by-url-and-detach\",\n] as const;\n\nexport const LOG_LEVELS = [\n  \"debug\",\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"verbose\",\n] as const;\n\nexport const DEFAULT_TIMEOUT = 300 as const;\n\nexport const DEFAULT_CONNECT_STUDIO_PORT = 3000 as const;\n\nexport const DEFAULT_VETRA_CONNECT_PORT = 3001 as const;\n\nexport const DEFAULT_CONNECT_PREVIEW_PORT = 4173 as const;\n\nexport const DEFAULT_CONNECT_OUTDIR = \".ph/connect-build/dist/\" as const;\n\nexport const DEFAULT_RENOWN_URL = \"https://www.renown.id\" as const;\n\nexport const DEFAULT_REGISTRY_URL = \"https://registry.dev.vetra.io\" as const;\n\nexport const DEFAULT_SWITCHBOARD_PORT = 4001 as const;\n\nexport const DEFAULT_VETRA_DRIVE_ID = \"vetra\" as const;\n\nexport const MINIMUM_NODE_VERSION = \"24.0.0\" as const;\nexport const PH_BIN = \"ph-cli-legacy\" as const;\nexport const POWERHOUSE_CONFIG_FILE = \"powerhouse.config.json\" as const;\nexport const PH_GLOBAL_DIR_NAME = \".ph\" as const;\n// Keep PH_GLOBAL_PROJECT_NAME for backwards compatibility\nexport const PH_GLOBAL_PROJECT_NAME = PH_GLOBAL_DIR_NAME;\n\nexport const HOME_DIR = homedir();\n\nexport const POWERHOUSE_GLOBAL_DIR = join(HOME_DIR, PH_GLOBAL_DIR_NAME);\n\nexport const VERSIONED_DEPENDENCIES = [\n  \"document-model\",\n  \"@powerhousedao/design-system\",\n  \"@powerhousedao/reactor-api\",\n  \"@powerhousedao/reactor-browser\",\n  \"@powerhousedao/connect\",\n  \"@powerhousedao/shared\",\n  \"@powerhousedao/analytics-engine-core\",\n];\n\nexport const VERSIONED_DEV_DEPENDENCIES = [\n  \"@powerhousedao/ph-cli\",\n  \"@powerhousedao/reactor\",\n];\n\nconst DEFAULT_DOCUMENT_MODELS_DIR = \"./document-models\";\nconst DEFAULT_EDITORS_DIR = \"./editors\";\nconst DEFAULT_PROCESSORS_DIR = \"./processors\";\nconst DEFAULT_SUBGRAPHS_DIR = \"./subgraphs\";\nconst DEFAULT_IMPORT_SCRIPTS_DIR = \"./scripts\";\nconst DEFAULT_SKIP_FORMAT = false;\nconst DEFAULT_LOG_LEVEL = \"info\";\n\nexport const DEFAULT_CONFIG: PowerhouseConfig = {\n  documentModelsDir: DEFAULT_DOCUMENT_MODELS_DIR,\n  editorsDir: DEFAULT_EDITORS_DIR,\n  processorsDir: DEFAULT_PROCESSORS_DIR,\n  subgraphsDir: DEFAULT_SUBGRAPHS_DIR,\n  importScriptsDir: DEFAULT_IMPORT_SCRIPTS_DIR,\n  skipFormat: DEFAULT_SKIP_FORMAT,\n  logLevel: DEFAULT_LOG_LEVEL,\n  auth: {\n    enabled: false,\n    admins: [],\n  },\n};\n","import { readFileSync } from \"node:fs\";\nimport { DEFAULT_CONFIG } from \"../constants.js\";\nimport type { PowerhouseConfig } from \"../types.js\";\n\nexport function getConfig(path = \"./powerhouse.config.json\") {\n  let config: PowerhouseConfig = { ...DEFAULT_CONFIG };\n  try {\n    const configStr = readFileSync(path, \"utf-8\");\n    const userConfig = JSON.parse(configStr) as PowerhouseConfig;\n    config = { ...config, ...userConfig };\n  } catch {\n    // console.warn(\"No powerhouse.config.json found, using defaults\");\n  }\n\n  return config;\n}\n","import { spawn } from \"node:child_process\";\n\nexport function spawnAsync(\n  command: string,\n  args: string[],\n  options: {\n    cwd?: string;\n    env?: NodeJS.ProcessEnv;\n  } = {},\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const cmd =\n      process.platform === \"win32\" && command === \"npm\" ? \"npm.cmd\" : command;\n\n    const child = spawn(cmd, args, {\n      cwd: options.cwd,\n      env: options.env,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n\n    let stdout = \"\";\n    let stderr = \"\";\n\n    child.stdout.on(\"data\", (d: Buffer) => {\n      stdout += d.toString();\n    });\n\n    child.stderr.on(\"data\", (d: Buffer) => {\n      stderr += d.toString();\n    });\n\n    child.on(\"error\", reject);\n\n    child.on(\"close\", (code) => {\n      if (code === 0) {\n        resolve(stdout.trim());\n      } else {\n        reject(\n          new Error(stderr.trim() || `${command} exited with code ${code}`),\n        );\n      }\n    });\n  });\n}\n","import { join } from \"node:path\";\nimport {\n  DEFAULT_REGISTRY_URL,\n  POWERHOUSE_CONFIG_FILE,\n} from \"../clis/constants.js\";\nimport { getConfig } from \"../clis/file-system/get-config.js\";\nimport { spawnAsync } from \"../clis/file-system/spawn-async.js\";\n\nexport { DEFAULT_REGISTRY_URL } from \"../clis/constants.js\";\n\nexport interface ResolveRegistryUrlOptions {\n  /** Explicit registry URL (e.g. from --registry flag). Highest priority. */\n  registry?: string;\n  /** Project path to read powerhouse.config.json from. */\n  projectPath: string;\n  /** Environment variables. Defaults to process.env. */\n  env?: Record<string, string | undefined>;\n}\n\n/**\n * Resolve the registry URL with priority: flag > env > config > default.\n */\nexport function resolveRegistryUrl(options: ResolveRegistryUrlOptions): string {\n  const { registry, projectPath, env = process.env } = options;\n  const configPath = join(projectPath, POWERHOUSE_CONFIG_FILE);\n  const config = getConfig(configPath);\n\n  return (\n    registry ??\n    env.PH_REGISTRY_URL ??\n    config.packageRegistryUrl ??\n    DEFAULT_REGISTRY_URL\n  );\n}\n\n/**\n * Check if the user is authenticated with the given npm registry.\n * Returns the username on success, throws on failure.\n */\nexport async function checkNpmAuth(registryUrl: string): Promise<string> {\n  return spawnAsync(\"npm\", [\"whoami\", \"--registry\", registryUrl]);\n}\n\nexport interface NpmPublishOptions {\n  /** Registry URL to publish to. */\n  registryUrl: string;\n  /** Working directory (project root). */\n  cwd: string;\n  /** Additional arguments forwarded to npm publish. */\n  args?: string[];\n}\n\nexport interface NpmPublishResult {\n  /** stdout from npm publish. */\n  stdout: string;\n}\n\n/**\n * Run `npm publish` against the given registry.\n * Uses spawn with args array to avoid shell injection.\n */\nexport async function npmPublish(\n  options: NpmPublishOptions,\n): Promise<NpmPublishResult> {\n  const { registryUrl, cwd, args = [] } = options;\n  const npmArgs = [\"publish\", \"--registry\", registryUrl, ...args];\n  const stdout = await spawnAsync(\"npm\", npmArgs, { cwd });\n  return { stdout };\n}\n\nexport interface NpmUnpublishOptions {\n  /** Registry URL to unpublish from. */\n  registryUrl: string;\n  /** Working directory (project root). */\n  cwd: string;\n  /** Package spec: `<name>` (whole package) or `<name>@<version>` (single version). */\n  spec: string;\n  /** Additional arguments forwarded to npm unpublish. */\n  args?: string[];\n}\n\nexport interface NpmUnpublishResult {\n  /** stdout from npm unpublish. */\n  stdout: string;\n}\n\n/**\n * Run `npm unpublish` against the given registry.\n * Always passes `--force` because npm otherwise refuses to unpublish packages\n * older than 72h (a public-npmjs safeguard that doesn't apply to private registries).\n */\nexport async function npmUnpublish(\n  options: NpmUnpublishOptions,\n): Promise<NpmUnpublishResult> {\n  const { registryUrl, cwd, spec, args = [] } = options;\n  const npmArgs = [\n    \"unpublish\",\n    spec,\n    \"--registry\",\n    registryUrl,\n    \"--force\",\n    ...args,\n  ];\n  const stdout = await spawnAsync(\"npm\", npmArgs, { cwd });\n  return { stdout };\n}\n"],"mappings":";;;;AAyCA,MAAa,uBAAuB;AAQpC,MAAa,yBAAyB;AAOD,KAFb,SAAS,EAES,MAA6B;AAyBvE,MAAa,iBAAmC;CAC9C,mBATkC;CAUlC,YAT0B;CAU1B,eAT6B;CAU7B,cAT4B;CAU5B,kBATiC;CAUjC,YAT0B;CAU1B,UATwB;CAUxB,MAAM;EACJ,SAAS;EACT,QAAQ,EAAE;EACX;CACF;;;ACzFD,SAAgB,UAAU,OAAO,4BAA4B;CAC3D,IAAI,SAA2B,EAAE,GAAG,gBAAgB;AACpD,KAAI;EACF,MAAM,YAAY,aAAa,MAAM,QAAQ;EAC7C,MAAM,aAAa,KAAK,MAAM,UAAU;AACxC,WAAS;GAAE,GAAG;GAAQ,GAAG;GAAY;SAC/B;AAIR,QAAO;;;;ACZT,SAAgB,WACd,SACA,MACA,UAGI,EAAE,EACW;AACjB,QAAO,IAAI,SAAS,SAAS,WAAW;EAItC,MAAM,QAAQ,MAFZ,QAAQ,aAAa,WAAW,YAAY,QAAQ,YAAY,SAEzC,MAAM;GAC7B,KAAK,QAAQ;GACb,KAAK,QAAQ;GACb,OAAO;IAAC;IAAU;IAAQ;IAAO;GAClC,CAAC;EAEF,IAAI,SAAS;EACb,IAAI,SAAS;AAEb,QAAM,OAAO,GAAG,SAAS,MAAc;AACrC,aAAU,EAAE,UAAU;IACtB;AAEF,QAAM,OAAO,GAAG,SAAS,MAAc;AACrC,aAAU,EAAE,UAAU;IACtB;AAEF,QAAM,GAAG,SAAS,OAAO;AAEzB,QAAM,GAAG,UAAU,SAAS;AAC1B,OAAI,SAAS,EACX,SAAQ,OAAO,MAAM,CAAC;OAEtB,QACE,IAAI,MAAM,OAAO,MAAM,IAAI,GAAG,QAAQ,oBAAoB,OAAO,CAClE;IAEH;GACF;;;;;;;ACpBJ,SAAgB,mBAAmB,SAA4C;CAC7E,MAAM,EAAE,UAAU,aAAa,MAAM,QAAQ,QAAQ;CAErD,MAAM,SAAS,UADI,KAAK,aAAa,uBAAuB,CACxB;AAEpC,QACE,YACA,IAAI,mBACJ,OAAO,sBAAA;;;;;;AASX,eAAsB,aAAa,aAAsC;AACvE,QAAO,WAAW,OAAO;EAAC;EAAU;EAAc;EAAY,CAAC;;;;;;AAqBjE,eAAsB,WACpB,SAC2B;CAC3B,MAAM,EAAE,aAAa,KAAK,OAAO,EAAE,KAAK;AAGxC,QAAO,EAAE,QADM,MAAM,WAAW,OADhB;EAAC;EAAW;EAAc;EAAa,GAAG;EAAK,EACf,EAAE,KAAK,CAAC,EACvC;;;;;;;AAwBnB,eAAsB,aACpB,SAC6B;CAC7B,MAAM,EAAE,aAAa,KAAK,MAAM,OAAO,EAAE,KAAK;AAU9C,QAAO,EAAE,QADM,MAAM,WAAW,OARhB;EACd;EACA;EACA;EACA;EACA;EACA,GAAG;EACJ,EAC+C,EAAE,KAAK,CAAC,EACvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/shared",
-  "version": "6.0.0-dev.196",
+  "version": "6.0.0-dev.197",
   "type": "module",
   "sideEffects": false,
   "publishConfig": {