@travories/frontend-sdk 0.1.2 → 0.1.4

package/dist/index.d.mts

@@ -215,6 +215,24 @@ interface AgencyBundle {
     associations: AgencyAssociationItem[];
     packages: HomePackageCard[];
 }
+/** One row in the booking's traveler breakdown. `name` is the category label. */
+interface BookingTraveler {
+    /** "Adult" | "Senior Citizen" | "Children" | "Infant" */
+    name: string;
+    count: number;
+}
+interface BookingInitiateRequest {
+    /** Package slug (NOT the package UUID — the BE looks it up by slug). */
+    packageId: string;
+    /** ISO date string, e.g. "2027-08-15". */
+    arrivalDate: string;
+    travelers: BookingTraveler[];
+}
+interface BookingInitiateResponse {
+    message: string;
+    /** Booking UUID. Used to build the payment URL: `/package/<data>/payment`. */
+    data: string;
+}
 
 declare class PackagesResource {
     private http;
@@ -268,6 +286,24 @@ declare class AgenciesResource {
     }, options?: HttpRequestOptions): Promise<AgencyBundle | null>;
 }
 
+/**
+ * Booking-related endpoints. Currently exposes the kickoff step (`initiate`);
+ * the rest of the flow (payment, confirmation) lives on travories.com today.
+ */
+declare class BookingsResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Open a booking. The BE returns a booking UUID — combine it with
+     *   `https://travories.com/package/<id>/payment`
+     * to send the user into the existing payment flow.
+     *
+     * Throws (not silent) so the consumer can surface errors to the user. Wrap
+     * in try/catch in your `onReserve` handler.
+     */
+    initiate(payload: BookingInitiateRequest, options?: HttpRequestOptions): Promise<BookingInitiateResponse>;
+}
+
 interface TravoriesClientConfig extends HttpClientConfig {
 }
 /**
@@ -288,6 +324,7 @@ declare class TravoriesClient {
     private http;
     packages: PackagesResource;
     agencies: AgenciesResource;
+    bookings: BookingsResource;
     constructor(config: TravoriesClientConfig);
     getPackageBySlug: (slug: string) => Promise<TravoriesPackage | null>;
     getPackageBundle: (slug: string) => Promise<PackageBundle | null>;
@@ -484,6 +521,15 @@ interface PackageCardProps {
  */
 declare const PackageCard: React.FC<PackageCardProps>;
 
+/** Booking details the user picked in the BookingCardLite when they hit Reserve. */
+interface ReservePayload {
+    pkg: TravoriesPackage;
+    arrival: string;
+    departure: string;
+    travelers: BookingTraveler[];
+    totalCost: number;
+    pricePerPerson: number;
+}
 interface PackageDetailViewProps {
     /** Travories SDK client. Required when using `slug`. */
     client?: TravoriesClient;
@@ -493,8 +539,10 @@ interface PackageDetailViewProps {
     initialBundle?: PackageBundle | null;
     /** Currency code for prices (default "USD"). */
     currency?: string;
-    /** Called when the user hits Reserve. If omitted, the button shows a disabled state. */
-    onReserve?: (pkg: TravoriesPackage) => void;
+    /** Called when the user hits Reserve. Receives the full picked payload
+     *  (pkg + arrival date + travelers + computed totals). Return a Promise to
+     *  show an "Initiating…" state on the CTA until it resolves. */
+    onReserve?: (payload: ReservePayload) => void | Promise<void>;
     /** Called when the user clicks the host card. Receives the host. */
     onSelectHost?: (host: PackageHost) => void;
     /** When set, host card renders as `<a href={agencyHrefFor(host)}>` — enables
@@ -617,7 +665,7 @@ interface DescriptionSectionProps {
     DescriptionData: DescriptionData;
     topData: TopData;
     currency?: string;
-    onReserve?: (pkg: TravoriesPackage) => void;
+    onReserve?: (payload: ReservePayload) => void | Promise<void>;
     pkg: TravoriesPackage;
     routes?: PackageRoutesDay[];
 }
@@ -693,28 +741,23 @@ interface HostAboutProps {
 }
 declare const HostAbout: React.FC<HostAboutProps>;
 
-type TravelerOption = {
-    id: "Adult" | "Senior Citizen" | "Children" | "Infant";
-    name: string;
-    count: number;
-    ageRange?: {
-        min: number;
-        max: number;
-    };
-    countInTotal: boolean;
-};
 interface BookingCardLiteProps {
     DescriptionData: DescriptionData;
     currency?: string;
     /** Called when user clicks Book/Reserve. Receives the picked values so the
-     *  consumer can wire their own booking flow. */
+     *  consumer can wire their own booking flow. Return a `Promise` to make the
+     *  button show an "Initiating…" state until it resolves. */
     onReserve?: (payload: {
         arrival: string;
         departure: string;
-        travelers: TravelerOption[];
+        /** Same shape `client.bookings.initiate()` accepts. */
+        travelers: {
+            name: string;
+            count: number;
+        }[];
         totalCost: number;
         pricePerPerson: number;
-    }) => void;
+    }) => void | Promise<void>;
 }
 /**
  * High-fidelity port of frontend `BookingForm.tsx` — visual only.
@@ -781,4 +824,4 @@ declare function startingPrice(prices: PackagePriceTier[] | undefined): number;
 declare function formatCurrency(amount: number, currency?: string): string;
 declare function formatRating(rating: number | undefined): string;
 
-export { AgenciesResource, type AgencyAssociationItem, AgencyAssociations, type AgencyBundle, AgencyDetailView, type AgencyDetailViewProps, type AgencyHostDetails, type AgencyHostResponse, BookingCardLite, type DescriptionData, DescriptionSection, GallerySection, type HomePackageCard, type HomeSectionKey, HomeSections, type HomeSectionsContextValue, type HomeSectionsProps, HomeSectionsProvider, type HomeSectionsProviderProps, type HomeSectionsResponse, HostAbout, HostCard, type HttpClientConfig, type HttpRequestOptions, Itinerary, type MajorAttractionItem, type MajorAttractionsResponse, type MediaItem, type PackageBundle, PackageCard, type PackageDay, type PackageDayLocation, PackageDetailView, type PackageDetailViewProps, type PackageDiscount, PackageExcludedAndToPack, type PackageHost, type PackageHostResponse, PackageIncluded, PackageMap, PackageOverview, type PackagePriceTier, type PackageRoute, type PackageRouteGeometry, type PackageRoutesDay, type PackageRoutesResponse, PackagesCarousel, PackagesResource, PackagesSection, type PackagesSectionProps, type ThingItem, type TopData, TopSection, TravoriesApiError, TravoriesClient, type TravoriesClientConfig, type TravoriesImage, type TravoriesImageUrls, type TravoriesPackage, type UseAgencyBundleResult, type UseHomeSectionsResult, type UsePackageBundleResult, type UsePackageBySlugResult, buildDescriptionData, buildGalleryMedia, buildTopData, createTravoriesClient, formatCurrency, formatRating, pickImageUrl, startingPrice, useAgencyBundle, useHomeSections, useHomeSectionsContext, usePackageBundle, usePackageBySlug };
+export { AgenciesResource, type AgencyAssociationItem, AgencyAssociations, type AgencyBundle, AgencyDetailView, type AgencyDetailViewProps, type AgencyHostDetails, type AgencyHostResponse, BookingCardLite, type BookingInitiateRequest, type BookingInitiateResponse, type BookingTraveler, BookingsResource, type DescriptionData, DescriptionSection, GallerySection, type HomePackageCard, type HomeSectionKey, HomeSections, type HomeSectionsContextValue, type HomeSectionsProps, HomeSectionsProvider, type HomeSectionsProviderProps, type HomeSectionsResponse, HostAbout, HostCard, type HttpClientConfig, type HttpRequestOptions, Itinerary, type MajorAttractionItem, type MajorAttractionsResponse, type MediaItem, type PackageBundle, PackageCard, type PackageDay, type PackageDayLocation, PackageDetailView, type PackageDetailViewProps, type PackageDiscount, PackageExcludedAndToPack, type PackageHost, type PackageHostResponse, PackageIncluded, PackageMap, PackageOverview, type PackagePriceTier, type PackageRoute, type PackageRouteGeometry, type PackageRoutesDay, type PackageRoutesResponse, PackagesCarousel, PackagesResource, PackagesSection, type PackagesSectionProps, type ReservePayload, type ThingItem, type TopData, TopSection, TravoriesApiError, TravoriesClient, type TravoriesClientConfig, type TravoriesImage, type TravoriesImageUrls, type TravoriesPackage, type UseAgencyBundleResult, type UseHomeSectionsResult, type UsePackageBundleResult, type UsePackageBySlugResult, buildDescriptionData, buildGalleryMedia, buildTopData, createTravoriesClient, formatCurrency, formatRating, pickImageUrl, startingPrice, useAgencyBundle, useHomeSections, useHomeSectionsContext, usePackageBundle, usePackageBySlug };

package/dist/index.d.ts

@@ -215,6 +215,24 @@ interface AgencyBundle {
     associations: AgencyAssociationItem[];
     packages: HomePackageCard[];
 }
+/** One row in the booking's traveler breakdown. `name` is the category label. */
+interface BookingTraveler {
+    /** "Adult" | "Senior Citizen" | "Children" | "Infant" */
+    name: string;
+    count: number;
+}
+interface BookingInitiateRequest {
+    /** Package slug (NOT the package UUID — the BE looks it up by slug). */
+    packageId: string;
+    /** ISO date string, e.g. "2027-08-15". */
+    arrivalDate: string;
+    travelers: BookingTraveler[];
+}
+interface BookingInitiateResponse {
+    message: string;
+    /** Booking UUID. Used to build the payment URL: `/package/<data>/payment`. */
+    data: string;
+}
 
 declare class PackagesResource {
     private http;
@@ -268,6 +286,24 @@ declare class AgenciesResource {
     }, options?: HttpRequestOptions): Promise<AgencyBundle | null>;
 }
 
+/**
+ * Booking-related endpoints. Currently exposes the kickoff step (`initiate`);
+ * the rest of the flow (payment, confirmation) lives on travories.com today.
+ */
+declare class BookingsResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Open a booking. The BE returns a booking UUID — combine it with
+     *   `https://travories.com/package/<id>/payment`
+     * to send the user into the existing payment flow.
+     *
+     * Throws (not silent) so the consumer can surface errors to the user. Wrap
+     * in try/catch in your `onReserve` handler.
+     */
+    initiate(payload: BookingInitiateRequest, options?: HttpRequestOptions): Promise<BookingInitiateResponse>;
+}
+
 interface TravoriesClientConfig extends HttpClientConfig {
 }
 /**
@@ -288,6 +324,7 @@ declare class TravoriesClient {
     private http;
     packages: PackagesResource;
     agencies: AgenciesResource;
+    bookings: BookingsResource;
     constructor(config: TravoriesClientConfig);
     getPackageBySlug: (slug: string) => Promise<TravoriesPackage | null>;
     getPackageBundle: (slug: string) => Promise<PackageBundle | null>;
@@ -484,6 +521,15 @@ interface PackageCardProps {
  */
 declare const PackageCard: React.FC<PackageCardProps>;
 
+/** Booking details the user picked in the BookingCardLite when they hit Reserve. */
+interface ReservePayload {
+    pkg: TravoriesPackage;
+    arrival: string;
+    departure: string;
+    travelers: BookingTraveler[];
+    totalCost: number;
+    pricePerPerson: number;
+}
 interface PackageDetailViewProps {
     /** Travories SDK client. Required when using `slug`. */
     client?: TravoriesClient;
@@ -493,8 +539,10 @@ interface PackageDetailViewProps {
     initialBundle?: PackageBundle | null;
     /** Currency code for prices (default "USD"). */
     currency?: string;
-    /** Called when the user hits Reserve. If omitted, the button shows a disabled state. */
-    onReserve?: (pkg: TravoriesPackage) => void;
+    /** Called when the user hits Reserve. Receives the full picked payload
+     *  (pkg + arrival date + travelers + computed totals). Return a Promise to
+     *  show an "Initiating…" state on the CTA until it resolves. */
+    onReserve?: (payload: ReservePayload) => void | Promise<void>;
     /** Called when the user clicks the host card. Receives the host. */
     onSelectHost?: (host: PackageHost) => void;
     /** When set, host card renders as `<a href={agencyHrefFor(host)}>` — enables
@@ -617,7 +665,7 @@ interface DescriptionSectionProps {
     DescriptionData: DescriptionData;
     topData: TopData;
     currency?: string;
-    onReserve?: (pkg: TravoriesPackage) => void;
+    onReserve?: (payload: ReservePayload) => void | Promise<void>;
     pkg: TravoriesPackage;
     routes?: PackageRoutesDay[];
 }
@@ -693,28 +741,23 @@ interface HostAboutProps {
 }
 declare const HostAbout: React.FC<HostAboutProps>;
 
-type TravelerOption = {
-    id: "Adult" | "Senior Citizen" | "Children" | "Infant";
-    name: string;
-    count: number;
-    ageRange?: {
-        min: number;
-        max: number;
-    };
-    countInTotal: boolean;
-};
 interface BookingCardLiteProps {
     DescriptionData: DescriptionData;
     currency?: string;
     /** Called when user clicks Book/Reserve. Receives the picked values so the
-     *  consumer can wire their own booking flow. */
+     *  consumer can wire their own booking flow. Return a `Promise` to make the
+     *  button show an "Initiating…" state until it resolves. */
     onReserve?: (payload: {
         arrival: string;
         departure: string;
-        travelers: TravelerOption[];
+        /** Same shape `client.bookings.initiate()` accepts. */
+        travelers: {
+            name: string;
+            count: number;
+        }[];
         totalCost: number;
         pricePerPerson: number;
-    }) => void;
+    }) => void | Promise<void>;
 }
 /**
  * High-fidelity port of frontend `BookingForm.tsx` — visual only.
@@ -781,4 +824,4 @@ declare function startingPrice(prices: PackagePriceTier[] | undefined): number;
 declare function formatCurrency(amount: number, currency?: string): string;
 declare function formatRating(rating: number | undefined): string;
 
-export { AgenciesResource, type AgencyAssociationItem, AgencyAssociations, type AgencyBundle, AgencyDetailView, type AgencyDetailViewProps, type AgencyHostDetails, type AgencyHostResponse, BookingCardLite, type DescriptionData, DescriptionSection, GallerySection, type HomePackageCard, type HomeSectionKey, HomeSections, type HomeSectionsContextValue, type HomeSectionsProps, HomeSectionsProvider, type HomeSectionsProviderProps, type HomeSectionsResponse, HostAbout, HostCard, type HttpClientConfig, type HttpRequestOptions, Itinerary, type MajorAttractionItem, type MajorAttractionsResponse, type MediaItem, type PackageBundle, PackageCard, type PackageDay, type PackageDayLocation, PackageDetailView, type PackageDetailViewProps, type PackageDiscount, PackageExcludedAndToPack, type PackageHost, type PackageHostResponse, PackageIncluded, PackageMap, PackageOverview, type PackagePriceTier, type PackageRoute, type PackageRouteGeometry, type PackageRoutesDay, type PackageRoutesResponse, PackagesCarousel, PackagesResource, PackagesSection, type PackagesSectionProps, type ThingItem, type TopData, TopSection, TravoriesApiError, TravoriesClient, type TravoriesClientConfig, type TravoriesImage, type TravoriesImageUrls, type TravoriesPackage, type UseAgencyBundleResult, type UseHomeSectionsResult, type UsePackageBundleResult, type UsePackageBySlugResult, buildDescriptionData, buildGalleryMedia, buildTopData, createTravoriesClient, formatCurrency, formatRating, pickImageUrl, startingPrice, useAgencyBundle, useHomeSections, useHomeSectionsContext, usePackageBundle, usePackageBySlug };
+export { AgenciesResource, type AgencyAssociationItem, AgencyAssociations, type AgencyBundle, AgencyDetailView, type AgencyDetailViewProps, type AgencyHostDetails, type AgencyHostResponse, BookingCardLite, type BookingInitiateRequest, type BookingInitiateResponse, type BookingTraveler, BookingsResource, type DescriptionData, DescriptionSection, GallerySection, type HomePackageCard, type HomeSectionKey, HomeSections, type HomeSectionsContextValue, type HomeSectionsProps, HomeSectionsProvider, type HomeSectionsProviderProps, type HomeSectionsResponse, HostAbout, HostCard, type HttpClientConfig, type HttpRequestOptions, Itinerary, type MajorAttractionItem, type MajorAttractionsResponse, type MediaItem, type PackageBundle, PackageCard, type PackageDay, type PackageDayLocation, PackageDetailView, type PackageDetailViewProps, type PackageDiscount, PackageExcludedAndToPack, type PackageHost, type PackageHostResponse, PackageIncluded, PackageMap, PackageOverview, type PackagePriceTier, type PackageRoute, type PackageRouteGeometry, type PackageRoutesDay, type PackageRoutesResponse, PackagesCarousel, PackagesResource, PackagesSection, type PackagesSectionProps, type ReservePayload, type ThingItem, type TopData, TopSection, TravoriesApiError, TravoriesClient, type TravoriesClientConfig, type TravoriesImage, type TravoriesImageUrls, type TravoriesPackage, type UseAgencyBundleResult, type UseHomeSectionsResult, type UsePackageBundleResult, type UsePackageBySlugResult, buildDescriptionData, buildGalleryMedia, buildTopData, createTravoriesClient, formatCurrency, formatRating, pickImageUrl, startingPrice, useAgencyBundle, useHomeSections, useHomeSectionsContext, usePackageBundle, usePackageBySlug };

package/dist/index.js

@@ -316,6 +316,45 @@ var AgenciesResource = class {
   }
 };
 
+// src/api/bookings.ts
+var BookingsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Open a booking. The BE returns a booking UUID — combine it with
+   *   `https://travories.com/package/<id>/payment`
+   * to send the user into the existing payment flow.
+   *
+   * Throws (not silent) so the consumer can surface errors to the user. Wrap
+   * in try/catch in your `onReserve` handler.
+   */
+  async initiate(payload, options) {
+    if (!payload?.packageId) {
+      throw new Error("[TravoriesClient] bookings.initiate requires packageId");
+    }
+    if (!payload?.arrivalDate) {
+      throw new Error("[TravoriesClient] bookings.initiate requires arrivalDate");
+    }
+    if (!payload?.travelers?.length) {
+      throw new Error("[TravoriesClient] bookings.initiate requires at least one traveler");
+    }
+    const res = await this.http.request(
+      `/booking/initiate`,
+      {
+        method: "POST",
+        body: payload,
+        silent: false,
+        ...options
+      }
+    );
+    if (!res?.data) {
+      throw new Error("[TravoriesClient] bookings.initiate returned no booking id");
+    }
+    return res;
+  }
+};
+
 // src/client/TravoriesClient.ts
 var TravoriesClient = class {
   constructor(config) {
@@ -328,6 +367,7 @@ var TravoriesClient = class {
     this.http = new HttpClient(config);
     this.packages = new PackagesResource(this.http);
     this.agencies = new AgenciesResource(this.http);
+    this.bookings = new BookingsResource(this.http);
   }
 };
 function createTravoriesClient(config) {
@@ -957,16 +997,22 @@ var BookingCardLite = ({
       (o) => o.id === id ? { ...o, count: Math.max(0, o.count + (inc ? 1 : -1)) } : o
     )
   );
+  const [isSubmitting, setIsSubmitting] = react.useState(false);
   const handleReserve = () => {
     if (!onReserve) return;
     if (allPeopleCount === 0) return;
-    onReserve({
+    const travelers = options.filter((o) => o.count > 0).map((o) => ({ name: o.name, count: o.count }));
+    const result = onReserve({
       arrival,
       departure,
-      travelers: options.filter((o) => o.count > 0),
+      travelers,
       totalCost,
       pricePerPerson: currentPrice
     });
+    if (result && typeof result.then === "function") {
+      setIsSubmitting(true);
+      result.finally(() => setIsSubmitting(false));
+    }
   };
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "w-full sm:w-full lg:w-[520px] h-fit border rounded-xl shadow-md px-4 sm:px-6 bg-white flex flex-col gap-6 py-8 sm:py-10", children: [
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col", children: [
@@ -1126,9 +1172,9 @@ var BookingCardLite = ({
           {
             type: "button",
             onClick: handleReserve,
-            disabled: allPeopleCount === 0 || !onReserve,
+            disabled: allPeopleCount === 0 || !onReserve || isSubmitting,
             className: "w-full py-2 md:py-3 bg-primary-normal text-white font-semibold rounded-lg hover:bg-primary-normal-hover transition text-sm md:text-base disabled:opacity-60 disabled:cursor-not-allowed",
-            children: allPeopleCount === 0 ? "Reserve Now" : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+            children: isSubmitting ? "Initiating\u2026" : allPeopleCount === 0 ? "Reserve Now" : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
               "Book Now - ",
               formatCurrency(totalCost, currency)
             ] })
@@ -2033,7 +2079,7 @@ var DescriptionSection = ({
               {
                 DescriptionData,
                 currency,
-                onReserve: onReserve ? () => onReserve(pkg) : void 0
+                onReserve: onReserve ? (booking) => onReserve({ pkg, ...booking }) : void 0
               }
             ) })
           ]
@@ -2745,6 +2791,7 @@ exports.AgenciesResource = AgenciesResource;
 exports.AgencyAssociations = AgencyAssociations_default;
 exports.AgencyDetailView = AgencyDetailView;
 exports.BookingCardLite = BookingCardLite_default;
+exports.BookingsResource = BookingsResource;
 exports.DescriptionSection = DescriptionSection_default;
 exports.GallerySection = GallerySection_default;
 exports.HomeSections = HomeSections;