@xenterprises/fastify-xstripe 1.0.0

package/server/app.js

@@ -0,0 +1,557 @@
+// server/app.js - Example Fastify server with xStripe
+import Fastify from 'fastify';
+import xStripe from '../src/xStripe.js';
+
+const fastify = Fastify({
+  logger: true,
+  // Enable raw body for webhook signature verification
+  rawBody: true,
+});
+
+// Register xStripe with custom handlers
+await fastify.register(xStripe, {
+  apiKey: process.env.STRIPE_API_KEY,
+  webhookSecret: process.env.STRIPE_WEBHOOK_SECRET,
+  webhookPath: '/stripe/webhook',
+  handlers: {
+    // Custom handler for new subscriptions
+    'customer.subscription.created': async (event, fastify, stripe) => {
+      const subscription = event.data.object;
+
+      fastify.log.info({
+        msg: '🎉 New subscription!',
+        customerId: subscription.customer,
+        subscriptionId: subscription.id,
+        plan: subscription.items.data[0]?.price.product,
+        status: subscription.status,
+      });
+
+      // Example: Update database (uncomment if using Prisma)
+      // await fastify.prisma.user.update({
+      //   where: { stripeCustomerId: subscription.customer },
+      //   data: {
+      //     subscriptionId: subscription.id,
+      //     subscriptionStatus: subscription.status,
+      //     planId: subscription.items.data[0]?.price.id,
+      //     trialEnd: subscription.trial_end
+      //       ? new Date(subscription.trial_end * 1000)
+      //       : null,
+      //   },
+      // });
+    },
+
+    // Custom handler for subscription updates
+    'customer.subscription.updated': async (event, fastify, stripe) => {
+      const subscription = event.data.object;
+      const previous = event.data.previous_attributes || {};
+
+      if ('status' in previous) {
+        fastify.log.info({
+          msg: 'Subscription status changed',
+          subscriptionId: subscription.id,
+          oldStatus: previous.status,
+          newStatus: subscription.status,
+        });
+
+        // Handle specific status transitions
+        if (subscription.status === 'active' && previous.status === 'trialing') {
+          fastify.log.info('✅ Trial converted to paid subscription');
+        }
+
+        if (subscription.status === 'past_due') {
+          fastify.log.warn('⚠️  Subscription past due - payment failed');
+        }
+
+        if (subscription.status === 'canceled') {
+          fastify.log.info('❌ Subscription canceled');
+        }
+      }
+    },
+
+    // Custom handler for failed payments
+    'invoice.payment_failed': async (event, fastify, stripe) => {
+      const invoice = event.data.object;
+
+      fastify.log.error({
+        msg: '💳 Payment failed',
+        invoiceId: invoice.id,
+        customerId: invoice.customer,
+        amount: invoice.amount_due / 100,
+        attemptCount: invoice.attempt_count,
+      });
+
+      // Example: Track failed payments
+      // await fastify.prisma.user.update({
+      //   where: { stripeCustomerId: invoice.customer },
+      //   data: {
+      //     failedPaymentCount: { increment: 1 },
+      //     lastFailedPayment: new Date(),
+      //   },
+      // });
+    },
+
+    // Custom handler for successful payments
+    'invoice.paid': async (event, fastify, stripe) => {
+      const invoice = event.data.object;
+
+      fastify.log.info({
+        msg: '✅ Payment successful',
+        invoiceId: invoice.id,
+        customerId: invoice.customer,
+        amount: invoice.amount_paid / 100,
+      });
+
+      // Example: Reset failed payment count
+      // await fastify.prisma.user.update({
+      //   where: { stripeCustomerId: invoice.customer },
+      //   data: {
+      //     failedPaymentCount: 0,
+      //     lastSuccessfulPayment: new Date(),
+      //   },
+      // });
+    },
+  },
+});
+
+// ============================================================================
+// Example API Routes - Subscription Management
+// ============================================================================
+
+// Create subscription checkout session
+fastify.post('/create-checkout-session', async (request, reply) => {
+  const { priceId, customerId } = request.body;
+
+  try {
+    const session = await fastify.stripe.checkout.sessions.create({
+      customer: customerId,
+      mode: 'subscription',
+      line_items: [{ price: priceId, quantity: 1 }],
+      success_url: `${process.env.DOMAIN}/success?session_id={CHECKOUT_SESSION_ID}`,
+      cancel_url: `${process.env.DOMAIN}/cancel`,
+    });
+
+    return { sessionId: session.id, url: session.url };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+// Create customer
+fastify.post('/create-customer', async (request, reply) => {
+  const { email, name } = request.body;
+
+  try {
+    const customer = await fastify.stripe.customers.create({
+      email,
+      name,
+    });
+
+    return { customerId: customer.id };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+// Get subscription status
+fastify.get('/subscription/:id', async (request, reply) => {
+  const { id } = request.params;
+
+  try {
+    const subscription = await fastify.stripe.subscriptions.retrieve(id);
+
+    return {
+      id: subscription.id,
+      status: subscription.status,
+      currentPeriodEnd: new Date(subscription.current_period_end * 1000),
+      cancelAtPeriodEnd: subscription.cancel_at_period_end,
+    };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(404).send({ error: 'Subscription not found' });
+  }
+});
+
+// Cancel subscription
+fastify.post('/cancel-subscription/:id', async (request, reply) => {
+  const { id } = request.params;
+  const { immediately = false } = request.body;
+
+  try {
+    let subscription;
+
+    if (immediately) {
+      subscription = await fastify.stripe.subscriptions.cancel(id);
+    } else {
+      subscription = await fastify.stripe.subscriptions.update(id, {
+        cancel_at_period_end: true,
+      });
+    }
+
+    return { subscriptionId: subscription.id, status: subscription.status };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+// ============================================================================
+// FEATURE 1: Plan Listing
+// ============================================================================
+
+/**
+ * GET /plans
+ * List all available products and their prices
+ * @returns Array of products with pricing information
+ */
+fastify.get('/plans', async (request, reply) => { // request unused but available for future pagination params
+  try {
+    // Get all products
+    const products = await fastify.stripe.products.list({
+      active: true,
+      limit: 100,
+    });
+
+    // Get prices for each product
+    const plans = await Promise.all(
+      products.data.map(async (product) => {
+        const prices = await fastify.stripe.prices.list({
+          product: product.id,
+          active: true,
+          type: 'recurring',
+        });
+
+        return {
+          productId: product.id,
+          name: product.name,
+          description: product.description,
+          images: product.images,
+          metadata: product.metadata,
+          prices: prices.data.map((price) => ({
+            priceId: price.id,
+            amount: price.unit_amount / 100, // Convert cents to dollars
+            currency: price.currency.toUpperCase(),
+            interval: price.recurring?.interval,
+            intervalCount: price.recurring?.interval_count || 1,
+            trialPeriodDays: price.recurring?.trial_period_days,
+            nickname: price.nickname,
+            metadata: price.metadata,
+          })),
+        };
+      })
+    );
+
+    return { plans };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+/**
+ * GET /plans/:productId
+ * Get a specific product with all its prices
+ */
+fastify.get('/plans/:productId', async (request, reply) => {
+  const { productId } = request.params;
+
+  try {
+    const product = await fastify.stripe.products.retrieve(productId);
+    const prices = await fastify.stripe.prices.list({
+      product: productId,
+      active: true,
+    });
+
+    return {
+      productId: product.id,
+      name: product.name,
+      description: product.description,
+      images: product.images,
+      metadata: product.metadata,
+      prices: prices.data.map((price) => ({
+        priceId: price.id,
+        amount: price.unit_amount / 100,
+        currency: price.currency.toUpperCase(),
+        interval: price.recurring?.interval,
+        intervalCount: price.recurring?.interval_count || 1,
+        trialPeriodDays: price.recurring?.trial_period_days,
+        nickname: price.nickname,
+      })),
+    };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(404).send({ error: 'Product not found' });
+  }
+});
+
+// ============================================================================
+// FEATURE 2: One-Time Payments
+// ============================================================================
+
+/**
+ * POST /create-payment-session
+ * Create a checkout session for one-time payment
+ * @body { customerId, priceId, quantity, metadata }
+ */
+fastify.post('/create-payment-session', async (request, reply) => {
+  const { customerId, priceId, quantity = 1, metadata = {} } = request.body;
+
+  try {
+    const session = await fastify.stripe.checkout.sessions.create({
+      customer: customerId,
+      mode: 'payment',
+      line_items: [
+        {
+          price: priceId,
+          quantity,
+        },
+      ],
+      success_url: `${process.env.DOMAIN}/success?session_id={CHECKOUT_SESSION_ID}`,
+      cancel_url: `${process.env.DOMAIN}/cancel`,
+      metadata,
+    });
+
+    return { sessionId: session.id, url: session.url };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+// ============================================================================
+// FEATURE 3: Subscription Listing & Management
+// ============================================================================
+
+/**
+ * GET /customer/:customerId/subscriptions
+ * List all subscriptions for a customer
+ */
+fastify.get('/customer/:customerId/subscriptions', async (request, reply) => {
+  const { customerId } = request.params;
+
+  try {
+    const subscriptions = await fastify.stripe.subscriptions.list({
+      customer: customerId,
+      limit: 100,
+    });
+
+    return {
+      subscriptions: subscriptions.data.map((sub) => ({
+        id: sub.id,
+        status: sub.status,
+        planId: sub.items.data[0]?.price.id,
+        planName: sub.items.data[0]?.price.nickname,
+        amount: sub.items.data[0]?.price.unit_amount / 100,
+        currency: sub.items.data[0]?.price.currency.toUpperCase(),
+        interval: sub.items.data[0]?.price.recurring?.interval,
+        createdAt: new Date(sub.created * 1000),
+        currentPeriodEnd: new Date(sub.current_period_end * 1000),
+        cancelAtPeriodEnd: sub.cancel_at_period_end,
+        canceledAt: sub.canceled_at ? new Date(sub.canceled_at * 1000) : null,
+      })),
+      total: subscriptions.data.length,
+    };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+/**
+ * POST /subscription/:id/update
+ * Update a subscription (change plan, apply coupon, etc.)
+ * @body { priceId, quantity, coupon, metadata, prorationBehavior }
+ */
+fastify.post('/subscription/:id/update', async (request, reply) => {
+  const { id } = request.params;
+  const {
+    priceId,
+    quantity = 1,
+    coupon,
+    metadata,
+    prorationBehavior = 'create_prorations',
+  } = request.body;
+
+  try {
+    const subscription = await fastify.stripe.subscriptions.retrieve(id);
+    const itemId = subscription.items.data[0]?.id;
+
+    const updateData = {
+      items: [
+        {
+          id: itemId,
+          price: priceId,
+          quantity,
+        },
+      ],
+      proration_behavior: prorationBehavior, // 'create_prorations', 'none', 'always_invoice'
+    };
+
+    if (coupon) {
+      updateData.coupon = coupon;
+    }
+
+    if (metadata) {
+      updateData.metadata = metadata;
+    }
+
+    const updated = await fastify.stripe.subscriptions.update(id, updateData);
+
+    return {
+      id: updated.id,
+      status: updated.status,
+      priceId: updated.items.data[0]?.price.id,
+      amount: updated.items.data[0]?.price.unit_amount / 100,
+      nextBillingDate: new Date(updated.current_period_end * 1000),
+      message: 'Subscription updated successfully',
+    };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+// ============================================================================
+// FEATURE 4: Payment Methods Management
+// ============================================================================
+
+/**
+ * GET /customer/:customerId/payment-methods
+ * List all payment methods for a customer
+ */
+fastify.get('/customer/:customerId/payment-methods', async (request, reply) => {
+  const { customerId } = request.params;
+
+  try {
+    const paymentMethods = await fastify.stripe.paymentMethods.list({
+      customer: customerId,
+      type: 'card',
+    });
+
+    // Get default payment method from customer
+    const customer = await fastify.stripe.customers.retrieve(customerId);
+
+    return {
+      paymentMethods: paymentMethods.data.map((pm) => ({
+        id: pm.id,
+        type: pm.type,
+        isDefault: pm.id === customer.invoice_settings?.default_payment_method,
+        card: {
+          brand: pm.card?.brand,
+          last4: pm.card?.last4,
+          expMonth: pm.card?.exp_month,
+          expYear: pm.card?.exp_year,
+        },
+        billingDetails: pm.billing_details,
+        createdAt: new Date(pm.created * 1000),
+      })),
+      defaultPaymentMethodId: customer.invoice_settings?.default_payment_method,
+      total: paymentMethods.data.length,
+    };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+/**
+ * POST /customer/:customerId/payment-methods
+ * Add a new payment method to a customer (requires payment method ID from frontend)
+ * @body { paymentMethodId }
+ */
+fastify.post('/customer/:customerId/payment-methods', async (request, reply) => {
+  const { customerId } = request.params;
+  const { paymentMethodId } = request.body;
+
+  try {
+    // Attach payment method to customer
+    await fastify.stripe.paymentMethods.attach(paymentMethodId, {
+      customer: customerId,
+    });
+
+    const paymentMethod = await fastify.stripe.paymentMethods.retrieve(
+      paymentMethodId
+    );
+
+    return {
+      id: paymentMethod.id,
+      type: paymentMethod.type,
+      card: {
+        brand: paymentMethod.card?.brand,
+        last4: paymentMethod.card?.last4,
+        expMonth: paymentMethod.card?.exp_month,
+        expYear: paymentMethod.card?.exp_year,
+      },
+      message: 'Payment method added successfully',
+    };
+  } catch (error) {
+    fastify.log.error(error);
+    return reply.code(500).send({ error: error.message });
+  }
+});
+
+/**
+ * POST /customer/:customerId/payment-methods/:paymentMethodId/default
+ * Set a payment method as default for a customer
+ */
+fastify.post(
+  '/customer/:customerId/payment-methods/:paymentMethodId/default',
+  async (request, reply) => {
+    const { customerId, paymentMethodId } = request.params;
+
+    try {
+      const customer = await fastify.stripe.customers.update(customerId, {
+        invoice_settings: {
+          default_payment_method: paymentMethodId,
+        },
+      });
+
+      return {
+        customerId: customer.id,
+        defaultPaymentMethodId: customer.invoice_settings?.default_payment_method,
+        message: 'Default payment method updated successfully',
+      };
+    } catch (error) {
+      fastify.log.error(error);
+      return reply.code(500).send({ error: error.message });
+    }
+  }
+);
+
+/**
+ * DELETE /customer/:customerId/payment-methods/:paymentMethodId
+ * Remove a payment method from a customer
+ */
+fastify.delete(
+  '/customer/:customerId/payment-methods/:paymentMethodId',
+  async (request, reply) => {
+    const { paymentMethodId } = request.params;
+
+    try {
+      await fastify.stripe.paymentMethods.detach(paymentMethodId);
+
+      return {
+        paymentMethodId,
+        message: 'Payment method removed successfully',
+      };
+    } catch (error) {
+      fastify.log.error(error);
+      return reply.code(500).send({ error: error.message });
+    }
+  }
+);
+
+// ============================================================================
+// Health Check
+// ============================================================================
+
+fastify.get('/health', async () => {
+  return {
+    status: 'ok',
+    stripe: !!fastify.stripe,
+    timestamp: new Date().toISOString(),
+  };
+});
+
+export default fastify;