more-apartments-astro-integration 1.4.0 → 1.5.3

package/dist/index.d.mts

@@ -107,7 +107,7 @@ declare const PropertySchema: z.ZodObject<{
     zipcode: z.ZodNullable<z.ZodString>;
     area: z.ZodNullable<z.ZodString>;
     city: z.ZodString;
-    country: z.ZodString;
+    country: z.ZodNullable<z.ZodString>;
     latitude: z.ZodNumber;
     longitude: z.ZodNumber;
     single_bed: z.ZodNullable<z.ZodNumber>;
@@ -231,7 +231,7 @@ declare const PropertySearchResultSchema: z.ZodObject<{
         zipcode: z.ZodNullable<z.ZodString>;
         area: z.ZodNullable<z.ZodString>;
         city: z.ZodString;
-        country: z.ZodString;
+        country: z.ZodNullable<z.ZodString>;
         latitude: z.ZodNumber;
         longitude: z.ZodNumber;
         single_bed: z.ZodNullable<z.ZodNumber>;
@@ -516,47 +516,294 @@ type ThemeSettings = z.infer<typeof ThemeSettingsSchema>;
 type PropertySettings = z.infer<typeof PropertySettingsSchema>;
 type BookingSettings = z.infer<typeof BookingSettingsSchema>;
 
-declare const BookingRequestSchema: z.ZodObject<{
+/**
+ * Booking-related types and schemas for the 3-step booking wizard
+ */
+type BookingStatus = 'pending_details' | 'waiting_payment' | 'fresh' | 'confirmed' | 'cancelled' | 'completed';
+type PaymentMethod = 'stripe' | 'bank_transfer' | 'cash';
+interface BookingDraftRequest {
+    property_id: number;
+    arrival: string;
+    departure: string;
+    amount_adults: number;
+    amount_children: number;
+}
+interface BookingDraftResponse {
+    uuid: string;
+    status: 'pending_details';
+    property_id: number;
+    arrival: string;
+    departure: string;
+    amount_adults: number;
+    amount_children: number;
+    total_price: number;
+    nights: number;
+    expires_at: string;
+    created_at: string;
+    updated_at: string;
+}
+interface PersonalInfoRequest {
+    first_name: string;
+    last_name: string;
+    email: string;
+    phone: string;
+    address_1: string;
+    address_2?: string;
+    postal_code?: string;
+    city: string;
+    country: string;
+}
+interface BookingDetailsRequest {
+    time_arrival: string;
+    flight?: string;
+    notes?: string;
+}
+interface ReviewRequest {
+    terms_accepted: boolean;
+    marketing_consent?: boolean;
+}
+interface PriceBreakdown {
+    base_price: number;
+    cleaning_fee: number;
+    tourist_tax: number;
+    vat: number;
+    total: number;
+}
+interface PropertySummary {
+    id: number;
+    name: string;
+    slug: string;
+    city: string;
+    image: string;
+    max_guests: number;
+}
+interface BookingResponse {
+    uuid: string;
+    status: BookingStatus;
+    property_id: number;
+    property?: PropertySummary;
+    arrival: string;
+    departure: string;
+    amount_adults: number;
+    amount_children: number;
+    first_name?: string;
+    last_name?: string;
+    email?: string;
+    phone?: string;
+    address_1?: string;
+    address_2?: string;
+    postal_code?: string;
+    city?: string;
+    country?: string;
+    time_arrival?: string;
+    flight?: string;
+    notes?: string;
+    terms_accepted?: boolean;
+    marketing_consent?: boolean;
+    total_price: number;
+    price_breakdown?: PriceBreakdown;
+    nights: number;
+    expires_at: string;
+    created_at: string;
+    updated_at: string;
+}
+interface BookingConfirmResponse {
+    message: string;
+    data: {
+        uuid: string;
+        status: BookingStatus;
+        property_id: number;
+        arrival: string;
+        departure: string;
+        first_name: string;
+        last_name: string;
+        email: string;
+        phone: string;
+        address_1: string;
+        address_2?: string;
+        postal_code?: string;
+        city: string;
+        country: string;
+        amount_adults: number;
+        amount_children: number;
+        time_arrival: string;
+        flight?: string;
+        notes?: string;
+        external_id?: string;
+        identifier?: string;
+        balance_due: number;
+        created_at: string;
+        updated_at: string;
+    };
+    stripe_url?: string;
+}
+declare const BookingDraftRequestSchema: z.ZodObject<{
     property_id: z.ZodNumber;
-    check_in: z.ZodString;
-    check_out: z.ZodString;
-    guests: z.ZodNumber;
+    arrival: z.ZodString;
+    departure: z.ZodString;
+    amount_adults: z.ZodNumber;
+    amount_children: z.ZodNumber;
+}, z.core.$strip>;
+declare const BookingDraftResponseSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    status: z.ZodLiteral<"pending_details">;
+    property_id: z.ZodNumber;
+    arrival: z.ZodString;
+    departure: z.ZodString;
+    amount_adults: z.ZodNumber;
+    amount_children: z.ZodNumber;
+    total_price: z.ZodNumber;
+    nights: z.ZodNumber;
+    expires_at: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+declare const PersonalInfoRequestSchema: z.ZodObject<{
     first_name: z.ZodString;
     last_name: z.ZodString;
     email: z.ZodString;
-    phone: z.ZodOptional<z.ZodString>;
+    phone: z.ZodString;
+    address_1: z.ZodString;
+    address_2: z.ZodOptional<z.ZodString>;
+    postal_code: z.ZodOptional<z.ZodString>;
+    city: z.ZodString;
+    country: z.ZodString;
+}, z.core.$strip>;
+declare const BookingDetailsRequestSchema: z.ZodObject<{
+    time_arrival: z.ZodString;
+    flight: z.ZodOptional<z.ZodString>;
     notes: z.ZodOptional<z.ZodString>;
-    total_amount: z.ZodNumber;
-    payment_method: z.ZodOptional<z.ZodEnum<{
-        stripe: "stripe";
-        cash: "cash";
-        bank_transfer: "bank_transfer";
-    }>>;
 }, z.core.$strip>;
-declare const BookingResponseSchema: z.ZodObject<{
-    id: z.ZodString;
+declare const ReviewRequestSchema: z.ZodObject<{
+    terms_accepted: z.ZodBoolean;
+    marketing_consent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const PropertySummarySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    slug: z.ZodString;
+    city: z.ZodString;
+    image: z.ZodString;
+    max_guests: z.ZodNumber;
+}, z.core.$strip>;
+declare const PriceBreakdownSchema: z.ZodObject<{
+    base_price: z.ZodNumber;
+    cleaning_fee: z.ZodNumber;
+    tourist_tax: z.ZodNumber;
+    vat: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+interface BookingPricingResponse {
+    uuid: string;
+    property_id: number;
+    arrival: string;
+    departure: string;
+    amount_adults: number;
+    amount_children: number;
+    nights: number;
+    total_price: number;
+    price_per_night: number;
+    currency: string;
+}
+declare const BookingPricingResponseSchema: z.ZodObject<{
+    uuid: z.ZodString;
     property_id: z.ZodNumber;
-    check_in: z.ZodString;
-    check_out: z.ZodString;
-    guests: z.ZodNumber;
+    arrival: z.ZodString;
+    departure: z.ZodString;
+    amount_adults: z.ZodNumber;
+    amount_children: z.ZodNumber;
+    nights: z.ZodNumber;
+    total_price: z.ZodNumber;
+    price_per_night: z.ZodNumber;
+    currency: z.ZodString;
+}, z.core.$strip>;
+declare const BookingResponseSchema: z.ZodObject<{
+    uuid: z.ZodString;
     status: z.ZodEnum<{
-        pending: "pending";
+        pending_details: "pending_details";
+        waiting_payment: "waiting_payment";
+        fresh: "fresh";
         confirmed: "confirmed";
         cancelled: "cancelled";
         completed: "completed";
     }>;
-    total_amount: z.ZodNumber;
-    payment_status: z.ZodEnum<{
-        pending: "pending";
-        paid: "paid";
-        refunded: "refunded";
-    }>;
-    confirmation_code: z.ZodString;
+    property_id: z.ZodNumber;
+    property: z.ZodOptional<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        slug: z.ZodString;
+        city: z.ZodString;
+        image: z.ZodString;
+        max_guests: z.ZodNumber;
+    }, z.core.$strip>>;
+    arrival: z.ZodString;
+    departure: z.ZodString;
+    amount_adults: z.ZodNumber;
+    amount_children: z.ZodNumber;
+    first_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    last_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    address_1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    address_2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    postal_code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    city: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    country: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    time_arrival: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    flight: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    terms_accepted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    marketing_consent: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    total_price: z.ZodNumber;
+    price_breakdown: z.ZodOptional<z.ZodObject<{
+        base_price: z.ZodNumber;
+        cleaning_fee: z.ZodNumber;
+        tourist_tax: z.ZodNumber;
+        vat: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>>;
+    nights: z.ZodNumber;
+    expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_at: z.ZodString;
     updated_at: z.ZodString;
 }, z.core.$strip>;
-type BookingRequest = z.infer<typeof BookingRequestSchema>;
-type BookingResponse = z.infer<typeof BookingResponseSchema>;
+declare const BookingConfirmResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    data: z.ZodObject<{
+        uuid: z.ZodString;
+        status: z.ZodEnum<{
+            pending_details: "pending_details";
+            waiting_payment: "waiting_payment";
+            fresh: "fresh";
+            confirmed: "confirmed";
+            cancelled: "cancelled";
+            completed: "completed";
+        }>;
+        property_id: z.ZodNumber;
+        arrival: z.ZodString;
+        departure: z.ZodString;
+        first_name: z.ZodString;
+        last_name: z.ZodString;
+        email: z.ZodString;
+        phone: z.ZodString;
+        address_1: z.ZodString;
+        address_2: z.ZodOptional<z.ZodString>;
+        postal_code: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        country: z.ZodString;
+        amount_adults: z.ZodNumber;
+        amount_children: z.ZodNumber;
+        time_arrival: z.ZodString;
+        flight: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodString>;
+        identifier: z.ZodOptional<z.ZodString>;
+        balance_due: z.ZodNumber;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>;
+    stripe_url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 
 declare const MoreApartmentsConfigSchema: z.ZodObject<{
     baseUrl: z.ZodOptional<z.ZodString>;
@@ -624,8 +871,52 @@ declare class MoreApartmentsClient {
     getThemeSettings(): Promise<ThemeSettings>;
     getPropertySettings(): Promise<PropertySettings>;
     getBookingSettings(): Promise<BookingSettings>;
-    createBooking(booking: BookingRequest): Promise<BookingResponse>;
-    getBooking(bookingId: string): Promise<BookingResponse>;
+    /**
+     * Create a booking draft with property and dates
+     * @param data Draft booking data (property, dates, guests)
+     * @returns BookingDraftResponse with UUID and status
+     */
+    createBookingDraft(data: BookingDraftRequest): Promise<BookingDraftResponse>;
+    /**
+     * Update booking with personal information (Step 1)
+     * @param uuid Booking UUID
+     * @param data Personal info (name, email, phone, address)
+     * @returns Updated BookingResponse
+     */
+    updateBookingStep1(uuid: string, data: PersonalInfoRequest): Promise<BookingResponse>;
+    /**
+     * Update booking with arrival details (Step 2)
+     * @param uuid Booking UUID
+     * @param data Arrival time, flight, notes
+     * @returns Updated BookingResponse
+     */
+    updateBookingStep2(uuid: string, data: BookingDetailsRequest): Promise<BookingResponse>;
+    /**
+     * Update booking with review data (Step 3)
+     * @param uuid Booking UUID
+     * @param data Terms acceptance, marketing consent
+     * @returns Updated BookingResponse with price breakdown
+     */
+    updateBookingStep3(uuid: string, data: ReviewRequest): Promise<BookingResponse>;
+    /**
+     * Confirm booking and get payment URL
+     * @param uuid Booking UUID
+     * @param paymentMethod Payment method (stripe, bank_transfer, cash)
+     * @returns Confirmation response with payment URL
+     */
+    confirmBooking(uuid: string, paymentMethod?: PaymentMethod): Promise<BookingConfirmResponse>;
+    /**
+     * Get current booking state
+     * @param uuid Booking UUID
+     * @returns Full BookingResponse with all data
+     */
+    getBookingState(uuid: string): Promise<BookingResponse>;
+    /**
+     * Get pricing details for a booking
+     * @param uuid Booking UUID
+     * @returns Pricing breakdown with total, per-night rate, and currency
+     */
+    getPricing(uuid: string): Promise<BookingPricingResponse>;
     /**
      * Search properties with advanced filtering
      */
@@ -721,6 +1012,12 @@ interface MoreApartmentsIntegrationOptions extends MoreApartmentsConfig {
      * @example '../prj-more-apartments/instance/stayci.com'
      */
     instancePath?: string;
+    /**
+     * Path to More Apartments project root directory
+     * Used for auto-loading .headless-token file during local development
+     * @example '../prj-more-apartments'
+     */
+    projectPath?: string;
 }
 declare function moreApartmentsIntegration(options: MoreApartmentsIntegrationOptions): AstroIntegration;
 /**
@@ -767,7 +1064,7 @@ declare function fetchProperties(client: MoreApartmentsClient, params?: {
     zipcode: string | null;
     area: string | null;
     city: string;
-    country: string;
+    country: string | null;
     latitude: number;
     longitude: number;
     single_bed: number | null;
@@ -889,7 +1186,7 @@ declare function fetchProperty(client: MoreApartmentsClient, idOrSlug: number |
     zipcode: string | null;
     area: string | null;
     city: string;
-    country: string;
+    country: string | null;
     latitude: number;
     longitude: number;
     single_bed: number | null;
@@ -1250,7 +1547,7 @@ declare function searchProperties(client: MoreApartmentsClient, params: Property
     zipcode: string | null;
     area: string | null;
     city: string;
-    country: string;
+    country: string | null;
     latitude: number;
     longitude: number;
     single_bed: number | null;
@@ -1335,4 +1632,4 @@ declare function searchProperties(client: MoreApartmentsClient, params: Property
     }[] | undefined;
 }[]>;
 
-export { type ApiError, ApiErrorSchema, type Availability, AvailabilitySchema, AvailableDay, type BookingRequest, BookingRequestSchema, type BookingResponse, BookingResponseSchema, type BookingSettings, BookingSettingsSchema, type Category, CategorySchema, type CategorySegment, CategorySegmentSchema, type MainSettings, MainSettingsSchema, MoreApartmentsClient, type MoreApartmentsConfig, MoreApartmentsConfigSchema, type Page, PageSchema, type PaginatedResponse, PaginatedResponseSchema, type PaginationLinks, PaginationLinksSchema, type PaginationMeta, PaginationMetaSchema, type Post, PostSchema, type Property, type PropertyImage, PropertyImageSchema, type PropertyPageSettings, PropertyPageSettingsSchema, PropertySchema, type PropertySearchParams, PropertySearchParamsSchema, type PropertySearchResult, PropertySearchResultSchema, type PropertySettings, PropertySettingsSchema, type ThemeSettings, ThemeSettingsSchema, moreApartmentsIntegration as default, fetchAvailability, fetchPage, fetchPages, fetchPost, fetchPosts, fetchProperties, fetchProperty, fetchSettings, generateBookingUrl, getAllImageUrls, getAllThumbnailUrls, getImage, getImageCount, getImageWithAlt, getPrimaryImageUrl, getThumbnailUrl, hasImages, searchProperties };
+export { type ApiError, ApiErrorSchema, type Availability, AvailabilitySchema, AvailableDay, type BookingConfirmResponse, BookingConfirmResponseSchema, type BookingDetailsRequest, BookingDetailsRequestSchema, type BookingDraftRequest, BookingDraftRequestSchema, type BookingDraftResponse, BookingDraftResponseSchema, type BookingPricingResponse, BookingPricingResponseSchema, type BookingResponse, BookingResponseSchema, type BookingSettings, BookingSettingsSchema, type BookingStatus, type Category, CategorySchema, type CategorySegment, CategorySegmentSchema, type MainSettings, MainSettingsSchema, MoreApartmentsClient, type MoreApartmentsConfig, MoreApartmentsConfigSchema, type Page, PageSchema, type PaginatedResponse, PaginatedResponseSchema, type PaginationLinks, PaginationLinksSchema, type PaginationMeta, PaginationMetaSchema, type PaymentMethod, type PersonalInfoRequest, PersonalInfoRequestSchema, type Post, PostSchema, type PriceBreakdown, PriceBreakdownSchema, type Property, type PropertyImage, PropertyImageSchema, type PropertyPageSettings, PropertyPageSettingsSchema, PropertySchema, type PropertySearchParams, PropertySearchParamsSchema, type PropertySearchResult, PropertySearchResultSchema, type PropertySettings, PropertySettingsSchema, type PropertySummary, PropertySummarySchema, type ReviewRequest, ReviewRequestSchema, type ThemeSettings, ThemeSettingsSchema, moreApartmentsIntegration as default, fetchAvailability, fetchPage, fetchPages, fetchPost, fetchPosts, fetchProperties, fetchProperty, fetchSettings, generateBookingUrl, getAllImageUrls, getAllThumbnailUrls, getImage, getImageCount, getImageWithAlt, getPrimaryImageUrl, getThumbnailUrl, hasImages, searchProperties };