@boruto_vk7/stickengine 0.0.6 → 1.0.1

package/dist/types/StickEngine.d.ts

@@ -0,0 +1,137 @@
+import { EventEmitter } from 'node:events';
+import { type AxiosRequestConfig } from 'axios';
+export interface StickerMetadata {
+    pack?: string;
+    author?: string;
+    emojis?: string[];
+    id?: string;
+}
+export interface JimpOptions {
+    greyscale?: boolean;
+    invert?: boolean;
+    sepia?: boolean;
+    blur?: number;
+    /** -1 .. 1 */
+    brightness?: number;
+    /** -1 .. 1 */
+    contrast?: number;
+    circle?: boolean;
+    resize?: {
+        width: number;
+        height: number;
+    };
+    text?: {
+        content: string;
+        alignmentX?: number;
+        alignmentY?: number;
+        color?: 'WHITE' | 'BLACK';
+        stroke?: boolean;
+    };
+}
+export interface StickEngineOptions {
+    /** Convert output to WebP sticker (default true). */
+    webp?: boolean;
+    /** Static-image edits via Jimp. */
+    edit?: JimpOptions | boolean;
+    /** remove.bg API key (string or list). Static images only. */
+    transparent?: string | string[] | false;
+    metadata?: StickerMetadata;
+    /**
+     * Delete temp files when you call `clean()`.
+     * Default false so you can read the sticker path first.
+     */
+    autoClean?: boolean;
+    /** Animated sticker FPS (default 15). */
+    fps?: number;
+    /** WebP quality 1–100 for animated (default 75). */
+    quality?: number;
+    /** Max animated duration in seconds (default 6). */
+    maxDuration?: number;
+    /** Temp directory (default ./tmp_stickengine). */
+    tempDir?: string;
+}
+export type StickInput = string | Buffer;
+export interface StickResult {
+    /** Absolute path to the final .webp */
+    path: string;
+    /** File as Buffer */
+    buffer: Buffer;
+    /** Base64 (no data: prefix) */
+    base64: string;
+    animated: boolean;
+    width: number;
+    height: number;
+    size: number;
+}
+export interface MediaInfo {
+    width: number;
+    height: number;
+    duration: number;
+}
+export declare function getBuffer(url: string, options?: AxiosRequestConfig): Promise<Buffer>;
+/**
+ * WhatsApp sticker engine (static + animated WebP + EXIF pack metadata).
+ *
+ * @example
+ * ```ts
+ * import StickEngine from '@boruto_vk7/stickengine';
+ *
+ * const sticker = await StickEngine.create('./cat.gif', {
+ *   metadata: { pack: 'My Pack', author: 'Me' },
+ * });
+ * // sticker.buffer  → send to WhatsApp
+ * // sticker.path    → temp file path
+ * ```
+ */
+export declare class StickEngine extends EventEmitter {
+    options: Required<Pick<StickEngineOptions, 'webp' | 'autoClean' | 'fps' | 'quality' | 'maxDuration'>> & StickEngineOptions;
+    private tempDir;
+    private queue;
+    private createdFiles;
+    constructor(options?: StickEngineOptions);
+    /**
+     * Create a sticker in one call. Returns path + buffer + base64.
+     */
+    static create(input: StickInput, options?: StickEngineOptions): Promise<StickResult>;
+    /**
+     * Create sticker and return only the Buffer (handy for bots).
+     */
+    static toBuffer(input: StickInput, options?: StickEngineOptions): Promise<Buffer>;
+    /**
+     * Create sticker and return base64 string.
+     */
+    static toBase64String(input: StickInput, options?: StickEngineOptions): Promise<string>;
+    /** Instance one-shot (uses constructor options). */
+    build(input: StickInput): Promise<StickResult>;
+    addFile(file: StickInput): this;
+    add(...files: StickInput[]): this;
+    /**
+     * Process the queue. Returns settled results with `value` = absolute path.
+     * Prefer `build()` / `StickEngine.create()` for a simpler API.
+     */
+    start(): Promise<PromiseSettledResult<string>[]>;
+    /** Delete tracked temp files. */
+    clean(): void;
+    private track;
+    private processFile;
+    private materializeInput;
+    /**
+     * Write WhatsApp sticker pack EXIF.
+     * Animated WebP MUST use muxAnim — save() throws on animations.
+     */
+    private addExif;
+    private detectAnimatedWebp;
+    private convertToWebp;
+    private applyJimpEdits;
+    private getMediaInfo;
+    static fileToBase64(filePath: string): string;
+    /** 96×96 tray icon WebP for sticker packs. */
+    createTrayIcon(input: StickInput): Promise<string>;
+    /** Text-only sticker (transparent 512×512). */
+    createTextSticker(text: string, options?: {
+        color?: 'WHITE' | 'BLACK';
+        background?: number | string;
+    }): Promise<StickResult>;
+}
+export default StickEngine;
+//# sourceMappingURL=StickEngine.d.ts.map

package/dist/types/StickEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StickEngine.d.ts","sourceRoot":"","sources":["../../src/StickEngine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAuBvD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAC7B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IACxC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB9F;AA0BD;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,SAAQ,YAAY;IACpC,OAAO,EAAE,QAAQ,CACtB,IAAI,CACF,kBAAkB,EAClB,MAAM,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,aAAa,CACzD,CACF,GACC,kBAAkB,CAAC;IAErB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,YAAY,CAAgB;gBAExB,OAAO,GAAE,kBAAuB;IAwB5C;;OAEG;WACU,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAS9F;;OAEG;WACU,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3F;;OAEG;WACU,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjG,oDAAoD;IAC9C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBpD,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAK/B,GAAG,CAAC,GAAG,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IAKjC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;IAOtD,iCAAiC;IACjC,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,KAAK;YAKC,WAAW;YA0EX,gBAAgB;IAgC9B;;;OAGG;YACW,OAAO;YAyHP,kBAAkB;YAkBlB,aAAa;YA0Db,cAAc;IAwC5B,OAAO,CAAC,YAAY;IA2BpB,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI7C,8CAA8C;IACxC,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BxD,+CAA+C;IACzC,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,GACxE,OAAO,CAAC,WAAW,CAAC;CAsBxB;AAED,eAAe,WAAW,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { StickEngine, getBuffer, type StickEngineOptions, type StickerMetadata, type JimpOptions, type StickInput, type StickResult, type MediaInfo, } from './StickEngine.js';
+export { StickEngine as default } from './StickEngine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,50 +1,73 @@
 {
   "name": "@boruto_vk7/stickengine",
-  "version": "0.0.6",
-  "description": "StickEngine module for creating WhatsApp stickers",
+  "version": "1.0.1",
+  "description": "Simple WhatsApp sticker engine — static & animated WebP, EXIF pack metadata, ESM + CommonJS.",
+  "author": "Borutovk7",
+  "contributors": [
+    "Eduh Dev"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "whatsapp",
+    "sticker",
+    "webp",
+    "animated",
+    "stickengine",
+    "baileys",
+    "wbot"
+  ],
   "type": "module",
-  "main": "dist/StickEngine.js",
-  "module": "dist/StickEngine.js",
-  "types": "dist/StickEngine.d.ts",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
-      "require": "./dist/StickEngine.js",
-      "import": "./dist/StickEngine.js",
-      "types": "./dist/StickEngine.d.ts"
-    }
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
+    },
+    "./package.json": "./package.json"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
-    "build": "tsc",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "clean": "node ./scripts/clean.mjs",
+    "build:esm": "tsc -p tsconfig.esm.json && node ./scripts/fix-esm-dirname.mjs && node ./scripts/copy-assets.mjs esm",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node ./scripts/copy-assets.mjs cjs && node ./scripts/write-cjs-package.mjs",
+    "build:types": "tsc -p tsconfig.types.json",
+    "build": "npm run clean && npm run build:esm && npm run build:cjs && npm run build:types",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
   },
-  "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"
+    "url": "git+https://github.com/Borutovk7/StickEngine.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Borutovk7/StickEngine/issues"
   },
+  "homepage": "https://github.com/Borutovk7/StickEngine#readme",
   "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",
+    "file-type": "^16.5.4",
+    "fluent-ffmpeg": "^2.1.3",
+    "jimp": "^0.22.12",
+    "node-webpmux": "^3.1.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"
+    "@types/fluent-ffmpeg": "^2.1.27",
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.4"
   }
 }

package/dist/StickEngine.d.ts

@@ -1,72 +0,0 @@
-import { AxiosRequestConfig } from 'axios';
-import { EventEmitter } from 'events';
-export interface StickerMetadata {
-    pack?: string;
-    author?: string;
-    emojis?: string[];
-}
-export interface JimpOptions {
-    greyscale?: boolean;
-    invert?: boolean;
-    sepia?: boolean;
-    blur?: number;
-    brightness?: number;
-    contrast?: number;
-    circle?: boolean;
-    resize?: {
-        width: number;
-        height: number;
-    };
-    text?: {
-        content: string;
-        alignmentX?: number;
-        alignmentY?: number;
-        color?: 'WHITE' | 'BLACK';
-        stroke?: boolean;
-    };
-}
-export interface StickEngineOptions {
-    webp?: boolean;
-    edit?: JimpOptions | boolean;
-    convert?: boolean;
-    transparent?: string | string[] | false;
-    metadata?: StickerMetadata;
-    autoClean?: boolean;
-    fps?: number;
-    quality?: number;
-}
-/**
- * Faz GET em uma URL e retorna o corpo como Buffer.
- */
-export declare const getBuffer: (url: string, options?: AxiosRequestConfig) => Promise<Buffer>;
-export declare class StickEngine extends EventEmitter {
-    options: StickEngineOptions;
-    private tempDir;
-    private queue;
-    private createdFiles;
-    constructor(options?: StickEngineOptions);
-    addFile(file: string | Buffer): this;
-    clean(): void;
-    private processFile;
-    private applyJimpEdits;
-    private getMediaInfo;
-    private convertToWebp;
-    private addExif;
-    start(): Promise<PromiseSettledResult<string>[]>;
-    /**
-     * Converte um arquivo em Base64.
-     */
-    static toBase64(filePath: string): string;
-    /**
-     * Gera um ícone de bandeja (Tray Icon) 96x96 para o pacote de figurinhas.
-     */
-    createTrayIcon(input: string | Buffer): Promise<string>;
-    /**
-     * Cria uma figurinha de texto do zero (TP).
-     */
-    createTextSticker(text: string, options?: {
-        color?: 'WHITE' | 'BLACK';
-        background?: string;
-    }): Promise<string>;
-}
-export default StickEngine;