@hed-hog/billing 0.0.2

package/src/billing-payments.controller.ts

@@ -0,0 +1,20 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import { Controller, Get, Param, ParseIntPipe } from '@nestjs/common';
+import { BillingService } from './billing.service';
+
+@Role()
+@Controller('billing')
+export class BillingPaymentsController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('payments')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listPayments(paginationParams);
+  }
+
+  @Get('payments/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getPayment(id);
+  }
+}

package/src/billing-prices.controller.ts

@@ -0,0 +1,46 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import {
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+} from '@nestjs/common';
+import { BillingService } from './billing.service';
+import { CreatePriceDto } from './dto/create-price.dto';
+import { UpdatePriceDto } from './dto/update-price.dto';
+
+@Role()
+@Controller('billing')
+export class BillingPricesController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('prices')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listPrices(paginationParams);
+  }
+
+  @Get('prices/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getPrice(id);
+  }
+
+  @Post('prices')
+  create(@Body() dto: CreatePriceDto) {
+    return this.billingService.createPrice(dto);
+  }
+
+  @Patch('prices/:id')
+  update(@Param('id', ParseIntPipe) id: number, @Body() dto: UpdatePriceDto) {
+    return this.billingService.updatePrice(id, dto);
+  }
+
+  @Delete('prices/:id')
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.deletePrice(id);
+  }
+}

package/src/billing-products.controller.ts

@@ -0,0 +1,46 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import {
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+} from '@nestjs/common';
+import { BillingService } from './billing.service';
+import { CreateProductDto } from './dto/create-product.dto';
+import { UpdateProductDto } from './dto/update-product.dto';
+
+@Role()
+@Controller('billing')
+export class BillingProductsController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('products')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listProducts(paginationParams);
+  }
+
+  @Get('products/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getProduct(id);
+  }
+
+  @Post('products')
+  create(@Body() dto: CreateProductDto) {
+    return this.billingService.createProduct(dto);
+  }
+
+  @Patch('products/:id')
+  update(@Param('id', ParseIntPipe) id: number, @Body() dto: UpdateProductDto) {
+    return this.billingService.updateProduct(id, dto);
+  }
+
+  @Delete('products/:id')
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.deleteProduct(id);
+  }
+}

package/src/billing-refunds.controller.ts

@@ -0,0 +1,15 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import { Controller, Get } from '@nestjs/common';
+import { BillingService } from './billing.service';
+
+@Role()
+@Controller('billing')
+export class BillingRefundsController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('refunds')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listRefunds(paginationParams);
+  }
+}

package/src/billing-subscriptions.controller.ts

@@ -0,0 +1,49 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import {
+    Body,
+    Controller,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+} from '@nestjs/common';
+import { BillingService } from './billing.service';
+import { CreateSubscriptionDto } from './dto/create-subscription.dto';
+
+@Role()
+@Controller('billing')
+export class BillingSubscriptionsController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('subscriptions')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listSubscriptions(paginationParams);
+  }
+
+  @Get('subscriptions/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getSubscription(id);
+  }
+
+  @Post('subscriptions')
+  create(@Body() dto: CreateSubscriptionDto) {
+    return this.billingService.createSubscription(dto);
+  }
+
+  @Patch('subscriptions/:id/cancel')
+  cancel(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.cancelSubscription(id);
+  }
+
+  @Patch('subscriptions/:id/pause')
+  pause(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.pauseSubscription(id);
+  }
+
+  @Patch('subscriptions/:id/resume')
+  resume(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.resumeSubscription(id);
+  }
+}

package/src/billing-webhooks.controller.ts

@@ -0,0 +1,15 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import { Controller, Get } from '@nestjs/common';
+import { BillingService } from './billing.service';
+
+@Role()
+@Controller('billing')
+export class BillingWebhooksController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('webhooks')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listWebhooks(paginationParams);
+  }
+}

package/src/billing.module.ts

@@ -0,0 +1,48 @@
+import { LocaleModule } from '@hed-hog/api-locale';
+import { PaginationModule } from '@hed-hog/api-pagination';
+import { PrismaModule } from '@hed-hog/api-prisma';
+import { forwardRef, Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { BillingContractsController } from './billing-contracts.controller';
+import { BillingCouponsController } from './billing-coupons.controller';
+import { BillingDashboardController } from './billing-dashboard.controller';
+import { BillingEntitlementsController } from './billing-entitlements.controller';
+import { BillingGatewaysController } from './billing-gateways.controller';
+import { BillingInvoicesController } from './billing-invoices.controller';
+import { BillingOffersController } from './billing-offers.controller';
+import { BillingOrdersController } from './billing-orders.controller';
+import { BillingPaymentsController } from './billing-payments.controller';
+import { BillingPricesController } from './billing-prices.controller';
+import { BillingProductsController } from './billing-products.controller';
+import { BillingRefundsController } from './billing-refunds.controller';
+import { BillingSubscriptionsController } from './billing-subscriptions.controller';
+import { BillingWebhooksController } from './billing-webhooks.controller';
+import { BillingService } from './billing.service';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot(),
+    forwardRef(() => PaginationModule),
+    forwardRef(() => PrismaModule),
+    forwardRef(() => LocaleModule),
+  ],
+  controllers: [
+    BillingDashboardController,
+    BillingProductsController,
+    BillingPricesController,
+    BillingOffersController,
+    BillingCouponsController,
+    BillingOrdersController,
+    BillingSubscriptionsController,
+    BillingInvoicesController,
+    BillingPaymentsController,
+    BillingRefundsController,
+    BillingEntitlementsController,
+    BillingContractsController,
+    BillingGatewaysController,
+    BillingWebhooksController,
+  ],
+  providers: [BillingService],
+  exports: [BillingService],
+})
+export class BillingModule {}

package/src/billing.service.ts

@@ -0,0 +1,391 @@
+import { PaginationDTO, PaginationService } from '@hed-hog/api-pagination';
+import { PrismaService } from '@hed-hog/api-prisma';
+import { Injectable, NotFoundException } from '@nestjs/common';
+import { CreateContractDto } from './dto/create-contract.dto';
+import { CreateCouponDto } from './dto/create-coupon.dto';
+import { CreateEntitlementDto } from './dto/create-entitlement.dto';
+import { CreateOfferDto } from './dto/create-offer.dto';
+import { CreateOrderDto } from './dto/create-order.dto';
+import { CreatePriceDto } from './dto/create-price.dto';
+import { CreateProductDto } from './dto/create-product.dto';
+import { CreateSubscriptionDto } from './dto/create-subscription.dto';
+import { UpdateContractDto } from './dto/update-contract.dto';
+import { UpdateOfferDto } from './dto/update-offer.dto';
+import { UpdatePriceDto } from './dto/update-price.dto';
+import { UpdateProductDto } from './dto/update-product.dto';
+
+@Injectable()
+export class BillingService {
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly paginationService: PaginationService,
+  ) {}
+
+  // ─── Products ─────────────────────────────────────────────────────────────
+
+  async listProducts(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_product,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  async getProduct(id: number) {
+    const product = await this.prisma.billing_product.findUnique({
+      where: { id },
+      include: { billing_price: true },
+    });
+    if (!product) throw new NotFoundException('Product not found');
+    return product;
+  }
+
+  async createProduct(data: CreateProductDto) {
+    return this.prisma.billing_product.create({ data });
+  }
+
+  async updateProduct(id: number, data: UpdateProductDto) {
+    return this.prisma.billing_product.update({ where: { id }, data });
+  }
+
+  async deleteProduct(id: number) {
+    return this.prisma.billing_product.delete({ where: { id } });
+  }
+
+  // ─── Prices ───────────────────────────────────────────────────────────────
+
+  async listPrices(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_price,
+      paginationParams,
+      {
+        include: { billing_product: { select: { id: true, name: true } } },
+        orderBy: { created_at: 'desc' },
+      },
+    );
+  }
+
+  async getPrice(id: number) {
+    const price = await this.prisma.billing_price.findUnique({
+      where: { id },
+      include: { billing_product: true },
+    });
+    if (!price) throw new NotFoundException('Price not found');
+    return price;
+  }
+
+  async createPrice(data: CreatePriceDto) {
+    return this.prisma.billing_price.create({ data });
+  }
+
+  async updatePrice(id: number, data: UpdatePriceDto) {
+    return this.prisma.billing_price.update({ where: { id }, data });
+  }
+
+  async deletePrice(id: number) {
+    return this.prisma.billing_price.delete({ where: { id } });
+  }
+
+  // ─── Offers ───────────────────────────────────────────────────────────────
+
+  async listOffers(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_offer,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  async getOffer(id: number) {
+    const offer = await this.prisma.billing_offer.findUnique({
+      where: { id },
+      include: { billing_offer_price: { include: { billing_price: true } } },
+    });
+    if (!offer) throw new NotFoundException('Offer not found');
+    return offer;
+  }
+
+  async createOffer(data: CreateOfferDto) {
+    return this.prisma.billing_offer.create({ data });
+  }
+
+  async updateOffer(id: number, data: UpdateOfferDto) {
+    return this.prisma.billing_offer.update({ where: { id }, data });
+  }
+
+  async deleteOffer(id: number) {
+    return this.prisma.billing_offer.delete({ where: { id } });
+  }
+
+  // ─── Coupons ──────────────────────────────────────────────────────────────
+
+  async listCoupons(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_coupon,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  async getCoupon(id: number) {
+    const coupon = await this.prisma.billing_coupon.findUnique({ where: { id } });
+    if (!coupon) throw new NotFoundException('Coupon not found');
+    return coupon;
+  }
+
+  async createCoupon(data: CreateCouponDto) {
+    return this.prisma.billing_coupon.create({ data });
+  }
+
+  async updateCoupon(id: number, data: Partial<CreateCouponDto>) {
+    return this.prisma.billing_coupon.update({ where: { id }, data });
+  }
+
+  async deleteCoupon(id: number) {
+    return this.prisma.billing_coupon.delete({ where: { id } });
+  }
+
+  // ─── Orders ───────────────────────────────────────────────────────────────
+
+  async listOrders(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_order,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  async getOrder(id: number) {
+    const order = await this.prisma.billing_order.findUnique({
+      where: { id },
+      include: { billing_order_item: true },
+    });
+    if (!order) throw new NotFoundException('Order not found');
+    return order;
+  }
+
+  async createOrder(data: CreateOrderDto) {
+    return this.prisma.billing_order.create({ data });
+  }
+
+  // ─── Subscriptions ────────────────────────────────────────────────────────
+
+  async listSubscriptions(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_subscription,
+      paginationParams,
+      {
+        include: {
+          billing_product: { select: { id: true, name: true } },
+          billing_price: { select: { id: true, name: true, amount_cents: true, interval_unit: true } },
+        },
+        orderBy: { created_at: 'desc' },
+      },
+    );
+  }
+
+  async getSubscription(id: number) {
+    const sub = await this.prisma.billing_subscription.findUnique({
+      where: { id },
+      include: {
+        billing_product: true,
+        billing_price: true,
+        billing_subscription_item: true,
+        billing_invoice: { take: 5, orderBy: { created_at: 'desc' } },
+      },
+    });
+    if (!sub) throw new NotFoundException('Subscription not found');
+    return sub;
+  }
+
+  async createSubscription(data: CreateSubscriptionDto) {
+    return this.prisma.billing_subscription.create({ data });
+  }
+
+  async cancelSubscription(id: number) {
+    return this.prisma.billing_subscription.update({
+      where: { id },
+      data: { status: 'canceled', canceled_at: new Date() },
+    });
+  }
+
+  async pauseSubscription(id: number) {
+    return this.prisma.billing_subscription.update({
+      where: { id },
+      data: { status: 'paused' },
+    });
+  }
+
+  async resumeSubscription(id: number) {
+    return this.prisma.billing_subscription.update({
+      where: { id },
+      data: { status: 'active' },
+    });
+  }
+
+  // ─── Invoices ─────────────────────────────────────────────────────────────
+
+  async listInvoices(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_invoice,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  async getInvoice(id: number) {
+    const invoice = await this.prisma.billing_invoice.findUnique({
+      where: { id },
+      include: { billing_invoice_item: true, billing_payment: { take: 5 } },
+    });
+    if (!invoice) throw new NotFoundException('Invoice not found');
+    return invoice;
+  }
+
+  async createInvoice(data: Record<string, unknown>) {
+    return this.prisma.billing_invoice.create({ data: data as any });
+  }
+
+  // ─── Payments ─────────────────────────────────────────────────────────────
+
+  async listPayments(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_payment,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  async getPayment(id: number) {
+    const payment = await this.prisma.billing_payment.findUnique({ where: { id } });
+    if (!payment) throw new NotFoundException('Payment not found');
+    return payment;
+  }
+
+  // ─── Refunds ──────────────────────────────────────────────────────────────
+
+  async listRefunds(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_refund,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  // ─── Entitlements ─────────────────────────────────────────────────────────
+
+  async listEntitlements(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_entitlement,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  async createEntitlement(data: CreateEntitlementDto) {
+    return this.prisma.billing_entitlement.create({ data });
+  }
+
+  async deleteEntitlement(id: number) {
+    return this.prisma.billing_entitlement.update({
+      where: { id },
+      data: { status: 'revoked' },
+    });
+  }
+
+  // ─── Contracts ────────────────────────────────────────────────────────────
+
+  async listContracts(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_contract,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  async getContract(id: number) {
+    const contract = await this.prisma.billing_contract.findUnique({
+      where: { id },
+      include: {
+        billing_contract_seat: { include: { billing_product: true } },
+        billing_seat_allocation: true,
+      },
+    });
+    if (!contract) throw new NotFoundException('Contract not found');
+    return contract;
+  }
+
+  async createContract(data: CreateContractDto) {
+    return this.prisma.billing_contract.create({ data });
+  }
+
+  async updateContract(id: number, data: UpdateContractDto) {
+    return this.prisma.billing_contract.update({ where: { id }, data });
+  }
+
+  async deleteContract(id: number) {
+    return this.prisma.billing_contract.delete({ where: { id } });
+  }
+
+  // ─── Gateways ─────────────────────────────────────────────────────────────
+
+  async listGateways() {
+    return this.prisma.billing_payment_provider.findMany({
+      orderBy: { name: 'asc' },
+    });
+  }
+
+  async updateGateway(slug: string, data: Record<string, unknown>) {
+    return this.prisma.billing_payment_provider.upsert({
+      where: { slug },
+      update: data as any,
+      create: { slug, name: slug, ...data } as any,
+    });
+  }
+
+  // ─── Webhooks ─────────────────────────────────────────────────────────────
+
+  async listWebhooks(paginationParams: PaginationDTO) {
+    return this.paginationService.paginate(
+      this.prisma.billing_provider_event,
+      paginationParams,
+      { orderBy: { created_at: 'desc' } },
+    );
+  }
+
+  // ─── Dashboard ────────────────────────────────────────────────────────────
+
+  async getDashboardData() {
+    const [
+      activeSubscriptions,
+      failedPayments,
+      overdueInvoices,
+      recentPayments,
+    ] = await Promise.all([
+      this.prisma.billing_subscription.count({ where: { status: 'active' } }),
+      this.prisma.billing_payment.count({ where: { status: 'failed' } }),
+      this.prisma.billing_invoice.count({ where: { status: 'open' } }),
+      this.prisma.billing_payment.findMany({
+        where: { status: 'paid' },
+        orderBy: { paid_at: 'desc' },
+        take: 10,
+      }),
+    ]);
+
+    const paidThisMonth = await this.prisma.billing_payment.aggregate({
+      where: {
+        status: 'paid',
+        paid_at: { gte: new Date(new Date().getFullYear(), new Date().getMonth(), 1) },
+      },
+      _sum: { amount_cents: true },
+    });
+
+    return {
+      activeSubscriptions,
+      failedPayments,
+      overdueInvoices,
+      revenueThisMonthCents: paidThisMonth._sum.amount_cents ?? 0,
+      recentPayments,
+    };
+  }
+}

package/src/dto/create-contract.dto.ts

@@ -0,0 +1,30 @@
+import { IsEnum, IsNumber, IsOptional, IsString } from 'class-validator';
+
+export class CreateContractDto {
+  @IsNumber()
+  contact_id: number;
+
+  @IsString()
+  name: string;
+
+  @IsOptional()
+  @IsString()
+  description?: string;
+
+  @IsString()
+  starts_at: string;
+
+  @IsOptional()
+  ends_at?: string;
+
+  @IsOptional()
+  @IsNumber()
+  total_seats?: number;
+
+  @IsOptional()
+  @IsEnum(['draft', 'active', 'expired', 'terminated'])
+  status?: string;
+
+  @IsOptional()
+  signed_at?: string;
+}