@travories/frontend-sdk 0.1.1 → 0.1.3

package/dist/index.d.mts

@@ -183,6 +183,56 @@ interface HomeSectionsResponse {
     trending: HomePackageCard[];
     moreToExplore: HomePackageCard[];
 }
+interface AgencyHostDetails {
+    id: string;
+    username: string;
+    agencyName: string;
+    agencyCreatedDate: string;
+    rating: number;
+    review: number;
+    description: string;
+    logo: TravoriesImage | null;
+    slug: string;
+}
+interface AgencyHostResponse {
+    success: boolean;
+    message: string;
+    hostDetails: AgencyHostDetails;
+}
+interface AgencyAssociationItem {
+    id: string;
+    name: string;
+    url: string;
+    image: TravoriesImage | null;
+}
+/**
+ * The bundle `client.agencies.getBundle()` returns — drives `<AgencyDetailView />`.
+ * `packages` are this agency's tour packages (`HomePackageCard` shape so the
+ * landing carousel components can render them directly).
+ */
+interface AgencyBundle {
+    agency: AgencyHostDetails;
+    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;
@@ -211,10 +261,54 @@ declare class PackagesResource {
     getBundle(slug: string, options?: HttpRequestOptions): Promise<PackageBundle | null>;
 }
 
+/** All agency-scoped endpoints live here so the resource stays focused. */
+declare class AgenciesResource {
+    private http;
+    constructor(http: HttpClient);
+    /** Public profile of an agency by its slug. Null on 404. */
+    getBySlug(slug: string, options?: HttpRequestOptions): Promise<AgencyHostResponse | null>;
+    /** Partner / association badges shown on the agency profile. */
+    getAssociations(slug: string, options?: HttpRequestOptions): Promise<AgencyAssociationItem[]>;
+    /**
+     * Packages published by this agency. Returns the same card shape as the home
+     * sections so `<PackagesCarousel>` / `<PackageCard>` render them directly.
+     */
+    getPackages(slug: string, params?: {
+        limit?: number;
+        page?: number;
+    }, options?: HttpRequestOptions): Promise<HomePackageCard[]>;
+    /**
+     * Convenience: fetch the full agency bundle (profile + associations + their
+     * packages) in parallel. Drives `<AgencyDetailView />`.
+     */
+    getBundle(slug: string, params?: {
+        packagesLimit?: number;
+    }, 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 {
 }
 /**
- * Main entry point for the Travories SDK.
+ * Main entry point for the Travories SDK. Holds the HTTP client and exposes
+ * resource modules grouped by domain (packages, agencies).
  *
  * @example
  * ```ts
@@ -222,17 +316,20 @@ interface TravoriesClientConfig extends HttpClientConfig {
  *   baseUrl: "https://api.travories.com",
  * });
  *
- * const pkg = await travories.packages.getBySlug("everest-base-camp");
+ * const pkg     = await travories.packages.getBySlug("everest-base-camp");
+ * const agency  = await travories.agencies.getBySlug("travel-route-pvt-ltd");
  * ```
  */
 declare class TravoriesClient {
     private http;
     packages: PackagesResource;
+    agencies: AgenciesResource;
+    bookings: BookingsResource;
     constructor(config: TravoriesClientConfig);
-    /** Shortcut for `client.packages.getBySlug(slug)`. */
     getPackageBySlug: (slug: string) => Promise<TravoriesPackage | null>;
-    /** Shortcut for `client.packages.getBundle(slug)` — package + host + attractions in one call. */
     getPackageBundle: (slug: string) => Promise<PackageBundle | null>;
+    getAgencyBySlug: (slug: string) => Promise<AgencyHostResponse | null>;
+    getAgencyBundle: (slug: string) => Promise<AgencyBundle | null>;
 }
 /** Factory form, in case you prefer a function over `new`. */
 declare function createTravoriesClient(config: TravoriesClientConfig): TravoriesClient;
@@ -276,6 +373,19 @@ interface UseHomeSectionsResult {
  */
 declare function useHomeSections(client: TravoriesClient | null): UseHomeSectionsResult;
 
+interface UseAgencyBundleResult {
+    data: AgencyBundle | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Fetches an agency profile + associations + their packages in one call.
+ * Re-runs when `slug` or `client` changes. Pass `null` slug or client to skip
+ * the fetch (useful when consumer already has data via `initialBundle`).
+ */
+declare function useAgencyBundle(client: TravoriesClient | null, slug: string | null | undefined): UseAgencyBundleResult;
+
 interface HomeSectionsProps {
     /** Required when `initialSections` is not provided. */
     client?: TravoriesClient;
@@ -391,7 +501,9 @@ interface PackageCardProps {
      *  in a new tab. Requires `href`. `onSelect` is NOT called on a normal click
      *  in this mode — the browser handles navigation. */
     openInNewTab?: boolean;
-    /** When true, show the heart (wishlist) icon. Default true. */
+    /** When true, show the heart (wishlist) icon. Default `false` — wishlist
+     *  state is user-specific and requires the consumer to wire auth + storage.
+     *  Pass `liked` + `onLike` together to opt in. */
     showHeart?: boolean;
     /** Initial wishlist state. */
     liked?: boolean;
@@ -420,6 +532,13 @@ interface PackageDetailViewProps {
     currency?: string;
     /** Called when the user hits Reserve. If omitted, the button shows a disabled state. */
     onReserve?: (pkg: TravoriesPackage) => 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
+     *  cmd/ctrl-click → open in new tab natively. */
+    agencyHrefFor?: (host: PackageHost) => string;
+    /** Open host link in a new tab (requires `agencyHrefFor`). */
+    openAgencyInNewTab?: boolean;
     /** Optional extra class on the root wrapper. */
     className?: string;
     /** Loading state override. */
@@ -427,7 +546,7 @@ interface PackageDetailViewProps {
     /** Not-found state override. */
     renderNotFound?: () => React.ReactNode;
 }
-declare function PackageDetailView({ client, slug, initialBundle, currency, onReserve, className, renderLoading, renderNotFound, }: PackageDetailViewProps): react_jsx_runtime.JSX.Element;
+declare function PackageDetailView({ client, slug, initialBundle, currency, onReserve, onSelectHost, agencyHrefFor, openAgencyInNewTab, className, renderLoading, renderNotFound, }: PackageDetailViewProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Legacy view-model types — identical shape to frontend's `types/package.ts`.
@@ -578,8 +697,28 @@ interface PackageExcludedAndToPackProps {
 }
 declare const PackageExcludedAndToPack: React.FC<PackageExcludedAndToPackProps>;
 
+/**
+ * Common shape both `PackageHost` (returned by the package detail endpoint)
+ * and `AgencyHostDetails` (returned by the agency profile endpoint) satisfy.
+ * `agencyName` is optional — when present it's preferred over `username`.
+ */
+interface HostCardData {
+    username: string;
+    agencyName?: string;
+    agencyCreatedDate: string;
+    rating: number;
+    review: number;
+    logo: TravoriesImage | null;
+    slug: string;
+}
 interface HostCardProps {
-    hostData: PackageHost;
+    hostData: HostCardData | PackageHost | AgencyHostDetails;
+    /** Called when the user clicks the card. Receives the host slug. */
+    onAgencyClick?: (slug: string) => void;
+    /** When set, the card wraps in `<a href>` so cmd/ctrl-click opens in a new tab. */
+    href?: string;
+    /** When true (with `href`), the anchor gets `target="_blank"`. */
+    openInNewTab?: boolean;
     className?: string;
 }
 declare const HostCard: React.FC<HostCardProps>;
@@ -605,14 +744,15 @@ 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[];
         totalCost: number;
         pricePerPerson: number;
-    }) => void;
+    }) => void | Promise<void>;
 }
 /**
  * High-fidelity port of frontend `BookingForm.tsx` — visual only.
@@ -625,9 +765,58 @@ declare const buildGalleryMedia: (pkg: TravoriesPackage) => MediaItem[];
 declare const buildTopData: (pkg: TravoriesPackage, host: PackageHost | null) => TopData;
 declare const buildDescriptionData: (pkg: TravoriesPackage) => DescriptionData;
 
+interface AgencyDetailViewProps {
+    /** Required when `initialBundle` is not provided. */
+    client?: TravoriesClient;
+    /** Agency slug to fetch. */
+    slug?: string;
+    /** Pre-fetched bundle (SSR pattern). When set, no client-side fetch runs. */
+    initialBundle?: AgencyBundle | null;
+    /** Currency code for package cards (default "USD"). */
+    currency?: string;
+    /** Called when the user clicks a package card. */
+    onSelectPackage?: (pkg: HomePackageCard) => void;
+    /** When set, package cards render as `<a href>` instead of buttons. */
+    packageHrefFor?: (pkg: HomePackageCard) => string;
+    /** Open package cards in a new tab. Requires `packageHrefFor`. */
+    openPackagesInNewTab?: boolean;
+    /** Optional class on the root scope wrapper. */
+    className?: string;
+    /** Render override for the loading state. */
+    renderLoading?: () => React.ReactNode;
+    /** Render override for the not-found state. */
+    renderNotFound?: () => React.ReactNode;
+}
+/**
+ * Public agency profile page — drop-in equivalent to `<PackageDetailView />`
+ * for the agency route. Pass `client` + `slug` to let the SDK fetch, or
+ * `initialBundle` to use server-fetched data (no client-side fetch).
+ *
+ * Sections rendered (top → bottom):
+ *   1. Breadcrumb + title
+ *   2. HostCard (left) | Overview block (right)
+ *   3. Agency associations / partner badges (if any)
+ *   4. Popular packages carousel
+ *
+ * Reviews / ratings are intentionally not included in this view — they require
+ * user-data plumbing that's out of scope for a static SDK component.
+ */
+declare function AgencyDetailView({ client, slug, initialBundle, currency, onSelectPackage, packageHrefFor, openPackagesInNewTab, className, renderLoading, renderNotFound, }: AgencyDetailViewProps): react_jsx_runtime.JSX.Element;
+
+interface AgencyAssociationsProps {
+    associations: AgencyAssociationItem[];
+    title?: string;
+    className?: string;
+}
+/**
+ * Partner / affiliation badge strip for an agency. Each badge is a link to the
+ * partner site (opens in a new tab). Renders nothing if `associations` is empty.
+ */
+declare const AgencyAssociations: React.FC<AgencyAssociationsProps>;
+
 declare function pickImageUrl(img: TravoriesImage | null | undefined): string;
 declare function startingPrice(prices: PackagePriceTier[] | undefined): number;
 declare function formatCurrency(amount: number, currency?: string): string;
 declare function formatRating(rating: number | undefined): string;
 
-export { 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 UseHomeSectionsResult, type UsePackageBundleResult, type UsePackageBySlugResult, buildDescriptionData, buildGalleryMedia, buildTopData, createTravoriesClient, formatCurrency, formatRating, pickImageUrl, startingPrice, 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 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

@@ -183,6 +183,56 @@ interface HomeSectionsResponse {
     trending: HomePackageCard[];
     moreToExplore: HomePackageCard[];
 }
+interface AgencyHostDetails {
+    id: string;
+    username: string;
+    agencyName: string;
+    agencyCreatedDate: string;
+    rating: number;
+    review: number;
+    description: string;
+    logo: TravoriesImage | null;
+    slug: string;
+}
+interface AgencyHostResponse {
+    success: boolean;
+    message: string;
+    hostDetails: AgencyHostDetails;
+}
+interface AgencyAssociationItem {
+    id: string;
+    name: string;
+    url: string;
+    image: TravoriesImage | null;
+}
+/**
+ * The bundle `client.agencies.getBundle()` returns — drives `<AgencyDetailView />`.
+ * `packages` are this agency's tour packages (`HomePackageCard` shape so the
+ * landing carousel components can render them directly).
+ */
+interface AgencyBundle {
+    agency: AgencyHostDetails;
+    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;
@@ -211,10 +261,54 @@ declare class PackagesResource {
     getBundle(slug: string, options?: HttpRequestOptions): Promise<PackageBundle | null>;
 }
 
+/** All agency-scoped endpoints live here so the resource stays focused. */
+declare class AgenciesResource {
+    private http;
+    constructor(http: HttpClient);
+    /** Public profile of an agency by its slug. Null on 404. */
+    getBySlug(slug: string, options?: HttpRequestOptions): Promise<AgencyHostResponse | null>;
+    /** Partner / association badges shown on the agency profile. */
+    getAssociations(slug: string, options?: HttpRequestOptions): Promise<AgencyAssociationItem[]>;
+    /**
+     * Packages published by this agency. Returns the same card shape as the home
+     * sections so `<PackagesCarousel>` / `<PackageCard>` render them directly.
+     */
+    getPackages(slug: string, params?: {
+        limit?: number;
+        page?: number;
+    }, options?: HttpRequestOptions): Promise<HomePackageCard[]>;
+    /**
+     * Convenience: fetch the full agency bundle (profile + associations + their
+     * packages) in parallel. Drives `<AgencyDetailView />`.
+     */
+    getBundle(slug: string, params?: {
+        packagesLimit?: number;
+    }, 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 {
 }
 /**
- * Main entry point for the Travories SDK.
+ * Main entry point for the Travories SDK. Holds the HTTP client and exposes
+ * resource modules grouped by domain (packages, agencies).
  *
  * @example
  * ```ts
@@ -222,17 +316,20 @@ interface TravoriesClientConfig extends HttpClientConfig {
  *   baseUrl: "https://api.travories.com",
  * });
  *
- * const pkg = await travories.packages.getBySlug("everest-base-camp");
+ * const pkg     = await travories.packages.getBySlug("everest-base-camp");
+ * const agency  = await travories.agencies.getBySlug("travel-route-pvt-ltd");
  * ```
  */
 declare class TravoriesClient {
     private http;
     packages: PackagesResource;
+    agencies: AgenciesResource;
+    bookings: BookingsResource;
     constructor(config: TravoriesClientConfig);
-    /** Shortcut for `client.packages.getBySlug(slug)`. */
     getPackageBySlug: (slug: string) => Promise<TravoriesPackage | null>;
-    /** Shortcut for `client.packages.getBundle(slug)` — package + host + attractions in one call. */
     getPackageBundle: (slug: string) => Promise<PackageBundle | null>;
+    getAgencyBySlug: (slug: string) => Promise<AgencyHostResponse | null>;
+    getAgencyBundle: (slug: string) => Promise<AgencyBundle | null>;
 }
 /** Factory form, in case you prefer a function over `new`. */
 declare function createTravoriesClient(config: TravoriesClientConfig): TravoriesClient;
@@ -276,6 +373,19 @@ interface UseHomeSectionsResult {
  */
 declare function useHomeSections(client: TravoriesClient | null): UseHomeSectionsResult;
 
+interface UseAgencyBundleResult {
+    data: AgencyBundle | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * Fetches an agency profile + associations + their packages in one call.
+ * Re-runs when `slug` or `client` changes. Pass `null` slug or client to skip
+ * the fetch (useful when consumer already has data via `initialBundle`).
+ */
+declare function useAgencyBundle(client: TravoriesClient | null, slug: string | null | undefined): UseAgencyBundleResult;
+
 interface HomeSectionsProps {
     /** Required when `initialSections` is not provided. */
     client?: TravoriesClient;
@@ -391,7 +501,9 @@ interface PackageCardProps {
      *  in a new tab. Requires `href`. `onSelect` is NOT called on a normal click
      *  in this mode — the browser handles navigation. */
     openInNewTab?: boolean;
-    /** When true, show the heart (wishlist) icon. Default true. */
+    /** When true, show the heart (wishlist) icon. Default `false` — wishlist
+     *  state is user-specific and requires the consumer to wire auth + storage.
+     *  Pass `liked` + `onLike` together to opt in. */
     showHeart?: boolean;
     /** Initial wishlist state. */
     liked?: boolean;
@@ -420,6 +532,13 @@ interface PackageDetailViewProps {
     currency?: string;
     /** Called when the user hits Reserve. If omitted, the button shows a disabled state. */
     onReserve?: (pkg: TravoriesPackage) => 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
+     *  cmd/ctrl-click → open in new tab natively. */
+    agencyHrefFor?: (host: PackageHost) => string;
+    /** Open host link in a new tab (requires `agencyHrefFor`). */
+    openAgencyInNewTab?: boolean;
     /** Optional extra class on the root wrapper. */
     className?: string;
     /** Loading state override. */
@@ -427,7 +546,7 @@ interface PackageDetailViewProps {
     /** Not-found state override. */
     renderNotFound?: () => React.ReactNode;
 }
-declare function PackageDetailView({ client, slug, initialBundle, currency, onReserve, className, renderLoading, renderNotFound, }: PackageDetailViewProps): react_jsx_runtime.JSX.Element;
+declare function PackageDetailView({ client, slug, initialBundle, currency, onReserve, onSelectHost, agencyHrefFor, openAgencyInNewTab, className, renderLoading, renderNotFound, }: PackageDetailViewProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Legacy view-model types — identical shape to frontend's `types/package.ts`.
@@ -578,8 +697,28 @@ interface PackageExcludedAndToPackProps {
 }
 declare const PackageExcludedAndToPack: React.FC<PackageExcludedAndToPackProps>;
 
+/**
+ * Common shape both `PackageHost` (returned by the package detail endpoint)
+ * and `AgencyHostDetails` (returned by the agency profile endpoint) satisfy.
+ * `agencyName` is optional — when present it's preferred over `username`.
+ */
+interface HostCardData {
+    username: string;
+    agencyName?: string;
+    agencyCreatedDate: string;
+    rating: number;
+    review: number;
+    logo: TravoriesImage | null;
+    slug: string;
+}
 interface HostCardProps {
-    hostData: PackageHost;
+    hostData: HostCardData | PackageHost | AgencyHostDetails;
+    /** Called when the user clicks the card. Receives the host slug. */
+    onAgencyClick?: (slug: string) => void;
+    /** When set, the card wraps in `<a href>` so cmd/ctrl-click opens in a new tab. */
+    href?: string;
+    /** When true (with `href`), the anchor gets `target="_blank"`. */
+    openInNewTab?: boolean;
     className?: string;
 }
 declare const HostCard: React.FC<HostCardProps>;
@@ -605,14 +744,15 @@ 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[];
         totalCost: number;
         pricePerPerson: number;
-    }) => void;
+    }) => void | Promise<void>;
 }
 /**
  * High-fidelity port of frontend `BookingForm.tsx` — visual only.
@@ -625,9 +765,58 @@ declare const buildGalleryMedia: (pkg: TravoriesPackage) => MediaItem[];
 declare const buildTopData: (pkg: TravoriesPackage, host: PackageHost | null) => TopData;
 declare const buildDescriptionData: (pkg: TravoriesPackage) => DescriptionData;
 
+interface AgencyDetailViewProps {
+    /** Required when `initialBundle` is not provided. */
+    client?: TravoriesClient;
+    /** Agency slug to fetch. */
+    slug?: string;
+    /** Pre-fetched bundle (SSR pattern). When set, no client-side fetch runs. */
+    initialBundle?: AgencyBundle | null;
+    /** Currency code for package cards (default "USD"). */
+    currency?: string;
+    /** Called when the user clicks a package card. */
+    onSelectPackage?: (pkg: HomePackageCard) => void;
+    /** When set, package cards render as `<a href>` instead of buttons. */
+    packageHrefFor?: (pkg: HomePackageCard) => string;
+    /** Open package cards in a new tab. Requires `packageHrefFor`. */
+    openPackagesInNewTab?: boolean;
+    /** Optional class on the root scope wrapper. */
+    className?: string;
+    /** Render override for the loading state. */
+    renderLoading?: () => React.ReactNode;
+    /** Render override for the not-found state. */
+    renderNotFound?: () => React.ReactNode;
+}
+/**
+ * Public agency profile page — drop-in equivalent to `<PackageDetailView />`
+ * for the agency route. Pass `client` + `slug` to let the SDK fetch, or
+ * `initialBundle` to use server-fetched data (no client-side fetch).
+ *
+ * Sections rendered (top → bottom):
+ *   1. Breadcrumb + title
+ *   2. HostCard (left) | Overview block (right)
+ *   3. Agency associations / partner badges (if any)
+ *   4. Popular packages carousel
+ *
+ * Reviews / ratings are intentionally not included in this view — they require
+ * user-data plumbing that's out of scope for a static SDK component.
+ */
+declare function AgencyDetailView({ client, slug, initialBundle, currency, onSelectPackage, packageHrefFor, openPackagesInNewTab, className, renderLoading, renderNotFound, }: AgencyDetailViewProps): react_jsx_runtime.JSX.Element;
+
+interface AgencyAssociationsProps {
+    associations: AgencyAssociationItem[];
+    title?: string;
+    className?: string;
+}
+/**
+ * Partner / affiliation badge strip for an agency. Each badge is a link to the
+ * partner site (opens in a new tab). Renders nothing if `associations` is empty.
+ */
+declare const AgencyAssociations: React.FC<AgencyAssociationsProps>;
+
 declare function pickImageUrl(img: TravoriesImage | null | undefined): string;
 declare function startingPrice(prices: PackagePriceTier[] | undefined): number;
 declare function formatCurrency(amount: number, currency?: string): string;
 declare function formatRating(rating: number | undefined): string;
 
-export { 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 UseHomeSectionsResult, type UsePackageBundleResult, type UsePackageBySlugResult, buildDescriptionData, buildGalleryMedia, buildTopData, createTravoriesClient, formatCurrency, formatRating, pickImageUrl, startingPrice, 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 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 };