@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/marketing/community-movie-google-ads.constants.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Canonical Google Ads accounts for Community.Movie marketing intelligence.
+ * @see .repo-policy/community-movie.constitution.md (Law CM-9)
+ * @see docs/google-ads-api/Community-Movie-Marketing-Intelligence-Design-Documentation.html
+ */
+/** Google Ads manager (MCC) — `GOOGLE_ADS_LOGIN_CUSTOMER_ID` in Doppler (no dashes). */
+export declare const COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID: "6483231390";
+/** MCC display name in Google Ads UI. */
+export declare const COMMUNITY_MOVIE_GOOGLE_ADS_MCC_ACCOUNT_NAME: "Community Movie";
+/** Google Ads advertiser customer ID (no dashes) — `GOOGLE_ADS_CUSTOMER_ID` in Doppler. */
+export declare const COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID: "5338378654";
+/** Human-readable advertiser label in Google Ads UI. */
+export declare const COMMUNITY_MOVIE_GOOGLE_ADS_ACCOUNT_NAME: "community.movie";
+/** gtag / Ads conversion tag (`NEXT_PUBLIC_GOOGLE_ADS_ID` in Doppler / Vercel). */
+export declare const COMMUNITY_MOVIE_GOOGLE_ADS_CONVERSION_TAG_ID: "AW-18173021866";
+/** GA4 property for marketing intelligence API (`GA4_PROPERTY_ID` in Doppler). */
+export declare const COMMUNITY_MOVIE_GA4_PROPERTY_ID: "538251218";
+/** Search Console property (`GSC_SITE_URL` in Doppler). */
+export declare const COMMUNITY_MOVIE_GSC_SITE_URL: "sc-domain:community.movie";
+/**
+ * Canonical Doppler / Vercel values for Community.Movie Google marketing (Law CM-9).
+ * Server-side keys: neuraloom `prd` / `prd_preview`; public keys: community.movie deploy.
+ */
+export declare const COMMUNITY_MOVIE_GOOGLE_MARKETING_DOPPLER_CANONICAL: {
+    readonly GOOGLE_ADS_LOGIN_CUSTOMER_ID: "6483231390";
+    readonly GOOGLE_ADS_CUSTOMER_ID: "5338378654";
+    readonly NEXT_PUBLIC_GOOGLE_ADS_ID: "AW-18173021866";
+    readonly GA4_PROPERTY_ID: "538251218";
+    readonly GSC_SITE_URL: "sc-domain:community.movie";
+};
+/** Public keys on community.movie Vercel deploy (browser gtag conversions). */
+export declare const COMMUNITY_MOVIE_PUBLIC_ADS_CONVERSION_ENV_KEYS: readonly ["NEXT_PUBLIC_GOOGLE_ADS_SIGNUP_CONVERSION_LABEL", "NEXT_PUBLIC_GOOGLE_ADS_PURCHASE_CONVERSION_LABEL"];
+/**
+ * Square logo for Google Ads asset upload (PMax / display). Public Supabase object;
+ * site `/icon-512.png` after middleware static bypass is deployed.
+ */
+export declare const COMMUNITY_MOVIE_ADS_LOGO_PUBLIC_URL: "https://cvwvuxedmarmvxfdcsib.supabase.co/storage/v1/object/public/community-movie-assets/brand/community-movie-icon-512.png";
+/**
+ * Customer IDs that must never be used for Community.Movie marketing (wrong org / legacy).
+ * NeuroNetIQ corporate Ads account — not community.movie.
+ */
+export declare const FORBIDDEN_COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_IDS: readonly ["8099454983"];
+export type CommunityMovieGoogleAdsLoginCustomerId = typeof COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID;
+export type CommunityMovieGoogleAdsCustomerId = typeof COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID;
+export type ForbiddenCommunityMovieGoogleAdsCustomerId = (typeof FORBIDDEN_COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_IDS)[number];
+/** Format 10-digit Google Ads ID as `XXX-XXX-XXXX` for operator docs and UI. */
+export declare function formatGoogleAdsCustomerId(customerId: string): string;
+export declare const COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID_FORMATTED: string;
+export declare const COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID_FORMATTED: string;

package/dist/marketing/community-movie-google-ads.constants.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Canonical Google Ads accounts for Community.Movie marketing intelligence.
+ * @see .repo-policy/community-movie.constitution.md (Law CM-9)
+ * @see docs/google-ads-api/Community-Movie-Marketing-Intelligence-Design-Documentation.html
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID_FORMATTED = exports.COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID_FORMATTED = exports.FORBIDDEN_COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_IDS = exports.COMMUNITY_MOVIE_ADS_LOGO_PUBLIC_URL = exports.COMMUNITY_MOVIE_PUBLIC_ADS_CONVERSION_ENV_KEYS = exports.COMMUNITY_MOVIE_GOOGLE_MARKETING_DOPPLER_CANONICAL = exports.COMMUNITY_MOVIE_GSC_SITE_URL = exports.COMMUNITY_MOVIE_GA4_PROPERTY_ID = exports.COMMUNITY_MOVIE_GOOGLE_ADS_CONVERSION_TAG_ID = exports.COMMUNITY_MOVIE_GOOGLE_ADS_ACCOUNT_NAME = exports.COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID = exports.COMMUNITY_MOVIE_GOOGLE_ADS_MCC_ACCOUNT_NAME = exports.COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID = void 0;
+exports.formatGoogleAdsCustomerId = formatGoogleAdsCustomerId;
+/** Google Ads manager (MCC) — `GOOGLE_ADS_LOGIN_CUSTOMER_ID` in Doppler (no dashes). */
+exports.COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID = '6483231390';
+/** MCC display name in Google Ads UI. */
+exports.COMMUNITY_MOVIE_GOOGLE_ADS_MCC_ACCOUNT_NAME = 'Community Movie';
+/** Google Ads advertiser customer ID (no dashes) — `GOOGLE_ADS_CUSTOMER_ID` in Doppler. */
+exports.COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID = '5338378654';
+/** Human-readable advertiser label in Google Ads UI. */
+exports.COMMUNITY_MOVIE_GOOGLE_ADS_ACCOUNT_NAME = 'community.movie';
+/** gtag / Ads conversion tag (`NEXT_PUBLIC_GOOGLE_ADS_ID` in Doppler / Vercel). */
+exports.COMMUNITY_MOVIE_GOOGLE_ADS_CONVERSION_TAG_ID = 'AW-18173021866';
+/** GA4 property for marketing intelligence API (`GA4_PROPERTY_ID` in Doppler). */
+exports.COMMUNITY_MOVIE_GA4_PROPERTY_ID = '538251218';
+/** Search Console property (`GSC_SITE_URL` in Doppler). */
+exports.COMMUNITY_MOVIE_GSC_SITE_URL = 'sc-domain:community.movie';
+/**
+ * Canonical Doppler / Vercel values for Community.Movie Google marketing (Law CM-9).
+ * Server-side keys: neuraloom `prd` / `prd_preview`; public keys: community.movie deploy.
+ */
+exports.COMMUNITY_MOVIE_GOOGLE_MARKETING_DOPPLER_CANONICAL = {
+    GOOGLE_ADS_LOGIN_CUSTOMER_ID: exports.COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID,
+    GOOGLE_ADS_CUSTOMER_ID: exports.COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID,
+    NEXT_PUBLIC_GOOGLE_ADS_ID: exports.COMMUNITY_MOVIE_GOOGLE_ADS_CONVERSION_TAG_ID,
+    GA4_PROPERTY_ID: exports.COMMUNITY_MOVIE_GA4_PROPERTY_ID,
+    GSC_SITE_URL: exports.COMMUNITY_MOVIE_GSC_SITE_URL,
+};
+/** Public keys on community.movie Vercel deploy (browser gtag conversions). */
+exports.COMMUNITY_MOVIE_PUBLIC_ADS_CONVERSION_ENV_KEYS = [
+    'NEXT_PUBLIC_GOOGLE_ADS_SIGNUP_CONVERSION_LABEL',
+    'NEXT_PUBLIC_GOOGLE_ADS_PURCHASE_CONVERSION_LABEL',
+];
+/**
+ * Square logo for Google Ads asset upload (PMax / display). Public Supabase object;
+ * site `/icon-512.png` after middleware static bypass is deployed.
+ */
+exports.COMMUNITY_MOVIE_ADS_LOGO_PUBLIC_URL = 'https://cvwvuxedmarmvxfdcsib.supabase.co/storage/v1/object/public/community-movie-assets/brand/community-movie-icon-512.png';
+/**
+ * Customer IDs that must never be used for Community.Movie marketing (wrong org / legacy).
+ * NeuroNetIQ corporate Ads account — not community.movie.
+ */
+exports.FORBIDDEN_COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_IDS = ['8099454983'];
+/** Format 10-digit Google Ads ID as `XXX-XXX-XXXX` for operator docs and UI. */
+function formatGoogleAdsCustomerId(customerId) {
+    const digits = customerId.replace(/\D/g, '');
+    if (digits.length !== 10) {
+        return customerId;
+    }
+    return `${digits.slice(0, 3)}-${digits.slice(3, 6)}-${digits.slice(6)}`;
+}
+exports.COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID_FORMATTED = formatGoogleAdsCustomerId(exports.COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID);
+exports.COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID_FORMATTED = formatGoogleAdsCustomerId(exports.COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID);

package/dist/marketing/config.schema.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+/** Documents required Doppler env keys — values loaded server-side only. */
+export declare const MarketingGoogleEnvKeysSchema: z.ZodObject<{
+    GOOGLE_API_MODE: z.ZodOptional<z.ZodEnum<["fixture", "live"]>>;
+    GOOGLE_OAUTH_CLIENT_ID: z.ZodString;
+    GOOGLE_OAUTH_CLIENT_SECRET: z.ZodString;
+    GOOGLE_OAUTH_REFRESH_TOKEN: z.ZodString;
+    GOOGLE_ADS_DEVELOPER_TOKEN: z.ZodString;
+    /** Must match {@link COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID} in live mode. */
+    GOOGLE_ADS_CUSTOMER_ID: z.ZodLiteral<"5338378654">;
+    /** Must match {@link COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID} (Community Movie MCC). */
+    GOOGLE_ADS_LOGIN_CUSTOMER_ID: z.ZodLiteral<"6483231390">;
+}, "strict", z.ZodTypeAny, {
+    GOOGLE_OAUTH_CLIENT_ID: string;
+    GOOGLE_OAUTH_CLIENT_SECRET: string;
+    GOOGLE_OAUTH_REFRESH_TOKEN: string;
+    GOOGLE_ADS_DEVELOPER_TOKEN: string;
+    GOOGLE_ADS_CUSTOMER_ID: "5338378654";
+    GOOGLE_ADS_LOGIN_CUSTOMER_ID: "6483231390";
+    GOOGLE_API_MODE?: "live" | "fixture" | undefined;
+}, {
+    GOOGLE_OAUTH_CLIENT_ID: string;
+    GOOGLE_OAUTH_CLIENT_SECRET: string;
+    GOOGLE_OAUTH_REFRESH_TOKEN: string;
+    GOOGLE_ADS_DEVELOPER_TOKEN: string;
+    GOOGLE_ADS_CUSTOMER_ID: "5338378654";
+    GOOGLE_ADS_LOGIN_CUSTOMER_ID: "6483231390";
+    GOOGLE_API_MODE?: "live" | "fixture" | undefined;
+}>;
+export type MarketingGoogleEnvKeys = z.infer<typeof MarketingGoogleEnvKeysSchema>;
+export declare const MARKETING_GOOGLE_ENV_KEY_NAMES: readonly ["GOOGLE_API_MODE", "GOOGLE_OAUTH_CLIENT_ID", "GOOGLE_OAUTH_CLIENT_SECRET", "GOOGLE_OAUTH_REFRESH_TOKEN", "GOOGLE_ADS_DEVELOPER_TOKEN", "GOOGLE_ADS_CUSTOMER_ID", "GOOGLE_ADS_LOGIN_CUSTOMER_ID", "GA4_PROPERTY_ID", "GSC_SITE_URL", "GOOGLE_ADS_DEFAULT_CONVERSION_ACTION_RESOURCE"];
+export type MarketingGoogleEnvKeyName = (typeof MARKETING_GOOGLE_ENV_KEY_NAMES)[number];

package/dist/marketing/config.schema.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MARKETING_GOOGLE_ENV_KEY_NAMES = exports.MarketingGoogleEnvKeysSchema = void 0;
+const zod_1 = require("zod");
+const community_movie_google_ads_constants_1 = require("./community-movie-google-ads.constants");
+/** Documents required Doppler env keys — values loaded server-side only. */
+exports.MarketingGoogleEnvKeysSchema = zod_1.z
+    .object({
+    GOOGLE_API_MODE: zod_1.z.enum(['fixture', 'live']).optional(),
+    GOOGLE_OAUTH_CLIENT_ID: zod_1.z.string().min(1),
+    GOOGLE_OAUTH_CLIENT_SECRET: zod_1.z.string().min(1),
+    GOOGLE_OAUTH_REFRESH_TOKEN: zod_1.z.string().min(1),
+    GOOGLE_ADS_DEVELOPER_TOKEN: zod_1.z.string().min(1),
+    /** Must match {@link COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID} in live mode. */
+    GOOGLE_ADS_CUSTOMER_ID: zod_1.z.literal(community_movie_google_ads_constants_1.COMMUNITY_MOVIE_GOOGLE_ADS_CUSTOMER_ID),
+    /** Must match {@link COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID} (Community Movie MCC). */
+    GOOGLE_ADS_LOGIN_CUSTOMER_ID: zod_1.z.literal(community_movie_google_ads_constants_1.COMMUNITY_MOVIE_GOOGLE_ADS_LOGIN_CUSTOMER_ID),
+})
+    .strict();
+exports.MARKETING_GOOGLE_ENV_KEY_NAMES = [
+    'GOOGLE_API_MODE',
+    'GOOGLE_OAUTH_CLIENT_ID',
+    'GOOGLE_OAUTH_CLIENT_SECRET',
+    'GOOGLE_OAUTH_REFRESH_TOKEN',
+    'GOOGLE_ADS_DEVELOPER_TOKEN',
+    'GOOGLE_ADS_CUSTOMER_ID',
+    'GOOGLE_ADS_LOGIN_CUSTOMER_ID',
+    'GA4_PROPERTY_ID',
+    'GSC_SITE_URL',
+    'GOOGLE_ADS_DEFAULT_CONVERSION_ACTION_RESOURCE',
+];

package/dist/marketing/date-range.schema.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const MarketingDateRangeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    from: string;
+    to: string;
+}, {
+    from: string;
+    to: string;
+}>;
+export type MarketingDateRange = z.infer<typeof MarketingDateRangeSchema>;

package/dist/marketing/date-range.schema.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketingDateRangeSchema = void 0;
+const zod_1 = require("zod");
+exports.MarketingDateRangeSchema = zod_1.z
+    .object({
+    from: zod_1.z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    to: zod_1.z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+})
+    .strict();

package/dist/marketing/entities/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Marketing intelligence entity schemas — expand per phase.
+ * @see .cursor/plans/community-movie/marketing-intelligence/02-schema-proposal.md
+ */
+export { CommunityAttributionProfileSchema, type CommunityAttributionProfile, } from '../../analytics/community-movie/attribution.schema';
+export { AcquisitionRecommendationSchema, type AcquisitionRecommendation, } from '../acquisition-recommendation.schema';

package/dist/marketing/entities/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Marketing intelligence entity schemas — expand per phase.
+ * @see .cursor/plans/community-movie/marketing-intelligence/02-schema-proposal.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcquisitionRecommendationSchema = exports.CommunityAttributionProfileSchema = void 0;
+var attribution_schema_1 = require("../../analytics/community-movie/attribution.schema");
+Object.defineProperty(exports, "CommunityAttributionProfileSchema", { enumerable: true, get: function () { return attribution_schema_1.CommunityAttributionProfileSchema; } });
+var acquisition_recommendation_schema_1 = require("../acquisition-recommendation.schema");
+Object.defineProperty(exports, "AcquisitionRecommendationSchema", { enumerable: true, get: function () { return acquisition_recommendation_schema_1.AcquisitionRecommendationSchema; } });

package/dist/marketing/ga4-conversion.schema.d.ts

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+export declare const MarketingGa4ConversionMetricSchema: z.ZodObject<{
+    source: z.ZodLiteral<"ga4">;
+    propertyId: z.ZodString;
+    eventName: z.ZodString;
+    conversions: z.ZodNumber;
+    totalUsers: z.ZodNumber;
+    conversionRate: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    source: "ga4";
+    conversions: number;
+    propertyId: string;
+    totalUsers: number;
+    eventName: string;
+    conversionRate?: number | undefined;
+}, {
+    source: "ga4";
+    conversions: number;
+    propertyId: string;
+    totalUsers: number;
+    eventName: string;
+    conversionRate?: number | undefined;
+}>;
+export declare const MarketingGa4ConversionReportSchema: z.ZodObject<{
+    propertyId: z.ZodString;
+    dateRange: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>;
+    rows: z.ZodArray<z.ZodObject<{
+        source: z.ZodLiteral<"ga4">;
+        propertyId: z.ZodString;
+        eventName: z.ZodString;
+        conversions: z.ZodNumber;
+        totalUsers: z.ZodNumber;
+        conversionRate: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        source: "ga4";
+        conversions: number;
+        propertyId: string;
+        totalUsers: number;
+        eventName: string;
+        conversionRate?: number | undefined;
+    }, {
+        source: "ga4";
+        conversions: number;
+        propertyId: string;
+        totalUsers: number;
+        eventName: string;
+        conversionRate?: number | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    rows: {
+        source: "ga4";
+        conversions: number;
+        propertyId: string;
+        totalUsers: number;
+        eventName: string;
+        conversionRate?: number | undefined;
+    }[];
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    propertyId: string;
+}, {
+    rows: {
+        source: "ga4";
+        conversions: number;
+        propertyId: string;
+        totalUsers: number;
+        eventName: string;
+        conversionRate?: number | undefined;
+    }[];
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    propertyId: string;
+}>;
+export type MarketingGa4ConversionReport = z.infer<typeof MarketingGa4ConversionReportSchema>;

package/dist/marketing/ga4-conversion.schema.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketingGa4ConversionReportSchema = exports.MarketingGa4ConversionMetricSchema = void 0;
+const zod_1 = require("zod");
+const date_range_schema_1 = require("./date-range.schema");
+exports.MarketingGa4ConversionMetricSchema = zod_1.z
+    .object({
+    source: zod_1.z.literal('ga4'),
+    propertyId: zod_1.z.string().min(1).max(32),
+    eventName: zod_1.z.string().min(1).max(128),
+    conversions: zod_1.z.number().nonnegative(),
+    totalUsers: zod_1.z.number().int().nonnegative(),
+    conversionRate: zod_1.z.number().min(0).max(1).optional(),
+})
+    .strict();
+exports.MarketingGa4ConversionReportSchema = zod_1.z
+    .object({
+    propertyId: zod_1.z.string().min(1).max(32),
+    dateRange: date_range_schema_1.MarketingDateRangeSchema,
+    rows: zod_1.z.array(exports.MarketingGa4ConversionMetricSchema),
+})
+    .strict();

package/dist/marketing/ga4-event.schema.d.ts

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+export declare const MarketingGa4EventCountSchema: z.ZodObject<{
+    source: z.ZodLiteral<"ga4">;
+    propertyId: z.ZodString;
+    eventName: z.ZodEnum<["page_view", "homepage_view", "consent_updated", "sign_up", "signup_started", "signup_completed", "engaged_free_user", "login", "view_challenge", "view_world", "world_page_view", "world_cta_click", "view_idea", "view_actor", "trailer_play", "trailer_complete_25", "trailer_complete_50", "trailer_complete_75", "trailer_complete_100", "idea_form_started", "pricing_viewed", "upgrade_clicked", "begin_checkout", "checkout_started", "checkout_abandoned", "subscription_started", "contribution_submitted", "idea_submitted", "submit_idea", "challenge_completed", "create_character", "vote_cast", "onboarding_complete", "waitlist_joined", "create_project", "join_challenge", "referral_link_visit", "referral_attribution_set", "referral_signup_converted", "referral_reward_issued", "partner_signup_redeemed", "email_dispatch_queued", "email_dispatch_sent", "email_dispatch_failed", "email_unsubscribed", "ad_capi_dispatched", "ad_capi_failed", "watch_page_view", "film_play", "film_progress_25", "film_progress_50", "film_progress_75", "film_complete", "film_error", "watchlist_add", "watchlist_remove", "content_reaction_set", "content_rating_set", "feedback_submitted", "future_movie_view", "character_view", "pwa_install_prompt_shown", "pwa_install_prompt_accepted", "pwa_install_prompt_dismissed", "pwa_launch", "founding_viewer_offer_viewed", "founding_viewer_checkout_started", "creator_upgrade_clicked"]>;
+    eventCount: z.ZodNumber;
+    totalUsers: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    source: "ga4";
+    propertyId: string;
+    totalUsers: number;
+    eventName: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+    eventCount: number;
+}, {
+    source: "ga4";
+    propertyId: string;
+    totalUsers: number;
+    eventName: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+    eventCount: number;
+}>;
+export declare const MarketingGa4EventCountListSchema: z.ZodArray<z.ZodObject<{
+    source: z.ZodLiteral<"ga4">;
+    propertyId: z.ZodString;
+    eventName: z.ZodEnum<["page_view", "homepage_view", "consent_updated", "sign_up", "signup_started", "signup_completed", "engaged_free_user", "login", "view_challenge", "view_world", "world_page_view", "world_cta_click", "view_idea", "view_actor", "trailer_play", "trailer_complete_25", "trailer_complete_50", "trailer_complete_75", "trailer_complete_100", "idea_form_started", "pricing_viewed", "upgrade_clicked", "begin_checkout", "checkout_started", "checkout_abandoned", "subscription_started", "contribution_submitted", "idea_submitted", "submit_idea", "challenge_completed", "create_character", "vote_cast", "onboarding_complete", "waitlist_joined", "create_project", "join_challenge", "referral_link_visit", "referral_attribution_set", "referral_signup_converted", "referral_reward_issued", "partner_signup_redeemed", "email_dispatch_queued", "email_dispatch_sent", "email_dispatch_failed", "email_unsubscribed", "ad_capi_dispatched", "ad_capi_failed", "watch_page_view", "film_play", "film_progress_25", "film_progress_50", "film_progress_75", "film_complete", "film_error", "watchlist_add", "watchlist_remove", "content_reaction_set", "content_rating_set", "feedback_submitted", "future_movie_view", "character_view", "pwa_install_prompt_shown", "pwa_install_prompt_accepted", "pwa_install_prompt_dismissed", "pwa_launch", "founding_viewer_offer_viewed", "founding_viewer_checkout_started", "creator_upgrade_clicked"]>;
+    eventCount: z.ZodNumber;
+    totalUsers: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    source: "ga4";
+    propertyId: string;
+    totalUsers: number;
+    eventName: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+    eventCount: number;
+}, {
+    source: "ga4";
+    propertyId: string;
+    totalUsers: number;
+    eventName: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+    eventCount: number;
+}>, "many">;
+export declare const MarketingGa4EventReportSchema: z.ZodObject<{
+    propertyId: z.ZodString;
+    dateRange: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>;
+    rows: z.ZodArray<z.ZodObject<{
+        source: z.ZodLiteral<"ga4">;
+        propertyId: z.ZodString;
+        eventName: z.ZodEnum<["page_view", "homepage_view", "consent_updated", "sign_up", "signup_started", "signup_completed", "engaged_free_user", "login", "view_challenge", "view_world", "world_page_view", "world_cta_click", "view_idea", "view_actor", "trailer_play", "trailer_complete_25", "trailer_complete_50", "trailer_complete_75", "trailer_complete_100", "idea_form_started", "pricing_viewed", "upgrade_clicked", "begin_checkout", "checkout_started", "checkout_abandoned", "subscription_started", "contribution_submitted", "idea_submitted", "submit_idea", "challenge_completed", "create_character", "vote_cast", "onboarding_complete", "waitlist_joined", "create_project", "join_challenge", "referral_link_visit", "referral_attribution_set", "referral_signup_converted", "referral_reward_issued", "partner_signup_redeemed", "email_dispatch_queued", "email_dispatch_sent", "email_dispatch_failed", "email_unsubscribed", "ad_capi_dispatched", "ad_capi_failed", "watch_page_view", "film_play", "film_progress_25", "film_progress_50", "film_progress_75", "film_complete", "film_error", "watchlist_add", "watchlist_remove", "content_reaction_set", "content_rating_set", "feedback_submitted", "future_movie_view", "character_view", "pwa_install_prompt_shown", "pwa_install_prompt_accepted", "pwa_install_prompt_dismissed", "pwa_launch", "founding_viewer_offer_viewed", "founding_viewer_checkout_started", "creator_upgrade_clicked"]>;
+        eventCount: z.ZodNumber;
+        totalUsers: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        source: "ga4";
+        propertyId: string;
+        totalUsers: number;
+        eventName: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+        eventCount: number;
+    }, {
+        source: "ga4";
+        propertyId: string;
+        totalUsers: number;
+        eventName: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+        eventCount: number;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    rows: {
+        source: "ga4";
+        propertyId: string;
+        totalUsers: number;
+        eventName: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+        eventCount: number;
+    }[];
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    propertyId: string;
+}, {
+    rows: {
+        source: "ga4";
+        propertyId: string;
+        totalUsers: number;
+        eventName: "login" | "signup_completed" | "checkout_started" | "idea_submitted" | "page_view" | "homepage_view" | "consent_updated" | "sign_up" | "signup_started" | "engaged_free_user" | "view_challenge" | "view_world" | "world_page_view" | "world_cta_click" | "view_idea" | "view_actor" | "trailer_play" | "trailer_complete_25" | "trailer_complete_50" | "trailer_complete_75" | "trailer_complete_100" | "idea_form_started" | "pricing_viewed" | "upgrade_clicked" | "begin_checkout" | "checkout_abandoned" | "subscription_started" | "contribution_submitted" | "submit_idea" | "challenge_completed" | "create_character" | "vote_cast" | "onboarding_complete" | "waitlist_joined" | "create_project" | "join_challenge" | "referral_link_visit" | "referral_attribution_set" | "referral_signup_converted" | "referral_reward_issued" | "partner_signup_redeemed" | "email_dispatch_queued" | "email_dispatch_sent" | "email_dispatch_failed" | "email_unsubscribed" | "ad_capi_dispatched" | "ad_capi_failed" | "watch_page_view" | "film_play" | "film_progress_25" | "film_progress_50" | "film_progress_75" | "film_complete" | "film_error" | "watchlist_add" | "watchlist_remove" | "content_reaction_set" | "content_rating_set" | "feedback_submitted" | "future_movie_view" | "character_view" | "pwa_install_prompt_shown" | "pwa_install_prompt_accepted" | "pwa_install_prompt_dismissed" | "pwa_launch" | "founding_viewer_offer_viewed" | "founding_viewer_checkout_started" | "creator_upgrade_clicked";
+        eventCount: number;
+    }[];
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    propertyId: string;
+}>;
+export type MarketingGa4EventReport = z.infer<typeof MarketingGa4EventReportSchema>;

package/dist/marketing/ga4-event.schema.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketingGa4EventReportSchema = exports.MarketingGa4EventCountListSchema = exports.MarketingGa4EventCountSchema = void 0;
+const zod_1 = require("zod");
+const event_names_1 = require("../analytics/community-movie/event-names");
+const date_range_schema_1 = require("./date-range.schema");
+exports.MarketingGa4EventCountSchema = zod_1.z
+    .object({
+    source: zod_1.z.literal('ga4'),
+    propertyId: zod_1.z.string().min(1).max(32),
+    eventName: zod_1.z.enum(event_names_1.COMMUNITY_MOVIE_ANALYTICS_EVENT_NAMES),
+    eventCount: zod_1.z.number().int().nonnegative(),
+    totalUsers: zod_1.z.number().int().nonnegative(),
+})
+    .strict();
+exports.MarketingGa4EventCountListSchema = zod_1.z.array(exports.MarketingGa4EventCountSchema);
+exports.MarketingGa4EventReportSchema = zod_1.z
+    .object({
+    propertyId: zod_1.z.string().min(1).max(32),
+    dateRange: date_range_schema_1.MarketingDateRangeSchema,
+    rows: exports.MarketingGa4EventCountListSchema,
+})
+    .strict();

package/dist/marketing/ga4-funnel.schema.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+export declare const MarketingGa4FunnelStepSchema: z.ZodObject<{
+    stepIndex: z.ZodNumber;
+    stepName: z.ZodString;
+    eventName: z.ZodString;
+    activeUsers: z.ZodNumber;
+    completionRate: z.ZodOptional<z.ZodNumber>;
+    abandonments: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    stepIndex: number;
+    eventName: string;
+    stepName: string;
+    activeUsers: number;
+    completionRate?: number | undefined;
+    abandonments?: number | undefined;
+}, {
+    stepIndex: number;
+    eventName: string;
+    stepName: string;
+    activeUsers: number;
+    completionRate?: number | undefined;
+    abandonments?: number | undefined;
+}>;
+export declare const MarketingGa4FunnelReportSchema: z.ZodObject<{
+    source: z.ZodLiteral<"ga4">;
+    propertyId: z.ZodString;
+    dateRange: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>;
+    steps: z.ZodArray<z.ZodObject<{
+        stepIndex: z.ZodNumber;
+        stepName: z.ZodString;
+        eventName: z.ZodString;
+        activeUsers: z.ZodNumber;
+        completionRate: z.ZodOptional<z.ZodNumber>;
+        abandonments: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        stepIndex: number;
+        eventName: string;
+        stepName: string;
+        activeUsers: number;
+        completionRate?: number | undefined;
+        abandonments?: number | undefined;
+    }, {
+        stepIndex: number;
+        eventName: string;
+        stepName: string;
+        activeUsers: number;
+        completionRate?: number | undefined;
+        abandonments?: number | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    source: "ga4";
+    steps: {
+        stepIndex: number;
+        eventName: string;
+        stepName: string;
+        activeUsers: number;
+        completionRate?: number | undefined;
+        abandonments?: number | undefined;
+    }[];
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    propertyId: string;
+}, {
+    source: "ga4";
+    steps: {
+        stepIndex: number;
+        eventName: string;
+        stepName: string;
+        activeUsers: number;
+        completionRate?: number | undefined;
+        abandonments?: number | undefined;
+    }[];
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    propertyId: string;
+}>;
+export type MarketingGa4FunnelReport = z.infer<typeof MarketingGa4FunnelReportSchema>;

package/dist/marketing/ga4-funnel.schema.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketingGa4FunnelReportSchema = exports.MarketingGa4FunnelStepSchema = void 0;
+const zod_1 = require("zod");
+const date_range_schema_1 = require("./date-range.schema");
+exports.MarketingGa4FunnelStepSchema = zod_1.z
+    .object({
+    stepIndex: zod_1.z.number().int().nonnegative(),
+    stepName: zod_1.z.string().min(1).max(128),
+    eventName: zod_1.z.string().min(1).max(128),
+    activeUsers: zod_1.z.number().int().nonnegative(),
+    completionRate: zod_1.z.number().min(0).max(1).optional(),
+    abandonments: zod_1.z.number().int().nonnegative().optional(),
+})
+    .strict();
+exports.MarketingGa4FunnelReportSchema = zod_1.z
+    .object({
+    source: zod_1.z.literal('ga4'),
+    propertyId: zod_1.z.string().min(1).max(32),
+    dateRange: date_range_schema_1.MarketingDateRangeSchema,
+    steps: zod_1.z.array(exports.MarketingGa4FunnelStepSchema),
+})
+    .strict();