sabre-client 0.4.1 → 0.5.1

package/dist/testing.d.ts

@@ -1,4 +1,5 @@
-import { Q as QueueRef } from './queue-ref-BDGh8FrV.js';
+import { Q as QueueRef, a as QueueActivityCounters, R as ReservationHistoryTransaction, b as ReservationHistoryFlightSegment, c as ReservationHistoryText, d as ReservationHistoryAccounting } from './reservation-history-BKRFlxpA.js';
+export { Anonymizer, AnonymizerLeak, AnonymizerOptions, createAnonymizer, isSafeHostLine } from './anonymize.js';
 
 /** Un PNR del fake, con los campos que Sabre manda en `Line`. */
 interface QueueFakePnr {
@@ -20,32 +21,70 @@ interface QueueFakePnr {
     /** `Line/PassengerName`. Solo llega en `list` con `primaryPassenger: true`. */
     primaryPassenger?: string;
 }
+/**
+ * Los contadores de `queue.activity` que se siembran para una cola. `numMessages` no va: sale
+ * siempre de lo que hay en la cola del fake.
+ */
+type QueueFakeActivity = Partial<Omit<QueueActivityCounters, 'numMessages'>>;
+/**
+ * Una transacción del historial de un PNR, como la devuelve `reservation.history`. Las listas que
+ * falten van vacías.
+ */
+type QueueFakeHistoryTransaction = Omit<ReservationHistoryTransaction, 'flightSegments' | 'generalInfo' | 'remarks' | 'accounting'> & {
+    flightSegments?: readonly ReservationHistoryFlightSegment[];
+    generalInfo?: readonly ReservationHistoryText[];
+    remarks?: readonly ReservationHistoryText[];
+    accounting?: readonly ReservationHistoryAccounting[];
+};
 /** Un PNR: sus campos, o solo el párrafo. Con solo el párrafo, el localizador sale de la línea de firma. */
 type QueueFakeItem = QueueFakePnr | readonly string[];
 interface QueueFakeOptions {
     /**
-     * El contenido de cada cola, en orden. La clave es el número de cola (`'12'`, de 0 a 511) o el
-     * nombre de una cola alfabética (`'S'`). El fake no distingue PCC: las colas son las mismas para
-     * cualquier `pcc`.
+     * El contenido de cada cola, en orden. La clave es el número de cola (`'12'`, de 0 a 511), una
+     * cola alfabética (`'S'`, una o dos letras mayúsculas) o una cola con nombre (`'name:HOTELS'`, o
+     * `'HOTELS'` sin el prefijo). La alfabética y la con nombre viajan por atributos distintos
+     * (`Number` y `Name`, ADR-028). El fake no distingue PCC: las colas son las mismas para cualquier
+     * `pcc`.
+     *
+     * La `'S'` es la cola de mensajes: cada elemento es el texto de un mensaje (`string[]`), no un
+     * PNR. `access` lo muestra sin `Line`, como Sabre en CERT, e `ignore` lo deja en la cola. Que
+     * `remove` lo saque es un supuesto del fake: no se probó con Sabre.
      */
     queues?: Readonly<Record<string, readonly QueueFakeItem[]>>;
     /** PNR que no están en ninguna cola, para colocarlos con `place({ locators })`. */
     pnrs?: readonly QueueFakeItem[];
+    /**
+     * Los contadores de `queue.activity` por cola, con las mismas claves que `queues`. `numMessages`
+     * sale del estado del fake, como en `count`: sin el PNR en pantalla (CERT, #167). Los demás valen
+     * lo que se siembre aquí, o 0. Las acciones del fake (`ignore`, `remove`, `place`, `exit`) **no**
+     * los cambian: no se probó qué contador sube Sabre con cada una (Q-097).
+     */
+    activity?: Readonly<Record<string, QueueFakeActivity>>;
+    /**
+     * El historial de cada PNR para `reservation.history`, por localizador. Un PNR que el fake
+     * conoce y no está aquí devuelve una transacción sintética (la creación). Un localizador que
+     * el fake no conoce da un error de host marcado como no simulado.
+     */
+    histories?: Readonly<Record<string, readonly QueueFakeHistoryTransaction[]>>;
     /** Reloj de las fechas de `count` y de `place`. Por defecto, `new Date()`. Las fechas van en UTC. */
     now?: () => Date;
 }
 /** Qué le pidió el SDK al fake. */
-type QueueFakeCommand = 'open' | 'close' | 'ping' | 'count' | 'access' | 'list' | 'ignore' | 'remove' | 'exit' | 'place';
+type QueueFakeCommand = 'open' | 'close' | 'ping' | 'count' | 'access' | 'list' | 'ignore' | 'remove' | 'exit' | 'place' | 'activity' | 'history';
 interface QueueFakeCall {
     command: QueueFakeCommand;
     /** La cola de `access` y `list`. */
     queue?: QueueRef;
+    /** El localizador de `history`. */
+    locator?: string;
 }
 interface QueueFake {
     /** Se pasa como `config.fetch` de `SabreLegacy`. */
     readonly fetch: typeof fetch;
     /** Los localizadores de una cola, en orden, con lo que el recorrido haya sacado o colocado. */
     locators(queue: QueueRef): string[];
+    /** El texto de los mensajes que siguen en la cola `S`, en orden. */
+    messages(): string[][];
     /** Las llamadas recibidas, en orden. */
     readonly calls: readonly QueueFakeCall[];
     /** Cuántas sesiones siguen abiertas: sirve para comprobar que el consumidor las cierra. */
@@ -73,13 +112,21 @@ interface RecordedFixture {
     responses: readonly RecordedResponse[];
 }
 /**
- * Las corridas de producción del Tier 3:
+ * Las corridas de producción del Tier 3. Cada una usa sus propios alias de localizador, así que
+ * se pueden juntar en un fake con `queueFakePnrs` sin que choquen:
+ * - `walk`: `AAAAAA`–`AAAAAD`; `place`: `AAAAAE`–`AAAAAF`;
+ *   `placeWithoutInstructionCodeInside`: `AAAAAG`–`AAAAAH`.
+ *
+ * Qué trae cada una:
  * - `walk`: `count`, `list`, `access` y `ignore` sobre una cola de 4 PNR hasta el fin de cola,
  *   más `I` y `QXI` fuera de una cola;
  * - `emptyQueue`: `access` y `list` sobre una cola vacía (`QUEUE SELECTED WAS EMPTY`);
  * - `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;
@@ -89,4 +136,34 @@ declare const queueFixtures: Readonly<{
     placeWithoutInstructionCodeInside: RecordedFixture;
 }>;
 
-export { type QueueFake, type QueueFakeCall, type QueueFakeCommand, type QueueFakeItem, type QueueFakeOptions, type QueueFakePnr, type RecordedFixture, type RecordedResponse, createQueueFake, queueFixtures };
+/**
+ * Los PNR de una corrida grabada, listos para `createQueueFake`: primero los de `queue.list`, en
+ * su orden, y después los que aparecen en las demás respuestas de cola (`access`, `ignore`,
+ * `remove`, `place`), en el orden en que aparecen. Cada localizador sale una sola vez.
+ *
+ * - `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).
+ * - Un PNR que solo aparece como colocado (`place` fuera de una cola) va sin párrafo, y el fake le
+ *   agrega una línea de firma.
+ *
+ * La cola en la que van los decide quien lo usa:
+ *
+ * ```ts
+ * createQueueFake({ queues: { '9': queueFakePnrs(queueFixtures.walk) } })
+ * ```
+ *
+ * Las fixtures de `queueFixtures` usan alias distintos (`walk`: `AAAAAA`–`AAAAAD`, `place`:
+ * `AAAAAE`–`AAAAAF`, `placeWithoutInstructionCodeInside`: `AAAAAG`–`AAAAAH`), así que los PNR de
+ * varias se pueden juntar en un mismo fake.
+ */
+declare function queueFakePnrs(fixture: RecordedFixture): QueueFakePnr[];
+
+export { type QueueFake, type QueueFakeActivity, type QueueFakeCall, type QueueFakeCommand, type QueueFakeHistoryTransaction, type QueueFakeItem, type QueueFakeOptions, type QueueFakePnr, type RecordedFixture, type RecordedResponse, createQueueFake, queueFakePnrs, queueFixtures };