@skillsmith/core 2.1.0 → 2.1.2

package/dist/src/billing/StripeWebhookHandler.js

@@ -0,0 +1,409 @@
+/**
+ * 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 { createHash, randomUUID } from 'crypto';
+import { createLogger } from '../utils/logger.js';
+import { StripeClient } from './StripeClient.js';
+import { BillingError } from './types.js';
+const logger = createLogger('StripeWebhookHandler');
+// ============================================================================
+// StripeWebhookHandler Class
+// ============================================================================
+/**
+ * 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 class StripeWebhookHandler {
+    stripe;
+    billing;
+    db;
+    onLicenseKeyNeeded;
+    onEmailNeeded;
+    constructor(config) {
+        this.stripe = config.stripeClient;
+        this.billing = config.billingService;
+        this.db = config.db;
+        this.onLicenseKeyNeeded = config.onLicenseKeyNeeded;
+        this.onEmailNeeded = config.onEmailNeeded;
+        logger.info('Stripe webhook handler initialized');
+    }
+    // ==========================================================================
+    // Main Entry Point
+    // ==========================================================================
+    /**
+     * Handle an incoming Stripe webhook
+     */
+    async handleWebhook(payload, signature) {
+        // 1. Verify signature
+        let event;
+        try {
+            event = this.stripe.verifyWebhookSignature(payload, signature);
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: 'Signature verification failed',
+                eventId: '',
+                processed: false,
+                error: error instanceof Error ? error.message : 'Invalid signature',
+            };
+        }
+        const eventId = event.id;
+        // 2. Check for duplicate (idempotency)
+        if (this.billing.isEventProcessed(eventId)) {
+            logger.info('Duplicate webhook event', { eventId, type: event.type });
+            return {
+                success: true,
+                message: 'Event already processed',
+                eventId,
+                processed: false,
+            };
+        }
+        // 3. Route to appropriate handler
+        try {
+            await this.routeEvent(event);
+            // 4. Record successful processing
+            this.billing.recordWebhookEvent({
+                stripeEventId: eventId,
+                eventType: event.type,
+                payload,
+                success: true,
+            });
+            logger.info('Webhook event processed', { eventId, type: event.type });
+            return {
+                success: true,
+                message: `Processed ${event.type}`,
+                eventId,
+                processed: true,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Record failed processing
+            this.billing.recordWebhookEvent({
+                stripeEventId: eventId,
+                eventType: event.type,
+                payload,
+                success: false,
+                errorMessage,
+            });
+            logger.error('Webhook processing failed', undefined, {
+                eventId,
+                eventType: event.type,
+                errorDetails: errorMessage,
+            });
+            return {
+                success: false,
+                message: 'Processing failed',
+                eventId,
+                processed: false,
+                error: errorMessage,
+            };
+        }
+    }
+    // ==========================================================================
+    // Event Routing
+    // ==========================================================================
+    async routeEvent(event) {
+        switch (event.type) {
+            case 'customer.subscription.created':
+                await this.handleSubscriptionCreated(event.data.object);
+                break;
+            case 'customer.subscription.updated':
+                await this.handleSubscriptionUpdated(event.data.object);
+                break;
+            case 'customer.subscription.deleted':
+                await this.handleSubscriptionDeleted(event.data.object);
+                break;
+            case 'invoice.payment_succeeded':
+                await this.handleInvoicePaymentSucceeded(event.data.object);
+                break;
+            case 'invoice.payment_failed':
+                await this.handleInvoicePaymentFailed(event.data.object);
+                break;
+            case 'checkout.session.completed':
+                await this.handleCheckoutSessionCompleted(event.data.object);
+                break;
+            default:
+                logger.debug('Unhandled webhook event type', { type: event.type });
+        }
+    }
+    // ==========================================================================
+    // Subscription Event Handlers
+    // ==========================================================================
+    async handleSubscriptionCreated(subscription) {
+        logger.info('Processing subscription.created', {
+            subscriptionId: subscription.id,
+            customerId: subscription.customer,
+            status: subscription.status,
+        });
+        const customer = await this.stripe.getCustomer(subscription.customer);
+        if (!customer) {
+            throw new BillingError('Customer not found', 'CUSTOMER_NOT_FOUND');
+        }
+        const tier = this.extractTier(subscription);
+        const seatCount = this.extractSeatCount(subscription);
+        // Create/update subscription record
+        const sub = this.billing.upsertSubscription({
+            customerId: customer.id,
+            email: customer.email,
+            stripeCustomerId: customer.id,
+            stripeSubscriptionId: subscription.id,
+            stripePriceId: subscription.items.data[0]?.price.id ?? '',
+            tier,
+            status: StripeClient.mapSubscriptionStatus(subscription.status),
+            seatCount,
+            currentPeriodStart: new Date(subscription.current_period_start * 1000),
+            currentPeriodEnd: new Date(subscription.current_period_end * 1000),
+        });
+        // Generate license key if subscription is active
+        if (subscription.status === 'active' && this.onLicenseKeyNeeded) {
+            const licenseKey = await this.onLicenseKeyNeeded({
+                customerId: customer.id,
+                tier,
+                expiresAt: new Date(subscription.current_period_end * 1000),
+                subscriptionId: sub.id,
+            });
+            // Store license key
+            this.storeLicenseKey({
+                subscriptionId: sub.id,
+                organizationId: customer.id,
+                keyJwt: licenseKey,
+                keyExpiry: new Date(subscription.current_period_end * 1000),
+            });
+            // Send license key email
+            if (this.onEmailNeeded) {
+                await this.onEmailNeeded({
+                    type: 'license_key',
+                    email: customer.email,
+                    data: {
+                        licenseKey,
+                        tier,
+                        expiresAt: new Date(subscription.current_period_end * 1000).toISOString(),
+                    },
+                });
+            }
+        }
+    }
+    async handleSubscriptionUpdated(subscription) {
+        logger.info('Processing subscription.updated', {
+            subscriptionId: subscription.id,
+            status: subscription.status,
+        });
+        const existingSub = this.billing.getSubscriptionByStripeId(subscription.id);
+        if (!existingSub) {
+            // Subscription doesn't exist locally, create it
+            await this.handleSubscriptionCreated(subscription);
+            return;
+        }
+        // Update status
+        const newStatus = StripeClient.mapSubscriptionStatus(subscription.status);
+        const canceledAt = subscription.canceled_at ? new Date(subscription.canceled_at * 1000) : null;
+        this.billing.updateSubscriptionStatus(subscription.id, newStatus, canceledAt);
+        // Check if tier changed (regenerate license key)
+        const newTier = this.extractTier(subscription);
+        if (existingSub.tier !== newTier && this.onLicenseKeyNeeded) {
+            const customer = await this.stripe.getCustomer(subscription.customer);
+            if (customer) {
+                // Revoke old license key
+                this.revokeLicenseKey(existingSub.id, 'tier_change');
+                // Generate new license key
+                const licenseKey = await this.onLicenseKeyNeeded({
+                    customerId: customer.id,
+                    tier: newTier,
+                    expiresAt: new Date(subscription.current_period_end * 1000),
+                    subscriptionId: existingSub.id,
+                });
+                this.storeLicenseKey({
+                    subscriptionId: existingSub.id,
+                    organizationId: customer.id,
+                    keyJwt: licenseKey,
+                    keyExpiry: new Date(subscription.current_period_end * 1000),
+                });
+            }
+        }
+    }
+    async handleSubscriptionDeleted(subscription) {
+        logger.info('Processing subscription.deleted', {
+            subscriptionId: subscription.id,
+        });
+        const existingSub = this.billing.getSubscriptionByStripeId(subscription.id);
+        if (existingSub) {
+            // Update status to canceled
+            this.billing.updateSubscriptionStatus(subscription.id, 'canceled', new Date());
+            // Revoke license key
+            this.revokeLicenseKey(existingSub.id, 'subscription_canceled');
+            // Send cancellation email
+            if (this.onEmailNeeded) {
+                const customer = await this.stripe.getCustomer(subscription.customer);
+                if (customer?.email) {
+                    await this.onEmailNeeded({
+                        type: 'subscription_canceled',
+                        email: customer.email,
+                        data: {
+                            subscriptionId: subscription.id,
+                            canceledAt: new Date().toISOString(),
+                        },
+                    });
+                }
+            }
+        }
+    }
+    // ==========================================================================
+    // Invoice Event Handlers
+    // ==========================================================================
+    async handleInvoicePaymentSucceeded(invoice) {
+        logger.info('Processing invoice.payment_succeeded', {
+            invoiceId: invoice.id,
+            customerId: invoice.customer,
+            amount: invoice.amount_paid,
+        });
+        const customerId = typeof invoice.customer === 'string' ? invoice.customer : invoice.customer?.id;
+        if (!customerId)
+            return;
+        // Store invoice
+        this.billing.storeInvoice({
+            customerId,
+            stripeInvoiceId: invoice.id,
+            subscriptionId: typeof invoice.subscription === 'string' ? invoice.subscription : invoice.subscription?.id,
+            amountCents: invoice.amount_paid,
+            currency: invoice.currency,
+            status: 'paid',
+            pdfUrl: invoice.invoice_pdf ?? undefined,
+            hostedInvoiceUrl: invoice.hosted_invoice_url ?? undefined,
+            invoiceNumber: invoice.number ?? undefined,
+            paidAt: invoice.status_transitions?.paid_at
+                ? new Date(invoice.status_transitions.paid_at * 1000)
+                : new Date(),
+            periodStart: invoice.period_start ? new Date(invoice.period_start * 1000) : undefined,
+            periodEnd: invoice.period_end ? new Date(invoice.period_end * 1000) : undefined,
+        });
+    }
+    async handleInvoicePaymentFailed(invoice) {
+        logger.warn('Processing invoice.payment_failed', {
+            invoiceId: invoice.id,
+            customerId: invoice.customer,
+            amount: invoice.amount_due,
+        });
+        const customerId = typeof invoice.customer === 'string' ? invoice.customer : invoice.customer?.id;
+        if (!customerId)
+            return;
+        // Store invoice with failed status
+        this.billing.storeInvoice({
+            customerId,
+            stripeInvoiceId: invoice.id,
+            subscriptionId: typeof invoice.subscription === 'string' ? invoice.subscription : invoice.subscription?.id,
+            amountCents: invoice.amount_due,
+            currency: invoice.currency,
+            status: 'open',
+            pdfUrl: invoice.invoice_pdf ?? undefined,
+            hostedInvoiceUrl: invoice.hosted_invoice_url ?? undefined,
+            invoiceNumber: invoice.number ?? undefined,
+        });
+        // Send payment failed email
+        if (this.onEmailNeeded) {
+            const customer = await this.stripe.getCustomer(customerId);
+            if (customer?.email) {
+                await this.onEmailNeeded({
+                    type: 'payment_failed',
+                    email: customer.email,
+                    data: {
+                        invoiceId: invoice.id,
+                        amount: invoice.amount_due,
+                        currency: invoice.currency,
+                        hostedInvoiceUrl: invoice.hosted_invoice_url,
+                    },
+                });
+            }
+        }
+    }
+    // ==========================================================================
+    // Checkout Event Handlers
+    // ==========================================================================
+    async handleCheckoutSessionCompleted(session) {
+        logger.info('Processing checkout.session.completed', {
+            sessionId: session.id,
+            customerId: session.customer,
+            subscriptionId: session.subscription,
+        });
+        // The subscription.created event will handle the actual subscription setup
+        // This handler is useful for tracking successful checkouts and analytics
+    }
+    // ==========================================================================
+    // License Key Management
+    // ==========================================================================
+    storeLicenseKey(params) {
+        const id = randomUUID();
+        const keyHash = createHash('sha256').update(params.keyJwt).digest('hex');
+        const now = new Date().toISOString();
+        this.db
+            .prepare(`INSERT INTO license_keys (
+          id, subscription_id, organization_id, key_jwt, key_hash,
+          key_expiry, is_active, generated_at
+        ) VALUES (?, ?, ?, ?, ?, ?, 1, ?)`)
+            .run(id, params.subscriptionId, params.organizationId, params.keyJwt, keyHash, params.keyExpiry.toISOString(), now);
+        logger.info('License key stored', {
+            subscriptionId: params.subscriptionId,
+            keyHash: keyHash.slice(0, 16) + '...',
+        });
+    }
+    revokeLicenseKey(subscriptionId, reason) {
+        const now = new Date().toISOString();
+        this.db
+            .prepare(`UPDATE license_keys
+        SET is_active = 0, revoked_at = ?, revocation_reason = ?
+        WHERE subscription_id = ? AND is_active = 1`)
+            .run(now, reason, subscriptionId);
+        logger.info('License key revoked', { subscriptionId, reason });
+    }
+    // ==========================================================================
+    // Helper Methods
+    // ==========================================================================
+    extractTier(subscription) {
+        // Try to get tier from metadata first
+        const metadataTier = subscription.metadata?.tier;
+        if (metadataTier && ['community', 'individual', 'team', 'enterprise'].includes(metadataTier)) {
+            return metadataTier;
+        }
+        // Fallback: infer from price ID or default to individual
+        return 'individual';
+    }
+    extractSeatCount(subscription) {
+        // Try metadata first
+        const metadataSeats = subscription.metadata?.seatCount;
+        if (metadataSeats) {
+            const count = parseInt(metadataSeats, 10);
+            if (!isNaN(count) && count > 0) {
+                return count;
+            }
+        }
+        // Fallback to quantity from first item
+        return subscription.items.data[0]?.quantity ?? 1;
+    }
+}
+//# sourceMappingURL=StripeWebhookHandler.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * SMI-1062: Billing Module
+ *
+ * Stripe billing integration for Skillsmith subscriptions.
+ * Provides subscription management, checkout, and invoice handling.
+ */
+export * from './types.js';
+export { StripeClient } from './StripeClient.js';
+export type { StripeClientConfig, TierPriceConfigs } from './StripeClient.js';
+export { BillingService } from './BillingService.js';
+export type { BillingServiceConfig } from './BillingService.js';
+export { StripeWebhookHandler } from './StripeWebhookHandler.js';
+export type { StripeWebhookHandlerConfig } from './StripeWebhookHandler.js';
+export { GDPRComplianceService } from './GDPRComplianceService.js';
+export type { GDPRComplianceServiceConfig, CustomerDataExport, SubscriptionExportData, InvoiceExportData, LicenseKeyExportData, WebhookEventExportData, DeletionResult, } from './GDPRComplianceService.js';
+export { StripeReconciliationJob } from './StripeReconciliationJob.js';
+export type { StripeReconciliationJobConfig, DiscrepancyType, Discrepancy, ReconciliationResult, } from './StripeReconciliationJob.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/billing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,YAAY,CAAA;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAG7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAG/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAG3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,YAAY,EACV,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,GACf,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,YAAY,EACV,6BAA6B,EAC7B,eAAe,EACf,WAAW,EACX,oBAAoB,GACrB,MAAM,8BAA8B,CAAA"}

package/dist/src/billing/index.js

@@ -0,0 +1,19 @@
+/**
+ * SMI-1062: Billing Module
+ *
+ * Stripe billing integration for Skillsmith subscriptions.
+ * Provides subscription management, checkout, and invoice handling.
+ */
+// Types
+export * from './types.js';
+// Stripe Client
+export { StripeClient } from './StripeClient.js';
+// Billing Service
+export { BillingService } from './BillingService.js';
+// Webhook Handler
+export { StripeWebhookHandler } from './StripeWebhookHandler.js';
+// GDPR Compliance (SMI-1068)
+export { GDPRComplianceService } from './GDPRComplianceService.js';
+// Reconciliation Job (SMI-1069)
+export { StripeReconciliationJob } from './StripeReconciliationJob.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/billing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAA;AAE1B,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGpD,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAGhE,6BAA6B;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAWlE,gCAAgC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA"}