sabre-client 0.3.0 → 0.4.1

package/dist/index.js

@@ -1207,12 +1207,20 @@ function resolveConfig(config) {
   if (environment !== "sandbox" && environment !== "production") {
     fail(`environment debe ser 'sandbox' o 'production' (recibido: ${JSON.stringify(environment)})`);
   }
-  const authVersion = config.authVersion ?? "v3";
-  if (authVersion !== "v3" && authVersion !== "v2") {
-    fail(`authVersion debe ser 'v3' o 'v2' (recibido: ${JSON.stringify(authVersion)})`);
+  const configVersion = config.authVersion ?? void 0;
+  if (configVersion !== void 0 && configVersion !== "v3" && configVersion !== "v2") {
+    fail(`authVersion debe ser 'v3' o 'v2' (recibido: ${JSON.stringify(configVersion)})`);
   }
   const { credentials } = config;
   if (!isObject3(credentials)) fail("credentials es requerido");
+  const credentialsVersion = credentials.authVersion ?? void 0;
+  if (credentialsVersion !== void 0 && credentialsVersion !== "v3" && credentialsVersion !== "v2") {
+    fail(`credentials.authVersion debe ser 'v3' o 'v2' (recibido: ${JSON.stringify(credentialsVersion)})`);
+  }
+  if (configVersion !== void 0 && credentialsVersion !== void 0 && configVersion !== credentialsVersion) {
+    fail(`authVersion '${configVersion}' no coincide con credentials.authVersion '${credentialsVersion}'`);
+  }
+  const authVersion = configVersion ?? credentialsVersion ?? "v3";
   requireString(credentials.username, "credentials.username");
   requireString(credentials.password, "credentials.password");
   if (authVersion === "v3") {
@@ -1491,14 +1499,16 @@ 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 parser = new XMLParser({
+var PARSER_OPTIONS = {
   ignoreAttributes: false,
   attributeNamePrefix: "@",
   removeNSPrefix: true,
   parseTagValue: false,
   parseAttributeValue: false,
   processEntities: true
-});
+};
+var parser = new XMLParser(PARSER_OPTIONS);
+var untrimmedParser = new XMLParser({ ...PARSER_OPTIONS, trimValues: false });
 var SoapTransport = class {
   #config;
   #log;
@@ -1738,11 +1748,11 @@ function scrubToken(text, security) {
   const token = security.binarySecurityToken;
   return text.split(token).join(REDACTED).split(xmlEscape(token)).join(REDACTED);
 }
-function parseEnvelope(text) {
+function parseEnvelope(text, xmlParser = parser) {
   if (text.trim() === "") return void 0;
   let parsed;
   try {
-    parsed = parser.parse(text);
+    parsed = xmlParser.parse(text);
   } catch {
     return void 0;
   }
@@ -1807,6 +1817,10 @@ function retryReason(error, idempotent) {
   if (error.status === void 0 || TRANSIENT_STATUS.has(error.status)) return "transient";
   return void 0;
 }
+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)) {
     if (!key.startsWith("@") && key !== "#text") return [key, Array.isArray(value) ? value[0] : value];
@@ -2511,11 +2525,63 @@ function validateSelection(selection) {
   });
 }
 
+// src/session/command.ts
+var SABRE_COMMAND_SERVICE = "sabreCommand";
+var NAMESPACE5 = "http://webservices.sabre.com/sabreXML/2011/10";
+var MAX_COMMAND_LENGTH = 1023;
+var DOUBLE_WIDTH = /* @__PURE__ */ new Set(["!", "%", "$", "&", "\xA5", "\xA7"]);
+function fail4(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>`;
+}
+function commandToken(command) {
+  return (command.trim().split(/[¥‡\s]/u)[0] ?? "").slice(0, 4);
+}
+function sabreCommandLength(command) {
+  let length = 0;
+  for (const char of command) length += DOUBLE_WIDTH.has(char) ? 2 : 1;
+  return length;
+}
+function sabreCommandRequest(command, options) {
+  if (typeof command !== "string" || command.trim() === "") fail4("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`);
+  }
+  const { idempotent = false, ...requestOptions } = options;
+  if (typeof idempotent !== "boolean") fail4("idempotent debe ser un boolean");
+  return {
+    service: SABRE_COMMAND_SERVICE,
+    action: "SabreCommandLLSRQ",
+    payload: sabreCommandPayload(command),
+    idempotent,
+    operation: "command",
+    ...requestOptions
+  };
+}
+function parseSabreCommandResponse(response) {
+  if (response.payloadName !== "SabreCommandLLSRS") {
+    throw new SabreGatewayError(`${SABRE_COMMAND_SERVICE}: respuesta no reconocida (${response.payloadName})`, {
+      protocol: "soap",
+      status: response.status,
+      retryable: false,
+      raw: response.raw
+    });
+  }
+  return {
+    text: textOf((untrimmedPayload(response.raw) ?? response.payload).Response) ?? "",
+    warnings: response.warnings,
+    messageId: response.messageId
+  };
+}
+
 // src/session/session.ts
 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 fail4(message) {
+function fail5(message) {
   throw new TypeError(`sabre-client: ${message}`);
 }
 var SESSION_ERROR_KINDS = /* @__PURE__ */ new Map([
@@ -2587,6 +2653,18 @@ var SabreSession = class {
   async ping(options = {}) {
     checkPingResponse(await this[sessionSend]({ ...pingRequest(), ...options }));
   }
+  /**
+   * Manda un comando de host (`SabreCommandLLSRQ` 2.0.0) y devuelve la pantalla como texto, sin
+   * interpretarla. Es una vía de escape: sin tipos ni garantías, y un comando puede cambiar la
+   * configuración del PCC o emitir. El comando va tal cual; el separador de Sabre Red (`‡`) se
+   * escribe `¥`. Sin reintento salvo `{ idempotent: true }`, para comandos de solo lectura. La
+   * pantalla llega sin recortar, y más de 1023 caracteres (contados como Sabre) lanza sin red.
+   */
+  async command(command, options = {}) {
+    const request = sabreCommandRequest(command, options);
+    this.#transport.log.emit("debug", "sabre.session.command", { command: commandToken(command) });
+    return parseSabreCommandResponse(await this[sessionSend](request));
+  }
   /**
    * Cierra la sesión con `SessionCloseRQ`: Sabre descarta el AAA e invalida el token. Es
    * idempotente: las llamadas siguientes devuelven la misma promesa, sin volver a la red. Si el
@@ -2614,11 +2692,11 @@ var SabreSession = class {
     return this.#send(request);
   }
   async #send(request) {
-    if (this.#closing !== void 0) fail4("session closed");
+    if (this.#closing !== void 0) fail5("session closed");
     if (this.#unusable !== void 0) {
       throw new TypeError(`sabre-client: session unusable (${this.#unusable.kind})`, { cause: this.#unusable });
     }
-    if (this.#busy) fail4("session busy");
+    if (this.#busy) fail5("session busy");
     this.#busy = true;
     try {
       const response = await this.#transport.request({ ...request, ...this.#envelopeFields() });
@@ -2773,7 +2851,7 @@ function usernameToken(credentials) {
 }
 async function openSession(transport, credentials, options = {}) {
   const { keepAlive = false, ...requestOptions } = options;
-  if (typeof keepAlive !== "boolean") fail4("keepAlive debe ser un boolean");
+  if (typeof keepAlive !== "boolean") fail5("keepAlive debe ser un boolean");
   const conversationId = globalThis.crypto.randomUUID();
   const request = {
     service: "sessionCreate",
@@ -2876,6 +2954,39 @@ var SabreLegacy = class {
   }
 };
 
+// src/auth/credentials.ts
+var DEFAULT_DOMAIN = "AA";
+function fail6(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`);
+}
+function buildCredentials(options) {
+  if (typeof options !== "object" || options === null) fail6("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)})`);
+  }
+  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");
+  requireString2(domain, "domain");
+  if (/[-:]/.test(domain)) fail6("domain no puede contener '-' ni ':'");
+  if (clientId === void 0 !== (clientSecret === void 0)) {
+    fail6("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}`;
+  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
 var MONTHS = ["JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC"];
 var DAY_MS = 864e5;
@@ -3258,7 +3369,7 @@ function fareComponent(fareComponentId, component) {
 }
 
 // src/index.ts
-var VERSION = "0.3.0";
+var VERSION = "0.4.1";
 export {
   Sabre,
   SabreBusinessError,
@@ -3270,6 +3381,7 @@ export {
   SabreWarning,
   VERSION,
   buildBookingFlightDetails,
+  buildCredentials,
   buildRevalidateItineraryRequest,
   buildSeatAvailabilityRequest,
   parseQueueParagraph,