Method getLibrariesAsArray

lib/handlers/api.ts:245–304

(
        languageId: LanguageKey,
        fields?: string[],
    )

    getLibrariesAsArray(languageId: LanguageKey, fields: string[] | undefined): Partial<LibraryArrayEntry>[];
    getLibrariesAsArray(languageId: LanguageKey): LibraryArrayEntry[];
    getLibrariesAsArray(
        languageId: LanguageKey,
        fields?: string[],
    ): LibraryArrayEntry[] | Partial<LibraryArrayEntry>[] {
        const libsForLanguageObj = unwrap(this.options).options.libs[languageId];
        if (!libsForLanguageObj) return [];

        // Field filtering supports dotted paths for nested version fields
        // (e.g. `versions.id,versions.version`). Bare `versions` includes the
        // full version objects. Omitting `fields` returns the legacy full shape.
        const VERSION_PREFIX = 'versions.';
        let topLevelFields: string[] | undefined;
        let versionFields: string[] | undefined;
        if (fields && fields.length > 0) {
            topLevelFields = [];
            versionFields = [];
            let allVersionFields = false;
            for (const f of fields) {
                if (f.startsWith(VERSION_PREFIX)) {
                    versionFields.push(f.slice(VERSION_PREFIX.length));
                } else if (f === 'versions') {
                    allVersionFields = true;
                    topLevelFields.push(f);
                } else {
                    topLevelFields.push(f);
                }
            }
            if (allVersionFields) {
                versionFields = undefined;
            } else if (versionFields.length > 0 && !topLevelFields.includes('versions')) {
                topLevelFields.push('versions');
            }
        }

        // Build the full, concretely-typed shape first so callers that omit
        // `fields` (e.g. the MCP tools) get the legacy non-partial type back.
        const fullList: LibraryArrayEntry[] = Object.keys(libsForLanguageObj).map(key => {
            const library = libsForLanguageObj[key];
            const versions = Object.keys(library.versions).map(versionKey => ({
                ...library.versions[versionKey],
                id: versionKey,
            }));
            return {
                id: key,
                name: library.name,
                description: library.description,
                url: library.url,
                versions,
            };
        });

        if (!topLevelFields && !versionFields) return fullList;

        return fullList.map(fullLib => {
            const lib = versionFields
                ? {...fullLib, versions: fullLib.versions.map(v => _.pick(v, versionFields!))}
                : fullLib;
            return topLevelFields ? _.pick(lib, topLevelFields) : lib;