@kosdev-code/kos-ui-sdk 2.0.45 → 2.0.46

package/models/models/index.d.ts

@@ -4,7 +4,6 @@ export * from './config-bean-prop';
 export * from './future';
 export * from './future-container';
 export * from './key-value';
-export * from './kos-expression-evaluator';
 export * from './kos-log-manager';
 export * from './kos-time';
 export * from './log-stream';

package/models/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/models/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/models/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/models/models/key-value/index.d.ts

@@ -1,9 +1,5 @@
 export type { KeyValueModel } from './key-value-model';
 export { KeyValue } from './key-value-registration';
-/**
- * @group KOS Model
- * @category Key-Value Store
- */
 export * as KeyValueServices from './services';
 export type * from './types';
 //# sourceMappingURL=index.d.ts.map

package/models/models/key-value/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/key-value/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD;;;GAGG;AACH,OAAO,KAAK,gBAAgB,MAAM,YAAY,CAAC;AAC/C,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/key-value/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,gBAAgB,MAAM,YAAY,CAAC;AAC/C,mBAAmB,SAAS,CAAC"}

package/models/models/key-value/key-value-model.d.ts

@@ -3,128 +3,17 @@ import { KeyValueUpdate } from './services';
 import { IKosDataModel, IKosIdentifiable, KosCreationContext, KosData, PublicModelInterface } from '../../../core';
 
 export declare const MODEL_TYPE = "key-value-model";
-/**
- * Key-Value Model - Persistent, reactive state storage with real-time synchronization across KOS applications.
- *
- * This model provides a namespaced key-value store that automatically persists data and synchronizes
- * changes across all connected clients in real-time. Perfect for storing user preferences, application
- * state, feature flags, or any data that needs to persist between sessions and sync across instances.
- *
- * ## Key Features
- * - **Persistent Storage** - Data survives application restarts and browser refreshes
- * - **Real-time Synchronization** - Changes propagate instantly to all connected clients
- * - **Namespace Isolation** - Multiple stores can coexist without key collisions
- * - **Type-Safe Values** - Supports string, number, boolean, and undefined types
- * - **Reactive Updates** - Automatic UI updates when values change (locally or remotely)
- * - **Topic-Based Sync** - Uses KOS event system for distributed state management
- *
- * ## Topic-Based Reactivity
- * The model listens to two KOS topics for real-time synchronization:
- * - **`/keyVal/set`** - Fired when any key-value pair is updated or added
- * - **`/keyVal/remove`** - Fired when a key is deleted from the store
- *
- * These topics ensure that all instances of the model with the same namespace stay
- * synchronized across browser tabs, windows, and even different client applications.
- * The model automatically filters events by namespace to ensure isolation.
- *
- * @interface
- *
- * @example Basic Usage
- * ```typescript
- * const preferences = KeyValue.instance('user-prefs')
- *   .options({ namespace: 'preferences' })
- *   .build();
- *
- * // Store values
- * await preferences.updateState('theme', 'dark');
- * await preferences.updateState('fontSize', 14);
- *
- * // Access reactive data
- * console.log(preferences.data.theme);     // 'dark'
- * console.log(preferences.data.fontSize);  // 14
- * ```
- *
- * @example React Integration
- * ```typescript
- * const UserSettings: React.FC = kosComponent(() => {
- *   const settings = useModel(KeyValue, 'app-settings');
- *
- *   return (
- *     <div>
- *       <p>Theme: {settings.data.theme || 'light'}</p>
- *       <button onClick={() => settings.updateState('theme', 'dark')}>
- *         Set Dark Theme
- *       </button>
- *     </div>
- *   );
- * });
- * ```
- *
- * @group KOS Model
- * @category State Management
- * @category Key-Value Store
- * @useDeclaredType
- * @see {@link KeyValueOptions} - Configuration options for key-value stores
- * @see {@link KeyValueUpdate} - Update event structure for synchronization
- */
 export type KeyValueModel = PublicModelInterface<KeyValueModelImpl>;
-/**
- * @ignore
- * @internal
- */
 export declare class KeyValueModelImpl implements IKosDataModel, IKosIdentifiable {
     id: string;
     private logger;
     private namespace;
     data: KosData<Record<string, string | number | boolean | undefined>>;
     constructor(modelId: string, options: KeyValueOptions, context: KosCreationContext);
-    /**
-     * @internal
-     */
     init(): Promise<void>;
-    /**
-     * Update or delete a key-value pair in the store.
-     *
-     * Changes are automatically persisted and synchronized across all instances
-     * with the same namespace via KOS topics.
-     *
-     * @param key - The key to update or delete
-     * @param value - The value to set (string | number | boolean), or undefined to delete the key
-     * @returns Promise that resolves when the operation completes
-     *
-     * @example
-     * ```typescript
-     * // Set a value
-     * await keyValue.updateState('theme', 'dark');
-     *
-     * // Delete a key
-     * await keyValue.updateState('theme', undefined);
-     * ```
-     */
     updateState(key: string, value: string | number | boolean | undefined): Promise<void>;
-    /**
-     * Load initial data from persistent storage.
-     *
-     * @internal
-     */
     load(): Promise<void>;
-    /**
-     * Topic handler for `/keyVal/set` events to sync updates across instances.
-     *
-     * Automatically called when any KeyValue model instance updates a value,
-     * ensuring all instances with the same namespace stay synchronized.
-     *
-     * @param update - The key-value update event containing namespace, key, and new value
-     */
     handleStateUpdate(update: KeyValueUpdate): void;
-    /**
-     * Topic handler for `/keyVal/remove` events to sync deletions across instances.
-     *
-     * Automatically called when any KeyValue model instance deletes a key,
-     * ensuring all instances with the same namespace stay synchronized.
-     *
-     * @param update - The key-value update event containing namespace and deleted key
-     */
     handleStateDelete(update: KeyValueUpdate): void;
 }
 //# sourceMappingURL=key-value-model.d.ts.map

package/models/models/key-value/key-value-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"key-value-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/key-value/key-value-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEhB,kBAAkB,EAClB,OAAO,EACP,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;AAEpE;;;GAGG;AACH,qBACa,iBAAkB,YAAW,aAAa,EAAE,gBAAgB;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;gBAEnE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,kBAAkB;IAQ7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;;;;;;;;;;;;;;;OAkBG;IACG,WAAW,CACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAC3C,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;;;;;OAOG;IAEH,iBAAiB,CAAC,MAAM,EAAE,cAAc;IAOxC;;;;;;;OAOG;IAEH,iBAAiB,CAAC,MAAM,EAAE,cAAc;CAMzC"}
+{"version":3,"file":"key-value-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/key-value/key-value-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEhB,kBAAkB,EAClB,OAAO,EACP,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;AAEpE,qBACa,iBAAkB,YAAW,aAAa,EAAE,gBAAgB;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;gBAEnE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,kBAAkB;IAUvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,WAAW,CACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAC3C,OAAO,CAAC,IAAI,CAAC;IAUV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,iBAAiB,CAAC,MAAM,EAAE,cAAc;IAQxC,iBAAiB,CAAC,MAAM,EAAE,cAAc;CAMzC"}

package/models/models/key-value/services/key-value-services.d.ts

@@ -1,140 +1,18 @@
-/**
- * @fileoverview Key-Value service functions for persistent data storage and retrieval.
- *
- * This module provides service functions for managing key-value pairs in KOS device storage.
- * Supports namespaced storage, CRUD operations, and typed value handling for configuration
- * data, user preferences, and application state persistence.
- *
- * @module KeyValueServices
- */
-/**
- * Response format for key-value data retrieval.
- *
- * Represents the structure of data returned from key-value service endpoints,
- * supporting primitive types commonly used for configuration and state data.
- *
- * @group KOS Model
- * @category Key-Value Store
- */
 interface KeyValueResponse {
-    /** Key-value pairs with primitive values */
     [key: string]: string | number | boolean;
 }
-/**
- * Update request format for key-value operations.
- *
- * Defines the structure for updating individual key-value pairs within
- * specific namespaces, supporting targeted updates without affecting
- * other stored data.
- *
- * @group KOS Model
- * @category Key-Value Store
- */
 export interface KeyValueUpdate {
-    /** Namespace identifier for data organization */
     namespace: string;
-    /** Specific key within the namespace */
     key: string;
-    /** Value to store (as string for API compatibility) */
     value: string;
 }
-/**
- * Removes a specific key-value pair from storage.
- *
- * Permanently deletes a key and its associated value from the specified namespace.
- * This operation cannot be undone, so use with caution for critical data.
- *
- * @param namespace - Namespace containing the key to delete
- * @param key - Specific key to remove from storage
- *
- * @throws {Error} When deletion request fails or service is unavailable
- *
- * @example Delete User Preference
- * ```typescript
- * await deleteKeyValue('user-preferences', 'theme-mode');
- * console.log('Theme preference cleared');
- * ```
- *
- * @group KOS Model
- * @category Key-Value Store
- */
 export declare const deleteKeyValue: (namespace: string, key: string) => Promise<void>;
-/**
- * Creates or updates a key-value pair in persistent storage.
- *
- * Stores a value under the specified key within the given namespace. If the key
- * already exists, its value will be overwritten. Supports primitive types with
- * automatic string conversion for API compatibility.
- *
- * @param namespace - Namespace for organizing related key-value pairs
- * @param key - Unique identifier within the namespace
- * @param value - Value to store (primitive types supported)
- * @returns Promise resolving to the stored value
- *
- * @throws {Error} When update request fails or service returns non-200 status
- *
- * @example Store Configuration Setting
- * ```typescript
- * await updateKeyValue('device-config', 'maxRetries', 5);
- * await updateKeyValue('user-prefs', 'darkMode', true);
- * await updateKeyValue('app-state', 'lastLogin', '2024-01-15');
- * ```
- *
- * @group KOS Model
- * @category Key-Value Store
- */
 export declare const updateKeyValue: (namespace: string, key: string, value: string | number | boolean) => Promise<any>;
 /**
- * Retrieves all key-value pairs from a specified namespace.
- *
- * Fetches all stored data within the given namespace as a complete object.
- * Useful for loading configuration sets, user preferences, or application
- * state data in bulk operations.
- *
- * @param namespace - Namespace to retrieve data from (defaults to "studio")
- * @returns Promise resolving to object containing all key-value pairs in namespace
- *
- * @throws {Error} When retrieval fails or service returns non-200 status
- *
- * @example Load Application Configuration
- * ```typescript
- * const appConfig = await getKeyValue('app-config');
- * console.log('Max retries:', appConfig.maxRetries);
- * console.log('Debug mode:', appConfig.debugMode);
- *
- * const userPrefs = await getKeyValue('user-preferences');
- * const theme = userPrefs.themeMode || 'light';
- * ```
- *
- * @group KOS Model
- * @category Key-Value Store
+ * @category Service
+ * Retrieves the initial studio-state data.
  */
 export declare const getKeyValue: (namespace?: string) => Promise<KeyValueResponse>;
-/**
- * Removes an entire namespace and all its key-value pairs.
- *
- * Permanently deletes all data within the specified namespace. This is a
- * destructive operation that cannot be undone. Use with extreme caution
- * for critical data or production systems.
- *
- * @param namespace - Namespace to completely remove from storage
- *
- * @throws {Error} When deletion request fails or service is unavailable
- *
- * @example Clear All User Preferences
- * ```typescript
- * // Warning: This removes ALL user preferences permanently
- * await deleteKeyValueNamespace('user-preferences');
- * console.log('All user preferences cleared');
- *
- * // Better: Clear specific preferences individually
- * await deleteKeyValue('user-preferences', 'theme-mode');
- * await deleteKeyValue('user-preferences', 'language');
- * ```
- *
- * @group KOS Model
- * @category Key-Value Store
- */
 export declare const deleteKeyValueNamespace: (namespace: string) => Promise<void>;
 export {};
 //# sourceMappingURL=key-value-services.d.ts.map

package/models/models/key-value/services/key-value-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"key-value-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/key-value/services/key-value-services.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH;;;;;;;;GAQG;AACH,UAAU,gBAAgB;IACxB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,cAAqB,MAAM,OAAO,MAAM,kBAKlE,CAAC;AACF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,cACd,MAAM,OACZ,MAAM,SACJ,MAAM,GAAG,MAAM,GAAG,OAAO,iBAcjC,CAAC;AACF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,mDAavB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,uBAAuB,cAAqB,MAAM,kBAK9D,CAAC"}
+{"version":3,"file":"key-value-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/key-value/services/key-value-services.ts"],"names":[],"mappings":"AAUA,UAAU,gBAAgB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,cAAc,cAAqB,MAAM,OAAO,MAAM,kBAKlE,CAAC;AACF,eAAO,MAAM,cAAc,cACd,MAAM,OACZ,MAAM,SACJ,MAAM,GAAG,MAAM,GAAG,OAAO,iBAcjC,CAAC;AACF;;;GAGG;AACH,eAAO,MAAM,WAAW,mDAavB,CAAC;AAEF,eAAO,MAAM,uBAAuB,cAAqB,MAAM,kBAK9D,CAAC"}

package/models/models/key-value/types/index.d.ts

@@ -1,60 +1,3 @@
-/**
- * Configuration options for creating KeyValue model instances.
- *
- * The namespace option allows you to create isolated key-value stores that don't
- * interfere with each other, even when using the same keys. This is essential for
- * organizing different types of data and preventing key collisions.
- *
- * @example Default Namespace
- * ```typescript
- * // Uses default 'studio' namespace
- * const store = KeyValue.instance('my-store')
- *   .options({})
- *   .build();
- * ```
- *
- * @example Custom Namespace
- * ```typescript
- * // Create isolated stores with custom namespaces
- * const userStore = KeyValue.instance('user')
- *   .options({ namespace: 'user-data' })
- *   .build();
- *
- * const appStore = KeyValue.instance('app')
- *   .options({ namespace: 'app-state' })
- *   .build();
- *
- * // Same key, different namespaces = no collision
- * await userStore.updateState('id', 'user-123');
- * await appStore.updateState('id', 'app-456');
- * ```
- *
- * @example Namespace Conventions
- * ```typescript
- * // Recommended namespace patterns
- * const examples: KeyValueOptions[] = [
- *   { namespace: 'user-preferences' },     // User-specific settings
- *   { namespace: 'application-state' },    // Global app state
- *   { namespace: 'feature-flags' },        // Feature toggles
- *   { namespace: 'session-data' },         // Session-specific data
- *   { namespace: 'cache-layer' },          // Cached API responses
- *   { namespace: 'dev-tools' }             // Development/debug data
- * ];
- * ```
- *
- * @kosService core.key-value
- * @group KOS Model
- * @category Data Persistence
- * @category Key-Value Store
- */
 export interface KeyValueOptions {
-  /**
-   * Namespace for the key-value store to prevent key collisions between different stores.
-   *
-   * Defaults to 'studio' if not specified. Choose descriptive namespaces that clearly
-   * indicate the purpose of the stored data.
-   *
-   * @default 'studio'
-   */
   namespace?: string;
 }

package/models/models/kos-log-manager/kos-log-manager-model.d.ts

@@ -10,68 +10,23 @@ import { KosRequest, KosResponse } from '../../../core';
  */
 export declare const MODEL_TYPE = "kos-log-manager-model";
 /**
- * KOS Log Manager Model - Centralized runtime log level management for the entire KOS system.
- *
- * This singleton model provides comprehensive control over logging behavior across the KOS UI SDK
- * and connected applications. It manages dynamic log level overrides, responds to real-time
- * configuration changes, and provides both REST API and WebSocket interfaces for log management.
- * Essential for debugging, performance monitoring, and production troubleshooting.
- *
- * ## Key Features
- * - **Runtime Log Level Control** - Dynamically adjust log levels without application restart
- * - **Hierarchical Logger Management** - Apply overrides to parent loggers and all children
- * - **Real-time Configuration** - WebSocket-based updates propagate instantly across clients
- * - **REST API Integration** - Query and manage logger configurations via HTTP endpoints
- * - **Override Persistence** - Log overrides are maintained across sessions and page refreshes
- * - **Multi-Node Support** - Coordinate logging across different KOS device nodes
- *
- * ## Topic-Based Reactivity
- * The model listens to these KOS topics for real-time log management:
- * - **`/kos/logs/override/add/*`** - Fired when new log level overrides are created
- * - **`/kos/logs/override/remove/*`** - Fired when log level overrides are removed
- *
- * Both topics support wildcard capture for node type targeting, enabling precise
- * control over which device nodes receive logging configuration changes.
- *
- * ## Architecture Integration
- * The log manager integrates with the broader KOS logging ecosystem:
- * - **KosLog System** - Manages underlying logger instances and level settings
- * - **LogStreamModel** - Streams managed by this model's log level policies
- * - **LogBlockModel** - Individual log entries governed by level settings
- * - **REST Endpoints** - Provides `/api/kos/ui/loggers` for external access
- *
- * ## Common Use Cases
- * - **Development Debugging** - Increase log verbosity for specific components during development
- * - **Production Troubleshooting** - Temporarily enable debug logging to diagnose issues
- * - **Performance Monitoring** - Adjust log levels to reduce overhead in production
- * - **System Administration** - Centrally manage logging across distributed KOS deployments
- * - **Dynamic Configuration** - Change logging behavior without service interruption
- * - **Selective Logging** - Enable detailed logging for specific modules while keeping others quiet
- *
- * @interface
- * @example Basic Usage
- * ```typescript
- * const logManager = KosLogManager.instance('log-control').build();
- *
- * // Get all current logger configurations via REST API
- * const loggers = await logManager.getAllLoggers();
- * console.log(`Managing ${loggers.length} loggers`);
- * ```
- *
- * @group KOS Model
- * @category Device Logging
- * @useDeclaredType
- *
- * @see {@link LogStreamModel} - Streams whose content is governed by log levels managed here
- * @see {@link LogBlockModel} - Individual log entries affected by level settings
- * @see {@link KosLogManagerOptions} - Configuration options for the log manager
- * @see {@link LogOverride} - Log level override structure for runtime control
- * @see {@link LogLevelDescriptor} - Logger information structure returned by REST API
+ * Public interface for the KOS Log Manager Model.
+ * Provides runtime log level management capabilities for the KOS UI SDK.
  */
 export type KosLogManagerModel = PublicModelInterface<KosLogManagerModelImpl>;
 /**
- * @ignore
- * @internal
+ * Implementation of the KOS Log Manager Model.
+ *
+ * This model manages log levels for different loggers in the KOS system,
+ * allowing dynamic runtime configuration of logging verbosity.
+ *
+ * Key features:
+ * - Maintains a collection of log level overrides
+ * - Responds to WebSocket events for adding/removing log overrides
+ * - Provides REST API endpoint for retrieving all logger configurations
+ * - Automatically applies log level changes to matching loggers
+ *
+ * @kosModel Decorated as a KOS model with type 'kos-log-manager-model'
  */
 export declare class KosLogManagerModelImpl implements IKosDataModel, IKosIdentifiable {
     id: string;
@@ -125,14 +80,12 @@ export declare class KosLogManagerModelImpl implements IKosDataModel, IKosIdenti
     /**
      * Initializes the log manager model.
      * Called during model creation lifecycle.
-     * @internal
      */
     init(): Promise<void>;
     /**
      * Loads existing log overrides from the server.
      * Fetches UI-specific overrides and applies them to the current loggers.
      * Called after model initialization.
-     * @internal
      */
     load(): Promise<void>;
 }

package/models/models/kos-log-manager/kos-log-manager-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-log-manager-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/kos-log-manager/kos-log-manager-model.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,aAAa,EAEb,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAElB,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,UAAU,0BAA0B,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;AA2B9E;;;GAGG;AACH,qBACa,sBAAuB,YAAW,aAAa,EAAE,gBAAgB;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,UAAU,CAAiC;gBAEjD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,kBAAkB;IAU7B,WAAW,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAMjD;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAqBtB;;;;;;OAMG;IAEG,aAAa,CACjB,IAAI,CAAC,EAAE,UAAU,EACjB,GAAG,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOhC;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAwBpB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAsBtB;;;;;OAKG;IAMH,mBAAmB,CACjB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,uBAAuB,CAAC,GAAG,CAAC;IAWvC;;;;OAIG;IAMH,qBAAqB,CAAC,QAAQ,EAAE,WAAW;IAK3C;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAwB5B"}
+{"version":3,"file":"kos-log-manager-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/kos-log-manager/kos-log-manager-model.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,aAAa,EAEb,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAElB,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,UAAU,0BAA0B,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;AA0B9E;;;;;;;;;;;;;GAaG;AACH,qBACa,sBAAuB,YAAW,aAAa,EAAE,gBAAgB;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,UAAU,CAAiC;gBAEjD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,kBAAkB;IAU7B,WAAW,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAMjD;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAmBtB;;;;;;OAMG;IAEG,aAAa,CACjB,IAAI,CAAC,EAAE,UAAU,EACjB,GAAG,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOhC;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAwBpB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAsBtB;;;;;OAKG;IAMH,mBAAmB,CACjB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,uBAAuB,CAAC,GAAG,CAAC;IAWvC;;;;OAIG;IAMH,qBAAqB,CAAC,QAAQ,EAAE,WAAW;IAK3C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB5B"}