sabre-client 0.5.0 → 0.6.0

package/dist/{reservation-history-bKDqkf8T.d.ts → reservation-history-C6giSdFd.d.ts}

@@ -647,10 +647,33 @@ interface RequestOptions {
 type QueueRef = number | string | {
     name: string;
 };
+/** La cola de mensajes del PCC: no tiene PNR y Sabre no la lista (`INVALID ENTRY`). */
+declare const MESSAGE_QUEUE = "S";
+/**
+ * Un rango de colas numéricas, de `start` a `end`, las dos incluidas: `{ start: 1, end: 25 }` es el
+ * `QC/<PCC>1-25` del host. Lo usan `count` y `activity`. A diferencia de pedir todo el PCC, Sabre
+ * devuelve cada cola del rango, también las vacías, con cuenta `0` (CERT y producción, #213).
+ *
+ * El design también acepta rangos de colas con nombre (`TEST1-TEST2`), pero ninguna prueba los vio:
+ * por ahora solo van números.
+ */
+interface QueueRange {
+    start: number;
+    end: number;
+}
+/** Si la cola es la de mensajes (`'S'`). */
+declare function isMessageQueue(queue: QueueRef): boolean;
 
 interface QueueActivityRequest {
     /** PCC cuyas colas se analizan. Por defecto, el de la sesión. */
     pcc?: string;
+    /** Analizar solo esta cola (`QA/<PCC><cola>`). No se combina con `range`. */
+    queue?: QueueRef;
+    /**
+     * Analizar un rango de colas (`QA/<PCC>1-25`). No se combina con `queue`. La respuesta trae cada
+     * cola del rango, también las que tienen todos los contadores en 0.
+     */
+    range?: QueueRange;
 }
 type QueueActivityOptions = RequestOptions;
 /**
@@ -682,9 +705,16 @@ interface QueueActivity extends QueueActivityCounters {
     queue: QueueRef;
 }
 interface QueueActivityResponse {
-    /** Las colas que trae la respuesta, en el orden de Sabre. */
+    /**
+     * Las colas que trae la respuesta, en el orden de Sabre. Sin filtros, Sabre omite las que tienen
+     * todos los contadores en 0; con `range`, trae todas las del rango, y con `queue`, solo esa
+     * (CERT y producción, #213).
+     */
     queues: QueueActivity[];
-    /** `Totals`: los ocho contadores sumados para el PCC. Sin `Totals`, `undefined`. */
+    /**
+     * `Totals`: los ocho contadores sumados para el PCC, o para el rango con `range`. Con `queue`,
+     * Sabre no manda `Totals` y queda en `undefined` (#213).
+     */
     totals?: QueueActivityCounters;
     /**
      * `QueueInfo@DateTime` tal cual llegó, sin año (`"11-06T11:33"`): la hora del host al analizar.
@@ -785,4 +815,4 @@ interface ReservationHistoryResponse {
     respondedAt?: string;
 }
 
-export { type ReservationHistoryText as $, type LowFareSearchLocation as A, type BargainFinderMaxRequest as B, type CurrencyConversion as C, type LowFareSearchOriginDestination as D, type LowFareSearchPassengerTypeQuantity as E, type Fare as F, type GroupedItineraryResponse as G, type LowFareSearchRequestorId as H, type ItineraryGroup as I, type LowFareSearchSource as J, type LowFareSearchTpaExtensions as K, type Leg as L, type LowFareSearchTravelPreferences as M, type LowFareSearchTravelerInfoSummary as N, type OtaAirLowFareSearchRq as O, type ObFeeDesc as P, type QueueRef as Q, type RetryOptions as R, SabreError as S, type PassengerInfo as T, type PassengerTotalFare as U, type PricingInformation as V, type QueueActivity as W, type QueueActivityCounters as X, type Ref as Y, type ReservationHistoryAccounting as Z, type ReservationHistoryFlightSegment as _, type SabreRawResponseCallback as a, type ReservationHistoryTransaction as a0, type SabreBusinessErrorOptions as a1, type SabreErrorOptions as a2, SabreGatewayError as a3, type SabreGatewayErrorOptions as a4, SabreOrchestrationError as a5, type SabreOrchestrationErrorOptions as a6, type SabreProtocol as a7, type SabreRawRequest as a8, type SabreRawResponse as a9, type SabreServiceErrorOptions as aa, SabreSessionError as ab, type SabreSessionErrorKind as ac, type SabreSessionErrorOptions as ad, type ScheduleCarrier as ae, type ScheduleDesc as af, type ScheduleEndpoint as ag, type ScheduleEquipment as ah, type TaxDesc as ai, type TaxSummaryDesc as aj, type TotalFare as ak, type ValidatingCarrierDesc as al, type SabreRawRequestCallback as b, SabreWarning as c, SabreBusinessError as d, type Itinerary as e, type RequestOptions as f, type BargainFinderMaxResponse as g, type QueueActivityRequest as h, type QueueActivityOptions as i, type QueueActivityResponse as j, type ReservationHistoryOptions as k, type ReservationHistoryResponse as l, type BaggageAllowanceDesc as m, type BaggageInformation as n, type FareComponent as o, type FareComponentDesc as p, type FareComponentDescSegment as q, type FareComponentSegment as r, type FareComponentSegmentDetail as s, type FareMessage as t, type ItineraryMessage as u, type LegDesc as v, type LegDescription as w, type LegSchedule as x, type LegScheduleRef as y, type LowFareSearchFlight as z };
+export { type PassengerTotalFare as $, type ItineraryMessage as A, type BargainFinderMaxRequest as B, type CurrencyConversion as C, type LegDesc as D, type LegDescription as E, type Fare as F, type GroupedItineraryResponse as G, type LegSchedule as H, type ItineraryGroup as I, type LegScheduleRef as J, type LowFareSearchFlight as K, type Leg as L, type LowFareSearchLocation as M, type LowFareSearchOriginDestination as N, type OtaAirLowFareSearchRq as O, type LowFareSearchPassengerTypeQuantity as P, type QueueRef as Q, type ReservationHistoryTransaction as R, SabreError as S, type LowFareSearchRequestorId as T, type LowFareSearchSource as U, type LowFareSearchTpaExtensions as V, type LowFareSearchTravelPreferences as W, type LowFareSearchTravelerInfoSummary as X, MESSAGE_QUEUE as Y, type ObFeeDesc as Z, type PassengerInfo as _, type QueueActivityCounters as a, type PricingInformation as a0, type QueueActivity as a1, type Ref as a2, type SabreBusinessErrorOptions as a3, type SabreErrorOptions as a4, SabreGatewayError as a5, type SabreGatewayErrorOptions as a6, SabreOrchestrationError as a7, type SabreOrchestrationErrorOptions as a8, type SabreProtocol as a9, type SabreRawRequest as aa, type SabreRawResponse as ab, type SabreServiceErrorOptions as ac, SabreSessionError as ad, type SabreSessionErrorKind as ae, type SabreSessionErrorOptions as af, type ScheduleCarrier as ag, type ScheduleDesc as ah, type ScheduleEndpoint as ai, type ScheduleEquipment as aj, type TaxDesc as ak, type TaxSummaryDesc as al, type TotalFare as am, type ValidatingCarrierDesc as an, isMessageQueue as ao, type ReservationHistoryFlightSegment as b, type ReservationHistoryText as c, type ReservationHistoryAccounting as d, type RetryOptions as e, type SabreRawResponseCallback as f, type SabreRawRequestCallback as g, SabreWarning as h, SabreBusinessError as i, type Itinerary as j, type RequestOptions as k, type BargainFinderMaxResponse as l, type QueueRange as m, type QueueActivityRequest as n, type QueueActivityOptions as o, type QueueActivityResponse as p, type ReservationHistoryOptions as q, type ReservationHistoryResponse as r, type BaggageAllowanceDesc as s, type BaggageInformation as t, type FareComponent as u, type FareComponentDesc as v, type FareComponentDescSegment as w, type FareComponentSegment as x, type FareComponentSegmentDetail as y, type FareMessage as z };

package/dist/testing.d.ts

@@ -1,4 +1,5 @@
-import { Q as QueueRef, X as QueueActivityCounters, a0 as ReservationHistoryTransaction, _ as ReservationHistoryFlightSegment, $ as ReservationHistoryText, Z as ReservationHistoryAccounting } from './reservation-history-bKDqkf8T.js';
+import { Q as QueueRef, a as QueueActivityCounters, R as ReservationHistoryTransaction, b as ReservationHistoryFlightSegment, c as ReservationHistoryText, d as ReservationHistoryAccounting } from './reservation-history-C6giSdFd.js';
+export { Anonymizer, AnonymizerLeak, AnonymizerOptions, createAnonymizer, isSafeHostLine } from './anonymize.js';
 
 /** Un PNR del fake, con los campos que Sabre manda en `Line`. */
 interface QueueFakePnr {
@@ -7,12 +8,14 @@ interface QueueFakePnr {
     /**
      * Las líneas del PNR en formato de host, como el `Paragraph` de Access Queue. Si no termina en
      * una línea de firma (`… HHMM/DDMMMYY <localizador> H`), el fake agrega una: `place` dentro de
-     * una cola saca el localizador de ahí, igual que con Sabre.
+     * una cola saca el localizador de ahí, igual que con Sabre. `selection` `AL` y `AC` filtran por
+     * los segmentos del párrafo, y `PI` por su aviso de PIC (`011  SEE REMARKS`), como los lee
+     * `parseQueueParagraph`.
      */
     paragraph?: readonly string[];
-    /** `Line/DateTime`, tal cual. */
+    /** `Line/DateTime`, tal cual. Es la fecha por la que filtra `selection` `QD`. */
     placedAt?: string;
-    /** `Line/POS/Source`. */
+    /** `Line/POS/Source`. `selection` `AK` filtra por el PCC más la firma (`'ABCDAAT'`). */
     placedBy?: {
         agentSine?: string;
         pseudoCityCode?: string;
@@ -95,60 +98,13 @@ interface QueueFake {
      */
     expireSessions(): void;
 }
-declare function createQueueFake(options?: QueueFakeOptions): QueueFake;
-
-/** Qué dato real quedó en un texto: lo que devuelve `Anonymizer.leaks`. */
-type AnonymizerLeak = 'secreto' | 'localizador' | 'nombre' | 'línea del PNR' | 'token';
-interface AnonymizerOptions {
-    /**
-     * Valores que nunca deben quedar: credenciales, usuario, PCC. Cada uno pasa a `XXXX` donde
-     * aparezca. Se ignoran los que no son string o tienen menos de 3 caracteres.
-     */
-    secrets?: ReadonlyArray<string | undefined>;
-}
-/**
- * Una anonimización con memoria: el mismo localizador da siempre el mismo alias y el mismo
- * pasajero el mismo nombre falso, en todos los textos que pasen por ella. Una por grabación.
- */
-interface Anonymizer {
-    /**
-     * Un sobre SOAP o cualquier texto con su XML (también un JSON con XML adentro):
-     * - cada `UniqueID@ID` pasa a un alias (`AAAAAA`, `AAAAAB`…), y el localizador real se reemplaza
-     *   por su alias en todo el texto;
-     * - `PassengerName` a `PASAJERO/UNO`, `PASAJERO/DOS`…, y `Group` a `GRUPO`;
-     * - `AgentSine` a `AAA` (salvo `SABRE`), `PseudoCityCode` a `XXXX` y `LNIATA` a `XXXXXX`;
-     * - cada `<Text>` pasa por `maskLine`;
-     * - los `secrets`, a `XXXX`.
-     */
-    anonymize(text: string): string;
-    /**
-     * Una línea del PNR en formato de host. Las de la lista blanca (`isSafeHostLine`) quedan tal
-     * cual; en las demás, letras a `X` y dígitos a `9`. La cabecera `QUEUE LIST FOR <PCC>` solo
-     * tapa el PCC, y `RECEIVED FROM - ` conserva el prefijo. La línea de firma
-     * (`… HHMM/DDMMMYY <localizador> H`) conserva su forma, y el localizador solo si ya es un alias:
-     * de ella sale el localizador del PNR siguiente en `place` dentro de una cola. Llamarla después
-     * de dar alias a los localizadores.
-     */
-    maskLine(line: string): string;
-    /** `maskLine` sobre cada línea de un párrafo, p. ej. `QueueItem.paragraph`. */
-    maskParagraph(lines: readonly string[]): string[];
-    /** El alias de un localizador: lo asigna la primera vez, en orden (`AAAAAA`, `AAAAAB`…). */
-    aliasOf(locator: string): string;
-    /**
-     * Qué datos reales siguen en `text`, sin repetir: un `secret`, un localizador o un nombre que ya
-     * tienen alias, una línea del PNR que se enmascaró, o un token de sesión. Vacío si no queda
-     * ninguno. Sirve para no escribir una fixture que todavía trae datos reales.
-     */
-    leaks(text: string): AnonymizerLeak[];
-}
 /**
- * Si una línea del PNR en formato de host queda tal cual al anonimizar: está en la lista blanca de
- * #96 (líneas vacías, avisos PIC como `011  SEE REMARKS`, títulos de sección como `REMARKS`, el fin
- * de cola).
+ * Las funciones de `selection` que simula el fake (#202). En `list`, Sabre acepta solo `QD` y `AK`
+ * (producción, #155); en `access` y `count`, cualquiera (#213), pero el fake simula solo estas.
+ * Las demás dan un error de host marcado como no simulado.
  */
-declare function isSafeHostLine(line: string): boolean;
-/** Ver `Anonymizer`. */
-declare function createAnonymizer(options?: AnonymizerOptions): Anonymizer;
+declare const QUEUE_FAKE_SELECTION_FUNCTIONS: readonly ["QD", "AK", "AL", "PI", "AC"];
+declare function createQueueFake(options?: QueueFakeOptions): QueueFake;
 
 /** Una respuesta grabada: la operación del SDK, el HTTP status y el sobre SOAP tal cual llegó. */
 interface RecordedResponse {
@@ -176,6 +132,9 @@ interface RecordedFixture {
  * - `place`: `place` fuera y dentro de una cola, y `remove` hasta el fin de cola;
  * - `placeWithoutInstructionCode` y `placeWithoutInstructionCodeInside`: `place` sin PIC, fuera
  *   (`INSTRUCTION NUMBER NOT IN RANGE`) y dentro de una cola (`NEED INSTRUCTION NUMBER`).
+ *
+ * El `list` de `walk` se grabó sin `primaryPassenger: true` (sin `/LN`), así que ningún `Line`
+ * trae `PassengerName` (#193).
  */
 declare const queueFixtures: Readonly<{
     walk: RecordedFixture;
@@ -193,6 +152,10 @@ declare const queueFixtures: Readonly<{
  * - `placedAt`, `placedBy` y `primaryPassenger` salen del `Line` de `list`. Si el PNR no está en la
  *   lista, salen del `Line` del primer `access`, `ignore` o `remove` que lo trae (ahí `placedAt` es
  *   la última modificación del PNR, no su colocación en la cola).
+ * - `primaryPassenger` solo sale si el `Line` trae `PassengerName`, y Sabre solo lo manda en un
+ *   `list` con `primaryPassenger: true` (`/LN`). Las fixtures de `queueFixtures` se grabaron sin
+ *   `/LN`, así que sus PNR van sin pasajero. Si el consumidor necesita uno, lo agrega con un
+ *   `map`; el helper no inventa datos que la grabación no tiene (#193).
  * - `paragraph` es el del primer `access`, `ignore`, `remove` o `place` que muestra el PNR, tal
  *   cual. El localizador del párrafo sale del `Line`, o de la línea de firma si no hay `Line`
  *   (`place` dentro de una cola).
@@ -211,4 +174,4 @@ declare const queueFixtures: Readonly<{
  */
 declare function queueFakePnrs(fixture: RecordedFixture): QueueFakePnr[];
 
-export { type Anonymizer, type AnonymizerLeak, type AnonymizerOptions, type QueueFake, type QueueFakeActivity, type QueueFakeCall, type QueueFakeCommand, type QueueFakeHistoryTransaction, type QueueFakeItem, type QueueFakeOptions, type QueueFakePnr, type RecordedFixture, type RecordedResponse, createAnonymizer, createQueueFake, isSafeHostLine, queueFakePnrs, queueFixtures };
+export { QUEUE_FAKE_SELECTION_FUNCTIONS, type QueueFake, type QueueFakeActivity, type QueueFakeCall, type QueueFakeCommand, type QueueFakeHistoryTransaction, type QueueFakeItem, type QueueFakeOptions, type QueueFakePnr, type RecordedFixture, type RecordedResponse, createQueueFake, queueFakePnrs, queueFixtures };