@agentlensai/server 0.10.0 → 0.11.0

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":"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"}

package/dist/cloud/billing/quota-enforcement.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Quota Enforcement (S-6.3)
+ *
+ * Checks usage against tier limits on every ingestion request.
+ * - Free tier: hard block at 10K events/month (402)
+ * - Pro/Team: allow overage up to cap (default 2x)
+ * - 80% soft warning
+ * - Grace period for paid tiers
+ */
+import type { TierName } from './stripe-client.js';
+import type { RedisUsageStore } from './usage-metering.js';
+import type { MigrationClient } from '../migrate.js';
+export interface QuotaCheckResult {
+    allowed: boolean;
+    status: 'ok' | 'warning' | 'overage' | 'blocked';
+    usage: number;
+    quota: number;
+    usage_pct: number;
+    message?: string;
+    upgrade_url?: string;
+}
+export interface QuotaEnforcerDeps {
+    db: MigrationClient;
+    redis?: RedisUsageStore;
+}
+export interface OrgQuotaInfo {
+    plan: TierName;
+    event_quota: number;
+    overage_cap_multiplier: number;
+}
+export declare class QuotaEnforcer {
+    private deps;
+    private orgCache;
+    private cacheTtlMs;
+    constructor(deps: QuotaEnforcerDeps, config?: {
+        cacheTtlMs?: number;
+    });
+    /**
+     * Check if an org can ingest events.
+     * Designed to be < 5ms via Redis lookup.
+     */
+    checkQuota(orgId: string): Promise<QuotaCheckResult>;
+    /**
+     * Check if an org should see a warning notification.
+     * Returns the warning level or null.
+     */
+    getWarningLevel(orgId: string): Promise<'80pct' | '100pct' | null>;
+    private getOrgInfo;
+    private getCurrentUsage;
+    /** Clear cache (for testing) */
+    clearCache(): void;
+}
+//# sourceMappingURL=quota-enforcement.d.ts.map

package/dist/cloud/billing/quota-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-enforcement.d.ts","sourceRoot":"","sources":["../../../src/cloud/billing/quota-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAMrD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,eAAe,CAAC;IACpB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAMD,qBAAa,aAAa;IAKtB,OAAO,CAAC,IAAI;IAJd,OAAO,CAAC,QAAQ,CAA8D;IAC9E,OAAO,CAAC,UAAU,CAAS;gBAGjB,IAAI,EAAE,iBAAiB,EAC/B,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAKlC;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+D1D;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;YAa1D,UAAU;YAsBV,eAAe;IA4B7B,gCAAgC;IAChC,UAAU,IAAI,IAAI;CAGnB"}

package/dist/cloud/billing/quota-enforcement.js

@@ -0,0 +1,143 @@
+/**
+ * Quota Enforcement (S-6.3)
+ *
+ * Checks usage against tier limits on every ingestion request.
+ * - Free tier: hard block at 10K events/month (402)
+ * - Pro/Team: allow overage up to cap (default 2x)
+ * - 80% soft warning
+ * - Grace period for paid tiers
+ */
+import { TIER_CONFIG } from './stripe-client.js';
+// ═══════════════════════════════════════════
+// Quota Enforcer
+// ═══════════════════════════════════════════
+export class QuotaEnforcer {
+    deps;
+    orgCache = new Map();
+    cacheTtlMs;
+    constructor(deps, config) {
+        this.deps = deps;
+        this.cacheTtlMs = config?.cacheTtlMs ?? 60_000; // 1 min
+    }
+    /**
+     * Check if an org can ingest events.
+     * Designed to be < 5ms via Redis lookup.
+     */
+    async checkQuota(orgId) {
+        const orgInfo = await this.getOrgInfo(orgId);
+        const usage = await this.getCurrentUsage(orgId);
+        const quota = orgInfo.event_quota;
+        const usagePct = quota > 0 ? (usage / quota) * 100 : 0;
+        // Under 80% — all good
+        if (usagePct < 80) {
+            return { allowed: true, status: 'ok', usage, quota, usage_pct: round2(usagePct) };
+        }
+        // 80-100% — soft warning
+        if (usage < quota) {
+            return {
+                allowed: true,
+                status: 'warning',
+                usage,
+                quota,
+                usage_pct: round2(usagePct),
+                message: `You've used ${Math.round(usagePct)}% of your monthly event quota.`,
+            };
+        }
+        // At or over quota
+        const plan = orgInfo.plan;
+        // Free tier: hard block
+        if (plan === 'free') {
+            return {
+                allowed: false,
+                status: 'blocked',
+                usage,
+                quota,
+                usage_pct: round2(usagePct),
+                message: 'Monthly event quota exceeded. Upgrade to continue ingesting events.',
+                upgrade_url: '/billing/upgrade',
+            };
+        }
+        // Paid tiers: check overage cap
+        const overageCap = quota * orgInfo.overage_cap_multiplier;
+        if (usage >= overageCap) {
+            return {
+                allowed: false,
+                status: 'blocked',
+                usage,
+                quota,
+                usage_pct: round2(usagePct),
+                message: `Overage cap reached (${orgInfo.overage_cap_multiplier}x quota). Contact support to increase.`,
+            };
+        }
+        // Paid tier, within overage cap — allow with overage billing
+        return {
+            allowed: true,
+            status: 'overage',
+            usage,
+            quota,
+            usage_pct: round2(usagePct),
+            message: `You're now incurring overage charges at ${TIER_CONFIG[plan]?.overage_rate_per_1k_cents ?? 0}¢ per 1K events.`,
+        };
+    }
+    /**
+     * Check if an org should see a warning notification.
+     * Returns the warning level or null.
+     */
+    async getWarningLevel(orgId) {
+        const orgInfo = await this.getOrgInfo(orgId);
+        const usage = await this.getCurrentUsage(orgId);
+        const quota = orgInfo.event_quota;
+        const pct = quota > 0 ? (usage / quota) * 100 : 0;
+        if (pct >= 100)
+            return '100pct';
+        if (pct >= 80)
+            return '80pct';
+        return null;
+    }
+    // ── Internals ──
+    async getOrgInfo(orgId) {
+        // Check cache
+        const cached = this.orgCache.get(orgId);
+        if (cached && cached.expires > Date.now()) {
+            return cached.info;
+        }
+        const result = await this.deps.db.query(`SELECT plan, event_quota, overage_cap_multiplier FROM orgs WHERE id = $1`, [orgId]);
+        const row = result.rows[0];
+        const info = {
+            plan: (row?.plan ?? 'free'),
+            event_quota: row?.event_quota ?? TIER_CONFIG.free.event_quota,
+            overage_cap_multiplier: row?.overage_cap_multiplier ?? 2.0,
+        };
+        this.orgCache.set(orgId, { info, expires: Date.now() + this.cacheTtlMs });
+        return info;
+    }
+    async getCurrentUsage(orgId) {
+        // Try Redis first (fast path, < 1ms)
+        if (this.deps.redis) {
+            const now = new Date();
+            const month = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, '0')}`;
+            const redisKey = `usage:${orgId}:${month}`;
+            const val = await this.deps.redis.get(redisKey);
+            if (val !== null) {
+                return parseInt(val, 10);
+            }
+        }
+        // Fallback to DB
+        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 result = 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()]);
+        return result.rows[0]?.total ?? 0;
+    }
+    /** Clear cache (for testing) */
+    clearCache() {
+        this.orgCache.clear();
+    }
+}
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=quota-enforcement.js.map

package/dist/cloud/billing/quota-enforcement.js.map

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