```markdown


📦 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:

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

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

`json
{
"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

$3

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

`ts
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

`ts
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"
}
]
*/
`

---

$3

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

`ts
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

`ts
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

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

`ts
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

`ts
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.