@forgecart/sdk 1.0.0 → 1.2.0

package/dist/admin-namespace.d.ts

@@ -4,7 +4,7 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-12T11:13:16.730Z
+ * Generated at: 2025-12-13T23:18:09.120Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -23,6 +23,8 @@ export interface SDKConfig {
     headers?: Record<string, string>;
     /** Custom WebSocket implementation (optional, auto-detected if not provided) */
     webSocketImpl?: unknown;
+    /** Use HTTP only, skip WebSocket initialization (default: false) */
+    httpOnly?: boolean;
 }
 export type ActiveAdministratorQueryVariables = Types.ActiveAdministratorQueryVariables;
 export type ActiveAdministratorQuery = Types.ActiveAdministratorQuery;

package/dist/admin-namespace.js

@@ -4,7 +4,7 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-12T11:13:16.730Z
+ * Generated at: 2025-12-13T23:18:09.120Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -6782,9 +6782,29 @@ class BaseGraphQLClient {
         this.endpoint = config.endpoint || 'https://api.forgecart.com/admin-api';
         this.wsEndpoint = config.wsEndpoint || 'wss://api.forgecart.com/admin-api';
         this.config = config;
-        // Initialize HTTP client (as fallback)
+        // Custom fetch that captures session token from response headers
+        const customFetch = async (url, options) => {
+            const response = await fetch(url, options);
+            // Capture session token from response header
+            const authToken = response.headers.get('forge-auth-token');
+            if (authToken && authToken !== this.authToken) {
+                this.authToken = authToken;
+                // Reconnect WebSocket with new token
+                if (this.wsClient) {
+                    this.wsConnected = false;
+                    this.wsClient.dispose();
+                    this.wsClient = null;
+                    this.wsInitializing = null;
+                    this.initializeWebSocket();
+                }
+            }
+            return response;
+        };
+        // Initialize HTTP client with custom fetch
         this.httpClient = new GraphQLClient(this.endpoint, {
             headers: config.headers || {},
+            credentials: 'include',
+            fetch: customFetch,
         });
         // Initialize WebSocket connection immediately
         this.initializeWebSocket();
@@ -6878,6 +6898,10 @@ class BaseGraphQLClient {
      * Connects immediately and tracks connection state
      */
     initializeWebSocket() {
+        // Skip WebSocket if httpOnly mode is enabled
+        if (this.config.httpOnly) {
+            return;
+        }
         // Prevent multiple simultaneous initializations
         if (this.wsClient || this.wsInitializing) {
             return;
@@ -6897,7 +6921,20 @@ class BaseGraphQLClient {
                     keepAlive: 10000, // Send keep-alive pings every 10 seconds
                     connectionParams: async () => {
                         try {
-                            return this.authToken ? { Authorization: `Bearer ${this.authToken}` } : {};
+                            const params = {};
+                            // Add session token if available
+                            if (this.authToken) {
+                                params.Authorization = `bearer ${this.authToken}`;
+                            }
+                            // Pass all configured headers (including forge-token for channel)
+                            if (this.config.headers) {
+                                Object.entries(this.config.headers).forEach(([key, value]) => {
+                                    if (value) {
+                                        params[key] = value;
+                                    }
+                                });
+                            }
+                            return params;
                         }
                         catch (error) {
                             console.error('Error in connectionParams:', error);

package/dist/index.d.ts

@@ -12,14 +12,12 @@ import { ShopNamespace, ShopSDKConfig } from './shop.js';
  * Unified SDK Configuration
  */
 export interface ForgeCartSDKConfig {
-    /** GraphQL HTTP endpoint for admin API */
-    adminEndpoint?: string;
-    /** WebSocket endpoint for admin subscriptions */
-    adminWsEndpoint?: string;
-    /** GraphQL HTTP endpoint for shop API */
-    shopEndpoint?: string;
-    /** WebSocket endpoint for shop subscriptions */
-    shopWsEndpoint?: string;
+    /** Base API endpoint (e.g., 'https://api.forgecart.com') */
+    endpoint?: string;
+    /** Channel token for Vendure multi-tenancy */
+    token?: string;
+    /** Use HTTP only, skip WebSocket initialization (default: false) */
+    httpOnly?: boolean;
     /** Custom HTTP headers */
     headers?: Record<string, string>;
     /** Custom WebSocket implementation (optional, auto-detected if not provided) */
@@ -34,8 +32,8 @@ export { AdminNamespace, ShopNamespace };
  * @example
  * ```typescript
  * const sdk = new ForgeCartSDK({
- *   adminEndpoint: 'https://api.forgecart.com/admin-api',
- *   shopEndpoint: 'https://api.forgecart.com/shop-api'
+ *   endpoint: 'https://api.forgecart.com',
+ *   token: 'your-channel-token',
  * });
  *
  * // Admin namespace → Category → Operations

package/dist/index.js

@@ -16,8 +16,8 @@ export { AdminNamespace, ShopNamespace };
  * @example
  * ```typescript
  * const sdk = new ForgeCartSDK({
- *   adminEndpoint: 'https://api.forgecart.com/admin-api',
- *   shopEndpoint: 'https://api.forgecart.com/shop-api'
+ *   endpoint: 'https://api.forgecart.com',
+ *   token: 'your-channel-token',
  * });
  *
  * // Admin namespace → Category → Operations
@@ -31,18 +31,27 @@ export { AdminNamespace, ShopNamespace };
  */
 export class ForgeCartSDK {
     constructor(config = {}) {
+        const baseEndpoint = config.endpoint || 'https://api.forgecart.com';
+        const baseWsEndpoint = baseEndpoint.replace('http', 'ws');
+        // Build headers with token
+        const headers = {
+            ...config.headers,
+            ...(config.token ? { 'forge-token': config.token } : {}),
+        };
         const adminConfig = {
-            endpoint: config.adminEndpoint || 'https://api.forgecart.com/admin-api',
-            wsEndpoint: config.adminWsEndpoint || 'wss://api.forgecart.com/admin-api',
-            headers: config.headers,
+            endpoint: `${baseEndpoint}/admin-api`,
+            wsEndpoint: `${baseWsEndpoint}/admin-api`,
+            headers,
             webSocketImpl: config.webSocketImpl,
+            httpOnly: config.httpOnly,
         };
         this.admin = new AdminNamespace(adminConfig);
         const shopConfig = {
-            endpoint: config.shopEndpoint || 'https://api.forgecart.com/shop-api',
-            wsEndpoint: config.shopWsEndpoint || 'wss://api.forgecart.com/shop-api',
-            headers: config.headers,
+            endpoint: `${baseEndpoint}/shop-api`,
+            wsEndpoint: `${baseWsEndpoint}/shop-api`,
+            headers,
             webSocketImpl: config.webSocketImpl,
+            httpOnly: config.httpOnly,
         };
         this.shop = new ShopNamespace(shopConfig);
     }

package/dist/shop-namespace.d.ts

@@ -4,7 +4,7 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-12T11:13:16.603Z
+ * Generated at: 2025-12-13T23:18:09.300Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -23,6 +23,8 @@ export interface SDKConfig {
     headers?: Record<string, string>;
     /** Custom WebSocket implementation (optional, auto-detected if not provided) */
     webSocketImpl?: unknown;
+    /** Use HTTP only, skip WebSocket initialization (default: false) */
+    httpOnly?: boolean;
 }
 export type AssetQueryVariables = Types.AssetQueryVariables;
 export type AssetQuery = Types.AssetQuery;

package/dist/shop-namespace.js

@@ -4,7 +4,7 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-12T11:13:16.603Z
+ * Generated at: 2025-12-13T23:18:09.300Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -2200,9 +2200,29 @@ class BaseGraphQLClient {
         this.endpoint = config.endpoint || 'https://api.forgecart.com/shop-api';
         this.wsEndpoint = config.wsEndpoint || 'wss://api.forgecart.com/shop-api';
         this.config = config;
-        // Initialize HTTP client (as fallback)
+        // Custom fetch that captures session token from response headers
+        const customFetch = async (url, options) => {
+            const response = await fetch(url, options);
+            // Capture session token from response header
+            const authToken = response.headers.get('forge-auth-token');
+            if (authToken && authToken !== this.authToken) {
+                this.authToken = authToken;
+                // Reconnect WebSocket with new token
+                if (this.wsClient) {
+                    this.wsConnected = false;
+                    this.wsClient.dispose();
+                    this.wsClient = null;
+                    this.wsInitializing = null;
+                    this.initializeWebSocket();
+                }
+            }
+            return response;
+        };
+        // Initialize HTTP client with custom fetch
         this.httpClient = new GraphQLClient(this.endpoint, {
             headers: config.headers || {},
+            credentials: 'include',
+            fetch: customFetch,
         });
         // Initialize WebSocket connection immediately
         this.initializeWebSocket();
@@ -2296,6 +2316,10 @@ class BaseGraphQLClient {
      * Connects immediately and tracks connection state
      */
     initializeWebSocket() {
+        // Skip WebSocket if httpOnly mode is enabled
+        if (this.config.httpOnly) {
+            return;
+        }
         // Prevent multiple simultaneous initializations
         if (this.wsClient || this.wsInitializing) {
             return;
@@ -2315,7 +2339,20 @@ class BaseGraphQLClient {
                     keepAlive: 10000, // Send keep-alive pings every 10 seconds
                     connectionParams: async () => {
                         try {
-                            return this.authToken ? { Authorization: `Bearer ${this.authToken}` } : {};
+                            const params = {};
+                            // Add session token if available
+                            if (this.authToken) {
+                                params.Authorization = `bearer ${this.authToken}`;
+                            }
+                            // Pass all configured headers (including forge-token for channel)
+                            if (this.config.headers) {
+                                Object.entries(this.config.headers).forEach(([key, value]) => {
+                                    if (value) {
+                                        params[key] = value;
+                                    }
+                                });
+                            }
+                            return params;
                         }
                         catch (error) {
                             console.error('Error in connectionParams:', error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgecart/sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "TypeScript SDK for ForgeCart API - Auto-generated GraphQL client",
   "type": "module",
   "main": "./dist/index.js",

package/src/admin-namespace.ts

@@ -4,7 +4,7 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-12T11:13:16.730Z
+ * Generated at: 2025-12-13T23:18:09.120Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -28,6 +28,8 @@ export interface SDKConfig {
   headers?: Record<string, string>;
   /** Custom WebSocket implementation (optional, auto-detected if not provided) */
   webSocketImpl?: unknown;
+  /** Use HTTP only, skip WebSocket initialization (default: false) */
+  httpOnly?: boolean;
 }
 
 export type ActiveAdministratorQueryVariables = Types.ActiveAdministratorQueryVariables;
@@ -8020,9 +8022,32 @@ class BaseGraphQLClient {
     this.wsEndpoint = config.wsEndpoint || 'wss://api.forgecart.com/admin-api';
     this.config = config;
 
-    // Initialize HTTP client (as fallback)
+    // Custom fetch that captures session token from response headers
+    const customFetch = async (url: RequestInfo | URL, options?: RequestInit): Promise<Response> => {
+      const response = await fetch(url, options);
+
+      // Capture session token from response header
+      const authToken = response.headers.get('forge-auth-token');
+      if (authToken && authToken !== this.authToken) {
+        this.authToken = authToken;
+        // Reconnect WebSocket with new token
+        if (this.wsClient) {
+          this.wsConnected = false;
+          this.wsClient.dispose();
+          this.wsClient = null;
+          this.wsInitializing = null;
+          this.initializeWebSocket();
+        }
+      }
+
+      return response;
+    };
+
+    // Initialize HTTP client with custom fetch
     this.httpClient = new GraphQLClient(this.endpoint, {
       headers: config.headers || {},
+      credentials: 'include',
+      fetch: customFetch,
     });
 
     // Initialize WebSocket connection immediately
@@ -8137,6 +8162,11 @@ class BaseGraphQLClient {
    * Connects immediately and tracks connection state
    */
   private initializeWebSocket(): void {
+    // Skip WebSocket if httpOnly mode is enabled
+    if (this.config.httpOnly) {
+      return;
+    }
+
     // Prevent multiple simultaneous initializations
     if (this.wsClient || this.wsInitializing) {
       return;
@@ -8159,7 +8189,23 @@ class BaseGraphQLClient {
           keepAlive: 10_000, // Send keep-alive pings every 10 seconds
           connectionParams: async () => {
             try {
-              return this.authToken ? { Authorization: `Bearer ${this.authToken}` } : {};
+              const params: Record<string, string> = {};
+
+              // Add session token if available
+              if (this.authToken) {
+                params.Authorization = `bearer ${this.authToken}`;
+              }
+
+              // Pass all configured headers (including forge-token for channel)
+              if (this.config.headers) {
+                Object.entries(this.config.headers).forEach(([key, value]) => {
+                  if (value) {
+                    params[key] = value;
+                  }
+                });
+              }
+
+              return params;
             } catch (error) {
               console.error('Error in connectionParams:', error);
               return {};

package/src/index.ts

@@ -14,14 +14,12 @@ import { ShopNamespace, ShopSDKConfig } from './shop.js'
  * Unified SDK Configuration
  */
 export interface ForgeCartSDKConfig {
-  /** GraphQL HTTP endpoint for admin API */
-  adminEndpoint?: string
-  /** WebSocket endpoint for admin subscriptions */
-  adminWsEndpoint?: string
-  /** GraphQL HTTP endpoint for shop API */
-  shopEndpoint?: string
-  /** WebSocket endpoint for shop subscriptions */
-  shopWsEndpoint?: string
+  /** Base API endpoint (e.g., 'https://api.forgecart.com') */
+  endpoint?: string
+  /** Channel token for Vendure multi-tenancy */
+  token?: string
+  /** Use HTTP only, skip WebSocket initialization (default: false) */
+  httpOnly?: boolean
   /** Custom HTTP headers */
   headers?: Record<string, string>
   /** Custom WebSocket implementation (optional, auto-detected if not provided) */
@@ -39,8 +37,8 @@ export { AdminNamespace, ShopNamespace }
  * @example
  * ```typescript
  * const sdk = new ForgeCartSDK({
- *   adminEndpoint: 'https://api.forgecart.com/admin-api',
- *   shopEndpoint: 'https://api.forgecart.com/shop-api'
+ *   endpoint: 'https://api.forgecart.com',
+ *   token: 'your-channel-token',
  * });
  *
  * // Admin namespace → Category → Operations
@@ -57,19 +55,30 @@ export class ForgeCartSDK {
   readonly shop: ShopNamespace
 
   constructor(config: ForgeCartSDKConfig = {}) {
+    const baseEndpoint = config.endpoint || 'https://api.forgecart.com'
+    const baseWsEndpoint = baseEndpoint.replace('http', 'ws')
+
+    // Build headers with token
+    const headers: Record<string, string> = {
+      ...config.headers,
+      ...(config.token ? { 'forge-token': config.token } : {}),
+    }
+
     const adminConfig: AdminSDKConfig = {
-      endpoint: config.adminEndpoint || 'https://api.forgecart.com/admin-api',
-      wsEndpoint: config.adminWsEndpoint || 'wss://api.forgecart.com/admin-api',
-      headers: config.headers,
+      endpoint: `${baseEndpoint}/admin-api`,
+      wsEndpoint: `${baseWsEndpoint}/admin-api`,
+      headers,
       webSocketImpl: config.webSocketImpl,
+      httpOnly: config.httpOnly,
     }
     this.admin = new AdminNamespace(adminConfig)
 
     const shopConfig: ShopSDKConfig = {
-      endpoint: config.shopEndpoint || 'https://api.forgecart.com/shop-api',
-      wsEndpoint: config.shopWsEndpoint || 'wss://api.forgecart.com/shop-api',
-      headers: config.headers,
+      endpoint: `${baseEndpoint}/shop-api`,
+      wsEndpoint: `${baseWsEndpoint}/shop-api`,
+      headers,
       webSocketImpl: config.webSocketImpl,
+      httpOnly: config.httpOnly,
     }
     this.shop = new ShopNamespace(shopConfig)
   }

package/src/shop-namespace.ts

@@ -4,7 +4,7 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-12T11:13:16.603Z
+ * Generated at: 2025-12-13T23:18:09.300Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -28,6 +28,8 @@ export interface SDKConfig {
   headers?: Record<string, string>;
   /** Custom WebSocket implementation (optional, auto-detected if not provided) */
   webSocketImpl?: unknown;
+  /** Use HTTP only, skip WebSocket initialization (default: false) */
+  httpOnly?: boolean;
 }
 
 export type AssetQueryVariables = Types.AssetQueryVariables;
@@ -2498,9 +2500,32 @@ class BaseGraphQLClient {
     this.wsEndpoint = config.wsEndpoint || 'wss://api.forgecart.com/shop-api';
     this.config = config;
 
-    // Initialize HTTP client (as fallback)
+    // Custom fetch that captures session token from response headers
+    const customFetch = async (url: RequestInfo | URL, options?: RequestInit): Promise<Response> => {
+      const response = await fetch(url, options);
+
+      // Capture session token from response header
+      const authToken = response.headers.get('forge-auth-token');
+      if (authToken && authToken !== this.authToken) {
+        this.authToken = authToken;
+        // Reconnect WebSocket with new token
+        if (this.wsClient) {
+          this.wsConnected = false;
+          this.wsClient.dispose();
+          this.wsClient = null;
+          this.wsInitializing = null;
+          this.initializeWebSocket();
+        }
+      }
+
+      return response;
+    };
+
+    // Initialize HTTP client with custom fetch
     this.httpClient = new GraphQLClient(this.endpoint, {
       headers: config.headers || {},
+      credentials: 'include',
+      fetch: customFetch,
     });
 
     // Initialize WebSocket connection immediately
@@ -2615,6 +2640,11 @@ class BaseGraphQLClient {
    * Connects immediately and tracks connection state
    */
   private initializeWebSocket(): void {
+    // Skip WebSocket if httpOnly mode is enabled
+    if (this.config.httpOnly) {
+      return;
+    }
+
     // Prevent multiple simultaneous initializations
     if (this.wsClient || this.wsInitializing) {
       return;
@@ -2637,7 +2667,23 @@ class BaseGraphQLClient {
           keepAlive: 10_000, // Send keep-alive pings every 10 seconds
           connectionParams: async () => {
             try {
-              return this.authToken ? { Authorization: `Bearer ${this.authToken}` } : {};
+              const params: Record<string, string> = {};
+
+              // Add session token if available
+              if (this.authToken) {
+                params.Authorization = `bearer ${this.authToken}`;
+              }
+
+              // Pass all configured headers (including forge-token for channel)
+              if (this.config.headers) {
+                Object.entries(this.config.headers).forEach(([key, value]) => {
+                  if (value) {
+                    params[key] = value;
+                  }
+                });
+              }
+
+              return params;
             } catch (error) {
               console.error('Error in connectionParams:', error);
               return {};