@deuriib/dgii-ecf 0.3.1 → 0.4.0

package/dist/index.cjs

@@ -370,16 +370,51 @@ var createResiliencePolicies = (options = {}) => {
 };
 
 // src/http.ts
+var DEFAULT_IDEMPOTENCY_TTL_MS = 24 * 60 * 60 * 1e3;
+var IDEMPOTENCY_SWEEP_THRESHOLD = 1e3;
 var InMemoryIdempotencyStore = class {
-  store = /* @__PURE__ */ new Map();
+  entries = /* @__PURE__ */ new Map();
+  ttlMs;
+  now;
+  constructor(options = {}) {
+    this.ttlMs = options.ttlMs ?? DEFAULT_IDEMPOTENCY_TTL_MS;
+    if (!Number.isFinite(this.ttlMs) || this.ttlMs <= 0) {
+      throw new RangeError("ttlMs must be a positive finite number");
+    }
+    this.now = options.now ?? Date.now;
+  }
+  /** Number of live entries; expired ones are swept first. */
+  get size() {
+    this.sweepExpired();
+    return this.entries.size;
+  }
   async get(key) {
-    return this.store.get(key);
+    const entry = this.entries.get(key);
+    if (entry === void 0) {
+      return void 0;
+    }
+    if (entry.expiresAt <= this.now()) {
+      this.entries.delete(key);
+      return void 0;
+    }
+    return entry.value;
   }
   async set(key, value) {
-    this.store.set(key, value);
+    this.entries.set(key, { value, expiresAt: this.now() + this.ttlMs });
+    if (this.entries.size > IDEMPOTENCY_SWEEP_THRESHOLD) {
+      this.sweepExpired();
+    }
   }
   async delete(key) {
-    this.store.delete(key);
+    this.entries.delete(key);
+  }
+  sweepExpired() {
+    const now = this.now();
+    for (const [key, entry] of this.entries) {
+      if (entry.expiresAt <= now) {
+        this.entries.delete(key);
+      }
+    }
   }
 };
 var HttpClient = class {
@@ -1051,8 +1086,39 @@ var ECF = class {
   }
   buildIdempotencyKey(signedXml) {
     const rnc = extractElementText(signedXml, "RNCEmisor") ?? "unknown-rnc";
-    const encf = extractElementText(signedXml, "eNCF") ?? "unknown-encf";
-    return `${rnc}:${encf}:${sha256Hex(signedXml)}`;
+    const ncf = extractElementText(signedXml, "eNCF") ?? extractElementText(signedXml, "RangoNCF") ?? "unknown-ncf";
+    return `${rnc}:${ncf}:${sha256Hex(signedXml)}`;
+  }
+  /**
+   * Run a submission through the persist-before-transmit idempotency flow.
+   *
+   * The pending marker is written first so an interrupted send can be
+   * reconciled instead of re-issued; a successful response replaces it, and
+   * a failure clears it so the caller can retry.
+   */
+  async submitIdempotent(key, send) {
+    const cached = await this.idempotency.get(key);
+    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" }
+          )
+        );
+      }
+      return (0, import_neverthrow.ok)(cached);
+    }
+    return this.singleFlight(key, async () => {
+      await this.idempotency.set(key, PENDING_SUBMISSION);
+      const result = await send();
+      if (result.isOk()) {
+        await this.idempotency.set(key, result.value);
+      } else {
+        await this.idempotency.delete(key);
+      }
+      return result;
+    });
   }
   async singleFlight(key, task) {
     const existing = this.inFlight.get(key);
@@ -1125,66 +1191,28 @@ var ECF = class {
    */
   async sendElectronicDocument(signedXml, fileName, buyerHost) {
     const key = this.buildIdempotencyKey(signedXml);
-    const cached = await this.idempotency.get(key);
-    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" }
-          )
-        );
-      }
-      return (0, import_neverthrow.ok)(cached);
-    }
-    return this.singleFlight(key, async () => {
-      await this.idempotency.set(key, PENDING_SUBMISSION);
+    return this.submitIdempotent(key, () => {
       const url = buyerHost ? buildSenderReceiverUrl(buyerHost, "fe/recepcion/api/ecf" /* SendInvoice */) : buildUrl(this.environment, "recepcion/api/FacturasElectronicas" /* SendInvoice */);
-      const result = await this.http.postMultipart(
+      return this.http.postMultipart(
         url,
         fileName,
         signedXml,
         { absoluteUrl: true, resource: "recepcion/api/FacturasElectronicas" /* SendInvoice */ }
       );
-      if (result.isOk()) {
-        await this.idempotency.set(key, result.value);
-      } else {
-        await this.idempotency.delete(key);
-      }
-      return result;
     });
   }
   /** Submit a signed summary invoice (RFCE). Idempotent like submissions. */
   async sendSummary(signedXml, fileName) {
     const key = this.buildIdempotencyKey(signedXml);
-    const cached = await this.idempotency.get(key);
-    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" }
-          )
-        );
-      }
-      return (0, import_neverthrow.ok)(cached);
-    }
-    return this.singleFlight(key, async () => {
-      await this.idempotency.set(key, PENDING_SUBMISSION);
-      const url = buildUrl(this.environment, "recepcionfc/api/recepcion/ecf" /* SendSummary */, BaseUrl.CF);
-      const result = await this.http.postMultipart(
-        url,
+    return this.submitIdempotent(
+      key,
+      () => this.http.postMultipart(
+        buildUrl(this.environment, "recepcionfc/api/recepcion/ecf" /* SendSummary */, BaseUrl.CF),
         fileName,
         signedXml,
         { absoluteUrl: true, resource: "recepcionfc/api/recepcion/ecf" /* SendSummary */ }
-      );
-      if (result.isOk()) {
-        await this.idempotency.set(key, result.value);
-      } else {
-        await this.idempotency.delete(key);
-      }
-      return result;
-    });
+      )
+    );
   }
   statusTrackId(trackId) {
     const url = buildUrl(this.environment, "consultaresultado/api/Consultas/Estado" /* TrackResultStatus */);
@@ -1244,21 +1272,37 @@ 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) {
-    const url = buildUrl(this.environment, "aprobacionComercial/api/AprobacionComercial" /* CommercialApproval */);
-    return this.http.postMultipart(
-      url,
-      fileName,
-      signedXml,
-      { absoluteUrl: true, resource: "aprobacionComercial/api/AprobacionComercial" /* CommercialApproval */ }
+    const key = this.buildIdempotencyKey(signedXml);
+    return this.submitIdempotent(
+      key,
+      () => this.http.postMultipart(
+        buildUrl(this.environment, "aprobacionComercial/api/AprobacionComercial" /* CommercialApproval */),
+        fileName,
+        signedXml,
+        { absoluteUrl: true, resource: "aprobacionComercial/api/AprobacionComercial" /* CommercialApproval */ }
+      )
     );
   }
+  /**
+   * Submit a signed range-voiding request (ANECF). Idempotent like
+   * submissions, keyed on `RNC + RangoNCF + SHA-256(signed XML)`.
+   */
   voidENCF(signedXml, fileName) {
-    const url = buildUrl(this.environment, "anulacionrangos/api/operaciones/anularrango" /* Void */);
-    return this.http.postMultipart(url, fileName, signedXml, {
-      absoluteUrl: true,
-      resource: "anulacionrangos/api/operaciones/anularrango" /* Void */
-    });
+    const key = this.buildIdempotencyKey(signedXml);
+    return this.submitIdempotent(
+      key,
+      () => this.http.postMultipart(
+        buildUrl(this.environment, "anulacionrangos/api/operaciones/anularrango" /* Void */),
+        fileName,
+        signedXml,
+        { absoluteUrl: true, resource: "anulacionrangos/api/operaciones/anularrango" /* Void */ }
+      )
+    );
   }
 };
 // Annotate the CommonJS export names for ESM import in node: