@carrierllc/mcp 0.0.1 → 0.2.0

package/dist/billing-thresholds.js

@@ -0,0 +1,238 @@
+/**
+ * Carrier MCP — Billing Thresholds (Hex Pattern)
+ *
+ * Prevents bill shock by:
+ *   1. Triggering invoices at predefined spend levels
+ *   2. Sending notifications at configurable usage percentages
+ *   3. Hard-stopping overages at a user-defined maximum
+ *
+ * Integrates with Stripe:
+ *   - Uses Stripe Billing Thresholds on subscriptions
+ *   - Creates threshold-triggered invoices for overage accumulation
+ *   - Sends webhook events for notification dispatch
+ *
+ * Reference: Hex case study — "Mitigating the risk of bill shock"
+ *   - Invoices trigger automatically at predefined amounts
+ *   - Acts as spend alerts, preventing unexpected charges
+ */
+// ---------------------------------------------------------------------------
+// Default Configs
+// ---------------------------------------------------------------------------
+const DEFAULT_THRESHOLD_CONFIGS = {
+    free: {
+        notification_thresholds: [80, 95, 100],
+        hard_cap_cents: 0, // Free tier has no overages
+        invoice_threshold_cents: 0,
+        auto_pause_on_cap: true,
+        notification_email: null,
+        webhook_url: null,
+    },
+    pro: {
+        notification_thresholds: [50, 75, 90, 100],
+        hard_cap_cents: 50_000, // $500 hard cap default
+        invoice_threshold_cents: 10_000, // Invoice every $100
+        auto_pause_on_cap: false,
+        notification_email: null,
+        webhook_url: null,
+    },
+    enterprise: {
+        notification_thresholds: [75, 90],
+        hard_cap_cents: 0, // No cap for enterprise
+        invoice_threshold_cents: 100_000, // Invoice every $1,000
+        auto_pause_on_cap: false,
+        notification_email: null,
+        webhook_url: null,
+    },
+};
+// ---------------------------------------------------------------------------
+// Core Functions
+// ---------------------------------------------------------------------------
+/**
+ * Check billing thresholds before allowing overage consumption.
+ * Returns whether overage is still allowed and any triggered events.
+ */
+export async function checkBillingThresholds(env, sub, tier, currentSpendCents, additionalSpendCents) {
+    const config = await getThresholdConfig(env, sub, tier);
+    const events = [];
+    const projectedSpend = currentSpendCents + additionalSpendCents;
+    // Check hard cap
+    if (config.hard_cap_cents > 0 && projectedSpend >= config.hard_cap_cents) {
+        events.push({
+            type: "hard_cap_reached",
+            sub,
+            tier,
+            current_spend_cents: projectedSpend,
+            threshold_cents: config.hard_cap_cents,
+            pct_of_limit: 100,
+            timestamp: new Date().toISOString(),
+        });
+        if (config.auto_pause_on_cap) {
+            events.push({
+                type: "overage_paused",
+                sub,
+                tier,
+                current_spend_cents: projectedSpend,
+                threshold_cents: config.hard_cap_cents,
+                pct_of_limit: 100,
+                timestamp: new Date().toISOString(),
+            });
+            return {
+                overage_allowed: false,
+                events,
+                spend_pct: 100,
+                remaining_cents: 0,
+            };
+        }
+    }
+    // Check invoice threshold
+    if (config.invoice_threshold_cents > 0) {
+        const prevInvoiceCount = Math.floor(currentSpendCents / config.invoice_threshold_cents);
+        const newInvoiceCount = Math.floor(projectedSpend / config.invoice_threshold_cents);
+        if (newInvoiceCount > prevInvoiceCount) {
+            events.push({
+                type: "invoice_triggered",
+                sub,
+                tier,
+                current_spend_cents: projectedSpend,
+                threshold_cents: config.invoice_threshold_cents * newInvoiceCount,
+                pct_of_limit: config.hard_cap_cents > 0
+                    ? Math.round((projectedSpend / config.hard_cap_cents) * 100)
+                    : 0,
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    // Check notification thresholds
+    if (config.hard_cap_cents > 0) {
+        for (const pct of config.notification_thresholds) {
+            const thresholdAmount = Math.round((pct / 100) * config.hard_cap_cents);
+            if (currentSpendCents < thresholdAmount && projectedSpend >= thresholdAmount) {
+                events.push({
+                    type: "notification",
+                    sub,
+                    tier,
+                    current_spend_cents: projectedSpend,
+                    threshold_cents: thresholdAmount,
+                    pct_of_limit: pct,
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        }
+    }
+    // Dispatch events (fire-and-forget)
+    if (events.length > 0) {
+        void dispatchThresholdEvents(env, sub, events, config);
+    }
+    const spendPct = config.hard_cap_cents > 0
+        ? Math.round((projectedSpend / config.hard_cap_cents) * 100)
+        : 0;
+    const remaining = config.hard_cap_cents > 0
+        ? Math.max(0, config.hard_cap_cents - projectedSpend)
+        : Infinity;
+    return {
+        overage_allowed: true,
+        events,
+        spend_pct: spendPct,
+        remaining_cents: remaining,
+    };
+}
+/**
+ * Get threshold config for a user, with fallback to tier defaults.
+ */
+export async function getThresholdConfig(env, sub, tier) {
+    const key = `threshold:config:${sub}`;
+    const raw = await env.CARRIER_USERS.get(key, "json").catch(() => null);
+    if (raw && typeof raw === "object" && "notification_thresholds" in raw) {
+        return raw;
+    }
+    return DEFAULT_THRESHOLD_CONFIGS[tier];
+}
+/**
+ * Update threshold config for a user.
+ */
+export async function updateThresholdConfig(env, sub, updates) {
+    const tier = await resolveUserTier(env, sub);
+    const current = await getThresholdConfig(env, sub, tier);
+    const updated = { ...current, ...updates };
+    const key = `threshold:config:${sub}`;
+    await env.CARRIER_USERS.put(key, JSON.stringify(updated));
+    return updated;
+}
+/**
+ * Set up Stripe subscription billing thresholds.
+ * Called when a user upgrades to Pro or changes their threshold config.
+ */
+export async function syncStripeThresholds(env, sub, config) {
+    const stripeKey = env.STRIPE_SECRET_KEY;
+    if (!stripeKey)
+        return false;
+    const subscriptionId = await env.CARRIER_USERS.get(`stripe_subscription_id:${sub}`);
+    if (!subscriptionId)
+        return false;
+    // Update Stripe subscription with billing thresholds
+    const body = new URLSearchParams();
+    if (config.invoice_threshold_cents > 0) {
+        body.set("billing_thresholds[amount_gte]", String(config.invoice_threshold_cents));
+    }
+    const resp = await fetch(`https://api.stripe.com/v1/subscriptions/${subscriptionId}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${stripeKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: body.toString(),
+    });
+    return resp.ok;
+}
+// ---------------------------------------------------------------------------
+// Event Dispatch
+// ---------------------------------------------------------------------------
+/**
+ * Dispatch threshold events to configured notification channels.
+ */
+async function dispatchThresholdEvents(env, sub, events, config) {
+    // Store events in KV for UI display
+    const eventsKey = `threshold:events:${sub}`;
+    const existingRaw = await env.CARRIER_USERS.get(eventsKey, "json").catch(() => null);
+    const existing = Array.isArray(existingRaw) ? existingRaw : [];
+    const allEvents = [...existing, ...events].slice(-50); // Keep last 50 events
+    await env.CARRIER_USERS.put(eventsKey, JSON.stringify(allEvents), {
+        expirationTtl: 35 * 24 * 60 * 60,
+    });
+    // Webhook dispatch
+    if (config.webhook_url) {
+        await fetch(config.webhook_url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ events }),
+        }).catch(() => { });
+    }
+    // Audit log (Analytics Engine)
+    for (const event of events) {
+        const ae = env.AUDIT_LOG;
+        if (ae) {
+            ae.writeDataPoint({
+                blobs: [
+                    `threshold_${event.type}`,
+                    sub,
+                    event.tier,
+                ],
+                doubles: [event.current_spend_cents, event.threshold_cents],
+                indexes: [sub],
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function resolveUserTier(env, sub) {
+    const raw = await env.CARRIER_USERS.get(`user:${sub}`, "json").catch(() => null);
+    if (raw && typeof raw === "object" && "tier" in raw) {
+        const t = raw.tier;
+        if (t === "pro" || t === "enterprise")
+            return t;
+    }
+    return "free";
+}
+//# sourceMappingURL=billing-thresholds.js.map

package/dist/billing-thresholds.js.map

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

package/dist/billing.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Carrier MCP — Billing v2.0 (Phase 15 — Clerk Billing GA Migration)
+ *
+ * Tier model:
+ *   free       — 5,000 tool calls/mo, read scope only, no Stripe product
+ *   pro        — 50,000 tool calls/mo, read+write+intelligence, $49/mo
+ *   enterprise — unlimited tool calls, read+write+admin, $499/mo, custom rate limits, SSO
+ *
+ * Storage layout (CARRIER_USERS KV):
+ *   key: user:<sub>        value: UserRecord (tier field drives all gate checks)
+ *   key: usage:<sub>:<yyyymm>  value: JSON { calls: number }  (TTL: 35 days)
+ *
+ * Analytics Engine (carrier_mcp_audit dataset) is the source of truth for usage
+ * rollups — KV counter is a fast hot path for quota checks.
+ *
+ * BILLING_PRIMARY feature flag (Doppler carrier/prd):
+ *   "clerk"  → Clerk Billing is authoritative; KV is a cache/fallback.
+ *              Portal redirects to Clerk-hosted billing page.
+ *              Stripe webhook still runs (dual-write period; kept for 1 billing cycle).
+ *   "stripe" → (default) Direct Stripe path; Clerk plan claim is a session-layer overlay.
+ *
+ * IMPORTANT: This module NEVER charges a card. It only:
+ *   1. Gates tool calls based on tier + call count.
+ *   2. Records usage records to Stripe Metered Billing (for Pro overages, Stripe-primary only).
+ *   3. Redirects users to the appropriate Billing Portal (Clerk or Stripe).
+ */
+import type { Env } from "./types.js";
+export declare const TIER_CALL_LIMITS: Record<Tier, number>;
+export declare const UPGRADE_URL = "https://mcp.carrier.llc/upgrade";
+export type Tier = "free" | "pro" | "enterprise";
+export type ScopeToken = "read" | "write" | "admin";
+export declare const TIER_SCOPES: Record<Tier, ScopeToken[]>;
+/**
+ * "clerk"  → Clerk Billing is the authoritative source.
+ * "stripe" → (default) Direct Stripe path; Clerk plan claim is a session overlay only.
+ *
+ * Cutover recommendation: flip to "clerk" after one full billing cycle of
+ * dual-write validation confirming KV ↔ Clerk plan parity for all active subscribers.
+ */
+export type BillingPrimary = "clerk" | "stripe";
+export declare function getBillingPrimary(env: Env): BillingPrimary;
+/**
+ * Read the tier stored in the user's KV record.
+ * Falls back to "free" if the record is missing or malformed.
+ * When BILLING_PRIMARY=clerk this becomes a cache/fallback only.
+ */
+export declare function getUserTier(env: Env, sub: string): Promise<Tier>;
+/**
+ * Phase 15 — Resolve the effective tier.
+ *
+ * BILLING_PRIMARY=clerk: Clerk session plan claim is primary; KV is the fallback.
+ * BILLING_PRIMARY=stripe (default): KV is canonical; Clerk plan is an overlay
+ *   (used to catch Clerk-driven downgrades like plan cancellations).
+ *
+ * In both modes: clerkPlan ?? fallbackTier — the function is the same; the
+ * caller decides which value to pass as fallbackTier based on BILLING_PRIMARY.
+ */
+export declare function resolveTierFromClerk(clerkPlan: Tier | undefined, fallbackTier: Tier): Tier;
+/**
+ * Phase 15 — Build the Clerk-hosted billing portal URL.
+ * Activated as primary when BILLING_PRIMARY=clerk.
+ */
+export declare function buildClerkBillingPortalUrl(env: Env, returnUrl: string): string;
+/**
+ * Phase 15 — Resolve the billing portal URL based on BILLING_PRIMARY.
+ * This is the single entry point for all portal redirects (oauth/index.ts,
+ * console billing routes, etc.).
+ *
+ * BILLING_PRIMARY=clerk  → Clerk-hosted portal (buildClerkBillingPortalUrl)
+ * BILLING_PRIMARY=stripe → Stripe portal (createBillingPortalSession) with
+ *                          Clerk portal as fallback when Stripe is unconfigured
+ */
+export declare function resolveBillingPortalUrl(env: Env, sub: string, returnUrl: string): Promise<string | null>;
+export declare function getScopeForTier(tier: Tier): ScopeToken[];
+export interface QuotaResult {
+    allowed: boolean;
+    remaining: number;
+    resetAt: string;
+    tier: Tier;
+}
+/**
+ * Returns current-month usage from KV hot counter.
+ * Enterprise users always get allowed=true / remaining=Infinity.
+ */
+export declare function checkCallQuota(env: Env, sub: string, tier: Tier): Promise<QuotaResult>;
+export declare function recordUsage(env: Env, sub: string, tier: Tier): void;
+/**
+ * Create a Stripe Billing Portal session URL for the given customer.
+ * Used by /oauth/billing route when BILLING_PRIMARY=stripe.
+ * Kept during the dual-write period; will be removed after Clerk-primary cutover.
+ *
+ * Returns null if Stripe is not configured or the user has no Stripe customer record.
+ */
+export declare function createBillingPortalSession(env: Env, sub: string, returnUrl: string): Promise<string | null>;
+//# sourceMappingURL=billing.d.ts.map

package/dist/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAMtC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIjD,CAAC;AAEF,eAAO,MAAM,WAAW,oCAAoC,CAAC;AAE7D,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;AACjD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAIpD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,CAIlD,CAAC;AAMF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAG1D;AAMD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAatE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,IAAI,GAAG,SAAS,EAC3B,YAAY,EAAE,IAAI,GACjB,IAAI,CAEN;AAMD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9E;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,EAAE,CAExD;AAMD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,WAAW,CAAC,CAuBtB;AAMD,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CA2BnE;AAyCD;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4BxB"}

package/dist/billing.js

@@ -0,0 +1,239 @@
+/**
+ * Carrier MCP — Billing v2.0 (Phase 15 — Clerk Billing GA Migration)
+ *
+ * Tier model:
+ *   free       — 5,000 tool calls/mo, read scope only, no Stripe product
+ *   pro        — 50,000 tool calls/mo, read+write+intelligence, $49/mo
+ *   enterprise — unlimited tool calls, read+write+admin, $499/mo, custom rate limits, SSO
+ *
+ * Storage layout (CARRIER_USERS KV):
+ *   key: user:<sub>        value: UserRecord (tier field drives all gate checks)
+ *   key: usage:<sub>:<yyyymm>  value: JSON { calls: number }  (TTL: 35 days)
+ *
+ * Analytics Engine (carrier_mcp_audit dataset) is the source of truth for usage
+ * rollups — KV counter is a fast hot path for quota checks.
+ *
+ * BILLING_PRIMARY feature flag (Doppler carrier/prd):
+ *   "clerk"  → Clerk Billing is authoritative; KV is a cache/fallback.
+ *              Portal redirects to Clerk-hosted billing page.
+ *              Stripe webhook still runs (dual-write period; kept for 1 billing cycle).
+ *   "stripe" → (default) Direct Stripe path; Clerk plan claim is a session-layer overlay.
+ *
+ * IMPORTANT: This module NEVER charges a card. It only:
+ *   1. Gates tool calls based on tier + call count.
+ *   2. Records usage records to Stripe Metered Billing (for Pro overages, Stripe-primary only).
+ *   3. Redirects users to the appropriate Billing Portal (Clerk or Stripe).
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const TIER_CALL_LIMITS = {
+    free: 5_000,
+    pro: 50_000,
+    enterprise: Infinity,
+};
+export const UPGRADE_URL = "https://mcp.carrier.llc/upgrade";
+// Intelligence scope is a virtual scope — Pro users can call intelligence tools
+// because those tools are registered under "read" or "write" scope internally.
+export const TIER_SCOPES = {
+    free: ["read"],
+    pro: ["read", "write"],
+    enterprise: ["read", "write", "admin"],
+};
+export function getBillingPrimary(env) {
+    const raw = env.BILLING_PRIMARY;
+    return raw === "clerk" ? "clerk" : "stripe";
+}
+// ---------------------------------------------------------------------------
+// getUserTier
+// ---------------------------------------------------------------------------
+/**
+ * Read the tier stored in the user's KV record.
+ * Falls back to "free" if the record is missing or malformed.
+ * When BILLING_PRIMARY=clerk this becomes a cache/fallback only.
+ */
+export async function getUserTier(env, sub) {
+    const raw = await env.CARRIER_USERS.get(`user:${sub}`, "json").catch(() => null);
+    if (raw &&
+        typeof raw === "object" &&
+        "tier" in raw &&
+        raw.tier in TIER_CALL_LIMITS) {
+        return raw.tier;
+    }
+    return "free";
+}
+/**
+ * Phase 15 — Resolve the effective tier.
+ *
+ * BILLING_PRIMARY=clerk: Clerk session plan claim is primary; KV is the fallback.
+ * BILLING_PRIMARY=stripe (default): KV is canonical; Clerk plan is an overlay
+ *   (used to catch Clerk-driven downgrades like plan cancellations).
+ *
+ * In both modes: clerkPlan ?? fallbackTier — the function is the same; the
+ * caller decides which value to pass as fallbackTier based on BILLING_PRIMARY.
+ */
+export function resolveTierFromClerk(clerkPlan, fallbackTier) {
+    return clerkPlan ?? fallbackTier;
+}
+// ---------------------------------------------------------------------------
+// Portal URL resolution
+// ---------------------------------------------------------------------------
+/**
+ * Phase 15 — Build the Clerk-hosted billing portal URL.
+ * Activated as primary when BILLING_PRIMARY=clerk.
+ */
+export function buildClerkBillingPortalUrl(env, returnUrl) {
+    const base = env.CLERK_BILLING_PORTAL_URL ?? "https://accounts.carrier.llc/user/billing";
+    const url = new URL(base);
+    url.searchParams.set("redirect_url", returnUrl);
+    return url.toString();
+}
+/**
+ * Phase 15 — Resolve the billing portal URL based on BILLING_PRIMARY.
+ * This is the single entry point for all portal redirects (oauth/index.ts,
+ * console billing routes, etc.).
+ *
+ * BILLING_PRIMARY=clerk  → Clerk-hosted portal (buildClerkBillingPortalUrl)
+ * BILLING_PRIMARY=stripe → Stripe portal (createBillingPortalSession) with
+ *                          Clerk portal as fallback when Stripe is unconfigured
+ */
+export async function resolveBillingPortalUrl(env, sub, returnUrl) {
+    const primary = getBillingPrimary(env);
+    if (primary === "clerk") {
+        return buildClerkBillingPortalUrl(env, returnUrl);
+    }
+    // BILLING_PRIMARY=stripe — try Stripe first, fall back to Clerk portal
+    const stripePortalUrl = await createBillingPortalSession(env, sub, returnUrl);
+    if (stripePortalUrl)
+        return stripePortalUrl;
+    return buildClerkBillingPortalUrl(env, returnUrl);
+}
+// ---------------------------------------------------------------------------
+// getScopeForTier
+// ---------------------------------------------------------------------------
+export function getScopeForTier(tier) {
+    return TIER_SCOPES[tier];
+}
+/**
+ * Returns current-month usage from KV hot counter.
+ * Enterprise users always get allowed=true / remaining=Infinity.
+ */
+export async function checkCallQuota(env, sub, tier) {
+    const limit = TIER_CALL_LIMITS[tier];
+    const resetAt = firstDayNextMonth();
+    if (tier === "enterprise") {
+        return { allowed: true, remaining: Infinity, resetAt, tier };
+    }
+    const month = currentMonth();
+    const usageKey = `usage:${sub}:${month}`;
+    const raw = await env.CARRIER_USERS.get(usageKey, "json").catch(() => null);
+    const calls = raw && typeof raw === "object" && "calls" in raw
+        ? Number(raw.calls)
+        : 0;
+    const remaining = Math.max(0, limit - calls);
+    return {
+        allowed: calls < limit,
+        remaining,
+        resetAt,
+        tier,
+    };
+}
+// ---------------------------------------------------------------------------
+// recordUsage
+// ---------------------------------------------------------------------------
+export function recordUsage(env, sub, tier) {
+    (async () => {
+        const month = currentMonth();
+        const usageKey = `usage:${sub}:${month}`;
+        const raw = await env.CARRIER_USERS.get(usageKey, "json").catch(() => null);
+        const prev = raw && typeof raw === "object" && "calls" in raw
+            ? Number(raw.calls)
+            : 0;
+        const next = prev + 1;
+        await env.CARRIER_USERS.put(usageKey, JSON.stringify({ calls: next, updated_at: new Date().toISOString() }), { expirationTtl: 35 * 24 * 60 * 60 });
+        // Push Stripe usage record only when Stripe is the primary billing source.
+        // When BILLING_PRIMARY=clerk, Clerk Billing handles metering natively.
+        if (tier === "pro" && next % 100 === 0 && getBillingPrimary(env) === "stripe") {
+            await pushStripeUsageRecord(env, sub, 100).catch(() => {
+                // Non-fatal — nightly rollup will reconcile.
+            });
+        }
+    })();
+}
+// ---------------------------------------------------------------------------
+// pushStripeUsageRecord (internal — Stripe-primary mode only)
+// ---------------------------------------------------------------------------
+async function pushStripeUsageRecord(env, sub, quantity) {
+    const stripeKey = env
+        .STRIPE_SECRET_KEY;
+    if (!stripeKey)
+        return;
+    const subItemId = await env.CARRIER_USERS.get(`stripe_sub_item_id:${sub}`);
+    if (!subItemId)
+        return;
+    const body = new URLSearchParams({
+        quantity: String(quantity),
+        timestamp: String(Math.floor(Date.now() / 1000)),
+        action: "increment",
+    });
+    await fetch(`https://api.stripe.com/v1/subscription_items/${subItemId}/usage_records`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${stripeKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: body.toString(),
+    });
+}
+// ---------------------------------------------------------------------------
+// createBillingPortalSession (Stripe — kept for dual-write period)
+// ---------------------------------------------------------------------------
+/**
+ * Create a Stripe Billing Portal session URL for the given customer.
+ * Used by /oauth/billing route when BILLING_PRIMARY=stripe.
+ * Kept during the dual-write period; will be removed after Clerk-primary cutover.
+ *
+ * Returns null if Stripe is not configured or the user has no Stripe customer record.
+ */
+export async function createBillingPortalSession(env, sub, returnUrl) {
+    const stripeKey = env
+        .STRIPE_SECRET_KEY;
+    if (!stripeKey)
+        return null;
+    const customerId = await env.CARRIER_USERS.get(`stripe_customer_id:${sub}`);
+    if (!customerId)
+        return null;
+    const body = new URLSearchParams({
+        customer: customerId,
+        return_url: returnUrl,
+    });
+    const resp = await fetch("https://api.stripe.com/v1/billing_portal/sessions", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${stripeKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: body.toString(),
+    });
+    if (!resp.ok)
+        return null;
+    const data = (await resp.json());
+    return data.url ?? null;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function currentMonth() {
+    const now = new Date();
+    return `${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}`;
+}
+function firstDayNextMonth() {
+    const now = new Date();
+    const y = now.getUTCFullYear();
+    const m = now.getUTCMonth() + 1;
+    if (m === 12) {
+        return new Date(Date.UTC(y + 1, 0, 1)).toISOString();
+    }
+    return new Date(Date.UTC(y, m, 1)).toISOString();
+}
+//# sourceMappingURL=billing.js.map

package/dist/billing.js.map

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