@experiwall/react 0.2.1 → 0.3.1

package/dist/server.d.mts

@@ -0,0 +1,46 @@
+/**
+ * Server-side helpers for Experiwall.
+ *
+ * Use this module in Next.js server components, Route Handlers,
+ * or any server runtime to resolve experiments during SSR —
+ * the variant is in the initial HTML with zero loading state.
+ *
+ * ```ts
+ * import { fetchExperiments } from "@experiwall/react/server";
+ *
+ * // In a server component:
+ * const { assignments } = await fetchExperiments({
+ *   apiKey: "ew_pub_...",
+ *   aliasId: cookies().get("ew_anon_id")?.value,
+ * });
+ * const variant = assignments["my-experiment"] ?? "control";
+ * ```
+ */
+interface ServerConfig {
+    apiKey: string;
+    baseUrl?: string;
+    userId?: string;
+    aliasId?: string;
+    environment?: string;
+}
+interface ExperimentsResponse {
+    user_seed: number;
+    assignments: Record<string, string>;
+    experiments?: Record<string, {
+        variants: {
+            key: string;
+            weight: number;
+        }[];
+    }>;
+}
+/**
+ * Fetch experiment assignments from the Experiwall API.
+ *
+ * Call this from server components to resolve variants at SSR time.
+ * Pass a `userId` or `aliasId` to identify the visitor (e.g. from a cookie).
+ * If neither is provided, a random ID is generated automatically so the
+ * call always succeeds (useful on first visit before a cookie is set).
+ */
+declare function fetchExperiments(config: ServerConfig): Promise<ExperimentsResponse>;
+
+export { type ExperimentsResponse, type ServerConfig, fetchExperiments };

package/dist/server.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Server-side helpers for Experiwall.
+ *
+ * Use this module in Next.js server components, Route Handlers,
+ * or any server runtime to resolve experiments during SSR —
+ * the variant is in the initial HTML with zero loading state.
+ *
+ * ```ts
+ * import { fetchExperiments } from "@experiwall/react/server";
+ *
+ * // In a server component:
+ * const { assignments } = await fetchExperiments({
+ *   apiKey: "ew_pub_...",
+ *   aliasId: cookies().get("ew_anon_id")?.value,
+ * });
+ * const variant = assignments["my-experiment"] ?? "control";
+ * ```
+ */
+interface ServerConfig {
+    apiKey: string;
+    baseUrl?: string;
+    userId?: string;
+    aliasId?: string;
+    environment?: string;
+}
+interface ExperimentsResponse {
+    user_seed: number;
+    assignments: Record<string, string>;
+    experiments?: Record<string, {
+        variants: {
+            key: string;
+            weight: number;
+        }[];
+    }>;
+}
+/**
+ * Fetch experiment assignments from the Experiwall API.
+ *
+ * Call this from server components to resolve variants at SSR time.
+ * Pass a `userId` or `aliasId` to identify the visitor (e.g. from a cookie).
+ * If neither is provided, a random ID is generated automatically so the
+ * call always succeeds (useful on first visit before a cookie is set).
+ */
+declare function fetchExperiments(config: ServerConfig): Promise<ExperimentsResponse>;
+
+export { type ExperimentsResponse, type ServerConfig, fetchExperiments };

package/dist/server.js

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  fetchExperiments: () => fetchExperiments
+});
+module.exports = __toCommonJS(server_exports);
+var DEFAULT_BASE_URL = "https://www.experiwall.com";
+async function fetchExperiments(config) {
+  const base = config.baseUrl ?? DEFAULT_BASE_URL;
+  const url = new URL("/api/sdk/init", base);
+  const aliasId = config.aliasId ?? (!config.userId ? crypto.randomUUID() : void 0);
+  if (config.userId) url.searchParams.set("user_id", config.userId);
+  if (aliasId) url.searchParams.set("alias_id", aliasId);
+  if (config.environment) url.searchParams.set("environment", config.environment);
+  const res = await fetch(url.toString(), {
+    headers: { "x-api-key": config.apiKey },
+    cache: "no-store"
+  });
+  if (!res.ok) {
+    throw new Error(`Experiwall API error: ${res.status}`);
+  }
+  return res.json();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fetchExperiments
+});

package/dist/server.mjs

@@ -0,0 +1,21 @@
+// src/server.ts
+var DEFAULT_BASE_URL = "https://www.experiwall.com";
+async function fetchExperiments(config) {
+  const base = config.baseUrl ?? DEFAULT_BASE_URL;
+  const url = new URL("/api/sdk/init", base);
+  const aliasId = config.aliasId ?? (!config.userId ? crypto.randomUUID() : void 0);
+  if (config.userId) url.searchParams.set("user_id", config.userId);
+  if (aliasId) url.searchParams.set("alias_id", aliasId);
+  if (config.environment) url.searchParams.set("environment", config.environment);
+  const res = await fetch(url.toString(), {
+    headers: { "x-api-key": config.apiKey },
+    cache: "no-store"
+  });
+  if (!res.ok) {
+    throw new Error(`Experiwall API error: ${res.status}`);
+  }
+  return res.json();
+}
+export {
+  fetchExperiments
+};

package/package.json

@@ -1,16 +1,28 @@
 {
   "name": "@experiwall/react",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Experiwall React SDK — code-first experimentation and A/B testing",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js"
+    }
+  },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch"
+    "build": "tsup src/index.ts src/server.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts src/server.ts --format cjs,esm --dts --watch"
   },
   "peerDependencies": {
     "react": ">=18",