@foundrynorth/flux-schema 1.12.0 → 1.13.1

package/dist/schema.js

@@ -2645,6 +2645,61 @@ export const fluxFulfillmentEventOutbox = pgTable("flux_fulfillment_event_outbox
 }));
 /** Relations for fulfillment event outbox (standalone — no foreign keys) */
 export const fluxFulfillmentEventOutboxRelations = relations(fluxFulfillmentEventOutbox, () => ({}));
+// ---------------------------------------------------------------------------
+// HubSpot Write-Back Queue
+// ---------------------------------------------------------------------------
+/**
+ * Delivery status for HubSpot write-back queue entries.
+ * Mirrors the fulfillment event outbox lifecycle.
+ */
+export const fluxHubspotWritebackStatusEnum = pgEnum("flux_hubspot_writeback_status", ["pending", "delivered", "failed", "dead_letter"]);
+/**
+ * Durable queue for HubSpot property write-backs.
+ *
+ * All computed state (health scores, confidence, completeness, SLA status) is
+ * written back to HubSpot via fire-and-forget calls. When inline delivery fails
+ * (API outage, rate limit, circuit breaker open), the write-back is enqueued
+ * here for retry by the `/api/cron/hubspot-writeback-retry` cron job.
+ *
+ * Pattern modeled after `fluxFulfillmentEventOutbox`.
+ */
+export const fluxHubspotWritebackQueue = pgTable("flux_hubspot_writeback_queue", {
+    id: varchar("id")
+        .primaryKey()
+        .default(sql `gen_random_uuid()`),
+    /** HubSpot object type: "company", "deal", or "ticket" */
+    objectType: text("object_type").notNull(),
+    /** HubSpot numeric object ID */
+    hubspotObjectId: text("hubspot_object_id").notNull(),
+    /** Properties to write as Record<string, string> */
+    properties: jsonb("properties").notNull(),
+    /** Source function that originated this write-back */
+    source: text("source").notNull(),
+    /** Delivery status lifecycle: pending → delivered | failed → dead_letter */
+    status: fluxHubspotWritebackStatusEnum("status")
+        .default("pending")
+        .notNull(),
+    /** Number of delivery attempts so far */
+    attemptCount: integer("attempt_count").default(0).notNull(),
+    /** When to next attempt delivery (exponential backoff) */
+    nextAttemptAt: timestamp("next_attempt_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+    /** Last error message from delivery attempt */
+    lastError: text("last_error"),
+    /** Idempotency key to prevent duplicate queue entries */
+    idempotencyKey: text("idempotency_key").unique(),
+    createdAt: timestamp("created_at", { withTimezone: true })
+        .defaultNow()
+        .notNull(),
+    /** Timestamp of successful delivery */
+    deliveredAt: timestamp("delivered_at", { withTimezone: true }),
+}, (table) => ({
+    pendingIdx: index("flux_hubspot_writeback_pending_idx").on(table.status, table.nextAttemptAt),
+    objectIdx: index("flux_hubspot_writeback_object_idx").on(table.objectType, table.hubspotObjectId),
+}));
+/** Relations for HubSpot write-back queue (standalone — no foreign keys) */
+export const fluxHubspotWritebackQueueRelations = relations(fluxHubspotWritebackQueue, () => ({}));
 // =============================================================================
 // PROGRAMMATIC SHELL — Enums
 // =============================================================================
@@ -3755,7 +3810,7 @@ export const fluxTapclicksLineItems = pgTable("flux_tapclicks_line_items", {
     rate: numeric("rate"),
     floorRate: numeric("floor_rate"),
     rateType: text("rate_type"),
-    impressions: integer("impressions"),
+    impressions: numeric("impressions"),
     totalCost: numeric("total_cost"),
     creativeOptions: text("creative_options"),
     dfpLineItemId: text("dfp_line_item_id"),