@foundrynorth/flux-schema 1.19.11 → 1.20.0

package/dist/schema.js

@@ -168,6 +168,28 @@ export const fluxSecretsAuditActionEnum = pgEnum("flux_secrets_audit_action", [
     "sync_failed",
 ]);
 // =============================================================================
+// MILESTONE NOTIFICATIONS (Real-time per-AM Slack DMs)
+// =============================================================================
+/**
+ * Milestone events that can trigger a per-user Slack DM. Owners on a ticket
+ * (account manager, account executive, strategist, fulfillment owner) receive
+ * these by default; non-owner subscribers must opt in per event type via
+ * `flux_users.notificationPreferences.milestones.subscriberOptIn`.
+ */
+export const MILESTONE_EVENT_TYPES = [
+    "ticket_created",
+    "creative_needed",
+    "creative_approved",
+    "ready_to_traffic",
+    "campaign_live",
+    "campaign_completed",
+    "campaign_paused",
+    "campaign_cancelled",
+    "change_required",
+    "sem_live",
+    "sem_failed",
+];
+// =============================================================================
 // USERS (Extension table - references Clerk, not Forge users)
 // =============================================================================
 /**
@@ -459,6 +481,43 @@ export const fluxActivityItems = pgTable("flux_activity_items", {
     projectOccurredIdx: index("flux_activity_items_project_occurred_idx").on(table.projectId, table.occurredAt),
 }));
 // =============================================================================
+// MILESTONE NOTIFICATIONS (delivery ledger for per-AM Slack DMs)
+// =============================================================================
+/**
+ * Idempotency ledger for milestone Slack DMs. The dispatcher inserts one row
+ * per (user, source, event) before sending the DM; the unique index causes
+ * `ON CONFLICT DO NOTHING` to no-op on retries / re-syncs / webhook replays.
+ *
+ * Source rows:
+ *   sourceType = "fulfillment_ticket"  → sourceId = flux_fulfillment_tickets.id
+ *   sourceType = "sem_campaign"        → sourceId = flux_sem_campaigns.id
+ *
+ * `slackTs` captures the Slack message timestamp so future code can thread
+ * follow-up updates (e.g. edit the "campaign live" message when it completes).
+ */
+export const fluxMilestoneNotifications = pgTable("flux_milestone_notifications", {
+    id: varchar("id")
+        .primaryKey()
+        .default(sql `gen_random_uuid()`),
+    userId: varchar("user_id")
+        .references(() => fluxUsers.id, { onDelete: "cascade" })
+        .notNull(),
+    sourceType: varchar("source_type").notNull(),
+    sourceId: varchar("source_id").notNull(),
+    eventType: varchar("event_type").notNull(),
+    projectId: varchar("project_id").references(() => fluxProjects.id, {
+        onDelete: "set null",
+    }),
+    deliveredAt: timestamp("delivered_at").defaultNow().notNull(),
+    slackTs: varchar("slack_ts"),
+    metadata: jsonb("metadata").default({}).$type(),
+}, (table) => ({
+    uniqueDelivery: uniqueIndex("flux_milestone_notifications_unique_idx").on(table.userId, table.sourceType, table.sourceId, table.eventType),
+    userIdx: index("flux_milestone_notifications_user_idx").on(table.userId),
+    projectIdx: index("flux_milestone_notifications_project_idx").on(table.projectId),
+    deliveredIdx: index("flux_milestone_notifications_delivered_idx").on(table.deliveredAt),
+}));
+// =============================================================================
 // ALERT RULES
 // =============================================================================
 export const fluxAlertRules = pgTable("flux_alert_rules", {