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

package/dist/esm/integrations/controllers/billing.mjs

@@ -111,7 +111,7 @@ export function activateOrderSync(config, request) {
         if (!confirmationToken) {
             throw new Error("confirmationToken is required");
         }
-        const data = yield paidApiFetch(config, `/api/organizations/${config.organizationId}/orders/${orderId}/activate-sync`, {
+        const data = yield paidApiFetch(config, `/api/organizations/${config.organizationId}/orders/${orderId}/activate-and-pay`, {
             method: "POST",
             body: Object.assign({ confirmationToken }, (returnUrl && { returnUrl })),
         });
@@ -156,3 +156,104 @@ export function createActivateOrderSyncHandler(defaultReturnUrl) {
         requireOrganizationId: true,
     });
 }
+/**
+ * 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 function createSetupIntent(config, request) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { customerId, confirmationToken, returnUrl, metadata } = request;
+        if (!customerId) {
+            throw new Error("customerId is required");
+        }
+        if (!confirmationToken) {
+            throw new Error("confirmationToken is required");
+        }
+        const data = yield paidApiFetch(config, `/api/organizations/${config.organizationId}/payments/setup-intents-external`, {
+            method: "POST",
+            body: Object.assign(Object.assign({ customerId,
+                confirmationToken }, (returnUrl && { returnUrl })), (metadata && { metadata })),
+        });
+        return {
+            setupIntent: data.setupIntent || data,
+            message: "Setup intent created successfully",
+        };
+    });
+}
+/**
+ * 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 function createSetupIntentHandler(defaultReturnUrl) {
+    return createHandler((client, body, _params, organizationId) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const apiKey = (_a = client._options) === null || _a === void 0 ? void 0 : _a.token;
+        const baseUrl = ((_b = client._options) === null || _b === void 0 ? void 0 : _b.baseUrl) || 'https://api.agentpaid.io/api/v1';
+        const apiUrl = baseUrl.replace('/api/v1', '');
+        const result = yield createSetupIntent({ apiUrl, apiKey, organizationId: organizationId }, {
+            customerId: body.customerId,
+            confirmationToken: body.confirmationToken,
+            returnUrl: body.returnUrl || defaultReturnUrl,
+            metadata: body.metadata,
+        });
+        return {
+            success: true,
+            data: result,
+        };
+    }), {
+        requiredFields: ['customerId', 'confirmationToken'],
+        requireOrganizationId: true,
+    });
+}

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

@@ -61,3 +61,36 @@ export declare function createCustomer(client: PaidClient, data: Required<Omit<C
  * @returns Handler function
  */
 export declare function createCustomersHandler(): (request: import("../utils/base-handler.mjs").BaseRequestContext<CustomerData, Record<string, string>>, response: import("../utils/base-handler.mjs").BaseResponseContext, config?: import("../utils/base-handler.mjs").BaseHandlerConfig) => Promise<any>;
+/**
+ * Get a customer by external ID
+ *
+ * @param client - PaidClient instance
+ * @param customerExternalId - Customer's external ID
+ * @returns Customer data
+ *
+ * @example
+ * ```typescript
+ * const customer = await getCustomer(client, 'user-123');
+ * console.log(customer.name, customer.email);
+ * ```
+ */
+export declare function getCustomer(client: PaidClient, customerExternalId: string): Promise<any>;
+/**
+ * Create a framework-agnostic handler for fetching a customer by external ID
+ *
+ * This handler can be used with any framework adapter.
+ * The customer external ID should be provided either in params or query string.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/customers/[customerExternalId]/route.ts
+ * import { createGetCustomerHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createGetCustomerHandler();
+ * export const GET = nextjsAdapter(handler);
+ * ```
+ */
+export declare function createGetCustomerHandler(): (request: import("../utils/base-handler.mjs").BaseRequestContext<any, Record<string, string>>, response: import("../utils/base-handler.mjs").BaseResponseContext, config?: import("../utils/base-handler.mjs").BaseHandlerConfig) => Promise<any>;

package/dist/esm/integrations/controllers/customers.mjs

@@ -143,3 +143,57 @@ export function createCustomersHandler() {
         return { success: true, data: customer };
     }), { requiredFields: ['externalId'] });
 }
+/**
+ * Get a customer by external ID
+ *
+ * @param client - PaidClient instance
+ * @param customerExternalId - Customer's external ID
+ * @returns Customer data
+ *
+ * @example
+ * ```typescript
+ * const customer = await getCustomer(client, 'user-123');
+ * console.log(customer.name, customer.email);
+ * ```
+ */
+export function getCustomer(client, customerExternalId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const customer = yield client.customers.getByExternalId(customerExternalId);
+        return customer;
+    });
+}
+/**
+ * Create a framework-agnostic handler for fetching a customer by external ID
+ *
+ * This handler can be used with any framework adapter.
+ * The customer external ID should be provided either in params or query string.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/customers/[customerExternalId]/route.ts
+ * import { createGetCustomerHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createGetCustomerHandler();
+ * export const GET = nextjsAdapter(handler);
+ * ```
+ */
+export function createGetCustomerHandler() {
+    return createHandler((client, _body, params) => __awaiter(this, void 0, void 0, function* () {
+        const customerExternalId = params === null || params === void 0 ? void 0 : params.customerExternalId;
+        if (!customerExternalId) {
+            return {
+                success: false,
+                error: "customerExternalId is required",
+                status: 400,
+            };
+        }
+        const customer = yield getCustomer(client, customerExternalId);
+        return { success: true, data: customer };
+    }), {
+        allowedMethods: ['GET'],
+        requireOrganizationId: false,
+    });
+}

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

@@ -1,6 +1,6 @@
-export { createCustomer, createCustomerWithDefaults, createCustomersHandler, } from "./customers.mjs";
+export { createCustomer, createCustomerWithDefaults, getCustomer, createGetCustomerHandler, createCustomersHandler, } from "./customers.mjs";
 export { createContact, createContactWithDefaults, createContactsHandler, } from "./contacts.mjs";
 export { createOrder, createOrderWithDefaults, createOrdersHandler, } from "./orders.mjs";
-export { payInvoice, createPayInvoiceHandler, type PayInvoiceConfig, type PayInvoiceRequest, type PayInvoiceResult, activateOrderSync, createActivateOrderSyncHandler, type ActivateOrderSyncConfig, type ActivateOrderSyncRequest, type ActivateOrderSyncResult, } from "./billing.mjs";
+export { payInvoice, createPayInvoiceHandler, type PayInvoiceConfig, type PayInvoiceRequest, type PayInvoiceResult, activateOrderSync, createActivateOrderSyncHandler, type ActivateOrderSyncConfig, type ActivateOrderSyncRequest, type ActivateOrderSyncResult, createSetupIntent, createSetupIntentHandler, type SetupIntentConfig, type SetupIntentRequest, type SetupIntentResponse, } from "./billing.mjs";
 export { getCustomerInvoices, createCustomerInvoicesHandler, type CustomerInvoicesResult, } from "./invoices.mjs";
 export { provisionNewUser, createProvisioningHandler, } from "./provision-users.mjs";

package/dist/esm/integrations/controllers/index.mjs

@@ -1,6 +1,6 @@
-export { createCustomer, createCustomerWithDefaults, createCustomersHandler, } from "./customers.mjs";
+export { createCustomer, createCustomerWithDefaults, getCustomer, createGetCustomerHandler, createCustomersHandler, } from "./customers.mjs";
 export { createContact, createContactWithDefaults, createContactsHandler, } from "./contacts.mjs";
 export { createOrder, createOrderWithDefaults, createOrdersHandler, } from "./orders.mjs";
-export { payInvoice, createPayInvoiceHandler, activateOrderSync, createActivateOrderSyncHandler, } from "./billing.mjs";
+export { payInvoice, createPayInvoiceHandler, activateOrderSync, createActivateOrderSyncHandler, createSetupIntent, createSetupIntentHandler, } from "./billing.mjs";
 export { getCustomerInvoices, createCustomerInvoicesHandler, } from "./invoices.mjs";
 export { provisionNewUser, createProvisioningHandler, } from "./provision-users.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.0-alpha1";
+export declare const SDK_VERSION = "0.5.0-alpha3";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.5.0-alpha1";
+export const SDK_VERSION = "0.5.0-alpha3";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@paid-ai/paid-node",
-    "version": "0.5.0-alpha1",
+    "version": "0.5.0-alpha3",
     "private": false,
     "repository": "https://github.com/paid-ai/paid-node",
     "type": "commonjs",
@@ -104,6 +104,30 @@
             },
             "default": "./dist/cjs/integrations/adapters/nextjs/index.js"
         },
+        "./integrations/express": {
+            "types": "./dist/cjs/integrations/adapters/expressjs/index.d.ts",
+            "import": {
+                "types": "./dist/esm/integrations/adapters/expressjs/index.d.mts",
+                "default": "./dist/esm/integrations/adapters/expressjs/index.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/integrations/adapters/expressjs/index.d.ts",
+                "default": "./dist/cjs/integrations/adapters/expressjs/index.js"
+            },
+            "default": "./dist/cjs/integrations/adapters/expressjs/index.js"
+        },
+        "./integrations/nestjs": {
+            "types": "./dist/cjs/integrations/adapters/nestjs/index.d.ts",
+            "import": {
+                "types": "./dist/esm/integrations/adapters/nestjs/index.d.mts",
+                "default": "./dist/esm/integrations/adapters/nestjs/index.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/integrations/adapters/nestjs/index.d.ts",
+                "default": "./dist/cjs/integrations/adapters/nestjs/index.js"
+            },
+            "default": "./dist/cjs/integrations/adapters/nestjs/index.js"
+        },
         "./package.json": "./package.json"
     },
     "files": [
@@ -137,6 +161,7 @@
         "@anthropic-ai/sdk": ">=0.36.3",
         "@langchain/core": ">=0.3.0",
         "@mistralai/mistralai": ">=1.0.0",
+        "@types/express": ">=4.17.0",
         "ai": ">=5.0.0",
         "openai": ">=4.85.4",
         "next": ">=13.0.0"
@@ -154,6 +179,9 @@
         "@mistralai/mistralai": {
             "optional": true
         },
+        "@types/express": {
+            "optional": true
+        },
         "ai": {
             "optional": true
         },
@@ -169,6 +197,7 @@
         "@types/qs": "^6.9.17",
         "@types/node-fetch": "^2.6.12",
         "@types/readable-stream": "^4.0.18",
+        "@types/express": "^4.17.21",
         "webpack": "^5.97.1",
         "ts-loader": "^9.5.1",
         "jest": "^29.7.0",