@magnet-cms/plugin-stripe 0.1.0

package/dist/backend/index.d.cts

@@ -0,0 +1,317 @@
+import { StripePluginConfig, SubscriptionAccessResponse, CreateCheckoutDto, SessionResponse, StripeMetricsResponse, CreatePortalDto } from '../index.cjs';
+export { StripePlugin } from '../index.cjs';
+import { Model, BaseSchema } from '@magnet-cms/common';
+import { OnModuleInit } from '@nestjs/common';
+import Stripe from 'stripe';
+
+/**
+ * Stripe Plugin Module
+ *
+ * Registers all Stripe schemas, services, and controllers.
+ * Auto-imported by the @Plugin decorator's `module` field.
+ */
+declare class StripeModule {
+}
+
+/**
+ * Stripe Price — synced from Stripe via webhooks.
+ * Represents a pricing option for a product.
+ */
+declare class StripePrice {
+    /** Stripe Price ID (price_...) */
+    stripePriceId: string;
+    /** Reference to the StripeProduct.stripeProductId */
+    productId: string;
+    /** Price amount in the smallest currency unit (e.g., cents) */
+    unitAmount: number;
+    /** Three-letter ISO currency code (e.g., 'usd') */
+    currency: string;
+    /** Pricing type */
+    type: 'one_time' | 'recurring';
+    /** Billing interval for recurring prices */
+    interval?: 'day' | 'week' | 'month' | 'year';
+    /** Number of intervals between billings */
+    intervalCount?: number;
+    /** Whether this price is currently active */
+    active: boolean;
+}
+
+/**
+ * Stripe Product — synced from Stripe via webhooks.
+ * Represents a product available for purchase.
+ */
+declare class StripeProduct {
+    /** Stripe Product ID (prod_...) */
+    stripeProductId: string;
+    /** Product name */
+    name: string;
+    /** Product description */
+    description?: string;
+    /** Whether the product is currently active in Stripe */
+    active: boolean;
+    /** Arbitrary metadata from Stripe */
+    metadata?: Record<string, string>;
+    /** Product image URLs */
+    images?: string[];
+    /** When the product was last synced */
+    updatedAt: Date;
+}
+
+/**
+ * Core Stripe SDK service.
+ *
+ * Initializes the Stripe client from plugin options and provides
+ * typed access for other services to use.
+ */
+declare class StripeService implements OnModuleInit {
+    private readonly config;
+    private readonly logger;
+    private stripe;
+    constructor(config: StripePluginConfig);
+    onModuleInit(): void;
+    /** Get the initialized Stripe client */
+    get client(): Stripe;
+    /** Get the plugin configuration */
+    get pluginConfig(): StripePluginConfig;
+    /**
+     * Verify that raw body is available on the request.
+     * Must be called before webhook signature verification.
+     * Consumers must enable `rawBody: true` in NestFactory.create().
+     */
+    verifyRawBodyAvailable(req: {
+        rawBody?: Buffer;
+    }): asserts req is {
+        rawBody: Buffer;
+    };
+}
+
+/**
+ * Stripe Customer — maps a Stripe customer to a Magnet user.
+ * Synced from Stripe via webhooks.
+ */
+declare class StripeCustomer {
+    /** Stripe Customer ID (cus_...) */
+    stripeCustomerId: string;
+    /** Customer email address */
+    email: string;
+    /** Customer display name */
+    name?: string;
+    /** Reference to the Magnet user ID */
+    userId?: string;
+    /** Arbitrary metadata from Stripe */
+    metadata?: Record<string, string>;
+    /** When the customer was created in Stripe */
+    createdAt: Date;
+}
+
+declare class StripeCustomerService {
+    private readonly customerModel;
+    constructor(customerModel: Model<StripeCustomer>);
+    /**
+     * Upsert a Stripe customer record from a Stripe Customer object.
+     */
+    upsertFromStripe(stripeCustomer: Stripe.Customer): Promise<BaseSchema<StripeCustomer>>;
+    /**
+     * Delete a customer record by Stripe Customer ID.
+     */
+    deleteByStripeId(stripeCustomerId: string): Promise<void>;
+    /**
+     * Find a customer by Magnet user ID.
+     */
+    findByUserId(userId: string): Promise<BaseSchema<StripeCustomer> | null>;
+    /**
+     * Find a customer by Stripe Customer ID.
+     */
+    findByStripeId(stripeCustomerId: string): Promise<BaseSchema<StripeCustomer> | null>;
+    /**
+     * List all customers.
+     */
+    findAll(): Promise<BaseSchema<StripeCustomer>[]>;
+    /**
+     * Link a Stripe customer to a Magnet user.
+     */
+    linkToUser(stripeCustomerId: string, userId: string): Promise<BaseSchema<StripeCustomer>>;
+}
+
+/**
+ * Stripe Subscription — synced from Stripe via webhooks.
+ * Tracks active, canceled, and past subscriptions.
+ */
+declare class StripeSubscription {
+    /** Stripe Subscription ID (sub_...) */
+    stripeSubscriptionId: string;
+    /** Reference to StripeCustomer.stripeCustomerId */
+    customerId: string;
+    /** Reference to StripePrice.stripePriceId */
+    priceId: string;
+    /** Subscription status from Stripe */
+    status: string;
+    /** Start of the current billing period */
+    currentPeriodStart: Date;
+    /** End of the current billing period */
+    currentPeriodEnd: Date;
+    /** Whether the subscription will be canceled at the end of the period */
+    cancelAtPeriodEnd: boolean;
+    /** When the trial ends (null if no trial) */
+    trialEnd?: Date;
+    /** When the subscription was last synced */
+    updatedAt: Date;
+}
+
+declare class StripeSubscriptionService {
+    private readonly subscriptionModel;
+    private readonly stripeService;
+    constructor(subscriptionModel: Model<StripeSubscription>, stripeService: StripeService);
+    /**
+     * Upsert a subscription from a Stripe Subscription object.
+     */
+    syncSubscription(stripeSub: Stripe.Subscription): Promise<BaseSchema<StripeSubscription>>;
+    /**
+     * Delete a subscription record by Stripe Subscription ID.
+     */
+    deleteByStripeId(stripeSubscriptionId: string): Promise<void>;
+    /**
+     * Find active subscription for a customer.
+     */
+    findActiveByCustomerId(customerId: string): Promise<BaseSchema<StripeSubscription> | null>;
+    /**
+     * List all subscriptions.
+     */
+    findAll(): Promise<BaseSchema<StripeSubscription>[]>;
+    /**
+     * Cancel a subscription via the Stripe API.
+     */
+    cancel(stripeSubscriptionId: string): Promise<void>;
+}
+
+declare class StripeAccessService {
+    private readonly stripeService;
+    private readonly customerService;
+    private readonly subscriptionService;
+    private readonly priceModel;
+    private readonly productModel;
+    constructor(stripeService: StripeService, customerService: StripeCustomerService, subscriptionService: StripeSubscriptionService, priceModel: Model<StripePrice>, productModel: Model<StripeProduct>);
+    /**
+     * Get subscription access info for a user.
+     * Returns subscription status, plan name, and feature flags.
+     */
+    getAccess(userId: string): Promise<SubscriptionAccessResponse>;
+    /**
+     * Resolve feature flags for a plan name from plugin config.
+     */
+    private resolveFeaturesForPlan;
+}
+
+declare class StripeCheckoutService {
+    private readonly stripeService;
+    constructor(stripeService: StripeService);
+    /**
+     * Create a Stripe Checkout session.
+     */
+    createCheckoutSession(dto: CreateCheckoutDto): Promise<SessionResponse>;
+}
+
+/**
+ * Stripe Payment — records payment history from invoices and charges.
+ * Synced from Stripe via webhooks.
+ */
+declare class StripePayment {
+    /** Stripe PaymentIntent ID (pi_...) or Invoice ID (in_...) */
+    stripePaymentIntentId: string;
+    /** Reference to StripeCustomer.stripeCustomerId */
+    customerId: string;
+    /** Payment amount in the smallest currency unit (e.g., cents) */
+    amount: number;
+    /** Three-letter ISO currency code */
+    currency: string;
+    /** Payment status */
+    status: string;
+    /** URL for the payment receipt */
+    receiptUrl?: string;
+    /** Stripe Invoice ID if payment is from an invoice */
+    invoiceId?: string;
+    /** When the payment was created */
+    createdAt: Date;
+}
+
+declare class StripeMetricsService {
+    private readonly paymentModel;
+    private readonly subscriptionModel;
+    private readonly stripeService;
+    constructor(paymentModel: Model<StripePayment>, subscriptionModel: Model<StripeSubscription>, stripeService: StripeService);
+    /**
+     * Get dashboard metrics — hybrid of live Stripe API and local DB data.
+     */
+    getMetrics(): Promise<StripeMetricsResponse>;
+    /**
+     * Calculate MRR from active subscriptions via live Stripe API.
+     */
+    private calculateMRR;
+    private countActiveSubscriptions;
+    private calculateRevenueThisMonth;
+    private calculateChurnRate;
+    private getRevenueByMonth;
+    private getRecentPayments;
+}
+
+declare class StripePortalService {
+    private readonly stripeService;
+    private readonly customerService;
+    constructor(stripeService: StripeService, customerService: StripeCustomerService);
+    /**
+     * Create a Stripe Customer Portal session.
+     */
+    createPortalSession(dto: CreatePortalDto): Promise<SessionResponse>;
+}
+
+declare class StripeProductService {
+    private readonly productModel;
+    private readonly priceModel;
+    constructor(productModel: Model<StripeProduct>, priceModel: Model<StripePrice>);
+    /**
+     * Upsert a product from a Stripe Product object.
+     */
+    syncProduct(stripeProduct: Stripe.Product): Promise<BaseSchema<StripeProduct>>;
+    /**
+     * Upsert a price from a Stripe Price object.
+     */
+    syncPrice(stripePrice: Stripe.Price): Promise<BaseSchema<StripePrice>>;
+    /**
+     * Delete a product by Stripe Product ID.
+     */
+    deleteProduct(stripeProductId: string): Promise<void>;
+    /**
+     * Delete a price by Stripe Price ID.
+     */
+    deletePrice(stripePriceId: string): Promise<void>;
+    /**
+     * List all active products with their prices.
+     */
+    findActiveProductsWithPrices(): Promise<Array<{
+        product: BaseSchema<StripeProduct>;
+        prices: BaseSchema<StripePrice>[];
+    }>>;
+    /**
+     * List all products.
+     */
+    findAllProducts(): Promise<BaseSchema<StripeProduct>[]>;
+    /**
+     * List all prices.
+     */
+    findAllPrices(): Promise<BaseSchema<StripePrice>[]>;
+}
+
+/**
+ * Stripe Processed Event — idempotency tracking for webhook events.
+ * Stores event IDs to prevent duplicate processing.
+ */
+declare class StripeProcessedEvent {
+    /** Stripe Event ID (evt_...) — unique to prevent reprocessing */
+    stripeEventId: string;
+    /** Event type (e.g., 'invoice.paid', 'customer.subscription.updated') */
+    eventType: string;
+    /** When this event was processed */
+    processedAt: Date;
+}
+
+export { CreateCheckoutDto, CreatePortalDto, SessionResponse, StripeAccessService, StripeCheckoutService, StripeCustomer, StripeCustomerService, StripeMetricsResponse, StripeMetricsService, StripeModule, StripePayment, StripePluginConfig, StripePortalService, StripePrice, StripeProcessedEvent, StripeProduct, StripeProductService, StripeService, StripeSubscription, StripeSubscriptionService, SubscriptionAccessResponse };

package/dist/backend/index.d.ts

@@ -0,0 +1,317 @@
+import { StripePluginConfig, SubscriptionAccessResponse, CreateCheckoutDto, SessionResponse, StripeMetricsResponse, CreatePortalDto } from '../index.js';
+export { StripePlugin } from '../index.js';
+import { Model, BaseSchema } from '@magnet-cms/common';
+import { OnModuleInit } from '@nestjs/common';
+import Stripe from 'stripe';
+
+/**
+ * Stripe Plugin Module
+ *
+ * Registers all Stripe schemas, services, and controllers.
+ * Auto-imported by the @Plugin decorator's `module` field.
+ */
+declare class StripeModule {
+}
+
+/**
+ * Stripe Price — synced from Stripe via webhooks.
+ * Represents a pricing option for a product.
+ */
+declare class StripePrice {
+    /** Stripe Price ID (price_...) */
+    stripePriceId: string;
+    /** Reference to the StripeProduct.stripeProductId */
+    productId: string;
+    /** Price amount in the smallest currency unit (e.g., cents) */
+    unitAmount: number;
+    /** Three-letter ISO currency code (e.g., 'usd') */
+    currency: string;
+    /** Pricing type */
+    type: 'one_time' | 'recurring';
+    /** Billing interval for recurring prices */
+    interval?: 'day' | 'week' | 'month' | 'year';
+    /** Number of intervals between billings */
+    intervalCount?: number;
+    /** Whether this price is currently active */
+    active: boolean;
+}
+
+/**
+ * Stripe Product — synced from Stripe via webhooks.
+ * Represents a product available for purchase.
+ */
+declare class StripeProduct {
+    /** Stripe Product ID (prod_...) */
+    stripeProductId: string;
+    /** Product name */
+    name: string;
+    /** Product description */
+    description?: string;
+    /** Whether the product is currently active in Stripe */
+    active: boolean;
+    /** Arbitrary metadata from Stripe */
+    metadata?: Record<string, string>;
+    /** Product image URLs */
+    images?: string[];
+    /** When the product was last synced */
+    updatedAt: Date;
+}
+
+/**
+ * Core Stripe SDK service.
+ *
+ * Initializes the Stripe client from plugin options and provides
+ * typed access for other services to use.
+ */
+declare class StripeService implements OnModuleInit {
+    private readonly config;
+    private readonly logger;
+    private stripe;
+    constructor(config: StripePluginConfig);
+    onModuleInit(): void;
+    /** Get the initialized Stripe client */
+    get client(): Stripe;
+    /** Get the plugin configuration */
+    get pluginConfig(): StripePluginConfig;
+    /**
+     * Verify that raw body is available on the request.
+     * Must be called before webhook signature verification.
+     * Consumers must enable `rawBody: true` in NestFactory.create().
+     */
+    verifyRawBodyAvailable(req: {
+        rawBody?: Buffer;
+    }): asserts req is {
+        rawBody: Buffer;
+    };
+}
+
+/**
+ * Stripe Customer — maps a Stripe customer to a Magnet user.
+ * Synced from Stripe via webhooks.
+ */
+declare class StripeCustomer {
+    /** Stripe Customer ID (cus_...) */
+    stripeCustomerId: string;
+    /** Customer email address */
+    email: string;
+    /** Customer display name */
+    name?: string;
+    /** Reference to the Magnet user ID */
+    userId?: string;
+    /** Arbitrary metadata from Stripe */
+    metadata?: Record<string, string>;
+    /** When the customer was created in Stripe */
+    createdAt: Date;
+}
+
+declare class StripeCustomerService {
+    private readonly customerModel;
+    constructor(customerModel: Model<StripeCustomer>);
+    /**
+     * Upsert a Stripe customer record from a Stripe Customer object.
+     */
+    upsertFromStripe(stripeCustomer: Stripe.Customer): Promise<BaseSchema<StripeCustomer>>;
+    /**
+     * Delete a customer record by Stripe Customer ID.
+     */
+    deleteByStripeId(stripeCustomerId: string): Promise<void>;
+    /**
+     * Find a customer by Magnet user ID.
+     */
+    findByUserId(userId: string): Promise<BaseSchema<StripeCustomer> | null>;
+    /**
+     * Find a customer by Stripe Customer ID.
+     */
+    findByStripeId(stripeCustomerId: string): Promise<BaseSchema<StripeCustomer> | null>;
+    /**
+     * List all customers.
+     */
+    findAll(): Promise<BaseSchema<StripeCustomer>[]>;
+    /**
+     * Link a Stripe customer to a Magnet user.
+     */
+    linkToUser(stripeCustomerId: string, userId: string): Promise<BaseSchema<StripeCustomer>>;
+}
+
+/**
+ * Stripe Subscription — synced from Stripe via webhooks.
+ * Tracks active, canceled, and past subscriptions.
+ */
+declare class StripeSubscription {
+    /** Stripe Subscription ID (sub_...) */
+    stripeSubscriptionId: string;
+    /** Reference to StripeCustomer.stripeCustomerId */
+    customerId: string;
+    /** Reference to StripePrice.stripePriceId */
+    priceId: string;
+    /** Subscription status from Stripe */
+    status: string;
+    /** Start of the current billing period */
+    currentPeriodStart: Date;
+    /** End of the current billing period */
+    currentPeriodEnd: Date;
+    /** Whether the subscription will be canceled at the end of the period */
+    cancelAtPeriodEnd: boolean;
+    /** When the trial ends (null if no trial) */
+    trialEnd?: Date;
+    /** When the subscription was last synced */
+    updatedAt: Date;
+}
+
+declare class StripeSubscriptionService {
+    private readonly subscriptionModel;
+    private readonly stripeService;
+    constructor(subscriptionModel: Model<StripeSubscription>, stripeService: StripeService);
+    /**
+     * Upsert a subscription from a Stripe Subscription object.
+     */
+    syncSubscription(stripeSub: Stripe.Subscription): Promise<BaseSchema<StripeSubscription>>;
+    /**
+     * Delete a subscription record by Stripe Subscription ID.
+     */
+    deleteByStripeId(stripeSubscriptionId: string): Promise<void>;
+    /**
+     * Find active subscription for a customer.
+     */
+    findActiveByCustomerId(customerId: string): Promise<BaseSchema<StripeSubscription> | null>;
+    /**
+     * List all subscriptions.
+     */
+    findAll(): Promise<BaseSchema<StripeSubscription>[]>;
+    /**
+     * Cancel a subscription via the Stripe API.
+     */
+    cancel(stripeSubscriptionId: string): Promise<void>;
+}
+
+declare class StripeAccessService {
+    private readonly stripeService;
+    private readonly customerService;
+    private readonly subscriptionService;
+    private readonly priceModel;
+    private readonly productModel;
+    constructor(stripeService: StripeService, customerService: StripeCustomerService, subscriptionService: StripeSubscriptionService, priceModel: Model<StripePrice>, productModel: Model<StripeProduct>);
+    /**
+     * Get subscription access info for a user.
+     * Returns subscription status, plan name, and feature flags.
+     */
+    getAccess(userId: string): Promise<SubscriptionAccessResponse>;
+    /**
+     * Resolve feature flags for a plan name from plugin config.
+     */
+    private resolveFeaturesForPlan;
+}
+
+declare class StripeCheckoutService {
+    private readonly stripeService;
+    constructor(stripeService: StripeService);
+    /**
+     * Create a Stripe Checkout session.
+     */
+    createCheckoutSession(dto: CreateCheckoutDto): Promise<SessionResponse>;
+}
+
+/**
+ * Stripe Payment — records payment history from invoices and charges.
+ * Synced from Stripe via webhooks.
+ */
+declare class StripePayment {
+    /** Stripe PaymentIntent ID (pi_...) or Invoice ID (in_...) */
+    stripePaymentIntentId: string;
+    /** Reference to StripeCustomer.stripeCustomerId */
+    customerId: string;
+    /** Payment amount in the smallest currency unit (e.g., cents) */
+    amount: number;
+    /** Three-letter ISO currency code */
+    currency: string;
+    /** Payment status */
+    status: string;
+    /** URL for the payment receipt */
+    receiptUrl?: string;
+    /** Stripe Invoice ID if payment is from an invoice */
+    invoiceId?: string;
+    /** When the payment was created */
+    createdAt: Date;
+}
+
+declare class StripeMetricsService {
+    private readonly paymentModel;
+    private readonly subscriptionModel;
+    private readonly stripeService;
+    constructor(paymentModel: Model<StripePayment>, subscriptionModel: Model<StripeSubscription>, stripeService: StripeService);
+    /**
+     * Get dashboard metrics — hybrid of live Stripe API and local DB data.
+     */
+    getMetrics(): Promise<StripeMetricsResponse>;
+    /**
+     * Calculate MRR from active subscriptions via live Stripe API.
+     */
+    private calculateMRR;
+    private countActiveSubscriptions;
+    private calculateRevenueThisMonth;
+    private calculateChurnRate;
+    private getRevenueByMonth;
+    private getRecentPayments;
+}
+
+declare class StripePortalService {
+    private readonly stripeService;
+    private readonly customerService;
+    constructor(stripeService: StripeService, customerService: StripeCustomerService);
+    /**
+     * Create a Stripe Customer Portal session.
+     */
+    createPortalSession(dto: CreatePortalDto): Promise<SessionResponse>;
+}
+
+declare class StripeProductService {
+    private readonly productModel;
+    private readonly priceModel;
+    constructor(productModel: Model<StripeProduct>, priceModel: Model<StripePrice>);
+    /**
+     * Upsert a product from a Stripe Product object.
+     */
+    syncProduct(stripeProduct: Stripe.Product): Promise<BaseSchema<StripeProduct>>;
+    /**
+     * Upsert a price from a Stripe Price object.
+     */
+    syncPrice(stripePrice: Stripe.Price): Promise<BaseSchema<StripePrice>>;
+    /**
+     * Delete a product by Stripe Product ID.
+     */
+    deleteProduct(stripeProductId: string): Promise<void>;
+    /**
+     * Delete a price by Stripe Price ID.
+     */
+    deletePrice(stripePriceId: string): Promise<void>;
+    /**
+     * List all active products with their prices.
+     */
+    findActiveProductsWithPrices(): Promise<Array<{
+        product: BaseSchema<StripeProduct>;
+        prices: BaseSchema<StripePrice>[];
+    }>>;
+    /**
+     * List all products.
+     */
+    findAllProducts(): Promise<BaseSchema<StripeProduct>[]>;
+    /**
+     * List all prices.
+     */
+    findAllPrices(): Promise<BaseSchema<StripePrice>[]>;
+}
+
+/**
+ * Stripe Processed Event — idempotency tracking for webhook events.
+ * Stores event IDs to prevent duplicate processing.
+ */
+declare class StripeProcessedEvent {
+    /** Stripe Event ID (evt_...) — unique to prevent reprocessing */
+    stripeEventId: string;
+    /** Event type (e.g., 'invoice.paid', 'customer.subscription.updated') */
+    eventType: string;
+    /** When this event was processed */
+    processedAt: Date;
+}
+
+export { CreateCheckoutDto, CreatePortalDto, SessionResponse, StripeAccessService, StripeCheckoutService, StripeCustomer, StripeCustomerService, StripeMetricsResponse, StripeMetricsService, StripeModule, StripePayment, StripePluginConfig, StripePortalService, StripePrice, StripeProcessedEvent, StripeProduct, StripeProductService, StripeService, StripeSubscription, StripeSubscriptionService, SubscriptionAccessResponse };

package/dist/backend/index.js

@@ -0,0 +1,19 @@
+import { init_stripe_module, init_access_service, init_checkout_service, init_customer_service, init_metrics_service, init_portal_service, init_product_service, init_subscription_service, init_stripe_service, init_customer_schema, init_payment_schema, init_price_schema, init_processed_event_schema, init_product_schema, init_subscription_schema } from '../chunk-IPPZL6QM.js';
+export { StripeAccessService, StripeCheckoutService, StripeCustomer, StripeCustomerService, StripeMetricsService, StripeModule, StripePayment, StripePlugin, StripePortalService, StripePrice, StripeProcessedEvent, StripeProduct, StripeProductService, StripeService, StripeSubscription, StripeSubscriptionService } from '../chunk-IPPZL6QM.js';
+
+// src/backend/index.ts
+init_stripe_module();
+init_access_service();
+init_checkout_service();
+init_customer_service();
+init_metrics_service();
+init_portal_service();
+init_product_service();
+init_subscription_service();
+init_stripe_service();
+init_customer_schema();
+init_payment_schema();
+init_price_schema();
+init_processed_event_schema();
+init_product_schema();
+init_subscription_schema();