@stackbe/sdk 0.6.3 → 0.6.5

package/dist/index.d.ts

@@ -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 };

package/dist/index.js

@@ -24,6 +24,9 @@ __export(index_exports, {
   CheckoutClient: () => CheckoutClient,
   CustomersClient: () => CustomersClient,
   EntitlementsClient: () => EntitlementsClient,
+  OrganizationsClient: () => OrganizationsClient,
+  PlansClient: () => PlansClient,
+  ProductsClient: () => ProductsClient,
   StackBE: () => StackBE,
   StackBEError: () => StackBEError,
   SubscriptionsClient: () => SubscriptionsClient,
@@ -1156,6 +1159,285 @@ var AuthClient = class {
   }
 };
 
+// src/organizations.ts
+var OrganizationsClient = class {
+  constructor(http, appId) {
+    this.http = http;
+    this.appId = appId;
+  }
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async create(options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/admin/organizations`,
+      options
+    );
+  }
+  /**
+   * List all organizations for this app.
+   *
+   * @example
+   * ```typescript
+   * const orgs = await stackbe.organizations.list();
+   * ```
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    if (options?.search) params.set("search", options.search);
+    const query = params.toString();
+    const path = `/v1/apps/${this.appId}/admin/organizations${query ? `?${query}` : ""}`;
+    return this.http.get(path);
+  }
+  /**
+   * Get an organization by ID.
+   *
+   * @example
+   * ```typescript
+   * const org = await stackbe.organizations.get('org_123');
+   * ```
+   */
+  async get(orgId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}`
+    );
+  }
+  /**
+   * Update an organization.
+   *
+   * @example
+   * ```typescript
+   * const org = await stackbe.organizations.update('org_123', {
+   *   name: 'New Name'
+   * });
+   * ```
+   */
+  async update(orgId, options) {
+    return this.http.patch(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}`,
+      options
+    );
+  }
+  /**
+   * Delete an organization.
+   * Note: Organizations with active subscriptions cannot be deleted.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.organizations.delete('org_123');
+   * ```
+   */
+  async delete(orgId) {
+    return this.http.delete(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}`
+    );
+  }
+  /**
+   * Add a customer as a member of an organization.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.organizations.addMember('org_123', {
+   *   customerId: 'cust_456',
+   *   role: 'member'
+   * });
+   * ```
+   */
+  async addMember(orgId, options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}/members`,
+      options
+    );
+  }
+  /**
+   * Remove a member from an organization.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.organizations.removeMember('org_123', 'member_456');
+   * ```
+   */
+  async removeMember(orgId, memberId) {
+    return this.http.delete(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}/members/${memberId}`
+    );
+  }
+  /**
+   * Update a member's role.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.organizations.updateMember('org_123', 'member_456', {
+   *   role: 'admin'
+   * });
+   * ```
+   */
+  async updateMember(orgId, memberId, options) {
+    return this.http.patch(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}/members/${memberId}`,
+      options
+    );
+  }
+  /**
+   * Send an invite to join an organization.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.organizations.invite('org_123', {
+   *   email: 'newuser@company.com',
+   *   role: 'member'
+   * });
+   * ```
+   */
+  async invite(orgId, options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}/invites`,
+      options
+    );
+  }
+  /**
+   * List pending invites for an organization.
+   *
+   * @example
+   * ```typescript
+   * const invites = await stackbe.organizations.listInvites('org_123');
+   * ```
+   */
+  async listInvites(orgId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}/invites`
+    );
+  }
+  /**
+   * Cancel a pending invite.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.organizations.cancelInvite('org_123', 'invite_456');
+   * ```
+   */
+  async cancelInvite(orgId, inviteId) {
+    return this.http.delete(
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}/invites/${inviteId}`
+    );
+  }
+};
+
+// 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;
@@ -1215,6 +1497,9 @@ var StackBE = class {
       sessionCacheTTL: config.sessionCacheTTL,
       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.
@@ -1352,6 +1637,9 @@ var StackBE = class {
   CheckoutClient,
   CustomersClient,
   EntitlementsClient,
+  OrganizationsClient,
+  PlansClient,
+  ProductsClient,
   StackBE,
   StackBEError,
   SubscriptionsClient,