@runbandit/sdk 1.0.0

package/README.md

@@ -0,0 +1,32 @@
+# @runbandit/sdk
+
+Browser/Node.js SDK for [Bandit](https://runbandit.com) — algorithmic A/B testing and treatment optimization with multi-armed bandits.
+
+## Install
+
+```bash
+npm install @runbandit/sdk
+```
+
+## Usage
+
+```ts
+import { BanditsClient } from '@runbandit/sdk'
+
+const client = new BanditsClient({
+  apiUrl: 'https://app.runbandit.com',
+  apiKey: 'your-api-key',
+})
+
+const assignment = await client.getAssignment('experiment-id', 'user-id')
+showTreatment(assignment.treatment.config)
+
+// Track a conversion. Pass { immediate: true } for events right before navigation.
+client.trackNamedEvent({
+  name: 'conversion',
+  value: 29.99,
+  metadata: { assignmentId: assignment.assignmentId },
+})
+```
+
+See the [SDK docs](https://runbandit.com/docs/sdk) for the full API.

package/dist/index.d.ts

@@ -0,0 +1,336 @@
+interface Company {
+    id: string;
+    name: string;
+    subdomain?: string;
+    domain?: string;
+    plan: string;
+    apiKey: string;
+    status: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface User {
+    id: string;
+    email: string;
+    name: string;
+    image?: string;
+    role: string;
+    companyId: string | null;
+    emailVerified?: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface Session {
+    id: string;
+    userId: string;
+    token: string;
+    expiresAt: Date;
+    ipAddress?: string | null;
+    userAgent?: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface Account {
+    id: string;
+    userId: string;
+    provider: string;
+    providerAccountId: string;
+    accessToken?: string;
+    refreshToken?: string;
+    accessTokenExpiresAt?: Date;
+    refreshTokenExpiresAt?: Date;
+    scope?: string;
+    idToken?: string;
+    sessionState?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface Experiment {
+    id: string;
+    name: string;
+    description?: string;
+    algorithm: BanditAlgorithm;
+    status: ExperimentStatus;
+    contentType: ContentType;
+    treatments: Treatment[];
+    context?: Record<string, any>;
+    image?: string;
+    emoji?: string;
+    assignmentTtl: number;
+    companyId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    endAt?: Date;
+}
+interface Treatment {
+    id: string;
+    experimentId: string;
+    name: string;
+    description?: string;
+    config: VariantConfig;
+    weight?: number;
+    companyId: string;
+    createdAt: Date;
+}
+interface AlgorithmResult {
+    treatmentId: string;
+    confidence: number;
+}
+interface BanditResult {
+    assignmentId: string;
+    treatmentId: string;
+    confidence: number;
+    metadata?: Record<string, any>;
+}
+interface ContextualFeatures {
+    [key: string]: string | number | boolean;
+}
+declare enum ExperimentStatus {
+    DRAFT = "draft",
+    ACTIVE = "active",
+    PAUSED = "paused",
+    COMPLETED = "completed",
+    ARCHIVED = "archived"
+}
+interface TreatmentMetadata {
+    strategy?: string;
+    tone?: string;
+    ctaStyle?: string;
+    emotionalHook?: string;
+    reasoning?: string;
+    tags?: string[];
+    generated?: boolean;
+    generatedAt?: string;
+}
+interface VariantConfig {
+    content: string;
+    metadata?: TreatmentMetadata & Record<string, any>;
+}
+declare enum BanditAlgorithm {
+    EPSILON_GREEDY = "epsilon_greedy",
+    UCB1 = "ucb1",
+    THOMPSON_SAMPLING = "thompson_sampling",
+    CONTEXTUAL_LINEAR = "contextual_linear",
+    CONTEXTUAL_NEURAL = "contextual_neural"
+}
+declare enum ContentType {
+    PLAIN_TEXT = "plain_text",
+    MARKDOWN = "markdown",
+    HTML = "html",
+    CSS = "css",
+    JAVASCRIPT = "javascript",
+    JSON = "json",
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio",
+    DOCUMENT = "document"
+}
+declare function getContentTypeCategory(contentType: ContentType): 'text' | 'code' | 'file';
+interface BanditConfig {
+    algorithm: BanditAlgorithm;
+    parameters: Record<string, any>;
+}
+interface ExperimentStats {
+    totalAssignments: number;
+    totalConversions: number;
+    conversionRate: number;
+    treatmentStats: Record<string, TreatmentStats>;
+}
+interface TreatmentStats {
+    assignments: number;
+    conversions: number;
+    conversionRate: number;
+    confidence: number;
+    lift?: number;
+}
+interface APIResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    timestamp: Date;
+}
+interface CreateExperimentRequest {
+    name: string;
+    description?: string;
+    algorithm: BanditAlgorithm;
+    contentType: ContentType;
+    algorithmConfig?: Record<string, any>;
+    treatments?: Omit<Treatment, 'id' | 'experimentId' | 'createdAt'>[];
+}
+interface AssignmentRequest {
+    experimentId: string;
+    userId: string;
+    context?: ContextualFeatures;
+    sessionId?: string;
+}
+interface TrackNamedEventRequest {
+    name: string;
+    category?: string;
+    value?: number;
+    metadata?: Record<string, any>;
+    sessionId: string;
+}
+declare enum FunnelStatus {
+    DRAFT = "draft",
+    ACTIVE = "active",
+    PAUSED = "paused",
+    COMPLETED = "completed"
+}
+interface Funnel {
+    id: string;
+    name: string;
+    description?: string;
+    status: FunnelStatus;
+    conversionWindowMs: number;
+    companyId: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface FunnelRewardRequest {
+    funnelId: string;
+    userId: string;
+    value: number;
+}
+interface ApiKey {
+    id: string;
+    name: string;
+    keyPrefix: string;
+    status: 'active' | 'revoked';
+    createdBy: string;
+    createdAt: Date;
+    lastUsedAt?: Date;
+    revokedAt?: Date;
+    revokedBy?: string;
+}
+interface CreateApiKeyRequest {
+    name: string;
+}
+interface CreateApiKeyResponse {
+    id: string;
+    key: string;
+    name: string;
+}
+type IdentifyMergeReason = 'user_signup' | 'email_verification' | 'social_login' | 'account_recovery' | 'manual';
+interface IdentifyUserRequest {
+    anonymousId: string;
+    identifiedUserId: string;
+    mergeReason?: IdentifyMergeReason;
+}
+interface IdentifyUserResponse {
+    anonymousId: string;
+    identifiedUserId: string;
+    alreadyMapped: boolean;
+}
+interface ResolvedIdentity {
+    canonicalId: string;
+    anonymousIds: string[];
+    isIdentified: boolean;
+}
+
+declare function generateId(): string;
+declare function validateTreatmentWeights(treatments: Treatment[]): boolean;
+declare function normalizeTreatmentWeights(treatments: Treatment[]): Treatment[];
+declare function calculateConfidenceInterval(successes: number, trials: number, confidence?: number): {
+    lower: number;
+    upper: number;
+};
+declare function isValidEmail(email: string): boolean;
+declare function sanitizeMetadata(metadata: Record<string, any>): Record<string, any>;
+/**
+ * Generates a URL-safe subdomain from a company name
+ * @param name Company name
+ * @returns URL-safe subdomain
+ */
+declare function generateSubdomain(name: string): string;
+/**
+ * Validates if a subdomain is properly formatted
+ * @param subdomain Subdomain to validate
+ * @returns true if valid, false otherwise
+ */
+declare function isValidSubdomain(subdomain: string): boolean;
+/**
+ * Extracts subdomain from hostname
+ * @param hostname Full hostname (e.g., 'acme.example.com')
+ * @param baseDomain Base domain (e.g., 'example.com')
+ * @returns Subdomain or null if not found
+ */
+declare function extractSubdomain(hostname: string, baseDomain: string): string | null;
+/**
+ * Builds full URL with subdomain
+ * @param subdomain Subdomain
+ * @param baseDomain Base domain
+ * @param path Optional path
+ * @param protocol Protocol (default: https)
+ * @returns Full URL
+ */
+declare function buildSubdomainUrl(subdomain: string, baseDomain: string, path?: string, protocol?: string): string;
+
+interface BanditsClientConfig {
+    apiUrl: string;
+    apiKey: string;
+    timeout?: number;
+    batchSize?: number;
+    flushInterval?: number;
+    sessionTtl?: number;
+}
+interface Assignment {
+    assignmentId: string;
+    treatmentId: string;
+    experimentId: string;
+    userId: string;
+    config: any;
+}
+declare class BanditsClient {
+    private config;
+    private namedEventQueue;
+    private sessionId;
+    private flushTimer?;
+    constructor(config: BanditsClientConfig);
+    getAssignment(experimentId: string, userId: string, context?: ContextualFeatures): Promise<Assignment>;
+    /**
+     * 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: {
+        name: string;
+        category?: string;
+        value?: number;
+        metadata?: Record<string, any>;
+    }, opts?: {
+        immediate?: boolean;
+    }): void;
+    flush(): Promise<void>;
+    /**
+     * 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
+     */
+    identify(anonymousId: string, identifiedUserId: string, companyId: string, mergeReason?: 'user_signup' | 'email_verification' | 'social_login' | 'account_recovery' | 'manual'): Promise<void>;
+    /**
+     * 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)
+     */
+    trackFunnelReward(funnelId: string, userId: string, value: number): Promise<void>;
+    private generateId;
+    private getOrCreateSessionId;
+    private makeRequest;
+    private startBatchFlush;
+    destroy(): void;
+}
+
+export { type APIResponse, type Account, type AlgorithmResult, type ApiKey, type Assignment, type AssignmentRequest, BanditAlgorithm, BanditsClient as BanditClient, type BanditConfig, type BanditResult, BanditsClient, type BanditsClientConfig, type Company, ContentType, type ContextualFeatures, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateExperimentRequest, type Experiment, type ExperimentStats, ExperimentStatus, type Funnel, type FunnelRewardRequest, FunnelStatus, type IdentifyMergeReason, type IdentifyUserRequest, type IdentifyUserResponse, type ResolvedIdentity, type Session, type TrackNamedEventRequest, type Treatment, type TreatmentMetadata, type TreatmentStats, type User, type VariantConfig, buildSubdomainUrl, calculateConfidenceInterval, extractSubdomain, generateId, generateSubdomain, getContentTypeCategory, isValidEmail, isValidSubdomain, normalizeTreatmentWeights, sanitizeMetadata, validateTreatmentWeights };

package/dist/index.js

@@ -0,0 +1,390 @@
+// src/client.ts
+var BanditsClient = class {
+  config;
+  namedEventQueue = [];
+  sessionId;
+  flushTimer;
+  constructor(config) {
+    this.config = {
+      timeout: 5e3,
+      batchSize: 100,
+      flushInterval: 1e4,
+      sessionTtl: 864e5,
+      // 24 hours in ms
+      ...config
+    };
+    this.sessionId = this.getOrCreateSessionId();
+    this.startBatchFlush();
+  }
+  async getAssignment(experimentId, userId, context) {
+    const request = {
+      experimentId,
+      userId,
+      context,
+      sessionId: this.sessionId
+    };
+    const response = await this.makeRequest(
+      "/assignments",
+      "POST",
+      request
+    );
+    if (!response.success || !response.data) {
+      throw new Error(response.error || "Failed to get assignment");
+    }
+    const assignment = response.data?.data ?? response.data;
+    if (!assignment?.assignmentId) {
+      throw new Error("Invalid assignment response");
+    }
+    return {
+      assignmentId: assignment.assignmentId,
+      treatmentId: assignment.treatmentId,
+      experimentId,
+      userId,
+      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,
+      category: event.category || "custom",
+      value: event.value,
+      metadata: event.metadata,
+      sessionId: this.sessionId
+    };
+    if (opts?.immediate) {
+      const url = `${this.config.apiUrl}/events`;
+      try {
+        void fetch(url, {
+          method: "POST",
+          headers: {
+            "Authorization": `Bearer ${this.config.apiKey}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(request),
+          keepalive: true
+        });
+      } catch {
+      }
+      return;
+    }
+    this.namedEventQueue.push(request);
+    if (this.namedEventQueue.length >= this.config.batchSize) {
+      this.flush();
+    }
+  }
+  async flush() {
+    const namedEvents = [...this.namedEventQueue];
+    this.namedEventQueue = [];
+    if (namedEvents.length === 0) return;
+    try {
+      await fetch(`${this.config.apiUrl}/events/batch`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${this.config.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ events: namedEvents }),
+        keepalive: true
+      });
+    } catch (error) {
+      this.namedEventQueue.unshift(...namedEvents);
+      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",
+      "POST",
+      {
+        anonymousId,
+        identifiedUserId,
+        mergeReason: mergeReason || "manual"
+      },
+      { "x-company-id": companyId }
+    );
+    if (!response.success) {
+      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 trackFunnelReward(funnelId, userId, value) {
+    const response = await this.makeRequest(
+      `/funnels/${funnelId}/reward`,
+      "POST",
+      { userId, value }
+    );
+    if (!response.success) {
+      throw new Error(response.error || "Failed to record funnel reward");
+    }
+  }
+  generateId() {
+    if (typeof crypto !== "undefined" && crypto.randomUUID) {
+      return crypto.randomUUID();
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = Math.random() * 16 | 0;
+      return (c === "x" ? r : r & 3 | 8).toString(16);
+    });
+  }
+  getOrCreateSessionId() {
+    if (typeof window !== "undefined" && window.localStorage) {
+      const stored = localStorage.getItem("bandits_session_id");
+      const storedAt = localStorage.getItem("bandits_session_created_at");
+      if (stored && storedAt) {
+        const age = Date.now() - parseInt(storedAt, 10);
+        if (age < this.config.sessionTtl) {
+          return stored;
+        }
+      }
+      const id = this.generateId();
+      localStorage.setItem("bandits_session_id", id);
+      localStorage.setItem("bandits_session_created_at", String(Date.now()));
+      return id;
+    }
+    return this.generateId();
+  }
+  async makeRequest(endpoint, method, body, extraHeaders) {
+    const url = `${this.config.apiUrl}${endpoint}`;
+    const headers = {
+      "Authorization": `Bearer ${this.config.apiKey}`,
+      "Content-Type": "application/json",
+      ...extraHeaders
+    };
+    const requestConfig = {
+      method,
+      headers,
+      signal: AbortSignal.timeout(this.config.timeout)
+    };
+    if (body && method !== "GET") {
+      requestConfig.body = JSON.stringify(body);
+    }
+    try {
+      const response = await fetch(url, requestConfig);
+      const data = await response.json();
+      return {
+        success: response.ok,
+        data: response.ok ? data : void 0,
+        error: response.ok ? void 0 : data?.message || "Request failed",
+        timestamp: /* @__PURE__ */ new Date()
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Network error",
+        timestamp: /* @__PURE__ */ new Date()
+      };
+    }
+  }
+  startBatchFlush() {
+    this.flushTimer = setInterval(() => {
+      this.flush().catch(console.error);
+    }, this.config.flushInterval);
+  }
+  destroy() {
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+    }
+    this.flush().catch(console.error);
+    if (typeof window !== "undefined" && window.localStorage) {
+      localStorage.removeItem("bandits_session_id");
+      localStorage.removeItem("bandits_session_created_at");
+    }
+  }
+};
+
+// ../shared/dist/types.js
+var ExperimentStatus;
+(function(ExperimentStatus2) {
+  ExperimentStatus2["DRAFT"] = "draft";
+  ExperimentStatus2["ACTIVE"] = "active";
+  ExperimentStatus2["PAUSED"] = "paused";
+  ExperimentStatus2["COMPLETED"] = "completed";
+  ExperimentStatus2["ARCHIVED"] = "archived";
+})(ExperimentStatus || (ExperimentStatus = {}));
+var BanditAlgorithm;
+(function(BanditAlgorithm2) {
+  BanditAlgorithm2["EPSILON_GREEDY"] = "epsilon_greedy";
+  BanditAlgorithm2["UCB1"] = "ucb1";
+  BanditAlgorithm2["THOMPSON_SAMPLING"] = "thompson_sampling";
+  BanditAlgorithm2["CONTEXTUAL_LINEAR"] = "contextual_linear";
+  BanditAlgorithm2["CONTEXTUAL_NEURAL"] = "contextual_neural";
+})(BanditAlgorithm || (BanditAlgorithm = {}));
+var ContentType;
+(function(ContentType2) {
+  ContentType2["PLAIN_TEXT"] = "plain_text";
+  ContentType2["MARKDOWN"] = "markdown";
+  ContentType2["HTML"] = "html";
+  ContentType2["CSS"] = "css";
+  ContentType2["JAVASCRIPT"] = "javascript";
+  ContentType2["JSON"] = "json";
+  ContentType2["IMAGE"] = "image";
+  ContentType2["VIDEO"] = "video";
+  ContentType2["AUDIO"] = "audio";
+  ContentType2["DOCUMENT"] = "document";
+})(ContentType || (ContentType = {}));
+function getContentTypeCategory(contentType) {
+  switch (contentType) {
+    case ContentType.PLAIN_TEXT:
+    case ContentType.MARKDOWN:
+      return "text";
+    case ContentType.HTML:
+    case ContentType.CSS:
+    case ContentType.JAVASCRIPT:
+    case ContentType.JSON:
+      return "code";
+    case ContentType.IMAGE:
+    case ContentType.VIDEO:
+    case ContentType.AUDIO:
+    case ContentType.DOCUMENT:
+      return "file";
+  }
+}
+var FunnelStatus;
+(function(FunnelStatus2) {
+  FunnelStatus2["DRAFT"] = "draft";
+  FunnelStatus2["ACTIVE"] = "active";
+  FunnelStatus2["PAUSED"] = "paused";
+  FunnelStatus2["COMPLETED"] = "completed";
+})(FunnelStatus || (FunnelStatus = {}));
+
+// ../shared/dist/utils.js
+function generateId() {
+  return Math.random().toString(36).substring(2) + Date.now().toString(36);
+}
+function validateTreatmentWeights(treatments) {
+  const totalWeight = treatments.reduce((sum, treatment) => sum + (treatment.weight || 1), 0);
+  return totalWeight > 0;
+}
+function normalizeTreatmentWeights(treatments) {
+  const totalWeight = treatments.reduce((sum, treatment) => sum + (treatment.weight || 1), 0);
+  return treatments.map((treatment) => ({
+    ...treatment,
+    weight: (treatment.weight || 1) / totalWeight
+  }));
+}
+function calculateConfidenceInterval(successes, trials, confidence = 0.95) {
+  if (trials === 0)
+    return { lower: 0, upper: 0 };
+  const z = confidence === 0.95 ? 1.96 : confidence === 0.99 ? 2.576 : 1.645;
+  const p = successes / trials;
+  const margin = z * Math.sqrt(p * (1 - p) / trials);
+  return {
+    lower: Math.max(0, p - margin),
+    upper: Math.min(1, p + margin)
+  };
+}
+function isValidEmail(email) {
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  return emailRegex.test(email);
+}
+function sanitizeMetadata(metadata) {
+  const sanitized = {};
+  for (const [key, value] of Object.entries(metadata)) {
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      sanitized[key] = value;
+    } else if (value !== null && value !== void 0) {
+      sanitized[key] = String(value);
+    }
+  }
+  return sanitized;
+}
+function generateSubdomain(name) {
+  return name.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").substring(0, 63);
+}
+function isValidSubdomain(subdomain) {
+  if (!subdomain || subdomain.length === 0 || subdomain.length > 63) {
+    return false;
+  }
+  const subdomainRegex = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+  const reserved = [
+    "www",
+    "api",
+    "app",
+    "admin",
+    "dashboard",
+    "mail",
+    "ftp",
+    "localhost",
+    "staging",
+    "dev",
+    "test",
+    "demo",
+    "blog",
+    "docs",
+    "status",
+    "help",
+    "support",
+    "cdn",
+    "static",
+    "assets",
+    "secure",
+    "payment",
+    "pay"
+  ];
+  return subdomainRegex.test(subdomain) && !reserved.includes(subdomain);
+}
+function extractSubdomain(hostname, baseDomain) {
+  if (!hostname || !baseDomain) {
+    return null;
+  }
+  const cleanHostname = hostname.split(":")[0];
+  if (!cleanHostname.endsWith(baseDomain)) {
+    return null;
+  }
+  const subdomain = cleanHostname.slice(0, -(baseDomain.length + 1));
+  if (!subdomain || subdomain === "www") {
+    return null;
+  }
+  return subdomain;
+}
+function buildSubdomainUrl(subdomain, baseDomain, path = "", protocol = "https") {
+  const url = `${protocol}://${subdomain}.${baseDomain}`;
+  return path ? `${url}${path.startsWith("/") ? path : "/" + path}` : url;
+}
+export {
+  BanditAlgorithm,
+  BanditsClient as BanditClient,
+  BanditsClient,
+  ContentType,
+  ExperimentStatus,
+  FunnelStatus,
+  buildSubdomainUrl,
+  calculateConfidenceInterval,
+  extractSubdomain,
+  generateId,
+  generateSubdomain,
+  getContentTypeCategory,
+  isValidEmail,
+  isValidSubdomain,
+  normalizeTreatmentWeights,
+  sanitizeMetadata,
+  validateTreatmentWeights
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../../shared/src/types.ts","../../shared/src/utils.ts"],"sourcesContent":["import {\n  AssignmentRequest,\n  TrackNamedEventRequest,\n  BanditResult,\n  APIResponse,\n  ContextualFeatures\n} from '@runbandit/shared';\n\nexport interface BanditsClientConfig {\n  apiUrl: string;\n  apiKey: string;\n  timeout?: number;\n  batchSize?: number;\n  flushInterval?: number;\n  sessionTtl?: number; // default 24 hours in ms\n}\n\nexport interface Assignment {\n  assignmentId: string;\n  treatmentId: string;\n  experimentId: string;\n  userId: string;\n  config: any;\n}\n\nexport class BanditsClient {\n  private config: BanditsClientConfig;\n  private namedEventQueue: TrackNamedEventRequest[] = [];\n  private sessionId: string;\n  private flushTimer?: NodeJS.Timeout;\n\n  constructor(config: BanditsClientConfig) {\n    this.config = {\n      timeout: 5000,\n      batchSize: 100,\n      flushInterval: 10000,\n      sessionTtl: 86400000, // 24 hours in ms\n      ...config\n    };\n    this.sessionId = this.getOrCreateSessionId();\n    this.startBatchFlush();\n  }\n\n  async getAssignment(\n    experimentId: string,\n    userId: string,\n    context?: ContextualFeatures\n  ): Promise<Assignment> {\n    const request: AssignmentRequest = {\n      experimentId,\n      userId,\n      context,\n      sessionId: this.sessionId\n    };\n\n    const response = await this.makeRequest<any>(\n      '/assignments',\n      'POST',\n      request\n    );\n\n    if (!response.success || !response.data) {\n      throw new Error(response.error || 'Failed to get assignment');\n    }\n\n    // API returns { success, data: { assignmentId, treatmentId, treatment, confidence } }\n    // makeRequest puts the raw JSON body in response.data, so unwrap one level.\n    const assignment = response.data?.data ?? response.data;\n\n    if (!assignment?.assignmentId) {\n      throw new Error('Invalid assignment response');\n    }\n\n    return {\n      assignmentId: assignment.assignmentId,\n      treatmentId: assignment.treatmentId,\n      experimentId,\n      userId,\n      config: assignment.treatment?.config || {}\n    };\n  }\n\n  /**\n   * Track a named event for session-based attribution (recommended)\n   * Events are matched to bandits by sessionId — no assignmentId needed\n   * Set immediate: true to fire synchronously (survives navigation)\n   */\n  trackNamedEvent(\n    event: { name: string; category?: string; value?: number; metadata?: Record<string, any> },\n    opts?: { immediate?: boolean }\n  ): void {\n    const request: TrackNamedEventRequest = {\n      name: event.name,\n      category: event.category || 'custom',\n      value: event.value,\n      metadata: event.metadata,\n      sessionId: this.sessionId,\n    };\n\n    if (opts?.immediate) {\n      // Fire now and survive navigation (e.g. CTA click -> route change)\n      const url = `${this.config.apiUrl}/events`;\n      try {\n        void fetch(url, {\n          method: 'POST',\n          headers: {\n            'Authorization': `Bearer ${this.config.apiKey}`,\n            'Content-Type': 'application/json',\n          },\n          body: JSON.stringify(request),\n          keepalive: true,\n        });\n      } catch {\n        // best-effort\n      }\n      return;\n    }\n\n    this.namedEventQueue.push(request);\n    if (this.namedEventQueue.length >= this.config.batchSize!) {\n      this.flush();\n    }\n  }\n\n  async flush(): Promise<void> {\n    const namedEvents = [...this.namedEventQueue];\n    this.namedEventQueue = [];\n    if (namedEvents.length === 0) return;\n\n    try {\n      await fetch(`${this.config.apiUrl}/events/batch`, {\n        method: 'POST',\n        headers: {\n          'Authorization': `Bearer ${this.config.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify({ events: namedEvents }),\n        keepalive: true,\n      });\n    } catch (error) {\n      this.namedEventQueue.unshift(...namedEvents);\n      throw error;\n    }\n  }\n\n  /**\n   * Link an anonymous user ID to a durable identity (e.g. email, account ID).\n   * All historical assignments and events for the anonymous ID are re-attributed\n   * to the identified user. Future calls to getAssignment() with either ID will\n   * resolve to the same assignment.\n   *\n   * Requires admin authentication — the client must be configured with a\n   * personal access token (PAT) instead of an API key, and companyId must\n   * be provided. This is a management operation, not an SDK client operation.\n   *\n   * @param anonymousId - The temporary/anonymous user ID (e.g. crypto.randomUUID())\n   * @param identifiedUserId - The permanent user ID (e.g. email, database ID)\n   * @param companyId - The company ID (required for PAT auth)\n   * @param mergeReason - Why the identification is happening\n   */\n  async identify(\n    anonymousId: string,\n    identifiedUserId: string,\n    companyId: string,\n    mergeReason?: 'user_signup' | 'email_verification' | 'social_login' | 'account_recovery' | 'manual'\n  ): Promise<void> {\n    const response = await this.makeRequest(\n      '/identify',\n      'POST',\n      {\n        anonymousId,\n        identifiedUserId,\n        mergeReason: mergeReason || 'manual',\n      },\n      { 'x-company-id': companyId }\n    );\n\n    if (!response.success) {\n      throw new Error(response.error || 'Failed to identify user');\n    }\n  }\n\n  /**\n   * Record a funnel payout event.\n   * Call this when the terminal conversion happens (e.g., purchase).\n   *\n   * @param funnelId - The funnel ID\n   * @param userId - The user who converted\n   * @param value - The payout value (e.g., purchase amount in dollars)\n   */\n  async trackFunnelReward(\n    funnelId: string,\n    userId: string,\n    value: number\n  ): Promise<void> {\n    const response = await this.makeRequest(\n      `/funnels/${funnelId}/reward`,\n      'POST',\n      { userId, value }\n    );\n\n    if (!response.success) {\n      throw new Error(response.error || 'Failed to record funnel reward');\n    }\n  }\n\n  private generateId(): string {\n    if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n      return crypto.randomUUID();\n    }\n    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n      const r = (Math.random() * 16) | 0;\n      return (c === 'x' ? r : (r & 0x3) | 0x8).toString(16);\n    });\n  }\n\n  private getOrCreateSessionId(): string {\n    if (typeof window !== 'undefined' && window.localStorage) {\n      const stored = localStorage.getItem('bandits_session_id');\n      const storedAt = localStorage.getItem('bandits_session_created_at');\n      if (stored && storedAt) {\n        const age = Date.now() - parseInt(storedAt, 10);\n        if (age < this.config.sessionTtl!) {\n          return stored;\n        }\n      }\n      const id = this.generateId();\n      localStorage.setItem('bandits_session_id', id);\n      localStorage.setItem('bandits_session_created_at', String(Date.now()));\n      return id;\n    }\n    return this.generateId();\n  }\n\n  private async makeRequest<T = any>(\n    endpoint: string,\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE',\n    body?: any,\n    extraHeaders?: Record<string, string>\n  ): Promise<APIResponse<T>> {\n    const url = `${this.config.apiUrl}${endpoint}`;\n\n    const headers: Record<string, string> = {\n      'Authorization': `Bearer ${this.config.apiKey}`,\n      'Content-Type': 'application/json',\n      ...extraHeaders,\n    };\n\n    const requestConfig: RequestInit = {\n      method,\n      headers,\n      signal: AbortSignal.timeout(this.config.timeout!)\n    };\n\n    if (body && method !== 'GET') {\n      requestConfig.body = JSON.stringify(body);\n    }\n\n    try {\n      const response = await fetch(url, requestConfig);\n      const data = await response.json();\n      \n      return {\n        success: response.ok,\n        data: response.ok ? data as T : undefined,\n        error: response.ok ? undefined : (data as any)?.message || 'Request failed',\n        timestamp: new Date()\n      };\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : 'Network error',\n        timestamp: new Date()\n      };\n    }\n  }\n\n  private startBatchFlush(): void {\n    this.flushTimer = setInterval(() => {\n      this.flush().catch(console.error);\n    }, this.config.flushInterval);\n  }\n\n  destroy(): void {\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer);\n    }\n    this.flush().catch(console.error);\n    if (typeof window !== 'undefined' && window.localStorage) {\n      localStorage.removeItem('bandits_session_id');\n      localStorage.removeItem('bandits_session_created_at');\n    }\n  }\n}","export interface Company {\n  id: string;\n  name: string;\n  subdomain?: string;  // nullable for backwards compatibility with existing data\n  domain?: string;\n  plan: string;\n  apiKey: string;\n  status: string;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport interface User {\n  id: string;\n  email: string;\n  name: string;\n  image?: string;\n  role: string;\n  companyId: string | null;\n  emailVerified?: boolean;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport interface Session {\n  id: string;\n  userId: string;\n  token: string;\n  expiresAt: Date;\n  ipAddress?: string | null;\n  userAgent?: string | null;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport interface Account {\n  id: string;\n  userId: string;\n  provider: string;\n  providerAccountId: string;\n  accessToken?: string;\n  refreshToken?: string;\n  accessTokenExpiresAt?: Date;\n  refreshTokenExpiresAt?: Date;\n  scope?: string;\n  idToken?: string;\n  sessionState?: string;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport interface Experiment {\n  id: string;\n  name: string;\n  description?: string;\n  algorithm: BanditAlgorithm;\n  status: ExperimentStatus;\n  contentType: ContentType;\n  treatments: Treatment[];\n  context?: Record<string, any>;\n  image?: string; // URL for uploaded image\n  emoji?: string; // Emoji character as alternative to image\n  assignmentTtl: number; // TTL in seconds for assignment expiration\n  companyId: string;\n  createdAt: Date;\n  updatedAt: Date;\n  endAt?: Date;\n}\n\nexport interface Treatment {\n  id: string;\n  experimentId: string;\n  name: string;\n  description?: string;\n  config: VariantConfig;\n  weight?: number;\n  companyId: string;\n  createdAt: Date;\n}\n\nexport interface AlgorithmResult {\n  treatmentId: string;\n  confidence: number;\n}\n\nexport interface BanditResult {\n  assignmentId: string;\n  treatmentId: string;\n  confidence: number;\n  metadata?: Record<string, any>;\n}\n\nexport interface ContextualFeatures {\n  [key: string]: string | number | boolean;\n}\n\nexport enum ExperimentStatus {\n  DRAFT = 'draft',\n  ACTIVE = 'active',\n  PAUSED = 'paused',\n  COMPLETED = 'completed',\n  ARCHIVED = 'archived'\n}\n\n\nexport interface TreatmentMetadata {\n  strategy?: string;       // e.g. \"social proof\", \"urgency\"\n  tone?: string;           // e.g. \"warm\", \"snarky\", \"deadpan corporate\"\n  ctaStyle?: string;       // e.g. \"direct\", \"soft question\", \"implied next step\"\n  emotionalHook?: string;  // e.g. \"fomo\", \"belonging\", \"righteous indignation\"\n  reasoning?: string;      // LLM's explanation of why it chose this approach\n  tags?: string[];\n  generated?: boolean;\n  generatedAt?: string;\n}\n\nexport interface VariantConfig {\n  content: string;\n  metadata?: TreatmentMetadata & Record<string, any>;\n}\n\nexport enum BanditAlgorithm {\n  EPSILON_GREEDY = 'epsilon_greedy',\n  UCB1 = 'ucb1',\n  THOMPSON_SAMPLING = 'thompson_sampling',\n  CONTEXTUAL_LINEAR = 'contextual_linear',\n  CONTEXTUAL_NEURAL = 'contextual_neural'\n}\n\nexport enum ContentType {\n  PLAIN_TEXT = 'plain_text',\n  MARKDOWN = 'markdown',\n  HTML = 'html',\n  CSS = 'css',\n  JAVASCRIPT = 'javascript',\n  JSON = 'json',\n  IMAGE = 'image',\n  VIDEO = 'video',\n  AUDIO = 'audio',\n  DOCUMENT = 'document',\n}\n\nexport function getContentTypeCategory(contentType: ContentType): 'text' | 'code' | 'file' {\n  switch (contentType) {\n    case ContentType.PLAIN_TEXT:\n    case ContentType.MARKDOWN:\n      return 'text';\n    case ContentType.HTML:\n    case ContentType.CSS:\n    case ContentType.JAVASCRIPT:\n    case ContentType.JSON:\n      return 'code';\n    case ContentType.IMAGE:\n    case ContentType.VIDEO:\n    case ContentType.AUDIO:\n    case ContentType.DOCUMENT:\n      return 'file';\n  }\n}\n\nexport interface BanditConfig {\n  algorithm: BanditAlgorithm;\n  parameters: Record<string, any>;\n}\n\nexport interface ExperimentStats {\n  totalAssignments: number;\n  totalConversions: number;\n  conversionRate: number;\n  treatmentStats: Record<string, TreatmentStats>;\n}\n\nexport interface TreatmentStats {\n  assignments: number;\n  conversions: number;\n  conversionRate: number;\n  confidence: number;\n  lift?: number;\n}\n\nexport interface APIResponse<T = any> {\n  success: boolean;\n  data?: T;\n  error?: string;\n  timestamp: Date;\n}\n\nexport interface CreateExperimentRequest {\n  name: string;\n  description?: string;\n  algorithm: BanditAlgorithm;\n  contentType: ContentType;\n  algorithmConfig?: Record<string, any>;\n  treatments?: Omit<Treatment, 'id' | 'experimentId' | 'createdAt'>[];\n}\n\nexport interface AssignmentRequest {\n  experimentId: string;\n  userId: string;\n  context?: ContextualFeatures;\n  sessionId?: string;\n}\n\n\nexport interface TrackNamedEventRequest {\n  name: string;\n  category?: string;\n  value?: number;\n  metadata?: Record<string, any>;\n  sessionId: string;\n}\n\n// --- Funnel RL Types ---\n\nexport enum FunnelStatus {\n  DRAFT = 'draft',\n  ACTIVE = 'active',\n  PAUSED = 'paused',\n  COMPLETED = 'completed',\n}\n\nexport interface Funnel {\n  id: string;\n  name: string;\n  description?: string;\n  status: FunnelStatus;\n  conversionWindowMs: number;\n  companyId: string;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport interface FunnelRewardRequest {\n  funnelId: string;\n  userId: string;\n  value: number;\n}\n\n// --- API Key Management Types ---\n\nexport interface ApiKey {\n  id: string;\n  name: string;\n  keyPrefix: string;\n  status: 'active' | 'revoked';\n  createdBy: string;\n  createdAt: Date;\n  lastUsedAt?: Date;\n  revokedAt?: Date;\n  revokedBy?: string;\n}\n\nexport interface CreateApiKeyRequest {\n  name: string;\n}\n\nexport interface CreateApiKeyResponse {\n  id: string;\n  key: string;\n  name: string;\n}\n\n// --- Identity Resolution Types ---\n\nexport type IdentifyMergeReason =\n  | 'user_signup'\n  | 'email_verification'\n  | 'social_login'\n  | 'account_recovery'\n  | 'manual';\n\nexport interface IdentifyUserRequest {\n  anonymousId: string;\n  identifiedUserId: string;\n  mergeReason?: IdentifyMergeReason;\n}\n\nexport interface IdentifyUserResponse {\n  anonymousId: string;\n  identifiedUserId: string;\n  alreadyMapped: boolean;\n}\n\nexport interface ResolvedIdentity {\n  canonicalId: string;\n  anonymousIds: string[];\n  isIdentified: boolean;\n}\n","import { Treatment } from './types.js';\n\nexport function generateId(): string {\n  return Math.random().toString(36).substring(2) + Date.now().toString(36);\n}\n\nexport function validateTreatmentWeights(treatments: Treatment[]): boolean {\n  const totalWeight = treatments.reduce((sum, treatment) => sum + (treatment.weight || 1), 0);\n  return totalWeight > 0;\n}\n\nexport function normalizeTreatmentWeights(treatments: Treatment[]): Treatment[] {\n  const totalWeight = treatments.reduce((sum, treatment) => sum + (treatment.weight || 1), 0);\n  \n  return treatments.map(treatment => ({\n    ...treatment,\n    weight: (treatment.weight || 1) / totalWeight\n  }));\n}\n\nexport function calculateConfidenceInterval(\n  successes: number,\n  trials: number,\n  confidence: number = 0.95\n): { lower: number; upper: number } {\n  if (trials === 0) return { lower: 0, upper: 0 };\n  \n  const z = confidence === 0.95 ? 1.96 : confidence === 0.99 ? 2.576 : 1.645;\n  const p = successes / trials;\n  const margin = z * Math.sqrt((p * (1 - p)) / trials);\n  \n  return {\n    lower: Math.max(0, p - margin),\n    upper: Math.min(1, p + margin)\n  };\n}\n\nexport function isValidEmail(email: string): boolean {\n  const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n  return emailRegex.test(email);\n}\n\nexport function sanitizeMetadata(metadata: Record<string, any>): Record<string, any> {\n  const sanitized: Record<string, any> = {};\n\n  for (const [key, value] of Object.entries(metadata)) {\n    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n      sanitized[key] = value;\n    } else if (value !== null && value !== undefined) {\n      sanitized[key] = String(value);\n    }\n  }\n\n  return sanitized;\n}\n\n/**\n * Generates a URL-safe subdomain from a company name\n * @param name Company name\n * @returns URL-safe subdomain\n */\nexport function generateSubdomain(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[^a-z0-9\\s-]/g, '') // Remove special characters\n    .replace(/\\s+/g, '-') // Replace spaces with hyphens\n    .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen\n    .replace(/^-|-$/g, '') // Remove leading/trailing hyphens\n    .substring(0, 63); // DNS label max length\n}\n\n/**\n * Validates if a subdomain is properly formatted\n * @param subdomain Subdomain to validate\n * @returns true if valid, false otherwise\n */\nexport function isValidSubdomain(subdomain: string): boolean {\n  if (!subdomain || subdomain.length === 0 || subdomain.length > 63) {\n    return false;\n  }\n\n  // Subdomain rules: lowercase letters, numbers, hyphens\n  // Cannot start or end with hyphen\n  // Cannot contain consecutive hyphens\n  const subdomainRegex = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;\n\n  // Reserved subdomains\n  const reserved = [\n    'www', 'api', 'app', 'admin', 'dashboard', 'mail', 'ftp', 'localhost',\n    'staging', 'dev', 'test', 'demo', 'blog', 'docs', 'status', 'help',\n    'support', 'cdn', 'static', 'assets', 'secure', 'payment', 'pay'\n  ];\n\n  return subdomainRegex.test(subdomain) && !reserved.includes(subdomain);\n}\n\n/**\n * Extracts subdomain from hostname\n * @param hostname Full hostname (e.g., 'acme.example.com')\n * @param baseDomain Base domain (e.g., 'example.com')\n * @returns Subdomain or null if not found\n */\nexport function extractSubdomain(hostname: string, baseDomain: string): string | null {\n  if (!hostname || !baseDomain) {\n    return null;\n  }\n\n  // Remove port if present\n  const cleanHostname = hostname.split(':')[0];\n\n  // Check if hostname ends with base domain\n  if (!cleanHostname.endsWith(baseDomain)) {\n    return null;\n  }\n\n  // Extract subdomain part\n  const subdomain = cleanHostname.slice(0, -(baseDomain.length + 1));\n\n  // Return null if no subdomain or if it's www\n  if (!subdomain || subdomain === 'www') {\n    return null;\n  }\n\n  return subdomain;\n}\n\n/**\n * Builds full URL with subdomain\n * @param subdomain Subdomain\n * @param baseDomain Base domain\n * @param path Optional path\n * @param protocol Protocol (default: https)\n * @returns Full URL\n */\nexport function buildSubdomainUrl(\n  subdomain: string,\n  baseDomain: string,\n  path: string = '',\n  protocol: string = 'https'\n): string {\n  const url = `${protocol}://${subdomain}.${baseDomain}`;\n  return path ? `${url}${path.startsWith('/') ? path : '/' + path}` : url;\n}"],"mappings":"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","names":["ExperimentStatus","BanditAlgorithm","ContentType","FunnelStatus"]}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@runbandit/sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@runbandit/shared": "workspace:*",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}