@avsbhq/node 1.8.0 → 1.9.0

package/dist/index.d.cts

@@ -351,40 +351,14 @@ interface InternalGetFlagOptions extends ServerGetFlagOptions {
     /** Runtime type check to apply, from a typed getter. */
     expectedType?: 'boolean' | 'string' | 'number' | 'json';
 }
+
 declare class AvsbServer {
-    private readonly sdkKey;
-    private readonly cdnHost;
-    private readonly pollingInterval;
-    private readonly initTimeout;
-    private readonly logger;
-    private readonly stickyBucketService;
-    private readonly eventOptions;
-    private readonly streamingEnabled;
-    private readonly streamingEndpointOption;
-    private readonly overrides;
-    private readonly resolveDecideOptions;
-    private datafile;
-    private datafileEtag;
-    private ready;
-    private destroyed;
-    private tracker;
-    private streamingClient;
-    private pollingTimer;
-    private abortController;
-    private listeners;
-    private readyPromise;
-    private pendingEvents;
-    private pendingPurchases;
-    /**
-     * Exposures produced before the tracker existed. Third member of the
-     * pre-ready family alongside `pendingEvents` and `pendingPurchases`; it used
-     * to be missing, and exposures were dropped on the floor instead.
-     */
-    private pendingExposures;
-    /** ms-epoch of the last liveness heartbeat, for the throttle. */
-    private lastHeartbeatAt;
-    /** Keys of one-time warnings, so a request loop cannot flood a log. */
-    private readonly warnedOnce;
+    /** Everything mutable about this client. See ./serverState. */
+    private readonly s;
+    private get tracker();
+    private set tracker(value);
+    private deliverExposure;
+    private initTracker;
     /**
      * `client.utils.*` surface, constructed lazily on first access so the utils
      * package is only imported when actually consumed.
@@ -413,9 +387,6 @@ declare class AvsbServer {
     onReady(): Promise<InitResult>;
     /** True when a datafile is loaded and flags are answerable right now. */
     isReady(): boolean;
-    private initializeAndReady;
-    /** Wiring that runs once a datafile is readable, however it arrived. */
-    private onDatafileReadable;
     close(): Promise<void>;
     flush(): Promise<void>;
     /**
@@ -448,8 +419,6 @@ declare class AvsbServer {
      * published API: its options bag carries package-internal fields.
      */
     evaluateInternal<T>(flagKey: string, defaultValue: NoInfer<T> | T, context?: EvalContext, options?: InternalGetFlagOptions): Flag<T>;
-    private evaluateAndBuild;
-    private checkType;
     /**
      * Every flag in the environment, evaluated against one context.
      *
@@ -515,74 +484,6 @@ declare class AvsbServer {
     createDecisionLog(): DecisionLog;
     on<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): () => void;
     off<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): void;
-    /**
-     * `on` for the shared `ClientEventMap` names the utils layer speaks. The
-     * server emits every one of them except `flagChange`, which needs per-flag
-     * diffing the server does not do; subscribing to it warns and hands back a
-     * no-op disposer instead of pretending.
-     */
-    private onSharedEvent;
-    private emit;
-    private warnOnce;
-    private evaluate;
-    /**
-     * One exposure, delivered everywhere: queued for ingestion AND emitted on
-     * the event bus with the SAME `eventId`, so a customer forwarding decisions
-     * to their own analytics can reconcile rows with A vs B results.
-     */
-    private deliverExposure;
-    private toFlag;
-    /** Build a Flag from a forced variation key (per-request forced decision). */
-    private buildForcedFlag;
-    /** Emit the evaluation event and append to a decision log if one was passed. */
-    private recordDecision;
-    private buildLegacyContext;
-    private resolveStickyBucket;
-    private findVariation;
-    private fireExposureForStickyAssignment;
-    private initTracker;
-    private enqueuePendingExposure;
-    private enqueuePending;
-    /**
-     * Fetch and apply the datafile.
-     *
-     * Three outcomes, not two, because a conditional request has three:
-     *   'applied'   a datafile came back and is now in memory
-     *   'unchanged' the CDN answered 304: what we hold IS current
-     *   'failed'    nothing usable came back; the error is already logged
-     *
-     * 'unchanged' is a success. Collapsing it into 'failed' made
-     * `refreshDatafile()` warn that a refresh "did not apply a new datafile"
-     * every time the datafile was simply up to date.
-     */
-    private loadDatafile;
-    /**
-     * Poll on a JITTERED interval. Without the jitter every process that
-     * deployed together polls the CDN on the same tick forever.
-     */
-    private startPolling;
-    /**
-     * Open the SSE stream when one is available, and fall back to polling in
-     * silence when it is not (B12). The endpoint comes from the datafile's
-     * `streamEndpoint` field, or an explicit option; it is never guessed from
-     * another host, which is what gave one port an infinite reconnect loop
-     * against DNS that does not resolve.
-     */
-    private startStreamingIfEnabled;
-    /**
-     * Report liveness, throttled.
-     *
-     * Called on every successful datafile load, not just at init: the dashboard
-     * marks an environment Stale after five minutes without a heartbeat, so an
-     * init-only heartbeat made every long-running process look dead a few
-     * minutes after it started. The throttle keeps a fast polling interval (or a
-     * burst of stream-triggered refreshes) from turning liveness into traffic.
-     *
-     * Fire and forget: a failed heartbeat never affects evaluation, and the
-     * throttle clock is stamped by the synchronous send below, so a hanging
-     * request cannot queue a second one.
-     */
-    private sendHeartbeat;
 }
 
 declare class InMemoryStickyBucketService implements StickyBucketService {
@@ -677,6 +578,6 @@ type WebhookVerifyResult = {
 declare function verifyWebhookSignature(payload: string | Buffer, headers: WebhookHeaders, secret: string, options?: VerifyWebhookOptions): WebhookVerifyResult;
 
 /** This package's version, reported on every liveness heartbeat as `sdkVersion`. */
-declare const SDK_VERSION = "1.8.0";
+declare const SDK_VERSION = "1.9.0";
 
 export { AvsbServer, type AvsbServerOptions, DEFAULT_TOLERANCE_SECONDS, type DatafileRecipe, type DatasetGetResult, type DatasetsClient, type EventOptions, type GetAllFlagsOptions, InMemoryStickyBucketService, type PurchaseOrder, type RecProduct, type RecsAttribution, type RecsClient, type RecsGetRequest, type RecsResult, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, SDK_VERSION, type ServerEventMap, type ServerEventName, type ServerGetFlagOptions, type ServerLogLevel, type UserBoundClient, type VerifyWebhookOptions, type WebhookHeaders, type WebhookVerifyFailure, type WebhookVerifyResult, createDecisionLog, defaultLogger, isDevEnvironment, resolveServerLogger, verifyWebhookSignature };

package/dist/index.d.ts

@@ -351,40 +351,14 @@ interface InternalGetFlagOptions extends ServerGetFlagOptions {
     /** Runtime type check to apply, from a typed getter. */
     expectedType?: 'boolean' | 'string' | 'number' | 'json';
 }
+
 declare class AvsbServer {
-    private readonly sdkKey;
-    private readonly cdnHost;
-    private readonly pollingInterval;
-    private readonly initTimeout;
-    private readonly logger;
-    private readonly stickyBucketService;
-    private readonly eventOptions;
-    private readonly streamingEnabled;
-    private readonly streamingEndpointOption;
-    private readonly overrides;
-    private readonly resolveDecideOptions;
-    private datafile;
-    private datafileEtag;
-    private ready;
-    private destroyed;
-    private tracker;
-    private streamingClient;
-    private pollingTimer;
-    private abortController;
-    private listeners;
-    private readyPromise;
-    private pendingEvents;
-    private pendingPurchases;
-    /**
-     * Exposures produced before the tracker existed. Third member of the
-     * pre-ready family alongside `pendingEvents` and `pendingPurchases`; it used
-     * to be missing, and exposures were dropped on the floor instead.
-     */
-    private pendingExposures;
-    /** ms-epoch of the last liveness heartbeat, for the throttle. */
-    private lastHeartbeatAt;
-    /** Keys of one-time warnings, so a request loop cannot flood a log. */
-    private readonly warnedOnce;
+    /** Everything mutable about this client. See ./serverState. */
+    private readonly s;
+    private get tracker();
+    private set tracker(value);
+    private deliverExposure;
+    private initTracker;
     /**
      * `client.utils.*` surface, constructed lazily on first access so the utils
      * package is only imported when actually consumed.
@@ -413,9 +387,6 @@ declare class AvsbServer {
     onReady(): Promise<InitResult>;
     /** True when a datafile is loaded and flags are answerable right now. */
     isReady(): boolean;
-    private initializeAndReady;
-    /** Wiring that runs once a datafile is readable, however it arrived. */
-    private onDatafileReadable;
     close(): Promise<void>;
     flush(): Promise<void>;
     /**
@@ -448,8 +419,6 @@ declare class AvsbServer {
      * published API: its options bag carries package-internal fields.
      */
     evaluateInternal<T>(flagKey: string, defaultValue: NoInfer<T> | T, context?: EvalContext, options?: InternalGetFlagOptions): Flag<T>;
-    private evaluateAndBuild;
-    private checkType;
     /**
      * Every flag in the environment, evaluated against one context.
      *
@@ -515,74 +484,6 @@ declare class AvsbServer {
     createDecisionLog(): DecisionLog;
     on<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): () => void;
     off<E extends ServerEventName>(event: E, cb: ServerEventMap[E]): void;
-    /**
-     * `on` for the shared `ClientEventMap` names the utils layer speaks. The
-     * server emits every one of them except `flagChange`, which needs per-flag
-     * diffing the server does not do; subscribing to it warns and hands back a
-     * no-op disposer instead of pretending.
-     */
-    private onSharedEvent;
-    private emit;
-    private warnOnce;
-    private evaluate;
-    /**
-     * One exposure, delivered everywhere: queued for ingestion AND emitted on
-     * the event bus with the SAME `eventId`, so a customer forwarding decisions
-     * to their own analytics can reconcile rows with A vs B results.
-     */
-    private deliverExposure;
-    private toFlag;
-    /** Build a Flag from a forced variation key (per-request forced decision). */
-    private buildForcedFlag;
-    /** Emit the evaluation event and append to a decision log if one was passed. */
-    private recordDecision;
-    private buildLegacyContext;
-    private resolveStickyBucket;
-    private findVariation;
-    private fireExposureForStickyAssignment;
-    private initTracker;
-    private enqueuePendingExposure;
-    private enqueuePending;
-    /**
-     * Fetch and apply the datafile.
-     *
-     * Three outcomes, not two, because a conditional request has three:
-     *   'applied'   a datafile came back and is now in memory
-     *   'unchanged' the CDN answered 304: what we hold IS current
-     *   'failed'    nothing usable came back; the error is already logged
-     *
-     * 'unchanged' is a success. Collapsing it into 'failed' made
-     * `refreshDatafile()` warn that a refresh "did not apply a new datafile"
-     * every time the datafile was simply up to date.
-     */
-    private loadDatafile;
-    /**
-     * Poll on a JITTERED interval. Without the jitter every process that
-     * deployed together polls the CDN on the same tick forever.
-     */
-    private startPolling;
-    /**
-     * Open the SSE stream when one is available, and fall back to polling in
-     * silence when it is not (B12). The endpoint comes from the datafile's
-     * `streamEndpoint` field, or an explicit option; it is never guessed from
-     * another host, which is what gave one port an infinite reconnect loop
-     * against DNS that does not resolve.
-     */
-    private startStreamingIfEnabled;
-    /**
-     * Report liveness, throttled.
-     *
-     * Called on every successful datafile load, not just at init: the dashboard
-     * marks an environment Stale after five minutes without a heartbeat, so an
-     * init-only heartbeat made every long-running process look dead a few
-     * minutes after it started. The throttle keeps a fast polling interval (or a
-     * burst of stream-triggered refreshes) from turning liveness into traffic.
-     *
-     * Fire and forget: a failed heartbeat never affects evaluation, and the
-     * throttle clock is stamped by the synchronous send below, so a hanging
-     * request cannot queue a second one.
-     */
-    private sendHeartbeat;
 }
 
 declare class InMemoryStickyBucketService implements StickyBucketService {
@@ -677,6 +578,6 @@ type WebhookVerifyResult = {
 declare function verifyWebhookSignature(payload: string | Buffer, headers: WebhookHeaders, secret: string, options?: VerifyWebhookOptions): WebhookVerifyResult;
 
 /** This package's version, reported on every liveness heartbeat as `sdkVersion`. */
-declare const SDK_VERSION = "1.8.0";
+declare const SDK_VERSION = "1.9.0";
 
 export { AvsbServer, type AvsbServerOptions, DEFAULT_TOLERANCE_SECONDS, type DatafileRecipe, type DatasetGetResult, type DatasetsClient, type EventOptions, type GetAllFlagsOptions, InMemoryStickyBucketService, type PurchaseOrder, type RecProduct, type RecsAttribution, type RecsClient, type RecsGetRequest, type RecsResult, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, SDK_VERSION, type ServerEventMap, type ServerEventName, type ServerGetFlagOptions, type ServerLogLevel, type UserBoundClient, type VerifyWebhookOptions, type WebhookHeaders, type WebhookVerifyFailure, type WebhookVerifyResult, createDecisionLog, defaultLogger, isDevEnvironment, resolveServerLogger, verifyWebhookSignature };