@gala-chain/launchpad-mcp-server 5.0.5-beta.0 → 5.0.5-beta.9

package/dist/tools/overseers/index.js

@@ -29,7 +29,7 @@ const getOverseerUserSummary_js_1 = require("./getOverseerUserSummary.js");
  */
 const OVERSEER_INVITE_ID_SCHEMA = {
     ...common_schemas_js_1.ENTITY_ID_SCHEMA,
-    description: 'Overseer invite ID (positive integer)',
+    description: 'Overseer invite ID (positive integer).',
 };
 /**
  * Overseer invite description schema
@@ -45,7 +45,7 @@ const OVERSEER_INVITE_CODE_SCHEMA = {
     type: 'string',
     minLength: 1,
     maxLength: 100,
-    description: 'The invite code from the magic link URL',
+    description: 'The invite code from the magic link URL.',
 };
 /**
  * Overseer invite status schema
@@ -57,7 +57,7 @@ const OVERSEER_INVITE_STATUS_SCHEMA = {
 - PENDING: Not yet claimed
 - CLAIMED: Claimed by an overseer
 - REVOKED: Revoked by admin/overseer
-- EXPIRED: Past expiration date`,
+- EXPIRED: Past expiration date.`,
 };
 /**
  * Overseer status schema
@@ -67,7 +67,7 @@ const OVERSEER_STATUS_FILTER_SCHEMA = {
     enum: Object.values(launchpad_sdk_1.OVERSEER_STATUS),
     description: `Filter overseers by status:
 - ACTIVE: Currently active overseer
-- REVOKED: Access has been revoked`,
+- REVOKED: Access has been revoked.`,
 };
 // =============================================================================
 // Overseer Invite Tools
@@ -87,7 +87,7 @@ The recipient claims the invite after logging in.
 
 RETURNS: { invite: { id, inviteCode, inviteUrl, invitedBy, claimedBy, description, status, expiresAt, createdAt } }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -108,25 +108,26 @@ Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overs
  */
 exports.listOverseerInvitesTool = {
     name: 'gala_launchpad_list_overseer_invites',
-    description: `List all overseer invites with pagination and filtering.
+    description: `List all overseer invites with cursor-based pagination and filtering.
 
 Returns a paginated list of overseer invites that can be filtered by status.
 
-RETURNS: { invites: [...], meta: { totalItems, currentPage, pageSize, totalPages } }
+RETURNS: { invites: [...], pageInfo: { hasNextPage, endCursor, hasPreviousPage, startCursor } }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             status: OVERSEER_INVITE_STATUS_SCHEMA,
-            page: common_schemas_js_1.OFFSET_SCHEMA,
-            limit: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
+            cursor: common_schemas_js_1.CURSOR_SCHEMA,
+            pageSize: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
         },
         required: [],
     },
     handler: (0, handler_factories_js_1.createSimpleHandler)('listOverseerInvites', (args) => ({
         status: (0, handler_factories_js_1.extractStatusArg)(args),
-        ...(0, handler_factories_js_1.extractPaginationArgs)(args),
+        cursor: args.cursor,
+        pageSize: args.pageSize,
     })),
 };
 /**
@@ -146,7 +147,7 @@ by the frontend to display invite details before the user logs in to claim.
 
 RETURNS: { description, status, expiresAt, invitedBy: { address, fullName } }
 
-Authentication: None required (public endpoint)`,
+Authentication: None required (public endpoint).`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -172,7 +173,7 @@ user's wallet becomes an overseer with GLOBAL access to ALL tokens on the platfo
 
 RETURNS: { invite: { id, inviteCode, inviteUrl, invitedBy, claimedBy, description, status, expiresAt, claimedAt, createdAt } }
 
-Authentication: Requires JWT auth`,
+Authentication: Requires JWT auth.`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -194,7 +195,7 @@ the overseer loses access to the platform.
 
 RETURNS: { success: true, message: "Invite revoked" }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -214,25 +215,26 @@ Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overs
  */
 exports.listOverseersTool = {
     name: 'gala_launchpad_list_overseers',
-    description: `List all overseers with pagination and filtering.
+    description: `List all overseers with cursor-based pagination and filtering.
 
 Returns a paginated list of overseers that can be filtered by status.
 
-RETURNS: { overseers: [...], meta: { totalItems, currentPage, pageSize, totalPages } }
+RETURNS: { overseers: [...], pageInfo: { hasNextPage, endCursor, hasPreviousPage, startCursor } }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             status: OVERSEER_STATUS_FILTER_SCHEMA,
-            page: common_schemas_js_1.OFFSET_SCHEMA,
-            limit: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
+            cursor: common_schemas_js_1.CURSOR_SCHEMA,
+            pageSize: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
         },
         required: [],
     },
     handler: (0, handler_factories_js_1.createSimpleHandler)('listOverseers', (args) => ({
         status: (0, handler_factories_js_1.extractStatusArg)(args),
-        ...(0, handler_factories_js_1.extractPaginationArgs)(args),
+        cursor: args.cursor,
+        pageSize: args.pageSize,
     })),
 };
 /**
@@ -246,13 +248,13 @@ Revokes an overseer by wallet address, removing their global platform access.
 
 RETURNS: { success: true, message: "Overseer access revoked" }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             address: {
                 ...common_schemas_js_1.ADDRESS_SCHEMA,
-                description: 'Wallet address of the overseer to revoke (eth|... or 0x... format)',
+                description: 'Wallet address of the overseer to revoke (eth|... or 0x... format).',
             },
         },
         required: ['address'],
@@ -271,7 +273,7 @@ and their details if so.
 
 RETURNS: { isOverseer: boolean, overseer?: { id, userAddress, inviteId, status, createdAt } }
 
-Authentication: Requires JWT auth`,
+Authentication: Requires JWT auth.`,
     inputSchema: {
         type: 'object',
         properties: {},
@@ -298,7 +300,7 @@ Use this for dashboard header stats. For detailed data, use:
 
 RETURNS: { activeStreams, totalViewers, pendingFlags, totalPools }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {},

package/dist/tools/overseers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/overseers/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/overseers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAGH,kEAKiC;AACjC,uEAOyC;AACzC,6DAAoF;AACpF,iEAA+D;AAC/D,2EAAyE;AAEzE,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,yBAAyB,GAAG;IAChC,GAAG,oCAAgB;IACnB,WAAW,EAAE,wCAAwC;CACtD,CAAC;AAEF;;GAEG;AACH,MAAM,2BAA2B,GAAG;IAClC,GAAG,6CAAyB;IAC5B,WAAW,EAAE,+FAA+F;CAC7G,CAAC;AAEF;;GAEG;AACH,MAAM,2BAA2B,GAAG;IAClC,IAAI,EAAE,QAAiB;IACvB,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,0CAA0C;CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,6BAA6B,GAAG;IACpC,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,sCAAsB,CAAC;IAC3C,WAAW,EAAE;;;;iCAIkB;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,6BAA6B,GAAG;IACpC,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,+BAAe,CAAC;IACpC,WAAW,EAAE;;oCAEqB;CACnC,CAAC;AAEF,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;GAEG;AACU,QAAA,wBAAwB,GAAY;IAC/C,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EAAE;;;;;;;;;;qFAUsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE,2BAA2B;YACxC,SAAS,EAAE,qCAAiB;SAC7B;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,sBAAsB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9D,WAAW,EAAE,IAAI,CAAC,WAAiC;QACnD,SAAS,EAAE,IAAI,CAAC,SAA+B;KAChD,CAAC,CAAC;CACJ,CAAC;AAEF;;;;GAIG;AACU,QAAA,uBAAuB,GAAY;IAC9C,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE;;;;;;qFAMsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,6BAA6B;YACrC,MAAM,EAAE,iCAAa;YACrB,QAAQ,EAAE,sCAAkB;SAC7B;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,EAAE,IAAA,uCAAgB,EAAgD,IAAI,CAAC;QAC7E,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,QAAQ,EAAE,IAAI,CAAC,QAA8B;KAC9C,CAAC,CAAC;CACJ,CAAC;AAEF;;GAEG;AACU,QAAA,2BAA2B,GAAY;IAClD,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;iDAYkC;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,2BAA2B;SACxC;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,OAAO,EAAE,IAAA,+CAAwB,EAAC,yBAAyB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAoB,CAAC;CAClG,CAAC;AAEF;;GAEG;AACU,QAAA,uBAAuB,GAAY;IAC9C,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE;;;;;;;;;;;mCAWoB;IACjC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,2BAA2B;SACxC;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,OAAO,EAAE,IAAA,+CAAwB,EAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAoB,CAAC;CAC9F,CAAC;AAEF;;GAEG;AACU,QAAA,wBAAwB,GAAY;IAC/C,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EAAE;;;;;;;qFAOsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,yBAAyB;SACpC;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,OAAO,EAAE,IAAA,2CAAoB,EAC3B,sBAAsB,EACtB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAkB,EACjC,gBAAgB,CACjB;CACF,CAAC;AAEF,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;;;GAIG;AACU,QAAA,iBAAiB,GAAY;IACxC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE;;;;;;qFAMsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,6BAA6B;YACrC,MAAM,EAAE,iCAAa;YACrB,QAAQ,EAAE,sCAAkB;SAC7B;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,IAAA,uCAAgB,EAAuB,IAAI,CAAC;QACpD,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,QAAQ,EAAE,IAAI,CAAC,QAA8B;KAC9C,CAAC,CAAC;CACJ,CAAC;AAEF;;GAEG;AACU,QAAA,kBAAkB,GAAY;IACzC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;qFAMsE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,GAAG,kCAAc;gBACjB,WAAW,EAAE,qEAAqE;aACnF;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,EAAE,IAAA,2CAAoB,EAC3B,gBAAgB,EAChB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAiB,EAChC,yBAAyB,CAC1B;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,uBAAuB,GAAY;IAC9C,IAAI,EAAE,uCAAuC;IAC7C,WAAW,EAAE;;;;;;;mCAOoB;IACjC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,+CAAwB,EAAC,qBAAqB,CAAC;CACzD,CAAC;AAEF;;GAEG;AACU,QAAA,sBAAsB,GAAY;IAC7C,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE;;;;;;;;;;;;;;4EAc6D;IAC1E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,+CAAwB,EAAC,oBAAoB,CAAC;CACxD,CAAC;AAEF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEnE,QAAA,aAAa,GAAc;IACtC,gCAAwB;IACxB,+BAAuB;IACvB,mCAA2B;IAC3B,+BAAuB;IACvB,gCAAwB;IACxB,yBAAiB;IACjB,0BAAkB;IAClB,+BAAuB;IACvB,8BAAsB;IACtB,4CAAqB;IACrB,sDAA0B;CAC3B,CAAC"}

package/dist/tools/overseers/listOverseerUsers.d.ts

@@ -2,6 +2,7 @@
  * List Overseer Users Tool
  *
  * MCP tool for listing users with pagination and sorting.
+ * Uses cursor-based pagination for efficient result navigation.
  *
  * @since 6.x.0
  */

package/dist/tools/overseers/listOverseerUsers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listOverseerUsers.d.ts","sourceRoot":"","sources":["../../../src/tools/overseers/listOverseerUsers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsBlD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAyCnC,CAAC"}
+{"version":3,"file":"listOverseerUsers.d.ts","sourceRoot":"","sources":["../../../src/tools/overseers/listOverseerUsers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsBlD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,OA6CnC,CAAC"}

package/dist/tools/overseers/listOverseerUsers.js

@@ -3,6 +3,7 @@
  * List Overseer Users Tool
  *
  * MCP tool for listing users with pagination and sorting.
+ * Uses cursor-based pagination for efficient result navigation.
  *
  * @since 6.x.0
  */
@@ -16,7 +17,7 @@ const common_schemas_js_1 = require("../../schemas/common-schemas.js");
 const USER_SORT_BY_SCHEMA = {
     type: 'string',
     enum: ['address', 'flagsReceived', 'activeBans', 'createdAt'],
-    description: 'Field to sort by (default: createdAt)',
+    description: 'Field to sort by (default: createdAt).',
 };
 /**
  * Sort order schema
@@ -24,7 +25,7 @@ const USER_SORT_BY_SCHEMA = {
 const SORT_ORDER_SCHEMA = {
     type: 'string',
     enum: ['asc', 'desc'],
-    description: 'Sort order (default: desc)',
+    description: 'Sort order (default: desc).',
 };
 /**
  * List Overseer Users Tool
@@ -44,24 +45,28 @@ Useful for overseer/admin dashboard user management.
 - activeBans: Active bans count
 - createdAt: Account creation date (default)
 
-RETURNS: { items: [...], total: number, offset, limit, hasNext }
+RETURNS: { items: [...], total: number, cursor?, pageSize }
 
-Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer`,
+Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overseer.`,
     inputSchema: {
         type: 'object',
         properties: {
             search: {
                 ...common_schemas_js_1.SEARCH_SCHEMA,
-                description: 'Search by user address or name',
+                description: 'Search by user address or name.',
             },
             sortBy: USER_SORT_BY_SCHEMA,
             sortOrder: SORT_ORDER_SCHEMA,
-            offset: {
+            cursor: {
+                type: 'string',
+                description: 'Cursor from previous response for pagination (omit for first page).',
+            },
+            pageSize: {
                 type: 'integer',
-                minimum: 0,
-                description: 'Offset for pagination (default: 0)',
+                minimum: 1,
+                maximum: 100,
+                description: 'Results per page (max: 100, default: 20).',
             },
-            limit: common_schemas_js_1.ADMIN_LIMIT_SCHEMA,
         },
         required: [],
     },
@@ -69,8 +74,8 @@ Authentication: Requires streamAdminApiKey (admin) OR JWT auth as existing Overs
         search: args.search,
         sortBy: args.sortBy,
         sortOrder: args.sortOrder,
-        offset: args.offset,
-        limit: args.limit,
+        cursor: args.cursor,
+        pageSize: args.pageSize ?? 20,
     })),
 };
 //# sourceMappingURL=listOverseerUsers.js.map

package/dist/tools/overseers/listOverseerUsers.js.map

@@ -1 +1 @@
-{"version":3,"file":"listOverseerUsers.js","sourceRoot":"","sources":["../../../src/tools/overseers/listOverseerUsers.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,kEAA8D;AAC9D,uEAAoF;AAEpF;;GAEG;AACH,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,CAAC;IAC7D,WAAW,EAAE,uCAAuC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,4BAA4B;CAC1C,CAAC;AAEF;;;;GAIG;AACU,QAAA,qBAAqB,GAAY;IAC5C,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;;oFAaqE;IAClF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,GAAG,iCAAa;gBAChB,WAAW,EAAE,gCAAgC;aAC9C;YACD,MAAM,EAAE,mBAAmB;YAC3B,SAAS,EAAE,iBAAiB;YAC5B,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,oCAAoC;aAClD;YACD,KAAK,EAAE,sCAAkB;SAC1B;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,MAAM,EAAE,IAAI,CAAC,MAA8E;QAC3F,SAAS,EAAE,IAAI,CAAC,SAAuC;QACvD,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,KAAK,EAAE,IAAI,CAAC,KAA2B;KACxC,CAAC,CAAC;CACJ,CAAC"}
+{"version":3,"file":"listOverseerUsers.js","sourceRoot":"","sources":["../../../src/tools/overseers/listOverseerUsers.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAGH,kEAA8D;AAC9D,uEAAgE;AAEhE;;GAEG;AACH,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,CAAC;IAC7D,WAAW,EAAE,wCAAwC;CACtD,CAAC;AAEF;;GAEG;AACH,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,QAAiB;IACvB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,6BAA6B;CAC3C,CAAC;AAEF;;;;GAIG;AACU,QAAA,qBAAqB,GAAY;IAC5C,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE;;;;;;;;;;;;;qFAasE;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,GAAG,iCAAa;gBAChB,WAAW,EAAE,iCAAiC;aAC/C;YACD,MAAM,EAAE,mBAAmB;YAC3B,SAAS,EAAE,iBAAiB;YAC5B,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qEAAqE;aACnF;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,2CAA2C;aACzD;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,MAAM,EAAE,IAAI,CAAC,MAA8E;QAC3F,SAAS,EAAE,IAAI,CAAC,SAAuC;QACvD,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,QAAQ,EAAG,IAAI,CAAC,QAAmB,IAAI,EAAE;KAC1C,CAAC,CAAC;CACJ,CAAC"}

package/dist/tools/pagination-handler-factory.d.ts

@@ -4,80 +4,82 @@
  * Factory for creating handlers that fetch paginated results with filter support.
  * Reduces boilerplate for tools like fetchDexPools, fetchPools, fetchPriceHistory.
  *
- * @see Phase 4A: DRY remediation for trading and discovery tools
+ * Supports cursor-based pagination for scalable, efficient result navigation.
+ *
+ * @see Phase 4B: Cursor-based pagination handlers
  */
 import type { MCPToolResponse } from '../types/mcp.js';
 import type { LaunchpadSDK } from '@gala-chain/launchpad-sdk';
 /**
- * Configuration for paginated fetch handlers
+ * Configuration for cursor-paginated fetch handlers
  */
-export interface PaginatedFetchConfig {
+export interface CursorPaginatedFetchConfig {
     /** Name of the SDK method to call */
     sdkMethodName: string;
     /** Function to extract/build filter options from args */
     filterBuilder: (args: Record<string, unknown>) => Record<string, unknown>;
-    /** Default limit for pagination (if different from DEFAULT_PAGINATION.limit) */
-    defaultLimit?: number;
-    /** Whether pagination args (offset/limit) should be included in filter options */
+    /** Default page size for pagination (if different from 20) */
+    defaultPageSize?: number;
+    /** Whether pagination args (cursor/pageSize) should be included in filter options */
     includePaginationInFilters?: boolean;
 }
 /**
- * Creates a handler for paginated fetch operations with filter support
+ * Creates a handler for cursor-paginated fetch operations with filter support
  *
  * Handles the common pattern of:
  * 1. Building filter options from args using filterBuilder
- * 2. Applying pagination defaults
+ * 2. Applying pagination defaults (cursor/pageSize)
  * 3. Calling SDK method with combined options
- * 4. Returning formatted success response
+ * 4. Returning formatted success response with pageInfo
  *
- * @param config - Configuration for the paginated fetch handler
+ * @param config - Configuration for the cursor-paginated fetch handler
  * @returns Handler function ready to be assigned to an MCPTool
  *
  * @example
  * ```typescript
  * // Create a fetchDexPools handler with custom filter builder
- * const handler = createPaginatedFetchHandler({
+ * const handler = createCursorPaginatedHandler({
  *   sdkMethodName: 'fetchDexPools',
  *   filterBuilder: (args) => ({
  *     search: args.search,
  *     sortBy: args.sortBy || 'tvl',
  *     sortOrder: args.sortOrder || 'desc',
  *   }),
- *   defaultLimit: 10,
+ *   defaultPageSize: 10,
  * });
  *
  * // Usage in tool
  * const tool: MCPTool = {
  *   name: 'gala_launchpad_fetch_dex_pools',
- *   description: 'Fetch DEX pools',
+ *   description: 'Fetch DEX pools.',
  *   inputSchema: { ... },
  *   handler
  * };
  * ```
  */
-export declare function createPaginatedFetchHandler(config: PaginatedFetchConfig): (sdk: LaunchpadSDK, args: Record<string, unknown>) => Promise<MCPToolResponse>;
+export declare function createCursorPaginatedHandler(config: CursorPaginatedFetchConfig): (sdk: LaunchpadSDK, args: Record<string, unknown>) => Promise<MCPToolResponse>;
 /**
- * Creates a handler for paginated fetch operations with explicit pagination parameters
+ * Creates a handler for cursor-paginated fetch operations with explicit pagination parameters
  *
- * Variant that always includes page and limit in the SDK method call,
+ * Variant that always includes cursor and pageSize in the SDK method call,
  * regardless of the filterBuilder output.
  *
- * @param config - Configuration for the paginated fetch handler
+ * @param config - Configuration for the cursor-paginated fetch handler
  * @returns Handler function ready to be assigned to an MCPTool
  *
  * @example
  * ```typescript
- * const handler = createPaginatedFetchWithPaginationHandler({
+ * const handler = createCursorPaginatedHandlerWithPagination({
  *   sdkMethodName: 'fetchDexPools',
  *   filterBuilder: (args) => ({
  *     search: args.search,
  *     sortBy: args.sortBy || 'tvl',
  *   }),
- *   defaultLimit: 10,
+ *   defaultPageSize: 10,
  * });
  * ```
  */
-export declare function createPaginatedFetchWithPaginationHandler(config: Omit<PaginatedFetchConfig, 'includePaginationInFilters'>): (sdk: LaunchpadSDK, args: Record<string, unknown>) => Promise<MCPToolResponse>;
+export declare function createCursorPaginatedHandlerWithPagination(config: Omit<CursorPaginatedFetchConfig, 'includePaginationInFilters'>): (sdk: LaunchpadSDK, args: Record<string, unknown>) => Promise<MCPToolResponse>;
 /**
  * Configuration for user portfolio/holdings query handlers
  *
@@ -85,13 +87,13 @@ export declare function createPaginatedFetchWithPaginationHandler(config: Omit<P
  * - Required address parameter
  * - Optional tokenName exact filter
  * - Optional search fuzzy filter
- * - Standard pagination (page/limit)
+ * - Cursor-based pagination (cursor/pageSize)
  */
 export interface UserPortfolioQueryConfig {
     /** Name of the SDK method to call (e.g., 'fetchTokensHeld', 'fetchTokensCreated') */
     sdkMethodName: string;
-    /** Default limit for pagination (defaults to 20 for user operations) */
-    defaultLimit?: number;
+    /** Default page size for pagination (defaults to 20 for user operations) */
+    defaultPageSize?: number;
 }
 /**
  * Creates a handler for user portfolio/holdings query operations
@@ -99,7 +101,7 @@ export interface UserPortfolioQueryConfig {
  * Handles the common pattern of:
  * 1. Requiring an address parameter
  * 2. Accepting optional tokenName (exact match) and search (fuzzy match) filters
- * 3. Applying user-type pagination defaults
+ * 3. Applying user-type pagination defaults (cursor/pageSize)
  * 4. Building the SDK options object with proper typing
  *
  * @param config - Configuration for the user portfolio query handler
@@ -110,13 +112,13 @@ export interface UserPortfolioQueryConfig {
  * // Create a fetchTokensHeld handler
  * const handler = createUserPortfolioQueryHandler({
  *   sdkMethodName: 'fetchTokensHeld',
- *   defaultLimit: 20,
+ *   defaultPageSize: 20,
  * });
  *
  * // Create a fetchTokensCreated handler
  * const handler = createUserPortfolioQueryHandler({
  *   sdkMethodName: 'fetchTokensCreated',
- *   defaultLimit: 20,
+ *   defaultPageSize: 20,
  * });
  * ```
  *
@@ -124,8 +126,8 @@ export interface UserPortfolioQueryConfig {
  * - address: string (required) - Wallet address in eth|... or 0x... format
  * - tokenName?: string - Exact match filter
  * - search?: string - Fuzzy match filter
- * - offset?: number - Offset for pagination (default: 0)
- * - limit?: number - Results per page (default: defaultLimit or 20)
+ * - cursor?: string - Cursor from previous response (omit for first page)
+ * - pageSize?: number - Results per page (default: defaultPageSize or 20)
  */
 export declare function createUserPortfolioQueryHandler(config: UserPortfolioQueryConfig): (sdk: LaunchpadSDK, args: Record<string, unknown>) => Promise<MCPToolResponse>;
 //# sourceMappingURL=pagination-handler-factory.d.ts.map

package/dist/tools/pagination-handler-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination-handler-factory.d.ts","sourceRoot":"","sources":["../../src/tools/pagination-handler-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1E,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,kFAAkF;IAClF,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,GAC3B,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAiChF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,4BAA4B,CAAC,GAC/D,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAKhF;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IAEtB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,wBAAwB,GAC/B,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CA0BhF"}
+{"version":3,"file":"pagination-handler-factory.d.ts","sourceRoot":"","sources":["../../src/tools/pagination-handler-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1E,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,qFAAqF;IACrF,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,0BAA0B,GACjC,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAmChF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0CAA0C,CACxD,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE,4BAA4B,CAAC,GACrE,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAKhF;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IAEtB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,wBAAwB,GAC/B,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CA8BhF"}

package/dist/tools/pagination-handler-factory.js

@@ -5,63 +5,66 @@
  * Factory for creating handlers that fetch paginated results with filter support.
  * Reduces boilerplate for tools like fetchDexPools, fetchPools, fetchPriceHistory.
  *
- * @see Phase 4A: DRY remediation for trading and discovery tools
+ * Supports cursor-based pagination for scalable, efficient result navigation.
+ *
+ * @see Phase 4B: Cursor-based pagination handlers
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createPaginatedFetchHandler = createPaginatedFetchHandler;
-exports.createPaginatedFetchWithPaginationHandler = createPaginatedFetchWithPaginationHandler;
+exports.createCursorPaginatedHandler = createCursorPaginatedHandler;
+exports.createCursorPaginatedHandlerWithPagination = createCursorPaginatedHandlerWithPagination;
 exports.createUserPortfolioQueryHandler = createUserPortfolioQueryHandler;
 const response_formatter_js_1 = require("../utils/response-formatter.js");
 const error_handler_js_1 = require("../utils/error-handler.js");
-const default_values_js_1 = require("../utils/default-values.js");
 const handler_factories_js_1 = require("./handler-factories.js");
 /**
- * Creates a handler for paginated fetch operations with filter support
+ * Creates a handler for cursor-paginated fetch operations with filter support
  *
  * Handles the common pattern of:
  * 1. Building filter options from args using filterBuilder
- * 2. Applying pagination defaults
+ * 2. Applying pagination defaults (cursor/pageSize)
  * 3. Calling SDK method with combined options
- * 4. Returning formatted success response
+ * 4. Returning formatted success response with pageInfo
  *
- * @param config - Configuration for the paginated fetch handler
+ * @param config - Configuration for the cursor-paginated fetch handler
  * @returns Handler function ready to be assigned to an MCPTool
  *
  * @example
  * ```typescript
  * // Create a fetchDexPools handler with custom filter builder
- * const handler = createPaginatedFetchHandler({
+ * const handler = createCursorPaginatedHandler({
  *   sdkMethodName: 'fetchDexPools',
  *   filterBuilder: (args) => ({
  *     search: args.search,
  *     sortBy: args.sortBy || 'tvl',
  *     sortOrder: args.sortOrder || 'desc',
  *   }),
- *   defaultLimit: 10,
+ *   defaultPageSize: 10,
  * });
  *
  * // Usage in tool
  * const tool: MCPTool = {
  *   name: 'gala_launchpad_fetch_dex_pools',
- *   description: 'Fetch DEX pools',
+ *   description: 'Fetch DEX pools.',
  *   inputSchema: { ... },
  *   handler
  * };
  * ```
  */
-function createPaginatedFetchHandler(config) {
-    const { sdkMethodName, filterBuilder, defaultLimit = default_values_js_1.DEFAULT_PAGINATION.limit, includePaginationInFilters = false, } = config;
+function createCursorPaginatedHandler(config) {
+    const { sdkMethodName, filterBuilder, defaultPageSize = 20, includePaginationInFilters = false, } = config;
     return (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
         // Build filter options using the provided builder function
         const filterOptions = filterBuilder(args);
-        // Apply pagination defaults
-        const offset = args.offset ?? default_values_js_1.DEFAULT_PAGINATION.offset;
-        const limit = args.limit ?? defaultLimit;
+        // Apply pagination defaults (cursor-based)
+        const cursor = args.cursor ?? undefined;
+        const pageSize = args.pageSize ?? defaultPageSize;
         // Build final options object
         const options = { ...filterOptions };
         if (includePaginationInFilters) {
-            options.offset = offset;
-            options.limit = limit;
+            if (cursor !== undefined) {
+                options.cursor = cursor;
+            }
+            options.pageSize = pageSize;
         }
         // Call SDK method using shared invocation helper
         const { result } = await (0, handler_factories_js_1.invokeSdkMethod)({
@@ -73,28 +76,28 @@ function createPaginatedFetchHandler(config) {
     });
 }
 /**
- * Creates a handler for paginated fetch operations with explicit pagination parameters
+ * Creates a handler for cursor-paginated fetch operations with explicit pagination parameters
  *
- * Variant that always includes page and limit in the SDK method call,
+ * Variant that always includes cursor and pageSize in the SDK method call,
  * regardless of the filterBuilder output.
  *
- * @param config - Configuration for the paginated fetch handler
+ * @param config - Configuration for the cursor-paginated fetch handler
  * @returns Handler function ready to be assigned to an MCPTool
  *
  * @example
  * ```typescript
- * const handler = createPaginatedFetchWithPaginationHandler({
+ * const handler = createCursorPaginatedHandlerWithPagination({
  *   sdkMethodName: 'fetchDexPools',
  *   filterBuilder: (args) => ({
  *     search: args.search,
  *     sortBy: args.sortBy || 'tvl',
  *   }),
- *   defaultLimit: 10,
+ *   defaultPageSize: 10,
  * });
  * ```
  */
-function createPaginatedFetchWithPaginationHandler(config) {
-    return createPaginatedFetchHandler({
+function createCursorPaginatedHandlerWithPagination(config) {
+    return createCursorPaginatedHandler({
         ...config,
         includePaginationInFilters: true,
     });
@@ -105,7 +108,7 @@ function createPaginatedFetchWithPaginationHandler(config) {
  * Handles the common pattern of:
  * 1. Requiring an address parameter
  * 2. Accepting optional tokenName (exact match) and search (fuzzy match) filters
- * 3. Applying user-type pagination defaults
+ * 3. Applying user-type pagination defaults (cursor/pageSize)
  * 4. Building the SDK options object with proper typing
  *
  * @param config - Configuration for the user portfolio query handler
@@ -116,13 +119,13 @@ function createPaginatedFetchWithPaginationHandler(config) {
  * // Create a fetchTokensHeld handler
  * const handler = createUserPortfolioQueryHandler({
  *   sdkMethodName: 'fetchTokensHeld',
- *   defaultLimit: 20,
+ *   defaultPageSize: 20,
  * });
  *
  * // Create a fetchTokensCreated handler
  * const handler = createUserPortfolioQueryHandler({
  *   sdkMethodName: 'fetchTokensCreated',
- *   defaultLimit: 20,
+ *   defaultPageSize: 20,
  * });
  * ```
  *
@@ -130,23 +133,26 @@ function createPaginatedFetchWithPaginationHandler(config) {
  * - address: string (required) - Wallet address in eth|... or 0x... format
  * - tokenName?: string - Exact match filter
  * - search?: string - Fuzzy match filter
- * - offset?: number - Offset for pagination (default: 0)
- * - limit?: number - Results per page (default: defaultLimit or 20)
+ * - cursor?: string - Cursor from previous response (omit for first page)
+ * - pageSize?: number - Results per page (default: defaultPageSize or 20)
  */
 function createUserPortfolioQueryHandler(config) {
-    const { sdkMethodName, defaultLimit = default_values_js_1.DEFAULT_PAGINATION.limit } = config;
+    const { sdkMethodName, defaultPageSize = 20 } = config;
     return (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        // Apply pagination defaults
-        const offset = args.offset ?? default_values_js_1.DEFAULT_PAGINATION.offset;
-        const limit = args.limit ?? defaultLimit;
+        // Apply pagination defaults (cursor-based)
+        const cursor = args.cursor ?? undefined;
+        const pageSize = args.pageSize ?? defaultPageSize;
         // Build options object with all parameters
         const options = {
             address: args.address,
             tokenName: args.tokenName,
             search: args.search,
-            offset,
-            limit,
         };
+        // Add cursor if provided
+        if (cursor !== undefined) {
+            options.cursor = cursor;
+        }
+        options.pageSize = pageSize;
         // Call SDK method using shared invocation helper
         const { result } = await (0, handler_factories_js_1.invokeSdkMethod)({
             sdk,

package/dist/tools/pagination-handler-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination-handler-factory.js","sourceRoot":"","sources":["../../src/tools/pagination-handler-factory.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA4DH,kEAmCC;AAuBD,8FAOC;AAyDD,0EA4BC;AA9MD,0EAA+D;AAC/D,gEAA8D;AAC9D,kEAAgE;AAChE,iEAAyD;AAmBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAgB,2BAA2B,CACzC,MAA4B;IAE5B,MAAM,EACJ,aAAa,EACb,aAAa,EACb,YAAY,GAAG,sCAAkB,CAAC,KAAK,EACvC,0BAA0B,GAAG,KAAK,GACnC,GAAG,MAAM,CAAC;IAEX,OAAO,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3C,2DAA2D;QAC3D,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAE1C,4BAA4B;QAC5B,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,sCAAkB,CAAC,MAAM,CAAC;QACpE,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,YAAY,CAAC;QAErD,6BAA6B;QAC7B,MAAM,OAAO,GAA4B,EAAE,GAAG,aAAa,EAAE,CAAC;QAE9D,IAAI,0BAA0B,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;YACxB,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,iDAAiD;QACjD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,sCAAe,EAAC;YACvC,GAAG;YACH,UAAU,EAAE,aAAa;YACzB,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,yCAAyC,CACvD,MAAgE;IAEhE,OAAO,2BAA2B,CAAC;QACjC,GAAG,MAAM;QACT,0BAA0B,EAAE,IAAI;KACjC,CAAC,CAAC;AACL,CAAC;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAgB,+BAA+B,CAC7C,MAAgC;IAEhC,MAAM,EAAE,aAAa,EAAE,YAAY,GAAG,sCAAkB,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC;IAE1E,OAAO,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3C,4BAA4B;QAC5B,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,sCAAkB,CAAC,MAAM,CAAC;QACpE,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,YAAY,CAAC;QAErD,2CAA2C;QAC3C,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,IAAI,CAAC,OAA0B;YACxC,SAAS,EAAE,IAAI,CAAC,SAA+B;YAC/C,MAAM,EAAE,IAAI,CAAC,MAA4B;YACzC,MAAM;YACN,KAAK;SACN,CAAC;QAEF,iDAAiD;QACjD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,sCAAe,EAAC;YACvC,GAAG;YACH,UAAU,EAAE,aAAa;YACzB,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"pagination-handler-factory.js","sourceRoot":"","sources":["../../src/tools/pagination-handler-factory.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AA2DH,oEAqCC;AAuBD,gGAOC;AAyDD,0EAgCC;AAnND,0EAA+D;AAC/D,gEAA8D;AAC9D,iEAAyD;AAmBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAgB,4BAA4B,CAC1C,MAAkC;IAElC,MAAM,EACJ,aAAa,EACb,aAAa,EACb,eAAe,GAAG,EAAE,EACpB,0BAA0B,GAAG,KAAK,GACnC,GAAG,MAAM,CAAC;IAEX,OAAO,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3C,2DAA2D;QAC3D,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAE1C,2CAA2C;QAC3C,MAAM,MAAM,GAAI,IAAI,CAAC,MAA6B,IAAI,SAAS,CAAC;QAChE,MAAM,QAAQ,GAAI,IAAI,CAAC,QAAmB,IAAI,eAAe,CAAC;QAE9D,6BAA6B;QAC7B,MAAM,OAAO,GAA4B,EAAE,GAAG,aAAa,EAAE,CAAC;QAE9D,IAAI,0BAA0B,EAAE,CAAC;YAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;YAC1B,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC9B,CAAC;QAED,iDAAiD;QACjD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,sCAAe,EAAC;YACvC,GAAG;YACH,UAAU,EAAE,aAAa;YACzB,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,0CAA0C,CACxD,MAAsE;IAEtE,OAAO,4BAA4B,CAAC;QAClC,GAAG,MAAM;QACT,0BAA0B,EAAE,IAAI;KACjC,CAAC,CAAC;AACL,CAAC;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAgB,+BAA+B,CAC7C,MAAgC;IAEhC,MAAM,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAEvD,OAAO,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3C,2CAA2C;QAC3C,MAAM,MAAM,GAAI,IAAI,CAAC,MAA6B,IAAI,SAAS,CAAC;QAChE,MAAM,QAAQ,GAAI,IAAI,CAAC,QAAmB,IAAI,eAAe,CAAC;QAE9D,2CAA2C;QAC3C,MAAM,OAAO,GAA4B;YACvC,OAAO,EAAE,IAAI,CAAC,OAA0B;YACxC,SAAS,EAAE,IAAI,CAAC,SAA+B;YAC/C,MAAM,EAAE,IAAI,CAAC,MAA4B;SAC1C,CAAC;QAEF,yBAAyB;QACzB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAC1B,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAE5B,iDAAiD;QACjD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,sCAAe,EAAC;YACvC,GAAG;YACH,UAAU,EAAE,aAAa;YACzB,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}