@stackbe/sdk 0.6.5 → 0.7.1

package/README.md

@@ -549,9 +549,22 @@ stackbe.auth.invalidateSession(token);
 stackbe.auth.clearCache(); // Clear all
 ```
 
-### Environment-Aware Redirects
+### Magic Link Callback URLs
 
-Auto-detect development environment for magic link redirects:
+**Recommended approach**: Pass the callback URL explicitly for maximum reliability:
+
+```typescript
+// Determine callback URL based on your environment
+const callbackUrl = process.env.NODE_ENV === 'production'
+  ? 'https://myapp.com/auth/callback'
+  : 'http://localhost:3000/auth/callback';
+
+await stackbe.auth.sendMagicLink('user@example.com', {
+  redirectUrl: callbackUrl,
+});
+```
+
+**Alternative**: Use `devCallbackUrl` for automatic detection (uses `devCallbackUrl` when `NODE_ENV !== 'production'`):
 
 ```typescript
 const stackbe = new StackBE({
@@ -560,17 +573,18 @@ const stackbe = new StackBE({
   devCallbackUrl: 'http://localhost:3000/auth/callback',
 });
 
-// In development (NODE_ENV !== 'production'), uses devCallbackUrl automatically
+// In development, uses devCallbackUrl automatically
 await stackbe.auth.sendMagicLink('user@example.com');
-// Redirects to: http://localhost:3000/auth/callback
 
-// In production, uses your configured auth callback URL
-// Or pass explicit redirectUrl to override
-await stackbe.auth.sendMagicLink('user@example.com', {
-  redirectUrl: 'https://myapp.com/custom-callback',
-});
+// In production, falls back to app settings callback URL
+// Explicit redirectUrl always takes priority if provided
 ```
 
+**Notes:**
+- `devCallbackUrl` only activates when `NODE_ENV !== 'production'`
+- Explicit `redirectUrl` parameter always takes priority
+- For predictable behavior, use the explicit approach above
+
 ## Webhooks
 
 Typed webhook payloads for handling StackBE events:

package/dist/index.d.mts

@@ -340,7 +340,7 @@ interface ListProductsOptions {
     appId?: string;
 }
 interface CreateCheckoutOptions {
-    /** Customer ID or email */
+    /** Customer ID or object with email. Use string for existing customer ID, object for email-based lookup/creation */
     customer: string | {
         email: string;
         name?: string;
@@ -351,6 +351,8 @@ interface CreateCheckoutOptions {
     successUrl: string;
     /** URL to redirect if checkout is canceled */
     cancelUrl?: string;
+    /** Organization ID for org-level subscriptions. Customer must be owner/admin of the org. */
+    organizationId?: string;
     /** Allow promotion codes */
     allowPromotionCodes?: boolean;
     /** Trial period in days */
@@ -825,7 +827,7 @@ declare class CheckoutClient {
      *
      * @example
      * ```typescript
-     * // With new customer (will be created)
+     * // With customer email (looks up or creates customer)
      * const { url } = await stackbe.checkout.createSession({
      *   customer: { email: 'user@example.com', name: 'John' },
      *   planId: 'plan_pro_monthly',
@@ -833,6 +835,18 @@ declare class CheckoutClient {
      *   trialDays: 14,
      * });
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Organization-level subscription (B2B)
+     * const { url } = await stackbe.checkout.createSession({
+     *   customer: 'cust_123',
+     *   organizationId: 'org_456',  // Customer must be owner/admin
+     *   planId: 'plan_team',
+     *   successUrl: 'https://myapp.com/success',
+     *   cancelUrl: 'https://myapp.com/pricing',
+     * });
+     * ```
      */
     createSession(options: CreateCheckoutOptions): Promise<CheckoutSessionResponse>;
     /**
@@ -1375,6 +1389,232 @@ declare class ProductsClient {
     get(productId: string): Promise<Product>;
 }
 
+interface FeatureRequest {
+    id: string;
+    title: string;
+    description?: string;
+    status: 'new' | 'under_review' | 'planned' | 'in_progress' | 'completed' | 'declined';
+    category?: string;
+    authorId: string;
+    authorEmail: string;
+    voteCount: number;
+    hasVoted?: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface FeatureRequestComment {
+    id: string;
+    customerEmail: string;
+    content: string;
+    isAdminReply: boolean;
+    createdAt: string;
+}
+interface CreateFeatureRequestOptions {
+    title: string;
+    description?: string;
+    category?: string;
+}
+interface ListFeatureRequestsOptions {
+    status?: 'new' | 'under_review' | 'planned' | 'in_progress' | 'completed' | 'declined';
+    category?: string;
+    sortBy?: 'newest' | 'votes' | 'recent_activity';
+    limit?: number;
+    offset?: number;
+}
+interface FeatureRequestListResponse {
+    data: FeatureRequest[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface InterestedCustomer {
+    customerId: string;
+    email: string;
+    votedAt?: string;
+    submittedAt?: string;
+}
+interface InterestedCustomersResponse {
+    featureRequestId: string;
+    title: string;
+    status: string;
+    author: {
+        customerId: string;
+        email: string;
+        submittedAt: string;
+    };
+    voters: InterestedCustomer[];
+    totalInterested: number;
+}
+interface CustomerFeatureActivity {
+    customerId: string;
+    submitted: Array<{
+        id: string;
+        title: string;
+        status: string;
+        voteCount: number;
+        submittedAt: string;
+    }>;
+    votedOn: Array<{
+        id: string;
+        title: string;
+        status: string;
+        voteCount: number;
+        votedAt: string;
+    }>;
+    totalSubmitted: number;
+    totalVotes: number;
+}
+declare class FeatureRequestsClient {
+    private http;
+    private appId;
+    constructor(http: HttpClient, appId: string);
+    /**
+     * List feature requests for the app.
+     *
+     * @example
+     * ```typescript
+     * // Get all feature requests
+     * const { data, total } = await stackbe.featureRequests.list();
+     *
+     * // Filter by status
+     * const planned = await stackbe.featureRequests.list({ status: 'planned' });
+     *
+     * // Sort by votes
+     * const popular = await stackbe.featureRequests.list({ sortBy: 'votes' });
+     * ```
+     */
+    list(options?: ListFeatureRequestsOptions): Promise<FeatureRequestListResponse>;
+    /**
+     * Submit a new feature request.
+     * Requires customer session token.
+     *
+     * @example
+     * ```typescript
+     * const request = await stackbe.featureRequests.create({
+     *   title: 'Dark mode support',
+     *   description: 'Would love to have a dark theme option',
+     *   category: 'UI',
+     * });
+     * ```
+     */
+    create(options: CreateFeatureRequestOptions): Promise<FeatureRequest>;
+    /**
+     * Get a specific feature request by ID.
+     *
+     * @example
+     * ```typescript
+     * const request = await stackbe.featureRequests.get('req_123');
+     * console.log(`${request.title} has ${request.voteCount} votes`);
+     * ```
+     */
+    get(requestId: string): Promise<FeatureRequest & {
+        comments: FeatureRequestComment[];
+    }>;
+    /**
+     * Upvote a feature request.
+     * Requires customer session token. Idempotent.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.vote('req_123');
+     * ```
+     */
+    vote(requestId: string): Promise<{
+        success?: boolean;
+        alreadyVoted?: boolean;
+        voteCount: number;
+    }>;
+    /**
+     * Remove your vote from a feature request.
+     * Requires customer session token.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.removeVote('req_123');
+     * ```
+     */
+    removeVote(requestId: string): Promise<{
+        success: boolean;
+        voteCount: number;
+    }>;
+    /**
+     * Add a comment to a feature request.
+     * Requires customer session token.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.addComment('req_123', {
+     *   content: 'This would be really helpful for my workflow!',
+     * });
+     * ```
+     */
+    addComment(requestId: string, options: {
+        content: string;
+    }): Promise<FeatureRequestComment>;
+    /**
+     * Update a feature request status or category.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.update('req_123', {
+     *   status: 'planned',
+     *   category: 'Core Features',
+     * });
+     * ```
+     */
+    update(requestId: string, options: {
+        status?: string;
+        category?: string;
+    }): Promise<FeatureRequest>;
+    /**
+     * Delete a feature request.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.delete('req_123');
+     * ```
+     */
+    delete(requestId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get all customers interested in a feature request (author + voters).
+     * Useful for user research or notifying users when the feature ships.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * const { author, voters, totalInterested } = await stackbe.featureRequests.getInterestedCustomers('req_123');
+     *
+     * // Notify all interested users
+     * const emails = [author.email, ...voters.map(v => v.email)];
+     * await sendNotification(emails, 'Your requested feature is now live!');
+     * ```
+     */
+    getInterestedCustomers(requestId: string): Promise<InterestedCustomersResponse>;
+    /**
+     * Get a customer's feature request activity (requests submitted + votes).
+     * Useful for displaying on customer profile.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * const activity = await stackbe.featureRequests.getCustomerActivity('cust_123');
+     *
+     * console.log(`Submitted ${activity.totalSubmitted} requests`);
+     * console.log(`Voted on ${activity.totalVotes} requests`);
+     *
+     * // Show their most wanted features
+     * activity.votedOn.forEach(r => {
+     *   console.log(`- ${r.title} (${r.status})`);
+     * });
+     * ```
+     */
+    getCustomerActivity(customerId: string): Promise<CustomerFeatureActivity>;
+}
+
 declare class StackBE {
     private http;
     private appId;
@@ -1396,6 +1636,8 @@ declare class StackBE {
     readonly plans: PlansClient;
     /** Products */
     readonly products: ProductsClient;
+    /** Feature requests and voting */
+    readonly featureRequests: FeatureRequestsClient;
     /**
      * Create a new StackBE client.
      *
@@ -1496,4 +1738,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 CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type InviteMemberOptions, 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 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 };

package/dist/index.d.ts

@@ -340,7 +340,7 @@ interface ListProductsOptions {
     appId?: string;
 }
 interface CreateCheckoutOptions {
-    /** Customer ID or email */
+    /** Customer ID or object with email. Use string for existing customer ID, object for email-based lookup/creation */
     customer: string | {
         email: string;
         name?: string;
@@ -351,6 +351,8 @@ interface CreateCheckoutOptions {
     successUrl: string;
     /** URL to redirect if checkout is canceled */
     cancelUrl?: string;
+    /** Organization ID for org-level subscriptions. Customer must be owner/admin of the org. */
+    organizationId?: string;
     /** Allow promotion codes */
     allowPromotionCodes?: boolean;
     /** Trial period in days */
@@ -825,7 +827,7 @@ declare class CheckoutClient {
      *
      * @example
      * ```typescript
-     * // With new customer (will be created)
+     * // With customer email (looks up or creates customer)
      * const { url } = await stackbe.checkout.createSession({
      *   customer: { email: 'user@example.com', name: 'John' },
      *   planId: 'plan_pro_monthly',
@@ -833,6 +835,18 @@ declare class CheckoutClient {
      *   trialDays: 14,
      * });
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Organization-level subscription (B2B)
+     * const { url } = await stackbe.checkout.createSession({
+     *   customer: 'cust_123',
+     *   organizationId: 'org_456',  // Customer must be owner/admin
+     *   planId: 'plan_team',
+     *   successUrl: 'https://myapp.com/success',
+     *   cancelUrl: 'https://myapp.com/pricing',
+     * });
+     * ```
      */
     createSession(options: CreateCheckoutOptions): Promise<CheckoutSessionResponse>;
     /**
@@ -1375,6 +1389,232 @@ declare class ProductsClient {
     get(productId: string): Promise<Product>;
 }
 
+interface FeatureRequest {
+    id: string;
+    title: string;
+    description?: string;
+    status: 'new' | 'under_review' | 'planned' | 'in_progress' | 'completed' | 'declined';
+    category?: string;
+    authorId: string;
+    authorEmail: string;
+    voteCount: number;
+    hasVoted?: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface FeatureRequestComment {
+    id: string;
+    customerEmail: string;
+    content: string;
+    isAdminReply: boolean;
+    createdAt: string;
+}
+interface CreateFeatureRequestOptions {
+    title: string;
+    description?: string;
+    category?: string;
+}
+interface ListFeatureRequestsOptions {
+    status?: 'new' | 'under_review' | 'planned' | 'in_progress' | 'completed' | 'declined';
+    category?: string;
+    sortBy?: 'newest' | 'votes' | 'recent_activity';
+    limit?: number;
+    offset?: number;
+}
+interface FeatureRequestListResponse {
+    data: FeatureRequest[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface InterestedCustomer {
+    customerId: string;
+    email: string;
+    votedAt?: string;
+    submittedAt?: string;
+}
+interface InterestedCustomersResponse {
+    featureRequestId: string;
+    title: string;
+    status: string;
+    author: {
+        customerId: string;
+        email: string;
+        submittedAt: string;
+    };
+    voters: InterestedCustomer[];
+    totalInterested: number;
+}
+interface CustomerFeatureActivity {
+    customerId: string;
+    submitted: Array<{
+        id: string;
+        title: string;
+        status: string;
+        voteCount: number;
+        submittedAt: string;
+    }>;
+    votedOn: Array<{
+        id: string;
+        title: string;
+        status: string;
+        voteCount: number;
+        votedAt: string;
+    }>;
+    totalSubmitted: number;
+    totalVotes: number;
+}
+declare class FeatureRequestsClient {
+    private http;
+    private appId;
+    constructor(http: HttpClient, appId: string);
+    /**
+     * List feature requests for the app.
+     *
+     * @example
+     * ```typescript
+     * // Get all feature requests
+     * const { data, total } = await stackbe.featureRequests.list();
+     *
+     * // Filter by status
+     * const planned = await stackbe.featureRequests.list({ status: 'planned' });
+     *
+     * // Sort by votes
+     * const popular = await stackbe.featureRequests.list({ sortBy: 'votes' });
+     * ```
+     */
+    list(options?: ListFeatureRequestsOptions): Promise<FeatureRequestListResponse>;
+    /**
+     * Submit a new feature request.
+     * Requires customer session token.
+     *
+     * @example
+     * ```typescript
+     * const request = await stackbe.featureRequests.create({
+     *   title: 'Dark mode support',
+     *   description: 'Would love to have a dark theme option',
+     *   category: 'UI',
+     * });
+     * ```
+     */
+    create(options: CreateFeatureRequestOptions): Promise<FeatureRequest>;
+    /**
+     * Get a specific feature request by ID.
+     *
+     * @example
+     * ```typescript
+     * const request = await stackbe.featureRequests.get('req_123');
+     * console.log(`${request.title} has ${request.voteCount} votes`);
+     * ```
+     */
+    get(requestId: string): Promise<FeatureRequest & {
+        comments: FeatureRequestComment[];
+    }>;
+    /**
+     * Upvote a feature request.
+     * Requires customer session token. Idempotent.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.vote('req_123');
+     * ```
+     */
+    vote(requestId: string): Promise<{
+        success?: boolean;
+        alreadyVoted?: boolean;
+        voteCount: number;
+    }>;
+    /**
+     * Remove your vote from a feature request.
+     * Requires customer session token.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.removeVote('req_123');
+     * ```
+     */
+    removeVote(requestId: string): Promise<{
+        success: boolean;
+        voteCount: number;
+    }>;
+    /**
+     * Add a comment to a feature request.
+     * Requires customer session token.
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.addComment('req_123', {
+     *   content: 'This would be really helpful for my workflow!',
+     * });
+     * ```
+     */
+    addComment(requestId: string, options: {
+        content: string;
+    }): Promise<FeatureRequestComment>;
+    /**
+     * Update a feature request status or category.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.update('req_123', {
+     *   status: 'planned',
+     *   category: 'Core Features',
+     * });
+     * ```
+     */
+    update(requestId: string, options: {
+        status?: string;
+        category?: string;
+    }): Promise<FeatureRequest>;
+    /**
+     * Delete a feature request.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * await stackbe.featureRequests.delete('req_123');
+     * ```
+     */
+    delete(requestId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get all customers interested in a feature request (author + voters).
+     * Useful for user research or notifying users when the feature ships.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * const { author, voters, totalInterested } = await stackbe.featureRequests.getInterestedCustomers('req_123');
+     *
+     * // Notify all interested users
+     * const emails = [author.email, ...voters.map(v => v.email)];
+     * await sendNotification(emails, 'Your requested feature is now live!');
+     * ```
+     */
+    getInterestedCustomers(requestId: string): Promise<InterestedCustomersResponse>;
+    /**
+     * Get a customer's feature request activity (requests submitted + votes).
+     * Useful for displaying on customer profile.
+     * Requires API key (admin).
+     *
+     * @example
+     * ```typescript
+     * const activity = await stackbe.featureRequests.getCustomerActivity('cust_123');
+     *
+     * console.log(`Submitted ${activity.totalSubmitted} requests`);
+     * console.log(`Voted on ${activity.totalVotes} requests`);
+     *
+     * // Show their most wanted features
+     * activity.votedOn.forEach(r => {
+     *   console.log(`- ${r.title} (${r.status})`);
+     * });
+     * ```
+     */
+    getCustomerActivity(customerId: string): Promise<CustomerFeatureActivity>;
+}
+
 declare class StackBE {
     private http;
     private appId;
@@ -1396,6 +1636,8 @@ declare class StackBE {
     readonly plans: PlansClient;
     /** Products */
     readonly products: ProductsClient;
+    /** Feature requests and voting */
+    readonly featureRequests: FeatureRequestsClient;
     /**
      * Create a new StackBE client.
      *
@@ -1496,4 +1738,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 CreateOrganizationOptions, type Customer, type CustomerCreatedEvent, type CustomerUpdatedEvent, type CustomerUsageResponse, type CustomerWebhookPayload, type CustomerWithSubscription, CustomersClient, EntitlementsClient, type EntitlementsResponse, type InviteMemberOptions, 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 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 };

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   CheckoutClient: () => CheckoutClient,
   CustomersClient: () => CustomersClient,
   EntitlementsClient: () => EntitlementsClient,
+  FeatureRequestsClient: () => FeatureRequestsClient,
   OrganizationsClient: () => OrganizationsClient,
   PlansClient: () => PlansClient,
   ProductsClient: () => ProductsClient,
@@ -620,7 +621,7 @@ var CheckoutClient = class {
    *
    * @example
    * ```typescript
-   * // With new customer (will be created)
+   * // With customer email (looks up or creates customer)
    * const { url } = await stackbe.checkout.createSession({
    *   customer: { email: 'user@example.com', name: 'John' },
    *   planId: 'plan_pro_monthly',
@@ -628,6 +629,18 @@ var CheckoutClient = class {
    *   trialDays: 14,
    * });
    * ```
+   *
+   * @example
+   * ```typescript
+   * // Organization-level subscription (B2B)
+   * const { url } = await stackbe.checkout.createSession({
+   *   customer: 'cust_123',
+   *   organizationId: 'org_456',  // Customer must be owner/admin
+   *   planId: 'plan_team',
+   *   successUrl: 'https://myapp.com/success',
+   *   cancelUrl: 'https://myapp.com/pricing',
+   * });
+   * ```
    */
   async createSession(options) {
     const body = {
@@ -635,15 +648,25 @@ var CheckoutClient = class {
       planId: options.planId,
       successUrl: options.successUrl,
       cancelUrl: options.cancelUrl,
+      organizationId: options.organizationId,
       allowPromotionCodes: options.allowPromotionCodes,
       trialDays: options.trialDays,
       metadata: options.metadata
     };
+    if (!options.customer) {
+      throw new Error(
+        'customer is required. Use customer: "cust_xxx" for existing customer ID, or customer: { email: "user@example.com" } for email-based lookup.'
+      );
+    }
     if (typeof options.customer === "string") {
       body.customerId = options.customer;
-    } else {
+    } else if (options.customer.email) {
       body.customerEmail = options.customer.email;
       body.customerName = options.customer.name;
+    } else {
+      throw new Error(
+        'customer.email is required when using object form. Use customer: { email: "user@example.com" }'
+      );
     }
     return this.http.post("/v1/checkout/session", body);
   }
@@ -1438,6 +1461,194 @@ var ProductsClient = class {
   }
 };
 
+// src/feature-requests.ts
+var FeatureRequestsClient = class {
+  constructor(http, appId) {
+    this.http = http;
+    this.appId = appId;
+  }
+  /**
+   * List feature requests for the app.
+   *
+   * @example
+   * ```typescript
+   * // Get all feature requests
+   * const { data, total } = await stackbe.featureRequests.list();
+   *
+   * // Filter by status
+   * const planned = await stackbe.featureRequests.list({ status: 'planned' });
+   *
+   * // Sort by votes
+   * const popular = await stackbe.featureRequests.list({ sortBy: 'votes' });
+   * ```
+   */
+  async list(options = {}) {
+    const params = {};
+    if (options.status) params.status = options.status;
+    if (options.category) params.category = options.category;
+    if (options.sortBy) params.sortBy = options.sortBy;
+    if (options.limit) params.limit = options.limit;
+    if (options.offset) params.offset = options.offset;
+    return this.http.get(
+      `/v1/apps/${this.appId}/feature-requests`,
+      params
+    );
+  }
+  /**
+   * Submit a new feature request.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * const request = await stackbe.featureRequests.create({
+   *   title: 'Dark mode support',
+   *   description: 'Would love to have a dark theme option',
+   *   category: 'UI',
+   * });
+   * ```
+   */
+  async create(options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/feature-requests`,
+      options
+    );
+  }
+  /**
+   * Get a specific feature request by ID.
+   *
+   * @example
+   * ```typescript
+   * const request = await stackbe.featureRequests.get('req_123');
+   * console.log(`${request.title} has ${request.voteCount} votes`);
+   * ```
+   */
+  async get(requestId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}`
+    );
+  }
+  /**
+   * Upvote a feature request.
+   * Requires customer session token. Idempotent.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.vote('req_123');
+   * ```
+   */
+  async vote(requestId) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`
+    );
+  }
+  /**
+   * Remove your vote from a feature request.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.removeVote('req_123');
+   * ```
+   */
+  async removeVote(requestId) {
+    return this.http.delete(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`
+    );
+  }
+  /**
+   * Add a comment to a feature request.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.addComment('req_123', {
+   *   content: 'This would be really helpful for my workflow!',
+   * });
+   * ```
+   */
+  async addComment(requestId, options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/comments`,
+      options
+    );
+  }
+  // ==================== Admin Methods ====================
+  /**
+   * Update a feature request status or category.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.update('req_123', {
+   *   status: 'planned',
+   *   category: 'Core Features',
+   * });
+   * ```
+   */
+  async update(requestId, options) {
+    return this.http.patch(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}`,
+      options
+    );
+  }
+  /**
+   * Delete a feature request.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.delete('req_123');
+   * ```
+   */
+  async delete(requestId) {
+    return this.http.delete(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}`
+    );
+  }
+  /**
+   * Get all customers interested in a feature request (author + voters).
+   * Useful for user research or notifying users when the feature ships.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * const { author, voters, totalInterested } = await stackbe.featureRequests.getInterestedCustomers('req_123');
+   *
+   * // Notify all interested users
+   * const emails = [author.email, ...voters.map(v => v.email)];
+   * await sendNotification(emails, 'Your requested feature is now live!');
+   * ```
+   */
+  async getInterestedCustomers(requestId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/interested`
+    );
+  }
+  /**
+   * Get a customer's feature request activity (requests submitted + votes).
+   * Useful for displaying on customer profile.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * const activity = await stackbe.featureRequests.getCustomerActivity('cust_123');
+   *
+   * console.log(`Submitted ${activity.totalSubmitted} requests`);
+   * console.log(`Voted on ${activity.totalVotes} requests`);
+   *
+   * // Show their most wanted features
+   * activity.votedOn.forEach(r => {
+   *   console.log(`- ${r.title} (${r.status})`);
+   * });
+   * ```
+   */
+  async getCustomerActivity(customerId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/feature-requests/customer/${customerId}/activity`
+    );
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.stackbe.io";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1500,6 +1711,7 @@ var StackBE = class {
     this.organizations = new OrganizationsClient(this.http, config.appId);
     this.plans = new PlansClient(this.http);
     this.products = new ProductsClient(this.http, config.appId);
+    this.featureRequests = new FeatureRequestsClient(this.http, config.appId);
   }
   /**
    * Create a middleware for Express that tracks usage automatically.
@@ -1637,6 +1849,7 @@ var StackBE = class {
   CheckoutClient,
   CustomersClient,
   EntitlementsClient,
+  FeatureRequestsClient,
   OrganizationsClient,
   PlansClient,
   ProductsClient,

package/dist/index.mjs

@@ -584,7 +584,7 @@ var CheckoutClient = class {
    *
    * @example
    * ```typescript
-   * // With new customer (will be created)
+   * // With customer email (looks up or creates customer)
    * const { url } = await stackbe.checkout.createSession({
    *   customer: { email: 'user@example.com', name: 'John' },
    *   planId: 'plan_pro_monthly',
@@ -592,6 +592,18 @@ var CheckoutClient = class {
    *   trialDays: 14,
    * });
    * ```
+   *
+   * @example
+   * ```typescript
+   * // Organization-level subscription (B2B)
+   * const { url } = await stackbe.checkout.createSession({
+   *   customer: 'cust_123',
+   *   organizationId: 'org_456',  // Customer must be owner/admin
+   *   planId: 'plan_team',
+   *   successUrl: 'https://myapp.com/success',
+   *   cancelUrl: 'https://myapp.com/pricing',
+   * });
+   * ```
    */
   async createSession(options) {
     const body = {
@@ -599,15 +611,25 @@ var CheckoutClient = class {
       planId: options.planId,
       successUrl: options.successUrl,
       cancelUrl: options.cancelUrl,
+      organizationId: options.organizationId,
       allowPromotionCodes: options.allowPromotionCodes,
       trialDays: options.trialDays,
       metadata: options.metadata
     };
+    if (!options.customer) {
+      throw new Error(
+        'customer is required. Use customer: "cust_xxx" for existing customer ID, or customer: { email: "user@example.com" } for email-based lookup.'
+      );
+    }
     if (typeof options.customer === "string") {
       body.customerId = options.customer;
-    } else {
+    } else if (options.customer.email) {
       body.customerEmail = options.customer.email;
       body.customerName = options.customer.name;
+    } else {
+      throw new Error(
+        'customer.email is required when using object form. Use customer: { email: "user@example.com" }'
+      );
     }
     return this.http.post("/v1/checkout/session", body);
   }
@@ -1402,6 +1424,194 @@ var ProductsClient = class {
   }
 };
 
+// src/feature-requests.ts
+var FeatureRequestsClient = class {
+  constructor(http, appId) {
+    this.http = http;
+    this.appId = appId;
+  }
+  /**
+   * List feature requests for the app.
+   *
+   * @example
+   * ```typescript
+   * // Get all feature requests
+   * const { data, total } = await stackbe.featureRequests.list();
+   *
+   * // Filter by status
+   * const planned = await stackbe.featureRequests.list({ status: 'planned' });
+   *
+   * // Sort by votes
+   * const popular = await stackbe.featureRequests.list({ sortBy: 'votes' });
+   * ```
+   */
+  async list(options = {}) {
+    const params = {};
+    if (options.status) params.status = options.status;
+    if (options.category) params.category = options.category;
+    if (options.sortBy) params.sortBy = options.sortBy;
+    if (options.limit) params.limit = options.limit;
+    if (options.offset) params.offset = options.offset;
+    return this.http.get(
+      `/v1/apps/${this.appId}/feature-requests`,
+      params
+    );
+  }
+  /**
+   * Submit a new feature request.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * const request = await stackbe.featureRequests.create({
+   *   title: 'Dark mode support',
+   *   description: 'Would love to have a dark theme option',
+   *   category: 'UI',
+   * });
+   * ```
+   */
+  async create(options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/feature-requests`,
+      options
+    );
+  }
+  /**
+   * Get a specific feature request by ID.
+   *
+   * @example
+   * ```typescript
+   * const request = await stackbe.featureRequests.get('req_123');
+   * console.log(`${request.title} has ${request.voteCount} votes`);
+   * ```
+   */
+  async get(requestId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}`
+    );
+  }
+  /**
+   * Upvote a feature request.
+   * Requires customer session token. Idempotent.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.vote('req_123');
+   * ```
+   */
+  async vote(requestId) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`
+    );
+  }
+  /**
+   * Remove your vote from a feature request.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.removeVote('req_123');
+   * ```
+   */
+  async removeVote(requestId) {
+    return this.http.delete(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`
+    );
+  }
+  /**
+   * Add a comment to a feature request.
+   * Requires customer session token.
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.addComment('req_123', {
+   *   content: 'This would be really helpful for my workflow!',
+   * });
+   * ```
+   */
+  async addComment(requestId, options) {
+    return this.http.post(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/comments`,
+      options
+    );
+  }
+  // ==================== Admin Methods ====================
+  /**
+   * Update a feature request status or category.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.update('req_123', {
+   *   status: 'planned',
+   *   category: 'Core Features',
+   * });
+   * ```
+   */
+  async update(requestId, options) {
+    return this.http.patch(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}`,
+      options
+    );
+  }
+  /**
+   * Delete a feature request.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * await stackbe.featureRequests.delete('req_123');
+   * ```
+   */
+  async delete(requestId) {
+    return this.http.delete(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}`
+    );
+  }
+  /**
+   * Get all customers interested in a feature request (author + voters).
+   * Useful for user research or notifying users when the feature ships.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * const { author, voters, totalInterested } = await stackbe.featureRequests.getInterestedCustomers('req_123');
+   *
+   * // Notify all interested users
+   * const emails = [author.email, ...voters.map(v => v.email)];
+   * await sendNotification(emails, 'Your requested feature is now live!');
+   * ```
+   */
+  async getInterestedCustomers(requestId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/interested`
+    );
+  }
+  /**
+   * Get a customer's feature request activity (requests submitted + votes).
+   * Useful for displaying on customer profile.
+   * Requires API key (admin).
+   *
+   * @example
+   * ```typescript
+   * const activity = await stackbe.featureRequests.getCustomerActivity('cust_123');
+   *
+   * console.log(`Submitted ${activity.totalSubmitted} requests`);
+   * console.log(`Voted on ${activity.totalVotes} requests`);
+   *
+   * // Show their most wanted features
+   * activity.votedOn.forEach(r => {
+   *   console.log(`- ${r.title} (${r.status})`);
+   * });
+   * ```
+   */
+  async getCustomerActivity(customerId) {
+    return this.http.get(
+      `/v1/apps/${this.appId}/feature-requests/customer/${customerId}/activity`
+    );
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.stackbe.io";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1464,6 +1674,7 @@ var StackBE = class {
     this.organizations = new OrganizationsClient(this.http, config.appId);
     this.plans = new PlansClient(this.http);
     this.products = new ProductsClient(this.http, config.appId);
+    this.featureRequests = new FeatureRequestsClient(this.http, config.appId);
   }
   /**
    * Create a middleware for Express that tracks usage automatically.
@@ -1600,6 +1811,7 @@ export {
   CheckoutClient,
   CustomersClient,
   EntitlementsClient,
+  FeatureRequestsClient,
   OrganizationsClient,
   PlansClient,
   ProductsClient,

package/package.json

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