@smplkit/sdk 1.5.7 → 1.6.0

package/dist/index.d.cts

@@ -13,6 +13,7 @@ declare class MetricsReporter {
     private readonly _environment;
     private readonly _service;
     private readonly _flushInterval;
+    private readonly _appBaseUrl;
     private _counters;
     private _gauges;
     private _timer;
@@ -22,6 +23,7 @@ declare class MetricsReporter {
         environment: string;
         service: string;
         flushInterval?: number;
+        appBaseUrl?: string;
     });
     record(name: string, value?: number, unit?: string | null, dimensions?: Record<string, string>): void;
     recordGauge(name: string, value: number, unit?: string | null, dimensions?: Record<string, string>): void;
@@ -223,7 +225,7 @@ declare class ConfigClient {
     private _initialized;
     private _listeners;
     /** @internal */
-    constructor(apiKey: string, timeout?: number);
+    constructor(apiKey: string, timeout?: number, baseUrl?: string);
     /** @internal */
     _mgNew(id: string, options?: {
         name?: string;
@@ -922,7 +924,7 @@ declare class FlagsClient {
     /** Management API — CRUD operations on Flag models. */
     readonly management: FlagsManagement;
     /** @internal */
-    constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
+    constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number, flagsBaseUrl?: string, appBaseUrl?: string);
     /** @internal */
     _mgNewBooleanFlag(id: string, options: {
         default: boolean;
@@ -1270,8 +1272,10 @@ declare class LoggingClient {
     private _keyListeners;
     private _adapters;
     private _explicitAdapters;
+    private _loggerBuffer;
+    private _loggerFlushTimer;
     /** @internal */
-    constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
+    constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number, baseUrl?: string);
     /**
      * Register a logging framework adapter.
      *
@@ -1328,6 +1332,8 @@ declare class LoggingClient {
     private _applyLevels;
     /** Called by adapter hooks when a new logger is created in the framework. */
     private _onAdapterNewLogger;
+    /** Flush buffered loggers to the bulk-register endpoint. */
+    private _flushLoggerBuffer;
     private _handleLoggerChanged;
     private _handleGroupChanged;
     private _loggerToModel;
@@ -1371,6 +1377,18 @@ interface SmplClientOptions {
      * @default false
      */
     disableTelemetry?: boolean;
+    /**
+     * Base domain for all smplkit service URLs.
+     * Override for local development (e.g. `"localhost"`).
+     * @default "smplkit.com"
+     */
+    baseDomain?: string;
+    /**
+     * URL scheme used when constructing service URLs.
+     * Override for local development (e.g. `"http"`).
+     * @default "https"
+     */
+    scheme?: string;
 }
 /**
  * Entry point for the smplkit TypeScript SDK.
@@ -1410,6 +1428,7 @@ declare class SmplClient {
     /** @internal */
     readonly _metrics: MetricsReporter | null;
     private readonly _timeout;
+    private readonly _appBaseUrl;
     private readonly _appHttp;
     constructor(options?: SmplClientOptions);
     /** @internal */

package/dist/index.d.ts

@@ -13,6 +13,7 @@ declare class MetricsReporter {
     private readonly _environment;
     private readonly _service;
     private readonly _flushInterval;
+    private readonly _appBaseUrl;
     private _counters;
     private _gauges;
     private _timer;
@@ -22,6 +23,7 @@ declare class MetricsReporter {
         environment: string;
         service: string;
         flushInterval?: number;
+        appBaseUrl?: string;
     });
     record(name: string, value?: number, unit?: string | null, dimensions?: Record<string, string>): void;
     recordGauge(name: string, value: number, unit?: string | null, dimensions?: Record<string, string>): void;
@@ -223,7 +225,7 @@ declare class ConfigClient {
     private _initialized;
     private _listeners;
     /** @internal */
-    constructor(apiKey: string, timeout?: number);
+    constructor(apiKey: string, timeout?: number, baseUrl?: string);
     /** @internal */
     _mgNew(id: string, options?: {
         name?: string;
@@ -922,7 +924,7 @@ declare class FlagsClient {
     /** Management API — CRUD operations on Flag models. */
     readonly management: FlagsManagement;
     /** @internal */
-    constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
+    constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number, flagsBaseUrl?: string, appBaseUrl?: string);
     /** @internal */
     _mgNewBooleanFlag(id: string, options: {
         default: boolean;
@@ -1270,8 +1272,10 @@ declare class LoggingClient {
     private _keyListeners;
     private _adapters;
     private _explicitAdapters;
+    private _loggerBuffer;
+    private _loggerFlushTimer;
     /** @internal */
-    constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
+    constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number, baseUrl?: string);
     /**
      * Register a logging framework adapter.
      *
@@ -1328,6 +1332,8 @@ declare class LoggingClient {
     private _applyLevels;
     /** Called by adapter hooks when a new logger is created in the framework. */
     private _onAdapterNewLogger;
+    /** Flush buffered loggers to the bulk-register endpoint. */
+    private _flushLoggerBuffer;
     private _handleLoggerChanged;
     private _handleGroupChanged;
     private _loggerToModel;
@@ -1371,6 +1377,18 @@ interface SmplClientOptions {
      * @default false
      */
     disableTelemetry?: boolean;
+    /**
+     * Base domain for all smplkit service URLs.
+     * Override for local development (e.g. `"localhost"`).
+     * @default "smplkit.com"
+     */
+    baseDomain?: string;
+    /**
+     * URL scheme used when constructing service URLs.
+     * Override for local development (e.g. `"http"`).
+     * @default "https"
+     */
+    scheme?: string;
 }
 /**
  * Entry point for the smplkit TypeScript SDK.
@@ -1410,6 +1428,7 @@ declare class SmplClient {
     /** @internal */
     readonly _metrics: MetricsReporter | null;
     private readonly _timeout;
+    private readonly _appBaseUrl;
     private readonly _appHttp;
     constructor(options?: SmplClientOptions);
     /** @internal */

package/dist/index.js

@@ -17056,11 +17056,11 @@ var ConfigClient = class {
   _initialized = false;
   _listeners = [];
   /** @internal */
-  constructor(apiKey, timeout) {
+  constructor(apiKey, timeout, baseUrl) {
     this._apiKey = apiKey;
     const ms = timeout ?? 3e4;
     this._http = createClient({
-      baseUrl: BASE_URL,
+      baseUrl: baseUrl ?? BASE_URL,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -17775,7 +17775,7 @@ var FlagsClient = class {
   /** Management API — CRUD operations on Flag models. */
   management;
   /** @internal */
-  constructor(apiKey, ensureWs, timeout) {
+  constructor(apiKey, ensureWs, timeout, flagsBaseUrl, appBaseUrl) {
     this._apiKey = apiKey;
     this._ensureWs = ensureWs;
     const ms = timeout ?? 3e4;
@@ -17794,7 +17794,7 @@ var FlagsClient = class {
       }
     };
     this._http = createClient2({
-      baseUrl: FLAGS_BASE_URL,
+      baseUrl: flagsBaseUrl ?? FLAGS_BASE_URL,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -17802,7 +17802,7 @@ var FlagsClient = class {
       fetch: fetchWithTimeout
     });
     this._appHttp = createClient2({
-      baseUrl: APP_BASE_URL,
+      baseUrl: appBaseUrl ?? APP_BASE_URL,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -18610,6 +18610,26 @@ var LogGroup = class {
 
 // src/logging/client.ts
 var LOGGING_BASE_URL = "https://logging.smplkit.com";
+var LoggerRegistrationBuffer = class {
+  _seen = /* @__PURE__ */ new Set();
+  _pending = [];
+  add(id, level, resolvedLevel, service, environment) {
+    if (this._seen.has(id)) return;
+    this._seen.add(id);
+    const item = { id, level, resolved_level: resolvedLevel };
+    if (service) item.service = service;
+    if (environment) item.environment = environment;
+    this._pending.push(item);
+  }
+  drain() {
+    const batch = this._pending;
+    this._pending = [];
+    return batch;
+  }
+  get pendingCount() {
+    return this._pending.length;
+  }
+};
 async function checkError3(response, _context) {
   const body = await response.text().catch(() => "");
   throwForStatus(response.status, body);
@@ -18680,13 +18700,15 @@ var LoggingClient = class {
   _keyListeners = /* @__PURE__ */ new Map();
   _adapters = [];
   _explicitAdapters = false;
+  _loggerBuffer = new LoggerRegistrationBuffer();
+  _loggerFlushTimer = null;
   /** @internal */
-  constructor(apiKey, ensureWs, timeout) {
+  constructor(apiKey, ensureWs, timeout, baseUrl) {
     this._apiKey = apiKey;
     this._ensureWs = ensureWs;
     const ms = timeout ?? 3e4;
     this._http = createClient3({
-      baseUrl: LOGGING_BASE_URL,
+      baseUrl: baseUrl ?? LOGGING_BASE_URL,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -18925,15 +18947,20 @@ var LoggingClient = class {
     if (!this._explicitAdapters) {
       this._adapters = this._autoLoadAdapters();
     }
-    const discovered = [];
+    const service = this._parent?._service ?? null;
+    const environment = this._parent?._environment ?? null;
+    let discoveredCount = 0;
     for (const adapter of this._adapters) {
       try {
         const loggers = adapter.discover();
-        discovered.push(...loggers);
+        for (const { name, level } of loggers) {
+          this._loggerBuffer.add(name, level, level, service, environment);
+          discoveredCount++;
+        }
       } catch {
       }
     }
-    debug("discovery", `discovered ${discovered.length} logger(s) from adapters`);
+    debug("discovery", `discovered ${discoveredCount} logger(s) from adapters`);
     for (const adapter of this._adapters) {
       try {
         adapter.installHook((name, level) => {
@@ -18943,39 +18970,13 @@ var LoggingClient = class {
       } catch {
       }
     }
-    if (discovered.length > 0) {
+    if (discoveredCount > 0) {
       const metrics = this._parent?._metrics;
       if (metrics) {
-        metrics.record("logging.loggers_discovered", discovered.length, "loggers");
-      }
-    }
-    if (discovered.length > 0) {
-      const service = this._parent?._service ?? null;
-      const environment = this._parent?._environment ?? null;
-      const loggers = discovered.map(
-        ({ name, level }) => ({
-          id: name,
-          // For Winston/Pino there is no inherited-null distinction — both fields carry the same value.
-          level,
-          resolved_level: level,
-          service: service ?? void 0,
-          environment: environment ?? void 0
-        })
-      );
-      debug("registration", `flushing ${loggers.length} logger(s) to bulk-register endpoint`);
-      try {
-        const result = await this._http.POST("/api/v1/loggers/bulk", {
-          body: { loggers }
-        });
-        if (result.error !== void 0)
-          await checkError3(result.response, "Failed to bulk-register loggers");
-        debug("registration", `bulk-register complete (${loggers.length} logger(s))`);
-      } catch (err) {
-        console.warn(
-          `[smplkit] Failed to bulk-register loggers: ${err instanceof Error ? err.message : String(err)}`
-        );
+        metrics.record("logging.loggers_discovered", discoveredCount, "loggers");
       }
     }
+    await this._flushLoggerBuffer();
     debug("resolution", `starting resolution pass (trigger: start())`);
     try {
       const [serverLoggers, serverGroups] = await Promise.all([
@@ -18994,6 +18995,9 @@ var LoggingClient = class {
     this._wsManager.on("logger_deleted", this._handleLoggerChanged);
     this._wsManager.on("group_changed", this._handleGroupChanged);
     this._wsManager.on("group_deleted", this._handleGroupChanged);
+    this._loggerFlushTimer = setInterval(() => {
+      void this._flushLoggerBuffer();
+    }, 3e4);
     this._started = true;
   }
   // ------------------------------------------------------------------
@@ -19025,6 +19029,10 @@ var LoggingClient = class {
   /** @internal */
   _close() {
     debug("lifecycle", "LoggingClient._close() called");
+    if (this._loggerFlushTimer !== null) {
+      clearInterval(this._loggerFlushTimer);
+      this._loggerFlushTimer = null;
+    }
     for (const adapter of this._adapters) {
       try {
         adapter.uninstallHook();
@@ -19093,12 +19101,34 @@ var LoggingClient = class {
     }
   }
   /** Called by adapter hooks when a new logger is created in the framework. */
-  _onAdapterNewLogger(_name, _level) {
-    debug("discovery", `new logger intercepted at runtime: ${_name}`);
-    const logger = this.management.new(_name, { managed: true });
-    logger.setLevel(_level);
-    logger.save().catch(() => {
-    });
+  _onAdapterNewLogger(name, level) {
+    debug("discovery", `new logger intercepted at runtime: ${name}`);
+    const service = this._parent?._service ?? null;
+    const environment = this._parent?._environment ?? null;
+    this._loggerBuffer.add(name, level, level, service, environment);
+    if (this._loggerBuffer.pendingCount >= 50) {
+      void this._flushLoggerBuffer();
+    }
+  }
+  /** Flush buffered loggers to the bulk-register endpoint. */
+  async _flushLoggerBuffer() {
+    const batch = this._loggerBuffer.drain();
+    if (batch.length === 0) return;
+    debug("registration", `flushing ${batch.length} logger(s) to bulk-register endpoint`);
+    try {
+      const result = await this._http.POST("/api/v1/loggers/bulk", {
+        body: { loggers: batch }
+      });
+      if (result.error !== void 0) {
+        console.warn("[smplkit] Logger bulk registration failed");
+      } else {
+        debug("registration", `bulk-register complete (${batch.length} logger(s))`);
+      }
+    } catch (err) {
+      console.warn(
+        `[smplkit] Logger bulk registration failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
   // ------------------------------------------------------------------
   // Internal: WebSocket handler
@@ -19420,6 +19450,7 @@ var MetricsReporter = class {
   _environment;
   _service;
   _flushInterval;
+  _appBaseUrl;
   _counters = /* @__PURE__ */ new Map();
   _gauges = /* @__PURE__ */ new Map();
   _timer = null;
@@ -19429,6 +19460,7 @@ var MetricsReporter = class {
     this._environment = options.environment;
     this._service = options.service;
     this._flushInterval = options.flushInterval ?? 60;
+    this._appBaseUrl = options.appBaseUrl ?? APP_BASE_URL2;
   }
   // ------------------------------------------------------------------
   // Public recording API
@@ -19505,7 +19537,7 @@ var MetricsReporter = class {
     if (counters.size === 0 && gauges.size === 0) return;
     const payload = this._buildPayload(counters, gauges);
     try {
-      fetch(`${APP_BASE_URL2}/api/v1/metrics/bulk`, {
+      fetch(`${this._appBaseUrl}/api/v1/metrics/bulk`, {
         method: "POST",
         headers: {
           Authorization: `Bearer ${this._apiKey}`,
@@ -19544,7 +19576,6 @@ var MetricsReporter = class {
 };
 
 // src/client.ts
-var APP_BASE_URL3 = "https://app.smplkit.com";
 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 {
@@ -19563,6 +19594,7 @@ var SmplClient = class {
   /** @internal */
   _metrics = null;
   _timeout;
+  _appBaseUrl;
   _appHttp;
   constructor(options = {}) {
     const environment = options.environment || process.env.SMPLKIT_ENVIRONMENT;
@@ -19578,13 +19610,20 @@ var SmplClient = class {
     const apiKey = resolveApiKey(options.apiKey, environment);
     this._apiKey = apiKey;
     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}`;
+    this._appBaseUrl = appBaseUrl;
     const maskedKey = apiKey.length > 14 ? apiKey.slice(0, 10) + "..." + apiKey.slice(-4) : apiKey.slice(0, Math.min(4, apiKey.length)) + "...";
     debug(
       "lifecycle",
       `SmplClient created (api_key=${maskedKey}, environment=${environment}, service=${service})`
     );
     this._appHttp = createClient4({
-      baseUrl: APP_BASE_URL3,
+      baseUrl: appBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
@@ -19594,12 +19633,19 @@ var SmplClient = class {
       this._metrics = new MetricsReporter({
         apiKey,
         environment: this._environment,
-        service: this._service
+        service: this._service,
+        appBaseUrl
       });
     }
-    this.config = new ConfigClient(apiKey, this._timeout);
-    this.flags = new FlagsClient(apiKey, () => this._ensureWs(), this._timeout);
-    this.logging = new LoggingClient(apiKey, () => this._ensureWs(), this._timeout);
+    this.config = new ConfigClient(apiKey, this._timeout, configBaseUrl);
+    this.flags = new FlagsClient(
+      apiKey,
+      () => this._ensureWs(),
+      this._timeout,
+      flagsBaseUrl,
+      appBaseUrl
+    );
+    this.logging = new LoggingClient(apiKey, () => this._ensureWs(), this._timeout, loggingBaseUrl);
     this.config._getSharedWs = () => this._ensureWs();
     this.flags._parent = this;
     this.config._parent = this;
@@ -19630,7 +19676,7 @@ var SmplClient = class {
   /** Lazily create and start the shared WebSocket. @internal */
   _ensureWs() {
     if (this._wsManager === null) {
-      this._wsManager = new SharedWebSocket(APP_BASE_URL3, this._apiKey, this._metrics);
+      this._wsManager = new SharedWebSocket(this._appBaseUrl, this._apiKey, this._metrics);
       this._wsManager.start();
     }
     return this._wsManager;