@foundrynorth/compass-schema 1.0.21 → 1.0.23

package/dist/schema.js

@@ -475,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(),
@@ -1016,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
@@ -1069,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(),
@@ -1122,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", {
@@ -3333,20 +3391,84 @@ export const insertSalesInitiativeSchema = createInsertSchema(salesInitiatives).
     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"),
@@ -3451,6 +3573,7 @@ export const mediaOrders = pgTable("media_orders", {
     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,
@@ -3544,6 +3667,10 @@ export const mediaOrderLineItems = pgTable("media_order_line_items", {
     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
@@ -3558,6 +3685,7 @@ export const mediaOrderLineItems = pgTable("media_order_line_items", {
     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,
@@ -6040,10 +6168,19 @@ export const semCampaigns = pgTable("sem_campaigns", {
     index("sem_campaigns_status_idx").on(table.status),
 ]);
 // =============================================================================
-// COMPASS EVENT OUTBOX (dead-letter queue for fn-flux webhook events)
+// COMPASS EVENT OUTBOX (durable outbox for cross-system writes)
+//
+// Generic claim/retry/DLQ pattern used by multiple producers. Events are
+// namespaced by `eventType` prefix so multiple workers can drain the same
+// table without contention:
+//   • "flux.*"         — fn-flux webhook delivery to external consumers
+//   • "hubspot.*"      — HubSpot ticket / Campaign Task writes from fn-legacy
+//                        (drained by fn-v2 hubspot-outbox-worker)
+// Workers filter on `event_type LIKE '{namespace}.%'` in their claim query.
 // =============================================================================
 export const compassEventOutboxStatusEnum = pgEnum("compass_event_outbox_status", [
     "pending",
+    "processing",
     "failed",
     "delivered",
     "dead_letter",
@@ -6116,6 +6253,8 @@ export const pendingActions = pgTable("pending_actions", {
     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 ────────────────────────────────────────────────