@fanfare-io/fanfare-sdk-react 0.10.0 → 0.11.0

package/dist/clock-context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A server-anchored clock for time-derived rendering (countdowns). `nowMs()`
+ * returns "now" corrected to the server's clock, so a skewed device clock
+ * doesn't shift what renders.
+ *
+ * Two phases, provided by `<FanfareProvider serverNow>`:
+ * - server render + the client's first paint use a CONSTANT anchor (`serverNow`
+ *   itself), so both produce identical markup and hydration matches;
+ * - after the provider mounts, `nowMs()` advances with real time on a fixed
+ *   server↔device offset, so a countdown mounted later (a routed view shown
+ *   minutes after hydration) reads the current corrected time rather than the
+ *   frozen render timestamp.
+ */
+export interface FanfareClock {
+    nowMs(): number;
+}
+/** Constant-anchor clock for server render + first paint (deterministic). Null for an absent/invalid anchor. */
+export declare function makeAnchorClock(serverNow: string | undefined): FanfareClock | null;
+/** Live offset clock captured at provider mount: advances with real time, corrected for device skew. */
+export declare function makeOffsetClock(serverNow: string, deviceNowMs: number): FanfareClock | null;
+export declare const FanfareClockContext: import('react').Context<FanfareClock | null>;
+/** The provided server-anchored clock, or null when no anchor is in scope. */
+export declare function useClock(): FanfareClock | null;

package/dist/components/module/index.d.ts

@@ -15,5 +15,5 @@ export { InfoPanel } from './info-panel';
 export type { InfoPanelProps } from './info-panel';
 export { AlertPanel } from './alert-panel';
 export type { AlertPanelProps } from './alert-panel';
-export { normalizeOutcomeReason } from './outcome-reason';
+export { normalizeOutcomeReason, normalizeSequenceOutcomeReason } from './outcome-reason';
 export type { OutcomeReason } from './outcome-reason';

package/dist/components/module/outcome-reason.d.ts

@@ -16,8 +16,13 @@
  *   queue_denied / draw_denied / denied / lost -> not_selected
  *   timed_release_denied   ->  sold_out
  *   outbid                 ->  outbid
+ *   floor_unsold           ->  floor_unsold
  *   reserve_not_met        ->  reserve_not_met
  *   completed / already_completed -> completed (a success terminal, not a loss)
+ *   won                    ->  won
+ *   cancelled              ->  cancelled
+ *   no_show                ->  no_show
+ *   left                   ->  left (voluntary exit: leave/withdraw)
  *   closed / unknown / other -> ended
  *
  * The terminal projection carries the outcome TYPE (completed/denied/lost);
@@ -27,5 +32,9 @@
  * Static story lanes pass UI values directly (e.g. `"outbid"`); those
  * pass through unchanged.
  */
-export type OutcomeReason = "expired" | "not_selected" | "sold_out" | "outbid" | "reserve_not_met" | "completed" | "ended";
+export type OutcomeReason = "expired" | "not_selected" | "sold_out" | "outbid" | "floor_unsold" | "reserve_not_met" | "completed" | "won" | "cancelled" | "no_show" | "left" | "ended";
 export declare function normalizeOutcomeReason(reason: string | undefined): OutcomeReason;
+export declare function normalizeSequenceOutcomeReason(outcome: {
+    type: string;
+    reason?: string;
+} | undefined, fallbackReason?: string): OutcomeReason;

package/dist/components/widgets/internal/upcoming-module.d.ts

@@ -12,7 +12,7 @@ export interface UpcomingModuleProps {
     description?: string;
     /** When the distribution starts */
     startsAt?: Date | number;
-    /** Called when countdown completes */
+    /** Called once at gate-open time after the jitter window, not at visual countdown zero. */
     onCountdownComplete?: () => void;
     /** Whether entry is available */
     canEnter?: boolean;

package/dist/components/widgets/internal/waitlist-view.d.ts

@@ -7,6 +7,7 @@ export interface WaitlistViewProps {
     title?: string;
     description?: string;
     startsAt?: Date | number;
+    /** Called once at gate-open time after the jitter window, not at visual countdown zero. */
     onCountdownComplete?: () => void;
     onLeave?: () => void;
     isLeaving?: boolean;

package/dist/hooks/use-auth.d.ts

@@ -19,4 +19,5 @@ export declare function useFanfareAuth(): {
     isAuthenticated: boolean;
     isGuest?: boolean;
     session?: import('@fanfare-io/fanfare-sdk-core/auth').Session;
+    identityExpiresAt?: string;
 };

package/dist/hooks/use-beacon-tracker.d.ts

@@ -0,0 +1,21 @@
+import { BoundBeaconTracker } from '@fanfare-io/fanfare-sdk-core/beacon';
+/**
+ * Experience currently rendering around the consumer. `ExperienceWidget`
+ * publishes its `experienceId` here so descendants (slots, render-prop children,
+ * storefront components) can attribute beacon events without threading the id
+ * through props. `null` outside any experience.
+ */
+export declare const ExperienceIdContext: import('react').Context<string | null>;
+/**
+ * Returns a beacon tracker scoped to an experience.
+ *
+ * With no argument the tracker binds to the enclosing `ExperienceWidget`'s
+ * experience; pass an `experienceId` to bind explicitly (an override, or for use
+ * outside a widget). Called with neither an argument nor a surrounding
+ * experience, it throws rather than silently emitting unattributed events.
+ *
+ * @param experienceId - Experience to bind to; defaults to the enclosing widget's
+ * @returns A tracker whose `track`/`trackBatch` stamp events with the experience
+ *   and, once routed, the sequence
+ */
+export declare function useBeaconTracker(experienceId?: string): BoundBeaconTracker;

package/dist/hooks/use-gate-open.d.ts

@@ -0,0 +1,3 @@
+import * as React from "react";
+export declare const GateOpenAttemptContext: React.Context<Map<number, number> | null>;
+export declare function useGateOpen(opensAt: Date | string | number | null | undefined, onOpen: (() => void) | undefined, random?: () => number): void;

package/dist/index.d.ts

@@ -8,6 +8,7 @@
 export { FanfareProvider } from './provider';
 export type { FanfareProviderProps } from './provider';
 export { useFanfareAuth } from './hooks/use-auth';
+export { useBeaconTracker } from './hooks/use-beacon-tracker';
 export { useExperienceJourney } from './hooks/use-experience-journey';
 export { useFanfare } from './hooks/use-fanfare';
 export { useJourneySnapshot } from './hooks/use-journey-snapshot';