@avsbhq/node 0.3.0 → 1.2.0

package/dist/index.d.cts

@@ -1,7 +1,10 @@
-import { FlagDatafile } from '@avsbhq/js';
-export { ExposureEvent, FlagDatafile, FlagEvaluationDetails, MetricEvent } from '@avsbhq/js';
+import { FlagDatafile, StickyBucketService, Logger, EvaluationSource, StickyAssignment, DecideOption, Flag, TrackPayload, DecisionLog, InitResult, EvalContext } from '@avsbhq/core';
+export { DecideOption, DecisionLog, DecisionLogEntry, EvalContext, EvaluationSource, ExposureEvent, Flag, FlagDatafile, FlagEvaluationDetails, InitResult, Logger, MetricEvent, MultiContext, RuleType, SingleContext, StickyAssignment, StickyBucketService, TrackPayload, consoleLogger, consoleTransport, createLogger, noopLogger } from '@avsbhq/core';
+import { AvsbUtils } from '@avsbhq/utils';
+export { AvsbUtils } from '@avsbhq/utils';
+export { StreamingClient, StreamingOptions, createStreamingClient } from '@avsbhq/utils/streaming';
 
-interface AvsBServerOptions {
+interface AvsbServerOptions {
     /** SDK key for the flag environment (e.g., "env_abc123") */
     sdkKey: string;
     /** Datafile polling interval in ms. Default: 60_000 (60s). Min: 5_000. */
@@ -33,67 +36,6 @@ interface EventOptions {
     /** Retry attempts on flush failure. Default: 3. */
     retryAttempts?: number;
 }
-interface UserContext {
-    /** User identifier for bucketing. Required. */
-    userId: string;
-    /** Targeting attributes (plan, country, device, etc.). */
-    attributes?: Record<string, unknown>;
-    /** When true, evaluate without firing an exposure event. Default: false. */
-    suppressExposure?: boolean;
-    /** Collect evaluation details into this log. */
-    decisionLog?: DecisionLog;
-    /** Attribute keys to strip from event payloads (used for targeting, not sent to analytics). */
-    privateAttributes?: string[];
-}
-interface TrackContext {
-    /** User identifier. Required. */
-    userId: string;
-    /** Revenue value for conversion tracking. */
-    revenue?: number;
-    /** Custom event properties. */
-    properties?: Record<string, unknown>;
-}
-interface DecisionLog {
-    readonly entries: DecisionLogEntry[];
-}
-interface DecisionLogEntry {
-    flagKey: string;
-    value: unknown;
-    variationKey: string | null;
-    source: EvaluationSource;
-    ruleId: string | null;
-    ruleType: 'targeted_delivery' | 'ab_test' | null;
-    reasons: string[];
-    evaluatedAt: number;
-    durationMs: number;
-}
-type EvaluationSource = 'override' | 'sticky' | 'rule' | 'default' | 'not_found' | 'disabled' | 'runtime_override';
-interface ServerFlagEvaluationDetails {
-    value: unknown;
-    variationKey: string | null;
-    source: EvaluationSource;
-    ruleId: string | null;
-    ruleType: 'targeted_delivery' | 'ab_test' | null;
-    flagKey: string;
-    reasons: string[];
-}
-interface InitResult {
-    success: boolean;
-    source: 'network' | 'bootstrap' | 'cache' | 'timeout' | 'error';
-    error?: Error;
-}
-interface StickyBucketService {
-    /** Look up stored variation for a user+flag. Return variationId or null. Synchronous. */
-    lookup(userId: string, flagKey: string): string | null;
-    /** Persist a variation assignment. Fire-and-forget (may be async internally). */
-    save(userId: string, flagKey: string, variationId: string): void;
-}
-interface Logger {
-    debug(message: string, data?: Record<string, unknown>): void;
-    info(message: string, data?: Record<string, unknown>): void;
-    warn(message: string, data?: Record<string, unknown>): void;
-    error(message: string, data?: Record<string, unknown>): void;
-}
 type ServerEventMap = {
     ready: () => void;
     configUpdate: (data: {
@@ -106,6 +48,12 @@ type ServerEventMap = {
         source: EvaluationSource;
     }) => void;
     error: (error: Error) => void;
+    /** Fired when a sticky assignment references a rule that no longer matches the datafile. */
+    stickyOrphan: (data: {
+        flagKey: string;
+        userId: string;
+        assignment: StickyAssignment;
+    }) => void;
 };
 type ServerEventName = keyof ServerEventMap;
 interface MiddlewareConfig {
@@ -114,26 +62,83 @@ interface MiddlewareConfig {
     /** Extract targeting attributes from the request. */
     attributesFrom?: (req: unknown) => Record<string, unknown>;
 }
-interface RequestAvsB {
-    /** Evaluate a flag for the request's user. */
-    getFlag<T = unknown>(flagKey: string, defaultValue?: T): T;
-    /** Get full evaluation details for the request's user. */
-    getFlagDetails(flagKey: string): ServerFlagEvaluationDetails;
-    /** Get all flag values for the request's user. */
-    getAllFlags(): Record<string, unknown>;
-    /** Track a conversion event for the request's user. */
-    track(eventKey: string, properties?: {
-        revenue?: number;
-        [key: string]: unknown;
-    }): void;
+
+/**
+ * Purchase order shape for server-side purchase tracking.
+ * Mirrors the client-side snippet PurchaseOrder interface.
+ * Decimal values are forwarded as-is — no server-side currency conversion.
+ */
+interface PurchaseOrder {
+    /** Required. Unique order/transaction identifier. */
+    orderId: string;
+    /** Required. Order total as a decimal (e.g. 99.95). */
+    total: number;
+    /** ISO 4217 currency code. */
+    currency?: string;
+    subtotal?: number;
+    shipping?: number;
+    tax?: number;
+    discount?: number;
+    coupon?: string;
+    items?: Array<{
+        sku: string;
+        name?: string;
+        price?: number;
+        quantity?: number;
+        category?: string;
+    }>;
 }
-interface OverrideEntry {
-    flagKey: string;
-    variationKey: string;
-    userId?: string;
+
+/**
+ * A per-request scoped client with a bound EvalContext.
+ *
+ * Created via `server.forUser(ctx)` or the `server.createUserContext(ctx)`
+ * alias. All flag evaluations and track calls use the bound context.
+ *
+ * Forced decisions set on a UserBoundClient survive only for the lifetime
+ * of the instance — they do not affect the shared AvsbServer override state.
+ * This makes them safe for test middleware and per-request debugging.
+ *
+ * Spec §5.8.
+ */
+interface UserBoundClient {
+    getFlag<T>(flagKey: string, defaultValue: T, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<T>;
+    getBoolFlag(flagKey: string, defaultValue: boolean, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<boolean>;
+    getStringFlag(flagKey: string, defaultValue: string, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<string>;
+    getNumberFlag(flagKey: string, defaultValue: number, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<number>;
+    getJsonFlag<T>(flagKey: string, defaultValue: T, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<T>;
+    getAllFlags(options?: GetAllFlagsOptions): Record<string, Flag>;
+    track(eventKey: string, payload?: Omit<TrackPayload, 'context'>): void;
+    setForcedDecision(flagKey: string, opts: {
+        ruleId?: string;
+        variationKey: string;
+    }): void;
+    clearForcedDecision(flagKey: string): void;
+    getDecisionLog(): DecisionLog;
 }
 
-declare class AvsBServer {
+interface GetFlagOptions {
+    context?: EvalContext;
+    decideOptions?: DecideOption[];
+    decisionLog?: DecisionLog;
+    /** Internal: UserBoundClient forced decision override. */
+    forcedVariationKey?: string;
+}
+interface GetAllFlagsOptions {
+    fireExposures?: boolean;
+    decideOptions?: DecideOption[];
+}
+declare class AvsbServer {
     private sdkKey;
     private pollingInterval;
     private cdnHost;
@@ -141,57 +146,88 @@ declare class AvsBServer {
     private logger;
     private stickyBucketService;
     private eventOptions;
+    private streamingEnabled;
+    private streamingEndpoint;
     private datafile;
     private ready;
     private destroyed;
     private tracker;
+    private streamingClient;
     private pollingId;
+    private abortController;
     private overrides;
     private listeners;
     private readyPromise;
-    constructor(options: AvsBServerOptions);
+    private pendingEvents;
+    /**
+     * §6 — `client.utils.*` surface. Constructed lazily on first access so
+     * the utils package is only imported when actually consumed.
+     *
+     * The server's event surface (`ServerEventMap`) is a subset of the
+     * shared `ClientEventMap`; the utils-adapter `on` here ignores events
+     * the server doesn't emit (e.g. `flagChange`). Workstream 5 (CoW 6)
+     * harmonises the two maps when the streaming evaluator lands.
+     */
+    private _utils;
+    get utils(): AvsbUtils;
+    constructor(options: AvsbServerOptions);
     onReady(): Promise<InitResult>;
     private initializeAndReady;
     close(): Promise<void>;
     flush(): Promise<void>;
     refreshDatafile(): Promise<void>;
-    getFlag<T = unknown>(flagKey: string, userContext: UserContext, defaultValue?: T): T;
-    getFlagDetails(flagKey: string, userContext: UserContext): ServerFlagEvaluationDetails;
-    getAllFlags(userContext: UserContext): Record<string, unknown>;
-    track(eventKey: string, context: TrackContext): void;
-    logExposure(flagKey: string, userContext: {
-        userId: string;
+    getFlag<T>(flagKey: string, defaultValue: NoInfer<T> | T, options?: GetFlagOptions): Flag<T>;
+    getBoolFlag(flagKey: string, defaultValue: NoInfer<boolean> | boolean, options?: GetFlagOptions): Flag<boolean>;
+    getStringFlag(flagKey: string, defaultValue: NoInfer<string> | string, options?: GetFlagOptions): Flag<string>;
+    getNumberFlag(flagKey: string, defaultValue: NoInfer<number> | number, options?: GetFlagOptions): Flag<number>;
+    getJsonFlag<T>(flagKey: string, defaultValue: NoInfer<T> | T, options?: GetFlagOptions): Flag<T>;
+    getAllFlags(context: EvalContext, options?: GetAllFlagsOptions): Record<string, Flag>;
+    trackPurchase(visitorId: string, order: PurchaseOrder): Promise<void>;
+    track(eventKey: string, payload: TrackPayload & {
+        context: EvalContext;
     }): void;
-    setOverride(flagKey: string, variationKey: string, userId?: string): void;
-    clearOverride(flagKey: string, userId?: string): void;
+    manualExposure(flagKey: string, context: EvalContext): void;
+    forUser(context: EvalContext): UserBoundClient;
+    createUserContext(context: EvalContext): UserBoundClient;
+    setOverrideForUser(flagKey: string, contextKey: string, variationKey: string, contextKind?: string): void;
+    setGlobalOverride(flagKey: string, variationKey: string): void;
+    clearOverrideForUser(flagKey: string, contextKey: string, contextKind?: string): void;
+    clearGlobalOverride(flagKey: string): void;
     clearAllOverrides(): void;
     createDecisionLog(): DecisionLog;
-    on<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): void;
+    on<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): () => void;
     off<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): void;
     private evaluate;
+    private getTypedFlag;
+    private toFlag;
+    /** toFlag variant that never writes a decision log (used by getAllFlags suppressed path). */
+    private toFlagNoLog;
+    /** Build a Flag<T> from a forced variation key (per-request override). */
+    private buildFlagFromVariationKey;
+    private buildLegacyContext;
+    private resolveRuntimeOverride;
+    private resolveStickyBucket;
+    private findVariation;
+    private fireExposureForStickyAssignment;
     private emit;
+    private emitEvaluation;
     private initTracker;
+    private startStreamingIfEnabled;
     private fetchDatafile;
     private startPolling;
     private sendHeartbeat;
-    private resolveRuntimeOverride;
-    private resolveStickyBucket;
-    private findVariation;
-    private fireExposureForVariation;
-    private recordDecisionLog;
-    private emitEvaluation;
 }
 
-declare function expressMiddleware(client: AvsBServer, config: MiddlewareConfig): (req: unknown, res: unknown, next: () => void) => void;
+declare function expressMiddleware(client: AvsbServer, config: MiddlewareConfig): (req: unknown, res: unknown, next: () => void) => void;
 declare function fastifyPlugin(instance: unknown, opts: {
-    client: AvsBServer;
+    client: AvsbServer;
 } & MiddlewareConfig, done: () => void): void;
 
 declare class InMemoryStickyBucketService implements StickyBucketService {
     private cache;
     private key;
-    lookup(userId: string, flagKey: string): string | null;
-    save(userId: string, flagKey: string, variationId: string): void;
+    lookup(userId: string, flagKey: string): StickyAssignment | null;
+    save(userId: string, flagKey: string, assignment: StickyAssignment): void;
 }
 interface RedisLike {
     get(key: string): Promise<string | null>;
@@ -216,31 +252,14 @@ declare class RedisStickyBucketService implements StickyBucketService {
     constructor(options: RedisStickyBucketOptions);
     private redisKey;
     private cacheKey;
-    lookup(userId: string, flagKey: string): string | null;
-    save(userId: string, flagKey: string, variationId: string): void;
+    lookup(userId: string, flagKey: string): StickyAssignment | null;
+    save(userId: string, flagKey: string, assignment: StickyAssignment): void;
     private backgroundFetch;
     private evictIfNeeded;
 }
 
-interface StreamingClient {
-    connect(): void;
-    disconnect(): void;
-    isConnected(): boolean;
-}
-interface StreamingOptions {
-    endpoint: string;
-    sdkKey: string;
-    onDatafileUpdated: () => void;
-    logger: Logger;
-    reconnectDelay?: number;
-}
-declare function createStreamingClient(options: StreamingOptions): StreamingClient;
-
 declare function createDecisionLog(): DecisionLog;
 
-/** No-op logger — used when no custom logger is provided. */
-declare const noopLogger: Logger;
-
 declare const SDK_VERSION = "0.3.0";
 
-export { AvsBServer, type AvsBServerOptions, type DecisionLog, type DecisionLogEntry, type EvaluationSource, type EventOptions, InMemoryStickyBucketService, type InitResult, type Logger, type MiddlewareConfig, type OverrideEntry, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, type RequestAvsB, SDK_VERSION, type ServerEventMap, type ServerEventName, type ServerFlagEvaluationDetails, type StickyBucketService, type StreamingClient, type StreamingOptions, type TrackContext, type UserContext, createDecisionLog, createStreamingClient, expressMiddleware, fastifyPlugin, noopLogger };
+export { AvsbServer, type AvsbServerOptions, type EventOptions, type GetAllFlagsOptions, type GetFlagOptions, InMemoryStickyBucketService, type MiddlewareConfig, type PurchaseOrder, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, SDK_VERSION, type UserBoundClient, createDecisionLog, expressMiddleware, fastifyPlugin };

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-import { FlagDatafile } from '@avsbhq/js';
-export { ExposureEvent, FlagDatafile, FlagEvaluationDetails, MetricEvent } from '@avsbhq/js';
+import { FlagDatafile, StickyBucketService, Logger, EvaluationSource, StickyAssignment, DecideOption, Flag, TrackPayload, DecisionLog, InitResult, EvalContext } from '@avsbhq/core';
+export { DecideOption, DecisionLog, DecisionLogEntry, EvalContext, EvaluationSource, ExposureEvent, Flag, FlagDatafile, FlagEvaluationDetails, InitResult, Logger, MetricEvent, MultiContext, RuleType, SingleContext, StickyAssignment, StickyBucketService, TrackPayload, consoleLogger, consoleTransport, createLogger, noopLogger } from '@avsbhq/core';
+import { AvsbUtils } from '@avsbhq/utils';
+export { AvsbUtils } from '@avsbhq/utils';
+export { StreamingClient, StreamingOptions, createStreamingClient } from '@avsbhq/utils/streaming';
 
-interface AvsBServerOptions {
+interface AvsbServerOptions {
     /** SDK key for the flag environment (e.g., "env_abc123") */
     sdkKey: string;
     /** Datafile polling interval in ms. Default: 60_000 (60s). Min: 5_000. */
@@ -33,67 +36,6 @@ interface EventOptions {
     /** Retry attempts on flush failure. Default: 3. */
     retryAttempts?: number;
 }
-interface UserContext {
-    /** User identifier for bucketing. Required. */
-    userId: string;
-    /** Targeting attributes (plan, country, device, etc.). */
-    attributes?: Record<string, unknown>;
-    /** When true, evaluate without firing an exposure event. Default: false. */
-    suppressExposure?: boolean;
-    /** Collect evaluation details into this log. */
-    decisionLog?: DecisionLog;
-    /** Attribute keys to strip from event payloads (used for targeting, not sent to analytics). */
-    privateAttributes?: string[];
-}
-interface TrackContext {
-    /** User identifier. Required. */
-    userId: string;
-    /** Revenue value for conversion tracking. */
-    revenue?: number;
-    /** Custom event properties. */
-    properties?: Record<string, unknown>;
-}
-interface DecisionLog {
-    readonly entries: DecisionLogEntry[];
-}
-interface DecisionLogEntry {
-    flagKey: string;
-    value: unknown;
-    variationKey: string | null;
-    source: EvaluationSource;
-    ruleId: string | null;
-    ruleType: 'targeted_delivery' | 'ab_test' | null;
-    reasons: string[];
-    evaluatedAt: number;
-    durationMs: number;
-}
-type EvaluationSource = 'override' | 'sticky' | 'rule' | 'default' | 'not_found' | 'disabled' | 'runtime_override';
-interface ServerFlagEvaluationDetails {
-    value: unknown;
-    variationKey: string | null;
-    source: EvaluationSource;
-    ruleId: string | null;
-    ruleType: 'targeted_delivery' | 'ab_test' | null;
-    flagKey: string;
-    reasons: string[];
-}
-interface InitResult {
-    success: boolean;
-    source: 'network' | 'bootstrap' | 'cache' | 'timeout' | 'error';
-    error?: Error;
-}
-interface StickyBucketService {
-    /** Look up stored variation for a user+flag. Return variationId or null. Synchronous. */
-    lookup(userId: string, flagKey: string): string | null;
-    /** Persist a variation assignment. Fire-and-forget (may be async internally). */
-    save(userId: string, flagKey: string, variationId: string): void;
-}
-interface Logger {
-    debug(message: string, data?: Record<string, unknown>): void;
-    info(message: string, data?: Record<string, unknown>): void;
-    warn(message: string, data?: Record<string, unknown>): void;
-    error(message: string, data?: Record<string, unknown>): void;
-}
 type ServerEventMap = {
     ready: () => void;
     configUpdate: (data: {
@@ -106,6 +48,12 @@ type ServerEventMap = {
         source: EvaluationSource;
     }) => void;
     error: (error: Error) => void;
+    /** Fired when a sticky assignment references a rule that no longer matches the datafile. */
+    stickyOrphan: (data: {
+        flagKey: string;
+        userId: string;
+        assignment: StickyAssignment;
+    }) => void;
 };
 type ServerEventName = keyof ServerEventMap;
 interface MiddlewareConfig {
@@ -114,26 +62,83 @@ interface MiddlewareConfig {
     /** Extract targeting attributes from the request. */
     attributesFrom?: (req: unknown) => Record<string, unknown>;
 }
-interface RequestAvsB {
-    /** Evaluate a flag for the request's user. */
-    getFlag<T = unknown>(flagKey: string, defaultValue?: T): T;
-    /** Get full evaluation details for the request's user. */
-    getFlagDetails(flagKey: string): ServerFlagEvaluationDetails;
-    /** Get all flag values for the request's user. */
-    getAllFlags(): Record<string, unknown>;
-    /** Track a conversion event for the request's user. */
-    track(eventKey: string, properties?: {
-        revenue?: number;
-        [key: string]: unknown;
-    }): void;
+
+/**
+ * Purchase order shape for server-side purchase tracking.
+ * Mirrors the client-side snippet PurchaseOrder interface.
+ * Decimal values are forwarded as-is — no server-side currency conversion.
+ */
+interface PurchaseOrder {
+    /** Required. Unique order/transaction identifier. */
+    orderId: string;
+    /** Required. Order total as a decimal (e.g. 99.95). */
+    total: number;
+    /** ISO 4217 currency code. */
+    currency?: string;
+    subtotal?: number;
+    shipping?: number;
+    tax?: number;
+    discount?: number;
+    coupon?: string;
+    items?: Array<{
+        sku: string;
+        name?: string;
+        price?: number;
+        quantity?: number;
+        category?: string;
+    }>;
 }
-interface OverrideEntry {
-    flagKey: string;
-    variationKey: string;
-    userId?: string;
+
+/**
+ * A per-request scoped client with a bound EvalContext.
+ *
+ * Created via `server.forUser(ctx)` or the `server.createUserContext(ctx)`
+ * alias. All flag evaluations and track calls use the bound context.
+ *
+ * Forced decisions set on a UserBoundClient survive only for the lifetime
+ * of the instance — they do not affect the shared AvsbServer override state.
+ * This makes them safe for test middleware and per-request debugging.
+ *
+ * Spec §5.8.
+ */
+interface UserBoundClient {
+    getFlag<T>(flagKey: string, defaultValue: T, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<T>;
+    getBoolFlag(flagKey: string, defaultValue: boolean, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<boolean>;
+    getStringFlag(flagKey: string, defaultValue: string, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<string>;
+    getNumberFlag(flagKey: string, defaultValue: number, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<number>;
+    getJsonFlag<T>(flagKey: string, defaultValue: T, options?: {
+        decideOptions?: DecideOption[];
+    }): Flag<T>;
+    getAllFlags(options?: GetAllFlagsOptions): Record<string, Flag>;
+    track(eventKey: string, payload?: Omit<TrackPayload, 'context'>): void;
+    setForcedDecision(flagKey: string, opts: {
+        ruleId?: string;
+        variationKey: string;
+    }): void;
+    clearForcedDecision(flagKey: string): void;
+    getDecisionLog(): DecisionLog;
 }
 
-declare class AvsBServer {
+interface GetFlagOptions {
+    context?: EvalContext;
+    decideOptions?: DecideOption[];
+    decisionLog?: DecisionLog;
+    /** Internal: UserBoundClient forced decision override. */
+    forcedVariationKey?: string;
+}
+interface GetAllFlagsOptions {
+    fireExposures?: boolean;
+    decideOptions?: DecideOption[];
+}
+declare class AvsbServer {
     private sdkKey;
     private pollingInterval;
     private cdnHost;
@@ -141,57 +146,88 @@ declare class AvsBServer {
     private logger;
     private stickyBucketService;
     private eventOptions;
+    private streamingEnabled;
+    private streamingEndpoint;
     private datafile;
     private ready;
     private destroyed;
     private tracker;
+    private streamingClient;
     private pollingId;
+    private abortController;
     private overrides;
     private listeners;
     private readyPromise;
-    constructor(options: AvsBServerOptions);
+    private pendingEvents;
+    /**
+     * §6 — `client.utils.*` surface. Constructed lazily on first access so
+     * the utils package is only imported when actually consumed.
+     *
+     * The server's event surface (`ServerEventMap`) is a subset of the
+     * shared `ClientEventMap`; the utils-adapter `on` here ignores events
+     * the server doesn't emit (e.g. `flagChange`). Workstream 5 (CoW 6)
+     * harmonises the two maps when the streaming evaluator lands.
+     */
+    private _utils;
+    get utils(): AvsbUtils;
+    constructor(options: AvsbServerOptions);
     onReady(): Promise<InitResult>;
     private initializeAndReady;
     close(): Promise<void>;
     flush(): Promise<void>;
     refreshDatafile(): Promise<void>;
-    getFlag<T = unknown>(flagKey: string, userContext: UserContext, defaultValue?: T): T;
-    getFlagDetails(flagKey: string, userContext: UserContext): ServerFlagEvaluationDetails;
-    getAllFlags(userContext: UserContext): Record<string, unknown>;
-    track(eventKey: string, context: TrackContext): void;
-    logExposure(flagKey: string, userContext: {
-        userId: string;
+    getFlag<T>(flagKey: string, defaultValue: NoInfer<T> | T, options?: GetFlagOptions): Flag<T>;
+    getBoolFlag(flagKey: string, defaultValue: NoInfer<boolean> | boolean, options?: GetFlagOptions): Flag<boolean>;
+    getStringFlag(flagKey: string, defaultValue: NoInfer<string> | string, options?: GetFlagOptions): Flag<string>;
+    getNumberFlag(flagKey: string, defaultValue: NoInfer<number> | number, options?: GetFlagOptions): Flag<number>;
+    getJsonFlag<T>(flagKey: string, defaultValue: NoInfer<T> | T, options?: GetFlagOptions): Flag<T>;
+    getAllFlags(context: EvalContext, options?: GetAllFlagsOptions): Record<string, Flag>;
+    trackPurchase(visitorId: string, order: PurchaseOrder): Promise<void>;
+    track(eventKey: string, payload: TrackPayload & {
+        context: EvalContext;
     }): void;
-    setOverride(flagKey: string, variationKey: string, userId?: string): void;
-    clearOverride(flagKey: string, userId?: string): void;
+    manualExposure(flagKey: string, context: EvalContext): void;
+    forUser(context: EvalContext): UserBoundClient;
+    createUserContext(context: EvalContext): UserBoundClient;
+    setOverrideForUser(flagKey: string, contextKey: string, variationKey: string, contextKind?: string): void;
+    setGlobalOverride(flagKey: string, variationKey: string): void;
+    clearOverrideForUser(flagKey: string, contextKey: string, contextKind?: string): void;
+    clearGlobalOverride(flagKey: string): void;
     clearAllOverrides(): void;
     createDecisionLog(): DecisionLog;
-    on<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): void;
+    on<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): () => void;
     off<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): void;
     private evaluate;
+    private getTypedFlag;
+    private toFlag;
+    /** toFlag variant that never writes a decision log (used by getAllFlags suppressed path). */
+    private toFlagNoLog;
+    /** Build a Flag<T> from a forced variation key (per-request override). */
+    private buildFlagFromVariationKey;
+    private buildLegacyContext;
+    private resolveRuntimeOverride;
+    private resolveStickyBucket;
+    private findVariation;
+    private fireExposureForStickyAssignment;
     private emit;
+    private emitEvaluation;
     private initTracker;
+    private startStreamingIfEnabled;
     private fetchDatafile;
     private startPolling;
     private sendHeartbeat;
-    private resolveRuntimeOverride;
-    private resolveStickyBucket;
-    private findVariation;
-    private fireExposureForVariation;
-    private recordDecisionLog;
-    private emitEvaluation;
 }
 
-declare function expressMiddleware(client: AvsBServer, config: MiddlewareConfig): (req: unknown, res: unknown, next: () => void) => void;
+declare function expressMiddleware(client: AvsbServer, config: MiddlewareConfig): (req: unknown, res: unknown, next: () => void) => void;
 declare function fastifyPlugin(instance: unknown, opts: {
-    client: AvsBServer;
+    client: AvsbServer;
 } & MiddlewareConfig, done: () => void): void;
 
 declare class InMemoryStickyBucketService implements StickyBucketService {
     private cache;
     private key;
-    lookup(userId: string, flagKey: string): string | null;
-    save(userId: string, flagKey: string, variationId: string): void;
+    lookup(userId: string, flagKey: string): StickyAssignment | null;
+    save(userId: string, flagKey: string, assignment: StickyAssignment): void;
 }
 interface RedisLike {
     get(key: string): Promise<string | null>;
@@ -216,31 +252,14 @@ declare class RedisStickyBucketService implements StickyBucketService {
     constructor(options: RedisStickyBucketOptions);
     private redisKey;
     private cacheKey;
-    lookup(userId: string, flagKey: string): string | null;
-    save(userId: string, flagKey: string, variationId: string): void;
+    lookup(userId: string, flagKey: string): StickyAssignment | null;
+    save(userId: string, flagKey: string, assignment: StickyAssignment): void;
     private backgroundFetch;
     private evictIfNeeded;
 }
 
-interface StreamingClient {
-    connect(): void;
-    disconnect(): void;
-    isConnected(): boolean;
-}
-interface StreamingOptions {
-    endpoint: string;
-    sdkKey: string;
-    onDatafileUpdated: () => void;
-    logger: Logger;
-    reconnectDelay?: number;
-}
-declare function createStreamingClient(options: StreamingOptions): StreamingClient;
-
 declare function createDecisionLog(): DecisionLog;
 
-/** No-op logger — used when no custom logger is provided. */
-declare const noopLogger: Logger;
-
 declare const SDK_VERSION = "0.3.0";
 
-export { AvsBServer, type AvsBServerOptions, type DecisionLog, type DecisionLogEntry, type EvaluationSource, type EventOptions, InMemoryStickyBucketService, type InitResult, type Logger, type MiddlewareConfig, type OverrideEntry, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, type RequestAvsB, SDK_VERSION, type ServerEventMap, type ServerEventName, type ServerFlagEvaluationDetails, type StickyBucketService, type StreamingClient, type StreamingOptions, type TrackContext, type UserContext, createDecisionLog, createStreamingClient, expressMiddleware, fastifyPlugin, noopLogger };
+export { AvsbServer, type AvsbServerOptions, type EventOptions, type GetAllFlagsOptions, type GetFlagOptions, InMemoryStickyBucketService, type MiddlewareConfig, type PurchaseOrder, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, SDK_VERSION, type UserBoundClient, createDecisionLog, expressMiddleware, fastifyPlugin };