@paid-ai/paid-node 1.0.1-alpha2 → 1.0.1-alpha8

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

@@ -1,302 +0,0 @@
-import type { BaseHandlerConfig } from "../../utils/base-handler.mjs";
-import type { OrderOptions } from "../../types.mjs";
-type NextJsHandler = (request: any, context?: any) => Promise<any>;
-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): NextJsHandler;
-/**
- * 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): NextJsHandler;
-/**
- * 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): NextJsHandler;
-/**
- * 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): NextJsHandler;
-/**
- * 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): NextJsHandler;
-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): NextJsHandler;
-/**
- * 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): NextJsHandler;
-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): NextJsHandler;
-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): NextJsHandler;
-/**
- * Create a Next.js API route handler for getting a plan group by ID
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/[planGroupId]/route.ts
- * import { createGetPlanGroupByIdRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const GET = createGetPlanGroupByIdRoute();
- * ```
- */
-export declare function createGetPlanGroupByIdRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
-/**
- * Create a Next.js API route handler for getting all plans in a plan group
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/[planGroupId]/plans/route.ts
- * import { createGetGroupPlansRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const GET = createGetGroupPlansRoute();
- * ```
- */
-export declare function createGetGroupPlansRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
-/**
- * Create a Next.js API route handler for subscribing a customer to a plan
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/[planId]/subscribe/route.ts
- * import { createSubscribeRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const POST = createSubscribeRoute();
- * ```
- */
-export declare function createSubscribeRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
-/**
- * Create a Next.js API route handler for unsubscribing a customer from a plan
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/[planId]/unsubscribe/route.ts
- * import { createUnsubscribeRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const POST = createUnsubscribeRoute();
- * ```
- */
-export declare function createUnsubscribeRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
-/**
- * Create a Next.js API route handler for upgrading a customer's plan
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/upgrade/route.ts
- * import { createUpgradeRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const POST = createUpgradeRoute();
- * ```
- */
-export declare function createUpgradeRoute(config?: BaseHandlerConfig): (request: any, context?: any) => Promise<any>;
-export {};

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

@@ -1,340 +0,0 @@
-import { nextjsAdapter } 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";
-import { createGetPlanGroupByIdHandler, createGetGroupPlansHandler, createSubscribeHandler, createUnsubscribeHandler, createUpgradeHandler } from "../../controllers/plans.mjs";
-/**
- * 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 function createActivateOrderSyncRoute(config = {}) {
-    const handler = createActivateOrderSyncHandler(config.defaultReturnUrl);
-    const adaptedHandler = nextjsAdapter(handler);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * 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 function createContactsRoute(config = {}) {
-    const handler = createContactsHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * 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 function createCustomerInvoicesRoute(config = {}) {
-    const handler = createCustomerInvoicesHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * 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);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * 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 function createCustomersRoute(config = {}) {
-    const handler = createCustomersHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * 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 function createOrdersRoute(config = {}) {
-    const handler = createOrdersHandler(config.helperOptions);
-    const adaptedHandler = nextjsAdapter(handler);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * 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 function createPayInvoiceRoute(config = {}) {
-    const handler = createPayInvoiceHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * 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 function createProvisioningRoute(config = {}) {
-    const handler = createProvisioningHandler(config.orderOptions, config.defaultAgentExternalId);
-    const adaptedHandler = nextjsAdapter(handler);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * 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);
-    const route = (request, context) => adaptedHandler(request, context, config);
-    return route;
-}
-/**
- * Create a Next.js API route handler for getting a plan group by ID
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/[planGroupId]/route.ts
- * import { createGetPlanGroupByIdRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const GET = createGetPlanGroupByIdRoute();
- * ```
- */
-export function createGetPlanGroupByIdRoute(config = {}) {
-    const handler = createGetPlanGroupByIdHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    return (request, context) => adaptedHandler(request, context, config);
-}
-/**
- * Create a Next.js API route handler for getting all plans in a plan group
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/[planGroupId]/plans/route.ts
- * import { createGetGroupPlansRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const GET = createGetGroupPlansRoute();
- * ```
- */
-export function createGetGroupPlansRoute(config = {}) {
-    const handler = createGetGroupPlansHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    return (request, context) => adaptedHandler(request, context, config);
-}
-/**
- * Create a Next.js API route handler for subscribing a customer to a plan
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/[planId]/subscribe/route.ts
- * import { createSubscribeRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const POST = createSubscribeRoute();
- * ```
- */
-export function createSubscribeRoute(config = {}) {
-    const handler = createSubscribeHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    return (request, context) => adaptedHandler(request, context, config);
-}
-/**
- * Create a Next.js API route handler for unsubscribing a customer from a plan
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/[planId]/unsubscribe/route.ts
- * import { createUnsubscribeRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const POST = createUnsubscribeRoute();
- * ```
- */
-export function createUnsubscribeRoute(config = {}) {
-    const handler = createUnsubscribeHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    return (request, context) => adaptedHandler(request, context, config);
-}
-/**
- * Create a Next.js API route handler for upgrading a customer's plan
- *
- * @param config - Handler configuration options
- * @returns Next.js route handler function
- *
- * @example
- * ```typescript
- * // src/app/api/plans/upgrade/route.ts
- * import { createUpgradeRoute } from '@paid-ai/paid-node/integrations/nextjs';
- *
- * export const POST = createUpgradeRoute();
- * ```
- */
-export function createUpgradeRoute(config = {}) {
-    const handler = createUpgradeHandler();
-    const adaptedHandler = nextjsAdapter(handler);
-    return (request, context) => adaptedHandler(request, context, config);
-}

package/dist/esm/integrations/client.d.mts

@@ -1,49 +0,0 @@
-/**
- * Shared Paid client initialization utility
- * Framework-agnostic
- */
-import { PaidClient } from '../Client.mjs';
-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>;