@avsbhq/node 1.7.0 → 1.7.1

package/dist/index.cjs

@@ -701,7 +701,7 @@ function createServerTracker(options) {
 var import_streaming = require("@avsbhq/utils/streaming");
 
 // src/version.ts
-var SDK_VERSION = "1.7.0";
+var SDK_VERSION = "1.7.1";
 
 // src/UserBoundClient.ts
 var import_core6 = require("@avsbhq/core");
@@ -844,6 +844,12 @@ var AvsbServer = class {
   readyPromise = null;
   pendingEvents = [];
   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.
+   */
+  pendingExposures = [];
   /** ms-epoch of the last liveness heartbeat, for the throttle. */
   lastHeartbeatAt = 0;
   /** Keys of one-time warnings, so a request loop cannot flood a log. */
@@ -920,6 +926,7 @@ var AvsbServer = class {
     if (!keyShape.valid && keyShape.message) {
       this.logger.error(keyShape.message);
     }
+    if (this.datafile) this.initTracker();
   }
   // ---------------------------------------------------------------------------
   // Readiness
@@ -1029,7 +1036,9 @@ var AvsbServer = class {
       this.logger.warn(
         "AvsB datafile refresh did not apply a new datafile; the SDK keeps serving the one it already has. The request error is logged above."
       );
+      return;
     }
+    if (result === "applied" && !this.ready) this.onDatafileReadable();
   }
   /**
    * Adopt a datafile received out of band: a bootstrap blob from
@@ -1049,6 +1058,7 @@ var AvsbServer = class {
       this.onDatafileReadable();
       return;
     }
+    this.initTracker();
     if (changed) {
       this.emit("configUpdate", {
         publishedAt: datafile.publishedAt,
@@ -1456,7 +1466,11 @@ var AvsbServer = class {
    */
   deliverExposure(event) {
     const stamped = event.eventId ? event : { ...event, eventId: (0, import_node_crypto2.randomUUID)() };
-    this.tracker?.queue(stamped);
+    if (this.tracker) {
+      this.tracker.queue(stamped);
+    } else {
+      this.enqueuePendingExposure(stamped);
+    }
     this.emit("exposure", stamped);
   }
   toFlag(result, defaultValue) {
@@ -1579,7 +1593,7 @@ var AvsbServer = class {
   // ---------------------------------------------------------------------------
   initTracker() {
     if (!this.datafile || this.tracker) return;
-    this.tracker = createServerTracker({
+    const tracker = createServerTracker({
       sdkKey: this.sdkKey,
       collectEndpoint: this.datafile.collectEndpoint,
       flushInterval: this.eventOptions.flushInterval,
@@ -1588,6 +1602,12 @@ var AvsbServer = class {
       retryAttempts: this.eventOptions.retryAttempts,
       logger: this.logger
     });
+    this.tracker = tracker;
+    if (this.pendingExposures.length > 0) {
+      const queued = this.pendingExposures;
+      this.pendingExposures = [];
+      for (const event of queued) tracker.queue(event);
+    }
     if (this.pendingEvents.length > 0) {
       const queued = this.pendingEvents;
       this.pendingEvents = [];
@@ -1599,6 +1619,16 @@ var AvsbServer = class {
       for (const item of queued) void this.trackPurchase(item.visitorId, item.order);
     }
   }
+  enqueuePendingExposure(event) {
+    if (this.pendingExposures.length >= this.eventOptions.maxQueueSize) {
+      this.pendingExposures.shift();
+      this.warnOnce(
+        "pending-exposures-full",
+        `Pre-ready exposure queue reached ${this.eventOptions.maxQueueSize} events; the oldest are being dropped. This means the datafile never loaded, so nothing has been delivered yet: check the datafile error logged above.`
+      );
+    }
+    this.pendingExposures.push(event);
+  }
   enqueuePending(eventKey, payload) {
     if (this.pendingEvents.length >= this.eventOptions.maxQueueSize) {
       this.pendingEvents.shift();

package/dist/index.d.cts

@@ -375,6 +375,12 @@ declare class AvsbServer {
     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. */
@@ -535,6 +541,7 @@ declare class AvsbServer {
     private findVariation;
     private fireExposureForStickyAssignment;
     private initTracker;
+    private enqueuePendingExposure;
     private enqueuePending;
     /**
      * Fetch and apply the datafile.
@@ -669,6 +676,6 @@ type WebhookVerifyResult = {
  */
 declare function verifyWebhookSignature(payload: string | Buffer, headers: WebhookHeaders, secret: string, options?: VerifyWebhookOptions): WebhookVerifyResult;
 
-declare const SDK_VERSION = "1.7.0";
+declare const SDK_VERSION = "1.7.1";
 
 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

@@ -375,6 +375,12 @@ declare class AvsbServer {
     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. */
@@ -535,6 +541,7 @@ declare class AvsbServer {
     private findVariation;
     private fireExposureForStickyAssignment;
     private initTracker;
+    private enqueuePendingExposure;
     private enqueuePending;
     /**
      * Fetch and apply the datafile.
@@ -669,6 +676,6 @@ type WebhookVerifyResult = {
  */
 declare function verifyWebhookSignature(payload: string | Buffer, headers: WebhookHeaders, secret: string, options?: VerifyWebhookOptions): WebhookVerifyResult;
 
-declare const SDK_VERSION = "1.7.0";
+declare const SDK_VERSION = "1.7.1";
 
 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.js

@@ -667,7 +667,7 @@ import {
 } from "@avsbhq/utils/streaming";
 
 // src/version.ts
-var SDK_VERSION = "1.7.0";
+var SDK_VERSION = "1.7.1";
 
 // src/UserBoundClient.ts
 import { bucketingKey } from "@avsbhq/core";
@@ -810,6 +810,12 @@ var AvsbServer = class {
   readyPromise = null;
   pendingEvents = [];
   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.
+   */
+  pendingExposures = [];
   /** ms-epoch of the last liveness heartbeat, for the throttle. */
   lastHeartbeatAt = 0;
   /** Keys of one-time warnings, so a request loop cannot flood a log. */
@@ -886,6 +892,7 @@ var AvsbServer = class {
     if (!keyShape.valid && keyShape.message) {
       this.logger.error(keyShape.message);
     }
+    if (this.datafile) this.initTracker();
   }
   // ---------------------------------------------------------------------------
   // Readiness
@@ -995,7 +1002,9 @@ var AvsbServer = class {
       this.logger.warn(
         "AvsB datafile refresh did not apply a new datafile; the SDK keeps serving the one it already has. The request error is logged above."
       );
+      return;
     }
+    if (result === "applied" && !this.ready) this.onDatafileReadable();
   }
   /**
    * Adopt a datafile received out of band: a bootstrap blob from
@@ -1015,6 +1024,7 @@ var AvsbServer = class {
       this.onDatafileReadable();
       return;
     }
+    this.initTracker();
     if (changed) {
       this.emit("configUpdate", {
         publishedAt: datafile.publishedAt,
@@ -1422,7 +1432,11 @@ var AvsbServer = class {
    */
   deliverExposure(event) {
     const stamped = event.eventId ? event : { ...event, eventId: randomUUID2() };
-    this.tracker?.queue(stamped);
+    if (this.tracker) {
+      this.tracker.queue(stamped);
+    } else {
+      this.enqueuePendingExposure(stamped);
+    }
     this.emit("exposure", stamped);
   }
   toFlag(result, defaultValue) {
@@ -1545,7 +1559,7 @@ var AvsbServer = class {
   // ---------------------------------------------------------------------------
   initTracker() {
     if (!this.datafile || this.tracker) return;
-    this.tracker = createServerTracker({
+    const tracker = createServerTracker({
       sdkKey: this.sdkKey,
       collectEndpoint: this.datafile.collectEndpoint,
       flushInterval: this.eventOptions.flushInterval,
@@ -1554,6 +1568,12 @@ var AvsbServer = class {
       retryAttempts: this.eventOptions.retryAttempts,
       logger: this.logger
     });
+    this.tracker = tracker;
+    if (this.pendingExposures.length > 0) {
+      const queued = this.pendingExposures;
+      this.pendingExposures = [];
+      for (const event of queued) tracker.queue(event);
+    }
     if (this.pendingEvents.length > 0) {
       const queued = this.pendingEvents;
       this.pendingEvents = [];
@@ -1565,6 +1585,16 @@ var AvsbServer = class {
       for (const item of queued) void this.trackPurchase(item.visitorId, item.order);
     }
   }
+  enqueuePendingExposure(event) {
+    if (this.pendingExposures.length >= this.eventOptions.maxQueueSize) {
+      this.pendingExposures.shift();
+      this.warnOnce(
+        "pending-exposures-full",
+        `Pre-ready exposure queue reached ${this.eventOptions.maxQueueSize} events; the oldest are being dropped. This means the datafile never loaded, so nothing has been delivered yet: check the datafile error logged above.`
+      );
+    }
+    this.pendingExposures.push(event);
+  }
   enqueuePending(eventKey, payload) {
     if (this.pendingEvents.length >= this.eventOptions.maxQueueSize) {
       this.pendingEvents.shift();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avsbhq/node",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "Node.js server SDK for A vs B feature flags and experiments: per-request contexts, sticky bucketing, decision logs, and batched event delivery.",
   "keywords": [
     "avsb",