@revturbine/sdk 0.2.13

package/dist/types/server-node/client.d.ts

@@ -0,0 +1,75 @@
+/**
+ * RevTurbine Server-Side SDK Client.
+ *
+ * Performs server-to-server evaluation calls against the RevTurbine decision
+ * engine and returns a serializable `ServerEvaluationPayload` that the
+ * client-side SDK can hydrate.
+ *
+ * Designed for:
+ * - Next.js `getServerSideProps` / RSC / API routes
+ * - Express / Fastify middleware
+ * - Any Node.js server-side rendering pipeline
+ *
+ * @example
+ * ```ts
+ * import { RevTurbineServer } from '@revt-eng/sdk/server';
+ *
+ * const server = new RevTurbineServer({
+ *   tenantId: 'tenant_abc',
+ *   apiKey: process.env.REVTURBINE_SECRET_KEY!,
+ *   endpoint: 'https://api.revturbine.io',
+ * });
+ *
+ * // In getServerSideProps:
+ * const payload = await server.evaluate({
+ *   userId: session.user.id,
+ *   traits: { plan: 'pro' },
+ *   placements: [{ slotId: 'hero_banner' }],
+ *   entitlementHandles: ['advanced_analytics'],
+ *   includeTheme: true,
+ * });
+ *
+ * return { props: { rtPayload: payload } };
+ * ```
+ */
+import type { RevTurbineServerOptions, ServerEvaluationPayload, ServerEvaluationPayloadDecisionsItem, ServerEvaluationPayloadEntitlementsValue, ServerEvaluationPayloadTrialStatus, ServerEvaluationRequest, ServerPlacementRequest } from './types';
+export declare class RevTurbineServer {
+    private readonly tenantId;
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly defaultTtlSeconds;
+    private readonly fetchFn;
+    constructor(options: RevTurbineServerOptions);
+    /**
+     * Evaluate placement decisions, entitlements, and context for a user.
+     *
+     * Returns a `ServerEvaluationPayload` that can be serialized and sent
+     * to the client for hydration.
+     */
+    evaluate(request: ServerEvaluationRequest): Promise<ServerEvaluationPayload>;
+    /**
+     * Evaluate a single placement.
+     */
+    getPlacement(userId: string, placement: ServerPlacementRequest, traits?: Record<string, unknown>): Promise<ServerEvaluationPayloadDecisionsItem>;
+    /**
+     * Check a single entitlement for a user.
+     */
+    checkEntitlement(userId: string, handle: string, context?: {
+        used?: number;
+        balance?: number;
+        requiredTier?: string;
+    }): Promise<ServerEvaluationPayloadEntitlementsValue>;
+    /**
+     * Fetch trial status for a user.
+     */
+    getTrialStatus(userId: string): Promise<ServerEvaluationPayloadTrialStatus>;
+    private apiCall;
+    private apiGet;
+    private evaluatePlacements;
+    private evaluatePlacementsBatch;
+    private evaluateEntitlements;
+    private fetchTrialStatus;
+    private fetchUserContext;
+    private fetchTheme;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/server-node/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../server-node/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAEV,uBAAuB,EACvB,uBAAuB,EACvB,oCAAoC,EACpC,wCAAwC,EACxC,kCAAkC,EAElC,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AASjB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,OAAO,EAAE,uBAAuB;IAQ5C;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA0ClF;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,sBAAsB,EACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,oCAAoC,CAAC;IAmEhD;;OAEG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACnE,OAAO,CAAC,wCAAwC,CAAC;IAiCpD;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kCAAkC,CAAC;YASnE,OAAO;YAaP,MAAM;YAWN,kBAAkB;YAiBlB,uBAAuB;YA+EvB,oBAAoB;YAwBpB,gBAAgB;YAiDhB,gBAAgB;YAyBhB,UAAU;CAYzB"}

package/dist/types/server-node/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module @revt-eng/sdk/server-node
+ *
+ * Server-side evaluation SDK for RevTurbine.
+ *
+ * Use `RevTurbineServer` to pre-evaluate placement decisions, entitlements,
+ * and user context on the server. The resulting `ServerEvaluationPayload`
+ * can be serialized into your page props and consumed by the client-side SDK
+ * via `sdk.hydrate(payload)`.
+ *
+ * @example
+ * ```ts
+ * import { RevTurbineServer } from '@revt-eng/sdk/server';
+ *
+ * const server = new RevTurbineServer({
+ *   tenantId: 'tenant_abc',
+ *   apiKey: process.env.REVTURBINE_SECRET_KEY!,
+ *   endpoint: 'https://api.revturbine.io',
+ * });
+ *
+ * const payload = await server.evaluate({
+ *   userId: 'user_123',
+ *   traits: { plan: 'pro' },
+ *   placements: [{ slotId: 'hero_banner' }],
+ *   includeTheme: true,
+ * });
+ * ```
+ */
+export { RevTurbineServer } from './client';
+export type { RevTurbineServerOptions, ServerEvaluationPayload, ServerEvaluationPayloadDecisionsItem, ServerEvaluationPayloadEntitlementsValue, ServerEvaluationPayloadTrialStatus, ServerEvaluationPayloadUser, ServerEvaluationPayloadUserContext, ServerEvaluationRequest, ServerPlacementRequest, ServerPlacementDecision, ServerEntitlementResult, ServerUserContext, } from './types';
+export { LocalEvaluationServer, createLocalEvaluationServer } from './local-server';
+export type { LocalEvaluationServerOptions, LocalEvaluationRequest } from './local-server';
+export { LocalRuntime, createStaticProviders, createHydrationProviders, DecisionEngine, DomainProviderRegistry, InteractionTracker, CapEnforcer, InMemoryStorage, } from '@revt-eng/core';
+export { createApiProviders, } from '../web-sdk/adapters/api';
+export type { ApiAdapterOptions, } from '../web-sdk/adapters/api';
+export type { LocalRuntimeOptions, AdapterBaseOptions, CreateProvidersResult, RevTurbineStorage, } from '@revt-eng/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/server-node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server-node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,oCAAoC,EACpC,wCAAwC,EACxC,kCAAkC,EAClC,2BAA2B,EAC3B,kCAAkC,EAClC,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AACpF,YAAY,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG3F,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/types/server-node/local-server.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Local server-side evaluation using core LocalRuntime.
+ *
+ * Unlike `RevTurbineServer` which calls REST APIs, this module evaluates
+ * placement decisions locally using data adapters (static config, Drizzle DB,
+ * or API-fetched data). The output is the same `ServerEvaluationPayload`
+ * that the client-side SDK expects for hydration.
+ *
+ * @example
+ * ```ts
+ * import { createLocalEvaluationServer } from '@revt-eng/server-node/local-server';
+ * import { createStaticProviders } from '@revt-eng/core';
+ *
+ * const server = createLocalEvaluationServer({
+ *   tenantId: 'tenant_abc',
+ *   providers: createStaticProviders({ exportedConfig }),
+ * });
+ *
+ * const payload = await server.evaluate({
+ *   userId: 'user_123',
+ *   placements: [{ slotId: 'hero_banner' }],
+ * });
+ * ```
+ */
+import type { AnyDomainProvider, RevTurbineStorage } from '@revt-eng/core';
+import type { ExportedConfig } from '@revt-eng/schema';
+import type { ServerEvaluationPayload } from './types';
+export interface LocalEvaluationServerOptions {
+    tenantId: string;
+    /** Pre-built domain providers (from createStaticProviders, createDrizzleProviders, etc.) */
+    providers: AnyDomainProvider[];
+    /** ExportedConfig for local placement resolution. */
+    exportedConfig?: ExportedConfig;
+    /** Optional storage for interaction state (defaults to in-memory). */
+    storage?: RevTurbineStorage;
+    /** Default TTL for evaluation payloads (seconds). Default: 60. */
+    defaultTtlSeconds?: number;
+}
+export interface LocalEvaluationRequest {
+    userId: string;
+    anonymousId?: string;
+    traits?: Record<string, unknown>;
+    placements?: Array<{
+        slotId?: string;
+        entitlementHandle?: string;
+        planHandle?: string;
+        placementHandle?: string;
+    }>;
+    entitlementHandles?: string[];
+    includeTheme?: boolean;
+}
+export declare class LocalEvaluationServer {
+    private readonly tenantId;
+    private readonly runtime;
+    private readonly defaultTtlSeconds;
+    constructor(options: LocalEvaluationServerOptions);
+    evaluate(request: LocalEvaluationRequest): Promise<ServerEvaluationPayload>;
+}
+export declare function createLocalEvaluationServer(options: LocalEvaluationServerOptions): LocalEvaluationServer;
+//# sourceMappingURL=local-server.d.ts.map

package/dist/types/server-node/local-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-server.d.ts","sourceRoot":"","sources":["../../../../server-node/local-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AASjB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,qDAAqD;IACrD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,OAAO,EAAE,4BAA4B;IAiB3C,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAwDlF;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAEvB"}

package/dist/types/server-node/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Server-side evaluation types for the RevTurbine SDK.
+ *
+ * Response/payload types are imported from the generated schema types
+ * (`@revt-eng/schema`) so the server SDK is always aligned with the
+ * JSON-Schema source of truth. Request-only and configuration types
+ * that are SDK-specific (not in the schema) are defined here.
+ */
+import type { PlacementDecisionOutput, ServerEvaluationPayload, ServerEvaluationPayloadDecisionsItem, ServerEvaluationPayloadEntitlementsValue, ServerEvaluationPayloadTrialStatus, ServerEvaluationPayloadUser, ServerEvaluationPayloadUserContext } from '@revt-eng/schema';
+export type { PlacementDecisionOutput, ServerEvaluationPayload, ServerEvaluationPayloadDecisionsItem, ServerEvaluationPayloadEntitlementsValue, ServerEvaluationPayloadTrialStatus, ServerEvaluationPayloadUser, ServerEvaluationPayloadUserContext, };
+/** A single placement decision within a server evaluation payload. */
+export type ServerPlacementDecision = ServerEvaluationPayloadDecisionsItem;
+/** An entitlement check result within a server evaluation payload. */
+export type ServerEntitlementResult = ServerEvaluationPayloadEntitlementsValue;
+/** User context returned in a server evaluation payload. */
+export type ServerUserContext = ServerEvaluationPayloadUserContext;
+/** A single placement to evaluate on the server. */
+export interface ServerPlacementRequest {
+    /** Slot identifier for slot-based decisions. */
+    slotId?: string;
+    /** Entitlement handle for entitlement-gated decisions. */
+    entitlementHandle?: string;
+    /** Plan handle for plan-specific placements. */
+    planHandle?: string;
+    /** Placement handle for chained CTA paths. */
+    placementHandle?: string;
+}
+/** Full evaluation request submitted to the server SDK. */
+export interface ServerEvaluationRequest {
+    /** Authenticated user identifier. */
+    userId: string;
+    /** Optional anonymous ID for correlation (generated server-side when omitted). */
+    anonymousId?: string;
+    /** User traits for segmentation/personalization. */
+    traits?: Record<string, unknown>;
+    /** Page context when rendering a specific page server-side. */
+    page?: {
+        url?: string;
+        title?: string;
+        tags?: string[];
+    };
+    /** Placements to evaluate. When omitted, evaluates the bootstrap context. */
+    placements?: ServerPlacementRequest[];
+    /** Entitlement handles to check. */
+    entitlementHandles?: string[];
+    /** Current usage balances keyed by entitlement handle. */
+    usageBalances?: Record<string, number>;
+    /** Whether to include the tenant theme in the payload. */
+    includeTheme?: boolean;
+    /** Whether to include trial status in the payload. */
+    includeTrialStatus?: boolean;
+    /** Whether to include full user context (segments, traits, balances). */
+    includeUserContext?: boolean;
+}
+/** Options for initializing the RevTurbine server-side SDK. */
+export interface RevTurbineServerOptions {
+    /** Your RevTurbine tenant identifier. */
+    tenantId: string;
+    /** Server-side API key (should be a secret key, not a publishable key). */
+    apiKey: string;
+    /** Base URL of the RevTurbine API Edge. */
+    endpoint: string;
+    /** Default TTL for evaluation payloads (seconds). Default: 60. */
+    defaultTtlSeconds?: number;
+    /** Custom fetch implementation (e.g. for testing or non-standard runtimes). */
+    fetch?: typeof globalThis.fetch;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/server-node/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../server-node/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,oCAAoC,EACpC,wCAAwC,EACxC,kCAAkC,EAClC,2BAA2B,EAC3B,kCAAkC,EACnC,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,oCAAoC,EACpC,wCAAwC,EACxC,kCAAkC,EAClC,2BAA2B,EAC3B,kCAAkC,GACnC,CAAC;AAMF,sEAAsE;AACtE,MAAM,MAAM,uBAAuB,GAAG,oCAAoC,CAAC;AAE3E,sEAAsE;AACtE,MAAM,MAAM,uBAAuB,GAAG,wCAAwC,CAAC;AAE/E,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAMnE,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,+DAA+D;IAC/D,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,6EAA6E;IAC7E,UAAU,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACtC,oCAAoC;IACpC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAMD,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC"}

package/dist/types/web-sdk/adapters/api.d.ts

@@ -0,0 +1,24 @@
+/**
+ * API adapter — creates domain providers that fetch data from the RevTurbine REST API.
+ *
+ * Works everywhere with `fetch` (Node 18+, edge runtimes, browsers).
+ * This adapter lives in the SDK (not core) because core is pure in-memory
+ * evaluation with no network dependencies.
+ */
+import type { AnyDomainProvider, AdapterBaseOptions } from '@revt-eng/core';
+/** Options for the API-backed adapter. */
+export interface ApiAdapterOptions extends AdapterBaseOptions {
+    baseUrl: string;
+    token?: string;
+    tenantId: string;
+    userId?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Create domain providers that fetch from the RevTurbine REST API.
+ *
+ * Returns providers for: plan, entitlements, segments, rules, content, theme.
+ * Each provider's `resolve()` makes a `fetch()` call to the appropriate endpoint.
+ */
+export declare function createApiProviders(options: ApiAdapterOptions): AnyDomainProvider[];
+//# sourceMappingURL=api.d.ts.map

package/dist/types/web-sdk/adapters/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../adapters/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAQjB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAUxB,0CAA0C;AAC1C,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAiMlF"}

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

@@ -0,0 +1,111 @@
+/**
+ * Analytics adapter — bridges RevTurbine SDK events to third-party analytics
+ * platforms (Heap, Segment, Amplitude, Mixpanel, PostHog, custom, etc.).
+ *
+ * Implements the {@link EventConsumerProvider} domain provider interface so it
+ * plugs into the SDK's `domainProviders` array at init time.
+ *
+ * @example
+ * ```ts
+ * import { createAnalyticsProvider } from '@revt-eng/sdk';
+ *
+ * const analytics = createAnalyticsProvider({
+ *   handler: (eventName, properties) => {
+ *     window.analytics.track(eventName, properties);
+ *   },
+ * });
+ *
+ * initRevTurbine({ domainProviders: [analytics], ... });
+ * ```
+ *
+ * @module
+ */
+import type { EventConsumerProvider } from '@revt-eng/core';
+/**
+ * Flat properties object passed to the analytics handler after
+ * transforming a raw {@link RevTurbineEventEnvelope}.
+ */
+export type AnalyticsEventProperties = Record<string, unknown>;
+/**
+ * Callback invoked for every SDK event.
+ *
+ * @param eventName - Normalised event name (e.g. `'placement_interaction'`).
+ * @param properties - Flat key-value properties derived from the event envelope.
+ */
+export type AnalyticsEventHandler = (eventName: string, properties: AnalyticsEventProperties) => void;
+/**
+ * Optional transformer applied before the handler.
+ * Return `null` to drop the event silently.
+ */
+export type AnalyticsEventTransformer = (eventName: string, properties: AnalyticsEventProperties) => {
+    eventName: string;
+    properties: AnalyticsEventProperties;
+} | null;
+/** Configuration for {@link createAnalyticsProvider}. */
+export interface AnalyticsProviderOptions {
+    /**
+     * Callback that pushes one event to the analytics platform.
+     * Called once per SDK event after optional transformation.
+     */
+    handler: AnalyticsEventHandler;
+    /**
+     * Optional transform applied before the handler.
+     * Use this to rename events, enrich properties, or drop events
+     * you don't care about.
+     *
+     * Return `null` to suppress the event.
+     */
+    transform?: AnalyticsEventTransformer;
+    /**
+     * When provided, only events whose `type` matches one of these
+     * strings are forwarded. All others are silently dropped.
+     *
+     * @example ['placement_interaction', 'placement_dismissed']
+     */
+    filter?: string[];
+    /**
+     * Human-readable consumer name shown in diagnostics.
+     * @default 'analytics'
+     */
+    name?: string;
+}
+/**
+ * Create an analytics domain provider that forwards SDK events
+ * (impressions, interactions, triggers, page views, etc.) to a
+ * third-party analytics platform.
+ *
+ * The returned provider should be passed in the `domainProviders`
+ * array when calling `initRevTurbine()`.
+ *
+ * @example Segment
+ * ```ts
+ * const analytics = createAnalyticsProvider({
+ *   handler: (eventName, properties) => {
+ *     window.analytics.track(eventName, properties);
+ *   },
+ * });
+ * ```
+ *
+ * @example Heap (filtered to interactions only)
+ * ```ts
+ * const analytics = createAnalyticsProvider({
+ *   handler: (eventName, properties) => {
+ *     heap.track(eventName, properties);
+ *   },
+ *   filter: ['placement_interaction', 'placement_dismissed', 'placement_converted'],
+ * });
+ * ```
+ *
+ * @example Custom transform
+ * ```ts
+ * const analytics = createAnalyticsProvider({
+ *   handler: (name, props) => posthog.capture(name, props),
+ *   transform: (name, props) => ({
+ *     eventName: `revturbine.${name}`,
+ *     properties: { ...props, source: 'revturbine-sdk' },
+ *   }),
+ * });
+ * ```
+ */
+export declare function createAnalyticsProvider(options: AnalyticsProviderOptions): EventConsumerProvider;
+//# sourceMappingURL=analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,gBAAgB,CAAC;AAMxB;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,wBAAwB,KACjC,IAAI,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,wBAAwB,KACjC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,wBAAwB,CAAA;CAAE,GAAG,IAAI,CAAC;AAExE,yDAAyD;AACzD,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,OAAO,EAAE,qBAAqB,CAAC;IAE/B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,yBAAyB,CAAC;IAEtC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA+ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,qBAAqB,CAOvB"}

package/dist/types/web-sdk/api-client.d.ts

@@ -0,0 +1,44 @@
+/**
+ * RevTurbine API Client — typed client for the RevTurbine API.
+ *
+ * Generated from `@revt-eng/schema` external OpenAPI spec via `openapi-typescript`.
+ * Uses `openapi-fetch` for type-safe requests with auth injection.
+ *
+ * @example
+ * ```ts
+ * const client = createRevTurbineApiClient({
+ *   baseUrl: 'https://api.revturbine.io',
+ *   token: 'rt_live_xxx',
+ *   tenantId: 'tenant_abc',
+ * });
+ *
+ * const { data } = await client.GET('/api/plans');
+ * ```
+ */
+import { type Client } from 'openapi-fetch';
+import type { paths } from './generated/openapi';
+export interface RevTurbineApiClientConfig {
+    /** Base URL of the RevTurbine API. */
+    baseUrl: string;
+    /** API token for authentication. */
+    token?: string;
+    /** Tenant ID to include in requests. */
+    tenantId?: string;
+    /** Additional headers to include in every request. */
+    headers?: Record<string, string>;
+}
+export type RevTurbineApiClient = Client<paths>;
+/**
+ * Create a configured RevTurbine API client instance.
+ *
+ * @param config - Client configuration.
+ * @returns Typed API client with GET, POST, PUT, PATCH, DELETE methods.
+ */
+export declare function createRevTurbineApiClient(config: RevTurbineApiClientConfig): RevTurbineApiClient;
+/** Error thrown when an API request fails. */
+export declare class ApiError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export type { paths } from './generated/openapi';
+//# sourceMappingURL=api-client.d.ts.map

package/dist/types/web-sdk/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAqB,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,yBAAyB;IACxC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,mBAAmB,CAahG;AAED,8CAA8C;AAC9C,qBAAa,QAAS,SAAQ,KAAK;aAEf,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM;CAKlB;AAGD,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types/web-sdk/browser-runtime.d.ts

@@ -0,0 +1,62 @@
+/**
+ * BrowserRuntime — browser-optimized composition of core subsystems that
+ * persists interaction state, caps, and impression history to localStorage.
+ *
+ * Drop-in replacement for `LocalRuntime` in browser environments. Falls
+ * back to in-memory storage when `localStorage` is unavailable (e.g.
+ * sandboxed iframes, incognito with quota errors).
+ *
+ * @example
+ * ```ts
+ * import { BrowserRuntime } from '@revt-eng/web-sdk';
+ * import { createStaticProviders } from '@revt-eng/core';
+ *
+ * const runtime = new BrowserRuntime({
+ *   tenantId: 'tenant_abc',
+ *   userId: 'user_123',
+ *   exportedConfig: myConfig,
+ *   providers: createStaticProviders({ config: myConfig, planHandle: 'pro' }),
+ * });
+ *
+ * // State survives page reloads — impressions, dismissals, and caps
+ * // are persisted to localStorage automatically.
+ * await runtime.hydrate();
+ *
+ * const decision = await runtime.getPlacementDecision({
+ *   placementId: 'slot_1',
+ *   userId: 'user_123',
+ * });
+ * ```
+ */
+import { LocalRuntime } from '@revt-eng/core';
+import type { LocalRuntimeOptions } from '@revt-eng/core';
+import type { RevTurbineStorage } from './storage';
+export interface BrowserRuntimeOptions extends Omit<LocalRuntimeOptions, 'storage' | 'impressionStore'> {
+    /**
+     * Override the storage backend. When omitted, `localStorage` is used
+     * in the browser, falling back to in-memory storage otherwise.
+     */
+    storage?: RevTurbineStorage;
+    /**
+     * Maximum number of impression records to keep per user.
+     * Older records are evicted when the limit is reached.
+     * Default: 500.
+     */
+    maxImpressionRecords?: number;
+    /**
+     * Automatically call `hydrate()` during construction so
+     * impression caches are warm by the time the first decision is made.
+     * Default: true.
+     */
+    autoHydrate?: boolean;
+}
+export declare class BrowserRuntime extends LocalRuntime {
+    private readonly _hydratePromise;
+    constructor(options: BrowserRuntimeOptions);
+    /**
+     * Wait for the auto-hydration started in the constructor to complete.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    ready(): Promise<void>;
+}
+//# sourceMappingURL=browser-runtime.d.ts.map

package/dist/types/web-sdk/browser-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime.d.ts","sourceRoot":"","sources":["../../../browser-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAMnD,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,iBAAiB,CAAC;IACrG;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;gBAE3C,OAAO,EAAE,qBAAqB;IAoB1C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}