@wireai/activation 0.14.3 → 0.15.0

package/dist/{currentSession-CW_5Mq4O.d.ts → currentSession-CFSRZ2wg.d.ts}

@@ -685,8 +685,11 @@ type WireOnboardingProps = {
      *
      * SINCE 0.12.2, leaving it out no longer silently empties the funnel: when you pass `storage` and
      * this prop carries no `device_key`, the kit injects its OWN per-install key — the same one the
-     * analytics surfaces mint and persist — so the default wiring joins. Anything you DO pass wins
-     * verbatim and is never touched. See `autoJoinKey` for the opt-out and the two cases where the kit
+     * analytics surfaces mint and persist — so the default wiring joins. A `device_key` you DO pass
+     * wins verbatim and is never touched, provided it is a string with at least one non-whitespace
+     * character (`resolveIdentity`) — this map also accepts numbers and booleans, and a non-string or
+     * all-whitespace value is not a usable join key, so it is read as absent and the auto key is
+     * merged over it. See `autoJoinKey` for the opt-out and the two cases where the kit
      * still cannot fill the gap (no `storage`, or you opted out), which keep warning in dev.
      *
      * Never hand-write `userContext={{ deviceKey }}`: the server's device lookup reads `device_key`,
@@ -713,8 +716,11 @@ type WireOnboardingProps = {
      * `autoJoinKey={false}` if you genuinely want an UNLINKED onboarding session; that restores the
      * pre-0.12.2 behavior exactly (nothing injected) and the dev warning fires again.
      *
-     * Two things this flag does NOT do. It never overrides a `device_key` you passed — a host-supplied
-     * key always wins, whatever this is set to. And it cannot conjure a key without `storage`: with no
+     * Two things this flag does NOT do. It never overrides a `device_key` you actually supplied — a
+     * host-supplied key always wins, whatever this is set to, where "supplied" means a string with at
+     * least one non-whitespace character (`resolveIdentity`); a non-string or an all-whitespace value
+     * is read as absent and the auto key is merged over it. And it cannot conjure a key without
+     * `storage`: with no
      * persistence the kit's id is minted fresh every launch, and a per-launch key corrupts
      * `min_sessions` instead of merely leaving the join empty, so the kit declines to inject and warns
      * in dev instead.

package/dist/{currentSession-CUvTOchb.d.mts → currentSession-orZy5p1e.d.mts}

@@ -685,8 +685,11 @@ type WireOnboardingProps = {
      *
      * SINCE 0.12.2, leaving it out no longer silently empties the funnel: when you pass `storage` and
      * this prop carries no `device_key`, the kit injects its OWN per-install key — the same one the
-     * analytics surfaces mint and persist — so the default wiring joins. Anything you DO pass wins
-     * verbatim and is never touched. See `autoJoinKey` for the opt-out and the two cases where the kit
+     * analytics surfaces mint and persist — so the default wiring joins. A `device_key` you DO pass
+     * wins verbatim and is never touched, provided it is a string with at least one non-whitespace
+     * character (`resolveIdentity`) — this map also accepts numbers and booleans, and a non-string or
+     * all-whitespace value is not a usable join key, so it is read as absent and the auto key is
+     * merged over it. See `autoJoinKey` for the opt-out and the two cases where the kit
      * still cannot fill the gap (no `storage`, or you opted out), which keep warning in dev.
      *
      * Never hand-write `userContext={{ deviceKey }}`: the server's device lookup reads `device_key`,
@@ -713,8 +716,11 @@ type WireOnboardingProps = {
      * `autoJoinKey={false}` if you genuinely want an UNLINKED onboarding session; that restores the
      * pre-0.12.2 behavior exactly (nothing injected) and the dev warning fires again.
      *
-     * Two things this flag does NOT do. It never overrides a `device_key` you passed — a host-supplied
-     * key always wins, whatever this is set to. And it cannot conjure a key without `storage`: with no
+     * Two things this flag does NOT do. It never overrides a `device_key` you actually supplied — a
+     * host-supplied key always wins, whatever this is set to, where "supplied" means a string with at
+     * least one non-whitespace character (`resolveIdentity`); a non-string or an all-whitespace value
+     * is read as absent and the auto key is merged over it. And it cannot conjure a key without
+     * `storage`: with no
      * persistence the kit's id is minted fresh every launch, and a per-launch key corrupts
      * `min_sessions` instead of merely leaving the join empty, so the kit declines to inject and warns
      * in dev instead.

package/dist/{decision-Bgo17oH7.d.mts → decision-3vWLuBlO.d.ts}

@@ -1,4 +1,4 @@
-import { c as ReviewDecision, j as ReviewSubmission, e as RatingRoute } from './types-Cju-1_jT.mjs';
+import { c as ReviewDecision, j as ReviewSubmission, e as RatingRoute } from './types-tdATL5z0.js';
 
 /**
  * decision.ts — the pure decision logic for the review gate.
@@ -65,7 +65,14 @@ declare const evaluateGate: (rules: GateRules, s: GateSignals) => ReviewDecision
  * never a button labeled "rate us 5 stars" (see the store-policy notes in the README).
  */
 declare const routeRating: (stars: number) => RatingRoute;
-/** Build the `POST /v1/reviews` body. Feedback text/contact belong ONLY here, never in events. */
+/**
+ * Build the `POST /v1/reviews` body. Feedback text/contact belong ONLY here, never in events.
+ *
+ * STILL PURE, deliberately: `idempotencyKey` and the `meta.device_key` the server scopes it to are
+ * both passed IN rather than resolved here. Reaching into the device-key registry from this function
+ * would make the gate logic untestable in isolation, and both values are scoped to an impression
+ * this function cannot see — see `reviews/idempotency.ts`.
+ */
 declare const buildReviewSubmission: (input: {
     stars: number;
     feedbackText?: string;
@@ -73,6 +80,8 @@ declare const buildReviewSubmission: (input: {
     contact?: string;
     sessionId?: string;
     source?: string;
+    /** The impression's idempotency key. Omitted → the server mints a row id and inserts, as before. */
+    idempotencyKey?: string;
     meta?: Record<string, unknown>;
 }) => ReviewSubmission;
 

package/dist/{decision-Bkh_LigV.d.ts → decision-yBj2AyPW.d.mts}

@@ -1,4 +1,4 @@
-import { c as ReviewDecision, j as ReviewSubmission, e as RatingRoute } from './types-h2BZvl1t.js';
+import { c as ReviewDecision, j as ReviewSubmission, e as RatingRoute } from './types-Byx306Kv.mjs';
 
 /**
  * decision.ts — the pure decision logic for the review gate.
@@ -65,7 +65,14 @@ declare const evaluateGate: (rules: GateRules, s: GateSignals) => ReviewDecision
  * never a button labeled "rate us 5 stars" (see the store-policy notes in the README).
  */
 declare const routeRating: (stars: number) => RatingRoute;
-/** Build the `POST /v1/reviews` body. Feedback text/contact belong ONLY here, never in events. */
+/**
+ * Build the `POST /v1/reviews` body. Feedback text/contact belong ONLY here, never in events.
+ *
+ * STILL PURE, deliberately: `idempotencyKey` and the `meta.device_key` the server scopes it to are
+ * both passed IN rather than resolved here. Reaching into the device-key registry from this function
+ * would make the gate logic untestable in isolation, and both values are scoped to an impression
+ * this function cannot see — see `reviews/idempotency.ts`.
+ */
 declare const buildReviewSubmission: (input: {
     stars: number;
     feedbackText?: string;
@@ -73,6 +80,8 @@ declare const buildReviewSubmission: (input: {
     contact?: string;
     sessionId?: string;
     source?: string;
+    /** The impression's idempotency key. Omitted → the server mints a row id and inserts, as before. */
+    idempotencyKey?: string;
     meta?: Record<string, unknown>;
 }) => ReviewSubmission;
 

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { I as WireOnboardingProps, J as WireOnboardingConfig, O as OnboardingResult, K as WirePermissionStatus, P as PermissionStage, L as WirePermissionOutcome, S as StepValidator, M as OnboardingEvent, N as OnboardingCopy, C as ClientEventTarget, Q as DeviceContext, T as PermissionScreenConfig, W as WireUserContext, c as ClientEvent, U as PermissionPlacement, g as EnvelopeSource } from './currentSession-CUvTOchb.mjs';
-export { A as AUTO_DEVICE_ID_PREFIX, a as AnalyticsEvent, b as ClearUserContextOptions, d as ClientEventType, V as DEFAULT_PERMISSION_COPY, X as DeviceFormFactor, D as DeviceKeyStorage, Y as EXTRA_KEY_PREFIX, Z as GENERIC_PERMISSION_COPY, _ as IdentifyOnboardingBinding, $ as IdentifyOnboardingOptions, a0 as IdentityRecord, a1 as IdentitySource, a2 as IdentitySpace, a3 as NOTIFICATIONS_PERMISSION_COPY, a4 as OnboardingProgress, a5 as PermissionScreenCopy, R as ResolveAutoDeviceKeyOptions, a6 as ResolveUserContextOptions, a7 as ResolvedUserContext, a8 as USER_ID_MAX_LENGTH, i as WIRE_ONBOARDING_EVENTS, a9 as WIRE_PERMISSION_EVENTS, j as WireOnboardingEventName, aa as WirePermissionEventName, ab as WirePermissionKind, ac as activationJoinContext, k as analyticsUserIdStorageKey, m as clearPiiFromContext, n as clearUserContext, ad as collectDeviceContext, p as deviceIdStorageKey, q as ensureCurrentSessionId, r as getCurrentSessionId, ae as hashEmailFnv1a, af as hostIdentity, ag as hydrateAutoDeviceKey, ah as hydrateDeviceIdentity, ai as identifyOnboarding, aj as isWireScalar, s as looksLikeEmail, t as makeSessionId, ak as mintDeviceId, al as namespaceExtra, am as normalizePermissionStatus, an as permissionEventName, ao as permissionEventProps, u as reportClientEvent, v as reportClientEventAwait, w as reportClientEvents, x as reportClientEventsAwait, y as resetAutoDeviceKeys, z as resetCurrentSessionId, ap as resetIdentityProvenance, F as resolveAutoDeviceKey, aq as resolveIdentity, ar as resolvePermissionCopy, as as resolveUserContext, at as sanitizeUserId, G as setCurrentSessionId, H as toAnalyticsEvent } from './currentSession-CUvTOchb.mjs';
+import { I as WireOnboardingProps, J as WireOnboardingConfig, O as OnboardingResult, K as WirePermissionStatus, P as PermissionStage, L as WirePermissionOutcome, S as StepValidator, M as OnboardingEvent, N as OnboardingCopy, C as ClientEventTarget, Q as DeviceContext, T as PermissionScreenConfig, W as WireUserContext, c as ClientEvent, U as PermissionPlacement, g as EnvelopeSource } from './currentSession-orZy5p1e.mjs';
+export { A as AUTO_DEVICE_ID_PREFIX, a as AnalyticsEvent, b as ClearUserContextOptions, d as ClientEventType, V as DEFAULT_PERMISSION_COPY, X as DeviceFormFactor, D as DeviceKeyStorage, Y as EXTRA_KEY_PREFIX, Z as GENERIC_PERMISSION_COPY, _ as IdentifyOnboardingBinding, $ as IdentifyOnboardingOptions, a0 as IdentityRecord, a1 as IdentitySource, a2 as IdentitySpace, a3 as NOTIFICATIONS_PERMISSION_COPY, a4 as OnboardingProgress, a5 as PermissionScreenCopy, R as ResolveAutoDeviceKeyOptions, a6 as ResolveUserContextOptions, a7 as ResolvedUserContext, a8 as USER_ID_MAX_LENGTH, i as WIRE_ONBOARDING_EVENTS, a9 as WIRE_PERMISSION_EVENTS, j as WireOnboardingEventName, aa as WirePermissionEventName, ab as WirePermissionKind, ac as activationJoinContext, k as analyticsUserIdStorageKey, m as clearPiiFromContext, n as clearUserContext, ad as collectDeviceContext, p as deviceIdStorageKey, q as ensureCurrentSessionId, r as getCurrentSessionId, ae as hashEmailFnv1a, af as hostIdentity, ag as hydrateAutoDeviceKey, ah as hydrateDeviceIdentity, ai as identifyOnboarding, aj as isWireScalar, s as looksLikeEmail, t as makeSessionId, ak as mintDeviceId, al as namespaceExtra, am as normalizePermissionStatus, an as permissionEventName, ao as permissionEventProps, u as reportClientEvent, v as reportClientEventAwait, w as reportClientEvents, x as reportClientEventsAwait, y as resetAutoDeviceKeys, z as resetCurrentSessionId, ap as resetIdentityProvenance, F as resolveAutoDeviceKey, aq as resolveIdentity, ar as resolvePermissionCopy, as as resolveUserContext, at as sanitizeUserId, G as setCurrentSessionId, H as toAnalyticsEvent } from './currentSession-orZy5p1e.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 { I as WireOnboardingProps, J as WireOnboardingConfig, O as OnboardingResult, K as WirePermissionStatus, P as PermissionStage, L as WirePermissionOutcome, S as StepValidator, M as OnboardingEvent, N as OnboardingCopy, C as ClientEventTarget, Q as DeviceContext, T as PermissionScreenConfig, W as WireUserContext, c as ClientEvent, U as PermissionPlacement, g as EnvelopeSource } from './currentSession-CW_5Mq4O.js';
-export { A as AUTO_DEVICE_ID_PREFIX, a as AnalyticsEvent, b as ClearUserContextOptions, d as ClientEventType, V as DEFAULT_PERMISSION_COPY, X as DeviceFormFactor, D as DeviceKeyStorage, Y as EXTRA_KEY_PREFIX, Z as GENERIC_PERMISSION_COPY, _ as IdentifyOnboardingBinding, $ as IdentifyOnboardingOptions, a0 as IdentityRecord, a1 as IdentitySource, a2 as IdentitySpace, a3 as NOTIFICATIONS_PERMISSION_COPY, a4 as OnboardingProgress, a5 as PermissionScreenCopy, R as ResolveAutoDeviceKeyOptions, a6 as ResolveUserContextOptions, a7 as ResolvedUserContext, a8 as USER_ID_MAX_LENGTH, i as WIRE_ONBOARDING_EVENTS, a9 as WIRE_PERMISSION_EVENTS, j as WireOnboardingEventName, aa as WirePermissionEventName, ab as WirePermissionKind, ac as activationJoinContext, k as analyticsUserIdStorageKey, m as clearPiiFromContext, n as clearUserContext, ad as collectDeviceContext, p as deviceIdStorageKey, q as ensureCurrentSessionId, r as getCurrentSessionId, ae as hashEmailFnv1a, af as hostIdentity, ag as hydrateAutoDeviceKey, ah as hydrateDeviceIdentity, ai as identifyOnboarding, aj as isWireScalar, s as looksLikeEmail, t as makeSessionId, ak as mintDeviceId, al as namespaceExtra, am as normalizePermissionStatus, an as permissionEventName, ao as permissionEventProps, u as reportClientEvent, v as reportClientEventAwait, w as reportClientEvents, x as reportClientEventsAwait, y as resetAutoDeviceKeys, z as resetCurrentSessionId, ap as resetIdentityProvenance, F as resolveAutoDeviceKey, aq as resolveIdentity, ar as resolvePermissionCopy, as as resolveUserContext, at as sanitizeUserId, G as setCurrentSessionId, H as toAnalyticsEvent } from './currentSession-CW_5Mq4O.js';
+import { I as WireOnboardingProps, J as WireOnboardingConfig, O as OnboardingResult, K as WirePermissionStatus, P as PermissionStage, L as WirePermissionOutcome, S as StepValidator, M as OnboardingEvent, N as OnboardingCopy, C as ClientEventTarget, Q as DeviceContext, T as PermissionScreenConfig, W as WireUserContext, c as ClientEvent, U as PermissionPlacement, g as EnvelopeSource } from './currentSession-CFSRZ2wg.js';
+export { A as AUTO_DEVICE_ID_PREFIX, a as AnalyticsEvent, b as ClearUserContextOptions, d as ClientEventType, V as DEFAULT_PERMISSION_COPY, X as DeviceFormFactor, D as DeviceKeyStorage, Y as EXTRA_KEY_PREFIX, Z as GENERIC_PERMISSION_COPY, _ as IdentifyOnboardingBinding, $ as IdentifyOnboardingOptions, a0 as IdentityRecord, a1 as IdentitySource, a2 as IdentitySpace, a3 as NOTIFICATIONS_PERMISSION_COPY, a4 as OnboardingProgress, a5 as PermissionScreenCopy, R as ResolveAutoDeviceKeyOptions, a6 as ResolveUserContextOptions, a7 as ResolvedUserContext, a8 as USER_ID_MAX_LENGTH, i as WIRE_ONBOARDING_EVENTS, a9 as WIRE_PERMISSION_EVENTS, j as WireOnboardingEventName, aa as WirePermissionEventName, ab as WirePermissionKind, ac as activationJoinContext, k as analyticsUserIdStorageKey, m as clearPiiFromContext, n as clearUserContext, ad as collectDeviceContext, p as deviceIdStorageKey, q as ensureCurrentSessionId, r as getCurrentSessionId, ae as hashEmailFnv1a, af as hostIdentity, ag as hydrateAutoDeviceKey, ah as hydrateDeviceIdentity, ai as identifyOnboarding, aj as isWireScalar, s as looksLikeEmail, t as makeSessionId, ak as mintDeviceId, al as namespaceExtra, am as normalizePermissionStatus, an as permissionEventName, ao as permissionEventProps, u as reportClientEvent, v as reportClientEventAwait, w as reportClientEvents, x as reportClientEventsAwait, y as resetAutoDeviceKeys, z as resetCurrentSessionId, ap as resetIdentityProvenance, F as resolveAutoDeviceKey, aq as resolveIdentity, ar as resolvePermissionCopy, as as resolveUserContext, at as sanitizeUserId, G as setCurrentSessionId, H as toAnalyticsEvent } from './currentSession-CFSRZ2wg.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';