@global-packages/mcp-kit 1.0.0 → 1.0.3

package/dist/utils/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAGA,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAK/E;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpF"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAQA;;GAEG;AAEH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAOzE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMvE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhE"}

package/dist/utils/fs.js

@@ -1,30 +1,94 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureDirForFile = ensureDirForFile;
-exports.pathExists = pathExists;
-exports.readJsonSafe = readJsonSafe;
-exports.writeJsonAtomic = writeJsonAtomic;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const node_path_1 = __importDefault(require("node:path"));
-async function ensureDirForFile(filePath) {
-    await fs_extra_1.default.mkdirp(node_path_1.default.dirname(filePath));
-}
-async function pathExists(filePath) {
-    return fs_extra_1.default.pathExists(filePath);
-}
-async function readJsonSafe(filePath, fallback) {
-    if (!(await fs_extra_1.default.pathExists(filePath))) {
-        return fallback;
-    }
-    return fs_extra_1.default.readJSON(filePath);
-}
-async function writeJsonAtomic(filePath, data) {
-    await ensureDirForFile(filePath);
-    const tmpPath = `${filePath}.tmp`;
-    await fs_extra_1.default.writeFile(tmpPath, JSON.stringify(data, null, 2), "utf8");
-    await fs_extra_1.default.rename(tmpPath, filePath);
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import fsExtra from 'fs-extra';
+//--------------------------------------------------------------
+// Safe file system helpers 
+//--------------------------------------------------------------
+/**
+ * Read and parse a JSON file. Returns null if the file doesn't exist or is invalid.
+ */
+export async function safeReadJSON(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write an object to a JSON file, creating directories as needed.
+ */
+export async function safeWriteJSON(filePath, data) {
+    await fsExtra.outputJSON(filePath, data, { encoding: 'utf-8', spaces: 2 });
+    const tmpPath = filePath + '.tmp';
+    await fs.writeFile(tmpPath, JSON.stringify(data, null, 2), 'utf-8');
+    await fs.rename(tmpPath, filePath);
+}
+/**
+ * Check if a file exists.
+ */
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check whether path is writable.
+ */
+export async function isWritable(filePath) {
+    try {
+        await fs.access(filePath, fs.constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Ensure a directory exists, creating it if necessary.
+ */
+export async function ensureDir(dirPath) {
+    await fsExtra.ensureDir(dirPath);
+}
+/**
+ * Read a text file, returning null if it doesn't exist.
+ */
+export async function readText(filePath) {
+    try {
+        return await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write text to a file, creating directories as needed.
+ */
+export async function writeText(filePath, content) {
+    await fsExtra.ensureDir(path.dirname(filePath));
+    await fsExtra.outputFile(filePath, content, 'utf-8');
+}
+/**
+ * Append text to a file, creating it if it doesn't exist.
+ */
+export async function appendText(filePath, content) {
+    await fsExtra.ensureDir(path.dirname(filePath));
+    await fsExtra.appendFile(filePath, content, 'utf-8');
+}
+/**
+ * Delete a file if it exists.
+ */
+export async function deleteFile(filePath) {
+    try {
+        await fs.unlink(filePath);
+    }
+    catch {
+        // Ignore errors if the file doesn't exist
+    }
 }
 //# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":";;;;;AAGA,4CAEC;AAED,gCAEC;AAED,oCAKC;AAED,0CAKC;AAvBD,wDAA0B;AAC1B,0DAA6B;AAEtB,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,MAAM,kBAAE,CAAC,MAAM,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1C,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,OAAO,kBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAEM,KAAK,UAAU,YAAY,CAAI,QAAgB,EAAE,QAAW;IACjE,IAAI,CAAC,CAAC,MAAM,kBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,kBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAe,CAAC;AAC7C,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAa;IACnE,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,CAAC;IAClC,MAAM,kBAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACnE,MAAM,kBAAE,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"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"}

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,GAAG;gBACF,MAAM,KAAG,IAAI;mBACV,MAAM,KAAG,IAAI;gBAChB,MAAM,KAAG,IAAI;iBACZ,MAAM,KAAG,IAAI;gBACd,MAAM,KAAG,IAAI;kBACX,MAAM,KAAG,IAAI;iBAOd,MAAM,KAAG,IAAI;gBACd,MAAM,KAAG,IAAI;iBACd,IAAI;CAChB,CAAC;AAGF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAOpE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,GAAG;gBACF,MAAM,KAAG,IAAI;mBACV,MAAM,KAAG,IAAI;gBAChB,MAAM,KAAG,IAAI;iBACZ,MAAM,KAAG,IAAI;gBACd,MAAM,KAAG,IAAI;kBACX,MAAM,KAAG,IAAI;iBAQd,MAAM,KAAG,IAAI;gBACd,MAAM,KAAG,IAAI;iBACd,IAAI;CAChB,CAAC;AAGF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAOpE"}

package/dist/utils/logger.js

@@ -1,35 +1,29 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.log = void 0;
-exports.printTable = printTable;
-const chalk_1 = __importDefault(require("chalk"));
-const boxen_1 = __importDefault(require("boxen"));
-const table_1 = require("table");
+import chalk from "chalk";
+import boxen from "boxen";
+import { table } from "table";
 // Chalk-based colored logger
-exports.log = {
-    info: (msg) => console.log(`${chalk_1.default.cyan("ℹ")} ${msg}`),
-    success: (msg) => console.log(`${chalk_1.default.green("✅")} ${msg}`),
-    warn: (msg) => console.log(`${chalk_1.default.yellow("⚠️")} ${msg}`),
-    error: (msg) => console.error(`${chalk_1.default.red("❌")} ${msg}`),
-    step: (msg) => console.log(`${chalk_1.default.blue("→")} ${msg}`),
-    header: (msg) => console.log((0, boxen_1.default)(chalk_1.default.bold(msg), {
+export const log = {
+    info: (msg) => console.log(`${chalk.cyan("ℹ")} ${msg}`),
+    success: (msg) => console.log(`${chalk.green("✅")} ${msg}`),
+    warn: (msg) => console.log(`${chalk.yellow("⚠️")} ${msg}`),
+    error: (msg) => console.error(`${chalk.red("❌")} ${msg}`),
+    step: (msg) => console.log(`${chalk.blue("→")} ${msg}`),
+    header: (msg) => console.log(boxen(chalk.bold(msg), {
         padding: 1,
-        borderColor: "cyan"
+        borderColor: "cyan",
+        borderStyle: "round",
     })),
-    muted: (msg) => console.log(chalk_1.default.gray(msg)),
-    code: (msg) => console.log(chalk_1.default.bgGray.white(` ${msg} `)),
+    muted: (msg) => console.log(chalk.gray(msg)),
+    code: (msg) => console.log(chalk.bgGray.white(` ${msg} `)),
     blank: () => console.log("")
 };
 // ASCII table renderer
-function printTable(headers, rows) {
+export function printTable(headers, rows) {
     if (rows.length === 0) {
-        exports.log.muted("(no entries)");
+        log.muted("(no entries)");
         return;
     }
-    const data = [headers.map((h) => chalk_1.default.bold.cyan(h)), ...rows];
-    console.log((0, table_1.table)(data));
+    const data = [headers.map((h) => chalk.bold.cyan(h)), ...rows];
+    console.log(table(data));
 }
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;;;;AAwBA,gCAOC;AA/BD,kDAA0B;AAC1B,kDAA0B;AAC1B,iCAA8B;AAE9B,6BAA6B;AAChB,QAAA,GAAG,GAAG;IACjB,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACrE,OAAO,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACzE,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,eAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACxE,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACvE,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACrE,MAAM,EAAE,CAAC,GAAW,EAAQ,EAAE,CAC5B,OAAO,CAAC,GAAG,CACT,IAAA,eAAK,EAAC,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACrB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,MAAM;KACpB,CAAC,CACH;IACH,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IACxE,KAAK,EAAE,GAAS,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;CACnC,CAAC;AAEF,uBAAuB;AACvB,SAAgB,UAAU,CAAC,OAAiB,EAAE,IAAgB;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,WAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,IAAA,aAAK,EAAC,IAAI,CAAC,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,6BAA6B;AAC7B,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACrE,OAAO,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACzE,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACxE,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACvE,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACrE,MAAM,EAAE,CAAC,GAAW,EAAQ,EAAE,CAC5B,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACrB,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,OAAO;KACrB,CAAC,CACH;IACH,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IACxE,KAAK,EAAE,GAAS,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;CACnC,CAAC;AAEF,uBAAuB;AACvB,MAAM,UAAU,UAAU,CAAC,OAAiB,EAAE,IAAgB;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3B,CAAC"}

package/dist/utils/network.d.ts

@@ -1,2 +1,13 @@
-export declare function canReach(url: string, timeout?: number): Promise<boolean>;
+/**
+ * Ping a URL to check if it's reachable. Returns true if the request succeeds, false otherwise.
+ */
+export declare function checkConnectivity(url: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Fetch the latest published version of a package from the npm registry. Returns 'unknown' if the package doesn't exist or there's an error.
+  */
+export declare function getNpmPackageVersion(packageName: string): Promise<string | null>;
+/**
+ * check whether an npm package exists. Returns true if the package exists, false otherwise.
+ */
+export declare function checkNpmPackageExists(packageName: string): Promise<boolean>;
 //# sourceMappingURL=network.d.ts.map

package/dist/utils/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"AAEA,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5E"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvF;AAED;;IAEI;AAEJ,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUtF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASjF"}

package/dist/utils/network.js

@@ -1,17 +1,45 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.canReach = canReach;
-const axios_1 = __importDefault(require("axios"));
-async function canReach(url, timeout = 5000) {
+import axios from "axios";
+//------------------------------------------------------------
+// Connectivity & npm registry helpers
+//------------------------------------------------------------
+/**
+ * Ping a URL to check if it's reachable. Returns true if the request succeeds, false otherwise.
+ */
+export async function checkConnectivity(url, timeoutMs = 8000) {
     try {
-        const response = await axios_1.default.head(url, { timeout });
+        const response = await axios.head(url, { timeout: timeoutMs });
         return response.status >= 200 && response.status < 300;
     }
     catch {
         return false;
     }
 }
+/**
+ * Fetch the latest published version of a package from the npm registry. Returns 'unknown' if the package doesn't exist or there's an error.
+  */
+export async function getNpmPackageVersion(packageName) {
+    try {
+        const pkgPath = packageName.replace(/\//g, '%2f');
+        const url = `https://registry.npmjs.org/${pkgPath}/latest`;
+        const response = await axios.get(url, { timeout: 8000 });
+        return response.data?.version ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * check whether an npm package exists. Returns true if the package exists, false otherwise.
+ */
+export async function checkNpmPackageExists(packageName) {
+    try {
+        const pkgPath = packageName.replace(/\//g, '%2f');
+        const url = `https://registry.npmjs.org/${pkgPath}`;
+        await axios.head(url, { timeout: 8000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 //# sourceMappingURL=network.js.map

package/dist/utils/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":";;;;;AAEA,4BAOC;AATD,kDAA0B;AAEnB,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,OAAO,GAAG,IAAI;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,8DAA8D;AAC9D,sCAAsC;AACtC,8DAA8D;AAE9D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,SAAS,GAAG,IAAI;IACnE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACjE,OAAO,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;IAEI;AAEJ,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,IAAI,CAAC;QACL,MAAM,OAAO,GAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,8BAA8B,OAAO,SAAS,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAsB,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9E,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,SAAS,CAAC;IAC7C,CAAC;IACA,MAAM,CAAC;QACJ,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB;IAC7D,IAAI,CAAC;QACH,MAAM,OAAO,GAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,8BAA8B,OAAO,EAAE,CAAC;QACpD,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/spinner.js

@@ -1,24 +1,15 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startSpinner = startSpinner;
-exports.succeedSpinner = succeedSpinner;
-exports.failSpinner = failSpinner;
-exports.updateSpinner = updateSpinner;
-const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
-function startSpinner(text) {
-    return (0, ora_1.default)({ text: chalk_1.default.cyan(text), color: "cyan" }).start();
+import chalk from "chalk";
+import ora from "ora";
+export function startSpinner(text) {
+    return ora({ text: chalk.cyan(text), color: "cyan" }).start();
 }
-function succeedSpinner(spinner, text) {
-    spinner.succeed(chalk_1.default.cyan(text));
+export function succeedSpinner(spinner, text) {
+    spinner.succeed(chalk.cyan(text));
 }
-function failSpinner(spinner, text) {
-    spinner.fail(chalk_1.default.cyan(text));
+export function failSpinner(spinner, text) {
+    spinner.fail(chalk.cyan(text));
 }
-function updateSpinner(spinner, text) {
-    spinner.text = chalk_1.default.cyan(text);
+export function updateSpinner(spinner, text) {
+    spinner.text = chalk.cyan(text);
 }
 //# sourceMappingURL=spinner.js.map

package/dist/utils/spinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":";;;;;AAKA,oCAEC;AAED,wCAEC;AAED,kCAEC;AAED,sCAEC;AAnBD,kDAA0B;AAC1B,8CAA+B;AAI/B,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,IAAA,aAAG,EAAC,EAAE,IAAI,EAAE,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAChE,CAAC;AAED,SAAgB,cAAc,CAAC,OAAgB,EAAE,IAAY;IAC3D,OAAO,CAAC,OAAO,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,WAAW,CAAC,OAAgB,EAAE,IAAY;IACxD,OAAO,CAAC,IAAI,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAgB,aAAa,CAAC,OAAgB,EAAE,IAAY;IAC1D,OAAO,CAAC,IAAI,GAAG,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAY,MAAM,KAAK,CAAC;AAI/B,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,IAAY;IAC3D,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,IAAY;IACxD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,IAAY;IAC1D,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -1,25 +1,29 @@
 {
   "name": "@global-packages/mcp-kit",
-  "version": "1.0.0",
-  "description": "Universal MCP Configuration CLI — auto-detect, configure and manage MCP servers across Azure, Confluence, MSSQL, Playwright and more. Works on Windows, macOS and Linux.",
+  "version": "1.0.3",
+  "description": "Universal MCP Configuration CLI - auto-detect, configure and manage MCP servers across Azure, Confluence, MSSQL, Playwright and more. Works on Windows, macOS and Linux.",
+  "type": "module",
+
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+
   "bin": {
     "mcp-kit": "./dist/index.js"
   },
+
   "scripts": {
     "build": "tsc && chmod +x dist/index.js",
-    "dev": "ts-node src/index.ts",
+    "dev": "node --loader ts-node/esm src/index.ts",
     "start": "node dist/index.js",
-    "postinstall": "node dist/postinstall.js",
     "prepare": "npm run build",
-    "test": "jest",
+    "postinstall": "node dist/postinstall.js || true",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
     "lint": "eslint src/**/*.ts"
   },
+
   "keywords": [
     "mcp",
     "model-context-protocol",
-    "vscode",
     "cli",
     "azure",
     "confluence",
@@ -30,11 +34,28 @@
     "automation",
     "ai-tools"
   ],
+
   "author": "global-packages",
   "license": "MIT",
+
   "publishConfig": {
     "access": "public"
   },
+
+  "engines": {
+    "node": ">=18.0.0"
+  },
+
+  "files": [
+    "dist/",
+    "README.md",
+    "src/postinstall.ts"
+  ],
+
+  "optionalDependencies": {
+    "keytar": "^7.9.0"
+  },
+
   "dependencies": {
     "axios": "^1.6.0",
     "boxen": "^7.1.0",
@@ -44,8 +65,6 @@
     "fs-extra": "^11.2.0",
     "glob": "^10.3.0",
     "inquirer": "^9.2.0",
-    "keytar": "^7.9.0",
-    "mcp-kit": "^1.2.8",
     "node-machine-id": "^1.1.12",
     "ora": "^8.0.0",
     "semver": "^7.6.0",
@@ -53,6 +72,7 @@
     "update-notifier": "^7.0.0",
     "zod": "^3.22.0"
   },
+
   "devDependencies": {
     "@types/fs-extra": "^11.0.0",
     "@types/inquirer": "^9.0.0",
@@ -64,11 +84,33 @@
     "ts-node": "^10.9.0",
     "typescript": "^5.3.0"
   },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "dist/",
-    "README.md"
-  ]
-}
+
+  "jest": {
+    "preset": "ts-jest/presets/default-esm",
+
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+
+    "moduleNameMapper": {
+      "^chalk$": "<rootDir>/test/mocks/chalk.ts",
+      "^boxen$": "<rootDir>/test/mocks/boxen.ts",
+      "^(\\.{1,2}/.*)\\.js$": "$1"
+    },
+
+    "transform": {
+      "^.+\\.tsx?$": [
+        "ts-jest",
+        {
+          "useESM": true
+        }
+      ]
+    },
+
+    "testEnvironment": "node",
+
+    "testMatch": [
+      "**/test/**/*.test.ts"
+    ]
+  }
+}

package/src/postinstall.ts

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall.ts
+ *
+ * Runs automatically after `npm install -g @global-packages/mcp-kit`.
+ * Prints the MCP-KIT welcome banner with a quick-start command table.
+ */
+
+import chalk from "chalk";
+import boxen from "boxen";
+import { table } from "table";
+
+const ASCII = `
+███╗   ███╗ ██████╗██████╗       ██╗  ██╗██╗████████╗
+████╗ ████║██╔════╝██╔══██╗      ██║ ██╔╝██║╚══██╔══╝
+██╔████╔██║██║     ██████╔╝█████╗█████╔╝ ██║   ██║
+██║╚██╔╝██║██║     ██╔═══╝ ╚════╝██╔═██╗ ██║   ██║
+██║ ╚═╝ ██║╚██████╗██║           ██║  ██╗██║   ██║
+╚═╝     ╚═╝ ╚═════╝╚═╝           ╚═╝  ╚═╝╚═╝   ╚═╝
+`;
+
+const COMMANDS: [string, string][] = [
+  ["mcp-kit init --dev", "Interactive setup for development MCPs (filesystem, git, playwright...)"],
+  ["mcp-kit init --non-dev", "Interactive setup for shared/team MCPs (azure, confluence, slack...)"],
+  ["mcp-kit install", "Pre-download MCP packages (recommended in restricted networks)"],
+  ["mcp-kit list", "Show configured MCPs and availability"],
+  ["mcp-kit status", "Show MCP versions and config health summary"],
+  ["mcp-kit add <id>", "Add one MCP server by ID (e.g. mcp-kit add azure)"],
+  ["mcp-kit remove <id>", "Remove a configured MCP server"],
+  ["mcp-kit update", "Refresh command args to latest package tags"],
+  ["mcp-kit doctor", "Diagnose env/version/path/credential issues"],
+  ["mcp-kit export", "Export current setup as shareable JSON"],
+  ["mcp-kit import <file>", "Import shared setup (prompts for redacted secrets)"],
+  ["mcp-kit reset", "Remove all configured MCPs and start fresh"]
+];
+
+function render(): void {
+  if (process.env.CI || process.env.MCP_KIT_POSTINSTALL_SILENT === "1") {
+    console.log("✅ @global-packages/mcp-kit installed. Run: mcp-kit init --dev");
+    return;
+  }
+
+  console.log(`\n${chalk.bold.magentaBright(ASCII)}`);
+
+  const topLine = boxen(
+    `${chalk.bold.whiteBright("Universal MCP Configuration CLI")}\n${chalk.gray(
+      "Auto-detect | Configure | Manage MCP servers - Windows | macOS | Linux"
+    )}`,
+    {
+      padding: { top: 0, bottom: 0, left: 2, right: 2 },
+      margin: { top: 0, bottom: 1, left: 2, right: 0 },
+      borderColor: "magenta",
+      borderStyle: "round",
+      textAlignment: "center"
+    }
+  );
+
+  console.log(topLine);
+  console.log(chalk.bold.yellowBright("  Quickstart commands\n"));
+
+  const tableData = [
+    [chalk.bold.cyanBright("Command"), chalk.bold.cyanBright("Description")],
+    ...COMMANDS.map(([cmd, desc]) => [chalk.cyan(cmd), chalk.white(desc)])
+  ];
+
+  const output = table(tableData, {
+    border: {
+      topBody: chalk.gray("─"),
+      topJoin: chalk.gray("┬"),
+      topLeft: chalk.gray("┌"),
+      topRight: chalk.gray("┐"),
+      bottomBody: chalk.gray("─"),
+      bottomJoin: chalk.gray("┴"),
+      bottomLeft: chalk.gray("└"),
+      bottomRight: chalk.gray("┘"),
+      bodyLeft: chalk.gray("│"),
+      bodyRight: chalk.gray("│"),
+      bodyJoin: chalk.gray("│"),
+      joinBody: chalk.gray("─"),
+      joinLeft: chalk.gray("├"),
+      joinRight: chalk.gray("┤"),
+      joinJoin: chalk.gray("┼")
+    },
+    columns: {
+      0: { width: 32, paddingLeft: 1, paddingRight: 1 },
+      1: { width: 58, paddingLeft: 1, paddingRight: 1, wrapWord: true }
+    },
+    drawHorizontalLine: (lineIndex: number, rowCount: number): boolean =>
+      lineIndex === 0 || lineIndex === 1 || lineIndex === rowCount
+  });
+
+  const indented = output
+    .split("\n")
+    .map((line) => `  ${line}`)
+    .join("\n");
+  console.log(indented);
+
+  console.log(
+    boxen(
+      `${chalk.bold.greenBright("✅ Get started:")} ${chalk.whiteBright("mcp-kit init --dev")}\n${chalk.gray(
+        "or"
+      )} ${chalk.whiteBright("mcp-kit install")}\n${chalk.underline.blue(
+        "https://github.com/global-packages/mcp-kit"
+      )}`,
+      {
+        padding: { top: 0, bottom: 0, left: 1, right: 1 },
+        margin: { top: 0, bottom: 1, left: 2, right: 0 },
+        borderColor: "green",
+        borderStyle: "double",
+        textAlignment: "center"
+      }
+    )
+  );
+}
+
+try {
+  render();
+} catch {
+  // Never fail npm install because of postinstall formatting.
+}