@stackbe/sdk 0.14.0 → 0.15.1

package/dist/index.d.mts

@@ -292,6 +292,17 @@ interface SwitchOrganizationResponse {
     /** Customer's role in the organization */
     orgRole: 'owner' | 'admin' | 'member';
 }
+/** Lightweight org membership returned in session responses */
+interface OrganizationMembership {
+    /** Organization ID */
+    id: string;
+    /** Organization name */
+    name: string;
+    /** Organization slug */
+    slug: string;
+    /** Customer's role in this organization */
+    role: 'owner' | 'admin' | 'member';
+}
 interface SessionResponse {
     valid: boolean;
     /** Customer ID */
@@ -306,6 +317,12 @@ interface SessionResponse {
     organizationId?: string;
     /** Role in the organization */
     orgRole?: 'owner' | 'admin' | 'member';
+    /**
+     * All org memberships for this customer.
+     * Included when the app has `enableOrganizations: true`, null otherwise.
+     * Use this to build an org-switcher UI without an extra API call.
+     */
+    organizations?: OrganizationMembership[] | null;
     /** Customer details (if included) */
     customer?: Customer;
     /** Current subscription (if any) */
@@ -627,6 +644,70 @@ type CustomerCreatedEvent = WebhookEvent<'customer_created', CustomerWebhookPayl
 type CustomerUpdatedEvent = WebhookEvent<'customer_updated', CustomerWebhookPayload>;
 /** Union of all webhook event types */
 type AnyWebhookEvent = SubscriptionCreatedEvent | SubscriptionUpdatedEvent | SubscriptionCancelledEvent | SubscriptionRenewedEvent | TrialStartedEvent | TrialEndedEvent | PaymentSucceededEvent | PaymentFailedEvent | CustomerCreatedEvent | CustomerUpdatedEvent;
+interface DealRegistration {
+    id: string;
+    affiliateId: string;
+    programId: string;
+    leadEmail: string;
+    leadName?: string | null;
+    notes?: string | null;
+    status: 'pending' | 'approved' | 'converted' | 'expired' | 'rejected';
+    expiresAt: string;
+    approvedAt?: string | null;
+    convertedAt?: string | null;
+    rejectedAt?: string | null;
+    rejectionReason?: string | null;
+    convertedCustomerId?: string | null;
+    convertedSubscriptionId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PartnerDashboard {
+    affiliate: {
+        id: string;
+        code: string;
+        type: string;
+        status: string;
+        totalEarned: number;
+        pendingBalance: number;
+        paidOut: number;
+        totalReferrals: number;
+        totalConversions: number;
+    };
+    tier?: {
+        id: string;
+        name: string;
+        level: number;
+        commissionRate: number;
+        commissionType: string;
+    } | null;
+    earningsBySource: {
+        link: number;
+        coupon: number;
+        deal: number;
+    };
+    recentCommissions: Array<{
+        id: string;
+        amount: number;
+        currency: string;
+        status: string;
+        createdAt: string;
+    }>;
+    activeDeals: Array<{
+        id: string;
+        leadEmail: string;
+        status: string;
+        expiresAt: string;
+        createdAt: string;
+    }>;
+    coupons: Array<{
+        id: string;
+        code: string;
+        discountType: string;
+        discountValue: number;
+        timesRedeemed: number;
+    }>;
+}
 
 declare class UsageClient {
     private http;
@@ -2277,6 +2358,7 @@ interface AffiliateInfo {
     enrolled: boolean;
     id?: string;
     code?: string;
+    type?: 'affiliate' | 'referral' | 'reseller';
     status?: 'active' | 'suspended' | 'pending';
     totalEarned?: number;
     pendingBalance?: number;
@@ -2288,6 +2370,7 @@ interface AffiliateInfo {
 interface AffiliateEnrollment {
     id: string;
     code: string;
+    type: string;
     status: string;
     createdAt: string;
 }
@@ -2320,6 +2403,20 @@ interface EnrollOptions {
     code?: string;
     /** PayPal email for payouts */
     payoutEmail?: string;
+    /** Partner type (default: 'affiliate') */
+    type?: 'affiliate' | 'referral' | 'reseller';
+}
+interface RegisterDealOptions {
+    /** Email of the lead */
+    leadEmail: string;
+    /** Name of the lead */
+    leadName?: string;
+    /** Notes about the deal */
+    notes?: string;
+}
+interface DealListResponse {
+    deals: DealRegistration[];
+    total: number;
 }
 declare class AffiliatesClient {
     private http;
@@ -2327,86 +2424,66 @@ declare class AffiliatesClient {
     /**
      * Get the current customer's affiliate info.
      * Requires customer session token.
-     *
-     * @example
-     * ```typescript
-     * const affiliate = await stackbe.affiliates.get();
-     *
-     * if (affiliate.enrolled) {
-     *   console.log(`Your referral code: ${affiliate.code}`);
-     *   console.log(`Earnings: $${(affiliate.totalEarned! / 100).toFixed(2)}`);
-     * } else {
-     *   console.log('Not enrolled in affiliate program');
-     * }
-     * ```
      */
     get(): Promise<AffiliateInfo>;
     /**
-     * Enroll the current customer as an affiliate.
+     * Enroll the current customer as an affiliate/partner.
      * Requires customer session token.
      *
      * @example
      * ```typescript
-     * // Enroll with auto-generated code
-     * const affiliate = await stackbe.affiliates.enroll();
+     * const affiliate = await stackbe.affiliates.enroll({ type: 'referral' });
      * console.log(`Your referral code: ${affiliate.code}`);
-     *
-     * // Enroll with custom code
-     * const affiliate = await stackbe.affiliates.enroll({
-     *   code: 'MYCODE',
-     *   payoutEmail: 'payouts@example.com',
-     * });
      * ```
      */
     enroll(options?: EnrollOptions): Promise<AffiliateEnrollment>;
     /**
      * Get affiliate statistics.
      * Requires customer session token.
-     *
-     * @example
-     * ```typescript
-     * const stats = await stackbe.affiliates.getStats();
-     *
-     * if (stats.enrolled) {
-     *   console.log(`Total earned: $${(stats.totalEarned / 100).toFixed(2)}`);
-     *   console.log(`Pending: $${(stats.pendingBalance / 100).toFixed(2)}`);
-     *   console.log(`Referrals: ${stats.totalReferrals}`);
-     *   console.log(`Conversions: ${stats.totalConversions}`);
-     * }
-     * ```
      */
     getStats(): Promise<AffiliateStats>;
     /**
      * Get affiliate commission history.
      * Requires customer session token.
+     */
+    getCommissions(): Promise<AffiliateCommissionsResponse>;
+    /**
+     * Track a referral click (store token for attribution).
+     * Requires API key.
+     */
+    trackReferral(code: string, referralUrl?: string): Promise<TrackReferralResponse>;
+    /**
+     * Get the full partner dashboard with stats, earnings by source, deals, and coupons.
+     * Requires customer session token.
      *
      * @example
      * ```typescript
-     * const { commissions, total } = await stackbe.affiliates.getCommissions();
-     *
-     * commissions.forEach((c) => {
-     *   console.log(`$${(c.amount / 100).toFixed(2)} - ${c.status}`);
-     * });
+     * const dashboard = await stackbe.affiliates.getDashboard();
+     * console.log(`Link earnings: $${dashboard.earningsBySource.link}`);
+     * console.log(`Coupon earnings: $${dashboard.earningsBySource.coupon}`);
+     * console.log(`Deal earnings: $${dashboard.earningsBySource.deal}`);
      * ```
      */
-    getCommissions(): Promise<AffiliateCommissionsResponse>;
+    getDashboard(): Promise<PartnerDashboard>;
     /**
-     * Track a referral click (store token for attribution).
-     * Call this when a user lands on your site with a referral code.
-     * Requires API key.
+     * Register a deal (lead attribution).
+     * Requires customer session token and active partner enrollment.
      *
      * @example
      * ```typescript
-     * // In your landing page handler
-     * const refCode = req.query.ref;
-     * if (refCode) {
-     *   const { token, expiresInDays } = await stackbe.affiliates.trackReferral(refCode);
-     *   // Store token in cookie for attribution on signup
-     *   res.cookie('ref_token', token, { maxAge: expiresInDays * 24 * 60 * 60 * 1000 });
-     * }
+     * const deal = await stackbe.affiliates.registerDeal({
+     *   leadEmail: 'prospect@company.com',
+     *   leadName: 'John Smith',
+     *   notes: 'Met at conference, interested in Pro plan',
+     * });
      * ```
      */
-    trackReferral(code: string, referralUrl?: string): Promise<TrackReferralResponse>;
+    registerDeal(options: RegisterDealOptions): Promise<DealRegistration>;
+    /**
+     * List the current partner's deal registrations.
+     * Requires customer session token.
+     */
+    listDeals(): Promise<DealListResponse>;
 }
 
 interface EarlyAccessSignup {
@@ -2989,4 +3066,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, type AttachPaymentMethodOptions, AuthClient, type BillingPortalSession, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type ChargeResult, 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 CreateSetupSessionOptions, 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 MigrateToStackbeManagedResult, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentMethod, PaymentMethodsClient, type PaymentSucceededEvent, type PaymentWebhookPayload, type PerformanceMetrics, type Plan, type PlanMetrics, PlansClient, type PopularEndpoint, type Product, ProductsClient, type RequestCountPoint, type RevenueByPlan, type SessionResponse, type SetupSessionResponse, 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 };
+export { type AddMemberOptions, type AffiliateCommission, type AffiliateCommissionsResponse, type AffiliateEnrollment, type AffiliateInfo, type AffiliateStats, AffiliatesClient, AnalyticsClient, type AnalyticsFilterOptions, type AnyWebhookEvent, type AttachPaymentMethodOptions, AuthClient, type BillingPortalSession, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type ChargeResult, 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 CreateSetupSessionOptions, 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 MigrateToStackbeManagedResult, type Organization, type OrganizationInvite, type OrganizationMember, type OrganizationMembership, OrganizationsClient, type PaymentFailedEvent, type PaymentMethod, PaymentMethodsClient, type PaymentSucceededEvent, type PaymentWebhookPayload, type PerformanceMetrics, type Plan, type PlanMetrics, PlansClient, type PopularEndpoint, type Product, ProductsClient, type RequestCountPoint, type RevenueByPlan, type SessionResponse, type SetupSessionResponse, 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

@@ -292,6 +292,17 @@ interface SwitchOrganizationResponse {
     /** Customer's role in the organization */
     orgRole: 'owner' | 'admin' | 'member';
 }
+/** Lightweight org membership returned in session responses */
+interface OrganizationMembership {
+    /** Organization ID */
+    id: string;
+    /** Organization name */
+    name: string;
+    /** Organization slug */
+    slug: string;
+    /** Customer's role in this organization */
+    role: 'owner' | 'admin' | 'member';
+}
 interface SessionResponse {
     valid: boolean;
     /** Customer ID */
@@ -306,6 +317,12 @@ interface SessionResponse {
     organizationId?: string;
     /** Role in the organization */
     orgRole?: 'owner' | 'admin' | 'member';
+    /**
+     * All org memberships for this customer.
+     * Included when the app has `enableOrganizations: true`, null otherwise.
+     * Use this to build an org-switcher UI without an extra API call.
+     */
+    organizations?: OrganizationMembership[] | null;
     /** Customer details (if included) */
     customer?: Customer;
     /** Current subscription (if any) */
@@ -627,6 +644,70 @@ type CustomerCreatedEvent = WebhookEvent<'customer_created', CustomerWebhookPayl
 type CustomerUpdatedEvent = WebhookEvent<'customer_updated', CustomerWebhookPayload>;
 /** Union of all webhook event types */
 type AnyWebhookEvent = SubscriptionCreatedEvent | SubscriptionUpdatedEvent | SubscriptionCancelledEvent | SubscriptionRenewedEvent | TrialStartedEvent | TrialEndedEvent | PaymentSucceededEvent | PaymentFailedEvent | CustomerCreatedEvent | CustomerUpdatedEvent;
+interface DealRegistration {
+    id: string;
+    affiliateId: string;
+    programId: string;
+    leadEmail: string;
+    leadName?: string | null;
+    notes?: string | null;
+    status: 'pending' | 'approved' | 'converted' | 'expired' | 'rejected';
+    expiresAt: string;
+    approvedAt?: string | null;
+    convertedAt?: string | null;
+    rejectedAt?: string | null;
+    rejectionReason?: string | null;
+    convertedCustomerId?: string | null;
+    convertedSubscriptionId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PartnerDashboard {
+    affiliate: {
+        id: string;
+        code: string;
+        type: string;
+        status: string;
+        totalEarned: number;
+        pendingBalance: number;
+        paidOut: number;
+        totalReferrals: number;
+        totalConversions: number;
+    };
+    tier?: {
+        id: string;
+        name: string;
+        level: number;
+        commissionRate: number;
+        commissionType: string;
+    } | null;
+    earningsBySource: {
+        link: number;
+        coupon: number;
+        deal: number;
+    };
+    recentCommissions: Array<{
+        id: string;
+        amount: number;
+        currency: string;
+        status: string;
+        createdAt: string;
+    }>;
+    activeDeals: Array<{
+        id: string;
+        leadEmail: string;
+        status: string;
+        expiresAt: string;
+        createdAt: string;
+    }>;
+    coupons: Array<{
+        id: string;
+        code: string;
+        discountType: string;
+        discountValue: number;
+        timesRedeemed: number;
+    }>;
+}
 
 declare class UsageClient {
     private http;
@@ -2277,6 +2358,7 @@ interface AffiliateInfo {
     enrolled: boolean;
     id?: string;
     code?: string;
+    type?: 'affiliate' | 'referral' | 'reseller';
     status?: 'active' | 'suspended' | 'pending';
     totalEarned?: number;
     pendingBalance?: number;
@@ -2288,6 +2370,7 @@ interface AffiliateInfo {
 interface AffiliateEnrollment {
     id: string;
     code: string;
+    type: string;
     status: string;
     createdAt: string;
 }
@@ -2320,6 +2403,20 @@ interface EnrollOptions {
     code?: string;
     /** PayPal email for payouts */
     payoutEmail?: string;
+    /** Partner type (default: 'affiliate') */
+    type?: 'affiliate' | 'referral' | 'reseller';
+}
+interface RegisterDealOptions {
+    /** Email of the lead */
+    leadEmail: string;
+    /** Name of the lead */
+    leadName?: string;
+    /** Notes about the deal */
+    notes?: string;
+}
+interface DealListResponse {
+    deals: DealRegistration[];
+    total: number;
 }
 declare class AffiliatesClient {
     private http;
@@ -2327,86 +2424,66 @@ declare class AffiliatesClient {
     /**
      * Get the current customer's affiliate info.
      * Requires customer session token.
-     *
-     * @example
-     * ```typescript
-     * const affiliate = await stackbe.affiliates.get();
-     *
-     * if (affiliate.enrolled) {
-     *   console.log(`Your referral code: ${affiliate.code}`);
-     *   console.log(`Earnings: $${(affiliate.totalEarned! / 100).toFixed(2)}`);
-     * } else {
-     *   console.log('Not enrolled in affiliate program');
-     * }
-     * ```
      */
     get(): Promise<AffiliateInfo>;
     /**
-     * Enroll the current customer as an affiliate.
+     * Enroll the current customer as an affiliate/partner.
      * Requires customer session token.
      *
      * @example
      * ```typescript
-     * // Enroll with auto-generated code
-     * const affiliate = await stackbe.affiliates.enroll();
+     * const affiliate = await stackbe.affiliates.enroll({ type: 'referral' });
      * console.log(`Your referral code: ${affiliate.code}`);
-     *
-     * // Enroll with custom code
-     * const affiliate = await stackbe.affiliates.enroll({
-     *   code: 'MYCODE',
-     *   payoutEmail: 'payouts@example.com',
-     * });
      * ```
      */
     enroll(options?: EnrollOptions): Promise<AffiliateEnrollment>;
     /**
      * Get affiliate statistics.
      * Requires customer session token.
-     *
-     * @example
-     * ```typescript
-     * const stats = await stackbe.affiliates.getStats();
-     *
-     * if (stats.enrolled) {
-     *   console.log(`Total earned: $${(stats.totalEarned / 100).toFixed(2)}`);
-     *   console.log(`Pending: $${(stats.pendingBalance / 100).toFixed(2)}`);
-     *   console.log(`Referrals: ${stats.totalReferrals}`);
-     *   console.log(`Conversions: ${stats.totalConversions}`);
-     * }
-     * ```
      */
     getStats(): Promise<AffiliateStats>;
     /**
      * Get affiliate commission history.
      * Requires customer session token.
+     */
+    getCommissions(): Promise<AffiliateCommissionsResponse>;
+    /**
+     * Track a referral click (store token for attribution).
+     * Requires API key.
+     */
+    trackReferral(code: string, referralUrl?: string): Promise<TrackReferralResponse>;
+    /**
+     * Get the full partner dashboard with stats, earnings by source, deals, and coupons.
+     * Requires customer session token.
      *
      * @example
      * ```typescript
-     * const { commissions, total } = await stackbe.affiliates.getCommissions();
-     *
-     * commissions.forEach((c) => {
-     *   console.log(`$${(c.amount / 100).toFixed(2)} - ${c.status}`);
-     * });
+     * const dashboard = await stackbe.affiliates.getDashboard();
+     * console.log(`Link earnings: $${dashboard.earningsBySource.link}`);
+     * console.log(`Coupon earnings: $${dashboard.earningsBySource.coupon}`);
+     * console.log(`Deal earnings: $${dashboard.earningsBySource.deal}`);
      * ```
      */
-    getCommissions(): Promise<AffiliateCommissionsResponse>;
+    getDashboard(): Promise<PartnerDashboard>;
     /**
-     * Track a referral click (store token for attribution).
-     * Call this when a user lands on your site with a referral code.
-     * Requires API key.
+     * Register a deal (lead attribution).
+     * Requires customer session token and active partner enrollment.
      *
      * @example
      * ```typescript
-     * // In your landing page handler
-     * const refCode = req.query.ref;
-     * if (refCode) {
-     *   const { token, expiresInDays } = await stackbe.affiliates.trackReferral(refCode);
-     *   // Store token in cookie for attribution on signup
-     *   res.cookie('ref_token', token, { maxAge: expiresInDays * 24 * 60 * 60 * 1000 });
-     * }
+     * const deal = await stackbe.affiliates.registerDeal({
+     *   leadEmail: 'prospect@company.com',
+     *   leadName: 'John Smith',
+     *   notes: 'Met at conference, interested in Pro plan',
+     * });
      * ```
      */
-    trackReferral(code: string, referralUrl?: string): Promise<TrackReferralResponse>;
+    registerDeal(options: RegisterDealOptions): Promise<DealRegistration>;
+    /**
+     * List the current partner's deal registrations.
+     * Requires customer session token.
+     */
+    listDeals(): Promise<DealListResponse>;
 }
 
 interface EarlyAccessSignup {
@@ -2989,4 +3066,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, type AttachPaymentMethodOptions, AuthClient, type BillingPortalSession, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type ChargeResult, 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 CreateSetupSessionOptions, 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 MigrateToStackbeManagedResult, type Organization, type OrganizationInvite, type OrganizationMember, OrganizationsClient, type PaymentFailedEvent, type PaymentMethod, PaymentMethodsClient, type PaymentSucceededEvent, type PaymentWebhookPayload, type PerformanceMetrics, type Plan, type PlanMetrics, PlansClient, type PopularEndpoint, type Product, ProductsClient, type RequestCountPoint, type RevenueByPlan, type SessionResponse, type SetupSessionResponse, 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 };
+export { type AddMemberOptions, type AffiliateCommission, type AffiliateCommissionsResponse, type AffiliateEnrollment, type AffiliateInfo, type AffiliateStats, AffiliatesClient, AnalyticsClient, type AnalyticsFilterOptions, type AnyWebhookEvent, type AttachPaymentMethodOptions, AuthClient, type BillingPortalSession, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type ChargeResult, 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 CreateSetupSessionOptions, 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 MigrateToStackbeManagedResult, type Organization, type OrganizationInvite, type OrganizationMember, type OrganizationMembership, OrganizationsClient, type PaymentFailedEvent, type PaymentMethod, PaymentMethodsClient, type PaymentSucceededEvent, type PaymentWebhookPayload, type PerformanceMetrics, type Plan, type PlanMetrics, PlansClient, type PopularEndpoint, type Product, ProductsClient, type RequestCountPoint, type RevenueByPlan, type SessionResponse, type SetupSessionResponse, 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

@@ -1593,6 +1593,7 @@ var AuthClient = class {
         tenantId: tenantId ?? data.tenantId,
         organizationId: data.organizationId ?? organizationId,
         orgRole: data.orgRole ?? orgRole,
+        organizations: data.organizations,
         customer: data.customer,
         subscription: data.subscription,
         entitlements: data.entitlements
@@ -2259,37 +2260,18 @@ var AffiliatesClient = class {
   /**
    * Get the current customer's affiliate info.
    * Requires customer session token.
-   *
-   * @example
-   * ```typescript
-   * const affiliate = await stackbe.affiliates.get();
-   *
-   * if (affiliate.enrolled) {
-   *   console.log(`Your referral code: ${affiliate.code}`);
-   *   console.log(`Earnings: $${(affiliate.totalEarned! / 100).toFixed(2)}`);
-   * } else {
-   *   console.log('Not enrolled in affiliate program');
-   * }
-   * ```
    */
   async get() {
     return this.http.get("/v1/affiliate");
   }
   /**
-   * Enroll the current customer as an affiliate.
+   * Enroll the current customer as an affiliate/partner.
    * Requires customer session token.
    *
    * @example
    * ```typescript
-   * // Enroll with auto-generated code
-   * const affiliate = await stackbe.affiliates.enroll();
+   * const affiliate = await stackbe.affiliates.enroll({ type: 'referral' });
    * console.log(`Your referral code: ${affiliate.code}`);
-   *
-   * // Enroll with custom code
-   * const affiliate = await stackbe.affiliates.enroll({
-   *   code: 'MYCODE',
-   *   payoutEmail: 'payouts@example.com',
-   * });
    * ```
    */
   async enroll(options = {}) {
@@ -2298,18 +2280,6 @@ var AffiliatesClient = class {
   /**
    * Get affiliate statistics.
    * Requires customer session token.
-   *
-   * @example
-   * ```typescript
-   * const stats = await stackbe.affiliates.getStats();
-   *
-   * if (stats.enrolled) {
-   *   console.log(`Total earned: $${(stats.totalEarned / 100).toFixed(2)}`);
-   *   console.log(`Pending: $${(stats.pendingBalance / 100).toFixed(2)}`);
-   *   console.log(`Referrals: ${stats.totalReferrals}`);
-   *   console.log(`Conversions: ${stats.totalConversions}`);
-   * }
-   * ```
    */
   async getStats() {
     return this.http.get("/v1/affiliate/stats");
@@ -2317,34 +2287,13 @@ var AffiliatesClient = class {
   /**
    * Get affiliate commission history.
    * Requires customer session token.
-   *
-   * @example
-   * ```typescript
-   * const { commissions, total } = await stackbe.affiliates.getCommissions();
-   *
-   * commissions.forEach((c) => {
-   *   console.log(`$${(c.amount / 100).toFixed(2)} - ${c.status}`);
-   * });
-   * ```
    */
   async getCommissions() {
     return this.http.get("/v1/affiliate/commissions");
   }
   /**
    * Track a referral click (store token for attribution).
-   * Call this when a user lands on your site with a referral code.
    * Requires API key.
-   *
-   * @example
-   * ```typescript
-   * // In your landing page handler
-   * const refCode = req.query.ref;
-   * if (refCode) {
-   *   const { token, expiresInDays } = await stackbe.affiliates.trackReferral(refCode);
-   *   // Store token in cookie for attribution on signup
-   *   res.cookie('ref_token', token, { maxAge: expiresInDays * 24 * 60 * 60 * 1000 });
-   * }
-   * ```
    */
   async trackReferral(code, referralUrl) {
     return this.http.post("/v1/affiliate/track", {
@@ -2352,6 +2301,44 @@ var AffiliatesClient = class {
       referralUrl
     });
   }
+  /**
+   * Get the full partner dashboard with stats, earnings by source, deals, and coupons.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * const dashboard = await stackbe.affiliates.getDashboard();
+   * console.log(`Link earnings: $${dashboard.earningsBySource.link}`);
+   * console.log(`Coupon earnings: $${dashboard.earningsBySource.coupon}`);
+   * console.log(`Deal earnings: $${dashboard.earningsBySource.deal}`);
+   * ```
+   */
+  async getDashboard() {
+    return this.http.get("/v1/affiliate/dashboard");
+  }
+  /**
+   * Register a deal (lead attribution).
+   * Requires customer session token and active partner enrollment.
+   *
+   * @example
+   * ```typescript
+   * const deal = await stackbe.affiliates.registerDeal({
+   *   leadEmail: 'prospect@company.com',
+   *   leadName: 'John Smith',
+   *   notes: 'Met at conference, interested in Pro plan',
+   * });
+   * ```
+   */
+  async registerDeal(options) {
+    return this.http.post("/v1/affiliate/deals", options);
+  }
+  /**
+   * List the current partner's deal registrations.
+   * Requires customer session token.
+   */
+  async listDeals() {
+    return this.http.get("/v1/affiliate/deals");
+  }
 };
 
 // src/early-access.ts

package/dist/index.mjs

@@ -1551,6 +1551,7 @@ var AuthClient = class {
         tenantId: tenantId ?? data.tenantId,
         organizationId: data.organizationId ?? organizationId,
         orgRole: data.orgRole ?? orgRole,
+        organizations: data.organizations,
         customer: data.customer,
         subscription: data.subscription,
         entitlements: data.entitlements
@@ -2217,37 +2218,18 @@ var AffiliatesClient = class {
   /**
    * Get the current customer's affiliate info.
    * Requires customer session token.
-   *
-   * @example
-   * ```typescript
-   * const affiliate = await stackbe.affiliates.get();
-   *
-   * if (affiliate.enrolled) {
-   *   console.log(`Your referral code: ${affiliate.code}`);
-   *   console.log(`Earnings: $${(affiliate.totalEarned! / 100).toFixed(2)}`);
-   * } else {
-   *   console.log('Not enrolled in affiliate program');
-   * }
-   * ```
    */
   async get() {
     return this.http.get("/v1/affiliate");
   }
   /**
-   * Enroll the current customer as an affiliate.
+   * Enroll the current customer as an affiliate/partner.
    * Requires customer session token.
    *
    * @example
    * ```typescript
-   * // Enroll with auto-generated code
-   * const affiliate = await stackbe.affiliates.enroll();
+   * const affiliate = await stackbe.affiliates.enroll({ type: 'referral' });
    * console.log(`Your referral code: ${affiliate.code}`);
-   *
-   * // Enroll with custom code
-   * const affiliate = await stackbe.affiliates.enroll({
-   *   code: 'MYCODE',
-   *   payoutEmail: 'payouts@example.com',
-   * });
    * ```
    */
   async enroll(options = {}) {
@@ -2256,18 +2238,6 @@ var AffiliatesClient = class {
   /**
    * Get affiliate statistics.
    * Requires customer session token.
-   *
-   * @example
-   * ```typescript
-   * const stats = await stackbe.affiliates.getStats();
-   *
-   * if (stats.enrolled) {
-   *   console.log(`Total earned: $${(stats.totalEarned / 100).toFixed(2)}`);
-   *   console.log(`Pending: $${(stats.pendingBalance / 100).toFixed(2)}`);
-   *   console.log(`Referrals: ${stats.totalReferrals}`);
-   *   console.log(`Conversions: ${stats.totalConversions}`);
-   * }
-   * ```
    */
   async getStats() {
     return this.http.get("/v1/affiliate/stats");
@@ -2275,34 +2245,13 @@ var AffiliatesClient = class {
   /**
    * Get affiliate commission history.
    * Requires customer session token.
-   *
-   * @example
-   * ```typescript
-   * const { commissions, total } = await stackbe.affiliates.getCommissions();
-   *
-   * commissions.forEach((c) => {
-   *   console.log(`$${(c.amount / 100).toFixed(2)} - ${c.status}`);
-   * });
-   * ```
    */
   async getCommissions() {
     return this.http.get("/v1/affiliate/commissions");
   }
   /**
    * Track a referral click (store token for attribution).
-   * Call this when a user lands on your site with a referral code.
    * Requires API key.
-   *
-   * @example
-   * ```typescript
-   * // In your landing page handler
-   * const refCode = req.query.ref;
-   * if (refCode) {
-   *   const { token, expiresInDays } = await stackbe.affiliates.trackReferral(refCode);
-   *   // Store token in cookie for attribution on signup
-   *   res.cookie('ref_token', token, { maxAge: expiresInDays * 24 * 60 * 60 * 1000 });
-   * }
-   * ```
    */
   async trackReferral(code, referralUrl) {
     return this.http.post("/v1/affiliate/track", {
@@ -2310,6 +2259,44 @@ var AffiliatesClient = class {
       referralUrl
     });
   }
+  /**
+   * Get the full partner dashboard with stats, earnings by source, deals, and coupons.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * const dashboard = await stackbe.affiliates.getDashboard();
+   * console.log(`Link earnings: $${dashboard.earningsBySource.link}`);
+   * console.log(`Coupon earnings: $${dashboard.earningsBySource.coupon}`);
+   * console.log(`Deal earnings: $${dashboard.earningsBySource.deal}`);
+   * ```
+   */
+  async getDashboard() {
+    return this.http.get("/v1/affiliate/dashboard");
+  }
+  /**
+   * Register a deal (lead attribution).
+   * Requires customer session token and active partner enrollment.
+   *
+   * @example
+   * ```typescript
+   * const deal = await stackbe.affiliates.registerDeal({
+   *   leadEmail: 'prospect@company.com',
+   *   leadName: 'John Smith',
+   *   notes: 'Met at conference, interested in Pro plan',
+   * });
+   * ```
+   */
+  async registerDeal(options) {
+    return this.http.post("/v1/affiliate/deals", options);
+  }
+  /**
+   * List the current partner's deal registrations.
+   * Requires customer session token.
+   */
+  async listDeals() {
+    return this.http.get("/v1/affiliate/deals");
+  }
 };
 
 // src/early-access.ts

package/package.json

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