dgii-ts 0.1.0

package/dist/chunk-VJ4ZQQIQ.cjs

@@ -0,0 +1,281 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkWY6V4Y7Scjs = require('./chunk-WY6V4Y7S.cjs');
+
+
+
+var _chunkQH4BK5X3cjs = require('./chunk-QH4BK5X3.cjs');
+
+
+
+var _chunk7RJWFPCZcjs = require('./chunk-7RJWFPCZ.cjs');
+
+// src/scraping/endpoints.ts
+var DGII_RNC_URL = "https://dgii.gov.do/app/WebApps/ConsultasWeb2/ConsultasWeb/consultas/rnc.aspx";
+var DGII_NCF_URL = "https://dgii.gov.do/app/WebApps/ConsultasWeb2/ConsultasWeb/consultas/ncf.aspx";
+var FORM_FIELDS = /* @__PURE__ */ Object.freeze({
+  viewState: "__VIEWSTATE",
+  viewStateGenerator: "__VIEWSTATEGENERATOR",
+  eventValidation: "__EVENTVALIDATION",
+  rncInput: "ctl00$cphMain$txtRNCCedula",
+  rncSubmit: "ctl00$cphMain$btnBuscarPorRNC",
+  ncfRncInput: "ctl00$cphMain$txtRNC",
+  ncfInput: "ctl00$cphMain$txtNCF",
+  ncfSubmit: "ctl00$cphMain$btnConsultar"
+});
+
+// src/scraping/html-parser.ts
+function extractViewStateTokens(html) {
+  const viewState = extractInputValue(html, "__VIEWSTATE");
+  const viewStateGenerator = extractInputValue(html, "__VIEWSTATEGENERATOR");
+  const eventValidation = extractInputValue(html, "__EVENTVALIDATION");
+  if (!viewState || !eventValidation) {
+    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      "No se encontraron tokens ViewState en la p\xE1gina de la DGII"
+    );
+  }
+  return { viewState, viewStateGenerator, eventValidation };
+}
+function parseContribuyenteHtml(html) {
+  const infoStart = html.indexOf("cphMain_lblInformacion");
+  if (infoStart !== -1) {
+    const infoEnd = html.indexOf("</span>", infoStart);
+    if (infoEnd !== -1) {
+      const infoBlock = html.slice(infoStart, infoEnd);
+      if (infoBlock.includes("no se encuentra")) {
+        throw new (0, _chunk7RJWFPCZcjs.DgiiNotFoundError)(
+          "RNC o c\xE9dula no encontrado en el registro de la DGII"
+        );
+      }
+    }
+  }
+  const tableId = "cphMain_dvDatosContribuyentes";
+  const tableStart = html.indexOf(tableId);
+  if (tableStart === -1) {
+    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      "Formato de respuesta HTML inesperado: tabla de resultados no encontrada"
+    );
+  }
+  const tableEnd = html.indexOf("</table>", tableStart);
+  if (tableEnd === -1) {
+    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      "Formato de respuesta HTML inesperado: tabla incompleta"
+    );
+  }
+  const tableHtml = html.slice(tableStart, tableEnd);
+  const fields = extractTableFields(tableHtml);
+  const rnc = _nullishCoalesce(_nullishCoalesce(fields.get("Cedula/RNC"), () => ( fields.get("RNC"))), () => ( ""));
+  const nombre = _nullishCoalesce(_nullishCoalesce(fields.get("Nombre/Razon Social"), () => ( fields.get("Nombre / Razon Social"))), () => ( ""));
+  const nombreComercial = _nullishCoalesce(fields.get("Nombre Comercial"), () => ( ""));
+  const categoria = _nullishCoalesce(fields.get("Categoria"), () => ( ""));
+  const rawEstado = _nullishCoalesce(fields.get("Estado"), () => ( ""));
+  const actividadEconomica = _nullishCoalesce(fields.get("Actividad Economica"), () => ( void 0));
+  const regimenDePagos = _nullishCoalesce(fields.get("Regimen de pagos"), () => ( void 0));
+  const administracionLocal = _nullishCoalesce(fields.get("Administracion Local"), () => ( void 0));
+  return {
+    rnc: _chunkQH4BK5X3cjs.stripNonDigits.call(void 0, rnc),
+    nombre: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, nombre),
+    nombreComercial: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, nombreComercial),
+    estado: rawEstado.toUpperCase().includes("ACTIVO") ? "ACTIVO" : "INACTIVO",
+    categoria: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, categoria),
+    actividadEconomica: actividadEconomica ? _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, actividadEconomica) : void 0,
+    regimenDePagos: regimenDePagos ? _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, regimenDePagos) : void 0,
+    administracionLocal: administracionLocal ? _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, administracionLocal) : void 0
+  };
+}
+function parseNcfHtml(html) {
+  const infoStart = html.indexOf("cphMain_lblInformacion");
+  if (infoStart !== -1) {
+    const infoEnd = html.indexOf("</span>", infoStart);
+    if (infoEnd !== -1) {
+      const infoBlock = html.slice(infoStart, infoEnd);
+      if (infoBlock.includes("no es v") || infoBlock.includes("no se encuentra") || infoBlock.includes("no existe")) {
+        return { valid: false, rnc: "", ncf: "", nombreComercial: void 0 };
+      }
+    }
+  }
+  const tableId = "cphMain_dvDatosComprobante";
+  const altTableId = "cphMain_dvDatosContribuyentes";
+  let tableStart = html.indexOf(tableId);
+  if (tableStart === -1) {
+    tableStart = html.indexOf(altTableId);
+  }
+  if (tableStart === -1) {
+    return { valid: false, rnc: "", ncf: "", nombreComercial: void 0 };
+  }
+  const tableEnd = html.indexOf("</table>", tableStart);
+  if (tableEnd === -1) {
+    return { valid: false, rnc: "", ncf: "", nombreComercial: void 0 };
+  }
+  const tableHtml = html.slice(tableStart, tableEnd);
+  const fields = extractTableFields(tableHtml);
+  const rnc = _nullishCoalesce(_nullishCoalesce(fields.get("RNC"), () => ( fields.get("Cedula/RNC"))), () => ( ""));
+  const ncf = _nullishCoalesce(_nullishCoalesce(fields.get("NCF"), () => ( fields.get("No. Comprobante Fiscal"))), () => ( ""));
+  const nombreComercial = _nullishCoalesce(_nullishCoalesce(fields.get("Nombre Comercial"), () => ( fields.get("Nombre / Razon Social"))), () => ( void 0));
+  return {
+    valid: true,
+    rnc: _chunkQH4BK5X3cjs.stripNonDigits.call(void 0, rnc),
+    ncf: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, ncf),
+    nombreComercial: nombreComercial ? _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, nombreComercial) : void 0
+  };
+}
+function extractInputValue(html, name) {
+  let idx = html.indexOf(`id="${name}"`);
+  if (idx === -1) {
+    idx = html.indexOf(`name="${name}"`);
+  }
+  if (idx === -1) return "";
+  const tagStart = html.lastIndexOf("<", idx);
+  if (tagStart === -1) return "";
+  const tagEnd = html.indexOf(">", idx);
+  if (tagEnd === -1) return "";
+  const tag = html.slice(tagStart, tagEnd + 1);
+  const valueMatch = tag.match(/value="([^"]*)"/);
+  return _nullishCoalesce(_optionalChain([valueMatch, 'optionalAccess', _2 => _2[1]]), () => ( ""));
+}
+var BOLD_STYLE_PATTERN = /<td[^>]*style="font-weight:bold;"[^>]*>(.*?)<\/td>\s*<td[^>]*>(.*?)<\/td>/gi;
+var BOLD_TAG_PATTERN = /<td><b>(.*?)<\/b><\/td>\s*<td>(.*?)<\/td>/gi;
+function extractTableFields(tableHtml) {
+  const fields = /* @__PURE__ */ new Map();
+  for (const match of tableHtml.matchAll(BOLD_STYLE_PATTERN)) {
+    const label = normalizeLabel(_nullishCoalesce(match[1], () => ( "")));
+    const value = stripHtmlTags(_nullishCoalesce(match[2], () => ( "")));
+    if (label) fields.set(label, value);
+  }
+  if (fields.size === 0) {
+    for (const match of tableHtml.matchAll(BOLD_TAG_PATTERN)) {
+      const label = normalizeLabel(_nullishCoalesce(match[1], () => ( "")));
+      const value = stripHtmlTags(_nullishCoalesce(match[2], () => ( "")));
+      if (label) fields.set(label, value);
+    }
+  }
+  return fields;
+}
+var ACCENT_PATTERN = /[\u0300-\u036f]/g;
+function normalizeLabel(raw) {
+  return decodeHtmlEntities(stripHtmlTags(raw)).replace(/\s+/g, " ").trim().normalize("NFD").replace(ACCENT_PATTERN, "");
+}
+function stripHtmlTags(str) {
+  return str.replace(/<[^>]*>/g, "").trim();
+}
+function decodeHtmlEntities(str) {
+  return str.replace(
+    /&#(\d+);/g,
+    (_, code) => String.fromCharCode(parseInt(code, 10))
+  ).replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&nbsp;/g, " ");
+}
+
+// src/scraping/client.ts
+var DEFAULT_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+var ScrapingClient = class {
+  constructor(options) {
+    this._rncUrl = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _3 => _3.baseRncUrl]), () => ( DGII_RNC_URL));
+    this._ncfUrl = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _4 => _4.baseNcfUrl]), () => ( DGII_NCF_URL));
+    this._timeout = Math.min(
+      Math.max(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _5 => _5.timeout]), () => ( 15e3)), 1e3),
+      12e4
+    );
+  }
+  /**
+   * Consulta datos de un contribuyente por RNC o cédula.
+   */
+  async getContribuyente(rnc) {
+    if (typeof rnc !== "string" || rnc.trim() === "") {
+      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
+    }
+    const tokens = await this._fetchTokens(this._rncUrl);
+    const body = buildFormBody([
+      ["__EVENTTARGET", ""],
+      ["__EVENTARGUMENT", ""],
+      [FORM_FIELDS.viewState, tokens.viewState],
+      [FORM_FIELDS.viewStateGenerator, tokens.viewStateGenerator],
+      [FORM_FIELDS.eventValidation, tokens.eventValidation],
+      [FORM_FIELDS.rncInput, rnc.trim()],
+      ["ctl00$cphMain$txtRazonSocial", ""],
+      ["ctl00$cphMain$hidActiveTab", "rnc"],
+      [FORM_FIELDS.rncSubmit, "BUSCAR"]
+    ]);
+    const html = await this._post(this._rncUrl, body);
+    return parseContribuyenteHtml(html);
+  }
+  /**
+   * Valida un comprobante fiscal (NCF) contra la DGII.
+   */
+  async getNCF(rnc, ncf) {
+    if (typeof rnc !== "string" || rnc.trim() === "") {
+      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
+    }
+    if (typeof ncf !== "string" || ncf.trim() === "") {
+      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro ncf es requerido");
+    }
+    const tokens = await this._fetchTokens(this._ncfUrl);
+    const body = buildFormBody([
+      [FORM_FIELDS.viewState, tokens.viewState],
+      [FORM_FIELDS.viewStateGenerator, tokens.viewStateGenerator],
+      [FORM_FIELDS.eventValidation, tokens.eventValidation],
+      [FORM_FIELDS.ncfRncInput, rnc.trim()],
+      [FORM_FIELDS.ncfInput, ncf.trim()],
+      [FORM_FIELDS.ncfSubmit, "Buscar"]
+    ]);
+    const html = await this._post(this._ncfUrl, body);
+    return parseNcfHtml(html);
+  }
+  async _fetchTokens(url) {
+    let response;
+    try {
+      response = await fetch(url, {
+        headers: { "User-Agent": DEFAULT_USER_AGENT },
+        signal: AbortSignal.timeout(this._timeout)
+      });
+    } catch (error) {
+      throw this._wrapFetchError(error);
+    }
+    if (!response.ok) {
+      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+        `La DGII respondi\xF3 con HTTP ${response.status} al obtener la p\xE1gina`,
+        { statusCode: response.status }
+      );
+    }
+    const html = await response.text();
+    return extractViewStateTokens(html);
+  }
+  async _post(url, body) {
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "User-Agent": DEFAULT_USER_AGENT,
+          "Content-Type": "application/x-www-form-urlencoded",
+          "Referer": url
+        },
+        body,
+        signal: AbortSignal.timeout(this._timeout)
+      });
+    } catch (error) {
+      throw this._wrapFetchError(error);
+    }
+    if (!response.ok) {
+      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+        `La DGII respondi\xF3 con HTTP ${response.status}`,
+        { statusCode: response.status }
+      );
+    }
+    return response.text();
+  }
+  _wrapFetchError(error) {
+    return _chunkWY6V4Y7Scjs.wrapFetchError.call(void 0, error, this._timeout);
+  }
+};
+function buildFormBody(fields) {
+  return fields.map(
+    ([name, value]) => `${encodeURIComponent(name)}=${encodeURIComponent(value)}`.replace(/%24/g, "$")
+  ).join("&");
+}
+
+
+
+
+
+
+exports.DGII_RNC_URL = DGII_RNC_URL; exports.DGII_NCF_URL = DGII_NCF_URL; exports.FORM_FIELDS = FORM_FIELDS; exports.ScrapingClient = ScrapingClient;

package/dist/chunk-WY6V4Y7S.cjs

@@ -0,0 +1,23 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunk7RJWFPCZcjs = require('./chunk-7RJWFPCZ.cjs');
+
+// src/utils/fetch-error.ts
+function wrapFetchError(error, timeoutMs) {
+  const name = error.name;
+  const causeName = _optionalChain([error, 'access', _ => _.cause, 'optionalAccess', _2 => _2.name]);
+  if (name === "TimeoutError" || causeName === "TimeoutError" || name === "AbortError" || causeName === "AbortError") {
+    return new (0, _chunk7RJWFPCZcjs.DgiiConnectionError)(
+      `Timeout de ${timeoutMs}ms excedido al conectar con la DGII`,
+      { cause: error }
+    );
+  }
+  return new (0, _chunk7RJWFPCZcjs.DgiiConnectionError)(
+    "Error de conexi\xF3n con el servicio de la DGII",
+    { cause: error }
+  );
+}
+
+
+
+exports.wrapFetchError = wrapFetchError;

package/dist/client.cjs

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunk6CIP7YH6cjs = require('./chunk-6CIP7YH6.cjs');
+require('./chunk-4OYLCOUL.cjs');
+require('./chunk-VJ4ZQQIQ.cjs');
+require('./chunk-WY6V4Y7S.cjs');
+require('./chunk-QH4BK5X3.cjs');
+require('./chunk-7RJWFPCZ.cjs');
+
+
+
+
+
+exports.ConsecutiveBreaker = _chunk6CIP7YH6cjs.ConsecutiveBreaker; exports.DgiiClient = _chunk6CIP7YH6cjs.DgiiClient; exports.isRetryableError = _chunk6CIP7YH6cjs.isRetryableError; exports.withRetry = _chunk6CIP7YH6cjs.withRetry;

package/dist/client.d.cts

@@ -0,0 +1,95 @@
+import { C as Contribuyente, N as NcfQueryResult } from './index-CS-7YY2y.cjs';
+
+interface RetryOptions {
+    /** Número máximo de reintentos (por defecto: 2) */
+    maxRetries: number;
+    /** Delay base en milisegundos (por defecto: 500) */
+    baseDelayMs: number;
+    /** Delay máximo en milisegundos (por defecto: 10000) */
+    maxDelayMs: number;
+}
+/**
+ * Determina si un error es reintentable.
+ *
+ * - DgiiConnectionError: siempre reintentable
+ * - DgiiServiceError con statusCode >= 500: reintentable
+ * - DgiiNotFoundError: nunca reintentable (resultado de negocio)
+ * - DgiiServiceError con 403/4xx: nunca reintentable
+ */
+declare function isRetryableError(error: unknown): boolean;
+/**
+ * Ejecuta una función con reintentos y backoff exponencial
+ * con jitter completo.
+ *
+ * Fórmula: delay = random(0, min(maxDelay, baseDelay * 2^attempt))
+ */
+declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+
+interface CircuitBreakerOptions {
+    /** Fallos consecutivos para abrir el circuito (por defecto: 5) */
+    failureThreshold: number;
+    /** Tiempo en ms antes de probar de nuevo (por defecto: 60000) */
+    recoveryTimeoutMs: number;
+    /** Éxitos consecutivos en HALF_OPEN para cerrar (por defecto: 2) */
+    successThreshold: number;
+}
+type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+/**
+ * Circuit breaker basado en fallos consecutivos.
+ *
+ * - CLOSED: operación normal, se cuentan fallos consecutivos
+ * - OPEN: rechaza inmediatamente, espera recoveryTimeoutMs
+ * - HALF_OPEN: permite llamadas de prueba, cierra después
+ *   de successThreshold éxitos consecutivos
+ */
+declare class ConsecutiveBreaker {
+    private _state;
+    private _failures;
+    private _successes;
+    private _lastFailureTime;
+    private readonly _options;
+    constructor(options?: Partial<CircuitBreakerOptions>);
+    get state(): CircuitState;
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    reset(): void;
+    private _onSuccess;
+    private _onFailure;
+}
+
+interface ClientOptions {
+    /** Tiempo de espera en milisegundos (por defecto: 15000) */
+    timeout?: number;
+    /** Habilitar fallback a SOAP (por defecto: true) */
+    soapFallback?: boolean;
+    /** Opciones de reintentos */
+    retry?: Partial<RetryOptions>;
+    /** Opciones del circuit breaker */
+    circuitBreaker?: Partial<CircuitBreakerOptions>;
+}
+
+/**
+ * Cliente resiliente para consultas a la DGII.
+ *
+ * Usa web scraping como estrategia principal y SOAP como
+ * fallback (con circuit breaker y reintentos automáticos).
+ */
+declare class DgiiClient {
+    private readonly _scraping;
+    private readonly _soap;
+    private readonly _scrapingBreaker;
+    private readonly _soapBreaker;
+    private readonly _retryOptions;
+    private readonly _soapFallback;
+    constructor(options?: ClientOptions);
+    /**
+     * Consulta datos de un contribuyente por RNC o cédula.
+     */
+    getContribuyente(rnc: string): Promise<Contribuyente>;
+    /**
+     * Valida un comprobante fiscal (NCF) contra la DGII.
+     */
+    getNCF(rnc: string, ncf: string): Promise<NcfQueryResult>;
+    private _executeWithFallback;
+}
+
+export { type CircuitBreakerOptions, type ClientOptions, ConsecutiveBreaker, DgiiClient, type RetryOptions, isRetryableError, withRetry };

package/dist/client.d.ts

@@ -0,0 +1,95 @@
+import { C as Contribuyente, N as NcfQueryResult } from './index-CS-7YY2y.js';
+
+interface RetryOptions {
+    /** Número máximo de reintentos (por defecto: 2) */
+    maxRetries: number;
+    /** Delay base en milisegundos (por defecto: 500) */
+    baseDelayMs: number;
+    /** Delay máximo en milisegundos (por defecto: 10000) */
+    maxDelayMs: number;
+}
+/**
+ * Determina si un error es reintentable.
+ *
+ * - DgiiConnectionError: siempre reintentable
+ * - DgiiServiceError con statusCode >= 500: reintentable
+ * - DgiiNotFoundError: nunca reintentable (resultado de negocio)
+ * - DgiiServiceError con 403/4xx: nunca reintentable
+ */
+declare function isRetryableError(error: unknown): boolean;
+/**
+ * Ejecuta una función con reintentos y backoff exponencial
+ * con jitter completo.
+ *
+ * Fórmula: delay = random(0, min(maxDelay, baseDelay * 2^attempt))
+ */
+declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+
+interface CircuitBreakerOptions {
+    /** Fallos consecutivos para abrir el circuito (por defecto: 5) */
+    failureThreshold: number;
+    /** Tiempo en ms antes de probar de nuevo (por defecto: 60000) */
+    recoveryTimeoutMs: number;
+    /** Éxitos consecutivos en HALF_OPEN para cerrar (por defecto: 2) */
+    successThreshold: number;
+}
+type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+/**
+ * Circuit breaker basado en fallos consecutivos.
+ *
+ * - CLOSED: operación normal, se cuentan fallos consecutivos
+ * - OPEN: rechaza inmediatamente, espera recoveryTimeoutMs
+ * - HALF_OPEN: permite llamadas de prueba, cierra después
+ *   de successThreshold éxitos consecutivos
+ */
+declare class ConsecutiveBreaker {
+    private _state;
+    private _failures;
+    private _successes;
+    private _lastFailureTime;
+    private readonly _options;
+    constructor(options?: Partial<CircuitBreakerOptions>);
+    get state(): CircuitState;
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    reset(): void;
+    private _onSuccess;
+    private _onFailure;
+}
+
+interface ClientOptions {
+    /** Tiempo de espera en milisegundos (por defecto: 15000) */
+    timeout?: number;
+    /** Habilitar fallback a SOAP (por defecto: true) */
+    soapFallback?: boolean;
+    /** Opciones de reintentos */
+    retry?: Partial<RetryOptions>;
+    /** Opciones del circuit breaker */
+    circuitBreaker?: Partial<CircuitBreakerOptions>;
+}
+
+/**
+ * Cliente resiliente para consultas a la DGII.
+ *
+ * Usa web scraping como estrategia principal y SOAP como
+ * fallback (con circuit breaker y reintentos automáticos).
+ */
+declare class DgiiClient {
+    private readonly _scraping;
+    private readonly _soap;
+    private readonly _scrapingBreaker;
+    private readonly _soapBreaker;
+    private readonly _retryOptions;
+    private readonly _soapFallback;
+    constructor(options?: ClientOptions);
+    /**
+     * Consulta datos de un contribuyente por RNC o cédula.
+     */
+    getContribuyente(rnc: string): Promise<Contribuyente>;
+    /**
+     * Valida un comprobante fiscal (NCF) contra la DGII.
+     */
+    getNCF(rnc: string, ncf: string): Promise<NcfQueryResult>;
+    private _executeWithFallback;
+}
+
+export { type CircuitBreakerOptions, type ClientOptions, ConsecutiveBreaker, DgiiClient, type RetryOptions, isRetryableError, withRetry };

package/dist/client.js

@@ -0,0 +1,17 @@
+import {
+  ConsecutiveBreaker,
+  DgiiClient,
+  isRetryableError,
+  withRetry
+} from "./chunk-4TKAQ4WV.js";
+import "./chunk-HR4DCHH7.js";
+import "./chunk-HGE4QZ3H.js";
+import "./chunk-53A7IG4Y.js";
+import "./chunk-D26S6EXD.js";
+import "./chunk-DMGDJEUY.js";
+export {
+  ConsecutiveBreaker,
+  DgiiClient,
+  isRetryableError,
+  withRetry
+};

package/dist/errors.cjs

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+var _chunk7RJWFPCZcjs = require('./chunk-7RJWFPCZ.cjs');
+
+
+
+
+
+
+exports.AllStrategiesFailedError = _chunk7RJWFPCZcjs.AllStrategiesFailedError; exports.DgiiConnectionError = _chunk7RJWFPCZcjs.DgiiConnectionError; exports.DgiiError = _chunk7RJWFPCZcjs.DgiiError; exports.DgiiNotFoundError = _chunk7RJWFPCZcjs.DgiiNotFoundError; exports.DgiiServiceError = _chunk7RJWFPCZcjs.DgiiServiceError;

package/dist/errors.d.cts

@@ -0,0 +1,40 @@
+/**
+ * Error base para todas las operaciones DGII.
+ */
+declare class DgiiError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string, options?: ErrorOptions);
+}
+/**
+ * Error de conexión: timeout, DNS, red caída, TLS.
+ */
+declare class DgiiConnectionError extends DgiiError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * RNC/cédula o NCF no encontrado en el registro de la DGII.
+ * Esto NO es un error de infraestructura -- es un resultado
+ * válido de negocio.
+ */
+declare class DgiiNotFoundError extends DgiiError {
+    constructor(message: string);
+}
+/**
+ * Error del servicio: SOAP fault, HTTP 403/5xx, respuesta
+ * inesperada.
+ */
+declare class DgiiServiceError extends DgiiError {
+    readonly statusCode?: number;
+    constructor(message: string, options?: ErrorOptions & {
+        statusCode?: number;
+    });
+}
+/**
+ * Todas las estrategias de consulta fallaron.
+ */
+declare class AllStrategiesFailedError extends DgiiError {
+    readonly errors: ReadonlyArray<Error>;
+    constructor(message: string, errors: ReadonlyArray<Error>);
+}
+
+export { AllStrategiesFailedError, DgiiConnectionError, DgiiError, DgiiNotFoundError, DgiiServiceError };

package/dist/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Error base para todas las operaciones DGII.
+ */
+declare class DgiiError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string, options?: ErrorOptions);
+}
+/**
+ * Error de conexión: timeout, DNS, red caída, TLS.
+ */
+declare class DgiiConnectionError extends DgiiError {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * RNC/cédula o NCF no encontrado en el registro de la DGII.
+ * Esto NO es un error de infraestructura -- es un resultado
+ * válido de negocio.
+ */
+declare class DgiiNotFoundError extends DgiiError {
+    constructor(message: string);
+}
+/**
+ * Error del servicio: SOAP fault, HTTP 403/5xx, respuesta
+ * inesperada.
+ */
+declare class DgiiServiceError extends DgiiError {
+    readonly statusCode?: number;
+    constructor(message: string, options?: ErrorOptions & {
+        statusCode?: number;
+    });
+}
+/**
+ * Todas las estrategias de consulta fallaron.
+ */
+declare class AllStrategiesFailedError extends DgiiError {
+    readonly errors: ReadonlyArray<Error>;
+    constructor(message: string, errors: ReadonlyArray<Error>);
+}
+
+export { AllStrategiesFailedError, DgiiConnectionError, DgiiError, DgiiNotFoundError, DgiiServiceError };

package/dist/errors.js

@@ -0,0 +1,14 @@
+import {
+  AllStrategiesFailedError,
+  DgiiConnectionError,
+  DgiiError,
+  DgiiNotFoundError,
+  DgiiServiceError
+} from "./chunk-DMGDJEUY.js";
+export {
+  AllStrategiesFailedError,
+  DgiiConnectionError,
+  DgiiError,
+  DgiiNotFoundError,
+  DgiiServiceError
+};