initRevTurbine

initRevTurbine<TUser>(options): Promise<SdkSession>

Create a fully-initialized SDK session.

This is the recommended entry point for headless (non-React) consumers. It handles:

1. SDK initialization via initRevTurbine()
2. User identification (if options.user.id is provided)
3. Theme resolution (from RevTurbineConfig or API)
4. Placement bootstrapping (preloading decisions)

The returned SdkSession exposes the full imperative API: user context management, placement controllers, entitlement gates, and event tracking.

Type Parameters

TUser

TUser extends RevTurbineUserContext = RevTurbineUserContext

Parameters

options

SdkSessionOptions & object

Returns

Promise<SdkSession>

Example

const session = await initRevTurbine({
  tenantId: 'tenant_abc',
  apiKey: 'rt_live_xxx',
  endpoint: 'https://edge.example.com',
  user: { id: 'user_123', plan_handle: 'pro' },
  bootstrapPlacements: [
    { placement: { name: 'pricing_banner' } },
  ],
});