@bookr-cl/widget 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,317 @@
+import * as react from 'react';
+
+interface ApiConfig {
+    apiBase: string;
+    apiKey: string;
+}
+interface Location {
+    id: string;
+    name: string;
+    address?: string;
+}
+interface Service {
+    id: string;
+    name: string;
+    price: string;
+    duration: number;
+    price_variants?: Record<string, number> | null;
+}
+interface Provider {
+    id: string;
+    public_name: string;
+}
+/** A bookable slot from GET /v1/available-slots. */
+interface Slot {
+    start_time: string;
+    end_time: string;
+    provider_id: string;
+    provider_name: string;
+    service_name?: string;
+    title?: string;
+    description?: string;
+    capacity?: number;
+    enrolled_count?: number;
+    class_session_id?: string;
+}
+interface ClientProfile {
+    id: string;
+    first_name: string;
+    last_name: string;
+    email: string | null;
+    phone: string | null;
+}
+interface BookingRecord {
+    id: string;
+    start_time: string;
+    end_time: string;
+    service_name: string;
+    provider_name: string;
+    payment_status: string;
+    price: string;
+    status?: {
+        id: string;
+        name: string;
+    };
+    approval_status?: string | null;
+}
+interface PackageRecord {
+    id: string;
+    service_name: string;
+    total_credits: number;
+    used_credits: number;
+    remaining_credits: number;
+    expiration_date: string;
+}
+interface ClientFormValues {
+    firstName: string;
+    lastName: string;
+    email: string;
+    phone: string;
+    rut: string;
+}
+interface BookingCreateInput {
+    start_time: string;
+    end_time: string;
+    service_id: string;
+    service_provider_id: string;
+    location_id: string;
+    price?: string;
+    notes?: string;
+    /** Only honored by the server when a client/staff auth token is sent alongside. */
+    client_id?: string;
+    /** Contact fields the server uses to find-or-create the client when no auth token is present. */
+    client_first_name?: string;
+    client_last_name?: string;
+    client_email?: string;
+    client_phone?: string;
+    client_rut?: string;
+}
+/** Result of a booking attempt — callers branch on `.ok` instead of parsing
+ * status codes/error strings themselves. */
+type BookingResult = {
+    ok: true;
+    booking: BookingRecord;
+} | {
+    ok: false;
+    conflict: true;
+    message: string;
+} | {
+    ok: false;
+    conflict: false;
+    message: string;
+};
+
+declare function listLocations(cfg: ApiConfig): Promise<Location[]>;
+declare function listServices(cfg: ApiConfig, perPage?: number): Promise<Service[]>;
+declare function listProviders(cfg: ApiConfig, perPage?: number): Promise<Provider[]>;
+declare function getAvailableSlots(cfg: ApiConfig, params: {
+    locationId: string;
+    startDate: string;
+    serviceId?: string;
+    providerId?: string;
+}): Promise<Slot[]>;
+declare function createClient(cfg: ApiConfig, form: ClientFormValues): Promise<{
+    id: string;
+}>;
+declare function createBooking(cfg: ApiConfig, input: BookingCreateInput, clientToken?: string): Promise<BookingResult>;
+declare function sendMagicLink(cfg: ApiConfig, email: string, frontendUrl: string, profile?: {
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+    rut?: string;
+}): Promise<void>;
+declare function verifyMagicLink(cfg: ApiConfig, token: string): Promise<{
+    access_token: string;
+}>;
+declare function loginWithGoogle(cfg: ApiConfig, credential: string): Promise<{
+    access_token: string;
+}>;
+declare function register(cfg: ApiConfig, form: {
+    firstName: string;
+    lastName: string;
+    email: string;
+    phone?: string;
+    password: string;
+}): Promise<{
+    access_token: string;
+}>;
+declare function getMe(apiBase: string, token: string): Promise<ClientProfile>;
+declare function getMyBookings(apiBase: string, token: string, params?: {
+    upcoming?: boolean;
+    perPage?: number;
+}): Promise<BookingRecord[]>;
+declare function getMyPackages(apiBase: string, token: string): Promise<PackageRecord[]>;
+
+declare function getClientToken(): string | null;
+declare function setClientToken(token: string): void;
+declare function clearClientToken(): void;
+declare function fetchMe(apiBase: string, token: string): Promise<ClientProfile | null>;
+
+declare function getMondayOf(date: Date): Date;
+declare function dateStr(d: Date): string;
+declare function formatMonthRange(monday: Date): string;
+declare const DAY_NAMES: string[];
+declare const DAY_NAMES_FULL: string[];
+interface ProviderColor {
+    bg: string;
+    border: string;
+    text: string;
+}
+declare const DEFAULT_PROVIDER_COLORS: ProviderColor[];
+
+interface UseBookingFlowOptions extends ApiConfig {
+    onBookingComplete: (booking: BookingRecord) => void;
+    /** Default notes attached to every booking (e.g. "Reserva realizada desde sitio web X"). */
+    defaultNotes?: string;
+}
+interface SubmitBookingOverrides {
+    /** Override the service's list price (e.g. magnolia's price-variant step). */
+    price?: string;
+    /** Override defaultNotes for this specific submission. */
+    notes?: string;
+}
+/**
+ * Shared booking-flow logic: catalog fetching (locations/services/providers/
+ * slots), logged-in-client prefill, form validation, and submit-with-409-
+ * handling. Does NOT own step navigation or app-specific filtering (e.g.
+ * magnolia's category/price-variant logic) — those stay in the consuming
+ * component, layered on top of the `services`/`providers` this hook returns.
+ */
+declare function useBookingFlow(opts: UseBookingFlowOptions): {
+    locations: Location[];
+    services: Service[];
+    providers: Provider[];
+    slots: Slot[];
+    selectedLoc: string;
+    setSelectedLoc: react.Dispatch<react.SetStateAction<string>>;
+    selectedSvc: string;
+    setSelectedSvc: react.Dispatch<react.SetStateAction<string>>;
+    selectedProv: string;
+    setSelectedProv: react.Dispatch<react.SetStateAction<string>>;
+    selectedDate: string;
+    setSelectedDate: react.Dispatch<react.SetStateAction<string>>;
+    selectedSlot: Slot | null;
+    setSelectedSlot: react.Dispatch<react.SetStateAction<Slot | null>>;
+    form: ClientFormValues;
+    updateForm: (fields: Partial<ClientFormValues>) => void;
+    loading: boolean;
+    error: string;
+    setError: react.Dispatch<react.SetStateAction<string>>;
+    client: ClientProfile | null;
+    submitBooking: (overrides?: SubmitBookingOverrides) => Promise<void>;
+};
+
+interface SelectedClassSlot {
+    slot: Slot;
+    date: string;
+}
+interface UseClassScheduleOptions extends ApiConfig {
+    onBookingComplete: () => void;
+    colors?: ProviderColor[];
+}
+/**
+ * Shared weekly group-class schedule logic: week-of-slots fetching, provider
+ * color-palette assignment, and submit-with-409-handling. The week-grid table
+ * JSX and modal markup stay in the consuming component — this hook only owns
+ * data and state transitions.
+ */
+declare function useClassSchedule(opts: UseClassScheduleOptions): {
+    monday: Date;
+    setMonday: react.Dispatch<react.SetStateAction<Date>>;
+    slotsByDay: Record<string, Slot[]>;
+    loading: boolean;
+    providerColorMap: Record<string, ProviderColor>;
+    selectedSlot: SelectedClassSlot | null;
+    setSelectedSlot: react.Dispatch<react.SetStateAction<SelectedClassSlot | null>>;
+    form: ClientFormValues;
+    updateForm: (fields: Partial<ClientFormValues>) => void;
+    submitting: boolean;
+    error: string;
+    setError: react.Dispatch<react.SetStateAction<string>>;
+    client: ClientProfile | null;
+    submitBooking: (e: {
+        preventDefault: () => void;
+    }) => Promise<void>;
+};
+
+declare global {
+    interface Window {
+        google?: {
+            accounts: {
+                id: {
+                    initialize: (config: {
+                        client_id: string;
+                        callback: (response: {
+                            credential: string;
+                        }) => void;
+                    }) => void;
+                    prompt: () => void;
+                };
+            };
+        };
+    }
+}
+interface UseMagicLinkAuthOptions extends ApiConfig {
+    googleClientId?: string;
+    frontendUrl: string;
+    onGoogleLoggedIn: () => void;
+}
+type MagicLinkStep = "email" | "sent";
+declare function useMagicLinkAuth(opts: UseMagicLinkAuthOptions): {
+    email: string;
+    setEmail: react.Dispatch<react.SetStateAction<string>>;
+    firstName: string;
+    setFirstName: react.Dispatch<react.SetStateAction<string>>;
+    lastName: string;
+    setLastName: react.Dispatch<react.SetStateAction<string>>;
+    phone: string;
+    setPhone: react.Dispatch<react.SetStateAction<string>>;
+    rut: string;
+    setRut: react.Dispatch<react.SetStateAction<string>>;
+    step: MagicLinkStep;
+    error: string;
+    loading: boolean;
+    handleMagicLink: (e: {
+        preventDefault: () => void;
+    }) => Promise<void>;
+    handleGoogle: () => void;
+    reset: () => void;
+};
+
+interface RegisterFormValues {
+    firstName: string;
+    lastName: string;
+    email: string;
+    phone: string;
+    password: string;
+    confirm: string;
+}
+interface UseRegisterFormOptions extends ApiConfig {
+    onRegistered: () => void;
+}
+declare function useRegisterForm(opts: UseRegisterFormOptions): {
+    form: RegisterFormValues;
+    updateField: (fields: Partial<RegisterFormValues>) => void;
+    error: string;
+    loading: boolean;
+    handleSubmit: (e: {
+        preventDefault: () => void;
+    }) => Promise<void>;
+};
+
+interface UseClientAccountOptions {
+    apiBase: string;
+    onUnauthenticated: () => void;
+    onLoggedOut: () => void;
+}
+declare function useClientAccount(opts: UseClientAccountOptions): {
+    profile: ClientProfile | null;
+    upcoming: BookingRecord[];
+    history: BookingRecord[];
+    packages: PackageRecord[];
+    loading: boolean;
+    totalCredits: number;
+    handleLogout: () => void;
+};
+
+export { type ApiConfig, type BookingCreateInput, type BookingRecord, type BookingResult, type ClientFormValues, type ClientProfile, DAY_NAMES, DAY_NAMES_FULL, DEFAULT_PROVIDER_COLORS, type Location, type MagicLinkStep, type PackageRecord, type Provider, type ProviderColor, type RegisterFormValues, type SelectedClassSlot, type Service, type Slot, type SubmitBookingOverrides, type UseBookingFlowOptions, type UseClassScheduleOptions, type UseClientAccountOptions, type UseMagicLinkAuthOptions, type UseRegisterFormOptions, clearClientToken, createBooking, createClient, dateStr, fetchMe, formatMonthRange, getAvailableSlots, getClientToken, getMe, getMondayOf, getMyBookings, getMyPackages, listLocations, listProviders, listServices, loginWithGoogle, register, sendMagicLink, setClientToken, useBookingFlow, useClassSchedule, useClientAccount, useMagicLinkAuth, useRegisterForm, verifyMagicLink };