@fanfare-io/fanfare-sdk-react 0.20.0 → 0.21.0

package/README.md

@@ -40,6 +40,16 @@ export function App() {
 }
 ```
 
+`autoStart` routes the journey on mount; entering is a separate matter. A queue, draw or timed
+release the merchant set to enter on arrival needs no Enter click: the SDK enters the consumer
+inside the routing operation that lands on it, and the widget shows a joining wait — no Enter
+control — until they have their place, then the participating screen. If the entry is turned down,
+the widget falls back to the ordinary Enter screen with the refusal beside it. A host that wants
+every entry to stay an explicit press passes `automaticEntry={false}` to `ExperienceWidget`, or the
+same `automaticEntry` option to `useExperienceJourney`; both reach the ready view's `start`, and
+omitting it keeps the SDK default of entering on arrival. The contract is in the core package's
+`docs/UPGRADING-automatic-entry.md` in the SDK repository.
+
 Customization has four levels of increasing specificity: `theme`, `variant`, `slots`, and `children` or `useExperienceJourney`.
 
 `slots` override targeted states while keeping the default widget flow. `children` receives `{ journey, view, snapshot, error, start, isStarting }` when you want to render the full state yourself.

package/dist/components/compositions/outcome-panel.d.ts

@@ -56,6 +56,13 @@ export interface OutcomePanelProps {
     };
     className?: string;
 }
+/**
+ * Re-entry is offered only where the participation ended without the distribution rejecting the
+ * consumer: a lapsed admission (`expired`) or a voluntary exit (`left`). A denial — bot detection,
+ * a validation limit, a draw the consumer simply lost — can leave the distribution open too, so the
+ * eligible reasons are named here rather than inferred from the distribution still accepting entries.
+ */
+export declare function outcomeOffersReentry(outcomeReason: OutcomeReason): boolean;
 export declare function OutcomePanel({ outcomeReason, participationType, onReenter, isReentering, action, copyOverride, className, }: OutcomePanelProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace OutcomePanel {
     var displayName: string;

package/dist/components/widgets/experience-widget.d.ts

@@ -176,6 +176,11 @@ export interface ExperienceWidgetProps {
     experienceId: string;
     /** Automatically start journey on mount */
     autoStart?: boolean;
+    /**
+     * Whether the SDK may enter the consumer on arrival at a distribution the merchant set to enter
+     * automatically. Omit to keep the default (`true`); pass `false` to keep every entry explicit.
+     */
+    automaticEntry?: boolean;
     /** Pre-fill access code */
     accessCode?: string;
     /** Auto-enter waitlist when available */

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

@@ -3,6 +3,12 @@ import { JourneyHandle, JourneySnapshot, JourneyView } from '@fanfare-io/fanfare
 export interface ExperienceJourneyOptions {
     accessCode?: string;
     autoEnterWaitlist?: boolean;
+    /**
+     * Whether core may enter the consumer on the consumer's behalf when routing lands on a
+     * distribution the merchant set to enter on arrival. Left unset, core's default (`true`)
+     * applies; `false` keeps every entry an explicit one the consumer presses.
+     */
+    automaticEntry?: boolean;
 }
 export interface UseExperienceJourneyOptions extends ExperienceJourneyOptions {
     /**