sabre-client 0.4.0 → 0.4.1

package/README.es.md

@@ -88,6 +88,11 @@ const sabre = new Sabre({
 | `fetch` | `fetch` global | `fetch` propio (proxies, tests, otros runtimes) |
 | `tokenStore` | solo en memoria | Comparte el token entre procesos (ver [Reutilizar el token](#reutilizar-el-token)) |
 
+> **`pcc` está deprecado** desde la `0.4.1` y se quita en la `0.5.0`. Era un campo reservado, y
+> ningún cliente lo lee. El PCC con el que te autenticas va en `credentials` (ver
+> [Credenciales](#credenciales) y `buildCredentials`). Para trabajar en otro PCC, pásalo en cada
+> operación: `targetPcc` en REST y `pcc` en las operaciones de colas.
+
 ### Credenciales
 
 Hay **un solo juego de credenciales** para REST y SOAP: el mismo objeto `credentials` sirve para
@@ -115,6 +120,12 @@ const sabre = new Sabre({ environment: 'sandbox', credentials });
 const legacy = new SabreLegacy({ environment: 'sandbox', credentials });
 ```
 
+El objeto que devuelve `buildCredentials` lleva su `authVersion`, así que la config no necesita
+repetirlo: con `authVersion: 'v2'` en `buildCredentials`, `{ environment, credentials }` ya es una
+config v2. Si también pasas `authVersion` en la config, tiene que coincidir; si no, el cliente lanza
+un `TypeError`. Las credenciales que armas a mano no llevan `authVersion`, así que con v2 la config
+sigue necesitando `authVersion: 'v2'`.
+
 El PCC de las credenciales es con el que te autenticas. Trabajar en otro PCC no requiere otro
 juego de credenciales: se pasa en cada operación, como `targetPcc` en `booking.create`, `get` y
 `cancel`, o como `pcc` en las operaciones de colas.

package/README.md

@@ -88,6 +88,11 @@ const sabre = new Sabre({
 | `fetch` | global `fetch` | Custom `fetch` (proxies, tests, other runtimes) |
 | `tokenStore` | in-memory only | Shares the token between processes (see [Token reuse](#token-reuse)) |
 
+> **`pcc` is deprecated** since `0.4.1` and will be removed in `0.5.0`. It was a reserved field,
+> and no client reads it. The PCC you authenticate with goes in `credentials` (see
+> [Credentials](#credentials) and `buildCredentials`). To work in another PCC, pass it per
+> operation: `targetPcc` in REST, `pcc` in the queue operations.
+
 ### Credentials
 
 There is **one set of credentials** for REST and SOAP: the same `credentials` object works for
@@ -115,6 +120,12 @@ const sabre = new Sabre({ environment: 'sandbox', credentials });
 const legacy = new SabreLegacy({ environment: 'sandbox', credentials });
 ```
 
+The object that `buildCredentials` returns carries its `authVersion`, so the config does not
+need to repeat it: with `authVersion: 'v2'` in `buildCredentials`, `{ environment, credentials }`
+is already a v2 config. If you pass `authVersion` in the config too, it must match, or the client
+throws a `TypeError`. Credentials you build by hand have no `authVersion`, so with v2 the config
+still needs `authVersion: 'v2'`.
+
 The PCC in the credentials is the one you authenticate with. Working in another PCC is not a
 second set of credentials: pass it per operation, as `targetPcc` in `booking.create`, `get` and
 `cancel`, or as `pcc` in the queue operations.

package/dist/index.d.ts

@@ -53,6 +53,11 @@ type SabreEnvironment = 'sandbox' | 'production';
 type SabreAuthVersion = 'v3' | 'v2';
 /** Credenciales para OAuth Token Create v3: Client ID/Secret más usuario EPR. */
 interface SabreCredentials {
+    /**
+     * Versión de OAuth para la que se armaron. `buildCredentials` la pone; la config la usa cuando
+     * no trae su propio `authVersion`.
+     */
+    authVersion?: 'v3';
     clientId: string;
     clientSecret: string;
     /** Usuario EPR. */
@@ -62,6 +67,11 @@ interface SabreCredentials {
 }
 /** Credenciales para OAuth Token Create v2: solo EPR; `clientId`/`clientSecret` se ignoran. */
 interface SabreCredentialsV2 {
+    /**
+     * Versión de OAuth para la que se armaron. `buildCredentials` la pone, y con ella la config no
+     * necesita repetir `authVersion: 'v2'`.
+     */
+    authVersion?: 'v2';
     clientId?: string;
     clientSecret?: string;
     /** Usuario EPR. */
@@ -71,7 +81,11 @@ interface SabreCredentialsV2 {
 }
 interface SabreBaseConfig {
     environment: SabreEnvironment;
-    /** Campo reservado: PCC vs iPCC sigue sin resolver. */
+    /**
+     * @deprecated Desde 0.4.1; se quita en 0.5.0. Ningún cliente lo lee. El PCC con el que te
+     * autenticas va en `credentials` (ver `buildCredentials`). Para trabajar en otro PCC, se pasa en
+     * cada operación: `targetPcc` en REST, `pcc` en colas.
+     */
     pcc?: string;
     logger?: SabreLogger;
     /** Reintentos por defecto del cliente; cada request puede pisarlos. */
@@ -94,8 +108,21 @@ interface SabreConfigV2 extends SabreBaseConfig {
     authVersion: 'v2';
     credentials: SabreCredentialsV2;
 }
-/** Config del cliente, discriminada por `authVersion`. */
-type SabreConfig = SabreConfigV3 | SabreConfigV2;
+/**
+ * OAuth Token Create v2 sin `authVersion` en la config: la versión sale de las credenciales,
+ * como las devuelve `buildCredentials({ authVersion: 'v2', … })`.
+ */
+interface SabreConfigV2FromCredentials extends SabreBaseConfig {
+    authVersion?: never;
+    credentials: SabreCredentialsV2 & {
+        authVersion: 'v2';
+    };
+}
+/**
+ * Config del cliente, discriminada por `authVersion`: el de la config o, si falta, el de
+ * `credentials`. Sin ninguno de los dos, es v3.
+ */
+type SabreConfig = SabreConfigV3 | SabreConfigV2 | SabreConfigV2FromCredentials;
 /** Config validada y con defaults aplicados. */
 interface ResolvedConfig {
     credentials: Readonly<SabreCredentials | SabreCredentialsV2>;
@@ -2030,15 +2057,27 @@ interface BuildCredentialsOptionsV2 extends BuildCredentialsBase {
     clientSecret?: string;
 }
 type BuildCredentialsOptions = BuildCredentialsOptionsV3 | BuildCredentialsOptionsV2;
+/** Lo que devuelve `buildCredentials` para v3: lleva `authVersion: 'v3'`. */
+type BuiltCredentialsV3 = SabreCredentials & {
+    authVersion: 'v3';
+};
+/**
+ * Lo que devuelve `buildCredentials` para v2: lleva `authVersion: 'v2'`, así que la config no
+ * necesita repetirlo (#148).
+ */
+type BuiltCredentialsV2 = SabreCredentialsV2 & {
+    authVersion: 'v2';
+};
 /**
  * Arma el `credentials` para `Sabre` y `SabreLegacy` a partir del usuario, el PCC, el domain y
  * la contraseña del EPR, más `clientId`/`clientSecret` cuando los hay. El username queda como
  * `<user>-<PCC>-<domain>` (v3) o `V1:<user>:<PCC>:<domain>` (v2). No lee variables de entorno
- * ni toca la red; un dato inválido lanza `TypeError` sin repetir secretos.
+ * ni toca la red; un dato inválido lanza `TypeError` sin repetir secretos. El resultado lleva
+ * `authVersion`, que la config usa si no trae el suyo.
  */
-declare function buildCredentials(options: BuildCredentialsOptionsV3): SabreCredentials;
-declare function buildCredentials(options: BuildCredentialsOptionsV2): SabreCredentialsV2;
-declare function buildCredentials(options: BuildCredentialsOptions): SabreCredentials | SabreCredentialsV2;
+declare function buildCredentials(options: BuildCredentialsOptionsV3): BuiltCredentialsV3;
+declare function buildCredentials(options: BuildCredentialsOptionsV2): BuiltCredentialsV2;
+declare function buildCredentials(options: BuildCredentialsOptions): BuiltCredentialsV3 | BuiltCredentialsV2;
 
 /**
  * Cómo se elige el año cuando el texto no lo trae:
@@ -2284,6 +2323,6 @@ interface BookingFlightDetailsSource {
  */
 declare function buildBookingFlightDetails(source: BookingFlightDetailsSource): FlightDetails;
 
-declare const VERSION = "0.4.0";
+declare const VERSION = "0.4.1";
 
-export { Air, type BaggageAllowanceDesc, type BaggageInformation, type BargainFinderMaxRequest, type BargainFinderMaxResponse, type BookContactInformation, type BookGenericSeat, type BookSeat, type BookTraveler, type Booking, type BookingAgency, type BookingFlightDetailsSource, type BookingItemReference, BookingManagement, type BookingResponseError, type BookingSeatSelection, type BookingSource, type BrandedFare, type BuildCredentialsOptions, type BuildCredentialsOptionsV2, type BuildCredentialsOptionsV3, type CancelBookingErrorPolicy, type CancelBookingNotification, type CancelBookingOptions, type CancelBookingRequest, type CancelBookingResponse, type CancelSegmentReference, type CreateBookingErrorPolicy, type CreateBookingOptions, type CreateBookingRequest, type CreateBookingResponse, type CreateBookingResponseError, type CurrencyConversion, type Fare, type FareComponent, type FareComponentDesc, type FareComponentDescSegment, type FareComponentSegment, type FareComponentSegmentDetail, type FareMessage, type FlightDetails, type FlightStatusCode, type FlightTicketOperation, type FlightToBook, type GetBookingExtraFeatures, type GetBookingOptions, type GetBookingRequest, type GetBookingResponse, type GetBookingReturnOnly, type GetSeatsRequest, type GetSeatsResponse, type GroupedItineraryResponse, type HostDateDirection, type Itinerary, type ItineraryGroup, type ItineraryMessage, type Leg, type LegDesc, type LegDescription, type LegSchedule, type LegScheduleRef, type LowFareSearchFlight, type LowFareSearchLocation, type LowFareSearchOriginDestination, type LowFareSearchPassengerTypeQuantity, type LowFareSearchRequestorId, type LowFareSearchSource, type LowFareSearchTpaExtensions, type LowFareSearchTravelPreferences, type LowFareSearchTravelerInfoSummary, type ObFeeDesc, type OpenSessionOptions, type OtaAirLowFareSearchRq, type PassengerInfo, type PassengerPricing, type PassengerTotalFare, type PaymentMethod, type PriceComparison, type PriceComparisonType, type PricedSeat, type PricingDetails, type PricingInformation, type PricingQualifiers, type QueueAccessOptions, type QueueAccessRequest, type QueueCount, type QueueCountOptions, type QueueCountRequest, type QueueCountResponse, type QueueEndReason, type QueueItem, type QueueListEntry, type QueueListOptions, type QueueListRequest, type QueueListResponse, QueueManagement, type QueueNavigationOptions, type QueueParagraph, type QueueParagraphAirSegment, type QueueParagraphMessage, type QueueParagraphOptions, type QueueParagraphOtherSegment, type QueueParagraphPassenger, type QueueParagraphReceivedFrom, type QueueParagraphSegment, type QueueParagraphTicketing, type QueueParagraphTicketingEntry, type QueuePlaceOptions, type QueuePlaceRequest, type QueuePlaceResponse, type QueuePlaceResult, type QueuePlaceTarget, type QueuePlacement, type QueueProcessAction, type QueueProcessRequest, type QueueProcessResult, QueueRef, type QueueRemoveRequest, type QueueRemoveTarget, type QueueSelection, type QueueState, type QueueStep, type RawSeatAvailabilityRs, type Ref, type RefundDocumentsType, type RequestOptions, type ResolveHostDateOptions, type RetryOptions, type RevalidateItineraryRequest, type RevalidateItineraryRequestSource, type RevalidateItineraryResponse, Sabre, type SabreAuthVersion, SabreBusinessError, type SabreBusinessErrorOptions, type SabreCommandOptions, type SabreCommandResponse, type SabreConfig, type SabreConfigV2, type SabreConfigV3, type SabreCredentials, type SabreCredentialsV2, type SabreEnvironment, SabreError, type SabreErrorOptions, SabreGatewayError, type SabreGatewayErrorOptions, SabreLegacy, type SabreLogEvent, type SabreLogLevel, type SabreLogger, SabreOrchestrationError, type SabreOrchestrationErrorOptions, type SabreProtocol, type SabreRawResponse, type SabreRawResponseCallback, type SabreServiceErrorOptions, SabreSession, SabreSessionError, type SabreSessionErrorKind, type SabreSessionErrorOptions, type SabreTokenStore, SabreWarning, type ScheduleCarrier, type ScheduleDesc, type ScheduleEndpoint, type ScheduleEquipment, type Seat, type SeatAreaPreference, type SeatAvailabilityByPayloadRq, type SeatAvailabilityByPnrLocatorRq, type SeatAvailabilityIssue, type SeatAvailabilityRequestSource, type SeatAvailabilityResponse, type SeatCabinCompartment, type SeatCabinFacility, type SeatCabinLayout, type SeatCabinRowPosition, type SeatCharacteristic, type SeatDisplayOnlyItem, type SeatFareComponent, type SeatFareDetail, type SeatFareSegmentAssociation, type SeatFlightLeg, type SeatKeyValuePair, type SeatLoyaltyProgramAccount, type SeatMap, type SeatOfferItem, type SeatOfferItemDetails, type SeatPassenger, type SeatPassengerPayloadRq, type SeatPassengerRs, type SeatPriceBreakdown, type SeatPriceDefinition, type SeatRow, type SeatSegment, type SeatSegmentPayloadRq, type SeatSegmentRs, type SeatServiceDefinition, type SeatSpecialServiceRequest, type SeatTax, type SpecificFare, type StoredToken, type TaxDesc, type TaxSummaryDesc, type TicketingPolicy, type TotalFare, type TravelerPhone, type TravelerTitle, VERSION, type ValidatingCarrierDesc, buildBookingFlightDetails, buildCredentials, buildRevalidateItineraryRequest, buildSeatAvailabilityRequest, parseQueueParagraph, resolveHostDate };
+export { Air, type BaggageAllowanceDesc, type BaggageInformation, type BargainFinderMaxRequest, type BargainFinderMaxResponse, type BookContactInformation, type BookGenericSeat, type BookSeat, type BookTraveler, type Booking, type BookingAgency, type BookingFlightDetailsSource, type BookingItemReference, BookingManagement, type BookingResponseError, type BookingSeatSelection, type BookingSource, type BrandedFare, type BuildCredentialsOptions, type BuildCredentialsOptionsV2, type BuildCredentialsOptionsV3, type BuiltCredentialsV2, type BuiltCredentialsV3, type CancelBookingErrorPolicy, type CancelBookingNotification, type CancelBookingOptions, type CancelBookingRequest, type CancelBookingResponse, type CancelSegmentReference, type CreateBookingErrorPolicy, type CreateBookingOptions, type CreateBookingRequest, type CreateBookingResponse, type CreateBookingResponseError, type CurrencyConversion, type Fare, type FareComponent, type FareComponentDesc, type FareComponentDescSegment, type FareComponentSegment, type FareComponentSegmentDetail, type FareMessage, type FlightDetails, type FlightStatusCode, type FlightTicketOperation, type FlightToBook, type GetBookingExtraFeatures, type GetBookingOptions, type GetBookingRequest, type GetBookingResponse, type GetBookingReturnOnly, type GetSeatsRequest, type GetSeatsResponse, type GroupedItineraryResponse, type HostDateDirection, type Itinerary, type ItineraryGroup, type ItineraryMessage, type Leg, type LegDesc, type LegDescription, type LegSchedule, type LegScheduleRef, type LowFareSearchFlight, type LowFareSearchLocation, type LowFareSearchOriginDestination, type LowFareSearchPassengerTypeQuantity, type LowFareSearchRequestorId, type LowFareSearchSource, type LowFareSearchTpaExtensions, type LowFareSearchTravelPreferences, type LowFareSearchTravelerInfoSummary, type ObFeeDesc, type OpenSessionOptions, type OtaAirLowFareSearchRq, type PassengerInfo, type PassengerPricing, type PassengerTotalFare, type PaymentMethod, type PriceComparison, type PriceComparisonType, type PricedSeat, type PricingDetails, type PricingInformation, type PricingQualifiers, type QueueAccessOptions, type QueueAccessRequest, type QueueCount, type QueueCountOptions, type QueueCountRequest, type QueueCountResponse, type QueueEndReason, type QueueItem, type QueueListEntry, type QueueListOptions, type QueueListRequest, type QueueListResponse, QueueManagement, type QueueNavigationOptions, type QueueParagraph, type QueueParagraphAirSegment, type QueueParagraphMessage, type QueueParagraphOptions, type QueueParagraphOtherSegment, type QueueParagraphPassenger, type QueueParagraphReceivedFrom, type QueueParagraphSegment, type QueueParagraphTicketing, type QueueParagraphTicketingEntry, type QueuePlaceOptions, type QueuePlaceRequest, type QueuePlaceResponse, type QueuePlaceResult, type QueuePlaceTarget, type QueuePlacement, type QueueProcessAction, type QueueProcessRequest, type QueueProcessResult, QueueRef, type QueueRemoveRequest, type QueueRemoveTarget, type QueueSelection, type QueueState, type QueueStep, type RawSeatAvailabilityRs, type Ref, type RefundDocumentsType, type RequestOptions, type ResolveHostDateOptions, type RetryOptions, type RevalidateItineraryRequest, type RevalidateItineraryRequestSource, type RevalidateItineraryResponse, Sabre, type SabreAuthVersion, SabreBusinessError, type SabreBusinessErrorOptions, type SabreCommandOptions, type SabreCommandResponse, type SabreConfig, type SabreConfigV2, type SabreConfigV2FromCredentials, type SabreConfigV3, type SabreCredentials, type SabreCredentialsV2, type SabreEnvironment, SabreError, type SabreErrorOptions, SabreGatewayError, type SabreGatewayErrorOptions, SabreLegacy, type SabreLogEvent, type SabreLogLevel, type SabreLogger, SabreOrchestrationError, type SabreOrchestrationErrorOptions, type SabreProtocol, type SabreRawResponse, type SabreRawResponseCallback, type SabreServiceErrorOptions, SabreSession, SabreSessionError, type SabreSessionErrorKind, type SabreSessionErrorOptions, type SabreTokenStore, SabreWarning, type ScheduleCarrier, type ScheduleDesc, type ScheduleEndpoint, type ScheduleEquipment, type Seat, type SeatAreaPreference, type SeatAvailabilityByPayloadRq, type SeatAvailabilityByPnrLocatorRq, type SeatAvailabilityIssue, type SeatAvailabilityRequestSource, type SeatAvailabilityResponse, type SeatCabinCompartment, type SeatCabinFacility, type SeatCabinLayout, type SeatCabinRowPosition, type SeatCharacteristic, type SeatDisplayOnlyItem, type SeatFareComponent, type SeatFareDetail, type SeatFareSegmentAssociation, type SeatFlightLeg, type SeatKeyValuePair, type SeatLoyaltyProgramAccount, type SeatMap, type SeatOfferItem, type SeatOfferItemDetails, type SeatPassenger, type SeatPassengerPayloadRq, type SeatPassengerRs, type SeatPriceBreakdown, type SeatPriceDefinition, type SeatRow, type SeatSegment, type SeatSegmentPayloadRq, type SeatSegmentRs, type SeatServiceDefinition, type SeatSpecialServiceRequest, type SeatTax, type SpecificFare, type StoredToken, type TaxDesc, type TaxSummaryDesc, type TicketingPolicy, type TotalFare, type TravelerPhone, type TravelerTitle, VERSION, type ValidatingCarrierDesc, buildBookingFlightDetails, buildCredentials, buildRevalidateItineraryRequest, buildSeatAvailabilityRequest, parseQueueParagraph, resolveHostDate };

package/dist/index.js

@@ -1207,12 +1207,20 @@ function resolveConfig(config) {
   if (environment !== "sandbox" && environment !== "production") {
     fail(`environment debe ser 'sandbox' o 'production' (recibido: ${JSON.stringify(environment)})`);
   }
-  const authVersion = config.authVersion ?? "v3";
-  if (authVersion !== "v3" && authVersion !== "v2") {
-    fail(`authVersion debe ser 'v3' o 'v2' (recibido: ${JSON.stringify(authVersion)})`);
+  const configVersion = config.authVersion ?? void 0;
+  if (configVersion !== void 0 && configVersion !== "v3" && configVersion !== "v2") {
+    fail(`authVersion debe ser 'v3' o 'v2' (recibido: ${JSON.stringify(configVersion)})`);
   }
   const { credentials } = config;
   if (!isObject3(credentials)) fail("credentials es requerido");
+  const credentialsVersion = credentials.authVersion ?? void 0;
+  if (credentialsVersion !== void 0 && credentialsVersion !== "v3" && credentialsVersion !== "v2") {
+    fail(`credentials.authVersion debe ser 'v3' o 'v2' (recibido: ${JSON.stringify(credentialsVersion)})`);
+  }
+  if (configVersion !== void 0 && credentialsVersion !== void 0 && configVersion !== credentialsVersion) {
+    fail(`authVersion '${configVersion}' no coincide con credentials.authVersion '${credentialsVersion}'`);
+  }
+  const authVersion = configVersion ?? credentialsVersion ?? "v3";
   requireString(credentials.username, "credentials.username");
   requireString(credentials.password, "credentials.password");
   if (authVersion === "v3") {
@@ -2975,7 +2983,8 @@ function buildCredentials(options) {
     requireString2(clientSecret, authVersion === "v3" ? "clientSecret (requerido con authVersion v3)" : "clientSecret");
   }
   const username = authVersion === "v3" ? `${user}-${pcc}-${domain}` : `V1:${user}:${pcc}:${domain}`;
-  return clientId === void 0 ? { username, password } : { clientId, clientSecret, username, password };
+  if (authVersion === "v3") return { authVersion, clientId, clientSecret, username, password };
+  return clientId === void 0 ? { authVersion, username, password } : { authVersion, clientId, clientSecret, username, password };
 }
 
 // src/queue/host-date.ts
@@ -3360,7 +3369,7 @@ function fareComponent(fareComponentId, component) {
 }
 
 // src/index.ts
-var VERSION = "0.4.0";
+var VERSION = "0.4.1";
 export {
   Sabre,
   SabreBusinessError,