feat: send one SMS from a person or lead and keep the dashboard inside the phone frame

Co-authored-by: Cursor <cursoragent@cursor.com>

apps/api/src/leads/dto.ts

@@ -5,9 +5,17 @@ import {
   IsNumber,
   IsOptional,
   IsString,
+  MaxLength,
   MinLength,
 } from 'class-validator';
 
+export class LeadSmsDto {
+  @IsString()
+  @MinLength(1)
+  @MaxLength(500)
+  text!: string;
+}
+
 export class CreateLeadDto {
   @IsString()
   @MinLength(1)

apps/api/src/leads/leads.controller.ts

@@ -37,6 +37,7 @@ import {
   LeadCallLogDto,
   LeadFollowUpDto,
   LeadNoteDto,
+  LeadSmsDto,
   MoveLeadDto,
   ReorderLeadStagesDto,
   UpdateLeadDto,
@@ -346,6 +347,15 @@ export class LeadsController {
     return this.leads.move(user, id, dto.stageId, dto.position);
   }
 
+  @Post(':id/sms')
+  sms(
+    @CurrentUser() user: Actor,
+    @Param('id') id: string,
+    @Body() dto: LeadSmsDto,
+  ) {
+    return this.leads.sendSms(user, id, dto.text);
+  }
+
   @Post(':id/call')
   logCall(
     @CurrentUser() user: Actor,

apps/api/src/leads/leads.module.ts

@@ -5,11 +5,12 @@ import { LeadStagesService } from './lead-stages.service';
 import { LeadsController } from './leads.controller';
 import { LeadsImportService } from './leads-import.service';
 import { LeadsService } from './leads.service';
+import { SmsService } from '../common/sms.service';
 
 @Module({
   imports: [AuthModule, BillingModule],
   controllers: [LeadsController],
-  providers: [LeadsService, LeadStagesService, LeadsImportService],
+  providers: [LeadsService, LeadStagesService, LeadsImportService, SmsService],
   exports: [LeadsService, LeadStagesService],
 })
 export class LeadsModule {}

apps/api/src/leads/leads.service.ts

@@ -3,6 +3,7 @@ import {
   ConflictException,
   Injectable,
   NotFoundException,
+  ServiceUnavailableException,
 } from '@nestjs/common';
 import { Prisma } from '@prisma/client';
 import { parseBirthDate } from '../common/excel';
@@ -18,6 +19,8 @@ import type {
   PaginatedResponse,
 } from '@mento/shared';
 import { PrismaService } from '../prisma/prisma.service';
+import { SmsService } from '../common/sms.service';
+import { renderSmsText } from '../common/sms-text';
 import {
   type Actor,
   elevated,
@@ -81,6 +84,7 @@ export class LeadsService {
     private readonly stages: LeadStagesService,
     private readonly files: LocalFileStorage,
     private readonly game: GamificationService,
+    private readonly sms: SmsService,
   ) {}
 
   private gameEvent(
@@ -1203,6 +1207,34 @@ export class LeadsService {
     return this.toDto(row);
   }
 
+  async sendSms(actor: Actor, id: string, text: string) {
+    const body = text.trim();
+    if (!body || body.length > 500) {
+      throw new BadRequestException('متن پیامک را تا ۵۰۰ نویسه بنویسید.');
+    }
+    const lead = await this.findAccessible(actor, id);
+    const mobile = lead.mobile || lead.phone;
+    if (!mobile) throw new BadRequestException('برای این لید شماره موبایل ثبت نشده است.');
+    const name = (lead.contactName || lead.title).trim();
+    const message = renderSmsText(body, {
+      name,
+      phone: mobile,
+      title: lead.title,
+      company: lead.contactName ? lead.title : '',
+    });
+    if (!message) throw new BadRequestException('متن پیامک خالی است.');
+    const result = await this.sms.sendSmsDetailed(mobile, message);
+    if (!result.ok) {
+      throw new ServiceUnavailableException(
+        result.reason === 'SMS not configured'
+          ? 'ارسال پیامک روی سرور فعال نیست.'
+          : 'پیامک ارسال نشد. کمی بعد دوباره تلاش کنید.',
+      );
+    }
+    await this.addEvent(actor, id, 'note', 'پیامک ارسال شد', message);
+    return { ok: true };
+  }
+
   async openLogo(actor: Actor, id: string) {
     const existing = await this.findAccessible(actor, id);
     if (!existing.logoStorageKey) {