@kaikybrofc/omnizap-system 2.2.2 → 2.2.3

package/README.md

@@ -33,6 +33,12 @@ Use as rotas abaixo para consumir o bloco já renderizado com dados do sistema:
 - JSON: `GET /api/sticker-packs/readme-summary`
 - Markdown: `GET /api/sticker-packs/readme-markdown`
 
+Para atualizar este `README.md` automaticamente com o conteúdo renderizado:
+
+```bash
+npm run readme:sync-snapshot
+```
+
 Conteúdo incluído no snapshot:
 
 - total de usuários (`lid_map`)
@@ -44,6 +50,94 @@ Conteúdo incluído no snapshot:
 
 Atualização em cache: **30 minutos** por padrão (`README_SUMMARY_CACHE_SECONDS=1800`).
 
+<!-- README_SNAPSHOT:START -->
+## OmniZap System Snapshot
+
+Atualizado em: **2026-02-28T01:11:03.592Z**
+Janela de atualização: **1800 segundos**
+
+### Totais do sistema
+- Usuários (lid_map): **5.502**
+- Grupos: **116**
+- Packs: **295**
+- Stickers: **6.313**
+- Mensagens registradas: **438.964**
+
+### Tipos de mensagem mais usados (amostra de 25.000 mensagens)
+1. `texto` - **16.530**
+2. `figurinha` - **4.262**
+3. `reacao` - **1.619**
+4. `imagem` - **1.326**
+5. `outros` - **799**
+6. `video` - **245**
+7. `audio` - **213**
+8. `documento` - **6**
+
+### Comandos disponíveis
+- `/add @user`
+- `/addmode`
+- `/autorequests`
+- `/autosticker`
+- `/ban @user`
+- `/captcha`
+- `/cat`
+- `/catimg`
+- `/catprompt`
+- `/catprompt reset`
+- `/dado`
+- `/down @user`
+- `/farewell`
+- `/groups`
+- `/info`
+- `/invite`
+- `/join`
+- `/leave`
+- `/menu anime`
+- `/menu figurinhas`
+- `/menu ia`
+- `/menu midia`
+- `/menu quote`
+- `/menu stats`
+- `/menuadm`
+- `/metadata`
+- `/newgroup`
+- `/noticias`
+- `/nsfw`
+- `/pack add`
+- `/pack create "Meu Pack"`
+- `/pack list`
+- `/pack send`
+- `/ping`
+- `/play`
+- `/playvid`
+- `/prefix`
+- `/premium`
+- `/quote`
+- `/ranking`
+- `/rankingglobal`
+- `/requests`
+- `/revoke`
+- `/s`
+- `/semmsg`
+- `/setdesc`
+- `/setgroup`
+- `/setsubject`
+- `/st`
+- `/stb`
+- `/sticker`
+- `/stickertext`
+- `/stickertextblink`
+- `/stickertextwhite`
+- `/stw`
+- `/temp`
+- `/tiktok`
+- `/toimg`
+- `/up @user`
+- `/updaterequests`
+- `/user perfil`
+- `/welcome`
+<!-- README_SNAPSHOT:END -->
+
 ## Recursos principais
 
 - Gerenciamento de grupos (admin, boas-vindas, despedida, anti-link, captcha).
@@ -150,6 +244,7 @@ Variáveis legadas foram mantidas por compatibilidade (`QUOTE_API_URL`, `WAIFU_A
 - `npm run pm2:prod`: sobe com PM2 usando `ecosystem.prod.config.cjs`.
 - `npm run deploy`: deploy automático de `public/` com cache-bust, backup, validação e reload do Nginx.
 - `npm run deploy:dry-run`: simula o deploy sem publicar/recarregar serviços.
+- `npm run readme:sync-snapshot`: sincroniza o bloco dinâmico do README consumindo `/api/sticker-packs/readme-markdown`.
 - `npm run release`: release completo com versão unificada (npmjs + GitHub Packages + GitHub Release) e verificação final.
 - `npm run release:minor`: bump `minor` + deploy + publish do package.
 - `npm run release:major`: bump `major` + deploy + publish do package.
@@ -256,6 +351,9 @@ Variáveis do fluxo de release (git):
 - `RELEASE_GIT_BRANCH` (opcional; vazio usa branch atual)
 - `RELEASE_GIT_PRE_COMMIT_MESSAGE` (default: `chore(release): auto-commit before release`)
 - `RELEASE_GIT_COMMIT_VERSION` (default: `1`) - commita alteração da versão após sucesso
+- `RELEASE_README_SYNC` (default: `1`) - sincroniza bloco dinâmico do README via API antes do commit/tag
+- `RELEASE_README_SYNC_REQUIRED` (default: `0`) - se `1`, falha o release quando a sincronização do README falhar
+- `RELEASE_README_SYNC_COMMAND` (default: `npm run readme:sync-snapshot`) - comando customizável para sincronização
 - `RELEASE_GIT_VERSION_COMMIT_PREFIX` (default: `chore(release): v`)
 - `RELEASE_GIT_TAG_CREATE` (default: `1`) - cria tag `vX.Y.Z` no release
 - `RELEASE_GIT_TAG_PUSH` (default: `1`) - envia a tag para o remoto

package/app/modules/stickerPackModule/stickerPackCatalogHttp.js

@@ -5778,7 +5778,7 @@ const extractCommandsFromMenuLine = (line, commandPrefix) => {
       const tokens = withoutPrefix.split(/\s+/).filter(Boolean);
       const selectedTokens = [];
       for (const token of tokens) {
-        if (/^[<[(]/.test(token)) break;
+        if (!/^[a-z0-9_-]+$/i.test(token)) break;
         selectedTokens.push(token);
       }
       if (!selectedTokens.length) return '';
@@ -5813,32 +5813,35 @@ const collectAvailableMenuCommands = (commandPrefix = README_COMMAND_PREFIX) =>
 };
 
 const renderReadmeSnapshotMarkdown = ({ generatedAt, totals, topMessageTypes, commands }) => {
-  const typeLines = topMessageTypes.length
-    ? topMessageTypes.map((entry, index) => `${index + 1}. \`${entry.type}\` - **${formatPtBrInteger(entry.total)}**`)
-    : ['1. `outros` - **0**'];
+  const typeRows = topMessageTypes.length
+    ? topMessageTypes.map((entry) => `| \`${entry.type}\` | ${formatPtBrInteger(entry.total)} |`)
+    : ['| `outros` | 0 |'];
 
-  const commandLines = commands.length
-    ? commands.map((command) => `- \`${command}\``)
-    : ['- Nenhum comando identificado no menu atual.'];
+  const commandInline = commands.length ? commands.map((command) => `\`${command}\``).join(' · ') : 'Nenhum comando identificado no menu atual.';
 
   return [
-    '## OmniZap System Snapshot',
+    '### Snapshot do Sistema',
     '',
-    `Atualizado em: **${generatedAt}**`,
-    `Janela de atualização: **${README_SUMMARY_CACHE_SECONDS} segundos**`,
+    `> Atualizado em \`${generatedAt}\` | cache \`${README_SUMMARY_CACHE_SECONDS}s\``,
     '',
-    '### Totais do sistema',
-    `- Usuários (lid_map): **${formatPtBrInteger(totals.total_users)}**`,
-    `- Grupos: **${formatPtBrInteger(totals.total_groups)}**`,
-    `- Packs: **${formatPtBrInteger(totals.total_packs)}**`,
-    `- Stickers: **${formatPtBrInteger(totals.total_stickers)}**`,
-    `- Mensagens registradas: **${formatPtBrInteger(totals.total_messages)}**`,
+    '| Métrica | Valor |',
+    '| --- | ---: |',
+    `| Usuários (lid_map) | ${formatPtBrInteger(totals.total_users)} |`,
+    `| Grupos | ${formatPtBrInteger(totals.total_groups)} |`,
+    `| Packs | ${formatPtBrInteger(totals.total_packs)} |`,
+    `| Stickers | ${formatPtBrInteger(totals.total_stickers)} |`,
+    `| Mensagens registradas | ${formatPtBrInteger(totals.total_messages)} |`,
     '',
-    `### Tipos de mensagem mais usados (amostra de ${formatPtBrInteger(totals.message_types_sample_size)} mensagens)`,
-    ...typeLines,
+    `#### Tipos de mensagem mais usados (amostra: ${formatPtBrInteger(totals.message_types_sample_size)})`,
+    '| Tipo | Total |',
+    '| --- | ---: |',
+    ...typeRows,
     '',
-    '### Comandos disponíveis',
-    ...commandLines,
+    `<details><summary>Comandos disponíveis (${formatPtBrInteger(commands.length)})</summary>`,
+    '',
+    commandInline,
+    '',
+    '</details>',
     '',
   ].join('\n');
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaikybrofc/omnizap-system",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "description": "Sistema profissional de automação WhatsApp com tecnologia Baileys",
   "main": "index.js",
   "publishConfig": {
@@ -58,6 +58,7 @@
     "pm2:prod": "pm2 start ecosystem.prod.config.cjs",
     "deploy": "bash ./scripts/deploy.sh",
     "deploy:dry-run": "DEPLOY_DRY_RUN=1 bash ./scripts/deploy.sh",
+    "readme:sync-snapshot": "node ./scripts/sync-readme-snapshot.mjs",
     "release": "bash ./scripts/release.sh",
     "release:minor": "RELEASE_TYPE=minor bash ./scripts/release.sh",
     "release:major": "RELEASE_TYPE=major bash ./scripts/release.sh",

package/scripts/release.sh

@@ -28,6 +28,9 @@ RELEASE_GITHUB_RELEASE_INCLUDE_CHANGED_FILES="${RELEASE_GITHUB_RELEASE_INCLUDE_C
 RELEASE_GITHUB_RELEASE_MAX_FILES="${RELEASE_GITHUB_RELEASE_MAX_FILES:-300}"
 RELEASE_REQUIRE_DUAL_PUBLISH="${RELEASE_REQUIRE_DUAL_PUBLISH:-1}"
 RELEASE_VERIFY_UNIFIED_VERSION="${RELEASE_VERIFY_UNIFIED_VERSION:-1}"
+RELEASE_README_SYNC="${RELEASE_README_SYNC:-1}"
+RELEASE_README_SYNC_REQUIRED="${RELEASE_README_SYNC_REQUIRED:-0}"
+RELEASE_README_SYNC_COMMAND="${RELEASE_README_SYNC_COMMAND:-npm run readme:sync-snapshot}"
 RELEASE_VERIFY_PRIMARY_REGISTRY="${RELEASE_VERIFY_PRIMARY_REGISTRY:-${DEPLOY_PACKAGE_REGISTRY:-https://npm.pkg.github.com}}"
 RELEASE_VERIFY_SECONDARY_REGISTRY="${RELEASE_VERIFY_SECONDARY_REGISTRY:-${DEPLOY_PACKAGE_SECONDARY_REGISTRY:-https://registry.npmjs.org}}"
 RELEASE_VERIFY_PRIMARY_TOKEN_KEYS="${RELEASE_VERIFY_PRIMARY_TOKEN_KEYS:-DEPLOY_PACKAGE_TOKEN,DEPLOY_GITHUB_TOKEN,GITHUB_TOKEN,GH_TOKEN,NPM_TOKEN,NODE_AUTH_TOKEN}"
@@ -439,6 +442,20 @@ if ! (
   exit 1
 fi
 
+if [ "$RELEASE_README_SYNC" = "1" ]; then
+  log "Sincronizando bloco dinâmico do README"
+  if ! (
+    cd "$PROJECT_ROOT" &&
+    bash -lc "$RELEASE_README_SYNC_COMMAND"
+  ); then
+    if [ "$RELEASE_README_SYNC_REQUIRED" = "1" ]; then
+      printf '[release] Falha ao sincronizar README e RELEASE_README_SYNC_REQUIRED=1.\n' >&2
+      exit 1
+    fi
+    log "Falha ao sincronizar README. Continuando release (RELEASE_README_SYNC_REQUIRED=0)."
+  fi
+fi
+
 if [ "$RELEASE_GIT_COMMIT_VERSION" = "1" ]; then
   commit_and_push_if_dirty "${RELEASE_GIT_VERSION_COMMIT_PREFIX}${new_version}"
 fi

package/scripts/sync-readme-snapshot.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import dotenv from 'dotenv';
+
+dotenv.config({ path: '.env' });
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const projectRoot = path.resolve(__dirname, '..');
+
+const START_MARKER = '<!-- README_SNAPSHOT:START -->';
+const END_MARKER = '<!-- README_SNAPSHOT:END -->';
+
+const readmePath = path.resolve(projectRoot, process.env.README_SNAPSHOT_TARGET_PATH || 'README.md');
+const siteOrigin = String(process.env.SITE_ORIGIN || 'https://omnizap.shop').trim().replace(/\/+$/, '');
+const sourceUrl = String(process.env.README_SNAPSHOT_SOURCE_URL || `${siteOrigin}/api/sticker-packs/readme-markdown`).trim();
+const timeoutMs = Math.max(1000, Number(process.env.README_SNAPSHOT_TIMEOUT_MS) || 15000);
+
+const escapeRegExp = (value) => String(value || '').replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+const fetchWithTimeout = async (url, timeout) => {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(url, {
+      method: 'GET',
+      headers: { 'User-Agent': 'omnizap-readme-sync/1.0' },
+      signal: controller.signal,
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status} ao buscar snapshot`);
+    }
+    const content = String(await response.text()).trim();
+    if (!content) {
+      throw new Error('Snapshot markdown vazio');
+    }
+    return content;
+  } finally {
+    clearTimeout(timer);
+  }
+};
+
+const syncReadmeSnapshot = async () => {
+  const markdown = await fetchWithTimeout(sourceUrl, timeoutMs);
+  const readme = await fs.readFile(readmePath, 'utf8');
+
+  const blockRegex = new RegExp(`${escapeRegExp(START_MARKER)}[\\s\\S]*?${escapeRegExp(END_MARKER)}`, 'm');
+  if (!blockRegex.test(readme)) {
+    throw new Error(`Marcadores não encontrados em ${path.relative(projectRoot, readmePath)} (${START_MARKER} ... ${END_MARKER})`);
+  }
+
+  const replacement = `${START_MARKER}\n${markdown}\n${END_MARKER}`;
+  const nextReadme = readme.replace(blockRegex, replacement);
+
+  if (nextReadme === readme) {
+    console.log('[readme-sync] Snapshot já está atualizado.');
+    return;
+  }
+
+  await fs.writeFile(readmePath, nextReadme, 'utf8');
+  console.log(`[readme-sync] README atualizado com snapshot de ${sourceUrl}`);
+};
+
+syncReadmeSnapshot().catch((error) => {
+  console.error(`[readme-sync] Falha: ${error?.message || error}`);
+  process.exit(1);
+});
+