@hed-hog/billing 0.0.2

package/hedhog/table/billing_subscription.yaml

@@ -0,0 +1,66 @@
+columns:
+  - type: pk
+  - name: contact_id
+    type: fk
+    isNullable: true
+    references:
+      table: person
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: product_id
+    type: fk
+    isNullable: true
+    references:
+      table: billing_product
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: price_id
+    type: fk
+    isNullable: true
+    references:
+      table: billing_price
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
+  - name: gateway
+    type: varchar
+    length: 64
+    isNullable: true
+  - name: gateway_subscription_id
+    type: varchar
+    length: 255
+    isNullable: true
+  - name: status
+    type: enum
+    values: [trialing, active, past_due, canceled, paused, unpaid]
+    default: active
+  - name: started_at
+    type: datetime
+    isNullable: true
+  - name: trial_ends_at
+    type: datetime
+    isNullable: true
+  - name: current_period_start
+    type: datetime
+    isNullable: true
+  - name: current_period_end
+    type: datetime
+    isNullable: true
+  - name: cancel_at_period_end
+    type: boolean
+    default: false
+  - name: canceled_at
+    type: datetime
+    isNullable: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [contact_id]
+  - columns: [product_id]
+  - columns: [price_id]
+  - columns: [gateway]
+  - columns: [gateway_subscription_id]
+  - columns: [status]

package/hedhog/table/billing_subscription_event.yaml

@@ -0,0 +1,20 @@
+columns:
+  - type: pk
+  - name: subscription_id
+    type: fk
+    references:
+      table: billing_subscription
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: event_type
+    type: varchar
+    length: 120
+  - name: payload
+    type: text
+    isNullable: true
+  - type: created_at
+
+indices:
+  - columns: [subscription_id]
+  - columns: [event_type]

package/hedhog/table/billing_subscription_item.yaml

@@ -0,0 +1,29 @@
+columns:
+  - type: pk
+  - name: subscription_id
+    type: fk
+    references:
+      table: billing_subscription
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  - name: price_id
+    type: fk
+    references:
+      table: billing_price
+      column: id
+      onDelete: RESTRICT
+      onUpdate: CASCADE
+  - name: quantity
+    type: int
+    default: 1
+  - name: is_active
+    type: boolean
+    default: true
+  - type: created_at
+  - type: updated_at
+
+indices:
+  - columns: [subscription_id]
+  - columns: [price_id]
+  - columns: [is_active]

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@hed-hog/billing",
+  "version": "0.0.2",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@nestjs/common": "*",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11",
+    "@nestjs/jwt": "^11",
+    "@nestjs/mapped-types": "*",
+    "@hed-hog/api": "0.0.4",
+    "@hed-hog/api-locale": "0.0.13",
+    "@hed-hog/api-pagination": "0.0.6",
+    "@hed-hog/api-types": "0.0.1",
+    "@hed-hog/api-prisma": "0.0.5"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "hedhog"
+  ],
+  "scripts": {
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\"",
+    "prebuild": "pnpm exec ts-node ../../scripts/build-dependencies.ts libraries/billing",
+    "build": "tsc --project tsconfig.production.json",
+    "patch": "pnpm exec ts-node ../../scripts/patch.ts libraries/billing",
+    "prod": "pnpm run patch && pnpm run build && pnpm publish --access public --no-git-checks"
+  }
+}

package/src/adapters/billing-gateway-registry.ts

@@ -0,0 +1,23 @@
+import { Injectable } from '@nestjs/common';
+import { PaymentGatewayAdapter } from './payment-gateway.adapter';
+
+@Injectable()
+export class BillingGatewayRegistry {
+  private readonly registry = new Map<string, PaymentGatewayAdapter>();
+
+  register(slug: string, adapter: PaymentGatewayAdapter): void {
+    this.registry.set(slug, adapter);
+  }
+
+  getAdapter(slug: string): PaymentGatewayAdapter {
+    const adapter = this.registry.get(slug);
+    if (!adapter) {
+      throw new Error(`No payment gateway adapter registered for slug: ${slug}`);
+    }
+    return adapter;
+  }
+
+  listAdapters(): string[] {
+    return Array.from(this.registry.keys());
+  }
+}

package/src/adapters/mercadopago.adapter.ts

@@ -0,0 +1,66 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { PaymentGatewayAdapter } from './payment-gateway.adapter';
+
+@Injectable()
+export class MercadoPagoAdapter implements PaymentGatewayAdapter {
+  private readonly logger = new Logger(MercadoPagoAdapter.name);
+
+  async createCustomer(data: Record<string, unknown>) {
+    this.logger.log('MercadoPago: createCustomer', data);
+    return { id: `cust_mp_${Date.now()}`, ...data };
+  }
+
+  async createCheckoutSession(data: Record<string, unknown>) {
+    this.logger.log('MercadoPago: createCheckoutSession', data);
+    return { id: `pref_mp_${Date.now()}`, init_point: 'https://www.mercadopago.com.br/checkout/v1/redirect?pref_id=stub' };
+  }
+
+  async createSubscription(data: Record<string, unknown>) {
+    this.logger.log('MercadoPago: createSubscription', data);
+    return { id: `sub_mp_${Date.now()}`, status: 'authorized', ...data };
+  }
+
+  async cancelSubscription(externalId: string) {
+    this.logger.log('MercadoPago: cancelSubscription', externalId);
+    return { id: externalId, status: 'cancelled' };
+  }
+
+  async pauseSubscription(externalId: string) {
+    this.logger.log('MercadoPago: pauseSubscription', externalId);
+    return { id: externalId, status: 'paused' };
+  }
+
+  async resumeSubscription(externalId: string) {
+    this.logger.log('MercadoPago: resumeSubscription', externalId);
+    return { id: externalId, status: 'authorized' };
+  }
+
+  async createInvoice(data: Record<string, unknown>) {
+    this.logger.log('MercadoPago: createInvoice', data);
+    return { id: `inv_mp_${Date.now()}`, status: 'pending', ...data };
+  }
+
+  async chargeInvoice(externalInvoiceId: string) {
+    this.logger.log('MercadoPago: chargeInvoice', externalInvoiceId);
+    return { id: externalInvoiceId, status: 'approved' };
+  }
+
+  async refundPayment(externalTransactionId: string, amountCents?: number) {
+    this.logger.log('MercadoPago: refundPayment', { externalTransactionId, amountCents });
+    return { id: `ref_mp_${Date.now()}`, status: 'approved', amount: amountCents };
+  }
+
+  async parseWebhook(rawBody: string, _signature: string) {
+    return JSON.parse(rawBody);
+  }
+
+  async getPaymentStatus(externalId: string) {
+    this.logger.log('MercadoPago: getPaymentStatus', externalId);
+    return 'approved';
+  }
+
+  async getSubscriptionStatus(externalId: string) {
+    this.logger.log('MercadoPago: getSubscriptionStatus', externalId);
+    return 'authorized';
+  }
+}

package/src/adapters/pagarme.adapter.ts

@@ -0,0 +1,66 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { PaymentGatewayAdapter } from './payment-gateway.adapter';
+
+@Injectable()
+export class PagarmeAdapter implements PaymentGatewayAdapter {
+  private readonly logger = new Logger(PagarmeAdapter.name);
+
+  async createCustomer(data: Record<string, unknown>) {
+    this.logger.log('Pagarme: createCustomer', data);
+    return { id: `cus_pagar_${Date.now()}`, ...data };
+  }
+
+  async createCheckoutSession(data: Record<string, unknown>) {
+    this.logger.log('Pagarme: createCheckoutSession', data);
+    return { id: `order_pagar_${Date.now()}`, payment_url: 'https://api.pagar.me/stub' };
+  }
+
+  async createSubscription(data: Record<string, unknown>) {
+    this.logger.log('Pagarme: createSubscription', data);
+    return { id: `sub_pagar_${Date.now()}`, status: 'active', ...data };
+  }
+
+  async cancelSubscription(externalId: string) {
+    this.logger.log('Pagarme: cancelSubscription', externalId);
+    return { id: externalId, status: 'canceled' };
+  }
+
+  async pauseSubscription(externalId: string) {
+    this.logger.log('Pagarme: pauseSubscription', externalId);
+    return { id: externalId, status: 'paused' };
+  }
+
+  async resumeSubscription(externalId: string) {
+    this.logger.log('Pagarme: resumeSubscription', externalId);
+    return { id: externalId, status: 'active' };
+  }
+
+  async createInvoice(data: Record<string, unknown>) {
+    this.logger.log('Pagarme: createInvoice', data);
+    return { id: `inv_pagar_${Date.now()}`, status: 'pending', ...data };
+  }
+
+  async chargeInvoice(externalInvoiceId: string) {
+    this.logger.log('Pagarme: chargeInvoice', externalInvoiceId);
+    return { id: externalInvoiceId, status: 'paid' };
+  }
+
+  async refundPayment(externalTransactionId: string, amountCents?: number) {
+    this.logger.log('Pagarme: refundPayment', { externalTransactionId, amountCents });
+    return { id: `ref_pagar_${Date.now()}`, status: 'refunded', amount: amountCents };
+  }
+
+  async parseWebhook(rawBody: string, _signature: string) {
+    return JSON.parse(rawBody);
+  }
+
+  async getPaymentStatus(externalId: string) {
+    this.logger.log('Pagarme: getPaymentStatus', externalId);
+    return 'paid';
+  }
+
+  async getSubscriptionStatus(externalId: string) {
+    this.logger.log('Pagarme: getSubscriptionStatus', externalId);
+    return 'active';
+  }
+}

package/src/adapters/payment-gateway.adapter.ts

@@ -0,0 +1,14 @@
+export interface PaymentGatewayAdapter {
+  createCustomer(data: Record<string, unknown>): Promise<Record<string, unknown>>;
+  createCheckoutSession(data: Record<string, unknown>): Promise<Record<string, unknown>>;
+  createSubscription(data: Record<string, unknown>): Promise<Record<string, unknown>>;
+  cancelSubscription(externalId: string): Promise<Record<string, unknown>>;
+  pauseSubscription(externalId: string): Promise<Record<string, unknown>>;
+  resumeSubscription(externalId: string): Promise<Record<string, unknown>>;
+  createInvoice(data: Record<string, unknown>): Promise<Record<string, unknown>>;
+  chargeInvoice(externalInvoiceId: string): Promise<Record<string, unknown>>;
+  refundPayment(externalTransactionId: string, amountCents?: number): Promise<Record<string, unknown>>;
+  parseWebhook(rawBody: string, signature: string): Promise<Record<string, unknown>>;
+  getPaymentStatus(externalId: string): Promise<string>;
+  getSubscriptionStatus(externalId: string): Promise<string>;
+}

package/src/adapters/stripe.adapter.ts

@@ -0,0 +1,67 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { PaymentGatewayAdapter } from './payment-gateway.adapter';
+
+@Injectable()
+export class StripeAdapter implements PaymentGatewayAdapter {
+  private readonly logger = new Logger(StripeAdapter.name);
+
+  async createCustomer(data: Record<string, unknown>) {
+    this.logger.log('Stripe: createCustomer', data);
+    return { id: `cus_stub_${Date.now()}`, ...data };
+  }
+
+  async createCheckoutSession(data: Record<string, unknown>) {
+    this.logger.log('Stripe: createCheckoutSession', data);
+    return { id: `cs_stub_${Date.now()}`, url: 'https://checkout.stripe.com/stub' };
+  }
+
+  async createSubscription(data: Record<string, unknown>) {
+    this.logger.log('Stripe: createSubscription', data);
+    return { id: `sub_stub_${Date.now()}`, status: 'active', ...data };
+  }
+
+  async cancelSubscription(externalId: string) {
+    this.logger.log('Stripe: cancelSubscription', externalId);
+    return { id: externalId, status: 'canceled' };
+  }
+
+  async pauseSubscription(externalId: string) {
+    this.logger.log('Stripe: pauseSubscription', externalId);
+    return { id: externalId, status: 'paused' };
+  }
+
+  async resumeSubscription(externalId: string) {
+    this.logger.log('Stripe: resumeSubscription', externalId);
+    return { id: externalId, status: 'active' };
+  }
+
+  async createInvoice(data: Record<string, unknown>) {
+    this.logger.log('Stripe: createInvoice', data);
+    return { id: `in_stub_${Date.now()}`, status: 'draft', ...data };
+  }
+
+  async chargeInvoice(externalInvoiceId: string) {
+    this.logger.log('Stripe: chargeInvoice', externalInvoiceId);
+    return { id: externalInvoiceId, status: 'paid' };
+  }
+
+  async refundPayment(externalTransactionId: string, amountCents?: number) {
+    this.logger.log('Stripe: refundPayment', { externalTransactionId, amountCents });
+    return { id: `re_stub_${Date.now()}`, status: 'succeeded', amount: amountCents };
+  }
+
+  async parseWebhook(rawBody: string, signature: string) {
+    this.logger.log('Stripe: parseWebhook signature', signature);
+    return JSON.parse(rawBody);
+  }
+
+  async getPaymentStatus(externalId: string) {
+    this.logger.log('Stripe: getPaymentStatus', externalId);
+    return 'paid';
+  }
+
+  async getSubscriptionStatus(externalId: string) {
+    this.logger.log('Stripe: getSubscriptionStatus', externalId);
+    return 'active';
+  }
+}

package/src/billing-contracts.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 { CreateContractDto } from './dto/create-contract.dto';
+import { UpdateContractDto } from './dto/update-contract.dto';
+
+@Role()
+@Controller('billing')
+export class BillingContractsController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('contracts')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listContracts(paginationParams);
+  }
+
+  @Get('contracts/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getContract(id);
+  }
+
+  @Post('contracts')
+  create(@Body() dto: CreateContractDto) {
+    return this.billingService.createContract(dto);
+  }
+
+  @Patch('contracts/:id')
+  update(@Param('id', ParseIntPipe) id: number, @Body() dto: UpdateContractDto) {
+    return this.billingService.updateContract(id, dto);
+  }
+
+  @Delete('contracts/:id')
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.deleteContract(id);
+  }
+}

package/src/billing-coupons.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 { CreateCouponDto } from './dto/create-coupon.dto';
+import { UpdateCouponDto } from './dto/update-coupon.dto';
+
+@Role()
+@Controller('billing')
+export class BillingCouponsController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('coupons')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listCoupons(paginationParams);
+  }
+
+  @Get('coupons/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getCoupon(id);
+  }
+
+  @Post('coupons')
+  create(@Body() dto: CreateCouponDto) {
+    return this.billingService.createCoupon(dto);
+  }
+
+  @Patch('coupons/:id')
+  update(@Param('id', ParseIntPipe) id: number, @Body() dto: UpdateCouponDto) {
+    return this.billingService.updateCoupon(id, dto);
+  }
+
+  @Delete('coupons/:id')
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.deleteCoupon(id);
+  }
+}

package/src/billing-dashboard.controller.ts

@@ -0,0 +1,14 @@
+import { Role } from '@hed-hog/api';
+import { Controller, Get } from '@nestjs/common';
+import { BillingService } from './billing.service';
+
+@Role()
+@Controller('billing')
+export class BillingDashboardController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('dashboard')
+  getData() {
+    return this.billingService.getDashboardData();
+  }
+}

package/src/billing-entitlements.controller.ts

@@ -0,0 +1,34 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import {
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Post,
+} from '@nestjs/common';
+import { BillingService } from './billing.service';
+import { CreateEntitlementDto } from './dto/create-entitlement.dto';
+
+@Role()
+@Controller('billing')
+export class BillingEntitlementsController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('entitlements')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listEntitlements(paginationParams);
+  }
+
+  @Post('entitlements')
+  create(@Body() dto: CreateEntitlementDto) {
+    return this.billingService.createEntitlement(dto);
+  }
+
+  @Delete('entitlements/:id')
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.deleteEntitlement(id);
+  }
+}

package/src/billing-gateways.controller.ts

@@ -0,0 +1,19 @@
+import { Role } from '@hed-hog/api';
+import { Body, Controller, Get, Param, Patch } from '@nestjs/common';
+import { BillingService } from './billing.service';
+
+@Role()
+@Controller('billing')
+export class BillingGatewaysController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('gateways')
+  list() {
+    return this.billingService.listGateways();
+  }
+
+  @Patch('gateways/:slug')
+  update(@Param('slug') slug: string, @Body() data: Record<string, unknown>) {
+    return this.billingService.updateGateway(slug, data);
+  }
+}

package/src/billing-invoices.controller.ts

@@ -0,0 +1,32 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import {
+    Body,
+    Controller,
+    Get,
+    Param,
+    ParseIntPipe,
+    Post,
+} from '@nestjs/common';
+import { BillingService } from './billing.service';
+
+@Role()
+@Controller('billing')
+export class BillingInvoicesController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('invoices')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listInvoices(paginationParams);
+  }
+
+  @Get('invoices/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getInvoice(id);
+  }
+
+  @Post('invoices')
+  create(@Body() data: Record<string, unknown>) {
+    return this.billingService.createInvoice(data);
+  }
+}

package/src/billing-offers.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 { CreateOfferDto } from './dto/create-offer.dto';
+import { UpdateOfferDto } from './dto/update-offer.dto';
+
+@Role()
+@Controller('billing')
+export class BillingOffersController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('offers')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listOffers(paginationParams);
+  }
+
+  @Get('offers/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getOffer(id);
+  }
+
+  @Post('offers')
+  create(@Body() dto: CreateOfferDto) {
+    return this.billingService.createOffer(dto);
+  }
+
+  @Patch('offers/:id')
+  update(@Param('id', ParseIntPipe) id: number, @Body() dto: UpdateOfferDto) {
+    return this.billingService.updateOffer(id, dto);
+  }
+
+  @Delete('offers/:id')
+  remove(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.deleteOffer(id);
+  }
+}

package/src/billing-orders.controller.ts

@@ -0,0 +1,33 @@
+import { Role } from '@hed-hog/api';
+import { Pagination, PaginationDTO } from '@hed-hog/api-pagination';
+import {
+    Body,
+    Controller,
+    Get,
+    Param,
+    ParseIntPipe,
+    Post,
+} from '@nestjs/common';
+import { BillingService } from './billing.service';
+import { CreateOrderDto } from './dto/create-order.dto';
+
+@Role()
+@Controller('billing')
+export class BillingOrdersController {
+  constructor(private readonly billingService: BillingService) {}
+
+  @Get('orders')
+  list(@Pagination() paginationParams: PaginationDTO) {
+    return this.billingService.listOrders(paginationParams);
+  }
+
+  @Get('orders/:id')
+  get(@Param('id', ParseIntPipe) id: number) {
+    return this.billingService.getOrder(id);
+  }
+
+  @Post('orders')
+  create(@Body() dto: CreateOrderDto) {
+    return this.billingService.createOrder(dto);
+  }
+}