stripe-no-webhooks 0.0.8 → 0.0.11

package/dist/BillingConfig-CpHPJg4Q.d.mts

@@ -0,0 +1,54 @@
+type PriceInterval = "month" | "year" | "week" | "one_time";
+type Price = {
+    id?: string;
+    amount: number;
+    currency: string;
+    interval: PriceInterval;
+};
+type OnDemandTopUp = {
+    mode: "on_demand";
+    pricePerCreditCents: number;
+    minPerPurchase?: number;
+    maxPerPurchase?: number;
+};
+type AutoTopUp = {
+    mode: "auto";
+    pricePerCreditCents: number;
+    balanceThreshold: number;
+    purchaseAmount: number;
+    maxPerMonth?: number;
+};
+type CreditConfig = {
+    allocation: number;
+    displayName?: string;
+    /**
+     * What happens on renewal (default: 'reset')
+     * - 'reset': Set balance to allocation (unused credits expire)
+     * - 'add': Add allocation to current balance (credits accumulate)
+     */
+    onRenewal?: "reset" | "add";
+    topUp?: OnDemandTopUp | AutoTopUp;
+};
+type Plan = {
+    id?: string;
+    name: string;
+    description?: string;
+    price: Price[];
+    credits?: Record<string, CreditConfig>;
+    /**
+     * Enable per-seat billing for this plan.
+     * When true, addSeat/removeSeat will update Stripe subscription quantity.
+     * Stripe automatically prorates charges when quantity changes.
+     */
+    perSeat?: boolean;
+};
+type BillingConfig = {
+    test?: {
+        plans?: Plan[];
+    };
+    production?: {
+        plans?: Plan[];
+    };
+};
+
+export type { AutoTopUp as A, BillingConfig as B, CreditConfig as C, OnDemandTopUp as O, PriceInterval as P, Price as a, Plan as b };

package/dist/BillingConfig-CpHPJg4Q.d.ts

@@ -0,0 +1,54 @@
+type PriceInterval = "month" | "year" | "week" | "one_time";
+type Price = {
+    id?: string;
+    amount: number;
+    currency: string;
+    interval: PriceInterval;
+};
+type OnDemandTopUp = {
+    mode: "on_demand";
+    pricePerCreditCents: number;
+    minPerPurchase?: number;
+    maxPerPurchase?: number;
+};
+type AutoTopUp = {
+    mode: "auto";
+    pricePerCreditCents: number;
+    balanceThreshold: number;
+    purchaseAmount: number;
+    maxPerMonth?: number;
+};
+type CreditConfig = {
+    allocation: number;
+    displayName?: string;
+    /**
+     * What happens on renewal (default: 'reset')
+     * - 'reset': Set balance to allocation (unused credits expire)
+     * - 'add': Add allocation to current balance (credits accumulate)
+     */
+    onRenewal?: "reset" | "add";
+    topUp?: OnDemandTopUp | AutoTopUp;
+};
+type Plan = {
+    id?: string;
+    name: string;
+    description?: string;
+    price: Price[];
+    credits?: Record<string, CreditConfig>;
+    /**
+     * Enable per-seat billing for this plan.
+     * When true, addSeat/removeSeat will update Stripe subscription quantity.
+     * Stripe automatically prorates charges when quantity changes.
+     */
+    perSeat?: boolean;
+};
+type BillingConfig = {
+    test?: {
+        plans?: Plan[];
+    };
+    production?: {
+        plans?: Plan[];
+    };
+};
+
+export type { AutoTopUp as A, BillingConfig as B, CreditConfig as C, OnDemandTopUp as O, PriceInterval as P, Price as a, Plan as b };

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { P as PriceInterval } from './BillingConfig-n6VbfqGY.mjs';
+import { P as PriceInterval } from './BillingConfig-CpHPJg4Q.mjs';
 
 interface CheckoutOptions {
     /**
@@ -21,10 +21,6 @@ interface CheckoutOptions {
      * Quantity of the item (defaults to 1)
      */
     quantity?: number;
-    /**
-     * Customer email for prefilling checkout
-     */
-    customerEmail?: string;
     /**
      * Override success URL for this checkout
      */
@@ -43,6 +39,28 @@ interface CheckoutClientConfig {
      * API endpoint for checkout (defaults to /api/stripe/checkout)
      */
     checkoutEndpoint?: string;
+    /**
+     * API endpoint for customer portal (defaults to /api/stripe/customer_portal)
+     */
+    customerPortalEndpoint?: string;
+    /**
+     * Called when loading state changes (start/end of API calls)
+     */
+    onLoading?: (isLoading: boolean) => void;
+    /**
+     * Called when an error occurs during checkout or portal access
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called right before redirecting to Stripe (checkout or portal)
+     */
+    onRedirect?: (url: string) => void;
+    /**
+     * Called when a plan switch completes successfully.
+     * Receives the redirect URL. Component is responsible for showing success UI
+     * and redirecting after a delay.
+     */
+    onPlanChanged?: (redirectUrl: string) => void;
 }
 /**
  * Creates a checkout client for initiating Stripe checkouts from the frontend.
@@ -61,19 +79,25 @@ interface CheckoutClientConfig {
  */
 declare function createCheckoutClient(config?: CheckoutClientConfig): {
     checkout: (options: CheckoutOptions) => Promise<void>;
+    customerPortal: () => Promise<void>;
 };
 /**
- * Default checkout client instance using /api/stripe/checkout endpoint.
+ * Default client instance using /api/stripe endpoints.
  *
  * @example
  * ```ts
- * import { checkout } from "stripe-no-webhooks/client";
+ * import { checkout, customerPortal } from "stripe-no-webhooks/client";
  *
  * <button onClick={() => checkout({ planName: "pro", interval: "month" })}>
  *   Subscribe to Pro
  * </button>
+ *
+ * <button onClick={() => customerPortal()}>
+ *   Manage Billing
+ * </button>
  * ```
  */
 declare const checkout: (options: CheckoutOptions) => Promise<void>;
+declare const customerPortal: () => Promise<void>;
 
-export { type CheckoutClientConfig, type CheckoutOptions, checkout, createCheckoutClient };
+export { type CheckoutClientConfig, type CheckoutOptions, checkout, createCheckoutClient, customerPortal };

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { P as PriceInterval } from './BillingConfig-n6VbfqGY.js';
+import { P as PriceInterval } from './BillingConfig-CpHPJg4Q.js';
 
 interface CheckoutOptions {
     /**
@@ -21,10 +21,6 @@ interface CheckoutOptions {
      * Quantity of the item (defaults to 1)
      */
     quantity?: number;
-    /**
-     * Customer email for prefilling checkout
-     */
-    customerEmail?: string;
     /**
      * Override success URL for this checkout
      */
@@ -43,6 +39,28 @@ interface CheckoutClientConfig {
      * API endpoint for checkout (defaults to /api/stripe/checkout)
      */
     checkoutEndpoint?: string;
+    /**
+     * API endpoint for customer portal (defaults to /api/stripe/customer_portal)
+     */
+    customerPortalEndpoint?: string;
+    /**
+     * Called when loading state changes (start/end of API calls)
+     */
+    onLoading?: (isLoading: boolean) => void;
+    /**
+     * Called when an error occurs during checkout or portal access
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called right before redirecting to Stripe (checkout or portal)
+     */
+    onRedirect?: (url: string) => void;
+    /**
+     * Called when a plan switch completes successfully.
+     * Receives the redirect URL. Component is responsible for showing success UI
+     * and redirecting after a delay.
+     */
+    onPlanChanged?: (redirectUrl: string) => void;
 }
 /**
  * Creates a checkout client for initiating Stripe checkouts from the frontend.
@@ -61,19 +79,25 @@ interface CheckoutClientConfig {
  */
 declare function createCheckoutClient(config?: CheckoutClientConfig): {
     checkout: (options: CheckoutOptions) => Promise<void>;
+    customerPortal: () => Promise<void>;
 };
 /**
- * Default checkout client instance using /api/stripe/checkout endpoint.
+ * Default client instance using /api/stripe endpoints.
  *
  * @example
  * ```ts
- * import { checkout } from "stripe-no-webhooks/client";
+ * import { checkout, customerPortal } from "stripe-no-webhooks/client";
  *
  * <button onClick={() => checkout({ planName: "pro", interval: "month" })}>
  *   Subscribe to Pro
  * </button>
+ *
+ * <button onClick={() => customerPortal()}>
+ *   Manage Billing
+ * </button>
  * ```
  */
 declare const checkout: (options: CheckoutOptions) => Promise<void>;
+declare const customerPortal: () => Promise<void>;
 
-export { type CheckoutClientConfig, type CheckoutOptions, checkout, createCheckoutClient };
+export { type CheckoutClientConfig, type CheckoutOptions, checkout, createCheckoutClient, customerPortal };

package/dist/client.js

@@ -21,35 +21,97 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var client_exports = {};
 __export(client_exports, {
   checkout: () => checkout,
-  createCheckoutClient: () => createCheckoutClient
+  createCheckoutClient: () => createCheckoutClient,
+  customerPortal: () => customerPortal
 });
 module.exports = __toCommonJS(client_exports);
 function createCheckoutClient(config = {}) {
-  const { checkoutEndpoint = "/api/stripe/checkout" } = config;
+  const {
+    checkoutEndpoint = "/api/stripe/checkout",
+    customerPortalEndpoint = "/api/stripe/customer_portal",
+    onLoading,
+    onError,
+    onRedirect,
+    onPlanChanged
+  } = config;
   async function checkout2(options) {
-    const response = await fetch(checkoutEndpoint, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json"
-      },
-      body: JSON.stringify(options)
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new Error(error.error || `Checkout failed: ${response.status}`);
-    }
-    const data = await response.json();
-    if (!data.url) {
+    try {
+      onLoading?.(true);
+      const response = await fetch(checkoutEndpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        },
+        body: JSON.stringify(options)
+      });
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(errorData.error || `Checkout failed: ${response.status}`);
+      }
+      const data = await response.json();
+      if (data.alreadySubscribed) {
+        onLoading?.(false);
+        return;
+      }
+      if (data.success && data.redirectUrl) {
+        onLoading?.(false);
+        if (onPlanChanged) {
+          onPlanChanged(data.redirectUrl);
+          return;
+        }
+        onRedirect?.(data.redirectUrl);
+        window.location.href = data.redirectUrl;
+        return;
+      }
+      if (data.url) {
+        onRedirect?.(data.url);
+        window.location.href = data.url;
+        return;
+      }
       throw new Error("No checkout URL returned");
+    } catch (err) {
+      onLoading?.(false);
+      const error = err instanceof Error ? err : new Error(String(err));
+      onError?.(error);
+      throw error;
+    }
+  }
+  async function customerPortal2() {
+    try {
+      onLoading?.(true);
+      const response = await fetch(customerPortalEndpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        }
+      });
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(
+          errorData.error || `Customer portal failed: ${response.status}`
+        );
+      }
+      const data = await response.json();
+      if (!data.url) {
+        throw new Error("No portal URL returned");
+      }
+      onRedirect?.(data.url);
+      window.location.href = data.url;
+    } catch (err) {
+      onLoading?.(false);
+      const error = err instanceof Error ? err : new Error(String(err));
+      onError?.(error);
+      throw error;
     }
-    window.location.href = data.url;
   }
-  return { checkout: checkout2 };
+  return { checkout: checkout2, customerPortal: customerPortal2 };
 }
-var { checkout } = createCheckoutClient();
+var { checkout, customerPortal } = createCheckoutClient();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   checkout,
-  createCheckoutClient
+  createCheckoutClient,
+  customerPortal
 });

package/dist/client.mjs

@@ -1,29 +1,90 @@
 // src/client.ts
 function createCheckoutClient(config = {}) {
-  const { checkoutEndpoint = "/api/stripe/checkout" } = config;
+  const {
+    checkoutEndpoint = "/api/stripe/checkout",
+    customerPortalEndpoint = "/api/stripe/customer_portal",
+    onLoading,
+    onError,
+    onRedirect,
+    onPlanChanged
+  } = config;
   async function checkout2(options) {
-    const response = await fetch(checkoutEndpoint, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json"
-      },
-      body: JSON.stringify(options)
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new Error(error.error || `Checkout failed: ${response.status}`);
-    }
-    const data = await response.json();
-    if (!data.url) {
+    try {
+      onLoading?.(true);
+      const response = await fetch(checkoutEndpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        },
+        body: JSON.stringify(options)
+      });
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(errorData.error || `Checkout failed: ${response.status}`);
+      }
+      const data = await response.json();
+      if (data.alreadySubscribed) {
+        onLoading?.(false);
+        return;
+      }
+      if (data.success && data.redirectUrl) {
+        onLoading?.(false);
+        if (onPlanChanged) {
+          onPlanChanged(data.redirectUrl);
+          return;
+        }
+        onRedirect?.(data.redirectUrl);
+        window.location.href = data.redirectUrl;
+        return;
+      }
+      if (data.url) {
+        onRedirect?.(data.url);
+        window.location.href = data.url;
+        return;
+      }
       throw new Error("No checkout URL returned");
+    } catch (err) {
+      onLoading?.(false);
+      const error = err instanceof Error ? err : new Error(String(err));
+      onError?.(error);
+      throw error;
+    }
+  }
+  async function customerPortal2() {
+    try {
+      onLoading?.(true);
+      const response = await fetch(customerPortalEndpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        }
+      });
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(
+          errorData.error || `Customer portal failed: ${response.status}`
+        );
+      }
+      const data = await response.json();
+      if (!data.url) {
+        throw new Error("No portal URL returned");
+      }
+      onRedirect?.(data.url);
+      window.location.href = data.url;
+    } catch (err) {
+      onLoading?.(false);
+      const error = err instanceof Error ? err : new Error(String(err));
+      onError?.(error);
+      throw error;
     }
-    window.location.href = data.url;
   }
-  return { checkout: checkout2 };
+  return { checkout: checkout2, customerPortal: customerPortal2 };
 }
-var { checkout } = createCheckoutClient();
+var { checkout, customerPortal } = createCheckoutClient();
 export {
   checkout,
-  createCheckoutClient
+  createCheckoutClient,
+  customerPortal
 };