@stackbe/sdk 0.6.3 → 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

@@ -251,6 +251,94 @@ interface SessionResponse {
     /** Feature entitlements */
     entitlements?: Record<string, boolean | number | string>;
 }
+interface OrganizationMember {
+    id: string;
+    customerId: string;
+    email: string;
+    role: 'owner' | 'admin' | 'member';
+    invitedAt: string;
+    acceptedAt?: string;
+}
+interface Organization {
+    id: string;
+    appId: string;
+    name: string;
+    slug: string;
+    logoUrl?: string;
+    members: OrganizationMember[];
+    memberCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateOrganizationOptions {
+    /** Organization name */
+    name: string;
+    /** Customer ID to set as owner */
+    ownerId: string;
+    /** Optional logo URL */
+    logoUrl?: string;
+}
+interface UpdateOrganizationOptions {
+    /** New organization name */
+    name?: string;
+    /** New logo URL */
+    logoUrl?: string;
+}
+interface AddMemberOptions {
+    /** Customer ID to add */
+    customerId: string;
+    /** Role for the member */
+    role?: 'admin' | 'member';
+}
+interface InviteMemberOptions {
+    /** Email to invite */
+    email: string;
+    /** Role for the invited member */
+    role?: 'admin' | 'member';
+}
+interface OrganizationInvite {
+    id: string;
+    organizationId: string;
+    email: string;
+    role: 'admin' | 'member';
+    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 | {
@@ -1050,6 +1138,243 @@ declare class AuthClient {
     isAuthenticated(sessionToken: string): Promise<boolean>;
 }
 
+declare class OrganizationsClient {
+    private http;
+    private appId;
+    constructor(http: HttpClient, appId: string);
+    /**
+     * Create a new organization with a customer as owner.
+     * Use this for B2B signup flows where you provision everything server-side.
+     *
+     * @example
+     * ```typescript
+     * const customer = await stackbe.customers.getOrCreate({ email: 'user@company.com' });
+     * const org = await stackbe.organizations.create({
+     *   name: 'Acme Corp',
+     *   ownerId: customer.id
+     * });
+     * ```
+     */
+    create(options: CreateOrganizationOptions): Promise<Organization>;
+    /**
+     * List all organizations for this app.
+     *
+     * @example
+     * ```typescript
+     * const orgs = await stackbe.organizations.list();
+     * ```
+     */
+    list(options?: {
+        limit?: number;
+        offset?: number;
+        search?: string;
+    }): Promise<Organization[]>;
+    /**
+     * Get an organization by ID.
+     *
+     * @example
+     * ```typescript
+     * const org = await stackbe.organizations.get('org_123');
+     * ```
+     */
+    get(orgId: string): Promise<Organization>;
+    /**
+     * Update an organization.
+     *
+     * @example
+     * ```typescript
+     * const org = await stackbe.organizations.update('org_123', {
+     *   name: 'New Name'
+     * });
+     * ```
+     */
+    update(orgId: string, options: UpdateOrganizationOptions): Promise<Organization>;
+    /**
+     * Delete an organization.
+     * Note: Organizations with active subscriptions cannot be deleted.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.organizations.delete('org_123');
+     * ```
+     */
+    delete(orgId: string): Promise<void>;
+    /**
+     * Add a customer as a member of an organization.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.organizations.addMember('org_123', {
+     *   customerId: 'cust_456',
+     *   role: 'member'
+     * });
+     * ```
+     */
+    addMember(orgId: string, options: AddMemberOptions): Promise<OrganizationMember>;
+    /**
+     * Remove a member from an organization.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.organizations.removeMember('org_123', 'member_456');
+     * ```
+     */
+    removeMember(orgId: string, memberId: string): Promise<void>;
+    /**
+     * Update a member's role.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.organizations.updateMember('org_123', 'member_456', {
+     *   role: 'admin'
+     * });
+     * ```
+     */
+    updateMember(orgId: string, memberId: string, options: {
+        role: 'admin' | 'member';
+    }): Promise<OrganizationMember>;
+    /**
+     * Send an invite to join an organization.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.organizations.invite('org_123', {
+     *   email: 'newuser@company.com',
+     *   role: 'member'
+     * });
+     * ```
+     */
+    invite(orgId: string, options: InviteMemberOptions): Promise<OrganizationInvite>;
+    /**
+     * List pending invites for an organization.
+     *
+     * @example
+     * ```typescript
+     * const invites = await stackbe.organizations.listInvites('org_123');
+     * ```
+     */
+    listInvites(orgId: string): Promise<OrganizationInvite[]>;
+    /**
+     * Cancel a pending invite.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.organizations.cancelInvite('org_123', 'invite_456');
+     * ```
+     */
+    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;
@@ -1065,6 +1390,12 @@ declare class StackBE {
     readonly subscriptions: SubscriptionsClient;
     /** Customer authentication (magic links) */
     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.
      *
@@ -1165,4 +1496,4 @@ declare class StackBE {
     }): (req: any, res: any, next: any) => Promise<any>;
 }
 
-export { type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type Customer, type CustomerCreatedEvent, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type MagicLinkOptions, type MagicLinkResponse, 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 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 };