@smplkit/sdk 3.0.48 → 3.0.50

package/dist/index.d.cts

@@ -2134,8 +2134,18 @@ declare class ManagementConfigClient {
         description?: string;
         parent?: string | Config | null;
     }): Config;
-    /** List all configs. */
-    list(): Promise<Config[]>;
+    /**
+     * List configs.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Config[]>;
     /** Fetch a config by id. */
     get(id: string): Promise<Config>;
     /** Delete a config by id. */
@@ -2571,8 +2581,18 @@ declare class ManagementFlagsClient {
     }): JsonFlag;
     /** Fetch a flag by id. */
     get(id: string): Promise<Flag>;
-    /** List all flags. */
-    list(): Promise<Flag[]>;
+    /**
+     * List flags.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Flag[]>;
     /** Delete a flag by id. */
     delete(id: string): Promise<void>;
     /** @internal — called by `Flag.delete()`. */
@@ -2839,7 +2859,18 @@ declare class LoggersClient {
     new(id: string, options?: {
         managed?: boolean;
     }): Logger;
-    list(): Promise<Logger[]>;
+    /**
+     * List loggers.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Logger[]>;
     get(id: string): Promise<Logger>;
     delete(id: string): Promise<void>;
     /** @internal — called by `Logger.delete()`. */
@@ -2867,7 +2898,18 @@ declare class LogGroupsClient {
         name?: string;
         group?: string;
     }): LogGroup;
-    list(): Promise<LogGroup[]>;
+    /**
+     * List log groups.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<LogGroup[]>;
     get(id: string): Promise<LogGroup>;
     delete(id: string): Promise<void>;
     /** @internal — called by `LogGroup.delete()`. */
@@ -2938,7 +2980,18 @@ declare class EnvironmentsClient {
         color?: Color | string | null;
         classification?: EnvironmentClassification;
     }): Environment;
-    list(): Promise<Environment[]>;
+    /**
+     * List environments.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Environment[]>;
     get(id: string): Promise<Environment>;
     delete(id: string): Promise<void>;
     /** @internal */
@@ -2960,7 +3013,18 @@ declare class ContextTypesClient {
         name?: string;
         attributes?: Record<string, Record<string, any>>;
     }): ContextType;
-    list(): Promise<ContextType[]>;
+    /**
+     * List context types.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<ContextType[]>;
     get(id: string): Promise<ContextType>;
     delete(id: string): Promise<void>;
     /** @internal */
@@ -3006,8 +3070,18 @@ declare class ContextsClient {
     flush(): Promise<void>;
     /** Number of contexts awaiting flush. */
     get pendingCount(): number;
-    /** List all contexts of a given type. */
-    list(type: string): Promise<Context[]>;
+    /**
+     * List contexts of a given type.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(type: string, params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Context[]>;
     /** Fetch a context by composite id (`"type:key"`) or by separate type and key. */
     get(idOrType: string, key?: string): Promise<Context>;
     /** Delete a context by composite id (`"type:key"`) or by separate type and key. */
@@ -3200,6 +3274,10 @@ declare class ConfigClient {
      * (set via `_resolveManagement`) so runtime + management share one HTTP
      * client; falls back to a direct GET when running without `SmplClient`
      * bootstrap (e.g. unit tests that construct `ConfigClient` directly).
+     *
+     * Pages through the server until a short page (less than the requested
+     * size) is returned — accounts with more than 1000 configs would
+     * otherwise silently lose everything past page one.
      */
     private _listConfigs;
     /**
@@ -3285,8 +3363,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>);
     /**
@@ -3301,6 +3381,10 @@ declare class LoggingClient {
      * (set via `_resolveManagement`); falls back to a direct GET when running
      * without `SmplClient` bootstrap (e.g. unit tests that construct
      * `LoggingClient` directly).
+     *
+     * Pages through the server until a short page (less than the requested
+     * size) is returned — accounts with more than 1000 loggers would
+     * otherwise silently lose everything past page one.
      */
     private _listLoggers;
     /** @internal — see {@link _listLoggers}. */
@@ -3359,8 +3443,29 @@ 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.
+     *
+     * Computes a resolved level (via {@link resolveLevel}) for every entry
+     * currently in `_loggersCache` *and* every adapter-known logger name —
+     * even loggers whose own `level` is `null`, because they may inherit
+     * via group chain or dot-notation ancestry.
+     *
+     * The full resolved-level snapshot is stored in `_resolvedLevelStore`
+     * so callers can diff pre-vs-post and fire change listeners on actual
+     * effective-level deltas (group-driven changes included). Adapter pushes
+     * only happen for adapter-known names where `managed !== false`.
+     * @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. */
@@ -3369,12 +3474,26 @@ declare class LoggingClient {
     private _handleLoggerDeleted;
     private _handleGroupChanged;
     private _handleGroupDeleted;
+    /**
+     * @internal Fire change listeners for every logger whose resolved level
+     * changed between `pre` and `post`. Stores resolved levels, not raw
+     * `logger.level`, so a group-driven change actually fires. Keys that
+     * disappeared from `post` are emitted with `deleted: true`.
+     */
+    private _fireDeltas;
+    /**
+     * @internal Always emit a deleted event for `id` on global and per-key
+     * listeners. Used by `logger_deleted` / `group_deleted` handlers to
+     * preserve the explicit notification contract even when nothing in the
+     * resolved-level store changed (e.g. server removed an unknown logger).
+     */
+    private _emitDeletedEvent;
     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

@@ -2134,8 +2134,18 @@ declare class ManagementConfigClient {
         description?: string;
         parent?: string | Config | null;
     }): Config;
-    /** List all configs. */
-    list(): Promise<Config[]>;
+    /**
+     * List configs.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Config[]>;
     /** Fetch a config by id. */
     get(id: string): Promise<Config>;
     /** Delete a config by id. */
@@ -2571,8 +2581,18 @@ declare class ManagementFlagsClient {
     }): JsonFlag;
     /** Fetch a flag by id. */
     get(id: string): Promise<Flag>;
-    /** List all flags. */
-    list(): Promise<Flag[]>;
+    /**
+     * List flags.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Flag[]>;
     /** Delete a flag by id. */
     delete(id: string): Promise<void>;
     /** @internal — called by `Flag.delete()`. */
@@ -2839,7 +2859,18 @@ declare class LoggersClient {
     new(id: string, options?: {
         managed?: boolean;
     }): Logger;
-    list(): Promise<Logger[]>;
+    /**
+     * List loggers.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Logger[]>;
     get(id: string): Promise<Logger>;
     delete(id: string): Promise<void>;
     /** @internal — called by `Logger.delete()`. */
@@ -2867,7 +2898,18 @@ declare class LogGroupsClient {
         name?: string;
         group?: string;
     }): LogGroup;
-    list(): Promise<LogGroup[]>;
+    /**
+     * List log groups.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<LogGroup[]>;
     get(id: string): Promise<LogGroup>;
     delete(id: string): Promise<void>;
     /** @internal — called by `LogGroup.delete()`. */
@@ -2938,7 +2980,18 @@ declare class EnvironmentsClient {
         color?: Color | string | null;
         classification?: EnvironmentClassification;
     }): Environment;
-    list(): Promise<Environment[]>;
+    /**
+     * List environments.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Environment[]>;
     get(id: string): Promise<Environment>;
     delete(id: string): Promise<void>;
     /** @internal */
@@ -2960,7 +3013,18 @@ declare class ContextTypesClient {
         name?: string;
         attributes?: Record<string, Record<string, any>>;
     }): ContextType;
-    list(): Promise<ContextType[]>;
+    /**
+     * List context types.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<ContextType[]>;
     get(id: string): Promise<ContextType>;
     delete(id: string): Promise<void>;
     /** @internal */
@@ -3006,8 +3070,18 @@ declare class ContextsClient {
     flush(): Promise<void>;
     /** Number of contexts awaiting flush. */
     get pendingCount(): number;
-    /** List all contexts of a given type. */
-    list(type: string): Promise<Context[]>;
+    /**
+     * List contexts of a given type.
+     *
+     * Server defaults are `pageNumber=1`, `pageSize=1000` (capped at 1000).
+     * Omit both to fetch the first page; pass them through to walk further
+     * pages. The wrapper does not loop on the customer's behalf — the
+     * customer chooses how to paginate.
+     */
+    list(type: string, params?: {
+        pageNumber?: number;
+        pageSize?: number;
+    }): Promise<Context[]>;
     /** Fetch a context by composite id (`"type:key"`) or by separate type and key. */
     get(idOrType: string, key?: string): Promise<Context>;
     /** Delete a context by composite id (`"type:key"`) or by separate type and key. */
@@ -3200,6 +3274,10 @@ declare class ConfigClient {
      * (set via `_resolveManagement`) so runtime + management share one HTTP
      * client; falls back to a direct GET when running without `SmplClient`
      * bootstrap (e.g. unit tests that construct `ConfigClient` directly).
+     *
+     * Pages through the server until a short page (less than the requested
+     * size) is returned — accounts with more than 1000 configs would
+     * otherwise silently lose everything past page one.
      */
     private _listConfigs;
     /**
@@ -3285,8 +3363,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>);
     /**
@@ -3301,6 +3381,10 @@ declare class LoggingClient {
      * (set via `_resolveManagement`); falls back to a direct GET when running
      * without `SmplClient` bootstrap (e.g. unit tests that construct
      * `LoggingClient` directly).
+     *
+     * Pages through the server until a short page (less than the requested
+     * size) is returned — accounts with more than 1000 loggers would
+     * otherwise silently lose everything past page one.
      */
     private _listLoggers;
     /** @internal — see {@link _listLoggers}. */
@@ -3359,8 +3443,29 @@ 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.
+     *
+     * Computes a resolved level (via {@link resolveLevel}) for every entry
+     * currently in `_loggersCache` *and* every adapter-known logger name —
+     * even loggers whose own `level` is `null`, because they may inherit
+     * via group chain or dot-notation ancestry.
+     *
+     * The full resolved-level snapshot is stored in `_resolvedLevelStore`
+     * so callers can diff pre-vs-post and fire change listeners on actual
+     * effective-level deltas (group-driven changes included). Adapter pushes
+     * only happen for adapter-known names where `managed !== false`.
+     * @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. */
@@ -3369,12 +3474,26 @@ declare class LoggingClient {
     private _handleLoggerDeleted;
     private _handleGroupChanged;
     private _handleGroupDeleted;
+    /**
+     * @internal Fire change listeners for every logger whose resolved level
+     * changed between `pre` and `post`. Stores resolved levels, not raw
+     * `logger.level`, so a group-driven change actually fires. Keys that
+     * disappeared from `post` are emitted with `deleted: true`.
+     */
+    private _fireDeltas;
+    /**
+     * @internal Always emit a deleted event for `id` on global and per-key
+     * listeners. Used by `logger_deleted` / `group_deleted` handlers to
+     * preserve the explicit notification contract even when nothing in the
+     * resolved-level store changed (e.g. server removed an unknown logger).
+     */
+    private _emitDeletedEvent;
     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;