gitlab-mcp 1.4.0 → 1.5.0

package/dist/lib/gitlab-client.js

@@ -21,6 +21,7 @@ export class GitLabClient {
     apiUrls;
     nextApiUrlIndex = 0;
     defaultToken;
+    defaultAuthHeader;
     timeoutMs;
     maxAttachmentBytes;
     maxLocalFileBytes;
@@ -33,6 +34,7 @@ export class GitLabClient {
             .filter((item) => item.length > 0) ?? [this.baseApiUrl];
         this.apiUrls = configuredApiUrls.length > 0 ? configuredApiUrls : [this.baseApiUrl];
         this.defaultToken = defaultToken;
+        this.defaultAuthHeader = options.defaultAuthHeader;
         this.timeoutMs = options.timeoutMs ?? 20_000;
         this.maxAttachmentBytes =
             options.maxAttachmentBytes ?? GitLabClient.DEFAULT_MAX_ATTACHMENT_BYTES;
@@ -58,6 +60,16 @@ export class GitLabClient {
             }
         });
     }
+    createGroup(payload, options = {}) {
+        return this.post("/groups", {
+            ...options,
+            body: JSON.stringify(payload),
+            headers: {
+                "Content-Type": "application/json",
+                ...(options.headers ?? {})
+            }
+        });
+    }
     listProjectMembers(projectId, options = {}) {
         return this.get(`/projects/${encode(projectId)}/members/all`, options);
     }
@@ -95,6 +107,16 @@ export class GitLabClient {
             }
         });
     }
+    searchCode(search, options = {}) {
+        return this.get("/search", {
+            ...options,
+            query: {
+                scope: "blobs",
+                search,
+                ...(options.query ?? {})
+            }
+        });
+    }
     searchCodeBlobs(projectId, search, options = {}) {
         return this.get(`/projects/${encode(projectId)}/search`, {
             ...options,
@@ -105,9 +127,67 @@ export class GitLabClient {
             }
         });
     }
+    searchGroupCodeBlobs(groupId, search, options = {}) {
+        return this.get(`/groups/${encode(groupId)}/search`, {
+            ...options,
+            query: {
+                scope: "blobs",
+                search,
+                ...(options.query ?? {})
+            }
+        });
+    }
     // repository/files
-    getRepositoryTree(projectId, options = {}) {
-        return this.get(`/projects/${encode(projectId)}/repository/tree`, options);
+    async getRepositoryTree(projectId, options = {}) {
+        const config = this.resolveRequestConfig(options);
+        const url = new URL(`projects/${encode(projectId)}/repository/tree`, `${config.apiUrl}/`);
+        for (const [key, value] of Object.entries(options.query ?? {})) {
+            if (value !== undefined && value !== null) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const response = await this.fetchRawResponse(url, {
+            method: "GET",
+            headers: {
+                Accept: "application/json",
+                ...(options.headers ?? {})
+            },
+            token: config.token,
+            authHeader: config.authHeader
+        });
+        let body;
+        try {
+            body = await this.parseResponseBody(response);
+        }
+        catch (error) {
+            if (response.ok) {
+                throw error;
+            }
+            throw new GitLabApiError(`GitLab API request failed: ${response.status} ${response.statusText}`, response.status, {
+                message: error instanceof Error ? error.message : "Failed to read GitLab error response"
+            });
+        }
+        if (!response.ok) {
+            throw new GitLabApiError(`GitLab API request failed: ${response.status} ${response.statusText}`, response.status, body);
+        }
+        const usesKeyset = options.query?.pagination === "keyset";
+        const nextPageToken = response.headers.get("x-next-page-token") ??
+            (usesKeyset ? response.headers.get("x-next-page") : null) ??
+            undefined;
+        if (!usesKeyset && !nextPageToken) {
+            return body;
+        }
+        return {
+            items: Array.isArray(body) ? body : [],
+            ...(nextPageToken
+                ? {
+                    next_page_token: nextPageToken,
+                    pagination_note: "Pass next_page_token as page_token with pagination=keyset to retrieve the next page."
+                }
+                : {
+                    pagination_note: "No next_page_token was returned; this is the final keyset page."
+                })
+        };
     }
     getFileContents(projectId, filePath, ref, options = {}) {
         return this.get(`/projects/${encode(projectId)}/repository/files/${encode(filePath)}`, {
@@ -118,6 +198,15 @@ export class GitLabClient {
             }
         });
     }
+    getFileBlame(projectId, filePath, ref, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/repository/files/${encode(filePath)}/blame`, {
+            ...options,
+            query: {
+                ref,
+                ...(options.query ?? {})
+            }
+        });
+    }
     createOrUpdateFile(projectId, filePath, payload, options = {}) {
         return this.put(`/projects/${encode(projectId)}/repository/files/${encode(filePath)}`, {
             ...options,
@@ -144,6 +233,15 @@ export class GitLabClient {
             query: payload
         });
     }
+    listBranches(projectId, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/repository/branches`, options);
+    }
+    getBranch(projectId, branch, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/repository/branches/${encode(branch)}`, options);
+    }
+    deleteBranch(projectId, branch, options = {}) {
+        return this.delete(`/projects/${encode(projectId)}/repository/branches/${encode(branch)}`, options);
+    }
     getBranchDiffs(projectId, payload, options = {}) {
         return this.get(`/projects/${encode(projectId)}/repository/compare`, {
             ...options,
@@ -159,6 +257,18 @@ export class GitLabClient {
     getCommitDiff(projectId, sha, options = {}) {
         return this.get(`/projects/${encode(projectId)}/repository/commits/${encode(sha)}/diff`, options);
     }
+    listCommitStatuses(projectId, sha, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/repository/commits/${encode(sha)}/statuses`, options);
+    }
+    createCommitStatus(projectId, sha, payload, options = {}) {
+        return this.post(`/projects/${encode(projectId)}/statuses/${encode(sha)}`, {
+            ...options,
+            query: {
+                ...payload,
+                ...(options.query ?? {})
+            }
+        });
+    }
     // merge requests
     listMergeRequests(projectId, options = {}) {
         return this.get(`/projects/${encode(projectId)}/merge_requests`, options);
@@ -167,7 +277,59 @@ export class GitLabClient {
         return this.get("/merge_requests", options);
     }
     getMergeRequest(projectId, mergeRequestIid, options = {}) {
-        return this.get(`/projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}`, options);
+        return this.get(`/projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}`, {
+            ...options,
+            query: {
+                include_diverged_commits_count: true,
+                ...(options.query ?? {})
+            }
+        });
+    }
+    async countMergeRequestCommits(projectId, mergeRequestIid, options = {}) {
+        const config = this.resolveRequestConfig(options);
+        let page = 1;
+        let totalCount = 0;
+        while (true) {
+            const url = new URL(`projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}/commits`, `${config.apiUrl}/`);
+            for (const [key, value] of Object.entries(options.query ?? {})) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+            if (!url.searchParams.has("per_page")) {
+                url.searchParams.set("per_page", "100");
+            }
+            url.searchParams.set("page", String(page));
+            const response = await this.fetchRawResponse(url, {
+                method: "GET",
+                headers: {
+                    Accept: "application/json",
+                    ...(options.headers ?? {})
+                },
+                token: config.token,
+                authHeader: config.authHeader
+            });
+            const body = await this.parseApiResponse(response);
+            if (!Array.isArray(body)) {
+                throw new Error("Unexpected merge request commits response format");
+            }
+            totalCount += body.length;
+            const nextPage = response.headers.get("x-next-page");
+            if (!nextPage) {
+                return totalCount;
+            }
+            const parsedNextPage = Number.parseInt(nextPage, 10);
+            if (!Number.isFinite(parsedNextPage) || parsedNextPage <= page) {
+                return totalCount;
+            }
+            page = parsedNextPage;
+        }
+    }
+    listMergeRequestCommits(projectId, mergeRequestIid, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}/commits`, options);
+    }
+    listMergeRequestPipelines(projectId, mergeRequestIid, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}/pipelines`, options);
     }
     createMergeRequest(projectId, payload, options = {}) {
         return this.post(`/projects/${encode(projectId)}/merge_requests`, {
@@ -231,8 +393,28 @@ export class GitLabClient {
             }
         });
     }
-    getMergeRequestApprovalState(projectId, mergeRequestIid, options = {}) {
-        return this.get(`/projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}/approval_state`, options);
+    async getMergeRequestApprovalState(projectId, mergeRequestIid, options = {}) {
+        const config = this.resolveRequestConfig(options);
+        const url = new URL(`projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}/approval_state`, `${config.apiUrl}/`);
+        for (const [key, value] of Object.entries(options.query ?? {})) {
+            if (value !== undefined && value !== null) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const response = await this.fetchRawResponse(url, {
+            method: "GET",
+            headers: {
+                Accept: "application/json",
+                ...(options.headers ?? {})
+            },
+            token: config.token,
+            authHeader: config.authHeader
+        });
+        if (response.status === 404) {
+            const approvals = await this.get(`/projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}/approvals`, options);
+            return normalizeMergeRequestApprovalsFallback(approvals);
+        }
+        return normalizeMergeRequestApprovalState(await this.parseApiResponse(response));
     }
     getMergeRequestConflicts(projectId, mergeRequestIid, options = {}) {
         return this.get(`/projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}/conflicts`, options);
@@ -299,6 +481,34 @@ export class GitLabClient {
             }
         });
     }
+    listMergeRequestEmojiReactions(projectId, mergeRequestIid, options = {}) {
+        return this.get(this.awardEmojiPath("merge_requests", projectId, mergeRequestIid), options);
+    }
+    createMergeRequestEmojiReaction(projectId, mergeRequestIid, name, options = {}) {
+        return this.createAwardEmoji(this.awardEmojiPath("merge_requests", projectId, mergeRequestIid), name, options);
+    }
+    deleteMergeRequestEmojiReaction(projectId, mergeRequestIid, awardId, options = {}) {
+        return this.delete(this.awardEmojiPath("merge_requests", projectId, mergeRequestIid, { awardId }), options);
+    }
+    listMergeRequestNoteEmojiReactions(projectId, mergeRequestIid, noteId, payload = {}, options = {}) {
+        return this.get(this.awardEmojiPath("merge_requests", projectId, mergeRequestIid, {
+            noteId,
+            discussionId: payload.discussion_id
+        }), options);
+    }
+    createMergeRequestNoteEmojiReaction(projectId, mergeRequestIid, noteId, payload, options = {}) {
+        return this.createAwardEmoji(this.awardEmojiPath("merge_requests", projectId, mergeRequestIid, {
+            noteId,
+            discussionId: payload.discussion_id
+        }), payload.name, options);
+    }
+    deleteMergeRequestNoteEmojiReaction(projectId, mergeRequestIid, noteId, payload, options = {}) {
+        return this.delete(this.awardEmojiPath("merge_requests", projectId, mergeRequestIid, {
+            noteId,
+            discussionId: payload.discussion_id,
+            awardId: payload.award_id
+        }), options);
+    }
     getDraftNote(projectId, mergeRequestIid, draftNoteId, options = {}) {
         return this.get(`/projects/${encode(projectId)}/merge_requests/${encode(mergeRequestIid)}/draft_notes/${encode(draftNoteId)}`, options);
     }
@@ -424,6 +634,15 @@ export class GitLabClient {
             }
         });
     }
+    listTodos(options = {}) {
+        return this.get("/todos", options);
+    }
+    markTodoDone(todoId, options = {}) {
+        return this.post(`/todos/${encode(todoId)}/mark_as_done`, options);
+    }
+    markAllTodosDone(options = {}) {
+        return this.post("/todos/mark_as_done", options);
+    }
     listIssueDiscussions(projectId, issueIid, options = {}) {
         return this.get(`/projects/${encode(projectId)}/issues/${encode(issueIid)}/discussions`, options);
     }
@@ -443,6 +662,34 @@ export class GitLabClient {
             }
         });
     }
+    listIssueEmojiReactions(projectId, issueIid, options = {}) {
+        return this.get(this.awardEmojiPath("issues", projectId, issueIid), options);
+    }
+    createIssueEmojiReaction(projectId, issueIid, name, options = {}) {
+        return this.createAwardEmoji(this.awardEmojiPath("issues", projectId, issueIid), name, options);
+    }
+    deleteIssueEmojiReaction(projectId, issueIid, awardId, options = {}) {
+        return this.delete(this.awardEmojiPath("issues", projectId, issueIid, { awardId }), options);
+    }
+    listIssueNoteEmojiReactions(projectId, issueIid, noteId, payload = {}, options = {}) {
+        return this.get(this.awardEmojiPath("issues", projectId, issueIid, {
+            noteId,
+            discussionId: payload.discussion_id
+        }), options);
+    }
+    createIssueNoteEmojiReaction(projectId, issueIid, noteId, payload, options = {}) {
+        return this.createAwardEmoji(this.awardEmojiPath("issues", projectId, issueIid, {
+            noteId,
+            discussionId: payload.discussion_id
+        }), payload.name, options);
+    }
+    deleteIssueNoteEmojiReaction(projectId, issueIid, noteId, payload, options = {}) {
+        return this.delete(this.awardEmojiPath("issues", projectId, issueIid, {
+            noteId,
+            discussionId: payload.discussion_id,
+            awardId: payload.award_id
+        }), options);
+    }
     updateIssueNote(projectId, issueIid, discussionId, noteId, payload, options = {}) {
         return this.put(`/projects/${encode(projectId)}/issues/${encode(issueIid)}/discussions/${encode(discussionId)}/notes/${encode(noteId)}`, {
             ...options,
@@ -502,6 +749,35 @@ export class GitLabClient {
     deleteWikiPage(projectId, slug, options = {}) {
         return this.delete(`/projects/${encode(projectId)}/wikis/${encode(slug)}`, options);
     }
+    listGroupWikiPages(groupId, options = {}) {
+        return this.get(`/groups/${encode(groupId)}/wikis`, options);
+    }
+    getGroupWikiPage(groupId, slug, options = {}) {
+        return this.get(`/groups/${encode(groupId)}/wikis/${encode(slug)}`, options);
+    }
+    createGroupWikiPage(groupId, payload, options = {}) {
+        return this.post(`/groups/${encode(groupId)}/wikis`, {
+            ...options,
+            body: JSON.stringify(payload),
+            headers: {
+                "Content-Type": "application/json",
+                ...(options.headers ?? {})
+            }
+        });
+    }
+    updateGroupWikiPage(groupId, slug, payload, options = {}) {
+        return this.put(`/groups/${encode(groupId)}/wikis/${encode(slug)}`, {
+            ...options,
+            body: JSON.stringify(payload),
+            headers: {
+                "Content-Type": "application/json",
+                ...(options.headers ?? {})
+            }
+        });
+    }
+    deleteGroupWikiPage(groupId, slug, options = {}) {
+        return this.delete(`/groups/${encode(groupId)}/wikis/${encode(slug)}`, options);
+    }
     // pipelines
     listPipelines(projectId, options = {}) {
         return this.get(`/projects/${encode(projectId)}/pipelines`, options);
@@ -533,6 +809,19 @@ export class GitLabClient {
     getPipelineJobOutput(projectId, jobId, options = {}) {
         return this.get(`/projects/${encode(projectId)}/jobs/${encode(jobId)}/trace`, options);
     }
+    validateCiLint(projectId, payload, options = {}) {
+        return this.post(`/projects/${encode(projectId)}/ci/lint`, {
+            ...options,
+            body: JSON.stringify(payload),
+            headers: {
+                "Content-Type": "application/json",
+                ...(options.headers ?? {})
+            }
+        });
+    }
+    validateProjectCiLint(projectId, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/ci/lint`, options);
+    }
     listJobArtifacts(projectId, jobId, options = {}) {
         return this.get(`/projects/${encode(projectId)}/jobs/${encode(jobId)}/artifacts/tree`, options);
     }
@@ -675,8 +964,37 @@ export class GitLabClient {
         return this.post(`/projects/${encode(projectId)}/releases/${encode(tagName)}/evidence`, options);
     }
     downloadReleaseAsset(projectId, tagName, directAssetPath, options = {}) {
+        const requestConfig = this.resolveRequestConfig(options);
         const safePath = encodeSlashPath(directAssetPath);
-        return this.get(`/projects/${encode(projectId)}/releases/${encode(tagName)}/downloads/${safePath}`, options);
+        const url = new URL(`projects/${encode(projectId)}/releases/${encode(tagName)}/downloads/${safePath}`, `${requestConfig.apiUrl}/`);
+        return this.downloadFile(url, {
+            headers: options.headers,
+            token: requestConfig.token,
+            authHeader: requestConfig.authHeader
+        }, "Release asset", path.basename(directAssetPath) || "release-asset");
+    }
+    // tags
+    listTags(projectId, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/repository/tags`, options);
+    }
+    getTag(projectId, tagName, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/repository/tags/${encode(tagName)}`, options);
+    }
+    createTag(projectId, payload, options = {}) {
+        return this.post(`/projects/${encode(projectId)}/repository/tags`, {
+            ...options,
+            body: JSON.stringify(payload),
+            headers: {
+                "Content-Type": "application/json",
+                ...(options.headers ?? {})
+            }
+        });
+    }
+    deleteTag(projectId, tagName, options = {}) {
+        return this.delete(`/projects/${encode(projectId)}/repository/tags/${encode(tagName)}`, options);
+    }
+    getTagSignature(projectId, tagName, options = {}) {
+        return this.get(`/projects/${encode(projectId)}/repository/tags/${encode(tagName)}/signature`, options);
     }
     // labels
     listLabels(projectId, options = {}) {
@@ -730,12 +1048,24 @@ export class GitLabClient {
     getUsers(options = {}) {
         return this.get("/users", options);
     }
+    getUser(userId, options = {}) {
+        return this.get(`/users/${encode(userId)}`, options);
+    }
+    whoami(options = {}) {
+        return this.get("/user", options);
+    }
     listEvents(options = {}) {
         return this.get("/events", options);
     }
     getProjectEvents(projectId, options = {}) {
         return this.get(`/projects/${encode(projectId)}/events`, options);
     }
+    listWebhooks(scope, options = {}) {
+        return this.get(`${this.webhookBasePath(scope)}/hooks`, options);
+    }
+    listWebhookEvents(scope, hookId, options = {}) {
+        return this.get(`${this.webhookBasePath(scope)}/hooks/${encode(hookId)}/events`, options);
+    }
     // attachments / markdown
     uploadMarkdown(projectId, content, filename, options = {}) {
         const form = new FormData();
@@ -1003,6 +1333,24 @@ export class GitLabClient {
         }
         return body;
     }
+    async parseApiResponse(response) {
+        let body;
+        try {
+            body = await this.parseResponseBody(response);
+        }
+        catch (error) {
+            if (response.ok) {
+                throw error;
+            }
+            throw new GitLabApiError(`GitLab API request failed: ${response.status} ${response.statusText}`, response.status, {
+                message: error instanceof Error ? error.message : "Failed to read GitLab error response"
+            });
+        }
+        if (!response.ok) {
+            throw new GitLabApiError(`GitLab API request failed: ${response.status} ${response.statusText}`, response.status, body);
+        }
+        return body;
+    }
     async parseResponseBody(response) {
         assertContentLengthWithinLimit(response, this.maxResponseBodyBytes, "Response body");
         const text = await readResponseTextWithLimit(response, this.maxResponseBodyBytes, "Response body");
@@ -1021,7 +1369,7 @@ export class GitLabClient {
         const sessionAuth = getSessionAuth();
         const apiUrl = options.apiUrl ?? sessionAuth?.apiUrl ?? this.pickApiUrl();
         const token = options.token ?? sessionAuth?.token ?? this.defaultToken;
-        const authHeader = options.authHeader ?? sessionAuth?.header;
+        const authHeader = options.authHeader ?? sessionAuth?.header ?? this.defaultAuthHeader;
         return {
             apiUrl: normalizeApiUrl(apiUrl),
             token,
@@ -1036,6 +1384,38 @@ export class GitLabClient {
         this.nextApiUrlIndex = (this.nextApiUrlIndex + 1) % this.apiUrls.length;
         return this.apiUrls[index] ?? this.baseApiUrl;
     }
+    webhookBasePath(scope) {
+        if (scope.projectId) {
+            return `/projects/${encode(scope.projectId)}`;
+        }
+        if (scope.groupId) {
+            return `/groups/${encode(scope.groupId)}`;
+        }
+        throw new Error("Either projectId or groupId is required");
+    }
+    awardEmojiPath(entity, projectId, entityIid, options = {}) {
+        let path = `/projects/${encode(projectId)}/${entity}/${encode(entityIid)}`;
+        if (options.noteId) {
+            path += options.discussionId
+                ? `/discussions/${encode(options.discussionId)}/notes/${encode(options.noteId)}`
+                : `/notes/${encode(options.noteId)}`;
+        }
+        path += "/award_emoji";
+        if (options.awardId) {
+            path += `/${encode(options.awardId)}`;
+        }
+        return path;
+    }
+    createAwardEmoji(path, name, options) {
+        return this.post(path, {
+            ...options,
+            body: JSON.stringify({ name }),
+            headers: {
+                "Content-Type": "application/json",
+                ...(options.headers ?? {})
+            }
+        });
+    }
     resolveAbsoluteUrl(raw, apiUrl) {
         if (/^https?:\/\//i.test(raw)) {
             return new URL(raw);
@@ -1093,6 +1473,70 @@ function encodeSlashPath(pathValue) {
         .map((segment) => encode(segment))
         .join("/");
 }
+function normalizeMergeRequestApprovalState(value) {
+    if (!isRecord(value)) {
+        return value;
+    }
+    const approvedBy = uniqueApprovalUsers(extractApprovalRules(value.rules).flatMap((rule) => extractApprovalUsers(rule.approved_by)));
+    return {
+        ...value,
+        approved_by: approvedBy,
+        approved_by_usernames: approvedBy
+            .map((user) => user.username)
+            .filter((username) => typeof username === "string"),
+        source_endpoint: "approval_state"
+    };
+}
+function normalizeMergeRequestApprovalsFallback(value) {
+    if (!isRecord(value)) {
+        return value;
+    }
+    const approvedBy = uniqueApprovalUsers(extractApprovalEntries(value.approved_by).flatMap((entry) => [entry.user]));
+    return {
+        approved: typeof value.approved === "boolean" ? value.approved : undefined,
+        user_has_approved: typeof value.user_has_approved === "boolean" ? value.user_has_approved : undefined,
+        user_can_approve: typeof value.user_can_approve === "boolean" ? value.user_can_approve : undefined,
+        approved_by: approvedBy,
+        approved_by_usernames: approvedBy
+            .map((user) => user.username)
+            .filter((username) => typeof username === "string"),
+        source_endpoint: "approvals"
+    };
+}
+function extractApprovalRules(value) {
+    return Array.isArray(value) ? value.filter(isRecord) : [];
+}
+function extractApprovalUsers(value) {
+    return Array.isArray(value) ? value.filter(isRecord) : [];
+}
+function extractApprovalEntries(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((item) => isRecord(item) && isRecord(item.user));
+}
+function uniqueApprovalUsers(users) {
+    const seen = new Set();
+    const unique = [];
+    for (const user of users) {
+        const id = user.id;
+        const username = user.username;
+        const key = typeof id === "string" || typeof id === "number"
+            ? `id:${id}`
+            : typeof username === "string"
+                ? `username:${username}`
+                : undefined;
+        if (!key || seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(user);
+    }
+    return unique;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function normalizeApiUrl(rawUrl) {
     const url = new URL(rawUrl);
     const pathname = url.pathname.replace(/\/+$/, "");