@surfiran/public-api-client 0.15.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 { GetPublicSearchResultsParams, 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, PublicSearchResultsResponse, 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,6 +41,10 @@ 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>>;

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)
@@ -173,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
@@ -247,6 +262,18 @@ 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);
         },

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' | '/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' | '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' | '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' | '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' | 'PublicDepartureListItem' | 'PublicDepartureListResponse' | 'PublicDestinationDetail' | 'PublicDestinationDetailResponse' | 'PublicDestinationListItem' | 'PublicDestinationListResponse' | 'PublicError' | 'PublicErrorEnvelope' | 'PublicHomepageResponse' | 'PublicHomepageSeo' | 'PublicHomepageStats' | 'PublicNavLink' | 'PublicOfficialSourceCard' | 'PublicPriceDisplayByCurrency' | 'PublicSearchResultGroup' | 'PublicSearchResultItem' | 'PublicSearchResultsResponse' | 'PublicSearchSuggestion' | 'PublicSearchSuggestionsResponse' | 'PublicSeo' | 'PublicSiteChromeContent' | 'PublicSiteChromeContentResponse' | 'PublicSiteCta' | 'PublicSiteFeaturesResponse' | 'PublicSiteFeatureStates' | 'PublicSiteHeaderMenuCategory' | 'PublicSiteHeaderMenuEditorial' | 'PublicSiteHeaderOffice' | 'PublicSiteHeaderQuickLink' | 'PublicSiteHeaderSearchShortcuts' | '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, PublicPriceDisplayByCurrency, PublicSearchResultItem, PublicSearchResultGroup, PublicSearchResultsResponse, PublicSearchSuggestion, PublicSearchSuggestionsResponse, PublicSiteRouteKey, PublicSiteCta, PublicSiteHomeSectionType, PublicSiteHomeSection, PublicSiteHomeContent, PublicSiteHomeContentResponse, PublicSiteNavItem, PublicSiteSocialPlatform, PublicSiteSocialLink, PublicSiteHeaderOffice, PublicSiteHeaderMenuCategory, PublicSiteHeaderMenuEditorial, PublicSiteHeaderQuickLink, PublicSiteHeaderSearchShortcuts, PublicSiteChromeContent, PublicSiteChromeContentResponse, PublicSiteFeatureStates, PublicSiteFeaturesResponse, 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 { 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;
@@ -66,6 +66,8 @@ export type PublicPriceDisplayByCurrency = {
     GBP: string | null;
 };
 export type PublicTourListItem = {
+    /** Published dates, independent of capacity; present in catalog mode. */
+    departureSummary?: PublicTourCatalogDepartureSummary;
     id: number;
     slug: string;
     title: string;
@@ -81,10 +83,9 @@ export type PublicTourListItem = {
      * 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. Optional so
-     * a response projected before this field existed still typechecks.
+     * the consumer falls back to `startingPriceDisplay` as published.
      */
-    priceDisplayByCurrency?: PublicPriceDisplayByCurrency;
+    priceDisplayByCurrency: PublicPriceDisplayByCurrency;
     heroImage: string | null;
     primaryDestinations: string[];
     /**
@@ -408,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;
@@ -415,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';
@@ -575,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;
 };
@@ -959,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;
@@ -1033,6 +1054,28 @@ 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;
@@ -1050,6 +1093,16 @@ export type PublicSiteChromeContent = {
     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;
@@ -1172,10 +1225,97 @@ 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;
@@ -1224,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. */
@@ -1232,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;

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.15.0",
+  "version": "0.20.0",
   "description": "TypeScript types and client for SURFIRAN CRM Public API V1",
   "type": "module",
   "engines": {