@stackbe/sdk 0.6.4 → 0.6.5

package/README.md

@@ -200,6 +200,64 @@ if (session) {
 const isAuthenticated = await stackbe.auth.isAuthenticated(sessionToken);
 ```
 
+### Plans & Products
+
+List available pricing plans for your pricing page:
+
+```typescript
+// List all plans
+const plans = await stackbe.plans.list();
+
+// List active plans sorted by price
+const plans = await stackbe.plans.listByPrice();
+// [Free ($0), Starter ($9), Pro ($29), Enterprise ($99)]
+
+// Filter by product
+const plans = await stackbe.plans.list({ productId: 'prod_123' });
+
+// Get a specific plan
+const plan = await stackbe.plans.get('plan_123');
+console.log(plan.name, plan.priceCents, plan.entitlements);
+
+// List products
+const products = await stackbe.products.list();
+
+// Get product details
+const product = await stackbe.products.get('prod_123');
+```
+
+#### Dynamic Pricing Page Example
+
+```typescript
+// Next.js pricing page
+export default async function PricingPage() {
+  const plans = await stackbe.plans.listByPrice();
+
+  return (
+    <div className="grid grid-cols-3 gap-4">
+      {plans.map((plan) => (
+        <div key={plan.id} className="border p-4 rounded">
+          <h3>{plan.name}</h3>
+          <p className="text-2xl">
+            ${plan.priceCents / 100}/{plan.interval}
+          </p>
+          <ul>
+            {Object.entries(plan.entitlements).map(([key, value]) => (
+              <li key={key}>
+                {key}: {value === true ? '✓' : value}
+              </li>
+            ))}
+          </ul>
+          <a href={`/checkout?plan=${plan.id}`}>
+            {plan.priceCents === 0 ? 'Start Free' : 'Subscribe'}
+          </a>
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
 ### Customer Management
 
 ```typescript
@@ -226,6 +284,76 @@ const customer = await stackbe.customers.getOrCreate({
 await stackbe.customers.update('cust_123', { name: 'Jane Doe' });
 ```
 
+### Organizations (B2B Multi-User)
+
+Manage customer organizations for B2B apps:
+
+```typescript
+// Create organization with customer as owner
+const org = await stackbe.organizations.create({
+  name: 'Acme Corp',
+  ownerId: customer.id,
+});
+
+// List all organizations
+const orgs = await stackbe.organizations.list();
+
+// Get organization by ID
+const org = await stackbe.organizations.get('org_123');
+
+// Update organization
+await stackbe.organizations.update('org_123', { name: 'New Name' });
+
+// Delete organization (must have no active subscriptions)
+await stackbe.organizations.delete('org_123');
+
+// Add member to organization
+await stackbe.organizations.addMember('org_123', {
+  customerId: 'cust_456',
+  role: 'member', // 'admin' | 'member'
+});
+
+// Remove member
+await stackbe.organizations.removeMember('org_123', 'member_456');
+
+// Update member role
+await stackbe.organizations.updateMember('org_123', 'member_456', {
+  role: 'admin',
+});
+
+// Invite by email
+await stackbe.organizations.invite('org_123', {
+  email: 'newuser@company.com',
+  role: 'member',
+});
+
+// List pending invites
+const invites = await stackbe.organizations.listInvites('org_123');
+
+// Cancel invite
+await stackbe.organizations.cancelInvite('org_123', 'invite_456');
+```
+
+#### B2B Signup Flow
+
+```typescript
+async function signup(email: string, orgName: string) {
+  // 1. Get or create customer
+  const customer = await stackbe.customers.getOrCreate({ email });
+
+  // 2. Create organization with customer as owner
+  const org = await stackbe.organizations.create({
+    name: orgName,
+    ownerId: customer.id,
+  });
+
+  // 3. Send magic link
+  await stackbe.auth.sendMagicLink(email);
+
+  return { customer, org };
+}
+```
+
 ## Express Middleware
 
 ### Track Usage Automatically

package/dist/index.d.mts

@@ -304,6 +304,41 @@ interface OrganizationInvite {
     status: 'pending' | 'accepted' | 'cancelled';
     sentAt: string;
 }
+interface Plan {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    priceCents: number;
+    currency: string;
+    interval: 'month' | 'year';
+    trialDays?: number;
+    entitlements: Record<string, boolean | number | string>;
+    status: 'active' | 'archived';
+    requirePaymentMethod: boolean;
+    productId: string;
+    product?: Product;
+    createdAt: string;
+    updatedAt: string;
+}
+interface Product {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    appId: string;
+    plans?: Plan[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface ListPlansOptions {
+    /** Filter by product ID */
+    productId?: string;
+}
+interface ListProductsOptions {
+    /** Filter by app ID (defaults to SDK appId) */
+    appId?: string;
+}
 interface CreateCheckoutOptions {
     /** Customer ID or email */
     customer: string | {
@@ -1230,6 +1265,116 @@ declare class OrganizationsClient {
     cancelInvite(orgId: string, inviteId: string): Promise<void>;
 }
 
+/**
+ * Client for managing plans and products.
+ * Use this to list available pricing plans for display in your pricing page.
+ *
+ * @example
+ * ```typescript
+ * // List all plans
+ * const plans = await stackbe.plans.list();
+ *
+ * // List plans for a specific product
+ * const plans = await stackbe.plans.list({ productId: 'prod_123' });
+ *
+ * // Get a specific plan
+ * const plan = await stackbe.plans.get('plan_123');
+ *
+ * // List products
+ * const products = await stackbe.products.list();
+ * ```
+ */
+declare class PlansClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all plans for the app.
+     *
+     * @example
+     * ```typescript
+     * // List all plans
+     * const plans = await stackbe.plans.list();
+     *
+     * // Filter by product
+     * const plans = await stackbe.plans.list({ productId: 'prod_123' });
+     *
+     * // Display in pricing page
+     * plans.forEach(plan => {
+     *   console.log(`${plan.name}: $${plan.priceCents / 100}/${plan.interval}`);
+     * });
+     * ```
+     */
+    list(options?: ListPlansOptions): Promise<Plan[]>;
+    /**
+     * Get a plan by ID.
+     *
+     * @example
+     * ```typescript
+     * const plan = await stackbe.plans.get('plan_123');
+     * console.log(plan.name, plan.priceCents, plan.entitlements);
+     * ```
+     */
+    get(planId: string): Promise<Plan>;
+    /**
+     * Get active plans only (excludes archived plans).
+     *
+     * @example
+     * ```typescript
+     * const activePlans = await stackbe.plans.getActive();
+     * ```
+     */
+    getActive(options?: ListPlansOptions): Promise<Plan[]>;
+    /**
+     * Get plans sorted by price (ascending).
+     *
+     * @example
+     * ```typescript
+     * const plans = await stackbe.plans.listByPrice();
+     * // [Free, Starter, Pro, Enterprise]
+     * ```
+     */
+    listByPrice(options?: ListPlansOptions): Promise<Plan[]>;
+}
+/**
+ * Client for managing products.
+ *
+ * @example
+ * ```typescript
+ * // List all products
+ * const products = await stackbe.products.list();
+ *
+ * // Get a specific product
+ * const product = await stackbe.products.get('prod_123');
+ * ```
+ */
+declare class ProductsClient {
+    private readonly http;
+    private readonly appId;
+    constructor(http: HttpClient, appId: string);
+    /**
+     * List all products for the app.
+     *
+     * @example
+     * ```typescript
+     * const products = await stackbe.products.list();
+     * products.forEach(product => {
+     *   console.log(product.name, product.plans?.length, 'plans');
+     * });
+     * ```
+     */
+    list(options?: ListProductsOptions): Promise<Product[]>;
+    /**
+     * Get a product by ID.
+     *
+     * @example
+     * ```typescript
+     * const product = await stackbe.products.get('prod_123');
+     * console.log(product.name, product.description);
+     * ```
+     */
+    get(productId: string): Promise<Product>;
+}
+
 declare class StackBE {
     private http;
     private appId;
@@ -1247,6 +1392,10 @@ declare class StackBE {
     readonly auth: AuthClient;
     /** Organization management (B2B multi-user) */
     readonly organizations: OrganizationsClient;
+    /** Pricing plans */
+    readonly plans: PlansClient;
+    /** Products */
+    readonly products: ProductsClient;
     /**
      * Create a new StackBE client.
      *
@@ -1347,4 +1496,4 @@ declare class StackBE {
     }): (req: any, res: any, next: any) => Promise<any>;
 }
 
-export { type AddMemberOptions, type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type InviteMemberOptions, type MagicLinkOptions, type MagicLinkResponse, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentSucceededEvent, type PaymentWebhookPayload, type SessionResponse, StackBE, type StackBEConfig, StackBEError, type StackBEErrorCode, type StackBEErrorResponse, type Subscription, type SubscriptionCancelledEvent, type SubscriptionCreatedEvent, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, type TrialStartedEvent, type UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };
+export { type AddMemberOptions, type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type InviteMemberOptions, type ListPlansOptions, type ListProductsOptions, type MagicLinkOptions, type MagicLinkResponse, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentSucceededEvent, type PaymentWebhookPayload, type Plan, PlansClient, type Product, ProductsClient, type SessionResponse, StackBE, type StackBEConfig, StackBEError, type StackBEErrorCode, type StackBEErrorResponse, type Subscription, type SubscriptionCancelledEvent, type SubscriptionCreatedEvent, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, type TrialStartedEvent, type UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };

package/dist/index.d.ts

@@ -304,6 +304,41 @@ interface OrganizationInvite {
     status: 'pending' | 'accepted' | 'cancelled';
     sentAt: string;
 }
+interface Plan {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    priceCents: number;
+    currency: string;
+    interval: 'month' | 'year';
+    trialDays?: number;
+    entitlements: Record<string, boolean | number | string>;
+    status: 'active' | 'archived';
+    requirePaymentMethod: boolean;
+    productId: string;
+    product?: Product;
+    createdAt: string;
+    updatedAt: string;
+}
+interface Product {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    appId: string;
+    plans?: Plan[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface ListPlansOptions {
+    /** Filter by product ID */
+    productId?: string;
+}
+interface ListProductsOptions {
+    /** Filter by app ID (defaults to SDK appId) */
+    appId?: string;
+}
 interface CreateCheckoutOptions {
     /** Customer ID or email */
     customer: string | {
@@ -1230,6 +1265,116 @@ declare class OrganizationsClient {
     cancelInvite(orgId: string, inviteId: string): Promise<void>;
 }
 
+/**
+ * Client for managing plans and products.
+ * Use this to list available pricing plans for display in your pricing page.
+ *
+ * @example
+ * ```typescript
+ * // List all plans
+ * const plans = await stackbe.plans.list();
+ *
+ * // List plans for a specific product
+ * const plans = await stackbe.plans.list({ productId: 'prod_123' });
+ *
+ * // Get a specific plan
+ * const plan = await stackbe.plans.get('plan_123');
+ *
+ * // List products
+ * const products = await stackbe.products.list();
+ * ```
+ */
+declare class PlansClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all plans for the app.
+     *
+     * @example
+     * ```typescript
+     * // List all plans
+     * const plans = await stackbe.plans.list();
+     *
+     * // Filter by product
+     * const plans = await stackbe.plans.list({ productId: 'prod_123' });
+     *
+     * // Display in pricing page
+     * plans.forEach(plan => {
+     *   console.log(`${plan.name}: $${plan.priceCents / 100}/${plan.interval}`);
+     * });
+     * ```
+     */
+    list(options?: ListPlansOptions): Promise<Plan[]>;
+    /**
+     * Get a plan by ID.
+     *
+     * @example
+     * ```typescript
+     * const plan = await stackbe.plans.get('plan_123');
+     * console.log(plan.name, plan.priceCents, plan.entitlements);
+     * ```
+     */
+    get(planId: string): Promise<Plan>;
+    /**
+     * Get active plans only (excludes archived plans).
+     *
+     * @example
+     * ```typescript
+     * const activePlans = await stackbe.plans.getActive();
+     * ```
+     */
+    getActive(options?: ListPlansOptions): Promise<Plan[]>;
+    /**
+     * Get plans sorted by price (ascending).
+     *
+     * @example
+     * ```typescript
+     * const plans = await stackbe.plans.listByPrice();
+     * // [Free, Starter, Pro, Enterprise]
+     * ```
+     */
+    listByPrice(options?: ListPlansOptions): Promise<Plan[]>;
+}
+/**
+ * Client for managing products.
+ *
+ * @example
+ * ```typescript
+ * // List all products
+ * const products = await stackbe.products.list();
+ *
+ * // Get a specific product
+ * const product = await stackbe.products.get('prod_123');
+ * ```
+ */
+declare class ProductsClient {
+    private readonly http;
+    private readonly appId;
+    constructor(http: HttpClient, appId: string);
+    /**
+     * List all products for the app.
+     *
+     * @example
+     * ```typescript
+     * const products = await stackbe.products.list();
+     * products.forEach(product => {
+     *   console.log(product.name, product.plans?.length, 'plans');
+     * });
+     * ```
+     */
+    list(options?: ListProductsOptions): Promise<Product[]>;
+    /**
+     * Get a product by ID.
+     *
+     * @example
+     * ```typescript
+     * const product = await stackbe.products.get('prod_123');
+     * console.log(product.name, product.description);
+     * ```
+     */
+    get(productId: string): Promise<Product>;
+}
+
 declare class StackBE {
     private http;
     private appId;
@@ -1247,6 +1392,10 @@ declare class StackBE {
     readonly auth: AuthClient;
     /** Organization management (B2B multi-user) */
     readonly organizations: OrganizationsClient;
+    /** Pricing plans */
+    readonly plans: PlansClient;
+    /** Products */
+    readonly products: ProductsClient;
     /**
      * Create a new StackBE client.
      *
@@ -1347,4 +1496,4 @@ declare class StackBE {
     }): (req: any, res: any, next: any) => Promise<any>;
 }
 
-export { type AddMemberOptions, type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type InviteMemberOptions, type MagicLinkOptions, type MagicLinkResponse, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentSucceededEvent, type PaymentWebhookPayload, type SessionResponse, StackBE, type StackBEConfig, StackBEError, type StackBEErrorCode, type StackBEErrorResponse, type Subscription, type SubscriptionCancelledEvent, type SubscriptionCreatedEvent, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, type TrialStartedEvent, type UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };
+export { type AddMemberOptions, type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type InviteMemberOptions, type ListPlansOptions, type ListProductsOptions, type MagicLinkOptions, type MagicLinkResponse, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentSucceededEvent, type PaymentWebhookPayload, type Plan, PlansClient, type Product, ProductsClient, type SessionResponse, StackBE, type StackBEConfig, StackBEError, type StackBEErrorCode, type StackBEErrorResponse, type Subscription, type SubscriptionCancelledEvent, type SubscriptionCreatedEvent, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, type TrialStartedEvent, type UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };

package/dist/index.js

@@ -25,6 +25,8 @@ __export(index_exports, {
   CustomersClient: () => CustomersClient,
   EntitlementsClient: () => EntitlementsClient,
   OrganizationsClient: () => OrganizationsClient,
+  PlansClient: () => PlansClient,
+  ProductsClient: () => ProductsClient,
   StackBE: () => StackBE,
   StackBEError: () => StackBEError,
   SubscriptionsClient: () => SubscriptionsClient,
@@ -1333,6 +1335,109 @@ var OrganizationsClient = class {
   }
 };
 
+// src/plans.ts
+var PlansClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all plans for the app.
+   *
+   * @example
+   * ```typescript
+   * // List all plans
+   * const plans = await stackbe.plans.list();
+   *
+   * // Filter by product
+   * const plans = await stackbe.plans.list({ productId: 'prod_123' });
+   *
+   * // Display in pricing page
+   * plans.forEach(plan => {
+   *   console.log(`${plan.name}: $${plan.priceCents / 100}/${plan.interval}`);
+   * });
+   * ```
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.productId) {
+      params.set("productId", options.productId);
+    }
+    const query = params.toString();
+    return this.http.get(`/v1/plans${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get a plan by ID.
+   *
+   * @example
+   * ```typescript
+   * const plan = await stackbe.plans.get('plan_123');
+   * console.log(plan.name, plan.priceCents, plan.entitlements);
+   * ```
+   */
+  async get(planId) {
+    return this.http.get(`/v1/plans/${planId}`);
+  }
+  /**
+   * Get active plans only (excludes archived plans).
+   *
+   * @example
+   * ```typescript
+   * const activePlans = await stackbe.plans.getActive();
+   * ```
+   */
+  async getActive(options) {
+    const plans = await this.list(options);
+    return plans.filter((p) => p.status === "active");
+  }
+  /**
+   * Get plans sorted by price (ascending).
+   *
+   * @example
+   * ```typescript
+   * const plans = await stackbe.plans.listByPrice();
+   * // [Free, Starter, Pro, Enterprise]
+   * ```
+   */
+  async listByPrice(options) {
+    const plans = await this.getActive(options);
+    return plans.sort((a, b) => a.priceCents - b.priceCents);
+  }
+};
+var ProductsClient = class {
+  constructor(http, appId) {
+    this.http = http;
+    this.appId = appId;
+  }
+  /**
+   * List all products for the app.
+   *
+   * @example
+   * ```typescript
+   * const products = await stackbe.products.list();
+   * products.forEach(product => {
+   *   console.log(product.name, product.plans?.length, 'plans');
+   * });
+   * ```
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    params.set("appId", options?.appId ?? this.appId);
+    return this.http.get(`/v1/products?${params.toString()}`);
+  }
+  /**
+   * Get a product by ID.
+   *
+   * @example
+   * ```typescript
+   * const product = await stackbe.products.get('prod_123');
+   * console.log(product.name, product.description);
+   * ```
+   */
+  async get(productId) {
+    return this.http.get(`/v1/products/${productId}`);
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.stackbe.io";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1393,6 +1498,8 @@ var StackBE = class {
       devCallbackUrl: config.devCallbackUrl
     });
     this.organizations = new OrganizationsClient(this.http, config.appId);
+    this.plans = new PlansClient(this.http);
+    this.products = new ProductsClient(this.http, config.appId);
   }
   /**
    * Create a middleware for Express that tracks usage automatically.
@@ -1531,6 +1638,8 @@ var StackBE = class {
   CustomersClient,
   EntitlementsClient,
   OrganizationsClient,
+  PlansClient,
+  ProductsClient,
   StackBE,
   StackBEError,
   SubscriptionsClient,

package/dist/index.mjs

@@ -1299,6 +1299,109 @@ var OrganizationsClient = class {
   }
 };
 
+// src/plans.ts
+var PlansClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all plans for the app.
+   *
+   * @example
+   * ```typescript
+   * // List all plans
+   * const plans = await stackbe.plans.list();
+   *
+   * // Filter by product
+   * const plans = await stackbe.plans.list({ productId: 'prod_123' });
+   *
+   * // Display in pricing page
+   * plans.forEach(plan => {
+   *   console.log(`${plan.name}: $${plan.priceCents / 100}/${plan.interval}`);
+   * });
+   * ```
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.productId) {
+      params.set("productId", options.productId);
+    }
+    const query = params.toString();
+    return this.http.get(`/v1/plans${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get a plan by ID.
+   *
+   * @example
+   * ```typescript
+   * const plan = await stackbe.plans.get('plan_123');
+   * console.log(plan.name, plan.priceCents, plan.entitlements);
+   * ```
+   */
+  async get(planId) {
+    return this.http.get(`/v1/plans/${planId}`);
+  }
+  /**
+   * Get active plans only (excludes archived plans).
+   *
+   * @example
+   * ```typescript
+   * const activePlans = await stackbe.plans.getActive();
+   * ```
+   */
+  async getActive(options) {
+    const plans = await this.list(options);
+    return plans.filter((p) => p.status === "active");
+  }
+  /**
+   * Get plans sorted by price (ascending).
+   *
+   * @example
+   * ```typescript
+   * const plans = await stackbe.plans.listByPrice();
+   * // [Free, Starter, Pro, Enterprise]
+   * ```
+   */
+  async listByPrice(options) {
+    const plans = await this.getActive(options);
+    return plans.sort((a, b) => a.priceCents - b.priceCents);
+  }
+};
+var ProductsClient = class {
+  constructor(http, appId) {
+    this.http = http;
+    this.appId = appId;
+  }
+  /**
+   * List all products for the app.
+   *
+   * @example
+   * ```typescript
+   * const products = await stackbe.products.list();
+   * products.forEach(product => {
+   *   console.log(product.name, product.plans?.length, 'plans');
+   * });
+   * ```
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    params.set("appId", options?.appId ?? this.appId);
+    return this.http.get(`/v1/products?${params.toString()}`);
+  }
+  /**
+   * Get a product by ID.
+   *
+   * @example
+   * ```typescript
+   * const product = await stackbe.products.get('prod_123');
+   * console.log(product.name, product.description);
+   * ```
+   */
+  async get(productId) {
+    return this.http.get(`/v1/products/${productId}`);
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.stackbe.io";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1359,6 +1462,8 @@ var StackBE = class {
       devCallbackUrl: config.devCallbackUrl
     });
     this.organizations = new OrganizationsClient(this.http, config.appId);
+    this.plans = new PlansClient(this.http);
+    this.products = new ProductsClient(this.http, config.appId);
   }
   /**
    * Create a middleware for Express that tracks usage automatically.
@@ -1496,6 +1601,8 @@ export {
   CustomersClient,
   EntitlementsClient,
   OrganizationsClient,
+  PlansClient,
+  ProductsClient,
   StackBE,
   StackBEError,
   SubscriptionsClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackbe/sdk",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Official JavaScript/TypeScript SDK for StackBE - the billing backend for your side project",
   "main": "dist/index.js",
   "module": "dist/index.mjs",