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

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

@@ -10,6 +10,10 @@ 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");
@@ -274,3 +278,79 @@ function createGetPlanGroupByIdRoute(config = {}) {
     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,4 +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 { createGetPlanGroupByIdHandler, } from "./plans.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.createGetPlanGroupByIdHandler = 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; } });
@@ -29,4 +29,14 @@ 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/plans.d.ts

@@ -1,6 +1,13 @@
 import { PaidClient } from "../../Client.js";
 import type { PlanGroup } from "../../api/types/PlanGroup.js";
 import type { Plan } from "../../api/types/Plan.js";
+import type { PlanWithFeatures } from "../../api/types/PlanWithFeatures.js";
+import type { Order } from "../../api/types/Order.js";
+import type { CancelRenewalResponse } from "../../api/types/CancelRenewalResponse.js";
+import type { ProrationUpgradeResponse } from "../../api/types/ProrationUpgradeResponse.js";
+import type { PlansSubscribeRequest } from "../../api/resources/plans/client/requests/PlansSubscribeRequest.js";
+import type { PlansUnsubscribeRequest } from "../../api/resources/plans/client/requests/PlansUnsubscribeRequest.js";
+import type { PlansUpgradeRequest } from "../../api/resources/plans/client/requests/PlansUpgradeRequest.js";
 /**
  * Get a plan by ID
  *
@@ -48,3 +55,154 @@ export declare function getPlanGroupById(client: PaidClient, planGroupId: string
  * ```
  */
 export declare function createGetPlanGroupByIdHandler(): (request: any, response: any, config?: any) => Promise<any>;
+/**
+ * Get all plans in a plan group
+ *
+ * @param client - PaidClient instance
+ * @param planGroupId - Plan group's ID
+ * @returns Array of plans with features
+ *
+ * @example
+ * ```typescript
+ * const plans = await getGroupPlans(client, 'plan-group-123');
+ * console.log(plans.length);
+ * ```
+ */
+export declare function getGroupPlans(client: PaidClient, planGroupId: string): Promise<PlanWithFeatures[]>;
+/**
+ * Create a framework-agnostic handler for fetching plans in a plan group
+ *
+ * This handler can be used with any framework adapter.
+ * The plan group ID should be provided either in params or query string.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/plans/[planGroupId]/plans/route.ts
+ * import { createGetGroupPlansHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createGetGroupPlansHandler();
+ * export const GET = nextjsAdapter(handler);
+ * ```
+ */
+export declare function createGetGroupPlansHandler(): (request: any, response: any, config?: any) => Promise<any>;
+/**
+ * Subscribe a customer to a plan
+ *
+ * Creates a new order for a customer based on the specified plan, automatically converting plan products to order lines.
+ *
+ * @param client - PaidClient instance
+ * @param planId - Plan's ID
+ * @param request - Subscribe request with customer external ID and currency
+ * @returns Created order
+ *
+ * @example
+ * ```typescript
+ * const order = await subscribe(client, 'plan-123', {
+ *   customerExternalId: 'customer-123',
+ *   currency: 'USD'
+ * });
+ * console.log(order.id);
+ * ```
+ */
+export declare function subscribe(client: PaidClient, planId: string, request: PlansSubscribeRequest): Promise<Order>;
+/**
+ * Create a framework-agnostic handler for subscribing a customer to a plan
+ *
+ * This handler can be used with any framework adapter.
+ * The plan ID should be provided either in params or query string.
+ * The request body should contain customerExternalId and currency.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/plans/[planId]/subscribe/route.ts
+ * import { createSubscribeHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createSubscribeHandler();
+ * export const POST = nextjsAdapter(handler);
+ * ```
+ */
+export declare function createSubscribeHandler(): (request: any, response: any, config?: any) => Promise<any>;
+/**
+ * Unsubscribe a customer from a plan
+ *
+ * Cancels the renewal of an order associated with the specified plan. The order will remain active until the cancellation date.
+ *
+ * @param client - PaidClient instance
+ * @param planId - Plan's ID
+ * @param request - Unsubscribe request with customer external ID
+ * @returns Cancel renewal response
+ *
+ * @example
+ * ```typescript
+ * const response = await unsubscribe(client, 'plan-123', {
+ *   customerExternalId: 'customer-123'
+ * });
+ * console.log(response.message);
+ * ```
+ */
+export declare function unsubscribe(client: PaidClient, planId: string, request: PlansUnsubscribeRequest): Promise<CancelRenewalResponse>;
+/**
+ * Create a framework-agnostic handler for unsubscribing a customer from a plan
+ *
+ * This handler can be used with any framework adapter.
+ * The plan ID should be provided either in params or query string.
+ * The request body should contain customerExternalId.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/plans/[planId]/unsubscribe/route.ts
+ * import { createUnsubscribeHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createUnsubscribeHandler();
+ * export const POST = nextjsAdapter(handler);
+ * ```
+ */
+export declare function createUnsubscribeHandler(): (request: any, response: any, config?: any) => Promise<any>;
+/**
+ * Upgrade a customer from their current plan to a new plan
+ *
+ * Upgrades a customer from their current plan to a new plan with automatic proration calculation. This schedules a plan change and applies credits for the unused portion of the current billing period.
+ *
+ * @param client - PaidClient instance
+ * @param request - Upgrade request with customer external ID, old plan ID, and new plan ID
+ * @returns Proration upgrade response
+ *
+ * @example
+ * ```typescript
+ * const response = await upgrade(client, {
+ *   customerExternalId: 'customer-123',
+ *   oldPlanId: 'plan-123',
+ *   newPlanId: 'plan-456'
+ * });
+ * console.log(response.order.id);
+ * ```
+ */
+export declare function upgrade(client: PaidClient, request: PlansUpgradeRequest): Promise<ProrationUpgradeResponse>;
+/**
+ * Create a framework-agnostic handler for upgrading a customer's plan
+ *
+ * This handler can be used with any framework adapter.
+ * The request body should contain customerExternalId, oldPlanId, and newPlanId.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/plans/upgrade/route.ts
+ * import { createUpgradeHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createUpgradeHandler();
+ * export const POST = nextjsAdapter(handler);
+ * ```
+ */
+export declare function createUpgradeHandler(): (request: any, response: any, config?: any) => Promise<any>;

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

@@ -12,6 +12,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPlanById = getPlanById;
 exports.getPlanGroupById = getPlanGroupById;
 exports.createGetPlanGroupByIdHandler = createGetPlanGroupByIdHandler;
+exports.getGroupPlans = getGroupPlans;
+exports.createGetGroupPlansHandler = createGetGroupPlansHandler;
+exports.subscribe = subscribe;
+exports.createSubscribeHandler = createSubscribeHandler;
+exports.unsubscribe = unsubscribe;
+exports.createUnsubscribeHandler = createUnsubscribeHandler;
+exports.upgrade = upgrade;
+exports.createUpgradeHandler = createUpgradeHandler;
 const base_handler_js_1 = require("../utils/base-handler.js");
 /**
  * Get a plan by ID
@@ -86,3 +94,272 @@ function createGetPlanGroupByIdHandler() {
         requireOrganizationId: false,
     });
 }
+/**
+ * Get all plans in a plan group
+ *
+ * @param client - PaidClient instance
+ * @param planGroupId - Plan group's ID
+ * @returns Array of plans with features
+ *
+ * @example
+ * ```typescript
+ * const plans = await getGroupPlans(client, 'plan-group-123');
+ * console.log(plans.length);
+ * ```
+ */
+function getGroupPlans(client, planGroupId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const plans = yield client.plans.getGroupPlans(planGroupId);
+        return plans;
+    });
+}
+/**
+ * Create a framework-agnostic handler for fetching plans in a plan group
+ *
+ * This handler can be used with any framework adapter.
+ * The plan group ID should be provided either in params or query string.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/plans/[planGroupId]/plans/route.ts
+ * import { createGetGroupPlansHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createGetGroupPlansHandler();
+ * export const GET = nextjsAdapter(handler);
+ * ```
+ */
+function createGetGroupPlansHandler() {
+    return (0, base_handler_js_1.createHandler)((client, _body, params) => __awaiter(this, void 0, void 0, function* () {
+        const planGroupId = params === null || params === void 0 ? void 0 : params.planGroupId;
+        if (!planGroupId) {
+            return {
+                success: false,
+                error: "planGroupId is required",
+                status: 400,
+            };
+        }
+        const plans = yield getGroupPlans(client, planGroupId);
+        return { success: true, data: plans };
+    }), {
+        allowedMethods: ['GET'],
+        requireOrganizationId: false,
+    });
+}
+/**
+ * Subscribe a customer to a plan
+ *
+ * Creates a new order for a customer based on the specified plan, automatically converting plan products to order lines.
+ *
+ * @param client - PaidClient instance
+ * @param planId - Plan's ID
+ * @param request - Subscribe request with customer external ID and currency
+ * @returns Created order
+ *
+ * @example
+ * ```typescript
+ * const order = await subscribe(client, 'plan-123', {
+ *   customerExternalId: 'customer-123',
+ *   currency: 'USD'
+ * });
+ * console.log(order.id);
+ * ```
+ */
+function subscribe(client, planId, request) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const order = yield client.plans.subscribe(planId, request);
+        return order;
+    });
+}
+/**
+ * Create a framework-agnostic handler for subscribing a customer to a plan
+ *
+ * This handler can be used with any framework adapter.
+ * The plan ID should be provided either in params or query string.
+ * The request body should contain customerExternalId and currency.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/plans/[planId]/subscribe/route.ts
+ * import { createSubscribeHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createSubscribeHandler();
+ * export const POST = nextjsAdapter(handler);
+ * ```
+ */
+function createSubscribeHandler() {
+    return (0, base_handler_js_1.createHandler)((client, body, params) => __awaiter(this, void 0, void 0, function* () {
+        const planId = params === null || params === void 0 ? void 0 : params.planId;
+        if (!planId) {
+            return {
+                success: false,
+                error: "planId is required",
+                status: 400,
+            };
+        }
+        if (!body.customerExternalId) {
+            return {
+                success: false,
+                error: "customerExternalId is required",
+                status: 400,
+            };
+        }
+        if (!body.currency) {
+            return {
+                success: false,
+                error: "currency is required",
+                status: 400,
+            };
+        }
+        const order = yield subscribe(client, planId, body);
+        return { success: true, data: order };
+    }), {
+        allowedMethods: ['POST'],
+        requireOrganizationId: false,
+    });
+}
+/**
+ * Unsubscribe a customer from a plan
+ *
+ * Cancels the renewal of an order associated with the specified plan. The order will remain active until the cancellation date.
+ *
+ * @param client - PaidClient instance
+ * @param planId - Plan's ID
+ * @param request - Unsubscribe request with customer external ID
+ * @returns Cancel renewal response
+ *
+ * @example
+ * ```typescript
+ * const response = await unsubscribe(client, 'plan-123', {
+ *   customerExternalId: 'customer-123'
+ * });
+ * console.log(response.message);
+ * ```
+ */
+function unsubscribe(client, planId, request) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield client.plans.unsubscribe(planId, request);
+        return response;
+    });
+}
+/**
+ * Create a framework-agnostic handler for unsubscribing a customer from a plan
+ *
+ * This handler can be used with any framework adapter.
+ * The plan ID should be provided either in params or query string.
+ * The request body should contain customerExternalId.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/plans/[planId]/unsubscribe/route.ts
+ * import { createUnsubscribeHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createUnsubscribeHandler();
+ * export const POST = nextjsAdapter(handler);
+ * ```
+ */
+function createUnsubscribeHandler() {
+    return (0, base_handler_js_1.createHandler)((client, body, params) => __awaiter(this, void 0, void 0, function* () {
+        const planId = params === null || params === void 0 ? void 0 : params.planId;
+        if (!planId) {
+            return {
+                success: false,
+                error: "planId is required",
+                status: 400,
+            };
+        }
+        if (!body.customerExternalId) {
+            return {
+                success: false,
+                error: "customerExternalId is required",
+                status: 400,
+            };
+        }
+        const response = yield unsubscribe(client, planId, body);
+        return { success: true, data: response };
+    }), {
+        allowedMethods: ['POST'],
+        requireOrganizationId: false,
+    });
+}
+/**
+ * Upgrade a customer from their current plan to a new plan
+ *
+ * Upgrades a customer from their current plan to a new plan with automatic proration calculation. This schedules a plan change and applies credits for the unused portion of the current billing period.
+ *
+ * @param client - PaidClient instance
+ * @param request - Upgrade request with customer external ID, old plan ID, and new plan ID
+ * @returns Proration upgrade response
+ *
+ * @example
+ * ```typescript
+ * const response = await upgrade(client, {
+ *   customerExternalId: 'customer-123',
+ *   oldPlanId: 'plan-123',
+ *   newPlanId: 'plan-456'
+ * });
+ * console.log(response.order.id);
+ * ```
+ */
+function upgrade(client, request) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield client.plans.upgrade(request);
+        return response;
+    });
+}
+/**
+ * Create a framework-agnostic handler for upgrading a customer's plan
+ *
+ * This handler can be used with any framework adapter.
+ * The request body should contain customerExternalId, oldPlanId, and newPlanId.
+ *
+ * @returns Handler function
+ *
+ * @example
+ * ```typescript
+ * // In Next.js route: /api/plans/upgrade/route.ts
+ * import { createUpgradeHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createUpgradeHandler();
+ * export const POST = nextjsAdapter(handler);
+ * ```
+ */
+function createUpgradeHandler() {
+    return (0, base_handler_js_1.createHandler)((client, body) => __awaiter(this, void 0, void 0, function* () {
+        if (!body.customerExternalId) {
+            return {
+                success: false,
+                error: "customerExternalId is required",
+                status: 400,
+            };
+        }
+        if (!body.oldPlanId) {
+            return {
+                success: false,
+                error: "oldPlanId is required",
+                status: 400,
+            };
+        }
+        if (!body.newPlanId) {
+            return {
+                success: false,
+                error: "newPlanId is required",
+                status: 400,
+            };
+        }
+        const response = yield upgrade(client, body);
+        return { success: true, data: response };
+    }), {
+        allowedMethods: ['POST'],
+        requireOrganizationId: false,
+    });
+}

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.1-alpha1";
+export declare const SDK_VERSION = "1.0.1-alpha2";

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 = "1.0.1-alpha1";
+exports.SDK_VERSION = "1.0.1-alpha2";

package/dist/esm/Client.mjs

@@ -14,8 +14,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": "1.0.1-alpha1",
-                "User-Agent": "@paid-ai/paid-node/1.0.1-alpha1",
+                "X-Fern-SDK-Version": "1.0.1-alpha2",
+                "User-Agent": "@paid-ai/paid-node/1.0.1-alpha2",
                 "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/api/resources/plans/client/Client.d.mts

@@ -42,6 +42,62 @@ export declare class Plans {
      */
     getUsage(planId: string, request: Paid.PlansGetUsageRequest, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.UsageSummariesResponse>;
     private __getUsage;
+    /**
+     * Creates a new order for a customer subscribing to a plan. The order will be created with the plan's products and pricing attributes.
+     *
+     * @param {string} planId - The ID of the plan
+     * @param {Paid.PlansSubscribeRequest} request
+     * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.plans.subscribe("planId", {
+     *         customerExternalId: "customerExternalId",
+     *         currency: "currency"
+     *     })
+     */
+    subscribe(planId: string, request: Paid.PlansSubscribeRequest, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.Order>;
+    private __subscribe;
+    /**
+     * Cancels the renewal of an active order for a customer's plan subscription. The order will remain active until the cancellation date.
+     *
+     * @param {string} planId - The ID of the plan
+     * @param {Paid.PlansUnsubscribeRequest} request
+     * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.plans.unsubscribe("planId", {
+     *         customerExternalId: "customerExternalId"
+     *     })
+     */
+    unsubscribe(planId: string, request: Paid.PlansUnsubscribeRequest, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.CancelRenewalResponse>;
+    private __unsubscribe;
+    /**
+     * Upgrades a customer from one plan to another with automatic proration. Credits are applied for the unused portion of the current billing period, and the order is updated with the new plan's pricing.
+     *
+     * @param {Paid.PlansUpgradeRequest} request
+     * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.plans.upgrade({
+     *         customerExternalId: "customerExternalId",
+     *         oldPlanId: "oldPlanId",
+     *         newPlanId: "newPlanId"
+     *     })
+     */
+    upgrade(request: Paid.PlansUpgradeRequest, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.ProrationUpgradeResponse>;
+    private __upgrade;
     /**
      * @param {string} planGroupId - The ID of the plan group
      * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
@@ -55,6 +111,8 @@ export declare class Plans {
     getGroupById(planGroupId: string, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.PlanGroup>;
     private __getGroupById;
     /**
+     * Retrieves all plans in a plan group with their features (product-attribute pairs)
+     *
      * @param {string} planGroupId - The ID of the plan group
      * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
      *