feat(F-113): completed feature

project/src/modules/orders/infrastructure/order-status-mailer.ts

@@ -30,6 +30,7 @@ export interface OrderStatusNotificationInput {
   orderId: string;
   state: string;
   trackingNumber?: string | null;
+  courier?: string | null;
 }
 
 /**
@@ -65,20 +66,36 @@ export async function sendOrderStatusEmail(
     auth: { user, pass: password },
   });
 
+  await transporter.sendMail({
+    from,
+    to: input.to,
+    ...buildOrderStatusEmail(input),
+  });
+}
+
+/**
+ * Builds the status-change email body. Pure function so the courier/tracking
+ * content can be unit tested without SMTP.
+ */
+export function buildOrderStatusEmail(input: OrderStatusNotificationInput): {
+  subject: string;
+  text: string;
+  html: string;
+} {
   const shortId = input.orderId.slice(0, 8);
   const stateLabel = ORDER_STATE_LABELS[input.state] ?? input.state;
+  const courierLine = input.courier?.trim() ? `Transportista: ${input.courier.trim()}` : '';
   const trackingLine = input.trackingNumber
     ? `Número de seguimiento: ${input.trackingNumber}`
     : '';
 
-  await transporter.sendMail({
-    from,
-    to: input.to,
+  return {
     subject: `Tu pedido #${shortId} ahora está: ${stateLabel} — Mercado de Vida`,
     text: [
       `Hola,`,
       '',
       `Tu pedido #${shortId} ha cambiado de estado: ${stateLabel}.`,
+      courierLine,
       trackingLine,
       '',
       'Puedes consultar el detalle desde tu cuenta en mercadodevida.',
@@ -90,11 +107,12 @@ export async function sendOrderStatusEmail(
     html: [
       `<p>Hola,</p>`,
       `<p>Tu pedido <strong>#${escapeHtml(shortId)}</strong> ha cambiado de estado: <strong>${escapeHtml(stateLabel)}</strong>.</p>`,
+      courierLine ? `<p>Transportista: <strong>${escapeHtml(input.courier ?? '')}</strong></p>` : '',
       trackingLine ? `<p>Número de seguimiento: <strong>${escapeHtml(input.trackingNumber ?? '')}</strong></p>` : '',
       `<p>Puedes consultar el detalle desde tu cuenta en mercadodevida.</p>`,
       `<p>Gracias por tu compra.</p>`,
     ]
       .filter((line) => line !== '')
       .join(''),
-  });
+  };
 }

project/src/modules/orders/infrastructure/pg-order-repository.ts

@@ -13,6 +13,7 @@ interface OrderRow {
   tax_cents: number;
   total_cents: number;
   tracking_number: string | null;
+  courier: string | null;
   created_at: Date;
   updated_at: Date;
 }
@@ -178,11 +179,11 @@ export class PgOrderRepository implements OrderRepository {
     return { ...toOrder(order), items: items.rows.map(toItem) };
   }
 
-  async updateState(id: string, state: OrderState, trackingNumber?: string): Promise<OrderView | undefined> {
+  async updateState(id: string, state: OrderState, trackingNumber?: string, courier?: string): Promise<OrderView | undefined> {
     const result = await this.pool.query<OrderRow>(
-      `UPDATE orders_orders SET state = $2, tracking_number = COALESCE($3, tracking_number), updated_at = now()
+      `UPDATE orders_orders SET state = $2, tracking_number = COALESCE($3, tracking_number), courier = COALESCE($4, courier), updated_at = now()
        WHERE id = $1 RETURNING *`,
-      [id, state, trackingNumber ?? null],
+      [id, state, trackingNumber ?? null, courier ?? null],
     );
     const order = result.rows[0];
     if (!order) return undefined;
@@ -249,6 +250,7 @@ function toOrder(row: OrderRow): Order {
     taxCents: row.tax_cents,
     totalCents: row.total_cents,
     trackingNumber: row.tracking_number,
+    courier: row.courier,
     createdAt: row.created_at,
     updatedAt: row.updated_at,
   };