Function loadConfiguration

extensions/cli/src/configLoader.ts:43–76

(
  authConfig: AuthConfig,
  cliConfigPath: string | undefined,
  apiClient: DefaultApiInterface,
  injectBlocks: PackageIdentifier[],
  isHeadless: boolean | undefined,
)

 * with clear precedence and fallback logic in a single testable function.
 */
export async function loadConfiguration(
  authConfig: AuthConfig,
  cliConfigPath: string | undefined,
  apiClient: DefaultApiInterface,
  injectBlocks: PackageIdentifier[],
  isHeadless: boolean | undefined,
): Promise<ConfigLoadResult> {
  const organizationId = getOrganizationId(authConfig);
  const accessToken = getAccessToken(authConfig);

  // Step 1: Determine config source using precedence rules
  const configSource = determineConfigSource(
    authConfig,
    cliConfigPath,
    isHeadless,
  );

  // Step 2: Load configuration from the determined source
  const config = await loadFromSource(
    configSource,
    accessToken,
    organizationId ?? null,
    apiClient,
    injectBlocks,
  );

  // Step 3: Save config URI for session continuity
  const uri = getUriFromSource(configSource);
  if (uri) {
    updateConfigUri(uri);
  }

  return { config, source: configSource };
}

/**
 * Determines the configuration source using the specification's precedence rules: