sabre-client 0.4.0 → 0.5.0

package/dist/index.js

@@ -223,6 +223,22 @@ function isObject(value) {
   return typeof value === "object" && value !== null;
 }
 
+// src/http/raw-request.ts
+function rawRequestHeaders(headers) {
+  const copy = new Headers(headers);
+  copy.delete("Authorization");
+  return copy;
+}
+function rawHooks(options, operation) {
+  const { onRawResponse, onRawRequest } = options;
+  if (onRawResponse === void 0 && onRawRequest === void 0) return {};
+  return {
+    operation,
+    ...onRawResponse === void 0 ? {} : { onRawResponse },
+    ...onRawRequest === void 0 ? {} : { onRawRequest }
+  };
+}
+
 // src/air/bargain-finder-max.ts
 var BARGAIN_FINDER_MAX_SERVICE = "bargainFinderMax";
 var PATH = "/v5/offers/shop";
@@ -248,7 +264,7 @@ async function bargainFinderMax(transport, request, options = {}) {
     classify: classifyBargainFinderMax,
     ...options.retry === void 0 ? {} : { retry: options.retry },
     ...options.signal === void 0 ? {} : { signal: options.signal },
-    ...options.onRawResponse === void 0 ? {} : { operation: "air.bargainFinderMax", onRawResponse: options.onRawResponse }
+    ...rawHooks(options, "air.bargainFinderMax")
   });
   return denormalizeGroupedItineraryResponse(body.groupedItineraryResponse, BARGAIN_FINDER_MAX_SERVICE);
 }
@@ -327,7 +343,7 @@ async function send(transport, path, service, request, options) {
     classify: (raw) => classifyGetSeats(raw, service),
     ...options.retry === void 0 ? {} : { retry: options.retry },
     ...options.signal === void 0 ? {} : { signal: options.signal },
-    ...options.onRawResponse === void 0 ? {} : { operation: `air.${service}`, onRawResponse: options.onRawResponse }
+    ...rawHooks(options, `air.${service}`)
   });
   return {
     response: body.response,
@@ -418,7 +434,7 @@ async function revalidateItinerary(transport, request, options = {}) {
     classify: classifyRevalidateItinerary,
     ...options.retry === void 0 ? {} : { retry: options.retry },
     ...options.signal === void 0 ? {} : { signal: options.signal },
-    ...options.onRawResponse === void 0 ? {} : { operation: "air.revalidateItinerary", onRawResponse: options.onRawResponse }
+    ...rawHooks(options, "air.revalidateItinerary")
   });
   return denormalizeGroupedItineraryResponse(body.groupedItineraryResponse, REVALIDATE_ITINERARY_SERVICE);
 }
@@ -797,7 +813,7 @@ async function cancelBooking(transport, request, options = {}) {
     body: request,
     classify: classifyCancelBooking,
     ...options.signal === void 0 ? {} : { signal: options.signal },
-    ...options.onRawResponse === void 0 ? {} : { operation: "booking.cancel", onRawResponse: options.onRawResponse }
+    ...rawHooks(options, "booking.cancel")
   });
   return toCancelBookingResponse(body);
 }
@@ -974,7 +990,7 @@ async function createBooking(transport, request, options = {}) {
     body: request,
     classify: classifyCreateBooking,
     ...options.signal === void 0 ? {} : { signal: options.signal },
-    ...options.onRawResponse === void 0 ? {} : { operation: "booking.create", onRawResponse: options.onRawResponse }
+    ...rawHooks(options, "booking.create")
   });
   return toCreateBookingResponse(body);
 }
@@ -1066,7 +1082,7 @@ async function getBooking(transport, request, options = {}) {
     body: request,
     classify: classifyGetBooking,
     ...options.signal === void 0 ? {} : { signal: options.signal },
-    ...options.onRawResponse === void 0 ? {} : { operation: "booking.get", onRawResponse: options.onRawResponse }
+    ...rawHooks(options, "booking.get")
   });
   return toGetBookingResponse(body);
 }
@@ -1207,19 +1223,26 @@ 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") {
     requireString(credentials.clientId, "credentials.clientId (requerido con authVersion v3)");
     requireString(credentials.clientSecret, "credentials.clientSecret (requerido con authVersion v3)");
   }
-  if (config.pcc !== void 0) requireString(config.pcc, "pcc");
   const { logger } = config;
   if (logger !== void 0) {
     if (!isObject3(logger)) fail("logger debe ser un objeto con debug/info/warn/error");
@@ -1240,12 +1263,12 @@ function resolveConfig(config) {
   const fetchImpl = config.fetch ?? globalThis.fetch;
   if (typeof fetchImpl !== "function") fail("no hay fetch disponible: pasa config.fetch");
   return {
+    // Ya validado arriba: con v3 trae clientId/clientSecret; la marca de versión ya se resolvió.
     credentials: Object.freeze({ ...credentials }),
     environment,
     baseUrl: BASE_URLS[environment],
     soapBaseUrl: SOAP_BASE_URLS[environment],
     authVersion,
-    pcc: config.pcc,
     logger,
     retry: Object.freeze({ ...DEFAULT_RETRY, ...definedOnly(config.retry ?? {}) }),
     // Enlazado al global para evitar "Illegal invocation" en algunos runtimes.
@@ -1282,10 +1305,12 @@ var RestTransport = class {
   }
   async request(request) {
     if (request.retry !== void 0) validateRetryOptions(request.retry, "retry");
-    const capture = request.onRawResponse === void 0 ? void 0 : { attempts: 0 };
+    const wantsRequest = request.onRawRequest !== void 0 && request.auth !== false;
+    const capture = request.onRawResponse === void 0 && !wantsRequest ? void 0 : { attempts: 0 };
     try {
       return await this.#attempts(request, capture);
     } finally {
+      if (wantsRequest && capture?.request !== void 0) this.#deliverRawRequest(request, capture.request, capture.attempts);
       if (capture?.last !== void 0) this.#deliverRaw(request, { ...capture.last, attempts: capture.attempts });
     }
   }
@@ -1339,6 +1364,19 @@ var RestTransport = class {
       });
     }
   }
+  /** Igual que `#deliverRaw`: un callback que lanza no rompe la operación. */
+  #deliverRawRequest(request, raw, attempts) {
+    const operation = request.operation ?? request.service;
+    try {
+      request.onRawRequest?.({ operation, protocol: "rest", ...raw, attempts });
+    } catch (error) {
+      this.#log.emit("warn", "sabre.request.rawRequestHookFailed", {
+        service: request.service,
+        operation,
+        errorName: error instanceof Error ? error.name : typeof error
+      });
+    }
+  }
   async #authorizationFor(request) {
     if (request.auth === false || this.#authorization === void 0) return void 0;
     return this.#authorization.get();
@@ -1355,12 +1393,18 @@ var RestTransport = class {
     this.#log.emit("debug", "sabre.request.start", logContext);
     const startedAt = Date.now();
     let response;
-    if (capture !== void 0) capture.attempts++;
+    const body = request.body === void 0 ? void 0 : form ? String(request.body) : JSON.stringify(request.body);
+    if (capture !== void 0) {
+      capture.attempts++;
+      if (request.onRawRequest !== void 0 && request.auth !== false) {
+        capture.request = { method: request.method, url, headers: rawRequestHeaders(headers), body };
+      }
+    }
     try {
       response = await this.#config.fetch(url, {
         method: request.method,
         headers,
-        ...request.body === void 0 ? {} : { body: form ? String(request.body) : JSON.stringify(request.body) },
+        ...body === void 0 ? {} : { body },
         ...request.signal === void 0 ? {} : { signal: request.signal }
       });
     } catch (cause) {
@@ -1375,20 +1419,20 @@ var RestTransport = class {
     }
     const text = await response.text();
     if (capture !== void 0) capture.last = { status: response.status, headers: response.headers, body: text };
-    const body = parseBody(text);
+    const parsed = parseBody(text);
     const endContext = { ...logContext, status: response.status, durationMs: Date.now() - startedAt };
     if (!response.ok) {
-      const error = gatewayError(request.service, response.status, body);
+      const error = gatewayError(request.service, response.status, parsed);
       this.#log.emit("error", "sabre.request.end", { ...endContext, error });
       throw error;
     }
-    const serviceError = request.classify?.(body, response);
+    const serviceError = request.classify?.(parsed, response);
     if (serviceError !== void 0) {
       this.#log.emit("warn", "sabre.request.end", { ...endContext, error: serviceError });
       throw serviceError;
     }
     this.#log.emit("info", "sabre.request.end", endContext);
-    return body;
+    return parsed;
   }
   #url(request) {
     const path = request.path.startsWith("/") ? request.path : `/${request.path}`;
@@ -1491,6 +1535,7 @@ var TRANSIENT_CODES = /* @__PURE__ */ new Set([
 var PREVIOUS_ENTRY_ACTIVE_RETRIES = 3;
 var PREVIOUS_ENTRY_ACTIVE_DELAY_MS = 1e3;
 var PREVIOUS_ENTRY_ACTIVE = /PREVIOUS ENTRY ACTIVE/i;
+var SOAP_HEADERS = { "Content-Type": "text/xml; charset=utf-8", Accept: "text/xml" };
 var PARSER_OPTIONS = {
   ignoreAttributes: false,
   attributeNamePrefix: "@",
@@ -1526,6 +1571,7 @@ var SoapTransport = class {
     try {
       return await this.#attempts(request, capture);
     } finally {
+      if (capture.request !== void 0) this.#deliverRawRequest(request, capture.request, capture.attempts);
       if (capture.last !== void 0) this.#deliverRaw(request, { ...capture.last, attempts: capture.attempts });
     }
   }
@@ -1572,10 +1618,18 @@ var SoapTransport = class {
     const startedAt = Date.now();
     let response;
     capture.attempts++;
+    if (wantsRawRequest(request)) {
+      capture.request = {
+        method: "POST",
+        url: this.#config.soapBaseUrl,
+        headers: rawRequestHeaders(SOAP_HEADERS),
+        body: redactSoapEnvelope(scrubToken(envelope, request.security))
+      };
+    }
     try {
       response = await this.#config.fetch(this.#config.soapBaseUrl, {
         method: "POST",
-        headers: { "Content-Type": "text/xml; charset=utf-8", Accept: "text/xml" },
+        headers: SOAP_HEADERS,
         body: envelope,
         ...request.signal === void 0 ? {} : { signal: request.signal }
       });
@@ -1606,6 +1660,7 @@ var SoapTransport = class {
       return {
         ...result,
         messageId,
+        respondedAt: respondedAtOf(text),
         raw: text,
         securityToken: request.readSecurityToken === true ? readSecurityToken(original) : void 0,
         status: response.status
@@ -1648,12 +1703,12 @@ var SoapTransport = class {
       });
     }
     const results = asNode(payload.ApplicationResults);
-    const warnings = asArray(results?.Warning).map((node2) => {
-      const entry = resultEntry(node2);
+    const warnings = asArray(results?.Warning).map((node3) => {
+      const entry = resultEntry(node3);
       return new SabreWarning(`${service}: ${entry.description}`, { service, code: entry.code, raw: text });
     });
-    const errors = asArray(results?.Error).map((node2) => {
-      const entry = resultEntry(node2);
+    const errors = asArray(results?.Error).map((node3) => {
+      const entry = resultEntry(node3);
       return new SabreBusinessError(`${service}: ${entry.description}`, {
         service,
         code: entry.code,
@@ -1699,6 +1754,19 @@ var SoapTransport = class {
     ].join("");
   }
   /** Un callback que lanza no rompe la operación (mismo criterio que REST). */
+  #deliverRawRequest(request, raw, attempts) {
+    const operation = request.operation ?? request.service;
+    try {
+      request.onRawRequest?.({ operation, protocol: "soap", ...raw, attempts });
+    } catch (error) {
+      this.#log.emit("warn", "sabre.request.rawRequestHookFailed", {
+        service: request.service,
+        operation,
+        errorName: error instanceof Error ? error.name : typeof error
+      });
+    }
+  }
+  /** Un callback que lanza no rompe la operación (mismo criterio que REST). */
   #deliverRaw(request, raw) {
     if (request.onRawResponse === void 0) return;
     const operation = request.operation ?? request.service;
@@ -1713,6 +1781,18 @@ var SoapTransport = class {
     }
   }
 };
+function respondedAtOf(raw) {
+  if (typeof raw !== "string") return void 0;
+  const header = /<(?:[\w-]+:)?Header\b[\s\S]*?<\/(?:[\w-]+:)?Header>/.exec(raw)?.[0];
+  const value = header === void 0 ? void 0 : /<(?:[\w-]+:)?Timestamp>\s*([^<\s]+)\s*</.exec(header)?.[1];
+  const match = value === void 0 ? null : /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?)(Z|[+-]\d{2}:\d{2})?$/.exec(value);
+  if (match === null) return void 0;
+  return `${match[1]}${match[2] ?? "Z"}`;
+}
+function respondedAtField(raw) {
+  const respondedAt = respondedAtOf(raw);
+  return respondedAt === void 0 ? {} : { respondedAt };
+}
 function xmlEscape(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
@@ -1735,6 +1815,9 @@ function securityHeader(security) {
     "</wsse:Security>"
   ].join("");
 }
+function wantsRawRequest(request) {
+  return request.onRawRequest !== void 0 && "binarySecurityToken" in request.security;
+}
 function scrubToken(text, security) {
   if (!("binarySecurityToken" in security) || security.binarySecurityToken === "") return text;
   const token = security.binarySecurityToken;
@@ -1774,8 +1857,8 @@ function faultError(service, status, fault, text) {
     ...code === void 0 || code === "" ? {} : { code }
   });
 }
-function resultEntry(node2) {
-  const entry = asNode(node2) ?? {};
+function resultEntry(node3) {
+  const entry = asNode(node3) ?? {};
   const messages = [];
   const shortTexts = [];
   let code;
@@ -1813,8 +1896,8 @@ function untrimmedPayload(raw) {
   const document = parseEnvelope(raw, untrimmedParser);
   return document === void 0 ? void 0 : asNode(firstElement(document.Body)[1]);
 }
-function firstElement(node2) {
-  for (const [key, value] of Object.entries(node2)) {
+function firstElement(node3) {
+  for (const [key, value] of Object.entries(node3)) {
     if (!key.startsWith("@") && key !== "#text") return [key, Array.isArray(value) ? value[0] : value];
   }
   return [void 0, void 0];
@@ -1829,14 +1912,14 @@ function asArray(value) {
 }
 function textOf(value) {
   if (typeof value === "string") return value;
-  const node2 = asNode(value);
-  const text = node2?.["#text"];
-  return typeof text === "string" ? text : node2 === void 0 ? void 0 : "";
+  const node3 = asNode(value);
+  const text = node3?.["#text"];
+  return typeof text === "string" ? text : node3 === void 0 ? void 0 : "";
 }
 function stringAt(root2, ...path) {
-  let node2 = root2;
-  for (const key of path) node2 = asNode(node2)?.[key];
-  return nonEmpty2(textOf(node2));
+  let node3 = root2;
+  for (const key of path) node3 = asNode(node3)?.[key];
+  return nonEmpty2(textOf(node3));
 }
 function nonEmpty2(value) {
   return typeof value === "string" && value !== "" ? value : void 0;
@@ -1893,27 +1976,41 @@ import { XMLParser as XMLParser2 } from "fast-xml-parser";
 // src/queue/queue-ref.ts
 var MIN_QUEUE_NUMBER = 0;
 var MAX_QUEUE_NUMBER = 511;
+var MESSAGE_QUEUE = "S";
+var ALPHA_QUEUE = /^[A-Z]{1,2}$/;
+function fail3(message) {
+  throw new TypeError(`sabre-client: ${message}`);
+}
 function validateQueueRef(value, label) {
   if (typeof value === "number") {
     if (Number.isInteger(value) && value >= MIN_QUEUE_NUMBER && value <= MAX_QUEUE_NUMBER) return;
-    throw new TypeError(
-      `sabre-client: ${label} debe ser un n\xFAmero de cola entero de ${MIN_QUEUE_NUMBER} a ${MAX_QUEUE_NUMBER}, o { name }`
-    );
+    fail3(`${label} debe ser un n\xFAmero de cola entero de ${MIN_QUEUE_NUMBER} a ${MAX_QUEUE_NUMBER}, una cola alfab\xE9tica ('S') o { name }`);
+  }
+  if (typeof value === "string") {
+    if (ALPHA_QUEUE.test(value)) return;
+    if (/^\d+$/.test(value.trim())) fail3(`${label}: una cola num\xE9rica va como n\xFAmero (${Number(value)}), no como string`);
+    fail3(`${label} debe ser una cola alfab\xE9tica de una o dos letras may\xFAsculas (p. ej. 'S')`);
   }
   if (typeof value === "object" && value !== null && !Array.isArray(value)) {
     const { name } = value;
-    if (typeof name === "string" && name.trim() !== "") return;
-    throw new TypeError(`sabre-client: ${label}.name debe ser un string no vac\xEDo`);
+    if (typeof name !== "string" || name.trim() === "") fail3(`${label}.name debe ser un string no vac\xEDo`);
+    if (ALPHA_QUEUE.test(name)) fail3(`${label}: '${name}' es una cola alfab\xE9tica: pasa '${name}', no { name: '${name}' }`);
+    return;
   }
-  throw new TypeError(`sabre-client: ${label} debe ser un n\xFAmero de cola (0\u2013511) o { name }`);
+  fail3(`${label} debe ser un n\xFAmero de cola (0\u2013511), una cola alfab\xE9tica ('S') o { name }`);
 }
 function queueRefAttribute(queue) {
-  return typeof queue === "number" ? `Number="${queue}"` : `Name="${xmlEscape(queue.name)}"`;
+  if (typeof queue === "number") return `Number="${queue}"`;
+  if (typeof queue === "string") return `Number="${xmlEscape(queue)}"`;
+  return `Name="${xmlEscape(queue.name)}"`;
+}
+function isMessageQueue(queue) {
+  return queue === MESSAGE_QUEUE;
 }
 function toQueueRef(value) {
   const text = value?.trim();
   if (text === void 0 || text === "") return void 0;
-  return /^\d+$/.test(text) ? Number(text) : { name: text };
+  return /^\d+$/.test(text) ? Number(text) : text;
 }
 
 // src/queue/queue-access.ts
@@ -1931,9 +2028,11 @@ function root(body) {
 function identifier(queue, pcc) {
   return `<QueueIdentifier ${queueRefAttribute(queue)} PseudoCityCode="${xmlEscape(pcc)}"/>`;
 }
+function selectionXml(selection) {
+  return selection.map((filter) => `<Selection Function="${xmlEscape(filter.function)}" Criteria="${xmlEscape(filter.criteria)}"/>`).join("");
+}
 function queueAccessPayload(queue, pcc, selection = []) {
-  const filters = selection.map((filter) => `<Selection Function="${xmlEscape(filter.function)}" Criteria="${xmlEscape(filter.criteria)}"/>`).join("");
-  return root(`${identifier(queue, pcc)}${filters}`);
+  return root(`${identifier(queue, pcc)}${selectionXml(selection)}`);
 }
 function queueNavigationPayload(action, from = []) {
   return root(`<Navigation Action="${action}"/>${from.map((target) => identifier(target.queue, target.pcc)).join("")}`);
@@ -1999,17 +2098,21 @@ function queueEndError(error, service) {
 function isOffQueueError(error) {
   return error instanceof SabreBusinessError && [error, ...error.errors].some((result) => resultHasText(result, OFF_QUEUE));
 }
-function endStep(warnings, reason = "end-of-display") {
-  return { done: true, reason, message: reason === "empty" ? QUEUE_EMPTY : END_OF_DISPLAY, warnings };
+function endStep(warnings, reason = "end-of-display", raw) {
+  return { done: true, reason, message: reason === "empty" ? QUEUE_EMPTY : END_OF_DISPLAY, warnings, ...respondedAtField(raw) };
 }
-function parseQueueStep(response) {
+function parseQueueStep(response, { messages = false } = {}) {
   const { warnings } = response;
   const paragraph = paragraphLines(response.raw);
   const firstLine = paragraph.find((line) => line.trim() !== "");
-  if (isEndOfDisplay(firstLine) || warnings.some(isEndOfDisplayResult)) return endStep(warnings);
-  const fields = lineFields(response.payload.Line);
+  if (isEndOfDisplay(firstLine) || warnings.some(isEndOfDisplayResult)) return endStep(warnings, "end-of-display", response.raw);
+  if (messages && response.payload.Line === void 0 && firstLine !== void 0) {
+    return { done: false, kind: "message", message: { text: paragraph }, warnings, ...respondedAtField(response.raw) };
+  }
+  const fields = messages ? void 0 : lineFields(response.payload.Line);
   if (fields === void 0) {
-    throw new SabreGatewayError(`${QUEUE_ACCESS_SERVICE}: respuesta no reconocida (sin Line/UniqueID ni fin de cola)`, {
+    const expected = messages ? "sin Paragraph de mensaje ni fin de cola en la cola S" : "sin Line/UniqueID ni fin de cola";
+    throw new SabreGatewayError(`${QUEUE_ACCESS_SERVICE}: respuesta no reconocida (${expected})`, {
       protocol: "soap",
       status: response.status,
       retryable: false,
@@ -2017,7 +2120,7 @@ function parseQueueStep(response) {
     });
   }
   const item = { ...fields, paragraph };
-  return { done: false, item, warnings };
+  return { done: false, kind: "pnr", item, warnings, ...respondedAtField(response.raw) };
 }
 function lineFields(value) {
   const line = node(value);
@@ -2064,8 +2167,8 @@ function parseHostCount(value) {
   const match = /^[.\s]*(\d+)\s*$/.exec(value ?? "");
   return match === null ? void 0 : Number(match[1]);
 }
-function attribute2(node2, name) {
-  const value = node2?.[`@${name}`];
+function attribute2(node3, name) {
+  const value = node3?.[`@${name}`];
   return typeof value === "string" ? value : void 0;
 }
 function parseQueueCountResponse(response) {
@@ -2075,7 +2178,8 @@ function parseQueueCountResponse(response) {
     countedAt ??= nonEmpty3(attribute2(info, "DateTime"));
     for (const identifier2 of asArray(info.QueueIdentifier)) {
       const number = attribute2(identifier2, "Number");
-      const queue = toQueueRef(number);
+      const name = nonEmpty3(attribute2(identifier2, "Name"));
+      const queue = number === void 0 && name !== void 0 ? { name } : toQueueRef(number);
       const count = parseHostCount(attribute2(identifier2, "Count"));
       if (queue === void 0 || count === void 0) {
         throw malformed(`QueueIdentifier con Number="${number ?? ""}" y Count="${attribute2(identifier2, "Count") ?? ""}"`, response);
@@ -2091,7 +2195,13 @@ function parseQueueCountResponse(response) {
     if (count === void 0) throw malformed(`Totals ${key} con Count="${attribute2(total, "Count") ?? ""}"`, response);
     totals[key] = count;
   }
-  return { queues, totals, ...countedAt === void 0 ? {} : { countedAt }, warnings: response.warnings };
+  return {
+    queues,
+    totals,
+    ...countedAt === void 0 ? {} : { countedAt },
+    warnings: response.warnings,
+    ...respondedAtField(response.raw)
+  };
 }
 function malformed(detail, response) {
   return new SabreGatewayError(`${QUEUE_COUNT_SERVICE}: respuesta no reconocida (${detail})`, {
@@ -2108,9 +2218,10 @@ function nonEmpty3(value) {
 
 // src/queue/queue-list.ts
 var NAMESPACE3 = "http://webservices.sabre.com/sabreXML/2011/10";
-function queueListPayload(queue, pcc, primaryPassenger) {
+var LIST_SELECTION_FUNCTIONS = ["QD", "AK"];
+function queueListPayload(queue, pcc, primaryPassenger, selection = []) {
   const list = primaryPassenger ? '<List Ind="true" PrimaryPassenger="true"/>' : '<List Ind="true"/>';
-  return `<QueueAccessRQ Version="2.1.1" xmlns="${NAMESPACE3}"><QueueIdentifier ${queueRefAttribute(queue)} PseudoCityCode="${xmlEscape(pcc)}">${list}</QueueIdentifier></QueueAccessRQ>`;
+  return `<QueueAccessRQ Version="2.1.1" xmlns="${NAMESPACE3}"><QueueIdentifier ${queueRefAttribute(queue)} PseudoCityCode="${xmlEscape(pcc)}">${list}</QueueIdentifier>${selectionXml(selection)}</QueueAccessRQ>`;
 }
 function queueListRequest(payload, options) {
   return {
@@ -2122,14 +2233,14 @@ function queueListRequest(payload, options) {
     ...options
   };
 }
-function emptyList(warnings, paragraph = []) {
-  return { locators: [], entries: [], paragraph, warnings };
+function emptyList(warnings, paragraph = [], raw) {
+  return { locators: [], entries: [], paragraph, warnings, ...respondedAtField(raw) };
 }
 function parseQueueList(response) {
   const { warnings } = response;
   const paragraph = paragraphLines(response.raw);
   const firstLine = paragraph.find((line) => line.trim() !== "");
-  if (isEndOfDisplay(firstLine) || warnings.some(isEndOfDisplayResult)) return emptyList(warnings, paragraph);
+  if (isEndOfDisplay(firstLine) || warnings.some(isEndOfDisplayResult)) return emptyList(warnings, paragraph, response.raw);
   const entries = asArray(response.payload.Line).map((line) => {
     const fields = lineFields(line);
     if (fields === void 0) {
@@ -2144,12 +2255,88 @@ function parseQueueList(response) {
     const position = number !== void 0 && /^\d+$/.test(number) ? Number(number) : void 0;
     return { ...position === void 0 ? {} : { position }, ...fields };
   });
-  return { locators: entries.map((entry) => entry.locator), entries, paragraph, warnings };
+  return { locators: entries.map((entry) => entry.locator), entries, paragraph, warnings, ...respondedAtField(response.raw) };
+}
+
+// src/queue/queue-activity.ts
+var QUEUE_ACTIVITY_SERVICE = "queueAnalysis";
+var NAMESPACE4 = "http://webservices.sabre.com/sabreXML/2011/10";
+var COUNTERS = [
+  ["NumMessages", "numMessages"],
+  ["Ended", "ended"],
+  ["Ignored", "ignored"],
+  ["Moved", "moved"],
+  ["Removed", "removed"],
+  ["Transferred", "transferred"],
+  ["LeftMessageToContact", "leftMessageToContact"],
+  ["UnableToReach", "unableToReach"]
+];
+function queueActivityPayload(pcc) {
+  return `<QueueAnalysisRQ Version="2.0.0" xmlns="${NAMESPACE4}"><QueueInfo><QueueIdentifier PseudoCityCode="${xmlEscape(pcc)}"/></QueueInfo></QueueAnalysisRQ>`;
+}
+function queueActivityRequest(pcc, options) {
+  return {
+    service: QUEUE_ACTIVITY_SERVICE,
+    action: "QueueAnalysisLLSRQ",
+    payload: queueActivityPayload(pcc),
+    idempotent: true,
+    operation: "queue.activity",
+    ...options
+  };
+}
+function attribute3(node3, name) {
+  const value = (Array.isArray(node3) ? node3[0] : node3)?.[`@${name}`];
+  return typeof value === "string" ? value : void 0;
+}
+function nonEmpty4(value) {
+  const text = value?.trim();
+  return text === void 0 || text === "" ? void 0 : text;
+}
+function parseQueueActivityResponse(response) {
+  const queues = [];
+  let analyzedAt;
+  for (const info of asArray(response.payload.QueueInfo)) {
+    analyzedAt ??= nonEmpty4(attribute3(info, "DateTime"));
+    for (const identifier2 of asArray(info.QueueIdentifier)) {
+      const number = attribute3(identifier2, "Number");
+      const name = nonEmpty4(attribute3(identifier2, "Name"));
+      const queue = number === void 0 && name !== void 0 ? { name } : toQueueRef(number);
+      if (queue === void 0) throw malformed2(`QueueIdentifier con Number="${number ?? ""}"`, response);
+      queues.push({ queue, ...counters(identifier2, `la cola ${number ?? name}`, response) });
+    }
+  }
+  const totalsNode = asArray(response.payload.Totals)[0];
+  const totals = totalsNode === void 0 ? void 0 : counters(totalsNode, "Totals", response);
+  return {
+    queues,
+    ...totals === void 0 ? {} : { totals },
+    ...analyzedAt === void 0 ? {} : { analyzedAt },
+    warnings: response.warnings,
+    ...respondedAtField(response.raw)
+  };
+}
+function counters(node3, label, response) {
+  const result = {};
+  for (const [element2, key] of COUNTERS) {
+    const raw = attribute3(node3[element2], "Count");
+    const count = parseHostCount(raw);
+    if (count === void 0) throw malformed2(`${label} con ${element2} Count="${raw ?? ""}"`, response);
+    result[key] = count;
+  }
+  return result;
+}
+function malformed2(detail, response) {
+  return new SabreGatewayError(`${QUEUE_ACTIVITY_SERVICE}: respuesta no reconocida (${detail})`, {
+    protocol: "soap",
+    status: response.status,
+    retryable: false,
+    raw: response.raw
+  });
 }
 
 // src/queue/queue-place.ts
 var QUEUE_PLACE_SERVICE = "queuePlace";
-var NAMESPACE4 = "http://webservices.sabre.com/sabreXML/2011/10";
+var NAMESPACE5 = "http://webservices.sabre.com/sabreXML/2011/10";
 var MAX_PLACE_TO = 10;
 var MAX_PLACE_LOCATORS = 6;
 var INSTRUCTION_CODE_RANGES = [
@@ -2165,7 +2352,7 @@ function queuePlacePayload(to, locators = []) {
     return `<QueueIdentifier ${queueRefAttribute(target.queue)}${pic} PseudoCityCode="${xmlEscape(target.pcc)}"/>`;
   }).join("");
   const ids = locators.map((locator) => `<UniqueID ID="${xmlEscape(locator)}"/>`).join("");
-  return `<QueuePlaceRQ Version="2.0.4" xmlns="${NAMESPACE4}"><QueueInfo>${identifiers}${ids}</QueueInfo></QueuePlaceRQ>`;
+  return `<QueuePlaceRQ Version="2.0.4" xmlns="${NAMESPACE5}"><QueueInfo>${identifiers}${ids}</QueueInfo></QueuePlaceRQ>`;
 }
 function queuePlaceRequest(payload, options) {
   return {
@@ -2190,7 +2377,7 @@ function isEnd(response, text) {
 }
 function parsePlaceStep(response) {
   const text = textLines(response.raw, "QueuePlaceRS");
-  if (isEnd(response, text)) return endStep(response.warnings);
+  if (isEnd(response, text)) return endStep(response.warnings, "end-of-display", response.raw);
   const locator = signatureLocator(text);
   if (locator === void 0) {
     throw new SabreGatewayError(`${QUEUE_PLACE_SERVICE}: respuesta no reconocida (sin l\xEDnea de firma del PNR ni fin de cola)`, {
@@ -2200,7 +2387,7 @@ function parsePlaceStep(response) {
       raw: response.raw
     });
   }
-  return { done: false, item: { locator, paragraph: text }, warnings: response.warnings };
+  return { done: false, kind: "pnr", item: { locator, paragraph: text }, warnings: response.warnings, ...respondedAtField(response.raw) };
 }
 function parsePlaceUnknown(response) {
   const text = textLines(response.raw, "QueuePlaceRS");
@@ -2223,11 +2410,16 @@ function parsePlaceResult(response) {
       ...placedAt === void 0 ? {} : { placedAt }
     };
   });
-  return { placements, text: textLines(response.raw, "QueuePlaceRS"), warnings: response.warnings };
+  return {
+    placements,
+    text: textLines(response.raw, "QueuePlaceRS"),
+    warnings: response.warnings,
+    ...respondedAtField(response.raw)
+  };
 }
 
 // src/queue/queue-management.ts
-function fail3(message) {
+function fail4(message) {
   throw new TypeError(`sabre-client: ${message}`);
 }
 function rejectedBySabre(error) {
@@ -2236,6 +2428,8 @@ function rejectedBySabre(error) {
 var QueueManagement = class {
   #context;
   #state = "outside";
+  /** Si la última cola a la que se entró es la `S`: ahí cada paso es un mensaje, no un PNR. */
+  #messages = false;
   /** @internal Lo construye `SabreSession`. */
   constructor(context) {
     this.#context = context;
@@ -2261,31 +2455,61 @@ var QueueManagement = class {
     const response = await this.#context.send(queueCountRequest(pcc, options));
     return parseQueueCountResponse(response);
   }
+  /**
+   * Get Queue Activity (`QueueAnalysisLLSRQ` 2.0.0, el `QA` del host): por cada cola del PCC, los
+   * ocho contadores de actividad (`numMessages`, `ended`, `ignored`, `moved`, `removed`,
+   * `transferred`, `leftMessageToContact` y `unableToReach`), más los totales. Cada `queue` se puede
+   * pasar tal cual a las demás operaciones de cola. Ninguna fuente dice desde cuándo cuentan
+   * (Q-097): el SDK los devuelve sin interpretar.
+   *
+   * Se puede llamar dentro o fuera de una cola, y no cambia `state`. Es una lectura: se reintenta
+   * ante fallos transitorios. No pide duty code 9 (CERT y producción, Q-098). Un PCC que no tiene 3
+   * o 4 caracteres alfanuméricos lanza `TypeError` sin red.
+   */
+  async activity(request = {}, options = {}) {
+    if (typeof request !== "object" || request === null) fail4("queue.activity recibe { pcc? }");
+    const pcc = this.#pcc(request.pcc, "pcc");
+    const response = await this.#context.send(queueActivityRequest(pcc, options));
+    return parseQueueActivityResponse(response);
+  }
   /**
    * La lista de localizadores de una cola (`QueueAccessLLSRQ` con `List`), sin recorrerla. Con
    * `primaryPassenger: true`, cada entrada trae también el pasajero principal. Una cola vacía da
    * una lista vacía.
    *
+   * No pagina: Sabre devuelve la cola entera en una respuesta, también con más de 1000 PNR. Con
+   * `selection`, solo los PNR que cumplen el filtro; Sabre acepta solo `QD` o `AK` en la lista.
+   *
    * No cambia `state`. Es una lectura: se reintenta ante fallos transitorios. Lanza `TypeError`
-   * sin red si `queue` o `pcc` no son válidos, o si `primaryPassenger` no es un boolean.
+   * sin red si `queue` o `pcc` no son válidos, si `primaryPassenger` no es un boolean, o si
+   * `selection` no es válida o trae un código que no es `QD` ni `AK`.
    */
   async list(request, options = {}) {
-    if (typeof request !== "object" || request === null) fail3("queue.list recibe { queue, pcc?, primaryPassenger? }");
+    if (typeof request !== "object" || request === null) fail4("queue.list recibe { queue, pcc?, primaryPassenger?, selection? }");
     validateQueueRef(request.queue, "queue");
+    if (isMessageQueue(request.queue)) fail4("la cola 'S' es la de mensajes del PCC: no tiene PNR y Sabre no la lista");
     const pcc = this.#pcc(request.pcc, "pcc");
     const { primaryPassenger = false } = request;
-    if (typeof primaryPassenger !== "boolean") fail3("primaryPassenger debe ser un boolean");
-    const send2 = queueListRequest(queueListPayload(request.queue, pcc, primaryPassenger), options);
+    if (typeof primaryPassenger !== "boolean") fail4("primaryPassenger debe ser un boolean");
+    const selection = validateSelection(request.selection);
+    selection.forEach((filter, index) => {
+      if (!LIST_SELECTION_FUNCTIONS.includes(filter.function)) {
+        fail4(`selection[${index}].function en list solo puede ser ${LIST_SELECTION_FUNCTIONS.join(" o ")}: Sabre no acepta otro c\xF3digo en la lista`);
+      }
+    });
+    const send2 = queueListRequest(queueListPayload(request.queue, pcc, primaryPassenger, selection), options);
     try {
       return parseQueueList(await this.#context.send(send2));
     } catch (error) {
       const end = queueEndError(error, send2.service);
-      if (end !== void 0) return emptyList([...end.error.warnings]);
+      if (end !== void 0) return emptyList([...end.error.warnings], [], end.error.raw);
       throw error;
     }
   }
   /**
-   * Access Queue (`QueueAccessLLSRQ` 2.1.1): entra a una cola y devuelve su primer PNR. Una cola
+   * Access Queue (`QueueAccessLLSRQ` 2.1.1): entra a una cola y devuelve su primer PNR
+   * (`kind: 'pnr'`). En la cola `S`, la de mensajes, devuelve el primer mensaje
+   * (`kind: 'message'`), y `ignore` pasa al siguiente sin borrarlo (CERT, 2026-11-06). Una cola
    * vacía, o sin PNR que cumplan `selection`, devuelve `{ done: true }` y la sesión sigue afuera.
    *
    * Lanza `TypeError` sin red si la sesión ya está dentro de una cola (o en `'unknown'`: hay que
@@ -2294,12 +2518,13 @@ var QueueManagement = class {
    * `'unknown'`.
    */
   async access(request, options = {}) {
-    if (this.#state === "inside") fail3("la sesi\xF3n ya est\xE1 dentro de una cola: sal con queue.exit() antes de entrar a otra");
-    if (this.#state === "unknown") fail3("no se sabe si la sesi\xF3n sigue dentro de una cola: llama a queue.exit() antes de entrar");
-    if (typeof request !== "object" || request === null) fail3("queue.access recibe { queue, pcc?, selection? }");
+    if (this.#state === "inside") fail4("la sesi\xF3n ya est\xE1 dentro de una cola: sal con queue.exit() antes de entrar a otra");
+    if (this.#state === "unknown") fail4("no se sabe si la sesi\xF3n sigue dentro de una cola: llama a queue.exit() antes de entrar");
+    if (typeof request !== "object" || request === null) fail4("queue.access recibe { queue, pcc?, selection? }");
     validateQueueRef(request.queue, "queue");
     const pcc = this.#pcc(request.pcc, "pcc");
     const selection = validateSelection(request.selection);
+    this.#messages = isMessageQueue(request.queue);
     return this.#step(queueAccessRequest(queueAccessPayload(request.queue, pcc, selection), "queue.access", options));
   }
   /**
@@ -2312,7 +2537,8 @@ var QueueManagement = class {
   }
   /**
    * Saca el PNR actual de la cola y pasa al siguiente (`QR`). Con `from` (de 1 a 3 colas), lo saca
-   * de esas colas a la vez. Fuera de una cola lanza `TypeError` sin red.
+   * de esas colas a la vez. Fuera de una cola lanza `TypeError` sin red. En la cola `S` manda `QR`
+   * igual, pero no hay evidencia de qué hace Sabre con el mensaje.
    */
   async remove(request = {}, options = {}) {
     this.#requireQueue("remove");
@@ -2359,10 +2585,11 @@ var QueueManagement = class {
    * `options` se aplica a cada llamada a Sabre del recorrido.
    */
   async process(request, callback, options = {}) {
-    if (typeof request !== "object" || request === null) fail3("queue.process recibe { queue, pcc?, selection?, limit? }");
-    if (typeof callback !== "function") fail3("queue.process necesita un callback");
+    if (typeof request !== "object" || request === null) fail4("queue.process recibe { queue, pcc?, selection?, limit? }");
+    if (typeof callback !== "function") fail4("queue.process necesita un callback");
     const { limit, ...access } = request;
-    if (limit !== void 0 && !(Number.isInteger(limit) && limit >= 1)) fail3("limit debe ser un entero mayor o igual a 1");
+    if (isMessageQueue(access.queue)) fail4("queue.process no recorre la cola 'S', la de mensajes: usa queue.access() e queue.ignore()");
+    if (limit !== void 0 && !(Number.isInteger(limit) && limit >= 1)) fail4("limit debe ser un entero mayor o igual a 1");
     const startedOutside = this.#state === "outside";
     let visited = 0;
     try {
@@ -2372,6 +2599,7 @@ var QueueManagement = class {
           await this.exit(options);
           return { visited, ended: "limit" };
         }
+        if (step.kind !== "pnr") throw new TypeError("sabre-client: queue.process recibi\xF3 un mensaje en vez de un PNR");
         const action = await callback(step.item);
         visited++;
         step = await this.#processAction(action, options);
@@ -2403,17 +2631,20 @@ var QueueManagement = class {
     }
   }
   async place(request, options = {}) {
-    if (typeof request !== "object" || request === null) fail3("queue.place recibe { to, locators? }");
+    if (typeof request !== "object" || request === null) fail4("queue.place recibe { to, locators? }");
     const to = this.#placeTo(request.to);
     const locators = validateLocators(request.locators);
+    if (this.#messages && this.#state !== "outside") {
+      fail4("queue.place no se puede dentro de la cola 'S': lo que hay en pantalla es un mensaje, no un PNR");
+    }
     if (locators.length > 0 && this.#state === "inside") {
-      fail3("queue.place con locators no se puede dentro de una cola, donde coloca el PNR actual: sal con queue.exit() antes");
+      fail4("queue.place con locators no se puede dentro de una cola, donde coloca el PNR actual: sal con queue.exit() antes");
     }
     if (locators.length > 0 && this.#state === "unknown") {
-      fail3("no se sabe si la sesi\xF3n sigue dentro de una cola: llama a queue.exit() antes de colocar por localizador");
+      fail4("no se sabe si la sesi\xF3n sigue dentro de una cola: llama a queue.exit() antes de colocar por localizador");
     }
     if (to.some((target) => target.instructionCode === void 0)) {
-      fail3("queue.place necesita instructionCode en cada destino: Sabre lo exige, dentro y fuera de una cola");
+      fail4("queue.place necesita instructionCode en cada destino: Sabre lo exige, dentro y fuera de una cola");
     }
     const send2 = queuePlaceRequest(queuePlacePayload(to, locators), options);
     if (this.#state === "outside") return parsePlaceResult(await this.#context.send(send2));
@@ -2421,7 +2652,8 @@ var QueueManagement = class {
   }
   /** Manda una operación que avanza y actualiza `state` con el resultado. */
   #step(request) {
-    return this.#advance(request, parseQueueStep);
+    const messages = this.#messages;
+    return this.#advance(request, (response) => parseQueueStep(response, { messages }));
   }
   /**
    * Manda una operación que puede mover el cursor. Un `QueueStep` fija el estado: `'outside'` con
@@ -2435,7 +2667,7 @@ var QueueManagement = class {
       const end = queueEndError(error, request.service);
       if (end !== void 0) {
         this.#state = "outside";
-        return endStep([...end.error.warnings], end.reason);
+        return endStep([...end.error.warnings], end.reason, end.error.raw);
       }
       this.#onError(error);
       throw error;
@@ -2456,14 +2688,14 @@ var QueueManagement = class {
   }
   #placeTo(to) {
     if (!Array.isArray(to) || to.length === 0 || to.length > MAX_PLACE_TO) {
-      fail3(`to debe ser una lista de 1 a ${MAX_PLACE_TO} colas`);
+      fail4(`to debe ser una lista de 1 a ${MAX_PLACE_TO} colas`);
     }
     return to.map((target, index) => {
-      if (typeof target !== "object" || target === null) fail3(`to[${index}] debe ser { queue, pcc?, instructionCode }`);
+      if (typeof target !== "object" || target === null) fail4(`to[${index}] debe ser { queue, pcc?, instructionCode }`);
       const { queue, pcc, instructionCode } = target;
       validateQueueRef(queue, `to[${index}].queue`);
       if (instructionCode !== void 0 && !isInstructionCode(instructionCode)) {
-        fail3(`to[${index}].instructionCode debe ser un entero de 0 a 191 o de 200 a 254`);
+        fail4(`to[${index}].instructionCode debe ser un entero de 0 a 191 o de 200 a 254`);
       }
       return {
         queue,
@@ -2473,20 +2705,20 @@ var QueueManagement = class {
     });
   }
   #requireQueue(operation) {
-    if (this.#state === "outside") fail3(`queue.${operation} necesita estar dentro de una cola: entra con queue.access()`);
+    if (this.#state === "outside") fail4(`queue.${operation} necesita estar dentro de una cola: entra con queue.access()`);
   }
   #pcc(value, label) {
     if (value === void 0) return this.#context.pcc;
-    if (!isPseudoCityCode(value)) fail3(`${label} debe tener 3 o 4 caracteres alfanum\xE9ricos`);
+    if (!isPseudoCityCode(value)) fail4(`${label} debe tener 3 o 4 caracteres alfanum\xE9ricos`);
     return value;
   }
   #removeFrom(from) {
     if (from === void 0) return [];
     if (!Array.isArray(from) || from.length === 0 || from.length > MAX_REMOVE_FROM) {
-      fail3(`from debe ser una lista de 1 a ${MAX_REMOVE_FROM} colas`);
+      fail4(`from debe ser una lista de 1 a ${MAX_REMOVE_FROM} colas`);
     }
     return from.map((target, index) => {
-      if (typeof target !== "object" || target === null) fail3(`from[${index}] debe ser { queue, pcc? }`);
+      if (typeof target !== "object" || target === null) fail4(`from[${index}] debe ser { queue, pcc? }`);
       const { queue, pcc } = target;
       validateQueueRef(queue, `from[${index}].queue`);
       return { queue, pcc: this.#pcc(pcc, `from[${index}].pcc`) };
@@ -2496,37 +2728,171 @@ var QueueManagement = class {
 function validateLocators(locators) {
   if (locators === void 0) return [];
   if (!Array.isArray(locators) || locators.length === 0 || locators.length > MAX_PLACE_LOCATORS) {
-    fail3(`locators debe ser una lista de 1 a ${MAX_PLACE_LOCATORS} localizadores`);
+    fail4(`locators debe ser una lista de 1 a ${MAX_PLACE_LOCATORS} localizadores`);
   }
   return locators.map((locator, index) => {
-    if (typeof locator !== "string" || locator.trim() === "") fail3(`locators[${index}] debe ser un string no vac\xEDo`);
+    if (typeof locator !== "string" || locator.trim() === "") fail4(`locators[${index}] debe ser un string no vac\xEDo`);
     return locator;
   });
 }
 function validateSelection(selection) {
   if (selection === void 0) return [];
-  if (!Array.isArray(selection)) fail3("selection debe ser una lista de { function, criteria }");
-  if (selection.length > MAX_SELECTIONS) fail3(`selection admite hasta ${MAX_SELECTIONS} filtros`);
+  if (!Array.isArray(selection)) fail4("selection debe ser una lista de { function, criteria }");
+  if (selection.length > MAX_SELECTIONS) fail4(`selection admite hasta ${MAX_SELECTIONS} filtros`);
   return selection.map((filter, index) => {
     const { function: fn, criteria } = typeof filter === "object" && filter !== null ? filter : {};
-    if (typeof fn !== "string" || fn.trim() === "") fail3(`selection[${index}].function debe ser un string no vac\xEDo`);
+    if (typeof fn !== "string" || fn.trim() === "") fail4(`selection[${index}].function debe ser un string no vac\xEDo`);
     if (typeof criteria !== "string" || criteria.trim() === "") {
-      fail3(`selection[${index}].criteria debe ser un string no vac\xEDo`);
+      fail4(`selection[${index}].criteria debe ser un string no vac\xEDo`);
     }
     return { function: fn, criteria };
   });
 }
 
+// src/reservation/reservation-history.ts
+var RESERVATION_HISTORY_SERVICE = "itineraryHistory";
+var NAMESPACE6 = "http://webservices.sabre.com/sabreXML/2011/10";
+var LOCATOR = /^[A-Z0-9]{6}$/;
+function isRecordLocator(value) {
+  return typeof value === "string" && LOCATOR.test(value);
+}
+function reservationHistoryPayload(locator) {
+  return `<TravelItineraryHistoryRQ Version="2.4.0" xmlns="${NAMESPACE6}"><UniqueID ID="${xmlEscape(locator)}"/></TravelItineraryHistoryRQ>`;
+}
+function reservationHistoryRequest(locator, options) {
+  return {
+    service: RESERVATION_HISTORY_SERVICE,
+    action: "TravelItineraryHistoryLLSRQ",
+    payload: reservationHistoryPayload(locator),
+    idempotent: true,
+    operation: "reservation.history",
+    ...options
+  };
+}
+function node2(value) {
+  const first = Array.isArray(value) ? value[0] : value;
+  return typeof first === "object" && first !== null ? first : void 0;
+}
+function attribute4(value, name) {
+  const text = node2(value)?.[`@${name}`];
+  if (typeof text !== "string") return void 0;
+  const trimmed = text.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function defined(fields) {
+  return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== void 0));
+}
+function integer(value) {
+  return value !== void 0 && /^\d+$/.test(value) ? Number(value) : void 0;
+}
+function parseReservationHistoryResponse(response) {
+  const transactions = asArray(response.payload.HistoricalInfo).map((info) => transaction(node2(info) ?? {}, response));
+  return { transactions, warnings: response.warnings, ...respondedAtField(response.raw) };
+}
+function transaction(info, response) {
+  const source = node2(node2(info.ItineraryRef)?.Source);
+  const flightSegments = asArray(node2(node2(info.ItineraryInfo)?.ReservationItems)?.Item).flatMap(
+    (item) => asArray(node2(item)?.FlightSegment).map((segment) => flightSegment(node2(segment) ?? {}, response))
+  );
+  return {
+    ...defined({
+      rph: integer(attribute4(info, "RPH")),
+      createdAt: attribute4(source, "CreateDateTime"),
+      agent: attribute4(source, "CreationAgent"),
+      agentDutyCode: attribute4(source, "CreationAgentDutyCode"),
+      agentFunctionCode: attribute4(source, "CreationAgentFunctionCode"),
+      pcc: attribute4(source, "PseudoCityCode"),
+      aaaPcc: attribute4(source, "AAA_PseudoCityCode") ?? attribute4(source, "AAAPseudoCityCode"),
+      receivedFrom: attribute4(source, "ReceivedFrom")
+    }),
+    flightSegments,
+    generalInfo: asArray(info.GeneralInfo).map((entry) => textEntry(entry, "GeneralInfo", response)),
+    remarks: asArray(node2(info.RemarkInfo)?.Remark).map((entry) => textEntry(entry, "Remark", response)),
+    accounting: asArray(info.AccountingInfo).map(
+      (entry) => defined({ action: attribute4(entry, "Action"), type: attribute4(entry, "Type"), linkCode: attribute4(entry, "LinkCode") })
+    )
+  };
+}
+function textEntry(entry, label, response) {
+  const action = attribute4(entry, "Action");
+  if (action === void 0) throw malformed3(`${label} sin Action`, response);
+  const texts = asArray(node2(entry)?.Text).map((text) => textOf(text) ?? "");
+  return { action, text: texts.join("\n") };
+}
+function flightSegment(segment, response) {
+  const action = attribute4(segment, "Action");
+  if (action === void 0) throw malformed3("FlightSegment sin Action", response);
+  return {
+    action,
+    ...defined({
+      status: attribute4(segment, "Status"),
+      marketingAirline: attribute4(segment.MarketingAirline, "Code"),
+      flightNumber: attribute4(segment, "FlightNumber") ?? attribute4(segment.MarketingAirline, "FlightNumber"),
+      bookingClass: attribute4(segment, "ResBookDesigCode"),
+      origin: attribute4(segment.OriginLocation, "LocationCode"),
+      destination: attribute4(segment.DestinationLocation, "LocationCode"),
+      departureDateTime: attribute4(segment, "DepartureDateTime"),
+      arrivalDateTime: attribute4(segment, "ArrivalDateTime"),
+      numberInParty: integer(attribute4(segment, "NumberInParty")),
+      supplierRef: attribute4(segment.SupplierRef, "ID")
+    })
+  };
+}
+function malformed3(detail, response) {
+  return new SabreGatewayError(`${RESERVATION_HISTORY_SERVICE}: respuesta no reconocida (${detail})`, {
+    protocol: "soap",
+    status: response.status,
+    retryable: false,
+    raw: response.raw
+  });
+}
+
+// src/reservation/session-reservation.ts
+var SessionReservation = class {
+  #context;
+  /** @internal Lo construye `SabreSession`. */
+  constructor(context) {
+    this.#context = context;
+  }
+  /**
+   * Get Itinerary History (`TravelItineraryHistoryLLSRQ` 2.4.0, el `*H` del host): el historial
+   * del PNR, una entrada por transacción. Cada una trae quién la firmó, cuándo y desde qué PCC, y
+   * los elementos que cambió con su `action`: los segmentos de vuelo con su estado en ese momento,
+   * y SSR, ticketing, teléfonos, nombres y emails como texto en `generalInfo`. Lo que no se tipa
+   * queda en la respuesta cruda (`onRawResponse`). **Trae datos del pasajero.**
+   *
+   * El historial no registra las colocaciones en cola, ni las del sistema ni un `place` manual
+   * (CERT, 2026-11-06, Q-097): para eso están `queue.list`/`access` o los remarks `QUEUE_PLACE` de
+   * Get Booking.
+   *
+   * **Dentro de una cola, Sabre lo rechaza** para otro PNR (CERT, 2026-11-06, Q-102): lanza
+   * `SabreBusinessError` con `NAK6 -NOT ALLOWED- FINISH OR IGNORE OTHER ACTIVITY`. El PNR del AAA
+   * no cambia, `queue.state` sigue en `'inside'` y el recorrido sigue con `ignore`. Conviene
+   * llamarlo fuera de una cola.
+   *
+   * Es una lectura: se reintenta ante fallos transitorios. Un `locator` que no es de 6 caracteres
+   * alfanuméricos en mayúscula lanza `TypeError` sin red. Un PNR que no existe sale como
+   * `SabreBusinessError` (`service: 'itineraryHistory'`).
+   */
+  async history(locator, options = {}) {
+    if (!isRecordLocator(locator)) {
+      throw new TypeError("sabre-client: reservation.history necesita un localizador de 6 caracteres alfanum\xE9ricos en may\xFAscula");
+    }
+    const response = await this.#context.send(reservationHistoryRequest(locator, options));
+    return parseReservationHistoryResponse(response);
+  }
+};
+
 // src/session/command.ts
 var SABRE_COMMAND_SERVICE = "sabreCommand";
-var NAMESPACE5 = "http://webservices.sabre.com/sabreXML/2011/10";
+var NAMESPACE7 = "http://webservices.sabre.com/sabreXML/2011/10";
 var MAX_COMMAND_LENGTH = 1023;
 var DOUBLE_WIDTH = /* @__PURE__ */ new Set(["!", "%", "$", "&", "\xA5", "\xA7"]);
-function fail4(message) {
+function fail5(message) {
   throw new TypeError(`sabre-client: ${message}`);
 }
 function sabreCommandPayload(command) {
-  return `<SabreCommandLLSRQ xmlns="${NAMESPACE5}" Version="2.0.0" ReturnHostCommand="true"><Request Output="SCREEN"><HostCommand>${xmlEscape(command)}</HostCommand></Request></SabreCommandLLSRQ>`;
+  return `<SabreCommandLLSRQ xmlns="${NAMESPACE7}" Version="2.0.0" ReturnHostCommand="true"><Request Output="SCREEN"><HostCommand>${xmlEscape(command)}</HostCommand></Request></SabreCommandLLSRQ>`;
 }
 function commandToken(command) {
   return (command.trim().split(/[¥‡\s]/u)[0] ?? "").slice(0, 4);
@@ -2537,13 +2903,13 @@ function sabreCommandLength(command) {
   return length;
 }
 function sabreCommandRequest(command, options) {
-  if (typeof command !== "string" || command.trim() === "") fail4("command es requerido y debe ser un string no vac\xEDo");
+  if (typeof command !== "string" || command.trim() === "") fail5("command es requerido y debe ser un string no vac\xEDo");
   const length = sabreCommandLength(command);
   if (length > MAX_COMMAND_LENGTH) {
-    fail4(`command mide ${length} y el m\xE1ximo es ${MAX_COMMAND_LENGTH} (!, %, $, &, \xA5 y \xA7 cuentan 2); Sabre responder\xEDa REQUEST EXCEEDED MAXIMUM LENGTH`);
+    fail5(`command mide ${length} y el m\xE1ximo es ${MAX_COMMAND_LENGTH} (!, %, $, &, \xA5 y \xA7 cuentan 2); Sabre responder\xEDa REQUEST EXCEEDED MAXIMUM LENGTH`);
   }
   const { idempotent = false, ...requestOptions } = options;
-  if (typeof idempotent !== "boolean") fail4("idempotent debe ser un boolean");
+  if (typeof idempotent !== "boolean") fail5("idempotent debe ser un boolean");
   return {
     service: SABRE_COMMAND_SERVICE,
     action: "SabreCommandLLSRQ",
@@ -2565,7 +2931,8 @@ function parseSabreCommandResponse(response) {
   return {
     text: textOf((untrimmedPayload(response.raw) ?? response.payload).Response) ?? "",
     warnings: response.warnings,
-    messageId: response.messageId
+    messageId: response.messageId,
+    ...respondedAtField(response.raw)
   };
 }
 
@@ -2573,7 +2940,7 @@ function parseSabreCommandResponse(response) {
 var OTA_NAMESPACE = "http://www.opentravel.org/OTA/2002/11";
 var SWS_NAMESPACE = "http://webservices.sabre.com";
 var sessionSend = /* @__PURE__ */ Symbol("sabre-client.session.send");
-function fail5(message) {
+function fail6(message) {
   throw new TypeError(`sabre-client: ${message}`);
 }
 var SESSION_ERROR_KINDS = /* @__PURE__ */ new Map([
@@ -2602,6 +2969,8 @@ var KEEP_ALIVE_IDLE_MS = 13 * 6e4;
 var SabreSession = class {
   /** Queue Management: contar, recorrer y colocar en colas, dentro de esta sesión. */
   queue;
+  /** La reserva: el historial de un PNR, dentro de esta sesión. */
+  reservation;
   #transport;
   #pcc;
   #conversationId;
@@ -2629,6 +2998,7 @@ var SabreSession = class {
       pcc: internal.pcc,
       log: internal.transport.log
     });
+    this.reservation = new SessionReservation({ send: (request) => this[sessionSend](request) });
     if (internal.keepAlive) this.#scheduleKeepAlive(KEEP_ALIVE_IDLE_MS);
   }
   /**
@@ -2684,11 +3054,11 @@ var SabreSession = class {
     return this.#send(request);
   }
   async #send(request) {
-    if (this.#closing !== void 0) fail5("session closed");
+    if (this.#closing !== void 0) fail6("session closed");
     if (this.#unusable !== void 0) {
       throw new TypeError(`sabre-client: session unusable (${this.#unusable.kind})`, { cause: this.#unusable });
     }
-    if (this.#busy) fail5("session busy");
+    if (this.#busy) fail6("session busy");
     this.#busy = true;
     try {
       const response = await this.#transport.request({ ...request, ...this.#envelopeFields() });
@@ -2703,6 +3073,7 @@ var SabreSession = class {
   }
   async #sendClose(options) {
     if (this.#unusable !== void 0) return;
+    const { onRawRequest: _skipped, ...closeOptions } = options;
     this.#busy = true;
     try {
       await this.#transport.request({
@@ -2713,7 +3084,7 @@ var SabreSession = class {
         // Solo se reintenta ante `USG_*_BUSY`: tras un fallo de red no se sabe si ya se cerró.
         idempotent: false,
         operation: "close",
-        ...options
+        ...closeOptions
       });
     } catch (error) {
       throw this.#markUnusable(error);
@@ -2843,7 +3214,7 @@ function usernameToken(credentials) {
 }
 async function openSession(transport, credentials, options = {}) {
   const { keepAlive = false, ...requestOptions } = options;
-  if (typeof keepAlive !== "boolean") fail5("keepAlive debe ser un boolean");
+  if (typeof keepAlive !== "boolean") fail6("keepAlive debe ser un boolean");
   const conversationId = globalThis.crypto.randomUUID();
   const request = {
     service: "sessionCreate",
@@ -2948,34 +3319,35 @@ var SabreLegacy = class {
 
 // src/auth/credentials.ts
 var DEFAULT_DOMAIN = "AA";
-function fail6(message) {
+function fail7(message) {
   throw new TypeError(`sabre-client: ${message}`);
 }
 function requireString2(value, field) {
-  if (typeof value !== "string" || value.trim() === "") fail6(`${field} es requerido y debe ser un string no vac\xEDo`);
+  if (typeof value !== "string" || value.trim() === "") fail7(`${field} es requerido y debe ser un string no vac\xEDo`);
 }
 function buildCredentials(options) {
-  if (typeof options !== "object" || options === null) fail6("buildCredentials recibe un objeto");
+  if (typeof options !== "object" || options === null) fail7("buildCredentials recibe un objeto");
   const authVersion = options.authVersion ?? "v3";
   if (authVersion !== "v3" && authVersion !== "v2") {
-    fail6(`authVersion debe ser 'v3' o 'v2' (recibido: ${JSON.stringify(authVersion)})`);
+    fail7(`authVersion debe ser 'v3' o 'v2' (recibido: ${JSON.stringify(authVersion)})`);
   }
   const { user, pcc, password, clientId, clientSecret } = options;
   const domain = options.domain ?? DEFAULT_DOMAIN;
   requireString2(user, "user");
   requireString2(password, "password");
-  if (!isPseudoCityCode(pcc)) fail6("pcc debe tener 3 o 4 caracteres alfanum\xE9ricos");
+  if (!isPseudoCityCode(pcc)) fail7("pcc debe tener 3 o 4 caracteres alfanum\xE9ricos");
   requireString2(domain, "domain");
-  if (/[-:]/.test(domain)) fail6("domain no puede contener '-' ni ':'");
+  if (/[-:]/.test(domain)) fail7("domain no puede contener '-' ni ':'");
   if (clientId === void 0 !== (clientSecret === void 0)) {
-    fail6("clientId y clientSecret van juntos: pasa los dos o ninguno");
+    fail7("clientId y clientSecret van juntos: pasa los dos o ninguno");
   }
   if (authVersion === "v3" || clientId !== void 0) {
     requireString2(clientId, authVersion === "v3" ? "clientId (requerido con authVersion v3)" : "clientId");
     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
@@ -3276,6 +3648,22 @@ function hostTime(text) {
   return `${String(hours).padStart(2, "0")}:${String(minutes).padStart(2, "0")}`;
 }
 
+// src/queue/queue-place-remark.ts
+var MONTHS2 = /* @__PURE__ */ new Set(["JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC"]);
+var REMARK = /^([A-Z0-9]{3,4})(\d{2})([A-Z]{3})(\d{1,3})\/(\d{1,3})$/;
+function parseQueuePlaceRemark(text) {
+  if (typeof text !== "string") return null;
+  const match = REMARK.exec(text.trim());
+  if (match === null) return null;
+  const [, pcc, day, month, queueText, picText] = match;
+  const dayNumber2 = Number(day);
+  if (dayNumber2 < 1 || dayNumber2 > 31 || !MONTHS2.has(month)) return null;
+  const queue = Number(queueText);
+  const pic = Number(picText);
+  if (queue > MAX_QUEUE_NUMBER || !isInstructionCode(pic)) return null;
+  return { pcc, date: `${day}${month}`, queue, pic };
+}
+
 // src/air/seat-availability-request.ts
 function buildSeatAvailabilityRequest(source) {
   const { group, itinerary, segments: only, currencyCode } = source;
@@ -3360,7 +3748,7 @@ function fareComponent(fareComponentId, component) {
 }
 
 // src/index.ts
-var VERSION = "0.4.0";
+var VERSION = "0.5.0";
 export {
   Sabre,
   SabreBusinessError,
@@ -3376,6 +3764,7 @@ export {
   buildRevalidateItineraryRequest,
   buildSeatAvailabilityRequest,
   parseQueueParagraph,
+  parseQueuePlaceRemark,
   resolveHostDate
 };
 //# sourceMappingURL=index.js.map