@ramiidv/arca-padron 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ramiidv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,310 @@
+# @ramiidv/arca-padron-sdk
+
+SDK de TypeScript para los web services de Padron de ARCA (ex AFIP). Soporta los alcances A4 (datos completos), A10 (datos basicos) y A100 (tablas de parametros).
+
+## Caracteristicas
+
+- Zero dependencias SOAP: construye los envelopes SOAP manualmente
+- Zero dependencias HTTP: usa `fetch` nativo (Node 18+)
+- Firma CMS/PKCS#7 con node-forge
+- ESM only
+- TypeScript estricto con tipos completos
+- Cache automatico de tokens WSAA
+- Reintentos con backoff exponencial
+- Sistema de eventos para monitoreo
+
+## Instalacion
+
+```bash
+npm install @ramiidv/arca-padron-sdk
+```
+
+## Inicio rapido
+
+```typescript
+import { readFileSync } from 'fs';
+import { ArcaPadron } from '@ramiidv/arca-padron-sdk';
+
+const padron = new ArcaPadron({
+  cert: readFileSync('./cert.pem', 'utf-8'),
+  key: readFileSync('./key.pem', 'utf-8'),
+  cuit: '20123456789',
+  production: false, // false = homologacion
+});
+
+// Consulta completa (A4)
+const contribuyente = await padron.getPersona('20123456789');
+console.log(contribuyente.tipoPersona, contribuyente.nombre);
+
+// Consulta basica (A10)
+const contribuyenteBasico = await padron.getPersonaBasic('20123456789');
+console.log(contribuyenteBasico.domicilio?.[0]?.direccion);
+
+// Tablas de parametros (A100)
+import { CollectionName } from '@ramiidv/arca-padron-sdk';
+const provincias = await padron.getParametros(CollectionName.PROVINCIA);
+console.log(provincias.length, 'provincias');
+```
+
+## Configuracion
+
+```typescript
+interface ArcaPadronConfig {
+  /** Certificado X.509 en formato PEM */
+  cert: string;
+  /** Clave privada RSA en formato PEM */
+  key: string;
+  /** CUIT de la entidad representada */
+  cuit: string;
+  /** Usar endpoints de produccion (default: false) */
+  production?: boolean;
+  /** Cantidad de reintentos en errores 5xx/red (default: 1) */
+  retries?: number;
+  /** Delay base en ms para backoff exponencial (default: 1000) */
+  retryDelayMs?: number;
+  /** Callback de eventos para monitoreo */
+  onEvent?: (event: ArcaPadronEvent) => void;
+}
+```
+
+## API
+
+### Metodos de alto nivel
+
+#### `getPersona(cuit: string): Promise<PersonaA4>`
+
+Obtiene los datos completos de un contribuyente via ws_sr_padron_a4. Autentica automaticamente con WSAA.
+
+```typescript
+const contribuyente = await padron.getPersona('20123456789');
+```
+
+#### `getPersonaBasic(cuit: string): Promise<PersonaA10>`
+
+Obtiene los datos basicos de un contribuyente via ws_sr_padron_a10.
+
+```typescript
+const contribuyenteBasico = await padron.getPersonaBasic('20123456789');
+```
+
+#### `getParametros(collection: string): Promise<ParameterRecord[]>`
+
+Obtiene una tabla de parametros via ws_sr_padron_a100.
+
+```typescript
+import { CollectionName } from '@ramiidv/arca-padron-sdk';
+
+const provincias = await padron.getParametros(CollectionName.PROVINCIA);
+const tiposDocumento = await padron.getParametros(CollectionName.TIPO_DOCUMENTO);
+const tiposRelacion = await padron.getParametros(CollectionName.TIPO_RELACION);
+```
+
+Colecciones disponibles (enum `CollectionName`, valores SUPA.\* prefijados): `PROVINCIA`, `TIPO_DOCUMENTO`, `TIPO_DOMICILIO`, `TIPO_CLAVE`, `TIPO_EMPRESA_JURIDICA`, `TIPO_EMPRESA_JURIDICA_SUBGRUPO`, `TIPO_RELACION`, `TIPO_SUBTIPO_RELACION`, `TIPO_COMPONENTE_SOCIEDAD`, `TIPO_RELACION_COMPONENTE_SOC`, `TIPO_EMAIL`, `TIPO_TELEFONO`, `TIPO_RESIDENCIA`, `TIPO_DATO_ADICIONAL_DOMICILIO`, `ORGANISMO_INFORMANTE`, `ORGANISMO_CONTROL`, `PROVINCIA_SOCIEDAD_ORG`, `SEXO`, `CALLE`, `LOCALIDAD`.
+
+#### `status(): Promise<{ a4: ServerStatus, a10: ServerStatus, a100: ServerStatus }>`
+
+Verifica el estado de los tres servicios (no requiere autenticacion).
+
+```typescript
+const estadoServicios = await padron.status();
+console.log(estadoServicios.a4.appserver); // "OK"
+```
+
+### Acceso a clientes de bajo nivel
+
+Para casos avanzados, se pueden usar los clientes individuales directamente:
+
+```typescript
+const padron = new ArcaPadron({ /* ... */ });
+
+// Obtener ticket de acceso manualmente
+const ticket = await padron.wsaa.getAccessTicket('ws_sr_padron_a4');
+
+const credenciales = {
+  Token: ticket.token,
+  Sign: ticket.sign,
+  CuitRepresentada: '20123456789',
+};
+
+// Llamar directamente al servicio
+const contribuyente = await padron.a4.getPersona(credenciales, '20123456789');
+```
+
+## Tipos de respuesta
+
+### PersonaA4 (datos completos)
+
+```typescript
+interface PersonaA4 {
+  idPersona: string;
+  tipoPersona: 'FISICA' | 'JURIDICA';
+  tipoClave?: string;
+  estadoClave?: string;
+  apellido?: string;
+  nombre?: string;
+  razonSocial?: string;
+  numeroDocumento?: string;
+  tipoDocumento?: string;
+  fechaNacimiento?: string;
+  sexo?: string;
+  numeroInscripcion?: string;
+  formaJuridica?: string;
+  mesCierre?: number;
+  fechaInscripcion?: string;
+  fechaContratoSocial?: string;
+  fechaFallecimiento?: string;
+  fechaJubilado?: string;
+  fechaVencimientoMigracion?: string;
+  localidadInscripcion?: string;
+  provinciaInscripcion?: string;
+  organismoInscripcion?: string;
+  organismoOriginante?: string;
+  tipoOrganismoOriginante?: string;
+  tipoResidencia?: string;
+  porcentajeCapitalNacional?: number;
+  cantidadSociosEmpresaMono?: number;
+  leyJubilacion?: number;
+  dependencia?: DependenciaA4;
+  claveInactivaAsociada?: string[];
+  domicilio?: DomicilioA4[];
+  impuesto?: ImpuestoA4[];
+  actividad?: ActividadA4[];
+  regimen?: RegimenA4[];
+  relacion?: RelacionA4[];
+  categoria?: CategoriaA4[];
+  email?: EmailA4[];
+  telefono?: TelefonoA4[];
+}
+```
+
+### PersonaA10 (datos basicos)
+
+```typescript
+interface PersonaA10 {
+  idPersona: string;
+  tipoPersona: 'FISICA' | 'JURIDICA';
+  tipoClave?: string;
+  estadoClave?: string;
+  nombre?: string;
+  apellido?: string;
+  razonSocial?: string;
+  numeroDocumento?: string;
+  tipoDocumento?: string;
+  idActividadPrincipal?: string;
+  descripcionActividadPrincipal?: string;
+  dependencia?: DependenciaA10;
+  claveInactivaAsociada?: string[];
+  domicilio?: DomicilioA10[];
+}
+```
+
+### ParameterRecord (tablas A100)
+
+```typescript
+interface ParameterRecord {
+  id: string;
+  descripcion: string;
+  atributos?: ParameterAttribute[];
+}
+
+interface ParameterAttribute {
+  name: string;
+  value: string;
+}
+```
+
+## Manejo de errores
+
+El SDK usa una jerarquia de errores de 4 clases:
+
+```
+Error
+  └── ArcaPadronError (base)
+        ├── ArcaAuthError (errores de WSAA)
+        ├── ArcaPadronServiceError (errores de negocio)
+        └── ArcaSoapError (errores HTTP/transporte)
+```
+
+```typescript
+import {
+  ArcaAuthError,
+  ArcaPadronServiceError,
+  ArcaSoapError,
+} from '@ramiidv/arca-padron-sdk';
+
+try {
+  await padron.getPersona('20123456789');
+} catch (error) {
+  if (error instanceof ArcaAuthError) {
+    // Certificado vencido, servicio no autorizado, WSAA caido
+    console.error('Error de autenticacion:', error.message);
+  } else if (error instanceof ArcaPadronServiceError) {
+    // Errores de negocio (CUIT no encontrada, etc.)
+    for (const detalle of error.errors) {
+      console.error(`[${detalle.code}] ${detalle.msg}`);
+    }
+  } else if (error instanceof ArcaSoapError) {
+    // Errores HTTP/red
+    console.error('Error HTTP:', error.statusCode, error.message);
+  }
+}
+```
+
+## Eventos
+
+El SDK emite eventos para monitoreo y debugging:
+
+```typescript
+const padron = new ArcaPadron({
+  // ...
+  onEvent: (evento) => {
+    switch (evento.type) {
+      case 'auth:login':
+        console.log(`Login para ${evento.serviceId}`);
+        break;
+      case 'auth:cache-hit':
+        console.log(`Token cacheado para ${evento.serviceId}`);
+        break;
+      case 'request:start':
+        console.log(`Inicio ${evento.method}`);
+        break;
+      case 'request:end':
+        console.log(`Fin ${evento.method} (${evento.durationMs}ms)`);
+        break;
+      case 'request:retry':
+        console.log(`Reintento #${evento.attempt}`);
+        break;
+      case 'request:error':
+        console.log(`Error: ${evento.error.message}`);
+        break;
+    }
+  },
+});
+```
+
+## Enums utiles
+
+```typescript
+import {
+  Provincia,
+  TipoDomicilio,
+  TipoPersona,
+  ImpuestoId,
+  CollectionName,
+} from '@ramiidv/arca-padron-sdk';
+
+// Verificar si el contribuyente esta inscripto en IVA
+const tieneIva = contribuyente.impuesto?.some(
+  (imp) => imp.idImpuesto === ImpuestoId.IVA_RESPONSABLE_INSCRIPTO && imp.estado === 'AC'
+);
+```
+
+## Requisitos
+
+- Node.js >= 18 (soporte nativo de `fetch`)
+- Certificado digital emitido por ARCA/AFIP
+- Autorizacion para los servicios web correspondientes
+
+## Licencia
+
+MIT

package/dist/arca-padron.d.ts

@@ -0,0 +1,70 @@
+import { WsaaClient } from '@ramiidv/arca-common';
+import { PadronA4Client } from './padron-a4.js';
+import { PadronA10Client } from './padron-a10.js';
+import { PadronA100Client } from './padron-a100.js';
+import type { ArcaPadronConfig, ParameterRecord, PersonaA4, PersonaA10, ServerStatus } from './types.js';
+/**
+ * Main orchestrator class for ARCA Padrón web services.
+ *
+ * Provides high-level methods that handle WSAA authentication automatically
+ * and expose results from the A4 (full), A10 (basic), and A100 (parameters)
+ * web services.
+ *
+ * @example
+ * ```ts
+ * import { ArcaPadron } from '@ramiidv/arca-padron';
+ * import { readFileSync } from 'fs';
+ *
+ * const client = new ArcaPadron({
+ *   cert: readFileSync('cert.pem', 'utf-8'),
+ *   key: readFileSync('key.pem', 'utf-8'),
+ *   cuit: '20123456789',
+ *   production: false,
+ * });
+ *
+ * const persona = await client.getPersona('20123456789');
+ * console.log(persona.tipoPersona, persona.nombre);
+ * ```
+ */
+export declare class ArcaPadron {
+    /** Low-level WSAA client for direct access */
+    readonly wsaa: WsaaClient;
+    /** Low-level Padrón A4 client for direct access */
+    readonly a4: PadronA4Client;
+    /** Low-level Padrón A10 client for direct access */
+    readonly a10: PadronA10Client;
+    /** Low-level Padrón A100 client for direct access */
+    readonly a100: PadronA100Client;
+    private readonly cuit;
+    private readonly onEvent?;
+    constructor(config: ArcaPadronConfig);
+    /**
+     * Get full taxpayer data (Padrón A4) for a given CUIT.
+     * Authenticates automatically via WSAA.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    getPersona(cuit: string): Promise<PersonaA4>;
+    /**
+     * Get basic taxpayer data (Padrón A10) for a given CUIT.
+     * Authenticates automatically via WSAA.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    getPersonaBasic(cuit: string): Promise<PersonaA10>;
+    /**
+     * Get a parameter table (Padrón A100) by collection name.
+     * Authenticates automatically via WSAA.
+     * @param collection - Name of the collection (e.g. CollectionName.PROVINCIA, CollectionName.TIPO_DOCUMENTO)
+     */
+    getParametros(collection: string): Promise<ParameterRecord[]>;
+    /**
+     * Health check for all three Padrón services.
+     * Does not require authentication.
+     */
+    status(): Promise<{
+        a4: ServerStatus;
+        a10: ServerStatus;
+        a100: ServerStatus;
+    }>;
+    private getAuth;
+}
+//# sourceMappingURL=arca-padron.d.ts.map

package/dist/arca-padron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arca-padron.d.ts","sourceRoot":"","sources":["../src/arca-padron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,UAAU,EACV,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,UAAU;IACrB,8CAA8C;IAC9C,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,mDAAmD;IACnD,SAAgB,EAAE,EAAE,cAAc,CAAC;IACnC,oDAAoD;IACpD,SAAgB,GAAG,EAAE,eAAe,CAAC;IACrC,qDAAqD;IACrD,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IAEvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA6B;gBAE1C,MAAM,EAAE,gBAAgB;IA4CpC;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAKlD;;;;OAIG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKxD;;;;OAIG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAKnE;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,YAAY,CAAC;QAAC,GAAG,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,YAAY,CAAA;KAAE,CAAC;YAatE,OAAO;CAQtB"}

package/dist/arca-padron.js

@@ -0,0 +1,129 @@
+import { WsaaClient } from '@ramiidv/arca-common';
+import { ENDPOINTS } from './constants.js';
+import { PadronA4Client } from './padron-a4.js';
+import { PadronA10Client } from './padron-a10.js';
+import { PadronA100Client } from './padron-a100.js';
+/**
+ * Main orchestrator class for ARCA Padrón web services.
+ *
+ * Provides high-level methods that handle WSAA authentication automatically
+ * and expose results from the A4 (full), A10 (basic), and A100 (parameters)
+ * web services.
+ *
+ * @example
+ * ```ts
+ * import { ArcaPadron } from '@ramiidv/arca-padron';
+ * import { readFileSync } from 'fs';
+ *
+ * const client = new ArcaPadron({
+ *   cert: readFileSync('cert.pem', 'utf-8'),
+ *   key: readFileSync('key.pem', 'utf-8'),
+ *   cuit: '20123456789',
+ *   production: false,
+ * });
+ *
+ * const persona = await client.getPersona('20123456789');
+ * console.log(persona.tipoPersona, persona.nombre);
+ * ```
+ */
+export class ArcaPadron {
+    /** Low-level WSAA client for direct access */
+    wsaa;
+    /** Low-level Padrón A4 client for direct access */
+    a4;
+    /** Low-level Padrón A10 client for direct access */
+    a10;
+    /** Low-level Padrón A100 client for direct access */
+    a100;
+    cuit;
+    onEvent;
+    constructor(config) {
+        const isProduction = config.production ?? false;
+        const env = isProduction ? 'production' : 'testing';
+        this.cuit = config.cuit;
+        this.onEvent = config.onEvent;
+        const soapOptions = {
+            timeout: config.timeout,
+            retries: config.retries,
+            retryDelayMs: config.retryDelayMs,
+        };
+        this.wsaa = new WsaaClient({
+            cert: config.cert,
+            key: config.key,
+            production: isProduction,
+            timeout: config.timeout,
+            retries: config.retries,
+            retryDelayMs: config.retryDelayMs,
+            onEvent: config.onEvent,
+        });
+        this.a4 = new PadronA4Client({
+            endpoint: ENDPOINTS.a4[env],
+            namespace: ENDPOINTS.a4.namespace,
+            soapOptions,
+            onEvent: config.onEvent,
+        });
+        this.a10 = new PadronA10Client({
+            endpoint: ENDPOINTS.a10[env],
+            namespace: ENDPOINTS.a10.namespace,
+            soapOptions,
+            onEvent: config.onEvent,
+        });
+        this.a100 = new PadronA100Client({
+            endpoint: ENDPOINTS.a100[env],
+            namespace: ENDPOINTS.a100.namespace,
+            soapOptions,
+            onEvent: config.onEvent,
+        });
+    }
+    /**
+     * Get full taxpayer data (Padrón A4) for a given CUIT.
+     * Authenticates automatically via WSAA.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    async getPersona(cuit) {
+        const auth = await this.getAuth(ENDPOINTS.a4.serviceId);
+        return this.a4.getPersona(auth, cuit);
+    }
+    /**
+     * Get basic taxpayer data (Padrón A10) for a given CUIT.
+     * Authenticates automatically via WSAA.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    async getPersonaBasic(cuit) {
+        const auth = await this.getAuth(ENDPOINTS.a10.serviceId);
+        return this.a10.getPersona(auth, cuit);
+    }
+    /**
+     * Get a parameter table (Padrón A100) by collection name.
+     * Authenticates automatically via WSAA.
+     * @param collection - Name of the collection (e.g. CollectionName.PROVINCIA, CollectionName.TIPO_DOCUMENTO)
+     */
+    async getParametros(collection) {
+        const auth = await this.getAuth(ENDPOINTS.a100.serviceId);
+        return this.a100.getParameterCollectionByName(auth, collection);
+    }
+    /**
+     * Health check for all three Padrón services.
+     * Does not require authentication.
+     */
+    async status() {
+        const [a4, a10, a100] = await Promise.all([
+            this.a4.dummy(),
+            this.a10.dummy(),
+            this.a100.dummy(),
+        ]);
+        return { a4, a10, a100 };
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    async getAuth(serviceId) {
+        const ticket = await this.wsaa.getAccessTicket(serviceId);
+        return {
+            Token: ticket.token,
+            Sign: ticket.sign,
+            CuitRepresentada: this.cuit,
+        };
+    }
+}
+//# sourceMappingURL=arca-padron.js.map

package/dist/arca-padron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arca-padron.js","sourceRoot":"","sources":["../src/arca-padron.ts"],"names":[],"mappings":"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"}

package/dist/base-client.d.ts

@@ -0,0 +1,26 @@
+import type { ArcaEvent, SoapCallOptions, ServerStatus } from '@ramiidv/arca-common';
+/** Shared configuration for all Padrón service clients. */
+export interface PadronClientConfig {
+    /** SOAP endpoint URL */
+    endpoint: string;
+    /** SOAP namespace */
+    namespace: string;
+    /** SOAP call options (retries, timeout) */
+    soapOptions?: Pick<SoapCallOptions, 'timeout' | 'retries' | 'retryDelayMs'>;
+    /** Optional event callback */
+    onEvent?: (event: ArcaEvent) => void;
+}
+/**
+ * Abstract base class for Padrón web service clients.
+ * Provides shared constructor logic and health-check method.
+ */
+export declare abstract class BasePadronClient {
+    protected readonly endpoint: string;
+    protected readonly namespace: string;
+    protected readonly soapOptions?: Pick<SoapCallOptions, 'timeout' | 'retries' | 'retryDelayMs'>;
+    protected readonly onEvent?: (event: ArcaEvent) => void;
+    constructor(config: PadronClientConfig);
+    /** Health check for this service. */
+    dummy(): Promise<ServerStatus>;
+}
+//# sourceMappingURL=base-client.d.ts.map

package/dist/base-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../src/base-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErF,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC,CAAC;IAC5E,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC,CAAC;IAC/F,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;gBAE5C,MAAM,EAAE,kBAAkB;IAOtC,qCAAqC;IAC/B,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;CAerC"}

package/dist/base-client.js

@@ -0,0 +1,27 @@
+import { afipSoapCall } from '@ramiidv/arca-common';
+/**
+ * Abstract base class for Padrón web service clients.
+ * Provides shared constructor logic and health-check method.
+ */
+export class BasePadronClient {
+    endpoint;
+    namespace;
+    soapOptions;
+    onEvent;
+    constructor(config) {
+        this.endpoint = config.endpoint;
+        this.namespace = config.namespace;
+        this.soapOptions = config.soapOptions;
+        this.onEvent = config.onEvent;
+    }
+    /** Health check for this service. */
+    async dummy() {
+        const result = await afipSoapCall(this.endpoint, this.namespace, 'dummy', {}, { ...this.soapOptions, onEvent: this.onEvent });
+        return {
+            appserver: (result['appserver'] ?? ''),
+            dbserver: (result['dbserver'] ?? ''),
+            authserver: (result['authserver'] ?? ''),
+        };
+    }
+}
+//# sourceMappingURL=base-client.js.map

package/dist/base-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.js","sourceRoot":"","sources":["../src/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAepD;;;GAGG;AACH,MAAM,OAAgB,gBAAgB;IACjB,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,WAAW,CAAiE;IAC5E,OAAO,CAA8B;IAExD,YAAY,MAA0B;QACpC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,EACd,OAAO,EACP,EAAE,EACF,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAC/C,CAAC;QAEF,OAAO;YACL,SAAS,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAW;YAChD,QAAQ,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAW;YAC9C,UAAU,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAW;SACnD,CAAC;IACJ,CAAC;CACF"}

package/dist/constants.d.ts

@@ -0,0 +1,79 @@
+export { Provincia, DocTipo as TipoDocumento } from '@ramiidv/arca-common';
+export declare const ENDPOINTS: {
+    readonly wsaa: {
+        readonly testing: "https://wsaahomo.afip.gov.ar/ws/services/LoginCms";
+        readonly production: "https://wsaa.afip.gov.ar/ws/services/LoginCms";
+    };
+    readonly a4: {
+        readonly testing: "https://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA4";
+        readonly production: "https://aws.afip.gov.ar/sr-padron/webservices/personaServiceA4";
+        readonly namespace: "http://a4.soap.ws.server.puc.sr/";
+        readonly serviceId: "ws_sr_padron_a4";
+    };
+    readonly a10: {
+        readonly testing: "https://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA10";
+        readonly production: "https://aws.afip.gov.ar/sr-padron/webservices/personaServiceA10";
+        readonly namespace: "http://a10.soap.ws.server.puc.sr/";
+        readonly serviceId: "ws_sr_padron_a10";
+    };
+    readonly a100: {
+        readonly testing: "https://awshomo.afip.gov.ar/sr-parametros/webservices/parameterServiceA100";
+        readonly production: "https://aws.afip.gov.ar/sr-parametros/webservices/parameterServiceA100";
+        readonly namespace: "http://a100.soap.ws.server.pucParam.sr/";
+        readonly serviceId: "ws_sr_padron_a100";
+    };
+};
+/** Tipos de domicilio */
+export declare enum TipoDomicilio {
+    FISCAL = "FISCAL",
+    LEGAL = "LEGAL",
+    REAL = "REAL"
+}
+/** Tipos de persona */
+export declare enum TipoPersona {
+    FISICA = "FISICA",
+    JURIDICA = "JURIDICA"
+}
+/** IDs de impuestos comunes */
+export declare enum ImpuestoId {
+    GANANCIAS_PJ = 10,
+    GANANCIAS_PH = 11,
+    MONOTRIBUTO_SOCIAL = 20,
+    MONOTRIBUTO = 21,
+    IVA_RESPONSABLE_INSCRIPTO = 30,
+    BIENES_PERSONALES = 31,
+    IVA_EXENTO = 32,
+    IVA_NO_INSCRIPTO = 33,
+    IVA_NO_ALCANZADO = 34,
+    EMPLEADOR = 301
+}
+/** Estado de la clave fiscal del contribuyente */
+export declare enum EstadoClave {
+    ACTIVO = "ACTIVO",
+    INACTIVO = "INACTIVO",
+    LIMITADO = "LIMITADO"
+}
+/** Nombres de colecciones disponibles en ws_sr_padron_a100 */
+export declare enum CollectionName {
+    PROVINCIA = "SUPA.E_PROVINCIA",
+    TIPO_DOCUMENTO = "SUPA.TIPO_DOCUMENTO",
+    TIPO_DOMICILIO = "SUPA.TIPO_DOMICILIO",
+    TIPO_CLAVE = "SUPA.TIPO_CLAVE_IDENTIFICACION",
+    TIPO_EMPRESA_JURIDICA = "SUPA.TIPO_EMPRESA_JURIDICA",
+    TIPO_EMPRESA_JURIDICA_SUBGRUPO = "SUPA.TIPO_EMPRESA_JURI_SUBGRUPO",
+    TIPO_RELACION = "SUPA.TIPO_RELACION",
+    TIPO_SUBTIPO_RELACION = "SUPA.TIPO_SUBTIPO_RELACION",
+    TIPO_COMPONENTE_SOCIEDAD = "SUPA.TIPO_COMPONENTE_SOCIEDAD",
+    TIPO_RELACION_COMPONENTE_SOC = "SUPA.TIPO_RELACION_COMPONENTE_SOC",
+    TIPO_EMAIL = "SUPA.TIPO_EMAIL",
+    TIPO_TELEFONO = "SUPA.TIPO_TELEFONO",
+    TIPO_RESIDENCIA = "SUPA.TIPO_RESIDENCIA",
+    TIPO_DATO_ADICIONAL_DOMICILIO = "SUPA.TIPO_DATO_ADICIONAL_DOMICILIO",
+    ORGANISMO_INFORMANTE = "SUPA.E_ORGANISMO_INFORMANTE",
+    ORGANISMO_CONTROL = "SUPA.E_ORGANISMO_CONTROL",
+    PROVINCIA_SOCIEDAD_ORG = "SUPA.A_PROVINCIA_SOCIEDAD_ORG",
+    SEXO = "E_SEXO",
+    CALLE = "PUC_PARAM.T_CALLE",
+    LOCALIDAD = "PUC_PARAM.T_LOCALIDAD"
+}
+//# sourceMappingURL=constants.d.ts.map