@paykit-sdk/stripe 1.1.7 → 1.1.9

package/README.md

@@ -5,7 +5,7 @@ Stripe provider for PayKit
 ## Quick Start
 
 ```typescript
-import { PayKit } from '@paykit-sdk/core';
+import { createEndpointHandlers, PayKit } from '@paykit-sdk/core';
 import { stripe, createStripe } from '@paykit-sdk/stripe';
 
 // Method 1: Using environment variables
@@ -17,138 +17,161 @@ const provider = createStripe({
   apiVersion: '2024-12-18.acacia',
 });
 
-const paykit = new PayKit(provider);
-
-// Create checkout
-const checkout = await paykit.checkouts.create({
-  customer_id: 'cus_123',
-  item_id: 'price_123',
-  session_type: 'one_time',
-  metadata: { plan: 'pro' },
-  provider_metadata: {
-    ui_mode: 'hosted',
-    success_url: 'https://your-app.com/success',
-  },
-});
-
-// Handle webhooks
-paykit.webhooks
-  .setup({ webhookSecret: process.env.STRIPE_WEBHOOK_SECRET })
-  .on('$checkoutCreated', async event => {
-    console.log('Checkout created:', event.data);
-  })
-  .on('$invoicePaid', async event => {
-    console.log('Payment received:', event.data);
-  });
+export const paykit = new PayKit(provider);
+export const endpoints = createEndpointHandlers(paykit);
 ```
 
-## Webhook Implementation
+### Next.js Catch All API Route (/api/paykit/[...endpoint]/route.ts)
+
+```typescript
+import { paykit } from '@/lib/paykit';
+import { EndpointPath } from '@paykit-sdk/core';
+
+export async function POST(request: NextRequest, { params }: { params: { endpoint: string[] } }) {
+  try {
+    // Construct the endpoint path with full type safety
+    const endpoint = ('/' + params.endpoint.join('/')) as EndpointPath;
+    const handler = endpoints[endpoint];
+
+    if (!handler) {
+      return NextResponse.json({ message: 'Endpoint not found' }, { status: 404 });
+    }
+
+    // Parse request body
+    const body = await request.json();
+    const { args } = body;
+
+    const result = await handler(...args);
+
+    return NextResponse.json({ result });
+  } catch (error) {
+    console.error('PayKit API Error:', error);
+    return NextResponse.json(
+      { message: error instanceof Error ? error.message : 'Internal server error' },
+      { status: 500 },
+    );
+  }
+}
+```
 
-### Next.js API Route
+### Next.js Webhooks (/api/paykit/webhooks/route.ts)
 
 ```typescript
 import { paykit } from '@/lib/paykit';
-import { NextRequest, NextResponse } from 'next/server';
+import { NextRequest } from 'next/server';
 
 export async function POST(request: NextRequest) {
-  console.log('Stripe webhook received');
+  const webhookSecret = process.env.STRIPE_WEBHOOK_SECRET;
+
+  if (!webhookSecret) {
+    return NextResponse.json({ error: 'Webhook secret not configured' }, { status: 500 });
+  }
 
   const webhook = paykit.webhooks
-    .setup({ webhookSecret: process.env.STRIPE_WEBHOOK_SECRET! })
-    .on('$checkoutCreated', async event => {
-      console.log('Checkout created:', event.data);
-      // Handle checkout creation
-    })
-    .on('$customerCreated', async event => {
+    .setup({ webhookSecret })
+    .on('customer.created', async event => {
       console.log('Customer created:', event.data);
-      // Handle customer creation
-    })
-    .on('$customerUpdated', async event => {
-      console.log('Customer updated:', event.data);
-      // Handle customer updates
-    })
-    .on('$subscriptionCreated', async event => {
+    });
+    .on('subscription.created', async event => {
       console.log('Subscription created:', event.data);
-      // Handle subscription creation
-    })
-    .on('$subscriptionUpdated', async event => {
-      console.log('Subscription updated:', event.data);
-      // Handle subscription updates
-    })
-    .on('$subscriptionCancelled', async event => {
-      console.log('Subscription cancelled:', event.data);
-      // Handle subscription cancellation
-    })
-    .on('$invoicePaid', async event => {
-      console.log('Payment received:', event.data);
-      // Handle successful payment
+    });
+    .on('payment.created', async event => {
+      console.log('Payment created:', event.data);
+    });
+    .on('refund.created', async event => {
+     console.log('Refund created:', event.data);
+    });
+    .on('invoice.generated', async event => {
+      console.log('Invoice generated:', event.data);
     });
 
-  const headers = Object.fromEntries(request.headers.entries());
   const body = await request.text();
-  await webhook.handle({ body, headers });
+  const headers = Object.fromEntries(request.headers.entries());
+  const url = request.url
+  await webhook.handle({ body, headers, fullUrl: url });
 
+  // Return immediately, processing happens in background
   return NextResponse.json({ success: true });
 }
 ```
 
-### Express.js Route
+### Express.js with Webhook Handler
 
 ```typescript
-import { paykit } from '@/lib/paykit';
+import { paykit, endpoints } from '@/lib/paykit';
+import { createEndpointHandlers, EndpointPath } from '@paykit-sdk/core';
 import express from 'express';
 
 const app = express();
-app.use(express.raw({ type: 'application/json' }));
-
-app.post('/api/webhooks/stripe', async (req, res) => {
-  console.log('Stripe webhook received');
 
-  const webhook = paykit.webhooks
-    .setup({ webhookSecret: process.env.STRIPE_WEBHOOK_SECRET! })
-    .on('$checkoutCreated', async event => {
-      console.log('Checkout created:', event.data);
-    })
-    .on('$customerCreated', async event => {
-      console.log('Customer created:', event.data);
-    })
-    .on('$invoicePaid', async event => {
-      console.log('Payment received:', event.data);
+// IMPORTANT: Webhook route must come BEFORE express.json() middleware
+// This ensures we get the raw body for signature verification
+app.post('/api/webhooks/stripe', express.raw({ type: 'application/json' }), async (req, res) => {
+  try {
+    const webhookSecret = process.env.STRIPE_WEBHOOK_SECRET;
+
+    if (!webhookSecret) {
+      return res.status(500).json({ error: 'Webhook secret not configured' });
+    }
+
+    const webhook = paykit.webhooks
+      .setup({ webhookSecret })
+      .on('customer.created', async event => {
+        console.log('Customer created:', event.data);
+      })
+      .on('subscription.created', async event => {
+        console.log('Subscription created:', event.data);
+      })
+      .on('payment.created', async event => {
+        console.log('Payment created:', event.data);
+      })
+      .on('refund.created', async event => {
+        console.log('Refund created:', event.data);
+      })
+      .on('invoice.generated', async event => {
+        console.log('Invoice generated:', event.data);
+      });
+
+    const body = req.body; // Raw buffer from express.raw()
+    const headers = req.headers;
+    const url = request.url;
+    await webhook.handle({ body, headers, fullUrl: url });
+
+    // Return immediately, processing happens in background
+    res.json({ success: true });
+  } catch (error) {
+    console.error('Webhook error:', error);
+    res.status(500).json({
+      message: error instanceof Error ? error.message : 'Webhook processing failed',
     });
-
-  const headers = req.headers;
-  const body = req.body;
-  await webhook.handle({ body, headers });
-
-  res.json({ success: true });
+  }
 });
-```
 
-### Vite.js
+// Regular API routes use JSON middleware
+app.use(express.json());
 
-```typescript
-import { paykit } from '@/lib/paykit';
+app.post('/api/paykit/*', async (req, res) => {
+  try {
+    const endpoint = req.path.replace('/api/paykit', '') as EndpointPath;
+    const handler = endpoints[endpoint];
 
-export default defineEventHandler(async event => {
-  console.log('Stripe webhook received');
+    if (!handler) {
+      return res.status(404).json({ message: 'Endpoint not found' });
+    }
 
-  const webhook = paykit.webhooks
-    .setup({ webhookSecret: process.env.STRIPE_WEBHOOK_SECRET! })
-    .on('$checkoutCreated', async event => {
-      console.log('Checkout created:', event.data);
-    })
-    .on('$customerCreated', async event => {
-      console.log('Customer created:', event.data);
-    })
-    .on('$invoicePaid', async event => {
-      console.log('Payment received:', event.data);
-    });
+    const { args } = req.body;
+    const result = await handler(...args);
 
-  const headers = getHeaders(event);
-  const body = await readBody(event);
-  await webhook.handle({ body, headers });
+    res.json({ result });
+  } catch (error) {
+    res.status(500).json({
+      message: error instanceof Error ? error.message : 'Internal server error',
+    });
+  }
+});
 
-  return { success: true };
+app.listen(3000, () => {
+  console.log('Server running on port 3000');
 });
 ```
 

package/dist/index.d.mts

@@ -1,37 +1,8 @@
-import { PaykitProviderOptions, PayKitProvider, CreateCheckoutParams, Checkout, CreateCustomerParams, Customer, UpdateCustomerParams, UpdateSubscriptionParams, Subscription, HandleWebhookParams, WebhookEventPayload } from '@paykit-sdk/core';
-import Stripe from 'stripe';
+import { StripeOptions, StripeProvider } from './stripe-provider.mjs';
+import '@paykit-sdk/core';
+import 'stripe';
 
-interface StripeConfig extends PaykitProviderOptions<Stripe.StripeConfig> {
-    apiKey: string;
-}
-declare class StripeProvider implements PayKitProvider {
-    private stripe;
-    constructor(config: StripeConfig);
-    /**
-     * Checkout management
-     */
-    createCheckout: (params: CreateCheckoutParams) => Promise<Checkout>;
-    retrieveCheckout: (id: string) => Promise<Checkout>;
-    /**
-     * Customer management
-     */
-    createCustomer: (params: CreateCustomerParams) => Promise<Customer>;
-    updateCustomer: (id: string, params: UpdateCustomerParams) => Promise<Customer>;
-    deleteCustomer: (id: string) => Promise<null>;
-    retrieveCustomer: (id: string) => Promise<Customer | null>;
-    /**
-     * Subscription management
-     */
-    cancelSubscription: (id: string) => Promise<null>;
-    updateSubscription: (id: string, params: UpdateSubscriptionParams) => Promise<Subscription>;
-    retrieveSubscription: (id: string) => Promise<Subscription>;
-    /**
-     * Webhook management
-     */
-    handleWebhook: (params: HandleWebhookParams) => Promise<WebhookEventPayload>;
-}
-
-declare const createStripe: (config: StripeConfig) => StripeProvider;
+declare const createStripe: (config: StripeOptions) => StripeProvider;
 declare const stripe: () => StripeProvider;
 
 export { createStripe, stripe };

package/dist/index.d.ts

@@ -1,37 +1,8 @@
-import { PaykitProviderOptions, PayKitProvider, CreateCheckoutParams, Checkout, CreateCustomerParams, Customer, UpdateCustomerParams, UpdateSubscriptionParams, Subscription, HandleWebhookParams, WebhookEventPayload } from '@paykit-sdk/core';
-import Stripe from 'stripe';
+import { StripeOptions, StripeProvider } from './stripe-provider.js';
+import '@paykit-sdk/core';
+import 'stripe';
 
-interface StripeConfig extends PaykitProviderOptions<Stripe.StripeConfig> {
-    apiKey: string;
-}
-declare class StripeProvider implements PayKitProvider {
-    private stripe;
-    constructor(config: StripeConfig);
-    /**
-     * Checkout management
-     */
-    createCheckout: (params: CreateCheckoutParams) => Promise<Checkout>;
-    retrieveCheckout: (id: string) => Promise<Checkout>;
-    /**
-     * Customer management
-     */
-    createCustomer: (params: CreateCustomerParams) => Promise<Customer>;
-    updateCustomer: (id: string, params: UpdateCustomerParams) => Promise<Customer>;
-    deleteCustomer: (id: string) => Promise<null>;
-    retrieveCustomer: (id: string) => Promise<Customer | null>;
-    /**
-     * Subscription management
-     */
-    cancelSubscription: (id: string) => Promise<null>;
-    updateSubscription: (id: string, params: UpdateSubscriptionParams) => Promise<Subscription>;
-    retrieveSubscription: (id: string) => Promise<Subscription>;
-    /**
-     * Webhook management
-     */
-    handleWebhook: (params: HandleWebhookParams) => Promise<WebhookEventPayload>;
-}
-
-declare const createStripe: (config: StripeConfig) => StripeProvider;
+declare const createStripe: (config: StripeOptions) => StripeProvider;
 declare const stripe: () => StripeProvider;
 
 export { createStripe, stripe };