@hanzo/booker 0.1.0

package/src/useBooker.ts

@@ -0,0 +1,187 @@
+// Orchestration hook — the one booking state machine both shells consume.
+
+import { useEffect, useMemo, useState } from 'react'
+import { DEFAULT_API_URL, type Booking, type BookingResponses, type Slot } from './client'
+import {
+  useAvailableSlots,
+  useCreateBooking,
+  useEventType,
+  type AsyncState,
+  type SlotsState,
+} from './hooks'
+import type { EventType } from './client'
+import { addMonths, monthRange, startOfMonth, visitorTimeZone } from './time'
+
+export type BookerPhase = 'pick' | 'form' | 'done'
+
+export interface UseBookerOptions {
+  host: string
+  eventSlug: string
+  apiUrl?: string
+  timeZone?: string
+  weekStartsOn?: 0 | 1
+  onBooked?: (booking: Booking) => void
+  /** Auto-select the soonest available day (used by the compact embed). */
+  autoSelectFirst?: boolean
+}
+
+export interface BookerModel {
+  api: string
+  timeZone: string
+  weekStartsOn: 0 | 1
+  event: AsyncState<EventType>
+  slots: SlotsState
+  viewDate: Date
+  availableKeys: Set<string>
+  selectedDay: string | null
+  daySlots: Slot[]
+  selectedSlot: string | null
+  phase: BookerPhase
+  booking: Booking | null
+  submitting: boolean
+  error: string | null
+  conflict: boolean
+  goPrevMonth: () => void
+  goNextMonth: () => void
+  atFirstMonth: boolean
+  selectDay: (key: string) => void
+  selectSlot: (iso: string) => void
+  submit: (responses: BookingResponses) => Promise<void>
+  back: () => void
+  reset: () => void
+}
+
+export function useBooker(opts: UseBookerOptions): BookerModel {
+  const api = opts.apiUrl ?? DEFAULT_API_URL
+  const timeZone = opts.timeZone ?? visitorTimeZone()
+  const weekStartsOn = opts.weekStartsOn ?? 0
+
+  const event = useEventType(api, opts.eventSlug, opts.host)
+
+  const [viewDate, setViewDate] = useState<Date>(() => startOfMonth(new Date()))
+  const { startTime, endTime } = useMemo(() => monthRange(viewDate), [viewDate])
+
+  const slots = useAvailableSlots(api, {
+    eventTypeSlug: opts.eventSlug,
+    username: opts.host,
+    startTime,
+    endTime,
+    timeZone,
+    enabled: !!event.data,
+  })
+
+  const [selectedDay, setSelectedDay] = useState<string | null>(null)
+  const [selectedSlot, setSelectedSlot] = useState<string | null>(null)
+  const [phase, setPhase] = useState<BookerPhase>('pick')
+  const [booking, setBooking] = useState<Booking | null>(null)
+
+  const create = useCreateBooking(api)
+
+  const availableKeys = useMemo(() => {
+    const map = slots.data ?? {}
+    return new Set(Object.keys(map).filter((k) => (map[k]?.length ?? 0) > 0))
+  }, [slots.data])
+
+  const daySlots = useMemo(() => {
+    if (!selectedDay) return []
+    return slots.data?.[selectedDay] ?? []
+  }, [slots.data, selectedDay])
+
+  // Optionally auto-select the soonest available day once slots arrive.
+  useEffect(() => {
+    if (!opts.autoSelectFirst) return
+    if (selectedDay && availableKeys.has(selectedDay)) return
+    const first = [...availableKeys].sort()[0]
+    if (first) {
+      setSelectedDay(first)
+      setSelectedSlot(null)
+    }
+  }, [opts.autoSelectFirst, availableKeys, selectedDay])
+
+  const now = startOfMonth(new Date())
+  const atFirstMonth =
+    viewDate.getFullYear() === now.getFullYear() && viewDate.getMonth() === now.getMonth()
+
+  const goPrevMonth = () => {
+    if (atFirstMonth) return
+    setViewDate((d) => addMonths(d, -1))
+    setSelectedDay(null)
+    setSelectedSlot(null)
+  }
+  const goNextMonth = () => {
+    setViewDate((d) => addMonths(d, 1))
+    setSelectedDay(null)
+    setSelectedSlot(null)
+  }
+
+  const selectDay = (key: string) => {
+    setSelectedDay(key)
+    setSelectedSlot(null)
+  }
+  const selectSlot = (iso: string) => {
+    setSelectedSlot(iso)
+    setPhase('form')
+    create.reset()
+  }
+  const back = () => {
+    setPhase('pick')
+    setSelectedSlot(null)
+    create.reset()
+  }
+  const reset = () => {
+    setBooking(null)
+    setSelectedSlot(null)
+    setSelectedDay(null)
+    setPhase('pick')
+    create.reset()
+    slots.refetch()
+  }
+
+  const submit = async (responses: BookingResponses) => {
+    if (!selectedSlot) return
+    const result = await create.submit({
+      eventTypeSlug: opts.eventSlug,
+      username: opts.host,
+      start: selectedSlot,
+      timeZone,
+      responses,
+    })
+    if (result.ok) {
+      setBooking(result.booking)
+      setPhase('done')
+      opts.onBooked?.(result.booking)
+    } else if (result.conflict) {
+      // Slot was just taken — refresh availability and return to picking.
+      slots.refetch()
+      setSelectedSlot(null)
+      setPhase('pick')
+    }
+    // non-conflict errors stay visible in the form via `error`.
+  }
+
+  return {
+    api,
+    timeZone,
+    weekStartsOn,
+    event,
+    slots,
+    viewDate,
+    availableKeys,
+    selectedDay,
+    daySlots,
+    selectedSlot,
+    phase,
+    booking,
+    submitting: create.submitting,
+    error: create.error,
+    conflict: create.conflict,
+    goPrevMonth,
+    goNextMonth,
+    atFirstMonth,
+    selectDay,
+    selectSlot,
+    submit,
+    back,
+    reset,
+  }
+}

package/types/Booker.d.ts

@@ -0,0 +1,16 @@
+import type { Booking } from './client';
+export interface BookerProps {
+    /** Host username (the calendar owner), e.g. "hanzo". */
+    host: string;
+    /** Event-type slug, e.g. "intro". */
+    eventSlug: string;
+    /** API base, defaults to https://api.hanzo.ai/v1/calendar */
+    apiUrl?: string;
+    /** Visitor IANA time zone; defaults to the browser/device zone. */
+    timeZone?: string;
+    weekStartsOn?: 0 | 1;
+    onBooked?: (booking: Booking) => void;
+}
+/** Universal scheduling flow: event → month → times → details → confirmation. */
+export declare function Booker(props: BookerProps): import("react").JSX.Element;
+//# sourceMappingURL=Booker.d.ts.map

package/types/Booker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Booker.d.ts","sourceRoot":"","sources":["../src/Booker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAQvC,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACpB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACtC;AAED,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,+BAiGxC"}

package/types/BookingForm.d.ts

@@ -0,0 +1,13 @@
+import type { BookingResponses } from './client';
+export interface BookingFormProps {
+    slotIso: string;
+    timeZone: string;
+    eventLength: number;
+    submitting?: boolean;
+    error?: string | null;
+    onSubmit: (responses: BookingResponses) => void;
+    onBack: () => void;
+}
+/** Attendee details form for the chosen slot. */
+export declare function BookingForm({ slotIso, timeZone, eventLength, submitting, error, onSubmit, onBack, }: BookingFormProps): import("react").JSX.Element;
+//# sourceMappingURL=BookingForm.d.ts.map

package/types/BookingForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BookingForm.d.ts","sourceRoot":"","sources":["../src/BookingForm.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC/C,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAID,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,WAAW,EACX,UAAU,EACV,KAAK,EACL,QAAQ,EACR,MAAM,GACP,EAAE,gBAAgB,+BAsGlB"}

package/types/CalendarEmbed.d.ts

@@ -0,0 +1,15 @@
+import type { Booking } from './client';
+export interface CalendarEmbedProps {
+    host: string;
+    eventSlug: string;
+    apiUrl?: string;
+    timeZone?: string;
+    weekStartsOn?: 0 | 1;
+    onBooked?: (booking: Booking) => void;
+}
+/**
+ * Compact booking card for a marketing hero — soonest availability inline,
+ * no month grid. Same state machine as <Booker>.
+ */
+export declare function CalendarEmbed(props: CalendarEmbedProps): import("react").JSX.Element;
+//# sourceMappingURL=CalendarEmbed.d.ts.map

package/types/CalendarEmbed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CalendarEmbed.d.ts","sourceRoot":"","sources":["../src/CalendarEmbed.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAQvC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACpB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACtC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAwFtD"}

package/types/Confirmation.d.ts

@@ -0,0 +1,12 @@
+import { type Booking } from './client';
+export interface ConfirmationProps {
+    /** Provide a booking directly, or a uid to fetch one. */
+    booking?: Booking;
+    uid?: string;
+    apiUrl?: string;
+    timeZone?: string;
+    onDone?: () => void;
+}
+/** Booking confirmation card. Accepts a booking object or fetches by uid. */
+export declare function Confirmation({ booking, uid, apiUrl, timeZone, onDone, }: ConfirmationProps): import("react").JSX.Element;
+//# sourceMappingURL=Confirmation.d.ts.map

package/types/Confirmation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Confirmation.d.ts","sourceRoot":"","sources":["../src/Confirmation.tsx"],"names":[],"mappings":"AASA,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,UAAU,CAAA;AAKxD,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,GAAG,EACH,MAAM,EACN,QAAQ,EACR,MAAM,GACP,EAAE,iBAAiB,+BA0FnB"}

package/types/EventHeader.d.ts

@@ -0,0 +1,10 @@
+import type { EventType } from './client';
+export interface EventHeaderProps {
+    event: EventType;
+    host: string;
+    timeZone: string;
+    compact?: boolean;
+}
+/** Event identity: host, title, duration, timezone, description. */
+export declare function EventHeader({ event, host, timeZone, compact }: EventHeaderProps): import("react").JSX.Element;
+//# sourceMappingURL=EventHeader.d.ts.map

package/types/EventHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventHeader.d.ts","sourceRoot":"","sources":["../src/EventHeader.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,gBAAgB,+BA0C/E"}

package/types/MonthCalendar.d.ts

@@ -0,0 +1,14 @@
+export interface MonthCalendarProps {
+    viewDate: Date;
+    availableKeys: Set<string>;
+    selectedDay: string | null;
+    onSelectDay: (key: string) => void;
+    onPrev: () => void;
+    onNext: () => void;
+    atFirstMonth: boolean;
+    weekStartsOn?: 0 | 1;
+    loading?: boolean;
+}
+/** Navigable month grid; days with availability are selectable. */
+export declare function MonthCalendar({ viewDate, availableKeys, selectedDay, onSelectDay, onPrev, onNext, atFirstMonth, weekStartsOn, loading, }: MonthCalendarProps): import("react").JSX.Element;
+//# sourceMappingURL=MonthCalendar.d.ts.map

package/types/MonthCalendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthCalendar.d.ts","sourceRoot":"","sources":["../src/MonthCalendar.tsx"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,IAAI,CAAA;IACd,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,MAAM,EACN,MAAM,EACN,YAAY,EACZ,YAAgB,EAChB,OAAO,GACR,EAAE,kBAAkB,+BAyDpB"}

package/types/TimeSlots.d.ts

@@ -0,0 +1,15 @@
+import type { Slot } from './client';
+export interface TimeSlotsProps {
+    dayKey: string | null;
+    slots: Slot[];
+    timeZone: string;
+    onPick: (iso: string) => void;
+    selectedIso?: string | null;
+    loading?: boolean;
+    /** compact = wrap into a flowing grid instead of a tall column */
+    compact?: boolean;
+    maxHeight?: number;
+}
+/** Time-slot pills for the selected day, shown in the visitor's time zone. */
+export declare function TimeSlots({ dayKey, slots, timeZone, onPick, selectedIso, loading, compact, maxHeight, }: TimeSlotsProps): import("react").JSX.Element;
+//# sourceMappingURL=TimeSlots.d.ts.map

package/types/TimeSlots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeSlots.d.ts","sourceRoot":"","sources":["../src/TimeSlots.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAGpC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAe,GAChB,EAAE,cAAc,+BA4DhB"}

package/types/client.d.ts

@@ -0,0 +1,77 @@
+export declare const DEFAULT_API_URL = "https://api.hanzo.ai/v1/calendar";
+export declare const CAL_API_VERSION = "2024-08-13";
+export interface Location {
+    type?: string;
+    link?: string;
+    address?: string;
+}
+export interface Profile {
+    name?: string | null;
+    username?: string | null;
+    image?: string | null;
+    avatarUrl?: string | null;
+}
+export interface EventType {
+    id: number;
+    slug: string;
+    title: string;
+    description: string;
+    /** duration in minutes */
+    length: number;
+    locations: Location[];
+    price: number;
+    currency: string;
+    profile?: Profile;
+}
+export interface Slot {
+    /** ISO-8601 UTC instant, e.g. "2026-07-24T16:00:00Z" */
+    time: string;
+}
+/** Slots grouped by day key "YYYY-MM-DD" (in the requested time zone). */
+export type SlotsByDay = Record<string, Slot[]>;
+export interface Attendee {
+    name?: string;
+    email?: string;
+    timeZone?: string;
+}
+export interface Booking {
+    uid: string;
+    status: string;
+    start: string;
+    end: string;
+    title: string;
+    location?: string;
+    attendees?: Attendee[];
+}
+export interface BookingResponses {
+    name: string;
+    email: string;
+    notes?: string;
+}
+export interface CreateBookingInput {
+    eventTypeSlug: string;
+    username: string;
+    /** ISO instant of the chosen slot */
+    start: string;
+    timeZone: string;
+    responses: BookingResponses;
+}
+export interface SlotsInput {
+    eventTypeSlug: string;
+    username: string;
+    startTime: string;
+    endTime: string;
+    timeZone: string;
+}
+/** Error carrying the HTTP status; `conflict` marks a 409 (slot just taken). */
+export declare class CalendarError extends Error {
+    status: number;
+    conflict: boolean;
+    constructor(message: string, status: number);
+}
+export declare function fetchEventType(api: string, eventSlug: string, username: string, signal?: AbortSignal): Promise<EventType>;
+export declare function fetchSlots(api: string, input: SlotsInput, signal?: AbortSignal): Promise<SlotsByDay>;
+export declare function createBooking(api: string, input: CreateBookingInput, signal?: AbortSignal): Promise<Booking>;
+export declare function fetchBooking(api: string, uid: string, signal?: AbortSignal): Promise<Booking>;
+export declare function cancelBooking(api: string, uid: string, reason?: string, signal?: AbortSignal): Promise<Booking>;
+//# sourceMappingURL=client.d.ts.map

package/types/client.d.ts.map

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

package/types/hooks.d.ts

@@ -0,0 +1,43 @@
+import { type Booking, type BookingResponses, type EventType, type SlotsByDay } from './client';
+export interface AsyncState<T> {
+    data: T | null;
+    loading: boolean;
+    error: string | null;
+}
+export declare function useEventType(api: string, eventSlug: string, username: string): AsyncState<EventType>;
+export interface SlotsQuery {
+    eventTypeSlug: string;
+    username: string;
+    startTime: string;
+    endTime: string;
+    timeZone: string;
+    enabled?: boolean;
+}
+export interface SlotsState extends AsyncState<SlotsByDay> {
+    refetch: () => void;
+}
+export declare function useAvailableSlots(api: string, query: SlotsQuery): SlotsState;
+export type SubmitResult = {
+    ok: true;
+    booking: Booking;
+} | {
+    ok: false;
+    conflict: boolean;
+    message: string;
+};
+export interface CreateBookingState {
+    submit: (input: {
+        eventTypeSlug: string;
+        username: string;
+        start: string;
+        timeZone: string;
+        responses: BookingResponses;
+    }) => Promise<SubmitResult>;
+    submitting: boolean;
+    error: string | null;
+    conflict: boolean;
+    reset: () => void;
+}
+export declare function useCreateBooking(api: string): CreateBookingState;
+export declare function useBooking(api: string, uid: string | undefined): AsyncState<Booking>;
+//# sourceMappingURL=hooks.d.ts.map

package/types/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,UAAU,CAAC,SAAS,CAAC,CAkBvB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,UAAW,SAAQ,UAAU,CAAC,UAAU,CAAC;IACxD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CA4B5E;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,CAAC,KAAK,EAAE;QACd,aAAa,EAAE,MAAM,CAAA;QACrB,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,gBAAgB,CAAA;KAC5B,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAC3B,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CA+ChE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAmBpF"}

package/types/index.d.ts

@@ -0,0 +1,12 @@
+export { Booker, type BookerProps } from './Booker';
+export { CalendarEmbed, type CalendarEmbedProps } from './CalendarEmbed';
+export { Confirmation, type ConfirmationProps } from './Confirmation';
+export { EventHeader, type EventHeaderProps } from './EventHeader';
+export { MonthCalendar, type MonthCalendarProps } from './MonthCalendar';
+export { TimeSlots, type TimeSlotsProps } from './TimeSlots';
+export { BookingForm, type BookingFormProps } from './BookingForm';
+export { useBooker, type UseBookerOptions, type BookerModel, type BookerPhase, } from './useBooker';
+export { useEventType, useAvailableSlots, useCreateBooking, useBooking, type AsyncState, type SlotsQuery, type SlotsState, type CreateBookingState, type SubmitResult, } from './hooks';
+export { DEFAULT_API_URL, CAL_API_VERSION, CalendarError, fetchEventType, fetchSlots, createBooking, fetchBooking, cancelBooking, type EventType, type Slot, type SlotsByDay, type Booking, type Attendee, type Location, type Profile, type BookingResponses, type CreateBookingInput, type SlotsInput, } from './client';
+export { visitorTimeZone, ymd, monthMatrix, monthRange, weekdayLabels, formatMonthLabel, formatDayLong, formatSlotTime, formatBookingWhen, dateFromKey, startOfMonth, addMonths, sameMonth, isBeforeToday, type MonthCell, } from './time';
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGrE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGlE,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,eAAe,EACf,GAAG,EACH,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,aAAa,EACb,KAAK,SAAS,GACf,MAAM,QAAQ,CAAA"}

package/types/time.d.ts

@@ -0,0 +1,38 @@
+/** The visitor's IANA time zone, e.g. "America/New_York". */
+export declare function visitorTimeZone(): string;
+/** Calendar date "YYYY-MM-DD" from a Date's local components. */
+export declare function ymd(d: Date): string;
+export declare function startOfMonth(d: Date): Date;
+export declare function addMonths(d: Date, n: number): Date;
+export declare function sameMonth(a: Date, b: Date): boolean;
+/** True if the day key is strictly before today (lexicographic works on YYYY-MM-DD). */
+export declare function isBeforeToday(key: string): boolean;
+export interface MonthCell {
+    date: Date;
+    key: string;
+    inMonth: boolean;
+}
+/**
+ * A 6×7 grid of days covering the month of `viewDate`, including the leading
+ * and trailing days needed to fill whole weeks.
+ */
+export declare function monthMatrix(viewDate: Date, weekStartsOn?: number): MonthCell[];
+/**
+ * ISO start/end covering the visible month, clamped so the start is never in
+ * the past (the backend rejects past ranges anyway).
+ */
+export declare function monthRange(viewDate: Date): {
+    startTime: string;
+    endTime: string;
+};
+/** Short weekday headers ordered from `weekStartsOn` (0 = Sunday). */
+export declare function weekdayLabels(weekStartsOn?: number): string[];
+export declare function formatMonthLabel(d: Date): string;
+export declare function formatDayLong(d: Date): string;
+/** Slot time in the visitor's zone, e.g. "9:00 AM". */
+export declare function formatSlotTime(iso: string, timeZone: string): string;
+/** Full human "when" for a confirmation, e.g. "Monday, July 27, 2026 at 9:00 AM PDT". */
+export declare function formatBookingWhen(iso: string, timeZone: string): string;
+/** A parsed local Date from a "YYYY-MM-DD" key (noon avoids DST edge slips). */
+export declare function dateFromKey(key: string): Date;
+//# sourceMappingURL=time.d.ts.map

package/types/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAGA,6DAA6D;AAC7D,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED,iEAAiE;AACjE,wBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAKnC;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAE1C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAEnD;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,SAAI,GAAG,SAAS,EAAE,CAWzE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,IAAI,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQjF;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,YAAY,SAAI,GAAG,MAAM,EAAE,CASxD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAEhD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAM7C;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBvE;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG7C"}

package/types/useBooker.d.ts

@@ -0,0 +1,41 @@
+import { type Booking, type BookingResponses, type Slot } from './client';
+import { type AsyncState, type SlotsState } from './hooks';
+import type { EventType } from './client';
+export type BookerPhase = 'pick' | 'form' | 'done';
+export interface UseBookerOptions {
+    host: string;
+    eventSlug: string;
+    apiUrl?: string;
+    timeZone?: string;
+    weekStartsOn?: 0 | 1;
+    onBooked?: (booking: Booking) => void;
+    /** Auto-select the soonest available day (used by the compact embed). */
+    autoSelectFirst?: boolean;
+}
+export interface BookerModel {
+    api: string;
+    timeZone: string;
+    weekStartsOn: 0 | 1;
+    event: AsyncState<EventType>;
+    slots: SlotsState;
+    viewDate: Date;
+    availableKeys: Set<string>;
+    selectedDay: string | null;
+    daySlots: Slot[];
+    selectedSlot: string | null;
+    phase: BookerPhase;
+    booking: Booking | null;
+    submitting: boolean;
+    error: string | null;
+    conflict: boolean;
+    goPrevMonth: () => void;
+    goNextMonth: () => void;
+    atFirstMonth: boolean;
+    selectDay: (key: string) => void;
+    selectSlot: (iso: string) => void;
+    submit: (responses: BookingResponses) => Promise<void>;
+    back: () => void;
+    reset: () => void;
+}
+export declare function useBooker(opts: UseBookerOptions): BookerModel;
+//# sourceMappingURL=useBooker.d.ts.map

package/types/useBooker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBooker.d.ts","sourceRoot":"","sources":["../src/useBooker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,IAAI,EAAE,MAAM,UAAU,CAAA;AAC1F,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAGzC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAElD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACpB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,CAAC,GAAG,CAAC,CAAA;IACnB,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAC5B,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,EAAE,IAAI,CAAA;IACd,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,IAAI,EAAE,CAAA;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,YAAY,EAAE,OAAO,CAAA;IACrB,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,MAAM,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAqI7D"}