@skillsmith/core 0.2.0 → 0.4.1

package/dist/src/billing/GDPRComplianceService.js

@@ -0,0 +1,361 @@
+/**
+ * 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 { createLogger } from '../utils/logger.js';
+const logger = createLogger('GDPRComplianceService');
+// ============================================================================
+// GDPRComplianceService Class
+// ============================================================================
+/**
+ * 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 class GDPRComplianceService {
+    db;
+    stripe;
+    constructor(config) {
+        this.db = config.db;
+        this.stripe = config.stripeClient;
+        logger.info('GDPR Compliance service initialized');
+    }
+    // ==========================================================================
+    // Data Export (Article 20: Right to Data Portability)
+    // ==========================================================================
+    /**
+     * 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) {
+        logger.info('Starting customer data export', { customerId });
+        const subscriptions = this.exportSubscriptions(customerId);
+        const invoices = this.exportInvoices(customerId);
+        const licenseKeys = this.exportLicenseKeys(customerId);
+        const webhookEvents = this.exportWebhookEvents(customerId);
+        const exportData = {
+            metadata: {
+                exportedAt: new Date().toISOString(),
+                customerId,
+                format: 'json',
+                version: '1.0',
+            },
+            subscriptions,
+            invoices,
+            licenseKeys,
+            webhookEvents,
+        };
+        logger.info('Customer data export completed', {
+            customerId,
+            subscriptionCount: subscriptions.length,
+            invoiceCount: invoices.length,
+            licenseKeyCount: licenseKeys.length,
+            webhookEventCount: webhookEvents.length,
+        });
+        return exportData;
+    }
+    exportSubscriptions(customerId) {
+        const rows = this.db
+            .prepare(`SELECT
+          id,
+          stripe_subscription_id as stripeSubscriptionId,
+          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 = ?`)
+            .all(customerId);
+        return rows.map((row) => ({
+            ...row,
+            seatCount: row.seatCount ?? 1,
+        }));
+    }
+    exportInvoices(customerId) {
+        const rows = this.db
+            .prepare(`SELECT
+          id,
+          stripe_invoice_id as stripeInvoiceId,
+          amount_cents as amountCents,
+          currency,
+          status,
+          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 = ?`)
+            .all(customerId);
+        return rows;
+    }
+    exportLicenseKeys(customerId) {
+        // Get subscription IDs for this customer
+        const subscriptionIds = this.db
+            .prepare(`SELECT id FROM user_subscriptions WHERE customer_id = ?`)
+            .all(customerId);
+        if (subscriptionIds.length === 0) {
+            return [];
+        }
+        const placeholders = subscriptionIds.map(() => '?').join(',');
+        const ids = subscriptionIds.map((s) => s.id);
+        const rows = this.db
+            .prepare(`SELECT
+          id,
+          key_expiry as keyExpiry,
+          is_active as isActive,
+          generated_at as generatedAt,
+          revoked_at as revokedAt,
+          revocation_reason as revocationReason
+        FROM license_keys
+        WHERE subscription_id IN (${placeholders})`)
+            .all(...ids);
+        return rows.map((row) => ({
+            id: row.id,
+            keyExpiry: row.keyExpiry,
+            isActive: row.isActive === 1,
+            generatedAt: row.generatedAt,
+            revokedAt: row.revokedAt,
+            revocationReason: row.revocationReason,
+        }));
+    }
+    exportWebhookEvents(customerId) {
+        // Get stripe customer ID for this customer
+        const customer = this.db
+            .prepare(`SELECT stripe_customer_id FROM user_subscriptions WHERE customer_id = ? LIMIT 1`)
+            .get(customerId);
+        if (!customer?.stripe_customer_id) {
+            return [];
+        }
+        // Find webhook events that contain this customer ID in the payload
+        const rows = this.db
+            .prepare(`SELECT
+          id,
+          stripe_event_id as stripeEventId,
+          event_type as eventType,
+          processed_at as processedAt,
+          success
+        FROM stripe_webhook_events
+        WHERE payload LIKE ?`)
+            .all(`%${customer.stripe_customer_id}%`);
+        return rows.map((row) => ({
+            id: row.id,
+            stripeEventId: row.stripeEventId,
+            eventType: row.eventType,
+            processedAt: row.processedAt,
+            success: row.success === 1,
+        }));
+    }
+    // ==========================================================================
+    // Data Deletion (Article 17: Right to Erasure)
+    // ==========================================================================
+    /**
+     * 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
+     */
+    async deleteCustomerData(customerId, options) {
+        const dryRun = options?.dryRun ?? false;
+        const deleteFromStripe = options?.deleteFromStripe ?? true;
+        logger.info('Starting customer data deletion', { customerId, dryRun });
+        const errors = [];
+        const counts = {
+            subscriptions: 0,
+            invoices: 0,
+            licenseKeys: 0,
+            webhookEvents: 0,
+        };
+        // Get Stripe customer ID before deletion
+        const stripeCustomerRow = this.db
+            .prepare(`SELECT stripe_customer_id FROM user_subscriptions WHERE customer_id = ? LIMIT 1`)
+            .get(customerId);
+        const stripeCustomerId = stripeCustomerRow?.stripe_customer_id;
+        // Perform deletion in a transaction
+        if (!dryRun) {
+            this.db.exec('BEGIN TRANSACTION');
+        }
+        try {
+            // 1. Delete license keys (depends on subscriptions)
+            const subscriptionIds = this.db
+                .prepare(`SELECT id FROM user_subscriptions WHERE customer_id = ?`)
+                .all(customerId);
+            if (subscriptionIds.length > 0) {
+                const placeholders = subscriptionIds.map(() => '?').join(',');
+                const ids = subscriptionIds.map((s) => s.id);
+                if (dryRun) {
+                    const count = this.db
+                        .prepare(`SELECT COUNT(*) as count FROM license_keys WHERE subscription_id IN (${placeholders})`)
+                        .get(...ids);
+                    counts.licenseKeys = count.count;
+                }
+                else {
+                    const result = this.db
+                        .prepare(`DELETE FROM license_keys WHERE subscription_id IN (${placeholders})`)
+                        .run(...ids);
+                    counts.licenseKeys = result.changes;
+                }
+            }
+            // 2. Delete invoices
+            if (dryRun) {
+                const count = this.db
+                    .prepare(`SELECT COUNT(*) as count FROM invoices WHERE customer_id = ?`)
+                    .get(customerId);
+                counts.invoices = count.count;
+            }
+            else {
+                const result = this.db.prepare(`DELETE FROM invoices WHERE customer_id = ?`).run(customerId);
+                counts.invoices = result.changes;
+            }
+            // 3. Delete related webhook events (containing customer ID in payload)
+            if (stripeCustomerId) {
+                if (dryRun) {
+                    const count = this.db
+                        .prepare(`SELECT COUNT(*) as count FROM stripe_webhook_events WHERE payload LIKE ?`)
+                        .get(`%${stripeCustomerId}%`);
+                    counts.webhookEvents = count.count;
+                }
+                else {
+                    const result = this.db
+                        .prepare(`DELETE FROM stripe_webhook_events WHERE payload LIKE ?`)
+                        .run(`%${stripeCustomerId}%`);
+                    counts.webhookEvents = result.changes;
+                }
+            }
+            // 4. Delete subscriptions
+            if (dryRun) {
+                const count = this.db
+                    .prepare(`SELECT COUNT(*) as count FROM user_subscriptions WHERE customer_id = ?`)
+                    .get(customerId);
+                counts.subscriptions = count.count;
+            }
+            else {
+                const result = this.db
+                    .prepare(`DELETE FROM user_subscriptions WHERE customer_id = ?`)
+                    .run(customerId);
+                counts.subscriptions = result.changes;
+            }
+            if (!dryRun) {
+                this.db.exec('COMMIT');
+            }
+        }
+        catch (error) {
+            if (!dryRun) {
+                this.db.exec('ROLLBACK');
+            }
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            errors.push(`Database deletion failed: ${errorMsg}`);
+            logger.error('Customer data deletion failed', undefined, { customerId, error: errorMsg });
+        }
+        // 5. Delete from Stripe if requested
+        let stripeDeleted = false;
+        if (deleteFromStripe && stripeCustomerId && this.stripe && !dryRun) {
+            try {
+                const stripeInstance = this.stripe.getStripeInstance();
+                await stripeInstance.customers.del(stripeCustomerId);
+                stripeDeleted = true;
+                logger.info('Stripe customer deleted', { stripeCustomerId });
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                errors.push(`Stripe deletion failed: ${errorMsg}`);
+                logger.error('Stripe customer deletion failed', undefined, {
+                    stripeCustomerId,
+                    error: errorMsg,
+                });
+            }
+        }
+        const result = {
+            success: errors.length === 0,
+            customerId,
+            deletedAt: new Date().toISOString(),
+            counts,
+            stripeDeleted,
+            errors,
+        };
+        logger.info('Customer data deletion completed', {
+            customerId,
+            success: result.success,
+            counts,
+            dryRun,
+        });
+        return result;
+    }
+    // ==========================================================================
+    // Utility Methods
+    // ==========================================================================
+    /**
+     * Check if a customer has any billing data
+     */
+    hasCustomerData(customerId) {
+        const subscription = this.db
+            .prepare(`SELECT id FROM user_subscriptions WHERE customer_id = ? LIMIT 1`)
+            .get(customerId);
+        return !!subscription;
+    }
+    /**
+     * Get a summary of customer data (for consent/overview purposes)
+     */
+    getDataSummary(customerId) {
+        const subscription = this.db
+            .prepare(`SELECT id, stripe_customer_id FROM user_subscriptions WHERE customer_id = ? LIMIT 1`)
+            .get(customerId);
+        if (!subscription) {
+            return {
+                hasSubscription: false,
+                invoiceCount: 0,
+                licenseKeyCount: 0,
+                stripeCustomerId: null,
+            };
+        }
+        const invoiceCount = this.db
+            .prepare(`SELECT COUNT(*) as count FROM invoices WHERE customer_id = ?`)
+            .get(customerId);
+        const licenseKeyCount = this.db
+            .prepare(`SELECT COUNT(*) as count FROM license_keys WHERE subscription_id = ?`)
+            .get(subscription.id);
+        return {
+            hasSubscription: true,
+            invoiceCount: invoiceCount.count,
+            licenseKeyCount: licenseKeyCount.count,
+            stripeCustomerId: subscription.stripe_customer_id,
+        };
+    }
+}
+//# sourceMappingURL=GDPRComplianceService.js.map

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

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

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

@@ -0,0 +1,178 @@
+/**
+ * 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 type { BillingPeriod, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, CreatePortalSessionRequest, CreatePortalSessionResponse, LicenseTier, StripeCheckoutSessionId, StripeCustomerId, StripePriceId, StripeSubscriptionId, SubscriptionStatus } from './types.js';
+/**
+ * Stripe client configuration
+ */
+export interface StripeClientConfig {
+    /**
+     * Stripe secret key (sk_test_xxx or sk_live_xxx)
+     */
+    secretKey: string;
+    /**
+     * Stripe webhook signing secret (whsec_xxx)
+     */
+    webhookSecret: string;
+    /**
+     * Price ID mappings for each tier
+     */
+    prices: TierPriceConfigs;
+    /**
+     * Base URL for success/cancel redirects
+     */
+    appUrl?: string;
+}
+/**
+ * Price configurations for all tiers
+ */
+export interface TierPriceConfigs {
+    individual: {
+        monthly: StripePriceId;
+        annual: StripePriceId;
+    };
+    team: {
+        monthly: StripePriceId;
+        annual: StripePriceId;
+    };
+    enterprise: {
+        monthly: StripePriceId;
+        annual: StripePriceId;
+    };
+}
+/**
+ * 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 declare class StripeClient {
+    private readonly stripe;
+    private readonly webhookSecret;
+    private readonly prices;
+    private readonly appUrl;
+    constructor(config: StripeClientConfig);
+    /**
+     * Create a new Stripe customer
+     */
+    createCustomer(params: {
+        email: string;
+        name?: string;
+        metadata?: Record<string, string>;
+    }): Promise<StripeCustomerId>;
+    /**
+     * Get a Stripe customer by ID
+     */
+    getCustomer(customerId: StripeCustomerId): Promise<Stripe.Customer | null>;
+    /**
+     * Update a Stripe customer
+     */
+    updateCustomer(customerId: StripeCustomerId, params: {
+        email?: string;
+        name?: string;
+        metadata?: Record<string, string>;
+    }): Promise<Stripe.Customer>;
+    /**
+     * Create a Stripe Checkout session for subscription
+     */
+    createCheckoutSession(request: CreateCheckoutSessionRequest): Promise<CreateCheckoutSessionResponse>;
+    /**
+     * Retrieve a checkout session
+     */
+    getCheckoutSession(sessionId: StripeCheckoutSessionId): Promise<Stripe.Checkout.Session>;
+    /**
+     * Get a subscription by ID
+     */
+    getSubscription(subscriptionId: StripeSubscriptionId): Promise<Stripe.Subscription | null>;
+    /**
+     * List subscriptions for a customer
+     */
+    listSubscriptions(customerId: StripeCustomerId): Promise<Stripe.Subscription[]>;
+    /**
+     * Update a subscription (tier change or seat count)
+     */
+    updateSubscription(subscriptionId: StripeSubscriptionId, params: {
+        tier?: LicenseTier;
+        billingPeriod?: BillingPeriod;
+        seatCount?: number;
+        prorate?: boolean;
+    }): Promise<Stripe.Subscription>;
+    /**
+     * Cancel a subscription
+     */
+    cancelSubscription(subscriptionId: StripeSubscriptionId, options?: {
+        immediately?: boolean;
+        feedback?: string;
+    }): Promise<Stripe.Subscription>;
+    /**
+     * Reactivate a canceled subscription (before period end)
+     */
+    reactivateSubscription(subscriptionId: StripeSubscriptionId): Promise<Stripe.Subscription>;
+    /**
+     * Create a Stripe Customer Portal session
+     */
+    createPortalSession(request: CreatePortalSessionRequest): Promise<CreatePortalSessionResponse>;
+    /**
+     * List invoices for a customer
+     */
+    listInvoices(customerId: StripeCustomerId, options?: {
+        limit?: number;
+        startingAfter?: string;
+    }): Promise<{
+        invoices: Stripe.Invoice[];
+        hasMore: boolean;
+    }>;
+    /**
+     * Get a specific invoice
+     */
+    getInvoice(invoiceId: string): Promise<Stripe.Invoice | null>;
+    /**
+     * Get upcoming invoice preview (preview of next charge)
+     * Note: Stripe v20+ uses createPreview instead of retrieveUpcoming
+     */
+    getUpcomingInvoice(customerId: StripeCustomerId): Promise<Stripe.Invoice | null>;
+    /**
+     * Verify and parse a webhook event
+     */
+    verifyWebhookSignature(payload: string, signature: string): Stripe.Event;
+    /**
+     * Get the price ID for a tier and billing period
+     */
+    getPriceId(tier: LicenseTier, billingPeriod: BillingPeriod): StripePriceId | null;
+    /**
+     * Map Stripe subscription status to our status
+     */
+    static mapSubscriptionStatus(stripeStatus: Stripe.Subscription.Status): SubscriptionStatus;
+    /**
+     * Get the underlying Stripe instance (for advanced operations)
+     */
+    getStripeInstance(): Stripe;
+}
+//# sourceMappingURL=StripeClient.d.ts.map

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

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