Subscription backend (#423)

Author: jahooma

.env.example

@@ -18,6 +18,9 @@ STRIPE_SECRET_KEY=sk_test_dummy_stripe_secret
 STRIPE_WEBHOOK_SECRET_KEY=whsec_dummy_webhook_secret
 STRIPE_USAGE_PRICE_ID=price_dummy_usage_id
 STRIPE_TEAM_FEE_PRICE_ID=price_dummy_team_fee_id
+STRIPE_SUBSCRIPTION_100_PRICE_ID=price_dummy_subscription_100_id
+STRIPE_SUBSCRIPTION_200_PRICE_ID=price_dummy_subscription_200_id
+STRIPE_SUBSCRIPTION_500_PRICE_ID=price_dummy_subscription_500_id
 
 # External Services
 LINKUP_API_KEY=dummy_linkup_key

common/src/constants/analytics-events.ts

@@ -30,6 +30,16 @@ export enum AnalyticsEvent {
   ADVISORY_LOCK_CONTENTION = 'backend.advisory_lock_contention',
   TRANSACTION_RETRY_THRESHOLD_EXCEEDED = 'backend.transaction_retry_threshold_exceeded',
 
+  // Backend - Subscription
+  SUBSCRIPTION_CREATED = 'backend.subscription_created',
+  SUBSCRIPTION_CANCELED = 'backend.subscription_canceled',
+  SUBSCRIPTION_PAYMENT_FAILED = 'backend.subscription_payment_failed',
+  SUBSCRIPTION_BLOCK_CREATED = 'backend.subscription_block_created',
+  SUBSCRIPTION_BLOCK_LIMIT_HIT = 'backend.subscription_block_limit_hit',
+  SUBSCRIPTION_WEEKLY_LIMIT_HIT = 'backend.subscription_weekly_limit_hit',
+  SUBSCRIPTION_CREDITS_MIGRATED = 'backend.subscription_credits_migrated',
+  SUBSCRIPTION_TIER_CHANGED = 'backend.subscription_tier_changed',
+
   // Web
   SIGNUP = 'web.signup',
 

common/src/constants/grant-priorities.ts

@@ -1,6 +1,7 @@
 import type { GrantType } from '@codebuff/common/types/grant'
 
 export const GRANT_PRIORITIES: Record<GrantType, number> = {
+  subscription: 10,
   free: 20,
   referral: 30,
   ad: 40,

common/src/constants/subscription-plans.ts

@@ -0,0 +1,49 @@
+export const SUBSCRIPTION_DISPLAY_NAME = 'Strong' as const
+
+export interface TierConfig {
+  monthlyPrice: number
+  creditsPerBlock: number
+  blockDurationHours: number
+  weeklyCreditsLimit: number
+}
+
+export const SUBSCRIPTION_TIERS = {
+  100: {
+    monthlyPrice: 100,
+    creditsPerBlock: 400,
+    blockDurationHours: 5,
+    weeklyCreditsLimit: 4000,
+  },
+  200: {
+    monthlyPrice: 200,
+    creditsPerBlock: 1200,
+    blockDurationHours: 5,
+    weeklyCreditsLimit: 12000,
+  },
+  500: {
+    monthlyPrice: 500,
+    creditsPerBlock: 3200,
+    blockDurationHours: 5,
+    weeklyCreditsLimit: 32000,
+  },
+} as const satisfies Record<number, TierConfig>
+
+export type SubscriptionTierPrice = keyof typeof SUBSCRIPTION_TIERS
+
+export const DEFAULT_TIER = SUBSCRIPTION_TIERS[200]
+
+export function createSubscriptionPriceMappings(priceIds: Record<SubscriptionTierPrice, string>) {
+  const priceToTier = Object.fromEntries(
+    Object.entries(priceIds).map(([tier, priceId]) => [priceId, Number(tier) as SubscriptionTierPrice]),
+  ) as Record<string, SubscriptionTierPrice>
+
+  function getTierFromPriceId(priceId: string): SubscriptionTierPrice | null {
+    return priceToTier[priceId] ?? null
+  }
+
+  function getPriceIdFromTier(tier: SubscriptionTierPrice): string | null {
+    return priceIds[tier] ?? null
+  }
+
+  return { getTierFromPriceId, getPriceIdFromTier }
+}

common/src/types/grant.ts

@@ -1,6 +1,7 @@
 export type GrantType =
   | 'free'
   | 'referral'
+  | 'subscription'
   | 'purchase'
   | 'admin'
   | 'organization'
@@ -9,6 +10,7 @@ export type GrantType =
 export const GrantTypeValues = [
   'free',
   'referral',
+  'subscription',
   'purchase',
   'admin',
   'organization',