@soymaycol/base64/README.md

Convertidor y ejecutor de archivos .may

# @soymaycol/base64

Módulo para convertir y ejecutar archivos Node.js con extensión .may
> La extensión ".may" es una extension que hace que tu codigo se convierta a base64

## Instalación

```bash

# Si lo vas a usar con comandos
npm install @soymaycol/base64 -g

# Si lo vas a usar en codigo
npm install @soymaycol/base64

# Si quieres usar ambos no instales con -g pero en comando siempre debes poner primero "npx"

```

## Uso por comandos

### Convertir archivo .js a .may
```bash
mayconvert archivo.js
```

### Ejecutar archivo .may
```bash
mayrun archivo.may
```

## Uso programático

```javascript
const { convert, execute } = require('@soymaycol/base64');

// Convertir archivo
convert('./mi-script.js');

// Ejecutar archivo .may
execute('./mi-script.may');
```

## Características

- Convierte archivos JavaScript (.js) a formato .may
- Ejecuta archivos .may de forma segura
- Compatible con Node.js 14+
- Interfaz de línea de comandos incluida
- API programática disponible

## Ejemplos

### Ejemplo 1: Convertir y ejecutar
```bash
# Crear archivo de ejemplo
echo "console.log('¡Hola mundo desde .may!');" > test.js

# Convertir a .may
mayconvert test.js

# Ejecutar archivo .may
mayrun test.may
```

### Ejemplo 2: Uso en código
```javascript
const { convert, execute } = require('@soymaycol/base64');

try {
    // Convertir archivo
    const mayFile = convert('./mi-aplicacion.js');
    
    // Ejecutar archivo convertido
    execute(mayFile);
} catch (error) {
    console.error('Error:', error.message);
}
```

## Autor

Creado por SoyMaycol

## Licencia

ISC