@uptrademedia/site-kit 1.0.1 → 1.0.4

package/dist/types-C0pJGfbH.d.mts

@@ -0,0 +1,155 @@
+/**
+ * @uptrade/site-kit/engage - Type definitions
+ */
+type WidgetType = 'popup' | 'nudge' | 'bar' | 'chat';
+interface EngageElement {
+    id: string;
+    project_id: string;
+    name: string;
+    type: WidgetType;
+    config: WidgetConfig;
+    targeting: TargetingRules;
+    trigger: TriggerConfig;
+    is_active: boolean;
+    priority: number;
+    created_at: string;
+    updated_at: string;
+}
+interface WidgetConfig {
+    /** Visual style */
+    theme?: 'light' | 'dark' | 'custom';
+    position?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Content */
+    title?: string;
+    message?: string;
+    imageUrl?: string;
+    /** CTA */
+    ctaText?: string;
+    ctaUrl?: string;
+    ctaAction?: 'link' | 'close' | 'form' | 'chat';
+    /** Form (if ctaAction is 'form') */
+    formId?: string;
+    /** Styling */
+    backgroundColor?: string;
+    textColor?: string;
+    ctaBackgroundColor?: string;
+    ctaTextColor?: string;
+    borderRadius?: number;
+    /** Behavior */
+    closable?: boolean;
+    showOverlay?: boolean;
+    overlayOpacity?: number;
+}
+interface TargetingRules {
+    /** Page targeting */
+    pages?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    /** Device targeting */
+    devices?: ('desktop' | 'mobile' | 'tablet')[];
+    /** Visitor targeting */
+    visitor?: {
+        type?: 'new' | 'returning' | 'all';
+        minSessions?: number;
+        maxSessions?: number;
+    };
+    /** Source targeting */
+    source?: {
+        utm_source?: string[];
+        utm_medium?: string[];
+        utm_campaign?: string[];
+        referrer?: string[];
+    };
+    /** Time targeting */
+    schedule?: {
+        startDate?: string;
+        endDate?: string;
+        daysOfWeek?: number[];
+        startTime?: string;
+        endTime?: string;
+        timezone?: string;
+    };
+}
+interface TriggerConfig {
+    type: 'immediate' | 'delay' | 'scroll' | 'exit-intent' | 'click' | 'custom';
+    /** Delay in seconds (for 'delay' type) */
+    delay?: number;
+    /** Scroll percentage (for 'scroll' type) */
+    scrollPercentage?: number;
+    /** CSS selector (for 'click' type) */
+    clickSelector?: string;
+    /** Custom event name (for 'custom' type) */
+    customEvent?: string;
+    /** Frequency capping */
+    frequency?: {
+        type: 'always' | 'once' | 'once-per-session' | 'every-n-days';
+        days?: number;
+    };
+}
+interface ChatConfig {
+    /** Widget position */
+    position: 'bottom-right' | 'bottom-left';
+    /** Widget appearance */
+    buttonIcon?: 'chat' | 'help' | 'custom';
+    buttonColor?: string;
+    buttonText?: string;
+    /** Welcome message */
+    welcomeMessage?: string;
+    /** Operating hours */
+    operatingHours?: {
+        enabled: boolean;
+        timezone: string;
+        hours: {
+            [day: number]: {
+                start: string;
+                end: string;
+            } | null;
+        };
+    };
+    /** AI vs Live Chat */
+    mode: 'ai' | 'live' | 'hybrid';
+    /** AI settings (if mode is 'ai' or 'hybrid') */
+    aiSettings?: {
+        skillId?: string;
+        handoffToLive?: boolean;
+        handoffKeywords?: string[];
+    };
+}
+interface ChatMessage {
+    id: string;
+    conversation_id: string;
+    role: 'user' | 'assistant' | 'agent' | 'system';
+    content: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+interface ChatConversation {
+    id: string;
+    project_id: string;
+    visitor_id: string;
+    status: 'active' | 'pending' | 'resolved' | 'closed';
+    assigned_to?: string;
+    last_message_at: string;
+    created_at: string;
+}
+interface EngageConfig {
+    projectId: string;
+    /** Widget position */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Z-index for widgets */
+    zIndex?: number;
+    /** Enable chat */
+    chatEnabled?: boolean;
+    /** Debug mode */
+    debug?: boolean;
+}
+interface EngageAnalytics {
+    element_id: string;
+    event_type: 'impression' | 'click' | 'close' | 'submit' | 'dismiss';
+    session_id: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+
+export type { ChatConfig as C, EngageElement as E, TargetingRules as T, WidgetType as W, WidgetConfig as a, TriggerConfig as b, ChatMessage as c, ChatConversation as d, EngageConfig as e, EngageAnalytics as f };

package/dist/types-C0pJGfbH.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @uptrade/site-kit/engage - Type definitions
+ */
+type WidgetType = 'popup' | 'nudge' | 'bar' | 'chat';
+interface EngageElement {
+    id: string;
+    project_id: string;
+    name: string;
+    type: WidgetType;
+    config: WidgetConfig;
+    targeting: TargetingRules;
+    trigger: TriggerConfig;
+    is_active: boolean;
+    priority: number;
+    created_at: string;
+    updated_at: string;
+}
+interface WidgetConfig {
+    /** Visual style */
+    theme?: 'light' | 'dark' | 'custom';
+    position?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Content */
+    title?: string;
+    message?: string;
+    imageUrl?: string;
+    /** CTA */
+    ctaText?: string;
+    ctaUrl?: string;
+    ctaAction?: 'link' | 'close' | 'form' | 'chat';
+    /** Form (if ctaAction is 'form') */
+    formId?: string;
+    /** Styling */
+    backgroundColor?: string;
+    textColor?: string;
+    ctaBackgroundColor?: string;
+    ctaTextColor?: string;
+    borderRadius?: number;
+    /** Behavior */
+    closable?: boolean;
+    showOverlay?: boolean;
+    overlayOpacity?: number;
+}
+interface TargetingRules {
+    /** Page targeting */
+    pages?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    /** Device targeting */
+    devices?: ('desktop' | 'mobile' | 'tablet')[];
+    /** Visitor targeting */
+    visitor?: {
+        type?: 'new' | 'returning' | 'all';
+        minSessions?: number;
+        maxSessions?: number;
+    };
+    /** Source targeting */
+    source?: {
+        utm_source?: string[];
+        utm_medium?: string[];
+        utm_campaign?: string[];
+        referrer?: string[];
+    };
+    /** Time targeting */
+    schedule?: {
+        startDate?: string;
+        endDate?: string;
+        daysOfWeek?: number[];
+        startTime?: string;
+        endTime?: string;
+        timezone?: string;
+    };
+}
+interface TriggerConfig {
+    type: 'immediate' | 'delay' | 'scroll' | 'exit-intent' | 'click' | 'custom';
+    /** Delay in seconds (for 'delay' type) */
+    delay?: number;
+    /** Scroll percentage (for 'scroll' type) */
+    scrollPercentage?: number;
+    /** CSS selector (for 'click' type) */
+    clickSelector?: string;
+    /** Custom event name (for 'custom' type) */
+    customEvent?: string;
+    /** Frequency capping */
+    frequency?: {
+        type: 'always' | 'once' | 'once-per-session' | 'every-n-days';
+        days?: number;
+    };
+}
+interface ChatConfig {
+    /** Widget position */
+    position: 'bottom-right' | 'bottom-left';
+    /** Widget appearance */
+    buttonIcon?: 'chat' | 'help' | 'custom';
+    buttonColor?: string;
+    buttonText?: string;
+    /** Welcome message */
+    welcomeMessage?: string;
+    /** Operating hours */
+    operatingHours?: {
+        enabled: boolean;
+        timezone: string;
+        hours: {
+            [day: number]: {
+                start: string;
+                end: string;
+            } | null;
+        };
+    };
+    /** AI vs Live Chat */
+    mode: 'ai' | 'live' | 'hybrid';
+    /** AI settings (if mode is 'ai' or 'hybrid') */
+    aiSettings?: {
+        skillId?: string;
+        handoffToLive?: boolean;
+        handoffKeywords?: string[];
+    };
+}
+interface ChatMessage {
+    id: string;
+    conversation_id: string;
+    role: 'user' | 'assistant' | 'agent' | 'system';
+    content: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+interface ChatConversation {
+    id: string;
+    project_id: string;
+    visitor_id: string;
+    status: 'active' | 'pending' | 'resolved' | 'closed';
+    assigned_to?: string;
+    last_message_at: string;
+    created_at: string;
+}
+interface EngageConfig {
+    projectId: string;
+    /** Widget position */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Z-index for widgets */
+    zIndex?: number;
+    /** Enable chat */
+    chatEnabled?: boolean;
+    /** Debug mode */
+    debug?: boolean;
+}
+interface EngageAnalytics {
+    element_id: string;
+    event_type: 'impression' | 'click' | 'close' | 'submit' | 'dismiss';
+    session_id: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+
+export type { ChatConfig as C, EngageElement as E, TargetingRules as T, WidgetType as W, WidgetConfig as a, TriggerConfig as b, ChatMessage as c, ChatConversation as d, EngageConfig as e, EngageAnalytics as f };

package/dist/types-DA_Kocle.d.mts

@@ -0,0 +1,127 @@
+/**
+ * @uptrade/site-kit/analytics - Type definitions
+ */
+interface PageView {
+    id: string;
+    project_id: string;
+    session_id: string;
+    path: string;
+    url: string;
+    title?: string;
+    referrer?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+    device_type: 'desktop' | 'mobile' | 'tablet';
+    browser?: string;
+    os?: string;
+    country?: string;
+    region?: string;
+    city?: string;
+    created_at: string;
+}
+interface AnalyticsEvent {
+    id: string;
+    project_id: string;
+    session_id: string;
+    event_name: string;
+    event_category?: string;
+    event_label?: string;
+    event_value?: number;
+    properties?: Record<string, unknown>;
+    path: string;
+    created_at: string;
+}
+interface TrackEventOptions {
+    /** Event name (e.g., 'button_click', 'form_submit') */
+    name: string;
+    /** Event category (e.g., 'engagement', 'conversion') */
+    category?: string;
+    /** Event label for additional context */
+    label?: string;
+    /** Numeric value associated with event */
+    value?: number;
+    /** Additional custom properties */
+    properties?: Record<string, unknown>;
+}
+interface Conversion {
+    id: string;
+    project_id: string;
+    session_id: string;
+    conversion_type: string;
+    value?: number;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+interface TrackConversionOptions {
+    /** Conversion type (e.g., 'form_submit', 'purchase', 'signup') */
+    type: string;
+    /** Monetary value */
+    value?: number;
+    /** Currency code (e.g., 'USD') */
+    currency?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+interface Session {
+    id: string;
+    project_id: string;
+    visitor_id: string;
+    started_at: string;
+    ended_at?: string;
+    page_count: number;
+    event_count: number;
+    duration_seconds?: number;
+    is_bounce: boolean;
+    entry_path: string;
+    exit_path?: string;
+    referrer?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    device_type: 'desktop' | 'mobile' | 'tablet';
+    browser?: string;
+    os?: string;
+}
+interface WebVitalsData {
+    id: string;
+    project_id: string;
+    path: string;
+    lcp?: number;
+    fid?: number;
+    cls?: number;
+    ttfb?: number;
+    inp?: number;
+    fcp?: number;
+    created_at: string;
+}
+interface AnalyticsConfig {
+    projectId: string;
+    /** Track page views automatically (default: true) */
+    trackPageViews?: boolean;
+    /** Track Web Vitals automatically (default: true) */
+    trackWebVitals?: boolean;
+    /** Track scroll depth (default: false) */
+    trackScrollDepth?: boolean;
+    /** Session timeout in minutes (default: 30) */
+    sessionTimeout?: number;
+    /** Paths to exclude from tracking */
+    excludePaths?: string[];
+    /** Debug mode - logs events to console */
+    debug?: boolean;
+}
+interface AnalyticsContextValue {
+    /** Track a custom event */
+    trackEvent: (options: TrackEventOptions) => void;
+    /** Track a conversion */
+    trackConversion: (options: TrackConversionOptions) => void;
+    /** Get current session ID */
+    sessionId: string | null;
+    /** Get current visitor ID */
+    visitorId: string | null;
+}
+
+export type { AnalyticsContextValue as A, Conversion as C, PageView as P, Session as S, TrackEventOptions as T, WebVitalsData as W, TrackConversionOptions as a, AnalyticsEvent as b, AnalyticsConfig as c };

package/dist/types-DA_Kocle.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @uptrade/site-kit/analytics - Type definitions
+ */
+interface PageView {
+    id: string;
+    project_id: string;
+    session_id: string;
+    path: string;
+    url: string;
+    title?: string;
+    referrer?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+    device_type: 'desktop' | 'mobile' | 'tablet';
+    browser?: string;
+    os?: string;
+    country?: string;
+    region?: string;
+    city?: string;
+    created_at: string;
+}
+interface AnalyticsEvent {
+    id: string;
+    project_id: string;
+    session_id: string;
+    event_name: string;
+    event_category?: string;
+    event_label?: string;
+    event_value?: number;
+    properties?: Record<string, unknown>;
+    path: string;
+    created_at: string;
+}
+interface TrackEventOptions {
+    /** Event name (e.g., 'button_click', 'form_submit') */
+    name: string;
+    /** Event category (e.g., 'engagement', 'conversion') */
+    category?: string;
+    /** Event label for additional context */
+    label?: string;
+    /** Numeric value associated with event */
+    value?: number;
+    /** Additional custom properties */
+    properties?: Record<string, unknown>;
+}
+interface Conversion {
+    id: string;
+    project_id: string;
+    session_id: string;
+    conversion_type: string;
+    value?: number;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+interface TrackConversionOptions {
+    /** Conversion type (e.g., 'form_submit', 'purchase', 'signup') */
+    type: string;
+    /** Monetary value */
+    value?: number;
+    /** Currency code (e.g., 'USD') */
+    currency?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+interface Session {
+    id: string;
+    project_id: string;
+    visitor_id: string;
+    started_at: string;
+    ended_at?: string;
+    page_count: number;
+    event_count: number;
+    duration_seconds?: number;
+    is_bounce: boolean;
+    entry_path: string;
+    exit_path?: string;
+    referrer?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    device_type: 'desktop' | 'mobile' | 'tablet';
+    browser?: string;
+    os?: string;
+}
+interface WebVitalsData {
+    id: string;
+    project_id: string;
+    path: string;
+    lcp?: number;
+    fid?: number;
+    cls?: number;
+    ttfb?: number;
+    inp?: number;
+    fcp?: number;
+    created_at: string;
+}
+interface AnalyticsConfig {
+    projectId: string;
+    /** Track page views automatically (default: true) */
+    trackPageViews?: boolean;
+    /** Track Web Vitals automatically (default: true) */
+    trackWebVitals?: boolean;
+    /** Track scroll depth (default: false) */
+    trackScrollDepth?: boolean;
+    /** Session timeout in minutes (default: 30) */
+    sessionTimeout?: number;
+    /** Paths to exclude from tracking */
+    excludePaths?: string[];
+    /** Debug mode - logs events to console */
+    debug?: boolean;
+}
+interface AnalyticsContextValue {
+    /** Track a custom event */
+    trackEvent: (options: TrackEventOptions) => void;
+    /** Track a conversion */
+    trackConversion: (options: TrackConversionOptions) => void;
+    /** Get current session ID */
+    sessionId: string | null;
+    /** Get current visitor ID */
+    visitorId: string | null;
+}
+
+export type { AnalyticsContextValue as A, Conversion as C, PageView as P, Session as S, TrackEventOptions as T, WebVitalsData as W, TrackConversionOptions as a, AnalyticsEvent as b, AnalyticsConfig as c };