@m13v/seo-components 0.33.0 → 0.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m13v/seo-components",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "scripts": {
     "build:css": "tailwind -i src/_build.css -o dist/styles.css --minify",
     "lint:mobile-spans": "node scripts/lint-mobile-spans.mjs",

package/src/lib/dm-short-link-redirect.ts

@@ -19,18 +19,27 @@ export interface DmShortLinkRedirectConfig {
 /**
  * Factory for `GET /r/[code]`.
  *
- * Each per-DM short link maps to a Cal.com / Calendly URL with full UTM and
- * `metadata[utm_*]` so cal_bookings closes the loop on which DM produced the
- * booking. The cached `target_url` is frozen at mint time on the dms row, so
- * the resolver is a single DB read with no config.json dependency.
+ * Each short link maps to a destination URL. Two rails are supported:
+ *
+ *   DM rail: code is minted from dm_links. Target is a Cal.com / Calendly URL
+ *   with full UTM and metadata[utm_*] so cal_bookings closes the loop on which
+ *   DM produced the booking. Fires `dm_short_link_clicked` in PostHog.
+ *
+ *   Post rail: code is minted from post_links (public posts/comments). Target
+ *   is typically the product homepage or a landing page. UTM params are injected
+ *   at redirect time (utm_source, utm_medium, utm_campaign, utm_content) so
+ *   PostHog can stitch the full funnel: post click -> get_started_click ->
+ *   schedule_click -> checkout_success. Fires `post_short_link_clicked` in
+ *   PostHog.
  *
  * Behavior:
  *   1. Read `code` from the route param. Reject non-alphanumeric / wrong-length.
- *   2. Hit `<resolverBase>/api/short-links/<code>`. The resolver increments
- *      dms.short_link_clicks and stamps first/last click timestamps.
- *   3. Fire a PostHog `dm_short_link_clicked` event with dm_id, project,
- *      platform, code, site.
- *   4. 302 to the resolved target_url. On miss/error, 302 to "/".
+ *   2. Hit `<resolverBase>/api/short-links/<code>`. The resolver increments the
+ *      click counter and stamps first/last click timestamps.
+ *   3. For post rail links: inject UTM params into the target URL.
+ *   4. Fire the appropriate PostHog event (dm_short_link_clicked or
+ *      post_short_link_clicked) fire-and-forget, non-blocking.
+ *   5. 302 to the resolved target_url. On miss/error, 302 to "/".
  */
 export function createDmShortLinkRedirectHandler(config: DmShortLinkRedirectConfig) {
   const {
@@ -55,6 +64,8 @@ export function createDmShortLinkRedirectHandler(config: DmShortLinkRedirectConf
 
     let target: string | null = null;
     let dmId: number | null = null;
+    let postId: number | null = null;
+    let replyId: number | null = null;
     let project: string | null = null;
     let platform: string | null = null;
 
@@ -67,12 +78,16 @@ export function createDmShortLinkRedirectHandler(config: DmShortLinkRedirectConf
         const body = (await resp.json()) as {
           target_url?: string;
           dm_id?: number;
+          post_id?: number;
+          reply_id?: number;
           project?: string;
           platform?: string;
         };
         if (body.target_url) {
           target = body.target_url;
           dmId = body.dm_id ?? null;
+          postId = body.post_id ?? null;
+          replyId = body.reply_id ?? null;
           project = body.project ?? null;
           platform = body.platform ?? null;
         }
@@ -81,8 +96,29 @@ export function createDmShortLinkRedirectHandler(config: DmShortLinkRedirectConf
       console.error("[dm-short-link/redirect] resolver fetch failed:", err);
     }
 
+    // For post rail links (public posts/comments), inject UTM params so
+    // PostHog can stitch click -> conversion events. DM rail links already
+    // have Cal.com metadata[utm_*] attribution embedded at mint time, so we
+    // leave those URLs untouched.
+    if (target && (postId != null || replyId != null)) {
+      try {
+        const targetUrl = new URL(target);
+        if (!targetUrl.searchParams.has("utm_source")) {
+          if (platform) targetUrl.searchParams.set("utm_source", platform);
+          targetUrl.searchParams.set("utm_medium", "social");
+          if (project) targetUrl.searchParams.set("utm_campaign", project);
+          targetUrl.searchParams.set("utm_content", code);
+          target = targetUrl.toString();
+        }
+      } catch {
+        // Keep original target if URL parsing fails (e.g. non-HTTP scheme).
+      }
+    }
+
     const posthogKey = process.env[posthogKeyEnv];
     const posthogHost = (process.env[posthogHostEnv] || "https://us.i.posthog.com").replace(/\/+$/, "");
+
+    // DM rail event
     if (target && posthogKey && dmId != null) {
       fetch(`${posthogHost}/i/v0/e/`, {
         method: "POST",
@@ -99,6 +135,30 @@ export function createDmShortLinkRedirectHandler(config: DmShortLinkRedirectConf
       );
     }
 
+    // Post rail event
+    if (target && posthogKey && (postId != null || replyId != null)) {
+      fetch(`${posthogHost}/i/v0/e/`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          api_key: posthogKey,
+          event: "post_short_link_clicked",
+          distinct_id: `post_${postId ?? replyId}`,
+          timestamp: new Date().toISOString(),
+          properties: {
+            post_id: postId,
+            reply_id: replyId,
+            project,
+            platform,
+            code,
+            site,
+          },
+        }),
+      }).catch((err) =>
+        console.error("[dm-short-link/redirect] posthog fetch failed:", err)
+      );
+    }
+
     return Response.redirect(target || homeUrl, 302);
   };
 }

package/src/lib/newsletter-route.ts

@@ -124,6 +124,7 @@ export interface NewsletterConfig {
   onSignup?: (email: string, resendEmailId: string | null) => Promise<void>;
 }
 
+
 /* ------------------------------------------------------------------ */
 /*  Factory                                                            */
 /* ------------------------------------------------------------------ */