@smplkit/sdk 1.6.0 → 1.6.2

package/dist/index.d.cts

@@ -1357,13 +1357,15 @@ interface SmplClientOptions {
     apiKey?: string;
     /**
      * The environment to connect to (e.g. `"production"`, `"staging"`).
-     * When omitted, resolved from the `SMPLKIT_ENVIRONMENT` environment variable.
+     * When omitted, resolved from the `SMPLKIT_ENVIRONMENT` environment variable
+     * or the `~/.smplkit` configuration file.
      */
     environment?: string;
     /**
      * Service name. The SDK automatically registers the service as a
      * context instance and includes it in flag evaluation context.
-     * When omitted, resolved from the `SMPLKIT_SERVICE` environment variable.
+     * When omitted, resolved from the `SMPLKIT_SERVICE` environment variable
+     * or the `~/.smplkit` configuration file.
      */
     service?: string;
     /**
@@ -1378,17 +1380,28 @@ interface SmplClientOptions {
      */
     disableTelemetry?: boolean;
     /**
-     * Base domain for all smplkit service URLs.
-     * Override for local development (e.g. `"localhost"`).
-     * @default "smplkit.com"
+     * Configuration profile to use from `~/.smplkit`.
+     * When omitted, resolved from `SMPLKIT_PROFILE` env var, falling back to `"default"`.
+     */
+    profile?: string;
+    /**
+     * Base domain for all service URLs.
+     * When omitted, resolved from `SMPLKIT_BASE_DOMAIN` env var or config file,
+     * falling back to `"smplkit.com"`.
      */
     baseDomain?: string;
     /**
-     * URL scheme used when constructing service URLs.
-     * Override for local development (e.g. `"http"`).
-     * @default "https"
+     * URL scheme for service URLs (`"https"` or `"http"`).
+     * When omitted, resolved from `SMPLKIT_SCHEME` env var or config file,
+     * falling back to `"https"`.
      */
     scheme?: string;
+    /**
+     * Enable debug logging to stderr.
+     * When omitted, resolved from `SMPLKIT_DEBUG` env var or config file,
+     * falling back to `false`.
+     */
+    debug?: boolean;
 }
 /**
  * Entry point for the smplkit TypeScript SDK.

package/dist/index.d.ts

@@ -1357,13 +1357,15 @@ interface SmplClientOptions {
     apiKey?: string;
     /**
      * The environment to connect to (e.g. `"production"`, `"staging"`).
-     * When omitted, resolved from the `SMPLKIT_ENVIRONMENT` environment variable.
+     * When omitted, resolved from the `SMPLKIT_ENVIRONMENT` environment variable
+     * or the `~/.smplkit` configuration file.
      */
     environment?: string;
     /**
      * Service name. The SDK automatically registers the service as a
      * context instance and includes it in flag evaluation context.
-     * When omitted, resolved from the `SMPLKIT_SERVICE` environment variable.
+     * When omitted, resolved from the `SMPLKIT_SERVICE` environment variable
+     * or the `~/.smplkit` configuration file.
      */
     service?: string;
     /**
@@ -1378,17 +1380,28 @@ interface SmplClientOptions {
      */
     disableTelemetry?: boolean;
     /**
-     * Base domain for all smplkit service URLs.
-     * Override for local development (e.g. `"localhost"`).
-     * @default "smplkit.com"
+     * Configuration profile to use from `~/.smplkit`.
+     * When omitted, resolved from `SMPLKIT_PROFILE` env var, falling back to `"default"`.
+     */
+    profile?: string;
+    /**
+     * Base domain for all service URLs.
+     * When omitted, resolved from `SMPLKIT_BASE_DOMAIN` env var or config file,
+     * falling back to `"smplkit.com"`.
      */
     baseDomain?: string;
     /**
-     * URL scheme used when constructing service URLs.
-     * Override for local development (e.g. `"http"`).
-     * @default "https"
+     * URL scheme for service URLs (`"https"` or `"http"`).
+     * When omitted, resolved from `SMPLKIT_SCHEME` env var or config file,
+     * falling back to `"https"`.
      */
     scheme?: string;
+    /**
+     * Enable debug logging to stderr.
+     * When omitted, resolved from `SMPLKIT_DEBUG` env var or config file,
+     * falling back to `false`.
+     */
+    debug?: boolean;
 }
 /**
  * Entry point for the smplkit TypeScript SDK.

package/dist/index.js

@@ -17043,7 +17043,7 @@ var ConfigClient = class {
   /** @internal */
   _apiKey;
   /** @internal */
-  _baseUrl = BASE_URL;
+  _baseUrl;
   /** @internal */
   _http;
   /** @internal — returns the shared WebSocket for real-time updates. */
@@ -17058,9 +17058,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 = createClient({
-      baseUrl: baseUrl ?? BASE_URL,
+      baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -17750,7 +17752,7 @@ var FlagsClient = class {
   /** @internal */
   _apiKey;
   /** @internal */
-  _baseUrl = FLAGS_BASE_URL;
+  _baseUrl;
   /** @internal */
   _http;
   /** @internal */
@@ -17778,6 +17780,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();
@@ -17794,7 +17799,7 @@ var FlagsClient = class {
       }
     };
     this._http = createClient2({
-      baseUrl: flagsBaseUrl ?? FLAGS_BASE_URL,
+      baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -17802,7 +17807,7 @@ var FlagsClient = class {
       fetch: fetchWithTimeout
     });
     this._appHttp = createClient2({
-      baseUrl: appBaseUrl ?? APP_BASE_URL,
+      baseUrl: resolvedAppBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -18686,7 +18691,7 @@ var LoggingClient = class {
   /** @internal */
   _apiKey;
   /** @internal */
-  _baseUrl = LOGGING_BASE_URL;
+  _baseUrl;
   /** @internal */
   _http;
   /** @internal — set by SmplClient after construction. */
@@ -18706,9 +18711,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 = createClient3({
-      baseUrl: baseUrl ?? LOGGING_BASE_URL,
+      baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -19381,59 +19388,117 @@ var SharedWebSocket = class {
   }
 };
 
-// src/resolve.ts
+// src/config.ts
 import { readFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "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 = join(homedir(), ".smplkit");
-  try {
-    const content = 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 = join(homedir(), ".smplkit");
+    const content = 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
@@ -19576,8 +19641,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;
@@ -19597,55 +19660,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 = createClient4({
       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;