@react-native-nitro-device-info/mcp-server 1.0.0

package/dist/indexer/api-parser.js

@@ -0,0 +1,404 @@
+"use strict";
+/**
+ * API Parser for DeviceInfo.nitro.ts
+ *
+ * Extracts method signatures, JSDoc comments, and platform tags
+ * from the TypeScript interface definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDeviceInfoFile = parseDeviceInfoFile;
+exports.parseDeviceInfoContent = parseDeviceInfoContent;
+exports.getDeviceInfoPath = getDeviceInfoPath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Category keywords mapping for automatic categorization
+ */
+const CATEGORY_KEYWORDS = {
+    // Battery & Power
+    battery: 'battery',
+    power: 'battery',
+    charging: 'battery',
+    lowpower: 'battery',
+    // Memory
+    memory: 'memory',
+    ram: 'memory',
+    // Storage
+    disk: 'storage',
+    storage: 'storage',
+    // Network
+    ip: 'network',
+    mac: 'network',
+    carrier: 'network',
+    network: 'network',
+    // Capabilities
+    notch: 'capabilities',
+    dynamicisland: 'capabilities',
+    emulator: 'capabilities',
+    simulator: 'capabilities',
+    tablet: 'capabilities',
+    camera: 'capabilities',
+    fingerprint: 'capabilities',
+    gms: 'capabilities',
+    hms: 'capabilities',
+    feature: 'capabilities',
+    landscape: 'capabilities',
+    // Application
+    version: 'application',
+    build: 'application',
+    bundle: 'application',
+    application: 'application',
+    install: 'application',
+    referrer: 'application',
+    useragent: 'application',
+    // Platform-specific
+    android: 'platform-specific',
+    serial: 'platform-specific',
+    security: 'platform-specific',
+    bootloader: 'platform-specific',
+    codename: 'platform-specific',
+    hardware: 'platform-specific',
+    incremental: 'platform-specific',
+    navigation: 'platform-specific',
+    // Display
+    brightness: 'display',
+    fontscale: 'display',
+    display: 'display',
+    zoom: 'display',
+    // Audio
+    headphone: 'audio',
+    bluetooth: 'audio',
+    audio: 'audio',
+    // Location
+    location: 'location',
+    airplane: 'location',
+    // Identification
+    unique: 'identification',
+    devicetoken: 'identification',
+    idfv: 'identification',
+};
+/**
+ * Parse JSDoc comment block
+ */
+function parseJsDoc(comment) {
+    const lines = comment.split('\n').map((l) => l.trim().replace(/^\*\s?/, ''));
+    let description = '';
+    let platform = { type: 'both' };
+    const examples = [];
+    const params = [];
+    let returns = '';
+    let isAsync = false;
+    let currentSection = 'description';
+    let currentExample = '';
+    for (const line of lines) {
+        // Check for @tags
+        if (line.startsWith('@platform')) {
+            const platformText = line.replace('@platform', '').trim().toLowerCase();
+            if (platformText.includes('android') && platformText.includes('ios')) {
+                platform = { type: 'both' };
+            }
+            else if (platformText.includes('android only') || platformText === 'android') {
+                const apiMatch = platformText.match(/api\s*(\d+)/i);
+                platform = {
+                    type: 'android-only',
+                    minApiLevel: apiMatch ? parseInt(apiMatch[1]) : undefined,
+                };
+            }
+            else if (platformText.includes('ios only') || platformText === 'ios') {
+                const versionMatch = platformText.match(/ios\s*([\d.]+)/i);
+                platform = {
+                    type: 'ios-only',
+                    minVersion: versionMatch ? versionMatch[1] : undefined,
+                };
+            }
+            else if (platformText.includes('android')) {
+                const apiMatch = platformText.match(/api\s*(\d+)/i);
+                platform = {
+                    type: 'android',
+                    minApiLevel: apiMatch ? parseInt(apiMatch[1]) : undefined,
+                };
+            }
+            else if (platformText.includes('ios')) {
+                const versionMatch = platformText.match(/([\d.]+)/);
+                platform = {
+                    type: 'ios',
+                    minVersion: versionMatch ? versionMatch[1] : undefined,
+                };
+            }
+            continue;
+        }
+        if (line.startsWith('@example')) {
+            currentSection = 'example';
+            currentExample = '';
+            continue;
+        }
+        if (line.startsWith('@param')) {
+            currentSection = 'param';
+            const paramMatch = line.match(/@param\s+(\w+)\s*(.*)/);
+            if (paramMatch) {
+                params.push({
+                    name: paramMatch[1],
+                    type: 'unknown', // Will be extracted from signature
+                    description: paramMatch[2] || '',
+                    optional: false,
+                });
+            }
+            continue;
+        }
+        if (line.startsWith('@returns') || line.startsWith('@return')) {
+            currentSection = 'returns';
+            returns = line.replace(/@returns?\s*/, '');
+            continue;
+        }
+        if (line.startsWith('@async')) {
+            isAsync = true;
+            continue;
+        }
+        if (line.startsWith('@')) {
+            // Skip other tags
+            currentSection = 'other';
+            continue;
+        }
+        // Accumulate content based on current section
+        if (currentSection === 'description' && line && !line.startsWith('```')) {
+            description += (description ? ' ' : '') + line;
+        }
+        else if (currentSection === 'example') {
+            currentExample += line + '\n';
+        }
+        else if (currentSection === 'returns' && line) {
+            returns += ' ' + line;
+        }
+    }
+    if (currentExample.trim()) {
+        examples.push(currentExample.trim());
+    }
+    return {
+        description: description.trim(),
+        platform,
+        examples,
+        params,
+        returns: returns.trim(),
+        async: isAsync,
+    };
+}
+/**
+ * Determine API category based on name and description
+ */
+function determineCategory(name, description) {
+    const searchText = (name + ' ' + description).toLowerCase();
+    for (const [keyword, category] of Object.entries(CATEGORY_KEYWORDS)) {
+        if (searchText.includes(keyword)) {
+            return category;
+        }
+    }
+    return 'device-info'; // Default category
+}
+/**
+ * Parse a single API member (method or property)
+ */
+function parseApiMember(memberText, jsDocComment) {
+    const jsDoc = parseJsDoc(jsDocComment);
+    // Check if it's a readonly property
+    const propertyMatch = memberText.match(/readonly\s+(\w+):\s*([^;]+)/);
+    if (propertyMatch) {
+        const [, name, returnType] = propertyMatch;
+        return {
+            name,
+            description: jsDoc.description,
+            kind: 'property',
+            signature: `readonly ${name}: ${returnType.trim()}`,
+            returnType: returnType.trim(),
+            parameters: [],
+            platform: jsDoc.platform,
+            isAsync: false,
+            examples: jsDoc.examples,
+            relatedApis: findRelatedApis(name),
+            category: determineCategory(name, jsDoc.description),
+        };
+    }
+    // Check if it's a method
+    const methodMatch = memberText.match(/(\w+)\s*\(([^)]*)\)\s*:\s*([^;]+)/);
+    if (methodMatch) {
+        const [, name, paramsStr, returnType] = methodMatch;
+        // Parse parameters
+        const parameters = [];
+        if (paramsStr.trim()) {
+            const paramParts = paramsStr.split(',');
+            for (const param of paramParts) {
+                const paramMatch = param.trim().match(/(\w+)(\?)?:\s*(.+)/);
+                if (paramMatch) {
+                    const [, paramName, optional, paramType] = paramMatch;
+                    const jsDocParam = jsDoc.params.find((p) => p.name === paramName);
+                    parameters.push({
+                        name: paramName,
+                        type: paramType.trim(),
+                        description: jsDocParam?.description || '',
+                        optional: !!optional,
+                    });
+                }
+            }
+        }
+        const isAsync = jsDoc.async || returnType.trim().startsWith('Promise<');
+        const cleanReturnType = returnType.trim();
+        return {
+            name,
+            description: jsDoc.description,
+            kind: 'method',
+            signature: `${name}(${paramsStr.trim()}): ${cleanReturnType}`,
+            returnType: cleanReturnType,
+            parameters,
+            platform: jsDoc.platform,
+            isAsync,
+            examples: jsDoc.examples,
+            relatedApis: findRelatedApis(name),
+            category: determineCategory(name, jsDoc.description),
+        };
+    }
+    return null;
+}
+/**
+ * Find related APIs based on naming patterns
+ */
+function findRelatedApis(name) {
+    const related = [];
+    const nameLower = name.toLowerCase();
+    // Battery-related
+    if (nameLower.includes('battery') || nameLower.includes('power') || nameLower.includes('charging')) {
+        if (!nameLower.includes('getbatterylevel'))
+            related.push('getBatteryLevel');
+        if (!nameLower.includes('getpowerstate'))
+            related.push('getPowerState');
+        if (!nameLower.includes('getisbatterycharging'))
+            related.push('getIsBatteryCharging');
+        if (!nameLower.includes('islowbatterylevel'))
+            related.push('isLowBatteryLevel');
+    }
+    // Memory-related
+    if (nameLower.includes('memory')) {
+        if (!nameLower.includes('totalmemory'))
+            related.push('totalMemory');
+        if (!nameLower.includes('getusedmemory'))
+            related.push('getUsedMemory');
+        if (!nameLower.includes('maxmemory'))
+            related.push('maxMemory');
+    }
+    // Storage-related
+    if (nameLower.includes('disk') || nameLower.includes('storage')) {
+        if (!nameLower.includes('totaldiskcapacity'))
+            related.push('totalDiskCapacity');
+        if (!nameLower.includes('getfreediskstorage'))
+            related.push('getFreeDiskStorage');
+    }
+    // Headphones-related
+    if (nameLower.includes('headphone')) {
+        if (!nameLower.includes('isheadphonesconnected'))
+            related.push('isHeadphonesConnected');
+        if (!nameLower.includes('iswiredheadphones'))
+            related.push('getIsWiredHeadphonesConnected');
+        if (!nameLower.includes('isbluetoothheadphones'))
+            related.push('getIsBluetoothHeadphonesConnected');
+    }
+    // Limit to 3 related APIs
+    return related.filter((r) => r.toLowerCase() !== nameLower).slice(0, 3);
+}
+/**
+ * Parse DeviceInfo.nitro.ts file and extract all API definitions
+ */
+function parseDeviceInfoFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return parseDeviceInfoContent(content);
+}
+/**
+ * Parse DeviceInfo content string and extract all API definitions
+ */
+function parseDeviceInfoContent(content) {
+    const apis = [];
+    // Find the DeviceInfo interface
+    const interfaceMatch = content.match(/export\s+interface\s+DeviceInfo[\s\S]*?\{([\s\S]*?)\n\}/);
+    if (!interfaceMatch) {
+        console.warn('Could not find DeviceInfo interface in file');
+        return apis;
+    }
+    const interfaceBody = interfaceMatch[1];
+    // Split by JSDoc comments and member declarations
+    const memberRegex = /\/\*\*[\s\S]*?\*\/\s*(?:readonly\s+\w+:[^;]+;|\w+\s*\([^)]*\)\s*:[^;]+;)/g;
+    const matches = interfaceBody.match(memberRegex);
+    if (!matches) {
+        return apis;
+    }
+    for (const match of matches) {
+        // Split into JSDoc and member
+        const jsDocMatch = match.match(/\/\*\*([\s\S]*?)\*\//);
+        const memberMatch = match.match(/\*\/\s*([\s\S]+)/);
+        if (jsDocMatch && memberMatch) {
+            const jsDoc = jsDocMatch[1];
+            const member = memberMatch[1].trim();
+            const api = parseApiMember(member, jsDoc);
+            if (api) {
+                apis.push(api);
+            }
+        }
+    }
+    return apis;
+}
+/**
+ * Get the path to DeviceInfo.nitro.ts relative to package
+ *
+ * When running from dist (packages/mcp-server/dist), we need to go up 3 levels
+ * to reach the repository root where src/DeviceInfo.nitro.ts lives.
+ */
+function getDeviceInfoPath(packageRoot) {
+    // Try common locations (ordered from most specific to least)
+    const possiblePaths = [
+        // From packages/mcp-server/dist -> repo root (3 levels up)
+        path.join(packageRoot, '..', '..', '..', 'src', 'DeviceInfo.nitro.ts'),
+        // From packages/mcp-server/src -> repo root (3 levels up, for dev mode)
+        path.join(packageRoot, '..', '..', '..', 'src', 'DeviceInfo.nitro.ts'),
+        // From packages/mcp-server -> repo root (2 levels up)
+        path.join(packageRoot, '..', '..', 'src', 'DeviceInfo.nitro.ts'),
+        // Legacy paths for other configurations
+        path.join(packageRoot, '..', 'src', 'DeviceInfo.nitro.ts'),
+        path.join(packageRoot, 'src', 'DeviceInfo.nitro.ts'),
+    ];
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            return p;
+        }
+    }
+    throw new Error(`Could not find DeviceInfo.nitro.ts. Searched: ${possiblePaths.join(', ')}`);
+}
+//# sourceMappingURL=api-parser.js.map

package/dist/indexer/api-parser.js.map

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

package/dist/indexer/doc-parser.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Documentation Parser
+ *
+ * Parses markdown documentation files with heading-based chunking
+ * for searchable documentation sections.
+ */
+import type { DocumentationChunk } from '../types/index.js';
+/**
+ * Parse a single markdown file into documentation chunks
+ */
+export declare function parseMarkdownFile(filePath: string): DocumentationChunk[];
+/**
+ * Parse markdown content string into documentation chunks
+ */
+export declare function parseMarkdownContent(content: string, source?: string): DocumentationChunk[];
+/**
+ * Parse all markdown files in a directory
+ */
+export declare function parseDocsDirectory(dirPath: string): DocumentationChunk[];
+/**
+ * Get documentation paths relative to package root
+ *
+ * When running from dist (packages/mcp-server/dist), we need to go up 3 levels
+ * to reach the repository root where docs/ lives.
+ */
+export declare function getDocsPaths(packageRoot: string): string[];
+/**
+ * Parse README file for quick reference content
+ *
+ * When running from dist (packages/mcp-server/dist), we need to go up 3 levels
+ * to reach the repository root where README.md lives.
+ */
+export declare function parseReadme(packageRoot: string): DocumentationChunk[];
+/**
+ * Create platform limitation documentation chunks
+ */
+export declare function createPlatformLimitationChunks(): DocumentationChunk[];
+//# sourceMappingURL=doc-parser.d.ts.map

package/dist/indexer/doc-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-parser.d.ts","sourceRoot":"","sources":["../../src/indexer/doc-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,mBAAmB,CAAC;AAkG1E;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAGxE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAkB,GACzB,kBAAkB,EAAE,CA2FtB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA2BxE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAsBrE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,kBAAkB,EAAE,CAuErE"}