Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
import { z } from "zod";
export const BILLING_ROUTE = "/billing";
export const SUBSCRIBE_ROUTE = "/subscribe";
// Billing page tabs. Here rather than in BillingTabs.tsx because the route's
// validateSearch reads them, and route options aren't code-split: importing
// the component would pull its chart into the entry chunk.
export const BILLING_TABS = [
{ value: "usage", label: "Usage" },
{ value: "invoices", label: "Invoices" },
] as const;
export type BillingTab = (typeof BILLING_TABS)[number]["value"];
export type PlanStatus = "free" | "paid";
export const AUTUMN_PAID_PLAN_ID = "base-plan";
// YC deal: same entitlements as the base plan with $50 of monthly credits.
export const AUTUMN_YC_PLAN_ID = "yc-plan";
/** The plans the app sells through checkout. */
export const CHECKOUT_PLAN_IDS = [
AUTUMN_PAID_PLAN_ID,
AUTUMN_YC_PLAN_ID,
] as const;
export type CheckoutPlanId = (typeof CHECKOUT_PLAN_IDS)[number];
export const AUTUMN_SEO_DATA_TOP_UP_PLAN_ID = "credit-top-up";
export const AUTUMN_PAID_PLAN_FEATURE_ID = "paid_plan";
// Granted by both the free plan (now the Autumn Default, so every non-paid
// user gets it) and the paid base plan. It's the floor for using the managed
// service at all — paid-only features gate on AUTUMN_PAID_PLAN_FEATURE_ID.
export const AUTUMN_MANAGED_ACCESS_FEATURE_ID = "managed_service_access";
// The shared usage-credit pool. Both DataForSEO and agent-LLM spend deduct
// from these (monthly usage_credits first, then rolled-over topup_credits).
export const AUTUMN_SEO_DATA_BALANCE_FEATURE_ID = "usage_credits";
export const AUTUMN_SEO_DATA_TOPUP_BALANCE_FEATURE_ID = "topup_credits";
export const AUTUMN_SEO_DATA_CREDITS_PER_USD = 1000;
const SEO_DATA_COST_MARKUP = 1.28;
export const LOW_CREDITS_THRESHOLD_USD = 0.25;
// Auto-reload: Autumn buys top-up credits with the saved card whenever the
// top-up balance is at or below the threshold, and a monthly budget caps
// what the organization spends on top-up credits per billing cycle. The
// threshold is fixed: it only needs to cover the largest single hold, and a
// user-set one that reached the reload amount would make every reload
// trigger the next. The reload amount shares the one-off top-up bounds
// because both buy through the same Autumn plan.
export const TOP_UP_MIN_USD = 10;
export const TOP_UP_MAX_USD = 99;
export const AUTO_RELOAD_THRESHOLD_USD = 5;
// Reloads are charged off-session, without Stripe Checkout's confirmation,
// and only happen as top-up credits are spent, so the budget bounds what a
// card can be charged in a cycle; raise on request.
export const AUTO_RELOAD_MAX_MONTHLY_USD = 1000;
export const AUTO_RELOAD_DEFAULTS = {
amountUsd: 20,
monthlyLimitUsd: 100,
} as const;
// Autumn refuses the hold that would take the cycle's spend past the budget
// while the balance still shows credits, so the spend rarely lands on the
// limit itself: the budget is as good as spent once less than the largest
// single hold (the threshold) is left of it, and the pages say so then.
export function isAutoReloadBudgetSpent(
spentUsd: number,
monthlyLimitUsd: number,
) {
return monthlyLimitUsd - spentUsd < AUTO_RELOAD_THRESHOLD_USD;
}
// Autumn's reasons a reload did not go through that the customer can act on:
// the card, not our setup. Everything else is ours to look at.
export const AUTO_RELOAD_CARD_FAILURE_REASONS: ReadonlySet<string> = new Set([
"charge_failed",
"suspended_after_failures",
"missing_payment_method",
"payment_method_not_supported",
"payment_method_delayed",
]);
export const autoReloadSettingsSchema = z
.object({
amountUsd: z.number().int().min(TOP_UP_MIN_USD).max(TOP_UP_MAX_USD),
/** The most the organization spends on top-up credits per billing
* cycle, in USD. Every top-up credit counts, not only reloaded ones. */
monthlyLimitUsd: z
.number()
.int()
.min(TOP_UP_MIN_USD)
.max(AUTO_RELOAD_MAX_MONTHLY_USD),
})
.refine((settings) => settings.monthlyLimitUsd >= settings.amountUsd, {
message: "The monthly budget must be at least the reload amount.",
path: ["monthlyLimitUsd"],
});
export type AutoReloadSettings = z.infer<typeof autoReloadSettingsSchema>;
// DataForSEO's raw price for one Google Ads search_volume live call (up to
// 1,000 keywords). Local keyword research adds one call to each search.
export const LOCAL_VOLUME_COST_USD = 0.09;
// Passed through to Stripe's checkout.sessions.create so checkout collects the
// legal business name, tax ID (EU VAT etc.), and full billing address — makes
// invoices valid for business customers. Display only, no Stripe Tax. Stripe
// requires customer_update.name "auto" to collect tax IDs for an existing customer.
export const AUTUMN_CHECKOUT_SESSION_PARAMS = {
tax_id_collection: { enabled: true },
billing_address_collection: "required",
customer_update: { name: "auto", address: "auto" },
} as const;
// YC checkout additionally shows Stripe's promotion code field so founders
// can redeem the YC deal code for their first month.
export const AUTUMN_YC_CHECKOUT_SESSION_PARAMS = {
...AUTUMN_CHECKOUT_SESSION_PARAMS,
allow_promotion_codes: true,
} as const;
export function roundUsdForBilling(value: number) {
return Math.round(value * 100000) / 100000;
}
export function autumnSeoDataCreditsToUsd(credits: number) {
return credits / AUTUMN_SEO_DATA_CREDITS_PER_USD;
}
/**
* Convert a raw DataForSEO USD cost into the USD amount a hosted customer is
* actually billed, applying the platform markup. Use this when displaying
* cost estimates so the number matches what the user will be charged.
*
* Self-hosted deployments pay DataForSEO directly at the raw rate and should
* show the raw number — gate at the call site with `isHostedClientAuthMode`.
*/
export function applyBillingMarkupUsd(rawUsd: number): number {
return roundUsdForBilling(rawUsd * SEO_DATA_COST_MARKUP);
}
/**
* Credits charged for one raw provider (DataForSEO) USD cost: marked-up,
* rounded, then ceiled per call. This is the single charging formula, so a
* pre-call estimate and the post-call deduction cannot drift apart.
*/
export function creditsForProviderUsd(rawUsd: number): number {
return Math.ceil(
applyBillingMarkupUsd(rawUsd) * AUTUMN_SEO_DATA_CREDITS_PER_USD,
);
}