# 📦 MCC Codes Utility

Una librería sencilla para **trabajar con códigos MCC (Merchant Category Codes)** en español o inglés.

Permite:

- Obtener todos los MCCs en un idioma.
- Buscar un MCC específico por su código.
- Buscar MCCs por texto dentro de su descripción.

---

## 📥 Instalación

Primero instala el paquete:

```bash
npm install mcc-list-en-es
# o con yarn
yarn add mcc-list-en-es
```

📖 Uso básico

Importa las funciones principales desde la librería:

import { getAllMccs, getMccByCode, searchMccs } from "mcc-list-en-es";

Cada función devuelve objetos MCC con la siguiente estructura:

{
  "combined_description": "Veterinary Services",
  "edited_description": "Veterinary Services",
  "id": 0,
  "irs_description": "Veterinary Services",
  "irs_reportable": "Yes",
  "mcc": "0742",
  "usda_description": "Veterinary Services"
}

⚡ Funciones disponibles

1. getAllMccs

Obtiene todos los códigos MCC en el idioma solicitado.

const allSpanish = getAllMccs("es");
const allEnglish = getAllMccs("en");

Parámetros

• lang: "es" o "en" (opcional, por defecto "es").

Devuelve Un array con todos los MCCs en el idioma seleccionado.

Ejemplo

const mccs = getAllMccs("es");

console.log(mccs.slice(0, 2));
/*
[
  {
    combined_description: "Servicios veterinarios",
    edited_description: "Servicios veterinarios",
    id: 0,
    irs_description: "Servicios veterinarios",
    irs_reportable: "Yes",
    mcc: "0742",
    usda_description: "Servicios veterinarios"
  },
  {
    combined_description: "Agricultural Co-operatives",
    edited_description: "Cooperativas agrícolas",
    id: 1,
    irs_description: "Agricultural Co-operatives",
    irs_reportable: "No",
    mcc: "0763",
    usda_description: "Agricultural Co-operatives"
  }
]
*/

2. getMccByCode

Busca un MCC específico por su código.

const mcc = getMccByCode("0742", "en");
console.log(mcc);

Parámetros

• code: string → El código MCC (ejemplo: "0742").
• lang: "es" o "en" (opcional, por defecto "es").

Devuelve Un objeto con los datos del MCC o undefined si no existe.

Ejemplo

const mcc = getMccByCode("0742", "en");

console.log(mcc);
/*
{
  combined_description: "Veterinary Services",
  edited_description: "Veterinary Services",
  id: 0,
  irs_description: "Veterinary Services",
  irs_reportable: "Yes",
  mcc: "0742",
  usda_description: "Veterinary Services"
}
*/

3. searchMccs

Busca MCCs cuyo texto aparezca dentro de la descripción.

const results = searchMccs("restaurant", "en");
console.log(results);

Parámetros

• query: string → Texto a buscar en la descripción.
• lang: "es" o "en" (opcional, por defecto "es").

Devuelve Un array con los MCCs que contienen el texto buscado.

Ejemplo

const results = searchMccs("restaurant", "en");

console.log(results.slice(0, 2));
/*
[
  {
    combined_description: "Eating places and restaurants",
    edited_description: "Restaurants",
    id: 100,
    irs_description: "Eating places and restaurants",
    irs_reportable: "Yes",
    mcc: "5812",
    usda_description: "Eating places and restaurants"
  },
  {
    combined_description: "Drinking Places (Alcoholic Beverages)",
    edited_description: "Bars and Pubs",
    id: 101,
    irs_description: "Drinking Places",
    irs_reportable: "Yes",
    mcc: "5813",
    usda_description: "Drinking Places (Alcoholic Beverages)"
  }
]
*/

📚 Casos de uso

• Crear un buscador de MCCs por palabra clave.
• Mapear el código MCC de una transacción a su descripción.
• Mostrar un catálogo completo de MCCs en un idioma (ej. lista desplegable).

📄 Licencia

MIT – Libre para usar y modificar.