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

package/dist/esm/integrations/adapters/expressjs/routes.mjs

@@ -9,6 +9,7 @@ import { createCustomersHandler, createGetCustomerHandler } from "../../controll
 import { createOrdersHandler } from "../../controllers/orders.mjs";
 import { createProvisioningHandler } from "../../controllers/provision-users.mjs";
 import { createActivateOrderSyncHandler, createPayInvoiceHandler, createSetupIntentHandler, } from "../../controllers/billing.mjs";
+import { createGetPlanGroupByIdHandler } from "../../controllers/plans.mjs";
 /**
  * Helper to extract headers from Express Request
  */
@@ -265,3 +266,29 @@ export 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());
+ * ```
+ */
+export function createGetPlanGroupByIdRoute(config = {}) {
+    const handler = createGetPlanGroupByIdHandler();
+    return (req, res) => {
+        return handler({
+            body: req.body,
+            headers: extractHeaders(req),
+            method: "GET",
+            params: req.params,
+        }, createExpressJSResponseContext(res), config);
+    };
+}

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

@@ -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.mjs';
+export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createGetCustomerRoute, createGetPlanGroupByIdRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, type ActivateOrderSyncRouteConfig, type OrdersRouteConfig, type ProvisioningRouteConfig, type SetupIntentRouteConfig, } from "./routes.mjs";

package/dist/esm/integrations/adapters/nextjs/index.mjs

@@ -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, } from './routes.mjs';
+export { createActivateOrderSyncRoute, createContactsRoute, createCustomerInvoicesRoute, createCustomersRoute, createGetCustomerRoute, createGetPlanGroupByIdRoute, createOrdersRoute, createPayInvoiceRoute, createProvisioningRoute, createSetupIntentRoute, } from "./routes.mjs";

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

@@ -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/esm/integrations/adapters/nextjs/routes.mjs

@@ -5,6 +5,7 @@ import { createCustomersHandler, createGetCustomerHandler } from "../../controll
 import { createOrdersHandler } from "../../controllers/orders.mjs";
 import { createProvisioningHandler } from "../../controllers/provision-users.mjs";
 import { createActivateOrderSyncHandler, createPayInvoiceHandler, createSetupIntentHandler } from "../../controllers/billing.mjs";
+import { createGetPlanGroupByIdHandler } from "../../controllers/plans.mjs";
 /**
  * Create a Next.js API route handler for synchronous order activation
  *
@@ -242,3 +243,22 @@ export 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();
+ * ```
+ */
+export function createGetPlanGroupByIdRoute(config = {}) {
+    const handler = createGetPlanGroupByIdHandler();
+    const adaptedHandler = nextjsAdapter(handler);
+    return (request, context) => adaptedHandler(request, context, config);
+}

package/dist/esm/integrations/controllers/index.d.mts

@@ -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.mjs";
 export { getCustomerInvoices, createCustomerInvoicesHandler, type CustomerInvoicesResult, } from "./invoices.mjs";
 export { provisionNewUser, createProvisioningHandler, } from "./provision-users.mjs";
+export { createGetPlanGroupByIdHandler, } from "./plans.mjs";

package/dist/esm/integrations/controllers/index.mjs

@@ -4,3 +4,4 @@ export { createOrder, createOrderWithDefaults, createOrdersHandler, } from "./or
 export { payInvoice, createPayInvoiceHandler, activateOrderSync, createActivateOrderSyncHandler, createSetupIntent, createSetupIntentHandler, } from "./billing.mjs";
 export { getCustomerInvoices, createCustomerInvoicesHandler, } from "./invoices.mjs";
 export { provisionNewUser, createProvisioningHandler, } from "./provision-users.mjs";
+export { createGetPlanGroupByIdHandler, } from "./plans.mjs";

package/dist/esm/integrations/controllers/orders.mjs

@@ -8,11 +8,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { createHandler } from "../utils/base-handler.mjs";
+import { getPlanById } from "./plans.mjs";
+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 ||
@@ -22,20 +28,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,
@@ -64,8 +81,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");
@@ -172,18 +193,32 @@ export function createOrder(client_1, config_1) {
  */
 export function createOrdersHandler(helperOptions) {
     return 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 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/esm/integrations/controllers/plans.d.mts

@@ -0,0 +1,50 @@
+import { PaidClient } from "../../Client.mjs";
+import type { PlanGroup } from "../../api/types/PlanGroup.mjs";
+import type { Plan } from "../../api/types/Plan.mjs";
+/**
+ * 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>;

package/dist/esm/integrations/controllers/plans.mjs

@@ -0,0 +1,84 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { PaidClient } from "../../Client.mjs";
+import { createHandler } from "../utils/base-handler.mjs";
+/**
+ * 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 function getPlanById(client, planId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const plan = yield client.plans.getById(planId);
+        return 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 function getPlanGroupById(client, planGroupId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const planGroup = yield client.plans.getGroupById(planGroupId);
+        return 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 function createGetPlanGroupByIdHandler() {
+    return 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 planGroup = yield getPlanGroupById(client, planGroupId);
+        return { success: true, data: planGroup };
+    }), {
+        allowedMethods: ['GET'],
+        requireOrganizationId: false,
+    });
+}

package/dist/esm/integrations/types.d.mts

@@ -41,18 +41,20 @@ export interface OrderConfig {
     customerId: string;
     customerExternalId: string;
     billingContactId?: string;
-    agentExternalId: string;
+    agentExternalId?: string;
     name?: string;
     description?: string;
     startDate?: string;
     endDate?: string;
     currency?: string;
     orderLines?: OrderLineConfig[];
+    planId?: string;
 }
 export interface OrderLineConfig {
     agentExternalId: string;
     name?: string;
     description?: string;
+    planProductId?: string;
 }
 /**
  * Note: orderLines is not required because if agentExternalId is provided,
@@ -62,13 +64,14 @@ export interface CompleteOrderConfig {
     customerId: string;
     customerExternalId: string;
     billingContactId?: string;
-    agentExternalId: string;
+    agentExternalId?: string;
     name: string;
     description: string;
     startDate: string;
     endDate: string;
     currency: string;
     orderLines: OrderLineConfig[];
+    planId?: string;
 }
 export interface OrderOptions {
     /**

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

@@ -1,11 +1,8 @@
 {
     "name": "@paid-ai/paid-node",
-    "version": "1.0.0",
+    "version": "1.0.1-alpha1",
     "private": false,
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/paid-ai/paid-node.git"
-    },
+    "repository": "github:paid-ai/paid-node",
     "type": "commonjs",
     "main": "./dist/cjs/index.js",
     "module": "./dist/esm/index.mjs",
@@ -241,9 +238,43 @@
         "path": false,
         "stream": false
     },
-    "packageManager": "pnpm@10.20.0",
+    "packageManager": "pnpm@10.14.0",
     "engines": {
         "node": ">=18.0.0"
     },
-    "sideEffects": false
+    "sideEffects": false,
+    "typesVersions": {
+        "*": {
+            "openai": [
+                "./dist/cjs/openai-wrapper/index.d.ts"
+            ],
+            "anthropic": [
+                "./dist/cjs/anthropic-wrapper/index.d.ts"
+            ],
+            "mistral": [
+                "./dist/cjs/mistral-wrapper/index.d.ts"
+            ],
+            "langchain": [
+                "./dist/cjs/langchain-wrapper/index.d.ts"
+            ],
+            "vercel": [
+                "./dist/cjs/vercel-wrapper/index.d.ts"
+            ],
+            "tracing": [
+                "./dist/cjs/tracing/index.d.ts"
+            ],
+            "integrations": [
+                "./dist/cjs/integrations/index.d.ts"
+            ],
+            "integrations/nextjs": [
+                "./dist/cjs/integrations/adapters/nextjs/index.d.ts"
+            ],
+            "integrations/express": [
+                "./dist/cjs/integrations/adapters/expressjs/index.d.ts"
+            ],
+            "integrations/nestjs": [
+                "./dist/cjs/integrations/adapters/nestjs/index.d.ts"
+            ]
+        }
+    }
 }