@paid-ai/paid-node 0.4.1 → 0.5.0-alpha2

package/dist/cjs/Client.js

@@ -60,8 +60,8 @@ class PaidClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@paid-ai/paid-node",
-                "X-Fern-SDK-Version": "0.4.1",
-                "User-Agent": "@paid-ai/paid-node/0.4.1",
+                "X-Fern-SDK-Version": "0.5.0-alpha2",
+                "User-Agent": "@paid-ai/paid-node/0.5.0-alpha2",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/index.d.ts

@@ -2,3 +2,4 @@ export * as Paid from "./api/index.js";
 export { PaidClient } from "./Client.js";
 export { PaidEnvironment } from "./environments.js";
 export { PaidError, PaidTimeoutError } from "./errors/index.js";
+export * as PaidIntegrations from "./integrations/index.js";

package/dist/cjs/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaidTimeoutError = exports.PaidError = exports.PaidEnvironment = exports.PaidClient = exports.Paid = void 0;
+exports.PaidIntegrations = exports.PaidTimeoutError = exports.PaidError = exports.PaidEnvironment = exports.PaidClient = exports.Paid = void 0;
 exports.Paid = __importStar(require("./api/index.js"));
 var Client_js_1 = require("./Client.js");
 Object.defineProperty(exports, "PaidClient", { enumerable: true, get: function () { return Client_js_1.PaidClient; } });
@@ -42,3 +42,4 @@ Object.defineProperty(exports, "PaidEnvironment", { enumerable: true, get: funct
 var index_js_1 = require("./errors/index.js");
 Object.defineProperty(exports, "PaidError", { enumerable: true, get: function () { return index_js_1.PaidError; } });
 Object.defineProperty(exports, "PaidTimeoutError", { enumerable: true, get: function () { return index_js_1.PaidTimeoutError; } });
+exports.PaidIntegrations = __importStar(require("./integrations/index.js"));

package/dist/cjs/integrations/adapters/nextjs/base-adapter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Next.js adapter for Paid SDK
+ * Converts Next.js App Router requests to framework-agnostic format
+ */
+import { NextRequest } from "next/server";
+/**
+ * Next.js adapter for App Router
+ * Handles NextRequest/NextResponse conversion to base handler format
+ */
+export declare const nextjsAdapter: (innerHandler: Function) => (req: NextRequest, context?: any, config?: any) => Promise<any>;

package/dist/cjs/integrations/adapters/nextjs/base-adapter.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Next.js adapter for Paid SDK
+ * Converts Next.js App Router requests to framework-agnostic format
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nextjsAdapter = void 0;
+const server_1 = require("next/server");
+const create_adapter_js_1 = require("../../utils/create-adapter.js");
+/**
+ * Next.js adapter for App Router
+ * Handles NextRequest/NextResponse conversion to base handler format
+ */
+exports.nextjsAdapter = (0, create_adapter_js_1.createFrameworkAdapter)({
+    getBody: (req) => __awaiter(void 0, void 0, void 0, function* () {
+        if (req.method === "GET" || req.method === "HEAD") {
+            return {};
+        }
+        try {
+            return yield req.json();
+        }
+        catch (error) {
+            return {};
+        }
+    }),
+    getHeaders: (req) => {
+        const headers = {};
+        req.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        return headers;
+    },
+    getMethod: (req) => req.method || "GET",
+    getParams: (_req, context) => __awaiter(void 0, void 0, void 0, function* () {
+        if (!(context === null || context === void 0 ? void 0 : context.params)) {
+            return {};
+        }
+        const params = context.params instanceof Promise ? yield context.params : context.params;
+        return params || {};
+    }),
+    getQuery: (req) => {
+        const query = {};
+        req.nextUrl.searchParams.forEach((value, key) => {
+            query[key] = value;
+        });
+        return query;
+    },
+    sendJson: (data, status) => server_1.NextResponse.json(data, { status }),
+});

package/dist/cjs/integrations/adapters/nextjs/index.d.ts

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

package/dist/cjs/integrations/adapters/nextjs/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Next.js API Route handlers for Paid integration
+ * Drop-in handlers for Next.js App Router
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSetupIntentRoute = exports.createProvisioningRoute = exports.createPayInvoiceRoute = exports.createOrdersRoute = exports.createGetCustomerRoute = exports.createCustomersRoute = exports.createCustomerInvoicesRoute = exports.createContactsRoute = exports.createActivateOrderSyncRoute = void 0;
+var routes_js_1 = require("./routes.js");
+Object.defineProperty(exports, "createActivateOrderSyncRoute", { enumerable: true, get: function () { return routes_js_1.createActivateOrderSyncRoute; } });
+Object.defineProperty(exports, "createContactsRoute", { enumerable: true, get: function () { return routes_js_1.createContactsRoute; } });
+Object.defineProperty(exports, "createCustomerInvoicesRoute", { enumerable: true, get: function () { return routes_js_1.createCustomerInvoicesRoute; } });
+Object.defineProperty(exports, "createCustomersRoute", { enumerable: true, get: function () { return routes_js_1.createCustomersRoute; } });
+Object.defineProperty(exports, "createGetCustomerRoute", { enumerable: true, get: function () { return routes_js_1.createGetCustomerRoute; } });
+Object.defineProperty(exports, "createOrdersRoute", { enumerable: true, get: function () { return routes_js_1.createOrdersRoute; } });
+Object.defineProperty(exports, "createPayInvoiceRoute", { enumerable: true, get: function () { return routes_js_1.createPayInvoiceRoute; } });
+Object.defineProperty(exports, "createProvisioningRoute", { enumerable: true, get: function () { return routes_js_1.createProvisioningRoute; } });
+Object.defineProperty(exports, "createSetupIntentRoute", { enumerable: true, get: function () { return routes_js_1.createSetupIntentRoute; } });

package/dist/cjs/integrations/adapters/nextjs/routes.d.ts

@@ -0,0 +1,225 @@
+import { BaseHandlerConfig } from "../../utils/base-handler.js";
+import { OrderOptions } from "../../types.js";
+export interface ActivateOrderSyncRouteConfig extends BaseHandlerConfig {
+    /**
+     * Default return URL for payment flow
+     * Can be overridden by request body
+     */
+    defaultReturnUrl?: string;
+}
+/**
+ * Create a Next.js API route handler for synchronous order activation
+ *
+ * This creates an endpoint that activates an order and immediately charges
+ * the customer using a confirmation token from a payment provider.
+ *
+ * Organization ID is automatically fetched from the API key.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/orders/[orderId]/activate-sync/route.ts
+ * import { createActivateOrderSyncRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createActivateOrderSyncRoute({
+ *   defaultReturnUrl: process.env.NEXT_PUBLIC_BASE_URL + '/orders'
+ * });
+ * ```
+ *
+ * @example Client-side usage with route params
+ * ```typescript
+ * await fetch('/api/orders/ord_123/activate-sync', {
+ *   method: 'POST',
+ *   body: JSON.stringify({
+ *     confirmationToken: 'pi_123_secret_456',
+ *     returnUrl: 'https://example.com/return'
+ *   })
+ * });
+ * ```
+ *
+ * @example Client-side usage with body params
+ * ```typescript
+ * await fetch('/api/orders/activate-sync', {
+ *   method: 'POST',
+ *   body: JSON.stringify({
+ *     orderId: 'ord_123',
+ *     confirmationToken: 'pi_123_secret_456'
+ *   })
+ * });
+ * ```
+ */
+export declare function createActivateOrderSyncRoute(config?: ActivateOrderSyncRouteConfig): (request: any, context?: any) => Promise<any>;
+/**
+ * Create a Next.js API route handler for contact creation
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/contacts/route.ts
+ * import { createContactsRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createContactsRoute();
+ * ```
+ */
+export declare function createContactsRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
+/**
+ * Create a Next.js API route handler for fetching customer invoices
+ *
+ * Organization ID is automatically fetched from the API key.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/customers/[customerExternalId]/invoices/route.ts
+ * import { createCustomerInvoicesRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const GET = createCustomerInvoicesRoute();
+ * ```
+ */
+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
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/customers/route.ts
+ * import { createCustomersRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createCustomersRoute();
+ * ```
+ *
+ * @example With custom config
+ * ```typescript
+ * export const POST = createCustomersRoute({
+ *   validate: async (body) => {
+ *     if (!body.email.includes('@company.com')) {
+ *       throw new Error('Only company emails allowed');
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare function createCustomersRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
+export interface OrdersRouteConfig extends BaseHandlerConfig {
+    /**
+     * Default helper options for order creation
+     */
+    helperOptions?: OrderOptions;
+}
+/**
+ * Create a Next.js API route handler for order creation
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/orders/route.ts
+ * import { createOrdersRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createOrdersRoute();
+ * ```
+ *
+ * @example With auto-activation disabled
+ * ```typescript
+ * export const POST = createOrdersRoute({
+ *   helperOptions: { autoActivate: false }
+ * });
+ * ```
+ */
+export declare function createOrdersRoute(config?: OrdersRouteConfig): (request: any, context?: any) => Promise<any>;
+/**
+ * Create a Next.js API route handler for invoice payment
+ *
+ * Organization ID is automatically fetched from the API key.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/invoices/[invoiceId]/pay/route.ts
+ * import { createPayInvoiceRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createPayInvoiceRoute();
+ * ```
+ */
+export declare function createPayInvoiceRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
+export interface ProvisioningRouteConfig extends BaseHandlerConfig {
+    /**
+     * Default agent external ID
+     * Can be overridden by request body
+     */
+    defaultAgentExternalId?: string;
+    /**
+     * Default order options
+     */
+    orderOptions?: OrderOptions;
+}
+/**
+ * Create a Next.js API route handler for user provisioning
+ *
+ * This creates a single endpoint that provisions a complete user
+ * with customer, contact, and optional order.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/provision/route.ts
+ * import { createProvisioningRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createProvisioningRoute({
+ *   defaultAgentExternalId: process.env.PAID_AGENT_ID
+ * });
+ * ```
+ *
+ * @example Client-side usage
+ * ```typescript
+ * await fetch('/api/provision', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ email: 'user@example.com' })
+ * });
+ * ```
+ */
+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/cjs/integrations/adapters/nextjs/routes.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createActivateOrderSyncRoute = createActivateOrderSyncRoute;
+exports.createContactsRoute = createContactsRoute;
+exports.createCustomerInvoicesRoute = createCustomerInvoicesRoute;
+exports.createGetCustomerRoute = createGetCustomerRoute;
+exports.createCustomersRoute = createCustomersRoute;
+exports.createOrdersRoute = createOrdersRoute;
+exports.createPayInvoiceRoute = createPayInvoiceRoute;
+exports.createProvisioningRoute = createProvisioningRoute;
+exports.createSetupIntentRoute = createSetupIntentRoute;
+const base_adapter_js_1 = require("./base-adapter.js");
+const contacts_js_1 = require("../../controllers/contacts.js");
+const invoices_js_1 = require("../../controllers/invoices.js");
+const customers_js_1 = require("../../controllers/customers.js");
+const orders_js_1 = require("../../controllers/orders.js");
+const provision_users_js_1 = require("../../controllers/provision-users.js");
+const billing_js_1 = require("../../controllers/billing.js");
+/**
+ * Create a Next.js API route handler for synchronous order activation
+ *
+ * This creates an endpoint that activates an order and immediately charges
+ * the customer using a confirmation token from a payment provider.
+ *
+ * Organization ID is automatically fetched from the API key.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/orders/[orderId]/activate-sync/route.ts
+ * import { createActivateOrderSyncRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createActivateOrderSyncRoute({
+ *   defaultReturnUrl: process.env.NEXT_PUBLIC_BASE_URL + '/orders'
+ * });
+ * ```
+ *
+ * @example Client-side usage with route params
+ * ```typescript
+ * await fetch('/api/orders/ord_123/activate-sync', {
+ *   method: 'POST',
+ *   body: JSON.stringify({
+ *     confirmationToken: 'pi_123_secret_456',
+ *     returnUrl: 'https://example.com/return'
+ *   })
+ * });
+ * ```
+ *
+ * @example Client-side usage with body params
+ * ```typescript
+ * await fetch('/api/orders/activate-sync', {
+ *   method: 'POST',
+ *   body: JSON.stringify({
+ *     orderId: 'ord_123',
+ *     confirmationToken: 'pi_123_secret_456'
+ *   })
+ * });
+ * ```
+ */
+function createActivateOrderSyncRoute(config = {}) {
+    const handler = (0, billing_js_1.createActivateOrderSyncHandler)(config.defaultReturnUrl);
+    const adaptedHandler = (0, base_adapter_js_1.nextjsAdapter)(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}
+/**
+ * Create a Next.js API route handler for contact creation
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/contacts/route.ts
+ * import { createContactsRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createContactsRoute();
+ * ```
+ */
+function createContactsRoute(config = {}) {
+    const handler = (0, contacts_js_1.createContactsHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.nextjsAdapter)(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}
+/**
+ * Create a Next.js API route handler for fetching customer invoices
+ *
+ * Organization ID is automatically fetched from the API key.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/customers/[customerExternalId]/invoices/route.ts
+ * import { createCustomerInvoicesRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const GET = createCustomerInvoicesRoute();
+ * ```
+ */
+function createCustomerInvoicesRoute(config = {}) {
+    const handler = (0, invoices_js_1.createCustomerInvoicesHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.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();
+ * ```
+ */
+function createGetCustomerRoute(config = {}) {
+    const handler = (0, customers_js_1.createGetCustomerHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.nextjsAdapter)(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}
+/**
+ * Create a Next.js API route handler for customer creation
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/customers/route.ts
+ * import { createCustomersRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createCustomersRoute();
+ * ```
+ *
+ * @example With custom config
+ * ```typescript
+ * export const POST = createCustomersRoute({
+ *   validate: async (body) => {
+ *     if (!body.email.includes('@company.com')) {
+ *       throw new Error('Only company emails allowed');
+ *     }
+ *   }
+ * });
+ * ```
+ */
+function createCustomersRoute(config = {}) {
+    const handler = (0, customers_js_1.createCustomersHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.nextjsAdapter)(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}
+/**
+ * Create a Next.js API route handler for order creation
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/orders/route.ts
+ * import { createOrdersRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createOrdersRoute();
+ * ```
+ *
+ * @example With auto-activation disabled
+ * ```typescript
+ * export const POST = createOrdersRoute({
+ *   helperOptions: { autoActivate: false }
+ * });
+ * ```
+ */
+function createOrdersRoute(config = {}) {
+    const handler = (0, orders_js_1.createOrdersHandler)(config.helperOptions);
+    const adaptedHandler = (0, base_adapter_js_1.nextjsAdapter)(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}
+/**
+ * Create a Next.js API route handler for invoice payment
+ *
+ * Organization ID is automatically fetched from the API key.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/invoices/[invoiceId]/pay/route.ts
+ * import { createPayInvoiceRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createPayInvoiceRoute();
+ * ```
+ */
+function createPayInvoiceRoute(config = {}) {
+    const handler = (0, billing_js_1.createPayInvoiceHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.nextjsAdapter)(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}
+/**
+ * Create a Next.js API route handler for user provisioning
+ *
+ * This creates a single endpoint that provisions a complete user
+ * with customer, contact, and optional order.
+ *
+ * @example
+ * ```typescript
+ * // src/app/api/provision/route.ts
+ * import { createProvisioningRoute } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * export const POST = createProvisioningRoute({
+ *   defaultAgentExternalId: process.env.PAID_AGENT_ID
+ * });
+ * ```
+ *
+ * @example Client-side usage
+ * ```typescript
+ * await fetch('/api/provision', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ email: 'user@example.com' })
+ * });
+ * ```
+ */
+function createProvisioningRoute(config = {}) {
+    const handler = (0, provision_users_js_1.createProvisioningHandler)(config.orderOptions, config.defaultAgentExternalId);
+    const adaptedHandler = (0, base_adapter_js_1.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' }
+ *   })
+ * });
+ * ```
+ */
+function createSetupIntentRoute(config = {}) {
+    const handler = (0, billing_js_1.createSetupIntentHandler)(config.defaultReturnUrl);
+    const adaptedHandler = (0, base_adapter_js_1.nextjsAdapter)(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}

package/dist/cjs/integrations/client.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared Paid client initialization utility
+ * Framework-agnostic
+ */
+import { PaidClient } from '../Client.js';
+export interface PaidClientConfig {
+    /**
+     * Paid API key - defaults to process.env.PAID_API_KEY
+     */
+    apiKey?: string;
+    /**
+     * Paid API URL - defaults to production
+     */
+    apiUrl?: string;
+}
+/**
+ * Initialize a Paid client with environment variable fallbacks
+ *
+ * @param config - Optional configuration overrides
+ * @returns Configured PaidClient instance
+ * @throws Error if API key is not provided or found in environment
+ *
+ * @example
+ * ```typescript
+ * const client = initializePaidClient();
+ * // Uses process.env.PAID_API_KEY
+ *
+ * const client = initializePaidClient({ apiKey: 'pk_xxx' });
+ * // Uses provided key
+ * ```
+ */
+export declare function initializePaidClient(config?: PaidClientConfig): PaidClient;
+/**
+ * Get organization ID from API key
+ *
+ * Calls the Paid API to resolve the organization ID associated with the API key.
+ *
+ * @param config - API configuration
+ * @returns Organization ID or null if not found
+ *
+ * @example
+ * ```typescript
+ * const orgId = await getOrganizationId({
+ *   apiKey: process.env.PAID_API_KEY,
+ *   apiUrl: 'https://api.agentpaid.io'
+ * });
+ * ```
+ */
+export declare function getOrganizationId(config?: PaidClientConfig): Promise<string | null>;