dgii-ts 0.1.2 → 0.2.0

package/dist/{chunk-SUSDEKID.cjs → chunk-UW6W2JHW.cjs}

@@ -729,56 +729,9 @@ function validateNcf(value) {
   };
 }
 
-// src/validators/ecf.ts
-var ECF_TYPES = /* @__PURE__ */ Object.freeze({
-  "31": "CREDITO_FISCAL_ELECTRONICA",
-  "32": "CONSUMO_ELECTRONICA",
-  "33": "NOTA_DE_DEBITO_ELECTRONICA",
-  "34": "NOTA_DE_CREDITO_ELECTRONICA",
-  "41": "COMPRAS_ELECTRONICO",
-  "43": "GASTOS_MENORES_ELECTRONICO",
-  "44": "REGIMENES_ESPECIALES_ELECTRONICO",
-  "45": "GUBERNAMENTAL_ELECTRONICO",
-  "46": "EXPORTACIONES_ELECTRONICO",
-  "47": "PAGOS_AL_EXTERIOR_ELECTRONICO"
-});
-var ECF_TYPE_NAMES = /* @__PURE__ */ Object.freeze({
-  "31": "Factura de cr\xE9dito fiscal electr\xF3nica",
-  "32": "Factura de consumo electr\xF3nica",
-  "33": "Nota de d\xE9bito electr\xF3nica",
-  "34": "Nota de cr\xE9dito electr\xF3nica",
-  "41": "Comprobante electr\xF3nico de compras",
-  "43": "Comprobante electr\xF3nico para gastos menores",
-  "44": "Comprobante electr\xF3nico para reg\xEDmenes especiales",
-  "45": "Comprobante electr\xF3nico gubernamental",
-  "46": "Comprobante electr\xF3nico para exportaciones",
-  "47": "Comprobante electr\xF3nico para pagos al exterior"
-});
-var ECF_PATTERN = /^E(\d{2})(\d{10})$/;
-function validateEcf(value) {
-  if (typeof value !== "string") return { valid: false };
-  const normalized = value.toUpperCase().trim();
-  const match = ECF_PATTERN.exec(normalized);
-  if (!match) {
-    return { valid: false };
-  }
-  const typeCode = match[1];
-  const type = ECF_TYPES[typeCode];
-  if (!type) {
-    return { valid: false };
-  }
-  return {
-    valid: true,
-    type,
-    serie: `E${typeCode}`
-  };
-}
-
-
-
 
 
 
 
 
-exports.validateRnc = validateRnc; exports.validateCedula = validateCedula; exports.NCF_TYPE_NAMES = NCF_TYPE_NAMES; exports.validateNcf = validateNcf; exports.ECF_TYPE_NAMES = ECF_TYPE_NAMES; exports.validateEcf = validateEcf;
+exports.validateRnc = validateRnc; exports.validateCedula = validateCedula; exports.NCF_TYPE_NAMES = NCF_TYPE_NAMES; exports.validateNcf = validateNcf;

package/dist/{chunk-FZ6QDTC4.cjs → chunk-VIZWYFHP.cjs}

@@ -2,6 +2,9 @@
 
 var _chunkQH4BK5X3cjs = require('./chunk-QH4BK5X3.cjs');
 
+
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
+
 // src/bulk/downloader.ts
 var _https = require('https');
 var _fs = require('fs');
@@ -10,6 +13,14 @@ var _path = require('path');
 
 // src/bulk/types.ts
 var DGII_BULK_URL = "https://dgii.gov.do/app/WebApps/Consultas/RNC/DGII_RNC.zip";
+var DGII_ESTADOS = /* @__PURE__ */ Object.freeze([
+  "ACTIVO",
+  "SUSPENDIDO",
+  "DADO DE BAJA",
+  "CESE TEMPORAL",
+  "ANULADO",
+  "RECHAZADO"
+]);
 
 // src/bulk/downloader.ts
 async function downloadBulkFile(options) {
@@ -68,26 +79,65 @@ function handleResponse(response, destPath, resolve, reject) {
 // src/bulk/parser.ts
 
 var _readline = require('readline');
+var KNOWN_ESTADOS = new Set(DGII_ESTADOS);
+var EXPECTED_COLUMNS = 11;
+var COLUMN = {
+  rnc: 0,
+  nombre: 1,
+  nombreComercial: 2,
+  actividad: 3,
+  fechaConstitucion: 8,
+  estado: 9,
+  regimen: 10
+};
+var ESTADO_SAMPLE_SIZE = 1e3;
+var ESTADO_MIN_RECOGNIZED_RATIO = 0.5;
+var UTF8_BOM = "\uFEFF";
+var UTF8_BOM_AS_LATIN1 = "\xEF\xBB\xBF";
+function stripBom(line) {
+  if (line.startsWith(UTF8_BOM)) return line.slice(UTF8_BOM.length);
+  if (line.startsWith(UTF8_BOM_AS_LATIN1)) {
+    return line.slice(UTF8_BOM_AS_LATIN1.length);
+  }
+  return line;
+}
 async function parseBulkFile(options) {
   const results = [];
+  let dataLines = 0;
+  let firstLine = true;
   const rl = _readline.createInterface.call(void 0, {
-    input: _fs.createReadStream.call(void 0, options.filePath, { encoding: "utf-8" }),
+    input: _fs.createReadStream.call(void 0, options.filePath, {
+      encoding: _nullishCoalesce(options.encoding, () => ( "latin1"))
+    }),
     crlfDelay: Infinity
   });
-  for await (const line of rl) {
+  for await (const rawLine of rl) {
+    const line = firstLine ? stripBom(rawLine) : rawLine;
+    firstLine = false;
     if (line.trim() === "") continue;
+    dataLines += 1;
     const fields = line.split("|");
-    if (fields.length < 7) continue;
+    if (fields.length !== EXPECTED_COLUMNS) continue;
     results.push({
-      rnc: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, _nullishCoalesce(fields[0], () => ( ""))),
-      nombre: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, _nullishCoalesce(fields[1], () => ( ""))),
-      nombreComercial: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, _nullishCoalesce(fields[2], () => ( ""))),
-      actividad: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, _nullishCoalesce(fields[6], () => ( ""))),
-      estado: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, _nullishCoalesce(fields[5], () => ( ""))),
-      regimen: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, _nullishCoalesce(fields[4], () => ( ""))),
-      fechaConstitucion: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, _nullishCoalesce(fields[7], () => ( "")))
+      rnc: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, fields[COLUMN.rnc]),
+      nombre: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, fields[COLUMN.nombre]),
+      nombreComercial: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, fields[COLUMN.nombreComercial]),
+      actividad: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, fields[COLUMN.actividad]),
+      fechaConstitucion: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, fields[COLUMN.fechaConstitucion]),
+      estado: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, fields[COLUMN.estado]).toUpperCase(),
+      regimen: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, fields[COLUMN.regimen])
     });
   }
+  if (dataLines > 0) {
+    const sample = results.slice(0, ESTADO_SAMPLE_SIZE);
+    const reconocidos = sample.filter((r) => KNOWN_ESTADOS.has(r.estado));
+    const ratio = sample.length === 0 ? 0 : reconocidos.length / sample.length;
+    if (ratio < ESTADO_MIN_RECOGNIZED_RATIO) {
+      throw new (0, _chunkNASWEFHNcjs.BulkFormatError)(
+        `El archivo masivo de la DGII no coincide con el layout esperado de 11 columnas: la mayor\xEDa de las filas muestreadas no trae un \`estado\` reconocido (${DGII_ESTADOS.join(", ")}). \xBFCambi\xF3 el formato del archivo?`
+      );
+    }
+  }
   return results;
 }
 
@@ -95,4 +145,5 @@ async function parseBulkFile(options) {
 
 
 
-exports.DGII_BULK_URL = DGII_BULK_URL; exports.downloadBulkFile = downloadBulkFile; exports.parseBulkFile = parseBulkFile;
+
+exports.DGII_BULK_URL = DGII_BULK_URL; exports.DGII_ESTADOS = DGII_ESTADOS; exports.downloadBulkFile = downloadBulkFile; exports.parseBulkFile = parseBulkFile;

package/dist/{chunk-WY6V4Y7S.cjs → chunk-WMFHPNFP.cjs}

@@ -1,18 +1,18 @@
 "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');
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.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)(
+    return new (0, _chunkNASWEFHNcjs.DgiiConnectionError)(
       `Timeout de ${timeoutMs}ms excedido al conectar con la DGII`,
       { cause: error }
     );
   }
-  return new (0, _chunk7RJWFPCZcjs.DgiiConnectionError)(
+  return new (0, _chunkNASWEFHNcjs.DgiiConnectionError)(
     "Error de conexi\xF3n con el servicio de la DGII",
     { cause: error }
   );

package/dist/{chunk-KIS7MVIW.js → chunk-Z72T6CZG.js}

@@ -1,6 +1,9 @@
 import {
   collapseSpaces
 } from "./chunk-D26S6EXD.js";
+import {
+  BulkFormatError
+} from "./chunk-IRQX4WNQ.js";
 
 // src/bulk/downloader.ts
 import { get } from "https";
@@ -10,6 +13,14 @@ import { join } from "path";
 
 // src/bulk/types.ts
 var DGII_BULK_URL = "https://dgii.gov.do/app/WebApps/Consultas/RNC/DGII_RNC.zip";
+var DGII_ESTADOS = /* @__PURE__ */ Object.freeze([
+  "ACTIVO",
+  "SUSPENDIDO",
+  "DADO DE BAJA",
+  "CESE TEMPORAL",
+  "ANULADO",
+  "RECHAZADO"
+]);
 
 // src/bulk/downloader.ts
 async function downloadBulkFile(options) {
@@ -68,31 +79,71 @@ function handleResponse(response, destPath, resolve, reject) {
 // src/bulk/parser.ts
 import { createReadStream } from "fs";
 import { createInterface } from "readline";
+var KNOWN_ESTADOS = new Set(DGII_ESTADOS);
+var EXPECTED_COLUMNS = 11;
+var COLUMN = {
+  rnc: 0,
+  nombre: 1,
+  nombreComercial: 2,
+  actividad: 3,
+  fechaConstitucion: 8,
+  estado: 9,
+  regimen: 10
+};
+var ESTADO_SAMPLE_SIZE = 1e3;
+var ESTADO_MIN_RECOGNIZED_RATIO = 0.5;
+var UTF8_BOM = "\uFEFF";
+var UTF8_BOM_AS_LATIN1 = "\xEF\xBB\xBF";
+function stripBom(line) {
+  if (line.startsWith(UTF8_BOM)) return line.slice(UTF8_BOM.length);
+  if (line.startsWith(UTF8_BOM_AS_LATIN1)) {
+    return line.slice(UTF8_BOM_AS_LATIN1.length);
+  }
+  return line;
+}
 async function parseBulkFile(options) {
   const results = [];
+  let dataLines = 0;
+  let firstLine = true;
   const rl = createInterface({
-    input: createReadStream(options.filePath, { encoding: "utf-8" }),
+    input: createReadStream(options.filePath, {
+      encoding: options.encoding ?? "latin1"
+    }),
     crlfDelay: Infinity
   });
-  for await (const line of rl) {
+  for await (const rawLine of rl) {
+    const line = firstLine ? stripBom(rawLine) : rawLine;
+    firstLine = false;
     if (line.trim() === "") continue;
+    dataLines += 1;
     const fields = line.split("|");
-    if (fields.length < 7) continue;
+    if (fields.length !== EXPECTED_COLUMNS) continue;
     results.push({
-      rnc: collapseSpaces(fields[0] ?? ""),
-      nombre: collapseSpaces(fields[1] ?? ""),
-      nombreComercial: collapseSpaces(fields[2] ?? ""),
-      actividad: collapseSpaces(fields[6] ?? ""),
-      estado: collapseSpaces(fields[5] ?? ""),
-      regimen: collapseSpaces(fields[4] ?? ""),
-      fechaConstitucion: collapseSpaces(fields[7] ?? "")
+      rnc: collapseSpaces(fields[COLUMN.rnc]),
+      nombre: collapseSpaces(fields[COLUMN.nombre]),
+      nombreComercial: collapseSpaces(fields[COLUMN.nombreComercial]),
+      actividad: collapseSpaces(fields[COLUMN.actividad]),
+      fechaConstitucion: collapseSpaces(fields[COLUMN.fechaConstitucion]),
+      estado: collapseSpaces(fields[COLUMN.estado]).toUpperCase(),
+      regimen: collapseSpaces(fields[COLUMN.regimen])
     });
   }
+  if (dataLines > 0) {
+    const sample = results.slice(0, ESTADO_SAMPLE_SIZE);
+    const reconocidos = sample.filter((r) => KNOWN_ESTADOS.has(r.estado));
+    const ratio = sample.length === 0 ? 0 : reconocidos.length / sample.length;
+    if (ratio < ESTADO_MIN_RECOGNIZED_RATIO) {
+      throw new BulkFormatError(
+        `El archivo masivo de la DGII no coincide con el layout esperado de 11 columnas: la mayor\xEDa de las filas muestreadas no trae un \`estado\` reconocido (${DGII_ESTADOS.join(", ")}). \xBFCambi\xF3 el formato del archivo?`
+      );
+    }
+  }
   return results;
 }
 
 export {
   DGII_BULK_URL,
+  DGII_ESTADOS,
   downloadBulkFile,
   parseBulkFile
 };

package/dist/client.cjs

@@ -3,15 +3,16 @@
 
 
 
-var _chunk5FZ4F5URcjs = require('./chunk-5FZ4F5UR.cjs');
-require('./chunk-JBKAE66C.cjs');
-require('./chunk-BQPH3JDZ.cjs');
-require('./chunk-WY6V4Y7S.cjs');
+var _chunk6ZRPVQPPcjs = require('./chunk-6ZRPVQPP.cjs');
+require('./chunk-DLB5RJ7E.cjs');
+require('./chunk-FRM5XREF.cjs');
+require('./chunk-OSGHCQFA.cjs');
+require('./chunk-WMFHPNFP.cjs');
 require('./chunk-QH4BK5X3.cjs');
-require('./chunk-7RJWFPCZ.cjs');
+require('./chunk-NASWEFHN.cjs');
 
 
 
 
 
-exports.ConsecutiveBreaker = _chunk5FZ4F5URcjs.ConsecutiveBreaker; exports.DgiiClient = _chunk5FZ4F5URcjs.DgiiClient; exports.isRetryableError = _chunk5FZ4F5URcjs.isRetryableError; exports.withRetry = _chunk5FZ4F5URcjs.withRetry;
+exports.ConsecutiveBreaker = _chunk6ZRPVQPPcjs.ConsecutiveBreaker; exports.DgiiClient = _chunk6ZRPVQPPcjs.DgiiClient; exports.isRetryableError = _chunk6ZRPVQPPcjs.isRetryableError; exports.withRetry = _chunk6ZRPVQPPcjs.withRetry;

package/dist/client.d.cts

@@ -1,4 +1,4 @@
-import { C as Contribuyente, N as NcfQueryResult } from './index-BE6Wfozd.cjs';
+import { C as Contribuyente, N as NcfQueryOptions, a as NcfQueryResult } from './index-BPvMDXya.cjs';
 
 interface RetryOptions {
     /** Número máximo de reintentos (por defecto: 2) */
@@ -86,9 +86,14 @@ declare class DgiiClient {
      */
     getContribuyente(rnc: string): Promise<Contribuyente>;
     /**
-     * Valida un comprobante fiscal (NCF) contra la DGII.
+     * Valida un comprobante fiscal contra la DGII.
+     *
+     * @param rnc - RNC del emisor
+     * @param ncf - NCF o e-NCF a validar
+     * @param options - Datos adicionales del e-NCF (`rncComprador`,
+     *   `codigoSeguridad`). Se ignoran cuando `ncf` no es un e-NCF válido.
      */
-    getNCF(rnc: string, ncf: string): Promise<NcfQueryResult>;
+    getNCF(rnc: string, ncf: string, options?: NcfQueryOptions): Promise<NcfQueryResult>;
     private _executeWithFallback;
 }
 

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { C as Contribuyente, N as NcfQueryResult } from './index-BE6Wfozd.js';
+import { C as Contribuyente, N as NcfQueryOptions, a as NcfQueryResult } from './index-BPvMDXya.js';
 
 interface RetryOptions {
     /** Número máximo de reintentos (por defecto: 2) */
@@ -86,9 +86,14 @@ declare class DgiiClient {
      */
     getContribuyente(rnc: string): Promise<Contribuyente>;
     /**
-     * Valida un comprobante fiscal (NCF) contra la DGII.
+     * Valida un comprobante fiscal contra la DGII.
+     *
+     * @param rnc - RNC del emisor
+     * @param ncf - NCF o e-NCF a validar
+     * @param options - Datos adicionales del e-NCF (`rncComprador`,
+     *   `codigoSeguridad`). Se ignoran cuando `ncf` no es un e-NCF válido.
      */
-    getNCF(rnc: string, ncf: string): Promise<NcfQueryResult>;
+    getNCF(rnc: string, ncf: string, options?: NcfQueryOptions): Promise<NcfQueryResult>;
     private _executeWithFallback;
 }
 

package/dist/client.js

@@ -3,12 +3,13 @@ import {
   DgiiClient,
   isRetryableError,
   withRetry
-} from "./chunk-ROJUYPIK.js";
-import "./chunk-43LGK4YP.js";
-import "./chunk-HRRYZUKI.js";
-import "./chunk-53A7IG4Y.js";
+} from "./chunk-JV4HWHYP.js";
+import "./chunk-QTN5ZT4P.js";
+import "./chunk-7ILLRYE4.js";
+import "./chunk-H42U4GI5.js";
+import "./chunk-KW4ZV6FJ.js";
 import "./chunk-D26S6EXD.js";
-import "./chunk-DMGDJEUY.js";
+import "./chunk-IRQX4WNQ.js";
 export {
   ConsecutiveBreaker,
   DgiiClient,

package/dist/errors.cjs

@@ -4,11 +4,13 @@
 
 
 
-var _chunk7RJWFPCZcjs = require('./chunk-7RJWFPCZ.cjs');
 
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
 
 
 
 
 
-exports.AllStrategiesFailedError = _chunk7RJWFPCZcjs.AllStrategiesFailedError; exports.DgiiConnectionError = _chunk7RJWFPCZcjs.DgiiConnectionError; exports.DgiiError = _chunk7RJWFPCZcjs.DgiiError; exports.DgiiNotFoundError = _chunk7RJWFPCZcjs.DgiiNotFoundError; exports.DgiiServiceError = _chunk7RJWFPCZcjs.DgiiServiceError;
+
+
+exports.AllStrategiesFailedError = _chunkNASWEFHNcjs.AllStrategiesFailedError; exports.BulkFormatError = _chunkNASWEFHNcjs.BulkFormatError; exports.DgiiConnectionError = _chunkNASWEFHNcjs.DgiiConnectionError; exports.DgiiError = _chunkNASWEFHNcjs.DgiiError; exports.DgiiNotFoundError = _chunkNASWEFHNcjs.DgiiNotFoundError; exports.DgiiServiceError = _chunkNASWEFHNcjs.DgiiServiceError;

package/dist/errors.d.cts

@@ -36,5 +36,14 @@ declare class AllStrategiesFailedError extends DgiiError {
     readonly errors: ReadonlyArray<Error>;
     constructor(message: string, errors: ReadonlyArray<Error>);
 }
+/**
+ * El archivo masivo (DGII_RNC.zip) no coincide con el layout esperado:
+ * cambió el número de columnas o la columna `estado` dejó de traer
+ * valores reconocidos. Se lanza para que un cambio de formato de la DGII
+ * falle de forma ruidosa en vez de devolver `estado` vacío en silencio.
+ */
+declare class BulkFormatError extends DgiiError {
+    constructor(message: string);
+}
 
-export { AllStrategiesFailedError, DgiiConnectionError, DgiiError, DgiiNotFoundError, DgiiServiceError };
+export { AllStrategiesFailedError, BulkFormatError, DgiiConnectionError, DgiiError, DgiiNotFoundError, DgiiServiceError };

package/dist/errors.d.ts

@@ -36,5 +36,14 @@ declare class AllStrategiesFailedError extends DgiiError {
     readonly errors: ReadonlyArray<Error>;
     constructor(message: string, errors: ReadonlyArray<Error>);
 }
+/**
+ * El archivo masivo (DGII_RNC.zip) no coincide con el layout esperado:
+ * cambió el número de columnas o la columna `estado` dejó de traer
+ * valores reconocidos. Se lanza para que un cambio de formato de la DGII
+ * falle de forma ruidosa en vez de devolver `estado` vacío en silencio.
+ */
+declare class BulkFormatError extends DgiiError {
+    constructor(message: string);
+}
 
-export { AllStrategiesFailedError, DgiiConnectionError, DgiiError, DgiiNotFoundError, DgiiServiceError };
+export { AllStrategiesFailedError, BulkFormatError, DgiiConnectionError, DgiiError, DgiiNotFoundError, DgiiServiceError };

package/dist/errors.js

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

package/dist/index-BPvMDXya.d.cts

@@ -0,0 +1,101 @@
+/**
+ * Resultado de validación para RNC y cédula.
+ */
+type ValidationResult = {
+    valid: true;
+    formatted: string;
+} | {
+    valid: false;
+    formatted?: undefined;
+};
+/**
+ * Resultado de validación para NCF (serie B) y e-NCF (serie E).
+ */
+type NcfValidationResult = {
+    valid: true;
+    type: string;
+    serie: string;
+} | {
+    valid: false;
+    type?: undefined;
+    serie?: undefined;
+};
+/**
+ * Datos de un contribuyente registrado en la DGII.
+ *
+ * `esFacturadorElectronico` indica si la DGII certificó al RNC como
+ * emisor de e-CF. Hoy solo el parser de scraping deriva el valor real;
+ * el parser SOAP retorna `false` hasta que la DGII restaure el endpoint.
+ */
+interface Contribuyente {
+    rnc: string;
+    nombre: string;
+    nombreComercial: string;
+    estado: string;
+    categoria: string;
+    esFacturadorElectronico: boolean;
+    actividadEconomica?: string;
+    regimenDePagos?: string;
+    administracionLocal?: string;
+}
+/**
+ * Datos adicionales para consultar un e-NCF (serie E) en la DGII.
+ *
+ * La DGII exige el RNC del comprador (o el ID extranjero) para
+ * responder el estado de un e-NCF. Se ignoran al consultar un NCF
+ * de serie B.
+ */
+interface NcfQueryOptions {
+    /** RNC del comprador tal como aparece en la factura. */
+    rncComprador?: string;
+    /** Código de seguridad de 6 caracteres impreso en la factura. */
+    codigoSeguridad?: string;
+}
+/**
+ * Resultado de validación de un comprobante fiscal contra la DGII.
+ *
+ * `valid` significa que la DGII encontró el comprobante, no que esté
+ * aceptado: para un e-NCF hay que revisar `estado` (por ejemplo
+ * `Aceptado`).
+ *
+ * Los campos de la sección e-NCF (`rncComprador`, `codigoSeguridad`,
+ * `estado`, `montoTotal`, `totalItbis`, `fechaEmision`, `fechaFirma`)
+ * solo se llenan cuando el comprobante es un e-NCF (serie E).
+ * `nombreComercial` no se llena para la serie E porque la DGII no lo
+ * muestra en esa consulta. `fechaEmision` y `fechaFirma` son strings
+ * exactamente como la DGII los renderiza.
+ */
+interface NcfQueryResult {
+    valid: boolean;
+    rnc: string;
+    ncf: string;
+    nombreComercial?: string;
+    rncComprador?: string;
+    codigoSeguridad?: string;
+    estado?: string;
+    montoTotal?: number;
+    totalItbis?: number;
+    fechaEmision?: string;
+    fechaFirma?: string;
+}
+/**
+ * Registro del archivo masivo de contribuyentes (DGII_RNC.zip).
+ */
+interface BulkContribuyente {
+    rnc: string;
+    nombre: string;
+    nombreComercial: string;
+    actividad: string;
+    /**
+     * Estado tal como lo trae el archivo masivo, normalizado a mayúsculas:
+     * uno de los valores de `DGII_ESTADOS` (ACTIVO, SUSPENDIDO, DADO DE
+     * BAJA, ...). Es un vocabulario más amplio que el `estado` binario
+     * (ACTIVO/INACTIVO) de {@link Contribuyente}, así que no son
+     * intercambiables al comparar entre fuentes.
+     */
+    estado: string;
+    regimen: string;
+    fechaConstitucion: string;
+}
+
+export type { BulkContribuyente as B, Contribuyente as C, NcfQueryOptions as N, ValidationResult as V, NcfQueryResult as a, NcfValidationResult as b };

package/dist/index-BPvMDXya.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Resultado de validación para RNC y cédula.
+ */
+type ValidationResult = {
+    valid: true;
+    formatted: string;
+} | {
+    valid: false;
+    formatted?: undefined;
+};
+/**
+ * Resultado de validación para NCF (serie B) y e-NCF (serie E).
+ */
+type NcfValidationResult = {
+    valid: true;
+    type: string;
+    serie: string;
+} | {
+    valid: false;
+    type?: undefined;
+    serie?: undefined;
+};
+/**
+ * Datos de un contribuyente registrado en la DGII.
+ *
+ * `esFacturadorElectronico` indica si la DGII certificó al RNC como
+ * emisor de e-CF. Hoy solo el parser de scraping deriva el valor real;
+ * el parser SOAP retorna `false` hasta que la DGII restaure el endpoint.
+ */
+interface Contribuyente {
+    rnc: string;
+    nombre: string;
+    nombreComercial: string;
+    estado: string;
+    categoria: string;
+    esFacturadorElectronico: boolean;
+    actividadEconomica?: string;
+    regimenDePagos?: string;
+    administracionLocal?: string;
+}
+/**
+ * Datos adicionales para consultar un e-NCF (serie E) en la DGII.
+ *
+ * La DGII exige el RNC del comprador (o el ID extranjero) para
+ * responder el estado de un e-NCF. Se ignoran al consultar un NCF
+ * de serie B.
+ */
+interface NcfQueryOptions {
+    /** RNC del comprador tal como aparece en la factura. */
+    rncComprador?: string;
+    /** Código de seguridad de 6 caracteres impreso en la factura. */
+    codigoSeguridad?: string;
+}
+/**
+ * Resultado de validación de un comprobante fiscal contra la DGII.
+ *
+ * `valid` significa que la DGII encontró el comprobante, no que esté
+ * aceptado: para un e-NCF hay que revisar `estado` (por ejemplo
+ * `Aceptado`).
+ *
+ * Los campos de la sección e-NCF (`rncComprador`, `codigoSeguridad`,
+ * `estado`, `montoTotal`, `totalItbis`, `fechaEmision`, `fechaFirma`)
+ * solo se llenan cuando el comprobante es un e-NCF (serie E).
+ * `nombreComercial` no se llena para la serie E porque la DGII no lo
+ * muestra en esa consulta. `fechaEmision` y `fechaFirma` son strings
+ * exactamente como la DGII los renderiza.
+ */
+interface NcfQueryResult {
+    valid: boolean;
+    rnc: string;
+    ncf: string;
+    nombreComercial?: string;
+    rncComprador?: string;
+    codigoSeguridad?: string;
+    estado?: string;
+    montoTotal?: number;
+    totalItbis?: number;
+    fechaEmision?: string;
+    fechaFirma?: string;
+}
+/**
+ * Registro del archivo masivo de contribuyentes (DGII_RNC.zip).
+ */
+interface BulkContribuyente {
+    rnc: string;
+    nombre: string;
+    nombreComercial: string;
+    actividad: string;
+    /**
+     * Estado tal como lo trae el archivo masivo, normalizado a mayúsculas:
+     * uno de los valores de `DGII_ESTADOS` (ACTIVO, SUSPENDIDO, DADO DE
+     * BAJA, ...). Es un vocabulario más amplio que el `estado` binario
+     * (ACTIVO/INACTIVO) de {@link Contribuyente}, así que no son
+     * intercambiables al comparar entre fuentes.
+     */
+    estado: string;
+    regimen: string;
+    fechaConstitucion: string;
+}
+
+export type { BulkContribuyente as B, Contribuyente as C, NcfQueryOptions as N, ValidationResult as V, NcfQueryResult as a, NcfValidationResult as b };