@evelan/jexity-widget 0.14.0 → 0.16.0

package/dist/types/features/chat/components/MagiclineFormMessage.d.ts

@@ -10,10 +10,15 @@ interface MagiclineFormMessageProps {
  * Three states driven by `message.magiclineForm.status`:
  * - `submitted` → read-only success card (NOT re-submittable).
  * - `failed`    → read-only failure card.
- * - `open`      → renders the interactive trial form. v1 is trial-only — the
+ * - `open`      → renders the interactive form: `trialSessionBooking` →
+ *   TrialSessionBookingForm, `contractCreation` → ContractCreationForm. The
  *   dormant `leadApplication` action is intentionally NOT routed (the file stays
  *   on disk but is no longer imported).
  *
+ * `contractCreation` is routed for EVERY status (not just `open`): its submit
+ * action flips the row to `submitted` at claim time, so the form must stay
+ * mounted to render its own result envelope (customer number / terminal notice).
+ *
  * 409 retry: when a `slot_unavailable` 409 reopens the form (status flips
  * back to `open` while the linked submission carries `errorCode === "slot_unavailable"`),
  * the form shows a "pick another time" notice and reloads slots. This is detected

package/dist/types/features/chat/components/MagiclineFormMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MagiclineFormMessage.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MagiclineFormMessage.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAExE,UAAU,yBAAyB;IACjC,OAAO,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;IAC7B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,yBAAyB,uCAyEhG"}
+{"version":3,"file":"MagiclineFormMessage.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MagiclineFormMessage.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAExE,UAAU,yBAAyB;IACjC,OAAO,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;IAC7B,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,yBAAyB,uCAgGhG"}

package/dist/types/features/chat/components/magicline/ContractCreationForm.d.ts

@@ -0,0 +1,34 @@
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+interface ContractCreationFormProps {
+    formMessageId: Id<'conversations'>;
+    sessionId: Id<'contactSessions'>;
+    visitorId: string;
+    projectId: Id<'projects'>;
+    /**
+     * The reactive form-row status. The submit flips this to `submitted` at claim
+     * time, so the LIVE result envelope (held in component state) always wins; this
+     * is only consulted when there is no live result — i.e. a resumed/cold session
+     * landing on an already-terminal row.
+     */
+    formStatus: 'open' | 'submitted' | 'failed';
+}
+/**
+ * Inline Magicline membership-signup STEP WIZARD. Renders the contract-creation
+ * flow as internal steps inside ONE chat card:
+ *
+ *   Offer → Personal → Address → Payment → Review
+ *
+ * All form state (offers, selected term, personal/address/payment fields,
+ * consents, server preview) lives in `useContractCreationState`, mounted ONCE
+ * here above the step switch so navigating steps never refetches offers.
+ *
+ * The submit action is synchronous and authoritative: it claims the submission
+ * (which flips the form row to `submitted` reactively), then dispatches and
+ * returns a result envelope. Because the reactive flip would otherwise unmount
+ * this form mid-await, the component owns its OWN `submitResult` and renders the
+ * success / terminal UI from the returned envelope — `MagiclineFormMessage`
+ * keeps this form mounted while it owns a live result.
+ */
+export declare function ContractCreationForm({ formMessageId, sessionId, visitorId, projectId, formStatus, }: ContractCreationFormProps): import("preact").JSX.Element;
+export {};
+//# sourceMappingURL=ContractCreationForm.d.ts.map

package/dist/types/features/chat/components/magicline/ContractCreationForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContractCreationForm.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/ContractCreationForm.tsx"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAuBnE,UAAU,yBAAyB;IACjC,aAAa,EAAE,EAAE,CAAC,eAAe,CAAC,CAAA;IAClC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,CAAA;IACzB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;CAC5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,aAAa,EACb,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,GACX,EAAE,yBAAyB,gCAgjB3B"}

package/dist/types/features/chat/components/magicline/formUtils.d.ts

@@ -1,3 +1,4 @@
+import type { WidgetStrings } from '../../../../i18n/locales/en';
 export declare function isValidEmail(value: string): boolean;
 /**
  * Whole-years age from an ISO `YYYY-MM-DD` date-of-birth string at `now`.
@@ -20,4 +21,93 @@ export declare function todayIsoDate(now?: Date): string;
  * default.
  */
 export declare function resolvePrivacyUrl(): string;
+/** Strip whitespace and uppercase — the canonical IBAN form for validation. */
+export declare function normalizeIban(raw: string): string;
+/**
+ * Client-side IBAN check mirroring the backend `validateIban` exactly:
+ *   1. length against the per-country table (or the generic 15–34 bound);
+ *   2. the ISO 13616 mod-97 check (move first 4 chars to the end, expand
+ *      letters A=10..Z=35, chunked reduction to stay in safe-integer range).
+ *
+ * Pure UX gate — the backend re-validates. The raw IBAN is never logged here.
+ */
+export declare function isValidIban(raw: string): boolean;
+/**
+ * Mask an IBAN for the review summary: show the first 4 and last 4 characters
+ * of the normalized value, bullets in between, regrouped into 4-char blocks.
+ * e.g. `DE89 3704 0044 0532 0130 00` → `DE89 •••• •••• •••• •••• 00`. Used for
+ * display ONLY — the raw IBAN never leaves component memory through this path.
+ */
+export declare function maskIban(raw: string): string;
+/**
+ * Format a Magicline money amount with its currency code, localised to the
+ * widget locale. Magicline rate-bundle / flat-fee prices are decimal MAJOR
+ * units (e.g. `29` → "29,00 €"), so the value is rendered as-is — never divided.
+ * Falls back to a bare numeric string when the currency code is unsupported by
+ * the runtime's `Intl`.
+ */
+export declare function formatContractMoney(amount: number, currencyCode: string, widgetLocale: 'en' | 'de'): string;
+/**
+ * Localised "{value} {unit}" period label, e.g. "12 months" / "12 Monate". The
+ * Magicline period unit is an uppercase enum (`DAY` / `WEEK` / `MONTH` / `YEAR`);
+ * unknown units fall back to a lowercased raw unit so the label degrades safely.
+ */
+export declare function formatContractPeriod(value: number, unit: string, widgetLocale: 'en' | 'de'): string;
+/**
+ * Format an ISO date (`YYYY-MM-DD` or a full datetime) for display in the
+ * review summary, localised to the widget locale. Falls back to the raw value
+ * when unparseable so a malformed start date never blanks the summary row.
+ */
+export declare function formatContractDate(isoDate: string, widgetLocale: 'en' | 'de'): string;
+/**
+ * Recurring-price frequency suffix for a rate-bundle term price, e.g.
+ * "per week" / "pro Woche" (value === 1) or "every 3 weeks" / "alle 3 Wochen"
+ * (value > 1). Used as a suffix after a formatted money amount in offer cards
+ * and the review base-price line.
+ *
+ * Supported units: DAY / WEEK / MONTH / YEAR (Magicline uppercase enum).
+ * Unknown units fall back to a lowercased raw unit so the label degrades safely.
+ */
+export declare function formatPaymentFrequency(value: number, unit: string, widgetLocale: 'en' | 'de'): string;
+/**
+ * Formatted price label for an optional module, combining the money amount with
+ * the appropriate frequency or type suffix. Mirrors Fit Inn's formatPriceLabel.
+ *
+ * paymentFrequencyType values:
+ *   "TERM_BASED"     → "{money} per term"
+ *   "RECURRING"      → "{money} " + formatPaymentFrequency(1, recurringUnit)
+ *   "NON_RECURRING"  → "{money} one-time"
+ *   "MONTH_DAY"      → "{money} one-time"
+ *   "FREE"           → "included"
+ *   null / other     → bare money string
+ */
+export declare function formatModulePrice(amount: number, currencyCode: string, paymentFrequencyType: string | null, recurringUnit: string | null, widgetLocale: 'en' | 'de'): string;
+/**
+ * Formatted voucher discount label. PERCENTAGE type produces "-{value}%";
+ * AMOUNT type produces "-{formatted money}" via `formatContractMoney`.
+ *
+ * Used in the Review step to show the active voucher's saving alongside the
+ * discounted base price.
+ */
+export declare function formatVoucherDiscount(discountValue: number, discountType: 'AMOUNT' | 'PERCENTAGE', currencyCode: string, locale: 'en' | 'de'): string;
+/**
+ * Localize a raw Magicline flat-fee name. When the normalized name is in the
+ * known-fee map, the locale string for that key is returned. Otherwise the
+ * original raw name is returned unchanged so unmapped fees degrade safely.
+ */
+export declare function localizeFeeName(rawName: string, t: WidgetStrings): string;
+/**
+ * Renewal label for an optional module extension type. Returns an empty string
+ * when the type produces no visible renewal line (SUBSEQUENT_RATE_DETAIL, null).
+ *
+ * extensionType values:
+ *   "NONE"                  → "No automatic renewal"
+ *   "TERM_EXTENSION"        → "Renewal: {n} {unit}" (via the period table)
+ *   "SUBSEQUENT_RATE_DETAIL"→ "" (no line rendered)
+ *   null                    → "" (no line rendered)
+ */
+export declare function formatModuleRenewal(extensionType: string | null, termExtension: {
+    value: number;
+    unit: string;
+} | null, widgetLocale: 'en' | 'de'): string;
 //# sourceMappingURL=formUtils.d.ts.map

package/dist/types/features/chat/components/magicline/formUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formUtils.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/formUtils.ts"],"names":[],"mappings":"AAKA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CA8BrF;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C"}
+{"version":3,"file":"formUtils.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/formUtils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAQhE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CA8BrF;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AA4BD,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgChD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS5C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,IAAI,GAAG,IAAI,GACxB,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,IAAI,GAAG,IAAI,GACxB,MAAM,CAcR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAWrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,IAAI,GAAG,IAAI,GACxB,MAAM,CAuBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,YAAY,EAAE,IAAI,GAAG,IAAI,GACxB,MAAM,CAmBR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,QAAQ,GAAG,YAAY,EACrC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,IAAI,GAAG,IAAI,GAClB,MAAM,CAKR;AAeD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAOzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACrD,YAAY,EAAE,IAAI,GAAG,IAAI,GACxB,MAAM,CAYR"}

package/dist/types/features/chat/components/magicline/useContractCreationState.d.ts

@@ -0,0 +1,250 @@
+import { type ContractFlatFee, type ContractPeriod, type ContractPreviewModule, type ContractVolume, type ContractVoucher, type RateBundleTermCard } from '../../hooks/useMagicline';
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+/**
+ * Offers lifecycle. `empty` (healthy, zero eligible terms) is split from
+ * `error` (unavailable / network rejection) so the Offer step shows a friendly
+ * no-offers message on `empty` and a Retry affordance on `error`.
+ */
+export type OffersState = {
+    phase: 'loading';
+} | {
+    phase: 'ready';
+    terms: RateBundleTermCard[];
+    allowVoucherCodes: boolean;
+} | {
+    phase: 'empty';
+} | {
+    phase: 'error';
+};
+/**
+ * Server-resolved pricing for the Review step. Fetched on entering Review and
+ * re-fetched after a `price_changed` outcome. The `fingerprint` is replayed to
+ * the submit action so the backend can confirm the price the visitor saw.
+ */
+export interface ContractPricing {
+    basePrice: number;
+    preUseCharge: number;
+    currencyCode: string;
+    flatFees: ContractFlatFee[];
+    modules: ContractPreviewModule[];
+    contractVolume: ContractVolume | null;
+    startDate: string;
+    /** Payment frequency of the revalidated term; renders the base-price period. */
+    paymentFrequency: ContractPeriod;
+    fingerprint: string;
+}
+/**
+ * Preview lifecycle. `idle` is the pre-Review state (no fetch yet). A non-ok
+ * preview status is surfaced as the `error` phase carrying the status code so
+ * the view can route an `offer_unavailable` back to the Offer step.
+ */
+export type PreviewState = {
+    phase: 'idle';
+} | {
+    phase: 'loading';
+} | {
+    phase: 'reloading';
+    pricing: ContractPricing;
+} | {
+    phase: 'ready';
+    pricing: ContractPricing;
+} | {
+    phase: 'error';
+    code: 'consent_required' | 'invalid_fields' | 'offer_unavailable' | 'unavailable';
+};
+/** Personal detail fields — all required by the backend. */
+export interface ContractPersonalFields {
+    firstName: string;
+    lastName: string;
+    email: string;
+    dateOfBirth: string;
+    gender: string;
+    phone: string;
+}
+/** Address fields — country is a static "Deutschland"/"Germany", not collected. */
+export interface ContractAddressFields {
+    street: string;
+    houseNumber: string;
+    zipCode: string;
+    city: string;
+}
+/**
+ * Payment fields. `accountHolderTouched` tracks whether the visitor has edited
+ * the account holder so the firstname+lastname prefill only auto-fills once and
+ * never clobbers a manual edit. The IBAN lives ONLY here, in memory — it is
+ * never persisted to sessionStorage and never logged.
+ */
+export interface ContractPaymentFields {
+    accountHolder: string;
+    accountHolderTouched: boolean;
+    iban: string;
+}
+/** Consent flags — both must be accepted before submit. */
+export interface ContractConsentFields {
+    privacy: boolean;
+    sepa: boolean;
+}
+export interface ContractFormFields {
+    termId: number | null;
+    /** Chosen paid optional-module ids for the current term. */
+    selectedModuleIds: number[];
+    /**
+     * Acceptance of required confirmations, keyed by ackKey. Carries both contract
+     * text-block acknowledgements and selected-module consents — a single source
+     * of truth for every gating tick across the wizard.
+     */
+    acknowledgedBlocks: Record<string, boolean>;
+    personal: ContractPersonalFields;
+    address: ContractAddressFields;
+    payment: ContractPaymentFields;
+    consents: ContractConsentFields;
+}
+/**
+ * Lifecycle status for an in-progress or resolved voucher application.
+ * - `idle` — no voucher attempt yet (or after CLEAR_VOUCHER).
+ * - `applying` — backend call in-flight.
+ * - `applied` — a valid voucher is active and its discount shows in the quote.
+ * - `invalid` — the code was rejected by the backend (`voucher_invalid`).
+ * - `disabled` — vouchers are turned off for this studio (`voucher_disabled`).
+ */
+export type VoucherStatus = 'idle' | 'applying' | 'applied' | 'invalid' | 'disabled';
+/**
+ * All mutable voucher fields held alongside the contract form. Kept in a
+ * dedicated reducer so voucher concerns are isolated and easy to delete.
+ *
+ * `voucherUnavailable` is session-sticky: once the backend returns
+ * `voucher_disabled`, no further voucher UI is shown for this session.
+ *
+ * `voucherRequestId` is a monotonic counter bumped on every VOUCHER_APPLYING
+ * dispatch. VOUCHER_APPLIED checks payload.requestId === state.voucherRequestId
+ * before committing — any response carrying a stale id is silently discarded.
+ */
+export interface VoucherState {
+    /** The string the visitor is currently typing into the voucher input. */
+    draftVoucherCode: string;
+    /**
+     * The code that was sent with the last successful preview fetch. Only set
+     * when `voucherStatus === 'applied'`; cleared on any invalidation.
+     */
+    appliedVoucherCode: string | null;
+    /**
+     * The parsed voucher block from the last successful apply response. Mirrors
+     * `ContractVoucher` from `useMagicline` (excludes null — null means cleared).
+     */
+    appliedVoucher: Exclude<ContractVoucher, null> | null;
+    /** Current lifecycle status of the voucher attempt. */
+    voucherStatus: VoucherStatus;
+    /**
+     * Monotonic counter. Bumped by VOUCHER_APPLYING; VOUCHER_APPLIED only commits
+     * when the payload requestId matches this value (stale-response discard).
+     */
+    voucherRequestId: number;
+    /**
+     * Session-sticky flag. Set to `true` on VOUCHER_DISABLED and never cleared.
+     * The UI uses this to permanently hide the voucher entry once the studio has
+     * disabled vouchers.
+     */
+    voucherUnavailable: boolean;
+}
+export interface UseContractCreationStateOptions {
+    sessionId: Id<'contactSessions'>;
+    visitorId: string;
+}
+export interface ContractCreationState {
+    fields: ContractFormFields;
+    offersState: OffersState;
+    previewState: PreviewState;
+    /** The currently selected term card (or null when none is chosen). */
+    selectedTerm: RateBundleTermCard | null;
+    /**
+     * ackKeys that MUST be acknowledged before submit for the current term:
+     * required text blocks ∪ the consents of SELECTED modules that carry one
+     * ∪ any voucher text-block acks (when a voucher is applied).
+     */
+    requiredAckKeys: string[];
+    /** True when every `requiredAckKeys` entry is currently acknowledged. */
+    allAcknowledged: boolean;
+    /** Current voucher lifecycle status. */
+    voucherStatus: VoucherStatus;
+    /** The string currently typed into the voucher input. */
+    draftVoucherCode: string;
+    /** The code tied to the currently displayed quote (set when `voucherStatus === 'applied'`). */
+    appliedVoucherCode: string | null;
+    /**
+     * Parsed voucher block from the last successful apply. Non-null only when
+     * `voucherStatus === 'applied'`.
+     */
+    appliedVoucher: Exclude<ContractVoucher, null> | null;
+    /**
+     * Session-sticky: true once the backend has returned `voucher_disabled`.
+     * The UI hides the voucher section permanently when this is true.
+     */
+    voucherUnavailable: boolean;
+    setTermId: (termId: number) => void;
+    setPersonal: (key: keyof ContractPersonalFields, value: string) => void;
+    setAddress: (key: keyof ContractAddressFields, value: string) => void;
+    /**
+     * Add/remove a paid optional module from the current term. Pass the module's
+     * consent ackKey so deselecting clears its acknowledgement in one dispatch.
+     */
+    toggleModule: (moduleId: number, selected: boolean, consentAckKey?: string) => void;
+    /** Set the acknowledgement for a contract block or module consent by ackKey. */
+    setBlockAck: (ackKey: string, value: boolean) => void;
+    setAccountHolder: (value: string) => void;
+    setIban: (value: string) => void;
+    setConsent: (key: keyof ContractConsentFields, value: boolean) => void;
+    clearIban: () => void;
+    /** Clears the selected term so a stale selection does not survive an offer refetch. */
+    clearTermId: () => void;
+    /** Re-run the offers fetch (Retry button + `offer_unavailable` recovery). */
+    refetchOffers: () => void;
+    /** Fetch the server pricing for the selected term (called entering Review). */
+    fetchPreview: () => void;
+    /** Reset the preview back to idle (e.g. when leaving Review). */
+    resetPreview: () => void;
+    /** Update the voucher input field. Clears any currently applied voucher. */
+    setVoucherDraft: (value: string) => void;
+    /**
+     * Signal that the voucher backend call is starting. Bumps `voucherRequestId`
+     * to enable stale-response discard for any concurrent in-flight request.
+     * Returns the new requestId so the caller can include it in the VOUCHER_APPLIED
+     * dispatch.
+     */
+    beginVoucherApply: () => number;
+    /**
+     * Commit a successful voucher response. Only takes effect if `requestId`
+     * matches the latest (stale responses are silently discarded). Updates
+     * `previewState.pricing` to the voucher-inclusive pricing from the apply
+     * response (fingerprint + discounted amounts) and seeds voucher ackKeys into
+     * `acknowledgedBlocks` as unticked.
+     */
+    commitVoucherApplied: (options: {
+        requestId: number;
+        voucher: Exclude<ContractVoucher, null>;
+        appliedCode: string;
+        voucherAckKeys: string[];
+        /** Voucher-inclusive pricing from the same getContractPreview response. */
+        pricing: ContractPricing;
+    }) => void;
+    /** Mark the current code as invalid and clear the applied state. */
+    markVoucherInvalid: () => void;
+    /** Mark vouchers as disabled for this session (session-sticky). */
+    markVoucherDisabled: () => void;
+    /** Remove the applied voucher and revert to a no-voucher quote. */
+    clearVoucher: () => void;
+}
+/**
+ * Single fetch-once container for the membership-signup wizard.
+ *
+ * - Offers are fetched ONCE on mount and again on `refetchOffers` (Retry /
+ *   `offer_unavailable` recovery). A `offersKey` counter drives the effect.
+ * - The preview is NOT fetched until `fetchPreview` runs (entering Review). A
+ *   `previewKey` counter re-runs it for `price_changed` recovery.
+ * - The account holder auto-prefills from firstname+lastname the first time both
+ *   are present and the field is still untouched.
+ *
+ * The IBAN is held only in this hook's in-memory reducer state — it is never
+ * written to sessionStorage and never logged.
+ */
+export declare function useContractCreationState({ sessionId, visitorId, }: UseContractCreationStateOptions): ContractCreationState;
+//# sourceMappingURL=useContractCreationState.d.ts.map

package/dist/types/features/chat/components/magicline/useContractCreationState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContractCreationState.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/useContractCreationState.ts"],"names":[],"mappings":"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"}