@runbandit/sdk 2.0.1 → 2.1.0

package/dist/index.js

@@ -51,7 +51,6 @@ var BanditsClient = class {
       batchSize: 100,
       flushInterval: 1e4,
       sessionTtl: 864e5,
-      // 24 hours in ms
       ...config
     };
     this.sessionId = this.getOrCreateSessionId();
@@ -86,11 +85,6 @@ var BanditsClient = class {
       config: assignment.treatment?.config || {}
     };
   }
-  /**
-   * Track a named event for session-based attribution (recommended)
-   * Events are matched to bandits by sessionId — no assignmentId needed
-   * Set immediate: true to fire synchronously (survives navigation)
-   */
   trackNamedEvent(event, opts) {
     const request = {
       name: event.name,
@@ -139,21 +133,6 @@ var BanditsClient = class {
       throw error;
     }
   }
-  /**
-   * Link an anonymous user ID to a durable identity (e.g. email, account ID).
-   * All historical assignments and events for the anonymous ID are re-attributed
-   * to the identified user. Future calls to getAssignment() with either ID will
-   * resolve to the same assignment.
-   *
-   * Requires admin authentication — the client must be configured with a
-   * personal access token (PAT) instead of an API key, and companyId must
-   * be provided. This is a management operation, not an SDK client operation.
-   *
-   * @param anonymousId - The temporary/anonymous user ID (e.g. crypto.randomUUID())
-   * @param identifiedUserId - The permanent user ID (e.g. email, database ID)
-   * @param companyId - The company ID (required for PAT auth)
-   * @param mergeReason - Why the identification is happening
-   */
   async identify(anonymousId, identifiedUserId, companyId, mergeReason) {
     const response = await this.makeRequest(
       "/identify",
@@ -169,14 +148,12 @@ var BanditsClient = class {
       throw new Error(response.error || "Failed to identify user");
     }
   }
-  /**
-   * Record a funnel payout event.
-   * Call this when the terminal conversion happens (e.g., purchase).
-   *
-   * @param funnelId - The funnel ID
-   * @param userId - The user who converted
-   * @param value - The payout value (e.g., purchase amount in dollars)
-   */
+  async label(userId, labels) {
+    const response = await this.makeRequest("/labels", "POST", { userId, labels });
+    if (!response.success) {
+      throw new Error(response.error || "Failed to record labels");
+    }
+  }
   async trackFunnelReward(funnelId, userId, value) {
     const response = await this.makeRequest(
       `/funnels/${funnelId}/reward`,
@@ -221,10 +198,6 @@ var BanditsClient = class {
   generateId() {
     return generateId();
   }
-  /**
-   * Normalize the apiUrl by adding /api prefix if not present.
-   * Supports both 'https://runbandit.com' and 'https://runbandit.com/api'.
-   */
   normalizeApiUrl() {
     let baseUrl = this.config.apiUrl.replace(/\/$/, "");
     if (!baseUrl.endsWith("/api")) {
@@ -780,16 +753,6 @@ var SnapshotClient = class {
       this.snapshot = this.readSnapshot();
     }
   }
-  /**
-   * Decide an arm with no network call, or return null.
-   *
-   * Null means "this caller must fall back" - a cold cache, an expired one, an
-   * unknown experiment, or one whose state cannot be served from a static
-   * document. Returning null rather than the control is deliberate: the caller
-   * renders control itself, and no impression is reported for it. Reporting a
-   * forced-control impression would inflate the control arm's trials with
-   * decisions the bandit never made.
-   */
   getAssignmentSync(experimentId, userId) {
     const snapshot = this.freshSnapshot();
     if (!snapshot) return null;
@@ -816,7 +779,6 @@ var SnapshotClient = class {
     decisions[key] = {
       clientAssignmentId,
       treatmentId: treatment.id,
-      // expiresAt is milliseconds here; assignmentTtl arrives in seconds.
       expiresAt: this.now() + ttlSeconds * 1e3
     };
     this.writeDecisions(decisions);
@@ -835,7 +797,6 @@ var SnapshotClient = class {
       config: treatment.config
     };
   }
-  /** Fetch a fresh snapshot and cache it. Safe to call on every pageview. */
   async refresh() {
     const response = await this.fetchImpl(`${this.config.apiUrl}/snapshot`, {
       method: "GET",
@@ -846,14 +807,6 @@ var SnapshotClient = class {
     this.snapshot = snapshot;
     this.persistSnapshot(snapshot);
   }
-  /**
-   * Post queued impressions.
-   *
-   * The queue is only cleared on success. A failed flush leaves the reports in
-   * storage, so a pageview that happened offline is still counted when the
-   * next one succeeds - the trial really did occur, and dropping it would bias
-   * the arm's denominator downward.
-   */
   async flush() {
     if (this.inFlight) return this.inFlight;
     this.inFlight = this.doFlush().finally(() => {
@@ -881,14 +834,12 @@ var SnapshotClient = class {
     this.queue = this.queue.slice(reports.length);
     this.persistQueue();
   }
-  /** The session id these reports are attributed under. */
   getSessionId() {
     return this.sessionId;
   }
   pendingReportCount() {
     return this.queue.length;
   }
-  /** The cached snapshot, or null when absent or past its ttl. */
   freshSnapshot() {
     if (!this.snapshot) return null;
     if (this.snapshot.ttl === 0) return null;
@@ -921,7 +872,6 @@ var SnapshotClient = class {
       return [];
     }
   }
-  /** Stored decisions, pruned of expired entries. */
   readDecisions() {
     if (!this.storage) return {};
     try {
@@ -1130,9 +1080,6 @@ async function reportPlanImpressions(plan, recipientIds, options) {
     headers: { "Content-Type": "application/json", "x-api-key": options.apiKey },
     body: JSON.stringify({
       campaignId: plan.campaignId,
-      // Derived from the recipients this call covers, so a retry of the same
-      // chunk collapses onto the same key without the caller needing to
-      // invent and persist an idempotency token of its own.
       batchKey: options.batchKey ?? await batchKeyFor(plan.campaignId, recipientIds),
       counts
     })