@smplkit/sdk 1.6.0 → 1.6.2

package/README.md

@@ -34,28 +34,49 @@ const client3 = new SmplClient();
 
 ## Configuration
 
-The API key is resolved using the following priority:
+All settings are resolved from three sources, in order of precedence:
 
-1. **Explicit argument:** Pass `apiKey` in the constructor options.
-2. **Environment variable:** Set `SMPLKIT_API_KEY`.
-3. **Configuration file:** Add `api_key` under `[default]` in `~/.smplkit`:
+1. **Constructor options** — highest priority, always wins.
+2. **Environment variables** — e.g. `SMPLKIT_API_KEY`, `SMPLKIT_ENVIRONMENT`.
+3. **Configuration file** (`~/.smplkit`) — INI-format with profile support.
+4. **Defaults** — built-in SDK defaults.
+
+### Configuration File
+
+The `~/.smplkit` file supports a `[common]` section (applied to all profiles) and named profiles:
 
 ```ini
-# ~/.smplkit
+[common]
+environment = production
+service = my-app
 
 [default]
-api_key = sk_api_your_key_here
+api_key = sk_api_abc123
+
+[local]
+base_domain = localhost
+scheme = http
+api_key = sk_api_local_xyz
+environment = development
+debug = true
 ```
 
-If none of these are set, the SDK throws `SmplError` with a message listing all three methods.
+### Constructor Examples
 
 ```typescript
+// Use a named profile
+const client = new SmplClient({ profile: "local" });
+
+// Or configure explicitly
 const client = new SmplClient({
   apiKey: "sk_api_...",
-  timeout: 30_000, // default (ms)
+  environment: "production",
+  service: "my-service",
 });
 ```
 
+For the complete configuration reference, see the [Configuration Guide](https://docs.smplkit.com/getting-started/configuration).
+
 ## Config
 
 ### Runtime (resolve config values)

package/dist/index.cjs

@@ -17084,7 +17084,7 @@ var ConfigClient = class {
   /** @internal */
   _apiKey;
   /** @internal */
-  _baseUrl = BASE_URL;
+  _baseUrl;
   /** @internal */
   _http;
   /** @internal — returns the shared WebSocket for real-time updates. */
@@ -17099,9 +17099,11 @@ var ConfigClient = class {
   /** @internal */
   constructor(apiKey, timeout, baseUrl) {
     this._apiKey = apiKey;
+    const resolvedBaseUrl = baseUrl ?? BASE_URL;
+    this._baseUrl = resolvedBaseUrl;
     const ms = timeout ?? 3e4;
     this._http = (0, import_openapi_fetch.default)({
-      baseUrl: baseUrl ?? BASE_URL,
+      baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -17791,7 +17793,7 @@ var FlagsClient = class {
   /** @internal */
   _apiKey;
   /** @internal */
-  _baseUrl = FLAGS_BASE_URL;
+  _baseUrl;
   /** @internal */
   _http;
   /** @internal */
@@ -17819,6 +17821,9 @@ var FlagsClient = class {
   constructor(apiKey, ensureWs, timeout, flagsBaseUrl, appBaseUrl) {
     this._apiKey = apiKey;
     this._ensureWs = ensureWs;
+    const resolvedBaseUrl = flagsBaseUrl ?? FLAGS_BASE_URL;
+    const resolvedAppBaseUrl = appBaseUrl ?? APP_BASE_URL;
+    this._baseUrl = resolvedBaseUrl;
     const ms = timeout ?? 3e4;
     const fetchWithTimeout = async (request) => {
       const controller = new AbortController();
@@ -17835,7 +17840,7 @@ var FlagsClient = class {
       }
     };
     this._http = (0, import_openapi_fetch2.default)({
-      baseUrl: flagsBaseUrl ?? FLAGS_BASE_URL,
+      baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -17843,7 +17848,7 @@ var FlagsClient = class {
       fetch: fetchWithTimeout
     });
     this._appHttp = (0, import_openapi_fetch2.default)({
-      baseUrl: appBaseUrl ?? APP_BASE_URL,
+      baseUrl: resolvedAppBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -18727,7 +18732,7 @@ var LoggingClient = class {
   /** @internal */
   _apiKey;
   /** @internal */
-  _baseUrl = LOGGING_BASE_URL;
+  _baseUrl;
   /** @internal */
   _http;
   /** @internal — set by SmplClient after construction. */
@@ -18747,9 +18752,11 @@ var LoggingClient = class {
   constructor(apiKey, ensureWs, timeout, baseUrl) {
     this._apiKey = apiKey;
     this._ensureWs = ensureWs;
+    const resolvedBaseUrl = baseUrl ?? LOGGING_BASE_URL;
+    this._baseUrl = resolvedBaseUrl;
     const ms = timeout ?? 3e4;
     this._http = (0, import_openapi_fetch3.default)({
-      baseUrl: baseUrl ?? LOGGING_BASE_URL,
+      baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -19422,59 +19429,117 @@ var SharedWebSocket = class {
   }
 };
 
-// src/resolve.ts
+// src/config.ts
 var import_node_fs = require("fs");
 var import_node_os = require("os");
 var import_node_path = require("path");
-function noApiKeyMessage(environment) {
-  return `No API key provided. Set one of:
-  1. Pass apiKey to the constructor
-  2. Set the SMPLKIT_API_KEY environment variable
-  3. Create a ~/.smplkit file with:
-     [${environment}]
-     api_key = your_key_here`;
-}
-function readApiKeyFromConfig(environment) {
-  const configPath = (0, import_node_path.join)((0, import_node_os.homedir)(), ".smplkit");
-  try {
-    const content = (0, import_node_fs.readFileSync)(configPath, "utf-8");
-    let currentSection = null;
-    let envKey;
-    let defaultKey;
-    for (const line of content.split("\n")) {
-      const trimmed = line.trim();
-      if (trimmed === "" || trimmed.startsWith("#")) continue;
-      if (trimmed.startsWith("[")) {
-        const sectionName = trimmed.slice(1, trimmed.indexOf("]")).toLowerCase();
-        currentSection = sectionName;
-        continue;
-      }
-      if (currentSection && trimmed.startsWith("api_key")) {
-        const eqIndex = trimmed.indexOf("=");
-        if (eqIndex !== -1) {
-          const value = trimmed.slice(eqIndex + 1).trim();
-          if (value) {
-            if (currentSection === environment.toLowerCase()) {
-              envKey = value;
-            } else if (currentSection === "default") {
-              defaultKey = value;
-            }
-          }
-        }
+var CONFIG_KEYS = {
+  api_key: "SMPLKIT_API_KEY",
+  base_domain: "SMPLKIT_BASE_DOMAIN",
+  scheme: "SMPLKIT_SCHEME",
+  environment: "SMPLKIT_ENVIRONMENT",
+  service: "SMPLKIT_SERVICE",
+  debug: "SMPLKIT_DEBUG",
+  disable_telemetry: "SMPLKIT_DISABLE_TELEMETRY"
+};
+function parseIniFile(content, profile) {
+  const common = {};
+  const profileValues = {};
+  const sections = /* @__PURE__ */ new Set();
+  let currentSection = null;
+  const lowerProfile = profile.toLowerCase();
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed === "" || trimmed.startsWith("#") || trimmed.startsWith(";")) continue;
+    if (trimmed.startsWith("[")) {
+      const closeBracket = trimmed.indexOf("]");
+      if (closeBracket === -1) continue;
+      currentSection = trimmed.slice(1, closeBracket).trim().toLowerCase();
+      if (currentSection !== "common") {
+        sections.add(currentSection);
       }
+      continue;
     }
-    return envKey ?? defaultKey;
-  } catch {
-    return void 0;
+    if (currentSection === null) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    const value = trimmed.slice(eqIndex + 1).trim();
+    if (!key || !value) continue;
+    if (currentSection === "common") {
+      common[key] = value;
+    } else if (currentSection === lowerProfile) {
+      profileValues[key] = value;
+    }
+  }
+  if (lowerProfile !== "default" && sections.size > 0 && !sections.has(lowerProfile) && Object.keys(profileValues).length === 0) {
+    const available = [...sections].sort().join(", ");
+    throw new SmplError(
+      `Configuration profile "${profile}" not found in ~/.smplkit. Available profiles: ${available}`
+    );
   }
+  return { ...common, ...profileValues };
 }
-function resolveApiKey(explicit, environment) {
-  if (explicit) return explicit;
-  const envVal = process.env.SMPLKIT_API_KEY;
-  if (envVal) return envVal;
-  const fileKey = readApiKeyFromConfig(environment);
-  if (fileKey) return fileKey;
-  throw new SmplError(noApiKeyMessage(environment));
+function parseBool(value, key) {
+  const lower = value.toLowerCase();
+  if (lower === "true" || lower === "1" || lower === "yes") return true;
+  if (lower === "false" || lower === "0" || lower === "no") return false;
+  throw new SmplError(
+    `Invalid boolean value "${value}" for ${key}. Expected true/false, 1/0, or yes/no.`
+  );
+}
+function serviceUrl(scheme, subdomain, baseDomain) {
+  return `${scheme}://${subdomain}.${baseDomain}`;
+}
+var NO_API_KEY_MESSAGE = "No API key provided. Set one of:\n  1. Pass apiKey to the constructor\n  2. Set the SMPLKIT_API_KEY environment variable\n  3. Add api_key to your ~/.smplkit config file";
+var NO_ENVIRONMENT_MESSAGE = "No environment provided. Set one of:\n  1. Pass environment to the constructor\n  2. Set the SMPLKIT_ENVIRONMENT environment variable\n  3. Add environment to your ~/.smplkit config file";
+var NO_SERVICE_MESSAGE = "No service provided. Set one of:\n  1. Pass service in options\n  2. Set the SMPLKIT_SERVICE environment variable\n  3. Add service to your ~/.smplkit config file";
+function resolveConfig(options) {
+  const merged = {
+    scheme: "https",
+    base_domain: "smplkit.com",
+    debug: "false",
+    disable_telemetry: "false"
+  };
+  const profile = options.profile ?? process.env.SMPLKIT_PROFILE ?? "default";
+  try {
+    const configPath = (0, import_node_path.join)((0, import_node_os.homedir)(), ".smplkit");
+    const content = (0, import_node_fs.readFileSync)(configPath, "utf-8");
+    const fileValues = parseIniFile(content, profile);
+    for (const key of Object.keys(CONFIG_KEYS)) {
+      if (fileValues[key]) {
+        merged[key] = fileValues[key];
+      }
+    }
+  } catch (e) {
+    if (e instanceof SmplError) throw e;
+  }
+  for (const [key, envVar] of Object.entries(CONFIG_KEYS)) {
+    const envVal = process.env[envVar];
+    if (envVal) {
+      merged[key] = envVal;
+    }
+  }
+  if (options.apiKey !== void 0) merged.api_key = options.apiKey;
+  if (options.baseDomain !== void 0) merged.base_domain = options.baseDomain;
+  if (options.scheme !== void 0) merged.scheme = options.scheme;
+  if (options.environment !== void 0) merged.environment = options.environment;
+  if (options.service !== void 0) merged.service = options.service;
+  if (options.debug !== void 0) merged.debug = String(options.debug);
+  if (options.disableTelemetry !== void 0)
+    merged.disable_telemetry = String(options.disableTelemetry);
+  if (!merged.api_key) throw new SmplError(NO_API_KEY_MESSAGE);
+  if (!merged.environment) throw new SmplError(NO_ENVIRONMENT_MESSAGE);
+  if (!merged.service) throw new SmplError(NO_SERVICE_MESSAGE);
+  return {
+    apiKey: merged.api_key,
+    baseDomain: merged.base_domain,
+    scheme: merged.scheme,
+    environment: merged.environment,
+    service: merged.service,
+    debug: parseBool(merged.debug, "debug"),
+    disableTelemetry: parseBool(merged.disable_telemetry, "disable_telemetry")
+  };
 }
 
 // src/_metrics.ts
@@ -19617,8 +19682,6 @@ var MetricsReporter = class {
 };
 
 // src/client.ts
-var NO_ENVIRONMENT_MESSAGE = "No environment provided. Set one of:\n  1. Pass environment to the constructor\n  2. Set the SMPLKIT_ENVIRONMENT environment variable";
-var NO_SERVICE_MESSAGE = "No service provided. Set one of:\n  1. Pass service in options\n  2. Set the SMPLKIT_SERVICE environment variable";
 var SmplClient = class {
   /** Client for config management and runtime. */
   config;
@@ -19638,55 +19701,50 @@ var SmplClient = class {
   _appBaseUrl;
   _appHttp;
   constructor(options = {}) {
-    const environment = options.environment || process.env.SMPLKIT_ENVIRONMENT;
-    if (!environment) {
-      throw new SmplError(NO_ENVIRONMENT_MESSAGE);
-    }
-    this._environment = environment;
-    const service = options.service || process.env.SMPLKIT_SERVICE;
-    if (!service) {
-      throw new SmplError(NO_SERVICE_MESSAGE);
-    }
-    this._service = service;
-    const apiKey = resolveApiKey(options.apiKey, environment);
-    this._apiKey = apiKey;
+    const cfg = resolveConfig(options);
+    this._apiKey = cfg.apiKey;
+    this._environment = cfg.environment;
+    this._service = cfg.service;
     this._timeout = options.timeout ?? 3e4;
-    const baseDomain = options.baseDomain ?? "smplkit.com";
-    const scheme = options.scheme ?? "https";
-    const appBaseUrl = `${scheme}://app.${baseDomain}`;
-    const configBaseUrl = `${scheme}://config.${baseDomain}`;
-    const flagsBaseUrl = `${scheme}://flags.${baseDomain}`;
-    const loggingBaseUrl = `${scheme}://logging.${baseDomain}`;
+    const appBaseUrl = serviceUrl(cfg.scheme, "app", cfg.baseDomain);
+    const configBaseUrl = serviceUrl(cfg.scheme, "config", cfg.baseDomain);
+    const flagsBaseUrl = serviceUrl(cfg.scheme, "flags", cfg.baseDomain);
+    const loggingBaseUrl = serviceUrl(cfg.scheme, "logging", cfg.baseDomain);
     this._appBaseUrl = appBaseUrl;
-    const maskedKey = apiKey.length > 14 ? apiKey.slice(0, 10) + "..." + apiKey.slice(-4) : apiKey.slice(0, Math.min(4, apiKey.length)) + "...";
+    const maskedKey = cfg.apiKey.length > 14 ? cfg.apiKey.slice(0, 10) + "..." + cfg.apiKey.slice(-4) : cfg.apiKey.slice(0, Math.min(4, cfg.apiKey.length)) + "...";
     debug(
       "lifecycle",
-      `SmplClient created (api_key=${maskedKey}, environment=${environment}, service=${service})`
+      `SmplClient created (api_key=${maskedKey}, environment=${cfg.environment}, service=${cfg.service})`
     );
     this._appHttp = (0, import_openapi_fetch4.default)({
       baseUrl: appBaseUrl,
       headers: {
-        Authorization: `Bearer ${apiKey}`,
+        Authorization: `Bearer ${cfg.apiKey}`,
         Accept: "application/json"
       }
     });
-    if (!options.disableTelemetry) {
+    if (!cfg.disableTelemetry) {
       this._metrics = new MetricsReporter({
-        apiKey,
+        apiKey: cfg.apiKey,
         environment: this._environment,
         service: this._service,
         appBaseUrl
       });
     }
-    this.config = new ConfigClient(apiKey, this._timeout, configBaseUrl);
+    this.config = new ConfigClient(cfg.apiKey, this._timeout, configBaseUrl);
     this.flags = new FlagsClient(
-      apiKey,
+      cfg.apiKey,
       () => this._ensureWs(),
       this._timeout,
       flagsBaseUrl,
       appBaseUrl
     );
-    this.logging = new LoggingClient(apiKey, () => this._ensureWs(), this._timeout, loggingBaseUrl);
+    this.logging = new LoggingClient(
+      cfg.apiKey,
+      () => this._ensureWs(),
+      this._timeout,
+      loggingBaseUrl
+    );
     this.config._getSharedWs = () => this._ensureWs();
     this.flags._parent = this;
     this.config._parent = this;