@ramiidv/arca-padron 0.3.0 → 0.4.0

package/dist/esm/errors.js

@@ -1,26 +1,55 @@
-// Base errors re-exported from common
-export { ArcaError, ArcaAuthError, ArcaSoapError, ArcaServiceError, ArcaTicketVigenteError } from '@ramiidv/arca-common';
-import { ArcaError, ArcaServiceError } from '@ramiidv/arca-common';
+import { ArcaError, ArcaServiceError, ArcaSoapError } from '@ramiidv/arca-common';
 /**
- * Base error for Padrón SDK.
- * Extends ArcaError from common for backward compatibility.
+ * Error propio del SDK de Padrón que no es de negocio ni de transporte: la
+ * respuesta de ARCA no tiene un dato obligatorio (ej: `personaReturn` sin
+ * `persona`) o tiene una forma inesperada.
  */
 export class ArcaPadronError extends ArcaError {
     static code = 'ARCA_PADRON_ERROR';
-    constructor(message) {
-        super(message);
+    constructor(message, options) {
+        super(message, options);
         this.name = 'ArcaPadronError';
     }
 }
 /**
- * Error de servicio de Padrón (errores de negocio).
- * Extiende ArcaServiceError de common.
+ * Error de negocio de Padrón (CUIT inexistente, clave inactiva, token no
+ * autorizado, etc.). ARCA los informa como SOAP Fault: el SDK los convierte en
+ * este error con un `reason` tipado. El `ArcaSoapError` original queda en
+ * `cause` y el texto de ARCA en `errors[0].msg`. No se reintentan.
  */
 export class ArcaPadronServiceError extends ArcaServiceError {
     static code = 'ARCA_PADRON_SERVICE_ERROR';
-    constructor(message, errors) {
-        super(message, errors);
+    reason;
+    constructor(message, errors, options) {
+        super(message, errors, options?.cause !== undefined ? { cause: options.cause } : undefined);
         this.name = 'ArcaPadronServiceError';
+        this.reason = options?.reason ?? 'otro';
     }
 }
+const FAULT_REASONS = [
+    [/es inexistente|no existe persona/i, 'inexistente'],
+    [/se encuentra inactiva/i, 'inactiva'],
+    [/id de la persona no es v[aá]lido/i, 'id_invalido'],
+    [/no autorizado|falta token|debe enviar la cuit representada|no le permite actuar en representaci[oó]n/i, 'no_autorizado'],
+];
+/** Motivo de un mensaje de error de negocio de Padrón, o `undefined` si no es uno conocido. */
+export function padronErrorReason(message) {
+    return FAULT_REASONS.find(([re]) => re.test(message))?.[1];
+}
+/**
+ * Convierte un SOAP Fault de negocio conocido en `ArcaPadronServiceError`.
+ * Cualquier otro error (transporte, timeout, Fault desconocido) se devuelve
+ * sin cambios.
+ */
+export function toPadronError(err, method) {
+    if (!(err instanceof ArcaSoapError) || err.faultString === undefined)
+        return err;
+    const reason = padronErrorReason(err.faultString);
+    if (!reason)
+        return err;
+    const detail = { code: 0, msg: err.faultString };
+    if (err.faultCode)
+        detail.rawCode = err.faultCode;
+    return new ArcaPadronServiceError(`${method}: ${err.faultString}`, [detail], { reason, cause: err });
+}
 //# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACzH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,MAAM,CAAmB,IAAI,GAAW,mBAAmB,CAAC;IAE5D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;;AAGH;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IAC1D,MAAM,CAAmB,IAAI,GAAW,2BAA2B,CAAC;IAEpE,YAAY,OAAe,EAAE,MAAuC;QAClE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGlF;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,MAAM,CAAmB,IAAI,GAAW,mBAAmB,CAAC;IAE5D,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;;AAkBH;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IAC1D,MAAM,CAAmB,IAAI,GAAW,2BAA2B,CAAC;IACpD,MAAM,CAAoB;IAE1C,YACE,OAAe,EACf,MAA4B,EAC5B,OAAyD;QAEzD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC;IAC1C,CAAC;;AAGH,MAAM,aAAa,GAAuC;IACxD,CAAC,mCAAmC,EAAE,aAAa,CAAC;IACpD,CAAC,wBAAwB,EAAE,UAAU,CAAC;IACtC,CAAC,mCAAmC,EAAE,aAAa,CAAC;IACpD,CAAC,uGAAuG,EAAE,eAAe,CAAC;CAC3H,CAAC;AAEF,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,MAAc;IACxD,IAAI,CAAC,CAAC,GAAG,YAAY,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACjF,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC;IACxB,MAAM,MAAM,GAAuB,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;IACrE,IAAI,GAAG,CAAC,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC;IAClD,OAAO,IAAI,sBAAsB,CAAC,GAAG,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AACvG,CAAC"}

package/dist/esm/index.d.ts

@@ -1,16 +1,24 @@
+import { checkServiceErrors as commonCheckServiceErrors } from '@ramiidv/arca-common';
 export { ArcaPadron } from './arca-padron.js';
 export { condicionIvaDesdePadron } from './condicion-iva.js';
 export { MemoryTicketStorage, FileTicketStorage } from '@ramiidv/arca-common';
-export { ArcaError, ArcaAuthError, ArcaTicketVigenteError, ArcaSoapError, ArcaServiceError, ArcaPadronError, ArcaPadronServiceError, } from './errors.js';
-export { BasePadronClient, type PadronClientConfig } from './base-client.js';
-export { WsaaClient } from './wsaa.js';
-export type { WsaaClientConfig } from './wsaa.js';
-export { PadronA5Client, type PadronA5ClientConfig } from './padron-a5.js';
+export { ArcaError, ArcaAuthError, ArcaTicketVigenteError, ArcaSoapError, ArcaServiceError, ArcaValidationError, } from '@ramiidv/arca-common';
+export { ArcaPadronError, ArcaPadronServiceError, type PadronErrorReason } from './errors.js';
+export { BasePadronClient, type PadronClientConfig, type PadronSoapOptions } from './base-client.js';
+export { WsaaClient } from '@ramiidv/arca-common';
+export type { WsaaClientConfig } from '@ramiidv/arca-common';
+export { PadronA5Client, MAX_PERSONA_LIST, type PadronA5ClientConfig } from './padron-a5.js';
 export { PadronA4Client, type PadronA4ClientConfig } from './padron-a4.js';
 export { PadronA13Client, type PadronA13ClientConfig } from './padron-a13.js';
 export { PadronA10Client, type PadronA10ClientConfig } from './padron-a10.js';
 export { PadronA100Client, type PadronA100ClientConfig } from './padron-a100.js';
-export type { ArcaPadronConfig, AccessTicket, TicketStorage, CallOptions, WsAuth, SoapCallOptions, ServerStatus, ArcaEvent, ArcaPadronEvent, PersonaA4, DependenciaA4, DomicilioA4, ImpuestoA4, ActividadA4, RegimenA4, RelacionA4, CategoriaA4, EmailA4, TelefonoA4, PersonaA10, DependenciaA10, DomicilioA10, ParameterRecord, ParameterAttribute, PersonaA13, DomicilioA13, PersonaA5, DomicilioA5, DependenciaA5, CaracterizacionA5, ImpuestoA5, ActividadA5, CategoriaA5, RegimenA5, RegimenGeneralA5, MonotributoA5, ErrorConstanciaA5, ErrorRegimenA5, CondicionIvaPadron, } from './types.js';
-export { ENDPOINTS, Provincia, TipoDocumento, CondicionIva, TipoDomicilio, TipoPersona, ImpuestoId, EstadoClave, CollectionName, } from './constants.js';
-export { ensureArray, parseXml, buildXml, checkServiceErrors } from './soap-client.js';
+export type { ArcaPadronConfig, PadronServicio, PadronStatus, AccessTicket, TicketStorage, CallOptions, WsAuth, SoapCallOptions, ServerStatus, ArcaEvent, ArcaPadronEvent, PersonaA4, DependenciaA4, DomicilioA4, ImpuestoA4, ActividadA4, RegimenA4, RelacionA4, CategoriaA4, EmailA4, TelefonoA4, PersonaA10, DependenciaA10, DomicilioA10, ParameterRecord, ParameterAttribute, PersonaA13, DomicilioA13, PersonaA5, DomicilioA5, DependenciaA5, CaracterizacionA5, ComponenteSociedadA5, ImpuestoA5, ActividadA5, CategoriaA5, RegimenA5, RegimenGeneralA5, MonotributoA5, ErrorConstanciaA5, ErrorRegimenA5, CondicionIvaPadron, } from './types.js';
+export { ENDPOINTS, Provincia, DocTipo, TipoDocumento, CondicionIva, TipoDomicilio, TipoPersona, ImpuestoId, EstadoClave, CollectionName, } from './constants.js';
+export { ensureArray, parseXml, buildXml } from '@ramiidv/arca-common';
+/**
+ * @deprecated Padrón no devuelve errores de negocio en el body (los informa
+ * como SOAP Fault, que el SDK ya convierte en `ArcaPadronServiceError`). Si lo
+ * necesitás para otro servicio, importalo de `@ramiidv/arca-common`.
+ */
+export declare const checkServiceErrors: typeof commonCheckServiceErrors;
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,EACL,SAAS,EACT,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,MAAM,EACN,eAAe,EACf,YAAY,EACZ,SAAS,EACT,eAAe,EACf,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,IAAI,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGtF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,EACL,SAAS,EACT,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG9F,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrG,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,MAAM,EACN,eAAe,EACf,YAAY,EACZ,SAAS,EACT,eAAe,EACf,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,SAAS,EACT,OAAO,EACP,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,iCAA2B,CAAC"}

package/dist/esm/index.js

@@ -1,22 +1,30 @@
+import { checkServiceErrors as commonCheckServiceErrors } from '@ramiidv/arca-common';
 // Main class
 export { ArcaPadron } from './arca-padron.js';
 // Helpers puros
 export { condicionIvaDesdePadron } from './condicion-iva.js';
 // Persistencia de tickets (desde arca-common)
 export { MemoryTicketStorage, FileTicketStorage } from '@ramiidv/arca-common';
-// Error classes (base from common, domain-specific local)
-export { ArcaError, ArcaAuthError, ArcaTicketVigenteError, ArcaSoapError, ArcaServiceError, ArcaPadronError, ArcaPadronServiceError, } from './errors.js';
+// Error classes
+export { ArcaError, ArcaAuthError, ArcaTicketVigenteError, ArcaSoapError, ArcaServiceError, ArcaValidationError, } from '@ramiidv/arca-common';
+export { ArcaPadronError, ArcaPadronServiceError } from './errors.js';
 // Base class
 export { BasePadronClient } from './base-client.js';
 // Low-level clients
-export { WsaaClient } from './wsaa.js';
-export { PadronA5Client } from './padron-a5.js';
+export { WsaaClient } from '@ramiidv/arca-common';
+export { PadronA5Client, MAX_PERSONA_LIST } from './padron-a5.js';
 export { PadronA4Client } from './padron-a4.js';
 export { PadronA13Client } from './padron-a13.js';
 export { PadronA10Client } from './padron-a10.js';
 export { PadronA100Client } from './padron-a100.js';
 // Constants and enums
-export { ENDPOINTS, Provincia, TipoDocumento, CondicionIva, TipoDomicilio, TipoPersona, ImpuestoId, EstadoClave, CollectionName, } from './constants.js';
+export { ENDPOINTS, Provincia, DocTipo, TipoDocumento, CondicionIva, TipoDomicilio, TipoPersona, ImpuestoId, EstadoClave, CollectionName, } from './constants.js';
 // Utilities (from common)
-export { ensureArray, parseXml, buildXml, checkServiceErrors } from './soap-client.js';
+export { ensureArray, parseXml, buildXml } from '@ramiidv/arca-common';
+/**
+ * @deprecated Padrón no devuelve errores de negocio en el body (los informa
+ * como SOAP Fault, que el SDK ya convierte en `ArcaPadronServiceError`). Si lo
+ * necesitás para otro servicio, importalo de `@ramiidv/arca-common`.
+ */
+export const checkServiceErrors = commonCheckServiceErrors;
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,8CAA8C;AAC9C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,0DAA0D;AAC1D,OAAO,EACL,SAAS,EACT,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EAAE,gBAAgB,EAA2B,MAAM,kBAAkB,CAAC;AAE7E,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAA8B,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAA8B,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAA+B,MAAM,kBAAkB,CAAC;AA6CjF,sBAAsB;AACtB,OAAO,EACL,SAAS,EACT,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,IAAI,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,8CAA8C;AAC9C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,gBAAgB;AAChB,OAAO,EACL,SAAS,EACT,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAA0B,MAAM,aAAa,CAAC;AAE9F,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAmD,MAAM,kBAAkB,CAAC;AAErG,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAA6B,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAA8B,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAA8B,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAA+B,MAAM,kBAAkB,CAAC;AAgDjF,sBAAsB;AACtB,OAAO,EACL,SAAS,EACT,SAAS,EACT,OAAO,EACP,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC"}

package/dist/esm/mapping.d.ts

@@ -1,9 +1,52 @@
+import type { DependenciaA4, DomicilioA10 } from './types.js';
 /** Registro de una respuesta SOAP parseada. */
 export type SoapRecord = Record<string, unknown>;
-/** Convierte a string, o `undefined` si el valor no vino. */
+/**
+ * `true` si el valor no vino o es un elemento `xsi:nil="true"` (el parser deja
+ * el atributo como `@_nil` o `@_xsi:nil`). Los WSDL de Padrón declaran
+ * `nillable` los elementos repetidos.
+ */
+export declare function isNil(v: unknown): boolean;
+/** Convierte a string, o `undefined` si el valor no vino. Para campos `xs:string`/`xs:long`/`xs:dateTime`. */
 export declare const optString: (v: unknown) => string | undefined;
-/** Convierte a número, o `undefined` si el valor no vino. */
+/** Convierte a número, o `undefined` si el valor no vino. Para campos `xs:int`/`xs:double`. */
 export declare const optNumber: (v: unknown) => number | undefined;
-/** Normaliza un elemento SOAP que puede venir solo, repetido o ausente. */
+/** Normaliza un elemento complejo que puede venir solo, repetido, ausente o nil. */
 export declare const records: (v: unknown) => SoapRecord[];
+/** Elemento complejo opcional (`undefined` si no vino, vino vacío o es nil). */
+export declare const record: (v: unknown) => SoapRecord | undefined;
+/** Lista de valores simples repetidos (ej: `claveInactivaAsociada`, `error`), sin los nil. */
+export declare const strings: (v: unknown) => string[];
+/** String obligatorio: lanza `ArcaPadronError` si no vino. */
+export declare function reqString(v: unknown, field: string): string;
+/** Número obligatorio: lanza `ArcaPadronError` si no vino. */
+export declare function reqNumber(v: unknown, field: string): number;
+/** `tipoPersona` obligatorio (`FISICA` | `JURIDICA`). */
+export declare function tipoPersona(v: unknown, field?: string): 'FISICA' | 'JURIDICA';
+/**
+ * Elemento `persona` de `personaReturn` (A4, A10, A13). Si falta, lanza
+ * `ArcaPadronError`: nunca se inventa una persona vacía.
+ */
+export declare function requirePersona(result: SoapRecord, method: string): SoapRecord;
+/** `dependencia` de A4/A10: `{descripcionDependencia, idDependencia}`. */
+export declare function mapDependencia(v: unknown): DependenciaA4 | undefined;
+/** `domicilio` de A4/A10/constancia (todos `xs:string` salvo `idProvincia`). */
+export declare function mapDomicilio(d: SoapRecord): DomicilioA10;
+/** Campos comunes de `persona` en A4 y A10. */
+export declare function mapPersonaComun(raw: SoapRecord): {
+    idPersona: string;
+    tipoPersona: "FISICA" | "JURIDICA";
+    tipoClave: string | undefined;
+    estadoClave: string | undefined;
+    nombre: string | undefined;
+    apellido: string | undefined;
+    razonSocial: string | undefined;
+    numeroDocumento: string | undefined;
+    tipoDocumento: string | undefined;
+};
+/** Asigna `dependencia` y `claveInactivaAsociada` solo si vinieron. */
+export declare function asignarDependenciaYClaves(target: {
+    dependencia?: DependenciaA4;
+    claveInactivaAsociada?: string[];
+}, raw: SoapRecord): void;
 //# sourceMappingURL=mapping.d.ts.map

package/dist/esm/mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/mapping.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,6DAA6D;AAC7D,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,KAAG,MAAM,GAAG,SACO,CAAC;AAExD,6DAA6D;AAC7D,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,KAAG,MAAM,GAAG,SACmB,CAAC;AAEpE,2EAA2E;AAC3E,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,KAAG,UAAU,EAA6D,CAAC"}
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/mapping.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAKzC;AAYD,8GAA8G;AAC9G,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,KAAG,MAAM,GAAG,SAG/C,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,KAAG,MAAM,GAAG,SAG/C,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,KAAG,UAAU,EAG5C,CAAC;AAEJ,gFAAgF;AAChF,eAAO,MAAM,MAAM,GAAI,GAAG,OAAO,KAAG,UAAU,GAAG,SACsD,CAAC;AAExG,8FAA8F;AAC9F,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,KAAG,MAAM,EACgC,CAAC;AAM5E,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,SAAwB,GAAG,QAAQ,GAAG,UAAU,CAE5F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAI7E;AAMD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAIpE;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,YAAY,CAWxD;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU;;;;;;;;;;EAY9C;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CACvC,MAAM,EAAE;IAAE,WAAW,CAAC,EAAE,aAAa,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EACzE,GAAG,EAAE,UAAU,GACd,IAAI,CAIN"}

package/dist/esm/mapping.js

@@ -1,8 +1,118 @@
-import { ensureArray } from './soap-client.js';
-/** Convierte a string, o `undefined` si el valor no vino. */
-export const optString = (v) => v === undefined || v === null ? undefined : String(v);
-/** Convierte a número, o `undefined` si el valor no vino. */
-export const optNumber = (v) => v === undefined || v === null || v === '' ? undefined : Number(v);
-/** Normaliza un elemento SOAP que puede venir solo, repetido o ausente. */
-export const records = (v) => ensureArray(v);
+import { ensureArray } from '@ramiidv/arca-common';
+import { ArcaPadronError } from './errors.js';
+/**
+ * `true` si el valor no vino o es un elemento `xsi:nil="true"` (el parser deja
+ * el atributo como `@_nil` o `@_xsi:nil`). Los WSDL de Padrón declaran
+ * `nillable` los elementos repetidos.
+ */
+export function isNil(v) {
+    if (v === undefined || v === null)
+        return true;
+    if (typeof v !== 'object' || Array.isArray(v))
+        return false;
+    const o = v;
+    return Object.keys(o).some((k) => /^@_(?:[\w-]+:)?nil$/.test(k) && String(o[k]) === 'true');
+}
+/** Valor de texto de un elemento simple (`undefined` si no vino o es nil). */
+function text(v) {
+    if (isNil(v))
+        return undefined;
+    if (typeof v === 'object') {
+        const o = v;
+        return Object.hasOwn(o, '#text') ? o['#text'] : undefined;
+    }
+    return v;
+}
+/** Convierte a string, o `undefined` si el valor no vino. Para campos `xs:string`/`xs:long`/`xs:dateTime`. */
+export const optString = (v) => {
+    const t = text(v);
+    return t === undefined ? undefined : String(t);
+};
+/** Convierte a número, o `undefined` si el valor no vino. Para campos `xs:int`/`xs:double`. */
+export const optNumber = (v) => {
+    const t = text(v);
+    return t === undefined || t === '' ? undefined : Number(t);
+};
+/** Normaliza un elemento complejo que puede venir solo, repetido, ausente o nil. */
+export const records = (v) => ensureArray(v).filter((x) => typeof x === 'object' && x !== null && !isNil(x));
+/** Elemento complejo opcional (`undefined` si no vino, vino vacío o es nil). */
+export const record = (v) => typeof v === 'object' && v !== null && !Array.isArray(v) && !isNil(v) ? v : undefined;
+/** Lista de valores simples repetidos (ej: `claveInactivaAsociada`, `error`), sin los nil. */
+export const strings = (v) => ensureArray(v).map(optString).filter((s) => s !== undefined);
+function missing(field) {
+    return new ArcaPadronError(`Respuesta inválida de ARCA: falta ${field}`);
+}
+/** String obligatorio: lanza `ArcaPadronError` si no vino. */
+export function reqString(v, field) {
+    const s = optString(v);
+    if (s === undefined || s === '')
+        throw missing(field);
+    return s;
+}
+/** Número obligatorio: lanza `ArcaPadronError` si no vino. */
+export function reqNumber(v, field) {
+    const n = optNumber(v);
+    if (n === undefined || Number.isNaN(n))
+        throw missing(field);
+    return n;
+}
+/** `tipoPersona` obligatorio (`FISICA` | `JURIDICA`). */
+export function tipoPersona(v, field = 'persona.tipoPersona') {
+    return reqString(v, field);
+}
+/**
+ * Elemento `persona` de `personaReturn` (A4, A10, A13). Si falta, lanza
+ * `ArcaPadronError`: nunca se inventa una persona vacía.
+ */
+export function requirePersona(result, method) {
+    const persona = record(result['persona']);
+    if (!persona)
+        throw new ArcaPadronError(`Respuesta inválida de ARCA (${method}): personaReturn sin persona`);
+    return persona;
+}
+// ---------------------------------------------------------------------------
+// Bloques comunes de A4 y A10 (mismos tipos en los dos WSDL)
+// ---------------------------------------------------------------------------
+/** `dependencia` de A4/A10: `{descripcionDependencia, idDependencia}`. */
+export function mapDependencia(v) {
+    const d = record(v);
+    if (!d)
+        return undefined;
+    return { idDependencia: optNumber(d['idDependencia']), descripcionDependencia: optString(d['descripcionDependencia']) };
+}
+/** `domicilio` de A4/A10/constancia (todos `xs:string` salvo `idProvincia`). */
+export function mapDomicilio(d) {
+    return {
+        direccion: optString(d['direccion']),
+        localidad: optString(d['localidad']),
+        codPostal: optString(d['codPostal']),
+        idProvincia: optNumber(d['idProvincia']),
+        descripcionProvincia: optString(d['descripcionProvincia']),
+        tipoDomicilio: optString(d['tipoDomicilio']),
+        datoAdicional: optString(d['datoAdicional']),
+        tipoDatoAdicional: optString(d['tipoDatoAdicional']),
+    };
+}
+/** Campos comunes de `persona` en A4 y A10. */
+export function mapPersonaComun(raw) {
+    return {
+        idPersona: reqString(raw['idPersona'], 'persona.idPersona'),
+        tipoPersona: tipoPersona(raw['tipoPersona']),
+        tipoClave: optString(raw['tipoClave']),
+        estadoClave: optString(raw['estadoClave']),
+        nombre: optString(raw['nombre']),
+        apellido: optString(raw['apellido']),
+        razonSocial: optString(raw['razonSocial']),
+        numeroDocumento: optString(raw['numeroDocumento']),
+        tipoDocumento: optString(raw['tipoDocumento']),
+    };
+}
+/** Asigna `dependencia` y `claveInactivaAsociada` solo si vinieron. */
+export function asignarDependenciaYClaves(target, raw) {
+    const dependencia = mapDependencia(raw['dependencia']);
+    if (dependencia)
+        target.dependencia = dependencia;
+    if (raw['claveInactivaAsociada'] !== undefined)
+        target.claveInactivaAsociada = strings(raw['claveInactivaAsociada']);
+}
 //# sourceMappingURL=mapping.js.map

package/dist/esm/mapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK/C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAU,EAAsB,EAAE,CAC1D,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAExD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAU,EAAsB,EAAE,CAC1D,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAU,EAAgB,EAAE,CAAC,WAAW,CAAC,CAA0C,CAAC,CAAC"}
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../src/mapping.ts"],"names":[],"mappings":"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"}

package/dist/esm/padron-a10.d.ts

@@ -1,18 +1,21 @@
 import type { CallOptions } from '@ramiidv/arca-common';
+import { type SoapRecord as R } from './mapping.js';
 import { BasePadronClient, type PadronClientConfig } from './base-client.js';
 import type { PersonaA10, WsAuth } from './types.js';
 export type PadronA10ClientConfig = PadronClientConfig;
 /**
- * Client for ws_sr_padron_a10 - Minimal taxpayer data.
+ * Client for ws_sr_padron_a10 - Datos básicos de un contribuyente.
  */
 export declare class PadronA10Client extends BasePadronClient {
     /**
-     * Get minimal taxpayer data for a given CUIT.
+     * Datos básicos de un contribuyente.
      * @param auth - Authentication object with Token, Sign, and CuitRepresentada
-     * @param cuit - CUIT of the taxpayer to query
+     * @param cuit - CUIT/CUIL a consultar (con o sin guiones; se valida el dígito verificador)
      * @param opts - Opciones por llamada (signal)
+     * @throws ArcaPadronServiceError si ARCA informa la CUIT inexistente, inactiva, etc.
      */
-    getPersona(auth: WsAuth, cuit: string, opts?: CallOptions): Promise<PersonaA10>;
-    private mapPersona;
+    getPersona(auth: WsAuth, cuit: string | number, opts?: CallOptions): Promise<PersonaA10>;
 }
+/** Mapea `persona` de A10 (WSDL personaServiceA10). */
+export declare function mapPersonaA10(raw: R): PersonaA10;
 //# sourceMappingURL=padron-a10.d.ts.map

package/dist/esm/padron-a10.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"padron-a10.d.ts","sourceRoot":"","sources":["../../src/padron-a10.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAEvD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBrF,OAAO,CAAC,UAAU;CAoDnB"}
+{"version":3,"file":"padron-a10.d.ts","sourceRoot":"","sources":["../../src/padron-a10.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAOL,KAAK,UAAU,IAAI,CAAC,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAEvD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAK/F;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,GAAG,EAAE,CAAC,GAAG,UAAU,CAShD"}

package/dist/esm/padron-a10.js

@@ -1,69 +1,33 @@
-import { ensureArray } from './soap-client.js';
+import { validateCuit } from '@ramiidv/arca-common';
+import { asignarDependenciaYClaves, mapDomicilio, mapPersonaComun, optString as str, records as list, requirePersona, } from './mapping.js';
 import { BasePadronClient } from './base-client.js';
 /**
- * Client for ws_sr_padron_a10 - Minimal taxpayer data.
+ * Client for ws_sr_padron_a10 - Datos básicos de un contribuyente.
  */
 export class PadronA10Client extends BasePadronClient {
     /**
-     * Get minimal taxpayer data for a given CUIT.
+     * Datos básicos de un contribuyente.
      * @param auth - Authentication object with Token, Sign, and CuitRepresentada
-     * @param cuit - CUIT of the taxpayer to query
+     * @param cuit - CUIT/CUIL a consultar (con o sin guiones; se valida el dígito verificador)
      * @param opts - Opciones por llamada (signal)
+     * @throws ArcaPadronServiceError si ARCA informa la CUIT inexistente, inactiva, etc.
      */
     async getPersona(auth, cuit, opts) {
-        const result = await this.call('getPersona', { ...this.authParams(auth), idPersona: cuit }, opts);
-        // Extract persona data
-        const persona = (result['persona'] ?? result);
-        return this.mapPersona(persona);
-    }
-    // -------------------------------------------------------------------------
-    // Private helpers
-    // -------------------------------------------------------------------------
-    mapPersona(raw) {
-        const persona = {
-            idPersona: String(raw['idPersona'] ?? ''),
-            tipoPersona: (raw['tipoPersona'] ?? 'FISICA'),
-            tipoClave: raw['tipoClave'],
-            estadoClave: raw['estadoClave'],
-            nombre: raw['nombre'],
-            apellido: raw['apellido'],
-            razonSocial: raw['razonSocial'],
-            numeroDocumento: raw['numeroDocumento'] != null
-                ? String(raw['numeroDocumento'])
-                : undefined,
-            tipoDocumento: raw['tipoDocumento'],
-            idActividadPrincipal: raw['idActividadPrincipal'] != null
-                ? String(raw['idActividadPrincipal'])
-                : undefined,
-            descripcionActividadPrincipal: raw['descripcionActividadPrincipal'],
-        };
-        // Dependencia (single object)
-        const dep = raw['dependencia'];
-        if (dep) {
-            persona.dependencia = {
-                idDependencia: Number(dep['idDependencia'] ?? 0),
-                descripcionDependencia: String(dep['descripcionDependencia'] ?? ''),
-            };
-        }
-        // claveInactivaAsociada (array of strings)
-        const clavesInactivas = raw['claveInactivaAsociada'];
-        if (clavesInactivas) {
-            persona.claveInactivaAsociada = ensureArray(clavesInactivas);
-        }
-        const domicilios = raw['domicilio'];
-        if (domicilios) {
-            persona.domicilio = ensureArray(domicilios).map((d) => ({
-                direccion: d['direccion'],
-                localidad: d['localidad'],
-                codPostal: d['codPostal'],
-                idProvincia: d['idProvincia'] != null ? Number(d['idProvincia']) : undefined,
-                descripcionProvincia: d['descripcionProvincia'],
-                tipoDomicilio: d['tipoDomicilio'],
-                datoAdicional: d['datoAdicional'],
-                tipoDatoAdicional: d['tipoDatoAdicional'],
-            }));
-        }
-        return persona;
+        const idPersona = validateCuit(cuit);
+        const result = await this.call('getPersona', { ...this.authParams(auth), idPersona }, opts);
+        return mapPersonaA10(requirePersona(result, 'getPersona'));
     }
 }
+/** Mapea `persona` de A10 (WSDL personaServiceA10). */
+export function mapPersonaA10(raw) {
+    const persona = {
+        ...mapPersonaComun(raw),
+        idActividadPrincipal: str(raw['idActividadPrincipal']),
+        descripcionActividadPrincipal: str(raw['descripcionActividadPrincipal']),
+    };
+    asignarDependenciaYClaves(persona, raw);
+    if (raw['domicilio'] !== undefined)
+        persona.domicilio = list(raw['domicilio']).map(mapDomicilio);
+    return persona;
+}
 //# sourceMappingURL=padron-a10.js.map

package/dist/esm/padron-a10.js.map

@@ -1 +1 @@
-{"version":3,"file":"padron-a10.js","sourceRoot":"","sources":["../../src/padron-a10.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAA2B,MAAM,kBAAkB,CAAC;AAQ7E;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,IAAkB;QAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAC5B,YAAY,EACZ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAC7C,IAAI,CACL,CAAC;QAEF,uBAAuB;QACvB,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAA4B,CAAC;QAEzE,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAEpE,UAAU,CAAC,GAA4B;QAC7C,MAAM,OAAO,GAAe;YAC1B,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACzC,WAAW,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,QAAQ,CAA0B;YACtE,SAAS,EAAE,GAAG,CAAC,WAAW,CAAuB;YACjD,WAAW,EAAE,GAAG,CAAC,aAAa,CAAuB;YACrD,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAuB;YAC3C,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAuB;YAC/C,WAAW,EAAE,GAAG,CAAC,aAAa,CAAuB;YACrD,eAAe,EAAE,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI;gBAC7C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAChC,CAAC,CAAC,SAAS;YACb,aAAa,EAAE,GAAG,CAAC,eAAe,CAAuB;YACzD,oBAAoB,EAAE,GAAG,CAAC,sBAAsB,CAAC,IAAI,IAAI;gBACvD,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;gBACrC,CAAC,CAAC,SAAS;YACb,6BAA6B,EAAE,GAAG,CAAC,+BAA+B,CAAuB;SAC1F,CAAC;QAEF,8BAA8B;QAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAwC,CAAC;QACtE,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,WAAW,GAAG;gBACpB,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBAChD,sBAAsB,EAAE,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,EAAE,CAAC;aACpE,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,MAAM,eAAe,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrD,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,CAAC,qBAAqB,GAAG,WAAW,CAAS,eAAoC,CAAC,CAAC;QAC5F,CAAC;QAID,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,SAAS,GAAG,WAAW,CAAI,UAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpE,SAAS,EAAE,CAAC,CAAC,WAAW,CAAuB;gBAC/C,SAAS,EAAE,CAAC,CAAC,WAAW,CAAuB;gBAC/C,SAAS,EAAE,CAAC,CAAC,WAAW,CAAuB;gBAC/C,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC5E,oBAAoB,EAAE,CAAC,CAAC,sBAAsB,CAAuB;gBACrE,aAAa,EAAE,CAAC,CAAC,eAAe,CAAuB;gBACvD,aAAa,EAAE,CAAC,CAAC,eAAe,CAAuB;gBACvD,iBAAiB,EAAE,CAAC,CAAC,mBAAmB,CAAuB;aAChE,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}
+{"version":3,"file":"padron-a10.js","sourceRoot":"","sources":["../../src/padron-a10.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EACL,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,SAAS,IAAI,GAAG,EAChB,OAAO,IAAI,IAAI,EACf,cAAc,GAEf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAA2B,MAAM,kBAAkB,CAAC;AAK7E;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,IAAqB,EAAE,IAAkB;QACtE,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5F,OAAO,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,GAAM;IAClC,MAAM,OAAO,GAAe;QAC1B,GAAG,eAAe,CAAC,GAAG,CAAC;QACvB,oBAAoB,EAAE,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACtD,6BAA6B,EAAE,GAAG,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;KACzE,CAAC;IACF,yBAAyB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACjG,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/esm/padron-a100.d.ts

@@ -3,13 +3,17 @@ import { BasePadronClient, type PadronClientConfig } from './base-client.js';
 import type { ParameterRecord, WsAuth } from './types.js';
 export type PadronA100ClientConfig = PadronClientConfig;
 /**
- * Client for ws_sr_padron_a100 - Parameter tables.
+ * Client for ws_sr_padron_a100 - Tablas de parámetros.
+ *
+ * `id`, `description`, `name` y `value` son `xs:string` en el WSDL y se
+ * devuelven tal cual los envía ARCA (`"10.50"`, `"1E3"`, `"007"`): la
+ * respuesta se parsea sin conversión a número (ver `BasePadronClient`).
  */
 export declare class PadronA100Client extends BasePadronClient {
     /**
-     * Get a parameter table by collection name.
-     * @param auth - Authentication object with Token, Sign, and CuitRepresentada
-     * @param collectionName - Name of the collection to query (e.g. "SUPA.E_PROVINCIA")
+     * Tabla de parámetros por nombre de colección (ver `CollectionName`).
+     * @param collectionName - Nombre de la colección (ej: "SUPA.E_PROVINCIA")
+     * @returns los registros de la tabla (`[]` si ARCA devuelve la colección vacía)
      */
     getParameterCollectionByName(auth: WsAuth, collectionName: string, opts?: CallOptions): Promise<ParameterRecord[]>;
 }

package/dist/esm/padron-a100.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"padron-a100.d.ts","sourceRoot":"","sources":["../../src/padron-a100.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EACV,eAAe,EACf,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAExD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD;;;;OAIG;IACG,4BAA4B,CAChC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,eAAe,EAAE,CAAC;CA8B9B"}
+{"version":3,"file":"padron-a100.d.ts","sourceRoot":"","sources":["../../src/padron-a100.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAIxD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD;;;;OAIG;IACG,4BAA4B,CAChC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,eAAe,EAAE,CAAC;CA8B9B"}

package/dist/esm/padron-a100.js

@@ -1,31 +1,41 @@
-import { ensureArray } from './soap-client.js';
+import { ArcaValidationError } from '@ramiidv/arca-common';
+import { ArcaPadronError } from './errors.js';
+import { optString, record, records as list, reqString } from './mapping.js';
 import { BasePadronClient } from './base-client.js';
+const METHOD = 'getParameterCollectionByName';
 /**
- * Client for ws_sr_padron_a100 - Parameter tables.
+ * Client for ws_sr_padron_a100 - Tablas de parámetros.
+ *
+ * `id`, `description`, `name` y `value` son `xs:string` en el WSDL y se
+ * devuelven tal cual los envía ARCA (`"10.50"`, `"1E3"`, `"007"`): la
+ * respuesta se parsea sin conversión a número (ver `BasePadronClient`).
  */
 export class PadronA100Client extends BasePadronClient {
     /**
-     * Get a parameter table by collection name.
-     * @param auth - Authentication object with Token, Sign, and CuitRepresentada
-     * @param collectionName - Name of the collection to query (e.g. "SUPA.E_PROVINCIA")
+     * Tabla de parámetros por nombre de colección (ver `CollectionName`).
+     * @param collectionName - Nombre de la colección (ej: "SUPA.E_PROVINCIA")
+     * @returns los registros de la tabla (`[]` si ARCA devuelve la colección vacía)
      */
     async getParameterCollectionByName(auth, collectionName, opts) {
-        const result = await this.call('getParameterCollectionByName', { ...this.authParams(auth), collectionName }, opts);
-        // Extract parameter collection
-        const collection = result['parameterCollection'];
+        if (typeof collectionName !== 'string' || collectionName.trim() === '') {
+            throw new ArcaValidationError('collectionName es obligatorio', [{ field: 'collectionName', message: 'Indicá el nombre de la colección', value: collectionName }], 'collectionName');
+        }
+        const result = await this.call(METHOD, { ...this.authParams(auth), collectionName: collectionName.trim() }, opts);
+        const collection = record(result['parameterCollection']);
         if (!collection) {
-            return [];
+            throw new ArcaPadronError(`Respuesta inválida de ARCA (${METHOD}): falta parameterCollection`);
         }
-        const parameterList = ensureArray((collection['parameterList'] ?? []));
-        return parameterList.map((p) => {
-            const attrList = ensureArray((p['attributeList'] ?? []));
-            const atributos = attrList.map((a) => ({
-                name: String(a['name'] ?? ''),
-                value: String(a['value'] ?? ''),
+        return list(collection['parameterList']).map((p) => {
+            const atributos = list(p['attributeList']).map((a) => ({
+                name: reqString(a['name'], 'attributeList.name'),
+                value: optString(a['value']),
             }));
+            const descripcion = optString(p['description']);
+            if (descripcion === undefined)
+                throw new ArcaPadronError(`Respuesta inválida de ARCA (${METHOD}): falta description`);
             return {
-                id: String(p['id'] ?? ''),
-                descripcion: String(p['description'] ?? ''),
+                id: reqString(p['id'], 'parameterList.id'),
+                descripcion,
                 atributos: atributos.length > 0 ? atributos : undefined,
             };
         });