@stackbe/sdk 0.9.4 → 0.9.5

package/dist/index.d.mts

@@ -194,6 +194,12 @@ interface Subscription {
     pausedAt?: string | null;
     /** When the subscription will auto-resume (null = indefinite pause) */
     resumesAt?: string | null;
+    /** Number of consecutive failed payment attempts */
+    failedPaymentCount?: number;
+    /** Timestamp of most recent failed payment */
+    lastPaymentFailedAt?: string | null;
+    /** When access will be revoked if payment not recovered */
+    gracePeriodEndsAt?: string | null;
     createdAt: string;
 }
 interface TrialStatus {
@@ -210,6 +216,28 @@ interface TrialStatus {
     /** Whether the trial has converted to paid */
     hasConverted: boolean;
 }
+interface DunningStatus {
+    /** Whether the subscription is past due */
+    isPastDue: boolean;
+    /** Whether the subscription is in grace period (past due but still has access) */
+    isInGracePeriod: boolean;
+    /** Number of consecutive failed payment attempts */
+    failedPaymentCount: number;
+    /** Timestamp of most recent failed payment */
+    lastPaymentFailedAt: string | null;
+    /** When access will be revoked if payment not recovered */
+    gracePeriodEndsAt: string | null;
+    /** Days until access is revoked (null if not in grace period) */
+    daysUntilAccessRevoked: number | null;
+    /** Days since payment failed */
+    daysSinceFailure: number | null;
+    /** Configured dunning email schedule (days after failure) */
+    dunningEmailSchedule: number[];
+    /** Which dunning emails have been sent (days) */
+    emailsSent: number[];
+    /** Whether the customer still has access (considering grace period) */
+    hasAccess: boolean;
+}
 interface CustomerWithSubscription extends Customer {
     subscription?: Subscription;
 }
@@ -1240,6 +1268,72 @@ declare class SubscriptionsClient {
      * ```
      */
     endTrial(subscriptionId: string): Promise<Subscription>;
+    /**
+     * Get dunning/payment recovery status for a subscription.
+     *
+     * Shows if the subscription is past due, in grace period, and when access
+     * will be revoked if payment isn't recovered.
+     *
+     * @example
+     * ```typescript
+     * const dunning = await stackbe.subscriptions.getDunningStatus('sub_123');
+     *
+     * if (dunning.isPastDue) {
+     *   console.log(`Payment failed ${dunning.daysSinceFailure} days ago`);
+     *
+     *   if (dunning.isInGracePeriod) {
+     *     console.log(`Access ends in ${dunning.daysUntilAccessRevoked} days`);
+     *   }
+     * }
+     *
+     * // Check if customer still has access
+     * if (dunning.hasAccess) {
+     *   // Allow access
+     * }
+     * ```
+     */
+    getDunningStatus(subscriptionId: string): Promise<DunningStatus>;
+    /**
+     * List all past-due subscriptions.
+     *
+     * Useful for monitoring and recovery efforts.
+     *
+     * @example
+     * ```typescript
+     * // List all past-due subscriptions
+     * const pastDue = await stackbe.subscriptions.listPastDue();
+     *
+     * // List subscriptions losing access within 3 days
+     * const urgent = await stackbe.subscriptions.listPastDue({ gracePeriodExpiringSoon: 3 });
+     *
+     * for (const sub of urgent) {
+     *   console.log(`${sub.customer.email} loses access in ${sub.gracePeriodEndsAt}`);
+     * }
+     * ```
+     */
+    listPastDue(options?: {
+        appId?: string;
+        gracePeriodExpiringSoon?: number;
+    }): Promise<Subscription[]>;
+    /**
+     * Check if a subscription still has access (considering grace period).
+     *
+     * Returns true if:
+     * - Subscription is active
+     * - Subscription is trialing
+     * - Subscription is past_due but within grace period
+     *
+     * @example
+     * ```typescript
+     * const { hasAccess } = await stackbe.subscriptions.checkAccess('sub_123');
+     * if (!hasAccess) {
+     *   // Show upgrade prompt or block feature
+     * }
+     * ```
+     */
+    checkAccess(subscriptionId: string): Promise<{
+        hasAccess: boolean;
+    }>;
 }
 
 interface AuthClientOptions {
@@ -2431,4 +2525,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, 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, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestImage, type FeatureRequestListResponse, FeatureRequestsClient, type GetSubscriptionOptions, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, type ListEarlyAccessOptions, type ListFeatureRequestsOptions, 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 SubscriptionPlan, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TrackReferralResponse, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, 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, 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 DunningStatus, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestImage, type FeatureRequestListResponse, FeatureRequestsClient, type GetSubscriptionOptions, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, type ListEarlyAccessOptions, type ListFeatureRequestsOptions, 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 SubscriptionPlan, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TrackReferralResponse, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, 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

@@ -194,6 +194,12 @@ interface Subscription {
     pausedAt?: string | null;
     /** When the subscription will auto-resume (null = indefinite pause) */
     resumesAt?: string | null;
+    /** Number of consecutive failed payment attempts */
+    failedPaymentCount?: number;
+    /** Timestamp of most recent failed payment */
+    lastPaymentFailedAt?: string | null;
+    /** When access will be revoked if payment not recovered */
+    gracePeriodEndsAt?: string | null;
     createdAt: string;
 }
 interface TrialStatus {
@@ -210,6 +216,28 @@ interface TrialStatus {
     /** Whether the trial has converted to paid */
     hasConverted: boolean;
 }
+interface DunningStatus {
+    /** Whether the subscription is past due */
+    isPastDue: boolean;
+    /** Whether the subscription is in grace period (past due but still has access) */
+    isInGracePeriod: boolean;
+    /** Number of consecutive failed payment attempts */
+    failedPaymentCount: number;
+    /** Timestamp of most recent failed payment */
+    lastPaymentFailedAt: string | null;
+    /** When access will be revoked if payment not recovered */
+    gracePeriodEndsAt: string | null;
+    /** Days until access is revoked (null if not in grace period) */
+    daysUntilAccessRevoked: number | null;
+    /** Days since payment failed */
+    daysSinceFailure: number | null;
+    /** Configured dunning email schedule (days after failure) */
+    dunningEmailSchedule: number[];
+    /** Which dunning emails have been sent (days) */
+    emailsSent: number[];
+    /** Whether the customer still has access (considering grace period) */
+    hasAccess: boolean;
+}
 interface CustomerWithSubscription extends Customer {
     subscription?: Subscription;
 }
@@ -1240,6 +1268,72 @@ declare class SubscriptionsClient {
      * ```
      */
     endTrial(subscriptionId: string): Promise<Subscription>;
+    /**
+     * Get dunning/payment recovery status for a subscription.
+     *
+     * Shows if the subscription is past due, in grace period, and when access
+     * will be revoked if payment isn't recovered.
+     *
+     * @example
+     * ```typescript
+     * const dunning = await stackbe.subscriptions.getDunningStatus('sub_123');
+     *
+     * if (dunning.isPastDue) {
+     *   console.log(`Payment failed ${dunning.daysSinceFailure} days ago`);
+     *
+     *   if (dunning.isInGracePeriod) {
+     *     console.log(`Access ends in ${dunning.daysUntilAccessRevoked} days`);
+     *   }
+     * }
+     *
+     * // Check if customer still has access
+     * if (dunning.hasAccess) {
+     *   // Allow access
+     * }
+     * ```
+     */
+    getDunningStatus(subscriptionId: string): Promise<DunningStatus>;
+    /**
+     * List all past-due subscriptions.
+     *
+     * Useful for monitoring and recovery efforts.
+     *
+     * @example
+     * ```typescript
+     * // List all past-due subscriptions
+     * const pastDue = await stackbe.subscriptions.listPastDue();
+     *
+     * // List subscriptions losing access within 3 days
+     * const urgent = await stackbe.subscriptions.listPastDue({ gracePeriodExpiringSoon: 3 });
+     *
+     * for (const sub of urgent) {
+     *   console.log(`${sub.customer.email} loses access in ${sub.gracePeriodEndsAt}`);
+     * }
+     * ```
+     */
+    listPastDue(options?: {
+        appId?: string;
+        gracePeriodExpiringSoon?: number;
+    }): Promise<Subscription[]>;
+    /**
+     * Check if a subscription still has access (considering grace period).
+     *
+     * Returns true if:
+     * - Subscription is active
+     * - Subscription is trialing
+     * - Subscription is past_due but within grace period
+     *
+     * @example
+     * ```typescript
+     * const { hasAccess } = await stackbe.subscriptions.checkAccess('sub_123');
+     * if (!hasAccess) {
+     *   // Show upgrade prompt or block feature
+     * }
+     * ```
+     */
+    checkAccess(subscriptionId: string): Promise<{
+        hasAccess: boolean;
+    }>;
 }
 
 interface AuthClientOptions {
@@ -2431,4 +2525,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, 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, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestImage, type FeatureRequestListResponse, FeatureRequestsClient, type GetSubscriptionOptions, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, type ListEarlyAccessOptions, type ListFeatureRequestsOptions, 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 SubscriptionPlan, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TrackReferralResponse, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, 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, 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 DunningStatus, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestImage, type FeatureRequestListResponse, FeatureRequestsClient, type GetSubscriptionOptions, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, type ListEarlyAccessOptions, type ListFeatureRequestsOptions, 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 SubscriptionPlan, type SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, type TrackReferralResponse, type TrackUsageOptions, type TrackUsageResponse, type TrialEndedEvent, 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

@@ -1086,6 +1086,87 @@ var SubscriptionsClient = class {
       `/v1/subscriptions/${subscriptionId}/trial/end`
     );
   }
+  // ============================================
+  // Dunning / Payment Recovery Methods
+  // ============================================
+  /**
+   * Get dunning/payment recovery status for a subscription.
+   *
+   * Shows if the subscription is past due, in grace period, and when access
+   * will be revoked if payment isn't recovered.
+   *
+   * @example
+   * ```typescript
+   * const dunning = await stackbe.subscriptions.getDunningStatus('sub_123');
+   *
+   * if (dunning.isPastDue) {
+   *   console.log(`Payment failed ${dunning.daysSinceFailure} days ago`);
+   *
+   *   if (dunning.isInGracePeriod) {
+   *     console.log(`Access ends in ${dunning.daysUntilAccessRevoked} days`);
+   *   }
+   * }
+   *
+   * // Check if customer still has access
+   * if (dunning.hasAccess) {
+   *   // Allow access
+   * }
+   * ```
+   */
+  async getDunningStatus(subscriptionId) {
+    return this.http.get(
+      `/v1/subscriptions/${subscriptionId}/dunning`
+    );
+  }
+  /**
+   * List all past-due subscriptions.
+   *
+   * Useful for monitoring and recovery efforts.
+   *
+   * @example
+   * ```typescript
+   * // List all past-due subscriptions
+   * const pastDue = await stackbe.subscriptions.listPastDue();
+   *
+   * // List subscriptions losing access within 3 days
+   * const urgent = await stackbe.subscriptions.listPastDue({ gracePeriodExpiringSoon: 3 });
+   *
+   * for (const sub of urgent) {
+   *   console.log(`${sub.customer.email} loses access in ${sub.gracePeriodEndsAt}`);
+   * }
+   * ```
+   */
+  async listPastDue(options) {
+    const params = new URLSearchParams();
+    if (options?.appId) params.set("appId", options.appId);
+    if (options?.gracePeriodExpiringSoon) {
+      params.set("gracePeriodExpiringSoon", String(options.gracePeriodExpiringSoon));
+    }
+    const query = params.toString();
+    const path = `/v1/subscriptions/past-due${query ? `?${query}` : ""}`;
+    return this.http.get(path);
+  }
+  /**
+   * Check if a subscription still has access (considering grace period).
+   *
+   * Returns true if:
+   * - Subscription is active
+   * - Subscription is trialing
+   * - Subscription is past_due but within grace period
+   *
+   * @example
+   * ```typescript
+   * const { hasAccess } = await stackbe.subscriptions.checkAccess('sub_123');
+   * if (!hasAccess) {
+   *   // Show upgrade prompt or block feature
+   * }
+   * ```
+   */
+  async checkAccess(subscriptionId) {
+    return this.http.get(
+      `/v1/subscriptions/${subscriptionId}/has-access`
+    );
+  }
 };
 
 // src/auth.ts

package/dist/index.mjs

@@ -1046,6 +1046,87 @@ var SubscriptionsClient = class {
       `/v1/subscriptions/${subscriptionId}/trial/end`
     );
   }
+  // ============================================
+  // Dunning / Payment Recovery Methods
+  // ============================================
+  /**
+   * Get dunning/payment recovery status for a subscription.
+   *
+   * Shows if the subscription is past due, in grace period, and when access
+   * will be revoked if payment isn't recovered.
+   *
+   * @example
+   * ```typescript
+   * const dunning = await stackbe.subscriptions.getDunningStatus('sub_123');
+   *
+   * if (dunning.isPastDue) {
+   *   console.log(`Payment failed ${dunning.daysSinceFailure} days ago`);
+   *
+   *   if (dunning.isInGracePeriod) {
+   *     console.log(`Access ends in ${dunning.daysUntilAccessRevoked} days`);
+   *   }
+   * }
+   *
+   * // Check if customer still has access
+   * if (dunning.hasAccess) {
+   *   // Allow access
+   * }
+   * ```
+   */
+  async getDunningStatus(subscriptionId) {
+    return this.http.get(
+      `/v1/subscriptions/${subscriptionId}/dunning`
+    );
+  }
+  /**
+   * List all past-due subscriptions.
+   *
+   * Useful for monitoring and recovery efforts.
+   *
+   * @example
+   * ```typescript
+   * // List all past-due subscriptions
+   * const pastDue = await stackbe.subscriptions.listPastDue();
+   *
+   * // List subscriptions losing access within 3 days
+   * const urgent = await stackbe.subscriptions.listPastDue({ gracePeriodExpiringSoon: 3 });
+   *
+   * for (const sub of urgent) {
+   *   console.log(`${sub.customer.email} loses access in ${sub.gracePeriodEndsAt}`);
+   * }
+   * ```
+   */
+  async listPastDue(options) {
+    const params = new URLSearchParams();
+    if (options?.appId) params.set("appId", options.appId);
+    if (options?.gracePeriodExpiringSoon) {
+      params.set("gracePeriodExpiringSoon", String(options.gracePeriodExpiringSoon));
+    }
+    const query = params.toString();
+    const path = `/v1/subscriptions/past-due${query ? `?${query}` : ""}`;
+    return this.http.get(path);
+  }
+  /**
+   * Check if a subscription still has access (considering grace period).
+   *
+   * Returns true if:
+   * - Subscription is active
+   * - Subscription is trialing
+   * - Subscription is past_due but within grace period
+   *
+   * @example
+   * ```typescript
+   * const { hasAccess } = await stackbe.subscriptions.checkAccess('sub_123');
+   * if (!hasAccess) {
+   *   // Show upgrade prompt or block feature
+   * }
+   * ```
+   */
+  async checkAccess(subscriptionId) {
+    return this.http.get(
+      `/v1/subscriptions/${subscriptionId}/has-access`
+    );
+  }
 };
 
 // src/auth.ts

package/package.json

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