facturas 0.20.5 → 0.22.0

package/dist/constants.d.ts

@@ -9,6 +9,9 @@ declare const ARCA_VOUCHER_TYPES: {
     readonly FACTURA_C: 11;
     readonly NOTA_DEBITO_C: 12;
     readonly NOTA_CREDITO_C: 13;
+    readonly FACTURA_E: 19;
+    readonly NOTA_DEBITO_E: 20;
+    readonly NOTA_CREDITO_E: 21;
 };
 /** Common document types accepted by ARCA services. */
 declare const ARCA_DOCUMENT_TYPES: {

package/dist/constants.mjs

@@ -11,7 +11,7 @@ import {
   ARCA_VOUCHER_TYPES,
   ARCA_WSMTXCA_GENERIC_CODES,
   ISO_CURRENCIES
-} from "./chunk-C2KX652X.mjs";
+} from "./chunk-5CGIRDZY.mjs";
 export {
   ARCA_CONCEPT_TYPES,
   ARCA_CURRENCY_IDS,

package/dist/errors.d.ts

@@ -1,2 +1,2 @@
-import './types-Su7QwloQ.js';
-export { A as ArcaAuthenticationError, a as ArcaAuthenticationErrorOptions, c as ArcaAuthenticationReason, f as ArcaConfigurationError, g as ArcaError, k as ArcaInputError, l as ArcaInputErrorCode, m as ArcaInputErrorOptions, n as ArcaInvalidSoapResponseError, o as ArcaSafeErrorMetadata, p as ArcaServiceError, q as ArcaSoapFaultError, r as ArcaTransportError, V as VoucherDateWindow, t as isArcaAuthenticationError, u as toArcaSafeErrorMetadata } from './fiscal-evidence-Bg4o9nxt.js';
+import './types-CbvsjIhf.js';
+export { A as ArcaAuthenticationError, a as ArcaAuthenticationErrorOptions, c as ArcaAuthenticationReason, f as ArcaConfigurationError, g as ArcaError, k as ArcaInputError, l as ArcaInputErrorCode, m as ArcaInputErrorOptions, n as ArcaInvalidSoapResponseError, o as ArcaLockTimeoutError, p as ArcaLockTimeoutReason, q as ArcaSafeErrorMetadata, r as ArcaServiceError, s as ArcaSoapFaultError, t as ArcaTransportError, V as VoucherDateWindow, v as isArcaAuthenticationError, w as toArcaSafeErrorMetadata } from './fiscal-evidence-DjG8zB3o.js';

package/dist/errors.mjs

@@ -4,18 +4,20 @@ import {
   ArcaError,
   ArcaInputError,
   ArcaInvalidSoapResponseError,
+  ArcaLockTimeoutError,
   ArcaServiceError,
   ArcaSoapFaultError,
   ArcaTransportError,
   isArcaAuthenticationError,
   toArcaSafeErrorMetadata
-} from "./chunk-NT2A6YMO.mjs";
+} from "./chunk-Q7IURW54.mjs";
 export {
   ArcaAuthenticationError,
   ArcaConfigurationError,
   ArcaError,
   ArcaInputError,
   ArcaInvalidSoapResponseError,
+  ArcaLockTimeoutError,
   ArcaServiceError,
   ArcaSoapFaultError,
   ArcaTransportError,

package/dist/{fiscal-evidence-Bg4o9nxt.d.ts → fiscal-evidence-DjG8zB3o.d.ts}

@@ -1,4 +1,4 @@
-import { b as ArcaServiceName } from './types-Su7QwloQ.js';
+import { b as ArcaServiceName } from './types-CbvsjIhf.js';
 
 /** Base error class for all ARCA-related errors. */
 declare class ArcaError extends Error {
@@ -11,6 +11,22 @@ declare class ArcaConfigurationError extends ArcaError {
     readonly name: string;
     constructor(message: string, options?: ErrorOptions);
 }
+/** Why a store lock was never taken: it stayed held, or the caller gave up. */
+type ArcaLockTimeoutReason = "held" | "aborted";
+/**
+ * Thrown when a call gave up waiting for a store lock. Nothing was sent to
+ * ARCA, and a call that waited for the sequence lock reserved nothing either,
+ * so the same call can be repeated. `held` means another holder kept the lock
+ * past the wait, `aborted` that the caller's `abortSignal` fired first.
+ */
+declare class ArcaLockTimeoutError extends ArcaError {
+    readonly code: "ARCA_LOCK_TIMEOUT";
+    readonly name: string;
+    readonly reason: ArcaLockTimeoutReason;
+    constructor(message: string, options: ErrorOptions & {
+        reason: ArcaLockTimeoutReason;
+    });
+}
 /** Stable routing codes for caller-provided input failures. */
 type ArcaInputErrorCode = "ARCA_INPUT_IDEMPOTENCY_MISMATCH" | "ARCA_INPUT_RESERVATION_NOT_FOUND" | "ARCA_INPUT_INVALID_DATE" | "ARCA_INPUT_DATE_OUTSIDE_WINDOW" | "ARCA_INPUT_INVALID_AMOUNT" | "ARCA_INPUT_AMOUNT_PRECISION" | "ARCA_INPUT_AMOUNT_MISMATCH" | "ARCA_INPUT_INVALID_EXCHANGE_RATE" | "ARCA_INPUT_INVALID_VALUE" | "ARCA_INPUT_MISSING_FIELD" | "ARCA_INPUT_RESERVED_FIELD";
 /** The first and last day ARCA accepts, both `YYYY-MM-DD` and inclusive. */
@@ -135,8 +151,8 @@ type ArcaSafeErrorMetadata = {
     contentType?: string;
     service?: ArcaServiceName;
     operation?: string;
-    /** ArcaAuthenticationError's stable reason. */
-    reason?: ArcaAuthenticationReason;
+    /** ArcaAuthenticationError's or ArcaLockTimeoutError's stable reason. */
+    reason?: ArcaAuthenticationReason | ArcaLockTimeoutReason;
     providerCode?: string | number;
     faultCode?: string;
     field?: string;
@@ -150,7 +166,7 @@ type ArcaSafeErrorMetadata = {
 declare function toArcaSafeErrorMetadata(error: unknown): ArcaSafeErrorMetadata;
 
 /** The ARCA service a call targets. It is chosen explicitly, never switched. */
-type IssuanceService = "wsfe" | "wsmtxca";
+type IssuanceService = "wsfe" | "wsmtxca" | "wsfex";
 /** Location of a structured authorization result in the service response. */
 type ArcaFiscalResultLevel = "header" | "detail" | "operation";
 /** Every structured result field exposed by one provider response. */
@@ -224,4 +240,4 @@ type ArcaVoucherLookupResult<TVoucher, TService extends IssuanceService = Issuan
     raw: Record<string, unknown>;
 };
 
-export { ArcaAuthenticationError as A, type IssuanceService as I, type VoucherDateWindow as V, type ArcaAuthenticationErrorOptions as a, type ArcaAuthenticationEvidence as b, type ArcaAuthenticationReason as c, type ArcaAuthorizationIndeterminateReason as d, type ArcaAuthorizationOutcome as e, ArcaConfigurationError as f, ArcaError as g, type ArcaFiscalIssue as h, type ArcaFiscalResultLevel as i, type ArcaFiscalResults as j, ArcaInputError as k, type ArcaInputErrorCode as l, type ArcaInputErrorOptions as m, ArcaInvalidSoapResponseError as n, type ArcaSafeErrorMetadata as o, ArcaServiceError as p, ArcaSoapFaultError as q, ArcaTransportError as r, type ArcaVoucherLookupResult as s, isArcaAuthenticationError as t, toArcaSafeErrorMetadata as u };
+export { ArcaAuthenticationError as A, type IssuanceService as I, type VoucherDateWindow as V, type ArcaAuthenticationErrorOptions as a, type ArcaAuthenticationEvidence as b, type ArcaAuthenticationReason as c, type ArcaAuthorizationIndeterminateReason as d, type ArcaAuthorizationOutcome as e, ArcaConfigurationError as f, ArcaError as g, type ArcaFiscalIssue as h, type ArcaFiscalResultLevel as i, type ArcaFiscalResults as j, ArcaInputError as k, type ArcaInputErrorCode as l, type ArcaInputErrorOptions as m, ArcaInvalidSoapResponseError as n, ArcaLockTimeoutError as o, type ArcaLockTimeoutReason as p, type ArcaSafeErrorMetadata as q, ArcaServiceError as r, ArcaSoapFaultError as s, ArcaTransportError as t, type ArcaVoucherLookupResult as u, isArcaAuthenticationError as v, toArcaSafeErrorMetadata as w };

package/dist/{index-DAC3edtw.d.ts → index-BSTxy3nN.d.ts}

@@ -1,4 +1,4 @@
-import { c as ArcaSoapExecutionOptions, d as ArcaSoapResponse, e as ArcaWsaaServiceId, f as ArcaAuthOptions, g as ArcaAuthCredentials } from './types-Su7QwloQ.js';
+import { c as ArcaSoapExecutionOptions, d as ArcaSoapResponse, e as ArcaWsaaServiceId, f as ArcaAuthOptions, g as ArcaAuthCredentials } from './types-CbvsjIhf.js';
 
 type SoapTransport = {
     execute<TBody, TResult>(request: ArcaSoapExecutionOptions<TBody>): Promise<ArcaSoapResponse<TResult>>;

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-export { a as ARCA_QR_URL, b as AmountItem, A as ArcaClient, c as ArcaClientConfigView, d as ArcaQrInput, e as ArcaQrPayload, C as CreditNoteInput, D as DebitNoteInput, F as FceOptions, f as FiscalHeader, I as InvoiceFamily, g as IssuanceFields, h as IssueAmounts, i as IssueCommon, j as IssueInput, k as IssueOptions, l as IssueOutcome, m as IssuePreview, n as IssueRequest, o as IssuedVoucher, p as ItemLine, N as NotePreview, P as PeriodNoteInput, q as PreviewOptions, R as Receiver, r as RecoveryOptions, T as Tribute, V as VatItem, s as VatRate, t as VoucherAmounts, u as VoucherCoordinates, v as VoucherDateWindowInput, w as VoucherSummary, x as VoucherTypeInfo, y as VouchersService, W as WsfeIdentityMatch, z as WsmtxcaIssueRequest, B as WsmtxcaLine, E as arcaQrPayload, G as arcaQrUrl, H as createArcaClient, J as describeVoucherType, K as matchWsfeVoucherIdentity, L as voucherDateWindow } from './client-BgWH_jKT.js';
-import { h as ArcaEnvironment, a as ArcaClientConfig, i as ArcaStore, j as ArcaWsaaSessionStore } from './types-Su7QwloQ.js';
-export { g as ArcaAuthCredentials, f as ArcaAuthOptions, A as ArcaClientConfig, k as ArcaLogLevel, l as ArcaLoggerConfig, m as ArcaPadronServiceName, n as ArcaRepresentedTaxId, b as ArcaServiceName, o as ArcaServiceTarget, e as ArcaWsaaServiceId, p as ArcaWsaaSessionKey } from './types-Su7QwloQ.js';
+export { a as ARCA_QR_URL, b as AmountItem, A as ArcaClient, c as ArcaClientConfigView, d as ArcaQrInput, e as ArcaQrPayload, C as CreateWsfexServiceOptions, f as CreditNoteInput, D as DebitNoteInput, E as ExportCreditNoteInput, g as ExportDebitNoteInput, h as ExportHeader, i as ExportIssueInput, j as ExportIssueOutcome, k as ExportIssueRequest, l as ExportIssuedVoucher, m as ExportItem, n as ExportOfGoods, o as ExportOfServices, p as ExportPreview, q as ExportReceiver, r as ExportVoucherSummary, s as ExportVoucherType, F as FceOptions, t as FiscalHeader, I as InvoiceFamily, u as IssuanceFields, v as IssueAmounts, w as IssueCommon, x as IssueInput, y as IssueOptions, z as IssueOutcome, B as IssuePreview, G as IssueRequest, H as IssuedVoucher, J as ItemLine, N as NotePreview, P as PeriodNoteInput, K as PreviewOptions, R as Receiver, L as RecoveryOptions, T as Tribute, V as VatItem, M as VatRate, O as VoucherAmounts, Q as VoucherCoordinates, S as VoucherDateWindowInput, U as VoucherSummary, W as VoucherTypeInfo, X as VouchersService, Y as WsfeIdentityMatch, Z as WsfexAssociatedVoucher, _ as WsfexAuthorizationOutcome, $ as WsfexCatalogEntry, a0 as WsfexCountryTaxId, a1 as WsfexExchangeRate, a2 as WsfexExportType, a3 as WsfexIssueInput, a4 as WsfexItem, a5 as WsfexLanguage, a6 as WsfexPermit, a7 as WsfexSalesPoint, a8 as WsfexService, a9 as WsfexVoucherInfo, aa as WsfexVoucherInput, ab as WsfexVoucherLookupResult, ac as WsfexVoucherType, ad as WsmtxcaIssueRequest, ae as WsmtxcaLine, af as arcaQrPayload, ag as arcaQrUrl, ah as createArcaClient, ai as createWsfexService, aj as describeVoucherType, ak as matchWsfeVoucherIdentity, al as voucherDateWindow } from './client-ghHzZdu8.js';
+import { h as ArcaEnvironment, a as ArcaClientConfig, i as ArcaStore, j as ArcaWsaaSessionStore } from './types-CbvsjIhf.js';
+export { g as ArcaAuthCredentials, f as ArcaAuthOptions, A as ArcaClientConfig, k as ArcaLockOptions, l as ArcaLogLevel, m as ArcaLoggerConfig, n as ArcaPadronServiceName, o as ArcaRepresentedTaxId, b as ArcaServiceName, p as ArcaServiceTarget, e as ArcaWsaaServiceId, q as ArcaWsaaSessionKey } from './types-CbvsjIhf.js';
 export { ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS, ARCA_INVOICE_CLASS_BY_ISSUER, ARCA_ISSUER_CONDITION_IDS, ARCA_RECEIVER_CONDITION_IDS, ARCA_WSMTXCA_GENERIC_CODES, IssuerCondition, IssuerConditionId, ReceiverCondition, VoucherClass } from './constants.js';
-export { A as ArcaAuthenticationError, a as ArcaAuthenticationErrorOptions, b as ArcaAuthenticationEvidence, c as ArcaAuthenticationReason, d as ArcaAuthorizationIndeterminateReason, e as ArcaAuthorizationOutcome, f as ArcaConfigurationError, g as ArcaError, h as ArcaFiscalIssue, i as ArcaFiscalResultLevel, j as ArcaFiscalResults, k as ArcaInputError, l as ArcaInputErrorCode, m as ArcaInputErrorOptions, n as ArcaInvalidSoapResponseError, o as ArcaSafeErrorMetadata, p as ArcaServiceError, q as ArcaSoapFaultError, r as ArcaTransportError, s as ArcaVoucherLookupResult, I as IssuanceService, V as VoucherDateWindow, t as isArcaAuthenticationError, u as toArcaSafeErrorMetadata } from './fiscal-evidence-Bg4o9nxt.js';
+export { A as ArcaAuthenticationError, a as ArcaAuthenticationErrorOptions, b as ArcaAuthenticationEvidence, c as ArcaAuthenticationReason, d as ArcaAuthorizationIndeterminateReason, e as ArcaAuthorizationOutcome, f as ArcaConfigurationError, g as ArcaError, h as ArcaFiscalIssue, i as ArcaFiscalResultLevel, j as ArcaFiscalResults, k as ArcaInputError, l as ArcaInputErrorCode, m as ArcaInputErrorOptions, n as ArcaInvalidSoapResponseError, o as ArcaLockTimeoutError, p as ArcaLockTimeoutReason, q as ArcaSafeErrorMetadata, r as ArcaServiceError, s as ArcaSoapFaultError, t as ArcaTransportError, u as ArcaVoucherLookupResult, I as IssuanceService, V as VoucherDateWindow, v as isArcaAuthenticationError, w as toArcaSafeErrorMetadata } from './fiscal-evidence-DjG8zB3o.js';
 export { CreatePadronServiceOptions, PadronActivity, PadronAddress, PadronService, PadronTax, PadronTaxIdLookupResult, PadronTaxpayerResult, createPadronService } from './padron.js';
 export { CreateWsfeServiceOptions, WsfeActivity, WsfeActivityType, WsfeAssociatedPeriod, WsfeAssociatedVoucher, WsfeAuthorizationOutcome, WsfeBuyer, WsfeCatalogEntry, WsfeCurrencyType, WsfeDateInput, WsfeIssueInput, WsfeOptionalField, WsfeQuotation, WsfeReceiverVatCondition, WsfeSalesPoint, WsfeServerStatus, WsfeService, WsfeTax, WsfeVatRate, WsfeVoucherInfo, WsfeVoucherInput, WsfeVoucherLookupResult, createWsfeService } from './wsfe.js';
 export { CreateWsmtxcaServiceOptions, WsmtxcaAuthorizationOutcome, WsmtxcaIssueInput, WsmtxcaLastAuthorizedVoucherResult, WsmtxcaSalesPoint, WsmtxcaSalesPointsResult, WsmtxcaService, WsmtxcaVoucherInfo, WsmtxcaVoucherLookupOutcome, createWsmtxcaService } from './wsmtxca.js';
-import './index-DAC3edtw.js';
+import './index-BSTxy3nN.js';
 
 /** Valid ARCA environment names. */
 declare const ARCA_ENVIRONMENTS: readonly ["production", "test"];

package/dist/index.mjs

@@ -3,6 +3,7 @@ import {
   ARCA_ENV_VARIABLES,
   ARCA_LEASE_MS,
   ARCA_QR_URL,
+  abortable,
   arcaQrPayload,
   arcaQrUrl,
   assertArcaClientConfig,
@@ -10,42 +11,45 @@ import {
   createArcaClientConfigFromEnv,
   createFileStore,
   createMemoryWsaaSessionStore,
+  createWsfexService,
   describeVoucherType,
   matchWsfeVoucherIdentity,
   storeCall,
+  throwIfAborted,
   voucherDateWindow,
   withLease
-} from "./chunk-KBEV7QTU.mjs";
+} from "./chunk-R4MOVPYT.mjs";
 import {
   ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS,
   ARCA_INVOICE_CLASS_BY_ISSUER,
   ARCA_ISSUER_CONDITION_IDS,
   ARCA_RECEIVER_CONDITION_IDS,
   ARCA_WSMTXCA_GENERIC_CODES
-} from "./chunk-C2KX652X.mjs";
+} from "./chunk-5CGIRDZY.mjs";
 import {
   createPadronService
-} from "./chunk-UOIZQMA6.mjs";
+} from "./chunk-FSJHE4VS.mjs";
 import {
   createWsfeService
-} from "./chunk-VEKUMXHW.mjs";
+} from "./chunk-67ISWKGE.mjs";
 import {
   createWsmtxcaService
-} from "./chunk-EXJMG54W.mjs";
-import "./chunk-YPQJRSTA.mjs";
-import "./chunk-B2M64SIK.mjs";
+} from "./chunk-GQGYO2Z2.mjs";
+import "./chunk-HLSFMWRT.mjs";
+import "./chunk-7MNVZSW6.mjs";
 import {
   ArcaAuthenticationError,
   ArcaConfigurationError,
   ArcaError,
   ArcaInputError,
   ArcaInvalidSoapResponseError,
+  ArcaLockTimeoutError,
   ArcaServiceError,
   ArcaSoapFaultError,
   ArcaTransportError,
   isArcaAuthenticationError,
   toArcaSafeErrorMetadata
-} from "./chunk-NT2A6YMO.mjs";
+} from "./chunk-Q7IURW54.mjs";
 
 // src/store/memory.ts
 function createMemoryStore() {
@@ -68,7 +72,8 @@ function createMemoryStore() {
       values.delete(key);
       return Promise.resolve();
     },
-    async withLock(key, fn) {
+    async withLock(key, fn, { signal } = {}) {
+      throwIfAborted(signal);
       const previous = locks.get(key) ?? Promise.resolve();
       let release = () => void 0;
       const current = new Promise((resolve) => {
@@ -76,7 +81,19 @@ function createMemoryStore() {
       });
       const queued = previous.catch(() => void 0).then(() => current);
       locks.set(key, queued);
-      await previous.catch(() => void 0);
+      await abortable(
+        previous.catch(() => void 0),
+        signal
+      ).catch(() => void 0);
+      if (signal?.aborted) {
+        release();
+        queued.then(() => {
+          if (locks.get(key) === queued) {
+            locks.delete(key);
+          }
+        });
+        throwIfAborted(signal);
+      }
       try {
         return await fn();
       } finally {
@@ -122,9 +139,8 @@ function createPostgresStore({
     async delete(key) {
       await run(`DELETE FROM ${name} WHERE key = $1`, [key]);
     },
-    withLock(key, fn) {
+    withLock(key, fn, options) {
       return withLease(
-        key,
         {
           async acquire(owner) {
             const taken = await run(
@@ -153,7 +169,8 @@ function createPostgresStore({
             ]);
           }
         },
-        fn
+        fn,
+        options
       );
     }
   };
@@ -200,8 +217,7 @@ function createRedisStore(client, options = {}) {
       delete: (key) => storeCall(async () => {
         await client.del?.(key);
       }),
-      withLock: (key, fn) => withLease(
-        key,
+      withLock: (key, fn, options2) => withLease(
         {
           acquire: (owner) => lease(key, owner, "nx"),
           renew: async (owner) => {
@@ -217,7 +233,8 @@ function createRedisStore(client, options = {}) {
             });
           }
         },
-        fn
+        fn,
+        options2
       )
     } : {}
   };
@@ -236,6 +253,7 @@ export {
   ArcaError,
   ArcaInputError,
   ArcaInvalidSoapResponseError,
+  ArcaLockTimeoutError,
   ArcaServiceError,
   ArcaSoapFaultError,
   ArcaTransportError,
@@ -251,6 +269,7 @@ export {
   createPostgresStore,
   createRedisStore,
   createWsfeService,
+  createWsfexService,
   createWsmtxcaService,
   describeVoucherType,
   isArcaAuthenticationError,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/store/memory.ts","../src/store/postgres.ts","../src/store/redis.ts"],"sourcesContent":["import type { ArcaStore } from \"./types\";\n\n/** In-process store for tests; reservations do not survive a restart. */\nexport function createMemoryStore(): ArcaStore {\n  const values = new Map<string, string>();\n  const locks = new Map<string, Promise<void>>();\n  return {\n    get: (key) => Promise.resolve(values.get(key) ?? null),\n    set(key, value) {\n      values.set(key, value);\n      return Promise.resolve();\n    },\n    add(key, value) {\n      if (values.has(key)) {\n        return Promise.resolve(false);\n      }\n      values.set(key, value);\n      return Promise.resolve(true);\n    },\n    delete(key) {\n      values.delete(key);\n      return Promise.resolve();\n    },\n    async withLock(key, fn) {\n      const previous = locks.get(key) ?? Promise.resolve();\n      let release: () => void = () => undefined;\n      const current = new Promise<void>((resolve) => {\n        release = resolve;\n      });\n      const queued = previous.catch(() => undefined).then(() => current);\n      locks.set(key, queued);\n      await previous.catch(() => undefined);\n      try {\n        return await fn();\n      } finally {\n        release();\n        if (locks.get(key) === queued) {\n          locks.delete(key);\n        }\n      }\n    },\n  };\n}\n","import { ArcaConfigurationError } from \"../errors\";\nimport { ARCA_LEASE_MS, withLease } from \"./lock\";\nimport { type ArcaStore, storeCall } from \"./types\";\n\ntype Row = { key?: string; value?: string };\n/** Uses the caller's SQL client; provision the table before use. */\nexport function createPostgresStore({\n  query,\n  table = \"arca_store\",\n}: {\n  query: (text: string, params: string[]) => Promise<Row[] | { rows: Row[] }>;\n  table?: string;\n}): ArcaStore {\n  if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {\n    throw new ArcaConfigurationError(\"Invalid ARCA store table identifier.\");\n  }\n  const name = `\"${table}\"`;\n  const lease = Math.round(ARCA_LEASE_MS / 1000);\n  const run = (text: string, params: string[]) =>\n    storeCall(async () => {\n      const result = await query(text, params);\n      return Array.isArray(result) ? result : result.rows;\n    });\n  return {\n    async get(key) {\n      return (\n        (await run(`SELECT value FROM ${name} WHERE key = $1`, [key]))[0]\n          ?.value ?? null\n      );\n    },\n    async set(key, value) {\n      await run(\n        `INSERT INTO ${name} (key, value) VALUES ($1, $2) ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, updated_at = now()`,\n        [key, value]\n      );\n    },\n    async add(key, value) {\n      return (\n        (\n          await run(\n            `INSERT INTO ${name} (key, value) VALUES ($1, $2) ON CONFLICT DO NOTHING RETURNING key`,\n            [key, value]\n          )\n        ).length > 0\n      );\n    },\n    async delete(key) {\n      await run(`DELETE FROM ${name} WHERE key = $1`, [key]);\n    },\n    withLock(key, fn) {\n      // A lease row, not an advisory lock: it survives a transaction-mode\n      // pooler, where a session-scoped lock would be taken on another backend.\n      return withLease(\n        key,\n        {\n          async acquire(owner) {\n            const taken = await run(\n              `INSERT INTO ${name} (key, value) VALUES ($1, $2) ON CONFLICT DO NOTHING RETURNING key`,\n              [key, owner]\n            );\n            if (taken.length > 0) {\n              return true;\n            }\n            const expired = await run(\n              `UPDATE ${name} SET value = $2, updated_at = now() WHERE key = $1 AND updated_at < now() - interval '${lease} seconds' RETURNING key`,\n              [key, owner]\n            );\n            return expired.length > 0;\n          },\n          async renew(owner) {\n            await run(\n              `UPDATE ${name} SET updated_at = now() WHERE key = $1 AND value = $2`,\n              [key, owner]\n            );\n          },\n          async release(owner) {\n            await run(`DELETE FROM ${name} WHERE key = $1 AND value = $2`, [\n              key,\n              owner,\n            ]);\n          },\n        },\n        fn\n      );\n    },\n  };\n}\n","import { ArcaConfigurationError } from \"../errors\";\nimport { ARCA_LEASE_MS, withLease } from \"./lock\";\nimport { type ArcaStore, storeCall } from \"./types\";\n\ntype RedisClient = {\n  get(key: string): Promise<unknown>;\n  set(key: string, value: string): Promise<unknown>;\n  call?(...args: string[]): Promise<unknown>;\n  del?(key: string): Promise<unknown>;\n};\n/** Uses ioredis or Upstash without importing either driver. */\nexport function createRedisStore(\n  client: RedisClient,\n  options: { flavor?: \"ioredis\" | \"upstash\" } = {}\n): ArcaStore {\n  const flavor =\n    options.flavor ??\n    (typeof client.call === \"function\" ? \"ioredis\" : \"upstash\");\n  if (flavor === \"ioredis\" && !client.call) {\n    throw new ArcaConfigurationError(\n      \"ARCA Redis ioredis flavor requires client.call.\"\n    );\n  }\n  // The public structural type accepts ioredis's overloaded set method.\n  // Only the Upstash flavor invokes its options-object overload.\n  const upstashSet = client.set as (\n    key: string,\n    value: string,\n    options: { nx?: true; xx?: true; px?: number }\n  ) => Promise<unknown>;\n  const read = async (key: string) => {\n    const value = await client.get(key);\n    if (value === null || value === undefined) {\n      return null;\n    }\n    // Upstash can deserialize stored JSON automatically.\n    return typeof value === \"string\" ? value : JSON.stringify(value);\n  };\n  // A lease, so a crashed holder frees the key; a renewal keeps a live one.\n  const lease = (key: string, owner: string, mode: \"nx\" | \"xx\") =>\n    storeCall(\n      async () =>\n        (flavor === \"ioredis\"\n          ? await client.call?.(\n              \"SET\",\n              key,\n              owner,\n              mode.toUpperCase(),\n              \"PX\",\n              String(ARCA_LEASE_MS)\n            )\n          : await upstashSet.call(client, key, owner, {\n              [mode]: true,\n              px: ARCA_LEASE_MS,\n            })) === \"OK\"\n    );\n  return {\n    get: (key) => storeCall(() => read(key)),\n    set: (key, value) =>\n      storeCall(async () => {\n        await client.set(key, value);\n      }),\n    add: (key, value) =>\n      storeCall(\n        async () =>\n          (flavor === \"ioredis\"\n            ? await client.call?.(\"SET\", key, value, \"NX\")\n            : await upstashSet.call(client, key, value, { nx: true })) === \"OK\"\n      ),\n    ...(client.del\n      ? {\n          delete: (key: string) =>\n            storeCall(async () => {\n              await client.del?.(key);\n            }),\n          withLock: <T>(key: string, fn: () => Promise<T>) =>\n            withLease(\n              key,\n              {\n                acquire: (owner) => lease(key, owner, \"nx\"),\n                renew: async (owner) => {\n                  // Check and set: only the holder extends its own lease.\n                  if ((await storeCall(() => read(key))) === owner) {\n                    await lease(key, owner, \"xx\");\n                  }\n                },\n                release: async (owner) => {\n                  await storeCall(async () => {\n                    if ((await read(key)) === owner) {\n                      await client.del?.(key);\n                    }\n                  });\n                },\n              },\n              fn\n            ),\n        }\n      : {}),\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/store/memory.ts","../src/store/postgres.ts","../src/store/redis.ts"],"sourcesContent":["import { abortable } from \"../internal/abort\";\nimport { throwIfAborted } from \"./lock\";\nimport type { ArcaStore } from \"./types\";\n\n/** In-process store for tests; reservations do not survive a restart. */\nexport function createMemoryStore(): ArcaStore {\n  const values = new Map<string, string>();\n  const locks = new Map<string, Promise<void>>();\n  return {\n    get: (key) => Promise.resolve(values.get(key) ?? null),\n    set(key, value) {\n      values.set(key, value);\n      return Promise.resolve();\n    },\n    add(key, value) {\n      if (values.has(key)) {\n        return Promise.resolve(false);\n      }\n      values.set(key, value);\n      return Promise.resolve(true);\n    },\n    delete(key) {\n      values.delete(key);\n      return Promise.resolve();\n    },\n    async withLock(key, fn, { signal } = {}) {\n      throwIfAborted(signal);\n      const previous = locks.get(key) ?? Promise.resolve();\n      let release: () => void = () => undefined;\n      const current = new Promise<void>((resolve) => {\n        release = resolve;\n      });\n      const queued = previous.catch(() => undefined).then(() => current);\n      locks.set(key, queued);\n      // An abort ends the wait early; the check below reports it.\n      await abortable(\n        previous.catch(() => undefined),\n        signal\n      ).catch(() => undefined);\n      if (signal?.aborted) {\n        // Hand the turn on, but keep this call's place until the holder\n        // before it finishes: a caller arriving now must still wait for it.\n        release();\n        queued.then(() => {\n          if (locks.get(key) === queued) {\n            locks.delete(key);\n          }\n        });\n        throwIfAborted(signal);\n      }\n      try {\n        return await fn();\n      } finally {\n        release();\n        if (locks.get(key) === queued) {\n          locks.delete(key);\n        }\n      }\n    },\n  };\n}\n","import { ArcaConfigurationError } from \"../errors\";\nimport { ARCA_LEASE_MS, withLease } from \"./lock\";\nimport { type ArcaStore, storeCall } from \"./types\";\n\ntype Row = { key?: string; value?: string };\n/** Uses the caller's SQL client; provision the table before use. */\nexport function createPostgresStore({\n  query,\n  table = \"arca_store\",\n}: {\n  query: (text: string, params: string[]) => Promise<Row[] | { rows: Row[] }>;\n  table?: string;\n}): ArcaStore {\n  if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(table)) {\n    throw new ArcaConfigurationError(\"Invalid ARCA store table identifier.\");\n  }\n  const name = `\"${table}\"`;\n  const lease = Math.round(ARCA_LEASE_MS / 1000);\n  const run = (text: string, params: string[]) =>\n    storeCall(async () => {\n      const result = await query(text, params);\n      return Array.isArray(result) ? result : result.rows;\n    });\n  return {\n    async get(key) {\n      return (\n        (await run(`SELECT value FROM ${name} WHERE key = $1`, [key]))[0]\n          ?.value ?? null\n      );\n    },\n    async set(key, value) {\n      await run(\n        `INSERT INTO ${name} (key, value) VALUES ($1, $2) ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, updated_at = now()`,\n        [key, value]\n      );\n    },\n    async add(key, value) {\n      return (\n        (\n          await run(\n            `INSERT INTO ${name} (key, value) VALUES ($1, $2) ON CONFLICT DO NOTHING RETURNING key`,\n            [key, value]\n          )\n        ).length > 0\n      );\n    },\n    async delete(key) {\n      await run(`DELETE FROM ${name} WHERE key = $1`, [key]);\n    },\n    withLock(key, fn, options) {\n      // A lease row, not an advisory lock: it survives a transaction-mode\n      // pooler, where a session-scoped lock would be taken on another backend.\n      return withLease(\n        {\n          async acquire(owner) {\n            const taken = await run(\n              `INSERT INTO ${name} (key, value) VALUES ($1, $2) ON CONFLICT DO NOTHING RETURNING key`,\n              [key, owner]\n            );\n            if (taken.length > 0) {\n              return true;\n            }\n            const expired = await run(\n              `UPDATE ${name} SET value = $2, updated_at = now() WHERE key = $1 AND updated_at < now() - interval '${lease} seconds' RETURNING key`,\n              [key, owner]\n            );\n            return expired.length > 0;\n          },\n          async renew(owner) {\n            await run(\n              `UPDATE ${name} SET updated_at = now() WHERE key = $1 AND value = $2`,\n              [key, owner]\n            );\n          },\n          async release(owner) {\n            await run(`DELETE FROM ${name} WHERE key = $1 AND value = $2`, [\n              key,\n              owner,\n            ]);\n          },\n        },\n        fn,\n        options\n      );\n    },\n  };\n}\n","import { ArcaConfigurationError } from \"../errors\";\nimport { ARCA_LEASE_MS, withLease } from \"./lock\";\nimport { type ArcaLockOptions, type ArcaStore, storeCall } from \"./types\";\n\ntype RedisClient = {\n  get(key: string): Promise<unknown>;\n  set(key: string, value: string): Promise<unknown>;\n  call?(...args: string[]): Promise<unknown>;\n  del?(key: string): Promise<unknown>;\n};\n/** Uses ioredis or Upstash without importing either driver. */\nexport function createRedisStore(\n  client: RedisClient,\n  options: { flavor?: \"ioredis\" | \"upstash\" } = {}\n): ArcaStore {\n  const flavor =\n    options.flavor ??\n    (typeof client.call === \"function\" ? \"ioredis\" : \"upstash\");\n  if (flavor === \"ioredis\" && !client.call) {\n    throw new ArcaConfigurationError(\n      \"ARCA Redis ioredis flavor requires client.call.\"\n    );\n  }\n  // The public structural type accepts ioredis's overloaded set method.\n  // Only the Upstash flavor invokes its options-object overload.\n  const upstashSet = client.set as (\n    key: string,\n    value: string,\n    options: { nx?: true; xx?: true; px?: number }\n  ) => Promise<unknown>;\n  const read = async (key: string) => {\n    const value = await client.get(key);\n    if (value === null || value === undefined) {\n      return null;\n    }\n    // Upstash can deserialize stored JSON automatically.\n    return typeof value === \"string\" ? value : JSON.stringify(value);\n  };\n  // A lease, so a crashed holder frees the key; a renewal keeps a live one.\n  const lease = (key: string, owner: string, mode: \"nx\" | \"xx\") =>\n    storeCall(\n      async () =>\n        (flavor === \"ioredis\"\n          ? await client.call?.(\n              \"SET\",\n              key,\n              owner,\n              mode.toUpperCase(),\n              \"PX\",\n              String(ARCA_LEASE_MS)\n            )\n          : await upstashSet.call(client, key, owner, {\n              [mode]: true,\n              px: ARCA_LEASE_MS,\n            })) === \"OK\"\n    );\n  return {\n    get: (key) => storeCall(() => read(key)),\n    set: (key, value) =>\n      storeCall(async () => {\n        await client.set(key, value);\n      }),\n    add: (key, value) =>\n      storeCall(\n        async () =>\n          (flavor === \"ioredis\"\n            ? await client.call?.(\"SET\", key, value, \"NX\")\n            : await upstashSet.call(client, key, value, { nx: true })) === \"OK\"\n      ),\n    ...(client.del\n      ? {\n          delete: (key: string) =>\n            storeCall(async () => {\n              await client.del?.(key);\n            }),\n          withLock: <T>(\n            key: string,\n            fn: () => Promise<T>,\n            options?: ArcaLockOptions\n          ) =>\n            withLease(\n              {\n                acquire: (owner) => lease(key, owner, \"nx\"),\n                renew: async (owner) => {\n                  // Check and set: only the holder extends its own lease.\n                  if ((await storeCall(() => read(key))) === owner) {\n                    await lease(key, owner, \"xx\");\n                  }\n                },\n                release: async (owner) => {\n                  await storeCall(async () => {\n                    if ((await read(key)) === owner) {\n                      await client.del?.(key);\n                    }\n                  });\n                },\n              },\n              fn,\n              options\n            ),\n        }\n      : {}),\n  };\n}\n"],"mappings":"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","names":["options"]}

package/dist/padron.d.ts

@@ -1,6 +1,6 @@
 import { ReceiverCondition } from './constants.js';
-import { a as ArcaClientConfig } from './types-Su7QwloQ.js';
-import { W as WsaaAuthModule, S as SoapTransport } from './index-DAC3edtw.js';
+import { a as ArcaClientConfig } from './types-CbvsjIhf.js';
+import { W as WsaaAuthModule, S as SoapTransport } from './index-BSTxy3nN.js';
 
 /** One tax registration reported by the constancia de inscripción. */
 type PadronTax = {

package/dist/padron.mjs

@@ -1,8 +1,8 @@
 import {
   createPadronService
-} from "./chunk-UOIZQMA6.mjs";
-import "./chunk-B2M64SIK.mjs";
-import "./chunk-NT2A6YMO.mjs";
+} from "./chunk-FSJHE4VS.mjs";
+import "./chunk-7MNVZSW6.mjs";
+import "./chunk-Q7IURW54.mjs";
 export {
   createPadronService
 };

package/dist/{types-Su7QwloQ.d.ts → types-CbvsjIhf.d.ts}

@@ -1,22 +1,31 @@
-/** Durable values. add must atomically create only when the key is absent. */
+/** What a caller may pass to `withLock`: a signal that stops the wait. */
+type ArcaLockOptions = {
+    signal?: AbortSignal;
+};
+/**
+ * Durable values. add must atomically create only when the key is absent.
+ * withLock runs `fn` exclusively across processes. `options.signal` only stops
+ * the wait: an abort before the lock is taken throws `ArcaLockTimeoutError`
+ * with `reason: "aborted"` and never runs `fn`.
+ */
 type ArcaStore = {
     get(key: string): Promise<string | null>;
     set(key: string, value: string): Promise<void>;
     add(key: string, value: string): Promise<boolean>;
     delete?(key: string): Promise<void>;
-    withLock?<T>(key: string, fn: () => Promise<T>): Promise<T>;
+    withLock?<T>(key: string, fn: () => Promise<T>, options?: ArcaLockOptions): Promise<T>;
 };
 
 /** Target environment for ARCA services. */
 type ArcaEnvironment = "production" | "test";
 /** All ARCA service identifiers, including WSAA. */
-type ArcaServiceName = "wsaa" | "wsfe" | "wsmtxca" | "padron-a5" | "padron-a13";
+type ArcaServiceName = "wsaa" | "wsfe" | "wsfex" | "wsmtxca" | "padron-a5" | "padron-a13";
 /** ARCA service identifiers excluding the WSAA authentication service. */
 type ArcaServiceTarget = Exclude<ArcaServiceName, "wsaa">;
 /** Padron-specific service identifiers. */
 type ArcaPadronServiceName = Extract<ArcaServiceTarget, "padron-a5" | "padron-a13">;
 /** WSAA service identifiers used for authentication scoping. */
-type ArcaWsaaServiceId = "wsfe" | "wsmtxca" | "ws_sr_constancia_inscripcion" | "ws_sr_padron_a13";
+type ArcaWsaaServiceId = "wsfe" | "wsfex" | "wsmtxca" | "ws_sr_constancia_inscripcion" | "ws_sr_padron_a13";
 type ArcaLogLevel = "debug" | "info" | "warn" | "error";
 type ArcaLoggerConfig = {
     disabled?: boolean;
@@ -78,4 +87,4 @@ type ArcaSoapExecutionOptions<TBody> = {
 };
 type ArcaClientOptions = Omit<ArcaClientConfig, "taxId" | "certificatePem" | "privateKeyPem" | "environment"> & Partial<Pick<ArcaClientConfig, "taxId" | "certificatePem" | "privateKeyPem" | "environment">>;
 
-export type { ArcaClientOptions as A, ArcaClientConfig as a, ArcaServiceName as b, ArcaSoapExecutionOptions as c, ArcaSoapResponse as d, ArcaWsaaServiceId as e, ArcaAuthOptions as f, ArcaAuthCredentials as g, ArcaEnvironment as h, ArcaStore as i, ArcaWsaaSessionStore as j, ArcaLogLevel as k, ArcaLoggerConfig as l, ArcaPadronServiceName as m, ArcaRepresentedTaxId as n, ArcaServiceTarget as o, ArcaWsaaSessionKey as p };
+export type { ArcaClientOptions as A, ArcaClientConfig as a, ArcaServiceName as b, ArcaSoapExecutionOptions as c, ArcaSoapResponse as d, ArcaWsaaServiceId as e, ArcaAuthOptions as f, ArcaAuthCredentials as g, ArcaEnvironment as h, ArcaStore as i, ArcaWsaaSessionStore as j, ArcaLockOptions as k, ArcaLogLevel as l, ArcaLoggerConfig as m, ArcaPadronServiceName as n, ArcaRepresentedTaxId as o, ArcaServiceTarget as p, ArcaWsaaSessionKey as q };

package/dist/types.d.ts

@@ -1 +1 @@
-export { g as ArcaAuthCredentials, f as ArcaAuthOptions, A as ArcaClientConfig, h as ArcaEnvironment, k as ArcaLogLevel, l as ArcaLoggerConfig, m as ArcaPadronServiceName, n as ArcaRepresentedTaxId, b as ArcaServiceName, o as ArcaServiceTarget, e as ArcaWsaaServiceId, p as ArcaWsaaSessionKey, j as ArcaWsaaSessionStore } from './types-Su7QwloQ.js';
+export { g as ArcaAuthCredentials, f as ArcaAuthOptions, A as ArcaClientConfig, h as ArcaEnvironment, l as ArcaLogLevel, m as ArcaLoggerConfig, n as ArcaPadronServiceName, o as ArcaRepresentedTaxId, b as ArcaServiceName, p as ArcaServiceTarget, e as ArcaWsaaServiceId, q as ArcaWsaaSessionKey, j as ArcaWsaaSessionStore } from './types-CbvsjIhf.js';

package/dist/wsfe.d.ts

@@ -1,6 +1,6 @@
-import { a as ArcaClientConfig } from './types-Su7QwloQ.js';
-import { W as WsaaAuthModule, S as SoapTransport } from './index-DAC3edtw.js';
-import { e as ArcaAuthorizationOutcome, s as ArcaVoucherLookupResult } from './fiscal-evidence-Bg4o9nxt.js';
+import { a as ArcaClientConfig } from './types-CbvsjIhf.js';
+import { W as WsaaAuthModule, S as SoapTransport } from './index-BSTxy3nN.js';
+import { e as ArcaAuthorizationOutcome, u as ArcaVoucherLookupResult } from './fiscal-evidence-DjG8zB3o.js';
 
 /** Accepted public date inputs for WSFE request fields. */
 type WsfeDateInput = `${number}${number}${number}${number}-${number}${number}-${number}${number}` | `${number}${number}${number}${number}${number}${number}${number}${number}`;

package/dist/wsfe.mjs

@@ -1,9 +1,9 @@
 import {
   createWsfeService
-} from "./chunk-VEKUMXHW.mjs";
-import "./chunk-YPQJRSTA.mjs";
-import "./chunk-B2M64SIK.mjs";
-import "./chunk-NT2A6YMO.mjs";
+} from "./chunk-67ISWKGE.mjs";
+import "./chunk-HLSFMWRT.mjs";
+import "./chunk-7MNVZSW6.mjs";
+import "./chunk-Q7IURW54.mjs";
 export {
   createWsfeService
 };

package/dist/wsmtxca.d.ts

@@ -1,6 +1,6 @@
-import { n as ArcaRepresentedTaxId, a as ArcaClientConfig } from './types-Su7QwloQ.js';
-import { W as WsaaAuthModule, S as SoapTransport } from './index-DAC3edtw.js';
-import { e as ArcaAuthorizationOutcome, s as ArcaVoucherLookupResult } from './fiscal-evidence-Bg4o9nxt.js';
+import { o as ArcaRepresentedTaxId, a as ArcaClientConfig } from './types-CbvsjIhf.js';
+import { W as WsaaAuthModule, S as SoapTransport } from './index-BSTxy3nN.js';
+import { e as ArcaAuthorizationOutcome, u as ArcaVoucherLookupResult } from './fiscal-evidence-DjG8zB3o.js';
 
 /** Input for {@link WsmtxcaService.issue}: one WSMTXCA voucher request. */
 type WsmtxcaIssueInput = {

package/dist/wsmtxca.mjs

@@ -1,9 +1,9 @@
 import {
   createWsmtxcaService
-} from "./chunk-EXJMG54W.mjs";
-import "./chunk-YPQJRSTA.mjs";
-import "./chunk-B2M64SIK.mjs";
-import "./chunk-NT2A6YMO.mjs";
+} from "./chunk-GQGYO2Z2.mjs";
+import "./chunk-HLSFMWRT.mjs";
+import "./chunk-7MNVZSW6.mjs";
+import "./chunk-Q7IURW54.mjs";
 export {
   createWsmtxcaService
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "facturas",
-  "version": "0.20.5",
+  "version": "0.22.0",
   "description": "SDK de TypeScript para facturación electrónica con ARCA / AFIP: facturas, notas de crédito y débito, y Padrón con una sola API.",
   "type": "module",
   "license": "Apache-2.0",

package/dist/chunk-B2M64SIK.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/internal/authentication.ts"],"sourcesContent":["import {\n  ArcaAuthenticationError,\n  type ArcaAuthenticationReason,\n  ArcaServiceError,\n  ArcaSoapFaultError,\n  isArcaAuthenticationError,\n} from \"../errors\";\nimport type {\n  ArcaAuthenticationEvidence,\n  ArcaFiscalIssue,\n} from \"../services/fiscal-evidence\";\nimport type { ArcaServiceName } from \"./types\";\n\ntype AuthenticationContext = {\n  service: ArcaServiceName;\n  operation: string;\n};\n\ntype AuthenticationCandidate = AuthenticationContext & {\n  providerCode?: string | number;\n  message?: string;\n  cause?: unknown;\n};\n\ntype AuthenticationRecoveryOptions<T> = AuthenticationContext & {\n  forceRefresh?: boolean;\n  allowRetry?: boolean;\n  execute(forceRefresh?: boolean): Promise<T>;\n};\n\nconst WSFE_AUTHENTICATION_CODES: Readonly<\n  Record<string, ArcaAuthenticationReason>\n> = {\n  \"600\": \"invalid_token\",\n  \"601\": \"missing_relationship\",\n};\n\n/** Classifies one safe provider code/message pair without inspecting object graphs. */\nexport function classifyArcaAuthenticationCandidate(\n  candidate: AuthenticationCandidate\n): ArcaAuthenticationError | undefined {\n  const providerCode = normalizeProviderCode(candidate.providerCode);\n  const reason =\n    getStructuredAuthenticationReason(candidate.service, providerCode) ??\n    getTextAuthenticationReason(candidate.message);\n\n  if (!reason) {\n    return undefined;\n  }\n\n  return new ArcaAuthenticationError(\n    formatAuthenticationMessage(candidate.service, candidate.operation, reason),\n    {\n      reason,\n      service: candidate.service,\n      operation: candidate.operation,\n      ...(providerCode === undefined ? {} : { providerCode }),\n      ...(candidate.cause === undefined ? {} : { cause: candidate.cause }),\n    }\n  );\n}\n\n/** Classifies supported public ARCA errors while ignoring arbitrary errors and causes. */\nexport function classifyArcaAuthenticationError(\n  error: unknown,\n  context: AuthenticationContext\n): ArcaAuthenticationError | undefined {\n  if (isArcaAuthenticationError(error)) {\n    return error;\n  }\n\n  if (error instanceof ArcaSoapFaultError) {\n    return classifyArcaAuthenticationCandidate({\n      ...context,\n      providerCode: error.faultCode,\n      message: error.message,\n      cause: error,\n    });\n  }\n\n  if (error instanceof ArcaServiceError) {\n    const issueError = classifyArcaAuthenticationIssues(\n      error.issues ?? [],\n      context\n    );\n    if (issueError) {\n      return new ArcaAuthenticationError(issueError.message, {\n        reason: issueError.reason,\n        service: issueError.service,\n        operation: issueError.operation,\n        ...(issueError.providerCode === undefined\n          ? {}\n          : { providerCode: issueError.providerCode }),\n        cause: error,\n      });\n    }\n\n    return classifyArcaAuthenticationCandidate({\n      ...context,\n      providerCode: error.serviceCode,\n      message: error.message,\n      cause: error,\n    });\n  }\n\n  return undefined;\n}\n\n/** Classifies structured service issues in provider order. */\nexport function classifyArcaAuthenticationIssues(\n  issues: readonly ArcaFiscalIssue[],\n  context: AuthenticationContext\n): ArcaAuthenticationError | undefined {\n  for (const issue of issues) {\n    const authenticationError = classifyArcaAuthenticationCandidate({\n      ...context,\n      providerCode: issue.code,\n      message: issue.message,\n    });\n    if (authenticationError) {\n      return authenticationError;\n    }\n  }\n  return undefined;\n}\n\n/** Converts the public error to safe serializable exact-attempt evidence. */\nexport function createArcaAuthenticationEvidence(\n  error: ArcaAuthenticationError\n): ArcaAuthenticationEvidence {\n  return {\n    code: \"ARCA_AUTHENTICATION_ERROR\",\n    reason: error.reason,\n    ...(error.providerCode === undefined\n      ? {}\n      : { providerCode: error.providerCode }),\n  };\n}\n\n/** Recreates the throwable contract from safe exact-attempt evidence. */\nexport function createArcaAuthenticationErrorFromEvidence(\n  evidence: ArcaAuthenticationEvidence,\n  context: AuthenticationContext\n): ArcaAuthenticationError {\n  return new ArcaAuthenticationError(\n    formatAuthenticationMessage(\n      context.service,\n      context.operation,\n      evidence.reason\n    ),\n    {\n      reason: evidence.reason,\n      service: context.service,\n      operation: context.operation,\n      ...(evidence.providerCode === undefined\n        ? {}\n        : { providerCode: evidence.providerCode }),\n    }\n  );\n}\n\n/** Runs one convenience operation and permits one proven-safe forced refresh. */\nexport async function executeWithAuthenticationRecovery<T>(\n  options: AuthenticationRecoveryOptions<T>\n): Promise<T> {\n  const executeAttempt = async (forceRefresh?: boolean): Promise<T> => {\n    try {\n      return await options.execute(forceRefresh);\n    } catch (error) {\n      throw classifyArcaAuthenticationError(error, options) ?? error;\n    }\n  };\n\n  try {\n    return await executeAttempt(options.forceRefresh);\n  } catch (error) {\n    const allowRetry =\n      options.allowRetry !== false && options.forceRefresh !== true;\n    if (!(allowRetry && isArcaAuthenticationError(error))) {\n      throw error;\n    }\n    return executeAttempt(true);\n  }\n}\n\nfunction getStructuredAuthenticationReason(\n  service: ArcaServiceName,\n  providerCode: string | number | undefined\n): ArcaAuthenticationReason | undefined {\n  if (service !== \"wsfe\" || providerCode === undefined) {\n    return undefined;\n  }\n  return WSFE_AUTHENTICATION_CODES[String(providerCode).trim()];\n}\n\nfunction getTextAuthenticationReason(\n  message: string | undefined\n): ArcaAuthenticationReason | undefined {\n  if (!message) {\n    return undefined;\n  }\n  const normalized = normalizeAuthenticationText(message);\n\n  if (\n    includesWholePhrase(\n      normalized,\n      \"no aparecio cuit en lista de relaciones\"\n    ) ||\n    includesWholePhrase(normalized, \"cuit representada no incluida en token\")\n  ) {\n    return \"missing_relationship\";\n  }\n  if (includesWholePhrase(normalized, \"computador no autorizado\")) {\n    return \"unauthorized_computer\";\n  }\n  if (\n    includesWholePhrase(normalized, \"validaciondetoken\") ||\n    includesWholePhrase(normalized, \"token vencido\") ||\n    includesWholePhrase(normalized, \"no se corresponden token y firma\")\n  ) {\n    return \"invalid_token\";\n  }\n  if (\n    includesWholePhrase(normalized, \"no autorizado a acceder al servicio\") ||\n    includesWholePhrase(normalized, \"no autorizado a acceder a los servicios\")\n  ) {\n    return \"authentication_rejected\";\n  }\n  return undefined;\n}\n\nfunction normalizeAuthenticationText(value: string): string {\n  return value\n    .normalize(\"NFD\")\n    .replace(/\\p{Diacritic}/gu, \"\")\n    .toLowerCase()\n    .replace(/\\s+/g, \" \")\n    .trim();\n}\n\nfunction includesWholePhrase(value: string, phrase: string): boolean {\n  let searchFrom = 0;\n  while (searchFrom <= value.length - phrase.length) {\n    const index = value.indexOf(phrase, searchFrom);\n    if (index < 0) {\n      return false;\n    }\n    const before = value[index - 1];\n    const after = value[index + phrase.length];\n    if (!(isWordCharacter(before) || isWordCharacter(after))) {\n      return true;\n    }\n    searchFrom = index + phrase.length;\n  }\n  return false;\n}\n\nfunction isWordCharacter(value: string | undefined): boolean {\n  return value !== undefined && /[a-z0-9]/.test(value);\n}\n\nfunction normalizeProviderCode(\n  providerCode: string | number | undefined\n): string | number | undefined {\n  if (typeof providerCode === \"number\") {\n    return Number.isFinite(providerCode) ? providerCode : undefined;\n  }\n  if (typeof providerCode === \"string\") {\n    const normalized = providerCode.trim();\n    return normalized || undefined;\n  }\n  return undefined;\n}\n\nfunction formatAuthenticationMessage(\n  service: ArcaServiceName,\n  operation: string,\n  reason: ArcaAuthenticationReason\n): string {\n  const descriptions: Record<ArcaAuthenticationReason, string> = {\n    invalid_token: \"the token or signature was rejected\",\n    unauthorized_computer: \"the certificate or computer is not authorized\",\n    missing_relationship: \"the represented taxpayer relationship is missing\",\n    authentication_rejected: \"the service denied authenticated access\",\n  };\n  return `ARCA rejected authentication for ${service}.${operation}: ${descriptions[reason]}.`;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-C2KX652X.mjs.map

@@ -1 +0,0 @@
-{"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 * ARCA's generic WSMTXCA item codes, keyed by the `matrixCode` to send.\n * RG 2904, Anexo VII: for concepts outside the issuer's main line of goods,\n * which carry their GTIN instead. Samples and promotional material use\n * `7790001001054` (Ventas varias).\n * https://www.afip.gob.ar/fe/documentos/codigosGenericosYEspecificos.xls\n */\nexport const ARCA_WSMTXCA_GENERIC_CODES = {\n  \"7790001001030\": \"Descuentos y bonificaciones comerciales\",\n  \"7790001001047\": \"Conceptos financieros\",\n  \"7790001001054\": \"Ventas varias\",\n  \"7790001001061\": \"Bienes de uso\",\n  \"7790001001078\": \"Servicios prestados\",\n  \"7790001001085\": \"Fletes\",\n  \"7790001001092\": \"Alquileres\",\n  \"7790001001115\": \"Depósito y servicios de logística\",\n  \"7790001001122\": \"Repuestos y accesorios\",\n  \"7790001001139\": \"Ajustes impositivos\",\n  \"7790001001146\": \"Actividades comerciales no codificadas\",\n  \"7790001001153\": \"Venta de material de rezago\",\n  \"7790001001856\": \"Anticipos y señas\",\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/** ISO currency codes accepted by the high-level WSFE builders. */\nexport const ISO_CURRENCIES = {\n  ARS: \"ARS\",\n  USD: \"USD\",\n} as const;\n\n/** ARCA currency identifiers keyed by their corresponding ISO currency. */\nexport const ARCA_CURRENCY_IDS = {\n  ARS: \"PES\",\n  USD: \"DOL\",\n} as const;\n\n/** Legal assertions supported by the invoice high-level API; never inferred from Padrón. */\nexport type IssuerCondition =\n  | \"responsable_inscripto\"\n  | \"monotributo\"\n  | \"exento\"\n  | \"no_alcanzado\";\nexport type ReceiverCondition = IssuerCondition | \"consumidor_final\";\nexport type VoucherClass = \"A\" | \"B\" | \"C\";\n\nexport const ARCA_RECEIVER_CONDITION_IDS = {\n  responsable_inscripto: ARCA_RECEIVER_VAT_CONDITIONS.RESPONSABLE_INSCRIPTO,\n  monotributo: ARCA_RECEIVER_VAT_CONDITIONS.MONOTRIBUTISTA,\n  exento: ARCA_RECEIVER_VAT_CONDITIONS.EXENTO,\n  consumidor_final: ARCA_RECEIVER_VAT_CONDITIONS.CONSUMIDOR_FINAL,\n  no_alcanzado: ARCA_RECEIVER_VAT_CONDITIONS.IVA_NO_ALCANZADO,\n} as const satisfies Record<ReceiverCondition, number>;\n\nexport const ARCA_ISSUER_CONDITION_IDS = {\n  responsable_inscripto: 1,\n  monotributo: 6,\n  exento: 4,\n  no_alcanzado: 15,\n} as const satisfies Record<IssuerCondition, number>;\n\n/** The ARCA identifier of each issuer condition, accepted wherever a name is. */\nexport type IssuerConditionId =\n  (typeof ARCA_ISSUER_CONDITION_IDS)[IssuerCondition];\n\n// RG 5866/2026, art. 1(f), effective 2026-07-01 (art. 4).\n// https://www.argentina.gob.ar/normativa/nacional/norma-427092/texto\nexport const ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS =\n  1_000_000_000n;\n\n// WSFE v4.7, physical PDF p. 203, validations 10243/10246; issuer asserted first.\n// ARCA checks actual issuer eligibility independently at authorization.\nexport const ARCA_INVOICE_CLASS_BY_ISSUER = {\n  responsable_inscripto: {\n    responsable_inscripto: \"A\",\n    monotributo: \"A\",\n    exento: \"B\",\n    consumidor_final: \"B\",\n    no_alcanzado: \"B\",\n  },\n  monotributo: {\n    responsable_inscripto: \"C\",\n    monotributo: \"C\",\n    exento: \"C\",\n    consumidor_final: \"C\",\n    no_alcanzado: \"C\",\n  },\n  exento: {\n    responsable_inscripto: \"C\",\n    monotributo: \"C\",\n    exento: \"C\",\n    consumidor_final: \"C\",\n    no_alcanzado: \"C\",\n  },\n  no_alcanzado: {\n    responsable_inscripto: \"C\",\n    monotributo: \"C\",\n    exento: \"C\",\n    consumidor_final: \"C\",\n    no_alcanzado: \"C\",\n  },\n} as const satisfies Record<\n  IssuerCondition,\n  Record<ReceiverCondition, VoucherClass>\n>;\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;AASO,IAAM,6BAA6B;AAAA,EACxC,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,iBAAiB;AACnB;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,iBAAiB;AAAA,EAC5B,KAAK;AAAA,EACL,KAAK;AACP;AAGO,IAAM,oBAAoB;AAAA,EAC/B,KAAK;AAAA,EACL,KAAK;AACP;AAWO,IAAM,8BAA8B;AAAA,EACzC,uBAAuB,6BAA6B;AAAA,EACpD,aAAa,6BAA6B;AAAA,EAC1C,QAAQ,6BAA6B;AAAA,EACrC,kBAAkB,6BAA6B;AAAA,EAC/C,cAAc,6BAA6B;AAC7C;AAEO,IAAM,4BAA4B;AAAA,EACvC,uBAAuB;AAAA,EACvB,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,cAAc;AAChB;AAQO,IAAM,2DACX;AAIK,IAAM,+BAA+B;AAAA,EAC1C,uBAAuB;AAAA,IACrB,uBAAuB;AAAA,IACvB,aAAa;AAAA,IACb,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,cAAc;AAAA,EAChB;AAAA,EACA,aAAa;AAAA,IACX,uBAAuB;AAAA,IACvB,aAAa;AAAA,IACb,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,cAAc;AAAA,EAChB;AAAA,EACA,QAAQ;AAAA,IACN,uBAAuB;AAAA,IACvB,aAAa;AAAA,IACb,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,cAAc;AAAA,EAChB;AAAA,EACA,cAAc;AAAA,IACZ,uBAAuB;AAAA,IACvB,aAAa;AAAA,IACb,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,cAAc;AAAA,EAChB;AACF;","names":[]}