@skillsmith/core 0.5.4 → 0.5.6

package/dist/billing/StripeClient.js

@@ -0,0 +1,405 @@
+/**
+ * SMI-1062: Stripe Client Wrapper
+ *
+ * Provides a type-safe wrapper around the Stripe SDK with:
+ * - Customer management
+ * - Subscription management
+ * - Checkout session creation
+ * - Customer portal sessions
+ * - Invoice retrieval
+ * - Webhook signature verification
+ */
+import Stripe from 'stripe';
+import { createLogger } from '../utils/logger.js';
+import { BillingError } from './types.js';
+import { mapSubscriptionStatus as mapStripeSubscriptionStatus } from './stripe-helpers.js';
+const logger = createLogger('StripeClient');
+/** Stripe API client wrapper for subscription management and billing operations */
+export class StripeClient {
+    stripe;
+    webhookSecret;
+    prices;
+    appUrl;
+    constructor(config) {
+        this.stripe = new Stripe(config.secretKey, {
+            // Use SDK default API version (2025-11-17.clover for v20)
+            typescript: true,
+        });
+        this.webhookSecret = config.webhookSecret;
+        this.prices = config.prices;
+        this.appUrl = config.appUrl ?? 'https://skillsmith.app';
+        logger.info('Stripe client initialized');
+    }
+    // --- Customer Management ---
+    /**
+     * Create a new Stripe customer
+     */
+    async createCustomer(params) {
+        try {
+            const customer = await this.stripe.customers.create({
+                email: params.email,
+                name: params.name,
+                metadata: {
+                    ...params.metadata,
+                    source: 'skillsmith',
+                },
+            });
+            logger.info('Customer created', { customerId: customer.id });
+            return customer.id;
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.error('Failed to create customer', undefined, {
+                errorDetails: errorMsg,
+                email: params.email,
+            });
+            throw new BillingError('Failed to create customer', 'STRIPE_API_ERROR', {
+                originalError: errorMsg,
+            });
+        }
+    }
+    /**
+     * Get a Stripe customer by ID
+     */
+    async getCustomer(customerId) {
+        try {
+            const customer = await this.stripe.customers.retrieve(customerId);
+            if (customer.deleted) {
+                return null;
+            }
+            return customer;
+        }
+        catch (error) {
+            if (error instanceof Stripe.errors.StripeError && error.code === 'resource_missing') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Update a Stripe customer
+     */
+    async updateCustomer(customerId, params) {
+        return this.stripe.customers.update(customerId, params);
+    }
+    // --- Checkout Session ---
+    /**
+     * Create a Stripe Checkout session for subscription
+     */
+    async createCheckoutSession(request) {
+        const priceId = this.getPriceId(request.tier, request.billingPeriod);
+        if (!priceId) {
+            throw new BillingError(`No price configured for tier: ${request.tier}`, 'INVALID_TIER', {
+                tier: request.tier,
+                billingPeriod: request.billingPeriod,
+            });
+        }
+        const lineItems = [
+            {
+                price: priceId,
+                quantity: request.seatCount ?? 1,
+            },
+        ];
+        const sessionParams = {
+            mode: 'subscription',
+            line_items: lineItems,
+            success_url: request.successUrl,
+            cancel_url: request.cancelUrl,
+            metadata: {
+                tier: request.tier,
+                billingPeriod: request.billingPeriod,
+                seatCount: String(request.seatCount ?? 1),
+                ...request.metadata,
+            },
+            subscription_data: {
+                metadata: {
+                    tier: request.tier,
+                    seatCount: String(request.seatCount ?? 1),
+                },
+            },
+        };
+        // Attach to existing customer or create new
+        if (request.customerId) {
+            sessionParams.customer = request.customerId;
+        }
+        else if (request.email) {
+            sessionParams.customer_email = request.email;
+        }
+        // Allow seat quantity changes for team/enterprise
+        if (request.tier === 'team' || request.tier === 'enterprise') {
+            sessionParams.line_items[0].adjustable_quantity = {
+                enabled: true,
+                minimum: 1,
+                maximum: 1000,
+            };
+        }
+        try {
+            const session = await this.stripe.checkout.sessions.create(sessionParams);
+            logger.info('Checkout session created', {
+                sessionId: session.id,
+                tier: request.tier,
+                seatCount: request.seatCount,
+            });
+            return {
+                sessionId: session.id,
+                url: session.url,
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.error('Failed to create checkout session', undefined, { errorDetails: errorMsg });
+            throw new BillingError('Failed to create checkout session', 'STRIPE_API_ERROR', {
+                originalError: errorMsg,
+            });
+        }
+    }
+    /**
+     * Retrieve a checkout session
+     */
+    async getCheckoutSession(sessionId) {
+        return this.stripe.checkout.sessions.retrieve(sessionId, {
+            expand: ['subscription', 'customer'],
+        });
+    }
+    // --- Subscription Management ---
+    /**
+     * Get a subscription by ID
+     */
+    async getSubscription(subscriptionId) {
+        try {
+            return await this.stripe.subscriptions.retrieve(subscriptionId);
+        }
+        catch (error) {
+            if (error instanceof Stripe.errors.StripeError && error.code === 'resource_missing') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * List subscriptions for a customer
+     */
+    async listSubscriptions(customerId) {
+        const subscriptions = await this.stripe.subscriptions.list({
+            customer: customerId,
+            status: 'all',
+            expand: ['data.default_payment_method'],
+        });
+        return subscriptions.data;
+    }
+    /**
+     * Update a subscription (tier change or seat count)
+     */
+    async updateSubscription(subscriptionId, params) {
+        const subscription = await this.getSubscription(subscriptionId);
+        if (!subscription) {
+            throw new BillingError('Subscription not found', 'SUBSCRIPTION_NOT_FOUND');
+        }
+        const updateParams = {
+            proration_behavior: params.prorate !== false ? 'create_prorations' : 'none',
+        };
+        // Update price if tier or billing period changed
+        if (params.tier && params.billingPeriod) {
+            const newPriceId = this.getPriceId(params.tier, params.billingPeriod);
+            if (newPriceId) {
+                updateParams.items = [
+                    {
+                        id: subscription.items.data[0].id,
+                        price: newPriceId,
+                        quantity: params.seatCount ?? subscription.items.data[0].quantity,
+                    },
+                ];
+                updateParams.metadata = {
+                    ...subscription.metadata,
+                    tier: params.tier,
+                    seatCount: String(params.seatCount ?? subscription.items.data[0].quantity),
+                };
+            }
+        }
+        else if (params.seatCount !== undefined) {
+            // Just update seat count
+            updateParams.items = [
+                {
+                    id: subscription.items.data[0].id,
+                    quantity: params.seatCount,
+                },
+            ];
+            updateParams.metadata = {
+                ...subscription.metadata,
+                seatCount: String(params.seatCount),
+            };
+        }
+        try {
+            const updated = await this.stripe.subscriptions.update(subscriptionId, updateParams);
+            logger.info('Subscription updated', { subscriptionId, params });
+            return updated;
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.error('Failed to update subscription', undefined, {
+                errorDetails: errorMsg,
+                subscriptionId,
+            });
+            throw new BillingError('Failed to update subscription', 'STRIPE_API_ERROR', {
+                originalError: errorMsg,
+            });
+        }
+    }
+    /**
+     * Cancel a subscription
+     */
+    async cancelSubscription(subscriptionId, options) {
+        try {
+            if (options?.immediately) {
+                return await this.stripe.subscriptions.cancel(subscriptionId, {
+                    cancellation_details: {
+                        comment: options.feedback,
+                    },
+                });
+            }
+            else {
+                // Cancel at period end
+                return await this.stripe.subscriptions.update(subscriptionId, {
+                    cancel_at_period_end: true,
+                    cancellation_details: {
+                        comment: options?.feedback,
+                    },
+                });
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.error('Failed to cancel subscription', undefined, {
+                errorDetails: errorMsg,
+                subscriptionId,
+            });
+            throw new BillingError('Failed to cancel subscription', 'STRIPE_API_ERROR', {
+                originalError: errorMsg,
+            });
+        }
+    }
+    /**
+     * Reactivate a canceled subscription (before period end)
+     */
+    async reactivateSubscription(subscriptionId) {
+        return this.stripe.subscriptions.update(subscriptionId, {
+            cancel_at_period_end: false,
+        });
+    }
+    // --- Customer Portal ---
+    /**
+     * Create a Stripe Customer Portal session
+     */
+    async createPortalSession(request) {
+        try {
+            // Need to get Stripe customer ID from our customer ID
+            // This assumes customerId is the Stripe customer ID
+            const session = await this.stripe.billingPortal.sessions.create({
+                customer: request.customerId,
+                return_url: request.returnUrl,
+            });
+            logger.info('Portal session created', { customerId: request.customerId });
+            return {
+                url: session.url,
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.error('Failed to create portal session', undefined, {
+                errorDetails: errorMsg,
+                customerId: request.customerId,
+            });
+            throw new BillingError('Failed to create portal session', 'STRIPE_API_ERROR', {
+                originalError: errorMsg,
+            });
+        }
+    }
+    // --- Invoice Management ---
+    /**
+     * List invoices for a customer
+     */
+    async listInvoices(customerId, options) {
+        const invoices = await this.stripe.invoices.list({
+            customer: customerId,
+            limit: options?.limit ?? 10,
+            starting_after: options?.startingAfter,
+        });
+        return {
+            invoices: invoices.data,
+            hasMore: invoices.has_more,
+        };
+    }
+    /**
+     * Get a specific invoice
+     */
+    async getInvoice(invoiceId) {
+        try {
+            return await this.stripe.invoices.retrieve(invoiceId);
+        }
+        catch (error) {
+            if (error instanceof Stripe.errors.StripeError && error.code === 'resource_missing') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get upcoming invoice preview (preview of next charge)
+     * Note: Stripe v20+ uses createPreview instead of retrieveUpcoming
+     */
+    async getUpcomingInvoice(customerId) {
+        try {
+            return await this.stripe.invoices.createPreview({
+                customer: customerId,
+            });
+        }
+        catch (error) {
+            if (error instanceof Stripe.errors.StripeError && error.code === 'invoice_upcoming_none') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    // --- Webhook Handling ---
+    /**
+     * Verify and parse a webhook event
+     */
+    verifyWebhookSignature(payload, signature) {
+        try {
+            return this.stripe.webhooks.constructEvent(payload, signature, this.webhookSecret);
+        }
+        catch (error) {
+            logger.warn('Webhook signature verification failed', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new BillingError('Invalid webhook signature', 'WEBHOOK_SIGNATURE_INVALID');
+        }
+    }
+    // --- Helper Methods ---
+    /**
+     * Get the price ID for a tier and billing period
+     */
+    getPriceId(tier, billingPeriod) {
+        if (tier === 'community') {
+            return null; // Community tier is free, no Stripe price
+        }
+        const tierPrices = this.prices[tier];
+        if (!tierPrices) {
+            return null;
+        }
+        return tierPrices[billingPeriod];
+    }
+    /**
+     * Map Stripe subscription status to our status
+     */
+    static mapSubscriptionStatus(stripeStatus) {
+        return mapStripeSubscriptionStatus(stripeStatus);
+    }
+    /**
+     * Get the underlying Stripe instance (for advanced operations)
+     */
+    getStripeInstance() {
+        return this.stripe;
+    }
+}
+//# sourceMappingURL=StripeClient.js.map

package/dist/billing/StripeClient.js.map

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

package/dist/billing/StripeReconciliationJob.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 type { StripeReconciliationJobConfig, ReconciliationResult } from './reconciliation-types.js';
+export type { StripeReconciliationJobConfig, DiscrepancyType, Discrepancy, ReconciliationResult, } from './reconciliation-types.js';
+/**
+ * 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 declare class StripeReconciliationJob {
+    private readonly stripe;
+    private readonly db;
+    private readonly autoFix;
+    private readonly batchSize;
+    constructor(config: StripeReconciliationJobConfig);
+    /**
+     * Run the reconciliation job
+     */
+    run(): Promise<ReconciliationResult>;
+    private getLocalSubscriptions;
+    private reconcileSubscription;
+    private getLocalInvoices;
+    private reconcileInvoice;
+    private fixDiscrepancy;
+    private fixSubscriptionDiscrepancy;
+    private fixInvoiceDiscrepancy;
+}
+//# sourceMappingURL=StripeReconciliationJob.d.ts.map

package/dist/billing/StripeReconciliationJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeReconciliationJob.d.ts","sourceRoot":"","sources":["../../src/billing/StripeReconciliationJob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EACV,6BAA6B,EAE7B,oBAAoB,EAGrB,MAAM,2BAA2B,CAAA;AAGlC,YAAY,EACV,6BAA6B,EAC7B,eAAe,EACf,WAAW,EACX,oBAAoB,GACrB,MAAM,2BAA2B,CAAA;AAQlC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,MAAM,EAAE,6BAA6B;IAgBjD;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAuF1C,OAAO,CAAC,qBAAqB;YAoBf,qBAAqB;IA0EnC,OAAO,CAAC,gBAAgB;YAgBV,gBAAgB;IAyD9B,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,0BAA0B;IA+ClC,OAAO,CAAC,qBAAqB;CA0B9B"}