@matterfact/embed 0.17.0 → 0.18.0

package/dist/react.d.cts

@@ -301,6 +301,19 @@ interface MatterfactAgentProps {
      * matching the template the widget auto-opens that shared 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}".
+     *
+     * DYNAMIC form: `{path}` directly after the origin stands for the page's current
+     * pathname — one template serves every page a popup install lives on. Links then
+     * carry the page the sharer was on, and pickup fires on any page:
+     * `` `${location.origin}{path}?mf_share={share_token}` `` (the token must be a
+     * query value in this form). Note `{path}` shares the current pathname with the
+     * widget; static templates never do.
+     *
+     * A query-only URL rewrite by your router (boot-time normalisation) does not
+     * cancel a picked-up conversation — only a real pathname change does. Your auth
+     * flow must still deliver the URL to the page: a redirect that drops the query
+     * before this page boots is unrecoverable from here.
+     *
      * Read at mount; change requires a remount.
      */
     shareDeeplinkFormat?: string;
@@ -418,7 +431,7 @@ interface MatterfactAgentProps {
      */
     onEvent?: (e: MatterfactEvent) => void;
 }
-declare function MatterfactAgent({ publishableKey: publishableKeyProp, widgetOrigin: widgetOriginProp, surface, shareDeeplinkFormat, theme: themeProp, getAuthToken: getAuthTokenProp, getPageContext, inline, className, style, pageContext, dev, actions, sitemap, artifacts, resolve, tools, onToolEvent, onEvent, }: MatterfactAgentProps): react_jsx_runtime.JSX.Element | null;
+declare function MatterfactAgent({ publishableKey: publishableKeyProp, widgetOrigin: widgetOriginProp, surface, shareDeeplinkFormat, theme: themeProp, getAuthToken: getAuthTokenProp, getPageContext, inline, className, style, pageContext, dev, actions, sitemap, artifacts, resolve, tools, onToolEvent, onEvent, ...unknownProps }: MatterfactAgentProps): react_jsx_runtime.JSX.Element | null;
 interface MatterfactArtifactProps {
     /** The artifact's name (its slug). */
     name?: string;

package/dist/react.d.ts

@@ -301,6 +301,19 @@ interface MatterfactAgentProps {
      * matching the template the widget auto-opens that shared 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}".
+     *
+     * DYNAMIC form: `{path}` directly after the origin stands for the page's current
+     * pathname — one template serves every page a popup install lives on. Links then
+     * carry the page the sharer was on, and pickup fires on any page:
+     * `` `${location.origin}{path}?mf_share={share_token}` `` (the token must be a
+     * query value in this form). Note `{path}` shares the current pathname with the
+     * widget; static templates never do.
+     *
+     * A query-only URL rewrite by your router (boot-time normalisation) does not
+     * cancel a picked-up conversation — only a real pathname change does. Your auth
+     * flow must still deliver the URL to the page: a redirect that drops the query
+     * before this page boots is unrecoverable from here.
+     *
      * Read at mount; change requires a remount.
      */
     shareDeeplinkFormat?: string;
@@ -418,7 +431,7 @@ interface MatterfactAgentProps {
      */
     onEvent?: (e: MatterfactEvent) => void;
 }
-declare function MatterfactAgent({ publishableKey: publishableKeyProp, widgetOrigin: widgetOriginProp, surface, shareDeeplinkFormat, theme: themeProp, getAuthToken: getAuthTokenProp, getPageContext, inline, className, style, pageContext, dev, actions, sitemap, artifacts, resolve, tools, onToolEvent, onEvent, }: MatterfactAgentProps): react_jsx_runtime.JSX.Element | null;
+declare function MatterfactAgent({ publishableKey: publishableKeyProp, widgetOrigin: widgetOriginProp, surface, shareDeeplinkFormat, theme: themeProp, getAuthToken: getAuthTokenProp, getPageContext, inline, className, style, pageContext, dev, actions, sitemap, artifacts, resolve, tools, onToolEvent, onEvent, ...unknownProps }: MatterfactAgentProps): react_jsx_runtime.JSX.Element | null;
 interface MatterfactArtifactProps {
     /** The artifact's name (its slug). */
     name?: string;

package/dist/react.js

@@ -227,7 +227,7 @@ function dockBox(g, vw, _vh) {
 }
 
 // src/loader.ts
-var EMBED_VERSION = "0.17.0";
+var EMBED_VERSION = "0.18.0";
 function devRequested() {
   try {
     if (new URLSearchParams(location.search).get("mfdev") === "1") return true;
@@ -375,12 +375,13 @@ var EmbedHost = class {
     }
     const fmt = this.config.shareDeeplinkFormat;
     if (fmt) {
-      this.send({ type: "host.deeplinkFormat", format: fmt });
-      void import("./deeplink-IBFUWANV.js").then((m) => {
+      void import("./deeplink-KCGMGNIR.js").then((m) => {
         if (this.destroyed) return;
-        this.deeplinkStop = m.installDeeplinkWatch(fmt, (token) => {
-          this.send({ type: "host.openShare", token });
-        });
+        this.deeplinkStop = m.installDeeplinkWatch(
+          fmt,
+          (token) => this.send({ type: "host.openShare", token }),
+          (format) => this.send({ type: "host.deeplinkFormat", format })
+        );
       }).catch(() => {
       });
     }
@@ -922,6 +923,27 @@ function toolDescriptorKey(artifacts, resolve, tools) {
     }))
   });
 }
+var KNOWN_AGENT_PROPS = [
+  "publishableKey",
+  "widgetOrigin",
+  "surface",
+  "shareDeeplinkFormat",
+  "theme",
+  "getAuthToken",
+  "getPageContext",
+  "inline",
+  "className",
+  "style",
+  "pageContext",
+  "dev",
+  "actions",
+  "sitemap",
+  "artifacts",
+  "resolve",
+  "tools",
+  "onToolEvent",
+  "onEvent"
+];
 function MatterfactAgent({
   publishableKey: publishableKeyProp,
   widgetOrigin: widgetOriginProp,
@@ -941,8 +963,20 @@ function MatterfactAgent({
   resolve,
   tools,
   onToolEvent,
-  onEvent
+  onEvent,
+  ...unknownProps
 }) {
+  useEffect2(() => {
+    if (process.env.NODE_ENV === "production") return;
+    for (const key of Object.keys(unknownProps)) {
+      const meant = KNOWN_AGENT_PROPS.find(
+        (k) => k.toLowerCase() === key.toLowerCase()
+      );
+      console.warn(
+        `[mf-embed] unknown prop "${key}" on <MatterfactAgent>` + (meant ? ` \u2014 did you mean "${meant}"?` : "")
+      );
+    }
+  }, []);
   const ctx = useMatterfactConfig();
   const publishableKey = publishableKeyProp ?? ctx?.publishableKey;
   if (!publishableKey) {