@structured-world/gitlab-mcp 4.1.0 → 4.2.0

package/dist/types.d.ts

@@ -2,6 +2,7 @@ declare const TransportModeObj: {
     readonly STDIO: "stdio";
     readonly SSE: "sse";
     readonly STREAMABLE_HTTP: "streamable-http";
+    readonly DUAL: "dual";
 };
 export { TransportModeObj as TransportMode };
 export type TransportMode = (typeof TransportModeObj)[keyof typeof TransportModeObj];

package/dist/types.js

@@ -5,6 +5,7 @@ const TransportModeObj = {
     STDIO: 'stdio',
     SSE: 'sse',
     STREAMABLE_HTTP: 'streamable-http',
+    DUAL: 'dual',
 };
 exports.TransportMode = TransportModeObj;
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AACA,MAAM,gBAAgB,GAAG;IACvB,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAEkB,yCAAa"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AACA,MAAM,gBAAgB,GAAG;IACvB,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,eAAe,EAAE,iBAAiB;IAClC,IAAI,EAAE,MAAM;CACJ,CAAC;AAEkB,yCAAa"}

package/dist/utils/namespace.d.ts

@@ -0,0 +1,6 @@
+export declare function isLikelyProjectPath(namespacePath: string): boolean;
+export declare function detectNamespaceType(namespacePath: string): Promise<'project' | 'group'>;
+export declare function resolveNamespaceForAPI(namespacePath: string): Promise<{
+    entityType: 'projects' | 'groups';
+    encodedPath: string;
+}>;

package/dist/utils/namespace.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLikelyProjectPath = isLikelyProjectPath;
+exports.detectNamespaceType = detectNamespaceType;
+exports.resolveNamespaceForAPI = resolveNamespaceForAPI;
+const fetch_1 = require("./fetch");
+function isLikelyProjectPath(namespacePath) {
+    return namespacePath.includes('/');
+}
+async function detectNamespaceType(namespacePath) {
+    if (isLikelyProjectPath(namespacePath)) {
+        const isProject = await verifyNamespaceType(namespacePath, 'project');
+        if (isProject)
+            return 'project';
+        const isGroup = await verifyNamespaceType(namespacePath, 'group');
+        if (isGroup)
+            return 'group';
+        return 'project';
+    }
+    else {
+        const isGroup = await verifyNamespaceType(namespacePath, 'group');
+        if (isGroup)
+            return 'group';
+        const isProject = await verifyNamespaceType(namespacePath, 'project');
+        if (isProject)
+            return 'project';
+        return 'group';
+    }
+}
+async function verifyNamespaceType(namespacePath, type) {
+    try {
+        const entityType = type === 'project' ? 'projects' : 'groups';
+        const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/${entityType}/${encodeURIComponent(namespacePath)}`;
+        const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
+            headers: {
+                Authorization: `Bearer ${process.env.GITLAB_TOKEN}`,
+            },
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveNamespaceForAPI(namespacePath) {
+    const namespaceType = await detectNamespaceType(namespacePath);
+    return {
+        entityType: namespaceType === 'project' ? 'projects' : 'groups',
+        encodedPath: encodeURIComponent(namespacePath),
+    };
+}
+//# sourceMappingURL=namespace.js.map

package/dist/utils/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/utils/namespace.ts"],"names":[],"mappings":";;AAMA,kDAEC;AAMD,kDAuBC;AA8BD,wDASC;AA5ED,mCAAwC;AAMxC,SAAgB,mBAAmB,CAAC,aAAqB;IACvD,OAAO,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAMM,KAAK,UAAU,mBAAmB,CAAC,aAAqB;IAE7D,IAAI,mBAAmB,CAAC,aAAa,CAAC,EAAE,CAAC;QAEvC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACtE,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAG5B,OAAO,SAAS,CAAC;IACnB,CAAC;SAAM,CAAC;QAEN,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACtE,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAGhC,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAKD,KAAK,UAAU,mBAAmB,CAChC,aAAqB,EACrB,IAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC9D,MAAM,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,WAAW,UAAU,IAAI,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC;QAEzG,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAa,EAAC,MAAM,EAAE;YAC3C,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE;aACpD;SACF,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QAEP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAMM,KAAK,UAAU,sBAAsB,CAAC,aAAqB;IAIhE,MAAM,aAAa,GAAG,MAAM,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAC/D,OAAO;QACL,UAAU,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;QAC/D,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/utils/smart-user-search.d.ts

@@ -0,0 +1,33 @@
+export type QueryType = 'email' | 'username' | 'name';
+export interface QueryPattern {
+    type: QueryType;
+    hasTransliteration: boolean;
+    originalQuery: string;
+    transliteratedQuery?: string;
+}
+export interface UserSearchParams {
+    username?: string;
+    public_email?: string;
+    search?: string;
+    active?: boolean;
+    humans?: boolean;
+    without_project_bots?: boolean;
+    [key: string]: unknown;
+}
+export interface SmartSearchResult {
+    users: unknown[];
+    searchMetadata: {
+        query: string;
+        pattern: QueryPattern;
+        searchPhases: Array<{
+            phase: string;
+            params: UserSearchParams;
+            resultCount: number;
+        }>;
+        totalApiCalls: number;
+    };
+}
+export declare function transliterateText(text: string): string;
+export declare function hasNonLatin(text: string): boolean;
+export declare function analyzeQuery(query: string): QueryPattern;
+export declare function smartUserSearch(query: string, additionalParams?: Partial<UserSearchParams>): Promise<SmartSearchResult>;

package/dist/utils/smart-user-search.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transliterateText = transliterateText;
+exports.hasNonLatin = hasNonLatin;
+exports.analyzeQuery = analyzeQuery;
+exports.smartUserSearch = smartUserSearch;
+const fetch_1 = require("./fetch");
+const transliteration_1 = require("transliteration");
+function transliterateText(text) {
+    return (0, transliteration_1.transliterate)(text);
+}
+function hasNonLatin(text) {
+    return /[^\u0000-\u007F\u0080-\u00FF]/.test(text);
+}
+function analyzeQuery(query) {
+    const trimmedQuery = query.trim();
+    if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(trimmedQuery)) {
+        return {
+            type: 'email',
+            hasTransliteration: false,
+            originalQuery: trimmedQuery,
+        };
+    }
+    if (trimmedQuery.length >= 3 && trimmedQuery.length <= 30 && !/\s/.test(trimmedQuery)) {
+        const hasTransliterationNeeded = hasNonLatin(trimmedQuery);
+        return {
+            type: 'username',
+            hasTransliteration: hasTransliterationNeeded,
+            originalQuery: trimmedQuery,
+            transliteratedQuery: hasTransliterationNeeded ? transliterateText(trimmedQuery) : undefined,
+        };
+    }
+    const hasTransliterationNeeded = hasNonLatin(trimmedQuery);
+    return {
+        type: 'name',
+        hasTransliteration: hasTransliterationNeeded,
+        originalQuery: trimmedQuery,
+        transliteratedQuery: hasTransliterationNeeded ? transliterateText(trimmedQuery) : undefined,
+    };
+}
+async function callUsersAPI(params) {
+    const queryParams = new URLSearchParams();
+    const defaultParams = {
+        active: true,
+        humans: true,
+        ...params,
+    };
+    Object.entries(defaultParams).forEach(([key, value]) => {
+        if (value !== undefined) {
+            queryParams.set(key, String(value));
+        }
+    });
+    const apiUrl = `${process.env.GITLAB_API_URL}/api/v4/users?${queryParams}`;
+    const response = await (0, fetch_1.enhancedFetch)(apiUrl, {
+        headers: {
+            Authorization: `Bearer ${process.env.GITLAB_TOKEN}`,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`GitLab API error: ${response.status} ${response.statusText}`);
+    }
+    const users = (await response.json());
+    return Array.isArray(users) ? users : [];
+}
+async function smartUserSearch(query, additionalParams = {}) {
+    const pattern = analyzeQuery(query);
+    const searchPhases = [];
+    let users = [];
+    let totalApiCalls = 0;
+    let targetParams;
+    switch (pattern.type) {
+        case 'email':
+            targetParams = { public_email: pattern.originalQuery, ...additionalParams };
+            break;
+        case 'username':
+            targetParams = { username: pattern.originalQuery, ...additionalParams };
+            break;
+        case 'name':
+            targetParams = { search: pattern.originalQuery, ...additionalParams };
+            break;
+    }
+    try {
+        users = await callUsersAPI(targetParams);
+        totalApiCalls++;
+        searchPhases.push({
+            phase: `targeted-${pattern.type}`,
+            params: targetParams,
+            resultCount: users.length,
+        });
+        if (users.length > 0) {
+            return {
+                users,
+                searchMetadata: {
+                    query,
+                    pattern,
+                    searchPhases,
+                    totalApiCalls,
+                },
+            };
+        }
+        if (pattern.type !== 'name') {
+            const broadParams = { search: pattern.originalQuery, ...additionalParams };
+            users = await callUsersAPI(broadParams);
+            totalApiCalls++;
+            searchPhases.push({
+                phase: 'broad-search',
+                params: broadParams,
+                resultCount: users.length,
+            });
+            if (users.length > 0) {
+                return {
+                    users,
+                    searchMetadata: {
+                        query,
+                        pattern,
+                        searchPhases,
+                        totalApiCalls,
+                    },
+                };
+            }
+        }
+        if (pattern.hasTransliteration && pattern.transliteratedQuery) {
+            const translitParams = { search: pattern.transliteratedQuery, ...additionalParams };
+            users = await callUsersAPI(translitParams);
+            totalApiCalls++;
+            searchPhases.push({
+                phase: 'transliteration',
+                params: translitParams,
+                resultCount: users.length,
+            });
+        }
+    }
+    catch (error) {
+        console.error('Smart user search error:', error);
+    }
+    return {
+        users,
+        searchMetadata: {
+            query,
+            pattern,
+            searchPhases,
+            totalApiCalls,
+        },
+    };
+}
+//# sourceMappingURL=smart-user-search.js.map

package/dist/utils/smart-user-search.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@structured-world/gitlab-mcp",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "Dmitry Prudnikov <mail@polaz.com>",
@@ -62,6 +62,7 @@
     "pino": "^9.9.5",
     "pino-pretty": "^13.1.1",
     "socks-proxy-agent": "^8.0.5",
+    "transliteration": "^2.3.5",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.24.6"
   },