@revturbine/sdk 0.2.84 → 0.2.85

package/dist/types/web-sdk/headless.d.ts

@@ -42,6 +42,7 @@ export { PlacementController, EntitlementGate, SdkSession, initRevTurbine, entit
 export type { ChangeListener, PlacementControllerOptions, PlacementControllerState, EntitlementGateOptions, EntitlementGateState, SdkSessionOptions, } from './controllers';
 export { createRevTurbineApiClient, ApiError as RevTurbineApiError, } from './api-client';
 export type { RevTurbineApiClient, RevTurbineApiClientConfig, paths as RevTurbineApiPaths, } from './api-client';
+export type { EntitlementView, PlacementView } from './views';
 export { isServer, isBrowser } from './env';
 export { InMemoryStorage, BrowserStorage, resolvePersistentStorage, resolveSessionStorage, } from './storage';
 export type { RevTurbineStorage } from './storage';

package/dist/types/web-sdk/headless.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../../headless.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../../headless.ts"],"names":[],"mappings":"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"}

package/dist/types/web-sdk/providers/basic-experiment-provider.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The one built-in `ExperimentProvider` (plan 183 REQ-3b).
+ *
+ * Deliberately basic, and deliberately opt-in: nothing registers this for you.
+ * A customer with their own experimentation tool registers an adapter that
+ * reads *their* assignments instead and loses nothing — the third-party path is
+ * first-class, not a fallback. RevTurbine does not own the split.
+ *
+ * Weights live here, in SDK code, rather than in the Playbook. Assignment is
+ * the provider's job, so the config that drives it is client-side
+ * configuration, not authored monetization config.
+ */
+import type { ExperimentProvider } from '@revt-eng/core';
+/** One experiment's arms, and optionally how much of the population sees it. */
+export interface BasicBucketerExperiment {
+    /**
+     * Either an equal split across the listed variant handles, or explicit
+     * relative weights. Weights need not sum to anything in particular — they are
+     * normalized — so `{ control: 1, variant_b: 3 }` is a 25/75 split.
+     *
+     * A variant weighted 0 (or negative) is excluded rather than made
+     * unreachable-but-present, so removing an arm and zeroing it behave the same.
+     */
+    variants: readonly string[] | Readonly<Record<string, number>>;
+    /**
+     * Fraction of subjects enrolled at all, 0..1. Default 1 (everyone).
+     *
+     * A subject outside it is reported as NOT ENROLLED — the experiment is simply
+     * absent from the assignment map, which is distinct from being assigned to a
+     * control arm. That distinction is the whole point of a holdout: control is a
+     * measured arm, unenrolled is not in the experiment.
+     */
+    exposure?: number;
+}
+export interface BasicBucketerOptions {
+    /** Keyed by experiment handle — the canonical, version-stable identifier. */
+    experiments: Readonly<Record<string, BasicBucketerExperiment>>;
+    /**
+     * The subject to bucket on. A function is re-read on every resolve, so a
+     * later `setUserContext` takes effect; a bare string pins one subject.
+     *
+     * With no stable subject there is no assignment: bucketing an anonymous or
+     * empty id would hand the same person a different arm on the next load and
+     * silently poison the results. Absent beats wrong.
+     */
+    subject: string | (() => string | undefined | null);
+}
+/**
+ * Assign one subject to one experiment, or `undefined` for not-enrolled.
+ *
+ * Exported for testing and for callers who want the decision without the
+ * provider wrapper. Pure: same inputs always give the same arm, with no
+ * storage, no clock and no randomness involved.
+ */
+export declare function bucketSubject(subject: string, experimentHandle: string, experiment: BasicBucketerExperiment): string | undefined;
+/**
+ * Build the built-in bucketer. Register it explicitly to switch it on:
+ *
+ * ```ts
+ * initRevTurbine({
+ *   domainProviders: [
+ *     createBasicExperimentProvider({
+ *       subject: () => currentUserId,
+ *       experiments: { pricing_test: { variants: ['control', 'variant_b'] } },
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function createBasicExperimentProvider(options: BasicBucketerOptions): ExperimentProvider;
+//# sourceMappingURL=basic-experiment-provider.d.ts.map

package/dist/types/web-sdk/providers/basic-experiment-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-experiment-provider.d.ts","sourceRoot":"","sources":["../../../../providers/basic-experiment-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAA2B,MAAM,gBAAgB,CAAC;AAElF,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC/D;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;CACrD;AAsCD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,uBAAuB,GAClC,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAmBpB"}

package/dist/types/web-sdk/providers/index.d.ts

@@ -1,5 +1,7 @@
-export type { DomainProviderName, DomainProvider, AnyDomainProvider, ResolvedProviderContext, ResolvedDomainType, TraitsNamespace, PlanProvider, PlanProviderState, EntitlementProvider, EntitlementProviderState, EntitlementUsageEntry, SegmentProvider, SegmentProviderState, ContentProvider, ContentProviderState, MessageBlockSnapshot, PlacementPayloadSnapshot, RuleProvider, RuleProviderState, EntitlementRuleSnapshot, PlanRuleSnapshot, TraitsProvider, TraitsProviderState, TrialStatusTraits, TrialStatusProvider, UsageTraits, UsageTraitsProvider, ThemeProvider, ThemeProviderState, EventConsumer, EventConsumerProvider, EventConsumerProviderState, CtaHandler, CtaHandlerMap, CtaHandlerProvider, CtaHandlerProviderState, } from './types';
+export type { DomainProviderName, DomainProvider, AnyDomainProvider, ResolvedProviderContext, ResolvedDomainType, TraitsNamespace, PlanProvider, PlanProviderState, EntitlementProvider, EntitlementProviderState, EntitlementUsageEntry, SegmentProvider, SegmentProviderState, ExperimentProvider, ExperimentProviderState, ContentProvider, ContentProviderState, MessageBlockSnapshot, PlacementPayloadSnapshot, RuleProvider, RuleProviderState, EntitlementRuleSnapshot, PlanRuleSnapshot, TraitsProvider, TraitsProviderState, TrialStatusTraits, TrialStatusProvider, UsageTraits, UsageTraitsProvider, ThemeProvider, ThemeProviderState, EventConsumer, EventConsumerProvider, EventConsumerProviderState, CtaHandler, CtaHandlerMap, CtaHandlerProvider, CtaHandlerProviderState, } from './types';
 export { DomainProviderRegistry } from './registry';
 export { ServerUserContextProvider, SERVER_TRAITS_DOMAIN, } from './server-user-context-provider';
 export type { ServerUserContextSnapshot } from './server-user-context-provider';
+export { createBasicExperimentProvider, bucketSubject, } from './basic-experiment-provider';
+export type { BasicBucketerOptions, BasicBucketerExperiment, } from './basic-experiment-provider';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/web-sdk/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../providers/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAElB,eAAe,EAEf,YAAY,EACZ,iBAAiB,EAEjB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EAErB,eAAe,EACf,oBAAoB,EAEpB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EAExB,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAEhB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EAEnB,aAAa,EACb,kBAAkB,EAElB,aAAa,EACb,qBAAqB,EACrB,0BAA0B,EAE1B,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAKpD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../providers/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAElB,eAAe,EAEf,YAAY,EACZ,iBAAiB,EAEjB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EAErB,eAAe,EACf,oBAAoB,EAEpB,kBAAkB,EAClB,uBAAuB,EAEvB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EAExB,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAEhB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EAEnB,aAAa,EACb,kBAAkB,EAElB,aAAa,EACb,qBAAqB,EACrB,0BAA0B,EAE1B,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAKpD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAKhF,OAAO,EACL,6BAA6B,EAC7B,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC"}

package/dist/types/web-sdk/providers/types.d.ts

@@ -4,5 +4,5 @@
  * This file maintains backward compatibility for web-sdk consumers.
  * All canonical type definitions live in core/providers/types.ts.
  */
-export type { TraitsNamespace, DomainProviderName, DomainProvider, PlanProviderState, PlanProvider, EntitlementUsageEntry, EntitlementProviderState, EntitlementProvider, SegmentProviderState, SegmentProvider, MessageBlockSnapshot, PlacementPayloadSnapshot, ContentProviderState, ContentProvider, EntitlementRuleSnapshot, PlanRuleSnapshot, RuleProviderState, RuleProvider, TraitsProviderState, TraitsProvider, TrialStatusTraits, TrialStatusProvider, UsageTraits, UsageTraitsProvider, ThemeProviderState, ThemeProvider, EventConsumer, EventConsumerProviderState, EventConsumerProvider, CtaHandler, CtaHandlerMap, CtaHandlerProviderState, CtaHandlerProvider, ResolvedProviderContext, AnyDomainProvider, ResolvedDomainType, } from '@revt-eng/core';
+export type { TraitsNamespace, DomainProviderName, DomainProvider, PlanProviderState, PlanProvider, EntitlementUsageEntry, EntitlementProviderState, EntitlementProvider, SegmentProviderState, SegmentProvider, ExperimentProviderState, ExperimentProvider, MessageBlockSnapshot, PlacementPayloadSnapshot, ContentProviderState, ContentProvider, EntitlementRuleSnapshot, PlanRuleSnapshot, RuleProviderState, RuleProvider, TraitsProviderState, TraitsProvider, TrialStatusTraits, TrialStatusProvider, UsageTraits, UsageTraitsProvider, ThemeProviderState, ThemeProvider, EventConsumer, EventConsumerProviderState, EventConsumerProvider, CtaHandler, CtaHandlerMap, CtaHandlerProviderState, CtaHandlerProvider, ResolvedProviderContext, AnyDomainProvider, ResolvedDomainType, } from '@revt-eng/core';
 //# sourceMappingURL=types.d.ts.map

package/dist/types/web-sdk/providers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../providers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../providers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/types/web-sdk/react/useEntitlement.d.ts

@@ -1,4 +1,5 @@
-import type { EntitlementResult, PlacementOutput, RevTurbineEntitlementContext, RevTurbinePlacementRequestConfig } from '../customer-side';
+import type { RevTurbineEntitlementContext, RevTurbinePlacementRequestConfig } from '../customer-side';
+import type { EntitlementView } from '../views';
 export interface UseEntitlementOptions {
     /** The entitlement handle to check (e.g. 'brand_kit', 'mp4_download'). */
     handle: string;
@@ -17,21 +18,19 @@ export interface UseEntitlementOptions {
      */
     gatePlacementRequest?: Omit<RevTurbinePlacementRequestConfig, 'entitlementHandle'>;
 }
-export interface UseEntitlementResult {
+/**
+ * The client-side entitlement result: the resolved decision
+ * ({@link EntitlementView}) plus the lifecycle a hook resolves it through.
+ *
+ * The lifecycle half is what makes this distinct from the server shape. A
+ * server caller awaits its decision and therefore has no loading state and
+ * nothing to re-run mid-render.
+ */
+export interface UseEntitlementResult extends EntitlementView {
     /** Whether the entitlement check is in progress. */
     isLoading: boolean;
     /** Error message if the check failed. */
     error: string | null;
-    /** The entitlement result from the SDK. `null` until resolved. */
-    result: EntitlementResult | null;
-    /** Convenience: `true` when the entitlement is allowed. */
-    allowed: boolean;
-    /** Convenience: `true` when usage is limited (partially exhausted). */
-    limited: boolean;
-    /** Convenience: `true` when the entitlement is denied. */
-    denied: boolean;
-    /** Resolved gated placement when `denied` and `autoGate` are active. */
-    gatedPlacement: PlacementOutput | null;
     /** Re-run the entitlement check. */
     recheck: () => Promise<void>;
 }

package/dist/types/web-sdk/react/useEntitlement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEntitlement.d.ts","sourceRoot":"","sources":["../../../../react/useEntitlement.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,4BAA4B,EAC5B,gCAAgC,EACjC,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,4BAA4B,CAAC;IACvC,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,IAAI,CAAC,gCAAgC,EAAE,mBAAmB,CAAC,CAAC;CACpF;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kEAAkE;IAClE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,cAAc,EAAE,eAAe,GAAG,IAAI,CAAC;IACvC,oCAAoC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,SAAgB,EAChB,QAAgB,EAChB,oBAAoB,GACrB,EAAE,qBAAqB,GAAG,oBAAoB,CAqD9C"}
+{"version":3,"file":"useEntitlement.d.ts","sourceRoot":"","sources":["../../../../react/useEntitlement.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,4BAA4B,EAC5B,gCAAgC,EACjC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMhD,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,4BAA4B,CAAC;IACvC,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,IAAI,CAAC,gCAAgC,EAAE,mBAAmB,CAAC,CAAC;CACpF;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oCAAoC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,SAAgB,EAChB,QAAgB,EAChB,oBAAoB,GACrB,EAAE,qBAAqB,GAAG,oBAAoB,CAqD9C"}

package/dist/types/web-sdk/react/usePlacement.d.ts

@@ -1,4 +1,5 @@
-import { type RevTurbinePlacementConfig, type RevTurbineSurfaceSlotConfig, type RevTurbinePlacementContent, type RevTurbinePlacementDecision, type RevTurbinePlacementDecisionOverrides, type RevTurbineContextMode } from '../customer-side';
+import { type RevTurbinePlacementConfig, type RevTurbineSurfaceSlotConfig, type RevTurbinePlacementDecisionOverrides, type RevTurbineContextMode } from '../customer-side';
+import type { PlacementView } from '../views';
 import type { PlacementExposureMode } from '../controllers';
 import { type ExposureBasis } from '../telemetry';
 /**
@@ -41,13 +42,18 @@ export type UsePlacementOptions = {
 /**
  * Result returned by the {@link usePlacement} hook.
  */
-export type UsePlacementResult = {
+/**
+ * The client-side placement result: the resolved decision
+ * ({@link PlacementView}) plus the lifecycle and interaction surface a hook
+ * adds on top.
+ *
+ * Everything beyond {@link PlacementView} is inherently client-side — a loading
+ * state, interaction callbacks, and viewport-exposure wiring have no meaning to
+ * a server caller that awaits a decision and renders once.
+ */
+export type UsePlacementResult = PlacementView & {
     isLoading: boolean;
     error: string;
-    placementId: string;
-    visible: boolean;
-    decision: RevTurbinePlacementDecision | null;
-    content: RevTurbinePlacementContent['content'] | null;
     refresh: () => Promise<void>;
     dismiss: (cooldownMs?: number) => Promise<void>;
     snooze: (seconds?: number) => Promise<void>;

package/dist/types/web-sdk/react/usePlacement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePlacement.d.ts","sourceRoot":"","sources":["../../../../react/usePlacement.tsx"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,oCAAoC,EACzC,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAGnE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,yEAAyE;IACzE,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,oDAAoD;IACpD,SAAS,CAAC,EAAE,oCAAoC,CAAC;IACjD,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC7C,OAAO,EAAE,0BAA0B,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACtD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C;;;;;OAKG;IACH,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,WAAW,EACX,MAAM,EACN,WAAoB,EACpB,SAAS,EACT,MAAM,EACN,KAAK,EACL,QAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,EAAE,mBAAmB,GAAG,kBAAkB,CA4G1C"}
+{"version":3,"file":"usePlacement.d.ts","sourceRoot":"","sources":["../../../../react/usePlacement.tsx"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,oCAAoC,EACzC,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAGnE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,yEAAyE;IACzE,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,oDAAoD;IACpD,SAAS,CAAC,EAAE,oCAAoC,CAAC;IACjD,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C;;;;;OAKG;IACH,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,WAAW,EACX,MAAM,EACN,WAAoB,EACpB,SAAS,EACT,MAAM,EACN,KAAK,EACL,QAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,EAAE,mBAAmB,GAAG,kBAAkB,CA4G1C"}

package/dist/types/web-sdk/server/index.d.ts

@@ -0,0 +1,173 @@
+/**
+ * @module @revt-eng/web-sdk/server
+ *
+ * Server-side entitlement and placement decisions for React Server Components
+ * (plan 186 TASK-3).
+ *
+ * A React hook cannot run in a Server Component: every module under `react/`
+ * opens with `'use client'`, so importing one from the server graph yields an
+ * opaque client reference rather than a callable. This module is the server
+ * half — the same decisions, awaited instead of subscribed to.
+ *
+ * ```tsx
+ * // app/page.tsx — a Server Component, no 'use client'
+ * const rt = createServerClient({ tenantId, playbook });
+ * const { denied } = await getEntitlement(rt, 'brand_kit', { user: { id: userId } });
+ * return denied ? <UpgradePrompt /> : <BrandKitEditor />;
+ * ```
+ *
+ * Three properties are deliberate and load-bearing:
+ *
+ * - **Local by default.** An RSC tree re-renders per request, so a network hop
+ *   per decision is a latency tax the client SDK never paid. With a `playbook`
+ *   the decision resolves in-process and keeps working when the control plane
+ *   is unreachable. Remote is available by explicit configuration.
+ * - **Fail closed.** Any evaluation failure resolves denied / not-visible and
+ *   never throws into the render tree — a control-plane outage must not turn
+ *   into an error boundary, and must never accidentally grant paid access.
+ * - **No lifecycle fields.** The returned {@link EntitlementView} carries no
+ *   `isLoading` and no `recheck`: the value is awaited, so it is always
+ *   decided and there is nothing to re-run mid-render. Synthesizing them would
+ *   be a lie the type system then endorses.
+ *
+ * The credential passed here — a long-lived `server` api-token — must never
+ * reach the browser. It is accepted only by {@link createServerClient}, is
+ * never placed on a returned value, and never appears in the hydration payload
+ * handed to `RevTurbineProvider`.
+ *
+ * Plan: docs/dev-lifecycle/inprogress/186-server-rendering-sdk-and-api-token-management.md
+ */
+import { type ConfigArtifact } from '../config-artifact';
+import type { EntitlementView, PlacementView } from '../views';
+import type { RevTurbineEntitlementContext } from '../customer-side';
+/**
+ * The end user a server-side decision is evaluated for.
+ *
+ * There is no ambient user on the server — a Server Component has no provider
+ * to read from — so the caller states it explicitly. Plan 186 TASK-4 adds an
+ * optional request-scoped form that supplies this implicitly.
+ */
+export interface ServerUser {
+    /** The end-user identifier decisions are evaluated for. */
+    id: string;
+    /** The user's current plan handle, used to resolve entitlement rules. */
+    planHandle?: string;
+    /** Targeting traits for segment evaluation. */
+    traits?: Record<string, string | number | boolean>;
+}
+/** How a {@link RevTurbineServerClient} reaches its decisions. */
+export type ServerTransport = 'local' | 'remote';
+/**
+ * Configuration for {@link createServerClient}.
+ *
+ * Supply a `playbook` for local mode (the default). Supply `endpoint` +
+ * `apiToken` for remote mode, which is selected automatically when no playbook
+ * is present and can be forced with `transport: 'remote'`.
+ */
+export interface ServerClientOptions {
+    /** Tenant the decisions belong to. */
+    tenantId: string;
+    /**
+     * The bundled Playbook. Its presence selects local mode, where decisions
+     * resolve in-process with no network call.
+     */
+    playbook?: ConfigArtifact;
+    /** Target environment for Playbooks that predate environment stamping. */
+    environmentId?: string;
+    /**
+     * A long-lived `server` api-token, for remote mode.
+     *
+     * Server-only. Never return it to the browser, never place it in props, and
+     * never embed it in a hydration payload.
+     */
+    apiToken?: string;
+    /** Control-plane origin, for remote mode. */
+    endpoint?: string;
+    /** Force a transport. Defaults to `'local'` whenever a `playbook` is given. */
+    transport?: ServerTransport;
+}
+/**
+ * A server-side decision client.
+ *
+ * Create one per process (or per request) with {@link createServerClient} and
+ * pass it to {@link getEntitlement} / {@link getPlacement}. Holds no per-user
+ * state, so it is safe to share across concurrent requests.
+ */
+export declare class RevTurbineServerClient {
+    #private;
+    /** Tenant the decisions belong to. */
+    readonly tenantId: string;
+    /** How this client reaches its decisions. */
+    readonly transport: ServerTransport;
+    constructor(options: ServerClientOptions);
+    /**
+     * A runtime bound to one user.
+     *
+     * Built per call rather than once per client: `LocalRuntime` takes its
+     * `userId` at construction and `createStaticProviders` resolves entitlement
+     * rules against a specific `planHandle`, so a shared instance would evaluate
+     * every request against whichever user built it. (This is also why the
+     * existing `LocalEvaluationServer`, whose runtime is constructed once with
+     * `userId: '__server__'`, cannot answer a per-user entitlement question.)
+     * Plan 186 TASK-4 memoizes this per request via React `cache()`.
+     */
+    private runtimeFor;
+    /** @internal Resolve one entitlement, fail-closed. */
+    _entitlement(handle: string, user: ServerUser, context?: RevTurbineEntitlementContext): Promise<EntitlementView>;
+    /** @internal Resolve one placement, fail-closed. */
+    _placement(placementId: string, user: ServerUser): Promise<PlacementView>;
+}
+/**
+ * Create a server-side decision client.
+ *
+ * @param options - Transport and tenant configuration. A `playbook` selects
+ * local mode; `endpoint` + `apiToken` select remote.
+ *
+ * @example
+ * ```ts
+ * import playbook from '../revturbine.playbook.json';
+ * export const rt = createServerClient({ tenantId: 'tn_acme', playbook });
+ * ```
+ */
+export declare function createServerClient(options: ServerClientOptions): RevTurbineServerClient;
+/**
+ * Resolve one entitlement for one user, from a Server Component.
+ *
+ * Never throws: an evaluation failure resolves denied, so a control-plane
+ * outage cannot become an error boundary and cannot accidentally grant access.
+ *
+ * Gate paid UI on `denied` rather than on `!allowed` — a `limited` result still
+ * grants access when the evaluator permits it.
+ *
+ * @param client - From {@link createServerClient}.
+ * @param handle - The entitlement handle, e.g. `'brand_kit'`.
+ * @param input - The user to evaluate for, and optional usage context.
+ *
+ * @example
+ * ```tsx
+ * const { denied } = await getEntitlement(rt, 'brand_kit', { user: { id: userId } });
+ * if (denied) return <UpgradePrompt />;
+ * ```
+ */
+export declare function getEntitlement(client: RevTurbineServerClient, handle: string, input: {
+    user: ServerUser;
+    context?: RevTurbineEntitlementContext;
+}): Promise<EntitlementView>;
+/**
+ * Resolve one placement decision for one user, from a Server Component.
+ *
+ * Never throws: an evaluation failure resolves not-visible, so a failed
+ * decision hides the surface rather than breaking the page.
+ *
+ * The result carries no interaction callbacks — `dismiss`, `ctaClick` and
+ * viewport exposure are inherently client-side. Render the decision on the
+ * server and let a client component own the interactions.
+ *
+ * @param client - From {@link createServerClient}.
+ * @param input - The placement to resolve and the user to resolve it for.
+ */
+export declare function getPlacement(client: RevTurbineServerClient, input: {
+    placementId: string;
+    user: ServerUser;
+}): Promise<PlacementView>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/web-sdk/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAKH,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAEV,4BAA4B,EAE7B,MAAM,kBAAkB,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD;AAED,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAqCD;;;;;;GAMG;AACH,qBAAa,sBAAsB;;IACjC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;gBAYxB,OAAO,EAAE,mBAAmB;IA0BxC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,UAAU;IAelB,sDAAsD;IAChD,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,eAAe,CAAC;IAY3B,oDAAoD;IAC9C,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;CA0BhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,sBAAsB,CAEvF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,4BAA4B,CAAA;CAAE,GAClE,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC/C,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/types/web-sdk/views.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @module @revt-eng/web-sdk/views
+ *
+ * The decision shapes a caller reads, independent of *how* the decision was
+ * obtained (plan 186 TASK-1).
+ *
+ * A React hook resolves a decision over time, so its result carries lifecycle
+ * fields — `isLoading`, `error`, a re-run callback. A server-rendered caller
+ * awaits the decision, so it has none of those: by the time it holds a value,
+ * the value is final. What both share is the decision itself, and that shared
+ * part lives here.
+ *
+ * This module deliberately contains **types only and no runtime imports**, and
+ * deliberately sits outside `react/`. Every module under `react/` opens with
+ * `'use client'`, so a React Server Component importing one receives an opaque
+ * client reference rather than a usable value — the server binding could not
+ * reuse these shapes if they stayed there.
+ *
+ * Plan: docs/dev-lifecycle/inprogress/186-server-rendering-sdk-and-api-token-management.md
+ */
+import type { EntitlementResult, PlacementOutput, RevTurbinePlacementContent, RevTurbinePlacementDecision } from './customer-side';
+/**
+ * A resolved entitlement decision.
+ *
+ * The three booleans are conveniences over {@link EntitlementView.result} and
+ * are mutually exclusive once resolved. Note that `allowed` and `limited` are
+ * not opposites: a `limited` result still grants access when the evaluator
+ * permits it, so gate paywall UI on `denied`, never on `!allowed`.
+ *
+ * Callers that need to distinguish "denied" from "not yet decided" want the
+ * client-side {@link UseEntitlementResult}, whose `isLoading` carries that
+ * distinction. On the server the question does not arise — the value is awaited,
+ * so it is always decided.
+ */
+export interface EntitlementView {
+    /** The full entitlement result from the evaluator. `null` until resolved. */
+    result: EntitlementResult | null;
+    /** `true` when the entitlement is allowed outright. */
+    allowed: boolean;
+    /** `true` when access is granted but the balance is approaching its limit. */
+    limited: boolean;
+    /** `true` when the entitlement is denied. */
+    denied: boolean;
+    /** The upgrade surface to render on denial, when one was resolved. */
+    gatedPlacement: PlacementOutput | null;
+}
+/**
+ * A resolved placement decision.
+ *
+ * Carries what to render and whether to render it — not how to interact with
+ * it. Interaction callbacks (`dismiss`, `ctaClick`, …) and viewport-exposure
+ * wiring are inherently client-side and live on
+ * {@link UsePlacementResult} instead.
+ */
+export interface PlacementView {
+    /** The resolved placement identifier. */
+    placementId: string;
+    /** Whether the placement should be rendered. */
+    visible: boolean;
+    /** The full decision from the engine. `null` until resolved. */
+    decision: RevTurbinePlacementDecision | null;
+    /** Resolved content with personalization tokens expanded. `null` until resolved. */
+    content: RevTurbinePlacementContent['content'] | null;
+}
+//# sourceMappingURL=views.d.ts.map

package/dist/types/web-sdk/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../../views.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,cAAc,EAAE,eAAe,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC7C,oFAAoF;IACpF,OAAO,EAAE,0BAA0B,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;CACvD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revturbine/sdk",
-  "version": "0.2.84",
+  "version": "0.2.85",
   "description": "RevTurbine customer-facing SDK — placement decisioning, entitlement checks, and usage tracking.",
   "type": "module",
   "packageManager": "pnpm@11.12.0",
@@ -16,6 +16,10 @@
       "import": "./dist/headless.js",
       "types": "./dist/headless.d.ts"
     },
+    "./server": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    },
     "./source": "./index.ts",
     "./source/headless": "./headless.ts"
   },