@foundrynorth/compass-schema 1.0.20 → 1.0.22

package/dist/schema.js

@@ -86,6 +86,7 @@ import { sql } from "drizzle-orm";
 import { pgTable, text, varchar, integer, jsonb, timestamp, doublePrecision, serial, numeric, uuid, date, index, boolean, pgEnum, unique, uniqueIndex, } from "drizzle-orm/pg-core";
 import { createInsertSchema } from "drizzle-zod";
 import { z } from "zod";
+import { ACTIVITY_EVENT_TYPES, ACTIVITY_SEVERITIES, ACTIVITY_SOURCE_SYSTEMS, PENDING_ACTION_TYPES, } from "./types/activity-feed.js";
 export const users = pgTable("users", {
     id: varchar("id")
         .primaryKey()
@@ -98,6 +99,21 @@ export const insertUserSchema = createInsertSchema(users).pick({
     password: true,
 });
 export const avatarRequestStatusEnum = pgEnum("avatar_request_status", ["pending", "processed", "rejected"]);
+// Activity feed enums (order activity feed + pending actions)
+export const activityEventTypeEnum = pgEnum("activity_event_type", ACTIVITY_EVENT_TYPES);
+export const activitySeverityEnum = pgEnum("activity_severity", ACTIVITY_SEVERITIES);
+export const activitySourceSystemEnum = pgEnum("activity_source_system", ACTIVITY_SOURCE_SYSTEMS);
+export const pendingActionTypeEnum = pgEnum("pending_action_type", PENDING_ACTION_TYPES);
+export const amendmentReasonEnum = pgEnum("amendment_reason", [
+    "budget_adjustment",
+    "flight_date_change",
+    "product_swap",
+    "add_line_items",
+    "remove_line_items",
+    "rate_renegotiation",
+    "client_request",
+    "other",
+]);
 // Vendor enums (must be declared before clerkUsers which references them)
 export const vendorFulfillmentStatusEnum = pgEnum("vendor_fulfillment_status", [
     "assigned",
@@ -167,6 +183,19 @@ export const userProfiles = pgTable("user_profiles", {
     photoUrl: text("photo_url"), // Profile photo (can sync from Clerk or custom upload)
     agencyAvatarUrl: text("agency_avatar_url"), // Hand-sketched avatar for proposals (Fal.ai)
     lastAvatarGeneratedAt: timestamp("last_avatar_generated_at"), // Rate limiting: non-admins can only generate 1/day
+    proposalPortraitRenderUrl: text("proposal_portrait_render_url"),
+    proposalPortraitCutoutUrl: text("proposal_portrait_cutout_url"),
+    proposalPortraitStatus: text("proposal_portrait_status"),
+    proposalPortraitPromptVersion: text("proposal_portrait_prompt_version"),
+    proposalPortraitSeed: integer("proposal_portrait_seed"),
+    proposalPortraitGeneratedAt: timestamp("proposal_portrait_generated_at"),
+    proposalPortraitSourcePhotoHash: text("proposal_portrait_source_photo_hash"),
+    proposalPortraitPreviewRenderUrl: text("proposal_portrait_preview_render_url"),
+    proposalPortraitPreviewCutoutUrl: text("proposal_portrait_preview_cutout_url"),
+    proposalPortraitPreviewPromptVersion: text("proposal_portrait_preview_prompt_version"),
+    proposalPortraitPreviewSeed: integer("proposal_portrait_preview_seed"),
+    proposalPortraitPreviewGeneratedAt: timestamp("proposal_portrait_preview_generated_at"),
+    proposalPortraitPreviewSourcePhotoHash: text("proposal_portrait_preview_source_photo_hash"),
     // Active Market Preference (overrides partner default)
     preferredMarketId: varchar("preferred_market_id"), // User's preferred market for planning
     // Digital Business Card
@@ -195,6 +224,19 @@ export const externalTeamMembers = pgTable("external_team_members", {
     title: text("title"),
     photoUrl: text("photo_url"),
     agencyAvatarUrl: text("agency_avatar_url"),
+    proposalPortraitRenderUrl: text("proposal_portrait_render_url"),
+    proposalPortraitCutoutUrl: text("proposal_portrait_cutout_url"),
+    proposalPortraitStatus: text("proposal_portrait_status"),
+    proposalPortraitPromptVersion: text("proposal_portrait_prompt_version"),
+    proposalPortraitSeed: integer("proposal_portrait_seed"),
+    proposalPortraitGeneratedAt: timestamp("proposal_portrait_generated_at"),
+    proposalPortraitSourcePhotoHash: text("proposal_portrait_source_photo_hash"),
+    proposalPortraitPreviewRenderUrl: text("proposal_portrait_preview_render_url"),
+    proposalPortraitPreviewCutoutUrl: text("proposal_portrait_preview_cutout_url"),
+    proposalPortraitPreviewPromptVersion: text("proposal_portrait_preview_prompt_version"),
+    proposalPortraitPreviewSeed: integer("proposal_portrait_preview_seed"),
+    proposalPortraitPreviewGeneratedAt: timestamp("proposal_portrait_preview_generated_at"),
+    proposalPortraitPreviewSourcePhotoHash: text("proposal_portrait_preview_source_photo_hash"),
     linkedinUrl: text("linkedin_url"),
     displayOrder: integer("display_order").default(0),
     createdAt: timestamp("created_at").notNull().defaultNow(),
@@ -433,6 +475,30 @@ export const competitorSchema = z.object({
         lng: z.number(),
     })
         .optional(), // Detailed location information
+    // Ad library data from Apify deep enrichment
+    ads: z
+        .object({
+        facebook: z
+            .array(z.object({
+            adImage: z.string().optional(),
+            headline: z.string().optional(),
+            adCopy: z.string().optional(),
+            callToAction: z.string().optional(),
+            publisherPlatforms: z.array(z.string()).optional(),
+            startDate: z.string().optional(),
+        }))
+            .optional(),
+        google: z
+            .array(z.object({
+            headline: z.string().optional(),
+            description: z.string().optional(),
+            landingPage: z.string().optional(),
+            adType: z.string().optional(),
+            imageUrl: z.string().optional(),
+        }))
+            .optional(),
+    })
+        .optional(),
 });
 export const extractionResultSchema = z.object({
     brand: z.string(),
@@ -855,7 +921,7 @@ export const plans = pgTable("plans", {
     selectedOptionId: varchar("selected_option_id"), // FK → plan_options.id (nullable during migration)
     contractId: uuid("contract_id"), // FK → contracts.id (nullable — links to annual contract)
     // Workflow mode: determines which UI sections and features are available
-    // 'research_backed' = full AnalyzeAndPlan flow (default, all existing plans)
+    // 'research_backed' = discovery mode — creates plan, runs analysis in background
     // 'direct_config' = configure products directly without research
     // 'aor_pitch' = agency-of-record pitch with proposal focus
     // 'io_entry' = direct insertion order entry from client PDF/XLSX
@@ -974,6 +1040,7 @@ export const plans = pgTable("plans", {
     defaultTargeting: text("default_targeting"),
     defaultAudience: text("default_audience"),
     defaultPromoting: text("default_promoting"),
+    defaultCreativeSource: varchar("default_creative_source"),
     defaultFlightStart: date("default_flight_start"),
     defaultFlightEnd: date("default_flight_end"),
     // Slack integration — per-plan client channel for alert routing
@@ -1027,8 +1094,12 @@ export const proposals = pgTable("proposals", {
         .primaryKey()
         .default(sql `gen_random_uuid()`),
     // Optional plan reference (nullable — can be standalone)
-    planId: varchar("plan_id"),
-    engagementId: varchar("engagement_id"), // FK → engagements.id (nullable during transition)
+    planId: varchar("plan_id").references(() => plans.id, {
+        onDelete: "set null",
+    }),
+    engagementId: varchar("engagement_id").references(() => engagements.id, {
+        onDelete: "set null",
+    }), // nullable during transition
     // Configuration references (which plan_configurations to include)
     configurationIds: jsonb("configuration_ids").$type(),
     optionIds: jsonb("option_ids").$type(),
@@ -1080,6 +1151,35 @@ export const insertPlanSchema = createInsertSchema(plans).omit({
     id: true,
     createdAt: true,
 });
+// ============================================================================
+// Proposal Engagement Tracking
+// ============================================================================
+export const proposalEngagement = pgTable("proposal_engagement", {
+    id: varchar("id")
+        .primaryKey()
+        .default(sql `gen_random_uuid()`),
+    proposalId: varchar("proposal_id"), // FK → proposals.id (nullable for legacy plan-based shares)
+    planId: varchar("plan_id"), // FK → plans.id (fallback for legacy shares)
+    shareToken: text("share_token").notNull(), // The share token used to access
+    sessionId: text("session_id").notNull(), // Anonymous session ID (crypto.randomUUID on client)
+    // Engagement data
+    events: jsonb("events").notNull().default(sql `'[]'::jsonb`), // Array of engagement events
+    engagementScore: integer("engagement_score").default(0), // Computed 0-100 score
+    summary: text("summary"), // AI-generated follow-up brief
+    // Device context
+    device: text("device"), // "desktop" | "mobile" | "tablet"
+    referrer: text("referrer"), // HTTP referrer
+    userAgent: text("user_agent"),
+    // Timestamps
+    firstSeenAt: timestamp("first_seen_at").notNull().defaultNow(),
+    lastSeenAt: timestamp("last_seen_at").notNull().defaultNow(),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+}, (table) => [
+    index("proposal_engagement_proposal_id_idx").on(table.proposalId),
+    index("proposal_engagement_plan_id_idx").on(table.planId),
+    index("proposal_engagement_share_token_idx").on(table.shareToken),
+    index("proposal_engagement_token_session_idx").on(table.shareToken, table.sessionId),
+]);
 // Plan Configurations — Named product mixes (replaces monolithic planAllocations)
 // A plan can have multiple configurations (e.g., "Digital Focus", "Full Mix", "Print Heavy")
 export const planConfigurations = pgTable("plan_configurations", {
@@ -1414,6 +1514,7 @@ export const clerkUsers = pgTable("clerk_users", {
     createdAt: timestamp("created_at").notNull().defaultNow(),
     approvedAt: timestamp("approved_at"),
     approvedBy: text("approved_by"), // Admin who approved
+    compassVoiceWarmth: numeric("compass_voice_warmth").default("0.6"),
 });
 export const insertClerkUserSchema = createInsertSchema(clerkUsers).omit({
     createdAt: true,
@@ -3268,19 +3369,106 @@ export const mediaOrderStatusEnum = pgEnum("media_order_status", [
     "active",
     "completed",
 ]);
+export const salesInitiatives = pgTable("sales_initiatives", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    code: varchar("code").notNull().unique(),
+    name: varchar("name").notNull(),
+    description: text("description"),
+    hubspotValue: varchar("hubspot_value").notNull().unique(),
+    displayOrder: integer("display_order").notNull().default(0),
+    startsAt: date("starts_at"),
+    endsAt: date("ends_at"),
+    isActive: boolean("is_active").notNull().default(true),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+}, (table) => [
+    index("sales_initiatives_active_idx").on(table.isActive),
+    index("sales_initiatives_display_order_idx").on(table.displayOrder),
+]);
+export const insertSalesInitiativeSchema = createInsertSchema(salesInitiatives).omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+export const updateSalesInitiativeSchema = insertSalesInitiativeSchema.partial();
+export const salesPackages = pgTable("sales_packages", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    code: varchar("code").notNull().unique(),
+    name: varchar("name").notNull(),
+    description: text("description"),
+    initiativeCode: varchar("initiative_code"),
+    sellerSummary: text("seller_summary"),
+    packagePrice: numeric("package_price", { precision: 12, scale: 2 }),
+    discountPercent: numeric("discount_percent", { precision: 5, scale: 2 }),
+    addedValueAmount: numeric("added_value_amount", { precision: 12, scale: 2 }),
+    addedValueDescription: varchar("added_value_description", { length: 255 }),
+    hubspotPackageValue: varchar("hubspot_package_value").notNull().unique(),
+    startsAt: date("starts_at"),
+    endsAt: date("ends_at"),
+    status: varchar("status").notNull().default("draft"),
+    recommendationMode: varchar("recommendation_mode").notNull().default("both"),
+    recommendationPriority: integer("recommendation_priority").notNull().default(0),
+    eligibilityRules: jsonb("eligibility_rules").$type(),
+    assistantHints: jsonb("assistant_hints").$type(),
+    taskTemplateMode: varchar("task_template_mode").notNull().default("standard"),
+    displayOrder: integer("display_order").notNull().default(0),
+    isActive: boolean("is_active").notNull().default(true),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+}, (table) => [
+    index("sales_packages_active_idx").on(table.isActive),
+    index("sales_packages_status_idx").on(table.status),
+    index("sales_packages_display_order_idx").on(table.displayOrder),
+    index("sales_packages_initiative_code_idx").on(table.initiativeCode),
+]);
+export const insertSalesPackageSchema = createInsertSchema(salesPackages).omit({
+    id: true,
+    createdAt: true,
+    updatedAt: true,
+});
+export const updateSalesPackageSchema = insertSalesPackageSchema.partial();
+export const salesPackageProducts = pgTable("sales_package_products", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    salesPackageCode: varchar("sales_package_code").notNull(),
+    stribProductId: uuid("strib_product_id")
+        .notNull()
+        .references(() => stribProducts.id, { onDelete: "cascade" }),
+    displayOrder: integer("display_order").notNull().default(0),
+    approvedUnitRate: numeric("approved_unit_rate", { precision: 12, scale: 4 }),
+    approvedRateType: varchar("approved_rate_type"),
+    allocationMode: varchar("allocation_mode").notNull().default("percent"),
+    allocationValue: numeric("allocation_value", { precision: 12, scale: 4 }),
+    required: boolean("required").notNull().default(true),
+    defaultFulfillmentDetails: jsonb("default_fulfillment_details"),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+}, (table) => [
+    uniqueIndex("sales_package_products_unique_idx").on(table.salesPackageCode, table.stribProductId),
+    index("sales_package_products_code_idx").on(table.salesPackageCode),
+    index("sales_package_products_product_idx").on(table.stribProductId),
+]);
 export const mediaOrders = pgTable("media_orders", {
     id: varchar("id")
         .primaryKey()
         .default(sql `gen_random_uuid()`),
-    planId: varchar("plan_id"), // FK → plans.id (nullable — can exist without a plan)
-    engagementId: varchar("engagement_id"), // FK → engagements.id (nullable during transition)
+    planId: varchar("plan_id").references(() => plans.id, {
+        onDelete: "set null",
+    }), // nullable — can exist without a plan
+    engagementId: varchar("engagement_id").references(() => engagements.id, {
+        onDelete: "set null",
+    }), // nullable during transition
     configurationId: varchar("configuration_id"), // FK → plan_configurations.id (named product mix)
     optionId: varchar("option_id"), // FK → plan_options.id (canonical selected option)
-    contractId: uuid("contract_id"), // FK → contracts.id (nullable — links to annual contract)
+    contractId: uuid("contract_id").references(() => contracts.id, {
+        onDelete: "set null",
+    }), // nullable — links to annual contract
     partnerId: varchar("partner_id"),
     hubspotDealId: text("hubspot_deal_id"),
     hubspotCompanyId: text("hubspot_company_id"),
     parentHubspotCompanyId: text("parent_hubspot_company_id"),
+    initiativeCode: varchar("initiative_code"),
+    salesPackageCode: varchar("sales_package_code"),
+    salesPackageSnapshot: jsonb("sales_package_snapshot").$type(),
     // Client header
     clientName: text("client_name").notNull(),
     clientContactName: text("client_contact_name"),
@@ -3304,6 +3492,8 @@ export const mediaOrders = pgTable("media_orders", {
     activatedAt: timestamp("activated_at"),
     completedAt: timestamp("completed_at"),
     returnReason: text("return_reason"),
+    amendmentReason: amendmentReasonEnum("amendment_reason"),
+    amendmentNotes: text("amendment_notes"),
     slaHold: boolean("sla_hold").default(false),
     clientTier: text("client_tier"),
     // Share link
@@ -3329,8 +3519,6 @@ export const mediaOrders = pgTable("media_orders", {
     defaultPromoting: text("default_promoting"),
     // Order-level notes
     orderNotes: text("order_notes"),
-    // Sales initiative (links to sales_initiatives table)
-    initiativeCode: varchar("initiative_code"),
     // Billing fields
     navigaAdvertiserId: text("naviga_advertiser_id"),
     purchaseOrderNumber: text("purchase_order_number"),
@@ -3378,12 +3566,14 @@ export const mediaOrders = pgTable("media_orders", {
     index("media_orders_engagement_id_idx").on(table.engagementId),
     index("media_orders_partner_id_idx").on(table.partnerId),
     index("media_orders_hubspot_company_id_idx").on(table.hubspotCompanyId),
+    index("media_orders_hubspot_deal_id_idx").on(table.hubspotDealId),
     index("media_orders_status_idx").on(table.status),
     index("media_orders_vendor_id_idx").on(table.vendorId),
     index("media_orders_vendor_fulfillment_status_idx").on(table.vendorFulfillmentStatus),
     index("media_orders_parent_company_idx").on(table.parentHubspotCompanyId),
     index("media_orders_contract_id_idx").on(table.contractId),
     index("media_orders_initiative_code_idx").on(table.initiativeCode),
+    index("media_orders_sales_package_code_idx").on(table.salesPackageCode),
 ]);
 export const insertMediaOrderSchema = createInsertSchema(mediaOrders).omit({
     id: true,
@@ -3476,6 +3666,11 @@ export const mediaOrderLineItems = pgTable("media_order_line_items", {
     // Fulfillment details (product-specific fields for HubSpot sync)
     fulfillmentDetails: jsonb("fulfillment_details"),
     creativeSource: varchar("creative_source"),
+    initiativeCode: varchar("initiative_code"),
+    salesPackageCode: varchar("sales_package_code"),
+    salesPackageComponentRef: varchar("sales_package_component_ref"),
+    isPackageDerived: boolean("is_package_derived").notNull().default(false),
+    packagePricingSource: varchar("package_pricing_source"),
     // Ad trafficking reference key (auto-generated naming convention)
     trafficKey: text("traffic_key"),
     // Canonical tracking fields for DSP/reporting consistency
@@ -3485,9 +3680,12 @@ export const mediaOrderLineItems = pgTable("media_order_line_items", {
     updatedAt: timestamp("updated_at").notNull().defaultNow(),
 }, (table) => [
     index("media_order_line_items_section_id_idx").on(table.sectionId),
+    index("media_order_line_items_sync_status_idx").on(table.syncStatus),
     index("idx_line_items_parent").on(table.parentLineItemId),
     index("media_order_line_items_location_id_idx").on(table.locationId),
     index("media_order_line_items_tracking_key_idx").on(table.trackingKey),
+    index("media_order_line_items_initiative_code_idx").on(table.initiativeCode),
+    index("media_order_line_items_sales_package_code_idx").on(table.salesPackageCode),
 ]);
 export const insertMediaOrderLineItemSchema = createInsertSchema(mediaOrderLineItems).omit({
     id: true,
@@ -3652,6 +3850,20 @@ export const insertStribProductSchema = createInsertSchema(stribProducts).omit({
     updatedAt: true,
 });
 export const updateStribProductSchema = insertStribProductSchema.partial();
+export const salesInitiativeProducts = pgTable("sales_initiative_products", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    initiativeCode: varchar("initiative_code").notNull(),
+    stribProductId: uuid("strib_product_id")
+        .notNull()
+        .references(() => stribProducts.id, { onDelete: "cascade" }),
+    displayOrder: integer("display_order").notNull().default(0),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+}, (table) => [
+    uniqueIndex("sales_initiative_products_unique_idx").on(table.initiativeCode, table.stribProductId),
+    index("sales_initiative_products_code_idx").on(table.initiativeCode),
+    index("sales_initiative_products_product_idx").on(table.stribProductId),
+]);
 /**
  * strib_product_rates — tier-based pricing per product.
  * Different tiers depending on family: Digital uses open/advocacy/tier_1/tier_2/tier_3;
@@ -3915,6 +4127,7 @@ export const rateExceptionRequests = pgTable("rate_exception_requests", {
     escalationHistory: jsonb("escalation_history"), // Array of {level, at, by, reason}
     expiresAt: timestamp("expires_at"),
     approvalScope: varchar("approval_scope").notNull().default("request"), // "request" = affects this exception only; "catalog" = also updates global product rate
+    batchId: uuid("batch_id"), // Groups bulk rate exception requests submitted together
     createdAt: timestamp("created_at").notNull().defaultNow(),
     updatedAt: timestamp("updated_at").notNull().defaultNow(),
 }, (table) => [
@@ -3922,6 +4135,8 @@ export const rateExceptionRequests = pgTable("rate_exception_requests", {
     index("rate_exception_status_idx").on(table.status),
     index("rate_exception_requester_idx").on(table.requestedByUserId),
     index("rate_exception_plan_idx").on(table.planId),
+    index("rate_exception_batch_idx").on(table.batchId),
+    index("rate_exception_order_status_idx").on(table.mediaOrderId, table.status),
 ]);
 // ─── Lead Time Rules ──────────────────────────────────────────────────────────
 export const leadTimeRules = pgTable("lead_time_rules", {
@@ -3968,6 +4183,31 @@ export const slaConfig = pgTable("sla_config", {
     createdAt: timestamp("created_at").defaultNow(),
     updatedAt: timestamp("updated_at").defaultNow(),
 });
+// ─── SLA Snapshots ───────────────────────────────────────────────────────────
+/**
+ * sla_snapshots — Point-in-time SLA state from fn-flux evaluations.
+ * Each row captures the hold status, deadline, milestones, and profile
+ * for a given media order + fulfillment ticket pair.
+ */
+export const slaHoldStatusEnum = pgEnum("sla_hold_status", ["clear", "hold", "override"]);
+export const slaSnapshots = pgTable("sla_snapshots", {
+    id: serial("id").primaryKey(),
+    mediaOrderId: text("media_order_id").notNull().references(() => mediaOrders.id),
+    ticketId: text("ticket_id").notNull(),
+    holdStatus: slaHoldStatusEnum("hold_status").notNull().default("clear"),
+    holdReason: text("hold_reason"),
+    slaDays: integer("sla_days").notNull(),
+    availableDays: numeric("available_days"),
+    slaDeadline: timestamp("sla_deadline"),
+    campaignStartDate: date("campaign_start_date"),
+    milestones: jsonb("milestones"),
+    profileName: text("profile_name"),
+    lastUpdatedAt: timestamp("last_updated_at").defaultNow(),
+}, (table) => [
+    index("sla_snapshots_media_order_id_idx").on(table.mediaOrderId),
+    index("sla_snapshots_ticket_id_idx").on(table.ticketId),
+    uniqueIndex("sla_snapshots_order_ticket_uniq").on(table.mediaOrderId, table.ticketId),
+]);
 // ─── Inventory Sync Audit Trail ─────────────────────────────────────────────
 /**
  * inventory_sync_log — Audit trail for external inventory syncs (GAM, Sailthru, Naviga).
@@ -5932,6 +6172,7 @@ export const semCampaigns = pgTable("sem_campaigns", {
 // =============================================================================
 export const compassEventOutboxStatusEnum = pgEnum("compass_event_outbox_status", [
     "pending",
+    "processing",
     "failed",
     "delivered",
     "dead_letter",
@@ -5967,4 +6208,73 @@ export const creativeDeliveries = pgTable("creative_deliveries", {
     assetCount: integer("asset_count").notNull().default(0),
     receivedAt: timestamp("received_at").defaultNow().notNull(),
 });
+// ─── Order Activity Feed ────────────────────────────────────────────────────
+export const orderActivityFeed = pgTable("order_activity_feed", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    mediaOrderId: varchar("media_order_id")
+        .notNull()
+        .references(() => mediaOrders.id),
+    lineItemId: varchar("line_item_id").references(() => mediaOrderLineItems.id),
+    eventType: activityEventTypeEnum("event_type").notNull(),
+    title: text("title").notNull(),
+    detail: text("detail"),
+    severity: activitySeverityEnum("severity").notNull(),
+    sourceSystem: activitySourceSystemEnum("source_system").notNull(),
+    externalId: text("external_id").notNull().unique(), // idempotency key — prevents duplicate event ingestion
+    status: text("status"), // intentionally untyped — values vary by eventType (creative vs fulfillment vs contract)
+    occurredAt: timestamp("occurred_at").notNull(),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    metadata: jsonb("metadata").$type(),
+}, (table) => [
+    index("order_activity_feed_order_occurred_idx").on(table.mediaOrderId, table.occurredAt),
+    index("order_activity_feed_line_item_idx").on(table.lineItemId),
+]);
+// ─── Pending Actions ────────────────────────────────────────────────────────
+export const pendingActions = pgTable("pending_actions", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    mediaOrderId: varchar("media_order_id")
+        .notNull()
+        .references(() => mediaOrders.id),
+    lineItemId: varchar("line_item_id").references(() => mediaOrderLineItems.id),
+    actionType: pendingActionTypeEnum("action_type").notNull(),
+    message: text("message").notNull(),
+    activityFeedId: uuid("activity_feed_id")
+        .notNull()
+        .references(() => orderActivityFeed.id),
+    resolvedAt: timestamp("resolved_at"),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+}, (table) => [
+    index("pending_actions_order_idx").on(table.mediaOrderId),
+    index("pending_actions_line_item_idx").on(table.lineItemId),
+    index("pending_actions_activity_feed_idx").on(table.activityFeedId),
+    index("pending_actions_unresolved_idx").on(table.mediaOrderId).where(sql `resolved_at IS NULL`),
+]);
+// ─── Order Version Snapshots ────────────────────────────────────────────────
+export const orderVersionSnapshots = pgTable("order_version_snapshots", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    mediaOrderId: varchar("media_order_id")
+        .notNull()
+        .references(() => mediaOrders.id),
+    version: integer("version").notNull(),
+    amendmentReason: text("amendment_reason"),
+    amendmentNotes: text("amendment_notes"),
+    amendedBy: varchar("amended_by"),
+    snapshot: jsonb("snapshot").notNull().$type(),
+    netInvestment: numeric("net_investment", { precision: 12, scale: 2 }),
+    lineItemCount: integer("line_item_count"),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+}, (table) => [
+    index("order_version_snapshots_order_version_idx").on(table.mediaOrderId, table.version),
+]);
+// ─── User Milestones ────────────────────────────────────────────────────────
+export const userMilestones = pgTable("user_milestones", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    userId: varchar("user_id").notNull(),
+    milestoneKey: text("milestone_key").notNull(),
+    shownAt: timestamp("shown_at").notNull().defaultNow(),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+}, (table) => [
+    index("user_milestones_user_id_idx").on(table.userId),
+    unique("user_milestones_user_key_unique").on(table.userId, table.milestoneKey),
+]);
 //# sourceMappingURL=schema.js.map