@forgecart/sdk 1.2.2 → 1.2.5

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:13:55.745Z
+ * Generated at: 2025-12-17T10:24:29.306Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -25,6 +25,30 @@ 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;
+}
+/**
+ * SDK Logger - Cross-platform logging with colors
+ * Respects debug flag for log/warn, errors are always visible
+ */
+export declare class SDKLogger {
+    private debug;
+    private prefix;
+    constructor(debug?: boolean);
+    private isNode;
+    /**
+     * Debug log - only outputs when debug: true
+     */
+    log(message: string, ...args: unknown[]): void;
+    /**
+     * Warning log - only outputs when debug: true
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Error log - always outputs (errors should always be visible)
+     */
+    error(message: string, ...args: unknown[]): void;
 }
 export type ActiveAdministratorQueryVariables = Types.ActiveAdministratorQueryVariables;
 export type ActiveAdministratorQuery = Types.ActiveAdministratorQuery;
@@ -989,7 +1013,12 @@ declare class BaseGraphQLClient {
     private endpoint;
     private wsEndpoint;
     private config;
+    private logger;
     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
@@ -2570,6 +2599,7 @@ declare class ZoneOperations {
  */
 export declare class AdminNamespace {
     private client;
+    private logger;
     readonly administrator: AdministratorOperations;
     readonly asset: AssetOperations;
     readonly blog: BlogOperations;

package/dist/admin-namespace.js

@@ -5,15 +5,66 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-15T07:13:55.745Z
+ * Generated at: 2025-12-17T10:24:29.306Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdminNamespace = exports.AllEvents = exports.CatalogEvents = exports.PaymentEvents = exports.FulfillmentEvents = exports.CustomerEvents = exports.OrderEvents = exports.ProductEvents = void 0;
+exports.AdminNamespace = exports.AllEvents = exports.CatalogEvents = exports.PaymentEvents = exports.FulfillmentEvents = exports.CustomerEvents = exports.OrderEvents = exports.ProductEvents = exports.SDKLogger = void 0;
 const graphql_request_1 = require("graphql-request");
 const graphql_ws_1 = require("graphql-ws");
+/**
+ * SDK Logger - Cross-platform logging with colors
+ * Respects debug flag for log/warn, errors are always visible
+ */
+class SDKLogger {
+    constructor(debug = false) {
+        this.prefix = '[ForgeCart SDK]';
+        this.debug = debug;
+    }
+    isNode() {
+        return typeof process !== 'undefined' && process.versions?.node != null;
+    }
+    /**
+     * Debug log - only outputs when debug: true
+     */
+    log(message, ...args) {
+        if (!this.debug)
+            return;
+        if (this.isNode()) {
+            console.log(`\x1b[36m${this.prefix}\x1b[0m ${message}`, ...args);
+        }
+        else {
+            console.log(`%c${this.prefix}%c ${message}`, 'color: #06b6d4; font-weight: bold', 'color: inherit', ...args);
+        }
+    }
+    /**
+     * Warning log - only outputs when debug: true
+     */
+    warn(message, ...args) {
+        if (!this.debug)
+            return;
+        if (this.isNode()) {
+            console.warn(`\x1b[33m${this.prefix}\x1b[0m ${message}`, ...args);
+        }
+        else {
+            console.warn(`%c${this.prefix}%c ${message}`, 'color: #eab308; font-weight: bold', 'color: inherit', ...args);
+        }
+    }
+    /**
+     * Error log - always outputs (errors should always be visible)
+     */
+    error(message, ...args) {
+        if (this.isNode()) {
+            console.error(`\x1b[31m${this.prefix}\x1b[0m ${message}`, ...args);
+        }
+        else {
+            console.error(`%c${this.prefix}%c ${message}`, 'color: #ef4444; font-weight: bold', 'color: inherit', ...args);
+        }
+    }
+}
+exports.SDKLogger = SDKLogger;
 const activeAdministratorDocument = `query activeAdministrator {
   activeAdministrator {
     id
@@ -6887,6 +6938,7 @@ 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;
+        this.logger = new SDKLogger(config?.debug ?? false);
         // Custom fetch that captures session token from response headers
         const customFetch = async (url, options) => {
             const response = await fetch(url, options);
@@ -6914,26 +6966,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) {
+                    this.logger.log(`${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+                }
+                return result;
             }
             catch (wsError) {
-                console.warn('WebSocket request failed, falling back to HTTP:', wsError);
+                transport = 'WebSocket -> HTTP';
+                this.logger.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) {
+                this.logger.log(`${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+            }
+            return result;
         }
         catch (error) {
+            if (this.config.debug) {
+                this.logger.log(`${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
+            }
             this.handleError(error);
             throw error;
         }
@@ -6974,7 +7050,7 @@ class BaseGraphQLClient {
      * Handle GraphQL errors
      */
     handleError(error) {
-        console.error('GraphQL Error:', error);
+        this.logger.error('GraphQL Error:', error);
     }
     /**
      * Get WebSocket implementation for current environment
@@ -6994,7 +7070,7 @@ class BaseGraphQLClient {
             return require('ws');
         }
         catch (e) {
-            console.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
+            this.logger.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
             return undefined;
         }
     }
@@ -7013,7 +7089,7 @@ class BaseGraphQLClient {
         }
         const WebSocketImpl = this.getWebSocketImpl();
         if (!WebSocketImpl) {
-            console.warn('WebSocket not available. Will use HTTP fallback only.');
+            this.logger.warn('WebSocket not available. Will use HTTP fallback only.');
             return;
         }
         this.wsInitializing = new Promise((resolve, reject) => {
@@ -7042,7 +7118,7 @@ class BaseGraphQLClient {
                             return params;
                         }
                         catch (error) {
-                            console.error('Error in connectionParams:', error);
+                            this.logger.error('Error in connectionParams:', error);
                             return {};
                         }
                     },
@@ -7055,7 +7131,7 @@ class BaseGraphQLClient {
                     on: {
                         connected: () => {
                             this.wsConnected = true;
-                            console.log('WebSocket connected');
+                            this.logger.log('WebSocket connected');
                             if (!isResolved) {
                                 isResolved = true;
                                 resolve();
@@ -7064,13 +7140,13 @@ class BaseGraphQLClient {
                         closed: () => {
                             this.wsConnected = false;
                             if (!this.isDisposing) {
-                                console.log('WebSocket disconnected');
+                                this.logger.log('WebSocket disconnected');
                             }
                         },
                         error: (error) => {
                             // Suppress errors during disposal - they're expected
                             if (!this.isDisposing && this.wsConnected) {
-                                console.error('WebSocket error:', error);
+                                this.logger.error('WebSocket error:', error);
                             }
                             // Don't fail the connection on errors - let retry logic handle it
                             // Only log errors if we're connected (unexpected errors)
@@ -7082,7 +7158,7 @@ class BaseGraphQLClient {
                 this.wsInitializing = null;
             }
             catch (error) {
-                console.error('Failed to create WebSocket client:', error);
+                this.logger.error('Failed to create WebSocket client:', error);
                 this.wsInitializing = null;
                 // Resolve anyway to not block - we'll fallback to HTTP
                 if (!isResolved) {
@@ -9417,6 +9493,7 @@ class AdminNamespace {
         this.retryCount = 0;
         this.abortController = null;
         this.client = new BaseGraphQLClient(config);
+        this.logger = new SDKLogger(config?.debug ?? false);
         this.administrator = new AdministratorOperations(this.client);
         this.asset = new AssetOperations(this.client);
         this.blog = new BlogOperations(this.client);
@@ -9530,7 +9607,7 @@ class AdminNamespace {
         }
         catch (error) {
             if (this.isListening) {
-                console.error('Event subscription error:', error);
+                this.logger.error('Event subscription error:', error);
                 await this.handleReconnect();
             }
         }
@@ -9544,7 +9621,7 @@ class AdminNamespace {
         // Calculate delay with exponential backoff
         const delay = Math.min(baseDelayMs * Math.pow(backoffMultiplier, this.retryCount), maxDelayMs);
         this.retryCount++;
-        console.log(`Reconnecting in ${delay}ms (attempt ${this.retryCount}/${maxRetries})`);
+        this.logger.log(`Reconnecting in ${delay}ms (attempt ${this.retryCount}/${maxRetries})`);
         await new Promise(resolve => setTimeout(resolve, delay));
         await this.startSubscription();
     }
@@ -9561,7 +9638,7 @@ class AdminNamespace {
                     handler(event);
                 }
                 catch (error) {
-                    console.error(`Error in event handler for ${eventName}:`, error);
+                    this.logger.error(`Error in event handler for ${eventName}:`, error);
                 }
             }
         }
@@ -9573,7 +9650,7 @@ class AdminNamespace {
                     await this.executeWithTimeout(handler(event), AdminNamespace.BLOCKING_TIMEOUT_MS, `Blocking handler for ${eventName} exceeded ${AdminNamespace.BLOCKING_TIMEOUT_MS}ms`);
                 }
                 catch (error) {
-                    console.error(`Error in blocking event handler for ${eventName}:`, error);
+                    this.logger.error(`Error in blocking event handler for ${eventName}:`, error);
                     throw error; // Re-throw for blocking handlers
                 }
             }

package/dist/admin-types.d.ts

@@ -973,6 +973,7 @@ export type CreateCustomerInput = {
 };
 export type CreateCustomerResult = Customer | EmailAddressConflictError;
 export type CreateDeploymentInput = {
+    envVars?: InputMaybe<Array<EnvVarInput>>;
     type: DeploymentType;
 };
 export type CreateFacetInput = {
@@ -1900,6 +1901,10 @@ export type EntityEventPayload = {
     type: Scalars['String']['output'];
 };
 export type EntityEventType = 'assigned' | 'created' | 'deleted' | 'removed' | 'updated';
+export type EnvVarInput = {
+    key: Scalars['String']['input'];
+    value: Scalars['String']['input'];
+};
 export type ErrorCode = 'ALREADY_REFUNDED_ERROR' | 'CANCEL_ACTIVE_ORDER_ERROR' | 'CANCEL_PAYMENT_ERROR' | 'CHANNEL_DEFAULT_LANGUAGE_ERROR' | 'COUPON_CODE_EXPIRED_ERROR' | 'COUPON_CODE_INVALID_ERROR' | 'COUPON_CODE_LIMIT_ERROR' | 'CREATE_FULFILLMENT_ERROR' | 'DUPLICATE_ENTITY_ERROR' | 'EMAIL_ADDRESS_CONFLICT_ERROR' | 'EMPTY_ORDER_LINE_SELECTION_ERROR' | 'FACET_IN_USE_ERROR' | 'FULFILLMENT_STATE_TRANSITION_ERROR' | 'GUEST_CHECKOUT_ERROR' | 'INELIGIBLE_SHIPPING_METHOD_ERROR' | 'INSUFFICIENT_STOCK_ERROR' | 'INSUFFICIENT_STOCK_ON_HAND_ERROR' | 'INVALID_CREDENTIALS_ERROR' | 'INVALID_FULFILLMENT_HANDLER_ERROR' | 'ITEMS_ALREADY_FULFILLED_ERROR' | 'LANGUAGE_NOT_AVAILABLE_ERROR' | 'MANUAL_PAYMENT_STATE_ERROR' | 'MIME_TYPE_ERROR' | 'MISSING_CONDITIONS_ERROR' | 'MULTIPLE_ORDER_ERROR' | 'NATIVE_AUTH_STRATEGY_ERROR' | 'NEGATIVE_QUANTITY_ERROR' | 'NOTHING_TO_REFUND_ERROR' | 'NO_ACTIVE_ORDER_ERROR' | 'NO_CHANGES_SPECIFIED_ERROR' | 'ORDER_INTERCEPTOR_ERROR' | 'ORDER_LIMIT_ERROR' | 'ORDER_MODIFICATION_ERROR' | 'ORDER_MODIFICATION_STATE_ERROR' | 'ORDER_STATE_TRANSITION_ERROR' | 'PAYMENT_METHOD_MISSING_ERROR' | 'PAYMENT_ORDER_MISMATCH_ERROR' | 'PAYMENT_STATE_TRANSITION_ERROR' | 'PRODUCT_OPTION_IN_USE_ERROR' | 'QUANTITY_TOO_GREAT_ERROR' | 'REFUND_AMOUNT_ERROR' | 'REFUND_ORDER_STATE_ERROR' | 'REFUND_PAYMENT_ID_MISSING_ERROR' | 'REFUND_STATE_TRANSITION_ERROR' | 'SETTLE_PAYMENT_ERROR' | 'UNKNOWN_ERROR';
 export type ErrorResult = {
     errorCode: ErrorCode;
@@ -6185,9 +6190,8 @@ export type SessionInput = {
 };
 export type SetCustomerForDraftOrderResult = EmailAddressConflictError | Order;
 export type SetEnvInput = {
-    key: Scalars['String']['input'];
+    envVars: Array<EnvVarInput>;
     type: DeploymentType;
-    value: Scalars['String']['input'];
 };
 export type SetOrderCustomerInput = {
     customerId: Scalars['ID']['input'];
@@ -6783,7 +6787,7 @@ export type TransitionFulfillmentToStateResult = Fulfillment | FulfillmentStateT
 export type TransitionOrderToStateResult = Order | OrderStateTransitionError;
 export type TransitionPaymentToStateResult = Payment | PaymentStateTransitionError;
 export type UnsetEnvInput = {
-    key: Scalars['String']['input'];
+    keys: Array<Scalars['String']['input']>;
     type: DeploymentType;
 };
 export type UpdateActiveAdministratorInput = {

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:13:55.632Z
+ * Generated at: 2025-12-17T10:24:29.175Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -25,6 +25,30 @@ 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;
+}
+/**
+ * SDK Logger - Cross-platform logging with colors
+ * Respects debug flag for log/warn, errors are always visible
+ */
+export declare class SDKLogger {
+    private debug;
+    private prefix;
+    constructor(debug?: boolean);
+    private isNode;
+    /**
+     * Debug log - only outputs when debug: true
+     */
+    log(message: string, ...args: unknown[]): void;
+    /**
+     * Warning log - only outputs when debug: true
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Error log - always outputs (errors should always be visible)
+     */
+    error(message: string, ...args: unknown[]): void;
 }
 export type AssetQueryVariables = Types.AssetQueryVariables;
 export type AssetQuery = Types.AssetQuery;
@@ -245,7 +269,12 @@ declare class BaseGraphQLClient {
     private endpoint;
     private wsEndpoint;
     private config;
+    private logger;
     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
@@ -657,6 +686,7 @@ declare class SearchOperations {
  */
 export declare class ShopNamespace {
     private client;
+    private logger;
     readonly asset: AssetOperations;
     readonly auth: AuthOperations;
     readonly blog: BlogOperations;

package/dist/shop-namespace.js

@@ -5,15 +5,66 @@
  * This file was automatically generated and should not be manually edited.
  * To regenerate, run: npm run codegen:ts
  *
- * Generated at: 2025-12-15T07:13:55.632Z
+ * Generated at: 2025-12-17T10:24:29.175Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ShopNamespace = void 0;
+exports.ShopNamespace = exports.SDKLogger = void 0;
 const graphql_request_1 = require("graphql-request");
 const graphql_ws_1 = require("graphql-ws");
+/**
+ * SDK Logger - Cross-platform logging with colors
+ * Respects debug flag for log/warn, errors are always visible
+ */
+class SDKLogger {
+    constructor(debug = false) {
+        this.prefix = '[ForgeCart SDK]';
+        this.debug = debug;
+    }
+    isNode() {
+        return typeof process !== 'undefined' && process.versions?.node != null;
+    }
+    /**
+     * Debug log - only outputs when debug: true
+     */
+    log(message, ...args) {
+        if (!this.debug)
+            return;
+        if (this.isNode()) {
+            console.log(`\x1b[36m${this.prefix}\x1b[0m ${message}`, ...args);
+        }
+        else {
+            console.log(`%c${this.prefix}%c ${message}`, 'color: #06b6d4; font-weight: bold', 'color: inherit', ...args);
+        }
+    }
+    /**
+     * Warning log - only outputs when debug: true
+     */
+    warn(message, ...args) {
+        if (!this.debug)
+            return;
+        if (this.isNode()) {
+            console.warn(`\x1b[33m${this.prefix}\x1b[0m ${message}`, ...args);
+        }
+        else {
+            console.warn(`%c${this.prefix}%c ${message}`, 'color: #eab308; font-weight: bold', 'color: inherit', ...args);
+        }
+    }
+    /**
+     * Error log - always outputs (errors should always be visible)
+     */
+    error(message, ...args) {
+        if (this.isNode()) {
+            console.error(`\x1b[31m${this.prefix}\x1b[0m ${message}`, ...args);
+        }
+        else {
+            console.error(`%c${this.prefix}%c ${message}`, 'color: #ef4444; font-weight: bold', 'color: inherit', ...args);
+        }
+    }
+}
+exports.SDKLogger = SDKLogger;
 const assetDocument = `query asset($id: ID!) {
   asset(id: $id) {
     id
@@ -2203,6 +2254,7 @@ 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;
+        this.logger = new SDKLogger(config?.debug ?? false);
         // Custom fetch that captures session token from response headers
         const customFetch = async (url, options) => {
             const response = await fetch(url, options);
@@ -2230,26 +2282,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) {
+                    this.logger.log(`${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+                }
+                return result;
             }
             catch (wsError) {
-                console.warn('WebSocket request failed, falling back to HTTP:', wsError);
+                transport = 'WebSocket -> HTTP';
+                this.logger.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) {
+                this.logger.log(`${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+            }
+            return result;
         }
         catch (error) {
+            if (this.config.debug) {
+                this.logger.log(`${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
+            }
             this.handleError(error);
             throw error;
         }
@@ -2290,7 +2366,7 @@ class BaseGraphQLClient {
      * Handle GraphQL errors
      */
     handleError(error) {
-        console.error('GraphQL Error:', error);
+        this.logger.error('GraphQL Error:', error);
     }
     /**
      * Get WebSocket implementation for current environment
@@ -2310,7 +2386,7 @@ class BaseGraphQLClient {
             return require('ws');
         }
         catch (e) {
-            console.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
+            this.logger.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
             return undefined;
         }
     }
@@ -2329,7 +2405,7 @@ class BaseGraphQLClient {
         }
         const WebSocketImpl = this.getWebSocketImpl();
         if (!WebSocketImpl) {
-            console.warn('WebSocket not available. Will use HTTP fallback only.');
+            this.logger.warn('WebSocket not available. Will use HTTP fallback only.');
             return;
         }
         this.wsInitializing = new Promise((resolve, reject) => {
@@ -2358,7 +2434,7 @@ class BaseGraphQLClient {
                             return params;
                         }
                         catch (error) {
-                            console.error('Error in connectionParams:', error);
+                            this.logger.error('Error in connectionParams:', error);
                             return {};
                         }
                     },
@@ -2371,7 +2447,7 @@ class BaseGraphQLClient {
                     on: {
                         connected: () => {
                             this.wsConnected = true;
-                            console.log('WebSocket connected');
+                            this.logger.log('WebSocket connected');
                             if (!isResolved) {
                                 isResolved = true;
                                 resolve();
@@ -2380,13 +2456,13 @@ class BaseGraphQLClient {
                         closed: () => {
                             this.wsConnected = false;
                             if (!this.isDisposing) {
-                                console.log('WebSocket disconnected');
+                                this.logger.log('WebSocket disconnected');
                             }
                         },
                         error: (error) => {
                             // Suppress errors during disposal - they're expected
                             if (!this.isDisposing && this.wsConnected) {
-                                console.error('WebSocket error:', error);
+                                this.logger.error('WebSocket error:', error);
                             }
                             // Don't fail the connection on errors - let retry logic handle it
                             // Only log errors if we're connected (unexpected errors)
@@ -2398,7 +2474,7 @@ class BaseGraphQLClient {
                 this.wsInitializing = null;
             }
             catch (error) {
-                console.error('Failed to create WebSocket client:', error);
+                this.logger.error('Failed to create WebSocket client:', error);
                 this.wsInitializing = null;
                 // Resolve anyway to not block - we'll fallback to HTTP
                 if (!isResolved) {
@@ -3010,6 +3086,7 @@ class SearchOperations {
 class ShopNamespace {
     constructor(config) {
         this.client = new BaseGraphQLClient(config);
+        this.logger = new SDKLogger(config?.debug ?? false);
         this.asset = new AssetOperations(this.client);
         this.auth = new AuthOperations(this.client);
         this.blog = new BlogOperations(this.client);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgecart/sdk",
-  "version": "1.2.2",
+  "version": "1.2.5",
   "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:13:55.745Z
+ * Generated at: 2025-12-17T10:24:29.306Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -30,6 +30,60 @@ 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;
+}
+
+/**
+ * SDK Logger - Cross-platform logging with colors
+ * Respects debug flag for log/warn, errors are always visible
+ */
+export class SDKLogger {
+  private debug: boolean;
+  private prefix = '[ForgeCart SDK]';
+
+  constructor(debug: boolean = false) {
+    this.debug = debug;
+  }
+
+  private isNode(): boolean {
+    return typeof process !== 'undefined' && process.versions?.node != null;
+  }
+
+  /**
+   * Debug log - only outputs when debug: true
+   */
+  log(message: string, ...args: unknown[]): void {
+    if (!this.debug) return;
+    if (this.isNode()) {
+      console.log(`\x1b[36m${this.prefix}\x1b[0m ${message}`, ...args);
+    } else {
+      console.log(`%c${this.prefix}%c ${message}`, 'color: #06b6d4; font-weight: bold', 'color: inherit', ...args);
+    }
+  }
+
+  /**
+   * Warning log - only outputs when debug: true
+   */
+  warn(message: string, ...args: unknown[]): void {
+    if (!this.debug) return;
+    if (this.isNode()) {
+      console.warn(`\x1b[33m${this.prefix}\x1b[0m ${message}`, ...args);
+    } else {
+      console.warn(`%c${this.prefix}%c ${message}`, 'color: #eab308; font-weight: bold', 'color: inherit', ...args);
+    }
+  }
+
+  /**
+   * Error log - always outputs (errors should always be visible)
+   */
+  error(message: string, ...args: unknown[]): void {
+    if (this.isNode()) {
+      console.error(`\x1b[31m${this.prefix}\x1b[0m ${message}`, ...args);
+    } else {
+      console.error(`%c${this.prefix}%c ${message}`, 'color: #ef4444; font-weight: bold', 'color: inherit', ...args);
+    }
+  }
 }
 
 export type ActiveAdministratorQueryVariables = Types.ActiveAdministratorQueryVariables;
@@ -8170,11 +8224,13 @@ class BaseGraphQLClient {
   private endpoint: string;
   private wsEndpoint: string;
   private config: SDKConfig;
+  private logger: SDKLogger;
 
   constructor(config: SDKConfig) {
     this.endpoint = config.endpoint || 'https://api.forgecart.com/admin-api';
     this.wsEndpoint = config.wsEndpoint || 'wss://api.forgecart.com/admin-api';
     this.config = config;
+    this.logger = new SDKLogger(config?.debug ?? false);
 
     // Custom fetch that captures session token from response headers
     const customFetch = async (url: RequestInfo | URL, options?: RequestInit): Promise<Response> => {
@@ -8208,6 +8264,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,13 +8281,23 @@ 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) {
+          this.logger.log(`${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+        }
+        return result;
       } catch (wsError) {
-        console.warn('WebSocket request failed, falling back to HTTP:', wsError);
+        transport = 'WebSocket -> HTTP';
+        this.logger.warn('WebSocket request failed, falling back to HTTP:', wsError);
         // Fall through to HTTP
       }
     }
@@ -8230,8 +8305,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) {
+        this.logger.log(`${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+      }
+      return result;
     } catch (error) {
+      if (this.config.debug) {
+        this.logger.log(`${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
+      }
       this.handleError(error);
       throw error;
     }
@@ -8283,7 +8365,7 @@ class BaseGraphQLClient {
    * Handle GraphQL errors
    */
   private handleError(error: any): void {
-    console.error('GraphQL Error:', error);
+    this.logger.error('GraphQL Error:', error);
   }
 
   
@@ -8306,7 +8388,7 @@ class BaseGraphQLClient {
       // Dynamic import for Node.js
       return require('ws');
     } catch (e) {
-      console.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
+      this.logger.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
       return undefined;
     }
   }
@@ -8328,7 +8410,7 @@ class BaseGraphQLClient {
 
     const WebSocketImpl = this.getWebSocketImpl();
     if (!WebSocketImpl) {
-      console.warn('WebSocket not available. Will use HTTP fallback only.');
+      this.logger.warn('WebSocket not available. Will use HTTP fallback only.');
       return;
     }
 
@@ -8361,7 +8443,7 @@ class BaseGraphQLClient {
 
               return params;
             } catch (error) {
-              console.error('Error in connectionParams:', error);
+              this.logger.error('Error in connectionParams:', error);
               return {};
             }
           },
@@ -8374,7 +8456,7 @@ class BaseGraphQLClient {
           on: {
             connected: () => {
               this.wsConnected = true;
-              console.log('WebSocket connected');
+              this.logger.log('WebSocket connected');
               if (!isResolved) {
                 isResolved = true;
                 resolve();
@@ -8383,13 +8465,13 @@ class BaseGraphQLClient {
             closed: () => {
               this.wsConnected = false;
               if (!this.isDisposing) {
-                console.log('WebSocket disconnected');
+                this.logger.log('WebSocket disconnected');
               }
             },
             error: (error) => {
               // Suppress errors during disposal - they're expected
               if (!this.isDisposing && this.wsConnected) {
-                console.error('WebSocket error:', error);
+                this.logger.error('WebSocket error:', error);
               }
               // Don't fail the connection on errors - let retry logic handle it
               // Only log errors if we're connected (unexpected errors)
@@ -8401,7 +8483,7 @@ class BaseGraphQLClient {
         this.wsClient = createClient(wsOptions);
         this.wsInitializing = null;
       } catch (error) {
-        console.error('Failed to create WebSocket client:', error);
+        this.logger.error('Failed to create WebSocket client:', error);
         this.wsInitializing = null;
         // Resolve anyway to not block - we'll fallback to HTTP
         if (!isResolved) {
@@ -11055,6 +11137,7 @@ class ZoneOperations {
  */
 export class AdminNamespace {
   private client: BaseGraphQLClient;
+  private logger: SDKLogger;
 
   readonly administrator: AdministratorOperations;
   readonly asset: AssetOperations;
@@ -11113,6 +11196,7 @@ export class AdminNamespace {
 
   constructor(config: SDKConfig) {
     this.client = new BaseGraphQLClient(config);
+    this.logger = new SDKLogger(config?.debug ?? false);
 
     this.administrator = new AdministratorOperations(this.client);
     this.asset = new AssetOperations(this.client);
@@ -11247,7 +11331,7 @@ export class AdminNamespace {
       }
     } catch (error) {
       if (this.isListening) {
-        console.error('Event subscription error:', error);
+        this.logger.error('Event subscription error:', error);
         await this.handleReconnect();
       }
     }
@@ -11268,7 +11352,7 @@ export class AdminNamespace {
     );
 
     this.retryCount++;
-    console.log(`Reconnecting in ${delay}ms (attempt ${this.retryCount}/${maxRetries})`);
+    this.logger.log(`Reconnecting in ${delay}ms (attempt ${this.retryCount}/${maxRetries})`);
 
     await new Promise(resolve => setTimeout(resolve, delay));
     await this.startSubscription();
@@ -11287,7 +11371,7 @@ export class AdminNamespace {
         try {
           handler(event);
         } catch (error) {
-          console.error(`Error in event handler for ${eventName}:`, error);
+          this.logger.error(`Error in event handler for ${eventName}:`, error);
         }
       }
     }
@@ -11303,7 +11387,7 @@ export class AdminNamespace {
             `Blocking handler for ${eventName} exceeded ${AdminNamespace.BLOCKING_TIMEOUT_MS}ms`
           );
         } catch (error) {
-          console.error(`Error in blocking event handler for ${eventName}:`, error);
+          this.logger.error(`Error in blocking event handler for ${eventName}:`, error);
           throw error; // Re-throw for blocking handlers
         }
       }

package/src/admin-types.ts

@@ -1063,6 +1063,7 @@ export type CreateCustomerInput = {
 export type CreateCustomerResult = Customer | EmailAddressConflictError;
 
 export type CreateDeploymentInput = {
+  envVars?: InputMaybe<Array<EnvVarInput>>;
   type: DeploymentType;
 };
 
@@ -2095,6 +2096,11 @@ export type EntityEventType =
   | 'removed'
   | 'updated';
 
+export type EnvVarInput = {
+  key: Scalars['String']['input'];
+  value: Scalars['String']['input'];
+};
+
 export type ErrorCode =
   | 'ALREADY_REFUNDED_ERROR'
   | 'CANCEL_ACTIVE_ORDER_ERROR'
@@ -7389,9 +7395,8 @@ export type SessionInput = {
 export type SetCustomerForDraftOrderResult = EmailAddressConflictError | Order;
 
 export type SetEnvInput = {
-  key: Scalars['String']['input'];
+  envVars: Array<EnvVarInput>;
   type: DeploymentType;
-  value: Scalars['String']['input'];
 };
 
 export type SetOrderCustomerInput = {
@@ -8078,7 +8083,7 @@ export type TransitionOrderToStateResult = Order | OrderStateTransitionError;
 export type TransitionPaymentToStateResult = Payment | PaymentStateTransitionError;
 
 export type UnsetEnvInput = {
-  key: Scalars['String']['input'];
+  keys: Array<Scalars['String']['input']>;
   type: DeploymentType;
 };
 

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:13:55.632Z
+ * Generated at: 2025-12-17T10:24:29.175Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -30,6 +30,60 @@ 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;
+}
+
+/**
+ * SDK Logger - Cross-platform logging with colors
+ * Respects debug flag for log/warn, errors are always visible
+ */
+export class SDKLogger {
+  private debug: boolean;
+  private prefix = '[ForgeCart SDK]';
+
+  constructor(debug: boolean = false) {
+    this.debug = debug;
+  }
+
+  private isNode(): boolean {
+    return typeof process !== 'undefined' && process.versions?.node != null;
+  }
+
+  /**
+   * Debug log - only outputs when debug: true
+   */
+  log(message: string, ...args: unknown[]): void {
+    if (!this.debug) return;
+    if (this.isNode()) {
+      console.log(`\x1b[36m${this.prefix}\x1b[0m ${message}`, ...args);
+    } else {
+      console.log(`%c${this.prefix}%c ${message}`, 'color: #06b6d4; font-weight: bold', 'color: inherit', ...args);
+    }
+  }
+
+  /**
+   * Warning log - only outputs when debug: true
+   */
+  warn(message: string, ...args: unknown[]): void {
+    if (!this.debug) return;
+    if (this.isNode()) {
+      console.warn(`\x1b[33m${this.prefix}\x1b[0m ${message}`, ...args);
+    } else {
+      console.warn(`%c${this.prefix}%c ${message}`, 'color: #eab308; font-weight: bold', 'color: inherit', ...args);
+    }
+  }
+
+  /**
+   * Error log - always outputs (errors should always be visible)
+   */
+  error(message: string, ...args: unknown[]): void {
+    if (this.isNode()) {
+      console.error(`\x1b[31m${this.prefix}\x1b[0m ${message}`, ...args);
+    } else {
+      console.error(`%c${this.prefix}%c ${message}`, 'color: #ef4444; font-weight: bold', 'color: inherit', ...args);
+    }
+  }
 }
 
 export type AssetQueryVariables = Types.AssetQueryVariables;
@@ -2494,11 +2548,13 @@ class BaseGraphQLClient {
   private endpoint: string;
   private wsEndpoint: string;
   private config: SDKConfig;
+  private logger: SDKLogger;
 
   constructor(config: SDKConfig) {
     this.endpoint = config.endpoint || 'https://api.forgecart.com/shop-api';
     this.wsEndpoint = config.wsEndpoint || 'wss://api.forgecart.com/shop-api';
     this.config = config;
+    this.logger = new SDKLogger(config?.debug ?? false);
 
     // Custom fetch that captures session token from response headers
     const customFetch = async (url: RequestInfo | URL, options?: RequestInit): Promise<Response> => {
@@ -2532,6 +2588,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,13 +2605,23 @@ 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) {
+          this.logger.log(`${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+        }
+        return result;
       } catch (wsError) {
-        console.warn('WebSocket request failed, falling back to HTTP:', wsError);
+        transport = 'WebSocket -> HTTP';
+        this.logger.warn('WebSocket request failed, falling back to HTTP:', wsError);
         // Fall through to HTTP
       }
     }
@@ -2554,8 +2629,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) {
+        this.logger.log(`${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+      }
+      return result;
     } catch (error) {
+      if (this.config.debug) {
+        this.logger.log(`${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
+      }
       this.handleError(error);
       throw error;
     }
@@ -2607,7 +2689,7 @@ class BaseGraphQLClient {
    * Handle GraphQL errors
    */
   private handleError(error: any): void {
-    console.error('GraphQL Error:', error);
+    this.logger.error('GraphQL Error:', error);
   }
 
   
@@ -2630,7 +2712,7 @@ class BaseGraphQLClient {
       // Dynamic import for Node.js
       return require('ws');
     } catch (e) {
-      console.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
+      this.logger.warn('WebSocket not available. Install "ws" package for Node.js support or provide webSocketImpl in config.');
       return undefined;
     }
   }
@@ -2652,7 +2734,7 @@ class BaseGraphQLClient {
 
     const WebSocketImpl = this.getWebSocketImpl();
     if (!WebSocketImpl) {
-      console.warn('WebSocket not available. Will use HTTP fallback only.');
+      this.logger.warn('WebSocket not available. Will use HTTP fallback only.');
       return;
     }
 
@@ -2685,7 +2767,7 @@ class BaseGraphQLClient {
 
               return params;
             } catch (error) {
-              console.error('Error in connectionParams:', error);
+              this.logger.error('Error in connectionParams:', error);
               return {};
             }
           },
@@ -2698,7 +2780,7 @@ class BaseGraphQLClient {
           on: {
             connected: () => {
               this.wsConnected = true;
-              console.log('WebSocket connected');
+              this.logger.log('WebSocket connected');
               if (!isResolved) {
                 isResolved = true;
                 resolve();
@@ -2707,13 +2789,13 @@ class BaseGraphQLClient {
             closed: () => {
               this.wsConnected = false;
               if (!this.isDisposing) {
-                console.log('WebSocket disconnected');
+                this.logger.log('WebSocket disconnected');
               }
             },
             error: (error) => {
               // Suppress errors during disposal - they're expected
               if (!this.isDisposing && this.wsConnected) {
-                console.error('WebSocket error:', error);
+                this.logger.error('WebSocket error:', error);
               }
               // Don't fail the connection on errors - let retry logic handle it
               // Only log errors if we're connected (unexpected errors)
@@ -2725,7 +2807,7 @@ class BaseGraphQLClient {
         this.wsClient = createClient(wsOptions);
         this.wsInitializing = null;
       } catch (error) {
-        console.error('Failed to create WebSocket client:', error);
+        this.logger.error('Failed to create WebSocket client:', error);
         this.wsInitializing = null;
         // Resolve anyway to not block - we'll fallback to HTTP
         if (!isResolved) {
@@ -3405,6 +3487,7 @@ class SearchOperations {
  */
 export class ShopNamespace {
   private client: BaseGraphQLClient;
+  private logger: SDKLogger;
 
   readonly asset: AssetOperations;
   readonly auth: AuthOperations;
@@ -3422,6 +3505,7 @@ export class ShopNamespace {
 
   constructor(config: SDKConfig) {
     this.client = new BaseGraphQLClient(config);
+    this.logger = new SDKLogger(config?.debug ?? false);
 
     this.asset = new AssetOperations(this.client);
     this.auth = new AuthOperations(this.client);