@stackbe/sdk 0.12.0 → 0.13.0

package/README.md

@@ -174,6 +174,12 @@ await stackbe.auth.sendMagicLink('user@example.com', {
   useDev: true,
 });
 
+// Log user directly into a specific organization
+// Customer must already be a member of the org
+await stackbe.auth.sendMagicLink('user@example.com', {
+  organizationId: 'org_abc123',
+});
+
 // Verify magic link token (in your /verify route)
 const { token } = req.query;
 const result = await stackbe.auth.verifyToken(token);
@@ -198,6 +204,15 @@ if (session) {
 
 // Check if authenticated
 const isAuthenticated = await stackbe.auth.isAuthenticated(sessionToken);
+
+// Switch to a different organization (for multi-org users)
+const orgs = await stackbe.organizations.listByCustomer(customerId);
+if (orgs.length > 1) {
+  // User belongs to multiple orgs - show org picker
+  const { sessionToken: newToken, organizationId, orgRole } =
+    await stackbe.auth.switchOrganization(sessionToken, targetOrgId);
+  // Store newToken - it's scoped to the target org
+}
 ```
 
 ### Plans & Products

package/dist/index.d.mts

@@ -255,6 +255,12 @@ interface MagicLinkOptions {
     redirectUrl?: string;
     /** Use development callback URL (for localhost testing) */
     useDev?: boolean;
+    /**
+     * Organization ID to scope the session to after verification.
+     * Customer must already be a member of this organization.
+     * Use this to log existing members directly into a specific org.
+     */
+    organizationId?: string;
 }
 interface MagicLinkResponse {
     success: boolean;
@@ -278,6 +284,14 @@ interface VerifyTokenResponse {
     /** URL to redirect to after verification */
     redirectUrl?: string;
 }
+interface SwitchOrganizationResponse {
+    /** New session token scoped to the target organization */
+    sessionToken: string;
+    /** Organization ID the session is now scoped to */
+    organizationId: string;
+    /** Customer's role in the organization */
+    orgRole: 'owner' | 'admin' | 'member';
+}
 interface SessionResponse {
     valid: boolean;
     /** Customer ID */
@@ -1381,6 +1395,11 @@ declare class AuthClient {
      * await stackbe.auth.sendMagicLink('user@example.com', {
      *   useDev: true,
      * });
+     *
+     * // Log user directly into a specific organization
+     * await stackbe.auth.sendMagicLink('user@example.com', {
+     *   organizationId: 'org_abc123',
+     * });
      * ```
      */
     sendMagicLink(email: string, options?: MagicLinkOptions): Promise<MagicLinkResponse>;
@@ -1469,6 +1488,31 @@ declare class AuthClient {
      * ```
      */
     isAuthenticated(sessionToken: string): Promise<boolean>;
+    /**
+     * Switch the current session to a different organization.
+     * The customer must be a member of the target organization.
+     *
+     * Returns a new session token scoped to the target organization.
+     * The original session token remains valid but is scoped to the previous org (or no org).
+     *
+     * @example
+     * ```typescript
+     * // Get available organizations for the customer
+     * const orgs = await stackbe.organizations.listByCustomer(customerId);
+     *
+     * // Switch to a different organization
+     * const { sessionToken: newToken, organizationId, orgRole } =
+     *   await stackbe.auth.switchOrganization(currentSessionToken, targetOrgId);
+     *
+     * // Store the new token - it's scoped to the target org
+     * localStorage.setItem('sessionToken', newToken);
+     * ```
+     *
+     * @throws {StackBEError} with code 'NOT_MEMBER' if customer is not a member of the organization
+     * @throws {StackBEError} with code 'ORG_NOT_FOUND' if organization doesn't exist
+     * @throws {StackBEError} with code 'SESSION_INVALID' if session token is invalid
+     */
+    switchOrganization(sessionToken: string, organizationId: string): Promise<SwitchOrganizationResponse>;
 }
 
 declare class OrganizationsClient {
@@ -1534,15 +1578,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.
      *
@@ -2315,6 +2369,8 @@ interface CreateCouponOptions {
 interface UpdateCouponOptions {
     name?: string;
     maxRedemptions?: number;
+    /** Reset or adjust the redemption count */
+    timesRedeemed?: number;
     expiresAt?: string;
     validPlanIds?: string[];
     active?: boolean;
@@ -2727,4 +2783,4 @@ declare class StackBE {
     }): (req: any, res: any, next: any) => Promise<any>;
 }
 
-export { type AddMemberOptions, type AffiliateCommission, type AffiliateCommissionsResponse, type AffiliateEnrollment, type AffiliateInfo, type AffiliateStats, AffiliatesClient, AnalyticsClient, type AnalyticsFilterOptions, type AnyWebhookEvent, AuthClient, type BillingPortalSession, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type Coupon, type CouponDiscountType, type CouponDuration, CouponsClient, type CreateCheckoutOptions, type CreateCouponOptions, type CreateCustomerOptions, type CreateEarlyAccessSignupOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, type CustomerInvoice, type CustomerInvoicesResponse, type CustomerPaymentMethod, type CustomerSubscriptionHistory, type CustomerSubscriptionHistoryResponse, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, type DashboardMetrics, type DunningStatus, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestImage, type FeatureRequestListResponse, FeatureRequestsClient, type FeatureUsagePoint, type GetSubscriptionOptions, type GrowthChartPoint, type GrowthMetrics, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, type ListEarlyAccessOptions, type ListFeatureRequestsOptions, type ListPlansOptions, type ListProductsOptions, type MRRHistoryPoint, type MagicLinkOptions, type MagicLinkResponse, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentSucceededEvent, type PaymentWebhookPayload, type PerformanceMetrics, type Plan, type PlanMetrics, PlansClient, type PopularEndpoint, type Product, ProductsClient, type RequestCountPoint, type RevenueByPlan, type SessionResponse, StackBE, type StackBEConfig, StackBEError, type StackBEErrorCode, type StackBEErrorResponse, type Subscription, type SubscriptionCancelledEvent, type SubscriptionCreatedEvent, type SubscriptionPlan, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TimeRangeOptions, type TrackReferralResponse, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, type TrialMetrics, type TrialStartedEvent, type TrialStatus, type UpcomingInvoice, type UpdateCouponOptions, type UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type ValidateCouponResult, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };
+export { type AddMemberOptions, type AffiliateCommission, type AffiliateCommissionsResponse, type AffiliateEnrollment, type AffiliateInfo, type AffiliateStats, AffiliatesClient, AnalyticsClient, type AnalyticsFilterOptions, type AnyWebhookEvent, AuthClient, type BillingPortalSession, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type Coupon, type CouponDiscountType, type CouponDuration, CouponsClient, type CreateCheckoutOptions, type CreateCouponOptions, type CreateCustomerOptions, type CreateEarlyAccessSignupOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, type CustomerInvoice, type CustomerInvoicesResponse, type CustomerPaymentMethod, type CustomerSubscriptionHistory, type CustomerSubscriptionHistoryResponse, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, type DashboardMetrics, type DunningStatus, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestImage, type FeatureRequestListResponse, FeatureRequestsClient, type FeatureUsagePoint, type GetSubscriptionOptions, type GrowthChartPoint, type GrowthMetrics, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, type ListEarlyAccessOptions, type ListFeatureRequestsOptions, type ListPlansOptions, type ListProductsOptions, type MRRHistoryPoint, type MagicLinkOptions, type MagicLinkResponse, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentSucceededEvent, type PaymentWebhookPayload, type PerformanceMetrics, type Plan, type PlanMetrics, PlansClient, type PopularEndpoint, type Product, ProductsClient, type RequestCountPoint, type RevenueByPlan, type SessionResponse, StackBE, type StackBEConfig, StackBEError, type StackBEErrorCode, type StackBEErrorResponse, type Subscription, type SubscriptionCancelledEvent, type SubscriptionCreatedEvent, type SubscriptionPlan, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type SwitchOrganizationResponse, type TimeRangeOptions, type TrackReferralResponse, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, type TrialMetrics, type TrialStartedEvent, type TrialStatus, type UpcomingInvoice, type UpdateCouponOptions, type UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type ValidateCouponResult, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };

package/dist/index.d.ts

@@ -255,6 +255,12 @@ interface MagicLinkOptions {
     redirectUrl?: string;
     /** Use development callback URL (for localhost testing) */
     useDev?: boolean;
+    /**
+     * Organization ID to scope the session to after verification.
+     * Customer must already be a member of this organization.
+     * Use this to log existing members directly into a specific org.
+     */
+    organizationId?: string;
 }
 interface MagicLinkResponse {
     success: boolean;
@@ -278,6 +284,14 @@ interface VerifyTokenResponse {
     /** URL to redirect to after verification */
     redirectUrl?: string;
 }
+interface SwitchOrganizationResponse {
+    /** New session token scoped to the target organization */
+    sessionToken: string;
+    /** Organization ID the session is now scoped to */
+    organizationId: string;
+    /** Customer's role in the organization */
+    orgRole: 'owner' | 'admin' | 'member';
+}
 interface SessionResponse {
     valid: boolean;
     /** Customer ID */
@@ -1381,6 +1395,11 @@ declare class AuthClient {
      * await stackbe.auth.sendMagicLink('user@example.com', {
      *   useDev: true,
      * });
+     *
+     * // Log user directly into a specific organization
+     * await stackbe.auth.sendMagicLink('user@example.com', {
+     *   organizationId: 'org_abc123',
+     * });
      * ```
      */
     sendMagicLink(email: string, options?: MagicLinkOptions): Promise<MagicLinkResponse>;
@@ -1469,6 +1488,31 @@ declare class AuthClient {
      * ```
      */
     isAuthenticated(sessionToken: string): Promise<boolean>;
+    /**
+     * Switch the current session to a different organization.
+     * The customer must be a member of the target organization.
+     *
+     * Returns a new session token scoped to the target organization.
+     * The original session token remains valid but is scoped to the previous org (or no org).
+     *
+     * @example
+     * ```typescript
+     * // Get available organizations for the customer
+     * const orgs = await stackbe.organizations.listByCustomer(customerId);
+     *
+     * // Switch to a different organization
+     * const { sessionToken: newToken, organizationId, orgRole } =
+     *   await stackbe.auth.switchOrganization(currentSessionToken, targetOrgId);
+     *
+     * // Store the new token - it's scoped to the target org
+     * localStorage.setItem('sessionToken', newToken);
+     * ```
+     *
+     * @throws {StackBEError} with code 'NOT_MEMBER' if customer is not a member of the organization
+     * @throws {StackBEError} with code 'ORG_NOT_FOUND' if organization doesn't exist
+     * @throws {StackBEError} with code 'SESSION_INVALID' if session token is invalid
+     */
+    switchOrganization(sessionToken: string, organizationId: string): Promise<SwitchOrganizationResponse>;
 }
 
 declare class OrganizationsClient {
@@ -1534,15 +1578,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.
      *
@@ -2315,6 +2369,8 @@ interface CreateCouponOptions {
 interface UpdateCouponOptions {
     name?: string;
     maxRedemptions?: number;
+    /** Reset or adjust the redemption count */
+    timesRedeemed?: number;
     expiresAt?: string;
     validPlanIds?: string[];
     active?: boolean;
@@ -2727,4 +2783,4 @@ declare class StackBE {
     }): (req: any, res: any, next: any) => Promise<any>;
 }
 
-export { type AddMemberOptions, type AffiliateCommission, type AffiliateCommissionsResponse, type AffiliateEnrollment, type AffiliateInfo, type AffiliateStats, AffiliatesClient, AnalyticsClient, type AnalyticsFilterOptions, type AnyWebhookEvent, AuthClient, type BillingPortalSession, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type Coupon, type CouponDiscountType, type CouponDuration, CouponsClient, type CreateCheckoutOptions, type CreateCouponOptions, type CreateCustomerOptions, type CreateEarlyAccessSignupOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, type CustomerInvoice, type CustomerInvoicesResponse, type CustomerPaymentMethod, type CustomerSubscriptionHistory, type CustomerSubscriptionHistoryResponse, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, type DashboardMetrics, type DunningStatus, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestImage, type FeatureRequestListResponse, FeatureRequestsClient, type FeatureUsagePoint, type GetSubscriptionOptions, type GrowthChartPoint, type GrowthMetrics, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, type ListEarlyAccessOptions, type ListFeatureRequestsOptions, type ListPlansOptions, type ListProductsOptions, type MRRHistoryPoint, type MagicLinkOptions, type MagicLinkResponse, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentSucceededEvent, type PaymentWebhookPayload, type PerformanceMetrics, type Plan, type PlanMetrics, PlansClient, type PopularEndpoint, type Product, ProductsClient, type RequestCountPoint, type RevenueByPlan, type SessionResponse, StackBE, type StackBEConfig, StackBEError, type StackBEErrorCode, type StackBEErrorResponse, type Subscription, type SubscriptionCancelledEvent, type SubscriptionCreatedEvent, type SubscriptionPlan, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TimeRangeOptions, type TrackReferralResponse, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, type TrialMetrics, type TrialStartedEvent, type TrialStatus, type UpcomingInvoice, type UpdateCouponOptions, type UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type ValidateCouponResult, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };
+export { type AddMemberOptions, type AffiliateCommission, type AffiliateCommissionsResponse, type AffiliateEnrollment, type AffiliateInfo, type AffiliateStats, AffiliatesClient, AnalyticsClient, type AnalyticsFilterOptions, type AnyWebhookEvent, AuthClient, type BillingPortalSession, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type Coupon, type CouponDiscountType, type CouponDuration, CouponsClient, type CreateCheckoutOptions, type CreateCouponOptions, type CreateCustomerOptions, type CreateEarlyAccessSignupOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, type CustomerInvoice, type CustomerInvoicesResponse, type CustomerPaymentMethod, type CustomerSubscriptionHistory, type CustomerSubscriptionHistoryResponse, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, type DashboardMetrics, type DunningStatus, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestImage, type FeatureRequestListResponse, FeatureRequestsClient, type FeatureUsagePoint, type GetSubscriptionOptions, type GrowthChartPoint, type GrowthMetrics, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, type ListEarlyAccessOptions, type ListFeatureRequestsOptions, type ListPlansOptions, type ListProductsOptions, type MRRHistoryPoint, type MagicLinkOptions, type MagicLinkResponse, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentSucceededEvent, type PaymentWebhookPayload, type PerformanceMetrics, type Plan, type PlanMetrics, PlansClient, type PopularEndpoint, type Product, ProductsClient, type RequestCountPoint, type RevenueByPlan, type SessionResponse, StackBE, type StackBEConfig, StackBEError, type StackBEErrorCode, type StackBEErrorResponse, type Subscription, type SubscriptionCancelledEvent, type SubscriptionCreatedEvent, type SubscriptionPlan, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type SwitchOrganizationResponse, type TimeRangeOptions, type TrackReferralResponse, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, type TrialMetrics, type TrialStartedEvent, type TrialStatus, type UpcomingInvoice, type UpdateCouponOptions, type UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type ValidateCouponResult, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };

package/dist/index.js

@@ -1230,6 +1230,11 @@ var AuthClient = class {
    * await stackbe.auth.sendMagicLink('user@example.com', {
    *   useDev: true,
    * });
+   *
+   * // Log user directly into a specific organization
+   * await stackbe.auth.sendMagicLink('user@example.com', {
+   *   organizationId: 'org_abc123',
+   * });
    * ```
    */
   async sendMagicLink(email, options = {}) {
@@ -1245,7 +1250,8 @@ var AuthClient = class {
       {
         email,
         redirectUrl,
-        useDev
+        useDev,
+        organizationId: options.organizationId
       }
     );
   }
@@ -1460,6 +1466,59 @@ var AuthClient = class {
     const session = await this.getSession(sessionToken);
     return session !== null;
   }
+  /**
+   * Switch the current session to a different organization.
+   * The customer must be a member of the target organization.
+   *
+   * Returns a new session token scoped to the target organization.
+   * The original session token remains valid but is scoped to the previous org (or no org).
+   *
+   * @example
+   * ```typescript
+   * // Get available organizations for the customer
+   * const orgs = await stackbe.organizations.listByCustomer(customerId);
+   *
+   * // Switch to a different organization
+   * const { sessionToken: newToken, organizationId, orgRole } =
+   *   await stackbe.auth.switchOrganization(currentSessionToken, targetOrgId);
+   *
+   * // Store the new token - it's scoped to the target org
+   * localStorage.setItem('sessionToken', newToken);
+   * ```
+   *
+   * @throws {StackBEError} with code 'NOT_MEMBER' if customer is not a member of the organization
+   * @throws {StackBEError} with code 'ORG_NOT_FOUND' if organization doesn't exist
+   * @throws {StackBEError} with code 'SESSION_INVALID' if session token is invalid
+   */
+  async switchOrganization(sessionToken, organizationId) {
+    this.sessionCache.delete(sessionToken);
+    const response = await fetch(
+      `${this.http.baseUrl}/v1/apps/${this.appId}/auth/switch-organization`,
+      {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${sessionToken}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ organizationId })
+      }
+    );
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}));
+      const message = errorData.message || errorData.error || "Failed to switch organization";
+      let code = "SWITCH_ORG_FAILED";
+      if (response.status === 401) {
+        code = "SESSION_INVALID";
+      } else if (message.toLowerCase().includes("not a member")) {
+        code = "NOT_MEMBER";
+      } else if (message.toLowerCase().includes("not found")) {
+        code = "ORG_NOT_FOUND";
+      }
+      throw new StackBEError(message, response.status, code);
+    }
+    const data = await response.json();
+    return data;
+  }
 };
 
 // src/organizations.ts
@@ -1549,17 +1608,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

@@ -1189,6 +1189,11 @@ var AuthClient = class {
    * await stackbe.auth.sendMagicLink('user@example.com', {
    *   useDev: true,
    * });
+   *
+   * // Log user directly into a specific organization
+   * await stackbe.auth.sendMagicLink('user@example.com', {
+   *   organizationId: 'org_abc123',
+   * });
    * ```
    */
   async sendMagicLink(email, options = {}) {
@@ -1204,7 +1209,8 @@ var AuthClient = class {
       {
         email,
         redirectUrl,
-        useDev
+        useDev,
+        organizationId: options.organizationId
       }
     );
   }
@@ -1419,6 +1425,59 @@ var AuthClient = class {
     const session = await this.getSession(sessionToken);
     return session !== null;
   }
+  /**
+   * Switch the current session to a different organization.
+   * The customer must be a member of the target organization.
+   *
+   * Returns a new session token scoped to the target organization.
+   * The original session token remains valid but is scoped to the previous org (or no org).
+   *
+   * @example
+   * ```typescript
+   * // Get available organizations for the customer
+   * const orgs = await stackbe.organizations.listByCustomer(customerId);
+   *
+   * // Switch to a different organization
+   * const { sessionToken: newToken, organizationId, orgRole } =
+   *   await stackbe.auth.switchOrganization(currentSessionToken, targetOrgId);
+   *
+   * // Store the new token - it's scoped to the target org
+   * localStorage.setItem('sessionToken', newToken);
+   * ```
+   *
+   * @throws {StackBEError} with code 'NOT_MEMBER' if customer is not a member of the organization
+   * @throws {StackBEError} with code 'ORG_NOT_FOUND' if organization doesn't exist
+   * @throws {StackBEError} with code 'SESSION_INVALID' if session token is invalid
+   */
+  async switchOrganization(sessionToken, organizationId) {
+    this.sessionCache.delete(sessionToken);
+    const response = await fetch(
+      `${this.http.baseUrl}/v1/apps/${this.appId}/auth/switch-organization`,
+      {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${sessionToken}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ organizationId })
+      }
+    );
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}));
+      const message = errorData.message || errorData.error || "Failed to switch organization";
+      let code = "SWITCH_ORG_FAILED";
+      if (response.status === 401) {
+        code = "SESSION_INVALID";
+      } else if (message.toLowerCase().includes("not a member")) {
+        code = "NOT_MEMBER";
+      } else if (message.toLowerCase().includes("not found")) {
+        code = "ORG_NOT_FOUND";
+      }
+      throw new StackBEError(message, response.status, code);
+    }
+    const data = await response.json();
+    return data;
+  }
 };
 
 // src/organizations.ts
@@ -1508,17 +1567,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.12.0",
+  "version": "0.13.0",
   "description": "Official JavaScript/TypeScript SDK for StackBE - the billing backend for your side project",
   "main": "dist/index.js",
   "module": "dist/index.mjs",