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

package/models/models/log-block/types/index.d.ts

@@ -1,38 +1,171 @@
 // ---------------  LogBlock ---------------
 
+/**
+ * Configuration options for LogBlock model instances.
+ * 
+ * These options define the metadata and boundaries for a log block, including
+ * line numbering, timing information, and stream identification. Used when
+ * creating new log blocks or updating existing block metadata.
+ *
+ * @example Basic Configuration
+ * ```typescript
+ * const blockOptions: LogBlockOptions = {
+ *   nodeId: 'primary',
+ *   stream: 'application-logs',
+ *   blockNum: 5,
+ *   startLineNum: 401,
+ *   endLineNum: 500,
+ *   startTime: new Date('2024-01-01T10:00:00Z'),
+ *   endTime: new Date('2024-01-01T10:05:00Z'),
+ *   lineCount: 100
+ * };
+ * 
+ * const logBlock = LogBlock.instance('app-block-5')
+ *   .options(blockOptions)
+ *   .build();
+ * ```
+ *
+ * @kosService core.logging
+ * @group KOS Model
+ * @category Device Logging
+ */
 export interface LogBlockOptions {
+  /**
+   * Node identifier where the log block originates.
+   * 
+   * Specifies which KOS device node contains this log block.
+   * Used for routing and organization in multi-node environments.
+   */
   nodeId: string;
+  
+  /**
+   * Name of the log stream this block belongs to.
+   * 
+   * Identifies the parent stream that contains this block.
+   * Used for organization and cross-referencing with LogStreamModel.
+   */
   stream: string;
+  
+  /**
+   * Sequential block number within the stream.
+   * 
+   * Used for ordering blocks chronologically within a stream.
+   * Blocks are automatically sorted by this number in containers.
+   */
   blockNum: number;
+  
+  /**
+   * Global line number where this block starts.
+   * 
+   * The first line number in this block relative to the entire stream.
+   * Used for accurate line numbering across the complete log stream.
+   */
   startLineNum: number;
+  
+  /**
+   * Global line number where this block ends.
+   * 
+   * The last line number in this block relative to the entire stream.
+   * Used with startLineNum to define the block's line range.
+   */
   endLineNum: number;
+  
+  /**
+   * Timestamp when this log block period began.
+   * 
+   * Used for time-based filtering and analysis of log blocks.
+   */
   startTime: Date;
+  
+  /**
+   * Timestamp when this log block period ended.
+   * 
+   * Used with startTime to define the temporal range of the block.
+   */
   endTime: Date;
+  
+  /**
+   * Total number of log lines in this block.
+   * 
+   * Should equal (endLineNum - startLineNum + 1). Used for
+   * validation and progress tracking during block loading.
+   */
   lineCount: number;
 }
 
 // ---------------  LogBlockContainer ---------------
+
+/**
+ * Configuration options for LogBlockContainer model instances.
+ * 
+ * Currently an empty interface but reserved for future container-level
+ * configuration options such as block sorting preferences, memory limits,
+ * or automatic cleanup policies.
+ *
+ * @kosService core.logging
+ * @group KOS Model
+ * @category Device Logging
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
 export interface LogBlockContainerOptions {}
 
+/**
+ * Data exchange format for log block information from KOS topics.
+ * 
+ * Used in topic handlers for log block events, representing block metadata
+ * as received from the KOS system. Similar to LogBlockOptions but uses
+ * timestamp numbers instead of Date objects for serialization efficiency.
+ *
+ * @kosService core.logging
+ * @group KOS Model
+ * @category Device Logging
+ */
 export interface LogBlockType {
+  /** Node identifier where the log block originates */
   nodeId: string;
+  /** Name of the log stream this block belongs to */
   stream: string;
+  /** Sequential block number within the stream */
   blockNum: number;
+  /** Global line number where this block starts */
   startLineNum: number;
+  /** Global line number where this block ends */
   endLineNum: number;
+  /** Timestamp when this log block period began (milliseconds since epoch) */
   startTime: number;
+  /** Timestamp when this log block period ended (milliseconds since epoch) */
   endTime: number;
+  /** Total number of log lines in this block */
   lineCount: number;
 }
 
+/**
+ * Data exchange format for log lines with block metadata from KOS topics.
+ * 
+ * Used in topic handlers for log line events, containing both the actual
+ * log lines and the block metadata. Extends LogBlockType with the lines array.
+ *
+ * @kosService core.logging
+ * @group KOS Model
+ * @category Device Logging
+ */
 export interface LogLinesType {
+  /** Node identifier where the log block originates */
   nodeId: string;
+  /** Name of the log stream this block belongs to */
   stream: string;
+  /** Sequential block number within the stream */
   blockNum: number;
+  /** Global line number where this block starts */
   startLineNum: number;
+  /** Global line number where this block ends */
   endLineNum: number;
+  /** Timestamp when this log block period began (milliseconds since epoch) */
   startTime: number;
+  /** Timestamp when this log block period ended (milliseconds since epoch) */
   endTime: number;
+  /** Total number of log lines in this block */
   lineCount: number;
+  /** Array of actual log line strings */
   lines: string[];
 }

package/models/models/log-stream/index.d.ts

@@ -1,7 +1,11 @@
+export type { LogStreamContainerModel } from './log-stream-container-model';
 export { LogStreamContainer } from './log-stream-container-registration';
+export type { LogStreamModel } from './log-stream-model';
 export { LogStream } from './log-stream-registration';
 export type * from './types';
-export type { LogStreamModel } from './log-stream-model';
-export type { LogStreamContainerModel } from './log-stream-container-model';
+/**
+ * @group KOS Model
+ * @category Device Logging
+ */
 export * as LogStreamServices from './services';
 //# sourceMappingURL=index.d.ts.map

package/models/models/log-stream/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/log-stream/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,mBAAmB,SAAS,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,iBAAiB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/log-stream/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,mBAAmB,SAAS,CAAC;AAC7B;;;GAGG;AACH,OAAO,KAAK,iBAAiB,MAAM,YAAY,CAAC"}

package/models/models/log-stream/log-stream-container-model.d.ts

@@ -7,11 +7,67 @@ import { IKosDataModel, KosCreationContext } from '../../../core/core/kosModel';
 import { IKosModelContainer } from '../../../core/core/kos-container-model';
 
 export declare const MODEL_TYPE = "log-stream-container-model";
+/**
+ * Log Stream Container Model - Manages multiple log streams with real-time topic-based synchronization.
+ *
+ * This container model manages multiple LogStreamModel instances and handles real-time log events
+ * from the KOS system. It provides centralized management of log streams, automatic stream discovery,
+ * and coordinated event handling for efficient log processing across multiple sources.
+ *
+ * ## Topic-Based Reactivity
+ * The container listens to these KOS topics for real-time log management:
+ * - **`/kos/logs/subscription/addBlock/*`** - Fired when new log blocks are created
+ * - **`/kos/logs/subscription/updateBlock/*`** - Fired when existing log blocks are updated
+ * - **`/kos/logs/subscription/removeBlock/*`** - Fired when log blocks are removed
+ * - **`/kos/logs/subscription/lines/*`** - Fired when new log lines are added to blocks
+ * - **`/kos/logs/streams/add/*`** - Fired when new log streams are discovered
+ *
+ * ## Key Features
+ * - **Multi-stream Management** - Handle multiple log streams simultaneously
+ * - **Automatic Stream Discovery** - Automatically add new streams as they become available
+ * - **Topic-based Synchronization** - Real-time updates via KOS event system
+ * - **Stream Selection** - Track currently selected stream for UI purposes
+ * - **Block Management** - Coordinate block updates across all managed streams
+ *
+ * ## Common Use Cases
+ * - **Log Dashboard** - Central management of multiple log sources
+ * - **System Monitoring** - Monitor logs from all system components
+ * - **Debugging Interface** - Switch between different log streams during troubleshooting
+ * - **Log Aggregation** - Collect and manage logs from distributed sources
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const logContainer = LogStreamContainer.instance('main-logger')
+ *   .options({})
+ *   .build();
+ *
+ * // Subscribe to and manage multiple streams
+ * await logContainer.subscribeToLogStream('application-logs');
+ * const appStream = logContainer.getModel('application-logs');
+ * logContainer.updateSelectedStream(appStream);
+ * ```
+ *
+ * @group KOS Model
+ * @category Device Logging
+ * @interface
+ * @useDeclaredType
+ *
+ * @see {@link LogStreamModel} - Individual log stream management
+ * @see {@link LogStreamContainerOptions} - Configuration options for the container
+ */
 export type LogStreamContainerModel = PublicModelInterface<LogStreamContainerModelImpl>;
+/**
+ * @ignore
+ * @internal
+ */
 export declare class LogStreamContainerModelImpl implements IKosIdentifiable, IKosModelHolder<LogStreamModel>, IKosDataModel {
+    /** Unique identifier for the container model instance */
     id: string;
+    /** Context logger for debugging log stream operations */
     private logger;
+    /** Currently selected log stream for UI display purposes */
     selectedStream?: LogStreamModel;
+    /** Container for managing LogStream model instances */
     private _models;
     constructor(modelId: string, options: LogStreamContainerOptions, context: KosCreationContext);
     getModel(id: string): LogStreamModel | undefined;
@@ -28,8 +84,14 @@ export declare class LogStreamContainerModelImpl implements IKosIdentifiable, IK
     handleRemoveBlock(data: LogBlockType, payload: any): void;
     handleUpdateBlock(data: LogBlockType, payload: any): void;
     handleLogLine(data: LogLinesType, payload: any): void;
+    /**
+     * @internal
+     */
     init(): Promise<void>;
     subscribeToLogStream(stream: string): Promise<void>;
+    /**
+     * @internal
+     */
     load(): Promise<void>;
 }
 //# sourceMappingURL=log-stream-container-model.d.ts.map

package/models/models/log-stream/log-stream-container-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-stream-container-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/log-stream/log-stream-container-model.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EACV,aAAa,EAEb,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD,eAAO,MAAM,UAAU,+BAA+B,CAAC;AAEvD,MAAM,MAAM,uBAAuB,GACjC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;AAOpD,qBACa,2BACX,YAAW,gBAAgB,EAAE,eAAe,CAAC,cAAc,CAAC,EAAE,aAAa;IAE3E,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IACjC,cAAc,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,OAAO,CAAqC;gBAE5D,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,kBAAkB;IAW7B,QAAQ,CAAC,EAAE,EAAE,MAAM;IAGnB,IAAI,MAAM,uCAET;IACD,IAAI,IAAI,qBAEP;IAED,WAAW,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAItD,QAAQ,CAAC,KAAK,EAAE,cAAc;IAI9B,WAAW,CAAC,EAAE,EAAE,MAAM;IAKtB,oBAAoB,CAAC,MAAM,CAAC,EAAE,cAAc;IAQ5C,iBAAiB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IAgB1C,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,KAAA;IAa1C,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,KAAA;IAa7C,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,KAAA;IAa7C,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,KAAA;IAQnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB5B"}
+{"version":3,"file":"log-stream-container-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/log-stream/log-stream-container-model.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EACV,aAAa,EAEb,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD,eAAO,MAAM,UAAU,+BAA+B,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,MAAM,uBAAuB,GACjC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;AAQpD;;;GAGG;AACH,qBACa,2BACX,YAAW,gBAAgB,EAAE,eAAe,CAAC,cAAc,CAAC,EAAE,aAAa;IAE3E,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAmB;IACjC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,uDAAuD;IAC7C,OAAO,CAAC,OAAO,CAAqC;gBAE5D,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,kBAAkB;IAW7B,QAAQ,CAAC,EAAE,EAAE,MAAM;IAGnB,IAAI,MAAM,uCAET;IACD,IAAI,IAAI,qBAEP;IAED,WAAW,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAItD,QAAQ,CAAC,KAAK,EAAE,cAAc;IAI9B,WAAW,CAAC,EAAE,EAAE,MAAM;IAKtB,oBAAoB,CAAC,MAAM,CAAC,EAAE,cAAc;IAQ5C,iBAAiB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IAgB1C,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,KAAA;IAa1C,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,KAAA;IAa7C,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,KAAA;IAa7C,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,KAAA;IAQzC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB5B"}

package/models/models/log-stream/log-stream-model.d.ts

@@ -5,7 +5,56 @@ import { IKosIdentifiable } from '../../../core/core/types';
 import { IKosDataModel, IKosVisitor, KosCreationContext } from '../../../core/core/kosModel';
 
 export declare const MODEL_TYPE = "log-stream-model";
+/**
+ * Log Stream Model - Real-time streaming log viewer with efficient block-based management and async iteration.
+ *
+ * This model provides high-performance log streaming capabilities for monitoring KOS device logs in real-time.
+ * It organizes log data into efficient blocks for memory management and provides async iterator support
+ * for continuous log consumption. Essential for debugging, monitoring, and troubleshooting KOS applications.
+ *
+ * ## Key Features
+ * - **Real-time Log Streaming** - Live log updates as they are generated on the device
+ * - **Block-based Management** - Efficient memory usage through log block organization
+ * - **Async Iterator Support** - Stream logs using modern async/await patterns
+ * - **Subscription Control** - Subscribe/unsubscribe to specific log streams
+ * - **Line Number Tracking** - Maintains accurate line numbering across blocks
+ * - **Multi-stream Support** - Handle multiple log streams simultaneously through container model
+ *
+ * ## Common Use Cases
+ * - **Development Debugging** - Monitor application logs during development
+ * - **Production Monitoring** - Track system health and errors in deployed applications
+ * - **Troubleshooting** - Analyze log patterns to diagnose issues
+ * - **Log Analysis** - Process log streams for metrics and insights
+ * - **Real-time Dashboards** - Display live log feeds in monitoring interfaces
+ * - **Automated Log Processing** - Stream logs to external analysis tools
+ *
+ * @interface
+ * @example Basic Usage
+ * ```typescript
+ * const logStream = LogStream.instance('application-logs')
+ *   .options({ name: 'application-logs', nodeId: 'primary' })
+ *   .build();
+ *
+ * await logStream.subscribe();
+ * const iterator = logStream.start();
+ * for await (const logLine of iterator) {
+ *   console.log(`[LOG] ${logLine}`);
+ * }
+ * ```
+ *
+ * @group KOS Model
+ * @category Device Logging
+ * @useDeclaredType
+ *
+ * @see {@link LogStreamOptions} - Configuration options for log stream instances
+ * @see {@link LogStreamContainerModel} - Container model for managing multiple streams
+ * @see {@link LogBlockModel} - Individual log block management within streams
+ */
 export type LogStreamModel = PublicModelInterface<LogStreamModelImpl>;
+/**
+ * @ignore
+ * @internal
+ */
 export declare class LogStreamModelImpl implements IKosDataModel, IKosIdentifiable {
     id: string;
     private logger;
@@ -27,7 +76,13 @@ export declare class LogStreamModelImpl implements IKosDataModel, IKosIdentifiab
     subscribe(): Promise<void>;
     unsubscribe(): Promise<void>;
     reset(): Promise<void>;
+    /**
+     * @internal
+     */
     init(): Promise<void>;
+    /**
+     * @internal
+     */
     load(): Promise<void>;
     private generatorInstance?;
     private shouldStop;

package/models/models/log-stream/log-stream-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-stream-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/log-stream/log-stream-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EAEX,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAOtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;AAEtE,qBACa,kBAAmB,YAAW,aAAa,EAAE,gBAAgB;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IACjC,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,OAAO,CAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;gBAEnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,kBAAkB;IAa7B,IAAI,YAAY,WAGf;IACD,IAAI,YAAY,qDAIf;IAED,IAAI,SAAS,2CAEZ;IACD,IAAI,MAAM,2CAET;IAED,IAAI,cAAc,WAEjB;IAED,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,aAAa,CAAC;IAI1C,WAAW,CAAC,SAAS,EAAE,YAAY;IAgCnC,QAAQ,CAAC,SAAS,EAAE,YAAY;IAwBhC,WAAW,CAAC,QAAQ,EAAE,MAAM;IAGtB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B,OAAO,CAAC,iBAAiB,CAAC,CAAqC;IAC/D,OAAO,CAAC,UAAU,CAAS;IAE3B,KAAK;IAML,IAAI;IAKG,UAAU,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;CAiExD"}
+{"version":3,"file":"log-stream-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/log-stream/log-stream-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EAEX,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAOtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;AACtE;;;GAGG;AACH,qBACa,kBAAmB,YAAW,aAAa,EAAE,gBAAgB;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IACjC,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,OAAO,CAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;gBAEnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,kBAAkB;IAa7B,IAAI,YAAY,WAGf;IACD,IAAI,YAAY,qDAIf;IAED,IAAI,SAAS,2CAEZ;IACD,IAAI,MAAM,2CAET;IAED,IAAI,cAAc,WAEjB;IAED,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,aAAa,CAAC;IAI1C,WAAW,CAAC,SAAS,EAAE,YAAY;IAgCnC,QAAQ,CAAC,SAAS,EAAE,YAAY;IAwBhC,WAAW,CAAC,QAAQ,EAAE,MAAM;IAGtB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B,OAAO,CAAC,iBAAiB,CAAC,CAAqC;IAC/D,OAAO,CAAC,UAAU,CAAS;IAE3B,KAAK;IAML,IAAI;IAKG,UAAU,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;CAgExD"}

package/models/models/log-stream/services/log-stream-services.d.ts

@@ -7,7 +7,8 @@ declare const SERVICE_PATH: ApiPath;
 export type LogStreamContainerClientResponse = ClientResponse<KosApi, typeof SERVICE_PATH, "get">;
 export type LogStreamContainerResponse = DeepRequired<ElementType<LogStreamContainerClientResponse>>;
 /**
- * @category Service
+ * @group KOS Model
+ * @category Device Logging
  * Retrieves the initial list of  log-stream-container data.
  */
 export declare const getLogStreams: () => Promise<ServiceResponse<LogStreamContainerClientResponse>>;

package/models/models/log-stream/services/log-stream-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-stream-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/log-stream/services/log-stream-services.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAY,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOpD,eAAO,MAAM,kBAAkB,QAAO,MAAM,GAAG,SAQ9C,CAAC;AAIF,QAAA,MAAM,YAAY,EAAE,OAA+C,CAAC;AACpE,MAAM,MAAM,gCAAgC,GAAG,cAAc,CAC3D,MAAM,EACN,OAAO,YAAY,EACnB,KAAK,CACN,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,YAAY,CACnD,WAAW,CAAC,gCAAgC,CAAC,CAC9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAa,QACrC,gBAAgB,gCAAgC,CAAC,CAclD,CAAC;AAEF,eAAO,MAAM,oBAAoB,WACvB,MAAM,sBAEb,QAAQ,IAAI,CAcd,CAAC;AAEF,eAAO,MAAM,wBAAwB,WAC3B,MAAM,KACb,QAAQ,IAAI,CASd,CAAC;AAEF,eAAO,MAAM,cAAc,QAAa,QAAQ,IAAI,CAcnD,CAAC;AAEF,QAAA,MAAM,mBAAmB,EAAE,OACoB,CAAC;AAChD,MAAM,MAAM,6BAA6B,GAAG,cAAc,CACxD,MAAM,EACN,OAAO,mBAAmB,EAC1B,KAAK,CACN,CAAC;AAEF,eAAO,MAAM,kBAAkB,WACrB,MAAM,KACb,QAAQ,gBAAgB,6BAA6B,CAAC,CAcxD,CAAC;AAEF,eAAO,MAAM,iBAAiB,WACpB,MAAM,WACL,MAAM,KACd,QAAQ,gBAAgB,YAAY,CAAC,CAevC,CAAC"}
+{"version":3,"file":"log-stream-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/log-stream/services/log-stream-services.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAY,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOpD,eAAO,MAAM,kBAAkB,QAAO,MAAM,GAAG,SAQ9C,CAAC;AAIF,QAAA,MAAM,YAAY,EAAE,OAA+C,CAAC;AACpE,MAAM,MAAM,gCAAgC,GAAG,cAAc,CAC3D,MAAM,EACN,OAAO,YAAY,EACnB,KAAK,CACN,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,YAAY,CACnD,WAAW,CAAC,gCAAgC,CAAC,CAC9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAa,QACrC,gBAAgB,gCAAgC,CAAC,CAclD,CAAC;AAEF,eAAO,MAAM,oBAAoB,WACvB,MAAM,sBAEb,QAAQ,IAAI,CAcd,CAAC;AAEF,eAAO,MAAM,wBAAwB,WAC3B,MAAM,KACb,QAAQ,IAAI,CASd,CAAC;AAEF,eAAO,MAAM,cAAc,QAAa,QAAQ,IAAI,CAcnD,CAAC;AAEF,QAAA,MAAM,mBAAmB,EAAE,OACoB,CAAC;AAChD,MAAM,MAAM,6BAA6B,GAAG,cAAc,CACxD,MAAM,EACN,OAAO,mBAAmB,EAC1B,KAAK,CACN,CAAC;AAEF,eAAO,MAAM,kBAAkB,WACrB,MAAM,KACb,QAAQ,gBAAgB,6BAA6B,CAAC,CAcxD,CAAC;AAEF,eAAO,MAAM,iBAAiB,WACpB,MAAM,WACL,MAAM,KACd,QAAQ,gBAAgB,YAAY,CAAC,CAevC,CAAC"}

package/models/models/log-stream/types/index.d.ts

@@ -1,9 +1,88 @@
 // ---------------  LogStream ---------------
 
+/**
+ * Configuration options for LogStream model instances.
+ * 
+ * These options specify the log stream identity and source location for connecting
+ * to specific log streams on KOS devices.
+ *
+ * @example Basic Log Stream Configuration
+ * ```typescript
+ * const options: LogStreamOptions = {
+ *   name: 'application-logs',
+ *   nodeId: 'primary'
+ * };
+ * 
+ * const logStream = LogStream.instance('app-logger')
+ *   .options(options)
+ *   .build();
+ * ```
+ *
+ * @example Multiple Stream Types
+ * ```typescript
+ * // System logs from primary node
+ * const systemLogs = LogStream.instance('system')
+ *   .options({ name: 'system-logs', nodeId: 'primary' })
+ *   .build();
+ *
+ * // Error logs from secondary node
+ * const errorLogs = LogStream.instance('errors') 
+ *   .options({ name: 'error-logs', nodeId: 'secondary' })
+ *   .build();
+ *
+ * // Debug logs from development node
+ * const debugLogs = LogStream.instance('debug')
+ *   .options({ name: 'debug-logs', nodeId: 'dev-node' })
+ *   .build();
+ * ```
+ *
+ * @kosService core.logging
+ * @group KOS Model
+ * @category Device Logging
+ */
 export interface LogStreamOptions {
+  /**
+   * Name of the log stream to connect to.
+   * 
+   * This should match the log stream name available on the target device.
+   * Common stream names include 'application-logs', 'system-logs', 'error-logs'.
+   */
   name: string;
+  
+  /**
+   * Node identifier where the log stream is located.
+   * 
+   * Specifies which KOS device node contains the target log stream.
+   * Typically 'primary' for main device logs, but can be any valid node ID.
+   * 
+   * @default 'primary'
+   */
   nodeId: string;
 }
 
 // ---------------  LogStreamContainer ---------------
+
+/**
+ * Configuration options for LogStreamContainer model instances.
+ * 
+ * Currently an empty interface but reserved for future container-level
+ * configuration options such as stream filtering, automatic discovery settings,
+ * or performance tuning parameters.
+ *
+ * @example Basic Container Configuration
+ * ```typescript
+ * const options: LogStreamContainerOptions = {
+ *   // Future options will be added here
+ * };
+ * 
+ * const container = LogStreamContainer.instance('log-manager')
+ *   .options(options)
+ *   .build();
+ * ```
+ *
+ * @kosService core.logging
+ * @category Model Configuration
+ * @category Data Persistence
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
 export interface LogStreamContainerOptions {}

package/models/models/network-interface/index.d.ts

@@ -1,7 +1,11 @@
+export type { NetworkInterfaceContainerModel } from './network-interface-container-model';
 export { NetworkInterfaceContainer } from './network-interface-container-registration';
+export type { NetworkInterfaceModel } from './network-interface-model';
 export { NetworkInterface } from './network-interface-registration';
 export type * from './types';
-export type { NetworkInterfaceModel } from './network-interface-model';
-export type { NetworkInterfaceContainerModel } from './network-interface-container-model';
+/**
+ * @group KOS Model
+ * @category Network Interfaces
+ */
 export * as NetworkInterfaceServices from './services';
 //# sourceMappingURL=index.d.ts.map

package/models/models/network-interface/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/network-interface/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,mBAAmB,SAAS,CAAC;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,YAAY,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,KAAK,wBAAwB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/network-interface/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,mBAAmB,SAAS,CAAC;AAC7B;;;GAGG;AACH,OAAO,KAAK,wBAAwB,MAAM,YAAY,CAAC"}

package/models/models/network-interface/network-interface-container-model.d.ts

@@ -3,10 +3,66 @@ import { NetworkInterfaceModel } from './network-interface-model';
 import { IKosDataModel, IKosIdentifiable, IKosModelContainer, IKosModelHolder, KosCreationContext, PublicModelInterface } from '../../../core';
 
 export declare const MODEL_TYPE = "network-interface-container-model";
+/**
+ * NetworkInterfaceContainer - Centralized management of multiple network interfaces on KOS devices.
+ *
+ * The NetworkInterfaceContainer model provides comprehensive management of all network interfaces
+ * available on a KOS device, including automatic discovery, categorization, and real-time updates.
+ * This container model is essential for applications that need to manage multiple network interfaces,
+ * build network configuration screens, or monitor overall network connectivity status.
+ *
+ * ## Key Features
+ * - **Automatic Interface Discovery** - Loads and manages all available network interfaces from the device
+ * - **Category-Based Indexing** - Organizes interfaces by category (INTERNAL, INTEGRATION, EXTERNAL, NONE)
+ * - **Real-Time Refresh** - Updates interface data with current network state
+ * - **Unified Interface Management** - Single point of access for all network interface operations
+ * - **Dynamic Interface Tracking** - Handles interface addition/removal as network state changes
+ * - **Service Integration** - Automatically fetches interface data from KOS network services
+ *
+ * ## Interface Categories
+ * The container automatically organizes interfaces into categories:
+ * - **EXTERNAL** - User-facing interfaces (WiFi adapters, Ethernet ports)
+ * - **INTERNAL** - System interfaces (loopback, virtual interfaces)
+ * - **INTEGRATION** - Integration-specific network interfaces
+ * - **NONE** - Uncategorized interfaces
+ *
+ * ## Common Use Cases
+ * - **Network Configuration UI** - Build comprehensive network settings interfaces
+ * - **System Monitoring** - Track overall network connectivity and interface health
+ * - **Interface Selection** - Allow users to choose from available network interfaces
+ * - **Network Diagnostics** - Provide detailed system-wide network interface information
+ * - **Automated Network Management** - Programmatically manage multiple interfaces
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const networkContainer = NetworkInterfaceContainer.instance('system-interfaces')
+ *   .build();
+ *
+ * // Access all network interfaces and get specific interface
+ * const allInterfaces = networkContainer.models;
+ * const ethInterface = networkContainer.getModel('eth0');
+ * ```
+ *
+ * @group KOS Model
+ * @category Network Interfaces
+ * @interface
+ * @useDeclaredType
+ *
+ * @see {@link NetworkInterface} - Individual network interface model
+ * @see {@link NetworkInterfaceOptions} - Network interface configuration options
+ * @see {@link getNetworkInterfaces} - Service function for loading interface data
+ */
 export type NetworkInterfaceContainerModel = PublicModelInterface<NetworkInterfaceContainerModelImpl>;
+/**
+ * @ignore
+ * @internal
+ */
 export declare class NetworkInterfaceContainerModelImpl implements IKosIdentifiable, IKosModelHolder<NetworkInterfaceModel>, IKosDataModel {
+    /** Unique identifier for the container model instance */
     id: string;
+    /** Context logger for debugging and network interface operations */
     private logger;
+    /** Container for managing NetworkInterface model instances with category indexing */
     private _models;
     constructor(modelId: string, options: NetworkInterfaceContainerOptions, context: KosCreationContext);
     getModel(id: string): NetworkInterfaceModel | undefined;
@@ -14,8 +70,14 @@ export declare class NetworkInterfaceContainerModelImpl implements IKosIdentifia
     get data(): NetworkInterfaceModel[];
     addModel(model: NetworkInterfaceModel): void;
     removeModel(id: string): void;
+    /**
+     * @internal
+     */
     init(): Promise<void>;
     refreshInterfaces(): Promise<void>;
+    /**
+     * @internal
+     */
     load(): Promise<void>;
 }
 //# sourceMappingURL=network-interface-container-model.d.ts.map

package/models/models/network-interface/network-interface-container-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-interface-container-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/network-interface/network-interface-container-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAEf,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,SAAS,CAAC;AAEhE,eAAO,MAAM,UAAU,sCAAsC,CAAC;AAE9D,MAAM,MAAM,8BAA8B,GACxC,oBAAoB,CAAC,kCAAkC,CAAC,CAAC;AAE3D,qBACa,kCACX,YACE,gBAAgB,EAChB,eAAe,CAAC,qBAAqB,CAAC,EACtC,aAAa;IAEf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IACvB,OAAO,CAAC,OAAO,CAA4C;gBAEnE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,kBAAkB;IAe7B,QAAQ,CAAC,EAAE,EAAE,MAAM;IAGnB,IAAI,MAAM,8CAET;IACD,IAAI,IAAI,4BAEP;IAED,QAAQ,CAAC,KAAK,EAAE,qBAAqB;IAIrC,WAAW,CAAC,EAAE,EAAE,MAAM;IAKhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,iBAAiB;IAoBjB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}
+{"version":3,"file":"network-interface-container-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/network-interface/network-interface-container-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAEf,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,SAAS,CAAC;AAEhE,eAAO,MAAM,UAAU,sCAAsC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,MAAM,8BAA8B,GACxC,oBAAoB,CAAC,kCAAkC,CAAC,CAAC;AAE3D;;;GAGG;AACH,qBACa,kCACX,YACE,gBAAgB,EAChB,eAAe,CAAC,qBAAqB,CAAC,EACtC,aAAa;IAEf,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,OAAO,CAAC,MAAM,CAAmB;IACjC,qFAAqF;IAC3E,OAAO,CAAC,OAAO,CAA4C;gBAEnE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gCAAgC,EACzC,OAAO,EAAE,kBAAkB;IAe7B,QAAQ,CAAC,EAAE,EAAE,MAAM;IAGnB,IAAI,MAAM,8CAET;IACD,IAAI,IAAI,4BAEP;IAED,QAAQ,CAAC,KAAK,EAAE,qBAAqB;IAIrC,WAAW,CAAC,EAAE,EAAE,MAAM;IAKtB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,iBAAiB;IAoBvB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/models/models/network-interface/network-interface-container-registration.d.ts

@@ -80,7 +80,8 @@ import { SingletonKosModelRegistrationFactory } from '../../../core';
  * If the model does not yet exist, it will be created passing in the provided options to initialize it.
  *
  * Singleton models don't require an ID as they will use the model type as their ID to guarantee uniqueness throughout the system.
- 
+ * @group KOS Model
+ * @category Network Interfaces
  * */
 export declare const NetworkInterfaceContainer: SingletonKosModelRegistrationFactory<NetworkInterfaceContainerModel, object>;
 //# sourceMappingURL=network-interface-container-registration.d.ts.map

package/models/models/network-interface/network-interface-container-registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-interface-container-registration.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/network-interface/network-interface-container-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAQ1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgFK;AACL,eAAO,MAAM,yBAAyB,8EAOlC,CAAC"}
+{"version":3,"file":"network-interface-container-registration.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/network-interface/network-interface-container-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAQ1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiFK;AACL,eAAO,MAAM,yBAAyB,8EAOlC,CAAC"}