@clianta/sdk 1.6.0 → 1.6.2

package/dist/react.d.ts

@@ -1,36 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ErrorInfo } from 'react';
 
-/**
- * Clianta SDK - CRM API Client
- * @see SDK_VERSION in core/config.ts
- */
-
-type InboundEventType = 'user.registered' | 'user.updated' | 'user.subscribed' | 'user.unsubscribed' | 'contact.created' | 'contact.updated' | 'purchase.completed';
-interface InboundEventPayload {
-    /** Event type (e.g. "user.registered") */
-    event: InboundEventType;
-    /** Contact data — at least email or phone is required */
-    contact: {
-        email?: string;
-        phone?: string;
-        firstName?: string;
-        lastName?: string;
-        company?: string;
-        jobTitle?: string;
-        tags?: string[];
-    };
-    /** Optional extra data stored as customFields on the contact */
-    data?: Record<string, unknown>;
-}
-interface InboundEventResult {
-    success: boolean;
-    contactCreated: boolean;
-    contactId?: string;
-    event: string;
-    error?: string;
-}
-
 /**
  * Clianta SDK - Type Definitions
  * @see SDK_VERSION in core/config.ts
@@ -40,10 +10,6 @@ interface CliantaConfig {
     projectId?: string;
     /** Backend API endpoint URL */
     apiEndpoint?: string;
-    /** Auth token for server-side API access (user JWT) */
-    authToken?: string;
-    /** Workspace API key for server-to-server access (use instead of authToken for external apps) */
-    apiKey?: string;
     /** Enable debug mode with verbose logging */
     debug?: boolean;
     /** Automatically track page views on load and navigation */
@@ -191,24 +157,6 @@ interface TrackerCore {
     onReady(callback: () => void): void;
     /** Check if the SDK is fully initialized and ready */
     isReady(): boolean;
-    /** Get the current visitor's profile from the CRM */
-    getVisitorProfile(): Promise<VisitorProfile | null>;
-    /** Get the current visitor's recent activity */
-    getVisitorActivity(options?: VisitorActivityOptions): Promise<{
-        data: VisitorActivity[];
-        pagination: {
-            page: number;
-            limit: number;
-            total: number;
-            pages: number;
-        };
-    } | null>;
-    /** Get a summarized journey timeline for the current visitor */
-    getVisitorTimeline(): Promise<VisitorTimeline | null>;
-    /** Get engagement metrics for the current visitor */
-    getVisitorEngagement(): Promise<EngagementMetrics | null>;
-    /** Send a server-side inbound event (requires apiKey in config) */
-    sendEvent(payload: InboundEventPayload): Promise<InboundEventResult>;
     /** Create or update a contact by email (upsert) */
     createContact(data: PublicContactData): Promise<PublicCrmResult>;
     /** Update an existing contact by ID (limited fields) */
@@ -219,76 +167,8 @@ interface TrackerCore {
     logActivity(data: PublicActivityData): Promise<PublicCrmResult>;
     /** Create an opportunity (e.g., from "Request Demo" forms) */
     createOpportunity(data: PublicOpportunityData): Promise<PublicCrmResult>;
-}
-interface VisitorProfile {
-    visitorId: string;
-    contactId?: string;
-    email?: string;
-    firstName?: string;
-    lastName?: string;
-    company?: string;
-    jobTitle?: string;
-    phone?: string;
-    status?: string;
-    lifecycleStage?: string;
-    tags?: string[];
-    leadScore?: number;
-    firstSeen?: string;
-    lastSeen?: string;
-    sessionCount?: number;
-    pageViewCount?: number;
-    totalTimeSpent?: number;
-    customFields?: Record<string, unknown>;
-}
-interface VisitorActivity {
-    _id?: string;
-    eventType: string;
-    eventName: string;
-    url: string;
-    properties?: Record<string, unknown>;
-    timestamp: string;
-}
-interface VisitorTimeline {
-    visitorId: string;
-    contactId?: string;
-    firstSeen: string;
-    lastSeen: string;
-    totalSessions: number;
-    totalPageViews: number;
-    totalEvents: number;
-    totalTimeSpentSeconds: number;
-    averageSessionDurationSeconds: number;
-    topPages: Array<{
-        url: string;
-        views: number;
-        avgTimeSeconds?: number;
-    }>;
-    recentActivities: VisitorActivity[];
-    devices: Array<{
-        userAgent: string;
-        lastSeen: string;
-    }>;
-}
-interface EngagementMetrics {
-    visitorId: string;
-    totalTimeOnSiteSeconds: number;
-    averageSessionDurationSeconds: number;
-    totalPageViews: number;
-    totalSessions: number;
-    engagementScore: number;
-    bounceRate: number;
-    lastActiveAt: string;
-    topEvents: Array<{
-        eventType: string;
-        count: number;
-    }>;
-}
-interface VisitorActivityOptions {
-    page?: number;
-    limit?: number;
-    eventType?: string;
-    startDate?: string;
-    endDate?: string;
+    /** Destroy the tracker instance, flush pending events, and clean up plugins */
+    destroy(): Promise<void>;
 }
 interface PublicContactData {
     email: string;
@@ -348,66 +228,42 @@ interface PublicCrmResult {
 }
 
 interface CliantaProviderProps {
-    /** Configuration object (from clianta.config.ts) */
-    config: CliantaConfig;
+    /** Project/workspace ID — the ONLY required prop */
+    projectId: string;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+    /** Full config for advanced usage (optional — most users don't need this) */
+    config?: Omit<CliantaConfig, 'projectId'>;
     /** React children */
     children: ReactNode;
-    /** Optional error handler when the SDK encounters errors */
+    /** Error handler (optional) */
     onError?: (error: Error, errorInfo: ErrorInfo) => void;
 }
 /**
- * CliantaProvider - Wrap your app to enable tracking
+ * CliantaProvider — Plug-and-play tracking for React/Next.js
  *
- * Includes an ErrorBoundary so SDK failures never crash the host app.
+ * Just wrap your app. Everything auto-tracks. Done.
  *
  * @example
- * // In clianta.config.ts:
- * import { CliantaConfig } from '@clianta/sdk';
- *
- * const config: CliantaConfig = {
- *   projectId: 'your-project-id',
- *   apiEndpoint: process.env.NEXT_PUBLIC_CLIANTA_API_ENDPOINT || 'http://localhost:5000',
- *   debug: process.env.NODE_ENV === 'development',
- * };
- *
- * export default config;
- *
- * // In app/layout.tsx or main.tsx:
- * import { CliantaProvider } from '@clianta/sdk/react';
- * import cliantaConfig from '../clianta.config';
- *
- * <CliantaProvider config={cliantaConfig}>
+ * // app/layout.tsx — that's it, one line:
+ * <CliantaProvider projectId={process.env.NEXT_PUBLIC_CLIANTA_ID!}>
  *   {children}
  * </CliantaProvider>
  */
-declare function CliantaProvider({ config, children, onError }: CliantaProviderProps): react_jsx_runtime.JSX.Element;
+declare function CliantaProvider({ projectId, debug, config, children, onError }: CliantaProviderProps): react_jsx_runtime.JSX.Element;
 /**
- * useClianta - Hook to access tracker in any component
- *
- * @example
- * const tracker = useClianta();
- * tracker?.track('button_click', 'CTA Button');
+ * useClianta — Access the tracker instance
  */
 declare function useClianta(): TrackerCore | null;
 /**
- * useCliantaReady - Hook to check if SDK is initialized
- *
- * @example
- * const { isReady, tracker } = useCliantaReady();
- * if (isReady) {
- *   tracker.track('purchase', 'Order', { value: 99 });
- * }
+ * useCliantaReady — Check if SDK is initialized
  */
 declare function useCliantaReady(): {
     isReady: boolean;
     tracker: TrackerCore | null;
 };
 /**
- * useCliantaTrack - Convenience hook for tracking events
- *
- * @example
- * const track = useCliantaTrack();
- * track('purchase', 'Order Completed', { orderId: '123' });
+ * useCliantaTrack — Quick tracking hook
  */
 declare function useCliantaTrack(): (eventType: string, eventName: string, properties?: Record<string, unknown>) => void;