docs(selectors): clarify JSM drain advances start by actual row count

The offset-advancement fix (advance `start` by the rows returned, not the
fixed page size) landed in 7b19788; update the TSDoc to match so it no
longer reads as advancing by `limit`.

Author: waleedlatif1

apps/sim/app/api/tools/jsm/selector-requesttypes/route.ts

@@ -30,9 +30,12 @@ interface JsmRequestTypeValue {
 
 /**
  * Drains the offset-paginated JSM `/servicedesk/{id}/requesttype` endpoint,
- * advancing `start` by `limit` until `isLastPage === true` (or `_links.next` is
- * absent). Bounded by `MAX_JSM_REQUEST_TYPES_PAGES`; emits a `logger.warn` and
- * returns the partial set rather than looping unbounded when the cap is hit.
+ * advancing `start` by the number of rows actually returned until
+ * `isLastPage === true` (or `_links.next` is absent, or a page comes back
+ * empty). Advancing by the real row count — not the requested `limit` —
+ * prevents skipping items if the server returns a short non-final page. Bounded
+ * by `MAX_JSM_REQUEST_TYPES_PAGES`; emits a `logger.warn` and returns the
+ * partial set rather than looping unbounded when the cap is hit.
  */
 async function fetchAllJsmRequestTypes(
   requestTypeUrl: string,

apps/sim/app/api/tools/jsm/selector-servicedesks/route.ts

@@ -30,9 +30,12 @@ interface JsmServiceDeskValue {
 
 /**
  * Drains the offset-paginated JSM `/servicedesk` endpoint, advancing `start` by
- * `limit` until `isLastPage === true` (or `_links.next` is absent). Bounded by
- * `MAX_JSM_SERVICE_DESKS_PAGES`; emits a `logger.warn` and returns the partial
- * set rather than looping unbounded when the cap is hit.
+ * the number of rows actually returned until `isLastPage === true` (or
+ * `_links.next` is absent, or a page comes back empty). Advancing by the real
+ * row count — not the requested `limit` — prevents skipping items if the server
+ * returns a short non-final page. Bounded by `MAX_JSM_SERVICE_DESKS_PAGES`;
+ * emits a `logger.warn` and returns the partial set rather than looping
+ * unbounded when the cap is hit.
  */
 async function fetchAllJsmServiceDesks(
   baseUrl: string,