gitlab-mcp-test 6.62.1

package/dist/src/utils/gitlab-api.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paths = exports.gitlab = void 0;
+exports.toQuery = toQuery;
+const fetch_1 = require("./fetch");
+const idConversion_1 = require("./idConversion");
+function buildQueryString(params) {
+    if (!params)
+        return "";
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                searchParams.append(`${key}[]`, String(item));
+            }
+        }
+        else {
+            searchParams.set(key, String(value));
+        }
+    }
+    const str = searchParams.toString();
+    return str ? `?${str}` : "";
+}
+function encodeBody(body, contentType) {
+    if (!body) {
+        return { headers: {} };
+    }
+    if (body instanceof URLSearchParams) {
+        return {
+            body: body.toString(),
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        };
+    }
+    if (body instanceof FormData) {
+        return {
+            body,
+            headers: {},
+        };
+    }
+    if (contentType === "json") {
+        return {
+            body: JSON.stringify(body),
+            headers: { "Content-Type": "application/json" },
+        };
+    }
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(body)) {
+        if (value !== undefined && value !== null) {
+            params.set(key, String(value));
+        }
+    }
+    return {
+        body: params.toString(),
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    };
+}
+async function request(method, path, options = {}) {
+    const baseUrl = process.env.GITLAB_API_URL ?? "https://gitlab.com";
+    const queryString = buildQueryString(options.query);
+    const url = `${baseUrl}/api/v4/${path}${queryString}`;
+    const { body, headers } = encodeBody(options.body, options.contentType ?? "form");
+    const hasBody = !!body;
+    const hasHeaders = Object.keys(headers).length > 0;
+    let response;
+    if (method === "GET" && !hasBody && !hasHeaders) {
+        response = await (0, fetch_1.enhancedFetch)(url);
+    }
+    else {
+        const fetchOptions = {
+            method,
+            ...(hasBody && { body }),
+            ...(hasHeaders && { headers }),
+        };
+        response = await (0, fetch_1.enhancedFetch)(url, fetchOptions);
+    }
+    if (!response.ok) {
+        let errorDetails = "";
+        try {
+            if (typeof response.text === "function") {
+                const text = await response.text();
+                if (text.trim()) {
+                    const errorResponse = JSON.parse(text);
+                    const parts = [];
+                    if (errorResponse.message) {
+                        if (typeof errorResponse.message === "string") {
+                            parts.push(errorResponse.message);
+                        }
+                        else if (typeof errorResponse.message === "object" &&
+                            "value" in errorResponse.message &&
+                            Array.isArray(errorResponse.message.value)) {
+                            parts.push(errorResponse.message.value.join(", "));
+                        }
+                        else {
+                            parts.push(JSON.stringify(errorResponse.message));
+                        }
+                    }
+                    if (errorResponse.error) {
+                        parts.push(errorResponse.error);
+                    }
+                    errorDetails = parts.join(" - ");
+                }
+            }
+        }
+        catch {
+        }
+        throw new Error(`GitLab API error: ${response.status} ${response.statusText}${errorDetails ? ` - ${errorDetails}` : ""}`);
+    }
+    if (response.status === 204) {
+        return undefined;
+    }
+    const data = (await response.json());
+    return options.rawResponse ? data : (0, idConversion_1.cleanGidsFromObject)(data);
+}
+exports.gitlab = {
+    get: (path, options) => request("GET", path, options),
+    post: (path, options) => request("POST", path, options),
+    put: (path, options) => request("PUT", path, options),
+    delete: (path, options) => request("DELETE", path, options),
+    patch: (path, options) => request("PATCH", path, options),
+};
+exports.paths = {
+    encode: (path) => encodeURIComponent(path),
+    project: (id) => `projects/${typeof id === "number" ? id : encodeURIComponent(id)}`,
+    group: (id) => `groups/${typeof id === "number" ? id : encodeURIComponent(id)}`,
+    namespace: (path, entityType) => `${entityType}/${encodeURIComponent(path)}`,
+};
+function toQuery(options, exclude = []) {
+    const result = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (!exclude.includes(key) && value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+exports.default = exports.gitlab;
+//# sourceMappingURL=gitlab-api.js.map

package/dist/src/utils/gitlab-api.js.map

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

package/dist/src/utils/idConversion.d.ts

@@ -0,0 +1,81 @@
+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;
+    };
+    linkedItems?: {
+        nodes?: Array<{
+            linkType?: string;
+            workItem?: {
+                id: string;
+                [key: string]: unknown;
+            };
+            [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 Iteration: "gid://gitlab/Iteration/";
+    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/";
+    readonly Timelog: "gid://gitlab/Timelog/";
+};
+export type EntityType = keyof typeof GID_PREFIXES;
+export declare function extractSimpleId(gid: string): string;
+export declare function normalizeWorkItemGid(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/src/utils/idConversion.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSimpleId = extractSimpleId;
+exports.normalizeWorkItemGid = normalizeWorkItemGid;
+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/",
+    Iteration: "gid://gitlab/Iteration/",
+    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/",
+    Timelog: "gid://gitlab/Timelog/",
+};
+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 normalizeWorkItemGid(gid) {
+    if (!gid || typeof gid !== "string") {
+        return gid;
+    }
+    const legacyTypes = ["Issue", "Epic", "Task", "Incident", "TestCase", "Requirement"];
+    for (const type of legacyTypes) {
+        const prefix = `gid://gitlab/${type}/`;
+        if (gid.startsWith(prefix)) {
+            return gid.replace(prefix, "gid://gitlab/WorkItem/");
+        }
+    }
+    return gid;
+}
+function toGid(id, entityType) {
+    if (id.startsWith("gid://gitlab/")) {
+        if (entityType === "WorkItem") {
+            return normalizeWorkItemGid(id);
+        }
+        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 normalizeLinkType(linkType) {
+    if (!linkType)
+        return linkType;
+    const mapping = {
+        is_blocked_by: "BLOCKED_BY",
+        blocks: "BLOCKS",
+        related: "RELATED",
+        BLOCKED_BY: "BLOCKED_BY",
+        BLOCKS: "BLOCKS",
+        RELATED: "RELATED",
+    };
+    return mapping[linkType] ?? linkType;
+}
+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),
+                };
+            }
+            if (widget.type === "LINKED_ITEMS" && widget.linkedItems?.nodes) {
+                cleanedWidget.linkedItems = {
+                    ...widget.linkedItems,
+                    nodes: widget.linkedItems.nodes.map(node => ({
+                        ...node,
+                        linkType: normalizeLinkType(node.linkType),
+                        workItem: node.workItem
+                            ? { ...node.workItem, id: extractSimpleId(node.workItem.id) }
+                            : node.workItem,
+                    })),
+                };
+            }
+            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/src/utils/idConversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idConversion.js","sourceRoot":"","sources":["../../../src/utils/idConversion.ts"],"names":[],"mappings":";;AAiFA,0CASC;AAYD,oDAgBC;AAQD,sBASC;AAQD,wBAEC;AAOD,4CAEC;AAOD,kDAuBC;AA0BD,sDAyFC;AASD,wDAkCC;AA9RD,MAAM,YAAY,GAAG;IACnB,QAAQ,EAAE,wBAAwB;IAClC,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,uBAAuB;IAChC,KAAK,EAAE,qBAAqB;IAC5B,KAAK,EAAE,4BAA4B;IACnC,SAAS,EAAE,yBAAyB;IACpC,SAAS,EAAE,yBAAyB;IACpC,YAAY,EAAE,4BAA4B;IAC1C,QAAQ,EAAE,4BAA4B;IACtC,GAAG,EAAE,yBAAyB;IAC9B,QAAQ,EAAE,4BAA4B;IACtC,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,oBAAoB;IAC1B,UAAU,EAAE,0BAA0B;IACtC,OAAO,EAAE,uBAAuB;CACxB,CAAC;AASX,SAAgB,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAYD,SAAgB,oBAAoB,CAAC,GAAW;IAC9C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC;IACb,CAAC;IAGD,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAErF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,gBAAgB,IAAI,GAAG,CAAC;QACvC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAQD,SAAgB,KAAK,CAAC,EAAU,EAAE,UAAsB;IAEtD,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACnC,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;AACvC,CAAC;AAQD,SAAgB,MAAM,CAAC,GAAa,EAAE,UAAsB;IAC1D,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;AAC9C,CAAC;AAOD,SAAgB,gBAAgB,CAAC,IAAc;IAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAOD,SAAgB,mBAAmB,CAAI,GAAM;IAC3C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAEvB,MAAM,YAAY,GAAc,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,OAAO,YAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,OAAY,CAAC;AACtB,CAAC;AAOD,SAAS,iBAAiB,CAAC,QAA4B;IACrD,IAAI,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/B,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,YAAY;QAC3B,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,SAAS;QAElB,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,SAAS;KACnB,CAAC;IACF,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;AACvC,CAAC;AAOD,SAAgB,qBAAqB,CAAC,QAAwB;IAC5D,IAAI,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE/B,MAAM,MAAM,GAAmB;QAC7B,GAAG,QAAQ;QACX,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;KACjC,CAAC;IAGF,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YAE9C,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;QAC9C,CAAC;aAAM,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAGtC,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC;QACnD,CAAC;aAAM,IAAI,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;YAEpC,MAAM,CAAC,YAAY,GAAG;gBACpB,GAAG,QAAQ,CAAC,YAAY;gBACxB,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;aAC9C,CAAC;QACJ,CAAC;IACH,CAAC;IAGD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAoB,EAAE,EAAE;YAC7D,MAAM,aAAa,GAAiB,EAAE,GAAG,MAAM,EAAE,CAAC;YAGlD,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;gBAC3D,aAAa,CAAC,SAAS,GAAG;oBACxB,GAAG,MAAM,CAAC,SAAS;oBACnB,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;wBAC7C,GAAG,QAAQ;wBACX,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;qBACjC,CAAC,CAAC;iBACJ,CAAC;YACJ,CAAC;YAGD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACrD,aAAa,CAAC,MAAM,GAAG;oBACrB,GAAG,MAAM,CAAC,MAAM;oBAChB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;wBACvC,GAAG,KAAK;wBACR,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;qBAC9B,CAAC,CAAC;iBACJ,CAAC;YACJ,CAAC;YAGD,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC;gBACxD,aAAa,CAAC,SAAS,GAAG;oBACxB,GAAG,MAAM,CAAC,SAAS;oBACnB,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;iBACzC,CAAC;YACJ,CAAC;YAGD,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;gBACrD,aAAa,CAAC,MAAM,GAAG;oBACrB,GAAG,MAAM,CAAC,MAAM;oBAChB,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;iBACtC,CAAC;YACJ,CAAC;YAGD,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;gBAChE,aAAa,CAAC,WAAW,GAAG;oBAC1B,GAAG,MAAM,CAAC,WAAW;oBACrB,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC3C,GAAG,IAAI;wBAEP,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC;wBAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ;4BACrB,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;4BAC7D,CAAC,CAAC,IAAI,CAAC,QAAQ;qBAClB,CAAC,CAAC;iBACJ,CAAC;YACJ,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AASM,KAAK,UAAU,sBAAsB,CAC1C,SAAmB,EACnB,aAAqB,EAErB,gBAAiE;IAEjE,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;IAGD,MAAM,aAAa,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,aAAa,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CACrD,CAAC;QAEF,IAAI,eAAe,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CACV,mBAAmB,QAAQ,6BAA6B,aAAa,uBAAuB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxI,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QACpF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/src/utils/namespace.d.ts

@@ -0,0 +1,7 @@
+export declare function extractNamespaceFromPath(projectPath: string): string | undefined;
+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/src/utils/namespace.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractNamespaceFromPath = extractNamespaceFromPath;
+exports.isLikelyProjectPath = isLikelyProjectPath;
+exports.detectNamespaceType = detectNamespaceType;
+exports.resolveNamespaceForAPI = resolveNamespaceForAPI;
+const fetch_1 = require("./fetch");
+function extractNamespaceFromPath(projectPath) {
+    if (!projectPath) {
+        return undefined;
+    }
+    const pathParts = projectPath.split("/");
+    if (pathParts.length === 1) {
+        return projectPath;
+    }
+    return pathParts.slice(0, -1).join("/");
+}
+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);
+        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/src/utils/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/utils/namespace.ts"],"names":[],"mappings":";;AAcA,4DAcC;AAMD,kDAEC;AAMD,kDAuBC;AA0BD,wDASC;AApGD,mCAAwC;AAcxC,SAAgB,wBAAwB,CAAC,WAAmB;IAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAGzC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IAGD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAMD,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,CAAC,CAAC;QAE7C,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/src/utils/projectIdentifier.d.ts

@@ -0,0 +1,9 @@
+export interface ProjectIdentifier {
+    identifier: string;
+    isNumericId: boolean;
+    originalValue: string;
+}
+export declare function processProjectIdentifier(input: string): ProjectIdentifier;
+export declare function safeEncodeProjectId(projectId: string): string;
+export declare function normalizeProjectId(projectId: string): string;
+export declare function validateProjectIdentifier(input: string): string | null;

package/dist/src/utils/projectIdentifier.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processProjectIdentifier = processProjectIdentifier;
+exports.safeEncodeProjectId = safeEncodeProjectId;
+exports.normalizeProjectId = normalizeProjectId;
+exports.validateProjectIdentifier = validateProjectIdentifier;
+function isUrlEncoded(str) {
+    return /%[0-9A-Fa-f]{2}/.test(str);
+}
+function isNumericId(str) {
+    return /^\d+$/.test(str.trim());
+}
+function processProjectIdentifier(input) {
+    const trimmedInput = input.trim();
+    if (isNumericId(trimmedInput)) {
+        return {
+            identifier: trimmedInput,
+            isNumericId: true,
+            originalValue: input,
+        };
+    }
+    let identifier;
+    if (isUrlEncoded(trimmedInput)) {
+        identifier = trimmedInput;
+    }
+    else {
+        identifier = encodeURIComponent(trimmedInput);
+    }
+    return {
+        identifier,
+        isNumericId: false,
+        originalValue: input,
+    };
+}
+function safeEncodeProjectId(projectId) {
+    const processed = processProjectIdentifier(projectId);
+    return processed.identifier;
+}
+function normalizeProjectId(projectId) {
+    return safeEncodeProjectId(projectId);
+}
+function validateProjectIdentifier(input) {
+    if (!input || typeof input !== "string") {
+        return "Project identifier is required and must be a string";
+    }
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        return "Project identifier cannot be empty";
+    }
+    if (isNumericId(trimmed)) {
+        return null;
+    }
+    const decoded = isUrlEncoded(trimmed) ? decodeURIComponent(trimmed) : trimmed;
+    if (!/^[a-zA-Z0-9\-_./]+$/.test(decoded)) {
+        return "Invalid project identifier format. Use numeric ID or namespace/project path.";
+    }
+    return null;
+}
+//# sourceMappingURL=projectIdentifier.js.map

package/dist/src/utils/projectIdentifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectIdentifier.js","sourceRoot":"","sources":["../../../src/utils/projectIdentifier.ts"],"names":[],"mappings":";;AAuCA,4DA4BC;AAOD,kDAGC;AAMD,gDAEC;AAMD,8DAwBC;AA/FD,SAAS,YAAY,CAAC,GAAW;IAE/B,OAAO,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAKD,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;AASD,SAAgB,wBAAwB,CAAC,KAAa;IACpD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAGlC,IAAI,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,UAAU,EAAE,YAAY;YACxB,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAGD,IAAI,UAAkB,CAAC;IAEvB,IAAI,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAE/B,UAAU,GAAG,YAAY,CAAC;IAC5B,CAAC;SAAM,CAAC;QAEN,UAAU,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,UAAU;QACV,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE,KAAK;KACrB,CAAC;AACJ,CAAC;AAOD,SAAgB,mBAAmB,CAAC,SAAiB;IACnD,MAAM,SAAS,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO,SAAS,CAAC,UAAU,CAAC;AAC9B,CAAC;AAMD,SAAgB,kBAAkB,CAAC,SAAiB;IAClD,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAMD,SAAgB,yBAAyB,CAAC,KAAa;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IAGD,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAG9E,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO,8EAA8E,CAAC;IACxF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/utils/request-logger.d.ts

@@ -0,0 +1,24 @@
+import { Request, Response } from "express";
+export interface RequestContext {
+    requestId: string;
+    ip: string;
+    method: string;
+    path: string;
+    userAgent?: string;
+    hasOAuthSession: boolean;
+    hasMcpSessionHeader: boolean;
+    oauthSessionId?: string;
+    mcpSessionId?: string;
+}
+export interface RateLimitInfo {
+    type: "ip" | "session";
+    key: string;
+    used: number;
+    limit: number;
+    resetInSec: number;
+}
+export declare function getIpAddress(req: Request): string;
+export declare function truncateId(id: string | undefined): string | undefined;
+export declare function getRequestContext(req: Request, res: Response): RequestContext;
+export declare function getMinimalRequestContext(req: Request): Pick<RequestContext, "requestId" | "ip" | "method" | "path" | "userAgent">;
+export declare function buildRateLimitInfo(type: "ip" | "session", key: string, used: number, limit: number, resetAt: number): RateLimitInfo;

package/dist/src/utils/request-logger.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIpAddress = getIpAddress;
+exports.truncateId = truncateId;
+exports.getRequestContext = getRequestContext;
+exports.getMinimalRequestContext = getMinimalRequestContext;
+exports.buildRateLimitInfo = buildRateLimitInfo;
+const crypto_1 = require("crypto");
+function generateRequestId() {
+    return (0, crypto_1.randomUUID)().substring(0, 8);
+}
+function getIpAddress(req) {
+    return req.ip ?? req.socket?.remoteAddress ?? "unknown";
+}
+const logger_1 = require("../logger");
+function truncateId(id) {
+    if (!id)
+        return undefined;
+    return (0, logger_1.truncateId)(id);
+}
+function getRequestContext(req, res) {
+    const mcpSessionId = req.headers["mcp-session-id"];
+    const oauthSessionId = res.locals.oauthSessionId;
+    return {
+        requestId: generateRequestId(),
+        ip: getIpAddress(req),
+        method: req.method,
+        path: req.path,
+        userAgent: req.headers["user-agent"],
+        hasOAuthSession: !!oauthSessionId,
+        hasMcpSessionHeader: !!mcpSessionId,
+        oauthSessionId: truncateId(oauthSessionId),
+        mcpSessionId: truncateId(mcpSessionId),
+    };
+}
+function getMinimalRequestContext(req) {
+    return {
+        requestId: generateRequestId(),
+        ip: getIpAddress(req),
+        method: req.method,
+        path: req.path,
+        userAgent: req.headers["user-agent"],
+    };
+}
+function buildRateLimitInfo(type, key, used, limit, resetAt) {
+    const resetInSec = Math.max(0, Math.ceil((resetAt - Date.now()) / 1000));
+    return {
+        type,
+        key: type === "session" ? (truncateId(key) ?? key) : key,
+        used,
+        limit,
+        resetInSec,
+    };
+}
+//# sourceMappingURL=request-logger.js.map