@eventra_dev/eventra-sdk 0.1.9 → 0.1.11

package/README.md

@@ -6,6 +6,14 @@
 
 Eventra SDK allows you to send **feature usage and product analytics events** to the Eventra platform.
 
+Eventra helps you:
+
+- Track feature adoption
+- Detect unused features
+- Understand user behavior
+- Monitor backend usage
+- Analyze product growth
+
 It is designed to be:
 
 * lightweight
@@ -54,6 +62,94 @@ tracker.track("checkout.completed", {
 });
 ```
 
+That's it. Events are automatically:
+
+- batched
+- retried
+- flushed
+
+---
+
+# Event Properties
+
+Eventra allows you to pass **optional properties** with every event.
+
+Properties are completely flexible — you can send **any JSON-compatible data**.
+
+```ts
+tracker.track("checkout.completed", {
+  userId: "user_123",
+  properties: {
+    plan: "pro",
+    price: 29,
+    currency: "USD"
+  }
+});
+```
+
+Properties are optional:
+
+```ts
+tracker.track("app.loaded");
+```
+
+Or with userId only:
+
+```ts
+tracker.track("user.login", {
+  userId: "user_123"
+});
+```
+
+---
+
+# Common Examples
+
+## Feature Usage
+
+```ts
+tracker.track("feature.used", {
+  userId: "user_123",
+  properties: {
+    feature: "dashboard",
+    section: "analytics"
+  }
+});
+```
+
+## Page View
+
+```ts
+tracker.track("page.viewed", {
+  properties: {
+    path: window.location.pathname
+  }
+});
+```
+
+## API Usage
+
+```ts
+tracker.track("api.request", {
+  properties: {
+    endpoint: "/checkout",
+    method: "POST",
+    status: 200
+  }
+});
+```
+
+## Error Tracking
+
+```ts
+tracker.track("error.occurred", {
+  properties: {
+    message: "Payment failed",
+    code: "PAYMENT_ERROR"
+  }
+});
+```
+
 ---
 
 # Where You Can Use Eventra SDK
@@ -208,8 +304,6 @@ app.post("/checkout", (req, res) => {
 
 # Vanilla JavaScript (CDN)
 
-You can use Eventra without a bundler.
-
 ```html
 <script type="module">
 
@@ -228,8 +322,6 @@ tracker.track("page.viewed");
 
 # Configuration
 
-You can configure the SDK behaviour.
-
 ```ts
 const eventra = new Eventra({
 
@@ -261,8 +353,6 @@ const eventra = new Eventra({
 
 # Multi-Tab Mode (Browser)
 
-To avoid duplicate event sending across multiple tabs:
-
 ```ts
 const tracker = new Eventra({
   apiKey: "YOUR_PROJECT_API_KEY",
@@ -314,7 +404,7 @@ Events are sent in batches:
   "sentAt": "2026-03-12T10:00:00Z",
   "sdk": {
     "name": "@eventra_dev/eventra-sdk",
-    "version": "0.1.9",
+    "version": "0.1.10",
     "runtime": "node"
   },
   "events": [
@@ -330,14 +420,6 @@ Events are sent in batches:
 
 ---
 
-# Error Handling
-
-Client errors (4xx) are **not retried**.
-
-Server errors (5xx) are retried using **exponential backoff**.
-
----
-
 # Documentation
 
 Full documentation:

package/dist/index.cjs

@@ -25,9 +25,9 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
-var SDK_VERSION = "0.1.9";
+var SDK_VERSION = "0.1.11";
 var DEFAULTS = {
-  endpoint: "http://api.eventra.dev/api/v1/ingest/batch",
+  endpoint: "https://api.eventra.dev/api/v1/ingest/batch",
   flushInterval: 2e3,
   maxBatchSize: 50,
   maxQueueSize: 1e4,

package/dist/index.mjs

@@ -1,7 +1,7 @@
 // src/client.ts
-var SDK_VERSION = "0.1.9";
+var SDK_VERSION = "0.1.11";
 var DEFAULTS = {
-  endpoint: "http://api.eventra.dev/api/v1/ingest/batch",
+  endpoint: "https://api.eventra.dev/api/v1/ingest/batch",
   flushInterval: 2e3,
   maxBatchSize: 50,
   maxQueueSize: 1e4,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventra_dev/eventra-sdk",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "private": false,
   "publishConfig": {
     "access": "public"