@agentlensai/server 0.10.0 → 0.13.0

package/dist/cloud/billing/billing-service.js

@@ -0,0 +1,153 @@
+/**
+ * Billing Service (S-6.1)
+ *
+ * Handles Stripe customer lifecycle, subscription management,
+ * and webhook processing.
+ */
+import { TIER_CONFIG } from './stripe-client.js';
+export class BillingService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Create a Stripe customer for an org (called on org creation).
+     * Stores stripe_customer_id on the orgs table.
+     */
+    async createCustomerForOrg(orgId, email, name) {
+        const customer = await this.deps.stripe.createCustomer(email, name, orgId);
+        await this.deps.db.query(`UPDATE orgs SET stripe_customer_id = $1 WHERE id = $2`, [customer.id, orgId]);
+        return customer.id;
+    }
+    /**
+     * Upgrade an org to a paid plan. Creates a Stripe subscription.
+     */
+    async upgradePlan(orgId, newTier) {
+        if (newTier === 'free') {
+            throw new Error('Cannot upgrade to free tier. Use downgradePlan instead.');
+        }
+        const tierConfig = TIER_CONFIG[newTier];
+        const org = await this.getOrg(orgId);
+        if (!org.stripe_customer_id) {
+            throw new Error('Org has no Stripe customer. Call createCustomerForOrg first.');
+        }
+        // Cancel existing subscription if any
+        if (org.stripe_subscription_id) {
+            await this.deps.stripe.cancelSubscription(org.stripe_subscription_id, false);
+        }
+        // Create new subscription
+        const items = [{ price: tierConfig.price_id }];
+        if (tierConfig.overage_price_id) {
+            items.push({ price: tierConfig.overage_price_id });
+        }
+        const subscription = await this.deps.stripe.createSubscription({
+            customer: org.stripe_customer_id,
+            items,
+        });
+        await this.deps.db.query(`UPDATE orgs SET plan = $1, stripe_subscription_id = $2, event_quota = $3, updated_at = now()
+       WHERE id = $4`, [newTier, subscription.id, tierConfig.event_quota, orgId]);
+    }
+    /**
+     * Downgrade an org (cancels at period end, schedules free tier).
+     */
+    async downgradePlan(orgId) {
+        const org = await this.getOrg(orgId);
+        if (org.stripe_subscription_id) {
+            await this.deps.stripe.cancelSubscription(org.stripe_subscription_id, true);
+        }
+        // Mark as pending downgrade — actual tier change happens via webhook
+        // when subscription period ends. For immediate effect in tests/mock:
+        await this.deps.db.query(`UPDATE orgs SET settings = jsonb_set(COALESCE(settings, '{}'), '{pending_downgrade}', '"free"'), updated_at = now()
+       WHERE id = $1`, [orgId]);
+    }
+    /**
+     * Process a Stripe webhook event.
+     */
+    async handleWebhook(event) {
+        try {
+            switch (event.type) {
+                case 'invoice.paid':
+                    return await this.handleInvoicePaid(event);
+                case 'invoice.payment_failed':
+                    return await this.handlePaymentFailed(event);
+                case 'customer.subscription.updated':
+                    return await this.handleSubscriptionUpdated(event);
+                case 'customer.subscription.deleted':
+                    return await this.handleSubscriptionDeleted(event);
+                default:
+                    return { handled: false, action: 'ignored' };
+            }
+        }
+        catch (err) {
+            return { handled: false, error: String(err) };
+        }
+    }
+    // ── Webhook handlers ──
+    async handleInvoicePaid(event) {
+        const invoice = event.data.object;
+        const stripeInvoiceId = invoice.id;
+        const customerId = invoice.customer;
+        const amountPaid = invoice.amount_paid;
+        const periodStart = invoice.period_start;
+        const periodEnd = invoice.period_end;
+        // Find org by stripe_customer_id
+        const orgResult = await this.deps.db.query(`SELECT id FROM orgs WHERE stripe_customer_id = $1`, [customerId]);
+        const org = orgResult.rows[0];
+        if (!org)
+            return { handled: false, error: 'org_not_found' };
+        // Upsert invoice record
+        await this.deps.db.query(`INSERT INTO invoices (org_id, stripe_invoice_id, period_start, period_end, base_amount_cents, total_amount_cents, status)
+       VALUES ($1, $2, to_timestamp($3), to_timestamp($4), $5, $5, 'paid')
+       ON CONFLICT (stripe_invoice_id) DO UPDATE SET status = 'paid', total_amount_cents = $5`, [org.id, stripeInvoiceId, periodStart, periodEnd, amountPaid]);
+        return { handled: true, action: 'invoice_recorded' };
+    }
+    async handlePaymentFailed(event) {
+        const invoice = event.data.object;
+        const customerId = invoice.customer;
+        const orgResult = await this.deps.db.query(`SELECT id FROM orgs WHERE stripe_customer_id = $1`, [customerId]);
+        const org = orgResult.rows[0];
+        if (!org)
+            return { handled: false, error: 'org_not_found' };
+        // Mark org as past_due in settings
+        await this.deps.db.query(`UPDATE orgs SET settings = jsonb_set(COALESCE(settings, '{}'), '{payment_status}', '"past_due"')
+       WHERE id = $1`, [org.id]);
+        return { handled: true, action: 'payment_failed_recorded' };
+    }
+    async handleSubscriptionUpdated(event) {
+        const sub = event.data.object;
+        const customerId = sub.customer;
+        const subId = sub.id;
+        const cancelAtPeriodEnd = sub.cancel_at_period_end;
+        const orgResult = await this.deps.db.query(`SELECT id FROM orgs WHERE stripe_customer_id = $1`, [customerId]);
+        const org = orgResult.rows[0];
+        if (!org)
+            return { handled: false, error: 'org_not_found' };
+        await this.deps.db.query(`UPDATE orgs SET stripe_subscription_id = $1, updated_at = now() WHERE id = $2`, [subId, org.id]);
+        if (cancelAtPeriodEnd) {
+            await this.deps.db.query(`UPDATE orgs SET settings = jsonb_set(COALESCE(settings, '{}'), '{pending_downgrade}', '"free"')
+         WHERE id = $1`, [org.id]);
+        }
+        return { handled: true, action: 'subscription_updated' };
+    }
+    async handleSubscriptionDeleted(event) {
+        const sub = event.data.object;
+        const customerId = sub.customer;
+        const orgResult = await this.deps.db.query(`SELECT id FROM orgs WHERE stripe_customer_id = $1`, [customerId]);
+        const org = orgResult.rows[0];
+        if (!org)
+            return { handled: false, error: 'org_not_found' };
+        // Downgrade to free
+        await this.deps.db.query(`UPDATE orgs SET plan = 'free', stripe_subscription_id = NULL,
+       event_quota = $1, updated_at = now() WHERE id = $2`, [TIER_CONFIG.free.event_quota, org.id]);
+        return { handled: true, action: 'downgraded_to_free' };
+    }
+    // ── Helpers ──
+    async getOrg(orgId) {
+        const result = await this.deps.db.query(`SELECT id, plan, stripe_customer_id, stripe_subscription_id FROM orgs WHERE id = $1`, [orgId]);
+        const org = result.rows[0];
+        if (!org)
+            throw new Error(`Org ${orgId} not found`);
+        return org;
+    }
+}
+//# sourceMappingURL=billing-service.js.map

package/dist/cloud/billing/billing-service.js.map

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

package/dist/cloud/billing/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Billing Module Index (S-6.1 through S-6.6)
+ */
+export { type IStripeClient, type StripeCustomer, type StripeSubscription, type StripeSubscriptionItem, type StripeInvoice, type StripeWebhookEvent, type CreateSubscriptionParams, type UsageRecordParams, type TierName, TIER_CONFIG, MockStripeClient, createStripeClient, } from './stripe-client.js';
+export { BillingService, type BillingServiceDeps, type WebhookResult } from './billing-service.js';
+export { UsageAccumulator, UsageQuery, reportOverageToStripe, type UsageMeteringDeps, type UsageSummary, type RedisUsageStore, } from './usage-metering.js';
+export { QuotaEnforcer, type QuotaCheckResult, type QuotaEnforcerDeps, type OrgQuotaInfo, } from './quota-enforcement.js';
+export { PlanManager, ANNUAL_PRICE_IDS, type PlanManagementDeps, type PlanChangeResult, } from './plan-management.js';
+export { InvoiceService, ANNUAL_DISCOUNT, calculateAnnualPrice, type InvoiceServiceDeps, type InvoiceRecord, type InvoiceLineItem, } from './invoice-service.js';
+export { TrialService, TRIAL_DURATION_DAYS, type TrialServiceDeps, type TrialStatus, } from './trial-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cloud/billing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cloud/billing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEnG,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/cloud/billing/index.js

@@ -0,0 +1,11 @@
+/**
+ * Billing Module Index (S-6.1 through S-6.6)
+ */
+export { TIER_CONFIG, MockStripeClient, createStripeClient, } from './stripe-client.js';
+export { BillingService } from './billing-service.js';
+export { UsageAccumulator, UsageQuery, reportOverageToStripe, } from './usage-metering.js';
+export { QuotaEnforcer, } from './quota-enforcement.js';
+export { PlanManager, ANNUAL_PRICE_IDS, } from './plan-management.js';
+export { InvoiceService, ANNUAL_DISCOUNT, calculateAnnualPrice, } from './invoice-service.js';
+export { TrialService, TRIAL_DURATION_DAYS, } from './trial-service.js';
+//# sourceMappingURL=index.js.map

package/dist/cloud/billing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cloud/billing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAUL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAA+C,MAAM,sBAAsB,CAAC;AAEnG,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,qBAAqB,GAItB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,aAAa,GAId,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,WAAW,EACX,gBAAgB,GAGjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,GAIrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC"}

package/dist/cloud/billing/invoice-service.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Invoice Generation & Annual Billing (S-6.5)
+ *
+ * - Monthly invoices via Stripe with itemized usage (base + overage)
+ * - Annual billing with 20% discount
+ * - Invoices table synced from Stripe webhooks
+ * - Invoice list queryable via API
+ */
+import type { IStripeClient, StripeWebhookEvent } from './stripe-client.js';
+import type { MigrationClient } from '../migrate.js';
+export interface InvoiceServiceDeps {
+    stripe: IStripeClient;
+    db: MigrationClient;
+}
+export interface InvoiceRecord {
+    id: string;
+    org_id: string;
+    stripe_invoice_id: string;
+    period_start: string;
+    period_end: string;
+    base_amount_cents: number;
+    overage_amount_cents: number;
+    total_amount_cents: number;
+    status: 'draft' | 'open' | 'paid' | 'void' | 'uncollectible';
+    billing_interval: 'monthly' | 'annual';
+    line_items: InvoiceLineItem[];
+    created_at: string;
+}
+export interface InvoiceLineItem {
+    description: string;
+    amount_cents: number;
+    quantity: number;
+}
+/** Annual pricing = monthly × 12 × 0.8 (20% discount) */
+export declare const ANNUAL_DISCOUNT = 0.2;
+export declare function calculateAnnualPrice(monthlyPriceCents: number): number;
+export declare class InvoiceService {
+    private deps;
+    constructor(deps: InvoiceServiceDeps);
+    /**
+     * Sync an invoice from a Stripe webhook event into the invoices table.
+     */
+    syncInvoiceFromWebhook(event: StripeWebhookEvent): Promise<InvoiceRecord | null>;
+    /**
+     * List invoices for an org, newest first.
+     */
+    listInvoices(orgId: string, limit?: number, offset?: number): Promise<InvoiceRecord[]>;
+    /**
+     * Calculate overage charges for an org's current period.
+     */
+    calculateOverageCharges(orgId: string): Promise<{
+        overage_events: number;
+        overage_cost_cents: number;
+        rate_per_1k_cents: number;
+    }>;
+}
+//# sourceMappingURL=invoice-service.d.ts.map

package/dist/cloud/billing/invoice-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-service.d.ts","sourceRoot":"","sources":["../../../src/cloud/billing/invoice-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAY,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,eAAe,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;IAC7D,gBAAgB,EAAE,SAAS,GAAG,QAAQ,CAAC;IACvC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yDAAyD;AACzD,eAAO,MAAM,eAAe,MAAO,CAAC;AAEpC,wBAAgB,oBAAoB,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAE5C;;OAEG;IACG,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2EtF;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IASnF;;OAEG;IACG,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QACpD,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CAkCH"}

package/dist/cloud/billing/invoice-service.js

@@ -0,0 +1,123 @@
+/**
+ * Invoice Generation & Annual Billing (S-6.5)
+ *
+ * - Monthly invoices via Stripe with itemized usage (base + overage)
+ * - Annual billing with 20% discount
+ * - Invoices table synced from Stripe webhooks
+ * - Invoice list queryable via API
+ */
+import { TIER_CONFIG } from './stripe-client.js';
+/** Annual pricing = monthly × 12 × 0.8 (20% discount) */
+export const ANNUAL_DISCOUNT = 0.20;
+export function calculateAnnualPrice(monthlyPriceCents) {
+    return Math.round(monthlyPriceCents * 12 * (1 - ANNUAL_DISCOUNT));
+}
+export class InvoiceService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Sync an invoice from a Stripe webhook event into the invoices table.
+     */
+    async syncInvoiceFromWebhook(event) {
+        const invoice = event.data.object;
+        const stripeInvoiceId = invoice.id;
+        const customerId = invoice.customer;
+        const status = invoice.status;
+        const amountDue = invoice.amount_due ?? 0;
+        const amountPaid = invoice.amount_paid ?? 0;
+        const periodStart = invoice.period_start;
+        const periodEnd = invoice.period_end;
+        // Extract line items
+        const lines = invoice.lines?.data ?? [];
+        const lineItems = lines.map((line) => ({
+            description: line.description ?? 'Subscription',
+            amount_cents: line.amount ?? 0,
+            quantity: line.quantity ?? 1,
+        }));
+        // Calculate base vs overage from line items
+        let baseAmount = 0;
+        let overageAmount = 0;
+        for (const line of lineItems) {
+            if ((line.description ?? '').toLowerCase().includes('overage')) {
+                overageAmount += line.amount_cents;
+            }
+            else {
+                baseAmount += line.amount_cents;
+            }
+        }
+        const totalAmount = status === 'paid' ? amountPaid : amountDue;
+        // Find org
+        const orgResult = await this.deps.db.query(`SELECT id FROM orgs WHERE stripe_customer_id = $1`, [customerId]);
+        const org = orgResult.rows[0];
+        if (!org)
+            return null;
+        // Determine billing interval from period length
+        const periodDays = (periodEnd - periodStart) / 86400;
+        const billingInterval = periodDays > 60 ? 'annual' : 'monthly';
+        // Upsert invoice
+        await this.deps.db.query(`INSERT INTO invoices (org_id, stripe_invoice_id, period_start, period_end,
+       base_amount_cents, overage_amount_cents, total_amount_cents, status,
+       billing_interval, line_items)
+       VALUES ($1, $2, to_timestamp($3), to_timestamp($4), $5, $6, $7, $8, $9, $10::jsonb)
+       ON CONFLICT (stripe_invoice_id)
+       DO UPDATE SET status = $8, total_amount_cents = $7, overage_amount_cents = $6,
+       line_items = $10::jsonb`, [
+            org.id, stripeInvoiceId, periodStart, periodEnd,
+            baseAmount, overageAmount, totalAmount, status,
+            billingInterval, JSON.stringify(lineItems),
+        ]);
+        return {
+            id: stripeInvoiceId,
+            org_id: org.id,
+            stripe_invoice_id: stripeInvoiceId,
+            period_start: new Date(periodStart * 1000).toISOString(),
+            period_end: new Date(periodEnd * 1000).toISOString(),
+            base_amount_cents: baseAmount,
+            overage_amount_cents: overageAmount,
+            total_amount_cents: totalAmount,
+            status: status,
+            billing_interval: billingInterval,
+            line_items: lineItems,
+            created_at: new Date().toISOString(),
+        };
+    }
+    /**
+     * List invoices for an org, newest first.
+     */
+    async listInvoices(orgId, limit = 20, offset = 0) {
+        const result = await this.deps.db.query(`SELECT * FROM invoices WHERE org_id = $1
+       ORDER BY period_start DESC LIMIT $2 OFFSET $3`, [orgId, limit, offset]);
+        return result.rows;
+    }
+    /**
+     * Calculate overage charges for an org's current period.
+     */
+    async calculateOverageCharges(orgId) {
+        // Get org plan and usage
+        const orgResult = await this.deps.db.query(`SELECT plan, event_quota FROM orgs WHERE id = $1`, [orgId]);
+        const org = orgResult.rows[0];
+        if (!org)
+            throw new Error(`Org ${orgId} not found`);
+        const plan = org.plan;
+        const quota = org.event_quota;
+        const rate = TIER_CONFIG[plan]?.overage_rate_per_1k_cents ?? 0;
+        // Get current month usage
+        const now = new Date();
+        const month = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, '0')}`;
+        const monthStart = `${month}-01T00:00:00Z`;
+        const nextMonth = new Date(now.getUTCFullYear(), now.getUTCMonth() + 1, 1);
+        const usageResult = await this.deps.db.query(`SELECT COALESCE(SUM(event_count), 0)::int as total
+       FROM usage_records WHERE org_id = $1 AND hour >= $2 AND hour < $3`, [orgId, monthStart, nextMonth.toISOString()]);
+        const totalEvents = usageResult.rows[0]?.total ?? 0;
+        const overageEvents = Math.max(0, totalEvents - quota);
+        const overageCostCents = Math.ceil(overageEvents / 1000) * rate;
+        return {
+            overage_events: overageEvents,
+            overage_cost_cents: overageCostCents,
+            rate_per_1k_cents: rate,
+        };
+    }
+}
+//# sourceMappingURL=invoice-service.js.map

package/dist/cloud/billing/invoice-service.js.map

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

package/dist/cloud/billing/plan-management.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Plan Upgrade/Downgrade (S-6.4)
+ *
+ * - Upgrade: immediate, with proration
+ * - Downgrade: at end of billing period
+ * - Enforces tier limits (keys, members, orgs)
+ */
+import type { IStripeClient, TierName } from './stripe-client.js';
+import type { MigrationClient } from '../migrate.js';
+export interface PlanManagementDeps {
+    stripe: IStripeClient;
+    db: MigrationClient;
+}
+export interface PlanChangeResult {
+    success: boolean;
+    action: 'upgraded' | 'downgraded' | 'scheduled_downgrade';
+    previousPlan: TierName;
+    newPlan: TierName;
+    effectiveAt: 'immediate' | 'end_of_period';
+    prorationApplied?: boolean;
+}
+/** Annual pricing: 20% discount applied to monthly × 12 */
+export declare const ANNUAL_PRICE_IDS: Partial<Record<TierName, string>>;
+export declare class PlanManager {
+    private deps;
+    constructor(deps: PlanManagementDeps);
+    /**
+     * Change an org's plan. Upgrades are immediate with proration;
+     * downgrades take effect at end of billing period.
+     */
+    changePlan(orgId: string, newTier: TierName, billing?: 'monthly' | 'annual'): Promise<PlanChangeResult>;
+    /**
+     * Immediate upgrade with proration.
+     */
+    private handleUpgrade;
+    /**
+     * Downgrade at end of billing period.
+     */
+    private handleDowngrade;
+    /**
+     * Apply a pending downgrade (called from webhook when subscription period ends).
+     */
+    applyPendingDowngrade(orgId: string): Promise<void>;
+    private getOrg;
+}
+//# sourceMappingURL=plan-management.d.ts.map

package/dist/cloud/billing/plan-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-management.d.ts","sourceRoot":"","sources":["../../../src/cloud/billing/plan-management.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,eAAe,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,qBAAqB,CAAC;IAC1D,YAAY,EAAE,QAAQ,CAAC;IACvB,OAAO,EAAE,QAAQ,CAAC;IAClB,WAAW,EAAE,WAAW,GAAG,eAAe,CAAC;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAUD,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAG9D,CAAC;AAEF,qBAAa,WAAW;IACV,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAE5C;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAE,SAAS,GAAG,QAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBxH;;OAEG;YACW,aAAa;IAmD3B;;OAEG;YACW,eAAe;IAmC7B;;OAEG;IACG,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAqC3C,MAAM;CASrB"}

package/dist/cloud/billing/plan-management.js

@@ -0,0 +1,157 @@
+/**
+ * Plan Upgrade/Downgrade (S-6.4)
+ *
+ * - Upgrade: immediate, with proration
+ * - Downgrade: at end of billing period
+ * - Enforces tier limits (keys, members, orgs)
+ */
+import { TIER_CONFIG } from './stripe-client.js';
+/** Tier ordering for upgrade/downgrade detection */
+const TIER_ORDER = {
+    free: 0,
+    pro: 1,
+    team: 2,
+    enterprise: 3,
+};
+/** Annual pricing: 20% discount applied to monthly × 12 */
+export const ANNUAL_PRICE_IDS = {
+    pro: 'price_pro_annual',
+    team: 'price_team_annual',
+};
+export class PlanManager {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Change an org's plan. Upgrades are immediate with proration;
+     * downgrades take effect at end of billing period.
+     */
+    async changePlan(orgId, newTier, billing = 'monthly') {
+        const org = await this.getOrg(orgId);
+        const currentTier = org.plan;
+        if (currentTier === newTier) {
+            throw new Error(`Org is already on the ${newTier} plan.`);
+        }
+        if (!org.stripe_customer_id) {
+            throw new Error('Org has no Stripe customer. Call createCustomerForOrg first.');
+        }
+        const isUpgrade = TIER_ORDER[newTier] > TIER_ORDER[currentTier];
+        if (isUpgrade) {
+            return this.handleUpgrade(org, newTier, billing);
+        }
+        else {
+            return this.handleDowngrade(org, newTier);
+        }
+    }
+    /**
+     * Immediate upgrade with proration.
+     */
+    async handleUpgrade(org, newTier, billing) {
+        const previousPlan = org.plan;
+        const tierConfig = TIER_CONFIG[newTier];
+        // Build subscription items for the new tier
+        const priceId = billing === 'annual' && ANNUAL_PRICE_IDS[newTier]
+            ? ANNUAL_PRICE_IDS[newTier]
+            : tierConfig.price_id;
+        const items = [{ price: priceId }];
+        if (tierConfig.overage_price_id) {
+            items.push({ price: tierConfig.overage_price_id });
+        }
+        // Atomically update existing subscription (proration) instead of cancel+recreate
+        let subscription;
+        if (org.stripe_subscription_id) {
+            subscription = await this.deps.stripe.updateSubscription(org.stripe_subscription_id, items);
+        }
+        else {
+            subscription = await this.deps.stripe.createSubscription({
+                customer: org.stripe_customer_id,
+                items,
+            });
+        }
+        // Update org immediately
+        await this.deps.db.query(`UPDATE orgs SET plan = $1, stripe_subscription_id = $2, event_quota = $3,
+       settings = jsonb_set(
+         jsonb_set(COALESCE(settings, '{}'), '{billing_interval}', $5::jsonb),
+         '{pending_downgrade}', 'null'::jsonb
+       ),
+       updated_at = now()
+       WHERE id = $4`, [newTier, subscription.id, tierConfig.event_quota, org.id, JSON.stringify(billing)]);
+        return {
+            success: true,
+            action: 'upgraded',
+            previousPlan,
+            newPlan: newTier,
+            effectiveAt: 'immediate',
+            prorationApplied: !!org.stripe_subscription_id, // proration if replacing existing sub
+        };
+    }
+    /**
+     * Downgrade at end of billing period.
+     */
+    async handleDowngrade(org, newTier) {
+        const previousPlan = org.plan;
+        if (newTier === 'free') {
+            // Cancel subscription at period end
+            if (org.stripe_subscription_id) {
+                await this.deps.stripe.cancelSubscription(org.stripe_subscription_id, true);
+            }
+        }
+        else {
+            // Downgrading to a lower paid tier — schedule change at period end
+            if (org.stripe_subscription_id) {
+                await this.deps.stripe.cancelSubscription(org.stripe_subscription_id, true);
+            }
+        }
+        // Record pending downgrade
+        await this.deps.db.query(`UPDATE orgs SET settings = jsonb_set(COALESCE(settings, '{}'), '{pending_downgrade}', $1::jsonb),
+       updated_at = now()
+       WHERE id = $2`, [JSON.stringify(newTier), org.id]);
+        return {
+            success: true,
+            action: 'scheduled_downgrade',
+            previousPlan,
+            newPlan: newTier,
+            effectiveAt: 'end_of_period',
+        };
+    }
+    /**
+     * Apply a pending downgrade (called from webhook when subscription period ends).
+     */
+    async applyPendingDowngrade(orgId) {
+        const org = await this.getOrg(orgId);
+        const pendingTier = org.settings?.pending_downgrade;
+        if (!pendingTier)
+            return;
+        const tierConfig = TIER_CONFIG[pendingTier];
+        if (pendingTier === 'free') {
+            await this.deps.db.query(`UPDATE orgs SET plan = 'free', stripe_subscription_id = NULL,
+         event_quota = $1, settings = settings - 'pending_downgrade',
+         updated_at = now()
+         WHERE id = $2`, [tierConfig.event_quota, orgId]);
+        }
+        else {
+            // Downgrade to lower paid tier — create new subscription
+            const items = [{ price: tierConfig.price_id }];
+            if (tierConfig.overage_price_id) {
+                items.push({ price: tierConfig.overage_price_id });
+            }
+            const subscription = await this.deps.stripe.createSubscription({
+                customer: org.stripe_customer_id,
+                items,
+            });
+            await this.deps.db.query(`UPDATE orgs SET plan = $1, stripe_subscription_id = $2,
+         event_quota = $3, settings = settings - 'pending_downgrade',
+         updated_at = now()
+         WHERE id = $4`, [pendingTier, subscription.id, tierConfig.event_quota, orgId]);
+        }
+    }
+    async getOrg(orgId) {
+        const result = await this.deps.db.query(`SELECT id, plan, stripe_customer_id, stripe_subscription_id, settings FROM orgs WHERE id = $1`, [orgId]);
+        const org = result.rows[0];
+        if (!org)
+            throw new Error(`Org ${orgId} not found`);
+        return org;
+    }
+}
+//# sourceMappingURL=plan-management.js.map

package/dist/cloud/billing/plan-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-management.js","sourceRoot":"","sources":["../../../src/cloud/billing/plan-management.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiBjD,oDAAoD;AACpD,MAAM,UAAU,GAA6B;IAC3C,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAsC;IACjE,GAAG,EAAE,kBAAkB;IACvB,IAAI,EAAE,mBAAmB;CAC1B,CAAC;AAEF,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;IAAG,CAAC;IAEhD;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,OAAiB,EAAE,UAAgC,SAAS;QAC1F,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,GAAG,CAAC,IAAgB,CAAC;QAEzC,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,QAAQ,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAEhE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CACzB,GAAW,EACX,OAAiB,EACjB,OAA6B;QAE7B,MAAM,YAAY,GAAG,GAAG,CAAC,IAAgB,CAAC;QAC1C,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAExC,4CAA4C;QAC5C,MAAM,OAAO,GAAG,OAAO,KAAK,QAAQ,IAAI,gBAAgB,CAAC,OAAO,CAAC;YAC/D,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAE;YAC5B,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QAExB,MAAM,KAAK,GAA6B,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,iFAAiF;QACjF,IAAI,YAA4B,CAAC;QACjC,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;YAC/B,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC9F,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;gBACvD,QAAQ,EAAE,GAAG,CAAC,kBAAmB;gBACjC,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAED,yBAAyB;QACzB,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CACtB;;;;;;qBAMe,EACf,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CACpF,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,UAAU;YAClB,YAAY;YACZ,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,WAAW;YACxB,gBAAgB,EAAE,CAAC,CAAC,GAAG,CAAC,sBAAsB,EAAE,sCAAsC;SACvF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAC3B,GAAW,EACX,OAAiB;QAEjB,MAAM,YAAY,GAAG,GAAG,CAAC,IAAgB,CAAC;QAE1C,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,oCAAoC;YACpC,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;gBAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CACtB;;qBAEe,EACf,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAClC,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,qBAAqB;YAC7B,YAAY;YACZ,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,eAAe;SAC7B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,KAAa;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,WAAW,GAAI,GAAG,CAAC,QAAgB,EAAE,iBAAyC,CAAC;QACrF,IAAI,CAAC,WAAW;YAAE,OAAO;QAEzB,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QAE5C,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CACtB;;;uBAGe,EACf,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAChC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,yDAAyD;YACzD,MAAM,KAAK,GAA6B,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzE,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;gBAC7D,QAAQ,EAAE,GAAG,CAAC,kBAAmB;gBACjC,KAAK;aACN,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CACtB;;;uBAGe,EACf,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,KAAa;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CACrC,+FAA+F,EAC/F,CAAC,KAAK,CAAC,CACR,CAAC;QACF,MAAM,GAAG,GAAI,MAAM,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC;QACpD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}