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

package/core/util/model-type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-type-guards.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/model-type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,WAAW,UAAW,GAAG;YAAsB,MAAM,MAAM;CACpC,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,cAAc,UAAW,GAAG,2BACF,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,mBAAmB,UACvB,GAAG,qCAE+C,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,cACZ,GAAG,KACb,aAAa,GAAG,aAAa,EAAE,GAAG,SAepC,CAAC"}

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

@@ -1,7 +1,15 @@
+import { Transitions } from './model-transition-utils';
 import { DependencyLifecycle, KosDependencyParams } from '../types/kos-dependency';
-import { IKosDataModel, IKosModel } from '../core/kosModel';
-import { IKosModelContainer } from '../core/kos-container-model';
+import { IKosModel } from '../core/kosModel';
 
+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;
@@ -9,37 +17,40 @@ export interface ModelPromise {
     type?: string;
     status?: string;
 }
-export type ModelPromiseResolver = (model: IKosModel) => Promise<void>;
-export declare const transitionToActive: (model: IKosModel) => Promise<void>;
-export declare const transitionToReady: (model: IKosModel) => Promise<void>;
-export declare const transitionToLoad: (model: IKosModel) => Promise<void>;
-export declare const transitionToUnload: (model: IKosModel) => Promise<void>;
-export declare const transitionToInit: (model: IKosModel) => Promise<void>;
-export declare enum Transitions {
-    ACTIVE = "active",
-    READY = "ready",
-    LOAD = "load",
-    UNLOAD = "unload",
-    INIT = "init"
-}
-export declare const TransitionMap: {
-    active: (model: IKosModel) => Promise<void>;
-    ready: (model: IKosModel) => Promise<void>;
-    load: (model: IKosModel) => Promise<void>;
-    init: (model: IKosModel) => Promise<void>;
-};
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const createModelDependency: (model: IKosModel, dependency: KosDependencyParams<any>) => {
-    dependentModel: import('../core/types/kos-model-manager-types').IKosCreateInstanceResponse<IKosDataModel>;
+    dependentModel: null;
     dataModelId: string;
+    success: boolean;
+} | {
+    dependentModel: {
+        model: IKosModel<import('../core/kosModel').IKosDataModel>;
+        data: import('../core/kosModel').IKosDataModel;
+    };
+    dataModelId: string;
+    success: boolean;
 };
-export declare const getDependenciesByLifecycle: (model: IKosModel, lifecycle?: DependencyLifecycle) => Promise<void>[];
+/**
+ * @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>;
-export declare const isPrintable: (model: any) => model is {
-    toJSON: () => object;
-};
-export declare const isKosDataModel: (model: any) => model is IKosDataModel;
-export declare const isKosModelContainer: (model: any) => model is IKosModelContainer<any>;
-export declare const resolveChild: (attribute: any) => any[] | IKosDataModel | undefined;
 //# 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,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGjE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAGjC,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;AASD,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AA8BvE,eAAO,MAAM,kBAAkB,UAAW,SAAS,KAAG,QAAQ,IAAI,CACM,CAAC;AAEzE,eAAO,MAAM,iBAAiB,UAAW,SAAS,KAAG,QAAQ,IAAI,CAC9C,CAAC;AAEpB,eAAO,MAAM,gBAAgB,UAAW,SAAS,KAAG,QAAQ,IAAI,CACG,CAAC;AAEpE,eAAO,MAAM,kBAAkB,UAAW,SAAS,KAAG,QAAQ,IAAI,CACK,CAAC;AAExE,eAAO,MAAM,gBAAgB,UAAW,SAAS,KAAG,QAAQ,IAAI,CACc,CAAC;AAE/E,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AACD,eAAO,MAAM,aAAa;oBAtBgB,SAAS,KAAG,QAAQ,IAAI,CAAC;mBAG1B,SAAS,KAAG,QAAQ,IAAI,CAAC;kBAG1B,SAAS,KAAG,QAAQ,IAAI,CAAC;kBAMzB,SAAS,KAAG,QAAQ,IAAI,CAAC;CAehE,CAAC;AAEF,eAAO,MAAM,qBAAqB,UACzB,SAAS,cACJ,oBAAoB,GAAG,CAAC;;;CA2BrC,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAC9B,SAAS,cACL,mBAAmB,oBAmD/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,gBAClB,SAAS,UACd,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,UACzB,WAAW,mBACF,mBAAmB,kBA8ErC,CAAC;AAEF,eAAO,MAAM,6BAA6B,UACjC,SAAS,UACR,WAAW,mBACF,mBAAmB,kBAQrC,CAAC;AAEF,eAAO,MAAM,8BAA8B,UAClC,SAAS,aACL,mBAAmB,kBAa/B,CAAC;AAEF,eAAO,MAAM,WAAW,UAAW,GAAG;YAAsB,MAAM,MAAM;CACpC,CAAC;AAErC,eAAO,MAAM,cAAc,UAAW,GAAG,2BACF,CAAC;AAExC,eAAO,MAAM,mBAAmB,UACvB,GAAG,qCAE+C,CAAC;AAE5D,eAAO,MAAM,YAAY,cAAe,GAAG,sCAe1C,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;AA4F7D,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/promise-utils.d.ts

@@ -0,0 +1,58 @@
+import { IKosModel } from '../core/kosModel';
+
+/**
+ * Custom error for model timeout scenarios
+ */
+export declare class ModelError extends Error {
+    model: IKosModel;
+    constructor(message: string | undefined, model: IKosModel);
+}
+/**
+ * Creates a promise that rejects after a specified delay with model context.
+ * Provides a cancel function to prevent rejection if the operation completes.
+ *
+ * @param ms - Timeout duration in milliseconds
+ * @param model - The model being operated on
+ * @param status - Description of the operation status (e.g., "ACTIVE", "INACTIVE")
+ * @returns Object containing the timeout promise and a cancel function
+ *
+ * @example
+ * ```typescript
+ * const { promise: timeoutPromise, cancel } = rejectAfterDelay(
+ *   MODEL_PROMISE_TIMEOUT_MS,
+ *   myModel,
+ *   'ACTIVE'
+ * );
+ *
+ * Promise.race([
+ *   myOperation().then(() => cancel()),
+ *   timeoutPromise
+ * ]);
+ * ```
+ */
+export declare const rejectAfterDelay: (ms: number, model: IKosModel, status: string) => {
+    promise: Promise<void>;
+    cancel: () => void;
+};
+/**
+ * Races a promise against a timeout with automatic cleanup.
+ * Useful for ensuring operations complete within a time limit.
+ *
+ * @param promise - The operation promise to race
+ * @param timeoutMs - Timeout duration in milliseconds (defaults to MODEL_PROMISE_TIMEOUT_MS)
+ * @param model - The model being operated on
+ * @param status - Description of the operation
+ * @returns Promise that resolves/rejects based on whichever completes first
+ *
+ * @example
+ * ```typescript
+ * await raceWithTimeout(
+ *   model.transitionToActive(),
+ *   MODEL_PROMISE_TIMEOUT_MS,
+ *   model,
+ *   'ACTIVE'
+ * );
+ * ```
+ */
+export declare const raceWithTimeout: <T>(promise: Promise<T>, timeoutMs: number | undefined, model: IKosModel, status: string) => Promise<T>;
+//# sourceMappingURL=promise-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promise-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/promise-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,KAAK,EAAE,SAAS,CAAC;gBACL,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS;CAI1D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,gBAAgB,OACvB,MAAM,SACH,SAAS,UACR,MAAM,KACb;IAAE,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAsB9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,eAAe,eACjB,QAAQ,CAAC,CAAC,wCAEZ,SAAS,UACR,MAAM,KACb,QAAQ,CAAC,CAeX,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

@@ -0,0 +1,125 @@
+import { IKosDataModel } from '../core/kosModel';
+import { ApiPath, HttpMethod } from '../core/decorators/kos-service-request';
+
+/**
+ * Utility functions for accessing cached service responses from ServiceResponseStore
+ *
+ * These functions provide type-safe access to responses stored by @kosServiceRequest
+ * decorated methods, eliminating the need for "magic last parameter" patterns.
+ *
+ * @example
+ * ```typescript
+ * @kosServiceRequest({
+ *   path: PATH_INGREDIENTS,
+ *   method: 'get',
+ *   lifecycle: DependencyLifecycle.LOAD
+ * })
+ * private onIngredientsLoaded(): void {
+ *   const response = getServiceResponse(this, PATH_INGREDIENTS, 'get');
+ *   this.processIngredients(response.data.ingredients);
+ * }
+ * ```
+ */
+/**
+ * Get cached service response by path and method
+ *
+ * Returns the response data cached by @kosServiceRequest decorated methods.
+ * TypeScript will infer types from your OpenAPI schema when using typed path constants.
+ *
+ * For cross-package scenarios where OpenAPI specs differ, you can optionally
+ * provide an explicit type parameter.
+ *
+ * @param model - The KOS model instance
+ * @param path - The API path constant
+ * @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');
+ * // TypeScript infers the type from PATH_DEVICE_STATUS
+ * ```
+ *
+ * @example Cross-package usage with explicit type (when OpenAPI schemas differ)
+ * ```typescript
+ * // 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;
+/**
+ * Check if a cached response exists for the given path and method
+ *
+ * @param model - The KOS model instance
+ * @param path - The API path constant
+ * @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')) {
+ *   // Use cached data
+ *   const status = getServiceResponse(this, PATH_DEVICE_STATUS, 'get');
+ * } else {
+ *   // Fetch fresh data
+ *   await this.refreshStatus();
+ * }
+ * ```
+ * @kosApiLevel 15
+ */
+export declare function hasCachedResponse(model: IKosDataModel, path: ApiPath, method?: HttpMethod): boolean;
+/**
+ * Manually clear a cached service response
+ *
+ * @param model - The KOS model instance
+ * @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;
+/**
+ * Clear all cached responses for a specific path (all methods)
+ *
+ * @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;
+/**
+ * Clear all cached service responses in the model
+ *
+ * @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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}