@clianta/sdk 1.6.1 → 1.6.2

package/dist/react.d.ts

@@ -167,6 +167,8 @@ interface TrackerCore {
     logActivity(data: PublicActivityData): Promise<PublicCrmResult>;
     /** Create an opportunity (e.g., from "Request Demo" forms) */
     createOpportunity(data: PublicOpportunityData): Promise<PublicCrmResult>;
+    /** Destroy the tracker instance, flush pending events, and clean up plugins */
+    destroy(): Promise<void>;
 }
 interface PublicContactData {
     email: string;
@@ -226,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;
 

package/dist/react.esm.js

@@ -1,5 +1,5 @@
 /*!
- * Clianta SDK v1.6.1
+ * Clianta SDK v1.6.2
  * (c) 2026 Clianta
  * Released under the MIT License.
  */
@@ -11,7 +11,7 @@ import { createContext, useState, useRef, useEffect, useContext, Component } fro
  * @see SDK_VERSION in core/config.ts
  */
 /** SDK Version */
-const SDK_VERSION = '1.6.1';
+const SDK_VERSION = '1.6.2';
 /** Default API endpoint — reads from env or falls back to localhost */
 const getDefaultApiEndpoint = () => {
     // Build-time env var (works with Next.js, Vite, CRA, etc.)
@@ -29,7 +29,7 @@ const getDefaultApiEndpoint = () => {
     }
     return 'http://localhost:5000';
 };
-/** Core plugins enabled by default */
+/** Core plugins enabled by default — all auto-track with zero config */
 const DEFAULT_PLUGINS = [
     'pageView',
     'forms',
@@ -38,6 +38,8 @@ const DEFAULT_PLUGINS = [
     'engagement',
     'downloads',
     'exitIntent',
+    'errors',
+    'performance',
 ];
 /** Default configuration values */
 const DEFAULT_CONFIG = {
@@ -3213,7 +3215,7 @@ function clianta(workspaceId, config) {
     globalInstance = new Tracker(workspaceId, config);
     return globalInstance;
 }
-// Attach to window for <script> tag usage
+// Attach to window for <script> tag usage + AUTO-INIT
 if (typeof window !== 'undefined') {
     window.clianta = clianta;
     window.Clianta = {
@@ -3221,21 +3223,47 @@ if (typeof window !== 'undefined') {
         Tracker,
         ConsentManager,
     };
+    // ============================================
+    // AUTO-INIT FROM SCRIPT TAG
+    // ============================================
+    // Enables true plug-and-play:
+    //   <script src="clianta.min.js" data-project-id="YOUR_ID"></script>
+    // That's it — everything auto-tracks.
+    const autoInit = () => {
+        const scripts = document.querySelectorAll('script[data-project-id]');
+        const script = scripts[scripts.length - 1]; // last matching script
+        if (!script)
+            return;
+        const projectId = script.getAttribute('data-project-id');
+        if (!projectId)
+            return;
+        const debug = script.hasAttribute('data-debug');
+        const instance = clianta(projectId, { debug });
+        // Expose the auto-initialized instance globally
+        window.__clianta = instance;
+    };
+    // Run after DOM is ready
+    if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', autoInit);
+    }
+    else {
+        autoInit();
+    }
 }
 
 /**
  * Clianta SDK - React Integration
  *
- * Provides CliantaProvider component (with ErrorBoundary) for easy
- * React/Next.js integration using the clianta.config.ts pattern.
+ * TRUE PLUG-AND-PLAY: Just wrap your app with <CliantaProvider projectId="xxx" />
+ * and everything auto-tracks — page views, forms, clicks, scroll, engagement,
+ * downloads, exit intent, errors, performance. Zero manual code needed.
  */
 const CliantaContext = createContext({
     tracker: null,
     isReady: false,
 });
 /**
- * Internal ErrorBoundary to prevent SDK errors from crashing the host app.
- * Catches render-time errors in the provider tree.
+ * Internal ErrorBoundary — SDK crashes never break the host app.
  */
 class CliantaErrorBoundary extends Component {
     constructor(props) {
@@ -3251,56 +3279,39 @@ class CliantaErrorBoundary extends Component {
     }
     render() {
         if (this.state.hasError) {
-            // Render children anyway — SDK failure shouldn't break the host UI
             return this.props.fallback ?? this.props.children;
         }
         return this.props.children;
     }
 }
 /**
- * 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>
  */
-function CliantaProvider({ config, children, onError }) {
+function CliantaProvider({ projectId, debug, config, children, onError }) {
     const [tracker, setTracker] = useState(null);
     const [isReady, setIsReady] = useState(false);
-    // Stable ref to projectId — the only value that truly identifies the tracker
-    const projectIdRef = useRef(config.projectId);
+    const projectIdRef = useRef(projectId);
     useEffect(() => {
-        // Initialize tracker with config
-        const projectId = config.projectId;
         if (!projectId) {
-            console.error('[Clianta] Missing projectId in config. Please add projectId to your clianta.config.ts');
+            console.error('[Clianta] Missing projectId prop on CliantaProvider');
             return;
         }
-        // Only re-initialize if projectId actually changed
         if (projectIdRef.current !== projectId) {
             projectIdRef.current = projectId;
         }
         try {
-            // Extract projectId (handled separately) and pass rest as options
-            const { projectId: _, ...options } = config;
+            const options = {
+                debug: debug ?? false,
+                ...config, // advanced config overrides
+            };
             const instance = clianta(projectId, options);
             setTracker(instance);
             setIsReady(true);
@@ -3309,48 +3320,33 @@ function CliantaProvider({ config, children, onError }) {
             console.error('[Clianta] Failed to initialize SDK:', error);
             onError?.(error, { componentStack: '' });
         }
-        // Cleanup: flush pending events on unmount
         return () => {
             tracker?.flush();
             setIsReady(false);
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [config.projectId]);
+    }, [projectId]);
     return (jsx(CliantaErrorBoundary, { onError: onError, children: jsx(CliantaContext.Provider, { value: { tracker, isReady }, children: children }) }));
 }
 // ============================================
 // HOOKS
 // ============================================
 /**
- * useClianta - Hook to access tracker in any component
- *
- * @example
- * const tracker = useClianta();
- * tracker?.track('button_click', 'CTA Button');
+ * useClianta — Access the tracker instance
  */
 function useClianta() {
     const { tracker } = useContext(CliantaContext);
     return tracker;
 }
 /**
- * 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
  */
 function useCliantaReady() {
     const { tracker, isReady } = useContext(CliantaContext);
     return { isReady, tracker };
 }
 /**
- * useCliantaTrack - Convenience hook for tracking events
- *
- * @example
- * const track = useCliantaTrack();
- * track('purchase', 'Order Completed', { orderId: '123' });
+ * useCliantaTrack — Quick tracking hook
  */
 function useCliantaTrack() {
     const tracker = useClianta();