@carrierllc/mcp 0.2.1 → 0.2.3

package/dist/client.js.map

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

package/dist/credits.d.ts

@@ -1,165 +0,0 @@
-/**
- * Carrier MCP — Credits System v2.0 (Pricing Evolution)
- *
- * Implements credit-based billing inspired by Stripe's Pricing Model Evolution Guide:
- *   - Monthly credit allotments per tier (Lovable pattern)
- *   - Auto-billed overages when base credits exhausted (Warp pattern)
- *   - Credit rollovers for irregular usage (Lovable pattern)
- *   - Daily free credits for acquisition (Browserbase/Lovable pattern)
- *   - Billing thresholds to prevent bill shock (Hex pattern)
- *   - Volume discounts for high-usage customers
- *
- * Storage layout (CARRIER_USERS KV):
- *   key: credits:<sub>:<yyyymm>     value: CreditLedger
- *   key: credits:daily:<sub>:<yyyymmdd>  value: DailyFreeCredits
- *   key: credits:config:<sub>       value: CreditConfig (overrides, thresholds)
- *   key: credits:rollover:<sub>     value: RolloverBalance
- *
- * Credit economy:
- *   1 tool call = 1 credit (read scope)
- *   1 tool call = 2 credits (write scope)
- *   1 tool call = 5 credits (admin scope)
- *   Intelligence composites = 3 credits each
- *
- * Stripe integration:
- *   - Overages reported via Stripe Metered Billing (usage_records API)
- *   - Billing thresholds trigger Stripe invoice finalization
- *   - Credit grants created via Stripe Customer Balance Transactions
- */
-import type { Env } from "./types.js";
-import type { Tier, ScopeToken } from "./billing.js";
-/** Monthly credit allotments per tier */
-export declare const TIER_CREDIT_ALLOTMENTS: Record<Tier, number>;
-/** Daily free credits for all users (acquisition driver) */
-export declare const DAILY_FREE_CREDITS = 50;
-/** Maximum rollover credits (cap at 2x monthly allotment) */
-export declare const ROLLOVER_CAP_MULTIPLIER = 2;
-/** Credit cost per scope */
-export declare const SCOPE_CREDIT_COSTS: Record<ScopeToken | "intelligence", number>;
-/** Volume discount tiers (cumulative monthly usage) */
-export declare const VOLUME_DISCOUNTS: VolumeDiscountTier[];
-/** Default billing threshold (in cents) — triggers invoice at this spend level */
-export declare const DEFAULT_BILLING_THRESHOLD_CENTS = 10000;
-/** Overage price per credit (in cents) — Pro tier */
-export declare const OVERAGE_PRICE_PER_CREDIT_CENTS = 0.1;
-export interface VolumeDiscountTier {
-    threshold: number;
-    discountPct: number;
-}
-export interface CreditLedger {
-    /** Monthly allotment (base + rollover) */
-    allotment: number;
-    /** Credits consumed this period */
-    consumed: number;
-    /** Credits from rollovers applied this month */
-    rollover_applied: number;
-    /** Overage credits consumed beyond allotment */
-    overage: number;
-    /** Overage amount billed (cents) */
-    overage_billed_cents: number;
-    /** Whether billing threshold was hit this period */
-    threshold_triggered: boolean;
-    /** ISO 8601 last updated */
-    updated_at: string;
-}
-export interface DailyFreeCredits {
-    /** Credits granted today */
-    granted: number;
-    /** Credits consumed from daily free pool */
-    consumed: number;
-    /** ISO date (YYYY-MM-DD) */
-    date: string;
-}
-export interface CreditConfig {
-    /** Custom billing threshold override (cents) */
-    billing_threshold_cents: number;
-    /** Whether overages are enabled (Pro+) */
-    overages_enabled: boolean;
-    /** Whether rollovers are enabled (Pro+) */
-    rollovers_enabled: boolean;
-    /** Custom overage rate override (cents per credit) */
-    overage_rate_cents: number;
-    /** Volume discount tier override */
-    volume_discount_pct: number;
-    /** Notification preferences */
-    notify_at_pct: number[];
-    updated_at: string;
-}
-export interface RolloverBalance {
-    /** Unused credits from previous month eligible for rollover */
-    credits: number;
-    /** Source month (YYYYMM) */
-    source_month: string;
-    /** Expiry — rollovers expire after 1 month */
-    expires_at: string;
-}
-export interface CreditCheckResult {
-    allowed: boolean;
-    credits_remaining: number;
-    daily_free_remaining: number;
-    overage_active: boolean;
-    overage_amount_cents: number;
-    threshold_pct: number;
-    tier: Tier;
-    volume_discount_pct: number;
-    reset_at: string;
-}
-export interface CreditDeductionResult {
-    success: boolean;
-    credits_deducted: number;
-    source: "allotment" | "daily_free" | "overage";
-    new_balance: number;
-    overage_triggered: boolean;
-    threshold_triggered: boolean;
-}
-/**
- * Check if a user has sufficient credits for a tool call.
- * Order of credit consumption:
- *   1. Daily free credits (if available)
- *   2. Monthly allotment (base + rollover)
- *   3. Overage (if enabled for tier)
- */
-export declare function checkCredits(env: Env, sub: string, tier: Tier, scope: ScopeToken | "intelligence"): Promise<CreditCheckResult>;
-/**
- * Deduct credits for a tool call. Fire-and-forget in the hot path.
- *
- * Consumption order:
- *   1. Daily free credits first (lowest cost to user)
- *   2. Monthly allotment
- *   3. Overage (auto-billed, Pro+ only)
- */
-export declare function deductCredits(env: Env, sub: string, tier: Tier, scope: ScopeToken | "intelligence"): void;
-/**
- * Calculate and apply rollover credits from previous month.
- * Called by the monthly cron job (scheduled handler).
- *
- * Rules:
- *   - Only Pro+ tiers get rollovers
- *   - Rollover = min(unused credits, allotment * ROLLOVER_CAP_MULTIPLIER)
- *   - Rollovers expire after 1 month (use-it-or-lose-it next cycle)
- */
-export declare function applyMonthlyRollover(env: Env, sub: string, tier: Tier): Promise<RolloverBalance | null>;
-/**
- * Resolve the applicable volume discount percentage based on cumulative usage.
- */
-export declare function resolveVolumeDiscount(consumed: number): number;
-/**
- * Update a user's credit configuration (admin or self-service).
- */
-export declare function updateCreditConfig(env: Env, sub: string, updates: Partial<CreditConfig>): Promise<CreditConfig>;
-/**
- * Get credit usage summary for a user (used by billing UI).
- */
-export declare function getCreditSummary(env: Env, sub: string, tier: Tier): Promise<{
-    ledger: CreditLedger;
-    daily_free: DailyFreeCredits;
-    config: CreditConfig;
-    rollover: RolloverBalance | null;
-    volume_discount_pct: number;
-}>;
-/**
- * Issue a credit grant to a customer via Stripe Customer Balance Transactions.
- * Used for promotional credits, referral bonuses, and compensation.
- */
-export declare function issueStripeCredits(env: Env, sub: string, amountCents: number, description: string): Promise<boolean>;
-//# sourceMappingURL=credits.d.ts.map

package/dist/credits.d.ts.map

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

package/dist/credits.js

@@ -1,483 +0,0 @@
-/**
- * Carrier MCP — Credits System v2.0 (Pricing Evolution)
- *
- * Implements credit-based billing inspired by Stripe's Pricing Model Evolution Guide:
- *   - Monthly credit allotments per tier (Lovable pattern)
- *   - Auto-billed overages when base credits exhausted (Warp pattern)
- *   - Credit rollovers for irregular usage (Lovable pattern)
- *   - Daily free credits for acquisition (Browserbase/Lovable pattern)
- *   - Billing thresholds to prevent bill shock (Hex pattern)
- *   - Volume discounts for high-usage customers
- *
- * Storage layout (CARRIER_USERS KV):
- *   key: credits:<sub>:<yyyymm>     value: CreditLedger
- *   key: credits:daily:<sub>:<yyyymmdd>  value: DailyFreeCredits
- *   key: credits:config:<sub>       value: CreditConfig (overrides, thresholds)
- *   key: credits:rollover:<sub>     value: RolloverBalance
- *
- * Credit economy:
- *   1 tool call = 1 credit (read scope)
- *   1 tool call = 2 credits (write scope)
- *   1 tool call = 5 credits (admin scope)
- *   Intelligence composites = 3 credits each
- *
- * Stripe integration:
- *   - Overages reported via Stripe Metered Billing (usage_records API)
- *   - Billing thresholds trigger Stripe invoice finalization
- *   - Credit grants created via Stripe Customer Balance Transactions
- */
-// ---------------------------------------------------------------------------
-// Credit Constants
-// ---------------------------------------------------------------------------
-/** Monthly credit allotments per tier */
-export const TIER_CREDIT_ALLOTMENTS = {
-    free: 5_000,
-    pro: 100_000,
-    enterprise: Infinity,
-};
-/** Daily free credits for all users (acquisition driver) */
-export const DAILY_FREE_CREDITS = 50;
-/** Maximum rollover credits (cap at 2x monthly allotment) */
-export const ROLLOVER_CAP_MULTIPLIER = 2;
-/** Credit cost per scope */
-export const SCOPE_CREDIT_COSTS = {
-    read: 1,
-    write: 2,
-    admin: 5,
-    intelligence: 3,
-};
-/** Volume discount tiers (cumulative monthly usage) */
-export const VOLUME_DISCOUNTS = [
-    { threshold: 50_000, discountPct: 0 },
-    { threshold: 100_000, discountPct: 10 },
-    { threshold: 250_000, discountPct: 15 },
-    { threshold: 500_000, discountPct: 20 },
-    { threshold: 1_000_000, discountPct: 25 },
-];
-/** Default billing threshold (in cents) — triggers invoice at this spend level */
-export const DEFAULT_BILLING_THRESHOLD_CENTS = 10_000; // $100
-/** Overage price per credit (in cents) — Pro tier */
-export const OVERAGE_PRICE_PER_CREDIT_CENTS = 0.1; // $0.001 per credit
-// ---------------------------------------------------------------------------
-// Credit Check
-// ---------------------------------------------------------------------------
-/**
- * Check if a user has sufficient credits for a tool call.
- * Order of credit consumption:
- *   1. Daily free credits (if available)
- *   2. Monthly allotment (base + rollover)
- *   3. Overage (if enabled for tier)
- */
-export async function checkCredits(env, sub, tier, scope) {
-    const cost = SCOPE_CREDIT_COSTS[scope];
-    const month = currentMonth();
-    const today = currentDay();
-    const resetAt = firstDayNextMonth();
-    // Enterprise always allowed
-    if (tier === "enterprise") {
-        return {
-            allowed: true,
-            credits_remaining: Infinity,
-            daily_free_remaining: Infinity,
-            overage_active: false,
-            overage_amount_cents: 0,
-            threshold_pct: 0,
-            tier,
-            volume_discount_pct: 0,
-            reset_at: resetAt,
-        };
-    }
-    // Load ledger
-    const ledger = await getLedger(env, sub, month, tier);
-    const dailyFree = await getDailyFreeCredits(env, sub, today);
-    const config = await getCreditConfig(env, sub, tier);
-    // Calculate remaining
-    const monthlyRemaining = Math.max(0, ledger.allotment - ledger.consumed);
-    const dailyFreeRemaining = Math.max(0, dailyFree.granted - dailyFree.consumed);
-    const totalRemaining = dailyFreeRemaining + monthlyRemaining;
-    // Check if allowed
-    const overageEnabled = config.overages_enabled && tier !== "free";
-    const allowed = totalRemaining >= cost || overageEnabled;
-    // Volume discount
-    const volumeDiscount = resolveVolumeDiscount(ledger.consumed);
-    // Threshold percentage
-    const thresholdPct = config.billing_threshold_cents > 0
-        ? Math.round((ledger.overage_billed_cents / config.billing_threshold_cents) * 100)
-        : 0;
-    return {
-        allowed,
-        credits_remaining: monthlyRemaining,
-        daily_free_remaining: dailyFreeRemaining,
-        overage_active: monthlyRemaining < cost && dailyFreeRemaining < cost && overageEnabled,
-        overage_amount_cents: ledger.overage_billed_cents,
-        threshold_pct: thresholdPct,
-        tier,
-        volume_discount_pct: volumeDiscount,
-        reset_at: resetAt,
-    };
-}
-// ---------------------------------------------------------------------------
-// Credit Deduction
-// ---------------------------------------------------------------------------
-/**
- * Deduct credits for a tool call. Fire-and-forget in the hot path.
- *
- * Consumption order:
- *   1. Daily free credits first (lowest cost to user)
- *   2. Monthly allotment
- *   3. Overage (auto-billed, Pro+ only)
- */
-export function deductCredits(env, sub, tier, scope) {
-    void (async () => {
-        const cost = SCOPE_CREDIT_COSTS[scope];
-        const month = currentMonth();
-        const today = currentDay();
-        // Enterprise — no deduction needed
-        if (tier === "enterprise")
-            return;
-        // Try daily free credits first
-        const dailyFree = await getDailyFreeCredits(env, sub, today);
-        const dailyRemaining = dailyFree.granted - dailyFree.consumed;
-        if (dailyRemaining >= cost) {
-            // Deduct from daily free pool
-            await putDailyFreeCredits(env, sub, today, {
-                ...dailyFree,
-                consumed: dailyFree.consumed + cost,
-            });
-            return;
-        }
-        // Deduct from monthly allotment
-        const ledger = await getLedger(env, sub, month, tier);
-        const monthlyRemaining = ledger.allotment - ledger.consumed;
-        if (monthlyRemaining >= cost) {
-            await putLedger(env, sub, month, {
-                ...ledger,
-                consumed: ledger.consumed + cost,
-                updated_at: new Date().toISOString(),
-            });
-            return;
-        }
-        // Overage path (Pro+ only)
-        const config = await getCreditConfig(env, sub, tier);
-        if (!config.overages_enabled || tier === "free")
-            return;
-        const volumeDiscount = resolveVolumeDiscount(ledger.consumed);
-        const effectiveRate = OVERAGE_PRICE_PER_CREDIT_CENTS * (1 - volumeDiscount / 100);
-        const overageCostCents = Math.round(cost * effectiveRate * 100) / 100;
-        const updatedLedger = {
-            ...ledger,
-            consumed: ledger.consumed + cost,
-            overage: ledger.overage + cost,
-            overage_billed_cents: ledger.overage_billed_cents + overageCostCents,
-            updated_at: new Date().toISOString(),
-        };
-        // Check billing threshold
-        if (!ledger.threshold_triggered &&
-            updatedLedger.overage_billed_cents >= config.billing_threshold_cents) {
-            updatedLedger.threshold_triggered = true;
-            // Trigger Stripe invoice finalization (async, non-blocking)
-            void triggerBillingThreshold(env, sub, updatedLedger.overage_billed_cents);
-        }
-        await putLedger(env, sub, month, updatedLedger);
-        // Push overage to Stripe at every 100-credit boundary
-        if (updatedLedger.overage % 100 === 0) {
-            void pushOverageToStripe(env, sub, 100, effectiveRate).catch(() => { });
-        }
-    })();
-}
-// ---------------------------------------------------------------------------
-// Credit Grant (Rollover)
-// ---------------------------------------------------------------------------
-/**
- * Calculate and apply rollover credits from previous month.
- * Called by the monthly cron job (scheduled handler).
- *
- * Rules:
- *   - Only Pro+ tiers get rollovers
- *   - Rollover = min(unused credits, allotment * ROLLOVER_CAP_MULTIPLIER)
- *   - Rollovers expire after 1 month (use-it-or-lose-it next cycle)
- */
-export async function applyMonthlyRollover(env, sub, tier) {
-    if (tier === "free")
-        return null;
-    const prevMonth = previousMonth();
-    const prevLedger = await getLedger(env, sub, prevMonth, tier);
-    const unused = Math.max(0, prevLedger.allotment - prevLedger.consumed);
-    if (unused === 0)
-        return null;
-    const maxRollover = TIER_CREDIT_ALLOTMENTS[tier] * ROLLOVER_CAP_MULTIPLIER;
-    const rolloverAmount = Math.min(unused, maxRollover);
-    const rollover = {
-        credits: rolloverAmount,
-        source_month: prevMonth,
-        expires_at: firstDayMonthAfterNext(),
-    };
-    await env.CARRIER_USERS.put(`credits:rollover:${sub}`, JSON.stringify(rollover), { expirationTtl: 62 * 24 * 60 * 60 });
-    // Apply to current month's ledger
-    const currentMo = currentMonth();
-    const currentLedger = await getLedger(env, sub, currentMo, tier);
-    await putLedger(env, sub, currentMo, {
-        ...currentLedger,
-        allotment: currentLedger.allotment + rolloverAmount,
-        rollover_applied: rolloverAmount,
-        updated_at: new Date().toISOString(),
-    });
-    return rollover;
-}
-// ---------------------------------------------------------------------------
-// Volume Discounts
-// ---------------------------------------------------------------------------
-/**
- * Resolve the applicable volume discount percentage based on cumulative usage.
- */
-export function resolveVolumeDiscount(consumed) {
-    let discount = 0;
-    for (const tier of VOLUME_DISCOUNTS) {
-        if (consumed >= tier.threshold) {
-            discount = tier.discountPct;
-        }
-        else {
-            break;
-        }
-    }
-    return discount;
-}
-// ---------------------------------------------------------------------------
-// Billing Threshold
-// ---------------------------------------------------------------------------
-/**
- * Trigger billing threshold — creates a Stripe invoice for accumulated overages.
- * Prevents bill shock by invoicing incrementally (Hex pattern).
- */
-async function triggerBillingThreshold(env, sub, amountCents) {
-    const stripeKey = env.STRIPE_SECRET_KEY;
-    if (!stripeKey)
-        return;
-    const customerId = await env.CARRIER_USERS.get(`stripe_customer_id:${sub}`);
-    if (!customerId)
-        return;
-    // Create an invoice item for the threshold amount
-    const body = new URLSearchParams({
-        customer: customerId,
-        amount: String(Math.round(amountCents)),
-        currency: "usd",
-        description: `Carrier MCP overage credits (threshold reached)`,
-    });
-    const resp = await fetch("https://api.stripe.com/v1/invoiceitems", {
-        method: "POST",
-        headers: {
-            Authorization: `Bearer ${stripeKey}`,
-            "Content-Type": "application/x-www-form-urlencoded",
-        },
-        body: body.toString(),
-    });
-    if (!resp.ok)
-        return;
-    // Create and finalize the invoice
-    const invoiceBody = new URLSearchParams({
-        customer: customerId,
-        auto_advance: "true", // Auto-finalize and attempt payment
-        "collection_method": "charge_automatically",
-        description: "Carrier MCP — Overage billing threshold invoice",
-    });
-    await fetch("https://api.stripe.com/v1/invoices", {
-        method: "POST",
-        headers: {
-            Authorization: `Bearer ${stripeKey}`,
-            "Content-Type": "application/x-www-form-urlencoded",
-        },
-        body: invoiceBody.toString(),
-    });
-}
-/**
- * Push overage usage records to Stripe Metered Billing.
- */
-async function pushOverageToStripe(env, sub, quantity, ratePerCredit) {
-    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(),
-    });
-    // Store rate for reconciliation
-    await env.CARRIER_USERS.put(`overage_rate:${sub}`, JSON.stringify({ rate_cents: ratePerCredit, updated_at: new Date().toISOString() }), { expirationTtl: 35 * 24 * 60 * 60 });
-}
-// ---------------------------------------------------------------------------
-// KV Helpers
-// ---------------------------------------------------------------------------
-async function getLedger(env, sub, month, tier) {
-    const key = `credits:${sub}:${month}`;
-    const raw = await env.CARRIER_USERS.get(key, "json").catch(() => null);
-    if (raw && typeof raw === "object" && "allotment" in raw) {
-        return raw;
-    }
-    // Initialize new ledger for the month
-    const allotment = TIER_CREDIT_ALLOTMENTS[tier];
-    return {
-        allotment,
-        consumed: 0,
-        rollover_applied: 0,
-        overage: 0,
-        overage_billed_cents: 0,
-        threshold_triggered: false,
-        updated_at: new Date().toISOString(),
-    };
-}
-async function putLedger(env, sub, month, ledger) {
-    const key = `credits:${sub}:${month}`;
-    await env.CARRIER_USERS.put(key, JSON.stringify(ledger), {
-        expirationTtl: 65 * 24 * 60 * 60, // ~2 months
-    });
-}
-async function getDailyFreeCredits(env, sub, day) {
-    const key = `credits:daily:${sub}:${day}`;
-    const raw = await env.CARRIER_USERS.get(key, "json").catch(() => null);
-    if (raw && typeof raw === "object" && "granted" in raw) {
-        return raw;
-    }
-    // Initialize daily free credits
-    return {
-        granted: DAILY_FREE_CREDITS,
-        consumed: 0,
-        date: day,
-    };
-}
-async function putDailyFreeCredits(env, sub, day, credits) {
-    const key = `credits:daily:${sub}:${day}`;
-    await env.CARRIER_USERS.put(key, JSON.stringify(credits), {
-        expirationTtl: 2 * 24 * 60 * 60, // 2 days
-    });
-}
-async function getCreditConfig(env, sub, tier) {
-    const key = `credits:config:${sub}`;
-    const raw = await env.CARRIER_USERS.get(key, "json").catch(() => null);
-    if (raw && typeof raw === "object" && "billing_threshold_cents" in raw) {
-        return raw;
-    }
-    // Default config
-    return {
-        billing_threshold_cents: DEFAULT_BILLING_THRESHOLD_CENTS,
-        overages_enabled: tier !== "free",
-        rollovers_enabled: tier !== "free",
-        overage_rate_cents: OVERAGE_PRICE_PER_CREDIT_CENTS,
-        volume_discount_pct: 0,
-        notify_at_pct: [50, 80, 95, 100],
-        updated_at: new Date().toISOString(),
-    };
-}
-// ---------------------------------------------------------------------------
-// Admin: Update Credit Config
-// ---------------------------------------------------------------------------
-/**
- * Update a user's credit configuration (admin or self-service).
- */
-export async function updateCreditConfig(env, sub, updates) {
-    const tier = await resolveUserTier(env, sub);
-    const current = await getCreditConfig(env, sub, tier);
-    const updated = {
-        ...current,
-        ...updates,
-        updated_at: new Date().toISOString(),
-    };
-    const key = `credits:config:${sub}`;
-    await env.CARRIER_USERS.put(key, JSON.stringify(updated));
-    return updated;
-}
-/**
- * Get credit usage summary for a user (used by billing UI).
- */
-export async function getCreditSummary(env, sub, tier) {
-    const month = currentMonth();
-    const today = currentDay();
-    const ledger = await getLedger(env, sub, month, tier);
-    const dailyFree = await getDailyFreeCredits(env, sub, today);
-    const config = await getCreditConfig(env, sub, tier);
-    const rolloverRaw = await env.CARRIER_USERS.get(`credits:rollover:${sub}`, "json").catch(() => null);
-    const rollover = rolloverRaw;
-    const volumeDiscount = resolveVolumeDiscount(ledger.consumed);
-    return { ledger, daily_free: dailyFree, config, rollover, volume_discount_pct: volumeDiscount };
-}
-// ---------------------------------------------------------------------------
-// Stripe Credit Grants
-// ---------------------------------------------------------------------------
-/**
- * Issue a credit grant to a customer via Stripe Customer Balance Transactions.
- * Used for promotional credits, referral bonuses, and compensation.
- */
-export async function issueStripeCredits(env, sub, amountCents, description) {
-    const stripeKey = env.STRIPE_SECRET_KEY;
-    if (!stripeKey)
-        return false;
-    const customerId = await env.CARRIER_USERS.get(`stripe_customer_id:${sub}`);
-    if (!customerId)
-        return false;
-    const body = new URLSearchParams({
-        amount: String(-Math.abs(amountCents)), // Negative = credit to customer
-        currency: "usd",
-        description,
-    });
-    const resp = await fetch(`https://api.stripe.com/v1/customers/${customerId}/balance_transactions`, {
-        method: "POST",
-        headers: {
-            Authorization: `Bearer ${stripeKey}`,
-            "Content-Type": "application/x-www-form-urlencoded",
-        },
-        body: body.toString(),
-    });
-    return resp.ok;
-}
-// ---------------------------------------------------------------------------
-// Internal 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";
-}
-function currentMonth() {
-    const now = new Date();
-    return `${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}`;
-}
-function currentDay() {
-    const now = new Date();
-    return `${now.getUTCFullYear()}${String(now.getUTCMonth() + 1).padStart(2, "0")}${String(now.getUTCDate()).padStart(2, "0")}`;
-}
-function previousMonth() {
-    const now = new Date();
-    const d = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() - 1, 1));
-    return `${d.getUTCFullYear()}${String(d.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();
-}
-function firstDayMonthAfterNext() {
-    const now = new Date();
-    const y = now.getUTCFullYear();
-    const m = now.getUTCMonth() + 2;
-    if (m >= 12)
-        return new Date(Date.UTC(y + 1, m - 12, 1)).toISOString();
-    return new Date(Date.UTC(y, m, 1)).toISOString();
-}
-//# sourceMappingURL=credits.js.map