@revturbine/sdk 0.9.1 → 0.9.3

package/CHANGELOG.md

@@ -35,6 +35,29 @@ the old shape was accepted and did nothing. Those windows are the expensive ones
 
 ---
 
+## 0.9.3
+
+### Fixed
+
+- Placement explanations use the same published segment-eligibility helper as
+  decisions, keeping OR-within-segments and AND-with-plan behavior aligned.
+  The explanation/decision matrix covers local and provider-backed Playbooks,
+  unknown or missing segments, exact handle matching and plan-filter combinations.
+
+## 0.9.2
+
+### Public initializer user context
+
+`await initRevTurbine({ user: { id, ...context }, ...options })` from
+`@revturbine/sdk` or `@revturbine/sdk/headless` now passes `id` only as the
+identity argument. Supported user context retains its existing behavior without
+the spurious unrecognized-context-key warning for `id`; genuinely unknown keys
+still warn. Public quick starts now show the awaited `SdkSession` and
+`session.sdk.getBranding()`. The separate synchronous core initializer is unchanged.
+
+Proving tests: `web-sdk/public-init.test.ts` and the installed public-package
+runtime/type examples in `web-sdk/scripts/check-public-diagnostics.mjs`.
+
 ## 0.9.1
 
 ### Public changelog distribution

package/dist/headless.d.ts

@@ -19260,7 +19260,7 @@ type ExportedConfigProvider = RevTurbineConfigProvider;
  * ```ts
  * import { initRevTurbine } from '@revturbine/sdk';
  *
- * const sdk = initRevTurbine({
+ * const session = await initRevTurbine({
  *   tenantId: 'tenant_abc',
  *   apiKey: 'rt_live_xxx',
  *   endpoint: 'https://edge.example.com',
@@ -20111,15 +20111,17 @@ declare const EMITTABLE_PLATFORM_EVENT_NAMES: readonly string[];
  *
  * @example
  * ```ts
- * const sdk = initRevTurbine({
+ * import { initRevTurbine } from '@revturbine/sdk';
+ *
+ * const session = await initRevTurbine({
  *   tenantId: 'tenant_abc',
  *   apiKey: 'rt_live_xxx',
  *   endpoint: 'https://edge.example.com',
  *   mode: 'react',
  * });
  *
- * sdk.identify('user_123', { plan: 'pro' });
- * const decision = await sdk.getPlacementDecision({ placementId, userId: 'user_123' });
+ * session.identify('user_123', { plan_handle: 'pro' });
+ * const branding = session.sdk.getBranding();
  * ```
  */
 declare class RevTurbineCustomerSdk {
@@ -20830,8 +20832,8 @@ declare class RevTurbineCustomerSdk {
      * @example
      * ```ts
      * // In your React component / page hydration:
-     * const sdk = initRevTurbine({ tenantId, apiKey, endpoint, mode: 'react' });
-     * sdk.hydrate(serverPayload);
+     * const session = await initRevTurbine({ tenantId, apiKey, endpoint, mode: 'react' });
+     * session.sdk.hydrate(serverPayload);
      * ```
      */
     hydrate(payload: ServerEvaluationHydrationPayload): void;
@@ -21392,19 +21394,18 @@ declare class RevTurbineCustomerSdk {
     }): void;
 }
 /**
- * Initialize the RevTurbine SDK.
+ * Initialize the synchronous RevTurbine core SDK.
  *
- * This is the primary entry point for browser integration.
- * Also available as `window.RevTurbine.init()` for non-module environments.
+ * Available as `window.RevTurbine.init()` for non-module environments.
+ * The package entrypoints expose the asynchronous session initializer instead:
+ * `const session = await initRevTurbine(options); const sdk = session.sdk;`.
  *
  * @param options - SDK initialization options
  * @returns A configured SDK instance
  *
  * @example
  * ```ts
- * import { initRevTurbine } from '@revturbine/sdk';
- *
- * const sdk = initRevTurbine({
+ * const sdk = window.RevTurbine?.init({
  *   tenantId: 'tenant_abc',
  *   apiKey: 'rt_live_xxx',
  *   endpoint: 'https://edge.example.com',
@@ -21557,6 +21558,7 @@ type RevTurbineThemeInput = {
  *   tenantId: 'tenant_abc',
  *   apiKey: 'rt_live_xxx',
  *   endpoint: 'https://edge.example.com',
+ *   mode: 'snippet',
  *   user: { id: 'user_123', plan_handle: 'pro' },
  * });
  *
@@ -21930,6 +21932,7 @@ type SdkSessionOptions = RevTurbineInitInputOptions & {
  *   tenantId: 'tenant_abc',
  *   apiKey: 'rt_live_xxx',
  *   endpoint: 'https://edge.example.com',
+ *   mode: 'snippet',
  *   user: { id: 'user_123', plan_handle: 'pro' },
  * });
  *
@@ -22074,6 +22077,7 @@ declare class SdkSession {
  *   tenantId: 'tenant_abc',
  *   apiKey: 'rt_live_xxx',
  *   endpoint: 'https://edge.example.com',
+ *   mode: 'snippet',
  *   user: { id: 'user_123', plan_handle: 'pro' },
  *   bootstrapPlacements: [
  *     { placement: { name: 'pricing_banner' } },
@@ -26495,7 +26499,7 @@ declare function createBasicExperimentProvider(options: BasicBucketerOptions): E
  *
  * @example
  * ```ts
- * import { createAnalyticsProvider } from '@revturbine/sdk';
+ * import { createAnalyticsProvider, initRevTurbine } from '@revturbine/sdk';
  *
  * const analytics = createAnalyticsProvider({
  *   handler: (eventName, properties) => {
@@ -26503,7 +26507,13 @@ declare function createBasicExperimentProvider(options: BasicBucketerOptions): E
  *   },
  * });
  *
- * initRevTurbine({ domainProviders: [analytics], ... });
+ * const session = await initRevTurbine({
+ *   tenantId: 'tenant_abc',
+ *   apiKey: 'rt_live_xxx',
+ *   endpoint: 'https://edge.example.com',
+ *   mode: 'snippet',
+ *   domainProviders: [analytics],
+ * });
  * ```
  *
  * @module
@@ -26647,7 +26657,13 @@ interface PostHogAnalyticsProviderOptions {
  * import { createPostHogAnalyticsProvider, initRevTurbine } from '@revturbine/sdk';
  *
  * const analytics = createPostHogAnalyticsProvider({ posthog });
- * initRevTurbine({ domainProviders: [analytics], ... });
+ * const session = await initRevTurbine({
+ *   tenantId: 'tenant_abc',
+ *   apiKey: 'rt_live_xxx',
+ *   endpoint: 'https://edge.example.com',
+ *   mode: 'snippet',
+ *   domainProviders: [analytics],
+ * });
  * ```
  */
 declare function createPostHogAnalyticsProvider(options: PostHogAnalyticsProviderOptions): EventConsumerProvider;