Initial commit - Route Commerce platform

2026-06-01 19:40:55 +00:00
commit 53a9671461
617 changed files with 106132 additions and 0 deletions
@@ -0,0 +1,310 @@
+"use server";
+
+import { getAdminUser } from "@/lib/admin-permissions";
+import { svcHeaders } from "@/lib/svc-headers";
+
+const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL!;
+const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY!;
+
+// ── Types ─────────────────────────────────────────────────────────────────────
+
+export type AbandonedCart = {
+  id: string;
+  brand_id: string;
+  customer_id: string | null;
+  contact_email: string;
+  contact_name: string | null;
+  cart_snapshot: {
+    items: { name: string; quantity: number; unit_price: number }[];
+    subtotal: number;
+    item_count: number;
+  };
+  brand_name: string | null;
+  locale: string;
+  sequence_step: number;
+  last_email_sent_at: string | null;
+  next_email_at: string | null;
+  status: string;
+  recovered_order_id: string | null;
+  recovered_at: string | null;
+  created_at: string;
+};
+
+export type GetAbandonedCartsResult = {
+  success: true;
+  carts: AbandonedCart[];
+  stats: { total: number; recovered: number; active: number; expired: number };
+} | { success: false; error: string };
+
+// ── Sequence email intervals ───────────────────────────────────────────────────
+
+const EMAIL_INTERVALS_HOURS = [1, 24, 48] as const;
+const LOCALE_CART_SUBJECT: Record<string, Record<number, { subject: string; heading: string; body: string }>> = {
+  en: {
+    1: {
+      subject: "Your cart is waiting — complete your order",
+      heading: "Don't forget your order",
+      body: "You left items in your cart. Complete your order before the pickup date fills up.",
+    },
+    2: {
+      subject: "Still thinking it over? Your cart is still here",
+      heading: "A little reminder",
+      body: "Your wholesale order is still waiting. Lock in your pickup date before it books up.",
+    },
+    3: {
+      subject: "Last chance — your cart expires soon",
+      heading: "One more day to order",
+      body: "This is your final reminder. After this, your cart will no longer be available.",
+    },
+  },
+  es: {
+    1: {
+      subject: "Tu carrito te espera — completa tu pedido",
+      heading: "No olvides tu pedido",
+      body: "Dejaste artículos en tu carrito. Completa tu pedido antes de que se llene la fecha de recogida.",
+    },
+    2: {
+      subject: "¿Aún lo estás pensando? Tu carrito sigue aquí",
+      heading: "Un pequeño recordatorio",
+      body: "Tu pedido al por mayor aún está esperando. Reserva tu fecha de recogida antes de que se llene.",
+    },
+    3: {
+      subject: "Última oportunidad — tu carrito expira pronto",
+      heading: "Un día más para ordenar",
+      body: "Este es tu último recordatorio. Después de esto, tu carrito ya no estará disponible.",
+    },
+  },
+};
+
+// ── Get all carts (admin view) ─────────────────────────────────────────────────
+
+export async function getAbandonedCarts(brandId: string): Promise<GetAbandonedCartsResult> {
+  const adminUser = await getAdminUser();
+  if (!adminUser) return { success: false, error: "Not authenticated" };
+
+  if (adminUser.role === "brand_admin" && adminUser.brand_id !== brandId) {
+    return { success: false, error: "Not authorized" };
+  }
+
+  const res = await fetch(
+    `${supabaseUrl}/rest/v1/rpc/get_abandoned_carts`,
+    {
+      method: "POST",
+      headers: { ...svcHeaders(supabaseKey), "Content-Type": "application/json" },
+      body: JSON.stringify({ p_brand_id: brandId }),
+    }
+  );
+  if (!res.ok) return { success: false, error: "Failed to fetch abandoned carts" };
+  const data = await res.json();
+  // Supabase TABLE(func) returns [{carts: ...}] — extract from first row
+  const row = Array.isArray(data) ? data[0] : data;
+  const carts: AbandonedCart[] = row?.carts ?? [];
+  return {
+    success: true,
+    carts,
+    stats: {
+      total: carts.length,
+      recovered: carts.filter(c => c.status === "recovered").length,
+      active: carts.filter(c => c.status === "active").length,
+      expired: carts.filter(c => c.status === "expired").length,
+    },
+  };
+}
+
+// ── Manually close an abandoned cart ──────────────────────────────────────────
+
+export async function manuallyCloseAbandonedCart(
+  cartId: string,
+  brandId: string
+): Promise<{ success: boolean; error?: string }> {
+  const adminUser = await getAdminUser();
+  if (!adminUser) return { success: false, error: "Not authenticated" };
+
+  if (adminUser.role === "brand_admin" && adminUser.brand_id !== brandId) {
+    return { success: false, error: "Not authorized" };
+  }
+
+  const res = await fetch(
+    `${supabaseUrl}/rest/v1/rpc/update_abandoned_cart`,
+    {
+      method: "POST",
+      headers: { ...svcHeaders(supabaseKey), "Content-Type": "application/json" },
+      body: JSON.stringify({
+        p_id: cartId,
+        p_status: "manually_closed",
+        p_manually_closed_by: adminUser.id,
+      }),
+    }
+  );
+  if (!res.ok) return { success: false, error: "Failed to close cart" };
+  return { success: true };
+}
+
+// ── Build email HTML ───────────────────────────────────────────────────────────
+
+function buildCartRecoveryEmail(params: {
+  brandName: string;
+  contactName: string | null;
+  locale: string;
+  step: number;
+  cartSnapshot: AbandonedCart["cart_snapshot"];
+  adminUrl: string;
+}): { subject: string; html: string; text: string } {
+  const { brandName, contactName, locale, step, cartSnapshot, adminUrl } = params;
+  const t = LOCALE_CART_SUBJECT[locale]?.[step] ?? LOCALE_CART_SUBJECT.en[step];
+  const greeting = locale === "es"
+    ? (contactName ? `Hola ${contactName}` : `Hola`)
+    : (contactName ? `Hi ${contactName}` : `Hi there`);
+  const ctaText = locale === "es" ? "Completar mi pedido" : "Complete my order";
+  const footerText = locale === "es"
+    ? "Este email fue enviado porque dejaste artículos en tu carrito."
+    : "You received this email because you left items in your cart.";
+
+  const itemsList = cartSnapshot.items
+    .slice(0, 5)
+    .map(
+      item =>
+        `<tr><td style="padding:8px 0;border-bottom:1px solid #27272a;color:#a8a29e">${item.name}</td><td style="padding:8px 0;border-bottom:1px solid #27272a;color:#fafafa;text-align:right">${item.quantity} × $${Number(item.unit_price).toFixed(2)}</td></tr>`
+    )
+    .join("");
+
+  const subject = t.subject;
+  const html = `<!DOCTYPE html>
+<html>
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"></head>
+<body style="margin:0;padding:0;background:#0f0f0f;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;color:#fafafa">
+<div style="max-width:560px;margin:0 auto;padding:32px 16px">
+  <div style="background:#1c1917;border-radius:16px;padding:28px 32px;margin-bottom:24px">
+    <p style="margin:0 0 4px;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.1em;color:#a8a29e">${locale === "es" ? "Carrito abandonado" : "Abandoned Cart"}</p>
+    <h1 style="margin:0;font-size:22px;font-weight:800;color:#ffffff">${t.heading}</h1>
+    <p style="margin:8px 0 0;font-size:14px;color:rgba(255,255,255,.6)">${brandName}</p>
+  </div>
+  <div style="background:#18181b;border-radius:16px;padding:28px 32px;border:1px solid #27272a;margin-bottom:24px">
+    <p style="margin:0 0 16px;font-size:14px;color:#fafafa">${greeting},</p>
+    <p style="margin:0 0 20px;font-size:14px;color:#a8a29e;line-height:1.6">${t.body}</p>
+    <table style="width:100%;border-collapse:collapse;font-size:14px;margin-bottom:20px">
+      ${itemsList}
+      <tr><td style="padding:8px 0;color:#a8a29e">Total</td><td style="padding:8px 0;color:#fafafa;font-weight:700;text-align:right">$${Number(cartSnapshot.subtotal).toFixed(2)}</td></tr>
+    </table>
+    <a href="${adminUrl}" style="display:inline-block;width:100%;text-align:center;background:#16a34a;color:#fff;text-decoration:none;font-weight:700;font-size:14px;padding:14px 28px;border-radius:8px">${ctaText}</a>
+  </div>
+  <div style="text-align:center;margin-top:24px">
+    <p style="margin:0;font-size:12px;color:#52525b">${footerText}</p>
+  </div>
+</div>
+</body>
+</html>`;
+
+  const text = `[${brandName} - ${t.heading}]\n\n${greeting},\n\n${t.body}\n\nItems in cart (${cartSnapshot.item_count} items):\n${cartSnapshot.items.map(i => `- ${i.name}: ${i.quantity} × $${Number(i.unit_price).toFixed(2)}`).join("\n")}\nTotal: $${Number(cartSnapshot.subtotal).toFixed(2)}\n\nComplete your order: ${adminUrl}\n\n${footerText}`;
+
+  return { subject, html, text };
+}
+
+// ── Internal: send one recovery email ─────────────────────────────────────────
+
+export async function sendAbandonedCartEmail(
+  cart: AbandonedCart,
+  step: number,
+  brandId: string
+): Promise<{ success: boolean; error?: string }> {
+  const adminUrl = `https://route-commerce-platform.vercel.app/admin/communications/abandoned-carts`;
+  const { subject, html, text } = buildCartRecoveryEmail({
+    brandName: cart.brand_name ?? "Our Farm",
+    contactName: cart.contact_name,
+    locale: cart.locale ?? "en",
+    step,
+    cartSnapshot: cart.cart_snapshot,
+    adminUrl,
+  });
+
+  const RESEND_API_KEY = process.env.RESEND_API_KEY ?? "";
+  if (!RESEND_API_KEY) return { success: false, error: "Resend not configured" };
+
+  try {
+    const res = await fetch("https://api.resend.com/emails", {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${RESEND_API_KEY}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        from: process.env.FROM_EMAIL ?? "Route Commerce <no-reply@routecommerce.com>",
+        to: [cart.contact_email],
+        subject,
+        html,
+        text,
+      }),
+    });
+
+    if (!res.ok) {
+      const err = await res.text();
+      return { success: false, error: err };
+    }
+
+    const data = await res.json();
+
+    // Update cart record
+    await fetch(
+      `${supabaseUrl}/rest/v1/rpc/update_abandoned_cart`,
+      {
+        method: "POST",
+        headers: { ...svcHeaders(supabaseKey), "Content-Type": "application/json" },
+        body: JSON.stringify({
+          p_id: cart.id,
+          p_sequence_step: step,
+          p_last_email_sent_at: new Date().toISOString(),
+          p_next_email_at: step < 3 ? new Date(Date.now() + EMAIL_INTERVALS_HOURS[step] * 3600000).toISOString() : null,
+          p_status: step >= 3 ? "expired" : "active",
+          p_expired_at: step >= 3 ? new Date().toISOString() : null,
+        }),
+      }
+    );
+
+    return { success: true };
+  } catch (e) {
+    return { success: false, error: String(e) };
+  }
+}
+
+// ── Manually resend a specific email step ─────────────────────────────────────
+
+export async function resendAbandonedCartEmail(
+  cartId: string,
+  brandId: string
+): Promise<{ success: boolean; error?: string }> {
+  const adminUser = await getAdminUser();
+  if (!adminUser) return { success: false, error: "Not authenticated" };
+
+  if (adminUser.role === "brand_admin" && adminUser.brand_id !== brandId) {
+    return { success: false, error: "Not authorized" };
+  }
+
+  const res = await fetch(
+    `${supabaseUrl}/rest/v1/rpc/manual_resend_abandoned_cart_email`,
+    {
+      method: "POST",
+      headers: { ...svcHeaders(supabaseKey), "Content-Type": "application/json" },
+      body: JSON.stringify({ p_cart_id: cartId, p_step: 1 }),
+    }
+  );
+  if (!res.ok) return { success: false, error: "Failed to resend email" };
+  return { success: true };
+}
+
+// ── Mark cart as recovered when order is placed ────────────────────────────────
+
+export async function markCartRecovered(cartId: string, orderId: string): Promise<void> {
+  await fetch(
+    `${supabaseUrl}/rest/v1/rpc/update_abandoned_cart`,
+    {
+      method: "POST",
+      headers: { ...svcHeaders(supabaseKey), "Content-Type": "application/json" },
+      body: JSON.stringify({
+        p_id: cartId,
+        p_status: "recovered",
+        p_recovered_order_id: orderId,
+        p_recovered_at: new Date().toISOString(),
+      }),
+    }
+  );
+}
@@ -0,0 +1,280 @@
+"use server";
+
+import { getAdminUser } from "@/lib/admin-permissions";
+import { svcHeaders } from "@/lib/svc-headers";
+
+const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL!;
+const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY!;
+
+// ── Types ─────────────────────────────────────────────────────────────────────
+
+export type WelcomeSequenceEntry = {
+  id: string;
+  brand_id: string;
+  contact_id: string | null;
+  contact_email: string;
+  contact_name: string | null;
+  brand_name: string | null;
+  locale: string;
+  sequence_step: number;
+  last_email_sent_at: string | null;
+  next_email_at: string | null;
+  status: string;
+  created_at: string;
+};
+
+export type GetWelcomeSequenceResult = {
+  success: true;
+  entries: WelcomeSequenceEntry[];
+  stats: { total: number; completed: number; active: number; unsubscribed: number };
+} | { success: false; error: string };
+
+// ── Welcome email content (EN + ES) ──────────────────────────────────────────
+
+type WelcomeEmailContent = {
+  subject: string;
+  heading: string;
+  body: string;
+  cta_text: string;
+  cta_url: string;
+};
+
+const WELCOME_EMAILS: Record<string, Record<number, WelcomeEmailContent>> = {
+  en: {
+    1: {
+      subject: "Welcome to {brand} — here's what to expect",
+      heading: "You're in!",
+      body: "Thanks for subscribing to {brand}'s wholesale updates. Here's what you can expect:\n\n• New product announcements before anyone else\n• Exclusive wholesale pricing\n• Seasonal availability alerts\n• Quick reorder from your saved preferences",
+      cta_text: "Explore wholesale catalog",
+      cta_url: "/wholesale",
+    },
+    2: {
+      subject: "How wholesale ordering works with {brand}",
+      heading: "Ordering is simple",
+      body: "Here's how our wholesale process works:\n\n1. Browse the catalog and add items to your cart\n2. Checkout and pay online, or request an invoice\n3. Choose your pickup date at checkout\n4. We'll have your order ready when you arrive\n\nNo account required to browse — sign up only when you're ready to order.",
+      cta_text: "See current availability",
+      cta_url: "/wholesale/portal",
+    },
+    3: {
+      subject: "Your first order is waiting — {brand} wholesale",
+      heading: "Ready to try us out?",
+      body: "If you've been thinking about placing your first wholesale order with {brand}, now's a great time.\n\nOur current seasonal selection includes produce from our farm and partner growers, sourced for freshness and quality.\n\nQuestions? Reply to this email — we read every message.",
+      cta_text: "Start my first order",
+      cta_url: "/wholesale/register",
+    },
+    4: {
+      subject: "You're all set — wholesale updates from {brand}",
+      heading: "You're all set",
+      body: "You're now fully set up to receive wholesale updates from {brand}.\n\nWe'll send you occasional emails about new products, seasonal availability, and any special offers. No spam — just the useful stuff.\n\nYou can unsubscribe at any time.",
+      cta_text: "Browse the catalog",
+      cta_url: "/wholesale/portal",
+    },
+  },
+  es: {
+    1: {
+      subject: "Bienvenido a {brand} — esto es lo que puedes esperar",
+      heading: "¡Bienvenido!",
+      body: "Gracias por suscribirte a las actualizaciones mayoristas de {brand}. Esto es lo que puedes esperar:\n\n• Anuncios de nuevos productos antes que nadie\n• Precios exclusivos al por mayor\n• Alertas de disponibilidad por temporada\n• Reorden rápido desde tus preferencias guardadas",
+      cta_text: "Explorar catálogo mayorista",
+      cta_url: "/wholesale",
+    },
+    2: {
+      subject: "Cómo funciona el pedido al por mayor con {brand}",
+      heading: "Ordenar es simple",
+      body: "Así funciona nuestro proceso mayorista:\n\n1. Explora el catálogo y agrega artículos a tu carrito\n2. Paga en línea o solicita una factura\n3. Elige tu fecha de recogida al pagar\n4. Tendremos tu pedido listo cuando llegues\n\nNo necesitas cuenta para浏览 — regístrate solo cuando estés listo para ordenar.",
+      cta_text: "Ver disponibilidad actual",
+      cta_url: "/wholesale/portal",
+    },
+    3: {
+      subject: "Tu primer pedido está esperando — {brand} mayorista",
+      heading: "¿Listo para probarnos?",
+      body: "Si has estado pensando en hacer tu primer pedido al por mayor con {brand}, ahora es un excelente momento.\n\nNuestra selección actual de temporada incluye productos de nuestra granja y productores asociados, seleccionados por su frescura y calidad.\n\n¿Preguntas? Responde a este correo — leemos cada mensaje.",
+      cta_text: "Comenzar mi primer pedido",
+      cta_url: "/wholesale/register",
+    },
+    4: {
+      subject: "Todo listo — actualizaciones mayoristas de {brand}",
+      heading: "Todo está listo",
+      body: "Ahora estás completamente configurado para recibir actualizaciones mayoristas de {brand}.\n\nTe enviaremos correos ocasionales sobre nuevos productos, disponibilidad por temporada y ofertas especiales. Sin spam — solo cosas útiles.\n\nPuedes darte de baja en cualquier momento.",
+      cta_text: "Explorar el catálogo",
+      cta_url: "/wholesale/portal",
+    },
+  },
+};
+
+// ── Get all welcome sequence entries (admin view) ────────────────────────────
+
+export async function getWelcomeSequence(brandId: string): Promise<GetWelcomeSequenceResult> {
+  const adminUser = await getAdminUser();
+  if (!adminUser) return { success: false, error: "Not authenticated" };
+
+  if (adminUser.role === "brand_admin" && adminUser.brand_id !== brandId) {
+    return { success: false, error: "Not authorized" };
+  }
+
+  const res = await fetch(
+    `${supabaseUrl}/rest/v1/rpc/get_welcome_sequence`,
+    {
+      method: "POST",
+      headers: { ...svcHeaders(supabaseKey), "Content-Type": "application/json" },
+      body: JSON.stringify({ p_brand_id: brandId }),
+    }
+  );
+  if (!res.ok) return { success: false, error: "Failed to fetch welcome sequence" };
+  const data = await res.json();
+  const row = Array.isArray(data) ? data[0] : data;
+  const entries: WelcomeSequenceEntry[] = row?.entries ?? [];
+  return {
+    success: true,
+    entries,
+    stats: {
+      total: entries.length,
+      completed: entries.filter(e => e.status === "completed").length,
+      active: entries.filter(e => e.status === "active").length,
+      unsubscribed: entries.filter(e => e.status === "unsubscribed").length,
+    },
+  };
+}
+
+// ── Build welcome email HTML ───────────────────────────────────────────────────
+
+function buildWelcomeEmail(params: {
+  brandName: string;
+  contactName: string | null;
+  locale: string;
+  step: number;
+  ctaUrl: string;
+}): { subject: string; html: string; text: string } {
+  const { brandName, contactName, locale, step, ctaUrl } = params;
+  const t = WELCOME_EMAILS[locale]?.[step] ?? WELCOME_EMAILS.en[step];
+  const greeting = locale === "es"
+    ? (contactName ? `Hola ${contactName}` : `Hola`)
+    : (contactName ? `Hi ${contactName}` : `Hi there`);
+  const fullCtaUrl = ctaUrl.startsWith("http") ? ctaUrl : `https://route-commerce-platform.vercel.app${ctaUrl}`;
+  const footerText = locale === "es"
+    ? "Te suscribiste a actualizaciones mayoristas de {brand}. Cancela la suscripción en cualquier momento."
+    : "You subscribed to wholesale updates from {brand}. Unsubscribe at any time.";
+
+  const subject = t.subject.replace("{brand}", brandName);
+  const heading = t.heading;
+  const body = t.body.replace(/{brand}/g, brandName);
+
+  const html = `<!DOCTYPE html>
+<html>
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"></head>
+<body style="margin:0;padding:0;background:#0f0f0f;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;color:#fafafa">
+<div style="max-width:560px;margin:0 auto;padding:32px 16px">
+  <div style="background:#1c1917;border-radius:16px;padding:28px 32px;margin-bottom:24px">
+    <p style="margin:0 0 4px;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.1em;color:#a8a29e">${locale === "es" ? "Bienvenido" : "Welcome"}</p>
+    <h1 style="margin:0;font-size:22px;font-weight:800;color:#ffffff">${heading}</h1>
+    <p style="margin:8px 0 0;font-size:14px;color:rgba(255,255,255,.6)">${brandName}</p>
+  </div>
+  <div style="background:#18181b;border-radius:16px;padding:28px 32px;border:1px solid #27272a;margin-bottom:24px">
+    <p style="margin:0 0 16px;font-size:14px;color:#fafafa">${greeting},</p>
+    <p style="margin:0 0 20px;font-size:14px;color:#a8a29e;line-height:1.7;white-space:pre-wrap">${body}</p>
+    <a href="${fullCtaUrl}" style="display:inline-block;text-align:center;background:#16a34a;color:#fff;text-decoration:none;font-weight:700;font-size:14px;padding:14px 28px;border-radius:8px;margin-top:8px">${t.cta_text}</a>
+  </div>
+  <div style="text-align:center;margin-top:24px">
+    <p style="margin:0;font-size:12px;color:#52525b">${footerText.replace("{brand}", brandName)}</p>
+  </div>
+</div>
+</body>
+</html>`;
+
+  const text = `[${brandName} - ${heading}]\n\n${greeting},\n\n${body}\n\n${t.cta_text}: ${fullCtaUrl}\n\n${footerText.replace("{brand}", brandName)}`;
+
+  return { subject, html, text };
+}
+
+// ── Send one welcome email ─────────────────────────────────────────────────────
+
+export async function sendWelcomeEmail(
+  entry: WelcomeSequenceEntry,
+  step: number
+): Promise<{ success: boolean; error?: string }> {
+  const { brand_name, contact_name, locale, contact_email } = entry;
+  const t = WELCOME_EMAILS[locale]?.[step] ?? WELCOME_EMAILS.en[step];
+  const ctaUrl = t.cta_url;
+
+  const { subject, html, text } = buildWelcomeEmail({
+    brandName: brand_name ?? "Our Farm",
+    contactName: contact_name,
+    locale: locale ?? "en",
+    step,
+    ctaUrl,
+  });
+
+  const RESEND_API_KEY = process.env.RESEND_API_KEY ?? "";
+  if (!RESEND_API_KEY) return { success: false, error: "Resend not configured" };
+
+  try {
+    const res = await fetch("https://api.resend.com/emails", {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${RESEND_API_KEY}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        from: process.env.FROM_EMAIL ?? "Route Commerce <no-reply@routecommerce.com>",
+        to: [contact_email],
+        subject,
+        html,
+        text,
+      }),
+    });
+
+    if (!res.ok) {
+      const err = await res.text();
+      return { success: false, error: err };
+    }
+
+    const data = await res.json();
+    const isLastEmail = step >= 4;
+
+    // Update sequence entry
+    await fetch(
+      `${supabaseUrl}/rest/v1/rpc/update_welcome_sequence`,
+      {
+        method: "POST",
+        headers: { ...svcHeaders(supabaseKey), "Content-Type": "application/json" },
+        body: JSON.stringify({
+          p_id: entry.id,
+          p_sequence_step: step,
+          p_last_email_sent_at: new Date().toISOString(),
+          p_next_email_at: isLastEmail ? null : new Date(Date.now() + 24 * 3600000).toISOString(),
+          p_status: isLastEmail ? "completed" : "active",
+          p_completed_at: isLastEmail ? new Date().toISOString() : null,
+        }),
+      }
+    );
+
+    return { success: true };
+  } catch (e) {
+    return { success: false, error: String(e) };
+  }
+}
+
+// ── Manually resend a specific welcome email step ─────────────────────────────
+
+export async function resendWelcomeEmail(
+  entryId: string,
+  brandId: string
+): Promise<{ success: boolean; error?: string }> {
+  const adminUser = await getAdminUser();
+  if (!adminUser) return { success: false, error: "Not authenticated" };
+
+  if (adminUser.role === "brand_admin" && adminUser.brand_id !== brandId) {
+    return { success: false, error: "Not authorized" };
+  }
+
+  const res = await fetch(
+    `${supabaseUrl}/rest/v1/rpc/manual_resend_welcome_email`,
+    {
+      method: "POST",
+      headers: { ...svcHeaders(supabaseKey), "Content-Type": "application/json" },
+      body: JSON.stringify({ p_entry_id: entryId, p_step: 1 }),
+    }
+  );
+  if (!res.ok) return { success: false, error: "Failed to resend email" };
+  return { success: true };
+}