@qaiddev/quests-embed 1.6.0 → 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;
@@ -45,6 +52,7 @@ export declare class QaidQuests {
     private scrollCueEl;
     private overflow;
     private footerEl;
+    private primaryBtn;
     private savingEl;
     private backdropEl;
     private currentInput;
@@ -96,6 +104,15 @@ export declare class QaidQuests {
     private advance;
     private back;
     private recomputeVisible;
+    /**
+     * Label the step's primary button for what pressing it will do: "Submit"
+     * when no question after this one is visible under the current answers,
+     * "Next" otherwise. Uses the same test as `advance()`, so the two cannot
+     * disagree. Called on draw AND on every answer, because an answer can
+     * reveal a follow-up (Submit → Next) or hide the last one (Next → Submit).
+     * Edits the one button in place — no redraw, so focus and typed text stay.
+     */
+    private syncPrimaryLabel;
     private handleAnswerChange;
     private flushPendingSave;
     private saveAnswer;