@lapyme/arca 0.1.0 → 0.2.0

package/README.md

@@ -5,7 +5,6 @@
 The package is ESM-first, supports Node.js `>=20`, and defaults to a safe configuration for open-source use:
 
 - WSAA credentials stay in memory by default.
-- Disk-backed WSAA caching is opt-in and requires an explicit directory.
 - The documented public surface is intentionally narrow.
 
 ## Install
@@ -28,7 +27,7 @@ const client = createArcaClient(
   })
 );
 
-const nextVoucher = await client.wsfe.getLastVoucher({
+const nextVoucher = await client.wsfe.getNextVoucherNumber({
   salesPoint: 1,
   voucherType: 6,
 });
@@ -60,40 +59,16 @@ const client = createArcaClient({
 });
 ```
 
-### Opt-in disk cache for WSAA credentials
-
-By default, WSAA login tickets are cached in memory only. To persist them across process restarts, enable disk cache explicitly:
-
-```ts
-import { createArcaClient } from "@lapyme/arca";
-
-const client = createArcaClient({
-  taxId: "20123456789",
-  certificatePem: process.env.ARCA_CERTIFICATE_PEM!,
-  privateKeyPem: process.env.ARCA_PRIVATE_KEY_PEM!,
-  environment: "production",
-  wsaa: {
-    cache: {
-      mode: "disk",
-      directory: ".arca-wsaa-cache",
-    },
-  },
-});
-```
-
-Environment-based configuration also supports:
-
-- `ARCA_WSAA_CACHE_MODE` with `memory` or `disk`
-- `ARCA_WSAA_CACHE_DIRECTORY` when `ARCA_WSAA_CACHE_MODE=disk`
-
 ## Supported Modules
 
 ### `client.wsfe`
 
 WSFE electronic invoicing. All inputs and outputs use JS-convention names; the library maps them to AFIP's SOAP schema internally.
 
+- WSFE request date fields accept `YYYY-MM-DD` or `YYYYMMDD` strings.
 - `createNextVoucher({ data })` — Authorizes a new voucher. Takes a typed `WsfeVoucherInput` and returns `WsfeAuthorizationResult` with `cae`, `caeExpiry`, `voucherNumber`, and `raw`.
-- `getLastVoucher({ salesPoint, voucherType })` — Returns the next available voucher number.
+- `getNextVoucherNumber({ salesPoint, voucherType })` — Returns the next available voucher number.
+- `getLastVoucher({ salesPoint, voucherType })` — Deprecated alias for `getNextVoucherNumber()`.
 - `getSalesPoints({})` — Lists configured points of sale as `WsfeSalesPoint[]`.
 - `getVoucherInfo({ number, salesPoint, voucherType })` — Retrieves voucher details as `WsfeVoucherInfo | null`.
 
@@ -170,8 +145,7 @@ pnpm pack:check
 ## Security Notes
 
 - Treat your certificate and private key as secrets.
-- Default in-memory WSAA caching avoids silent disk writes.
-- If you enable disk cache, point it at a directory with appropriate filesystem permissions for your runtime.
+- WSAA credentials are cached in memory only and are never written to disk by this package.
 
 ## License
 

package/dist/errors.d.ts

@@ -9,6 +9,14 @@ declare class ArcaConfigurationError extends ArcaError {
     readonly name: string;
     constructor(message: string, options?: ErrorOptions);
 }
+/** Thrown when caller-provided input data is missing or invalid. */
+declare class ArcaInputError extends ArcaError {
+    readonly name: string;
+    readonly detail?: unknown;
+    constructor(message: string, options?: ErrorOptions & {
+        detail?: unknown;
+    });
+}
 /** Thrown when an HTTP request to an ARCA endpoint fails at the transport level. */
 declare class ArcaTransportError extends ArcaError {
     readonly name: string;
@@ -40,4 +48,4 @@ declare class ArcaServiceError extends ArcaError {
     });
 }
 
-export { ArcaConfigurationError, ArcaError, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError };
+export { ArcaConfigurationError, ArcaError, ArcaInputError, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError };

package/dist/errors.js

@@ -13,6 +13,14 @@ var ArcaConfigurationError = class extends ArcaError {
     super(message, "ARCA_CONFIGURATION_ERROR", options);
   }
 };
+var ArcaInputError = class extends ArcaError {
+  name = "ArcaInputError";
+  detail;
+  constructor(message, options) {
+    super(message, "ARCA_INPUT_ERROR", options);
+    this.detail = options?.detail;
+  }
+};
 var ArcaTransportError = class extends ArcaError {
   name = "ArcaTransportError";
   statusCode;
@@ -46,6 +54,7 @@ var ArcaServiceError = class extends ArcaError {
 export {
   ArcaConfigurationError,
   ArcaError,
+  ArcaInputError,
   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\nclass ArcaNotImplementedError extends ArcaError {\n  override readonly name: string = \"ArcaNotImplementedError\";\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"ARCA_NOT_IMPLEMENTED\", options);\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;AAWO,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":["/** 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":[]}

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

@@ -1,4 +1,4 @@
-import { j as ArcaSoapExecutionOptions, k as ArcaSoapResponse, i as ArcaWsaaServiceId, c as ArcaAuthOptions, b as ArcaAuthCredentials } from './types-DWsYue4B.js';
+import { k as ArcaSoapExecutionOptions, l as ArcaSoapResponse, j as ArcaWsaaServiceId, c as ArcaAuthOptions, b as ArcaAuthCredentials } from './types-SloiIQkT.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-DWsYue4B.js';
-export { b as ArcaAuthCredentials, c as ArcaAuthOptions, d as ArcaPadronServiceName, e as ArcaRepresentedTaxId, f as ArcaServiceName, g as ArcaServiceTarget, h as ArcaWsaaCacheConfig, i as ArcaWsaaServiceId } from './types-DWsYue4B.js';
+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 { PadronService } from './padron.js';
 export { CreatePadronServiceOptions, PadronTaxIdLookupResult, PadronTaxpayerResult, createPadronService } from './padron.js';
 import { WsfeService } from './wsfe.js';
-export { CreateWsfeServiceOptions, WsfeAssociatedVoucher, WsfeAuthorizationResult, WsfeBuyer, WsfeOptionalField, WsfeSalesPoint, WsfeTax, WsfeVatRate, WsfeVoucherInfo, WsfeVoucherInput, createWsfeService } from './wsfe.js';
+export { CreateWsfeServiceOptions, WsfeAssociatedVoucher, WsfeAuthorizationResult, WsfeBuyer, WsfeCatalogEntry, WsfeCurrencyType, WsfeDateInput, WsfeOptionalField, WsfeQuotation, 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, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError } from './errors.js';
-import './index-vWZOjFDO.js';
+export { ArcaConfigurationError, ArcaError, ArcaInputError, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError } from './errors.js';
+import './index-BLq3d6xg.js';
 
 /** Fully wired ARCA client with access to all service modules. */
 type ArcaClient = {
@@ -33,8 +33,6 @@ declare const ARCA_ENV_VARIABLES: {
     readonly certificatePem: "ARCA_CERTIFICATE_PEM";
     readonly privateKeyPem: "ARCA_PRIVATE_KEY_PEM";
     readonly environment: "ARCA_ENVIRONMENT";
-    readonly wsaaCacheMode: "ARCA_WSAA_CACHE_MODE";
-    readonly wsaaCacheDirectory: "ARCA_WSAA_CACHE_DIRECTORY";
 };
 type ArcaClientConfigEnvironment = Record<string, string | undefined>;
 /** Options for {@link createArcaClientConfigFromEnv}. */