fa-mcp-sdk 0.2.243 → 0.2.247

package/cli-template/.env.example

@@ -1,4 +1,8 @@
+# SERVICE_NAME - service name. If this variable is not specified, it is taken from package.json.name
 SERVICE_NAME={{project.name}}
+# PRODUCT_NAME - If this variable is not specified, it is taken from package.json.productName
+# PRODUCT_NAME=
+
 NODE_ENV={{NODE_ENV}}
 # Used for PM2
 SERVICE_INSTANCE={{SERVICE_INSTANCE}}

package/cli-template/FA-MCP-SDK-DOC/04-authentication.md

@@ -574,7 +574,7 @@ function generateTokenApp(port?: number): Server;
 generateTokenApp();
 
 // Start on custom port
-generateTokenApp(8080);
+generateTokenApp(1234);
 
 // Can also be run directly from command line:
 // npx ts-node node_modules/fa-mcp-sdk/dist/core/auth/token-generator/server.js

package/cli-template/FA-MCP-SDK-DOC/06-utilities.md

@@ -310,9 +310,9 @@ import { isPortAvailable, checkPortAvailability } from 'fa-mcp-sdk';
 function isPortAvailable (port: number, host: string = '0.0.0.0'): Promise<boolean> {...}
 
 // Examples:
-const available1 = await isPortAvailable(3000);                    // Check on all interfaces
-const available2 = await isPortAvailable(3000, 'localhost');       // Check on localhost
-const available3 = await isPortAvailable(8080, '192.168.1.10');   // Check on specific IP
+const available1 = await isPortAvailable(1234);                    // Check on all interfaces
+const available2 = await isPortAvailable(1234, 'localhost');       // Check on localhost
+const available3 = await isPortAvailable(1234, '192.168.1.10');   // Check on specific IP
 
 if (available1) {
   console.log('Port 3000 is available');

package/cli-template/eslint.config.js

@@ -29,14 +29,19 @@ export default [
     rules: {
       ...tsPlugin.configs.recommended.rules,
       '@typescript-eslint/ban-ts-comment': 'off',
-      '@typescript-eslint/no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': ['warn', {
+        'argsIgnorePattern': '^_',
+        'varsIgnorePattern': '^_',
+        'caughtErrorsIgnorePattern': '^_',
+        'ignoreRestSiblings': true,
+      }],
       '@typescript-eslint/no-unsafe-function-type': 'off',
       'unused-imports/no-unused-imports': 'error',
       'unused-imports/no-unused-vars': ['warn', {
         'argsIgnorePattern': '^_',
         'varsIgnorePattern': '^_',
         'caughtErrorsIgnorePattern': '^_',
-        'ignoreRestSiblings': true
+        'ignoreRestSiblings': true,
       }],
       '@typescript-eslint/no-explicit-any': 'off',
       '@typescript-eslint/no-unsafe-member-access': 'off',
@@ -45,9 +50,9 @@ export default [
         'ts': 'never',
         'js': 'always',
         'pattern': {
-          '**/*.ts': 'always'
+          '**/*.ts': 'always',
         },
-        'ignorePackages': true
+        'ignorePackages': true,
       }],
       // Formatting rules
       'semi': ['error', 'always'],
@@ -55,7 +60,7 @@ export default [
       'space-before-function-paren': ['error', {
         'anonymous': 'always',
         'named': 'always',
-        'asyncArrow': 'always'
+        'asyncArrow': 'always',
       }],
       'object-curly-spacing': ['error', 'always'],
       'curly': ['error', 'all'],
@@ -80,13 +85,21 @@ export default [
     },
     rules: {
       'import/no-default-export': 'off',
+      // Unused variables/imports rules
+      'unused-imports/no-unused-imports': 'warn',
+      'unused-imports/no-unused-vars': ['warn', {
+        'argsIgnorePattern': '^_',
+        'varsIgnorePattern': '^_',
+        'caughtErrorsIgnorePattern': '^_',
+        'ignoreRestSiblings': true,
+      }],
       // Formatting rules
       'semi': ['error', 'always'],
       'quotes': ['error', 'single', { 'avoidEscape': true }],
       'space-before-function-paren': ['error', {
         'anonymous': 'always',
         'named': 'always',
-        'asyncArrow': 'always'
+        'asyncArrow': 'always',
       }],
       'object-curly-spacing': ['error', 'always'],
       'curly': ['error', 'all'],

package/cli-template/package.json

@@ -47,7 +47,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
     "dotenv": "^17.2.3",
-    "fa-mcp-sdk": "^0.2.243"
+    "fa-mcp-sdk": "^0.2.247"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",

package/config/default.yaml

@@ -78,7 +78,7 @@ consul:
       token: '***'
   service:
     enable: {{consul.service.enable}} # true - Allows registration of the service with the consul
-    name: <name> # Here you can specify an alternative name for the service. String "<name>" will be replaced by <package.json>.name at initialization
+    name: <name> # Here you can specify an alternative name for the service. String "<name>" will be replaced by env SERVICE_NAME | <package.json>.name at initialization
     instance: '{{SERVICE_INSTANCE}}' # This value will be specified as a suffix in the id of the service
     version: <version> # String "<version>" will be replaced by <package.json>.version at initialization
     description: <description> # Here you can specify an alternative name description. String "<description>" will be replaced by <package.json>.description at initialization

package/dist/core/bootstrap/init-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-config.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/init-config.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,eAAO,MAAM,MAAM,EAAE,SAAwC,CAAC;AAK9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiDpD,eAAO,MAAM,SAAS,EAAE,SAAyB,CAAC;AAElD;;GAEG;AACH,wBAAgB,gBAAgB,IAAK,GAAG,CASvC;AAED,wBAAgB,cAAc,IAAK,aAAa,CAE/C"}
+{"version":3,"file":"init-config.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/init-config.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,eAAO,MAAM,MAAM,EAAE,SAAwC,CAAC;AAK9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoDpD,eAAO,MAAM,SAAS,EAAE,SAAyB,CAAC;AAElD;;GAEG;AACH,wBAAgB,gBAAgB,IAAK,GAAG,CASvC;AAED,wBAAgB,cAAc,IAAK,aAAa,CAE/C"}

package/dist/core/bootstrap/init-config.js

@@ -5,7 +5,10 @@ export const config = configModule.util.toObject();
 import { readFileSync } from 'fs';
 import * as path from 'path';
 import { trim } from '../utils/utils.js';
-const { name, productName, version, description, keywords, repository, homepage } = JSON.parse(readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'));
+const pj = JSON.parse(readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'));
+const { version, description, keywords, repository, homepage } = pj;
+const name = process.env.SERVICE_NAME || pj.name;
+const productName = process.env.PRODUCT_NAME || pj.productName;
 /**
  * Build application configuration from YAML and environment variables
  * Priority: environment variables > config.yaml > defaults

package/dist/core/bootstrap/init-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-config.js","sourceRoot":"","sources":["../../../src/core/bootstrap/init-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init-config.js","sourceRoot":"","sources":["../../../src/core/bootstrap/init-config.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,aAAa,CAAC,CAAE,mCAAmC;AAC1D,OAAO,YAAY,MAAM,QAAQ,CAAC;AAGlC,MAAM,CAAC,MAAM,MAAM,GAAc,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACvF,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AACpE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,IAAI,CAAC;AACjD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,WAAW,CAAC;AAE/D;;;GAGG;AACH,SAAS,WAAW;IAClB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAc;QACrB,GAAG,MAAM;QACT,qCAAqC;QACrC,IAAI;QACJ,SAAS;QACT,WAAW;QACX,OAAO;QACP,WAAW;KACZ,CAAC;IAEF,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxB,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QAC9B,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,KAAK,eAAe,EAAE,CAAC;QACtC,CAAC,CAAC,WAAW,GAAG,WAAW,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC;IACpB,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;IACzF,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,2EAA2E,CAAC;IAC1F,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,qBAAwD,CAAC;IAC1F,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,qBAAqB,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAc,WAAW,EAAE,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa;IAEnE,yBAAyB;IACzB,IAAI,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,oBAAoB,CAAC;AACrC,CAAC"}

package/dist/core/web/static/home/script.js

@@ -2,7 +2,6 @@
 let toolsData = [];
 let resourcesData = [];
 let promptsData = [];
-let pageData = {};
 
 // Set primary color CSS variable
 function setPrimaryColor (color) {
@@ -133,7 +132,6 @@ async function loadPageData () {
     }
 
     const data = await response.json();
-    pageData = data;
 
     // Set theme color
     setPrimaryColor(data.primaryColor);
@@ -155,6 +153,7 @@ async function loadPageData () {
   }
 }
 
+// eslint-disable-next-line unused-imports/no-unused-vars
 function openModal (sectionName) {
   const modal = document.getElementById(sectionName + '-modal');
   const tableBody = document.getElementById(sectionName + '-table').querySelector('tbody');
@@ -272,6 +271,7 @@ function generatePromptsTableRows (prompts) {
   ).join('');
 }
 
+// eslint-disable-next-line unused-imports/no-unused-vars
 function toggleDetails (sectionName, index) {
   const detailRow = document.getElementById(sectionName + '-detail-' + index);
   const toggleLink = document.getElementById(sectionName + '-toggle-' + index);
@@ -322,6 +322,7 @@ function toggleDetails (sectionName, index) {
 }
 
 // Handle prompt details and prompt content display
+// eslint-disable-next-line unused-imports/no-unused-vars
 async function togglePromptDetails (sectionName, index, displayType) {
   const detailRow = document.getElementById(sectionName + '-detail-' + index);
   const toggleLinkDetails = document.getElementById(sectionName + '-toggle-details-' + index);
@@ -414,6 +415,7 @@ async function togglePromptDetails (sectionName, index, displayType) {
 }
 
 // Handle resource details and resource content display
+// eslint-disable-next-line unused-imports/no-unused-vars
 async function toggleResourceDetails (sectionName, index, displayType) {
   const detailRow = document.getElementById(sectionName + '-detail-' + index);
   const toggleLinkDetails = document.getElementById(sectionName + '-toggle-details-' + index);
@@ -516,6 +518,7 @@ async function toggleResourceDetails (sectionName, index, displayType) {
 }
 
 // Health Check Modal
+// eslint-disable-next-line unused-imports/no-unused-vars
 async function openHealthCheckModal () {
   const modal = document.getElementById('health-modal');
   const loading = document.getElementById('health-loading');
@@ -599,7 +602,7 @@ function addCopyButton (contentElement) {
         notification.classList.remove('show');
       }, 1000);
 
-    } catch (err) {
+    } catch {
       // Fallback for browsers that don't support clipboard API
       const textArea = document.createElement('textarea');
       textArea.value = textToCopy;

package/dist/core/web/static/token-gen/script.js

@@ -104,7 +104,7 @@ async function initializeAuth () {
           showTokenModal('Token is invalid or expired.');
           return false;
         }
-      } catch (error) {
+      } catch {
         // authFetch already handles 401 and shows modal
         return false;
       }
@@ -207,6 +207,7 @@ function addKeyValuePair (key = '', value = '', readonly = false, placeholder =
   keyValuePairCount++;
 }
 
+// eslint-disable-next-line unused-imports/no-unused-vars
 function removeKeyValuePair (button) {
   button.parentElement.remove();
   keyValuePairCount--;
@@ -251,7 +252,7 @@ function addCopyButtonToTokenOutput (tokenOutput, token) {
         notification.classList.remove('show');
       }, 1000);
 
-    } catch (err) {
+    } catch {
       // Fallback for browsers that don't support clipboard API
       const textArea = document.createElement('textarea');
       textArea.value = token;
@@ -504,6 +505,7 @@ async function initializeForm () {
 }
 
 // Logout function
+// eslint-disable-next-line unused-imports/no-unused-vars
 async function logout () {
   try {
     // For token-based auth, just clear the stored token

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fa-mcp-sdk",
   "productName": "FA MCP SDK",
-  "version": "0.2.243",
+  "version": "0.2.247",
   "description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",

package/scripts/kill-port.js

@@ -27,7 +27,7 @@ async function killProcessOnPort (portNumber) {
       try {
         const result = await execAsync(`netstat -ano | findstr :${portNumber}`);
         stdout = result.stdout;
-      } catch (error) {
+      } catch {
         // findstr returns error when no matches found
         console.log(`No process found on port ${portNumber}`);
         return;