stripe-no-webhooks 0.0.8 → 0.0.9

package/README.md

@@ -1,152 +1,90 @@
 # stripe-no-webhooks
 
-Stripe integration without dealing with webhooks. Automatically syncs Stripe data to your PostgreSQL database and provides simple callbacks for subscription events.
+Opinionated & Open Source library that automatically syncs Stripe to your database and gives you useful helpers to implement subscriptions.
 
-## Installation
+## Why this library?
+
+Stripe documentation lacks the ability to clearly point you to an easy way to implement Stripe. Depending on what you google you might end up in a weird place and shoot yourself in the foot.
+
+## Setup
+
+### 1. Install
 
 ```bash
 npm install stripe-no-webhooks stripe
 ```
 
-## Setup
-
-### 1. Create Stripe schema and tables
+Note: make sure you also have `.env` or `.env.local` in your project so it can save the generated secrets there.
 
-**Option 1:** Run the migration command
+### 2. Create tables where all Stripe data will be automatically synced
 
 ```bash
 npx stripe-no-webhooks migrate postgresql://postgres.[USER]:[PASSWORD]@[DB_URL]/postgres
 ```
 
-**Option 2:** Copy `stripe_schema.sql` and run the query manually
-
-### 2. Set up the webhook handler
-
-Create a webhook endpoint in your Next.js app:
-
-#### App Router (recommended)
-
-```ts
-// app/api/stripe/webhook/route.ts
-import { createStripeWebhookHandler } from "stripe-no-webhooks";
-
-const handler = createStripeWebhookHandler({
-  databaseUrl: process.env.DATABASE_URL!,
-  stripeSecretKey: process.env.STRIPE_SECRET_KEY!,
-  stripeWebhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
-  callbacks: {
-    onSubscriptionCreated: async (subscription) => {
-      // Called when a new subscription is created
-      console.log("New subscription:", subscription.id);
-      // e.g., send welcome email, provision resources, etc.
-    },
-    onSubscriptionCancelled: async (subscription) => {
-      // Called when a subscription is cancelled
-      console.log("Subscription cancelled:", subscription.id);
-      // e.g., send cancellation email, revoke access, etc.
-    },
-  },
-});
+### 3. Run `config` to generate files & webhook
 
-export const POST = handler;
+```bash
+npx stripe-no-webhooks config
 ```
 
-#### Pages Router
-
-```ts
-// pages/api/stripe/webhook.ts
-import { createStripeWebhookHandler } from "stripe-no-webhooks";
-import type { NextApiRequest, NextApiResponse } from "next";
-
-const handler = createStripeWebhookHandler({
-  databaseUrl: process.env.DATABASE_URL!,
-  stripeSecretKey: process.env.STRIPE_SECRET_KEY!,
-  stripeWebhookSecret: process.env.STRIPE_WEBHOOK_SECRET!,
-  callbacks: {
-    onSubscriptionCreated: async (subscription) => {
-      console.log("New subscription:", subscription.id);
-    },
-    onSubscriptionCancelled: async (subscription) => {
-      console.log("Subscription cancelled:", subscription.id);
-    },
-  },
-});
-
-// Disable body parsing, we need the raw body for webhook verification
-export const config = {
-  api: {
-    bodyParser: false,
+### 4. Create your plans
+
+```javascript
+// billing.config.ts (automatically created during config)
+import type { BillingConfig } from "stripe-no-webhooks";
+const billingConfig: BillingConfig = {
+  test: {
+    plans: [
+      {
+        name: "Premium",
+        description: "Access to all features",
+        price: [
+          {
+            amount: 1000, // $10
+            currency: "usd",
+            interval: "month",
+          },
+          {
+            amount: 10000, // $100
+            currency: "usd",
+            interval: "year",
+          },
+        ],
+      },
+    ],
   },
 };
-
-export default async function webhookHandler(
-  req: NextApiRequest,
-  res: NextApiResponse
-) {
-  if (req.method !== "POST") {
-    return res.status(405).json({ error: "Method not allowed" });
-  }
-
-  // Convert NextApiRequest to Request for the handler
-  const body = await new Promise<string>((resolve) => {
-    let data = "";
-    req.on("data", (chunk) => (data += chunk));
-    req.on("end", () => resolve(data));
-  });
-
-  const request = new Request(`https://${req.headers.host}${req.url}`, {
-    method: "POST",
-    headers: new Headers(req.headers as Record<string, string>),
-    body,
-  });
-
-  const response = await handler(request);
-  res.status(response.status).send(await response.text());
-}
+export default billingConfig;
 ```
 
-### 3. Configure Stripe webhook
-
-Run the config command to automatically create a webhook in your Stripe account:
+Run sync:
 
 ```bash
-npx stripe-no-webhooks config
+npx stripe-no-webhooks sync
 ```
 
-This will:
-
-1. Ask for your Stripe Secret Key
-2. Ask for your site URL (defaults to `NEXT_PUBLIC_SITE_URL` if set)
-3. Create a webhook endpoint at `https://yoursite.com/api/stripe/webhook` listening to all events
-4. Automatically add `STRIPE_WEBHOOK_SECRET` to your `.env` files (if they exist)
-
-## Environment Variables
-
-```env
-DATABASE_URL=postgresql://user:pass@host:port/db
-STRIPE_SECRET_KEY=sk_test_...
-STRIPE_WEBHOOK_SECRET=whsec_...  # Output from `npx stripe-no-webhooks config`
+### 5. Implement a checkout button in your frontend:
+
+```javascript
+"use client";
+import { checkout } from "stripe-no-webhooks/client";
+
+export default function Home() {
+  return (
+    <div className="min-h-screen flex items-center justify-center">
+      <button
+        className="bg-blue-500 text-white px-4 py-2 rounded-md cursor-pointer"
+        onClick={() =>
+          checkout({
+            planName: "Premium",
+            interval: "month",
+          })
+        }
+      >
+        Checkout
+      </button>
+    </div>
+  );
+}
 ```
-
-## What gets synced?
-
-All Stripe webhook events are automatically synced to your PostgreSQL database in the `stripe` schema. This includes:
-
-- Customers
-- Subscriptions
-- Products
-- Prices
-- Invoices
-- Payment methods
-- And more...
-
-You can query this data directly from your database without making API calls to Stripe.
-
-## Callbacks
-
-| Callback                  | Event                                                           | Description                               |
-| ------------------------- | --------------------------------------------------------------- | ----------------------------------------- |
-| `onSubscriptionCreated`   | `customer.subscription.created`                                 | Called when a new subscription is created |
-| `onSubscriptionCancelled` | `customer.subscription.deleted` or status changes to `canceled` | Called when a subscription is cancelled   |
-
-Both callbacks receive the full Stripe `Subscription` object.

package/bin/cli.js

@@ -4,6 +4,7 @@ const { runMigrations } = require("@supabase/stripe-sync-engine");
 const readline = require("readline");
 const fs = require("fs");
 const path = require("path");
+const { Client } = require("pg");
 
 // Load environment variables from .env files in the user's project directory
 require("dotenv").config({ path: path.join(process.cwd(), ".env.local") });
@@ -76,7 +77,9 @@ function questionHidden(rl, query, defaultValue = "") {
   });
 }
 
-async function migrate(databaseUrl) {
+async function migrate(dbUrl) {
+  const SCHEMA = "stripe";
+  const databaseUrl = dbUrl || process.env.DATABASE_URL;
   if (!databaseUrl) {
     console.error("❌ Missing database URL.\n");
     console.log(
@@ -89,16 +92,30 @@ async function migrate(databaseUrl) {
   try {
     await runMigrations({
       databaseUrl,
-      schema: "stripe",
+      schema: SCHEMA,
       logger: console,
     });
-    console.log("✅ Migrations completed successfully!");
+    const client = new Client({ connectionString: databaseUrl });
+    await client.connect();
+
+    await client.query(`
+      CREATE TABLE IF NOT EXISTS ${SCHEMA}.user_stripe_customer_map (
+        user_id text PRIMARY KEY,
+        stripe_customer_id text UNIQUE NOT NULL,
+        created_at timestamptz DEFAULT now(),
+        updated_at timestamptz DEFAULT now()
+      );
+    `);
 
-    // Save DATABASE_URL to env files
-    const envVars = [{ key: "DATABASE_URL", value: databaseUrl }];
-    const updatedFiles = saveToEnvFiles(envVars);
-    if (updatedFiles.length > 0) {
-      console.log(`📝 Updated ${updatedFiles.join(", ")} with DATABASE_URL`);
+    await client.end();
+    console.log("✅ Stripe schema migrations completed!");
+
+    if (!process.env.DATABASE_URL) {
+      const envVars = [{ key: "DATABASE_URL", value: databaseUrl }];
+      const updatedFiles = saveToEnvFiles(envVars);
+      if (updatedFiles.length > 0) {
+        console.log(`📝 Updated ${updatedFiles.join(", ")} with DATABASE_URL`);
+      }
     }
   } catch (error) {
     console.error("❌ Migration failed:");
@@ -127,10 +144,8 @@ function saveToEnvFiles(envVars) {
         const regex = new RegExp(`^${key}=.*`, "m");
 
         if (regex.test(content)) {
-          // Replace existing value
           content = content.replace(regex, line);
         } else {
-          // Append to file
           const newline = content.endsWith("\n") ? "" : "\n";
           content = content + newline + line + "\n";
         }
@@ -188,8 +203,6 @@ function createApiRoute(routerType, useSrc) {
     // App Router: app/api/stripe/[...all]/route.ts
     const routeDir = path.join(baseDir, "app", "api", "stripe", "[...all]");
     const routeFile = path.join(routeDir, "route.ts");
-
-    // Create directories if they don't exist
     fs.mkdirSync(routeDir, { recursive: true });
 
     // Get template content (remove the comment with file path)
@@ -199,7 +212,6 @@ function createApiRoute(routerType, useSrc) {
       ""
     );
 
-    // Write the file
     fs.writeFileSync(routeFile, template);
 
     const prefix = useSrc ? "src/" : "";
@@ -209,7 +221,6 @@ function createApiRoute(routerType, useSrc) {
     const routeDir = path.join(baseDir, "pages", "api", "stripe");
     const routeFile = path.join(routeDir, "[...all].ts");
 
-    // Create directories if they don't exist
     fs.mkdirSync(routeDir, { recursive: true });
 
     // Get template content (remove the comment with file path)
@@ -218,8 +229,6 @@ function createApiRoute(routerType, useSrc) {
       /^\/\/ pages\/api\/stripe\/\[\.\.\.all\]\.ts\n/,
       ""
     );
-
-    // Write the file
     fs.writeFileSync(routeFile, template);
 
     const prefix = useSrc ? "src/" : "";
@@ -245,7 +254,6 @@ async function config() {
   const srcLabel = useSrc ? " (src/)" : "";
   console.log(`📂 Detected: ${routerLabel}${srcLabel}\n`);
 
-  // Get Stripe API key (hidden input)
   const existingStripeKey = process.env.STRIPE_SECRET_KEY || "";
   const stripeSecretKey = await questionHidden(
     null,
@@ -258,10 +266,8 @@ async function config() {
     process.exit(1);
   }
 
-  // Create readline for site URL question
   const rl = createPrompt();
 
-  // Get site URL with default from env
   const defaultSiteUrl = process.env.NEXT_PUBLIC_SITE_URL || "";
   const siteUrl = await question(rl, "Enter your site URL", defaultSiteUrl);
 
@@ -271,7 +277,6 @@ async function config() {
     process.exit(1);
   }
 
-  // Validate URL
   let webhookUrl;
   try {
     const url = new URL(siteUrl);
@@ -282,7 +287,6 @@ async function config() {
     process.exit(1);
   }
 
-  // Get DATABASE_URL (optional) - skip if already set in env
   let databaseUrlInput = "";
   if (process.env.DATABASE_URL) {
     console.log("✓ DATABASE_URL already set in environment");
@@ -297,7 +301,6 @@ async function config() {
 
   rl.close();
 
-  // Create the API route
   console.log(`📁 Creating API route...`);
   try {
     const createdFile = createApiRoute(routerType, useSrc);
@@ -307,7 +310,6 @@ async function config() {
     process.exit(1);
   }
 
-  // Copy billing.config.ts to root
   console.log(`📁 Creating billing.config.ts...`);
   try {
     const billingConfigPath = path.join(process.cwd(), "billing.config.ts");
@@ -329,7 +331,6 @@ async function config() {
   const stripe = new Stripe(stripeSecretKey);
 
   try {
-    // Check if a webhook with the same URL already exists
     const existingWebhooks = await stripe.webhookEndpoints.list({ limit: 100 });
     const existingWebhook = existingWebhooks.data.find(
       (wh) => wh.url === webhookUrl
@@ -341,7 +342,6 @@ async function config() {
       console.log(`✅ Deleted existing webhook (${existingWebhook.id})\n`);
     }
 
-    // Create webhook endpoint
     console.log(`🔄 Creating new webhook endpoint...`);
     const webhook = await stripe.webhookEndpoints.create({
       url: webhookUrl,
@@ -350,7 +350,6 @@ async function config() {
     });
     console.log("✅ Webhook created successfully!\n");
 
-    // Build list of env vars to update
     const envVars = [
       { key: "STRIPE_SECRET_KEY", value: stripeSecretKey },
       { key: "STRIPE_WEBHOOK_SECRET", value: webhook.secret },
@@ -360,7 +359,6 @@ async function config() {
       envVars.push({ key: "DATABASE_URL", value: databaseUrlInput });
     }
 
-    // Save to env files
     const updatedFiles = saveToEnvFiles(envVars);
 
     const envVarNames = envVars.map((v) => v.key).join(", ");
@@ -401,7 +399,6 @@ async function config() {
 }
 
 function findMatchingBrace(content, startIndex) {
-  // Find the matching closing brace for an opening brace
   let depth = 0;
   for (let i = startIndex; i < content.length; i++) {
     if (content[i] === "{" || content[i] === "[") depth++;
@@ -462,7 +459,6 @@ function parseBillingConfig(content, mode) {
     return { config: null, plans: [] };
   }
 
-  // Convert to JSON and parse
   const jsonString = tsObjectToJson(extracted.raw);
   let config;
   try {
@@ -472,13 +468,11 @@ function parseBillingConfig(content, mode) {
     return { config: null, plans: [] };
   }
 
-  // Get plans for the specified mode
   const modeConfig = config[mode];
   if (!modeConfig || !modeConfig.plans || modeConfig.plans.length === 0) {
     return { config, plans: [], extracted };
   }
 
-  // Return parsed plans with their indices for updating
   const plans = modeConfig.plans.map((plan, index) => ({
     plan,
     index,
@@ -488,7 +482,6 @@ function parseBillingConfig(content, mode) {
 }
 
 function reorderWithIdFirst(obj) {
-  // Reorder object so 'id' is the first property if it exists
   if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
     return obj;
   }
@@ -556,7 +549,6 @@ function formatConfigToTs(config) {
     }
   }
 
-  // Convert to TypeScript object literal format (unquoted keys)
   return toTsObjectLiteral(reorderedConfig, 0);
 }
 
@@ -578,7 +570,6 @@ async function sync() {
     process.exit(1);
   }
 
-  // Get Stripe API key from env or prompt
   let stripeSecretKey = process.env.STRIPE_SECRET_KEY;
   if (!stripeSecretKey) {
     stripeSecretKey = await questionHidden(
@@ -592,7 +583,6 @@ async function sync() {
     process.exit(1);
   }
 
-  // Determine mode based on Stripe key
   let mode;
   try {
     mode = getMode(stripeSecretKey);
@@ -613,7 +603,6 @@ async function sync() {
     process.exit(1);
   }
 
-  // Ensure the mode config exists with plans array
   if (!config[mode]) {
     config[mode] = { plans: [] };
   }
@@ -629,20 +618,16 @@ async function sync() {
   let skippedProducts = 0;
   let skippedPrices = 0;
 
-  // === PULL: Fetch products and prices from Stripe and add missing ones ===
   console.log("📥 Pulling products from Stripe...\n");
 
   try {
-    // Fetch all active products from Stripe
     const stripeProducts = await stripe.products.list({
       active: true,
       limit: 100,
     });
 
-    // Fetch all active prices from Stripe
     const stripePrices = await stripe.prices.list({ active: true, limit: 100 });
 
-    // Build a map of price by product
     const pricesByProduct = {};
     for (const price of stripePrices.data) {
       const productId =
@@ -653,12 +638,10 @@ async function sync() {
       pricesByProduct[productId].push(price);
     }
 
-    // Get existing product IDs in config
     const existingProductIds = new Set(
       config[mode].plans.filter((p) => p.id).map((p) => p.id)
     );
 
-    // Get existing price IDs in config
     const existingPriceIds = new Set();
     for (const plan of config[mode].plans) {
       if (plan.price) {
@@ -749,10 +732,8 @@ async function sync() {
     console.error("❌ Failed to fetch products from Stripe:", error.message);
   }
 
-  // === PUSH: Create products and prices in Stripe from config ===
   console.log("📤 Pushing new plans to Stripe...\n");
 
-  // Re-get plans after potential modifications
   const currentPlans = config[mode].plans || [];
 
   if (currentPlans.length === 0) {
@@ -843,7 +824,6 @@ async function sync() {
     console.log("   No new products or prices to push to Stripe.\n");
   }
 
-  // Write updated config back to file
   if (configModified) {
     const newConfigJson = formatConfigToTs(config);
     const newContent =

package/dist/index.d.mts

@@ -2,6 +2,11 @@ import Stripe from 'stripe';
 import { B as BillingConfig, P as PriceInterval } from './BillingConfig-n6VbfqGY.mjs';
 export { b as Plan, a as Price } from './BillingConfig-n6VbfqGY.mjs';
 
+interface User {
+    id: string;
+    name?: string;
+    email?: string;
+}
 interface StripeWebhookCallbacks {
     /**
      * Called when a new subscription is created
@@ -52,6 +57,16 @@ interface StripeHandlerConfig {
      * Callbacks for subscription events
      */
     callbacks?: StripeWebhookCallbacks;
+    /**
+     * Function to map a user ID to a Stripe customer ID.
+     * Used as fallback when user is not found in user_stripe_customer_map table.
+     */
+    mapUserIdToStripeCustomerId?: (userId: string) => string | Promise<string> | null | Promise<string | null>;
+    /**
+     * Function to extract user from the request.
+     * Useful for extracting user from authentication middleware/session.
+     */
+    getUser?: (request: Request) => User | Promise<User> | null | Promise<User | null>;
 }
 interface CheckoutRequestBody {
     /**
@@ -90,11 +105,30 @@ interface CheckoutRequestBody {
      * Existing Stripe customer ID
      */
     customerId?: string;
+    /**
+     * User object to associate with this checkout.
+     * Will be used to look up or create a Stripe customer.
+     */
+    user?: User;
     /**
      * Additional metadata to attach to the session
      */
     metadata?: Record<string, string>;
 }
+interface CustomerPortalRequestBody {
+    /**
+     * Stripe customer ID (cus_...)
+     */
+    stripe_customer_id?: string;
+    /**
+     * User object to look up Stripe customer ID
+     */
+    user?: User;
+    /**
+     * URL to redirect to after the customer portal session ends
+     */
+    returnUrl?: string;
+}
 declare function createStripeHandler(config?: StripeHandlerConfig): (request: Request) => Promise<Response>;
 
-export { BillingConfig, type CheckoutRequestBody, PriceInterval, type StripeHandlerConfig, type StripeWebhookCallbacks, createStripeHandler };
+export { BillingConfig, type CheckoutRequestBody, type CustomerPortalRequestBody, PriceInterval, type StripeHandlerConfig, type StripeWebhookCallbacks, type User, createStripeHandler };

package/dist/index.d.ts

@@ -2,6 +2,11 @@ import Stripe from 'stripe';
 import { B as BillingConfig, P as PriceInterval } from './BillingConfig-n6VbfqGY.js';
 export { b as Plan, a as Price } from './BillingConfig-n6VbfqGY.js';
 
+interface User {
+    id: string;
+    name?: string;
+    email?: string;
+}
 interface StripeWebhookCallbacks {
     /**
      * Called when a new subscription is created
@@ -52,6 +57,16 @@ interface StripeHandlerConfig {
      * Callbacks for subscription events
      */
     callbacks?: StripeWebhookCallbacks;
+    /**
+     * Function to map a user ID to a Stripe customer ID.
+     * Used as fallback when user is not found in user_stripe_customer_map table.
+     */
+    mapUserIdToStripeCustomerId?: (userId: string) => string | Promise<string> | null | Promise<string | null>;
+    /**
+     * Function to extract user from the request.
+     * Useful for extracting user from authentication middleware/session.
+     */
+    getUser?: (request: Request) => User | Promise<User> | null | Promise<User | null>;
 }
 interface CheckoutRequestBody {
     /**
@@ -90,11 +105,30 @@ interface CheckoutRequestBody {
      * Existing Stripe customer ID
      */
     customerId?: string;
+    /**
+     * User object to associate with this checkout.
+     * Will be used to look up or create a Stripe customer.
+     */
+    user?: User;
     /**
      * Additional metadata to attach to the session
      */
     metadata?: Record<string, string>;
 }
+interface CustomerPortalRequestBody {
+    /**
+     * Stripe customer ID (cus_...)
+     */
+    stripe_customer_id?: string;
+    /**
+     * User object to look up Stripe customer ID
+     */
+    user?: User;
+    /**
+     * URL to redirect to after the customer portal session ends
+     */
+    returnUrl?: string;
+}
 declare function createStripeHandler(config?: StripeHandlerConfig): (request: Request) => Promise<Response>;
 
-export { BillingConfig, type CheckoutRequestBody, PriceInterval, type StripeHandlerConfig, type StripeWebhookCallbacks, createStripeHandler };
+export { BillingConfig, type CheckoutRequestBody, type CustomerPortalRequestBody, PriceInterval, type StripeHandlerConfig, type StripeWebhookCallbacks, type User, createStripeHandler };

package/dist/index.js

@@ -37,6 +37,7 @@ module.exports = __toCommonJS(index_exports);
 // src/handler.ts
 var import_stripe_sync_engine = require("@supabase/stripe-sync-engine");
 var import_stripe = __toESM(require("stripe"));
+var import_pg = require("pg");
 
 // src/utils.ts
 var getMode = (stripeKey) => {
@@ -60,9 +61,12 @@ function createStripeHandler(config = {}) {
     successUrl: defaultSuccessUrl,
     cancelUrl: defaultCancelUrl,
     automaticTax = true,
-    callbacks
+    callbacks,
+    mapUserIdToStripeCustomerId,
+    getUser
   } = config;
   const stripe = new import_stripe.default(stripeSecretKey);
+  const pool = databaseUrl ? new import_pg.Pool({ connectionString: databaseUrl }) : null;
   const sync = databaseUrl ? new import_stripe_sync_engine.StripeSync({
     poolConfig: {
       connectionString: databaseUrl
@@ -71,6 +75,47 @@ function createStripeHandler(config = {}) {
     stripeSecretKey,
     stripeWebhookSecret
   }) : null;
+  async function resolveStripeCustomerId(options) {
+    const { user, createIfNotFound } = options;
+    const { id: userId, name, email } = user;
+    if (pool) {
+      const result = await pool.query(
+        `SELECT stripe_customer_id FROM ${schema}.user_stripe_customer_map WHERE user_id = $1`,
+        [userId]
+      );
+      if (result.rows.length > 0) {
+        return result.rows[0].stripe_customer_id;
+      }
+    }
+    if (mapUserIdToStripeCustomerId) {
+      const customerId = await mapUserIdToStripeCustomerId(userId);
+      if (customerId) {
+        return customerId;
+      }
+    }
+    if (createIfNotFound) {
+      const customerParams = {
+        metadata: { user_id: userId }
+      };
+      if (name) {
+        customerParams.name = name;
+      }
+      if (email) {
+        customerParams.email = email;
+      }
+      const customer = await stripe.customers.create(customerParams);
+      if (pool) {
+        await pool.query(
+          `INSERT INTO ${schema}.user_stripe_customer_map (user_id, stripe_customer_id) 
+         VALUES ($1, $2) 
+         ON CONFLICT (user_id) DO UPDATE SET stripe_customer_id = $2, updated_at = now()`,
+          [userId, customer.id]
+        );
+      }
+      return customer.id;
+    }
+    return null;
+  }
   function resolvePriceId(body, mode) {
     if (body.priceId) {
       return body.priceId;
@@ -133,11 +178,25 @@ function createStripeHandler(config = {}) {
         cancel_url: cancelUrl,
         automatic_tax: { enabled: automaticTax }
       };
-      if (body.customerEmail) {
-        sessionParams.customer_email = body.customerEmail;
-      }
+      let customerId = null;
       if (body.customerId) {
-        sessionParams.customer = body.customerId;
+        customerId = body.customerId;
+      } else {
+        let user = body.user;
+        if (!user && getUser) {
+          user = await getUser(request) ?? void 0;
+        }
+        if (user) {
+          customerId = await resolveStripeCustomerId({
+            user,
+            createIfNotFound: true
+          });
+        }
+      }
+      if (customerId) {
+        sessionParams.customer = customerId;
+      } else if (body.customerEmail) {
+        sessionParams.customer_email = body.customerEmail;
       }
       if (body.metadata) {
         sessionParams.metadata = body.metadata;
@@ -212,6 +271,56 @@ function createStripeHandler(config = {}) {
       return new Response(message, { status: 500 });
     }
   }
+  async function handleCustomerPortal(request) {
+    try {
+      const body = await request.json();
+      let customerId = null;
+      if (body.stripe_customer_id) {
+        customerId = body.stripe_customer_id;
+      } else {
+        let user = body.user;
+        if (!user && getUser) {
+          user = await getUser(request) ?? void 0;
+        }
+        if (user) {
+          customerId = await resolveStripeCustomerId({
+            user,
+            createIfNotFound: false
+          });
+        }
+      }
+      if (!customerId) {
+        return new Response(
+          JSON.stringify({
+            error: "Provide either stripe_customer_id or user. Alternatively, configure getUser to extract user from the request."
+          }),
+          { status: 400, headers: { "Content-Type": "application/json" } }
+        );
+      }
+      const origin = request.headers.get("origin") || "";
+      const returnUrl = body.returnUrl || `${origin}/`;
+      const session = await stripe.billingPortal.sessions.create({
+        customer: customerId,
+        return_url: returnUrl
+      });
+      const acceptHeader = request.headers.get("accept") || "";
+      if (acceptHeader.includes("application/json")) {
+        return new Response(JSON.stringify({ url: session.url }), {
+          status: 200,
+          headers: { "Content-Type": "application/json" }
+        });
+      }
+      return Response.redirect(session.url, 303);
+    } catch (err) {
+      console.error("Customer portal error:", err);
+      const message = err instanceof Error ? err.message : "Unknown error";
+      const status = err && typeof err === "object" && "statusCode" in err ? err.statusCode : 500;
+      return new Response(JSON.stringify({ error: message }), {
+        status,
+        headers: { "Content-Type": "application/json" }
+      });
+    }
+  }
   return async function handler(request) {
     const url = new URL(request.url);
     const pathSegments = url.pathname.split("/").filter(Boolean);
@@ -227,10 +336,12 @@ function createStripeHandler(config = {}) {
         return handleCheckout(request);
       case "webhook":
         return handleWebhook(request);
+      case "customer_portal":
+        return handleCustomerPortal(request);
       default:
         return new Response(
           JSON.stringify({
-            error: `Unknown action: ${action}. Supported: checkout, webhook`
+            error: `Unknown action: ${action}. Supported: checkout, webhook, customer_portal`
           }),
           { status: 404, headers: { "Content-Type": "application/json" } }
         );

package/dist/index.mjs

@@ -1,6 +1,7 @@
 // src/handler.ts
 import { StripeSync } from "@supabase/stripe-sync-engine";
 import Stripe from "stripe";
+import { Pool } from "pg";
 
 // src/utils.ts
 var getMode = (stripeKey) => {
@@ -24,9 +25,12 @@ function createStripeHandler(config = {}) {
     successUrl: defaultSuccessUrl,
     cancelUrl: defaultCancelUrl,
     automaticTax = true,
-    callbacks
+    callbacks,
+    mapUserIdToStripeCustomerId,
+    getUser
   } = config;
   const stripe = new Stripe(stripeSecretKey);
+  const pool = databaseUrl ? new Pool({ connectionString: databaseUrl }) : null;
   const sync = databaseUrl ? new StripeSync({
     poolConfig: {
       connectionString: databaseUrl
@@ -35,6 +39,47 @@ function createStripeHandler(config = {}) {
     stripeSecretKey,
     stripeWebhookSecret
   }) : null;
+  async function resolveStripeCustomerId(options) {
+    const { user, createIfNotFound } = options;
+    const { id: userId, name, email } = user;
+    if (pool) {
+      const result = await pool.query(
+        `SELECT stripe_customer_id FROM ${schema}.user_stripe_customer_map WHERE user_id = $1`,
+        [userId]
+      );
+      if (result.rows.length > 0) {
+        return result.rows[0].stripe_customer_id;
+      }
+    }
+    if (mapUserIdToStripeCustomerId) {
+      const customerId = await mapUserIdToStripeCustomerId(userId);
+      if (customerId) {
+        return customerId;
+      }
+    }
+    if (createIfNotFound) {
+      const customerParams = {
+        metadata: { user_id: userId }
+      };
+      if (name) {
+        customerParams.name = name;
+      }
+      if (email) {
+        customerParams.email = email;
+      }
+      const customer = await stripe.customers.create(customerParams);
+      if (pool) {
+        await pool.query(
+          `INSERT INTO ${schema}.user_stripe_customer_map (user_id, stripe_customer_id) 
+         VALUES ($1, $2) 
+         ON CONFLICT (user_id) DO UPDATE SET stripe_customer_id = $2, updated_at = now()`,
+          [userId, customer.id]
+        );
+      }
+      return customer.id;
+    }
+    return null;
+  }
   function resolvePriceId(body, mode) {
     if (body.priceId) {
       return body.priceId;
@@ -97,11 +142,25 @@ function createStripeHandler(config = {}) {
         cancel_url: cancelUrl,
         automatic_tax: { enabled: automaticTax }
       };
-      if (body.customerEmail) {
-        sessionParams.customer_email = body.customerEmail;
-      }
+      let customerId = null;
       if (body.customerId) {
-        sessionParams.customer = body.customerId;
+        customerId = body.customerId;
+      } else {
+        let user = body.user;
+        if (!user && getUser) {
+          user = await getUser(request) ?? void 0;
+        }
+        if (user) {
+          customerId = await resolveStripeCustomerId({
+            user,
+            createIfNotFound: true
+          });
+        }
+      }
+      if (customerId) {
+        sessionParams.customer = customerId;
+      } else if (body.customerEmail) {
+        sessionParams.customer_email = body.customerEmail;
       }
       if (body.metadata) {
         sessionParams.metadata = body.metadata;
@@ -176,6 +235,56 @@ function createStripeHandler(config = {}) {
       return new Response(message, { status: 500 });
     }
   }
+  async function handleCustomerPortal(request) {
+    try {
+      const body = await request.json();
+      let customerId = null;
+      if (body.stripe_customer_id) {
+        customerId = body.stripe_customer_id;
+      } else {
+        let user = body.user;
+        if (!user && getUser) {
+          user = await getUser(request) ?? void 0;
+        }
+        if (user) {
+          customerId = await resolveStripeCustomerId({
+            user,
+            createIfNotFound: false
+          });
+        }
+      }
+      if (!customerId) {
+        return new Response(
+          JSON.stringify({
+            error: "Provide either stripe_customer_id or user. Alternatively, configure getUser to extract user from the request."
+          }),
+          { status: 400, headers: { "Content-Type": "application/json" } }
+        );
+      }
+      const origin = request.headers.get("origin") || "";
+      const returnUrl = body.returnUrl || `${origin}/`;
+      const session = await stripe.billingPortal.sessions.create({
+        customer: customerId,
+        return_url: returnUrl
+      });
+      const acceptHeader = request.headers.get("accept") || "";
+      if (acceptHeader.includes("application/json")) {
+        return new Response(JSON.stringify({ url: session.url }), {
+          status: 200,
+          headers: { "Content-Type": "application/json" }
+        });
+      }
+      return Response.redirect(session.url, 303);
+    } catch (err) {
+      console.error("Customer portal error:", err);
+      const message = err instanceof Error ? err.message : "Unknown error";
+      const status = err && typeof err === "object" && "statusCode" in err ? err.statusCode : 500;
+      return new Response(JSON.stringify({ error: message }), {
+        status,
+        headers: { "Content-Type": "application/json" }
+      });
+    }
+  }
   return async function handler(request) {
     const url = new URL(request.url);
     const pathSegments = url.pathname.split("/").filter(Boolean);
@@ -191,10 +300,12 @@ function createStripeHandler(config = {}) {
         return handleCheckout(request);
       case "webhook":
         return handleWebhook(request);
+      case "customer_portal":
+        return handleCustomerPortal(request);
       default:
         return new Response(
           JSON.stringify({
-            error: `Unknown action: ${action}. Supported: checkout, webhook`
+            error: `Unknown action: ${action}. Supported: checkout, webhook, customer_portal`
           }),
           { status: 404, headers: { "Content-Type": "application/json" } }
         );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe-no-webhooks",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "author": "Ramon Garate",
   "description": "Stripe integration without dealing with webhooks",
   "main": "./dist/index.js",
@@ -34,13 +34,15 @@
   },
   "dependencies": {
     "@supabase/stripe-sync-engine": "^0.47.0",
-    "dotenv": "^17.2.3"
+    "dotenv": "^17.2.3",
+    "pg": "^8.13.1"
   },
   "peerDependencies": {
     "stripe": ">=14.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
+    "@types/pg": "^8.16.0",
     "stripe": "^17.4.0",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2"