@stackbe/sdk 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+All notable changes to the StackBE SDK will be documented in this file.
+
+## [0.11.1] - 2026-01-09
+
+### Changed
+- CHANGELOG.md now included in npm package for better visibility of changes
+
+## [0.11.0] - 2026-01-09
+
+### Backend Compatibility
+All SDK methods now have full API backend support:
+
+- **`checkout.getSession()`** - Retrieve checkout session status by ID
+- **`subscriptions.update()`** - Change subscription plans with proration support
+- **`entitlements.check()`** - Check customer access to specific features
+- **`entitlements.getAll()`** - Get all entitlements for a customer
+- **`customers.update()`** - Update customer name and metadata
+
+### API Endpoints Added
+- `GET /v1/checkout/session/:sessionId` - Get checkout session details
+- `PATCH /v1/subscriptions/:id` - Update subscription (plan changes)
+- `GET /v1/customers/:customerId/entitlements` - List customer entitlements
+- `GET /v1/customers/:customerId/entitlements/check` - Check feature access
+- `PATCH /v1/customers/:id` - Update customer properties
+
+## [0.10.0] - 2025-01-08
+
+### Added
+- Initial public release
+- Full TypeScript support
+- 88 SDK methods covering:
+  - Authentication (magic links)
+  - Checkout sessions
+  - Subscriptions (CRUD, pause/resume, trials, dunning)
+  - Entitlements
+  - Usage tracking
+  - Analytics
+  - Customers
+  - Organizations
+  - Affiliates
+  - Coupons
+  - Feature requests
+  - Early access
+
+## [0.9.0] - 2024-12-30
+
+### Added
+- Affiliate system endpoints
+- Organization management
+- Analytics dashboard methods
+
+## [0.8.0] - 2024-12-20
+
+### Added
+- Dunning/payment recovery methods
+- Trial management (extend, end)
+- Grace period support
+
+## [0.7.0] - 2024-12-15
+
+### Added
+- Subscription pause/resume
+- Billing history endpoints
+- Invoice retrieval

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.
      *

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.
      *

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.
    *

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.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackbe/sdk",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Official JavaScript/TypeScript SDK for StackBE - the billing backend for your side project",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -13,7 +13,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",