@eventra_dev/eventra-sdk 0.1.10 → 1.0.1

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",
@@ -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 → index.js}

@@ -25,7 +25,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
-var SDK_VERSION = "0.1.10";
+var SDK_VERSION = "1.0.1";
 var DEFAULTS = {
   endpoint: "https://api.eventra.dev/api/v1/ingest/batch",
   flushInterval: 2e3,
@@ -259,4 +259,4 @@ var Eventra = class {
 0 && (module.exports = {
   Eventra
 });
-//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.js.map

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/client.ts
-var SDK_VERSION = "0.1.10";
+var SDK_VERSION = "1.0.1";
 var DEFAULTS = {
   endpoint: "https://api.eventra.dev/api/v1/ingest/batch",
   flushInterval: 2e3,

package/package.json

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