The Executive's Guide to SaaS Product Development: From Architectural Blueprint to Launch

import { Stripe } from 'stripe';

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, { apiVersion: '2024-06-20' });

export interface TenantEntitlements {
  canAccessAdvancedAnalytics: boolean;
  maxMonthlyApiCalls: number;
  activePlan: 'STARTER' | 'PRO' | 'ENTERPRISE';
}

export async function getTenantEntitlements(stripeCustomerId: string): Promise<TenantEntitlements> {
  // 1. Fetch active subscription details from Stripe
  const subscriptions = await stripe.subscriptions.list({
    customer: stripeCustomerId,
    status: 'active',
    limit: 1,
  });

  if (subscriptions.data.length === 0) {
    // Default free tier fallback
    return { canAccessAdvancedAnalytics: false, maxMonthlyApiCalls: 1000, activePlan: 'STARTER' };
  }

  const activeSub = subscriptions.data[0];
  const priceId = activeSub.items.data[0].price.id;

  // 2. Map Stripe price IDs to application feature permissions
  if (priceId === process.env.STRIPE_PRICE_ENTERPRISE) {
    return { canAccessAdvancedAnalytics: true, maxMonthlyApiCalls: 1000000, activePlan: 'ENTERPRISE' };
  } else if (priceId === process.env.STRIPE_PRICE_PRO) {
    return { canAccessAdvancedAnalytics: true, maxMonthlyApiCalls: 50000, activePlan: 'PRO' };
  }

  return { canAccessAdvancedAnalytics: false, maxMonthlyApiCalls: 1000, activePlan: 'STARTER' };
}