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

package/dist/cjs/Client.js

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

@@ -54,5 +54,17 @@ export declare class Plans {
      */
     getGroupById(planGroupId: string, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.PlanGroup>;
     private __getGroupById;
+    /**
+     * @param {string} planGroupId - The ID of the plan group
+     * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.plans.getGroupPlans("planGroupId")
+     */
+    getGroupPlans(planGroupId: string, requestOptions?: Plans.RequestOptions): core.HttpResponsePromise<Paid.PlanWithFeatures[]>;
+    private __getGroupPlans;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

package/dist/cjs/api/resources/plans/client/Client.js

@@ -216,7 +216,7 @@ class Plans {
             var _a, _b, _c, _d, _e, _f, _g, _h;
             const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PaidEnvironment.Production, `plans/group/${core.url.encodePathParam(planGroupId)}`),
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PaidEnvironment.Production, `plans/planGroup/${core.url.encodePathParam(planGroupId)}`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -249,7 +249,67 @@ class Plans {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.PaidTimeoutError("Timeout exceeded when calling GET /plans/group/{planGroupId}.");
+                    throw new errors.PaidTimeoutError("Timeout exceeded when calling GET /plans/planGroup/{planGroupId}.");
+                case "unknown":
+                    throw new errors.PaidError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * @param {string} planGroupId - The ID of the plan group
+     * @param {Plans.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.plans.getGroupPlans("planGroupId")
+     */
+    getGroupPlans(planGroupId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getGroupPlans(planGroupId, requestOptions));
+    }
+    __getGroupPlans(planGroupId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PaidEnvironment.Production, `plans/planGroup/${core.url.encodePathParam(planGroupId)}/plans`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 403:
+                        throw new Paid.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Paid.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PaidError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PaidError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PaidTimeoutError("Timeout exceeded when calling GET /plans/planGroup/{planGroupId}/plans.");
                 case "unknown":
                     throw new errors.PaidError({
                         message: _response.error.errorMessage,

package/dist/cjs/api/resources/usage/client/Client.d.ts

@@ -33,15 +33,15 @@ export declare class Usage {
      *     await client.usage.usageRecordBulkV2({
      *         signals: [{
      *                 event_name: "emails_sent",
-     *                 product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
-     *                 customer_id: "7d0b6fce-d82a-433d-8315-c994f8f1d68d"
+     *                 product_id: "prod_abc123def",
+     *                 customer_id: "cus_xyz789ghi"
      *             }, {
      *                 event_name: "emails_sent",
      *                 external_product_id: "acme-product",
      *                 external_customer_id: "acme-inc"
      *             }, {
      *                 event_name: "meeting_booked",
-     *                 product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
+     *                 product_id: "prod_abc123def",
      *                 external_customer_id: "acme-inc",
      *                 data: {
      *                     "meeting_duration": 30,

package/dist/cjs/api/resources/usage/client/Client.js

@@ -120,15 +120,15 @@ class Usage {
      *     await client.usage.usageRecordBulkV2({
      *         signals: [{
      *                 event_name: "emails_sent",
-     *                 product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
-     *                 customer_id: "7d0b6fce-d82a-433d-8315-c994f8f1d68d"
+     *                 product_id: "prod_abc123def",
+     *                 customer_id: "cus_xyz789ghi"
      *             }, {
      *                 event_name: "emails_sent",
      *                 external_product_id: "acme-product",
      *                 external_customer_id: "acme-inc"
      *             }, {
      *                 event_name: "meeting_booked",
-     *                 product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
+     *                 product_id: "prod_abc123def",
      *                 external_customer_id: "acme-inc",
      *                 data: {
      *                     "meeting_duration": 30,

package/dist/cjs/api/resources/usage/client/requests/UsageRecordBulkV2Request.d.ts

@@ -4,15 +4,15 @@ import type * as Paid from "../../../../index.js";
  *     {
  *         signals: [{
  *                 event_name: "emails_sent",
- *                 product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
- *                 customer_id: "7d0b6fce-d82a-433d-8315-c994f8f1d68d"
+ *                 product_id: "prod_abc123def",
+ *                 customer_id: "cus_xyz789ghi"
  *             }, {
  *                 event_name: "emails_sent",
  *                 external_product_id: "acme-product",
  *                 external_customer_id: "acme-inc"
  *             }, {
  *                 event_name: "meeting_booked",
- *                 product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
+ *                 product_id: "prod_abc123def",
  *                 external_customer_id: "acme-inc",
  *                 data: {
  *                     "meeting_duration": 30,

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

@@ -0,0 +1,34 @@
+/**
+ * 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;
+    /** 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 {
+    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,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, type ActivateOrderSyncRouteConfig, type OrdersRouteConfig, type ProvisioningRouteConfig, type SetupIntentRouteConfig, } from "./routes.js";

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

@@ -4,13 +4,14 @@
  * 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.createSetupIntentRoute = exports.createProvisioningRoute = exports.createPayInvoiceRoute = exports.createOrdersRoute = 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, "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/nextjs/routes.d.ts

@@ -224,4 +224,19 @@ 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>;
 export {};

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

@@ -9,6 +9,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");
@@ -16,6 +17,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 +255,22 @@ 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);
+}

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 { createGetPlanGroupByIdHandler, } 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.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;
 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,5 @@ 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, "createGetPlanGroupByIdHandler", { enumerable: true, get: function () { return plans_js_1.createGetPlanGroupByIdHandler; } });

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'] });
 }

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

@@ -0,0 +1,50 @@
+import { PaidClient } from "../../Client.js";
+import type { PlanGroup } from "../../api/types/PlanGroup.js";
+import type { Plan } from "../../api/types/Plan.js";
+/**
+ * Get a plan by ID
+ *
+ * @param client - PaidClient instance
+ * @param planId - Plan's ID
+ * @returns Plan data
+ *
+ * @example
+ * ```typescript
+ * const plan = await getPlanById(client, 'plan-123');
+ * console.log(plan.name, plan.id);
+ * ```
+ */
+export declare function getPlanById(client: PaidClient, planId: string): Promise<Plan>;
+/**
+ * Get a plan group by ID
+ *
+ * @param client - PaidClient instance
+ * @param planGroupId - Plan group's ID
+ * @returns Plan group data
+ *
+ * @example
+ * ```typescript
+ * const planGroup = await getPlanGroupById(client, 'plan-group-123');
+ * console.log(planGroup.name, planGroup.id);
+ * ```
+ */
+export declare function getPlanGroupById(client: PaidClient, planGroupId: string): Promise<PlanGroup>;
+/**
+ * Create a framework-agnostic handler for fetching a plan group by ID
+ *
+ * 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]/route.ts
+ * import { createGetPlanGroupByIdHandler } from '@paid-ai/paid-node/integrations';
+ * import { nextjsAdapter } from '@paid-ai/paid-node/integrations/nextjs';
+ *
+ * const handler = createGetPlanGroupByIdHandler();
+ * export const GET = nextjsAdapter(handler);
+ * ```
+ */
+export declare function createGetPlanGroupByIdHandler(): (request: any, response: any, config?: any) => Promise<any>;