@uptrademedia/site-kit 1.0.1 → 1.0.4

package/dist/index.d.mts

@@ -0,0 +1,649 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default, { ReactNode } from 'react';
+export { c as ManagedFAQData, M as ManagedMetadataResult, b as ManagedSchemaProps } from './types-BmzutFwy.mjs';
+export { c as AnalyticsConfig, b as AnalyticsEvent, P as PageView } from './types-DA_Kocle.mjs';
+export { C as ChatConfig, E as EngageElement, a as WidgetConfig } from './types-C0pJGfbH.mjs';
+export { a as FormField, F as FormSubmission, M as ManagedFormConfig } from './types-lFLKKn0G.mjs';
+export { c as BlogAuthor, d as BlogCategory, b as BlogPostType } from './types-BDojCvvL.mjs';
+export { g as Cart, f as CartItem, e as CommerceCategory, C as CommerceOffering, c as CommerceSchedule, a as CommerceVariant, O as OfferingType } from './types-nB206tPK.mjs';
+export { n as CalendarView, C as CheckoutForm, p as EventCalendar, m as EventEmbed, o as EventModal, E as EventTile, O as OfferingCard, l as OfferingList, P as ProductEmbed, R as RegistrationForm, U as UpcomingEvents, k as createCheckoutSession, j as fetchNextEvent, a as fetchOffering, f as fetchOfferings, c as fetchProducts, h as fetchServices, i as fetchUpcomingEvents, s as formatDate, t as formatDateTime, q as formatPrice, A as getOfferingUrl, r as registerForEvent, u as useEventModal } from './useEventModal-6U1pF3_g.mjs';
+export { RedirectConfig, RedirectRule, clearRedirectCache, fetchRedirectRules, generateNextRedirects, handleManagedRedirects } from './redirects/index.mjs';
+export { ImageApiConfig, ImageFile, ManagedImage, ManagedImageData, ManagedImageProps, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from './images/index.mjs';
+export { S as SetupWizard } from './SetupWizard-Cki06kB0.mjs';
+import 'next';
+import 'next/server';
+
+/**
+ * @uptrade/site-kit - Shared types across all modules
+ *
+ * Site-kit ONLY calls Portal API - never Supabase directly.
+ * All data access goes through api.uptrademedia.com with API key auth.
+ */
+interface SiteKitConfig {
+    /**
+     * Portal API URL (defaults to https://api.uptrademedia.com)
+     */
+    apiUrl?: string;
+    /**
+     * Project API key for all API calls
+     * Required - identifies the project and provides access
+     */
+    apiKey: string;
+    /** Analytics module configuration */
+    analytics?: {
+        enabled: boolean;
+        trackPageViews?: boolean;
+        trackWebVitals?: boolean;
+        trackScrollDepth?: boolean;
+        trackClicks?: boolean;
+        sessionDuration?: number;
+        excludePaths?: string[];
+    };
+    /** Engage widget configuration */
+    engage?: {
+        enabled: boolean;
+        position?: 'bottom-right' | 'bottom-left';
+        zIndex?: number;
+        chatEnabled?: boolean;
+    };
+    /** Forms configuration */
+    forms?: {
+        enabled: boolean;
+        honeypotField?: string;
+    };
+    /** Debug mode - logs to console */
+    debug?: boolean;
+}
+
+interface SignalConfig$1 {
+    enabled: boolean;
+    realtime?: boolean;
+    experiments?: boolean;
+    behaviorTracking?: boolean;
+}
+interface SiteKitContextValue extends SiteKitConfig {
+    isReady: boolean;
+    signal?: SignalConfig$1;
+    signalUrl?: string;
+}
+declare function useSiteKit(): SiteKitContextValue;
+interface SiteKitProviderProps extends SiteKitConfig {
+    children: ReactNode;
+    signalUrl?: string;
+}
+declare function SiteKitProvider({ children, apiUrl, signalUrl, apiKey, analytics, engage, forms, signal, debug, }: SiteKitProviderProps & {
+    signal?: SignalConfig$1;
+}): react_jsx_runtime.JSX.Element;
+
+/**
+ * @uptrade/site-kit/affiliates - Affiliates Types
+ *
+ * TypeScript types for affiliate tracking and display.
+ */
+interface Affiliate {
+    id: string;
+    project_id: string;
+    name: string;
+    website_url?: string;
+    logo_url?: string;
+    status: 'active' | 'paused';
+    notes?: string;
+    created_at: string;
+}
+interface AffiliateOffer {
+    id: string;
+    affiliate_id: string;
+    name: string;
+    destination_url: string;
+    description?: string;
+    payout_type: 'flat' | 'percent' | 'none';
+    payout_amount?: number;
+    is_active: boolean;
+}
+interface AffiliateWithOffers extends Affiliate {
+    offers: AffiliateOffer[];
+}
+interface FetchAffiliatesOptions {
+    status?: 'active' | 'paused';
+    includeOffers?: boolean;
+}
+
+/**
+ * @uptrade/site-kit/affiliates - Affiliates API
+ *
+ * API functions for fetching affiliate data for client sites.
+ * All data goes through Portal API with API key auth - never Supabase directly.
+ */
+
+/**
+ * Fetch all active affiliates for the project
+ *
+ * @example
+ * ```ts
+ * const affiliates = await fetchAffiliates()
+ * ```
+ */
+declare function fetchAffiliates(options?: FetchAffiliatesOptions): Promise<AffiliateWithOffers[]>;
+/**
+ * Build a tracking URL for an affiliate offer
+ * When clicked, this redirects through our tracking endpoint and then to the destination
+ *
+ * @example
+ * ```ts
+ * const trackingUrl = getTrackingUrl(affiliate.id, offer.id)
+ * // Returns: https://api.uptrademedia.com/a/{affiliateId}/{offerId}
+ * ```
+ */
+declare function getTrackingUrl(affiliateId: string, offerId: string): string;
+
+/**
+ * @uptrade/site-kit/affiliates - useAffiliates Hook
+ *
+ * React hook for fetching and displaying affiliates on client sites.
+ */
+
+interface UseAffiliatesResult {
+    affiliates: AffiliateWithOffers[];
+    isLoading: boolean;
+    error: string | null;
+    getTrackingUrl: (affiliateId: string, offerId: string) => string;
+}
+/**
+ * Hook to fetch affiliates for display on client sites
+ *
+ * @example
+ * ```tsx
+ * function AffiliatesSection() {
+ *   const { affiliates, isLoading } = useAffiliates()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <div className="grid grid-cols-3 gap-4">
+ *       {affiliates.map(affiliate => (
+ *         <AffiliateCard key={affiliate.id} affiliate={affiliate} />
+ *       ))}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useAffiliates(): UseAffiliatesResult;
+
+interface AffiliateCardProps {
+    affiliate: AffiliateWithOffers;
+    className?: string;
+    /** Optional custom render for the logo */
+    renderLogo?: (affiliate: AffiliateWithOffers) => React__default.ReactNode;
+    /** Show offers as links below the card */
+    showOffers?: boolean;
+}
+/**
+ * Single affiliate card - unstyled, bring your own CSS
+ *
+ * @example
+ * ```tsx
+ * <AffiliateCard
+ *   affiliate={affiliate}
+ *   className="p-4 bg-white rounded-lg shadow"
+ *   showOffers
+ * />
+ * ```
+ */
+declare function AffiliateCard({ affiliate, className, renderLogo, showOffers, }: AffiliateCardProps): react_jsx_runtime.JSX.Element;
+interface AffiliatesWidgetProps {
+    className?: string;
+    /** Custom loading component */
+    loadingComponent?: React__default.ReactNode;
+    /** Custom empty state component */
+    emptyComponent?: React__default.ReactNode;
+    /** Custom error component */
+    errorComponent?: React__default.ReactNode;
+    /** Show offers on each card */
+    showOffers?: boolean;
+    /** Custom render function for each affiliate */
+    renderAffiliate?: (affiliate: AffiliateWithOffers) => React__default.ReactNode;
+    /** Maximum number to display */
+    limit?: number;
+}
+/**
+ * Display a grid of affiliates - unstyled, bring your own CSS
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <AffiliatesWidget className="grid grid-cols-3 gap-4" />
+ *
+ * // With custom rendering
+ * <AffiliatesWidget
+ *   renderAffiliate={(affiliate) => (
+ *     <MyCustomCard key={affiliate.id} data={affiliate} />
+ *   )}
+ * />
+ * ```
+ */
+declare function AffiliatesWidget({ className, loadingComponent, emptyComponent, errorComponent, showOffers, renderAffiliate, limit, }: AffiliatesWidgetProps): string | number | bigint | true | Iterable<React__default.ReactNode> | Promise<React__default.AwaitedReactNode> | react_jsx_runtime.JSX.Element | null;
+
+/**
+ * @uptrade/site-kit/signal - Types
+ *
+ * Type definitions for Signal integration
+ */
+interface SignalConfig {
+    /** Config version (for cache invalidation) */
+    version: string;
+    /** Whether Signal is enabled for this project */
+    enabled: boolean;
+    /** Engage element overrides */
+    engage?: {
+        popups?: Record<string, EngageOverride>;
+        nudges?: Record<string, EngageOverride>;
+        banners?: Record<string, EngageOverride>;
+        chat?: ChatOverride;
+    };
+    /** SEO overrides */
+    seo?: {
+        meta?: Record<string, MetaOverride>;
+        redirects?: RedirectRule[];
+    };
+    /** Commerce overrides */
+    commerce?: {
+        pricing?: Record<string, PriceOverride>;
+        upsells?: Record<string, UpsellConfig>;
+    };
+    /** Active experiments */
+    experiments: ExperimentConfig[];
+    /** Updated timestamp */
+    updated_at: string;
+}
+interface EngageOverride {
+    /** Whether the element is enabled */
+    enabled?: boolean;
+    /** Timing override in ms */
+    timing?: number;
+    /** Content overrides */
+    content?: {
+        headline?: string;
+        body?: string;
+        cta?: string;
+        image?: string;
+    };
+    /** Targeting overrides */
+    targeting?: {
+        pages?: string[];
+        devices?: ('desktop' | 'mobile' | 'tablet')[];
+        segments?: string[];
+    };
+}
+interface ChatOverride {
+    /** Whether chat is enabled */
+    enabled?: boolean;
+    /** Auto-open delay in ms */
+    auto_open_delay?: number;
+    /** Welcome message override */
+    welcome_message?: string;
+    /** Offline message */
+    offline_message?: string;
+}
+interface MetaOverride {
+    /** Title tag override */
+    title?: string;
+    /** Meta description override */
+    description?: string;
+    /** OG image override */
+    og_image?: string;
+}
+interface RedirectRule {
+    /** Source path (supports wildcards) */
+    from: string;
+    /** Destination path */
+    to: string;
+    /** Redirect type */
+    type: 301 | 302;
+    /** Whether the rule is active */
+    active: boolean;
+}
+interface PriceOverride {
+    /** Offering ID */
+    offering_id: string;
+    /** New price in cents */
+    price: number;
+    /** Compare-at price for sales */
+    compare_at_price?: number;
+    /** Reason for override */
+    reason: string;
+}
+interface UpsellConfig {
+    /** Primary offering ID */
+    offering_id: string;
+    /** Upsell offering IDs */
+    upsell_ids: string[];
+    /** Display location */
+    location: 'cart' | 'checkout' | 'product_page';
+}
+interface ExperimentConfig {
+    /** Unique experiment ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Experiment status */
+    status: 'draft' | 'running' | 'paused' | 'completed';
+    /** Variants with weights */
+    variants: ExperimentVariant[];
+    /** Target pages/segments */
+    target?: {
+        pages?: string[];
+        segments?: string[];
+        devices?: ('desktop' | 'mobile' | 'tablet')[];
+    };
+    /** Goal definition */
+    goal: {
+        outcome_type: string;
+        min_confidence: number;
+    };
+    /** Traffic allocation (0-1) */
+    traffic_allocation: number;
+    /** Winner if determined */
+    winner_variant?: string;
+}
+interface ExperimentVariant {
+    /** Unique variant key */
+    key: string;
+    /** Display name */
+    name: string;
+    /** Traffic weight (0-1) */
+    weight: number;
+    /** Variant description */
+    description?: string;
+}
+interface ExperimentAssignment {
+    /** Experiment ID */
+    experiment_id: string;
+    /** Assigned variant key */
+    variant_key: string;
+    /** Assignment expiration */
+    expires: number;
+    /** Assigned timestamp */
+    assigned_at: string;
+}
+interface SignalEvent {
+    /** Event type (page_view, click, form_submit, etc.) */
+    event_type: string;
+    /** Specific event name */
+    event_name: string;
+    /** Event data payload */
+    event_data: Record<string, unknown>;
+    /** Page context */
+    page_url: string;
+    page_path: string;
+    referrer: string;
+    /** Device info */
+    device_type: 'desktop' | 'mobile' | 'tablet';
+    browser: string;
+    os: string;
+    viewport_width: number;
+    viewport_height: number;
+    /** Engagement metrics */
+    time_on_page: number;
+    scroll_depth: number;
+    click_count: number;
+    /** Active experiments */
+    experiments: Array<{
+        experiment_id: string;
+        variant_key: string;
+    }>;
+    /** Attribution */
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    /** Timestamp */
+    timestamp: string;
+}
+interface SignalOutcome {
+    /** Outcome type (form_submit, purchase, signup, etc.) */
+    outcome_type: string;
+    /** Monetary value if applicable */
+    value?: number;
+    /** Related entity ID */
+    entity_id?: string;
+    /** Active experiment IDs */
+    experiments: string[];
+    /** Additional context */
+    metadata?: Record<string, unknown>;
+}
+interface SignalContextValue {
+    /** Current config */
+    config: SignalConfig | null;
+    /** Whether Signal is loading */
+    loading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Track a custom event */
+    trackEvent: (event: Partial<SignalEvent>) => void;
+    /** Report an outcome/conversion */
+    trackOutcome: (outcome: SignalOutcome) => void;
+    /** Get experiment assignment */
+    getExperiment: (experimentId: string) => ExperimentAssignment | null;
+    /** Force refresh config */
+    refreshConfig: () => Promise<void>;
+}
+interface SignalBridgeProps {
+    /** Enable Signal integration */
+    enabled?: boolean;
+    /** Enable real-time config updates via SSE */
+    realtime?: boolean;
+    /** Enable A/B experiment participation */
+    experiments?: boolean;
+    /** Enable rich behavioral tracking */
+    behaviorTracking?: boolean;
+    /** Children */
+    children: React.ReactNode;
+}
+
+declare function useSignal(): SignalContextValue;
+declare function SignalBridge({ enabled, realtime, experiments, behaviorTracking, children, }: SignalBridgeProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access Signal config
+ */
+declare function useSignalConfig(): SignalConfig | null;
+/**
+ * Hook for tracking events
+ */
+declare function useSignalEvent(): (event: Partial<SignalEvent>) => void;
+/**
+ * Hook for tracking outcomes/conversions
+ */
+declare function useSignalOutcome(): {
+    trackOutcome: (outcome: SignalOutcome) => void;
+};
+/**
+ * Hook for experiment assignment
+ */
+declare function useSignalExperiment(experimentId: string): {
+    assignment: ExperimentAssignment | null;
+    variant: string | null;
+    isControl: boolean;
+};
+
+interface SignalExperimentProps {
+    /** Unique experiment ID */
+    experimentId: string;
+    /** Variants to test - keys are variant names, values are React nodes */
+    variants: Record<string, React__default.ReactNode>;
+    /** Fallback content if no assignment (defaults to 'control' variant) */
+    fallback?: React__default.ReactNode;
+    /** Track impression automatically */
+    trackImpression?: boolean;
+    /** Children function for more control */
+    children?: (props: {
+        variant: string;
+        isControl: boolean;
+    }) => React__default.ReactNode;
+}
+/**
+ * Renders different content variants based on Signal's A/B assignment.
+ *
+ * @example
+ * // Simple variant switching
+ * <SignalExperiment experimentId="hero-cta" variants={{
+ *   control: <Button>Get Started</Button>,
+ *   variant_a: <Button variant="primary">Start Free Trial</Button>,
+ *   variant_b: <Button variant="secondary">Book a Demo</Button>,
+ * }} />
+ *
+ * @example
+ * // With render prop for more control
+ * <SignalExperiment experimentId="pricing-layout">
+ *   {({ variant, isControl }) => (
+ *     <PricingSection layout={isControl ? 'cards' : 'table'} />
+ *   )}
+ * </SignalExperiment>
+ */
+declare function SignalExperiment({ experimentId, variants, fallback, trackImpression, children, }: SignalExperimentProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook for conditional experiment logic
+ *
+ * @example
+ * const { variant, isControl } = useExperimentVariant('pricing-test')
+ *
+ * return isControl
+ *   ? <OldPricing />
+ *   : <NewPricing showAnnual={variant === 'annual_first'} />
+ */
+declare function useExperimentVariant(experimentId: string): {
+    assignment: ExperimentAssignment | null;
+    variant: string | null;
+    isControl: boolean;
+};
+/**
+ * Component for tracking experiment conversions
+ * Wraps interactive elements to track when they convert
+ *
+ * @example
+ * <SignalExperiment experimentId="signup-button" variants={{
+ *   control: (
+ *     <ExperimentConversion experimentId="signup-button" outcomeType="click">
+ *       <Button>Sign Up</Button>
+ *     </ExperimentConversion>
+ *   ),
+ *   variant_a: (
+ *     <ExperimentConversion experimentId="signup-button" outcomeType="click">
+ *       <Button variant="large">Join Now - It's Free!</Button>
+ *     </ExperimentConversion>
+ *   ),
+ * }} />
+ */
+declare function ExperimentConversion({ experimentId, outcomeType, value, children, }: {
+    experimentId: string;
+    outcomeType?: string;
+    value?: number;
+    children: React__default.ReactElement;
+}): React__default.ReactElement<any, string | React__default.JSXElementConstructor<any>>;
+
+/**
+ * @uptrade/site-kit/setup - Conversational Setup Assistant
+ *
+ * AI-powered conversational interface for setting up site-kit.
+ * Uses Echo/Signal to guide users through configuration.
+ *
+ * Features:
+ * - Streaming AI responses for real-time feedback
+ * - Brand extraction from existing websites
+ * - Module recommendations based on business type
+ * - Integration verification
+ * - Copilot instructions generation
+ */
+interface SetupContext {
+    flow: 'new' | 'existing' | 'rebuild' | null;
+    step: string;
+    project_id?: string;
+    org_id?: string;
+    domain?: string;
+    business_type?: string;
+    scan_results?: ScanResults;
+    scrape_results?: ScrapeResults;
+    selected_modules?: string[];
+    brand?: BrandInfo;
+}
+interface ScanResults {
+    forms: {
+        file: string;
+        form_library: string;
+        fields: number;
+    }[];
+    widgets: {
+        file: string;
+        widget_type: string;
+    }[];
+    metadata: {
+        file: string;
+        type: string;
+    }[];
+    sitemaps: {
+        file: string;
+        type: string;
+    }[];
+}
+interface ScrapeResults {
+    scrape_id: string;
+    domain: string;
+    pages_found: number;
+    faqs_imported: number;
+    routes: {
+        path: string;
+        title: string;
+    }[];
+    brand?: BrandInfo;
+}
+interface BrandInfo {
+    business_name: string;
+    tagline?: string;
+    primary_color?: string;
+    secondary_color?: string;
+    logo_url?: string;
+    phone_numbers?: string[];
+    email_addresses?: string[];
+    social_profiles?: Record<string, string>;
+}
+interface SetupState {
+    step: 'welcome' | 'auth' | 'project' | 'modules' | 'config' | 'verify' | 'complete';
+    isAuthenticated: boolean;
+    userEmail?: string;
+    accessToken?: string;
+    selectedOrg?: {
+        id: string;
+        name: string;
+    };
+    selectedProject?: {
+        id: string;
+        name: string;
+        domain: string;
+    };
+    selectedModules: string[];
+    config: Record<string, unknown>;
+    errors: string[];
+    context: SetupContext;
+}
+interface SetupAssistantProps {
+    /** Portal API URL */
+    apiUrl?: string;
+    /** Signal API URL for AI chat */
+    signalUrl?: string;
+    /** Supabase URL for auth */
+    supabaseUrl?: string;
+    /** Supabase anon key */
+    supabaseKey?: string;
+    /** Pre-selected project ID (if coming from Portal) */
+    projectId?: string;
+    /** Pre-selected org ID (if coming from Portal) */
+    orgId?: string;
+    /** Auth token (if already authenticated) */
+    authToken?: string;
+    /** Callback when setup is complete */
+    onComplete?: (config: SetupState) => void;
+    /** Custom welcome message */
+    welcomeMessage?: string;
+}
+declare function SetupAssistant({ apiUrl, signalUrl, supabaseUrl, supabaseKey, projectId, orgId, authToken, onComplete, welcomeMessage, }: SetupAssistantProps): react_jsx_runtime.JSX.Element;
+
+export { type Affiliate, AffiliateCard, type AffiliateCardProps, type AffiliateOffer, type AffiliateWithOffers, AffiliatesWidget, type AffiliatesWidgetProps, type EngageOverride, type ExperimentAssignment, type ExperimentConfig, ExperimentConversion, type ExperimentVariant, type MetaOverride, type PriceOverride, SetupAssistant, SignalBridge, type SignalBridgeProps, type SignalConfig, type SignalContextValue, type SignalEvent, SignalExperiment, type SignalOutcome, type SiteKitConfig, SiteKitProvider, type UseAffiliatesResult, fetchAffiliates, getTrackingUrl, useAffiliates, useExperimentVariant, useSignal, useSignalConfig, useSignalEvent, useSignalExperiment, useSignalOutcome, useSiteKit };