@revturbine/sdk 0.2.83 → 0.2.85

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.83",
+  "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"
   },