fix(gateway): anchor config discovery and isolate env tests (#1138)

2026-08-09 23:11:09 -05:00
parent 884d527cc8
commit 2d5a8c81ec
3 changed files with 404 additions and 258 deletions
@@ -14,67 +14,112 @@ type TierSource =

 type BootSource = TierSource | 'mosaic.config.json';

+export interface GatewayDotenvPaths {
+  daemonEnv: string;
+  monorepoRootEnv: string;
+  gatewayLocalEnv: string;
+}
+
 const here = dirname(fileURLToPath(import.meta.url));
-const daemonEnv = join(homedir(), '.config', 'mosaic', 'gateway', '.env');
-const monorepoRootEnv = resolve(here, '../../..', '.env');
-const gatewayLocalEnv = resolve(here, '..', '.env');

-const inheritedTier = process.env['MOSAIC_STORAGE_TIER'];
-let tierSource: TierSource = inheritedTier === undefined ? 'default' : 'process environment';
-const inheritedDatabaseUrl = process.env['DATABASE_URL'];
-let databaseUrlSource: TierSource =
-  inheritedDatabaseUrl === undefined ? 'default' : 'process environment';
-
-function loadAnchoredDotenv(
-  path: string,
-  sourceLabel: Exclude<TierSource, 'process environment' | 'default'>,
-): void {
-  if (!existsSync(path)) {
-    return;
-  }
-
-  const beforeTier = process.env['MOSAIC_STORAGE_TIER'];
-  const beforeDatabaseUrl = process.env['DATABASE_URL'];
-  config({ path, quiet: true });
-
-  if (
-    beforeTier === undefined &&
-    process.env['MOSAIC_STORAGE_TIER'] !== undefined &&
-    tierSource === 'default'
-  ) {
-    tierSource = sourceLabel;
-  }
-
-  if (
-    beforeDatabaseUrl === undefined &&
-    process.env['DATABASE_URL'] !== undefined &&
-    databaseUrlSource === 'default'
-  ) {
-    databaseUrlSource = sourceLabel;
-  }
+export function resolveGatewayDotenvPaths(
+  anchor: string = here,
+  homeBase: string = homedir(),
+): GatewayDotenvPaths {
+  return {
+    daemonEnv: join(homeBase, '.config', 'mosaic', 'gateway', '.env'),
+    monorepoRootEnv: resolve(anchor, '../../..', '.env'),
+    gatewayLocalEnv: resolve(anchor, '..', '.env'),
+  };
 }

-// Load .env from daemon config dir (global install / daemon mode) first.
-// It takes precedence over file-based local-dev configuration.
-loadAnchoredDotenv(daemonEnv, 'daemon .env');
+export function resolveGatewayConfigPath(anchor: string = here): string {
+  const monorepoRootConfig = resolve(anchor, '../../..', 'mosaic.config.json');
+  const gatewayLocalConfig = resolve(anchor, '..', 'mosaic.config.json');

-// Load .env from the anchored monorepo root, then fill any remaining values
-// from apps/gateway/.env when present.
-loadAnchoredDotenv(monorepoRootEnv, 'monorepo-root .env');
-loadAnchoredDotenv(gatewayLocalEnv, 'gateway-local .env');
+  if (existsSync(monorepoRootConfig)) {
+    return monorepoRootConfig;
+  }
+  if (existsSync(gatewayLocalConfig)) {
+    return gatewayLocalConfig;
+  }

-const envOnlyTier = detectFromEnv().tier;
-const resolvedTier = loadConfig().tier;
-
-let source: BootSource;
-if (resolvedTier !== envOnlyTier) {
-  source = 'mosaic.config.json';
-} else if (tierSource !== 'default') {
-  source = tierSource;
-} else if (envOnlyTier === 'standalone' && databaseUrlSource !== 'default') {
-  source = databaseUrlSource;
-} else {
-  source = 'default';
+  return monorepoRootConfig;
 }

-console.info(`[gateway env] storage tier=${resolvedTier} source=${source}`);
+export function loadGatewayEnv(anchor: string = here, homeBase: string = homedir()): void {
+  const { daemonEnv, monorepoRootEnv, gatewayLocalEnv } = resolveGatewayDotenvPaths(
+    anchor,
+    homeBase,
+  );
+  const inheritedTier = process.env['MOSAIC_STORAGE_TIER'];
+  let tierSource: TierSource = inheritedTier === undefined ? 'default' : 'process environment';
+  const inheritedDatabaseUrl = process.env['DATABASE_URL'];
+  let databaseUrlSource: TierSource =
+    inheritedDatabaseUrl === undefined ? 'default' : 'process environment';
+
+  function loadAnchoredDotenv(
+    path: string,
+    sourceLabel: Exclude<TierSource, 'process environment' | 'default'>,
+  ): void {
+    if (!existsSync(path)) {
+      return;
+    }
+
+    const beforeTier = process.env['MOSAIC_STORAGE_TIER'];
+    const beforeDatabaseUrl = process.env['DATABASE_URL'];
+    config({ path, quiet: true });
+
+    if (
+      beforeTier === undefined &&
+      process.env['MOSAIC_STORAGE_TIER'] !== undefined &&
+      tierSource === 'default'
+    ) {
+      tierSource = sourceLabel;
+    }
+
+    if (
+      beforeDatabaseUrl === undefined &&
+      process.env['DATABASE_URL'] !== undefined &&
+      databaseUrlSource === 'default'
+    ) {
+      databaseUrlSource = sourceLabel;
+    }
+  }
+
+  // Load .env from daemon config dir (global install / daemon mode) first.
+  // It takes precedence over file-based local-dev configuration.
+  loadAnchoredDotenv(daemonEnv, 'daemon .env');
+
+  // Load .env from the anchored monorepo root, then fill any remaining values
+  // from apps/gateway/.env when present.
+  loadAnchoredDotenv(monorepoRootEnv, 'monorepo-root .env');
+  loadAnchoredDotenv(gatewayLocalEnv, 'gateway-local .env');
+
+  const envOnlyTier = detectFromEnv().tier;
+  const configPath = resolveGatewayConfigPath(anchor);
+  const anchoredConfigExists = existsSync(configPath);
+  const resolvedTier = loadConfig(configPath).tier;
+  const configuredTier = process.env['MOSAIC_STORAGE_TIER'];
+  const databaseUrlDeterminesTier = envOnlyTier === 'standalone' && configuredTier !== 'standalone';
+  const recognizedTierDeterminesTier =
+    (configuredTier === 'federated' ||
+      configuredTier === 'standalone' ||
+      configuredTier === 'local') &&
+    configuredTier === envOnlyTier;
+
+  let source: BootSource;
+  if (anchoredConfigExists) {
+    source = 'mosaic.config.json';
+  } else if (databaseUrlDeterminesTier && databaseUrlSource !== 'default') {
+    source = databaseUrlSource;
+  } else if (recognizedTierDeterminesTier && tierSource !== 'default') {
+    source = tierSource;
+  } else {
+    source = 'default';
+  }
+
+  console.info(`[gateway env] storage tier=${resolvedTier} source=${source}`);
+}
+
+loadGatewayEnv();