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

package/models/models/gpio-chip/gpio-chip-container-model.d.ts

@@ -0,0 +1,25 @@
+import { GpioChipContainerOptions } from './types';
+import { GpioChipContainerResponse } from './services';
+import { GpioChipModel } from './gpio-chip-model';
+import { PublicModelInterface } from '../../../core/types';
+import { IKosIdentifiable } from '../../../core/core/types';
+import { IKosDataModel } from '../../../core/core/kosModel';
+import { KosContainerAware, KosLoggerAware } from '../../../core/core/decorators';
+import { SingletonKosModelRegistrationFactory } from '../../../core';
+
+export declare const MODEL_TYPE = "gpio-chip-container-model";
+export type GpioChipContainerModel = PublicModelInterface<GpioChipContainerModelImpl>;
+export interface GpioChipContainerModelImpl extends KosLoggerAware, KosContainerAware<GpioChipModel> {
+}
+export declare class GpioChipContainerModelImpl implements IKosIdentifiable, IKosDataModel {
+    static Registration: SingletonKosModelRegistrationFactory<GpioChipContainerModel, GpioChipContainerOptions>;
+    id: string;
+    destinationAddress: string;
+    constructor(modelId: string, options: GpioChipContainerOptions);
+    updateModel(_options: GpioChipContainerOptions): void;
+    handleGpioChipInit(_error: never, response: Record<string, GpioChipContainerResponse>): Promise<void>;
+    init(): Promise<void>;
+    load(): Promise<void>;
+}
+export declare const GpioChipContainer: SingletonKosModelRegistrationFactory<GpioChipContainerModel, GpioChipContainerOptions>;
+//# sourceMappingURL=gpio-chip-container-model.d.ts.map

package/models/models/gpio-chip/gpio-chip-container-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpio-chip-container-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/gpio-chip/gpio-chip-container-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,eAAO,MAAM,UAAU,8BAA8B,CAAC;AAEtD,MAAM,MAAM,sBAAsB,GAChC,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;AAGnD,MAAM,WAAW,0BACf,SAAQ,cAAc,EACpB,iBAAiB,CAAC,aAAa,CAAC;CAAG;AAEvC,qBAOa,0BACX,YAAW,gBAAgB,EAAE,aAAa;IAG1C,MAAM,CAAC,YAAY,EAAE,oCAAoC,CACvD,sBAAsB,EACtB,wBAAwB,CACzB,CAAC;IAEF,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB;IAK9D,WAAW,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAkB/C,kBAAkB,CACtB,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC;IAiFV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AACD,eAAO,MAAM,iBAAiB,wFAA0C,CAAC"}

package/models/models/gpio-chip/gpio-chip-model.d.ts

@@ -0,0 +1,30 @@
+import { GpioChipOptions } from './types';
+import { GpioPinContainerModel } from '../gpio-pin';
+import { PublicModelInterface } from '../../../core/types';
+import { IKosIdentifiable } from '../../../core/core/types';
+import { KosModelRegistrationType } from '../../../core/core/registration/model-registration';
+import { IKosDataModel } from '../../../core/core/kosModel';
+import { KosLoggerAware } from '../../../core/core/decorators';
+
+export declare const MODEL_TYPE = "gpio-chip-model";
+export type GpioChipModel = PublicModelInterface<GpioChipModelImpl>;
+export interface GpioChipModelImpl extends KosLoggerAware {
+}
+export declare class GpioChipModelImpl implements IKosDataModel, IKosIdentifiable {
+    static Registration: KosModelRegistrationType<GpioChipModel, GpioChipOptions>;
+    id: string;
+    num: number;
+    devName: string;
+    name: string;
+    pinCount: number;
+    pinNames: string[];
+    private _pins;
+    constructor(modelId: string, options: GpioChipOptions);
+    get pinManager(): GpioPinContainerModel;
+    updateModel(_options: GpioChipOptions): void;
+    handleGpioChipLoad(): Promise<void>;
+    init(): Promise<void>;
+    load(): Promise<void>;
+}
+export declare const GpioChip: KosModelRegistrationType<GpioChipModel, GpioChipOptions>;
+//# sourceMappingURL=gpio-chip-model.d.ts.map

package/models/models/gpio-chip/gpio-chip-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpio-chip-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/gpio-chip/gpio-chip-model.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,cAAc,EAEf,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE3E,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;AAIpE,MAAM,WAAW,iBAAkB,SAAQ,cAAc;CAAG;AAE5D,qBAEa,iBAAkB,YAAW,aAAa,EAAE,gBAAgB;IAEvE,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAE9E,EAAE,EAAE,MAAM,CAAC;IAEX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAET,OAAO,CAAC,KAAK,CAAwB;gBAGnC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;IAcrD,IAAI,UAAU,0BAEb;IAED,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAMtC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED,eAAO,MAAM,QAAQ,0DAAiC,CAAC"}

package/models/models/gpio-chip/index.d.ts

@@ -0,0 +1,7 @@
+export { GpioChipContainer } from './gpio-chip-container-model';
+export { GpioChip } from './gpio-chip-model';
+export type { GpioChipContainerModel } from './gpio-chip-container-model';
+export type { GpioChipModel } from './gpio-chip-model';
+export type * from './types';
+export * as GpioChipServices from './services';
+//# sourceMappingURL=index.d.ts.map

package/models/models/gpio-chip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/gpio-chip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,mBAAmB,SAAS,CAAC;AAG7B,OAAO,KAAK,gBAAgB,MAAM,YAAY,CAAC"}

package/models/models/gpio-chip/services/gpio-chip-services.d.ts

@@ -0,0 +1,86 @@
+import { KOS_SERVICE_1_9_X as KOS_SERVICE } from '../../../utils/services-index';
+
+export declare const GPIO_CHIP_PATH: KOS_SERVICE.ApiPath;
+export type GpioChipContainerResponse = KOS_SERVICE.ApiResponse<typeof GPIO_CHIP_PATH, "get">;
+export declare const GPIO_PIN_PATH: KOS_SERVICE.ApiPath;
+export type GpioPinContainerResponse = KOS_SERVICE.ApiResponse<typeof GPIO_PIN_PATH, "get">;
+export declare const gpioServiceRequest: typeof KOS_SERVICE.kosServiceRequest;
+export declare const gpioApi: {
+    get: <K extends "/api/kos/network/interfaces" | "/api/kos/ui/plugins/context/{*name}" | "/api/kos/ui/plugins/contexts" | "/api/kos/localization/context/{*path}" | "/api/kos/localization/contexts" | "/api/kos/browser" | "/api/kos/browser/redirect" | "/api/kos/future/traces" | "/api/kos/future/traces/{traceId}/events" | "/api/kos/ota/paused" | "/api/kos/ota/artifacts" | "/api/kos/state/paths" | "/api/kos/state/{path}" | "/api/kos/hardware/resolver/identityMappings" | "/api/kos/config/schema" | "/api/kos/config/schema/{path}" | "/api/kos/config/{path}" | "/api/kos/config/details/{options}" | "/api/kos/config/details/{path}/{options}" | "/api/kos/config/value/merged/{scopedPath}/{attr}" | "/api/kos/config/value/{scopedPath}/{attr}" | "/api/kos/config/bean/defaults/{scopedPath}" | "/api/kos/config/bean/merged/{path}" | "/api/kos/config/bean/overrides/{scopedPath}" | "/api/kos/storage/devices" | "/api/kos/update/available" | "/api/kos/troubles" | "/api/kos/troubles/{troubleId}" | "/api/kos/handles" | "/api/kos/handles/{path}" | "/api/kos/handles/{path}/{view}" | "/api/kos/handles/views" | "/api/kos/openapi/{*baseUrl}" | "/api/kos/manifest/node" | "/api/kos/manifest/device" | "/api/kos/manifest/info" | "/api/kos/apps" | "/api/kos/apps/started" | "/api/kos/time/timezone" | "/api/kos/regions" | "/api/kos/regions/info" | "/api/kos/descriptor/{path}" | "/api/kos/descriptor/{path}/{dotted}" | "/api/kos/logs/rotateAll" | "/api/kos/logs/node/{nodeId}/streams" | "/api/kos/logs/node/{nodeId}/{stream}/blocks" | "/api/kos/logs/node/{nodeId}/{stream}/blocks/{blockId}" | "/api/kos/logs/rotate/{stream}" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests" | "/api/kos/nodeMgr/blockedManifests" | "/api/kos/logs/groups" | "/api/kos/logs/overrides/{nodeType}" | "/api/kos/logs/overrides/{nodeType}/{typePrefix}" | "/api/kos/studio/properties" | "/api/kos/criticalData/sources" | "/api/kos/criticalData/data" | "/api/kos/criticalData/data/{name}" | "/api/kos/device" | "/api/kos/device/assemblies" | "/api/kos/device/serialNumber" | "/api/kos/context" | "/api/kos/gpio/chips" | "/api/kos/gpio/pins">(endpoint: K, params?: (import('../../../utils/services/kos/1.9.x/openapi').paths[K]["get"] extends {
+        parameters: infer P;
+    } ? P : never) | undefined, options?: {
+        ordered?: boolean | undefined;
+        tracker?: string | undefined;
+        timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
+        headers?: Record<string, string> | undefined;
+        fos?: boolean | undefined;
+        studio?: boolean | undefined;
+        signal?: AbortSignal | undefined;
+        stream?: boolean | undefined;
+        responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
+        retry?: boolean | import('../../../../core').RetryConfig | undefined;
+    } | undefined) => Promise<import('../../../../core').ServiceResponse<import('../../../../core').ClientResponse<import('../../../utils/services/kos/1.9.x/openapi').paths, K, "get">>>;
+    post: <K_1 extends "/api/kos/network/set-connection/{nodeId}" | "/api/kos/network/connect-node-to-wifi" | "/api/kos/browser/{nodeId}" | "/api/kos/browser/{nodeId}/{name}" | "/api/kos/browser/intent" | "/api/kos/browser/url" | "/api/kos/future/{futureId}/cancel" | "/api/kos/ota/resume/{name}" | "/api/kos/ota/cancel" | "/api/kos/ota/cancel/{name}" | "/api/kos/ota/pause/{name}" | "/api/kos/hardware/resolver/identityMappings/{boardPath}" | "/api/kos/config/{path}" | "/api/kos/config/bulk" | "/api/kos/update/install" | "/api/kos/troubles/resolve" | "/api/kos/troubles/resolve/{troubleId}" | "/api/kos/time/date" | "/api/kos/time/timezone" | "/api/kos/time/time" | "/api/kos/logs/node/{nodeId}/{stream}/subscribe" | "/api/kos/logs/node/{nodeId}/{stream}/unsubscribe" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/reboot" | "/api/kos/nodeMgr/node/{nodeId}/reboot" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests/{manifestId}" | "/api/kos/nodeMgr/blockedManifests/{manifestId}" | "/api/kos/criticalData/data" | "/api/kos/criticalData/data/{name}" | "/api/kos/device/serialNumber/{serialNum}" | "/api/kos/update/internalUpdate" | "/api/kos/update/internalUpdateAndReboot">(endpoint: K_1, params?: (import('../../../utils/services/kos/1.9.x/openapi').paths[K_1]["post"] extends {
+        parameters: infer P_1;
+    } ? P_1 : never) | undefined, body?: (import('../../../utils/services/kos/1.9.x/openapi').paths[K_1]["post"] extends {
+        requestBody: {
+            content: infer B;
+        };
+    } ? B[keyof B] : never) | undefined, options?: {
+        ordered?: boolean | undefined;
+        tracker?: string | undefined;
+        timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
+        headers?: Record<string, string> | undefined;
+        fos?: boolean | undefined;
+        studio?: boolean | undefined;
+        signal?: AbortSignal | undefined;
+        stream?: boolean | undefined;
+        responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
+        retry?: boolean | import('../../../../core').RetryConfig | undefined;
+    } | undefined) => Promise<import('../../../../core').ServiceResponse<import('../../../../core').ClientResponse<import('../../../utils/services/kos/1.9.x/openapi').paths, K_1, "post">>>;
+    put: <K_2 extends never>(endpoint: K_2, params?: (import('../../../utils/services/kos/1.9.x/openapi').paths[K_2]["put"] extends {
+        parameters: infer P_2;
+    } ? P_2 : never) | undefined, body?: (import('../../../utils/services/kos/1.9.x/openapi').paths[K_2]["put"] extends {
+        requestBody: {
+            content: infer B_1;
+        };
+    } ? B_1[keyof B_1] : never) | undefined, options?: {
+        ordered?: boolean | undefined;
+        tracker?: string | undefined;
+        timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
+        headers?: Record<string, string> | undefined;
+        fos?: boolean | undefined;
+        studio?: boolean | undefined;
+        signal?: AbortSignal | undefined;
+        stream?: boolean | undefined;
+        responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
+        retry?: boolean | import('../../../../core').RetryConfig | undefined;
+    } | undefined) => Promise<import('../../../../core').ServiceResponse<import('../../../../core').ClientResponse<import('../../../utils/services/kos/1.9.x/openapi').paths, K_2, "put">>>;
+    delete: <K_3 extends "/api/kos/hardware/resolver/identityMappings/{boardPath}" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests/{manifestId}" | "/api/kos/nodeMgr/blockedManifests/{manifestId}" | "/api/kos/criticalData/data/{name}">(endpoint: K_3, params?: (import('../../../utils/services/kos/1.9.x/openapi').paths[K_3]["delete"] extends {
+        parameters: infer P_3;
+    } ? P_3 : never) | undefined, body?: (import('../../../utils/services/kos/1.9.x/openapi').paths[K_3]["put"] extends {
+        requestBody: {
+            content: infer B_1;
+        };
+    } ? B_1[keyof B_1] : never) | undefined, options?: {
+        ordered?: boolean | undefined;
+        tracker?: string | undefined;
+        timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
+        headers?: Record<string, string> | undefined;
+        fos?: boolean | undefined;
+        studio?: boolean | undefined;
+        signal?: AbortSignal | undefined;
+        stream?: boolean | undefined;
+        responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
+        retry?: boolean | import('../../../../core').RetryConfig | undefined;
+    } | undefined) => Promise<import('../../../../core').ServiceResponse<import('../../../../core').ClientResponse<import('../../../utils/services/kos/1.9.x/openapi').paths, K_3, "delete">>>;
+};
+//# sourceMappingURL=gpio-chip-services.d.ts.map

package/models/models/gpio-chip/services/gpio-chip-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpio-chip-services.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/gpio-chip/services/gpio-chip-services.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,IAAI,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAQjF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,OAA+B,CAAC;AACzE,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,WAAW,CAC7D,OAAO,cAAc,EACrB,KAAK,CACN,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,OAA8B,CAAC;AACvE,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,WAAW,CAC5D,OAAO,aAAa,EACpB,KAAK,CACN,CAAC;AAEF,eAAO,MAAM,kBAAkB,sCAAgC,CAAC;AAChE,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAkB,CAAC"}

package/models/models/gpio-chip/services/index.d.ts

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

package/models/models/gpio-chip/services/index.d.ts.map

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

package/models/models/gpio-chip/types/index.d.ts

@@ -0,0 +1,24 @@
+// ---------------  GpioChip ---------------
+
+/**
+ * Configuration options for GpioChip model instances.
+ *
+ * @kosService core.gpio
+ */
+export interface GpioChipOptions {
+  num: number;
+  devName: string;
+  name: string;
+  pinCount: number;
+  pinNames: string[];
+}
+
+// ---------------  GpioChipContainer ---------------
+/**
+ * Configuration options for GpioChipContainer model instances.
+ *
+ * @kosService core.gpio
+ */
+export interface GpioChipContainerOptions {
+  destinationAddress?: string;
+}

package/models/models/gpio-pin/gpio-pin-container-model.d.ts

@@ -0,0 +1,23 @@
+import { GpioPinContainerOptions } from './types';
+import { GpioPinModel } from './gpio-pin-model';
+import { PublicModelInterface } from '../../../core/types';
+import { IKosIdentifiable } from '../../../core/core/types';
+import { KosModelRegistrationType } from '../../../core/core/registration/model-registration';
+import { IKosDataModel } from '../../../core/core/kosModel';
+import { KosContainerAware, KosLoggerAware } from '../../../core/core/decorators';
+
+export declare const MODEL_TYPE = "gpio-pin-container-model";
+export type GpioPinContainerModel = PublicModelInterface<GpioPinContainerModelImpl>;
+export interface GpioPinContainerModelImpl extends KosLoggerAware, KosContainerAware<GpioPinModel> {
+}
+export declare class GpioPinContainerModelImpl implements IKosIdentifiable, IKosDataModel {
+    static Registration: KosModelRegistrationType<GpioPinContainerModel, GpioPinContainerOptions>;
+    id: string;
+    constructor(modelId: string, _options: GpioPinContainerOptions);
+    updateModel(_options: GpioPinContainerOptions): void;
+    getPin(pinNum: number): GpioPinModel | undefined;
+    init(): Promise<void>;
+    load(): Promise<void>;
+}
+export declare const GpioPinContainer: KosModelRegistrationType<GpioPinContainerModel, GpioPinContainerOptions>;
+//# sourceMappingURL=gpio-pin-container-model.d.ts.map

package/models/models/gpio-pin/gpio-pin-container-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpio-pin-container-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/gpio-pin/gpio-pin-container-model.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEvD,eAAO,MAAM,UAAU,6BAA6B,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAC/B,oBAAoB,CAAC,yBAAyB,CAAC,CAAC;AAGlD,MAAM,WAAW,yBACf,SAAQ,cAAc,EACpB,iBAAiB,CAAC,YAAY,CAAC;CAAG;AAEtC,qBAOa,yBACX,YAAW,gBAAgB,EAAE,aAAa;IAG1C,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAC3C,qBAAqB,EACrB,uBAAuB,CACxB,CAAC;IAEF,EAAE,EAAE,MAAM,CAAC;gBAEC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB;IAK9D,WAAW,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAIpD,MAAM,CAAC,MAAM,EAAE,MAAM;IAkBf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AACD,eAAO,MAAM,gBAAgB,0EAAyC,CAAC"}

package/models/models/gpio-pin/gpio-pin-model.d.ts

@@ -0,0 +1,26 @@
+import { GpioPinOptions } from './types';
+import { PublicModelInterface } from '../../../core/types';
+import { IKosIdentifiable } from '../../../core/core/types';
+import { KosModelRegistrationType } from '../../../core/core/registration/model-registration';
+import { IKosDataModel } from '../../../core/core/kosModel';
+import { KosLoggerAware } from '../../../core/core/decorators';
+
+export declare const MODEL_TYPE = "gpio-pin-model";
+export type GpioPinModel = PublicModelInterface<GpioPinModelImpl>;
+export interface GpioPinModelImpl extends KosLoggerAware {
+}
+export declare class GpioPinModelImpl implements IKosDataModel, IKosIdentifiable {
+    static Registration: KosModelRegistrationType<GpioPinModel, GpioPinOptions>;
+    id: string;
+    pinNum: number;
+    chipNum: number;
+    name: string;
+    status: "bound" | "pending" | "invalid" | "free";
+    connected: boolean;
+    constructor(modelId: string, options: GpioPinOptions);
+    updateModel(options: Partial<Omit<GpioPinOptions, "chipNum" | "pinNum" | "name">>): void;
+    init(): Promise<void>;
+    load(): Promise<void>;
+}
+export declare const GpioPin: KosModelRegistrationType<GpioPinModel, GpioPinOptions>;
+//# sourceMappingURL=gpio-pin-model.d.ts.map

package/models/models/gpio-pin/gpio-pin-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpio-pin-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/gpio-pin/gpio-pin-model.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,cAAc,EAEf,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,eAAO,MAAM,UAAU,mBAAmB,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;AAIlE,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAE3D,qBAEa,gBAAiB,YAAW,aAAa,EAAE,gBAAgB;IAEtE,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAE5E,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACjD,SAAS,EAAE,OAAO,CAAC;gBAGP,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;IASpD,WAAW,CACT,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,GACpE,IAAI;IASD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED,eAAO,MAAM,OAAO,wDAAgC,CAAC"}

package/models/models/gpio-pin/index.d.ts

@@ -0,0 +1,6 @@
+export { GpioPinContainer } from './gpio-pin-container-model';
+export { GpioPin } from './gpio-pin-model';
+export type { GpioPinContainerModel } from './gpio-pin-container-model';
+export type { GpioPinModel } from './gpio-pin-model';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

package/models/models/gpio-pin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/gpio-pin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,mBAAmB,SAAS,CAAC"}

package/models/models/gpio-pin/types/index.d.ts

@@ -0,0 +1,23 @@
+// ---------------  GpioPin ---------------
+
+/**
+ * Configuration options for GpioPin model instances.
+ *
+ * @kosService core.gpio
+ */
+export interface GpioPinOptions {
+  name: string;
+  chipNum: number;
+  pinNum: number;
+  connected?: boolean;
+  pinBinding?: Record<string, any>;
+  status?: "bound" | "pending" | "invalid" | "free";
+}
+
+// ---------------  GpioPinContainer ---------------
+/**
+ * Configuration options for GpioPinContainer model instances.
+ *
+ * @kosService core.gpio
+ */
+export interface GpioPinContainerOptions {}

package/models/models/index.d.ts

@@ -4,6 +4,7 @@ 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,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,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"}

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

@@ -1,5 +1,9 @@
 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,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;;;GAGG;AACH,OAAO,KAAK,gBAAgB,MAAM,YAAY,CAAC;AAC/C,mBAAmB,SAAS,CAAC"}

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

@@ -3,17 +3,128 @@ 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,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"}
+{"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"}

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

@@ -1,18 +1,140 @@
+/**
+ * @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>;
 /**
- * @category Service
- * Retrieves the initial studio-state data.
+ * 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
  */
 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":"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"}
+{"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"}