facturas 0.6.0 → 0.7.0

package/dist/fiscal-evidence-BQuBbJ3h.d.ts

@@ -0,0 +1,189 @@
+import { A as ArcaServiceName } from './types-BXq0da71.js';
+
+/** Base error class for all ARCA-related errors. */
+declare class ArcaError extends Error {
+    readonly code: string;
+    readonly name: string;
+    constructor(message: string, code?: string, options?: ErrorOptions);
+}
+/** Thrown when the ARCA client configuration is missing or invalid. */
+declare class ArcaConfigurationError extends ArcaError {
+    readonly name: string;
+    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 ArcaInputErrorOptions = ErrorOptions & {
+    code: ArcaInputErrorCode;
+    field?: string;
+    expected?: string;
+};
+/** Thrown when caller-provided input data is missing or invalid. */
+declare class ArcaInputError extends ArcaError {
+    readonly code: ArcaInputErrorCode;
+    readonly name: string;
+    readonly field?: string;
+    readonly expected?: string;
+    constructor(message: string, options: ArcaInputErrorOptions);
+}
+/** Stable reasons exposed for explicit ARCA authentication rejections. */
+type ArcaAuthenticationReason = "invalid_token" | "unauthorized_computer" | "missing_relationship" | "authentication_rejected";
+type ArcaAuthenticationErrorOptions = ErrorOptions & {
+    reason: ArcaAuthenticationReason;
+    service: ArcaServiceName;
+    operation: string;
+    providerCode?: string | number;
+};
+/** Thrown when ARCA explicitly rejects credentials before an operation runs. */
+declare class ArcaAuthenticationError extends ArcaError {
+    readonly code: "ARCA_AUTHENTICATION_ERROR";
+    readonly name: string;
+    readonly reason: ArcaAuthenticationReason;
+    readonly service: ArcaServiceName;
+    readonly operation: string;
+    readonly providerCode?: string | number;
+    constructor(message: string, options: ArcaAuthenticationErrorOptions);
+}
+/** Narrows unknown failures to the explicit authentication error contract. */
+declare function isArcaAuthenticationError(error: unknown): error is ArcaAuthenticationError;
+/** Thrown when an HTTP request to an ARCA endpoint fails at the transport level. */
+declare class ArcaTransportError extends ArcaError {
+    readonly name: string;
+    readonly statusCode?: number;
+    readonly contentType?: string;
+    readonly responseBodyLength?: number;
+    readonly responseBodyPreview?: string;
+    constructor(message: string, options?: ErrorOptions & {
+        statusCode?: number;
+        contentType?: string;
+        responseBodyLength?: number;
+        responseBodyPreview?: string;
+    });
+}
+/** Thrown when the SOAP response contains a Fault element. */
+declare class ArcaSoapFaultError extends ArcaError {
+    readonly name: string;
+    readonly faultCode?: string;
+    constructor(message: string, options?: ErrorOptions & {
+        faultCode?: string;
+    });
+}
+/** 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;
+    constructor(message: string, options?: ErrorOptions & {
+        service?: ArcaServiceName;
+        operation?: string;
+        endpointUrl?: string;
+        statusCode?: number;
+        contentType?: string;
+        responseBodyLength?: number;
+        responseBodyPreview?: string;
+    });
+}
+/** Thrown when an ARCA service (WSFE, WSMTXCA, Padron) returns a domain-level error. */
+declare class ArcaServiceError extends ArcaError {
+    readonly name: string;
+    readonly serviceCode?: string | number;
+    readonly service?: ArcaServiceName;
+    readonly operation?: string;
+    readonly result?: string;
+    readonly resultLevel?: ArcaFiscalResultLevel;
+    readonly results?: ArcaFiscalResults;
+    readonly cae?: string;
+    readonly issues?: readonly ArcaFiscalIssue[];
+    constructor(message: string, options?: ErrorOptions & {
+        serviceCode?: string | number;
+        service?: ArcaServiceName;
+        operation?: string;
+        result?: string;
+        resultLevel?: ArcaFiscalResultLevel;
+        results?: ArcaFiscalResults;
+        cae?: string;
+        issues?: readonly ArcaFiscalIssue[];
+    });
+}
+
+/** 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 { ArcaAuthenticationError as A, 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, type ArcaFiscalService as k, ArcaInputError as l, type ArcaInputErrorCode as m, type ArcaInputErrorOptions as n, ArcaInvalidSoapResponseError as o, ArcaServiceError as p, ArcaSoapFaultError as q, ArcaTransportError as r, type ArcaVoucherLookupResult as s, isArcaAuthenticationError as t };

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

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

package/dist/index.d.ts

@@ -1,18 +1,25 @@
-import { f as ArcaClientConfig, g as ArcaEnvironment, h as ArcaWsaaSessionStore } from './types-Cup-oevW.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-Cup-oevW.js';
+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 { PadronService } from './padron.js';
 export { CreatePadronServiceOptions, PadronTaxIdLookupResult, PadronTaxpayerResult, createPadronService } from './padron.js';
 import { WsfeService } from './wsfe.js';
-export { CreateWsfeServiceOptions, WsfeActivity, WsfeActivityType, WsfeAssociatedPeriod, WsfeAssociatedVoucher, WsfeAuthorizationOutcome, WsfeAuthorizationResult, WsfeAuthorizeVoucherInput, WsfeBuyer, WsfeCatalogEntry, WsfeCurrencyType, WsfeDateInput, WsfeOptionalField, WsfeQuotation, WsfeReceiverVatCondition, WsfeSalesPoint, WsfeServerStatus, WsfeTax, WsfeVatRate, WsfeVoucherInfo, WsfeVoucherInput, WsfeVoucherLookupResult, createWsfeService } from './wsfe.js';
+export { BuildFacturaBInput, BuildFacturaCInput, CreateWsfeServiceOptions, WsfeActivity, WsfeActivityType, WsfeAssociatedPeriod, WsfeAssociatedVoucher, WsfeAuthorizationOutcome, WsfeAuthorizationResult, WsfeAuthorizeVoucherInput, WsfeBuilderCurrencyInput, WsfeBuilderVatRate, WsfeBuyer, WsfeCatalogEntry, WsfeCurrencyType, WsfeDateInput, WsfeOptionalField, WsfeQuotation, WsfeReceiverVatCondition, WsfeSalesPoint, WsfeServerStatus, WsfeTax, WsfeVatRate, WsfeVoucherInfo, WsfeVoucherInput, WsfeVoucherLookupResult, buildFacturaB, buildFacturaC, createWsfeService } from './wsfe.js';
 import { WsmtxcaService } from './wsmtxca.js';
 export { CreateWsmtxcaServiceOptions, WsmtxcaAuthorizationOutcome, WsmtxcaAuthorizationResult, WsmtxcaAuthorizeVoucherInput, WsmtxcaLastAuthorizedVoucherResult, WsmtxcaSalesPoint, WsmtxcaSalesPointsResult, WsmtxcaVoucherInfo, WsmtxcaVoucherLookupOutcome, WsmtxcaVoucherLookupResult, createWsmtxcaService } from './wsmtxca.js';
-export { ArcaConfigurationError, ArcaError, ArcaInputError, ArcaInvalidSoapResponseError, ArcaServiceError, ArcaSoapFaultError, ArcaTransportError } from './errors.js';
-export { c as ArcaAuthorizationIndeterminateReason, d as ArcaAuthorizationOutcome, b as ArcaFiscalIssue, A as ArcaFiscalResultLevel, a as ArcaFiscalResults, e as ArcaFiscalService, f as ArcaVoucherLookupResult } from './fiscal-evidence-DbbFH74x.js';
-import './index-3fdgJ3c2.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 ArcaFiscalService, l as ArcaInputError, m as ArcaInputErrorCode, n as ArcaInputErrorOptions, o as ArcaInvalidSoapResponseError, p as ArcaServiceError, q as ArcaSoapFaultError, r as ArcaTransportError, s as ArcaVoucherLookupResult, t as isArcaAuthenticationError } from './fiscal-evidence-BQuBbJ3h.js';
+import './index-CVpygFb0.js';
 
+/** Immutable, credential-free operational view of an ARCA client configuration. */
+type ArcaClientConfigView = Readonly<{
+    taxId: string;
+    environment: ArcaEnvironment;
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+}>;
 /** Fully wired ARCA client with access to all service modules. */
 type ArcaClient = {
-    config: ArcaClientConfig;
+    readonly config: ArcaClientConfigView;
     wsfe: WsfeService;
     wsmtxca: WsmtxcaService;
     padron: PadronService;
@@ -60,4 +67,4 @@ declare function assertArcaClientConfig(config: ArcaClientConfig): void;
 
 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 };
+export { ARCA_ENVIRONMENTS, ARCA_ENV_VARIABLES, type ArcaClient, ArcaClientConfig, type ArcaClientConfigView, ArcaEnvironment, ArcaWsaaSessionStore, type CreateArcaClientConfigFromEnvOptions, PadronService, WsfeService, WsmtxcaService, assertArcaClientConfig, createArcaClient, createArcaClientConfigFromEnv, createMemoryWsaaSessionStore, resolveArcaEnvironment };