@eventra_dev/eventra-sdk 0.1.2

package/README.md

@@ -0,0 +1,197 @@
+# Eventra SDK
+
+![npm](https://img.shields.io/npm/v/@eventra/sdk)
+![bundle size](https://img.shields.io/bundlephobia/minzip/@eventra/sdk)
+![license](https://img.shields.io/npm/l/@eventra/sdk)
+![types](https://img.shields.io/npm/types/@eventra/sdk)
+
+Production-grade TypeScript SDK for tracking product events across **browser, server, and edge runtimes**.
+
+Eventra is designed for **deterministic ingestion**, batching efficiency, and near-zero runtime overhead.
+
+---
+
+##  Features
+
+- UUID v4 idempotency keys
+- Safe retry policy
+- Exponential backoff with jitter
+- sendBeacon support for browsers
+- Multi-runtime support (Browser / Node / Bun / Deno / Edge)
+- Optional multi-tab leader mode
+- Queue overflow protection
+- Zero dependencies
+
+---
+
+## Install
+
+```bash
+pnpm add @eventra/sdk
+```
+
+or
+
+```bash
+npm install @eventra/sdk
+```
+
+---
+
+#  Quick Start
+
+## Browser
+
+```ts
+import { Eventra } from "@eventra/sdk";
+
+const tracker = new Eventra({
+  apiKey: "YOUR_API_KEY"
+});
+
+tracker.track("checkout.completed", {
+  userId: "user_123"
+});
+```
+
+---
+
+## Node / NestJS
+
+```ts
+import { Eventra } from "@eventra/sdk";
+
+const tracker = new Eventra({
+  apiKey: process.env.EVENTRA_API_KEY!
+});
+
+tracker.track("invoice.created", {
+  userId: "user_123"
+});
+```
+
+---
+
+#  Configuration
+
+| Option | Default |
+|------|------|
+| flushInterval | 2000 ms |
+| maxBatchSize | 50 |
+| maxRetries | 3 |
+| maxQueueSize | 10000 |
+| retryBaseDelayMs | 300 |
+
+Example:
+
+```ts
+const tracker = new Eventra({
+  apiKey: "API_KEY",
+  flushInterval: 2000,
+  maxBatchSize: 50
+});
+```
+
+---
+
+# Reliability Model
+
+### Idempotency
+
+Each event receives a **UUID v4 idempotency key**, ensuring:
+
+- safe retries
+- duplicate suppression
+- multi-tab safety
+
+---
+
+### Retry Policy
+
+The SDK retries only when safe:
+
+✔ network failures  
+✔ HTTP 5xx
+
+It does **not retry**:
+
+✖ HTTP 4xx  
+✖ validation errors  
+✖ authentication errors
+
+---
+
+### Backoff Strategy
+
+```
+delay = base * 2^attempt * jitter(0.5–1.5) 
+```
+
+---
+
+# Multi-Tab Mode
+
+Default:
+
+```ts
+multiTabMode: "independent"
+```
+
+Leader mode:
+
+```ts
+const tracker = new Eventra({
+  apiKey: "API_KEY",
+  multiTabMode: "leader"
+});
+```
+
+One tab becomes the sender and reduces duplicate traffic.
+
+---
+
+# Architecture
+
+```
+ Application
+     │
+     ▼
+ Eventra SDK
+     │
+ batching + retry
+     │
+     ▼
+ Eventra Ingest API
+     │
+ idempotent pipeline
+     │
+     ▼
+ Eventra Event Store
+```
+
+---
+
+# Best Practices
+
+Use semantic event names.
+
+Good:
+
+```
+invoice.created
+checkout.completed
+team.invited
+```
+
+Bad:
+
+```
+button_clicked
+modal_opened
+```
+
+---
+
+# License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,262 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Eventra: () => Eventra
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var SDK_VERSION = "0.1.2";
+var DEFAULTS = {
+  endpoint: "http://api.eventra.dev/api/v1/ingest/batch",
+  flushInterval: 2e3,
+  maxBatchSize: 50,
+  maxQueueSize: 1e4,
+  maxRetries: 3,
+  retryBaseDelay: 300
+};
+function getGlobalFetch() {
+  if (typeof fetch !== "undefined") {
+    return fetch.bind(globalThis);
+  }
+  return void 0;
+}
+function generateUUIDv4() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  const rnd = Math.random().toString(16).slice(2);
+  const ts = Date.now().toString(16);
+  return `${ts}-${rnd}`;
+}
+function isBrowser() {
+  return typeof window !== "undefined";
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+var LEADER_KEY = "__eventra_sdk_leader__";
+var LEADER_TTL = 4e3;
+function tryBecomeLeader() {
+  if (!isBrowser()) return true;
+  try {
+    const now = Date.now();
+    const raw = localStorage.getItem(LEADER_KEY);
+    if (!raw) {
+      localStorage.setItem(
+        LEADER_KEY,
+        JSON.stringify({ ts: now })
+      );
+      return true;
+    }
+    const parsed = JSON.parse(raw);
+    if (now - parsed.ts > LEADER_TTL) {
+      localStorage.setItem(
+        LEADER_KEY,
+        JSON.stringify({ ts: now })
+      );
+      return true;
+    }
+    return false;
+  } catch {
+    return true;
+  }
+}
+var Eventra = class {
+  constructor(options) {
+    this.queue = [];
+    this.inFlight = false;
+    this.destroyed = false;
+    this.droppedEvents = 0;
+    if (!options.apiKey) {
+      throw new Error("Eventra: apiKey is required");
+    }
+    this.apiKey = options.apiKey;
+    this.endpoint = options.endpoint ?? DEFAULTS.endpoint ?? "";
+    if (!this.endpoint) {
+      throw new Error("Eventra: endpoint is not configured");
+    }
+    this.flushInterval = options.flushInterval ?? DEFAULTS.flushInterval;
+    this.maxBatchSize = options.maxBatchSize ?? DEFAULTS.maxBatchSize;
+    this.maxQueueSize = options.maxQueueSize ?? DEFAULTS.maxQueueSize;
+    this.maxRetries = options.maxRetries ?? DEFAULTS.maxRetries;
+    this.retryBaseDelay = options.retryBaseDelayMs ?? DEFAULTS.retryBaseDelay;
+    this.multiTabMode = options.multiTabMode ?? "independent";
+    this.fetchImpl = options.fetchImpl ?? getGlobalFetch();
+    if (!this.fetchImpl) {
+      throw new Error(
+        "Eventra: fetch is not available. Provide fetchImpl."
+      );
+    }
+    this.sdkInfo = {
+      name: "@eventra/sdk",
+      version: SDK_VERSION,
+      runtime: this.detectRuntime()
+    };
+    if (!options.disableTimer) {
+      this.startTimer();
+    }
+    if (options.autoFlushOnExit !== false) {
+      this.setupExitHandlers();
+    }
+    this.onEventsDropped = options.onEventsDropped;
+  }
+  /* ---------------- Public API ---------------- */
+  track(name, options) {
+    if (this.destroyed) return;
+    if (this.queue.length >= this.maxQueueSize) {
+      this.droppedEvents++;
+      this.onEventsDropped?.(this.droppedEvents);
+      return;
+    }
+    this.queue.push({
+      idempotencyKey: generateUUIDv4(),
+      name,
+      userId: options?.userId,
+      properties: options?.properties ?? {},
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    if (this.queue.length >= this.maxBatchSize) {
+      void this.flush();
+    }
+  }
+  async flush() {
+    if (this.destroyed) return;
+    if (this.inFlight) return;
+    if (this.queue.length === 0) return;
+    if (this.multiTabMode === "leader" && !tryBecomeLeader()) {
+      return;
+    }
+    this.inFlight = true;
+    const batch = this.queue.splice(0, this.queue.length);
+    try {
+      await this.send(batch);
+    } catch {
+      this.queue.unshift(...batch);
+    } finally {
+      this.inFlight = false;
+    }
+  }
+  destroy() {
+    this.destroyed = true;
+    if (this.timer) clearInterval(this.timer);
+  }
+  /* ---------------- Transport ---------------- */
+  trySendBeacon(payload) {
+    if (!isBrowser()) return false;
+    try {
+      if (navigator.sendBeacon) {
+        const blob = new Blob([payload], {
+          type: "application/json"
+        });
+        return navigator.sendBeacon(this.endpoint, blob);
+      }
+    } catch {
+    }
+    return false;
+  }
+  async send(events) {
+    const payload = JSON.stringify({
+      sentAt: (/* @__PURE__ */ new Date()).toISOString(),
+      sdk: this.sdkInfo,
+      events
+    });
+    if (isBrowser() && payload.length < 6e4 && document.visibilityState === "hidden") {
+      if (this.trySendBeacon(payload)) return;
+    }
+    let attempt = 0;
+    while (attempt <= this.maxRetries) {
+      try {
+        const res = await this.fetchImpl(this.endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-api-key": this.apiKey
+          },
+          body: payload
+        });
+        if (res.status >= 400 && res.status < 500) {
+          if (res.status === 401 || res.status === 403) {
+            console.error("Eventra: Invalid API key");
+          }
+          return;
+        }
+        if (!res.ok) {
+          throw new Error(`HTTP ${res.status}`);
+        }
+        return;
+      } catch (err) {
+        attempt++;
+        if (attempt > this.maxRetries) {
+          throw err;
+        }
+        const jitter = 0.5 + Math.random();
+        const delay = this.retryBaseDelay * 2 ** (attempt - 1) * jitter;
+        await sleep(delay);
+      }
+    }
+  }
+  /* ---------------- Runtime ---------------- */
+  detectRuntime() {
+    if (typeof window !== "undefined") return "browser";
+    const g = globalThis;
+    if (g["Deno"]) return "deno";
+    if (g["Bun"]) return "bun";
+    const maybeProcess = g["process"];
+    if (maybeProcess?.versions?.node) return "node";
+    return "unknown";
+  }
+  /* ---------------- Timer ---------------- */
+  startTimer() {
+    this.timer = setInterval(() => {
+      void this.flush();
+    }, this.flushInterval);
+  }
+  /* ---------------- Exit handling ---------------- */
+  setupExitHandlers() {
+    if (typeof window !== "undefined") {
+      window.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "hidden") {
+          void this.flush();
+        }
+      });
+    }
+    const g = globalThis;
+    const maybeProcess = g["process"];
+    if (typeof maybeProcess?.once === "function") {
+      const shutdown = async () => {
+        try {
+          await this.flush();
+        } catch {
+        }
+      };
+      maybeProcess.once("SIGINT", shutdown);
+      maybeProcess.once("SIGTERM", shutdown);
+      maybeProcess.once("beforeExit", shutdown);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Eventra
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export * from \"./client\";\nexport * from \"./types\";\n","import {\n  TrackerOptions,\n  TrackEvent,\n  SdkInfo,\n} from \"./types\";\n\n/* ---------------- Constants ---------------- */\n\n\ndeclare const __SDK_VERSION__: string;\ndeclare const __EVENTRA_ENDPOINT__: string | undefined;\n\nconst SDK_VERSION = __SDK_VERSION__;\n\nconst DEFAULTS = {\n  endpoint: __EVENTRA_ENDPOINT__ ?? \"\",\n  flushInterval: 2000,\n  maxBatchSize: 50,\n  maxQueueSize: 10_000,\n  maxRetries: 3,\n  retryBaseDelay: 300,\n};\n\n/* ---------------- Helpers ---------------- */\n\nfunction getGlobalFetch(): typeof fetch | undefined {\n  if (typeof fetch !== \"undefined\") {\n    return fetch.bind(globalThis);\n  }\n  return undefined;\n}\n\nfunction generateUUIDv4(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return crypto.randomUUID();\n  }\n\n  // ultra-rare fallback (не должен происходить в нормальной среде)\n  const rnd = Math.random().toString(16).slice(2);\n  const ts = Date.now().toString(16);\n  return `${ts}-${rnd}`;\n}\n\nfunction isBrowser(): boolean {\n  return typeof window !== \"undefined\";\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((r) => setTimeout(r, ms));\n}\n\n/* ---------------- Leader Election (minimal) ---------------- */\n\nconst LEADER_KEY = \"__eventra_sdk_leader__\";\nconst LEADER_TTL = 4000;\n\nfunction tryBecomeLeader(): boolean {\n  if (!isBrowser()) return true;\n\n  try {\n    const now = Date.now();\n    const raw = localStorage.getItem(LEADER_KEY);\n\n    if (!raw) {\n      localStorage.setItem(\n        LEADER_KEY,\n        JSON.stringify({ ts: now })\n      );\n      return true;\n    }\n\n    const parsed = JSON.parse(raw) as { ts: number };\n\n    if (now - parsed.ts > LEADER_TTL) {\n      localStorage.setItem(\n        LEADER_KEY,\n        JSON.stringify({ ts: now })\n      );\n      return true;\n    }\n\n    return false;\n  } catch {\n    return true; // fail-open\n  }\n}\n\n/* ============================================================ */\n\nexport class Eventra {\n  private apiKey: string;\n  private endpoint: string;\n  private flushInterval: number;\n  private maxBatchSize: number;\n  private maxQueueSize: number;\n  private maxRetries: number;\n  private retryBaseDelay: number;\n  private multiTabMode: \"independent\" | \"leader\";\n\n  private fetchImpl?: typeof fetch;\n  private queue: TrackEvent[] = [];\n  private timer?: ReturnType<typeof setInterval>;\n  private inFlight = false;\n  private destroyed = false;\n  private droppedEvents = 0;\n\n  private sdkInfo: SdkInfo;\n\n  constructor(options: TrackerOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"Eventra: apiKey is required\");\n    }\n\n    this.apiKey = options.apiKey;\n\n    this.endpoint = options.endpoint ?? DEFAULTS.endpoint ?? \"\";\n    if (!this.endpoint) {\n      throw new Error(\"Eventra: endpoint is not configured\");\n    }\n\n    this.flushInterval =\n      options.flushInterval ?? DEFAULTS.flushInterval;\n\n    this.maxBatchSize =\n      options.maxBatchSize ?? DEFAULTS.maxBatchSize;\n\n    this.maxQueueSize =\n      options.maxQueueSize ?? DEFAULTS.maxQueueSize;\n\n    this.maxRetries =\n      options.maxRetries ?? DEFAULTS.maxRetries;\n\n    this.retryBaseDelay =\n      options.retryBaseDelayMs ?? DEFAULTS.retryBaseDelay;\n\n    this.multiTabMode =\n      options.multiTabMode ?? \"independent\";\n\n    this.fetchImpl =\n      options.fetchImpl ?? getGlobalFetch();\n\n    if (!this.fetchImpl) {\n      throw new Error(\n        \"Eventra: fetch is not available. Provide fetchImpl.\"\n      );\n    }\n\n    this.sdkInfo = {\n      name: \"@eventra/sdk\",\n      version: SDK_VERSION,\n      runtime: this.detectRuntime(),\n    };\n\n    if (!options.disableTimer) {\n      this.startTimer();\n    }\n\n    if (options.autoFlushOnExit !== false) {\n      this.setupExitHandlers();\n    }\n\n    this.onEventsDropped = options.onEventsDropped;\n  }\n\n  private onEventsDropped?: (count: number) => void;\n\n  /* ---------------- Public API ---------------- */\n\n  track(\n    name: string,\n    options?: {\n      userId?: string;\n      properties?: Record<string, unknown>;\n    }\n  ) {\n    if (this.destroyed) return;\n\n    if (this.queue.length >= this.maxQueueSize) {\n      this.droppedEvents++;\n      this.onEventsDropped?.(this.droppedEvents);\n      return;\n    }\n\n    this.queue.push({\n      idempotencyKey: generateUUIDv4(),\n      name,\n      userId: options?.userId,\n      properties: options?.properties ?? {},\n      timestamp: new Date().toISOString(),\n    });\n\n    if (this.queue.length >= this.maxBatchSize) {\n      void this.flush();\n    }\n  }\n\n  async flush(): Promise<void> {\n    if (this.destroyed) return;\n    if (this.inFlight) return;\n    if (this.queue.length === 0) return;\n\n    if (\n      this.multiTabMode === \"leader\" &&\n      !tryBecomeLeader()\n    ) {\n      return;\n    }\n\n    this.inFlight = true;\n\n    const batch = this.queue.splice(0, this.queue.length);\n\n    try {\n      await this.send(batch);\n    } catch {\n      this.queue.unshift(...batch);\n    } finally {\n      this.inFlight = false;\n    }\n  }\n\n  destroy() {\n    this.destroyed = true;\n    if (this.timer) clearInterval(this.timer);\n  }\n\n  /* ---------------- Transport ---------------- */\n\n  private trySendBeacon(payload: string): boolean {\n    if (!isBrowser()) return false;\n\n    try {\n      if (navigator.sendBeacon) {\n        const blob = new Blob([payload], {\n          type: \"application/json\",\n        });\n        return navigator.sendBeacon(this.endpoint, blob);\n      }\n    } catch {\n      // ignore\n    }\n\n    return false;\n  }\n\n  private async send(events: TrackEvent[]) {\n    const payload = JSON.stringify({\n      sentAt: new Date().toISOString(),\n      sdk: this.sdkInfo,\n      events,\n    });\n\n    // beacon fast-path (browser only)\n    if (\n      isBrowser() &&\n      payload.length < 60_000 &&\n      document.visibilityState === \"hidden\"\n    ) {\n      if (this.trySendBeacon(payload)) return;\n    }\n\n    let attempt = 0;\n\n    while (attempt <= this.maxRetries) {\n      try {\n        const res = await this.fetchImpl!(this.endpoint, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            \"x-api-key\": this.apiKey,\n          },\n          body: payload,\n        });\n\n        // ❗ DO NOT retry client errors\n        if (res.status >= 400 && res.status < 500) {\n          if (res.status === 401 || res.status === 403) {\n            console.error(\"Eventra: Invalid API key\");\n          }\n          return;\n        }\n\n        if (!res.ok) {\n          throw new Error(`HTTP ${res.status}`);\n        }\n\n        return;\n      } catch (err) {\n        attempt++;\n\n        if (attempt > this.maxRetries) {\n          throw err;\n        }\n\n        const jitter = 0.5 + Math.random(); // 0.5–1.5\n        const delay =\n          this.retryBaseDelay *\n          2 ** (attempt - 1) *\n          jitter;\n\n        await sleep(delay);\n      }\n    }\n  }\n\n  /* ---------------- Runtime ---------------- */\n\n  private detectRuntime(): string {\n    if (typeof window !== \"undefined\") return \"browser\";\n\n    const g = globalThis as Record<string, unknown>;\n\n    if (g[\"Deno\"]) return \"deno\";\n    if (g[\"Bun\"]) return \"bun\";\n\n    const maybeProcess = g[\"process\"] as\n      | { versions?: { node?: string } }\n      | undefined;\n\n    if (maybeProcess?.versions?.node) return \"node\";\n\n    return \"unknown\";\n  }\n\n  /* ---------------- Timer ---------------- */\n\n  private startTimer() {\n    this.timer = setInterval(() => {\n      void this.flush();\n    }, this.flushInterval);\n  }\n\n  /* ---------------- Exit handling ---------------- */\n\n  private setupExitHandlers() {\n    // browser\n    if (typeof window !== \"undefined\") {\n      window.addEventListener(\"visibilitychange\", () => {\n        if (document.visibilityState === \"hidden\") {\n          void this.flush();\n        }\n      });\n    }\n\n    // node\n    const g = globalThis as Record<string, unknown>;\n\n    const maybeProcess = g[\"process\"] as\n      | { once?: (event: string, cb: () => void) => void }\n      | undefined;\n\n    if (typeof maybeProcess?.once === \"function\") {\n      const shutdown = async () => {\n        try {\n          await this.flush();\n        } catch {}\n      };\n\n      maybeProcess.once(\"SIGINT\", shutdown);\n      maybeProcess.once(\"SIGTERM\", shutdown);\n      maybeProcess.once(\"beforeExit\", shutdown);\n    }\n  }\n}\n\nexport * from \"./types\";\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,61 @@
+interface TrackerOptions {
+    apiKey: string;
+    endpoint?: string;
+    flushInterval?: number;
+    maxBatchSize?: number;
+    maxQueueSize?: number;
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+    fetchImpl?: typeof fetch;
+    autoFlushOnExit?: boolean;
+    disableTimer?: boolean;
+    /** Called when events are dropped due to queue overflow */
+    onEventsDropped?: (count: number) => void;
+    /** Multi-tab mode (browser only) */
+    multiTabMode?: "independent" | "leader";
+}
+interface TrackEvent {
+    idempotencyKey: string;
+    name: string;
+    userId?: string;
+    properties?: Record<string, unknown>;
+    timestamp: string;
+}
+interface SdkInfo {
+    name: string;
+    version: string;
+    runtime: string;
+}
+
+declare class Eventra {
+    private apiKey;
+    private endpoint;
+    private flushInterval;
+    private maxBatchSize;
+    private maxQueueSize;
+    private maxRetries;
+    private retryBaseDelay;
+    private multiTabMode;
+    private fetchImpl?;
+    private queue;
+    private timer?;
+    private inFlight;
+    private destroyed;
+    private droppedEvents;
+    private sdkInfo;
+    constructor(options: TrackerOptions);
+    private onEventsDropped?;
+    track(name: string, options?: {
+        userId?: string;
+        properties?: Record<string, unknown>;
+    }): void;
+    flush(): Promise<void>;
+    destroy(): void;
+    private trySendBeacon;
+    private send;
+    private detectRuntime;
+    private startTimer;
+    private setupExitHandlers;
+}
+
+export { Eventra, type SdkInfo, type TrackEvent, type TrackerOptions };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+interface TrackerOptions {
+    apiKey: string;
+    endpoint?: string;
+    flushInterval?: number;
+    maxBatchSize?: number;
+    maxQueueSize?: number;
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+    fetchImpl?: typeof fetch;
+    autoFlushOnExit?: boolean;
+    disableTimer?: boolean;
+    /** Called when events are dropped due to queue overflow */
+    onEventsDropped?: (count: number) => void;
+    /** Multi-tab mode (browser only) */
+    multiTabMode?: "independent" | "leader";
+}
+interface TrackEvent {
+    idempotencyKey: string;
+    name: string;
+    userId?: string;
+    properties?: Record<string, unknown>;
+    timestamp: string;
+}
+interface SdkInfo {
+    name: string;
+    version: string;
+    runtime: string;
+}
+
+declare class Eventra {
+    private apiKey;
+    private endpoint;
+    private flushInterval;
+    private maxBatchSize;
+    private maxQueueSize;
+    private maxRetries;
+    private retryBaseDelay;
+    private multiTabMode;
+    private fetchImpl?;
+    private queue;
+    private timer?;
+    private inFlight;
+    private destroyed;
+    private droppedEvents;
+    private sdkInfo;
+    constructor(options: TrackerOptions);
+    private onEventsDropped?;
+    track(name: string, options?: {
+        userId?: string;
+        properties?: Record<string, unknown>;
+    }): void;
+    flush(): Promise<void>;
+    destroy(): void;
+    private trySendBeacon;
+    private send;
+    private detectRuntime;
+    private startTimer;
+    private setupExitHandlers;
+}
+
+export { Eventra, type SdkInfo, type TrackEvent, type TrackerOptions };

package/dist/index.js

@@ -0,0 +1,235 @@
+// src/client.ts
+var SDK_VERSION = "0.1.2";
+var DEFAULTS = {
+  endpoint: "http://api.eventra.dev/api/v1/ingest/batch",
+  flushInterval: 2e3,
+  maxBatchSize: 50,
+  maxQueueSize: 1e4,
+  maxRetries: 3,
+  retryBaseDelay: 300
+};
+function getGlobalFetch() {
+  if (typeof fetch !== "undefined") {
+    return fetch.bind(globalThis);
+  }
+  return void 0;
+}
+function generateUUIDv4() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  const rnd = Math.random().toString(16).slice(2);
+  const ts = Date.now().toString(16);
+  return `${ts}-${rnd}`;
+}
+function isBrowser() {
+  return typeof window !== "undefined";
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+var LEADER_KEY = "__eventra_sdk_leader__";
+var LEADER_TTL = 4e3;
+function tryBecomeLeader() {
+  if (!isBrowser()) return true;
+  try {
+    const now = Date.now();
+    const raw = localStorage.getItem(LEADER_KEY);
+    if (!raw) {
+      localStorage.setItem(
+        LEADER_KEY,
+        JSON.stringify({ ts: now })
+      );
+      return true;
+    }
+    const parsed = JSON.parse(raw);
+    if (now - parsed.ts > LEADER_TTL) {
+      localStorage.setItem(
+        LEADER_KEY,
+        JSON.stringify({ ts: now })
+      );
+      return true;
+    }
+    return false;
+  } catch {
+    return true;
+  }
+}
+var Eventra = class {
+  constructor(options) {
+    this.queue = [];
+    this.inFlight = false;
+    this.destroyed = false;
+    this.droppedEvents = 0;
+    if (!options.apiKey) {
+      throw new Error("Eventra: apiKey is required");
+    }
+    this.apiKey = options.apiKey;
+    this.endpoint = options.endpoint ?? DEFAULTS.endpoint ?? "";
+    if (!this.endpoint) {
+      throw new Error("Eventra: endpoint is not configured");
+    }
+    this.flushInterval = options.flushInterval ?? DEFAULTS.flushInterval;
+    this.maxBatchSize = options.maxBatchSize ?? DEFAULTS.maxBatchSize;
+    this.maxQueueSize = options.maxQueueSize ?? DEFAULTS.maxQueueSize;
+    this.maxRetries = options.maxRetries ?? DEFAULTS.maxRetries;
+    this.retryBaseDelay = options.retryBaseDelayMs ?? DEFAULTS.retryBaseDelay;
+    this.multiTabMode = options.multiTabMode ?? "independent";
+    this.fetchImpl = options.fetchImpl ?? getGlobalFetch();
+    if (!this.fetchImpl) {
+      throw new Error(
+        "Eventra: fetch is not available. Provide fetchImpl."
+      );
+    }
+    this.sdkInfo = {
+      name: "@eventra/sdk",
+      version: SDK_VERSION,
+      runtime: this.detectRuntime()
+    };
+    if (!options.disableTimer) {
+      this.startTimer();
+    }
+    if (options.autoFlushOnExit !== false) {
+      this.setupExitHandlers();
+    }
+    this.onEventsDropped = options.onEventsDropped;
+  }
+  /* ---------------- Public API ---------------- */
+  track(name, options) {
+    if (this.destroyed) return;
+    if (this.queue.length >= this.maxQueueSize) {
+      this.droppedEvents++;
+      this.onEventsDropped?.(this.droppedEvents);
+      return;
+    }
+    this.queue.push({
+      idempotencyKey: generateUUIDv4(),
+      name,
+      userId: options?.userId,
+      properties: options?.properties ?? {},
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    if (this.queue.length >= this.maxBatchSize) {
+      void this.flush();
+    }
+  }
+  async flush() {
+    if (this.destroyed) return;
+    if (this.inFlight) return;
+    if (this.queue.length === 0) return;
+    if (this.multiTabMode === "leader" && !tryBecomeLeader()) {
+      return;
+    }
+    this.inFlight = true;
+    const batch = this.queue.splice(0, this.queue.length);
+    try {
+      await this.send(batch);
+    } catch {
+      this.queue.unshift(...batch);
+    } finally {
+      this.inFlight = false;
+    }
+  }
+  destroy() {
+    this.destroyed = true;
+    if (this.timer) clearInterval(this.timer);
+  }
+  /* ---------------- Transport ---------------- */
+  trySendBeacon(payload) {
+    if (!isBrowser()) return false;
+    try {
+      if (navigator.sendBeacon) {
+        const blob = new Blob([payload], {
+          type: "application/json"
+        });
+        return navigator.sendBeacon(this.endpoint, blob);
+      }
+    } catch {
+    }
+    return false;
+  }
+  async send(events) {
+    const payload = JSON.stringify({
+      sentAt: (/* @__PURE__ */ new Date()).toISOString(),
+      sdk: this.sdkInfo,
+      events
+    });
+    if (isBrowser() && payload.length < 6e4 && document.visibilityState === "hidden") {
+      if (this.trySendBeacon(payload)) return;
+    }
+    let attempt = 0;
+    while (attempt <= this.maxRetries) {
+      try {
+        const res = await this.fetchImpl(this.endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-api-key": this.apiKey
+          },
+          body: payload
+        });
+        if (res.status >= 400 && res.status < 500) {
+          if (res.status === 401 || res.status === 403) {
+            console.error("Eventra: Invalid API key");
+          }
+          return;
+        }
+        if (!res.ok) {
+          throw new Error(`HTTP ${res.status}`);
+        }
+        return;
+      } catch (err) {
+        attempt++;
+        if (attempt > this.maxRetries) {
+          throw err;
+        }
+        const jitter = 0.5 + Math.random();
+        const delay = this.retryBaseDelay * 2 ** (attempt - 1) * jitter;
+        await sleep(delay);
+      }
+    }
+  }
+  /* ---------------- Runtime ---------------- */
+  detectRuntime() {
+    if (typeof window !== "undefined") return "browser";
+    const g = globalThis;
+    if (g["Deno"]) return "deno";
+    if (g["Bun"]) return "bun";
+    const maybeProcess = g["process"];
+    if (maybeProcess?.versions?.node) return "node";
+    return "unknown";
+  }
+  /* ---------------- Timer ---------------- */
+  startTimer() {
+    this.timer = setInterval(() => {
+      void this.flush();
+    }, this.flushInterval);
+  }
+  /* ---------------- Exit handling ---------------- */
+  setupExitHandlers() {
+    if (typeof window !== "undefined") {
+      window.addEventListener("visibilitychange", () => {
+        if (document.visibilityState === "hidden") {
+          void this.flush();
+        }
+      });
+    }
+    const g = globalThis;
+    const maybeProcess = g["process"];
+    if (typeof maybeProcess?.once === "function") {
+      const shutdown = async () => {
+        try {
+          await this.flush();
+        } catch {
+        }
+      };
+      maybeProcess.once("SIGINT", shutdown);
+      maybeProcess.once("SIGTERM", shutdown);
+      maybeProcess.once("beforeExit", shutdown);
+    }
+  }
+};
+export {
+  Eventra
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import {\n  TrackerOptions,\n  TrackEvent,\n  SdkInfo,\n} from \"./types\";\n\n/* ---------------- Constants ---------------- */\n\n\ndeclare const __SDK_VERSION__: string;\ndeclare const __EVENTRA_ENDPOINT__: string | undefined;\n\nconst SDK_VERSION = __SDK_VERSION__;\n\nconst DEFAULTS = {\n  endpoint: __EVENTRA_ENDPOINT__ ?? \"\",\n  flushInterval: 2000,\n  maxBatchSize: 50,\n  maxQueueSize: 10_000,\n  maxRetries: 3,\n  retryBaseDelay: 300,\n};\n\n/* ---------------- Helpers ---------------- */\n\nfunction getGlobalFetch(): typeof fetch | undefined {\n  if (typeof fetch !== \"undefined\") {\n    return fetch.bind(globalThis);\n  }\n  return undefined;\n}\n\nfunction generateUUIDv4(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return crypto.randomUUID();\n  }\n\n  // ultra-rare fallback (не должен происходить в нормальной среде)\n  const rnd = Math.random().toString(16).slice(2);\n  const ts = Date.now().toString(16);\n  return `${ts}-${rnd}`;\n}\n\nfunction isBrowser(): boolean {\n  return typeof window !== \"undefined\";\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((r) => setTimeout(r, ms));\n}\n\n/* ---------------- Leader Election (minimal) ---------------- */\n\nconst LEADER_KEY = \"__eventra_sdk_leader__\";\nconst LEADER_TTL = 4000;\n\nfunction tryBecomeLeader(): boolean {\n  if (!isBrowser()) return true;\n\n  try {\n    const now = Date.now();\n    const raw = localStorage.getItem(LEADER_KEY);\n\n    if (!raw) {\n      localStorage.setItem(\n        LEADER_KEY,\n        JSON.stringify({ ts: now })\n      );\n      return true;\n    }\n\n    const parsed = JSON.parse(raw) as { ts: number };\n\n    if (now - parsed.ts > LEADER_TTL) {\n      localStorage.setItem(\n        LEADER_KEY,\n        JSON.stringify({ ts: now })\n      );\n      return true;\n    }\n\n    return false;\n  } catch {\n    return true; // fail-open\n  }\n}\n\n/* ============================================================ */\n\nexport class Eventra {\n  private apiKey: string;\n  private endpoint: string;\n  private flushInterval: number;\n  private maxBatchSize: number;\n  private maxQueueSize: number;\n  private maxRetries: number;\n  private retryBaseDelay: number;\n  private multiTabMode: \"independent\" | \"leader\";\n\n  private fetchImpl?: typeof fetch;\n  private queue: TrackEvent[] = [];\n  private timer?: ReturnType<typeof setInterval>;\n  private inFlight = false;\n  private destroyed = false;\n  private droppedEvents = 0;\n\n  private sdkInfo: SdkInfo;\n\n  constructor(options: TrackerOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"Eventra: apiKey is required\");\n    }\n\n    this.apiKey = options.apiKey;\n\n    this.endpoint = options.endpoint ?? DEFAULTS.endpoint ?? \"\";\n    if (!this.endpoint) {\n      throw new Error(\"Eventra: endpoint is not configured\");\n    }\n\n    this.flushInterval =\n      options.flushInterval ?? DEFAULTS.flushInterval;\n\n    this.maxBatchSize =\n      options.maxBatchSize ?? DEFAULTS.maxBatchSize;\n\n    this.maxQueueSize =\n      options.maxQueueSize ?? DEFAULTS.maxQueueSize;\n\n    this.maxRetries =\n      options.maxRetries ?? DEFAULTS.maxRetries;\n\n    this.retryBaseDelay =\n      options.retryBaseDelayMs ?? DEFAULTS.retryBaseDelay;\n\n    this.multiTabMode =\n      options.multiTabMode ?? \"independent\";\n\n    this.fetchImpl =\n      options.fetchImpl ?? getGlobalFetch();\n\n    if (!this.fetchImpl) {\n      throw new Error(\n        \"Eventra: fetch is not available. Provide fetchImpl.\"\n      );\n    }\n\n    this.sdkInfo = {\n      name: \"@eventra/sdk\",\n      version: SDK_VERSION,\n      runtime: this.detectRuntime(),\n    };\n\n    if (!options.disableTimer) {\n      this.startTimer();\n    }\n\n    if (options.autoFlushOnExit !== false) {\n      this.setupExitHandlers();\n    }\n\n    this.onEventsDropped = options.onEventsDropped;\n  }\n\n  private onEventsDropped?: (count: number) => void;\n\n  /* ---------------- Public API ---------------- */\n\n  track(\n    name: string,\n    options?: {\n      userId?: string;\n      properties?: Record<string, unknown>;\n    }\n  ) {\n    if (this.destroyed) return;\n\n    if (this.queue.length >= this.maxQueueSize) {\n      this.droppedEvents++;\n      this.onEventsDropped?.(this.droppedEvents);\n      return;\n    }\n\n    this.queue.push({\n      idempotencyKey: generateUUIDv4(),\n      name,\n      userId: options?.userId,\n      properties: options?.properties ?? {},\n      timestamp: new Date().toISOString(),\n    });\n\n    if (this.queue.length >= this.maxBatchSize) {\n      void this.flush();\n    }\n  }\n\n  async flush(): Promise<void> {\n    if (this.destroyed) return;\n    if (this.inFlight) return;\n    if (this.queue.length === 0) return;\n\n    if (\n      this.multiTabMode === \"leader\" &&\n      !tryBecomeLeader()\n    ) {\n      return;\n    }\n\n    this.inFlight = true;\n\n    const batch = this.queue.splice(0, this.queue.length);\n\n    try {\n      await this.send(batch);\n    } catch {\n      this.queue.unshift(...batch);\n    } finally {\n      this.inFlight = false;\n    }\n  }\n\n  destroy() {\n    this.destroyed = true;\n    if (this.timer) clearInterval(this.timer);\n  }\n\n  /* ---------------- Transport ---------------- */\n\n  private trySendBeacon(payload: string): boolean {\n    if (!isBrowser()) return false;\n\n    try {\n      if (navigator.sendBeacon) {\n        const blob = new Blob([payload], {\n          type: \"application/json\",\n        });\n        return navigator.sendBeacon(this.endpoint, blob);\n      }\n    } catch {\n      // ignore\n    }\n\n    return false;\n  }\n\n  private async send(events: TrackEvent[]) {\n    const payload = JSON.stringify({\n      sentAt: new Date().toISOString(),\n      sdk: this.sdkInfo,\n      events,\n    });\n\n    // beacon fast-path (browser only)\n    if (\n      isBrowser() &&\n      payload.length < 60_000 &&\n      document.visibilityState === \"hidden\"\n    ) {\n      if (this.trySendBeacon(payload)) return;\n    }\n\n    let attempt = 0;\n\n    while (attempt <= this.maxRetries) {\n      try {\n        const res = await this.fetchImpl!(this.endpoint, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            \"x-api-key\": this.apiKey,\n          },\n          body: payload,\n        });\n\n        // ❗ DO NOT retry client errors\n        if (res.status >= 400 && res.status < 500) {\n          if (res.status === 401 || res.status === 403) {\n            console.error(\"Eventra: Invalid API key\");\n          }\n          return;\n        }\n\n        if (!res.ok) {\n          throw new Error(`HTTP ${res.status}`);\n        }\n\n        return;\n      } catch (err) {\n        attempt++;\n\n        if (attempt > this.maxRetries) {\n          throw err;\n        }\n\n        const jitter = 0.5 + Math.random(); // 0.5–1.5\n        const delay =\n          this.retryBaseDelay *\n          2 ** (attempt - 1) *\n          jitter;\n\n        await sleep(delay);\n      }\n    }\n  }\n\n  /* ---------------- Runtime ---------------- */\n\n  private detectRuntime(): string {\n    if (typeof window !== \"undefined\") return \"browser\";\n\n    const g = globalThis as Record<string, unknown>;\n\n    if (g[\"Deno\"]) return \"deno\";\n    if (g[\"Bun\"]) return \"bun\";\n\n    const maybeProcess = g[\"process\"] as\n      | { versions?: { node?: string } }\n      | undefined;\n\n    if (maybeProcess?.versions?.node) return \"node\";\n\n    return \"unknown\";\n  }\n\n  /* ---------------- Timer ---------------- */\n\n  private startTimer() {\n    this.timer = setInterval(() => {\n      void this.flush();\n    }, this.flushInterval);\n  }\n\n  /* ---------------- Exit handling ---------------- */\n\n  private setupExitHandlers() {\n    // browser\n    if (typeof window !== \"undefined\") {\n      window.addEventListener(\"visibilitychange\", () => {\n        if (document.visibilityState === \"hidden\") {\n          void this.flush();\n        }\n      });\n    }\n\n    // node\n    const g = globalThis as Record<string, unknown>;\n\n    const maybeProcess = g[\"process\"] as\n      | { once?: (event: string, cb: () => void) => void }\n      | undefined;\n\n    if (typeof maybeProcess?.once === \"function\") {\n      const shutdown = async () => {\n        try {\n          await this.flush();\n        } catch {}\n      };\n\n      maybeProcess.once(\"SIGINT\", shutdown);\n      maybeProcess.once(\"SIGTERM\", shutdown);\n      maybeProcess.once(\"beforeExit\", shutdown);\n    }\n  }\n}\n\nexport * from \"./types\";\n"],"mappings":";AAYA,IAAM,cAAc;AAEpB,IAAM,WAAW;AAAA,EACf,UAAU;AAAA,EACV,eAAe;AAAA,EACf,cAAc;AAAA,EACd,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,gBAAgB;AAClB;AAIA,SAAS,iBAA2C;AAClD,MAAI,OAAO,UAAU,aAAa;AAChC,WAAO,MAAM,KAAK,UAAU;AAAA,EAC9B;AACA,SAAO;AACT;AAEA,SAAS,iBAAyB;AAChC,MACE,OAAO,WAAW,eAClB,OAAO,OAAO,eAAe,YAC7B;AACA,WAAO,OAAO,WAAW;AAAA,EAC3B;AAGA,QAAM,MAAM,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC;AAC9C,QAAM,KAAK,KAAK,IAAI,EAAE,SAAS,EAAE;AACjC,SAAO,GAAG,EAAE,IAAI,GAAG;AACrB;AAEA,SAAS,YAAqB;AAC5B,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,MAAM,IAA2B;AACxC,SAAO,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC7C;AAIA,IAAM,aAAa;AACnB,IAAM,aAAa;AAEnB,SAAS,kBAA2B;AAClC,MAAI,CAAC,UAAU,EAAG,QAAO;AAEzB,MAAI;AACF,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,MAAM,aAAa,QAAQ,UAAU;AAE3C,QAAI,CAAC,KAAK;AACR,mBAAa;AAAA,QACX;AAAA,QACA,KAAK,UAAU,EAAE,IAAI,IAAI,CAAC;AAAA,MAC5B;AACA,aAAO;AAAA,IACT;AAEA,UAAM,SAAS,KAAK,MAAM,GAAG;AAE7B,QAAI,MAAM,OAAO,KAAK,YAAY;AAChC,mBAAa;AAAA,QACX;AAAA,QACA,KAAK,UAAU,EAAE,IAAI,IAAI,CAAC;AAAA,MAC5B;AACA,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAIO,IAAM,UAAN,MAAc;AAAA,EAmBnB,YAAY,SAAyB;AARrC,SAAQ,QAAsB,CAAC;AAE/B,SAAQ,WAAW;AACnB,SAAQ,YAAY;AACpB,SAAQ,gBAAgB;AAKtB,QAAI,CAAC,QAAQ,QAAQ;AACnB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AAEA,SAAK,SAAS,QAAQ;AAEtB,SAAK,WAAW,QAAQ,YAAY,SAAS,YAAY;AACzD,QAAI,CAAC,KAAK,UAAU;AAClB,YAAM,IAAI,MAAM,qCAAqC;AAAA,IACvD;AAEA,SAAK,gBACH,QAAQ,iBAAiB,SAAS;AAEpC,SAAK,eACH,QAAQ,gBAAgB,SAAS;AAEnC,SAAK,eACH,QAAQ,gBAAgB,SAAS;AAEnC,SAAK,aACH,QAAQ,cAAc,SAAS;AAEjC,SAAK,iBACH,QAAQ,oBAAoB,SAAS;AAEvC,SAAK,eACH,QAAQ,gBAAgB;AAE1B,SAAK,YACH,QAAQ,aAAa,eAAe;AAEtC,QAAI,CAAC,KAAK,WAAW;AACnB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,SAAK,UAAU;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,MACT,SAAS,KAAK,cAAc;AAAA,IAC9B;AAEA,QAAI,CAAC,QAAQ,cAAc;AACzB,WAAK,WAAW;AAAA,IAClB;AAEA,QAAI,QAAQ,oBAAoB,OAAO;AACrC,WAAK,kBAAkB;AAAA,IACzB;AAEA,SAAK,kBAAkB,QAAQ;AAAA,EACjC;AAAA;AAAA,EAMA,MACE,MACA,SAIA;AACA,QAAI,KAAK,UAAW;AAEpB,QAAI,KAAK,MAAM,UAAU,KAAK,cAAc;AAC1C,WAAK;AACL,WAAK,kBAAkB,KAAK,aAAa;AACzC;AAAA,IACF;AAEA,SAAK,MAAM,KAAK;AAAA,MACd,gBAAgB,eAAe;AAAA,MAC/B;AAAA,MACA,QAAQ,SAAS;AAAA,MACjB,YAAY,SAAS,cAAc,CAAC;AAAA,MACpC,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,CAAC;AAED,QAAI,KAAK,MAAM,UAAU,KAAK,cAAc;AAC1C,WAAK,KAAK,MAAM;AAAA,IAClB;AAAA,EACF;AAAA,EAEA,MAAM,QAAuB;AAC3B,QAAI,KAAK,UAAW;AACpB,QAAI,KAAK,SAAU;AACnB,QAAI,KAAK,MAAM,WAAW,EAAG;AAE7B,QACE,KAAK,iBAAiB,YACtB,CAAC,gBAAgB,GACjB;AACA;AAAA,IACF;AAEA,SAAK,WAAW;AAEhB,UAAM,QAAQ,KAAK,MAAM,OAAO,GAAG,KAAK,MAAM,MAAM;AAEpD,QAAI;AACF,YAAM,KAAK,KAAK,KAAK;AAAA,IACvB,QAAQ;AACN,WAAK,MAAM,QAAQ,GAAG,KAAK;AAAA,IAC7B,UAAE;AACA,WAAK,WAAW;AAAA,IAClB;AAAA,EACF;AAAA,EAEA,UAAU;AACR,SAAK,YAAY;AACjB,QAAI,KAAK,MAAO,eAAc,KAAK,KAAK;AAAA,EAC1C;AAAA;AAAA,EAIQ,cAAc,SAA0B;AAC9C,QAAI,CAAC,UAAU,EAAG,QAAO;AAEzB,QAAI;AACF,UAAI,UAAU,YAAY;AACxB,cAAM,OAAO,IAAI,KAAK,CAAC,OAAO,GAAG;AAAA,UAC/B,MAAM;AAAA,QACR,CAAC;AACD,eAAO,UAAU,WAAW,KAAK,UAAU,IAAI;AAAA,MACjD;AAAA,IACF,QAAQ;AAAA,IAER;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,KAAK,QAAsB;AACvC,UAAM,UAAU,KAAK,UAAU;AAAA,MAC7B,SAAQ,oBAAI,KAAK,GAAE,YAAY;AAAA,MAC/B,KAAK,KAAK;AAAA,MACV;AAAA,IACF,CAAC;AAGD,QACE,UAAU,KACV,QAAQ,SAAS,OACjB,SAAS,oBAAoB,UAC7B;AACA,UAAI,KAAK,cAAc,OAAO,EAAG;AAAA,IACnC;AAEA,QAAI,UAAU;AAEd,WAAO,WAAW,KAAK,YAAY;AACjC,UAAI;AACF,cAAM,MAAM,MAAM,KAAK,UAAW,KAAK,UAAU;AAAA,UAC/C,QAAQ;AAAA,UACR,SAAS;AAAA,YACP,gBAAgB;AAAA,YAChB,aAAa,KAAK;AAAA,UACpB;AAAA,UACA,MAAM;AAAA,QACR,CAAC;AAGD,YAAI,IAAI,UAAU,OAAO,IAAI,SAAS,KAAK;AACzC,cAAI,IAAI,WAAW,OAAO,IAAI,WAAW,KAAK;AAC5C,oBAAQ,MAAM,0BAA0B;AAAA,UAC1C;AACA;AAAA,QACF;AAEA,YAAI,CAAC,IAAI,IAAI;AACX,gBAAM,IAAI,MAAM,QAAQ,IAAI,MAAM,EAAE;AAAA,QACtC;AAEA;AAAA,MACF,SAAS,KAAK;AACZ;AAEA,YAAI,UAAU,KAAK,YAAY;AAC7B,gBAAM;AAAA,QACR;AAEA,cAAM,SAAS,MAAM,KAAK,OAAO;AACjC,cAAM,QACJ,KAAK,iBACL,MAAM,UAAU,KAChB;AAEF,cAAM,MAAM,KAAK;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIQ,gBAAwB;AAC9B,QAAI,OAAO,WAAW,YAAa,QAAO;AAE1C,UAAM,IAAI;AAEV,QAAI,EAAE,MAAM,EAAG,QAAO;AACtB,QAAI,EAAE,KAAK,EAAG,QAAO;AAErB,UAAM,eAAe,EAAE,SAAS;AAIhC,QAAI,cAAc,UAAU,KAAM,QAAO;AAEzC,WAAO;AAAA,EACT;AAAA;AAAA,EAIQ,aAAa;AACnB,SAAK,QAAQ,YAAY,MAAM;AAC7B,WAAK,KAAK,MAAM;AAAA,IAClB,GAAG,KAAK,aAAa;AAAA,EACvB;AAAA;AAAA,EAIQ,oBAAoB;AAE1B,QAAI,OAAO,WAAW,aAAa;AACjC,aAAO,iBAAiB,oBAAoB,MAAM;AAChD,YAAI,SAAS,oBAAoB,UAAU;AACzC,eAAK,KAAK,MAAM;AAAA,QAClB;AAAA,MACF,CAAC;AAAA,IACH;AAGA,UAAM,IAAI;AAEV,UAAM,eAAe,EAAE,SAAS;AAIhC,QAAI,OAAO,cAAc,SAAS,YAAY;AAC5C,YAAM,WAAW,YAAY;AAC3B,YAAI;AACF,gBAAM,KAAK,MAAM;AAAA,QACnB,QAAQ;AAAA,QAAC;AAAA,MACX;AAEA,mBAAa,KAAK,UAAU,QAAQ;AACpC,mBAAa,KAAK,WAAW,QAAQ;AACrC,mBAAa,KAAK,cAAc,QAAQ;AAAA,IAC1C;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@eventra_dev/eventra-sdk",
+  "version": "0.1.2",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/and-1991/eventra-sdk"
+  },
+  "homepage": "https://eventra.dev",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}