@cascayd/experiment 0.3.22 → 0.3.24

package/dist/react/Experiment.d.ts

@@ -1,4 +1,4 @@
-import type { ReactElement } from 'react';
+import type { ReactElement } from "react";
 export type ExperimentProps = {
     id: string;
     children: React.ReactNode;

package/dist/react/Experiment.js

@@ -1,28 +1,30 @@
-import { useEffect, useMemo, useRef, useState } from 'react';
-import { getVariantStatus } from '../http';
-import { record } from '../client';
-import { getOrCreateSession, persistVariantChoice, readVariantChoice } from '../cookies';
-import { buildWeights, chooseByWeightDeterministic, resolveVariant } from '../assignment';
-const sentImpressions = new Set();
+"use client";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { getVariantStatus } from "../http";
+import { record } from "../client";
+import { getOrCreateSession, persistVariantChoice, readVariantChoice } from "../cookies";
+import { buildWeights, chooseByWeightDeterministic, resolveVariant } from "../assignment";
 export function Experiment({ id, children }) {
-    const [active, setActive] = useState(null);
-    const hasRunRef = useRef(false);
     const childrenArray = useMemo(() => {
         const arr = [];
         for (const child of [].concat(children)) {
-            if (!child || child.type?.displayName !== 'CascaydVariant')
+            if (!child || child.type?.displayName !== "CascaydVariant")
                 continue;
             arr.push({ id: child.props.id, weight: child.props.weight, element: child });
         }
         return arr;
     }, [children]);
+    // Always render control initially (deterministic for SSR + hydration)
+    const initial = useMemo(() => resolveVariant("control", childrenArray), [childrenArray]);
+    const [active, setActive] = useState(initial);
+    const hasRunRef = useRef(false);
+    const sentImpressionsRef = useRef(new Set());
     useEffect(() => {
         if (hasRunRef.current)
             return;
         hasRunRef.current = true;
         let cancelled = false;
         const existing = readVariantChoice(id);
-        // Create or read a stable session id first
         const sessionId = getOrCreateSession();
         void (async () => {
             try {
@@ -33,14 +35,14 @@ export function Experiment({ id, children }) {
                             return;
                         const serving = resolveVariant(status.serving_variant_id || existing, childrenArray);
                         applyAssignment(id, serving, setActive);
-                        sendImpression(id, serving);
+                        sendImpression(id, serving, sentImpressionsRef.current);
                         return;
                     }
                     catch {
-                        // fall through to base assignment
+                        // fall through
                     }
                 }
-                const baseStatus = await getVariantStatus(id, 'control');
+                const baseStatus = await getVariantStatus(id, "control");
                 if (cancelled)
                     return;
                 const weighted = buildWeights(childrenArray, baseStatus.weights);
@@ -57,24 +59,21 @@ export function Experiment({ id, children }) {
                 }
                 const serving = resolveVariant(finalVariant, childrenArray);
                 applyAssignment(id, serving, setActive);
-                sendImpression(id, serving);
+                sendImpression(id, serving, sentImpressionsRef.current);
             }
-            catch (err) {
-                // last-ditch fallback, deterministic equal weight using session id
+            catch {
                 const weighted = buildWeights(childrenArray, undefined);
                 const chosen = chooseByWeightDeterministic(weighted, id, sessionId);
                 if (cancelled)
                     return;
                 applyAssignment(id, chosen, setActive);
-                sendImpression(id, chosen);
+                sendImpression(id, chosen, sentImpressionsRef.current);
             }
         })();
         return () => {
             cancelled = true;
         };
     }, [id, childrenArray]);
-    if (!active)
-        return null;
     const match = childrenArray.find((c) => c.id === active);
     return match ? match.element : null;
 }
@@ -82,11 +81,12 @@ function applyAssignment(experimentId, variantId, setActive) {
     persistVariantChoice(experimentId, variantId);
     setActive(variantId);
 }
-function sendImpression(experimentId, variantId) {
+function sendImpression(experimentId, variantId, sent) {
     if (!variantId)
         return;
-    if (sentImpressions.has(`${experimentId}:${variantId}`))
+    const key = `${experimentId}:${variantId}`;
+    if (sent.has(key))
         return;
-    sentImpressions.add(`${experimentId}:${variantId}`);
-    void record('impression', { experimentId, variantId });
+    sent.add(key);
+    void record("impression", { experimentId, variantId });
 }

package/dist/react/Variant.d.ts

@@ -3,7 +3,7 @@ export type VariantProps = {
     weight?: number;
     children?: React.ReactNode;
 };
-export declare function Variant({ id, children }: VariantProps): import("react/jsx-runtime").JSX.Element;
+export declare function Variant({ children }: VariantProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Variant {
     var displayName: string;
 }

package/dist/react/Variant.js

@@ -1,5 +1,6 @@
+"use client";
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-export function Variant({ id, children }) {
+export function Variant({ children }) {
     return _jsx(_Fragment, { children: children });
 }
-Variant.displayName = 'CascaydVariant';
+Variant.displayName = "CascaydVariant";

package/dist/react/index.d.ts

@@ -0,0 +1,4 @@
+export { Experiment } from './Experiment';
+export { Variant } from './Variant';
+export type { ExperimentProps } from './Experiment';
+export type { VariantProps } from './Variant';

package/dist/react/index.js

@@ -0,0 +1,2 @@
+export { Experiment } from './Experiment';
+export { Variant } from './Variant';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascayd/experiment",
-  "version": "0.3.22",
+  "version": "0.3.24",
   "description": "A lightweight A/B testing SDK for React applications with server-side analytics integration",
   "keywords": [
     "ab-testing",