@corti/embedded-web 0.2.0 → 1.0.0

package/dist/web-bundle.js

@@ -1026,12 +1026,40 @@ var __decorate = function(decorators, target, key, desc) {
   return c4 > 3 && r5 && Object.defineProperty(target, key, r5), r5;
 };
 var IFRAME_SANDBOX_POLICY = "allow-forms allow-modals allow-scripts allow-same-origin";
-var CortiEmbedded = class extends i4 {
+var DEPRECATION_TIMELINE_URL = "https://docs.corti.ai/assistant/deprecation-timeline";
+var CONFIGURATION_MIGRATION_URL = "https://docs.corti.ai/assistant/configuration-migration";
+var DEPRECATED_EVENT_SUBSCRIPTIONS = /* @__PURE__ */ new Set([
+  "ready",
+  "loaded",
+  "recordingStarted",
+  "recordingStopped",
+  "documentGenerated",
+  "documentUpdated",
+  "documentSynced",
+  "authChanged",
+  "interactionCreated",
+  "navigationChanged",
+  "usage",
+  "embedded-event"
+]);
+var CortiEmbedded = class _CortiEmbedded extends i4 {
   constructor() {
     super(...arguments);
     this.visibility = "hidden";
     this.postMessageHandler = null;
     this.normalizedBaseURL = null;
+    this.warnedDeprecatedEventSubscriptions = /* @__PURE__ */ new Set();
+  }
+  addEventListener(type, callback, options) {
+    this.warnDeprecatedEventSubscription(type);
+    super.addEventListener(type, callback, options);
+  }
+  warnDeprecatedEventSubscription(eventName) {
+    if (!DEPRECATED_EVENT_SUBSCRIPTIONS.has(eventName) || this.warnedDeprecatedEventSubscriptions.has(eventName)) {
+      return;
+    }
+    this.warnedDeprecatedEventSubscriptions.add(eventName);
+    console.warn(`[Corti Embedded] The '${eventName}' event subscription is deprecated and will be removed in a future release. Subscribe to the canonical 'event' stream instead. See ${DEPRECATION_TIMELINE_URL}.`);
   }
   // eslint-disable-next-line class-methods-use-this
   getIframeAllowPolicy(normalizedBaseURL) {
@@ -1107,6 +1135,9 @@ var CortiEmbedded = class extends i4 {
   dispatchErrorEvent(error) {
     this.dispatchPublicEvent("error", error);
   }
+  static warnDeprecatedAPI(methodName, replacement) {
+    console.warn(`[Corti Embedded] ${methodName} is deprecated and will be removed in a future release. Use ${replacement} instead. See ${CONFIGURATION_MIGRATION_URL} and ${DEPRECATION_TIMELINE_URL}.`);
+  }
   isRealIframeLoad(iframe) {
     const src = iframe.getAttribute("src") || "";
     if (!this.normalizedBaseURL)
@@ -1240,6 +1271,7 @@ var CortiEmbedded = class extends i4 {
       throw new Error("Component not ready");
     }
     try {
+      _CortiEmbedded.warnDeprecatedAPI("configureSession()", "setInteractionOptions()");
       const payload = {
         defaultLanguage: config.defaultLanguage,
         defaultOutputLanguage: config.defaultOutputLanguage,
@@ -1281,20 +1313,20 @@ var CortiEmbedded = class extends i4 {
   }
   /**
    * Navigate to a specific path within the embedded UI
-   * @param path Path to navigate to
+   * @param payload Navigation request payload or legacy path string
    * @returns Promise that resolves when navigation is complete
    */
-  async navigate(path) {
+  async navigate(payload) {
     if (!this.postMessageHandler) {
       throw new Error("Component not ready");
     }
     try {
-      const payload = { path };
+      const normalizedPayload = typeof payload === "string" ? { path: payload } : payload;
       await this.postMessageHandler.postMessage({
         type: "CORTI_EMBEDDED",
         version: "v1",
         action: "navigate",
-        payload
+        payload: normalizedPayload
       });
     } catch (error) {
       const formattedError = formatError(error, "Failed to navigate");
@@ -1372,6 +1404,31 @@ var CortiEmbedded = class extends i4 {
       throw new Error(JSON.stringify(formattedError));
     }
   }
+  /**
+   * Configure the component
+   * @param config Component configuration
+   * @returns Promise that resolves when configuration is applied
+   */
+  async configureApp(config) {
+    if (!this.postMessageHandler) {
+      throw new Error("Component not ready");
+    }
+    try {
+      const response = await this.postMessageHandler.postMessage({
+        type: "CORTI_EMBEDDED",
+        version: "v1",
+        action: "configureApp",
+        payload: config
+      });
+      if (response.success && response.payload) {
+        return response.payload;
+      }
+      throw new Error(response.error);
+    } catch (error) {
+      const formattedError = formatError(error, "Failed to configure app");
+      throw new Error(JSON.stringify(formattedError));
+    }
+  }
   /**
    * Configure the component
    * @param config Component configuration
@@ -1382,6 +1439,7 @@ var CortiEmbedded = class extends i4 {
       throw new Error("Component not ready");
     }
     try {
+      _CortiEmbedded.warnDeprecatedAPI("configure()", "configureApp()");
       const response = await this.postMessageHandler.postMessage({
         type: "CORTI_EMBEDDED",
         version: "v1",
@@ -1397,6 +1455,30 @@ var CortiEmbedded = class extends i4 {
       throw new Error(JSON.stringify(formattedError));
     }
   }
+  /**
+   * Set one-shot interaction options for the embedded instance.
+   * @param config Interaction/session-level options
+   * @returns Promise that resolves when options are applied
+   */
+  async setInteractionOptions(config) {
+    if (!this.postMessageHandler) {
+      throw new Error("Component not ready");
+    }
+    try {
+      const response = await this.postMessageHandler.postMessage({
+        type: "CORTI_EMBEDDED",
+        version: "v1",
+        action: "setInteractionOptions",
+        payload: config
+      });
+      if (response.success === false || response.error) {
+        throw new Error(response.error);
+      }
+    } catch (error) {
+      const formattedError = formatError(error, "Failed to set interaction options");
+      throw new Error(JSON.stringify(formattedError));
+    }
+  }
   /**
    * Set authentication credentials without triggering auth flow
    * @param credentials Authentication credentials to store
@@ -1455,6 +1537,31 @@ var CortiEmbedded = class extends i4 {
       throw new Error(JSON.stringify(formattedError));
     }
   }
+  /**
+   * Show the device-link QR code in the embedded UI
+   * @param payload Device-link token response to render as a QR code
+   * @returns Promise resolving to the rendered QR code state
+   */
+  async showDeviceLinkQR(payload) {
+    if (!this.postMessageHandler) {
+      throw new Error("Component not ready");
+    }
+    try {
+      const response = await this.postMessageHandler.postMessage({
+        type: "CORTI_EMBEDDED",
+        version: "v1",
+        action: "showDeviceLinkQR",
+        payload
+      });
+      if (response.success && response.payload) {
+        return response.payload;
+      }
+      throw new Error(response.error);
+    } catch (error) {
+      const formattedError = formatError(error, "Failed to show device link QR");
+      throw new Error(JSON.stringify(formattedError));
+    }
+  }
   /**
    * Check the current status of the iframe and PostMessageHandler
    * Useful for debugging

package/dist/web-index.d.ts

@@ -1,3 +1,3 @@
 import "./corti-embedded.js";
 export { CortiEmbedded } from "./CortiEmbedded.js";
-export * from "./types/index.js";
+export * from "./public-types.js";

package/dist/web-index.js

@@ -1,5 +1,5 @@
 import "./corti-embedded.js";
 export { CortiEmbedded } from "./CortiEmbedded.js";
-// Export clean public types only
-export * from "./types/index.js";
+// Export hand-owned public types only. The src/types folder is generated.
+export * from "./public-types.js";
 //# sourceMappingURL=web-index.js.map

package/dist/web-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-index.js","sourceRoot":"","sources":["../src/web-index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,iCAAiC;AACjC,cAAc,kBAAkB,CAAC","sourcesContent":["import \"./corti-embedded.js\";\n\nexport { CortiEmbedded } from \"./CortiEmbedded.js\";\n\n// Export clean public types only\nexport * from \"./types/index.js\";\n"]}
+{"version":3,"file":"web-index.js","sourceRoot":"","sources":["../src/web-index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,0EAA0E;AAC1E,cAAc,mBAAmB,CAAC","sourcesContent":["import \"./corti-embedded.js\";\n\nexport { CortiEmbedded } from \"./CortiEmbedded.js\";\n\n// Export hand-owned public types only. The src/types folder is generated.\nexport * from \"./public-types.js\";\n"]}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@corti/embedded-web",
   "description": "Web component for Corti Embedded",
   "author": "Corti ApS",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "license": "MIT",
   "bugs": {
     "url": "https://help.corti.app",
@@ -35,6 +35,8 @@
     }
   },
   "sideEffects": [
+    "src/corti-embedded.ts",
+    "src/corti-embedded.js",
     "dist/corti-embedded.js",
     "dist/web-bundle.js",
     "dist/bundle.js"