import { createAnalytics } from "@visitor-analytics-sdk/core";

const analytics = createAnalytics({
  endpoint: "https://your-api.com/analytics",
  // storage auto-detects: indexeddb -> localstorage -> memory
  autoStart: true,
});

// That's it. Data starts collecting automatically.

const analytics = createAnalytics({
  endpoint: "https://api.example.com/analytics",
  storage: "indexeddb",       // auto-detected if omitted: indexeddb -> localstorage -> memory
  autoStart: true,            // Start collecting immediately
  batchSize: 50,              // Records per upload batch
  flushInterval: 30000,       // ms between auto-flushes
  maxRetries: 5,              // Max retry attempts
  retryBaseDelay: 1000,       // Base delay for exponential backoff
  compressionEnabled: false,  // Gzip compression (requires CompressionStream: Chrome 80+, Firefox 113+, Safari 16.4+)
  deduplicationEnabled: true, // Deduplicate batches
  includeUserAgent: false,    // Include raw UA string
  includeReferrer: true,      // Include page referrer
  sessionTimeout: 1800000,    // Session timeout (30min)
  customData: {},             // Custom key-value pairs
});

analytics.start()                          // Begin collecting
analytics.stop()                           // Pause collecting
analytics.flush()                          // Force upload pending records (does NOT re-collect)
analytics.sync()                           // Force sync (alias for flush)
analytics.retryFailed()                    // Retry failed uploads
analytics.use(plugin)                      // Install a plugin
analytics.addCollector(collector)          // Add a custom collector
analytics.removeCollector(name)            // Remove a collector
analytics.getCollectedData()               // Get all stored records
analytics.query(query)                     // Query records with filters
analytics.export()                         // Export as JSON string
analytics.trackRouteChange(url)            // Manually track a SPA route change
analytics.on(event, handler)               // Subscribe to events
analytics.off(event, handler)              // Unsubscribe from events
analytics.destroy()                        // Cleanup everything

const records = await analytics.query({
  since: Date.now() - 86400000,   // Last 24 hours
  until: Date.now(),
  pagePath: "/pricing",           // Filter by page path
  sessionId: "abc-123",           // Filter by session
  limit: 100,                     // Max records
  offset: 0,                      // Skip first N records
});

analytics.on("start", () => { /* ... */ });
analytics.on("stop", () => { /* ... */ });
analytics.on("flush", () => { /* ... */ });
analytics.on("record-collected", (record) => { /* ... */ });
analytics.on("batch-uploaded", (batchId) => { /* ... */ });
analytics.on("batch-failed", (batchId, error) => { /* ... */ });
analytics.on("collector-registered", (name) => { /* ... */ });
analytics.on("collector-removed", (name) => { /* ... */ });
analytics.on("plugin-installed", (name) => { /* ... */ });
analytics.on("plugin-uninstalled", (name) => { /* ... */ });

import { createAnalytics } from "@visitor-analytics-sdk/core";

const analytics = createAnalytics({
  endpoint: "https://api.example.com/analytics",
  storage: "indexeddb",
  autoStart: true,
});

// Listen for events
analytics.on("batch-uploaded", (batchId) => {
  console.log("Uploaded:", batchId);
});

import type { Collector, CollectorContext, AnalyticsRecord } from "@visitor-analytics-sdk/core";

class MyCollector implements Collector {
  readonly name = "my-collector";
  readonly category = "custom";
  readonly version = "1.0.0";
  enabled = true;

  async collect(context: CollectorContext): Promise<Partial<AnalyticsRecord>> {
    return {
      metadata: {
        sdkVersion: "1.0.0",
        buildTarget: "browser",
        collectorVersion: "1.0.0",
        customData: {
          userRole: "admin",
          experimentGroup: "A",
        },
      },
    };
  }
}

analytics.addCollector(new MyCollector());

import type { StorageAdapter, AnalyticsRecord } from "@visitor-analytics-sdk/core";

class RedisAdapter implements StorageAdapter {
  async save(record: AnalyticsRecord): Promise<void> {
    await fetch("/api/redis/save", {
      method: "POST",
      body: JSON.stringify(record),
    });
  }

  async saveBatch(records: readonly AnalyticsRecord[]): Promise<void> {
    await fetch("/api/redis/save-batch", {
      method: "POST",
      body: JSON.stringify(records),
    });
  }

  async load(): Promise<readonly AnalyticsRecord[]> {
    const res = await fetch("/api/redis/load");
    return res.json();
  }

  async loadBatch(limit: number): Promise<readonly AnalyticsRecord[]> {
    const res = await fetch(`/api/redis/load-batch?limit=${limit}`);
    return res.json();
  }

  async remove(ids: readonly string[]): Promise<void> {
    await fetch("/api/redis/remove", {
      method: "POST",
      body: JSON.stringify(ids),
    });
  }

  async count(): Promise<number> {
    const res = await fetch("/api/redis/count");
    return res.json();
  }

  async clear(): Promise<void> {
    await fetch("/api/redis/clear", { method: "POST" });
  }

  async export(): Promise<string> {
    const res = await fetch("/api/redis/export");
    return res.text();
  }
}

const analytics = createAnalytics({
  endpoint: "/api/analytics",
  storage: new RedisAdapter(),
});

import type { Plugin, PluginContext } from "@visitor-analytics-sdk/core";

class ABTestPlugin implements Plugin {
  readonly name = "ab-test";
  readonly version = "1.0.0";
  readonly description = "Adds A/B test variant data to analytics";

  install(ctx: PluginContext): void {
    const variant = localStorage.getItem("ab-variant") ?? "control";
    const collector = {
      name: "ab-test-collector",
      category: "custom",
      version: "1.0.0",
      enabled: true,
      collect: async () => ({
        metadata: {
          sdkVersion: "1.0.0",
          buildTarget: "browser",
          collectorVersion: "1.0.0",
          customData: { abVariant: variant },
        },
      }),
    };
    ctx.addCollector(collector);
  }

  uninstall(ctx: PluginContext): void {
    ctx.removeCollector("ab-test-collector");
  }
}

analytics.use(new ABTestPlugin());

analytics.trackRouteChange("/new-page");