snapshot of https://github.com/RocketChat/Rocket.Chat.git (develop, 2026-09-16; blobs > 131072B omitted)

apps/meteor/server/meteor-methods/omnichannel/sendFileLivechatMessage.ts

@@ -0,0 +1,97 @@
+import type {
+	FileAttachmentProps,
+	ImageAttachmentProps,
+	AudioAttachmentProps,
+	VideoAttachmentProps,
+	IUpload,
+} from '@rocket.chat/core-typings';
+import { LivechatVisitors, LivechatRooms } from '@rocket.chat/models';
+import { Random } from '@rocket.chat/random';
+import { Match, check } from 'meteor/check';
+
+import { sendMessageLivechat } from './sendMessageLivechat';
+import { FileUpload } from '../../lib/media/file-upload';
+
+interface ISendFileLivechatMessage {
+	roomId: string;
+	visitorToken: string;
+	file: IUpload;
+	msgData?: { avatar?: string; emoji?: string; alias?: string; groupable?: boolean; msg?: string };
+}
+
+export const sendFileLivechatMessage = async ({ roomId, visitorToken, file, msgData = {} }: ISendFileLivechatMessage): Promise<boolean> => {
+	const visitor = await LivechatVisitors.getVisitorByToken(visitorToken);
+
+	if (!visitor) {
+		return false;
+	}
+
+	const room = await LivechatRooms.findOneOpenByRoomIdAndVisitorToken(roomId, visitorToken);
+
+	if (!room) {
+		return false;
+	}
+
+	check(msgData, {
+		avatar: Match.Optional(String),
+		emoji: Match.Optional(String),
+		alias: Match.Optional(String),
+		groupable: Match.Optional(Boolean),
+		msg: Match.Optional(String),
+	});
+
+	const fileUrl = file.name && FileUpload.getPath(`${file._id}/${encodeURI(file.name)}`);
+
+	const attachment: Partial<FileAttachmentProps> = {
+		title: file.name,
+		type: 'file',
+		description: file.description,
+		title_link: fileUrl,
+		title_link_download: true,
+	};
+
+	if (file.type && /^image\/.+/.test(file.type)) {
+		(attachment as ImageAttachmentProps).image_url = fileUrl || '';
+		(attachment as ImageAttachmentProps).image_type = file.type;
+		(attachment as ImageAttachmentProps).image_size = file.size;
+		if (file.identify?.size) {
+			(attachment as ImageAttachmentProps).image_dimensions = file.identify.size;
+		}
+		(attachment as ImageAttachmentProps).image_preview = await FileUpload.resizeImagePreview(file);
+	} else if (file.type && /^audio\/.+/.test(file.type)) {
+		(attachment as AudioAttachmentProps).audio_url = fileUrl || '';
+		(attachment as AudioAttachmentProps).audio_type = file.type;
+		(attachment as AudioAttachmentProps).audio_size = file.size;
+	} else if (file.type && /^video\/.+/.test(file.type)) {
+		(attachment as VideoAttachmentProps).video_url = fileUrl || '';
+		(attachment as VideoAttachmentProps).video_type = file.type;
+		(attachment as VideoAttachmentProps).video_size = file.size || 0;
+	}
+
+	const msg = Object.assign(
+		{
+			_id: Random.id(),
+			rid: roomId,
+			ts: new Date(),
+			msg: '',
+			file: {
+				_id: file._id,
+				name: file.name,
+				type: file.type,
+			},
+			files: [
+				{
+					_id: file._id,
+					name: file.name,
+					type: file.type,
+				},
+			],
+			groupable: false,
+			attachments: [attachment],
+			token: visitorToken,
+		},
+		msgData,
+	);
+
+	return sendMessageLivechat({ message: msg });
+};

apps/meteor/server/meteor-methods/omnichannel/sendMessageLivechat.ts

@@ -0,0 +1,82 @@
+import { OmnichannelSourceType } from '@rocket.chat/core-typings';
+import type { ServerMethods } from '@rocket.chat/ddp-client';
+import { LivechatVisitors } from '@rocket.chat/models';
+import { Match, check } from 'meteor/check';
+import { Meteor } from 'meteor/meteor';
+
+import { methodDeprecationLogger } from '../../lib/deprecationWarningLogger';
+import type { ILivechatMessage } from '../../lib/omnichannel/localTypes';
+import { sendMessage } from '../../lib/omnichannel/messages';
+import { settings } from '../../settings';
+
+interface ILivechatMessageAgent {
+	agentId: string;
+	username: string;
+}
+
+interface ISendMessageLivechat {
+	message: ILivechatMessage;
+	agent?: ILivechatMessageAgent;
+}
+
+declare module '@rocket.chat/ddp-client' {
+	// eslint-disable-next-line @typescript-eslint/naming-convention
+	interface ServerMethods {
+		sendMessageLivechat(message: ILivechatMessage, agent: ILivechatMessageAgent): boolean;
+	}
+}
+
+export const sendMessageLivechat = async ({
+	message: { token, _id, rid, msg, file, files, attachments },
+	agent,
+}: ISendMessageLivechat): Promise<boolean> => {
+	check(token, String);
+	check(_id, String);
+	check(rid, String);
+	check(msg, String);
+
+	check(
+		agent,
+		Match.Maybe({
+			agentId: String,
+			username: String,
+		}),
+	);
+
+	// No projection: the guest is forwarded into the message-sending pipeline, which expects a full visitor.
+	const guest = await LivechatVisitors.getVisitorByToken(token);
+
+	if (!guest) {
+		throw new Meteor.Error('invalid-token');
+	}
+
+	if (settings.get('Livechat_enable_message_character_limit') && msg.length > parseInt(settings.get('Livechat_message_character_limit'))) {
+		throw new Meteor.Error('message-length-exceeds-character-limit');
+	}
+
+	return sendMessage({
+		guest,
+		message: {
+			_id,
+			rid,
+			msg,
+			token,
+			file,
+			files,
+			attachments,
+		},
+		agent,
+		roomInfo: {
+			source: {
+				type: OmnichannelSourceType.API,
+			},
+		},
+	});
+};
+
+Meteor.methods<ServerMethods>({
+	async sendMessageLivechat({ token, _id, rid, msg, file, files, attachments }: ILivechatMessage, agent: ILivechatMessageAgent) {
+		methodDeprecationLogger.method('sendMessageLivechat', '9.0.0', '/v1/livechat/message');
+		return sendMessageLivechat({ message: { token, _id, rid, msg, file, files, attachments }, agent });
+	},
+});