@stackbe/sdk 0.11.1 → 0.12.1

package/README.md

@@ -298,6 +298,9 @@ const org = await stackbe.organizations.create({
 // List all organizations
 const orgs = await stackbe.organizations.list();
 
+// List organizations for a specific customer (for org switchers)
+const customerOrgs = await stackbe.organizations.listByCustomer('cust_123');
+
 // Get organization by ID
 const org = await stackbe.organizations.get('org_123');
 

package/dist/index.d.mts

@@ -1502,6 +1502,17 @@ declare class OrganizationsClient {
         offset?: number;
         search?: string;
     }): Promise<Organization[]>;
+    /**
+     * List organizations where a specific customer is a member.
+     * Useful for building org switchers or checking what orgs a user belongs to.
+     *
+     * @example
+     * ```typescript
+     * const orgs = await stackbe.organizations.listByCustomer('cust_123');
+     * orgs.forEach(org => console.log(`${org.name} - ${org.members.find(m => m.customerId === 'cust_123')?.role}`));
+     * ```
+     */
+    listByCustomer(customerId: string): Promise<Organization[]>;
     /**
      * Get an organization by ID.
      *
@@ -1523,15 +1534,25 @@ declare class OrganizationsClient {
      */
     update(orgId: string, options: UpdateOrganizationOptions): Promise<Organization>;
     /**
-     * Delete an organization.
-     * Note: Organizations with active subscriptions cannot be deleted.
+     * Delete an organization (soft-delete).
+     * By default, fails if org has active subscriptions.
+     * Pass cancelSubscriptions: true to auto-cancel them first.
      *
      * @example
      * ```typescript
+     * // Basic delete (fails if active subscriptions)
      * await stackbe.organizations.delete('org_123');
+     *
+     * // Force delete with subscription cancellation
+     * await stackbe.organizations.delete('org_123', { cancelSubscriptions: true });
      * ```
      */
-    delete(orgId: string): Promise<void>;
+    delete(orgId: string, options?: {
+        cancelSubscriptions?: boolean;
+    }): Promise<{
+        success: boolean;
+        cancelledSubscriptions: number;
+    }>;
     /**
      * Add a customer as a member of an organization.
      *

package/dist/index.d.ts

@@ -1502,6 +1502,17 @@ declare class OrganizationsClient {
         offset?: number;
         search?: string;
     }): Promise<Organization[]>;
+    /**
+     * List organizations where a specific customer is a member.
+     * Useful for building org switchers or checking what orgs a user belongs to.
+     *
+     * @example
+     * ```typescript
+     * const orgs = await stackbe.organizations.listByCustomer('cust_123');
+     * orgs.forEach(org => console.log(`${org.name} - ${org.members.find(m => m.customerId === 'cust_123')?.role}`));
+     * ```
+     */
+    listByCustomer(customerId: string): Promise<Organization[]>;
     /**
      * Get an organization by ID.
      *
@@ -1523,15 +1534,25 @@ declare class OrganizationsClient {
      */
     update(orgId: string, options: UpdateOrganizationOptions): Promise<Organization>;
     /**
-     * Delete an organization.
-     * Note: Organizations with active subscriptions cannot be deleted.
+     * Delete an organization (soft-delete).
+     * By default, fails if org has active subscriptions.
+     * Pass cancelSubscriptions: true to auto-cancel them first.
      *
      * @example
      * ```typescript
+     * // Basic delete (fails if active subscriptions)
      * await stackbe.organizations.delete('org_123');
+     *
+     * // Force delete with subscription cancellation
+     * await stackbe.organizations.delete('org_123', { cancelSubscriptions: true });
      * ```
      */
-    delete(orgId: string): Promise<void>;
+    delete(orgId: string, options?: {
+        cancelSubscriptions?: boolean;
+    }): Promise<{
+        success: boolean;
+        cancelledSubscriptions: number;
+    }>;
     /**
      * Add a customer as a member of an organization.
      *

package/dist/index.js

@@ -1504,6 +1504,21 @@ var OrganizationsClient = class {
     const path = `/v1/apps/${this.appId}/admin/organizations${query ? `?${query}` : ""}`;
     return this.http.get(path);
   }
+  /**
+   * List organizations where a specific customer is a member.
+   * Useful for building org switchers or checking what orgs a user belongs to.
+   *
+   * @example
+   * ```typescript
+   * const orgs = await stackbe.organizations.listByCustomer('cust_123');
+   * orgs.forEach(org => console.log(`${org.name} - ${org.members.find(m => m.customerId === 'cust_123')?.role}`));
+   * ```
+   */
+  async listByCustomer(customerId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/admin/organizations/by-customer/${customerId}`
+    );
+  }
   /**
    * Get an organization by ID.
    *
@@ -1534,17 +1549,23 @@ var OrganizationsClient = class {
     );
   }
   /**
-   * Delete an organization.
-   * Note: Organizations with active subscriptions cannot be deleted.
+   * Delete an organization (soft-delete).
+   * By default, fails if org has active subscriptions.
+   * Pass cancelSubscriptions: true to auto-cancel them first.
    *
    * @example
    * ```typescript
+   * // Basic delete (fails if active subscriptions)
    * await stackbe.organizations.delete('org_123');
+   *
+   * // Force delete with subscription cancellation
+   * await stackbe.organizations.delete('org_123', { cancelSubscriptions: true });
    * ```
    */
-  async delete(orgId) {
+  async delete(orgId, options) {
+    const query = options?.cancelSubscriptions ? "?cancelSubscriptions=true" : "";
     return this.http.delete(
-      `/v1/apps/${this.appId}/admin/organizations/${orgId}`
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}${query}`
     );
   }
   /**

package/dist/index.mjs

@@ -1463,6 +1463,21 @@ var OrganizationsClient = class {
     const path = `/v1/apps/${this.appId}/admin/organizations${query ? `?${query}` : ""}`;
     return this.http.get(path);
   }
+  /**
+   * List organizations where a specific customer is a member.
+   * Useful for building org switchers or checking what orgs a user belongs to.
+   *
+   * @example
+   * ```typescript
+   * const orgs = await stackbe.organizations.listByCustomer('cust_123');
+   * orgs.forEach(org => console.log(`${org.name} - ${org.members.find(m => m.customerId === 'cust_123')?.role}`));
+   * ```
+   */
+  async listByCustomer(customerId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/admin/organizations/by-customer/${customerId}`
+    );
+  }
   /**
    * Get an organization by ID.
    *
@@ -1493,17 +1508,23 @@ var OrganizationsClient = class {
     );
   }
   /**
-   * Delete an organization.
-   * Note: Organizations with active subscriptions cannot be deleted.
+   * Delete an organization (soft-delete).
+   * By default, fails if org has active subscriptions.
+   * Pass cancelSubscriptions: true to auto-cancel them first.
    *
    * @example
    * ```typescript
+   * // Basic delete (fails if active subscriptions)
    * await stackbe.organizations.delete('org_123');
+   *
+   * // Force delete with subscription cancellation
+   * await stackbe.organizations.delete('org_123', { cancelSubscriptions: true });
    * ```
    */
-  async delete(orgId) {
+  async delete(orgId, options) {
+    const query = options?.cancelSubscriptions ? "?cancelSubscriptions=true" : "";
     return this.http.delete(
-      `/v1/apps/${this.appId}/admin/organizations/${orgId}`
+      `/v1/apps/${this.appId}/admin/organizations/${orgId}${query}`
     );
   }
   /**

package/package.json

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