@deuriib/dgii-ecf 0.5.0 → 0.6.0

package/dist/index.cjs

@@ -42,13 +42,24 @@ __export(index_exports, {
   InMemoryIdempotencyStore: () => InMemoryIdempotencyStore,
   Ok: () => import_neverthrow.Ok,
   P12Reader: () => P12Reader,
+  PENDING_SUBMISSION_MESSAGE: () => PENDING_SUBMISSION_MESSAGE,
   ResultAsync: () => import_neverthrow.ResultAsync,
+  SCHEMA_DIR: () => SCHEMA_DIR,
+  SUMMARY_ACCEPTED: () => SUMMARY_ACCEPTED,
+  SUMMARY_CONDITIONAL_ACCEPTED: () => SUMMARY_CONDITIONAL_ACCEPTED,
+  SUMMARY_REJECTED: () => SUMMARY_REJECTED,
   SenderReceiverEndpoint: () => SenderReceiverEndpoint,
   Signature: () => Signature,
+  StatusEndpoint: () => StatusEndpoint,
+  StatusEnvironment: () => StatusEnvironment,
   TrackStatusEnum: () => TrackStatusEnum,
   Transformer: () => Transformer,
+  UNAVAILABLE_SCHEMAS: () => UNAVAILABLE_SCHEMAS,
   buildSenderReceiverUrl: () => buildSenderReceiverUrl,
+  buildStatusUrl: () => buildStatusUrl,
   buildUrl: () => buildUrl,
+  canReuseSequence: () => canReuseSequence,
+  checkB2BApplicability: () => checkB2BApplicability,
   compareDecimal: () => compareDecimal,
   convertECF32ToRFCE: () => convertECF32ToRFCE,
   createResiliencePolicies: () => createResiliencePolicies,
@@ -56,6 +67,7 @@ __export(index_exports, {
   err: () => import_neverthrow.err,
   errAsync: () => import_neverthrow.errAsync,
   extractDgiiErrorMessage: () => extractDgiiErrorMessage,
+  formatViolations: () => formatViolations,
   fromPromise: () => import_neverthrow.fromPromise,
   fromSafePromise: () => import_neverthrow.fromSafePromise,
   fromThrowable: () => import_neverthrow.fromThrowable,
@@ -70,9 +82,11 @@ __export(index_exports, {
   isRetryableStatus: () => isRetryableStatus,
   ok: () => import_neverthrow.ok,
   okAsync: () => import_neverthrow.okAsync,
+  pruneEmptyValues: () => pruneEmptyValues,
   resolveReceptionRoute: () => resolveReceptionRoute,
   roundHalfUpToCents: () => roundHalfUpToCents,
   toDgiiError: () => toDgiiError,
+  validateDocument: () => validateDocument,
   validateXMLCertificate: () => validateXMLCertificate
 });
 module.exports = __toCommonJS(index_exports);
@@ -103,6 +117,7 @@ var Endpoint = /* @__PURE__ */ ((Endpoint2) => {
   Endpoint2["InquiryStatus"] = "consultaestado/api/Consultas/Estado";
   Endpoint2["AllTrackingEcf"] = "ConsultaTrackIds/api/TrackIds/Consulta";
   Endpoint2["Directory"] = "consultadirectorio/api/consultas/obtenerdirectorioporrnc";
+  Endpoint2["DirectoryList"] = "consultadirectorio/api/consultas/listado";
   Endpoint2["Void"] = "anulacionrangos/api/operaciones/anularrango";
   return Endpoint2;
 })(Endpoint || {});
@@ -113,6 +128,19 @@ var SenderReceiverEndpoint = /* @__PURE__ */ ((SenderReceiverEndpoint2) => {
   SenderReceiverEndpoint2["CommercialApproval"] = "fe/aprobacioncomercial/api/ecf";
   return SenderReceiverEndpoint2;
 })(SenderReceiverEndpoint || {});
+var StatusEndpoint = /* @__PURE__ */ ((StatusEndpoint2) => {
+  StatusEndpoint2["Services"] = "api/estatusservicios/obtenerestatus";
+  StatusEndpoint2["MaintenanceWindows"] = "api/estatusservicios/obtenerventanasmantenimiento";
+  StatusEndpoint2["Check"] = "api/estatusservicios/verificarestado";
+  return StatusEndpoint2;
+})(StatusEndpoint || {});
+var StatusEnvironment = /* @__PURE__ */ ((StatusEnvironment3) => {
+  StatusEnvironment3[StatusEnvironment3["PreCertification"] = 1] = "PreCertification";
+  StatusEnvironment3[StatusEnvironment3["Production"] = 2] = "Production";
+  StatusEnvironment3[StatusEnvironment3["Certification"] = 3] = "Certification";
+  return StatusEnvironment3;
+})(StatusEnvironment || {});
+var buildStatusUrl = (endpoint, baseUrl = BaseUrl.STATUS) => `${baseUrl.replace(/\/+$/, "")}/${endpoint}`;
 var buildUrl = (environment, endpoint, baseUrl = BaseUrl.ECF) => `${baseUrl.replace(/\/+$/, "")}/${environment}/${endpoint}`;
 var buildSenderReceiverUrl = (host, endpoint) => `${host.replace(/\/+$/, "")}/${endpoint}`;
 
@@ -125,6 +153,9 @@ var TrackStatusEnum = /* @__PURE__ */ ((TrackStatusEnum2) => {
   TrackStatusEnum2["ConditionalAccepted"] = "Aceptado Condicional";
   return TrackStatusEnum2;
 })(TrackStatusEnum || {});
+var SUMMARY_ACCEPTED = "Aceptado";
+var SUMMARY_CONDITIONAL_ACCEPTED = "Aceptado condicional";
+var SUMMARY_REJECTED = "Rechazado";
 
 // src/errors.ts
 var RETRYABLE_STATUSES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
@@ -146,9 +177,10 @@ var readMensajes = (value) => {
     if (typeof item === "string" && item.trim()) {
       out.push({ valor: item.trim(), codigo: 0 });
     } else if (isObject(item) && typeof item.valor === "string") {
+      const codigo = item.codigo;
       out.push({
         valor: item.valor,
-        codigo: typeof item.codigo === "number" ? item.codigo : 0
+        codigo: typeof codigo === "number" || typeof codigo === "string" ? codigo : 0
       });
     }
   }
@@ -465,9 +497,9 @@ var HttpClient = class {
     }
     return url;
   }
-  authHeaders(extra) {
+  authHeaders(extra, omitAuth = false) {
     const headers = { Accept: "application/json" };
-    if (this.token) {
+    if (!omitAuth && this.token) {
       headers.Authorization = `Bearer ${this.token}`;
     }
     return { ...headers, ...extra };
@@ -520,7 +552,7 @@ var HttpClient = class {
   async execute(options) {
     const url = this.buildUrl(options.path, options.absoluteUrl, options.query);
     const method = options.method ?? "GET";
-    const headers = this.authHeaders(options.headers);
+    const headers = this.authHeaders(options.headers, options.omitAuth);
     const ctx = {
       method,
       resource: options.resource ?? options.path,
@@ -842,18 +874,43 @@ var roundHalfUpToCents = (value) => {
   const padded = rounded.padStart(3, "0");
   return `${sign}${padded.slice(0, -2)}.${padded.slice(-2)}`;
 };
+var isEmptyObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && Object.keys(value).length === 0;
+var pruneEmptyValues = (input) => {
+  if (input === null || input === void 0 || input === "") {
+    return void 0;
+  }
+  if (Array.isArray(input)) {
+    const filtered = input.map(pruneEmptyValues).filter(
+      (item) => item !== null && item !== void 0 && item !== "" && !isEmptyObject(item)
+    );
+    return filtered.length ? filtered : void 0;
+  }
+  if (typeof input === "object") {
+    const output = {};
+    for (const [key, value] of Object.entries(
+      input
+    )) {
+      const cleaned = pruneEmptyValues(value);
+      if (cleaned !== void 0 && cleaned !== "" && !isEmptyObject(cleaned)) {
+        output[key] = cleaned;
+      }
+    }
+    return Object.keys(output).length ? output : void 0;
+  }
+  return input;
+};
 var Transformer = class {
   json2xml(dataObject, round = false) {
     try {
+      const pruned = pruneEmptyValues(dataObject);
       const data = {
         _declaration: { _attributes: { version: "1.0", encoding: "utf-8" } },
-        ...dataObject
+        ...pruned !== null && pruned !== void 0 && typeof pruned === "object" && !Array.isArray(pruned) ? pruned : {}
       };
       const xml = import_xml_js.default.js2xml(data, {
         compact: true,
         ignoreComment: true,
         spaces: 2,
-        fullTagEmptyElement: true,
         textFn: (value, label) => {
           if (round && label.toLowerCase() !== "version") {
             return roundHalfUpToCents(value);
@@ -1004,6 +1061,191 @@ var resolveReceptionRoute = (signedXml) => {
     )
   ) : (0, import_neverthrow.ok)(GENERAL);
 };
+var B2B_EXCLUDED_TYPES = [
+  "41",
+  "43",
+  "45",
+  "46",
+  "47"
+];
+var checkB2BApplicability = (signedXml) => {
+  const root = extractRootElementName(signedXml);
+  if (root === "RFCE") {
+    return (0, import_neverthrow.err)(
+      validationError(
+        "An RFCE summary cannot be delivered directly to a buyer host"
+      )
+    );
+  }
+  if (root !== "ECF") {
+    return (0, import_neverthrow.err)(
+      validationError(
+        `Unsupported document root "${root ?? "unknown"}"; expected "ECF"`
+      )
+    );
+  }
+  const tipo = extractElementText(signedXml, "TipoeCF");
+  if (tipo === void 0) {
+    return (0, import_neverthrow.err)(validationError("TipoeCF is missing from the document"));
+  }
+  if (!isEcfTypeCode(tipo)) {
+    return (0, import_neverthrow.err)(validationError(`Unknown TipoeCF "${tipo}"`));
+  }
+  if (B2B_EXCLUDED_TYPES.includes(tipo)) {
+    return (0, import_neverthrow.err)(
+      validationError(
+        `An e-CF of type ${tipo} cannot be delivered directly to a buyer host`
+      )
+    );
+  }
+  if (tipo !== CONSUMPTION_TYPE) {
+    return (0, import_neverthrow.ok)(void 0);
+  }
+  const total = extractElementText(signedXml, "MontoTotal");
+  if (total === void 0) {
+    return (0, import_neverthrow.err)(
+      validationError(
+        "MontoTotal is required to check B2B applicability of an E32"
+      )
+    );
+  }
+  if (!DECIMAL_PATTERN.test(total)) {
+    return (0, import_neverthrow.err)(
+      validationError(`MontoTotal "${total}" is not a decimal amount`)
+    );
+  }
+  if (compareDecimal(total, CONSUMPTION_SUMMARY_THRESHOLD) < 0) {
+    return (0, import_neverthrow.err)(
+      validationError(
+        "An E32 below RD$250,000 cannot be delivered directly to a buyer host; send the RFCE summary to DGII instead"
+      )
+    );
+  }
+  return (0, import_neverthrow.ok)(void 0);
+};
+
+// src/reconciliation.ts
+var PENDING_SUBMISSION_MESSAGE = "A submission with this key is already pending; call reconcileSubmission() before retrying";
+var canReuseSequence = (response) => response.secuenciaUtilizada === false;
+
+// src/validation.ts
+var import_node_child_process = require("child_process");
+var import_node_fs2 = require("fs");
+var import_node_path = require("path");
+var import_node_url = require("url");
+var import_meta = {};
+var moduleDir = (() => {
+  if (typeof __dirname !== "undefined") {
+    return __dirname;
+  }
+  return (0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
+})();
+var SCHEMA_DIR = [moduleDir, (0, import_node_path.resolve)(moduleDir, "..", "schemas")].find(
+  (candidate) => (0, import_node_fs2.existsSync)((0, import_node_path.resolve)(candidate, "e-cf-32.xsd"))
+) ?? (0, import_node_path.resolve)(moduleDir, "..", "schemas");
+var SCHEMA_FILES = {
+  "ECF|32": "e-cf-32.xsd",
+  "ECF|33": "e-cf-33.xsd",
+  "ECF|34": "e-cf-34.xsd",
+  "ECF|41": "e-cf-41.xsd",
+  "ECF|43": "e-cf-43.xsd",
+  "ECF|44": "e-cf-44.xsd",
+  "ECF|45": "e-cf-45.xsd",
+  "ECF|46": "e-cf-46.xsd",
+  "ECF|47": "e-cf-47.xsd",
+  "ANECF|": "anecf.xsd",
+  "ARECF|": "arecf.xsd",
+  "SemillaModel|": "semilla.xsd"
+};
+var UNAVAILABLE_SCHEMAS = {
+  "ECF|31": "the published schema references IndicadorServicioTodoIncluidoType, which does not resolve",
+  "RFCE|": "the published schema has an invalid pattern facet: [$0-9] and the \\- escape are not valid XML Schema regex",
+  "ACECF|": "the published schema has an invalid pattern facet: the \\- escape is not valid XML Schema regex"
+};
+var schemaKey = (xml) => {
+  const root = extractRootElementName(xml);
+  if (root === void 0) {
+    return void 0;
+  }
+  if (root !== "ECF") {
+    return `${root}|`;
+  }
+  const tipo = extractElementText(xml, "TipoeCF");
+  return tipo === void 0 ? void 0 : `ECF|${tipo}`;
+};
+var validationError2 = (message, cause) => new DgiiError(message, {
+  code: "VALIDATION",
+  ...cause !== void 0 ? { cause } : {}
+});
+var VIOLATION_LINE = /^.*?:(\d+):\s*element\s+([^:]+):\s*(.*)$/;
+var parseViolations = (stderr) => {
+  const violations = [];
+  for (const raw of stderr.split("\n")) {
+    const line = raw.trim();
+    if (line === "" || line.endsWith("fails to validate") || line.endsWith("validates")) {
+      continue;
+    }
+    const match = VIOLATION_LINE.exec(line);
+    if (match !== null) {
+      violations.push({
+        path: (match[2] ?? "").trim(),
+        message: (match[3] ?? "").trim()
+      });
+    } else {
+      violations.push({ path: "", message: line });
+    }
+  }
+  return violations;
+};
+var validateDocument = (xml, options = {}) => {
+  const key = schemaKey(xml);
+  if (key === void 0) {
+    return (0, import_neverthrow.err)(
+      validationError2("Cannot determine the document type to validate")
+    );
+  }
+  const file = SCHEMA_FILES[key];
+  if (file === void 0) {
+    const reason = UNAVAILABLE_SCHEMAS[key] ?? "no bundled XML Schema for this document type";
+    const [root, tipo] = key.split("|");
+    const label = tipo ? `${root} ${tipo}` : root ?? key;
+    return (0, import_neverthrow.err)(validationError2(`Schema unavailable for ${label}: ${reason}`));
+  }
+  const bin = options.bin ?? process.env["DGII_XMLLINT_BIN"] ?? "xmllint";
+  const result = (0, import_node_child_process.spawnSync)(
+    bin,
+    ["--noout", "--schema", (0, import_node_path.resolve)(SCHEMA_DIR, file), "-"],
+    { input: xml, encoding: "utf8", maxBuffer: 8 * 1024 * 1024 }
+  );
+  if (result.error !== void 0 && result.error !== null) {
+    const code = result.error.code;
+    return (0, import_neverthrow.err)(
+      validationError2(
+        code === "ENOENT" ? `xmllint was not found ("${bin}"). Install libxml2-utils or set DGII_XMLLINT_BIN; schema validation cannot run without it` : `Failed to run xmllint: ${result.error.message}`,
+        result.error
+      )
+    );
+  }
+  if (result.status === 0) {
+    return (0, import_neverthrow.ok)([]);
+  }
+  const violations = parseViolations(result.stderr ?? "");
+  return (0, import_neverthrow.ok)(
+    violations.length > 0 ? violations : [
+      {
+        path: "",
+        message: (result.stderr ?? "").trim() || "Validation failed"
+      }
+    ]
+  );
+};
+var formatViolations = (violations) => {
+  const shown = violations.slice(0, 5).map(
+    (violation) => violation.path ? `${violation.path}: ${violation.message}` : violation.message
+  ).join("; ");
+  const remaining = violations.length - 5;
+  return remaining > 0 ? `${shown} (+${remaining} more)` : shown;
+};
 
 // src/utils.ts
 var getCodeSixDigitfromSignature = (signedXml) => {
@@ -1063,31 +1305,6 @@ var toArray = (value) => {
   }
   return Array.isArray(value) ? value : [value];
 };
-var isEmptyObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && Object.keys(value).length === 0;
-var removeEmptyValues = (input) => {
-  if (input === null || input === void 0 || input === "") {
-    return void 0;
-  }
-  if (Array.isArray(input)) {
-    const filtered = input.map(removeEmptyValues).filter(
-      (item) => item !== null && item !== void 0 && item !== "" && !isEmptyObject(item)
-    );
-    return filtered.length ? filtered : void 0;
-  }
-  if (typeof input === "object") {
-    const output = {};
-    for (const [key, value] of Object.entries(
-      input
-    )) {
-      const cleaned = removeEmptyValues(value);
-      if (cleaned !== void 0 && cleaned !== "" && !isEmptyObject(cleaned)) {
-        output[key] = cleaned;
-      }
-    }
-    return Object.keys(output).length ? output : void 0;
-  }
-  return input;
-};
 var convertECF32ToRFCE = (ecf32Xml) => {
   const securityCode = getCodeSixDigitfromSignature(ecf32Xml);
   if (securityCode.isErr()) {
@@ -1102,7 +1319,7 @@ var convertECF32ToRFCE = (ecf32Xml) => {
   const impuestos = toArray(
     encabezado?.Totales?.ImpuestosAdicionales?.ImpuestoAdicional
   );
-  const rfce = removeEmptyValues({
+  const rfce = pruneEmptyValues({
     RFCE: {
       Encabezado: {
         Version: encabezado?.Version,
@@ -1182,6 +1399,10 @@ var ECF = class {
   inFlight = /* @__PURE__ */ new Map();
   tokenRefreshSkewMs;
   now;
+  statusApiKey;
+  enforceB2BRules;
+  validateBeforeSend;
+  xmllintBin;
   tokenExpiresAt;
   refreshPromise;
   constructor(credentials, environment = "TesteCF" /* Dev */, options = {}) {
@@ -1189,6 +1410,10 @@ var ECF = class {
     this.environment = environment;
     this.tokenRefreshSkewMs = options.tokenRefreshSkewMs ?? 5 * 60 * 1e3;
     this.now = options.now ?? Date.now;
+    this.statusApiKey = options.statusApiKey;
+    this.enforceB2BRules = options.enforceB2BRules ?? true;
+    this.validateBeforeSend = options.validateBeforeSend ?? false;
+    this.xmllintBin = options.xmllintBin;
     this.idempotency = options.idempotencyStore ?? new InMemoryIdempotencyStore();
     this.http = new HttpClient({
       baseUrl: BaseUrl.ECF,
@@ -1203,8 +1428,8 @@ var ECF = class {
     });
   }
   buildIdempotencyKey(signedXml) {
-    const rnc = extractElementText(signedXml, "RNCEmisor") ?? "unknown-rnc";
-    const ncf = extractElementText(signedXml, "eNCF") ?? extractElementText(signedXml, "RangoNCF") ?? "unknown-ncf";
+    const rnc = extractElementText(signedXml, "RNCEmisor") ?? extractElementText(signedXml, "RncEmisor") ?? "unknown-rnc";
+    const ncf = extractElementText(signedXml, "eNCF") ?? extractElementText(signedXml, "SecuenciaeNCFDesde") ?? extractElementText(signedXml, "RangoNCF") ?? "unknown-ncf";
     return `${rnc}:${ncf}:${sha256Hex(signedXml)}`;
   }
   /**
@@ -1219,10 +1444,7 @@ var ECF = class {
     if (cached !== void 0) {
       if (isPendingSubmission(cached)) {
         return (0, import_neverthrow.err)(
-          new DgiiError(
-            "A submission with this key is already pending; reconcile via a status lookup before retrying",
-            { code: "IDEMPOTENCY" }
-          )
+          new DgiiError(PENDING_SUBMISSION_MESSAGE, { code: "IDEMPOTENCY" })
         );
       }
       return (0, import_neverthrow.ok)(cached);
@@ -1314,6 +1536,90 @@ var ECF = class {
     this.tokenExpiresAt = parseExpiry(token.value.expira);
     return (0, import_neverthrow.ok)(token.value);
   }
+  /**
+   * Query the operational status of every DGII service.
+   *
+   * The status host takes an API key instead of a bearer token, so this call
+   * neither needs `authenticate()` nor triggers a token refresh.
+   */
+  async getServiceStatus() {
+    const result = await this.statusRequest("api/estatusservicios/obtenerestatus" /* Services */);
+    if (result.isErr()) {
+      return (0, import_neverthrow.err)(result.error);
+    }
+    const data = result.value;
+    if (data === void 0 || data === null) {
+      return (0, import_neverthrow.ok)([]);
+    }
+    return (0, import_neverthrow.ok)(Array.isArray(data) ? data : [data]);
+  }
+  /** Scheduled maintenance windows, one entry per environment. */
+  async getMaintenanceWindows() {
+    const result = await this.statusRequest("api/estatusservicios/obtenerventanasmantenimiento" /* MaintenanceWindows */);
+    if (result.isErr()) {
+      return (0, import_neverthrow.err)(result.error);
+    }
+    const data = result.value;
+    if (Array.isArray(data)) {
+      return (0, import_neverthrow.ok)(data);
+    }
+    return (0, import_neverthrow.ok)(data?.ventanaMantenimientos ?? []);
+  }
+  /** Whether an environment is currently inside a maintenance window. */
+  checkServiceAvailability(ambiente) {
+    return this.statusRequest(
+      "api/estatusservicios/verificarestado" /* Check */,
+      { ambiente }
+    );
+  }
+  statusRequest(endpoint, query) {
+    const headers = this.statusApiKey === void 0 ? {} : { Authorization: `Apikey ${this.statusApiKey}` };
+    return this.http.request({
+      method: "GET",
+      path: buildStatusUrl(endpoint),
+      absoluteUrl: true,
+      resource: `status:${endpoint}`,
+      headers,
+      ...query !== void 0 ? { query } : {},
+      skipAuthHooks: true,
+      omitAuth: true
+    });
+  }
+  /**
+   * Resolve what happened to a submission whose idempotency marker is pending.
+   *
+   * Queries DGII by e-NCF. When DGII has no record of the document the marker
+   * is cleared, because re-submitting cannot double-issue. When DGII does have
+   * a record the marker stays in place — it is the lock that prevents a second
+   * submission of a document that already exists — and `delivered` tells the
+   * caller to stop retrying.
+   */
+  async reconcileSubmission(signedXml) {
+    const rnc = extractElementText(signedXml, "RNCEmisor") ?? extractElementText(signedXml, "RncEmisor");
+    const encf = extractElementText(signedXml, "eNCF") ?? extractElementText(signedXml, "SecuenciaeNCFDesde");
+    if (rnc === void 0 || encf === void 0) {
+      return (0, import_neverthrow.err)(
+        new DgiiError("The document has no emitter RNC or e-NCF to reconcile", {
+          code: "VALIDATION"
+        })
+      );
+    }
+    const inquiry = await this.inquiryStatus(rnc, encf);
+    if (inquiry.isErr()) {
+      return (0, import_neverthrow.err)(inquiry.error);
+    }
+    const delivered = inquiry.value.estado !== "No encontrado";
+    const cleared = !delivered;
+    if (cleared) {
+      await this.idempotency.delete(this.buildIdempotencyKey(signedXml));
+    }
+    return (0, import_neverthrow.ok)({
+      inquiry: inquiry.value,
+      delivered,
+      canReuseSequence: canReuseSequence(inquiry.value),
+      cleared
+    });
+  }
   getSeed(buyerHost) {
     if (buyerHost) {
       const url2 = buildSenderReceiverUrl(
@@ -1346,6 +1652,29 @@ var ECF = class {
    * a repeated call returns the cached response instead of double-issuing.
    */
   async sendElectronicDocument(signedXml, fileName, buyerHost) {
+    if (buyerHost !== void 0 && this.enforceB2BRules) {
+      const applicable = checkB2BApplicability(signedXml);
+      if (applicable.isErr()) {
+        return (0, import_neverthrow.err)(applicable.error);
+      }
+    }
+    if (this.validateBeforeSend) {
+      const validation = validateDocument(
+        signedXml,
+        this.xmllintBin !== void 0 ? { bin: this.xmllintBin } : {}
+      );
+      if (validation.isErr()) {
+        return (0, import_neverthrow.err)(validation.error);
+      }
+      if (validation.value.length > 0) {
+        return (0, import_neverthrow.err)(
+          new DgiiError(
+            `Document does not match the DGII XML Schema: ${formatViolations(validation.value)}`,
+            { code: "VALIDATION", data: validation.value }
+          )
+        );
+      }
+    }
     const key = this.buildIdempotencyKey(signedXml);
     return this.submitIdempotent(key, () => {
       const url = buyerHost ? buildSenderReceiverUrl(buyerHost, "fe/recepcion/api/ecf" /* SendInvoice */) : buildUrl(this.environment, "recepcion/api/FacturasElectronicas" /* SendInvoice */);
@@ -1433,6 +1762,22 @@ var ECF = class {
     }
     return (0, import_neverthrow.ok)(Array.isArray(data) ? data : [data]);
   }
+  /** General directory listing — every receiver that publishes service URLs. */
+  async getDirectoryListing() {
+    const url = buildUrl(this.environment, "consultadirectorio/api/consultas/listado" /* DirectoryList */);
+    const result = await this.http.get(url, void 0, {
+      absoluteUrl: true,
+      resource: "consultadirectorio/api/consultas/listado" /* DirectoryList */
+    });
+    if (result.isErr()) {
+      return (0, import_neverthrow.err)(result.error);
+    }
+    const data = result.value;
+    if (data === void 0 || data === null) {
+      return (0, import_neverthrow.ok)([]);
+    }
+    return (0, import_neverthrow.ok)(Array.isArray(data) ? data : [data]);
+  }
   /** RFCE inquiry — DGII production only. */
   async getSummaryInvoiceInquiry(rnc, encf, codSeguridad) {
     if (this.environment !== "eCF" /* Prod */) {
@@ -1454,12 +1799,32 @@ var ECF = class {
       { absoluteUrl: true, resource: "consultarfce/api/Consultas/Consulta" /* InquiryInvoiceSummary */ }
     );
   }
-  /**
-   * Submit a signed commercial approval (ACECF). Idempotent like submissions,
-   * keyed on `RNC + eNCF + SHA-256(signed XML)`.
-   */
-  sendCommercialApproval(signedXml, fileName) {
+  sendCommercialApproval(signedXml, fileName, buyerHost) {
     const key = this.buildIdempotencyKey(signedXml);
+    if (buyerHost !== void 0) {
+      return this.submitIdempotent(
+        key,
+        async () => {
+          const url = buildSenderReceiverUrl(
+            buyerHost,
+            "fe/aprobacioncomercial/api/ecf" /* CommercialApproval */
+          );
+          const result = await this.http.postMultipart(
+            url,
+            fileName,
+            signedXml,
+            {
+              absoluteUrl: true,
+              resource: "fe/aprobacioncomercial/api/ecf" /* CommercialApproval */
+            }
+          );
+          if (result.isErr()) {
+            return result.error.status === 400 ? (0, import_neverthrow.ok)({ status: 400, accepted: false }) : (0, import_neverthrow.err)(result.error);
+          }
+          return (0, import_neverthrow.ok)({ status: 200, accepted: true });
+        }
+      );
+    }
     return this.submitIdempotent(
       key,
       () => this.http.postMultipart(
@@ -1501,13 +1866,24 @@ var ECF = class {
   InMemoryIdempotencyStore,
   Ok,
   P12Reader,
+  PENDING_SUBMISSION_MESSAGE,
   ResultAsync,
+  SCHEMA_DIR,
+  SUMMARY_ACCEPTED,
+  SUMMARY_CONDITIONAL_ACCEPTED,
+  SUMMARY_REJECTED,
   SenderReceiverEndpoint,
   Signature,
+  StatusEndpoint,
+  StatusEnvironment,
   TrackStatusEnum,
   Transformer,
+  UNAVAILABLE_SCHEMAS,
   buildSenderReceiverUrl,
+  buildStatusUrl,
   buildUrl,
+  canReuseSequence,
+  checkB2BApplicability,
   compareDecimal,
   convertECF32ToRFCE,
   createResiliencePolicies,
@@ -1515,6 +1891,7 @@ var ECF = class {
   err,
   errAsync,
   extractDgiiErrorMessage,
+  formatViolations,
   fromPromise,
   fromSafePromise,
   fromThrowable,
@@ -1529,9 +1906,11 @@ var ECF = class {
   isRetryableStatus,
   ok,
   okAsync,
+  pruneEmptyValues,
   resolveReceptionRoute,
   roundHalfUpToCents,
   toDgiiError,
+  validateDocument,
   validateXMLCertificate
 });
 //# sourceMappingURL=index.cjs.map