@skillsmith/core 0.1.2 → 0.4.0

package/dist/src/billing/StripeClient.js

@@ -0,0 +1,462 @@
+/**
+ * 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';
+const logger = createLogger('StripeClient');
+// ============================================================================
+// StripeClient Class
+// ============================================================================
+/**
+ * Stripe API client wrapper
+ *
+ * @example
+ * ```typescript
+ * const client = new StripeClient({
+ *   secretKey: process.env.STRIPE_SECRET_KEY!,
+ *   webhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
+ *   prices: {
+ *     individual: { monthly: 'price_xxx', annual: 'price_yyy' },
+ *     team: { monthly: 'price_xxx', annual: 'price_yyy' },
+ *     enterprise: { monthly: 'price_xxx', annual: 'price_yyy' },
+ *   },
+ * });
+ *
+ * const session = await client.createCheckoutSession({
+ *   tier: 'team',
+ *   billingPeriod: 'monthly',
+ *   seatCount: 5,
+ *   successUrl: 'https://app.example.com/success',
+ *   cancelUrl: 'https://app.example.com/cancel',
+ * });
+ * ```
+ */
+export class StripeClient {
+    stripe;
+    webhookSecret;
+    prices;
+    appUrl;
+    constructor(config) {
+        this.stripe = new Stripe(config.secretKey, {
+            apiVersion: '2023-10-16',
+            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 of next charge)
+     */
+    async getUpcomingInvoice(customerId) {
+        try {
+            return await this.stripe.invoices.retrieveUpcoming({
+                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) {
+        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';
+        }
+    }
+    /**
+     * Get the underlying Stripe instance (for advanced operations)
+     */
+    getStripeInstance() {
+        return this.stripe;
+    }
+}
+//# sourceMappingURL=StripeClient.js.map

package/dist/src/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/src/billing/StripeReconciliationJob.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 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 { Database as BetterSqliteDatabase } from 'better-sqlite3';
+import type { StripeClient } from './StripeClient.js';
+export interface StripeReconciliationJobConfig {
+    /**
+     * StripeClient for API calls
+     */
+    stripeClient: StripeClient;
+    /**
+     * Database connection
+     */
+    db: BetterSqliteDatabase;
+    /**
+     * Whether to automatically fix discrepancies
+     * @default false
+     */
+    autoFix?: boolean;
+    /**
+     * Maximum subscriptions to process per run
+     * @default 100
+     */
+    batchSize?: number;
+}
+export type DiscrepancyType = 'status_mismatch' | 'missing_local' | 'missing_stripe' | 'tier_mismatch' | 'seat_count_mismatch' | 'period_mismatch' | 'invoice_status_mismatch' | 'invoice_amount_mismatch';
+export interface Discrepancy {
+    type: DiscrepancyType;
+    entityType: 'subscription' | 'invoice';
+    entityId: string;
+    stripeId: string;
+    localValue: string | number | null;
+    stripeValue: string | number | null;
+    description: string;
+    fixed: boolean;
+}
+export interface ReconciliationResult {
+    success: boolean;
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
+    stats: {
+        subscriptionsChecked: number;
+        invoicesChecked: number;
+        discrepanciesFound: number;
+        discrepanciesFixed: number;
+    };
+    discrepancies: Discrepancy[];
+    errors: string[];
+}
+/**
+ * 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/src/billing/StripeReconciliationJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripeReconciliationJob.d.ts","sourceRoot":"","sources":["../../../src/billing/StripeReconciliationJob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AASrD,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,YAAY,EAAE,YAAY,CAAA;IAE1B;;OAEG;IACH,EAAE,EAAE,oBAAoB,CAAA;IAExB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,qBAAqB,GACrB,iBAAiB,GACjB,yBAAyB,GACzB,yBAAyB,CAAA;AAE7B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAA;IACrB,UAAU,EAAE,cAAc,GAAG,SAAS,CAAA;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE;QACL,oBAAoB,EAAE,MAAM,CAAA;QAC5B,eAAe,EAAE,MAAM,CAAA;QACvB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,kBAAkB,EAAE,MAAM,CAAA;KAC3B,CAAA;IACD,aAAa,EAAE,WAAW,EAAE,CAAA;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;IACzC,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"}