facturas 0.18.0 → 0.20.0

package/dist/{chunk-4RD5VQWC.mjs → chunk-TMSP5QPZ.mjs}

@@ -3,14 +3,14 @@ import {
   classifyArcaAuthenticationIssues,
   createArcaAuthenticationEvidence,
   executeWithAuthenticationRecovery
-} from "./chunk-WPHD2GQJ.mjs";
+} from "./chunk-B2M64SIK.mjs";
 import {
   ArcaInputError,
   ArcaInvalidSoapResponseError,
   ArcaServiceError,
   ArcaSoapFaultError,
   ArcaTransportError
-} from "./chunk-EZ4HA3LC.mjs";
+} from "./chunk-NT2A6YMO.mjs";
 
 // src/services/wsmtxca.ts
 function createWsmtxcaService(options) {
@@ -631,4 +631,4 @@ function formatCompactDateToIso(dateValue) {
 export {
   createWsmtxcaService
 };
-//# sourceMappingURL=chunk-4RD5VQWC.mjs.map
+//# sourceMappingURL=chunk-TMSP5QPZ.mjs.map

package/dist/{chunk-OORNZFI5.mjs → chunk-TXFYTMO4.mjs}

@@ -3,14 +3,14 @@ import {
   classifyArcaAuthenticationIssues,
   createArcaAuthenticationEvidence,
   executeWithAuthenticationRecovery
-} from "./chunk-WPHD2GQJ.mjs";
+} from "./chunk-B2M64SIK.mjs";
 import {
   ArcaInputError,
   ArcaInvalidSoapResponseError,
   ArcaServiceError,
   ArcaSoapFaultError,
   ArcaTransportError
-} from "./chunk-EZ4HA3LC.mjs";
+} from "./chunk-NT2A6YMO.mjs";
 
 // src/internal/dates.ts
 function toIsoDate(value) {
@@ -1461,4 +1461,4 @@ export {
   normalizeWsfeVoucherInput,
   normalizeWsfeDateInput
 };
-//# sourceMappingURL=chunk-OORNZFI5.mjs.map
+//# sourceMappingURL=chunk-TXFYTMO4.mjs.map

package/dist/cli.d.ts

@@ -1,9 +1,9 @@
-import { A as ArcaClient } from './client-COK5u3oz.js';
+import { A as ArcaClient } from './client-BIkLOgBA.js';
 import { A as ArcaClientOptions, a as ArcaClientConfig } from './types-Su7QwloQ.js';
 import { W as WsaaAuthModule } from './index-DAC3edtw.js';
 import './padron.js';
 import './constants.js';
-import './fiscal-evidence-B6UTFGmY.js';
+import './fiscal-evidence-Bg4o9nxt.js';
 import './wsfe.js';
 import './wsmtxca.js';
 

package/dist/cli.mjs

@@ -7,12 +7,12 @@ import {
   createWsaaAuthModule,
   createWsaaStoreAdapter,
   discoverArcaClientConfig
-} from "./chunk-JP5IBMVI.mjs";
-import "./chunk-DHN6OQJP.mjs";
-import "./chunk-MRBFLBWX.mjs";
-import "./chunk-OORNZFI5.mjs";
-import "./chunk-4RD5VQWC.mjs";
-import "./chunk-WPHD2GQJ.mjs";
+} from "./chunk-T5N62FRZ.mjs";
+import "./chunk-C2KX652X.mjs";
+import "./chunk-JP3LVU7K.mjs";
+import "./chunk-TXFYTMO4.mjs";
+import "./chunk-TMSP5QPZ.mjs";
+import "./chunk-B2M64SIK.mjs";
 import {
   ArcaConfigurationError,
   ArcaServiceError,
@@ -20,7 +20,7 @@ import {
   ArcaTransportError,
   isArcaAuthenticationError,
   toArcaSafeErrorMetadata
-} from "./chunk-EZ4HA3LC.mjs";
+} from "./chunk-NT2A6YMO.mjs";
 
 // src/cli/main.ts
 import { tmpdir } from "os";

package/dist/{client-COK5u3oz.d.ts → client-BIkLOgBA.d.ts}

@@ -1,8 +1,8 @@
 import { h as ArcaEnvironment, A as ArcaClientOptions } from './types-Su7QwloQ.js';
 import { PadronService } from './padron.js';
-import { e as ArcaAuthorizationOutcome, I as IssuanceService, h as ArcaFiscalIssue, o as ArcaSafeErrorMetadata } from './fiscal-evidence-B6UTFGmY.js';
+import { e as ArcaAuthorizationOutcome, I as IssuanceService, h as ArcaFiscalIssue, o as ArcaSafeErrorMetadata, V as VoucherDateWindow } from './fiscal-evidence-Bg4o9nxt.js';
 import { WsfeVoucherInput, WsfeVoucherInfo, WsfeDateInput, WsfeService } from './wsfe.js';
-import { VoucherClass, ReceiverCondition, IssuerCondition } from './constants.js';
+import { VoucherClass, ReceiverCondition, IssuerCondition, IssuerConditionId } from './constants.js';
 import { WsmtxcaService } from './wsmtxca.js';
 
 type VoucherCoordinates = {
@@ -165,28 +165,75 @@ declare function wsmtxcaRequest(data: FiscalHeader$1, number?: number): {
         fechaServicioHasta: string | undefined;
         fechaVencimientoPago: string | undefined;
         importeOtrosTributos?: number | undefined;
-        fechaEmision: string | undefined;
-        codigoTipoDocumento: number;
-        numeroDocumento: number;
         condicionIVAReceptor: number;
         importeGravado: number;
         importeNoGravado: number;
         importeExento: number;
         importeSubtotal: number;
+        codigoTipoDocumento: number | undefined;
+        numeroDocumento: number | undefined;
+        fechaEmision: string | undefined;
         numeroComprobante?: number | undefined;
         codigoTipoComprobante: number;
         numeroPuntoVenta: number;
     };
 };
 
+/** Where every printed voucher's QR points, per ARCA's QR specification v1. */
+declare const ARCA_QR_URL = "https://www.arca.gob.ar/fe/qr/";
+/** What the QR of a printed voucher encodes. Amounts are minor units. */
+type ArcaQrInput = {
+    /** The issuer's CUIT. */
+    taxId: number | string;
+    salesPoint: number;
+    voucherType: number;
+    number: number;
+    /** `YYYY-MM-DD` or `YYYYMMDD`. */
+    date: string;
+    /** The total in the voucher's currency, in minor units. */
+    total: number;
+    /** ARCA currency id; `PES` when omitted. */
+    currency?: string;
+    /** Pesos per unit of `currency`; 1 for pesos. */
+    exchangeRate?: number | string;
+    /** The CAE, or the CAEA when `authorization` is `"CAEA"`. */
+    cae: string;
+    authorization?: "CAE" | "CAEA";
+    /** The receiver's document. Omitted, or type 99, means an unidentified consumidor final. */
+    document?: {
+        type: number;
+        number: number | string;
+    };
+};
+/** The JSON the QR carries, in the field order of ARCA's specification. */
+type ArcaQrPayload = {
+    ver: 1;
+    fecha: string;
+    cuit: number;
+    ptoVta: number;
+    tipoCmp: number;
+    nroCmp: number;
+    importe: number;
+    moneda: string;
+    ctz: number;
+    tipoDocRec?: number;
+    nroDocRec?: number;
+    tipoCodAut: "E" | "A";
+    codAut: number;
+};
+/** Builds the URL a printed voucher's QR must encode. Pure, no I/O. */
+declare function arcaQrUrl(input: ArcaQrInput): string;
+declare function arcaQrPayload(input: ArcaQrInput): ArcaQrPayload;
+
 declare const SUPPORTED_VAT_RATES: readonly [0, 2.5, 5, 10.5, 21, 27];
 type SupportedVatRate = (typeof SUPPORTED_VAT_RATES)[number];
 
 /**
  * The line an item describes. WSFE ignores every field here and derives its
  * header from the money alone; WSMTXCA requires `description`, `quantity`,
- * `unit` and `unitPrice` and sends the line as it is. The line never carries
- * its own VAT amount: that follows from the item's `vat` and its money.
+ * `unit`, `unitPrice`, and `matrixCode` with `matrixUnits` unless `unit` is 97
+ * or 99, and sends the line as it is. The line never carries its own VAT
+ * amount: that follows from the item's `vat` and its money.
  */
 type ItemLine = {
     description?: string;
@@ -195,8 +242,11 @@ type ItemLine = {
     /** A major-unit decimal string with up to six decimals, unlike every other amount. */
     unitPrice?: string;
     discount?: number;
+    /** Your own product code, at most 50 characters. */
     code?: string;
+    /** The product's GTIN, or one of `ARCA_WSMTXCA_GENERIC_CODES`. */
     matrixCode?: string;
+    /** Whole units of `matrixCode`, from 1 to 999999. */
     matrixUnits?: number;
 };
 type VatRate = SupportedVatRate | "exempt" | "untaxed";
@@ -274,6 +324,8 @@ type IssuedVoucher = VoucherCoordinates & {
      * authorization is never lost over its QR.
      */
     qr?: string;
+    /** The JSON `qr` carries in base64 after `?p=`. Present whenever `qr` is. */
+    qrPayload?: ArcaQrPayload;
 };
 type ServiceFor<O extends IssueOptions> = "service" extends keyof O ? "wsmtxca" extends O["service"] ? O extends {
     service: "wsmtxca";
@@ -394,6 +446,13 @@ type IssuanceFields = {
     buyers?: WsfeVoucherInput["buyers"];
     activities?: WsfeVoucherInput["activities"];
 };
+type VoucherTypeInfo = {
+    family: InvoiceFamily;
+    voucherClass: VoucherClass;
+    kind: "invoice" | "debit_note" | "credit_note";
+};
+/** What an ARCA voucher type the SDK issues is. Pure; throws for any other. */
+declare function describeVoucherType(voucherType: number): VoucherTypeInfo;
 /** FCE business fields; the SDK encodes each provider's different option layout. */
 type FceOptions = {
     cbu?: string;
@@ -437,18 +496,33 @@ type IssueCommon = IssuanceFields & {
     };
 };
 type IssueInput = IssueCommon & ({
-    issuer: "responsable_inscripto";
+    issuer: "responsable_inscripto" | 1;
     items: readonly VatItem[];
     amounts?: never;
 } | {
-    issuer: "monotributo" | "exento" | "no_alcanzado";
+    issuer: "monotributo" | "exento" | "no_alcanzado" | 4 | 6 | 15;
     items: readonly AmountItem[];
     amounts?: never;
 } | {
-    issuer: IssuerCondition;
+    issuer: IssuerCondition | IssuerConditionId;
     amounts: VoucherAmounts;
     items?: never;
 });
+type VoucherDateWindowInput = {
+    voucherType: number;
+    /** What the voucher bills; `"products"` when omitted, as in `issue()`. */
+    concept?: NonNullable<IssuanceFields["concept"]>;
+    /** The service that will authorize it; `"wsfe"` when omitted. */
+    service?: "wsfe" | "wsmtxca";
+    /** When it will be sent; its day in Argentina anchors the window. */
+    now?: Date;
+};
+/**
+ * The dates ARCA accepts for a voucher sent now, the same window `issue()`
+ * checks before any call. Pure, no I/O. ARCA still rejects a date before the
+ * last voucher of the same type and sales point.
+ */
+declare function voucherDateWindow(input: VoucherDateWindowInput): VoucherDateWindow;
 
 /**
  * The credited lines and, at most, the note's own sales point and date.
@@ -515,6 +589,11 @@ type VouchersService = {
      * throws on any other provider error. Reads only: no store and no reserve.
      */
     lookup(voucher: VoucherCoordinates, options?: PreviewOptions): Promise<VoucherSummary | null>;
+    /**
+     * The number of the last voucher ARCA authorized for a sales point and
+     * voucher type, on WSFE or WSMTXCA; `0` when none was ever authorized.
+     */
+    lastAuthorized(sequence: Omit<VoucherCoordinates, "number">, options?: PreviewOptions): Promise<number>;
     /** Consults a durable reservation. Never allocates or authorizes a voucher. */
     recover<O extends RecoveryOptions = {
         include?: never;
@@ -612,6 +691,8 @@ type ArcaClient = {
     previewDebitNote: VouchersService["previewDebitNote"];
     /** Consults one authorized voucher; `null` when ARCA has no such voucher. */
     lookup: VouchersService["lookup"];
+    /** The last number ARCA authorized for a sales point and type; `0` when none. */
+    lastAuthorized: VouchersService["lastAuthorized"];
     wsfe: WsfeService;
     wsmtxca: WsmtxcaService;
     padron: PadronService;
@@ -621,10 +702,11 @@ type ArcaClient = {
  * Validates the config, wires WSAA authentication and SOAP transport,
  * and returns an object with `issue()`, `preview()`, `issueCreditNote()`,
  * `issueDebitNote()`, `previewCreditNote()`, `previewDebitNote()`, `recover()`,
- * `lookup()` and the `.wsfe`, `.wsmtxca`, and `.padron` service modules.
+ * `lookup()`, `lastAuthorized()` and the `.wsfe`, `.wsmtxca`, and `.padron`
+ * service modules.
  *
  * @throws {ArcaConfigurationError} When the config is missing or invalid.
  */
 declare function createArcaClient(config?: ArcaClientOptions): ArcaClient;
 
-export { type ArcaClient as A, type CreditNoteInput as C, type DebitNoteInput as D, type FceOptions as F, type InvoiceFamily as I, type NotePreview as N, type PeriodNoteInput as P, type Receiver as R, type Tribute as T, type VatItem as V, type WsfeIdentityMatch as W, type AmountItem as a, type ArcaClientConfigView as b, type FiscalHeader as c, type IssuanceFields as d, type IssueAmounts as e, type IssueCommon as f, type IssueInput as g, type IssueOptions as h, type IssueOutcome as i, type IssuePreview as j, type IssueRequest as k, type IssuedVoucher as l, type ItemLine as m, type PreviewOptions as n, type RecoveryOptions as o, type VatRate as p, type VoucherAmounts as q, type VoucherCoordinates as r, type VoucherSummary as s, type VouchersService as t, type WsmtxcaIssueRequest as u, type WsmtxcaLine as v, createArcaClient as w, matchWsfeVoucherIdentity as x };
+export { type ArcaClient as A, type WsmtxcaLine as B, type CreditNoteInput as C, type DebitNoteInput as D, arcaQrPayload as E, type FceOptions as F, arcaQrUrl as G, createArcaClient as H, type InvoiceFamily as I, describeVoucherType as J, matchWsfeVoucherIdentity as K, voucherDateWindow as L, type NotePreview as N, type PeriodNoteInput as P, type Receiver as R, type Tribute as T, type VatItem as V, type WsfeIdentityMatch as W, ARCA_QR_URL as a, type AmountItem as b, type ArcaClientConfigView as c, type ArcaQrInput as d, type ArcaQrPayload as e, type FiscalHeader as f, type IssuanceFields as g, type IssueAmounts as h, type IssueCommon as i, type IssueInput as j, type IssueOptions as k, type IssueOutcome as l, type IssuePreview as m, type IssueRequest as n, type IssuedVoucher as o, type ItemLine as p, type PreviewOptions as q, type RecoveryOptions as r, type VatRate as s, type VoucherAmounts as t, type VoucherCoordinates as u, type VoucherDateWindowInput as v, type VoucherSummary as w, type VoucherTypeInfo as x, type VouchersService as y, type WsmtxcaIssueRequest as z };

package/dist/constants.d.ts

@@ -16,6 +16,28 @@ declare const ARCA_DOCUMENT_TYPES: {
     readonly DNI: 96;
     readonly CONSUMIDOR_FINAL: 99;
 };
+/**
+ * ARCA's generic WSMTXCA item codes, keyed by the `matrixCode` to send.
+ * RG 2904, Anexo VII: for concepts outside the issuer's main line of goods,
+ * which carry their GTIN instead. Samples and promotional material use
+ * `7790001001054` (Ventas varias).
+ * https://www.afip.gob.ar/fe/documentos/codigosGenericosYEspecificos.xls
+ */
+declare const ARCA_WSMTXCA_GENERIC_CODES: {
+    readonly "7790001001030": "Descuentos y bonificaciones comerciales";
+    readonly "7790001001047": "Conceptos financieros";
+    readonly "7790001001054": "Ventas varias";
+    readonly "7790001001061": "Bienes de uso";
+    readonly "7790001001078": "Servicios prestados";
+    readonly "7790001001085": "Fletes";
+    readonly "7790001001092": "Alquileres";
+    readonly "7790001001115": "Depósito y servicios de logística";
+    readonly "7790001001122": "Repuestos y accesorios";
+    readonly "7790001001139": "Ajustes impositivos";
+    readonly "7790001001146": "Actividades comerciales no codificadas";
+    readonly "7790001001153": "Venta de material de rezago";
+    readonly "7790001001856": "Anticipos y señas";
+};
 /**
  * Common receiver IVA condition identifiers used by WSFE.
  * Allowed values depend on the voucher class and ARCA's live catalog.
@@ -69,6 +91,8 @@ declare const ARCA_ISSUER_CONDITION_IDS: {
     readonly exento: 4;
     readonly no_alcanzado: 15;
 };
+/** The ARCA identifier of each issuer condition, accepted wherever a name is. */
+type IssuerConditionId = (typeof ARCA_ISSUER_CONDITION_IDS)[IssuerCondition];
 declare const ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS = 1000000000n;
 declare const ARCA_INVOICE_CLASS_BY_ISSUER: {
     readonly responsable_inscripto: {
@@ -101,4 +125,4 @@ declare const ARCA_INVOICE_CLASS_BY_ISSUER: {
     };
 };
 
-export { ARCA_CONCEPT_TYPES, ARCA_CURRENCY_IDS, ARCA_DOCUMENT_TYPES, ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS, ARCA_INVOICE_CLASS_BY_ISSUER, ARCA_ISSUER_CONDITION_IDS, ARCA_RECEIVER_CONDITION_IDS, ARCA_RECEIVER_VAT_CONDITIONS, ARCA_VAT_RATES, ARCA_VOUCHER_TYPES, ISO_CURRENCIES, type IssuerCondition, type ReceiverCondition, type VoucherClass };
+export { ARCA_CONCEPT_TYPES, ARCA_CURRENCY_IDS, ARCA_DOCUMENT_TYPES, ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS, ARCA_INVOICE_CLASS_BY_ISSUER, ARCA_ISSUER_CONDITION_IDS, ARCA_RECEIVER_CONDITION_IDS, ARCA_RECEIVER_VAT_CONDITIONS, ARCA_VAT_RATES, ARCA_VOUCHER_TYPES, ARCA_WSMTXCA_GENERIC_CODES, ISO_CURRENCIES, type IssuerCondition, type IssuerConditionId, type ReceiverCondition, type VoucherClass };

package/dist/constants.mjs

@@ -9,8 +9,9 @@ import {
   ARCA_RECEIVER_VAT_CONDITIONS,
   ARCA_VAT_RATES,
   ARCA_VOUCHER_TYPES,
+  ARCA_WSMTXCA_GENERIC_CODES,
   ISO_CURRENCIES
-} from "./chunk-DHN6OQJP.mjs";
+} from "./chunk-C2KX652X.mjs";
 export {
   ARCA_CONCEPT_TYPES,
   ARCA_CURRENCY_IDS,
@@ -22,6 +23,7 @@ export {
   ARCA_RECEIVER_VAT_CONDITIONS,
   ARCA_VAT_RATES,
   ARCA_VOUCHER_TYPES,
+  ARCA_WSMTXCA_GENERIC_CODES,
   ISO_CURRENCIES
 };
 //# sourceMappingURL=constants.mjs.map

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, t as isArcaAuthenticationError, u as toArcaSafeErrorMetadata } from './fiscal-evidence-B6UTFGmY.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';

package/dist/errors.mjs

@@ -9,7 +9,7 @@ import {
   ArcaTransportError,
   isArcaAuthenticationError,
   toArcaSafeErrorMetadata
-} from "./chunk-EZ4HA3LC.mjs";
+} from "./chunk-NT2A6YMO.mjs";
 export {
   ArcaAuthenticationError,
   ArcaConfigurationError,

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

@@ -12,18 +12,30 @@ declare class ArcaConfigurationError extends ArcaError {
     constructor(message: string, options?: ErrorOptions);
 }
 /** 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_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";
+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. */
+type VoucherDateWindow = {
+    from: string;
+    to: string;
+};
 type ArcaInputErrorOptions = ErrorOptions & {
     code: ArcaInputErrorCode;
     field?: string;
     expected?: string;
+    window?: VoucherDateWindow;
 };
-/** Thrown when caller-provided input data is missing or invalid. */
+/**
+ * Thrown when caller-provided input data is missing or invalid. From
+ * `issue()`, `issueCreditNote()` or `issueDebitNote()` it means that call sent
+ * no authorization request, so ARCA issued nothing for it.
+ */
 declare class ArcaInputError extends ArcaError {
     readonly code: ArcaInputErrorCode;
     readonly name: string;
     readonly field?: string;
     readonly expected?: string;
+    /** With `ARCA_INPUT_DATE_OUTSIDE_WINDOW`, the dates ARCA accepts today. */
+    readonly window?: VoucherDateWindow;
     constructor(message: string, options: ArcaInputErrorOptions);
 }
 /** Stable reasons exposed for explicit ARCA authentication rejections. */
@@ -129,6 +141,7 @@ type ArcaSafeErrorMetadata = {
     faultCode?: string;
     field?: string;
     expected?: string;
+    window?: VoucherDateWindow;
     /** ArcaServiceError's provider code, always as a string. */
     serviceCode?: string;
     result?: string;
@@ -211,4 +224,4 @@ type ArcaVoucherLookupResult<TVoucher, TService extends IssuanceService = Issuan
     raw: Record<string, unknown>;
 };
 
-export { ArcaAuthenticationError as A, type IssuanceService as I, 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, type ArcaSafeErrorMetadata as o, ArcaServiceError as p, ArcaSoapFaultError as q, ArcaTransportError as r, type ArcaVoucherLookupResult as s, isArcaAuthenticationError as t, toArcaSafeErrorMetadata as u };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { a as AmountItem, A as ArcaClient, b as ArcaClientConfigView, C as CreditNoteInput, D as DebitNoteInput, F as FceOptions, c as FiscalHeader, I as InvoiceFamily, d as IssuanceFields, e as IssueAmounts, f as IssueCommon, g as IssueInput, h as IssueOptions, i as IssueOutcome, j as IssuePreview, k as IssueRequest, l as IssuedVoucher, m as ItemLine, N as NotePreview, P as PeriodNoteInput, n as PreviewOptions, R as Receiver, o as RecoveryOptions, T as Tribute, V as VatItem, p as VatRate, q as VoucherAmounts, r as VoucherCoordinates, s as VoucherSummary, t as VouchersService, W as WsfeIdentityMatch, u as WsmtxcaIssueRequest, v as WsmtxcaLine, w as createArcaClient, x as matchWsfeVoucherIdentity } from './client-COK5u3oz.js';
+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-BIkLOgBA.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 { ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS, ARCA_INVOICE_CLASS_BY_ISSUER, ARCA_ISSUER_CONDITION_IDS, ARCA_RECEIVER_CONDITION_IDS, IssuerCondition, 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, t as isArcaAuthenticationError, u as toArcaSafeErrorMetadata } from './fiscal-evidence-B6UTFGmY.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 { 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';
@@ -38,52 +38,6 @@ declare function createArcaClientConfigFromEnv(options?: CreateArcaClientConfigF
  */
 declare function assertArcaClientConfig(config: ArcaClientConfig): void;
 
-/** Where every printed voucher's QR points, per ARCA's QR specification v1. */
-declare const ARCA_QR_URL = "https://www.arca.gob.ar/fe/qr/";
-/** What the QR of a printed voucher encodes. Amounts are minor units. */
-type ArcaQrInput = {
-    /** The issuer's CUIT. */
-    taxId: number | string;
-    salesPoint: number;
-    voucherType: number;
-    number: number;
-    /** `YYYY-MM-DD` or `YYYYMMDD`. */
-    date: string;
-    /** The total in the voucher's currency, in minor units. */
-    total: number;
-    /** ARCA currency id; `PES` when omitted. */
-    currency?: string;
-    /** Pesos per unit of `currency`; 1 for pesos. */
-    exchangeRate?: number | string;
-    /** The CAE, or the CAEA when `authorization` is `"CAEA"`. */
-    cae: string;
-    authorization?: "CAE" | "CAEA";
-    /** The receiver's document. Omitted, or type 99, means an unidentified consumidor final. */
-    document?: {
-        type: number;
-        number: number | string;
-    };
-};
-/** The JSON the QR carries, in the field order of ARCA's specification. */
-type ArcaQrPayload = {
-    ver: 1;
-    fecha: string;
-    cuit: number;
-    ptoVta: number;
-    tipoCmp: number;
-    nroCmp: number;
-    importe: number;
-    moneda: string;
-    ctz: number;
-    tipoDocRec?: number;
-    nroDocRec?: number;
-    tipoCodAut: "E" | "A";
-    codAut: number;
-};
-/** Builds the URL a printed voucher's QR must encode. Pure, no I/O. */
-declare function arcaQrUrl(input: ArcaQrInput): string;
-declare function arcaQrPayload(input: ArcaQrInput): ArcaQrPayload;
-
 /** Persistent store for a single server with a private durable volume. */
 declare function createFileStore(directory: string): ArcaStore;
 
@@ -115,4 +69,4 @@ declare function createRedisStore(client: RedisClient, options?: {
 
 declare function createMemoryWsaaSessionStore(): ArcaWsaaSessionStore;
 
-export { ARCA_ENVIRONMENTS, ARCA_ENV_VARIABLES, ARCA_QR_URL, ArcaEnvironment, type ArcaQrInput, type ArcaQrPayload, ArcaStore, ArcaWsaaSessionStore, type CreateArcaClientConfigFromEnvOptions, arcaQrPayload, arcaQrUrl, assertArcaClientConfig, createArcaClientConfigFromEnv, createFileStore, createMemoryStore, createMemoryWsaaSessionStore, createPostgresStore, createRedisStore };
+export { ARCA_ENVIRONMENTS, ARCA_ENV_VARIABLES, ArcaEnvironment, ArcaStore, ArcaWsaaSessionStore, type CreateArcaClientConfigFromEnvOptions, assertArcaClientConfig, createArcaClientConfigFromEnv, createFileStore, createMemoryStore, createMemoryWsaaSessionStore, createPostgresStore, createRedisStore };

package/dist/index.mjs

@@ -10,26 +10,29 @@ import {
   createArcaClientConfigFromEnv,
   createFileStore,
   createMemoryWsaaSessionStore,
+  describeVoucherType,
   matchWsfeVoucherIdentity,
   storeCall,
+  voucherDateWindow,
   withLease
-} from "./chunk-JP5IBMVI.mjs";
+} from "./chunk-T5N62FRZ.mjs";
 import {
   ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS,
   ARCA_INVOICE_CLASS_BY_ISSUER,
   ARCA_ISSUER_CONDITION_IDS,
-  ARCA_RECEIVER_CONDITION_IDS
-} from "./chunk-DHN6OQJP.mjs";
+  ARCA_RECEIVER_CONDITION_IDS,
+  ARCA_WSMTXCA_GENERIC_CODES
+} from "./chunk-C2KX652X.mjs";
 import {
   createPadronService
-} from "./chunk-MRBFLBWX.mjs";
+} from "./chunk-JP3LVU7K.mjs";
 import {
   createWsfeService
-} from "./chunk-OORNZFI5.mjs";
+} from "./chunk-TXFYTMO4.mjs";
 import {
   createWsmtxcaService
-} from "./chunk-4RD5VQWC.mjs";
-import "./chunk-WPHD2GQJ.mjs";
+} from "./chunk-TMSP5QPZ.mjs";
+import "./chunk-B2M64SIK.mjs";
 import {
   ArcaAuthenticationError,
   ArcaConfigurationError,
@@ -41,7 +44,7 @@ import {
   ArcaTransportError,
   isArcaAuthenticationError,
   toArcaSafeErrorMetadata
-} from "./chunk-EZ4HA3LC.mjs";
+} from "./chunk-NT2A6YMO.mjs";
 
 // src/store/memory.ts
 function createMemoryStore() {
@@ -226,6 +229,7 @@ export {
   ARCA_ISSUER_CONDITION_IDS,
   ARCA_QR_URL,
   ARCA_RECEIVER_CONDITION_IDS,
+  ARCA_WSMTXCA_GENERIC_CODES,
   ArcaAuthenticationError,
   ArcaConfigurationError,
   ArcaError,
@@ -247,8 +251,10 @@ export {
   createRedisStore,
   createWsfeService,
   createWsmtxcaService,
+  describeVoucherType,
   isArcaAuthenticationError,
   matchWsfeVoucherIdentity,
-  toArcaSafeErrorMetadata
+  toArcaSafeErrorMetadata,
+  voucherDateWindow
 };
 //# sourceMappingURL=index.mjs.map

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 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":[]}

package/dist/padron.mjs

@@ -1,7 +1,7 @@
 import {
   createPadronService
-} from "./chunk-MRBFLBWX.mjs";
-import "./chunk-EZ4HA3LC.mjs";
+} from "./chunk-JP3LVU7K.mjs";
+import "./chunk-NT2A6YMO.mjs";
 export {
   createPadronService
 };

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-B6UTFGmY.js';
+import { e as ArcaAuthorizationOutcome, s as ArcaVoucherLookupResult } from './fiscal-evidence-Bg4o9nxt.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}`;