@stackbe/sdk 0.7.1 → 0.7.3

package/dist/index.d.mts

@@ -13,7 +13,7 @@ declare class HttpClient {
     post<T>(path: string, body?: unknown, params?: Record<string, string | number | undefined>): Promise<T>;
     put<T>(path: string, body?: unknown, params?: Record<string, string | number | undefined>): Promise<T>;
     patch<T>(path: string, body?: unknown): Promise<T>;
-    delete<T>(path: string): Promise<T>;
+    delete<T>(path: string, body?: unknown): Promise<T>;
 }
 
 interface StackBEConfig {
@@ -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>;
@@ -1512,44 +1530,60 @@ declare class FeatureRequestsClient {
     }>;
     /**
      * Upvote a feature request.
-     * Requires customer session token. Idempotent.
+     * Requires customer session token, OR API key with customerId.
      *
      * @example
      * ```typescript
+     * // With customer session token
      * await stackbe.featureRequests.vote('req_123');
+     *
+     * // With API key (server-side)
+     * await stackbe.featureRequests.vote('req_123', 'cust_456');
      * ```
      */
-    vote(requestId: string): Promise<{
+    vote(requestId: string, customerId?: string): Promise<{
         success?: boolean;
         alreadyVoted?: boolean;
         voteCount: number;
     }>;
     /**
      * Remove your vote from 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.removeVote('req_123');
+     *
+     * // With API key (server-side)
+     * await stackbe.featureRequests.removeVote('req_123', 'cust_456');
      * ```
      */
-    removeVote(requestId: string): Promise<{
+    removeVote(requestId: string, customerId?: string): Promise<{
         success: boolean;
         voteCount: number;
     }>;
     /**
      * 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

@@ -13,7 +13,7 @@ declare class HttpClient {
     post<T>(path: string, body?: unknown, params?: Record<string, string | number | undefined>): Promise<T>;
     put<T>(path: string, body?: unknown, params?: Record<string, string | number | undefined>): Promise<T>;
     patch<T>(path: string, body?: unknown): Promise<T>;
-    delete<T>(path: string): Promise<T>;
+    delete<T>(path: string, body?: unknown): Promise<T>;
 }
 
 interface StackBEConfig {
@@ -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>;
@@ -1512,44 +1530,60 @@ declare class FeatureRequestsClient {
     }>;
     /**
      * Upvote a feature request.
-     * Requires customer session token. Idempotent.
+     * Requires customer session token, OR API key with customerId.
      *
      * @example
      * ```typescript
+     * // With customer session token
      * await stackbe.featureRequests.vote('req_123');
+     *
+     * // With API key (server-side)
+     * await stackbe.featureRequests.vote('req_123', 'cust_456');
      * ```
      */
-    vote(requestId: string): Promise<{
+    vote(requestId: string, customerId?: string): Promise<{
         success?: boolean;
         alreadyVoted?: boolean;
         voteCount: number;
     }>;
     /**
      * Remove your vote from 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.removeVote('req_123');
+     *
+     * // With API key (server-side)
+     * await stackbe.featureRequests.removeVote('req_123', 'cust_456');
      * ```
      */
-    removeVote(requestId: string): Promise<{
+    removeVote(requestId: string, customerId?: string): Promise<{
         success: boolean;
         voteCount: number;
     }>;
     /**
      * 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

@@ -169,8 +169,8 @@ var HttpClient = class {
   async patch(path, body) {
     return this.request("PATCH", path, { body });
   }
-  async delete(path) {
-    return this.request("DELETE", path);
+  async delete(path, body) {
+    return this.request("DELETE", path, body ? { body } : void 0);
   }
 };
 
@@ -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) {
@@ -1529,41 +1554,58 @@ var FeatureRequestsClient = class {
   }
   /**
    * Upvote a feature request.
-   * Requires customer session token. Idempotent.
+   * Requires customer session token, OR API key with customerId.
    *
    * @example
    * ```typescript
+   * // With customer session token
    * await stackbe.featureRequests.vote('req_123');
+   *
+   * // With API key (server-side)
+   * await stackbe.featureRequests.vote('req_123', 'cust_456');
    * ```
    */
-  async vote(requestId) {
+  async vote(requestId, customerId) {
     return this.http.post(
-      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`,
+      customerId ? { customerId } : void 0
     );
   }
   /**
    * Remove your vote from 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.removeVote('req_123');
+   *
+   * // With API key (server-side)
+   * await stackbe.featureRequests.removeVote('req_123', 'cust_456');
    * ```
    */
-  async removeVote(requestId) {
+  async removeVote(requestId, customerId) {
     return this.http.delete(
-      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`,
+      customerId ? { customerId } : void 0
     );
   }
   /**
    * 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

@@ -132,8 +132,8 @@ var HttpClient = class {
   async patch(path, body) {
     return this.request("PATCH", path, { body });
   }
-  async delete(path) {
-    return this.request("DELETE", path);
+  async delete(path, body) {
+    return this.request("DELETE", path, body ? { body } : void 0);
   }
 };
 
@@ -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) {
@@ -1492,41 +1517,58 @@ var FeatureRequestsClient = class {
   }
   /**
    * Upvote a feature request.
-   * Requires customer session token. Idempotent.
+   * Requires customer session token, OR API key with customerId.
    *
    * @example
    * ```typescript
+   * // With customer session token
    * await stackbe.featureRequests.vote('req_123');
+   *
+   * // With API key (server-side)
+   * await stackbe.featureRequests.vote('req_123', 'cust_456');
    * ```
    */
-  async vote(requestId) {
+  async vote(requestId, customerId) {
     return this.http.post(
-      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`,
+      customerId ? { customerId } : void 0
     );
   }
   /**
    * Remove your vote from 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.removeVote('req_123');
+   *
+   * // With API key (server-side)
+   * await stackbe.featureRequests.removeVote('req_123', 'cust_456');
    * ```
    */
-  async removeVote(requestId) {
+  async removeVote(requestId, customerId) {
     return this.http.delete(
-      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`
+      `/v1/apps/${this.appId}/feature-requests/${requestId}/vote`,
+      customerId ? { customerId } : void 0
     );
   }
   /**
    * 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.1",
+  "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",