facturas 0.4.2 → 0.5.1

package/README.md

@@ -29,6 +29,10 @@ The package exports:
 - `facturas/errors`
 - `facturas/types`
 
+`facturas` also exports `createMemoryWsaaSessionStore()` for tests/local single-process coordination and the small `ArcaWsaaSessionStore` interface for applications that need to share WSAA tickets across workers through their own durable store.
+
+Authenticated WSFE and WSMTXCA methods accept `forceRefresh: true` when callers need to discard the cached WSAA TA and request a fresh Token Authorization for the same service.
+
 ## WSFE associated periods
 
 `client.wsfe.createNextVoucher({ data })` supports `associatedPeriod` for credit/debit notes that use `PeriodoAsoc` instead of `CbtesAsoc`:

package/dist/errors.d.ts

@@ -1,3 +1,5 @@
+import { A as ArcaServiceName } from './types-CKKe1Oo4.js';
+
 /** Base error class for all ARCA-related errors. */
 declare class ArcaError extends Error {
     readonly code: string;
@@ -21,9 +23,11 @@ declare class ArcaInputError extends ArcaError {
 declare class ArcaTransportError extends ArcaError {
     readonly name: string;
     readonly statusCode?: number;
+    readonly contentType?: string;
     readonly responseBody?: string;
     constructor(message: string, options?: ErrorOptions & {
         statusCode?: number;
+        contentType?: string;
         responseBody?: string;
     });
 }
@@ -37,6 +41,28 @@ declare class ArcaSoapFaultError extends ArcaError {
         detail?: unknown;
     });
 }
+/** Thrown when a response cannot be parsed as a valid SOAP envelope. */
+declare class ArcaInvalidSoapResponseError extends ArcaError {
+    readonly name: string;
+    readonly service?: ArcaServiceName;
+    readonly operation?: string;
+    readonly endpointUrl?: string;
+    readonly statusCode?: number;
+    readonly contentType?: string;
+    readonly responseBodyLength?: number;
+    readonly responseBodyPreview?: string;
+    readonly parsedDetail?: unknown;
+    constructor(message: string, options?: ErrorOptions & {
+        service?: ArcaServiceName;
+        operation?: string;
+        endpointUrl?: string;
+        statusCode?: number;
+        contentType?: string;
+        responseBodyLength?: number;
+        responseBodyPreview?: string;
+        parsedDetail?: unknown;
+    });
+}
 /** Thrown when an ARCA service (WSFE, WSMTXCA, Padron) returns a domain-level error. */
 declare class ArcaServiceError extends ArcaError {
     readonly name: string;
@@ -48,4 +74,4 @@ declare class ArcaServiceError extends ArcaError {
     });
 }
 
-export { ArcaConfigurationError, ArcaError, ArcaInputError, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError };
+export { ArcaConfigurationError, ArcaError, ArcaInputError, ArcaInvalidSoapResponseError, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError };

package/dist/errors.js

@@ -24,10 +24,12 @@ var ArcaInputError = class extends ArcaError {
 var ArcaTransportError = class extends ArcaError {
   name = "ArcaTransportError";
   statusCode;
+  contentType;
   responseBody;
   constructor(message, options) {
     super(message, "ARCA_TRANSPORT_ERROR", options);
     this.statusCode = options?.statusCode;
+    this.contentType = options?.contentType;
     this.responseBody = options?.responseBody;
   }
 };
@@ -41,6 +43,28 @@ var ArcaSoapFaultError = class extends ArcaError {
     this.detail = options?.detail;
   }
 };
+var ArcaInvalidSoapResponseError = class extends ArcaError {
+  name = "ArcaInvalidSoapResponseError";
+  service;
+  operation;
+  endpointUrl;
+  statusCode;
+  contentType;
+  responseBodyLength;
+  responseBodyPreview;
+  parsedDetail;
+  constructor(message, options) {
+    super(message, "ARCA_INVALID_SOAP_RESPONSE", options);
+    this.service = options?.service;
+    this.operation = options?.operation;
+    this.endpointUrl = options?.endpointUrl;
+    this.statusCode = options?.statusCode;
+    this.contentType = options?.contentType;
+    this.responseBodyLength = options?.responseBodyLength;
+    this.responseBodyPreview = options?.responseBodyPreview;
+    this.parsedDetail = options?.parsedDetail;
+  }
+};
 var ArcaServiceError = class extends ArcaError {
   name = "ArcaServiceError";
   serviceCode;
@@ -55,6 +79,7 @@ export {
   ArcaConfigurationError,
   ArcaError,
   ArcaInputError,
+  ArcaInvalidSoapResponseError,
   ArcaServiceError,
   ArcaSoapFaultError,
   ArcaTransportError

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["/** 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/** Thrown when caller-provided input data is missing or invalid. */\nexport class ArcaInputError extends ArcaError {\n  override readonly name: string = \"ArcaInputError\";\n  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_INPUT_ERROR\", options);\n    this.detail = options?.detail;\n  }\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 responseBody?: string;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      statusCode?: number;\n      responseBody?: string;\n    }\n  ) {\n    super(message, \"ARCA_TRANSPORT_ERROR\", options);\n    this.statusCode = options?.statusCode;\n    this.responseBody = options?.responseBody;\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  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      faultCode?: string;\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_SOAP_FAULT\", options);\n    this.faultCode = options?.faultCode;\n    this.detail = options?.detail;\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 detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      serviceCode?: string | number;\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_SERVICE_ERROR\", options);\n    this.serviceCode = options?.serviceCode;\n    this.detail = options?.detail;\n  }\n}\n"],"mappings":";AACO,IAAM,YAAN,cAAwB,MAAM;AAAA,EAC1B;AAAA,EACS,OAAe;AAAA,EAEjC,YAAY,SAAiB,OAAO,cAAc,SAAwB;AACxE,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,yBAAN,cAAqC,UAAU;AAAA,EAClC,OAAe;AAAA,EAEjC,YAAY,SAAiB,SAAwB;AACnD,UAAM,SAAS,4BAA4B,OAAO;AAAA,EACpD;AACF;AAGO,IAAM,iBAAN,cAA6B,UAAU;AAAA,EAC1B,OAAe;AAAA,EACxB;AAAA,EAET,YACE,SACA,SAGA;AACA,UAAM,SAAS,oBAAoB,OAAO;AAC1C,SAAK,SAAS,SAAS;AAAA,EACzB;AACF;AAGO,IAAM,qBAAN,cAAiC,UAAU;AAAA,EAC9B,OAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAET,YACE,SACA,SAIA;AACA,UAAM,SAAS,wBAAwB,OAAO;AAC9C,SAAK,aAAa,SAAS;AAC3B,SAAK,eAAe,SAAS;AAAA,EAC/B;AACF;AAGO,IAAM,qBAAN,cAAiC,UAAU;AAAA,EAC9B,OAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAET,YACE,SACA,SAIA;AACA,UAAM,SAAS,mBAAmB,OAAO;AACzC,SAAK,YAAY,SAAS;AAC1B,SAAK,SAAS,SAAS;AAAA,EACzB;AACF;AAGO,IAAM,mBAAN,cAA+B,UAAU;AAAA,EAC5B,OAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAET,YACE,SACA,SAIA;AACA,UAAM,SAAS,sBAAsB,OAAO;AAC5C,SAAK,cAAc,SAAS;AAC5B,SAAK,SAAS,SAAS;AAAA,EACzB;AACF;","names":[]}
+{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["import type { ArcaServiceName } from \"./internal/types\";\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/** Thrown when caller-provided input data is missing or invalid. */\nexport class ArcaInputError extends ArcaError {\n  override readonly name: string = \"ArcaInputError\";\n  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_INPUT_ERROR\", options);\n    this.detail = options?.detail;\n  }\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 responseBody?: string;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      statusCode?: number;\n      contentType?: string;\n      responseBody?: string;\n    }\n  ) {\n    super(message, \"ARCA_TRANSPORT_ERROR\", options);\n    this.statusCode = options?.statusCode;\n    this.contentType = options?.contentType;\n    this.responseBody = options?.responseBody;\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  readonly detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      faultCode?: string;\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_SOAP_FAULT\", options);\n    this.faultCode = options?.faultCode;\n    this.detail = options?.detail;\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  readonly parsedDetail?: unknown;\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      parsedDetail?: unknown;\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 = options?.responseBodyPreview;\n    this.parsedDetail = options?.parsedDetail;\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 detail?: unknown;\n\n  constructor(\n    message: string,\n    options?: ErrorOptions & {\n      serviceCode?: string | number;\n      detail?: unknown;\n    }\n  ) {\n    super(message, \"ARCA_SERVICE_ERROR\", options);\n    this.serviceCode = options?.serviceCode;\n    this.detail = options?.detail;\n  }\n}\n"],"mappings":";AAGO,IAAM,YAAN,cAAwB,MAAM;AAAA,EAC1B;AAAA,EACS,OAAe;AAAA,EAEjC,YAAY,SAAiB,OAAO,cAAc,SAAwB;AACxE,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,yBAAN,cAAqC,UAAU;AAAA,EAClC,OAAe;AAAA,EAEjC,YAAY,SAAiB,SAAwB;AACnD,UAAM,SAAS,4BAA4B,OAAO;AAAA,EACpD;AACF;AAGO,IAAM,iBAAN,cAA6B,UAAU;AAAA,EAC1B,OAAe;AAAA,EACxB;AAAA,EAET,YACE,SACA,SAGA;AACA,UAAM,SAAS,oBAAoB,OAAO;AAC1C,SAAK,SAAS,SAAS;AAAA,EACzB;AACF;AAGO,IAAM,qBAAN,cAAiC,UAAU;AAAA,EAC9B,OAAe;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,SACA,SAKA;AACA,UAAM,SAAS,wBAAwB,OAAO;AAC9C,SAAK,aAAa,SAAS;AAC3B,SAAK,cAAc,SAAS;AAC5B,SAAK,eAAe,SAAS;AAAA,EAC/B;AACF;AAGO,IAAM,qBAAN,cAAiC,UAAU;AAAA,EAC9B,OAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAET,YACE,SACA,SAIA;AACA,UAAM,SAAS,mBAAmB,OAAO;AACzC,SAAK,YAAY,SAAS;AAC1B,SAAK,SAAS,SAAS;AAAA,EACzB;AACF;AAGO,IAAM,+BAAN,cAA2C,UAAU;AAAA,EACxC,OAAe;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,SACA,SAUA;AACA,UAAM,SAAS,8BAA8B,OAAO;AACpD,SAAK,UAAU,SAAS;AACxB,SAAK,YAAY,SAAS;AAC1B,SAAK,cAAc,SAAS;AAC5B,SAAK,aAAa,SAAS;AAC3B,SAAK,cAAc,SAAS;AAC5B,SAAK,qBAAqB,SAAS;AACnC,SAAK,sBAAsB,SAAS;AACpC,SAAK,eAAe,SAAS;AAAA,EAC/B;AACF;AAGO,IAAM,mBAAN,cAA+B,UAAU;AAAA,EAC5B,OAAe;AAAA,EACxB;AAAA,EACA;AAAA,EAET,YACE,SACA,SAIA;AACA,UAAM,SAAS,sBAAsB,OAAO;AAC5C,SAAK,cAAc,SAAS;AAC5B,SAAK,SAAS,SAAS;AAAA,EACzB;AACF;","names":[]}

package/dist/{index-BLq3d6xg.d.ts → index-CqXVyU0E.d.ts}

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

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { A as ArcaClientConfig, a as ArcaEnvironment } from './types-SloiIQkT.js';
-export { b as ArcaAuthCredentials, c as ArcaAuthOptions, d as ArcaLogLevel, e as ArcaLoggerConfig, f as ArcaPadronServiceName, g as ArcaRepresentedTaxId, h as ArcaServiceName, i as ArcaServiceTarget, j as ArcaWsaaServiceId } from './types-SloiIQkT.js';
+import { f as ArcaClientConfig, g as ArcaEnvironment, h as ArcaWsaaSessionStore } from './types-CKKe1Oo4.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-CKKe1Oo4.js';
 import { PadronService } from './padron.js';
 export { CreatePadronServiceOptions, PadronTaxIdLookupResult, PadronTaxpayerResult, createPadronService } from './padron.js';
 import { WsfeService } from './wsfe.js';
 export { CreateWsfeServiceOptions, WsfeActivity, WsfeActivityType, WsfeAssociatedPeriod, WsfeAssociatedVoucher, WsfeAuthorizationResult, WsfeAuthorizeVoucherInput, WsfeBuyer, WsfeCatalogEntry, WsfeCurrencyType, WsfeDateInput, WsfeOptionalField, WsfeQuotation, WsfeReceiverVatCondition, WsfeSalesPoint, WsfeServerStatus, WsfeTax, WsfeVatRate, WsfeVoucherInfo, WsfeVoucherInput, createWsfeService } from './wsfe.js';
 import { WsmtxcaService } from './wsmtxca.js';
 export { CreateWsmtxcaServiceOptions, WsmtxcaAuthorizationResult, WsmtxcaLastAuthorizedVoucherResult, WsmtxcaVoucherLookupResult, createWsmtxcaService } from './wsmtxca.js';
-export { ArcaConfigurationError, ArcaError, ArcaInputError, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError } from './errors.js';
-import './index-BLq3d6xg.js';
+export { ArcaConfigurationError, ArcaError, ArcaInputError, ArcaInvalidSoapResponseError, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError } from './errors.js';
+import './index-CqXVyU0E.js';
 
 /** Fully wired ARCA client with access to all service modules. */
 type ArcaClient = {
@@ -57,4 +57,6 @@ declare function createArcaClientConfigFromEnv(options?: CreateArcaClientConfigF
  */
 declare function assertArcaClientConfig(config: ArcaClientConfig): void;
 
-export { ARCA_ENVIRONMENTS, ARCA_ENV_VARIABLES, type ArcaClient, ArcaClientConfig, ArcaEnvironment, type CreateArcaClientConfigFromEnvOptions, PadronService, WsfeService, WsmtxcaService, assertArcaClientConfig, createArcaClient, createArcaClientConfigFromEnv, resolveArcaEnvironment };
+declare function createMemoryWsaaSessionStore(): ArcaWsaaSessionStore;
+
+export { ARCA_ENVIRONMENTS, ARCA_ENV_VARIABLES, type ArcaClient, ArcaClientConfig, ArcaEnvironment, ArcaWsaaSessionStore, type CreateArcaClientConfigFromEnvOptions, PadronService, WsfeService, WsmtxcaService, assertArcaClientConfig, createArcaClient, createArcaClientConfigFromEnv, createMemoryWsaaSessionStore, resolveArcaEnvironment };