@kaikybrofc/omnizap-system 2.2.10 → 2.3.1

package/app/modules/stickerPackModule/stickerDomainEventConsumerRuntime.js

@@ -1,12 +1,7 @@
 import logger from '../../utils/logger/loggerModule.js';
 import { setQueueDepth } from '../../observability/metrics.js';
 import { isFeatureEnabled } from '../../services/featureFlagService.js';
-import {
-  claimDomainEvent,
-  completeDomainEvent,
-  countDomainEventsByStatus,
-  failDomainEvent,
-} from './domainEventOutboxRepository.js';
+import { claimDomainEvent, completeDomainEvent, countDomainEventsByStatus, failDomainEvent } from './domainEventOutboxRepository.js';
 import { STICKER_DOMAIN_EVENTS } from './domainEvents.js';
 import { enqueueWorkerTask } from './stickerWorkerTaskQueueRepository.js';
 import { enqueuePackScoreSnapshotRefresh } from './stickerPackScoreSnapshotRuntime.js';
@@ -21,32 +16,20 @@ const parseEnvBool = (value, fallback) => {
 };
 
 const CONSUMER_ENABLED = parseEnvBool(process.env.STICKER_DOMAIN_EVENT_CONSUMER_ENABLED, true);
-const STARTUP_DELAY_MS = Math.max(
-  1_000,
-  Number(process.env.STICKER_DOMAIN_EVENT_CONSUMER_STARTUP_DELAY_MS) || 8_000,
-);
-const POLLER_INTERVAL_MS = Math.max(
-  1_000,
-  Number(process.env.STICKER_DOMAIN_EVENT_CONSUMER_POLLER_INTERVAL_MS) || 2_000,
-);
-const RETRY_DELAY_SECONDS = Math.max(
-  5,
-  Math.min(3600, Number(process.env.STICKER_DOMAIN_EVENT_CONSUMER_RETRY_DELAY_SECONDS) || 45),
-);
-const CONSUMER_COHORT_KEY =
-  String(process.env.STICKER_DOMAIN_EVENT_CONSUMER_COHORT_KEY || process.env.HOSTNAME || process.pid).trim()
-  || 'consumer';
+const STARTUP_DELAY_MS = Math.max(1_000, Number(process.env.STICKER_DOMAIN_EVENT_CONSUMER_STARTUP_DELAY_MS) || 8_000);
+const POLLER_INTERVAL_MS = Math.max(1_000, Number(process.env.STICKER_DOMAIN_EVENT_CONSUMER_POLLER_INTERVAL_MS) || 2_000);
+const RETRY_DELAY_SECONDS = Math.max(5, Math.min(3600, Number(process.env.STICKER_DOMAIN_EVENT_CONSUMER_RETRY_DELAY_SECONDS) || 45));
+const CLASSIFICATION_COALESCE_WINDOW_SECONDS = Math.max(30, Math.min(3600, Number(process.env.STICKER_DOMAIN_EVENT_CLASSIFICATION_COALESCE_WINDOW_SECONDS) || 60));
+const CURATION_COALESCE_WINDOW_SECONDS = Math.max(30, Math.min(3600, Number(process.env.STICKER_DOMAIN_EVENT_CURATION_COALESCE_WINDOW_SECONDS) || 60));
+const REBUILD_COALESCE_WINDOW_SECONDS = Math.max(30, Math.min(3600, Number(process.env.STICKER_DOMAIN_EVENT_REBUILD_COALESCE_WINDOW_SECONDS) || 120));
+const CONSUMER_COHORT_KEY = String(process.env.STICKER_DOMAIN_EVENT_CONSUMER_COHORT_KEY || process.env.HOSTNAME || process.pid).trim() || 'consumer';
 
 let startupHandle = null;
 let pollerHandle = null;
 let running = false;
 
 const refreshOutboxDepthMetrics = async () => {
-  const [pending, processing, failed] = await Promise.all([
-    countDomainEventsByStatus('pending'),
-    countDomainEventsByStatus('processing'),
-    countDomainEventsByStatus('failed'),
-  ]);
+  const [pending, processing, failed] = await Promise.all([countDomainEventsByStatus('pending'), countDomainEventsByStatus('processing'), countDomainEventsByStatus('failed')]);
   setQueueDepth('domain_event_outbox_pending', pending);
   setQueueDepth('domain_event_outbox_processing', processing);
   setQueueDepth('domain_event_outbox_failed', failed);
@@ -67,22 +50,38 @@ const enqueueTaskSafely = async ({ taskType, payload, priority, idempotencyKey }
   });
 };
 
+const toUnixSeconds = (value) => {
+  if (!value) return Math.floor(Date.now() / 1000);
+  const numeric = Date.parse(value);
+  if (!Number.isFinite(numeric)) return Math.floor(Date.now() / 1000);
+  return Math.floor(numeric / 1000);
+};
+
+const toWindowBucket = (value, windowSeconds) => {
+  const safeWindow = Math.max(1, Math.floor(windowSeconds || 1));
+  return Math.floor(toUnixSeconds(value) / safeWindow);
+};
+
 const handleDomainEvent = async (event) => {
-  const eventType = String(event?.event_type || '').trim().toUpperCase();
+  const eventType = String(event?.event_type || '')
+    .trim()
+    .toUpperCase();
   const aggregateId = String(event?.aggregate_id || '').trim();
   const payload = event?.payload && typeof event.payload === 'object' ? event.payload : {};
 
   if (eventType === STICKER_DOMAIN_EVENTS.STICKER_ASSET_CREATED) {
+    const coalesceBucket = toWindowBucket(event?.created_at, CLASSIFICATION_COALESCE_WINDOW_SECONDS);
     await enqueueTaskSafely({
       taskType: 'classification_cycle',
-      payload: { reason: 'domain_event', event_type: eventType, aggregate_id: aggregateId },
+      payload: { reason: 'domain_event', event_type: eventType, aggregate_id: aggregateId, coalesced: true },
       priority: 80,
-      idempotencyKey: `evt:${event.id}:classification_cycle`,
+      idempotencyKey: `evt:${eventType}:${coalesceBucket}:classification_cycle`,
     });
     return;
   }
 
   if (eventType === STICKER_DOMAIN_EVENTS.STICKER_CLASSIFIED) {
+    const coalesceBucket = toWindowBucket(event?.created_at, CURATION_COALESCE_WINDOW_SECONDS);
     const assetId = String(payload?.asset_id || aggregateId || '').trim();
     const relatedPackIds = assetId ? await listPackIdsByStickerId(assetId).catch(() => []) : [];
     if (relatedPackIds.length) {
@@ -95,23 +94,28 @@ const handleDomainEvent = async (event) => {
         event_type: eventType,
         aggregate_id: aggregateId,
         related_pack_ids: relatedPackIds,
+        coalesced: true,
       },
       priority: 65,
-      idempotencyKey: `evt:${event.id}:curation_cycle`,
+      idempotencyKey: `evt:${eventType}:${coalesceBucket}:curation_cycle`,
     });
     return;
   }
 
   if (eventType === STICKER_DOMAIN_EVENTS.PACK_UPDATED) {
+    const coalesceBucket = toWindowBucket(event?.created_at, REBUILD_COALESCE_WINDOW_SECONDS);
     const packId = String(payload?.pack_id || aggregateId || '').trim();
     if (packId) {
       enqueuePackScoreSnapshotRefresh([packId]);
     }
+    const rebuildIdempotency = packId
+      ? `evt:${eventType}:${packId}:${coalesceBucket}:rebuild_cycle`
+      : `evt:${eventType}:${coalesceBucket}:rebuild_cycle`;
     await enqueueTaskSafely({
       taskType: 'rebuild_cycle',
-      payload: { reason: 'domain_event', event_type: eventType, aggregate_id: aggregateId, pack_id: packId || null },
+      payload: { reason: 'domain_event', event_type: eventType, aggregate_id: aggregateId, pack_id: packId || null, coalesced: true },
       priority: 60,
-      idempotencyKey: `evt:${event.id}:rebuild_cycle`,
+      idempotencyKey: rebuildIdempotency,
     });
     return;
   }
@@ -141,13 +145,10 @@ const pollOnce = async () => {
       await handleDomainEvent(event);
       await completeDomainEvent(event.id);
     } catch (error) {
-      await failDomainEvent(
-        event.id,
-        {
-          error: error?.message || 'domain_event_consumer_failed',
-          retryDelaySeconds: RETRY_DELAY_SECONDS,
-        },
-      );
+      await failDomainEvent(event.id, {
+        error: error?.message || 'domain_event_consumer_failed',
+        retryDelaySeconds: RETRY_DELAY_SECONDS,
+      });
       logger.warn('Evento de domínio falhou no consumidor interno.', {
         action: 'sticker_domain_event_consumer_event_failed',
         event_id: event.id,

package/app/modules/stickerPackModule/stickerMarketplaceDriftService.js

@@ -80,10 +80,7 @@ export const getMarketplaceDriftSnapshot = async ({ force = false } = {}) => {
     return cache;
   }
 
-  const [distribution7d, distribution30d] = await Promise.all([
-    listClassificationCategoryDistribution({ days: 7 }),
-    listClassificationCategoryDistribution({ days: 30 }),
-  ]);
+  const [distribution7d, distribution30d] = await Promise.all([listClassificationCategoryDistribution({ days: 7 }), listClassificationCategoryDistribution({ days: 30 })]);
 
   const probability7d = toProbabilityMap(distribution7d);
   const probability30d = toProbabilityMap(distribution30d);

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.`],
             }),
           });
         }