@kosdev-code/kos-ui-sdk 3.0.21 → 3.0.23

package/{index-BUwbSjst.js → index-YzHb2lnB.js}

@@ -1,4 +1,4 @@
-import { makeAutoObservable, observable, makeObservable, action, createAtom, autorun, runInAction, observe, isComputedProp, reaction, when, ObservableMap, computed, isObservable } from "mobx";
+import { makeAutoObservable, observable, makeObservable, action, createAtom, autorun, runInAction, observe, isComputedProp, reaction, ObservableMap, when, computed, isObservable } from "mobx";
 import log$q from "loglevel";
 import { createMachine, invoke, transition, action as action$1, state, interpret, immediate } from "robot3";
 const HEADER_METHOD = `method`;
@@ -2491,7 +2491,7 @@ var KosModelEvents = /* @__PURE__ */ ((KosModelEvents2) => {
   KosModelEvents2["READY"] = `ready`;
   KosModelEvents2["GO_ONLINE"] = `go_online`;
   KosModelEvents2["GO_OFFLINE"] = `go_offline`;
-  KosModelEvents2["RESET"] = `go_offline`;
+  KosModelEvents2["RESET"] = `reset`;
   KosModelEvents2["UNLOAD"] = `unload`;
   KosModelEvents2["FAILED"] = "failed";
   KosModelEvents2["GO_ACTIVE"] = "go_active";
@@ -2516,6 +2516,9 @@ const destroyKosModel = async (model) => {
   await KosCore.getInstance().modelManager.initiateDestroyModel(model);
 };
 const unloadKosModel = async (dataModel) => {
+  KosLog.warn(
+    `unloadKosModel(${dataModel?.id}) is deprecated and never resolves. Use destroyKosModel() to release a model, or reload() to refresh it.`
+  );
   await KosCore.getInstance().whenReady();
   if (!dataModel.id) {
     throw new Error("Model ID is required");
@@ -2526,6 +2529,9 @@ const unloadKosModel = async (dataModel) => {
   }
 };
 const resetKosModel = async (model) => {
+  KosLog.warn(
+    `resetKosModel(${model?.id}) is deprecated: the reset route drops every topic handler registered at INIT or with no lifecycle. Implement reload() on the model and refetch and reconcile in place.`
+  );
   await KosCore.getInstance().whenReady();
   await KosCore.getInstance().modelManager.reloadModel(model);
   KosLog.debug(
@@ -3692,6 +3698,21 @@ function setupReplayHandler(topic, bufferSize) {
     replay(t, bufferSize);
   });
 }
+const isPrintable = (model) => typeof model.toJSON === "function";
+const isKosDataModel = (model) => model[DependencyModels] !== void 0;
+const isKosModelContainer = (model) => model.revision !== void 0 && model.index !== void 0;
+const resolveChild = (attribute) => {
+  if (!attribute) return void 0;
+  if (isKosDataModel(attribute)) return attribute;
+  if (isKosModelContainer(attribute)) return attribute.data;
+  if (attribute instanceof Map || attribute instanceof ObservableMap || attribute instanceof Set) {
+    return Array.from(attribute.values()).filter(isKosDataModel);
+  }
+  if (Array.isArray(attribute)) {
+    return attribute.filter(isKosDataModel);
+  }
+  return void 0;
+};
 const deletionMap = /* @__PURE__ */ new Map();
 const KosDeletionManager = {
   addToDeletionQueue: (modelId, timeout) => {
@@ -4182,21 +4203,6 @@ const rejectAfterDelay$1 = (ms, model, status) => {
   };
   return { promise, cancel };
 };
-const isPrintable = (model) => typeof model.toJSON === "function";
-const isKosDataModel = (model) => model[DependencyModels] !== void 0;
-const isKosModelContainer = (model) => model.revision !== void 0 && model.index !== void 0;
-const resolveChild = (attribute) => {
-  if (!attribute) return void 0;
-  if (isKosDataModel(attribute)) return attribute;
-  if (isKosModelContainer(attribute)) return attribute.data;
-  if (attribute instanceof Map || attribute instanceof ObservableMap || attribute instanceof Set) {
-    return Array.from(attribute.values()).filter(isKosDataModel);
-  }
-  if (Array.isArray(attribute)) {
-    return attribute.filter(isKosDataModel);
-  }
-  return void 0;
-};
 const createModelDependency = (model, dependency) => {
   const _dataModelId = dependency.id || dependency.modelType;
   const dataModelId = resolveParameters({
@@ -9803,6 +9809,8 @@ class KosSubscriptionManager {
       const config2 = subscriptions2[topic];
       const topicLifecycle = config2.lifecycle;
       if (lifecycle && lifecycle !== topicLifecycle) return;
+      if (!lifecycle && topicLifecycle === DependencyLifecycle.ACTIVATE && this.model.activeStatus !== KosModelState.ACTIVE)
+        return;
       const resolvedTopic = this.resolvePropKey(topic);
       if (this.onceTopics.has(resolvedTopic)) {
         this.log.debug(`Skipping once topic (already fired): ${resolvedTopic}`);
@@ -9875,7 +9883,7 @@ class KosSubscriptionManager {
     this.registeredTopics.clear();
   }
   subscribe(subscription, topic, handler, activatable) {
-    const destinationAddress = subscription.destinationAddress ? this.resolvePropKey(subscription.destinationAddress) : null;
+    const { destinationAddress, explicitDestination } = this.resolveDestination(subscription);
     if (subscription.websocket) {
       this.log.debug(`Subscribing to WebSocket topic: ${topic}`);
       const socketSub = WebSocketTransport.getInstance().subscribeTopic({
@@ -9884,7 +9892,7 @@ class KosSubscriptionManager {
         fos: subscription.fos,
         bridge: subscription.bridge,
         destinationAddress,
-        explicitDestination: subscription.explicitDestination
+        explicitDestination
       });
       if (activatable) {
         this.activatableDisposers.push(socketSub);
@@ -9984,6 +9992,27 @@ class KosSubscriptionManager {
       );
     }
   }
+  // A destination template whose model property is unset names no destination:
+  // it resolves to null and is not treated as explicit, so the transport keeps
+  // its connId fallback for that model.
+  resolveDestination(subscription) {
+    const template = subscription.destinationAddress;
+    const explicitDestination = subscription.explicitDestination ?? false;
+    if (!template) {
+      return { destinationAddress: null, explicitDestination };
+    }
+    const match = template.match(/{PROP_(.+?)}/);
+    if (match) {
+      const value = this.modelData?.[match[1]];
+      if (value === null || value === void 0) {
+        return { destinationAddress: null, explicitDestination: false };
+      }
+    }
+    return {
+      destinationAddress: this.resolvePropKey(template),
+      explicitDestination
+    };
+  }
   resolvePropKey(template) {
     const propRegex = /.*({PROP_(.+)})/;
     let topic = template.includes("{MODEL_ID}") ? template.replace("{MODEL_ID}", this.modelId) : template;
@@ -10023,7 +10052,7 @@ class KosSubscriptionManager {
     try {
       let eventSource;
       if (config2.websocket) {
-        const destinationAddress = config2.destinationAddress ? this.resolvePropKey(config2.destinationAddress) : null;
+        const { destinationAddress, explicitDestination } = this.resolveDestination(config2);
         WebSocketTransport.getInstance().subscribeTopic({
           topic: resolvedTopic,
           callback: () => {
@@ -10032,7 +10061,7 @@ class KosSubscriptionManager {
           fos: config2.fos,
           bridge: config2.bridge,
           destinationAddress,
-          explicitDestination: config2.explicitDestination
+          explicitDestination
         });
         eventSource = iterate(resolvedTopic);
       } else {
@@ -10905,6 +10934,20 @@ class KosModel {
     );
     this.subscriptionManager?.registerAll(lifecycle);
   }
+  /**
+   * The counterpart of `unload()` for a reload that keeps the instance: every
+   * manager `unload()` disposed comes back, not only the subscriptions.
+   * @internal
+   */
+  restoreAfterReload() {
+    this.onlineLifecycleManager?.register();
+    this.subscriptionManager?.registerAll();
+    this.httpRouteManager?.registerAll();
+    this.effectManager?.setup();
+    kosAction(() => {
+      this.loaded = true;
+    });
+  }
   /**
    * Initialize the state machine for a specific lifecycle phase.
    * Called from lifecycle hooks (init, load, ready, activate).
@@ -11305,6 +11348,10 @@ class KosModelManager {
    * by its ID, it transitions the model to the RESETTING state using the
    * RESET event.
    *
+   * @deprecated The reset route re-runs load() and ready() only and loses the
+   * handlers registered at INIT or with no lifecycle. Models refresh through
+   * `reload()`, driven by KOS Core.
+   *
    * @param model - The data model to be reloaded. Must implement the `IKosDataModel` interface.
    *                The `id` property of the model is used to locate the corresponding model.
    *
@@ -11355,17 +11402,51 @@ class KosModelManager {
    * the following actions:
    * 1. Calls the `unload` method on the model, if it exists.
    * 2. Removes the model from the manager using the `removeModel` method.
+   * 3. Releases the model's children (decorated children, container members,
+   *    companions) from the manager the same way, recursively.
    *
    * @throws This method does not explicitly throw errors, but any errors occurring
    * during the `unload` or `removeModel` operations will propagate to the caller.
    */
   async destroyModel(model) {
     if (model?.modelId && this.dependencies.canDestroy(model.modelId)) {
+      const children = model.getChildren();
       await model.unload?.();
       this.removeModel(model);
       this.dependencies.removeAll(model.modelId);
       clearModelHookCacheEntry(model.modelId);
-    }
+      this.emptyContainersOf(model);
+      children.forEach((child) => this.releaseUnloadedChild(child));
+    }
+  }
+  // Each container held as a child is emptied with one bulk removal, so its
+  // indexes are recalculated once and its per-member observers are released.
+  emptyContainersOf(model) {
+    const data = model.modelData;
+    const childKeys = Object.keys(data?.[ChildModels] || {});
+    for (const key of childKeys) {
+      const container = data[key];
+      if (!isKosModelContainer(container)) continue;
+      const ids = container.data.map((member) => member.id);
+      if (ids.length) container.removeAll(ids);
+    }
+  }
+  // A destroyed model's unload() has already unloaded its children; only the
+  // registry half of destruction is left for them. Never walks dependencies:
+  // a child something else depends on stays registered, and a child already
+  // removed or queued for deletion is left to that path.
+  releaseUnloadedChild(child) {
+    const { modelId } = child;
+    if (!this.getModelById(modelId)) return;
+    if (!this.dependencies.canDestroy(modelId)) return;
+    const grandchildren = child.getChildren();
+    this.removeModel(child);
+    this.dependencies.removeAll(modelId);
+    clearModelHookCacheEntry(modelId);
+    this.emptyContainersOf(child);
+    grandchildren.forEach(
+      (grandchild) => this.releaseUnloadedChild(grandchild)
+    );
   }
   /**
    * Creates an instance of a model based on the specified type ID and optional model ID.
@@ -11752,30 +11833,13 @@ class KosCore {
         this.transport.token = data.body;
       }
     });
-    subscribe(WebSocketEvents.DISCONNECTED, async () => {
-      await Promise.allSettled(
-        this.modelManager.models.map(async (model) => {
-          try {
-            await model.offline?.();
-          } catch (e) {
-            log$5.error(`model ${model.modelId} offline() threw:`, e);
-          }
-          model.onlineLifecycleManager?.dispose();
-        })
-      );
+    subscribe(WebSocketEvents.DISCONNECTED, () => {
       this.fsmService.service.send(KosCoreEvents.GO_OFFLINE);
     });
     subscribe(WebSocketEvents.CONNECTED, async () => {
       await this.whenReady();
-      await Promise.allSettled(
-        this.modelManager.models.map(async (model) => {
-          model.onlineLifecycleManager?.register();
-          try {
-            await model.online?.();
-          } catch (e) {
-            log$5.error(`model ${model.modelId} online() threw:`, e);
-          }
-        })
+      this.modelManager.models.forEach(
+        (model) => model.onlineLifecycleManager?.register()
       );
       this.fsmService.service.send(KosCoreEvents.GO_ONLINE);
     });
@@ -11846,9 +11910,7 @@ class KosCore {
           continue;
         }
         log$5.info(`reloading model ${model.modelId}`);
-        model.unload?.();
-        await model.modelData.reload();
-        model.registerSubscribers?.();
+        await this.reloadModel(model, model.modelData);
         log$5.info(`reloading model ${model.modelId} complete`);
       }
     }
@@ -11859,9 +11921,7 @@ class KosCore {
           continue;
         }
         log$5.warn(`reloading model ${model.modelId}`);
-        model.unload?.();
-        await model.modelData.reload();
-        model.registerSubscribers?.();
+        await this.reloadModel(model, model.modelData);
       }
     }
     const elapsed = Date.now() - currentTime;
@@ -11872,6 +11932,13 @@ class KosCore {
       });
     }, 1e3 - elapsed);
   }
+  // unload() must finish before reload() starts, and whatever it disposed must
+  // come back afterwards; the data model's reload() only refreshes data.
+  async reloadModel(model, data) {
+    await model.unload?.();
+    await data.reload();
+    model.restoreAfterReload?.();
+  }
   async online() {
     log$5.debug("KOS Core going online");
     await this._transport.whenReady();
@@ -13537,4 +13604,4 @@ export {
   ObservableData as y,
   kosAction as z
 };
-//# sourceMappingURL=index-BUwbSjst.js.map
+//# sourceMappingURL=index-YzHb2lnB.js.map