@kosdev-code/kos-ui-sdk 0.1.0-next.807 → 0.1.0-next.809

package/core/core/transport/webSocketTransport.d.ts

@@ -13,6 +13,23 @@ export interface IKosConnectionStatus {
     status: string;
     message?: string;
 }
+/**
+ * Options for {@link IKosServiceTransport.whenReady}.
+ *
+ * @kosService core.transport
+ * @kosApiLevel 23
+ */
+export interface KosTransportReadyOptions {
+    /**
+     * Cancels the readiness wait when it aborts. Without one the wait is
+     * indefinite, which is correct for startup/lifecycle code but not for a
+     * request working against a deadline.
+     *
+     * When the signal aborts, `whenReady` rejects with the signal's reason and
+     * disposes the underlying reactive waiter.
+     */
+    signal?: AbortSignal;
+}
 export interface KosSubscriptionParams {
     topic: string;
     callback: EventCallback;
@@ -32,7 +49,7 @@ export interface IKosServiceTransport {
     socket?: MessageTransport;
     init(): IKosServiceTransport;
     subscribeTopic(params: KosSubscriptionParams): VoidFunction;
-    whenReady(): Promise<IKosConnectionStatus>;
+    whenReady(options?: KosTransportReadyOptions): Promise<IKosConnectionStatus>;
     fosSocket?: MessageTransport;
 }
 export type KosCallback = (msg: IKosMessage) => void;
@@ -78,7 +95,18 @@ export declare class WebSocketTransport implements IKosServiceTransport {
     private calculateBackoffDelay;
     private _sendSubscriptionMessage;
     subscribeTopic({ topic, callback, fos, bridge, destinationAddress, explicitDestination, }: KosSubscriptionParams): () => void;
-    whenReady(): Promise<{
+    /**
+     * Resolves once the transport can carry requests: the socket (and the FOS
+     * socket, when used) is connected and the connection is authorized.
+     *
+     * Pass `options.signal` to bound the wait. `connectionEstablished` flips back
+     * to `false` on socket close, so an unbounded wait parks indefinitely while
+     * the transport is down — callers with a deadline must supply a signal.
+     *
+     * @param options - See {@link KosTransportReadyOptions}.
+     * @throws The signal's abort reason if it aborts before the transport is ready.
+     */
+    whenReady(options?: KosTransportReadyOptions): Promise<{
         status: string;
     }>;
     get token(): string;

package/core/core/transport/webSocketTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webSocketTransport.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-ui-sdk/src/core/core/transport/webSocketTransport.ts"],"names":[],"mappings":"AASA,OAAO,EAAY,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI1D,OAAO,EAAE,gBAAgB,EAAmB,MAAM,0BAA0B,CAAC;AAY7E,oBAAY,oBAAoB;IAC9B,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AACD,MAAM,WAAW,WAAW;IAC1B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AACD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,OAAO,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,IAAI,IAAI,oBAAoB,CAAC;IAC7B,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,YAAY,CAAC;IAC5D,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,UAAU,wBAAwB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,MAAM,CAAC,SAAS,CAAuB;IAE/C,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,MAAM,CAAC,CAAS;IAExB,OAAO,CAAC,kBAAkB,CAA0B;IAEpD,UAAU,EAAE,OAAO,CAAC;IAEpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,eAAe,EAAE,OAAO,CAAC;IAGzB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAM;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAQ;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAEjC,EACV,IAAkB,EAClB,IAAW,EACX,QAAkB,EAClB,KAAK,EACL,UAAU,EACV,KAAK,EACL,GAAG,GACJ,EAAE,wBAAwB;IA+C3B,IAAI,qBAAqB,YAsBxB;IAED,IAAI;IA+BJ;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,wBAAwB;IAyChC,cAAc,CAAC,EACb,KAAK,EACL,QAAQ,EACR,GAAG,EACH,MAAM,EACN,kBAAkB,EAClB,mBAAmB,GACpB,EAAE,qBAAqB;IA4BlB,SAAS;;;IAmBf,IAAI,KAAK,IAGQ,MAAM,CADtB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAGtB;WACa,IAAI,CAAC,IAAI,SAAc;WAKvB,IAAI,CAAC,IAAI,SAAO;WAKhB,KAAK,CAAC,KAAK,EAAE,MAAM;WAInB,WAAW,CAAC,IAAI,SAAO,EAAE,KAAK,CAAC,EAAE,MAAM;CAStD"}
+{"version":3,"file":"webSocketTransport.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-ui-sdk/src/core/core/transport/webSocketTransport.ts"],"names":[],"mappings":"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"}

package/core/types/utils/kos-fetch.d.ts

@@ -141,6 +141,23 @@ export interface KosFetchOptions {
      * @internal
      */
     bridge?: boolean;
+    /**
+     * Timeout budget for the **entire call**, in milliseconds: waiting for the
+     * transport to become ready plus the request itself.
+     *
+     * A request issued while the socket is down or reconnecting settles within
+     * this budget — it rejects with a `TransportNotReadyError` if the transport
+     * never becomes ready — rather than queuing indefinitely. If the transport
+     * becomes ready with budget remaining, the remainder applies to the request,
+     * which then rejects with a `TimeoutError` `DOMException`. The two errors are
+     * distinct so callers can tell "service is slow" from "transport is down".
+     *
+     * Defaults to the `KOS_WS_TIMEOUT` environment value, or 30000.
+     *
+     * Pass `0` or `Infinity` to opt out of the budget entirely and queue until
+     * the transport recovers — a request that does this can never settle while
+     * the socket is down.
+     */
     timeout?: number;
     /**
      * @kosApiLevel 5

package/core/types/utils/kos-fetch.d.ts.map

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

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

@@ -0,0 +1,21 @@
+/**
+ * Waits for a MobX predicate to become `true`, but gives up as soon as the
+ * supplied signal aborts.
+ *
+ * MobX's `when()` waits forever by design. That is the right default for
+ * lifecycle code, but a caller working against a deadline needs the wait to be
+ * cancellable — and, more importantly, needs the underlying reaction disposed
+ * when it gives up. Without disposal, every abandoned waiter leaves a live
+ * reaction observing the predicate for the lifetime of the process.
+ *
+ * @param predicate - The reactive condition to wait for.
+ * @param signal - Optional signal that cancels the wait. When omitted the wait
+ *   is indefinite, matching plain `when()`.
+ * @returns A promise that resolves once the predicate holds.
+ * @throws The signal's abort reason (a `TimeoutError` or `AbortError`
+ *   `DOMException` for signals created by the SDK) if it aborts first.
+ *
+ * @internal
+ */
+export declare const abortableWhen: (predicate: () => boolean, signal?: AbortSignal) => Promise<void>;
+//# sourceMappingURL=abortable-when.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abortable-when.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/core/util/abortable-when.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa,GACxB,WAAW,MAAM,OAAO,EACxB,SAAS,WAAW,KACnB,OAAO,CAAC,IAAI,CAqCd,CAAC"}

package/core/util/index.d.ts

@@ -30,6 +30,7 @@ export * from './service-factory';
 export * from './service-request-error';
 export * from './service-response';
 export * from './session-utils';
+export * from './transport-not-ready-error';
 export * from './wait-for-request';
 export * from './when-ready';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/core/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/core/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/core/util/kos-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/core/util/kos-fetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAmBrE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB;AAkTD;;;;;GAKG;AACH,QAAA,IAAI,QAAQ,QAAS,CAAC;AACtB;;;;;GAKG;AACH,QAAA,IAAI,QAAQ,QA/NL,MAAM,YACD,eAAe,KACxB,OAAO,CAAC,QAAQ,CA6NM,CAAC;AAS1B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/core/util/kos-fetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAoBrE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB;AA4XD;;;;;GAKG;AACH,QAAA,IAAI,QAAQ,QAAS,CAAC;AACtB;;;;;GAKG;AACH,QAAA,IAAI,QAAQ,QA9OL,MAAM,YACD,eAAe,KACxB,OAAO,CAAC,QAAQ,CA4OM,CAAC;AAS1B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}

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

@@ -1,4 +1,5 @@
 import { IKosDataModel, IKosModel } from '../core/kosModel';
+import { KosModelState } from '../core/lifecycle';
 /**
  * Asynchronously destroys a KOS data model.
  *
@@ -143,4 +144,46 @@ export declare const isKosModel: <T extends IKosDataModel>(type: string) => (mod
  * @kosApiLevel 2
  */
 export declare const isKosModelReady: (model: IKosDataModel) => boolean;
+/**
+ * An observable, read-only view of a model's activation lifecycle.
+ *
+ * Models that fetch lazily do so in `activate()`, so activation state — not
+ * `loaded`, which tracks the `load()` lifecycle — is what tells a consumer
+ * whether that fetch has settled and whether it succeeded. Exposing just this
+ * lets a view react to activation without taking a dependency on the whole
+ * {@link IKosModel}.
+ */
+export interface KosModelActivationState {
+    /** The model's current activation state. */
+    readonly activeStatus: KosModelState;
+    /** Activation is in flight — nothing conclusive to render yet. */
+    readonly isActivating: boolean;
+    /** Activation completed; the model's activate() work is done. */
+    readonly isActive: boolean;
+    /** Activation threw — the model's data is absent, not empty. */
+    readonly isFailed: boolean;
+}
+/**
+ * Retrieves an observable view of a model's activation state.
+ *
+ * Every member is a getter, so reads happen at access time and stay tracked —
+ * call this once and read its properties inside a `kosComponent` (or any MobX
+ * reaction) to re-render as the model activates, succeeds, or fails.
+ *
+ * @param model - The KOS data model to observe.
+ * @returns The activation view, or `undefined` when the model has no wrapper
+ *          yet (not created, or already destroyed).
+ *
+ * @example Distinguishing "still loading" from "empty" from "failed"
+ * ```tsx
+ * const activation = getKosModelActivationState(container);
+ * if (!activation || activation.isActivating) return <Blank />;
+ * if (activation.isFailed) return <LoadError />;
+ * return <Versions items={container.items} />;
+ * ```
+ *
+ * @kosService core.utils
+ * @kosApiLevel 15
+ */
+export declare const getKosModelActivationState: (model: IKosDataModel | undefined) => KosModelActivationState | undefined;
 //# sourceMappingURL=kos-model-utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"kos-model-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/core/util/kos-model-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKjE;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAU,OAAO,aAAa,kBAGzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,WAAW,aAAa,kBAS5D,CAAC;AACF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAU,OAAO,aAAa,kBAevD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,MAAM,gCAQpD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAU,CAAC,SAAS,aAAa,GAAG,aAAa,EACvE,SAAS,MAAM;WAQqB,CAAC;;EACtC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,aAAa,GAAG,aAAa,EACrE,SAAS,MAAM;WAOqB,CAAC;;CACtC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,aAAa,EAChD,WAAW,MAAM,EACjB,WAAW;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,KASZ,CAAC,EACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,aAAa,EAC/C,WAAW,MAAM,EACjB,WAAW;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,MACU,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,EAC1D,OAAO,aAAa,EACpB,MAAM,MAAM,KAWwB,CACrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,aAAa,oBAc5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,mEAYtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,aAAa,EACzD,SAAS,MAAM,EACf,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,KAC9B,SAAS,GAAG,SAWd,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACpB,CAAC,SAAS,aAAa,EAAE,MAAM,MAAM,MACrC,OAAO,GAAG,KAAG,KAAK,IAAI,CAC4B,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,aAAa,YAMnD,CAAC"}
+{"version":3,"file":"kos-model-utils.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/core/util/kos-model-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAkB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIlE;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAU,OAAO,aAAa,kBAGzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,WAAW,aAAa,kBAS5D,CAAC;AACF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAU,OAAO,aAAa,kBAevD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,MAAM,gCAQpD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAU,CAAC,SAAS,aAAa,GAAG,aAAa,EACvE,SAAS,MAAM;WAQqB,CAAC;;EACtC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,aAAa,GAAG,aAAa,EACrE,SAAS,MAAM;WAOqB,CAAC;;CACtC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,aAAa,EAChD,WAAW,MAAM,EACjB,WAAW;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,KASZ,CAAC,EACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,aAAa,EAC/C,WAAW,MAAM,EACjB,WAAW;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,MACU,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,EAC1D,OAAO,aAAa,EACpB,MAAM,MAAM,KAWwB,CACrC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,aAAa,oBAc5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,mEAYtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,aAAa,EACzD,SAAS,MAAM,EACf,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,KAC9B,SAAS,GAAG,SAWd,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACpB,CAAC,SAAS,aAAa,EAAE,MAAM,MAAM,MACrC,OAAO,GAAG,KAAG,KAAK,IAAI,CAC4B,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,aAAa,YAMnD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,0BAA0B,GACrC,OAAO,aAAa,GAAG,SAAS,KAC/B,uBAAuB,GAAG,SAuB5B,CAAC"}

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

@@ -13,6 +13,16 @@ export declare const resolveBaseUrl: () => {
     isMock: boolean;
     URL: string;
 };
+/**
+ * Error string returned when the transport never became ready inside the
+ * request's timeout budget, so the request was never sent. Distinct from
+ * `"Request timed out"`, which means the request was sent and the service was
+ * slow.
+ *
+ * @kosService core.service-request
+ * @kosApiLevel 23
+ */
+export declare const ERROR_TRANSPORT_NOT_READY = "Transport not ready";
 type NonNeverKeys<T> = {
     [K in keyof T]-?: T[K] extends never | undefined ? never : K;
 }[keyof T];

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

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

package/core/util/transport-not-ready-error.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Discriminator carried by every {@link TransportNotReadyError}.
+ *
+ * Prefer checking `error.code === TRANSPORT_NOT_READY` over `instanceof` when
+ * the error may have crossed a bundle boundary (an app and the SDK can end up
+ * with separate copies of the class).
+ *
+ * @category Service Request
+ * @kosService core.fetch
+ * @kosApiLevel 23
+ */
+export declare const TRANSPORT_NOT_READY = "TRANSPORT_NOT_READY";
+/**
+ * Raised when a request's timeout budget expires while waiting for the KOS
+ * transport to become ready — the socket is closed, reconnecting, or not yet
+ * authorized — so the request was never sent.
+ *
+ * This is deliberately distinct from the `TimeoutError` `DOMException` raised
+ * when the request itself times out. The two call for different reactions:
+ *
+ * - `TimeoutError` — the request reached the service and the service was slow.
+ *   Retrying later is usually reasonable.
+ * - `TransportNotReadyError` — connectivity is down. Retrying the same request
+ *   will fail the same way until the socket comes back; surface a connectivity
+ *   state to the user or trigger a reconnect/reload instead.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await api.get("/api/device/status", { timeout: 3000 });
+ * } catch (error) {
+ *   if (isTransportNotReadyError(error)) {
+ *     // websocket is down — show the offline UI
+ *   }
+ * }
+ * ```
+ *
+ * @category Service Request
+ * @kosService core.fetch
+ * @kosApiLevel 23
+ */
+export declare class TransportNotReadyError extends Error {
+    /** Stable discriminator; see {@link TRANSPORT_NOT_READY}. */
+    readonly code = "TRANSPORT_NOT_READY";
+    /**
+     * The budget, in milliseconds, that expired while waiting. `undefined` when
+     * the wait was cut short by a caller-supplied timeout signal rather than by
+     * the request's own budget.
+     */
+    readonly timeout?: number;
+    /** The URL of the request that was never sent. */
+    readonly url?: string;
+    constructor(details?: {
+        timeout?: number;
+        url?: string;
+    });
+}
+/**
+ * Type guard for {@link TransportNotReadyError} that works across bundle
+ * boundaries by checking the `code` discriminator rather than the prototype.
+ *
+ * @category Service Request
+ * @kosService core.fetch
+ * @kosApiLevel 23
+ */
+export declare const isTransportNotReadyError: (error: unknown) => error is TransportNotReadyError;
+//# sourceMappingURL=transport-not-ready-error.d.ts.map

package/core/util/transport-not-ready-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-not-ready-error.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/core/util/transport-not-ready-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,yBAAuB;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,kDAAkD;IAClD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;gBAEV,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO;CAU7D;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,KACb,KAAK,IAAI,sBAC+D,CAAC"}

package/index.cjs

@@ -2915,6 +2915,29 @@ const isKosModelReady = (model) => {
   }
   return kosModel2.isReady();
 };
+const getKosModelActivationState = (model) => {
+  if (!model?.id) {
+    return void 0;
+  }
+  const kosModel2 = KosCore.getInstance().modelManager.getModelById(model.id);
+  if (!kosModel2) {
+    return void 0;
+  }
+  return {
+    get activeStatus() {
+      return kosModel2.activeStatus;
+    },
+    get isActivating() {
+      return kosModel2.activeStatus === KosModelState.ACTIVATING;
+    },
+    get isActive() {
+      return kosModel2.activeStatus === KosModelState.ACTIVE;
+    },
+    get isFailed() {
+      return kosModel2.activeStatus === KosModelState.FAILED;
+    }
+  };
+};
 const log$L = KosLog.createLogger({ name: "kos-model-factory" });
 const KosModelFactory = {
   byModelType: (modelType) => KosCore.getInstance().modelManager.getModelFactory(
@@ -6339,8 +6362,38 @@ const getMessageBody = (payload, skipParse) => {
     return payload.body || payload;
   }
 };
+const TRANSPORT_NOT_READY = "TRANSPORT_NOT_READY";
+class TransportNotReadyError extends Error {
+  /** Stable discriminator; see {@link TRANSPORT_NOT_READY}. */
+  code = TRANSPORT_NOT_READY;
+  /**
+   * The budget, in milliseconds, that expired while waiting. `undefined` when
+   * the wait was cut short by a caller-supplied timeout signal rather than by
+   * the request's own budget.
+   */
+  timeout;
+  /** The URL of the request that was never sent. */
+  url;
+  constructor(details = {}) {
+    super(
+      `Transport not ready${details.timeout === void 0 ? "" : ` after ${details.timeout}ms`}${details.url ? ` - url: ${details.url}` : ""}`
+    );
+    this.name = "TransportNotReadyError";
+    this.timeout = details.timeout;
+    this.url = details.url;
+  }
+}
+const isTransportNotReadyError = (error) => !!error && error.code === TRANSPORT_NOT_READY;
 const log$D = KosLog.createLogger({ name: "kos-fetch" });
-const WS_TIMEOUT = process.env.KOS_WS_TIMEOUT ? parseInt(process.env.KOS_WS_TIMEOUT) : 3e4;
+const DEFAULT_WS_TIMEOUT = 3e4;
+const WS_TIMEOUT = (() => {
+  const configured = process.env.KOS_WS_TIMEOUT ? parseInt(process.env.KOS_WS_TIMEOUT) : DEFAULT_WS_TIMEOUT;
+  return Number.isNaN(configured) ? DEFAULT_WS_TIMEOUT : configured;
+})();
+const resolveTimeoutBudget = (timeout) => {
+  const budget = timeout ?? WS_TIMEOUT;
+  return Number.isFinite(budget) && budget > 0 ? budget : void 0;
+};
 const delay = () => new Promise((resolve) => {
   setTimeout(() => {
     resolve(true);
@@ -6374,6 +6427,14 @@ const combineSignals = (signals) => {
   }
   return controller.signal;
 };
+const createRequestSignal = (budget, callerSignal) => {
+  const timeoutSignal = budget ? createTimeoutSignal(budget) : void 0;
+  if (timeoutSignal && callerSignal) {
+    return combineSignals([callerSignal, timeoutSignal]);
+  }
+  return timeoutSignal ?? callerSignal ?? new AbortController().signal;
+};
+const isTimeoutReason = (reason) => reason?.name === "TimeoutError";
 const fetchMessageFactory = (options) => {
   if (options?.studio) {
     return createStudioMessage;
@@ -6385,15 +6446,25 @@ const fetchMessageFactory = (options) => {
 };
 const kosFetchWs = async (url, options) => {
   const transport = KosCore.getInstance().transport;
-  await transport.whenReady();
   const requestId = uuid();
   const urlObj = new URL(url);
   const path = `${urlObj.pathname}${urlObj.search}`;
   log$D.debug(`path: ${path}`);
-  const TIMEOUT = options?.timeout || WS_TIMEOUT;
+  const budget = resolveTimeoutBudget(options?.timeout);
   const messageFactory = fetchMessageFactory(options);
-  const timeoutSignal = createTimeoutSignal(TIMEOUT);
-  const signal = options?.signal ? combineSignals([options.signal, timeoutSignal]) : timeoutSignal;
+  const signal = createRequestSignal(budget, options?.signal);
+  try {
+    await transport.whenReady({ signal });
+  } catch (error) {
+    if (isTimeoutReason(error)) {
+      log$D.error(
+        `Transport not ready${budget === void 0 ? "" : ` after ${budget}ms`} - request not sent - url: ${url}`
+      );
+      throw new TransportNotReadyError({ timeout: budget, url });
+    }
+    log$D.debug(`Request aborted while waiting for transport - url: ${url}`);
+    throw error;
+  }
   const processedBody = await processRequestBody(options?.body);
   const additionalHeaders = {};
   if (processedBody.contentType) {
@@ -6556,6 +6627,7 @@ const resolveBaseUrl = () => {
 };
 const log$C = KosLog.createLogger({ name: "kos-service-request" });
 const ERROR_UNKNOWN = "errUnknown";
+const ERROR_TRANSPORT_NOT_READY = "Transport not ready";
 const MUTATING_METHODS = /* @__PURE__ */ new Set(["POST", "PUT", "DELETE", "PATCH"]);
 const RETRY_DEFAULTS = {
   maxAttempts: 3,
@@ -6605,6 +6677,10 @@ async function executeFetch(fullUrl, fetchOptions) {
     const payload = await response.json();
     return [null, payload.data ?? payload];
   } catch (error) {
+    if (isTransportNotReadyError(error)) {
+      log$C.error(`Transport not ready, request not sent: ${fullUrl}`);
+      return [ERROR_TRANSPORT_NOT_READY, null];
+    }
     if (error instanceof DOMException) {
       if (error.name === "TimeoutError") {
         log$C.error(`Request timed out: ${fullUrl}`);
@@ -6648,6 +6724,10 @@ async function executeFetchWithRetry(fullUrl, fetchOptions, config2) {
         await new Promise((resolve) => setTimeout(resolve, delayMs));
       }
     } catch (error) {
+      if (isTransportNotReadyError(error)) {
+        log$C.error(`Transport not ready, request not sent: ${fullUrl}`);
+        return [ERROR_TRANSPORT_NOT_READY, null];
+      }
       if (error instanceof DOMException) {
         if (error.name === "TimeoutError") {
           log$C.error(`Request timed out: ${fullUrl}`);
@@ -7459,6 +7539,38 @@ class FlowControlManager {
     return { ...this.stats };
   }
 }
+const abortReason = (signal) => signal.reason ?? new DOMException("Aborted", "AbortError");
+const abortableWhen = async (predicate, signal) => {
+  if (predicate()) {
+    return;
+  }
+  if (!signal) {
+    await mobx.when(predicate);
+    return;
+  }
+  if (signal.aborted) {
+    throw abortReason(signal);
+  }
+  const pending = mobx.when(predicate);
+  let onAbort;
+  try {
+    await Promise.race([
+      // `cancel()` below rejects this promise with MobX's WHEN_CANCELLED
+      // sentinel. That rejection *is* the cancellation, never a real failure,
+      // so it is swallowed here; the abort branch supplies the thrown reason.
+      pending.catch(() => void 0),
+      new Promise((_, reject) => {
+        onAbort = () => reject(abortReason(signal));
+        signal.addEventListener("abort", onAbort, { once: true });
+      })
+    ]);
+  } finally {
+    if (onAbort) {
+      signal.removeEventListener("abort", onAbort);
+    }
+    pending.cancel();
+  }
+};
 class WebSocketBridgeTransport extends WebSocket {
   constructor(address) {
     super(address);
@@ -8091,15 +8203,26 @@ ${dstAddr}topics:${topic}
       }
     };
   }
-  async whenReady() {
-    const that = this;
+  /**
+   * Resolves once the transport can carry requests: the socket (and the FOS
+   * socket, when used) is connected and the connection is authorized.
+   *
+   * Pass `options.signal` to bound the wait. `connectionEstablished` flips back
+   * to `false` on socket close, so an unbounded wait parks indefinitely while
+   * the transport is down — callers with a deadline must supply a signal.
+   *
+   * @param options - See {@link KosTransportReadyOptions}.
+   * @throws The signal's abort reason if it aborts before the transport is ready.
+   */
+  async whenReady(options) {
     if (!this.webSocketSupported) {
       return {
         status: `not supported`
       };
     }
-    await mobx.when(
-      () => !!that.socket?.connectionEstablished && (!that.useFosTransport || !!that.fosSocket?.connectionEstablished) && that.authorized
+    await abortableWhen(
+      () => !!this.socket?.connectionEstablished && (!this.useFosTransport || !!this.fosSocket?.connectionEstablished) && this.authorized,
+      options?.signal
     );
     return {
       status: `success`
@@ -26932,6 +27055,7 @@ exports.DependencyResolutionPolicy = DependencyResolutionPolicy;
 exports.Device = Device;
 exports.DeviceServices = index$6;
 exports.DomIntersectionStrategy = DomIntersectionStrategy;
+exports.ERROR_TRANSPORT_NOT_READY = ERROR_TRANSPORT_NOT_READY;
 exports.EVENT_KOS_MODEL_READY = EVENT_KOS_MODEL_READY;
 exports.EVENT_TROUBLE_ADDED = EVENT_TROUBLE_ADDED;
 exports.EVENT_TROUBLE_REMOVED = EVENT_TROUBLE_REMOVED;
@@ -27114,6 +27238,7 @@ exports.SubscriptionHandlers = SubscriptionHandlers;
 exports.TIMER_END = TIMER_END;
 exports.TIMER_EVENT = TIMER_EVENT;
 exports.TOPIC_TIMER_TICK_EVENT = TOPIC_TIMER_TICK_EVENT;
+exports.TRANSPORT_NOT_READY = TRANSPORT_NOT_READY;
 exports.TimerManager = TimerManager;
 exports.TokenContext = TokenContext;
 exports.TokenProvider = TokenProvider;
@@ -27126,6 +27251,7 @@ exports.TranslationContainer = TranslationContainer;
 exports.TranslationContainerContext = TranslationContainerContext;
 exports.TranslationContext = TranslationContext;
 exports.TransportFactory = TransportFactory;
+exports.TransportNotReadyError = TransportNotReadyError;
 exports.Trouble = Trouble;
 exports.TroubleAwareSetup = TroubleAwareSetup;
 exports.TroubleContainer = TroubleContainer;
@@ -27220,6 +27346,7 @@ exports.getKosConnectionId = getKosConnectionId;
 exports.getKosLocalizationDescriptor = getKosLocalizationDescriptor;
 exports.getKosMessageLogging = getKosMessageLogging;
 exports.getKosModel = getKosModel$1;
+exports.getKosModelActivationState = getKosModelActivationState;
 exports.getKosModelSync = getKosModelSync;
 exports.getKosModelType = getKosModelType;
 exports.getKosServiceApi = getKosServiceApi;
@@ -27262,6 +27389,7 @@ exports.isLeapYear = isLeapYear;
 exports.isLocalRefId = isLocalRefId;
 exports.isNumber = isNumber;
 exports.isPrintable = isPrintable;
+exports.isTransportNotReadyError = isTransportNotReadyError;
 exports.isTroubleAware = isTroubleAware;
 exports.isValidDate = isValidDate;
 exports.kosAction = kosAction;