@myop/sdk 0.3.33 → 0.3.36

package/dist/cjs/{_WebComponentSDK.a7e660ab.js → _WebComponentSDK.e84be6ea.js}

@@ -2139,7 +2139,7 @@ var WebcomponentLoader = class extends BaseMyopLoader {
 };
 
 // version:myop-sdk-version
-var myop_sdk_version_default = "0.3.33";
+var myop_sdk_version_default = "0.3.36";
 
 // src/host/embeddedSDK.ts
 var EMBEDDED_SDK_CONTENT = "";
@@ -2148,7 +2148,7 @@ var HAS_EMBEDDED_SDK = false;
 // src/host/loaders/HTMLComponentLoader.ts
 var MYOP_WEB_COMPONENT_MARKER = "<!-- myop-web-component -->";
 var MYOP_WEB_COMPONENT_SCRIPT_ID = "myop-web-component";
-var extractedWebComponentScripts = /* @__PURE__ */ new Set();
+var extractedWebComponentScripts = /* @__PURE__ */ new Map();
 var seen2 = [];
 var sdk;
 var getInitiatedSdk = async () => {
@@ -2389,19 +2389,25 @@ var HTMLComponentLoader = class extends BaseMyopLoader {
     return (script == null ? void 0 : script.textContent) || null;
   }
   /**
-   * Execute the web component script on the host document
+   * Execute the web component script on the host document.
+   * Returns the custom element tag name this script registered.
    */
   executeWebComponentScript(scriptContent, scriptId) {
-    if (extractedWebComponentScripts.has(scriptId)) {
-      console.log("[MyopWebComponent] Script already executed for ".concat(scriptId, ", skipping"));
-      return;
+    const cachedTagName = extractedWebComponentScripts.get(scriptId);
+    if (cachedTagName) {
+      console.log("[MyopWebComponent] Script already executed for ".concat(scriptId, ", reusing <").concat(cachedTagName, ">"));
+      return cachedTagName;
     }
     const script = document.createElement("script");
     script.textContent = scriptContent;
     script.id = "myop-extracted-".concat(scriptId);
     document.head.appendChild(script);
-    extractedWebComponentScripts.add(scriptId);
-    console.log("[MyopWebComponent] Executed web component script: ".concat(scriptId));
+    const tagName = window.__MYOP_TAG_NAME__;
+    if (tagName) {
+      extractedWebComponentScripts.set(scriptId, tagName);
+    }
+    console.log("[MyopWebComponent] Executed web component script: ".concat(scriptId, " -> <").concat(tagName, ">"));
+    return tagName;
   }
   /**
    * Load a Myop Web Component (extracted and run on host document)
@@ -2412,15 +2418,10 @@ var HTMLComponentLoader = class extends BaseMyopLoader {
       throw new Error('[MyopWebComponent] No <script id="myop-web-component"> found in HTML');
     }
     const scriptId = "".concat(componentDefinition.id, "-").concat(skin.id);
-    const previousTagName = window.__MYOP_TAG_NAME__;
-    this.executeWebComponentScript(scriptContent, scriptId);
-    const tagName = window.__MYOP_TAG_NAME__;
+    const tagName = this.executeWebComponentScript(scriptContent, scriptId);
     if (!tagName) {
       throw new Error("[MyopWebComponent] Script did not set window.__MYOP_TAG_NAME__");
     }
-    if (previousTagName && previousTagName !== tagName) {
-      console.warn("[MyopWebComponent] __MYOP_TAG_NAME__ changed from ".concat(previousTagName, " to ").concat(tagName));
-    }
     const domId = "myop-comp-".concat(uuidv4());
     const element = document.createElement(tagName);
     element.id = domId;
@@ -2596,24 +2597,33 @@ var _CloudRepository = class _CloudRepository {
   getPreloadedParams(componentId) {
     return this.preloadedComponents[componentId];
   }
+  /**
+   * Resolve a component config: fetch it once, then serve it from this
+   * repository's cache.
+   *
+   * This is the name to use. `fetchComponentV2` is the same method under its
+   * versioned name and stays for backward compatibility — note that the
+   * unversioned `fetchComponent` is a *deprecated v1* API and is NOT this.
+   *
+   * Completes the trio with {@link getResolvedConfig} (synchronous read of an
+   * already-resolved config) and {@link hydrateComponent} (seed one you
+   * already hold).
+   *
+   * Prefer the module-level `preloadComponents([id])` in app code; reach for
+   * this when you need an isolated repository instance whose cache lifetime
+   * you control — a server with its own TTL, for example.
+   */
+  async resolveComponent(componentId, env, preview) {
+    return this.fetchComponentV2(componentId, env, preview);
+  }
   /**
    * Fetch a v2 component config
    * If env/preview not specified and component was preloaded, uses preloaded params
+   *
+   * @see resolveComponent — the unversioned name for this method
    */
   async fetchComponentV2(componentId, environmentIdentifier, preview) {
-    const preloaded = this.preloadedComponents[componentId];
-    const hasExplicitParams = environmentIdentifier !== void 0 || preview !== void 0;
-    let env;
-    let usePreview;
-    if (!hasExplicitParams && preloaded) {
-      env = preloaded.env;
-      usePreview = preloaded.preview;
-    } else {
-      env = environmentIdentifier || this._defaultEnv;
-      const hasEffectiveEnv = environmentIdentifier || this._envExplicitlySet;
-      usePreview = preview === true ? true : preview === false ? false : !hasEffectiveEnv;
-    }
-    const cacheKey = "".concat(componentId, ":").concat(env, ":").concat(usePreview ? "preview" : "live");
+    const { env, usePreview, cacheKey } = this.resolveParams(componentId, environmentIdentifier, preview);
     console.log("[CloudRepository] fetchComponentV2", {
       componentId: componentId.slice(0, 8) + "...",
       env,
@@ -2682,20 +2692,52 @@ var _CloudRepository = class _CloudRepository {
    */
   getResolvedConfig(componentId, env, preview) {
     var _a;
+    const { cacheKey } = this.resolveParams(componentId, env, preview);
+    return ((_a = this.variants[cacheKey]) == null ? void 0 : _a.resolved) || null;
+  }
+  /**
+   * Resolve which (env, preview) pair — and therefore which cache key — a call
+   * for `componentId` refers to.
+   *
+   * Single source of truth for fetchComponentV2, getResolvedConfig and
+   * hydrateComponent, so a hydrated config always lands on the key a later
+   * fetch will look under.
+   */
+  resolveParams(componentId, environmentIdentifier, preview) {
     const preloaded = this.preloadedComponents[componentId];
-    const hasExplicitParams = env !== void 0 || preview !== void 0;
-    let resolvedEnv;
+    const hasExplicitParams = environmentIdentifier !== void 0 || preview !== void 0;
+    let env;
     let usePreview;
     if (!hasExplicitParams && preloaded) {
-      resolvedEnv = preloaded.env;
+      env = preloaded.env;
       usePreview = preloaded.preview;
     } else {
-      resolvedEnv = env || this._defaultEnv;
-      const hasEffectiveEnv = env || this._envExplicitlySet;
+      env = environmentIdentifier || this._defaultEnv;
+      const hasEffectiveEnv = environmentIdentifier || this._envExplicitlySet;
       usePreview = preview === true ? true : preview === false ? false : !hasEffectiveEnv;
     }
-    const cacheKey = "".concat(componentId, ":").concat(resolvedEnv, ":").concat(usePreview ? "preview" : "live");
-    return ((_a = this.variants[cacheKey]) == null ? void 0 : _a.resolved) || null;
+    return { env, usePreview, cacheKey: "".concat(componentId, ":").concat(env, ":").concat(usePreview ? "preview" : "live") };
+  }
+  /**
+   * Seed an already-resolved component config into the cache, without any
+   * network request.
+   *
+   * The counterpart to {@link fetchComponentV2}: use it when the config was
+   * resolved somewhere else — most often on a server, then embedded in the
+   * page — so the browser can render the component with no round trip.
+   *
+   * After hydrating, `fetchComponentV2`, `getResolvedConfig` and `isPreloaded`
+   * all answer for this component from memory.
+   *
+   * Pass the same `env` / `preview` the config was resolved with; the defaults
+   * match what a plain `fetchComponentV2(componentId)` would have used.
+   */
+  hydrateComponent(componentId, config, env, preview) {
+    const { env: resolvedEnv, usePreview, cacheKey } = this.resolveParams(componentId, env, preview);
+    const promise = Promise.resolve(config);
+    promise.resolved = config;
+    this.variants[cacheKey] = promise;
+    this.preloadedComponents[componentId] = { env: resolvedEnv, preview: usePreview };
   }
   // ============ V1 Methods (Legacy) ============
   /**