@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/marketing/marketing-readiness.schema.d.ts

@@ -0,0 +1,506 @@
+import { z } from 'zod';
+/** Operational status for acquisition spine checks (operator dashboard). */
+export declare const MarketingReadinessStatusSchema: z.ZodEnum<["healthy", "degraded", "warning", "incomplete", "blocked"]>;
+export type MarketingReadinessStatus = z.infer<typeof MarketingReadinessStatusSchema>;
+export declare const MarketingReadinessCategorySchema: z.ZodEnum<["account", "billing", "oauth", "api", "ga4", "gsc", "attribution", "conversion", "runtime", "landing", "campaign", "mobile", "assets"]>;
+export type MarketingReadinessCategory = z.infer<typeof MarketingReadinessCategorySchema>;
+export declare const MarketingReadinessCheckSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    category: z.ZodEnum<["account", "billing", "oauth", "api", "ga4", "gsc", "attribution", "conversion", "runtime", "landing", "campaign", "mobile", "assets"]>;
+    status: z.ZodEnum<["healthy", "degraded", "warning", "incomplete", "blocked"]>;
+    summary: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+    /** Human-owned blocker (e.g. billing, Ads UI). */
+    ownerHint: z.ZodOptional<z.ZodEnum<["marketing_ops", "engineering", "legal", "finance"]>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    status: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+    summary: string;
+    label: string;
+    category: "api" | "assets" | "runtime" | "mobile" | "campaign" | "oauth" | "conversion" | "attribution" | "ga4" | "gsc" | "account" | "billing" | "landing";
+    detail?: string | undefined;
+    ownerHint?: "marketing_ops" | "engineering" | "legal" | "finance" | undefined;
+}, {
+    id: string;
+    status: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+    summary: string;
+    label: string;
+    category: "api" | "assets" | "runtime" | "mobile" | "campaign" | "oauth" | "conversion" | "attribution" | "ga4" | "gsc" | "account" | "billing" | "landing";
+    detail?: string | undefined;
+    ownerHint?: "marketing_ops" | "engineering" | "legal" | "finance" | undefined;
+}>;
+export type MarketingReadinessCheck = z.infer<typeof MarketingReadinessCheckSchema>;
+export declare const MarketingLandingProbeSchema: z.ZodObject<{
+    path: z.ZodString;
+    campaignTheme: z.ZodOptional<z.ZodString>;
+    httpStatus: z.ZodNullable<z.ZodNumber>;
+    ok: z.ZodBoolean;
+    latencyMs: z.ZodNullable<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    ok: boolean;
+    httpStatus: number | null;
+    latencyMs: number | null;
+    campaignTheme?: string | undefined;
+}, {
+    path: string;
+    ok: boolean;
+    httpStatus: number | null;
+    latencyMs: number | null;
+    campaignTheme?: string | undefined;
+}>;
+export type MarketingLandingProbe = z.infer<typeof MarketingLandingProbeSchema>;
+export declare const MarketingReadinessResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        generatedAt: z.ZodString;
+        overallStatus: z.ZodEnum<["healthy", "degraded", "warning", "incomplete", "blocked"]>;
+        apiMode: z.ZodEnum<["fixture", "live"]>;
+        integrations: z.ZodObject<{
+            ads: z.ZodObject<{
+                status: z.ZodEnum<["fixture", "live", "config_error", "unavailable"]>;
+                credentialsPresent: z.ZodBoolean;
+            }, "strict", z.ZodTypeAny, {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            }, {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            }>;
+            ga4: z.ZodObject<{
+                status: z.ZodEnum<["fixture", "live", "config_error", "unavailable"]>;
+                credentialsPresent: z.ZodBoolean;
+            }, "strict", z.ZodTypeAny, {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            }, {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            }>;
+            gsc: z.ZodObject<{
+                status: z.ZodEnum<["fixture", "live", "config_error", "unavailable"]>;
+                credentialsPresent: z.ZodBoolean;
+            }, "strict", z.ZodTypeAny, {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            }, {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            }>;
+            conversionUpload: z.ZodObject<{
+                status: z.ZodEnum<["fixture", "live", "config_error", "unavailable"]>;
+                credentialsPresent: z.ZodBoolean;
+            }, "strict", z.ZodTypeAny, {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            }, {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            ga4: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            gsc: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            ads: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            conversionUpload: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+        }, {
+            ga4: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            gsc: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            ads: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            conversionUpload: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+        }>;
+        googleAdsCanonical: z.ZodObject<{
+            mccAccountName: z.ZodString;
+            mccCustomerId: z.ZodString;
+            mccCustomerIdFormatted: z.ZodString;
+            advertiserAccountName: z.ZodString;
+            advertiserCustomerId: z.ZodString;
+            advertiserCustomerIdFormatted: z.ZodString;
+            conversionTagId: z.ZodString;
+            envCustomerIdCanonical: z.ZodBoolean;
+            envLoginCustomerIdCanonical: z.ZodBoolean;
+        }, "strict", z.ZodTypeAny, {
+            mccAccountName: string;
+            mccCustomerId: string;
+            mccCustomerIdFormatted: string;
+            advertiserAccountName: string;
+            advertiserCustomerId: string;
+            advertiserCustomerIdFormatted: string;
+            conversionTagId: string;
+            envCustomerIdCanonical: boolean;
+            envLoginCustomerIdCanonical: boolean;
+        }, {
+            mccAccountName: string;
+            mccCustomerId: string;
+            mccCustomerIdFormatted: string;
+            advertiserAccountName: string;
+            advertiserCustomerId: string;
+            advertiserCustomerIdFormatted: string;
+            conversionTagId: string;
+            envCustomerIdCanonical: boolean;
+            envLoginCustomerIdCanonical: boolean;
+        }>;
+        checks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            category: z.ZodEnum<["account", "billing", "oauth", "api", "ga4", "gsc", "attribution", "conversion", "runtime", "landing", "campaign", "mobile", "assets"]>;
+            status: z.ZodEnum<["healthy", "degraded", "warning", "incomplete", "blocked"]>;
+            summary: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            /** Human-owned blocker (e.g. billing, Ads UI). */
+            ownerHint: z.ZodOptional<z.ZodEnum<["marketing_ops", "engineering", "legal", "finance"]>>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            status: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+            summary: string;
+            label: string;
+            category: "api" | "assets" | "runtime" | "mobile" | "campaign" | "oauth" | "conversion" | "attribution" | "ga4" | "gsc" | "account" | "billing" | "landing";
+            detail?: string | undefined;
+            ownerHint?: "marketing_ops" | "engineering" | "legal" | "finance" | undefined;
+        }, {
+            id: string;
+            status: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+            summary: string;
+            label: string;
+            category: "api" | "assets" | "runtime" | "mobile" | "campaign" | "oauth" | "conversion" | "attribution" | "ga4" | "gsc" | "account" | "billing" | "landing";
+            detail?: string | undefined;
+            ownerHint?: "marketing_ops" | "engineering" | "legal" | "finance" | undefined;
+        }>, "many">;
+        landingProbes: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            campaignTheme: z.ZodOptional<z.ZodString>;
+            httpStatus: z.ZodNullable<z.ZodNumber>;
+            ok: z.ZodBoolean;
+            latencyMs: z.ZodNullable<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            ok: boolean;
+            httpStatus: number | null;
+            latencyMs: number | null;
+            campaignTheme?: string | undefined;
+        }, {
+            path: string;
+            ok: boolean;
+            httpStatus: number | null;
+            latencyMs: number | null;
+            campaignTheme?: string | undefined;
+        }>, "many">;
+        warehouse: z.ZodObject<{
+            visitorCount: z.ZodNumber;
+            sessionCount: z.ZodNumber;
+            linkedUserCount: z.ZodNumber;
+            conversionQueuePending: z.ZodNumber;
+            conversionQueueFailed: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            conversionQueuePending: number;
+            conversionQueueFailed: number;
+        }, {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            conversionQueuePending: number;
+            conversionQueueFailed: number;
+        }>;
+        communityMovieOrigin: z.ZodString;
+        publicTagConfigured: z.ZodBoolean;
+        searchCampaignScript: z.ZodObject<{
+            name: z.ZodString;
+            adGroupCount: z.ZodNumber;
+            negativeKeywordCount: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            adGroupCount: number;
+            negativeKeywordCount: number;
+        }, {
+            name: string;
+            adGroupCount: number;
+            negativeKeywordCount: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        integrations: {
+            ga4: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            gsc: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            ads: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            conversionUpload: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+        };
+        generatedAt: string;
+        apiMode: "live" | "fixture";
+        checks: {
+            id: string;
+            status: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+            summary: string;
+            label: string;
+            category: "api" | "assets" | "runtime" | "mobile" | "campaign" | "oauth" | "conversion" | "attribution" | "ga4" | "gsc" | "account" | "billing" | "landing";
+            detail?: string | undefined;
+            ownerHint?: "marketing_ops" | "engineering" | "legal" | "finance" | undefined;
+        }[];
+        overallStatus: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+        googleAdsCanonical: {
+            mccAccountName: string;
+            mccCustomerId: string;
+            mccCustomerIdFormatted: string;
+            advertiserAccountName: string;
+            advertiserCustomerId: string;
+            advertiserCustomerIdFormatted: string;
+            conversionTagId: string;
+            envCustomerIdCanonical: boolean;
+            envLoginCustomerIdCanonical: boolean;
+        };
+        warehouse: {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            conversionQueuePending: number;
+            conversionQueueFailed: number;
+        };
+        landingProbes: {
+            path: string;
+            ok: boolean;
+            httpStatus: number | null;
+            latencyMs: number | null;
+            campaignTheme?: string | undefined;
+        }[];
+        communityMovieOrigin: string;
+        publicTagConfigured: boolean;
+        searchCampaignScript: {
+            name: string;
+            adGroupCount: number;
+            negativeKeywordCount: number;
+        };
+    }, {
+        integrations: {
+            ga4: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            gsc: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            ads: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            conversionUpload: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+        };
+        generatedAt: string;
+        apiMode: "live" | "fixture";
+        checks: {
+            id: string;
+            status: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+            summary: string;
+            label: string;
+            category: "api" | "assets" | "runtime" | "mobile" | "campaign" | "oauth" | "conversion" | "attribution" | "ga4" | "gsc" | "account" | "billing" | "landing";
+            detail?: string | undefined;
+            ownerHint?: "marketing_ops" | "engineering" | "legal" | "finance" | undefined;
+        }[];
+        overallStatus: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+        googleAdsCanonical: {
+            mccAccountName: string;
+            mccCustomerId: string;
+            mccCustomerIdFormatted: string;
+            advertiserAccountName: string;
+            advertiserCustomerId: string;
+            advertiserCustomerIdFormatted: string;
+            conversionTagId: string;
+            envCustomerIdCanonical: boolean;
+            envLoginCustomerIdCanonical: boolean;
+        };
+        warehouse: {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            conversionQueuePending: number;
+            conversionQueueFailed: number;
+        };
+        landingProbes: {
+            path: string;
+            ok: boolean;
+            httpStatus: number | null;
+            latencyMs: number | null;
+            campaignTheme?: string | undefined;
+        }[];
+        communityMovieOrigin: string;
+        publicTagConfigured: boolean;
+        searchCampaignScript: {
+            name: string;
+            adGroupCount: number;
+            negativeKeywordCount: number;
+        };
+    }>;
+}, "strict", z.ZodTypeAny, {
+    success: true;
+    data: {
+        integrations: {
+            ga4: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            gsc: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            ads: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            conversionUpload: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+        };
+        generatedAt: string;
+        apiMode: "live" | "fixture";
+        checks: {
+            id: string;
+            status: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+            summary: string;
+            label: string;
+            category: "api" | "assets" | "runtime" | "mobile" | "campaign" | "oauth" | "conversion" | "attribution" | "ga4" | "gsc" | "account" | "billing" | "landing";
+            detail?: string | undefined;
+            ownerHint?: "marketing_ops" | "engineering" | "legal" | "finance" | undefined;
+        }[];
+        overallStatus: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+        googleAdsCanonical: {
+            mccAccountName: string;
+            mccCustomerId: string;
+            mccCustomerIdFormatted: string;
+            advertiserAccountName: string;
+            advertiserCustomerId: string;
+            advertiserCustomerIdFormatted: string;
+            conversionTagId: string;
+            envCustomerIdCanonical: boolean;
+            envLoginCustomerIdCanonical: boolean;
+        };
+        warehouse: {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            conversionQueuePending: number;
+            conversionQueueFailed: number;
+        };
+        landingProbes: {
+            path: string;
+            ok: boolean;
+            httpStatus: number | null;
+            latencyMs: number | null;
+            campaignTheme?: string | undefined;
+        }[];
+        communityMovieOrigin: string;
+        publicTagConfigured: boolean;
+        searchCampaignScript: {
+            name: string;
+            adGroupCount: number;
+            negativeKeywordCount: number;
+        };
+    };
+}, {
+    success: true;
+    data: {
+        integrations: {
+            ga4: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            gsc: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            ads: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+            conversionUpload: {
+                status: "unavailable" | "live" | "fixture" | "config_error";
+                credentialsPresent: boolean;
+            };
+        };
+        generatedAt: string;
+        apiMode: "live" | "fixture";
+        checks: {
+            id: string;
+            status: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+            summary: string;
+            label: string;
+            category: "api" | "assets" | "runtime" | "mobile" | "campaign" | "oauth" | "conversion" | "attribution" | "ga4" | "gsc" | "account" | "billing" | "landing";
+            detail?: string | undefined;
+            ownerHint?: "marketing_ops" | "engineering" | "legal" | "finance" | undefined;
+        }[];
+        overallStatus: "warning" | "incomplete" | "blocked" | "degraded" | "healthy";
+        googleAdsCanonical: {
+            mccAccountName: string;
+            mccCustomerId: string;
+            mccCustomerIdFormatted: string;
+            advertiserAccountName: string;
+            advertiserCustomerId: string;
+            advertiserCustomerIdFormatted: string;
+            conversionTagId: string;
+            envCustomerIdCanonical: boolean;
+            envLoginCustomerIdCanonical: boolean;
+        };
+        warehouse: {
+            visitorCount: number;
+            sessionCount: number;
+            linkedUserCount: number;
+            conversionQueuePending: number;
+            conversionQueueFailed: number;
+        };
+        landingProbes: {
+            path: string;
+            ok: boolean;
+            httpStatus: number | null;
+            latencyMs: number | null;
+            campaignTheme?: string | undefined;
+        }[];
+        communityMovieOrigin: string;
+        publicTagConfigured: boolean;
+        searchCampaignScript: {
+            name: string;
+            adGroupCount: number;
+            negativeKeywordCount: number;
+        };
+    };
+}>;
+export type MarketingReadinessResponse = z.infer<typeof MarketingReadinessResponseSchema>;

package/dist/marketing/marketing-readiness.schema.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketingReadinessResponseSchema = exports.MarketingLandingProbeSchema = exports.MarketingReadinessCheckSchema = exports.MarketingReadinessCategorySchema = exports.MarketingReadinessStatusSchema = void 0;
+const zod_1 = require("zod");
+const marketing_health_schema_1 = require("./marketing-health.schema");
+/** Operational status for acquisition spine checks (operator dashboard). */
+exports.MarketingReadinessStatusSchema = zod_1.z.enum([
+    'healthy',
+    'degraded',
+    'warning',
+    'incomplete',
+    'blocked',
+]);
+exports.MarketingReadinessCategorySchema = zod_1.z.enum([
+    'account',
+    'billing',
+    'oauth',
+    'api',
+    'ga4',
+    'gsc',
+    'attribution',
+    'conversion',
+    'runtime',
+    'landing',
+    'campaign',
+    'mobile',
+    'assets',
+]);
+exports.MarketingReadinessCheckSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().min(1).max(64),
+    label: zod_1.z.string().min(1).max(128),
+    category: exports.MarketingReadinessCategorySchema,
+    status: exports.MarketingReadinessStatusSchema,
+    summary: zod_1.z.string().max(512),
+    detail: zod_1.z.string().max(1024).optional(),
+    /** Human-owned blocker (e.g. billing, Ads UI). */
+    ownerHint: zod_1.z.enum(['marketing_ops', 'engineering', 'legal', 'finance']).optional(),
+})
+    .strict();
+exports.MarketingLandingProbeSchema = zod_1.z
+    .object({
+    path: zod_1.z.string().min(1).max(256),
+    campaignTheme: zod_1.z.string().max(64).optional(),
+    httpStatus: zod_1.z.number().int().nullable(),
+    ok: zod_1.z.boolean(),
+    latencyMs: zod_1.z.number().int().nonnegative().nullable(),
+})
+    .strict();
+exports.MarketingReadinessResponseSchema = zod_1.z
+    .object({
+    success: zod_1.z.literal(true),
+    data: zod_1.z
+        .object({
+        generatedAt: zod_1.z.string().datetime(),
+        overallStatus: exports.MarketingReadinessStatusSchema,
+        apiMode: zod_1.z.enum(['fixture', 'live']),
+        integrations: marketing_health_schema_1.MarketingIntegrationHealthSchema,
+        googleAdsCanonical: marketing_health_schema_1.MarketingGoogleAdsCanonicalAccountSchema,
+        checks: zod_1.z.array(exports.MarketingReadinessCheckSchema),
+        landingProbes: zod_1.z.array(exports.MarketingLandingProbeSchema),
+        warehouse: zod_1.z
+            .object({
+            visitorCount: zod_1.z.number().int().nonnegative(),
+            sessionCount: zod_1.z.number().int().nonnegative(),
+            linkedUserCount: zod_1.z.number().int().nonnegative(),
+            conversionQueuePending: zod_1.z.number().int().nonnegative(),
+            conversionQueueFailed: zod_1.z.number().int().nonnegative(),
+        })
+            .strict(),
+        communityMovieOrigin: zod_1.z.string().url(),
+        publicTagConfigured: zod_1.z.boolean(),
+        searchCampaignScript: zod_1.z
+            .object({
+            name: zod_1.z.string(),
+            adGroupCount: zod_1.z.number().int().nonnegative(),
+            negativeKeywordCount: zod_1.z.number().int().nonnegative(),
+        })
+            .strict(),
+    })
+        .strict(),
+})
+    .strict();

package/dist/marketing/marketing-test-traffic.d.ts

@@ -0,0 +1,6 @@
+export declare function isTestMarketingClickId(value: string | undefined | null): boolean;
+export declare function hasMarketingClickId(attribution: {
+    gclid?: string | undefined;
+    gbraid?: string | undefined;
+    wbraid?: string | undefined;
+}): boolean;

package/dist/marketing/marketing-test-traffic.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTestMarketingClickId = isTestMarketingClickId;
+exports.hasMarketingClickId = hasMarketingClickId;
+/** Patterns that mark synthetic / QA click IDs — excluded from offline conversion upload. */
+const TEST_CLICK_ID_PATTERNS = [
+    /^E2E_TEST/i,
+    /^TEST_GCLID/i,
+    /^cm_test_/i,
+    /^test123$/i,
+    /^test$/i,
+];
+function isTestMarketingClickId(value) {
+    if (value === undefined || value === null)
+        return false;
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return false;
+    return TEST_CLICK_ID_PATTERNS.some((pattern) => pattern.test(trimmed));
+}
+function hasMarketingClickId(attribution) {
+    const gclid = attribution.gclid?.trim();
+    const gbraid = attribution.gbraid?.trim();
+    const wbraid = attribution.wbraid?.trim();
+    return ((gclid !== undefined && gclid.length > 0) ||
+        (gbraid !== undefined && gbraid.length > 0) ||
+        (wbraid !== undefined && wbraid.length > 0));
+}