@dalmore/api-contracts 0.0.0-dev.c751882 → 0.0.0-dev.c81baa3

package/common/types/attribution.types.d.ts

@@ -0,0 +1,582 @@
+import { z } from 'zod';
+/**
+ * UTM Source enum - Common marketing sources
+ */
+export declare enum UtmSource {
+    GOOGLE = "GOOGLE",
+    FACEBOOK = "FACEBOOK",
+    TWITTER = "TWITTER",
+    LINKEDIN = "LINKEDIN",
+    INSTAGRAM = "INSTAGRAM",
+    TIKTOK = "TIKTOK",
+    EMAIL = "EMAIL",
+    DIRECT = "DIRECT",
+    ORGANIC = "ORGANIC",
+    REFERRAL = "REFERRAL",
+    OTHER = "OTHER"
+}
+/**
+ * Zod enum schema for UTM Source
+ */
+export declare const UtmSourceZod: z.ZodNativeEnum<typeof UtmSource>;
+/**
+ * Attribution Touch Data (from cookie)
+ * This represents the raw data structure stored in the cookie
+ * Platform click IDs are stored as a record: { "gclid": "abc123", "fbclid": "xyz789", "ttclid": "def456" }
+ */
+export declare const AttributionTouchDataSchema: z.ZodObject<{
+    utmSource: z.ZodNativeEnum<typeof UtmSource>;
+    utmMedium: z.ZodString;
+    utmCampaign: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    utmTerm: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    utmContent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gclid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fbclid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ttclid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    msclkid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    twclid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lifatid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ref: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    landingPage: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>>;
+    documentReferrer: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>>;
+}, "strip", z.ZodTypeAny, {
+    utmSource: UtmSource;
+    utmMedium: string;
+    landingPage?: string | null | undefined;
+    utmCampaign?: string | null | undefined;
+    utmTerm?: string | null | undefined;
+    utmContent?: string | null | undefined;
+    gclid?: string | null | undefined;
+    fbclid?: string | null | undefined;
+    ttclid?: string | null | undefined;
+    msclkid?: string | null | undefined;
+    twclid?: string | null | undefined;
+    lifatid?: string | null | undefined;
+    ref?: string | null | undefined;
+    documentReferrer?: string | null | undefined;
+}, {
+    utmSource: UtmSource;
+    utmMedium: string;
+    landingPage?: string | null | undefined;
+    utmCampaign?: string | null | undefined;
+    utmTerm?: string | null | undefined;
+    utmContent?: string | null | undefined;
+    gclid?: string | null | undefined;
+    fbclid?: string | null | undefined;
+    ttclid?: string | null | undefined;
+    msclkid?: string | null | undefined;
+    twclid?: string | null | undefined;
+    lifatid?: string | null | undefined;
+    ref?: string | null | undefined;
+    documentReferrer?: string | null | undefined;
+}>;
+export type AttributionTouchData = z.infer<typeof AttributionTouchDataSchema>;
+/**
+ * Attribution Touch Response Schema
+ * This represents the entity structure returned from the API
+ */
+export declare const AttributionTouchSchema: z.ZodObject<{
+    id: z.ZodString;
+    __entity: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+    updatedAt: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+    deletedAt: z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+} & {
+    utmSource: z.ZodNullable<z.ZodNativeEnum<typeof UtmSource>>;
+    utmMedium: z.ZodNullable<z.ZodString>;
+    utmCampaign: z.ZodNullable<z.ZodString>;
+    utmTerm: z.ZodNullable<z.ZodString>;
+    utmContent: z.ZodNullable<z.ZodString>;
+    platformClickIds: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+    ref: z.ZodNullable<z.ZodString>;
+    landingPage: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    documentReferrer: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    isFirstTouch: z.ZodBoolean;
+    isLastTouch: z.ZodBoolean;
+    touchCount: z.ZodNumber;
+    userId: z.ZodString;
+    accountId: z.ZodString;
+    tradeId: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+    deletedAt: string | Date | null;
+    accountId: string;
+    userId: string;
+    tradeId: string | null;
+    landingPage: string | null;
+    utmSource: UtmSource | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    utmTerm: string | null;
+    utmContent: string | null;
+    ref: string | null;
+    documentReferrer: string | null;
+    platformClickIds: Record<string, string> | null;
+    isFirstTouch: boolean;
+    isLastTouch: boolean;
+    touchCount: number;
+    __entity?: string | undefined;
+}, {
+    id: string;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+    deletedAt: string | Date | null;
+    accountId: string;
+    userId: string;
+    tradeId: string | null;
+    landingPage: string | null;
+    utmSource: UtmSource | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    utmTerm: string | null;
+    utmContent: string | null;
+    ref: string | null;
+    documentReferrer: string | null;
+    platformClickIds: Record<string, string> | null;
+    isFirstTouch: boolean;
+    isLastTouch: boolean;
+    touchCount: number;
+    __entity?: string | undefined;
+}>;
+export type AttributionTouch = z.infer<typeof AttributionTouchSchema>;
+/**
+ * Cookie name constant for attribution data
+ */
+export declare const ATTRIBUTION_COOKIE_NAME = "dalmore_attribution";
+/**
+ * Cookie parsing helper type
+ */
+export type AttributionCookie = AttributionTouchData;
+/**
+ * Attribution Touches Include Options
+ */
+export declare const attributionTouchesInclude: z.ZodEnum<["user", "account", "trade"]>;
+/**
+ * @description Query parameters for including related entities
+ */
+export declare const AttributionTouchesIncludeQuery: z.ZodObject<{
+    include: z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodString>, string[], string | undefined>, string[], string | undefined>;
+}, "strip", z.ZodTypeAny, {
+    include: string[];
+}, {
+    include?: string | undefined;
+}>;
+export interface AttributionTouchesIncludeQuery extends z.infer<typeof AttributionTouchesIncludeQuery> {
+}
+/**
+ * Attribution Touches Filters
+ */
+export declare const AttributionTouchesFiltersZod: z.ZodObject<{
+    userId: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodString>;
+    tradeId: z.ZodOptional<z.ZodString>;
+    isFirstTouch: z.ZodOptional<z.ZodBoolean>;
+    isLastTouch: z.ZodOptional<z.ZodBoolean>;
+    utmSource: z.ZodOptional<z.ZodNativeEnum<typeof UtmSource>>;
+    utmMedium: z.ZodOptional<z.ZodString>;
+    utmCampaign: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    accountId?: string | undefined;
+    userId?: string | undefined;
+    tradeId?: string | undefined;
+    utmSource?: UtmSource | undefined;
+    utmMedium?: string | undefined;
+    utmCampaign?: string | undefined;
+    isFirstTouch?: boolean | undefined;
+    isLastTouch?: boolean | undefined;
+}, {
+    accountId?: string | undefined;
+    userId?: string | undefined;
+    tradeId?: string | undefined;
+    utmSource?: UtmSource | undefined;
+    utmMedium?: string | undefined;
+    utmCampaign?: string | undefined;
+    isFirstTouch?: boolean | undefined;
+    isLastTouch?: boolean | undefined;
+}>;
+export type AttributionTouchesFilters = z.infer<typeof AttributionTouchesFiltersZod>;
+/**
+ * Paginated Attribution Touch Response
+ */
+export declare const IPaginatedAttributionTouch: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        __entity: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+        updatedAt: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+        deletedAt: z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    } & {
+        utmSource: z.ZodNullable<z.ZodNativeEnum<typeof UtmSource>>;
+        utmMedium: z.ZodNullable<z.ZodString>;
+        utmCampaign: z.ZodNullable<z.ZodString>;
+        utmTerm: z.ZodNullable<z.ZodString>;
+        utmContent: z.ZodNullable<z.ZodString>;
+        platformClickIds: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+        ref: z.ZodNullable<z.ZodString>;
+        landingPage: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+        documentReferrer: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+        isFirstTouch: z.ZodBoolean;
+        isLastTouch: z.ZodBoolean;
+        touchCount: z.ZodNumber;
+        userId: z.ZodString;
+        accountId: z.ZodString;
+        tradeId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    }, {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    }>, "many">;
+    meta: z.ZodObject<{
+        itemCount: z.ZodNumber;
+        totalItems: z.ZodOptional<z.ZodNumber>;
+        itemsPerPage: z.ZodNumber;
+        totalPages: z.ZodOptional<z.ZodNumber>;
+        currentPage: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        itemCount: number;
+        itemsPerPage: number;
+        currentPage: number;
+        totalItems?: number | undefined;
+        totalPages?: number | undefined;
+    }, {
+        itemCount: number;
+        itemsPerPage: number;
+        currentPage: number;
+        totalItems?: number | undefined;
+        totalPages?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    }[];
+    meta: {
+        itemCount: number;
+        itemsPerPage: number;
+        currentPage: number;
+        totalItems?: number | undefined;
+        totalPages?: number | undefined;
+    };
+}, {
+    items: {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    }[];
+    meta: {
+        itemCount: number;
+        itemsPerPage: number;
+        currentPage: number;
+        totalItems?: number | undefined;
+        totalPages?: number | undefined;
+    };
+}>;
+export type IPaginatedAttributionTouch = z.infer<typeof IPaginatedAttributionTouch>;
+/**
+ * User Attribution Touch Summary Response
+ * Contains first and last touch for a user, total touches, and conversion path
+ */
+export declare const UserAttributionTouchSummarySchema: z.ZodObject<{
+    firstTouch: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        __entity: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+        updatedAt: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+        deletedAt: z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    } & {
+        utmSource: z.ZodNullable<z.ZodNativeEnum<typeof UtmSource>>;
+        utmMedium: z.ZodNullable<z.ZodString>;
+        utmCampaign: z.ZodNullable<z.ZodString>;
+        utmTerm: z.ZodNullable<z.ZodString>;
+        utmContent: z.ZodNullable<z.ZodString>;
+        platformClickIds: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+        ref: z.ZodNullable<z.ZodString>;
+        landingPage: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+        documentReferrer: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+        isFirstTouch: z.ZodBoolean;
+        isLastTouch: z.ZodBoolean;
+        touchCount: z.ZodNumber;
+        userId: z.ZodString;
+        accountId: z.ZodString;
+        tradeId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    }, {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    }>>;
+    lastTouch: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        __entity: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+        updatedAt: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+        deletedAt: z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    } & {
+        utmSource: z.ZodNullable<z.ZodNativeEnum<typeof UtmSource>>;
+        utmMedium: z.ZodNullable<z.ZodString>;
+        utmCampaign: z.ZodNullable<z.ZodString>;
+        utmTerm: z.ZodNullable<z.ZodString>;
+        utmContent: z.ZodNullable<z.ZodString>;
+        platformClickIds: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+        ref: z.ZodNullable<z.ZodString>;
+        landingPage: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+        documentReferrer: z.ZodNullable<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+        isFirstTouch: z.ZodBoolean;
+        isLastTouch: z.ZodBoolean;
+        touchCount: z.ZodNumber;
+        userId: z.ZodString;
+        accountId: z.ZodString;
+        tradeId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    }, {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    }>>;
+    totalTouches: z.ZodNumber;
+    conversionPath: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    firstTouch: {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    } | null;
+    lastTouch: {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    } | null;
+    totalTouches: number;
+    conversionPath: string[];
+}, {
+    firstTouch: {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    } | null;
+    lastTouch: {
+        id: string;
+        createdAt: string | Date;
+        updatedAt: string | Date;
+        deletedAt: string | Date | null;
+        accountId: string;
+        userId: string;
+        tradeId: string | null;
+        landingPage: string | null;
+        utmSource: UtmSource | null;
+        utmMedium: string | null;
+        utmCampaign: string | null;
+        utmTerm: string | null;
+        utmContent: string | null;
+        ref: string | null;
+        documentReferrer: string | null;
+        platformClickIds: Record<string, string> | null;
+        isFirstTouch: boolean;
+        isLastTouch: boolean;
+        touchCount: number;
+        __entity?: string | undefined;
+    } | null;
+    totalTouches: number;
+    conversionPath: string[];
+}>;
+export type UserAttributionTouchSummary = z.infer<typeof UserAttributionTouchSummarySchema>;

package/common/types/attribution.types.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { extendZodWithOpenApi } from '@anatine/zod-openapi';
+import { IBaseEntity } from './entity.types.js';
+import { createUrlSchema, IPaginationMeta } from './common.types.js';
+extendZodWithOpenApi(z);
+/**
+ * UTM Source enum - Common marketing sources
+ */
+export var UtmSource;
+(function (UtmSource) {
+    UtmSource["GOOGLE"] = "GOOGLE";
+    UtmSource["FACEBOOK"] = "FACEBOOK";
+    UtmSource["TWITTER"] = "TWITTER";
+    UtmSource["LINKEDIN"] = "LINKEDIN";
+    UtmSource["INSTAGRAM"] = "INSTAGRAM";
+    UtmSource["TIKTOK"] = "TIKTOK";
+    UtmSource["EMAIL"] = "EMAIL";
+    UtmSource["DIRECT"] = "DIRECT";
+    UtmSource["ORGANIC"] = "ORGANIC";
+    UtmSource["REFERRAL"] = "REFERRAL";
+    UtmSource["OTHER"] = "OTHER";
+})(UtmSource || (UtmSource = {}));
+/**
+ * Zod enum schema for UTM Source
+ */
+export const UtmSourceZod = z.nativeEnum(UtmSource);
+/**
+ * Attribution Touch Data (from cookie)
+ * This represents the raw data structure stored in the cookie
+ * Platform click IDs are stored as a record: { "gclid": "abc123", "fbclid": "xyz789", "ttclid": "def456" }
+ */
+export const AttributionTouchDataSchema = z.object({
+    // UTM Parameters
+    utmSource: UtmSourceZod,
+    utmMedium: z.string(),
+    utmCampaign: z.string().nullable().optional(),
+    utmTerm: z.string().nullable().optional(),
+    utmContent: z.string().nullable().optional(),
+    // Platform Click IDs
+    gclid: z.string().nullable().optional(), // Google Click ID
+    fbclid: z.string().nullable().optional(), // Facebook Click ID
+    ttclid: z.string().nullable().optional(), // TikTok Click ID
+    msclkid: z.string().nullable().optional(), // Microsoft Click ID
+    twclid: z.string().nullable().optional(), // Twitter Click ID
+    lifatid: z.string().nullable().optional(), // LinkedIn Click ID
+    // In-house Referral
+    ref: z.string().nullable().optional(),
+    // Landing Page
+    landingPage: createUrlSchema({ strict: true }).nullable().optional(),
+    documentReferrer: createUrlSchema({ strict: true }).nullable().optional(),
+});
+/**
+ * Attribution Touch Response Schema
+ * This represents the entity structure returned from the API
+ */
+export const AttributionTouchSchema = IBaseEntity.extend({
+    utmSource: UtmSourceZod.nullable(),
+    utmMedium: z.string().nullable(),
+    utmCampaign: z.string().nullable(),
+    utmTerm: z.string().nullable(),
+    utmContent: z.string().nullable(),
+    platformClickIds: z.record(z.string()).nullable(),
+    ref: z.string().nullable(),
+    landingPage: createUrlSchema({ strict: true }).nullable(),
+    documentReferrer: createUrlSchema({ strict: true }).nullable(),
+    isFirstTouch: z.boolean(),
+    isLastTouch: z.boolean(),
+    touchCount: z.number().int(),
+    userId: z.string(),
+    accountId: z.string(),
+    tradeId: z.string().nullable(),
+});
+/**
+ * Cookie name constant for attribution data
+ */
+export const ATTRIBUTION_COOKIE_NAME = 'dalmore_attribution';
+/**
+ * Attribution Touches Include Options
+ */
+export const attributionTouchesInclude = z.enum(['user', 'account', 'trade']);
+/**
+ * @description Query parameters for including related entities
+ */
+export const AttributionTouchesIncludeQuery = z.object({
+    include: z
+        .string()
+        .optional()
+        .transform((str) => (str ? str.split(',') : []))
+        .refine((includes) => includes.every((include) => attributionTouchesInclude.options.includes(include)), {
+        message: `Invalid include option provided. Valid options are: ${attributionTouchesInclude.options.join(', ')}`,
+    })
+        .openapi({
+        example: `${attributionTouchesInclude.options.join(', ')}`,
+    }),
+});
+/**
+ * Attribution Touches Filters
+ */
+export const AttributionTouchesFiltersZod = z.object({
+    userId: z.string().optional(),
+    accountId: z.string().optional(),
+    tradeId: z.string().optional(),
+    isFirstTouch: z.coerce.boolean().optional(),
+    isLastTouch: z.coerce.boolean().optional(),
+    utmSource: UtmSourceZod.optional(),
+    utmMedium: z.string().optional(),
+    utmCampaign: z.string().optional(),
+});
+/**
+ * Paginated Attribution Touch Response
+ */
+export const IPaginatedAttributionTouch = z.object({
+    items: z.array(AttributionTouchSchema),
+    meta: IPaginationMeta,
+});
+/**
+ * User Attribution Touch Summary Response
+ * Contains first and last touch for a user, total touches, and conversion path
+ */
+export const UserAttributionTouchSummarySchema = z.object({
+    firstTouch: AttributionTouchSchema.nullable(),
+    lastTouch: AttributionTouchSchema.nullable(),
+    totalTouches: z.number().int(),
+    conversionPath: z.array(z.string()),
+});
+//# sourceMappingURL=attribution.types.js.map