@surfiran/public-api-client 0.14.0 → 0.20.0

package/README.md

@@ -1,195 +1,76 @@
 # Public API Client
 
-TypeScript types and a fetch-based client for SURFIRAN CRM Public API V1 (`/api/v1/*`). Zero runtime dependencies beyond `fetch`.
+Zero-runtime-dependency TypeScript types and fetch client for SURFIRAN Public API V1. The package-local contract snapshot is OpenAPI `v0.14.0`.
 
-## Contract Source
+Project authority lives in:
 
-```text
-contract/public-api-v1.yaml  (v0.9.0 package snapshot)
-```
-
-The backend API remains the canonical contract owner at
-`server/openapi/public-api-v1.yaml`. This package contains an explicit,
-checked-in snapshot with provenance linking it to the canonical source commit
-and checksum. The package never reads backend source during generation.
-
-## Current Runtime Scope
-
-Active read endpoints:
-
-```http
-GET /api/v1/homepage
-GET /api/v1/site-navigation
-GET /api/v1/sitemap
-GET /api/v1/search-suggestions
-GET /api/v1/tour-categories
-GET /api/v1/tours
-GET /api/v1/tours/:slug
-GET /api/v1/tours/:slug/departures
-GET /api/v1/tours/:slug/availability
-GET /api/v1/destinations
-GET /api/v1/destinations/:slug
-GET /api/v1/travel-knowledge
-```
-
-Active narrow public write endpoints:
-
-```http
-POST /api/v1/inquiries
-POST /api/v1/booking-intents
-```
-
-Blocked endpoint:
-
-```http
-GET /api/v1/booking-intents/:id
-```
-
-`POST /api/v1/booking-intents` creates a public booking-intent record only. It does not create bookings, traveler records, payments, uploads, inventory holds, supplier-private records, BFF behavior, or Next.js behavior.
-
-`GET /api/v1/booking-intents/:id` remains blocked at `501 PUBLIC_API_ROUTE_NOT_IMPLEMENTED` and is intentionally not exposed by this client.
-
-## Exported Types
-
-All types are aligned with the OpenAPI specification. Key exports:
-
-- `PublicApiErrorCode` - union of current public error code strings
-- `PublicApiV1Path` - union of active client paths
-- `PublicApiV1RouteMap` - maps supported `GET` and `POST` client operations to response types
-- `PublicTourListItem`, `PublicTourDetail`
-- `PublicDepartureListItem`
-- `PublicAvailabilityListItem`, `PublicAvailabilityListResponse`
-- `PublicDestinationListItem`, `PublicDestinationDetail`
-- `PublicTourListResponse`, `PublicTourDetailResponse`
-- `PublicDepartureListResponse`
-- `PublicDestinationListResponse`, `PublicDestinationDetailResponse`
-- `PublicInquiryRequest`, `PublicInquiryResponse`
-- `PublicBookingIntentRequest`, `PublicBookingIntentResponse`
-- `PublicTravelKnowledgeItem`, `PublicTravelKnowledgeResponse`
-- `PublicError`, `PublicErrorEnvelope`
-- `PublicApiNotImplementedError`, `PublicApiValidationError`
-- `PublicApiRateLimitError`, `PublicApiAbuseBlockedError`
-- `PublicApiIdempotencyConflictError`
-
-## Client Functions
-
-```ts
-import { createPublicApiClient } from '@surfiran/public-api-client';
-
-const client = createPublicApiClient({ baseUrl: 'https://crm.example.com' });
-
-const homepage = await client.getPublicHomepage();
-const siteNavigation = await client.getPublicSiteNavigation();
-const sitemap = await client.getPublicSitemap({ type: 'tour' });
-const suggestions = await client.getPublicSearchSuggestions({ q: 'iran' });
-const categories = await client.listPublicTourCategories({ limit: 20 });
-const tours = await client.listPublicTours({ limit: 20 });
-const tour = await client.getPublicTourBySlug('iran-hiking-tour');
-const departures = await client.listPublicTourDepartures('iran-hiking-tour', { limit: 20 });
-const availability = await client.listPublicTourAvailability('iran-hiking-tour', { limit: 20 });
-const destinations = await client.listPublicDestinations({ limit: 20 });
-const destination = await client.getPublicDestinationBySlug('tehran');
-const travelKnowledge = await client.getPublicTravelKnowledge({ type: 'city', q: 'shiraz' });
-```
-
-Public write calls require caller-provided idempotency keys where the Public API contract requires them:
-
-```ts
-const inquiry = await client.createPublicInquiry(
-  { name: 'Traveler', email: 'traveler@example.com', message: 'I am interested in Iran tours.' },
-  'client-generated-idempotency-key',
-);
-
-const bookingIntent = await client.createPublicBookingIntent(
-  { tourSlug: 'iran-hiking-tour', travelerCount: 2 },
-  'client-generated-idempotency-key',
-);
-```
+- [Cross-Repository Contracts](../../docs/architecture/CROSS_REPOSITORY_CONTRACTS.md)
+- [System Architecture](../../docs/architecture/SYSTEM_ARCHITECTURE.md)
+- [Public Web Product Model](../../docs/domains/public-web/PUBLIC_WEB_PRODUCT_MODEL.md)
 
-## Boundaries
+This README contains package-local generation, verification, and consumption guidance.
 
-This package must never:
+## Contract ownership
 
-- Import CRM server modules or connect to MariaDB
-- Call internal CRM routes
-- Export raw CRM row types or sensitive fields
-- Expose `storage_path`, upload-private fields, passenger data, supplier-private data, payment data, audit data, tokens, cookies, or internal notes
-- Add a client method for `GET /api/v1/booking-intents/:id` until that route is separately approved and implemented
+`contract/public-api-v1.yaml` is the package-local immutable snapshot. The canonical source is owned by the API component at `server/openapi/public-api-v1.yaml`; `contract/provenance.json` pins its source commit and checksums. Package generation reads package-local files only, generated source is never hand-edited, and committed dist output is rebuilt and verified from that snapshot.
 
-## Media Projection Boundary
+## Boundary
 
-`heroImage` and `gallery` remain public-safe placeholders until a separate Public API media projection design is approved. This package must not infer public media URLs from `file_uploads.storage_path` or authenticated upload preview URLs.
+The client exposes only operations present and implemented in the pinned Public API contract. It must never:
 
-## Next.js Usage
+- import server modules or connect to MariaDB;
+- call internal CRM or generic-table routes;
+- export raw CRM rows or passenger, supplier-private, payment, audit, internal-note, credential, cookie, token, or storage-path fields;
+- manufacture public media URLs from private upload fields; public media remains outside typed-client methods and is governed by the signed-only proxy contract;
+- add `GET /api/v1/booking-intents/:id` until separately approved and implemented.
 
-The public Next.js website consumes this client as the exact published dependency `@surfiran/public-api-client@0.1.0`. Its TypeScript, Vitest, and build configuration must resolve the package from `node_modules`, never from the monorepo `packages/` source tree.
+Booking-intent creation remains intent-only. It does not create a Booking/Passenger, payment, inventory hold, supplier confirmation, checkout, or Public Web behavior.
 
-## Code Generation
+## Install and verify
 
-From this package directory, install dependencies and generate the committed
-artifact from the checked-in contract snapshot:
+From this directory:
 
-```text
+```bash
 npm ci --include=dev
 npm run generate
 npm run verify:contract
 npm run verify:generated
+npm test
+npm run typecheck
+npm run build
 ```
 
-Generation has stable ordering, formatting, LF newlines, no random identifiers,
-no machine-specific paths, and no uncontrolled timestamps. To synchronize the
-snapshot from the canonical backend source during monorepo development, use the
-explicit root command with a recorded source commit:
+Generation is deterministic: stable ordering/formatting, LF newlines, no machine paths, random IDs, or uncontrolled timestamps.
+
+## Monorepo synchronization
 
-```text
+During co-location only, synchronize from the canonical OpenAPI source with the root command and an explicit full source commit:
+
+```bash
 npm run sync:public-api-client-contract -- --source-commit <canonical-source-commit>
 ```
 
-The synchronization command is not required by a package-only clone and must
-not be used to create a competing contract.
+After a future repository split, the client repository consumes an immutable versioned contract artifact published by the API repository. No build reads another repository's source tree.
 
-## Publication and Rollback
+## Consumer usage
 
-Publication preflight is validation-only and must run from the package root:
+`listPublicTours` accepts full-catalog country, style, travel-format, activity,
+duration-bucket, journey-type and departure-month selections. Values within a
+group are ORed; groups are ANDed. `includeFacets: true` adds disjunctive facet
+counts and the unfiltered catalog total. `destination` retains its legacy city
+meaning; countries use `countries`. Dates mean published departures, not available
+capacity. Price filtering and price sorting are not supported.
 
-```text
-npm run verify:contract
-npm run generate
-npm run verify:generated
-npm run verify:package
-npm run typecheck
-npm test
-npm run build
-npm pack --dry-run --json
-npm run verify:pack
-npm run verify:publication-preflight -- <previous-exact-version>
-```
+Treat the catalog cursor as opaque. Clear it after changing filters or sorting;
+it is bound to the normalized selection, locale and UTC reference day. Calls
+without catalog parameters keep their existing pagination and response shape.
 
-Create and verify release provenance with an explicit UTC timestamp, source
-commit, rollback version, and packed tarball:
-
-```text
-npm pack --pack-destination <evidence-directory>
-npm run create:provenance -- \
-  --source-commit <full-source-commit> \
-  --generated-at <UTC-ISO-8601-timestamp> \
-  --tarball <packed-tarball> \
-  --rollback-version <previous-exact-version> \
-  --output <evidence-directory>/public-api-client-provenance.json
-npm run verify:provenance -- \
-  --file <evidence-directory>/public-api-client-provenance.json \
-  --tarball <packed-tarball>
-```
+Consumers install an exact immutable `@surfiran/public-api-client` version and create a client with their supported Public API base URL. They check the typed success/error result for every operation and keep credentials/environment values outside code and logs.
+
+Do not duplicate the endpoint list in this README; the pinned OpenAPI and generated route/types are the executable inventory.
 
-The exact package allowlist is enforced before packing. Provenance links the
-package name and version, canonical source commit, canonical and snapshot
-checksums, generated artifact checksum, allowlist checksum, generation tool,
-explicit generation timestamp policy, rollback version, and tarball checksum.
-The package is immutable on npm. Consumers roll back by pinning the previous
-verified exact version; an existing version is never overwritten.
+## Publication and rollback
 
-## Next Steps
+Run package verification, `npm pack --dry-run --json`, pack verification, and publication preflight against the previous exact version. Publish a new immutable version with provenance; never rewrite an existing version. Rollback means reinstalling the prior verified package version and independently rolling back any consumer deployment.
 
-- Keep `server/openapi/public-api-v1.yaml` as the API-owned contract source
-- Synchronize the explicit snapshot only from the API-owned canonical source
-- Run package-local generation, validation, provenance, and clean-clone checks
+No package command deploys a consumer, changes API runtime behavior, applies a migration, or accesses production data/configuration.

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { GetPublicSearchSuggestionsParams, GetPublicSitemapParams, GetPublicTourPreviewParams, GetPublicTravelKnowledgeParams, ListPublicDeparturesParams, ListPublicDestinationsParams, ListPublicTourAccommodationsParams, ListPublicTourAvailabilityParams, ListPublicTourCategoriesParams, ListPublicTourExperiencesParams, ListPublicTravellerStoriesParams, ListPublicTourQuestionsParams, ListPublicTourReviewsParams, ListPublicTourItineraryParams, ListPublicTourRouteParams, ListPublicToursParams, PublicApiResult, PublicAvailabilityListResponse, PublicBookingIntentRequest, PublicBookingIntentResponse, PublicBrochureLeadRequest, PublicBrochureLeadResponse, PublicDepartureListResponse, PublicDestinationDetailResponse, PublicDestinationListResponse, PublicHomepageResponse, PublicInquiryRequest, PublicInquiryResponse, PublicSearchSuggestionsResponse, PublicSitemapResponse, PublicSiteChromeContentResponse, PublicSiteFeaturesResponse, PublicSiteHomeContentResponse, PublicSiteNavigationResponse, PublicSiteTrustPageContentResponse, PublicTourAccommodationListResponse, PublicTourCategoryListResponse, PublicTourDetailResponse, PublicTourExperienceListResponse, PublicTravellerStoryListResponse, PublicTourListResponse, PublicTourQuestionListResponse, PublicTourReviewsSummaryResponse, PublicTourReviewListResponse, PublicTourItineraryResponse, PublicTourRouteResponse, PublicTravelKnowledgeResponse, PublicTravelStatusResponse } from './types.js';
+import type { GetPublicSearchResultsParams, GetPublicSearchSuggestionsParams, GetPublicSitemapParams, GetPublicTourPreviewParams, GetPublicTravelKnowledgeParams, ListPublicDeparturesParams, ListPublicDestinationsParams, ListPublicTourAccommodationsParams, ListPublicTourAvailabilityParams, ListPublicTourCategoriesParams, ListPublicTourExperiencesParams, ListPublicTravellerStoriesParams, ListPublicTourQuestionsParams, ListPublicTourReviewsParams, ListPublicTourItineraryParams, ListPublicTourRouteParams, ListPublicToursParams, GetPublicTourParams, PublicApiResult, PublicAvailabilityListResponse, PublicBookingIntentRequest, PublicBookingIntentResponse, PublicBrochureLeadRequest, PublicBrochureLeadResponse, PublicDepartureListResponse, PublicDestinationDetailResponse, PublicDestinationListResponse, PublicHomepageResponse, PublicInquiryRequest, PublicInquiryResponse, PublicSearchResultsResponse, PublicSearchSuggestionsResponse, PublicSitemapResponse, PublicSiteChromeContentResponse, PublicSiteFeaturesResponse, PublicLocaleRegistryResponse, PublicLocalizationCandidatePreviewResponse, PublicLocalizationReleaseResponse, PublicUiCatalogResponse, LocalizationReleaseId, LocalizationPreviewCapability, UiCatalogSnapshotId, PublicSiteHomeContentResponse, PublicSiteNavigationResponse, PublicSiteTrustPageContentResponse, PublicTourAccommodationListResponse, PublicTourCategoryListResponse, PublicTourDetailResponse, PublicTourExperienceListResponse, PublicTravellerStoryListResponse, PublicTourListResponse, PublicTourQuestionListResponse, PublicTourReviewsSummaryResponse, PublicTourReviewListResponse, PublicTourItineraryResponse, PublicTourRouteResponse, PublicTravelKnowledgeResponse, PublicTravelStatusResponse } from './types.js';
 export type PublicApiClientOptions = {
     baseUrl: string;
     fetchImpl?: typeof fetch;
@@ -12,7 +12,7 @@ export type PublicApiClientOptions = {
 };
 export declare const createPublicApiClient: (options: PublicApiClientOptions) => {
     listPublicTours(params?: ListPublicToursParams): Promise<PublicApiResult<PublicTourListResponse>>;
-    getPublicTourBySlug(slug: string): Promise<PublicApiResult<PublicTourDetailResponse>>;
+    getPublicTourBySlug(slug: string, params?: GetPublicTourParams): Promise<PublicApiResult<PublicTourDetailResponse>>;
     /**
      * ADR-0022 Tour Product/Edition MVP candidate preview: renders the same
      * public-safe DTO as getPublicTourBySlug, with the Edition-sourced
@@ -41,8 +41,13 @@ export declare const createPublicApiClient: (options: PublicApiClientOptions) =>
     getPublicHomepage(): Promise<PublicApiResult<PublicHomepageResponse>>;
     getPublicSiteNavigation(): Promise<PublicApiResult<PublicSiteNavigationResponse>>;
     getPublicSiteFeatures(): Promise<PublicApiResult<PublicSiteFeaturesResponse>>;
+    listPublicLocales(): Promise<PublicApiResult<PublicLocaleRegistryResponse>>;
+    getPublicLocalizationRelease(releaseId: LocalizationReleaseId): Promise<PublicApiResult<PublicLocalizationReleaseResponse>>;
+    getPublicLocalizationCandidatePreview(candidateId: LocalizationReleaseId, capability: LocalizationPreviewCapability): Promise<PublicApiResult<PublicLocalizationCandidatePreviewResponse>>;
+    getPublicUiCatalog(snapshotId: UiCatalogSnapshotId): Promise<PublicApiResult<PublicUiCatalogResponse>>;
     getPublicSitemap(params?: GetPublicSitemapParams): Promise<PublicApiResult<PublicSitemapResponse>>;
     getPublicSearchSuggestions(params: GetPublicSearchSuggestionsParams): Promise<PublicApiResult<PublicSearchSuggestionsResponse>>;
+    getPublicSearchResults(params: GetPublicSearchResultsParams): Promise<PublicApiResult<PublicSearchResultsResponse>>;
     listPublicTourCategories(params?: ListPublicTourCategoriesParams): Promise<PublicApiResult<PublicTourCategoryListResponse>>;
     getPublicTravelStatus(): Promise<PublicApiResult<PublicTravelStatusResponse>>;
     getPublicSiteContentHome(): Promise<PublicApiResult<PublicSiteHomeContentResponse>>;

package/dist/client.js

@@ -30,11 +30,13 @@ const toPublicError = async (response) => {
         },
     };
 };
-const requestJson = async (url, options) => {
+const requestJson = async (url, options, authorization) => {
     const fetcher = options.fetchImpl || fetch;
     const headers = new Headers();
     if (options.requestId)
         headers.set('x-request-id', options.requestId);
+    if (authorization)
+        headers.set('Authorization', authorization);
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
     let response;
@@ -83,9 +85,22 @@ const toQueryString = (params) => {
         search.set('minDuration', String(params.minDuration));
     if (params?.maxDuration !== undefined)
         search.set('maxDuration', String(params.maxDuration));
+    if (params?.locale)
+        search.set('locale', params.locale);
+    for (const key of ['countries', 'styles', 'travelFormats', 'activityLevels', 'durationBuckets', 'journeyTypes', 'months']) {
+        if (params?.[key]?.length)
+            search.set(key, params[key].join(','));
+    }
+    for (const key of ['includeFacets', 'hasUpcomingDepartures']) {
+        if (params?.[key] !== undefined)
+            search.set(key, String(params[key]));
+    }
+    if (params?.sort)
+        search.set('sort', params.sort);
     const value = search.toString();
     return value ? `?${value}` : '';
 };
+const toContentLocaleQueryString = (params) => params?.locale ? `?locale=${encodeURIComponent(params.locale)}` : '';
 const toSitemapQueryString = (params) => {
     const search = new URLSearchParams();
     if (params?.type)
@@ -102,6 +117,21 @@ const toSearchSuggestionsQueryString = (params) => {
         search.set('type', params.type);
     return `?${search.toString()}`;
 };
+/*
+ * Same shape as the suggestion query, kept as its own builder rather than
+ * shared: the two endpoints have separate limit ranges and are free to diverge,
+ * and the server rejects any parameter it does not name, so a builder that
+ * quietly served both would be the thing that broke on the first divergence.
+ */
+const toSearchResultsQueryString = (params) => {
+    const search = new URLSearchParams();
+    search.set('q', params.q);
+    if (params.limit !== undefined)
+        search.set('limit', String(params.limit));
+    if (params.type)
+        search.set('type', params.type);
+    return `?${search.toString()}`;
+};
 const toTravelKnowledgeQueryString = (params) => {
     const search = new URLSearchParams();
     search.set('type', params.type);
@@ -158,8 +188,8 @@ export const createPublicApiClient = (options) => {
         listPublicTours(params) {
             return requestJson(`${baseUrl}/api/v1/tours${toQueryString(params)}`, options);
         },
-        getPublicTourBySlug(slug) {
-            return requestJson(`${baseUrl}/api/v1/tours/${encodeURIComponent(slug)}`, options);
+        getPublicTourBySlug(slug, params) {
+            return requestJson(`${baseUrl}/api/v1/tours/${encodeURIComponent(slug)}${toContentLocaleQueryString(params)}`, options);
         },
         /**
          * ADR-0022 Tour Product/Edition MVP candidate preview: renders the same
@@ -232,12 +262,27 @@ export const createPublicApiClient = (options) => {
         getPublicSiteFeatures() {
             return requestJson(`${baseUrl}/api/v1/site-features`, options);
         },
+        listPublicLocales() {
+            return requestJson(`${baseUrl}/api/v1/locales`, options);
+        },
+        getPublicLocalizationRelease(releaseId) {
+            return requestJson(`${baseUrl}/api/v1/localization/releases/${encodeURIComponent(releaseId)}`, options);
+        },
+        getPublicLocalizationCandidatePreview(candidateId, capability) {
+            return requestJson(`${baseUrl}/api/v1/localization/previews/${encodeURIComponent(candidateId)}`, options, `Bearer ${capability}`);
+        },
+        getPublicUiCatalog(snapshotId) {
+            return requestJson(`${baseUrl}/api/v1/localization/ui-catalogs/${encodeURIComponent(snapshotId)}`, options);
+        },
         getPublicSitemap(params) {
             return requestJson(`${baseUrl}/api/v1/sitemap${toSitemapQueryString(params)}`, options);
         },
         getPublicSearchSuggestions(params) {
             return requestJson(`${baseUrl}/api/v1/search-suggestions${toSearchSuggestionsQueryString(params)}`, options);
         },
+        getPublicSearchResults(params) {
+            return requestJson(`${baseUrl}/api/v1/search${toSearchResultsQueryString(params)}`, options);
+        },
         listPublicTourCategories(params) {
             return requestJson(`${baseUrl}/api/v1/tour-categories${toPaginationQueryString(params)}`, options);
         },

package/dist/generated/public-api-v1.d.ts

@@ -1,7 +1,7 @@
-export type GeneratedPublicApiVersion = '0.9.0';
-export type GeneratedPublicApiPath = '/booking-intents' | '/booking-intents/{id}' | '/brochure-leads' | '/destinations' | '/destinations/{slug}' | '/homepage' | '/inquiries' | '/search-suggestions' | '/site-content/about' | '/site-content/accessibility-statement' | '/site-content/booking-cancellation-policy' | '/site-content/contact' | '/site-content/cookie-policy' | '/site-content/faqs' | '/site-content/footer' | '/site-content/header' | '/site-content/health-safety-support' | '/site-content/home' | '/site-content/iran-travel-status' | '/site-content/iran-visa-information' | '/site-content/money-in-iran' | '/site-content/privacy' | '/site-content/responsible-travel' | '/site-content/tailor-made' | '/site-content/terms' | '/site-content/travel-insurance' | '/site-features' | '/site-navigation' | '/sitemap' | '/tour-categories' | '/tours' | '/tours/{slug}' | '/tours/{slug}/accommodations' | '/tours/{slug}/availability' | '/tours/{slug}/departures' | '/tours/{slug}/experiences' | '/tours/{slug}/itinerary' | '/tours/{slug}/preview' | '/tours/{slug}/questions' | '/tours/{slug}/reviews' | '/tours/{slug}/reviews-summary' | '/tours/{slug}/route' | '/travel-knowledge' | '/travel-status' | '/traveller-stories';
-export type GeneratedPublicApiOperation = 'GET /booking-intents/{id}' | 'GET /destinations' | 'GET /destinations/{slug}' | 'GET /homepage' | 'GET /search-suggestions' | 'GET /site-content/about' | 'GET /site-content/accessibility-statement' | 'GET /site-content/booking-cancellation-policy' | 'GET /site-content/contact' | 'GET /site-content/cookie-policy' | 'GET /site-content/faqs' | 'GET /site-content/footer' | 'GET /site-content/header' | 'GET /site-content/health-safety-support' | 'GET /site-content/home' | 'GET /site-content/iran-travel-status' | 'GET /site-content/iran-visa-information' | 'GET /site-content/money-in-iran' | 'GET /site-content/privacy' | 'GET /site-content/responsible-travel' | 'GET /site-content/tailor-made' | 'GET /site-content/terms' | 'GET /site-content/travel-insurance' | 'GET /site-features' | 'GET /site-navigation' | 'GET /sitemap' | 'GET /tour-categories' | 'GET /tours' | 'GET /tours/{slug}' | 'GET /tours/{slug}/accommodations' | 'GET /tours/{slug}/availability' | 'GET /tours/{slug}/departures' | 'GET /tours/{slug}/experiences' | 'GET /tours/{slug}/itinerary' | 'GET /tours/{slug}/preview' | 'GET /tours/{slug}/questions' | 'GET /tours/{slug}/reviews' | 'GET /tours/{slug}/reviews-summary' | 'GET /tours/{slug}/route' | 'GET /travel-knowledge' | 'GET /travel-status' | 'GET /traveller-stories' | 'POST /booking-intents' | 'POST /brochure-leads' | 'POST /inquiries';
-export type GeneratedPublicApiActiveOperation = 'GET /destinations' | 'GET /destinations/{slug}' | 'GET /homepage' | 'GET /search-suggestions' | 'GET /site-content/about' | 'GET /site-content/accessibility-statement' | 'GET /site-content/booking-cancellation-policy' | 'GET /site-content/contact' | 'GET /site-content/cookie-policy' | 'GET /site-content/faqs' | 'GET /site-content/footer' | 'GET /site-content/header' | 'GET /site-content/health-safety-support' | 'GET /site-content/home' | 'GET /site-content/iran-travel-status' | 'GET /site-content/iran-visa-information' | 'GET /site-content/money-in-iran' | 'GET /site-content/privacy' | 'GET /site-content/responsible-travel' | 'GET /site-content/tailor-made' | 'GET /site-content/terms' | 'GET /site-content/travel-insurance' | 'GET /site-features' | 'GET /site-navigation' | 'GET /sitemap' | 'GET /tour-categories' | 'GET /tours' | 'GET /tours/{slug}' | 'GET /tours/{slug}/accommodations' | 'GET /tours/{slug}/availability' | 'GET /tours/{slug}/departures' | 'GET /tours/{slug}/experiences' | 'GET /tours/{slug}/itinerary' | 'GET /tours/{slug}/preview' | 'GET /tours/{slug}/questions' | 'GET /tours/{slug}/reviews' | 'GET /tours/{slug}/reviews-summary' | 'GET /tours/{slug}/route' | 'GET /travel-knowledge' | 'GET /travel-status' | 'GET /traveller-stories' | 'POST /booking-intents' | 'POST /brochure-leads' | 'POST /inquiries';
+export type GeneratedPublicApiVersion = '0.14.0';
+export type GeneratedPublicApiPath = '/booking-intents' | '/booking-intents/{id}' | '/brochure-leads' | '/destinations' | '/destinations/{slug}' | '/homepage' | '/inquiries' | '/locales' | '/localization/previews/{candidateId}' | '/localization/releases/{releaseId}' | '/localization/ui-catalogs/{snapshotId}' | '/search' | '/search-suggestions' | '/site-content/about' | '/site-content/accessibility-statement' | '/site-content/booking-cancellation-policy' | '/site-content/contact' | '/site-content/cookie-policy' | '/site-content/faqs' | '/site-content/footer' | '/site-content/header' | '/site-content/health-safety-support' | '/site-content/home' | '/site-content/iran-travel-status' | '/site-content/iran-visa-information' | '/site-content/money-in-iran' | '/site-content/privacy' | '/site-content/responsible-travel' | '/site-content/tailor-made' | '/site-content/terms' | '/site-content/travel-insurance' | '/site-features' | '/site-navigation' | '/sitemap' | '/tour-categories' | '/tours' | '/tours/{slug}' | '/tours/{slug}/accommodations' | '/tours/{slug}/availability' | '/tours/{slug}/departures' | '/tours/{slug}/experiences' | '/tours/{slug}/itinerary' | '/tours/{slug}/preview' | '/tours/{slug}/questions' | '/tours/{slug}/reviews' | '/tours/{slug}/reviews-summary' | '/tours/{slug}/route' | '/travel-knowledge' | '/travel-status' | '/traveller-stories';
+export type GeneratedPublicApiOperation = 'GET /booking-intents/{id}' | 'GET /destinations' | 'GET /destinations/{slug}' | 'GET /homepage' | 'GET /locales' | 'GET /localization/previews/{candidateId}' | 'GET /localization/releases/{releaseId}' | 'GET /localization/ui-catalogs/{snapshotId}' | 'GET /search' | 'GET /search-suggestions' | 'GET /site-content/about' | 'GET /site-content/accessibility-statement' | 'GET /site-content/booking-cancellation-policy' | 'GET /site-content/contact' | 'GET /site-content/cookie-policy' | 'GET /site-content/faqs' | 'GET /site-content/footer' | 'GET /site-content/header' | 'GET /site-content/health-safety-support' | 'GET /site-content/home' | 'GET /site-content/iran-travel-status' | 'GET /site-content/iran-visa-information' | 'GET /site-content/money-in-iran' | 'GET /site-content/privacy' | 'GET /site-content/responsible-travel' | 'GET /site-content/tailor-made' | 'GET /site-content/terms' | 'GET /site-content/travel-insurance' | 'GET /site-features' | 'GET /site-navigation' | 'GET /sitemap' | 'GET /tour-categories' | 'GET /tours' | 'GET /tours/{slug}' | 'GET /tours/{slug}/accommodations' | 'GET /tours/{slug}/availability' | 'GET /tours/{slug}/departures' | 'GET /tours/{slug}/experiences' | 'GET /tours/{slug}/itinerary' | 'GET /tours/{slug}/preview' | 'GET /tours/{slug}/questions' | 'GET /tours/{slug}/reviews' | 'GET /tours/{slug}/reviews-summary' | 'GET /tours/{slug}/route' | 'GET /travel-knowledge' | 'GET /travel-status' | 'GET /traveller-stories' | 'POST /booking-intents' | 'POST /brochure-leads' | 'POST /inquiries';
+export type GeneratedPublicApiActiveOperation = 'GET /destinations' | 'GET /destinations/{slug}' | 'GET /homepage' | 'GET /locales' | 'GET /localization/previews/{candidateId}' | 'GET /localization/releases/{releaseId}' | 'GET /localization/ui-catalogs/{snapshotId}' | 'GET /search' | 'GET /search-suggestions' | 'GET /site-content/about' | 'GET /site-content/accessibility-statement' | 'GET /site-content/booking-cancellation-policy' | 'GET /site-content/contact' | 'GET /site-content/cookie-policy' | 'GET /site-content/faqs' | 'GET /site-content/footer' | 'GET /site-content/header' | 'GET /site-content/health-safety-support' | 'GET /site-content/home' | 'GET /site-content/iran-travel-status' | 'GET /site-content/iran-visa-information' | 'GET /site-content/money-in-iran' | 'GET /site-content/privacy' | 'GET /site-content/responsible-travel' | 'GET /site-content/tailor-made' | 'GET /site-content/terms' | 'GET /site-content/travel-insurance' | 'GET /site-features' | 'GET /site-navigation' | 'GET /sitemap' | 'GET /tour-categories' | 'GET /tours' | 'GET /tours/{slug}' | 'GET /tours/{slug}/accommodations' | 'GET /tours/{slug}/availability' | 'GET /tours/{slug}/departures' | 'GET /tours/{slug}/experiences' | 'GET /tours/{slug}/itinerary' | 'GET /tours/{slug}/preview' | 'GET /tours/{slug}/questions' | 'GET /tours/{slug}/reviews' | 'GET /tours/{slug}/reviews-summary' | 'GET /tours/{slug}/route' | 'GET /travel-knowledge' | 'GET /travel-status' | 'GET /traveller-stories' | 'POST /booking-intents' | 'POST /brochure-leads' | 'POST /inquiries';
 export type GeneratedPublicApiBlockedOperation = 'GET /booking-intents/{id}';
-export type GeneratedPublicApiOperationId = 'getBookingIntent' | 'listPublicDestinations' | 'getPublicDestinationBySlug' | 'getPublicHomepage' | 'getPublicSearchSuggestions' | 'getPublicSiteContentAbout' | 'getPublicSiteContentAccessibilityStatement' | 'getPublicSiteContentBookingCancellationPolicy' | 'getPublicSiteContentContact' | 'getPublicSiteContentCookiePolicy' | 'getPublicSiteContentFaqs' | 'getPublicSiteContentFooter' | 'getPublicSiteContentHeader' | 'getPublicSiteContentHealthSafetySupport' | 'getPublicSiteContentHome' | 'getPublicSiteContentIranTravelStatus' | 'getPublicSiteContentIranVisaInformation' | 'getPublicSiteContentMoneyInIran' | 'getPublicSiteContentPrivacy' | 'getPublicSiteContentResponsibleTravel' | 'getPublicSiteContentTailorMade' | 'getPublicSiteContentTerms' | 'getPublicSiteContentTravelInsurance' | 'getPublicSiteFeatures' | 'getPublicSiteNavigation' | 'getPublicSitemap' | 'listPublicTourCategories' | 'listPublicTours' | 'getPublicTourBySlug' | 'listPublicTourAccommodations' | 'listPublicTourAvailability' | 'listPublicTourDepartures' | 'listPublicTourExperiences' | 'listPublicTourItinerary' | 'getPublicTourPreviewBySlug' | 'listPublicTourQuestions' | 'listPublicTourReviews' | 'getPublicTourReviewsSummary' | 'listPublicTourRoute' | 'listPublicTravelKnowledge' | 'getPublicTravelStatus' | 'listPublicTravellerStories' | 'createPublicBookingIntent' | 'createPublicBrochureLead' | 'createPublicInquiry';
-export type GeneratedPublicApiSchemaName = 'BookingIntentConflictErrorResponse' | 'BookingIntentResponse' | 'CanonicalIntakeAttribution' | 'CanonicalIntakeConsent' | 'CreateBookingIntentRequest' | 'CreateBookingIntentSuccessResponse' | 'CreateBrochureLeadRequest' | 'CreateBrochureLeadResponse' | 'CreateInquiryRequest' | 'CreateInquiryResponse' | 'GetBookingIntentStatusResponse' | 'PaginationMeta' | 'PublicApiAbuseBlockedError' | 'PublicApiError' | 'PublicApiInternalError' | 'PublicApiNotFoundError' | 'PublicApiNotImplementedError' | 'PublicApiRateLimitError' | 'PublicApiTravelStatusUnavailableError' | 'PublicApiValidationError' | 'PublicAvailabilityListItem' | 'PublicAvailabilityListResponse' | 'PublicBookingIntentLinks' | 'PublicBookingIntentPublicStatus' | 'PublicBookingIntentStatus' | 'PublicCityDestinationContent' | 'PublicCityExperience' | 'PublicCityImage' | 'PublicCityLabelledValue' | 'PublicCityLink' | 'PublicCityNextPlace' | 'PublicCityReason' | 'PublicCityResource' | 'PublicCityRoutePattern' | 'PublicCityStayLink' | 'PublicDepartureListItem' | 'PublicDepartureListResponse' | 'PublicDestinationDetail' | 'PublicDestinationDetailResponse' | 'PublicDestinationListItem' | 'PublicDestinationListResponse' | 'PublicError' | 'PublicErrorEnvelope' | 'PublicHomepageResponse' | 'PublicHomepageSeo' | 'PublicHomepageStats' | 'PublicNavLink' | 'PublicOfficialSourceCard' | 'PublicSearchSuggestion' | 'PublicSearchSuggestionsResponse' | 'PublicSeo' | 'PublicSiteChromeContent' | 'PublicSiteChromeContentResponse' | 'PublicSiteCta' | 'PublicSiteFeaturesResponse' | 'PublicSiteFeatureStates' | 'PublicSiteHomeContent' | 'PublicSiteHomeContentResponse' | 'PublicSiteHomeSection' | 'PublicSitemapEntry' | 'PublicSitemapResponse' | 'PublicSiteNavigationResponse' | 'PublicSiteNavItem' | 'PublicSiteRouteKey' | 'PublicSiteSocialLink' | 'PublicSiteTrustPageContent' | 'PublicSiteTrustPageContentResponse' | 'PublicSiteTrustPageSeo' | 'PublicSiteTrustSection' | 'PublicSiteTrustTitledItem' | 'PublicStaticLink' | 'PublicSurfiranOperationalUpdate' | 'PublicTourAccommodationListItem' | 'PublicTourAccommodationListResponse' | 'PublicTourCategoryListItem' | 'PublicTourCategoryListResponse' | 'PublicTourDetail' | 'PublicTourDetailEditorial' | 'PublicTourDetailResponse' | 'PublicTourExperienceFrame' | 'PublicTourExperienceListItem' | 'PublicTourExperienceListResponse' | 'PublicTourItineraryDay' | 'PublicTourItineraryResponse' | 'PublicTourListItem' | 'PublicTourListResponse' | 'PublicTourQuestionListItem' | 'PublicTourQuestionListResponse' | 'PublicTourRatingBreakdownItem' | 'PublicTourReviewListItem' | 'PublicTourReviewListResponse' | 'PublicTourReviewsAggregate' | 'PublicTourReviewsSummary' | 'PublicTourReviewsSummaryResponse' | 'PublicTourRouteResponse' | 'PublicTourRouteStop' | 'PublicTourTailorJourney' | 'PublicTravelKnowledgeItem' | 'PublicTravelKnowledgeResponse' | 'PublicTravellerStoryListItem' | 'PublicTravellerStoryListResponse' | 'PublicTravelStatusCorrectionNotice' | 'PublicTravelStatusFreshness' | 'PublicTravelStatusHandoff' | 'PublicTravelStatusResponse' | 'PublicTravelStatusReviewerLabel' | 'PublicTravelStatusSection' | 'PublicTravelStatusState' | 'PublicTripBrief';
+export type GeneratedPublicApiOperationId = 'getBookingIntent' | 'listPublicDestinations' | 'getPublicDestinationBySlug' | 'getPublicHomepage' | 'listPublicLocales' | 'getPublicLocalizationCandidatePreview' | 'getPublicLocalizationRelease' | 'getPublicUiCatalog' | 'getPublicSearchResults' | 'getPublicSearchSuggestions' | 'getPublicSiteContentAbout' | 'getPublicSiteContentAccessibilityStatement' | 'getPublicSiteContentBookingCancellationPolicy' | 'getPublicSiteContentContact' | 'getPublicSiteContentCookiePolicy' | 'getPublicSiteContentFaqs' | 'getPublicSiteContentFooter' | 'getPublicSiteContentHeader' | 'getPublicSiteContentHealthSafetySupport' | 'getPublicSiteContentHome' | 'getPublicSiteContentIranTravelStatus' | 'getPublicSiteContentIranVisaInformation' | 'getPublicSiteContentMoneyInIran' | 'getPublicSiteContentPrivacy' | 'getPublicSiteContentResponsibleTravel' | 'getPublicSiteContentTailorMade' | 'getPublicSiteContentTerms' | 'getPublicSiteContentTravelInsurance' | 'getPublicSiteFeatures' | 'getPublicSiteNavigation' | 'getPublicSitemap' | 'listPublicTourCategories' | 'listPublicTours' | 'getPublicTourBySlug' | 'listPublicTourAccommodations' | 'listPublicTourAvailability' | 'listPublicTourDepartures' | 'listPublicTourExperiences' | 'listPublicTourItinerary' | 'getPublicTourPreviewBySlug' | 'listPublicTourQuestions' | 'listPublicTourReviews' | 'getPublicTourReviewsSummary' | 'listPublicTourRoute' | 'listPublicTravelKnowledge' | 'getPublicTravelStatus' | 'listPublicTravellerStories' | 'createPublicBookingIntent' | 'createPublicBrochureLead' | 'createPublicInquiry';
+export type GeneratedPublicApiSchemaName = 'BookingIntentConflictErrorResponse' | 'BookingIntentResponse' | 'CanonicalIntakeAttribution' | 'CanonicalIntakeConsent' | 'CreateBookingIntentRequest' | 'CreateBookingIntentSuccessResponse' | 'CreateBrochureLeadRequest' | 'CreateBrochureLeadResponse' | 'CreateInquiryRequest' | 'CreateInquiryResponse' | 'GetBookingIntentStatusResponse' | 'PaginationMeta' | 'PublicApiAbuseBlockedError' | 'PublicApiError' | 'PublicApiInternalError' | 'PublicApiNotFoundError' | 'PublicApiNotImplementedError' | 'PublicApiRateLimitError' | 'PublicApiTravelStatusUnavailableError' | 'PublicApiValidationError' | 'PublicAvailabilityListItem' | 'PublicAvailabilityListResponse' | 'PublicBookingIntentLinks' | 'PublicBookingIntentPublicStatus' | 'PublicBookingIntentStatus' | 'PublicCityDestinationContent' | 'PublicCityExperience' | 'PublicCityImage' | 'PublicCityLabelledValue' | 'PublicCityLink' | 'PublicCityNextPlace' | 'PublicCityReason' | 'PublicCityResource' | 'PublicCityRoutePattern' | 'PublicCityStayLink' | 'PublicCmsContentSnapshotId' | 'PublicDepartureListItem' | 'PublicDepartureListResponse' | 'PublicDestinationDetail' | 'PublicDestinationDetailResponse' | 'PublicDestinationListItem' | 'PublicDestinationListResponse' | 'PublicError' | 'PublicErrorEnvelope' | 'PublicHomepageResponse' | 'PublicHomepageSeo' | 'PublicHomepageStats' | 'PublicLocaleRegistryData' | 'PublicLocaleRegistryItem' | 'PublicLocaleRegistryResponse' | 'PublicLocaleTag' | 'PublicLocalizationCandidatePreview' | 'PublicLocalizationCandidatePreviewResponse' | 'PublicLocalizationRelease' | 'PublicLocalizationReleaseId' | 'PublicLocalizationReleaseResponse' | 'PublicLocalizationSnapshotReferences' | 'PublicNavLink' | 'PublicOfficialSourceCard' | 'PublicPriceDisplayByCurrency' | 'PublicSearchResultGroup' | 'PublicSearchResultItem' | 'PublicSearchResultsResponse' | 'PublicSearchSuggestion' | 'PublicSearchSuggestionsResponse' | 'PublicSeo' | 'PublicSiteChromeContent' | 'PublicSiteChromeContentResponse' | 'PublicSiteCta' | 'PublicSiteFeaturesResponse' | 'PublicSiteFeatureStates' | 'PublicSiteFooterNavGroup' | 'PublicSiteFooterNavGroupLink' | 'PublicSiteFooterPaymentNote' | 'PublicSiteFooterSupportBand' | 'PublicSiteHeaderMenuCategory' | 'PublicSiteHeaderMenuEditorial' | 'PublicSiteHeaderOffice' | 'PublicSiteHeaderQuickLink' | 'PublicSiteHeaderSearchShortcuts' | 'PublicSiteHomeContent' | 'PublicSiteHomeContentResponse' | 'PublicSiteHomeSection' | 'PublicSitemapEntry' | 'PublicSitemapResponse' | 'PublicSiteNavigationResponse' | 'PublicSiteNavItem' | 'PublicSiteRouteKey' | 'PublicSiteSocialLink' | 'PublicSiteTrustPageContent' | 'PublicSiteTrustPageContentResponse' | 'PublicSiteTrustPageSeo' | 'PublicSiteTrustSection' | 'PublicSiteTrustTitledItem' | 'PublicStaticLink' | 'PublicSurfiranOperationalUpdate' | 'PublicTourAccommodationListItem' | 'PublicTourAccommodationListResponse' | 'PublicTourCatalogDepartureSummary' | 'PublicTourCatalogFacetOption' | 'PublicTourCatalogMetadata' | 'PublicTourCategoryListItem' | 'PublicTourCategoryListResponse' | 'PublicTourDetail' | 'PublicTourDetailEditorial' | 'PublicTourDetailResponse' | 'PublicTourExperienceFrame' | 'PublicTourExperienceListItem' | 'PublicTourExperienceListResponse' | 'PublicTourItineraryDay' | 'PublicTourItineraryResponse' | 'PublicTourListItem' | 'PublicTourListResponse' | 'PublicTourMediaItem' | 'PublicTourQuestionListItem' | 'PublicTourQuestionListResponse' | 'PublicTourRatingBreakdownItem' | 'PublicTourReviewListItem' | 'PublicTourReviewListResponse' | 'PublicTourReviewsAggregate' | 'PublicTourReviewsSummary' | 'PublicTourReviewsSummaryResponse' | 'PublicTourRouteResponse' | 'PublicTourRouteStop' | 'PublicTourTailorJourney' | 'PublicTravelKnowledgeItem' | 'PublicTravelKnowledgeResponse' | 'PublicTravellerStoryListItem' | 'PublicTravellerStoryListResponse' | 'PublicTravelStatusCorrectionNotice' | 'PublicTravelStatusFreshness' | 'PublicTravelStatusHandoff' | 'PublicTravelStatusResponse' | 'PublicTravelStatusReviewerLabel' | 'PublicTravelStatusSection' | 'PublicTravelStatusState' | 'PublicTripBrief' | 'PublicUiCatalog' | 'PublicUiCatalogFallbackSummary' | 'PublicUiCatalogMessage' | 'PublicUiCatalogResponse' | 'PublicUiCatalogSnapshotId';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { createPublicApiClient } from './client.js';
-export type { PublicApiErrorCode, PublicApiV1Path, PublicApiV1RouteMap, PublicError, PublicErrorEnvelope, PublicApiError, PublicApiNotImplementedError, PublicApiValidationError, PublicApiRateLimitError, PublicApiAbuseBlockedError, PublicTourListItem, PublicTourDetail, PublicTourDetailEditorial, PublicDepartureListItem, PublicAvailabilityStatus, PublicAvailabilityListItem, PublicAvailabilityListResponse, PublicDestinationListItem, PublicCityDestinationContent, PublicCityExperience, PublicCityImage, PublicCityLabelledValue, PublicCityLink, PublicCityNextPlace, PublicCityReason, PublicCityResource, PublicCityStayLink, PublicDestinationDetail, PublicTourListResponse, PublicTourDetailResponse, PublicDepartureListResponse, PublicDestinationListResponse, PublicDestinationDetailResponse, PublicApiResult, ListPublicToursParams, GetPublicTourPreviewParams, ListPublicDeparturesParams, ListPublicTourAvailabilityParams, ListPublicDestinationsParams, PublicInquiryRequest, PublicTourTailorJourney, PublicInquiryResponse, PublicBookingIntentRequest, PublicBookingIntentData, PublicBookingIntentResponse, PublicHomepageStats, PublicHomepageSeo, PublicHomepageResponse, PublicSitemapEntry, PublicSitemapResponse, PublicNavLink, PublicStaticLink, PublicSiteNavigationResponse, PublicTourCategoryListItem, PublicTourCategoryListResponse, PublicSearchSuggestion, PublicSearchSuggestionsResponse, PublicSiteRouteKey, PublicSiteCta, PublicSiteHomeSectionType, PublicSiteHomeSection, PublicSiteHomeContent, PublicSiteHomeContentResponse, PublicSiteNavItem, PublicSiteSocialPlatform, PublicSiteSocialLink, PublicSiteChromeContent, PublicSiteChromeContentResponse, PublicSiteFeatureStates, PublicSiteFeaturesResponse, PublicSiteTrustSectionType, PublicSiteTrustTitledItem, PublicSiteTrustParagraphGroup, PublicSiteTrustTitledItemList, PublicSiteTrustBulletList, PublicSiteTrustSection, PublicSiteTrustPageSeo, PublicSiteTrustPageContent, PublicSiteTrustPageContentResponse, PublicTravelStatusState, PublicTravelStatusFreshness, PublicSurfiranOperationalUpdate, PublicTravelStatusResponse, PublicTravelKnowledgeType, PublicTravelKnowledgeItem, PublicTravelKnowledgeResponse, GetPublicSitemapParams, GetPublicSearchSuggestionsParams, GetPublicTravelKnowledgeParams, ListPublicTourCategoriesParams, PublicTravellerStoryListItem, PublicTravellerStoryListResponse, ListPublicTravellerStoriesParams, PublicTourQuestionListItem, PublicTourQuestionListResponse, ListPublicTourQuestionsParams, PublicTourExperienceFrame, PublicTourExperienceListItem, PublicTourExperienceListResponse, ListPublicTourExperiencesParams, PublicTourAccommodationListItem, PublicTourAccommodationListResponse, ListPublicTourAccommodationsParams, PublicTourReviewsAggregate, PublicTourRatingBreakdownItem, PublicTourReviewsSummary, PublicTourReviewsSummaryResponse, PublicTourReviewListItem, PublicTourReviewListResponse, PublicTourReviewsLimit, ListPublicTourReviewsParams, PublicTourRouteStop, PublicTourRouteResponse, ListPublicTourRouteParams, PublicItineraryMealCode, PublicTourItineraryDay, PublicTourItineraryResponse, ListPublicTourItineraryParams, PublicBrochureLeadRequest, PublicBrochureLeadResponse, } from './types.js';
+export type { PublicApiErrorCode, PublicApiV1Path, PublicApiV1RouteMap, PublicError, PublicErrorEnvelope, PublicApiError, PublicApiNotImplementedError, PublicApiValidationError, PublicApiRateLimitError, PublicApiAbuseBlockedError, PublicTourListItem, PublicTourDetail, PublicTourDetailEditorial, PublicDepartureListItem, PublicAvailabilityStatus, PublicAvailabilityListItem, PublicAvailabilityListResponse, PublicDestinationListItem, PublicCityDestinationContent, PublicCityExperience, PublicCityImage, PublicCityLabelledValue, PublicCityLink, PublicCityNextPlace, PublicCityReason, PublicCityResource, PublicCityStayLink, PublicDestinationDetail, PublicTourListResponse, PublicTourCatalogMetadata, PublicTourCatalogFacetKey, PublicTourCatalogFacetOption, PublicTourCatalogSort, PublicTourCatalogDepartureSummary, PublicTourDetailResponse, PublicDepartureListResponse, PublicDestinationListResponse, PublicDestinationDetailResponse, PublicApiResult, ListPublicToursParams, GetPublicTourParams, PublicContentLocale, GetPublicTourPreviewParams, ListPublicDeparturesParams, ListPublicTourAvailabilityParams, ListPublicDestinationsParams, PublicInquiryRequest, PublicTourTailorJourney, PublicInquiryResponse, PublicBookingIntentRequest, PublicBookingIntentData, PublicBookingIntentResponse, PublicHomepageStats, PublicHomepageSeo, PublicHomepageResponse, PublicSitemapEntry, PublicSitemapResponse, PublicNavLink, PublicStaticLink, PublicSiteNavigationResponse, PublicTourCategoryListItem, PublicTourCategoryListResponse, PublicPriceDisplayByCurrency, PublicSearchResultItem, PublicSearchResultGroup, PublicSearchResultsResponse, PublicSearchSuggestion, PublicSearchSuggestionsResponse, PublicSiteRouteKey, PublicSiteCta, PublicSiteHomeSectionType, PublicSiteHomeSection, PublicSiteHomeContent, PublicSiteHomeContentResponse, PublicSiteNavItem, PublicSiteSocialPlatform, PublicSiteSocialLink, PublicSiteHeaderOffice, PublicSiteHeaderMenuCategory, PublicSiteHeaderMenuEditorial, PublicSiteHeaderQuickLink, PublicSiteHeaderSearchShortcuts, PublicSiteFooterNavGroupLink, PublicSiteFooterNavGroup, PublicSiteFooterSupportBand, PublicSiteFooterPaymentNote, PublicSiteChromeContent, PublicSiteChromeContentResponse, PublicSiteFeatureStates, PublicSiteFeaturesResponse, LocaleTag, LocalizationReleaseId, UiCatalogSnapshotId, CmsContentSnapshotId, PublicLocaleRegistryItem, PublicLocaleRegistryResponse, PublicLocalizationRelease, PublicLocalizationReleaseResponse, PublicUiCatalogMessage, PublicUiCatalog, PublicUiCatalogResponse, PublicSiteTrustSectionType, PublicSiteTrustTitledItem, PublicSiteTrustParagraphGroup, PublicSiteTrustTitledItemList, PublicSiteTrustBulletList, PublicSiteTrustSection, PublicSiteTrustPageSeo, PublicSiteTrustPageContent, PublicSiteTrustPageContentResponse, PublicTravelStatusState, PublicTravelStatusFreshness, PublicSurfiranOperationalUpdate, PublicTravelStatusResponse, PublicTravelKnowledgeType, PublicTravelKnowledgeItem, PublicTravelKnowledgeResponse, GetPublicSitemapParams, GetPublicSearchResultsParams, GetPublicSearchSuggestionsParams, GetPublicTravelKnowledgeParams, ListPublicTourCategoriesParams, PublicTravellerStoryListItem, PublicTravellerStoryListResponse, ListPublicTravellerStoriesParams, PublicTourQuestionListItem, PublicTourQuestionListResponse, ListPublicTourQuestionsParams, PublicTourExperienceFrame, PublicTourExperienceListItem, PublicTourExperienceListResponse, ListPublicTourExperiencesParams, PublicTourAccommodationListItem, PublicTourAccommodationListResponse, ListPublicTourAccommodationsParams, PublicTourReviewsAggregate, PublicTourRatingBreakdownItem, PublicTourReviewsSummary, PublicTourReviewsSummaryResponse, PublicTourReviewListItem, PublicTourReviewListResponse, PublicTourReviewsLimit, ListPublicTourReviewsParams, PublicTourRouteStop, PublicTourRouteResponse, ListPublicTourRouteParams, PublicItineraryMealCode, PublicTourItineraryDay, PublicTourItineraryResponse, ListPublicTourItineraryParams, PublicBrochureLeadRequest, PublicBrochureLeadResponse, } from './types.js';
 export type { PublicApiClientOptions } from './client.js';
 export type { GeneratedPublicApiVersion, GeneratedPublicApiPath, GeneratedPublicApiOperation, GeneratedPublicApiActiveOperation, GeneratedPublicApiBlockedOperation, GeneratedPublicApiOperationId, GeneratedPublicApiSchemaName, } from './generated/public-api-v1.js';

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-export type PublicApiErrorCode = 'PUBLIC_API_ROUTE_NOT_IMPLEMENTED' | 'PUBLIC_API_INTERNAL_ERROR' | 'PUBLIC_API_TOUR_NOT_FOUND' | 'PUBLIC_API_DESTINATION_NOT_FOUND' | 'PUBLIC_API_INVALID_QUERY' | 'PUBLIC_API_BOOKING_INTENT_VALIDATION_ERROR' | 'PUBLIC_API_IDEMPOTENCY_CONFLICT' | 'PUBLIC_API_RATE_LIMITED' | 'PUBLIC_API_ABUSE_BLOCKED' | 'PUBLIC_API_TRAVEL_STATUS_UNAVAILABLE' | 'PUBLIC_API_SITE_CONTENT_UNAVAILABLE' | 'PUBLIC_API_CLIENT_TIMEOUT';
-export type PublicApiV1Path = '/homepage' | '/site-navigation' | '/site-features' | '/sitemap' | '/search-suggestions' | '/tour-categories' | '/tours' | '/tours/{slug}' | '/tours/{slug}/preview' | '/tours/{slug}/departures' | '/tours/{slug}/availability' | '/tours/{slug}/reviews' | '/destinations' | '/destinations/{slug}' | '/inquiries' | '/booking-intents' | '/travel-status' | '/travel-knowledge' | '/site-content/home' | '/site-content/header' | '/site-content/footer' | '/site-content/about' | '/site-content/contact' | '/site-content/tailor-made' | '/site-content/faqs' | '/site-content/privacy' | '/site-content/terms' | '/site-content/responsible-travel' | '/site-content/iran-travel-status' | '/site-content/iran-visa-information' | '/site-content/money-in-iran' | '/site-content/travel-insurance' | '/site-content/health-safety-support' | '/site-content/booking-cancellation-policy' | '/site-content/cookie-policy' | '/site-content/accessibility-statement';
+export type PublicApiErrorCode = 'PUBLIC_API_ROUTE_NOT_IMPLEMENTED' | 'PUBLIC_API_INTERNAL_ERROR' | 'PUBLIC_API_TOUR_NOT_FOUND' | 'PUBLIC_API_DESTINATION_NOT_FOUND' | 'PUBLIC_API_INVALID_QUERY' | 'PUBLIC_API_BOOKING_INTENT_VALIDATION_ERROR' | 'PUBLIC_API_IDEMPOTENCY_CONFLICT' | 'PUBLIC_API_RATE_LIMITED' | 'PUBLIC_API_ABUSE_BLOCKED' | 'PUBLIC_API_TRAVEL_STATUS_UNAVAILABLE' | 'PUBLIC_API_SITE_CONTENT_UNAVAILABLE' | 'PUBLIC_API_LOCALIZATION_NOT_FOUND' | 'PUBLIC_API_LOCALIZATION_UNAVAILABLE' | 'PUBLIC_API_CLIENT_TIMEOUT';
+export type PublicApiV1Path = '/homepage' | '/site-navigation' | '/site-features' | '/locales' | '/localization/previews/{candidateId}' | '/localization/releases/{releaseId}' | '/localization/ui-catalogs/{snapshotId}' | '/sitemap' | '/search-suggestions' | '/tour-categories' | '/tours' | '/tours/{slug}' | '/tours/{slug}/preview' | '/tours/{slug}/departures' | '/tours/{slug}/availability' | '/tours/{slug}/reviews' | '/destinations' | '/destinations/{slug}' | '/inquiries' | '/booking-intents' | '/travel-status' | '/travel-knowledge' | '/site-content/home' | '/site-content/header' | '/site-content/footer' | '/site-content/about' | '/site-content/contact' | '/site-content/tailor-made' | '/site-content/faqs' | '/site-content/privacy' | '/site-content/terms' | '/site-content/responsible-travel' | '/site-content/iran-travel-status' | '/site-content/iran-visa-information' | '/site-content/money-in-iran' | '/site-content/travel-insurance' | '/site-content/health-safety-support' | '/site-content/booking-cancellation-policy' | '/site-content/cookie-policy' | '/site-content/accessibility-statement';
 export type PublicError = {
     code: string;
     message: string;
@@ -51,7 +51,23 @@ export type PublicApiIdempotencyConflictError = {
         status: 409;
     };
 };
+/**
+ * One finished display string per public display currency.
+ *
+ * Deliberately a per-payload map rather than a `?currency=` query parameter: a
+ * parameter would multiply every cached page by the number of currencies, while
+ * a map is one cache entry serving all of them and lets a consumer switch
+ * currency with no refetch. Every entry is `null` when the price, or the amount
+ * behind it, is not publishable.
+ */
+export type PublicPriceDisplayByCurrency = {
+    USD: string | null;
+    EUR: string | null;
+    GBP: string | null;
+};
 export type PublicTourListItem = {
+    /** Published dates, independent of capacity; present in catalog mode. */
+    departureSummary?: PublicTourCatalogDepartureSummary;
     id: number;
     slug: string;
     title: string;
@@ -60,6 +76,16 @@ export type PublicTourListItem = {
     durationNights: number | null;
     startingPriceDisplay: string | null;
     currency: string | null;
+    /**
+     * The same published starting price rendered in each display currency the
+     * public site offers. Finished display strings, never rates or raw amounts:
+     * the CRM converts from its own operational `fx_rates`, so a consumer picks a
+     * string and can neither round nor format differently.
+     *
+     * A currency with no active rate for this price's own currency is `null`, and
+     * the consumer falls back to `startingPriceDisplay` as published.
+     */
+    priceDisplayByCurrency: PublicPriceDisplayByCurrency;
     heroImage: string | null;
     primaryDestinations: string[];
     /**
@@ -383,6 +409,7 @@ export type PublicAvailabilityListItem = {
     bookingStatus: 'open' | 'closed' | null;
     currency: string | null;
     priceDisplay: string | null;
+    priceDisplayByCurrency: PublicPriceDisplayByCurrency;
     promoLabel?: string | null;
     publicNote?: string | null;
     roomBasis?: 'twin_share' | 'double_share' | 'single_room' | 'triple_share' | 'family_room' | null;
@@ -390,6 +417,7 @@ export type PublicAvailabilityListItem = {
         basis: 'twin_share' | 'double_share' | 'single_room' | 'private_departure';
         label: string;
         priceDisplay: string;
+        priceDisplayByCurrency: PublicPriceDisplayByCurrency;
         minimumTravelers?: number;
     }>;
     remainingCapacityBucket: 'available' | 'limited' | 'full' | 'unconstrained' | 'unknown';
@@ -550,7 +578,25 @@ export type PublicTourListResponse = {
     data: PublicTourListItem[];
     nextCursor: string | null;
     total: number;
+    catalog?: PublicTourCatalogMetadata;
+};
+export type PublicTourCatalogDepartureSummary = {
+    nextDepartureDate: string | null;
+    upcomingCount: number;
+    upcomingMonths: string[];
+};
+export type PublicTourCatalogFacetKey = 'countries' | 'styles' | 'travelFormats' | 'activityLevels' | 'durationBuckets' | 'journeyTypes' | 'months';
+export type PublicTourCatalogFacetOption = {
+    value: string;
+    label: string;
+    count: number;
+};
+export type PublicTourCatalogMetadata = {
+    asOf: string;
+    unfilteredTotal: number;
+    facets: Record<PublicTourCatalogFacetKey, PublicTourCatalogFacetOption[]>;
 };
+export type PublicTourCatalogSort = 'departure-soonest' | 'duration-asc' | 'duration-desc' | 'default';
 export type PublicTourDetailResponse = {
     data: PublicTourDetail;
 };
@@ -808,6 +854,17 @@ export type PublicTourCategoryListItem = {
     slug: string;
     name: string;
     tourCount: number;
+    /**
+     * Shortest published duration among this category's active tours, in days.
+     * Derived from active tour data, never authored, so a rendered range cannot
+     * disagree with the catalogue. `null` when no tour in the category publishes
+     * a usable duration -- never a guessed value.
+     *
+     * Optional so a response projected before these fields existed typechecks.
+     */
+    durationMinDays?: number | null;
+    /** Longest published duration. Same derivation and same null rule. */
+    durationMaxDays?: number | null;
 };
 export type PublicTourCategoryListResponse = {
     data: PublicTourCategoryListItem[];
@@ -825,6 +882,37 @@ export type PublicSearchSuggestionsResponse = {
     total: number;
     query: string;
 };
+/**
+ * One search hit. Already-public identity and published summary text only.
+ *
+ * Guides are deliberately absent from the union: guide records are staff and
+ * supplier data and no public-safe guide projection exists, so a guide group
+ * would be a promise the contract cannot keep.
+ */
+export type PublicSearchResultItem = {
+    type: 'tour' | 'destination';
+    label: string;
+    slug: string;
+    path: string;
+    summary: string | null;
+};
+export type PublicSearchResultGroup = {
+    type: 'tour' | 'destination';
+    /** Every match found in the scanned set, which may exceed `items.length`. */
+    total: number;
+    items: PublicSearchResultItem[];
+};
+export type PublicSearchResultsResponse = {
+    query: string;
+    groups: PublicSearchResultGroup[];
+    /** Sum of every group total. */
+    total: number;
+    /**
+     * False when the published set outgrew the server's scan bound, so a caller
+     * can tell "no more matches" from "we stopped looking". Never silently true.
+     */
+    complete: boolean;
+};
 export type PublicTravelKnowledgeType = 'city' | 'landmark' | 'activity' | 'accommodation_label' | 'theme';
 export type PublicTravelKnowledgeItem = {
     type: PublicTravelKnowledgeType;
@@ -892,7 +980,7 @@ export type PublicTravelStatusResponse = {
     };
 };
 /** Closed public route vocabulary. Routing is resolved by the rendering layer. */
-export type PublicSiteRouteKey = 'home' | 'tours' | 'tour-categories' | 'destinations' | 'about' | 'contact' | 'inquire' | 'faqs' | 'privacy' | 'terms' | 'responsible-travel' | 'iran-travel-status' | 'iran-visa-information' | 'money-in-iran' | 'travel-insurance' | 'health-safety-support' | 'booking-cancellation-policy' | 'cookie-policy' | 'accessibility-statement' | 'reviews' | 'travel-trade' | 'tailor-made';
+export type PublicSiteRouteKey = 'home' | 'tours' | 'tour-categories' | 'destinations' | 'about' | 'contact' | 'inquire' | 'faqs' | 'privacy' | 'terms' | 'responsible-travel' | 'iran-travel-status' | 'iran-visa-information' | 'money-in-iran' | 'travel-insurance' | 'health-safety-support' | 'booking-cancellation-policy' | 'cookie-policy' | 'accessibility-statement' | 'reviews' | 'travel-trade' | 'tailor-made' | 'ask-a-specialist' | 'journal' | 'travel-guide' | 'airport-transfers';
 export type PublicSiteCta = {
     label: string;
     routeKey: PublicSiteRouteKey;
@@ -922,12 +1010,99 @@ export type PublicSiteSocialLink = {
     platform: PublicSiteSocialPlatform;
     url: string;
 };
+/**
+ * Published office line for the site chrome.
+ *
+ * `timeZone` is an IANA zone name, so a consumer formats a real local time from
+ * it. A numeric UTC offset is deliberately not representable -- it would be
+ * wrong for half the year in any zone that observes a transition -- and a zone
+ * the serving runtime cannot format is emitted as `null` rather than passed on.
+ */
+export type PublicSiteHeaderOffice = {
+    label: string | null;
+    hoursText: string | null;
+    /** IANA time zone name, for example `Asia/Tehran`. */
+    timeZone: string | null;
+};
+/**
+ * Operator-authored editorial for one tour category, keyed on the slug
+ * `GET /tour-categories` publishes.
+ *
+ * Editorial text only. Tour counts and duration ranges are derived from active
+ * tour data and are deliberately not representable here, so a published value
+ * can never disagree with the catalogue.
+ */
+export type PublicSiteHeaderMenuCategory = {
+    categorySlug: string;
+    blurb: string | null;
+    ctaLabel: string | null;
+    tags: string[];
+};
+export type PublicSiteHeaderMenuEditorial = {
+    iranTagline: string | null;
+    categories: PublicSiteHeaderMenuCategory[];
+};
+/**
+ * A search-dialog shortcut. Carries a closed route key, never a path or URL, so
+ * a shortcut can never point off-site or at an internal CRM route.
+ */
+export type PublicSiteHeaderQuickLink = {
+    label: string;
+    routeKey: PublicSiteRouteKey;
+};
+export type PublicSiteHeaderSearchShortcuts = {
+    popularSearches: string[];
+    quickLinks: PublicSiteHeaderQuickLink[];
+};
+/** One link inside a footer navigation group. Carries a closed route key, never a path. */
+export type PublicSiteFooterNavGroupLink = {
+    label: string;
+    routeKey: PublicSiteRouteKey;
+};
+/** One of the footer's grouped navigation columns (for example "Explore"). */
+export type PublicSiteFooterNavGroup = {
+    title: string;
+    links: PublicSiteFooterNavGroupLink[];
+};
+/** The footer's "Planning a trip to Iran?" support band. `null` when nothing is published. */
+export type PublicSiteFooterSupportBand = {
+    heading: string | null;
+    body: string | null;
+    primary: PublicSiteCta | null;
+    secondary: PublicSiteCta | null;
+};
+/** The footer's "Payment" row body copy and its one CTA. `null` when nothing is published. */
+export type PublicSiteFooterPaymentNote = {
+    body: string | null;
+    cta: PublicSiteCta | null;
+};
 export type PublicSiteChromeContent = {
     navItems: PublicSiteNavItem[];
     cta: PublicSiteCta | null;
     contactEmail: string | null;
     contactPhone: string | null;
     socialLinks: PublicSiteSocialLink[];
+    /**
+     * Header editorial. These three exist on both shared surfaces so the shape is
+     * stable, but they are Header concepts: the Footer publishes `null` for each.
+     * An unpublished or unusable value is `null` rather than an empty object, so a
+     * consumer has one absent case to handle rather than two.
+     *
+     * Optional so a response projected before these fields existed typechecks.
+     */
+    office?: PublicSiteHeaderOffice | null;
+    menuEditorial?: PublicSiteHeaderMenuEditorial | null;
+    searchShortcuts?: PublicSiteHeaderSearchShortcuts | null;
+    /**
+     * Footer editorial. These exist on both shared surfaces so the shape is
+     * stable, but they are Footer concepts: the Header publishes an empty array
+     * / `null` for each.
+     *
+     * Optional so a response projected before these fields existed typechecks.
+     */
+    navGroups?: PublicSiteFooterNavGroup[];
+    supportBand?: PublicSiteFooterSupportBand | null;
+    paymentNote?: PublicSiteFooterPaymentNote | null;
 };
 export type PublicSiteChromeContentResponse = {
     data: PublicSiteChromeContent | null;
@@ -1050,11 +1225,99 @@ export type PublicSiteFeaturesResponse = {
         features: PublicSiteFeatureStates;
     };
 };
+export type LocaleTag = string;
+export type LocalizationReleaseId = `lr1_${string}`;
+export type LocalizationPreviewCapability = string;
+export type UiCatalogSnapshotId = `ui1_${string}`;
+export type CmsContentSnapshotId = `cms1_${string}`;
+export type PublicLocaleRegistryItem = {
+    localeTag: LocaleTag;
+    language: string;
+    script: string | null;
+    region: string | null;
+    direction: 'ltr' | 'rtl';
+    routePrefix: string;
+    hreflangTag: LocaleTag;
+    fallbackLocaleTag: LocaleTag | null;
+    isDefault: boolean;
+    defaultCalendar: string;
+    defaultNumberingSystem: string;
+    defaultTimeZone: string;
+    activeReleaseId: LocalizationReleaseId;
+};
+export type PublicLocaleRegistryResponse = {
+    data: {
+        schemaVersion: 1;
+        marketScope: 'global';
+        locales: PublicLocaleRegistryItem[];
+    };
+};
+export type PublicLocalizationRelease = {
+    schemaVersion: 1;
+    releaseId: LocalizationReleaseId;
+    localeTag: LocaleTag;
+    contentLanguage: LocaleTag;
+    channel: 'public_web';
+    marketScope: string;
+    manifestVersion: string;
+    compatibilityVersion: string;
+    checksum: string;
+    snapshots: {
+        uiCatalog: UiCatalogSnapshotId;
+        cmsContent: CmsContentSnapshotId;
+    };
+};
+export type PublicLocalizationReleaseResponse = {
+    data: PublicLocalizationRelease;
+};
+export type PublicUiCatalogMessage = {
+    messageId: string;
+    resolvedLocale: LocaleTag;
+    fallbackStatus: 'none' | 'safe_fallback';
+    syntaxVersion: string;
+    variableSchema: Record<string, unknown>;
+    value: unknown;
+    contentChecksum: string;
+};
+export type PublicUiCatalog = {
+    schemaVersion: 1;
+    snapshotId: UiCatalogSnapshotId;
+    requestedLocale: LocaleTag;
+    sourceLocale: LocaleTag;
+    contentLanguage: LocaleTag;
+    manifestVersion: string;
+    compatibilityVersion: string;
+    checksum: string;
+    fallbackSummary: {
+        itemCount: number;
+        fallbackCount: number;
+    };
+    messages: PublicUiCatalogMessage[];
+};
+export type PublicUiCatalogResponse = {
+    data: PublicUiCatalog;
+};
+export type PublicLocalizationCandidatePreview = {
+    schemaVersion: 1;
+    candidateId: LocalizationReleaseId;
+    requestedLocale: LocaleTag;
+    contentLanguage: LocaleTag;
+    release: PublicLocalizationRelease;
+    uiCatalog: PublicUiCatalog;
+};
+export type PublicLocalizationCandidatePreviewResponse = {
+    data: PublicLocalizationCandidatePreview;
+};
 export type PublicApiV1RouteMap = {
     'GET /homepage': PublicHomepageResponse;
     'GET /site-navigation': PublicSiteNavigationResponse;
     'GET /site-features': PublicSiteFeaturesResponse;
+    'GET /locales': PublicLocaleRegistryResponse;
+    'GET /localization/previews/{candidateId}': PublicLocalizationCandidatePreviewResponse;
+    'GET /localization/releases/{releaseId}': PublicLocalizationReleaseResponse;
+    'GET /localization/ui-catalogs/{snapshotId}': PublicUiCatalogResponse;
     'GET /sitemap': PublicSitemapResponse;
+    'GET /search': PublicSearchResultsResponse;
     'GET /search-suggestions': PublicSearchSuggestionsResponse;
     'GET /tour-categories': PublicTourCategoryListResponse;
     'GET /tours': PublicTourListResponse;
@@ -1101,6 +1364,17 @@ export type PublicApiResult<T> = {
     requestId: string | null;
 };
 export type ListPublicToursParams = {
+    /** OR within each group, AND between groups. Values are supplied by catalog facets. */
+    countries?: string[];
+    styles?: string[];
+    travelFormats?: string[];
+    activityLevels?: string[];
+    durationBuckets?: string[];
+    journeyTypes?: string[];
+    months?: string[];
+    hasUpcomingDepartures?: boolean;
+    sort?: PublicTourCatalogSort;
+    includeFacets?: boolean;
     limit?: number;
     cursor?: string;
     /** Itinerary-derived destination slug, matched server-side. */
@@ -1109,6 +1383,21 @@ export type ListPublicToursParams = {
     minDuration?: number;
     /** Inclusive upper bound on `durationDays`. */
     maxDuration?: number;
+    /**
+     * Content locale for CRM-authored tour copy (ADR-0023). Every approved and
+     * published translation replaces its English source; anything not translated,
+     * or translated from text that has since changed, stays as published in
+     * English. Omitted, or 'en', requests the English source. Typed facts —
+     * prices, durations, currencies, availability — are formatted per locale by
+     * the consumer and are never affected by this parameter.
+     */
+    locale?: PublicContentLocale;
+};
+/** Locales the public content contract will resolve translations for. */
+export type PublicContentLocale = 'en' | 'de' | 'fr' | 'es' | 'it' | 'fa' | 'ar';
+export type GetPublicTourParams = {
+    /** See ListPublicToursParams['locale']. */
+    locale?: PublicContentLocale;
 };
 export type ListPublicDeparturesParams = {
     limit?: number;
@@ -1153,6 +1442,12 @@ export type GetPublicSearchSuggestionsParams = {
     limit?: number;
     type?: 'tour' | 'destination';
 };
+export type GetPublicSearchResultsParams = {
+    q: string;
+    /** Maximum items per group. 1 through 25; defaults to 10 server-side. Group totals still report every match. */
+    limit?: number;
+    type?: 'tour' | 'destination';
+};
 export type ListPublicTourCategoriesParams = {
     limit?: number;
     cursor?: string;

package/dist/types.js

@@ -1,3 +1,3 @@
-// TypeScript interfaces aligned with server/openapi/public-api-v1.yaml v0.9.0
+// TypeScript interfaces aligned with server/openapi/public-api-v1.yaml v0.10.0
 // Zero runtime code. Types only.
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surfiran/public-api-client",
-  "version": "0.14.0",
+  "version": "0.20.0",
   "description": "TypeScript types and client for SURFIRAN CRM Public API V1",
   "type": "module",
   "engines": {