refactor: extract common paginate type (#415)

Author: Lightning00Blade

src/McpResponse.ts

@@ -21,7 +21,8 @@ import type {
 } from './third_party/modelcontextprotocol-sdk/index.js';
 import {handleDialog} from './tools/pages.js';
 import type {ImageContentData, Response} from './tools/ToolDefinition.js';
-import {paginate, type PaginationOptions} from './utils/pagination.js';
+import {paginate} from './utils/pagination.js';
+import type {PaginationOptions} from './utils/types.js';
 
 interface NetworkRequestData {
   networkRequestStableId: number;
@@ -65,9 +66,7 @@ export class McpResponse implements Response {
 
   setIncludeNetworkRequests(
     value: boolean,
-    options?: {
-      pageSize?: number;
-      pageIdx?: number;
+    options?: PaginationOptions & {
       resourceTypes?: ResourceType[];
     },
   ): void {
@@ -91,9 +90,7 @@ export class McpResponse implements Response {
 
   setIncludeConsoleData(
     value: boolean,
-    options?: {
-      pageSize?: number;
-      pageIdx?: number;
+    options?: PaginationOptions & {
       types?: string[];
     },
   ): void {

src/tools/ToolDefinition.ts

@@ -9,6 +9,7 @@ import z from 'zod';
 
 import type {TextSnapshotNode} from '../McpContext.js';
 import type {TraceResult} from '../trace-processing/parse.js';
+import type {PaginationOptions} from '../utils/types.js';
 
 import type {ToolCategories} from './categories.js';
 
@@ -45,11 +46,15 @@ export interface Response {
   setIncludePages(value: boolean): void;
   setIncludeNetworkRequests(
     value: boolean,
-    options?: {pageSize?: number; pageIdx?: number; resourceTypes?: string[]},
+    options?: PaginationOptions & {
+      resourceTypes?: string[];
+    },
   ): void;
   setIncludeConsoleData(
     value: boolean,
-    options?: {pageSize?: number; pageIdx?: number; types?: string[]},
+    options?: PaginationOptions & {
+      types?: string[];
+    },
   ): void;
   setIncludeSnapshot(value: boolean): void;
   setIncludeSnapshot(value: boolean, verbose?: boolean): void;

src/utils/pagination.ts

@@ -4,10 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-export interface PaginationOptions {
-  pageSize?: number;
-  pageIdx?: number;
-}
+import type {PaginationOptions} from './types.js';
 
 export interface PaginationResult<Item> {
   items: readonly Item[];

src/utils/types.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export interface PaginationOptions {
+  pageSize?: number;
+  pageIdx?: number;
+}