@trendyvideo/billing 1.0.0

package/dist/pricing.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MICRODOLLARS_PER_CREDIT = exports.COST_MARKUP = exports.DEFAULT_PRICING = exports.MODEL_PRICING = void 0;
+exports.getPricing = getPricing;
+exports.calculateCostMicrodollars = calculateCostMicrodollars;
+exports.microdollarsToCredits = microdollarsToCredits;
+exports.creditsToMicrodollars = creditsToMicrodollars;
+// ============================================================================
+// Model Pricing — Single Source of Truth
+// All prices in USD per 1 million tokens
+// ============================================================================
+exports.MODEL_PRICING = {
+    // ---------------------------------------------------------------------------
+    // Claude models
+    // ---------------------------------------------------------------------------
+    'claude-opus-4-6': { input: 5, output: 25, cacheRead: 0.50, cacheWrite: 6.25 },
+    'claude-opus-4-20250514': { input: 15, output: 75, cacheRead: 1.50, cacheWrite: 18.75 },
+    'claude-sonnet-4-6': { input: 3, output: 15, cacheRead: 0.30, cacheWrite: 3.75 },
+    'claude-sonnet-4-5-20250929': { input: 3, output: 15, cacheRead: 0.30, cacheWrite: 3.75 },
+    'claude-sonnet-4-20250514': { input: 3, output: 15, cacheRead: 0.30, cacheWrite: 3.75 },
+    'claude-haiku-4-5-20251001': { input: 1, output: 5, cacheRead: 0.10, cacheWrite: 1.25 },
+    'claude-haiku-3-5-20241022': { input: 0.80, output: 4, cacheRead: 0.08, cacheWrite: 1 },
+    // ---------------------------------------------------------------------------
+    // Gemini models
+    // ---------------------------------------------------------------------------
+    'gemini-3.1-pro-preview': { input: 2.50, output: 15, cacheRead: 0, cacheWrite: 0 },
+    // Tool-call-optimized Pro variant — same rate card as vanilla 3.1 Pro preview.
+    'gemini-3.1-pro-preview-customtools': { input: 2.50, output: 15, cacheRead: 0, cacheWrite: 0 },
+    // gemini-3.1-flash-preview was a phantom SKU — never published on Vertex AI
+    // (returns 404). The actual Flash 3.x SKUs are:
+    //   - `gemini-3-flash-preview` (regular Flash, global region)
+    //   - `gemini-3.1-flash-lite-preview` (cheaper Lite variant, global region)
+    'gemini-3-flash-preview': { input: 0.30, output: 2.50, cacheRead: 0, cacheWrite: 0 },
+    'gemini-3.1-flash-lite-preview': { input: 0.15, output: 0.60, cacheRead: 0, cacheWrite: 0 },
+    'gemini-2.5-pro': { input: 1.25, output: 10, cacheRead: 0, cacheWrite: 0 },
+    'gemini-2.5-flash': { input: 0.15, output: 0.60, cacheRead: 0, cacheWrite: 0 },
+    'gemini-2.0-flash': { input: 0.10, output: 0.40, cacheRead: 0, cacheWrite: 0 },
+    'gemini-1.5-pro': { input: 1.25, output: 5, cacheRead: 0, cacheWrite: 0 },
+    'gemini-1.5-flash': { input: 0.075, output: 0.30, cacheRead: 0, cacheWrite: 0 },
+    // ---------------------------------------------------------------------------
+    // Gemini image generation models (flat-rate — use costMicrodollarsOverride)
+    // Pricing: ~$0.04/image for Pro, ~$0.02/image for Flash
+    // ---------------------------------------------------------------------------
+    'gemini-3-pro-image-preview': { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    'gemini-3.1-flash-image-preview': { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    // ---------------------------------------------------------------------------
+    // Non-token services (flat-rate — use costMicrodollarsOverride when recording)
+    // Pricing listed here for reference; input = cost per 1M "units"
+    // ---------------------------------------------------------------------------
+    'render-engine': { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    'chirp-tts': { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    'veo-video-gen': { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    'text-embedding-005': { input: 0.025, output: 0, cacheRead: 0, cacheWrite: 0 },
+    // ---------------------------------------------------------------------------
+    // Storage (flat-rate — $0.05/GB/month, use costMicrodollarsOverride)
+    // ---------------------------------------------------------------------------
+    'storage': { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+};
+/**
+ * Default pricing used when the model is not found in MODEL_PRICING.
+ * Falls back to Claude Sonnet pricing as a safe default.
+ */
+exports.DEFAULT_PRICING = {
+    input: 3,
+    output: 15,
+    cacheRead: 0.30,
+    cacheWrite: 3.75,
+};
+/**
+ * Look up pricing for a model. Tries exact match first, then prefix match
+ * (stripping date suffixes like `-20250514`), then falls back to DEFAULT_PRICING.
+ */
+function getPricing(model) {
+    // Exact match
+    if (exports.MODEL_PRICING[model])
+        return exports.MODEL_PRICING[model];
+    // Prefix match (e.g. "gemini-2.5-flash-preview-05-20" → "gemini-2.5-flash")
+    for (const [key, pricing] of Object.entries(exports.MODEL_PRICING)) {
+        if (model.startsWith(key))
+            return pricing;
+    }
+    // Strip trailing date suffix and retry (e.g. "claude-sonnet-4-6-20260101" → "claude-sonnet-4-6")
+    const stripped = model.replace(/-\d{8}$/, '');
+    if (stripped !== model && exports.MODEL_PRICING[stripped]) {
+        return exports.MODEL_PRICING[stripped];
+    }
+    return exports.DEFAULT_PRICING;
+}
+/**
+ * Markup applied to all API costs to ensure profit margin.
+ * 1.5x means we charge 50% more than raw cost → ~33% margin.
+ * Applied to both token-based costs AND flat-rate overrides.
+ */
+exports.COST_MARKUP = 1.5;
+/**
+ * Calculate cost in microdollars (1 microdollar = $0.000001).
+ *
+ * Since pricing is per-million tokens:
+ *   cost_usd = (tokens / 1_000_000) * rate_per_million
+ *   cost_microdollars = cost_usd * 1_000_000 = tokens * rate_per_million
+ *
+ * All costs include COST_MARKUP (1.5x) for profit margin.
+ */
+function calculateCostMicrodollars(model, inputTokens, outputTokens, cacheReadTokens = 0, cacheCreationTokens = 0, costMicrodollarsOverride) {
+    if (costMicrodollarsOverride !== undefined) {
+        return Math.round(costMicrodollarsOverride * exports.COST_MARKUP);
+    }
+    const p = getPricing(model);
+    const inputCost = inputTokens * p.input;
+    const outputCost = outputTokens * p.output;
+    const cacheReadCost = cacheReadTokens * p.cacheRead;
+    const cacheWriteCost = cacheCreationTokens * p.cacheWrite;
+    const rawCost = inputCost + outputCost + cacheReadCost + cacheWriteCost;
+    return Math.round(rawCost * exports.COST_MARKUP);
+}
+// ============================================================================
+// Credit System — 1 credit = $0.01 = 10,000 microdollars
+// ============================================================================
+exports.MICRODOLLARS_PER_CREDIT = 10_000;
+function microdollarsToCredits(microdollars) {
+    return Math.ceil(microdollars / exports.MICRODOLLARS_PER_CREDIT);
+}
+function creditsToMicrodollars(credits) {
+    return credits * exports.MICRODOLLARS_PER_CREDIT;
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Minimal Supabase client interface — accepts any version of @supabase/supabase-js
+ * without requiring exact type identity (avoids duplicate package type mismatches)
+ */
+export interface SupabaseClientLike {
+    rpc(fn: string, params?: Record<string, unknown>): PromiseLike<{
+        data: unknown;
+        error: {
+            message: string;
+        } | null;
+    }>;
+    from(table: string): any;
+}
+export interface ModelPricing {
+    /** Cost per 1M input tokens (USD) */
+    input: number;
+    /** Cost per 1M output tokens (USD) */
+    output: number;
+    /** Cost per 1M cached read tokens (USD). 0 if not applicable. */
+    cacheRead: number;
+    /** Cost per 1M cache creation tokens (USD). 0 if not applicable. */
+    cacheWrite: number;
+}
+export type PlanName = 'free' | 'creator' | 'pro' | 'agency';
+export interface PlanLimits {
+    /** Storage quota in bytes */
+    storageBytes: number;
+    /** Max renders per billing period */
+    rendersPerMonth: number;
+    /** Max concurrent streams */
+    streams: number;
+    /** Max projects */
+    projects: number;
+    /** Max connected social accounts */
+    socialAccounts: number;
+    /** Max export resolution */
+    maxResolution: '720p' | '1080p' | '4k';
+    /** Number of base team seats included in the plan */
+    seats: number;
+    /** Price per additional seat in cents (0 = no seat add-ons allowed) */
+    seatPrice: number;
+    /** Credits granted per additional seat */
+    creditsPerSeat: number;
+    /** Whether exports include a watermark */
+    watermark: boolean;
+    /** Max streamer watches */
+    maxWatches: number;
+    /** Included credits per billing period (1 credit = $0.01) */
+    includedCredits: number;
+    /** Max overage credits before hard block */
+    overageCapCredits: number;
+}
+export interface UsageEvent {
+    organizationId: string;
+    /** Service name (e.g. 'agent', 'chunk-analyzer', 'reviral') */
+    service: string;
+    /** Model identifier (e.g. 'claude-sonnet-4-6', 'gemini-2.5-pro') */
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+    apiCalls?: number;
+    /** Override auto-calculated cost for flat-rate services (Chirp TTS, Veo, etc.) */
+    costMicrodollarsOverride?: number;
+    /** Credits consumed by this event (auto-computed from costMicrodollars) */
+    creditsConsumed?: number;
+    /** Optional conversation ID for agent usage */
+    conversationId?: string;
+    /** Optional context (stream_id, chunk_number, project_id, etc.) */
+    metadata?: Record<string, unknown>;
+    /**
+     * True when the platform eats this cost (conversation naming, compaction,
+     * summaries, project auto-naming, memories, studio suggestions, etc.).
+     * Recorded to usage_events for analytics, but skipped from the usage_records
+     * upsert so it never hits the user's credit/subscription balance.
+     * Metadata is auto-augmented with { platform_paid: true } in recordUsage.
+     */
+    platformPaid?: boolean;
+}
+export interface UsageRecord {
+    organizationId: string;
+    periodStart: string;
+    periodEnd: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    apiCallCount: number;
+    renderCount: number;
+    /** Total credits used in this billing period */
+    creditsUsed?: number;
+}
+export interface UsageCheckResult {
+    allowed: boolean;
+    reason?: 'no_subscription' | 'subscription_inactive' | 'free_limit_exceeded' | 'overage_cap_reached';
+    warning?: 'approaching_limit' | 'in_overage';
+    usage: {
+        /** Credits used in the current billing period */
+        creditsUsed: number;
+        /** Credits included in the plan */
+        creditsIncluded: number;
+        /** Remaining credits (can be negative if in overage) */
+        creditsRemaining: number;
+        /** Percentage of included credits consumed */
+        creditPercentUsed: number;
+        /** Whether the organization has exceeded included credits */
+        isOverCredits: boolean;
+        /** Number of overage credits consumed beyond the included amount */
+        overageCredits: number;
+        totalTokens?: number;
+        includedLimit?: number;
+        overageTokens?: number;
+        percentUsed?: number;
+        inputTokens?: number;
+        outputTokens?: number;
+        includedInputLimit?: number;
+        includedOutputLimit?: number;
+        inputOverageTokens?: number;
+        outputOverageTokens?: number;
+        inputOverageCost?: number;
+        outputOverageCost?: number;
+        totalOverageCost?: number;
+        overageCap?: number;
+    };
+    plan: {
+        id: string;
+        name: string;
+        inputOverageRatePer1k?: number;
+        outputOverageRatePer1k?: number;
+    };
+}
+export interface RenderLimitResult {
+    allowed: boolean;
+    rendersUsed: number;
+    maxRenders: number;
+    message?: string;
+}
+export interface StorageQuotaResult {
+    allowed: boolean;
+    currentUsageBytes: number;
+    quotaBytes: number;
+    planName: string;
+    reason?: string;
+}
+export interface StreamLimitResult {
+    allowed: boolean;
+    activeStreams: number;
+    maxStreams: number;
+    reason?: string;
+}
+export interface ProjectLimitResult {
+    allowed: boolean;
+    currentProjects: number;
+    maxProjects: number;
+    reason?: string;
+}
+export interface SocialAccountLimitResult {
+    allowed: boolean;
+    currentAccounts: number;
+    maxAccounts: number;
+    reason?: string;
+}
+export interface ResolutionLimitResult {
+    allowed: boolean;
+    requestedResolution: string;
+    maxResolution: string;
+    reason?: string;
+}
+export interface SeatLimitResult {
+    allowed: boolean;
+    currentSeats: number;
+    maxSeats: number;
+    reason?: string;
+}
+export interface UsageAlertResult {
+    shouldSend: boolean;
+    percentUsed: number;
+    alreadySent: boolean;
+}
+export interface BillingLogger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+export type SupabaseClient = SupabaseClientLike;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/usage-checker.d.ts

@@ -0,0 +1,26 @@
+import { SupabaseClient, UsageCheckResult, RenderLimitResult, BillingLogger } from './types';
+/**
+ * Check whether an organization is allowed to continue using AI services.
+ * Credits are the SOLE enforcement mechanism.
+ *
+ * Logic:
+ *  - Free plan: hard block when credits exhausted (no overages).
+ *  - Paid plans: allow overages up to the plan's overage credit cap.
+ *
+ * Token counts are still returned for analytics/logging but are NOT
+ * used for any enforcement decisions.
+ */
+export declare function checkUsage(supabase: SupabaseClient, orgId: string, logger?: BillingLogger): Promise<UsageCheckResult>;
+/**
+ * Check if an organization has remaining renders in the current billing period.
+ * Fails CLOSED on errors — if we cannot verify the render quota, the render
+ * is denied. Includes 1 retry with a short delay.
+ */
+export declare function checkRenderLimit(supabase: SupabaseClient, orgId: string, logger?: BillingLogger): Promise<RenderLimitResult>;
+/**
+ * Increment the render count for an organization in the current billing period.
+ * Should be called after a render job completes successfully.
+ * Never throws.
+ */
+export declare function incrementRenders(supabase: SupabaseClient, orgId: string, count?: number, logger?: BillingLogger): Promise<void>;
+//# sourceMappingURL=usage-checker.d.ts.map

package/dist/usage-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-checker.d.ts","sourceRoot":"","sources":["../src/usage-checker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAiF7F;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,aAA6B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CA8G3B;AASD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,aAA6B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAsE5B;AAMD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,SAAI,EACT,MAAM,GAAE,aAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/dist/usage-checker.js

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkUsage = checkUsage;
+exports.checkRenderLimit = checkRenderLimit;
+exports.incrementRenders = incrementRenders;
+const pricing_1 = require("./pricing");
+const plan_limits_1 = require("./plan-limits");
+const defaultLogger = {
+    debug: () => { },
+    info: (msg, meta) => console.log(`[billing] ${msg}`, meta ?? ''),
+    warn: (msg, meta) => console.warn(`[billing] ${msg}`, meta ?? ''),
+    error: (msg, meta) => console.error(`[billing] ${msg}`, meta ?? ''),
+};
+/**
+ * Log an enforcement/audit event to the billing_events table.
+ * Fire-and-forget — never throws or blocks the caller.
+ */
+async function logBillingEvent(supabase, orgId, eventType, description, details, logger) {
+    try {
+        const { error } = await supabase.from('billing_events').insert({
+            organization_id: orgId,
+            event_type: eventType,
+            description,
+            amount_cents: 0,
+            related_data: details,
+        });
+        if (error) {
+            logger.warn('Failed to log billing event', {
+                orgId,
+                eventType,
+                error: error.message,
+            });
+        }
+    }
+    catch (err) {
+        // Never block the caller
+        logger.warn('Unexpected error logging billing event', {
+            orgId,
+            eventType,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+// ============================================================================
+// Empty / default values
+// ============================================================================
+const EMPTY_USAGE = {
+    creditsUsed: 0,
+    creditsIncluded: 0,
+    creditsRemaining: 0,
+    creditPercentUsed: 0,
+    isOverCredits: false,
+    overageCredits: 0,
+};
+const UNKNOWN_PLAN = {
+    id: 'unknown',
+    name: 'Unknown',
+};
+// ============================================================================
+// checkUsage
+// ============================================================================
+/**
+ * Check whether an organization is allowed to continue using AI services.
+ * Credits are the SOLE enforcement mechanism.
+ *
+ * Logic:
+ *  - Free plan: hard block when credits exhausted (no overages).
+ *  - Paid plans: allow overages up to the plan's overage credit cap.
+ *
+ * Token counts are still returned for analytics/logging but are NOT
+ * used for any enforcement decisions.
+ */
+async function checkUsage(supabase, orgId, logger = defaultLogger) {
+    const { data, error } = await supabase.rpc('get_org_current_usage', { org_id: orgId });
+    if (error) {
+        logger.error('Failed to check org usage', { orgId, error: error.message });
+        return { allowed: false, reason: 'no_subscription', usage: EMPTY_USAGE, plan: UNKNOWN_PLAN };
+    }
+    const row = Array.isArray(data) ? data[0] : data;
+    if (!row) {
+        return {
+            allowed: false,
+            reason: 'no_subscription',
+            usage: EMPTY_USAGE,
+            plan: { ...UNKNOWN_PLAN, id: 'none', name: 'None' },
+        };
+    }
+    const planId = row.plan_id ?? 'unknown';
+    const planName = row.plan_name ?? 'Unknown';
+    // Credit calculations — sole enforcement mechanism
+    const costMicrodollars = row.cost_microdollars ?? 0;
+    const creditsUsed = (0, pricing_1.microdollarsToCredits)(costMicrodollars);
+    const planLimits = (0, plan_limits_1.getPlanLimits)((0, plan_limits_1.normalizePlanName)(planName));
+    // Include bonus credits from additional purchased seats
+    const additionalSeats = row.additional_seats ?? 0;
+    const seatBonusCredits = additionalSeats * planLimits.creditsPerSeat;
+    const creditsIncluded = planLimits.includedCredits + seatBonusCredits;
+    const creditsRemaining = creditsIncluded - creditsUsed;
+    const creditPercentUsed = creditsIncluded > 0 ? (creditsUsed / creditsIncluded) * 100 : 0;
+    const isOverCredits = creditsUsed > creditsIncluded;
+    const overageCredits = Math.max(0, creditsUsed - creditsIncluded);
+    // Raw token counts (analytics only — NOT used for enforcement)
+    const inputTokens = row.used_input_tokens ?? 0;
+    const outputTokens = row.used_output_tokens ?? 0;
+    const totalTokens = inputTokens + outputTokens;
+    const usage = {
+        creditsUsed,
+        creditsIncluded,
+        creditsRemaining,
+        creditPercentUsed,
+        isOverCredits,
+        overageCredits,
+        // Analytics-only token data
+        totalTokens,
+        inputTokens,
+        outputTokens,
+    };
+    const plan = {
+        id: planId,
+        name: planName,
+    };
+    // Free plan hard limit — block when credits exhausted
+    if (planId === 'free' && isOverCredits) {
+        logBillingEvent(supabase, orgId, 'limit_exceeded', 'Free plan credit limit exceeded', {
+            planId,
+            creditsUsed,
+            creditsIncluded,
+            creditPercentUsed,
+        }, logger);
+        return { allowed: false, reason: 'free_limit_exceeded', usage, plan };
+    }
+    // Paid plans — block when overage credits reach the cap
+    const overageCapCredits = planLimits.overageCapCredits;
+    if (planId !== 'free' && overageCredits >= overageCapCredits && overageCapCredits > 0) {
+        logBillingEvent(supabase, orgId, 'overage_cap_reached', 'Monthly overage credit cap reached', {
+            planId,
+            creditsUsed,
+            creditsIncluded,
+            overageCredits,
+            overageCapCredits,
+        }, logger);
+        return { allowed: false, reason: 'overage_cap_reached', usage, plan };
+    }
+    // Warnings (credit-based only)
+    let warning;
+    if (isOverCredits) {
+        warning = 'in_overage';
+        // Log overage start only when first entering overage (within 5% band to reduce noise)
+        if (creditPercentUsed <= 105) {
+            logBillingEvent(supabase, orgId, 'usage_warning', 'Organization entered credit overage', {
+                planId,
+                creditsUsed,
+                creditsIncluded,
+                overageCredits,
+                warning: 'in_overage',
+            }, logger);
+        }
+    }
+    else if (creditPercentUsed > 80) {
+        warning = 'approaching_limit';
+        // Log warning when crossing 80% threshold (within 2% band to reduce noise)
+        if (creditPercentUsed <= 82) {
+            logBillingEvent(supabase, orgId, 'usage_warning', 'Credit usage approaching plan limit (80%)', {
+                planId,
+                creditsUsed,
+                creditsIncluded,
+                creditPercentUsed,
+                warning: 'approaching_limit',
+            }, logger);
+        }
+    }
+    return { allowed: true, warning, usage, plan };
+}
+// ============================================================================
+// checkRenderLimit
+// ============================================================================
+const RENDER_RETRY_DELAY_MS = 500;
+const RENDER_MAX_ATTEMPTS = 2;
+/**
+ * Check if an organization has remaining renders in the current billing period.
+ * Fails CLOSED on errors — if we cannot verify the render quota, the render
+ * is denied. Includes 1 retry with a short delay.
+ */
+async function checkRenderLimit(supabase, orgId, logger = defaultLogger) {
+    const failClosed = {
+        allowed: false,
+        rendersUsed: 0,
+        maxRenders: 0,
+        message: 'Unable to verify render quota. Please try again.',
+    };
+    for (let attempt = 1; attempt <= RENDER_MAX_ATTEMPTS; attempt++) {
+        try {
+            const { data, error } = await supabase.rpc('check_render_limit', {
+                p_organization_id: orgId,
+            });
+            if (error) {
+                logger.error('Failed to check render limit', {
+                    orgId,
+                    error: error.message,
+                    attempt,
+                });
+                if (attempt < RENDER_MAX_ATTEMPTS) {
+                    await new Promise((r) => setTimeout(r, RENDER_RETRY_DELAY_MS));
+                    continue;
+                }
+                return failClosed;
+            }
+            const row = Array.isArray(data) ? data[0] : data;
+            if (!row) {
+                return {
+                    allowed: false,
+                    rendersUsed: 0,
+                    maxRenders: 0,
+                    message: 'No active subscription found. Please check your billing settings.',
+                };
+            }
+            const rendersUsed = row.renders_used ?? 0;
+            const maxRenders = row.max_renders ?? 2147483647;
+            if (rendersUsed >= maxRenders) {
+                logBillingEvent(supabase, orgId, 'render_limit_reached', 'Monthly render limit reached', {
+                    rendersUsed,
+                    maxRenders,
+                }, logger);
+                return {
+                    allowed: false,
+                    rendersUsed,
+                    maxRenders,
+                    message: `Render limit reached: ${rendersUsed}/${maxRenders} used. Upgrade your plan for more renders.`,
+                };
+            }
+            return { allowed: true, rendersUsed, maxRenders };
+        }
+        catch (err) {
+            logger.error('Unexpected error checking render limit', {
+                orgId,
+                error: err instanceof Error ? err.message : String(err),
+                attempt,
+            });
+            if (attempt < RENDER_MAX_ATTEMPTS) {
+                await new Promise((r) => setTimeout(r, RENDER_RETRY_DELAY_MS));
+                continue;
+            }
+        }
+    }
+    return failClosed;
+}
+// ============================================================================
+// incrementRenders
+// ============================================================================
+/**
+ * Increment the render count for an organization in the current billing period.
+ * Should be called after a render job completes successfully.
+ * Never throws.
+ */
+async function incrementRenders(supabase, orgId, count = 1, logger = defaultLogger) {
+    try {
+        // Get the current billing period for the RPC
+        const { data: sub, error: subError } = await supabase
+            .from('organization_subscriptions')
+            .select('current_period_start, current_period_end')
+            .eq('organization_id', orgId)
+            .order('created_at', { ascending: false })
+            .limit(1)
+            .single();
+        if (subError || !sub) {
+            logger.warn('No subscription found for render count increment', {
+                orgId,
+                error: subError?.message,
+            });
+            return;
+        }
+        // Call the correct RPC: increment_renders_used (matches DB migration)
+        for (let i = 0; i < count; i++) {
+            const { error } = await supabase.rpc('increment_renders_used', {
+                p_organization_id: orgId,
+                p_period_start: sub.current_period_start,
+                p_period_end: sub.current_period_end,
+            });
+            if (error) {
+                logger.error('RPC increment_renders_used failed', {
+                    orgId,
+                    error: error.message,
+                    iteration: i + 1,
+                });
+            }
+        }
+    }
+    catch (err) {
+        logger.error('Failed to increment render count', {
+            orgId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=usage-checker.js.map