@smplkit/sdk 1.5.8 → 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;
@@ -1273,7 +1275,7 @@ declare class LoggingClient {
     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.
      *
@@ -1375,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.
@@ -1414,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;
@@ -1273,7 +1275,7 @@ declare class LoggingClient {
     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.
      *
@@ -1375,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.
@@ -1414,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"
@@ -18703,12 +18703,12 @@ var LoggingClient = class {
   _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"
@@ -19450,6 +19450,7 @@ var MetricsReporter = class {
   _environment;
   _service;
   _flushInterval;
+  _appBaseUrl;
   _counters = /* @__PURE__ */ new Map();
   _gauges = /* @__PURE__ */ new Map();
   _timer = null;
@@ -19459,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
@@ -19535,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}`,
@@ -19574,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 {
@@ -19593,6 +19594,7 @@ var SmplClient = class {
   /** @internal */
   _metrics = null;
   _timeout;
+  _appBaseUrl;
   _appHttp;
   constructor(options = {}) {
     const environment = options.environment || process.env.SMPLKIT_ENVIRONMENT;
@@ -19608,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"
@@ -19624,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;
@@ -19660,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;