@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/marketing/marketing-visibility-overview.schema.d.ts

@@ -0,0 +1,949 @@
+import { z } from 'zod';
+export declare const MarketingVisibilityOverviewSchema: z.ZodObject<{
+    dateRange: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>;
+    warehouse: z.ZodObject<{
+        visitorCount: z.ZodNumber;
+        sessionCount: z.ZodNumber;
+        linkedUserCount: z.ZodNumber;
+        telemetryEventCount7d: z.ZodNumber;
+        conversionQueuePending: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        visitorCount: number;
+        sessionCount: number;
+        linkedUserCount: number;
+        telemetryEventCount7d: number;
+        conversionQueuePending: number;
+    }, {
+        visitorCount: number;
+        sessionCount: number;
+        linkedUserCount: number;
+        telemetryEventCount7d: number;
+        conversionQueuePending: number;
+    }>;
+    worlds: z.ZodArray<z.ZodObject<{
+        worldSlug: z.ZodString;
+        title: z.ZodString;
+        challengeSlug: z.ZodNullable<z.ZodString>;
+        viewWorldCount: z.ZodNumber;
+        viewChallengeCount: z.ZodNumber;
+        joinChallengeCount: z.ZodNumber;
+        submitIdeaCount: z.ZodNumber;
+        ga4Sessions: z.ZodNumber;
+        ga4Conversions: z.ZodNumber;
+        organicClicks: z.ZodNumber;
+        organicImpressions: z.ZodNumber;
+        qualifiedCreatorRate: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        challengeSlug: string | null;
+        worldSlug: string;
+        viewWorldCount: number;
+        viewChallengeCount: number;
+        joinChallengeCount: number;
+        submitIdeaCount: number;
+        ga4Sessions: number;
+        ga4Conversions: number;
+        organicClicks: number;
+        organicImpressions: number;
+        qualifiedCreatorRate: number;
+    }, {
+        title: string;
+        challengeSlug: string | null;
+        worldSlug: string;
+        viewWorldCount: number;
+        viewChallengeCount: number;
+        joinChallengeCount: number;
+        submitIdeaCount: number;
+        ga4Sessions: number;
+        ga4Conversions: number;
+        organicClicks: number;
+        organicImpressions: number;
+        qualifiedCreatorRate: number;
+    }>, "many">;
+    challenges: z.ZodArray<z.ZodObject<{
+        challengeSlug: z.ZodString;
+        worldSlug: z.ZodString;
+        title: z.ZodString;
+        viewChallengeCount: z.ZodNumber;
+        joinChallengeCount: z.ZodNumber;
+        challengeCompletedCount: z.ZodNumber;
+        submitIdeaCount: z.ZodNumber;
+        joinToSubmitRate: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        challengeSlug: string;
+        worldSlug: string;
+        viewChallengeCount: number;
+        joinChallengeCount: number;
+        submitIdeaCount: number;
+        challengeCompletedCount: number;
+        joinToSubmitRate: number;
+    }, {
+        title: string;
+        challengeSlug: string;
+        worldSlug: string;
+        viewChallengeCount: number;
+        joinChallengeCount: number;
+        submitIdeaCount: number;
+        challengeCompletedCount: number;
+        joinToSubmitRate: number;
+    }>, "many">;
+    landingPages: z.ZodArray<z.ZodObject<{
+        pagePath: z.ZodString;
+        worldSlug: z.ZodNullable<z.ZodString>;
+        ga4Sessions: z.ZodNumber;
+        ga4Users: z.ZodNumber;
+        ga4Conversions: z.ZodNumber;
+        ga4BounceRate: z.ZodNullable<z.ZodNumber>;
+        organicClicks: z.ZodNumber;
+        organicImpressions: z.ZodNumber;
+        organicCtr: z.ZodNumber;
+        organicPosition: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        worldSlug: string | null;
+        pagePath: string;
+        ga4Sessions: number;
+        ga4Conversions: number;
+        organicClicks: number;
+        organicImpressions: number;
+        ga4Users: number;
+        ga4BounceRate: number | null;
+        organicCtr: number;
+        organicPosition: number;
+    }, {
+        worldSlug: string | null;
+        pagePath: string;
+        ga4Sessions: number;
+        ga4Conversions: number;
+        organicClicks: number;
+        organicImpressions: number;
+        ga4Users: number;
+        ga4BounceRate: number | null;
+        organicCtr: number;
+        organicPosition: number;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    challenges: {
+        title: string;
+        challengeSlug: string;
+        worldSlug: string;
+        viewChallengeCount: number;
+        joinChallengeCount: number;
+        submitIdeaCount: number;
+        challengeCompletedCount: number;
+        joinToSubmitRate: number;
+    }[];
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    landingPages: {
+        worldSlug: string | null;
+        pagePath: string;
+        ga4Sessions: number;
+        ga4Conversions: number;
+        organicClicks: number;
+        organicImpressions: number;
+        ga4Users: number;
+        ga4BounceRate: number | null;
+        organicCtr: number;
+        organicPosition: number;
+    }[];
+    warehouse: {
+        visitorCount: number;
+        sessionCount: number;
+        linkedUserCount: number;
+        telemetryEventCount7d: number;
+        conversionQueuePending: number;
+    };
+    worlds: {
+        title: string;
+        challengeSlug: string | null;
+        worldSlug: string;
+        viewWorldCount: number;
+        viewChallengeCount: number;
+        joinChallengeCount: number;
+        submitIdeaCount: number;
+        ga4Sessions: number;
+        ga4Conversions: number;
+        organicClicks: number;
+        organicImpressions: number;
+        qualifiedCreatorRate: number;
+    }[];
+}, {
+    challenges: {
+        title: string;
+        challengeSlug: string;
+        worldSlug: string;
+        viewChallengeCount: number;
+        joinChallengeCount: number;
+        submitIdeaCount: number;
+        challengeCompletedCount: number;
+        joinToSubmitRate: number;
+    }[];
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    landingPages: {
+        worldSlug: string | null;
+        pagePath: string;
+        ga4Sessions: number;
+        ga4Conversions: number;
+        organicClicks: number;
+        organicImpressions: number;
+        ga4Users: number;
+        ga4BounceRate: number | null;
+        organicCtr: number;
+        organicPosition: number;
+    }[];
+    warehouse: {
+        visitorCount: number;
+        sessionCount: number;
+        linkedUserCount: number;
+        telemetryEventCount7d: number;
+        conversionQueuePending: number;
+    };
+    worlds: {
+        title: string;
+        challengeSlug: string | null;
+        worldSlug: string;
+        viewWorldCount: number;
+        viewChallengeCount: number;
+        joinChallengeCount: number;
+        submitIdeaCount: number;
+        ga4Sessions: number;
+        ga4Conversions: number;
+        organicClicks: number;
+        organicImpressions: number;
+        qualifiedCreatorRate: number;
+    }[];
+}>;
+export type MarketingVisibilityOverview = z.infer<typeof MarketingVisibilityOverviewSchema>;
+export declare const MarketingVisibilityOverviewResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        dateRange: z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            from: string;
+            to: string;
+        }, {
+            from: string;
+            to: string;
+        }>;
+        warehouse: z.ZodObject<{
+            visitorCount: z.ZodNumber;
+            sessionCount: z.ZodNumber;
+            linkedUserCount: z.ZodNumber;
+            telemetryEventCount7d: z.ZodNumber;
+            conversionQueuePending: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            telemetryEventCount7d: number;
+            conversionQueuePending: number;
+        }, {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            telemetryEventCount7d: number;
+            conversionQueuePending: number;
+        }>;
+        worlds: z.ZodArray<z.ZodObject<{
+            worldSlug: z.ZodString;
+            title: z.ZodString;
+            challengeSlug: z.ZodNullable<z.ZodString>;
+            viewWorldCount: z.ZodNumber;
+            viewChallengeCount: z.ZodNumber;
+            joinChallengeCount: z.ZodNumber;
+            submitIdeaCount: z.ZodNumber;
+            ga4Sessions: z.ZodNumber;
+            ga4Conversions: z.ZodNumber;
+            organicClicks: z.ZodNumber;
+            organicImpressions: z.ZodNumber;
+            qualifiedCreatorRate: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            title: string;
+            challengeSlug: string | null;
+            worldSlug: string;
+            viewWorldCount: number;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            qualifiedCreatorRate: number;
+        }, {
+            title: string;
+            challengeSlug: string | null;
+            worldSlug: string;
+            viewWorldCount: number;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            qualifiedCreatorRate: number;
+        }>, "many">;
+        challenges: z.ZodArray<z.ZodObject<{
+            challengeSlug: z.ZodString;
+            worldSlug: z.ZodString;
+            title: z.ZodString;
+            viewChallengeCount: z.ZodNumber;
+            joinChallengeCount: z.ZodNumber;
+            challengeCompletedCount: z.ZodNumber;
+            submitIdeaCount: z.ZodNumber;
+            joinToSubmitRate: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            title: string;
+            challengeSlug: string;
+            worldSlug: string;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            challengeCompletedCount: number;
+            joinToSubmitRate: number;
+        }, {
+            title: string;
+            challengeSlug: string;
+            worldSlug: string;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            challengeCompletedCount: number;
+            joinToSubmitRate: number;
+        }>, "many">;
+        landingPages: z.ZodArray<z.ZodObject<{
+            pagePath: z.ZodString;
+            worldSlug: z.ZodNullable<z.ZodString>;
+            ga4Sessions: z.ZodNumber;
+            ga4Users: z.ZodNumber;
+            ga4Conversions: z.ZodNumber;
+            ga4BounceRate: z.ZodNullable<z.ZodNumber>;
+            organicClicks: z.ZodNumber;
+            organicImpressions: z.ZodNumber;
+            organicCtr: z.ZodNumber;
+            organicPosition: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            worldSlug: string | null;
+            pagePath: string;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            ga4Users: number;
+            ga4BounceRate: number | null;
+            organicCtr: number;
+            organicPosition: number;
+        }, {
+            worldSlug: string | null;
+            pagePath: string;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            ga4Users: number;
+            ga4BounceRate: number | null;
+            organicCtr: number;
+            organicPosition: number;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        challenges: {
+            title: string;
+            challengeSlug: string;
+            worldSlug: string;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            challengeCompletedCount: number;
+            joinToSubmitRate: number;
+        }[];
+        dateRange: {
+            from: string;
+            to: string;
+        };
+        landingPages: {
+            worldSlug: string | null;
+            pagePath: string;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            ga4Users: number;
+            ga4BounceRate: number | null;
+            organicCtr: number;
+            organicPosition: number;
+        }[];
+        warehouse: {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            telemetryEventCount7d: number;
+            conversionQueuePending: number;
+        };
+        worlds: {
+            title: string;
+            challengeSlug: string | null;
+            worldSlug: string;
+            viewWorldCount: number;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            qualifiedCreatorRate: number;
+        }[];
+    }, {
+        challenges: {
+            title: string;
+            challengeSlug: string;
+            worldSlug: string;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            challengeCompletedCount: number;
+            joinToSubmitRate: number;
+        }[];
+        dateRange: {
+            from: string;
+            to: string;
+        };
+        landingPages: {
+            worldSlug: string | null;
+            pagePath: string;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            ga4Users: number;
+            ga4BounceRate: number | null;
+            organicCtr: number;
+            organicPosition: number;
+        }[];
+        warehouse: {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            telemetryEventCount7d: number;
+            conversionQueuePending: number;
+        };
+        worlds: {
+            title: string;
+            challengeSlug: string | null;
+            worldSlug: string;
+            viewWorldCount: number;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            qualifiedCreatorRate: number;
+        }[];
+    }>;
+}, "strict", z.ZodTypeAny, {
+    success: true;
+    data: {
+        challenges: {
+            title: string;
+            challengeSlug: string;
+            worldSlug: string;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            challengeCompletedCount: number;
+            joinToSubmitRate: number;
+        }[];
+        dateRange: {
+            from: string;
+            to: string;
+        };
+        landingPages: {
+            worldSlug: string | null;
+            pagePath: string;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            ga4Users: number;
+            ga4BounceRate: number | null;
+            organicCtr: number;
+            organicPosition: number;
+        }[];
+        warehouse: {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            telemetryEventCount7d: number;
+            conversionQueuePending: number;
+        };
+        worlds: {
+            title: string;
+            challengeSlug: string | null;
+            worldSlug: string;
+            viewWorldCount: number;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            qualifiedCreatorRate: number;
+        }[];
+    };
+}, {
+    success: true;
+    data: {
+        challenges: {
+            title: string;
+            challengeSlug: string;
+            worldSlug: string;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            challengeCompletedCount: number;
+            joinToSubmitRate: number;
+        }[];
+        dateRange: {
+            from: string;
+            to: string;
+        };
+        landingPages: {
+            worldSlug: string | null;
+            pagePath: string;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            ga4Users: number;
+            ga4BounceRate: number | null;
+            organicCtr: number;
+            organicPosition: number;
+        }[];
+        warehouse: {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            telemetryEventCount7d: number;
+            conversionQueuePending: number;
+        };
+        worlds: {
+            title: string;
+            challengeSlug: string | null;
+            worldSlug: string;
+            viewWorldCount: number;
+            viewChallengeCount: number;
+            joinChallengeCount: number;
+            submitIdeaCount: number;
+            ga4Sessions: number;
+            ga4Conversions: number;
+            organicClicks: number;
+            organicImpressions: number;
+            qualifiedCreatorRate: number;
+        }[];
+    };
+}>;
+export declare const MarketingRecommendationsGenerateResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        generatedAt: z.ZodString;
+        recommendations: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            status: z.ZodEnum<["pending", "approved", "rejected", "applied", "expired", "failed"]>;
+            action_type: z.ZodEnum<["increase_spend", "pause_keyword", "negative_keyword", "new_landing_page", "split_ad_group", "test_cta", "world_trailer", "launch_challenge", "retarget_pricing_viewers", "seo_page"]>;
+            priority: z.ZodEnum<["low", "medium", "high", "critical"]>;
+            priority_score: z.ZodNumber;
+            title: z.ZodString;
+            rationale: z.ZodString;
+            evidence: z.ZodObject<{
+                date_range: z.ZodObject<{
+                    start: z.ZodString;
+                    end: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    start: string;
+                    end: string;
+                }, {
+                    start: string;
+                    end: string;
+                }>;
+                metrics: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                entity_refs: z.ZodArray<z.ZodObject<{
+                    entity_type: z.ZodEnum<["campaign", "ad_group", "keyword", "landing_page", "world", "challenge"]>;
+                    entity_id: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }, {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }>, "many">;
+                rule_ids: z.ZodArray<z.ZodString, "many">;
+                rules_version: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                metrics: Record<string, number>;
+                date_range: {
+                    start: string;
+                    end: string;
+                };
+                entity_refs: {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }[];
+                rule_ids: string[];
+                rules_version: string;
+            }, {
+                metrics: Record<string, number>;
+                date_range: {
+                    start: string;
+                    end: string;
+                };
+                entity_refs: {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }[];
+                rule_ids: string[];
+                rules_version: string;
+            }>;
+            proposed_change: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            approval: z.ZodObject<{
+                required: z.ZodLiteral<true>;
+                approved_by: z.ZodNullable<z.ZodString>;
+                approved_at: z.ZodNullable<z.ZodString>;
+                rejected_by: z.ZodNullable<z.ZodString>;
+                rejected_at: z.ZodNullable<z.ZodString>;
+                rejection_reason: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                required: true;
+                approved_by: string | null;
+                approved_at: string | null;
+                rejection_reason: string | null;
+                rejected_by: string | null;
+                rejected_at: string | null;
+            }, {
+                required: true;
+                approved_by: string | null;
+                approved_at: string | null;
+                rejection_reason: string | null;
+                rejected_by: string | null;
+                rejected_at: string | null;
+            }>;
+            execution: z.ZodObject<{
+                feature_flag: z.ZodString;
+                applied_at: z.ZodNullable<z.ZodString>;
+                external_job_id: z.ZodNullable<z.ZodString>;
+                error_code: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                error_code: string | null;
+                feature_flag: string;
+                applied_at: string | null;
+                external_job_id: string | null;
+            }, {
+                error_code: string | null;
+                feature_flag: string;
+                applied_at: string | null;
+                external_job_id: string | null;
+            }>;
+            expires_at: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            status: "failed" | "pending" | "rejected" | "approved" | "applied" | "expired";
+            created_at: string;
+            updated_at: string;
+            evidence: {
+                metrics: Record<string, number>;
+                date_range: {
+                    start: string;
+                    end: string;
+                };
+                entity_refs: {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }[];
+                rule_ids: string[];
+                rules_version: string;
+            };
+            rationale: string;
+            priority: "critical" | "low" | "medium" | "high";
+            approval: {
+                required: true;
+                approved_by: string | null;
+                approved_at: string | null;
+                rejection_reason: string | null;
+                rejected_by: string | null;
+                rejected_at: string | null;
+            };
+            action_type: "increase_spend" | "pause_keyword" | "negative_keyword" | "new_landing_page" | "split_ad_group" | "test_cta" | "world_trailer" | "launch_challenge" | "retarget_pricing_viewers" | "seo_page";
+            priority_score: number;
+            proposed_change: Record<string, unknown>;
+            execution: {
+                error_code: string | null;
+                feature_flag: string;
+                applied_at: string | null;
+                external_job_id: string | null;
+            };
+            expires_at: string;
+        }, {
+            id: string;
+            title: string;
+            status: "failed" | "pending" | "rejected" | "approved" | "applied" | "expired";
+            created_at: string;
+            updated_at: string;
+            evidence: {
+                metrics: Record<string, number>;
+                date_range: {
+                    start: string;
+                    end: string;
+                };
+                entity_refs: {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }[];
+                rule_ids: string[];
+                rules_version: string;
+            };
+            rationale: string;
+            priority: "critical" | "low" | "medium" | "high";
+            approval: {
+                required: true;
+                approved_by: string | null;
+                approved_at: string | null;
+                rejection_reason: string | null;
+                rejected_by: string | null;
+                rejected_at: string | null;
+            };
+            action_type: "increase_spend" | "pause_keyword" | "negative_keyword" | "new_landing_page" | "split_ad_group" | "test_cta" | "world_trailer" | "launch_challenge" | "retarget_pricing_viewers" | "seo_page";
+            priority_score: number;
+            proposed_change: Record<string, unknown>;
+            execution: {
+                error_code: string | null;
+                feature_flag: string;
+                applied_at: string | null;
+                external_job_id: string | null;
+            };
+            expires_at: string;
+        }>, "many">;
+        meta: z.ZodObject<{
+            rulesVersion: z.ZodString;
+            keywordOpportunityCount: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            rulesVersion: string;
+            keywordOpportunityCount: number;
+        }, {
+            rulesVersion: string;
+            keywordOpportunityCount: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        generatedAt: string;
+        meta: {
+            rulesVersion: string;
+            keywordOpportunityCount: number;
+        };
+        recommendations: {
+            id: string;
+            title: string;
+            status: "failed" | "pending" | "rejected" | "approved" | "applied" | "expired";
+            created_at: string;
+            updated_at: string;
+            evidence: {
+                metrics: Record<string, number>;
+                date_range: {
+                    start: string;
+                    end: string;
+                };
+                entity_refs: {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }[];
+                rule_ids: string[];
+                rules_version: string;
+            };
+            rationale: string;
+            priority: "critical" | "low" | "medium" | "high";
+            approval: {
+                required: true;
+                approved_by: string | null;
+                approved_at: string | null;
+                rejection_reason: string | null;
+                rejected_by: string | null;
+                rejected_at: string | null;
+            };
+            action_type: "increase_spend" | "pause_keyword" | "negative_keyword" | "new_landing_page" | "split_ad_group" | "test_cta" | "world_trailer" | "launch_challenge" | "retarget_pricing_viewers" | "seo_page";
+            priority_score: number;
+            proposed_change: Record<string, unknown>;
+            execution: {
+                error_code: string | null;
+                feature_flag: string;
+                applied_at: string | null;
+                external_job_id: string | null;
+            };
+            expires_at: string;
+        }[];
+    }, {
+        generatedAt: string;
+        meta: {
+            rulesVersion: string;
+            keywordOpportunityCount: number;
+        };
+        recommendations: {
+            id: string;
+            title: string;
+            status: "failed" | "pending" | "rejected" | "approved" | "applied" | "expired";
+            created_at: string;
+            updated_at: string;
+            evidence: {
+                metrics: Record<string, number>;
+                date_range: {
+                    start: string;
+                    end: string;
+                };
+                entity_refs: {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }[];
+                rule_ids: string[];
+                rules_version: string;
+            };
+            rationale: string;
+            priority: "critical" | "low" | "medium" | "high";
+            approval: {
+                required: true;
+                approved_by: string | null;
+                approved_at: string | null;
+                rejection_reason: string | null;
+                rejected_by: string | null;
+                rejected_at: string | null;
+            };
+            action_type: "increase_spend" | "pause_keyword" | "negative_keyword" | "new_landing_page" | "split_ad_group" | "test_cta" | "world_trailer" | "launch_challenge" | "retarget_pricing_viewers" | "seo_page";
+            priority_score: number;
+            proposed_change: Record<string, unknown>;
+            execution: {
+                error_code: string | null;
+                feature_flag: string;
+                applied_at: string | null;
+                external_job_id: string | null;
+            };
+            expires_at: string;
+        }[];
+    }>;
+}, "strict", z.ZodTypeAny, {
+    success: true;
+    data: {
+        generatedAt: string;
+        meta: {
+            rulesVersion: string;
+            keywordOpportunityCount: number;
+        };
+        recommendations: {
+            id: string;
+            title: string;
+            status: "failed" | "pending" | "rejected" | "approved" | "applied" | "expired";
+            created_at: string;
+            updated_at: string;
+            evidence: {
+                metrics: Record<string, number>;
+                date_range: {
+                    start: string;
+                    end: string;
+                };
+                entity_refs: {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }[];
+                rule_ids: string[];
+                rules_version: string;
+            };
+            rationale: string;
+            priority: "critical" | "low" | "medium" | "high";
+            approval: {
+                required: true;
+                approved_by: string | null;
+                approved_at: string | null;
+                rejection_reason: string | null;
+                rejected_by: string | null;
+                rejected_at: string | null;
+            };
+            action_type: "increase_spend" | "pause_keyword" | "negative_keyword" | "new_landing_page" | "split_ad_group" | "test_cta" | "world_trailer" | "launch_challenge" | "retarget_pricing_viewers" | "seo_page";
+            priority_score: number;
+            proposed_change: Record<string, unknown>;
+            execution: {
+                error_code: string | null;
+                feature_flag: string;
+                applied_at: string | null;
+                external_job_id: string | null;
+            };
+            expires_at: string;
+        }[];
+    };
+}, {
+    success: true;
+    data: {
+        generatedAt: string;
+        meta: {
+            rulesVersion: string;
+            keywordOpportunityCount: number;
+        };
+        recommendations: {
+            id: string;
+            title: string;
+            status: "failed" | "pending" | "rejected" | "approved" | "applied" | "expired";
+            created_at: string;
+            updated_at: string;
+            evidence: {
+                metrics: Record<string, number>;
+                date_range: {
+                    start: string;
+                    end: string;
+                };
+                entity_refs: {
+                    entity_type: "world" | "keyword" | "campaign" | "ad_group" | "landing_page" | "challenge";
+                    entity_id: string;
+                }[];
+                rule_ids: string[];
+                rules_version: string;
+            };
+            rationale: string;
+            priority: "critical" | "low" | "medium" | "high";
+            approval: {
+                required: true;
+                approved_by: string | null;
+                approved_at: string | null;
+                rejection_reason: string | null;
+                rejected_by: string | null;
+                rejected_at: string | null;
+            };
+            action_type: "increase_spend" | "pause_keyword" | "negative_keyword" | "new_landing_page" | "split_ad_group" | "test_cta" | "world_trailer" | "launch_challenge" | "retarget_pricing_viewers" | "seo_page";
+            priority_score: number;
+            proposed_change: Record<string, unknown>;
+            execution: {
+                error_code: string | null;
+                feature_flag: string;
+                applied_at: string | null;
+                external_job_id: string | null;
+            };
+            expires_at: string;
+        }[];
+    };
+}>;