@omnizap-system/omnizap 2.5.12

package/app/modules/stickerPackModule/commandConfig.json

@@ -0,0 +1,387 @@
+{
+  "schema_version": "2.0.0",
+  "module": "stickerPackModule",
+  "enabled": true,
+  "source_files": ["stickerPackCommandHandlers.js"],
+  "defaults": {
+    "inheritance_mode": "deep_merge_with_command_overrides",
+    "compatibility_mode": "legacy_and_v2_fields",
+    "legacy_field_aliases": {
+      "descricao": "description",
+      "metodos_de_uso": "usage",
+      "permissao_necessaria": "permission",
+      "local_de_uso": "contexts",
+      "informacoes_coletadas": "collected_data",
+      "pre_condicoes": "requirements",
+      "dependencias_externas": "dependencies",
+      "efeitos_colaterais": "side_effects",
+      "observabilidade": "observability",
+      "privacidade": "privacy",
+      "limite_uso_por_plano": "plan_limits",
+      "argumentos": "arguments",
+      "acesso": "access"
+    },
+    "command": {
+      "enabled": true,
+      "category": "figurinhas",
+      "version": "1.0.0",
+      "stability": "stable",
+      "deprecated": false,
+      "replaced_by": null,
+      "risk_level": "medium"
+    },
+    "requirements": {
+      "require_group": false,
+      "require_group_admin": false,
+      "require_bot_owner": false,
+      "require_google_login": true,
+      "require_nsfw_enabled": false,
+      "require_media": false,
+      "require_reply_message": false,
+      "legacy": {
+        "requer_grupo": false,
+        "requer_admin": false,
+        "requer_admin_principal": false,
+        "requer_google_login": true,
+        "requer_nsfw": false,
+        "requer_midia": false,
+        "requer_mensagem_respondida": false
+      }
+    },
+    "pre_condicoes": {
+      "requer_grupo": false,
+      "requer_admin": false,
+      "requer_admin_principal": false,
+      "requer_google_login": true,
+      "requer_nsfw": false,
+      "requer_midia": false,
+      "requer_mensagem_respondida": false
+    },
+    "rate_limit": {
+      "max": 20,
+      "janela_ms": 60000,
+      "escopo": "usuario"
+    },
+    "dependencies": ["banco de dados de packs", "armazenamento de assets de figurinha"],
+    "dependencias_externas": ["banco de dados de packs", "armazenamento de assets de figurinha"],
+    "responses": {
+      "success": "Comando executado com sucesso.",
+      "usage_error": "Formato de uso inválido. Consulte metodos_de_uso.",
+      "permission_error": "Permissão insuficiente para executar este comando."
+    },
+    "respostas_padrao": {
+      "sucesso": "Comando executado com sucesso.",
+      "erro_uso": "Formato de uso inválido. Consulte metodos_de_uso.",
+      "erro_permissao": "Permissão insuficiente para executar este comando."
+    },
+    "observability": {
+      "event_name": "command.executed",
+      "log_level": "info",
+      "tags": ["whatsapp", "command", "stickerPackModule"]
+    },
+    "privacy": {
+      "data_categories": ["chat_identifier", "sender_identifier", "command_content"],
+      "retention_policy": "standard_app_logs",
+      "legal_basis": "service_execution_and_legitimate_interest"
+    },
+    "access": {
+      "premium_only": false,
+      "allowed_plans": ["comum", "premium"]
+    },
+    "acesso": {
+      "somente_premium": false,
+      "planos_permitidos": ["comum", "premium"]
+    },
+    "plan_limits": {
+      "comum": {
+        "max": 12,
+        "janela_ms": 300000,
+        "escopo": "usuario"
+      },
+      "premium": {
+        "max": 45,
+        "janela_ms": 300000,
+        "escopo": "usuario"
+      }
+    },
+    "limite_uso_por_plano": {
+      "comum": {
+        "max": 12,
+        "janela_ms": 300000,
+        "escopo": "usuario"
+      },
+      "premium": {
+        "max": 45,
+        "janela_ms": 300000,
+        "escopo": "usuario"
+      }
+    },
+    "behavior_templates": {
+      "toggle_on_off_status": {
+        "type": "toggle",
+        "allowed_actions": ["on", "off", "status"],
+        "action_argument": "acao"
+      },
+      "add_remove_list": {
+        "type": "list_management",
+        "allowed_actions": ["add", "remove", "list"],
+        "action_argument": "acao"
+      },
+      "approve_reject": {
+        "type": "moderation_decision",
+        "allowed_actions": ["approve", "reject"],
+        "action_argument": "acao",
+        "requires_targets": true
+      },
+      "set_status_reset": {
+        "type": "configuration_window",
+        "allowed_actions": ["set", "status", "reset"],
+        "action_argument": "valor"
+      }
+    }
+  },
+  "commands": [
+    {
+      "name": "pacote",
+      "aliases": ["packs", "pacotes", "pack"],
+      "descricao": "Gerencia packs de figurinhas (criar, listar, adicionar, enviar).",
+      "metodos_de_uso": ["<prefix>pacote help", "<prefix>pacote create meupack", "<prefix>pacote list", "<prefix>pacote add <pacote>", "<prefix>pacote send <pacote>"],
+      "permissao_necessaria": "usuario comum",
+      "limite_de_uso": "rate limit por janela e limite de itens por pack",
+      "local_de_uso": ["privado", "grupo"],
+      "informacoes_coletadas": ["identificador do chat (remoteJid)", "identificador do remetente (senderJid)", "texto do comando e argumentos", "contexto da mensagem (citacao e mencoes, quando existir)", "subcomando e argumentos do pack", "figurinha da mensagem atual/citada (para add/setcover)", "estado de rate limit por usuario", "dados de packs do usuario no armazenamento interno"],
+      "enabled": true,
+      "categoria": "figurinhas",
+      "subcomandos": ["help", "create", "list", "info", "add", "setcover", "setdesc", "setpublisher", "send", "rename", "remove", "delete", "reorder"],
+      "argumentos": [
+        {
+          "nome": "subcomando",
+          "tipo": "string",
+          "obrigatorio": true,
+          "validacao": "ação de gerenciamento de pack",
+          "default": null
+        },
+        {
+          "nome": "parametros",
+          "tipo": "array<string>",
+          "obrigatorio": false,
+          "validacao": "dependente do subcomando",
+          "default": []
+        }
+      ],
+      "pre_condicoes": {
+        "requer_grupo": false,
+        "requer_admin": false,
+        "requer_admin_principal": false,
+        "requer_google_login": true,
+        "requer_nsfw": false,
+        "requer_midia": false,
+        "requer_mensagem_respondida": false
+      },
+      "rate_limit": {
+        "max": 20,
+        "janela_ms": 60000,
+        "escopo": "usuario"
+      },
+      "dependencias_externas": ["banco de dados de packs", "armazenamento de assets de figurinha"],
+      "efeitos_colaterais": ["cria/atualiza packs no banco", "pode armazenar/remover assets de figurinha"],
+      "respostas_padrao": {
+        "sucesso": "Comando executado com sucesso.",
+        "erro_uso": "Formato de uso inválido. Consulte metodos_de_uso.",
+        "erro_permissao": "Permissão insuficiente para executar este comando."
+      },
+      "observabilidade": {
+        "evento_analytics": "whatsapp_command_pack",
+        "tags_log": ["whatsapp", "command", "stickerPackModule", "pack"],
+        "nivel_log": "info"
+      },
+      "privacidade": {
+        "dados_sensiveis": ["identificador do remetente", "conteúdo de figurinhas adicionadas ao pack", "metadados de packs do usuário"],
+        "retencao": "conforme políticas de logs, banco de dados e arquivos temporários da aplicação",
+        "base_legal": "execução do serviço solicitado e legítimo interesse operacional"
+      },
+      "capability_keywords": ["pacote", "packs", "figurinhas", "privado", "grupo"],
+      "faq_patterns": ["como usar pacote", "o que faz pacote", "comando pacote"],
+      "user_phrasings": ["quero usar pacote", "me ajuda com pacote", "gerencia packs de figurinhas"],
+      "suggestion_priority": 100,
+      "acesso": {
+        "somente_premium": false,
+        "planos_permitidos": ["comum", "premium"]
+      },
+      "limite_uso_por_plano": {
+        "comum": {
+          "max": 12,
+          "janela_ms": 300000,
+          "escopo": "usuario"
+        },
+        "premium": {
+          "max": 45,
+          "janela_ms": 300000,
+          "escopo": "usuario"
+        }
+      },
+      "mensagens_uso": {
+        "default": ["<prefix>pacote help", "<prefix>pacote create meupack", "<prefix>pacote list", "<prefix>pacote add <pacote>", "<prefix>pacote send <pacote>"]
+      },
+      "id": "stickerpack.pacote",
+      "description": "Gerencia packs de figurinhas (criar, listar, adicionar, enviar).",
+      "usage": ["<prefix>pacote help", "<prefix>pacote create meupack", "<prefix>pacote list", "<prefix>pacote add <pacote>", "<prefix>pacote send <pacote>"],
+      "docs": {
+        "summary": "Gerencia packs de figurinhas (criar, listar, adicionar, enviar).",
+        "usage_examples": ["<prefix>pacote help", "<prefix>pacote create meupack", "<prefix>pacote list", "<prefix>pacote add <pacote>", "<prefix>pacote send <pacote>"],
+        "usage_variants": {
+          "default": ["<prefix>pacote help", "<prefix>pacote create meupack", "<prefix>pacote list", "<prefix>pacote add <pacote>", "<prefix>pacote send <pacote>"]
+        }
+      },
+      "permission": "usuario comum",
+      "contexts": ["privado", "grupo"],
+      "collected_data": ["identificador do chat (remoteJid)", "identificador do remetente (senderJid)", "texto do comando e argumentos", "contexto da mensagem (citacao e mencoes, quando existir)", "subcomando e argumentos do pack", "figurinha da mensagem atual/citada (para add/setcover)", "estado de rate limit por usuario", "dados de packs do usuario no armazenamento interno"],
+      "requirements": {
+        "require_group": false,
+        "require_group_admin": false,
+        "require_bot_owner": false,
+        "require_google_login": true,
+        "require_nsfw_enabled": false,
+        "require_media": false,
+        "require_reply_message": false,
+        "legacy": {
+          "requer_grupo": false,
+          "requer_admin": false,
+          "requer_admin_principal": false,
+          "requer_google_login": true,
+          "requer_nsfw": false,
+          "requer_midia": false,
+          "requer_mensagem_respondida": false
+        }
+      },
+      "arguments": [
+        {
+          "name": "subcomando",
+          "type": "string",
+          "required": true,
+          "default": null,
+          "enum": null,
+          "description": "ação de gerenciamento de pack",
+          "position": 0,
+          "accepts_mentions": false,
+          "accepts_reply_target": false,
+          "greedy": false,
+          "validation": "ação de gerenciamento de pack"
+        },
+        {
+          "name": "parametros",
+          "type": "array",
+          "required": false,
+          "default": [],
+          "enum": null,
+          "description": "dependente do subcomando",
+          "position": 1,
+          "accepts_mentions": false,
+          "accepts_reply_target": false,
+          "greedy": false,
+          "validation": "dependente do subcomando"
+        }
+      ],
+      "behavior": {
+        "type": "list_management",
+        "allowed_actions": ["add", "remove", "list"],
+        "action_argument": "acao"
+      },
+      "limits": {
+        "usage_description": "rate limit por janela e limite de itens por pack",
+        "rate_limit": {
+          "max": 20,
+          "janela_ms": 60000,
+          "escopo": "usuario"
+        },
+        "access": {
+          "somente_premium": false,
+          "planos_permitidos": ["comum", "premium"]
+        },
+        "plan_limits": {
+          "comum": {
+            "max": 12,
+            "janela_ms": 300000,
+            "escopo": "usuario"
+          },
+          "premium": {
+            "max": 45,
+            "janela_ms": 300000,
+            "escopo": "usuario"
+          }
+        }
+      },
+      "dependencies": ["banco de dados de packs", "armazenamento de assets de figurinha"],
+      "side_effects": ["cria/atualiza packs no banco", "pode armazenar/remover assets de figurinha"],
+      "observability": {
+        "event_name": "command.executed",
+        "event_key": "stickerpack.pacote",
+        "analytics_event": "whatsapp_command_pack",
+        "log_level": "info",
+        "tags": ["whatsapp", "command", "stickerPackModule", "pack"],
+        "legacy": {
+          "evento_analytics": "whatsapp_command_pack",
+          "tags_log": ["whatsapp", "command", "stickerPackModule", "pack"],
+          "nivel_log": "info"
+        }
+      },
+      "privacy": {
+        "data_categories": ["sender_identifier"],
+        "sensitive_fields": ["senderJid"],
+        "retention_policy": "standard_app_logs",
+        "retention_notes": "conforme políticas de logs, banco de dados e arquivos temporários da aplicação",
+        "legal_basis": "service_execution_and_legitimate_interest",
+        "legal_basis_notes": "execução do serviço solicitado e legítimo interesse operacional",
+        "legacy": {
+          "dados_sensiveis": ["identificador do remetente", "conteúdo de figurinhas adicionadas ao pack", "metadados de packs do usuário"],
+          "retencao": "conforme políticas de logs, banco de dados e arquivos temporários da aplicação",
+          "base_legal": "execução do serviço solicitado e legítimo interesse operacional"
+        }
+      },
+      "discovery": {
+        "keywords": ["pacote", "packs", "figurinhas", "privado", "grupo"],
+        "faq_queries": ["como usar pacote", "o que faz pacote", "comando pacote"],
+        "user_phrasings": ["quero usar pacote", "me ajuda com pacote", "gerencia packs de figurinhas"],
+        "suggestion_priority": 100
+      },
+      "access": {
+        "premium_only": false,
+        "allowed_plans": ["comum", "premium"],
+        "legacy": {
+          "somente_premium": false,
+          "planos_permitidos": ["comum", "premium"]
+        }
+      },
+      "plan_limits": {
+        "comum": {
+          "max": 12,
+          "janela_ms": 300000,
+          "escopo": "usuario"
+        },
+        "premium": {
+          "max": 45,
+          "janela_ms": 300000,
+          "escopo": "usuario"
+        }
+      },
+      "version": "1.0.0",
+      "stability": "stable",
+      "deprecated": false,
+      "replaced_by": null,
+      "risk_level": "low",
+      "handler": {
+        "file": "stickerPackCommandHandlers.js",
+        "method": "handlePackCommand",
+        "command_case": "pacote"
+      },
+      "compatibility": {
+        "schema": "legacy_v1_and_v2",
+        "legacy_name": "pacote",
+        "legacy_fields_present": ["descricao", "metodos_de_uso", "permissao_necessaria", "local_de_uso", "informacoes_coletadas", "argumentos", "pre_condicoes", "dependencias_externas", "efeitos_colaterais", "observabilidade", "privacidade", "acesso", "limite_uso_por_plano"]
+      }
+    }
+  ],
+  "textos": {
+    "usage_header": ""
+  }
+}

package/app/modules/stickerPackModule/domainEventOutboxRepository.js

@@ -0,0 +1,227 @@
+import { randomUUID } from 'node:crypto';
+
+import { executeQuery, TABLES } from '../../../database/index.js';
+import { normalizeDomainEventPayload } from './domainEvents.js';
+
+const normalizeStatus = (value) => {
+  const normalized = String(value || '')
+    .trim()
+    .toLowerCase();
+  if (['pending', 'processing', 'completed', 'failed'].includes(normalized)) return normalized;
+  return null;
+};
+
+const parseJson = (value, fallback = null) => {
+  if (value === null || value === undefined) return fallback;
+  if (typeof value === 'object') return value;
+  if (Buffer.isBuffer(value)) {
+    try {
+      return JSON.parse(value.toString('utf8'));
+    } catch {
+      return fallback;
+    }
+  }
+  if (typeof value === 'string') {
+    try {
+      return JSON.parse(value);
+    } catch {
+      return fallback;
+    }
+  }
+  return fallback;
+};
+
+const clampInt = (value, fallback, min, max) => {
+  const numeric = Number(value);
+  if (!Number.isFinite(numeric)) return fallback;
+  return Math.max(min, Math.min(max, Math.floor(numeric)));
+};
+
+const CLAIM_LOCK_TIMEOUT_SECONDS = clampInt(process.env.DOMAIN_EVENT_OUTBOX_LOCK_TIMEOUT_SECONDS, 15 * 60, 30, 24 * 60 * 60);
+
+const normalizeRow = (row) => {
+  if (!row) return null;
+  return {
+    id: Number(row.id),
+    event_type: row.event_type,
+    aggregate_type: row.aggregate_type,
+    aggregate_id: row.aggregate_id,
+    payload: parseJson(row.payload, {}),
+    status: row.status,
+    priority: Number(row.priority || 0),
+    idempotency_key: row.idempotency_key || null,
+    available_at: row.available_at || null,
+    attempts: Number(row.attempts || 0),
+    max_attempts: Number(row.max_attempts || 0),
+    worker_token: row.worker_token || null,
+    last_error: row.last_error || null,
+    locked_at: row.locked_at || null,
+    processed_at: row.processed_at || null,
+    created_at: row.created_at || null,
+    updated_at: row.updated_at || null,
+  };
+};
+
+export async function enqueueDomainEvent(eventPayload, connection = null) {
+  const normalized = normalizeDomainEventPayload(eventPayload);
+  if (!normalized) return false;
+
+  await executeQuery(
+    `INSERT INTO ${TABLES.DOMAIN_EVENT_OUTBOX}
+      (
+        event_type,
+        aggregate_type,
+        aggregate_id,
+        payload,
+        status,
+        priority,
+        idempotency_key,
+        available_at,
+        attempts,
+        max_attempts
+      )
+     VALUES (?, ?, ?, ?, 'pending', ?, ?, COALESCE(?, UTC_TIMESTAMP()), 0, ?)
+     ON DUPLICATE KEY UPDATE
+      priority = GREATEST(priority, VALUES(priority)),
+      available_at = LEAST(available_at, VALUES(available_at)),
+      updated_at = CURRENT_TIMESTAMP`,
+    [normalized.event_type, normalized.aggregate_type, normalized.aggregate_id, JSON.stringify(normalized.payload ?? {}), normalized.priority, normalized.idempotency_key, normalized.available_at, normalized.max_attempts],
+    connection,
+  );
+  return true;
+}
+
+export async function claimDomainEvent({ eventTypes = [], allowRetryFailed = true } = {}, connection = null) {
+  const workerToken = randomUUID();
+  const statusClause = allowRetryFailed
+    ? `(status = 'pending'
+      OR (status = 'failed' AND attempts < max_attempts)
+      OR (status = 'processing' AND locked_at <= (UTC_TIMESTAMP() - INTERVAL ${CLAIM_LOCK_TIMEOUT_SECONDS} SECOND)))`
+    : `(status = 'pending'
+      OR (status = 'processing' AND locked_at <= (UTC_TIMESTAMP() - INTERVAL ${CLAIM_LOCK_TIMEOUT_SECONDS} SECOND)))`;
+
+  const normalizedTypes = Array.from(
+    new Set(
+      (Array.isArray(eventTypes) ? eventTypes : [])
+        .map((type) =>
+          String(type || '')
+            .trim()
+            .toUpperCase(),
+        )
+        .filter(Boolean),
+    ),
+  );
+
+  let eventTypeClause = '';
+  let params = [workerToken];
+  if (normalizedTypes.length) {
+    eventTypeClause = `AND event_type IN (${normalizedTypes.map(() => '?').join(', ')})`;
+    params = [workerToken, ...normalizedTypes];
+  }
+
+  await executeQuery(
+    `UPDATE ${TABLES.DOMAIN_EVENT_OUTBOX}
+     SET status = 'processing',
+         worker_token = ?,
+         locked_at = UTC_TIMESTAMP(),
+         attempts = attempts + 1,
+         updated_at = UTC_TIMESTAMP()
+     WHERE id = (
+       SELECT id FROM (
+         SELECT id
+         FROM ${TABLES.DOMAIN_EVENT_OUTBOX}
+         WHERE ${statusClause}
+           ${eventTypeClause}
+           AND available_at <= UTC_TIMESTAMP()
+         ORDER BY priority DESC, available_at ASC, id ASC
+         LIMIT 1
+       ) picked
+     )`,
+    params,
+    connection,
+  );
+
+  const rows = await executeQuery(
+    `SELECT *
+     FROM ${TABLES.DOMAIN_EVENT_OUTBOX}
+     WHERE worker_token = ?
+       AND status = 'processing'
+     ORDER BY id DESC
+     LIMIT 1`,
+    [workerToken],
+    connection,
+  );
+
+  return normalizeRow(rows?.[0] || null);
+}
+
+export async function completeDomainEvent(eventId, connection = null) {
+  if (!eventId) return false;
+  await executeQuery(
+    `UPDATE ${TABLES.DOMAIN_EVENT_OUTBOX}
+     SET status = 'completed',
+         processed_at = UTC_TIMESTAMP(),
+         worker_token = NULL,
+         locked_at = NULL,
+         last_error = NULL,
+         updated_at = CURRENT_TIMESTAMP
+     WHERE id = ?`,
+    [eventId],
+    connection,
+  );
+  return true;
+}
+
+export async function failDomainEvent(eventId, { error = null, retryDelaySeconds = 0 } = {}, connection = null) {
+  if (!eventId) return false;
+
+  const safeDelay = clampInt(retryDelaySeconds, 0, 0, 86400 * 7);
+  const message =
+    String(error || '')
+      .trim()
+      .slice(0, 255) || null;
+
+  await executeQuery(
+    `UPDATE ${TABLES.DOMAIN_EVENT_OUTBOX}
+     SET status = IF(attempts >= max_attempts, 'failed', 'pending'),
+         worker_token = NULL,
+         locked_at = NULL,
+         last_error = ?,
+         available_at = IF(attempts >= max_attempts, available_at, UTC_TIMESTAMP() + INTERVAL ${safeDelay} SECOND),
+         updated_at = CURRENT_TIMESTAMP,
+         processed_at = IF(attempts >= max_attempts, UTC_TIMESTAMP(), processed_at)
+     WHERE id = ?`,
+    [message, eventId],
+    connection,
+  );
+
+  await executeQuery(
+    `INSERT INTO ${TABLES.DOMAIN_EVENT_OUTBOX_DLQ}
+      (outbox_event_id, event_type, aggregate_type, aggregate_id, payload, attempts, max_attempts, last_error)
+     SELECT id, event_type, aggregate_type, aggregate_id, payload, attempts, max_attempts, last_error
+       FROM ${TABLES.DOMAIN_EVENT_OUTBOX}
+      WHERE id = ?
+        AND status = 'failed'
+     ON DUPLICATE KEY UPDATE
+      last_error = VALUES(last_error),
+      attempts = VALUES(attempts),
+      max_attempts = VALUES(max_attempts),
+      failed_at = CURRENT_TIMESTAMP`,
+    [eventId],
+    connection,
+  ).catch(() => null);
+  return true;
+}
+
+export async function countDomainEventsByStatus(status = 'pending', connection = null) {
+  const normalized = normalizeStatus(status);
+  if (!normalized) return 0;
+  const rows = await executeQuery(
+    `SELECT COUNT(*) AS total
+     FROM ${TABLES.DOMAIN_EVENT_OUTBOX}
+     WHERE status = ?`,
+    [normalized],
+    connection,
+  );
+  return Number(rows?.[0]?.total || 0);
+}

package/app/modules/stickerPackModule/domainEvents.js

@@ -0,0 +1,52 @@
+export const STICKER_DOMAIN_EVENTS = Object.freeze({
+  STICKER_ASSET_CREATED: 'STICKER_ASSET_CREATED',
+  STICKER_CLASSIFIED: 'STICKER_CLASSIFIED',
+  PACK_UPDATED: 'PACK_UPDATED',
+  ENGAGEMENT_RECORDED: 'ENGAGEMENT_RECORDED',
+});
+
+export const STICKER_DOMAIN_EVENT_TYPES = new Set(Object.values(STICKER_DOMAIN_EVENTS));
+
+const normalizeType = (value) =>
+  String(value || '')
+    .trim()
+    .toUpperCase()
+    .replace(/[^A-Z0-9_]/g, '')
+    .slice(0, 96);
+
+const normalizeAggregateType = (value) =>
+  String(value || '')
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9_:-]/g, '')
+    .slice(0, 96);
+
+const normalizeAggregateId = (value) =>
+  String(value || '')
+    .trim()
+    .slice(0, 128);
+
+const normalizeIdempotencyKey = (value) =>
+  String(value || '')
+    .trim()
+    .replace(/[^a-zA-Z0-9_:-]/g, '')
+    .slice(0, 180);
+
+export const normalizeDomainEventPayload = ({ eventType, aggregateType, aggregateId, payload = null, priority = 50, availableAt = null, idempotencyKey = '', maxAttempts = 10 } = {}) => {
+  const normalizedType = normalizeType(eventType);
+  if (!normalizedType) return null;
+  const normalizedAggregateType = normalizeAggregateType(aggregateType);
+  const normalizedAggregateId = normalizeAggregateId(aggregateId);
+  if (!normalizedAggregateType || !normalizedAggregateId) return null;
+
+  return {
+    event_type: normalizedType,
+    aggregate_type: normalizedAggregateType,
+    aggregate_id: normalizedAggregateId,
+    payload: payload && typeof payload === 'object' ? payload : (payload ?? null),
+    priority: Math.max(1, Math.min(100, Number(priority) || 50)),
+    available_at: availableAt ? new Date(availableAt) : null,
+    idempotency_key: normalizeIdempotencyKey(idempotencyKey) || null,
+    max_attempts: Math.max(1, Math.min(30, Number(maxAttempts) || 10)),
+  };
+};