@kosdev-code/kos-ui-sdk 2.1.23 → 2.1.26

package/core/constants/model-constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Constants for KOS model lifecycle and operations
+ */
+/**
+ * Timeout in milliseconds for model lifecycle transitions.
+ * Models that don't complete their transition within this time will reject.
+ */
+export declare const MODEL_PROMISE_TIMEOUT_MS = 5000;
+//# sourceMappingURL=model-constants.d.ts.map

package/core/constants/model-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-constants.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/constants/model-constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC"}

package/core/core/decorators/kos-service-request.d.ts

@@ -2,9 +2,11 @@ import { KosExecutionContext } from './kos-execution-context';
 import { KosModelRegistrationType } from '../registration/model-registration';
 import { IKosDataModel } from '../kosModel';
 import { ClientBody, ClientParams } from '../../util/kos-service-request';
+import { KosFetchOptions } from '../../types/utils/kos-fetch';
 import { ResponseCacheConfig } from '../../types/service-response-store';
 import { DependencyLifecycle } from '../../types';
 
+export type RequestOptions = Omit<KosFetchOptions, "method" | "body">;
 export type { KosExecutionContext };
 /**
  * Symbol for storing service request handlers metadata on model instances
@@ -270,6 +272,26 @@ export interface IKosServiceRequestParams<Paths extends Record<string, any> = Re
      * cache: { retention: ResponseRetention.PERMANENT }
      */
     cache?: ResponseCacheConfig;
+    /**
+     * Request options for controlling fetch behavior
+     * These are merged with runtime options passed to ctx.$request()
+     * Runtime options take precedence over decorator options
+     *
+     * @example
+     * // Set default timeout and destination for all requests
+     * requestOptions: {
+     *   destinationAddress: 'device-123',
+     *   timeout: 10000
+     * }
+     *
+     * @example
+     * // Dynamic from method arguments
+     * requestOptions: (model, ...args) => ({
+     *   destinationAddress: model.deviceId,
+     *   headers: { 'X-Session': model.sessionId }
+     * })
+     */
+    requestOptions?: RequestOptions | ((model: IKosDataModel, ...args: any[]) => RequestOptions);
 }
 /**
  * Metadata stored for each service request handler
@@ -298,6 +320,7 @@ export interface ServiceRequestExecutor<Paths extends Record<string, any> = Reco
             query?: infer Q;
         } ? Q : never;
         body?: ClientBody<Paths, Path, Method>;
+        requestOptions?: RequestOptions;
     }): Promise<[string | null, any]>;
 }
 /**
@@ -339,7 +362,10 @@ export type ServiceRequestExecutorFn<Paths extends Record<string, any> = Record<
  * ```typescript
  * @kosServiceRequest({
  *   path: PATH_VM_INSTALL,
- *   method: 'post'
+ *   method: 'post',
+ *   requestOptions: {
+ *     timeout: 10000  // Decorator-level default timeout
+ *   }
  * })
  * async createRelease(
  *   path: string,
@@ -348,7 +374,11 @@ export type ServiceRequestExecutorFn<Paths extends Record<string, any> = Record<
  * ): Promise<void> {
  *   const [error, response] = await ctx.$request({
  *     queryParams: { keySetId: keysetId },
- *     body: { path }
+ *     body: { path },
+ *     requestOptions: {
+ *       destinationAddress: 'device-123',  // Runtime options merged with decorator options
+ *       headers: { 'X-Custom-Header': 'value' }
+ *     }
  *   });
  *   if (error) throw new Error(error);
  *   return response?.data;

package/core/core/decorators/kos-service-request.d.ts.map

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

package/core/core/model-instantiator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-instantiator.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/model-instantiator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EAAY,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAU5C;;;GAGG;AACH,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IAJf,OAAO,CAAC,qBAAqB,CAA2B;gBAG9C,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,oBAAoB;IASrC,mBAAmB,CAAC,OAAO,SAAS,aAAa,EAC/C,MAAM,EAAE,MAAM,EACd,EAAE,CAAC,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAChC;QAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IA4C/C;;;;;;;OAOG;IACH,qBAAqB,CACnB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,SAAS,CAAC,EAAE,mBAAmB;IAKjC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAM/B"}
+{"version":3,"file":"model-instantiator.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/model-instantiator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAKpD,OAAO,EAAY,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAU5C;;;GAGG;AACH,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IAJf,OAAO,CAAC,qBAAqB,CAA2B;gBAG9C,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,oBAAoB;IASrC,mBAAmB,CAAC,OAAO,SAAS,aAAa,EAC/C,MAAM,EAAE,MAAM,EACd,EAAE,CAAC,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAChC;QAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAwF/C;;;;;;;OAOG;IACH,qBAAqB,CACnB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,SAAS,CAAC,EAAE,mBAAmB;IAKjC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAM/B"}

package/core/types/kos-dependency.d.ts

@@ -7,20 +7,28 @@ export declare enum DependencyLifecycle {
 }
 /**
  * Policy for handling dependency resolution failures.
+ *
+ * All policies follow a lookup-first approach: The framework first checks if a model
+ * with the specified ID already exists. If found and the type matches, it returns the
+ * existing instance. Only if no existing model is found does the framework apply the
+ * resolution policy below.
  */
 export declare enum DependencyResolutionPolicy {
     /**
-     * CREATE (default) - Attempt to create a new instance of the model if it doesn't exist.
-     * If the model expects options and none are provided, it will fail with an exception.
+     * CREATE (default) - After lookup fails, attempt to create a new instance of the model.
+     * If the model requires options (via optionsRequired flag) and none are provided,
+     * it will fail with an exception.
      */
     CREATE = "create",
     /**
-     * CONTINUE - Do not create a new instance if the dependency cannot be resolved.
-     * The property will be set to undefined/null. Log the failure but allow execution to continue.
+     * CONTINUE - After lookup fails, do not attempt to create a new instance.
+     * The property will be set to undefined. Log the failure but allow execution to continue.
+     * Use for optional dependencies that can degrade gracefully.
      */
     CONTINUE = "continue",
     /**
-     * FAIL - Throw an exception and log detailed failure information if the dependency cannot be resolved.
+     * FAIL - After lookup fails, throw an exception with detailed diagnostic logging.
+     * Use for critical dependencies where failure should halt execution.
      */
     FAIL = "fail"
 }
@@ -38,9 +46,13 @@ export interface KosDependencyParams<Options = unknown> {
     lifecycle?: DependencyLifecycle;
     /**
      * Policy for handling dependency resolution failures.
-     * - CREATE (default): Attempts to create model instance, fails if options are missing
-     * - CONTINUE: Logs error but continues with undefined dependency
-     * - FAIL: Throws exception with detailed error logging
+     *
+     * All policies first attempt to look up an existing model instance. If found and the type
+     * matches, the existing instance is returned. Only if lookup fails does the policy apply:
+     *
+     * - CREATE (default): Attempts to create model instance after lookup fails
+     * - CONTINUE: Returns undefined after lookup fails, allows graceful degradation
+     * - FAIL: Throws exception with detailed logging after lookup fails
      */
     resolutionPolicy?: DependencyResolutionPolicy;
 }

package/core/types/kos-dependency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-dependency.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/kos-dependency.ts"],"names":[],"mappings":"AAAA,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,oBAAY,0BAA0B;IACpC;;;OAGG;IACH,MAAM,WAAW;IACjB;;;OAGG;IACH,QAAQ,aAAa;IACrB;;OAEG;IACH,IAAI,SAAS;CACd;AAED;;KAEK;AACL,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,OAAO;IACpD,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;CAC/C"}
+{"version":3,"file":"kos-dependency.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/kos-dependency.ts"],"names":[],"mappings":"AAAA,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED;;;;;;;GAOG;AACH,oBAAY,0BAA0B;IACpC;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;OAIG;IACH,QAAQ,aAAa;IACrB;;;OAGG;IACH,IAAI,SAAS;CACd;AAED;;KAEK;AACL,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,OAAO;IACpD,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;CAC/C"}

package/core/util/error-logger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Zone 3 utility for logging errors with structured context
+ */
+export interface ModelInstantiationErrorContext {
+    modelType: string;
+    options: any;
+    registryId: string;
+}
+/**
+ * Logs a model instantiation error with structured metadata.
+ *
+ * @param error - The error that occurred during instantiation
+ * @param context - Contextual information about the failed instantiation
+ */
+export declare function logModelInstantiationError(error: unknown, context: ModelInstantiationErrorContext): void;
+//# sourceMappingURL=error-logger.d.ts.map

package/core/util/error-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-logger.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/error-logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,8BAA8B,GACtC,IAAI,CASN"}

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

@@ -0,0 +1,41 @@
+import { IKosModel } from '../core/kosModel';
+
+/**
+ * Transition map type for lifecycle operations
+ */
+export type ModelPromiseResolver = (model: IKosModel) => Promise<void>;
+/**
+ * Transitions a model to the ACTIVE state
+ */
+export declare const transitionToActive: (model: IKosModel) => Promise<void>;
+/**
+ * Transitions a model to the READY state
+ */
+export declare const transitionToReady: (model: IKosModel) => Promise<void>;
+/**
+ * Transitions a model to the LOADED state
+ */
+export declare const transitionToLoad: (model: IKosModel) => Promise<void>;
+/**
+ * Transitions a model to the UNLOADED state
+ */
+export declare const transitionToUnload: (model: IKosModel) => Promise<void>;
+/**
+ * Transitions a model to the INITIALIZED state
+ */
+export declare const transitionToInit: (model: IKosModel) => Promise<void>;
+/**
+ * Enum defining available lifecycle transitions
+ */
+export declare enum Transitions {
+    ACTIVE = "active",
+    READY = "ready",
+    LOAD = "load",
+    UNLOAD = "unload",
+    INIT = "init"
+}
+/**
+ * Mapping of transition types to their corresponding transition functions
+ */
+export declare const TransitionMap: Record<Transitions, ModelPromiseResolver>;
+//# sourceMappingURL=model-transition-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-transition-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/model-transition-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAW,SAAS,KAAG,QAAQ,IAAI,CACM,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,iBAAiB,UAAW,SAAS,KAAG,QAAQ,IAAI,CAC9C,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAAW,SAAS,KAAG,QAAQ,IAAI,CACG,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAW,SAAS,KAAG,QAAQ,IAAI,CACK,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAAW,SAAS,KAAG,QAAQ,IAAI,CACc,CAAC;AAE/E;;GAEG;AACH,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,oBAAoB,CAMnE,CAAC"}

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

@@ -0,0 +1,26 @@
+import { IKosDataModel } from '../core/kosModel';
+import { IKosModelContainer } from '../core/kos-container-model';
+
+/**
+ * Type guard to check if a model has a toJSON method
+ */
+export declare const isPrintable: (model: any) => model is {
+    toJSON: () => object;
+};
+/**
+ * Type guard to check if an object is a KOS data model
+ */
+export declare const isKosDataModel: (model: any) => model is IKosDataModel;
+/**
+ * Type guard to check if a model is a KOS model container
+ */
+export declare const isKosModelContainer: (model: any) => model is IKosModelContainer<any>;
+/**
+ * Resolves a child attribute to its data model representation.
+ * Handles various collection types and extracts KOS data models.
+ *
+ * @param attribute - The attribute to resolve (can be a model, container, collection, or array)
+ * @returns The resolved data model(s) or undefined
+ */
+export declare const resolveChild: (attribute: any) => IKosDataModel | IKosDataModel[] | undefined;
+//# sourceMappingURL=model-type-guards.d.ts.map

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,11 @@
+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';
 
+export { Transitions, TransitionMap } from './model-transition-utils';
+export { isPrintable, isKosDataModel, isKosModelContainer, resolveChild, } from './model-type-guards';
+export { ModelError } from './promise-utils';
+export type { ModelPromiseResolver } from './model-transition-utils';
 export interface ModelPromise {
     promise?: Promise<void>;
     modelId?: string;
@@ -9,31 +13,15 @@ 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>;
-};
 export declare const createModelDependency: (model: IKosModel, dependency: KosDependencyParams<any>) => {
     dependentModel: null;
     dataModelId: string;
     success: boolean;
 } | {
-    dependentModel: import('../core/types/kos-model-manager-types').IKosCreateInstanceResponse<IKosDataModel>;
+    dependentModel: {
+        model: IKosModel<IKosDataModel>;
+        data: IKosDataModel;
+    };
     dataModelId: string;
     success: boolean;
 };
@@ -41,10 +29,4 @@ export declare const getDependenciesByLifecycle: (model: IKosModel, lifecycle?:
 export declare const executeListLifecycle: (sourceModel: IKosModel, models: (IKosModel | undefined)[], target: Transitions, sourceLifecycle: DependencyLifecycle) => Promise<void>;
 export declare const executeChildrenModelLifecycle: (model: IKosModel, target: Transitions, sourceLifecycle: DependencyLifecycle) => Promise<void>;
 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,EAEnB,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAIjC,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;;;;;;;;CA+HrC,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,kBAiHrC,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":"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"}

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"}