@stackbe/sdk 0.7.4 → 0.8.0

package/dist/index.d.mts

@@ -1653,6 +1653,252 @@ declare class FeatureRequestsClient {
     getCustomerActivity(customerId: string): Promise<CustomerFeatureActivity>;
 }
 
+interface AffiliateInfo {
+    enrolled: boolean;
+    id?: string;
+    code?: string;
+    status?: 'active' | 'suspended' | 'pending';
+    totalEarned?: number;
+    pendingBalance?: number;
+    paidOut?: number;
+    totalReferrals?: number;
+    totalConversions?: number;
+    createdAt?: string;
+}
+interface AffiliateEnrollment {
+    id: string;
+    code: string;
+    status: string;
+    createdAt: string;
+}
+interface AffiliateStats {
+    enrolled: boolean;
+    totalEarned: number;
+    pendingBalance: number;
+    paidOut: number;
+    totalReferrals: number;
+    totalConversions: number;
+}
+interface AffiliateCommission {
+    id: string;
+    amount: number;
+    currency: string;
+    status: 'pending' | 'approved' | 'paid' | 'rejected';
+    createdAt: string;
+    referredCustomerEmail?: string;
+}
+interface AffiliateCommissionsResponse {
+    commissions: AffiliateCommission[];
+    total: number;
+}
+interface TrackReferralResponse {
+    token: string;
+    expiresInDays: number;
+}
+interface EnrollOptions {
+    /** Preferred referral code (auto-generated if not provided) */
+    code?: string;
+    /** PayPal email for payouts */
+    payoutEmail?: string;
+}
+declare class AffiliatesClient {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * 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.
+     * Requires customer session token.
+     *
+     * @example
+     * ```typescript
+     * // Enroll with auto-generated code
+     * const affiliate = await stackbe.affiliates.enroll();
+     * 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.
+     *
+     * @example
+     * ```typescript
+     * const { commissions, total } = await stackbe.affiliates.getCommissions();
+     *
+     * commissions.forEach((c) => {
+     *   console.log(`$${(c.amount / 100).toFixed(2)} - ${c.status}`);
+     * });
+     * ```
+     */
+    getCommissions(): Promise<AffiliateCommissionsResponse>;
+    /**
+     * 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 });
+     * }
+     * ```
+     */
+    trackReferral(code: string, referralUrl?: string): Promise<TrackReferralResponse>;
+}
+
+interface EarlyAccessSignup {
+    id: string;
+    status: 'new' | 'invited' | 'converted' | 'archived';
+    email: string;
+    name?: string;
+    createdAt: string;
+}
+interface CreateEarlyAccessSignupOptions {
+    email: string;
+    name?: string;
+    note?: string;
+    metadata?: Record<string, any>;
+}
+interface EarlyAccessSignupListResponse {
+    items: Array<{
+        id: string;
+        email: string;
+        name?: string;
+        status: string;
+        metadata?: Record<string, any>;
+        createdAt: string;
+    }>;
+    page: number;
+    limit: number;
+    total: number;
+    hasMore: boolean;
+}
+interface ListEarlyAccessOptions {
+    status?: 'new' | 'invited' | 'converted' | 'archived';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+declare class EarlyAccessClient {
+    private http;
+    private appId;
+    constructor(http: HttpClient, appId: string);
+    /**
+     * Submit an early access / waitlist signup.
+     * This is a public endpoint - no auth required.
+     *
+     * @example
+     * ```typescript
+     * // Basic signup
+     * const signup = await stackbe.earlyAccess.signup({
+     *   email: 'user@example.com',
+     * });
+     *
+     * // With additional info
+     * const signup = await stackbe.earlyAccess.signup({
+     *   email: 'user@example.com',
+     *   name: 'John Doe',
+     *   note: 'Interested in enterprise features',
+     *   metadata: { source: 'landing_page', campaign: 'launch' },
+     * });
+     *
+     * console.log(`Signup ID: ${signup.id}`);
+     * ```
+     */
+    signup(options: CreateEarlyAccessSignupOptions): Promise<EarlyAccessSignup>;
+    /**
+     * List early access signups.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * // Get all signups
+     * const { items, total } = await stackbe.earlyAccess.list();
+     *
+     * // Filter by status
+     * const newSignups = await stackbe.earlyAccess.list({ status: 'new' });
+     *
+     * // Search by email
+     * const results = await stackbe.earlyAccess.list({ search: 'example.com' });
+     *
+     * // Paginate
+     * const page2 = await stackbe.earlyAccess.list({ offset: 50, limit: 50 });
+     * ```
+     */
+    list(options?: ListEarlyAccessOptions): Promise<EarlyAccessSignupListResponse>;
+    /**
+     * Get a specific early access signup.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * const signup = await stackbe.earlyAccess.get('signup_123');
+     * console.log(`${signup.email} - ${signup.status}`);
+     * ```
+     */
+    get(signupId: string): Promise<EarlyAccessSignup>;
+    /**
+     * Update the status of an early access signup.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * // Mark as invited
+     * await stackbe.earlyAccess.updateStatus('signup_123', 'invited');
+     *
+     * // Mark as converted (user signed up)
+     * await stackbe.earlyAccess.updateStatus('signup_123', 'converted');
+     *
+     * // Archive
+     * await stackbe.earlyAccess.updateStatus('signup_123', 'archived');
+     * ```
+     */
+    updateStatus(signupId: string, status: 'new' | 'invited' | 'converted' | 'archived'): Promise<EarlyAccessSignup>;
+}
+
 declare class StackBE {
     private http;
     private appId;
@@ -1676,6 +1922,10 @@ declare class StackBE {
     readonly products: ProductsClient;
     /** Feature requests and voting */
     readonly featureRequests: FeatureRequestsClient;
+    /** Affiliate program (customer-facing) */
+    readonly affiliates: AffiliatesClient;
+    /** Early access / waitlist signups */
+    readonly earlyAccess: EarlyAccessClient;
     /**
      * Create a new StackBE client.
      *
@@ -1776,4 +2026,4 @@ declare class StackBE {
     }): (req: any, res: any, next: any) => Promise<any>;
 }
 
-export { type AddMemberOptions, type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestListResponse, FeatureRequestsClient, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, 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 SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, 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 CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestListResponse, FeatureRequestsClient, 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 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

@@ -1653,6 +1653,252 @@ declare class FeatureRequestsClient {
     getCustomerActivity(customerId: string): Promise<CustomerFeatureActivity>;
 }
 
+interface AffiliateInfo {
+    enrolled: boolean;
+    id?: string;
+    code?: string;
+    status?: 'active' | 'suspended' | 'pending';
+    totalEarned?: number;
+    pendingBalance?: number;
+    paidOut?: number;
+    totalReferrals?: number;
+    totalConversions?: number;
+    createdAt?: string;
+}
+interface AffiliateEnrollment {
+    id: string;
+    code: string;
+    status: string;
+    createdAt: string;
+}
+interface AffiliateStats {
+    enrolled: boolean;
+    totalEarned: number;
+    pendingBalance: number;
+    paidOut: number;
+    totalReferrals: number;
+    totalConversions: number;
+}
+interface AffiliateCommission {
+    id: string;
+    amount: number;
+    currency: string;
+    status: 'pending' | 'approved' | 'paid' | 'rejected';
+    createdAt: string;
+    referredCustomerEmail?: string;
+}
+interface AffiliateCommissionsResponse {
+    commissions: AffiliateCommission[];
+    total: number;
+}
+interface TrackReferralResponse {
+    token: string;
+    expiresInDays: number;
+}
+interface EnrollOptions {
+    /** Preferred referral code (auto-generated if not provided) */
+    code?: string;
+    /** PayPal email for payouts */
+    payoutEmail?: string;
+}
+declare class AffiliatesClient {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * 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.
+     * Requires customer session token.
+     *
+     * @example
+     * ```typescript
+     * // Enroll with auto-generated code
+     * const affiliate = await stackbe.affiliates.enroll();
+     * 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.
+     *
+     * @example
+     * ```typescript
+     * const { commissions, total } = await stackbe.affiliates.getCommissions();
+     *
+     * commissions.forEach((c) => {
+     *   console.log(`$${(c.amount / 100).toFixed(2)} - ${c.status}`);
+     * });
+     * ```
+     */
+    getCommissions(): Promise<AffiliateCommissionsResponse>;
+    /**
+     * 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 });
+     * }
+     * ```
+     */
+    trackReferral(code: string, referralUrl?: string): Promise<TrackReferralResponse>;
+}
+
+interface EarlyAccessSignup {
+    id: string;
+    status: 'new' | 'invited' | 'converted' | 'archived';
+    email: string;
+    name?: string;
+    createdAt: string;
+}
+interface CreateEarlyAccessSignupOptions {
+    email: string;
+    name?: string;
+    note?: string;
+    metadata?: Record<string, any>;
+}
+interface EarlyAccessSignupListResponse {
+    items: Array<{
+        id: string;
+        email: string;
+        name?: string;
+        status: string;
+        metadata?: Record<string, any>;
+        createdAt: string;
+    }>;
+    page: number;
+    limit: number;
+    total: number;
+    hasMore: boolean;
+}
+interface ListEarlyAccessOptions {
+    status?: 'new' | 'invited' | 'converted' | 'archived';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+declare class EarlyAccessClient {
+    private http;
+    private appId;
+    constructor(http: HttpClient, appId: string);
+    /**
+     * Submit an early access / waitlist signup.
+     * This is a public endpoint - no auth required.
+     *
+     * @example
+     * ```typescript
+     * // Basic signup
+     * const signup = await stackbe.earlyAccess.signup({
+     *   email: 'user@example.com',
+     * });
+     *
+     * // With additional info
+     * const signup = await stackbe.earlyAccess.signup({
+     *   email: 'user@example.com',
+     *   name: 'John Doe',
+     *   note: 'Interested in enterprise features',
+     *   metadata: { source: 'landing_page', campaign: 'launch' },
+     * });
+     *
+     * console.log(`Signup ID: ${signup.id}`);
+     * ```
+     */
+    signup(options: CreateEarlyAccessSignupOptions): Promise<EarlyAccessSignup>;
+    /**
+     * List early access signups.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * // Get all signups
+     * const { items, total } = await stackbe.earlyAccess.list();
+     *
+     * // Filter by status
+     * const newSignups = await stackbe.earlyAccess.list({ status: 'new' });
+     *
+     * // Search by email
+     * const results = await stackbe.earlyAccess.list({ search: 'example.com' });
+     *
+     * // Paginate
+     * const page2 = await stackbe.earlyAccess.list({ offset: 50, limit: 50 });
+     * ```
+     */
+    list(options?: ListEarlyAccessOptions): Promise<EarlyAccessSignupListResponse>;
+    /**
+     * Get a specific early access signup.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * const signup = await stackbe.earlyAccess.get('signup_123');
+     * console.log(`${signup.email} - ${signup.status}`);
+     * ```
+     */
+    get(signupId: string): Promise<EarlyAccessSignup>;
+    /**
+     * Update the status of an early access signup.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * // Mark as invited
+     * await stackbe.earlyAccess.updateStatus('signup_123', 'invited');
+     *
+     * // Mark as converted (user signed up)
+     * await stackbe.earlyAccess.updateStatus('signup_123', 'converted');
+     *
+     * // Archive
+     * await stackbe.earlyAccess.updateStatus('signup_123', 'archived');
+     * ```
+     */
+    updateStatus(signupId: string, status: 'new' | 'invited' | 'converted' | 'archived'): Promise<EarlyAccessSignup>;
+}
+
 declare class StackBE {
     private http;
     private appId;
@@ -1676,6 +1922,10 @@ declare class StackBE {
     readonly products: ProductsClient;
     /** Feature requests and voting */
     readonly featureRequests: FeatureRequestsClient;
+    /** Affiliate program (customer-facing) */
+    readonly affiliates: AffiliatesClient;
+    /** Early access / waitlist signups */
+    readonly earlyAccess: EarlyAccessClient;
     /**
      * Create a new StackBE client.
      *
@@ -1776,4 +2026,4 @@ declare class StackBE {
     }): (req: any, res: any, next: any) => Promise<any>;
 }
 
-export { type AddMemberOptions, type AnyWebhookEvent, AuthClient, type CancelSubscriptionOptions, type CancelSubscriptionResponse, type CheckEntitlementResponse, type CheckUsageResponse, CheckoutClient, type CheckoutSessionResponse, type CreateCheckoutOptions, type CreateCustomerOptions, type CreateFeatureRequestOptions, type CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerFeatureActivity, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestListResponse, FeatureRequestsClient, type InterestedCustomer, type InterestedCustomersResponse, type InviteMemberOptions, 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 SubscriptionRenewedEvent, type SubscriptionUpdatedEvent, type SubscriptionWebhookPayload, type SubscriptionWithPlan, SubscriptionsClient, 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 CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EarlyAccessClient, type EarlyAccessSignup, type EarlyAccessSignupListResponse, type EnrollOptions, EntitlementsClient, type EntitlementsResponse, type FeatureRequest, type FeatureRequestComment, type FeatureRequestListResponse, FeatureRequestsClient, 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 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

@@ -20,9 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AffiliatesClient: () => AffiliatesClient,
   AuthClient: () => AuthClient,
   CheckoutClient: () => CheckoutClient,
   CustomersClient: () => CustomersClient,
+  EarlyAccessClient: () => EarlyAccessClient,
   EntitlementsClient: () => EntitlementsClient,
   FeatureRequestsClient: () => FeatureRequestsClient,
   OrganizationsClient: () => OrganizationsClient,
@@ -1694,6 +1696,213 @@ var FeatureRequestsClient = class {
   }
 };
 
+// src/affiliates.ts
+var AffiliatesClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * 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.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * // Enroll with auto-generated code
+   * const affiliate = await stackbe.affiliates.enroll();
+   * 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 = {}) {
+    return this.http.post("/v1/affiliate/enroll", options);
+  }
+  /**
+   * 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");
+  }
+  /**
+   * 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", {
+      code,
+      referralUrl
+    });
+  }
+};
+
+// src/early-access.ts
+var EarlyAccessClient = class {
+  constructor(http, appId) {
+    this.http = http;
+    this.appId = appId;
+  }
+  /**
+   * Submit an early access / waitlist signup.
+   * This is a public endpoint - no auth required.
+   *
+   * @example
+   * ```typescript
+   * // Basic signup
+   * const signup = await stackbe.earlyAccess.signup({
+   *   email: 'user@example.com',
+   * });
+   *
+   * // With additional info
+   * const signup = await stackbe.earlyAccess.signup({
+   *   email: 'user@example.com',
+   *   name: 'John Doe',
+   *   note: 'Interested in enterprise features',
+   *   metadata: { source: 'landing_page', campaign: 'launch' },
+   * });
+   *
+   * console.log(`Signup ID: ${signup.id}`);
+   * ```
+   */
+  async signup(options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/early-access/signups`,
+      options
+    );
+  }
+  // ==================== Admin Methods ====================
+  /**
+   * List early access signups.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * // Get all signups
+   * const { items, total } = await stackbe.earlyAccess.list();
+   *
+   * // Filter by status
+   * const newSignups = await stackbe.earlyAccess.list({ status: 'new' });
+   *
+   * // Search by email
+   * const results = await stackbe.earlyAccess.list({ search: 'example.com' });
+   *
+   * // Paginate
+   * const page2 = await stackbe.earlyAccess.list({ offset: 50, limit: 50 });
+   * ```
+   */
+  async list(options = {}) {
+    const params = {};
+    if (options.status) params.status = options.status;
+    if (options.search) params.search = options.search;
+    if (options.limit) params.limit = options.limit;
+    if (options.offset) params.offset = options.offset;
+    return this.http.get(
+      `/v1/apps/${this.appId}/early-access/signups`,
+      params
+    );
+  }
+  /**
+   * Get a specific early access signup.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * const signup = await stackbe.earlyAccess.get('signup_123');
+   * console.log(`${signup.email} - ${signup.status}`);
+   * ```
+   */
+  async get(signupId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/early-access/signups/${signupId}`
+    );
+  }
+  /**
+   * Update the status of an early access signup.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * // Mark as invited
+   * await stackbe.earlyAccess.updateStatus('signup_123', 'invited');
+   *
+   * // Mark as converted (user signed up)
+   * await stackbe.earlyAccess.updateStatus('signup_123', 'converted');
+   *
+   * // Archive
+   * await stackbe.earlyAccess.updateStatus('signup_123', 'archived');
+   * ```
+   */
+  async updateStatus(signupId, status) {
+    return this.http.patch(
+      `/v1/apps/${this.appId}/early-access/signups/${signupId}`,
+      { status }
+    );
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.stackbe.io";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1757,6 +1966,8 @@ var StackBE = class {
     this.plans = new PlansClient(this.http);
     this.products = new ProductsClient(this.http, config.appId);
     this.featureRequests = new FeatureRequestsClient(this.http, config.appId);
+    this.affiliates = new AffiliatesClient(this.http);
+    this.earlyAccess = new EarlyAccessClient(this.http, config.appId);
   }
   /**
    * Create a middleware for Express that tracks usage automatically.
@@ -1890,9 +2101,11 @@ var StackBE = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AffiliatesClient,
   AuthClient,
   CheckoutClient,
   CustomersClient,
+  EarlyAccessClient,
   EntitlementsClient,
   FeatureRequestsClient,
   OrganizationsClient,

package/dist/index.mjs

@@ -1657,6 +1657,213 @@ var FeatureRequestsClient = class {
   }
 };
 
+// src/affiliates.ts
+var AffiliatesClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * 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.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * // Enroll with auto-generated code
+   * const affiliate = await stackbe.affiliates.enroll();
+   * 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 = {}) {
+    return this.http.post("/v1/affiliate/enroll", options);
+  }
+  /**
+   * 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");
+  }
+  /**
+   * 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", {
+      code,
+      referralUrl
+    });
+  }
+};
+
+// src/early-access.ts
+var EarlyAccessClient = class {
+  constructor(http, appId) {
+    this.http = http;
+    this.appId = appId;
+  }
+  /**
+   * Submit an early access / waitlist signup.
+   * This is a public endpoint - no auth required.
+   *
+   * @example
+   * ```typescript
+   * // Basic signup
+   * const signup = await stackbe.earlyAccess.signup({
+   *   email: 'user@example.com',
+   * });
+   *
+   * // With additional info
+   * const signup = await stackbe.earlyAccess.signup({
+   *   email: 'user@example.com',
+   *   name: 'John Doe',
+   *   note: 'Interested in enterprise features',
+   *   metadata: { source: 'landing_page', campaign: 'launch' },
+   * });
+   *
+   * console.log(`Signup ID: ${signup.id}`);
+   * ```
+   */
+  async signup(options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/early-access/signups`,
+      options
+    );
+  }
+  // ==================== Admin Methods ====================
+  /**
+   * List early access signups.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * // Get all signups
+   * const { items, total } = await stackbe.earlyAccess.list();
+   *
+   * // Filter by status
+   * const newSignups = await stackbe.earlyAccess.list({ status: 'new' });
+   *
+   * // Search by email
+   * const results = await stackbe.earlyAccess.list({ search: 'example.com' });
+   *
+   * // Paginate
+   * const page2 = await stackbe.earlyAccess.list({ offset: 50, limit: 50 });
+   * ```
+   */
+  async list(options = {}) {
+    const params = {};
+    if (options.status) params.status = options.status;
+    if (options.search) params.search = options.search;
+    if (options.limit) params.limit = options.limit;
+    if (options.offset) params.offset = options.offset;
+    return this.http.get(
+      `/v1/apps/${this.appId}/early-access/signups`,
+      params
+    );
+  }
+  /**
+   * Get a specific early access signup.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * const signup = await stackbe.earlyAccess.get('signup_123');
+   * console.log(`${signup.email} - ${signup.status}`);
+   * ```
+   */
+  async get(signupId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/early-access/signups/${signupId}`
+    );
+  }
+  /**
+   * Update the status of an early access signup.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * // Mark as invited
+   * await stackbe.earlyAccess.updateStatus('signup_123', 'invited');
+   *
+   * // Mark as converted (user signed up)
+   * await stackbe.earlyAccess.updateStatus('signup_123', 'converted');
+   *
+   * // Archive
+   * await stackbe.earlyAccess.updateStatus('signup_123', 'archived');
+   * ```
+   */
+  async updateStatus(signupId, status) {
+    return this.http.patch(
+      `/v1/apps/${this.appId}/early-access/signups/${signupId}`,
+      { status }
+    );
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.stackbe.io";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1720,6 +1927,8 @@ var StackBE = class {
     this.plans = new PlansClient(this.http);
     this.products = new ProductsClient(this.http, config.appId);
     this.featureRequests = new FeatureRequestsClient(this.http, config.appId);
+    this.affiliates = new AffiliatesClient(this.http);
+    this.earlyAccess = new EarlyAccessClient(this.http, config.appId);
   }
   /**
    * Create a middleware for Express that tracks usage automatically.
@@ -1852,9 +2061,11 @@ var StackBE = class {
   }
 };
 export {
+  AffiliatesClient,
   AuthClient,
   CheckoutClient,
   CustomersClient,
+  EarlyAccessClient,
   EntitlementsClient,
   FeatureRequestsClient,
   OrganizationsClient,

package/package.json

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