@stripe-sdk/core 1.0.0 → 1.0.2

package/dist/next/index.d.mts

@@ -1,23 +1,37 @@
-import { i as CreatePaymentIntentInput, t as SDKResult, c as CreateCheckoutSessionInput, p as CreateSetupIntentInput, f as CreateCustomerInput, k as CreatePortalSessionInput, q as CreateSubscriptionInput, C as CancelSubscriptionInput } from '../index-D8rM_YD4.mjs';
-export { A as createNextWebhookHandler, B as createPagesWebhookHandler } from '../index-D8rM_YD4.mjs';
+import { i as CreatePaymentIntentInput, t as SDKResult, c as CreateCheckoutSessionInput, p as CreateSetupIntentInput, f as CreateCustomerInput, k as CreatePortalSessionInput, q as CreateSubscriptionInput, C as CancelSubscriptionInput } from '../index-BKDJf1Hz.mjs';
+export { A as createNextWebhookHandler, B as createPagesWebhookHandler } from '../index-BKDJf1Hz.mjs';
 import * as Stripe from 'stripe';
 
 /**
- * Pre-built Server Actions for Next.js App Router.
+ * Authorization callback type.
+ * Must return true if the request is authorized, or throw an error / return false otherwise.
+ */
+type AuthorizeFn = (request: Request) => Promise<boolean | void>;
+/**
+ * Creates authorized server actions for Next.js App Router.
+ *
+ * IMPORTANT: You MUST provide an `authorize` callback that verifies
+ * the current user's session/identity before any Stripe operation.
  *
- * Usage in a Server Component or `use server` file:
+ * Usage in a `use server` file:
  * ```ts
  * 'use server';
- * import { actions } from '@stripe-sdk/core/next';
+ * import { createActions } from '@stripe-sdk/core/next';
+ * import { getServerSession } from 'next-auth';
  *
- * export const createPayment = async (amount: number, currency: string) => {
- *   const result = await actions.createPaymentIntent({ amount, currency });
- *   if (result.error) throw new Error(result.error.message);
- *   return { clientSecret: result.data.client_secret };
- * };
+ * const actions = createActions({
+ *   authorize: async () => {
+ *     const session = await getServerSession();
+ *     if (!session) throw new Error('Unauthorized');
+ *   },
+ * });
+ *
+ * export const createPayment = actions.createPaymentIntent;
  * ```
  */
-declare const actions: {
+declare function createActions(config: {
+    authorize: () => Promise<boolean | void>;
+}): {
     createPaymentIntent: (input: CreatePaymentIntentInput) => Promise<SDKResult<Stripe.Stripe.PaymentIntent>>;
     createCheckoutSession: (input: CreateCheckoutSessionInput) => Promise<SDKResult<Stripe.Stripe.Checkout.Session>>;
     createSetupIntent: (input: CreateSetupIntentInput) => Promise<SDKResult<Stripe.Stripe.SetupIntent>>;
@@ -27,39 +41,48 @@ declare const actions: {
     cancelSubscription: (input: CancelSubscriptionInput) => Promise<SDKResult<Stripe.Stripe.Subscription>>;
     resumeSubscription: (subscriptionId: string) => Promise<SDKResult<Stripe.Stripe.Subscription>>;
 };
+interface RouteOptions<TInput> {
+    /**
+     * REQUIRED: Authorization callback. Must verify the user's identity.
+     * Throw an error or return false to reject the request.
+     */
+    authorize: AuthorizeFn;
+    /**
+     * Optional hook to transform/validate input before creating the resource.
+     */
+    beforeCreate?: (input: TInput, request: Request) => Promise<TInput>;
+}
 /**
  * Creates a Next.js API route handler for creating payment intents.
+ * Requires an `authorize` callback for authentication.
  *
  * Usage in app/api/create-payment-intent/route.ts:
  * ```ts
  * import { createPaymentIntentRoute } from '@stripe-sdk/core/next';
- * export const POST = createPaymentIntentRoute();
+ * import { getServerSession } from 'next-auth';
+ *
+ * export const POST = createPaymentIntentRoute({
+ *   authorize: async (request) => {
+ *     const session = await getServerSession();
+ *     if (!session) throw new Error('Unauthorized');
+ *   },
+ *   beforeCreate: async (input) => ({
+ *     ...input,
+ *     amount: getVerifiedAmount(input),
+ *   }),
+ * });
  * ```
  */
-declare function createPaymentIntentRoute(options?: {
-    beforeCreate?: (input: CreatePaymentIntentInput, request: Request) => Promise<CreatePaymentIntentInput>;
-}): (request: Request) => Promise<Response>;
+declare function createPaymentIntentRoute(options: RouteOptions<CreatePaymentIntentInput>): (request: Request) => Promise<Response>;
 /**
  * Creates a Next.js API route handler for creating checkout sessions.
- *
- * Usage in app/api/create-checkout-session/route.ts:
- * ```ts
- * import { createCheckoutSessionRoute } from '@stripe-sdk/core/next';
- * export const POST = createCheckoutSessionRoute();
- * ```
+ * Requires an `authorize` callback for authentication.
  */
-declare function createCheckoutSessionRoute(options?: {
-    beforeCreate?: (input: CreateCheckoutSessionInput, request: Request) => Promise<CreateCheckoutSessionInput>;
-}): (request: Request) => Promise<Response>;
+declare function createCheckoutSessionRoute(options: RouteOptions<CreateCheckoutSessionInput>): (request: Request) => Promise<Response>;
 /**
  * Creates a Next.js API route handler for creating portal sessions.
- *
- * Usage in app/api/create-portal-session/route.ts:
- * ```ts
- * import { createPortalSessionRoute } from '@stripe-sdk/core/next';
- * export const POST = createPortalSessionRoute();
- * ```
+ * Requires an `authorize` callback for authentication.
  */
-declare function createPortalSessionRoute(): (request: Request) => Promise<Response>;
+declare function createPortalSessionRoute(options: RouteOptions<CreatePortalSessionInput>): (request: Request) => Promise<Response>;
 
-export { actions, createCheckoutSessionRoute, createPaymentIntentRoute, createPortalSessionRoute };
+export { type AuthorizeFn, createActions, createCheckoutSessionRoute, createPaymentIntentRoute, createPortalSessionRoute };

package/dist/next/index.d.ts

@@ -1,23 +1,37 @@
-import { i as CreatePaymentIntentInput, t as SDKResult, c as CreateCheckoutSessionInput, p as CreateSetupIntentInput, f as CreateCustomerInput, k as CreatePortalSessionInput, q as CreateSubscriptionInput, C as CancelSubscriptionInput } from '../index-D8rM_YD4.js';
-export { A as createNextWebhookHandler, B as createPagesWebhookHandler } from '../index-D8rM_YD4.js';
+import { i as CreatePaymentIntentInput, t as SDKResult, c as CreateCheckoutSessionInput, p as CreateSetupIntentInput, f as CreateCustomerInput, k as CreatePortalSessionInput, q as CreateSubscriptionInput, C as CancelSubscriptionInput } from '../index-BKDJf1Hz.js';
+export { A as createNextWebhookHandler, B as createPagesWebhookHandler } from '../index-BKDJf1Hz.js';
 import * as Stripe from 'stripe';
 
 /**
- * Pre-built Server Actions for Next.js App Router.
+ * Authorization callback type.
+ * Must return true if the request is authorized, or throw an error / return false otherwise.
+ */
+type AuthorizeFn = (request: Request) => Promise<boolean | void>;
+/**
+ * Creates authorized server actions for Next.js App Router.
+ *
+ * IMPORTANT: You MUST provide an `authorize` callback that verifies
+ * the current user's session/identity before any Stripe operation.
  *
- * Usage in a Server Component or `use server` file:
+ * Usage in a `use server` file:
  * ```ts
  * 'use server';
- * import { actions } from '@stripe-sdk/core/next';
+ * import { createActions } from '@stripe-sdk/core/next';
+ * import { getServerSession } from 'next-auth';
  *
- * export const createPayment = async (amount: number, currency: string) => {
- *   const result = await actions.createPaymentIntent({ amount, currency });
- *   if (result.error) throw new Error(result.error.message);
- *   return { clientSecret: result.data.client_secret };
- * };
+ * const actions = createActions({
+ *   authorize: async () => {
+ *     const session = await getServerSession();
+ *     if (!session) throw new Error('Unauthorized');
+ *   },
+ * });
+ *
+ * export const createPayment = actions.createPaymentIntent;
  * ```
  */
-declare const actions: {
+declare function createActions(config: {
+    authorize: () => Promise<boolean | void>;
+}): {
     createPaymentIntent: (input: CreatePaymentIntentInput) => Promise<SDKResult<Stripe.Stripe.PaymentIntent>>;
     createCheckoutSession: (input: CreateCheckoutSessionInput) => Promise<SDKResult<Stripe.Stripe.Checkout.Session>>;
     createSetupIntent: (input: CreateSetupIntentInput) => Promise<SDKResult<Stripe.Stripe.SetupIntent>>;
@@ -27,39 +41,48 @@ declare const actions: {
     cancelSubscription: (input: CancelSubscriptionInput) => Promise<SDKResult<Stripe.Stripe.Subscription>>;
     resumeSubscription: (subscriptionId: string) => Promise<SDKResult<Stripe.Stripe.Subscription>>;
 };
+interface RouteOptions<TInput> {
+    /**
+     * REQUIRED: Authorization callback. Must verify the user's identity.
+     * Throw an error or return false to reject the request.
+     */
+    authorize: AuthorizeFn;
+    /**
+     * Optional hook to transform/validate input before creating the resource.
+     */
+    beforeCreate?: (input: TInput, request: Request) => Promise<TInput>;
+}
 /**
  * Creates a Next.js API route handler for creating payment intents.
+ * Requires an `authorize` callback for authentication.
  *
  * Usage in app/api/create-payment-intent/route.ts:
  * ```ts
  * import { createPaymentIntentRoute } from '@stripe-sdk/core/next';
- * export const POST = createPaymentIntentRoute();
+ * import { getServerSession } from 'next-auth';
+ *
+ * export const POST = createPaymentIntentRoute({
+ *   authorize: async (request) => {
+ *     const session = await getServerSession();
+ *     if (!session) throw new Error('Unauthorized');
+ *   },
+ *   beforeCreate: async (input) => ({
+ *     ...input,
+ *     amount: getVerifiedAmount(input),
+ *   }),
+ * });
  * ```
  */
-declare function createPaymentIntentRoute(options?: {
-    beforeCreate?: (input: CreatePaymentIntentInput, request: Request) => Promise<CreatePaymentIntentInput>;
-}): (request: Request) => Promise<Response>;
+declare function createPaymentIntentRoute(options: RouteOptions<CreatePaymentIntentInput>): (request: Request) => Promise<Response>;
 /**
  * Creates a Next.js API route handler for creating checkout sessions.
- *
- * Usage in app/api/create-checkout-session/route.ts:
- * ```ts
- * import { createCheckoutSessionRoute } from '@stripe-sdk/core/next';
- * export const POST = createCheckoutSessionRoute();
- * ```
+ * Requires an `authorize` callback for authentication.
  */
-declare function createCheckoutSessionRoute(options?: {
-    beforeCreate?: (input: CreateCheckoutSessionInput, request: Request) => Promise<CreateCheckoutSessionInput>;
-}): (request: Request) => Promise<Response>;
+declare function createCheckoutSessionRoute(options: RouteOptions<CreateCheckoutSessionInput>): (request: Request) => Promise<Response>;
 /**
  * Creates a Next.js API route handler for creating portal sessions.
- *
- * Usage in app/api/create-portal-session/route.ts:
- * ```ts
- * import { createPortalSessionRoute } from '@stripe-sdk/core/next';
- * export const POST = createPortalSessionRoute();
- * ```
+ * Requires an `authorize` callback for authentication.
  */
-declare function createPortalSessionRoute(): (request: Request) => Promise<Response>;
+declare function createPortalSessionRoute(options: RouteOptions<CreatePortalSessionInput>): (request: Request) => Promise<Response>;
 
-export { actions, createCheckoutSessionRoute, createPaymentIntentRoute, createPortalSessionRoute };
+export { type AuthorizeFn, createActions, createCheckoutSessionRoute, createPaymentIntentRoute, createPortalSessionRoute };