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

package/dist/cjs/api/types/PlanWithFeatures.d.ts

@@ -0,0 +1,67 @@
+/**
+ * A plan with its features (product-attribute pairs) for display
+ */
+export interface PlanWithFeatures {
+    /** The unique identifier of the plan */
+    id: string;
+    /** The name of the plan */
+    name: string;
+    /** The description of the plan */
+    description?: string;
+    /** The type of plan (flat for fixed pricing, usage for usage-based, credit for prepaid credits) */
+    type: PlanWithFeatures.Type;
+    /** The pricing configuration for the plan */
+    pricing: PlanWithFeatures.Pricing;
+    /** When the plan was created */
+    createdAt: string;
+    /** When the plan was last updated */
+    updatedAt: string;
+    /** The ID of the next plan in the sequence */
+    nextPlanId?: string;
+    /** The ID of the previous plan in the sequence */
+    prevPlanId?: string;
+    /** The features (product-attribute pairs) included in this plan */
+    features: PlanWithFeatures.Features.Item[];
+}
+export declare namespace PlanWithFeatures {
+    /** The type of plan (flat for fixed pricing, usage for usage-based, credit for prepaid credits) */
+    const Type: {
+        readonly Flat: "flat";
+        readonly Usage: "usage";
+        readonly Credit: "credit";
+    };
+    type Type = (typeof Type)[keyof typeof Type];
+    /**
+     * The pricing configuration for the plan
+     */
+    interface Pricing {
+        /** The currency code (e.g., "USD", "EUR") */
+        currency: string;
+        /** The fixed amount for flat plans (in smallest currency unit, e.g., cents) */
+        amount?: number;
+        /** The billing frequency for the plan */
+        billingFrequency: Pricing.BillingFrequency;
+        /** Custom billing frequency in months (if not using standard frequencies) */
+        billingFrequencyCustomMonths?: number;
+    }
+    namespace Pricing {
+        /** The billing frequency for the plan */
+        const BillingFrequency: {
+            readonly Monthly: "monthly";
+            readonly Quarterly: "quarterly";
+            readonly Annual: "annual";
+        };
+        type BillingFrequency = (typeof BillingFrequency)[keyof typeof BillingFrequency];
+    }
+    type Features = Features.Item[];
+    namespace Features {
+        interface Item {
+            /** The name of the product */
+            productName: string;
+            /** The name of the product attribute */
+            attributeName: string;
+            /** The pricing configuration for this feature */
+            pricing: Record<string, unknown>;
+        }
+    }
+}

package/dist/cjs/api/types/PlanWithFeatures.js

@@ -0,0 +1,22 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanWithFeatures = void 0;
+var PlanWithFeatures;
+(function (PlanWithFeatures) {
+    /** The type of plan (flat for fixed pricing, usage for usage-based, credit for prepaid credits) */
+    PlanWithFeatures.Type = {
+        Flat: "flat",
+        Usage: "usage",
+        Credit: "credit",
+    };
+    let Pricing;
+    (function (Pricing) {
+        /** The billing frequency for the plan */
+        Pricing.BillingFrequency = {
+            Monthly: "monthly",
+            Quarterly: "quarterly",
+            Annual: "annual",
+        };
+    })(Pricing = PlanWithFeatures.Pricing || (PlanWithFeatures.Pricing = {}));
+})(PlanWithFeatures || (exports.PlanWithFeatures = PlanWithFeatures = {}));

package/dist/cjs/api/types/SignalV2.d.ts

@@ -1,16 +1,16 @@
 /**
- * V2 signal schema with clean field names. Use either internal IDs (product_id, customer_id) or external IDs (external_product_id, external_customer_id).
+ * V2 signal schema with clean field names. IMPORTANT: Exactly one customer ID field (customer_id OR external_customer_id) and exactly one product ID field (product_id OR external_product_id) must be provided per signal.
  */
 export interface SignalV2 {
     /** The name of the event being tracked */
     event_name: string;
-    /** Paid's internal product ID. Use either this OR external_product_id. */
+    /** Paid's display ID for the product (e.g., prod_abc123). Cannot be used with external_product_id. Either this or external_product_id is required. */
     product_id?: string;
-    /** Your system's product ID. Use either this OR product_id. */
+    /** Your system's product ID. Cannot be used with product_id. Either this or product_id is required. */
     external_product_id?: string;
-    /** Paid's internal customer ID. Use either this OR external_customer_id. */
+    /** Paid's display ID for the customer (e.g., cus_xyz789). Cannot be used with external_customer_id. Either this or external_customer_id is required. */
     customer_id?: string;
-    /** Your system's customer ID. Use either this OR customer_id. */
+    /** Your system's customer ID. Cannot be used with customer_id. Either this or customer_id is required. */
     external_customer_id?: string;
     /** Optional additional data/metadata for the signal */
     data?: Record<string, unknown>;

package/dist/cjs/api/types/index.d.ts

@@ -30,6 +30,7 @@ export * from "./PaginationMeta.js";
 export * from "./PaymentMethod.js";
 export * from "./Plan.js";
 export * from "./PlanGroup.js";
+export * from "./PlanWithFeatures.js";
 export * from "./PricePoint.js";
 export * from "./Pricing.js";
 export * from "./PricingModelType.js";

package/dist/cjs/api/types/index.js

@@ -46,6 +46,7 @@ __exportStar(require("./PaginationMeta.js"), exports);
 __exportStar(require("./PaymentMethod.js"), exports);
 __exportStar(require("./Plan.js"), exports);
 __exportStar(require("./PlanGroup.js"), exports);
+__exportStar(require("./PlanWithFeatures.js"), exports);
 __exportStar(require("./PricePoint.js"), exports);
 __exportStar(require("./Pricing.js"), exports);
 __exportStar(require("./PricingModelType.js"), exports);

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

@@ -2,5 +2,5 @@
  * 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";
+export { expressjsAdapter, createExpressJSResponseContext, } from "./base-adapter.js";
+export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createGetCustomerRoute, createGetPlanGroupByIdRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, type ActivateOrderSyncRouteConfig, type OrdersRouteConfig, type ProvisioningRouteConfig, type SetupIntentRouteConfig, } from "./routes.js";

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

@@ -4,7 +4,7 @@
  * 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;
+exports.createSetupIntentRoute = exports.createProvisioningRoute = exports.createPayInvoiceRoute = exports.createOrdersRoute = exports.createGetPlanGroupByIdRoute = 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; } });
@@ -14,6 +14,7 @@ Object.defineProperty(exports, "createContactsRoute", { enumerable: true, get: f
 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, "createGetPlanGroupByIdRoute", { enumerable: true, get: function () { return routes_js_1.createGetPlanGroupByIdRoute; } });
 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; } });

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

@@ -161,4 +161,20 @@ export interface SetupIntentRouteConfig extends BaseHandlerConfig {
  * ```
  */
 export declare function createSetupIntentRoute(config?: SetupIntentRouteConfig): ExpressHandler;
+/**
+ * Create an Express handler for getting a plan group by ID
+ *
+ * @param config - Handler configuration options
+ * @returns Express route handler function
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createGetPlanGroupByIdRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.get('/paid/plans/:planGroupId', createGetPlanGroupByIdRoute());
+ * ```
+ */
+export declare function createGetPlanGroupByIdRoute(config?: BaseHandlerConfig): (req: Request, res: Response) => Promise<any>;
 export {};

package/dist/cjs/integrations/adapters/expressjs/routes.js

@@ -13,6 +13,7 @@ exports.createOrdersRoute = createOrdersRoute;
 exports.createPayInvoiceRoute = createPayInvoiceRoute;
 exports.createProvisioningRoute = createProvisioningRoute;
 exports.createSetupIntentRoute = createSetupIntentRoute;
+exports.createGetPlanGroupByIdRoute = createGetPlanGroupByIdRoute;
 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");
@@ -20,6 +21,7 @@ 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");
+const plans_js_1 = require("../../controllers/plans.js");
 /**
  * Helper to extract headers from Express Request
  */
@@ -276,3 +278,29 @@ function createSetupIntentRoute(config = {}) {
     };
     return route;
 }
+/**
+ * Create an Express handler for getting a plan group by ID
+ *
+ * @param config - Handler configuration options
+ * @returns Express route handler function
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createGetPlanGroupByIdRoute } from '@paid-ai/paid-node/integrations/express';
+ *
+ * const app = express();
+ * app.get('/paid/plans/:planGroupId', createGetPlanGroupByIdRoute());
+ * ```
+ */
+function createGetPlanGroupByIdRoute(config = {}) {
+    const handler = (0, plans_js_1.createGetPlanGroupByIdHandler)();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "GET",
+            params: req.params,
+        }, (0, base_adapter_js_1.createExpressJSResponseContext)(res), config);
+    };
+}

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

@@ -2,4 +2,4 @@
  * Next.js API Route handlers for Paid integration
  * Drop-in handlers for Next.js App Router
  */
-export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createGetCustomerRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, type ActivateOrderSyncRouteConfig, type OrdersRouteConfig, type ProvisioningRouteConfig, type SetupIntentRouteConfig, } from './routes.js';
+export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createGetCustomerRoute, createGetPlanGroupByIdRoute, createGetGroupPlansRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, createSubscribeRoute, createUnsubscribeRoute, createUpgradeRoute, type ActivateOrderSyncRouteConfig, type OrdersRouteConfig, type ProvisioningRouteConfig, type SetupIntentRouteConfig, } from "./routes.js";

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

@@ -4,14 +4,19 @@
  * Drop-in handlers for Next.js App Router
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSetupIntentRoute = exports.createProvisioningRoute = exports.createPayInvoiceRoute = exports.createOrdersRoute = exports.createGetCustomerRoute = exports.createCustomersRoute = exports.createCustomerInvoicesRoute = exports.createContactsRoute = exports.createActivateOrderSyncRoute = void 0;
+exports.createUpgradeRoute = exports.createUnsubscribeRoute = exports.createSubscribeRoute = exports.createSetupIntentRoute = exports.createProvisioningRoute = exports.createPayInvoiceRoute = exports.createOrdersRoute = exports.createGetGroupPlansRoute = exports.createGetPlanGroupByIdRoute = exports.createGetCustomerRoute = exports.createCustomersRoute = exports.createCustomerInvoicesRoute = exports.createContactsRoute = exports.createActivateOrderSyncRoute = void 0;
 var routes_js_1 = require("./routes.js");
 Object.defineProperty(exports, "createActivateOrderSyncRoute", { enumerable: true, get: function () { return routes_js_1.createActivateOrderSyncRoute; } });
 Object.defineProperty(exports, "createContactsRoute", { enumerable: true, get: function () { return routes_js_1.createContactsRoute; } });
 Object.defineProperty(exports, "createCustomerInvoicesRoute", { enumerable: true, get: function () { return routes_js_1.createCustomerInvoicesRoute; } });
 Object.defineProperty(exports, "createCustomersRoute", { enumerable: true, get: function () { return routes_js_1.createCustomersRoute; } });
 Object.defineProperty(exports, "createGetCustomerRoute", { enumerable: true, get: function () { return routes_js_1.createGetCustomerRoute; } });
+Object.defineProperty(exports, "createGetPlanGroupByIdRoute", { enumerable: true, get: function () { return routes_js_1.createGetPlanGroupByIdRoute; } });
+Object.defineProperty(exports, "createGetGroupPlansRoute", { enumerable: true, get: function () { return routes_js_1.createGetGroupPlansRoute; } });
 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; } });
+Object.defineProperty(exports, "createSubscribeRoute", { enumerable: true, get: function () { return routes_js_1.createSubscribeRoute; } });
+Object.defineProperty(exports, "createUnsubscribeRoute", { enumerable: true, get: function () { return routes_js_1.createUnsubscribeRoute; } });
+Object.defineProperty(exports, "createUpgradeRoute", { enumerable: true, get: function () { return routes_js_1.createUpgradeRoute; } });

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

@@ -224,4 +224,79 @@ export interface SetupIntentRouteConfig extends BaseHandlerConfig {
  * ```
  */
 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/cjs/integrations/adapters/nextjs/routes.js

@@ -9,6 +9,11 @@ exports.createOrdersRoute = createOrdersRoute;
 exports.createPayInvoiceRoute = createPayInvoiceRoute;
 exports.createProvisioningRoute = createProvisioningRoute;
 exports.createSetupIntentRoute = createSetupIntentRoute;
+exports.createGetPlanGroupByIdRoute = createGetPlanGroupByIdRoute;
+exports.createGetGroupPlansRoute = createGetGroupPlansRoute;
+exports.createSubscribeRoute = createSubscribeRoute;
+exports.createUnsubscribeRoute = createUnsubscribeRoute;
+exports.createUpgradeRoute = createUpgradeRoute;
 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");
@@ -16,6 +21,7 @@ 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");
+const plans_js_1 = require("../../controllers/plans.js");
 /**
  * Create a Next.js API route handler for synchronous order activation
  *
@@ -253,3 +259,98 @@ function createSetupIntentRoute(config = {}) {
     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();
+ * ```
+ */
+function createGetPlanGroupByIdRoute(config = {}) {
+    const handler = (0, plans_js_1.createGetPlanGroupByIdHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.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();
+ * ```
+ */
+function createGetGroupPlansRoute(config = {}) {
+    const handler = (0, plans_js_1.createGetGroupPlansHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.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();
+ * ```
+ */
+function createSubscribeRoute(config = {}) {
+    const handler = (0, plans_js_1.createSubscribeHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.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();
+ * ```
+ */
+function createUnsubscribeRoute(config = {}) {
+    const handler = (0, plans_js_1.createUnsubscribeHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.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();
+ * ```
+ */
+function createUpgradeRoute(config = {}) {
+    const handler = (0, plans_js_1.createUpgradeHandler)();
+    const adaptedHandler = (0, base_adapter_js_1.nextjsAdapter)(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}

package/dist/cjs/integrations/controllers/index.d.ts

@@ -4,3 +4,4 @@ export { createOrder, createOrderWithDefaults, createOrdersHandler, } from "./or
 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.js";
 export { getCustomerInvoices, createCustomerInvoicesHandler, type CustomerInvoicesResult, } from "./invoices.js";
 export { provisionNewUser, createProvisioningHandler, } from "./provision-users.js";
+export { getPlanById, getPlanGroupById, createGetPlanGroupByIdHandler, getGroupPlans, createGetGroupPlansHandler, subscribe, createSubscribeHandler, unsubscribe, createUnsubscribeHandler, upgrade, createUpgradeHandler, } from "./plans.js";

package/dist/cjs/integrations/controllers/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createProvisioningHandler = exports.provisionNewUser = exports.createCustomerInvoicesHandler = exports.getCustomerInvoices = exports.createSetupIntentHandler = exports.createSetupIntent = exports.createActivateOrderSyncHandler = exports.activateOrderSync = exports.createPayInvoiceHandler = exports.payInvoice = exports.createOrdersHandler = exports.createOrderWithDefaults = exports.createOrder = exports.createContactsHandler = exports.createContactWithDefaults = exports.createContact = exports.createCustomersHandler = exports.createGetCustomerHandler = exports.getCustomer = exports.createCustomerWithDefaults = exports.createCustomer = void 0;
+exports.createUpgradeHandler = exports.upgrade = exports.createUnsubscribeHandler = exports.unsubscribe = exports.createSubscribeHandler = exports.subscribe = exports.createGetGroupPlansHandler = exports.getGroupPlans = exports.createGetPlanGroupByIdHandler = exports.getPlanGroupById = exports.getPlanById = exports.createProvisioningHandler = exports.provisionNewUser = exports.createCustomerInvoicesHandler = exports.getCustomerInvoices = exports.createSetupIntentHandler = exports.createSetupIntent = exports.createActivateOrderSyncHandler = exports.activateOrderSync = exports.createPayInvoiceHandler = exports.payInvoice = exports.createOrdersHandler = exports.createOrderWithDefaults = exports.createOrder = exports.createContactsHandler = exports.createContactWithDefaults = exports.createContact = exports.createCustomersHandler = exports.createGetCustomerHandler = exports.getCustomer = exports.createCustomerWithDefaults = exports.createCustomer = void 0;
 var customers_js_1 = require("./customers.js");
 Object.defineProperty(exports, "createCustomer", { enumerable: true, get: function () { return customers_js_1.createCustomer; } });
 Object.defineProperty(exports, "createCustomerWithDefaults", { enumerable: true, get: function () { return customers_js_1.createCustomerWithDefaults; } });
@@ -28,3 +28,15 @@ Object.defineProperty(exports, "createCustomerInvoicesHandler", { enumerable: tr
 var provision_users_js_1 = require("./provision-users.js");
 Object.defineProperty(exports, "provisionNewUser", { enumerable: true, get: function () { return provision_users_js_1.provisionNewUser; } });
 Object.defineProperty(exports, "createProvisioningHandler", { enumerable: true, get: function () { return provision_users_js_1.createProvisioningHandler; } });
+var plans_js_1 = require("./plans.js");
+Object.defineProperty(exports, "getPlanById", { enumerable: true, get: function () { return plans_js_1.getPlanById; } });
+Object.defineProperty(exports, "getPlanGroupById", { enumerable: true, get: function () { return plans_js_1.getPlanGroupById; } });
+Object.defineProperty(exports, "createGetPlanGroupByIdHandler", { enumerable: true, get: function () { return plans_js_1.createGetPlanGroupByIdHandler; } });
+Object.defineProperty(exports, "getGroupPlans", { enumerable: true, get: function () { return plans_js_1.getGroupPlans; } });
+Object.defineProperty(exports, "createGetGroupPlansHandler", { enumerable: true, get: function () { return plans_js_1.createGetGroupPlansHandler; } });
+Object.defineProperty(exports, "subscribe", { enumerable: true, get: function () { return plans_js_1.subscribe; } });
+Object.defineProperty(exports, "createSubscribeHandler", { enumerable: true, get: function () { return plans_js_1.createSubscribeHandler; } });
+Object.defineProperty(exports, "unsubscribe", { enumerable: true, get: function () { return plans_js_1.unsubscribe; } });
+Object.defineProperty(exports, "createUnsubscribeHandler", { enumerable: true, get: function () { return plans_js_1.createUnsubscribeHandler; } });
+Object.defineProperty(exports, "upgrade", { enumerable: true, get: function () { return plans_js_1.upgrade; } });
+Object.defineProperty(exports, "createUpgradeHandler", { enumerable: true, get: function () { return plans_js_1.createUpgradeHandler; } });

package/dist/cjs/integrations/controllers/orders.js

@@ -13,11 +13,17 @@ exports.createOrderWithDefaults = createOrderWithDefaults;
 exports.createOrder = createOrder;
 exports.createOrdersHandler = createOrdersHandler;
 const base_handler_js_1 = require("../utils/base-handler.js");
+const plans_js_1 = require("./plans.js");
+function hasProductWithExternalId(pp) {
+    if (!pp.product) {
+        throw new Error(`Plan product ${pp.id} is missing nested product data`);
+    }
+    return !!pp.product.externalId;
+}
 /**
  * Generate default values for missing order fields
  */
 function generateOrderDefaults(config, options = {}) {
-    var _a;
     const { defaultDurationDays = 365 } = options;
     const startDate = config.startDate || new Date().toISOString().split("T")[0];
     const endDate = config.endDate ||
@@ -27,20 +33,31 @@ function generateOrderDefaults(config, options = {}) {
     const name = config.name || "Subscription Order";
     const description = config.description || "Annual subscription";
     const currency = config.currency || "USD";
-    const orderLines = ((_a = config.orderLines) === null || _a === void 0 ? void 0 : _a.map(line => ({
-        agentExternalId: line.agentExternalId,
-        name: line.name || name,
-        description: line.description || description,
-    }))) || [{
-            agentExternalId: config.agentExternalId,
-            name,
-            description,
-        }];
+    // defensive guard
+    if (!config.orderLines && !config.planId && !config.agentExternalId) {
+        throw new Error("Either orderLines, planId, or agentExternalId must be provided");
+    }
+    const orderLines = config.orderLines
+        ? config.orderLines.map(line => {
+            var _a;
+            return ({
+                agentExternalId: line.agentExternalId,
+                name: line.name || name,
+                description: line.description || description,
+                planProductId: (_a = line.planProductId) !== null && _a !== void 0 ? _a : undefined,
+            });
+        })
+        : [{
+                agentExternalId: config.agentExternalId,
+                name,
+                description,
+            }];
     return {
         customerId: config.customerId,
         customerExternalId: config.customerExternalId,
         billingContactId: config.billingContactId,
         agentExternalId: config.agentExternalId,
+        planId: config.planId,
         name,
         description,
         startDate,
@@ -69,8 +86,12 @@ function createAndActivateOrder(client, config, autoActivate) {
                     orderLine.name = line.name;
                 if (line.description)
                     orderLine.description = line.description;
+                // planProductId is not in the create orders api spec - this is functioning but greptile will complain
+                if (line.planProductId)
+                    orderLine.planProductId = line.planProductId;
                 return orderLine;
             }),
+            planId: config.planId,
         });
         if (!order.id) {
             throw new Error("Order created but missing ID");
@@ -177,18 +198,32 @@ function createOrder(client_1, config_1) {
  */
 function createOrdersHandler(helperOptions) {
     return (0, base_handler_js_1.createHandler)((client, body) => __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        if (!body.customerId) {
-            throw new Error("customerId is required");
-        }
+        var _a, _b, _c;
         if (!body.customerExternalId) {
             throw new Error("customerExternalId is required");
         }
-        if (!body.agentExternalId) {
-            throw new Error("agentExternalId is required");
+        if (!body.agentExternalId && !body.planId) {
+            throw new Error("agentExternalId or planId are required");
         }
         const orderOptions = Object.assign(Object.assign({}, helperOptions), { autoActivate: (_b = (_a = body.autoActivate) !== null && _a !== void 0 ? _a : helperOptions === null || helperOptions === void 0 ? void 0 : helperOptions.autoActivate) !== null && _b !== void 0 ? _b : true });
+        if (body.planId) {
+            const plan = yield (0, plans_js_1.getPlanById)(client, body.planId);
+            if (!((_c = plan.planProducts) === null || _c === void 0 ? void 0 : _c.length)) {
+                throw new Error(`Plan ${body.planId} has no products`);
+            }
+            body.orderLines = plan.planProducts
+                .filter(hasProductWithExternalId)
+                .map((pp) => ({
+                agentExternalId: pp.product.externalId,
+                name: pp.product.name,
+                description: pp.product.description,
+                planProductId: pp.id,
+            }));
+            if (body.orderLines.length === 0) {
+                throw new Error(`Plan ${body.planId} has no products with externalId`);
+            }
+        }
         const order = yield createOrderWithDefaults(client, body, orderOptions);
         return { success: true, data: order };
-    }), { requiredFields: ['customerId', 'customerExternalId', 'agentExternalId'] });
+    }), { requiredFields: ['customerExternalId'] });
 }