@fanfare-io/fanfare-sdk-solid 0.9.0 → 0.11.0

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

@@ -1,5 +1,5 @@
 export { AlertPanel, type AlertPanelProps } from './alert-panel';
 export { InfoPanel, type InfoPanelProps } from './info-panel';
-export { normalizeOutcomeReason, type OutcomeReason } from './outcome-reason';
+export { normalizeOutcomeReason, normalizeSequenceOutcomeReason, type OutcomeReason } from './outcome-reason';
 export { PanelHeading, type PanelHeadingProps, type PanelHeadingVariant } from './panel-heading';
 export { PanelBody, PanelFooter, PanelLayout, type PanelBodyProps, type PanelFooterProps, type PanelLayoutProps, } from './panel-layout';

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/hooks/index.d.ts

@@ -6,6 +6,7 @@
  * @packageDocumentation
  */
 export { useFanfareAuth } from './use-auth';
+export { createBeaconTracker } from './use-beacon-tracker';
 export { useExperienceJourney } from './use-experience-journey';
 export type { ExperienceJourneyOptions, UseExperienceJourneyOptions, UseExperienceJourneyResult, } from './use-experience-journey';
 export { useJourneySnapshot } from './use-journey-snapshot';

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

@@ -4,6 +4,7 @@ export declare function useFanfareAuth(): {
     isAuthenticated: import('solid-js').Accessor<boolean>;
     isGuest: import('solid-js').Accessor<boolean | undefined>;
     session: import('solid-js').Accessor<import('@fanfare-io/fanfare-sdk-core/auth').Session | undefined>;
+    identityExpiresAt: import('solid-js').Accessor<string | undefined>;
     guest: () => Promise<import('@fanfare-io/fanfare-sdk-core/auth').GuestSession>;
     requestOtp: (options: OtpRequest) => Promise<void>;
     verifyOtp: (options: OtpVerify) => Promise<import('@fanfare-io/fanfare-sdk-core/auth').AuthenticatedSession>;

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

@@ -0,0 +1,28 @@
+import { BoundBeaconTracker } from '@fanfare-io/fanfare-sdk-core/beacon';
+import { Accessor } from 'solid-js';
+/**
+ * Experience currently rendering around the consumer, as an accessor.
+ * `ExperienceWidget` publishes its `experienceId` here so descendants (slots,
+ * render-prop children, storefront components) can attribute beacon events
+ * without threading the id through props. It is an accessor, not a bare string,
+ * because Solid runs component setup once: a tracker must read the value at
+ * track time so a later change to the widget's `experienceId` prop is honored.
+ * Returns `null` outside any experience.
+ */
+export declare const ExperienceIdContext: import('solid-js').Context<Accessor<string | null>>;
+/**
+ * Creates 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.
+ *
+ * The bound experience is resolved at each `track`/`trackBatch` call, so if the
+ * enclosing widget's `experienceId` changes, subsequent events follow it.
+ *
+ * @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 createBeaconTracker(experienceId?: string): BoundBeaconTracker;

package/dist/hooks/use-experience-journey.d.ts

@@ -1,3 +1,4 @@
+import { FanfareError } from '@fanfare-io/fanfare-sdk-core/errors';
 import { JourneyHandle, JourneySnapshot, JourneyView } from '@fanfare-io/fanfare-sdk-core/experiences';
 import { MaybeAccessor } from '../utils/to-accessor';
 export interface ExperienceJourneyOptions {
@@ -12,6 +13,7 @@ export interface UseExperienceJourneyResult {
     view: () => JourneyView | null;
     snapshot: () => JourneySnapshot | null;
     error: () => string | null;
+    fanfareError: () => FanfareError | null;
     start: (options?: ExperienceJourneyOptions) => Promise<JourneyView>;
 }
 export declare function useExperienceJourney(experienceId: MaybeAccessor<string | undefined>, options?: UseExperienceJourneyOptions): UseExperienceJourneyResult;

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  */
 export { FanfareProvider, useFanfare } from './components/provider';
 export type { FanfareProviderProps } from './components/provider';
-export { useExperienceJourney, useFanfareAuth, useJourneySnapshot, useNanostore } from './hooks';
+export { createBeaconTracker, useExperienceJourney, useFanfareAuth, useJourneySnapshot, useNanostore } from './hooks';
 export { I18nProvider, RTL_LOCALES, isRTLLocale, useTranslations } from './i18n';
 export type { I18nConfig, I18nProviderProps, Locale, PartialTranslationMessages, RTLLocale, TextDirection, TranslateFunction, TranslateOptions, TranslationKey, TranslationMessageKey, TranslationMessages, } from './i18n';
 export { THEME_CSS_VARS, ThemeProvider, buildThemeCssVars } from './theme';