@paid-ai/paid-node 0.5.0-alpha1 → 0.5.0-alpha3

package/dist/esm/integrations/adapters/expressjs/routes.d.mts

@@ -0,0 +1,162 @@
+/**
+ * ExpressJS route helpers for Paid SDK
+ * These functions create handlers compatible with ExpressJS controllers
+ */
+import { Request, Response } from "express";
+import { BaseHandlerConfig } from "../../utils/base-handler.mjs";
+import { OrderOptions } from "../../types.mjs";
+export interface ActivateOrderSyncRouteConfig extends BaseHandlerConfig {
+    defaultReturnUrl?: string;
+}
+/**
+ * Create an Express handler for synchronous order activation
+ *
+ * Use this in your Express app to handle order activation with payment.
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createActivateOrderSyncRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * const activateOrderSyncHandler = createActivateOrderSyncRoute();
+ *
+ * app.post('/paid/payments/activate-order-sync', activateOrderSyncHandler);
+ * ```
+ *
+ * @example With NestJS
+ * ```typescript
+ * import { Controller, Post, Req, Res } from '@nestjs/common';
+ * import { Request, Response } from 'express';
+ * import { createActivateOrderSyncRoute } from '@paid-ai/paid-node/integrations/nestjs';
+ *
+ * @Controller('paid/payments')
+ * export class PaymentsController {
+ *   private activateOrderSyncHandler = createActivateOrderSyncRoute();
+ *
+ *   @Post('activate-order-sync')
+ *   async activateOrderSync(@Req() req: Request, @Res() res: Response) {
+ *     return this.activateOrderSyncHandler(req, res);
+ *   }
+ * }
+ * ```
+ */
+export declare function createActivateOrderSyncRoute(config?: ActivateOrderSyncRouteConfig): (req: Request, res: Response) => Promise<any>;
+/**
+ * Create an Express handler for contact creation
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createContactsRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/contacts', createContactsRoute());
+ * ```
+ */
+export declare function createContactsRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+/**
+ * Create an Express handler for fetching customer invoices
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createCustomerInvoicesRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.get('/paid/customers/:customerExternalId/invoices', createCustomerInvoicesRoute());
+ * ```
+ */
+export declare function createCustomerInvoicesRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+/**
+ * Create an Express handler for fetching a customer by external ID
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createGetCustomerRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.get('/paid/customers/:customerExternalId', createGetCustomerRoute());
+ * ```
+ */
+export declare function createGetCustomerRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+/**
+ * Create an Express handler for customer creation
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createCustomersRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/customers', createCustomersRoute());
+ * ```
+ */
+export declare function createCustomersRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+export interface OrdersRouteConfig extends BaseHandlerConfig {
+    helperOptions?: OrderOptions;
+}
+/**
+ * Create an Express handler for order creation
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createOrdersRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/orders', createOrdersRoute({ helperOptions: { autoActivate: true } }));
+ * ```
+ */
+export declare function createOrdersRoute(config?: OrdersRouteConfig): (req: Request, res: Response) => Promise<any>;
+/**
+ * Create an Express handler for invoice payment
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createPayInvoiceRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/invoices/:invoiceId/pay', createPayInvoiceRoute());
+ * ```
+ */
+export declare function createPayInvoiceRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+export interface ProvisioningRouteConfig extends BaseHandlerConfig {
+    defaultAgentExternalId?: string;
+    orderOptions?: OrderOptions;
+}
+/**
+ * Create an Express handler for user provisioning
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createProvisioningRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/provision', createProvisioningRoute({
+ *   defaultAgentExternalId: process.env.PAID_AGENT_ID
+ * }));
+ * ```
+ */
+export declare function createProvisioningRoute(config?: ProvisioningRouteConfig): (req: Request, res: Response) => Promise<any>;
+export interface SetupIntentRouteConfig extends BaseHandlerConfig {
+    defaultReturnUrl?: string;
+}
+/**
+ * Create an Express handler for setup intent creation
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createSetupIntentRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/payments/setup-intent', createSetupIntentRoute({
+ *   defaultReturnUrl: process.env.APP_URL + '/billing'
+ * }));
+ * ```
+ */
+export declare function createSetupIntentRoute(config?: SetupIntentRouteConfig): (req: Request, res: Response) => Promise<any>;

package/dist/esm/integrations/adapters/expressjs/routes.mjs

@@ -0,0 +1,258 @@
+/**
+ * ExpressJS route helpers for Paid SDK
+ * These functions create handlers compatible with ExpressJS controllers
+ */
+import { createExpressJSResponseContext } from "./base-adapter.mjs";
+import { createContactsHandler } from "../../controllers/contacts.mjs";
+import { createCustomerInvoicesHandler } from "../../controllers/invoices.mjs";
+import { createCustomersHandler, createGetCustomerHandler } from "../../controllers/customers.mjs";
+import { createOrdersHandler } from "../../controllers/orders.mjs";
+import { createProvisioningHandler } from "../../controllers/provision-users.mjs";
+import { createActivateOrderSyncHandler, createPayInvoiceHandler, createSetupIntentHandler, } from "../../controllers/billing.mjs";
+/**
+ * Helper to extract headers from Express Request
+ */
+function extractHeaders(req) {
+    const headers = {};
+    Object.entries(req.headers).forEach(([key, value]) => {
+        if (typeof value === "string") {
+            headers[key] = value;
+        }
+        else if (Array.isArray(value)) {
+            headers[key] = value.join(", ");
+        }
+    });
+    return headers;
+}
+/**
+ * Create an Express handler for synchronous order activation
+ *
+ * Use this in your Express app to handle order activation with payment.
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createActivateOrderSyncRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * const activateOrderSyncHandler = createActivateOrderSyncRoute();
+ *
+ * app.post('/paid/payments/activate-order-sync', activateOrderSyncHandler);
+ * ```
+ *
+ * @example With NestJS
+ * ```typescript
+ * import { Controller, Post, Req, Res } from '@nestjs/common';
+ * import { Request, Response } from 'express';
+ * import { createActivateOrderSyncRoute } from '@paid-ai/paid-node/integrations/nestjs';
+ *
+ * @Controller('paid/payments')
+ * export class PaymentsController {
+ *   private activateOrderSyncHandler = createActivateOrderSyncRoute();
+ *
+ *   @Post('activate-order-sync')
+ *   async activateOrderSync(@Req() req: Request, @Res() res: Response) {
+ *     return this.activateOrderSyncHandler(req, res);
+ *   }
+ * }
+ * ```
+ */
+export function createActivateOrderSyncRoute(config = {}) {
+    const handler = createActivateOrderSyncHandler(config.defaultReturnUrl);
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}
+/**
+ * Create an Express handler for contact creation
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createContactsRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/contacts', createContactsRoute());
+ * ```
+ */
+export function createContactsRoute(config = {}) {
+    const handler = createContactsHandler();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}
+/**
+ * Create an Express handler for fetching customer invoices
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createCustomerInvoicesRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.get('/paid/customers/:customerExternalId/invoices', createCustomerInvoicesRoute());
+ * ```
+ */
+export function createCustomerInvoicesRoute(config = {}) {
+    const handler = createCustomerInvoicesHandler();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "GET",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}
+/**
+ * Create an Express handler for fetching a customer by external ID
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createGetCustomerRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.get('/paid/customers/:customerExternalId', createGetCustomerRoute());
+ * ```
+ */
+export function createGetCustomerRoute(config = {}) {
+    const handler = createGetCustomerHandler();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "GET",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}
+/**
+ * Create an Express handler for customer creation
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createCustomersRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/customers', createCustomersRoute());
+ * ```
+ */
+export function createCustomersRoute(config = {}) {
+    const handler = createCustomersHandler();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}
+/**
+ * Create an Express handler for order creation
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createOrdersRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/orders', createOrdersRoute({ helperOptions: { autoActivate: true } }));
+ * ```
+ */
+export function createOrdersRoute(config = {}) {
+    const handler = createOrdersHandler(config.helperOptions);
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}
+/**
+ * Create an Express handler for invoice payment
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createPayInvoiceRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/invoices/:invoiceId/pay', createPayInvoiceRoute());
+ * ```
+ */
+export function createPayInvoiceRoute(config = {}) {
+    const handler = createPayInvoiceHandler();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}
+/**
+ * Create an Express handler for user provisioning
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createProvisioningRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/provision', createProvisioningRoute({
+ *   defaultAgentExternalId: process.env.PAID_AGENT_ID
+ * }));
+ * ```
+ */
+export function createProvisioningRoute(config = {}) {
+    const handler = createProvisioningHandler(config.orderOptions, config.defaultAgentExternalId);
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}
+/**
+ * Create an Express handler for setup intent creation
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createSetupIntentRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.post('/paid/payments/setup-intent', createSetupIntentRoute({
+ *   defaultReturnUrl: process.env.APP_URL + '/billing'
+ * }));
+ * ```
+ */
+export function createSetupIntentRoute(config = {}) {
+    const handler = createSetupIntentHandler(config.defaultReturnUrl);
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}

package/dist/esm/integrations/adapters/nestjs/index.d.mts

@@ -0,0 +1,7 @@
+/**
+ * NestJS integration for Paid SDK
+ *
+ * NestJS uses Express under the hood, so this is a re-export of the Express adapter.
+ * All functionality is identical to the Express adapter.
+ */
+export * from "../expressjs/index.mjs";

package/dist/esm/integrations/adapters/nestjs/index.mjs

@@ -0,0 +1,7 @@
+/**
+ * NestJS integration for Paid SDK
+ *
+ * NestJS uses Express under the hood, so this is a re-export of the Express adapter.
+ * All functionality is identical to the Express adapter.
+ */
+export * from "../expressjs/index.mjs";

package/dist/esm/integrations/adapters/nextjs/index.d.mts

@@ -2,4 +2,4 @@
  * Next.js API Route handlers for Paid integration
  * Drop-in handlers for Next.js App Router
  */
-export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, type ActivateOrderSyncRouteConfig, type OrdersRouteConfig, type ProvisioningRouteConfig, } from './routes.mjs';
+export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createGetCustomerRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, type ActivateOrderSyncRouteConfig, type OrdersRouteConfig, type ProvisioningRouteConfig, type SetupIntentRouteConfig, } from './routes.mjs';

package/dist/esm/integrations/adapters/nextjs/index.mjs

@@ -2,4 +2,4 @@
  * Next.js API Route handlers for Paid integration
  * Drop-in handlers for Next.js App Router
  */
-export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, } from './routes.mjs';
+export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createGetCustomerRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, } from './routes.mjs';

package/dist/esm/integrations/adapters/nextjs/routes.d.mts

@@ -74,6 +74,18 @@ export declare function createContactsRoute(config?: BaseHandlerConfig): (reques
  * ```
  */
 export declare function createCustomerInvoicesRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
+/**
+ * Create a Next.js API route handler for fetching a customer by external ID
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/customers/[customerExternalId]/route.ts
+ * import { createGetCustomerRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const GET = createGetCustomerRoute();
+ * ```
+ */
+export declare function createGetCustomerRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
 /**
  * Create a Next.js API route handler for customer creation
  *
@@ -172,3 +184,42 @@ export interface ProvisioningRouteConfig extends BaseHandlerConfig {
  * ```
  */
 export declare function createProvisioningRoute(config?: ProvisioningRouteConfig): (request: any, context?: any) => Promise<any>;
+export interface SetupIntentRouteConfig extends BaseHandlerConfig {
+    /**
+     * Default return URL for setup flow
+     * Can be overridden by request body
+     */
+    defaultReturnUrl?: string;
+}
+/**
+ * Create a Next.js API route handler for setup intent creation
+ *
+ * Setup intents are used to add payment methods without immediate charge.
+ * This is useful for saving payment methods for future billing.
+ *
+ * Organization ID is automatically fetched from the API key.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/payment-methods/setup/route.ts
+ * import { createSetupIntentRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createSetupIntentRoute({
+ *   defaultReturnUrl: process.env.NEXT_PUBLIC_BASE_URL + '/billing'
+ * });
+ * ```
+ *
+ * @example Client-side usage
+ * ```typescript
+ * await fetch('/api/payment-methods/setup', {
+ *   method: 'POST',
+ *   body: JSON.stringify({
+ *     customerId: 'cus_123',
+ *     confirmationToken: 'seti_123_secret_456',
+ *     returnUrl: 'https://example.com/billing',
+ *     metadata: { source: 'settings_page' }
+ *   })
+ * });
+ * ```
+ */
+export declare function createSetupIntentRoute(config?: SetupIntentRouteConfig): (request: any, context?: any) => Promise<any>;

package/dist/esm/integrations/adapters/nextjs/routes.mjs

@@ -1,10 +1,10 @@
 import { nextjsAdapter } from "./base-adapter.mjs";
 import { createContactsHandler } from "../../controllers/contacts.mjs";
 import { createCustomerInvoicesHandler } from "../../controllers/invoices.mjs";
-import { createCustomersHandler } from "../../controllers/customers.mjs";
+import { createCustomersHandler, createGetCustomerHandler } from "../../controllers/customers.mjs";
 import { createOrdersHandler } from "../../controllers/orders.mjs";
 import { createProvisioningHandler } from "../../controllers/provision-users.mjs";
-import { createActivateOrderSyncHandler, createPayInvoiceHandler } from "../../controllers/billing.mjs";
+import { createActivateOrderSyncHandler, createPayInvoiceHandler, createSetupIntentHandler } from "../../controllers/billing.mjs";
 /**
  * Create a Next.js API route handler for synchronous order activation
  *
@@ -84,6 +84,22 @@ export function createCustomerInvoicesRoute(config = {}) {
     const adaptedHandler = nextjsAdapter(handler);
     return (request, context) => adaptedHandler(request, context, config);
 }
+/**
+ * Create a Next.js API route handler for fetching a customer by external ID
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/customers/[customerExternalId]/route.ts
+ * import { createGetCustomerRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const GET = createGetCustomerRoute();
+ * ```
+ */
+export function createGetCustomerRoute(config = {}) {
+    const handler = createGetCustomerHandler();
+    const adaptedHandler = nextjsAdapter(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}
 /**
  * Create a Next.js API route handler for customer creation
  *
@@ -181,3 +197,39 @@ export function createProvisioningRoute(config = {}) {
     const adaptedHandler = nextjsAdapter(handler);
     return (request, context) => adaptedHandler(request, context, config);
 }
+/**
+ * Create a Next.js API route handler for setup intent creation
+ *
+ * Setup intents are used to add payment methods without immediate charge.
+ * This is useful for saving payment methods for future billing.
+ *
+ * Organization ID is automatically fetched from the API key.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/payment-methods/setup/route.ts
+ * import { createSetupIntentRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createSetupIntentRoute({
+ *   defaultReturnUrl: process.env.NEXT_PUBLIC_BASE_URL + '/billing'
+ * });
+ * ```
+ *
+ * @example Client-side usage
+ * ```typescript
+ * await fetch('/api/payment-methods/setup', {
+ *   method: 'POST',
+ *   body: JSON.stringify({
+ *     customerId: 'cus_123',
+ *     confirmationToken: 'seti_123_secret_456',
+ *     returnUrl: 'https://example.com/billing',
+ *     metadata: { source: 'settings_page' }
+ *   })
+ * });
+ * ```
+ */
+export function createSetupIntentRoute(config = {}) {
+    const handler = createSetupIntentHandler(config.defaultReturnUrl);
+    const adaptedHandler = nextjsAdapter(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}

package/dist/esm/integrations/controllers/billing.d.mts

@@ -110,4 +110,87 @@ interface ActivateOrderSyncRequestBody {
  * @returns Handler function
  */
 export declare function createActivateOrderSyncHandler(defaultReturnUrl?: string): (request: import("../utils/base-handler.mjs").BaseRequestContext<ActivateOrderSyncRequestBody, Record<string, string>>, response: import("../utils/base-handler.mjs").BaseResponseContext, config?: import("../utils/base-handler.mjs").BaseHandlerConfig) => Promise<any>;
+export interface SetupIntentRequest {
+    customerId: string;
+    confirmationToken: string;
+    returnUrl?: string;
+    metadata?: Record<string, any>;
+}
+export interface SetupIntentResponse {
+    setupIntent: {
+        id: string;
+        client_secret: string;
+        status: string;
+        usage: string;
+        customer: string;
+    };
+    message: string;
+}
+export interface SetupIntentConfig {
+    apiUrl: string;
+    apiKey: string;
+    organizationId: string;
+}
+/**
+ * Create a setup intent for adding payment methods without immediate charge
+ *
+ * Setup intents are used to save payment methods for future use without
+ * charging the customer immediately. This is useful for:
+ * - Adding payment methods for subscription billing
+ * - Updating payment methods
+ * - Pre-authorizing payment methods
+ *
+ * @param config - API configuration with organization context
+ * @param request - Setup intent request with customer ID and confirmation token
+ * @returns Setup intent result with payment method details
+ *
+ * @example
+ * ```typescript
+ * const result = await createSetupIntent(
+ *   {
+ *     apiUrl: 'https://api.agentpaid.io',
+ *     apiKey: process.env.PAID_API_KEY,
+ *     organizationId: 'org_123'
+ *   },
+ *   {
+ *     customerId: 'cus_123',
+ *     confirmationToken: 'seti_123_secret_456',
+ *     returnUrl: 'https://example.com/return',
+ *     metadata: { source: 'web' }
+ *   }
+ * );
+ * ```
+ */
+export declare function createSetupIntent(config: SetupIntentConfig, request: SetupIntentRequest): Promise<SetupIntentResponse>;
+/**
+ * Create a framework-agnostic handler for setup intent creation
+ *
+ * This handler can be used with any framework adapter.
+ *
+ * @param defaultReturnUrl - Optional default return URL
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // Next.js API route
+ * import { createSetupIntentHandler } from '@paid-ai/paid-node/integrations';
+ *
+ * const handler = createSetupIntentHandler('https://myapp.com/billing');
+ *
+ * export async function POST(req: Request) {
+ *   return handler(
+ *     {
+ *       body: await req.json(),
+ *       headers: Object.fromEntries(req.headers),
+ *       method: 'POST'
+ *     },
+ *     {
+ *       json: (data, status = 200) => Response.json(data, { status }),
+ *       error: (message, status) => Response.json({ error: message }, { status })
+ *     }
+ *   );
+ * }
+ * ```
+ */
+export declare function createSetupIntentHandler(defaultReturnUrl?: string): (request: import("../utils/base-handler.mjs").BaseRequestContext<SetupIntentRequest, Record<string, string>>, response: import("../utils/base-handler.mjs").BaseResponseContext, config?: import("../utils/base-handler.mjs").BaseHandlerConfig) => Promise<any>;
 export {};