@stackbe/sdk 0.7.2 → 0.7.3

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';
@@ -1486,15 +1496,23 @@ declare class FeatureRequestsClient {
     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 +1565,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';
@@ -1486,15 +1496,23 @@ declare class FeatureRequestsClient {
     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 +1565,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();
   }
 };
 
@@ -1496,15 +1513,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 +1592,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();
   }
 };
 
@@ -1459,15 +1476,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 +1555,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.3",
   "description": "Official JavaScript/TypeScript SDK for StackBE - the billing backend for your side project",
   "main": "dist/index.js",
   "module": "dist/index.mjs",