@forgecart/sdk 1.2.1 → 1.2.3

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-15T07:01:16.361Z
+ * Generated at: 2025-12-15T13:49:08.285Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -25,6 +25,8 @@ export interface SDKConfig {
     webSocketImpl?: unknown;
     /** Use HTTP only, skip WebSocket initialization (default: false) */
     httpOnly?: boolean;
+    /** Enable debug logging with request timing (default: false) */
+    debug?: boolean;
 }
 export type ActiveAdministratorQueryVariables = Types.ActiveAdministratorQueryVariables;
 export type ActiveAdministratorQuery = Types.ActiveAdministratorQuery;
@@ -990,6 +992,10 @@ declare class BaseGraphQLClient {
     private wsEndpoint;
     private config;
     constructor(config: SDKConfig);
+    /**
+     * Extract operation name from GraphQL document
+     */
+    private getOperationName;
     /**
      * Execute a GraphQL query or mutation
      * Uses WebSocket if available, falls back to HTTP

package/dist/admin-namespace.js

@@ -5,7 +5,7 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-15T07:01:16.361Z
+ * Generated at: 2025-12-15T13:49:08.285Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -6914,26 +6914,50 @@ class BaseGraphQLClient {
         // Initialize WebSocket connection immediately
         this.initializeWebSocket();
     }
+    /**
+     * Extract operation name from GraphQL document
+     */
+    getOperationName(document) {
+        const docString = typeof document === 'string' ? document : String(document);
+        const match = docString.match(/(?:query|mutation|subscription)\s+(\w+)/);
+        return match ? match[1] : 'UnknownOperation';
+    }
     /**
      * Execute a GraphQL query or mutation
      * Uses WebSocket if available, falls back to HTTP
      */
     async request(document, variables) {
+        const startTime = this.config.debug ? performance.now() : 0;
+        const operationName = this.config.debug ? this.getOperationName(document) : '';
+        let transport = 'HTTP';
         // Try WebSocket first if available
         if (this.wsClient && this.wsConnected) {
             try {
-                return await this.requestViaWebSocket(document, variables);
+                transport = 'WebSocket';
+                const result = await this.requestViaWebSocket(document, variables);
+                if (this.config.debug) {
+                    console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+                }
+                return result;
             }
             catch (wsError) {
+                transport = 'WebSocket -> HTTP';
                 console.warn('WebSocket request failed, falling back to HTTP:', wsError);
                 // Fall through to HTTP
             }
         }
         // Use HTTP as fallback or when WebSocket is not available
         try {
-            return await this.httpClient.request(document, variables);
+            const result = await this.httpClient.request(document, variables);
+            if (this.config.debug) {
+                console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+            }
+            return result;
         }
         catch (error) {
+            if (this.config.debug) {
+                console.log(`[ForgeCart SDK] ${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
+            }
             this.handleError(error);
             throw error;
         }

package/dist/index.d.ts

@@ -18,6 +18,8 @@ export interface ForgeCartSDKConfig {
     token: string;
     /** Use HTTP only, skip WebSocket initialization (default: false) */
     httpOnly?: boolean;
+    /** Enable debug logging with request timing (default: false) */
+    debug?: boolean;
     /** Custom HTTP headers */
     headers?: Record<string, string>;
     /** Custom WebSocket implementation (optional, auto-detected if not provided) */

package/dist/index.js

@@ -52,6 +52,7 @@ class ForgeCartSDK {
             headers,
             webSocketImpl: config.webSocketImpl,
             httpOnly: config.httpOnly,
+            debug: config.debug,
         };
         this.admin = new admin_js_1.AdminNamespace(adminConfig);
         const shopConfig = {
@@ -60,6 +61,7 @@ class ForgeCartSDK {
             headers,
             webSocketImpl: config.webSocketImpl,
             httpOnly: config.httpOnly,
+            debug: config.debug,
         };
         this.shop = new shop_js_1.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-15T07:01:16.247Z
+ * Generated at: 2025-12-15T13:49:08.152Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -25,6 +25,8 @@ export interface SDKConfig {
     webSocketImpl?: unknown;
     /** Use HTTP only, skip WebSocket initialization (default: false) */
     httpOnly?: boolean;
+    /** Enable debug logging with request timing (default: false) */
+    debug?: boolean;
 }
 export type AssetQueryVariables = Types.AssetQueryVariables;
 export type AssetQuery = Types.AssetQuery;
@@ -246,6 +248,10 @@ declare class BaseGraphQLClient {
     private wsEndpoint;
     private config;
     constructor(config: SDKConfig);
+    /**
+     * Extract operation name from GraphQL document
+     */
+    private getOperationName;
     /**
      * Execute a GraphQL query or mutation
      * Uses WebSocket if available, falls back to HTTP

package/dist/shop-namespace.js

@@ -5,7 +5,7 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-15T07:01:16.247Z
+ * Generated at: 2025-12-15T13:49:08.152Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -2230,26 +2230,50 @@ class BaseGraphQLClient {
         // Initialize WebSocket connection immediately
         this.initializeWebSocket();
     }
+    /**
+     * Extract operation name from GraphQL document
+     */
+    getOperationName(document) {
+        const docString = typeof document === 'string' ? document : String(document);
+        const match = docString.match(/(?:query|mutation|subscription)\s+(\w+)/);
+        return match ? match[1] : 'UnknownOperation';
+    }
     /**
      * Execute a GraphQL query or mutation
      * Uses WebSocket if available, falls back to HTTP
      */
     async request(document, variables) {
+        const startTime = this.config.debug ? performance.now() : 0;
+        const operationName = this.config.debug ? this.getOperationName(document) : '';
+        let transport = 'HTTP';
         // Try WebSocket first if available
         if (this.wsClient && this.wsConnected) {
             try {
-                return await this.requestViaWebSocket(document, variables);
+                transport = 'WebSocket';
+                const result = await this.requestViaWebSocket(document, variables);
+                if (this.config.debug) {
+                    console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+                }
+                return result;
             }
             catch (wsError) {
+                transport = 'WebSocket -> HTTP';
                 console.warn('WebSocket request failed, falling back to HTTP:', wsError);
                 // Fall through to HTTP
             }
         }
         // Use HTTP as fallback or when WebSocket is not available
         try {
-            return await this.httpClient.request(document, variables);
+            const result = await this.httpClient.request(document, variables);
+            if (this.config.debug) {
+                console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+            }
+            return result;
         }
         catch (error) {
+            if (this.config.debug) {
+                console.log(`[ForgeCart SDK] ${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
+            }
             this.handleError(error);
             throw error;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgecart/sdk",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "TypeScript SDK for ForgeCart API - Auto-generated GraphQL client",
   "main": "./dist/index.js",
   "module": "./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-15T07:01:16.361Z
+ * Generated at: 2025-12-15T13:49:08.285Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -30,6 +30,8 @@ export interface SDKConfig {
   webSocketImpl?: unknown;
   /** Use HTTP only, skip WebSocket initialization (default: false) */
   httpOnly?: boolean;
+  /** Enable debug logging with request timing (default: false) */
+  debug?: boolean;
 }
 
 export type ActiveAdministratorQueryVariables = Types.ActiveAdministratorQueryVariables;
@@ -8208,6 +8210,15 @@ class BaseGraphQLClient {
     this.initializeWebSocket();
   }
 
+  /**
+   * Extract operation name from GraphQL document
+   */
+  private getOperationName(document: RequestDocument): string {
+    const docString = typeof document === 'string' ? document : String(document);
+    const match = docString.match(/(?:query|mutation|subscription)\s+(\w+)/);
+    return match ? match[1] : 'UnknownOperation';
+  }
+
   /**
    * Execute a GraphQL query or mutation
    * Uses WebSocket if available, falls back to HTTP
@@ -8216,12 +8227,22 @@ class BaseGraphQLClient {
     document: RequestDocument,
     variables?: V
   ): Promise<T> {
+    const startTime = this.config.debug ? performance.now() : 0;
+    const operationName = this.config.debug ? this.getOperationName(document) : '';
+    let transport = 'HTTP';
+
     
     // Try WebSocket first if available
     if (this.wsClient && this.wsConnected) {
       try {
-        return await this.requestViaWebSocket<T>(document, variables);
+        transport = 'WebSocket';
+        const result = await this.requestViaWebSocket<T>(document, variables);
+        if (this.config.debug) {
+          console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+        }
+        return result;
       } catch (wsError) {
+        transport = 'WebSocket -> HTTP';
         console.warn('WebSocket request failed, falling back to HTTP:', wsError);
         // Fall through to HTTP
       }
@@ -8230,8 +8251,15 @@ class BaseGraphQLClient {
 
     // Use HTTP as fallback or when WebSocket is not available
     try {
-      return await this.httpClient.request<T>(document, variables);
+      const result = await this.httpClient.request<T>(document, variables);
+      if (this.config.debug) {
+        console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+      }
+      return result;
     } catch (error) {
+      if (this.config.debug) {
+        console.log(`[ForgeCart SDK] ${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
+      }
       this.handleError(error);
       throw error;
     }

package/src/index.ts

@@ -20,6 +20,8 @@ export interface ForgeCartSDKConfig {
   token: string
   /** Use HTTP only, skip WebSocket initialization (default: false) */
   httpOnly?: boolean
+  /** Enable debug logging with request timing (default: false) */
+  debug?: boolean
   /** Custom HTTP headers */
   headers?: Record<string, string>
   /** Custom WebSocket implementation (optional, auto-detected if not provided) */
@@ -75,6 +77,7 @@ export class ForgeCartSDK {
       headers,
       webSocketImpl: config.webSocketImpl,
       httpOnly: config.httpOnly,
+      debug: config.debug,
     }
     this.admin = new AdminNamespace(adminConfig)
 
@@ -84,6 +87,7 @@ export class ForgeCartSDK {
       headers,
       webSocketImpl: config.webSocketImpl,
       httpOnly: config.httpOnly,
+      debug: config.debug,
     }
     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-15T07:01:16.247Z
+ * Generated at: 2025-12-15T13:49:08.152Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -30,6 +30,8 @@ export interface SDKConfig {
   webSocketImpl?: unknown;
   /** Use HTTP only, skip WebSocket initialization (default: false) */
   httpOnly?: boolean;
+  /** Enable debug logging with request timing (default: false) */
+  debug?: boolean;
 }
 
 export type AssetQueryVariables = Types.AssetQueryVariables;
@@ -2532,6 +2534,15 @@ class BaseGraphQLClient {
     this.initializeWebSocket();
   }
 
+  /**
+   * Extract operation name from GraphQL document
+   */
+  private getOperationName(document: RequestDocument): string {
+    const docString = typeof document === 'string' ? document : String(document);
+    const match = docString.match(/(?:query|mutation|subscription)\s+(\w+)/);
+    return match ? match[1] : 'UnknownOperation';
+  }
+
   /**
    * Execute a GraphQL query or mutation
    * Uses WebSocket if available, falls back to HTTP
@@ -2540,12 +2551,22 @@ class BaseGraphQLClient {
     document: RequestDocument,
     variables?: V
   ): Promise<T> {
+    const startTime = this.config.debug ? performance.now() : 0;
+    const operationName = this.config.debug ? this.getOperationName(document) : '';
+    let transport = 'HTTP';
+
     
     // Try WebSocket first if available
     if (this.wsClient && this.wsConnected) {
       try {
-        return await this.requestViaWebSocket<T>(document, variables);
+        transport = 'WebSocket';
+        const result = await this.requestViaWebSocket<T>(document, variables);
+        if (this.config.debug) {
+          console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+        }
+        return result;
       } catch (wsError) {
+        transport = 'WebSocket -> HTTP';
         console.warn('WebSocket request failed, falling back to HTTP:', wsError);
         // Fall through to HTTP
       }
@@ -2554,8 +2575,15 @@ class BaseGraphQLClient {
 
     // Use HTTP as fallback or when WebSocket is not available
     try {
-      return await this.httpClient.request<T>(document, variables);
+      const result = await this.httpClient.request<T>(document, variables);
+      if (this.config.debug) {
+        console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+      }
+      return result;
     } catch (error) {
+      if (this.config.debug) {
+        console.log(`[ForgeCart SDK] ${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
+      }
       this.handleError(error);
       throw error;
     }