@trueburn/spring-config-client 0.1.0

package/dist/register.js

@@ -0,0 +1,299 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/register.ts
+var register_exports = {};
+__export(register_exports, {
+  default: () => register_default
+});
+module.exports = __toCommonJS(register_exports);
+
+// src/config.ts
+function resolveConfig(env = process.env) {
+  const auth = env.SPRING_CLOUD_CONFIG_AUTH_USER ? {
+    user: env.SPRING_CLOUD_CONFIG_AUTH_USER,
+    pass: env.SPRING_CLOUD_CONFIG_AUTH_PASS ?? ""
+  } : void 0;
+  return {
+    enabled: envBool(env, "SPRING_CLOUD_CONFIG_ENABLED", false),
+    uri: env.SPRING_CLOUD_CONFIG_URI ?? "http://localhost:8888",
+    name: env.SPRING_CLOUD_CONFIG_NAME ?? "application",
+    profile: env.SPRING_CLOUD_CONFIG_PROFILE ?? "default",
+    label: env.SPRING_CLOUD_CONFIG_LABEL ?? "main",
+    failFast: envBool(env, "SPRING_CLOUD_CONFIG_FAIL_FAST", false),
+    auth,
+    retry: {
+      enabled: envBool(env, "SPRING_CLOUD_CONFIG_RETRY_ENABLED", false),
+      maxAttempts: envInt(env, "SPRING_CLOUD_CONFIG_RETRY_MAX_ATTEMPTS", 5),
+      interval: envInt(env, "SPRING_CLOUD_CONFIG_RETRY_INTERVAL", 1e3),
+      multiplier: envFloat(env, "SPRING_CLOUD_CONFIG_RETRY_MULTIPLIER", 1.5),
+      maxInterval: envInt(env, "SPRING_CLOUD_CONFIG_RETRY_MAX_INTERVAL", 3e4)
+    },
+    headers: parseHeaders(env),
+    requestTimeout: envInt(env, "SPRING_CLOUD_CONFIG_REQUEST_TIMEOUT", 1e4)
+  };
+}
+function parseHeaders(env) {
+  const prefix = "SPRING_CLOUD_CONFIG_HEADERS_";
+  const headers = {};
+  let hasHeaders = false;
+  for (const [key, value] of Object.entries(env)) {
+    if (key.startsWith(prefix) && value !== void 0 && value !== "") {
+      const headerName = key.substring(prefix.length).split("_").map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()).join("-");
+      headers[headerName] = value;
+      hasHeaders = true;
+    }
+  }
+  return hasHeaders ? headers : void 0;
+}
+function envBool(env, key, defaultValue) {
+  const val = env[key];
+  if (val === void 0 || val === "") return defaultValue;
+  return val.toLowerCase() === "true";
+}
+function envInt(env, key, defaultValue) {
+  const val = env[key];
+  if (val === void 0 || val === "") return defaultValue;
+  const parsed = parseInt(val, 10);
+  return isNaN(parsed) ? defaultValue : parsed;
+}
+function envFloat(env, key, defaultValue) {
+  const val = env[key];
+  if (val === void 0 || val === "") return defaultValue;
+  const parsed = parseFloat(val);
+  return isNaN(parsed) ? defaultValue : parsed;
+}
+
+// src/logger.ts
+var LOG_LEVELS = { debug: 0, info: 1, warn: 2, error: 3, silent: 4 };
+function getLogLevel() {
+  const level = (process.env.SPRING_CLOUD_CONFIG_LOG_LEVEL ?? "info").toLowerCase();
+  return level in LOG_LEVELS ? level : "info";
+}
+function createLogger(scope) {
+  const prefix = `[@trueburn/spring-config-client:${scope}]`;
+  const shouldLog = (level) => {
+    return LOG_LEVELS[level] >= LOG_LEVELS[getLogLevel()];
+  };
+  return {
+    debug: (msg) => shouldLog("debug") && console.debug(`${prefix} ${msg}`),
+    info: (msg) => shouldLog("info") && console.info(`${prefix} ${msg}`),
+    warn: (msg) => shouldLog("warn") && console.warn(`${prefix} ${msg}`),
+    error: (msg) => shouldLog("error") && console.error(`${prefix} ${msg}`)
+  };
+}
+
+// src/retry.ts
+var log = createLogger("retry");
+async function withRetry(fn, config) {
+  if (!config.enabled) {
+    return fn();
+  }
+  let lastError;
+  let currentInterval = config.interval;
+  for (let attempt = 1; attempt <= config.maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err instanceof Error ? err : new Error(String(err));
+      if (attempt === config.maxAttempts) {
+        log.error(
+          `All ${config.maxAttempts} attempts failed. Last error: ${lastError.message}`
+        );
+        break;
+      }
+      log.warn(
+        `Attempt ${attempt}/${config.maxAttempts} failed: ${lastError.message}. Retrying in ${currentInterval}ms...`
+      );
+      await sleep(currentInterval);
+      currentInterval = Math.min(
+        currentInterval * config.multiplier,
+        config.maxInterval
+      );
+    }
+  }
+  throw lastError;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/client.ts
+var log2 = createLogger("client");
+async function fetchConfig(config) {
+  const url = buildUrl(config);
+  log2.info(`Fetching config from ${url}`);
+  const doFetch = async () => {
+    const headers = {
+      Accept: "application/json"
+    };
+    if (config.auth) {
+      const credentials = Buffer.from(
+        `${config.auth.user}:${config.auth.pass}`
+      ).toString("base64");
+      headers["Authorization"] = `Basic ${credentials}`;
+    }
+    if (config.headers) {
+      Object.assign(headers, config.headers);
+    }
+    const response = await fetch(url, {
+      method: "GET",
+      headers,
+      signal: AbortSignal.timeout(config.requestTimeout)
+    });
+    if (!response.ok) {
+      throw new Error(
+        `Config server returned HTTP ${response.status}: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    log2.info(
+      `Received ${data.propertySources.length} property source(s) for ${data.name} [${data.profiles.join(", ")}]` + (data.version ? ` @ ${data.version.substring(0, 8)}` : "")
+    );
+    if (log2.debug) {
+      for (const source of data.propertySources) {
+        const keyCount = Object.keys(source.source).length;
+        log2.debug(`  -> ${source.name} (${keyCount} properties)`);
+      }
+    }
+    return data.propertySources;
+  };
+  try {
+    return await withRetry(doFetch, config.retry);
+  } catch (err) {
+    const error = err instanceof Error ? err : new Error(String(err));
+    if (config.failFast) {
+      log2.error(`Failed to fetch config (fail-fast enabled): ${error.message}`);
+      throw error;
+    }
+    log2.warn(
+      `Failed to fetch config (fail-fast disabled, continuing without remote config): ${error.message}`
+    );
+    return [];
+  }
+}
+function buildUrl(config) {
+  const base = config.uri.replace(/\/+$/, "");
+  const profileEncoded = config.profile.split(",").map((p) => encodeURIComponent(p.trim())).join(",");
+  return `${base}/${encodeURIComponent(config.name)}/${profileEncoded}/${encodeURIComponent(config.label)}`;
+}
+
+// src/merge.ts
+var log3 = createLogger("merge");
+function mergeAndInject(sources, env = process.env) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const source of sources) {
+    for (const [key, value] of Object.entries(source.source)) {
+      if (!merged.has(key)) {
+        merged.set(key, String(value));
+      }
+    }
+  }
+  log3.info(`Merged ${merged.size} unique properties from ${sources.length} source(s)`);
+  let injected = 0;
+  for (const [dotKey, value] of merged) {
+    const snakeKey = toUpperSnake(dotKey);
+    if (injectIfAbsent(env, dotKey, value)) {
+      injected++;
+    }
+    if (snakeKey !== dotKey) {
+      if (injectIfAbsent(env, snakeKey, value)) {
+        injected++;
+      }
+    }
+  }
+  log3.info(`Injected ${injected} new entries into process.env`);
+  return injected;
+}
+function injectIfAbsent(env, key, value) {
+  if (env[key] !== void 0 && env[key] !== "") {
+    log3.debug(`Skipping "${key}" -- already set in environment`);
+    return false;
+  }
+  env[key] = value;
+  return true;
+}
+function toUpperSnake(key) {
+  return key.replace(/[.-]/g, "_").replace(/\[(\d+)\]/g, "_$1").replace(/_+/g, "_").replace(/^_|_$/g, "").toUpperCase();
+}
+
+// src/bootstrap.ts
+var log4 = createLogger("bootstrap");
+var _bootstrapped = false;
+async function bootstrap(overrides) {
+  const config = { ...resolveConfig(), ...overrides };
+  if (!config.enabled) {
+    log4.info("Config client is disabled (SPRING_CLOUD_CONFIG_ENABLED != true). Skipping.");
+    return {
+      success: true,
+      propertiesInjected: 0,
+      sources: []
+    };
+  }
+  if (_bootstrapped) {
+    log4.warn("Bootstrap has already been called. Skipping duplicate invocation.");
+    return {
+      success: true,
+      propertiesInjected: 0,
+      sources: []
+    };
+  }
+  log4.info(
+    `Bootstrapping config for "${config.name}" [profile=${config.profile}, label=${config.label}] from ${config.uri}`
+  );
+  try {
+    const sources = await fetchConfig(config);
+    if (sources.length === 0) {
+      log4.warn("No property sources returned from config server.");
+      _bootstrapped = true;
+      return {
+        success: true,
+        propertiesInjected: 0,
+        sources: []
+      };
+    }
+    const propertiesInjected = mergeAndInject(sources);
+    _bootstrapped = true;
+    log4.info("Bootstrap complete.");
+    return {
+      success: true,
+      propertiesInjected,
+      sources: sources.map((s) => s.name)
+    };
+  } catch (err) {
+    const error = err instanceof Error ? err : new Error(String(err));
+    log4.error(`Bootstrap failed: ${error.message}`);
+    return {
+      success: false,
+      propertiesInjected: 0,
+      sources: [],
+      error
+    };
+  }
+}
+
+// src/register.ts
+var promise = bootstrap().then((result) => {
+  if (!result.success && result.error) {
+    throw result.error;
+  }
+  return result;
+});
+var register_default = promise;
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register.ts","../src/config.ts","../src/logger.ts","../src/retry.ts","../src/client.ts","../src/merge.ts","../src/bootstrap.ts"],"sourcesContent":["/**\n * Auto-bootstrap entry point for Next.js instrumentation.\n *\n * Usage in your Next.js project's instrumentation.ts:\n *\n * ```typescript\n * export async function register() {\n *   if (process.env.NEXT_RUNTIME === 'nodejs') {\n *     await import('@trueburn/spring-config-client/register');\n *   }\n * }\n * ```\n *\n * This module calls bootstrap() on import, so simply importing it\n * is enough to load remote config into process.env.\n *\n * The default export is a promise that resolves when bootstrap completes,\n * which allows `await import(...)` to wait for the config to be loaded.\n */\n\nimport { bootstrap } from \"./bootstrap.js\";\n\nconst promise = bootstrap().then((result) => {\n  if (!result.success && result.error) {\n    throw result.error;\n  }\n  return result;\n});\n\nexport default promise;\n","import type { ClientConfig } from \"./types.js\";\n\n/**\n * Resolves the client configuration from environment variables.\n *\n * Uses the SPRING_CLOUD_CONFIG_* prefix to stay consistent with\n * Spring Boot conventions -- teams set the same env var names\n * regardless of whether the service is JVM or Node.\n */\nexport function resolveConfig(env: Record<string, string | undefined> = process.env): ClientConfig {\n  const auth = env.SPRING_CLOUD_CONFIG_AUTH_USER\n    ? {\n        user: env.SPRING_CLOUD_CONFIG_AUTH_USER,\n        pass: env.SPRING_CLOUD_CONFIG_AUTH_PASS ?? \"\",\n      }\n    : undefined;\n\n  return {\n    enabled: envBool(env, \"SPRING_CLOUD_CONFIG_ENABLED\", false),\n    uri: env.SPRING_CLOUD_CONFIG_URI ?? \"http://localhost:8888\",\n    name: env.SPRING_CLOUD_CONFIG_NAME ?? \"application\",\n    profile: env.SPRING_CLOUD_CONFIG_PROFILE ?? \"default\",\n    label: env.SPRING_CLOUD_CONFIG_LABEL ?? \"main\",\n    failFast: envBool(env, \"SPRING_CLOUD_CONFIG_FAIL_FAST\", false),\n    auth,\n    retry: {\n      enabled: envBool(env, \"SPRING_CLOUD_CONFIG_RETRY_ENABLED\", false),\n      maxAttempts: envInt(env, \"SPRING_CLOUD_CONFIG_RETRY_MAX_ATTEMPTS\", 5),\n      interval: envInt(env, \"SPRING_CLOUD_CONFIG_RETRY_INTERVAL\", 1000),\n      multiplier: envFloat(env, \"SPRING_CLOUD_CONFIG_RETRY_MULTIPLIER\", 1.5),\n      maxInterval: envInt(env, \"SPRING_CLOUD_CONFIG_RETRY_MAX_INTERVAL\", 30000),\n    },\n    headers: parseHeaders(env),\n    requestTimeout: envInt(env, \"SPRING_CLOUD_CONFIG_REQUEST_TIMEOUT\", 10000),\n  };\n}\n\n/**\n * Parses custom headers from SPRING_CLOUD_CONFIG_HEADERS_* env vars.\n *\n * Strips the prefix, replaces underscores with hyphens, and title-cases each segment.\n *\n * Examples:\n *   SPRING_CLOUD_CONFIG_HEADERS_AUTHORIZATION=Bearer tok → { Authorization: \"Bearer tok\" }\n *   SPRING_CLOUD_CONFIG_HEADERS_X_CUSTOM_HEADER=val     → { \"X-Custom-Header\": \"val\" }\n */\nfunction parseHeaders(\n  env: Record<string, string | undefined>\n): Record<string, string> | undefined {\n  const prefix = \"SPRING_CLOUD_CONFIG_HEADERS_\";\n  const headers: Record<string, string> = {};\n  let hasHeaders = false;\n\n  for (const [key, value] of Object.entries(env)) {\n    if (key.startsWith(prefix) && value !== undefined && value !== \"\") {\n      const headerName = key\n        .substring(prefix.length)\n        .split(\"_\")\n        .map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())\n        .join(\"-\");\n      headers[headerName] = value;\n      hasHeaders = true;\n    }\n  }\n\n  return hasHeaders ? headers : undefined;\n}\n\nfunction envBool(\n  env: Record<string, string | undefined>,\n  key: string,\n  defaultValue: boolean\n): boolean {\n  const val = env[key];\n  if (val === undefined || val === \"\") return defaultValue;\n  return val.toLowerCase() === \"true\";\n}\n\nfunction envInt(\n  env: Record<string, string | undefined>,\n  key: string,\n  defaultValue: number\n): number {\n  const val = env[key];\n  if (val === undefined || val === \"\") return defaultValue;\n  const parsed = parseInt(val, 10);\n  return isNaN(parsed) ? defaultValue : parsed;\n}\n\nfunction envFloat(\n  env: Record<string, string | undefined>,\n  key: string,\n  defaultValue: number\n): number {\n  const val = env[key];\n  if (val === undefined || val === \"\") return defaultValue;\n  const parsed = parseFloat(val);\n  return isNaN(parsed) ? defaultValue : parsed;\n}\n","/**\n * Minimal logger with a consistent prefix.\n * Keeps things simple -- no external logging dependency.\n * Respects SPRING_CLOUD_CONFIG_LOG_LEVEL env var (debug, info, warn, error).\n */\n\nconst LOG_LEVELS = { debug: 0, info: 1, warn: 2, error: 3, silent: 4 } as const;\ntype LogLevel = keyof typeof LOG_LEVELS;\n\nfunction getLogLevel(): LogLevel {\n  const level = (\n    process.env.SPRING_CLOUD_CONFIG_LOG_LEVEL ?? \"info\"\n  ).toLowerCase() as LogLevel;\n  return level in LOG_LEVELS ? level : \"info\";\n}\n\nexport interface Logger {\n  debug: (msg: string) => void;\n  info: (msg: string) => void;\n  warn: (msg: string) => void;\n  error: (msg: string) => void;\n}\n\nexport function createLogger(scope: string): Logger {\n  const prefix = `[@trueburn/spring-config-client:${scope}]`;\n\n  const shouldLog = (level: LogLevel): boolean => {\n    return LOG_LEVELS[level] >= LOG_LEVELS[getLogLevel()];\n  };\n\n  return {\n    debug: (msg: string) => shouldLog(\"debug\") && console.debug(`${prefix} ${msg}`),\n    info: (msg: string) => shouldLog(\"info\") && console.info(`${prefix} ${msg}`),\n    warn: (msg: string) => shouldLog(\"warn\") && console.warn(`${prefix} ${msg}`),\n    error: (msg: string) => shouldLog(\"error\") && console.error(`${prefix} ${msg}`),\n  };\n}\n","import type { RetryConfig } from \"./types.js\";\nimport { createLogger } from \"./logger.js\";\n\nconst log = createLogger(\"retry\");\n\n/**\n * Executes an async function with exponential backoff retry.\n *\n * The interval doubles (x multiplier) after each attempt, capped at maxInterval.\n * If all attempts fail, the last error is thrown.\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  config: RetryConfig\n): Promise<T> {\n  if (!config.enabled) {\n    return fn();\n  }\n\n  let lastError: Error | undefined;\n  let currentInterval = config.interval;\n\n  for (let attempt = 1; attempt <= config.maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err instanceof Error ? err : new Error(String(err));\n\n      if (attempt === config.maxAttempts) {\n        log.error(\n          `All ${config.maxAttempts} attempts failed. Last error: ${lastError.message}`\n        );\n        break;\n      }\n\n      log.warn(\n        `Attempt ${attempt}/${config.maxAttempts} failed: ${lastError.message}. ` +\n          `Retrying in ${currentInterval}ms...`\n      );\n\n      await sleep(currentInterval);\n      currentInterval = Math.min(\n        currentInterval * config.multiplier,\n        config.maxInterval\n      );\n    }\n  }\n\n  throw lastError;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type { ClientConfig, ConfigServerResponse, PropertySource } from \"./types.js\";\nimport { withRetry } from \"./retry.js\";\nimport { createLogger } from \"./logger.js\";\n\nconst log = createLogger(\"client\");\n\n/**\n * Fetches configuration from the Spring Cloud Config Server.\n *\n * Calls: GET {uri}/{name}/{profile}/{label}\n *\n * Returns the ordered list of property sources (most specific first).\n * If the server is unreachable and failFast is false, returns an empty array.\n */\nexport async function fetchConfig(config: ClientConfig): Promise<PropertySource[]> {\n  const url = buildUrl(config);\n\n  log.info(`Fetching config from ${url}`);\n\n  const doFetch = async (): Promise<PropertySource[]> => {\n    const headers: Record<string, string> = {\n      Accept: \"application/json\",\n    };\n\n    if (config.auth) {\n      const credentials = Buffer.from(\n        `${config.auth.user}:${config.auth.pass}`\n      ).toString(\"base64\");\n      headers[\"Authorization\"] = `Basic ${credentials}`;\n    }\n\n    if (config.headers) {\n      Object.assign(headers, config.headers);\n    }\n\n    const response = await fetch(url, {\n      method: \"GET\",\n      headers,\n      signal: AbortSignal.timeout(config.requestTimeout),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Config server returned HTTP ${response.status}: ${response.statusText}`\n      );\n    }\n\n    const data = (await response.json()) as ConfigServerResponse;\n\n    log.info(\n      `Received ${data.propertySources.length} property source(s) ` +\n        `for ${data.name} [${data.profiles.join(\", \")}]` +\n        (data.version ? ` @ ${data.version.substring(0, 8)}` : \"\")\n    );\n\n    if (log.debug) {\n      for (const source of data.propertySources) {\n        const keyCount = Object.keys(source.source).length;\n        log.debug(`  -> ${source.name} (${keyCount} properties)`);\n      }\n    }\n\n    return data.propertySources;\n  };\n\n  try {\n    return await withRetry(doFetch, config.retry);\n  } catch (err) {\n    const error = err instanceof Error ? err : new Error(String(err));\n\n    if (config.failFast) {\n      log.error(`Failed to fetch config (fail-fast enabled): ${error.message}`);\n      throw error;\n    }\n\n    log.warn(\n      `Failed to fetch config (fail-fast disabled, continuing without remote config): ${error.message}`\n    );\n    return [];\n  }\n}\n\n/**\n * Builds the config server URL.\n *\n * For multi-profile support, each profile segment is encoded individually\n * while commas are preserved (Spring Cloud Config Server expects unencoded commas).\n */\nfunction buildUrl(config: ClientConfig): string {\n  const base = config.uri.replace(/\\/+$/, \"\");\n  const profileEncoded = config.profile\n    .split(\",\")\n    .map((p) => encodeURIComponent(p.trim()))\n    .join(\",\");\n  return `${base}/${encodeURIComponent(config.name)}/${profileEncoded}/${encodeURIComponent(config.label)}`;\n}\n","import type { PropertySource } from \"./types.js\";\nimport { createLogger } from \"./logger.js\";\n\nconst log = createLogger(\"merge\");\n\n/**\n * Merges property sources and injects them into process.env.\n *\n * Precedence (highest to lowest):\n *   1. Existing env vars (VSO secrets, K8s ConfigMaps, etc.) -- NEVER overwritten\n *   2. Most specific property source (first in the array from config server)\n *   3. Less specific property sources\n *\n * For each property, both formats are injected:\n *   - Dot notation as-is:     \"app.database.host\"\n *   - UPPER_SNAKE_CASE:       \"APP_DATABASE_HOST\"\n *\n * Returns the number of new properties injected.\n */\nexport function mergeAndInject(\n  sources: PropertySource[],\n  env: Record<string, string | undefined> = process.env\n): number {\n  // Merge sources: most specific first -> iterate in order, first write wins\n  const merged = new Map<string, string>();\n\n  for (const source of sources) {\n    for (const [key, value] of Object.entries(source.source)) {\n      if (!merged.has(key)) {\n        merged.set(key, String(value));\n      }\n    }\n  }\n\n  log.info(`Merged ${merged.size} unique properties from ${sources.length} source(s)`);\n\n  let injected = 0;\n\n  for (const [dotKey, value] of merged) {\n    const snakeKey = toUpperSnake(dotKey);\n\n    // Dot notation -- only if not already set\n    if (injectIfAbsent(env, dotKey, value)) {\n      injected++;\n    }\n\n    // UPPER_SNAKE -- only if different from dot key and not already set\n    if (snakeKey !== dotKey) {\n      if (injectIfAbsent(env, snakeKey, value)) {\n        injected++;\n      }\n    }\n  }\n\n  log.info(`Injected ${injected} new entries into process.env`);\n\n  return injected;\n}\n\n/**\n * Injects a value into the env object only if the key is not already set.\n * Returns true if the value was injected, false if it was skipped.\n */\nfunction injectIfAbsent(\n  env: Record<string, string | undefined>,\n  key: string,\n  value: string\n): boolean {\n  if (env[key] !== undefined && env[key] !== \"\") {\n    log.debug(`Skipping \"${key}\" -- already set in environment`);\n    return false;\n  }\n  env[key] = value;\n  return true;\n}\n\n/**\n * Converts a dot-notation or kebab-case property key to UPPER_SNAKE_CASE.\n *\n * Examples:\n *   \"app.database.host\"      -> \"APP_DATABASE_HOST\"\n *   \"app.feature.dark-mode\"  -> \"APP_FEATURE_DARK_MODE\"\n *   \"server.port\"            -> \"SERVER_PORT\"\n *   \"app.list[0].name\"       -> \"APP_LIST_0_NAME\"\n */\nexport function toUpperSnake(key: string): string {\n  return key\n    .replace(/[.-]/g, \"_\")     // dots and hyphens -> underscores\n    .replace(/\\[(\\d+)\\]/g, \"_$1\") // array notation [0] -> _0\n    .replace(/_+/g, \"_\")       // collapse multiple underscores\n    .replace(/^_|_$/g, \"\")     // trim leading/trailing underscores\n    .toUpperCase();\n}\n","import type { BootstrapResult, ClientConfig } from \"./types.js\";\nimport { resolveConfig } from \"./config.js\";\nimport { fetchConfig } from \"./client.js\";\nimport { mergeAndInject } from \"./merge.js\";\nimport { createLogger } from \"./logger.js\";\n\nconst log = createLogger(\"bootstrap\");\n\nlet _bootstrapped = false;\n\n/**\n * Bootstraps the application by fetching remote config from the\n * Spring Cloud Config Server and injecting it into process.env.\n *\n * This should be called as early as possible in the application lifecycle.\n * For Next.js, call it in `instrumentation.ts` inside the `register()` function.\n * For Express/Fastify, call it before starting the HTTP server.\n *\n * If SPRING_CLOUD_CONFIG_ENABLED is not \"true\", this is a no-op.\n *\n * Existing env vars (from VSO, K8s ConfigMaps, etc.) are never overwritten.\n *\n * @param overrides - Optional partial config to override env-based resolution (useful for testing)\n * @returns Result of the bootstrap process\n *\n * @example\n * ```typescript\n * // Next.js instrumentation.ts\n * export async function register() {\n *   if (process.env.NEXT_RUNTIME === 'nodejs') {\n *     const { bootstrap } = require('@trueburn/spring-config-client');\n *     await bootstrap();\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Express / Fastify\n * import { bootstrap } from '@trueburn/spring-config-client';\n *\n * async function main() {\n *   await bootstrap();\n *   // process.env now has remote config\n *   const app = express();\n *   app.listen(process.env.SERVER_PORT ?? 3000);\n * }\n * main();\n * ```\n */\nexport async function bootstrap(\n  overrides?: Partial<ClientConfig>\n): Promise<BootstrapResult> {\n  const config = { ...resolveConfig(), ...overrides };\n\n  if (!config.enabled) {\n    log.info(\"Config client is disabled (SPRING_CLOUD_CONFIG_ENABLED != true). Skipping.\");\n    return {\n      success: true,\n      propertiesInjected: 0,\n      sources: [],\n    };\n  }\n\n  if (_bootstrapped) {\n    log.warn(\"Bootstrap has already been called. Skipping duplicate invocation.\");\n    return {\n      success: true,\n      propertiesInjected: 0,\n      sources: [],\n    };\n  }\n\n  log.info(\n    `Bootstrapping config for \"${config.name}\" ` +\n      `[profile=${config.profile}, label=${config.label}] ` +\n      `from ${config.uri}`\n  );\n\n  try {\n    const sources = await fetchConfig(config);\n\n    if (sources.length === 0) {\n      log.warn(\"No property sources returned from config server.\");\n      _bootstrapped = true;\n      return {\n        success: true,\n        propertiesInjected: 0,\n        sources: [],\n      };\n    }\n\n    const propertiesInjected = mergeAndInject(sources);\n    _bootstrapped = true;\n\n    log.info(\"Bootstrap complete.\");\n\n    return {\n      success: true,\n      propertiesInjected,\n      sources: sources.map((s) => s.name),\n    };\n  } catch (err) {\n    const error = err instanceof Error ? err : new Error(String(err));\n\n    // If failFast is true, fetchConfig already threw -- this re-throws\n    // If failFast is false, fetchConfig returned [] -- so we won't get here\n    // But just in case of unexpected errors:\n    log.error(`Bootstrap failed: ${error.message}`);\n\n    return {\n      success: false,\n      propertiesInjected: 0,\n      sources: [],\n      error,\n    };\n  }\n}\n\n/**\n * Resets the bootstrap state. Only useful for testing.\n */\nexport function _resetBootstrap(): void {\n  _bootstrapped = false;\n}\n"],"mappings":"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","names":["log","log","log"]}

package/dist/register.mjs

@@ -0,0 +1,16 @@
+import {
+  bootstrap
+} from "./chunk-E3W7NEIV.mjs";
+
+// src/register.ts
+var promise = bootstrap().then((result) => {
+  if (!result.success && result.error) {
+    throw result.error;
+  }
+  return result;
+});
+var register_default = promise;
+export {
+  register_default as default
+};
+//# sourceMappingURL=register.mjs.map

package/dist/register.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/register.ts"],"sourcesContent":["/**\n * Auto-bootstrap entry point for Next.js instrumentation.\n *\n * Usage in your Next.js project's instrumentation.ts:\n *\n * ```typescript\n * export async function register() {\n *   if (process.env.NEXT_RUNTIME === 'nodejs') {\n *     await import('@trueburn/spring-config-client/register');\n *   }\n * }\n * ```\n *\n * This module calls bootstrap() on import, so simply importing it\n * is enough to load remote config into process.env.\n *\n * The default export is a promise that resolves when bootstrap completes,\n * which allows `await import(...)` to wait for the config to be loaded.\n */\n\nimport { bootstrap } from \"./bootstrap.js\";\n\nconst promise = bootstrap().then((result) => {\n  if (!result.success && result.error) {\n    throw result.error;\n  }\n  return result;\n});\n\nexport default promise;\n"],"mappings":";;;;;AAsBA,IAAM,UAAU,UAAU,EAAE,KAAK,CAAC,WAAW;AAC3C,MAAI,CAAC,OAAO,WAAW,OAAO,OAAO;AACnC,UAAM,OAAO;AAAA,EACf;AACA,SAAO;AACT,CAAC;AAED,IAAO,mBAAQ;","names":[]}

package/dist/types-Cv_lvWI3.d.mts

@@ -0,0 +1,99 @@
+/**
+ * Configuration options for the config client, resolved from environment variables.
+ *
+ * Environment variable mapping:
+ *   SPRING_CLOUD_CONFIG_ENABLED       -- Enable/disable the client (default: false)
+ *   SPRING_CLOUD_CONFIG_URI           -- Config server base URL (default: http://localhost:8888)
+ *   SPRING_CLOUD_CONFIG_NAME          -- Application name (default: application)
+ *   SPRING_CLOUD_CONFIG_PROFILE       -- Active profile(s), comma-separated (default: default)
+ *   SPRING_CLOUD_CONFIG_LABEL         -- Git branch/label (default: main)
+ *   SPRING_CLOUD_CONFIG_FAIL_FAST     -- Throw on fetch failure (default: false)
+ *   SPRING_CLOUD_CONFIG_AUTH_USER     -- Basic auth username
+ *   SPRING_CLOUD_CONFIG_AUTH_PASS     -- Basic auth password
+ *   SPRING_CLOUD_CONFIG_RETRY_ENABLED -- Enable retry with backoff (default: false)
+ *   SPRING_CLOUD_CONFIG_RETRY_MAX_ATTEMPTS   -- Max retry attempts (default: 5)
+ *   SPRING_CLOUD_CONFIG_RETRY_INTERVAL       -- Initial retry interval in ms (default: 1000)
+ *   SPRING_CLOUD_CONFIG_RETRY_MULTIPLIER     -- Backoff multiplier (default: 1.5)
+ *   SPRING_CLOUD_CONFIG_RETRY_MAX_INTERVAL   -- Max retry interval in ms (default: 30000)
+ *   SPRING_CLOUD_CONFIG_REQUEST_TIMEOUT      -- Request timeout in ms (default: 10000)
+ *   SPRING_CLOUD_CONFIG_HEADERS_<NAME>       -- Custom headers (e.g. SPRING_CLOUD_CONFIG_HEADERS_AUTHORIZATION)
+ */
+interface ClientConfig {
+    /** Whether the config client is enabled */
+    enabled: boolean;
+    /** Config server base URL */
+    uri: string;
+    /** Application name used to resolve config on the server */
+    name: string;
+    /** Active profile(s), comma-separated (e.g. "production" or "production,eu-west") */
+    profile: string;
+    /** Git branch or label */
+    label: string;
+    /** If true, throw an error when the config server is unreachable */
+    failFast: boolean;
+    /** Basic auth credentials */
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    /** Retry configuration */
+    retry: RetryConfig;
+    /** Custom headers to send with the config server request */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds (default: 10000) */
+    requestTimeout: number;
+}
+interface RetryConfig {
+    /** Whether retry is enabled */
+    enabled: boolean;
+    /** Maximum number of retry attempts */
+    maxAttempts: number;
+    /** Initial interval between retries in ms */
+    interval: number;
+    /** Multiplier applied to interval after each attempt */
+    multiplier: number;
+    /** Maximum interval between retries in ms */
+    maxInterval: number;
+}
+/**
+ * A single property source returned by the Spring Cloud Config Server.
+ * Each source represents a config file (e.g. my-app-production.yml).
+ */
+interface PropertySource {
+    /** Source identifier (usually the file path in the git repo) */
+    name: string;
+    /** Flat key-value map of resolved properties (dot-notation keys) */
+    source: Record<string, string | number | boolean>;
+}
+/**
+ * The full response from the Config Server's /{name}/{profile}/{label} endpoint.
+ */
+interface ConfigServerResponse {
+    /** Application name */
+    name: string;
+    /** Active profiles */
+    profiles: string[];
+    /** Git label */
+    label: string;
+    /** Git version/commit hash */
+    version?: string;
+    /** State identifier */
+    state?: string;
+    /** Ordered property sources (most specific first) */
+    propertySources: PropertySource[];
+}
+/**
+ * Result of the bootstrap process.
+ */
+interface BootstrapResult {
+    /** Whether config was fetched successfully */
+    success: boolean;
+    /** Number of properties injected into process.env */
+    propertiesInjected: number;
+    /** Property sources that were loaded (names only) */
+    sources: string[];
+    /** Error if the bootstrap failed and failFast is false */
+    error?: Error;
+}
+
+export type { BootstrapResult as B, ClientConfig as C, PropertySource as P, RetryConfig as R, ConfigServerResponse as a };

package/dist/types-Cv_lvWI3.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Configuration options for the config client, resolved from environment variables.
+ *
+ * Environment variable mapping:
+ *   SPRING_CLOUD_CONFIG_ENABLED       -- Enable/disable the client (default: false)
+ *   SPRING_CLOUD_CONFIG_URI           -- Config server base URL (default: http://localhost:8888)
+ *   SPRING_CLOUD_CONFIG_NAME          -- Application name (default: application)
+ *   SPRING_CLOUD_CONFIG_PROFILE       -- Active profile(s), comma-separated (default: default)
+ *   SPRING_CLOUD_CONFIG_LABEL         -- Git branch/label (default: main)
+ *   SPRING_CLOUD_CONFIG_FAIL_FAST     -- Throw on fetch failure (default: false)
+ *   SPRING_CLOUD_CONFIG_AUTH_USER     -- Basic auth username
+ *   SPRING_CLOUD_CONFIG_AUTH_PASS     -- Basic auth password
+ *   SPRING_CLOUD_CONFIG_RETRY_ENABLED -- Enable retry with backoff (default: false)
+ *   SPRING_CLOUD_CONFIG_RETRY_MAX_ATTEMPTS   -- Max retry attempts (default: 5)
+ *   SPRING_CLOUD_CONFIG_RETRY_INTERVAL       -- Initial retry interval in ms (default: 1000)
+ *   SPRING_CLOUD_CONFIG_RETRY_MULTIPLIER     -- Backoff multiplier (default: 1.5)
+ *   SPRING_CLOUD_CONFIG_RETRY_MAX_INTERVAL   -- Max retry interval in ms (default: 30000)
+ *   SPRING_CLOUD_CONFIG_REQUEST_TIMEOUT      -- Request timeout in ms (default: 10000)
+ *   SPRING_CLOUD_CONFIG_HEADERS_<NAME>       -- Custom headers (e.g. SPRING_CLOUD_CONFIG_HEADERS_AUTHORIZATION)
+ */
+interface ClientConfig {
+    /** Whether the config client is enabled */
+    enabled: boolean;
+    /** Config server base URL */
+    uri: string;
+    /** Application name used to resolve config on the server */
+    name: string;
+    /** Active profile(s), comma-separated (e.g. "production" or "production,eu-west") */
+    profile: string;
+    /** Git branch or label */
+    label: string;
+    /** If true, throw an error when the config server is unreachable */
+    failFast: boolean;
+    /** Basic auth credentials */
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    /** Retry configuration */
+    retry: RetryConfig;
+    /** Custom headers to send with the config server request */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds (default: 10000) */
+    requestTimeout: number;
+}
+interface RetryConfig {
+    /** Whether retry is enabled */
+    enabled: boolean;
+    /** Maximum number of retry attempts */
+    maxAttempts: number;
+    /** Initial interval between retries in ms */
+    interval: number;
+    /** Multiplier applied to interval after each attempt */
+    multiplier: number;
+    /** Maximum interval between retries in ms */
+    maxInterval: number;
+}
+/**
+ * A single property source returned by the Spring Cloud Config Server.
+ * Each source represents a config file (e.g. my-app-production.yml).
+ */
+interface PropertySource {
+    /** Source identifier (usually the file path in the git repo) */
+    name: string;
+    /** Flat key-value map of resolved properties (dot-notation keys) */
+    source: Record<string, string | number | boolean>;
+}
+/**
+ * The full response from the Config Server's /{name}/{profile}/{label} endpoint.
+ */
+interface ConfigServerResponse {
+    /** Application name */
+    name: string;
+    /** Active profiles */
+    profiles: string[];
+    /** Git label */
+    label: string;
+    /** Git version/commit hash */
+    version?: string;
+    /** State identifier */
+    state?: string;
+    /** Ordered property sources (most specific first) */
+    propertySources: PropertySource[];
+}
+/**
+ * Result of the bootstrap process.
+ */
+interface BootstrapResult {
+    /** Whether config was fetched successfully */
+    success: boolean;
+    /** Number of properties injected into process.env */
+    propertiesInjected: number;
+    /** Property sources that were loaded (names only) */
+    sources: string[];
+    /** Error if the bootstrap failed and failFast is false */
+    error?: Error;
+}
+
+export type { BootstrapResult as B, ClientConfig as C, PropertySource as P, RetryConfig as R, ConfigServerResponse as a };

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@trueburn/spring-config-client",
+  "version": "0.1.0",
+  "description": "Spring Cloud Config Server client for Node.js/Next.js -- bootstraps remote configuration into process.env at startup",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TrueBurn/node-spring-config-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TrueBurn/node-spring-config-client/issues"
+  },
+  "homepage": "https://github.com/TrueBurn/node-spring-config-client#readme",
+  "author": "trueburn",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.mjs",
+      "require": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "format": "prettier --write 'src/**/*.ts'",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "spring-cloud-config",
+    "config-server",
+    "nextjs",
+    "nodejs",
+    "configuration",
+    "bootstrap",
+    "env"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}