@smplkit/sdk 3.0.2 → 3.0.3

package/dist/index.d.cts

@@ -1549,6 +1549,13 @@ declare class FlagsClient {
      * before using `.get()` on flag handles.
      */
     initialize(): Promise<void>;
+    /**
+     * Synchronous teardown — clears the flag-flush interval and unsubscribes
+     * from WebSocket events. Called by `SmplClient.close()`. Does not flush
+     * pending context observations (use {@link disconnect} for that).
+     * @internal
+     */
+    _close(): void;
     /** Disconnect the flags runtime and release resources. */
     disconnect(): Promise<void>;
     /** Refresh all flag definitions from the server. */
@@ -2568,8 +2575,32 @@ declare class LoggingClient {
      * `install()`.
      *
      * Mirrors Python's `client.logging.install()`. There is no `stop()`.
+     *
+     * Adapter coverage:
+     * - **winston**: pre-existing named loggers (`winston.loggers.*`) and the
+     *   default logger are auto-discovered.
+     * - **pino**: pino has no global registry, so only loggers created
+     *   through `pino()` / `logger.child()` *after* `install()` runs are
+     *   tracked. To bring pre-existing pino loggers under management, recreate
+     *   them after install or register them explicitly via
+     *   `client.manage.loggers.register([...])`.
+     *
+     * After the initial pass, call {@link refresh} to re-fetch managed levels
+     * from the server and re-apply them onto the native loggers (e.g. after
+     * suspecting drift, or to force a manual sync outside the WebSocket).
      */
     install(): Promise<void>;
+    /**
+     * Re-fetch logger and group levels from the server and re-apply them
+     * onto the registered adapters.
+     *
+     * Diff-based: change listeners only fire for loggers whose level
+     * actually changed (added, removed, or different level), with
+     * `source: "manual"`. Mirrors Python's `client.logging.refresh()`.
+     *
+     * @throws SmplError if `install()` has not been called.
+     */
+    refresh(): Promise<void>;
     /**
      * @deprecated Use {@link LoggingClient.install}. Retained as a backwards-
      * compatible alias.
@@ -2599,6 +2630,14 @@ declare class LoggingClient {
     private _handleGroupChanged;
     private _handleGroupDeleted;
     private _handleLoggersChanged;
+    /**
+     * Full refetch of loggers + log_groups, apply resolved levels to
+     * adapters, diff against local stores and fire change listeners
+     * (global once, per-key for each changed id). Shared between the
+     * `loggers_changed` WS handler and the public `refresh()` method.
+     * @internal
+     */
+    private _resolveAndFire;
     /** Fetch a single logger by key. Returns null if not found. @internal */
     private _fetchSingleLogger;
     /** Fetch a single log group by key. Returns null if not found. @internal */

package/dist/index.d.ts

@@ -1549,6 +1549,13 @@ declare class FlagsClient {
      * before using `.get()` on flag handles.
      */
     initialize(): Promise<void>;
+    /**
+     * Synchronous teardown — clears the flag-flush interval and unsubscribes
+     * from WebSocket events. Called by `SmplClient.close()`. Does not flush
+     * pending context observations (use {@link disconnect} for that).
+     * @internal
+     */
+    _close(): void;
     /** Disconnect the flags runtime and release resources. */
     disconnect(): Promise<void>;
     /** Refresh all flag definitions from the server. */
@@ -2568,8 +2575,32 @@ declare class LoggingClient {
      * `install()`.
      *
      * Mirrors Python's `client.logging.install()`. There is no `stop()`.
+     *
+     * Adapter coverage:
+     * - **winston**: pre-existing named loggers (`winston.loggers.*`) and the
+     *   default logger are auto-discovered.
+     * - **pino**: pino has no global registry, so only loggers created
+     *   through `pino()` / `logger.child()` *after* `install()` runs are
+     *   tracked. To bring pre-existing pino loggers under management, recreate
+     *   them after install or register them explicitly via
+     *   `client.manage.loggers.register([...])`.
+     *
+     * After the initial pass, call {@link refresh} to re-fetch managed levels
+     * from the server and re-apply them onto the native loggers (e.g. after
+     * suspecting drift, or to force a manual sync outside the WebSocket).
      */
     install(): Promise<void>;
+    /**
+     * Re-fetch logger and group levels from the server and re-apply them
+     * onto the registered adapters.
+     *
+     * Diff-based: change listeners only fire for loggers whose level
+     * actually changed (added, removed, or different level), with
+     * `source: "manual"`. Mirrors Python's `client.logging.refresh()`.
+     *
+     * @throws SmplError if `install()` has not been called.
+     */
+    refresh(): Promise<void>;
     /**
      * @deprecated Use {@link LoggingClient.install}. Retained as a backwards-
      * compatible alias.
@@ -2599,6 +2630,14 @@ declare class LoggingClient {
     private _handleGroupChanged;
     private _handleGroupDeleted;
     private _handleLoggersChanged;
+    /**
+     * Full refetch of loggers + log_groups, apply resolved levels to
+     * adapters, diff against local stores and fire change listeners
+     * (global once, per-key for each changed id). Shared between the
+     * `loggers_changed` WS handler and the public `refresh()` method.
+     * @internal
+     */
+    private _resolveAndFire;
     /** Fetch a single logger by key. Returns null if not found. @internal */
     private _fetchSingleLogger;
     /** Fetch a single log group by key. Returns null if not found. @internal */

package/dist/index.js

@@ -20490,6 +20490,30 @@ var FlagsClient = class {
     this._flagFlushTimer = setInterval(() => {
       void this._flushFlags();
     }, FLAG_REGISTRATION_FLUSH_INTERVAL_MS);
+    if (typeof this._flagFlushTimer === "object" && "unref" in this._flagFlushTimer) {
+      this._flagFlushTimer.unref();
+    }
+  }
+  /**
+   * Synchronous teardown — clears the flag-flush interval and unsubscribes
+   * from WebSocket events. Called by `SmplClient.close()`. Does not flush
+   * pending context observations (use {@link disconnect} for that).
+   * @internal
+   */
+  _close() {
+    if (this._flagFlushTimer !== null) {
+      clearInterval(this._flagFlushTimer);
+      this._flagFlushTimer = null;
+    }
+    if (this._wsManager !== null) {
+      this._wsManager.off("flag_changed", this._handleFlagChanged);
+      this._wsManager.off("flag_deleted", this._handleFlagDeleted);
+      this._wsManager.off("flags_changed", this._handleFlagsChanged);
+      this._wsManager = null;
+    }
+    this._cache.clear();
+    this._initialized = false;
+    this._environment = null;
   }
   /** Disconnect the flags runtime and release resources. */
   async disconnect() {
@@ -20646,6 +20670,9 @@ var FlagsClient = class {
     this._flagFlushTimer = setInterval(() => {
       void this._flushFlags();
     }, FLAG_REGISTRATION_FLUSH_INTERVAL_MS);
+    if (typeof this._flagFlushTimer === "object" && "unref" in this._flagFlushTimer) {
+      this._flagFlushTimer.unref();
+    }
   }
   // ------------------------------------------------------------------
   // Internal: event handlers (called by SharedWebSocket)
@@ -20993,10 +21020,39 @@ var LoggingClient = class {
    * `install()`.
    *
    * Mirrors Python's `client.logging.install()`. There is no `stop()`.
+   *
+   * Adapter coverage:
+   * - **winston**: pre-existing named loggers (`winston.loggers.*`) and the
+   *   default logger are auto-discovered.
+   * - **pino**: pino has no global registry, so only loggers created
+   *   through `pino()` / `logger.child()` *after* `install()` runs are
+   *   tracked. To bring pre-existing pino loggers under management, recreate
+   *   them after install or register them explicitly via
+   *   `client.manage.loggers.register([...])`.
+   *
+   * After the initial pass, call {@link refresh} to re-fetch managed levels
+   * from the server and re-apply them onto the native loggers (e.g. after
+   * suspecting drift, or to force a manual sync outside the WebSocket).
    */
   async install() {
     return this._installInternal();
   }
+  /**
+   * Re-fetch logger and group levels from the server and re-apply them
+   * onto the registered adapters.
+   *
+   * Diff-based: change listeners only fire for loggers whose level
+   * actually changed (added, removed, or different level), with
+   * `source: "manual"`. Mirrors Python's `client.logging.refresh()`.
+   *
+   * @throws SmplError if `install()` has not been called.
+   */
+  async refresh() {
+    if (!this._started) {
+      throw new SmplError("Logging not installed. Call install() first.");
+    }
+    await this._resolveAndFire("manual");
+  }
   /**
    * @deprecated Use {@link LoggingClient.install}. Retained as a backwards-
    * compatible alias.
@@ -21069,6 +21125,9 @@ var LoggingClient = class {
     this._loggerFlushTimer = setInterval(() => {
       void this._flushLoggerBuffer();
     }, 3e4);
+    if (typeof this._loggerFlushTimer === "object" && "unref" in this._loggerFlushTimer) {
+      this._loggerFlushTimer.unref();
+    }
     this._started = true;
   }
   // ------------------------------------------------------------------
@@ -21340,63 +21399,75 @@ var LoggingClient = class {
   };
   _handleLoggersChanged = (_data) => {
     debug("websocket", `loggers_changed event received`);
-    void Promise.all([this._listLoggers(), this._listLogGroups()]).then(([serverLoggers, serverGroups]) => {
-      debug("resolution", `resolution pass (trigger: loggers_changed event)`);
-      const changedLoggerIds = /* @__PURE__ */ new Set();
-      const newLoggerKeys = new Set(serverLoggers.map((l) => l.id));
-      for (const logger of serverLoggers) {
-        const key = logger.id;
-        const oldLevel = this._loggerStore[key] ?? null;
-        const newLevel = logger.level ?? null;
-        if (oldLevel !== newLevel || !(key in this._loggerStore)) {
-          changedLoggerIds.add(key);
-          this._loggerStore[key] = newLevel;
-        }
-      }
-      for (const key of Object.keys(this._loggerStore)) {
-        if (!newLoggerKeys.has(key)) {
-          changedLoggerIds.add(key);
-          delete this._loggerStore[key];
-        }
-      }
-      for (const group of serverGroups) {
-        this._groupStore[group.id] = group.level ?? null;
-      }
-      this._applyLevels(serverLoggers);
-      if (changedLoggerIds.size === 0) return;
-      const [firstKey] = changedLoggerIds;
-      const firstLogger = serverLoggers.find((l) => l.id === firstKey);
-      const globalEvent = new LoggerChangeEvent({
-        id: firstKey,
-        level: firstLogger?.level ?? null,
-        source: "websocket"
-      });
-      for (const cb of this._globalListeners) {
-        try {
-          cb(globalEvent);
-        } catch {
-        }
+    void this._resolveAndFire("websocket").catch(() => {
+    });
+  };
+  /**
+   * Full refetch of loggers + log_groups, apply resolved levels to
+   * adapters, diff against local stores and fire change listeners
+   * (global once, per-key for each changed id). Shared between the
+   * `loggers_changed` WS handler and the public `refresh()` method.
+   * @internal
+   */
+  async _resolveAndFire(source) {
+    const [serverLoggers, serverGroups] = await Promise.all([
+      this._listLoggers(),
+      this._listLogGroups()
+    ]);
+    debug("resolution", `resolution pass (trigger: ${source})`);
+    const changedLoggerIds = /* @__PURE__ */ new Set();
+    const newLoggerKeys = new Set(serverLoggers.map((l) => l.id));
+    for (const logger of serverLoggers) {
+      const key = logger.id;
+      const oldLevel = this._loggerStore[key] ?? null;
+      const newLevel = logger.level ?? null;
+      if (oldLevel !== newLevel || !(key in this._loggerStore)) {
+        changedLoggerIds.add(key);
+        this._loggerStore[key] = newLevel;
+      }
+    }
+    for (const key of Object.keys(this._loggerStore)) {
+      if (!newLoggerKeys.has(key)) {
+        changedLoggerIds.add(key);
+        delete this._loggerStore[key];
+      }
+    }
+    for (const group of serverGroups) {
+      this._groupStore[group.id] = group.level ?? null;
+    }
+    this._applyLevels(serverLoggers);
+    if (changedLoggerIds.size === 0) return;
+    const [firstKey] = changedLoggerIds;
+    const firstLogger = serverLoggers.find((l) => l.id === firstKey);
+    const globalEvent = new LoggerChangeEvent({
+      id: firstKey,
+      level: firstLogger?.level ?? null,
+      source
+    });
+    for (const cb of this._globalListeners) {
+      try {
+        cb(globalEvent);
+      } catch {
       }
-      for (const key of changedLoggerIds) {
-        const keyCallbacks = this._keyListeners.get(key);
-        if (keyCallbacks) {
-          const l = serverLoggers.find((x) => x.id === key);
-          const keyEvent = new LoggerChangeEvent({
-            id: key,
-            level: l?.level ?? null,
-            source: "websocket"
-          });
-          for (const cb of keyCallbacks) {
-            try {
-              cb(keyEvent);
-            } catch {
-            }
+    }
+    for (const key of changedLoggerIds) {
+      const keyCallbacks = this._keyListeners.get(key);
+      if (keyCallbacks) {
+        const l = serverLoggers.find((x) => x.id === key);
+        const keyEvent = new LoggerChangeEvent({
+          id: key,
+          level: l?.level ?? null,
+          source
+        });
+        for (const cb of keyCallbacks) {
+          try {
+            cb(keyEvent);
+          } catch {
           }
         }
       }
-    }).catch(() => {
-    });
-  };
+    }
+  }
   // ------------------------------------------------------------------
   // Internal: single-resource fetchers
   // ------------------------------------------------------------------
@@ -21939,6 +22010,7 @@ var SmplClient = class {
     if (this._metrics !== null) {
       this._metrics.close();
     }
+    this.flags._close();
     this.logging._close();
     if (this._wsManager !== null) {
       this._wsManager.stop();