@fanfare-io/fanfare-sdk-core 0.24.0 → 0.25.0

package/dist/auth/types.d.ts

@@ -70,9 +70,11 @@ export interface OtpVerify {
     /**
      * Marketing SMS consent, recorded only on a phone verify, against the number the
      * code just proved; ignored on an email verify. Send true only when the consumer
-     * ticked the consent box on this step.
+     * explicitly agreed to the marketing offer for this attempt.
      */
     marketingSmsConsent?: boolean;
+    /** Exact localized marketing offer accepted for this attempt, including its policy link URLs. */
+    marketingSmsConsentText?: string;
     /**
      * The experience the consumer is verifying on, validated against the caller's
      * organization server-side. It records where consent was given; it does not

package/dist/draws/types.d.ts

@@ -102,6 +102,8 @@ export interface DrawModule {
  */
 export interface Draw {
     id: string;
+    /** Whether loyalty points weight the randomized entry order. */
+    loyaltyBiasEnabled?: boolean;
     openAt?: string | null;
     closeAt?: string | null;
     timeZone: string;

package/dist/experiences/types.d.ts

@@ -24,6 +24,8 @@ export interface Experience {
     description?: string;
     /** Optional image URL suitable for experience display. */
     imageUrl?: string;
+    /** Merchant identity shown in the optional marketing SMS offer. */
+    marketingSmsMerchantName?: string;
     /** Organization-level currency code (ISO 4217), when available */
     currencyCode?: string;
     /** ISO 8601 timestamp when the experience was created. */
@@ -195,6 +197,8 @@ export interface BaseDistributionDetails {
 export interface QueueDetails extends BaseDistributionDetails {
     /** Mechanism discriminator for queue details. */
     type: "queue";
+    /** Whether loyalty points weight this distribution's randomized entry order. */
+    loyaltyBiasEnabled?: boolean;
     /** Estimated wait time in seconds, when available. */
     estimatedWaitTime?: number;
     /** Current queue length, when available. */
@@ -209,6 +213,8 @@ export interface QueueDetails extends BaseDistributionDetails {
 export interface DrawDetails extends BaseDistributionDetails {
     /** Mechanism discriminator for draw details. */
     type: "draw";
+    /** Whether loyalty points weight this distribution's randomized entry order. */
+    loyaltyBiasEnabled?: boolean;
     /** ISO 8601 timestamp when the draw is expected to run. */
     drawTime?: string;
     /** ISO 8601 timestamp when entry closes. */

package/dist/internals.d.ts

@@ -15,3 +15,6 @@ export type { AppointmentDisplayState, AuctionDisplayState, DistributionDisplayS
 export { getEventBus } from './state/events';
 export { generateFingerprint, generateFingerprintSync } from './utils/fingerprint.module';
 export type { BrowserFingerprint } from './utils/fingerprint.module';
+export { restoreFocus } from './utils/focus-recovery';
+export { MARKETING_SMS_PRIVACY_URL, MARKETING_SMS_TERMS_URL, formatMarketingSmsConsentText, } from './utils/marketing-sms-consent';
+export type { MarketingSmsCopy } from './utils/marketing-sms-consent';

package/dist/internals.js

@@ -1 +1 @@
-import{readExperienceDetails as e}from"./core/internal-sdk-registry.js";import{createDomBridge as r}from"./experiences/dom-bridge.js";import{describeJourneyState as o,selectJourneyDisplay as i}from"./experiences/journey-display.js";import{SnapshotInvariantError as m,getAdmissionGrant as s,getAdmissionGrantExpiresAt as t,getDistribution as p,getGates as n,getOffers as j,getParticipation as f,getSelected as c,getSequenceId as d,getSequencePhase as a,getSequenceState as l,isGateState as u,isPreEntryJourney as x,isRoutedState as y}from"./experiences/journey.machine.js";import{getEventBus as g}from"./state/events.js";import{generateFingerprint as b,generateFingerprintSync as h}from"./utils/fingerprint.module.js";export{m as SnapshotInvariantError,r as createDomBridge,o as describeJourneyState,b as generateFingerprint,h as generateFingerprintSync,s as getAdmissionGrant,t as getAdmissionGrantExpiresAt,p as getDistribution,g as getEventBus,n as getGates,j as getOffers,f as getParticipation,c as getSelected,d as getSequenceId,a as getSequencePhase,l as getSequenceState,u as isGateState,x as isPreEntryJourney,y as isRoutedState,e as readExperienceDetails,i as selectJourneyDisplay};
+import{readExperienceDetails as r}from"./core/internal-sdk-registry.js";import{createDomBridge as e}from"./experiences/dom-bridge.js";import{describeJourneyState as o,selectJourneyDisplay as s}from"./experiences/journey-display.js";import{SnapshotInvariantError as i,getAdmissionGrant as m,getAdmissionGrantExpiresAt as t,getDistribution as n,getGates as p,getOffers as f,getParticipation as j,getSelected as c,getSequenceId as u,getSequencePhase as l,getSequenceState as a,isGateState as d,isPreEntryJourney as y,isRoutedState as g}from"./experiences/journey.machine.js";import{getEventBus as x}from"./state/events.js";import{generateFingerprint as k,generateFingerprintSync as v}from"./utils/fingerprint.module.js";import{restoreFocus as b}from"./utils/focus-recovery.js";import{MARKETING_SMS_PRIVACY_URL as h,MARKETING_SMS_TERMS_URL as q,formatMarketingSmsConsentText as w}from"./utils/marketing-sms-consent.js";export{h as MARKETING_SMS_PRIVACY_URL,q as MARKETING_SMS_TERMS_URL,i as SnapshotInvariantError,e as createDomBridge,o as describeJourneyState,w as formatMarketingSmsConsentText,k as generateFingerprint,v as generateFingerprintSync,m as getAdmissionGrant,t as getAdmissionGrantExpiresAt,n as getDistribution,x as getEventBus,p as getGates,f as getOffers,j as getParticipation,c as getSelected,u as getSequenceId,l as getSequencePhase,a as getSequenceState,d as isGateState,y as isPreEntryJourney,g as isRoutedState,r as readExperienceDetails,b as restoreFocus,s as selectJourneyDisplay};

package/dist/utils/focus-recovery.d.ts

@@ -0,0 +1,2 @@
+/** Restore focus lost when a native control is disabled or replaced, preserving deliberate focus moves. */
+export declare function restoreFocus(target?: HTMLButtonElement | HTMLInputElement | null): void;

package/dist/utils/focus-recovery.js

@@ -0,0 +1 @@
+function e(e){if(!e?.isConnected||e.disabled)return;const t=e.ownerDocument,o=e.getRootNode().activeElement??t.activeElement;o&&o!==e&&o!==t.body||e.focus()}export{e as restoreFocus};

package/dist/utils/marketing-sms-consent.d.ts

@@ -0,0 +1,13 @@
+/** Shared first-party offer destinations and evidence format. */
+export declare const MARKETING_SMS_TERMS_URL = "https://www.fanfare.io/terms-of-service#sms";
+export declare const MARKETING_SMS_PRIVACY_URL = "https://www.fanfare.io/privacy-policy#text-messages";
+export type MarketingSmsCopy = readonly [
+    title: string,
+    disclosure: string,
+    legalLine: string,
+    termsLabel: string,
+    privacyLabel: string,
+    agreeLabel: string
+];
+/** Formats already-resolved displayed copy; callers freeze this only on affirmative consent. */
+export declare function formatMarketingSmsConsentText([title, disclosure, legalLine, termsLabel, privacyLabel, agreeLabel,]: MarketingSmsCopy): string;

package/dist/utils/marketing-sms-consent.js

@@ -0,0 +1 @@
+const t="https://www.fanfare.io/terms-of-service#sms",e="https://www.fanfare.io/privacy-policy#text-messages";function s([s,n,o,r,i,a]){return[s,n,o,`${r}: ${t}`,`${i}: ${e}`,a].join("\n")}export{e as MARKETING_SMS_PRIVACY_URL,t as MARKETING_SMS_TERMS_URL,s as formatMarketingSmsConsentText};

package/dist/version.d.ts

@@ -2,4 +2,4 @@
  * SDK version
  * This is automatically updated during the build process
  */
-export declare const version = "0.24.0";
+export declare const version = "0.25.0";

package/dist/version.js

@@ -1 +1 @@
-const o="0.24.0";export{o as version};
+const o="0.25.0";export{o as version};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanfare-io/fanfare-sdk-core",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Official Fanfare Browser SDK for queue, draw, auction, and appointment experiences",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -114,18 +114,16 @@
     "uuid": "^14.0.0",
     "wretch": "^2.11.0",
     "zustand": "^5.0.6",
-    "@fanfare-io/fanfare-sdk-contracts": "0.24.0"
+    "@fanfare-io/fanfare-sdk-contracts": "0.25.0"
   },
   "peerDependencies": {
     "valibot": "^1.1.0"
   },
   "devDependencies": {
-    "@chromatic-com/storybook": "^5.0.1",
     "@size-limit/preset-small-lib": "^11.1.8",
-    "@storybook/addon-docs": "^10.2.16",
-    "@storybook/addon-onboarding": "^10.2.16",
-    "@storybook/addon-vitest": "^10.2.16",
-    "@storybook/react-vite": "^10.2.16",
+    "@storybook/addon-docs": "~10.4.6",
+    "@storybook/addon-vitest": "~10.4.6",
+    "@storybook/react-vite": "~10.4.6",
     "@types/node": "^24.1.0",
     "@types/react": "^19.1.12",
     "@types/react-dom": "^19.1.9",
@@ -142,7 +140,7 @@
     "rimraf": "^6.0.1",
     "rollup-plugin-visualizer": "^5.14.0",
     "size-limit": "^11.1.8",
-    "storybook": "^10.2.16",
+    "storybook": "~10.4.6",
     "terser": "^5.46.1",
     "typescript": "^5.9.2",
     "typescript-native": "npm:typescript@^7.0.2",
@@ -152,7 +150,8 @@
     "vite-plugin-dts": "^4.5.4",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^5.0.0",
-    "@fanfare-io/shared-models": "0.24.0"
+    "@fanfare-io/shared-models": "0.25.0",
+    "@fanfare-io/storybook-preset": "0.25.0"
   },
   "sideEffects": false,
   "keywords": [