@classytic/revenue 1.0.2 → 1.1.2

package/dist/core/events.d.ts

@@ -0,0 +1,455 @@
+import { T as TransactionDocument, S as SubscriptionDocument, P as PaymentIntentData, a as SplitInfo, W as WebhookEventData, b as PaymentResultData } from '../index-cLJBLUvx.js';
+import { PaymentResult, RefundResult } from '../providers/index.js';
+import { S as SettlementDocument } from '../settlement.schema-CpamV7ZY.js';
+import 'mongoose';
+import '@classytic/shared-types';
+import '../split.enums-DG3TxQf9.js';
+
+/**
+ * Event System - Type-safe pub/sub
+ * @classytic/revenue
+ *
+ * Strongly typed events with async handlers
+ * Inspired by: Node.js EventEmitter, mitt, EventTarget
+ */
+
+/**
+ * All revenue events with their payload types
+ */
+interface RevenueEvents {
+    'payment.verified': PaymentVerifiedEvent;
+    'payment.failed': PaymentFailedEvent;
+    'payment.refunded': PaymentRefundedEvent;
+    'payment.requires_action': PaymentRequiresActionEvent;
+    'payment.processing': PaymentProcessingEvent;
+    'monetization.created': MonetizationCreatedEvent;
+    'purchase.created': PurchaseCreatedEvent;
+    'free.created': FreeCreatedEvent;
+    'subscription.created': SubscriptionCreatedEvent;
+    'subscription.activated': SubscriptionActivatedEvent;
+    'subscription.renewed': SubscriptionRenewedEvent;
+    'subscription.cancelled': SubscriptionCancelledEvent;
+    'subscription.paused': SubscriptionPausedEvent;
+    'subscription.resumed': SubscriptionResumedEvent;
+    'transaction.updated': TransactionUpdatedEvent;
+    'escrow.held': EscrowHeldEvent;
+    'escrow.released': EscrowReleasedEvent;
+    'escrow.cancelled': EscrowCancelledEvent;
+    'escrow.split': EscrowSplitEvent;
+    'settlement.created': SettlementCreatedEvent;
+    'settlement.scheduled': SettlementScheduledEvent;
+    'settlement.processing': SettlementProcessingEvent;
+    'settlement.completed': SettlementCompletedEvent;
+    'settlement.failed': SettlementFailedEvent;
+    'webhook.processed': WebhookProcessedEvent;
+    '*': BaseEvent;
+}
+/**
+ * Base event with auto-injected fields
+ */
+interface BaseEvent {
+    readonly type: string;
+    readonly timestamp: Date;
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Event data types (what services emit - without type/timestamp)
+ * These are clean, explicit types that make it obvious what data to pass
+ */
+interface PaymentVerifiedEventData {
+    transaction: TransactionDocument;
+    paymentResult: PaymentResult | PaymentResultData;
+    verifiedBy?: string | null;
+}
+interface PaymentFailedEventData {
+    transaction: TransactionDocument;
+    error: string;
+    provider: string;
+    paymentIntentId: string;
+}
+interface PaymentRefundedEventData {
+    transaction: TransactionDocument;
+    refundTransaction: TransactionDocument;
+    refundResult: RefundResult;
+    refundAmount: number;
+    reason?: string;
+    isPartialRefund: boolean;
+}
+interface PaymentRequiresActionEventData {
+    transaction: TransactionDocument;
+    paymentResult: PaymentResult | PaymentResultData;
+    action?: string | Record<string, unknown>;
+}
+interface PaymentProcessingEventData {
+    transaction: TransactionDocument;
+    paymentResult: PaymentResult | PaymentResultData;
+}
+interface MonetizationCreatedEventData {
+    monetizationType: string;
+    subscription?: SubscriptionDocument;
+    transaction?: TransactionDocument;
+    paymentIntent?: PaymentIntentData;
+}
+interface SubscriptionActivatedEventData {
+    subscription: SubscriptionDocument;
+    activatedAt: Date;
+}
+interface TransactionUpdatedEventData {
+    transaction: TransactionDocument;
+    updates: Partial<TransactionDocument>;
+}
+interface PaymentVerifiedEvent extends BaseEvent {
+    type: 'payment.verified';
+    transaction: TransactionDocument;
+    paymentResult: PaymentResult;
+    verifiedBy?: string;
+}
+interface PaymentFailedEvent extends BaseEvent {
+    type: 'payment.failed';
+    transaction: TransactionDocument;
+    error: string;
+    provider: string;
+    paymentIntentId: string;
+}
+interface PaymentRefundedEvent extends BaseEvent {
+    type: 'payment.refunded';
+    transaction: TransactionDocument;
+    refundTransaction: TransactionDocument;
+    refundResult: RefundResult;
+    refundAmount: number;
+    reason?: string;
+    isPartialRefund: boolean;
+}
+interface PaymentRequiresActionEvent extends BaseEvent {
+    type: 'payment.requires_action';
+    transaction: TransactionDocument;
+    paymentResult: PaymentResult;
+    action?: string | Record<string, unknown>;
+}
+interface PaymentProcessingEvent extends BaseEvent {
+    type: 'payment.processing';
+    transaction: TransactionDocument;
+    paymentResult: PaymentResult;
+}
+interface MonetizationCreatedEvent extends BaseEvent {
+    type: 'monetization.created';
+    monetizationType: string;
+    subscription?: SubscriptionDocument;
+    transaction?: TransactionDocument;
+    paymentIntent?: PaymentIntentData;
+}
+interface PurchaseCreatedEvent extends BaseEvent {
+    type: 'purchase.created';
+    monetizationType: string;
+    subscription?: SubscriptionDocument;
+    transaction: TransactionDocument;
+    paymentIntent?: PaymentIntentData;
+}
+interface FreeCreatedEvent extends BaseEvent {
+    type: 'free.created';
+    monetizationType: string;
+    subscription?: SubscriptionDocument;
+    transaction?: TransactionDocument;
+    paymentIntent?: PaymentIntentData;
+}
+interface SubscriptionCreatedEvent extends BaseEvent {
+    type: 'subscription.created';
+    subscriptionId: string;
+    subscription: SubscriptionDocument;
+    transactionId?: string;
+}
+interface SubscriptionActivatedEvent extends BaseEvent {
+    type: 'subscription.activated';
+    subscription: SubscriptionDocument;
+    activatedAt: Date;
+}
+interface SubscriptionRenewedEvent extends BaseEvent {
+    type: 'subscription.renewed';
+    subscription: SubscriptionDocument;
+    transaction: TransactionDocument;
+    paymentIntent?: PaymentIntentData;
+    renewalCount: number;
+}
+interface SubscriptionCancelledEvent extends BaseEvent {
+    type: 'subscription.cancelled';
+    subscription: SubscriptionDocument;
+    immediate: boolean;
+    reason?: string;
+    canceledAt: Date;
+}
+interface SubscriptionPausedEvent extends BaseEvent {
+    type: 'subscription.paused';
+    subscription: SubscriptionDocument;
+    reason?: string;
+    pausedAt: Date;
+}
+interface SubscriptionResumedEvent extends BaseEvent {
+    type: 'subscription.resumed';
+    subscription: SubscriptionDocument;
+    extendPeriod: boolean;
+    pauseDuration: number;
+    resumedAt: Date;
+}
+interface TransactionUpdatedEvent extends BaseEvent {
+    type: 'transaction.updated';
+    transaction: TransactionDocument;
+    updates: Partial<TransactionDocument>;
+}
+interface EscrowHeldEvent extends BaseEvent {
+    type: 'escrow.held';
+    transaction: TransactionDocument;
+    heldAmount: number;
+    reason: string;
+}
+interface EscrowReleasedEvent extends BaseEvent {
+    type: 'escrow.released';
+    transaction: TransactionDocument;
+    releaseTransaction: TransactionDocument | null;
+    releaseAmount: number;
+    recipientId: string;
+    recipientType: string;
+    reason: string;
+    isFullRelease: boolean;
+    isPartialRelease: boolean;
+}
+interface EscrowCancelledEvent extends BaseEvent {
+    type: 'escrow.cancelled';
+    transaction: TransactionDocument;
+    reason: string;
+}
+interface EscrowSplitEvent extends BaseEvent {
+    type: 'escrow.split';
+    transaction: TransactionDocument;
+    splits: SplitInfo[];
+    splitTransactions: TransactionDocument[];
+    organizationTransaction: TransactionDocument | null;
+    organizationPayout: number;
+}
+interface SettlementCreatedEvent extends BaseEvent {
+    type: 'settlement.created';
+    settlements: SettlementDocument[];
+    transactionId: string;
+    count: number;
+}
+interface SettlementScheduledEvent extends BaseEvent {
+    type: 'settlement.scheduled';
+    settlement: SettlementDocument;
+    scheduledAt: Date;
+}
+interface SettlementProcessingEvent extends BaseEvent {
+    type: 'settlement.processing';
+    settlement: SettlementDocument;
+    processedAt?: Date;
+}
+interface SettlementCompletedEvent extends BaseEvent {
+    type: 'settlement.completed';
+    settlement: SettlementDocument;
+    completedAt?: Date;
+}
+interface SettlementFailedEvent extends BaseEvent {
+    type: 'settlement.failed';
+    settlement: SettlementDocument;
+    reason: string;
+    code?: string;
+    retry: boolean;
+}
+interface WebhookProcessedEvent extends BaseEvent {
+    type: 'webhook.processed';
+    webhookType: string;
+    provider: string;
+    event: WebhookEventData;
+    transaction: TransactionDocument;
+    processedAt: Date;
+}
+/**
+ * Event data for free.created (transaction is optional)
+ */
+interface FreeCreatedEventData {
+    monetizationType: string;
+    subscription?: SubscriptionDocument;
+    transaction?: TransactionDocument;
+    paymentIntent?: PaymentIntentData;
+}
+/**
+ * Event data for subscription.created
+ */
+interface SubscriptionCreatedEventData {
+    subscriptionId: string;
+    subscription: SubscriptionDocument;
+    transactionId?: string;
+}
+/**
+ * Event data for subscription lifecycle events
+ */
+interface SubscriptionRenewedEventData {
+    subscription: SubscriptionDocument;
+    transaction: TransactionDocument;
+    paymentIntent?: PaymentIntentData;
+    renewalCount: number;
+}
+interface SubscriptionCancelledEventData {
+    subscription: SubscriptionDocument;
+    immediate: boolean;
+    reason?: string;
+    canceledAt: Date;
+}
+interface SubscriptionPausedEventData {
+    subscription: SubscriptionDocument;
+    reason?: string;
+    pausedAt: Date;
+}
+interface SubscriptionResumedEventData {
+    subscription: SubscriptionDocument;
+    extendPeriod: boolean;
+    pauseDuration: number;
+    resumedAt: Date;
+}
+/**
+ * Event data for escrow events
+ */
+interface EscrowHeldEventData {
+    transaction: TransactionDocument;
+    heldAmount: number;
+    reason: string;
+}
+interface EscrowReleasedEventData {
+    transaction: TransactionDocument;
+    releaseTransaction: TransactionDocument | null;
+    releaseAmount: number;
+    recipientId: string;
+    recipientType: string;
+    reason: string;
+    isFullRelease: boolean;
+    isPartialRelease: boolean;
+}
+interface EscrowCancelledEventData {
+    transaction: TransactionDocument;
+    reason: string;
+}
+interface EscrowSplitEventData {
+    transaction: TransactionDocument;
+    splits: SplitInfo[];
+    splitTransactions: TransactionDocument[];
+    organizationTransaction: TransactionDocument | null;
+    organizationPayout: number;
+}
+/**
+ * Event data for settlement events
+ */
+interface SettlementCreatedEventData {
+    settlements: SettlementDocument[];
+    transactionId: string;
+    count: number;
+}
+interface SettlementScheduledEventData {
+    settlement: SettlementDocument;
+    scheduledAt: Date;
+}
+interface SettlementProcessingEventData {
+    settlement: SettlementDocument;
+    processedAt?: Date;
+}
+interface SettlementCompletedEventData {
+    settlement: SettlementDocument;
+    completedAt?: Date;
+}
+interface SettlementFailedEventData {
+    settlement: SettlementDocument;
+    reason: string;
+    code?: string;
+    retry: boolean;
+}
+/**
+ * Event data for webhook events
+ */
+interface WebhookProcessedEventData {
+    webhookType: string;
+    provider: string;
+    event: WebhookEventData;
+    transaction: TransactionDocument;
+    processedAt: Date;
+}
+/**
+ * Clean mapping of event names to their data types (what you emit)
+ * This makes it crystal clear what data each event needs
+ * Only includes events that are actually emitted in the codebase
+ */
+interface EventDataMap {
+    'payment.verified': PaymentVerifiedEventData;
+    'payment.failed': PaymentFailedEventData;
+    'payment.refunded': PaymentRefundedEventData;
+    'payment.requires_action': PaymentRequiresActionEventData;
+    'payment.processing': PaymentProcessingEventData;
+    'monetization.created': MonetizationCreatedEventData;
+    'purchase.created': MonetizationCreatedEventData;
+    'free.created': FreeCreatedEventData;
+    'subscription.created': SubscriptionCreatedEventData;
+    'subscription.activated': SubscriptionActivatedEventData;
+    'subscription.renewed': SubscriptionRenewedEventData;
+    'subscription.cancelled': SubscriptionCancelledEventData;
+    'subscription.paused': SubscriptionPausedEventData;
+    'subscription.resumed': SubscriptionResumedEventData;
+    'transaction.updated': TransactionUpdatedEventData;
+    'escrow.held': EscrowHeldEventData;
+    'escrow.released': EscrowReleasedEventData;
+    'escrow.cancelled': EscrowCancelledEventData;
+    'escrow.split': EscrowSplitEventData;
+    'settlement.created': SettlementCreatedEventData;
+    'settlement.scheduled': SettlementScheduledEventData;
+    'settlement.processing': SettlementProcessingEventData;
+    'settlement.completed': SettlementCompletedEventData;
+    'settlement.failed': SettlementFailedEventData;
+    'webhook.processed': WebhookProcessedEventData;
+}
+type EventHandler<T> = (event: T) => void | Promise<void>;
+type EventKey = keyof RevenueEvents;
+/**
+ * Type-safe event bus with clean, simple API
+ */
+declare class EventBus {
+    private handlers;
+    private onceHandlers;
+    /**
+     * Subscribe to an event
+     */
+    on<K extends EventKey>(event: K, handler: EventHandler<RevenueEvents[K]>): () => void;
+    /**
+     * Subscribe to an event once
+     */
+    once<K extends EventKey>(event: K, handler: EventHandler<RevenueEvents[K]>): () => void;
+    /**
+     * Unsubscribe from an event
+     */
+    off<K extends EventKey>(event: K, handler: EventHandler<RevenueEvents[K]>): void;
+    /**
+     * Emit an event (fire and forget, non-blocking)
+     *
+     * @example
+     * ```typescript
+     * events.emit('payment.verified', {
+     *   transaction: txDoc,
+     *   paymentResult: result,
+     *   verifiedBy: 'admin_123'
+     * });
+     * ```
+     */
+    emit<K extends keyof EventDataMap>(event: K, data: EventDataMap[K]): void;
+    /**
+     * Emit and wait for all handlers to complete
+     */
+    emitAsync<K extends EventKey>(event: K, payload: Omit<RevenueEvents[K], 'timestamp' | 'type'>): Promise<void>;
+    /**
+     * Remove all handlers
+     */
+    clear(): void;
+    /**
+     * Get handler count for an event
+     */
+    listenerCount(event: EventKey): number;
+}
+/**
+ * Create a new event bus
+ */
+declare function createEventBus(): EventBus;
+
+export { type BaseEvent, type EscrowCancelledEvent, type EscrowCancelledEventData, type EscrowHeldEvent, type EscrowHeldEventData, type EscrowReleasedEvent, type EscrowReleasedEventData, type EscrowSplitEvent, type EscrowSplitEventData, EventBus, type EventDataMap, type FreeCreatedEvent, type FreeCreatedEventData, type MonetizationCreatedEvent, type MonetizationCreatedEventData, type PaymentFailedEvent, type PaymentFailedEventData, type PaymentProcessingEvent, type PaymentProcessingEventData, type PaymentRefundedEvent, type PaymentRefundedEventData, type PaymentRequiresActionEvent, type PaymentRequiresActionEventData, type PaymentVerifiedEvent, type PaymentVerifiedEventData, type PurchaseCreatedEvent, type RevenueEvents, type SettlementCompletedEvent, type SettlementCompletedEventData, type SettlementCreatedEvent, type SettlementCreatedEventData, type SettlementFailedEvent, type SettlementFailedEventData, type SettlementProcessingEvent, type SettlementProcessingEventData, type SettlementScheduledEvent, type SettlementScheduledEventData, type SubscriptionActivatedEvent, type SubscriptionActivatedEventData, type SubscriptionCancelledEvent, type SubscriptionCancelledEventData, type SubscriptionCreatedEvent, type SubscriptionCreatedEventData, type SubscriptionPausedEvent, type SubscriptionPausedEventData, type SubscriptionRenewedEvent, type SubscriptionRenewedEventData, type SubscriptionResumedEvent, type SubscriptionResumedEventData, type TransactionUpdatedEvent, type TransactionUpdatedEventData, type WebhookProcessedEvent, type WebhookProcessedEventData, createEventBus, EventBus as default };

package/dist/core/events.js

@@ -0,0 +1,122 @@
+// @classytic/revenue - Enterprise Revenue Management System
+
+// src/core/events.ts
+var EventBus = class {
+  handlers = /* @__PURE__ */ new Map();
+  onceHandlers = /* @__PURE__ */ new Map();
+  /**
+   * Subscribe to an event
+   */
+  on(event, handler) {
+    if (!this.handlers.has(event)) {
+      this.handlers.set(event, /* @__PURE__ */ new Set());
+    }
+    this.handlers.get(event).add(handler);
+    return () => this.off(event, handler);
+  }
+  /**
+   * Subscribe to an event once
+   */
+  once(event, handler) {
+    if (!this.onceHandlers.has(event)) {
+      this.onceHandlers.set(event, /* @__PURE__ */ new Set());
+    }
+    this.onceHandlers.get(event).add(handler);
+    return () => this.onceHandlers.get(event)?.delete(handler);
+  }
+  /**
+   * Unsubscribe from an event
+   */
+  off(event, handler) {
+    this.handlers.get(event)?.delete(handler);
+    this.onceHandlers.get(event)?.delete(handler);
+  }
+  emit(event, data) {
+    const fullPayload = {
+      ...data,
+      type: event,
+      timestamp: /* @__PURE__ */ new Date()
+    };
+    const handlers = this.handlers.get(event);
+    if (handlers) {
+      for (const handler of handlers) {
+        Promise.resolve(handler(fullPayload)).catch((err) => {
+          console.error(`[Revenue] Event handler error for "${event}":`, err);
+        });
+      }
+    }
+    const onceHandlers = this.onceHandlers.get(event);
+    if (onceHandlers) {
+      for (const handler of onceHandlers) {
+        Promise.resolve(handler(fullPayload)).catch((err) => {
+          console.error(`[Revenue] Once handler error for "${event}":`, err);
+        });
+      }
+      this.onceHandlers.delete(event);
+    }
+    if (event !== "*") {
+      const wildcardHandlers = this.handlers.get("*");
+      if (wildcardHandlers) {
+        for (const handler of wildcardHandlers) {
+          Promise.resolve(handler(fullPayload)).catch((err) => {
+            console.error(`[Revenue] Wildcard handler error:`, err);
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Emit and wait for all handlers to complete
+   */
+  async emitAsync(event, payload) {
+    const fullPayload = {
+      ...payload,
+      type: event,
+      timestamp: /* @__PURE__ */ new Date()
+    };
+    const promises = [];
+    const handlers = this.handlers.get(event);
+    if (handlers) {
+      for (const handler of handlers) {
+        promises.push(Promise.resolve(handler(fullPayload)));
+      }
+    }
+    const onceHandlers = this.onceHandlers.get(event);
+    if (onceHandlers) {
+      for (const handler of onceHandlers) {
+        promises.push(Promise.resolve(handler(fullPayload)));
+      }
+      this.onceHandlers.delete(event);
+    }
+    if (event !== "*") {
+      const wildcardHandlers = this.handlers.get("*");
+      if (wildcardHandlers) {
+        for (const handler of wildcardHandlers) {
+          promises.push(Promise.resolve(handler(fullPayload)));
+        }
+      }
+    }
+    await Promise.all(promises);
+  }
+  /**
+   * Remove all handlers
+   */
+  clear() {
+    this.handlers.clear();
+    this.onceHandlers.clear();
+  }
+  /**
+   * Get handler count for an event
+   */
+  listenerCount(event) {
+    return (this.handlers.get(event)?.size ?? 0) + (this.onceHandlers.get(event)?.size ?? 0);
+  }
+};
+function createEventBus() {
+  return new EventBus();
+}
+var events_default = EventBus;
+
+export { EventBus, createEventBus, events_default as default };
+//# sourceMappingURL=events.js.map
+//# sourceMappingURL=events.js.map

package/dist/core/events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/events.ts"],"names":[],"mappings":"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","file":"events.js","sourcesContent":["/**\n * Event System - Type-safe pub/sub\n * @classytic/revenue\n *\n * Strongly typed events with async handlers\n * Inspired by: Node.js EventEmitter, mitt, EventTarget\n */\n\nimport type {\n  TransactionDocument,\n  SubscriptionDocument,\n  PaymentResultData,\n  PaymentIntentData,\n  SplitInfo,\n  WebhookEventData,\n} from '../shared/types/index.js';\nimport type { PaymentResult, RefundResult } from '../providers/base.js';\nimport type { SettlementDocument } from '../schemas/settlement/settlement.schema.js';\n\n// ============ EVENT DEFINITIONS ============\n\n/**\n * All revenue events with their payload types\n */\nexport interface RevenueEvents {\n  // Payment events\n  'payment.verified': PaymentVerifiedEvent;\n  'payment.failed': PaymentFailedEvent;\n  'payment.refunded': PaymentRefundedEvent;\n  'payment.requires_action': PaymentRequiresActionEvent;\n  'payment.processing': PaymentProcessingEvent;\n\n  // Monetization events\n  'monetization.created': MonetizationCreatedEvent;\n  'purchase.created': PurchaseCreatedEvent;\n  'free.created': FreeCreatedEvent;\n\n  // Subscription events\n  'subscription.created': SubscriptionCreatedEvent;\n  'subscription.activated': SubscriptionActivatedEvent;\n  'subscription.renewed': SubscriptionRenewedEvent;\n  'subscription.cancelled': SubscriptionCancelledEvent;\n  'subscription.paused': SubscriptionPausedEvent;\n  'subscription.resumed': SubscriptionResumedEvent;\n\n  // Transaction events\n  'transaction.updated': TransactionUpdatedEvent;\n\n  // Escrow events\n  'escrow.held': EscrowHeldEvent;\n  'escrow.released': EscrowReleasedEvent;\n  'escrow.cancelled': EscrowCancelledEvent;\n  'escrow.split': EscrowSplitEvent;\n\n  // Settlement events\n  'settlement.created': SettlementCreatedEvent;\n  'settlement.scheduled': SettlementScheduledEvent;\n  'settlement.processing': SettlementProcessingEvent;\n  'settlement.completed': SettlementCompletedEvent;\n  'settlement.failed': SettlementFailedEvent;\n\n  // Webhook events\n  'webhook.processed': WebhookProcessedEvent;\n\n  // Wildcard - catches all events\n  '*': BaseEvent;\n}\n\n// ============ EVENT PAYLOADS ============\n\n/**\n * Base event with auto-injected fields\n */\nexport interface BaseEvent {\n  readonly type: string;\n  readonly timestamp: Date;\n  readonly metadata?: Record<string, unknown>;\n}\n\n/**\n * Event data types (what services emit - without type/timestamp)\n * These are clean, explicit types that make it obvious what data to pass\n */\nexport interface PaymentVerifiedEventData {\n  transaction: TransactionDocument;\n  paymentResult: PaymentResult | PaymentResultData;\n  verifiedBy?: string | null;\n}\n\nexport interface PaymentFailedEventData {\n  transaction: TransactionDocument;\n  error: string;\n  provider: string;\n  paymentIntentId: string;\n}\n\nexport interface PaymentRefundedEventData {\n  transaction: TransactionDocument;\n  refundTransaction: TransactionDocument;\n  refundResult: RefundResult;\n  refundAmount: number;\n  reason?: string;\n  isPartialRefund: boolean;\n}\n\nexport interface PaymentRequiresActionEventData {\n  transaction: TransactionDocument;\n  paymentResult: PaymentResult | PaymentResultData;\n  action?: string | Record<string, unknown>;\n}\n\nexport interface PaymentProcessingEventData {\n  transaction: TransactionDocument;\n  paymentResult: PaymentResult | PaymentResultData;\n}\n\nexport interface MonetizationCreatedEventData {\n  monetizationType: string;\n  subscription?: SubscriptionDocument;\n  transaction?: TransactionDocument;\n  paymentIntent?: PaymentIntentData;\n}\n\nexport interface SubscriptionActivatedEventData {\n  subscription: SubscriptionDocument;\n  activatedAt: Date;\n}\n\nexport interface TransactionUpdatedEventData {\n  transaction: TransactionDocument;\n  updates: Partial<TransactionDocument>;\n}\n\nexport interface PaymentVerifiedEvent extends BaseEvent {\n  type: 'payment.verified';\n  transaction: TransactionDocument;\n  paymentResult: PaymentResult;\n  verifiedBy?: string;\n}\n\nexport interface PaymentFailedEvent extends BaseEvent {\n  type: 'payment.failed';\n  transaction: TransactionDocument;\n  error: string;\n  provider: string;\n  paymentIntentId: string;\n}\n\nexport interface PaymentRefundedEvent extends BaseEvent {\n  type: 'payment.refunded';\n  transaction: TransactionDocument;\n  refundTransaction: TransactionDocument;\n  refundResult: RefundResult;\n  refundAmount: number;\n  reason?: string;\n  isPartialRefund: boolean;\n}\n\nexport interface PaymentRequiresActionEvent extends BaseEvent {\n  type: 'payment.requires_action';\n  transaction: TransactionDocument;\n  paymentResult: PaymentResult;\n  action?: string | Record<string, unknown>;\n}\n\nexport interface PaymentProcessingEvent extends BaseEvent {\n  type: 'payment.processing';\n  transaction: TransactionDocument;\n  paymentResult: PaymentResult;\n}\n\nexport interface MonetizationCreatedEvent extends BaseEvent {\n  type: 'monetization.created';\n  monetizationType: string;\n  subscription?: SubscriptionDocument;\n  transaction?: TransactionDocument;\n  paymentIntent?: PaymentIntentData;\n}\n\nexport interface PurchaseCreatedEvent extends BaseEvent {\n  type: 'purchase.created';\n  monetizationType: string;\n  subscription?: SubscriptionDocument;\n  transaction: TransactionDocument;\n  paymentIntent?: PaymentIntentData;\n}\n\nexport interface FreeCreatedEvent extends BaseEvent {\n  type: 'free.created';\n  monetizationType: string;\n  subscription?: SubscriptionDocument;\n  transaction?: TransactionDocument; // Optional: free flows may not create transactions\n  paymentIntent?: PaymentIntentData;\n}\n\nexport interface SubscriptionCreatedEvent extends BaseEvent {\n  type: 'subscription.created';\n  subscriptionId: string;\n  subscription: SubscriptionDocument;\n  transactionId?: string;\n}\n\nexport interface SubscriptionActivatedEvent extends BaseEvent {\n  type: 'subscription.activated';\n  subscription: SubscriptionDocument;\n  activatedAt: Date;\n}\n\nexport interface SubscriptionRenewedEvent extends BaseEvent {\n  type: 'subscription.renewed';\n  subscription: SubscriptionDocument;\n  transaction: TransactionDocument;\n  paymentIntent?: PaymentIntentData;\n  renewalCount: number;\n}\n\nexport interface SubscriptionCancelledEvent extends BaseEvent {\n  type: 'subscription.cancelled';\n  subscription: SubscriptionDocument;\n  immediate: boolean;\n  reason?: string;\n  canceledAt: Date;\n}\n\nexport interface SubscriptionPausedEvent extends BaseEvent {\n  type: 'subscription.paused';\n  subscription: SubscriptionDocument;\n  reason?: string;\n  pausedAt: Date;\n}\n\nexport interface SubscriptionResumedEvent extends BaseEvent {\n  type: 'subscription.resumed';\n  subscription: SubscriptionDocument;\n  extendPeriod: boolean;\n  pauseDuration: number;\n  resumedAt: Date;\n}\n\nexport interface TransactionUpdatedEvent extends BaseEvent {\n  type: 'transaction.updated';\n  transaction: TransactionDocument;\n  updates: Partial<TransactionDocument>;\n}\n\nexport interface EscrowHeldEvent extends BaseEvent {\n  type: 'escrow.held';\n  transaction: TransactionDocument;\n  heldAmount: number;\n  reason: string;\n}\n\nexport interface EscrowReleasedEvent extends BaseEvent {\n  type: 'escrow.released';\n  transaction: TransactionDocument;\n  releaseTransaction: TransactionDocument | null;\n  releaseAmount: number;\n  recipientId: string;\n  recipientType: string;\n  reason: string;\n  isFullRelease: boolean;\n  isPartialRelease: boolean;\n}\n\nexport interface EscrowCancelledEvent extends BaseEvent {\n  type: 'escrow.cancelled';\n  transaction: TransactionDocument;\n  reason: string;\n}\n\nexport interface EscrowSplitEvent extends BaseEvent {\n  type: 'escrow.split';\n  transaction: TransactionDocument;\n  splits: SplitInfo[];\n  splitTransactions: TransactionDocument[];\n  organizationTransaction: TransactionDocument | null;\n  organizationPayout: number;\n}\n\nexport interface SettlementCreatedEvent extends BaseEvent {\n  type: 'settlement.created';\n  settlements: SettlementDocument[];\n  transactionId: string;\n  count: number;\n}\n\nexport interface SettlementScheduledEvent extends BaseEvent {\n  type: 'settlement.scheduled';\n  settlement: SettlementDocument;\n  scheduledAt: Date;\n}\n\nexport interface SettlementProcessingEvent extends BaseEvent {\n  type: 'settlement.processing';\n  settlement: SettlementDocument;\n  processedAt?: Date;\n}\n\nexport interface SettlementCompletedEvent extends BaseEvent {\n  type: 'settlement.completed';\n  settlement: SettlementDocument;\n  completedAt?: Date;\n}\n\nexport interface SettlementFailedEvent extends BaseEvent {\n  type: 'settlement.failed';\n  settlement: SettlementDocument;\n  reason: string;\n  code?: string;\n  retry: boolean;\n}\n\nexport interface WebhookProcessedEvent extends BaseEvent {\n  type: 'webhook.processed';\n  webhookType: string;\n  provider: string;\n  event: WebhookEventData;\n  transaction: TransactionDocument;\n  processedAt: Date;\n}\n\n/**\n * Event data for free.created (transaction is optional)\n */\nexport interface FreeCreatedEventData {\n  monetizationType: string;\n  subscription?: SubscriptionDocument;\n  transaction?: TransactionDocument;\n  paymentIntent?: PaymentIntentData;\n}\n\n/**\n * Event data for subscription.created\n */\nexport interface SubscriptionCreatedEventData {\n  subscriptionId: string;\n  subscription: SubscriptionDocument;\n  transactionId?: string;\n}\n\n/**\n * Event data for subscription lifecycle events\n */\nexport interface SubscriptionRenewedEventData {\n  subscription: SubscriptionDocument;\n  transaction: TransactionDocument;\n  paymentIntent?: PaymentIntentData;\n  renewalCount: number;\n}\n\nexport interface SubscriptionCancelledEventData {\n  subscription: SubscriptionDocument;\n  immediate: boolean;\n  reason?: string;\n  canceledAt: Date;\n}\n\nexport interface SubscriptionPausedEventData {\n  subscription: SubscriptionDocument;\n  reason?: string;\n  pausedAt: Date;\n}\n\nexport interface SubscriptionResumedEventData {\n  subscription: SubscriptionDocument;\n  extendPeriod: boolean;\n  pauseDuration: number;\n  resumedAt: Date;\n}\n\n/**\n * Event data for escrow events\n */\nexport interface EscrowHeldEventData {\n  transaction: TransactionDocument;\n  heldAmount: number;\n  reason: string;\n}\n\nexport interface EscrowReleasedEventData {\n  transaction: TransactionDocument;\n  releaseTransaction: TransactionDocument | null;\n  releaseAmount: number;\n  recipientId: string;\n  recipientType: string;\n  reason: string;\n  isFullRelease: boolean;\n  isPartialRelease: boolean;\n}\n\nexport interface EscrowCancelledEventData {\n  transaction: TransactionDocument;\n  reason: string;\n}\n\nexport interface EscrowSplitEventData {\n  transaction: TransactionDocument;\n  splits: SplitInfo[];\n  splitTransactions: TransactionDocument[];\n  organizationTransaction: TransactionDocument | null;\n  organizationPayout: number;\n}\n\n/**\n * Event data for settlement events\n */\nexport interface SettlementCreatedEventData {\n  settlements: SettlementDocument[];\n  transactionId: string;\n  count: number;\n}\n\nexport interface SettlementScheduledEventData {\n  settlement: SettlementDocument;\n  scheduledAt: Date;\n}\n\nexport interface SettlementProcessingEventData {\n  settlement: SettlementDocument;\n  processedAt?: Date;\n}\n\nexport interface SettlementCompletedEventData {\n  settlement: SettlementDocument;\n  completedAt?: Date;\n}\n\nexport interface SettlementFailedEventData {\n  settlement: SettlementDocument;\n  reason: string;\n  code?: string;\n  retry: boolean;\n}\n\n/**\n * Event data for webhook events\n */\nexport interface WebhookProcessedEventData {\n  webhookType: string;\n  provider: string;\n  event: WebhookEventData;\n  transaction: TransactionDocument;\n  processedAt: Date;\n}\n\n/**\n * Clean mapping of event names to their data types (what you emit)\n * This makes it crystal clear what data each event needs\n * Only includes events that are actually emitted in the codebase\n */\nexport interface EventDataMap {\n  // Payment events\n  'payment.verified': PaymentVerifiedEventData;\n  'payment.failed': PaymentFailedEventData;\n  'payment.refunded': PaymentRefundedEventData;\n  'payment.requires_action': PaymentRequiresActionEventData;\n  'payment.processing': PaymentProcessingEventData;\n\n  // Monetization events\n  'monetization.created': MonetizationCreatedEventData;\n  'purchase.created': MonetizationCreatedEventData;\n  'free.created': FreeCreatedEventData;\n\n  // Subscription events\n  'subscription.created': SubscriptionCreatedEventData;\n  'subscription.activated': SubscriptionActivatedEventData;\n  'subscription.renewed': SubscriptionRenewedEventData;\n  'subscription.cancelled': SubscriptionCancelledEventData;\n  'subscription.paused': SubscriptionPausedEventData;\n  'subscription.resumed': SubscriptionResumedEventData;\n\n  // Transaction events\n  'transaction.updated': TransactionUpdatedEventData;\n\n  // Escrow events\n  'escrow.held': EscrowHeldEventData;\n  'escrow.released': EscrowReleasedEventData;\n  'escrow.cancelled': EscrowCancelledEventData;\n  'escrow.split': EscrowSplitEventData;\n\n  // Settlement events\n  'settlement.created': SettlementCreatedEventData;\n  'settlement.scheduled': SettlementScheduledEventData;\n  'settlement.processing': SettlementProcessingEventData;\n  'settlement.completed': SettlementCompletedEventData;\n  'settlement.failed': SettlementFailedEventData;\n\n  // Webhook events\n  'webhook.processed': WebhookProcessedEventData;\n}\n\n// ============ EVENT BUS ============\n\ntype EventHandler<T> = (event: T) => void | Promise<void>;\ntype EventKey = keyof RevenueEvents;\n\n/**\n * Type-safe event bus with clean, simple API\n */\nexport class EventBus {\n  private handlers = new Map<string, Set<EventHandler<any>>>();\n  private onceHandlers = new Map<string, Set<EventHandler<any>>>();\n\n  /**\n   * Subscribe to an event\n   */\n  on<K extends EventKey>(\n    event: K,\n    handler: EventHandler<RevenueEvents[K]>\n  ): () => void {\n    if (!this.handlers.has(event)) {\n      this.handlers.set(event, new Set());\n    }\n    this.handlers.get(event)!.add(handler);\n    \n    // Return unsubscribe function\n    return () => this.off(event, handler);\n  }\n\n  /**\n   * Subscribe to an event once\n   */\n  once<K extends EventKey>(\n    event: K,\n    handler: EventHandler<RevenueEvents[K]>\n  ): () => void {\n    if (!this.onceHandlers.has(event)) {\n      this.onceHandlers.set(event, new Set());\n    }\n    this.onceHandlers.get(event)!.add(handler);\n    \n    return () => this.onceHandlers.get(event)?.delete(handler);\n  }\n\n  /**\n   * Unsubscribe from an event\n   */\n  off<K extends EventKey>(\n    event: K,\n    handler: EventHandler<RevenueEvents[K]>\n  ): void {\n    this.handlers.get(event)?.delete(handler);\n    this.onceHandlers.get(event)?.delete(handler);\n  }\n\n  /**\n   * Emit an event (fire and forget, non-blocking)\n   *\n   * @example\n   * ```typescript\n   * events.emit('payment.verified', {\n   *   transaction: txDoc,\n   *   paymentResult: result,\n   *   verifiedBy: 'admin_123'\n   * });\n   * ```\n   */\n  emit<K extends keyof EventDataMap>(event: K, data: EventDataMap[K]): void;\n  emit<K extends EventKey>(event: K, data: any): void {\n    const fullPayload = {\n      ...data,\n      type: event,\n      timestamp: new Date(),\n    } as RevenueEvents[K];\n\n    // Regular handlers\n    const handlers = this.handlers.get(event);\n    if (handlers) {\n      for (const handler of handlers) {\n        // Fire and forget - don't await\n        Promise.resolve(handler(fullPayload)).catch(err => {\n          console.error(`[Revenue] Event handler error for \"${event}\":`, err);\n        });\n      }\n    }\n\n    // Once handlers\n    const onceHandlers = this.onceHandlers.get(event);\n    if (onceHandlers) {\n      for (const handler of onceHandlers) {\n        Promise.resolve(handler(fullPayload)).catch(err => {\n          console.error(`[Revenue] Once handler error for \"${event}\":`, err);\n        });\n      }\n      this.onceHandlers.delete(event);\n    }\n\n    // Wildcard handlers\n    if (event !== '*') {\n      const wildcardHandlers = this.handlers.get('*');\n      if (wildcardHandlers) {\n        for (const handler of wildcardHandlers) {\n          Promise.resolve(handler(fullPayload)).catch(err => {\n            console.error(`[Revenue] Wildcard handler error:`, err);\n          });\n        }\n      }\n    }\n  }\n\n  /**\n   * Emit and wait for all handlers to complete\n   */\n  async emitAsync<K extends EventKey>(\n    event: K,\n    payload: Omit<RevenueEvents[K], 'timestamp' | 'type'>\n  ): Promise<void> {\n    const fullPayload = {\n      ...payload,\n      type: event,\n      timestamp: new Date(),\n    } as RevenueEvents[K];\n\n    const promises: Promise<void>[] = [];\n\n    const handlers = this.handlers.get(event);\n    if (handlers) {\n      for (const handler of handlers) {\n        promises.push(Promise.resolve(handler(fullPayload)));\n      }\n    }\n\n    const onceHandlers = this.onceHandlers.get(event);\n    if (onceHandlers) {\n      for (const handler of onceHandlers) {\n        promises.push(Promise.resolve(handler(fullPayload)));\n      }\n      this.onceHandlers.delete(event);\n    }\n\n    if (event !== '*') {\n      const wildcardHandlers = this.handlers.get('*');\n      if (wildcardHandlers) {\n        for (const handler of wildcardHandlers) {\n          promises.push(Promise.resolve(handler(fullPayload)));\n        }\n      }\n    }\n\n    await Promise.all(promises);\n  }\n\n  /**\n   * Remove all handlers\n   */\n  clear(): void {\n    this.handlers.clear();\n    this.onceHandlers.clear();\n  }\n\n  /**\n   * Get handler count for an event\n   */\n  listenerCount(event: EventKey): number {\n    return (this.handlers.get(event)?.size ?? 0) + \n           (this.onceHandlers.get(event)?.size ?? 0);\n  }\n}\n\n/**\n * Create a new event bus\n */\nexport function createEventBus(): EventBus {\n  return new EventBus();\n}\n\nexport default EventBus;\n\n"]}