@stackbe/sdk 0.7.2 → 0.7.4

package/dist/index.d.mts

@@ -779,9 +779,13 @@ declare class CustomersClient {
     /**
      * Send a magic link to a customer for passwordless authentication.
      *
+     * @deprecated Use `stackbe.auth.sendMagicLink()` instead, which uses the app-specific endpoint
+     * and supports dev callback URLs.
+     *
      * @example
      * ```typescript
-     * await stackbe.customers.sendMagicLink('user@example.com', {
+     * // Deprecated - use auth.sendMagicLink instead:
+     * await stackbe.auth.sendMagicLink('user@example.com', {
      *   redirectUrl: 'https://myapp.com/dashboard'
      * });
      * ```
@@ -793,10 +797,14 @@ declare class CustomersClient {
      * Get the current session for a customer token.
      * Use this to validate tokens and get customer data.
      *
+     * @deprecated Use `stackbe.auth.getSession()` instead, which includes caching,
+     * tenant/org context extraction, and proper error handling.
+     *
      * @example
      * ```typescript
-     * const session = await stackbe.customers.getSession(token);
-     * console.log(session.customer.email);
+     * // Deprecated - use auth.getSession instead:
+     * const session = await stackbe.auth.getSession(token);
+     * console.log(session.customerId);
      * console.log(session.entitlements);
      * ```
      */
@@ -1413,6 +1421,8 @@ interface CreateFeatureRequestOptions {
     title: string;
     description?: string;
     category?: string;
+    /** Customer ID for server-side creation with API key */
+    customerId?: string;
 }
 interface ListFeatureRequestsOptions {
     status?: 'new' | 'under_review' | 'planned' | 'in_progress' | 'completed' | 'declined';
@@ -1422,10 +1432,11 @@ interface ListFeatureRequestsOptions {
     offset?: number;
 }
 interface FeatureRequestListResponse {
-    data: FeatureRequest[];
+    items: FeatureRequest[];
     total: number;
     limit: number;
-    offset: number;
+    page: number;
+    hasMore: boolean;
 }
 interface InterestedCustomer {
     customerId: string;
@@ -1474,27 +1485,38 @@ declare class FeatureRequestsClient {
      * @example
      * ```typescript
      * // Get all feature requests
-     * const { data, total } = await stackbe.featureRequests.list();
+     * const { items, total, hasMore } = 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' });
+     *
+     * // Paginate
+     * const page2 = await stackbe.featureRequests.list({ offset: 50, limit: 50 });
      * ```
      */
     list(options?: ListFeatureRequestsOptions): Promise<FeatureRequestListResponse>;
     /**
      * Submit a new feature request.
-     * Requires customer session token.
+     * Requires customer session token, OR API key with customerId.
      *
      * @example
      * ```typescript
+     * // With customer session token
      * const request = await stackbe.featureRequests.create({
      *   title: 'Dark mode support',
      *   description: 'Would love to have a dark theme option',
      *   category: 'UI',
      * });
+     *
+     * // With API key (server-side)
+     * const request = await stackbe.featureRequests.create({
+     *   title: 'Dark mode support',
+     *   description: 'Would love to have a dark theme option',
+     *   customerId: 'cust_123',
+     * });
      * ```
      */
     create(options: CreateFeatureRequestOptions): Promise<FeatureRequest>;
@@ -1547,17 +1569,25 @@ declare class FeatureRequestsClient {
     }>;
     /**
      * Add a comment to a feature request.
-     * Requires customer session token.
+     * Requires customer session token, OR API key with customerId.
      *
      * @example
      * ```typescript
+     * // With customer session token
+     * await stackbe.featureRequests.addComment('req_123', {
+     *   content: 'This would be really helpful for my workflow!',
+     * });
+     *
+     * // With API key (server-side)
      * await stackbe.featureRequests.addComment('req_123', {
      *   content: 'This would be really helpful for my workflow!',
+     *   customerId: 'cust_456',
      * });
      * ```
      */
     addComment(requestId: string, options: {
         content: string;
+        customerId?: string;
     }): Promise<FeatureRequestComment>;
     /**
      * Update a feature request status or category.

package/dist/index.d.ts

@@ -779,9 +779,13 @@ declare class CustomersClient {
     /**
      * Send a magic link to a customer for passwordless authentication.
      *
+     * @deprecated Use `stackbe.auth.sendMagicLink()` instead, which uses the app-specific endpoint
+     * and supports dev callback URLs.
+     *
      * @example
      * ```typescript
-     * await stackbe.customers.sendMagicLink('user@example.com', {
+     * // Deprecated - use auth.sendMagicLink instead:
+     * await stackbe.auth.sendMagicLink('user@example.com', {
      *   redirectUrl: 'https://myapp.com/dashboard'
      * });
      * ```
@@ -793,10 +797,14 @@ declare class CustomersClient {
      * Get the current session for a customer token.
      * Use this to validate tokens and get customer data.
      *
+     * @deprecated Use `stackbe.auth.getSession()` instead, which includes caching,
+     * tenant/org context extraction, and proper error handling.
+     *
      * @example
      * ```typescript
-     * const session = await stackbe.customers.getSession(token);
-     * console.log(session.customer.email);
+     * // Deprecated - use auth.getSession instead:
+     * const session = await stackbe.auth.getSession(token);
+     * console.log(session.customerId);
      * console.log(session.entitlements);
      * ```
      */
@@ -1413,6 +1421,8 @@ interface CreateFeatureRequestOptions {
     title: string;
     description?: string;
     category?: string;
+    /** Customer ID for server-side creation with API key */
+    customerId?: string;
 }
 interface ListFeatureRequestsOptions {
     status?: 'new' | 'under_review' | 'planned' | 'in_progress' | 'completed' | 'declined';
@@ -1422,10 +1432,11 @@ interface ListFeatureRequestsOptions {
     offset?: number;
 }
 interface FeatureRequestListResponse {
-    data: FeatureRequest[];
+    items: FeatureRequest[];
     total: number;
     limit: number;
-    offset: number;
+    page: number;
+    hasMore: boolean;
 }
 interface InterestedCustomer {
     customerId: string;
@@ -1474,27 +1485,38 @@ declare class FeatureRequestsClient {
      * @example
      * ```typescript
      * // Get all feature requests
-     * const { data, total } = await stackbe.featureRequests.list();
+     * const { items, total, hasMore } = 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' });
+     *
+     * // Paginate
+     * const page2 = await stackbe.featureRequests.list({ offset: 50, limit: 50 });
      * ```
      */
     list(options?: ListFeatureRequestsOptions): Promise<FeatureRequestListResponse>;
     /**
      * Submit a new feature request.
-     * Requires customer session token.
+     * Requires customer session token, OR API key with customerId.
      *
      * @example
      * ```typescript
+     * // With customer session token
      * const request = await stackbe.featureRequests.create({
      *   title: 'Dark mode support',
      *   description: 'Would love to have a dark theme option',
      *   category: 'UI',
      * });
+     *
+     * // With API key (server-side)
+     * const request = await stackbe.featureRequests.create({
+     *   title: 'Dark mode support',
+     *   description: 'Would love to have a dark theme option',
+     *   customerId: 'cust_123',
+     * });
      * ```
      */
     create(options: CreateFeatureRequestOptions): Promise<FeatureRequest>;
@@ -1547,17 +1569,25 @@ declare class FeatureRequestsClient {
     }>;
     /**
      * Add a comment to a feature request.
-     * Requires customer session token.
+     * Requires customer session token, OR API key with customerId.
      *
      * @example
      * ```typescript
+     * // With customer session token
+     * await stackbe.featureRequests.addComment('req_123', {
+     *   content: 'This would be really helpful for my workflow!',
+     * });
+     *
+     * // With API key (server-side)
      * await stackbe.featureRequests.addComment('req_123', {
      *   content: 'This would be really helpful for my workflow!',
+     *   customerId: 'cust_456',
      * });
      * ```
      */
     addComment(requestId: string, options: {
         content: string;
+        customerId?: string;
     }): Promise<FeatureRequestComment>;
     /**
      * Update a feature request status or category.

package/dist/index.js

@@ -566,9 +566,13 @@ var CustomersClient = class {
   /**
    * Send a magic link to a customer for passwordless authentication.
    *
+   * @deprecated Use `stackbe.auth.sendMagicLink()` instead, which uses the app-specific endpoint
+   * and supports dev callback URLs.
+   *
    * @example
    * ```typescript
-   * await stackbe.customers.sendMagicLink('user@example.com', {
+   * // Deprecated - use auth.sendMagicLink instead:
+   * await stackbe.auth.sendMagicLink('user@example.com', {
    *   redirectUrl: 'https://myapp.com/dashboard'
    * });
    * ```
@@ -583,15 +587,28 @@ var CustomersClient = class {
    * Get the current session for a customer token.
    * Use this to validate tokens and get customer data.
    *
+   * @deprecated Use `stackbe.auth.getSession()` instead, which includes caching,
+   * tenant/org context extraction, and proper error handling.
+   *
    * @example
    * ```typescript
-   * const session = await stackbe.customers.getSession(token);
-   * console.log(session.customer.email);
+   * // Deprecated - use auth.getSession instead:
+   * const session = await stackbe.auth.getSession(token);
+   * console.log(session.customerId);
    * console.log(session.entitlements);
    * ```
    */
   async getSession(token) {
-    return this.http.get("/v1/auth/session", void 0);
+    const response = await fetch(`${this.http.baseUrl}/v1/apps/${this.appId}/auth/session`, {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      }
+    });
+    if (!response.ok) {
+      throw new Error("Failed to get session");
+    }
+    return response.json();
   }
 };
 
@@ -1473,13 +1490,16 @@ var FeatureRequestsClient = class {
    * @example
    * ```typescript
    * // Get all feature requests
-   * const { data, total } = await stackbe.featureRequests.list();
+   * const { items, total, hasMore } = 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' });
+   *
+   * // Paginate
+   * const page2 = await stackbe.featureRequests.list({ offset: 50, limit: 50 });
    * ```
    */
   async list(options = {}) {
@@ -1496,15 +1516,23 @@ var FeatureRequestsClient = class {
   }
   /**
    * Submit a new feature request.
-   * Requires customer session token.
+   * Requires customer session token, OR API key with customerId.
    *
    * @example
    * ```typescript
+   * // With customer session token
    * const request = await stackbe.featureRequests.create({
    *   title: 'Dark mode support',
    *   description: 'Would love to have a dark theme option',
    *   category: 'UI',
    * });
+   *
+   * // With API key (server-side)
+   * const request = await stackbe.featureRequests.create({
+   *   title: 'Dark mode support',
+   *   description: 'Would love to have a dark theme option',
+   *   customerId: 'cust_123',
+   * });
    * ```
    */
   async create(options) {
@@ -1567,13 +1595,20 @@ var FeatureRequestsClient = class {
   }
   /**
    * Add a comment to a feature request.
-   * Requires customer session token.
+   * Requires customer session token, OR API key with customerId.
    *
    * @example
    * ```typescript
+   * // With customer session token
    * await stackbe.featureRequests.addComment('req_123', {
    *   content: 'This would be really helpful for my workflow!',
    * });
+   *
+   * // With API key (server-side)
+   * await stackbe.featureRequests.addComment('req_123', {
+   *   content: 'This would be really helpful for my workflow!',
+   *   customerId: 'cust_456',
+   * });
    * ```
    */
   async addComment(requestId, options) {

package/dist/index.mjs

@@ -529,9 +529,13 @@ var CustomersClient = class {
   /**
    * Send a magic link to a customer for passwordless authentication.
    *
+   * @deprecated Use `stackbe.auth.sendMagicLink()` instead, which uses the app-specific endpoint
+   * and supports dev callback URLs.
+   *
    * @example
    * ```typescript
-   * await stackbe.customers.sendMagicLink('user@example.com', {
+   * // Deprecated - use auth.sendMagicLink instead:
+   * await stackbe.auth.sendMagicLink('user@example.com', {
    *   redirectUrl: 'https://myapp.com/dashboard'
    * });
    * ```
@@ -546,15 +550,28 @@ var CustomersClient = class {
    * Get the current session for a customer token.
    * Use this to validate tokens and get customer data.
    *
+   * @deprecated Use `stackbe.auth.getSession()` instead, which includes caching,
+   * tenant/org context extraction, and proper error handling.
+   *
    * @example
    * ```typescript
-   * const session = await stackbe.customers.getSession(token);
-   * console.log(session.customer.email);
+   * // Deprecated - use auth.getSession instead:
+   * const session = await stackbe.auth.getSession(token);
+   * console.log(session.customerId);
    * console.log(session.entitlements);
    * ```
    */
   async getSession(token) {
-    return this.http.get("/v1/auth/session", void 0);
+    const response = await fetch(`${this.http.baseUrl}/v1/apps/${this.appId}/auth/session`, {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      }
+    });
+    if (!response.ok) {
+      throw new Error("Failed to get session");
+    }
+    return response.json();
   }
 };
 
@@ -1436,13 +1453,16 @@ var FeatureRequestsClient = class {
    * @example
    * ```typescript
    * // Get all feature requests
-   * const { data, total } = await stackbe.featureRequests.list();
+   * const { items, total, hasMore } = 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' });
+   *
+   * // Paginate
+   * const page2 = await stackbe.featureRequests.list({ offset: 50, limit: 50 });
    * ```
    */
   async list(options = {}) {
@@ -1459,15 +1479,23 @@ var FeatureRequestsClient = class {
   }
   /**
    * Submit a new feature request.
-   * Requires customer session token.
+   * Requires customer session token, OR API key with customerId.
    *
    * @example
    * ```typescript
+   * // With customer session token
    * const request = await stackbe.featureRequests.create({
    *   title: 'Dark mode support',
    *   description: 'Would love to have a dark theme option',
    *   category: 'UI',
    * });
+   *
+   * // With API key (server-side)
+   * const request = await stackbe.featureRequests.create({
+   *   title: 'Dark mode support',
+   *   description: 'Would love to have a dark theme option',
+   *   customerId: 'cust_123',
+   * });
    * ```
    */
   async create(options) {
@@ -1530,13 +1558,20 @@ var FeatureRequestsClient = class {
   }
   /**
    * Add a comment to a feature request.
-   * Requires customer session token.
+   * Requires customer session token, OR API key with customerId.
    *
    * @example
    * ```typescript
+   * // With customer session token
    * await stackbe.featureRequests.addComment('req_123', {
    *   content: 'This would be really helpful for my workflow!',
    * });
+   *
+   * // With API key (server-side)
+   * await stackbe.featureRequests.addComment('req_123', {
+   *   content: 'This would be really helpful for my workflow!',
+   *   customerId: 'cust_456',
+   * });
    * ```
    */
   async addComment(requestId, options) {

package/package.json

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