@matterfact/embed 0.16.0 → 0.18.0

package/dist/index.d.cts

@@ -18,7 +18,7 @@
  *    shapes are right, "deeper integration" is a transport swap (postMessage ->
  *    direct call), not a rewrite. So model the DOMAIN here, not the plumbing.
  */
-declare const PROTOCOL_VERSION = 3;
+declare const PROTOCOL_VERSION = 4;
 /** Every message is namespaced so we never collide with the host page's own postMessage traffic. */
 declare const CHANNEL = "mf-embed";
 /**
@@ -346,6 +346,26 @@ type HostToWidget = {
     type: 'host.theme';
     mode: 'light' | 'dark';
 }
+/**
+ * The share-link template the integration configured on the loader
+ * (`shareDeeplinkFormat`), e.g. `https://portal.acme.com/share/{share_token}`. Sent
+ * at mount; the widget mints "Share chat" links in this format. Absent config ⇒
+ * never sent, and the widget falls back to its own share route.
+ */
+ | {
+    type: 'host.deeplinkFormat';
+    format: string;
+}
+/**
+ * The host page's URL matches that same template, and this is the share token it
+ * carries — or `null` the moment the user navigates off it. Only the loader can see
+ * the host URL, so only the loader can report this; the widget opens (or closes) the
+ * shared thread on the back of it.
+ */
+ | {
+    type: 'host.openShare';
+    token: string | null;
+}
 /**
  * Where the widget currently IS. Sent on mount and after anything that moves it
  * (drag, snap, mode change, viewport resize).
@@ -669,6 +689,17 @@ interface LoaderConfig {
      * the URL param still works untouched; `mount()` ORs the two together.
      */
     dev?: boolean;
+    /**
+     * Host-site share-link template. The widget mints "Share chat" links in this format,
+     * and this loader watches the host URL for a match so a visitor landing on one opens
+     * that conversation. Exactly one `{share_token}`, as a whole path segment or whole
+     * query value, e.g. `https://portal.acme.com/assistant?mf_share={share_token}`.
+     * `{path}` directly after the origin makes it dynamic — links carry the page the
+     * sharer is on and pickup fires on any page (token must be a query value; the
+     * current pathname then reaches the widget). Absent ⇒ no watch is installed and
+     * the widget keeps its own share route.
+     */
+    shareDeeplinkFormat?: string;
 }
 declare function readConfig(): LoaderConfig | null;
 declare class EmbedHost {
@@ -706,6 +737,12 @@ declare class EmbedHost {
     private dragLeftBand;
     /** Loaded on first open. Holds everything that touches the customer's DOM. */
     private context;
+    /** Uninstall for the share-deeplink URL watch. No initializer on purpose: an `= null`
+     *  emits a constructor assignment into the size-budgeted stub for no behaviour. */
+    private deeplinkStop?;
+    /** Set once `destroy()` has run; falsy (never assigned) otherwise — no initializer,
+     *  same reasoning as `deeplinkStop` above. */
+    private destroyed?;
     /** The host element; kept so `destroy()` can remove it (React lifecycle). */
     private hostEl;
     /** Rendering into the host's own element: they own the box, the chrome and visibility. */

package/dist/index.d.ts

@@ -18,7 +18,7 @@
  *    shapes are right, "deeper integration" is a transport swap (postMessage ->
  *    direct call), not a rewrite. So model the DOMAIN here, not the plumbing.
  */
-declare const PROTOCOL_VERSION = 3;
+declare const PROTOCOL_VERSION = 4;
 /** Every message is namespaced so we never collide with the host page's own postMessage traffic. */
 declare const CHANNEL = "mf-embed";
 /**
@@ -346,6 +346,26 @@ type HostToWidget = {
     type: 'host.theme';
     mode: 'light' | 'dark';
 }
+/**
+ * The share-link template the integration configured on the loader
+ * (`shareDeeplinkFormat`), e.g. `https://portal.acme.com/share/{share_token}`. Sent
+ * at mount; the widget mints "Share chat" links in this format. Absent config ⇒
+ * never sent, and the widget falls back to its own share route.
+ */
+ | {
+    type: 'host.deeplinkFormat';
+    format: string;
+}
+/**
+ * The host page's URL matches that same template, and this is the share token it
+ * carries — or `null` the moment the user navigates off it. Only the loader can see
+ * the host URL, so only the loader can report this; the widget opens (or closes) the
+ * shared thread on the back of it.
+ */
+ | {
+    type: 'host.openShare';
+    token: string | null;
+}
 /**
  * Where the widget currently IS. Sent on mount and after anything that moves it
  * (drag, snap, mode change, viewport resize).
@@ -669,6 +689,17 @@ interface LoaderConfig {
      * the URL param still works untouched; `mount()` ORs the two together.
      */
     dev?: boolean;
+    /**
+     * Host-site share-link template. The widget mints "Share chat" links in this format,
+     * and this loader watches the host URL for a match so a visitor landing on one opens
+     * that conversation. Exactly one `{share_token}`, as a whole path segment or whole
+     * query value, e.g. `https://portal.acme.com/assistant?mf_share={share_token}`.
+     * `{path}` directly after the origin makes it dynamic — links carry the page the
+     * sharer is on and pickup fires on any page (token must be a query value; the
+     * current pathname then reaches the widget). Absent ⇒ no watch is installed and
+     * the widget keeps its own share route.
+     */
+    shareDeeplinkFormat?: string;
 }
 declare function readConfig(): LoaderConfig | null;
 declare class EmbedHost {
@@ -706,6 +737,12 @@ declare class EmbedHost {
     private dragLeftBand;
     /** Loaded on first open. Holds everything that touches the customer's DOM. */
     private context;
+    /** Uninstall for the share-deeplink URL watch. No initializer on purpose: an `= null`
+     *  emits a constructor assignment into the size-budgeted stub for no behaviour. */
+    private deeplinkStop?;
+    /** Set once `destroy()` has run; falsy (never assigned) otherwise — no initializer,
+     *  same reasoning as `deeplinkStop` above. */
+    private destroyed?;
     /** The host element; kept so `destroy()` can remove it (React lifecycle). */
     private hostEl;
     /** Rendering into the host's own element: they own the box, the chrome and visibility. */

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/protocol.ts
-var PROTOCOL_VERSION = 3;
+var PROTOCOL_VERSION = 4;
 var CHANNEL = "mf-embed";
 function envelope(payload, id) {
   return {
@@ -222,6 +222,7 @@ function dockBox(g, vw, _vh) {
 
 // src/loader.ts
 var DEFAULT_ORIGIN = "https://app.matterfact.com";
+var EMBED_VERSION = "0.18.0";
 function devRequested() {
   try {
     if (new URLSearchParams(location.search).get("mfdev") === "1") return true;
@@ -266,7 +267,10 @@ function readConfig() {
     theme: el?.dataset.theme || "auto",
     surface: el?.dataset.surface || "",
     container,
-    pageContext
+    pageContext,
+    // `data-share-deeplink-format="https://…/{share_token}"` — the script-tag twin of
+    // the React `shareDeeplinkFormat` prop.
+    shareDeeplinkFormat: el?.dataset.shareDeeplinkFormat
     // No `data-dev` — see the `dev` field's doc comment: the URL trigger is the
     // point for the script-tag path, so there is deliberately no script-tag knob here.
     // No `data-actions` either: the action policy lives entirely in the lazy chunk,
@@ -347,6 +351,8 @@ var EmbedHost = class {
     this.inline = !!config.container;
   }
   mount() {
+    const w = window;
+    (w.matterfact ?? (w.matterfact = {})).embedVersion = EMBED_VERSION;
     const host = document.createElement("div");
     this.hostEl = host;
     host.id = "matterfact-embed";
@@ -390,7 +396,7 @@ var EmbedHost = class {
       "sandbox",
       "allow-scripts allow-same-origin allow-forms allow-popups allow-popups-to-escape-sandbox allow-downloads"
     );
-    iframe.setAttribute("allow", "microphone; clipboard-write");
+    iframe.setAttribute("allow", "microphone; clipboard-write; web-share");
     iframe.src = `${this.config.origin}/embed/chat?k=${encodeURIComponent(
       this.config.publishableKey
     )}&o=${encodeURIComponent(location.origin)}` + (this.config.surface ? `&s=${encodeURIComponent(this.config.surface)}` : "") + // Either trigger works: the URL param (no redeploy needed) OR the config's
@@ -403,6 +409,18 @@ var EmbedHost = class {
       window.addEventListener("resize", this.onViewportResize);
       this.place();
     }
+    const fmt = this.config.shareDeeplinkFormat;
+    if (fmt) {
+      void import('./deeplink-X7IQDBCR.js').then((m) => {
+        if (this.destroyed) return;
+        this.deeplinkStop = m.installDeeplinkWatch(
+          fmt,
+          (token) => this.send({ type: "host.openShare", token }),
+          (format) => this.send({ type: "host.deeplinkFormat", format })
+        );
+      }).catch(() => {
+      });
+    }
   }
   /**
    * Test seam. The shadow root is CLOSED, so a test cannot reach the iframe to forge a
@@ -825,6 +843,9 @@ var EmbedHost = class {
     this.iframe = null;
     this.shadow = null;
     this.ready = false;
+    this.destroyed = true;
+    this.deeplinkStop?.();
+    this.deeplinkStop = null;
     void this.context?.then((m) => m.stop());
   }
 };