@kosdev-code/kos-ui-sdk 3.0.16 → 3.0.18

package/index.js

@@ -766,6 +766,17 @@ const defaultConfig = {
 };
 const config = globalThis.getKosConfig?.() || JSON.stringify(defaultConfig);
 const configObj = JSON.parse(config);
+const urlProfiles = () => {
+  if (typeof window === "undefined") {
+    return [];
+  }
+  const value = getQueryParams()?.["kosProfiles"];
+  return value ? value.split(",").map((profile) => profile.trim()).filter(Boolean) : [];
+};
+configObj.profiles = [
+  ...configObj.profiles ?? [],
+  ...urlProfiles().filter((profile) => !configObj.profiles?.includes(profile))
+];
 globalThis.kosConfig = configObj;
 const KosGlobalConfig = configObj;
 const resolveKosProfiles = () => KosGlobalConfig.profiles || [];
@@ -1208,6 +1219,25 @@ function kosContext(_target, _propertyKey, descriptor) {
     return originalMethod.apply(this, args);
   };
 }
+async function executeServiceRequest(host, $ctx, params2) {
+  const name = $ctx?.$name ?? "service request";
+  if (!$ctx?.$request) {
+    host.logger.error(
+      `${name}: missing execution context — executeServiceRequest is for method-driven requests; a @kosServiceRequest with a lifecycle receives (error, data) instead and needs no helper`
+    );
+    return void 0;
+  }
+  const [error, data] = await $ctx.$request(params2);
+  if (error) {
+    host.logger.error(`${name}: request failed`, error);
+    return void 0;
+  }
+  if (data == null) {
+    host.logger.error(`${name}: no data returned`);
+    return void 0;
+  }
+  return data;
+}
 const KOS_EXECUTION_CONTEXT = /* @__PURE__ */ Symbol("KosExecutionContext");
 function isKosExecutionContext(obj) {
   return obj && typeof obj === "object" && KOS_EXECUTION_CONTEXT in obj;
@@ -1582,11 +1612,13 @@ function kosServiceRequest$9(params2) {
         };
         if (isKosExecutionContext(lastArg)) {
           lastArg.$request = executor;
+          lastArg.$name = String(propertyKey);
           return originalHandler.apply(this, args);
         } else {
           const context = {
             [KOS_EXECUTION_CONTEXT]: true,
-            $request: executor
+            $request: executor,
+            $name: String(propertyKey)
           };
           return originalHandler.apply(this, [...args, context]);
         }
@@ -4169,6 +4201,33 @@ class KosDependencyManager {
       uses.filter((id) => id !== dependencyId)
     );
   }
+  /**
+   * Drops every edge into and out of a model. Called when the model is
+   * destroyed, so its dependencies are not left pinned by a model that is
+   * gone and can never release them.
+   */
+  removeAll(modelId) {
+    for (const dependencyId of this._usesCache.get(modelId) ?? []) {
+      const usedBy = this._usedByCache.get(dependencyId);
+      if (usedBy) {
+        this._usedByCache.set(
+          dependencyId,
+          usedBy.filter((id) => id !== modelId)
+        );
+      }
+    }
+    this._usesCache.delete(modelId);
+    for (const dependentId of this._usedByCache.get(modelId) ?? []) {
+      const uses = this._usesCache.get(dependentId);
+      if (uses) {
+        this._usesCache.set(
+          dependentId,
+          uses.filter((id) => id !== modelId)
+        );
+      }
+    }
+    this._usedByCache.delete(modelId);
+  }
   canDestroy(modelId) {
     const usedBy = this._usedByCache.get(modelId);
     if (usedBy?.length) {
@@ -4246,6 +4305,19 @@ class KosModelCache {
     return this._preloaded;
   }
 }
+const cache$1 = /* @__PURE__ */ new Map();
+const modelHookCache = {
+  has: (key) => cache$1.has(key),
+  get: (key) => cache$1.get(key),
+  set: (key, entry) => cache$1.set(key, entry),
+  delete: (key) => cache$1.delete(key),
+  clear: () => cache$1.clear()
+};
+const clearModelHookCacheEntry = (modelId) => {
+  if (modelId) {
+    cache$1.delete(modelId);
+  }
+};
 class KosModelError extends Error {
   context;
   originalCause;
@@ -8314,6 +8386,7 @@ class KosMockRecorder {
   pending = /* @__PURE__ */ new Map();
   exchanges = [];
   pushes = [];
+  sends = [];
   get isRecording() {
     return this.recording;
   }
@@ -8325,6 +8398,7 @@ class KosMockRecorder {
     this.pending.clear();
     this.exchanges = [];
     this.pushes = [];
+    this.sends = [];
     KosLog.info(
       `KosMock recorder started${options.name ? ` (${options.name})` : ""}`
     );
@@ -8333,7 +8407,7 @@ class KosMockRecorder {
     const fixture = this.toFixture();
     this.recording = false;
     KosLog.info(
-      `KosMock recorder stopped: ${fixture.exchanges.length} exchanges, ${fixture.pushes.length} pushes`
+      `KosMock recorder stopped: ${fixture.exchanges.length} exchanges, ${fixture.pushes.length} pushes, ${fixture.sends?.length ?? 0} sends`
     );
     return fixture;
   }
@@ -8343,7 +8417,8 @@ class KosMockRecorder {
       name: this.name,
       capturedAt: this.capturedAt,
       exchanges: [...this.exchanges],
-      pushes: [...this.pushes]
+      pushes: [...this.pushes],
+      sends: [...this.sends]
     };
   }
   download(filename) {
@@ -8372,6 +8447,7 @@ class KosMockRecorder {
     }
     const frame = decodeRequestFrame(data);
     if (!frame) {
+      this.noteSend(data);
       return;
     }
     this.pending.set(frame.requestId, {
@@ -8379,7 +8455,31 @@ class KosMockRecorder {
       method: frame.method,
       url: frame.url,
       tracker: frame.tracker,
-      requestBody: frame.rawBody
+      requestBody: frame.rawBody,
+      requestHeaders: frame.headers
+    });
+  }
+  /**
+   * Everything else a window sends: alias registration, broker subscribes,
+   * client-sent futures. What a window asked for is not recoverable from the
+   * responses it got back, so it is captured rather than discarded.
+   */
+  noteSend(data) {
+    if (typeof data !== "string") {
+      return;
+    }
+    let headers;
+    let body;
+    try {
+      ({ headers, body } = processKosMessage(data));
+    } catch {
+      return;
+    }
+    this.sends.push({
+      tMs: this.elapsed(),
+      type: headers["type"],
+      headers,
+      ...body ? { body } : {}
     });
   }
   /** Interceptor tap: every inbound frame (real, mocked, injected). Internal. */
@@ -8405,6 +8505,7 @@ class KosMockRecorder {
         ...request2,
         status: parseInt(headers["status"] ?? "200", 10) || 200,
         responseBody: body ?? "",
+        responseHeaders: headers,
         latencyMs: Math.max(0, this.elapsed() - request2.tMs),
         ...headers[KOS_MOCKED_HEADER] === "true" ? { mocked: true } : {}
       });
@@ -8416,7 +8517,8 @@ class KosMockRecorder {
         tMs: this.elapsed(),
         kind: "topic",
         topic,
-        body: body ?? ""
+        body: body ?? "",
+        headers
       });
       return;
     }
@@ -8430,7 +8532,8 @@ class KosMockRecorder {
         tMs: this.elapsed(),
         kind: "future",
         tracker,
-        body: body ?? ""
+        body: body ?? "",
+        headers
       });
     }
   }
@@ -9251,32 +9354,53 @@ const resolveSingleton = () => {
 };
 const kosMockRegistry = resolveSingleton();
 const KosMock = kosMockRegistry;
-if (typeof window !== "undefined" && window.location?.search) {
-  const params2 = getQueryParams();
-  if (params2["kosMock"] === "standalone") {
+const PROFILE_MOCK = "studio.mock";
+const PROFILE_MOCK_STANDALONE = "studio.mock.standalone";
+const PROFILE_MOCK_RECORD = "studio.mock.record";
+const PROFILE_MOCK_FIXTURE_SERVER = "studio.mock.fixtureServer";
+const PROFILE_MOCK_FIXTURE = "studio.mock.fixture";
+const PROFILE_MOCK_SETUP = "studio.mock.setup";
+const profileValue = (name) => {
+  const match = resolveKosProfiles().find(
+    (profile) => profile === name || profile.startsWith(`${name}=`)
+  );
+  return match === void 0 ? void 0 : match.slice(name.length + 1);
+};
+if (typeof window !== "undefined") {
+  const params2 = window.location?.search ? getQueryParams() : {};
+  const setting = (param, profile) => params2[param] !== void 0 ? params2[param] : profileValue(profile);
+  const mock = params2["kosMock"] !== void 0 ? params2["kosMock"] : hasKosProfile(PROFILE_MOCK_STANDALONE) ? "standalone" : hasKosProfile(PROFILE_MOCK) ? "on" : void 0;
+  const record = setting("kosRecord", PROFILE_MOCK_RECORD);
+  const fixtureServer = setting(
+    "kosFixtureServer",
+    PROFILE_MOCK_FIXTURE_SERVER
+  );
+  const fixture = setting("kosFixture", PROFILE_MOCK_FIXTURE);
+  const setups = setting("kosSetup", PROFILE_MOCK_SETUP);
+  if (mock === "standalone") {
     KosMock.configure({ standalone: true });
-  } else if (params2["kosMock"] === "on") {
+  } else if (mock === "on") {
     KosMock.enable();
   }
-  if (params2["kosRecord"] !== void 0) {
-    KosMock.recorder.start({ name: params2["kosRecord"] || void 0 });
+  if (record !== void 0) {
+    KosMock.recorder.start({ name: record || void 0 });
   }
-  if (params2["kosFixtureServer"] !== void 0) {
-    KosMock.fixtures.useServer(params2["kosFixtureServer"] || true);
+  if (fixtureServer !== void 0) {
+    KosMock.fixtures.useServer(fixtureServer || true);
   }
   const bootLoads = [];
-  if (params2["kosFixture"]) {
+  if (fixture) {
     bootLoads.push(
-      KosMock.fixtures.play(params2["kosFixture"]).then(() => void 0).catch(
+      KosMock.fixtures.play(fixture).then(() => void 0).catch(
         (error) => KosLog.error(
-          `KosMock: boot fixture "${params2["kosFixture"]}" failed to load`,
+          `KosMock: boot fixture "${fixture}" failed to load`,
           error?.message
         )
       )
     );
   }
-  if (params2["kosSetup"]) {
-    for (const name of params2["kosSetup"].split(",").filter(Boolean)) {
+  if (setups) {
+    for (const name of setups.split(",").filter(Boolean)) {
       bootLoads.push(
         KosMock.setups.load(name).then(() => void 0).catch(
           (error) => KosLog.error(
@@ -11700,6 +11824,8 @@ class KosModelManager {
     if (model?.modelId && this.dependencies.canDestroy(model.modelId)) {
       await model.unload?.();
       this.removeModel(model);
+      this.dependencies.removeAll(model.modelId);
+      clearModelHookCacheEntry(model.modelId);
     }
   }
   /**
@@ -26779,33 +26905,32 @@ const waitForRetry = (depth = 0) => new Promise((resolve) => {
     resolve(true);
   }, 2 ** depth * 10);
 });
-const cache$1 = /* @__PURE__ */ new Map();
-function fetchData$1(key, fetcher) {
-  if (cache$1.has(key)) {
-    const entry = cache$1.get(key);
+function readModelHookEntry(key, fetcher) {
+  const entry = modelHookCache.get(key);
+  if (entry) {
     if (entry.status === "finished") {
       const kosModel2 = KosCore.getInstance().modelManager.getModelById(key);
       return { kosModel: kosModel2, model: kosModel2?.modelData };
-    } else {
-      throw entry.promise;
     }
-  } else {
-    const promise = fetcher().then(
-      () => {
-        cache$1.set(key, { status: "finished", key });
-      },
-      (error) => {
-        cache$1.set(key, { status: "error", error });
-        throw error;
-      }
-    );
-    const entry = { status: "pending", promise };
-    cache$1.set(key, entry);
-    throw promise;
+    if (entry.status === "error") {
+      throw entry.error;
+    }
+    throw entry.promise;
   }
+  const promise = fetcher().then(
+    () => {
+      modelHookCache.set(key, { status: "finished", key });
+    },
+    (error) => {
+      modelHookCache.set(key, { status: "error", error });
+      throw error;
+    }
+  );
+  modelHookCache.set(key, { status: "pending", promise });
+  throw promise;
 }
 function useSuspenseData$1(key, fetcher) {
-  const data = fetchData$1(key, fetcher);
+  const data = readModelHookEntry(key, fetcher);
   return data;
 }
 async function fetchModel$1(kosCore, modelOptions) {
@@ -26893,7 +27018,7 @@ const useKosModel = (modelOptions) => {
             if (destroyOnUnmount) {
               const modelId2 = model.id;
               destroyKosModel(model).then(() => {
-                cache$1.delete(modelId2);
+                clearModelHookCacheEntry(modelId2);
                 disposer?.();
               });
             }
@@ -26902,7 +27027,7 @@ const useKosModel = (modelOptions) => {
       } else {
         if (destroyOnUnmount && model) {
           destroyKosModel(model).then(() => {
-            cache$1.delete(modelId);
+            clearModelHookCacheEntry(modelId);
             disposer?.();
           });
         }
@@ -29175,6 +29300,7 @@ export {
   checkAppsStarted,
   checkWildcardPattern,
   clearAllServiceResponses,
+  clearModelHookCacheEntry,
   clearPath,
   clearServiceResponse,
   convert,
@@ -29208,6 +29334,7 @@ export {
   executeChildrenModelLifecycle,
   executeDependentModelLifecycle,
   executeListLifecycle,
+  executeServiceRequest,
   fetchModel,
   findModel,
   findModels,
@@ -29332,6 +29459,7 @@ export {
   mapUpdateDtoToConfigBeanModel,
   modelEventTopicFactory,
   modelFactory,
+  modelHookCache,
   modelTypeEventTopicFactory,
   modifyConfigBean,
   modifyFuture,
@@ -29343,6 +29471,7 @@ export {
   processId,
   processMiddleware,
   put,
+  readModelHookEntry,
   registerCompanionModel,
   registerCoreModels,
   registerExtensionPoint,