@stacksee/analytics 0.9.8 → 0.11.0

package/dist/index-CBs091W0.js

@@ -0,0 +1,157 @@
+var u = Object.defineProperty;
+var l = (e, t, r) => t in e ? u(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var c = (e, t, r) => l(e, typeof t != "symbol" ? t + "" : t, r);
+var i = class extends Error {
+  constructor(e, t, r, a) {
+    super(e), this.statusCode = t, this.requestId = r, this.details = a, this.name = "EmitKitError";
+  }
+}, y = class extends i {
+  constructor(e, t) {
+    super(
+      `Rate limit exceeded. Resets in ${Math.ceil(e.resetIn / 1e3)}s`,
+      429,
+      t
+    ), this.rateLimit = e, this.name = "RateLimitError";
+  }
+}, w = class extends i {
+  constructor(e, t, r) {
+    super(e, 400, r, t), this.validationErrors = t, this.name = "ValidationError";
+  }
+}, I = class {
+  constructor(e, t) {
+    c(this, "config");
+    c(this, "lastRateLimit");
+    this.config = {
+      apiKey: e,
+      baseUrl: (t == null ? void 0 : t.baseUrl) || "https://api.emitkit.com",
+      timeout: (t == null ? void 0 : t.timeout) || 3e4,
+      fetch: (t == null ? void 0 : t.fetch) || globalThis.fetch
+    };
+  }
+  /**
+   * Get the last known rate limit information
+   */
+  get rateLimit() {
+    return this.lastRateLimit;
+  }
+  /**
+   * Events API
+   */
+  get events() {
+    return {
+      /**
+       * Create a new event
+       *
+       * @example
+       * ```ts
+       * const result = await client.events.create({
+       *   channelName: 'payments',
+       *   title: 'Payment Received',
+       *   metadata: { amount: 99.99 }
+       * });
+       * ```
+       */
+      create: async (e, t) => this.request("/v1/events", {
+        method: "POST",
+        body: JSON.stringify(e),
+        headers: {
+          "Content-Type": "application/json",
+          ...(t == null ? void 0 : t.idempotencyKey) && {
+            "Idempotency-Key": t.idempotencyKey
+          },
+          ...t == null ? void 0 : t.headers
+        }
+      })
+    };
+  }
+  /**
+   * Identify a user with properties and aliases
+   *
+   * @example
+   * ```ts
+   * const result = await client.identify({
+   *   user_id: 'user_123',
+   *   properties: {
+   *     email: 'user@example.com',
+   *     name: 'John Doe',
+   *     plan: 'pro'
+   *   },
+   *   aliases: ['user@example.com', 'johndoe']
+   * });
+   * ```
+   */
+  async identify(e, t) {
+    return this.request("/v1/identify", {
+      method: "POST",
+      body: JSON.stringify(e),
+      headers: {
+        "Content-Type": "application/json",
+        ...t == null ? void 0 : t.headers
+      }
+    });
+  }
+  /**
+   * Make a raw API request
+   */
+  async request(e, t) {
+    const r = `${this.config.baseUrl}${e}`, a = new AbortController(), n = setTimeout(() => a.abort(), this.config.timeout);
+    try {
+      const s = await this.config.fetch(r, {
+        ...t,
+        headers: {
+          Authorization: `Bearer ${this.config.apiKey}`,
+          ...t.headers
+        },
+        signal: a.signal
+      });
+      clearTimeout(n);
+      const o = this.extractRateLimit(s);
+      o && (this.lastRateLimit = o);
+      const d = s.headers.get("X-Idempotent-Replay") === "true";
+      s.ok || await this.handleErrorResponse(s, o);
+      const h = await s.json(), m = h.requestId || s.headers.get("X-Request-ID");
+      return {
+        data: h.success ? h.data : h,
+        rateLimit: o,
+        requestId: m || "unknown",
+        wasReplayed: d
+      };
+    } catch (s) {
+      throw clearTimeout(n), s instanceof i ? s : s instanceof Error ? s.name === "AbortError" ? new i("Request timeout", 408) : new i(
+        `Network error: ${s.message}`,
+        0
+      ) : new i("Unknown error occurred", 500);
+    }
+  }
+  extractRateLimit(e) {
+    const t = e.headers.get("X-RateLimit-Limit"), r = e.headers.get("X-RateLimit-Remaining"), a = e.headers.get("X-RateLimit-Reset");
+    if (!t || !r || !a)
+      return null;
+    const n = parseInt(a, 10) * 1e3, s = Math.max(0, n - Date.now());
+    return {
+      limit: parseInt(t, 10),
+      remaining: parseInt(r, 10),
+      reset: parseInt(a, 10),
+      resetIn: s
+    };
+  }
+  async handleErrorResponse(e, t) {
+    const r = await e.json().catch(() => ({})), a = r.requestId || e.headers.get("X-Request-ID") || void 0;
+    throw e.status === 429 && t ? new y(t, a) : e.status === 400 && r.details ? new w(
+      r.error || "Validation error",
+      r.details,
+      a
+    ) : new i(
+      r.error || r.message || `HTTP ${e.status}`,
+      e.status,
+      a || void 0,
+      r
+    );
+  }
+};
+export {
+  I as EmitKit,
+  i as EmitKitError,
+  y as RateLimitError,
+  w as ValidationError
+};

package/dist/providers/client.js

@@ -58,7 +58,7 @@ class w extends u {
     const s = (i == null ? void 0 : i.email) || e;
     if (this.bento.identify(s), i) {
       const t = { ...i };
-      delete t.email, Object.keys(t).length > 0 && this.bento.updateFields(t);
+      t.email = void 0, Object.keys(t).length > 0 && this.bento.updateFields(t);
     }
     this.log("Identified user", { userId: e, email: s, traits: i });
   }
@@ -139,7 +139,9 @@ class w extends u {
     this.bento.track("$pageleave", s), this.log("Tracked page leave", { properties: e, context: i });
   }
   reset() {
-    !this.isEnabled() || !this.initialized || !this.bento || !a() || this.log("Reset user session - Note: Bento doesn't have a native reset method");
+    !this.isEnabled() || !this.initialized || !this.bento || !a() || this.log(
+      "Reset user session - Note: Bento doesn't have a native reset method"
+    );
   }
   // ============================================================================
   // Bento-Specific Utility Methods
@@ -389,7 +391,7 @@ class v extends u {
     r(this, "retryAttempts");
     r(this, "retryBackoff");
     r(this, "retryInitialDelay");
-    this.config = e, this.batchSize = ((i = e.batch) == null ? void 0 : i.size) ?? 10, this.batchInterval = ((s = e.batch) == null ? void 0 : s.interval) ?? 5e3, this.retryAttempts = ((t = e.retry) == null ? void 0 : t.attempts) ?? 3, this.retryBackoff = ((n = e.retry) == null ? void 0 : n.backoff) ?? "exponential", this.retryInitialDelay = ((l = e.retry) == null ? void 0 : l.initialDelay) ?? 1e3, typeof window < "u" && (window.addEventListener("beforeunload", () => {
+    this.config = e, this.batchSize = ((i = e.batch) == null ? void 0 : i.size) ?? 10, this.batchInterval = ((s = e.batch) == null ? void 0 : s.interval) ?? 2e3, this.retryAttempts = ((t = e.retry) == null ? void 0 : t.attempts) ?? 3, this.retryBackoff = ((n = e.retry) == null ? void 0 : n.backoff) ?? "exponential", this.retryInitialDelay = ((l = e.retry) == null ? void 0 : l.initialDelay) ?? 1e3, typeof window < "u" && (window.addEventListener("beforeunload", () => {
       this.flush(!0);
     }), document.addEventListener("visibilitychange", () => {
       document.visibilityState === "hidden" && this.flush(!0);
@@ -442,11 +444,11 @@ class v extends u {
       });
       return;
     }
-    this.flushTimer || (this.flushTimer = setTimeout(() => {
+    this.flushTimer && clearTimeout(this.flushTimer), this.flushTimer = setTimeout(() => {
       this.flush().catch((i) => {
         console.error("[Proxy] Failed to flush events:", i);
       });
-    }, this.batchInterval));
+    }, this.batchInterval);
   }
   async sendEvents(e, i = !1) {
     const s = { events: e };

package/dist/providers/emitkit/server.d.ts

@@ -0,0 +1,62 @@
+import { BaseEvent, EventContext } from '../../core/events/types.js';
+import { BaseAnalyticsProvider } from '../base.provider.js';
+/**
+ * Configuration for EmitKit server provider
+ */
+export interface EmitKitServerConfig {
+    /**
+     * Your EmitKit API key (starts with emitkit_)
+     */
+    apiKey: string;
+    /**
+     * Default channel name for events
+     * @default 'analytics'
+     */
+    channelName?: string;
+    /**
+     * Send notification for events
+     * @default true
+     */
+    notify?: boolean;
+    /**
+     * Display style for events
+     * @default 'notification'
+     */
+    displayAs?: "message" | "notification";
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Enable/disable the provider
+     */
+    enabled?: boolean;
+}
+export declare class EmitKitServerProvider extends BaseAnalyticsProvider {
+    name: string;
+    private client?;
+    private initialized;
+    private config;
+    private currentUserId?;
+    private currentUserEmail?;
+    constructor(config: EmitKitServerConfig);
+    initialize(): Promise<void>;
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    track(event: BaseEvent, context?: EventContext): Promise<void>;
+    pageView(properties?: Record<string, unknown>, context?: EventContext): void;
+    reset(): Promise<void>;
+    shutdown(): Promise<void>;
+    /**
+     * Format event action into a human-readable title
+     * Converts: "user_signed_up" -> "User Signed Up"
+     */
+    private formatEventTitle;
+    /**
+     * Generate a description for the event
+     */
+    private getEventDescription;
+    /**
+     * Get an appropriate icon for the event category
+     */
+    private getEventIcon;
+}

package/dist/providers/server.d.ts

@@ -2,8 +2,10 @@ export { BaseAnalyticsProvider } from './base.provider.js';
 export { PostHogServerProvider } from './posthog/server.js';
 export type { PostHogOptions } from 'posthog-node';
 export { BentoServerProvider } from './bento/server.js';
-export type { BentoServerConfig, BentoAnalyticsOptions } from './bento/server.js';
+export type { BentoServerConfig, BentoAnalyticsOptions, } from './bento/server.js';
 export { PirschServerProvider } from './pirsch/server.js';
 export type { PirschServerConfig } from './pirsch/server.js';
+export { EmitKitServerProvider } from './emitkit/server.js';
+export type { EmitKitServerConfig } from './emitkit/server.js';
 export { ingestProxyEvents, createProxyHandler } from './proxy/server.js';
 export type { IngestProxyEventsConfig } from './proxy/server.js';