@axxel/event-bus 1.0.6 → 1.0.8

package/README.md

@@ -54,8 +54,8 @@ await produceTokenPrice({
   price: {
     USD: { price: 3250.42, exchange: 'uniswap-v3', liquidity: 1250000 },
   },
-  priceInUsd: 3250.42,
-  fdvInUsd: 1234567890,
+  priceUsd: 3250.42,
+  fdv: 1234567890,
   symbol: 'WETH',
   updatedAt: Math.floor(Date.now() / 1000),
 });
@@ -86,8 +86,8 @@ const safePricePayload = ensureTokenPriceEvent({
   price: new Map([
     ['USD', { price: 3250.42, exchange: 'uniswap-v3', liquidity: 1250000 }],
   ]),
-  priceInUsd: 3250.42,
-  fdvInUsd: 1234567890,
+  priceUsd: 3250.42,
+  fdv: 1234567890,
 });
 await produceTokenPrice(safePricePayload);
 ```
@@ -108,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})`,
   );
 });
 
@@ -126,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` |
 
@@ -145,8 +147,8 @@ interface TokenPriceEvent {
   tokenAddress: string;
   blockNumber: number;
   price: Record<string, PriceInfo> | Map<string, PriceInfo>;
-  priceInUsd?: number | null;
-  fdvInUsd?: number | null;
+  priceUsd?: number | null;
+  fdv?: number | null;
   symbol?: string | null;
   updatedAt?: number;
 }
@@ -179,7 +181,10 @@ interface WalletTransactionEvent {
 Shared Zod schemas are exported to normalize inputs consistently:
 
 ```ts
-import { ensureTokenPriceEvent, ensureWalletTransactionEvent } from '@axxel/event-bus';
+import {
+  ensureTokenPriceEvent,
+  ensureWalletTransactionEvent,
+} from '@axxel/event-bus';
 
 const normalizedPrice = ensureTokenPriceEvent(rawPricePayload);
 const normalizedTx = ensureWalletTransactionEvent(rawTxPayload);

package/dist/consumers/index.d.ts

@@ -1,4 +1,5 @@
 export * from './tokenPriceConsumer';
 export * from './walletTransactionConsumer';
 export * from './tradeExecutionConsumer';
+export * from './poolCreatedConsumer';
 //# sourceMappingURL=index.d.ts.map

package/dist/consumers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consumers/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consumers/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/consumers/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./tokenPriceConsumer"), exports);
 __exportStar(require("./walletTransactionConsumer"), exports);
 __exportStar(require("./tradeExecutionConsumer"), exports);
+__exportStar(require("./poolCreatedConsumer"), exports);

package/dist/consumers/poolCreatedConsumer.d.ts

@@ -0,0 +1,8 @@
+import type { PoolCreatedEvent } from '../types/PoolCreatedEvent';
+/**
+ * Start consuming pool created events.
+ * @param groupId - unique consumer group ID
+ * @param handler - function to handle each pool created event
+ */
+export declare function startPoolCreatedConsumer(groupId: string, handler: (event: PoolCreatedEvent) => Promise<void> | void): Promise<void>;
+//# sourceMappingURL=poolCreatedConsumer.d.ts.map

package/dist/consumers/poolCreatedConsumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poolCreatedConsumer.d.ts","sourceRoot":"","sources":["../../src/consumers/poolCreatedConsumer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,iBAuB3D"}

package/dist/consumers/poolCreatedConsumer.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startPoolCreatedConsumer = startPoolCreatedConsumer;
+const kafka_1 = require("../config/kafka");
+const topics_1 = require("../topics");
+/**
+ * Start consuming pool created events.
+ * @param groupId - unique consumer group ID
+ * @param handler - function to handle each pool created event
+ */
+async function startPoolCreatedConsumer(groupId, handler) {
+    const consumer = kafka_1.kafka.consumer({ groupId });
+    await consumer.connect();
+    await consumer.subscribe({
+        topic: topics_1.TOPICS.POOL_CREATED,
+        fromBeginning: false,
+    });
+    await consumer.run({
+        eachMessage: async ({ message }) => {
+            if (!message.value)
+                return;
+            const event = JSON.parse(message.value.toString());
+            await handler(event);
+        },
+    });
+    console.log(`📡 Listening for pool created events (consumer group: ${groupId})`);
+}

package/dist/producers/index.d.ts

@@ -1,4 +1,5 @@
 export * from './tokenPriceProducer';
 export * from './walletTransactionProducer';
 export * from './tradeExecutionProducer';
+export * from './poolCreatedProducer';
 //# sourceMappingURL=index.d.ts.map

package/dist/producers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/producers/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/producers/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/producers/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./tokenPriceProducer"), exports);
 __exportStar(require("./walletTransactionProducer"), exports);
 __exportStar(require("./tradeExecutionProducer"), exports);
+__exportStar(require("./poolCreatedProducer"), exports);

package/dist/producers/poolCreatedProducer.d.ts

@@ -0,0 +1,3 @@
+import type { PoolCreatedEvent } from '../types/PoolCreatedEvent';
+export declare function producePoolCreated(event: PoolCreatedEvent): Promise<void>;
+//# sourceMappingURL=poolCreatedProducer.d.ts.map

package/dist/producers/poolCreatedProducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poolCreatedProducer.d.ts","sourceRoot":"","sources":["../../src/producers/poolCreatedProducer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,iBAqB/D"}

package/dist/producers/poolCreatedProducer.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.producePoolCreated = producePoolCreated;
+const kafka_1 = require("../config/kafka");
+const topics_1 = require("../topics");
+async function producePoolCreated(event) {
+    const producer = kafka_1.kafka.producer();
+    await producer.connect();
+    const key = `${event.chainId}:${event.factoryAddress}`;
+    await producer.send({
+        topic: topics_1.TOPICS.POOL_CREATED,
+        messages: [
+            {
+                key,
+                value: JSON.stringify(event),
+            },
+        ],
+    });
+    await producer.disconnect();
+    console.log(`✅ Pool created event published | chain=${event.chainId} | pool=${event.address}`);
+}

package/dist/topics.d.ts

@@ -2,6 +2,7 @@ export declare const TOPICS: {
     readonly TOKEN_PRICES: "token-prices";
     readonly WALLET_TRANSACTIONS: "wallet-transactions";
     readonly TRADE_EXECUTION: "trade-execution";
+    readonly POOL_CREATED: "pool-created";
 };
 export type Topic = (typeof TOPICS)[keyof typeof TOPICS];
 //# sourceMappingURL=topics.d.ts.map

package/dist/topics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../src/topics.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC"}
+{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../src/topics.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC"}

package/dist/topics.js

@@ -5,4 +5,5 @@ exports.TOPICS = {
     TOKEN_PRICES: 'token-prices',
     WALLET_TRANSACTIONS: 'wallet-transactions',
     TRADE_EXECUTION: 'trade-execution',
+    POOL_CREATED: 'pool-created',
 };

package/dist/types/PoolCreatedEvent.d.ts

@@ -0,0 +1,17 @@
+export type PoolCreatedEvent = {
+    address: string;
+    createdBlock: number | null;
+    chainId: number;
+    factoryAddress: string;
+    exchangeName: string;
+    protocol: string;
+    token0Address: string;
+    token0Symbol: string;
+    token0Decimals: number;
+    token1Address: string;
+    token1Symbol: string;
+    token1Decimals: number;
+    fee: string | null;
+    tickSpacing: number | null;
+};
+//# sourceMappingURL=PoolCreatedEvent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PoolCreatedEvent.d.ts","sourceRoot":"","sources":["../../src/types/PoolCreatedEvent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IAEvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IAEvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC"}

package/dist/types/PoolCreatedEvent.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/TokenPriceEvent.d.ts

@@ -8,8 +8,8 @@ export interface TokenPriceEvent {
     tokenAddress: string;
     blockNumber: number;
     price: Record<string, PriceInfo> | Map<string, PriceInfo>;
-    priceInUsd?: number | null;
-    fdvInUsd?: 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,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,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/types/TradeExecutionEvent.d.ts

@@ -8,8 +8,26 @@ export type TradeExecutionEvent = {
     slippage: string;
     mev: boolean;
     totalFee: string;
+    /**
+     * Execution side (buy | sell)
+     * For sniper orders, this represents only buy
+     */
     type: string;
-    executionPriceUsd: string;
-    orderType: 'limit' | 'trailing';
+    /**
+     * USD execution price.
+     * Present for limit and trailing orders.
+     * Undefined for sniper orders.
+     */
+    executionPriceUsd?: string;
+    /**
+     * Pool address used for execution.
+     * Present for sniper orders.
+     * Undefined for limit and trailing orders.
+     */
+    poolAddress?: string;
+    /**
+     * Order category driving execution semantics.
+     */
+    orderType: 'limit' | 'trailing' | 'sniper';
 };
 //# sourceMappingURL=TradeExecutionEvent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TradeExecutionEvent.d.ts","sourceRoot":"","sources":["../../src/types/TradeExecutionEvent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC;CACjC,CAAC"}
+{"version":3,"file":"TradeExecutionEvent.d.ts","sourceRoot":"","sources":["../../src/types/TradeExecutionEvent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC5C,CAAC"}

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from './TokenPriceEvent';
 export * from './WalletTransactionEvent';
 export * from './TradeExecutionEvent';
+export * from './PoolCreatedEvent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./TokenPriceEvent"), exports);
 __exportStar(require("./WalletTransactionEvent"), exports);
 __exportStar(require("./TradeExecutionEvent"), exports);
+__exportStar(require("./PoolCreatedEvent"), exports);

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

@@ -8,8 +8,8 @@ export declare const tokenPriceEventSchema: z.ZodObject<{
         exchange: z.ZodString;
         liquidity: z.ZodNumber;
     }, z.core.$strip>>>>;
-    priceInUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    fdvInUsd: 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.js

@@ -42,8 +42,8 @@ exports.tokenPriceEventSchema = zod_1.z.object({
     tokenAddress: common_1.addressSchema,
     blockNumber: zod_1.z.number().int().min(0),
     price: priceRecordSchema,
-    priceInUsd: zod_1.z.number().nullable().optional(),
-    fdvInUsd: 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.6",
+  "version": "1.0.8",
   "description": "Axxel Kafka Event Bus SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +20,10 @@
     "prepublishOnly": "npm run build",
     "test": "echo \"No tests yet\" && exit 0",
     "publish:public": "npm publish --access public",
-    "publish:private": "npm publish"
+    "publish:private": "npm publish",
+    "release:patch": "npm version patch && npm publish --access public",
+    "release:minor": "npm version minor && npm publish --access public",
+    "release:major": "npm version major && npm publish --access public"
   },
   "keywords": [],
   "author": "",
@@ -36,4 +39,4 @@
     "tsx": "^4.20.6",
     "typescript": "^5.9.3"
   }
-}
+}