@structured-world/gitlab-mcp 4.3.1 → 4.3.2

package/dist/utils/idConversion.d.ts

@@ -0,0 +1,68 @@
+export interface GitLabObject {
+    [key: string]: unknown;
+}
+export interface GitLabWorkItemType {
+    id: string;
+    name: string;
+}
+export interface GitLabWorkItem extends GitLabObject {
+    id: string;
+    iid?: string;
+    title?: string;
+    description?: string;
+    state?: string;
+    workItemType?: GitLabWorkItemType | string;
+    widgets?: GitLabWidget[];
+    createdAt?: string;
+    updatedAt?: string;
+    closedAt?: string;
+    webUrl?: string;
+}
+export interface GitLabWidget {
+    type: string;
+    assignees?: {
+        nodes?: Array<{
+            id: string;
+            [key: string]: unknown;
+        }>;
+    };
+    labels?: {
+        nodes?: Array<{
+            id: string;
+            [key: string]: unknown;
+        }>;
+    };
+    milestone?: {
+        id: string;
+        [key: string]: unknown;
+    };
+    parent?: {
+        id: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+declare const GID_PREFIXES: {
+    readonly WorkItem: "gid://gitlab/WorkItem/";
+    readonly User: "gid://gitlab/User/";
+    readonly Project: "gid://gitlab/Project/";
+    readonly Group: "gid://gitlab/Group/";
+    readonly Label: "gid://gitlab/ProjectLabel/";
+    readonly Milestone: "gid://gitlab/Milestone/";
+    readonly MergeRequest: "gid://gitlab/MergeRequest/";
+    readonly Pipeline: "gid://gitlab/Ci::Pipeline/";
+    readonly Job: "gid://gitlab/Ci::Build/";
+    readonly Variable: "gid://gitlab/Ci::Variable/";
+    readonly Wiki: "gid://gitlab/Wiki/";
+    readonly Note: "gid://gitlab/Note/";
+    readonly Discussion: "gid://gitlab/Discussion/";
+};
+export type EntityType = keyof typeof GID_PREFIXES;
+export declare function extractSimpleId(gid: string): string;
+export declare function toGid(id: string, entityType: EntityType): string;
+export declare function toGids(ids: string[], entityType: EntityType): string[];
+export declare function extractSimpleIds(gids: string[]): string[];
+export declare function cleanGidsFromObject<T>(obj: T): T;
+export declare function cleanWorkItemResponse(workItem: GitLabWorkItem): GitLabWorkItem;
+export declare function convertTypeNamesToGids(typeNames: string[], namespacePath: string, getWorkItemTypes: (path: string) => Promise<GitLabWorkItemType[]>): Promise<string[]>;
+export {};

package/dist/utils/idConversion.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSimpleId = extractSimpleId;
+exports.toGid = toGid;
+exports.toGids = toGids;
+exports.extractSimpleIds = extractSimpleIds;
+exports.cleanGidsFromObject = cleanGidsFromObject;
+exports.cleanWorkItemResponse = cleanWorkItemResponse;
+exports.convertTypeNamesToGids = convertTypeNamesToGids;
+const GID_PREFIXES = {
+    WorkItem: 'gid://gitlab/WorkItem/',
+    User: 'gid://gitlab/User/',
+    Project: 'gid://gitlab/Project/',
+    Group: 'gid://gitlab/Group/',
+    Label: 'gid://gitlab/ProjectLabel/',
+    Milestone: 'gid://gitlab/Milestone/',
+    MergeRequest: 'gid://gitlab/MergeRequest/',
+    Pipeline: 'gid://gitlab/Ci::Pipeline/',
+    Job: 'gid://gitlab/Ci::Build/',
+    Variable: 'gid://gitlab/Ci::Variable/',
+    Wiki: 'gid://gitlab/Wiki/',
+    Note: 'gid://gitlab/Note/',
+    Discussion: 'gid://gitlab/Discussion/',
+};
+function extractSimpleId(gid) {
+    if (!gid || typeof gid !== 'string') {
+        return gid;
+    }
+    if (gid.startsWith('gid://gitlab/')) {
+        const parts = gid.split('/');
+        return parts[parts.length - 1];
+    }
+    return gid;
+}
+function toGid(id, entityType) {
+    if (id.startsWith('gid://gitlab/')) {
+        return id;
+    }
+    return GID_PREFIXES[entityType] + id;
+}
+function toGids(ids, entityType) {
+    return ids.map((id) => toGid(id, entityType));
+}
+function extractSimpleIds(gids) {
+    return gids.map((gid) => extractSimpleId(gid));
+}
+function cleanGidsFromObject(obj) {
+    if (!obj || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        const cleanedArray = obj.map((item) => cleanGidsFromObject(item));
+        return cleanedArray;
+    }
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === 'string' && value.startsWith('gid://gitlab/')) {
+            cleaned[key] = extractSimpleId(value);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            cleaned[key] = cleanGidsFromObject(value);
+        }
+        else {
+            cleaned[key] = value;
+        }
+    }
+    return cleaned;
+}
+function cleanWorkItemResponse(workItem) {
+    if (!workItem)
+        return workItem;
+    const result = {
+        ...workItem,
+        id: extractSimpleId(workItem.id),
+    };
+    if (workItem.workItemType) {
+        if (typeof workItem.workItemType === 'string') {
+            result.workItemType = workItem.workItemType;
+        }
+        else if (workItem.workItemType.name) {
+            result.workItemType = workItem.workItemType.name;
+        }
+        else if (workItem.workItemType.id) {
+            result.workItemType = {
+                ...workItem.workItemType,
+                id: extractSimpleId(workItem.workItemType.id),
+            };
+        }
+    }
+    if (workItem.widgets) {
+        result.widgets = workItem.widgets.map((widget) => {
+            const cleanedWidget = { ...widget };
+            if (widget.type === 'ASSIGNEES' && widget.assignees?.nodes) {
+                cleanedWidget.assignees = {
+                    ...widget.assignees,
+                    nodes: widget.assignees.nodes.map((assignee) => ({
+                        ...assignee,
+                        id: extractSimpleId(assignee.id),
+                    })),
+                };
+            }
+            if (widget.type === 'LABELS' && widget.labels?.nodes) {
+                cleanedWidget.labels = {
+                    ...widget.labels,
+                    nodes: widget.labels.nodes.map((label) => ({
+                        ...label,
+                        id: extractSimpleId(label.id),
+                    })),
+                };
+            }
+            if (widget.type === 'MILESTONE' && widget.milestone?.id) {
+                cleanedWidget.milestone = {
+                    ...widget.milestone,
+                    id: extractSimpleId(widget.milestone.id),
+                };
+            }
+            if (widget.type === 'HIERARCHY' && widget.parent?.id) {
+                cleanedWidget.parent = {
+                    ...widget.parent,
+                    id: extractSimpleId(widget.parent.id),
+                };
+            }
+            return cleanedWidget;
+        });
+    }
+    return result;
+}
+async function convertTypeNamesToGids(typeNames, namespacePath, getWorkItemTypes) {
+    if (!typeNames || typeNames.length === 0) {
+        return [];
+    }
+    const workItemTypes = await getWorkItemTypes(namespacePath);
+    const resolvedTypes = [];
+    for (const typeName of typeNames) {
+        const workItemTypeObj = workItemTypes.find((t) => t.name.toUpperCase() === typeName.toUpperCase());
+        if (workItemTypeObj) {
+            resolvedTypes.push(workItemTypeObj.id);
+        }
+        else {
+            console.warn(`Work item type "${typeName}" not found in namespace "${namespacePath}". Available types: ${workItemTypes.map((t) => t.name).join(', ')}`);
+        }
+    }
+    if (resolvedTypes.length === 0) {
+        console.warn('No valid work item types found for filtering. Using no type filter.');
+        return [];
+    }
+    return resolvedTypes;
+}
+//# sourceMappingURL=idConversion.js.map

package/dist/utils/idConversion.js.map

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

package/dist/utils/workItemTypes.d.ts

@@ -0,0 +1,6 @@
+interface WorkItemType {
+    id: string;
+    name: string;
+}
+export declare function getWorkItemTypes(namespacePath: string): Promise<WorkItemType[]>;
+export {};

package/dist/utils/workItemTypes.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWorkItemTypes = getWorkItemTypes;
+const ConnectionManager_1 = require("../services/ConnectionManager");
+const workItems_1 = require("../graphql/workItems");
+async function getWorkItemTypes(namespacePath) {
+    const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
+    const client = connectionManager.getClient();
+    const response = await client.request(workItems_1.GET_WORK_ITEM_TYPES, {
+        namespacePath: namespacePath,
+    });
+    return response.namespace?.workItemTypes?.nodes ?? [];
+}
+//# sourceMappingURL=workItemTypes.js.map

package/dist/utils/workItemTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workItemTypes.js","sourceRoot":"","sources":["../../src/utils/workItemTypes.ts"],"names":[],"mappings":";;AAaA,4CAYC;AAzBD,qEAAkE;AAClE,oDAA2D;AAYpD,KAAK,UAAU,gBAAgB,CAAC,aAAqB;IAE1D,MAAM,iBAAiB,GAAG,qCAAiB,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,EAAE,CAAC;IAG7C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,+BAAmB,EAAE;QACzD,aAAa,EAAE,aAAa;KAC7B,CAAC,CAAC;IAGH,OAAO,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@structured-world/gitlab-mcp",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "Dmitry Prudnikov <mail@polaz.com>",