opencode-gitlab-plugin 2.5.0 → 2.6.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.6.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v2.5.0...v2.6.0) (2026-05-20)
+
+
+### ✨ Features
+
+* **pagination:** expose pagination info in list MR and issue responses ([1c1722e](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/1c1722e62e0e41f00ab5409057bea1e76ec17a8d))
+
+
+### ♻️ Code Refactoring
+
+* **client:** address review feedback on !23 ([2e94e46](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/2e94e46706807bc8797f10884f71fc56ecf967b9)), closes [23#note_3135645102](https://gitlab.com/vglafirov/23/issues/note_3135645102) [23#note_3135645423](https://gitlab.com/vglafirov/23/issues/note_3135645423) [23#note_3135644923](https://gitlab.com/vglafirov/23/issues/note_3135644923)
+
 ## [2.5.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v2.4.0...v2.5.0) (2026-05-20)
 
 

package/dist/index.js

@@ -26,7 +26,13 @@ var GitLabApiClient = class {
     }
     return projectId;
   }
-  async fetch(method, path2, body) {
+  /**
+   * Core HTTP request used by all REST helpers.
+   *
+   * Returns the raw `Response` after validating the status code so callers can
+   * inspect headers (e.g. for pagination) before parsing the body.
+   */
+  async rawFetch(method, path2, body) {
     const url = `${this.instanceUrl}/api/v4${path2}`;
     const response = await fetch(url, {
       method,
@@ -37,12 +43,53 @@ var GitLabApiClient = class {
       const errorText = await response.text();
       throw new Error(`GitLab API error ${response.status}: ${errorText}`);
     }
+    return response;
+  }
+  async fetch(method, path2, body) {
+    const response = await this.rawFetch(method, path2, body);
     const text = await response.text();
     if (!text) {
       return {};
     }
     return JSON.parse(text);
   }
+  /**
+   * Parse a numeric pagination header, guarding against empty strings.
+   *
+   * GitLab returns `""` (rather than omitting the header) for `X-Next-Page` and
+   * `X-Prev-Page` when there is no next/prev page, and bare `parseInt` without
+   * a radix on an empty string yields `NaN`. Treat empty/missing as `undefined`.
+   */
+  parsePaginationHeader(response, name) {
+    const raw = response.headers.get(name);
+    if (raw == null || raw === "") return void 0;
+    const value = parseInt(raw, 10);
+    return Number.isNaN(value) ? void 0 : value;
+  }
+  /**
+   * Pagination info extracted from GitLab API response headers
+   */
+  extractPaginationInfo(response) {
+    return {
+      total: this.parsePaginationHeader(response, "X-Total"),
+      totalPages: this.parsePaginationHeader(response, "X-Total-Pages"),
+      page: this.parsePaginationHeader(response, "X-Page"),
+      perPage: this.parsePaginationHeader(response, "X-Per-Page"),
+      nextPage: this.parsePaginationHeader(response, "X-Next-Page"),
+      prevPage: this.parsePaginationHeader(response, "X-Prev-Page")
+    };
+  }
+  /**
+   * Fetch with pagination info from response headers.
+   * Use this for list endpoints where knowing if more data exists is important.
+   */
+  async fetchWithPagination(method, path2, body) {
+    const response = await this.rawFetch(method, path2, body);
+    const text = await response.text();
+    const data = text ? JSON.parse(text) : [];
+    const pagination = this.extractPaginationInfo(response);
+    return { data, pagination };
+  }
   async fetchText(method, path2) {
     const url = `${this.instanceUrl}/api/v4${path2}`;
     const response = await fetch(url, {
@@ -306,6 +353,7 @@ var MergeRequestsClient = class extends GitLabApiClient {
   async listMergeRequests(options) {
     const params = new URLSearchParams();
     params.set("per_page", String(options.limit || 20));
+    if (options.page) params.set("page", String(options.page));
     if (options.state) params.set("state", options.state);
     if (options.scope) params.set("scope", options.scope);
     if (options.search) params.set("search", options.search);
@@ -317,7 +365,7 @@ var MergeRequestsClient = class extends GitLabApiClient {
     } else {
       path2 = `/merge_requests?${params}`;
     }
-    return this.fetch("GET", path2);
+    return this.fetchWithPagination("GET", path2);
   }
   async getMrChanges(projectId, mrIid) {
     const encodedProject = this.encodeProjectId(projectId);
@@ -729,6 +777,7 @@ var IssuesClient = class extends GitLabApiClient {
   async listIssues(options) {
     const params = new URLSearchParams();
     params.set("per_page", String(options.limit || 20));
+    if (options.page) params.set("page", String(options.page));
     if (options.state) params.set("state", options.state);
     if (options.scope) params.set("scope", options.scope);
     if (options.search) params.set("search", options.search);
@@ -741,7 +790,7 @@ var IssuesClient = class extends GitLabApiClient {
     } else {
       path2 = `/issues?${params}`;
     }
-    return this.fetch("GET", path2);
+    return this.fetchWithPagination("GET", path2);
   }
   /**
    * List notes on an issue using GraphQL API with pagination support
@@ -2647,26 +2696,31 @@ Returns: title, description, state, author, assignees, reviewers, labels, diff s
   }),
   gitlab_list_merge_requests: tool({
     description: `List merge requests for a project or search globally.
-Can filter by state (opened, closed, merged, all), scope (assigned_to_me, created_by_me), and labels.`,
+Can filter by state (opened, closed, merged, all), scope (assigned_to_me, created_by_me), and labels.
+
+IMPORTANT: Response includes pagination info. If nextPage exists, there are more results.
+Always paginate until you get an empty response or no nextPage to ensure you have all data.`,
     args: {
       project_id: z.string().optional().describe("The project ID or path. If not provided, searches globally."),
       state: z.enum(["opened", "closed", "merged", "all"]).optional().describe("Filter by MR state (default: opened)"),
       scope: z.enum(["assigned_to_me", "created_by_me", "all"]).optional().describe("Filter by scope"),
       search: z.string().optional().describe("Search MRs by title or description"),
       labels: z.string().optional().describe("Comma-separated list of labels to filter by"),
-      limit: z.number().optional().describe("Maximum number of results (default: 20)")
+      limit: z.number().optional().describe("Maximum number of results per page (default: 20)"),
+      page: z.number().optional().describe("Page number for pagination (default: 1)")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const mrs = await client.listMergeRequests({
+      const result = await client.listMergeRequests({
         projectId: args.project_id,
         state: args.state,
         scope: args.scope,
         search: args.search,
         labels: args.labels,
-        limit: args.limit
+        limit: args.limit,
+        page: args.page
       });
-      return JSON.stringify(mrs, null, 2);
+      return JSON.stringify(result, null, 2);
     }
   }),
   gitlab_get_mr_changes: tool({
@@ -2998,7 +3052,10 @@ Returns: title, description, state, author, assignees, labels, milestone, weight
   }),
   gitlab_list_issues: tool2({
     description: `List issues for a project or search globally.
-Can filter by state, labels, assignee, milestone.`,
+Can filter by state, labels, assignee, milestone.
+
+IMPORTANT: Response includes pagination info. If nextPage exists, there are more results.
+Always paginate until you get an empty response or no nextPage to ensure you have all data.`,
     args: {
       project_id: z2.string().optional().describe("The project ID or path. If not provided, searches globally."),
       state: z2.enum(["opened", "closed", "all"]).optional().describe("Filter by issue state (default: opened)"),
@@ -3006,20 +3063,22 @@ Can filter by state, labels, assignee, milestone.`,
       search: z2.string().optional().describe("Search issues by title or description"),
       labels: z2.string().optional().describe("Comma-separated list of labels to filter by"),
       milestone: z2.string().optional().describe("Filter by milestone title"),
-      limit: z2.number().optional().describe("Maximum number of results (default: 20)")
+      limit: z2.number().optional().describe("Maximum number of results per page (default: 20)"),
+      page: z2.number().optional().describe("Page number for pagination (default: 1)")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const issues = await client.listIssues({
+      const result = await client.listIssues({
         projectId: args.project_id,
         state: args.state,
         scope: args.scope,
         search: args.search,
         labels: args.labels,
         milestone: args.milestone,
-        limit: args.limit
+        limit: args.limit,
+        page: args.page
       });
-      return JSON.stringify(issues, null, 2);
+      return JSON.stringify(result, null, 2);
     }
   })
 };