@skillsmith/core 0.5.4 → 0.5.6

package/dist/billing/types.d.ts

@@ -0,0 +1,266 @@
+/**
+ * SMI-1062: Billing Types and Interfaces
+ *
+ * Type definitions for Stripe billing integration including:
+ * - Subscription management
+ * - Customer management
+ * - Invoice handling
+ * - Webhook events
+ */
+/**
+ * Available license tiers
+ * - community: Free tier (1,000 API calls/month)
+ * - individual: Solo developers ($9.99/mo, 10,000 API calls/month)
+ * - team: Teams ($25/user/mo, 100,000 API calls/month)
+ * - enterprise: Full enterprise ($55/user/mo, unlimited)
+ */
+export type LicenseTier = 'community' | 'individual' | 'team' | 'enterprise';
+/**
+ * Stripe Customer ID (cus_xxx)
+ */
+export type StripeCustomerId = string & {
+    readonly __brand: 'StripeCustomerId';
+};
+/**
+ * Stripe Subscription ID (sub_xxx)
+ */
+export type StripeSubscriptionId = string & {
+    readonly __brand: 'StripeSubscriptionId';
+};
+/**
+ * Stripe Price ID (price_xxx)
+ */
+export type StripePriceId = string & {
+    readonly __brand: 'StripePriceId';
+};
+/**
+ * Stripe Invoice ID (in_xxx)
+ */
+export type StripeInvoiceId = string & {
+    readonly __brand: 'StripeInvoiceId';
+};
+/**
+ * Stripe Checkout Session ID (cs_xxx)
+ */
+export type StripeCheckoutSessionId = string & {
+    readonly __brand: 'StripeCheckoutSessionId';
+};
+/**
+ * Stripe Event ID (evt_xxx)
+ */
+export type StripeEventId = string & {
+    readonly __brand: 'StripeEventId';
+};
+/**
+ * Subscription status values
+ */
+export type SubscriptionStatus = 'active' | 'past_due' | 'canceled' | 'trialing' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
+/**
+ * Customer record in our database
+ */
+export interface Customer {
+    id: string;
+    customerId: string;
+    email: string;
+    stripeCustomerId: StripeCustomerId | null;
+    tier: LicenseTier;
+    status: SubscriptionStatus;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Create customer request
+ */
+export interface CreateCustomerRequest {
+    email: string;
+    name?: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * Create customer response
+ */
+export interface CreateCustomerResponse {
+    customerId: string;
+    stripeCustomerId: StripeCustomerId;
+}
+/**
+ * Subscription record in our database
+ */
+export interface Subscription {
+    id: string;
+    customerId: string;
+    stripeSubscriptionId: StripeSubscriptionId | null;
+    stripePriceId: StripePriceId | null;
+    tier: LicenseTier;
+    status: SubscriptionStatus;
+    seatCount: number;
+    currentPeriodStart: Date | null;
+    currentPeriodEnd: Date | null;
+    canceledAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Billing period (monthly or annual)
+ */
+export type BillingPeriod = 'monthly' | 'annual';
+/**
+ * Create checkout session request
+ */
+export interface CreateCheckoutSessionRequest {
+    tier: LicenseTier;
+    billingPeriod: BillingPeriod;
+    seatCount?: number;
+    successUrl: string;
+    cancelUrl: string;
+    customerId?: string;
+    email?: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * Create checkout session response
+ */
+export interface CreateCheckoutSessionResponse {
+    sessionId: StripeCheckoutSessionId;
+    url: string;
+}
+/**
+ * Update subscription request
+ */
+export interface UpdateSubscriptionRequest {
+    subscriptionId: StripeSubscriptionId;
+    tier?: LicenseTier;
+    seatCount?: number;
+    prorate?: boolean;
+}
+/**
+ * Cancel subscription request
+ */
+export interface CancelSubscriptionRequest {
+    subscriptionId: StripeSubscriptionId;
+    immediately?: boolean;
+    feedback?: string;
+}
+/**
+ * Invoice status values
+ */
+export type InvoiceStatus = 'draft' | 'open' | 'paid' | 'void' | 'uncollectible';
+/**
+ * Invoice record in our database
+ */
+export interface Invoice {
+    id: string;
+    customerId: string;
+    stripeInvoiceId: StripeInvoiceId;
+    subscriptionId: string | null;
+    amountCents: number;
+    currency: string;
+    status: InvoiceStatus;
+    pdfUrl: string | null;
+    hostedInvoiceUrl: string | null;
+    invoiceNumber: string | null;
+    paidAt: Date | null;
+    periodStart: Date | null;
+    periodEnd: Date | null;
+    createdAt: Date;
+}
+/**
+ * Invoice list request
+ */
+export interface ListInvoicesRequest {
+    customerId: string;
+    limit?: number;
+    startingAfter?: string;
+}
+/**
+ * Invoice list response
+ */
+export interface ListInvoicesResponse {
+    invoices: Invoice[];
+    hasMore: boolean;
+}
+/**
+ * Stripe webhook event types we handle
+ */
+export type StripeWebhookEventType = 'customer.subscription.created' | 'customer.subscription.updated' | 'customer.subscription.deleted' | 'invoice.payment_succeeded' | 'invoice.payment_failed' | 'checkout.session.completed' | 'customer.created' | 'customer.updated';
+/**
+ * Webhook event record in our database
+ */
+export interface WebhookEvent {
+    id: string;
+    stripeEventId: StripeEventId;
+    eventType: StripeWebhookEventType;
+    processedAt: Date;
+    payload: string;
+    success: boolean;
+    errorMessage: string | null;
+    createdAt: Date;
+}
+/**
+ * Webhook processing result
+ */
+export interface WebhookProcessResult {
+    success: boolean;
+    message: string;
+    eventId: StripeEventId;
+    processed: boolean;
+    error?: string;
+}
+/**
+ * Create portal session request
+ */
+export interface CreatePortalSessionRequest {
+    customerId: string;
+    returnUrl: string;
+}
+/**
+ * Create portal session response
+ */
+export interface CreatePortalSessionResponse {
+    url: string;
+}
+/**
+ * Seat update request
+ */
+export interface UpdateSeatsRequest {
+    subscriptionId: StripeSubscriptionId;
+    seatCount: number;
+    prorate?: boolean;
+}
+/**
+ * Seat update response
+ */
+export interface UpdateSeatsResponse {
+    success: boolean;
+    seatCount: number;
+    proratedAmount?: number;
+    message: string;
+}
+/**
+ * Price configuration for a tier
+ */
+export interface TierPriceConfig {
+    tier: LicenseTier;
+    monthlyPriceId: StripePriceId;
+    annualPriceId: StripePriceId;
+    monthlyPrice: number;
+    annualPrice: number;
+    perUser: boolean;
+}
+/**
+ * All price configurations
+ */
+export type PriceConfigs = Record<LicenseTier, TierPriceConfig>;
+/**
+ * Billing-specific error codes
+ */
+export type BillingErrorCode = 'CUSTOMER_NOT_FOUND' | 'SUBSCRIPTION_NOT_FOUND' | 'INVALID_TIER' | 'PAYMENT_FAILED' | 'WEBHOOK_SIGNATURE_INVALID' | 'WEBHOOK_DUPLICATE_EVENT' | 'STRIPE_API_ERROR' | 'SEAT_LIMIT_EXCEEDED' | 'DOWNGRADE_NOT_ALLOWED';
+/**
+ * Billing error class
+ */
+export declare class BillingError extends Error {
+    readonly code: BillingErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: BillingErrorCode, details?: Record<string, unknown> | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/billing/types.js

@@ -0,0 +1,23 @@
+/**
+ * SMI-1062: Billing Types and Interfaces
+ *
+ * Type definitions for Stripe billing integration including:
+ * - Subscription management
+ * - Customer management
+ * - Invoice handling
+ * - Webhook events
+ */
+/**
+ * Billing error class
+ */
+export class BillingError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'BillingError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/billing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/billing/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkVH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAGnB;IACA;IAHlB,YACE,OAAe,EACC,IAAsB,EACtB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,SAAI,GAAJ,IAAI,CAAkB;QACtB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF"}

package/dist/billing/webhook-handlers.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SMI-1070: Stripe Webhook Event Handlers
+ *
+ * Individual event handler functions for Stripe webhooks.
+ * These are extracted to reduce the size of the main handler file.
+ */
+import type Stripe from 'stripe';
+import type { Database as DatabaseType } from '../db/database-interface.js';
+import { StripeClient } from './StripeClient.js';
+import type { BillingService } from './BillingService.js';
+import type { LicenseTier } from './types.js';
+export interface WebhookHandlerContext {
+    stripe: StripeClient;
+    billing: BillingService;
+    db: DatabaseType;
+    onLicenseKeyNeeded?: (params: {
+        customerId: string;
+        tier: LicenseTier;
+        expiresAt: Date;
+        subscriptionId: string;
+    }) => Promise<string>;
+    onEmailNeeded?: (params: {
+        type: 'license_key' | 'payment_failed' | 'subscription_canceled';
+        email: string;
+        data: Record<string, unknown>;
+    }) => Promise<void>;
+}
+export declare function handleSubscriptionCreated(ctx: WebhookHandlerContext, subscription: Stripe.Subscription): Promise<void>;
+export declare function handleSubscriptionUpdated(ctx: WebhookHandlerContext, subscription: Stripe.Subscription): Promise<void>;
+export declare function handleSubscriptionDeleted(ctx: WebhookHandlerContext, subscription: Stripe.Subscription): Promise<void>;
+export declare function handleInvoicePaymentSucceeded(ctx: WebhookHandlerContext, invoice: Stripe.Invoice): Promise<void>;
+export declare function handleInvoicePaymentFailed(ctx: WebhookHandlerContext, invoice: Stripe.Invoice): Promise<void>;
+export declare function handleCheckoutSessionCompleted(session: Stripe.Checkout.Session): void;
+export declare function storeLicenseKey(db: DatabaseType, params: {
+    subscriptionId: string;
+    organizationId: string;
+    keyJwt: string;
+    keyExpiry: Date;
+}): void;
+export declare function revokeLicenseKey(db: DatabaseType, subscriptionId: string, reason: string): void;
+export declare function extractTier(subscription: Stripe.Subscription): LicenseTier;
+export declare function extractSeatCount(subscription: Stripe.Subscription): number;
+/**
+ * Get current period end from subscription (Stripe v20+ moved this to items)
+ */
+export declare function getCurrentPeriodEnd(subscription: Stripe.Subscription): number;
+/**
+ * Get current period start from subscription (Stripe v20+ moved this to items)
+ */
+export declare function getCurrentPeriodStart(subscription: Stripe.Subscription): number;
+/**
+ * Extract subscription ID from invoice (Stripe v20+ structure)
+ * The subscription is now at invoice.parent.subscription_details.subscription
+ */
+export declare function extractSubscriptionIdFromInvoice(invoice: Stripe.Invoice): string | undefined;
+//# sourceMappingURL=webhook-handlers.d.ts.map

package/dist/billing/webhook-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-handlers.d.ts","sourceRoot":"","sources":["../../src/billing/webhook-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAEhC,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAA0C,MAAM,YAAY,CAAA;AASrF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,cAAc,CAAA;IACvB,EAAE,EAAE,YAAY,CAAA;IAChB,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE;QAC5B,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,WAAW,CAAA;QACjB,SAAS,EAAE,IAAI,CAAA;QACf,cAAc,EAAE,MAAM,CAAA;KACvB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACrB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,uBAAuB,CAAA;QAChE,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC9B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpB;AAMD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,qBAAqB,EAC1B,YAAY,EAAE,MAAM,CAAC,YAAY,GAChC,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,qBAAqB,EAC1B,YAAY,EAAE,MAAM,CAAC,YAAY,GAChC,OAAO,CAAC,IAAI,CAAC,CAiDf;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,qBAAqB,EAC1B,YAAY,EAAE,MAAM,CAAC,YAAY,GAChC,OAAO,CAAC,IAAI,CAAC,CAiCf;AAMD,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,MAAM,CAAC,OAAO,GACtB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,MAAM,CAAC,OAAO,GACtB,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAMD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,CASrF;AAMD,wBAAgB,eAAe,CAC7B,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,IAAI,CAAA;CAChB,GACA,IAAI,CAwBN;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAU/F;AAMD,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,GAAG,WAAW,CAS1E;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAY1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAU7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAU/E;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,SAAS,CAM5F"}

package/dist/billing/webhook-handlers.js

@@ -0,0 +1,303 @@
+/**
+ * SMI-1070: Stripe Webhook Event Handlers
+ *
+ * Individual event handler functions for Stripe webhooks.
+ * These are extracted to reduce the size of the main handler file.
+ */
+import { createHash, randomUUID } from 'crypto';
+import { createLogger } from '../utils/logger.js';
+import { StripeClient } from './StripeClient.js';
+import { BillingError } from './types.js';
+const logger = createLogger('WebhookHandlers');
+// ============================================================================
+// Subscription Event Handlers
+// ============================================================================
+export async function handleSubscriptionCreated(ctx, subscription) {
+    logger.info('Processing subscription.created', {
+        subscriptionId: subscription.id,
+        customerId: subscription.customer,
+        status: subscription.status,
+    });
+    const customer = await ctx.stripe.getCustomer(subscription.customer);
+    if (!customer) {
+        throw new BillingError('Customer not found', 'CUSTOMER_NOT_FOUND');
+    }
+    const tier = extractTier(subscription);
+    const seatCount = extractSeatCount(subscription);
+    // Create/update subscription record
+    const sub = ctx.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(getCurrentPeriodStart(subscription) * 1000),
+        currentPeriodEnd: new Date(getCurrentPeriodEnd(subscription) * 1000),
+    });
+    // Generate license key if subscription is active
+    if (subscription.status === 'active' && ctx.onLicenseKeyNeeded) {
+        const periodEnd = getCurrentPeriodEnd(subscription);
+        const licenseKey = await ctx.onLicenseKeyNeeded({
+            customerId: customer.id,
+            tier,
+            expiresAt: new Date(periodEnd * 1000),
+            subscriptionId: sub.id,
+        });
+        // Store license key
+        storeLicenseKey(ctx.db, {
+            subscriptionId: sub.id,
+            organizationId: customer.id,
+            keyJwt: licenseKey,
+            keyExpiry: new Date(periodEnd * 1000),
+        });
+        // Send license key email
+        if (ctx.onEmailNeeded) {
+            await ctx.onEmailNeeded({
+                type: 'license_key',
+                email: customer.email,
+                data: {
+                    licenseKey,
+                    tier,
+                    expiresAt: new Date(periodEnd * 1000).toISOString(),
+                },
+            });
+        }
+    }
+}
+export async function handleSubscriptionUpdated(ctx, subscription) {
+    logger.info('Processing subscription.updated', {
+        subscriptionId: subscription.id,
+        status: subscription.status,
+    });
+    const existingSub = ctx.billing.getSubscriptionByStripeId(subscription.id);
+    if (!existingSub) {
+        // Subscription doesn't exist locally, create it
+        await handleSubscriptionCreated(ctx, subscription);
+        return;
+    }
+    // Update status
+    const newStatus = StripeClient.mapSubscriptionStatus(subscription.status);
+    const canceledAt = subscription.canceled_at ? new Date(subscription.canceled_at * 1000) : null;
+    ctx.billing.updateSubscriptionStatus(subscription.id, newStatus, canceledAt);
+    // Check if tier changed (regenerate license key)
+    const newTier = extractTier(subscription);
+    if (existingSub.tier !== newTier && ctx.onLicenseKeyNeeded) {
+        const customer = await ctx.stripe.getCustomer(subscription.customer);
+        if (customer) {
+            // Revoke old license key
+            revokeLicenseKey(ctx.db, existingSub.id, 'tier_change');
+            // Generate new license key
+            const periodEnd = getCurrentPeriodEnd(subscription);
+            const licenseKey = await ctx.onLicenseKeyNeeded({
+                customerId: customer.id,
+                tier: newTier,
+                expiresAt: new Date(periodEnd * 1000),
+                subscriptionId: existingSub.id,
+            });
+            storeLicenseKey(ctx.db, {
+                subscriptionId: existingSub.id,
+                organizationId: customer.id,
+                keyJwt: licenseKey,
+                keyExpiry: new Date(periodEnd * 1000),
+            });
+        }
+    }
+}
+export async function handleSubscriptionDeleted(ctx, subscription) {
+    logger.info('Processing subscription.deleted', {
+        subscriptionId: subscription.id,
+    });
+    const existingSub = ctx.billing.getSubscriptionByStripeId(subscription.id);
+    if (existingSub) {
+        // Update status to canceled
+        ctx.billing.updateSubscriptionStatus(subscription.id, 'canceled', new Date());
+        // Revoke license key
+        revokeLicenseKey(ctx.db, existingSub.id, 'subscription_canceled');
+        // Send cancellation email
+        if (ctx.onEmailNeeded) {
+            const customer = await ctx.stripe.getCustomer(subscription.customer);
+            if (customer?.email) {
+                await ctx.onEmailNeeded({
+                    type: 'subscription_canceled',
+                    email: customer.email,
+                    data: {
+                        subscriptionId: subscription.id,
+                        canceledAt: new Date().toISOString(),
+                    },
+                });
+            }
+        }
+    }
+}
+// ============================================================================
+// Invoice Event Handlers
+// ============================================================================
+export async function handleInvoicePaymentSucceeded(ctx, 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
+    ctx.billing.storeInvoice({
+        customerId,
+        stripeInvoiceId: invoice.id,
+        subscriptionId: extractSubscriptionIdFromInvoice(invoice),
+        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,
+    });
+}
+export async function handleInvoicePaymentFailed(ctx, 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;
+    // Get subscription ID from parent.subscription_details (Stripe v20+ structure)
+    const subscriptionId = extractSubscriptionIdFromInvoice(invoice);
+    // Store invoice with failed status
+    ctx.billing.storeInvoice({
+        customerId,
+        stripeInvoiceId: invoice.id,
+        subscriptionId,
+        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 (ctx.onEmailNeeded) {
+        const customer = await ctx.stripe.getCustomer(customerId);
+        if (customer?.email) {
+            await ctx.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
+// ============================================================================
+export function 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
+// ============================================================================
+export function storeLicenseKey(db, params) {
+    const id = randomUUID();
+    const keyHash = createHash('sha256').update(params.keyJwt).digest('hex');
+    const now = new Date().toISOString();
+    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) + '...',
+    });
+}
+export function revokeLicenseKey(db, subscriptionId, reason) {
+    const now = new Date().toISOString();
+    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 Functions
+// ============================================================================
+export function 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';
+}
+export function 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;
+}
+/**
+ * Get current period end from subscription (Stripe v20+ moved this to items)
+ */
+export function getCurrentPeriodEnd(subscription) {
+    const periodEnd = subscription.items.data[0]?.current_period_end;
+    if (!periodEnd) {
+        logger.warn('No subscription items found for period end', {
+            subscriptionId: subscription.id,
+            itemCount: subscription.items.data.length,
+        });
+        return Math.floor(Date.now() / 1000);
+    }
+    return periodEnd;
+}
+/**
+ * Get current period start from subscription (Stripe v20+ moved this to items)
+ */
+export function getCurrentPeriodStart(subscription) {
+    const periodStart = subscription.items.data[0]?.current_period_start;
+    if (!periodStart) {
+        logger.warn('No subscription items found for period start', {
+            subscriptionId: subscription.id,
+            itemCount: subscription.items.data.length,
+        });
+        return Math.floor(Date.now() / 1000);
+    }
+    return periodStart;
+}
+/**
+ * Extract subscription ID from invoice (Stripe v20+ structure)
+ * The subscription is now at invoice.parent.subscription_details.subscription
+ */
+export function extractSubscriptionIdFromInvoice(invoice) {
+    const subscription = invoice.parent?.subscription_details?.subscription;
+    if (!subscription) {
+        return undefined;
+    }
+    return typeof subscription === 'string' ? subscription : subscription.id;
+}
+//# sourceMappingURL=webhook-handlers.js.map