@deuriib/dgii-ecf 0.3.2 → 0.4.0

package/dist/index.d.cts

@@ -399,6 +399,14 @@ declare class ECF {
     private readonly inFlight;
     constructor(credentials: P12ReaderData, environment?: Environment, options?: EcfOptions);
     private buildIdempotencyKey;
+    /**
+     * 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.
+     */
+    private submitIdempotent;
     private singleFlight;
     /** Authenticate against DGII (or a buyer host) and store the bearer token. */
     authenticate(buyerHost?: string): Promise<Result<AuthToken, DgiiError>>;
@@ -418,7 +426,15 @@ declare class ECF {
     getCustomerDirectory(rnc: string): Promise<Result<ServiceDirectoryResponse[] | undefined, DgiiError>>;
     /** RFCE inquiry — DGII production only. */
     getSummaryInvoiceInquiry(rnc: string, encf: string, codSeguridad: string): Promise<Result<InquiryInvoiceSummary, DgiiError>>;
+    /**
+     * Submit a signed commercial approval (ACECF). Idempotent like submissions,
+     * keyed on `RNC + eNCF + SHA-256(signed XML)`.
+     */
     sendCommercialApproval(signedXml: string, fileName: string): Promise<Result<CommercialApprovalResponse, DgiiError>>;
+    /**
+     * Submit a signed range-voiding request (ANECF). Idempotent like
+     * submissions, keyed on `RNC + RangoNCF + SHA-256(signed XML)`.
+     */
     voidENCF(signedXml: string, fileName: string): Promise<Result<VoidNCFResponse, DgiiError>>;
 }
 

package/dist/index.d.ts

@@ -399,6 +399,14 @@ declare class ECF {
     private readonly inFlight;
     constructor(credentials: P12ReaderData, environment?: Environment, options?: EcfOptions);
     private buildIdempotencyKey;
+    /**
+     * 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.
+     */
+    private submitIdempotent;
     private singleFlight;
     /** Authenticate against DGII (or a buyer host) and store the bearer token. */
     authenticate(buyerHost?: string): Promise<Result<AuthToken, DgiiError>>;
@@ -418,7 +426,15 @@ declare class ECF {
     getCustomerDirectory(rnc: string): Promise<Result<ServiceDirectoryResponse[] | undefined, DgiiError>>;
     /** RFCE inquiry — DGII production only. */
     getSummaryInvoiceInquiry(rnc: string, encf: string, codSeguridad: string): Promise<Result<InquiryInvoiceSummary, DgiiError>>;
+    /**
+     * Submit a signed commercial approval (ACECF). Idempotent like submissions,
+     * keyed on `RNC + eNCF + SHA-256(signed XML)`.
+     */
     sendCommercialApproval(signedXml: string, fileName: string): Promise<Result<CommercialApprovalResponse, DgiiError>>;
+    /**
+     * Submit a signed range-voiding request (ANECF). Idempotent like
+     * submissions, keyed on `RNC + RangoNCF + SHA-256(signed XML)`.
+     */
     voidENCF(signedXml: string, fileName: string): Promise<Result<VoidNCFResponse, DgiiError>>;
 }
 

package/dist/index.js

@@ -1034,8 +1034,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 err(
+          new DgiiError(
+            "A submission with this key is already pending; reconcile via a status lookup before retrying",
+            { code: "IDEMPOTENCY" }
+          )
+        );
+      }
+      return 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);
@@ -1108,66 +1139,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 err(
-          new DgiiError(
-            "A submission with this key is already pending; reconcile via a status lookup before retrying",
-            { code: "IDEMPOTENCY" }
-          )
-        );
-      }
-      return 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 err(
-          new DgiiError(
-            "A submission with this key is already pending; reconcile via a status lookup before retrying",
-            { code: "IDEMPOTENCY" }
-          )
-        );
-      }
-      return 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 */);
@@ -1227,21 +1220,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 */ }
+      )
+    );
   }
 };
 export {