snow-flow 3.0.15 → 3.0.16

package/dist/mcp/servicenow-deployment-mcp.js

@@ -637,7 +637,9 @@ Your widget is deployed and ready for testing in Service Portal.`
                         this.logger.info('✅ Direct deployment successful');
                     }
                     else {
-                        throw new Error(`Widget creation failed: ${result?.error || 'Unknown error'}`);
+                        // Include detailed error information
+                        const errorDetails = result?.details ? JSON.stringify(result.details, null, 2) : '';
+                        throw new Error(`Widget creation failed: ${result?.error || 'Unknown error'}${errorDetails ? '\nDetails: ' + errorDetails : ''}`);
                     }
                 }
                 catch (error) {

package/dist/utils/servicenow-client.d.ts

@@ -46,6 +46,7 @@ export interface ServiceNowAPIResponse<T> {
     data?: T;
     error?: string;
     result?: T[];
+    details?: any;
 }
 export declare class ServiceNowClient {
     private client;

package/dist/utils/servicenow-client.js

@@ -668,39 +668,91 @@ class ServiceNowClient {
             }
             // Ensure we have credentials before making the API call
             await this.ensureAuthenticated();
-            const response = await this.client.post(`${this.getBaseUrl()}/api/now/table/sp_widget`, {
+            // Log the request details for debugging
+            const widgetData = {
                 name: widget.name,
-                id: widget.id,
+                id: widget.id || widget.name, // Ensure id is set
                 title: widget.title,
-                description: widget.description,
+                description: widget.description || '',
                 template: widget.template,
-                css: widget.css,
-                client_script: widget.client_script,
-                script: widget.server_script, // Service Portal uses 'script' not 'server_script'
+                css: widget.css || '',
+                client_script: widget.client_script || '',
+                script: widget.server_script || '', // Service Portal uses 'script' not 'server_script'
                 option_schema: widget.option_schema || '[]',
                 demo_data: widget.demo_data || '{}',
-                has_preview: widget.has_preview || false,
-                category: widget.category || 'custom'
-            }, {
+                has_preview: widget.has_preview !== false, // Default to true
+                category: widget.category || 'custom',
+                active: true // Ensure widget is active
+            };
+            this.logger.info('Widget data to be sent:', widgetData);
+            const response = await this.client.post(`${this.getBaseUrl()}/api/now/table/sp_widget`, widgetData, {
                 timeout: this.deploymentTimeout, // Use deployment-specific timeout
                 headers: {
                     'X-Operation-Type': 'deployment' // Mark as deployment operation
                 }
             });
             this.logger.info('✅ Widget created successfully!');
-            this.logger.info(`🆔 Widget ID: ${response.data.result.sys_id}`);
+            // Handle different response structures from ServiceNow
+            const widgetResult = response.data.result || response.data;
+            const sysId = widgetResult.sys_id;
+            if (!sysId) {
+                this.logger.warn('⚠️ Widget created but no sys_id returned. Response:', response.data);
+                throw new Error('Widget creation succeeded but no sys_id was returned');
+            }
+            this.logger.info(`🆔 Widget ID: ${sysId}`);
             // Add post-deployment verification
-            await this.verifyDeployment(response.data.result.sys_id, 'widget');
+            await this.verifyDeployment(sysId, 'widget');
             return {
                 success: true,
-                data: response.data.result
+                data: widgetResult
             };
         }
         catch (error) {
             console.error('❌ Failed to create widget:', error);
+            // Better error handling for axios errors
+            let errorMessage = 'Unknown error';
+            let errorDetails = {};
+            if (error.response) {
+                // The request was made and the server responded with a status code
+                // that falls out of the range of 2xx
+                errorMessage = `HTTP ${error.response.status}: ${error.response.statusText || 'Request failed'}`;
+                errorDetails = {
+                    status: error.response.status,
+                    statusText: error.response.statusText,
+                    data: error.response.data,
+                    headers: error.response.headers
+                };
+                // Extract ServiceNow specific error message if available
+                if (error.response.data?.error?.message) {
+                    errorMessage = `ServiceNow Error: ${error.response.data.error.message}`;
+                }
+                else if (error.response.data?.error) {
+                    errorMessage = `ServiceNow Error: ${JSON.stringify(error.response.data.error)}`;
+                }
+                else if (error.response.status === 401) {
+                    errorMessage = 'Authentication failed: Invalid or expired token. Run: snow-flow auth login';
+                }
+                else if (error.response.status === 403) {
+                    errorMessage = 'Permission denied: User lacks sp_admin role or widget creation permissions';
+                }
+                else if (error.response.status === 404) {
+                    errorMessage = 'API endpoint not found: ServiceNow instance may not have Service Portal installed';
+                }
+            }
+            else if (error.request) {
+                // The request was made but no response was received
+                errorMessage = 'No response from ServiceNow - check network connection and instance URL';
+                errorDetails = { request: error.config?.url };
+            }
+            else {
+                // Something happened in setting up the request that triggered an Error
+                errorMessage = error.message || String(error);
+            }
+            this.logger.error('Widget creation error details:', errorDetails);
             return {
                 success: false,
-                error: error instanceof Error ? error.message : String(error)
+                error: errorMessage,
+                details: errorDetails
             };
         }
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "snow-flow",
-  "version": "3.0.15",
-  "description": "Snow-Flow v3.0.15: FLOW/WORKFLOW DEPRECATION 🚫 Flows, workflows, and subflows have been officially deprecated and are no longer supported. Focus is now entirely on widgets, applications, and direct ServiceNow development. All flow-related features have been marked as deprecated. Use widgets and applications for UI development instead.",
+  "version": "3.0.16",
+  "description": "Snow-Flow v3.0.16: WIDGET DEPLOYMENT ERROR FIX! 🔧 Fixed 'error: null' issue in widget deployment. Enhanced error reporting for failed POST requests to /api/now/table/sp_widget. Now provides detailed HTTP status codes, ServiceNow-specific error messages, and better debugging information. Widget deployment failures now show exact cause (401 auth, 403 permissions, 404 endpoint, etc).",
   "main": "dist/index.js",
   "type": "commonjs",
   "bin": {