@kosdev-code/kos-ui-sdk 0.1.0-dev.5053

package/models/models/region-info/index.d.ts

@@ -0,0 +1,5 @@
+export { default as RegionInfo } from './region-info-model';
+export type { RegionInfoModel, RegionInfoOptions, TimeFormatOptions, DateFormatOptions, UnitSystemOptions, UnitSource, } from './types';
+import * as RegionServices from "./services";
+export { RegionServices };
+//# sourceMappingURL=index.d.ts.map

package/models/models/region-info/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/region-info/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,cAAc,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/models/models/region-info/region-info-model.d.ts

@@ -0,0 +1,99 @@
+import { DateFormatOptions, RegionInfoModel, RegionInfoOptions, TimeFormatOptions, UnitSource, UnitSystemOptions, UnitTuple } from './types';
+import { BaseRegionResponse, RegionsResponse } from './services';
+import { IConfigBeanModel } from '../config-bean/config-bean-model';
+
+interface RegionSettingsService {
+    unitSystemId: string;
+    timeFormatId: string;
+    dateFormatId: string;
+    country: string;
+    timeZone: string;
+}
+type RegionSettingsConfigBean = IConfigBeanModel<RegionSettingsService>;
+/**
+ * @ignore
+ * @internal
+ */
+export declare class RegionInfoModelImpl<AdditionalData extends BaseRegionResponse = BaseRegionResponse> implements RegionInfoModel {
+    id: string;
+    private unitSystemMap;
+    private measureMap;
+    private defaultMeasureMap;
+    private regionMap;
+    private timeFormats;
+    private dateFormats;
+    private unitSystems;
+    regionSource: RegionSettingsConfigBean;
+    private region;
+    private regions;
+    private timeZoneMap;
+    constructor(modelId: string);
+    get availableRegions(): string[];
+    get defaultUnitSystem(): string;
+    get unitSystemId(): string;
+    get timeFormatId(): string;
+    get selectedTimeFormat(): string;
+    get is12HourTimeFormat(): boolean;
+    get dateFormatId(): string;
+    get selectedDateFormat(): string;
+    get selectedDateOrder(): string;
+    get selectedCountry(): string;
+    get selectedTimeZone(): string;
+    get timeZones(): string[];
+    get allTimeZones(): string[];
+    get regionId(): string;
+    get selectedRegion(): RegionsResponse<AdditionalData>;
+    get selectedUnitSystem(): string;
+    get timeFormatOptions(): TimeFormatOptions[];
+    get dateFormatOptions(): DateFormatOptions[];
+    get unitSystemOptions(): UnitSystemOptions[];
+    setSelectedTimeFormat(timeFormatId: string): void;
+    setSelectedDateFormat(dateFormatId: string): void;
+    setSelectedUnitSystem(unitSystemId: string): void;
+    getUnitSystem(_unit?: string): string;
+    getUnitMeasure(_unit: string): string;
+    /**
+     *@internal
+     */
+    getDefaultUnitDecimalPlaces(measure: string, unitSystem: string, _unit?: string): any;
+    /**
+     *@internal
+     */
+    getDefaultUnitForMeasure(measure: string, unitSystem: string): string;
+    /**
+     *@internal
+     */
+    convertByUnit(value: number, fromUnit: UnitTuple, toUnit: UnitTuple): string;
+    /**
+     *@internal
+     */
+    convertByUnitName(value: number, from: string, to: string): string;
+    /**
+     * @internal
+     */
+    convert(value: number, from: UnitSource, to: UnitSource): string;
+    /**
+     * @internal
+     */
+    init(): Promise<void>;
+    /**
+     * @internal
+     */
+    load(): Promise<void>;
+    /**
+     * @internal
+     */
+    ready(): Promise<void>;
+}
+declare const Registration: {
+    registration: {
+        "region-info-model": {
+            class: typeof RegionInfoModelImpl;
+            singleton: boolean;
+        };
+    };
+    type: string;
+    factory: (options?: RegionInfoOptions | undefined, parentId?: string | undefined) => RegionInfoModel<BaseRegionResponse>;
+};
+export default Registration;
+//# sourceMappingURL=region-info-model.d.ts.map

package/models/models/region-info/region-info-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-info-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/region-info/region-info-model.ts"],"names":[],"mappings":"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"}

package/models/models/region-info/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './region-info-services';
+//# sourceMappingURL=index.d.ts.map

package/models/models/region-info/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/region-info/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/models/models/region-info/services/region-info-services.d.ts

@@ -0,0 +1,48 @@
+export interface DateFormat {
+    id: string;
+    format: string;
+    order: string;
+}
+export interface TimeFormat {
+    id: string;
+    format: string;
+    ampm: boolean;
+}
+export interface Unit {
+    measure: string;
+    name: string;
+    scale: number;
+    offset: number;
+    decimals: number;
+    alias: string;
+    def: boolean;
+}
+export interface UnitSystem {
+    id: string;
+    units: Unit[];
+}
+export interface RegionInfoResponse {
+    unitSystems: UnitSystem[];
+    timeFormats: TimeFormat[];
+    dateFormats: DateFormat[];
+}
+export interface BaseRegionResponse {
+    id: string;
+    country: string;
+    timeFormatId: string;
+    dateFormatId: string;
+    unitSystemId: string;
+    timeZones: string[];
+    hidden: boolean;
+}
+export type RegionsResponse<AdditionalData extends BaseRegionResponse = BaseRegionResponse> = BaseRegionResponse & {
+    [key in keyof AdditionalData]: AdditionalData[key];
+};
+/**
+ * @category Service
+ * @internal
+ * Retrieves the initial Region Info data.
+ */
+export declare const getRegionInfo: () => Promise<import('../../../../core').KosServiceResponse<RegionInfoResponse> | undefined>;
+export declare const getRegions: () => Promise<import('../../../../core').KosServiceResponse<RegionsResponse<BaseRegionResponse>[]> | undefined>;
+//# sourceMappingURL=region-info-services.d.ts.map

package/models/models/region-info/services/region-info-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-info-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/region-info/services/region-info-services.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AACD,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AACD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AACD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,MAAM,eAAe,CACzB,cAAc,SAAS,kBAAkB,GAAG,kBAAkB,IAC5D,kBAAkB,GAAG;KACtB,GAAG,IAAI,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC;CACnD,CAAC;AACF;;;;GAIG;AACH,eAAO,MAAM,aAAa,8FAOzB,CAAC;AAEF,eAAO,MAAM,UAAU,iHAStB,CAAC"}

package/models/models/region-info/types/index.d.ts

@@ -0,0 +1,296 @@
+import { BaseRegionResponse, RegionsResponse, Unit } from '../services';
+import { IKosDataModel } from '../../../../core';
+
+/**
+ * Unit conversion source specification for the conversion system.
+ *
+ * Flexible specification allowing conversion by specific unit name or by
+ * measurement system with automatic unit selection. The conversion system
+ * intelligently selects appropriate default units when only system/measure is provided.
+ *
+ * @example Specific Unit Conversion
+ * ```typescript
+ * const fahrenheitSource: UnitSource = { unit: 'fahrenheit' };
+ * const celsiusSource: UnitSource = { unit: 'celsius' };
+ *
+ * const result = regionModel.convert(72, fahrenheitSource, celsiusSource);
+ * console.log(result); // '22.22'
+ * ```
+ *
+ * @example System-Based Conversion (Auto Unit Selection)
+ * ```typescript
+ * const imperialLength: UnitSource = { measure: 'length', system: 'imperial' };
+ * const metricLength: UnitSource = { measure: 'length', system: 'metric' };
+ *
+ * // Automatically uses miles → kilometers
+ * const result = regionModel.convert(5, imperialLength, metricLength);
+ * console.log(result); // '8.047'
+ * ```
+ *
+ * @group KOS Model
+ * @category Region Info
+ */
+export interface UnitSource {
+    /** Measurement system identifier (e.g., 'metric', 'imperial', 'us') */
+    system?: string;
+    /** Type of measurement (e.g., 'length', 'weight', 'temperature', 'volume') */
+    measure?: string;
+    /** Specific unit name (e.g., 'meter', 'kilogram', 'fahrenheit') */
+    unit?: string;
+}
+export type MeasureMapKeys = string | "default";
+export type SystemMeasureMap = Record<MeasureMapKeys, Unit>;
+export type MeasureMap = Record<string, SystemMeasureMap>;
+export type SystemDefaultMap = Record<string, string>;
+export type DefaultMeasureMap = Record<string, SystemDefaultMap>;
+/**
+ * Configuration options for creating RegionInfoModel instances.
+ *
+ * Currently an empty interface but reserved for future regional configuration
+ * options such as default locale preferences, custom unit mappings, or
+ * regional API endpoints.
+ *
+ * @example
+ * ```typescript
+ * const options: RegionInfoOptions = {
+ *   // Future options will be defined here
+ * };
+ * const regionModel = RegionInfo.instance().options(options).build();
+ * ```
+ *
+ * @group KOS Model
+ * @category Region Info
+ */
+export interface RegionInfoOptions {
+}
+interface BaseOptions {
+    id: string;
+}
+interface FormatOptions extends BaseOptions {
+    format: string;
+}
+/**
+ * Time format configuration options for regional time display.
+ *
+ * Defines available time formats including 12-hour (AM/PM) and 24-hour formats
+ * with their display patterns and behavior.
+ *
+ * @example
+ * ```typescript
+ * const timeFormats: TimeFormatOptions[] = [
+ *   { id: '12h', format: 'hh:mm:ss a', ampm: true },   // 3:45:30 PM
+ *   { id: '24h', format: 'HH:mm:ss', ampm: false }     // 15:45:30
+ * ];
+ * ```
+ *
+ * @group KOS Model
+ * @category Region Info
+ */
+export interface TimeFormatOptions extends FormatOptions {
+    /** True if using 12-hour format with AM/PM, false for 24-hour format */
+    ampm: boolean;
+}
+/**
+ * Date format configuration options for regional date display.
+ *
+ * Defines available date formats including different component ordering
+ * (Day/Month/Year vs Month/Day/Year) and display patterns.
+ *
+ * @example
+ * ```typescript
+ * const dateFormats: DateFormatOptions[] = [
+ *   { id: 'us', format: 'MM/DD/YYYY', order: 'MDY' },    // 03/15/2024
+ *   { id: 'eu', format: 'DD/MM/YYYY', order: 'DMY' },    // 15/03/2024
+ *   { id: 'iso', format: 'YYYY-MM-DD', order: 'YMD' }    // 2024-03-15
+ * ];
+ * ```
+ *
+ * @group KOS Model
+ * @category Region Info
+ */
+export interface DateFormatOptions extends FormatOptions {
+    /** Order of date components: 'MDY', 'DMY', 'YMD', etc. */
+    order: string;
+}
+/**
+ * Unit system configuration options for measurement standards.
+ *
+ * Defines available unit systems (metric, imperial, etc.) with their
+ * display names and identification.
+ *
+ * @example
+ * ```typescript
+ * const unitSystems: UnitSystemOptions[] = [
+ *   { id: 'metric', name: 'Metric System' },
+ *   { id: 'imperial', name: 'Imperial System' },
+ *   { id: 'us', name: 'US Customary System' }
+ * ];
+ * ```
+ *
+ * @group KOS Model
+ * @category Region Info
+ */
+export interface UnitSystemOptions extends BaseOptions {
+    /** Display name of the unit system (e.g., 'Metric System', 'Imperial System') */
+    name: string;
+}
+/**
+ * Region Info Model - Comprehensive regional localization and unit conversion system for KOS applications.
+ *
+ * This singleton model provides centralized management of regional settings including time formats,
+ * date formats, unit systems, time zones, and intelligent unit conversion. Essential for building
+ * internationally-aware applications that adapt to local preferences and measurement standards.
+ *
+ * ## Key Features
+ * - **Time & Date Formatting** - Configurable 12/24-hour time and various date order formats
+ * - **Unit System Management** - Complete metric/imperial conversion with precision control
+ * - **Time Zone Support** - Full time zone management with regional associations
+ * - **Dynamic Configuration** - Live updates through KOS configuration system
+ * - **Type Safety** - Generic support for additional regional data
+ * - **Singleton Pattern** - Single instance manages all regional settings
+ *
+ * ## Unit Conversion System
+ * The model provides intelligent unit conversion between different measurement systems:
+ * - **Automatic scaling** - Handles complex conversions with proper scaling factors
+ * - **Precision control** - Configurable decimal places per unit type
+ * - **Family validation** - Prevents invalid conversions (e.g., length to weight)
+ * - **Default unit resolution** - Automatic selection of appropriate units per system
+ *
+ * @template AdditionalData - Extends BaseRegionResponse for custom regional data requirements
+ *
+ * @interface
+ * @example Basic Usage
+ * ```typescript
+ * const regionModel = RegionInfo.instance().build();
+ *
+ * // Unit conversion and regional settings
+ * const celsius = regionModel.convert(72, { unit: 'fahrenheit' }, { unit: 'celsius' });
+ * console.log(regionModel.selectedCountry);     // 'us'
+ * ```
+ *
+ * @group KOS Model
+ * @category Region Info
+ * @useDeclaredType
+ *
+ * @see {@link UnitSource} - Unit conversion source specification
+ * @see {@link RegionInfoOptions} - Configuration options for RegionInfoModel instances
+ */
+export interface RegionInfoModel<AdditionalData extends BaseRegionResponse = BaseRegionResponse> extends RegionInfoOptions, IKosDataModel {
+    /** Unique identifier for the region model instance. */
+    readonly id: string;
+    /** The default unit system (e.g., metric or imperial) for the region. */
+    readonly defaultUnitSystem: string;
+    /** The currently selected unit system. */
+    readonly selectedUnitSystem: string;
+    /** The currently selected time format as a string. */
+    readonly selectedTimeFormat: string;
+    /** The currently selected date format as a string. */
+    readonly selectedDateFormat: string;
+    /** The order of date elements (e.g., day/month/year) for the selected format. */
+    readonly selectedDateOrder: string;
+    /** The currently selected country. */
+    readonly selectedCountry: string;
+    /** The currently selected time zone. */
+    readonly selectedTimeZone: string;
+    /**
+     * The detailed information of the selected region, extended with additional data.
+     * The type of additional data is determined by the generic parameter `AdditionalData`.
+     */
+    selectedRegion: RegionsResponse<AdditionalData>;
+    /** Flag indicating if the 12-hour time format (AM/PM) is used. */
+    is12HourTimeFormat: boolean;
+    /** An array of available regions as strings. */
+    availableRegions: string[];
+    /** Identifier of the region. */
+    regionId: string;
+    readonly dateFormatId: string;
+    readonly timeFormatId: string;
+    readonly unitSystemId: string;
+    /** An array of available time zones as strings. */
+    timeZones: string[];
+    /** An array of all available time zones as strings. */
+    allTimeZones: string[];
+    /** Time format options available for selection. */
+    readonly timeFormatOptions: TimeFormatOptions[];
+    /** Date format options available for selection. */
+    readonly dateFormatOptions: DateFormatOptions[];
+    /** Unit system options available for selection. */
+    readonly unitSystemOptions: UnitSystemOptions[];
+    /**
+     * Converts a value from one unit to another.
+     *
+     * @param value - The numerical value to convert.
+     * @param from - The unit source to convert from.
+     * @param to - The unit source to convert to.
+     * @returns The converted value as a string.
+     * @internal
+     */
+    convert(value: number, from: UnitSource, to: UnitSource): string;
+    /**
+     * Sets the selected time format.
+     *
+     * @param id - The identifier of the time format to select.
+     */
+    setSelectedTimeFormat(id: string): void;
+    /**
+     * Sets the selected date format.
+     *
+     * @param id - The identifier of the date format to select.
+     */
+    setSelectedDateFormat(id: string): void;
+    /**
+     * Sets the selected unit system.
+     *
+     * @param id - The identifier of the unit system to select.
+     */
+    setSelectedUnitSystem(id: string): void;
+    /**
+     * Retrieves the default unit for a given measure in a specified unit system.
+     *
+     * @param measure - The measure for which to get the default unit.
+     * @param unitSystem - The unit system in which to find the default unit.
+     * @returns The default unit for the specified measure and system.
+     */
+    getDefaultUnitForMeasure(measure: string, unitSystem: string): string;
+    /**
+     * Retrieves the measure associated with a given unit.
+     *
+     * @param unit - The unit for which to get the measure.
+     * @returns The measure associated with the specified unit.
+     *
+     * @internal
+     */
+    getUnitMeasure: (unit: string) => string;
+    /**
+     *
+     * @internal
+     */
+    getUnitSystem: (unit?: string) => string;
+    /**
+     * Retrieves the default number of decimal places for a unit in a given measure and system.
+     *
+     * @param measure - The measure to consider.
+     * @param unitSystem - The unit system in which the unit is defined.
+     * @param unit - Optional specific unit to consider.
+     * @returns The number of decimal places for the unit.
+     */
+    getDefaultUnitDecimalPlaces(measure: string, unitSystem: string, unit?: string): number;
+}
+export declare enum UnitTupleKeys {
+    family = 0,
+    scale = 1,
+    offset = 2,
+    decimals = 3,
+    alias = 4,
+    system = 5
+}
+export type UnitTuple = [
+    family: string,
+    scale: number,
+    offset: number,
+    decimals: number,
+    alias: string,
+    system: string
+];
+export {};
+//# sourceMappingURL=index.d.ts.map

package/models/models/region-info/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/region-info/types/index.ts"],"names":[],"mappings":"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"}

package/models/models/region-info/utils/unit-system-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function unitSystemMapReducer(acc: any, unitSystem: any): any;
+export declare function measureMapReducer(systemAcc: any, unitSystem: any): any;
+export declare function defaultMeasureMapReducer(systemAcc: any, unitSystem: any): any;
+//# sourceMappingURL=unit-system-utils.d.ts.map

package/models/models/region-info/utils/unit-system-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-system-utils.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/region-info/utils/unit-system-utils.ts"],"names":[],"mappings":"AAmBA,wBAAgB,oBAAoB,CAAC,GAAG,KAAA,EAAE,UAAU,KAAA,OAwBnD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,KAAA,EAAE,UAAU,KAAA,OAiDtD;AAED,wBAAgB,wBAAwB,CAAC,SAAS,KAAA,EAAE,UAAU,KAAA,OA2B7D"}

package/models/models/software-info/index.d.ts

@@ -0,0 +1,4 @@
+export { SoftwareInfo } from './software-info-registration';
+export type * from './types';
+export * as SoftwareInfoServices from './services';
+//# sourceMappingURL=index.d.ts.map

package/models/models/software-info/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/software-info/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,mBAAmB,SAAS,CAAC;AAC7B,OAAO,KAAK,oBAAoB,MAAM,YAAY,CAAC"}

package/models/models/software-info/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './software-info-services';
+//# sourceMappingURL=index.d.ts.map

package/models/models/software-info/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/software-info/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/models/models/software-info/services/software-info-services.d.ts

@@ -0,0 +1,44 @@
+import { BaseResponseType } from '../../../utils';
+
+export interface Nodes {
+    [key: string]: NodeSoftwareInfo[];
+}
+export interface NodeSoftwareInfo {
+    node: string;
+    artifacts: SoftwareInfoDescriptorFragment[];
+}
+export interface SoftwareInfoDescriptorFragment {
+    name: string;
+    group: string;
+    version: string;
+}
+export type DeviceSoftwareInfoResponse = BaseResponseType<"/api/kos/manifest/info", "get">;
+/**
+ * @category Service
+ * @internal
+ * Retrieves the initial software-info data.
+ * @param signal - Optional AbortSignal to cancel the request
+ */
+export declare const getSoftwareInfos: (signal?: AbortSignal) => Promise<DeviceSoftwareInfoResponse>;
+/**
+ * Cancellable version of getSoftwareInfos
+ * @example
+ * ```typescript
+ * // In your model
+ * const data = await getSoftwareInfosWithCancel();
+ *
+ * // Cancel if needed
+ * getSoftwareInfosWithCancel.cancel();
+ *
+ * // Check if active
+ * if (getSoftwareInfosWithCancel.isActive()) {
+ *   console.log('Request in progress');
+ * }
+ * ```
+ */
+export declare const getSoftwareInfosWithCancel: import('../../../utils/cancellable-service').CancellableFunction<() => Promise<{
+    nodes?: {
+        empty?: boolean | undefined;
+    } | undefined;
+}>>;
+//# sourceMappingURL=software-info-services.d.ts.map

package/models/models/software-info/services/software-info-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-info-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/software-info/services/software-info-services.ts"],"names":[],"mappings":"AAKA,OAAO,EAAO,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAO5D,MAAM,WAAW,KAAK;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,8BAA8B,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,CACvD,wBAAwB,EACxB,KAAK,CACN,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,YAClB,WAAW,KACnB,QAAQ,0BAA0B,CAiBpC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,0BAA0B;;;;GACK,CAAC"}

package/models/models/software-info/software-info-model.d.ts

@@ -0,0 +1,86 @@
+import { ArtifactsType, NodeInfoType, SoftwareInfoOptions } from './types';
+import { PublicModelInterface } from '../../../core/types';
+import { IKosDataModel, KosCreationContext } from '../../../core/core/kosModel';
+
+export declare const MODEL_TYPE = "software-info-model";
+/**
+ * SoftwareInfo - System software version and artifact management for KOS devices.
+ *
+ * The SoftwareInfo model provides comprehensive visibility into installed software versions,
+ * artifacts, and system components across all nodes in a KOS device. This model is essential
+ * for applications that need to display system information, perform version checks, or
+ * manage software compatibility and updates.
+ *
+ * ## Key Features
+ * - **Node-Based Architecture** - Track software information across multiple device nodes
+ * - **Artifact Management** - Complete visibility into installed software components and versions
+ * - **Version Tracking** - Monitor KOS framework versions and application artifacts
+ * - **Group Organization** - Automatic categorization of artifacts by functional groups
+ * - **System Overview** - Comprehensive system software inventory and version reporting
+ * - **Compatibility Checking** - Version information for dependency and compatibility validation
+ *
+ * ## Data Structure
+ * The model organizes software information hierarchically:
+ * - **Nodes** - Individual system nodes (primary, secondary, etc.)
+ * - **Artifacts** - Software components installed on each node
+ * - **Groups** - Logical grouping of related artifacts (core, ui, services, etc.)
+ * - **Versions** - Specific version information for each artifact
+ *
+ * ## Common Use Cases
+ * - **System Information Display** - Show installed software versions to users and administrators
+ * - **Version Compatibility** - Check software versions before updates or feature activation
+ * - **Support Diagnostics** - Provide detailed software information for troubleshooting
+ * - **Update Planning** - Assess current software state before planning updates
+ * - **Inventory Management** - Track and report on installed software components
+ *
+ * @interface
+ * @example Basic Usage
+ * ```typescript
+ * const softwareInfo = SoftwareInfo.instance('system-info').build();
+ *
+ * // Access system software information across nodes
+ * const nodes = softwareInfo.nodes;
+ * nodes?.forEach(node => {
+ *   console.log(`Node ${node.nodeName}: KOS ${node.kosVersion}`);
+ * });
+ * ```
+ *
+ * @group KOS Model
+ * @category System Integration
+ * @useDeclaredType
+ *
+ * @see {@link SoftwareInfoOptions} - Configuration options for SoftwareInfo model
+ * @see {@link NodeInfoType} - Individual node software information
+ * @see {@link ArtifactsType} - Software artifact information
+ * @see {@link getSoftwareInfos} - Service function for loading software data
+ */
+export type SoftwareInfoModel = PublicModelInterface<SoftwareInfoModelImpl>;
+/**
+ * @ignore
+ * @internal
+ */
+export declare class SoftwareInfoModelImpl implements IKosDataModel {
+    /** Unique identifier for the model instance */
+    id: string;
+    private logger;
+    /** Software information for all device nodes, including KOS versions and artifacts */
+    nodes: NodeInfoType[] | undefined;
+    constructor(modelId: string, _options: SoftwareInfoOptions, context: KosCreationContext);
+    /**
+     * @internal
+     */
+    init(): Promise<void>;
+    /**
+     * Groups artifacts by a specified property for organization.
+     * @param arr Array of artifacts to group
+     * @param property Property to group by
+     * @returns Grouped artifacts organized by the specified property
+     * @private
+     */
+    groupBy(arr: ArtifactsType[], property: keyof ArtifactsType): Record<string, ArtifactsType[]>;
+    /**
+     * @internal
+     */
+    load(): Promise<void>;
+}
+//# sourceMappingURL=software-info-model.d.ts.map

package/models/models/software-info/software-info-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-info-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/software-info/software-info-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAEb,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhF,eAAO,MAAM,UAAU,wBAAwB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;AAE5E;;;GAGG;AACH,qBACa,qBAAsB,YAAW,aAAa;IACzD,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IAEjC,sFAAsF;IACtF,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;gBAEhC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,kBAAkB;IAS7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,aAAa;IAU3D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB5B"}