@sentientui/react 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist/index.js.map +1 -1
  2. package/dist/index.mjs.map +1 -1
  3. package/dist/next/adaptive-root-client.js.map +1 -1
  4. package/dist/next/adaptive-root.js.map +1 -1
  5. package/dist/server.js.map +1 -1
  6. package/dist/server.mjs.map +1 -1
  7. package/package.json +58 -59
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/adaptive.tsx","../src/use-assignment.ts","../src/weights-store.ts","../src/segment.ts"],"sourcesContent":["export { AdaptiveProvider, useSentient, useInitialAssignments } from './provider.js';\r\nexport type { AdaptiveProviderProps, SsrFallback } from './provider.js';\r\n\r\nexport { Adaptive } from './adaptive.js';\r\nexport type {\r\n AdaptiveProps,\r\n GoalConfig,\r\n ClickGoal,\r\n ScrollDepthGoal,\r\n FormSubmitGoal,\r\n CompositeGoal,\r\n} from './adaptive.js';\r\n\r\nexport { useAssignment } from './use-assignment.js';\r\nexport type { AssignmentState } from './use-assignment.js';\r\n\r\nexport {\r\n subscribe as subscribeWeights,\r\n update as updateWeights,\r\n getWeights,\r\n} from './weights-store.js';\r\nexport type { ComponentWeights, VariantWeight } from './weights-store.js';\r\n\r\nexport { detectSegment } from './segment.js';\r\n","'use client';\n\nimport { createContext, useContext, useEffect, useState, type ReactNode } from 'react';\nimport { init, type SentientClient, type SentientConfig } from '@sentientui/core';\n\n/** How to render adaptive slots during SSR when assignments are not preloaded. */\nexport type SsrFallback = 'first' | 'none';\n\ntype AdaptiveContextValue = {\n client: SentientClient | null;\n projectId: string;\n initialAssignments: Record<string, string>;\n sessionSegment: string;\n ssrFallback: SsrFallback;\n onAssignment: ((componentId: string, variantId: string) => void) | undefined;\n};\n\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\n client: null,\n projectId: '',\n initialAssignments: {},\n sessionSegment: 'desktop:direct',\n ssrFallback: 'first',\n onAssignment: undefined,\n});\n\nexport type AdaptiveProviderProps = {\n apiKey: string;\n context: SentientConfig['context'];\n ingestUrl: string;\n debug?: boolean;\n /**\n * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.\n * Passed through to `useAssignment` as synchronous initial state so crawlers and\n * the first paint see real content (recommended for SEO).\n */\n initialAssignments?: Record<string, string>;\n /**\n * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker\n * weights on one row — must match `loadAdaptiveAssignments` / session upsert.\n */\n sessionSegment?: string;\n /**\n * When no `initialAssignments` exist for a component, `'first'` renders\n * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for\n * decorative slots marked `clientOnly`.\n * @default 'first'\n */\n ssrFallback?: SsrFallback;\n /**\n * Consent gate. When `false` the SDK is not initialised and no events are\n * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to\n * initialise and begin tracking.\n */\n consent?: boolean;\n /**\n * Called once per component the first time a variant is resolved for that\n * component in this session. Use to forward assignments to your own analytics\n * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.\n */\n onAssignment?: (componentId: string, variantId: string) => void;\n children: ReactNode;\n};\n\n/**\n * Initialises the Sentient core SDK in a useEffect (SSR-safe) and exposes the\n * client via React context. Re-initialises when `consent` changes.\n */\nexport function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element {\n const [client, setClient] = useState<SentientClient | null>(null);\n\n useEffect(() => {\n // When consent is explicitly false, tear down any existing client.\n if (props.consent === false) {\n setClient((prev) => {\n prev?.destroy();\n return null;\n });\n return;\n }\n\n const c = init({\n apiKey: props.apiKey,\n context: props.context,\n ingestUrl: props.ingestUrl,\n debug: props.debug,\n initialAssignments: props.initialAssignments,\n sessionSegment: props.sessionSegment,\n consent: props.consent,\n });\n setClient(c);\n return () => {\n c.destroy();\n };\n // Re-init when consent changes. Other props are intentionally stable.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [props.consent]);\n\n const ssrFallback = props.ssrFallback ?? 'first';\n\n return (\n <AdaptiveContext.Provider\n value={{\n client,\n projectId: props.apiKey,\n initialAssignments: props.initialAssignments ?? {},\n sessionSegment: props.sessionSegment ?? 'desktop:direct',\n ssrFallback,\n onAssignment: props.onAssignment,\n }}\n >\n {props.children}\n </AdaptiveContext.Provider>\n );\n}\n\n/**\n * Returns the SentientClient, or null until the provider has finished\n * initialising on the client.\n */\nexport function useSentient(): SentientClient | null {\n return useContext(AdaptiveContext).client;\n}\n\n/** Internal: project identifier carried alongside the client. */\nexport function useAdaptiveProjectId(): string {\n return useContext(AdaptiveContext).projectId;\n}\n\n/** Internal: SSR-preloaded assignments for hydration-safe first render. */\nexport function useInitialAssignments(): Record<string, string> {\n return useContext(AdaptiveContext).initialAssignments;\n}\n\n/** Internal: bandit segment aligned with SSR session upsert. */\nexport function useSessionSegment(): string {\n return useContext(AdaptiveContext).sessionSegment;\n}\n\n/** Internal: SSR fallback strategy when a slot has no preloaded assignment. */\nexport function useSsrFallback(): SsrFallback {\n return useContext(AdaptiveContext).ssrFallback;\n}\n\n/** Internal: forwarding hook for consumer analytics integration. */\nexport function useOnAssignment(): ((componentId: string, variantId: string) => void) | undefined {\n return useContext(AdaptiveContext).onAssignment;\n}\n","'use client';\r\n\r\nimport { memo, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';\r\nimport { useAdaptiveProjectId, useSentient } from './provider.js';\r\nimport { useAssignment } from './use-assignment.js';\r\n\r\nexport type ScrollDepthGoal = { type: 'scroll_depth'; threshold: number };\r\nexport type ClickGoal = { type: 'click'; selector?: string };\r\nexport type FormSubmitGoal = { type: 'form_submit' };\r\nexport type CompositeGoal = { type: 'composite'; all: GoalConfig[] };\r\nexport type GoalConfig = ScrollDepthGoal | ClickGoal | FormSubmitGoal | CompositeGoal;\r\n\r\nexport type AdaptiveProps = {\r\n id: string;\r\n variants: Record<string, ReactNode>;\r\n goal: string | GoalConfig;\r\n /**\r\n * When true, renders nothing during SSR and before client hydration.\r\n * Use when you cannot pass `initialAssignments` and prefer a blank slot over\r\n * a hydration mismatch. Tradeoff: minor CLS on first paint.\r\n */\r\n clientOnly?: boolean;\r\n};\r\n\r\nfunction normalize(goal: string | GoalConfig): GoalConfig {\r\n if (typeof goal === 'string') return { type: 'click' };\r\n return goal;\r\n}\r\n\r\nfunction isClickableTarget(el: EventTarget | null): boolean {\r\n if (!(el instanceof Element)) return false;\r\n const tag = el.tagName.toLowerCase();\r\n if (tag === 'a' || tag === 'button') return true;\r\n const role = el.getAttribute('role');\r\n return role === 'button';\r\n}\r\n\r\nfunction findClickable(start: Element, container: Element): boolean {\r\n let cursor: Element | null = start;\r\n while (cursor && cursor !== container) {\r\n if (isClickableTarget(cursor)) return true;\r\n cursor = cursor.parentElement;\r\n }\r\n return false;\r\n}\r\n\r\nfunction AdaptiveImpl(props: AdaptiveProps): JSX.Element | null {\r\n const client = useSentient();\r\n const projectId = useAdaptiveProjectId();\r\n const variantIds = useMemo(() => Object.keys(props.variants), [props.variants]);\r\n const { variantId } = useAssignment(props.id, variantIds);\r\n const containerRef = useRef<HTMLDivElement>(null);\r\n const [mounted, setMounted] = useState(false);\r\n\r\n useEffect(() => { setMounted(true); }, []);\r\n const goalFiredRef = useRef(false);\r\n const assignTrackedRef = useRef<string | null>(null);\r\n const goal = useMemo(() => normalize(props.goal), [props.goal]);\r\n const goalLabel = typeof props.goal === 'string' ? props.goal : goal.type;\r\n\r\n // Track variant_assigned exactly once per (component, variant) mount.\r\n // Captures innerHTML as previewHtml so the dashboard can render a live preview\r\n // without requiring manual registry calls. First-seen wins on the server.\r\n // `mounted` is in deps so the effect re-runs after clientOnly components hydrate\r\n // and their container div is actually in the DOM.\r\n useEffect(() => {\r\n if (!client || !variantId || !projectId) return;\r\n if (assignTrackedRef.current === variantId) return;\r\n const rawHtml = containerRef.current?.innerHTML ?? '';\r\n // For clientOnly, the container is null until mounted — defer until it exists.\r\n if (!rawHtml && !mounted) return;\r\n assignTrackedRef.current = variantId;\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId,\r\n eventType: 'variant_assigned',\r\n payload: rawHtml ? { previewHtml: rawHtml.slice(0, 30_000) } : {},\r\n });\r\n }, [client, variantId, projectId, props.id, mounted]);\r\n\r\n // Reset goal latch when variant changes.\r\n useEffect(() => {\r\n goalFiredRef.current = false;\r\n }, [variantId]);\r\n\r\n // Emit cursor_signal after 800 ms of continuous hover.\r\n useEffect(() => {\r\n if (!client || !variantId) return;\r\n const node = containerRef.current;\r\n if (!node) return;\r\n\r\n let timerId: ReturnType<typeof setTimeout> | null = null;\r\n let hoverStart = 0;\r\n\r\n const onEnter = (): void => {\r\n hoverStart = Date.now();\r\n timerId = setTimeout(() => {\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId: variantId!,\r\n eventType: 'cursor_signal',\r\n payload: { hoverDuration: Date.now() - hoverStart },\r\n });\r\n timerId = null;\r\n }, 800);\r\n };\r\n\r\n const onLeave = (): void => {\r\n if (timerId !== null) {\r\n clearTimeout(timerId);\r\n timerId = null;\r\n }\r\n };\r\n\r\n node.addEventListener('mouseenter', onEnter);\r\n node.addEventListener('mouseleave', onLeave);\r\n return () => {\r\n node.removeEventListener('mouseenter', onEnter);\r\n node.removeEventListener('mouseleave', onLeave);\r\n if (timerId !== null) clearTimeout(timerId);\r\n };\r\n }, [client, variantId, projectId, props.id]);\r\n\r\n // Attach goal tracking.\r\n useEffect(() => {\r\n if (!client || !variantId) return;\r\n const node = containerRef.current;\r\n if (!node) return;\r\n\r\n const fireGoal = (): void => {\r\n if (goalFiredRef.current) return;\r\n goalFiredRef.current = true;\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId,\r\n eventType: 'goal_achieved',\r\n goalType: goalLabel,\r\n payload: { reward: 1.0 },\r\n });\r\n };\r\n\r\n const subgoals: GoalConfig[] = goal.type === 'composite' ? goal.all : [goal];\r\n const remaining = new Set<number>(subgoals.map((_, i) => i));\r\n const checkComposite = (idx: number): void => {\r\n remaining.delete(idx);\r\n if (remaining.size === 0) fireGoal();\r\n };\r\n\r\n const cleanups: Array<() => void> = [];\r\n\r\n subgoals.forEach((sub, idx) => {\r\n if (sub.type === 'click') {\r\n const onClick = (e: MouseEvent): void => {\r\n const target = e.target;\r\n if (!(target instanceof Element)) return;\r\n if (!findClickable(target, node)) return;\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n };\r\n node.addEventListener('click', onClick);\r\n cleanups.push(() => node.removeEventListener('click', onClick));\r\n return;\r\n }\r\n\r\n if (sub.type === 'form_submit') {\r\n const onSubmit = (e: Event): void => {\r\n if (!(e.target instanceof HTMLFormElement)) return;\r\n if (!node.contains(e.target)) return;\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n };\r\n node.addEventListener('submit', onSubmit);\r\n cleanups.push(() => node.removeEventListener('submit', onSubmit));\r\n return;\r\n }\r\n\r\n if (sub.type === 'scroll_depth') {\r\n const threshold = Math.max(0, Math.min(1, sub.threshold));\r\n const io = new IntersectionObserver(\r\n (entries) => {\r\n for (const entry of entries) {\r\n if (entry.intersectionRatio >= threshold) {\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n io.disconnect();\r\n break;\r\n }\r\n }\r\n },\r\n { threshold: [threshold] },\r\n );\r\n io.observe(node);\r\n cleanups.push(() => io.disconnect());\r\n return;\r\n }\r\n });\r\n\r\n return () => {\r\n for (const c of cleanups) c();\r\n };\r\n }, [client, variantId, projectId, props.id, goal, goalLabel]);\r\n\r\n // Decorative slots: empty in SSR HTML and until the client has mounted.\r\n if (props.clientOnly && (!mounted || !client)) return null;\r\n if (!variantId) return null;\r\n const content = props.variants[variantId] ?? null;\r\n\r\n return (\r\n <div ref={containerRef} data-sentient-id={props.id} data-sentient-variant={variantId}>\r\n {content}\r\n </div>\r\n );\r\n}\r\n\r\n/** Re-renders only when the chosen variant changes. */\r\nexport const Adaptive = memo(AdaptiveImpl, (prev, next) => {\r\n if (prev.id !== next.id) return false;\r\n if (prev.goal !== next.goal) return false;\r\n if (prev.variants === next.variants) return true;\r\n const prevKeys = Object.keys(prev.variants);\r\n const nextKeys = Object.keys(next.variants);\r\n if (prevKeys.length !== nextKeys.length) return false;\r\n return prevKeys.every((k) => k in next.variants);\r\n});\r\n","import { useEffect, useRef, useState } from 'react';\r\nimport { useSentient, useInitialAssignments, useSessionSegment, useSsrFallback, useOnAssignment } from './provider.js';\r\nimport { subscribe, getWeights, type ComponentWeights } from './weights-store.js';\r\n\r\ndeclare global {\r\n interface Window { __sentient_overrides?: Record<string, string>; }\r\n}\r\n\r\nfunction getDevOverride(componentId: string): string | null {\r\n if (typeof window === 'undefined') return null;\r\n const global = window.__sentient_overrides?.[componentId];\r\n if (global) return global;\r\n try {\r\n const params = new URLSearchParams(window.location.search);\r\n for (const raw of params.getAll('sentient_variant')) {\r\n // sentient_variant=componentId:variantId (repeatable for multiple components)\r\n const sep = raw.indexOf(':');\r\n if (sep === -1) continue;\r\n if (raw.slice(0, sep) === componentId) return raw.slice(sep + 1);\r\n }\r\n } catch { /* non-browser env */ }\r\n return null;\r\n}\r\n\r\nexport type AssignmentState = {\r\n variantId: string | null;\r\n isLoading: boolean;\r\n};\r\n\r\nfunction pickFromWeights(weights: ComponentWeights, variantIds: string[]): string | null {\r\n let best: { variantId: string; avgReward: number } | null = null;\r\n for (const v of weights.variants) {\r\n if (!variantIds.includes(v.variantId)) continue;\r\n if (!best || v.avgReward > best.avgReward) {\r\n best = { variantId: v.variantId, avgReward: v.avgReward };\r\n }\r\n }\r\n return best?.variantId ?? null;\r\n}\r\n\r\n/**\r\n * Returns a sticky variant assignment for a component.\r\n *\r\n * First render reads the local SDK cache; if empty, falls back to a\r\n * deterministic default and asynchronously calls `/v1/assign`. The server\r\n * picks the actual variant via ε-greedy and the result replaces the fallback\r\n * on the next render. Subsequent paints read synchronously from cache —\r\n * no flicker, no loading state after first paint.\r\n */\r\nexport function useAssignment(componentId: string, variantIds: string[]): AssignmentState {\r\n const initialAssignments = useInitialAssignments();\r\n const ssrFallback = useSsrFallback();\r\n const client = useSentient();\r\n const segment = useSessionSegment();\r\n const onAssignment = useOnAssignment();\r\n const assignmentReportedRef = useRef<string | null>(null);\r\n\r\n // Dev override: URL param ?sentient_variant=componentId:variantId\r\n // or window.__sentient_overrides[componentId]. Short-circuits the bandit entirely.\r\n const devOverride = getDevOverride(componentId);\r\n const overrideVariant = devOverride && variantIds.includes(devOverride) ? devOverride : null;\r\n if (overrideVariant) {\r\n console.info(`[sentient] override active: ${componentId} -> ${overrideVariant}`);\r\n }\r\n\r\n const initial = (() => {\r\n if (overrideVariant) {\r\n return { variantId: overrideVariant, isLoading: false };\r\n }\r\n // SSR / pre-hydration: no client yet. Use initialAssignments if provided so\r\n // the server and client first render agree on the same variant (no mismatch).\r\n if (!client) {\r\n const preloaded = initialAssignments[componentId];\r\n if (preloaded && variantIds.includes(preloaded)) {\r\n return { variantId: preloaded, isLoading: false };\r\n }\r\n if (ssrFallback === 'first' && variantIds.length > 0) {\r\n return { variantId: variantIds[0], isLoading: false };\r\n }\r\n return { variantId: null, isLoading: true };\r\n }\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n return { variantId: cached.variantId, isLoading: false };\r\n }\r\n const weights = getWeights(componentId);\r\n if (weights) {\r\n const chosen = pickFromWeights(weights, variantIds);\r\n if (chosen) return { variantId: chosen, isLoading: false };\r\n }\r\n return { variantId: variantIds[0] ?? null, isLoading: false };\r\n })();\r\n\r\n const [state, setState] = useState<AssignmentState>(initial);\r\n\r\n // Helper: call onAssignment at most once per resolved variant.\r\n const reportAssignment = (variantId: string): void => {\r\n if (!onAssignment) return;\r\n if (assignmentReportedRef.current === variantId) return;\r\n assignmentReportedRef.current = variantId;\r\n onAssignment(componentId, variantId);\r\n };\r\n\r\n // As soon as the client is ready, unblock the UI immediately with variantIds[0]\r\n // (or a cached value) so the component never stays invisible while assign is\r\n // in-flight. The async assign call below then swaps to the bandit-chosen variant.\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n setState({ variantId: cached.variantId, isLoading: false });\r\n reportAssignment(cached.variantId);\r\n return;\r\n }\r\n setState((prev) => prev.variantId ? prev : { variantId: variantIds[0] ?? null, isLoading: false });\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n // Ask the server for a real assignment when we have a client but no cached one.\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) return;\r\n\r\n let cancelled = false;\r\n void client.assign(componentId, variantIds).then((result) => {\r\n if (cancelled) return;\r\n // If the API is unreachable or returns null, the fallback set above stays.\r\n if (!result || !variantIds.includes(result.variantId)) return;\r\n setState({ variantId: result.variantId, isLoading: false });\r\n reportAssignment(result.variantId);\r\n });\r\n return () => { cancelled = true; };\r\n // variantIds intentionally excluded — changing variants mid-mount is unsupported\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n // Live weight updates from the dashboard SSE stream (when wired).\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n return subscribe(componentId, (weights) => {\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n setState({ variantId: cached.variantId, isLoading: false });\r\n return;\r\n }\r\n const chosen = pickFromWeights(weights, variantIds);\r\n if (chosen) setState({ variantId: chosen, isLoading: false });\r\n });\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n if (overrideVariant) {\r\n return { variantId: overrideVariant, isLoading: false };\r\n }\r\n\r\n return state;\r\n}\r\n","/** Per-component weights store with isolated subscriptions. */\r\n\r\nexport type VariantWeight = {\r\n variantId: string;\r\n pulls: number;\r\n avgReward: number;\r\n};\r\n\r\nexport type ComponentWeights = {\r\n componentId: string;\r\n variants: VariantWeight[];\r\n updatedAt: number;\r\n};\r\n\r\ntype Listener = (weights: ComponentWeights) => void;\r\n\r\nconst store = new Map<string, ComponentWeights>();\r\nconst listeners = new Map<string, Set<Listener>>();\r\n\r\n/**\r\n * Subscribes a listener to a single component. Returns an unsubscribe function.\r\n * Updates to other components never trigger this listener.\r\n */\r\nexport function subscribe(componentId: string, cb: Listener): () => void {\r\n let set = listeners.get(componentId);\r\n if (!set) {\r\n set = new Set();\r\n listeners.set(componentId, set);\r\n }\r\n set.add(cb);\r\n return () => {\r\n set!.delete(cb);\r\n if (set!.size === 0) listeners.delete(componentId);\r\n };\r\n}\r\n\r\n/**\r\n * Replaces the weights for a component and notifies only that component's\r\n * subscribers.\r\n */\r\nexport function update(componentId: string, weights: ComponentWeights): void {\r\n store.set(componentId, weights);\r\n const set = listeners.get(componentId);\r\n if (!set) return;\r\n for (const cb of set) {\r\n try {\r\n cb(weights);\r\n } catch {\r\n /* never throw to other listeners */\r\n }\r\n }\r\n}\r\n\r\n/**\r\n * Returns the latest known weights for a component, or null if none seen.\r\n */\r\nexport function getWeights(componentId: string): ComponentWeights | null {\r\n return store.get(componentId) ?? null;\r\n}\r\n\r\n/** Test-only: wipe the entire store. */\r\nexport function _resetWeightsStore(): void {\r\n store.clear();\r\n listeners.clear();\r\n}\r\n","/** @deprecated Use `useSessionSegment()` from the provider, or `deriveSessionSegment` from `@sentientui/core`. */\nexport { deriveSessionSegment as detectSegment } from '@sentientui/core';\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime","_a","import_core"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/adaptive.tsx","../src/use-assignment.ts","../src/weights-store.ts","../src/segment.ts"],"sourcesContent":["export { AdaptiveProvider, useSentient, useInitialAssignments } from './provider.js';\r\nexport type { AdaptiveProviderProps, SsrFallback } from './provider.js';\r\n\r\nexport { Adaptive } from './adaptive.js';\r\nexport type {\r\n AdaptiveProps,\r\n GoalConfig,\r\n ClickGoal,\r\n ScrollDepthGoal,\r\n FormSubmitGoal,\r\n CompositeGoal,\r\n} from './adaptive.js';\r\n\r\nexport { useAssignment } from './use-assignment.js';\r\nexport type { AssignmentState } from './use-assignment.js';\r\n\r\nexport {\r\n subscribe as subscribeWeights,\r\n update as updateWeights,\r\n getWeights,\r\n} from './weights-store.js';\r\nexport type { ComponentWeights, VariantWeight } from './weights-store.js';\r\n\r\nexport { detectSegment } from './segment.js';\r\n","'use client';\r\n\r\nimport { createContext, useContext, useEffect, useState, type ReactNode } from 'react';\r\nimport { init, type SentientClient, type SentientConfig } from '@sentientui/core';\r\n\r\n/** How to render adaptive slots during SSR when assignments are not preloaded. */\r\nexport type SsrFallback = 'first' | 'none';\r\n\r\ntype AdaptiveContextValue = {\r\n client: SentientClient | null;\r\n projectId: string;\r\n initialAssignments: Record<string, string>;\r\n sessionSegment: string;\r\n ssrFallback: SsrFallback;\r\n onAssignment: ((componentId: string, variantId: string) => void) | undefined;\r\n};\r\n\r\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\r\n client: null,\r\n projectId: '',\r\n initialAssignments: {},\r\n sessionSegment: 'desktop:direct',\r\n ssrFallback: 'first',\r\n onAssignment: undefined,\r\n});\r\n\r\nexport type AdaptiveProviderProps = {\r\n apiKey: string;\r\n context: SentientConfig['context'];\r\n ingestUrl: string;\r\n debug?: boolean;\r\n /**\r\n * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.\r\n * Passed through to `useAssignment` as synchronous initial state so crawlers and\r\n * the first paint see real content (recommended for SEO).\r\n */\r\n initialAssignments?: Record<string, string>;\r\n /**\r\n * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker\r\n * weights on one row — must match `loadAdaptiveAssignments` / session upsert.\r\n */\r\n sessionSegment?: string;\r\n /**\r\n * When no `initialAssignments` exist for a component, `'first'` renders\r\n * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for\r\n * decorative slots marked `clientOnly`.\r\n * @default 'first'\r\n */\r\n ssrFallback?: SsrFallback;\r\n /**\r\n * Consent gate. When `false` the SDK is not initialised and no events are\r\n * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to\r\n * initialise and begin tracking.\r\n */\r\n consent?: boolean;\r\n /**\r\n * Called once per component the first time a variant is resolved for that\r\n * component in this session. Use to forward assignments to your own analytics\r\n * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.\r\n */\r\n onAssignment?: (componentId: string, variantId: string) => void;\r\n children: ReactNode;\r\n};\r\n\r\n/**\r\n * Initialises the Sentient core SDK in a useEffect (SSR-safe) and exposes the\r\n * client via React context. Re-initialises when `consent` changes.\r\n */\r\nexport function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element {\r\n const [client, setClient] = useState<SentientClient | null>(null);\r\n\r\n useEffect(() => {\r\n // When consent is explicitly false, tear down any existing client.\r\n if (props.consent === false) {\r\n setClient((prev: SentientClient | null) => {\r\n prev?.destroy();\r\n return null;\r\n });\r\n return;\r\n }\r\n\r\n const c = init({\r\n apiKey: props.apiKey,\r\n context: props.context,\r\n ingestUrl: props.ingestUrl,\r\n debug: props.debug,\r\n initialAssignments: props.initialAssignments,\r\n sessionSegment: props.sessionSegment,\r\n consent: props.consent,\r\n });\r\n setClient(c);\r\n return () => {\r\n c.destroy();\r\n };\r\n // Re-init when consent changes. Other props are intentionally stable.\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [props.consent]);\r\n\r\n const ssrFallback = props.ssrFallback ?? 'first';\r\n\r\n return (\r\n <AdaptiveContext.Provider\r\n value={{\r\n client,\r\n projectId: props.apiKey,\r\n initialAssignments: props.initialAssignments ?? {},\r\n sessionSegment: props.sessionSegment ?? 'desktop:direct',\r\n ssrFallback,\r\n onAssignment: props.onAssignment,\r\n }}\r\n >\r\n {props.children}\r\n </AdaptiveContext.Provider>\r\n );\r\n}\r\n\r\n/**\r\n * Returns the SentientClient, or null until the provider has finished\r\n * initialising on the client.\r\n */\r\nexport function useSentient(): SentientClient | null {\r\n return useContext(AdaptiveContext).client;\r\n}\r\n\r\n/** Internal: project identifier carried alongside the client. */\r\nexport function useAdaptiveProjectId(): string {\r\n return useContext(AdaptiveContext).projectId;\r\n}\r\n\r\n/** Internal: SSR-preloaded assignments for hydration-safe first render. */\r\nexport function useInitialAssignments(): Record<string, string> {\r\n return useContext(AdaptiveContext).initialAssignments;\r\n}\r\n\r\n/** Internal: bandit segment aligned with SSR session upsert. */\r\nexport function useSessionSegment(): string {\r\n return useContext(AdaptiveContext).sessionSegment;\r\n}\r\n\r\n/** Internal: SSR fallback strategy when a slot has no preloaded assignment. */\r\nexport function useSsrFallback(): SsrFallback {\r\n return useContext(AdaptiveContext).ssrFallback;\r\n}\r\n\r\n/** Internal: forwarding hook for consumer analytics integration. */\r\nexport function useOnAssignment(): ((componentId: string, variantId: string) => void) | undefined {\r\n return useContext(AdaptiveContext).onAssignment;\r\n}\r\n","'use client';\r\n\r\nimport { memo, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';\r\nimport { useAdaptiveProjectId, useSentient } from './provider.js';\r\nimport { useAssignment } from './use-assignment.js';\r\n\r\nexport type ScrollDepthGoal = { type: 'scroll_depth'; threshold: number };\r\nexport type ClickGoal = { type: 'click'; selector?: string };\r\nexport type FormSubmitGoal = { type: 'form_submit' };\r\nexport type CompositeGoal = { type: 'composite'; all: GoalConfig[] };\r\nexport type GoalConfig = ScrollDepthGoal | ClickGoal | FormSubmitGoal | CompositeGoal;\r\n\r\nexport type AdaptiveProps = {\r\n id: string;\r\n variants: Record<string, ReactNode>;\r\n goal: string | GoalConfig;\r\n /**\r\n * When true, renders nothing during SSR and before client hydration.\r\n * Use when you cannot pass `initialAssignments` and prefer a blank slot over\r\n * a hydration mismatch. Tradeoff: minor CLS on first paint.\r\n */\r\n clientOnly?: boolean;\r\n};\r\n\r\nfunction normalize(goal: string | GoalConfig): GoalConfig {\r\n if (typeof goal === 'string') return { type: 'click' };\r\n return goal;\r\n}\r\n\r\nfunction isClickableTarget(el: EventTarget | null): boolean {\r\n if (!(el instanceof Element)) return false;\r\n const tag = el.tagName.toLowerCase();\r\n if (tag === 'a' || tag === 'button') return true;\r\n const role = el.getAttribute('role');\r\n return role === 'button';\r\n}\r\n\r\nfunction findClickable(start: Element, container: Element): boolean {\r\n let cursor: Element | null = start;\r\n while (cursor && cursor !== container) {\r\n if (isClickableTarget(cursor)) return true;\r\n cursor = cursor.parentElement;\r\n }\r\n return false;\r\n}\r\n\r\nfunction AdaptiveImpl(props: AdaptiveProps): JSX.Element | null {\r\n const client = useSentient();\r\n const projectId = useAdaptiveProjectId();\r\n const variantIds = useMemo(() => Object.keys(props.variants), [props.variants]);\r\n const { variantId } = useAssignment(props.id, variantIds);\r\n const containerRef = useRef<HTMLDivElement>(null);\r\n const [mounted, setMounted] = useState(false);\r\n\r\n useEffect(() => { setMounted(true); }, []);\r\n const goalFiredRef = useRef(false);\r\n const assignTrackedRef = useRef<string | null>(null);\r\n const goal = useMemo(() => normalize(props.goal), [props.goal]);\r\n const goalLabel = typeof props.goal === 'string' ? props.goal : goal.type;\r\n\r\n // Track variant_assigned exactly once per (component, variant) mount.\r\n // Captures innerHTML as previewHtml so the dashboard can render a live preview\r\n // without requiring manual registry calls. First-seen wins on the server.\r\n // `mounted` is in deps so the effect re-runs after clientOnly components hydrate\r\n // and their container div is actually in the DOM.\r\n useEffect(() => {\r\n if (!client || !variantId || !projectId) return;\r\n if (assignTrackedRef.current === variantId) return;\r\n const rawHtml = containerRef.current?.innerHTML ?? '';\r\n // For clientOnly, the container is null until mounted — defer until it exists.\r\n if (!rawHtml && !mounted) return;\r\n assignTrackedRef.current = variantId;\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId,\r\n eventType: 'variant_assigned',\r\n payload: rawHtml ? { previewHtml: rawHtml.slice(0, 30_000) } : {},\r\n });\r\n }, [client, variantId, projectId, props.id, mounted]);\r\n\r\n // Reset goal latch when variant changes.\r\n useEffect(() => {\r\n goalFiredRef.current = false;\r\n }, [variantId]);\r\n\r\n // Emit cursor_signal after 800 ms of continuous hover.\r\n useEffect(() => {\r\n if (!client || !variantId) return;\r\n const node = containerRef.current;\r\n if (!node) return;\r\n\r\n let timerId: ReturnType<typeof setTimeout> | null = null;\r\n let hoverStart = 0;\r\n\r\n const onEnter = (): void => {\r\n hoverStart = Date.now();\r\n timerId = setTimeout(() => {\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId: variantId!,\r\n eventType: 'cursor_signal',\r\n payload: { hoverDuration: Date.now() - hoverStart },\r\n });\r\n timerId = null;\r\n }, 800);\r\n };\r\n\r\n const onLeave = (): void => {\r\n if (timerId !== null) {\r\n clearTimeout(timerId);\r\n timerId = null;\r\n }\r\n };\r\n\r\n node.addEventListener('mouseenter', onEnter);\r\n node.addEventListener('mouseleave', onLeave);\r\n return () => {\r\n node.removeEventListener('mouseenter', onEnter);\r\n node.removeEventListener('mouseleave', onLeave);\r\n if (timerId !== null) clearTimeout(timerId);\r\n };\r\n }, [client, variantId, projectId, props.id]);\r\n\r\n // Attach goal tracking.\r\n useEffect(() => {\r\n if (!client || !variantId) return;\r\n const node = containerRef.current;\r\n if (!node) return;\r\n\r\n const fireGoal = (): void => {\r\n if (goalFiredRef.current) return;\r\n goalFiredRef.current = true;\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId,\r\n eventType: 'goal_achieved',\r\n goalType: goalLabel,\r\n payload: { reward: 1.0 },\r\n });\r\n };\r\n\r\n const subgoals: GoalConfig[] = goal.type === 'composite' ? goal.all : [goal];\r\n const remaining = new Set<number>(subgoals.map((_, i) => i));\r\n const checkComposite = (idx: number): void => {\r\n remaining.delete(idx);\r\n if (remaining.size === 0) fireGoal();\r\n };\r\n\r\n const cleanups: Array<() => void> = [];\r\n\r\n subgoals.forEach((sub, idx) => {\r\n if (sub.type === 'click') {\r\n const onClick = (e: MouseEvent): void => {\r\n const target = e.target;\r\n if (!(target instanceof Element)) return;\r\n if (!findClickable(target, node)) return;\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n };\r\n node.addEventListener('click', onClick);\r\n cleanups.push(() => node.removeEventListener('click', onClick));\r\n return;\r\n }\r\n\r\n if (sub.type === 'form_submit') {\r\n const onSubmit = (e: Event): void => {\r\n if (!(e.target instanceof HTMLFormElement)) return;\r\n if (!node.contains(e.target)) return;\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n };\r\n node.addEventListener('submit', onSubmit);\r\n cleanups.push(() => node.removeEventListener('submit', onSubmit));\r\n return;\r\n }\r\n\r\n if (sub.type === 'scroll_depth') {\r\n const threshold = Math.max(0, Math.min(1, sub.threshold));\r\n const io = new IntersectionObserver(\r\n (entries) => {\r\n for (const entry of entries) {\r\n if (entry.intersectionRatio >= threshold) {\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n io.disconnect();\r\n break;\r\n }\r\n }\r\n },\r\n { threshold: [threshold] },\r\n );\r\n io.observe(node);\r\n cleanups.push(() => io.disconnect());\r\n return;\r\n }\r\n });\r\n\r\n return () => {\r\n for (const c of cleanups) c();\r\n };\r\n }, [client, variantId, projectId, props.id, goal, goalLabel]);\r\n\r\n // Decorative slots: empty in SSR HTML and until the client has mounted.\r\n if (props.clientOnly && (!mounted || !client)) return null;\r\n if (!variantId) return null;\r\n const content = props.variants[variantId] ?? null;\r\n\r\n return (\r\n <div ref={containerRef} data-sentient-id={props.id} data-sentient-variant={variantId}>\r\n {content}\r\n </div>\r\n );\r\n}\r\n\r\n/** Re-renders only when the chosen variant changes. */\r\nexport const Adaptive = memo(AdaptiveImpl, (prev, next) => {\r\n if (prev.id !== next.id) return false;\r\n if (prev.goal !== next.goal) return false;\r\n if (prev.variants === next.variants) return true;\r\n const prevKeys = Object.keys(prev.variants);\r\n const nextKeys = Object.keys(next.variants);\r\n if (prevKeys.length !== nextKeys.length) return false;\r\n return prevKeys.every((k) => k in next.variants);\r\n});\r\n","import { useEffect, useRef, useState } from 'react';\r\nimport { type AssignResult } from '@sentientui/core';\r\nimport { useSentient, useInitialAssignments, useSessionSegment, useSsrFallback, useOnAssignment } from './provider.js';\r\nimport { subscribe, getWeights, type ComponentWeights } from './weights-store.js';\r\n\r\ndeclare global {\r\n interface Window { __sentient_overrides?: Record<string, string>; }\r\n}\r\n\r\nfunction getDevOverride(componentId: string): string | null {\r\n if (typeof window === 'undefined') return null;\r\n const global = window.__sentient_overrides?.[componentId];\r\n if (global) return global;\r\n try {\r\n const params = new URLSearchParams(window.location.search);\r\n for (const raw of params.getAll('sentient_variant')) {\r\n // sentient_variant=componentId:variantId (repeatable for multiple components)\r\n const sep = raw.indexOf(':');\r\n if (sep === -1) continue;\r\n if (raw.slice(0, sep) === componentId) return raw.slice(sep + 1);\r\n }\r\n } catch { /* non-browser env */ }\r\n return null;\r\n}\r\n\r\nexport type AssignmentState = {\r\n variantId: string | null;\r\n isLoading: boolean;\r\n};\r\n\r\nfunction pickFromWeights(weights: ComponentWeights, variantIds: string[]): string | null {\r\n let best: { variantId: string; avgReward: number } | null = null;\r\n for (const v of weights.variants) {\r\n if (!variantIds.includes(v.variantId)) continue;\r\n if (!best || v.avgReward > best.avgReward) {\r\n best = { variantId: v.variantId, avgReward: v.avgReward };\r\n }\r\n }\r\n return best?.variantId ?? null;\r\n}\r\n\r\n/**\r\n * Returns a sticky variant assignment for a component.\r\n *\r\n * First render reads the local SDK cache; if empty, falls back to a\r\n * deterministic default and asynchronously calls `/v1/assign`. The server\r\n * picks the actual variant via ε-greedy and the result replaces the fallback\r\n * on the next render. Subsequent paints read synchronously from cache —\r\n * no flicker, no loading state after first paint.\r\n */\r\nexport function useAssignment(componentId: string, variantIds: string[]): AssignmentState {\r\n const initialAssignments = useInitialAssignments();\r\n const ssrFallback = useSsrFallback();\r\n const client = useSentient();\r\n const segment = useSessionSegment();\r\n const onAssignment = useOnAssignment();\r\n const assignmentReportedRef = useRef<string | null>(null);\r\n\r\n // Dev override: URL param ?sentient_variant=componentId:variantId\r\n // or window.__sentient_overrides[componentId]. Short-circuits the bandit entirely.\r\n const devOverride = getDevOverride(componentId);\r\n const overrideVariant = devOverride && variantIds.includes(devOverride) ? devOverride : null;\r\n if (overrideVariant) {\r\n console.info(`[sentient] override active: ${componentId} -> ${overrideVariant}`);\r\n }\r\n\r\n const initial = (() => {\r\n if (overrideVariant) {\r\n return { variantId: overrideVariant, isLoading: false };\r\n }\r\n // SSR / pre-hydration: no client yet. Use initialAssignments if provided so\r\n // the server and client first render agree on the same variant (no mismatch).\r\n if (!client) {\r\n const preloaded = initialAssignments[componentId];\r\n if (preloaded && variantIds.includes(preloaded)) {\r\n return { variantId: preloaded, isLoading: false };\r\n }\r\n if (ssrFallback === 'first' && variantIds.length > 0) {\r\n return { variantId: variantIds[0], isLoading: false };\r\n }\r\n return { variantId: null, isLoading: true };\r\n }\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n return { variantId: cached.variantId, isLoading: false };\r\n }\r\n const weights = getWeights(componentId);\r\n if (weights) {\r\n const chosen = pickFromWeights(weights, variantIds);\r\n if (chosen) return { variantId: chosen, isLoading: false };\r\n }\r\n return { variantId: variantIds[0] ?? null, isLoading: false };\r\n })();\r\n\r\n const [state, setState] = useState<AssignmentState>(initial);\r\n\r\n // Helper: call onAssignment at most once per resolved variant.\r\n const reportAssignment = (variantId: string): void => {\r\n if (!onAssignment) return;\r\n if (assignmentReportedRef.current === variantId) return;\r\n assignmentReportedRef.current = variantId;\r\n onAssignment(componentId, variantId);\r\n };\r\n\r\n // As soon as the client is ready, unblock the UI immediately with variantIds[0]\r\n // (or a cached value) so the component never stays invisible while assign is\r\n // in-flight. The async assign call below then swaps to the bandit-chosen variant.\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n setState({ variantId: cached.variantId, isLoading: false });\r\n reportAssignment(cached.variantId);\r\n return;\r\n }\r\n setState((prev) => prev.variantId ? prev : { variantId: variantIds[0] ?? null, isLoading: false });\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n // Ask the server for a real assignment when we have a client but no cached one.\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) return;\r\n\r\n let cancelled = false;\r\n void client.assign(componentId, variantIds).then((result: AssignResult | null) => {\r\n if (cancelled) return;\r\n // If the API is unreachable or returns null, the fallback set above stays.\r\n if (!result || !variantIds.includes(result.variantId)) return;\r\n setState({ variantId: result.variantId, isLoading: false });\r\n reportAssignment(result.variantId);\r\n });\r\n return () => { cancelled = true; };\r\n // variantIds intentionally excluded — changing variants mid-mount is unsupported\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n // Live weight updates from the dashboard SSE stream (when wired).\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n return subscribe(componentId, (weights) => {\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n setState({ variantId: cached.variantId, isLoading: false });\r\n return;\r\n }\r\n const chosen = pickFromWeights(weights, variantIds);\r\n if (chosen) setState({ variantId: chosen, isLoading: false });\r\n });\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n if (overrideVariant) {\r\n return { variantId: overrideVariant, isLoading: false };\r\n }\r\n\r\n return state;\r\n}\r\n","/** Per-component weights store with isolated subscriptions. */\n\nexport type VariantWeight = {\n variantId: string;\n pulls: number;\n avgReward: number;\n};\n\nexport type ComponentWeights = {\n componentId: string;\n variants: VariantWeight[];\n updatedAt: number;\n};\n\ntype Listener = (weights: ComponentWeights) => void;\n\nconst store = new Map<string, ComponentWeights>();\nconst listeners = new Map<string, Set<Listener>>();\n\n/**\n * Subscribes a listener to a single component. Returns an unsubscribe function.\n * Updates to other components never trigger this listener.\n */\nexport function subscribe(componentId: string, cb: Listener): () => void {\n let set = listeners.get(componentId);\n if (!set) {\n set = new Set();\n listeners.set(componentId, set);\n }\n set.add(cb);\n return () => {\n set!.delete(cb);\n if (set!.size === 0) listeners.delete(componentId);\n };\n}\n\n/**\n * Replaces the weights for a component and notifies only that component's\n * subscribers.\n */\nexport function update(componentId: string, weights: ComponentWeights): void {\n store.set(componentId, weights);\n const set = listeners.get(componentId);\n if (!set) return;\n for (const cb of set) {\n try {\n cb(weights);\n } catch {\n /* never throw to other listeners */\n }\n }\n}\n\n/**\n * Returns the latest known weights for a component, or null if none seen.\n */\nexport function getWeights(componentId: string): ComponentWeights | null {\n return store.get(componentId) ?? null;\n}\n\n/** Test-only: wipe the entire store. */\nexport function _resetWeightsStore(): void {\n store.clear();\n listeners.clear();\n}\n","/** @deprecated Use `useSessionSegment()` from the provider, or `deriveSessionSegment` from `@sentientui/core`. */\r\nexport { deriveSessionSegment as detectSegment } from '@sentientui/core';\r\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime","_a","import_core"]}
package/dist/index.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/provider.tsx","../src/adaptive.tsx","../src/use-assignment.ts","../src/weights-store.ts","../src/segment.ts"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useEffect, useState, type ReactNode } from 'react';\nimport { init, type SentientClient, type SentientConfig } from '@sentientui/core';\n\n/** How to render adaptive slots during SSR when assignments are not preloaded. */\nexport type SsrFallback = 'first' | 'none';\n\ntype AdaptiveContextValue = {\n client: SentientClient | null;\n projectId: string;\n initialAssignments: Record<string, string>;\n sessionSegment: string;\n ssrFallback: SsrFallback;\n onAssignment: ((componentId: string, variantId: string) => void) | undefined;\n};\n\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\n client: null,\n projectId: '',\n initialAssignments: {},\n sessionSegment: 'desktop:direct',\n ssrFallback: 'first',\n onAssignment: undefined,\n});\n\nexport type AdaptiveProviderProps = {\n apiKey: string;\n context: SentientConfig['context'];\n ingestUrl: string;\n debug?: boolean;\n /**\n * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.\n * Passed through to `useAssignment` as synchronous initial state so crawlers and\n * the first paint see real content (recommended for SEO).\n */\n initialAssignments?: Record<string, string>;\n /**\n * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker\n * weights on one row — must match `loadAdaptiveAssignments` / session upsert.\n */\n sessionSegment?: string;\n /**\n * When no `initialAssignments` exist for a component, `'first'` renders\n * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for\n * decorative slots marked `clientOnly`.\n * @default 'first'\n */\n ssrFallback?: SsrFallback;\n /**\n * Consent gate. When `false` the SDK is not initialised and no events are\n * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to\n * initialise and begin tracking.\n */\n consent?: boolean;\n /**\n * Called once per component the first time a variant is resolved for that\n * component in this session. Use to forward assignments to your own analytics\n * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.\n */\n onAssignment?: (componentId: string, variantId: string) => void;\n children: ReactNode;\n};\n\n/**\n * Initialises the Sentient core SDK in a useEffect (SSR-safe) and exposes the\n * client via React context. Re-initialises when `consent` changes.\n */\nexport function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element {\n const [client, setClient] = useState<SentientClient | null>(null);\n\n useEffect(() => {\n // When consent is explicitly false, tear down any existing client.\n if (props.consent === false) {\n setClient((prev) => {\n prev?.destroy();\n return null;\n });\n return;\n }\n\n const c = init({\n apiKey: props.apiKey,\n context: props.context,\n ingestUrl: props.ingestUrl,\n debug: props.debug,\n initialAssignments: props.initialAssignments,\n sessionSegment: props.sessionSegment,\n consent: props.consent,\n });\n setClient(c);\n return () => {\n c.destroy();\n };\n // Re-init when consent changes. Other props are intentionally stable.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [props.consent]);\n\n const ssrFallback = props.ssrFallback ?? 'first';\n\n return (\n <AdaptiveContext.Provider\n value={{\n client,\n projectId: props.apiKey,\n initialAssignments: props.initialAssignments ?? {},\n sessionSegment: props.sessionSegment ?? 'desktop:direct',\n ssrFallback,\n onAssignment: props.onAssignment,\n }}\n >\n {props.children}\n </AdaptiveContext.Provider>\n );\n}\n\n/**\n * Returns the SentientClient, or null until the provider has finished\n * initialising on the client.\n */\nexport function useSentient(): SentientClient | null {\n return useContext(AdaptiveContext).client;\n}\n\n/** Internal: project identifier carried alongside the client. */\nexport function useAdaptiveProjectId(): string {\n return useContext(AdaptiveContext).projectId;\n}\n\n/** Internal: SSR-preloaded assignments for hydration-safe first render. */\nexport function useInitialAssignments(): Record<string, string> {\n return useContext(AdaptiveContext).initialAssignments;\n}\n\n/** Internal: bandit segment aligned with SSR session upsert. */\nexport function useSessionSegment(): string {\n return useContext(AdaptiveContext).sessionSegment;\n}\n\n/** Internal: SSR fallback strategy when a slot has no preloaded assignment. */\nexport function useSsrFallback(): SsrFallback {\n return useContext(AdaptiveContext).ssrFallback;\n}\n\n/** Internal: forwarding hook for consumer analytics integration. */\nexport function useOnAssignment(): ((componentId: string, variantId: string) => void) | undefined {\n return useContext(AdaptiveContext).onAssignment;\n}\n","'use client';\r\n\r\nimport { memo, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';\r\nimport { useAdaptiveProjectId, useSentient } from './provider.js';\r\nimport { useAssignment } from './use-assignment.js';\r\n\r\nexport type ScrollDepthGoal = { type: 'scroll_depth'; threshold: number };\r\nexport type ClickGoal = { type: 'click'; selector?: string };\r\nexport type FormSubmitGoal = { type: 'form_submit' };\r\nexport type CompositeGoal = { type: 'composite'; all: GoalConfig[] };\r\nexport type GoalConfig = ScrollDepthGoal | ClickGoal | FormSubmitGoal | CompositeGoal;\r\n\r\nexport type AdaptiveProps = {\r\n id: string;\r\n variants: Record<string, ReactNode>;\r\n goal: string | GoalConfig;\r\n /**\r\n * When true, renders nothing during SSR and before client hydration.\r\n * Use when you cannot pass `initialAssignments` and prefer a blank slot over\r\n * a hydration mismatch. Tradeoff: minor CLS on first paint.\r\n */\r\n clientOnly?: boolean;\r\n};\r\n\r\nfunction normalize(goal: string | GoalConfig): GoalConfig {\r\n if (typeof goal === 'string') return { type: 'click' };\r\n return goal;\r\n}\r\n\r\nfunction isClickableTarget(el: EventTarget | null): boolean {\r\n if (!(el instanceof Element)) return false;\r\n const tag = el.tagName.toLowerCase();\r\n if (tag === 'a' || tag === 'button') return true;\r\n const role = el.getAttribute('role');\r\n return role === 'button';\r\n}\r\n\r\nfunction findClickable(start: Element, container: Element): boolean {\r\n let cursor: Element | null = start;\r\n while (cursor && cursor !== container) {\r\n if (isClickableTarget(cursor)) return true;\r\n cursor = cursor.parentElement;\r\n }\r\n return false;\r\n}\r\n\r\nfunction AdaptiveImpl(props: AdaptiveProps): JSX.Element | null {\r\n const client = useSentient();\r\n const projectId = useAdaptiveProjectId();\r\n const variantIds = useMemo(() => Object.keys(props.variants), [props.variants]);\r\n const { variantId } = useAssignment(props.id, variantIds);\r\n const containerRef = useRef<HTMLDivElement>(null);\r\n const [mounted, setMounted] = useState(false);\r\n\r\n useEffect(() => { setMounted(true); }, []);\r\n const goalFiredRef = useRef(false);\r\n const assignTrackedRef = useRef<string | null>(null);\r\n const goal = useMemo(() => normalize(props.goal), [props.goal]);\r\n const goalLabel = typeof props.goal === 'string' ? props.goal : goal.type;\r\n\r\n // Track variant_assigned exactly once per (component, variant) mount.\r\n // Captures innerHTML as previewHtml so the dashboard can render a live preview\r\n // without requiring manual registry calls. First-seen wins on the server.\r\n // `mounted` is in deps so the effect re-runs after clientOnly components hydrate\r\n // and their container div is actually in the DOM.\r\n useEffect(() => {\r\n if (!client || !variantId || !projectId) return;\r\n if (assignTrackedRef.current === variantId) return;\r\n const rawHtml = containerRef.current?.innerHTML ?? '';\r\n // For clientOnly, the container is null until mounted — defer until it exists.\r\n if (!rawHtml && !mounted) return;\r\n assignTrackedRef.current = variantId;\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId,\r\n eventType: 'variant_assigned',\r\n payload: rawHtml ? { previewHtml: rawHtml.slice(0, 30_000) } : {},\r\n });\r\n }, [client, variantId, projectId, props.id, mounted]);\r\n\r\n // Reset goal latch when variant changes.\r\n useEffect(() => {\r\n goalFiredRef.current = false;\r\n }, [variantId]);\r\n\r\n // Emit cursor_signal after 800 ms of continuous hover.\r\n useEffect(() => {\r\n if (!client || !variantId) return;\r\n const node = containerRef.current;\r\n if (!node) return;\r\n\r\n let timerId: ReturnType<typeof setTimeout> | null = null;\r\n let hoverStart = 0;\r\n\r\n const onEnter = (): void => {\r\n hoverStart = Date.now();\r\n timerId = setTimeout(() => {\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId: variantId!,\r\n eventType: 'cursor_signal',\r\n payload: { hoverDuration: Date.now() - hoverStart },\r\n });\r\n timerId = null;\r\n }, 800);\r\n };\r\n\r\n const onLeave = (): void => {\r\n if (timerId !== null) {\r\n clearTimeout(timerId);\r\n timerId = null;\r\n }\r\n };\r\n\r\n node.addEventListener('mouseenter', onEnter);\r\n node.addEventListener('mouseleave', onLeave);\r\n return () => {\r\n node.removeEventListener('mouseenter', onEnter);\r\n node.removeEventListener('mouseleave', onLeave);\r\n if (timerId !== null) clearTimeout(timerId);\r\n };\r\n }, [client, variantId, projectId, props.id]);\r\n\r\n // Attach goal tracking.\r\n useEffect(() => {\r\n if (!client || !variantId) return;\r\n const node = containerRef.current;\r\n if (!node) return;\r\n\r\n const fireGoal = (): void => {\r\n if (goalFiredRef.current) return;\r\n goalFiredRef.current = true;\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId,\r\n eventType: 'goal_achieved',\r\n goalType: goalLabel,\r\n payload: { reward: 1.0 },\r\n });\r\n };\r\n\r\n const subgoals: GoalConfig[] = goal.type === 'composite' ? goal.all : [goal];\r\n const remaining = new Set<number>(subgoals.map((_, i) => i));\r\n const checkComposite = (idx: number): void => {\r\n remaining.delete(idx);\r\n if (remaining.size === 0) fireGoal();\r\n };\r\n\r\n const cleanups: Array<() => void> = [];\r\n\r\n subgoals.forEach((sub, idx) => {\r\n if (sub.type === 'click') {\r\n const onClick = (e: MouseEvent): void => {\r\n const target = e.target;\r\n if (!(target instanceof Element)) return;\r\n if (!findClickable(target, node)) return;\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n };\r\n node.addEventListener('click', onClick);\r\n cleanups.push(() => node.removeEventListener('click', onClick));\r\n return;\r\n }\r\n\r\n if (sub.type === 'form_submit') {\r\n const onSubmit = (e: Event): void => {\r\n if (!(e.target instanceof HTMLFormElement)) return;\r\n if (!node.contains(e.target)) return;\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n };\r\n node.addEventListener('submit', onSubmit);\r\n cleanups.push(() => node.removeEventListener('submit', onSubmit));\r\n return;\r\n }\r\n\r\n if (sub.type === 'scroll_depth') {\r\n const threshold = Math.max(0, Math.min(1, sub.threshold));\r\n const io = new IntersectionObserver(\r\n (entries) => {\r\n for (const entry of entries) {\r\n if (entry.intersectionRatio >= threshold) {\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n io.disconnect();\r\n break;\r\n }\r\n }\r\n },\r\n { threshold: [threshold] },\r\n );\r\n io.observe(node);\r\n cleanups.push(() => io.disconnect());\r\n return;\r\n }\r\n });\r\n\r\n return () => {\r\n for (const c of cleanups) c();\r\n };\r\n }, [client, variantId, projectId, props.id, goal, goalLabel]);\r\n\r\n // Decorative slots: empty in SSR HTML and until the client has mounted.\r\n if (props.clientOnly && (!mounted || !client)) return null;\r\n if (!variantId) return null;\r\n const content = props.variants[variantId] ?? null;\r\n\r\n return (\r\n <div ref={containerRef} data-sentient-id={props.id} data-sentient-variant={variantId}>\r\n {content}\r\n </div>\r\n );\r\n}\r\n\r\n/** Re-renders only when the chosen variant changes. */\r\nexport const Adaptive = memo(AdaptiveImpl, (prev, next) => {\r\n if (prev.id !== next.id) return false;\r\n if (prev.goal !== next.goal) return false;\r\n if (prev.variants === next.variants) return true;\r\n const prevKeys = Object.keys(prev.variants);\r\n const nextKeys = Object.keys(next.variants);\r\n if (prevKeys.length !== nextKeys.length) return false;\r\n return prevKeys.every((k) => k in next.variants);\r\n});\r\n","import { useEffect, useRef, useState } from 'react';\r\nimport { useSentient, useInitialAssignments, useSessionSegment, useSsrFallback, useOnAssignment } from './provider.js';\r\nimport { subscribe, getWeights, type ComponentWeights } from './weights-store.js';\r\n\r\ndeclare global {\r\n interface Window { __sentient_overrides?: Record<string, string>; }\r\n}\r\n\r\nfunction getDevOverride(componentId: string): string | null {\r\n if (typeof window === 'undefined') return null;\r\n const global = window.__sentient_overrides?.[componentId];\r\n if (global) return global;\r\n try {\r\n const params = new URLSearchParams(window.location.search);\r\n for (const raw of params.getAll('sentient_variant')) {\r\n // sentient_variant=componentId:variantId (repeatable for multiple components)\r\n const sep = raw.indexOf(':');\r\n if (sep === -1) continue;\r\n if (raw.slice(0, sep) === componentId) return raw.slice(sep + 1);\r\n }\r\n } catch { /* non-browser env */ }\r\n return null;\r\n}\r\n\r\nexport type AssignmentState = {\r\n variantId: string | null;\r\n isLoading: boolean;\r\n};\r\n\r\nfunction pickFromWeights(weights: ComponentWeights, variantIds: string[]): string | null {\r\n let best: { variantId: string; avgReward: number } | null = null;\r\n for (const v of weights.variants) {\r\n if (!variantIds.includes(v.variantId)) continue;\r\n if (!best || v.avgReward > best.avgReward) {\r\n best = { variantId: v.variantId, avgReward: v.avgReward };\r\n }\r\n }\r\n return best?.variantId ?? null;\r\n}\r\n\r\n/**\r\n * Returns a sticky variant assignment for a component.\r\n *\r\n * First render reads the local SDK cache; if empty, falls back to a\r\n * deterministic default and asynchronously calls `/v1/assign`. The server\r\n * picks the actual variant via ε-greedy and the result replaces the fallback\r\n * on the next render. Subsequent paints read synchronously from cache —\r\n * no flicker, no loading state after first paint.\r\n */\r\nexport function useAssignment(componentId: string, variantIds: string[]): AssignmentState {\r\n const initialAssignments = useInitialAssignments();\r\n const ssrFallback = useSsrFallback();\r\n const client = useSentient();\r\n const segment = useSessionSegment();\r\n const onAssignment = useOnAssignment();\r\n const assignmentReportedRef = useRef<string | null>(null);\r\n\r\n // Dev override: URL param ?sentient_variant=componentId:variantId\r\n // or window.__sentient_overrides[componentId]. Short-circuits the bandit entirely.\r\n const devOverride = getDevOverride(componentId);\r\n const overrideVariant = devOverride && variantIds.includes(devOverride) ? devOverride : null;\r\n if (overrideVariant) {\r\n console.info(`[sentient] override active: ${componentId} -> ${overrideVariant}`);\r\n }\r\n\r\n const initial = (() => {\r\n if (overrideVariant) {\r\n return { variantId: overrideVariant, isLoading: false };\r\n }\r\n // SSR / pre-hydration: no client yet. Use initialAssignments if provided so\r\n // the server and client first render agree on the same variant (no mismatch).\r\n if (!client) {\r\n const preloaded = initialAssignments[componentId];\r\n if (preloaded && variantIds.includes(preloaded)) {\r\n return { variantId: preloaded, isLoading: false };\r\n }\r\n if (ssrFallback === 'first' && variantIds.length > 0) {\r\n return { variantId: variantIds[0], isLoading: false };\r\n }\r\n return { variantId: null, isLoading: true };\r\n }\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n return { variantId: cached.variantId, isLoading: false };\r\n }\r\n const weights = getWeights(componentId);\r\n if (weights) {\r\n const chosen = pickFromWeights(weights, variantIds);\r\n if (chosen) return { variantId: chosen, isLoading: false };\r\n }\r\n return { variantId: variantIds[0] ?? null, isLoading: false };\r\n })();\r\n\r\n const [state, setState] = useState<AssignmentState>(initial);\r\n\r\n // Helper: call onAssignment at most once per resolved variant.\r\n const reportAssignment = (variantId: string): void => {\r\n if (!onAssignment) return;\r\n if (assignmentReportedRef.current === variantId) return;\r\n assignmentReportedRef.current = variantId;\r\n onAssignment(componentId, variantId);\r\n };\r\n\r\n // As soon as the client is ready, unblock the UI immediately with variantIds[0]\r\n // (or a cached value) so the component never stays invisible while assign is\r\n // in-flight. The async assign call below then swaps to the bandit-chosen variant.\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n setState({ variantId: cached.variantId, isLoading: false });\r\n reportAssignment(cached.variantId);\r\n return;\r\n }\r\n setState((prev) => prev.variantId ? prev : { variantId: variantIds[0] ?? null, isLoading: false });\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n // Ask the server for a real assignment when we have a client but no cached one.\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) return;\r\n\r\n let cancelled = false;\r\n void client.assign(componentId, variantIds).then((result) => {\r\n if (cancelled) return;\r\n // If the API is unreachable or returns null, the fallback set above stays.\r\n if (!result || !variantIds.includes(result.variantId)) return;\r\n setState({ variantId: result.variantId, isLoading: false });\r\n reportAssignment(result.variantId);\r\n });\r\n return () => { cancelled = true; };\r\n // variantIds intentionally excluded — changing variants mid-mount is unsupported\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n // Live weight updates from the dashboard SSE stream (when wired).\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n return subscribe(componentId, (weights) => {\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n setState({ variantId: cached.variantId, isLoading: false });\r\n return;\r\n }\r\n const chosen = pickFromWeights(weights, variantIds);\r\n if (chosen) setState({ variantId: chosen, isLoading: false });\r\n });\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n if (overrideVariant) {\r\n return { variantId: overrideVariant, isLoading: false };\r\n }\r\n\r\n return state;\r\n}\r\n","/** Per-component weights store with isolated subscriptions. */\r\n\r\nexport type VariantWeight = {\r\n variantId: string;\r\n pulls: number;\r\n avgReward: number;\r\n};\r\n\r\nexport type ComponentWeights = {\r\n componentId: string;\r\n variants: VariantWeight[];\r\n updatedAt: number;\r\n};\r\n\r\ntype Listener = (weights: ComponentWeights) => void;\r\n\r\nconst store = new Map<string, ComponentWeights>();\r\nconst listeners = new Map<string, Set<Listener>>();\r\n\r\n/**\r\n * Subscribes a listener to a single component. Returns an unsubscribe function.\r\n * Updates to other components never trigger this listener.\r\n */\r\nexport function subscribe(componentId: string, cb: Listener): () => void {\r\n let set = listeners.get(componentId);\r\n if (!set) {\r\n set = new Set();\r\n listeners.set(componentId, set);\r\n }\r\n set.add(cb);\r\n return () => {\r\n set!.delete(cb);\r\n if (set!.size === 0) listeners.delete(componentId);\r\n };\r\n}\r\n\r\n/**\r\n * Replaces the weights for a component and notifies only that component's\r\n * subscribers.\r\n */\r\nexport function update(componentId: string, weights: ComponentWeights): void {\r\n store.set(componentId, weights);\r\n const set = listeners.get(componentId);\r\n if (!set) return;\r\n for (const cb of set) {\r\n try {\r\n cb(weights);\r\n } catch {\r\n /* never throw to other listeners */\r\n }\r\n }\r\n}\r\n\r\n/**\r\n * Returns the latest known weights for a component, or null if none seen.\r\n */\r\nexport function getWeights(componentId: string): ComponentWeights | null {\r\n return store.get(componentId) ?? null;\r\n}\r\n\r\n/** Test-only: wipe the entire store. */\r\nexport function _resetWeightsStore(): void {\r\n store.clear();\r\n listeners.clear();\r\n}\r\n","/** @deprecated Use `useSessionSegment()` from the provider, or `deriveSessionSegment` from `@sentientui/core`. */\nexport { deriveSessionSegment as detectSegment } from '@sentientui/core';\n"],"mappings":"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","names":["useEffect","useRef","useState","useEffect","useState","useState","useEffect","jsx","useRef","useState","useEffect","_a"]}
1
+ {"version":3,"sources":["../src/provider.tsx","../src/adaptive.tsx","../src/use-assignment.ts","../src/weights-store.ts","../src/segment.ts"],"sourcesContent":["'use client';\r\n\r\nimport { createContext, useContext, useEffect, useState, type ReactNode } from 'react';\r\nimport { init, type SentientClient, type SentientConfig } from '@sentientui/core';\r\n\r\n/** How to render adaptive slots during SSR when assignments are not preloaded. */\r\nexport type SsrFallback = 'first' | 'none';\r\n\r\ntype AdaptiveContextValue = {\r\n client: SentientClient | null;\r\n projectId: string;\r\n initialAssignments: Record<string, string>;\r\n sessionSegment: string;\r\n ssrFallback: SsrFallback;\r\n onAssignment: ((componentId: string, variantId: string) => void) | undefined;\r\n};\r\n\r\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\r\n client: null,\r\n projectId: '',\r\n initialAssignments: {},\r\n sessionSegment: 'desktop:direct',\r\n ssrFallback: 'first',\r\n onAssignment: undefined,\r\n});\r\n\r\nexport type AdaptiveProviderProps = {\r\n apiKey: string;\r\n context: SentientConfig['context'];\r\n ingestUrl: string;\r\n debug?: boolean;\r\n /**\r\n * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.\r\n * Passed through to `useAssignment` as synchronous initial state so crawlers and\r\n * the first paint see real content (recommended for SEO).\r\n */\r\n initialAssignments?: Record<string, string>;\r\n /**\r\n * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker\r\n * weights on one row — must match `loadAdaptiveAssignments` / session upsert.\r\n */\r\n sessionSegment?: string;\r\n /**\r\n * When no `initialAssignments` exist for a component, `'first'` renders\r\n * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for\r\n * decorative slots marked `clientOnly`.\r\n * @default 'first'\r\n */\r\n ssrFallback?: SsrFallback;\r\n /**\r\n * Consent gate. When `false` the SDK is not initialised and no events are\r\n * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to\r\n * initialise and begin tracking.\r\n */\r\n consent?: boolean;\r\n /**\r\n * Called once per component the first time a variant is resolved for that\r\n * component in this session. Use to forward assignments to your own analytics\r\n * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.\r\n */\r\n onAssignment?: (componentId: string, variantId: string) => void;\r\n children: ReactNode;\r\n};\r\n\r\n/**\r\n * Initialises the Sentient core SDK in a useEffect (SSR-safe) and exposes the\r\n * client via React context. Re-initialises when `consent` changes.\r\n */\r\nexport function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element {\r\n const [client, setClient] = useState<SentientClient | null>(null);\r\n\r\n useEffect(() => {\r\n // When consent is explicitly false, tear down any existing client.\r\n if (props.consent === false) {\r\n setClient((prev: SentientClient | null) => {\r\n prev?.destroy();\r\n return null;\r\n });\r\n return;\r\n }\r\n\r\n const c = init({\r\n apiKey: props.apiKey,\r\n context: props.context,\r\n ingestUrl: props.ingestUrl,\r\n debug: props.debug,\r\n initialAssignments: props.initialAssignments,\r\n sessionSegment: props.sessionSegment,\r\n consent: props.consent,\r\n });\r\n setClient(c);\r\n return () => {\r\n c.destroy();\r\n };\r\n // Re-init when consent changes. Other props are intentionally stable.\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [props.consent]);\r\n\r\n const ssrFallback = props.ssrFallback ?? 'first';\r\n\r\n return (\r\n <AdaptiveContext.Provider\r\n value={{\r\n client,\r\n projectId: props.apiKey,\r\n initialAssignments: props.initialAssignments ?? {},\r\n sessionSegment: props.sessionSegment ?? 'desktop:direct',\r\n ssrFallback,\r\n onAssignment: props.onAssignment,\r\n }}\r\n >\r\n {props.children}\r\n </AdaptiveContext.Provider>\r\n );\r\n}\r\n\r\n/**\r\n * Returns the SentientClient, or null until the provider has finished\r\n * initialising on the client.\r\n */\r\nexport function useSentient(): SentientClient | null {\r\n return useContext(AdaptiveContext).client;\r\n}\r\n\r\n/** Internal: project identifier carried alongside the client. */\r\nexport function useAdaptiveProjectId(): string {\r\n return useContext(AdaptiveContext).projectId;\r\n}\r\n\r\n/** Internal: SSR-preloaded assignments for hydration-safe first render. */\r\nexport function useInitialAssignments(): Record<string, string> {\r\n return useContext(AdaptiveContext).initialAssignments;\r\n}\r\n\r\n/** Internal: bandit segment aligned with SSR session upsert. */\r\nexport function useSessionSegment(): string {\r\n return useContext(AdaptiveContext).sessionSegment;\r\n}\r\n\r\n/** Internal: SSR fallback strategy when a slot has no preloaded assignment. */\r\nexport function useSsrFallback(): SsrFallback {\r\n return useContext(AdaptiveContext).ssrFallback;\r\n}\r\n\r\n/** Internal: forwarding hook for consumer analytics integration. */\r\nexport function useOnAssignment(): ((componentId: string, variantId: string) => void) | undefined {\r\n return useContext(AdaptiveContext).onAssignment;\r\n}\r\n","'use client';\r\n\r\nimport { memo, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';\r\nimport { useAdaptiveProjectId, useSentient } from './provider.js';\r\nimport { useAssignment } from './use-assignment.js';\r\n\r\nexport type ScrollDepthGoal = { type: 'scroll_depth'; threshold: number };\r\nexport type ClickGoal = { type: 'click'; selector?: string };\r\nexport type FormSubmitGoal = { type: 'form_submit' };\r\nexport type CompositeGoal = { type: 'composite'; all: GoalConfig[] };\r\nexport type GoalConfig = ScrollDepthGoal | ClickGoal | FormSubmitGoal | CompositeGoal;\r\n\r\nexport type AdaptiveProps = {\r\n id: string;\r\n variants: Record<string, ReactNode>;\r\n goal: string | GoalConfig;\r\n /**\r\n * When true, renders nothing during SSR and before client hydration.\r\n * Use when you cannot pass `initialAssignments` and prefer a blank slot over\r\n * a hydration mismatch. Tradeoff: minor CLS on first paint.\r\n */\r\n clientOnly?: boolean;\r\n};\r\n\r\nfunction normalize(goal: string | GoalConfig): GoalConfig {\r\n if (typeof goal === 'string') return { type: 'click' };\r\n return goal;\r\n}\r\n\r\nfunction isClickableTarget(el: EventTarget | null): boolean {\r\n if (!(el instanceof Element)) return false;\r\n const tag = el.tagName.toLowerCase();\r\n if (tag === 'a' || tag === 'button') return true;\r\n const role = el.getAttribute('role');\r\n return role === 'button';\r\n}\r\n\r\nfunction findClickable(start: Element, container: Element): boolean {\r\n let cursor: Element | null = start;\r\n while (cursor && cursor !== container) {\r\n if (isClickableTarget(cursor)) return true;\r\n cursor = cursor.parentElement;\r\n }\r\n return false;\r\n}\r\n\r\nfunction AdaptiveImpl(props: AdaptiveProps): JSX.Element | null {\r\n const client = useSentient();\r\n const projectId = useAdaptiveProjectId();\r\n const variantIds = useMemo(() => Object.keys(props.variants), [props.variants]);\r\n const { variantId } = useAssignment(props.id, variantIds);\r\n const containerRef = useRef<HTMLDivElement>(null);\r\n const [mounted, setMounted] = useState(false);\r\n\r\n useEffect(() => { setMounted(true); }, []);\r\n const goalFiredRef = useRef(false);\r\n const assignTrackedRef = useRef<string | null>(null);\r\n const goal = useMemo(() => normalize(props.goal), [props.goal]);\r\n const goalLabel = typeof props.goal === 'string' ? props.goal : goal.type;\r\n\r\n // Track variant_assigned exactly once per (component, variant) mount.\r\n // Captures innerHTML as previewHtml so the dashboard can render a live preview\r\n // without requiring manual registry calls. First-seen wins on the server.\r\n // `mounted` is in deps so the effect re-runs after clientOnly components hydrate\r\n // and their container div is actually in the DOM.\r\n useEffect(() => {\r\n if (!client || !variantId || !projectId) return;\r\n if (assignTrackedRef.current === variantId) return;\r\n const rawHtml = containerRef.current?.innerHTML ?? '';\r\n // For clientOnly, the container is null until mounted — defer until it exists.\r\n if (!rawHtml && !mounted) return;\r\n assignTrackedRef.current = variantId;\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId,\r\n eventType: 'variant_assigned',\r\n payload: rawHtml ? { previewHtml: rawHtml.slice(0, 30_000) } : {},\r\n });\r\n }, [client, variantId, projectId, props.id, mounted]);\r\n\r\n // Reset goal latch when variant changes.\r\n useEffect(() => {\r\n goalFiredRef.current = false;\r\n }, [variantId]);\r\n\r\n // Emit cursor_signal after 800 ms of continuous hover.\r\n useEffect(() => {\r\n if (!client || !variantId) return;\r\n const node = containerRef.current;\r\n if (!node) return;\r\n\r\n let timerId: ReturnType<typeof setTimeout> | null = null;\r\n let hoverStart = 0;\r\n\r\n const onEnter = (): void => {\r\n hoverStart = Date.now();\r\n timerId = setTimeout(() => {\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId: variantId!,\r\n eventType: 'cursor_signal',\r\n payload: { hoverDuration: Date.now() - hoverStart },\r\n });\r\n timerId = null;\r\n }, 800);\r\n };\r\n\r\n const onLeave = (): void => {\r\n if (timerId !== null) {\r\n clearTimeout(timerId);\r\n timerId = null;\r\n }\r\n };\r\n\r\n node.addEventListener('mouseenter', onEnter);\r\n node.addEventListener('mouseleave', onLeave);\r\n return () => {\r\n node.removeEventListener('mouseenter', onEnter);\r\n node.removeEventListener('mouseleave', onLeave);\r\n if (timerId !== null) clearTimeout(timerId);\r\n };\r\n }, [client, variantId, projectId, props.id]);\r\n\r\n // Attach goal tracking.\r\n useEffect(() => {\r\n if (!client || !variantId) return;\r\n const node = containerRef.current;\r\n if (!node) return;\r\n\r\n const fireGoal = (): void => {\r\n if (goalFiredRef.current) return;\r\n goalFiredRef.current = true;\r\n client.track({\r\n projectId,\r\n componentId: props.id,\r\n variantId,\r\n eventType: 'goal_achieved',\r\n goalType: goalLabel,\r\n payload: { reward: 1.0 },\r\n });\r\n };\r\n\r\n const subgoals: GoalConfig[] = goal.type === 'composite' ? goal.all : [goal];\r\n const remaining = new Set<number>(subgoals.map((_, i) => i));\r\n const checkComposite = (idx: number): void => {\r\n remaining.delete(idx);\r\n if (remaining.size === 0) fireGoal();\r\n };\r\n\r\n const cleanups: Array<() => void> = [];\r\n\r\n subgoals.forEach((sub, idx) => {\r\n if (sub.type === 'click') {\r\n const onClick = (e: MouseEvent): void => {\r\n const target = e.target;\r\n if (!(target instanceof Element)) return;\r\n if (!findClickable(target, node)) return;\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n };\r\n node.addEventListener('click', onClick);\r\n cleanups.push(() => node.removeEventListener('click', onClick));\r\n return;\r\n }\r\n\r\n if (sub.type === 'form_submit') {\r\n const onSubmit = (e: Event): void => {\r\n if (!(e.target instanceof HTMLFormElement)) return;\r\n if (!node.contains(e.target)) return;\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n };\r\n node.addEventListener('submit', onSubmit);\r\n cleanups.push(() => node.removeEventListener('submit', onSubmit));\r\n return;\r\n }\r\n\r\n if (sub.type === 'scroll_depth') {\r\n const threshold = Math.max(0, Math.min(1, sub.threshold));\r\n const io = new IntersectionObserver(\r\n (entries) => {\r\n for (const entry of entries) {\r\n if (entry.intersectionRatio >= threshold) {\r\n if (goal.type === 'composite') checkComposite(idx);\r\n else fireGoal();\r\n io.disconnect();\r\n break;\r\n }\r\n }\r\n },\r\n { threshold: [threshold] },\r\n );\r\n io.observe(node);\r\n cleanups.push(() => io.disconnect());\r\n return;\r\n }\r\n });\r\n\r\n return () => {\r\n for (const c of cleanups) c();\r\n };\r\n }, [client, variantId, projectId, props.id, goal, goalLabel]);\r\n\r\n // Decorative slots: empty in SSR HTML and until the client has mounted.\r\n if (props.clientOnly && (!mounted || !client)) return null;\r\n if (!variantId) return null;\r\n const content = props.variants[variantId] ?? null;\r\n\r\n return (\r\n <div ref={containerRef} data-sentient-id={props.id} data-sentient-variant={variantId}>\r\n {content}\r\n </div>\r\n );\r\n}\r\n\r\n/** Re-renders only when the chosen variant changes. */\r\nexport const Adaptive = memo(AdaptiveImpl, (prev, next) => {\r\n if (prev.id !== next.id) return false;\r\n if (prev.goal !== next.goal) return false;\r\n if (prev.variants === next.variants) return true;\r\n const prevKeys = Object.keys(prev.variants);\r\n const nextKeys = Object.keys(next.variants);\r\n if (prevKeys.length !== nextKeys.length) return false;\r\n return prevKeys.every((k) => k in next.variants);\r\n});\r\n","import { useEffect, useRef, useState } from 'react';\r\nimport { type AssignResult } from '@sentientui/core';\r\nimport { useSentient, useInitialAssignments, useSessionSegment, useSsrFallback, useOnAssignment } from './provider.js';\r\nimport { subscribe, getWeights, type ComponentWeights } from './weights-store.js';\r\n\r\ndeclare global {\r\n interface Window { __sentient_overrides?: Record<string, string>; }\r\n}\r\n\r\nfunction getDevOverride(componentId: string): string | null {\r\n if (typeof window === 'undefined') return null;\r\n const global = window.__sentient_overrides?.[componentId];\r\n if (global) return global;\r\n try {\r\n const params = new URLSearchParams(window.location.search);\r\n for (const raw of params.getAll('sentient_variant')) {\r\n // sentient_variant=componentId:variantId (repeatable for multiple components)\r\n const sep = raw.indexOf(':');\r\n if (sep === -1) continue;\r\n if (raw.slice(0, sep) === componentId) return raw.slice(sep + 1);\r\n }\r\n } catch { /* non-browser env */ }\r\n return null;\r\n}\r\n\r\nexport type AssignmentState = {\r\n variantId: string | null;\r\n isLoading: boolean;\r\n};\r\n\r\nfunction pickFromWeights(weights: ComponentWeights, variantIds: string[]): string | null {\r\n let best: { variantId: string; avgReward: number } | null = null;\r\n for (const v of weights.variants) {\r\n if (!variantIds.includes(v.variantId)) continue;\r\n if (!best || v.avgReward > best.avgReward) {\r\n best = { variantId: v.variantId, avgReward: v.avgReward };\r\n }\r\n }\r\n return best?.variantId ?? null;\r\n}\r\n\r\n/**\r\n * Returns a sticky variant assignment for a component.\r\n *\r\n * First render reads the local SDK cache; if empty, falls back to a\r\n * deterministic default and asynchronously calls `/v1/assign`. The server\r\n * picks the actual variant via ε-greedy and the result replaces the fallback\r\n * on the next render. Subsequent paints read synchronously from cache —\r\n * no flicker, no loading state after first paint.\r\n */\r\nexport function useAssignment(componentId: string, variantIds: string[]): AssignmentState {\r\n const initialAssignments = useInitialAssignments();\r\n const ssrFallback = useSsrFallback();\r\n const client = useSentient();\r\n const segment = useSessionSegment();\r\n const onAssignment = useOnAssignment();\r\n const assignmentReportedRef = useRef<string | null>(null);\r\n\r\n // Dev override: URL param ?sentient_variant=componentId:variantId\r\n // or window.__sentient_overrides[componentId]. Short-circuits the bandit entirely.\r\n const devOverride = getDevOverride(componentId);\r\n const overrideVariant = devOverride && variantIds.includes(devOverride) ? devOverride : null;\r\n if (overrideVariant) {\r\n console.info(`[sentient] override active: ${componentId} -> ${overrideVariant}`);\r\n }\r\n\r\n const initial = (() => {\r\n if (overrideVariant) {\r\n return { variantId: overrideVariant, isLoading: false };\r\n }\r\n // SSR / pre-hydration: no client yet. Use initialAssignments if provided so\r\n // the server and client first render agree on the same variant (no mismatch).\r\n if (!client) {\r\n const preloaded = initialAssignments[componentId];\r\n if (preloaded && variantIds.includes(preloaded)) {\r\n return { variantId: preloaded, isLoading: false };\r\n }\r\n if (ssrFallback === 'first' && variantIds.length > 0) {\r\n return { variantId: variantIds[0], isLoading: false };\r\n }\r\n return { variantId: null, isLoading: true };\r\n }\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n return { variantId: cached.variantId, isLoading: false };\r\n }\r\n const weights = getWeights(componentId);\r\n if (weights) {\r\n const chosen = pickFromWeights(weights, variantIds);\r\n if (chosen) return { variantId: chosen, isLoading: false };\r\n }\r\n return { variantId: variantIds[0] ?? null, isLoading: false };\r\n })();\r\n\r\n const [state, setState] = useState<AssignmentState>(initial);\r\n\r\n // Helper: call onAssignment at most once per resolved variant.\r\n const reportAssignment = (variantId: string): void => {\r\n if (!onAssignment) return;\r\n if (assignmentReportedRef.current === variantId) return;\r\n assignmentReportedRef.current = variantId;\r\n onAssignment(componentId, variantId);\r\n };\r\n\r\n // As soon as the client is ready, unblock the UI immediately with variantIds[0]\r\n // (or a cached value) so the component never stays invisible while assign is\r\n // in-flight. The async assign call below then swaps to the bandit-chosen variant.\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n setState({ variantId: cached.variantId, isLoading: false });\r\n reportAssignment(cached.variantId);\r\n return;\r\n }\r\n setState((prev) => prev.variantId ? prev : { variantId: variantIds[0] ?? null, isLoading: false });\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n // Ask the server for a real assignment when we have a client but no cached one.\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) return;\r\n\r\n let cancelled = false;\r\n void client.assign(componentId, variantIds).then((result: AssignResult | null) => {\r\n if (cancelled) return;\r\n // If the API is unreachable or returns null, the fallback set above stays.\r\n if (!result || !variantIds.includes(result.variantId)) return;\r\n setState({ variantId: result.variantId, isLoading: false });\r\n reportAssignment(result.variantId);\r\n });\r\n return () => { cancelled = true; };\r\n // variantIds intentionally excluded — changing variants mid-mount is unsupported\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n // Live weight updates from the dashboard SSE stream (when wired).\r\n useEffect(() => {\r\n if (overrideVariant) return;\r\n if (!client) return;\r\n return subscribe(componentId, (weights) => {\r\n const cached = client.getAssignment(componentId, segment);\r\n if (cached && variantIds.includes(cached.variantId)) {\r\n setState({ variantId: cached.variantId, isLoading: false });\r\n return;\r\n }\r\n const chosen = pickFromWeights(weights, variantIds);\r\n if (chosen) setState({ variantId: chosen, isLoading: false });\r\n });\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [overrideVariant, client, componentId, segment]);\r\n\r\n if (overrideVariant) {\r\n return { variantId: overrideVariant, isLoading: false };\r\n }\r\n\r\n return state;\r\n}\r\n","/** Per-component weights store with isolated subscriptions. */\n\nexport type VariantWeight = {\n variantId: string;\n pulls: number;\n avgReward: number;\n};\n\nexport type ComponentWeights = {\n componentId: string;\n variants: VariantWeight[];\n updatedAt: number;\n};\n\ntype Listener = (weights: ComponentWeights) => void;\n\nconst store = new Map<string, ComponentWeights>();\nconst listeners = new Map<string, Set<Listener>>();\n\n/**\n * Subscribes a listener to a single component. Returns an unsubscribe function.\n * Updates to other components never trigger this listener.\n */\nexport function subscribe(componentId: string, cb: Listener): () => void {\n let set = listeners.get(componentId);\n if (!set) {\n set = new Set();\n listeners.set(componentId, set);\n }\n set.add(cb);\n return () => {\n set!.delete(cb);\n if (set!.size === 0) listeners.delete(componentId);\n };\n}\n\n/**\n * Replaces the weights for a component and notifies only that component's\n * subscribers.\n */\nexport function update(componentId: string, weights: ComponentWeights): void {\n store.set(componentId, weights);\n const set = listeners.get(componentId);\n if (!set) return;\n for (const cb of set) {\n try {\n cb(weights);\n } catch {\n /* never throw to other listeners */\n }\n }\n}\n\n/**\n * Returns the latest known weights for a component, or null if none seen.\n */\nexport function getWeights(componentId: string): ComponentWeights | null {\n return store.get(componentId) ?? null;\n}\n\n/** Test-only: wipe the entire store. */\nexport function _resetWeightsStore(): void {\n store.clear();\n listeners.clear();\n}\n","/** @deprecated Use `useSessionSegment()` from the provider, or `deriveSessionSegment` from `@sentientui/core`. */\r\nexport { deriveSessionSegment as detectSegment } from '@sentientui/core';\r\n"],"mappings":"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","names":["useEffect","useRef","useState","useEffect","useState","useState","useEffect","jsx","useRef","useState","useEffect","_a"]}
package/dist/next/adaptive-root-client.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/provider.tsx","../../src/next/adaptive-root-client.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useEffect, useState, type ReactNode } from 'react';\nimport { init, type SentientClient, type SentientConfig } from '@sentientui/core';\n\n/** How to render adaptive slots during SSR when assignments are not preloaded. */\nexport type SsrFallback = 'first' | 'none';\n\ntype AdaptiveContextValue = {\n client: SentientClient | null;\n projectId: string;\n initialAssignments: Record<string, string>;\n sessionSegment: string;\n ssrFallback: SsrFallback;\n onAssignment: ((componentId: string, variantId: string) => void) | undefined;\n};\n\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\n client: null,\n projectId: '',\n initialAssignments: {},\n sessionSegment: 'desktop:direct',\n ssrFallback: 'first',\n onAssignment: undefined,\n});\n\nexport type AdaptiveProviderProps = {\n apiKey: string;\n context: SentientConfig['context'];\n ingestUrl: string;\n debug?: boolean;\n /**\n * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.\n * Passed through to `useAssignment` as synchronous initial state so crawlers and\n * the first paint see real content (recommended for SEO).\n */\n initialAssignments?: Record<string, string>;\n /**\n * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker\n * weights on one row — must match `loadAdaptiveAssignments` / session upsert.\n */\n sessionSegment?: string;\n /**\n * When no `initialAssignments` exist for a component, `'first'` renders\n * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for\n * decorative slots marked `clientOnly`.\n * @default 'first'\n */\n ssrFallback?: SsrFallback;\n /**\n * Consent gate. When `false` the SDK is not initialised and no events are\n * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to\n * initialise and begin tracking.\n */\n consent?: boolean;\n /**\n * Called once per component the first time a variant is resolved for that\n * component in this session. Use to forward assignments to your own analytics\n * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.\n */\n onAssignment?: (componentId: string, variantId: string) => void;\n children: ReactNode;\n};\n\n/**\n * Initialises the Sentient core SDK in a useEffect (SSR-safe) and exposes the\n * client via React context. Re-initialises when `consent` changes.\n */\nexport function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element {\n const [client, setClient] = useState<SentientClient | null>(null);\n\n useEffect(() => {\n // When consent is explicitly false, tear down any existing client.\n if (props.consent === false) {\n setClient((prev) => {\n prev?.destroy();\n return null;\n });\n return;\n }\n\n const c = init({\n apiKey: props.apiKey,\n context: props.context,\n ingestUrl: props.ingestUrl,\n debug: props.debug,\n initialAssignments: props.initialAssignments,\n sessionSegment: props.sessionSegment,\n consent: props.consent,\n });\n setClient(c);\n return () => {\n c.destroy();\n };\n // Re-init when consent changes. Other props are intentionally stable.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [props.consent]);\n\n const ssrFallback = props.ssrFallback ?? 'first';\n\n return (\n <AdaptiveContext.Provider\n value={{\n client,\n projectId: props.apiKey,\n initialAssignments: props.initialAssignments ?? {},\n sessionSegment: props.sessionSegment ?? 'desktop:direct',\n ssrFallback,\n onAssignment: props.onAssignment,\n }}\n >\n {props.children}\n </AdaptiveContext.Provider>\n );\n}\n\n/**\n * Returns the SentientClient, or null until the provider has finished\n * initialising on the client.\n */\nexport function useSentient(): SentientClient | null {\n return useContext(AdaptiveContext).client;\n}\n\n/** Internal: project identifier carried alongside the client. */\nexport function useAdaptiveProjectId(): string {\n return useContext(AdaptiveContext).projectId;\n}\n\n/** Internal: SSR-preloaded assignments for hydration-safe first render. */\nexport function useInitialAssignments(): Record<string, string> {\n return useContext(AdaptiveContext).initialAssignments;\n}\n\n/** Internal: bandit segment aligned with SSR session upsert. */\nexport function useSessionSegment(): string {\n return useContext(AdaptiveContext).sessionSegment;\n}\n\n/** Internal: SSR fallback strategy when a slot has no preloaded assignment. */\nexport function useSsrFallback(): SsrFallback {\n return useContext(AdaptiveContext).ssrFallback;\n}\n\n/** Internal: forwarding hook for consumer analytics integration. */\nexport function useOnAssignment(): ((componentId: string, variantId: string) => void) | undefined {\n return useContext(AdaptiveContext).onAssignment;\n}\n","'use client';\r\n\r\nimport type { ReactNode } from 'react';\r\nimport { AdaptiveProvider, type AdaptiveProviderProps } from '../provider.js';\r\n\r\nexport type AdaptiveRootClientProps = AdaptiveProviderProps & {\r\n children: ReactNode;\r\n};\r\n\r\n/** Client boundary for {@link AdaptiveRoot} — keeps context/hooks out of the server bundle. */\r\nexport function AdaptiveRootClient(props: AdaptiveRootClientProps): JSX.Element {\r\n return <AdaptiveProvider {...props} />;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAEA,SAAS,eAAe,YAAY,WAAW,gBAAgC;AAC/E,SAAS,YAAsD;AAkG3D;AApFJ,IAAM,kBAAkB,cAAoC;AAAA,EAC1D,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,oBAAoB,CAAC;AAAA,EACrB,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,cAAc;AAChB,CAAC;AA4CM,SAAS,iBAAiB,OAA2C;AApE5E;AAqEE,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAgC,IAAI;AAEhE,YAAU,MAAM;AAEd,QAAI,MAAM,YAAY,OAAO;AAC3B,gBAAU,CAAC,SAAS;AAClB,qCAAM;AACN,eAAO;AAAA,MACT,CAAC;AACD;AAAA,IACF;AAEA,UAAM,IAAI,KAAK;AAAA,MACb,QAAQ,MAAM;AAAA,MACd,SAAS,MAAM;AAAA,MACf,WAAW,MAAM;AAAA,MACjB,OAAO,MAAM;AAAA,MACb,oBAAoB,MAAM;AAAA,MAC1B,gBAAgB,MAAM;AAAA,MACtB,SAAS,MAAM;AAAA,IACjB,CAAC;AACD,cAAU,CAAC;AACX,WAAO,MAAM;AACX,QAAE,QAAQ;AAAA,IACZ;AAAA,EAGF,GAAG,CAAC,MAAM,OAAO,CAAC;AAElB,QAAM,eAAc,WAAM,gBAAN,YAAqB;AAEzC,SACE;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC,OAAO;AAAA,QACL;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,qBAAoB,WAAM,uBAAN,YAA4B,CAAC;AAAA,QACjD,iBAAgB,WAAM,mBAAN,YAAwB;AAAA,QACxC;AAAA,QACA,cAAc,MAAM;AAAA,MACtB;AAAA,MAEC,gBAAM;AAAA;AAAA,EACT;AAEJ;;;ACvGS,gBAAAA,YAAA;AADF,SAAS,mBAAmB,OAA6C;AAC9E,SAAO,gBAAAA,KAAC,qCAAqB,MAAO;AACtC;","names":["jsx"]}
1
+ {"version":3,"sources":["../../src/provider.tsx","../../src/next/adaptive-root-client.tsx"],"sourcesContent":["'use client';\r\n\r\nimport { createContext, useContext, useEffect, useState, type ReactNode } from 'react';\r\nimport { init, type SentientClient, type SentientConfig } from '@sentientui/core';\r\n\r\n/** How to render adaptive slots during SSR when assignments are not preloaded. */\r\nexport type SsrFallback = 'first' | 'none';\r\n\r\ntype AdaptiveContextValue = {\r\n client: SentientClient | null;\r\n projectId: string;\r\n initialAssignments: Record<string, string>;\r\n sessionSegment: string;\r\n ssrFallback: SsrFallback;\r\n onAssignment: ((componentId: string, variantId: string) => void) | undefined;\r\n};\r\n\r\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\r\n client: null,\r\n projectId: '',\r\n initialAssignments: {},\r\n sessionSegment: 'desktop:direct',\r\n ssrFallback: 'first',\r\n onAssignment: undefined,\r\n});\r\n\r\nexport type AdaptiveProviderProps = {\r\n apiKey: string;\r\n context: SentientConfig['context'];\r\n ingestUrl: string;\r\n debug?: boolean;\r\n /**\r\n * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.\r\n * Passed through to `useAssignment` as synchronous initial state so crawlers and\r\n * the first paint see real content (recommended for SEO).\r\n */\r\n initialAssignments?: Record<string, string>;\r\n /**\r\n * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker\r\n * weights on one row — must match `loadAdaptiveAssignments` / session upsert.\r\n */\r\n sessionSegment?: string;\r\n /**\r\n * When no `initialAssignments` exist for a component, `'first'` renders\r\n * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for\r\n * decorative slots marked `clientOnly`.\r\n * @default 'first'\r\n */\r\n ssrFallback?: SsrFallback;\r\n /**\r\n * Consent gate. When `false` the SDK is not initialised and no events are\r\n * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to\r\n * initialise and begin tracking.\r\n */\r\n consent?: boolean;\r\n /**\r\n * Called once per component the first time a variant is resolved for that\r\n * component in this session. Use to forward assignments to your own analytics\r\n * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.\r\n */\r\n onAssignment?: (componentId: string, variantId: string) => void;\r\n children: ReactNode;\r\n};\r\n\r\n/**\r\n * Initialises the Sentient core SDK in a useEffect (SSR-safe) and exposes the\r\n * client via React context. Re-initialises when `consent` changes.\r\n */\r\nexport function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element {\r\n const [client, setClient] = useState<SentientClient | null>(null);\r\n\r\n useEffect(() => {\r\n // When consent is explicitly false, tear down any existing client.\r\n if (props.consent === false) {\r\n setClient((prev: SentientClient | null) => {\r\n prev?.destroy();\r\n return null;\r\n });\r\n return;\r\n }\r\n\r\n const c = init({\r\n apiKey: props.apiKey,\r\n context: props.context,\r\n ingestUrl: props.ingestUrl,\r\n debug: props.debug,\r\n initialAssignments: props.initialAssignments,\r\n sessionSegment: props.sessionSegment,\r\n consent: props.consent,\r\n });\r\n setClient(c);\r\n return () => {\r\n c.destroy();\r\n };\r\n // Re-init when consent changes. Other props are intentionally stable.\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [props.consent]);\r\n\r\n const ssrFallback = props.ssrFallback ?? 'first';\r\n\r\n return (\r\n <AdaptiveContext.Provider\r\n value={{\r\n client,\r\n projectId: props.apiKey,\r\n initialAssignments: props.initialAssignments ?? {},\r\n sessionSegment: props.sessionSegment ?? 'desktop:direct',\r\n ssrFallback,\r\n onAssignment: props.onAssignment,\r\n }}\r\n >\r\n {props.children}\r\n </AdaptiveContext.Provider>\r\n );\r\n}\r\n\r\n/**\r\n * Returns the SentientClient, or null until the provider has finished\r\n * initialising on the client.\r\n */\r\nexport function useSentient(): SentientClient | null {\r\n return useContext(AdaptiveContext).client;\r\n}\r\n\r\n/** Internal: project identifier carried alongside the client. */\r\nexport function useAdaptiveProjectId(): string {\r\n return useContext(AdaptiveContext).projectId;\r\n}\r\n\r\n/** Internal: SSR-preloaded assignments for hydration-safe first render. */\r\nexport function useInitialAssignments(): Record<string, string> {\r\n return useContext(AdaptiveContext).initialAssignments;\r\n}\r\n\r\n/** Internal: bandit segment aligned with SSR session upsert. */\r\nexport function useSessionSegment(): string {\r\n return useContext(AdaptiveContext).sessionSegment;\r\n}\r\n\r\n/** Internal: SSR fallback strategy when a slot has no preloaded assignment. */\r\nexport function useSsrFallback(): SsrFallback {\r\n return useContext(AdaptiveContext).ssrFallback;\r\n}\r\n\r\n/** Internal: forwarding hook for consumer analytics integration. */\r\nexport function useOnAssignment(): ((componentId: string, variantId: string) => void) | undefined {\r\n return useContext(AdaptiveContext).onAssignment;\r\n}\r\n","'use client';\r\n\r\nimport type { ReactNode } from 'react';\r\nimport { AdaptiveProvider, type AdaptiveProviderProps } from '../provider.js';\r\n\r\nexport type AdaptiveRootClientProps = AdaptiveProviderProps & {\r\n children: ReactNode;\r\n};\r\n\r\n/** Client boundary for {@link AdaptiveRoot} — keeps context/hooks out of the server bundle. */\r\nexport function AdaptiveRootClient(props: AdaptiveRootClientProps): JSX.Element {\r\n return <AdaptiveProvider {...props} />;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAEA,SAAS,eAAe,YAAY,WAAW,gBAAgC;AAC/E,SAAS,YAAsD;AAkG3D;AApFJ,IAAM,kBAAkB,cAAoC;AAAA,EAC1D,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,oBAAoB,CAAC;AAAA,EACrB,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,cAAc;AAChB,CAAC;AA4CM,SAAS,iBAAiB,OAA2C;AApE5E;AAqEE,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAgC,IAAI;AAEhE,YAAU,MAAM;AAEd,QAAI,MAAM,YAAY,OAAO;AAC3B,gBAAU,CAAC,SAAgC;AACzC,qCAAM;AACN,eAAO;AAAA,MACT,CAAC;AACD;AAAA,IACF;AAEA,UAAM,IAAI,KAAK;AAAA,MACb,QAAQ,MAAM;AAAA,MACd,SAAS,MAAM;AAAA,MACf,WAAW,MAAM;AAAA,MACjB,OAAO,MAAM;AAAA,MACb,oBAAoB,MAAM;AAAA,MAC1B,gBAAgB,MAAM;AAAA,MACtB,SAAS,MAAM;AAAA,IACjB,CAAC;AACD,cAAU,CAAC;AACX,WAAO,MAAM;AACX,QAAE,QAAQ;AAAA,IACZ;AAAA,EAGF,GAAG,CAAC,MAAM,OAAO,CAAC;AAElB,QAAM,eAAc,WAAM,gBAAN,YAAqB;AAEzC,SACE;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC,OAAO;AAAA,QACL;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,qBAAoB,WAAM,uBAAN,YAA4B,CAAC;AAAA,QACjD,iBAAgB,WAAM,mBAAN,YAAwB;AAAA,QACxC;AAAA,QACA,cAAc,MAAM;AAAA,MACtB;AAAA,MAEC,gBAAM;AAAA;AAAA,EACT;AAEJ;;;ACvGS,gBAAAA,YAAA;AADF,SAAS,mBAAmB,OAA6C;AAC9E,SAAO,gBAAAA,KAAC,qCAAqB,MAAO;AACtC;","names":["jsx"]}
package/dist/next/adaptive-root.js.map CHANGED
@@ -1 +1 @@
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":[]}
1
+ {"version":3,"sources":["../../src/next/adaptive-root.tsx","../../src/server.ts"],"sourcesContent":["import { deriveSessionSegment } from '@sentientui/core';\r\nimport { cookies, headers } from 'next/headers';\r\nimport type { ReactNode } from 'react';\r\nimport type { AdaptiveProviderProps } from '../provider.js';\r\nimport { loadAdaptiveAssignments, type ServerAssignments } from '../server.js';\r\nimport { AdaptiveRootClient } from './adaptive-root-client.js';\r\n\r\nexport type PreloadComponent = { id: string; variantIds: string[] };\r\n\r\nexport type AdaptiveRootProps = Omit<AdaptiveProviderProps, 'initialAssignments'> & {\r\n /** Slots to resolve on the server before HTML is sent (SEO-safe). */\r\n components: PreloadComponent[];\r\n /** Server-only key for `/v1/sessions` and `/v1/assign` (usually the same `pk_` as `apiKey`). */\r\n serverApiKey: string;\r\n /** API base URL without trailing slash, e.g. `https://api.example.com/v1`. */\r\n apiBaseUrl: string;\r\n /**\r\n * App origin for SSR preload requests (must be in the project's `allowed_origins`).\r\n * @default `http://localhost:3001` in development\r\n */\r\n appOrigin?: string;\r\n /**\r\n * Optional preloaded map; when set, `components` is not fetched (useful for tests\r\n * or custom loaders). Normally omit and let `loadAdaptiveAssignments` run.\r\n */\r\n initialAssignments?: ServerAssignments;\r\n children: ReactNode;\r\n};\r\n\r\n/**\r\n * Server Component wrapper: loads assignments, then renders `AdaptiveProvider`\r\n * with `initialAssignments` so crawlers and hydration see real variant content.\r\n *\r\n * @example\r\n * ```tsx\r\n * // app/layout.tsx\r\n * import { AdaptiveRoot } from '@sentientui/react/next';\r\n *\r\n * export default function Layout({ children }) {\r\n * return (\r\n * <AdaptiveRoot\r\n * components={[{ id: 'hero_cta', variantIds: ['default', 'accent'] }]}\r\n * serverApiKey={process.env.SENTIENT_API_KEY!}\r\n * apiBaseUrl={process.env.SENTIENT_API_URL!}\r\n * apiKey={process.env.NEXT_PUBLIC_SENTIENT_API_KEY!}\r\n * ingestUrl={process.env.NEXT_PUBLIC_SENTIENT_INGEST_URL!}\r\n * context=\"saas\"\r\n * >\r\n * {children}\r\n * </AdaptiveRoot>\r\n * );\r\n * }\r\n * ```\r\n */\r\nexport async function AdaptiveRoot(props: AdaptiveRootProps): Promise<JSX.Element> {\r\n const {\r\n components,\r\n serverApiKey,\r\n apiBaseUrl,\r\n appOrigin,\r\n initialAssignments: initialAssignmentsOverride,\r\n children,\r\n ...providerProps\r\n } = props;\r\n\r\n const headerStore = await headers();\r\n const resolvedOrigin = appOrigin ?? 'http://localhost:3001';\r\n const userAgent = headerStore.get('user-agent') ?? undefined;\r\n const referer = headerStore.get('referer') ?? undefined;\r\n const sessionSegment = deriveSessionSegment({ userAgent, referer, appOrigin: resolvedOrigin });\r\n const initialAssignments =\r\n initialAssignmentsOverride ??\r\n (await loadAdaptiveAssignments(components, {\r\n cookies: await cookies(),\r\n apiKey: serverApiKey,\r\n baseUrl: apiBaseUrl,\r\n origin: resolvedOrigin,\r\n userAgent,\r\n referer,\r\n }));\r\n\r\n return (\r\n <AdaptiveRootClient\r\n {...providerProps}\r\n initialAssignments={initialAssignments}\r\n sessionSegment={sessionSegment}\r\n >\r\n {children}\r\n </AdaptiveRootClient>\r\n );\r\n}\r\n","/**\r\n * Server-only helpers for Next.js / SSR. No React or DOM APIs.\r\n */\r\nimport {\r\n preloadAssignments,\r\n readSessionCookie,\r\n type ServerAssignConfig,\r\n type ServerAssignments,\r\n} from '@sentientui/core';\r\n\r\nexport { preloadAssignments, readSessionCookie };\r\nexport type { ServerAssignConfig, ServerAssignments };\r\n\r\nexport type LoadAdaptiveAssignmentsOptions = {\r\n /** Next.js `cookies()` return value, or any object with `get(name)`. */\r\n cookies: { get(name: string): { value: string } | undefined };\r\n apiKey: string;\r\n baseUrl: string;\r\n /** Used when `_snt_uid` is absent (e.g. first visit, many crawlers). */\r\n createSessionId?: () => string;\r\n /** Must match a value in the project's `allowed_origins` (e.g. `http://localhost:3001`). */\r\n origin?: string;\r\n /** From Next.js `headers().get('user-agent')` — aligns SSR segment with the client. */\r\n userAgent?: string;\r\n /** From Next.js `headers().get('referer')`. */\r\n referer?: string;\r\n};\r\n\r\nfunction defaultSessionId(): string {\r\n if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\r\n return crypto.randomUUID();\r\n }\r\n return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\r\n}\r\n\r\n/**\r\n * Fetches bandit assignments on the server for SEO-safe HTML.\r\n * Pass the result as `initialAssignments` on `<AdaptiveProvider>`.\r\n */\r\nexport async function loadAdaptiveAssignments(\r\n components: Array<{ id: string; variantIds: string[] }>,\r\n options: LoadAdaptiveAssignmentsOptions,\r\n): Promise<ServerAssignments> {\r\n const sessionId =\r\n readSessionCookie(options.cookies) ??\r\n options.createSessionId?.() ??\r\n defaultSessionId();\r\n\r\n return preloadAssignments(components, sessionId, {\r\n apiKey: options.apiKey,\r\n baseUrl: options.baseUrl,\r\n origin: options.origin,\r\n userAgent: options.userAgent,\r\n referer: options.referer,\r\n });\r\n}\r\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.js.map CHANGED
@@ -1 +1 @@
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":[]}
1
+ {"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\r\n * Server-only helpers for Next.js / SSR. No React or DOM APIs.\r\n */\r\nimport {\r\n preloadAssignments,\r\n readSessionCookie,\r\n type ServerAssignConfig,\r\n type ServerAssignments,\r\n} from '@sentientui/core';\r\n\r\nexport { preloadAssignments, readSessionCookie };\r\nexport type { ServerAssignConfig, ServerAssignments };\r\n\r\nexport type LoadAdaptiveAssignmentsOptions = {\r\n /** Next.js `cookies()` return value, or any object with `get(name)`. */\r\n cookies: { get(name: string): { value: string } | undefined };\r\n apiKey: string;\r\n baseUrl: string;\r\n /** Used when `_snt_uid` is absent (e.g. first visit, many crawlers). */\r\n createSessionId?: () => string;\r\n /** Must match a value in the project's `allowed_origins` (e.g. `http://localhost:3001`). */\r\n origin?: string;\r\n /** From Next.js `headers().get('user-agent')` — aligns SSR segment with the client. */\r\n userAgent?: string;\r\n /** From Next.js `headers().get('referer')`. */\r\n referer?: string;\r\n};\r\n\r\nfunction defaultSessionId(): string {\r\n if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\r\n return crypto.randomUUID();\r\n }\r\n return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\r\n}\r\n\r\n/**\r\n * Fetches bandit assignments on the server for SEO-safe HTML.\r\n * Pass the result as `initialAssignments` on `<AdaptiveProvider>`.\r\n */\r\nexport async function loadAdaptiveAssignments(\r\n components: Array<{ id: string; variantIds: string[] }>,\r\n options: LoadAdaptiveAssignmentsOptions,\r\n): Promise<ServerAssignments> {\r\n const sessionId =\r\n readSessionCookie(options.cookies) ??\r\n options.createSessionId?.() ??\r\n defaultSessionId();\r\n\r\n return preloadAssignments(components, sessionId, {\r\n apiKey: options.apiKey,\r\n baseUrl: options.baseUrl,\r\n origin: options.origin,\r\n userAgent: options.userAgent,\r\n referer: options.referer,\r\n });\r\n}\r\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.map CHANGED
@@ -1 +1 @@
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":[]}
1
+ {"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\r\n * Server-only helpers for Next.js / SSR. No React or DOM APIs.\r\n */\r\nimport {\r\n preloadAssignments,\r\n readSessionCookie,\r\n type ServerAssignConfig,\r\n type ServerAssignments,\r\n} from '@sentientui/core';\r\n\r\nexport { preloadAssignments, readSessionCookie };\r\nexport type { ServerAssignConfig, ServerAssignments };\r\n\r\nexport type LoadAdaptiveAssignmentsOptions = {\r\n /** Next.js `cookies()` return value, or any object with `get(name)`. */\r\n cookies: { get(name: string): { value: string } | undefined };\r\n apiKey: string;\r\n baseUrl: string;\r\n /** Used when `_snt_uid` is absent (e.g. first visit, many crawlers). */\r\n createSessionId?: () => string;\r\n /** Must match a value in the project's `allowed_origins` (e.g. `http://localhost:3001`). */\r\n origin?: string;\r\n /** From Next.js `headers().get('user-agent')` — aligns SSR segment with the client. */\r\n userAgent?: string;\r\n /** From Next.js `headers().get('referer')`. */\r\n referer?: string;\r\n};\r\n\r\nfunction defaultSessionId(): string {\r\n if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\r\n return crypto.randomUUID();\r\n }\r\n return `snt-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\r\n}\r\n\r\n/**\r\n * Fetches bandit assignments on the server for SEO-safe HTML.\r\n * Pass the result as `initialAssignments` on `<AdaptiveProvider>`.\r\n */\r\nexport async function loadAdaptiveAssignments(\r\n components: Array<{ id: string; variantIds: string[] }>,\r\n options: LoadAdaptiveAssignmentsOptions,\r\n): Promise<ServerAssignments> {\r\n const sessionId =\r\n readSessionCookie(options.cookies) ??\r\n options.createSessionId?.() ??\r\n defaultSessionId();\r\n\r\n return preloadAssignments(components, sessionId, {\r\n apiKey: options.apiKey,\r\n baseUrl: options.baseUrl,\r\n origin: options.origin,\r\n userAgent: options.userAgent,\r\n referer: options.referer,\r\n });\r\n}\r\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 CHANGED
@@ -1,59 +1,58 @@
1
- {
2
- "name": "@sentientui/react",
3
- "version": "0.1.0",
4
- "private": false,
5
- "type": "module",
6
- "main": "./dist/index.js",
7
- "module": "./dist/index.mjs",
8
- "types": "./dist/index.d.ts",
9
- "exports": {
10
- ".": {
11
- "types": "./dist/index.d.ts",
12
- "import": "./dist/index.mjs",
13
- "require": "./dist/index.js"
14
- },
15
- "./server": {
16
- "types": "./dist/server.d.ts",
17
- "import": "./dist/server.mjs",
18
- "require": "./dist/server.js"
19
- },
20
- "./next": {
21
- "types": "./dist/next/adaptive-root.d.ts",
22
- "import": "./dist/next/adaptive-root.js",
23
- "default": "./dist/next/adaptive-root.js"
24
- }
25
- },
26
- "files": [
27
- "dist"
28
- ],
29
- "dependencies": {
30
- "@sentientui/core": "0.1.0"
31
- },
32
- "peerDependencies": {
33
- "react": ">=18.0.0",
34
- "next": ">=14.0.0"
35
- },
36
- "peerDependenciesMeta": {
37
- "next": {
38
- "optional": true
39
- }
40
- },
41
- "devDependencies": {
42
- "@testing-library/react": "^16.1.0",
43
- "@types/react": "^18.3.12",
44
- "jsdom": "^25.0.1",
45
- "react": "^18.3.1",
46
- "react-dom": "^18.3.1",
47
- "tsup": "^8.3.5",
48
- "tsx": "^4.19.2",
49
- "typescript": "^5.7.2",
50
- "vitest": "^2.1.8"
51
- },
52
- "scripts": {
53
- "build": "tsup",
54
- "test": "vitest run",
55
- "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
56
- "size-check": "tsx scripts/size-check.ts",
57
- "lint": "eslint src"
58
- }
59
- }
1
+ {
2
+ "name": "@sentientui/react",
3
+ "version": "0.2.0",
4
+ "private": false,
5
+ "type": "module",
6
+ "main": "./dist/index.js",
7
+ "module": "./dist/index.mjs",
8
+ "types": "./dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/index.d.ts",
12
+ "import": "./dist/index.mjs",
13
+ "require": "./dist/index.js"
14
+ },
15
+ "./server": {
16
+ "types": "./dist/server.d.ts",
17
+ "import": "./dist/server.mjs",
18
+ "require": "./dist/server.js"
19
+ },
20
+ "./next": {
21
+ "types": "./dist/next/adaptive-root.d.ts",
22
+ "import": "./dist/next/adaptive-root.js",
23
+ "default": "./dist/next/adaptive-root.js"
24
+ }
25
+ },
26
+ "files": ["dist"],
27
+ "scripts": {
28
+ "build": "tsup",
29
+ "test": "vitest run",
30
+ "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
31
+ "size-check": "tsx scripts/size-check.ts",
32
+ "lint": "eslint src",
33
+ "prepublishOnly": "pnpm build"
34
+ },
35
+ "dependencies": {
36
+ "@sentientui/core": "^0.2.0"
37
+ },
38
+ "peerDependencies": {
39
+ "react": ">=18.0.0",
40
+ "next": ">=14.0.0"
41
+ },
42
+ "peerDependenciesMeta": {
43
+ "next": {
44
+ "optional": true
45
+ }
46
+ },
47
+ "devDependencies": {
48
+ "@testing-library/react": "^16.1.0",
49
+ "@types/react": "^18.3.12",
50
+ "jsdom": "^25.0.1",
51
+ "react": "^18.3.1",
52
+ "react-dom": "^18.3.1",
53
+ "tsup": "^8.3.5",
54
+ "tsx": "^4.19.2",
55
+ "typescript": "^5.7.2",
56
+ "vitest": "^2.1.8"
57
+ }
58
+ }