plebdevs/yearly_subscriptions.md

Yearly Subscription Implementation Plan

1. Database Schema Updates

model Role {
    // Existing fields...
    subscriptionType  String    @default("monthly") // Options: "monthly", "yearly"
    // Other fields remain the same
}

2. UI Component Updates

SubscribeModal.js

• Add toggle between monthly/yearly subscription options
• Update pricing display (50,000 sats monthly / 500,000 sats yearly)
• Show savings message for yearly option (~17% discount)

SubscriptionPaymentButton.js

• Add subscription type parameter
• Modify amount calculation based on subscription type
• Update NWC configuration for yearly budgets

// Example modification
const getAmount = (subscriptionType) => {
  return subscriptionType === 'yearly' ? 500000 : 50000;
};

// For NWC setup
const budgetRenewal = subscriptionType === 'yearly' ? 'yearly' : 'monthly';

3. API Endpoints Updates

/api/users/subscription

• Update to accept subscriptionType parameter
• Modify database update to store subscription type

// Example modification
export const updateUserSubscription = async (userId, isSubscribed, nwc, subscriptionType = 'monthly') => {
  try {
    const now = new Date();
    return await prisma.user.update({
      where: { id: userId },
      data: {
        role: {
          upsert: {
            create: {
              subscribed: isSubscribed,
              subscriptionType: subscriptionType,
              // Other fields remain the same
            },
            update: {
              subscribed: isSubscribed,
              subscriptionType: subscriptionType,
              // Other fields remain the same
            },
          },
        },
      },
      include: {
        role: true,
      },
    });
  } finally {
    await prisma.$disconnect();
  }
};

4. Cron Job Modifications

cron.js

• Update expiration calculation to check subscription type
• For monthly: expire after 30 days + 1 hour
• For yearly: expire after 365 days + 1 hour

export const findExpiredSubscriptions = async () => {
  const now = new Date();
  
  // Define expiration periods
  const monthlyExpiration = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000 - 1 * 60 * 60 * 1000);
  const yearlyExpiration = new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000 - 1 * 60 * 60 * 1000);
  
  // Find expired subscriptions of both types
  const expiredSubscriptions = await prisma.role.findMany({
    where: {
      subscribed: true,
      OR: [
        {
          subscriptionType: 'monthly',
          lastPaymentAt: { lt: monthlyExpiration }
        },
        {
          subscriptionType: 'yearly', 
          lastPaymentAt: { lt: yearlyExpiration }
        }
      ]
    },
    select: {
      userId: true,
      nwc: true,
      subscriptionType: true,
      subscriptionExpiredAt: true,
      subscriptionStartDate: true,
      admin: true,
    }
  });
  
  return expiredSubscriptions;
};

5. Testing Plan

Database Testing

1. Verify Prisma schema correctly includes the subscriptionType field with default value "monthly"
2. Confirm migrations apply correctly to existing database

UI Testing

1. Monthly Subscription UI

   • Verify the subscription selector defaults to monthly
   • Check pricing shows 50,000 sats for monthly
   • Ensure subscription buttons show "Monthly" where appropriate

2. Yearly Subscription UI

   • Verify selecting yearly plan updates all UI elements
   • Check pricing shows 500,000 sats for yearly
   • Confirm ~17% savings message appears
   • Ensure subscription buttons show "Yearly" where appropriate

Payment Flow Testing

1. Monthly One-time Payment

   • Test subscription purchase with "Pay as you go" for monthly plan
   • Verify subscription is created with type "monthly"
   • Confirm user profile shows correct subscription expiration date (30 days)

2. Monthly Recurring Payment

   • Test subscription setup with "Setup Recurring Monthly Subscription"
   • Verify NWC configuration with monthly budget renewal
   • Confirm subscription is created with type "monthly"

3. Yearly One-time Payment

   • Test subscription purchase with "Pay as you go" for yearly plan
   • Verify subscription is created with type "yearly"
   • Confirm user profile shows correct subscription expiration date (365 days)

4. Yearly Recurring Payment

   • Test subscription setup with "Setup Recurring Yearly Subscription"
   • Verify NWC configuration with yearly budget renewal
   • Confirm subscription is created with type "yearly"

Cron Job Testing

1. Recently Active Monthly Subscription

   • Set up test account with monthly subscription
   • Verify subscription not marked as expired by cron job

2. Recently Active Yearly Subscription

   • Set up test account with yearly subscription
   • Verify subscription not marked as expired by cron job

3. Expired Monthly Subscription

   • Create test account with monthly subscription
   • Manually adjust lastPaymentAt date to be >30 days ago
   • Run cron job and verify subscription is expired

4. Expired Yearly Subscription

   • Create test account with yearly subscription
   • Manually adjust lastPaymentAt date to be >365 days ago
   • Run cron job and verify subscription is expired

5. Auto-renewal Testing

   • Set up NWC for test accounts (both monthly and yearly)
   • Manually adjust lastPaymentAt date to trigger expiration
   • Run cron job and verify proper renewal amount is charged
   • Confirm subscription type is maintained after renewal

6. Implementation Steps

1. ✅ Create database migration for schema changes
2. ✅ Modify frontend subscription components
3. ✅ Update backend models and API endpoints
4. ✅ Update cron job logic
5. Test all flows thoroughly
6. Deploy changes

7. Marketing Considerations

• Highlight savings with yearly subscription (~17% discount)
• Update documentation and marketing materials
• Consider grandfathering existing subscribers or offering upgrade path