@smplkit/sdk 1.3.21 → 1.3.23

package/dist/index.d.cts

@@ -53,7 +53,7 @@ declare class SharedWebSocket {
  * A configuration resource managed by the smplkit platform.
  *
  * Management: mutate properties directly and call `save()` to persist.
- * POST if `id` is null (new), PUT if `id` is set (update).
+ * Creates if new, updates if existing.
  */
 declare class Config {
     /** UUID of the config, or `null` if unsaved. */
@@ -70,8 +70,7 @@ declare class Config {
     items: Record<string, unknown>;
     /**
      * Per-environment overrides.
-     * Stored as `{ env_name: { values: { key: value } } }` — values are
-     * unwrapped from the server's `{ value: raw }` wrapper.
+     * Structured as `{ env_name: { values: { key: value } } }`.
      */
     environments: Record<string, unknown>;
     /** When the config was created, or null if unavailable. */
@@ -95,7 +94,7 @@ declare class Config {
     /**
      * Persist this config to the server.
      *
-     * POST if `id` is null (new config), PUT if `id` is set (update).
+     * Creates if new, updates if existing.
      * Updates this instance in-place with the server response.
      */
     save(): Promise<void>;
@@ -118,17 +117,17 @@ declare class Config {
 }
 
 /**
- * LiveConfigProxy — ES6 Proxy-based live configuration access.
+ * LiveConfigProxy — live configuration access.
  *
- * Property reads are delegated to the latest resolved values in the
- * ConfigClient cache. When the cache updates via WebSocket, subsequent
- * reads automatically reflect the new values.
+ * Property reads always return the latest resolved values. When the
+ * underlying config changes, subsequent reads automatically reflect
+ * the new values.
  */
 
 /**
  * A live proxy that auto-updates when the underlying config changes.
  *
- * Access properties directly — each read re-resolves from the cache.
+ * Access properties directly — each read returns the latest resolved value.
  *
  * @example
  * ```typescript
@@ -208,8 +207,8 @@ declare class ConfigClient {
     /**
      * Resolve a config's values for the current environment.
      *
-     * Returns a flat dict of resolved key-value pairs, walking the
-     * parent chain and applying environment overrides.
+     * Returns a flat dict of resolved key-value pairs with inherited
+     * values and environment overrides applied.
      *
      * Optionally pass a model class to map the resolved values.
      */
@@ -230,7 +229,7 @@ declare class ConfigClient {
      */
     onChange(callbackOrConfigKey: string | ((event: ConfigChangeEvent) => void), callbackOrItemKey?: string | ((event: ConfigChangeEvent) => void), callback?: (event: ConfigChangeEvent) => void): void;
     /**
-     * Re-fetch all configs, re-resolve values, and update the cache.
+     * Re-fetch all configs and re-resolve values.
      * Fires change listeners for any values that differ.
      */
     refresh(): Promise<void>;
@@ -529,8 +528,8 @@ declare class Rule {
 /**
  * A flag resource that doubles as a runtime handle.
  *
- * Management: call `save()` to persist (POST if new, PUT if existing).
- * Runtime: call `get()` for local JSON Logic evaluation.
+ * Management: call `save()` to persist (creates if new, updates if existing).
+ * Runtime: call `get()` to evaluate the flag locally.
  */
 declare class Flag {
     /** UUID of the flag, or `null` if unsaved. */
@@ -577,7 +576,7 @@ declare class Flag {
     /**
      * Persist this flag to the server.
      *
-     * POST if `id` is null (new flag), PUT if `id` is set (update).
+     * Creates if new, updates if existing.
      * Updates this instance in-place with the server response.
      */
     save(): Promise<void>;
@@ -597,7 +596,7 @@ declare class Flag {
     /** Clear all rules for a specific environment (sync local mutation). */
     clearRules(envKey: string): void;
     /**
-     * Evaluate the flag locally (sync, no HTTP).
+     * Evaluate the flag locally.
      *
      * Requires `initialize()` to have been called.
      */
@@ -635,10 +634,6 @@ declare class JsonFlag extends Flag {
 
 /**
  * FlagsClient — management + prescriptive runtime for Smpl Flags.
- *
- * Uses the generated OpenAPI types (`src/generated/flags.d.ts`) via
- * `openapi-fetch` for all flag HTTP calls. Context registration uses
- * the generated app service types (`src/generated/app.d.ts`).
  */
 
 type FlagResource = components["schemas"]["FlagResource"];
@@ -773,16 +768,18 @@ declare class FlagsClient {
      */
     onChange(callbackOrKey: string | ((event: FlagChangeEvent) => void), callback?: (event: FlagChangeEvent) => void): void;
     /**
-     * Explicitly register context(s) for background batch registration.
+     * Register context(s) with the server.
      *
-     * Accepts a single Context or an array. Fire-and-forget — never
-     * blocks. Works before `initialize()` is called.
+     * Accepts a single Context or an array. Registration is asynchronous
+     * and never blocks. Works before `initialize()` is called.
      */
     register(context: Context | Context[]): void;
     /** Flush pending context registrations to the server. */
     flushContexts(): Promise<void>;
     /**
-     * Tier 1 explicit evaluation — stateless, no provider or cache.
+     * Evaluate a flag with an explicit environment and context.
+     *
+     * Stateless — does not use the context provider or cached results.
      */
     evaluate(key: string, options: {
         environment: string;
@@ -877,7 +874,7 @@ declare class Logger {
     /**
      * Persist this logger to the server.
      *
-     * POST if `id` is null (new), PUT if `id` is set (update).
+     * Creates if new, updates if existing.
      */
     save(): Promise<void>;
     /** Set the base log level (sync local mutation). */
@@ -932,7 +929,7 @@ declare class LogGroup {
     /**
      * Persist this log group to the server.
      *
-     * POST if `id` is null (new), PUT if `id` is set (update).
+     * Creates if new, updates if existing.
      */
     save(): Promise<void>;
     /** Set the base log level (sync local mutation). */
@@ -951,10 +948,40 @@ declare class LogGroup {
 }
 
 /**
- * LoggingClient — management plane + scaffolded runtime for Smpl Logging.
+ * Contract for pluggable logging framework integration.
  *
- * Uses the generated OpenAPI types (`src/generated/logging.d.ts`) via
- * `openapi-fetch` for all HTTP calls.
+ * Adapters bridge the smplkit logging runtime to a specific logging
+ * framework (e.g., Winston, Pino).
+ */
+interface LoggingAdapter {
+    /** Human-readable adapter name for diagnostics (e.g., 'winston'). */
+    readonly name: string;
+    /**
+     * Scan the runtime for existing loggers.
+     * Returns an array of { name, level } where level is a smplkit level string.
+     */
+    discover(): Array<{
+        name: string;
+        level: string;
+    }>;
+    /**
+     * Set the level on a specific logger.
+     * @param loggerName - The original (non-normalized) logger name.
+     * @param level - smplkit level string (e.g., 'DEBUG', 'INFO', 'WARN').
+     */
+    applyLevel(loggerName: string, level: string): void;
+    /**
+     * Install continuous discovery hook.
+     * The callback receives (original_name, smplkit_level_string) whenever
+     * a new logger is created in the framework.
+     */
+    installHook(onNewLogger: (name: string, level: string) => void): void;
+    /** Remove the hook installed by installHook(). Called on client close(). */
+    uninstallHook(): void;
+}
+
+/**
+ * LoggingClient — management plane + scaffolded runtime for Smpl Logging.
  */
 
 /**
@@ -979,8 +1006,17 @@ declare class LoggingClient {
     private _started;
     private _globalListeners;
     private _keyListeners;
+    private _adapters;
+    private _explicitAdapters;
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
+    /**
+     * Register a logging framework adapter.
+     *
+     * Must be called before `start()`. Disables auto-loading of built-in
+     * adapters — only explicitly registered adapters will be used.
+     */
+    registerAdapter(adapter: LoggingAdapter): void;
     /** Create an unsaved logger. Call `.save()` to persist. */
     new(key: string, options?: {
         name?: string;
@@ -1010,11 +1046,12 @@ declare class LoggingClient {
     /**
      * Start the logging runtime.
      *
-     * Fetches existing loggers/groups and wires WebSocket listeners for
-     * live updates. Idempotent — safe to call multiple times.
+     * Discovers loggers from registered adapters, syncs them with the
+     * server, applies server-side log levels, and subscribes to live
+     * level updates.
      *
-     * Note: Node.js auto-discovery (equivalent to Python's logging module
-     * monkey-patching) is deferred. Management methods work without start().
+     * Idempotent — safe to call multiple times.
+     * Management methods work without start().
      */
     start(): Promise<void>;
     /**
@@ -1026,6 +1063,12 @@ declare class LoggingClient {
     onChange(callbackOrKey: string | ((event: LoggerChangeEvent) => void), callback?: (event: LoggerChangeEvent) => void): void;
     /** @internal */
     _close(): void;
+    /** Auto-load built-in adapters by attempting to require each framework. */
+    private _autoLoadAdapters;
+    /** Apply resolved levels from server loggers to all adapters. */
+    private _applyLevels;
+    /** Called by adapter hooks when a new logger is created in the framework. */
+    private _onAdapterNewLogger;
     private _handleLoggerChanged;
     private _loggerToModel;
     private _groupToModel;
@@ -1109,6 +1152,65 @@ declare class SmplClient {
     close(): void;
 }
 
+/**
+ * Winston logging framework adapter.
+ *
+ * Integrates the smplkit logging runtime with Winston. Discovers
+ * existing loggers, tracks new logger creation, and applies
+ * server-managed log levels.
+ */
+
+interface WinstonAdapterConfig {
+    /** Whether to include the default logger in discovery (default: true). */
+    discoverDefault?: boolean;
+    /** @internal — inject a winston module for testing. */
+    _winston?: unknown;
+}
+declare class WinstonAdapter implements LoggingAdapter {
+    readonly name = "winston";
+    private readonly _discoverDefault;
+    private _winston;
+    private _originalAdd;
+    constructor(config?: WinstonAdapterConfig);
+    discover(): Array<{
+        name: string;
+        level: string;
+    }>;
+    applyLevel(loggerName: string, level: string): void;
+    installHook(onNewLogger: (name: string, level: string) => void): void;
+    uninstallHook(): void;
+}
+
+/**
+ * Pino logging framework adapter.
+ *
+ * Integrates the smplkit logging runtime with Pino. Tracks logger
+ * instances (including child loggers) for discovery and level control.
+ */
+
+interface PinoAdapterConfig {
+    /** Which binding field to use as the logger name (default: 'name'). */
+    nameField?: string;
+    /** @internal — inject a pino module for testing. */
+    _pino?: unknown;
+}
+declare class PinoAdapter implements LoggingAdapter {
+    readonly name = "pino";
+    private readonly _nameField;
+    private _pino;
+    private _registry;
+    private _originalPino;
+    private _pinoModule;
+    constructor(config?: PinoAdapterConfig);
+    discover(): Array<{
+        name: string;
+        level: string;
+    }>;
+    applyLevel(loggerName: string, level: string): void;
+    installHook(onNewLogger: (name: string, level: string) => void): void;
+    uninstallHook(): void;
+}
+
 /**
  * Structured SDK error types.
  *
@@ -1155,4 +1257,4 @@ declare class SmplValidationError extends SmplError {
     constructor(message: string, statusCode?: number, responseBody?: string, errors?: ApiErrorObject[]);
 }
 
-export { type ApiErrorObject, BooleanFlag, Config, type ConfigChangeEvent, ConfigClient, Context, Flag, FlagChangeEvent, FlagStats, FlagsClient, JsonFlag, LiveConfigProxy, LogGroup, LogLevel, Logger, type LoggerChangeEvent, LoggingClient, NumberFlag, Rule, SharedWebSocket, SmplClient, type SmplClientOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, StringFlag };
+export { type ApiErrorObject, BooleanFlag, Config, type ConfigChangeEvent, ConfigClient, Context, Flag, FlagChangeEvent, FlagStats, FlagsClient, JsonFlag, LiveConfigProxy, LogGroup, LogLevel, Logger, type LoggerChangeEvent, type LoggingAdapter, LoggingClient, NumberFlag, PinoAdapter, type PinoAdapterConfig, Rule, SharedWebSocket, SmplClient, type SmplClientOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, StringFlag, WinstonAdapter, type WinstonAdapterConfig };

package/dist/index.d.ts

@@ -53,7 +53,7 @@ declare class SharedWebSocket {
  * A configuration resource managed by the smplkit platform.
  *
  * Management: mutate properties directly and call `save()` to persist.
- * POST if `id` is null (new), PUT if `id` is set (update).
+ * Creates if new, updates if existing.
  */
 declare class Config {
     /** UUID of the config, or `null` if unsaved. */
@@ -70,8 +70,7 @@ declare class Config {
     items: Record<string, unknown>;
     /**
      * Per-environment overrides.
-     * Stored as `{ env_name: { values: { key: value } } }` — values are
-     * unwrapped from the server's `{ value: raw }` wrapper.
+     * Structured as `{ env_name: { values: { key: value } } }`.
      */
     environments: Record<string, unknown>;
     /** When the config was created, or null if unavailable. */
@@ -95,7 +94,7 @@ declare class Config {
     /**
      * Persist this config to the server.
      *
-     * POST if `id` is null (new config), PUT if `id` is set (update).
+     * Creates if new, updates if existing.
      * Updates this instance in-place with the server response.
      */
     save(): Promise<void>;
@@ -118,17 +117,17 @@ declare class Config {
 }
 
 /**
- * LiveConfigProxy — ES6 Proxy-based live configuration access.
+ * LiveConfigProxy — live configuration access.
  *
- * Property reads are delegated to the latest resolved values in the
- * ConfigClient cache. When the cache updates via WebSocket, subsequent
- * reads automatically reflect the new values.
+ * Property reads always return the latest resolved values. When the
+ * underlying config changes, subsequent reads automatically reflect
+ * the new values.
  */
 
 /**
  * A live proxy that auto-updates when the underlying config changes.
  *
- * Access properties directly — each read re-resolves from the cache.
+ * Access properties directly — each read returns the latest resolved value.
  *
  * @example
  * ```typescript
@@ -208,8 +207,8 @@ declare class ConfigClient {
     /**
      * Resolve a config's values for the current environment.
      *
-     * Returns a flat dict of resolved key-value pairs, walking the
-     * parent chain and applying environment overrides.
+     * Returns a flat dict of resolved key-value pairs with inherited
+     * values and environment overrides applied.
      *
      * Optionally pass a model class to map the resolved values.
      */
@@ -230,7 +229,7 @@ declare class ConfigClient {
      */
     onChange(callbackOrConfigKey: string | ((event: ConfigChangeEvent) => void), callbackOrItemKey?: string | ((event: ConfigChangeEvent) => void), callback?: (event: ConfigChangeEvent) => void): void;
     /**
-     * Re-fetch all configs, re-resolve values, and update the cache.
+     * Re-fetch all configs and re-resolve values.
      * Fires change listeners for any values that differ.
      */
     refresh(): Promise<void>;
@@ -529,8 +528,8 @@ declare class Rule {
 /**
  * A flag resource that doubles as a runtime handle.
  *
- * Management: call `save()` to persist (POST if new, PUT if existing).
- * Runtime: call `get()` for local JSON Logic evaluation.
+ * Management: call `save()` to persist (creates if new, updates if existing).
+ * Runtime: call `get()` to evaluate the flag locally.
  */
 declare class Flag {
     /** UUID of the flag, or `null` if unsaved. */
@@ -577,7 +576,7 @@ declare class Flag {
     /**
      * Persist this flag to the server.
      *
-     * POST if `id` is null (new flag), PUT if `id` is set (update).
+     * Creates if new, updates if existing.
      * Updates this instance in-place with the server response.
      */
     save(): Promise<void>;
@@ -597,7 +596,7 @@ declare class Flag {
     /** Clear all rules for a specific environment (sync local mutation). */
     clearRules(envKey: string): void;
     /**
-     * Evaluate the flag locally (sync, no HTTP).
+     * Evaluate the flag locally.
      *
      * Requires `initialize()` to have been called.
      */
@@ -635,10 +634,6 @@ declare class JsonFlag extends Flag {
 
 /**
  * FlagsClient — management + prescriptive runtime for Smpl Flags.
- *
- * Uses the generated OpenAPI types (`src/generated/flags.d.ts`) via
- * `openapi-fetch` for all flag HTTP calls. Context registration uses
- * the generated app service types (`src/generated/app.d.ts`).
  */
 
 type FlagResource = components["schemas"]["FlagResource"];
@@ -773,16 +768,18 @@ declare class FlagsClient {
      */
     onChange(callbackOrKey: string | ((event: FlagChangeEvent) => void), callback?: (event: FlagChangeEvent) => void): void;
     /**
-     * Explicitly register context(s) for background batch registration.
+     * Register context(s) with the server.
      *
-     * Accepts a single Context or an array. Fire-and-forget — never
-     * blocks. Works before `initialize()` is called.
+     * Accepts a single Context or an array. Registration is asynchronous
+     * and never blocks. Works before `initialize()` is called.
      */
     register(context: Context | Context[]): void;
     /** Flush pending context registrations to the server. */
     flushContexts(): Promise<void>;
     /**
-     * Tier 1 explicit evaluation — stateless, no provider or cache.
+     * Evaluate a flag with an explicit environment and context.
+     *
+     * Stateless — does not use the context provider or cached results.
      */
     evaluate(key: string, options: {
         environment: string;
@@ -877,7 +874,7 @@ declare class Logger {
     /**
      * Persist this logger to the server.
      *
-     * POST if `id` is null (new), PUT if `id` is set (update).
+     * Creates if new, updates if existing.
      */
     save(): Promise<void>;
     /** Set the base log level (sync local mutation). */
@@ -932,7 +929,7 @@ declare class LogGroup {
     /**
      * Persist this log group to the server.
      *
-     * POST if `id` is null (new), PUT if `id` is set (update).
+     * Creates if new, updates if existing.
      */
     save(): Promise<void>;
     /** Set the base log level (sync local mutation). */
@@ -951,10 +948,40 @@ declare class LogGroup {
 }
 
 /**
- * LoggingClient — management plane + scaffolded runtime for Smpl Logging.
+ * Contract for pluggable logging framework integration.
  *
- * Uses the generated OpenAPI types (`src/generated/logging.d.ts`) via
- * `openapi-fetch` for all HTTP calls.
+ * Adapters bridge the smplkit logging runtime to a specific logging
+ * framework (e.g., Winston, Pino).
+ */
+interface LoggingAdapter {
+    /** Human-readable adapter name for diagnostics (e.g., 'winston'). */
+    readonly name: string;
+    /**
+     * Scan the runtime for existing loggers.
+     * Returns an array of { name, level } where level is a smplkit level string.
+     */
+    discover(): Array<{
+        name: string;
+        level: string;
+    }>;
+    /**
+     * Set the level on a specific logger.
+     * @param loggerName - The original (non-normalized) logger name.
+     * @param level - smplkit level string (e.g., 'DEBUG', 'INFO', 'WARN').
+     */
+    applyLevel(loggerName: string, level: string): void;
+    /**
+     * Install continuous discovery hook.
+     * The callback receives (original_name, smplkit_level_string) whenever
+     * a new logger is created in the framework.
+     */
+    installHook(onNewLogger: (name: string, level: string) => void): void;
+    /** Remove the hook installed by installHook(). Called on client close(). */
+    uninstallHook(): void;
+}
+
+/**
+ * LoggingClient — management plane + scaffolded runtime for Smpl Logging.
  */
 
 /**
@@ -979,8 +1006,17 @@ declare class LoggingClient {
     private _started;
     private _globalListeners;
     private _keyListeners;
+    private _adapters;
+    private _explicitAdapters;
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
+    /**
+     * Register a logging framework adapter.
+     *
+     * Must be called before `start()`. Disables auto-loading of built-in
+     * adapters — only explicitly registered adapters will be used.
+     */
+    registerAdapter(adapter: LoggingAdapter): void;
     /** Create an unsaved logger. Call `.save()` to persist. */
     new(key: string, options?: {
         name?: string;
@@ -1010,11 +1046,12 @@ declare class LoggingClient {
     /**
      * Start the logging runtime.
      *
-     * Fetches existing loggers/groups and wires WebSocket listeners for
-     * live updates. Idempotent — safe to call multiple times.
+     * Discovers loggers from registered adapters, syncs them with the
+     * server, applies server-side log levels, and subscribes to live
+     * level updates.
      *
-     * Note: Node.js auto-discovery (equivalent to Python's logging module
-     * monkey-patching) is deferred. Management methods work without start().
+     * Idempotent — safe to call multiple times.
+     * Management methods work without start().
      */
     start(): Promise<void>;
     /**
@@ -1026,6 +1063,12 @@ declare class LoggingClient {
     onChange(callbackOrKey: string | ((event: LoggerChangeEvent) => void), callback?: (event: LoggerChangeEvent) => void): void;
     /** @internal */
     _close(): void;
+    /** Auto-load built-in adapters by attempting to require each framework. */
+    private _autoLoadAdapters;
+    /** Apply resolved levels from server loggers to all adapters. */
+    private _applyLevels;
+    /** Called by adapter hooks when a new logger is created in the framework. */
+    private _onAdapterNewLogger;
     private _handleLoggerChanged;
     private _loggerToModel;
     private _groupToModel;
@@ -1109,6 +1152,65 @@ declare class SmplClient {
     close(): void;
 }
 
+/**
+ * Winston logging framework adapter.
+ *
+ * Integrates the smplkit logging runtime with Winston. Discovers
+ * existing loggers, tracks new logger creation, and applies
+ * server-managed log levels.
+ */
+
+interface WinstonAdapterConfig {
+    /** Whether to include the default logger in discovery (default: true). */
+    discoverDefault?: boolean;
+    /** @internal — inject a winston module for testing. */
+    _winston?: unknown;
+}
+declare class WinstonAdapter implements LoggingAdapter {
+    readonly name = "winston";
+    private readonly _discoverDefault;
+    private _winston;
+    private _originalAdd;
+    constructor(config?: WinstonAdapterConfig);
+    discover(): Array<{
+        name: string;
+        level: string;
+    }>;
+    applyLevel(loggerName: string, level: string): void;
+    installHook(onNewLogger: (name: string, level: string) => void): void;
+    uninstallHook(): void;
+}
+
+/**
+ * Pino logging framework adapter.
+ *
+ * Integrates the smplkit logging runtime with Pino. Tracks logger
+ * instances (including child loggers) for discovery and level control.
+ */
+
+interface PinoAdapterConfig {
+    /** Which binding field to use as the logger name (default: 'name'). */
+    nameField?: string;
+    /** @internal — inject a pino module for testing. */
+    _pino?: unknown;
+}
+declare class PinoAdapter implements LoggingAdapter {
+    readonly name = "pino";
+    private readonly _nameField;
+    private _pino;
+    private _registry;
+    private _originalPino;
+    private _pinoModule;
+    constructor(config?: PinoAdapterConfig);
+    discover(): Array<{
+        name: string;
+        level: string;
+    }>;
+    applyLevel(loggerName: string, level: string): void;
+    installHook(onNewLogger: (name: string, level: string) => void): void;
+    uninstallHook(): void;
+}
+
 /**
  * Structured SDK error types.
  *
@@ -1155,4 +1257,4 @@ declare class SmplValidationError extends SmplError {
     constructor(message: string, statusCode?: number, responseBody?: string, errors?: ApiErrorObject[]);
 }
 
-export { type ApiErrorObject, BooleanFlag, Config, type ConfigChangeEvent, ConfigClient, Context, Flag, FlagChangeEvent, FlagStats, FlagsClient, JsonFlag, LiveConfigProxy, LogGroup, LogLevel, Logger, type LoggerChangeEvent, LoggingClient, NumberFlag, Rule, SharedWebSocket, SmplClient, type SmplClientOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, StringFlag };
+export { type ApiErrorObject, BooleanFlag, Config, type ConfigChangeEvent, ConfigClient, Context, Flag, FlagChangeEvent, FlagStats, FlagsClient, JsonFlag, LiveConfigProxy, LogGroup, LogLevel, Logger, type LoggerChangeEvent, type LoggingAdapter, LoggingClient, NumberFlag, PinoAdapter, type PinoAdapterConfig, Rule, SharedWebSocket, SmplClient, type SmplClientOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, StringFlag, WinstonAdapter, type WinstonAdapterConfig };