@wireai/activation 0.13.0 → 0.13.3

package/dist/questionnaire/index.d.mts

@@ -2,8 +2,8 @@ import React__default from 'react';
 import { O as OnboardingTheme } from '../types-BKfpdZzX.mjs';
 import { C as CoachmarkStorage } from '../types-BcmagF6K.mjs';
 import { W as WireFeatures, a as WireFeaturesConfig } from '../types-CKFhyrMu.mjs';
-export { G as GateRules, a as GateSignals, e as evaluateGate, r as resolveRules } from '../decision-Bl_M2y3r.mjs';
-import '../types-CNUqMK0D.mjs';
+import { S as SubmitResult } from '../types-l2tfg23P.mjs';
+export { G as GateRules, a as GateSignals, e as evaluateGate, r as resolveRules } from '../decision-Cjw0jbEj.mjs';
 
 /**
  * The firing verdict - the SAME contract on both sides of the seam. `decideQuestionnaire`
@@ -208,8 +208,10 @@ interface QuestionnaireGateController {
  * step is simply an empty answer, which is what the builder already handled.
  *
  * ⚠️ This gate now REQUIRES the server to accept an empty `answers.opinion` - step 1 is
- * skippable and the live endpoint still 422s a blank opinion, silently (the transport is
- * fire-and-forget). See the REQUIRED_STEPS note in steps.ts. Server fix, not a client one.
+ * skippable and the live endpoint still 422s a blank opinion. The 422 is read (the transport
+ * resolves `"rejected"`) but deliberately not retried — the server ANSWERED, so re-posting could
+ * duplicate the row. The user still sees the thank-you either way. See the REQUIRED_STEPS note in
+ * steps.ts. Server fix, not a client one.
  *
  * Motion: `ModalPaneHost` slides step→step (and mirrors the slide on Back) and resizes the
  * card; `StepDots` fills; `DoneCheck` plays the submit payoff. All shared, all reduce-motion
@@ -245,9 +247,9 @@ declare const buildQuestionnaireSubmission: (input: {
 }) => QuestionnaireSubmission;
 
 /**
- * transport.ts - kit → Wire server requests for the questionnaire module, all fire-and-forget
+ * transport.ts - kit → Wire server requests for the questionnaire module, never throwing
  * (a pre-onboarding questionnaire must NEVER break the app). Mirrors `submitReview`: a thin
- * fetch wrapper, Bearer tenant key, swallow every error.
+ * fetch wrapper, Bearer tenant key, and — since 0.13.3 — the SAME three-outcome delivery ack.
  *
  *   • submitQuestionnaireResponse → POST {serverUrl}/v1/questionnaires/{id}/responses
  *   • fetchQuestionnaireDecision  → GET  {serverUrl}/v1/questionnaires/decision  (best-effort)
@@ -258,10 +260,40 @@ declare const buildQuestionnaireSubmission: (input: {
  */
 
 /**
- * POST a questionnaire response. Fire-and-forget: a missing target, a missing id, a build
- * error, a missing `fetch`, or a network failure is swallowed and the call returns immediately.
+ * What became of a questionnaire POST. The SHARED verdict — identical values, identical meaning,
+ * identical retry rule as `ReviewSubmitResult`. The reasoning lives once, in `utils/submitResult.ts`.
  */
-declare const submitQuestionnaireResponse: (target: QuestionnaireTarget | undefined, id: string, submission: QuestionnaireSubmission) => void;
+type QuestionnaireSubmitResult = SubmitResult;
+/**
+ * POST a questionnaire response.
+ *
+ * NON-BLOCKING, and ACKED. It never throws and never makes a caller wait — the request is fired
+ * synchronously and the UI is free to advance on the next line — but it RESOLVES with what became
+ * of the response.
+ *
+ * ── WHY THE RETURN VALUE EXISTS (this used to be `void`) ─────────────────────────────────────
+ *
+ * The body was `void fetch(...).catch(() => {})`: the response was never read, so the caller could
+ * not tell a delivered submission from one that died in the socket. `QuestionnaireGate.finish`
+ * therefore latched the run as submitted unconditionally and resolved the gate, and `onResolved` →
+ * `markResolved` writes the PERMANENT `wire_questionnaire_<id>_<ver>_seen` key. A user who answered
+ * offline was never asked again and their answers were gone — the exact failure 0.13.3's
+ * `submitReview` fix was written for ("a detractor who rated offline was dropped AND never asked
+ * again"), on the one surface that both burns a permanent once-gate and had zero evidence of
+ * delivery. This is the twin of that fix.
+ *
+ * ── ONLY `unsent` MAY BE RETRIED ─────────────────────────────────────────────────────────────
+ *
+ * The same rule as reviews, for the same reason: the server mints the response id and the body
+ * carries no client id, so there is no idempotency key on the wire. A non-2xx proves the server was
+ * REACHED — a gateway 502 after the insert commits is indistinguishable from a refusal — so
+ * re-posting on it writes a SECOND response row. See `utils/submitResult.ts` for the full split and
+ * the honest residual.
+ *
+ * A missing target or a missing id resolves `"unsent"` with no request at all: nothing reached a
+ * server, which is exactly what a caller must be told before it decides the answers are delivered.
+ */
+declare const submitQuestionnaireResponse: (target: QuestionnaireTarget | undefined, id: string, submission: QuestionnaireSubmission) => Promise<QuestionnaireSubmitResult>;
 /** Options for the best-effort decision fetch. `deviceKey` groups a device's sessions server-side. */
 interface FetchQuestionnaireDecisionOptions {
     /** The onboarding/session id to correlate with, when known. */
@@ -293,4 +325,4 @@ declare const questionnaireLastShownKey: (id: string) => string;
 /** Session-count key, incremented once per APP-OPEN (not per mount), for the min-sessions rule. */
 declare const questionnaireSessionsKey: (id: string) => string;
 
-export { type FetchQuestionnaireDecisionOptions, type QuestionnaireAnswers, type QuestionnaireDecision, type QuestionnaireDecisionResponse, type QuestionnaireDefinition, QuestionnaireGate, type QuestionnaireGateController, type QuestionnaireGateEvent, type QuestionnaireGateEventName, type QuestionnaireGateProps, type QuestionnaireMeta, type QuestionnaireSubmission, type QuestionnaireTarget, type UseQuestionnaireGateOptions, buildQuestionnaireSubmission, decideQuestionnaire, fetchQuestionnaireDecision, questionnaireLastShownKey, questionnaireSeenKey, questionnaireSessionsKey, submitQuestionnaireResponse, useQuestionnaireGate };
+export { type FetchQuestionnaireDecisionOptions, type QuestionnaireAnswers, type QuestionnaireDecision, type QuestionnaireDecisionResponse, type QuestionnaireDefinition, QuestionnaireGate, type QuestionnaireGateController, type QuestionnaireGateEvent, type QuestionnaireGateEventName, type QuestionnaireGateProps, type QuestionnaireMeta, type QuestionnaireSubmission, type QuestionnaireSubmitResult, type QuestionnaireTarget, SubmitResult, type UseQuestionnaireGateOptions, buildQuestionnaireSubmission, decideQuestionnaire, fetchQuestionnaireDecision, questionnaireLastShownKey, questionnaireSeenKey, questionnaireSessionsKey, submitQuestionnaireResponse, useQuestionnaireGate };

package/dist/questionnaire/index.d.ts

@@ -2,8 +2,8 @@ import React__default from 'react';
 import { O as OnboardingTheme } from '../types-BKfpdZzX.js';
 import { C as CoachmarkStorage } from '../types-BcmagF6K.js';
 import { W as WireFeatures, a as WireFeaturesConfig } from '../types-CKFhyrMu.js';
-export { G as GateRules, a as GateSignals, e as evaluateGate, r as resolveRules } from '../decision-Cau5KmP6.js';
-import '../types-Buj9Lw9t.js';
+import { S as SubmitResult } from '../types-UVYt9BJe.js';
+export { G as GateRules, a as GateSignals, e as evaluateGate, r as resolveRules } from '../decision-GfpXAsk_.js';
 
 /**
  * The firing verdict - the SAME contract on both sides of the seam. `decideQuestionnaire`
@@ -208,8 +208,10 @@ interface QuestionnaireGateController {
  * step is simply an empty answer, which is what the builder already handled.
  *
  * ⚠️ This gate now REQUIRES the server to accept an empty `answers.opinion` - step 1 is
- * skippable and the live endpoint still 422s a blank opinion, silently (the transport is
- * fire-and-forget). See the REQUIRED_STEPS note in steps.ts. Server fix, not a client one.
+ * skippable and the live endpoint still 422s a blank opinion. The 422 is read (the transport
+ * resolves `"rejected"`) but deliberately not retried — the server ANSWERED, so re-posting could
+ * duplicate the row. The user still sees the thank-you either way. See the REQUIRED_STEPS note in
+ * steps.ts. Server fix, not a client one.
  *
  * Motion: `ModalPaneHost` slides step→step (and mirrors the slide on Back) and resizes the
  * card; `StepDots` fills; `DoneCheck` plays the submit payoff. All shared, all reduce-motion
@@ -245,9 +247,9 @@ declare const buildQuestionnaireSubmission: (input: {
 }) => QuestionnaireSubmission;
 
 /**
- * transport.ts - kit → Wire server requests for the questionnaire module, all fire-and-forget
+ * transport.ts - kit → Wire server requests for the questionnaire module, never throwing
  * (a pre-onboarding questionnaire must NEVER break the app). Mirrors `submitReview`: a thin
- * fetch wrapper, Bearer tenant key, swallow every error.
+ * fetch wrapper, Bearer tenant key, and — since 0.13.3 — the SAME three-outcome delivery ack.
  *
  *   • submitQuestionnaireResponse → POST {serverUrl}/v1/questionnaires/{id}/responses
  *   • fetchQuestionnaireDecision  → GET  {serverUrl}/v1/questionnaires/decision  (best-effort)
@@ -258,10 +260,40 @@ declare const buildQuestionnaireSubmission: (input: {
  */
 
 /**
- * POST a questionnaire response. Fire-and-forget: a missing target, a missing id, a build
- * error, a missing `fetch`, or a network failure is swallowed and the call returns immediately.
+ * What became of a questionnaire POST. The SHARED verdict — identical values, identical meaning,
+ * identical retry rule as `ReviewSubmitResult`. The reasoning lives once, in `utils/submitResult.ts`.
  */
-declare const submitQuestionnaireResponse: (target: QuestionnaireTarget | undefined, id: string, submission: QuestionnaireSubmission) => void;
+type QuestionnaireSubmitResult = SubmitResult;
+/**
+ * POST a questionnaire response.
+ *
+ * NON-BLOCKING, and ACKED. It never throws and never makes a caller wait — the request is fired
+ * synchronously and the UI is free to advance on the next line — but it RESOLVES with what became
+ * of the response.
+ *
+ * ── WHY THE RETURN VALUE EXISTS (this used to be `void`) ─────────────────────────────────────
+ *
+ * The body was `void fetch(...).catch(() => {})`: the response was never read, so the caller could
+ * not tell a delivered submission from one that died in the socket. `QuestionnaireGate.finish`
+ * therefore latched the run as submitted unconditionally and resolved the gate, and `onResolved` →
+ * `markResolved` writes the PERMANENT `wire_questionnaire_<id>_<ver>_seen` key. A user who answered
+ * offline was never asked again and their answers were gone — the exact failure 0.13.3's
+ * `submitReview` fix was written for ("a detractor who rated offline was dropped AND never asked
+ * again"), on the one surface that both burns a permanent once-gate and had zero evidence of
+ * delivery. This is the twin of that fix.
+ *
+ * ── ONLY `unsent` MAY BE RETRIED ─────────────────────────────────────────────────────────────
+ *
+ * The same rule as reviews, for the same reason: the server mints the response id and the body
+ * carries no client id, so there is no idempotency key on the wire. A non-2xx proves the server was
+ * REACHED — a gateway 502 after the insert commits is indistinguishable from a refusal — so
+ * re-posting on it writes a SECOND response row. See `utils/submitResult.ts` for the full split and
+ * the honest residual.
+ *
+ * A missing target or a missing id resolves `"unsent"` with no request at all: nothing reached a
+ * server, which is exactly what a caller must be told before it decides the answers are delivered.
+ */
+declare const submitQuestionnaireResponse: (target: QuestionnaireTarget | undefined, id: string, submission: QuestionnaireSubmission) => Promise<QuestionnaireSubmitResult>;
 /** Options for the best-effort decision fetch. `deviceKey` groups a device's sessions server-side. */
 interface FetchQuestionnaireDecisionOptions {
     /** The onboarding/session id to correlate with, when known. */
@@ -293,4 +325,4 @@ declare const questionnaireLastShownKey: (id: string) => string;
 /** Session-count key, incremented once per APP-OPEN (not per mount), for the min-sessions rule. */
 declare const questionnaireSessionsKey: (id: string) => string;
 
-export { type FetchQuestionnaireDecisionOptions, type QuestionnaireAnswers, type QuestionnaireDecision, type QuestionnaireDecisionResponse, type QuestionnaireDefinition, QuestionnaireGate, type QuestionnaireGateController, type QuestionnaireGateEvent, type QuestionnaireGateEventName, type QuestionnaireGateProps, type QuestionnaireMeta, type QuestionnaireSubmission, type QuestionnaireTarget, type UseQuestionnaireGateOptions, buildQuestionnaireSubmission, decideQuestionnaire, fetchQuestionnaireDecision, questionnaireLastShownKey, questionnaireSeenKey, questionnaireSessionsKey, submitQuestionnaireResponse, useQuestionnaireGate };
+export { type FetchQuestionnaireDecisionOptions, type QuestionnaireAnswers, type QuestionnaireDecision, type QuestionnaireDecisionResponse, type QuestionnaireDefinition, QuestionnaireGate, type QuestionnaireGateController, type QuestionnaireGateEvent, type QuestionnaireGateEventName, type QuestionnaireGateProps, type QuestionnaireMeta, type QuestionnaireSubmission, type QuestionnaireSubmitResult, type QuestionnaireTarget, SubmitResult, type UseQuestionnaireGateOptions, buildQuestionnaireSubmission, decideQuestionnaire, fetchQuestionnaireDecision, questionnaireLastShownKey, questionnaireSeenKey, questionnaireSessionsKey, submitQuestionnaireResponse, useQuestionnaireGate };

package/dist/questionnaire/index.js

@@ -60,7 +60,12 @@ var defaultOnboardingTheme = {
 var mergeTheme = (override) => {
   return defaultOnboardingTheme;
 };
-var OnboardingThemeContext = React8.createContext(null);
+var THEME_CONTEXT_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:themeContext");
+var themeGlobal = globalThis;
+if (!themeGlobal[THEME_CONTEXT_SLOT]) {
+  themeGlobal[THEME_CONTEXT_SLOT] = React8.createContext(null);
+}
+var OnboardingThemeContext = themeGlobal[THEME_CONTEXT_SLOT];
 var useOnboardingTheme = () => {
   const ctx = React8.useContext(OnboardingThemeContext);
   return ctx != null ? ctx : mergeTheme();
@@ -839,20 +844,22 @@ var toAnswers = (drafts) => {
 };
 
 // src/questionnaire/transport.ts
-var submitQuestionnaireResponse = (target, id, submission) => {
-  if (!(target == null ? void 0 : target.serverUrl) || !id) return;
+var submitQuestionnaireResponse = async (target, id, submission) => {
+  if (!(target == null ? void 0 : target.serverUrl) || !id) return "unsent";
   try {
     const base = target.serverUrl.replace(/\/$/, "");
     const url = `${base}/v1/questionnaires/${encodeURIComponent(id)}/responses`;
     const headers = { "Content-Type": "application/json" };
     if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-    void fetch(url, {
+    const res = await fetch(url, {
       method: "POST",
       headers,
       body: JSON.stringify(submission)
-    }).catch(() => {
     });
+    if (!res) return "unsent";
+    return res.ok ? "accepted" : "rejected";
   } catch {
+    return "unsent";
   }
 };
 var fetchQuestionnaireDecision = async (target, options = {}) => {
@@ -945,14 +952,39 @@ var _QuestionnaireGate = ({
     }
     onResolved == null ? void 0 : onResolved();
   }, [id, onResolved]);
+  const postedRef = React8.useRef(false);
+  const unackedRef = React8.useRef(null);
+  const postOnce = React8.useCallback(
+    (body) => {
+      if (postedRef.current) return;
+      postedRef.current = true;
+      unackedRef.current = body;
+      void submitQuestionnaireResponse(target, id, body).then((result) => {
+        if (result === "unsent") {
+          postedRef.current = false;
+          return;
+        }
+        unackedRef.current = null;
+      });
+    },
+    [target, id]
+  );
+  const recoverRef = React8.useRef(() => {
+  });
+  recoverRef.current = () => {
+    const undelivered = unackedRef.current;
+    if (undelivered && !postedRef.current) postOnce(undelivered);
+  };
+  React8__default.default.useEffect(() => () => recoverRef.current(), []);
   const finish = React8.useCallback(
     (drafts) => {
-      const submission = buildQuestionnaireSubmission({
-        answers: toAnswers(drafts),
-        sessionId,
-        meta
-      });
-      submitQuestionnaireResponse(target, id, submission);
+      postOnce(
+        buildQuestionnaireSubmission({
+          answers: toAnswers(drafts),
+          sessionId,
+          meta
+        })
+      );
       submittedRef.current = true;
       onEvent == null ? void 0 : onEvent({ name: "questionnaire_submitted", id });
       playHaptic("success");
@@ -963,7 +995,7 @@ var _QuestionnaireGate = ({
         (_a2 = modalRef.current) == null ? void 0 : _a2.close();
       }, 1500);
     },
-    [sessionId, meta, target, id, onEvent]
+    [sessionId, meta, postOnce, id, onEvent]
   );
   const applyTransition = React8.useCallback(
     (next) => {
@@ -1262,7 +1294,7 @@ var useWireFeatures = (config) => {
   return flags;
 };
 var CONTEXT_SYMBOL = /* @__PURE__ */ Symbol.for("wireai.features.context");
-var globalObj = global;
+var globalObj = globalThis;
 if (!globalObj[CONTEXT_SYMBOL]) {
   globalObj[CONTEXT_SYMBOL] = React8.createContext(null);
 }