@kaikybrofc/omnizap-system 2.2.10 → 2.3.0

package/app/modules/stickerPackModule/stickerObjectStorageService.js

@@ -14,15 +14,22 @@ const parseEnvBool = (value, fallback) => {
 const OBJECT_STORAGE_ENABLED = parseEnvBool(process.env.STICKER_OBJECT_STORAGE_ENABLED, false);
 const OBJECT_STORAGE_UPLOAD_ON_WRITE = parseEnvBool(process.env.STICKER_OBJECT_STORAGE_UPLOAD_ON_WRITE, true);
 const OBJECT_STORAGE_SIGNED_URL_ENABLED = parseEnvBool(process.env.STICKER_OBJECT_STORAGE_SIGNED_URL_ENABLED, true);
-const OBJECT_STORAGE_PROVIDER = String(process.env.STICKER_OBJECT_STORAGE_PROVIDER || 's3').trim().toLowerCase();
+const OBJECT_STORAGE_PROVIDER = String(process.env.STICKER_OBJECT_STORAGE_PROVIDER || 's3')
+  .trim()
+  .toLowerCase();
 const OBJECT_STORAGE_BUCKET = String(process.env.STICKER_OBJECT_STORAGE_BUCKET || '').trim();
 const OBJECT_STORAGE_REGION = String(process.env.STICKER_OBJECT_STORAGE_REGION || 'us-east-1').trim() || 'us-east-1';
 const OBJECT_STORAGE_ENDPOINT = String(process.env.STICKER_OBJECT_STORAGE_ENDPOINT || '').trim();
 const OBJECT_STORAGE_ACCESS_KEY_ID = String(process.env.STICKER_OBJECT_STORAGE_ACCESS_KEY_ID || '').trim();
 const OBJECT_STORAGE_SECRET_ACCESS_KEY = String(process.env.STICKER_OBJECT_STORAGE_SECRET_ACCESS_KEY || '').trim();
 const OBJECT_STORAGE_FORCE_PATH_STYLE = parseEnvBool(process.env.STICKER_OBJECT_STORAGE_FORCE_PATH_STYLE, true);
-const OBJECT_STORAGE_CDN_BASE_URL = String(process.env.STICKER_OBJECT_STORAGE_CDN_BASE_URL || '').trim().replace(/\/+$/, '');
-const OBJECT_STORAGE_KEY_PREFIX = String(process.env.STICKER_OBJECT_STORAGE_KEY_PREFIX || 'stickers').trim().replace(/^\/+|\/+$/g, '') || 'stickers';
+const OBJECT_STORAGE_CDN_BASE_URL = String(process.env.STICKER_OBJECT_STORAGE_CDN_BASE_URL || '')
+  .trim()
+  .replace(/\/+$/, '');
+const OBJECT_STORAGE_KEY_PREFIX =
+  String(process.env.STICKER_OBJECT_STORAGE_KEY_PREFIX || 'stickers')
+    .trim()
+    .replace(/^\/+|\/+$/g, '') || 'stickers';
 
 let sdkLoadState = {
   loaded: false,
@@ -36,7 +43,9 @@ let s3Client = null;
 
 const safeOwnerToken = (ownerJid) => {
   const normalized = normalizeOwnerJid(ownerJid);
-  const token = String(normalized || 'unknown').replace(/[^a-zA-Z0-9._-]/g, '_').slice(0, 100);
+  const token = String(normalized || 'unknown')
+    .replace(/[^a-zA-Z0-9._-]/g, '_')
+    .slice(0, 100);
   return token || 'unknown';
 };
 
@@ -62,7 +71,9 @@ const resolveStickerObjectKey = (asset) => {
   const fromStoragePath = parseS3StoragePath(asset?.storage_path);
   if (fromStoragePath?.key) return fromStoragePath.key;
   const ownerToken = safeOwnerToken(asset?.owner_jid || 'unknown');
-  const sha256 = String(asset?.sha256 || '').trim().toLowerCase();
+  const sha256 = String(asset?.sha256 || '')
+    .trim()
+    .toLowerCase();
   if (!sha256) return '';
   return `${OBJECT_STORAGE_KEY_PREFIX}/${ownerToken}/${sha256}.webp`;
 };
@@ -70,10 +81,7 @@ const resolveStickerObjectKey = (asset) => {
 const loadAwsSdk = async () => {
   if (sdkLoadState.loaded) return sdkLoadState;
   try {
-    const [{ S3Client, PutObjectCommand, GetObjectCommand }, { getSignedUrl }] = await Promise.all([
-      import('@aws-sdk/client-s3'),
-      import('@aws-sdk/s3-request-presigner'),
-    ]);
+    const [{ S3Client, PutObjectCommand, GetObjectCommand }, { getSignedUrl }] = await Promise.all([import('@aws-sdk/client-s3'), import('@aws-sdk/s3-request-presigner')]);
     sdkLoadState = {
       loaded: true,
       warned: false,
@@ -149,15 +157,9 @@ const streamToBuffer = async (body) => {
   return null;
 };
 
-export const isStickerObjectStorageEnabled = () =>
-  Boolean(OBJECT_STORAGE_ENABLED && OBJECT_STORAGE_PROVIDER === 's3' && OBJECT_STORAGE_BUCKET);
+export const isStickerObjectStorageEnabled = () => Boolean(OBJECT_STORAGE_ENABLED && OBJECT_STORAGE_PROVIDER === 's3' && OBJECT_STORAGE_BUCKET);
 
-export const uploadStickerToObjectStorage = async ({
-  ownerJid,
-  sha256,
-  buffer,
-  mimetype = 'image/webp',
-} = {}) => {
+export const uploadStickerToObjectStorage = async ({ ownerJid, sha256, buffer, mimetype = 'image/webp' } = {}) => {
   if (!OBJECT_STORAGE_UPLOAD_ON_WRITE || !Buffer.isBuffer(buffer) || !buffer.length) {
     return { uploaded: false, key: null };
   }
@@ -165,7 +167,9 @@ export const uploadStickerToObjectStorage = async ({
     return { uploaded: false, key: null };
   }
 
-  const key = `${OBJECT_STORAGE_KEY_PREFIX}/${safeOwnerToken(ownerJid)}/${String(sha256 || '').trim().toLowerCase()}.webp`;
+  const key = `${OBJECT_STORAGE_KEY_PREFIX}/${safeOwnerToken(ownerJid)}/${String(sha256 || '')
+    .trim()
+    .toLowerCase()}.webp`;
   if (!key || key.endsWith('/.webp')) return { uploaded: false, key: null };
 
   try {
@@ -194,13 +198,7 @@ export const uploadStickerToObjectStorage = async ({
   }
 };
 
-export const getStickerObjectStorageUrl = async (
-  asset,
-  {
-    secure = true,
-    expiresInSeconds = 300,
-  } = {},
-) => {
+export const getStickerObjectStorageUrl = async (asset, { secure = true, expiresInSeconds = 300 } = {}) => {
   if (!isStickerObjectStorageEnabled()) return null;
 
   const key = resolveStickerObjectKey(asset);
@@ -279,7 +277,9 @@ export const toStickerStoragePath = ({ localPath, ownerJid, sha256 }) => {
   const normalizedLocalPath = path.resolve(String(localPath || ''));
   if (!isStickerObjectStorageEnabled()) return normalizedLocalPath;
   if (!OBJECT_STORAGE_UPLOAD_ON_WRITE) return normalizedLocalPath;
-  const key = `${OBJECT_STORAGE_KEY_PREFIX}/${safeOwnerToken(ownerJid)}/${String(sha256 || '').trim().toLowerCase()}.webp`;
+  const key = `${OBJECT_STORAGE_KEY_PREFIX}/${safeOwnerToken(ownerJid)}/${String(sha256 || '')
+    .trim()
+    .toLowerCase()}.webp`;
   if (!key || key.endsWith('/.webp')) return normalizedLocalPath;
   return `s3://${OBJECT_STORAGE_BUCKET}/${key}`;
 };

package/app/modules/stickerPackModule/stickerPackCommandHandlers.js

@@ -3,10 +3,7 @@ import { sendAndStore } from '../../services/messagePersistenceService.js';
 import { isUserJid } from '../../config/baileysConfig.js';
 import stickerPackService from './stickerPackServiceRuntime.js';
 import { STICKER_PACK_ERROR_CODES, StickerPackError } from './stickerPackErrors.js';
-import {
-  captureIncomingStickerAsset,
-  resolveStickerAssetForCommand,
-} from './stickerStorageService.js';
+import { captureIncomingStickerAsset, resolveStickerAssetForCommand } from './stickerStorageService.js';
 import { buildStickerPackMessage, sendStickerPackWithFallback } from './stickerPackMessageService.js';
 import { sanitizeText } from './stickerPackUtils.js';
 
@@ -221,10 +218,7 @@ const buildPackVisualMessage = ({ intro = [], sections = [], footer = [] }) => {
 const buildActionMessage = ({ title, explanation = [], details = [], nextSteps = [], footer = [] }) =>
   buildPackVisualMessage({
     intro: [title, ...normalizeMessageLines(explanation)],
-    sections: [
-      normalizeMessageLines(details).length ? { title: '📌 *DETALHES*', lines: details } : null,
-      normalizeMessageLines(nextSteps).length ? { title: '➡️ *PRÓXIMAS AÇÕES*', lines: nextSteps } : null,
-    ],
+    sections: [normalizeMessageLines(details).length ? { title: '📌 *DETALHES*', lines: details } : null, normalizeMessageLines(nextSteps).length ? { title: '➡️ *PRÓXIMAS AÇÕES*', lines: nextSteps } : null],
     footer,
   });
 
@@ -238,18 +232,11 @@ const buildActionMessage = ({ title, explanation = [], details = [], nextSteps =
 const formatPackList = (packs, prefix) => {
   if (!packs.length) {
     return buildPackVisualMessage({
-      intro: [
-        '📭 *Nenhum pack extra encontrado.*',
-        'As figurinhas que você cria continuam sendo salvas automaticamente no seu *Pack Principal*.',
-      ],
+      intro: ['📭 *Nenhum pack extra encontrado.*', 'As figurinhas que você cria continuam sendo salvas automaticamente no seu *Pack Principal*.'],
       sections: [
         {
           title: '🆕 *COMECE EM 3 PASSOS*',
-          lines: [
-            `1) Crie um pack: \`${prefix}pack create meupack\``,
-            `2) Responda uma figurinha e adicione: \`${prefix}pack add <pack>\``,
-            `3) Veja o resumo: \`${prefix}pack info <pack>\``,
-          ],
+          lines: [`1) Crie um pack: \`${prefix}pack create meupack\``, `2) Responda uma figurinha e adicione: \`${prefix}pack add <pack>\``, `3) Veja o resumo: \`${prefix}pack info <pack>\``],
         },
       ],
       footer: ['💡 Dica: crie packs por tema (memes, animes, reactions) para achar tudo mais rápido.'],
@@ -258,28 +245,16 @@ const formatPackList = (packs, prefix) => {
 
   const lines = packs.map((pack, index) => {
     const count = Number(pack.sticker_count || 0);
-    return [
-      `${index + 1}. *${pack.name}*`,
-      `   🆔 ID: \`${pack.pack_key}\``,
-      `   🧩 Itens: ${count}/${MAX_PACK_ITEMS}`,
-      `   👁️ Visibilidade: ${formatVisibilityLabel(pack.visibility)}`,
-    ].join('\n');
+    return [`${index + 1}. *${pack.name}*`, `   🆔 ID: \`${pack.pack_key}\``, `   🧩 Itens: ${count}/${MAX_PACK_ITEMS}`, `   👁️ Visibilidade: ${formatVisibilityLabel(pack.visibility)}`].join('\n');
   });
 
   return buildPackVisualMessage({
-    intro: [
-      `📋 *Packs encontrados: ${packs.length}*`,
-      'Você pode usar o *nome* ou o *ID* do pack para ver detalhes, editar ou enviar.',
-    ],
+    intro: [`📋 *Packs encontrados: ${packs.length}*`, 'Você pode usar o *nome* ou o *ID* do pack para ver detalhes, editar ou enviar.'],
     sections: [
       { title: '📦 *SEUS PACKS*', lines },
       {
         title: '🛠 *ATALHOS*',
-        lines: [
-          `ℹ️ Detalhes: \`${prefix}pack info <pack>\``,
-          `📤 Enviar: \`${prefix}pack send <pack>\``,
-          `🆕 Criar novo: \`${prefix}pack create meupack\``,
-        ],
+        lines: [`ℹ️ Detalhes: \`${prefix}pack info <pack>\``, `📤 Enviar: \`${prefix}pack send <pack>\``, `🆕 Criar novo: \`${prefix}pack create meupack\``],
       },
     ],
     footer: ['✅ Tudo pronto — escolha um pack e continue gerenciando.'],
@@ -307,22 +282,11 @@ const formatPackInfo = (pack, prefix) => {
   }
 
   return buildPackVisualMessage({
-    intro: [
-      `ℹ️ *Informações do pack: "${pack.name}"*`,
-      'Aqui você vê identificação, visibilidade e uma prévia dos itens cadastrados.',
-    ],
+    intro: [`ℹ️ *Informações do pack: "${pack.name}"*`, 'Aqui você vê identificação, visibilidade e uma prévia dos itens cadastrados.'],
     sections: [
       {
         title: '📌 *DADOS DO PACK*',
-        lines: [
-          `📛 Nome: *${pack.name}*`,
-          `🆔 ID: \`${pack.pack_key}\``,
-          `👤 Publisher: *${pack.publisher}*`,
-          `👁️ Visibilidade: ${formatVisibilityLabel(pack.visibility)}`,
-          `🧩 Itens: *${pack.items.length}/${MAX_PACK_ITEMS}*`,
-          `🖼️ Capa: *${coverLabel}*`,
-          `📝 Descrição: ${pack.description ? `"${pack.description}"` : 'não definida'}`,
-        ],
+        lines: [`📛 Nome: *${pack.name}*`, `🆔 ID: \`${pack.pack_key}\``, `👤 Publisher: *${pack.publisher}*`, `👁️ Visibilidade: ${formatVisibilityLabel(pack.visibility)}`, `🧩 Itens: *${pack.items.length}/${MAX_PACK_ITEMS}*`, `🖼️ Capa: *${coverLabel}*`, `📝 Descrição: ${pack.description ? `"${pack.description}"` : 'não definida'}`],
       },
       {
         title: '🖼️ *PRÉVIA (ATÉ 12 ITENS)*',
@@ -330,12 +294,7 @@ const formatPackInfo = (pack, prefix) => {
       },
       {
         title: '⚙️ *AÇÕES DISPONÍVEIS*',
-        lines: [
-          `➕ Adicionar: \`${prefix}pack add ${pack.pack_key}\``,
-          `🖼 Definir capa: \`${prefix}pack setcover ${pack.pack_key}\``,
-          `🔀 Reordenar: \`${prefix}pack reorder ${pack.pack_key} 1 2 3 ...\``,
-          `📤 Enviar: \`${prefix}pack send ${pack.pack_key}\``,
-        ],
+        lines: [`➕ Adicionar: \`${prefix}pack add ${pack.pack_key}\``, `🖼 Definir capa: \`${prefix}pack setcover ${pack.pack_key}\``, `🔀 Reordenar: \`${prefix}pack reorder ${pack.pack_key} 1 2 3 ...\``, `📤 Enviar: \`${prefix}pack send ${pack.pack_key}\``],
       },
     ],
     footer: ['💡 Se precisar, use o guia completo com `pack` para ver exemplos e comandos extras.'],
@@ -348,45 +307,7 @@ const formatPackInfo = (pack, prefix) => {
  * @param {string} prefix Prefixo de comando.
  * @returns {string} Guia textual.
  */
-const buildPackHelp = (prefix) =>
-  [
-    '📦 *PACKS DE FIGURINHAS — GUIA RÁPIDO*',
-    '',
-    'Toda figurinha que você criar é salva automaticamente no seu *Pack Principal*.',
-    'Além disso, você pode criar packs extras para organizar por tema e enviar mais rápido.',
-    '',
-    PACK_VISUAL_DIVIDER,
-    '🧭 *COMANDOS PRINCIPAIS*',
-    '',
-    '🆕 Criar um pack',
-    `\`${prefix}pack create "Meus memes 😂" | publisher="Seu Nome" | desc="Descrição"\``,
-    '_Nome livre: espaços e emojis são permitidos._',
-    '',
-    '📋 Listar packs',
-    `\`${prefix}pack list\``,
-    '',
-    'ℹ️ Ver detalhes do pack',
-    `\`${prefix}pack info <pack>\``,
-    '',
-    '➕ Adicionar figurinha',
-    `\`${prefix}pack add <pack>\``,
-    '_Dica: responda uma figurinha (ou use a última enviada)._',
-    '',
-    '🖼 Definir capa',
-    `\`${prefix}pack setcover <pack>\``,
-    '',
-    '📤 Enviar pack no chat',
-    `\`${prefix}pack send "<nome do pack>"\``,
-    `_Ou use o ID: \`${prefix}pack send <pack_id>\`_`,
-    '',
-    PACK_VISUAL_DIVIDER,
-    '🧰 *COMANDOS EXTRAS*',
-    '',
-    '`rename` • `setpub` • `setdesc` • `remove` • `reorder` • `clone` • `publish` • `delete`',
-    '',
-    PACK_VISUAL_DIVIDER,
-    '✅ *Pronto!* Se quiser, diga o que você quer fazer (criar, organizar, enviar) que eu te guio.',
-  ].join('\n');
+const buildPackHelp = (prefix) => ['📦 *PACKS DE FIGURINHAS — GUIA RÁPIDO*', '', 'Toda figurinha que você criar é salva automaticamente no seu *Pack Principal*.', 'Além disso, você pode criar packs extras para organizar por tema e enviar mais rápido.', '', PACK_VISUAL_DIVIDER, '🧭 *COMANDOS PRINCIPAIS*', '', '🆕 Criar um pack', `\`${prefix}pack create "Meus memes 😂" | publisher="Seu Nome" | desc="Descrição"\``, '_Nome livre: espaços e emojis são permitidos._', '', '📋 Listar packs', `\`${prefix}pack list\``, '', 'ℹ️ Ver detalhes do pack', `\`${prefix}pack info <pack>\``, '', '➕ Adicionar figurinha', `\`${prefix}pack add <pack>\``, '_Dica: responda uma figurinha (ou use a última enviada)._', '', '🖼 Definir capa', `\`${prefix}pack setcover <pack>\``, '', '📤 Enviar pack no chat', `\`${prefix}pack send "<nome do pack>"\``, `_Ou use o ID: \`${prefix}pack send <pack_id>\`_`, '', PACK_VISUAL_DIVIDER, '🧰 *COMANDOS EXTRAS*', '', '`rename` • `setpub` • `setdesc` • `remove` • `reorder` • `clone` • `publish` • `delete`', '', PACK_VISUAL_DIVIDER, '✅ *Pronto!* Se quiser, diga o que você quer fazer (criar, organizar, enviar) que eu te guio.'].join('\n');
 
 /**
  * Template visual de erro orientado a resolução.
@@ -430,41 +351,28 @@ const formatErrorMessage = (error, commandPrefix) => {
       return buildErrorMessage({
         title: '🔎 *Pack não encontrado.*',
         explanation: ['Não localizei um pack com esse nome ou ID.'],
-        steps: [
-          `Veja a lista com \`${commandPrefix}pack list\`.`,
-          'Copie o ID exatamente como aparece.',
-          `Depois tente novamente (ex.: \`${commandPrefix}pack info <pack>\`).`,
-        ],
+        steps: [`Veja a lista com \`${commandPrefix}pack list\`.`, 'Copie o ID exatamente como aparece.', `Depois tente novamente (ex.: \`${commandPrefix}pack info <pack>\`).`],
         commandPrefix,
       });
     case STICKER_PACK_ERROR_CODES.DUPLICATE_STICKER:
       return buildErrorMessage({
         title: '⚠️ *Essa figurinha já está no pack.*',
         explanation: ['Para manter o pack organizado, não adiciono itens duplicados.'],
-        steps: [
-          `Veja os itens com \`${commandPrefix}pack info <pack>\`.`,
-          'Se quiser reorganizar, use `reorder`.',
-        ],
+        steps: [`Veja os itens com \`${commandPrefix}pack info <pack>\`.`, 'Se quiser reorganizar, use `reorder`.'],
         commandPrefix,
       });
     case STICKER_PACK_ERROR_CODES.PACK_LIMIT_REACHED:
       return buildErrorMessage({
         title: '⚠️ *Limite de figurinhas atingido.*',
         explanation: [error.message || 'Este pack já está no limite e não aceita novos itens no momento.'],
-        steps: [
-          `Crie outro pack: \`${commandPrefix}pack create novopack\`.`,
-          'Depois continue adicionando as próximas figurinhas no novo pack.',
-        ],
+        steps: [`Crie outro pack: \`${commandPrefix}pack create novopack\`.`, 'Depois continue adicionando as próximas figurinhas no novo pack.'],
         commandPrefix,
       });
     case STICKER_PACK_ERROR_CODES.STICKER_NOT_FOUND:
       return buildErrorMessage({
         title: '🧩 *Não encontrei uma figurinha válida para usar.*',
         explanation: ['Para esse comando, você precisa responder uma figurinha ou ter uma figurinha recente no contexto.'],
-        steps: [
-          'Responda diretamente a figurinha que você quer usar.',
-          'Ou envie uma figurinha e execute o comando novamente.',
-        ],
+        steps: ['Responda diretamente a figurinha que você quer usar.', 'Ou envie uma figurinha e execute o comando novamente.'],
         commandPrefix,
       });
     case STICKER_PACK_ERROR_CODES.INVALID_INPUT:
@@ -621,16 +529,7 @@ const resolveStickerFromCommandContext = async ({ messageInfo, ownerJid, include
  * }} params Contexto da requisição.
  * @returns {Promise<void>}
  */
-export async function handlePackCommand({
-  sock,
-  remoteJid,
-  messageInfo,
-  expirationMessage,
-  senderJid,
-  senderName,
-  text,
-  commandPrefix,
-}) {
+export async function handlePackCommand({ sock, remoteJid, messageInfo, expirationMessage, senderJid, senderName, text, commandPrefix }) {
   const ownerJid = senderJid;
   const rate = checkRateLimit(ownerJid);
 
@@ -682,16 +581,8 @@ export async function handlePackCommand({
           text: buildActionMessage({
             title: '✅ *Pack criado!*',
             explanation: ['Seu pack já está disponível e pronto para receber figurinhas.'],
-            details: [
-              `📛 Nome: *${created.name}*`,
-              `🆔 ID: \`${created.pack_key}\``,
-              `👤 Publisher: *${created.publisher}*`,
-              `👁️ Visibilidade: ${formatVisibilityLabel(created.visibility)}`,
-            ],
-            nextSteps: [
-              `Responda uma figurinha e use: \`${commandPrefix}pack add ${created.pack_key}\`.`,
-              `Para conferir: \`${commandPrefix}pack info ${created.pack_key}\`.`,
-            ],
+            details: [`📛 Nome: *${created.name}*`, `🆔 ID: \`${created.pack_key}\``, `👤 Publisher: *${created.publisher}*`, `👁️ Visibilidade: ${formatVisibilityLabel(created.visibility)}`],
+            nextSteps: [`Responda uma figurinha e use: \`${commandPrefix}pack add ${created.pack_key}\`.`, `Para conferir: \`${commandPrefix}pack info ${created.pack_key}\`.`],
             footer: ['💡 Dica: use packs por tema para organizar e enviar mais rápido.'],
           }),
         });
@@ -759,9 +650,7 @@ export async function handlePackCommand({
             title: '👤 *Publisher atualizado!*',
             explanation: ['O publisher deste pack foi ajustado e já aparece nas informações.'],
             details: [`📦 Pack: *${updated.name}*`, `👤 Publisher: *${updated.publisher}*`, `🆔 ID: \`${updated.pack_key}\``],
-            nextSteps: [
-              `Se quiser, ajuste a descrição: \`${commandPrefix}pack setdesc ${updated.pack_key} "Nova descrição"\`.`,
-            ],
+            nextSteps: [`Se quiser, ajuste a descrição: \`${commandPrefix}pack setdesc ${updated.pack_key} "Nova descrição"\`.`],
           }),
         });
         return;
@@ -780,10 +669,7 @@ export async function handlePackCommand({
           text: buildActionMessage({
             title: '📝 *Descrição atualizada!*',
             explanation: ['A descrição ajuda a identificar o tema do pack.'],
-            details: [
-              `📦 Pack: *${updated.name}*`,
-              description ? `📝 Descrição: "${updated.description}"` : '🧹 Descrição removida.',
-            ],
+            details: [`📦 Pack: *${updated.name}*`, description ? `📝 Descrição: "${updated.description}"` : '🧹 Descrição removida.'],
             nextSteps: [`Ver como ficou: \`${commandPrefix}pack info ${updated.pack_key}\`.`],
           }),
         });
@@ -795,10 +681,7 @@ export async function handlePackCommand({
         const asset = await resolveStickerFromCommandContext({ messageInfo, ownerJid });
 
         if (!asset) {
-          throw new StickerPackError(
-            STICKER_PACK_ERROR_CODES.STICKER_NOT_FOUND,
-            'Não encontrei uma figurinha para definir como capa.',
-          );
+          throw new StickerPackError(STICKER_PACK_ERROR_CODES.STICKER_NOT_FOUND, 'Não encontrei uma figurinha para definir como capa.');
         }
 
         const updated = await stickerPackService.setPackCover({
@@ -829,10 +712,7 @@ export async function handlePackCommand({
 
         const asset = await resolveStickerFromCommandContext({ messageInfo, ownerJid });
         if (!asset) {
-          throw new StickerPackError(
-            STICKER_PACK_ERROR_CODES.STICKER_NOT_FOUND,
-            'Não encontrei uma figurinha para adicionar.',
-          );
+          throw new StickerPackError(STICKER_PACK_ERROR_CODES.STICKER_NOT_FOUND, 'Não encontrei uma figurinha para adicionar.');
         }
 
         const updated = await stickerPackService.addStickerToPack({
@@ -851,15 +731,8 @@ export async function handlePackCommand({
           text: buildActionMessage({
             title: '➕ *Figurinha adicionada!*',
             explanation: ['Item adicionado com sucesso ao pack selecionado.'],
-            details: [
-              `📦 Pack: *${updated.name}*`,
-              `🧩 Itens: *${updated.items.length}/${MAX_PACK_ITEMS}*`,
-              `🆔 ID: \`${updated.pack_key}\``,
-            ],
-            nextSteps: [
-              `Definir como capa: responda a figurinha e use \`${commandPrefix}pack setcover ${updated.pack_key}\`.`,
-              `Ver lista completa: \`${commandPrefix}pack info ${updated.pack_key}\`.`,
-            ],
+            details: [`📦 Pack: *${updated.name}*`, `🧩 Itens: *${updated.items.length}/${MAX_PACK_ITEMS}*`, `🆔 ID: \`${updated.pack_key}\``],
+            nextSteps: [`Definir como capa: responda a figurinha e use \`${commandPrefix}pack setcover ${updated.pack_key}\`.`, `Ver lista completa: \`${commandPrefix}pack info ${updated.pack_key}\`.`],
           }),
         });
         return;
@@ -883,11 +756,7 @@ export async function handlePackCommand({
           text: buildActionMessage({
             title: '🗑️ *Figurinha removida!*',
             explanation: ['Remoção concluída e o pack foi reordenado automaticamente.'],
-            details: [
-              `📦 Pack: *${result.pack.name}*`,
-              `🔢 Item removido: figurinha #${result.removed.position}`,
-              `🧩 Itens: *${result.pack.items.length}/${MAX_PACK_ITEMS}*`,
-            ],
+            details: [`📦 Pack: *${result.pack.name}*`, `🔢 Item removido: figurinha #${result.removed.position}`, `🧩 Itens: *${result.pack.items.length}/${MAX_PACK_ITEMS}*`],
             nextSteps: [`Conferir: \`${commandPrefix}pack info ${result.pack.pack_key}\`.`],
           }),
         });
@@ -942,10 +811,7 @@ export async function handlePackCommand({
             title: '🧬 *Clone criado!*',
             explanation: ['O pack foi duplicado com as mesmas figurinhas e configurações.'],
             details: [`📦 Novo pack: *${cloned.name}*`, `🆔 ID: \`${cloned.pack_key}\``],
-            nextSteps: [
-              `Renomear: \`${commandPrefix}pack rename ${cloned.pack_key} novonome\`.`,
-              `Enviar: \`${commandPrefix}pack send ${cloned.pack_key}\`.`,
-            ],
+            nextSteps: [`Renomear: \`${commandPrefix}pack rename ${cloned.pack_key} novonome\`.`, `Enviar: \`${commandPrefix}pack send ${cloned.pack_key}\`.`],
           }),
         });
         return;
@@ -988,11 +854,7 @@ export async function handlePackCommand({
           text: buildActionMessage({
             title: '🌐 *Visibilidade atualizada!*',
             explanation: ['A configuração de privacidade foi aplicada ao pack.'],
-            details: [
-              `📦 Pack: *${updated.name}*`,
-              `👁️ Visibilidade: ${formatVisibilityLabel(updated.visibility)}`,
-              `🆔 ID: \`${updated.pack_key}\``,
-            ],
+            details: [`📦 Pack: *${updated.name}*`, `👁️ Visibilidade: ${formatVisibilityLabel(updated.visibility)}`, `🆔 ID: \`${updated.pack_key}\``],
             nextSteps: [`Compartilhar/enviar: \`${commandPrefix}pack send ${updated.pack_key}\`.`],
           }),
         });
@@ -1020,15 +882,8 @@ export async function handlePackCommand({
             text: buildActionMessage({
               title: '📤 *Pack enviado!*',
               explanation: ['Enviei no formato nativo (melhor experiência e compatibilidade).'],
-              details: [
-                `📦 Pack: *${packDetails.name}*`,
-                `🆔 ID: \`${packDetails.pack_key}\``,
-                `🧩 Enviadas: *${sendResult.sentCount} figurinha(s)*`,
-              ],
-              nextSteps: [
-                `Ver detalhes: \`${commandPrefix}pack info ${packDetails.pack_key}\`.`,
-                `Editar: \`${commandPrefix}pack add ${packDetails.pack_key}\` ou \`${commandPrefix}pack remove ${packDetails.pack_key} <item>\`.`,
-              ],
+              details: [`📦 Pack: *${packDetails.name}*`, `🆔 ID: \`${packDetails.pack_key}\``, `🧩 Enviadas: *${sendResult.sentCount} figurinha(s)*`],
+              nextSteps: [`Ver detalhes: \`${commandPrefix}pack info ${packDetails.pack_key}\`.`, `Editar: \`${commandPrefix}pack add ${packDetails.pack_key}\` ou \`${commandPrefix}pack remove ${packDetails.pack_key} <item>\`.`],
             }),
           });
         } else {
@@ -1039,19 +894,9 @@ export async function handlePackCommand({
             expirationMessage,
             text: buildActionMessage({
               title: 'ℹ️ *Pack enviado em modo compatível.*',
-              explanation: [
-                `O cliente não aceitou o formato nativo para *${packDetails.name}*.`,
-                'Enviei em modo compatível (prévia + figurinhas individuais).',
-              ],
-              details: [
-                `📦 Pack: *${packDetails.name}*`,
-                `🧩 Progresso: *${sendResult.sentCount}/${sendResult.total}*`,
-                sendResult.nativeError ? `🛠 Detalhe técnico: ${sendResult.nativeError}` : null,
-              ],
-              nextSteps: [
-                `Você pode continuar gerenciando: \`${commandPrefix}pack info ${packDetails.pack_key}\`.`,
-                `Para tentar novamente no formato nativo: \`${commandPrefix}pack send ${packDetails.pack_key}\` mais tarde.`,
-              ],
+              explanation: [`O cliente não aceitou o formato nativo para *${packDetails.name}*.`, 'Enviei em modo compatível (prévia + figurinhas individuais).'],
+              details: [`📦 Pack: *${packDetails.name}*`, `🧩 Progresso: *${sendResult.sentCount}/${sendResult.total}*`, sendResult.nativeError ? `🛠 Detalhe técnico: ${sendResult.nativeError}` : null],
+              nextSteps: [`Você pode continuar gerenciando: \`${commandPrefix}pack info ${packDetails.pack_key}\`.`, `Para tentar novamente no formato nativo: \`${commandPrefix}pack send ${packDetails.pack_key}\` mais tarde.`],
             }),
           });
         }

package/app/modules/stickerPackModule/stickerPackInteractionEventRepository.js

@@ -7,7 +7,9 @@ const clamp = (value, fallback, min, max) => {
 };
 
 const normalizeInteraction = (value) => {
-  const normalized = String(value || '').trim().toLowerCase();
+  const normalized = String(value || '')
+    .trim()
+    .toLowerCase();
   if (['open', 'like', 'dislike'].includes(normalized)) return normalized;
   return null;
 };
@@ -20,10 +22,7 @@ const sanitizeKey = (value, maxLength = 120) => {
   return normalized || null;
 };
 
-export async function createStickerPackInteractionEvent(
-  { packId, interaction, actorKey = null, sessionKey = null, source = null },
-  connection = null,
-) {
+export async function createStickerPackInteractionEvent({ packId, interaction, actorKey = null, sessionKey = null, source = null }, connection = null) {
   const normalizedInteraction = normalizeInteraction(interaction);
   if (!packId || !normalizedInteraction) return false;
 
@@ -37,11 +36,7 @@ export async function createStickerPackInteractionEvent(
   return true;
 }
 
-export async function listStickerPackInteractionStatsByPackIds(
-  packIds,
-  { horizonHours = 24, baselineDays = 7 } = {},
-  connection = null,
-) {
+export async function listStickerPackInteractionStatsByPackIds(packIds, { horizonHours = 24, baselineDays = 7 } = {}, connection = null) {
   const ids = Array.from(new Set((Array.isArray(packIds) ? packIds : []).filter(Boolean)));
   if (!ids.length) return new Map();
 
@@ -80,11 +75,7 @@ export async function listStickerPackInteractionStatsByPackIds(
   return byPackId;
 }
 
-export async function listViewerRecentPackIds(
-  viewerKey,
-  { days = 30, limit = 120 } = {},
-  connection = null,
-) {
+export async function listViewerRecentPackIds(viewerKey, { days = 30, limit = 120 } = {}, connection = null) {
   const normalizedViewer = sanitizeKey(viewerKey);
   if (!normalizedViewer) return [];
 

package/app/modules/stickerPackModule/stickerPackItemRepository.js

@@ -55,8 +55,7 @@ const normalizeItemRow = (row) => {
           is_animated: row.asset_is_animated === 1 || row.asset_is_animated === true,
           width: row.asset_width !== null && row.asset_width !== undefined ? Number(row.asset_width) : null,
           height: row.asset_height !== null && row.asset_height !== undefined ? Number(row.asset_height) : null,
-          size_bytes:
-            row.asset_size_bytes !== null && row.asset_size_bytes !== undefined ? Number(row.asset_size_bytes) : 0,
+          size_bytes: row.asset_size_bytes !== null && row.asset_size_bytes !== undefined ? Number(row.asset_size_bytes) : 0,
           storage_path: row.asset_storage_path,
           created_at: row.asset_created_at,
         }
@@ -181,11 +180,7 @@ export async function getStickerPackItemByPosition(packId, position, connection
  * @returns {Promise<number>} Total de itens.
  */
 export async function countStickerPackItems(packId, connection = null) {
-  const rows = await executeQuery(
-    `SELECT COUNT(*) AS total FROM ${TABLES.STICKER_PACK_ITEM} WHERE pack_id = ?`,
-    [packId],
-    connection,
-  );
+  const rows = await executeQuery(`SELECT COUNT(*) AS total FROM ${TABLES.STICKER_PACK_ITEM} WHERE pack_id = ?`, [packId], connection);
 
   return Number(rows?.[0]?.total || 0);
 }
@@ -198,11 +193,7 @@ export async function countStickerPackItems(packId, connection = null) {
  * @returns {Promise<number>} Total de referências em packs.
  */
 export async function countStickerPackItemRefsByStickerId(stickerId, connection = null) {
-  const rows = await executeQuery(
-    `SELECT COUNT(*) AS total FROM ${TABLES.STICKER_PACK_ITEM} WHERE sticker_id = ?`,
-    [stickerId],
-    connection,
-  );
+  const rows = await executeQuery(`SELECT COUNT(*) AS total FROM ${TABLES.STICKER_PACK_ITEM} WHERE sticker_id = ?`, [stickerId], connection);
 
   return Number(rows?.[0]?.total || 0);
 }
@@ -233,11 +224,7 @@ export async function listPackIdsByStickerId(stickerId, connection = null) {
  * @returns {Promise<number>} Maior posição encontrada.
  */
 export async function getMaxStickerPackPosition(packId, connection = null) {
-  const rows = await executeQuery(
-    `SELECT MAX(position) AS max_position FROM ${TABLES.STICKER_PACK_ITEM} WHERE pack_id = ?`,
-    [packId],
-    connection,
-  );
+  const rows = await executeQuery(`SELECT MAX(position) AS max_position FROM ${TABLES.STICKER_PACK_ITEM} WHERE pack_id = ?`, [packId], connection);
 
   const maxValue = rows?.[0]?.max_position;
   return maxValue !== null && maxValue !== undefined ? Number(maxValue) : 0;
@@ -255,14 +242,7 @@ export async function createStickerPackItem(item, connection = null) {
     `INSERT INTO ${TABLES.STICKER_PACK_ITEM}
       (id, pack_id, sticker_id, position, emojis, accessibility_label)
      VALUES (?, ?, ?, ?, ?, ?)`,
-    [
-      item.id,
-      item.pack_id,
-      item.sticker_id,
-      item.position,
-      item.emojis ? JSON.stringify(item.emojis) : JSON.stringify([]),
-      item.accessibility_label ?? null,
-    ],
+    [item.id, item.pack_id, item.sticker_id, item.position, item.emojis ? JSON.stringify(item.emojis) : JSON.stringify([]), item.accessibility_label ?? null],
     connection,
   );
 
@@ -445,13 +425,7 @@ export async function cloneStickerPackItems(sourcePackId, targetPackId, connecti
       `INSERT INTO ${TABLES.STICKER_PACK_ITEM}
         (id, pack_id, sticker_id, position, emojis, accessibility_label)
        VALUES (UUID(), ?, ?, ?, ?, ?)`,
-      [
-        targetPackId,
-        item.sticker_id,
-        item.position,
-        item.emojis ? JSON.stringify(item.emojis) : JSON.stringify([]),
-        item.accessibility_label ?? null,
-      ],
+      [targetPackId, item.sticker_id, item.position, item.emojis ? JSON.stringify(item.emojis) : JSON.stringify([]), item.accessibility_label ?? null],
       connection,
     );
   }