Initial backend impl

Author: jahooma

common/src/constants/analytics-events.ts

@@ -30,6 +30,15 @@ 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',
+
   // 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,26 @@
+export const PLAN_NAMES = ['pro'] as const
+export type PlanName = (typeof PLAN_NAMES)[number]
+
+export interface PlanConfig {
+  name: PlanName
+  displayName: string
+  monthlyPrice: number
+  creditsPerBlock: number
+  blockDurationHours: number
+  weeklyCreditsLimit: number
+}
+
+export const PLANS = {
+  pro: {
+    name: 'pro',
+    displayName: 'Pro',
+    monthlyPrice: 200,
+    creditsPerBlock: 1250,
+    blockDurationHours: 5,
+    weeklyCreditsLimit: 15000,
+  },
+} as const satisfies Record<PlanName, PlanConfig>
+
+export function isPlanName(name: string): name is PlanName {
+  return (PLAN_NAMES as readonly string[]).includes(name)
+}

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',

packages/billing/src/__tests__/usage-service.test.ts

@@ -19,8 +19,8 @@ const mockBalance = {
   totalRemaining: 1000,
   totalDebt: 0,
   netBalance: 1000,
-  breakdown: { free: 500, paid: 500, referral: 0, purchase: 0, admin: 0, organization: 0, ad: 0 },
-  principals: { free: 500, paid: 500, referral: 0, purchase: 0, admin: 0, organization: 0, ad: 0 },
+  breakdown: { free: 500, referral: 0, subscription: 0, purchase: 500, admin: 0, organization: 0, ad: 0 },
+  principals: { free: 500, referral: 0, subscription: 0, purchase: 500, admin: 0, organization: 0, ad: 0 },
 }
 
 describe('usage-service', () => {

packages/billing/src/index.ts

@@ -19,5 +19,11 @@ export * from './usage-service'
 // Credit delegation
 export * from './credit-delegation'
 
+// Subscription
+export * from './subscription'
+
+// Subscription webhooks
+export * from './subscription-webhooks'
+
 // Utilities
 export * from './utils'