@forgebuild/hotal-ui 0.23.203 → 0.23.204

package/dist/index.d.ts

@@ -421,10 +421,32 @@ export interface SpaBookingPayload {
 	email: string;
 	phone: string;
 	notes: string;
+	/** The PaymentIntent confirmed on the Details step -- only present when
+	 *  payment is enabled (stripePublishableKey + createPaymentIntent). Verify
+	 *  its status and amount server-side before booking, and refund/cancel it
+	 *  if the booking is then rejected. */
+	stripePaymentIntentId?: string;
 }
 
 export type SpaBookingResult = { ok: true } | { ok: false; error?: string };
 
+/** The slot a spa PaymentIntent is created for -- the host prices it. */
+export interface SpaPaymentIntentRequest {
+	treatmentId: string;
+	date: string;
+	time: string;
+	therapistId?: string;
+}
+
+export interface SpaPaymentIntentResult {
+	clientSecret: string;
+	paymentIntentId: string;
+	/** The intent's amount (Stripe integer units) and currency, shown as
+	 *  "£X due now" above the card form. Omit either to show no amount. */
+	amount?: number;
+	currency?: string;
+}
+
 export interface SpaBookingWidgetStrings {
 	chooseServiceLabel: string;
 	loadingServices: string;
@@ -440,6 +462,7 @@ export interface SpaBookingWidgetStrings {
 	therapistFilterLabel: string;
 	anyTherapistLabel: string;
 	staffRowLabel: string;
+	bookedAtLabel: string;
 	totalLabel: string;
 	continueLabel: string;
 	changeServiceLabel: string;
@@ -462,6 +485,13 @@ export interface SpaBookingWidgetStrings {
 	memberRateLabel: string;
 	membersOnlyLabel: string;
 	membersOnlyHint: string;
+	paymentLabel: string;
+	paymentDueLabel: string;
+	paymentHint: string;
+	paymentUnavailable: string;
+	paymentNotReady: string;
+	paymentFailed: string;
+	confirmPayLabel: string;
 }
 
 export interface SpaBookingWidgetElement extends HTMLElement {
@@ -523,6 +553,16 @@ export interface SpaBookingWidgetElement extends HTMLElement {
 	 *  undefined on "Any therapist" or when fetchTherapists was never provided. */
 	fetchAvailability?: (fromISO: string, toISO: string, treatmentId: string, therapistId?: string) => Promise<SpaAvailabilityDay[]>;
 	submitBooking?: (payload: SpaBookingPayload) => Promise<SpaBookingResult>;
+	/** Optional payment: with both this and stripePublishableKey set, the
+	 *  Details step shows a Stripe Payment Element and confirms it before
+	 *  submitBooking (which then gets stripePaymentIntentId). The host's
+	 *  intent decides full charge, deposit, or manual-capture hold. Called
+	 *  on entering Details, and again if the visitor picks a different slot
+	 *  before paying. Unused in skipDetailsStep mode. JS property only. */
+	createPaymentIntent?: (req: SpaPaymentIntentRequest) => Promise<SpaPaymentIntentResult>;
+	stripePublishableKey?: string;
+	/** Stripe Elements `appearance` object. JS property only. */
+	stripeAppearance?: Record<string, unknown>;
 }
 
 export interface ReservationCancelPayload {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgebuild/hotal-ui",
-  "version": "0.23.203",
+  "version": "0.23.204",
   "description": "Reusable Svelte UI components for booking and reservation experiences.",
   "type": "module",
   "license": "MIT",