@skillsmith/core 0.2.0 → 0.4.0

package/dist/src/billing/BillingService.js

@@ -0,0 +1,393 @@
+/**
+ * SMI-1063: Billing Service
+ *
+ * High-level billing operations that coordinate between:
+ * - StripeClient (Stripe API)
+ * - Database (subscription/invoice storage)
+ * - LicenseKeyGenerator (license key generation)
+ */
+import { randomUUID } from 'crypto';
+import { createLogger } from '../utils/logger.js';
+import { BillingError } from './types.js';
+const logger = createLogger('BillingService');
+// ============================================================================
+// BillingService Class
+// ============================================================================
+/**
+ * Billing service for subscription management
+ *
+ * @example
+ * ```typescript
+ * const billing = new BillingService({
+ *   stripeClient,
+ *   db,
+ * });
+ *
+ * // Create checkout session
+ * const session = await billing.createCheckoutSession({
+ *   tier: 'team',
+ *   billingPeriod: 'monthly',
+ *   seatCount: 5,
+ *   email: 'admin@company.com',
+ *   successUrl: '/success',
+ *   cancelUrl: '/cancel',
+ * });
+ *
+ * // Get subscription
+ * const subscription = await billing.getSubscriptionByCustomerId('cust_123');
+ * ```
+ */
+export class BillingService {
+    stripe;
+    db;
+    constructor(config) {
+        this.stripe = config.stripeClient;
+        this.db = config.db;
+        logger.info('Billing service initialized');
+    }
+    // ==========================================================================
+    // Checkout Flow
+    // ==========================================================================
+    /**
+     * Create a Stripe Checkout session
+     */
+    async createCheckoutSession(request) {
+        return this.stripe.createCheckoutSession(request);
+    }
+    // ==========================================================================
+    // Subscription Management
+    // ==========================================================================
+    /**
+     * Get subscription by customer ID (our internal ID)
+     */
+    getSubscriptionByCustomerId(customerId) {
+        const row = this.db
+            .prepare(`SELECT
+          id,
+          customer_id as customerId,
+          stripe_subscription_id as stripeSubscriptionId,
+          stripe_price_id as stripePriceId,
+          tier,
+          status,
+          seat_count as seatCount,
+          current_period_start as currentPeriodStart,
+          current_period_end as currentPeriodEnd,
+          canceled_at as canceledAt,
+          created_at as createdAt,
+          updated_at as updatedAt
+        FROM user_subscriptions
+        WHERE customer_id = ?`)
+            .get(customerId);
+        if (!row)
+            return null;
+        return this.mapRowToSubscription(row);
+    }
+    /**
+     * Get subscription by Stripe subscription ID
+     */
+    getSubscriptionByStripeId(stripeSubscriptionId) {
+        const row = this.db
+            .prepare(`SELECT
+          id,
+          customer_id as customerId,
+          stripe_subscription_id as stripeSubscriptionId,
+          stripe_price_id as stripePriceId,
+          tier,
+          status,
+          seat_count as seatCount,
+          current_period_start as currentPeriodStart,
+          current_period_end as currentPeriodEnd,
+          canceled_at as canceledAt,
+          created_at as createdAt,
+          updated_at as updatedAt
+        FROM user_subscriptions
+        WHERE stripe_subscription_id = ?`)
+            .get(stripeSubscriptionId);
+        if (!row)
+            return null;
+        return this.mapRowToSubscription(row);
+    }
+    /**
+     * Create or update subscription from Stripe data
+     */
+    upsertSubscription(params) {
+        const id = randomUUID();
+        const now = new Date().toISOString();
+        this.db
+            .prepare(`INSERT INTO user_subscriptions (
+          id, customer_id, email, stripe_customer_id, stripe_subscription_id,
+          stripe_price_id, tier, status, seat_count,
+          current_period_start, current_period_end, canceled_at,
+          created_at, updated_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(customer_id) DO UPDATE SET
+          stripe_subscription_id = excluded.stripe_subscription_id,
+          stripe_price_id = excluded.stripe_price_id,
+          tier = excluded.tier,
+          status = excluded.status,
+          seat_count = excluded.seat_count,
+          current_period_start = excluded.current_period_start,
+          current_period_end = excluded.current_period_end,
+          canceled_at = excluded.canceled_at,
+          updated_at = excluded.updated_at`)
+            .run(id, params.customerId, params.email, params.stripeCustomerId, params.stripeSubscriptionId, params.stripePriceId, params.tier, params.status, params.seatCount, params.currentPeriodStart.toISOString(), params.currentPeriodEnd.toISOString(), params.canceledAt?.toISOString() ?? null, now, now);
+        logger.info('Subscription upserted', {
+            customerId: params.customerId,
+            tier: params.tier,
+            status: params.status,
+        });
+        return this.getSubscriptionByCustomerId(params.customerId);
+    }
+    /**
+     * Update subscription status
+     */
+    updateSubscriptionStatus(stripeSubscriptionId, status, canceledAt) {
+        this.db
+            .prepare(`UPDATE user_subscriptions
+        SET status = ?, canceled_at = ?, updated_at = ?
+        WHERE stripe_subscription_id = ?`)
+            .run(status, canceledAt?.toISOString() ?? null, new Date().toISOString(), stripeSubscriptionId);
+        logger.info('Subscription status updated', { stripeSubscriptionId, status });
+    }
+    /**
+     * Update seat count
+     */
+    async updateSeatCount(stripeSubscriptionId, seatCount, prorate = true) {
+        // Update in Stripe
+        await this.stripe.updateSubscription(stripeSubscriptionId, {
+            seatCount,
+            prorate,
+        });
+        // Update locally
+        this.db
+            .prepare(`UPDATE user_subscriptions
+        SET seat_count = ?, updated_at = ?
+        WHERE stripe_subscription_id = ?`)
+            .run(seatCount, new Date().toISOString(), stripeSubscriptionId);
+        logger.info('Seat count updated', { stripeSubscriptionId, seatCount });
+        return this.getSubscriptionByStripeId(stripeSubscriptionId);
+    }
+    /**
+     * Cancel a subscription
+     */
+    async cancelSubscription(customerId, options) {
+        const subscription = this.getSubscriptionByCustomerId(customerId);
+        if (!subscription?.stripeSubscriptionId) {
+            throw new BillingError('Subscription not found', 'SUBSCRIPTION_NOT_FOUND');
+        }
+        await this.stripe.cancelSubscription(subscription.stripeSubscriptionId, options);
+        // Update local status
+        const newStatus = options?.immediately ? 'canceled' : subscription.status;
+        const canceledAt = options?.immediately ? new Date() : null;
+        this.updateSubscriptionStatus(subscription.stripeSubscriptionId, newStatus, canceledAt);
+        return this.getSubscriptionByCustomerId(customerId);
+    }
+    /**
+     * Upgrade subscription tier
+     */
+    async upgradeTier(customerId, newTier, billingPeriod) {
+        const subscription = this.getSubscriptionByCustomerId(customerId);
+        if (!subscription?.stripeSubscriptionId) {
+            throw new BillingError('Subscription not found', 'SUBSCRIPTION_NOT_FOUND');
+        }
+        // Validate tier upgrade
+        const tierOrder = ['community', 'individual', 'team', 'enterprise'];
+        const currentIndex = tierOrder.indexOf(subscription.tier);
+        const newIndex = tierOrder.indexOf(newTier);
+        if (newIndex <= currentIndex) {
+            throw new BillingError('Can only upgrade to a higher tier', 'DOWNGRADE_NOT_ALLOWED', {
+                currentTier: subscription.tier,
+                requestedTier: newTier,
+            });
+        }
+        await this.stripe.updateSubscription(subscription.stripeSubscriptionId, {
+            tier: newTier,
+            billingPeriod,
+            prorate: true,
+        });
+        // Update local tier
+        this.db
+            .prepare(`UPDATE user_subscriptions
+        SET tier = ?, updated_at = ?
+        WHERE customer_id = ?`)
+            .run(newTier, new Date().toISOString(), customerId);
+        logger.info('Tier upgraded', {
+            customerId,
+            fromTier: subscription.tier,
+            toTier: newTier,
+        });
+        return this.getSubscriptionByCustomerId(customerId);
+    }
+    // ==========================================================================
+    // Customer Portal
+    // ==========================================================================
+    /**
+     * Create a Customer Portal session
+     */
+    async createPortalSession(customerId, returnUrl) {
+        const subscription = this.getSubscriptionByCustomerId(customerId);
+        if (!subscription) {
+            throw new BillingError('Customer not found', 'CUSTOMER_NOT_FOUND');
+        }
+        const row = this.db
+            .prepare(`SELECT stripe_customer_id FROM user_subscriptions WHERE customer_id = ?`)
+            .get(customerId);
+        if (!row?.stripe_customer_id) {
+            throw new BillingError('No Stripe customer found', 'CUSTOMER_NOT_FOUND');
+        }
+        return this.stripe.createPortalSession({
+            customerId: row.stripe_customer_id,
+            returnUrl,
+        });
+    }
+    // ==========================================================================
+    // Invoice Management
+    // ==========================================================================
+    /**
+     * Get invoices for a customer
+     */
+    getInvoices(customerId, limit = 10) {
+        const rows = this.db
+            .prepare(`SELECT
+          id,
+          customer_id as customerId,
+          stripe_invoice_id as stripeInvoiceId,
+          subscription_id as subscriptionId,
+          amount_cents as amountCents,
+          currency,
+          status,
+          pdf_url as pdfUrl,
+          hosted_invoice_url as hostedInvoiceUrl,
+          invoice_number as invoiceNumber,
+          paid_at as paidAt,
+          period_start as periodStart,
+          period_end as periodEnd,
+          created_at as createdAt
+        FROM invoices
+        WHERE customer_id = ?
+        ORDER BY created_at DESC
+        LIMIT ?`)
+            .all(customerId, limit);
+        return rows.map(this.mapRowToInvoice);
+    }
+    /**
+     * Store an invoice from Stripe
+     */
+    storeInvoice(params) {
+        const id = randomUUID();
+        const now = new Date().toISOString();
+        this.db
+            .prepare(`INSERT INTO invoices (
+          id, customer_id, stripe_invoice_id, subscription_id,
+          amount_cents, currency, status, pdf_url, hosted_invoice_url,
+          invoice_number, paid_at, period_start, period_end, created_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(stripe_invoice_id) DO UPDATE SET
+          status = excluded.status,
+          pdf_url = excluded.pdf_url,
+          paid_at = excluded.paid_at`)
+            .run(id, params.customerId, params.stripeInvoiceId, params.subscriptionId ?? null, params.amountCents, params.currency, params.status, params.pdfUrl ?? null, params.hostedInvoiceUrl ?? null, params.invoiceNumber ?? null, params.paidAt?.toISOString() ?? null, params.periodStart?.toISOString() ?? null, params.periodEnd?.toISOString() ?? null, now);
+        logger.info('Invoice stored', {
+            invoiceId: id,
+            stripeInvoiceId: params.stripeInvoiceId,
+            status: params.status,
+        });
+        const row = this.db
+            .prepare(`SELECT
+          id,
+          customer_id as customerId,
+          stripe_invoice_id as stripeInvoiceId,
+          subscription_id as subscriptionId,
+          amount_cents as amountCents,
+          currency,
+          status,
+          pdf_url as pdfUrl,
+          hosted_invoice_url as hostedInvoiceUrl,
+          invoice_number as invoiceNumber,
+          paid_at as paidAt,
+          period_start as periodStart,
+          period_end as periodEnd,
+          created_at as createdAt
+        FROM invoices WHERE stripe_invoice_id = ?`)
+            .get(params.stripeInvoiceId);
+        return this.mapRowToInvoice(row);
+    }
+    // ==========================================================================
+    // Webhook Event Tracking (Idempotency)
+    // ==========================================================================
+    /**
+     * Check if a webhook event has already been processed
+     */
+    isEventProcessed(stripeEventId) {
+        const row = this.db
+            .prepare(`SELECT id FROM stripe_webhook_events WHERE stripe_event_id = ?`)
+            .get(stripeEventId);
+        return !!row;
+    }
+    /**
+     * Record a processed webhook event
+     */
+    recordWebhookEvent(params) {
+        const id = randomUUID();
+        const now = new Date().toISOString();
+        this.db
+            .prepare(`INSERT INTO stripe_webhook_events (
+          id, stripe_event_id, event_type, processed_at,
+          payload, success, error_message, created_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, params.stripeEventId, params.eventType, now, params.payload ?? null, params.success !== false ? 1 : 0, params.errorMessage ?? null, now);
+        logger.info('Webhook event recorded', {
+            eventId: params.stripeEventId,
+            eventType: params.eventType,
+            success: params.success !== false,
+        });
+        return {
+            id,
+            stripeEventId: params.stripeEventId,
+            eventType: params.eventType,
+            processedAt: new Date(now),
+            payload: params.payload ?? '',
+            success: params.success !== false,
+            errorMessage: params.errorMessage ?? null,
+            createdAt: new Date(now),
+        };
+    }
+    // ==========================================================================
+    // Helper Methods
+    // ==========================================================================
+    mapRowToSubscription(row) {
+        return {
+            id: row.id,
+            customerId: row.customerId,
+            stripeSubscriptionId: row.stripeSubscriptionId,
+            stripePriceId: row.stripePriceId,
+            tier: row.tier,
+            status: row.status,
+            seatCount: row.seatCount ?? 1,
+            currentPeriodStart: row.currentPeriodStart ? new Date(row.currentPeriodStart) : null,
+            currentPeriodEnd: row.currentPeriodEnd ? new Date(row.currentPeriodEnd) : null,
+            canceledAt: row.canceledAt ? new Date(row.canceledAt) : null,
+            createdAt: new Date(row.createdAt),
+            updatedAt: new Date(row.updatedAt),
+        };
+    }
+    mapRowToInvoice(row) {
+        return {
+            id: row.id,
+            customerId: row.customerId,
+            stripeInvoiceId: row.stripeInvoiceId,
+            subscriptionId: row.subscriptionId,
+            amountCents: row.amountCents,
+            currency: row.currency,
+            status: row.status,
+            pdfUrl: row.pdfUrl,
+            hostedInvoiceUrl: row.hostedInvoiceUrl,
+            invoiceNumber: row.invoiceNumber,
+            paidAt: row.paidAt ? new Date(row.paidAt) : null,
+            periodStart: row.periodStart ? new Date(row.periodStart) : null,
+            periodEnd: row.periodEnd ? new Date(row.periodEnd) : null,
+            createdAt: new Date(row.createdAt),
+        };
+    }
+}
+//# sourceMappingURL=BillingService.js.map

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

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

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

@@ -0,0 +1,176 @@
+/**
+ * SMI-1068: GDPR Compliance Service
+ *
+ * Provides data subject rights implementation for billing data:
+ * - Article 17: Right to Erasure (data deletion)
+ * - Article 20: Right to Data Portability (data export)
+ *
+ * All operations are logged for audit purposes.
+ */
+import type { Database as BetterSqliteDatabase } from 'better-sqlite3';
+import type { StripeClient } from './StripeClient.js';
+export interface GDPRComplianceServiceConfig {
+    /**
+     * Database connection (better-sqlite3)
+     */
+    db: BetterSqliteDatabase;
+    /**
+     * Optional StripeClient for Stripe data operations
+     */
+    stripeClient?: StripeClient;
+}
+/**
+ * Exported customer data format
+ */
+export interface CustomerDataExport {
+    /**
+     * Export metadata
+     */
+    metadata: {
+        exportedAt: string;
+        customerId: string;
+        format: 'json';
+        version: '1.0';
+    };
+    /**
+     * Subscription data
+     */
+    subscriptions: SubscriptionExportData[];
+    /**
+     * Invoice data
+     */
+    invoices: InvoiceExportData[];
+    /**
+     * License key data (without the actual JWT for security)
+     */
+    licenseKeys: LicenseKeyExportData[];
+    /**
+     * Webhook events related to this customer
+     */
+    webhookEvents: WebhookEventExportData[];
+}
+export interface SubscriptionExportData {
+    id: string;
+    stripeSubscriptionId: string | null;
+    tier: string;
+    status: string;
+    seatCount: number;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    canceledAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface InvoiceExportData {
+    id: string;
+    stripeInvoiceId: string;
+    amountCents: number;
+    currency: string;
+    status: string;
+    invoiceNumber: string | null;
+    paidAt: string | null;
+    periodStart: string | null;
+    periodEnd: string | null;
+    createdAt: string;
+}
+export interface LicenseKeyExportData {
+    id: string;
+    keyExpiry: string;
+    isActive: boolean;
+    generatedAt: string;
+    revokedAt: string | null;
+    revocationReason: string | null;
+}
+export interface WebhookEventExportData {
+    id: string;
+    stripeEventId: string;
+    eventType: string;
+    processedAt: string;
+    success: boolean;
+}
+/**
+ * Result of a data deletion operation
+ */
+export interface DeletionResult {
+    success: boolean;
+    customerId: string;
+    deletedAt: string;
+    counts: {
+        subscriptions: number;
+        invoices: number;
+        licenseKeys: number;
+        webhookEvents: number;
+    };
+    stripeDeleted: boolean;
+    errors: string[];
+}
+/**
+ * GDPR Compliance Service for billing data
+ *
+ * @example
+ * ```typescript
+ * const gdpr = new GDPRComplianceService({
+ *   db,
+ *   stripeClient,
+ * });
+ *
+ * // Export customer data (Article 20)
+ * const data = gdpr.exportCustomerData('customer_123');
+ *
+ * // Delete customer data (Article 17)
+ * const result = await gdpr.deleteCustomerData('customer_123');
+ * ```
+ */
+export declare class GDPRComplianceService {
+    private readonly db;
+    private readonly stripe?;
+    constructor(config: GDPRComplianceServiceConfig);
+    /**
+     * Export all billing data for a customer
+     *
+     * Returns a structured JSON export of all data associated with the customer.
+     * This fulfills GDPR Article 20 requirements.
+     *
+     * @param customerId - The customer ID to export data for
+     * @returns Complete data export in JSON format
+     */
+    exportCustomerData(customerId: string): CustomerDataExport;
+    private exportSubscriptions;
+    private exportInvoices;
+    private exportLicenseKeys;
+    private exportWebhookEvents;
+    /**
+     * Delete all billing data for a customer
+     *
+     * Performs cascading deletion of:
+     * 1. License keys
+     * 2. Invoices
+     * 3. Webhook events (those containing customer data)
+     * 4. Subscriptions
+     * 5. Stripe customer (if stripeClient provided)
+     *
+     * This fulfills GDPR Article 17 requirements.
+     *
+     * @param customerId - The customer ID to delete data for
+     * @param options - Deletion options
+     * @returns Result of the deletion operation
+     */
+    deleteCustomerData(customerId: string, options?: {
+        deleteFromStripe?: boolean;
+        dryRun?: boolean;
+    }): Promise<DeletionResult>;
+    /**
+     * Check if a customer has any billing data
+     */
+    hasCustomerData(customerId: string): boolean;
+    /**
+     * Get a summary of customer data (for consent/overview purposes)
+     */
+    getDataSummary(customerId: string): {
+        hasSubscription: boolean;
+        invoiceCount: number;
+        licenseKeyCount: number;
+        stripeCustomerId: string | null;
+    };
+}
+//# sourceMappingURL=GDPRComplianceService.d.ts.map

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

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