@forgecart/sdk 1.2.3 → 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-15T13:49:08.285Z
+ * Generated at: 2025-12-17T10:24:29.306Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -28,6 +28,28 @@ export interface SDKConfig {
     /** 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;
 export type ActiveAdministratorQueryResult = Types.ActiveAdministratorQuery;
@@ -991,6 +1013,7 @@ declare class BaseGraphQLClient {
     private endpoint;
     private wsEndpoint;
     private config;
+    private logger;
     constructor(config: SDKConfig);
     /**
      * Extract operation name from GraphQL document
@@ -2576,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-15T13:49:08.285Z
+ * 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);
@@ -6936,13 +6988,13 @@ class BaseGraphQLClient {
                 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`);
+                    this.logger.log(`${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);
+                this.logger.warn('WebSocket request failed, falling back to HTTP:', wsError);
                 // Fall through to HTTP
             }
         }
@@ -6950,13 +7002,13 @@ class BaseGraphQLClient {
         try {
             const result = await this.httpClient.request(document, variables);
             if (this.config.debug) {
-                console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+                this.logger.log(`${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.logger.log(`${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
             }
             this.handleError(error);
             throw error;
@@ -6998,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
@@ -7018,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;
         }
     }
@@ -7037,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) => {
@@ -7066,7 +7118,7 @@ class BaseGraphQLClient {
                             return params;
                         }
                         catch (error) {
-                            console.error('Error in connectionParams:', error);
+                            this.logger.error('Error in connectionParams:', error);
                             return {};
                         }
                     },
@@ -7079,7 +7131,7 @@ class BaseGraphQLClient {
                     on: {
                         connected: () => {
                             this.wsConnected = true;
-                            console.log('WebSocket connected');
+                            this.logger.log('WebSocket connected');
                             if (!isResolved) {
                                 isResolved = true;
                                 resolve();
@@ -7088,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)
@@ -7106,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) {
@@ -9441,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);
@@ -9554,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();
             }
         }
@@ -9568,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();
     }
@@ -9585,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);
                 }
             }
         }
@@ -9597,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/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-15T13:49:08.152Z
+ * Generated at: 2025-12-17T10:24:29.175Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -28,6 +28,28 @@ export interface SDKConfig {
     /** 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;
 export type AssetQueryResult = Types.AssetQuery;
@@ -247,6 +269,7 @@ declare class BaseGraphQLClient {
     private endpoint;
     private wsEndpoint;
     private config;
+    private logger;
     constructor(config: SDKConfig);
     /**
      * Extract operation name from GraphQL document
@@ -663,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-15T13:49:08.152Z
+ * 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);
@@ -2252,13 +2304,13 @@ class BaseGraphQLClient {
                 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`);
+                    this.logger.log(`${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);
+                this.logger.warn('WebSocket request failed, falling back to HTTP:', wsError);
                 // Fall through to HTTP
             }
         }
@@ -2266,13 +2318,13 @@ class BaseGraphQLClient {
         try {
             const result = await this.httpClient.request(document, variables);
             if (this.config.debug) {
-                console.log(`[ForgeCart SDK] ${operationName} (${transport}) - ${(performance.now() - startTime).toFixed(0)}ms`);
+                this.logger.log(`${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.logger.log(`${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
             }
             this.handleError(error);
             throw error;
@@ -2314,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
@@ -2334,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;
         }
     }
@@ -2353,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) => {
@@ -2382,7 +2434,7 @@ class BaseGraphQLClient {
                             return params;
                         }
                         catch (error) {
-                            console.error('Error in connectionParams:', error);
+                            this.logger.error('Error in connectionParams:', error);
                             return {};
                         }
                     },
@@ -2395,7 +2447,7 @@ class BaseGraphQLClient {
                     on: {
                         connected: () => {
                             this.wsConnected = true;
-                            console.log('WebSocket connected');
+                            this.logger.log('WebSocket connected');
                             if (!isResolved) {
                                 isResolved = true;
                                 resolve();
@@ -2404,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)
@@ -2422,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) {
@@ -3034,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.3",
+  "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-15T13:49:08.285Z
+ * Generated at: 2025-12-17T10:24:29.306Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -34,6 +34,58 @@ export interface SDKConfig {
   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;
 export type ActiveAdministratorQuery = Types.ActiveAdministratorQuery;
 export type ActiveAdministratorQueryResult = Types.ActiveAdministratorQuery;
@@ -8172,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> => {
@@ -8238,12 +8292,12 @@ class BaseGraphQLClient {
         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`);
+          this.logger.log(`${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);
+        this.logger.warn('WebSocket request failed, falling back to HTTP:', wsError);
         // Fall through to HTTP
       }
     }
@@ -8253,12 +8307,12 @@ class BaseGraphQLClient {
     try {
       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`);
+        this.logger.log(`${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.logger.log(`${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
       }
       this.handleError(error);
       throw error;
@@ -8311,7 +8365,7 @@ class BaseGraphQLClient {
    * Handle GraphQL errors
    */
   private handleError(error: any): void {
-    console.error('GraphQL Error:', error);
+    this.logger.error('GraphQL Error:', error);
   }
 
   
@@ -8334,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;
     }
   }
@@ -8356,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;
     }
 
@@ -8389,7 +8443,7 @@ class BaseGraphQLClient {
 
               return params;
             } catch (error) {
-              console.error('Error in connectionParams:', error);
+              this.logger.error('Error in connectionParams:', error);
               return {};
             }
           },
@@ -8402,7 +8456,7 @@ class BaseGraphQLClient {
           on: {
             connected: () => {
               this.wsConnected = true;
-              console.log('WebSocket connected');
+              this.logger.log('WebSocket connected');
               if (!isResolved) {
                 isResolved = true;
                 resolve();
@@ -8411,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)
@@ -8429,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) {
@@ -11083,6 +11137,7 @@ class ZoneOperations {
  */
 export class AdminNamespace {
   private client: BaseGraphQLClient;
+  private logger: SDKLogger;
 
   readonly administrator: AdministratorOperations;
   readonly asset: AssetOperations;
@@ -11141,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);
@@ -11275,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();
       }
     }
@@ -11296,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();
@@ -11315,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);
         }
       }
     }
@@ -11331,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/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-15T13:49:08.152Z
+ * Generated at: 2025-12-17T10:24:29.175Z
  * Generator version: 1.0.0
  *
  * 🤖 Generated with ForgeCart SDK Generator
@@ -34,6 +34,58 @@ export interface SDKConfig {
   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;
 export type AssetQuery = Types.AssetQuery;
 export type AssetQueryResult = Types.AssetQuery;
@@ -2496,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> => {
@@ -2562,12 +2616,12 @@ class BaseGraphQLClient {
         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`);
+          this.logger.log(`${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);
+        this.logger.warn('WebSocket request failed, falling back to HTTP:', wsError);
         // Fall through to HTTP
       }
     }
@@ -2577,12 +2631,12 @@ class BaseGraphQLClient {
     try {
       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`);
+        this.logger.log(`${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.logger.log(`${operationName} (${transport}) - FAILED after ${(performance.now() - startTime).toFixed(0)}ms`);
       }
       this.handleError(error);
       throw error;
@@ -2635,7 +2689,7 @@ class BaseGraphQLClient {
    * Handle GraphQL errors
    */
   private handleError(error: any): void {
-    console.error('GraphQL Error:', error);
+    this.logger.error('GraphQL Error:', error);
   }
 
   
@@ -2658,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;
     }
   }
@@ -2680,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;
     }
 
@@ -2713,7 +2767,7 @@ class BaseGraphQLClient {
 
               return params;
             } catch (error) {
-              console.error('Error in connectionParams:', error);
+              this.logger.error('Error in connectionParams:', error);
               return {};
             }
           },
@@ -2726,7 +2780,7 @@ class BaseGraphQLClient {
           on: {
             connected: () => {
               this.wsConnected = true;
-              console.log('WebSocket connected');
+              this.logger.log('WebSocket connected');
               if (!isResolved) {
                 isResolved = true;
                 resolve();
@@ -2735,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)
@@ -2753,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) {
@@ -3433,6 +3487,7 @@ class SearchOperations {
  */
 export class ShopNamespace {
   private client: BaseGraphQLClient;
+  private logger: SDKLogger;
 
   readonly asset: AssetOperations;
   readonly auth: AuthOperations;
@@ -3450,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);