sabre-client 0.4.0 → 0.5.0

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { Q as QueueRef } from './queue-ref-BDGh8FrV.js';
+import { Q as QueueRef, X as QueueActivityCounters, a0 as ReservationHistoryTransaction, _ as ReservationHistoryFlightSegment, $ as ReservationHistoryText, Z as ReservationHistoryAccounting } from './reservation-history-bKDqkf8T.js';
 
 /** Un PNR del fake, con los campos que Sabre manda en `Line`. */
 interface QueueFakePnr {
@@ -20,32 +20,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. */
@@ -59,6 +97,59 @@ interface QueueFake {
 }
 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).
+ */
+declare function isSafeHostLine(line: string): boolean;
+/** Ver `Anonymizer`. */
+declare function createAnonymizer(options?: AnonymizerOptions): Anonymizer;
+
 /** Una respuesta grabada: la operación del SDK, el HTTP status y el sobre SOAP tal cual llegó. */
 interface RecordedResponse {
     /** `operation` de `onRawResponse` (`'openSession'`, `'queue.access'`…) o `probe.*` si el script la mandó crudo. */
@@ -73,7 +164,12 @@ 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`);
@@ -89,4 +185,30 @@ 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).
+ * - `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 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 };