@qaiddev/quests-embed 1.6.1 → 1.7.0

package/README.md

@@ -252,7 +252,7 @@ For programmatic embedding — e.g. launching a quest from another widget — th
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `metadata` | `Record<string, unknown>` | — | Extra key/value pairs sent verbatim in the create-response `POST` body. The server decides which keys it persists; unknown keys are ignored. Used, for example, by `@qaiddev/thumbs-embed` to pass `{ feedbackId }` so the QAid backend joins the quest answers to the feedback record. |
+| `metadata` | `Record<string, unknown>` or a `Promise` of one | — | Extra key/value pairs sent verbatim in the create-response `POST` body. The server decides which keys it persists; unknown keys are ignored. Used, for example, by `@qaiddev/thumbs-embed` to pass `{ feedbackId }` so the QAid backend joins the quest answers to the feedback record. A promise lets you open the quest before you have the ids: the form shows at once and only the create-response call waits for it. Check `QaidQuests.supports.asyncMetadata` first if you load the widget at runtime. |
 | `onComplete` | `(answers) => void` | — | Called once when the quest is completed and the server accepted the submit (just after the thank-you screen renders), with a copy of the submitted answers — answers to questions hidden by `visibleIf` are left out. Not called while the submit is failing. Fires in both modal and inline modes. |
 | `onClose` | `() => void` | — | Called once when the embed is torn down — visitor close, host `destroy()`, or teardown after completion. Lets a host that launched the quest drop its reference. |
 

package/dist/embed.d.ts

@@ -10,6 +10,13 @@ import type { Answers, Questionnaire, QuestsConfig } from "./types";
  */
 export declare function randomId(): string;
 export declare class QaidQuests {
+    /**
+     * What this build accepts, for hosts that load it at runtime and may get
+     * an older copy. asyncMetadata: `metadata` may be a promise.
+     */
+    static readonly supports: {
+        readonly asyncMetadata: true;
+    };
     private config;
     private questionnaire;
     private inlineQuestionnaire;

package/dist/qaid-quests.js

@@ -473,6 +473,11 @@ function Le() {
 }
 const Oe = '<svg width="14" height="14" viewBox="0 0 14 14" aria-hidden="true"><path d="M2 2l10 10M12 2L2 12" stroke="currentColor" stroke-width="2" stroke-linecap="round" fill="none"/></svg>', Pe = '<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true"><path d="M5 12l4 4L19 7" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" fill="none"/></svg>';
 class ze {
+  /**
+   * What this build accepts, for hosts that load it at runtime and may get
+   * an older copy. asyncMetadata: `metadata` may be a promise.
+   */
+  static supports = { asyncMetadata: !0 };
   config;
   questionnaire = null;
   inlineQuestionnaire;
@@ -978,8 +983,14 @@ ${s}
     }), this.createPromise;
   }
   async createResponse() {
+    let e;
+    try {
+      e = await this.metadata;
+    } catch {
+      e = void 0;
+    }
     try {
-      const e = await fetch(this.config.endpoint, {
+      const i = await fetch(this.config.endpoint, {
         method: "POST",
         headers: this.jsonHeaders(),
         body: JSON.stringify({
@@ -988,19 +999,19 @@ ${s}
           pageUrl: window.location.href,
           visitorId: this.visitorId,
           userAgent: navigator.userAgent,
-          metadata: this.metadata
+          metadata: e
         })
       });
-      if (!e.ok) {
+      if (!i.ok) {
         console.error(
-          `[quests-embed] failed to create response (${e.status})`
+          `[quests-embed] failed to create response (${i.status})`
         );
         return;
       }
-      const i = await e.json();
-      i && i.id !== null && i.id !== void 0 ? this.responseId = i.id : console.error("[quests-embed] create response returned no id");
-    } catch (e) {
-      console.error("[quests-embed] failed to create response:", e);
+      const a = await i.json();
+      a && a.id !== null && a.id !== void 0 ? this.responseId = a.id : console.error("[quests-embed] create response returned no id");
+    } catch (i) {
+      console.error("[quests-embed] failed to create response:", i);
     }
   }
   async submit() {