@skillsmith/core 0.2.0 → 0.4.0

package/dist/src/billing/StripeReconciliationJob.js

@@ -0,0 +1,405 @@
+/**
+ * SMI-1069: Stripe Reconciliation Job
+ *
+ * Periodically reconciles local subscription and invoice data with Stripe.
+ * Identifies and reports discrepancies to ensure data consistency.
+ *
+ * Features:
+ * - Subscription status sync
+ * - Invoice status verification
+ * - Missing data detection
+ * - Automatic correction (optional)
+ * - Detailed reporting
+ */
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('StripeReconciliation');
+// ============================================================================
+// StripeReconciliationJob Class
+// ============================================================================
+/**
+ * Stripe Reconciliation Job
+ *
+ * @example
+ * ```typescript
+ * const job = new StripeReconciliationJob({
+ *   stripeClient,
+ *   db,
+ *   autoFix: true,
+ * });
+ *
+ * // Run reconciliation
+ * const result = await job.run();
+ * console.log(`Found ${result.discrepancies.length} discrepancies`);
+ * ```
+ */
+export class StripeReconciliationJob {
+    stripe;
+    db;
+    autoFix;
+    batchSize;
+    constructor(config) {
+        this.stripe = config.stripeClient;
+        this.db = config.db;
+        this.autoFix = config.autoFix ?? false;
+        this.batchSize = config.batchSize ?? 100;
+        logger.info('Stripe reconciliation job initialized', {
+            autoFix: this.autoFix,
+            batchSize: this.batchSize,
+        });
+    }
+    // ==========================================================================
+    // Main Entry Point
+    // ==========================================================================
+    /**
+     * Run the reconciliation job
+     */
+    async run() {
+        const startedAt = new Date();
+        const discrepancies = [];
+        const errors = [];
+        let subscriptionsChecked = 0;
+        let invoicesChecked = 0;
+        let discrepanciesFixed = 0;
+        logger.info('Starting Stripe reconciliation job');
+        try {
+            // 1. Get all local subscriptions with Stripe IDs
+            const localSubscriptions = this.getLocalSubscriptions();
+            subscriptionsChecked = localSubscriptions.length;
+            // 2. Reconcile each subscription
+            for (const local of localSubscriptions) {
+                try {
+                    const subDiscrepancies = await this.reconcileSubscription(local);
+                    discrepancies.push(...subDiscrepancies);
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    errors.push(`Subscription ${local.stripeSubscriptionId}: ${errorMsg}`);
+                }
+            }
+            // 3. Reconcile invoices
+            const localInvoices = this.getLocalInvoices();
+            invoicesChecked = localInvoices.length;
+            for (const invoice of localInvoices) {
+                try {
+                    const invDiscrepancies = await this.reconcileInvoice(invoice);
+                    discrepancies.push(...invDiscrepancies);
+                }
+                catch (error) {
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    errors.push(`Invoice ${invoice.stripeInvoiceId}: ${errorMsg}`);
+                }
+            }
+            // 4. Apply fixes if autoFix is enabled
+            if (this.autoFix) {
+                for (const discrepancy of discrepancies) {
+                    if (this.fixDiscrepancy(discrepancy)) {
+                        discrepancy.fixed = true;
+                        discrepanciesFixed++;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            errors.push(`Job failed: ${errorMsg}`);
+            logger.error('Reconciliation job failed', undefined, { error: errorMsg });
+        }
+        const completedAt = new Date();
+        const result = {
+            success: errors.length === 0,
+            startedAt: startedAt.toISOString(),
+            completedAt: completedAt.toISOString(),
+            durationMs: completedAt.getTime() - startedAt.getTime(),
+            stats: {
+                subscriptionsChecked,
+                invoicesChecked,
+                discrepanciesFound: discrepancies.length,
+                discrepanciesFixed,
+            },
+            discrepancies,
+            errors,
+        };
+        logger.info('Stripe reconciliation job completed', {
+            success: result.success,
+            subscriptionsChecked,
+            invoicesChecked,
+            discrepanciesFound: discrepancies.length,
+            discrepanciesFixed,
+            durationMs: result.durationMs,
+        });
+        return result;
+    }
+    // ==========================================================================
+    // Subscription Reconciliation
+    // ==========================================================================
+    getLocalSubscriptions() {
+        return this.db
+            .prepare(`SELECT
+          id,
+          customer_id as customerId,
+          stripe_subscription_id as stripeSubscriptionId,
+          stripe_customer_id as stripeCustomerId,
+          tier,
+          status,
+          seat_count as seatCount,
+          current_period_start as currentPeriodStart,
+          current_period_end as currentPeriodEnd
+        FROM user_subscriptions
+        WHERE stripe_subscription_id IS NOT NULL
+        LIMIT ?`)
+            .all(this.batchSize);
+    }
+    async reconcileSubscription(local) {
+        const discrepancies = [];
+        // Fetch from Stripe
+        const stripeSubscription = await this.stripe.getSubscription(local.stripeSubscriptionId);
+        if (!stripeSubscription) {
+            discrepancies.push({
+                type: 'missing_stripe',
+                entityType: 'subscription',
+                entityId: local.id,
+                stripeId: local.stripeSubscriptionId,
+                localValue: local.status,
+                stripeValue: null,
+                description: 'Subscription exists locally but not in Stripe',
+                fixed: false,
+            });
+            return discrepancies;
+        }
+        // Compare status
+        const stripeStatus = mapStripeStatus(stripeSubscription.status);
+        if (local.status !== stripeStatus) {
+            discrepancies.push({
+                type: 'status_mismatch',
+                entityType: 'subscription',
+                entityId: local.id,
+                stripeId: local.stripeSubscriptionId,
+                localValue: local.status,
+                stripeValue: stripeStatus,
+                description: `Status mismatch: local=${local.status}, stripe=${stripeStatus}`,
+                fixed: false,
+            });
+        }
+        // Compare tier (from metadata)
+        const stripeTier = stripeSubscription.metadata?.tier;
+        if (stripeTier && local.tier !== stripeTier) {
+            discrepancies.push({
+                type: 'tier_mismatch',
+                entityType: 'subscription',
+                entityId: local.id,
+                stripeId: local.stripeSubscriptionId,
+                localValue: local.tier,
+                stripeValue: stripeTier,
+                description: `Tier mismatch: local=${local.tier}, stripe=${stripeTier}`,
+                fixed: false,
+            });
+        }
+        // Compare seat count
+        const stripeQuantity = stripeSubscription.items.data[0]?.quantity ?? 1;
+        if (local.seatCount !== stripeQuantity) {
+            discrepancies.push({
+                type: 'seat_count_mismatch',
+                entityType: 'subscription',
+                entityId: local.id,
+                stripeId: local.stripeSubscriptionId,
+                localValue: local.seatCount,
+                stripeValue: stripeQuantity,
+                description: `Seat count mismatch: local=${local.seatCount}, stripe=${stripeQuantity}`,
+                fixed: false,
+            });
+        }
+        return discrepancies;
+    }
+    // ==========================================================================
+    // Invoice Reconciliation
+    // ==========================================================================
+    getLocalInvoices() {
+        return this.db
+            .prepare(`SELECT
+          id,
+          customer_id as customerId,
+          stripe_invoice_id as stripeInvoiceId,
+          amount_cents as amountCents,
+          status
+        FROM invoices
+        WHERE stripe_invoice_id IS NOT NULL
+        LIMIT ?`)
+            .all(this.batchSize);
+    }
+    async reconcileInvoice(local) {
+        const discrepancies = [];
+        // Fetch from Stripe
+        const stripeInvoice = await this.stripe.getInvoice(local.stripeInvoiceId);
+        if (!stripeInvoice) {
+            discrepancies.push({
+                type: 'missing_stripe',
+                entityType: 'invoice',
+                entityId: local.id,
+                stripeId: local.stripeInvoiceId,
+                localValue: local.status,
+                stripeValue: null,
+                description: 'Invoice exists locally but not in Stripe',
+                fixed: false,
+            });
+            return discrepancies;
+        }
+        // Compare status
+        const stripeStatus = mapInvoiceStatus(stripeInvoice.status);
+        if (local.status !== stripeStatus) {
+            discrepancies.push({
+                type: 'invoice_status_mismatch',
+                entityType: 'invoice',
+                entityId: local.id,
+                stripeId: local.stripeInvoiceId,
+                localValue: local.status,
+                stripeValue: stripeStatus,
+                description: `Invoice status mismatch: local=${local.status}, stripe=${stripeStatus}`,
+                fixed: false,
+            });
+        }
+        // Compare amount
+        const stripeAmount = stripeInvoice.amount_paid ?? stripeInvoice.amount_due;
+        if (local.amountCents !== stripeAmount) {
+            discrepancies.push({
+                type: 'invoice_amount_mismatch',
+                entityType: 'invoice',
+                entityId: local.id,
+                stripeId: local.stripeInvoiceId,
+                localValue: local.amountCents,
+                stripeValue: stripeAmount,
+                description: `Invoice amount mismatch: local=${local.amountCents}, stripe=${stripeAmount}`,
+                fixed: false,
+            });
+        }
+        return discrepancies;
+    }
+    // ==========================================================================
+    // Fix Discrepancies
+    // ==========================================================================
+    fixDiscrepancy(discrepancy) {
+        try {
+            if (discrepancy.entityType === 'subscription') {
+                return this.fixSubscriptionDiscrepancy(discrepancy);
+            }
+            else if (discrepancy.entityType === 'invoice') {
+                return this.fixInvoiceDiscrepancy(discrepancy);
+            }
+            return false;
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.error('Failed to fix discrepancy', undefined, {
+                type: discrepancy.type,
+                entityId: discrepancy.entityId,
+                error: errorMsg,
+            });
+            return false;
+        }
+    }
+    fixSubscriptionDiscrepancy(discrepancy) {
+        switch (discrepancy.type) {
+            case 'status_mismatch':
+                this.db
+                    .prepare(`UPDATE user_subscriptions SET status = ?, updated_at = ? WHERE id = ?`)
+                    .run(discrepancy.stripeValue, new Date().toISOString(), discrepancy.entityId);
+                logger.info('Fixed subscription status', {
+                    entityId: discrepancy.entityId,
+                    newStatus: discrepancy.stripeValue,
+                });
+                return true;
+            case 'tier_mismatch':
+                this.db
+                    .prepare(`UPDATE user_subscriptions SET tier = ?, updated_at = ? WHERE id = ?`)
+                    .run(discrepancy.stripeValue, new Date().toISOString(), discrepancy.entityId);
+                logger.info('Fixed subscription tier', {
+                    entityId: discrepancy.entityId,
+                    newTier: discrepancy.stripeValue,
+                });
+                return true;
+            case 'seat_count_mismatch':
+                this.db
+                    .prepare(`UPDATE user_subscriptions SET seat_count = ?, updated_at = ? WHERE id = ?`)
+                    .run(discrepancy.stripeValue, new Date().toISOString(), discrepancy.entityId);
+                logger.info('Fixed subscription seat count', {
+                    entityId: discrepancy.entityId,
+                    newSeatCount: discrepancy.stripeValue,
+                });
+                return true;
+            case 'missing_stripe':
+                // Mark local subscription as canceled if missing in Stripe
+                this.db
+                    .prepare(`UPDATE user_subscriptions SET status = 'canceled', canceled_at = ?, updated_at = ? WHERE id = ?`)
+                    .run(new Date().toISOString(), new Date().toISOString(), discrepancy.entityId);
+                logger.info('Marked missing subscription as canceled', { entityId: discrepancy.entityId });
+                return true;
+            default:
+                return false;
+        }
+    }
+    fixInvoiceDiscrepancy(discrepancy) {
+        switch (discrepancy.type) {
+            case 'invoice_status_mismatch':
+                this.db
+                    .prepare(`UPDATE invoices SET status = ? WHERE id = ?`)
+                    .run(discrepancy.stripeValue, discrepancy.entityId);
+                logger.info('Fixed invoice status', {
+                    entityId: discrepancy.entityId,
+                    newStatus: discrepancy.stripeValue,
+                });
+                return true;
+            case 'invoice_amount_mismatch':
+                this.db
+                    .prepare(`UPDATE invoices SET amount_cents = ? WHERE id = ?`)
+                    .run(discrepancy.stripeValue, discrepancy.entityId);
+                logger.info('Fixed invoice amount', {
+                    entityId: discrepancy.entityId,
+                    newAmount: discrepancy.stripeValue,
+                });
+                return true;
+            default:
+                return false;
+        }
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function mapStripeStatus(stripeStatus) {
+    switch (stripeStatus) {
+        case 'active':
+            return 'active';
+        case 'past_due':
+            return 'past_due';
+        case 'canceled':
+            return 'canceled';
+        case 'trialing':
+            return 'trialing';
+        case 'paused':
+            return 'paused';
+        case 'incomplete':
+            return 'incomplete';
+        case 'incomplete_expired':
+            return 'incomplete_expired';
+        case 'unpaid':
+            return 'unpaid';
+        default:
+            return 'active';
+    }
+}
+function mapInvoiceStatus(stripeStatus) {
+    switch (stripeStatus) {
+        case 'paid':
+            return 'paid';
+        case 'open':
+            return 'open';
+        case 'draft':
+            return 'draft';
+        case 'void':
+            return 'void';
+        case 'uncollectible':
+            return 'uncollectible';
+        default:
+            return 'open';
+    }
+}
+//# sourceMappingURL=StripeReconciliationJob.js.map

package/dist/src/billing/StripeReconciliationJob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeReconciliationJob.js","sourceRoot":"","sources":["../../../src/billing/StripeReconciliationJob.ts"],"names":[],"mappings":"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"}

package/dist/src/billing/StripeWebhookHandler.d.ts

@@ -0,0 +1,92 @@
+/**
+ * SMI-1070: Stripe Webhook Handler
+ *
+ * Processes Stripe webhook events for:
+ * - Subscription lifecycle (created, updated, deleted)
+ * - Invoice events (payment succeeded, payment failed)
+ * - Checkout session completion
+ *
+ * Features:
+ * - Idempotent event processing
+ * - Signature verification
+ * - License key generation on subscription creation
+ * - Status synchronization
+ */
+import type { Database as BetterSqliteDatabase } from 'better-sqlite3';
+import { StripeClient } from './StripeClient.js';
+import type { BillingService } from './BillingService.js';
+import type { LicenseTier, WebhookProcessResult } from './types.js';
+export interface StripeWebhookHandlerConfig {
+    /**
+     * StripeClient for API calls
+     */
+    stripeClient: StripeClient;
+    /**
+     * BillingService for database operations
+     */
+    billingService: BillingService;
+    /**
+     * Database connection (for license key storage)
+     */
+    db: BetterSqliteDatabase;
+    /**
+     * Callback for license key generation
+     * Called when a subscription is created/activated
+     */
+    onLicenseKeyNeeded?: (params: {
+        customerId: string;
+        tier: LicenseTier;
+        expiresAt: Date;
+        subscriptionId: string;
+    }) => Promise<string>;
+    /**
+     * Callback for sending emails
+     */
+    onEmailNeeded?: (params: {
+        type: 'license_key' | 'payment_failed' | 'subscription_canceled';
+        email: string;
+        data: Record<string, unknown>;
+    }) => Promise<void>;
+}
+/**
+ * Handles Stripe webhook events
+ *
+ * @example
+ * ```typescript
+ * const handler = new StripeWebhookHandler({
+ *   stripeClient,
+ *   billingService,
+ *   db,
+ *   onLicenseKeyNeeded: async (params) => {
+ *     return licenseGenerator.createLicense(params);
+ *   },
+ * });
+ *
+ * // In webhook endpoint:
+ * const result = await handler.handleWebhook(payload, signature);
+ * ```
+ */
+export declare class StripeWebhookHandler {
+    private readonly stripe;
+    private readonly billing;
+    private readonly db;
+    private readonly onLicenseKeyNeeded?;
+    private readonly onEmailNeeded?;
+    constructor(config: StripeWebhookHandlerConfig);
+    /**
+     * Handle an incoming Stripe webhook
+     */
+    handleWebhook(payload: string, signature: string): Promise<WebhookProcessResult>;
+    private routeEvent;
+    private handleSubscriptionCreated;
+    private handleSubscriptionUpdated;
+    private handleSubscriptionDeleted;
+    private handleInvoicePaymentSucceeded;
+    private handleInvoicePaymentFailed;
+    private handleCheckoutSessionCompleted;
+    private storeLicenseKey;
+    private revokeLicenseKey;
+    private extractTier;
+    private extractSeatCount;
+}
+//# sourceMappingURL=StripeWebhookHandler.d.ts.map

package/dist/src/billing/StripeWebhookHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeWebhookHandler.d.ts","sourceRoot":"","sources":["../../../src/billing/StripeWebhookHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EACV,WAAW,EAIX,oBAAoB,EACrB,MAAM,YAAY,CAAA;AASnB,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,YAAY,EAAE,YAAY,CAAA;IAE1B;;OAEG;IACH,cAAc,EAAE,cAAc,CAAA;IAE9B;;OAEG;IACH,EAAE,EAAE,oBAAoB,CAAA;IAExB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,WAAW,CAAA;QACjB,SAAS,EAAE,IAAI,CAAA;QACf,cAAc,EAAE,MAAM,CAAA;KACvB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,uBAAuB,CAAA;QAChE,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC9B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAkD;IACtF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAA6C;gBAEhE,MAAM,EAAE,0BAA0B;IAc9C;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAgFxE,UAAU;YAmCV,yBAAyB;YA6DzB,yBAAyB;YAoDzB,yBAAyB;YAyCzB,6BAA6B;YAgC7B,0BAA0B;YAgD1B,8BAA8B;IAe5C,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,gBAAgB;CAazB"}