@revturbine/sdk 0.2.76 → 0.2.78

package/dist/headless.d.ts

@@ -13492,7 +13492,7 @@ type RevTurbineThemeInput = {
  *
  * @example
  * ```ts
- * import { initRevTurbine, PlacementController, EntitlementGate } from '@revt-eng/web-sdk/headless';
+ * import { initRevTurbine, PlacementController, EntitlementGate } from '@revturbine/sdk/headless';
  *
  * const session = await initRevTurbine({
  *   tenantId: 'tenant_abc',
@@ -13882,6 +13882,14 @@ declare class SdkSession {
     getUserContext(): ReturnType<RevTurbineCustomerSdk['getUserContext']>;
     /** Update usage balances (e.g. after a meter event). */
     updateUsage(balances: UsageBalances): void;
+    /**
+     * Patch the session-scoped user context — the whole-context-minus-`id`
+     * upsert (`update({ plan: {...} })`, `update({ usage: {...} })`, …).
+     * Alias of the SDK's `update()`, promoted onto the session facade so the
+     * documented `session.update()` verb is real (plan 179 Q-1/Q-3 ruling).
+     * Unrecognized keys dev-warn and drop, exactly as on the SDK.
+     */
+    update(patch: RevTurbineUpdateInput): void;
     /** Fetch full user context from the server (server runtime mode). */
     fetchUserContext(userId: string): Promise<UserTargetingContext>;
     /** Get the current trial status. */
@@ -13927,8 +13935,29 @@ declare class SdkSession {
      * prefer {@link entitlement} which returns a full controller.
      */
     checkEntitlement(handle: string, context?: RevTurbineEntitlementContext): Promise<EntitlementResult>;
+    /**
+     * The entitlement check as a `can` question — alias of
+     * {@link checkEntitlement}, promoted onto the session facade so
+     * `session.can('batch_export')` works without the `session.sdk` escape
+     * hatch (plan 179 Q-1/Q-3 ruling). Read `.allowed` for the verdict; an
+     * at-cap blocked limit resolves `limited` + `allowed: false`.
+     */
+    can(handle: string, context?: RevTurbineEntitlementContext): Promise<EntitlementResult>;
     /** Track a custom event. */
     trackEvent(name: string, data?: Record<string, JsonObject[string]>): Promise<void>;
+    /**
+     * Track an event — the advertised alias of {@link trackEvent}, first-class
+     * on the session facade so headless code carries the full telemetry surface
+     * (plan 179 ruling, Kent 2026-08-13). Powers analytics, frequency caps,
+     * attribution, and experiments.
+     */
+    track(name: string, data?: Record<string, JsonObject[string]>): Promise<void>;
+    /**
+     * Flush buffered events immediately. Headless processes are often
+     * short-lived (scripts, jobs, edge handlers) — call this before exit so
+     * buffered `track()` events aren't lost with the process.
+     */
+    flushEvents(): Promise<void>;
 }
 /**
  * Create a fully-initialized SDK session.
@@ -20665,7 +20694,7 @@ declare class ApiError extends Error {
  *
  * @example
  * ```ts
- * import { BrowserRuntime } from '@revt-eng/web-sdk';
+ * import { BrowserRuntime } from '@revturbine/sdk';
  * import { createStaticProviders } from '@revt-eng/core';
  *
  * const runtime = new BrowserRuntime({