vibefast-cli 1.3.3 → 1.3.5

package/recipes/stripe/packages/backend/convex/payments/providers/stripe.ts

@@ -0,0 +1,186 @@
+import { action, query } from '../../_generated/server';
+import { components } from '../../_generated/api';
+import { StripeSubscriptions } from '@convex-dev/stripe';
+import { v } from 'convex/values';
+import {
+  checkoutResultValidator,
+  portalResultValidator,
+  subscriptionValidator,
+} from '../types';
+import { getCheckoutUrls, getPlanByPriceId } from '../config';
+
+// ============================================================================
+// Stripe Payment Provider Implementation
+// ============================================================================
+
+const stripe = new StripeSubscriptions(components.stripe, {});
+
+/**
+ * Create a checkout session for subscription or one-time payment
+ */
+export const createCheckout = action({
+  args: {
+    priceId: v.string(),
+    mode: v.optional(v.union(v.literal('subscription'), v.literal('payment'))),
+    successUrl: v.optional(v.string()),
+    cancelUrl: v.optional(v.string()),
+  },
+  returns: checkoutResultValidator,
+  handler: async (ctx, args) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) {
+      throw new Error('Not authenticated');
+    }
+
+    const userId = identity.subject;
+    const urls = getCheckoutUrls(args.successUrl, args.cancelUrl);
+
+    // Get or create a Stripe customer linked to this user
+    const customer = await stripe.getOrCreateCustomer(ctx, {
+      userId,
+      email: identity.email,
+      name: identity.name,
+    });
+
+    // Create checkout session
+    const session = await stripe.createCheckoutSession(ctx, {
+      priceId: args.priceId,
+      customerId: customer.customerId,
+      mode: args.mode ?? 'subscription',
+      successUrl: urls.successUrl,
+      cancelUrl: urls.cancelUrl,
+      subscriptionMetadata: { userId },
+      paymentIntentMetadata: { userId },
+    });
+
+    return {
+      url: session.url ?? '',
+      sessionId: session.sessionId,
+    };
+  },
+});
+
+/**
+ * Create a customer portal session for billing management
+ */
+export const createPortalSession = action({
+  args: {
+    returnUrl: v.optional(v.string()),
+  },
+  returns: portalResultValidator,
+  handler: async (ctx, args) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) {
+      throw new Error('Not authenticated');
+    }
+
+    const customer = await stripe.getOrCreateCustomer(ctx, {
+      userId: identity.subject,
+      email: identity.email,
+      name: identity.name,
+    });
+
+    const result = await stripe.createCustomerPortalSession(ctx, {
+      customerId: customer.customerId,
+      returnUrl: args.returnUrl ?? `${process.env.SITE_URL}/billing`,
+    });
+
+    return { url: result.url };
+  },
+});
+
+/**
+ * Get the current user's active subscription
+ */
+export const getSubscription = query({
+  args: {},
+  returns: v.union(subscriptionValidator, v.null()),
+  handler: async (ctx) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) return null;
+
+    const subscriptions = await ctx.runQuery(
+      components.stripe.public.listSubscriptionsByUserId,
+      { userId: identity.subject },
+    );
+
+    // Find active or trialing subscription
+    const active = subscriptions.find(
+      (s) => s.status === 'active' || s.status === 'trialing',
+    );
+
+    if (!active) return null;
+
+    // Map to unified subscription shape
+    const plan = getPlanByPriceId(active.priceId ?? '');
+    const cancelAtRaw = (active as any)?.metadata?.cancelAt;
+    const cancelAt =
+      typeof cancelAtRaw === 'number'
+        ? cancelAtRaw
+        : typeof cancelAtRaw === 'string'
+          ? Number(cancelAtRaw)
+          : undefined;
+
+    return {
+      id: active.stripeSubscriptionId,
+      provider: 'stripe',
+      status: active.status,
+      planId: plan?.id ?? '',
+      priceId: active.priceId ?? undefined,
+      currentPeriodEnd: active.currentPeriodEnd,
+      cancelAt: Number.isFinite(cancelAt) ? cancelAt : undefined,
+      cancelAtPeriodEnd: active.cancelAtPeriodEnd,
+      createdAt: active._creationTime,
+    };
+  },
+});
+
+/**
+ * Cancel a subscription (at period end)
+ */
+export const cancelSubscription = action({
+  args: { subscriptionId: v.string() },
+  returns: v.boolean(),
+  handler: async (ctx, args) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) {
+      throw new Error('Not authenticated');
+    }
+
+    await stripe.cancelSubscription(ctx, {
+      stripeSubscriptionId: args.subscriptionId,
+    });
+
+    return true;
+  },
+});
+
+/**
+ * Get user's payment history
+ */
+export const getPayments = query({
+  args: {},
+  handler: async (ctx) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) return [];
+
+    return await ctx.runQuery(components.stripe.public.listPaymentsByUserId, {
+      userId: identity.subject,
+    });
+  },
+});
+
+/**
+ * Get user's invoices
+ */
+export const getInvoices = query({
+  args: {},
+  handler: async (ctx) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) return [];
+
+    return await ctx.runQuery(components.stripe.public.listInvoicesByUserId, {
+      userId: identity.subject,
+    });
+  },
+});

package/recipes/stripe/packages/backend/convex/payments/types.ts

@@ -0,0 +1,89 @@
+import { v } from 'convex/values';
+
+// ============================================================================
+// Payment Provider Types
+// Shared interfaces for all payment providers (Stripe, LemonSqueezy, etc.)
+// ============================================================================
+
+/**
+ * Normalized subscription status across all providers
+ */
+export type SubscriptionStatus =
+  | 'active'
+  | 'trialing'
+  | 'past_due'
+  | 'canceled'
+  | 'expired'
+  | 'paused'
+  | 'unpaid';
+
+/**
+ * Billing interval types
+ */
+export type BillingInterval = 'month' | 'year' | 'one_time';
+
+/**
+ * Plan definition for pricing display
+ */
+export interface Plan {
+  id: string;
+  name: string;
+  description?: string;
+  price: string; // Display price (e.g., "$29/mo")
+  priceId: string; // Provider-specific price/variant ID
+  interval: BillingInterval;
+  features: string[];
+  popular?: boolean;
+}
+
+// Convex validators
+export const planValidator = v.object({
+  id: v.string(),
+  name: v.string(),
+  description: v.optional(v.string()),
+  price: v.string(),
+  priceId: v.string(),
+  interval: v.union(
+    v.literal('month'),
+    v.literal('year'),
+    v.literal('one_time'),
+  ),
+  features: v.array(v.string()),
+  popular: v.optional(v.boolean()),
+});
+
+/**
+ * Unified subscription shape returned by all providers
+ */
+export const subscriptionValidator = v.object({
+  id: v.string(),
+  provider: v.string(),
+  status: v.string(),
+  planId: v.string(),
+  priceId: v.optional(v.string()),
+  currentPeriodEnd: v.optional(v.number()),
+  cancelAt: v.optional(v.number()),
+  cancelAtPeriodEnd: v.optional(v.boolean()),
+  createdAt: v.optional(v.number()),
+});
+
+export type Subscription = typeof subscriptionValidator._type;
+
+/**
+ * Checkout session result
+ */
+export const checkoutResultValidator = v.object({
+  url: v.string(),
+  sessionId: v.optional(v.string()),
+});
+
+export type CheckoutResult = typeof checkoutResultValidator._type;
+
+/**
+ * Portal session result
+ */
+export const portalResultValidator = v.object({
+  url: v.string(),
+});
+
+export type PortalResult = typeof portalResultValidator._type;

package/recipes/stripe/packages/backend/convex/payments.ts

@@ -0,0 +1,137 @@
+import { getAuthUserId } from '@convex-dev/auth/server';
+import { v } from 'convex/values';
+
+import { mutation, query } from './_generated/server';
+
+// ============================================================================
+// Payment Provider Exports
+// All payment functions are delegated through the provider interface.
+// Change ACTIVE_PROVIDER in payments/index.ts to switch providers.
+// ============================================================================
+
+export {
+  createCheckout,
+  createPortalSession,
+  getSubscription,
+  cancelSubscription,
+  getPayments,
+} from './payments/index';
+
+// ============================================================================
+// Credits & Consumable Purchases
+// ============================================================================
+
+/**
+ * Record a consumable purchase (like credits) in the database
+ */
+export const recordConsumablePurchase = mutation({
+  args: {
+    productId: v.string(),
+    quantity: v.number(),
+  },
+  returns: v.object({
+    success: v.boolean(),
+    newCredits: v.number(),
+    totalCredits: v.number(),
+  }),
+  handler: async (ctx, args) => {
+    const userId = await getAuthUserId(ctx);
+    if (!userId) {
+      throw new Error('Not authenticated');
+    }
+    // Get current user to check existing credits
+    const user = await ctx.db.get(userId);
+    if (!user) {
+      throw new Error('User not found');
+    }
+
+    // Calculate new credits based on product
+    let creditsToAdd = args.quantity;
+
+    // You can customize credit amounts based on productId
+    if (args.productId.includes('premium')) {
+      creditsToAdd = args.quantity * 2; // Premium products give 2x credits
+    }
+
+    // Update user credits - credits is optional in schema
+    const currentCredits = user.credits ?? 0;
+    const newTotalCredits = currentCredits + creditsToAdd;
+
+    await ctx.db.patch(userId, {
+      credits: newTotalCredits,
+    });
+
+    // Log the purchase
+    await ctx.db.insert('purchases', {
+      userId,
+      productId: args.productId,
+      quantity: args.quantity,
+      creditsAdded: creditsToAdd,
+      purchaseDate: Date.now(),
+    });
+
+    return {
+      success: true,
+      newCredits: creditsToAdd,
+      totalCredits: newTotalCredits,
+    };
+  },
+});
+
+/**
+ * Get user's current credit balance
+ */
+export const getUserCredits = query({
+  args: {},
+  returns: v.union(v.number(), v.null()),
+  handler: async (ctx) => {
+    const userId = await getAuthUserId(ctx);
+    if (!userId) {
+      throw new Error('Not authenticated');
+    }
+    const user = await ctx.db.get(userId);
+
+    return user?.credits ?? 0;
+  },
+});
+
+/**
+ * Get user's purchase history with pagination
+ */
+export const getPurchaseHistory = query({
+  args: {
+    paginationOpts: v.optional(
+      v.object({
+        numItems: v.number(),
+        cursor: v.union(v.string(), v.null()),
+      }),
+    ),
+  },
+  returns: v.object({
+    page: v.array(
+      v.object({
+        _id: v.id('purchases'),
+        _creationTime: v.number(),
+        productId: v.string(),
+        quantity: v.number(),
+        creditsAdded: v.number(),
+        purchaseDate: v.number(),
+      }),
+    ),
+    isDone: v.boolean(),
+    continueCursor: v.string(),
+    pageStatus: v.optional(v.union(v.string(), v.null())),
+    splitCursor: v.optional(v.union(v.string(), v.null())),
+  }),
+  handler: async (ctx, args) => {
+    const userId = await getAuthUserId(ctx);
+    if (!userId) {
+      throw new Error('Not authenticated');
+    }
+    return await ctx.db
+      .query('purchases')
+      .withIndex('by_userId', (q) => q.eq('userId', userId))
+      .order('desc')
+      .paginate(args.paginationOpts ?? { numItems: 50, cursor: null });
+  },
+});

package/recipes/stripe/recipe.json

@@ -0,0 +1,114 @@
+{
+  "name": "stripe",
+  "version": "1.0.0",
+  "description": "Stripe web payments (pricing + billing)",
+  "copy": [
+    {
+      "from": "apps/web/app/pricing",
+      "to": "apps/web/app/pricing"
+    },
+    {
+      "from": "apps/web/app/billing",
+      "to": "apps/web/app/billing"
+    },
+    {
+      "from": "apps/web/components/payments",
+      "to": "apps/web/components/payments"
+    },
+    {
+      "from": "apps/web/lib/plans.ts",
+      "to": "apps/web/lib/plans.ts"
+    },
+    {
+      "from": "packages/backend/convex/payments",
+      "to": "packages/backend/convex/payments"
+    },
+    {
+      "from": "packages/backend/convex/payments.ts",
+      "to": "packages/backend/convex/payments.ts"
+    }
+  ],
+  "target": "web",
+  "dependencies": {
+    "backend": [
+      "@convex-dev/stripe"
+    ]
+  },
+  "env": [
+    {
+      "key": "PAYMENT_PROVIDER",
+      "description": "Active payments provider (stripe or lemonsqueezy)",
+      "example": "stripe",
+      "file": "packages/backend/.env.local"
+    },
+    {
+      "key": "SITE_URL",
+      "description": "Public site URL for checkout redirects (no trailing slash)",
+      "example": "https://yourdomain.com",
+      "file": "packages/backend/.env.local"
+    },
+    {
+      "key": "PLAN_STARTER_PRICE_ID",
+      "description": "Stripe Price ID for Starter plan",
+      "example": "price_1234",
+      "file": "packages/backend/.env.local"
+    },
+    {
+      "key": "PLAN_PRO_PRICE_ID",
+      "description": "Stripe Price ID for Pro plan",
+      "example": "price_5678",
+      "file": "packages/backend/.env.local"
+    },
+    {
+      "key": "PLAN_ENTERPRISE_PRICE_ID",
+      "description": "Stripe Price ID for Enterprise plan",
+      "example": "price_9012",
+      "file": "packages/backend/.env.local"
+    },
+    {
+      "key": "STRIPE_SECRET_KEY",
+      "description": "Stripe secret key",
+      "example": "sk_live_...",
+      "file": "packages/backend/.env.local"
+    },
+    {
+      "key": "STRIPE_WEBHOOK_SECRET",
+      "description": "Stripe webhook signing secret",
+      "example": "whsec_...",
+      "file": "packages/backend/.env.local"
+    },
+    {
+      "key": "NEXT_PUBLIC_PLAN_STARTER_PRICE_ID",
+      "description": "Starter plan Price ID for the web app",
+      "example": "price_1234",
+      "file": "apps/web/.env.local"
+    },
+    {
+      "key": "NEXT_PUBLIC_PLAN_PRO_PRICE_ID",
+      "description": "Pro plan Price ID for the web app",
+      "example": "price_5678",
+      "file": "apps/web/.env.local"
+    },
+    {
+      "key": "NEXT_PUBLIC_PLAN_ENTERPRISE_PRICE_ID",
+      "description": "Enterprise plan Price ID for the web app",
+      "example": "price_9012",
+      "file": "apps/web/.env.local"
+    }
+  ],
+  "manualSteps": [
+    {
+      "title": "Create Stripe webhook",
+      "description": "Add a webhook endpoint in Stripe: https://<your-deployment>.convex.site/stripe/webhook",
+      "file": "Stripe Dashboard"
+    },
+    {
+      "title": "Update pricing plans",
+      "description": "Update plan names, prices, and feature lists in apps/web/lib/plans.ts and packages/backend/convex/payments/config.ts to match your Stripe products.",
+      "file": "apps/web/lib/plans.ts"
+    }
+  ],
+  "postInstall": {
+    "message": "✅ Stripe web payments added. Set env vars, configure webhooks, then run convex dev."
+  }
+}

package/recipes/stripe-supabase/apps/web/app/billing/page.tsx

@@ -0,0 +1,48 @@
+'use client';
+
+import { Layout } from '@/components/Layout';
+import { BillingSection } from '@/components/payments';
+import { Authenticated, Unauthenticated } from '@/lib/supabase-provider';
+import Link from 'next/link';
+import { Button } from '@/components/ui/button';
+
+// ============================================================================
+// Billing Page
+// User's subscription and billing management
+// ============================================================================
+
+export default function BillingPage() {
+  return (
+    <Layout>
+      <div className="container max-w-2xl py-8">
+        <div className="mb-8">
+          <h1 className="text-2xl font-bold">Billing & Subscription</h1>
+          <p className="mt-1 text-muted-foreground">
+            Manage your subscription and billing details
+          </p>
+        </div>
+
+        <Authenticated>
+          <BillingSection />
+        </Authenticated>
+
+        <Unauthenticated>
+          <div className="rounded-lg border bg-card p-8 text-center">
+            <h2 className="text-lg font-semibold">Sign in to view billing</h2>
+            <p className="mt-2 text-sm text-muted-foreground">
+              You need to be signed in to manage your subscription.
+            </p>
+            <div className="mt-6 flex justify-center gap-4">
+              <Button asChild>
+                <Link href="/">Sign In</Link>
+              </Button>
+              <Button variant="outline" asChild>
+                <Link href="/pricing">View Plans</Link>
+              </Button>
+            </div>
+          </div>
+        </Unauthenticated>
+      </div>
+    </Layout>
+  );
+}

package/recipes/stripe-supabase/apps/web/app/pricing/page.tsx

@@ -0,0 +1,19 @@
+'use client';
+
+import { Layout } from '@/components/Layout';
+import { PricingSection } from '@/components/payments';
+
+// ============================================================================
+// Pricing Page
+// Displays available subscription plans
+// ============================================================================
+
+export default function PricingPage() {
+  return (
+    <Layout>
+      <div className="container max-w-6xl py-8">
+        <PricingSection />
+      </div>
+    </Layout>
+  );
+}