@prodisco/search-libs 0.1.0

package/dist/extractor/method-extractor.js

@@ -0,0 +1,163 @@
+/**
+ * Extract methods from TypeScript class declarations
+ */
+import * as ts from 'typescript';
+import { readFileSync, existsSync } from 'fs';
+import { createSourceFile, getJSDocDescription, extractParameterInfo, isAsyncMethod, isStaticMethod, isPrivateMember, } from './ast-parser.js';
+/**
+ * Extract all methods from a TypeScript file
+ *
+ * @param filePath - Path to the .d.ts file
+ * @param libraryName - Name of the library
+ * @param classFilter - Optional filter function for class names
+ * @param exportAliases - Optional map of internal class names to exported aliases
+ * @param publicExports - Optional set of publicly exported names (only index these)
+ */
+export function extractMethodsFromFile(filePath, libraryName, classFilter, exportAliases, publicExports) {
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    const sourceCode = readFileSync(filePath, 'utf-8');
+    const sourceFile = createSourceFile(filePath, sourceCode);
+    const methods = [];
+    function visit(node) {
+        if (ts.isClassDeclaration(node) && node.name) {
+            const internalClassName = node.name.text;
+            // Use exported alias if available (e.g., ObjectCoreV1Api -> CoreV1Api)
+            const className = exportAliases?.get(internalClassName) ?? internalClassName;
+            // If we have public exports info, only index classes that are publicly exported
+            // A class is public if:
+            // 1. Its internal name has an alias in the export map (aliased export)
+            // 2. OR its name is directly in the public exports set
+            if (publicExports && publicExports.size > 0) {
+                const isAliasedExport = exportAliases?.has(internalClassName);
+                const isDirectExport = publicExports.has(internalClassName);
+                if (!isAliasedExport && !isDirectExport) {
+                    // This class is not publicly exported, skip it
+                    return;
+                }
+            }
+            // Apply class filter if provided (filter on the public name)
+            if (classFilter && !classFilter(className)) {
+                return;
+            }
+            const classMethods = extractMethodsFromClass(node, sourceFile, libraryName, filePath, className // Pass the resolved className (with alias applied)
+            );
+            methods.push(...classMethods);
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return methods;
+}
+/**
+ * Extract methods from a class declaration
+ *
+ * @param classNode - The class declaration AST node
+ * @param sourceFile - The source file containing the class
+ * @param libraryName - Name of the library
+ * @param filePath - Path to the source file
+ * @param resolvedClassName - Optional pre-resolved class name (with export alias applied)
+ */
+export function extractMethodsFromClass(classNode, sourceFile, libraryName, filePath, resolvedClassName) {
+    if (!classNode.name)
+        return [];
+    // Use resolved name if provided, otherwise use the internal name
+    const className = resolvedClassName ?? classNode.name.text;
+    const methods = [];
+    const defaultReturnType = filePath.endsWith('.js') || filePath.endsWith('.mjs') || filePath.endsWith('.cjs')
+        ? 'any'
+        : 'void';
+    for (const member of classNode.members) {
+        // Handle method declarations
+        if (ts.isMethodDeclaration(member) && member.name) {
+            const methodName = member.name.getText(sourceFile);
+            // Skip private methods, constructors, and internal methods
+            if (methodName === 'constructor' ||
+                isPrivateMember(member, sourceFile, methodName)) {
+                continue;
+            }
+            const description = getJSDocDescription(member) ||
+                `${methodName} method of ${className}`;
+            const parameters = extractParameterInfo(member.parameters, sourceFile);
+            const returnType = member.type?.getText(sourceFile) || defaultReturnType;
+            const isStatic = isStaticMethod(member);
+            const isAsync = isAsyncMethod(member, sourceFile);
+            methods.push({
+                name: methodName,
+                className,
+                description,
+                parameters,
+                returnType,
+                isStatic,
+                isAsync,
+                sourceFile: filePath,
+                library: libraryName,
+            });
+        }
+        // Handle method signatures (for interfaces/abstract classes)
+        if (ts.isMethodSignature(member) && member.name) {
+            const methodName = member.name.getText(sourceFile);
+            // Skip private methods
+            if (isPrivateMember(member, sourceFile, methodName)) {
+                continue;
+            }
+            const description = getJSDocDescription(member) ||
+                `${methodName} method of ${className}`;
+            const parameters = extractParameterInfo(member.parameters, sourceFile);
+            const returnType = member.type?.getText(sourceFile) || defaultReturnType;
+            const isAsync = isAsyncMethod(member, sourceFile);
+            methods.push({
+                name: methodName,
+                className,
+                description,
+                parameters,
+                returnType,
+                isStatic: false,
+                isAsync,
+                sourceFile: filePath,
+                library: libraryName,
+            });
+        }
+    }
+    return methods;
+}
+/**
+ * Extract methods from an interface declaration (for type libraries)
+ */
+export function extractMethodsFromInterface(interfaceNode, sourceFile, libraryName, filePath) {
+    if (!interfaceNode.name)
+        return [];
+    const interfaceName = interfaceNode.name.text;
+    const methods = [];
+    const defaultReturnType = filePath.endsWith('.js') || filePath.endsWith('.mjs') || filePath.endsWith('.cjs')
+        ? 'any'
+        : 'void';
+    for (const member of interfaceNode.members) {
+        if (ts.isMethodSignature(member) && member.name) {
+            const methodName = member.name.getText(sourceFile);
+            // Skip private methods
+            if (methodName.startsWith('_')) {
+                continue;
+            }
+            const description = getJSDocDescription(member) ||
+                `${methodName} method of ${interfaceName}`;
+            const parameters = extractParameterInfo(member.parameters, sourceFile);
+            const returnType = member.type?.getText(sourceFile) || defaultReturnType;
+            const isAsync = isAsyncMethod(member, sourceFile);
+            methods.push({
+                name: methodName,
+                className: interfaceName,
+                description,
+                parameters,
+                returnType,
+                isStatic: false,
+                isAsync,
+                sourceFile: filePath,
+                library: libraryName,
+            });
+        }
+    }
+    return methods;
+}
+//# sourceMappingURL=method-extractor.js.map

package/dist/extractor/method-extractor.js.map

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

package/dist/extractor/package-resolver.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Resolve npm packages and find their .d.ts files
+ */
+import type { PackageInfo } from './types.js';
+/**
+ * Resolve a package and find all its .d.ts files
+ */
+export declare function resolvePackage(packageName: string, basePath?: string): PackageInfo | null;
+/**
+ * Find the main ESM JavaScript entry file for a package.
+ *
+ * This is intended as a fallback for packages that ship no `.d.ts` files.
+ * Scope: ESM only (`.js` with `"type":"module"` or `.mjs`). CommonJS (`.cjs`)
+ * is intentionally out of scope.
+ */
+export declare function findMainEsmJs(packagePath: string, packageJson: Record<string, unknown>): string | undefined;
+/**
+ * Read and parse package.json
+ */
+export declare function getPackageJson(packageJsonPath: string): Record<string, unknown> | null;
+/**
+ * Find all .d.ts files in a package
+ */
+export declare function findDtsFiles(packagePath: string, typesDir?: string, maxDepth?: number): string[];
+/**
+ * Get all exportable types from a package's main entry point
+ */
+export declare function getPackageExports(packagePath: string, packageJson: Record<string, unknown>): string[];
+/**
+ * Result of parsing exports from a package entry point
+ */
+export interface ExportParseResult {
+    /** Map of internal class names to their exported aliases (e.g., ObjectCoreV1Api -> CoreV1Api) */
+    aliasMap: Map<string, string>;
+    /** Set of all publicly exported names (the names users see and use) */
+    publicExports: Set<string>;
+}
+/**
+ * Parse exports from a package's entry point to determine:
+ * 1. Which names are publicly exported (visible to users)
+ * 2. Which internal names map to which public aliases
+ *
+ * Parses export statements like:
+ *   export { ObjectCoreV1Api as CoreV1Api } from './gen/api/coreV1Api';
+ *   export { SomeClass } from './module';  // No alias, SomeClass is public
+ *   export class PublicClass { }  // Directly exported class
+ *
+ * Recursively follows `export * from './module'` re-exports.
+ */
+export declare function buildExportInfo(mainDtsPath: string): ExportParseResult;
+/**
+ * Result of computing the public export surface of an ESM JavaScript package entry.
+ *
+ * - `filesToParse`: entry + all statically referenced re-export targets (relative only)
+ * - `exportAllowlistByFile`: per-file set of declaration names that are part of the public API
+ * - `aliasMapByFile`: per-file map from declaration name -> public export name (when renamed)
+ */
+export interface ESMExportSurface {
+    entryFile: string;
+    filesToParse: string[];
+    exportAllowlistByFile: Map<string, Set<string>>;
+    aliasMapByFile: Map<string, Map<string, string>>;
+    /** Names users can import from the package entry (public surface) */
+    publicExports: Set<string>;
+}
+/**
+ * Build the public export surface for an ESM entry file.
+ *
+ * This follows only *relative* static re-exports (`./...`). Re-exports from
+ * dependencies are intentionally ignored.
+ */
+export declare function buildEsmExportSurface(entryFile: string): ESMExportSurface;
+/**
+ * @deprecated Use buildExportInfo instead
+ */
+export declare function buildExportAliasMap(mainDtsPath: string): Map<string, string>;
+//# sourceMappingURL=package-resolver.d.ts.map

package/dist/extractor/package-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-resolver.d.ts","sourceRoot":"","sources":["../../src/extractor/package-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAsB,GAC/B,WAAW,GAAG,IAAI,CAoDpB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,GAAG,SAAS,CAyEpB;AA+GD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWhC;AAoFD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAU,GACnB,MAAM,EAAE,CAyEV;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,EAAE,CAeV;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,uEAAuE;IACvE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAuHtE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,qEAAqE;IACrE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAOD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CA2OzE;AAoDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5E"}