@voyantjs/connect-sdk 0.1.0

package/dist/client.js

@@ -0,0 +1,644 @@
+import { VoyantApiError, VoyantTransport } from "@voyant-sdk/sdk-core";
+function withIdempotency(idempotencyKey) {
+    if (!idempotencyKey)
+        return undefined;
+    return { "idempotency-key": idempotencyKey };
+}
+function scopeQuery(filter) {
+    if (!filter)
+        return {};
+    const out = {};
+    if (filter.connectionId !== undefined)
+        out.connectionId = filter.connectionId;
+    if (filter.providerKey !== undefined)
+        out.providerKey = filter.providerKey;
+    return out;
+}
+export class VoyantConnectClient {
+    transport;
+    defaultOperatorId;
+    constructor(options) {
+        this.transport = new VoyantTransport(options);
+        this.defaultOperatorId = options.operatorId ?? null;
+    }
+    resolveOperatorId(scope) {
+        const operatorId = scope?.operatorId ?? this.defaultOperatorId;
+        if (!operatorId) {
+            throw new VoyantApiError("operatorId is required: pass it via the call's OperatorScope or set VoyantConnectClientOptions.operatorId", { status: 0, body: null, requestId: null });
+        }
+        return operatorId;
+    }
+    // ── OAuth ─────────────────────────────────────────────────────────────
+    oauth = {
+        issueToken: (input) => this.transport.request("/connect/v1/oauth/token", {
+            body: {
+                client_id: input.clientId,
+                client_secret: input.clientSecret,
+                grant_type: input.grantType ?? "client_credentials",
+                scope: input.scope,
+            },
+            method: "POST",
+            unwrapData: false,
+        }),
+    };
+    // ── Operators (control plane) ────────────────────────────────────────
+    operators = {
+        list: () => this.transport.request("/connect/v1/operators"),
+        get: (operatorId) => this.transport.request(`/connect/v1/operators/${operatorId}`),
+        create: (input) => this.transport.request("/connect/v1/operators", {
+            body: input,
+            method: "POST",
+        }),
+        update: (operatorId, input) => this.transport.request(`/connect/v1/operators/${operatorId}`, {
+            body: input,
+            method: "PATCH",
+        }),
+        deactivate: (operatorId) => this.transport.request(`/connect/v1/operators/${operatorId}`, {
+            method: "DELETE",
+        }),
+        getUsage: (operatorId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/usage`, {
+            query: query,
+        }),
+        listSearchDocuments: (operatorId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/search-documents`, { query: query }),
+        listSearchProjectionChanges: (operatorId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/search-projection-changes`, {
+            query: query,
+            unwrapData: false,
+        }),
+    };
+    // ── Connector providers ──────────────────────────────────────────────
+    connectorProviders = {
+        list: () => this.transport.request("/connect/v1/connector-providers"),
+        update: (providerKey, input) => this.transport.request(`/connect/v1/connector-providers/${providerKey}`, { body: input, method: "PATCH" }),
+        listApplications: (providerKey) => this.transport.request(`/connect/v1/connector-providers/${providerKey}/applications`),
+        listRegistrations: (operatorId) => this.transport.request(`/connect/v1/operators/${operatorId}/provider-registrations`),
+        getRegistration: (operatorId, registrationId) => this.transport.request(`/connect/v1/operators/${operatorId}/provider-registrations/${registrationId}`),
+        upsertRegistration: (operatorId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/provider-registrations`, { body: input, method: "POST" }),
+        updateRegistration: (operatorId, registrationId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/provider-registrations/${registrationId}`, { body: input, method: "PATCH" }),
+        updateTuiSettings: (operatorId, registrationId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/provider-registrations/${registrationId}/tui-settings`, { body: input, method: "PATCH" }),
+        revalidateRegistration: (operatorId, registrationId) => this.transport.request(`/connect/v1/operators/${operatorId}/provider-registrations/${registrationId}/revalidate`, { method: "POST" }),
+    };
+    // ── Connections (control plane) ──────────────────────────────────────
+    connections = {
+        list: (operatorId) => this.transport.request(`/connect/v1/operators/${operatorId}/connections`),
+        get: (operatorId, connectionId) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}`),
+        create: (operatorId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/connections`, { body: input, method: "POST" }),
+        update: (operatorId, connectionId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}`, { body: input, method: "PATCH" }),
+        delete: (operatorId, connectionId) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}`, { method: "DELETE" }),
+        rotateWebhookSecret: (operatorId, connectionId) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}/webhook-secret/rotate`, { method: "POST" }),
+        listProjectionSyncs: (operatorId, connectionId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}/search-projection-syncs`, { query: query }),
+        triggerProjectionSync: (operatorId, connectionId) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}/search-projection-syncs`, { method: "POST" }),
+        listWebhookEvents: (operatorId, connectionId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}/webhook-events`, { query: query }),
+        listHealthEvents: (operatorId, connectionId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}/health-events`, { query: query }),
+        listRequestLogs: (operatorId, connectionId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/connections/${connectionId}/request-logs`, {
+            query: {
+                ...query,
+                from: query?.from instanceof Date ? query.from.toISOString() : query?.from,
+                to: query?.to instanceof Date ? query.to.toISOString() : query?.to,
+            },
+        }),
+    };
+    // ── Links ────────────────────────────────────────────────────────────
+    links = {
+        list: (operatorId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/links`, {
+            query: query,
+        }),
+        get: (operatorId, linkId) => this.transport.request(`/connect/v1/operators/${operatorId}/links/${linkId}`),
+        create: (operatorId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/links`, {
+            body: input,
+            method: "POST",
+        }),
+        update: (operatorId, linkId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/links/${linkId}`, { body: input, method: "PATCH" }),
+        updateCapability: (operatorId, linkId, capabilityId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/links/${linkId}/capabilities/${capabilityId}`, { body: input, method: "PATCH" }),
+    };
+    // ── OAuth clients ────────────────────────────────────────────────────
+    oauthClients = {
+        list: (operatorId) => this.transport.request(`/connect/v1/operators/${operatorId}/oauth-clients`),
+        create: (operatorId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/oauth-clients`, { body: input, method: "POST" }),
+        revoke: (operatorId, clientId) => this.transport.request(`/connect/v1/operators/${operatorId}/oauth-clients/${clientId}`, { method: "DELETE" }),
+    };
+    // ── Grants ───────────────────────────────────────────────────────────
+    grants = {
+        listForOperator: (operatorId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/grants`, {
+            query: query,
+        }),
+        create: (operatorId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/grants`, {
+            body: input,
+            method: "POST",
+        }),
+        update: (operatorId, grantId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/grants/${grantId}`, { body: input, method: "PATCH" }),
+        revoke: (operatorId, grantId) => this.transport.request(`/connect/v1/operators/${operatorId}/grants/${grantId}`, { method: "DELETE" }),
+        listReceived: (query) => this.transport.request("/connect/v1/grants/received", {
+            query: query,
+        }),
+        get: (grantId) => this.transport.request(`/connect/v1/grants/${grantId}`),
+    };
+    // ── Audit logs ───────────────────────────────────────────────────────
+    auditLogs = {
+        list: (query) => this.transport.request("/connect/v1/audit-logs", {
+            query: query,
+            unwrapData: false,
+        }),
+    };
+    // ── Invite tokens ────────────────────────────────────────────────────
+    inviteTokens = {
+        list: (operatorId) => this.transport.request(`/connect/v1/operators/${operatorId}/invite-tokens`),
+        create: (operatorId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/invite-tokens`, {
+            body: {
+                ...input,
+                expiresAt: input.expiresAt instanceof Date
+                    ? input.expiresAt.toISOString()
+                    : input.expiresAt,
+            },
+            method: "POST",
+        }),
+        revoke: (operatorId, inviteId) => this.transport.request(`/connect/v1/operators/${operatorId}/invite-tokens/${inviteId}`, { method: "DELETE" }),
+        lookup: (token) => this.transport.request(`/connect/v1/invites/${token}`),
+        redeem: (token) => this.transport.request(`/connect/v1/invites/${token}/redeem`, {
+            method: "POST",
+        }),
+    };
+    // ── Webhook subscriptions ────────────────────────────────────────────
+    webhookSubscriptions = {
+        list: (operatorId) => this.transport.request(`/connect/v1/operators/${operatorId}/webhook-subscriptions`),
+        create: (operatorId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/webhook-subscriptions`, { body: input, method: "POST" }),
+        update: (operatorId, subscriptionId, input) => this.transport.request(`/connect/v1/operators/${operatorId}/webhook-subscriptions/${subscriptionId}`, { body: input, method: "PATCH" }),
+        delete: (operatorId, subscriptionId) => this.transport.request(`/connect/v1/operators/${operatorId}/webhook-subscriptions/${subscriptionId}`, { method: "DELETE" }),
+        listDeliveries: (operatorId, subscriptionId, query) => this.transport.request(`/connect/v1/operators/${operatorId}/webhook-subscriptions/${subscriptionId}/deliveries`, { query: query }),
+        sendTestEvent: (operatorId, subscriptionId) => this.transport.request(`/connect/v1/operators/${operatorId}/webhook-subscriptions/${subscriptionId}/test`, { method: "POST" }),
+        replayDelivery: (operatorId, subscriptionId, deliveryId) => this.transport.request(`/connect/v1/operators/${operatorId}/webhook-subscriptions/${subscriptionId}/deliveries/${deliveryId}/replay`, { method: "POST" }),
+    };
+    // ── Custom connection requests ───────────────────────────────────────
+    customConnectionRequests = {
+        list: (organizationId) => this.transport.request(`/connect/v1/organizations/${organizationId}/custom-connection-requests`),
+        create: (organizationId, input) => this.transport.request(`/connect/v1/organizations/${organizationId}/custom-connection-requests`, { body: input, method: "POST" }),
+    };
+    // ── Products ─────────────────────────────────────────────────────────
+    products = {
+        /**
+         * List products across all connections in the operator's catalog.
+         * Optionally filter by `connectionId` and/or `providerKey` (single value
+         * or array). Falls back to the client's default `operatorId` when omitted.
+         */
+        list: async (filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            return this.transport.request(`/connect/v1/operators/${operatorId}/products`, { query: scopeQuery(filter) });
+        },
+        /** Look up a single product in the operator's catalog. */
+        get: async (productId, scope) => {
+            const operatorId = this.resolveOperatorId(scope);
+            return this.transport.request(`/connect/v1/operators/${operatorId}/products/${productId}`);
+        },
+        /** Per-connection list (Connect-normalized). Optional `supplierId` filter. */
+        listOnConnection: (connectionId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/products`, {
+            query: options?.supplierId ? { supplierId: options.supplierId } : undefined,
+            unwrapData: false,
+        }),
+        /** Per-connection product lookup (Connect-normalized). */
+        getOnConnection: (connectionId, productId) => this.transport.request(`/connect/v1/connections/${connectionId}/products/${productId}`, { unwrapData: false }),
+        /** List options for a product on a connection. */
+        listOptions: (connectionId, productId) => this.transport.request(`/connect/v1/connections/${connectionId}/products/${productId}/options`, { unwrapData: false }),
+        /** List extras (add-ons) for a product on a connection. */
+        listExtras: (connectionId, productId) => this.transport.request(`/connect/v1/connections/${connectionId}/products/${productId}/extras`, { unwrapData: false }),
+    };
+    // ── Options ──────────────────────────────────────────────────────────
+    options = {
+        /** List units (pricing/capacity buckets) for an option. */
+        listUnits: (connectionId, optionId) => this.transport.request(`/connect/v1/connections/${connectionId}/options/${optionId}/units`, { unwrapData: false }),
+        /** List per-option extras configuration. */
+        listExtraConfigs: (connectionId, optionId) => this.transport.request(`/connect/v1/connections/${connectionId}/options/${optionId}/extra-configs`, { unwrapData: false }),
+    };
+    // ── Suppliers ────────────────────────────────────────────────────────
+    suppliers = {
+        /**
+         * List suppliers across all connections in the operator's catalog.
+         * Optionally filter by `connectionId` and/or `providerKey`.
+         */
+        list: async (filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            return this.transport.request(`/connect/v1/operators/${operatorId}/suppliers`, { query: scopeQuery(filter) });
+        },
+        /** Per-connection list (Connect-normalized). */
+        listOnConnection: (connectionId) => this.transport.request(`/connect/v1/connections/${connectionId}/suppliers`, { unwrapData: false }),
+    };
+    // ── Availability ─────────────────────────────────────────────────────
+    availability = {
+        /** Per-connection availability slots (Connect-normalized). */
+        list: (connectionId, query) => this.transport.request(`/connect/v1/connections/${connectionId}/availability`, {
+            query: query,
+            unwrapData: false,
+        }),
+        /** Per-connection calendar query (Connect-normalized). */
+        calendar: (connectionId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/availability/calendar`, { body: input, method: "POST", unwrapData: false }),
+    };
+    // ── Bookings ─────────────────────────────────────────────────────────
+    bookings = {
+        /**
+         * List bookings across all connections in the operator's catalog.
+         * Filter by `connectionId`, `providerKey`, status, and/or date range.
+         */
+        listAll: async (filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            const query = {};
+            if (filter?.connectionId !== undefined)
+                query.connectionId = filter.connectionId;
+            if (filter?.providerKey !== undefined)
+                query.providerKey = filter.providerKey;
+            if (filter?.status !== undefined)
+                query.status = filter.status;
+            if (filter?.localDateStart !== undefined)
+                query.localDateStart = filter.localDateStart;
+            if (filter?.localDateEnd !== undefined)
+                query.localDateEnd = filter.localDateEnd;
+            if (filter?.limit !== undefined)
+                query.limit = filter.limit;
+            return this.transport.request(`/connect/v1/operators/${operatorId}/bookings`, { query });
+        },
+        /** Per-connection booking list (Connect-normalized). */
+        list: (connectionId, query) => this.transport.request(`/connect/v1/connections/${connectionId}/bookings`, {
+            query: query,
+            unwrapData: false,
+        }),
+        get: (connectionId, bookingId) => this.transport.request(`/connect/v1/connections/${connectionId}/bookings/${bookingId}`, { unwrapData: false }),
+        create: (connectionId, input, options) => this.transport.request(`/connect/v1/connections/${connectionId}/bookings`, {
+            body: input,
+            headers: withIdempotency(options?.idempotencyKey),
+            method: "POST",
+            unwrapData: false,
+        }),
+        confirm: (connectionId, bookingId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/bookings/${bookingId}/confirm`, { body: input ?? {}, method: "POST", unwrapData: false }),
+        cancel: (connectionId, bookingId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/bookings/${bookingId}`, { body: input ?? {}, method: "DELETE", unwrapData: false }),
+        /** Booking activity log (Connect-normalized). */
+        listActivities: (connectionId, bookingId, query) => this.transport.request(`/connect/v1/connections/${connectionId}/bookings/${bookingId}/activities`, {
+            query: {
+                from: query?.from instanceof Date ? query.from.toISOString() : query?.from,
+                to: query?.to instanceof Date ? query.to.toISOString() : query?.to,
+                type: query?.type,
+                limit: query?.limit,
+            },
+            unwrapData: false,
+        }),
+    };
+    // ── Health ───────────────────────────────────────────────────────────
+    health = {
+        /** Per-connection sync health. */
+        get: (connectionId) => this.transport.request(`/connect/v1/connections/${connectionId}/health`, { unwrapData: false }),
+    };
+    // ── Accommodations (hospitality data plane) ──────────────────────────
+    accommodations = {
+        /**
+         * List accommodations across all connections in the operator's catalog.
+         * Filter by `connectionId`, `providerKey`, `category`, `countryCode`,
+         * `city`, `minStars`, `locale`. Falls back to client.operatorId.
+         */
+        list: async (filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            const query = {};
+            if (filter?.connectionId !== undefined)
+                query.connectionId = filter.connectionId;
+            if (filter?.providerKey !== undefined)
+                query.providerKey = filter.providerKey;
+            if (filter?.category !== undefined)
+                query.category = filter.category;
+            if (filter?.countryCode !== undefined)
+                query.countryCode = filter.countryCode;
+            if (filter?.city !== undefined)
+                query.city = filter.city;
+            if (filter?.minStars !== undefined)
+                query.minStars = filter.minStars;
+            if (filter?.maxPriceFromAmountMinor !== undefined)
+                query.maxPriceFromAmountMinor = filter.maxPriceFromAmountMinor;
+            if (filter?.locale !== undefined)
+                query.locale = filter.locale;
+            if (filter?.limit !== undefined)
+                query.limit = filter.limit;
+            return this.transport.request(`/connect/v1/operators/${operatorId}/accommodations`, { query });
+        },
+        /** Look up an accommodation in the operator's catalog. */
+        get: async (accommodationId, scope) => {
+            const operatorId = this.resolveOperatorId(scope);
+            return this.transport.request(`/connect/v1/operators/${operatorId}/accommodations/${accommodationId}`, {
+                query: scope?.locale ? { locale: scope.locale } : undefined,
+            });
+        },
+        /** Per-connection list (Connect-normalized). */
+        listOnConnection: (connectionId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/accommodations`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /** Per-connection accommodation lookup. */
+        getOnConnection: (connectionId, accommodationId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/accommodations/${accommodationId}`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /** List room types for an accommodation on a connection. */
+        listRoomTypes: (connectionId, accommodationExternalId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/accommodations/${accommodationExternalId}/room-types`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /** List rate plans for an accommodation, optionally filtered by room type. */
+        listRatePlans: (connectionId, accommodationExternalId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/accommodations/${accommodationExternalId}/rate-plans`, {
+            query: options,
+            unwrapData: false,
+        }),
+    };
+    // ── Stays (search + booking lifecycle) ───────────────────────────────
+    stays = {
+        /** Per-connection search; delegates to the adapter. Returns offers + diagnostics. */
+        search: (connectionId, query) => this.transport.request(`/connect/v1/connections/${connectionId}/stays/search`, { body: query, method: "POST", unwrapData: false }),
+        /**
+         * Cross-connection search. Fans out across the operator's accessible
+         * connections in parallel, merges offers, returns a unified response with
+         * `connectionDiagnostics` per connection.
+         */
+        searchAcrossProviders: async (query, filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            const body = { ...query };
+            if (filter && (filter.connectionId !== undefined || filter.providerKey !== undefined)) {
+                body.filter = {
+                    connectionId: filter.connectionId,
+                    providerKey: filter.providerKey,
+                };
+            }
+            return this.transport.request(`/connect/v1/operators/${operatorId}/stays/search`, { body, method: "POST", unwrapData: false });
+        },
+        /**
+         * Lock an offer. Pass the StayOffer returned from search; Connect creates a
+         * server-side hold whose TTL caps any provider-native lock that exists.
+         */
+        lock: (connectionId, offer, options) => this.transport.request(`/connect/v1/connections/${connectionId}/stays/lock`, {
+            body: { offerId: offer.id, offer, ttlMinutes: options?.ttlMinutes },
+            method: "POST",
+            unwrapData: false,
+        }),
+        releaseLock: (connectionId, holdId) => this.transport.request(`/connect/v1/connections/${connectionId}/stays/holds/${holdId}`, { method: "DELETE", unwrapData: false }),
+        getHold: (connectionId, holdId) => this.transport.request(`/connect/v1/connections/${connectionId}/stays/holds/${holdId}`, { unwrapData: false }),
+        /**
+         * Confirm a held offer into a booking. `idempotencyKey` becomes
+         * `Idempotency-Key` and is enforced server-side against the hold.
+         */
+        confirm: (connectionId, input, options) => this.transport.request(`/connect/v1/connections/${connectionId}/stays/bookings`, {
+            body: input,
+            headers: withIdempotency(options?.idempotencyKey),
+            method: "POST",
+            unwrapData: false,
+        }),
+        cancel: (connectionId, bookingId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/stays/bookings/${bookingId}`, {
+            body: options?.reason ? { reason: options.reason } : {},
+            method: "DELETE",
+            unwrapData: false,
+        }),
+        get: (connectionId, bookingId) => this.transport.request(`/connect/v1/connections/${connectionId}/stays/bookings/${bookingId}`, { unwrapData: false }),
+        list: (connectionId, query) => this.transport.request(`/connect/v1/connections/${connectionId}/stays/bookings`, {
+            query: query,
+            unwrapData: false,
+        }),
+        /** Cross-connection booking list scoped to the operator. */
+        listAll: async (filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            const query = {};
+            if (filter?.connectionId !== undefined)
+                query.connectionId = filter.connectionId;
+            if (filter?.providerKey !== undefined)
+                query.providerKey = filter.providerKey;
+            if (filter?.status !== undefined)
+                query.status = filter.status;
+            if (filter?.checkInFrom !== undefined)
+                query.checkInFrom = filter.checkInFrom;
+            if (filter?.checkInTo !== undefined)
+                query.checkInTo = filter.checkInTo;
+            if (filter?.limit !== undefined)
+                query.limit = filter.limit;
+            return this.transport.request(`/connect/v1/operators/${operatorId}/stays/bookings`, { query });
+        },
+    };
+    // ── Cruises (cruise data plane — read API) ───────────────────────────
+    cruises = {
+        /**
+         * List cruises across all of the operator's accessible connections.
+         * Filter by `connectionId`, `providerKey`, `cruiseType`, line/ship,
+         * `minNights`/`maxNights`, `locale`. Falls back to client.operatorId.
+         */
+        list: async (filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            const query = {};
+            if (filter?.connectionId !== undefined)
+                query.connectionId = filter.connectionId;
+            if (filter?.providerKey !== undefined)
+                query.providerKey = filter.providerKey;
+            if (filter?.cruiseType !== undefined)
+                query.cruiseType = filter.cruiseType;
+            if (filter?.cruiseLineExternalId !== undefined)
+                query.cruiseLineExternalId = filter.cruiseLineExternalId;
+            if (filter?.shipExternalId !== undefined)
+                query.shipExternalId = filter.shipExternalId;
+            if (filter?.minNights !== undefined)
+                query.minNights = filter.minNights;
+            if (filter?.maxNights !== undefined)
+                query.maxNights = filter.maxNights;
+            if (filter?.locale !== undefined)
+                query.locale = filter.locale;
+            if (filter?.limit !== undefined)
+                query.limit = filter.limit;
+            return this.transport.request(`/connect/v1/operators/${operatorId}/cruises`, { query });
+        },
+        /** Look up a cruise by id in the operator's catalog. */
+        get: async (cruiseId, scope) => {
+            const operatorId = this.resolveOperatorId(scope);
+            return this.transport.request(`/connect/v1/operators/${operatorId}/cruises/${cruiseId}`, {
+                query: scope?.locale ? { locale: scope.locale } : undefined,
+            });
+        },
+        /** Per-connection list (Connect-normalized). */
+        listOnConnection: (connectionId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/cruises`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /** Per-connection cruise lookup. */
+        getOnConnection: (connectionId, cruiseId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/cruises/${cruiseId}`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /**
+         * Cross-connection sailings list — primary search axis is departure
+         * window. Filter by cruise/ship/sales status.
+         */
+        listSailings: async (filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            const query = {};
+            if (filter?.connectionId !== undefined)
+                query.connectionId = filter.connectionId;
+            if (filter?.providerKey !== undefined)
+                query.providerKey = filter.providerKey;
+            if (filter?.cruiseExternalId !== undefined)
+                query.cruiseExternalId = filter.cruiseExternalId;
+            if (filter?.shipExternalId !== undefined)
+                query.shipExternalId = filter.shipExternalId;
+            if (filter?.salesStatus !== undefined)
+                query.salesStatus = filter.salesStatus;
+            if (filter?.departureFrom !== undefined)
+                query.departureFrom = filter.departureFrom;
+            if (filter?.departureTo !== undefined)
+                query.departureTo = filter.departureTo;
+            if (filter?.limit !== undefined)
+                query.limit = filter.limit;
+            return this.transport.request(`/connect/v1/operators/${operatorId}/sailings`, { query });
+        },
+        /** Look up a sailing by id in the operator's catalog. */
+        getSailing: async (sailingId, scope) => {
+            const operatorId = this.resolveOperatorId(scope);
+            return this.transport.request(`/connect/v1/operators/${operatorId}/sailings/${sailingId}`);
+        },
+        /** Per-connection sailings list. */
+        listSailingsOnConnection: (connectionId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/sailings`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /** Per-connection sailing lookup. */
+        getSailingOnConnection: (connectionId, sailingId) => this.transport.request(`/connect/v1/connections/${connectionId}/sailings/${sailingId}`, { unwrapData: false }),
+        /** Itinerary days for a sailing on a connection (port calls + sea days). */
+        listItinerary: (connectionId, sailingExternalId) => this.transport.request(`/connect/v1/connections/${connectionId}/sailings/${sailingExternalId}/itinerary`, { unwrapData: false }),
+        /** Cabin pricing grid for a sailing on a connection. */
+        listSailingPricing: (connectionId, sailingExternalId, query) => this.transport.request(`/connect/v1/connections/${connectionId}/sailings/${sailingExternalId}/pricing`, {
+            query: query,
+            unwrapData: false,
+        }),
+        /** Cruise lines available on a connection. */
+        listCruiseLines: (connectionId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/cruise-lines`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /** Ships on a connection — optionally filter by cruise line. */
+        listShips: (connectionId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/ships`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /** Per-connection ship lookup. */
+        getShip: (connectionId, shipId) => this.transport.request(`/connect/v1/connections/${connectionId}/ships/${shipId}`, { unwrapData: false }),
+        /** Cabin categories for a ship on a connection. */
+        listCabinCategories: (connectionId, shipExternalId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/ships/${shipExternalId}/cabin-categories`, {
+            query: options,
+            unwrapData: false,
+        }),
+        /** Per-connection cruise search; reads the local cache. */
+        search: (connectionId, query) => this.transport.request(`/connect/v1/connections/${connectionId}/cruises/search`, { body: query, method: "POST", unwrapData: false }),
+        /**
+         * Cross-connection cruise search. Fans out across the operator's
+         * accessible connections, merges offers, returns a unified response with
+         * `connectionDiagnostics` per connection.
+         */
+        searchAcrossProviders: async (query, filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            const body = { ...query };
+            if (filter && (filter.connectionId !== undefined || filter.providerKey !== undefined)) {
+                body.filter = {
+                    connectionId: filter.connectionId,
+                    providerKey: filter.providerKey,
+                };
+            }
+            return this.transport.request(`/connect/v1/operators/${operatorId}/cruises/search`, { body, method: "POST", unwrapData: false });
+        },
+    };
+    // ── Cruise bookings (lock + confirm + lifecycle) ─────────────────────
+    cruiseBookings = {
+        /**
+         * Inquiry-mode booking: creates a sales lead, no provider hold. The
+         * reseller follows up out-of-band. Returns the booking with status
+         * `inquiry`.
+         */
+        inquire: (connectionId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/cruise-bookings/inquiries`, { body: input, method: "POST", unwrapData: false }),
+        /**
+         * Lock a cruise offer (reserve mode). Connect creates a server-side
+         * quote with a 24h default TTL; if the adapter has a native option API
+         * (e.g. Viking), Connect calls it under the hood.
+         */
+        lock: (connectionId, offer, options) => this.transport.request(`/connect/v1/connections/${connectionId}/cruises/lock`, {
+            body: { offer, ttlHours: options?.ttlHours },
+            method: "POST",
+            unwrapData: false,
+        }),
+        /**
+         * Lock a concrete cruise selection. Connect resolves the current
+         * normalized pricing row server-side, builds the canonical offer snapshot,
+         * optionally calls the provider lock API, and returns the quote.
+         */
+        lockSelection: (connectionId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/cruises/lock-selection`, { body: input, method: "POST", unwrapData: false }),
+        releaseLock: (connectionId, quoteId) => this.transport.request(`/connect/v1/connections/${connectionId}/cruise-quotes/${quoteId}`, { method: "DELETE", unwrapData: false }),
+        getQuote: (connectionId, quoteId) => this.transport.request(`/connect/v1/connections/${connectionId}/cruise-quotes/${quoteId}`, { unwrapData: false }),
+        /**
+         * Confirm a held offer into a booking (reserve mode). `idempotencyKey`
+         * becomes `Idempotency-Key` and is enforced server-side against the
+         * quote.
+         */
+        confirm: (connectionId, input, options) => this.transport.request(`/connect/v1/connections/${connectionId}/cruise-bookings`, {
+            body: input,
+            headers: withIdempotency(options?.idempotencyKey),
+            method: "POST",
+            unwrapData: false,
+        }),
+        cancel: (connectionId, bookingId, options) => this.transport.request(`/connect/v1/connections/${connectionId}/cruise-bookings/${bookingId}/cancel`, {
+            body: options?.reason ? { reason: options.reason } : {},
+            method: "POST",
+            unwrapData: false,
+        }),
+        get: (connectionId, bookingId) => this.transport.request(`/connect/v1/connections/${connectionId}/cruise-bookings/${bookingId}`, { unwrapData: false }),
+        list: (connectionId, query) => this.transport.request(`/connect/v1/connections/${connectionId}/cruise-bookings`, {
+            query: query,
+            unwrapData: false,
+        }),
+        /** Cross-connection booking list scoped to the operator. */
+        listAll: async (filter) => {
+            const operatorId = this.resolveOperatorId(filter);
+            const query = {};
+            if (filter?.connectionId !== undefined)
+                query.connectionId = filter.connectionId;
+            if (filter?.providerKey !== undefined)
+                query.providerKey = filter.providerKey;
+            if (filter?.status !== undefined)
+                query.status = filter.status;
+            if (filter?.mode !== undefined)
+                query.mode = filter.mode;
+            if (filter?.departureFrom !== undefined)
+                query.departureFrom = filter.departureFrom;
+            if (filter?.departureTo !== undefined)
+                query.departureTo = filter.departureTo;
+            if (filter?.limit !== undefined)
+                query.limit = filter.limit;
+            return this.transport.request(`/connect/v1/operators/${operatorId}/cruise-bookings`, { query });
+        },
+    };
+    // ── Flights ──────────────────────────────────────────────────────────
+    flights = {
+        search: (input) => this.transport.request("/connect/v1/flights/search", {
+            body: input,
+            method: "POST",
+        }),
+        /**
+         * Server-Sent Events variant of multi-connection search. Returns the raw
+         * `Response` so callers can stream events with their preferred parser.
+         */
+        searchStream: (input, options) => this.transport.fetchRaw("/connect/v1/flights/search-stream", {
+            body: input,
+            headers: { accept: "text/event-stream" },
+            method: "POST",
+            signal: options?.signal,
+        }),
+        searchOnConnection: (connectionId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/search`, { body: input, method: "POST" }),
+        price: (connectionId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/price`, { body: input, method: "POST" }),
+        book: (connectionId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders`, { body: input, method: "POST" }),
+        getOrder: (connectionId, orderId) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}`),
+        cancelOrder: (connectionId, orderId) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}`, { method: "DELETE" }),
+        ticketOrder: (connectionId, orderId) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/ticket`, { method: "POST" }),
+        getSeatMap: (connectionId, orderId, segmentId) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/seats/${segmentId}`),
+        selectSeats: (connectionId, orderId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/seats`, { body: input, method: "POST" }),
+        getAncillaries: (connectionId, orderId) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/ancillaries`),
+        addAncillary: (connectionId, orderId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/ancillaries`, { body: input, method: "POST" }),
+        checkIn: (connectionId, orderId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/checkin`, { body: input, method: "POST" }),
+        exchange: (connectionId, orderId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/exchange`, { body: input, method: "POST" }),
+        refund: (connectionId, orderId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/refund`, { body: input, method: "POST" }),
+        voidOrder: (connectionId, orderId) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/void`, { method: "POST" }),
+        addServiceRequest: (connectionId, orderId, input) => this.transport.request(`/connect/v1/connections/${connectionId}/flights/orders/${orderId}/ssr`, { body: input, method: "POST" }),
+    };
+}
+export function createVoyantConnectClient(options) {
+    return new VoyantConnectClient(options);
+}