* 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: [email protected] <[email protected]> * 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: [email protected] <[email protected]> * 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: [email protected] <[email protected]> * 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: [email protected] <[email protected]> * 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: [email protected] <[email protected]> * feat: handle cancel and reschedule usage * fix: restore IsUserInBillingOrg to billing module providers Co-Authored-By: [email protected] <[email protected]> * 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>
112 lines
3.3 KiB
TypeScript
112 lines
3.3 KiB
TypeScript
import type Stripe from "stripe";
|
|
|
|
import { SubscriptionStatus } from "../../repository/billing/IBillingRepository";
|
|
|
|
export interface IBillingProviderService {
|
|
checkoutSessionIsPaid(paymentId: string): Promise<boolean>;
|
|
handleSubscriptionCancel(subscriptionId: string): Promise<void>;
|
|
handleSubscriptionCreation(subscriptionId: string): Promise<void>;
|
|
handleSubscriptionUpdate(args: {
|
|
subscriptionId: string;
|
|
subscriptionItemId: string;
|
|
membershipCount: number;
|
|
}): Promise<void>;
|
|
handleEndTrial(subscriptionId: string): Promise<void>;
|
|
|
|
// Customer management
|
|
createCustomer(args: {
|
|
email: string;
|
|
metadata?: Record<string, string>;
|
|
}): Promise<{ stripeCustomerId: string }>;
|
|
createPaymentIntent(args: {
|
|
customerId: string;
|
|
amount: number;
|
|
metadata?: Record<string, string | number>;
|
|
}): Promise<{ id: string; client_secret: string | null }>;
|
|
|
|
// Subscription management
|
|
createSubscriptionCheckout(args: {
|
|
customerId: string;
|
|
successUrl: string;
|
|
cancelUrl: string;
|
|
priceId: string;
|
|
quantity: number;
|
|
metadata?: Record<string, string | number>;
|
|
mode?: "subscription" | "setup" | "payment";
|
|
allowPromotionCodes?: boolean;
|
|
customerUpdate?: {
|
|
address?: "auto" | "never";
|
|
};
|
|
automaticTax?: {
|
|
enabled: boolean;
|
|
};
|
|
discounts?: Array<{
|
|
coupon: string;
|
|
}>;
|
|
subscriptionData?: {
|
|
metadata?: Record<string, string | number>;
|
|
trial_period_days?: number;
|
|
};
|
|
}): Promise<{ checkoutUrl: string | null; sessionId: string }>;
|
|
|
|
// Price management
|
|
createPrice(args: {
|
|
amount: number;
|
|
currency: string;
|
|
interval: "month" | "year";
|
|
nickname?: string;
|
|
productId: string;
|
|
metadata?: Record<string, string | number>;
|
|
}): Promise<{ priceId: string }>;
|
|
getPrice(priceId: string): Promise<Stripe.Price | null>;
|
|
getSubscriptionStatus(subscriptionId: string): Promise<SubscriptionStatus | null>;
|
|
|
|
getCheckoutSession(checkoutSessionId: string): Promise<Stripe.Checkout.Session | null>;
|
|
getCustomer(customerId: string): Promise<Stripe.Customer | Stripe.DeletedCustomer | null>;
|
|
getSubscriptions(customerId: string): Promise<Stripe.Subscription[] | null>;
|
|
updateCustomer(args: { customerId: string; email: string; userId?: number }): Promise<void>;
|
|
|
|
// Invoice management
|
|
createInvoiceItem(args: {
|
|
customerId: string;
|
|
amount: number;
|
|
currency: string;
|
|
description: string;
|
|
metadata?: Record<string, string>;
|
|
}): Promise<{ invoiceItemId: string }>;
|
|
|
|
createInvoice(args: {
|
|
customerId: string;
|
|
autoAdvance: boolean;
|
|
metadata?: Record<string, string>;
|
|
}): Promise<{ invoiceId: string }>;
|
|
|
|
finalizeInvoice(invoiceId: string): Promise<void>;
|
|
|
|
// Usage-based billing
|
|
createSubscriptionUsageRecord(args: {
|
|
subscriptionId: string;
|
|
action: "increment" | "set";
|
|
quantity: number;
|
|
}): Promise<void>;
|
|
|
|
// Subscription queries
|
|
getSubscription(subscriptionId: string): Promise<{
|
|
items: Array<{
|
|
id: string;
|
|
quantity: number;
|
|
price: {
|
|
unit_amount: number | null;
|
|
recurring: {
|
|
interval: string;
|
|
} | null;
|
|
};
|
|
}>;
|
|
customer: string;
|
|
status: string;
|
|
current_period_start: number;
|
|
current_period_end: number;
|
|
trial_end: number | null;
|
|
} | null>;
|
|
}
|