@resira/sdk 0.4.5 → 0.4.7

package/dist/index.d.cts

@@ -1,901 +1,901 @@
-/**
- * POST body for creating a reservation.
- *
- * Use date fields (`startDate`/`endDate`) for property bookings and
- * datetime fields (`startTime`/`endTime`) for restaurant/experience
- * reservations. Both can be provided simultaneously.
- */
-interface CreateReservationRequest {
-    /** The resource to book. Sent in the request body. */
-    resourceId: string;
-    /** Guest's full name. */
-    guestName: string;
-    /** Guest's email address. Optional for restaurant reservations. */
-    guestEmail?: string;
-    /** Guest's phone number. Required for restaurant if email not provided. */
-    guestPhone?: string;
-    /** Start date in `YYYY-MM-DD` format (date-based resources). Optional for time-based resources. */
-    startDate?: string;
-    /** End date in `YYYY-MM-DD` format (date-based resources). Optional for time-based resources. */
-    endDate?: string;
-    /** Start datetime in ISO 8601 / RFC 3339 (time-based resources). */
-    startTime?: string;
-    /** End datetime in ISO 8601 / RFC 3339 (time-based resources). */
-    endTime?: string;
-    /** Number of guests / party size. Defaults to 2 on the server. */
-    partySize?: number;
-    /** Free-form notes from the guest. */
-    notes?: string;
-}
-/** Query parameters for listing reservations. */
-interface ListReservationsParams {
-    /** Filter by status (e.g. `"pending"`, `"confirmed"`). Omit for all non-archived. */
-    status?: string;
-    /** Page number (1-indexed). Defaults to 1. */
-    page?: number;
-    /** Items per page (1–100). Defaults to 25. */
-    limit?: number;
-}
-/**
- * Query parameters for the availability endpoint.
- *
- * For **properties**: pass `startDate` + `endDate` to check a range,
- * or omit both to get all blocked dates for calendar rendering.
- *
- * For **restaurants**: pass `date` (and optionally `partySize`) to
- * get time-slot availability for a specific day.
- */
-interface AvailabilityParams {
-    /** Start date `YYYY-MM-DD` (property: range start). */
-    startDate?: string;
-    /** End date `YYYY-MM-DD` (property: range end). */
-    endDate?: string;
-    /** Date `YYYY-MM-DD` (restaurant: day to query slots for). */
-    date?: string;
-    /** Party size (restaurant: filter by capacity). */
-    partySize?: number;
-    /** Session duration in minutes (watersport/service: controls slot intervals). */
-    durationMinutes?: number;
-}
-/**
- * A reservation as returned by the public API.
- *
- * Intentionally minimal — no Stripe internals, no per-night
- * breakdown, no audit metadata.
- */
-interface Reservation {
-    /** Unique reservation identifier. */
-    id: string;
-    /** The resource this reservation belongs to. */
-    resourceId: string;
-    /** Reservation status: `pending`, `confirmed`, `cancelled`, etc. */
-    status: string;
-    /** Start date (`YYYY-MM-DD`) for date-based reservations. */
-    startDate?: string;
-    /** End date (`YYYY-MM-DD`) for date-based reservations. */
-    endDate?: string;
-    /** Start datetime (ISO 8601) for time-based reservations. */
-    startTime?: string;
-    /** End datetime (ISO 8601) for time-based reservations. */
-    endTime?: string;
-    /** Start datetime (ISO 8601) — returned by v2 API for datetime-range reservations. */
-    startDatetime?: string;
-    /** End datetime (ISO 8601) — returned by v2 API for datetime-range reservations. */
-    endDatetime?: string;
-    /** Guest's name. */
-    guestName: string;
-    /** Party size. */
-    partySize: number;
-    /** Total price in the smallest currency unit (cents). */
-    totalPrice: number;
-    /** ISO 4217 currency code (e.g. `"EUR"`). */
-    currency: string;
-    /** When the reservation was created (ISO 8601). */
-    createdAt: string;
-}
-/** Response wrapper for a single reservation. */
-interface ReservationResponse {
-    reservation: Reservation;
-}
-/** Paginated list of reservations. */
-interface PaginatedReservations {
-    data: Reservation[];
-    total: number;
-    page: number;
-    limit: number;
-    totalPages: number;
-}
-/** Date-level availability for property-like resources. */
-interface DateAvailability {
-    /** Whether the requested date range is fully available. */
-    available?: boolean;
-    /** Sorted list of unavailable dates (`YYYY-MM-DD`). */
-    blockedDates: string[];
-    /** Total price for the requested range (cents). */
-    totalPrice?: number;
-    /** Minimum stay in nights. */
-    minStay?: number;
-}
-/** A single time-slot with remaining capacity (restaurants). */
-interface TimeSlotAvailability {
-    /** Slot start time (ISO 8601). */
-    start: string;
-    /** Slot end time (ISO 8601). */
-    end: string;
-    /** Total capacity. */
-    capacity: number;
-    /** Number of confirmed/pending reservations in this slot. */
-    reserved: number;
-    /** Remaining seats (`capacity - reserved`). */
-    remaining: number;
-    /** Whether the slot has any remaining capacity. */
-    available: boolean;
-}
-/**
- * Availability response — domain-agnostic.
- *
- * For properties, `dates` is populated.
- * For restaurants, `timeSlots` is populated.
- * Both are never present simultaneously.
- */
-interface Availability {
-    /** The resource being queried. */
-    resourceId: string;
-    /** ISO 4217 currency code. */
-    currency: string;
-    /** Date-level availability (properties). */
-    dates?: DateAvailability;
-    /** Time-slot availability (restaurants). */
-    timeSlots?: TimeSlotAvailability[];
-}
-/** Configuration for the Resira SDK client. */
-interface WeightedBaseUrl {
-    /** Base URL for an API origin. */
-    url: string;
-    /** Legacy weight field. Ignored by the SDK in deterministic routing mode. */
-    weight?: number;
-}
-interface ResiraConfig {
-    /** API key (format: `resira_live_<hex>`). */
-    apiKey: string;
-    /**
-     * Base URL of the API.
-      * Overrides default endpoint resolution when set.
-     */
-    baseUrl?: string;
-    /**
-      * Ordered fallback API origins.
-      * The SDK uses the first valid entry deterministically and does not persist routing state in browser storage.
-     */
-    baseUrls?: Array<string | WeightedBaseUrl>;
-    /**
-     * Maximum number of retry attempts for retryable errors (429, 5xx).
-     * @default 3
-     */
-    maxRetries?: number;
-    /**
-     * Base delay in milliseconds for exponential backoff.
-     * @default 500
-     */
-    retryBaseDelay?: number;
-    /**
-     * Custom `fetch` implementation (for testing or Node 16 polyfills).
-     * Defaults to the global `fetch`.
-     */
-    fetch?: typeof globalThis.fetch;
-}
-/** Display settings for a resource image (CSS-level transform hints). */
-interface ResourceImageDisplaySettings {
-    /** How the image fits the container. */
-    objectFit?: "cover" | "contain" | "fill" | "none";
-    /** CSS object-position value (e.g. "center center", "top left"). */
-    objectPosition?: string;
-    /** Zoom level (1.0 = no zoom, 2.0 = 200%). */
-    zoom?: number;
-}
-/** A single image entry for a resource (multi-image support). */
-interface ResourceImage {
-    /** CDN URL of the image. */
-    url: string;
-    /** Per-image display preferences. */
-    displaySettings?: ResourceImageDisplaySettings;
-}
-/** A bookable resource as returned by the public API. */
-interface PublicResource {
-    /** Unique resource identifier. */
-    id: string;
-    /** Human-readable name. */
-    name: string;
-    /** URL-friendly slug. */
-    slug: string;
-    /** Resource type (e.g. "boat", "property", "vehicle"). */
-    resourceType: string;
-    /** Max capacity / seats. */
-    capacity: number | null;
-    /** Whether the resource is active. */
-    active: boolean;
-    /** Optional description. */
-    description?: string;
-    /** Optional primary image URL (first image). */
-    imageUrl?: string;
-    /** All images for this resource (ordered). The first is the primary/cover image. */
-    images?: ResourceImage[];
-    /** Price per session in cents (watersport/service). */
-    pricePerSession?: number;
-    /** Session duration in minutes (watersport/service). */
-    durationMinutes?: number;
-    /** Currency code (e.g. "EUR"). */
-    currency?: string;
-    /** Subtype (e.g. "jet_ski", "kayak"). */
-    boatType?: string;
-}
-/** Response wrapper for resource listing. */
-interface ResourceListResponse {
-    resources: PublicResource[];
-    count: number;
-}
-/** Raw error body returned by the API (`{ "error": "..." }`). */
-interface ApiErrorBody {
-    error: string;
-    retryAfter?: number;
-}
-/** Pricing model for a product/service. */
-type PricingModel = "per_session" | "per_person" | "per_rider";
-/** A duration-price pair for multi-duration services. */
-interface DurationPrice {
-    /** Duration in minutes. */
-    durationMinutes: number;
-    /** Price in the smallest currency unit (cents). */
-    priceCents: number;
-}
-/** A rider-tier with its own set of duration-price pairs. */
-interface RiderTierPrice {
-    /** Number of riders this tier applies to. */
-    riders: number;
-    /** Duration-price options for this rider count. */
-    durationPricing: DurationPrice[];
-}
-/** A bookable product/service as returned by the public API. */
-interface Product {
-    /** Unique product identifier. */
-    id: string;
-    /** Human-readable name. */
-    name: string;
-    /** Optional description. */
-    description?: string;
-    /** Default duration in minutes (first/shortest option). */
-    durationMinutes: number;
-    /** Default price in the smallest currency unit (cents). */
-    priceCents: number;
-    /** ISO 4217 currency code (e.g. `"EUR"`). */
-    currency: string;
-    /** Optional image URL. */
-    imageUrl?: string;
-    /** Optional calendar/display color for this service, usually configured in admin settings. */
-    serviceColor?: string;
-    /** Whether the product is active. */
-    active: boolean;
-    /** Sort order. */
-    sortOrder?: number;
-    /** Pricing model: flat rate per session or per person. */
-    pricingModel: PricingModel;
-    /** IDs of linked equipment/resources. */
-    equipmentIds: string[];
-    /** Equipment names (resolved by the server). */
-    equipmentNames?: string[];
-    /** Maximum party size for this service (derived from linked equipment's maxPeople). */
-    maxPartySize?: number;
-    /** Available duration options with per-duration pricing. If absent, single duration. */
-    durationPricing?: DurationPrice[];
-    /** Rider-tier pricing (per_rider model). Each tier has a rider count and its own duration-price set. */
-    riderTierPricing?: RiderTierPrice[];
-    /** Normalized product variants with duration and price (returned by v2 API). */
-    variants?: ProductVariant[];
-    /** Available slot durations in minutes (returned by v2 API). */
-    slotDurations?: number[];
-}
-/** Response wrapper for product listing. */
-interface ProductListResponse {
-    products: Product[];
-    count: number;
-}
-/** Request body for creating a payment intent. */
-interface CreatePaymentIntentRequest {
-    /** Product ID being booked. */
-    productId?: string;
-    /** Resource/equipment ID. */
-    resourceId?: string;
-    /** Party size. */
-    partySize?: number;
-    /** Selected duration in minutes (for multi-duration products). */
-    durationMinutes?: number;
-    /** Start date (YYYY-MM-DD). */
-    startDate?: string;
-    /** Start time (ISO 8601, optional). */
-    startTime?: string;
-    /** End time (ISO 8601, optional). */
-    endTime?: string;
-    /** Guest name. */
-    guestName: string;
-    /** Guest email. Optional for restaurant reservations. */
-    guestEmail?: string;
-    /** Guest phone. Required for restaurant if email not provided. */
-    guestPhone?: string;
-    /** Notes (optional). */
-    notes?: string;
-    /** Promo/discount code (optional). Validated server-side. */
-    promoCode?: string;
-    /** Whether the guest accepted terms & conditions. Required when property has termsRequired=true. */
-    termsAccepted?: boolean;
-    /** Checkout session token. When provided, session data is merged with the payload. */
-    checkoutSessionToken?: string;
-}
-/** Response from creating a payment intent. */
-interface PaymentIntentResponse {
-    /** Stripe client secret for confirming payment. */
-    clientSecret: string;
-    /** Payment intent ID. */
-    paymentIntentId: string;
-    /** Amount due now (cents) — maps from backend `amountDue`. */
-    amountNow: number;
-    /** Amount to charge at venue (cents) — computed: totalAmount - amountNow. */
-    amountAtVenue: number;
-    /** Total amount (cents) — maps from backend `totalPrice`. */
-    totalAmount: number;
-    /** Currency code. */
-    currency: string;
-    /** Payment option: "full" or "deposit". */
-    paymentOption?: string;
-    /** The reservation created in pending state (may not be returned). */
-    reservationId?: string;
-    /** Discount amount in cents (if a promo code was applied). */
-    discountAmount?: number;
-    /** Original price before discount (cents). */
-    originalPrice?: number;
-    /** The promo code that was applied (echoed back by server). */
-    promoCodeApplied?: string;
-}
-/** Request to confirm payment was successful. */
-interface ConfirmPaymentRequest {
-    /** The payment intent ID from Stripe. */
-    paymentIntentId: string;
-    /** The reservation ID to confirm. */
-    reservationId: string;
-}
-/** Response after confirming payment. */
-interface ConfirmPaymentResponse {
-    /** The confirmed reservation. */
-    reservation: Reservation;
-    /** Whether payment was successfully captured. */
-    paymentStatus: "succeeded" | "requires_action" | "failed";
-}
-/** Public-safe property configuration returned by GET /v1/public/config. */
-interface PropertyConfig {
-    /** Property name. */
-    name?: string;
-    /** ISO 4217 currency code. */
-    currency?: string;
-    /** Whether online bookings are enabled. */
-    bookingsEnabled?: boolean;
-    /** Deposit percentage (0–100). */
-    depositPercent?: number;
-    /** Primary brand color. */
-    primaryColor?: string;
-    /** Stripe publishable key (pk_test_… or pk_live_…). */
-    stripePublishableKey?: string | null;
-    /** Whether multi-resource selection is allowed. */
-    allowMultiResourceSelect?: boolean;
-    /** Whether guests must accept terms & conditions before booking. */
-    termsRequired?: boolean;
-    /** Custom terms & conditions text shown to guests. */
-    termsText?: string;
-    /** Refund policy rules (sorted by hoursBeforeStart descending). */
-    refundPolicy?: RefundRule[];
-}
-/** A single refund policy rule: if cancellation is >= hoursBeforeStart hours before the booking, refund refundPercent%. */
-interface RefundRule {
-    /** Minimum hours before the booking start time for this tier to apply. */
-    hoursBeforeStart: number;
-    /** Percentage of the payment to refund (0–100). */
-    refundPercent: number;
-}
-/** Response from validating a promo code. */
-interface ValidatePromoCodeResponse {
-    /** Whether the code is valid. */
-    valid: boolean;
-    /** Discount type: "percent" or "fixed". */
-    discountType?: "percent" | "fixed";
-    /** Discount value (percentage 0-100 or fixed amount in cents). */
-    discountValue?: number;
-    /** Currency for fixed discounts. */
-    currency?: string;
-    /** Minimum order amount in cents (if applicable). */
-    minOrderCents?: number;
-    /** Error message if invalid. */
-    error?: string;
-}
-/** A promo code as returned by the admin API. */
-interface PromoCode {
-    id: string;
-    propertyId: string;
-    code: string;
-    discountType: "percent" | "fixed";
-    discountValue: number;
-    currency: string;
-    maxUses: number | null;
-    timesUsed: number;
-    minOrderCents: number;
-    expiresAt: string | null;
-    active: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-/** A 3D model asset attached to a dish. */
-interface DishModel {
-    /** URL to the GLB/glTF model file. */
-    glbUrl: string;
-    /** URL to the USDZ model file (iOS AR Quick Look). */
-    usdzUrl?: string;
-    /** Optional poster/thumbnail shown while the model loads. */
-    posterUrl?: string;
-    /** Alt text for accessibility. */
-    alt?: string;
-}
-/** A dish as returned by the public API. */
-interface Dish {
-    /** Unique dish identifier (shown in admin for easy copy). */
-    id: string;
-    /** Human-readable dish name. */
-    name: string;
-    /** Optional description. */
-    description?: string;
-    /** Price in the smallest currency unit (cents). */
-    priceCents?: number;
-    /** ISO 4217 currency code (e.g. `"EUR"`). */
-    currency?: string;
-    /** Category or tag (e.g. "Starter", "Main", "Dessert"). */
-    category?: string;
-    /** Optional flat image URL (fallback when 3D is unavailable). */
-    imageUrl?: string;
-    /** 3D model data for AR/preview. */
-    model?: DishModel;
-    /** Whether the dish is currently available. */
-    available?: boolean;
-    /** Allergen tags (e.g. ["gluten", "dairy"]). */
-    allergens?: string[];
-    /** Sort order. */
-    sortOrder?: number;
-}
-/** Response wrapper for a single dish. */
-interface DishResponse {
-    dish: Dish;
-}
-/** Response wrapper for dish listing. */
-interface DishListResponse {
-    dishes: Dish[];
-    count: number;
-}
-/** Checkout configuration embedded in a checkout session. */
-interface CheckoutConfig {
-    /** Stripe publishable key. */
-    stripePublishableKey: string;
-    /** Deposit percentage (0–100). */
-    depositPercent: number;
-    /** Whether terms acceptance is required. */
-    termsRequired: boolean;
-    /** Terms text to display. */
-    termsText?: string;
-}
-/** A checkout session as returned by the API. */
-interface CheckoutSession {
-    /** Unique session token. */
-    sessionToken: string;
-    /** Session status. */
-    status: "pending" | "consumed" | "expired";
-    /** When the session expires (ISO 8601). */
-    expiresAt: string;
-    /** Product ID. */
-    productId: string;
-    /** Product display name. */
-    productName: string;
-    /** Duration in minutes. */
-    durationMinutes: number;
-    /** Price in smallest currency unit (cents). */
-    priceCents: number;
-    /** ISO 4217 currency code. */
-    currency: string;
-    /** Party size / number of riders. */
-    partySize: number;
-    /** Pricing model. */
-    pricingModel: PricingModel;
-    /** Booking date (YYYY-MM-DD). */
-    date: string;
-    /** Start time (ISO 8601). */
-    startTime: string;
-    /** End time (ISO 8601). */
-    endTime: string;
-    /** Service display color. */
-    serviceColor?: string;
-    /** Product image URL. */
-    imageUrl?: string;
-    /** Pre-filled guest name. */
-    guestName?: string;
-    /** Pre-filled guest email. */
-    guestEmail?: string;
-    /** Pre-applied promo code. */
-    promoCode?: string;
-    /** Checkout-specific configuration. */
-    checkoutConfig: CheckoutConfig;
-}
-/** Response wrapper for a checkout session. */
-interface CheckoutSessionResponse {
-    session: CheckoutSession;
-}
-/** Request body for creating a checkout session. */
-interface CreateCheckoutSessionRequest {
-    /** Product ID. */
-    productId: string;
-    /** Duration in minutes. */
-    durationMinutes: number;
-    /** Party size. */
-    partySize: number;
-    /** Booking date (YYYY-MM-DD). */
-    date: string;
-    /** Start time (ISO 8601). */
-    startTime: string;
-    /** End time (ISO 8601). */
-    endTime: string;
-    /** Guest name (optional). */
-    guestName?: string;
-    /** Guest email (optional). */
-    guestEmail?: string;
-    /** Promo code (optional). */
-    promoCode?: string;
-}
-/** Response from creating a checkout session. */
-interface CreateCheckoutSessionResponse {
-    sessionToken: string;
-    expiresAt: string;
-}
-/** A normalized product variant with duration and price. */
-interface ProductVariant {
-    /** Duration in minutes. */
-    durationMinutes: number;
-    /** Price in smallest currency unit (cents). */
-    priceCents: number;
-    /** Optional display label (e.g. "Full Hour"). */
-    label?: string;
-}
-
-/**
- * Resira SDK client.
- *
- * ```ts
- * const resira = new Resira({
- *   apiKey: "resira_live_abc123…",
- *   baseUrl: "https://api.example.com", // optional
- * });
- *
- * const availability = await resira.getAvailability("prop-1", {
- *   startDate: "2026-07-01",
- *   endDate: "2026-07-07",
- * });
- * ```
- */
-declare class Resira {
-    private readonly apiKey;
-    private readonly baseUrls;
-    private readonly maxRetries;
-    private readonly retryBaseDelay;
-    private readonly _fetch;
-    constructor(config: ResiraConfig);
-    /** The resolved API origin used by this client instance. */
-    getBaseUrl(): string;
-    /**
-     * Fetch the public property configuration.
-     *
-     * Returns non-sensitive settings such as the Stripe publishable
-     * key, deposit percentage, currency, and branding info.
-     *
-     * ```ts
-     * const config = await resira.getConfig();
-     * console.log(config.stripePublishableKey); // "pk_test_…"
-     * ```
-     */
-    getConfig(): Promise<PropertyConfig>;
-    /**
-     * Validate a promo/discount code.
-     *
-     * Returns discount details if valid, or an error message if not.
-     *
-     * ```ts
-     * const result = await resira.validatePromoCode("SUMMER20");
-     * if (result.valid) {
-     *   console.log(result.discountType, result.discountValue);
-     * }
-     * ```
-     */
-    validatePromoCode(code: string): Promise<ValidatePromoCodeResponse>;
-    /**
-     * List all active resources for the organization.
-     *
-     * Returns resource cards with name, description, price, duration,
-     * image, and type — suitable for building a resource picker.
-     *
-     * ```ts
-     * const { resources } = await resira.listResources();
-     * ```
-     */
-    listResources(): Promise<ResourceListResponse>;
-    /**
-     * Query availability for a resource.
-     *
-     * **Properties** (date-based):
-     * ```ts
-     * await resira.getAvailability("prop-1", {
-     *   startDate: "2026-07-01",
-     *   endDate: "2026-07-07",
-     * });
-     * ```
-     *
-     * **Restaurants** (time-slot):
-     * ```ts
-     * await resira.getAvailability("table-5", {
-     *   date: "2026-07-01",
-     *   partySize: 4,
-     * });
-     * ```
-     *
-     * Omit params to get all blocked dates (for calendar rendering).
-     */
-    getAvailability(resourceId: string, params?: AvailabilityParams): Promise<Availability>;
-    /**
-     * Query availability for a product/service.
-     *
-     * Aggregates capacity across all linked equipment. If a product
-     * has 2 jet skis (each capacity=1), slots show capacity: 2.
-     * Both pending and confirmed reservations count as occupied.
-     *
-     * ```ts
-     * await resira.getProductAvailability("prod-123", {
-     *   date: "2026-07-01",
-     *   durationMinutes: 30,
-     * });
-     * ```
-     */
-    getProductAvailability(productId: string, params?: AvailabilityParams): Promise<Availability>;
-    /**
-     * Create a reservation.
-     *
-     * Uses `POST /v2/api/reservations` — the `resourceId` is sent in
-     * the request body, **not** in the URL path.
-     *
-     * An `Idempotency-Key` header is automatically attached so that
-     * retries (including those from exponential backoff) are safe.
-     *
-     * ```ts
-     * const { reservation } = await resira.createReservation({
-     *   resourceId: "prop-1",
-     *   guestName: "Jane Doe",
-     *   guestEmail: "jane@example.com",
-     *   startDate: "2026-07-01",
-     *   endDate: "2026-07-07",
-     *   partySize: 3,
-     * });
-     * ```
-     */
-    createReservation(payload: CreateReservationRequest, options?: {
-        idempotencyKey?: string;
-    }): Promise<ReservationResponse>;
-    /**
-     * List reservations for a resource (paginated).
-     *
-     * ```ts
-     * const page = await resira.listReservations("prop-1", {
-     *   status: "confirmed",
-     *   page: 1,
-     *   limit: 50,
-     * });
-     * console.log(page.data);       // Reservation[]
-     * console.log(page.totalPages);  // number
-     * ```
-     */
-    listReservations(resourceId: string, params?: ListReservationsParams): Promise<PaginatedReservations>;
-    /**
-     * Get a single reservation by ID.
-     *
-     * ```ts
-     * const { reservation } = await resira.getReservation("prop-1", "res-uuid");
-     * ```
-     */
-    getReservation(resourceId: string, reservationId: string): Promise<ReservationResponse>;
-    /**
-     * List all active products/services for the organisation.
-     *
-     * Calls `GET /v1/public/products` which returns products with
-     * pricing, duration, and linked equipment.
-     *
-     * Falls back to mapping resources → products if the endpoint
-     * returns 404 (backend hasn't been updated yet).
-     *
-     * ```ts
-     * const { products } = await resira.listProducts();
-     * ```
-     */
-    listProducts(): Promise<ProductListResponse>;
-    /**
-     * List all dishes with 3D model data for the organisation.
-     *
-     * Returns dishes with name, description, price, image, and
-     * 3D model URLs for AR/preview rendering.
-     *
-     * ```ts
-     * const { dishes } = await resira.listDishes();
-     * ```
-     */
-    listDishes(): Promise<DishListResponse>;
-    /**
-     * Get a single dish by ID.
-     *
-     * ```ts
-     * const { dish } = await resira.getDish("dish-uuid");
-     * console.log(dish.name, dish.model?.glbUrl);
-     * ```
-     */
-    getDish(dishId: string): Promise<DishResponse>;
-    /**
-     * Retrieve a checkout session by its token.
-     *
-     * Used to hydrate the checkout screen when opening the widget
-     * with a pre-created session token (skip service selection).
-     *
-     * ```ts
-     * const { session } = await resira.getCheckoutSession("cs_ab12cd34ef56");
-     * console.log(session.productName, session.priceCents);
-     * ```
-     */
-    getCheckoutSession(token: string): Promise<CheckoutSessionResponse>;
-    /**
-     * Create a new checkout session.
-     *
-     * External sites can create a session with product, slot, and guest
-     * details, then pass the returned token to the widget to skip
-     * directly to checkout.
-     *
-     * ```ts
-     * const { sessionToken } = await resira.createCheckoutSession({
-     *   productId: "prod-123",
-     *   durationMinutes: 30,
-     *   partySize: 2,
-     *   date: "2026-07-01",
-     *   startTime: "2026-07-01T10:00:00Z",
-     *   endTime: "2026-07-01T10:30:00Z",
-     * });
-     * ```
-     */
-    createCheckoutSession(payload: CreateCheckoutSessionRequest, options?: {
-        idempotencyKey?: string;
-    }): Promise<CreateCheckoutSessionResponse>;
-    /**
-     * Create a Stripe payment intent for a booking.
-     *
-     * The server creates the payment intent, calculates the amount,
-     * and returns a `clientSecret` to confirm payment on the frontend
-     * using Stripe Elements.
-     *
-     * ```ts
-     * const { clientSecret, amountNow, amountAtVenue } =
-     *   await resira.createPaymentIntent({
-     *     productId: "prod-123",
-     *     resourceId: "res-456",
-     *     partySize: 2,
-     *     startDate: "2026-07-01",
-     *     startTime: "2026-07-01T10:00:00Z",
-     *     endTime: "2026-07-01T11:00:00Z",
-     *     guestName: "Jane Doe",
-     *     guestEmail: "jane@example.com",
-     *   });
-     * ```
-     */
-    createPaymentIntent(payload: CreatePaymentIntentRequest, options?: {
-        idempotencyKey?: string;
-    }): Promise<PaymentIntentResponse>;
-    /**
-     * Confirm that a payment was successful after the guest
-     * completes the Stripe payment flow.
-     *
-     * This transitions the reservation from `pending` to `confirmed`.
-     *
-     * ```ts
-     * const { reservation, paymentStatus } =
-     *   await resira.confirmPayment({
-     *     paymentIntentId: "pi_xxx",
-     *     reservationId: "res-uuid",
-     *   });
-     * ```
-     */
-    confirmPayment(payload: ConfirmPaymentRequest): Promise<ConfirmPaymentResponse>;
-    /**
-     * Execute an HTTP request with retry logic and error normalization.
-     *
-     * - Attaches `Authorization: Bearer <apiKey>` on every request.
-     * - Retries on 429 and 5xx with exponential backoff + jitter.
-     * - Parses error bodies and throws typed error classes.
-     */
-    private request;
-    /**
-     * Calculate backoff delay in milliseconds for a given retry attempt.
-     *
-     * Uses exponential backoff with full jitter:
-     *   delay = random(0, base * 2^attempt)
-     *
-     * For 429 responses, respects the `Retry-After` header as a minimum.
-     */
-    private calculateBackoff;
-}
-
-declare function getRoutingStats(): Record<string, never>;
-
-/**
- * Base error class for all SDK errors.
- *
- * Use `instanceof` checks to distinguish error types:
- *
- * ```ts
- * try { … } catch (e) {
- *   if (e instanceof ResiraRateLimitError) { … }
- *   if (e instanceof ResiraApiError)       { … }
- *   if (e instanceof ResiraNetworkError)   { … }
- * }
- * ```
- */
-declare class ResiraError extends Error {
-    constructor(message: string);
-}
-/**
- * Thrown when the API returns a non-2xx response with a JSON body.
- *
- * ```ts
- * err.status   // 400, 404, 409, 422, 500, …
- * err.code     // HTTP status text (e.g. "Not Found")
- * err.body     // Parsed `{ error: "…" }` from the server
- * ```
- */
-declare class ResiraApiError extends ResiraError {
-    /** HTTP status code. */
-    readonly status: number;
-    /** HTTP status text (e.g. `"Bad Request"`). */
-    readonly code: string;
-    /** Parsed error body from the API. */
-    readonly body: ApiErrorBody;
-    /** The full `Response` object (headers are still accessible). */
-    readonly response: Response;
-    constructor(status: number, code: string, body: ApiErrorBody, response: Response);
-    /** Whether this error is retryable (5xx or 429). */
-    get retryable(): boolean;
-}
-/**
- * Thrown when the API returns 429 Too Many Requests.
- *
- * ```ts
- * err.retryAfter  // Seconds until the client should retry
- * ```
- */
-declare class ResiraRateLimitError extends ResiraApiError {
-    /** Seconds to wait before retrying (from `Retry-After` header). */
-    readonly retryAfter: number;
-    constructor(body: ApiErrorBody, response: Response);
-}
-/**
- * Thrown when the request never reached the server.
- *
- * This wraps the underlying `TypeError` or `DOMException` from
- * `fetch()` failures (DNS resolution, TLS, network offline, etc.).
- */
-declare class ResiraNetworkError extends ResiraError {
-    /** The original error thrown by `fetch`. */
-    readonly cause: unknown;
-    constructor(message: string, cause: unknown);
-}
-
-export { type ApiErrorBody, type Availability, type AvailabilityParams, type CheckoutConfig, type CheckoutSession, type CheckoutSessionResponse, type ConfirmPaymentRequest, type ConfirmPaymentResponse, type CreateCheckoutSessionRequest, type CreateCheckoutSessionResponse, type CreatePaymentIntentRequest, type CreateReservationRequest, type DateAvailability, type Dish, type DishListResponse, type DishModel, type DishResponse, type DurationPrice, type ListReservationsParams, type PaginatedReservations, type PaymentIntentResponse, type PricingModel, type Product, type ProductListResponse, type ProductVariant, type PromoCode, type PropertyConfig, type PublicResource, type RefundRule, type Reservation, type ReservationResponse, Resira, ResiraApiError, type ResiraConfig, ResiraError, ResiraNetworkError, ResiraRateLimitError, type ResourceImage, type ResourceImageDisplaySettings, type ResourceListResponse, type RiderTierPrice, type TimeSlotAvailability, type ValidatePromoCodeResponse, type WeightedBaseUrl, getRoutingStats };
+/**
+ * POST body for creating a reservation.
+ *
+ * Use date fields (`startDate`/`endDate`) for property bookings and
+ * datetime fields (`startTime`/`endTime`) for restaurant/experience
+ * reservations. Both can be provided simultaneously.
+ */
+interface CreateReservationRequest {
+    /** The resource to book. Sent in the request body. */
+    resourceId: string;
+    /** Guest's full name. */
+    guestName: string;
+    /** Guest's email address. Optional for restaurant reservations. */
+    guestEmail?: string;
+    /** Guest's phone number. Required for restaurant if email not provided. */
+    guestPhone?: string;
+    /** Start date in `YYYY-MM-DD` format (date-based resources). Optional for time-based resources. */
+    startDate?: string;
+    /** End date in `YYYY-MM-DD` format (date-based resources). Optional for time-based resources. */
+    endDate?: string;
+    /** Start datetime in ISO 8601 / RFC 3339 (time-based resources). */
+    startTime?: string;
+    /** End datetime in ISO 8601 / RFC 3339 (time-based resources). */
+    endTime?: string;
+    /** Number of guests / party size. Defaults to 2 on the server. */
+    partySize?: number;
+    /** Free-form notes from the guest. */
+    notes?: string;
+}
+/** Query parameters for listing reservations. */
+interface ListReservationsParams {
+    /** Filter by status (e.g. `"pending"`, `"confirmed"`). Omit for all non-archived. */
+    status?: string;
+    /** Page number (1-indexed). Defaults to 1. */
+    page?: number;
+    /** Items per page (1–100). Defaults to 25. */
+    limit?: number;
+}
+/**
+ * Query parameters for the availability endpoint.
+ *
+ * For **properties**: pass `startDate` + `endDate` to check a range,
+ * or omit both to get all blocked dates for calendar rendering.
+ *
+ * For **restaurants**: pass `date` (and optionally `partySize`) to
+ * get time-slot availability for a specific day.
+ */
+interface AvailabilityParams {
+    /** Start date `YYYY-MM-DD` (property: range start). */
+    startDate?: string;
+    /** End date `YYYY-MM-DD` (property: range end). */
+    endDate?: string;
+    /** Date `YYYY-MM-DD` (restaurant: day to query slots for). */
+    date?: string;
+    /** Party size (restaurant: filter by capacity). */
+    partySize?: number;
+    /** Session duration in minutes (watersport/service: controls slot intervals). */
+    durationMinutes?: number;
+}
+/**
+ * A reservation as returned by the public API.
+ *
+ * Intentionally minimal — no Stripe internals, no per-night
+ * breakdown, no audit metadata.
+ */
+interface Reservation {
+    /** Unique reservation identifier. */
+    id: string;
+    /** The resource this reservation belongs to. */
+    resourceId: string;
+    /** Reservation status: `pending`, `confirmed`, `cancelled`, etc. */
+    status: string;
+    /** Start date (`YYYY-MM-DD`) for date-based reservations. */
+    startDate?: string;
+    /** End date (`YYYY-MM-DD`) for date-based reservations. */
+    endDate?: string;
+    /** Start datetime (ISO 8601) for time-based reservations. */
+    startTime?: string;
+    /** End datetime (ISO 8601) for time-based reservations. */
+    endTime?: string;
+    /** Start datetime (ISO 8601) — returned by v2 API for datetime-range reservations. */
+    startDatetime?: string;
+    /** End datetime (ISO 8601) — returned by v2 API for datetime-range reservations. */
+    endDatetime?: string;
+    /** Guest's name. */
+    guestName: string;
+    /** Party size. */
+    partySize: number;
+    /** Total price in the smallest currency unit (cents). */
+    totalPrice: number;
+    /** ISO 4217 currency code (e.g. `"EUR"`). */
+    currency: string;
+    /** When the reservation was created (ISO 8601). */
+    createdAt: string;
+}
+/** Response wrapper for a single reservation. */
+interface ReservationResponse {
+    reservation: Reservation;
+}
+/** Paginated list of reservations. */
+interface PaginatedReservations {
+    data: Reservation[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
+/** Date-level availability for property-like resources. */
+interface DateAvailability {
+    /** Whether the requested date range is fully available. */
+    available?: boolean;
+    /** Sorted list of unavailable dates (`YYYY-MM-DD`). */
+    blockedDates: string[];
+    /** Total price for the requested range (cents). */
+    totalPrice?: number;
+    /** Minimum stay in nights. */
+    minStay?: number;
+}
+/** A single time-slot with remaining capacity (restaurants). */
+interface TimeSlotAvailability {
+    /** Slot start time (ISO 8601). */
+    start: string;
+    /** Slot end time (ISO 8601). */
+    end: string;
+    /** Total capacity. */
+    capacity: number;
+    /** Number of confirmed/pending reservations in this slot. */
+    reserved: number;
+    /** Remaining seats (`capacity - reserved`). */
+    remaining: number;
+    /** Whether the slot has any remaining capacity. */
+    available: boolean;
+}
+/**
+ * Availability response — domain-agnostic.
+ *
+ * For properties, `dates` is populated.
+ * For restaurants, `timeSlots` is populated.
+ * Both are never present simultaneously.
+ */
+interface Availability {
+    /** The resource being queried. */
+    resourceId: string;
+    /** ISO 4217 currency code. */
+    currency: string;
+    /** Date-level availability (properties). */
+    dates?: DateAvailability;
+    /** Time-slot availability (restaurants). */
+    timeSlots?: TimeSlotAvailability[];
+}
+/** Configuration for the Resira SDK client. */
+interface WeightedBaseUrl {
+    /** Base URL for an API origin. */
+    url: string;
+    /** Legacy weight field. Ignored by the SDK in deterministic routing mode. */
+    weight?: number;
+}
+interface ResiraConfig {
+    /** API key (format: `resira_live_<hex>`). */
+    apiKey: string;
+    /**
+     * Base URL of the API.
+      * Overrides default endpoint resolution when set.
+     */
+    baseUrl?: string;
+    /**
+      * Ordered fallback API origins.
+      * The SDK uses the first valid entry deterministically and does not persist routing state in browser storage.
+     */
+    baseUrls?: Array<string | WeightedBaseUrl>;
+    /**
+     * Maximum number of retry attempts for retryable errors (429, 5xx).
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Base delay in milliseconds for exponential backoff.
+     * @default 500
+     */
+    retryBaseDelay?: number;
+    /**
+     * Custom `fetch` implementation (for testing or Node 16 polyfills).
+     * Defaults to the global `fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
+}
+/** Display settings for a resource image (CSS-level transform hints). */
+interface ResourceImageDisplaySettings {
+    /** How the image fits the container. */
+    objectFit?: "cover" | "contain" | "fill" | "none";
+    /** CSS object-position value (e.g. "center center", "top left"). */
+    objectPosition?: string;
+    /** Zoom level (1.0 = no zoom, 2.0 = 200%). */
+    zoom?: number;
+}
+/** A single image entry for a resource (multi-image support). */
+interface ResourceImage {
+    /** CDN URL of the image. */
+    url: string;
+    /** Per-image display preferences. */
+    displaySettings?: ResourceImageDisplaySettings;
+}
+/** A bookable resource as returned by the public API. */
+interface PublicResource {
+    /** Unique resource identifier. */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** URL-friendly slug. */
+    slug: string;
+    /** Resource type (e.g. "boat", "property", "vehicle"). */
+    resourceType: string;
+    /** Max capacity / seats. */
+    capacity: number | null;
+    /** Whether the resource is active. */
+    active: boolean;
+    /** Optional description. */
+    description?: string;
+    /** Optional primary image URL (first image). */
+    imageUrl?: string;
+    /** All images for this resource (ordered). The first is the primary/cover image. */
+    images?: ResourceImage[];
+    /** Price per session in cents (watersport/service). */
+    pricePerSession?: number;
+    /** Session duration in minutes (watersport/service). */
+    durationMinutes?: number;
+    /** Currency code (e.g. "EUR"). */
+    currency?: string;
+    /** Subtype (e.g. "jet_ski", "kayak"). */
+    boatType?: string;
+}
+/** Response wrapper for resource listing. */
+interface ResourceListResponse {
+    resources: PublicResource[];
+    count: number;
+}
+/** Raw error body returned by the API (`{ "error": "..." }`). */
+interface ApiErrorBody {
+    error: string;
+    retryAfter?: number;
+}
+/** Pricing model for a product/service. */
+type PricingModel = "per_session" | "per_person" | "per_rider";
+/** A duration-price pair for multi-duration services. */
+interface DurationPrice {
+    /** Duration in minutes. */
+    durationMinutes: number;
+    /** Price in the smallest currency unit (cents). */
+    priceCents: number;
+}
+/** A rider-tier with its own set of duration-price pairs. */
+interface RiderTierPrice {
+    /** Number of riders this tier applies to. */
+    riders: number;
+    /** Duration-price options for this rider count. */
+    durationPricing: DurationPrice[];
+}
+/** A bookable product/service as returned by the public API. */
+interface Product {
+    /** Unique product identifier. */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Optional description. */
+    description?: string;
+    /** Default duration in minutes (first/shortest option). */
+    durationMinutes: number;
+    /** Default price in the smallest currency unit (cents). */
+    priceCents: number;
+    /** ISO 4217 currency code (e.g. `"EUR"`). */
+    currency: string;
+    /** Optional image URL. */
+    imageUrl?: string;
+    /** Optional calendar/display color for this service, usually configured in admin settings. */
+    serviceColor?: string;
+    /** Whether the product is active. */
+    active: boolean;
+    /** Sort order. */
+    sortOrder?: number;
+    /** Pricing model: flat rate per session or per person. */
+    pricingModel: PricingModel;
+    /** IDs of linked equipment/resources. */
+    equipmentIds: string[];
+    /** Equipment names (resolved by the server). */
+    equipmentNames?: string[];
+    /** Maximum party size for this service (derived from linked equipment's maxPeople). */
+    maxPartySize?: number;
+    /** Available duration options with per-duration pricing. If absent, single duration. */
+    durationPricing?: DurationPrice[];
+    /** Rider-tier pricing (per_rider model). Each tier has a rider count and its own duration-price set. */
+    riderTierPricing?: RiderTierPrice[];
+    /** Normalized product variants with duration and price (returned by v2 API). */
+    variants?: ProductVariant[];
+    /** Available slot durations in minutes (returned by v2 API). */
+    slotDurations?: number[];
+}
+/** Response wrapper for product listing. */
+interface ProductListResponse {
+    products: Product[];
+    count: number;
+}
+/** Request body for creating a payment intent. */
+interface CreatePaymentIntentRequest {
+    /** Product ID being booked. */
+    productId?: string;
+    /** Resource/equipment ID. */
+    resourceId?: string;
+    /** Party size. */
+    partySize?: number;
+    /** Selected duration in minutes (for multi-duration products). */
+    durationMinutes?: number;
+    /** Start date (YYYY-MM-DD). */
+    startDate?: string;
+    /** Start time (ISO 8601, optional). */
+    startTime?: string;
+    /** End time (ISO 8601, optional). */
+    endTime?: string;
+    /** Guest name. */
+    guestName: string;
+    /** Guest email. Optional for restaurant reservations. */
+    guestEmail?: string;
+    /** Guest phone. Required for restaurant if email not provided. */
+    guestPhone?: string;
+    /** Notes (optional). */
+    notes?: string;
+    /** Promo/discount code (optional). Validated server-side. */
+    promoCode?: string;
+    /** Whether the guest accepted terms & conditions. Required when property has termsRequired=true. */
+    termsAccepted?: boolean;
+    /** Checkout session token. When provided, session data is merged with the payload. */
+    checkoutSessionToken?: string;
+}
+/** Response from creating a payment intent. */
+interface PaymentIntentResponse {
+    /** Stripe client secret for confirming payment. */
+    clientSecret: string;
+    /** Payment intent ID. */
+    paymentIntentId: string;
+    /** Amount due now (cents) — maps from backend `amountDue`. */
+    amountNow: number;
+    /** Amount to charge at venue (cents) — computed: totalAmount - amountNow. */
+    amountAtVenue: number;
+    /** Total amount (cents) — maps from backend `totalPrice`. */
+    totalAmount: number;
+    /** Currency code. */
+    currency: string;
+    /** Payment option: "full" or "deposit". */
+    paymentOption?: string;
+    /** The reservation created in pending state (may not be returned). */
+    reservationId?: string;
+    /** Discount amount in cents (if a promo code was applied). */
+    discountAmount?: number;
+    /** Original price before discount (cents). */
+    originalPrice?: number;
+    /** The promo code that was applied (echoed back by server). */
+    promoCodeApplied?: string;
+}
+/** Request to confirm payment was successful. */
+interface ConfirmPaymentRequest {
+    /** The payment intent ID from Stripe. */
+    paymentIntentId: string;
+    /** The reservation ID to confirm. */
+    reservationId: string;
+}
+/** Response after confirming payment. */
+interface ConfirmPaymentResponse {
+    /** The confirmed reservation. */
+    reservation: Reservation;
+    /** Whether payment was successfully captured. */
+    paymentStatus: "succeeded" | "requires_action" | "failed";
+}
+/** Public-safe property configuration returned by GET /v1/public/config. */
+interface PropertyConfig {
+    /** Property name. */
+    name?: string;
+    /** ISO 4217 currency code. */
+    currency?: string;
+    /** Whether online bookings are enabled. */
+    bookingsEnabled?: boolean;
+    /** Deposit percentage (0–100). */
+    depositPercent?: number;
+    /** Primary brand color. */
+    primaryColor?: string;
+    /** Stripe publishable key (pk_test_… or pk_live_…). */
+    stripePublishableKey?: string | null;
+    /** Whether multi-resource selection is allowed. */
+    allowMultiResourceSelect?: boolean;
+    /** Whether guests must accept terms & conditions before booking. */
+    termsRequired?: boolean;
+    /** Custom terms & conditions text shown to guests. */
+    termsText?: string;
+    /** Refund policy rules (sorted by hoursBeforeStart descending). */
+    refundPolicy?: RefundRule[];
+}
+/** A single refund policy rule: if cancellation is >= hoursBeforeStart hours before the booking, refund refundPercent%. */
+interface RefundRule {
+    /** Minimum hours before the booking start time for this tier to apply. */
+    hoursBeforeStart: number;
+    /** Percentage of the payment to refund (0–100). */
+    refundPercent: number;
+}
+/** Response from validating a promo code. */
+interface ValidatePromoCodeResponse {
+    /** Whether the code is valid. */
+    valid: boolean;
+    /** Discount type: "percent" or "fixed". */
+    discountType?: "percent" | "fixed";
+    /** Discount value (percentage 0-100 or fixed amount in cents). */
+    discountValue?: number;
+    /** Currency for fixed discounts. */
+    currency?: string;
+    /** Minimum order amount in cents (if applicable). */
+    minOrderCents?: number;
+    /** Error message if invalid. */
+    error?: string;
+}
+/** A promo code as returned by the admin API. */
+interface PromoCode {
+    id: string;
+    propertyId: string;
+    code: string;
+    discountType: "percent" | "fixed";
+    discountValue: number;
+    currency: string;
+    maxUses: number | null;
+    timesUsed: number;
+    minOrderCents: number;
+    expiresAt: string | null;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A 3D model asset attached to a dish. */
+interface DishModel {
+    /** URL to the GLB/glTF model file. */
+    glbUrl: string;
+    /** URL to the USDZ model file (iOS AR Quick Look). */
+    usdzUrl?: string;
+    /** Optional poster/thumbnail shown while the model loads. */
+    posterUrl?: string;
+    /** Alt text for accessibility. */
+    alt?: string;
+}
+/** A dish as returned by the public API. */
+interface Dish {
+    /** Unique dish identifier (shown in admin for easy copy). */
+    id: string;
+    /** Human-readable dish name. */
+    name: string;
+    /** Optional description. */
+    description?: string;
+    /** Price in the smallest currency unit (cents). */
+    priceCents?: number;
+    /** ISO 4217 currency code (e.g. `"EUR"`). */
+    currency?: string;
+    /** Category or tag (e.g. "Starter", "Main", "Dessert"). */
+    category?: string;
+    /** Optional flat image URL (fallback when 3D is unavailable). */
+    imageUrl?: string;
+    /** 3D model data for AR/preview. */
+    model?: DishModel;
+    /** Whether the dish is currently available. */
+    available?: boolean;
+    /** Allergen tags (e.g. ["gluten", "dairy"]). */
+    allergens?: string[];
+    /** Sort order. */
+    sortOrder?: number;
+}
+/** Response wrapper for a single dish. */
+interface DishResponse {
+    dish: Dish;
+}
+/** Response wrapper for dish listing. */
+interface DishListResponse {
+    dishes: Dish[];
+    count: number;
+}
+/** Checkout configuration embedded in a checkout session. */
+interface CheckoutConfig {
+    /** Stripe publishable key. */
+    stripePublishableKey: string;
+    /** Deposit percentage (0–100). */
+    depositPercent: number;
+    /** Whether terms acceptance is required. */
+    termsRequired: boolean;
+    /** Terms text to display. */
+    termsText?: string;
+}
+/** A checkout session as returned by the API. */
+interface CheckoutSession {
+    /** Unique session token. */
+    sessionToken: string;
+    /** Session status. */
+    status: "pending" | "consumed" | "expired";
+    /** When the session expires (ISO 8601). */
+    expiresAt: string;
+    /** Product ID. */
+    productId: string;
+    /** Product display name. */
+    productName: string;
+    /** Duration in minutes. */
+    durationMinutes: number;
+    /** Price in smallest currency unit (cents). */
+    priceCents: number;
+    /** ISO 4217 currency code. */
+    currency: string;
+    /** Party size / number of riders. */
+    partySize: number;
+    /** Pricing model. */
+    pricingModel: PricingModel;
+    /** Booking date (YYYY-MM-DD). */
+    date: string;
+    /** Start time (ISO 8601). */
+    startTime: string;
+    /** End time (ISO 8601). */
+    endTime: string;
+    /** Service display color. */
+    serviceColor?: string;
+    /** Product image URL. */
+    imageUrl?: string;
+    /** Pre-filled guest name. */
+    guestName?: string;
+    /** Pre-filled guest email. */
+    guestEmail?: string;
+    /** Pre-applied promo code. */
+    promoCode?: string;
+    /** Checkout-specific configuration. */
+    checkoutConfig: CheckoutConfig;
+}
+/** Response wrapper for a checkout session. */
+interface CheckoutSessionResponse {
+    session: CheckoutSession;
+}
+/** Request body for creating a checkout session. */
+interface CreateCheckoutSessionRequest {
+    /** Product ID. */
+    productId: string;
+    /** Duration in minutes. */
+    durationMinutes: number;
+    /** Party size. */
+    partySize: number;
+    /** Booking date (YYYY-MM-DD). */
+    date: string;
+    /** Start time (ISO 8601). */
+    startTime: string;
+    /** End time (ISO 8601). */
+    endTime: string;
+    /** Guest name (optional). */
+    guestName?: string;
+    /** Guest email (optional). */
+    guestEmail?: string;
+    /** Promo code (optional). */
+    promoCode?: string;
+}
+/** Response from creating a checkout session. */
+interface CreateCheckoutSessionResponse {
+    sessionToken: string;
+    expiresAt: string;
+}
+/** A normalized product variant with duration and price. */
+interface ProductVariant {
+    /** Duration in minutes. */
+    durationMinutes: number;
+    /** Price in smallest currency unit (cents). */
+    priceCents: number;
+    /** Optional display label (e.g. "Full Hour"). */
+    label?: string;
+}
+
+/**
+ * Resira SDK client.
+ *
+ * ```ts
+ * const resira = new Resira({
+ *   apiKey: "resira_live_abc123…",
+ *   baseUrl: "https://api.example.com", // optional
+ * });
+ *
+ * const availability = await resira.getAvailability("prop-1", {
+ *   startDate: "2026-07-01",
+ *   endDate: "2026-07-07",
+ * });
+ * ```
+ */
+declare class Resira {
+    private readonly apiKey;
+    private readonly baseUrls;
+    private readonly maxRetries;
+    private readonly retryBaseDelay;
+    private readonly _fetch;
+    constructor(config: ResiraConfig);
+    /** The resolved API origin used by this client instance. */
+    getBaseUrl(): string;
+    /**
+     * Fetch the public property configuration.
+     *
+     * Returns non-sensitive settings such as the Stripe publishable
+     * key, deposit percentage, currency, and branding info.
+     *
+     * ```ts
+     * const config = await resira.getConfig();
+     * console.log(config.stripePublishableKey); // "pk_test_…"
+     * ```
+     */
+    getConfig(): Promise<PropertyConfig>;
+    /**
+     * Validate a promo/discount code.
+     *
+     * Returns discount details if valid, or an error message if not.
+     *
+     * ```ts
+     * const result = await resira.validatePromoCode("SUMMER20");
+     * if (result.valid) {
+     *   console.log(result.discountType, result.discountValue);
+     * }
+     * ```
+     */
+    validatePromoCode(code: string): Promise<ValidatePromoCodeResponse>;
+    /**
+     * List all active resources for the organization.
+     *
+     * Returns resource cards with name, description, price, duration,
+     * image, and type — suitable for building a resource picker.
+     *
+     * ```ts
+     * const { resources } = await resira.listResources();
+     * ```
+     */
+    listResources(): Promise<ResourceListResponse>;
+    /**
+     * Query availability for a resource.
+     *
+     * **Properties** (date-based):
+     * ```ts
+     * await resira.getAvailability("prop-1", {
+     *   startDate: "2026-07-01",
+     *   endDate: "2026-07-07",
+     * });
+     * ```
+     *
+     * **Restaurants** (time-slot):
+     * ```ts
+     * await resira.getAvailability("table-5", {
+     *   date: "2026-07-01",
+     *   partySize: 4,
+     * });
+     * ```
+     *
+     * Omit params to get all blocked dates (for calendar rendering).
+     */
+    getAvailability(resourceId: string, params?: AvailabilityParams): Promise<Availability>;
+    /**
+     * Query availability for a product/service.
+     *
+     * Aggregates capacity across all linked equipment. If a product
+     * has 2 jet skis (each capacity=1), slots show capacity: 2.
+     * Both pending and confirmed reservations count as occupied.
+     *
+     * ```ts
+     * await resira.getProductAvailability("prod-123", {
+     *   date: "2026-07-01",
+     *   durationMinutes: 30,
+     * });
+     * ```
+     */
+    getProductAvailability(productId: string, params?: AvailabilityParams): Promise<Availability>;
+    /**
+     * Create a reservation.
+     *
+     * Uses `POST /v2/api/reservations` — the `resourceId` is sent in
+     * the request body, **not** in the URL path.
+     *
+     * An `Idempotency-Key` header is automatically attached so that
+     * retries (including those from exponential backoff) are safe.
+     *
+     * ```ts
+     * const { reservation } = await resira.createReservation({
+     *   resourceId: "prop-1",
+     *   guestName: "Jane Doe",
+     *   guestEmail: "jane@example.com",
+     *   startDate: "2026-07-01",
+     *   endDate: "2026-07-07",
+     *   partySize: 3,
+     * });
+     * ```
+     */
+    createReservation(payload: CreateReservationRequest, options?: {
+        idempotencyKey?: string;
+    }): Promise<ReservationResponse>;
+    /**
+     * List reservations for a resource (paginated).
+     *
+     * ```ts
+     * const page = await resira.listReservations("prop-1", {
+     *   status: "confirmed",
+     *   page: 1,
+     *   limit: 50,
+     * });
+     * console.log(page.data);       // Reservation[]
+     * console.log(page.totalPages);  // number
+     * ```
+     */
+    listReservations(resourceId: string, params?: ListReservationsParams): Promise<PaginatedReservations>;
+    /**
+     * Get a single reservation by ID.
+     *
+     * ```ts
+     * const { reservation } = await resira.getReservation("prop-1", "res-uuid");
+     * ```
+     */
+    getReservation(resourceId: string, reservationId: string): Promise<ReservationResponse>;
+    /**
+     * List all active products/services for the organisation.
+     *
+     * Calls `GET /v1/public/products` which returns products with
+     * pricing, duration, and linked equipment.
+     *
+     * Falls back to mapping resources → products if the endpoint
+     * returns 404 (backend hasn't been updated yet).
+     *
+     * ```ts
+     * const { products } = await resira.listProducts();
+     * ```
+     */
+    listProducts(): Promise<ProductListResponse>;
+    /**
+     * List all dishes with 3D model data for the organisation.
+     *
+     * Returns dishes with name, description, price, image, and
+     * 3D model URLs for AR/preview rendering.
+     *
+     * ```ts
+     * const { dishes } = await resira.listDishes();
+     * ```
+     */
+    listDishes(): Promise<DishListResponse>;
+    /**
+     * Get a single dish by ID.
+     *
+     * ```ts
+     * const { dish } = await resira.getDish("dish-uuid");
+     * console.log(dish.name, dish.model?.glbUrl);
+     * ```
+     */
+    getDish(dishId: string): Promise<DishResponse>;
+    /**
+     * Retrieve a checkout session by its token.
+     *
+     * Used to hydrate the checkout screen when opening the widget
+     * with a pre-created session token (skip service selection).
+     *
+     * ```ts
+     * const { session } = await resira.getCheckoutSession("cs_ab12cd34ef56");
+     * console.log(session.productName, session.priceCents);
+     * ```
+     */
+    getCheckoutSession(token: string): Promise<CheckoutSessionResponse>;
+    /**
+     * Create a new checkout session.
+     *
+     * External sites can create a session with product, slot, and guest
+     * details, then pass the returned token to the widget to skip
+     * directly to checkout.
+     *
+     * ```ts
+     * const { sessionToken } = await resira.createCheckoutSession({
+     *   productId: "prod-123",
+     *   durationMinutes: 30,
+     *   partySize: 2,
+     *   date: "2026-07-01",
+     *   startTime: "2026-07-01T10:00:00Z",
+     *   endTime: "2026-07-01T10:30:00Z",
+     * });
+     * ```
+     */
+    createCheckoutSession(payload: CreateCheckoutSessionRequest, options?: {
+        idempotencyKey?: string;
+    }): Promise<CreateCheckoutSessionResponse>;
+    /**
+     * Create a Stripe payment intent for a booking.
+     *
+     * The server creates the payment intent, calculates the amount,
+     * and returns a `clientSecret` to confirm payment on the frontend
+     * using Stripe Elements.
+     *
+     * ```ts
+     * const { clientSecret, amountNow, amountAtVenue } =
+     *   await resira.createPaymentIntent({
+     *     productId: "prod-123",
+     *     resourceId: "res-456",
+     *     partySize: 2,
+     *     startDate: "2026-07-01",
+     *     startTime: "2026-07-01T10:00:00Z",
+     *     endTime: "2026-07-01T11:00:00Z",
+     *     guestName: "Jane Doe",
+     *     guestEmail: "jane@example.com",
+     *   });
+     * ```
+     */
+    createPaymentIntent(payload: CreatePaymentIntentRequest, options?: {
+        idempotencyKey?: string;
+    }): Promise<PaymentIntentResponse>;
+    /**
+     * Confirm that a payment was successful after the guest
+     * completes the Stripe payment flow.
+     *
+     * This transitions the reservation from `pending` to `confirmed`.
+     *
+     * ```ts
+     * const { reservation, paymentStatus } =
+     *   await resira.confirmPayment({
+     *     paymentIntentId: "pi_xxx",
+     *     reservationId: "res-uuid",
+     *   });
+     * ```
+     */
+    confirmPayment(payload: ConfirmPaymentRequest): Promise<ConfirmPaymentResponse>;
+    /**
+     * Execute an HTTP request with retry logic and error normalization.
+     *
+     * - Attaches `Authorization: Bearer <apiKey>` on every request.
+     * - Retries on 429 and 5xx with exponential backoff + jitter.
+     * - Parses error bodies and throws typed error classes.
+     */
+    private request;
+    /**
+     * Calculate backoff delay in milliseconds for a given retry attempt.
+     *
+     * Uses exponential backoff with full jitter:
+     *   delay = random(0, base * 2^attempt)
+     *
+     * For 429 responses, respects the `Retry-After` header as a minimum.
+     */
+    private calculateBackoff;
+}
+
+declare function getRoutingStats(): Record<string, never>;
+
+/**
+ * Base error class for all SDK errors.
+ *
+ * Use `instanceof` checks to distinguish error types:
+ *
+ * ```ts
+ * try { … } catch (e) {
+ *   if (e instanceof ResiraRateLimitError) { … }
+ *   if (e instanceof ResiraApiError)       { … }
+ *   if (e instanceof ResiraNetworkError)   { … }
+ * }
+ * ```
+ */
+declare class ResiraError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when the API returns a non-2xx response with a JSON body.
+ *
+ * ```ts
+ * err.status   // 400, 404, 409, 422, 500, …
+ * err.code     // HTTP status text (e.g. "Not Found")
+ * err.body     // Parsed `{ error: "…" }` from the server
+ * ```
+ */
+declare class ResiraApiError extends ResiraError {
+    /** HTTP status code. */
+    readonly status: number;
+    /** HTTP status text (e.g. `"Bad Request"`). */
+    readonly code: string;
+    /** Parsed error body from the API. */
+    readonly body: ApiErrorBody;
+    /** The full `Response` object (headers are still accessible). */
+    readonly response: Response;
+    constructor(status: number, code: string, body: ApiErrorBody, response: Response);
+    /** Whether this error is retryable (5xx or 429). */
+    get retryable(): boolean;
+}
+/**
+ * Thrown when the API returns 429 Too Many Requests.
+ *
+ * ```ts
+ * err.retryAfter  // Seconds until the client should retry
+ * ```
+ */
+declare class ResiraRateLimitError extends ResiraApiError {
+    /** Seconds to wait before retrying (from `Retry-After` header). */
+    readonly retryAfter: number;
+    constructor(body: ApiErrorBody, response: Response);
+}
+/**
+ * Thrown when the request never reached the server.
+ *
+ * This wraps the underlying `TypeError` or `DOMException` from
+ * `fetch()` failures (DNS resolution, TLS, network offline, etc.).
+ */
+declare class ResiraNetworkError extends ResiraError {
+    /** The original error thrown by `fetch`. */
+    readonly cause: unknown;
+    constructor(message: string, cause: unknown);
+}
+
+export { type ApiErrorBody, type Availability, type AvailabilityParams, type CheckoutConfig, type CheckoutSession, type CheckoutSessionResponse, type ConfirmPaymentRequest, type ConfirmPaymentResponse, type CreateCheckoutSessionRequest, type CreateCheckoutSessionResponse, type CreatePaymentIntentRequest, type CreateReservationRequest, type DateAvailability, type Dish, type DishListResponse, type DishModel, type DishResponse, type DurationPrice, type ListReservationsParams, type PaginatedReservations, type PaymentIntentResponse, type PricingModel, type Product, type ProductListResponse, type ProductVariant, type PromoCode, type PropertyConfig, type PublicResource, type RefundRule, type Reservation, type ReservationResponse, Resira, ResiraApiError, type ResiraConfig, ResiraError, ResiraNetworkError, ResiraRateLimitError, type ResourceImage, type ResourceImageDisplaySettings, type ResourceListResponse, type RiderTierPrice, type TimeSlotAvailability, type ValidatePromoCodeResponse, type WeightedBaseUrl, getRoutingStats };