@justmpm/deps-consult 1.0.0

package/build/types/index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Tipos compartilhados do deps-consult MCP.
+ * Todos os tipos são rigorosamente tipados -- NUNCA usar `any`.
+ */
+export type SymbolKind = 'function' | 'class' | 'interface' | 'type' | 'enum' | 'variable' | 'constant';
+export declare const SYMBOL_KINDS: readonly SymbolKind[];
+export interface JSDocData {
+    description?: string;
+    params?: ReadonlyArray<{
+        name: string;
+        description: string;
+        type?: string;
+    }>;
+    returns?: string;
+    examples?: ReadonlyArray<string>;
+    since?: string;
+    deprecated?: string | true;
+    sees?: ReadonlyArray<string>;
+    throws?: ReadonlyArray<string>;
+    defaultValue?: string;
+}
+export interface ExtractedSymbol {
+    /** Nome do símbolo exportado */
+    name: string;
+    /** Tipo do símbolo (function, class, interface, etc.) */
+    kind: SymbolKind;
+    /** Assinatura completa em TypeScript */
+    signature: string;
+    /** Caminho do arquivo onde foi declarado */
+    file: string;
+    /** Linha no arquivo fonte (1-indexed) */
+    line: number;
+    /** Entry point (subpath) onde está disponível */
+    entrypoint: string;
+    /** JSDoc associado */
+    jsdoc?: JSDocData;
+    /** Se é um re-export de outro módulo */
+    isReExport: boolean;
+    /** Módulo original (se re-export) */
+    originalModule?: string;
+}
+export interface ResolvedEntrypoint {
+    /** Subpath (ex: ".", "./hooks", "./utils") */
+    subpath: string;
+    /** Caminho do arquivo JS resolvido */
+    jsPath?: string;
+    /** Caminho do arquivo de tipos (.d.ts) resolvido */
+    typesPath?: string;
+    /** Se tem tipos disponíveis */
+    hasTypes: boolean;
+}
+export interface ReadmeSection {
+    title: string;
+    content: string;
+}
+export interface ReadmeData {
+    /** Seção de descrição/overview */
+    description?: string;
+    /** Seções de uso/exemplos */
+    usageSections: ReadonlyArray<ReadmeSection>;
+    /** Exemplos de código extraídos */
+    codeBlocks: ReadonlyArray<{
+        code: string;
+        language?: string;
+        context?: string;
+    }>;
+}
+export interface PackageMeta {
+    /** Nome do pacote */
+    name: string;
+    /** Versão instalada */
+    version?: string;
+    /** Descrição */
+    description?: string;
+    /** Licença */
+    license?: string;
+    /** Entry points resolvidos */
+    entrypoints: ReadonlyArray<ResolvedEntrypoint>;
+    /** Dependências diretas */
+    dependencies?: Readonly<Record<string, string>>;
+    /** Peer dependencies */
+    peerDependencies?: Readonly<Record<string, string>>;
+    /** Se tem tipos disponíveis */
+    hasTypes: boolean;
+    /** Diretório raiz do pacote no node_modules */
+    packageDir: string;
+    /** Tamanho no disco (bytes) */
+    diskSize?: number;
+    /** Campo "files" do package.json */
+    includedFiles?: ReadonlyArray<string>;
+    /** Side effects */
+    sideEffects?: boolean | ReadonlyArray<string>;
+}
+export interface CachedPackage {
+    /** Metadados do pacote */
+    meta: PackageMeta;
+    /** Símbolos extraídos por entry point */
+    symbols: ReadonlyMap<string, ReadonlyArray<ExtractedSymbol>>;
+    /** README parseado */
+    readme: ReadmeData | null;
+    /** Timestamp da extração */
+    extractedAt: number;
+    /** Hash do package.json para invalidação */
+    packageJsonHash: string;
+}
+export interface ToolContext {
+    /** Diretório do projeto (onde está o node_modules) */
+    projectDir: string;
+}
+export interface SearchResult {
+    symbol: ExtractedSymbol;
+    /** Score de relevância (0-1) */
+    score: number;
+    /** Tipo de match */
+    matchType: 'exact' | 'prefix' | 'contains' | 'fuzzy';
+}
+//# sourceMappingURL=index.d.ts.map

package/build/types/index.d.ts.map

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

package/build/types/index.js

@@ -0,0 +1,14 @@
+/**
+ * Tipos compartilhados do deps-consult MCP.
+ * Todos os tipos são rigorosamente tipados -- NUNCA usar `any`.
+ */
+export const SYMBOL_KINDS = [
+    'function',
+    'class',
+    'interface',
+    'type',
+    'enum',
+    'variable',
+    'constant',
+];
+//# sourceMappingURL=index.js.map

package/build/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,UAAU;IACV,OAAO;IACP,WAAW;IACX,MAAM;IACN,MAAM;IACN,UAAU;IACV,UAAU;CACF,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@justmpm/deps-consult",
+  "version": "1.0.0",
+  "description": "MCP server for querying installed npm packages in node_modules - extract API surfaces, types, documentation and usage examples",
+  "type": "module",
+  "main": "./build/index.js",
+  "bin": {
+    "deps-consult": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node build/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "type-check": "tsc --noEmit"
+  },
+  "files": [
+    "build"
+  ],
+  "keywords": [
+    "mcp",
+    "node_modules",
+    "npm",
+    "typescript",
+    "api-documentation",
+    "package-explorer"
+  ],
+  "author": "Koda AI Studio",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "es-toolkit": "^1.40.0",
+    "lru-cache": "^11.1.0",
+    "resolve.exports": "^2.0.3",
+    "ts-morph": "^25.0.1",
+    "zod": "^4.0.5"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.10",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}