@breadstone/archipel-platform-payments

Provider-agnostic payment infrastructure for NestJS with support for Stripe, Paddle, LemonSqueezy, and Mollie.

⚠️ Environment Variables (Most Important)

Choose one provider and configure its required variables.

Stripe

Paddle

LemonSqueezy

Mollie

Import Options

import { PaymentModule } from '@breadstone/archipel-platform-payments';

Provider-specific imports:

import { StripeClient, STRIPE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-payments/stripe';
import { PaddleClient, PADDLE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-payments/paddle';
import { LemonSqueezyClient, LEMONSQUEEZY_CONFIG_ENTRIES } from '@breadstone/archipel-platform-payments/lemonsqueezy';
import { MollieClient, MOLLIE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-payments/mollie';

Quick Start

import { PaymentModule } from '@breadstone/archipel-platform-payments';
import { StripeClient, STRIPE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-payments/stripe';

@Module({
  imports: [
    PaymentModule.register({
      paymentClient: StripeClient,
      configEntries: STRIPE_CONFIG_ENTRIES,
    }),
  ],
})
export class AppModule {}

Features

• Provider-agnostic: Switch between Stripe, Paddle, LemonSqueezy, or Mollie without changing business logic
• Subpath imports: Each provider lives in its own subpath — install only the SDK you need
• Normalized types: All providers return the same INormalizedPrice, INormalizedSubscription, etc.
• Feature gating: FeatureGuard + @RequiresFeature() for quota-based access control
• Usage tracking: FeatureUsageInterceptor records feature consumption automatically
• Strict error propagation: Methods like fetchPrices propagate errors to the caller instead of silently returning empty results. Wrap calls in try/catch if you need fallback behavior

Available Providers

Development

# Build
yarn nx build platform-payments

# Test
yarn nx test platform-payments

# Lint
yarn nx lint platform-payments