@stacksfinder/mcp-server 1.0.0

package/dist/utils/api-client.js

@@ -0,0 +1,197 @@
+import { getConfig, hasApiKey } from './config.js';
+import { McpError, ErrorCode, apiError } from './errors.js';
+import { debug, error as logError } from './logger.js';
+/**
+ * Simple semaphore for concurrency limiting.
+ */
+class Semaphore {
+    permits;
+    queue = [];
+    constructor(permits) {
+        this.permits = permits;
+    }
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.permits++;
+        }
+    }
+}
+class TTLCache {
+    cache = new Map();
+    ttlMs;
+    constructor(ttlSeconds) {
+        this.ttlMs = ttlSeconds * 1000;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry.data;
+    }
+    set(key, data) {
+        this.cache.set(key, {
+            data,
+            expiresAt: Date.now() + this.ttlMs
+        });
+    }
+    clear() {
+        this.cache.clear();
+    }
+}
+// Max 2 concurrent API requests
+const semaphore = new Semaphore(2);
+// 60 second TTL cache for score API
+const scoreCache = new TTLCache(60);
+// Default timeout of 15 seconds
+const DEFAULT_TIMEOUT_MS = 15000;
+/**
+ * Generate cache key for score API request.
+ */
+function scoreCacheKey(params) {
+    const sorted = Object.keys(params)
+        .sort()
+        .reduce((acc, key) => {
+        acc[key] = params[key];
+        return acc;
+    }, {});
+    return JSON.stringify(sorted);
+}
+/**
+ * Make an authenticated API request with concurrency limiting and caching.
+ */
+export async function apiRequest(path, options = {}) {
+    const config = getConfig();
+    const { method = 'GET', body, timeoutMs = DEFAULT_TIMEOUT_MS, useCache = false } = options;
+    // Check for API key
+    if (!hasApiKey()) {
+        throw new McpError(ErrorCode.CONFIG_ERROR, 'API key not configured. Set STACKSFINDER_API_KEY environment variable.', ['Get your API key from https://stacksfinder.com/settings/api']);
+    }
+    // Check cache for score API
+    const cacheKey = useCache && body ? scoreCacheKey(body) : null;
+    if (cacheKey) {
+        const cached = scoreCache.get(cacheKey);
+        if (cached) {
+            debug(`Cache hit for ${path}`);
+            return cached;
+        }
+    }
+    const url = `${config.apiUrl}${path}`;
+    debug(`API request: ${method} ${url}`);
+    // Acquire semaphore permit
+    await semaphore.acquire();
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${config.apiKey}`
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => '');
+                let errorMessage;
+                try {
+                    const errorJson = JSON.parse(errorText);
+                    errorMessage = errorJson.error || errorJson.message;
+                }
+                catch {
+                    // Not JSON, use raw text if short
+                    if (errorText.length < 200) {
+                        errorMessage = errorText;
+                    }
+                }
+                throw apiError(response.status, errorMessage);
+            }
+            const contentType = response.headers.get('content-type');
+            if (!contentType?.includes('application/json')) {
+                throw new McpError(ErrorCode.API_ERROR, 'API returned non-JSON response');
+            }
+            const data = (await response.json());
+            // Cache successful score responses
+            if (cacheKey) {
+                scoreCache.set(cacheKey, data);
+                debug(`Cached response for ${path}`);
+            }
+            return data;
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err instanceof McpError) {
+                throw err;
+            }
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new McpError(ErrorCode.TIMEOUT, `Request timed out after ${timeoutMs}ms`, [
+                    'The API may be under heavy load. Please try again.'
+                ]);
+            }
+            logError('API request failed', err);
+            throw new McpError(ErrorCode.API_ERROR, err instanceof Error ? err.message : 'Unknown API error');
+        }
+    }
+    finally {
+        semaphore.release();
+    }
+}
+/**
+ * POST to the score API with caching.
+ */
+export async function scoreRequest(body) {
+    return apiRequest('/api/v1/score', {
+        method: 'POST',
+        body,
+        useCache: true
+    });
+}
+/**
+ * GET a blueprint by ID.
+ */
+export async function getBlueprintRequest(blueprintId) {
+    return apiRequest(`/api/v1/blueprints/${blueprintId}`);
+}
+/**
+ * POST to create a new blueprint.
+ * This creates a project and queues a job for blueprint generation.
+ */
+export async function createBlueprintRequest(body) {
+    return apiRequest('/api/v1/blueprints', {
+        method: 'POST',
+        body: body,
+        timeoutMs: 30000 // 30 second timeout for creation
+    });
+}
+/**
+ * GET job status by ID.
+ */
+export async function getJobStatusRequest(jobId) {
+    return apiRequest(`/api/v1/jobs/${jobId}`);
+}
+/**
+ * Clear the score cache (useful for testing).
+ */
+export function clearScoreCache() {
+    scoreCache.clear();
+}
+//# sourceMappingURL=api-client.js.map

package/dist/utils/api-client.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+declare const ConfigSchema: z.ZodObject<{
+    apiUrl: z.ZodDefault<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    apiUrl: string;
+    debug: boolean;
+    apiKey?: string | undefined;
+}, {
+    apiUrl?: string | undefined;
+    apiKey?: string | undefined;
+    debug?: boolean | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Load configuration from environment variables.
+ * Call this once at startup.
+ */
+export declare function loadConfig(): Config;
+/**
+ * Get the current configuration.
+ * Throws if loadConfig() hasn't been called.
+ */
+export declare function getConfig(): Config;
+/**
+ * Check if API key is configured.
+ */
+export declare function hasApiKey(): boolean;
+/**
+ * Reset config (useful for testing).
+ */
+export declare function resetConfig(): void;
+export {};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,YAAY;;;;;;;;;;;;EAIhB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAUnC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/utils/config.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+const ConfigSchema = z.object({
+    apiUrl: z.string().url().default('https://stacksfinder.com'),
+    apiKey: z.string().optional(),
+    debug: z.boolean().default(false)
+});
+let _config = null;
+/**
+ * Load configuration from environment variables.
+ * Call this once at startup.
+ */
+export function loadConfig() {
+    if (_config)
+        return _config;
+    _config = ConfigSchema.parse({
+        apiUrl: process.env.STACKSFINDER_API_URL || 'https://stacksfinder.com',
+        apiKey: process.env.STACKSFINDER_API_KEY,
+        debug: process.env.STACKSFINDER_MCP_DEBUG === 'true'
+    });
+    return _config;
+}
+/**
+ * Get the current configuration.
+ * Throws if loadConfig() hasn't been called.
+ */
+export function getConfig() {
+    if (!_config) {
+        throw new Error('Config not loaded. Call loadConfig() first.');
+    }
+    return _config;
+}
+/**
+ * Check if API key is configured.
+ */
+export function hasApiKey() {
+    const config = getConfig();
+    return !!config.apiKey;
+}
+/**
+ * Reset config (useful for testing).
+ */
+export function resetConfig() {
+    _config = null;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC;IAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACjC,CAAC,CAAC;AAIH,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,UAAU;IACzB,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC;QAC5B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,0BAA0B;QACtE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QACxC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,MAAM;KACpD,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACxB,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,GAAG,IAAI,CAAC;AAChB,CAAC"}

package/dist/utils/device-id.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Get the current device ID.
+ */
+export declare function getDeviceId(): string;
+/**
+ * Check if demo was used today.
+ */
+export declare function wasDemoUsedToday(): boolean;
+/**
+ * Record demo usage.
+ */
+export declare function recordDemoUsage(): void;
+/**
+ * Get demo usage stats.
+ */
+export declare function getDemoUsageStats(): {
+    usedToday: boolean;
+    totalUsage: number;
+    deviceId: string;
+};
+//# sourceMappingURL=device-id.d.ts.map

package/dist/utils/device-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-id.d.ts","sourceRoot":"","sources":["../../src/utils/device-id.ts"],"names":[],"mappings":"AA2EA;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAgB1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAMtC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAOhG"}

package/dist/utils/device-id.js

@@ -0,0 +1,101 @@
+import { randomUUID } from 'crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { debug, warn } from './logger.js';
+/**
+ * Get the path to the device data file.
+ */
+function getDeviceFilePath() {
+    const configDir = join(homedir(), '.stacksfinder');
+    return join(configDir, 'device.json');
+}
+/**
+ * Ensure the config directory exists.
+ */
+function ensureConfigDir() {
+    const configDir = join(homedir(), '.stacksfinder');
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+        debug('Created config directory', { path: configDir });
+    }
+}
+/**
+ * Load device data from file, or create new if doesn't exist.
+ */
+function loadDeviceData() {
+    const filePath = getDeviceFilePath();
+    if (existsSync(filePath)) {
+        try {
+            const raw = readFileSync(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            debug('Loaded device data', { deviceId: data.deviceId.slice(0, 8) + '...' });
+            return data;
+        }
+        catch (err) {
+            warn('Failed to parse device data, creating new', err);
+        }
+    }
+    // Create new device data
+    ensureConfigDir();
+    const newData = {
+        deviceId: randomUUID(),
+        createdAt: new Date().toISOString(),
+        lastDemoUsedAt: null,
+        demoUsageCount: 0
+    };
+    saveDeviceData(newData);
+    debug('Created new device data', { deviceId: newData.deviceId.slice(0, 8) + '...' });
+    return newData;
+}
+/**
+ * Save device data to file.
+ */
+function saveDeviceData(data) {
+    ensureConfigDir();
+    const filePath = getDeviceFilePath();
+    writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
+}
+/**
+ * Get the current device ID.
+ */
+export function getDeviceId() {
+    return loadDeviceData().deviceId;
+}
+/**
+ * Check if demo was used today.
+ */
+export function wasDemoUsedToday() {
+    const data = loadDeviceData();
+    if (!data.lastDemoUsedAt) {
+        return false;
+    }
+    const lastUsed = new Date(data.lastDemoUsedAt);
+    const today = new Date();
+    // Compare date only (ignore time)
+    return (lastUsed.getUTCFullYear() === today.getUTCFullYear() &&
+        lastUsed.getUTCMonth() === today.getUTCMonth() &&
+        lastUsed.getUTCDate() === today.getUTCDate());
+}
+/**
+ * Record demo usage.
+ */
+export function recordDemoUsage() {
+    const data = loadDeviceData();
+    data.lastDemoUsedAt = new Date().toISOString();
+    data.demoUsageCount++;
+    saveDeviceData(data);
+    debug('Recorded demo usage', { count: data.demoUsageCount });
+}
+/**
+ * Get demo usage stats.
+ */
+export function getDemoUsageStats() {
+    const data = loadDeviceData();
+    return {
+        usedToday: wasDemoUsedToday(),
+        totalUsage: data.demoUsageCount,
+        deviceId: data.deviceId
+    };
+}
+//# sourceMappingURL=device-id.js.map

package/dist/utils/device-id.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Error codes for MCP tool responses.
+ */
+export declare enum ErrorCode {
+    UNAUTHORIZED = "UNAUTHORIZED",
+    NOT_FOUND = "NOT_FOUND",
+    RATE_LIMITED = "RATE_LIMITED",
+    INVALID_INPUT = "INVALID_INPUT",
+    API_ERROR = "API_ERROR",
+    TECH_NOT_FOUND = "TECH_NOT_FOUND",
+    TIMEOUT = "TIMEOUT",
+    CONFIG_ERROR = "CONFIG_ERROR"
+}
+/**
+ * MCP-friendly error with code and optional suggestions.
+ */
+export declare class McpError extends Error {
+    code: ErrorCode;
+    suggestions?: string[];
+    constructor(code: ErrorCode, message: string, suggestions?: string[]);
+    /**
+     * Format error for MCP response text.
+     */
+    toResponseText(): string;
+}
+/**
+ * Calculate Levenshtein distance between two strings.
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * Find similar strings using Levenshtein distance.
+ */
+export declare function findSimilar(input: string, candidates: string[], limit?: number): string[];
+/**
+ * Create error for unknown technology ID.
+ */
+export declare function techNotFoundError(techId: string, availableTechs: string[]): McpError;
+/**
+ * Map HTTP status codes to error codes.
+ */
+export declare function httpStatusToErrorCode(status: number): ErrorCode;
+/**
+ * Create error from HTTP response.
+ */
+export declare function apiError(status: number, message?: string): McpError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,SAAS;IACpB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,YAAY,iBAAiB;CAC7B;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;gBAEX,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAOpE;;OAEG;IACH,cAAc,IAAI,MAAM;CAOxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAYpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,QAAQ,CAQpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAe/D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAcnE"}

package/dist/utils/errors.js

@@ -0,0 +1,125 @@
+/**
+ * Error codes for MCP tool responses.
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    ErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["API_ERROR"] = "API_ERROR";
+    ErrorCode["TECH_NOT_FOUND"] = "TECH_NOT_FOUND";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    ErrorCode["CONFIG_ERROR"] = "CONFIG_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * MCP-friendly error with code and optional suggestions.
+ */
+export class McpError extends Error {
+    code;
+    suggestions;
+    constructor(code, message, suggestions) {
+        super(message);
+        this.name = 'McpError';
+        this.code = code;
+        this.suggestions = suggestions;
+    }
+    /**
+     * Format error for MCP response text.
+     */
+    toResponseText() {
+        let text = `**Error (${this.code})**: ${this.message}`;
+        if (this.suggestions && this.suggestions.length > 0) {
+            text += `\n\n**Suggestions**:\n${this.suggestions.map((s) => `- ${s}`).join('\n')}`;
+        }
+        return text;
+    }
+}
+/**
+ * Calculate Levenshtein distance between two strings.
+ */
+export function levenshteinDistance(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Find similar strings using Levenshtein distance.
+ */
+export function findSimilar(input, candidates, limit = 3) {
+    const inputLower = input.toLowerCase();
+    return candidates
+        .map((candidate) => ({
+        candidate,
+        distance: levenshteinDistance(inputLower, candidate.toLowerCase())
+    }))
+        .filter((item) => item.distance <= 3) // Max 3 edits
+        .sort((a, b) => a.distance - b.distance)
+        .slice(0, limit)
+        .map((item) => item.candidate);
+}
+/**
+ * Create error for unknown technology ID.
+ */
+export function techNotFoundError(techId, availableTechs) {
+    const similar = findSimilar(techId, availableTechs);
+    const suggestions = similar.length > 0
+        ? [`Did you mean: ${similar.join(', ')}?`, 'Use list_technologies to see all available IDs.']
+        : ['Use list_technologies to see all available technology IDs.'];
+    return new McpError(ErrorCode.TECH_NOT_FOUND, `Unknown technology: "${techId}"`, suggestions);
+}
+/**
+ * Map HTTP status codes to error codes.
+ */
+export function httpStatusToErrorCode(status) {
+    switch (status) {
+        case 401:
+        case 403:
+            return ErrorCode.UNAUTHORIZED;
+        case 404:
+            return ErrorCode.NOT_FOUND;
+        case 429:
+            return ErrorCode.RATE_LIMITED;
+        case 400:
+        case 422:
+            return ErrorCode.INVALID_INPUT;
+        default:
+            return ErrorCode.API_ERROR;
+    }
+}
+/**
+ * Create error from HTTP response.
+ */
+export function apiError(status, message) {
+    const code = httpStatusToErrorCode(status);
+    const defaultMessages = {
+        [ErrorCode.UNAUTHORIZED]: 'API key is invalid or missing. Set STACKSFINDER_API_KEY.',
+        [ErrorCode.NOT_FOUND]: 'Resource not found.',
+        [ErrorCode.RATE_LIMITED]: 'Rate limit exceeded. Please try again later.',
+        [ErrorCode.INVALID_INPUT]: 'Invalid request parameters.',
+        [ErrorCode.API_ERROR]: `API request failed with status ${status}.`,
+        [ErrorCode.TECH_NOT_FOUND]: 'Technology not found.',
+        [ErrorCode.TIMEOUT]: 'Request timed out.',
+        [ErrorCode.CONFIG_ERROR]: 'Configuration error.'
+    };
+    return new McpError(code, message || defaultMessages[code]);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * stderr-only logger for MCP server.
+ * stdout is reserved for the MCP protocol (stdio transport).
+ */
+/**
+ * Enable or disable debug logging.
+ */
+export declare function setDebug(enabled: boolean): void;
+/**
+ * Check if debug logging is enabled.
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Log a debug message to stderr (only if debug is enabled).
+ */
+export declare function debug(message: string, data?: unknown): void;
+/**
+ * Log an info message to stderr.
+ */
+export declare function info(message: string): void;
+/**
+ * Log a warning message to stderr.
+ */
+export declare function warn(message: string, err?: unknown): void;
+/**
+ * Log an error message to stderr.
+ */
+export declare function error(message: string, err?: unknown): void;
+export declare const log: {
+    debug: typeof debug;
+    info: typeof info;
+    warn: typeof warn;
+    error: typeof error;
+    setDebug: typeof setDebug;
+    isDebugEnabled: typeof isDebugEnabled;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAQ3D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CASzD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAY1D;AAED,eAAO,MAAM,GAAG;;;;;;;CAAyD,CAAC"}