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

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.5.0-alpha2",
-                "User-Agent": "@paid-ai/paid-node/0.5.0-alpha2",
+                "X-Fern-SDK-Version": "0.5.0-alpha3",
+                "User-Agent": "@paid-ai/paid-node/0.5.0-alpha3",
                 "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/integrations/adapters/expressjs/base-adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ExpressJS adapter for Paid SDK
+ * Converts Express Request/Response to framework-agnostic format
+ */
+import { Request, Response } from "express";
+/**
+ * Handles Express Request/Response conversion to base handler format
+ */
+export declare const expressjsAdapter: (innerHandler: Function) => (req: Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>, context?: any, config?: any) => Promise<any>;
+/**
+ * Create response context for ExpressJS
+ * This converts the base handler response methods to ExpressJS/Express format
+ */
+export declare function createExpressJSResponseContext(res: Response): {
+    json: (data: any, status?: number) => Response<any, Record<string, any>>;
+    error: (message: string, status: number) => Response<any, Record<string, any>>;
+};

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

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * ExpressJS adapter for Paid SDK
+ * Converts Express Request/Response 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.expressjsAdapter = void 0;
+exports.createExpressJSResponseContext = createExpressJSResponseContext;
+const create_adapter_js_1 = require("../../utils/create-adapter.js");
+/**
+ * Handles Express Request/Response conversion to base handler format
+ */
+exports.expressjsAdapter = (0, create_adapter_js_1.createFrameworkAdapter)({
+    getBody: (req) => __awaiter(void 0, void 0, void 0, function* () {
+        return req.body || {};
+    }),
+    getHeaders: (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;
+    },
+    getMethod: (req) => req.method || "GET",
+    getParams: (req) => __awaiter(void 0, void 0, void 0, function* () {
+        return req.params || {};
+    }),
+    getQuery: (req) => {
+        const query = {};
+        Object.entries(req.query).forEach(([key, value]) => {
+            if (typeof value === "string") {
+                query[key] = value;
+            }
+            else if (Array.isArray(value)) {
+                query[key] = value.join(", ");
+            }
+        });
+        return query;
+    },
+    sendJson: (data, status) => {
+        throw new Error("ExpressJS adapter requires using response context from handler");
+    },
+});
+/**
+ * Create response context for ExpressJS
+ * This converts the base handler response methods to ExpressJS/Express format
+ */
+function createExpressJSResponseContext(res) {
+    return {
+        json: (data, status = 200) => {
+            return res.status(status).json(data);
+        },
+        error: (message, status) => {
+            return res.status(status).json({ error: message });
+        },
+    };
+}

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

@@ -0,0 +1,6 @@
+/**
+ * ExpressJS integration for Paid SDK
+ * Drop-in handlers for ExpressJS controllers using Express Request/Response
+ */
+export { expressjsAdapter, createExpressJSResponseContext } from "./base-adapter.js";
+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/expressjs/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * ExpressJS integration for Paid SDK
+ * Drop-in handlers for ExpressJS controllers using Express Request/Response
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSetupIntentRoute = exports.createProvisioningRoute = exports.createPayInvoiceRoute = exports.createOrdersRoute = exports.createGetCustomerRoute = exports.createCustomersRoute = exports.createCustomerInvoicesRoute = exports.createContactsRoute = exports.createActivateOrderSyncRoute = exports.createExpressJSResponseContext = exports.expressjsAdapter = void 0;
+var base_adapter_js_1 = require("./base-adapter.js");
+Object.defineProperty(exports, "expressjsAdapter", { enumerable: true, get: function () { return base_adapter_js_1.expressjsAdapter; } });
+Object.defineProperty(exports, "createExpressJSResponseContext", { enumerable: true, get: function () { return base_adapter_js_1.createExpressJSResponseContext; } });
+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/expressjs/routes.d.ts

@@ -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.js";
+import { OrderOptions } from "../../types.js";
+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/cjs/integrations/adapters/expressjs/routes.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * ExpressJS route helpers for Paid SDK
+ * These functions create handlers compatible with ExpressJS controllers
+ */
+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");
+/**
+ * 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);
+ *   }
+ * }
+ * ```
+ */
+function createActivateOrderSyncRoute(config = {}) {
+    const handler = (0, billing_js_1.createActivateOrderSyncHandler)(config.defaultReturnUrl);
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, (0, base_adapter_js_1.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());
+ * ```
+ */
+function createContactsRoute(config = {}) {
+    const handler = (0, contacts_js_1.createContactsHandler)();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, (0, base_adapter_js_1.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());
+ * ```
+ */
+function createCustomerInvoicesRoute(config = {}) {
+    const handler = (0, invoices_js_1.createCustomerInvoicesHandler)();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "GET",
+            params: req.params,
+        }, (0, base_adapter_js_1.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());
+ * ```
+ */
+function createGetCustomerRoute(config = {}) {
+    const handler = (0, customers_js_1.createGetCustomerHandler)();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "GET",
+            params: req.params,
+        }, (0, base_adapter_js_1.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());
+ * ```
+ */
+function createCustomersRoute(config = {}) {
+    const handler = (0, customers_js_1.createCustomersHandler)();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, (0, base_adapter_js_1.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 } }));
+ * ```
+ */
+function createOrdersRoute(config = {}) {
+    const handler = (0, orders_js_1.createOrdersHandler)(config.helperOptions);
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, (0, base_adapter_js_1.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());
+ * ```
+ */
+function createPayInvoiceRoute(config = {}) {
+    const handler = (0, billing_js_1.createPayInvoiceHandler)();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, (0, base_adapter_js_1.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
+ * }));
+ * ```
+ */
+function createProvisioningRoute(config = {}) {
+    const handler = (0, provision_users_js_1.createProvisioningHandler)(config.orderOptions, config.defaultAgentExternalId);
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, (0, base_adapter_js_1.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'
+ * }));
+ * ```
+ */
+function createSetupIntentRoute(config = {}) {
+    const handler = (0, billing_js_1.createSetupIntentHandler)(config.defaultReturnUrl);
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "POST",
+            params: req.params,
+        }, (0, base_adapter_js_1.createExpressJSResponseContext)(res), config);
+    };
+}

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

@@ -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.js";

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

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../expressjs/index.js"), exports);

package/dist/cjs/version.d.ts

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

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.5.0-alpha2";
+exports.SDK_VERSION = "0.5.0-alpha3";

package/dist/esm/Client.mjs

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

package/dist/esm/integrations/adapters/expressjs/base-adapter.d.mts

@@ -0,0 +1,17 @@
+/**
+ * ExpressJS adapter for Paid SDK
+ * Converts Express Request/Response to framework-agnostic format
+ */
+import { Request, Response } from "express";
+/**
+ * Handles Express Request/Response conversion to base handler format
+ */
+export declare const expressjsAdapter: (innerHandler: Function) => (req: Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>, context?: any, config?: any) => Promise<any>;
+/**
+ * Create response context for ExpressJS
+ * This converts the base handler response methods to ExpressJS/Express format
+ */
+export declare function createExpressJSResponseContext(res: Response): {
+    json: (data: any, status?: number) => Response<any, Record<string, any>>;
+    error: (message: string, status: number) => Response<any, Record<string, any>>;
+};

package/dist/esm/integrations/adapters/expressjs/base-adapter.mjs

@@ -0,0 +1,67 @@
+/**
+ * ExpressJS adapter for Paid SDK
+ * Converts Express Request/Response 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());
+    });
+};
+import { createFrameworkAdapter } from "../../utils/create-adapter.mjs";
+/**
+ * Handles Express Request/Response conversion to base handler format
+ */
+export const expressjsAdapter = createFrameworkAdapter({
+    getBody: (req) => __awaiter(void 0, void 0, void 0, function* () {
+        return req.body || {};
+    }),
+    getHeaders: (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;
+    },
+    getMethod: (req) => req.method || "GET",
+    getParams: (req) => __awaiter(void 0, void 0, void 0, function* () {
+        return req.params || {};
+    }),
+    getQuery: (req) => {
+        const query = {};
+        Object.entries(req.query).forEach(([key, value]) => {
+            if (typeof value === "string") {
+                query[key] = value;
+            }
+            else if (Array.isArray(value)) {
+                query[key] = value.join(", ");
+            }
+        });
+        return query;
+    },
+    sendJson: (data, status) => {
+        throw new Error("ExpressJS adapter requires using response context from handler");
+    },
+});
+/**
+ * Create response context for ExpressJS
+ * This converts the base handler response methods to ExpressJS/Express format
+ */
+export function createExpressJSResponseContext(res) {
+    return {
+        json: (data, status = 200) => {
+            return res.status(status).json(data);
+        },
+        error: (message, status) => {
+            return res.status(status).json({ error: message });
+        },
+    };
+}

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

@@ -0,0 +1,6 @@
+/**
+ * ExpressJS integration for Paid SDK
+ * Drop-in handlers for ExpressJS controllers using Express Request/Response
+ */
+export { expressjsAdapter, createExpressJSResponseContext } from "./base-adapter.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/expressjs/index.mjs

@@ -0,0 +1,6 @@
+/**
+ * ExpressJS integration for Paid SDK
+ * Drop-in handlers for ExpressJS controllers using Express Request/Response
+ */
+export { expressjsAdapter, createExpressJSResponseContext } from "./base-adapter.mjs";
+export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createGetCustomerRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, } from "./routes.mjs";

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/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@paid-ai/paid-node",
-    "version": "0.5.0-alpha2",
+    "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",