/** * Marketing-Funnel Phase 3 — click-through tracking + redirect (Phase 05 #80). * * GET /email/track-click/:deliveryId?u= * * Records the first clickedAt for the delivery row and 302-redirects * the browser to the original href. Only http(s) URLs are accepted * to prevent open-redirect abuse (e.g. javascript: / data: schemes). * * Idempotent: subsequent clicks never overwrite the first-touch * timestamp. Stats jobs aggregate raw counts per delivery. */ import type { LoaderFunctionArgs } from "react-router"; import { redirect } from "react-router"; import { db } from "~/utils/db.server"; import { createScopedLogger } from "~/utils/logger.server"; const logger = createScopedLogger("marketing.tracking.click"); function isSafeRedirect(url: string): boolean { try { const parsed = new URL(url); return parsed.protocol === "https:" || parsed.protocol === "http:"; } catch { return false; } } export async function loader({ params, request }: LoaderFunctionArgs): Promise { const deliveryId = params.deliveryId ?? ""; const url = new URL(request.url); const target = url.searchParams.get("u") ?? ""; if (!isSafeRedirect(target)) { logger.warn({ op: "marketing.tracking.click.unsafe_url", deliveryId }, "click target rejected"); return new Response("Invalid redirect target", { status: 400 }); } if (deliveryId.length > 0) { try { await db.emailSequenceStepDelivery.updateMany({ where: { id: deliveryId, clickedAt: null }, data: { clickedAt: new Date() }, }); } catch (err) { logger.warn( { op: "marketing.tracking.click.error", deliveryId, errorName: (err as Error)?.name }, "click tracker update failed" ); } } return redirect(target); }