@smplkit/sdk 3.0.49 → 3.0.51

package/dist/index.d.cts

@@ -2632,22 +2632,20 @@ declare enum LogLevel {
     SILENT = "SILENT"
 }
 /**
- * Describes a logger configuration change. Frozen — fields cannot be
+ * Describes a logger effective-level change. Frozen — fields cannot be
  * mutated after construction so a listener cannot affect later listeners.
  *
- * The `level` field is a TypeScript-SDK-only convenience for callers that
- * want to act on the new effective level without re-fetching the logger.
+ * One instance per logger whose effective level moved; emitted in lockstep
+ * with the matching `adapter.applyLevel(...)` call.
  */
 declare class LoggerChangeEvent {
     readonly id: string;
     readonly source: string;
-    readonly level?: LogLevel | null;
-    readonly deleted?: true;
+    readonly level: LogLevel;
     constructor(fields: {
         id: string;
         source: string;
-        level?: LogLevel | null;
-        deleted?: true;
+        level: LogLevel;
     });
 }
 /**
@@ -3363,8 +3361,10 @@ declare class LoggingClient {
     private _explicitAdapters;
     private _loggerBuffer;
     private _loggerFlushTimer;
-    private _loggerStore;
-    private _groupStore;
+    private _loggersCache;
+    private _groupsCache;
+    private _resolvedLevelStore;
+    private _knownLoggerNames;
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number, baseUrl?: string, extraHeaders?: Record<string, string>);
     /**
@@ -3441,8 +3441,31 @@ declare class LoggingClient {
     _close(): void;
     /** Auto-load built-in adapters by attempting to require each framework. */
     private _autoLoadAdapters;
-    /** Apply resolved levels from server loggers to all adapters. */
+    /**
+     * Refresh resolved levels and apply them to adapter-known loggers.
+     *
+     * Walks every adapter-known logger name through {@link resolveLevel}
+     * (env override → base → group chain → dot-notation ancestry → fallback)
+     * and pushes the result to every registered adapter. Loggers whose own
+     * `level` is `null` are still applied — that's the whole point of group
+     * inheritance and dot-notation ancestry.
+     *
+     * The resolved-level snapshot lives in `_resolvedLevelStore` so callers
+     * can diff pre-vs-post and fire change listeners on actual effective-
+     * level deltas. The store is scoped to adapter-known names: listener
+     * fanout pairs 1:1 with `adapter.applyLevel` calls, so a logger that
+     * the adapter doesn't know about has no apply and no listener fire.
+     * @internal
+     */
     private _applyLevels;
+    /** @internal Convert a server Logger list into the resolution cache. */
+    private _buildLoggersCache;
+    /** @internal Convert a server LogGroup list into the resolution cache. */
+    private _buildGroupsCache;
+    /** @internal */
+    private _loggerToCacheEntry;
+    /** @internal */
+    private _groupToCacheEntry;
     /** Called by adapter hooks when a new logger is created in the framework. */
     private _onAdapterNewLogger;
     /** Flush buffered loggers to the bulk-register endpoint. */
@@ -3451,12 +3474,32 @@ declare class LoggingClient {
     private _handleLoggerDeleted;
     private _handleGroupChanged;
     private _handleGroupDeleted;
+    /**
+     * @internal Fire change listeners for every logger whose effective level
+     * changed between `pre` and `post`.
+     *
+     * Contract:
+     *   - Iterates loggers present in `post` (the post-apply resolved store).
+     *     A key in `pre` but not in `post` is a cache eviction — that key
+     *     itself fires nothing. Dependents that re-resolved to a new value
+     *     are still in `post` and fire normally.
+     *   - For every changed logger, fires every global listener once with
+     *     that logger's own payload (no "summary" event), then fires every
+     *     key-scoped listener registered for that id.
+     *   - One adapter.applyLevel call ↔ one listener notification per
+     *     subscriber. A trigger that moves N loggers fires the global
+     *     listener N times, not once.
+     *   - `suppressIds` is the deletion-event escape hatch: a deleted id
+     *     fires nothing for itself even when its adapter-known resolved
+     *     level moved (e.g. fell back to INFO).
+     */
+    private _fireDeltas;
     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.
+     * Full refetch of loggers + log_groups, rebuild the caches, re-resolve
+     * every adapter-known logger, and fire change listeners on resolved-level
+     * deltas. Shared between the `loggers_changed` WS handler and the
+     * public `refresh()` method.
      * @internal
      */
     private _resolveAndFire;

package/dist/index.d.ts

@@ -2632,22 +2632,20 @@ declare enum LogLevel {
     SILENT = "SILENT"
 }
 /**
- * Describes a logger configuration change. Frozen — fields cannot be
+ * Describes a logger effective-level change. Frozen — fields cannot be
  * mutated after construction so a listener cannot affect later listeners.
  *
- * The `level` field is a TypeScript-SDK-only convenience for callers that
- * want to act on the new effective level without re-fetching the logger.
+ * One instance per logger whose effective level moved; emitted in lockstep
+ * with the matching `adapter.applyLevel(...)` call.
  */
 declare class LoggerChangeEvent {
     readonly id: string;
     readonly source: string;
-    readonly level?: LogLevel | null;
-    readonly deleted?: true;
+    readonly level: LogLevel;
     constructor(fields: {
         id: string;
         source: string;
-        level?: LogLevel | null;
-        deleted?: true;
+        level: LogLevel;
     });
 }
 /**
@@ -3363,8 +3361,10 @@ declare class LoggingClient {
     private _explicitAdapters;
     private _loggerBuffer;
     private _loggerFlushTimer;
-    private _loggerStore;
-    private _groupStore;
+    private _loggersCache;
+    private _groupsCache;
+    private _resolvedLevelStore;
+    private _knownLoggerNames;
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number, baseUrl?: string, extraHeaders?: Record<string, string>);
     /**
@@ -3441,8 +3441,31 @@ declare class LoggingClient {
     _close(): void;
     /** Auto-load built-in adapters by attempting to require each framework. */
     private _autoLoadAdapters;
-    /** Apply resolved levels from server loggers to all adapters. */
+    /**
+     * Refresh resolved levels and apply them to adapter-known loggers.
+     *
+     * Walks every adapter-known logger name through {@link resolveLevel}
+     * (env override → base → group chain → dot-notation ancestry → fallback)
+     * and pushes the result to every registered adapter. Loggers whose own
+     * `level` is `null` are still applied — that's the whole point of group
+     * inheritance and dot-notation ancestry.
+     *
+     * The resolved-level snapshot lives in `_resolvedLevelStore` so callers
+     * can diff pre-vs-post and fire change listeners on actual effective-
+     * level deltas. The store is scoped to adapter-known names: listener
+     * fanout pairs 1:1 with `adapter.applyLevel` calls, so a logger that
+     * the adapter doesn't know about has no apply and no listener fire.
+     * @internal
+     */
     private _applyLevels;
+    /** @internal Convert a server Logger list into the resolution cache. */
+    private _buildLoggersCache;
+    /** @internal Convert a server LogGroup list into the resolution cache. */
+    private _buildGroupsCache;
+    /** @internal */
+    private _loggerToCacheEntry;
+    /** @internal */
+    private _groupToCacheEntry;
     /** Called by adapter hooks when a new logger is created in the framework. */
     private _onAdapterNewLogger;
     /** Flush buffered loggers to the bulk-register endpoint. */
@@ -3451,12 +3474,32 @@ declare class LoggingClient {
     private _handleLoggerDeleted;
     private _handleGroupChanged;
     private _handleGroupDeleted;
+    /**
+     * @internal Fire change listeners for every logger whose effective level
+     * changed between `pre` and `post`.
+     *
+     * Contract:
+     *   - Iterates loggers present in `post` (the post-apply resolved store).
+     *     A key in `pre` but not in `post` is a cache eviction — that key
+     *     itself fires nothing. Dependents that re-resolved to a new value
+     *     are still in `post` and fire normally.
+     *   - For every changed logger, fires every global listener once with
+     *     that logger's own payload (no "summary" event), then fires every
+     *     key-scoped listener registered for that id.
+     *   - One adapter.applyLevel call ↔ one listener notification per
+     *     subscriber. A trigger that moves N loggers fires the global
+     *     listener N times, not once.
+     *   - `suppressIds` is the deletion-event escape hatch: a deleted id
+     *     fires nothing for itself even when its adapter-known resolved
+     *     level moved (e.g. fell back to INFO).
+     */
+    private _fireDeltas;
     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.
+     * Full refetch of loggers + log_groups, rebuild the caches, re-resolve
+     * every adapter-known logger, and fire change listeners on resolved-level
+     * deltas. Shared between the `loggers_changed` WS handler and the
+     * public `refresh()` method.
      * @internal
      */
     private _resolveAndFire;