@classytic/revenue 1.0.2 → 1.1.2

package/dist/providers/index.d.ts

@@ -1,5 +1,6 @@
-import { q as CreateIntentParams, r as PaymentIntentData, s as PaymentResultData, t as RefundResultData, u as WebhookEventData, v as ProviderCapabilities } from '../index-ChVD3P9k.js';
+import { l as CreateIntentParams, P as PaymentIntentData, b as PaymentResultData, m as RefundResultData, W as WebhookEventData, n as ProviderCapabilities } from '../index-cLJBLUvx.js';
 import 'mongoose';
+import '@classytic/shared-types';
 
 /**
  * Payment Provider Base Class
@@ -19,7 +20,7 @@ declare class PaymentIntent implements PaymentIntentData {
     readonly provider: string;
     readonly status: string;
     readonly amount: number;
-    readonly currency: string;
+    readonly currency?: string;
     readonly metadata: Record<string, unknown>;
     readonly clientSecret?: string;
     readonly paymentUrl?: string;
@@ -33,9 +34,9 @@ declare class PaymentIntent implements PaymentIntentData {
 declare class PaymentResult implements PaymentResultData {
     readonly id: string;
     readonly provider: string;
-    readonly status: 'succeeded' | 'failed' | 'processing';
+    readonly status: 'succeeded' | 'failed' | 'processing' | 'requires_action';
     readonly amount?: number;
-    readonly currency: string;
+    readonly currency?: string;
     readonly paidAt?: Date;
     readonly metadata: Record<string, unknown>;
     readonly raw?: unknown;
@@ -49,7 +50,7 @@ declare class RefundResult implements RefundResultData {
     readonly provider: string;
     readonly status: 'succeeded' | 'failed' | 'processing';
     readonly amount?: number;
-    readonly currency: string;
+    readonly currency?: string;
     readonly refundedAt?: Date;
     readonly reason?: string;
     readonly metadata: Record<string, unknown>;
@@ -79,7 +80,19 @@ declare class WebhookEvent implements WebhookEventData {
 declare abstract class PaymentProvider {
     readonly config: Record<string, unknown>;
     readonly name: string;
+    /** Default currency - injected by Revenue when provider is registered */
+    private _defaultCurrency;
     constructor(config?: Record<string, unknown>);
+    /**
+     * Get the default currency for this provider
+     * Used when creating PaymentIntent, PaymentResult, RefundResult without explicit currency
+     */
+    get defaultCurrency(): string;
+    /**
+     * Set the default currency (called by Revenue when registering provider)
+     * @internal
+     */
+    setDefaultCurrency(currency: string): void;
     /**
      * Create a payment intent
      * @param params - Payment parameters
@@ -129,4 +142,4 @@ declare abstract class PaymentProvider {
     getCapabilities(): ProviderCapabilities;
 }
 
-export { PaymentIntent, PaymentProvider, PaymentProvider as PaymentProviderDefault, PaymentResult, RefundResult, WebhookEvent };
+export { CreateIntentParams, PaymentIntent, PaymentIntentData, PaymentProvider, PaymentProvider as PaymentProviderDefault, PaymentResult, PaymentResultData, ProviderCapabilities, RefundResult, RefundResultData, WebhookEvent, WebhookEventData };

package/dist/providers/index.js

@@ -21,7 +21,7 @@ var PaymentIntent = class {
     this.provider = data.provider;
     this.status = data.status;
     this.amount = data.amount;
-    this.currency = data.currency ?? "BDT";
+    this.currency = data.currency;
     this.metadata = data.metadata ?? {};
     this.clientSecret = data.clientSecret;
     this.paymentUrl = data.paymentUrl;
@@ -43,7 +43,7 @@ var PaymentResult = class {
     this.provider = data.provider;
     this.status = data.status;
     this.amount = data.amount;
-    this.currency = data.currency ?? "BDT";
+    this.currency = data.currency;
     this.paidAt = data.paidAt;
     this.metadata = data.metadata ?? {};
     this.raw = data.raw;
@@ -64,7 +64,7 @@ var RefundResult = class {
     this.provider = data.provider;
     this.status = data.status;
     this.amount = data.amount;
-    this.currency = data.currency ?? "BDT";
+    this.currency = data.currency;
     this.refundedAt = data.refundedAt;
     this.reason = data.reason;
     this.metadata = data.metadata ?? {};
@@ -90,9 +90,28 @@ var WebhookEvent = class {
 var PaymentProvider = class {
   config;
   name;
+  /** Default currency - injected by Revenue when provider is registered */
+  _defaultCurrency = "USD";
   constructor(config = {}) {
     this.config = config;
     this.name = "base";
+    if (config.defaultCurrency && typeof config.defaultCurrency === "string") {
+      this._defaultCurrency = config.defaultCurrency;
+    }
+  }
+  /**
+   * Get the default currency for this provider
+   * Used when creating PaymentIntent, PaymentResult, RefundResult without explicit currency
+   */
+  get defaultCurrency() {
+    return this._defaultCurrency;
+  }
+  /**
+   * Set the default currency (called by Revenue when registering provider)
+   * @internal
+   */
+  setDefaultCurrency(currency) {
+    this._defaultCurrency = currency;
   }
   /**
    * Verify webhook signature (optional)

package/dist/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/providers/base.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Payment Provider Base Class\n * @classytic/revenue\n *\n * Abstract base class for all payment providers\n * Inspired by: Vercel AI SDK, Stripe SDK\n */\n\nimport type {\n  CreateIntentParams,\n  PaymentIntentData,\n  PaymentResultData,\n  RefundResultData,\n  WebhookEventData,\n  ProviderCapabilities,\n} from '../types/index.js';\n\n/**\n * Payment Intent - standardized response from createIntent\n */\nexport class PaymentIntent implements PaymentIntentData {\n  public readonly id: string;\n  public readonly sessionId: string | null;\n  public readonly paymentIntentId: string | null;\n  public readonly provider: string;\n  public readonly status: string;\n  public readonly amount: number;\n  public readonly currency: string;\n  public readonly metadata: Record<string, unknown>;\n  public readonly clientSecret?: string;\n  public readonly paymentUrl?: string;\n  public readonly instructions?: string;\n  public readonly raw?: unknown;\n\n  constructor(data: PaymentIntentData) {\n    this.id = data.id;\n    this.sessionId = data.sessionId ?? null;\n    this.paymentIntentId = data.paymentIntentId ?? null;\n    this.provider = data.provider;\n    this.status = data.status;\n    this.amount = data.amount;\n    this.currency = data.currency ?? 'BDT';\n    this.metadata = data.metadata ?? {};\n    this.clientSecret = data.clientSecret;\n    this.paymentUrl = data.paymentUrl;\n    this.instructions = data.instructions;\n    this.raw = data.raw;\n  }\n}\n\n/**\n * Payment Result - standardized response from verifyPayment\n */\nexport class PaymentResult implements PaymentResultData {\n  public readonly id: string;\n  public readonly provider: string;\n  public readonly status: 'succeeded' | 'failed' | 'processing';\n  public readonly amount?: number;\n  public readonly currency: string;\n  public readonly paidAt?: Date;\n  public readonly metadata: Record<string, unknown>;\n  public readonly raw?: unknown;\n\n  constructor(data: PaymentResultData) {\n    this.id = data.id;\n    this.provider = data.provider;\n    this.status = data.status;\n    this.amount = data.amount;\n    this.currency = data.currency ?? 'BDT';\n    this.paidAt = data.paidAt;\n    this.metadata = data.metadata ?? {};\n    this.raw = data.raw;\n  }\n}\n\n/**\n * Refund Result - standardized response from refund\n */\nexport class RefundResult implements RefundResultData {\n  public readonly id: string;\n  public readonly provider: string;\n  public readonly status: 'succeeded' | 'failed' | 'processing';\n  public readonly amount?: number;\n  public readonly currency: string;\n  public readonly refundedAt?: Date;\n  public readonly reason?: string;\n  public readonly metadata: Record<string, unknown>;\n  public readonly raw?: unknown;\n\n  constructor(data: RefundResultData) {\n    this.id = data.id;\n    this.provider = data.provider;\n    this.status = data.status;\n    this.amount = data.amount;\n    this.currency = data.currency ?? 'BDT';\n    this.refundedAt = data.refundedAt;\n    this.reason = data.reason;\n    this.metadata = data.metadata ?? {};\n    this.raw = data.raw;\n  }\n}\n\n/**\n * Webhook Event - standardized webhook event\n */\nexport class WebhookEvent implements WebhookEventData {\n  public readonly id: string;\n  public readonly provider: string;\n  public readonly type: string;\n  public readonly data: { sessionId?: string; paymentIntentId?: string; [key: string]: unknown };\n  public readonly createdAt?: Date;\n  public readonly raw?: unknown;\n\n  constructor(data: WebhookEventData) {\n    this.id = data.id;\n    this.provider = data.provider;\n    this.type = data.type;\n    this.data = data.data;\n    this.createdAt = data.createdAt;\n    this.raw = data.raw;\n  }\n}\n\n/**\n * Base Payment Provider\n * All payment providers must extend this class\n */\nexport abstract class PaymentProvider {\n  public readonly config: Record<string, unknown>;\n  public readonly name: string;\n\n  constructor(config: Record<string, unknown> = {}) {\n    this.config = config;\n    this.name = 'base'; // Override in subclass\n  }\n\n  /**\n   * Create a payment intent\n   * @param params - Payment parameters\n   * @returns Promise<PaymentIntent>\n   */\n  abstract createIntent(params: CreateIntentParams): Promise<PaymentIntent>;\n\n  /**\n   * Verify a payment\n   * @param intentId - Payment intent ID\n   * @returns Promise<PaymentResult>\n   */\n  abstract verifyPayment(intentId: string): Promise<PaymentResult>;\n\n  /**\n   * Get payment status\n   * @param intentId - Payment intent ID\n   * @returns Promise<PaymentResult>\n   */\n  abstract getStatus(intentId: string): Promise<PaymentResult>;\n\n  /**\n   * Refund a payment\n   * @param paymentId - Payment ID\n   * @param amount - Amount to refund (optional, full refund if not provided)\n   * @param options - Refund options\n   * @returns Promise<RefundResult>\n   */\n  abstract refund(\n    paymentId: string,\n    amount?: number | null,\n    options?: { reason?: string }\n  ): Promise<RefundResult>;\n\n  /**\n   * Handle webhook from provider\n   * @param payload - Webhook payload\n   * @param headers - Request headers (for signature verification)\n   * @returns Promise<WebhookEvent>\n   */\n  abstract handleWebhook(\n    payload: unknown,\n    headers?: Record<string, string>\n  ): Promise<WebhookEvent>;\n\n  /**\n   * Verify webhook signature (optional)\n   * @param payload - Webhook payload\n   * @param signature - Webhook signature\n   * @returns boolean\n   */\n  verifyWebhookSignature(_payload: unknown, _signature: string): boolean {\n    // Override in subclass if provider supports webhook signatures\n    return true;\n  }\n\n  /**\n   * Get provider capabilities\n   * @returns ProviderCapabilities\n   */\n  getCapabilities(): ProviderCapabilities {\n    return {\n      supportsWebhooks: false,\n      supportsRefunds: false,\n      supportsPartialRefunds: false,\n      requiresManualVerification: true,\n    };\n  }\n}\n\nexport default PaymentProvider;\n\n"]}
+{"version":3,"sources":["../../src/providers/base.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Payment Provider Base Class\n * @classytic/revenue\n *\n * Abstract base class for all payment providers\n * Inspired by: Vercel AI SDK, Stripe SDK\n */\n\nimport type {\n  CreateIntentParams,\n  PaymentIntentData,\n  PaymentResultData,\n  RefundResultData,\n  WebhookEventData,\n  ProviderCapabilities,\n} from '../shared/types/index.js';\n\n/**\n * Payment Intent - standardized response from createIntent\n */\nexport class PaymentIntent implements PaymentIntentData {\n  public readonly id: string;\n  public readonly sessionId: string | null;\n  public readonly paymentIntentId: string | null;\n  public readonly provider: string;\n  public readonly status: string;\n  public readonly amount: number;\n  public readonly currency?: string;\n  public readonly metadata: Record<string, unknown>;\n  public readonly clientSecret?: string;\n  public readonly paymentUrl?: string;\n  public readonly instructions?: string;\n  public readonly raw?: unknown;\n\n  constructor(data: PaymentIntentData) {\n    this.id = data.id;\n    this.sessionId = data.sessionId ?? null;\n    this.paymentIntentId = data.paymentIntentId ?? null;\n    this.provider = data.provider;\n    this.status = data.status;\n    this.amount = data.amount;\n    this.currency = data.currency; // Don't default - use app's defaultCurrency config\n    this.metadata = data.metadata ?? {};\n    this.clientSecret = data.clientSecret;\n    this.paymentUrl = data.paymentUrl;\n    this.instructions = data.instructions;\n    this.raw = data.raw;\n  }\n}\n\n/**\n * Payment Result - standardized response from verifyPayment\n */\nexport class PaymentResult implements PaymentResultData {\n  public readonly id: string;\n  public readonly provider: string;\n  public readonly status: 'succeeded' | 'failed' | 'processing' | 'requires_action';\n  public readonly amount?: number;\n  public readonly currency?: string;\n  public readonly paidAt?: Date;\n  public readonly metadata: Record<string, unknown>;\n  public readonly raw?: unknown;\n\n  constructor(data: PaymentResultData) {\n    this.id = data.id;\n    this.provider = data.provider;\n    this.status = data.status;\n    this.amount = data.amount;\n    this.currency = data.currency; // Don't default - let transaction's currency be used\n    this.paidAt = data.paidAt;\n    this.metadata = data.metadata ?? {};\n    this.raw = data.raw;\n  }\n}\n\n/**\n * Refund Result - standardized response from refund\n */\nexport class RefundResult implements RefundResultData {\n  public readonly id: string;\n  public readonly provider: string;\n  public readonly status: 'succeeded' | 'failed' | 'processing';\n  public readonly amount?: number;\n  public readonly currency?: string;\n  public readonly refundedAt?: Date;\n  public readonly reason?: string;\n  public readonly metadata: Record<string, unknown>;\n  public readonly raw?: unknown;\n\n  constructor(data: RefundResultData) {\n    this.id = data.id;\n    this.provider = data.provider;\n    this.status = data.status;\n    this.amount = data.amount;\n    this.currency = data.currency; // Don't default - let transaction's currency be used\n    this.refundedAt = data.refundedAt;\n    this.reason = data.reason;\n    this.metadata = data.metadata ?? {};\n    this.raw = data.raw;\n  }\n}\n\n/**\n * Webhook Event - standardized webhook event\n */\nexport class WebhookEvent implements WebhookEventData {\n  public readonly id: string;\n  public readonly provider: string;\n  public readonly type: string;\n  public readonly data: { sessionId?: string; paymentIntentId?: string; [key: string]: unknown };\n  public readonly createdAt?: Date;\n  public readonly raw?: unknown;\n\n  constructor(data: WebhookEventData) {\n    this.id = data.id;\n    this.provider = data.provider;\n    this.type = data.type;\n    this.data = data.data;\n    this.createdAt = data.createdAt;\n    this.raw = data.raw;\n  }\n}\n\n/**\n * Base Payment Provider\n * All payment providers must extend this class\n */\nexport abstract class PaymentProvider {\n  public readonly config: Record<string, unknown>;\n  public readonly name: string;\n\n  /** Default currency - injected by Revenue when provider is registered */\n  private _defaultCurrency: string = 'USD';\n\n  constructor(config: Record<string, unknown> = {}) {\n    this.config = config;\n    this.name = 'base'; // Override in subclass\n\n    // Allow defaultCurrency to be passed via config\n    if (config.defaultCurrency && typeof config.defaultCurrency === 'string') {\n      this._defaultCurrency = config.defaultCurrency;\n    }\n  }\n\n  /**\n   * Get the default currency for this provider\n   * Used when creating PaymentIntent, PaymentResult, RefundResult without explicit currency\n   */\n  get defaultCurrency(): string {\n    return this._defaultCurrency;\n  }\n\n  /**\n   * Set the default currency (called by Revenue when registering provider)\n   * @internal\n   */\n  setDefaultCurrency(currency: string): void {\n    this._defaultCurrency = currency;\n  }\n\n  /**\n   * Create a payment intent\n   * @param params - Payment parameters\n   * @returns Promise<PaymentIntent>\n   */\n  abstract createIntent(params: CreateIntentParams): Promise<PaymentIntent>;\n\n  /**\n   * Verify a payment\n   * @param intentId - Payment intent ID\n   * @returns Promise<PaymentResult>\n   */\n  abstract verifyPayment(intentId: string): Promise<PaymentResult>;\n\n  /**\n   * Get payment status\n   * @param intentId - Payment intent ID\n   * @returns Promise<PaymentResult>\n   */\n  abstract getStatus(intentId: string): Promise<PaymentResult>;\n\n  /**\n   * Refund a payment\n   * @param paymentId - Payment ID\n   * @param amount - Amount to refund (optional, full refund if not provided)\n   * @param options - Refund options\n   * @returns Promise<RefundResult>\n   */\n  abstract refund(\n    paymentId: string,\n    amount?: number | null,\n    options?: { reason?: string }\n  ): Promise<RefundResult>;\n\n  /**\n   * Handle webhook from provider\n   * @param payload - Webhook payload\n   * @param headers - Request headers (for signature verification)\n   * @returns Promise<WebhookEvent>\n   */\n  abstract handleWebhook(\n    payload: unknown,\n    headers?: Record<string, string>\n  ): Promise<WebhookEvent>;\n\n  /**\n   * Verify webhook signature (optional)\n   * @param payload - Webhook payload\n   * @param signature - Webhook signature\n   * @returns boolean\n   */\n  verifyWebhookSignature(_payload: unknown, _signature: string): boolean {\n    // Override in subclass if provider supports webhook signatures\n    return true;\n  }\n\n  /**\n   * Get provider capabilities\n   * @returns ProviderCapabilities\n   */\n  getCapabilities(): ProviderCapabilities {\n    return {\n      supportsWebhooks: false,\n      supportsRefunds: false,\n      supportsPartialRefunds: false,\n      requiresManualVerification: true,\n    };\n  }\n}\n\nexport default PaymentProvider;\n\n"]}

package/dist/reconciliation/index.d.ts

@@ -0,0 +1,215 @@
+import { T as TransactionDocument, M as MongooseModel } from '../index-cLJBLUvx.js';
+import 'mongoose';
+import '@classytic/shared-types';
+
+/**
+ * Reconciliation Types
+ * @classytic/revenue
+ *
+ * Types for comparing gateway reports with database records
+ */
+
+/**
+ * Gateway Settlement Record
+ * Data from payment gateway's settlement report (Stripe, PayPal, etc.)
+ */
+interface GatewaySettlement {
+    /** Settlement ID from gateway */
+    settlementId: string;
+    /** Transaction/payment ID from gateway */
+    transactionId: string;
+    /** Amount settled */
+    amount: number;
+    /** Currency */
+    currency: string;
+    /** When funds were settled */
+    settledAt: Date;
+    /** Gateway fee deducted */
+    gatewayFee?: number;
+    /** Net amount received (amount - gatewayFee) */
+    netAmount?: number;
+    /** Payment status in gateway */
+    status?: string;
+    /** Additional gateway metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Reconciliation Options
+ * Configuration for reconciliation process
+ */
+interface ReconciliationOptions {
+    /** Filter by organization */
+    organizationId?: string;
+    /** Filter by payment gateway */
+    gateway?: string;
+    /** Start date for reconciliation period */
+    startDate?: Date;
+    /** End date for reconciliation period */
+    endDate?: Date;
+    /** Automatically match by transactionId */
+    autoMatch?: boolean;
+    /** Tolerance for amount mismatches (in cents) */
+    amountTolerance?: number;
+}
+/**
+ * Reconciliation Report
+ * Result of reconciling gateway settlements with database transactions
+ */
+interface ReconciliationReport {
+    /** Summary statistics */
+    summary: {
+        /** Total transactions in gateway report */
+        totalGatewayTransactions: number;
+        /** Total transactions in database */
+        totalDbTransactions: number;
+        /** Number of matched transactions */
+        matched: number;
+        /** Number missing in database */
+        missing: number;
+        /** Number extra in database (not in gateway) */
+        extra: number;
+        /** Number with amount mismatches */
+        amountMismatches: number;
+        /** Total amount difference across all mismatches */
+        totalAmountDiff: number;
+    };
+    /** Transactions in gateway but not in database */
+    missingInDb: GatewaySettlement[];
+    /** Transactions in database but not in gateway */
+    missingInGateway: TransactionDocument[];
+    /** Transactions with amount mismatches */
+    amountMismatches: Array<{
+        transactionId: string;
+        gatewayAmount: number;
+        dbAmount: number;
+        diff: number;
+        transaction?: TransactionDocument;
+        gatewayRecord?: GatewaySettlement;
+    }>;
+    /** Successfully matched transactions */
+    matched: Array<{
+        transactionId: string;
+        amount: number;
+        transaction: TransactionDocument;
+        gatewayRecord: GatewaySettlement;
+    }>;
+    /** Reconciliation metadata */
+    metadata: {
+        reconciledAt: Date;
+        period: {
+            start?: Date;
+            end?: Date;
+        };
+        gateway?: string;
+        organizationId?: string;
+    };
+}
+/**
+ * Discrepancy Type
+ */
+type DiscrepancyType = 'missing_in_db' | 'missing_in_gateway' | 'amount_mismatch' | 'status_mismatch';
+/**
+ * Discrepancy Record
+ * Individual reconciliation discrepancy
+ */
+interface Discrepancy {
+    type: DiscrepancyType;
+    transactionId: string;
+    severity: 'low' | 'medium' | 'high';
+    description: string;
+    gatewayData?: GatewaySettlement;
+    dbData?: TransactionDocument;
+    diff?: number;
+}
+
+/**
+ * Reconciliation Utilities
+ * @classytic/revenue
+ *
+ * Compare gateway settlement reports with database transactions
+ * Find missing transactions, amount mismatches, and discrepancies
+ */
+
+/**
+ * Reconcile gateway settlements with database transactions
+ *
+ * Compares payment gateway's settlement report with your database to identify:
+ * - Transactions in gateway but missing in DB
+ * - Transactions in DB but missing in gateway
+ * - Amount mismatches between gateway and DB
+ *
+ * @param gatewaySettlements - Settlement data from payment gateway
+ * @param TransactionModel - Mongoose Transaction model
+ * @param options - Reconciliation options
+ * @returns Reconciliation report with findings
+ *
+ * @example
+ * ```typescript
+ * import { reconcileSettlement } from '@classytic/revenue/reconciliation';
+ *
+ * // Get Stripe settlements for January
+ * const stripeSettlements = await stripe.balanceTransactions.list({
+ *   created: { gte: jan1, lte: jan31 },
+ * });
+ *
+ * // Reconcile with database
+ * const report = await reconcileSettlement(
+ *   stripeSettlements.data.map(s => ({
+ *     settlementId: s.id,
+ *     transactionId: s.source,
+ *     amount: s.amount,
+ *     currency: s.currency,
+ *     settledAt: new Date(s.created * 1000),
+ *     gatewayFee: s.fee,
+ *     netAmount: s.net,
+ *   })),
+ *   TransactionModel,
+ *   { gateway: 'stripe', startDate: jan1, endDate: jan31 }
+ * );
+ *
+ * console.log(report.summary);
+ * // { matched: 1245, missing: 2, extra: 1, amountMismatches: 3 }
+ * ```
+ */
+declare function reconcileSettlement(gatewaySettlements: GatewaySettlement[], TransactionModel: MongooseModel<TransactionDocument>, options?: ReconciliationOptions): Promise<ReconciliationReport>;
+/**
+ * Find transactions missing in database
+ *
+ * @param organizationId - Organization to check
+ * @param dateRange - Date range to search
+ * @param gateway - Payment gateway
+ * @param TransactionModel - Mongoose Transaction model
+ * @returns Missing transaction IDs
+ */
+declare function findMissingTransactions(_organizationId: string, _dateRange: {
+    start: Date;
+    end: Date;
+}, _gateway: string, _TransactionModel: MongooseModel<TransactionDocument>): Promise<{
+    inGateway: string[];
+    inDb: string[];
+}>;
+/**
+ * Find amount mismatches between gateway and database
+ *
+ * @param organizationId - Organization to check
+ * @param dateRange - Date range to search
+ * @param threshold - Amount difference threshold (cents)
+ * @param TransactionModel - Mongoose Transaction model
+ * @returns Array of mismatches
+ */
+declare function findAmountMismatches(_organizationId: string, _dateRange: {
+    start: Date;
+    end: Date;
+}, _threshold: number | undefined, _TransactionModel: MongooseModel<TransactionDocument>): Promise<Array<{
+    transactionId: string;
+    diff: number;
+}>>;
+/**
+ * Generate reconciliation discrepancies
+ *
+ * @param report - Reconciliation report
+ * @returns Array of discrepancies sorted by severity
+ */
+declare function generateDiscrepancies(report: ReconciliationReport): Discrepancy[];
+
+export { type Discrepancy, type DiscrepancyType, type GatewaySettlement, type ReconciliationOptions, type ReconciliationReport, findAmountMismatches, findMissingTransactions, generateDiscrepancies, reconcileSettlement };

package/dist/reconciliation/index.js

@@ -0,0 +1,140 @@
+// @classytic/revenue - Enterprise Revenue Management System
+
+// src/reconciliation/reconciler.ts
+async function reconcileSettlement(gatewaySettlements, TransactionModel, options = {}) {
+  const {
+    organizationId,
+    gateway,
+    startDate,
+    endDate,
+    autoMatch: _autoMatch = true,
+    amountTolerance = 1
+    // 1 cent tolerance
+  } = options;
+  const query = {};
+  if (organizationId) query.organizationId = organizationId;
+  if (gateway) query["gateway.type"] = gateway;
+  if (startDate || endDate) {
+    query.createdAt = {};
+    if (startDate) query.createdAt.$gte = startDate;
+    if (endDate) query.createdAt.$lte = endDate;
+  }
+  const dbTransactions = await TransactionModel.find(query);
+  const gatewayMap = /* @__PURE__ */ new Map();
+  const dbMap = /* @__PURE__ */ new Map();
+  for (const settlement of gatewaySettlements) {
+    gatewayMap.set(settlement.transactionId, settlement);
+  }
+  for (const transaction of dbTransactions) {
+    const key = transaction.gateway?.paymentIntentId || transaction._id.toString();
+    dbMap.set(key, transaction);
+  }
+  const report = {
+    summary: {
+      totalGatewayTransactions: gatewaySettlements.length,
+      totalDbTransactions: dbTransactions.length,
+      matched: 0,
+      missing: 0,
+      extra: 0,
+      amountMismatches: 0,
+      totalAmountDiff: 0
+    },
+    missingInDb: [],
+    missingInGateway: [],
+    amountMismatches: [],
+    matched: [],
+    metadata: {
+      reconciledAt: /* @__PURE__ */ new Date(),
+      period: { start: startDate, end: endDate },
+      gateway,
+      organizationId
+    }
+  };
+  for (const [gatewayTxId, gatewaySettlement] of gatewayMap.entries()) {
+    const dbTransaction = dbMap.get(gatewayTxId);
+    if (!dbTransaction) {
+      report.missingInDb.push(gatewaySettlement);
+      report.summary.missing++;
+    } else {
+      const amountDiff = Math.abs(dbTransaction.amount - gatewaySettlement.amount);
+      if (amountDiff > amountTolerance) {
+        report.amountMismatches.push({
+          transactionId: gatewayTxId,
+          gatewayAmount: gatewaySettlement.amount,
+          dbAmount: dbTransaction.amount,
+          diff: dbTransaction.amount - gatewaySettlement.amount,
+          transaction: dbTransaction,
+          gatewayRecord: gatewaySettlement
+        });
+        report.summary.amountMismatches++;
+        report.summary.totalAmountDiff += amountDiff;
+      } else {
+        report.matched.push({
+          transactionId: gatewayTxId,
+          amount: dbTransaction.amount,
+          transaction: dbTransaction,
+          gatewayRecord: gatewaySettlement
+        });
+        report.summary.matched++;
+      }
+      dbMap.delete(gatewayTxId);
+    }
+  }
+  for (const [_, transaction] of dbMap.entries()) {
+    report.missingInGateway.push(transaction);
+    report.summary.extra++;
+  }
+  return report;
+}
+async function findMissingTransactions(_organizationId, _dateRange, _gateway, _TransactionModel) {
+  return {
+    inGateway: [],
+    // Transactions in gateway but not in DB
+    inDb: []
+    // Transactions in DB but not confirmed by gateway
+  };
+}
+async function findAmountMismatches(_organizationId, _dateRange, _threshold = 1, _TransactionModel) {
+  const mismatches = [];
+  return mismatches;
+}
+function generateDiscrepancies(report) {
+  const discrepancies = [];
+  for (const gateway of report.missingInDb) {
+    discrepancies.push({
+      type: "missing_in_db",
+      transactionId: gateway.transactionId,
+      severity: "high",
+      description: `Transaction ${gateway.transactionId} found in gateway (${gateway.amount} ${gateway.currency}) but missing in database`,
+      gatewayData: gateway
+    });
+  }
+  for (const transaction of report.missingInGateway) {
+    discrepancies.push({
+      type: "missing_in_gateway",
+      transactionId: transaction._id.toString(),
+      severity: "medium",
+      description: `Transaction ${transaction._id} found in database but not in gateway report`,
+      dbData: transaction
+    });
+  }
+  for (const mismatch of report.amountMismatches) {
+    const severity = Math.abs(mismatch.diff) > 1e3 ? "high" : Math.abs(mismatch.diff) > 100 ? "medium" : "low";
+    discrepancies.push({
+      type: "amount_mismatch",
+      transactionId: mismatch.transactionId,
+      severity,
+      description: `Amount mismatch: Gateway shows ${mismatch.gatewayAmount}, DB shows ${mismatch.dbAmount} (diff: ${mismatch.diff})`,
+      gatewayData: mismatch.gatewayRecord,
+      dbData: mismatch.transaction,
+      diff: mismatch.diff
+    });
+  }
+  const severityOrder = { high: 0, medium: 1, low: 2 };
+  discrepancies.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+  return discrepancies;
+}
+
+export { findAmountMismatches, findMissingTransactions, generateDiscrepancies, reconcileSettlement };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/reconciliation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/reconciliation/reconciler.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Reconciliation Utilities\n * @classytic/revenue\n *\n * Compare gateway settlement reports with database transactions\n * Find missing transactions, amount mismatches, and discrepancies\n */\n\nimport type {\n  GatewaySettlement,\n  ReconciliationOptions,\n  ReconciliationReport,\n  Discrepancy,\n} from '../shared/types/reconciliation.js';\nimport type { TransactionDocument, MongooseModel } from '../shared/types/index.js';\n\n/**\n * Reconcile gateway settlements with database transactions\n *\n * Compares payment gateway's settlement report with your database to identify:\n * - Transactions in gateway but missing in DB\n * - Transactions in DB but missing in gateway\n * - Amount mismatches between gateway and DB\n *\n * @param gatewaySettlements - Settlement data from payment gateway\n * @param TransactionModel - Mongoose Transaction model\n * @param options - Reconciliation options\n * @returns Reconciliation report with findings\n *\n * @example\n * ```typescript\n * import { reconcileSettlement } from '@classytic/revenue/reconciliation';\n *\n * // Get Stripe settlements for January\n * const stripeSettlements = await stripe.balanceTransactions.list({\n *   created: { gte: jan1, lte: jan31 },\n * });\n *\n * // Reconcile with database\n * const report = await reconcileSettlement(\n *   stripeSettlements.data.map(s => ({\n *     settlementId: s.id,\n *     transactionId: s.source,\n *     amount: s.amount,\n *     currency: s.currency,\n *     settledAt: new Date(s.created * 1000),\n *     gatewayFee: s.fee,\n *     netAmount: s.net,\n *   })),\n *   TransactionModel,\n *   { gateway: 'stripe', startDate: jan1, endDate: jan31 }\n * );\n *\n * console.log(report.summary);\n * // { matched: 1245, missing: 2, extra: 1, amountMismatches: 3 }\n * ```\n */\nexport async function reconcileSettlement(\n  gatewaySettlements: GatewaySettlement[],\n  TransactionModel: MongooseModel<TransactionDocument>,\n  options: ReconciliationOptions = {}\n): Promise<ReconciliationReport> {\n  const {\n    organizationId,\n    gateway,\n    startDate,\n    endDate,\n    autoMatch: _autoMatch = true,\n    amountTolerance = 1, // 1 cent tolerance\n  } = options;\n\n  // Build query for DB transactions\n  const query: Record<string, unknown> = {};\n  if (organizationId) query.organizationId = organizationId;\n  if (gateway) query['gateway.type'] = gateway;\n\n  if (startDate || endDate) {\n    query.createdAt = {};\n    if (startDate) (query.createdAt as Record<string, unknown>).$gte = startDate;\n    if (endDate) (query.createdAt as Record<string, unknown>).$lte = endDate;\n  }\n\n  // Get database transactions\n  const dbTransactions = await (TransactionModel as unknown as {\n    find(filter: object): Promise<TransactionDocument[]>;\n  }).find(query);\n\n  // Create lookup maps\n  const gatewayMap = new Map<string, GatewaySettlement>();\n  const dbMap = new Map<string, TransactionDocument>();\n\n  for (const settlement of gatewaySettlements) {\n    gatewayMap.set(settlement.transactionId, settlement);\n  }\n\n  for (const transaction of dbTransactions) {\n    // Use gateway.paymentIntentId as the key for matching\n    const key = (transaction.gateway?.paymentIntentId || transaction._id.toString());\n    dbMap.set(key, transaction);\n  }\n\n  // Initialize report\n  const report: ReconciliationReport = {\n    summary: {\n      totalGatewayTransactions: gatewaySettlements.length,\n      totalDbTransactions: dbTransactions.length,\n      matched: 0,\n      missing: 0,\n      extra: 0,\n      amountMismatches: 0,\n      totalAmountDiff: 0,\n    },\n    missingInDb: [],\n    missingInGateway: [],\n    amountMismatches: [],\n    matched: [],\n    metadata: {\n      reconciledAt: new Date(),\n      period: { start: startDate, end: endDate },\n      gateway,\n      organizationId,\n    },\n  };\n\n  // Find matches and mismatches\n  for (const [gatewayTxId, gatewaySettlement] of gatewayMap.entries()) {\n    const dbTransaction = dbMap.get(gatewayTxId);\n\n    if (!dbTransaction) {\n      // Missing in DB\n      report.missingInDb.push(gatewaySettlement);\n      report.summary.missing++;\n    } else {\n      // Found - check amount\n      const amountDiff = Math.abs(dbTransaction.amount - gatewaySettlement.amount);\n\n      if (amountDiff > amountTolerance) {\n        // Amount mismatch\n        report.amountMismatches.push({\n          transactionId: gatewayTxId,\n          gatewayAmount: gatewaySettlement.amount,\n          dbAmount: dbTransaction.amount,\n          diff: dbTransaction.amount - gatewaySettlement.amount,\n          transaction: dbTransaction,\n          gatewayRecord: gatewaySettlement,\n        });\n        report.summary.amountMismatches++;\n        report.summary.totalAmountDiff += amountDiff;\n      } else {\n        // Matched!\n        report.matched.push({\n          transactionId: gatewayTxId,\n          amount: dbTransaction.amount,\n          transaction: dbTransaction,\n          gatewayRecord: gatewaySettlement,\n        });\n        report.summary.matched++;\n      }\n\n      // Mark as processed\n      dbMap.delete(gatewayTxId);\n    }\n  }\n\n  // Remaining DB transactions = extra (not in gateway)\n  for (const [_, transaction] of dbMap.entries()) {\n    report.missingInGateway.push(transaction);\n    report.summary.extra++;\n  }\n\n  return report;\n}\n\n/**\n * Find transactions missing in database\n *\n * @param organizationId - Organization to check\n * @param dateRange - Date range to search\n * @param gateway - Payment gateway\n * @param TransactionModel - Mongoose Transaction model\n * @returns Missing transaction IDs\n */\nexport async function findMissingTransactions(\n  _organizationId: string,\n  _dateRange: { start: Date; end: Date },\n  _gateway: string,\n  _TransactionModel: MongooseModel<TransactionDocument>\n): Promise<{ inGateway: string[]; inDb: string[] }> {\n  // This is a simplified version - in production, you'd fetch from gateway API\n  // For now, return structure for apps to implement\n  return {\n    inGateway: [], // Transactions in gateway but not in DB\n    inDb: [],      // Transactions in DB but not confirmed by gateway\n  };\n}\n\n/**\n * Find amount mismatches between gateway and database\n *\n * @param organizationId - Organization to check\n * @param dateRange - Date range to search\n * @param threshold - Amount difference threshold (cents)\n * @param TransactionModel - Mongoose Transaction model\n * @returns Array of mismatches\n */\nexport async function findAmountMismatches(\n  _organizationId: string,\n  _dateRange: { start: Date; end: Date },\n  _threshold: number = 1,\n  _TransactionModel: MongooseModel<TransactionDocument>\n): Promise<Array<{ transactionId: string; diff: number }>> {\n  // This is a stub function for apps to implement\n  // In production, query transactions and compare with gateway data\n\n  const mismatches: Array<{ transactionId: string; diff: number }> = [];\n\n  return mismatches;\n}\n\n/**\n * Generate reconciliation discrepancies\n *\n * @param report - Reconciliation report\n * @returns Array of discrepancies sorted by severity\n */\nexport function generateDiscrepancies(report: ReconciliationReport): Discrepancy[] {\n  const discrepancies: Discrepancy[] = [];\n\n  // Missing in DB (HIGH severity)\n  for (const gateway of report.missingInDb) {\n    discrepancies.push({\n      type: 'missing_in_db',\n      transactionId: gateway.transactionId,\n      severity: 'high',\n      description: `Transaction ${gateway.transactionId} found in gateway (${gateway.amount} ${gateway.currency}) but missing in database`,\n      gatewayData: gateway,\n    });\n  }\n\n  // Missing in gateway (MEDIUM severity)\n  for (const transaction of report.missingInGateway) {\n    discrepancies.push({\n      type: 'missing_in_gateway',\n      transactionId: transaction._id.toString(),\n      severity: 'medium',\n      description: `Transaction ${transaction._id} found in database but not in gateway report`,\n      dbData: transaction,\n    });\n  }\n\n  // Amount mismatches (severity based on amount)\n  for (const mismatch of report.amountMismatches) {\n    const severity: 'low' | 'medium' | 'high' = Math.abs(mismatch.diff) > 1000 ? 'high' : Math.abs(mismatch.diff) > 100 ? 'medium' : 'low';\n\n    discrepancies.push({\n      type: 'amount_mismatch',\n      transactionId: mismatch.transactionId,\n      severity,\n      description: `Amount mismatch: Gateway shows ${mismatch.gatewayAmount}, DB shows ${mismatch.dbAmount} (diff: ${mismatch.diff})`,\n      gatewayData: mismatch.gatewayRecord,\n      dbData: mismatch.transaction,\n      diff: mismatch.diff,\n    });\n  }\n\n  // Sort by severity\n  const severityOrder = { high: 0, medium: 1, low: 2 };\n  discrepancies.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);\n\n  return discrepancies;\n}\n"]}

package/dist/{retry-80lBCmSe.d.ts → retry-D4hFUwVk.d.ts}

@@ -123,43 +123,10 @@ interface RetryConfig {
     /** Callback on each retry */
     onRetry?: (error: unknown, attempt: number, delay: number) => void;
 }
-interface RetryState {
-    attempt: number;
-    totalDelay: number;
-    errors: Error[];
-}
-/**
- * Calculate delay with exponential backoff and jitter
- */
-declare function calculateDelay(attempt: number, config: RetryConfig): number;
-/**
- * Check if error is retryable by default
- */
-declare function isRetryableError(error: unknown): boolean;
 /**
  * Execute operation with retry logic
  */
 declare function retry<T>(operation: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
-/**
- * Execute operation with retry, returning Result instead of throwing
- */
-declare function retryWithResult<T>(operation: () => Promise<T>, config?: Partial<RetryConfig>): Promise<Result<T, RetryExhaustedError>>;
-/**
- * Error thrown when all retries are exhausted
- */
-declare class RetryExhaustedError extends Error {
-    readonly attempts: number;
-    readonly errors: Error[];
-    constructor(message: string, errors: Error[]);
-    /**
-     * Get the last error
-     */
-    get lastError(): Error | undefined;
-    /**
-     * Get the first error
-     */
-    get firstError(): Error | undefined;
-}
 type CircuitState = 'closed' | 'open' | 'half-open';
 interface CircuitBreakerConfig {
     /** Number of failures before opening circuit */
@@ -223,12 +190,5 @@ declare class CircuitOpenError extends Error {
  * Create a circuit breaker
  */
 declare function createCircuitBreaker(config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
-/**
- * Execute with both retry and circuit breaker
- */
-declare function resilientExecute<T>(operation: () => Promise<T>, options?: {
-    retry?: Partial<RetryConfig>;
-    circuitBreaker?: CircuitBreaker;
-}): Promise<T>;
 
-export { CircuitBreaker as C, type Err as E, type Ok as O, Result as R, isErr as a, unwrapOr as b, mapErr as c, tryCatchSync as d, err as e, flatMap as f, all as g, match as h, isOk as i, retryWithResult as j, calculateDelay as k, isRetryableError as l, map as m, RetryExhaustedError as n, ok as o, createCircuitBreaker as p, CircuitOpenError as q, retry as r, resilientExecute as s, tryCatch as t, unwrap as u, type CircuitState as v, type CircuitBreakerConfig as w, type RetryConfig as x, type RetryState as y };
+export { CircuitBreaker as C, type Err as E, type Ok as O, Result as R, isErr as a, unwrapOr as b, mapErr as c, tryCatchSync as d, err as e, flatMap as f, all as g, match as h, isOk as i, createCircuitBreaker as j, type RetryConfig as k, type CircuitBreakerConfig as l, map as m, type CircuitState as n, ok as o, retry as r, tryCatch as t, unwrap as u };