@foundrynorth/flux-schema 1.19.11 → 1.21.0

package/dist/schema.d.ts

@@ -40,6 +40,24 @@ export declare const fluxSecretsStatusEnum: import("drizzle-orm/pg-core").PgEnum
 export declare const fluxSecretsPlatformEnum: import("drizzle-orm/pg-core").PgEnum<["railway", "vercel", "trigger", "local"]>;
 export declare const fluxSecretsSyncStatusEnum: import("drizzle-orm/pg-core").PgEnum<["synced", "pending", "failed", "unknown"]>;
 export declare const fluxSecretsAuditActionEnum: import("drizzle-orm/pg-core").PgEnum<["created", "rotated", "revoked", "synced", "sync_failed"]>;
+/**
+ * Milestone events that can trigger a per-user Slack DM. Owners on a ticket
+ * (account manager, account executive, strategist, fulfillment owner) receive
+ * these by default; non-owner subscribers must opt in per event type via
+ * `flux_users.notificationPreferences.milestones.subscriberOptIn`.
+ */
+export declare const MILESTONE_EVENT_TYPES: readonly ["ticket_created", "creative_needed", "creative_approved", "ready_to_traffic", "campaign_live", "campaign_completed", "campaign_paused", "campaign_cancelled", "change_required", "sem_live", "sem_failed"];
+export type MilestoneEventType = (typeof MILESTONE_EVENT_TYPES)[number];
+export interface MilestonePreferences {
+    /** Owner default behavior: "all" (every event), "lifecycle_only" (live/completed/paused/cancelled), or "none". Defaults to "all". */
+    ownerDefaults?: "all" | "lifecycle_only" | "none";
+    /** Event types a non-owner subscriber wants DMs for. Defaults to []. */
+    subscriberOptIn?: MilestoneEventType[];
+    /** Project IDs the user has muted. */
+    mutedProjectIds?: string[];
+    /** ISO timestamp until which all milestone DMs are suppressed. */
+    mutedUntil?: string;
+}
 /**
  * Flux user profiles - extends Clerk user identity with Flux-specific data.
  *
@@ -315,6 +333,7 @@ export declare const fluxUsers: import("drizzle-orm/pg-core").PgTableWithColumns
                 sentinelSeverityThreshold?: "all" | "notable" | "urgent" | "crisis";
                 sentinelDigestFrequency?: "daily" | "weekly" | "none";
                 sentinelSlackDMs?: boolean;
+                milestones?: MilestonePreferences;
             };
             driverParam: unknown;
             notNull: false;
@@ -333,6 +352,7 @@ export declare const fluxUsers: import("drizzle-orm/pg-core").PgTableWithColumns
                 sentinelSeverityThreshold?: "all" | "notable" | "urgent" | "crisis";
                 sentinelDigestFrequency?: "daily" | "weekly" | "none";
                 sentinelSlackDMs?: boolean;
+                milestones?: MilestonePreferences;
             };
         }>;
         onboardingComplete: import("drizzle-orm/pg-core").PgColumn<{
@@ -2376,6 +2396,194 @@ export declare const fluxActivityItems: import("drizzle-orm/pg-core").PgTableWit
     };
     dialect: "pg";
 }>;
+/**
+ * Idempotency ledger for milestone Slack DMs. The dispatcher inserts one row
+ * per (user, source, event) before sending the DM; the unique index causes
+ * `ON CONFLICT DO NOTHING` to no-op on retries / re-syncs / webhook replays.
+ *
+ * Source rows:
+ *   sourceType = "fulfillment_ticket"  → sourceId = flux_fulfillment_tickets.id
+ *   sourceType = "sem_campaign"        → sourceId = flux_sem_campaigns.id
+ *
+ * `slackTs` captures the Slack message timestamp so future code can thread
+ * follow-up updates (e.g. edit the "campaign live" message when it completes).
+ */
+export declare const fluxMilestoneNotifications: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "flux_milestone_notifications";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "flux_milestone_notifications";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        userId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "user_id";
+            tableName: "flux_milestone_notifications";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        sourceType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source_type";
+            tableName: "flux_milestone_notifications";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        sourceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source_id";
+            tableName: "flux_milestone_notifications";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        eventType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "event_type";
+            tableName: "flux_milestone_notifications";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        projectId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "project_id";
+            tableName: "flux_milestone_notifications";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        deliveredAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "delivered_at";
+            tableName: "flux_milestone_notifications";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        slackTs: import("drizzle-orm/pg-core").PgColumn<{
+            name: "slack_ts";
+            tableName: "flux_milestone_notifications";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        metadata: import("drizzle-orm/pg-core").PgColumn<{
+            name: "metadata";
+            tableName: "flux_milestone_notifications";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+    };
+    dialect: "pg";
+}>;
 export declare const fluxAlertRules: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "flux_alert_rules";
     schema: undefined;
@@ -5411,6 +5619,184 @@ export declare const fluxServiceUsageEvents: import("drizzle-orm/pg-core").PgTab
     };
     dialect: "pg";
 }>;
+/**
+ * flux_search_cache — deterministic-key cache for paid search APIs.
+ *
+ * Phase 1 of the search-stack-cost optimization initiative. Wraps the
+ * Exa, GNews, Firecrawl, and DataForSEO clients in fn-flux + fn-v2 so
+ * the same query (same options, same lookback window) doesn't hit the
+ * upstream API multiple times within its TTL.
+ *
+ * Key shape: `{provider}:{operation}:{sha256-of-options-bag}`. Payload
+ * is the verbatim provider response array. `expiresAt` controls TTL
+ * eviction; `hits` is bumped on each cache hit so we can rank
+ * highest-savings keys.
+ *
+ * Cache is bypassed when the caller passes an `AbortSignal` (assistant
+ * tool calls always want fresh data).
+ */
+export declare const fluxSearchCache: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "flux_search_cache";
+    schema: undefined;
+    columns: {
+        cacheKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "cache_key";
+            tableName: "flux_search_cache";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        providerKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "provider_key";
+            tableName: "flux_search_cache";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        operationKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "operation_key";
+            tableName: "flux_search_cache";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: "flux_search_cache";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        queryFingerprint: import("drizzle-orm/pg-core").PgColumn<{
+            name: "query_fingerprint";
+            tableName: "flux_search_cache";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown> | null;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown> | null;
+        }>;
+        expiresAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "expires_at";
+            tableName: "flux_search_cache";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        hits: import("drizzle-orm/pg-core").PgColumn<{
+            name: "hits";
+            tableName: "flux_search_cache";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastHitAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_hit_at";
+            tableName: "flux_search_cache";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "flux_search_cache";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
 export declare const fluxServiceBudgetAlerts: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "flux_service_budget_alerts";
     schema: undefined;
@@ -14402,7 +14788,7 @@ export declare const fluxFulfillmentTickets: import("drizzle-orm/pg-core").PgTab
             tableName: "flux_fulfillment_tickets";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "paused" | "pending_form" | "submitted" | "pending_creative" | "pending_fulfillment" | "ready" | "running" | "completed" | "cancelled" | "change_required" | "billing_change_required";
+            data: "paused" | "change_required" | "pending_form" | "submitted" | "pending_creative" | "pending_fulfillment" | "ready" | "running" | "completed" | "cancelled" | "billing_change_required";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -16514,7 +16900,7 @@ export declare const fluxFulfillmentTaskTemplates: import("drizzle-orm/pg-core")
             tableName: "flux_fulfillment_task_templates";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "paused" | "pending_form" | "submitted" | "pending_creative" | "pending_fulfillment" | "ready" | "running" | "completed" | "cancelled" | "change_required" | "billing_change_required";
+            data: "paused" | "change_required" | "pending_form" | "submitted" | "pending_creative" | "pending_fulfillment" | "ready" | "running" | "completed" | "cancelled" | "billing_change_required";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -18222,6 +18608,8 @@ export type FluxEmailThread = typeof fluxEmailThreads.$inferSelect;
 export type NewFluxEmailThread = typeof fluxEmailThreads.$inferInsert;
 export type FluxActivityItem = typeof fluxActivityItems.$inferSelect;
 export type NewFluxActivityItem = typeof fluxActivityItems.$inferInsert;
+export type FluxMilestoneNotification = typeof fluxMilestoneNotifications.$inferSelect;
+export type NewFluxMilestoneNotification = typeof fluxMilestoneNotifications.$inferInsert;
 export type FluxAlertRule = typeof fluxAlertRules.$inferSelect;
 export type NewFluxAlertRule = typeof fluxAlertRules.$inferInsert;
 export type FluxAlert = typeof fluxAlerts.$inferSelect;
@@ -18248,6 +18636,8 @@ export type FluxSecretsProvider = typeof fluxSecretsProviders.$inferSelect;
 export type NewFluxSecretsProvider = typeof fluxSecretsProviders.$inferInsert;
 export type FluxServiceUsageEvent = typeof fluxServiceUsageEvents.$inferSelect;
 export type NewFluxServiceUsageEvent = typeof fluxServiceUsageEvents.$inferInsert;
+export type FluxSearchCache = typeof fluxSearchCache.$inferSelect;
+export type NewFluxSearchCache = typeof fluxSearchCache.$inferInsert;
 export type FluxServiceBudgetAlert = typeof fluxServiceBudgetAlerts.$inferSelect;
 export type NewFluxServiceBudgetAlert = typeof fluxServiceBudgetAlerts.$inferInsert;
 export type FluxServiceCostReconciliation = typeof fluxServiceCostReconciliations.$inferSelect;