@kosdev-code/kos-ui-sdk 0.1.0-next.810 → 0.1.0-next.812

package/core/core/kosCore.d.ts

@@ -8,6 +8,11 @@ declare global {
     }
 }
 export interface IKosCoreLifecycle {
+    /**
+     * Starts the lifecycle state machine. Idempotent; called by `create()` once
+     * the core has a model manager.
+     */
+    startLifecycle(): void;
     /**
      * lifecycle function to initialize the core and provide initial values that
      * will be used by the system.  For example, loading the logger, setting up
@@ -52,8 +57,10 @@ export declare class KosCore implements IKosCoreManager {
     isOnline: boolean;
     private _reloading;
     private _unloading;
+    private lifecycleStarted;
     connectionAlias?: string;
     private constructor();
+    startLifecycle(): void;
     get onlineStatus(): boolean;
     get reloading(): boolean;
     get unloading(): boolean;

package/core/core/kosCore.d.ts.map

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

package/core/core/lifecycle/kosCoreLifecycle.d.ts

@@ -12,7 +12,8 @@ export declare enum KosCoreState {
     OFFLINE = "offline",
     UNLOADING = "unloading",
     UNLOADED = "unloaded",
-    RELOADING = "reloading"
+    RELOADING = "reloading",
+    FAILED = "failed"
 }
 export declare enum KosCoreEvents {
     CREATE = "create",
@@ -60,6 +61,7 @@ export declare const coreFsm: (core: IKosCoreManager) => {
         loaded: import('robot3').MachineState;
         readying: import('robot3').MachineState;
         reloading: import('robot3').MachineState;
+        failed: import('robot3').MachineState;
         ready: import('robot3').MachineState;
         unloaded: import('robot3').MachineState;
     }, {}, import('robot3').AllStateKeys<{
@@ -71,6 +73,7 @@ export declare const coreFsm: (core: IKosCoreManager) => {
         loaded: unknown;
         readying: unknown;
         reloading: unknown;
+        failed: unknown;
         ready: unknown;
         unloaded: unknown;
     }>>>;

package/core/core/lifecycle/kosCoreLifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kosCoreLifecycle.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-ui-sdk/src/core/core/lifecycle/kosCoreLifecycle.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,UAAU,SAAS;IACnB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS,CAAC,OAAO;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AACD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,KAAK,CAAC;CACX;AACD,MAAM,WAAW,0BAA0B,CAAC,OAAO;IACjD,CAAC,CAAC,EAAE,MAAM,GAAG;QACX,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAC7C,EAAE,CAAC,EAAE,KAAK,CAAC;QACX,MAAM,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,GAAG;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,OAAO,GAAI,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiG5C,CAAC"}
+{"version":3,"file":"kosCoreLifecycle.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-ui-sdk/src/core/core/lifecycle/kosCoreLifecycle.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,UAAU,SAAS;IACnB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS,CAAC,OAAO;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AACD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,KAAK,CAAC;CACX;AACD,MAAM,WAAW,0BAA0B,CAAC,OAAO;IACjD,CAAC,CAAC,EAAE,MAAM,GAAG;QACX,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAC7C,EAAE,CAAC,EAAE,KAAK,CAAC;QACX,MAAM,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,GAAG;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;CAClB;AAoBD,eAAO,MAAM,OAAO,GAAI,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkH5C,CAAC"}

package/index.cjs

@@ -9913,6 +9913,7 @@ var KosCoreState = /* @__PURE__ */ ((KosCoreState2) => {
   KosCoreState2["UNLOADING"] = `unloading`;
   KosCoreState2["UNLOADED"] = `unloaded`;
   KosCoreState2["RELOADING"] = `reloading`;
+  KosCoreState2["FAILED"] = `failed`;
   return KosCoreState2;
 })(KosCoreState || {});
 var KosCoreEvents = /* @__PURE__ */ ((KosCoreEvents2) => {
@@ -9925,6 +9926,15 @@ var KosCoreEvents = /* @__PURE__ */ ((KosCoreEvents2) => {
   KosCoreEvents2["RELOAD"] = `reload`;
   return KosCoreEvents2;
 })(KosCoreEvents || {});
+const reportFailure = async (step, run2) => {
+  try {
+    return await run2();
+  } catch (error) {
+    const detail = error instanceof Error ? error.stack ?? `${error.name}: ${error.message}` : String(error);
+    log$R.error(`KOS Core lifecycle step "${step}" failed. ${detail}`);
+    throw error;
+  }
+};
 const coreFsm = (core) => {
   const onlineMachine2 = robot3.createMachine("offline", {
     [
@@ -9962,6 +9972,15 @@ const coreFsm = (core) => {
     onlineMachine2,
     (_service) => log$R.debug(_service.machine.current)
   );
+  const failed = robot3.transition(
+    `error`,
+    "failed",
+    robot3.action(() => {
+      mobx.runInAction(() => {
+        core.status = "failed";
+      });
+    })
+  );
   const machine2 = robot3.createMachine({
     [
       "creating"
@@ -9984,12 +10003,13 @@ const coreFsm = (core) => {
       "initializing"
       /* INITIALIZING */
     ]: robot3.invoke(
-      () => core.init(),
+      () => reportFailure("initializing", () => core.init()),
       robot3.transition(
         `done`,
         "initialized"
         /* INITIALIZED */
-      )
+      ),
+      failed
     ),
     [
       "initialized"
@@ -10002,12 +10022,13 @@ const coreFsm = (core) => {
       "loading"
       /* LOADING */
     ]: robot3.invoke(
-      () => core.load(),
+      () => reportFailure("loading", () => core.load()),
       robot3.transition(
         `done`,
         "loaded"
         /* LOADED */
-      )
+      ),
+      failed
     ),
     [
       "loaded"
@@ -10027,7 +10048,7 @@ const coreFsm = (core) => {
       "readying"
       /* READYING */
     ]: robot3.invoke(
-      () => core.ready(),
+      () => reportFailure("readying", () => core.ready()),
       robot3.transition(
         `done`,
         "ready",
@@ -10036,19 +10057,25 @@ const coreFsm = (core) => {
             core.status = "ready";
           });
         })
-      )
+      ),
+      failed
     ),
     [
       "reloading"
       /* RELOADING */
     ]: robot3.invoke(
-      () => core.reload(),
+      () => reportFailure("reloading", () => core.reload()),
       robot3.transition(
         `done`,
         "loading"
         /* LOADING */
-      )
+      ),
+      failed
     ),
+    [
+      "failed"
+      /* FAILED */
+    ]: robot3.state(),
     [
       "ready"
       /* READY */
@@ -10186,6 +10213,7 @@ class KosCore {
   isOnline;
   _reloading;
   _unloading;
+  lifecycleStarted = false;
   connectionAlias;
   constructor(connectionAlias) {
     this.initialized = false;
@@ -10262,6 +10290,12 @@ class KosCore {
     }
     this._transport = ws.init();
     this.fsmService = coreFsm(this);
+  }
+  startLifecycle() {
+    if (this.lifecycleStarted) {
+      return;
+    }
+    this.lifecycleStarted = true;
     this.fsmService.service.send(KosCoreEvents.CREATE);
   }
   get onlineStatus() {
@@ -10351,6 +10385,12 @@ class KosCore {
   async ready() {
     log$w.debug("Readying KOS Core");
     await this._transport.whenReady();
+    log$w.debug("KOS Transport ready. Preloading models");
+    if (!this.modelManager) {
+      throw new Error(
+        "KOS Core reached ready() with no model manager. Its lifecycle was started without a registry."
+      );
+    }
     const promises = this.modelManager.preloadedModels.map((model) => {
       return {
         modelId: model.modelId,
@@ -10358,6 +10398,7 @@ class KosCore {
         promise: model.whenReady()
       };
     });
+    log$w.debug(`Preloaded ${promises.length} models`);
     const settled = await Promise.allSettled(
       promises.map((promise) => {
         const { promise: timeoutPromise, cancel: timeoutCancel } = rejectAfterDelay(5e3, promise.model);
@@ -10476,6 +10517,7 @@ class KosCore {
     });
     const modelManager = KosModelManager.create(registry, reset2);
     instance.modelManager = modelManager;
+    instance.startLifecycle();
     return instance;
   }
   static getInstance(data) {