@smplkit/sdk 1.3.38 → 1.3.40

package/dist/index.d.cts

@@ -176,6 +176,27 @@ interface ConfigChangeEvent {
     /** How the change was delivered. */
     source: "websocket" | "manual";
 }
+/**
+ * Management API for smplkit Config — CRUD operations on Config models.
+ *
+ * Access via `SmplClient.config.management`.
+ */
+declare class ConfigManagement {
+    private readonly _client;
+    constructor(_client: ConfigClient);
+    /** Create an unsaved config. Call `.save()` to persist. */
+    new(id: string, options?: {
+        name?: string;
+        description?: string;
+        parent?: string;
+    }): Config;
+    /** Fetch a config by id. */
+    get(id: string): Promise<Config>;
+    /** List all configs. */
+    list(): Promise<Config[]>;
+    /** Delete a config by id. */
+    delete(id: string): Promise<void>;
+}
 /**
  * Client for the smplkit Config API.
  *
@@ -196,23 +217,23 @@ declare class ConfigClient {
         readonly _service: string | null;
         readonly _metrics: MetricsReporter | null;
     } | null;
+    /** Management API — CRUD operations on Config models. */
+    readonly management: ConfigManagement;
     private _configCache;
     private _initialized;
     private _listeners;
     /** @internal */
     constructor(apiKey: string, timeout?: number);
-    /** Create an unsaved config. Call `.save()` to persist. */
-    new(id: string, options?: {
+    /** @internal */
+    _mgNew(id: string, options?: {
         name?: string;
         description?: string;
         parent?: string;
     }): Config;
-    /** Fetch a config by id. */
-    get(id: string): Promise<Config>;
-    /** List all configs. */
-    list(): Promise<Config[]>;
-    /** Delete a config by id. */
-    delete(id: string): Promise<void>;
+    /** @internal */
+    _mgList(): Promise<Config[]>;
+    /** @internal */
+    _mgDelete(id: string): Promise<void>;
     /** @internal — POST a new config. */
     _createConfig(config: Config): Promise<Config>;
     /** @internal — PUT a config update. */
@@ -220,12 +241,12 @@ declare class ConfigClient {
     /** @internal — fetch a config by id. */
     _getById(id: string): Promise<Config>;
     /**
-     * Resolve a config's values for the current environment.
+     * Get a config's resolved values for the current environment.
      *
      * Returns the resolved key-value pairs for the given config.
      * Optionally pass a model class to map the resolved values.
      */
-    resolve<T = Record<string, unknown>>(id: string, model?: new (data: any) => T): Promise<T>;
+    get<T = Record<string, unknown>>(id: string, model?: new (data: any) => T): Promise<T>;
     /**
      * Subscribe to a config's values. Returns a proxy whose properties
      * always reflect the latest resolved values.
@@ -645,6 +666,57 @@ declare class FlagStats {
     readonly cacheMisses: number;
     constructor(cacheHits: number, cacheMisses: number);
 }
+/**
+ * Management API for smplkit Flags — CRUD operations on Flag models.
+ *
+ * Access via `SmplClient.flags.management`.
+ */
+declare class FlagsManagement {
+    private readonly _client;
+    constructor(_client: FlagsClient);
+    /** Create an unsaved boolean flag. Call `.save()` to persist. */
+    newBooleanFlag(id: string, options: {
+        default: boolean;
+        name?: string;
+        description?: string;
+    }): BooleanFlag;
+    /** Create an unsaved string flag. Call `.save()` to persist. */
+    newStringFlag(id: string, options: {
+        default: string;
+        name?: string;
+        description?: string;
+        values?: Array<{
+            name: string;
+            value: unknown;
+        }>;
+    }): StringFlag;
+    /** Create an unsaved number flag. Call `.save()` to persist. */
+    newNumberFlag(id: string, options: {
+        default: number;
+        name?: string;
+        description?: string;
+        values?: Array<{
+            name: string;
+            value: unknown;
+        }>;
+    }): NumberFlag;
+    /** Create an unsaved JSON flag. Call `.save()` to persist. */
+    newJsonFlag(id: string, options: {
+        default: Record<string, any>;
+        name?: string;
+        description?: string;
+        values?: Array<{
+            name: string;
+            value: unknown;
+        }>;
+    }): JsonFlag;
+    /** Fetch a flag by id. */
+    get(id: string): Promise<Flag>;
+    /** List all flags. */
+    list(): Promise<Flag[]>;
+    /** Delete a flag by id. */
+    delete(id: string): Promise<void>;
+}
 /**
  * Client for the smplkit Flags API.
  *
@@ -676,16 +748,18 @@ declare class FlagsClient {
         readonly _service: string | null;
         readonly _metrics: MetricsReporter | null;
     } | null;
+    /** Management API — CRUD operations on Flag models. */
+    readonly management: FlagsManagement;
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
-    /** Create an unsaved boolean flag. Call `.save()` to persist. */
-    newBooleanFlag(id: string, options: {
+    /** @internal */
+    _mgNewBooleanFlag(id: string, options: {
         default: boolean;
         name?: string;
         description?: string;
     }): BooleanFlag;
-    /** Create an unsaved string flag. Call `.save()` to persist. */
-    newStringFlag(id: string, options: {
+    /** @internal */
+    _mgNewStringFlag(id: string, options: {
         default: string;
         name?: string;
         description?: string;
@@ -694,8 +768,8 @@ declare class FlagsClient {
             value: unknown;
         }>;
     }): StringFlag;
-    /** Create an unsaved number flag. Call `.save()` to persist. */
-    newNumberFlag(id: string, options: {
+    /** @internal */
+    _mgNewNumberFlag(id: string, options: {
         default: number;
         name?: string;
         description?: string;
@@ -704,8 +778,8 @@ declare class FlagsClient {
             value: unknown;
         }>;
     }): NumberFlag;
-    /** Create an unsaved JSON flag. Call `.save()` to persist. */
-    newJsonFlag(id: string, options: {
+    /** @internal */
+    _mgNewJsonFlag(id: string, options: {
         default: Record<string, any>;
         name?: string;
         description?: string;
@@ -714,12 +788,12 @@ declare class FlagsClient {
             value: unknown;
         }>;
     }): JsonFlag;
-    /** Fetch a flag by id. */
-    get(id: string): Promise<Flag>;
-    /** List all flags. */
-    list(): Promise<Flag[]>;
-    /** Delete a flag by id. */
-    delete(id: string): Promise<void>;
+    /** @internal */
+    _mgGet(id: string): Promise<Flag>;
+    /** @internal */
+    _mgList(): Promise<Flag[]>;
+    /** @internal */
+    _mgDelete(id: string): Promise<void>;
     /** @internal — POST a new flag. */
     _createFlag(flag: Flag): Promise<Flag>;
     /** @internal — PUT a flag update. */
@@ -966,6 +1040,37 @@ interface LoggingAdapter {
  * LoggingClient — management and runtime for Smpl Logging.
  */
 
+/**
+ * Management API for smplkit Logging — CRUD operations on Logger and LogGroup models.
+ *
+ * Access via `SmplClient.logging.management`.
+ */
+declare class LoggingManagement {
+    private readonly _client;
+    constructor(_client: LoggingClient);
+    /** Create an unsaved logger. Call `.save()` to persist. */
+    new(id: string, options?: {
+        name?: string;
+        managed?: boolean;
+    }): Logger;
+    /** Fetch a logger by id. */
+    get(id: string): Promise<Logger>;
+    /** List all loggers. */
+    list(): Promise<Logger[]>;
+    /** Delete a logger by id. */
+    delete(id: string): Promise<void>;
+    /** Create an unsaved log group. Call `.save()` to persist. */
+    newGroup(id: string, options?: {
+        name?: string;
+        group?: string;
+    }): LogGroup;
+    /** Fetch a log group by id. */
+    getGroup(id: string): Promise<LogGroup>;
+    /** List all log groups. */
+    listGroups(): Promise<LogGroup[]>;
+    /** Delete a log group by id. */
+    deleteGroup(id: string): Promise<void>;
+}
 /**
  * Client for the smplkit Logging API.
  *
@@ -984,6 +1089,8 @@ declare class LoggingClient {
         readonly _service: string | null;
         readonly _metrics: MetricsReporter | null;
     } | null;
+    /** Management API — CRUD operations on Logger and LogGroup models. */
+    readonly management: LoggingManagement;
     private readonly _ensureWs;
     private _wsManager;
     private _started;
@@ -1000,28 +1107,28 @@ declare class LoggingClient {
      * registered adapters will be used.
      */
     registerAdapter(adapter: LoggingAdapter): void;
-    /** Create an unsaved logger. Call `.save()` to persist. */
-    new(id: string, options?: {
+    /** @internal */
+    _mgNew(id: string, options?: {
         name?: string;
         managed?: boolean;
     }): Logger;
-    /** Fetch a logger by id. */
-    get(id: string): Promise<Logger>;
-    /** List all loggers. */
-    list(): Promise<Logger[]>;
-    /** Delete a logger by id. */
-    delete(id: string): Promise<void>;
-    /** Create an unsaved log group. Call `.save()` to persist. */
-    newGroup(id: string, options?: {
+    /** @internal */
+    _mgGet(id: string): Promise<Logger>;
+    /** @internal */
+    _mgList(): Promise<Logger[]>;
+    /** @internal */
+    _mgDelete(id: string): Promise<void>;
+    /** @internal */
+    _mgNewGroup(id: string, options?: {
         name?: string;
         group?: string;
     }): LogGroup;
-    /** Fetch a log group by id. */
-    getGroup(id: string): Promise<LogGroup>;
-    /** List all log groups. */
-    listGroups(): Promise<LogGroup[]>;
-    /** Delete a log group by id. */
-    deleteGroup(id: string): Promise<void>;
+    /** @internal */
+    _mgGetGroup(id: string): Promise<LogGroup>;
+    /** @internal */
+    _mgListGroups(): Promise<LogGroup[]>;
+    /** @internal */
+    _mgDeleteGroup(id: string): Promise<void>;
     /** @internal — POST or PUT a logger. */
     _saveLogger(logger: Logger): Promise<Logger>;
     /** @internal — POST or PUT a log group. */
@@ -1111,7 +1218,7 @@ interface SmplClientOptions {
  * console.log(flag.get());
  *
  * // Config runtime
- * const values = await client.config.resolve("user-service");
+ * const values = await client.config.get("user-service");
  * ```
  */
 declare class SmplClient {
@@ -1238,4 +1345,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, type LoggingAdapter, LoggingClient, NumberFlag, PinoAdapter, type PinoAdapterConfig, Rule, SharedWebSocket, SmplClient, type SmplClientOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, StringFlag, WinstonAdapter, type WinstonAdapterConfig };
+export { type ApiErrorObject, BooleanFlag, Config, type ConfigChangeEvent, ConfigClient, ConfigManagement, Context, Flag, FlagChangeEvent, FlagStats, FlagsClient, FlagsManagement, JsonFlag, LiveConfigProxy, LogGroup, LogLevel, Logger, type LoggerChangeEvent, type LoggingAdapter, LoggingClient, LoggingManagement, NumberFlag, PinoAdapter, type PinoAdapterConfig, Rule, SharedWebSocket, SmplClient, type SmplClientOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, StringFlag, WinstonAdapter, type WinstonAdapterConfig };

package/dist/index.d.ts

@@ -176,6 +176,27 @@ interface ConfigChangeEvent {
     /** How the change was delivered. */
     source: "websocket" | "manual";
 }
+/**
+ * Management API for smplkit Config — CRUD operations on Config models.
+ *
+ * Access via `SmplClient.config.management`.
+ */
+declare class ConfigManagement {
+    private readonly _client;
+    constructor(_client: ConfigClient);
+    /** Create an unsaved config. Call `.save()` to persist. */
+    new(id: string, options?: {
+        name?: string;
+        description?: string;
+        parent?: string;
+    }): Config;
+    /** Fetch a config by id. */
+    get(id: string): Promise<Config>;
+    /** List all configs. */
+    list(): Promise<Config[]>;
+    /** Delete a config by id. */
+    delete(id: string): Promise<void>;
+}
 /**
  * Client for the smplkit Config API.
  *
@@ -196,23 +217,23 @@ declare class ConfigClient {
         readonly _service: string | null;
         readonly _metrics: MetricsReporter | null;
     } | null;
+    /** Management API — CRUD operations on Config models. */
+    readonly management: ConfigManagement;
     private _configCache;
     private _initialized;
     private _listeners;
     /** @internal */
     constructor(apiKey: string, timeout?: number);
-    /** Create an unsaved config. Call `.save()` to persist. */
-    new(id: string, options?: {
+    /** @internal */
+    _mgNew(id: string, options?: {
         name?: string;
         description?: string;
         parent?: string;
     }): Config;
-    /** Fetch a config by id. */
-    get(id: string): Promise<Config>;
-    /** List all configs. */
-    list(): Promise<Config[]>;
-    /** Delete a config by id. */
-    delete(id: string): Promise<void>;
+    /** @internal */
+    _mgList(): Promise<Config[]>;
+    /** @internal */
+    _mgDelete(id: string): Promise<void>;
     /** @internal — POST a new config. */
     _createConfig(config: Config): Promise<Config>;
     /** @internal — PUT a config update. */
@@ -220,12 +241,12 @@ declare class ConfigClient {
     /** @internal — fetch a config by id. */
     _getById(id: string): Promise<Config>;
     /**
-     * Resolve a config's values for the current environment.
+     * Get a config's resolved values for the current environment.
      *
      * Returns the resolved key-value pairs for the given config.
      * Optionally pass a model class to map the resolved values.
      */
-    resolve<T = Record<string, unknown>>(id: string, model?: new (data: any) => T): Promise<T>;
+    get<T = Record<string, unknown>>(id: string, model?: new (data: any) => T): Promise<T>;
     /**
      * Subscribe to a config's values. Returns a proxy whose properties
      * always reflect the latest resolved values.
@@ -645,6 +666,57 @@ declare class FlagStats {
     readonly cacheMisses: number;
     constructor(cacheHits: number, cacheMisses: number);
 }
+/**
+ * Management API for smplkit Flags — CRUD operations on Flag models.
+ *
+ * Access via `SmplClient.flags.management`.
+ */
+declare class FlagsManagement {
+    private readonly _client;
+    constructor(_client: FlagsClient);
+    /** Create an unsaved boolean flag. Call `.save()` to persist. */
+    newBooleanFlag(id: string, options: {
+        default: boolean;
+        name?: string;
+        description?: string;
+    }): BooleanFlag;
+    /** Create an unsaved string flag. Call `.save()` to persist. */
+    newStringFlag(id: string, options: {
+        default: string;
+        name?: string;
+        description?: string;
+        values?: Array<{
+            name: string;
+            value: unknown;
+        }>;
+    }): StringFlag;
+    /** Create an unsaved number flag. Call `.save()` to persist. */
+    newNumberFlag(id: string, options: {
+        default: number;
+        name?: string;
+        description?: string;
+        values?: Array<{
+            name: string;
+            value: unknown;
+        }>;
+    }): NumberFlag;
+    /** Create an unsaved JSON flag. Call `.save()` to persist. */
+    newJsonFlag(id: string, options: {
+        default: Record<string, any>;
+        name?: string;
+        description?: string;
+        values?: Array<{
+            name: string;
+            value: unknown;
+        }>;
+    }): JsonFlag;
+    /** Fetch a flag by id. */
+    get(id: string): Promise<Flag>;
+    /** List all flags. */
+    list(): Promise<Flag[]>;
+    /** Delete a flag by id. */
+    delete(id: string): Promise<void>;
+}
 /**
  * Client for the smplkit Flags API.
  *
@@ -676,16 +748,18 @@ declare class FlagsClient {
         readonly _service: string | null;
         readonly _metrics: MetricsReporter | null;
     } | null;
+    /** Management API — CRUD operations on Flag models. */
+    readonly management: FlagsManagement;
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
-    /** Create an unsaved boolean flag. Call `.save()` to persist. */
-    newBooleanFlag(id: string, options: {
+    /** @internal */
+    _mgNewBooleanFlag(id: string, options: {
         default: boolean;
         name?: string;
         description?: string;
     }): BooleanFlag;
-    /** Create an unsaved string flag. Call `.save()` to persist. */
-    newStringFlag(id: string, options: {
+    /** @internal */
+    _mgNewStringFlag(id: string, options: {
         default: string;
         name?: string;
         description?: string;
@@ -694,8 +768,8 @@ declare class FlagsClient {
             value: unknown;
         }>;
     }): StringFlag;
-    /** Create an unsaved number flag. Call `.save()` to persist. */
-    newNumberFlag(id: string, options: {
+    /** @internal */
+    _mgNewNumberFlag(id: string, options: {
         default: number;
         name?: string;
         description?: string;
@@ -704,8 +778,8 @@ declare class FlagsClient {
             value: unknown;
         }>;
     }): NumberFlag;
-    /** Create an unsaved JSON flag. Call `.save()` to persist. */
-    newJsonFlag(id: string, options: {
+    /** @internal */
+    _mgNewJsonFlag(id: string, options: {
         default: Record<string, any>;
         name?: string;
         description?: string;
@@ -714,12 +788,12 @@ declare class FlagsClient {
             value: unknown;
         }>;
     }): JsonFlag;
-    /** Fetch a flag by id. */
-    get(id: string): Promise<Flag>;
-    /** List all flags. */
-    list(): Promise<Flag[]>;
-    /** Delete a flag by id. */
-    delete(id: string): Promise<void>;
+    /** @internal */
+    _mgGet(id: string): Promise<Flag>;
+    /** @internal */
+    _mgList(): Promise<Flag[]>;
+    /** @internal */
+    _mgDelete(id: string): Promise<void>;
     /** @internal — POST a new flag. */
     _createFlag(flag: Flag): Promise<Flag>;
     /** @internal — PUT a flag update. */
@@ -966,6 +1040,37 @@ interface LoggingAdapter {
  * LoggingClient — management and runtime for Smpl Logging.
  */
 
+/**
+ * Management API for smplkit Logging — CRUD operations on Logger and LogGroup models.
+ *
+ * Access via `SmplClient.logging.management`.
+ */
+declare class LoggingManagement {
+    private readonly _client;
+    constructor(_client: LoggingClient);
+    /** Create an unsaved logger. Call `.save()` to persist. */
+    new(id: string, options?: {
+        name?: string;
+        managed?: boolean;
+    }): Logger;
+    /** Fetch a logger by id. */
+    get(id: string): Promise<Logger>;
+    /** List all loggers. */
+    list(): Promise<Logger[]>;
+    /** Delete a logger by id. */
+    delete(id: string): Promise<void>;
+    /** Create an unsaved log group. Call `.save()` to persist. */
+    newGroup(id: string, options?: {
+        name?: string;
+        group?: string;
+    }): LogGroup;
+    /** Fetch a log group by id. */
+    getGroup(id: string): Promise<LogGroup>;
+    /** List all log groups. */
+    listGroups(): Promise<LogGroup[]>;
+    /** Delete a log group by id. */
+    deleteGroup(id: string): Promise<void>;
+}
 /**
  * Client for the smplkit Logging API.
  *
@@ -984,6 +1089,8 @@ declare class LoggingClient {
         readonly _service: string | null;
         readonly _metrics: MetricsReporter | null;
     } | null;
+    /** Management API — CRUD operations on Logger and LogGroup models. */
+    readonly management: LoggingManagement;
     private readonly _ensureWs;
     private _wsManager;
     private _started;
@@ -1000,28 +1107,28 @@ declare class LoggingClient {
      * registered adapters will be used.
      */
     registerAdapter(adapter: LoggingAdapter): void;
-    /** Create an unsaved logger. Call `.save()` to persist. */
-    new(id: string, options?: {
+    /** @internal */
+    _mgNew(id: string, options?: {
         name?: string;
         managed?: boolean;
     }): Logger;
-    /** Fetch a logger by id. */
-    get(id: string): Promise<Logger>;
-    /** List all loggers. */
-    list(): Promise<Logger[]>;
-    /** Delete a logger by id. */
-    delete(id: string): Promise<void>;
-    /** Create an unsaved log group. Call `.save()` to persist. */
-    newGroup(id: string, options?: {
+    /** @internal */
+    _mgGet(id: string): Promise<Logger>;
+    /** @internal */
+    _mgList(): Promise<Logger[]>;
+    /** @internal */
+    _mgDelete(id: string): Promise<void>;
+    /** @internal */
+    _mgNewGroup(id: string, options?: {
         name?: string;
         group?: string;
     }): LogGroup;
-    /** Fetch a log group by id. */
-    getGroup(id: string): Promise<LogGroup>;
-    /** List all log groups. */
-    listGroups(): Promise<LogGroup[]>;
-    /** Delete a log group by id. */
-    deleteGroup(id: string): Promise<void>;
+    /** @internal */
+    _mgGetGroup(id: string): Promise<LogGroup>;
+    /** @internal */
+    _mgListGroups(): Promise<LogGroup[]>;
+    /** @internal */
+    _mgDeleteGroup(id: string): Promise<void>;
     /** @internal — POST or PUT a logger. */
     _saveLogger(logger: Logger): Promise<Logger>;
     /** @internal — POST or PUT a log group. */
@@ -1111,7 +1218,7 @@ interface SmplClientOptions {
  * console.log(flag.get());
  *
  * // Config runtime
- * const values = await client.config.resolve("user-service");
+ * const values = await client.config.get("user-service");
  * ```
  */
 declare class SmplClient {
@@ -1238,4 +1345,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, type LoggingAdapter, LoggingClient, NumberFlag, PinoAdapter, type PinoAdapterConfig, Rule, SharedWebSocket, SmplClient, type SmplClientOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, StringFlag, WinstonAdapter, type WinstonAdapterConfig };
+export { type ApiErrorObject, BooleanFlag, Config, type ConfigChangeEvent, ConfigClient, ConfigManagement, Context, Flag, FlagChangeEvent, FlagStats, FlagsClient, FlagsManagement, JsonFlag, LiveConfigProxy, LogGroup, LogLevel, Logger, type LoggerChangeEvent, type LoggingAdapter, LoggingClient, LoggingManagement, NumberFlag, PinoAdapter, type PinoAdapterConfig, Rule, SharedWebSocket, SmplClient, type SmplClientOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, StringFlag, WinstonAdapter, type WinstonAdapterConfig };