krisspy-sdk 0.3.1 → 0.4.1

package/dist/index.d.mts

@@ -6,8 +6,12 @@ interface KrisspyClientOptions {
     url?: string;
     /** Backend ID for this client */
     backendId: string;
-    /** API key or access token */
-    apiKey?: string;
+    /**
+     * Public API key for the backend (required)
+     * This key can be safely exposed in frontend code.
+     * Get it from your backend settings in the Krisspy dashboard.
+     */
+    anonKey: string;
     /** Custom headers to include in all requests */
     headers?: Record<string, string>;
     /** Enable debug logging */
@@ -695,6 +699,89 @@ declare class KrisspyRealtime {
     private log;
 }
 
+/**
+ * Krisspy Analytics - Lightweight event tracking module
+ *
+ * Tracks page views, sessions, custom events. Sends batched events
+ * to the analytics ingest endpoint. Works with SPAs (intercepts pushState).
+ *
+ * @example
+ * const krisspy = createClient({ backendId: '...', anonKey: '...' })
+ * krisspy.analytics.init({ autoTrackPageViews: true })
+ * krisspy.analytics.track('button_click', { label: 'signup' })
+ */
+
+interface AnalyticsInitOptions {
+    /** Auto-track page views on init + navigation (default: true) */
+    autoTrackPageViews?: boolean;
+    /** Auto-track SPA navigation via pushState/popstate (default: true) */
+    autoTrackNavigation?: boolean;
+    /** Flush interval in ms (default: 5000) */
+    flushInterval?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+interface AnalyticsEvent {
+    eventName: string;
+    sessionId: string;
+    userId?: string;
+    properties?: Record<string, any>;
+    timestamp: string;
+}
+declare class KrisspyAnalytics {
+    private http;
+    private backendId;
+    private queue;
+    private sessionId;
+    private userId;
+    private userTraits;
+    private initialized;
+    private flushTimer;
+    private options;
+    private originalPushState;
+    private popstateHandler;
+    private unloadHandler;
+    constructor(http: HttpClient, backendId: string);
+    /**
+     * Initialize analytics tracking
+     *
+     * @example
+     * krisspy.analytics.init()
+     * krisspy.analytics.init({ autoTrackPageViews: true, flushInterval: 3000 })
+     */
+    init(options?: AnalyticsInitOptions): void;
+    /**
+     * Track a custom event
+     *
+     * @example
+     * krisspy.analytics.track('button_click', { label: 'signup', variant: 'blue' })
+     * krisspy.analytics.track('purchase', { amount: 29.99, plan: 'pro' })
+     */
+    track(eventName: string, properties?: Record<string, any>): void;
+    /**
+     * Identify a user (attach userId + traits to all future events)
+     *
+     * @example
+     * krisspy.analytics.identify('user_123', { name: 'John', plan: 'pro' })
+     */
+    identify(userId: string, traits?: Record<string, any>): void;
+    /**
+     * Flush event queue to the server (async)
+     */
+    flush(): Promise<void>;
+    /**
+     * Synchronous flush using sendBeacon (for page unload)
+     */
+    private flushSync;
+    /**
+     * Stop tracking and cleanup all listeners/timers
+     */
+    destroy(): void;
+    private getOrCreateSessionId;
+    private getIngestUrl;
+    private setupNavigationTracking;
+}
+
 /**
  * Query Builder - Supabase-style fluent API for database queries
  */
@@ -846,6 +933,7 @@ declare class KrisspyClient {
     private _auth;
     private _storage;
     private _realtime;
+    private _analytics;
     private useRLS;
     private debug;
     constructor(options: KrisspyClientOptions);
@@ -894,6 +982,23 @@ declare class KrisspyClient {
      * const { error } = await krisspy.storage.from('uploads').remove(['old.jpg'])
      */
     get storage(): KrisspyStorage;
+    /**
+     * Analytics module for event tracking
+     *
+     * @example
+     * // Initialize tracking
+     * krisspy.analytics.init()
+     *
+     * // Track custom events
+     * krisspy.analytics.track('button_click', { label: 'signup' })
+     *
+     * // Identify a user
+     * krisspy.analytics.identify('user_123', { plan: 'pro' })
+     *
+     * // Cleanup
+     * krisspy.analytics.destroy()
+     */
+    get analytics(): KrisspyAnalytics;
     /**
      * Create a realtime channel for subscribing to database changes
      *
@@ -1029,7 +1134,7 @@ declare class KrisspyClient {
  *
  * const krisspy = createClient({
  *   backendId: 'your-backend-id',
- *   apiKey: 'your-api-key', // optional
+ *   anonKey: 'your-anon-key', // from backend settings
  * })
  *
  * // Auth
@@ -1071,10 +1176,10 @@ declare class KrisspyClient {
  * @example
  * const krisspy = createClient({
  *   backendId: 'abc123',
- *   apiKey: 'your-api-key',
+ *   anonKey: 'your-anon-key',
  *   url: 'https://api.krisspy.ai', // optional
  * })
  */
 declare function createClient(options: KrisspyClientOptions): KrisspyClient;
 
-export { type AuthChangeEvent, type AuthResponse, type ChannelState, type FileObject, type FileUploadOptions, type Filter, type FilterOperator, type FunctionInvokeOptions, type FunctionResponse, HttpClient, KrisspyAuth, KrisspyClient, type KrisspyClientOptions, type KrisspyError, KrisspyRealtime, KrisspyStorage, type MutationResponse, type OAuthProvider, type OrderBy, type PostgresChangesConfig, QueryBuilder, type QueryOptions, type QueryResponse, RealtimeChannel, type RealtimeEvent, type RealtimePayload, type Session, type SignInCredentials, type SignUpCredentials, type SingleResponse, StorageBucket, type UploadAndLinkOptions, type UploadAndLinkResponse, type User, createClient };
+export { type AnalyticsEvent, type AnalyticsInitOptions, type AuthChangeEvent, type AuthResponse, type ChannelState, type FileObject, type FileUploadOptions, type Filter, type FilterOperator, type FunctionInvokeOptions, type FunctionResponse, HttpClient, KrisspyAnalytics, KrisspyAuth, KrisspyClient, type KrisspyClientOptions, type KrisspyError, KrisspyRealtime, KrisspyStorage, type MutationResponse, type OAuthProvider, type OrderBy, type PostgresChangesConfig, QueryBuilder, type QueryOptions, type QueryResponse, RealtimeChannel, type RealtimeEvent, type RealtimePayload, type Session, type SignInCredentials, type SignUpCredentials, type SingleResponse, StorageBucket, type UploadAndLinkOptions, type UploadAndLinkResponse, type User, createClient };

package/dist/index.d.ts

@@ -6,8 +6,12 @@ interface KrisspyClientOptions {
     url?: string;
     /** Backend ID for this client */
     backendId: string;
-    /** API key or access token */
-    apiKey?: string;
+    /**
+     * Public API key for the backend (required)
+     * This key can be safely exposed in frontend code.
+     * Get it from your backend settings in the Krisspy dashboard.
+     */
+    anonKey: string;
     /** Custom headers to include in all requests */
     headers?: Record<string, string>;
     /** Enable debug logging */
@@ -695,6 +699,89 @@ declare class KrisspyRealtime {
     private log;
 }
 
+/**
+ * Krisspy Analytics - Lightweight event tracking module
+ *
+ * Tracks page views, sessions, custom events. Sends batched events
+ * to the analytics ingest endpoint. Works with SPAs (intercepts pushState).
+ *
+ * @example
+ * const krisspy = createClient({ backendId: '...', anonKey: '...' })
+ * krisspy.analytics.init({ autoTrackPageViews: true })
+ * krisspy.analytics.track('button_click', { label: 'signup' })
+ */
+
+interface AnalyticsInitOptions {
+    /** Auto-track page views on init + navigation (default: true) */
+    autoTrackPageViews?: boolean;
+    /** Auto-track SPA navigation via pushState/popstate (default: true) */
+    autoTrackNavigation?: boolean;
+    /** Flush interval in ms (default: 5000) */
+    flushInterval?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+interface AnalyticsEvent {
+    eventName: string;
+    sessionId: string;
+    userId?: string;
+    properties?: Record<string, any>;
+    timestamp: string;
+}
+declare class KrisspyAnalytics {
+    private http;
+    private backendId;
+    private queue;
+    private sessionId;
+    private userId;
+    private userTraits;
+    private initialized;
+    private flushTimer;
+    private options;
+    private originalPushState;
+    private popstateHandler;
+    private unloadHandler;
+    constructor(http: HttpClient, backendId: string);
+    /**
+     * Initialize analytics tracking
+     *
+     * @example
+     * krisspy.analytics.init()
+     * krisspy.analytics.init({ autoTrackPageViews: true, flushInterval: 3000 })
+     */
+    init(options?: AnalyticsInitOptions): void;
+    /**
+     * Track a custom event
+     *
+     * @example
+     * krisspy.analytics.track('button_click', { label: 'signup', variant: 'blue' })
+     * krisspy.analytics.track('purchase', { amount: 29.99, plan: 'pro' })
+     */
+    track(eventName: string, properties?: Record<string, any>): void;
+    /**
+     * Identify a user (attach userId + traits to all future events)
+     *
+     * @example
+     * krisspy.analytics.identify('user_123', { name: 'John', plan: 'pro' })
+     */
+    identify(userId: string, traits?: Record<string, any>): void;
+    /**
+     * Flush event queue to the server (async)
+     */
+    flush(): Promise<void>;
+    /**
+     * Synchronous flush using sendBeacon (for page unload)
+     */
+    private flushSync;
+    /**
+     * Stop tracking and cleanup all listeners/timers
+     */
+    destroy(): void;
+    private getOrCreateSessionId;
+    private getIngestUrl;
+    private setupNavigationTracking;
+}
+
 /**
  * Query Builder - Supabase-style fluent API for database queries
  */
@@ -846,6 +933,7 @@ declare class KrisspyClient {
     private _auth;
     private _storage;
     private _realtime;
+    private _analytics;
     private useRLS;
     private debug;
     constructor(options: KrisspyClientOptions);
@@ -894,6 +982,23 @@ declare class KrisspyClient {
      * const { error } = await krisspy.storage.from('uploads').remove(['old.jpg'])
      */
     get storage(): KrisspyStorage;
+    /**
+     * Analytics module for event tracking
+     *
+     * @example
+     * // Initialize tracking
+     * krisspy.analytics.init()
+     *
+     * // Track custom events
+     * krisspy.analytics.track('button_click', { label: 'signup' })
+     *
+     * // Identify a user
+     * krisspy.analytics.identify('user_123', { plan: 'pro' })
+     *
+     * // Cleanup
+     * krisspy.analytics.destroy()
+     */
+    get analytics(): KrisspyAnalytics;
     /**
      * Create a realtime channel for subscribing to database changes
      *
@@ -1029,7 +1134,7 @@ declare class KrisspyClient {
  *
  * const krisspy = createClient({
  *   backendId: 'your-backend-id',
- *   apiKey: 'your-api-key', // optional
+ *   anonKey: 'your-anon-key', // from backend settings
  * })
  *
  * // Auth
@@ -1071,10 +1176,10 @@ declare class KrisspyClient {
  * @example
  * const krisspy = createClient({
  *   backendId: 'abc123',
- *   apiKey: 'your-api-key',
+ *   anonKey: 'your-anon-key',
  *   url: 'https://api.krisspy.ai', // optional
  * })
  */
 declare function createClient(options: KrisspyClientOptions): KrisspyClient;
 
-export { type AuthChangeEvent, type AuthResponse, type ChannelState, type FileObject, type FileUploadOptions, type Filter, type FilterOperator, type FunctionInvokeOptions, type FunctionResponse, HttpClient, KrisspyAuth, KrisspyClient, type KrisspyClientOptions, type KrisspyError, KrisspyRealtime, KrisspyStorage, type MutationResponse, type OAuthProvider, type OrderBy, type PostgresChangesConfig, QueryBuilder, type QueryOptions, type QueryResponse, RealtimeChannel, type RealtimeEvent, type RealtimePayload, type Session, type SignInCredentials, type SignUpCredentials, type SingleResponse, StorageBucket, type UploadAndLinkOptions, type UploadAndLinkResponse, type User, createClient };
+export { type AnalyticsEvent, type AnalyticsInitOptions, type AuthChangeEvent, type AuthResponse, type ChannelState, type FileObject, type FileUploadOptions, type Filter, type FilterOperator, type FunctionInvokeOptions, type FunctionResponse, HttpClient, KrisspyAnalytics, KrisspyAuth, KrisspyClient, type KrisspyClientOptions, type KrisspyError, KrisspyRealtime, KrisspyStorage, type MutationResponse, type OAuthProvider, type OrderBy, type PostgresChangesConfig, QueryBuilder, type QueryOptions, type QueryResponse, RealtimeChannel, type RealtimeEvent, type RealtimePayload, type Session, type SignInCredentials, type SignUpCredentials, type SingleResponse, StorageBucket, type UploadAndLinkOptions, type UploadAndLinkResponse, type User, createClient };

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   HttpClient: () => HttpClient,
+  KrisspyAnalytics: () => KrisspyAnalytics,
   KrisspyAuth: () => KrisspyAuth,
   KrisspyClient: () => KrisspyClient,
   KrisspyRealtime: () => KrisspyRealtime,
@@ -1144,6 +1145,192 @@ var KrisspyRealtime = class {
   }
 };
 
+// src/analytics.ts
+var KrisspyAnalytics = class {
+  constructor(http, backendId) {
+    this.queue = [];
+    this.sessionId = null;
+    this.userId = null;
+    this.userTraits = {};
+    this.initialized = false;
+    this.flushTimer = null;
+    this.options = {};
+    this.originalPushState = null;
+    this.popstateHandler = null;
+    this.unloadHandler = null;
+    this.http = http;
+    this.backendId = backendId;
+  }
+  /**
+   * Initialize analytics tracking
+   *
+   * @example
+   * krisspy.analytics.init()
+   * krisspy.analytics.init({ autoTrackPageViews: true, flushInterval: 3000 })
+   */
+  init(options) {
+    if (this.initialized) return;
+    if (typeof window === "undefined") return;
+    this.options = {
+      autoTrackPageViews: true,
+      autoTrackNavigation: true,
+      flushInterval: 5e3,
+      debug: false,
+      ...options
+    };
+    this.sessionId = this.getOrCreateSessionId();
+    this.initialized = true;
+    if (this.options.autoTrackPageViews) {
+      this.track("session_start", {});
+      this.track("page_view", { url: location.href, referrer: document.referrer });
+    }
+    if (this.options.autoTrackNavigation) {
+      this.setupNavigationTracking();
+    }
+    this.unloadHandler = () => {
+      this.track("session_end", {});
+      this.flushSync();
+    };
+    window.addEventListener("beforeunload", this.unloadHandler);
+    this.flushTimer = setInterval(() => this.flush(), this.options.flushInterval);
+    if (this.options.debug) {
+      console.log("[Krisspy Analytics] Initialized", { backendId: this.backendId, sessionId: this.sessionId });
+    }
+  }
+  /**
+   * Track a custom event
+   *
+   * @example
+   * krisspy.analytics.track('button_click', { label: 'signup', variant: 'blue' })
+   * krisspy.analytics.track('purchase', { amount: 29.99, plan: 'pro' })
+   */
+  track(eventName, properties) {
+    if (!this.initialized || typeof window === "undefined") return;
+    const event = {
+      eventName,
+      sessionId: this.sessionId,
+      userId: this.userId || void 0,
+      properties: {
+        ...properties,
+        ...this.userId ? { _user_traits: this.userTraits } : {}
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.queue.push(event);
+    if (this.options.debug) {
+      console.log("[Krisspy Analytics] Tracked:", eventName, properties);
+    }
+  }
+  /**
+   * Identify a user (attach userId + traits to all future events)
+   *
+   * @example
+   * krisspy.analytics.identify('user_123', { name: 'John', plan: 'pro' })
+   */
+  identify(userId, traits) {
+    this.userId = userId;
+    this.userTraits = traits || {};
+    if (this.initialized) {
+      this.track("identify", { userId, ...traits });
+    }
+  }
+  /**
+   * Flush event queue to the server (async)
+   */
+  async flush() {
+    if (!this.queue.length) return;
+    const events = this.queue.splice(0, 50);
+    const payload = { appId: this.backendId, events };
+    try {
+      await this.http.post("/api/v1/analytics/events", payload);
+      if (this.options.debug) {
+        console.log(`[Krisspy Analytics] Flushed ${events.length} events`);
+      }
+    } catch {
+      this.queue.unshift(...events);
+    }
+  }
+  /**
+   * Synchronous flush using sendBeacon (for page unload)
+   */
+  flushSync() {
+    if (!this.queue.length) return;
+    const events = this.queue.splice(0, 50);
+    const payload = JSON.stringify({ appId: this.backendId, events });
+    try {
+      if (typeof navigator !== "undefined" && navigator.sendBeacon) {
+        const blob = new Blob([payload], { type: "application/json" });
+        navigator.sendBeacon(this.getIngestUrl(), blob);
+      } else {
+        fetch(this.getIngestUrl(), {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: payload,
+          keepalive: true
+        }).catch(() => {
+        });
+      }
+    } catch {
+    }
+  }
+  /**
+   * Stop tracking and cleanup all listeners/timers
+   */
+  destroy() {
+    if (!this.initialized) return;
+    this.flushSync();
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    if (this.originalPushState) {
+      history.pushState = this.originalPushState;
+      this.originalPushState = null;
+    }
+    if (this.popstateHandler) {
+      window.removeEventListener("popstate", this.popstateHandler);
+      this.popstateHandler = null;
+    }
+    if (this.unloadHandler) {
+      window.removeEventListener("beforeunload", this.unloadHandler);
+      this.unloadHandler = null;
+    }
+    this.initialized = false;
+    this.queue = [];
+    if (this.options.debug) {
+      console.log("[Krisspy Analytics] Destroyed");
+    }
+  }
+  // ── Private helpers ──────────────────────────────────────────────────────
+  getOrCreateSessionId() {
+    const key = "_ka_sid";
+    try {
+      const existing = localStorage.getItem(key);
+      if (existing) return existing;
+      const id = Math.random().toString(36).substring(2, 15) + Date.now().toString(36);
+      localStorage.setItem(key, id);
+      return id;
+    } catch {
+      return Math.random().toString(36).substring(2, 15) + Date.now().toString(36);
+    }
+  }
+  getIngestUrl() {
+    return `${this.http.baseUrl}/api/v1/analytics/events`;
+  }
+  setupNavigationTracking() {
+    this.originalPushState = history.pushState;
+    const self = this;
+    history.pushState = function(...args) {
+      self.originalPushState.apply(history, args);
+      self.track("page_view", { url: location.href });
+    };
+    this.popstateHandler = () => {
+      this.track("page_view", { url: location.href });
+    };
+    window.addEventListener("popstate", this.popstateHandler);
+  }
+};
+
 // src/query-builder.ts
 var QueryBuilder = class {
   constructor(http, backendId, tableName, useRLS = true) {
@@ -1431,13 +1618,14 @@ var KrisspyClient = class {
       baseUrl: this.baseUrl,
       headers: {
         ...options.headers,
-        ...options.apiKey ? { "Authorization": `Bearer ${options.apiKey}` } : {}
+        "apikey": options.anonKey
       },
       debug: options.debug
     });
     this._auth = new KrisspyAuth(this.http, this.backendId);
     this._storage = new KrisspyStorage(this.http, this.backendId);
     this._realtime = new KrisspyRealtime(this.baseUrl, this.backendId, this.debug);
+    this._analytics = new KrisspyAnalytics(this.http, this.backendId);
     this._auth.onAuthStateChange((event) => {
       if (event === "SIGNED_IN") {
         const session = this._auth.session();
@@ -1498,6 +1686,25 @@ var KrisspyClient = class {
   get storage() {
     return this._storage;
   }
+  /**
+   * Analytics module for event tracking
+   *
+   * @example
+   * // Initialize tracking
+   * krisspy.analytics.init()
+   *
+   * // Track custom events
+   * krisspy.analytics.track('button_click', { label: 'signup' })
+   *
+   * // Identify a user
+   * krisspy.analytics.identify('user_123', { plan: 'pro' })
+   *
+   * // Cleanup
+   * krisspy.analytics.destroy()
+   */
+  get analytics() {
+    return this._analytics;
+  }
   /**
    * Create a realtime channel for subscribing to database changes
    *
@@ -1666,6 +1873,7 @@ function createClient(options) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   HttpClient,
+  KrisspyAnalytics,
   KrisspyAuth,
   KrisspyClient,
   KrisspyRealtime,

package/dist/index.mjs

@@ -1110,6 +1110,192 @@ var KrisspyRealtime = class {
   }
 };
 
+// src/analytics.ts
+var KrisspyAnalytics = class {
+  constructor(http, backendId) {
+    this.queue = [];
+    this.sessionId = null;
+    this.userId = null;
+    this.userTraits = {};
+    this.initialized = false;
+    this.flushTimer = null;
+    this.options = {};
+    this.originalPushState = null;
+    this.popstateHandler = null;
+    this.unloadHandler = null;
+    this.http = http;
+    this.backendId = backendId;
+  }
+  /**
+   * Initialize analytics tracking
+   *
+   * @example
+   * krisspy.analytics.init()
+   * krisspy.analytics.init({ autoTrackPageViews: true, flushInterval: 3000 })
+   */
+  init(options) {
+    if (this.initialized) return;
+    if (typeof window === "undefined") return;
+    this.options = {
+      autoTrackPageViews: true,
+      autoTrackNavigation: true,
+      flushInterval: 5e3,
+      debug: false,
+      ...options
+    };
+    this.sessionId = this.getOrCreateSessionId();
+    this.initialized = true;
+    if (this.options.autoTrackPageViews) {
+      this.track("session_start", {});
+      this.track("page_view", { url: location.href, referrer: document.referrer });
+    }
+    if (this.options.autoTrackNavigation) {
+      this.setupNavigationTracking();
+    }
+    this.unloadHandler = () => {
+      this.track("session_end", {});
+      this.flushSync();
+    };
+    window.addEventListener("beforeunload", this.unloadHandler);
+    this.flushTimer = setInterval(() => this.flush(), this.options.flushInterval);
+    if (this.options.debug) {
+      console.log("[Krisspy Analytics] Initialized", { backendId: this.backendId, sessionId: this.sessionId });
+    }
+  }
+  /**
+   * Track a custom event
+   *
+   * @example
+   * krisspy.analytics.track('button_click', { label: 'signup', variant: 'blue' })
+   * krisspy.analytics.track('purchase', { amount: 29.99, plan: 'pro' })
+   */
+  track(eventName, properties) {
+    if (!this.initialized || typeof window === "undefined") return;
+    const event = {
+      eventName,
+      sessionId: this.sessionId,
+      userId: this.userId || void 0,
+      properties: {
+        ...properties,
+        ...this.userId ? { _user_traits: this.userTraits } : {}
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.queue.push(event);
+    if (this.options.debug) {
+      console.log("[Krisspy Analytics] Tracked:", eventName, properties);
+    }
+  }
+  /**
+   * Identify a user (attach userId + traits to all future events)
+   *
+   * @example
+   * krisspy.analytics.identify('user_123', { name: 'John', plan: 'pro' })
+   */
+  identify(userId, traits) {
+    this.userId = userId;
+    this.userTraits = traits || {};
+    if (this.initialized) {
+      this.track("identify", { userId, ...traits });
+    }
+  }
+  /**
+   * Flush event queue to the server (async)
+   */
+  async flush() {
+    if (!this.queue.length) return;
+    const events = this.queue.splice(0, 50);
+    const payload = { appId: this.backendId, events };
+    try {
+      await this.http.post("/api/v1/analytics/events", payload);
+      if (this.options.debug) {
+        console.log(`[Krisspy Analytics] Flushed ${events.length} events`);
+      }
+    } catch {
+      this.queue.unshift(...events);
+    }
+  }
+  /**
+   * Synchronous flush using sendBeacon (for page unload)
+   */
+  flushSync() {
+    if (!this.queue.length) return;
+    const events = this.queue.splice(0, 50);
+    const payload = JSON.stringify({ appId: this.backendId, events });
+    try {
+      if (typeof navigator !== "undefined" && navigator.sendBeacon) {
+        const blob = new Blob([payload], { type: "application/json" });
+        navigator.sendBeacon(this.getIngestUrl(), blob);
+      } else {
+        fetch(this.getIngestUrl(), {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: payload,
+          keepalive: true
+        }).catch(() => {
+        });
+      }
+    } catch {
+    }
+  }
+  /**
+   * Stop tracking and cleanup all listeners/timers
+   */
+  destroy() {
+    if (!this.initialized) return;
+    this.flushSync();
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    if (this.originalPushState) {
+      history.pushState = this.originalPushState;
+      this.originalPushState = null;
+    }
+    if (this.popstateHandler) {
+      window.removeEventListener("popstate", this.popstateHandler);
+      this.popstateHandler = null;
+    }
+    if (this.unloadHandler) {
+      window.removeEventListener("beforeunload", this.unloadHandler);
+      this.unloadHandler = null;
+    }
+    this.initialized = false;
+    this.queue = [];
+    if (this.options.debug) {
+      console.log("[Krisspy Analytics] Destroyed");
+    }
+  }
+  // ── Private helpers ──────────────────────────────────────────────────────
+  getOrCreateSessionId() {
+    const key = "_ka_sid";
+    try {
+      const existing = localStorage.getItem(key);
+      if (existing) return existing;
+      const id = Math.random().toString(36).substring(2, 15) + Date.now().toString(36);
+      localStorage.setItem(key, id);
+      return id;
+    } catch {
+      return Math.random().toString(36).substring(2, 15) + Date.now().toString(36);
+    }
+  }
+  getIngestUrl() {
+    return `${this.http.baseUrl}/api/v1/analytics/events`;
+  }
+  setupNavigationTracking() {
+    this.originalPushState = history.pushState;
+    const self = this;
+    history.pushState = function(...args) {
+      self.originalPushState.apply(history, args);
+      self.track("page_view", { url: location.href });
+    };
+    this.popstateHandler = () => {
+      this.track("page_view", { url: location.href });
+    };
+    window.addEventListener("popstate", this.popstateHandler);
+  }
+};
+
 // src/query-builder.ts
 var QueryBuilder = class {
   constructor(http, backendId, tableName, useRLS = true) {
@@ -1397,13 +1583,14 @@ var KrisspyClient = class {
       baseUrl: this.baseUrl,
       headers: {
         ...options.headers,
-        ...options.apiKey ? { "Authorization": `Bearer ${options.apiKey}` } : {}
+        "apikey": options.anonKey
       },
       debug: options.debug
     });
     this._auth = new KrisspyAuth(this.http, this.backendId);
     this._storage = new KrisspyStorage(this.http, this.backendId);
     this._realtime = new KrisspyRealtime(this.baseUrl, this.backendId, this.debug);
+    this._analytics = new KrisspyAnalytics(this.http, this.backendId);
     this._auth.onAuthStateChange((event) => {
       if (event === "SIGNED_IN") {
         const session = this._auth.session();
@@ -1464,6 +1651,25 @@ var KrisspyClient = class {
   get storage() {
     return this._storage;
   }
+  /**
+   * Analytics module for event tracking
+   *
+   * @example
+   * // Initialize tracking
+   * krisspy.analytics.init()
+   *
+   * // Track custom events
+   * krisspy.analytics.track('button_click', { label: 'signup' })
+   *
+   * // Identify a user
+   * krisspy.analytics.identify('user_123', { plan: 'pro' })
+   *
+   * // Cleanup
+   * krisspy.analytics.destroy()
+   */
+  get analytics() {
+    return this._analytics;
+  }
   /**
    * Create a realtime channel for subscribing to database changes
    *
@@ -1631,6 +1837,7 @@ function createClient(options) {
 }
 export {
   HttpClient,
+  KrisspyAnalytics,
   KrisspyAuth,
   KrisspyClient,
   KrisspyRealtime,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "krisspy-sdk",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Krisspy Cloud SDK - Database, Auth, Storage, and Functions for your apps",
   "main": "dist/index.js",
   "module": "dist/index.mjs",