@enfyra/mcp-server 0.1.13 → 0.1.14

package/README.md

@@ -2,7 +2,7 @@
 
 Manage Enfyra instances from MCP-compatible coding tools such as **Codex**, **Claude Code**, **Cursor**, **VS Code / GitHub Copilot**, **Google Antigravity**, MCP Inspector, and other STDIO MCP hosts.
 
-This package is the MCP bridge only. Assistant rules, schema behavior, dynamic script guidance, and examples are served through the MCP server itself from `src/lib/mcp-instructions.js`, `src/lib/mcp-examples.js`, and tool descriptions in `src/mcp-server-entry.mjs`.
+This package is the MCP bridge only. Assistant rules, schema behavior, dynamic script guidance, and examples are served through the MCP server itself from TypeScript source in `src/lib/mcp-instructions.ts`, `src/lib/mcp-examples.ts`, and tool descriptions in `src/mcp-server-entry.ts`. Published packages run the compiled `dist/index.js` entry.
 
 ## Quick Start
 
@@ -34,9 +34,22 @@ npx @enfyra/mcp-server@latest config --antigravity
 Equivalent in this repo:
 
 ```bash
+yarn build
 yarn mcp:config
 ```
 
+## Development
+
+This repo uses Yarn 4 through Corepack and TypeScript source compiled to `dist`.
+
+```bash
+yarn typecheck
+yarn build
+yarn test
+```
+
+`yarn test` builds first and then runs Node tests against `dist` while static source assertions read `src/**/*.ts`.
+
 ## Choose A Client
 
 | Client | Command | Project config |

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * Enfyra MCP — entry: `config` subcommand (local project files) or stdio MCP server.
+ */
+export {};

package/{src/index.mjs → dist/index.js}

@@ -2,12 +2,10 @@
 /**
  * Enfyra MCP — entry: `config` subcommand (local project files) or stdio MCP server.
  */
-
 import { config as loadEnv } from 'dotenv';
-
 const args = process.argv.slice(2);
 if (args[0] === '--help' || args[0] === '-h' || args[0] === 'help') {
-  console.log(`Enfyra MCP Server
+    console.log(`Enfyra MCP Server
 
 Usage:
   npx @enfyra/mcp-server@latest                 Start the MCP stdio server
@@ -27,14 +25,14 @@ Common config flags:
 
 Run \`npx @enfyra/mcp-server@latest config --help\` for full config details.
 `);
-  process.exit(0);
+    process.exit(0);
 }
 if (args[0] === 'config') {
-  loadEnv({ quiet: true });
-  const { runLocalConfig } = await import('./lib/config-local.mjs');
-  await runLocalConfig(args.slice(1));
-  process.exit(0);
+    loadEnv({ quiet: true });
+    const { runLocalConfig } = await import('./lib/config-local.js');
+    await runLocalConfig(args.slice(1));
+    process.exit(0);
 }
-
 loadEnv();
-await import('./mcp-server-entry.mjs');
+await import('./mcp-server-entry.js');
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;CAmBb,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACjE,MAAM,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,CAAC;AACV,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/lib/auth.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Authentication module for Enfyra MCP Server
+ * Handles API-token exchange and token validation
+ */
+/**
+ * Initialize auth module with config
+ */
+export declare function initAuth(apiUrl: any, apiToken?: string): void;
+/**
+ * Check if token needs refresh (expires within the refresh buffer)
+ */
+export declare function needsRefresh(): boolean;
+/**
+ * Get current access token (does not refresh)
+ */
+export declare function getAccessToken(): any;
+export declare function hasApiToken(): boolean;
+/**
+ * Get token expiry time
+ */
+export declare function getTokenExpiry(): any;
+export declare function exchangeApiToken(url: any, apiToken: any): Promise<any>;
+/**
+ * Refresh access token using refresh token
+ */
+export declare function refreshAccessToken(url: any): Promise<any>;
+/**
+ * Get valid access token, refreshing if needed
+ */
+export declare function getValidToken(url: any): Promise<any>;
+/**
+ * Reset token state (for logout)
+ */
+export declare function resetTokens(): void;

package/dist/lib/auth.js

@@ -0,0 +1,161 @@
+/**
+ * Authentication module for Enfyra MCP Server
+ * Handles API-token exchange and token validation
+ */
+// Token state
+let accessToken = null;
+let refreshToken = null;
+let tokenExpiry = null; // expTime từ server (milliseconds)
+let isRefreshing = false;
+let exchangePromise = null;
+// Config
+let API_URL = 'http://localhost:3000/api';
+let API_TOKEN = '';
+const TOKEN_REFRESH_BUFFER = 20000;
+function normalizeExpiry(expTime) {
+    if (expTime == null)
+        return Infinity;
+    if (typeof expTime === 'number')
+        return expTime < 1_000_000_000_000 ? expTime * 1000 : expTime;
+    if (typeof expTime === 'string' && expTime.trim()) {
+        const numeric = Number(expTime);
+        if (Number.isFinite(numeric))
+            return numeric < 1_000_000_000_000 ? numeric * 1000 : numeric;
+        const parsed = Date.parse(expTime);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return Infinity;
+}
+/**
+ * Initialize auth module with config
+ */
+export function initAuth(apiUrl, apiToken = '') {
+    API_URL = apiUrl;
+    API_TOKEN = apiToken;
+}
+/**
+ * Check if token needs refresh (expires within the refresh buffer)
+ */
+export function needsRefresh() {
+    if (tokenExpiry === Infinity)
+        return false;
+    if (!tokenExpiry)
+        return true;
+    const now = Date.now();
+    return now + TOKEN_REFRESH_BUFFER >= tokenExpiry;
+}
+/**
+ * Get current access token (does not refresh)
+ */
+export function getAccessToken() {
+    return accessToken;
+}
+export function hasApiToken() {
+    return !!API_TOKEN;
+}
+/**
+ * Get token expiry time
+ */
+export function getTokenExpiry() {
+    return tokenExpiry;
+}
+export async function exchangeApiToken(url, apiToken) {
+    const apiUrl = url || API_URL;
+    const token = apiToken || API_TOKEN;
+    if (!token) {
+        throw new Error('API token required');
+    }
+    if (exchangePromise)
+        return exchangePromise;
+    exchangePromise = (async () => {
+        console.error('[Auth] Exchanging API token...');
+        const response = await fetch(`${apiUrl}/auth/token/exchange`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ apiToken: token }),
+        });
+        if (!response.ok) {
+            throw new Error(`API token exchange failed: ${await response.text()}`);
+        }
+        const data = await response.json();
+        accessToken = data.accessToken || data.access_token;
+        refreshToken = null;
+        tokenExpiry = normalizeExpiry(data.expTime ?? data.exp_time ?? data.expiresAt ?? data.expires_at);
+        const expiryLabel = tokenExpiry === Infinity
+            ? 'no expiration'
+            : new Date(tokenExpiry).toISOString();
+        console.error(`[Auth] API token exchanged, access token expires at ${expiryLabel}`);
+        return accessToken;
+    })();
+    try {
+        return await exchangePromise;
+    }
+    finally {
+        exchangePromise = null;
+    }
+}
+/**
+ * Refresh access token using refresh token
+ */
+export async function refreshAccessToken(url) {
+    const apiUrl = url || API_URL;
+    if (isRefreshing) {
+        await new Promise(resolve => setTimeout(resolve, 500));
+        return accessToken;
+    }
+    if (API_TOKEN) {
+        return await exchangeApiToken(apiUrl, API_TOKEN);
+    }
+    if (!refreshToken) {
+        throw new Error('ENFYRA_API_TOKEN required');
+    }
+    isRefreshing = true;
+    try {
+        console.error('[Auth] Refreshing token...');
+        const response = await fetch(`${apiUrl}/auth/refresh-token`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ refreshToken }),
+        });
+        if (!response.ok) {
+            refreshToken = null;
+            return await exchangeApiToken(apiUrl, API_TOKEN);
+        }
+        const data = await response.json();
+        accessToken = data.accessToken || data.access_token;
+        refreshToken = data.refreshToken || data.refresh_token;
+        tokenExpiry = normalizeExpiry(data.expTime ?? data.exp_time ?? data.expiresAt ?? data.expires_at);
+        console.error(`[Auth] Token refreshed, expires at ${new Date(tokenExpiry).toISOString()}`);
+        return accessToken;
+    }
+    finally {
+        isRefreshing = false;
+    }
+}
+/**
+ * Get valid access token, refreshing if needed
+ */
+export async function getValidToken(url) {
+    const apiUrl = url || API_URL;
+    if (!accessToken || needsRefresh()) {
+        if (API_TOKEN) {
+            return await exchangeApiToken(apiUrl, API_TOKEN);
+        }
+        if (refreshToken) {
+            return await refreshAccessToken(apiUrl);
+        }
+        throw new Error('ENFYRA_API_TOKEN required');
+    }
+    return accessToken;
+}
+/**
+ * Reset token state (for logout)
+ */
+export function resetTokens() {
+    accessToken = null;
+    refreshToken = null;
+    tokenExpiry = null;
+    isRefreshing = false;
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"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"}

package/dist/lib/config-local.d.ts

@@ -0,0 +1 @@
+export declare function runLocalConfig(argv: string[]): Promise<void>;