# StickEngine - Lagos Solutions

![Lagos Solutions](./logo_small.png)

**Motor profissional de figurinhas para WhatsApp**
Estático e animado, com EXIF, marca d'água com sua logo e suporte total ESM + CJS + TypeScript

[![npm](https://img.shields.io/npm/v/@boruto_vk7/stickengine?style=flat-square&color=7c3aed)](https://www.npmjs.com/package/@boruto_vk7/stickengine)
[![node](https://img.shields.io/node/v/@boruto_vk7/stickengine?style=flat-square&color=7c3aed)](https://nodejs.org)
[![license](https://img.shields.io/badge/License-MIT-7c3aed?style=flat-square)](LICENSE)
[![Lagos](https://img.shields.io/badge/Lagos-Solutions-7c3aed?style=flat-square)](https://www.npmjs.com/package/@boruto_vk7/stickengine)

![Lagos Solutions Logo](./logo.png)

> SOLUÇÕES INTELIGENTES. RESULTADOS REAIS.

---

## 🚀 Instalação

```bash
npm install @boruto_vk7/stickengine
```

FFmpeg já incluso via `@ffmpeg-installer/ffmpeg`. Não precisa instalar manualmente.

---

## ✨ Funcionalidades

- ✅ **Todos os tipos de entrada:** Buffer, caminho local, URL https, data URI base64, base64 puro
- ✅ **Todos os tipos de figurinha:** JPG, PNG, WEBP estático, GIF animado, MP4, WEBM
- ✅ **5 modos de enquadramento:** `natural` (padrão WA), `cover`, `contain`, `fill`, `none`
- ✅ **EXIF com pack e autor:** Compatível com node-webpmux v1 e v3
- ✅ **Auto shrink:** Figurinhas animadas sempre abaixo de 1MB
- ✅ **Dirtemp custom:** `Dirtemp`, `tempDir`, `dirTemp` - qualquer alias funciona
- ✅ **Marca d'água com LOGO:** `watermark: true` usa sua `logo.png` automaticamente
- ✅ **Compatível:** ESM `import`, CJS `require()`, TypeScript `NodeNext` e `CommonJS`
- ✅ **APIs antigas:** `sendImageAsSticker`, `imageToWebp`, `writeExifImg` ainda funcionam

---

## 📦 Uso Rápido

### ESM / TypeScript
```javascript
import StickEngine from '@boruto_vk7/stickengine';

const sticker = await StickEngine.create('./foto.jpg', {
  Dirtemp: './temp',
  watermark: true,
  metadata: {
    pack: 'Lagos Solutions',
    author: 'Borutovk7',
    emojis: ['🔥']
  }
});

await sock.sendMessage(jid, { sticker: sticker.buffer });
```

### CommonJS
```javascript
const StickEngine = require('@boruto_vk7/stickengine');

const buffer = await StickEngine.toBuffer('./video.mp4', {
  Dirtemp: '/tmp/meus-stickers',
  watermark: false,
  fit: 'natural',
  metadata: { pack: 'Meu Pack', author: 'Bot' }
});
```

### Com marca d'água LOGO

```javascript
await StickEngine.create('./imagem.png', {
  Dirtemp: './temp',
  watermark: true,
  metadata: { pack: 'Lagos', author: 'Solutions' }
});

await StickEngine.create('./imagem.png', {
  watermark: { image: './logo.png', position: 'center', size: 0.4, opacity: 0.6 },
  metadata: { pack: 'Pack', author: 'Author' }
});

await StickEngine.create('./imagem.png', {
  watermark: false,
  metadata: { pack: 'Sem marca', author: 'Bot' }
});
```

---

## 🎨 Modos de Enquadramento

```javascript
await StickEngine.create(input, { fit: 'natural' });
```

| Fit | Resultado |
|-----|-----------|
| `natural` (padrão) | Mantém proporção, lado maior = 512px - visual real do WhatsApp |
| `cover` | Força 512x512 quadrado com corte central |
| `contain` | Encaixa dentro de 512x512 com fundo transparente |
| `fill` | Estica para 512x512 |
| `none` | Só diminui se maior que 512, nunca aumenta |

---

## 📁 Dirtemp Personalizado

Aceita qualquer alias:

```javascript
new StickEngine({ Dirtemp: './minha-pasta' })
new StickEngine({ tempDir: './minha-pasta' })
new StickEngine({ dirTemp: './minha-pasta' })
```

Padrão: `os.tmpdir()/stickengine`

---

## 💧 Marca d'água LOGO

Sua logo `logo.png` é usada automaticamente:

```javascript
{ watermark: true }
{ watermark: false }
{ watermark: './caminho/para/outra-logo.png' }
{ watermark: { image: './logo.png', position: 'bottom-right', size: 0.25 } }
{ marcaDagua: true }
```

Posições: `bottom-right`, `bottom-left`, `top-right`, `top-left`, `center`

---

## 🔄 Compatibilidade com código antigo

```javascript
const { sendImageAsSticker } = require('@boruto_vk7/stickengine');
await sendImageAsSticker(conn, jid, './foto.jpg', quoted, {
  packname: 'Meu Pack',
  author: 'Bot',
  categories: ['🔥']
});
```

---

## 📊 Testado

- ✅ PNG, JPG, WEBP transparente, GIF, MP4, WEBM
- ✅ Buffer, Path local, URL https, Data URI base64, Base64 puro
- ✅ Dirtemp custom
- ✅ Watermark logo e texto
- ✅ Fit natural, cover, contain, fill, none
- ✅ ESM + CJS dual package
- ✅ Foto real com logo Lagos Solutions no canto e no centro

---

## 📄 Licença

MIT - Lagos Solutions

![Lagos Solutions](./logo_small.png)

**SOLUÇÕES INTELIGENTES. RESULTADOS REAIS.**