feat: add PlatformOrganizationBillingTasker with sync and trigger.dev versions (calcom#26803)

* feat: add PlatformOrganizationBillingTasker with sync and trigger.dev versions

- Create PlatformOrganizationBillingTasker extending Tasker base class
- Add sync tasker (PlatformOrganizationBillingSyncTasker) for synchronous execution
- Add trigger.dev tasker (PlatformOrganizationBillingTriggerTasker) for async execution
- Create trigger.dev task for incrementing subscription usage
- Add PlatformOrganizationBillingTaskService with business logic
- Add PlatformOrganizationBillingRepository for data access
- Add createSubscriptionUsageRecord method to StripeBillingService
- Follow BookingEmailAndSmsTasker pattern for consistency

Co-Authored-By: morgan@cal.com <morgan@cal.com>

* refactor: move repository methods per PR feedback

- Move findPlatformOrgByUserId to OrganizationRepository
- Create new PlatformBillingRepository for billing queries
- Remove PlatformOrganizationBillingRepository (consolidated)
- Update task service and trigger.dev task to use new repositories

Co-Authored-By: morgan@cal.com <morgan@cal.com>

* feat: add DI using @evyweb/ioctopus for platform billing tasker

- Create di/tasker/ directory following BookingEmailAndSmsTasker pattern
- Add tokens.ts with DI tokens for all billing tasker classes
- Add module files for PlatformBillingRepository, TaskService, SyncTasker, TriggerTasker, Tasker
- Add container files with getter functions
- Update trigger.dev task to use DI container instead of manual instantiation

Co-Authored-By: morgan@cal.com <morgan@cal.com>

* refactor: add select statement to PlatformBillingRepository.findByTeamId

Only select subscriptionId field since that's the only field used by the task service

Co-Authored-By: morgan@cal.com <morgan@cal.com>

* feat: add NestJS DI modules for platform billing tasker in API v2

- Add platform billing tasker exports to platform-libraries/organizations.ts
- Export IBillingProviderService type from platform-libraries
- Create StripeBillingProviderService wrapper implementing IBillingProviderService
- Create PrismaPlatformBillingRepository extending PlatformBillingRepository
- Create NestJS service wrappers for all platform billing tasker classes
- Create PlatformBillingTaskerModule with all providers and exports
- Update PlatformOrganizationBillingTaskService to use Pick<IBillingProviderService>

Co-Authored-By: morgan@cal.com <morgan@cal.com>

* feat: handle cancel and reschedule usage

* fix: restore IsUserInBillingOrg to billing module providers

Co-Authored-By: morgan@cal.com <morgan@cal.com>

* chore: add idempotency key

* fix: just log error]

* fix: logger and typo

* fix: address Cubic AI review feedback (high confidence issues)

- Fix grammar error: 'Delayed task are' -> 'Delayed tasks are' in PlatformOrganizationBillingSyncTasker.ts (3 occurrences)
- Re-throw error after logging in increment-usage.ts to enable trigger.dev retry mechanism

Co-Authored-By: unknown <>

* fix: remove duplicate code and use DI instead

* fix: remove orThrow on find first in findPlatformOrgByUserId

* refactor: prevent usage increment task from re-throwing errors

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Author: ThyMinimalDev

apps/api/v2/src/config/app.ts

@@ -47,6 +47,8 @@ const loadConfig = (): AppConfig => {
     e2e: getEnv("IS_E2E", "false") === "true",
     enableSlotsWorkers: getEnv("ENABLE_SLOTS_WORKERS", "true") === "true",
     slotsWorkerPoolSize: Number(getEnv("SLOTS_WORKER_POOL_SIZE", "4")),
+    vercel: getEnv("VERCEL", "false") === "true",
+    enableAsyncTasker: getEnv("ENABLE_ASYNC_TASKER", "false") === "true",
   };
 };
 

apps/api/v2/src/config/type.ts

@@ -35,4 +35,6 @@ export type AppConfig = {
   e2e: boolean;
   enableSlotsWorkers: boolean;
   slotsWorkerPoolSize: number;
+  vercel: boolean;
+  enableAsyncTasker: boolean;
 };

apps/api/v2/src/env.ts

@@ -41,6 +41,8 @@ export type Environment = {
   ENABLE_SLOTS_WORKERS: string;
   SLOTS_WORKER_POOL_SIZE: string;
   USE_POOL: string;
+  VERCEL: string;
+  ENABLE_ASYNC_TASKER: string;
 };
 
 export const getEnv = <K extends keyof Environment>(key: K, fallback?: Environment[K]): Environment[K] => {

apps/api/v2/src/lib/modules/platform-billing-tasker.module.ts

@@ -0,0 +1,32 @@
+import { Module, Scope } from "@nestjs/common";
+import { Logger } from "@/lib/logger.bridge";
+import { PrismaPlatformBillingRepository } from "@/lib/repositories/prisma-platform-billing.repository";
+import { StripeBillingProviderService } from "@/lib/services/stripe-billing-provider.service";
+import { PlatformBillingSyncTaskerService } from "@/lib/services/tasker/platform-billing-sync-tasker.service";
+import { PlatformBillingTaskService } from "@/lib/services/tasker/platform-billing-task.service";
+import { PlatformBillingTasker } from "@/lib/services/tasker/platform-billing-tasker.service";
+import { PlatformBillingTriggerTaskerService } from "@/lib/services/tasker/platform-billing-trigger-tasker.service";
+import { OrganizationsModule } from "@/modules/organizations/organizations.module";
+import { PrismaModule } from "@/modules/prisma/prisma.module";
+import { StripeModule } from "@/modules/stripe/stripe.module";
+
+@Module({
+  imports: [PrismaModule, StripeModule, OrganizationsModule],
+  providers: [
+    PrismaPlatformBillingRepository,
+    StripeBillingProviderService,
+    {
+      provide: Logger,
+      useFactory: () => {
+        return new Logger();
+      },
+      scope: Scope.TRANSIENT,
+    },
+    PlatformBillingTaskService,
+    PlatformBillingSyncTaskerService,
+    PlatformBillingTriggerTaskerService,
+    PlatformBillingTasker,
+  ],
+  exports: [PlatformBillingTasker],
+})
+export class PlatformBillingTaskerModule {}

apps/api/v2/src/lib/repositories/prisma-platform-billing.repository.ts

@@ -0,0 +1,12 @@
+import { PrismaWriteService } from "@/modules/prisma/prisma-write.service";
+import { Injectable } from "@nestjs/common";
+
+import { PlatformBillingRepository } from "@calcom/platform-libraries/organizations";
+import type { PrismaClient } from "@calcom/prisma";
+
+@Injectable()
+export class PrismaPlatformBillingRepository extends PlatformBillingRepository {
+  constructor(dbWrite: PrismaWriteService) {
+    super(dbWrite.prisma as unknown as PrismaClient);
+  }
+}

apps/api/v2/src/lib/services/stripe-billing-provider.service.ts

@@ -0,0 +1,14 @@
+import { StripeBillingService } from "@calcom/platform-libraries";
+import type { IBillingProviderService } from "@calcom/platform-libraries/organizations";
+import { Injectable } from "@nestjs/common";
+import { StripeService } from "@/modules/stripe/stripe.service";
+
+@Injectable()
+export class StripeBillingProviderService
+  extends StripeBillingService
+  implements Pick<IBillingProviderService, "createSubscriptionUsageRecord">
+{
+  constructor(readonly stripeService: StripeService) {
+    super(stripeService.getStripe());
+  }
+}

apps/api/v2/src/lib/services/tasker/platform-billing-sync-tasker.service.ts

@@ -0,0 +1,15 @@
+import { Logger } from "@/lib/logger.bridge";
+import { PlatformBillingTaskService } from "@/lib/services/tasker/platform-billing-task.service";
+import { Injectable } from "@nestjs/common";
+
+import { PlatformOrganizationBillingSyncTasker as BasePlatformOrganizationBillingSyncTasker } from "@calcom/platform-libraries/organizations";
+
+@Injectable()
+export class PlatformBillingSyncTaskerService extends BasePlatformOrganizationBillingSyncTasker {
+  constructor(billingTaskService: PlatformBillingTaskService, logger: Logger) {
+    super({
+      logger,
+      billingTaskService,
+    });
+  }
+}

apps/api/v2/src/lib/services/tasker/platform-billing-task.service.ts

@@ -0,0 +1,24 @@
+import { Logger } from "@/lib/logger.bridge";
+import { PrismaPlatformBillingRepository } from "@/lib/repositories/prisma-platform-billing.repository";
+import { StripeBillingProviderService } from "@/lib/services/stripe-billing-provider.service";
+import { OrganizationsRepository } from "@/modules/organizations/index/organizations.repository";
+import { Injectable } from "@nestjs/common";
+
+import { PlatformOrganizationBillingTaskService as BasePlatformOrganizationBillingTaskService } from "@calcom/platform-libraries/organizations";
+
+@Injectable()
+export class PlatformBillingTaskService extends BasePlatformOrganizationBillingTaskService {
+  constructor(
+    organizationRepository: OrganizationsRepository,
+    platformBillingRepository: PrismaPlatformBillingRepository,
+    billingProviderService: StripeBillingProviderService,
+    logger: Logger
+  ) {
+    super({
+      logger,
+      organizationRepository,
+      platformBillingRepository,
+      billingProviderService,
+    });
+  }
+}

apps/api/v2/src/lib/services/tasker/platform-billing-tasker.service.ts

@@ -0,0 +1,20 @@
+import { PlatformOrganizationBillingTasker as BasePlatformOrganizationBillingTasker } from "@calcom/platform-libraries/organizations";
+import { Injectable } from "@nestjs/common";
+import { Logger } from "@/lib/logger.bridge";
+import { PlatformBillingSyncTaskerService } from "@/lib/services/tasker/platform-billing-sync-tasker.service";
+import { PlatformBillingTriggerTaskerService } from "@/lib/services/tasker/platform-billing-trigger-tasker.service";
+
+@Injectable()
+export class PlatformBillingTasker extends BasePlatformOrganizationBillingTasker {
+  constructor(
+    syncTasker: PlatformBillingSyncTaskerService,
+    asyncTasker: PlatformBillingTriggerTaskerService,
+    logger: Logger
+  ) {
+    super({
+      logger,
+      asyncTasker: asyncTasker,
+      syncTasker: syncTasker,
+    });
+  }
+}

apps/api/v2/src/lib/services/tasker/platform-billing-trigger-tasker.service.ts

@@ -0,0 +1,13 @@
+import { Logger } from "@/lib/logger.bridge";
+import { Injectable } from "@nestjs/common";
+
+import { PlatformOrganizationBillingTriggerTasker as BasePlatformOrganizationBillingTriggerTasker } from "@calcom/platform-libraries/organizations";
+
+@Injectable()
+export class PlatformBillingTriggerTaskerService extends BasePlatformOrganizationBillingTriggerTasker {
+  constructor(logger: Logger) {
+    super({
+      logger,
+    });
+  }
+}