feat(billing): gate auto-recharge behind AUTO_RECHARGE_ENABLED env flag (firecrawl#3263)

Add AUTO_RECHARGE_ENABLED environment variable (defaults to false) to
globally disable the auto-recharge flow. When unset or false,
auto-recharge will not trigger regardless of per-team database settings.
Set AUTO_RECHARGE_ENABLED=true to re-enable the previous behavior.

Co-authored-by: firecrawl-spring[bot] <254786068+firecrawl-spring[bot]@users.noreply.github.com>
Co-authored-by: micahstairs <micah@sideguide.dev>

Author: firecrawl-spring[bot]

apps/api/src/config.ts

@@ -231,6 +231,9 @@ const configSchema = z.object({
   SENTRY_ENVIRONMENT: z.string().default("production"),
   NUQ_POD_NAME: z.string().default("main"),
 
+  // Billing
+  AUTO_RECHARGE_ENABLED: z.stringbool().default(false),
+
   // Miscellaneous
   IDMUX_URL: z.string().optional(),
   GITHUB_RUN_NUMBER: z.string().optional(),

apps/api/src/services/billing/credit_billing.ts

@@ -11,6 +11,7 @@ import { queueBillingOperation } from "./batch_billing";
 import { autumnService } from "../autumn/autumn.service";
 import { toAutumnBillingProperties, type BillingMetadata } from "./types";
 import type { Logger } from "winston";
+import { config } from "../../config";
 
 /**
  * If you do not know the subscription_id in the current context, pass subscription_id as undefined.
@@ -92,8 +93,7 @@ function evaluateTeamCredits(
   credits: number,
   isAutoRechargeEnabled: boolean,
 ) {
-  const allowOverages =
-    chunk.price_should_be_graceful && isAutoRechargeEnabled;
+  const allowOverages = chunk.price_should_be_graceful && isAutoRechargeEnabled;
   const remainingCredits = allowOverages
     ? chunk.remaining_credits + chunk.price_credits
     : chunk.remaining_credits;
@@ -173,6 +173,7 @@ async function supaCheckTeamCredits(
   } = evaluateTeamCredits(chunk, credits, isAutoRechargeEnabled);
 
   if (
+    config.AUTO_RECHARGE_ENABLED &&
     isAutoRechargeEnabled &&
     chunk.remaining_credits < autoRechargeThreshold &&
     !chunk.is_extract