extraer-datos-ine 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Extraer Datos de INE
+
+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,160 @@
+# extraer-datos-ine
+
+SDK oficial en JavaScript / TypeScript para la **[API de OCR para INE de Extraer Datos de INE](https://extraerdatosdeine.com)** — extrae CURP, nombre, clave de elector, dirección y todos los campos de una **credencial para votar mexicana (INE/IFE)** a partir de una imagen, en segundos.
+
+- 🇲🇽 Diseñado para credenciales **INE e IFE** (todos los modelos).
+- 🧩 **Cero dependencias.** Usa el `fetch`/`FormData` nativos de Node 18+ (y navegadores).
+- 🔠 **TypeScript de primera clase**: tipos para los 20 campos y para cada código de error.
+- 📦 Doble build **ESM + CommonJS**.
+
+📚 Documentación de la API: **https://extraerdatosdeine.com/docs**
+🔑 Consigue una API key con **20 extracciones gratis**: **https://extraerdatosdeine.com/register**
+
+---
+
+## Instalación
+
+```bash
+npm install extraer-datos-ine
+```
+
+Requiere **Node.js 18 o superior** (por `fetch`, `FormData` y `Blob` globales).
+
+## Uso rápido
+
+```ts
+import { readFile } from 'node:fs/promises'
+import { IneExtractorClient } from 'extraer-datos-ine'
+
+const client = new IneExtractorClient({ apiKey: process.env.INE_API_KEY! })
+
+const front = await readFile('./ine_frente.jpg')
+const back = await readFile('./ine_reverso.jpg') // opcional, para CIC/OCR del reverso
+
+const { data, tokensRemaining } = await client.extract({ front, back })
+
+console.log(data.curp)          // 'PEGJ850101HDFRRL09'
+console.log(data.claveElector)  // 'PRGRJN85010109H100'
+console.log(tokensRemaining)    // 19
+```
+
+### Consultar saldo de tokens
+
+```ts
+const balance = await client.getBalance()
+console.log(`Tokens disponibles: ${balance}`)
+```
+
+## Formas de enviar la imagen
+
+El SDK elige el método de envío automáticamente según el tipo de `front`/`back`.
+
+| Tipo de entrada | Ejemplo | Método HTTP usado |
+|---|---|---|
+| Binario | `Buffer` / `Uint8Array` / `Blob` | `multipart/form-data` |
+| Base64 | `{ base64: '...' }` o `'data:image/jpeg;base64,...'` | JSON base64 |
+| URL | `{ url: 'https://...' }` | JSON URL (la API descarga la imagen) |
+
+```ts
+// Binario (recomendado en backend)
+await client.extract({ front: buffer, frontMimeType: 'image/png' })
+
+// Base64
+await client.extract({ front: { base64 }, back: { base64: back64 } })
+
+// URL HTTPS
+await client.extract({ front: { url }, back: { url: backUrl } })
+```
+
+> `front` y `back` deben ser del **mismo tipo**: la API no mezcla métodos en una sola petición.
+
+## Manejo de errores
+
+Toda respuesta no exitosa lanza un `IneExtractorError` con un `code` legible por máquina.
+
+```ts
+import { IneExtractorError } from 'extraer-datos-ine'
+
+try {
+  const { data } = await client.extract({ front })
+} catch (err) {
+  if (err instanceof IneExtractorError) {
+    switch (err.code) {
+      case 'INSUFFICIENT_TOKENS':
+        console.error('Sin tokens. Recarga en:', err.enrollUrl)
+        break
+      case 'LOW_IMAGE_QUALITY':
+        console.error('Imagen ilegible. Campos faltantes:', err.missingFields)
+        break
+      case 'IMAGE_TOO_LARGE':
+        console.error('La imagen excede 10 MB.')
+        break
+      default:
+        console.error(`[${err.code}] ${err.message}`)
+    }
+  } else {
+    throw err
+  }
+}
+```
+
+### Códigos de error
+
+| `code` | HTTP | Significado |
+|---|---|---|
+| `MISSING_API_KEY` | 401 | No se envió la API key |
+| `INVALID_API_KEY` | 401 | API key inválida o revocada |
+| `MISSING_IMAGE` | 400 | Falta la imagen frontal |
+| `INVALID_IMAGE_FORMAT` | 400 | Formato no soportado (usa JPEG, PNG o WebP) |
+| `IMAGE_TOO_LARGE` | 400 | La imagen excede 10 MB |
+| `INVALID_BASE64` | 400 | Error al decodificar base64 |
+| `INVALID_MULTIPART` | 400 | Error al procesar el formulario multipart |
+| `URL_FETCH_FAILED` | 400 | No se pudo descargar la imagen de la URL |
+| `URL_INVALID` | 400 | URL inválida (debe ser HTTPS) |
+| `URL_BLOCKED` | 400 | URL bloqueada por seguridad |
+| `URL_TIMEOUT` | 400 | Timeout al descargar la imagen (10 s) |
+| `UNSUPPORTED_CONTENT_TYPE` | 415 | Content-Type no soportado |
+| `INSUFFICIENT_TOKENS` | 402 | Saldo insuficiente (ver `err.enrollUrl`) |
+| `LOW_IMAGE_QUALITY` | 422 | Imagen ilegible (ver `err.missingFields`) |
+| `EXTRACTION_FAILED` | 500 | Falló la extracción (el token se reembolsa) |
+| `PROCESSING_ERROR` | 500 | Error procesando la imagen (token reembolsado) |
+| `INTERNAL_ERROR` | 500 | Error interno del servidor |
+| `NETWORK_ERROR` | — | Fallo de red (lado del cliente) |
+| `TIMEOUT` | — | Se superó el `timeoutMs` del cliente |
+
+## Campos extraídos (`IneData`)
+
+`nombre`, `apellidoPaterno`, `apellidoMaterno`, `domicilio`, `calle`, `colonia`, `codigoPostal`, `municipio`, `estado`, `seccion`, `curp`, `claveElector`, `anioRegistro`, `fechaNacimiento`, `sexo`, `vigencia`, `numeroVertical`, `ocr`, `cic`, `emision`.
+
+Los cuatro últimos (`numeroVertical`, `ocr`, `cic`, `emision`) viven en el **reverso**: envía también `back` para obtenerlos. ¿Dudas sobre CIC vs OCR vs clave de elector? Lee la [guía](https://extraerdatosdeine.com/blog/cic-ocr-clave-elector-ine).
+
+## Configuración del cliente
+
+```ts
+new IneExtractorClient({
+  apiKey: 'ine_...',              // requerido
+  baseUrl: 'https://extraerdatosdeine.com/api/v1', // default
+  timeoutMs: 60_000,             // default
+  fetch: customFetch,            // opcional (tests / polyfills)
+})
+```
+
+## Desarrollo
+
+```bash
+npm install
+npm run build      # compila ESM + CJS + .d.ts con tsup
+npm test           # build + node --test
+npm run typecheck
+```
+
+## Enlaces
+
+- 🌐 Sitio: https://extraerdatosdeine.com
+- 📚 Documentación de la API: https://extraerdatosdeine.com/docs
+- 🔑 Crear cuenta (20 extracciones gratis): https://extraerdatosdeine.com/register
+- 📝 Blog: https://extraerdatosdeine.com/blog
+
+## Licencia
+
+[MIT](./LICENSE) © Extraer Datos de INE

package/dist/index.cjs

@@ -0,0 +1,221 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  IneExtractorClient: () => IneExtractorClient,
+  IneExtractorError: () => IneExtractorError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var IneExtractorError = class _IneExtractorError extends Error {
+  /** Código de error legible por máquina. */
+  code;
+  /** Status HTTP de la respuesta (ausente en errores de red). */
+  status;
+  /** ID de la extracción, cuando aplica (LOW_IMAGE_QUALITY / EXTRACTION_FAILED). */
+  extractionId;
+  /** Campos que no se pudieron leer (LOW_IMAGE_QUALITY). */
+  missingFields;
+  /** URL para configurar auto-recarga (algunos INSUFFICIENT_TOKENS). */
+  enrollUrl;
+  /** Motivo de bloqueo (algunos INSUFFICIENT_TOKENS). */
+  blockReason;
+  /** Cuerpo crudo de la respuesta de error, por si necesitas más detalle. */
+  response;
+  constructor(message, code, init = {}) {
+    super(message, init.cause !== void 0 ? { cause: init.cause } : void 0);
+    this.name = "IneExtractorError";
+    this.code = code;
+    this.status = init.status;
+    this.extractionId = init.extractionId;
+    this.missingFields = init.missingFields;
+    this.enrollUrl = init.enrollUrl;
+    this.blockReason = init.blockReason;
+    this.response = init.response;
+    Object.setPrototypeOf(this, _IneExtractorError.prototype);
+  }
+  /** Construye el error a partir de una respuesta de la API. */
+  static fromResponse(status, body) {
+    const b = body ?? {};
+    const code = typeof b.code === "string" ? b.code : "INTERNAL_ERROR";
+    const message = typeof b.error === "string" && b.error || `La API respondi\xF3 con status ${status}`;
+    return new _IneExtractorError(message, code, {
+      status,
+      extractionId: typeof b.extraction_id === "string" ? b.extraction_id : void 0,
+      missingFields: Array.isArray(b.missing_fields) ? b.missing_fields : void 0,
+      enrollUrl: typeof b.enroll_url === "string" ? b.enroll_url : void 0,
+      blockReason: typeof b.block_reason === "string" ? b.block_reason : void 0,
+      response: body
+    });
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://extraerdatosdeine.com/api/v1";
+var DEFAULT_TIMEOUT_MS = 6e4;
+var IneExtractorClient = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  fetchImpl;
+  constructor(options) {
+    if (!options || !options.apiKey) {
+      throw new IneExtractorError("Falta `apiKey` en las opciones del cliente.", "INVALID_INPUT");
+    }
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+      throw new IneExtractorError(
+        "No hay `fetch` disponible. Usa Node 18+ o pasa `fetch` en las opciones.",
+        "INVALID_INPUT"
+      );
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.fetchImpl = fetchImpl;
+  }
+  /**
+   * Consulta el saldo de tokens de tu cuenta.
+   * @returns número de tokens disponibles.
+   */
+  async getBalance() {
+    const body = await this.request("/balance", { method: "GET" });
+    return Number(body.balance);
+  }
+  /**
+   * Extrae los datos de una credencial INE/IFE.
+   *
+   * El método de envío se elige automáticamente según el tipo de `front`:
+   * binario → multipart; `{ base64 }` o string → JSON base64; `{ url }` → JSON URL.
+   * `front` y `back` deben ser del mismo tipo (la API no mezcla métodos).
+   *
+   * @throws {IneExtractorError} ante saldo insuficiente, imagen ilegible,
+   *   formato inválido, error de red, timeout, etc. Revisa `error.code`.
+   */
+  async extract(input) {
+    if (!input || input.front === void 0 || input.front === null) {
+      throw new IneExtractorError("Falta la imagen frontal (`front`).", "MISSING_IMAGE");
+    }
+    const frontKind = kindOf(input.front);
+    if (input.back !== void 0 && kindOf(input.back) !== frontKind) {
+      throw new IneExtractorError(
+        "`front` y `back` deben ser del mismo tipo (ambos binarios, base64 o url).",
+        "INVALID_INPUT"
+      );
+    }
+    let init;
+    if (frontKind === "url") {
+      const payload = {
+        image_front_url: input.front.url
+      };
+      if (input.back) payload.image_back_url = input.back.url;
+      init = jsonRequest(payload);
+    } else if (frontKind === "base64") {
+      const payload = { image_front: asBase64(input.front) };
+      if (input.back) payload.image_back = asBase64(input.back);
+      init = jsonRequest(payload);
+    } else {
+      const form = new FormData();
+      form.append("image_front", toBlob(input.front, input.frontMimeType));
+      if (input.back) {
+        form.append("image_back", toBlob(input.back, input.backMimeType));
+      }
+      init = { method: "POST", body: form };
+    }
+    const body = await this.request("/extract", init);
+    return {
+      extractionId: body.extraction_id,
+      data: body.data,
+      tokensRemaining: body.tokens_remaining,
+      uploadMethod: body.upload_method
+    };
+  }
+  async request(path, init) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    let res;
+    try {
+      res = await this.fetchImpl(this.baseUrl + path, {
+        ...init,
+        signal: controller.signal,
+        headers: { "X-API-Key": this.apiKey, ...init.headers ?? {} }
+      });
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new IneExtractorError(
+          `La petici\xF3n excedi\xF3 el timeout de ${this.timeoutMs} ms.`,
+          "TIMEOUT",
+          { cause: err }
+        );
+      }
+      throw new IneExtractorError(
+        err instanceof Error ? err.message : "Error de red",
+        "NETWORK_ERROR",
+        { cause: err }
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok || body?.success === false) {
+      throw IneExtractorError.fromResponse(res.status, body);
+    }
+    return body;
+  }
+};
+function kindOf(src) {
+  if (typeof src === "string") return "base64";
+  if (src instanceof Uint8Array || src instanceof ArrayBuffer) return "binary";
+  if (src instanceof Blob) return "binary";
+  if (typeof src === "object" && src !== null) {
+    if ("url" in src) return "url";
+    if ("base64" in src) return "base64";
+  }
+  throw new IneExtractorError(
+    "Fuente de imagen no soportada. Usa Uint8Array, ArrayBuffer, Blob, { base64 } o { url }.",
+    "INVALID_INPUT"
+  );
+}
+function asBase64(src) {
+  if (typeof src === "string") return src;
+  if (typeof src === "object" && src !== null && "base64" in src) return src.base64;
+  throw new IneExtractorError("Se esperaba una cadena base64.", "INVALID_INPUT");
+}
+function toBlob(src, mimeType = "image/jpeg") {
+  if (src instanceof Blob) return src;
+  if (src instanceof ArrayBuffer) return new Blob([src], { type: mimeType });
+  const bytes = src.buffer.slice(src.byteOffset, src.byteOffset + src.byteLength);
+  return new Blob([bytes], { type: mimeType });
+}
+function jsonRequest(payload) {
+  return {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload)
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IneExtractorClient,
+  IneExtractorError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * SDK oficial de Extraer Datos de INE.\n * API de OCR para credenciales INE/IFE mexicanas.\n *\n * @see https://extraerdatosdeine.com/docs\n * @packageDocumentation\n */\nexport { IneExtractorClient } from './client.js'\nexport { IneExtractorError } from './errors.js'\nexport type { IneErrorCode } from './errors.js'\nexport type {\n  IneData,\n  ExtractResult,\n  ExtractInput,\n  ImageSource,\n  BinaryImage,\n  IneExtractorOptions,\n} from './types.js'\n","/**\n * Códigos de error que devuelve la API de Extraer Datos de INE, más algunos\n * códigos propios del SDK (`NETWORK_ERROR`, `TIMEOUT`).\n *\n * @see https://extraerdatosdeine.com/docs\n */\nexport type IneErrorCode =\n  // 401\n  | 'MISSING_API_KEY'\n  | 'INVALID_API_KEY'\n  // 400\n  | 'MISSING_IMAGE'\n  | 'INVALID_IMAGE_FORMAT'\n  | 'IMAGE_TOO_LARGE'\n  | 'INVALID_BASE64'\n  | 'INVALID_MULTIPART'\n  | 'URL_FETCH_FAILED'\n  | 'URL_INVALID'\n  | 'URL_BLOCKED'\n  | 'URL_TIMEOUT'\n  // 415\n  | 'UNSUPPORTED_CONTENT_TYPE'\n  // 402\n  | 'INSUFFICIENT_TOKENS'\n  // 422\n  | 'LOW_IMAGE_QUALITY'\n  // 500\n  | 'EXTRACTION_FAILED'\n  | 'PROCESSING_ERROR'\n  | 'INTERNAL_ERROR'\n  // SDK-only\n  | 'NETWORK_ERROR'\n  | 'TIMEOUT'\n  | 'INVALID_INPUT'\n  // forward-compatible: unknown server codes\n  | (string & {})\n\n/**\n * Error lanzado por el SDK ante cualquier respuesta no exitosa de la API\n * o un fallo de red/timeout. Inspecciona `code` para reaccionar de forma\n * programática.\n *\n * @example\n * try {\n *   await client.extract({ front })\n * } catch (err) {\n *   if (err instanceof IneExtractorError && err.code === 'INSUFFICIENT_TOKENS') {\n *     console.log('Recarga tokens en', err.enrollUrl)\n *   }\n * }\n */\nexport class IneExtractorError extends Error {\n  /** Código de error legible por máquina. */\n  readonly code: IneErrorCode\n  /** Status HTTP de la respuesta (ausente en errores de red). */\n  readonly status?: number\n  /** ID de la extracción, cuando aplica (LOW_IMAGE_QUALITY / EXTRACTION_FAILED). */\n  readonly extractionId?: string\n  /** Campos que no se pudieron leer (LOW_IMAGE_QUALITY). */\n  readonly missingFields?: string[]\n  /** URL para configurar auto-recarga (algunos INSUFFICIENT_TOKENS). */\n  readonly enrollUrl?: string\n  /** Motivo de bloqueo (algunos INSUFFICIENT_TOKENS). */\n  readonly blockReason?: string\n  /** Cuerpo crudo de la respuesta de error, por si necesitas más detalle. */\n  readonly response?: unknown\n\n  constructor(\n    message: string,\n    code: IneErrorCode,\n    init: {\n      status?: number\n      extractionId?: string\n      missingFields?: string[]\n      enrollUrl?: string\n      blockReason?: string\n      response?: unknown\n      cause?: unknown\n    } = {}\n  ) {\n    super(message, init.cause !== undefined ? { cause: init.cause } : undefined)\n    this.name = 'IneExtractorError'\n    this.code = code\n    this.status = init.status\n    this.extractionId = init.extractionId\n    this.missingFields = init.missingFields\n    this.enrollUrl = init.enrollUrl\n    this.blockReason = init.blockReason\n    this.response = init.response\n    // Restore prototype chain for instanceof across transpile targets.\n    Object.setPrototypeOf(this, IneExtractorError.prototype)\n  }\n\n  /** Construye el error a partir de una respuesta de la API. */\n  static fromResponse(status: number, body: unknown): IneExtractorError {\n    const b = (body ?? {}) as Record<string, unknown>\n    const code = (typeof b.code === 'string' ? b.code : 'INTERNAL_ERROR') as IneErrorCode\n    const message =\n      (typeof b.error === 'string' && b.error) ||\n      `La API respondió con status ${status}`\n    return new IneExtractorError(message, code, {\n      status,\n      extractionId: typeof b.extraction_id === 'string' ? b.extraction_id : undefined,\n      missingFields: Array.isArray(b.missing_fields)\n        ? (b.missing_fields as string[])\n        : undefined,\n      enrollUrl: typeof b.enroll_url === 'string' ? b.enroll_url : undefined,\n      blockReason: typeof b.block_reason === 'string' ? b.block_reason : undefined,\n      response: body,\n    })\n  }\n}\n","import { IneExtractorError } from './errors.js'\nimport type {\n  BinaryImage,\n  ExtractInput,\n  ExtractResult,\n  ImageSource,\n  IneExtractorOptions,\n} from './types.js'\n\nconst DEFAULT_BASE_URL = 'https://extraerdatosdeine.com/api/v1'\nconst DEFAULT_TIMEOUT_MS = 60_000\n\n/**\n * Cliente para la API de Extraer Datos de INE.\n *\n * @example\n * import { readFile } from 'node:fs/promises'\n * import { IneExtractorClient } from 'extraer-datos-ine'\n *\n * const client = new IneExtractorClient({ apiKey: process.env.INE_API_KEY! })\n * const front = await readFile('./ine_frente.jpg')\n * const back = await readFile('./ine_reverso.jpg')\n * const { data } = await client.extract({ front, back })\n * console.log(data.curp, data.claveElector)\n *\n * @see https://extraerdatosdeine.com/docs\n */\nexport class IneExtractorClient {\n  private readonly apiKey: string\n  private readonly baseUrl: string\n  private readonly timeoutMs: number\n  private readonly fetchImpl: typeof fetch\n\n  constructor(options: IneExtractorOptions) {\n    if (!options || !options.apiKey) {\n      throw new IneExtractorError('Falta `apiKey` en las opciones del cliente.', 'INVALID_INPUT')\n    }\n    const fetchImpl = options.fetch ?? globalThis.fetch\n    if (typeof fetchImpl !== 'function') {\n      throw new IneExtractorError(\n        'No hay `fetch` disponible. Usa Node 18+ o pasa `fetch` en las opciones.',\n        'INVALID_INPUT'\n      )\n    }\n    this.apiKey = options.apiKey\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '')\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.fetchImpl = fetchImpl\n  }\n\n  /**\n   * Consulta el saldo de tokens de tu cuenta.\n   * @returns número de tokens disponibles.\n   */\n  async getBalance(): Promise<number> {\n    const body = await this.request('/balance', { method: 'GET' })\n    return Number((body as { balance: number }).balance)\n  }\n\n  /**\n   * Extrae los datos de una credencial INE/IFE.\n   *\n   * El método de envío se elige automáticamente según el tipo de `front`:\n   * binario → multipart; `{ base64 }` o string → JSON base64; `{ url }` → JSON URL.\n   * `front` y `back` deben ser del mismo tipo (la API no mezcla métodos).\n   *\n   * @throws {IneExtractorError} ante saldo insuficiente, imagen ilegible,\n   *   formato inválido, error de red, timeout, etc. Revisa `error.code`.\n   */\n  async extract(input: ExtractInput): Promise<ExtractResult> {\n    if (!input || input.front === undefined || input.front === null) {\n      throw new IneExtractorError('Falta la imagen frontal (`front`).', 'MISSING_IMAGE')\n    }\n\n    const frontKind = kindOf(input.front)\n    if (input.back !== undefined && kindOf(input.back) !== frontKind) {\n      throw new IneExtractorError(\n        '`front` y `back` deben ser del mismo tipo (ambos binarios, base64 o url).',\n        'INVALID_INPUT'\n      )\n    }\n\n    let init: RequestInit\n    if (frontKind === 'url') {\n      const payload: Record<string, string> = {\n        image_front_url: (input.front as { url: string }).url,\n      }\n      if (input.back) payload.image_back_url = (input.back as { url: string }).url\n      init = jsonRequest(payload)\n    } else if (frontKind === 'base64') {\n      const payload: Record<string, string> = { image_front: asBase64(input.front) }\n      if (input.back) payload.image_back = asBase64(input.back)\n      init = jsonRequest(payload)\n    } else {\n      const form = new FormData()\n      form.append('image_front', toBlob(input.front as BinaryImage, input.frontMimeType))\n      if (input.back) {\n        form.append('image_back', toBlob(input.back as BinaryImage, input.backMimeType))\n      }\n      init = { method: 'POST', body: form }\n    }\n\n    const body = (await this.request('/extract', init)) as {\n      extraction_id: string\n      data: ExtractResult['data']\n      tokens_remaining: number\n      upload_method: string\n    }\n\n    return {\n      extractionId: body.extraction_id,\n      data: body.data,\n      tokensRemaining: body.tokens_remaining,\n      uploadMethod: body.upload_method,\n    }\n  }\n\n  private async request(path: string, init: RequestInit): Promise<unknown> {\n    const controller = new AbortController()\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs)\n\n    let res: Response\n    try {\n      res = await this.fetchImpl(this.baseUrl + path, {\n        ...init,\n        signal: controller.signal,\n        headers: { 'X-API-Key': this.apiKey, ...(init.headers ?? {}) },\n      })\n    } catch (err) {\n      if (err instanceof Error && err.name === 'AbortError') {\n        throw new IneExtractorError(\n          `La petición excedió el timeout de ${this.timeoutMs} ms.`,\n          'TIMEOUT',\n          { cause: err }\n        )\n      }\n      throw new IneExtractorError(\n        err instanceof Error ? err.message : 'Error de red',\n        'NETWORK_ERROR',\n        { cause: err }\n      )\n    } finally {\n      clearTimeout(timer)\n    }\n\n    const body = await res.json().catch(() => ({}))\n    if (!res.ok || (body as { success?: boolean })?.success === false) {\n      throw IneExtractorError.fromResponse(res.status, body)\n    }\n    return body\n  }\n}\n\ntype SourceKind = 'binary' | 'base64' | 'url'\n\nfunction kindOf(src: ImageSource): SourceKind {\n  if (typeof src === 'string') return 'base64'\n  if (src instanceof Uint8Array || src instanceof ArrayBuffer) return 'binary'\n  if (src instanceof Blob) return 'binary'\n  if (typeof src === 'object' && src !== null) {\n    if ('url' in src) return 'url'\n    if ('base64' in src) return 'base64'\n  }\n  throw new IneExtractorError(\n    'Fuente de imagen no soportada. Usa Uint8Array, ArrayBuffer, Blob, { base64 } o { url }.',\n    'INVALID_INPUT'\n  )\n}\n\nfunction asBase64(src: ImageSource): string {\n  if (typeof src === 'string') return src\n  if (typeof src === 'object' && src !== null && 'base64' in src) return src.base64\n  throw new IneExtractorError('Se esperaba una cadena base64.', 'INVALID_INPUT')\n}\n\nfunction toBlob(src: BinaryImage, mimeType = 'image/jpeg'): Blob {\n  if (src instanceof Blob) return src\n  if (src instanceof ArrayBuffer) return new Blob([src], { type: mimeType })\n  // Uint8Array: copy exactly its bytes into a standalone ArrayBuffer so the\n  // result is a valid BlobPart regardless of the backing buffer kind.\n  const bytes = src.buffer.slice(src.byteOffset, src.byteOffset + src.byteLength)\n  return new Blob([bytes as ArrayBuffer], { type: mimeType })\n}\n\nfunction jsonRequest(payload: Record<string, string>): RequestInit {\n  return {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(payload),\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,187 @@
+/**
+ * Datos extraídos de una credencial INE/IFE.
+ *
+ * Todos los campos son strings. Los del reverso (`numeroVertical`, `ocr`,
+ * `cic`, `emision`) solo se obtienen si envías también la imagen trasera.
+ * Un campo puede venir vacío si no es legible en la credencial.
+ */
+interface IneData {
+    /** Nombre(s) del titular */
+    nombre: string;
+    /** Apellido paterno */
+    apellidoPaterno: string;
+    /** Apellido materno */
+    apellidoMaterno: string;
+    /** Domicilio completo */
+    domicilio: string;
+    /** Calle con número */
+    calle: string;
+    /** Colonia */
+    colonia: string;
+    /** Código postal (5 dígitos) */
+    codigoPostal: string;
+    /** Municipio o alcaldía */
+    municipio: string;
+    /** Estado (abreviatura) */
+    estado: string;
+    /** Sección electoral (4 dígitos) */
+    seccion: string;
+    /** CURP (18 caracteres) */
+    curp: string;
+    /** Clave de elector (18 caracteres) */
+    claveElector: string;
+    /** Año de registro (4 dígitos) */
+    anioRegistro: string;
+    /** Fecha de nacimiento (DD/MM/AAAA) */
+    fechaNacimiento: string;
+    /** Sexo: H (hombre) o M (mujer) */
+    sexo: string;
+    /** Vigencia (año, 4 dígitos) */
+    vigencia: string;
+    /** Número vertical (reverso) */
+    numeroVertical: string;
+    /** Código OCR / MRZ (13 dígitos, reverso) */
+    ocr: string;
+    /** CIC — folio del plástico (9 dígitos, reverso) */
+    cic: string;
+    /** Número de emisión (2 dígitos, reverso) */
+    emision: string;
+}
+/** Resultado de una extracción exitosa. */
+interface ExtractResult {
+    /** Identificador de la extracción en el sistema. */
+    extractionId: string;
+    /** Datos extraídos de la credencial. */
+    data: IneData;
+    /** Tokens restantes en tu cuenta tras esta extracción. */
+    tokensRemaining: number;
+    /** Método de upload detectado por la API. */
+    uploadMethod: string;
+}
+/** Imagen binaria aceptada por el SDK (Node 18+ o navegador). */
+type BinaryImage = Uint8Array | ArrayBuffer | Blob;
+/**
+ * Fuente de una imagen de credencial. Puede ser:
+ * - binaria (`Uint8Array` / `ArrayBuffer` / `Blob`) → se envía como multipart;
+ * - `{ base64 }` (con o sin prefijo `data:`) → se envía como JSON base64;
+ * - `{ url }` (HTTPS) → la API descarga la imagen.
+ * - `string` → atajo equivalente a `{ base64: string }`.
+ */
+type ImageSource = BinaryImage | {
+    base64: string;
+} | {
+    url: string;
+} | string;
+/** Parámetros de `client.extract()`. */
+interface ExtractInput {
+    /** Imagen frontal (requerida). */
+    front: ImageSource;
+    /** Imagen trasera (opcional; necesaria para CIC, OCR y número vertical). */
+    back?: ImageSource;
+    /** MIME de la imagen frontal cuando es binaria. Default `image/jpeg`. */
+    frontMimeType?: string;
+    /** MIME de la imagen trasera cuando es binaria. Default `image/jpeg`. */
+    backMimeType?: string;
+}
+/** Opciones del constructor del cliente. */
+interface IneExtractorOptions {
+    /** Tu API key (empieza con `ine_`). Requerida. */
+    apiKey: string;
+    /** URL base de la API. Default `https://extraerdatosdeine.com/api/v1`. */
+    baseUrl?: string;
+    /** Timeout por petición en ms. Default `60000`. */
+    timeoutMs?: number;
+    /** Implementación de `fetch` a usar (para tests o entornos sin fetch global). */
+    fetch?: typeof fetch;
+}
+
+/**
+ * Cliente para la API de Extraer Datos de INE.
+ *
+ * @example
+ * import { readFile } from 'node:fs/promises'
+ * import { IneExtractorClient } from 'extraer-datos-ine'
+ *
+ * const client = new IneExtractorClient({ apiKey: process.env.INE_API_KEY! })
+ * const front = await readFile('./ine_frente.jpg')
+ * const back = await readFile('./ine_reverso.jpg')
+ * const { data } = await client.extract({ front, back })
+ * console.log(data.curp, data.claveElector)
+ *
+ * @see https://extraerdatosdeine.com/docs
+ */
+declare class IneExtractorClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: IneExtractorOptions);
+    /**
+     * Consulta el saldo de tokens de tu cuenta.
+     * @returns número de tokens disponibles.
+     */
+    getBalance(): Promise<number>;
+    /**
+     * Extrae los datos de una credencial INE/IFE.
+     *
+     * El método de envío se elige automáticamente según el tipo de `front`:
+     * binario → multipart; `{ base64 }` o string → JSON base64; `{ url }` → JSON URL.
+     * `front` y `back` deben ser del mismo tipo (la API no mezcla métodos).
+     *
+     * @throws {IneExtractorError} ante saldo insuficiente, imagen ilegible,
+     *   formato inválido, error de red, timeout, etc. Revisa `error.code`.
+     */
+    extract(input: ExtractInput): Promise<ExtractResult>;
+    private request;
+}
+
+/**
+ * Códigos de error que devuelve la API de Extraer Datos de INE, más algunos
+ * códigos propios del SDK (`NETWORK_ERROR`, `TIMEOUT`).
+ *
+ * @see https://extraerdatosdeine.com/docs
+ */
+type IneErrorCode = 'MISSING_API_KEY' | 'INVALID_API_KEY' | 'MISSING_IMAGE' | 'INVALID_IMAGE_FORMAT' | 'IMAGE_TOO_LARGE' | 'INVALID_BASE64' | 'INVALID_MULTIPART' | 'URL_FETCH_FAILED' | 'URL_INVALID' | 'URL_BLOCKED' | 'URL_TIMEOUT' | 'UNSUPPORTED_CONTENT_TYPE' | 'INSUFFICIENT_TOKENS' | 'LOW_IMAGE_QUALITY' | 'EXTRACTION_FAILED' | 'PROCESSING_ERROR' | 'INTERNAL_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'INVALID_INPUT' | (string & {});
+/**
+ * Error lanzado por el SDK ante cualquier respuesta no exitosa de la API
+ * o un fallo de red/timeout. Inspecciona `code` para reaccionar de forma
+ * programática.
+ *
+ * @example
+ * try {
+ *   await client.extract({ front })
+ * } catch (err) {
+ *   if (err instanceof IneExtractorError && err.code === 'INSUFFICIENT_TOKENS') {
+ *     console.log('Recarga tokens en', err.enrollUrl)
+ *   }
+ * }
+ */
+declare class IneExtractorError extends Error {
+    /** Código de error legible por máquina. */
+    readonly code: IneErrorCode;
+    /** Status HTTP de la respuesta (ausente en errores de red). */
+    readonly status?: number;
+    /** ID de la extracción, cuando aplica (LOW_IMAGE_QUALITY / EXTRACTION_FAILED). */
+    readonly extractionId?: string;
+    /** Campos que no se pudieron leer (LOW_IMAGE_QUALITY). */
+    readonly missingFields?: string[];
+    /** URL para configurar auto-recarga (algunos INSUFFICIENT_TOKENS). */
+    readonly enrollUrl?: string;
+    /** Motivo de bloqueo (algunos INSUFFICIENT_TOKENS). */
+    readonly blockReason?: string;
+    /** Cuerpo crudo de la respuesta de error, por si necesitas más detalle. */
+    readonly response?: unknown;
+    constructor(message: string, code: IneErrorCode, init?: {
+        status?: number;
+        extractionId?: string;
+        missingFields?: string[];
+        enrollUrl?: string;
+        blockReason?: string;
+        response?: unknown;
+        cause?: unknown;
+    });
+    /** Construye el error a partir de una respuesta de la API. */
+    static fromResponse(status: number, body: unknown): IneExtractorError;
+}
+
+export { type BinaryImage, type ExtractInput, type ExtractResult, type ImageSource, type IneData, type IneErrorCode, IneExtractorClient, IneExtractorError, type IneExtractorOptions };

package/dist/index.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Datos extraídos de una credencial INE/IFE.
+ *
+ * Todos los campos son strings. Los del reverso (`numeroVertical`, `ocr`,
+ * `cic`, `emision`) solo se obtienen si envías también la imagen trasera.
+ * Un campo puede venir vacío si no es legible en la credencial.
+ */
+interface IneData {
+    /** Nombre(s) del titular */
+    nombre: string;
+    /** Apellido paterno */
+    apellidoPaterno: string;
+    /** Apellido materno */
+    apellidoMaterno: string;
+    /** Domicilio completo */
+    domicilio: string;
+    /** Calle con número */
+    calle: string;
+    /** Colonia */
+    colonia: string;
+    /** Código postal (5 dígitos) */
+    codigoPostal: string;
+    /** Municipio o alcaldía */
+    municipio: string;
+    /** Estado (abreviatura) */
+    estado: string;
+    /** Sección electoral (4 dígitos) */
+    seccion: string;
+    /** CURP (18 caracteres) */
+    curp: string;
+    /** Clave de elector (18 caracteres) */
+    claveElector: string;
+    /** Año de registro (4 dígitos) */
+    anioRegistro: string;
+    /** Fecha de nacimiento (DD/MM/AAAA) */
+    fechaNacimiento: string;
+    /** Sexo: H (hombre) o M (mujer) */
+    sexo: string;
+    /** Vigencia (año, 4 dígitos) */
+    vigencia: string;
+    /** Número vertical (reverso) */
+    numeroVertical: string;
+    /** Código OCR / MRZ (13 dígitos, reverso) */
+    ocr: string;
+    /** CIC — folio del plástico (9 dígitos, reverso) */
+    cic: string;
+    /** Número de emisión (2 dígitos, reverso) */
+    emision: string;
+}
+/** Resultado de una extracción exitosa. */
+interface ExtractResult {
+    /** Identificador de la extracción en el sistema. */
+    extractionId: string;
+    /** Datos extraídos de la credencial. */
+    data: IneData;
+    /** Tokens restantes en tu cuenta tras esta extracción. */
+    tokensRemaining: number;
+    /** Método de upload detectado por la API. */
+    uploadMethod: string;
+}
+/** Imagen binaria aceptada por el SDK (Node 18+ o navegador). */
+type BinaryImage = Uint8Array | ArrayBuffer | Blob;
+/**
+ * Fuente de una imagen de credencial. Puede ser:
+ * - binaria (`Uint8Array` / `ArrayBuffer` / `Blob`) → se envía como multipart;
+ * - `{ base64 }` (con o sin prefijo `data:`) → se envía como JSON base64;
+ * - `{ url }` (HTTPS) → la API descarga la imagen.
+ * - `string` → atajo equivalente a `{ base64: string }`.
+ */
+type ImageSource = BinaryImage | {
+    base64: string;
+} | {
+    url: string;
+} | string;
+/** Parámetros de `client.extract()`. */
+interface ExtractInput {
+    /** Imagen frontal (requerida). */
+    front: ImageSource;
+    /** Imagen trasera (opcional; necesaria para CIC, OCR y número vertical). */
+    back?: ImageSource;
+    /** MIME de la imagen frontal cuando es binaria. Default `image/jpeg`. */
+    frontMimeType?: string;
+    /** MIME de la imagen trasera cuando es binaria. Default `image/jpeg`. */
+    backMimeType?: string;
+}
+/** Opciones del constructor del cliente. */
+interface IneExtractorOptions {
+    /** Tu API key (empieza con `ine_`). Requerida. */
+    apiKey: string;
+    /** URL base de la API. Default `https://extraerdatosdeine.com/api/v1`. */
+    baseUrl?: string;
+    /** Timeout por petición en ms. Default `60000`. */
+    timeoutMs?: number;
+    /** Implementación de `fetch` a usar (para tests o entornos sin fetch global). */
+    fetch?: typeof fetch;
+}
+
+/**
+ * Cliente para la API de Extraer Datos de INE.
+ *
+ * @example
+ * import { readFile } from 'node:fs/promises'
+ * import { IneExtractorClient } from 'extraer-datos-ine'
+ *
+ * const client = new IneExtractorClient({ apiKey: process.env.INE_API_KEY! })
+ * const front = await readFile('./ine_frente.jpg')
+ * const back = await readFile('./ine_reverso.jpg')
+ * const { data } = await client.extract({ front, back })
+ * console.log(data.curp, data.claveElector)
+ *
+ * @see https://extraerdatosdeine.com/docs
+ */
+declare class IneExtractorClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: IneExtractorOptions);
+    /**
+     * Consulta el saldo de tokens de tu cuenta.
+     * @returns número de tokens disponibles.
+     */
+    getBalance(): Promise<number>;
+    /**
+     * Extrae los datos de una credencial INE/IFE.
+     *
+     * El método de envío se elige automáticamente según el tipo de `front`:
+     * binario → multipart; `{ base64 }` o string → JSON base64; `{ url }` → JSON URL.
+     * `front` y `back` deben ser del mismo tipo (la API no mezcla métodos).
+     *
+     * @throws {IneExtractorError} ante saldo insuficiente, imagen ilegible,
+     *   formato inválido, error de red, timeout, etc. Revisa `error.code`.
+     */
+    extract(input: ExtractInput): Promise<ExtractResult>;
+    private request;
+}
+
+/**
+ * Códigos de error que devuelve la API de Extraer Datos de INE, más algunos
+ * códigos propios del SDK (`NETWORK_ERROR`, `TIMEOUT`).
+ *
+ * @see https://extraerdatosdeine.com/docs
+ */
+type IneErrorCode = 'MISSING_API_KEY' | 'INVALID_API_KEY' | 'MISSING_IMAGE' | 'INVALID_IMAGE_FORMAT' | 'IMAGE_TOO_LARGE' | 'INVALID_BASE64' | 'INVALID_MULTIPART' | 'URL_FETCH_FAILED' | 'URL_INVALID' | 'URL_BLOCKED' | 'URL_TIMEOUT' | 'UNSUPPORTED_CONTENT_TYPE' | 'INSUFFICIENT_TOKENS' | 'LOW_IMAGE_QUALITY' | 'EXTRACTION_FAILED' | 'PROCESSING_ERROR' | 'INTERNAL_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'INVALID_INPUT' | (string & {});
+/**
+ * Error lanzado por el SDK ante cualquier respuesta no exitosa de la API
+ * o un fallo de red/timeout. Inspecciona `code` para reaccionar de forma
+ * programática.
+ *
+ * @example
+ * try {
+ *   await client.extract({ front })
+ * } catch (err) {
+ *   if (err instanceof IneExtractorError && err.code === 'INSUFFICIENT_TOKENS') {
+ *     console.log('Recarga tokens en', err.enrollUrl)
+ *   }
+ * }
+ */
+declare class IneExtractorError extends Error {
+    /** Código de error legible por máquina. */
+    readonly code: IneErrorCode;
+    /** Status HTTP de la respuesta (ausente en errores de red). */
+    readonly status?: number;
+    /** ID de la extracción, cuando aplica (LOW_IMAGE_QUALITY / EXTRACTION_FAILED). */
+    readonly extractionId?: string;
+    /** Campos que no se pudieron leer (LOW_IMAGE_QUALITY). */
+    readonly missingFields?: string[];
+    /** URL para configurar auto-recarga (algunos INSUFFICIENT_TOKENS). */
+    readonly enrollUrl?: string;
+    /** Motivo de bloqueo (algunos INSUFFICIENT_TOKENS). */
+    readonly blockReason?: string;
+    /** Cuerpo crudo de la respuesta de error, por si necesitas más detalle. */
+    readonly response?: unknown;
+    constructor(message: string, code: IneErrorCode, init?: {
+        status?: number;
+        extractionId?: string;
+        missingFields?: string[];
+        enrollUrl?: string;
+        blockReason?: string;
+        response?: unknown;
+        cause?: unknown;
+    });
+    /** Construye el error a partir de una respuesta de la API. */
+    static fromResponse(status: number, body: unknown): IneExtractorError;
+}
+
+export { type BinaryImage, type ExtractInput, type ExtractResult, type ImageSource, type IneData, type IneErrorCode, IneExtractorClient, IneExtractorError, type IneExtractorOptions };

package/dist/index.js

@@ -0,0 +1,193 @@
+// src/errors.ts
+var IneExtractorError = class _IneExtractorError extends Error {
+  /** Código de error legible por máquina. */
+  code;
+  /** Status HTTP de la respuesta (ausente en errores de red). */
+  status;
+  /** ID de la extracción, cuando aplica (LOW_IMAGE_QUALITY / EXTRACTION_FAILED). */
+  extractionId;
+  /** Campos que no se pudieron leer (LOW_IMAGE_QUALITY). */
+  missingFields;
+  /** URL para configurar auto-recarga (algunos INSUFFICIENT_TOKENS). */
+  enrollUrl;
+  /** Motivo de bloqueo (algunos INSUFFICIENT_TOKENS). */
+  blockReason;
+  /** Cuerpo crudo de la respuesta de error, por si necesitas más detalle. */
+  response;
+  constructor(message, code, init = {}) {
+    super(message, init.cause !== void 0 ? { cause: init.cause } : void 0);
+    this.name = "IneExtractorError";
+    this.code = code;
+    this.status = init.status;
+    this.extractionId = init.extractionId;
+    this.missingFields = init.missingFields;
+    this.enrollUrl = init.enrollUrl;
+    this.blockReason = init.blockReason;
+    this.response = init.response;
+    Object.setPrototypeOf(this, _IneExtractorError.prototype);
+  }
+  /** Construye el error a partir de una respuesta de la API. */
+  static fromResponse(status, body) {
+    const b = body ?? {};
+    const code = typeof b.code === "string" ? b.code : "INTERNAL_ERROR";
+    const message = typeof b.error === "string" && b.error || `La API respondi\xF3 con status ${status}`;
+    return new _IneExtractorError(message, code, {
+      status,
+      extractionId: typeof b.extraction_id === "string" ? b.extraction_id : void 0,
+      missingFields: Array.isArray(b.missing_fields) ? b.missing_fields : void 0,
+      enrollUrl: typeof b.enroll_url === "string" ? b.enroll_url : void 0,
+      blockReason: typeof b.block_reason === "string" ? b.block_reason : void 0,
+      response: body
+    });
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://extraerdatosdeine.com/api/v1";
+var DEFAULT_TIMEOUT_MS = 6e4;
+var IneExtractorClient = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  fetchImpl;
+  constructor(options) {
+    if (!options || !options.apiKey) {
+      throw new IneExtractorError("Falta `apiKey` en las opciones del cliente.", "INVALID_INPUT");
+    }
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+      throw new IneExtractorError(
+        "No hay `fetch` disponible. Usa Node 18+ o pasa `fetch` en las opciones.",
+        "INVALID_INPUT"
+      );
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.fetchImpl = fetchImpl;
+  }
+  /**
+   * Consulta el saldo de tokens de tu cuenta.
+   * @returns número de tokens disponibles.
+   */
+  async getBalance() {
+    const body = await this.request("/balance", { method: "GET" });
+    return Number(body.balance);
+  }
+  /**
+   * Extrae los datos de una credencial INE/IFE.
+   *
+   * El método de envío se elige automáticamente según el tipo de `front`:
+   * binario → multipart; `{ base64 }` o string → JSON base64; `{ url }` → JSON URL.
+   * `front` y `back` deben ser del mismo tipo (la API no mezcla métodos).
+   *
+   * @throws {IneExtractorError} ante saldo insuficiente, imagen ilegible,
+   *   formato inválido, error de red, timeout, etc. Revisa `error.code`.
+   */
+  async extract(input) {
+    if (!input || input.front === void 0 || input.front === null) {
+      throw new IneExtractorError("Falta la imagen frontal (`front`).", "MISSING_IMAGE");
+    }
+    const frontKind = kindOf(input.front);
+    if (input.back !== void 0 && kindOf(input.back) !== frontKind) {
+      throw new IneExtractorError(
+        "`front` y `back` deben ser del mismo tipo (ambos binarios, base64 o url).",
+        "INVALID_INPUT"
+      );
+    }
+    let init;
+    if (frontKind === "url") {
+      const payload = {
+        image_front_url: input.front.url
+      };
+      if (input.back) payload.image_back_url = input.back.url;
+      init = jsonRequest(payload);
+    } else if (frontKind === "base64") {
+      const payload = { image_front: asBase64(input.front) };
+      if (input.back) payload.image_back = asBase64(input.back);
+      init = jsonRequest(payload);
+    } else {
+      const form = new FormData();
+      form.append("image_front", toBlob(input.front, input.frontMimeType));
+      if (input.back) {
+        form.append("image_back", toBlob(input.back, input.backMimeType));
+      }
+      init = { method: "POST", body: form };
+    }
+    const body = await this.request("/extract", init);
+    return {
+      extractionId: body.extraction_id,
+      data: body.data,
+      tokensRemaining: body.tokens_remaining,
+      uploadMethod: body.upload_method
+    };
+  }
+  async request(path, init) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    let res;
+    try {
+      res = await this.fetchImpl(this.baseUrl + path, {
+        ...init,
+        signal: controller.signal,
+        headers: { "X-API-Key": this.apiKey, ...init.headers ?? {} }
+      });
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new IneExtractorError(
+          `La petici\xF3n excedi\xF3 el timeout de ${this.timeoutMs} ms.`,
+          "TIMEOUT",
+          { cause: err }
+        );
+      }
+      throw new IneExtractorError(
+        err instanceof Error ? err.message : "Error de red",
+        "NETWORK_ERROR",
+        { cause: err }
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok || body?.success === false) {
+      throw IneExtractorError.fromResponse(res.status, body);
+    }
+    return body;
+  }
+};
+function kindOf(src) {
+  if (typeof src === "string") return "base64";
+  if (src instanceof Uint8Array || src instanceof ArrayBuffer) return "binary";
+  if (src instanceof Blob) return "binary";
+  if (typeof src === "object" && src !== null) {
+    if ("url" in src) return "url";
+    if ("base64" in src) return "base64";
+  }
+  throw new IneExtractorError(
+    "Fuente de imagen no soportada. Usa Uint8Array, ArrayBuffer, Blob, { base64 } o { url }.",
+    "INVALID_INPUT"
+  );
+}
+function asBase64(src) {
+  if (typeof src === "string") return src;
+  if (typeof src === "object" && src !== null && "base64" in src) return src.base64;
+  throw new IneExtractorError("Se esperaba una cadena base64.", "INVALID_INPUT");
+}
+function toBlob(src, mimeType = "image/jpeg") {
+  if (src instanceof Blob) return src;
+  if (src instanceof ArrayBuffer) return new Blob([src], { type: mimeType });
+  const bytes = src.buffer.slice(src.byteOffset, src.byteOffset + src.byteLength);
+  return new Blob([bytes], { type: mimeType });
+}
+function jsonRequest(payload) {
+  return {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload)
+  };
+}
+export {
+  IneExtractorClient,
+  IneExtractorError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["/**\n * Códigos de error que devuelve la API de Extraer Datos de INE, más algunos\n * códigos propios del SDK (`NETWORK_ERROR`, `TIMEOUT`).\n *\n * @see https://extraerdatosdeine.com/docs\n */\nexport type IneErrorCode =\n  // 401\n  | 'MISSING_API_KEY'\n  | 'INVALID_API_KEY'\n  // 400\n  | 'MISSING_IMAGE'\n  | 'INVALID_IMAGE_FORMAT'\n  | 'IMAGE_TOO_LARGE'\n  | 'INVALID_BASE64'\n  | 'INVALID_MULTIPART'\n  | 'URL_FETCH_FAILED'\n  | 'URL_INVALID'\n  | 'URL_BLOCKED'\n  | 'URL_TIMEOUT'\n  // 415\n  | 'UNSUPPORTED_CONTENT_TYPE'\n  // 402\n  | 'INSUFFICIENT_TOKENS'\n  // 422\n  | 'LOW_IMAGE_QUALITY'\n  // 500\n  | 'EXTRACTION_FAILED'\n  | 'PROCESSING_ERROR'\n  | 'INTERNAL_ERROR'\n  // SDK-only\n  | 'NETWORK_ERROR'\n  | 'TIMEOUT'\n  | 'INVALID_INPUT'\n  // forward-compatible: unknown server codes\n  | (string & {})\n\n/**\n * Error lanzado por el SDK ante cualquier respuesta no exitosa de la API\n * o un fallo de red/timeout. Inspecciona `code` para reaccionar de forma\n * programática.\n *\n * @example\n * try {\n *   await client.extract({ front })\n * } catch (err) {\n *   if (err instanceof IneExtractorError && err.code === 'INSUFFICIENT_TOKENS') {\n *     console.log('Recarga tokens en', err.enrollUrl)\n *   }\n * }\n */\nexport class IneExtractorError extends Error {\n  /** Código de error legible por máquina. */\n  readonly code: IneErrorCode\n  /** Status HTTP de la respuesta (ausente en errores de red). */\n  readonly status?: number\n  /** ID de la extracción, cuando aplica (LOW_IMAGE_QUALITY / EXTRACTION_FAILED). */\n  readonly extractionId?: string\n  /** Campos que no se pudieron leer (LOW_IMAGE_QUALITY). */\n  readonly missingFields?: string[]\n  /** URL para configurar auto-recarga (algunos INSUFFICIENT_TOKENS). */\n  readonly enrollUrl?: string\n  /** Motivo de bloqueo (algunos INSUFFICIENT_TOKENS). */\n  readonly blockReason?: string\n  /** Cuerpo crudo de la respuesta de error, por si necesitas más detalle. */\n  readonly response?: unknown\n\n  constructor(\n    message: string,\n    code: IneErrorCode,\n    init: {\n      status?: number\n      extractionId?: string\n      missingFields?: string[]\n      enrollUrl?: string\n      blockReason?: string\n      response?: unknown\n      cause?: unknown\n    } = {}\n  ) {\n    super(message, init.cause !== undefined ? { cause: init.cause } : undefined)\n    this.name = 'IneExtractorError'\n    this.code = code\n    this.status = init.status\n    this.extractionId = init.extractionId\n    this.missingFields = init.missingFields\n    this.enrollUrl = init.enrollUrl\n    this.blockReason = init.blockReason\n    this.response = init.response\n    // Restore prototype chain for instanceof across transpile targets.\n    Object.setPrototypeOf(this, IneExtractorError.prototype)\n  }\n\n  /** Construye el error a partir de una respuesta de la API. */\n  static fromResponse(status: number, body: unknown): IneExtractorError {\n    const b = (body ?? {}) as Record<string, unknown>\n    const code = (typeof b.code === 'string' ? b.code : 'INTERNAL_ERROR') as IneErrorCode\n    const message =\n      (typeof b.error === 'string' && b.error) ||\n      `La API respondió con status ${status}`\n    return new IneExtractorError(message, code, {\n      status,\n      extractionId: typeof b.extraction_id === 'string' ? b.extraction_id : undefined,\n      missingFields: Array.isArray(b.missing_fields)\n        ? (b.missing_fields as string[])\n        : undefined,\n      enrollUrl: typeof b.enroll_url === 'string' ? b.enroll_url : undefined,\n      blockReason: typeof b.block_reason === 'string' ? b.block_reason : undefined,\n      response: body,\n    })\n  }\n}\n","import { IneExtractorError } from './errors.js'\nimport type {\n  BinaryImage,\n  ExtractInput,\n  ExtractResult,\n  ImageSource,\n  IneExtractorOptions,\n} from './types.js'\n\nconst DEFAULT_BASE_URL = 'https://extraerdatosdeine.com/api/v1'\nconst DEFAULT_TIMEOUT_MS = 60_000\n\n/**\n * Cliente para la API de Extraer Datos de INE.\n *\n * @example\n * import { readFile } from 'node:fs/promises'\n * import { IneExtractorClient } from 'extraer-datos-ine'\n *\n * const client = new IneExtractorClient({ apiKey: process.env.INE_API_KEY! })\n * const front = await readFile('./ine_frente.jpg')\n * const back = await readFile('./ine_reverso.jpg')\n * const { data } = await client.extract({ front, back })\n * console.log(data.curp, data.claveElector)\n *\n * @see https://extraerdatosdeine.com/docs\n */\nexport class IneExtractorClient {\n  private readonly apiKey: string\n  private readonly baseUrl: string\n  private readonly timeoutMs: number\n  private readonly fetchImpl: typeof fetch\n\n  constructor(options: IneExtractorOptions) {\n    if (!options || !options.apiKey) {\n      throw new IneExtractorError('Falta `apiKey` en las opciones del cliente.', 'INVALID_INPUT')\n    }\n    const fetchImpl = options.fetch ?? globalThis.fetch\n    if (typeof fetchImpl !== 'function') {\n      throw new IneExtractorError(\n        'No hay `fetch` disponible. Usa Node 18+ o pasa `fetch` en las opciones.',\n        'INVALID_INPUT'\n      )\n    }\n    this.apiKey = options.apiKey\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '')\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS\n    this.fetchImpl = fetchImpl\n  }\n\n  /**\n   * Consulta el saldo de tokens de tu cuenta.\n   * @returns número de tokens disponibles.\n   */\n  async getBalance(): Promise<number> {\n    const body = await this.request('/balance', { method: 'GET' })\n    return Number((body as { balance: number }).balance)\n  }\n\n  /**\n   * Extrae los datos de una credencial INE/IFE.\n   *\n   * El método de envío se elige automáticamente según el tipo de `front`:\n   * binario → multipart; `{ base64 }` o string → JSON base64; `{ url }` → JSON URL.\n   * `front` y `back` deben ser del mismo tipo (la API no mezcla métodos).\n   *\n   * @throws {IneExtractorError} ante saldo insuficiente, imagen ilegible,\n   *   formato inválido, error de red, timeout, etc. Revisa `error.code`.\n   */\n  async extract(input: ExtractInput): Promise<ExtractResult> {\n    if (!input || input.front === undefined || input.front === null) {\n      throw new IneExtractorError('Falta la imagen frontal (`front`).', 'MISSING_IMAGE')\n    }\n\n    const frontKind = kindOf(input.front)\n    if (input.back !== undefined && kindOf(input.back) !== frontKind) {\n      throw new IneExtractorError(\n        '`front` y `back` deben ser del mismo tipo (ambos binarios, base64 o url).',\n        'INVALID_INPUT'\n      )\n    }\n\n    let init: RequestInit\n    if (frontKind === 'url') {\n      const payload: Record<string, string> = {\n        image_front_url: (input.front as { url: string }).url,\n      }\n      if (input.back) payload.image_back_url = (input.back as { url: string }).url\n      init = jsonRequest(payload)\n    } else if (frontKind === 'base64') {\n      const payload: Record<string, string> = { image_front: asBase64(input.front) }\n      if (input.back) payload.image_back = asBase64(input.back)\n      init = jsonRequest(payload)\n    } else {\n      const form = new FormData()\n      form.append('image_front', toBlob(input.front as BinaryImage, input.frontMimeType))\n      if (input.back) {\n        form.append('image_back', toBlob(input.back as BinaryImage, input.backMimeType))\n      }\n      init = { method: 'POST', body: form }\n    }\n\n    const body = (await this.request('/extract', init)) as {\n      extraction_id: string\n      data: ExtractResult['data']\n      tokens_remaining: number\n      upload_method: string\n    }\n\n    return {\n      extractionId: body.extraction_id,\n      data: body.data,\n      tokensRemaining: body.tokens_remaining,\n      uploadMethod: body.upload_method,\n    }\n  }\n\n  private async request(path: string, init: RequestInit): Promise<unknown> {\n    const controller = new AbortController()\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs)\n\n    let res: Response\n    try {\n      res = await this.fetchImpl(this.baseUrl + path, {\n        ...init,\n        signal: controller.signal,\n        headers: { 'X-API-Key': this.apiKey, ...(init.headers ?? {}) },\n      })\n    } catch (err) {\n      if (err instanceof Error && err.name === 'AbortError') {\n        throw new IneExtractorError(\n          `La petición excedió el timeout de ${this.timeoutMs} ms.`,\n          'TIMEOUT',\n          { cause: err }\n        )\n      }\n      throw new IneExtractorError(\n        err instanceof Error ? err.message : 'Error de red',\n        'NETWORK_ERROR',\n        { cause: err }\n      )\n    } finally {\n      clearTimeout(timer)\n    }\n\n    const body = await res.json().catch(() => ({}))\n    if (!res.ok || (body as { success?: boolean })?.success === false) {\n      throw IneExtractorError.fromResponse(res.status, body)\n    }\n    return body\n  }\n}\n\ntype SourceKind = 'binary' | 'base64' | 'url'\n\nfunction kindOf(src: ImageSource): SourceKind {\n  if (typeof src === 'string') return 'base64'\n  if (src instanceof Uint8Array || src instanceof ArrayBuffer) return 'binary'\n  if (src instanceof Blob) return 'binary'\n  if (typeof src === 'object' && src !== null) {\n    if ('url' in src) return 'url'\n    if ('base64' in src) return 'base64'\n  }\n  throw new IneExtractorError(\n    'Fuente de imagen no soportada. Usa Uint8Array, ArrayBuffer, Blob, { base64 } o { url }.',\n    'INVALID_INPUT'\n  )\n}\n\nfunction asBase64(src: ImageSource): string {\n  if (typeof src === 'string') return src\n  if (typeof src === 'object' && src !== null && 'base64' in src) return src.base64\n  throw new IneExtractorError('Se esperaba una cadena base64.', 'INVALID_INPUT')\n}\n\nfunction toBlob(src: BinaryImage, mimeType = 'image/jpeg'): Blob {\n  if (src instanceof Blob) return src\n  if (src instanceof ArrayBuffer) return new Blob([src], { type: mimeType })\n  // Uint8Array: copy exactly its bytes into a standalone ArrayBuffer so the\n  // result is a valid BlobPart regardless of the backing buffer kind.\n  const bytes = src.buffer.slice(src.byteOffset, src.byteOffset + src.byteLength)\n  return new Blob([bytes as ArrayBuffer], { type: mimeType })\n}\n\nfunction jsonRequest(payload: Record<string, string>): RequestInit {\n  return {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(payload),\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "extraer-datos-ine",
+  "version": "1.0.0",
+  "description": "SDK oficial de Extraer Datos de INE — API de OCR para credenciales INE/IFE mexicanas (CURP, clave de elector, dirección y más).",
+  "keywords": [
+    "INE",
+    "IFE",
+    "OCR",
+    "CURP",
+    "clave de elector",
+    "credencial para votar",
+    "Mexico",
+    "KYC",
+    "extraccion de datos",
+    "API"
+  ],
+  "homepage": "https://extraerdatosdeine.com/docs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rcfrias/ine-extractor-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rcfrias/ine-extractor-js/issues"
+  },
+  "license": "MIT",
+  "author": "Extraer Datos de INE (https://extraerdatosdeine.com)",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  }
+}