@traffical/node 0.5.0 → 0.5.1

package/README.md

@@ -148,6 +148,59 @@ const context: Context = {
 const decision: DecisionResult = await client.decide(context);
 ```
 
+## Type-Safe Event Tracking
+
+Use `@traffical/cli generate-types` to generate TypeScript interfaces for your event schemas. This lets you create a strictly typed `track` wrapper that catches invalid event names and properties at compile time.
+
+### 1. Generate types
+
+```bash
+bunx @traffical/cli generate-types
+```
+
+### 2. Create a typed wrapper
+
+```typescript
+import type { TrafficalEventProperties } from './traffical.generated';
+import { TrafficalClient } from '@traffical/node';
+
+type TypedTrack = <E extends Extract<keyof TrafficalEventProperties, string>>(
+  event: E,
+  options: {
+    decisionId: string;
+    unitKey: string;
+    properties?: TrafficalEventProperties[E];
+  }
+) => Promise<void>;
+
+const client = new TrafficalClient({ apiKey: 'sk_...' });
+export const track = client.track.bind(client) as unknown as TypedTrack;
+```
+
+### 3. Use it
+
+```typescript
+await track('purchase', {
+  decisionId: decision.decisionId,
+  unitKey: 'user-123',
+  properties: {
+    order_total: 99.99,
+    payment_method: 'visa',
+  },
+}); // ✅
+
+await track('purchase', {
+  decisionId: decision.decisionId,
+  unitKey: 'user-123',
+  properties: {
+    order_total: 99.99,
+    unknown_field: true, // ❌ Type error
+  },
+});
+```
+
+---
+
 ## License
 
 MIT

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "0.5.0";
+export declare const SDK_VERSION = "0.5.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 // Auto-generated from package.json — do not edit manually.
-export const SDK_VERSION = "0.5.0";
+export const SDK_VERSION = "0.5.1";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@traffical/node",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Traffical SDK for Node.js - HTTP client with caching and event tracking",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,8 +23,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@traffical/core": "0.6.0",
-    "@traffical/core-io": "0.5.0"
+    "@traffical/core": "0.7.0",
+    "@traffical/core-io": "0.5.1"
   },
   "devDependencies": {
     "@types/bun": "latest",