@probat/react 0.2.0 → 0.3.0

package/src/hooks/useProbatMetrics.ts

@@ -1,152 +1,36 @@
 "use client";
 
 import { useCallback } from "react";
-import type { MouseEvent } from "react";
 import { useProbatContext } from "../context/ProbatContext";
-import { sendMetric, extractClickMeta } from "../utils/api";
+import { sendMetric } from "../utils/api";
 
 export interface UseProbatMetricsReturn {
     /**
-     * Track a click event
-     * @param event - Optional React mouse event (will extract metadata automatically)
-     * @param options - Optional configuration
-     * @param options.force - Force tracking even if no actionable element is found
-     * @param options.proposalId - Override the proposal ID (usually not needed)
-     * @param options.variantLabel - Override the variant label (usually not needed)
-     * @param options.dimensions - Additional dimensions to include
+     * Send a custom event with arbitrary properties.
+     * Never throws — failures are silently dropped.
+     *
+     * @example
+     * ```tsx
+     * const { capture } = useProbatMetrics();
+     * capture("purchase", { revenue: 42, currency: "USD" });
+     * ```
      */
-    trackClick: (
-        event?: MouseEvent | null,
-        options?: {
-            force?: boolean;
-            proposalId?: string;
-            variantLabel?: string;
-            dimensions?: Record<string, any>;
-        }
-    ) => boolean;
-    /**
-     * Track a custom metric
-     * @param metricName - Name of the metric
-     * @param proposalId - Proposal ID
-     * @param variantLabel - Variant label (defaults to "control")
-     * @param dimensions - Additional dimensions
-     */
-    trackMetric: (
-        metricName: string,
-        proposalId: string,
-        variantLabel?: string,
-        dimensions?: Record<string, any>
-    ) => void;
-    /**
-     * Track an impression/view
-     * @param proposalId - Proposal ID
-     * @param variantLabel - Variant label (defaults to "control")
-     * @param experimentId - Optional experiment ID
-     */
-    trackImpression: (
-        proposalId: string,
-        variantLabel?: string,
-        experimentId?: string
-    ) => void;
+    capture: (event: string, properties?: Record<string, unknown>) => void;
 }
 
 /**
- * Hook for tracking Probat metrics (clicks, impressions, custom metrics)
- *
- * @example
- * ```tsx
- * const { trackClick, trackImpression } = useProbatMetrics();
- *
- * // Track click on button
- * <button onClick={(e) => trackClick(e)}>Click me</button>
- *
- * // Track impression
- * useEffect(() => {
- *   trackImpression(proposalId, variantLabel, experimentId);
- * }, [proposalId, variantLabel, experimentId]);
- * ```
+ * Minimal metrics hook. Provides a single `capture(event, props)` function
+ * that sends events to the Probat backend using the provider's host config.
  */
 export function useProbatMetrics(): UseProbatMetricsReturn {
-    const { apiBaseUrl } = useProbatContext();
-
-    const trackClick = useCallback(
-        (
-            event?: MouseEvent | null,
-            options?: {
-                force?: boolean;
-                proposalId?: string;
-                variantLabel?: string;
-                dimensions?: Record<string, any>;
-            }
-        ) => {
-            const meta = extractClickMeta(event ?? undefined);
-            if (!options?.force && event && !meta) {
-                return false;
-            }
-
-            const proposalId = options?.proposalId;
-            const variantLabel = options?.variantLabel || "control";
-
-            if (!proposalId) {
-                console.warn(
-                    "[Probat] trackClick called without proposalId. Provide it in options or use useExperiment hook."
-                );
-                return false;
-            }
+    const { host } = useProbatContext();
 
-            void sendMetric(
-                apiBaseUrl,
-                proposalId,
-                "click",
-                variantLabel,
-                undefined,
-                { ...meta, ...options?.dimensions }
-            );
-            return true;
+    const capture = useCallback(
+        (event: string, properties: Record<string, unknown> = {}) => {
+            sendMetric(host, event, properties);
         },
-        [apiBaseUrl]
+        [host]
     );
 
-    const trackMetric = useCallback(
-        (
-            metricName: string,
-            proposalId: string,
-            variantLabel: string = "control",
-            dimensions: Record<string, any> = {}
-        ) => {
-            void sendMetric(
-                apiBaseUrl,
-                proposalId,
-                metricName,
-                variantLabel,
-                undefined,
-                dimensions
-            );
-        },
-        [apiBaseUrl]
-    );
-
-    const trackImpression = useCallback(
-        (
-            proposalId: string,
-            variantLabel: string = "control",
-            experimentId?: string
-        ) => {
-            void sendMetric(
-                apiBaseUrl,
-                proposalId,
-                "visit",
-                variantLabel,
-                experimentId
-            );
-        },
-        [apiBaseUrl]
-    );
-
-    return {
-        trackClick,
-        trackMetric,
-        trackImpression,
-    };
+    return { capture };
 }
-

package/src/index.ts

@@ -1,40 +1,17 @@
 "use client";
 
-// Provider and Context - Default export (works in regular React)
-// Note: These are Client Components - use ProbatProviderClient for Next.js App Router
-export { ProbatProvider, useProbatContext } from "./context/ProbatContext";
-export type { ProbatProviderProps, ProbatContextValue } from "./context/ProbatContext";
-
-// Next.js App Router compatible - Re-export from client component file
-// This ensures "use client" directive is properly recognized
+// ── Provider ───────────────────────────────────────────────────────────────
 export { ProbatProviderClient } from "./components/ProbatProviderClient";
-export type { ProbatProviderProps as ProbatProviderClientProps } from "./components/ProbatProviderClient";
+export type { ProbatProviderProps } from "./context/ProbatContext";
 
-// For convenience: Also export ProbatProvider as default for Next.js
-// Users can import { ProbatProvider } and it will work if they use dynamic import
+// ── Experiment component ───────────────────────────────────────────────────
+export { Experiment } from "./components/Experiment";
+export type { ExperimentProps, ExperimentTrackOptions } from "./components/Experiment";
 
-// Hooks
+// ── Hooks ──────────────────────────────────────────────────────────────────
 export { useProbatMetrics } from "./hooks/useProbatMetrics";
 export type { UseProbatMetricsReturn } from "./hooks/useProbatMetrics";
 
-export { useExperiment } from "./hooks/useExperiment";
-export type { UseExperimentReturn } from "./hooks/useExperiment";
-
-// HOC
-export { withExperiment } from "./hoc/withExperiment";
-export type { WithExperimentOptions } from "./hoc/withExperiment";
-
-// Utilities (exported for advanced use cases)
-export { detectEnvironment } from "./utils/environment";
-export { fetchDecision, sendMetric, extractClickMeta } from "./utils/api";
-export type { RetrieveResponse } from "./utils/api";
-// Heatmap tracking (automatically initialized by ProbatProvider)
-export { initHeatmapTracking, stopHeatmapTracking, getHeatmapTracker } from "./utils/heatmapTracker";
-export {
-    readChoice,
-    writeChoice,
-    hasTrackedVisit,
-    markTrackedVisit,
-} from "./utils/storage";
-export type { Choice } from "./utils/storage";
-
+// ── Utilities (advanced) ───────────────────────────────────────────────────
+export { sendMetric, fetchDecision } from "./utils/api";
+export type { MetricPayload, DecisionResponse } from "./utils/api";