@wireai/activation 0.9.1 → 0.9.2

package/dist/{currentSession-Bs2JfTJ8.d.mts → currentSession-CRRQLbAq.d.mts}

@@ -391,6 +391,22 @@ type WireOnboardingProps = {
      * accounts mid-flow. Only meaningful with `storage`.
      */
     persistKey?: string;
+    /**
+     * OPT-IN: keep the persisted session seed alive ACROSS completion, so a multi-stage or
+     * replay-after-complete re-entry WITHIN one signup (typically a `key=` remount) resumes the
+     * SAME session instead of minting a fresh `metadata.sessionId` — which the backend would adopt
+     * as a second `contextId`, double-counting a `session_started` on the funnel.
+     *
+     * Default (omitted / `false`): a completion CLEARS the seed, so the next onboarding on this
+     * device starts fresh — the legacy single-stage behavior. Leave it unset and NOTHING changes.
+     *
+     * When `true`: the seed survives completion, and freshness for a genuinely new run is governed
+     * by the TTL (past `sessionTtlMs` → a fresh seed is minted) and an explicit new-run signal
+     * (scope a new `persistKey`, e.g. a per-signup id, to force a fresh seed within the TTL).
+     *
+     * Only meaningful with `storage`. Dropped/degraded sessions are unaffected (they never clear).
+     */
+    retainSessionOnComplete?: boolean;
 };
 /** Backend-supplied progress, read off `response.props.progress` when present. */
 type OnboardingProgress = {

package/dist/{currentSession-61dcm3V-.d.ts → currentSession-Dj0cN3Rg.d.ts}

@@ -391,6 +391,22 @@ type WireOnboardingProps = {
      * accounts mid-flow. Only meaningful with `storage`.
      */
     persistKey?: string;
+    /**
+     * OPT-IN: keep the persisted session seed alive ACROSS completion, so a multi-stage or
+     * replay-after-complete re-entry WITHIN one signup (typically a `key=` remount) resumes the
+     * SAME session instead of minting a fresh `metadata.sessionId` — which the backend would adopt
+     * as a second `contextId`, double-counting a `session_started` on the funnel.
+     *
+     * Default (omitted / `false`): a completion CLEARS the seed, so the next onboarding on this
+     * device starts fresh — the legacy single-stage behavior. Leave it unset and NOTHING changes.
+     *
+     * When `true`: the seed survives completion, and freshness for a genuinely new run is governed
+     * by the TTL (past `sessionTtlMs` → a fresh seed is minted) and an explicit new-run signal
+     * (scope a new `persistKey`, e.g. a per-signup id, to force a fresh seed within the TTL).
+     *
+     * Only meaningful with `storage`. Dropped/degraded sessions are unaffected (they never clear).
+     */
+    retainSessionOnComplete?: boolean;
 };
 /** Backend-supplied progress, read off `response.props.progress` when present. */
 type OnboardingProgress = {

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { o as WireOnboardingProps, p as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, q as OnboardingEvent, u as OnboardingCopy, a as ClientEventTarget, D as DeviceContext, C as ClientEvent, e as EnvelopeSource } from './currentSession-Bs2JfTJ8.mjs';
-export { A as AnalyticsEvent, b as ClientEventType, v as DeviceFormFactor, w as EXTRA_KEY_PREFIX, x as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, y as ResolveUserContextOptions, z as ResolvedUserContext, g as WIRE_ONBOARDING_EVENTS, h as WireOnboardingEventName, W as WireUserContext, B as collectDeviceContext, k as getCurrentSessionId, F as hashEmailFnv1a, G as isWireScalar, m as makeSessionId, H as namespaceExtra, r as reportClientEvent, l as reportClientEvents, n as resetCurrentSessionId, I as resolveUserContext, s as setCurrentSessionId, t as toAnalyticsEvent } from './currentSession-Bs2JfTJ8.mjs';
+import { o as WireOnboardingProps, p as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, q as OnboardingEvent, u as OnboardingCopy, a as ClientEventTarget, D as DeviceContext, C as ClientEvent, e as EnvelopeSource } from './currentSession-CRRQLbAq.mjs';
+export { A as AnalyticsEvent, b as ClientEventType, v as DeviceFormFactor, w as EXTRA_KEY_PREFIX, x as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, y as ResolveUserContextOptions, z as ResolvedUserContext, g as WIRE_ONBOARDING_EVENTS, h as WireOnboardingEventName, W as WireUserContext, B as collectDeviceContext, k as getCurrentSessionId, F as hashEmailFnv1a, G as isWireScalar, m as makeSessionId, H as namespaceExtra, r as reportClientEvent, l as reportClientEvents, n as resetCurrentSessionId, I as resolveUserContext, s as setCurrentSessionId, t as toAnalyticsEvent } from './currentSession-CRRQLbAq.mjs';
 import { O as OnboardingTheme } from './types-BKfpdZzX.mjs';
 export { a as OnboardingButtonStyle, b as OnboardingColors, c as OnboardingFonts, d as OnboardingRadius, e as OnboardingSpacing } from './types-BKfpdZzX.mjs';
 export { C as CenteredModal, a as CenteredModalHandle, b as CenteredModalProps } from './CenteredModal-C3qQBHsA.mjs';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { o as WireOnboardingProps, p as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, q as OnboardingEvent, u as OnboardingCopy, a as ClientEventTarget, D as DeviceContext, C as ClientEvent, e as EnvelopeSource } from './currentSession-61dcm3V-.js';
-export { A as AnalyticsEvent, b as ClientEventType, v as DeviceFormFactor, w as EXTRA_KEY_PREFIX, x as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, y as ResolveUserContextOptions, z as ResolvedUserContext, g as WIRE_ONBOARDING_EVENTS, h as WireOnboardingEventName, W as WireUserContext, B as collectDeviceContext, k as getCurrentSessionId, F as hashEmailFnv1a, G as isWireScalar, m as makeSessionId, H as namespaceExtra, r as reportClientEvent, l as reportClientEvents, n as resetCurrentSessionId, I as resolveUserContext, s as setCurrentSessionId, t as toAnalyticsEvent } from './currentSession-61dcm3V-.js';
+import { o as WireOnboardingProps, p as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, q as OnboardingEvent, u as OnboardingCopy, a as ClientEventTarget, D as DeviceContext, C as ClientEvent, e as EnvelopeSource } from './currentSession-Dj0cN3Rg.js';
+export { A as AnalyticsEvent, b as ClientEventType, v as DeviceFormFactor, w as EXTRA_KEY_PREFIX, x as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, y as ResolveUserContextOptions, z as ResolvedUserContext, g as WIRE_ONBOARDING_EVENTS, h as WireOnboardingEventName, W as WireUserContext, B as collectDeviceContext, k as getCurrentSessionId, F as hashEmailFnv1a, G as isWireScalar, m as makeSessionId, H as namespaceExtra, r as reportClientEvent, l as reportClientEvents, n as resetCurrentSessionId, I as resolveUserContext, s as setCurrentSessionId, t as toAnalyticsEvent } from './currentSession-Dj0cN3Rg.js';
 import { O as OnboardingTheme } from './types-BKfpdZzX.js';
 export { a as OnboardingButtonStyle, b as OnboardingColors, c as OnboardingFonts, d as OnboardingRadius, e as OnboardingSpacing } from './types-BKfpdZzX.js';
 export { C as CenteredModal, a as CenteredModalHandle, b as CenteredModalProps } from './CenteredModal-Cdgns6--.js';

package/dist/index.js

@@ -3351,6 +3351,7 @@ var clearPersistedSession = (storage, key) => {
   } catch {
   }
 };
+var shouldClearOnComplete = (retainSessionOnComplete) => !retainSessionOnComplete;
 
 // src/identity/userIdentity.ts
 var USER_ID_MAX_LENGTH = 128;
@@ -3400,6 +3401,7 @@ var WireOnboarding = ({
   storage,
   sessionTtlMs = DEFAULT_SESSION_TTL_MS,
   persistKey,
+  retainSessionOnComplete,
   userContext,
   userId
 }) => {
@@ -3434,10 +3436,10 @@ var WireOnboarding = ({
   }, [storage, storageKey, sessionTtlMs, session]);
   const handleComplete = React18.useCallback(
     (result) => {
-      if (storage) clearPersistedSession(storage, storageKey);
+      if (storage && shouldClearOnComplete(retainSessionOnComplete)) clearPersistedSession(storage, storageKey);
       onComplete(result);
     },
-    [storage, storageKey, onComplete]
+    [storage, storageKey, retainSessionOnComplete, onComplete]
   );
   const sessionId = (_a2 = session == null ? void 0 : session.id) != null ? _a2 : "";
   const startupUserIdRef = React18.useRef(boundUserId);
@@ -4433,8 +4435,9 @@ var createEventQueue = (options) => {
     } catch {
     }
   })();
+  const DROP_STATUSES = /* @__PURE__ */ new Set([400, 404, 413, 422]);
   const postBatch = async (events) => {
-    if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return false;
+    if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return "retry";
     const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
     const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), 15e3);
     try {
@@ -4447,9 +4450,12 @@ var createEventQueue = (options) => {
         body: JSON.stringify({ events }),
         signal: controller == null ? void 0 : controller.signal
       });
-      return !!(res && res.ok);
+      if (res && res.ok) return "ok";
+      const status = res == null ? void 0 : res.status;
+      if (typeof status === "number" && DROP_STATUSES.has(status)) return "drop";
+      return "retry";
     } catch {
-      return false;
+      return "retry";
     } finally {
       clearTimeout(timer);
     }
@@ -4481,8 +4487,8 @@ var createEventQueue = (options) => {
     try {
       while (pending.length > 0) {
         const batch = pending.slice(0, batchSize);
-        const ok = await postBatch(batch.map((item) => item.event));
-        if (!ok) {
+        const result = await postBatch(batch.map((item) => item.event));
+        if (result === "retry") {
           scheduleRetry();
           return;
         }