dgii-ts 0.1.1 → 0.1.3

package/README.en.md

@@ -180,6 +180,10 @@ const ncfResult = await client.getNCF('131098193', 'B0100000001');
 | `downloadBulkFile(options)` | Downloads DGII\_RNC.zip to the given directory |
 | `parseBulkFile(options)` | Parses the taxpayer TXT file |
 
+`parseBulkFile` throws `BulkFormatError` if the file doesn't match the
+expected 11-column layout (for example, if DGII changes the format). It
+accepts an `encoding` option (defaults to `latin1`).
+
 ## Architecture
 
 ```text

package/README.md

@@ -183,6 +183,10 @@ const ncfResult = await client.getNCF('131098193', 'B0100000001');
 | `downloadBulkFile(options)` | Descarga DGII\_RNC.zip |
 | `parseBulkFile(options)` | Parsea el archivo TXT |
 
+`parseBulkFile` lanza `BulkFormatError` si el archivo no coincide con el
+layout de 11 columnas esperado (por ejemplo, si la DGII cambia el formato).
+Acepta `encoding` en las opciones (`latin1` por defecto).
+
 ## Arquitectura
 
 ```text

package/dist/bulk.cjs

@@ -2,10 +2,16 @@
 
 
 
-var _chunkFZ6QDTC4cjs = require('./chunk-FZ6QDTC4.cjs');
+
+var _chunkVIZWYFHPcjs = require('./chunk-VIZWYFHP.cjs');
 require('./chunk-QH4BK5X3.cjs');
 
 
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
+
+
+
+
 
 
-exports.DGII_BULK_URL = _chunkFZ6QDTC4cjs.DGII_BULK_URL; exports.downloadBulkFile = _chunkFZ6QDTC4cjs.downloadBulkFile; exports.parseBulkFile = _chunkFZ6QDTC4cjs.parseBulkFile;
+exports.BulkFormatError = _chunkNASWEFHNcjs.BulkFormatError; exports.DGII_BULK_URL = _chunkVIZWYFHPcjs.DGII_BULK_URL; exports.DGII_ESTADOS = _chunkVIZWYFHPcjs.DGII_ESTADOS; exports.downloadBulkFile = _chunkVIZWYFHPcjs.downloadBulkFile; exports.parseBulkFile = _chunkVIZWYFHPcjs.parseBulkFile;

package/dist/bulk.d.cts

@@ -1,4 +1,5 @@
-import { B as BulkContribuyente } from './index-CS-7YY2y.cjs';
+import { B as BulkContribuyente } from './index-KNOaUG34.cjs';
+export { BulkFormatError } from './errors.cjs';
 
 interface DownloadOptions {
     /** Directorio de destino para el archivo ZIP */
@@ -9,8 +10,27 @@ interface DownloadOptions {
 interface ParseOptions {
     /** Ruta al archivo TXT extraído del ZIP */
     filePath: string;
+    /**
+     * Codificación del archivo. La DGII publica el TXT en latin-1
+     * (ISO-8859-1), que es el valor por defecto. Permite anularla si una
+     * futura versión del archivo llega en otra codificación (p. ej. UTF-8).
+     */
+    encoding?: BufferEncoding;
 }
 declare const DGII_BULK_URL: string;
+/**
+ * Valores conocidos de la columna `estado` (col 9) en el archivo masivo,
+ * verificados contra ~778k filas en producción. El parser usa este
+ * vocabulario para detectar un cambio de layout: si ninguna fila de una
+ * muestra trae un `estado` reconocido, el formato de la DGII cambió.
+ */
+declare const DGII_ESTADOS: readonly ["ACTIVO", "SUSPENDIDO", "DADO DE BAJA", "CESE TEMPORAL", "ANULADO", "RECHAZADO"];
+/**
+ * Valor de la columna `estado` del archivo masivo: uno de
+ * {@link DGII_ESTADOS}. Vocabulario completo de la DGII, distinto del
+ * `estado` binario (ACTIVO/INACTIVO) que exponen el scraping y el SOAP.
+ */
+type DgiiEstado = (typeof DGII_ESTADOS)[number];
 
 /**
  * Descarga el archivo masivo DGII_RNC.zip desde el portal de la DGII.
@@ -20,11 +40,34 @@ declare const DGII_BULK_URL: string;
 declare function downloadBulkFile(options: DownloadOptions): Promise<string>;
 
 /**
- * Parsea el archivo TXT de contribuyentes extraido de DGII_RNC.zip.
+ * Parsea el archivo TXT de contribuyentes extraído de DGII_RNC.zip.
+ *
+ * El archivo usa delimitador pipe (|) con 11 columnas y viene codificado
+ * en latin-1 (ISO-8859-1); leerlo como UTF-8 corrompe los nombres con
+ * ñ/acentos (p. ej. MUÑOZ, PEÑA). Usa {@link ParseOptions.encoding} para
+ * anular la codificación si una futura versión del archivo cambia.
+ *
+ * Layout verificado contra el archivo en producción (~778k filas):
+ *
+ *   col  0   rnc                (100% dígitos)
+ *   col  1   nombre             (razón social)
+ *   col  2   nombreComercial
+ *   col  3   actividad
+ *   col  4-7 reservadas/vacías en el archivo actual
+ *   col  8   fechaConstitucion  (dd/mm/yyyy)
+ *   col  9   estado             (ACTIVO / SUSPENDIDO / DADO DE BAJA / ...)
+ *   col 10   regimen            (NORMAL / RST / PST)
+ *
+ * `estado` se normaliza a mayúsculas para que coincida con
+ * {@link DGII_ESTADOS} sin importar la capitalización de la fuente.
  *
- * El archivo usa delimitador pipe (|) con 9 columnas.
- * Los registros pueden tener espacios dobles que se limpian.
+ * Las filas cuyo número de columnas no sea exactamente 11 se descartan por
+ * malformadas (formato viejo más corto, o una columna añadida/insertada).
+ * Si el archivo trae filas pero la mayoría de la muestra no trae un
+ * `estado` reconocido, se lanza {@link BulkFormatError}: un cambio de
+ * layout de la DGII debe fallar ruidosamente en vez de devolver `estado`
+ * vacío o mapeado a la columna equivocada en silencio.
  */
 declare function parseBulkFile(options: ParseOptions): Promise<BulkContribuyente[]>;
 
-export { BulkContribuyente, DGII_BULK_URL, type DownloadOptions, type ParseOptions, downloadBulkFile, parseBulkFile };
+export { BulkContribuyente, DGII_BULK_URL, DGII_ESTADOS, type DgiiEstado, type DownloadOptions, type ParseOptions, downloadBulkFile, parseBulkFile };

package/dist/bulk.d.ts

@@ -1,4 +1,5 @@
-import { B as BulkContribuyente } from './index-CS-7YY2y.js';
+import { B as BulkContribuyente } from './index-KNOaUG34.js';
+export { BulkFormatError } from './errors.js';
 
 interface DownloadOptions {
     /** Directorio de destino para el archivo ZIP */
@@ -9,8 +10,27 @@ interface DownloadOptions {
 interface ParseOptions {
     /** Ruta al archivo TXT extraído del ZIP */
     filePath: string;
+    /**
+     * Codificación del archivo. La DGII publica el TXT en latin-1
+     * (ISO-8859-1), que es el valor por defecto. Permite anularla si una
+     * futura versión del archivo llega en otra codificación (p. ej. UTF-8).
+     */
+    encoding?: BufferEncoding;
 }
 declare const DGII_BULK_URL: string;
+/**
+ * Valores conocidos de la columna `estado` (col 9) en el archivo masivo,
+ * verificados contra ~778k filas en producción. El parser usa este
+ * vocabulario para detectar un cambio de layout: si ninguna fila de una
+ * muestra trae un `estado` reconocido, el formato de la DGII cambió.
+ */
+declare const DGII_ESTADOS: readonly ["ACTIVO", "SUSPENDIDO", "DADO DE BAJA", "CESE TEMPORAL", "ANULADO", "RECHAZADO"];
+/**
+ * Valor de la columna `estado` del archivo masivo: uno de
+ * {@link DGII_ESTADOS}. Vocabulario completo de la DGII, distinto del
+ * `estado` binario (ACTIVO/INACTIVO) que exponen el scraping y el SOAP.
+ */
+type DgiiEstado = (typeof DGII_ESTADOS)[number];
 
 /**
  * Descarga el archivo masivo DGII_RNC.zip desde el portal de la DGII.
@@ -20,11 +40,34 @@ declare const DGII_BULK_URL: string;
 declare function downloadBulkFile(options: DownloadOptions): Promise<string>;
 
 /**
- * Parsea el archivo TXT de contribuyentes extraido de DGII_RNC.zip.
+ * Parsea el archivo TXT de contribuyentes extraído de DGII_RNC.zip.
+ *
+ * El archivo usa delimitador pipe (|) con 11 columnas y viene codificado
+ * en latin-1 (ISO-8859-1); leerlo como UTF-8 corrompe los nombres con
+ * ñ/acentos (p. ej. MUÑOZ, PEÑA). Usa {@link ParseOptions.encoding} para
+ * anular la codificación si una futura versión del archivo cambia.
+ *
+ * Layout verificado contra el archivo en producción (~778k filas):
+ *
+ *   col  0   rnc                (100% dígitos)
+ *   col  1   nombre             (razón social)
+ *   col  2   nombreComercial
+ *   col  3   actividad
+ *   col  4-7 reservadas/vacías en el archivo actual
+ *   col  8   fechaConstitucion  (dd/mm/yyyy)
+ *   col  9   estado             (ACTIVO / SUSPENDIDO / DADO DE BAJA / ...)
+ *   col 10   regimen            (NORMAL / RST / PST)
+ *
+ * `estado` se normaliza a mayúsculas para que coincida con
+ * {@link DGII_ESTADOS} sin importar la capitalización de la fuente.
  *
- * El archivo usa delimitador pipe (|) con 9 columnas.
- * Los registros pueden tener espacios dobles que se limpian.
+ * Las filas cuyo número de columnas no sea exactamente 11 se descartan por
+ * malformadas (formato viejo más corto, o una columna añadida/insertada).
+ * Si el archivo trae filas pero la mayoría de la muestra no trae un
+ * `estado` reconocido, se lanza {@link BulkFormatError}: un cambio de
+ * layout de la DGII debe fallar ruidosamente en vez de devolver `estado`
+ * vacío o mapeado a la columna equivocada en silencio.
  */
 declare function parseBulkFile(options: ParseOptions): Promise<BulkContribuyente[]>;
 
-export { BulkContribuyente, DGII_BULK_URL, type DownloadOptions, type ParseOptions, downloadBulkFile, parseBulkFile };
+export { BulkContribuyente, DGII_BULK_URL, DGII_ESTADOS, type DgiiEstado, type DownloadOptions, type ParseOptions, downloadBulkFile, parseBulkFile };

package/dist/bulk.js

@@ -1,11 +1,17 @@
 import {
   DGII_BULK_URL,
+  DGII_ESTADOS,
   downloadBulkFile,
   parseBulkFile
-} from "./chunk-KIS7MVIW.js";
+} from "./chunk-Z72T6CZG.js";
 import "./chunk-D26S6EXD.js";
+import {
+  BulkFormatError
+} from "./chunk-IRQX4WNQ.js";
 export {
+  BulkFormatError,
   DGII_BULK_URL,
+  DGII_ESTADOS,
   downloadBulkFile,
   parseBulkFile
 };

package/dist/{chunk-VJ4ZQQIQ.cjs → chunk-AML7LZBU.cjs}

@@ -1,6 +1,6 @@
 "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 _chunkWMFHPNFPcjs = require('./chunk-WMFHPNFP.cjs');
 
 
 
@@ -8,7 +8,7 @@ var _chunkQH4BK5X3cjs = require('./chunk-QH4BK5X3.cjs');
 
 
 
-var _chunk7RJWFPCZcjs = require('./chunk-7RJWFPCZ.cjs');
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
 
 // src/scraping/endpoints.ts
 var DGII_RNC_URL = "https://dgii.gov.do/app/WebApps/ConsultasWeb2/ConsultasWeb/consultas/rnc.aspx";
@@ -30,7 +30,7 @@ function extractViewStateTokens(html) {
   const viewStateGenerator = extractInputValue(html, "__VIEWSTATEGENERATOR");
   const eventValidation = extractInputValue(html, "__EVENTVALIDATION");
   if (!viewState || !eventValidation) {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+    throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
       "No se encontraron tokens ViewState en la p\xE1gina de la DGII"
     );
   }
@@ -43,7 +43,7 @@ function parseContribuyenteHtml(html) {
     if (infoEnd !== -1) {
       const infoBlock = html.slice(infoStart, infoEnd);
       if (infoBlock.includes("no se encuentra")) {
-        throw new (0, _chunk7RJWFPCZcjs.DgiiNotFoundError)(
+        throw new (0, _chunkNASWEFHNcjs.DgiiNotFoundError)(
           "RNC o c\xE9dula no encontrado en el registro de la DGII"
         );
       }
@@ -52,13 +52,13 @@ function parseContribuyenteHtml(html) {
   const tableId = "cphMain_dvDatosContribuyentes";
   const tableStart = html.indexOf(tableId);
   if (tableStart === -1) {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+    throw new (0, _chunkNASWEFHNcjs.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)(
+    throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
       "Formato de respuesta HTML inesperado: tabla incompleta"
     );
   }
@@ -72,12 +72,14 @@ function parseContribuyenteHtml(html) {
   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));
+  const rawFacturadorElectronico = _nullishCoalesce(fields.get("Facturador Electronico"), () => ( ""));
   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),
+    esFacturadorElectronico: rawFacturadorElectronico.trim().toUpperCase().replace(/[ÍI]/g, "I").startsWith("SI"),
     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
@@ -181,7 +183,7 @@ var ScrapingClient = class {
    */
   async getContribuyente(rnc) {
     if (typeof rnc !== "string" || rnc.trim() === "") {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
     }
     const tokens = await this._fetchTokens(this._rncUrl);
     const body = buildFormBody([
@@ -203,10 +205,10 @@ var ScrapingClient = class {
    */
   async getNCF(rnc, ncf) {
     if (typeof rnc !== "string" || rnc.trim() === "") {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
     }
     if (typeof ncf !== "string" || ncf.trim() === "") {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro ncf es requerido");
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)("El par\xE1metro ncf es requerido");
     }
     const tokens = await this._fetchTokens(this._ncfUrl);
     const body = buildFormBody([
@@ -231,7 +233,7 @@ var ScrapingClient = class {
       throw this._wrapFetchError(error);
     }
     if (!response.ok) {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
         `La DGII respondi\xF3 con HTTP ${response.status} al obtener la p\xE1gina`,
         { statusCode: response.status }
       );
@@ -256,7 +258,7 @@ var ScrapingClient = class {
       throw this._wrapFetchError(error);
     }
     if (!response.ok) {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
         `La DGII respondi\xF3 con HTTP ${response.status}`,
         { statusCode: response.status }
       );
@@ -264,7 +266,7 @@ var ScrapingClient = class {
     return response.text();
   }
   _wrapFetchError(error) {
-    return _chunkWY6V4Y7Scjs.wrapFetchError.call(void 0, error, this._timeout);
+    return _chunkWMFHPNFPcjs.wrapFetchError.call(void 0, error, this._timeout);
   }
 };
 function buildFormBody(fields) {

package/dist/{chunk-4OYLCOUL.cjs → chunk-DLB5RJ7E.cjs}

@@ -1,6 +1,6 @@
 "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 _chunkWMFHPNFPcjs = require('./chunk-WMFHPNFP.cjs');
 
 
 
@@ -8,7 +8,7 @@ var _chunkQH4BK5X3cjs = require('./chunk-QH4BK5X3.cjs');
 
 
 
-var _chunk7RJWFPCZcjs = require('./chunk-7RJWFPCZ.cjs');
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
 
 // src/soap/endpoints.ts
 var DGII_SOAP_BASE_URL = "https://dgii.gov.do/wsMovilDGII/WSMovilDGII.asmx";
@@ -49,13 +49,13 @@ function sanitizeJson(raw) {
 function parseContribuyenteResponse(responseXml) {
   const raw = extractTagContent(responseXml, "GetContribuyentesResult");
   if (raw === void 0) {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+    throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
       "Respuesta SOAP sin GetContribuyentesResult"
     );
   }
   const trimmed = raw.trim();
   if (trimmed === "0" || trimmed === "") {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiNotFoundError)(
+    throw new (0, _chunkNASWEFHNcjs.DgiiNotFoundError)(
       "RNC o c\xE9dula no encontrado en el registro de la DGII"
     );
   }
@@ -65,12 +65,12 @@ function parseContribuyenteResponse(responseXml) {
   try {
     parsed = JSON.parse(sanitized);
   } catch (e) {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+    throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
       "Respuesta de la DGII no es JSON v\xE1lido"
     );
   }
   if (typeof parsed !== "object" || parsed === null || typeof parsed["RGE_RUC"] !== "string") {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+    throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
       "Formato de respuesta de la DGII inesperado"
     );
   }
@@ -80,13 +80,15 @@ function parseContribuyenteResponse(responseXml) {
     nombre: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, String(_nullishCoalesce(data["RGE_NOMBRE"], () => ( "")))),
     nombreComercial: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, String(_nullishCoalesce(data["NOMBRE_COMERCIAL"], () => ( "")))),
     estado: String(_nullishCoalesce(data["ESTATUS"], () => ( ""))) === "2" ? "ACTIVO" : "INACTIVO",
-    categoria: String(_nullishCoalesce(data["CATEGORIA"], () => ( "")))
+    categoria: String(_nullishCoalesce(data["CATEGORIA"], () => ( ""))),
+    // TODO: derivar de la respuesta SOAP cuando la DGII restaure el endpoint
+    esFacturadorElectronico: false
   };
 }
 function parseNcfResponse(responseXml) {
   const raw = extractTagContent(responseXml, "GetNCFResult");
   if (raw === void 0) {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("Respuesta SOAP sin GetNCFResult");
+    throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)("Respuesta SOAP sin GetNCFResult");
   }
   const trimmed = raw.trim();
   if (trimmed === "0" || trimmed === "") {
@@ -97,12 +99,12 @@ function parseNcfResponse(responseXml) {
   try {
     parsed = JSON.parse(sanitized);
   } catch (e2) {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+    throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
       "Respuesta de la DGII no es JSON v\xE1lido"
     );
   }
   if (typeof parsed !== "object" || parsed === null) {
-    throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+    throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
       "Formato de respuesta de la DGII inesperado"
     );
   }
@@ -142,22 +144,22 @@ var DgiiSoapClient = class {
         signal: AbortSignal.timeout(timeout)
       });
     } catch (error) {
-      throw _chunkWY6V4Y7Scjs.wrapFetchError.call(void 0, error, timeout);
+      throw _chunkWMFHPNFPcjs.wrapFetchError.call(void 0, error, timeout);
     }
     const contentLength = response.headers.get("content-length");
     if (contentLength && parseInt(contentLength, 10) > 1048576) {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
         "Respuesta de la DGII excede el tama\xF1o m\xE1ximo permitido"
       );
     }
     if (response.status === 403) {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
         "Acceso denegado por la DGII (HTTP 403). El servicio puede estar restringido por ubicaci\xF3n geogr\xE1fica.",
         { statusCode: 403 }
       );
     }
     if (!response.ok) {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
         `El servicio de la DGII respondi\xF3 con HTTP ${response.status}`,
         { statusCode: response.status }
       );
@@ -169,7 +171,7 @@ var DgiiSoapClient = class {
    */
   async getContribuyente(rnc) {
     if (typeof rnc !== "string" || rnc.trim() === "") {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
     }
     const envelope = buildGetContribuyentesEnvelope(rnc.trim());
     const responseXml = await this._fetch(
@@ -183,10 +185,10 @@ var DgiiSoapClient = class {
    */
   async getNCF(rnc, ncf) {
     if (typeof rnc !== "string" || rnc.trim() === "") {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
     }
     if (typeof ncf !== "string" || ncf.trim() === "") {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)("El par\xE1metro ncf es requerido");
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)("El par\xE1metro ncf es requerido");
     }
     const envelope = buildGetNcfEnvelope(rnc.trim(), ncf.trim());
     const responseXml = await this._fetch(SOAP_ACTIONS.getNCF, envelope);

package/dist/{chunk-DMGDJEUY.js → chunk-IRQX4WNQ.js}

@@ -34,11 +34,18 @@ var AllStrategiesFailedError = class extends DgiiError {
     this.errors = errors;
   }
 };
+var BulkFormatError = class extends DgiiError {
+  constructor(message) {
+    super(message, "DGII_BULK_FORMAT_ERROR");
+    this.name = "BulkFormatError";
+  }
+};
 
 export {
   DgiiError,
   DgiiConnectionError,
   DgiiNotFoundError,
   DgiiServiceError,
-  AllStrategiesFailedError
+  AllStrategiesFailedError,
+  BulkFormatError
 };

package/dist/{chunk-4TKAQ4WV.js → chunk-KJXLES3I.js}

@@ -1,15 +1,15 @@
 import {
   DgiiSoapClient
-} from "./chunk-HR4DCHH7.js";
+} from "./chunk-QTN5ZT4P.js";
 import {
   ScrapingClient
-} from "./chunk-HGE4QZ3H.js";
+} from "./chunk-YTX4QOLE.js";
 import {
   AllStrategiesFailedError,
   DgiiConnectionError,
   DgiiNotFoundError,
   DgiiServiceError
-} from "./chunk-DMGDJEUY.js";
+} from "./chunk-IRQX4WNQ.js";
 
 // src/client/circuit-breaker.ts
 var DEFAULT_CIRCUIT_BREAKER_OPTIONS = /* @__PURE__ */ Object.freeze({

package/dist/{chunk-53A7IG4Y.js → chunk-KW4ZV6FJ.js}

@@ -1,6 +1,6 @@
 import {
   DgiiConnectionError
-} from "./chunk-DMGDJEUY.js";
+} from "./chunk-IRQX4WNQ.js";
 
 // src/utils/fetch-error.ts
 function wrapFetchError(error, timeoutMs) {

package/dist/{chunk-6CIP7YH6.cjs → chunk-MUAPXS3H.cjs}

@@ -1,15 +1,15 @@
 "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 _chunk4OYLCOULcjs = require('./chunk-4OYLCOUL.cjs');
+var _chunkDLB5RJ7Ecjs = require('./chunk-DLB5RJ7E.cjs');
 
 
-var _chunkVJ4ZQQIQcjs = require('./chunk-VJ4ZQQIQ.cjs');
+var _chunkAML7LZBUcjs = require('./chunk-AML7LZBU.cjs');
 
 
 
 
 
-var _chunk7RJWFPCZcjs = require('./chunk-7RJWFPCZ.cjs');
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
 
 // src/client/circuit-breaker.ts
 var DEFAULT_CIRCUIT_BREAKER_OPTIONS = /* @__PURE__ */ Object.freeze({
@@ -39,7 +39,7 @@ var ConsecutiveBreaker = class {
   async execute(fn) {
     const currentState = this.state;
     if (currentState === "OPEN") {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
         "Circuito abierto: estrategia deshabilitada temporalmente"
       );
     }
@@ -89,9 +89,9 @@ var DEFAULT_RETRY_OPTIONS = /* @__PURE__ */ Object.freeze({
   maxDelayMs: 1e4
 });
 function isRetryableError(error) {
-  if (error instanceof _chunk7RJWFPCZcjs.DgiiNotFoundError) return false;
-  if (error instanceof _chunk7RJWFPCZcjs.DgiiConnectionError) return true;
-  if (error instanceof _chunk7RJWFPCZcjs.DgiiServiceError) {
+  if (error instanceof _chunkNASWEFHNcjs.DgiiNotFoundError) return false;
+  if (error instanceof _chunkNASWEFHNcjs.DgiiConnectionError) return true;
+  if (error instanceof _chunkNASWEFHNcjs.DgiiServiceError) {
     const code = error.statusCode;
     if (code !== void 0 && code >= 500) return true;
     return false;
@@ -123,10 +123,10 @@ async function withRetry(fn, options = DEFAULT_RETRY_OPTIONS) {
 var DgiiClient = class {
   constructor(options) {
     const timeout = _optionalChain([options, 'optionalAccess', _ => _.timeout]);
-    this._scraping = new (0, _chunkVJ4ZQQIQcjs.ScrapingClient)(
+    this._scraping = new (0, _chunkAML7LZBUcjs.ScrapingClient)(
       timeout ? { timeout } : void 0
     );
-    this._soap = new (0, _chunk4OYLCOULcjs.DgiiSoapClient)(
+    this._soap = new (0, _chunkDLB5RJ7Ecjs.DgiiSoapClient)(
       timeout ? { timeout } : void 0
     );
     this._scrapingBreaker = new ConsecutiveBreaker(
@@ -167,7 +167,7 @@ var DgiiClient = class {
         )
       );
     } catch (error) {
-      if (error instanceof _chunk7RJWFPCZcjs.DgiiNotFoundError) throw error;
+      if (error instanceof _chunkNASWEFHNcjs.DgiiNotFoundError) throw error;
       errors.push(error instanceof Error ? error : new Error(String(error)));
     }
     if (this._soapFallback) {
@@ -179,11 +179,11 @@ var DgiiClient = class {
           )
         );
       } catch (error) {
-        if (error instanceof _chunk7RJWFPCZcjs.DgiiNotFoundError) throw error;
+        if (error instanceof _chunkNASWEFHNcjs.DgiiNotFoundError) throw error;
         errors.push(error instanceof Error ? error : new Error(String(error)));
       }
     }
-    throw new (0, _chunk7RJWFPCZcjs.AllStrategiesFailedError)(
+    throw new (0, _chunkNASWEFHNcjs.AllStrategiesFailedError)(
       `Todas las estrategias de consulta fallaron. \xDAltimo error: ${_nullishCoalesce(_optionalChain([errors, 'access', _6 => _6[errors.length - 1], 'optionalAccess', _7 => _7.message]), () => ( "desconocido"))}`,
       errors
     );

package/dist/{chunk-7RJWFPCZ.cjs → chunk-NASWEFHN.cjs}

@@ -34,6 +34,13 @@ var AllStrategiesFailedError = class extends DgiiError {
     this.errors = errors;
   }
 };
+var BulkFormatError = class extends DgiiError {
+  constructor(message) {
+    super(message, "DGII_BULK_FORMAT_ERROR");
+    this.name = "BulkFormatError";
+  }
+};
+
 
 
 
@@ -41,4 +48,4 @@ var AllStrategiesFailedError = class extends DgiiError {
 
 
 
-exports.DgiiError = DgiiError; exports.DgiiConnectionError = DgiiConnectionError; exports.DgiiNotFoundError = DgiiNotFoundError; exports.DgiiServiceError = DgiiServiceError; exports.AllStrategiesFailedError = AllStrategiesFailedError;
+exports.DgiiError = DgiiError; exports.DgiiConnectionError = DgiiConnectionError; exports.DgiiNotFoundError = DgiiNotFoundError; exports.DgiiServiceError = DgiiServiceError; exports.AllStrategiesFailedError = AllStrategiesFailedError; exports.BulkFormatError = BulkFormatError;

package/dist/{chunk-HR4DCHH7.js → chunk-QTN5ZT4P.js}

@@ -1,6 +1,6 @@
 import {
   wrapFetchError
-} from "./chunk-53A7IG4Y.js";
+} from "./chunk-KW4ZV6FJ.js";
 import {
   collapseSpaces,
   stripNonDigits
@@ -8,7 +8,7 @@ import {
 import {
   DgiiNotFoundError,
   DgiiServiceError
-} from "./chunk-DMGDJEUY.js";
+} from "./chunk-IRQX4WNQ.js";
 
 // src/soap/endpoints.ts
 var DGII_SOAP_BASE_URL = "https://dgii.gov.do/wsMovilDGII/WSMovilDGII.asmx";
@@ -80,7 +80,9 @@ function parseContribuyenteResponse(responseXml) {
     nombre: collapseSpaces(String(data["RGE_NOMBRE"] ?? "")),
     nombreComercial: collapseSpaces(String(data["NOMBRE_COMERCIAL"] ?? "")),
     estado: String(data["ESTATUS"] ?? "") === "2" ? "ACTIVO" : "INACTIVO",
-    categoria: String(data["CATEGORIA"] ?? "")
+    categoria: String(data["CATEGORIA"] ?? ""),
+    // TODO: derivar de la respuesta SOAP cuando la DGII restaure el endpoint
+    esFacturadorElectronico: false
   };
 }
 function parseNcfResponse(responseXml) {