facturas 0.6.0 → 0.6.1

package/dist/constants.d.ts

@@ -6,11 +6,26 @@ declare const ARCA_VOUCHER_TYPES: {
     readonly FACTURA_B: 6;
     readonly NOTA_DEBITO_B: 7;
     readonly NOTA_CREDITO_B: 8;
+    readonly FACTURA_C: 11;
+    readonly NOTA_DEBITO_C: 12;
+    readonly NOTA_CREDITO_C: 13;
 };
 /** Common document types accepted by ARCA services. */
 declare const ARCA_DOCUMENT_TYPES: {
     readonly CUIT: 80;
     readonly DNI: 96;
+    readonly CONSUMIDOR_FINAL: 99;
+};
+/**
+ * Common receiver IVA condition identifiers used by WSFE.
+ * Allowed values depend on the voucher class and ARCA's live catalog.
+ */
+declare const ARCA_RECEIVER_VAT_CONDITIONS: {
+    readonly RESPONSABLE_INSCRIPTO: 1;
+    readonly EXENTO: 4;
+    readonly CONSUMIDOR_FINAL: 5;
+    readonly MONOTRIBUTISTA: 6;
+    readonly IVA_NO_ALCANZADO: 15;
 };
 /** Supported invoice concept types for WSFE requests. */
 declare const ARCA_CONCEPT_TYPES: {
@@ -24,6 +39,8 @@ declare const ARCA_VAT_RATES: {
     readonly IVA_10_5: 4;
     readonly IVA_21: 5;
     readonly IVA_27: 6;
+    readonly IVA_5: 8;
+    readonly IVA_2_5: 9;
 };
 /** Common ARCA currency identifiers. */
 declare const ARCA_CURRENCIES: {
@@ -31,4 +48,4 @@ declare const ARCA_CURRENCIES: {
     readonly DOL: "DOL";
 };
 
-export { ARCA_CONCEPT_TYPES, ARCA_CURRENCIES, ARCA_DOCUMENT_TYPES, ARCA_VAT_RATES, ARCA_VOUCHER_TYPES };
+export { ARCA_CONCEPT_TYPES, ARCA_CURRENCIES, ARCA_DOCUMENT_TYPES, ARCA_RECEIVER_VAT_CONDITIONS, ARCA_VAT_RATES, ARCA_VOUCHER_TYPES };

package/dist/constants.mjs

@@ -5,11 +5,22 @@ var ARCA_VOUCHER_TYPES = {
   NOTA_CREDITO_A: 3,
   FACTURA_B: 6,
   NOTA_DEBITO_B: 7,
-  NOTA_CREDITO_B: 8
+  NOTA_CREDITO_B: 8,
+  FACTURA_C: 11,
+  NOTA_DEBITO_C: 12,
+  NOTA_CREDITO_C: 13
 };
 var ARCA_DOCUMENT_TYPES = {
   CUIT: 80,
-  DNI: 96
+  DNI: 96,
+  CONSUMIDOR_FINAL: 99
+};
+var ARCA_RECEIVER_VAT_CONDITIONS = {
+  RESPONSABLE_INSCRIPTO: 1,
+  EXENTO: 4,
+  CONSUMIDOR_FINAL: 5,
+  MONOTRIBUTISTA: 6,
+  IVA_NO_ALCANZADO: 15
 };
 var ARCA_CONCEPT_TYPES = {
   PRODUCTOS: 1,
@@ -20,7 +31,9 @@ var ARCA_VAT_RATES = {
   IVA_0: 3,
   IVA_10_5: 4,
   IVA_21: 5,
-  IVA_27: 6
+  IVA_27: 6,
+  IVA_5: 8,
+  IVA_2_5: 9
 };
 var ARCA_CURRENCIES = {
   PES: "PES",
@@ -30,6 +43,7 @@ export {
   ARCA_CONCEPT_TYPES,
   ARCA_CURRENCIES,
   ARCA_DOCUMENT_TYPES,
+  ARCA_RECEIVER_VAT_CONDITIONS,
   ARCA_VAT_RATES,
   ARCA_VOUCHER_TYPES
 };

package/dist/constants.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["/** Common ARCA reference data for readable userland code and examples. */\nexport const ARCA_VOUCHER_TYPES = {\n  FACTURA_A: 1,\n  NOTA_DEBITO_A: 2,\n  NOTA_CREDITO_A: 3,\n  FACTURA_B: 6,\n  NOTA_DEBITO_B: 7,\n  NOTA_CREDITO_B: 8,\n} as const;\n\n/** Common document types accepted by ARCA services. */\nexport const ARCA_DOCUMENT_TYPES = {\n  CUIT: 80,\n  DNI: 96,\n} as const;\n\n/** Supported invoice concept types for WSFE requests. */\nexport const ARCA_CONCEPT_TYPES = {\n  PRODUCTOS: 1,\n  SERVICIOS: 2,\n  PRODUCTOS_Y_SERVICIOS: 3,\n} as const;\n\n/** Common IVA rate identifiers used by WSFE. */\nexport const ARCA_VAT_RATES = {\n  IVA_0: 3,\n  IVA_10_5: 4,\n  IVA_21: 5,\n  IVA_27: 6,\n} as const;\n\n/** Common ARCA currency identifiers. */\nexport const ARCA_CURRENCIES = {\n  PES: \"PES\",\n  DOL: \"DOL\",\n} as const;\n"],"mappings":";AACO,IAAM,qBAAqB;AAAA,EAChC,WAAW;AAAA,EACX,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,eAAe;AAAA,EACf,gBAAgB;AAClB;AAGO,IAAM,sBAAsB;AAAA,EACjC,MAAM;AAAA,EACN,KAAK;AACP;AAGO,IAAM,qBAAqB;AAAA,EAChC,WAAW;AAAA,EACX,WAAW;AAAA,EACX,uBAAuB;AACzB;AAGO,IAAM,iBAAiB;AAAA,EAC5B,OAAO;AAAA,EACP,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ;AACV;AAGO,IAAM,kBAAkB;AAAA,EAC7B,KAAK;AAAA,EACL,KAAK;AACP;","names":[]}
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["/** Common ARCA reference data for readable userland code and examples. */\nexport const ARCA_VOUCHER_TYPES = {\n  FACTURA_A: 1,\n  NOTA_DEBITO_A: 2,\n  NOTA_CREDITO_A: 3,\n  FACTURA_B: 6,\n  NOTA_DEBITO_B: 7,\n  NOTA_CREDITO_B: 8,\n  FACTURA_C: 11,\n  NOTA_DEBITO_C: 12,\n  NOTA_CREDITO_C: 13,\n} as const;\n\n/** Common document types accepted by ARCA services. */\nexport const ARCA_DOCUMENT_TYPES = {\n  CUIT: 80,\n  DNI: 96,\n  CONSUMIDOR_FINAL: 99,\n} as const;\n\n/**\n * Common receiver IVA condition identifiers used by WSFE.\n * Allowed values depend on the voucher class and ARCA's live catalog.\n */\nexport const ARCA_RECEIVER_VAT_CONDITIONS = {\n  RESPONSABLE_INSCRIPTO: 1,\n  EXENTO: 4,\n  CONSUMIDOR_FINAL: 5,\n  MONOTRIBUTISTA: 6,\n  IVA_NO_ALCANZADO: 15,\n} as const;\n\n/** Supported invoice concept types for WSFE requests. */\nexport const ARCA_CONCEPT_TYPES = {\n  PRODUCTOS: 1,\n  SERVICIOS: 2,\n  PRODUCTOS_Y_SERVICIOS: 3,\n} as const;\n\n/** Common IVA rate identifiers used by WSFE. */\nexport const ARCA_VAT_RATES = {\n  IVA_0: 3,\n  IVA_10_5: 4,\n  IVA_21: 5,\n  IVA_27: 6,\n  IVA_5: 8,\n  IVA_2_5: 9,\n} as const;\n\n/** Common ARCA currency identifiers. */\nexport const ARCA_CURRENCIES = {\n  PES: \"PES\",\n  DOL: \"DOL\",\n} as const;\n"],"mappings":";AACO,IAAM,qBAAqB;AAAA,EAChC,WAAW;AAAA,EACX,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,eAAe;AAAA,EACf,gBAAgB;AAClB;AAGO,IAAM,sBAAsB;AAAA,EACjC,MAAM;AAAA,EACN,KAAK;AAAA,EACL,kBAAkB;AACpB;AAMO,IAAM,+BAA+B;AAAA,EAC1C,uBAAuB;AAAA,EACvB,QAAQ;AAAA,EACR,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,kBAAkB;AACpB;AAGO,IAAM,qBAAqB;AAAA,EAChC,WAAW;AAAA,EACX,WAAW;AAAA,EACX,uBAAuB;AACzB;AAGO,IAAM,iBAAiB;AAAA,EAC5B,OAAO;AAAA,EACP,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AACX;AAGO,IAAM,kBAAkB;AAAA,EAC7B,KAAK;AAAA,EACL,KAAK;AACP;","names":[]}

package/dist/index.mjs

@@ -100,9 +100,10 @@ var ARCA_ENV_VARIABLES = {
 };
 var PRIVATE_KEY_PEM_PREFIXES = [
   "-----BEGIN PRIVATE KEY-----",
-  "-----BEGIN RSA PRIVATE KEY-----",
-  "-----BEGIN ENCRYPTED PRIVATE KEY-----"
+  "-----BEGIN RSA PRIVATE KEY-----"
 ];
+var ENCRYPTED_PRIVATE_KEY_PEM_PREFIX = "-----BEGIN ENCRYPTED PRIVATE KEY-----";
+var LEGACY_ENCRYPTED_RSA_PRIVATE_KEY_PATTERN = /^-----BEGIN RSA PRIVATE KEY-----[\s\S]*^Proc-Type:\s*4,\s*ENCRYPTED\s*$/m;
 var VALID_ARCA_LOG_LEVELS = ["debug", "info", "warn", "error"];
 var DEFAULT_ARCA_TIMEOUT_MS = 3e4;
 var DEFAULT_ARCA_RETRIES = 0;
@@ -133,6 +134,11 @@ function assertArcaClientConfig(config) {
   const timeout = normalized.timeout ?? DEFAULT_ARCA_TIMEOUT_MS;
   const retries = normalized.retries ?? DEFAULT_ARCA_RETRIES;
   const retryDelay = normalized.retryDelay ?? DEFAULT_ARCA_RETRY_DELAY_MS;
+  if (normalized.privateKeyPem.startsWith(ENCRYPTED_PRIVATE_KEY_PEM_PREFIX) || LEGACY_ENCRYPTED_RSA_PRIVATE_KEY_PATTERN.test(normalized.privateKeyPem)) {
+    throw new ArcaConfigurationError(
+      "Encrypted private keys are not supported. Provide an unencrypted PKCS#8 or RSA private key PEM."
+    );
+  }
   if (!/^\d{11}$/.test(normalized.taxId)) {
     invalidFields.push("taxId");
   }
@@ -786,12 +792,6 @@ function createWsfeService(options) {
   };
 }
 function mapWsfeVoucherInput(input, voucherNumber) {
-  const sendsSameForeignCurrencyCancellation = input.currencyId !== "PES" && input.sameCurrencyForeignCancellation === "S";
-  if (input.exchangeRate === void 0 && !sendsSameForeignCurrencyCancellation) {
-    throw new ArcaInputError(
-      "exchangeRate is required unless sameCurrencyForeignCancellation is S for a foreign-currency voucher."
-    );
-  }
   const data = {
     Concepto: input.concept,
     DocTipo: input.documentType,
@@ -809,7 +809,7 @@ function mapWsfeVoucherInput(input, voucherNumber) {
     PtoVta: input.salesPoint,
     CbteTipo: input.voucherType
   };
-  if (!sendsSameForeignCurrencyCancellation) {
+  if (input.exchangeRate !== void 0) {
     data.MonCotiz = input.exchangeRate;
   }
   if (input.receiverVatConditionId !== void 0) {
@@ -893,6 +893,7 @@ function mapWsfeVoucherInput(input, voucherNumber) {
 function normalizeWsfeVoucherInput(input) {
   const {
     voucherDate,
+    exchangeRate,
     serviceStartDate,
     serviceEndDate,
     paymentDueDate,
@@ -900,9 +901,11 @@ function normalizeWsfeVoucherInput(input) {
     associatedPeriod,
     ...rest
   } = input;
+  const normalizedExchangeRate = normalizeWsfeExchangeRate(input, exchangeRate);
   return {
     ...rest,
     voucherDate: normalizeWsfeDateInput(voucherDate, "voucherDate"),
+    ...normalizedExchangeRate === void 0 ? {} : { exchangeRate: normalizedExchangeRate },
     ...serviceStartDate === void 0 ? {} : {
       serviceStartDate: normalizeWsfeDateInput(
         serviceStartDate,
@@ -949,6 +952,30 @@ function normalizeWsfeVoucherInput(input) {
     }
   };
 }
+function normalizeWsfeExchangeRate(input, exchangeRate) {
+  if (input.currencyId === "PES") {
+    if (exchangeRate !== void 0 && exchangeRate !== 1) {
+      throw new ArcaInputError(
+        "exchangeRate must be 1 when currencyId is PES."
+      );
+    }
+    return 1;
+  }
+  if (exchangeRate === void 0) {
+    if (input.sameCurrencyForeignCancellation === "S") {
+      return void 0;
+    }
+    throw new ArcaInputError(
+      "exchangeRate is required unless sameCurrencyForeignCancellation is S for a foreign-currency voucher."
+    );
+  }
+  if (!(Number.isFinite(exchangeRate) && exchangeRate > 0)) {
+    throw new ArcaInputError(
+      "exchangeRate must be a positive finite number for a foreign-currency voucher."
+    );
+  }
+  return exchangeRate;
+}
 function normalizeWsfeDateInput(value, fieldName) {
   if (typeof value !== "string") {
     throw new ArcaInputError(
@@ -1380,12 +1407,12 @@ function createWsmtxcaService(options) {
       bodyElementName: `${operation}Request`,
       bodyElementNamespaceMode: "prefix",
       body: {
+        ...body,
         authRequest: createWsmtxcaAuth(
           input.representedTaxId ?? options.config.taxId,
           auth.token,
           auth.sign
-        ),
-        ...body
+        )
       }
     });
     return unwrapWsmtxcaOperationResponse(response.result, operation);
@@ -1395,6 +1422,11 @@ function createWsmtxcaService(options) {
     data,
     forceRefresh
   }) {
+    if (Object.hasOwn(data, "authRequest")) {
+      throw new ArcaInputError(
+        'WSMTXCA authorization data cannot include the reserved top-level field "authRequest".'
+      );
+    }
     try {
       const raw = await executeWsmtxcaAuthenticatedOperation(
         "autorizarComprobante",
@@ -2405,93 +2437,129 @@ function isWsaaCredentialValid(credentials) {
 // src/wsaa/index.ts
 function createWsaaAuthModule(options) {
   const cache = /* @__PURE__ */ new Map();
-  const inFlight = /* @__PURE__ */ new Map();
-  return {
-    async login(service, authOptions = {}) {
-      const sessionKey = buildWsaaSessionKey(options.config, service);
-      const cacheKey = serializeWsaaSessionKey(sessionKey);
-      const running = inFlight.get(cacheKey);
-      if (running) {
-        return running;
+  const ordinaryInFlight = /* @__PURE__ */ new Map();
+  const forcedInFlight = /* @__PURE__ */ new Map();
+  function trackLogin(target, cacheKey, login) {
+    const promise = login();
+    target.set(cacheKey, promise);
+    const cleanup = () => {
+      if (target.get(cacheKey) === promise) {
+        target.delete(cacheKey);
       }
-      const loginPromise = (async () => {
-        const reuse = await getReusableCredentials({
-          config: options.config,
-          cache,
-          cacheKey,
-          sessionKey,
-          logger: options.logger,
-          service,
-          allowStore: !authOptions.forceRefresh,
-          allowCache: !authOptions.forceRefresh
-        });
-        if (reuse) {
-          return reuse;
-        }
-        const refresh = () => refreshWsaaCredentials({
+    };
+    promise.then(cleanup, cleanup);
+    return promise;
+  }
+  async function requestOrReuseWsaaCredentials(service, sessionKey, cacheKey, forceRefresh) {
+    const reuse = await getReusableCredentials({
+      config: options.config,
+      cache,
+      cacheKey,
+      sessionKey,
+      logger: options.logger,
+      service,
+      allowStore: !forceRefresh,
+      allowCache: !forceRefresh
+    });
+    if (reuse) {
+      return reuse;
+    }
+    const refresh = () => refreshWsaaCredentials({
+      config: options.config,
+      cache,
+      cacheKey,
+      sessionKey,
+      logger: options.logger,
+      service,
+      forceRefresh
+    });
+    if (options.config.wsaaSessionStore?.withLock) {
+      return await withWsaaSessionStoreLock(
+        options.config,
+        sessionKey,
+        service,
+        refresh
+      );
+    }
+    return await refresh();
+  }
+  async function performLogin(service, sessionKey, cacheKey, forceRefresh) {
+    try {
+      return await requestOrReuseWsaaCredentials(
+        service,
+        sessionKey,
+        cacheKey,
+        forceRefresh
+      );
+    } catch (error) {
+      if (error instanceof ArcaSoapFaultError && error.faultCode === "ns1:coe.alreadyAuthenticated") {
+        const recovered = await getReusableCredentials({
           config: options.config,
           cache,
           cacheKey,
           sessionKey,
           logger: options.logger,
           service,
-          forceRefresh: authOptions.forceRefresh === true
+          allowStore: true,
+          allowCache: true
         });
-        if (options.config.wsaaSessionStore?.withLock) {
-          return await withWsaaSessionStoreLock(
-            options.config,
-            sessionKey,
-            service,
-            refresh
+        if (recovered) {
+          options.logger?.warn(
+            "Recovered WSAA coe.alreadyAuthenticated fault",
+            {
+              service,
+              faultCode: error.faultCode
+            }
           );
+          return recovered;
         }
-        return await refresh();
-      })();
-      inFlight.set(cacheKey, loginPromise);
-      try {
-        return await loginPromise;
-      } catch (error) {
-        if (error instanceof ArcaSoapFaultError && error.faultCode === "ns1:coe.alreadyAuthenticated") {
-          const recovered = await getReusableCredentials({
-            config: options.config,
-            cache,
-            cacheKey,
-            sessionKey,
-            logger: options.logger,
-            service,
-            allowStore: true,
-            allowCache: true
-          });
-          if (recovered) {
-            options.logger?.warn(
-              "Recovered WSAA coe.alreadyAuthenticated fault",
-              {
-                service,
-                faultCode: error.faultCode
-              }
-            );
-            return recovered;
-          }
-          if (!options.config.wsaaSessionStore) {
-            throw new ArcaConfigurationError(
-              "WSAA login failed because another process likely owns a valid TA. Configure a durable wsaaSessionStore for multi-process or serverless deployments.",
-              { cause: error }
-            );
-          }
+        if (!options.config.wsaaSessionStore) {
+          throw new ArcaConfigurationError(
+            "WSAA login failed because another process likely owns a valid TA. Configure a durable wsaaSessionStore for multi-process or serverless deployments.",
+            { cause: error }
+          );
         }
-        if (error instanceof ArcaSoapFaultError) {
-          options.logger?.error("WSAA SOAP fault response", {
-            service,
-            operation: "loginCms",
-            url: ARCA_WSAA_CONFIG.endpoint[options.config.environment],
-            faultCode: error.faultCode,
-            error
-          });
+      }
+      if (error instanceof ArcaSoapFaultError) {
+        options.logger?.error("WSAA SOAP fault response", {
+          service,
+          operation: "loginCms",
+          url: ARCA_WSAA_CONFIG.endpoint[options.config.environment],
+          faultCode: error.faultCode,
+          error
+        });
+      }
+      throw error;
+    }
+  }
+  return {
+    login(service, authOptions = {}) {
+      const sessionKey = buildWsaaSessionKey(options.config, service);
+      const cacheKey = serializeWsaaSessionKey(sessionKey);
+      if (authOptions.forceRefresh) {
+        const runningForced2 = forcedInFlight.get(cacheKey);
+        if (runningForced2) {
+          return runningForced2;
         }
-        throw error;
-      } finally {
-        inFlight.delete(cacheKey);
+        const runningOrdinary2 = ordinaryInFlight.get(cacheKey);
+        return trackLogin(forcedInFlight, cacheKey, async () => {
+          await runningOrdinary2?.catch(() => void 0);
+          return await performLogin(service, sessionKey, cacheKey, true);
+        });
+      }
+      const runningOrdinary = ordinaryInFlight.get(cacheKey);
+      if (runningOrdinary) {
+        return runningOrdinary;
       }
+      const runningForced = forcedInFlight.get(cacheKey);
+      if (runningForced) {
+        return runningForced;
+      }
+      return trackLogin(
+        ordinaryInFlight,
+        cacheKey,
+        () => performLogin(service, sessionKey, cacheKey, false)
+      );
     }
   };
 }