@quantabit/eventbus-sdk

QuantaBit EventBus SDK - Unified event publish/subscribe and module decoupling

📦 Installation

npm install @quantabit/eventbus-sdk
# or
yarn add @quantabit/eventbus-sdk

🚀 Quick Start

1. Basic Usage

import { eventBus, on, emit, once } from "@quantabit/eventbus-sdk";

// Subscribe to event
const unsubscribe = on("user:login", (data) => {
  console.log("User logged in:", data);
});

// Publish event
emit("user:login", { userId: "123", nickname: "Alice" });

// Unsubscribe
unsubscribe();

2. Using Predefined Events

import { eventBus, UserEvents, WalletEvents } from "@quantabit/eventbus-sdk";

// Listen for user login
eventBus.on(UserEvents.LOGIN, (data) => {
  console.log("User logged in:", data);
});

// Listen for wallet connection
eventBus.on(WalletEvents.CONNECT, (data) => {
  console.log("Wallet connected:", data);
});

// Publish event
eventBus.emit(UserEvents.LEVEL_UP, { level: 10 });

3. One-time Subscribe

import { once, wait } from "@quantabit/eventbus-sdk";

// Trigger only once
once("payment:complete", (data) => {
  console.log("Payment completed:", data);
});

// Promise-based event waiting
const data = await wait("payment:complete", 5000); // 5s timeout

4. Wildcard Subscribe

import { eventBus } from "@quantabit/eventbus-sdk";

// Listen to all events
eventBus.on("*", (data, event) => {
  console.log(`[${event.type}]`, data);
});

📋 Predefined Events

import { Events } from "@quantabit/eventbus-sdk";

Events.User.LOGIN; // User login
Events.User.LOGOUT; // User logout
Events.User.LEVEL_UP; // Level up

Events.Wallet.CONNECT; // Wallet connected
Events.Wallet.BALANCE_CHANGE; // Balance changed

Events.Task.COMPLETE; // Task completed
Events.Task.CLAIM; // Claim reward

Events.Social.LIKE; // Like
Events.Social.FOLLOW; // Follow

📄 License

MIT License

🌐 Brand & Links

• Official Mainnet: QuantaBit Chain
• Developer Platform: Developer Platform
• Open Platform: Open Platform
• Payment Platform: Pay Platform
• Feedback: Feedback