@kosdev-code/kos-ui-sdk 2.1.37 → 2.1.38

package/core/util/model-utils.d.ts

@@ -1,11 +1,15 @@
 import { Transitions } from './model-transition-utils';
 import { DependencyLifecycle, KosDependencyParams } from '../types/kos-dependency';
-import { IKosDataModel, IKosModel } from '../core/kosModel';
+import { IKosModel } from '../core/kosModel';
 
-export { Transitions, TransitionMap } from './model-transition-utils';
-export { isPrintable, isKosDataModel, isKosModelContainer, resolveChild, } from './model-type-guards';
-export { ModelError } from './promise-utils';
+export { TransitionMap, Transitions } from './model-transition-utils';
 export type { ModelPromiseResolver } from './model-transition-utils';
+export { isKosDataModel, isKosModelContainer, isPrintable, resolveChild, } from './model-type-guards';
+export { ModelError } from './promise-utils';
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export interface ModelPromise {
     promise?: Promise<void>;
     modelId?: string;
@@ -13,20 +17,40 @@ export interface ModelPromise {
     type?: string;
     status?: string;
 }
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const createModelDependency: (model: IKosModel, dependency: KosDependencyParams<any>) => {
     dependentModel: null;
     dataModelId: string;
     success: boolean;
 } | {
     dependentModel: {
-        model: IKosModel<IKosDataModel>;
-        data: IKosDataModel;
+        model: IKosModel<import('../core/kosModel').IKosDataModel>;
+        data: import('../core/kosModel').IKosDataModel;
     };
     dataModelId: string;
     success: boolean;
 };
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const getDependenciesByLifecycle: (model: IKosModel, lifecycle?: DependencyLifecycle) => (Promise<void> | null)[];
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const executeListLifecycle: (sourceModel: IKosModel, models: (IKosModel | undefined)[], target: Transitions, sourceLifecycle: DependencyLifecycle) => Promise<void>;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const executeChildrenModelLifecycle: (model: IKosModel, target: Transitions, sourceLifecycle: DependencyLifecycle) => Promise<void>;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const executeDependentModelLifecycle: (model: IKosModel, lifecycle: DependencyLifecycle) => Promise<void>;
 //# sourceMappingURL=model-utils.d.ts.map

package/core/util/model-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/model-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGjE,OAAO,EACL,mBAAmB,EAEnB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAUtE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EACL,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,qBAAqB,UACzB,SAAS,cACJ,oBAAoB,GAAG,CAAC;;;;;;;;;;;CA+KrC,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAC9B,SAAS,cACL,mBAAmB,6BAqE/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,gBAClB,SAAS,UACd,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,UACzB,WAAW,mBACF,mBAAmB,kBAqHrC,CAAC;AAEF,eAAO,MAAM,6BAA6B,UACjC,SAAS,UACR,WAAW,mBACF,mBAAmB,kBAQrC,CAAC;AAEF,eAAO,MAAM,8BAA8B,UAClC,SAAS,aACL,mBAAmB,kBAa/B,CAAC"}
+{"version":3,"file":"model-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/model-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EACL,mBAAmB,EAEnB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAItE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,UACzB,SAAS,cACJ,oBAAoB,GAAG,CAAC;;;;;;;;;;;CA+KrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,UAC9B,SAAS,cACL,mBAAmB,6BAqE/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,gBAClB,SAAS,UACd,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,UACzB,WAAW,mBACF,mBAAmB,kBAqHrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,UACjC,SAAS,UACR,WAAW,mBACF,mBAAmB,kBAQrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,UAClC,SAAS,aACL,mBAAmB,kBAa/B,CAAC"}

package/core/util/observable-proxy-map.d.ts

@@ -1,4 +1,11 @@
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const KosObservableData: unique symbol;
+/**
+ * @kosService core.utils
+ */
 export type KosData<T extends Record<any, any>> = T & {
     setValues: (initialData?: T) => void;
     keys: (keyof T)[];
@@ -6,5 +13,9 @@ export type KosData<T extends Record<any, any>> = T & {
     values: T[keyof T][];
     has: (key: keyof T) => boolean;
 };
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const ObservableData: <T extends Record<string, any>>(initialData?: T) => KosData<T>;
 //# sourceMappingURL=observable-proxy-map.d.ts.map

package/core/util/observable-proxy-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observable-proxy-map.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/observable-proxy-map.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAyI7D,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG;IACpD,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACrC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACrB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,cAAc,gDACX,CAAC,KACd,QAAQ,CAAC,CAGX,CAAC"}
+{"version":3,"file":"observable-proxy-map.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/observable-proxy-map.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAyI7D;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG;IACpD,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACrC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAClB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACrB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,gDACX,CAAC,KACd,QAAQ,CAAC,CAGX,CAAC"}

package/core/util/paired-client-heartbeat.d.ts

@@ -10,6 +10,8 @@ interface HeartbeatOptions {
  * if one is closed, the other is notified of its closure.
  *
  * @category Utility
+ * @kosService core.utils
+ * @kosApiLevel 2
  */
 export declare const pairedClientHeartbeat: ({ relationshipId, destinationAddress, onAbort, waitTime, beatTime, }: HeartbeatOptions) => {
     cleanUpHeartbeat: () => void;

package/core/util/paired-client-heartbeat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paired-client-heartbeat.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/paired-client-heartbeat.ts"],"names":[],"mappings":"AAKA,UAAU,gBAAgB;IAExB,cAAc,EAAE,MAAM,CAAC;IAEvB,kBAAkB,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAGrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,yEAM/B,gBAAgB;;CA2DlB,CAAC"}
+{"version":3,"file":"paired-client-heartbeat.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/paired-client-heartbeat.ts"],"names":[],"mappings":"AAKA,UAAU,gBAAgB;IAExB,cAAc,EAAE,MAAM,CAAC;IAEvB,kBAAkB,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAGrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,yEAM/B,gBAAgB;;CA2DlB,CAAC"}

package/core/util/pipe.d.ts

@@ -1,4 +1,8 @@
 type PipeFn = (arg: any) => any;
+/**
+ * @kosService core.pipe
+ * @kosApiLevel 2
+ */
 export declare const pipe: (...fns: PipeFn[]) => (x: any) => any;
 export {};
 //# sourceMappingURL=pipe.d.ts.map

package/core/util/pipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/pipe.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC;AAChC,eAAO,MAAM,IAAI,WACN,MAAM,EAAE,SACb,GAAG,QACwB,CAAC"}
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/pipe.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC;AAChC;;;GAGG;AACH,eAAO,MAAM,IAAI,WACN,MAAM,EAAE,SACb,GAAG,QACwB,CAAC"}

package/core/util/retry-with-exponential-backoff.d.ts

@@ -12,6 +12,9 @@ interface BackoffOptions {
  * @param options - optional backoff options
  * @returns - the result of the operation if successful
  * @throws - the last error if all attempts fail
+ *
+ * @kosService core.fetch
+ * @kosApiLevel 2
  */
 export declare function retryWithExponentialBackoff<T>(operation: () => Promise<T>, options?: Partial<BackoffOptions>): Promise<T>;
 export {};

package/core/util/retry-with-exponential-backoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry-with-exponential-backoff.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/retry-with-exponential-backoff.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IAEpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB;AAUD;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,CAAC,EACjD,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,CAAC,CAAC,CA0BZ"}
+{"version":3,"file":"retry-with-exponential-backoff.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/retry-with-exponential-backoff.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IAEpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;CACvB;AAUD;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,CAAC,EACjD,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/core/util/service-factory.d.ts

@@ -4,6 +4,9 @@ import { KosServiceResponse } from './kos-fetch';
  * Resolves the service URL configuration.
  * @param _service - The optional service name (not used).
  * @returns An object with `isMock` and `URL` properties.
+ *
+ * @kosService core.service-request
+ * @kosApiLevel 2
  */
 export declare const resolveServiceUrl: (_service?: string) => {
     isMock: boolean;
@@ -63,6 +66,10 @@ interface ModifyModelParams<Request> extends Partial<Orderable>, Partial<StudioR
     id: string;
     urlOverride?: string;
 }
+/**
+ * @kosService core.service-request
+ * @kosApiLevel 2
+ */
 export declare class FetchError<T extends Record<string, any> | string = {
     error: string;
 }> extends Error {
@@ -84,6 +91,9 @@ interface ServiceFactoryParams {
 }
 /**
  * A factory for creating service instances with common configurations.
+ *
+ * @kosService core.service-request
+ * @kosApiLevel 2
  */
 export declare const ServiceFactory: {
     /**

package/core/util/service-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/service-factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service-factory.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/service-factory.ts"],"names":[],"mappings":"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"}

package/core/util/service-request-error.d.ts

@@ -0,0 +1,60 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+/**
+ * Rich error class for service request failures.
+ *
+ * Extends `Error` so it is backward-compatible with any code that expects
+ * a plain `Error`.  Adds HTTP response context so `onError` handlers in
+ * `@kosServiceRequest` can inspect status codes, response bodies, and headers.
+ *
+ * @example
+ * ```typescript
+ * errorHandler: {
+ *   strategy: 'log',
+ *   defaultValue: [],
+ *   onError: (error, model) => {
+ *     if (error instanceof ServiceRequestError) {
+ *       console.error('HTTP', error.status, error.responseBody);
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @category Service Request
+ * @kosService core.service-request
+ * @kosApiLevel 22
+ */
+export declare class ServiceRequestError extends Error {
+    /** HTTP status code (e.g. 404, 500) */
+    readonly status: number;
+    /** HTTP status text (e.g. "Not Found") */
+    readonly statusText: string;
+    /**
+     * Parsed response body (JSON) or raw text.
+     * `undefined` if the body could not be read.
+     */
+    readonly responseBody: unknown;
+    /** Response headers as a plain key/value map */
+    readonly responseHeaders: Record<string, string>;
+    constructor(message: string, details: {
+        status: number;
+        statusText: string;
+        responseBody?: unknown;
+        responseHeaders?: Record<string, string>;
+    });
+}
+/**
+ * Context captured from an HTTP error response.
+ * Used internally to thread rich error info through the service request pipeline.
+ * @internal
+ * @kosService core.service-request
+ * @kosApiLevel 22
+ */
+export interface ErrorResponseContext {
+    status: number;
+    statusText: string;
+    responseBody: unknown;
+    responseHeaders: Record<string, string>;
+}
+//# sourceMappingURL=service-request-error.d.ts.map

package/core/util/service-request-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-request-error.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/service-request-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,gDAAgD;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAG/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1C;CASJ;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC"}

package/core/util/service-response.d.ts

@@ -34,6 +34,8 @@ import { ApiPath, HttpMethod } from '../core/decorators/kos-service-request';
  * @param method - The HTTP method (defaults to 'get')
  * @returns The cached response data, or undefined if not found/expired
  *
+ * @kosService core.service-response
+ *
  * @example Standard usage (types inferred from OpenAPI)
  * ```typescript
  * const status = getServiceResponse(this, PATH_DEVICE_STATUS, 'get');
@@ -45,6 +47,7 @@ import { ApiPath, HttpMethod } from '../core/decorators/kos-service-request';
  * // Studio models using different OpenAPI than main SDK
  * const vms = getServiceResponse<StudioVMResponse>(this, PATH_VMS, 'get');
  * ```
+ * @kosApiLevel 15
  */
 export declare function getServiceResponse<T = any>(model: IKosDataModel, path: ApiPath, method?: HttpMethod): T | undefined;
 /**
@@ -55,6 +58,8 @@ export declare function getServiceResponse<T = any>(model: IKosDataModel, path:
  * @param method - The HTTP method (defaults to 'get')
  * @returns true if a valid cached response exists
  *
+ * @kosService core.service-response
+ *
  * @example
  * ```typescript
  * if (hasCachedResponse(this, PATH_DEVICE_STATUS, 'get')) {
@@ -65,6 +70,7 @@ export declare function getServiceResponse<T = any>(model: IKosDataModel, path:
  *   await this.refreshStatus();
  * }
  * ```
+ * @kosApiLevel 15
  */
 export declare function hasCachedResponse(model: IKosDataModel, path: ApiPath, method?: HttpMethod): boolean;
 /**
@@ -74,11 +80,14 @@ export declare function hasCachedResponse(model: IKosDataModel, path: ApiPath, m
  * @param path - The API path constant
  * @param method - The HTTP method (defaults to 'get')
  *
+ * @kosService core.service-response
+ *
  * @example
  * ```typescript
  * // Clear cached response to force refresh on next request
  * clearServiceResponse(this, PATH_TEMP_DATA, 'post');
  * ```
+ * @kosApiLevel 15
  */
 export declare function clearServiceResponse(model: IKosDataModel, path: ApiPath, method?: HttpMethod): void;
 /**
@@ -87,12 +96,15 @@ export declare function clearServiceResponse(model: IKosDataModel, path: ApiPath
  * @param model - The KOS model instance
  * @param path - The API path constant
  *
+ * @kosService core.service-response
+ *
  * @example
  * ```typescript
  * // Clear all cached responses for this endpoint
  * clearPath(this, PATH_INGREDIENTS);
  * // Clears GET, POST, PUT, DELETE responses for this path
  * ```
+ * @kosApiLevel 15
  */
 export declare function clearPath(model: IKosDataModel, path: ApiPath): void;
 /**
@@ -100,11 +112,14 @@ export declare function clearPath(model: IKosDataModel, path: ApiPath): void;
  *
  * @param model - The KOS model instance
  *
+ * @kosService core.service-response
+ *
  * @example
  * ```typescript
  * // Clear all cached responses (typically during model cleanup)
  * clearAllServiceResponses(this);
  * ```
+ * @kosApiLevel 15
  */
 export declare function clearAllServiceResponses(model: IKosDataModel): void;
 //# sourceMappingURL=service-response.d.ts.map

package/core/util/service-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-response.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/service-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACX,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EACxC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,CAAC,GAAG,SAAS,CAOf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,OAAO,CAOT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,IAAI,CAON;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAOnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAOnE"}
+{"version":3,"file":"service-response.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/service-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACX,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EACxC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,CAAC,GAAG,SAAS,CAOf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,OAAO,CAOT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,IAAI,CAON;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAOnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAOnE"}

package/core/util/session-utils.d.ts

@@ -1,3 +1,11 @@
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const getKosSessionKey: () => string;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const isLocalRefId: (id?: string) => boolean;
 //# sourceMappingURL=session-utils.d.ts.map

package/core/util/session-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/session-utils.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,QAAO,MAA8B,CAAC;AAEnE,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,OAC8B,CAAC"}
+{"version":3,"file":"session-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/session-utils.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAA8B,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,OAC8B,CAAC"}

package/core/util/wait-for-request.d.ts

@@ -1,15 +1,31 @@
 import { KosServiceResponse } from './kos-fetch';
 
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export interface ErrorResponse {
     error?: string;
 }
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const waitForRequest: <ResponseType extends ErrorResponse>(requestId: string, timeout?: number) => Promise<ResponseType>;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const sendRequest: <R, T extends KosServiceResponse<any>>(requestPromise: (param: R) => Promise<T | undefined>, params: R, refId: string) => Promise<T | undefined>;
 interface SyncPublishParams<T> {
     topic: string;
     msg: T;
     requestId?: string;
 }
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const syncPublish: <T, R extends ErrorResponse>({ topic, msg, requestId, }: SyncPublishParams<T>) => Promise<R>;
 export {};
 //# sourceMappingURL=wait-for-request.d.ts.map

package/core/util/wait-for-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wait-for-request.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/wait-for-request.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc,kDACd,MAAM,4CAqBf,CAAC;AAEL,eAAO,MAAM,WAAW,yDACN,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,CAAC,GAAG,SAAS,CAAC,UAC5C,CAAC,SACF,MAAM,2BAqBd,CAAC;AAEF,UAAU,iBAAiB,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,CAAC;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,eAAO,MAAM,WAAW,2DAIrB,kBAAkB,CAAC,CAAC,eAStB,CAAC"}
+{"version":3,"file":"wait-for-request.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/wait-for-request.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,kDACd,MAAM,4CAqBf,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,WAAW,yDACN,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,CAAC,GAAG,SAAS,CAAC,UAC5C,CAAC,SACF,MAAM,2BAqBd,CAAC;AAEF,UAAU,iBAAiB,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,CAAC;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD;;;GAGG;AACH,eAAO,MAAM,WAAW,2DAIrB,kBAAkB,CAAC,CAAC,eAStB,CAAC"}

package/core/util/when-ready.d.ts

@@ -13,9 +13,12 @@ import { IKosDataModel } from '../core/kosModel';
  * @throws {Error} If the specified data model is not found or if it has no ID.
  * @returns A promise that resolves to the same data model when it becomes ready.
  *
+ * @kosService core.utils
+ *
  * @example
  * // Wait for the 'dataModel' to become ready before using it.
  * const dataModel = await whenReady(dataModel);
+ * @kosApiLevel 2
  */
 export declare const whenReady: (dataModel: IKosDataModel) => Promise<IKosDataModel>;
 //# sourceMappingURL=when-ready.d.ts.map

package/core/util/when-ready.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"when-ready.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/when-ready.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,cAAqB,aAAa,2BAmBvD,CAAC"}
+{"version":3,"file":"when-ready.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/when-ready.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS,cAAqB,aAAa,2BAmBvD,CAAC"}