@stackbe/sdk 0.8.4 → 0.8.5

package/dist/index.d.mts

@@ -720,6 +720,42 @@ declare class EntitlementsClient {
     require(customerId: string, feature: string): Promise<void>;
 }
 
+interface CustomerSubscriptionHistory {
+    id: string;
+    status: string;
+    planId: string;
+    planName?: string;
+    priceCents?: number;
+    currency?: string;
+    interval?: string;
+    currentPeriodStart?: string;
+    currentPeriodEnd?: string;
+    cancelAtPeriodEnd: boolean;
+    pausedAt?: string | null;
+    resumesAt?: string | null;
+    createdAt: string;
+}
+interface CustomerSubscriptionHistoryResponse {
+    subscriptions: CustomerSubscriptionHistory[];
+    total: number;
+}
+interface CustomerInvoice {
+    id: string;
+    number?: string;
+    status?: string;
+    amountPaid: number;
+    amountDue: number;
+    currency: string;
+    created: string;
+    periodStart?: string;
+    periodEnd?: string;
+    invoiceUrl?: string;
+    invoicePdf?: string;
+}
+interface CustomerInvoicesResponse {
+    invoices: CustomerInvoice[];
+    hasMore: boolean;
+}
 declare class CustomersClient {
     private http;
     private appId;
@@ -814,6 +850,35 @@ declare class CustomersClient {
      * ```
      */
     getSession(token: string): Promise<SessionResponse>;
+    /**
+     * Get a customer's subscription history (all subscriptions, including past).
+     *
+     * @example
+     * ```typescript
+     * const { subscriptions, total } = await stackbe.customers.getSubscriptionHistory('cust_123');
+     *
+     * subscriptions.forEach(sub => {
+     *   console.log(`${sub.planName} - ${sub.status} (${sub.createdAt})`);
+     * });
+     * ```
+     */
+    getSubscriptionHistory(customerId: string): Promise<CustomerSubscriptionHistoryResponse>;
+    /**
+     * Get a customer's invoice/payment history from Stripe.
+     *
+     * @example
+     * ```typescript
+     * const { invoices, hasMore } = await stackbe.customers.getInvoices('cust_123');
+     *
+     * invoices.forEach(inv => {
+     *   console.log(`Invoice ${inv.number}: $${inv.amountPaid} - ${inv.status}`);
+     *   console.log(`PDF: ${inv.invoicePdf}`);
+     * });
+     * ```
+     */
+    getInvoices(customerId: string, options?: {
+        limit?: number;
+    }): Promise<CustomerInvoicesResponse>;
 }
 
 declare class CheckoutClient {
@@ -2081,4 +2146,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 CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateEarlyAccessSignupOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, 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 UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };
+export { type AddMemberOptions, type AffiliateCommission, type AffiliateCommissionsResponse, type AffiliateEnrollment, type AffiliateInfo, type AffiliateStats, AffiliatesClient, type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateEarlyAccessSignupOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, type CustomerInvoice, type CustomerInvoicesResponse, 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 UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };

package/dist/index.d.ts

@@ -720,6 +720,42 @@ declare class EntitlementsClient {
     require(customerId: string, feature: string): Promise<void>;
 }
 
+interface CustomerSubscriptionHistory {
+    id: string;
+    status: string;
+    planId: string;
+    planName?: string;
+    priceCents?: number;
+    currency?: string;
+    interval?: string;
+    currentPeriodStart?: string;
+    currentPeriodEnd?: string;
+    cancelAtPeriodEnd: boolean;
+    pausedAt?: string | null;
+    resumesAt?: string | null;
+    createdAt: string;
+}
+interface CustomerSubscriptionHistoryResponse {
+    subscriptions: CustomerSubscriptionHistory[];
+    total: number;
+}
+interface CustomerInvoice {
+    id: string;
+    number?: string;
+    status?: string;
+    amountPaid: number;
+    amountDue: number;
+    currency: string;
+    created: string;
+    periodStart?: string;
+    periodEnd?: string;
+    invoiceUrl?: string;
+    invoicePdf?: string;
+}
+interface CustomerInvoicesResponse {
+    invoices: CustomerInvoice[];
+    hasMore: boolean;
+}
 declare class CustomersClient {
     private http;
     private appId;
@@ -814,6 +850,35 @@ declare class CustomersClient {
      * ```
      */
     getSession(token: string): Promise<SessionResponse>;
+    /**
+     * Get a customer's subscription history (all subscriptions, including past).
+     *
+     * @example
+     * ```typescript
+     * const { subscriptions, total } = await stackbe.customers.getSubscriptionHistory('cust_123');
+     *
+     * subscriptions.forEach(sub => {
+     *   console.log(`${sub.planName} - ${sub.status} (${sub.createdAt})`);
+     * });
+     * ```
+     */
+    getSubscriptionHistory(customerId: string): Promise<CustomerSubscriptionHistoryResponse>;
+    /**
+     * Get a customer's invoice/payment history from Stripe.
+     *
+     * @example
+     * ```typescript
+     * const { invoices, hasMore } = await stackbe.customers.getInvoices('cust_123');
+     *
+     * invoices.forEach(inv => {
+     *   console.log(`Invoice ${inv.number}: $${inv.amountPaid} - ${inv.status}`);
+     *   console.log(`PDF: ${inv.invoicePdf}`);
+     * });
+     * ```
+     */
+    getInvoices(customerId: string, options?: {
+        limit?: number;
+    }): Promise<CustomerInvoicesResponse>;
 }
 
 declare class CheckoutClient {
@@ -2081,4 +2146,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 CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateEarlyAccessSignupOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, 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 UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };
+export { type AddMemberOptions, type AffiliateCommission, type AffiliateCommissionsResponse, type AffiliateEnrollment, type AffiliateInfo, type AffiliateStats, AffiliatesClient, type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateEarlyAccessSignupOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, type CustomerInvoice, type CustomerInvoicesResponse, 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 UpdateCustomerOptions, type UpdateOrganizationOptions, type UpdateSubscriptionOptions, UsageClient, type UsageMetric, type VerifyTokenResponse, type WebhookEvent, type WebhookEventType };

package/dist/index.js

@@ -612,6 +612,45 @@ var CustomersClient = class {
     }
     return response.json();
   }
+  // ==================== Billing History ====================
+  /**
+   * Get a customer's subscription history (all subscriptions, including past).
+   *
+   * @example
+   * ```typescript
+   * const { subscriptions, total } = await stackbe.customers.getSubscriptionHistory('cust_123');
+   *
+   * subscriptions.forEach(sub => {
+   *   console.log(`${sub.planName} - ${sub.status} (${sub.createdAt})`);
+   * });
+   * ```
+   */
+  async getSubscriptionHistory(customerId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/customers/${customerId}/subscriptions`
+    );
+  }
+  /**
+   * Get a customer's invoice/payment history from Stripe.
+   *
+   * @example
+   * ```typescript
+   * const { invoices, hasMore } = await stackbe.customers.getInvoices('cust_123');
+   *
+   * invoices.forEach(inv => {
+   *   console.log(`Invoice ${inv.number}: $${inv.amountPaid} - ${inv.status}`);
+   *   console.log(`PDF: ${inv.invoicePdf}`);
+   * });
+   * ```
+   */
+  async getInvoices(customerId, options) {
+    const params = {};
+    if (options?.limit) params.limit = options.limit;
+    return this.http.get(
+      `/v1/apps/${this.appId}/customers/${customerId}/invoices`,
+      params
+    );
+  }
 };
 
 // src/checkout.ts

package/dist/index.mjs

@@ -573,6 +573,45 @@ var CustomersClient = class {
     }
     return response.json();
   }
+  // ==================== Billing History ====================
+  /**
+   * Get a customer's subscription history (all subscriptions, including past).
+   *
+   * @example
+   * ```typescript
+   * const { subscriptions, total } = await stackbe.customers.getSubscriptionHistory('cust_123');
+   *
+   * subscriptions.forEach(sub => {
+   *   console.log(`${sub.planName} - ${sub.status} (${sub.createdAt})`);
+   * });
+   * ```
+   */
+  async getSubscriptionHistory(customerId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/customers/${customerId}/subscriptions`
+    );
+  }
+  /**
+   * Get a customer's invoice/payment history from Stripe.
+   *
+   * @example
+   * ```typescript
+   * const { invoices, hasMore } = await stackbe.customers.getInvoices('cust_123');
+   *
+   * invoices.forEach(inv => {
+   *   console.log(`Invoice ${inv.number}: $${inv.amountPaid} - ${inv.status}`);
+   *   console.log(`PDF: ${inv.invoicePdf}`);
+   * });
+   * ```
+   */
+  async getInvoices(customerId, options) {
+    const params = {};
+    if (options?.limit) params.limit = options.limit;
+    return this.http.get(
+      `/v1/apps/${this.appId}/customers/${customerId}/invoices`,
+      params
+    );
+  }
 };
 
 // src/checkout.ts

package/package.json

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