@varaos/db 1.5.2 → 1.5.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@varaos/db",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "private": false,
   "main": "index.js",
   "files": [

package/prisma/migrations/20260502000000_add_system_announcements/migration.sql

@@ -0,0 +1,77 @@
+-- Migration: add_system_announcements
+-- Description:
+--   1. Add TargetSegment enum for audience targeting
+--   2. Add SystemAnnouncement table for broadcast messages
+--   3. Add UserAnnouncementRead table for read receipts
+
+-- ============================================================
+-- 1. ENUM: TargetSegment
+-- ============================================================
+
+CREATE TYPE "TargetSegment" AS ENUM (
+  'all',
+  'free_plan',
+  'pro_plan',
+  'business',
+  'enterprise',
+  'admin'
+);
+
+-- ============================================================
+-- 2. TABLE: SystemAnnouncement
+-- ============================================================
+
+CREATE TABLE "SystemAnnouncement" (
+    "id"            TEXT NOT NULL,
+    "title"         TEXT NOT NULL,
+    "body"          TEXT,
+    "type"          TEXT NOT NULL,
+    "actionUrl"     TEXT,
+    "targetSegment" "TargetSegment" NOT NULL DEFAULT 'all',
+    "active"        BOOLEAN NOT NULL DEFAULT true,
+    "expiresAt"     TIMESTAMP(3),
+    "createdAt"     TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "SystemAnnouncement_pkey" PRIMARY KEY ("id")
+);
+
+-- ============================================================
+-- 3. TABLE: UserAnnouncementRead
+-- ============================================================
+
+CREATE TABLE "UserAnnouncementRead" (
+    "id"             TEXT NOT NULL,
+    "userId"         TEXT NOT NULL,
+    "announcementId" TEXT NOT NULL,
+    "readAt"         TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "UserAnnouncementRead_pkey" PRIMARY KEY ("id")
+);
+
+-- ============================================================
+-- 4. UNIQUE CONSTRAINT
+-- ============================================================
+
+CREATE UNIQUE INDEX "UserAnnouncementRead_userId_announcementId_key"
+    ON "UserAnnouncementRead"("userId", "announcementId");
+
+-- ============================================================
+-- 5. INDEX
+-- ============================================================
+
+CREATE INDEX "UserAnnouncementRead_userId_idx"
+    ON "UserAnnouncementRead"("userId");
+
+-- ============================================================
+-- 6. FOREIGN KEYS
+-- ============================================================
+
+ALTER TABLE "UserAnnouncementRead"
+    ADD CONSTRAINT "UserAnnouncementRead_userId_fkey"
+    FOREIGN KEY ("userId") REFERENCES "User"("id")
+    ON DELETE CASCADE ON UPDATE CASCADE;
+
+ALTER TABLE "UserAnnouncementRead"
+    ADD CONSTRAINT "UserAnnouncementRead_announcementId_fkey"
+    FOREIGN KEY ("announcementId") REFERENCES "SystemAnnouncement"("id")
+    ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/schema.prisma

@@ -307,6 +307,15 @@ enum ToolStatus {
   beta
 }
 
+enum TargetSegment {
+  all         // Broadcast to every active user in the system
+  free_plan   // Broadcast only to users on the free plan (e.g. upselling campaigns)
+  pro_plan    // Broadcast only to users on the pro plan (e.g. announcing new premium features)
+  business    // Broadcast to users on the business plan
+  enterprise  // Broadcast only to enterprise plan users
+  admin       // Internal broadcast only for system admins and moderators
+}
+
 /// ─────────────────────────────────────────────
 /// USERS & AUTH
 /// ─────────────────────────────────────────────
@@ -1115,6 +1124,35 @@ model Notification {
   @@index([type])
 }
 
+model SystemAnnouncement {
+  id            String    @id @default(uuid())
+  title         String
+  body          String?   @db.Text
+  type          String    // e.g. 'info', 'warning', 'feature', 'maintenance'
+  actionUrl     String?
+  
+  targetSegment TargetSegment @default(all)
+  
+  active        Boolean   @default(true)
+  expiresAt     DateTime?
+  createdAt     DateTime  @default(now())
+
+  readReceipts  UserAnnouncementRead[]
+}
+
+model UserAnnouncementRead {
+  id             String   @id @default(uuid())
+  userId         String
+  announcementId String
+  readAt         DateTime @default(now())
+
+  user         User               @relation(fields: [userId], references: [id], onDelete: Cascade)
+  announcement SystemAnnouncement @relation(fields: [announcementId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, announcementId])
+  @@index([userId])
+}
+
 model ChatSession {
   id          String  @id @default(uuid())
   title       String?