@stackbe/sdk 0.6.4 → 0.7.1

package/dist/index.js

@@ -24,7 +24,10 @@ __export(index_exports, {
   CheckoutClient: () => CheckoutClient,
   CustomersClient: () => CustomersClient,
   EntitlementsClient: () => EntitlementsClient,
+  FeatureRequestsClient: () => FeatureRequestsClient,
   OrganizationsClient: () => OrganizationsClient,
+  PlansClient: () => PlansClient,
+  ProductsClient: () => ProductsClient,
   StackBE: () => StackBE,
   StackBEError: () => StackBEError,
   SubscriptionsClient: () => SubscriptionsClient,
@@ -618,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',
@@ -626,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 = {
@@ -633,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);
   }
@@ -1333,6 +1358,297 @@ var OrganizationsClient = class {
   }
 };
 
+// src/plans.ts
+var PlansClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all plans for the app.
+   *
+   * @example
+   * ```typescript
+   * // List all plans
+   * const plans = await stackbe.plans.list();
+   *
+   * // Filter by product
+   * const plans = await stackbe.plans.list({ productId: 'prod_123' });
+   *
+   * // Display in pricing page
+   * plans.forEach(plan => {
+   *   console.log(`${plan.name}: $${plan.priceCents / 100}/${plan.interval}`);
+   * });
+   * ```
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    if (options?.productId) {
+      params.set("productId", options.productId);
+    }
+    const query = params.toString();
+    return this.http.get(`/v1/plans${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get a plan by ID.
+   *
+   * @example
+   * ```typescript
+   * const plan = await stackbe.plans.get('plan_123');
+   * console.log(plan.name, plan.priceCents, plan.entitlements);
+   * ```
+   */
+  async get(planId) {
+    return this.http.get(`/v1/plans/${planId}`);
+  }
+  /**
+   * Get active plans only (excludes archived plans).
+   *
+   * @example
+   * ```typescript
+   * const activePlans = await stackbe.plans.getActive();
+   * ```
+   */
+  async getActive(options) {
+    const plans = await this.list(options);
+    return plans.filter((p) => p.status === "active");
+  }
+  /**
+   * Get plans sorted by price (ascending).
+   *
+   * @example
+   * ```typescript
+   * const plans = await stackbe.plans.listByPrice();
+   * // [Free, Starter, Pro, Enterprise]
+   * ```
+   */
+  async listByPrice(options) {
+    const plans = await this.getActive(options);
+    return plans.sort((a, b) => a.priceCents - b.priceCents);
+  }
+};
+var ProductsClient = class {
+  constructor(http, appId) {
+    this.http = http;
+    this.appId = appId;
+  }
+  /**
+   * List all products for the app.
+   *
+   * @example
+   * ```typescript
+   * const products = await stackbe.products.list();
+   * products.forEach(product => {
+   *   console.log(product.name, product.plans?.length, 'plans');
+   * });
+   * ```
+   */
+  async list(options) {
+    const params = new URLSearchParams();
+    params.set("appId", options?.appId ?? this.appId);
+    return this.http.get(`/v1/products?${params.toString()}`);
+  }
+  /**
+   * Get a product by ID.
+   *
+   * @example
+   * ```typescript
+   * const product = await stackbe.products.get('prod_123');
+   * console.log(product.name, product.description);
+   * ```
+   */
+  async get(productId) {
+    return this.http.get(`/v1/products/${productId}`);
+  }
+};
+
+// 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;
@@ -1393,6 +1709,9 @@ var StackBE = class {
       devCallbackUrl: config.devCallbackUrl
     });
     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.
@@ -1530,7 +1849,10 @@ var StackBE = class {
   CheckoutClient,
   CustomersClient,
   EntitlementsClient,
+  FeatureRequestsClient,
   OrganizationsClient,
+  PlansClient,
+  ProductsClient,
   StackBE,
   StackBEError,
   SubscriptionsClient,