@evelan/jexity-widget 0.13.1 → 0.15.0

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

@@ -0,0 +1,34 @@
+import type { Doc, Id } from '@repo/backend/convex/_generated/dataModel';
+interface MagiclineFormMessageProps {
+    message: Doc<'conversations'>;
+    sessionId: Id<'contactSessions'>;
+    visitorId: string;
+}
+/**
+ * Inline Magicline integration form rendered inside the chat thread.
+ *
+ * Three states driven by `message.magiclineForm.status`:
+ * - `submitted` → read-only success card (NOT re-submittable).
+ * - `failed`    → read-only failure card.
+ * - `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
+ * by reading `getSubmissionStatus` only when the form is `open` AND a
+ * `submissionId` is present (otherwise the query is skipped).
+ *
+ * Mirrors FormMessage (escalation): reads the row, renders read-only when the
+ * backend has flipped the status, otherwise renders the interactive form. The
+ * form's own submit handler additionally guards against double-submit.
+ */
+export declare function MagiclineFormMessage({ message, sessionId, visitorId }: MagiclineFormMessageProps): import("preact").JSX.Element | null;
+export {};
+//# sourceMappingURL=MagiclineFormMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"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/MessageList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MessageList.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAgBxE,UAAU,gBAAgB;IACxB,aAAa,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,GAAG,SAAS,CAAA;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,iDAAiD;IACjD,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,gBAAgB,gCA0J3I"}
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MessageList.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAgBxE,UAAU,gBAAgB;IACxB,aAAa,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,GAAG,SAAS,CAAA;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,iDAAiD;IACjD,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,gBAAgB,gCA6J3I"}

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":"AAkCA,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,gCAqb3B"}

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

@@ -0,0 +1,34 @@
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+interface TrialSessionBookingFormProps {
+    formMessageId: Id<'conversations'>;
+    sessionId: Id<'contactSessions'>;
+    visitorId: string;
+    /** Set when the form was reopened after a `slot_unavailable` 409. */
+    slotUnavailable?: boolean;
+    /**
+     * True while the 409 retry-status query is still resolving. The Slot
+     * step waits for this to clear before deciding its UI so a reopened form
+     * doesn't flash "no slots" before the slot-unavailable notice resolves.
+     */
+    retryPending?: boolean;
+}
+/**
+ * Inline Magicline trial-session booking STEP WIZARD. Renders the
+ * dynamic per-studio form as internal steps inside ONE chat card:
+ *
+ *   Trainer → Slot → Personal → Address → Confirm
+ *
+ * Steps with no visible fields are auto-skipped (see `buildWizardSteps`). The
+ * trainer step is shown only when the studio allows trainer-free bookings.
+ *
+ * State (config, slots, all field values) is lifted into `useTrialBookingState`
+ * which is mounted ONCE here, above the step switch — so navigating between
+ * steps never refetches config or slots. Config is fetched once on open;
+ * slots are fetched on open and whenever the trainer choice changes.
+ *
+ * The selected slot's `startDateTime` is sent as the `slotId` field — the
+ * backend transformer maps `slotId` → Magicline `startDateTime`.
+ */
+export declare function TrialSessionBookingForm({ formMessageId, sessionId, visitorId, slotUnavailable, retryPending, }: TrialSessionBookingFormProps): import("preact").JSX.Element;
+export {};
+//# sourceMappingURL=TrialSessionBookingForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TrialSessionBookingForm.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/TrialSessionBookingForm.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,4BAA4B;IACpC,aAAa,EAAE,EAAE,CAAC,eAAe,CAAC,CAAA;IAClC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,aAAa,EACb,SAAS,EACT,SAAS,EACT,eAAuB,EACvB,YAAoB,GACrB,EAAE,4BAA4B,gCA2C9B"}

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

@@ -0,0 +1,26 @@
+import type { TrialConfigPlan } from '../../hooks/useMagicline';
+/**
+ * Ordered wizard step identifiers. The widget renders these as internal steps
+ * inside ONE card (not one chat message per step).
+ */
+export type WizardStep = 'trainer' | 'slot' | 'personal' | 'address' | 'confirm';
+/**
+ * Pure helper — resolves the ordered list of VISIBLE wizard steps for a studio
+ * plan. Steps with no visible fields are skipped so the visitor never lands on
+ * an empty page and the "Step n of N" counter shrinks accordingly.
+ *
+ * Skip rules:
+ * - `trainer`  — skipped unless the studio allows trainer-free bookings
+ *   (`bookingWithoutTrainerAllowed === true`); otherwise the choice is forced
+ *   and there is nothing to ask.
+ * - `slot`     — always shown (a slot is mandatory).
+ * - `personal` — always shown (firstname/lastname are always visible+required).
+ * - `address`  — skipped when neither the address group nor the zip field is
+ *   visible per the plan.
+ * - `confirm`  — always shown (note + consent + summary + submit).
+ *
+ * Visibility is derived ONLY from the same `plan` the fields use — no second
+ * source of truth.
+ */
+export declare function buildWizardSteps(plan: TrialConfigPlan, bookingWithoutTrainerAllowed: boolean): WizardStep[];
+//# sourceMappingURL=buildWizardSteps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildWizardSteps.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/buildWizardSteps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,4BAA4B,EAAE,OAAO,GACpC,UAAU,EAAE,CAYd"}

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

@@ -0,0 +1,105 @@
+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`.
+ * Returns `null` when the value is empty or unparseable (callers treat a null
+ * age as "not yet entered", deferring to required-field handling). Client-side
+ * UX only — the backend re-validates minimum age against the studio plan.
+ *
+ * The Y/M/D parts are parsed manually via `split('-')` instead of
+ * `new Date('YYYY-MM-DD')`. The string form is parsed as UTC midnight, so
+ * comparing it with LOCAL getters (`now.getDate()` etc.) shifts the day by one
+ * in negative-offset timezones and mis-gates min-age on the birthday boundary.
+ * Parsing the parts directly keeps the comparison purely calendar-based.
+ */
+export declare function ageFromIsoDate(isoDate: string, now?: Date): number | null;
+/** Today's date as an ISO `YYYY-MM-DD` string in LOCAL time (for `<input max>`). */
+export declare function todayIsoDate(now?: Date): string;
+/**
+ * Resolve the privacy-policy URL the same way FormMessage does: prefer the
+ * org-configured URL when it is absolute, otherwise fall back to the platform
+ * 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;
+/**
+ * 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

@@ -0,0 +1 @@
+{"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;;;;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/magiclineConstants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Widget-side Magicline constants. The widget cannot import the backend
+ * `model.ts` (it is bundled separately), so the controlled `<select>` enums are
+ * mirrored here. Every value below is a member of the backend `GENDER_ENUM` /
+ * `COUNTRY_ENUM` so a submission re-validates server-side without surprises.
+ */
+/** Magicline gender enum (controlled select). Mirrors backend `GENDER_ENUM`. */
+export declare const GENDER_VALUES: readonly ["MALE", "FEMALE", "UNISEX"];
+export type GenderValue = (typeof GENDER_VALUES)[number];
+/**
+ * Curated subset of the backend `COUNTRY_ENUM` for the country `<select>`.
+ * Magicline's full enum has 250+ ISO codes; surfacing all of them in a widget
+ * dropdown is poor UX. We ship the DACH region plus common neighbours — every
+ * code here is a valid `COUNTRY_ENUM` member, so the server-side check passes.
+ */
+export interface CountryOption {
+    code: string;
+    label: string;
+}
+export declare const COUNTRY_OPTIONS: readonly CountryOption[];
+//# sourceMappingURL=magiclineConstants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"magiclineConstants.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/magiclineConstants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,eAAO,MAAM,aAAa,uCAAwC,CAAA;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAgB1C,CAAA"}

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

@@ -0,0 +1,152 @@
+import { type ContractFlatFee, type ContractPeriod, type ContractPreviewModule, type ContractVolume, 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[];
+} | {
+    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: '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;
+}
+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.
+     */
+    requiredAckKeys: string[];
+    /** True when every `requiredAckKeys` entry is currently acknowledged. */
+    allAcknowledged: 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;
+}
+/**
+ * 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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"}

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

@@ -0,0 +1,87 @@
+import { type TrialConfigPlan, type TrialSlot } from '../../hooks/useMagicline';
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+/** Resolved per-studio config (only present once the fetch succeeds). */
+export interface ResolvedConfig {
+    plan: TrialConfigPlan;
+    minimumAge: number;
+    bookingWithoutTrainerAllowed: boolean;
+    /** Studio IANA timezone (or null) — used to display bare-UTC slot times. */
+    studioZoneId: string | null;
+}
+/**
+ * Config status as a CODE, not a resolved message. The view resolves the
+ * code to a localised string at render time so a locale toggle mid-fill never
+ * re-runs the config fetch and never nukes the filled form to an error card.
+ */
+export type ConfigStatusCode = 'unsupported' | 'inconsistent' | 'unavailable';
+export type ConfigState = {
+    phase: 'loading';
+} | {
+    phase: 'ready';
+    config: ResolvedConfig;
+} | {
+    phase: 'error';
+    code: ConfigStatusCode;
+    backendMessage: string;
+};
+/**
+ * Slots lifecycle. `empty` (healthy, zero availability) is split from
+ * `error` (unavailable / network_error / rejection) so the Slot step can show
+ * a Retry affordance on `error` and a no-slots message on `empty`.
+ */
+export type SlotsState = {
+    phase: 'loading';
+} | {
+    phase: 'ready';
+    slots: TrialSlot[];
+} | {
+    phase: 'empty';
+} | {
+    phase: 'error';
+};
+/** The flat field bag — all controlled inputs default to "". */
+export interface TrialFormFields {
+    firstName: string;
+    lastName: string;
+    email: string;
+    phone: string;
+    birthDate: string;
+    gender: string;
+    street: string;
+    houseNumber: string;
+    zip: string;
+    city: string;
+    country: string;
+    note: string;
+    slotId: string;
+    consent: boolean;
+    /** Trainer required defaults to TRUE (safest); preselected "with trainer". */
+    trainerRequired: boolean;
+}
+export interface UseTrialBookingStateOptions {
+    sessionId: Id<'contactSessions'>;
+    visitorId: string;
+}
+export interface TrialBookingState {
+    fields: TrialFormFields;
+    setField: (key: keyof TrialFormFields, value: string | boolean) => void;
+    setTrainerRequired: (trainerRequired: boolean) => void;
+    configState: ConfigState;
+    slotsState: SlotsState;
+    /** Re-fetch slots with the current `trainerRequired` (Retry button). */
+    refetchSlots: () => void;
+}
+/**
+ * Single fetch-once container for the trial-booking wizard.
+ *
+ * - Config is fetched ONCE on mount. A locale toggle does NOT re-fetch it
+ *   (no `t` in deps; status stored as a code).
+ * - Slots are fetched once config is ready and again whenever `trainerRequired`
+ *   flips OR `refetchSlots` is called. A `refreshKey` counter drives the slot
+ *   effect so the Retry button can re-run it without other deps changing.
+ * - Wizard STEP components read this shared state — mounting a step never
+ *   re-fetches config or slots (the fetches live on this single hook instance,
+ *   which is mounted once by the container, above the step switch).
+ */
+export declare function useTrialBookingState({ sessionId, visitorId, }: UseTrialBookingStateOptions): TrialBookingState;
+//# sourceMappingURL=useTrialBookingState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTrialBookingState.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/components/magicline/useTrialBookingState.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,SAAS,EACf,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,4BAA4B,EAAE,OAAO,CAAA;IACrC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,cAAc,GAAG,aAAa,CAAA;AAE7E,MAAM,MAAM,WAAW,GACnB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GACpB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GACpB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAClB;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEtB,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAA;CACzB;AAiDD,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,KAAK,IAAI,CAAA;IACvE,kBAAkB,EAAE,CAAC,eAAe,EAAE,OAAO,KAAK,IAAI,CAAA;IACtD,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;IACtB,wEAAwE;IACxE,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,SAAS,EACT,SAAS,GACV,EAAE,2BAA2B,GAAG,iBAAiB,CAoHjD"}