@eventra_dev/eventra-sdk 1.1.4 → 1.2.0

package/README.md

@@ -4,10 +4,16 @@
 
 # Eventra SDK
 
-[![npm version](https://img.shields.io/npm/v/@eventra_dev/eventra-sdk.svg)](https://www.npmjs.com/package/@eventra_dev/eventra-sdk)
-[![npm downloads](https://img.shields.io/npm/dm/@eventra_dev/eventra-sdk.svg)](https://www.npmjs.com/package/@eventra_dev/eventra-sdk)
-[![TypeScript](https://img.shields.io/badge/typescript-ready-blue.svg)](https://www.typescriptlang.org/)
-[![License](https://img.shields.io/npm/l/@eventra_dev/eventra-sdk)]()
+<p align="center">
+  <a href="https://www.npmjs.com/package/@eventra_dev/eventra-sdk"><img alt="npm version" src="https://img.shields.io/npm/v/@eventra_dev/eventra-sdk.svg?style=flat-square&color=blue"></a>
+  <a href="https://www.npmjs.com/package/@eventra_dev/eventra-sdk"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@eventra_dev/eventra-sdk.svg?style=flat-square&color=blue"></a>
+  <a href="https://github.com/and-1991/eventra-sdk/actions/workflows/test.yml"><img alt="tests" src="https://img.shields.io/github/actions/workflow/status/and-1991/eventra-sdk/test.yml?branch=main&label=tests&style=flat-square&logo=vitest&logoColor=white"></a>
+  <img alt="tests passing" src="https://img.shields.io/badge/tests-41%20passing-brightgreen?style=flat-square&logo=vitest&logoColor=white">
+  <img alt="test suites" src="https://img.shields.io/badge/suites-8-brightgreen?style=flat-square">
+  <img alt="node" src="https://img.shields.io/node/v/@eventra_dev/eventra-sdk?style=flat-square&color=darkgreen&logo=node.js&logoColor=white">
+  <a href="https://www.typescriptlang.org/"><img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-ready-blue?style=flat-square&logo=typescript&logoColor=white"></a>
+  <img alt="license" src="https://img.shields.io/npm/l/@eventra_dev/eventra-sdk?style=flat-square&color=lightgrey">
+</p>
 
 Production-grade analytics SDK for tracking **feature usage, product behavior, and backend activity**.
 
@@ -354,6 +360,28 @@ Eventra SDK includes:
 
 ---
 
+## Test Coverage
+
+41 vitest tests across 8 suites cover the entire delivery pipeline:
+
+- `track()` validation — name length, userId truncation, properties depth/size, idempotency keys
+- Batching — auto-flush at `maxBatchSize`, periodic flush via timer, queue overflow drop
+- Retry & backoff — 429, 5xx, network errors, no-retry on 4xx
+- Circuit breaker — opens after 5 consecutive failures, cools down, resets on success
+- Payload guards — multi-batch splitting, oversize event dropped via `onDeliveryFailed(413)`
+- Shutdown & destroy — flush ordering, timer teardown, idempotent shutdown
+- Runtime detection — Node, Edge (`EdgeRuntime`), Serverless (AWS Lambda)
+- Browser mode — persistence, leader election, BroadcastChannel sync, `fetch` keepalive, `pagehide`
+
+Run locally:
+
+```bash
+pnpm --filter @eventra_dev/eventra-sdk test
+pnpm --filter @eventra_dev/eventra-sdk test:coverage
+```
+
+---
+
 ## Event Format
 
 ```json
@@ -361,7 +389,7 @@ Eventra SDK includes:
   "sentAt": "2026-03-12T10:00:00Z",
   "sdk": {
     "name": "@eventra_dev/eventra-sdk",
-    "version": "1.1.3",
+    "version": "<sdk-version>",
     "runtime": "browser"
   },
   "events": [
@@ -376,6 +404,18 @@ Eventra SDK includes:
 }
 ```
 
+Limits enforced by the SDK at `track()` time:
+
+| Field | Limit |
+|-------|-------|
+| `name` | trimmed, ≤ 64 chars |
+| `userId` | ≤ 120 chars |
+| `properties` (JSON serialized) | ≤ 32,000 bytes per event |
+| Property nesting depth | ≤ 8 |
+| Batch payload | ≤ `maxPayloadBytes` (default 60,000) |
+| Fetch timeout | 5,000 ms |
+| Circuit breaker | opens after 5 consecutive failures, cools down 5,000 ms |
+
 ---
 
 ## Docs

package/dist/index.cjs

@@ -27,7 +27,7 @@ module.exports = __toCommonJS(index_exports);
 // src/client.ts
 var SDK_NAME = "@eventra_dev/eventra-sdk";
 var DEFAULT_ENDPOINT = "https://api.eventra.dev/api/v1/ingest/batch";
-var SDK_VERSION = "1.1.4";
+var SDK_VERSION = "1.2.0";
 var LEADER_KEY = "__eventra_leader__";
 var LEADER_TTL_MS = 4e3;
 var QUEUE_KEY = "__eventra_q__";

package/dist/index.mjs

@@ -1,7 +1,7 @@
 // src/client.ts
 var SDK_NAME = "@eventra_dev/eventra-sdk";
 var DEFAULT_ENDPOINT = "https://api.eventra.dev/api/v1/ingest/batch";
-var SDK_VERSION = "1.1.4";
+var SDK_VERSION = "1.2.0";
 var LEADER_KEY = "__eventra_leader__";
 var LEADER_TTL_MS = 4e3;
 var QUEUE_KEY = "__eventra_q__";

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@eventra_dev/eventra-sdk",
-  "version": "1.1.4",
+  "version": "1.2.0",
+  "description": "Production-grade analytics SDK for feature usage and product behavior — batching, retries, circuit breaker, runtime-aware (browser, Node, Edge, serverless).",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -21,7 +22,10 @@
   "sideEffects": false,
   "scripts": {
     "build": "tsup",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "repository": {
     "type": "git",
@@ -29,11 +33,43 @@
   },
   "homepage": "https://eventra.dev",
   "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.7",
     "tsup": "^8.0.0",
-    "typescript": "^5.6.0"
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.7"
   },
   "license": "MIT",
   "engines": {
     "node": ">=18"
-  }
+  },
+  "keywords": [
+    "analytics",
+    "analytics-sdk",
+    "event-tracking",
+    "feature-usage",
+    "feature-tracking",
+    "product-analytics",
+    "telemetry",
+    "metrics",
+    "tracking",
+    "events",
+    "ingest",
+    "batching",
+    "retry",
+    "circuit-breaker",
+    "idempotency",
+    "browser",
+    "nodejs",
+    "edge",
+    "serverless",
+    "vercel",
+    "aws-lambda",
+    "cloudflare-workers",
+    "typescript",
+    "typescript-first",
+    "esm",
+    "cjs",
+    "eventra",
+    "eventra-sdk"
+  ]
 }