Sync public snapshot from freebuff-private

Source: CodebuffAI/freebuff-private@259af22fd7b810c1683a2b72105c33d75b2b2020

Author: github-actions[bot]

bun.lock

@@ -118,11 +118,31 @@ export const FREEBUFF_SUBSCRIPTION_TIER_IDS = [
 export type FreebuffSubscriptionTierId =
   (typeof FREEBUFF_SUBSCRIPTION_TIER_IDS)[number]
 
+export const FREEBUFF_SUBSCRIPTION_BILLING_INTERVALS = [
+  'monthly',
+  'yearly',
+] as const
+export type FreebuffSubscriptionBillingInterval =
+  (typeof FREEBUFF_SUBSCRIPTION_BILLING_INTERVALS)[number]
+
+export function isFreebuffSubscriptionBillingInterval(
+  value: unknown,
+): value is FreebuffSubscriptionBillingInterval {
+  return (
+    typeof value === 'string' &&
+    FREEBUFF_SUBSCRIPTION_BILLING_INTERVALS.includes(
+      value as FreebuffSubscriptionBillingInterval,
+    )
+  )
+}
+
 export interface FreebuffSubscriptionTier {
   id: FreebuffSubscriptionTierId
   displayName: string
   /** Every period after the first, in USD. */
   priceUsd: number
+  /** Annual charge in USD. Usage allowances still refresh monthly. */
+  yearlyPriceUsd: number
   /**
    * First billing period, in USD.
    *
@@ -199,6 +219,7 @@ export const FREEBUFF_SUBSCRIPTION_TIERS: readonly FreebuffSubscriptionTier[] =
       id: 'starter',
       displayName: 'Starter',
       priceUsd: 8,
+      yearlyPriceUsd: 75,
       introPriceUsd: 5,
       dailySessions: 3,
       fiveDaySessions: 10,
@@ -213,6 +234,7 @@ export const FREEBUFF_SUBSCRIPTION_TIERS: readonly FreebuffSubscriptionTier[] =
       id: 'plus',
       displayName: 'Plus',
       priceUsd: 25,
+      yearlyPriceUsd: 235,
       introPriceUsd: 19,
       dailySessions: 7,
       fiveDaySessions: 26,
@@ -224,6 +246,7 @@ export const FREEBUFF_SUBSCRIPTION_TIERS: readonly FreebuffSubscriptionTier[] =
       id: 'pro',
       displayName: 'Pro',
       priceUsd: 60,
+      yearlyPriceUsd: 560,
       introPriceUsd: 45,
       dailySessions: 11,
       fiveDaySessions: 66,

common/src/constants/freebuff-subscriptions.ts

@@ -71,6 +71,7 @@ export interface FreebuffSubscriptionTierOffer {
   id: string
   displayName: string
   priceUsd: number
+  yearlyPriceUsd?: number
   /** What this caller would actually be charged for the first period —
    *  `introPriceUsd` only while the account has never used its intro. */
   firstPeriodPriceUsd: number
@@ -89,6 +90,10 @@ export interface FreebuffSubscriptionTierOffer {
   /** True when it is below. A downgrade is SCHEDULED for the next renewal
    *  rather than applied now, so clients must not word it as immediate. */
   downgrade: boolean
+  /** Whether the monthly Stripe price is configured. Optional on old servers. */
+  purchasable?: boolean
+  /** Annual checkout remains unavailable until its Stripe price is configured. */
+  yearlyPurchasable?: boolean
 }
 
 /**
@@ -317,6 +322,12 @@ export interface FreebuffPriceChange {
 export interface FreebuffSubscriptionInfo {
   /** The caller's tier id, or null when they have no live subscription. */
   tierId: string | null
+  /** Entitlement origin. Optional for compatibility with older servers. */
+  source?: 'stripe' | 'grant'
+  /** Billing cadence for the live plan. Absent on legacy server payloads. */
+  billingInterval?: 'monthly' | 'yearly'
+  /** Stripe paid-through/renewal instant, distinct from monthly usage reset. */
+  renewsAt?: string
   /** Present only while subscribed. */
   usage?: FreebuffSubscriptionUsage
   /** Raw Stripe status, so a client can surface a failed payment. */