@hogsend/db 0.26.0 → 0.27.0

package/drizzle/meta/_journal.json

@@ -197,6 +197,13 @@
       "when": 1781546768414,
       "tag": "0027_wealthy_aqueduct",
       "breakpoints": true
+    },
+    {
+      "idx": 28,
+      "version": "7",
+      "when": 1782060240750,
+      "tag": "0028_eminent_war_machine",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hogsend/db",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "type": "module",
   "license": "MIT",
   "repository": {

package/src/schema/index.ts

@@ -18,6 +18,7 @@ export * from "./journey-configs.js";
 export * from "./journey-logs.js";
 export * from "./journey-states.js";
 export * from "./link-clicks.js";
+export * from "./links.js";
 export * from "./provider-credentials.js";
 export * from "./relations.js";
 export * from "./tracked-links.js";

package/src/schema/links.ts

@@ -0,0 +1,44 @@
+import { index, pgTable, text, timestamp, uuid } from "drizzle-orm/pg-core";
+import { timestamps } from "./_shared.js";
+
+/**
+ * Operator-owned / standalone tracked links — the managed surface behind the
+ * Studio "Links" view and any non-email channel (Discord, SMS, share links). A
+ * `links` row is the durable, named identity of a tracked link; the click
+ * counter + per-hit `link_clicks` live in `tracked_links` (which points back
+ * here via `link_id`). Email's own per-send rewritten links do NOT create a
+ * `links` row (they keep `tracked_links.link_id` NULL) — email stays a separate
+ * consumer of the same click spine.
+ */
+export const links = pgTable(
+  "links",
+  {
+    id: uuid("id").defaultRandom().primaryKey(),
+    originalUrl: text("original_url").notNull(),
+    // "personal" = single-recipient, identity-bearing (carries `distinctId`, may
+    // mint a SINGLE-USE `hs_t`); "public" = shareable, NEVER carries a person
+    // token (campaign/UTM attribution only). Default "public" — the safe default.
+    type: text("type").notNull().default("public"),
+    // Operator-facing name (Studio list).
+    label: text("label"),
+    // UTM-style campaign grouping for public links.
+    campaign: text("campaign"),
+    // Originating channel: "studio" | "discord" | "sms" | … (open string).
+    source: text("source").notNull(),
+    // The canonical contact key a click should stitch the visitor's anon session
+    // into — set ONLY for personal links; NULL for public/broadcast (a shareable
+    // link must never carry a person).
+    distinctId: text("distinct_id"),
+    // The admin actor who minted it (mirrors api_keys.createdBy).
+    createdBy: text("created_by"),
+    // Soft-delete: archive (not hard-delete) so historical `link_clicks` survive
+    // (the `tracked_links.link_id` FK is ON DELETE set null as a backstop).
+    archivedAt: timestamp("archived_at", { withTimezone: true }),
+    ...timestamps,
+  },
+  (table) => [
+    index("links_source_idx").on(table.source),
+    index("links_campaign_idx").on(table.campaign),
+    index("links_created_at_idx").on(table.createdAt),
+  ],
+);

package/src/schema/tracked-links.ts

@@ -9,6 +9,7 @@ import {
 } from "drizzle-orm/pg-core";
 import { timestamps } from "./_shared.js";
 import { emailSends } from "./email-sends.js";
+import { links } from "./links.js";
 
 export const trackedLinks = pgTable(
   "tracked_links",
@@ -21,6 +22,13 @@ export const trackedLinks = pgTable(
     emailSendId: uuid("email_send_id").references(() => emailSends.id, {
       onDelete: "cascade",
     }),
+    // The managed `links` row this click-counter belongs to, when the link was
+    // minted via `mintLink` (Studio / Discord / share links). NULL for email's
+    // per-send rewritten links (they resolve identity from `email_sends`). ON
+    // DELETE set null so archiving/removing a `links` row keeps the click spine.
+    linkId: uuid("link_id").references(() => links.id, {
+      onDelete: "set null",
+    }),
     // Subject of a stitch-bearing NON-email link: the canonical contact key the
     // click should fold the visitor's anon session into. NULL for broadcast
     // links (Discord/referral default) — broadcast links are tracked for click
@@ -46,5 +54,8 @@ export const trackedLinks = pgTable(
     }),
     ...timestamps,
   },
-  (table) => [index("tracked_links_email_send_id_idx").on(table.emailSendId)],
+  (table) => [
+    index("tracked_links_email_send_id_idx").on(table.emailSendId),
+    index("tracked_links_link_id_idx").on(table.linkId),
+  ],
 );