@kaikybrofc/omnizap-system 2.1.8

package/database/init.js

@@ -0,0 +1,516 @@
+import mysql from 'mysql2/promise';
+import logger from '../app/utils/logger/loggerModule.js';
+import { dbConfig, TABLES } from './index.js';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/**
+ * Nome do banco de dados que será criado ou validado.
+ * Já vem resolvido com sufixo _dev ou _prod via dbConfig.
+ * @type {string}
+ */
+const dbToCreate = dbConfig.database;
+
+/**
+ * SQL para criar o banco de dados caso ainda não exista.
+ * Usa:
+ * - utf8mb4: suporte total a emojis e caracteres unicode
+ * - utf8mb4_unicode_ci: collation consistente para buscas
+ */
+const createDatabaseSQL = `
+  CREATE DATABASE IF NOT EXISTS \`${dbToCreate}\`
+  DEFAULT CHARACTER SET utf8mb4
+  DEFAULT COLLATE utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela MESSAGES
+ * Armazena todas as mensagens processadas pelo sistema.
+ *
+ * Campos importantes:
+ * - message_id: ID global do WhatsApp (único)
+ * - chat_id: conversa (grupo ou privado)
+ * - sender_id: remetente da mensagem
+ * - content: texto extraído
+ * - raw_message: JSON original da Baileys
+ * - timestamp: timestamp da mensagem no WhatsApp
+ *
+ * Índices:
+ * - chat_id + timestamp → leitura de histórico por conversa
+ * - sender_id → estatísticas por usuário
+ * - timestamp → ordenação global
+ */
+const createMessagesTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.MESSAGES} (
+    id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
+    message_id VARCHAR(255) UNIQUE NOT NULL,
+    chat_id VARCHAR(255) NOT NULL,
+    sender_id VARCHAR(255),
+    content TEXT,
+    raw_message JSON,
+    timestamp TIMESTAMP NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_chat_timestamp (chat_id, timestamp),
+    INDEX idx_sender (sender_id),
+    INDEX idx_timestamp (timestamp)
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela CHATS
+ * Representa uma conversa (grupo ou privado).
+ *
+ * - id → JID do WhatsApp
+ * - name → nome do grupo ou contato
+ * - raw_chat → JSON bruto retornado pela Baileys
+ */
+const createChatsTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.CHATS} (
+    id VARCHAR(255) PRIMARY KEY NOT NULL,
+    name VARCHAR(255),
+    raw_chat JSON,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela GROUPS_METADATA
+ * Armazena informações normalizadas de grupos.
+ *
+ * Usada para:
+ * - admin commands
+ * - estatísticas
+ * - sincronização de participantes
+ *
+ * participants é JSON para armazenar:
+ * [{ jid, lid, admin }, ...]
+ */
+const createGroupsMetadataTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.GROUPS_METADATA} (
+    id VARCHAR(255) PRIMARY KEY NOT NULL,
+    subject VARCHAR(255),
+    description TEXT,
+    owner_jid VARCHAR(255),
+    creation BIGINT,
+    participants JSON,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela GROUP_CONFIGS
+ * Configurações específicas por grupo.
+ *
+ * Exemplo:
+ * - prefixo de comandos
+ * - anti-link
+ * - modo restrito
+ */
+const createGroupConfigsTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.GROUP_CONFIGS} (
+    id VARCHAR(255) PRIMARY KEY NOT NULL,
+    config JSON,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela LID_MAP
+ * Mapeia IDs temporários do WhatsApp (LID) para JIDs reais.
+ *
+ * Isso resolve problemas de:
+ * - mensagens vindo com "xxx@lid"
+ * - alternância entre lid e s.whatsapp.net
+ *
+ * Campos:
+ * - lid → chave primária
+ * - jid → jid real associado
+ * - first_seen → quando apareceu
+ * - last_seen → última vez visto
+ * - source → origem do dado (message, group, etc)
+ */
+const createLidMapTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.LID_MAP} (
+    lid VARCHAR(64) PRIMARY KEY,
+    jid VARCHAR(64) NULL,
+    first_seen TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    last_seen TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    source VARCHAR(32),
+    INDEX idx_lid_map_jid (jid),
+    INDEX idx_lid_map_last_seen (last_seen)
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela STICKER_ASSET
+ * Armazena os arquivos de figurinha persistidos no storage local.
+ */
+const createStickerAssetTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.STICKER_ASSET} (
+    id CHAR(36) PRIMARY KEY,
+    owner_jid VARCHAR(255) NOT NULL,
+    sha256 CHAR(64) NOT NULL,
+    mimetype VARCHAR(64) NOT NULL,
+    is_animated TINYINT(1) NOT NULL DEFAULT 0,
+    width INT UNSIGNED NULL,
+    height INT UNSIGNED NULL,
+    size_bytes INT UNSIGNED NOT NULL,
+    storage_path VARCHAR(1024) NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uq_sticker_asset_sha256 (sha256),
+    INDEX idx_sticker_asset_owner_created (owner_jid, created_at)
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela STICKER_PACK
+ * Metadados do pack (dono, nome, publisher, capa, visibilidade).
+ */
+const createStickerPackTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.STICKER_PACK} (
+    id CHAR(36) PRIMARY KEY,
+    owner_jid VARCHAR(255) NOT NULL,
+    name VARCHAR(120) NOT NULL,
+    publisher VARCHAR(120) NOT NULL,
+    description TEXT NULL,
+    pack_key VARCHAR(160) NOT NULL,
+    cover_sticker_id CHAR(36) NULL,
+    visibility ENUM('private', 'public', 'unlisted') NOT NULL DEFAULT 'private',
+    status ENUM('draft', 'uploading', 'processing', 'published', 'failed') NOT NULL DEFAULT 'published',
+    version INT UNSIGNED NOT NULL DEFAULT 1,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    deleted_at TIMESTAMP NULL DEFAULT NULL,
+    UNIQUE KEY uq_sticker_pack_pack_key (pack_key),
+    INDEX idx_sticker_pack_owner_deleted (owner_jid, deleted_at),
+    INDEX idx_sticker_pack_owner_updated (owner_jid, updated_at),
+    CONSTRAINT fk_sticker_pack_cover
+      FOREIGN KEY (cover_sticker_id) REFERENCES ${TABLES.STICKER_ASSET}(id)
+      ON DELETE SET NULL ON UPDATE CASCADE
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela STICKER_PACK_ITEM
+ * Relação N:N ordenada entre pack e figurinhas.
+ */
+const createStickerPackItemTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.STICKER_PACK_ITEM} (
+    id CHAR(36) PRIMARY KEY,
+    pack_id CHAR(36) NOT NULL,
+    sticker_id CHAR(36) NOT NULL,
+    position INT UNSIGNED NOT NULL,
+    emojis JSON NULL,
+    accessibility_label VARCHAR(255) NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uq_sticker_pack_item_pack_sticker (pack_id, sticker_id),
+    UNIQUE KEY uq_sticker_pack_item_pack_position (pack_id, position),
+    INDEX idx_sticker_pack_item_pack_position (pack_id, position),
+    CONSTRAINT fk_sticker_pack_item_pack
+      FOREIGN KEY (pack_id) REFERENCES ${TABLES.STICKER_PACK}(id)
+      ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT fk_sticker_pack_item_asset
+      FOREIGN KEY (sticker_id) REFERENCES ${TABLES.STICKER_ASSET}(id)
+      ON DELETE RESTRICT ON UPDATE CASCADE
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela STICKER_PACK_WEB_UPLOAD
+ * Controle de upload idempotente do fluxo web (upload_id + hash por pack).
+ */
+const createStickerPackWebUploadTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.STICKER_PACK_WEB_UPLOAD} (
+    id CHAR(36) PRIMARY KEY,
+    pack_id CHAR(36) NOT NULL,
+    upload_id VARCHAR(120) NOT NULL,
+    sticker_hash CHAR(64) NOT NULL,
+    source_mimetype VARCHAR(64) NULL,
+    upload_status ENUM('pending', 'processing', 'done', 'failed') NOT NULL DEFAULT 'pending',
+    sticker_id CHAR(36) NULL,
+    error_code VARCHAR(64) NULL,
+    error_message VARCHAR(255) NULL,
+    attempt_count INT UNSIGNED NOT NULL DEFAULT 0,
+    last_attempt_at TIMESTAMP NULL DEFAULT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uq_sticker_pack_web_upload_pack_upload_id (pack_id, upload_id),
+    UNIQUE KEY uq_sticker_pack_web_upload_pack_hash (pack_id, sticker_hash),
+    INDEX idx_sticker_pack_web_upload_pack_status (pack_id, upload_status),
+    INDEX idx_sticker_pack_web_upload_pack_updated (pack_id, updated_at),
+    CONSTRAINT fk_sticker_pack_web_upload_pack
+      FOREIGN KEY (pack_id) REFERENCES ${TABLES.STICKER_PACK}(id)
+      ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT fk_sticker_pack_web_upload_sticker
+      FOREIGN KEY (sticker_id) REFERENCES ${TABLES.STICKER_ASSET}(id)
+      ON DELETE SET NULL ON UPDATE CASCADE
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela STICKER_ASSET_CLASSIFICATION
+ * Classificação de conteúdo por asset (CLIP), com score completo.
+ */
+const createStickerAssetClassificationTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.STICKER_ASSET_CLASSIFICATION} (
+    asset_id CHAR(36) PRIMARY KEY,
+    provider VARCHAR(64) NOT NULL DEFAULT 'clip',
+    model_name VARCHAR(120) NULL,
+    classification_version VARCHAR(32) NOT NULL DEFAULT 'v1',
+    category VARCHAR(120) NULL,
+    confidence DECIMAL(6,5) NULL,
+    nsfw_score DECIMAL(6,5) NULL,
+    is_nsfw TINYINT(1) NOT NULL DEFAULT 0,
+    all_scores JSON NULL,
+    classified_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    CONSTRAINT fk_sticker_asset_classification_asset
+      FOREIGN KEY (asset_id) REFERENCES ${TABLES.STICKER_ASSET}(id)
+      ON DELETE CASCADE ON UPDATE CASCADE,
+    INDEX idx_sticker_asset_classification_category (category),
+    INDEX idx_sticker_asset_classification_nsfw (is_nsfw)
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela STICKER_PACK_ENGAGEMENT
+ * Armazena métricas reais de interação no catálogo web (cliques/likes/dislikes).
+ */
+const createStickerPackEngagementTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.STICKER_PACK_ENGAGEMENT} (
+    pack_id CHAR(36) PRIMARY KEY,
+    open_count BIGINT UNSIGNED NOT NULL DEFAULT 0,
+    like_count BIGINT UNSIGNED NOT NULL DEFAULT 0,
+    dislike_count BIGINT UNSIGNED NOT NULL DEFAULT 0,
+    last_opened_at TIMESTAMP NULL DEFAULT NULL,
+    last_interacted_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    CONSTRAINT fk_sticker_pack_engagement_pack
+      FOREIGN KEY (pack_id) REFERENCES ${TABLES.STICKER_PACK}(id)
+      ON DELETE CASCADE ON UPDATE CASCADE,
+    INDEX idx_sticker_pack_engagement_updated (updated_at),
+    INDEX idx_sticker_pack_engagement_like (like_count),
+    INDEX idx_sticker_pack_engagement_open (open_count)
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+/**
+ * Tabela STICKER_PACK_INTERACTION_EVENT
+ * Histórico de interações para tendência, recomendação e perfis de criador.
+ */
+const createStickerPackInteractionEventTableSQL = `
+  CREATE TABLE IF NOT EXISTS ${TABLES.STICKER_PACK_INTERACTION_EVENT} (
+    id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
+    pack_id CHAR(36) NOT NULL,
+    interaction ENUM('open', 'like', 'dislike') NOT NULL,
+    actor_key VARCHAR(120) NULL,
+    session_key VARCHAR(120) NULL,
+    source VARCHAR(32) NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT fk_sticker_pack_interaction_pack
+      FOREIGN KEY (pack_id) REFERENCES ${TABLES.STICKER_PACK}(id)
+      ON DELETE CASCADE ON UPDATE CASCADE,
+    INDEX idx_sticker_pack_interaction_pack_created (pack_id, created_at),
+    INDEX idx_sticker_pack_interaction_actor_created (actor_key, created_at),
+    INDEX idx_sticker_pack_interaction_session_created (session_key, created_at),
+    INDEX idx_sticker_pack_interaction_type_created (interaction, created_at)
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+const createSchemaMigrationsTableSQL = `
+  CREATE TABLE IF NOT EXISTS schema_migrations (
+    name VARCHAR(255) PRIMARY KEY,
+    executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+  ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+`;
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const MIGRATIONS_DIR = path.join(__dirname, 'migrations');
+
+/**
+ * Divide um arquivo SQL em statements individuais.
+ * Suporta aspas simples e duplas para não quebrar strings.
+ *
+ * @param {string} sql
+ * @returns {string[]}
+ */
+function splitSqlStatements(sql) {
+  const statements = [];
+  let current = '';
+  let inSingleQuote = false;
+  let inDoubleQuote = false;
+  let escaped = false;
+
+  for (const char of sql) {
+    if (escaped) {
+      current += char;
+      escaped = false;
+      continue;
+    }
+
+    if (char === '\\') {
+      current += char;
+      escaped = true;
+      continue;
+    }
+
+    if (char === "'" && !inDoubleQuote) {
+      inSingleQuote = !inSingleQuote;
+      current += char;
+      continue;
+    }
+
+    if (char === '"' && !inSingleQuote) {
+      inDoubleQuote = !inDoubleQuote;
+      current += char;
+      continue;
+    }
+
+    if (char === ';' && !inSingleQuote && !inDoubleQuote) {
+      const statement = current.trim();
+      if (statement) {
+        statements.push(statement);
+      }
+      current = '';
+      continue;
+    }
+
+    current += char;
+  }
+
+  const trailing = current.trim();
+  if (trailing) {
+    statements.push(trailing);
+  }
+
+  return statements;
+}
+
+/**
+ * Executa migrações SQL idempotentes a partir de `database/migrations`.
+ *
+ * @param {import('mysql2/promise').Connection} connection
+ * @returns {Promise<number>} Quantidade de migrações aplicadas.
+ */
+async function runSqlMigrations(connection) {
+  await connection.query(createSchemaMigrationsTableSQL);
+
+  let files = [];
+  try {
+    files = await fs.readdir(MIGRATIONS_DIR);
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      logger.info('Diretório de migrações não encontrado. Seguindo sem migrações extras.');
+      return 0;
+    }
+    throw error;
+  }
+
+  const migrationFiles = files.filter((file) => file.endsWith('.sql')).sort();
+  if (migrationFiles.length === 0) return 0;
+
+  const [rows] = await connection.query('SELECT name FROM schema_migrations');
+  const applied = new Set((rows || []).map((row) => row.name));
+
+  let appliedCount = 0;
+
+  for (const fileName of migrationFiles) {
+    if (applied.has(fileName)) continue;
+
+    const filePath = path.join(MIGRATIONS_DIR, fileName);
+    const sqlContent = await fs.readFile(filePath, 'utf8');
+    const statements = splitSqlStatements(sqlContent);
+
+    if (statements.length === 0) {
+      await connection.query('INSERT INTO schema_migrations (name) VALUES (?)', [fileName]);
+      appliedCount += 1;
+      continue;
+    }
+
+    logger.info(`Aplicando migração SQL: ${fileName}`);
+    for (const statement of statements) {
+      await connection.query(statement);
+    }
+
+    await connection.query('INSERT INTO schema_migrations (name) VALUES (?)', [fileName]);
+    appliedCount += 1;
+  }
+
+  return appliedCount;
+}
+
+/**
+ * Inicializa o banco de dados:
+ * 1) Conecta ao MySQL sem database
+ * 2) Cria o banco se não existir
+ * 3) Muda para o database correto
+ * 4) Cria todas as tabelas
+ * 5) Encerra a conexão
+ *
+ * Este script é idempotente:
+ * pode ser rodado várias vezes sem quebrar nada.
+ *
+ * @returns {Promise<void>}
+ */
+export default async function initializeDatabase() {
+  let connection;
+
+  try {
+    connection = await mysql.createConnection({
+      host: dbConfig.host,
+      user: dbConfig.user,
+      password: dbConfig.password,
+    });
+
+    // Cria/verifica o banco
+    await connection.query(createDatabaseSQL);
+    logger.info(`Banco de dados '${dbToCreate}' verificado/criado com sucesso.`);
+
+    // Seleciona o banco recém-criado
+    await connection.changeUser({ database: dbToCreate });
+
+    // Cria todas as tabelas em paralelo
+    await Promise.all([
+      connection.query(createMessagesTableSQL),
+      connection.query(createChatsTableSQL),
+      connection.query(createGroupsMetadataTableSQL),
+      connection.query(createGroupConfigsTableSQL),
+      connection.query(createLidMapTableSQL),
+      connection.query(createStickerAssetTableSQL),
+    ]);
+
+    // Ordem importa por conta das FKs: pack depende de asset e item depende de pack+asset.
+    await connection.query(createStickerPackTableSQL);
+    await connection.query(createStickerPackItemTableSQL);
+    await connection.query(createStickerPackWebUploadTableSQL);
+    await connection.query(createStickerAssetClassificationTableSQL);
+    await connection.query(createStickerPackEngagementTableSQL);
+    await connection.query(createStickerPackInteractionEventTableSQL);
+
+    const appliedMigrations = await runSqlMigrations(connection);
+
+    logger.info('Todas as tabelas foram verificadas/criadas com sucesso.', {
+      appliedMigrations,
+    });
+  } catch (error) {
+    logger.error(`Erro ao inicializar o banco: ${error.code || ''} ${error.message}`);
+    process.exit(1);
+  } finally {
+    if (connection) {
+      await connection.end();
+      logger.info('Conexão com o MySQL encerrada após inicialização.');
+    }
+  }
+}
+
+/**
+ * Permite que este arquivo seja executado diretamente:
+ * node database/init.js
+ */
+if (process.argv[1] === __filename) {
+  initializeDatabase();
+}

package/database/migrations/20260203_0001_sticker_packs.sql

@@ -0,0 +1,54 @@
+CREATE TABLE IF NOT EXISTS sticker_asset (
+  id CHAR(36) PRIMARY KEY,
+  owner_jid VARCHAR(255) NOT NULL,
+  sha256 CHAR(64) NOT NULL,
+  mimetype VARCHAR(64) NOT NULL,
+  is_animated TINYINT(1) NOT NULL DEFAULT 0,
+  width INT UNSIGNED NULL,
+  height INT UNSIGNED NULL,
+  size_bytes INT UNSIGNED NOT NULL,
+  storage_path VARCHAR(1024) NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE KEY uq_sticker_asset_sha256 (sha256),
+  INDEX idx_sticker_asset_owner_created (owner_jid, created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS sticker_pack (
+  id CHAR(36) PRIMARY KEY,
+  owner_jid VARCHAR(255) NOT NULL,
+  name VARCHAR(120) NOT NULL,
+  publisher VARCHAR(120) NOT NULL,
+  description TEXT NULL,
+  pack_key VARCHAR(160) NOT NULL,
+  cover_sticker_id CHAR(36) NULL,
+  visibility ENUM('private', 'public', 'unlisted') NOT NULL DEFAULT 'private',
+  version INT UNSIGNED NOT NULL DEFAULT 1,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  deleted_at TIMESTAMP NULL DEFAULT NULL,
+  UNIQUE KEY uq_sticker_pack_pack_key (pack_key),
+  INDEX idx_sticker_pack_owner_deleted (owner_jid, deleted_at),
+  INDEX idx_sticker_pack_owner_updated (owner_jid, updated_at),
+  CONSTRAINT fk_sticker_pack_cover
+    FOREIGN KEY (cover_sticker_id) REFERENCES sticker_asset(id)
+    ON DELETE SET NULL ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS sticker_pack_item (
+  id CHAR(36) PRIMARY KEY,
+  pack_id CHAR(36) NOT NULL,
+  sticker_id CHAR(36) NOT NULL,
+  position INT UNSIGNED NOT NULL,
+  emojis JSON NULL,
+  accessibility_label VARCHAR(255) NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE KEY uq_sticker_pack_item_pack_sticker (pack_id, sticker_id),
+  UNIQUE KEY uq_sticker_pack_item_pack_position (pack_id, position),
+  INDEX idx_sticker_pack_item_pack_position (pack_id, position),
+  CONSTRAINT fk_sticker_pack_item_pack
+    FOREIGN KEY (pack_id) REFERENCES sticker_pack(id)
+    ON DELETE CASCADE ON UPDATE CASCADE,
+  CONSTRAINT fk_sticker_pack_item_asset
+    FOREIGN KEY (sticker_id) REFERENCES sticker_asset(id)
+    ON DELETE RESTRICT ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

package/database/migrations/20260210_0003_rpg_pokemon.sql

@@ -0,0 +1,58 @@
+CREATE TABLE IF NOT EXISTS rpg_player (
+  jid VARCHAR(255) PRIMARY KEY,
+  level INT UNSIGNED NOT NULL DEFAULT 1,
+  xp BIGINT UNSIGNED NOT NULL DEFAULT 0,
+  gold BIGINT UNSIGNED NOT NULL DEFAULT 200,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS rpg_player_pokemon (
+  id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
+  owner_jid VARCHAR(255) NOT NULL,
+  poke_id INT UNSIGNED NOT NULL,
+  nickname VARCHAR(120) NULL,
+  level INT UNSIGNED NOT NULL DEFAULT 5,
+  xp BIGINT UNSIGNED NOT NULL DEFAULT 0,
+  current_hp INT UNSIGNED NOT NULL,
+  ivs_json JSON NOT NULL,
+  moves_json JSON NOT NULL,
+  is_active TINYINT(1) NOT NULL DEFAULT 0,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  INDEX idx_rpg_player_pokemon_owner (owner_jid),
+  INDEX idx_rpg_player_pokemon_owner_active (owner_jid, is_active),
+  CONSTRAINT fk_rpg_player_pokemon_owner
+    FOREIGN KEY (owner_jid) REFERENCES rpg_player(jid)
+    ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS rpg_battle_state (
+  chat_jid VARCHAR(255) PRIMARY KEY,
+  owner_jid VARCHAR(255) NOT NULL,
+  my_pokemon_id BIGINT UNSIGNED NOT NULL,
+  enemy_snapshot_json JSON NOT NULL,
+  turn INT UNSIGNED NOT NULL DEFAULT 1,
+  expires_at DATETIME NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  UNIQUE KEY uq_rpg_battle_owner (owner_jid),
+  INDEX idx_rpg_battle_expires_at (expires_at),
+  CONSTRAINT fk_rpg_battle_owner
+    FOREIGN KEY (owner_jid) REFERENCES rpg_player(jid)
+    ON DELETE CASCADE ON UPDATE CASCADE,
+  CONSTRAINT fk_rpg_battle_my_pokemon
+    FOREIGN KEY (my_pokemon_id) REFERENCES rpg_player_pokemon(id)
+    ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS rpg_player_inventory (
+  owner_jid VARCHAR(255) NOT NULL,
+  item_key VARCHAR(64) NOT NULL,
+  quantity INT UNSIGNED NOT NULL DEFAULT 0,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (owner_jid, item_key),
+  CONSTRAINT fk_rpg_inventory_owner
+    FOREIGN KEY (owner_jid) REFERENCES rpg_player(jid)
+    ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

package/database/migrations/20260210_0004_rpg_shiny_biome.sql

@@ -0,0 +1,9 @@
+ALTER TABLE rpg_player_pokemon
+  ADD COLUMN is_shiny TINYINT(1) NOT NULL DEFAULT 0 AFTER moves_json;
+
+CREATE TABLE IF NOT EXISTS rpg_group_biome (
+  group_jid VARCHAR(255) PRIMARY KEY,
+  biome_key VARCHAR(64) NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

package/database/migrations/20260210_0005_rpg_missions.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS rpg_player_mission_progress (
+  owner_jid VARCHAR(255) PRIMARY KEY,
+  daily_ref_date DATE NOT NULL,
+  daily_progress_json JSON NOT NULL,
+  daily_claimed_at DATETIME NULL,
+  weekly_ref_date DATE NOT NULL,
+  weekly_progress_json JSON NOT NULL,
+  weekly_claimed_at DATETIME NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  CONSTRAINT fk_rpg_mission_owner
+    FOREIGN KEY (owner_jid) REFERENCES rpg_player(jid)
+    ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

package/database/migrations/20260210_0006_rpg_world_pokedex_traits.sql

@@ -0,0 +1,27 @@
+ALTER TABLE rpg_player_pokemon
+  ADD COLUMN nature_key VARCHAR(64) NULL AFTER moves_json,
+  ADD COLUMN ability_key VARCHAR(64) NULL AFTER nature_key,
+  ADD COLUMN ability_name VARCHAR(120) NULL AFTER ability_key;
+
+CREATE TABLE IF NOT EXISTS rpg_player_pokedex (
+  owner_jid VARCHAR(255) NOT NULL,
+  poke_id INT UNSIGNED NOT NULL,
+  first_captured_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  PRIMARY KEY (owner_jid, poke_id),
+  INDEX idx_rpg_pokedex_owner (owner_jid),
+  CONSTRAINT fk_rpg_pokedex_owner
+    FOREIGN KEY (owner_jid) REFERENCES rpg_player(jid)
+    ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS rpg_player_travel (
+  owner_jid VARCHAR(255) PRIMARY KEY,
+  region_key VARCHAR(120) NULL,
+  location_key VARCHAR(120) NULL,
+  location_area_key VARCHAR(120) NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  CONSTRAINT fk_rpg_travel_owner
+    FOREIGN KEY (owner_jid) REFERENCES rpg_player(jid)
+    ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;