@paid-ai/paid-node 0.5.1 → 1.0.1-alpha0

package/dist/esm/core/fetcher/getResponseBody.mjs

@@ -7,45 +7,46 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { chooseStreamWrapper } from "./stream-wrappers/chooseStreamWrapper.mjs";
+import { fromJson } from "../json.mjs";
+import { getBinaryResponse } from "./BinaryResponse.mjs";
+import { isResponseWithBody } from "./ResponseWithBody.mjs";
 export function getResponseBody(response, responseType) {
     return __awaiter(this, void 0, void 0, function* () {
-        if (response.body != null && responseType === "blob") {
-            return yield response.blob();
+        if (!isResponseWithBody(response)) {
+            return undefined;
         }
-        else if (response.body != null && responseType === "arrayBuffer") {
-            return yield response.arrayBuffer();
+        switch (responseType) {
+            case "binary-response":
+                return getBinaryResponse(response);
+            case "blob":
+                return yield response.blob();
+            case "arrayBuffer":
+                return yield response.arrayBuffer();
+            case "sse":
+                return response.body;
+            case "streaming":
+                return response.body;
+            case "text":
+                return yield response.text();
         }
-        else if (response.body != null && responseType === "sse") {
-            return response.body;
-        }
-        else if (response.body != null && responseType === "streaming") {
-            return chooseStreamWrapper(response.body);
-        }
-        else if (response.body != null && responseType === "text") {
-            return yield response.text();
-        }
-        else {
-            const text = yield response.text();
-            if (text.length > 0) {
-                try {
-                    let responseBody = JSON.parse(text);
-                    return responseBody;
-                }
-                catch (err) {
-                    return {
-                        ok: false,
-                        error: {
-                            reason: "non-json",
-                            statusCode: response.status,
-                            rawBody: text,
-                        },
-                    };
-                }
+        // if responseType is "json" or not specified, try to parse as JSON
+        const text = yield response.text();
+        if (text.length > 0) {
+            try {
+                const responseBody = fromJson(text);
+                return responseBody;
             }
-            else {
-                return undefined;
+            catch (_err) {
+                return {
+                    ok: false,
+                    error: {
+                        reason: "non-json",
+                        statusCode: response.status,
+                        rawBody: text,
+                    },
+                };
             }
         }
+        return undefined;
     });
 }

package/dist/esm/core/fetcher/index.d.mts

@@ -1,8 +1,11 @@
 export type { APIResponse } from "./APIResponse.mjs";
-export { fetcher } from "./Fetcher.mjs";
+export type { BinaryResponse } from "./BinaryResponse.mjs";
+export type { EndpointMetadata } from "./EndpointMetadata.mjs";
+export { EndpointSupplier } from "./EndpointSupplier.mjs";
 export type { Fetcher, FetchFunction } from "./Fetcher.mjs";
+export { fetcher } from "./Fetcher.mjs";
 export { getHeader } from "./getHeader.mjs";
-export { Supplier } from "./Supplier.mjs";
-export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
-export type { RawResponse, WithRawResponse } from "./RawResponse.mjs";
 export { HttpResponsePromise } from "./HttpResponsePromise.mjs";
+export type { RawResponse, WithRawResponse } from "./RawResponse.mjs";
+export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
+export { Supplier } from "./Supplier.mjs";

package/dist/esm/core/fetcher/index.mjs

@@ -1,5 +1,6 @@
+export { EndpointSupplier } from "./EndpointSupplier.mjs";
 export { fetcher } from "./Fetcher.mjs";
 export { getHeader } from "./getHeader.mjs";
-export { Supplier } from "./Supplier.mjs";
-export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
 export { HttpResponsePromise } from "./HttpResponsePromise.mjs";
+export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
+export { Supplier } from "./Supplier.mjs";

package/dist/esm/core/fetcher/makeRequest.mjs

@@ -11,7 +11,7 @@ import { anySignal, getTimeoutSignal } from "./signals.mjs";
 export const makeRequest = (fetchFn, url, method, headers, requestBody, timeoutMs, abortSignal, withCredentials, duplex) => __awaiter(void 0, void 0, void 0, function* () {
     const signals = [];
     // Add timeout signal
-    let timeoutAbortId = undefined;
+    let timeoutAbortId;
     if (timeoutMs != null) {
         const { signal, abortId } = getTimeoutSignal(timeoutMs);
         timeoutAbortId = abortId;
@@ -21,7 +21,7 @@ export const makeRequest = (fetchFn, url, method, headers, requestBody, timeoutM
     if (abortSignal != null) {
         signals.push(abortSignal);
     }
-    let newSignals = anySignal(signals);
+    const newSignals = anySignal(signals);
     const response = yield fetchFn(url, {
         method: method,
         headers,

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,21 +11,57 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
-function addJitter(delay) {
-    // Generate a random value between -JITTER_FACTOR and +JITTER_FACTOR
-    const jitterMultiplier = 1 + (Math.random() * 2 - 1) * JITTER_FACTOR;
+function addPositiveJitter(delay) {
+    // Generate a random value between 0 and +JITTER_FACTOR
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
+function addSymmetricJitter(delay) {
+    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    // Check for Retry-After header first (RFC 7231), with no jitter
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        // Parse as number of seconds...
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!Number.isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        // ...or as an HTTP date; both are valid
+        const retryAfterDate = new Date(retryAfter);
+        if (!Number.isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!Number.isNaN(resetTime)) {
+            // Assume Unix timestamp in epoch seconds
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    // Fall back to exponential backoff, with symmetric jitter
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
+}
 export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Calculate base delay using exponential backoff (in milliseconds)
-                const baseDelay = Math.min(INITIAL_RETRY_DELAY * Math.pow(2, i), MAX_RETRY_DELAY);
-                // Add jitter to the delay
-                const delayWithJitter = addJitter(baseDelay);
-                yield new Promise((resolve) => setTimeout(resolve, delayWithJitter));
+                // Get delay with appropriate jitter applied
+                const delay = getRetryDelayFromHeaders(response, i);
+                yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();
             }
             else {

package/dist/esm/core/headers.d.mts

@@ -1,3 +1,2 @@
-import * as core from "./index.mjs";
-export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
-export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
+export declare function mergeHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, string | THeaderValue>;
+export declare function mergeOnlyDefinedHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, THeaderValue>;

package/dist/esm/core/index.d.mts

@@ -1,3 +1,5 @@
+export * from "./auth/index.mjs";
+export * from "./base64.mjs";
 export * from "./fetcher/index.mjs";
 export * from "./runtime/index.mjs";
-export * from "./auth/index.mjs";
+export * as url from "./url/index.mjs";

package/dist/esm/core/index.mjs

@@ -1,3 +1,5 @@
+export * from "./auth/index.mjs";
+export * from "./base64.mjs";
 export * from "./fetcher/index.mjs";
 export * from "./runtime/index.mjs";
-export * from "./auth/index.mjs";
+export * as url from "./url/index.mjs";

package/dist/esm/core/runtime/runtime.mjs

@@ -38,7 +38,6 @@ function evaluateRuntime() {
      * A constant that indicates whether the environment the code is running is a Web Worker.
      */
     const isWebWorker = typeof self === "object" &&
-        // @ts-ignore
         typeof (self === null || self === void 0 ? void 0 : self.importScripts) === "function" &&
         (((_b = self.constructor) === null || _b === void 0 ? void 0 : _b.name) === "DedicatedWorkerGlobalScope" ||
             ((_c = self.constructor) === null || _c === void 0 ? void 0 : _c.name) === "ServiceWorkerGlobalScope" ||

package/dist/esm/core/url/encodePathParam.d.mts

@@ -0,0 +1 @@
+export declare function encodePathParam(param: unknown): string;

package/dist/esm/core/url/encodePathParam.mjs

@@ -0,0 +1,18 @@
+export function encodePathParam(param) {
+    if (param === null) {
+        return "null";
+    }
+    const typeofParam = typeof param;
+    switch (typeofParam) {
+        case "undefined":
+            return "undefined";
+        case "string":
+        case "number":
+        case "boolean":
+            break;
+        default:
+            param = String(param);
+            break;
+    }
+    return encodeURIComponent(param);
+}

package/dist/esm/core/url/index.d.mts

@@ -0,0 +1,3 @@
+export { encodePathParam } from "./encodePathParam.mjs";
+export { join } from "./join.mjs";
+export { toQueryString } from "./qs.mjs";

package/dist/esm/core/url/index.mjs

@@ -0,0 +1,3 @@
+export { encodePathParam } from "./encodePathParam.mjs";
+export { join } from "./join.mjs";
+export { toQueryString } from "./qs.mjs";

package/dist/esm/core/url/join.d.mts

@@ -0,0 +1 @@
+export declare function join(base: string, ...segments: string[]): string;

package/dist/esm/core/url/join.mjs

@@ -0,0 +1,66 @@
+export function join(base, ...segments) {
+    if (!base) {
+        return "";
+    }
+    if (segments.length === 0) {
+        return base;
+    }
+    if (base.includes("://")) {
+        let url;
+        try {
+            url = new URL(base);
+        }
+        catch (_a) {
+            // Fallback to path joining if URL is malformed
+            return joinPath(base, ...segments);
+        }
+        const lastSegment = segments[segments.length - 1];
+        const shouldPreserveTrailingSlash = lastSegment === null || lastSegment === void 0 ? void 0 : lastSegment.endsWith("/");
+        for (const segment of segments) {
+            const cleanSegment = trimSlashes(segment);
+            if (cleanSegment) {
+                url.pathname = joinPathSegments(url.pathname, cleanSegment);
+            }
+        }
+        if (shouldPreserveTrailingSlash && !url.pathname.endsWith("/")) {
+            url.pathname += "/";
+        }
+        return url.toString();
+    }
+    return joinPath(base, ...segments);
+}
+function joinPath(base, ...segments) {
+    if (segments.length === 0) {
+        return base;
+    }
+    let result = base;
+    const lastSegment = segments[segments.length - 1];
+    const shouldPreserveTrailingSlash = lastSegment === null || lastSegment === void 0 ? void 0 : lastSegment.endsWith("/");
+    for (const segment of segments) {
+        const cleanSegment = trimSlashes(segment);
+        if (cleanSegment) {
+            result = joinPathSegments(result, cleanSegment);
+        }
+    }
+    if (shouldPreserveTrailingSlash && !result.endsWith("/")) {
+        result += "/";
+    }
+    return result;
+}
+function joinPathSegments(left, right) {
+    if (left.endsWith("/")) {
+        return left + right;
+    }
+    return `${left}/${right}`;
+}
+function trimSlashes(str) {
+    if (!str)
+        return str;
+    let start = 0;
+    let end = str.length;
+    if (str.startsWith("/"))
+        start = 1;
+    if (str.endsWith("/"))
+        end = str.length - 1;
+    return start === 0 && end === str.length ? str : str.slice(start, end);
+}

package/dist/esm/core/url/qs.d.mts

@@ -0,0 +1,6 @@
+interface QueryStringOptions {
+    arrayFormat?: "indices" | "repeat";
+    encode?: boolean;
+}
+export declare function toQueryString(obj: unknown, options?: QueryStringOptions): string;
+export {};

package/dist/esm/core/url/qs.mjs

@@ -0,0 +1,61 @@
+const defaultQsOptions = {
+    arrayFormat: "indices",
+    encode: true,
+};
+function encodeValue(value, shouldEncode) {
+    if (value === undefined) {
+        return "";
+    }
+    if (value === null) {
+        return "";
+    }
+    const stringValue = String(value);
+    return shouldEncode ? encodeURIComponent(stringValue) : stringValue;
+}
+function stringifyObject(obj, prefix = "", options) {
+    const parts = [];
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}[${key}]` : key;
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                continue;
+            }
+            for (let i = 0; i < value.length; i++) {
+                const item = value[i];
+                if (item === undefined) {
+                    continue;
+                }
+                if (typeof item === "object" && !Array.isArray(item) && item !== null) {
+                    const arrayKey = options.arrayFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
+                    parts.push(...stringifyObject(item, arrayKey, options));
+                }
+                else {
+                    const arrayKey = options.arrayFormat === "indices" ? `${fullKey}[${i}]` : fullKey;
+                    const encodedKey = options.encode ? encodeURIComponent(arrayKey) : arrayKey;
+                    parts.push(`${encodedKey}=${encodeValue(item, options.encode)}`);
+                }
+            }
+        }
+        else if (typeof value === "object" && value !== null) {
+            if (Object.keys(value).length === 0) {
+                continue;
+            }
+            parts.push(...stringifyObject(value, fullKey, options));
+        }
+        else {
+            const encodedKey = options.encode ? encodeURIComponent(fullKey) : fullKey;
+            parts.push(`${encodedKey}=${encodeValue(value, options.encode)}`);
+        }
+    }
+    return parts;
+}
+export function toQueryString(obj, options) {
+    if (obj == null || typeof obj !== "object") {
+        return "";
+    }
+    const parts = stringifyObject(obj, "", Object.assign(Object.assign({}, defaultQsOptions), options));
+    return parts.join("&");
+}

package/dist/esm/environments.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 export declare const PaidEnvironment: {
     readonly Production: "https://api.agentpaid.io/api/v1";
 };

package/dist/esm/environments.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export const PaidEnvironment = {
     Production: "https://api.agentpaid.io/api/v1",
 };

package/dist/esm/errors/PaidError.d.mts

@@ -1,7 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as core from "../core/index.mjs";
+import type * as core from "../core/index.mjs";
 export declare class PaidError extends Error {
     readonly statusCode?: number;
     readonly body?: unknown;

package/dist/esm/errors/PaidError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 import { toJson } from "../core/json.mjs";
 export class PaidError extends Error {
     constructor({ message, statusCode, body, rawResponse, }) {
@@ -12,7 +10,7 @@ export class PaidError extends Error {
     }
 }
 function buildMessage({ message, statusCode, body, }) {
-    let lines = [];
+    const lines = [];
     if (message != null) {
         lines.push(message);
     }

package/dist/esm/errors/PaidTimeoutError.d.mts

@@ -1,6 +1,3 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
 export declare class PaidTimeoutError extends Error {
     constructor(message: string);
 }

package/dist/esm/errors/PaidTimeoutError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 export class PaidTimeoutError extends Error {
     constructor(message) {
         super(message);

package/dist/esm/index.d.mts

@@ -1,6 +1,5 @@
 export * as Paid from "./api/index.mjs";
+export type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.mjs";
 export { PaidClient } from "./Client.mjs";
 export { PaidEnvironment } from "./environments.mjs";
 export { PaidError, PaidTimeoutError } from "./errors/index.mjs";
-export * as PaidIntegrations from "./integrations/index.mjs";
-export * from "./tracing/index.mjs";

package/dist/esm/index.mjs

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

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

@@ -2,16 +2,19 @@
  * ExpressJS adapter for Paid SDK
  * Converts Express Request/Response to framework-agnostic format
  */
-import { Request, Response } from "express";
+import type { Request, Response } from "express";
+import type { FrameworkAdapter } from "../../utils/create-adapter.mjs";
 /**
  * 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>;
+export declare const expressjsAdapter: FrameworkAdapter<Request, Response>;
 /**
  * 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>>;
+type ExpressResponseContext = {
+    json: (data: any, status?: number) => Response;
+    error: (message: string, status: number) => Response;
 };
+export declare function createExpressJSResponseContext(res: Response): ExpressResponseContext;
+export {};

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

@@ -51,17 +51,12 @@ export const expressjsAdapter = createFrameworkAdapter({
         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 });
-        },
+    const json = (data, status = 200) => {
+        return res.status(status).json(data);
+    };
+    const error = (message, status) => {
+        return res.status(status).json({ error: message });
     };
+    return { json, error };
 }

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

@@ -2,9 +2,10 @@
  * 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";
+import type { Request, Response } from "express";
+import type { BaseHandlerConfig } from "../../utils/base-handler.mjs";
+import type { OrderOptions } from "../../types.mjs";
+type ExpressHandler = (req: Request, res: Response) => Promise<any>;
 export interface ActivateOrderSyncRouteConfig extends BaseHandlerConfig {
     defaultReturnUrl?: string;
 }
@@ -41,7 +42,7 @@ export interface ActivateOrderSyncRouteConfig extends BaseHandlerConfig {
  * }
  * ```
  */
-export declare function createActivateOrderSyncRoute(config?: ActivateOrderSyncRouteConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createActivateOrderSyncRoute(config?: ActivateOrderSyncRouteConfig): ExpressHandler;
 /**
  * Create an Express handler for contact creation
  *
@@ -54,7 +55,7 @@ export declare function createActivateOrderSyncRoute(config?: ActivateOrderSyncR
  * app.post('/paid/contacts', createContactsRoute());
  * ```
  */
-export declare function createContactsRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createContactsRoute(config?: BaseHandlerConfig): ExpressHandler;
 /**
  * Create an Express handler for fetching customer invoices
  *
@@ -67,7 +68,7 @@ export declare function createContactsRoute(config?: BaseHandlerConfig): (req: R
  * app.get('/paid/customers/:customerExternalId/invoices', createCustomerInvoicesRoute());
  * ```
  */
-export declare function createCustomerInvoicesRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createCustomerInvoicesRoute(config?: BaseHandlerConfig): ExpressHandler;
 /**
  * Create an Express handler for fetching a customer by external ID
  *
@@ -80,7 +81,7 @@ export declare function createCustomerInvoicesRoute(config?: BaseHandlerConfig):
  * app.get('/paid/customers/:customerExternalId', createGetCustomerRoute());
  * ```
  */
-export declare function createGetCustomerRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createGetCustomerRoute(config?: BaseHandlerConfig): ExpressHandler;
 /**
  * Create an Express handler for customer creation
  *
@@ -93,7 +94,7 @@ export declare function createGetCustomerRoute(config?: BaseHandlerConfig): (req
  * app.post('/paid/customers', createCustomersRoute());
  * ```
  */
-export declare function createCustomersRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createCustomersRoute(config?: BaseHandlerConfig): ExpressHandler;
 export interface OrdersRouteConfig extends BaseHandlerConfig {
     helperOptions?: OrderOptions;
 }
@@ -109,7 +110,7 @@ export interface OrdersRouteConfig extends BaseHandlerConfig {
  * app.post('/paid/orders', createOrdersRoute({ helperOptions: { autoActivate: true } }));
  * ```
  */
-export declare function createOrdersRoute(config?: OrdersRouteConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createOrdersRoute(config?: OrdersRouteConfig): ExpressHandler;
 /**
  * Create an Express handler for invoice payment
  *
@@ -122,7 +123,7 @@ export declare function createOrdersRoute(config?: OrdersRouteConfig): (req: Req
  * app.post('/paid/invoices/:invoiceId/pay', createPayInvoiceRoute());
  * ```
  */
-export declare function createPayInvoiceRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createPayInvoiceRoute(config?: BaseHandlerConfig): ExpressHandler;
 export interface ProvisioningRouteConfig extends BaseHandlerConfig {
     defaultAgentExternalId?: string;
     orderOptions?: OrderOptions;
@@ -141,7 +142,7 @@ export interface ProvisioningRouteConfig extends BaseHandlerConfig {
  * }));
  * ```
  */
-export declare function createProvisioningRoute(config?: ProvisioningRouteConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createProvisioningRoute(config?: ProvisioningRouteConfig): ExpressHandler;
 export interface SetupIntentRouteConfig extends BaseHandlerConfig {
     defaultReturnUrl?: string;
 }
@@ -159,4 +160,5 @@ export interface SetupIntentRouteConfig extends BaseHandlerConfig {
  * }));
  * ```
  */
-export declare function createSetupIntentRoute(config?: SetupIntentRouteConfig): (req: Request, res: Response) => Promise<any>;
+export declare function createSetupIntentRoute(config?: SetupIntentRouteConfig): ExpressHandler;
+export {};