refactor: extract send-message normalization helpers and keep everyOne as deprecated alias

- Add src/utils/normalizeSendMessageOptions.ts with normalizeFileName (uses
  undefined-check so intentional empty fileName is preserved) and
  resolveMentionsEveryOne (accepts everyOne alias and logs a one-shot
  deprecation warning).
- Apply normalizeFileName in baileys, evolution and meta mediaMessage
  services, removing the duplicated (data as any).filename cast.
- Restore backward compatibility for everyOne: schemas accept it as a
  deprecated alias, DTOs expose it as @deprecated, and baileys uses
  resolveMentionsEveryOne when computing mentions.
- Fix unrelated axios AxiosHeaderValue type errors surfacing in pre-commit
  tsc (baileys + chatwoot content-type header casts).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: enzowilliam

src/api/dto/sendMessage.dto.ts

@@ -12,6 +12,8 @@ export class Options {
   linkPreview?: boolean;
   encoding?: boolean;
   mentionsEveryOne?: boolean;
+  /** @deprecated use `mentionsEveryOne` instead. Kept for backward compatibility; will be removed in a future release. */
+  everyOne?: boolean;
   mentioned?: string[];
   webhookUrl?: string;
   messageId?: string;
@@ -45,6 +47,8 @@ export class Metadata {
   quoted?: Quoted;
   linkPreview?: boolean;
   mentionsEveryOne?: boolean;
+  /** @deprecated use `mentionsEveryOne` instead. Kept for backward compatibility; will be removed in a future release. */
+  everyOne?: boolean;
   mentioned?: string[];
   encoding?: boolean;
   notConvertSticker?: boolean;

src/api/integrations/channel/evolution/evolution.channel.service.ts

@@ -16,6 +16,7 @@ import { Events, wa } from '@api/types/wa.types';
 import { AudioConverter, Chatwoot, ConfigService, Openai, S3 } from '@config/env.config';
 import { BadRequestException, InternalServerErrorException } from '@exceptions';
 import { createJid } from '@utils/createJid';
+import { normalizeFileName } from '@utils/normalizeSendMessageOptions';
 import { sendTelemetry } from '@utils/sendTelemetry';
 import axios from 'axios';
 import { isBase64, isURL } from 'class-validator';
@@ -607,11 +608,7 @@ export class EvolutionStartupService extends ChannelStartupService {
   }
 
   public async mediaMessage(data: SendMediaDto, file?: any, isIntegration = false) {
-    const mediaData: SendMediaDto = {
-      ...data,
-      // Normalize filename to fileName (handle case-insensitivity)
-      fileName: data.fileName || (data as any).filename,
-    };
+    const mediaData: SendMediaDto = normalizeFileName({ ...data });
 
     if (file) mediaData.media = file.buffer.toString('base64');
 

src/api/integrations/channel/meta/whatsapp.business.service.ts

@@ -23,6 +23,7 @@ import { Events, wa } from '@api/types/wa.types';
 import { AudioConverter, Chatwoot, ConfigService, Database, Openai, S3, WaBusiness } from '@config/env.config';
 import { BadRequestException, InternalServerErrorException } from '@exceptions';
 import { createJid } from '@utils/createJid';
+import { normalizeFileName } from '@utils/normalizeSendMessageOptions';
 import { status } from '@utils/renderStatus';
 import { sendTelemetry } from '@utils/sendTelemetry';
 import axios from 'axios';
@@ -1284,11 +1285,7 @@ export class BusinessStartupService extends ChannelStartupService {
   }
 
   public async mediaMessage(data: SendMediaDto, file?: any, isIntegration = false) {
-    const mediaData: SendMediaDto = {
-      ...data,
-      // Normalize filename to fileName (handle case-insensitivity)
-      fileName: data.fileName || (data as any).filename,
-    };
+    const mediaData: SendMediaDto = normalizeFileName({ ...data });
 
     if (file) mediaData.media = file.buffer.toString('base64');
 

src/api/integrations/channel/whatsapp/whatsapp.baileys.service.ts

@@ -86,6 +86,7 @@ import { Instance, Message } from '@prisma/client';
 import { createJid } from '@utils/createJid';
 import { fetchLatestWaWebVersion } from '@utils/fetchLatestWaWebVersion';
 import { makeProxyAgent, makeProxyAgentUndici } from '@utils/makeProxyAgent';
+import { normalizeFileName, resolveMentionsEveryOne } from '@utils/normalizeSendMessageOptions';
 import { getOnWhatsappCache, saveOnWhatsappCache } from '@utils/onWhatsappCache';
 import { status } from '@utils/renderStatus';
 import { sendTelemetry } from '@utils/sendTelemetry';
@@ -2643,7 +2644,7 @@ export class BaileysStartupService extends ChannelStartupService {
           throw new NotFoundException('Group not found');
         }
 
-        if (options?.mentionsEveryOne === true) {
+        if (resolveMentionsEveryOne(options)) {
           mentions = group.participants.map((participant) => participant.id);
         } else if (options?.mentioned?.length) {
           mentions = options.mentioned.map((mention) => {
@@ -3265,11 +3266,7 @@ export class BaileysStartupService extends ChannelStartupService {
   }
 
   public async mediaMessage(data: SendMediaDto, file?: any, isIntegration = false) {
-    const mediaData: SendMediaDto = {
-      ...data,
-      // Normalize filename to fileName (handle case-insensitivity)
-      fileName: data.fileName || (data as any).filename,
-    };
+    const mediaData: SendMediaDto = normalizeFileName({ ...data });
 
     if (file) mediaData.media = file.buffer.toString('base64');
 

src/utils/normalizeSendMessageOptions.ts

@@ -0,0 +1,32 @@
+import { Logger } from '@config/logger.config';
+
+const logger = new Logger('SendMessageOptions');
+const warnedAliases = new Set<string>();
+
+const warnOnce = (key: string, message: string) => {
+  if (warnedAliases.has(key)) return;
+  warnedAliases.add(key);
+  logger.warn(message);
+};
+
+export const normalizeFileName = <T extends { fileName?: string }>(data: T): T => {
+  if (!data) return data;
+  const legacy = (data as any).filename;
+  if (data.fileName === undefined && legacy !== undefined) {
+    return { ...data, fileName: legacy };
+  }
+  return data;
+};
+
+export const resolveMentionsEveryOne = (input: any): boolean => {
+  if (!input) return false;
+  if (input.mentionsEveryOne === true) return true;
+  if (input.everyOne === true) {
+    warnOnce(
+      'everyOne',
+      '"everyOne" is deprecated and will be removed in a future release. Use "mentionsEveryOne" instead.',
+    );
+    return true;
+  }
+  return false;
+};

src/validate/message.schema.ts

@@ -78,6 +78,7 @@ export const textMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,
@@ -117,6 +118,7 @@ export const mediaMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,
@@ -143,6 +145,7 @@ export const ptvMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,
@@ -169,6 +172,7 @@ export const audioMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,
@@ -219,6 +223,7 @@ export const stickerMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,
@@ -248,6 +253,7 @@ export const locationMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,
@@ -335,6 +341,7 @@ export const pollMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,
@@ -392,6 +399,7 @@ export const listMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,
@@ -443,6 +451,7 @@ export const buttonsMessageSchema: JSONSchema7 = {
     },
     quoted: { ...quotedOptionsSchema },
     mentionsEveryOne: { type: 'boolean', enum: [true, false] },
+    everyOne: { type: 'boolean', enum: [true, false], description: 'Deprecated alias for "mentionsEveryOne".' },
     mentioned: {
       type: 'array',
       minItems: 1,