@sentientui/react 0.1.0

package/dist/next/adaptive-root.d.ts

@@ -0,0 +1,94 @@
+import { ReactNode } from 'react';
+import { SentientConfig, ServerAssignments } from '@sentientui/core';
+
+/** How to render adaptive slots during SSR when assignments are not preloaded. */
+type SsrFallback = 'first' | 'none';
+type AdaptiveProviderProps = {
+    apiKey: string;
+    context: SentientConfig['context'];
+    ingestUrl: string;
+    debug?: boolean;
+    /**
+     * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.
+     * Passed through to `useAssignment` as synchronous initial state so crawlers and
+     * the first paint see real content (recommended for SEO).
+     */
+    initialAssignments?: Record<string, string>;
+    /**
+     * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker
+     * weights on one row — must match `loadAdaptiveAssignments` / session upsert.
+     */
+    sessionSegment?: string;
+    /**
+     * When no `initialAssignments` exist for a component, `'first'` renders
+     * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for
+     * decorative slots marked `clientOnly`.
+     * @default 'first'
+     */
+    ssrFallback?: SsrFallback;
+    /**
+     * Consent gate. When `false` the SDK is not initialised and no events are
+     * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to
+     * initialise and begin tracking.
+     */
+    consent?: boolean;
+    /**
+     * Called once per component the first time a variant is resolved for that
+     * component in this session. Use to forward assignments to your own analytics
+     * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.
+     */
+    onAssignment?: (componentId: string, variantId: string) => void;
+    children: ReactNode;
+};
+
+type PreloadComponent = {
+    id: string;
+    variantIds: string[];
+};
+type AdaptiveRootProps = Omit<AdaptiveProviderProps, 'initialAssignments'> & {
+    /** Slots to resolve on the server before HTML is sent (SEO-safe). */
+    components: PreloadComponent[];
+    /** Server-only key for `/v1/sessions` and `/v1/assign` (usually the same `pk_` as `apiKey`). */
+    serverApiKey: string;
+    /** API base URL without trailing slash, e.g. `https://api.example.com/v1`. */
+    apiBaseUrl: string;
+    /**
+     * App origin for SSR preload requests (must be in the project's `allowed_origins`).
+     * @default `http://localhost:3001` in development
+     */
+    appOrigin?: string;
+    /**
+     * Optional preloaded map; when set, `components` is not fetched (useful for tests
+     * or custom loaders). Normally omit and let `loadAdaptiveAssignments` run.
+     */
+    initialAssignments?: ServerAssignments;
+    children: ReactNode;
+};
+/**
+ * Server Component wrapper: loads assignments, then renders `AdaptiveProvider`
+ * with `initialAssignments` so crawlers and hydration see real variant content.
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { AdaptiveRoot } from '@sentientui/react/next';
+ *
+ * export default function Layout({ children }) {
+ *   return (
+ *     <AdaptiveRoot
+ *       components={[{ id: 'hero_cta', variantIds: ['default', 'accent'] }]}
+ *       serverApiKey={process.env.SENTIENT_API_KEY!}
+ *       apiBaseUrl={process.env.SENTIENT_API_URL!}
+ *       apiKey={process.env.NEXT_PUBLIC_SENTIENT_API_KEY!}
+ *       ingestUrl={process.env.NEXT_PUBLIC_SENTIENT_INGEST_URL!}
+ *       context="saas"
+ *     >
+ *       {children}
+ *     </AdaptiveRoot>
+ *   );
+ * }
+ * ```
+ */
+declare function AdaptiveRoot(props: AdaptiveRootProps): Promise<JSX.Element>;
+
+export { AdaptiveRoot, type AdaptiveRootProps, type PreloadComponent };

package/dist/next/adaptive-root.js

@@ -0,0 +1,105 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+
+// src/next/adaptive-root.tsx
+import { deriveSessionSegment } from "@sentientui/core";
+import { cookies, headers } from "next/headers";
+
+// src/server.ts
+import {
+  preloadAssignments,
+  readSessionCookie
+} from "@sentientui/core";
+function defaultSessionId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+async function loadAdaptiveAssignments(components, options) {
+  var _a, _b, _c;
+  const sessionId = (_c = (_b = readSessionCookie(options.cookies)) != null ? _b : (_a = options.createSessionId) == null ? void 0 : _a.call(options)) != null ? _c : defaultSessionId();
+  return preloadAssignments(components, sessionId, {
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl,
+    origin: options.origin,
+    userAgent: options.userAgent,
+    referer: options.referer
+  });
+}
+
+// src/next/adaptive-root.tsx
+import { AdaptiveRootClient } from "./adaptive-root-client.js";
+import { jsx } from "react/jsx-runtime";
+async function AdaptiveRoot(props) {
+  var _b, _c;
+  const _a = props, {
+    components,
+    serverApiKey,
+    apiBaseUrl,
+    appOrigin,
+    initialAssignments: initialAssignmentsOverride,
+    children
+  } = _a, providerProps = __objRest(_a, [
+    "components",
+    "serverApiKey",
+    "apiBaseUrl",
+    "appOrigin",
+    "initialAssignments",
+    "children"
+  ]);
+  const headerStore = await headers();
+  const resolvedOrigin = appOrigin != null ? appOrigin : "http://localhost:3001";
+  const userAgent = (_b = headerStore.get("user-agent")) != null ? _b : void 0;
+  const referer = (_c = headerStore.get("referer")) != null ? _c : void 0;
+  const sessionSegment = deriveSessionSegment({ userAgent, referer, appOrigin: resolvedOrigin });
+  const initialAssignments = initialAssignmentsOverride != null ? initialAssignmentsOverride : await loadAdaptiveAssignments(components, {
+    cookies: await cookies(),
+    apiKey: serverApiKey,
+    baseUrl: apiBaseUrl,
+    origin: resolvedOrigin,
+    userAgent,
+    referer
+  });
+  return /* @__PURE__ */ jsx(
+    AdaptiveRootClient,
+    __spreadProps(__spreadValues({}, providerProps), {
+      initialAssignments,
+      sessionSegment,
+      children
+    })
+  );
+}
+export {
+  AdaptiveRoot
+};
+//# sourceMappingURL=adaptive-root.js.map

package/dist/next/adaptive-root.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/next/adaptive-root.tsx","../../src/server.ts"],"sourcesContent":["import { deriveSessionSegment } from '@sentientui/core';\nimport { cookies, headers } from 'next/headers';\nimport type { ReactNode } from 'react';\nimport type { AdaptiveProviderProps } from '../provider.js';\nimport { loadAdaptiveAssignments, type ServerAssignments } from '../server.js';\nimport { AdaptiveRootClient } from './adaptive-root-client.js';\n\nexport type PreloadComponent = { id: string; variantIds: string[] };\n\nexport type AdaptiveRootProps = Omit<AdaptiveProviderProps, 'initialAssignments'> & {\n  /** Slots to resolve on the server before HTML is sent (SEO-safe). */\n  components: PreloadComponent[];\n  /** Server-only key for `/v1/sessions` and `/v1/assign` (usually the same `pk_` as `apiKey`). */\n  serverApiKey: string;\n  /** API base URL without trailing slash, e.g. `https://api.example.com/v1`. */\n  apiBaseUrl: string;\n  /**\n   * App origin for SSR preload requests (must be in the project's `allowed_origins`).\n   * @default `http://localhost:3001` in development\n   */\n  appOrigin?: string;\n  /**\n   * Optional preloaded map; when set, `components` is not fetched (useful for tests\n   * or custom loaders). Normally omit and let `loadAdaptiveAssignments` run.\n   */\n  initialAssignments?: ServerAssignments;\n  children: ReactNode;\n};\n\n/**\n * Server Component wrapper: loads assignments, then renders `AdaptiveProvider`\n * with `initialAssignments` so crawlers and hydration see real variant content.\n *\n * @example\n * ```tsx\n * // app/layout.tsx\n * import { AdaptiveRoot } from '@sentientui/react/next';\n *\n * export default function Layout({ children }) {\n *   return (\n *     <AdaptiveRoot\n *       components={[{ id: 'hero_cta', variantIds: ['default', 'accent'] }]}\n *       serverApiKey={process.env.SENTIENT_API_KEY!}\n *       apiBaseUrl={process.env.SENTIENT_API_URL!}\n *       apiKey={process.env.NEXT_PUBLIC_SENTIENT_API_KEY!}\n *       ingestUrl={process.env.NEXT_PUBLIC_SENTIENT_INGEST_URL!}\n *       context=\"saas\"\n *     >\n *       {children}\n *     </AdaptiveRoot>\n *   );\n * }\n * ```\n */\nexport async function AdaptiveRoot(props: AdaptiveRootProps): Promise<JSX.Element> {\n  const {\n    components,\n    serverApiKey,\n    apiBaseUrl,\n    appOrigin,\n    initialAssignments: initialAssignmentsOverride,\n    children,\n    ...providerProps\n  } = props;\n\n  const headerStore = await headers();\n  const resolvedOrigin = appOrigin ?? 'http://localhost:3001';\n  const userAgent = headerStore.get('user-agent') ?? undefined;\n  const referer = headerStore.get('referer') ?? undefined;\n  const sessionSegment = deriveSessionSegment({ userAgent, referer, appOrigin: resolvedOrigin });\n  const initialAssignments =\n    initialAssignmentsOverride ??\n    (await loadAdaptiveAssignments(components, {\n      cookies: await cookies(),\n      apiKey: serverApiKey,\n      baseUrl: apiBaseUrl,\n      origin: resolvedOrigin,\n      userAgent,\n      referer,\n    }));\n\n  return (\n    <AdaptiveRootClient\n      {...providerProps}\n      initialAssignments={initialAssignments}\n      sessionSegment={sessionSegment}\n    >\n      {children}\n    </AdaptiveRootClient>\n  );\n}\n","/**\n * Server-only helpers for Next.js / SSR. No React or DOM APIs.\n */\nimport {\n  preloadAssignments,\n  readSessionCookie,\n  type ServerAssignConfig,\n  type ServerAssignments,\n} from '@sentientui/core';\n\nexport { preloadAssignments, readSessionCookie };\nexport type { ServerAssignConfig, ServerAssignments };\n\nexport type LoadAdaptiveAssignmentsOptions = {\n  /** Next.js `cookies()` return value, or any object with `get(name)`. */\n  cookies: { get(name: string): { value: string } | undefined };\n  apiKey: string;\n  baseUrl: string;\n  /** Used when `_snt_uid` is absent (e.g. first visit, many crawlers). */\n  createSessionId?: () => string;\n  /** Must match a value in the project's `allowed_origins` (e.g. `http://localhost:3001`). */\n  origin?: string;\n  /** From Next.js `headers().get('user-agent')` — aligns SSR segment with the client. */\n  userAgent?: string;\n  /** From Next.js `headers().get('referer')`. */\n  referer?: string;\n};\n\nfunction defaultSessionId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  }\n  return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n\n/**\n * Fetches bandit assignments on the server for SEO-safe HTML.\n * Pass the result as `initialAssignments` on `<AdaptiveProvider>`.\n */\nexport async function loadAdaptiveAssignments(\n  components: Array<{ id: string; variantIds: string[] }>,\n  options: LoadAdaptiveAssignmentsOptions,\n): Promise<ServerAssignments> {\n  const sessionId =\n    readSessionCookie(options.cookies) ??\n    options.createSessionId?.() ??\n    defaultSessionId();\n\n  return preloadAssignments(components, sessionId, {\n    apiKey: options.apiKey,\n    baseUrl: options.baseUrl,\n    origin: options.origin,\n    userAgent: options.userAgent,\n    referer: options.referer,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,4BAA4B;AACrC,SAAS,SAAS,eAAe;;;ACEjC;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAoBP,SAAS,mBAA2B;AAClC,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY;AAC5E,WAAO,OAAO,WAAW;AAAA,EAC3B;AACA,SAAO,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACrE;AAMA,eAAsB,wBACpB,YACA,SAC4B;AA1C9B;AA2CE,QAAM,aACJ,6BAAkB,QAAQ,OAAO,MAAjC,aACA,aAAQ,oBAAR,qCADA,YAEA,iBAAiB;AAEnB,SAAO,mBAAmB,YAAY,WAAW;AAAA,IAC/C,QAAQ,QAAQ;AAAA,IAChB,SAAS,QAAQ;AAAA,IACjB,QAAQ,QAAQ;AAAA,IAChB,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ;AAAA,EACnB,CAAC;AACH;;;ADlDA,SAAS,0BAA0B;AA6E/B;AA5BJ,eAAsB,aAAa,OAAgD;AAtDnF;AAuDE,QAQI,YAPF;AAAA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,oBAAoB;AAAA,IACpB;AAAA,EA7DJ,IA+DM,IADC,0BACD,IADC;AAAA,IANH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAIF,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,iBAAiB,gCAAa;AACpC,QAAM,aAAY,iBAAY,IAAI,YAAY,MAA5B,YAAiC;AACnD,QAAM,WAAU,iBAAY,IAAI,SAAS,MAAzB,YAA8B;AAC9C,QAAM,iBAAiB,qBAAqB,EAAE,WAAW,SAAS,WAAW,eAAe,CAAC;AAC7F,QAAM,qBACJ,kEACC,MAAM,wBAAwB,YAAY;AAAA,IACzC,SAAS,MAAM,QAAQ;AAAA,IACvB,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,EACF,CAAC;AAEH,SACE;AAAA,IAAC;AAAA,qCACK,gBADL;AAAA,MAEC;AAAA,MACA;AAAA,MAEC;AAAA;AAAA,EACH;AAEJ;","names":[]}

package/dist/server.d.cts

@@ -0,0 +1,35 @@
+import { ServerAssignments } from '@sentientui/core';
+export { ServerAssignConfig, ServerAssignments, preloadAssignments, readSessionCookie } from '@sentientui/core';
+
+/**
+ * Server-only helpers for Next.js / SSR. No React or DOM APIs.
+ */
+
+type LoadAdaptiveAssignmentsOptions = {
+    /** Next.js `cookies()` return value, or any object with `get(name)`. */
+    cookies: {
+        get(name: string): {
+            value: string;
+        } | undefined;
+    };
+    apiKey: string;
+    baseUrl: string;
+    /** Used when `_snt_uid` is absent (e.g. first visit, many crawlers). */
+    createSessionId?: () => string;
+    /** Must match a value in the project's `allowed_origins` (e.g. `http://localhost:3001`). */
+    origin?: string;
+    /** From Next.js `headers().get('user-agent')` — aligns SSR segment with the client. */
+    userAgent?: string;
+    /** From Next.js `headers().get('referer')`. */
+    referer?: string;
+};
+/**
+ * Fetches bandit assignments on the server for SEO-safe HTML.
+ * Pass the result as `initialAssignments` on `<AdaptiveProvider>`.
+ */
+declare function loadAdaptiveAssignments(components: Array<{
+    id: string;
+    variantIds: string[];
+}>, options: LoadAdaptiveAssignmentsOptions): Promise<ServerAssignments>;
+
+export { type LoadAdaptiveAssignmentsOptions, loadAdaptiveAssignments };

package/dist/server.d.ts

@@ -0,0 +1,35 @@
+import { ServerAssignments } from '@sentientui/core';
+export { ServerAssignConfig, ServerAssignments, preloadAssignments, readSessionCookie } from '@sentientui/core';
+
+/**
+ * Server-only helpers for Next.js / SSR. No React or DOM APIs.
+ */
+
+type LoadAdaptiveAssignmentsOptions = {
+    /** Next.js `cookies()` return value, or any object with `get(name)`. */
+    cookies: {
+        get(name: string): {
+            value: string;
+        } | undefined;
+    };
+    apiKey: string;
+    baseUrl: string;
+    /** Used when `_snt_uid` is absent (e.g. first visit, many crawlers). */
+    createSessionId?: () => string;
+    /** Must match a value in the project's `allowed_origins` (e.g. `http://localhost:3001`). */
+    origin?: string;
+    /** From Next.js `headers().get('user-agent')` — aligns SSR segment with the client. */
+    userAgent?: string;
+    /** From Next.js `headers().get('referer')`. */
+    referer?: string;
+};
+/**
+ * Fetches bandit assignments on the server for SEO-safe HTML.
+ * Pass the result as `initialAssignments` on `<AdaptiveProvider>`.
+ */
+declare function loadAdaptiveAssignments(components: Array<{
+    id: string;
+    variantIds: string[];
+}>, options: LoadAdaptiveAssignmentsOptions): Promise<ServerAssignments>;
+
+export { type LoadAdaptiveAssignmentsOptions, loadAdaptiveAssignments };

package/dist/server.js

@@ -0,0 +1,52 @@
+"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, {
+  loadAdaptiveAssignments: () => loadAdaptiveAssignments,
+  preloadAssignments: () => import_core.preloadAssignments,
+  readSessionCookie: () => import_core.readSessionCookie
+});
+module.exports = __toCommonJS(server_exports);
+var import_core = require("@sentientui/core");
+function defaultSessionId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+async function loadAdaptiveAssignments(components, options) {
+  var _a, _b, _c;
+  const sessionId = (_c = (_b = (0, import_core.readSessionCookie)(options.cookies)) != null ? _b : (_a = options.createSessionId) == null ? void 0 : _a.call(options)) != null ? _c : defaultSessionId();
+  return (0, import_core.preloadAssignments)(components, sessionId, {
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl,
+    origin: options.origin,
+    userAgent: options.userAgent,
+    referer: options.referer
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadAdaptiveAssignments,
+  preloadAssignments,
+  readSessionCookie
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\n * Server-only helpers for Next.js / SSR. No React or DOM APIs.\n */\nimport {\n  preloadAssignments,\n  readSessionCookie,\n  type ServerAssignConfig,\n  type ServerAssignments,\n} from '@sentientui/core';\n\nexport { preloadAssignments, readSessionCookie };\nexport type { ServerAssignConfig, ServerAssignments };\n\nexport type LoadAdaptiveAssignmentsOptions = {\n  /** Next.js `cookies()` return value, or any object with `get(name)`. */\n  cookies: { get(name: string): { value: string } | undefined };\n  apiKey: string;\n  baseUrl: string;\n  /** Used when `_snt_uid` is absent (e.g. first visit, many crawlers). */\n  createSessionId?: () => string;\n  /** Must match a value in the project's `allowed_origins` (e.g. `http://localhost:3001`). */\n  origin?: string;\n  /** From Next.js `headers().get('user-agent')` — aligns SSR segment with the client. */\n  userAgent?: string;\n  /** From Next.js `headers().get('referer')`. */\n  referer?: string;\n};\n\nfunction defaultSessionId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  }\n  return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n\n/**\n * Fetches bandit assignments on the server for SEO-safe HTML.\n * Pass the result as `initialAssignments` on `<AdaptiveProvider>`.\n */\nexport async function loadAdaptiveAssignments(\n  components: Array<{ id: string; variantIds: string[] }>,\n  options: LoadAdaptiveAssignmentsOptions,\n): Promise<ServerAssignments> {\n  const sessionId =\n    readSessionCookie(options.cookies) ??\n    options.createSessionId?.() ??\n    defaultSessionId();\n\n  return preloadAssignments(components, sessionId, {\n    apiKey: options.apiKey,\n    baseUrl: options.baseUrl,\n    origin: options.origin,\n    userAgent: options.userAgent,\n    referer: options.referer,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAKO;AAoBP,SAAS,mBAA2B;AAClC,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY;AAC5E,WAAO,OAAO,WAAW;AAAA,EAC3B;AACA,SAAO,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACrE;AAMA,eAAsB,wBACpB,YACA,SAC4B;AA1C9B;AA2CE,QAAM,aACJ,8CAAkB,QAAQ,OAAO,MAAjC,aACA,aAAQ,oBAAR,qCADA,YAEA,iBAAiB;AAEnB,aAAO,gCAAmB,YAAY,WAAW;AAAA,IAC/C,QAAQ,QAAQ;AAAA,IAChB,SAAS,QAAQ;AAAA,IACjB,QAAQ,QAAQ;AAAA,IAChB,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ;AAAA,EACnB,CAAC;AACH;","names":[]}

package/dist/server.mjs

@@ -0,0 +1,28 @@
+// src/server.ts
+import {
+  preloadAssignments,
+  readSessionCookie
+} from "@sentientui/core";
+function defaultSessionId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+async function loadAdaptiveAssignments(components, options) {
+  var _a, _b, _c;
+  const sessionId = (_c = (_b = readSessionCookie(options.cookies)) != null ? _b : (_a = options.createSessionId) == null ? void 0 : _a.call(options)) != null ? _c : defaultSessionId();
+  return preloadAssignments(components, sessionId, {
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl,
+    origin: options.origin,
+    userAgent: options.userAgent,
+    referer: options.referer
+  });
+}
+export {
+  loadAdaptiveAssignments,
+  preloadAssignments,
+  readSessionCookie
+};
+//# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\n * Server-only helpers for Next.js / SSR. No React or DOM APIs.\n */\nimport {\n  preloadAssignments,\n  readSessionCookie,\n  type ServerAssignConfig,\n  type ServerAssignments,\n} from '@sentientui/core';\n\nexport { preloadAssignments, readSessionCookie };\nexport type { ServerAssignConfig, ServerAssignments };\n\nexport type LoadAdaptiveAssignmentsOptions = {\n  /** Next.js `cookies()` return value, or any object with `get(name)`. */\n  cookies: { get(name: string): { value: string } | undefined };\n  apiKey: string;\n  baseUrl: string;\n  /** Used when `_snt_uid` is absent (e.g. first visit, many crawlers). */\n  createSessionId?: () => string;\n  /** Must match a value in the project's `allowed_origins` (e.g. `http://localhost:3001`). */\n  origin?: string;\n  /** From Next.js `headers().get('user-agent')` — aligns SSR segment with the client. */\n  userAgent?: string;\n  /** From Next.js `headers().get('referer')`. */\n  referer?: string;\n};\n\nfunction defaultSessionId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return crypto.randomUUID();\n  }\n  return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n\n/**\n * Fetches bandit assignments on the server for SEO-safe HTML.\n * Pass the result as `initialAssignments` on `<AdaptiveProvider>`.\n */\nexport async function loadAdaptiveAssignments(\n  components: Array<{ id: string; variantIds: string[] }>,\n  options: LoadAdaptiveAssignmentsOptions,\n): Promise<ServerAssignments> {\n  const sessionId =\n    readSessionCookie(options.cookies) ??\n    options.createSessionId?.() ??\n    defaultSessionId();\n\n  return preloadAssignments(components, sessionId, {\n    apiKey: options.apiKey,\n    baseUrl: options.baseUrl,\n    origin: options.origin,\n    userAgent: options.userAgent,\n    referer: options.referer,\n  });\n}\n"],"mappings":";AAGA;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAoBP,SAAS,mBAA2B;AAClC,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY;AAC5E,WAAO,OAAO,WAAW;AAAA,EAC3B;AACA,SAAO,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACrE;AAMA,eAAsB,wBACpB,YACA,SAC4B;AA1C9B;AA2CE,QAAM,aACJ,6BAAkB,QAAQ,OAAO,MAAjC,aACA,aAAQ,oBAAR,qCADA,YAEA,iBAAiB;AAEnB,SAAO,mBAAmB,YAAY,WAAW;AAAA,IAC/C,QAAQ,QAAQ;AAAA,IAChB,SAAS,QAAQ;AAAA,IACjB,QAAQ,QAAQ;AAAA,IAChB,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ;AAAA,EACnB,CAAC;AACH;","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@sentientui/react",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "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"
+    },
+    "./next": {
+      "types": "./dist/next/adaptive-root.d.ts",
+      "import": "./dist/next/adaptive-root.js",
+      "default": "./dist/next/adaptive-root.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@sentientui/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "next": ">=14.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^18.3.12",
+    "jsdom": "^25.0.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
+    "size-check": "tsx scripts/size-check.ts",
+    "lint": "eslint src"
+  }
+}