@boruto_vk7/stickengine 0.0.2-alpha → 0.0.3-alpha

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boruto_vk7/stickengine",
-  "version": "0.0.2-alpha",
+  "version": "0.0.3-alpha",
   "description": "StickEngine module for creating WhatsApp stickers",
   "type": "module",
   "main": "dist/StickEngine.js",

package/README.md.bak

@@ -1,131 +0,0 @@
-# StickEngine: Gerador de Stickers para WhatsApp
-
-Bem-vindo ao **StickEngine**, um módulo Node.js robusto e flexível para a criação de stickers personalizados para WhatsApp. Desenvolvido para ser eficiente e compatível com diversos ambientes, o StickEngine permite transformar imagens e vídeos em stickers WebP com metadados personalizados, além de oferecer funcionalidades como remoção de fundo.
-
-## Funcionalidades Principais
-
--   **Geração de Stickers WebP**: Converte imagens (JPG, PNG, GIF) e vídeos (MP4, WebM) para o formato WebP, otimizado para stickers do WhatsApp.
--   **Metadados Personalizados (EXIF)**: Adiciona informações como nome do pacote, autor e emojis diretamente no sticker.
--   **Suporte a URLs, Buffers e Caminhos Locais**: Flexibilidade na entrada de dados para a criação dos stickers.
--   **Remoção de Fundo (Opcional)**: Integração com a API `remove.bg` para remover o fundo de imagens, ideal para criar stickers transparentes.
--   **Compatibilidade CJS e ESM**: O módulo pode ser utilizado tanto em projetos CommonJS (`require`) quanto em módulos ES (`import`).
-
-## Instalação
-
-Para utilizar o StickEngine, você precisará ter o Node.js e o `ffmpeg` instalados em seu sistema. O `ffmpeg` é essencial para a conversão de mídia.
-
-```bash
-# Instale as dependências do Node.js
-pnpm install axios fluent-ffmpeg node-webpmux file-type jimp remove.bg node-fetch
-
-# Certifique-se de ter o ffmpeg instalado e acessível no PATH do seu sistema.
-# Para sistemas baseados em Debian/Ubuntu:
-sudo apt update && sudo apt install ffmpeg
-# Para outras plataformas, consulte a documentação oficial do ffmpeg.
-```
-
-## Uso
-
-O StickEngine é projetado para ser fácil de usar, com uma API baseada em classes e eventos para feedback de progresso.
-
-### Exemplo de Uso (ESM - `index.js`)
-
-```javascript
-import StickEngine from './index.js';
-
-const engine = new StickEngine({
-  metadata: {
-    pack: 'Meu Pack de Stickers',
-    author: 'Borutovk7 & Eduh Dev',
-    emojis: ['✨', '🚀'] // Emojis opcionais
-  },
-  // Para remover o fundo, forneça uma ou mais chaves de API do remove.bg
-  // transparent: ['SUA_API_KEY_REMOVEBG_1', 'SUA_API_KEY_REMOVEBG_2']
-});
-
-// Eventos para acompanhar o progresso
-engine.on('st.start', (data) => console.log(`[START] Processando arquivo ${data.index}:`, data.input));
-engine.on('st.info', (data) => console.log(`[INFO] Metadados do arquivo ${data.index}:`, data));
-engine.on('st.data', (data) => console.log(`[DATA] Sticker ${data.index} gerado em:`, data.file));
-engine.on('st.error', (data) => console.error(`[ERROR] Falha no arquivo ${data.index}:`, data.error));
-
-// Adicione arquivos à fila (pode ser URL, Buffer ou caminho local)
-engine.addFile('https://picsum.photos/512') // Exemplo de URL de imagem
-      .addFile('caminho/para/seu/video.mp4') // Exemplo de caminho local para vídeo
-      .addFile(Buffer.from('...')) // Exemplo de Buffer
-  .start()
-  .then(results => {
-    console.log('Processamento concluído. Resultados:', results);
-  })
-  .catch(err => {
-    console.error('Ocorreu um erro geral no processamento:', err);
-  });
-```
-
-### Exemplo de Uso (CommonJS - `index.cjs`)
-
-```javascript
-const StickEngine = require('./index.cjs');
-
-const engine = new StickEngine({
-  metadata: {
-    pack: 'Meu Pack CJS',
-    author: 'Borutovk7 & Eduh Dev',
-    emojis: ['🎉']
-  }
-});
-
-// Os eventos e a forma de adicionar arquivos são os mesmos do exemplo ESM.
-engine.on('st.start', (data) => console.log(`[START CJS] Processando arquivo ${data.index}:`, data.input));
-// ... (outros eventos)
-
-engine.addFile('https://picsum.photos/200')
-  .start()
-  .then(results => {
-    console.log('Processamento CJS concluído. Resultados:', results);
-  })
-  .catch(err => {
-    console.error('Ocorreu um erro geral no processamento CJS:', err);
-  });
-```
-
-### Função `getBuffer`
-
-A função `getBuffer` fornecida pelo usuário foi integrada ao módulo para lidar com o download de URLs de forma robusta. Ela pode ser importada e utilizada separadamente, se necessário:
-
-```javascript
-// ESM
-import { getBuffer } from './index.js';
-
-// CJS
-const { getBuffer } = require('./index.cjs');
-
-async function downloadAndProcess() {
-  try {
-    const buffer = await getBuffer('https://example.com/image.png');
-    console.log('Buffer obtido com sucesso:', buffer.length, 'bytes');
-    // Faça algo com o buffer
-  } catch (error) {
-    console.error('Erro ao obter buffer:', error);
-  }
-}
-downloadAndProcess();
-```
-
-## Notas Importantes
-
-*   **Diretrizes `async`**: Lembre-se de que as operações do StickEngine são assíncronas. Certifique-se de usar `async/await` ou `.then().catch()` para lidar com as Promises retornadas, garantindo um código funcional e sem bloqueios.
-*   **`extractMetadata` (EXIF) sem `sharp`**: A implementação da manipulação de metadados (EXIF) foi cuidadosamente desenvolvida para **não depender da biblioteca `sharp`**. Esta decisão foi tomada para garantir a máxima compatibilidade e leveza do módulo, especialmente para usuários que executam o código em ambientes com recursos limitados, como o Termux, ou em hosts que não suportam a compilação de dependências nativas como o `sharp`. Agradecemos a compreensão, caro usuário! 👊🏻
-*   **Verificação de Atualizações**: Caso encontre algum erro na execução ou comportamento inesperado, verifique se os módulos e dependências foram atualizados. Em alguns casos, pode ser necessário obter a versão mais recente do arquivo.
-
-## Créditos
-
-Este módulo foi desenvolvido com base nas contribuições e inspiração de:
-
--   **Borutovk7** (GitHub: [Borutovk7](https://github.com/Borutovk7))
--   **Eduh Dev**
--   **Manus AI** (Adaptação e refatoração)
-
-## Licença
-
-Este projeto está licenciado sob a licença ISC. Veja o arquivo `LICENSE` para mais detalhes.

package/package.json.bak

@@ -1,49 +0,0 @@
-{
-  "name": "@boruto_vk7/stickengine",
-  "version": "0.0.1-alpha",
-  "description": "StickEngine module for creating WhatsApp stickers",
-  "type": "module",
-  "main": "dist/StickEngine.js",
-  "module": "dist/StickEngine.js",
-  "types": "dist/StickEngine.d.ts",
-  "exports": {
-    ".": {
-      "require": "./dist/StickEngine.js",
-      "import": "./dist/StickEngine.js",
-      "types": "./dist/StickEngine.d.ts"
-    }
-  },
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": [
-    "sticker",
-    "whatsapp",
-    "stickengine"
-  ],
-  "author": "Borutovk7 <https://github.com/Borutovk7>",
-  "contributors": [
-    "Eduh Dev",
-    "Manus AI"
-  ],
-  "license": "ISC",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Borutovk7/StickEngine.git"
-  },
-  "dependencies": {
-    "axios": "^1.6.0",
-    "file-type": "^16.5.3",
-    "fluent-ffmpeg": "^2.1.2",
-    "jimp": "^0.22.10",
-    "node-fetch": "^2.6.1",
-    "node-webpmux": "^1.0.7",
-    "remove.bg": "^1.3.0"
-  },
-  "devDependencies": {
-    "@types/fluent-ffmpeg": "^2.1.28",
-    "@types/node": "^25.9.2",
-    "@types/node-fetch": "2.6.1",
-    "typescript": "^6.0.3"
-  }
-}

package/src/StickEngine.ts

@@ -1,221 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import axios, { AxiosRequestConfig } from 'axios';
-import { exec } from 'child_process';
-import { EventEmitter } from 'events';
-import ffmpeg from 'fluent-ffmpeg';
-// @ts-ignore
-import webpMux from 'node-webpmux';
-// @ts-ignore
-import Jimp from 'jimp';
-// @ts-ignore
-import { removeBackgroundFromImageFile } from 'remove.bg';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-export interface StickerMetadata {
-  pack?: string;
-  author?: string;
-  emojis?: string[];
-}
-
-export interface StickEngineOptions {
-  webp?: boolean;
-  edit?: string | boolean;
-  convert?: boolean;
-  transparent?: string | string[] | false;
-  metadata?: StickerMetadata;
-}
-
-/**
- * Faz GET em uma URL e retorna o corpo como Buffer.
- * Fornecido pelo usuário para integração.
- */
-export const getBuffer = async (url: string, options: AxiosRequestConfig = {}): Promise<Buffer> => {
-  try {
-    const { data } = await axios({
-      method: 'get',
-      url,
-      headers: {
-        'user-agent': 'Mozilla/5.0 (Windows NT 6.3; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.128 Safari/537.36',
-        'DNT': '1',
-        'Upgrade-Insecure-Request': '1',
-      },
-      ...options,
-      responseType: 'arraybuffer',
-    });
-    return Buffer.from(data);
-  } catch (err) {
-    console.error(`Erro em getBuffer: ${err}`);
-    const errorImagePath = path.join(__dirname, 'src', 'emror.jpg');
-    if (fs.existsSync(errorImagePath)) {
-      return fs.readFileSync(errorImagePath);
-    }
-    return Buffer.alloc(0);
-  }
-};
-
-export class StickEngine extends EventEmitter {
-  public options: StickEngineOptions;
-  private tempDir: string;
-  private queue: any[];
-
-  constructor(options: StickEngineOptions = {}) {
-    super();
-    this.options = {
-      webp: true,
-      edit: false,
-      convert: false,
-      transparent: false,
-      metadata: {
-        pack: 'StickEngine',
-        author: 'Borutovk7 & Eduh Dev',
-        emojis: ['🥶']
-      },
-      ...options
-    };
-    this.tempDir = path.join(process.cwd(), 'tmp_stickengine');
-    if (!fs.existsSync(this.tempDir)) {
-      fs.mkdirSync(this.tempDir, { recursive: true });
-    }
-    this.queue = [];
-  }
-
-  public addFile(file: string | Buffer): this {
-    this.queue.push(file);
-    return this;
-  }
-
-  private async processFile(input: string | Buffer, index: number): Promise<string> {
-    let filePath: string;
-    let extension: string;
-    const timestamp = Date.now();
-
-    try {
-      this.emit('st.start', { index, input });
-
-      const ft = await import('file-type');
-      const fileTypeFunc = (ft as any).fromBuffer || (ft as any).fileTypeFromBuffer || (ft.default && ((ft.default as any).fromBuffer || (ft.default as any).fileTypeFromBuffer));
-
-      if (Buffer.isBuffer(input)) {
-        const type = await fileTypeFunc(input);
-        extension = type ? type.ext : 'bin';
-        filePath = path.join(this.tempDir, `input_${timestamp}_${index}.${extension}`);
-        fs.writeFileSync(filePath, input);
-      } else if (typeof input === 'string' && input.startsWith('http')) {
-        const buffer = await getBuffer(input);
-        const type = await fileTypeFunc(buffer);
-        extension = type ? type.ext : 'bin';
-        filePath = path.join(this.tempDir, `input_${timestamp}_${index}.${extension}`);
-        fs.writeFileSync(filePath, buffer);
-      } else if (typeof input === 'string' && fs.existsSync(input)) {
-        extension = path.extname(input).slice(1);
-        filePath = input;
-      } else {
-        throw new Error('Tipo de entrada inválido ou arquivo não encontrado.');
-      }
-
-      const metadata = await this.getMediaInfo(filePath);
-      this.emit('st.info', { index, ...metadata });
-
-      let currentFile = filePath;
-
-      if (this.options.transparent) {
-        const apiKey = Array.isArray(this.options.transparent) 
-          ? this.options.transparent[Math.floor(Math.random() * this.options.transparent.length)]
-          : this.options.transparent;
-        
-        if (typeof apiKey === 'string') {
-          const bgRemovedPath = path.join(this.tempDir, `nobg_${timestamp}_${index}.png`);
-          const result = await removeBackgroundFromImageFile({
-            path: currentFile,
-            apiKey,
-            size: 'auto',
-            type: 'auto'
-          });
-          fs.writeFileSync(bgRemovedPath, Buffer.from(result.base64img, 'base64'));
-          currentFile = bgRemovedPath;
-        }
-      }
-
-      const webpPath = path.join(this.tempDir, `sticker_${timestamp}_${index}.webp`);
-      await this.convertToWebp(currentFile, webpPath);
-      currentFile = webpPath;
-
-      if (this.options.metadata) {
-        await this.addExif(currentFile, this.options.metadata);
-      }
-
-      this.emit('st.data', { index, file: currentFile });
-      return currentFile;
-
-    } catch (error: any) {
-      this.emit('st.error', { index, error: error.message });
-      throw error;
-    }
-  }
-
-  private getMediaInfo(file: string): Promise<any> {
-    return new Promise((resolve, reject) => {
-      exec(`ffprobe -v error -select_streams v:0 -show_entries stream=width,height,duration -of csv=p=0:s=x ${file}`, (err, stdout) => {
-        if (err) return reject(err);
-        const [width, height, duration] = stdout.split('x');
-        resolve({
-          width: parseInt(width) || 0,
-          height: parseInt(height) || 0,
-          duration: parseFloat(duration) || 0
-        });
-      });
-    });
-  }
-
-  private convertToWebp(input: string, output: string): Promise<void> {
-    return new Promise((resolve, reject) => {
-      ffmpeg(input)
-        .on('error', reject)
-        .on('end', () => resolve())
-        .addOutputOptions([
-          '-vcodec', 'libwebp',
-          '-vf', 'scale=512:512:force_original_aspect_ratio=decrease,fps=15,pad=512:512:(ow-iw)/2:(oh-ih)/2:color=#00000000,setsar=1',
-          '-lossless', '1',
-          '-loop', '0',
-          '-preset', 'default',
-          '-an',
-          '-vsync', '0'
-        ])
-        .toFormat('webp')
-        .save(output);
-    });
-  }
-
-  private async addExif(webpPath: string, metadata: StickerMetadata): Promise<void> {
-    const json = {
-      'sticker-pack-id': 'StickEngine-Manus',
-      'sticker-pack-name': metadata.pack || 'StickEngine',
-      'sticker-pack-publisher': metadata.author || 'Borutovk7 & Eduh Dev',
-      'emojis': metadata.emojis || ['🥶']
-    };
-
-    const Image = webpMux.Image || (webpMux.default && webpMux.default.Image);
-    const img = new Image();
-    const exifAttr = Buffer.from([0x49, 0x49, 0x2A, 0x00, 0x08, 0x00, 0x00, 0x00, 0x01, 0x00, 0x41, 0x57, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x16, 0x00, 0x00, 0x00]);
-    const jsonBuff = Buffer.from(JSON.stringify(json), 'utf-8');
-    const exifBuffer = Buffer.concat([exifAttr, jsonBuff]);
-    exifBuffer.writeUIntLE(jsonBuff.length, 14, 4);
-
-    await img.load(webpPath);
-    img.exif = exifBuffer;
-    await img.save(webpPath);
-  }
-
-  public async start(): Promise<PromiseSettledResult<string>[]> {
-    if (this.queue.length === 0) throw new Error('Nenhum arquivo na fila.');
-    const results = await Promise.allSettled(this.queue.map((file, i) => this.processFile(file, i)));
-    this.queue = [];
-    return results;
-  }
-}
-
-export default StickEngine;

package/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "allowJs": true,
-    "resolveJsonModule": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}