@foundrynorth/compass-schema 1.0.21 → 1.0.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foundrynorth/compass-schema",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "description": "Canonical Drizzle ORM schema for Foundry Compass (rough-waterfall database)",
   "type": "module",
   "main": "dist/index.js",

package/src/schema.ts

@@ -598,6 +598,35 @@ 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 type Competitor = z.infer<typeof competitorSchema>;
@@ -1244,6 +1273,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"),
 
@@ -1315,8 +1345,12 @@ export const proposals = pgTable(
       .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<string[]>(),
@@ -1387,6 +1421,41 @@ export const insertPlanSchema = createInsertSchema(plans).omit({
   createdAt: true,
 } as any);
 
+// ============================================================================
+// 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),
+  ]
+);
+
 export type InsertPlan = z.infer<typeof insertPlanSchema>;
 export type Plan = typeof plans.$inferSelect;
 
@@ -4805,22 +4874,134 @@ export type SalesInitiative = typeof salesInitiatives.$inferSelect;
 export type InsertSalesInitiative = z.infer<typeof insertSalesInitiativeSchema>;
 export type UpdateSalesInitiative = z.infer<typeof updateSalesInitiativeSchema>;
 
+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<{
+      goals?: string[];
+      industries?: string[];
+      geographyTags?: string[];
+      minBudget?: number | null;
+      maxBudget?: number | null;
+      requireActiveWindow?: boolean;
+      minProductOverlap?: number | null;
+      allowSubsetMatch?: boolean;
+      allowNearMatch?: boolean;
+      compareSignals?: string[];
+    }>(),
+    assistantHints: jsonb("assistant_hints").$type<{
+      recommendedWhen?: string[];
+      upsellMessage?: string | null;
+      compareHeadline?: string | null;
+      compareBody?: string | null;
+    }>(),
+    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 type SalesPackage = typeof salesPackages.$inferSelect;
+export type InsertSalesPackage = z.infer<typeof insertSalesPackageSchema>;
+export type UpdateSalesPackage = z.infer<typeof updateSalesPackageSchema>;
+
+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 type SalesPackageProduct = typeof salesPackageProducts.$inferSelect;
+
 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<Array<{
+      code: string;
+      name: string;
+      packagePrice: number | null;
+      initiativeCode: string | null;
+      componentCount: number;
+      appliedAt: string;
+      packageSource: "direct_package" | "upgrade_from_selection" | "manual_products";
+      compareSignals?: string[];
+      sellerSummary?: string | null;
+      discountPercent?: number | null;
+      addedValueAmount?: number | null;
+      addedValueDescription?: string | null;
+    }>>(),
 
     // Client header
     clientName: text("client_name").notNull(),
@@ -4944,6 +5125,7 @@ export const mediaOrders = pgTable(
     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),
   ]
 );
 
@@ -5073,6 +5255,10 @@ export const mediaOrderLineItems = pgTable(
     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"),
@@ -5099,6 +5285,7 @@ export const mediaOrderLineItems = pgTable(
     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),
   ]
 );
 
@@ -8321,6 +8508,7 @@ export type InsertSemCampaign = typeof semCampaigns.$inferInsert;
 
 export const compassEventOutboxStatusEnum = pgEnum("compass_event_outbox_status", [
   "pending",
+  "processing",
   "failed",
   "delivered",
   "dead_letter",
@@ -8422,6 +8610,8 @@ export const pendingActions = pgTable(
   },
   (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`,
     ),