facturas 0.8.0 → 0.9.0

package/dist/{chunk-HUT3PFKF.mjs → chunk-ZOSNASXB.mjs}

@@ -224,4 +224,4 @@ export {
   ArcaServiceError,
   toArcaSafeErrorMetadata
 };
-//# sourceMappingURL=chunk-HUT3PFKF.mjs.map
+//# sourceMappingURL=chunk-ZOSNASXB.mjs.map

package/dist/chunk-ZOSNASXB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/redaction.ts","../src/errors.ts"],"sourcesContent":["export const MAX_DIAGNOSTIC_PREVIEW_LENGTH = 4096;\n\nconst MAX_DIAGNOSTIC_SCALAR_LENGTH = 512;\nconst SENSITIVE_XML_ELEMENT_NAME = \"((?:[A-Za-z_][\\\\w.-]*:)?(?:Token|Sign))\";\nconst PAIRED_SENSITIVE_XML_ELEMENT = new RegExp(\n  `<${SENSITIVE_XML_ELEMENT_NAME}\\\\b[^>]*>[\\\\s\\\\S]*?<\\\\/\\\\1\\\\s*>`,\n  \"gi\"\n);\nconst SELF_CLOSING_SENSITIVE_XML_ELEMENT = new RegExp(\n  `<${SENSITIVE_XML_ELEMENT_NAME}\\\\b[^>]*\\\\/\\\\s*>`,\n  \"gi\"\n);\nconst UNTERMINATED_SENSITIVE_XML_ELEMENT = new RegExp(\n  `<${SENSITIVE_XML_ELEMENT_NAME}\\\\b[^>]*>[^<]*`,\n  \"gi\"\n);\n\nexport type ResponseBodyDiagnostic = {\n  responseBodyLength: number;\n  responseBodyPreview: string;\n};\n\nexport type SafeErrorDiagnostic = {\n  errorName?: string;\n  errorCode?: string;\n  statusCode?: number;\n  contentType?: string;\n  responseBodyLength?: number;\n  responseBodyPreview?: string;\n  faultCode?: string;\n};\n\n/** Redacts credential-bearing XML elements and applies the global preview bound. */\nexport function redactDiagnosticPreview(\n  value: string,\n  requestedMaxLength = MAX_DIAGNOSTIC_PREVIEW_LENGTH\n): string {\n  const maxLength = normalizePreviewLength(requestedMaxLength);\n\n  return value\n    .replace(\n      PAIRED_SENSITIVE_XML_ELEMENT,\n      (_match, tagName: string) => `<${tagName}>[REDACTED]</${tagName}>`\n    )\n    .replace(\n      SELF_CLOSING_SENSITIVE_XML_ELEMENT,\n      (_match, tagName: string) => `<${tagName}>[REDACTED]</${tagName}>`\n    )\n    .replace(\n      UNTERMINATED_SENSITIVE_XML_ELEMENT,\n      (_match, tagName: string) => `<${tagName}>[REDACTED]`\n    )\n    .slice(0, maxLength);\n}\n\n/** Produces the only response-body shape allowed in errors and logs. */\nexport function createResponseBodyDiagnostic(\n  responseBody: string,\n  requestedMaxLength = MAX_DIAGNOSTIC_PREVIEW_LENGTH\n): ResponseBodyDiagnostic {\n  return {\n    responseBodyLength: responseBody.length,\n    responseBodyPreview: redactDiagnosticPreview(\n      responseBody,\n      requestedMaxLength\n    ),\n  };\n}\n\n/** Extracts a scalar allowlist from an error without exposing the error or cause. */\nexport function createSafeErrorDiagnostic(error: unknown): SafeErrorDiagnostic {\n  if (!(error && typeof error === \"object\")) {\n    return {};\n  }\n\n  const candidate = error as Record<string, unknown>;\n  const diagnostic: SafeErrorDiagnostic = {};\n\n  assignSafeString(diagnostic, \"errorName\", candidate.name);\n  assignSafeString(diagnostic, \"errorCode\", candidate.code);\n  assignSafeNumber(diagnostic, \"statusCode\", candidate.statusCode);\n  assignSafeString(diagnostic, \"contentType\", candidate.contentType);\n  assignSafeNumber(\n    diagnostic,\n    \"responseBodyLength\",\n    candidate.responseBodyLength\n  );\n  if (typeof candidate.responseBodyPreview === \"string\") {\n    diagnostic.responseBodyPreview = redactDiagnosticPreview(\n      candidate.responseBodyPreview\n    );\n  }\n  assignSafeString(diagnostic, \"faultCode\", candidate.faultCode);\n\n  return diagnostic;\n}\n\nfunction normalizePreviewLength(requestedMaxLength: number): number {\n  if (!Number.isFinite(requestedMaxLength)) {\n    return MAX_DIAGNOSTIC_PREVIEW_LENGTH;\n  }\n\n  return Math.max(\n    0,\n    Math.min(Math.trunc(requestedMaxLength), MAX_DIAGNOSTIC_PREVIEW_LENGTH)\n  );\n}\n\nfunction assignSafeString<\n  TKey extends \"errorName\" | \"errorCode\" | \"contentType\" | \"faultCode\",\n>(target: SafeErrorDiagnostic, key: TKey, value: unknown): void {\n  if (typeof value === \"string\") {\n    target[key] = redactDiagnosticPreview(value, MAX_DIAGNOSTIC_SCALAR_LENGTH);\n  }\n}\n\nfunction assignSafeNumber<TKey extends \"statusCode\" | \"responseBodyLength\">(\n  target: SafeErrorDiagnostic,\n  key: TKey,\n  value: unknown\n): void {\n  if (typeof value === \"number\" && Number.isFinite(value)) {\n    target[key] = value;\n  }\n}\n","import { redactDiagnosticPreview } from \"./internal/redaction\";\nimport type { ArcaServiceName } from \"./internal/types\";\nimport type {\n  ArcaFiscalIssue,\n  ArcaFiscalResultLevel,\n  ArcaFiscalResults,\n} from \"./services/fiscal-evidence\";\n\n/** Base error class for all ARCA-related errors. */\nexport class ArcaError extends Error {\n  readonly code: string;\n  override readonly name: string = \"ArcaError\";\n\n  constructor(message: string, code = \"ARCA_ERROR\", options?: ErrorOptions) {\n    super(message, options);\n    this.code = code;\n  }\n}\n\n/** Thrown when the ARCA client configuration is missing or invalid. */\nexport class ArcaConfigurationError extends ArcaError {\n  override readonly name: string = \"ArcaConfigurationError\";\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"ARCA_CONFIGURATION_ERROR\", options);\n  }\n}\n\n/** Stable routing codes for caller-provided input failures. */\nexport type ArcaInputErrorCode =\n  | \"ARCA_INPUT_IDEMPOTENCY_MISMATCH\"\n  | \"ARCA_INPUT_INVALID_DATE\"\n  | \"ARCA_INPUT_INVALID_AMOUNT\"\n  | \"ARCA_INPUT_AMOUNT_PRECISION\"\n  | \"ARCA_INPUT_AMOUNT_MISMATCH\"\n  | \"ARCA_INPUT_INVALID_EXCHANGE_RATE\"\n  | \"ARCA_INPUT_INVALID_VALUE\"\n  | \"ARCA_INPUT_MISSING_FIELD\"\n  | \"ARCA_INPUT_RESERVED_FIELD\";\n\nexport type ArcaInputErrorOptions = ErrorOptions & {\n  code: ArcaInputErrorCode;\n  field?: string;\n  expected?: string;\n};\n\n/** Thrown when caller-provided input data is missing or invalid. */\nexport class ArcaInputError extends ArcaError {\n  declare readonly code: ArcaInputErrorCode;\n  override readonly name: string = \"ArcaInputError\";\n  readonly field?: string;\n  readonly expected?: string;\n\n  constructor(message: string, options: ArcaInputErrorOptions) {\n    super(message, options.code, options);\n    this.field = options.field;\n    this.expected = options.expected;\n  }\n}\n\n/** Stable reasons exposed for explicit ARCA authentication rejections. */\nexport type ArcaAuthenticationReason =\n  | \"invalid_token\"\n  | \"unauthorized_computer\"\n  | \"missing_relationship\"\n  | \"authentication_rejected\";\n\nexport type ArcaAuthenticationErrorOptions = ErrorOptions & {\n  reason: ArcaAuthenticationReason;\n  service: ArcaServiceName;\n  operation: string;\n  providerCode?: string | number;\n};\n\n/** Thrown when ARCA explicitly rejects credentials before an operation runs. */\nexport class ArcaAuthenticationError extends ArcaError {\n  declare readonly code: \"ARCA_AUTHENTICATION_ERROR\";\n  override readonly name: string = \"ArcaAuthenticationError\";\n  readonly reason: ArcaAuthenticationReason;\n  readonly service: ArcaServiceName;\n  readonly operation: string;\n  readonly providerCode?: string | number;\n\n  constructor(message: string, options: ArcaAuthenticationErrorOptions) {\n    super(\n      redactDiagnosticPreview(message),\n      \"ARCA_AUTHENTICATION_ERROR\",\n      options\n    );\n    this.reason = options.reason;\n    this.service = options.service;\n    this.operation = options.operation;\n    this.providerCode = normalizeProviderCode(options.providerCode);\n  }\n}\n\n/** Narrows unknown failures to the explicit authentication error contract. */\nexport function isArcaAuthenticationError(\n  error: unknown\n): error is ArcaAuthenticationError {\n  return error instanceof ArcaAuthenticationError;\n}\n\n/** Thrown when an HTTP request to an ARCA endpoint fails at the transport level. */\nexport class ArcaTransportError extends ArcaError {\n  override readonly name: string = \"ArcaTransportError\";\n  readonly statusCode?: number;\n  readonly contentType?: string;\n  readonly responseBodyLength?: number;\n  readonly responseBodyPreview?: string;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      statusCode?: number;\n      contentType?: string;\n      responseBodyLength?: number;\n      responseBodyPreview?: string;\n    }\n  ) {\n    super(message, \"ARCA_TRANSPORT_ERROR\", options);\n    this.statusCode = options?.statusCode;\n    this.contentType = options?.contentType;\n    this.responseBodyLength = options?.responseBodyLength;\n    this.responseBodyPreview =\n      options?.responseBodyPreview === undefined\n        ? undefined\n        : redactDiagnosticPreview(options.responseBodyPreview);\n  }\n}\n\n/** Thrown when the SOAP response contains a Fault element. */\nexport class ArcaSoapFaultError extends ArcaError {\n  override readonly name: string = \"ArcaSoapFaultError\";\n  readonly faultCode?: string;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      faultCode?: string;\n    }\n  ) {\n    super(redactDiagnosticPreview(message), \"ARCA_SOAP_FAULT\", options);\n    this.faultCode =\n      options?.faultCode === undefined\n        ? undefined\n        : redactDiagnosticPreview(options.faultCode);\n  }\n}\n\n/** Thrown when a response cannot be parsed as a valid SOAP envelope. */\nexport class ArcaInvalidSoapResponseError extends ArcaError {\n  override readonly name: string = \"ArcaInvalidSoapResponseError\";\n  readonly service?: ArcaServiceName;\n  readonly operation?: string;\n  readonly endpointUrl?: string;\n  readonly statusCode?: number;\n  readonly contentType?: string;\n  readonly responseBodyLength?: number;\n  readonly responseBodyPreview?: string;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      service?: ArcaServiceName;\n      operation?: string;\n      endpointUrl?: string;\n      statusCode?: number;\n      contentType?: string;\n      responseBodyLength?: number;\n      responseBodyPreview?: string;\n    }\n  ) {\n    super(message, \"ARCA_INVALID_SOAP_RESPONSE\", options);\n    this.service = options?.service;\n    this.operation = options?.operation;\n    this.endpointUrl = options?.endpointUrl;\n    this.statusCode = options?.statusCode;\n    this.contentType = options?.contentType;\n    this.responseBodyLength = options?.responseBodyLength;\n    this.responseBodyPreview =\n      options?.responseBodyPreview === undefined\n        ? undefined\n        : redactDiagnosticPreview(options.responseBodyPreview);\n  }\n}\n\n/** Thrown when an ARCA service (WSFE, WSMTXCA, Padron) returns a domain-level error. */\nexport class ArcaServiceError extends ArcaError {\n  override readonly name: string = \"ArcaServiceError\";\n  readonly serviceCode?: string | number;\n  readonly service?: ArcaServiceName;\n  readonly operation?: string;\n  readonly result?: string;\n  readonly resultLevel?: ArcaFiscalResultLevel;\n  readonly results?: ArcaFiscalResults;\n  readonly cae?: string;\n  readonly issues?: readonly ArcaFiscalIssue[];\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      serviceCode?: string | number;\n      service?: ArcaServiceName;\n      operation?: string;\n      result?: string;\n      resultLevel?: ArcaFiscalResultLevel;\n      results?: ArcaFiscalResults;\n      cae?: string;\n      issues?: readonly ArcaFiscalIssue[];\n    }\n  ) {\n    super(message, \"ARCA_SERVICE_ERROR\", options);\n    this.serviceCode = options?.serviceCode;\n    this.service = options?.service;\n    this.operation = options?.operation;\n    this.result = options?.result;\n    this.resultLevel = options?.resultLevel;\n    this.results = options?.results;\n    this.cae = options?.cae;\n    this.issues = options?.issues;\n  }\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    return redactDiagnosticPreview(providerCode, 512);\n  }\n  return undefined;\n}\n\n/** Narrow error evidence: never includes a cause, raw response or stack. */\nexport type ArcaSafeErrorMetadata = {\n  name: string;\n  message: string;\n  code?: string;\n  statusCode?: number;\n};\n\nexport function toArcaSafeErrorMetadata(error: unknown): ArcaSafeErrorMetadata {\n  if (!(error instanceof Error)) {\n    return { name: \"UnknownError\", message: String(error) };\n  }\n  return {\n    name: error.name,\n    message: error.message,\n    ...(error instanceof ArcaError ? { code: error.code } : {}),\n    ...(error instanceof ArcaTransportError && error.statusCode !== undefined\n      ? { statusCode: error.statusCode }\n      : {}),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/errors.d.ts

@@ -1,2 +1,2 @@
-import './types-BXq0da71.js';
-export { c as ArcaAuthenticationError, d as ArcaAuthenticationErrorOptions, f as ArcaAuthenticationReason, h as ArcaConfigurationError, i as ArcaError, m as ArcaInputError, n as ArcaInputErrorCode, o as ArcaInputErrorOptions, p as ArcaInvalidSoapResponseError, b as ArcaSafeErrorMetadata, q as ArcaServiceError, r as ArcaSoapFaultError, s as ArcaTransportError, u as isArcaAuthenticationError, v as toArcaSafeErrorMetadata } from './errors-B0uouRzR.js';
+import './types-BiznC1-X.js';
+export { c as ArcaAuthenticationError, d as ArcaAuthenticationErrorOptions, f as ArcaAuthenticationReason, h as ArcaConfigurationError, i as ArcaError, m as ArcaInputError, n as ArcaInputErrorCode, o as ArcaInputErrorOptions, p as ArcaInvalidSoapResponseError, b as ArcaSafeErrorMetadata, q as ArcaServiceError, r as ArcaSoapFaultError, s as ArcaTransportError, u as isArcaAuthenticationError, v as toArcaSafeErrorMetadata } from './fiscal-evidence-DBzakqBE.js';

package/dist/errors.mjs

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

package/dist/{errors-B0uouRzR.d.ts → fiscal-evidence-DBzakqBE.d.ts}

@@ -1,79 +1,4 @@
-import { A as ArcaServiceName } from './types-BXq0da71.js';
-
-/** ARCA services that authorize fiscal vouchers. */
-type ArcaFiscalService = "wsfe" | "wsmtxca";
-/** Location of a structured authorization result in the service response. */
-type ArcaFiscalResultLevel = "header" | "detail" | "operation";
-/** Every structured result field exposed by one provider response. */
-type ArcaFiscalResults = {
-    header?: string;
-    detail?: string;
-    operation?: string;
-};
-/** Source and meaning of one provider issue. */
-type ArcaFiscalIssue = {
-    service: ArcaFiscalService;
-    operation: string;
-    source: "error" | "observation";
-    category: "business" | "infrastructure" | "observation" | "unknown";
-    code?: string;
-    message: string;
-    resultLevel?: ArcaFiscalResultLevel;
-};
-/** Why an authorization response cannot prove approval or rejection. */
-type ArcaAuthorizationIndeterminateReason = "authentication_rejected" | "transport_error" | "soap_fault" | "invalid_response" | "incomplete_response" | "contradictory_response" | "unexpected_error";
-/** Safe authentication evidence attached to an exact authorization outcome. */
-type ArcaAuthenticationEvidence = {
-    code: "ARCA_AUTHENTICATION_ERROR";
-    reason: ArcaAuthenticationReason;
-    providerCode?: string | number;
-};
-type ArcaAuthorizationEvidenceBase<TService extends ArcaFiscalService = ArcaFiscalService> = {
-    service: TService;
-    operation: string;
-    results: ArcaFiscalResults;
-    errors: ArcaFiscalIssue[];
-    observations: ArcaFiscalIssue[];
-    raw?: Record<string, unknown>;
-};
-/** Structured evidence returned by one exact voucher authorization attempt. */
-type ArcaAuthorizationOutcome<TService extends ArcaFiscalService = ArcaFiscalService> = (ArcaAuthorizationEvidenceBase<TService> & {
-    kind: "authorized";
-    result: "A" | "O";
-    resultLevel: ArcaFiscalResultLevel;
-    cae: string;
-    caeExpiry?: string;
-    voucherNumber: number;
-}) | (ArcaAuthorizationEvidenceBase<TService> & {
-    kind: "rejected";
-    result: "R";
-    resultLevel: ArcaFiscalResultLevel;
-}) | (ArcaAuthorizationEvidenceBase<TService> & {
-    kind: "indeterminate";
-    reason: ArcaAuthorizationIndeterminateReason;
-    authentication?: ArcaAuthenticationEvidence;
-    result?: string;
-    resultLevel?: ArcaFiscalResultLevel;
-    cae?: string;
-    caeExpiry?: string;
-    voucherNumber?: number;
-});
-/** Structured result of consulting one exact voucher number. */
-type ArcaVoucherLookupResult<TVoucher, TService extends ArcaFiscalService = ArcaFiscalService> = {
-    kind: "found";
-    service: TService;
-    operation: string;
-    voucher: TVoucher;
-    observations: ArcaFiscalIssue[];
-    raw: Record<string, unknown>;
-} | {
-    kind: "not_found";
-    service: TService;
-    operation: string;
-    errors: ArcaFiscalIssue[];
-    observations: ArcaFiscalIssue[];
-    raw: Record<string, unknown>;
-};
+import { A as ArcaServiceName } from './types-BiznC1-X.js';
 
 /** Base error class for all ARCA-related errors. */
 declare class ArcaError extends Error {
@@ -87,7 +12,7 @@ declare class ArcaConfigurationError extends ArcaError {
     constructor(message: string, options?: ErrorOptions);
 }
 /** Stable routing codes for caller-provided input failures. */
-type ArcaInputErrorCode = "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_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 ArcaInputErrorOptions = ErrorOptions & {
     code: ArcaInputErrorCode;
     field?: string;
@@ -194,4 +119,79 @@ type ArcaSafeErrorMetadata = {
 };
 declare function toArcaSafeErrorMetadata(error: unknown): ArcaSafeErrorMetadata;
 
+/** ARCA services that authorize fiscal vouchers. */
+type ArcaFiscalService = "wsfe" | "wsmtxca";
+/** Location of a structured authorization result in the service response. */
+type ArcaFiscalResultLevel = "header" | "detail" | "operation";
+/** Every structured result field exposed by one provider response. */
+type ArcaFiscalResults = {
+    header?: string;
+    detail?: string;
+    operation?: string;
+};
+/** Source and meaning of one provider issue. */
+type ArcaFiscalIssue = {
+    service: ArcaFiscalService;
+    operation: string;
+    source: "error" | "observation";
+    category: "business" | "infrastructure" | "observation" | "unknown";
+    code?: string;
+    message: string;
+    resultLevel?: ArcaFiscalResultLevel;
+};
+/** Why an authorization response cannot prove approval or rejection. */
+type ArcaAuthorizationIndeterminateReason = "authentication_rejected" | "transport_error" | "soap_fault" | "invalid_response" | "incomplete_response" | "contradictory_response" | "unexpected_error";
+/** Safe authentication evidence attached to an exact authorization outcome. */
+type ArcaAuthenticationEvidence = {
+    code: "ARCA_AUTHENTICATION_ERROR";
+    reason: ArcaAuthenticationReason;
+    providerCode?: string | number;
+};
+type ArcaAuthorizationEvidenceBase<TService extends ArcaFiscalService = ArcaFiscalService> = {
+    service: TService;
+    operation: string;
+    results: ArcaFiscalResults;
+    errors: ArcaFiscalIssue[];
+    observations: ArcaFiscalIssue[];
+    raw?: Record<string, unknown>;
+};
+/** Structured evidence returned by one exact voucher authorization attempt. */
+type ArcaAuthorizationOutcome<TService extends ArcaFiscalService = ArcaFiscalService> = (ArcaAuthorizationEvidenceBase<TService> & {
+    kind: "authorized";
+    result: "A" | "O";
+    resultLevel: ArcaFiscalResultLevel;
+    cae: string;
+    caeExpiry?: string;
+    voucherNumber: number;
+}) | (ArcaAuthorizationEvidenceBase<TService> & {
+    kind: "rejected";
+    result: "R";
+    resultLevel: ArcaFiscalResultLevel;
+}) | (ArcaAuthorizationEvidenceBase<TService> & {
+    kind: "indeterminate";
+    reason: ArcaAuthorizationIndeterminateReason;
+    authentication?: ArcaAuthenticationEvidence;
+    result?: string;
+    resultLevel?: ArcaFiscalResultLevel;
+    cae?: string;
+    caeExpiry?: string;
+    voucherNumber?: number;
+});
+/** Structured result of consulting one exact voucher number. */
+type ArcaVoucherLookupResult<TVoucher, TService extends ArcaFiscalService = ArcaFiscalService> = {
+    kind: "found";
+    service: TService;
+    operation: string;
+    voucher: TVoucher;
+    observations: ArcaFiscalIssue[];
+    raw: Record<string, unknown>;
+} | {
+    kind: "not_found";
+    service: TService;
+    operation: string;
+    errors: ArcaFiscalIssue[];
+    observations: ArcaFiscalIssue[];
+    raw: Record<string, unknown>;
+};
+
 export { type ArcaAuthorizationOutcome as A, type ArcaFiscalIssue as a, type ArcaSafeErrorMetadata as b, ArcaAuthenticationError as c, type ArcaAuthenticationErrorOptions as d, type ArcaAuthenticationEvidence as e, type ArcaAuthenticationReason as f, type ArcaAuthorizationIndeterminateReason as g, ArcaConfigurationError as h, ArcaError as i, type ArcaFiscalResultLevel as j, type ArcaFiscalResults as k, type ArcaFiscalService as l, ArcaInputError as m, type ArcaInputErrorCode as n, type ArcaInputErrorOptions as o, ArcaInvalidSoapResponseError as p, ArcaServiceError as q, ArcaSoapFaultError as r, ArcaTransportError as s, type ArcaVoucherLookupResult as t, isArcaAuthenticationError as u, toArcaSafeErrorMetadata as v };

package/dist/{index-CVpygFb0.d.ts → index-CVGQyyYM.d.ts}

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

package/dist/index.d.ts

@@ -1,16 +1,16 @@
-import { f as ArcaEnvironment, g as ArcaClientConfig, h as ArcaWsaaSessionStore } from './types-BXq0da71.js';
-export { e as ArcaAuthCredentials, d as ArcaAuthOptions, i as ArcaLogLevel, j as ArcaLoggerConfig, k as ArcaPadronServiceName, l as ArcaRepresentedTaxId, A as ArcaServiceName, m as ArcaServiceTarget, c as ArcaWsaaServiceId, n as ArcaWsaaSessionKey } from './types-BXq0da71.js';
+import { f as ArcaEnvironment, g as ArcaClientOptions, h as ArcaClientConfig, i as ArcaStore, j as ArcaWsaaSessionStore } from './types-BiznC1-X.js';
+export { e as ArcaAuthCredentials, d as ArcaAuthOptions, k as ArcaLogLevel, l as ArcaLoggerConfig, m as ArcaPadronServiceName, n as ArcaRepresentedTaxId, A as ArcaServiceName, o as ArcaServiceTarget, c as ArcaWsaaServiceId, p as ArcaWsaaSessionKey } from './types-BiznC1-X.js';
 import { PadronService } from './padron.js';
 export { CreatePadronServiceOptions, PadronTaxIdLookupResult, PadronTaxpayerResult, createPadronService } from './padron.js';
+import { S as SupportedVatRate, W as WsfeVoucherInput, a as WsfeVoucherInfo, b as WsfeDateInput, c as WsfeService } from './wsfe-DF0jAE2k.js';
+export { B as BuildFacturaBInput, d as BuildFacturaCInput, C as CreateWsfeServiceOptions, e as WsfeActivity, f as WsfeActivityType, g as WsfeAssociatedPeriod, h as WsfeAssociatedVoucher, i as WsfeAuthorizationOutcome, j as WsfeAuthorizationResult, k as WsfeAuthorizeVoucherInput, l as WsfeBuilderCurrencyInput, m as WsfeBuilderVatRate, n as WsfeBuyer, o as WsfeCatalogEntry, p as WsfeCurrencyType, q as WsfeOptionalField, r as WsfeQuotation, s as WsfeReceiverVatCondition, t as WsfeSalesPoint, u as WsfeServerStatus, v as WsfeTax, w as WsfeVatRate, x as WsfeVoucherLookupResult, y as buildFacturaB, z as buildFacturaC, A as createWsfeService } from './wsfe-DF0jAE2k.js';
 import { VoucherClass, ReceiverCondition } from './constants.js';
 export { ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS, ARCA_INVOICE_CLASS_BY_ISSUER, ARCA_ISSUER_CONDITION_IDS, ARCA_RECEIVER_CONDITION_IDS, IssuerCondition } from './constants.js';
-import { A as ArcaAuthorizationOutcome, a as ArcaFiscalIssue, b as ArcaSafeErrorMetadata } from './errors-B0uouRzR.js';
-export { c as ArcaAuthenticationError, d as ArcaAuthenticationErrorOptions, e as ArcaAuthenticationEvidence, f as ArcaAuthenticationReason, g as ArcaAuthorizationIndeterminateReason, h as ArcaConfigurationError, i as ArcaError, j as ArcaFiscalResultLevel, k as ArcaFiscalResults, l as ArcaFiscalService, m as ArcaInputError, n as ArcaInputErrorCode, o as ArcaInputErrorOptions, p as ArcaInvalidSoapResponseError, q as ArcaServiceError, r as ArcaSoapFaultError, s as ArcaTransportError, t as ArcaVoucherLookupResult, u as isArcaAuthenticationError, v as toArcaSafeErrorMetadata } from './errors-B0uouRzR.js';
-import { S as SupportedVatRate, W as WsfeVoucherInput, a as WsfeVoucherInfo, b as WsfeDateInput, c as WsfeService } from './wsfe-CG_erq7V.js';
-export { B as BuildFacturaBInput, d as BuildFacturaCInput, C as CreateWsfeServiceOptions, e as WsfeActivity, f as WsfeActivityType, g as WsfeAssociatedPeriod, h as WsfeAssociatedVoucher, i as WsfeAuthorizationOutcome, j as WsfeAuthorizationResult, k as WsfeAuthorizeVoucherInput, l as WsfeBuilderCurrencyInput, m as WsfeBuilderVatRate, n as WsfeBuyer, o as WsfeCatalogEntry, p as WsfeCurrencyType, q as WsfeOptionalField, r as WsfeQuotation, s as WsfeReceiverVatCondition, t as WsfeSalesPoint, u as WsfeServerStatus, v as WsfeTax, w as WsfeVatRate, x as WsfeVoucherLookupResult, y as buildFacturaB, z as buildFacturaC, A as createWsfeService } from './wsfe-CG_erq7V.js';
+import { A as ArcaAuthorizationOutcome, a as ArcaFiscalIssue, b as ArcaSafeErrorMetadata } from './fiscal-evidence-DBzakqBE.js';
+export { c as ArcaAuthenticationError, d as ArcaAuthenticationErrorOptions, e as ArcaAuthenticationEvidence, f as ArcaAuthenticationReason, g as ArcaAuthorizationIndeterminateReason, h as ArcaConfigurationError, i as ArcaError, j as ArcaFiscalResultLevel, k as ArcaFiscalResults, l as ArcaFiscalService, m as ArcaInputError, n as ArcaInputErrorCode, o as ArcaInputErrorOptions, p as ArcaInvalidSoapResponseError, q as ArcaServiceError, r as ArcaSoapFaultError, s as ArcaTransportError, t as ArcaVoucherLookupResult, u as isArcaAuthenticationError, v as toArcaSafeErrorMetadata } from './fiscal-evidence-DBzakqBE.js';
 import { WsmtxcaService } from './wsmtxca.js';
 export { CreateWsmtxcaServiceOptions, WsmtxcaAuthorizationOutcome, WsmtxcaAuthorizationResult, WsmtxcaAuthorizeVoucherInput, WsmtxcaLastAuthorizedVoucherResult, WsmtxcaSalesPoint, WsmtxcaSalesPointsResult, WsmtxcaVoucherInfo, WsmtxcaVoucherLookupOutcome, WsmtxcaVoucherLookupResult, createWsmtxcaService } from './wsmtxca.js';
-import './index-CVpygFb0.js';
+import './index-CVGQyyYM.js';
 
 type VatRate = SupportedVatRate | "exempt" | "untaxed";
 type VatItem = {
@@ -79,13 +79,14 @@ type WsfeIdentityMatch = {
     reason: string;
 };
 /**
- * Compares the invoice subset supported by vouchers.issue(). This proves
- * consistency, not authorship; callers must serialize writers per taxpayer,
- * sales point and voucher type. Unsupported exact-API extensions are incomplete.
+ * Compares the invoice subset supported by issue(). This proves
+ * consistency, not authorship. Configure a store and pass idempotencyKey for retries.
+ * Unsupported exact-API extensions are incomplete.
  */
 declare function matchWsfeVoucherIdentity(sent: WsfeVoucherInput, number: number, found: WsfeVoucherInfo): WsfeIdentityMatch;
 
 type IssueOptions = {
+    idempotencyKey?: string;
     representedTaxId?: number | string;
     forceRefresh?: boolean;
     include?: {
@@ -115,7 +116,7 @@ type WithSent<O extends IssueOptions> = O extends {
 type Evidence<K extends ArcaAuthorizationOutcome<"wsfe">["kind"], O extends IssueOptions> = WithRaw<Omit<Extract<ArcaAuthorizationOutcome<"wsfe">, {
     kind: K;
 }>, "raw">, O>;
-/** Fiscal outcomes are returned, never thrown or automatically resubmitted. */
+/** Fiscal outcomes are returned. Keyed replays authorize only after not_found. */
 type IssueOutcome<O extends IssueOptions = {
     include?: never;
 }> = ({
@@ -186,15 +187,17 @@ type IssueInput = IssueCommon & ({
 });
 
 type VouchersService = {
+    /** Creates a full credit note associated to an authorized A, B or C invoice. */
+    cancel<O extends IssueOptions & {
+        date?: WsfeDateInput;
+    } = {
+        include?: never;
+    }>(target: VoucherCoordinates, options?: O): Promise<IssueOutcome<O>>;
     /**
-     * Single-writer contract: serialize calls per (representedTaxId, salesPoint,
-     * voucherType), including concurrent promises in one process. The SDK does not
-     * coordinate writers; uncoordinated calls collide on ARCA 10016. Servers and
-     * queues must persist attempts and use wsfe.authorizeVoucherOutcome() directly.
-     * See the "does not serialize concurrent calls" test in services/vouchers.test.ts.
+     * Configure a store and pass idempotencyKey to recover retries after a crash.
      *
-     * One next-number read, one authorization attempt (zero transport retries), and
-     * at most one identity-matched lookup after indeterminate. Never resubmits.
+     * Without a key: one next-number read, one authorization and at most one lookup.
+     * Keyed replay consults the reserved number; only not_found permits a write.
      * Local validation and next-number read failures throw before authorization.
      */
     issue<O extends IssueOptions = {
@@ -213,19 +216,22 @@ type ArcaClientConfigView = Readonly<{
 /** Fully wired ARCA client with access to all service modules. */
 type ArcaClient = {
     readonly config: ArcaClientConfigView;
+    /** Issues an invoice from business input. Idempotent with a store and key. */
+    issue: VouchersService["issue"];
+    /** Issues a full credit note against an authorized invoice. */
+    cancel: VouchersService["cancel"];
     wsfe: WsfeService;
-    vouchers: VouchersService;
     wsmtxca: WsmtxcaService;
     padron: PadronService;
 };
 /**
  * Creates an ARCA client from the given configuration.
  * Validates the config, wires WSAA authentication and SOAP transport,
- * and returns an object with `.vouchers`, `.wsfe`, `.wsmtxca`, and `.padron` service modules.
+ * and returns an object with `issue()`, `cancel()` and the `.wsfe`, `.wsmtxca`, and `.padron` service modules.
  *
  * @throws {ArcaConfigurationError} When the config is missing or invalid.
  */
-declare function createArcaClient(config: ArcaClientConfig): ArcaClient;
+declare function createArcaClient(config?: ArcaClientOptions): ArcaClient;
 
 /** Valid ARCA environment names. */
 declare const ARCA_ENVIRONMENTS: readonly ["production", "test"];
@@ -259,6 +265,35 @@ declare function createArcaClientConfigFromEnv(options?: CreateArcaClientConfigF
  */
 declare function assertArcaClientConfig(config: ArcaClientConfig): void;
 
+/** Persistent store for a single server with a private durable volume. */
+declare function createFileStore(directory: string): ArcaStore;
+
+/** In-process store for tests; reservations do not survive a restart. */
+declare function createMemoryStore(): ArcaStore;
+
+type Row = {
+    key?: string;
+    value?: string;
+};
+/** Uses the caller's SQL client; provision the table before use. */
+declare function createPostgresStore({ query, table, }: {
+    query: (text: string, params: string[]) => Promise<Row[] | {
+        rows: Row[];
+    }>;
+    table?: string;
+}): ArcaStore;
+
+type RedisClient = {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: string): Promise<unknown>;
+    call?(...args: string[]): Promise<unknown>;
+    del?(key: string): Promise<unknown>;
+};
+/** Uses ioredis or Upstash without importing either driver. */
+declare function createRedisStore(client: RedisClient, options?: {
+    flavor?: "ioredis" | "upstash";
+}): ArcaStore;
+
 declare function createMemoryWsaaSessionStore(): ArcaWsaaSessionStore;
 
-export { ARCA_ENVIRONMENTS, ARCA_ENV_VARIABLES, type AmountItem, ArcaAuthorizationOutcome, type ArcaClient, ArcaClientConfig, type ArcaClientConfigView, ArcaEnvironment, ArcaFiscalIssue, ArcaSafeErrorMetadata, ArcaWsaaSessionStore, type CreateArcaClientConfigFromEnvOptions, type IssueAmounts, type IssueCommon, type IssueInput, type IssueOptions, type IssueOutcome, type IssuedVoucher, PadronService, type Receiver, ReceiverCondition, type VatItem, type VatRate, VoucherClass, type VoucherCoordinates, type VoucherSummary, type VouchersService, WsfeDateInput, type WsfeIdentityMatch, WsfeService, WsfeVoucherInfo, WsfeVoucherInput, WsmtxcaService, assertArcaClientConfig, createArcaClient, createArcaClientConfigFromEnv, createMemoryWsaaSessionStore, matchWsfeVoucherIdentity, resolveArcaEnvironment };
+export { ARCA_ENVIRONMENTS, ARCA_ENV_VARIABLES, type AmountItem, ArcaAuthorizationOutcome, type ArcaClient, ArcaClientOptions as ArcaClientConfig, type ArcaClientConfigView, ArcaEnvironment, ArcaFiscalIssue, ArcaSafeErrorMetadata, ArcaStore, ArcaWsaaSessionStore, type CreateArcaClientConfigFromEnvOptions, type IssueAmounts, type IssueCommon, type IssueInput, type IssueOptions, type IssueOutcome, type IssuedVoucher, PadronService, type Receiver, ReceiverCondition, type VatItem, type VatRate, VoucherClass, type VoucherCoordinates, type VoucherSummary, type VouchersService, WsfeDateInput, type WsfeIdentityMatch, WsfeService, WsfeVoucherInfo, WsfeVoucherInput, WsmtxcaService, assertArcaClientConfig, createArcaClient, createArcaClientConfigFromEnv, createFileStore, createMemoryStore, createMemoryWsaaSessionStore, createPostgresStore, createRedisStore, matchWsfeVoucherIdentity, resolveArcaEnvironment };