@axxel/event-bus 1.0.5 → 1.0.7

package/README.md

@@ -40,7 +40,12 @@ KAFKA_BROKER="localhost:9092"
 ### 1️⃣ Producing messages
 
 ```ts
-import { produceTokenPrice, produceWalletTransaction } from '@axxel/event-bus';
+import {
+  produceTokenPrice,
+  produceWalletTransaction,
+  ensureTokenPriceEvent,
+  ensureWalletTransactionEvent,
+} from '@axxel/event-bus';
 
 await produceTokenPrice({
   chainId: 1,
@@ -49,7 +54,8 @@ await produceTokenPrice({
   price: {
     USD: { price: 3250.42, exchange: 'uniswap-v3', liquidity: 1250000 },
   },
-  marketcap: 1234567890,
+  priceUsd: 3250.42,
+  fdv: 1234567890,
   symbol: 'WETH',
   updatedAt: Math.floor(Date.now() / 1000),
 });
@@ -71,6 +77,19 @@ await produceWalletTransaction({
   marketcap: 500000000,
   totalSupply: 1000000,
 });
+
+// Optional: validate and normalize before producing
+const safePricePayload = ensureTokenPriceEvent({
+  chainId: 1,
+  tokenAddress: '0xC02a...',
+  blockNumber: 21345678,
+  price: new Map([
+    ['USD', { price: 3250.42, exchange: 'uniswap-v3', liquidity: 1250000 }],
+  ]),
+  priceUsd: 3250.42,
+  fdv: 1234567890,
+});
+await produceTokenPrice(safePricePayload);
 ```
 
 ---
@@ -89,7 +108,9 @@ await startTokenPriceConsumer('limit-orders', async (priceEvent) => {
       ? priceEvent.price.get('USD')
       : priceEvent.price['USD'];
   console.log(
-    `📈 ${priceEvent.symbol ?? priceEvent.tokenAddress} @ $${usdInfo?.price ?? 'n/a'} (chain ${priceEvent.chainId})`,
+    `📈 ${priceEvent.symbol ?? priceEvent.tokenAddress} @ $${
+      usdInfo?.price ?? 'n/a'
+    } (chain ${priceEvent.chainId})`,
   );
 });
 
@@ -107,8 +128,8 @@ Multiple instances with the same group ID will automatically load-balance partit
 
 ## 🧠 Topics Overview
 
-| Topic                 | Description                                | Partition Key  |
-| --------------------- | ------------------------------------------ | -------------- |
+| Topic                 | Description                                | Partition Key           |
+| --------------------- | ------------------------------------------ | ----------------------- |
 | `token-prices`        | Live token price updates across all chains | `chainId:tokenAddress`  |
 | `wallet-transactions` | Wallet buy/sell/transfer events            | `chainId:walletAddress` |
 
@@ -126,7 +147,8 @@ interface TokenPriceEvent {
   tokenAddress: string;
   blockNumber: number;
   price: Record<string, PriceInfo> | Map<string, PriceInfo>;
-  marketcap?: number | null;
+  priceUsd?: number | null;
+  fdv?: number | null;
   symbol?: string | null;
   updatedAt?: number;
 }
@@ -154,6 +176,22 @@ interface WalletTransactionEvent {
 }
 ```
 
+### Runtime validation helpers
+
+Shared Zod schemas are exported to normalize inputs consistently:
+
+```ts
+import {
+  ensureTokenPriceEvent,
+  ensureWalletTransactionEvent,
+} from '@axxel/event-bus';
+
+const normalizedPrice = ensureTokenPriceEvent(rawPricePayload);
+const normalizedTx = ensureWalletTransactionEvent(rawTxPayload);
+```
+
+`ensureTokenPriceEvent` accepts either a `Record` or `Map` for `price`, and both helpers lowercase EVM addresses / tx hashes while rejecting malformed numeric fields.
+
 ---
 
 ## ⚙️ Environment Variables

package/dist/types/TokenPriceEvent.d.ts

@@ -8,7 +8,8 @@ export interface TokenPriceEvent {
     tokenAddress: string;
     blockNumber: number;
     price: Record<string, PriceInfo> | Map<string, PriceInfo>;
-    marketcap?: number | null;
+    priceUsd?: number | null;
+    fdv?: number | null;
     symbol?: string | null;
     updatedAt?: number;
 }

package/dist/types/TokenPriceEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenPriceEvent.d.ts","sourceRoot":"","sources":["../../src/types/TokenPriceEvent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IAEpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"TokenPriceEvent.d.ts","sourceRoot":"","sources":["../../src/types/TokenPriceEvent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IAEpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/validation/tokenPriceEvent.schema.d.ts

@@ -8,7 +8,8 @@ export declare const tokenPriceEventSchema: z.ZodObject<{
         exchange: z.ZodString;
         liquidity: z.ZodNumber;
     }, z.core.$strip>>>>;
-    marketcap: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    priceUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    fdv: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     symbol: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     updatedAt: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;

package/dist/validation/tokenPriceEvent.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenPriceEvent.schema.d.ts","sourceRoot":"","sources":["../../src/validation/tokenPriceEvent.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiDxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAQhC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAE3E"}
+{"version":3,"file":"tokenPriceEvent.schema.d.ts","sourceRoot":"","sources":["../../src/validation/tokenPriceEvent.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiDxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;iBAShC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAE3E"}

package/dist/validation/tokenPriceEvent.schema.js

@@ -42,7 +42,8 @@ exports.tokenPriceEventSchema = zod_1.z.object({
     tokenAddress: common_1.addressSchema,
     blockNumber: zod_1.z.number().int().min(0),
     price: priceRecordSchema,
-    marketcap: zod_1.z.number().nullable().optional(),
+    priceUsd: zod_1.z.number().nullable().optional(),
+    fdv: zod_1.z.number().nullable().optional(),
     symbol: zod_1.z.string().nullable().optional(),
     updatedAt: zod_1.z.number().int().min(0).optional(),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axxel/event-bus",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Axxel Kafka Event Bus SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,4 +36,4 @@
     "tsx": "^4.20.6",
     "typescript": "^5.9.3"
   }
-}
+}