@kosdev-code/kos-ui-sdk 2.1.22 → 2.1.25

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