add date range for changes endpoint

Author: shashankbrgowda

packages/apollo-collaboration-server/src/changes/changes.service.ts

@@ -274,6 +274,28 @@ export class ChangesService {
       queryCond.sequence = { $gt: Number(changeFilter.since) }
       delete queryCond.since
     }
+
+    if (changeFilter.createdAfter) {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+      const createdAfterDate = new Date(changeFilter.createdAfter)
+      if (Number.isNaN(createdAfterDate.getTime())) {
+        throw new UnprocessableEntityException(
+          'createdAfter must be a valid date string',
+        )
+      }
+
+      // Return only changes created on/after this date.
+      queryCond.createdAt = {
+        $gte: createdAfterDate,
+      }
+      delete queryCond.createdAfter
+    }
+    delete queryCond.createdBefore
+
+    delete queryCond.limit
+    delete queryCond.sort
+    delete queryCond.offset
+
     this.logger.debug(`Search criteria: "${JSON.stringify(queryCond)}"`)
 
     let sortOrder: 1 | -1 = -1
@@ -289,6 +311,15 @@ export class ChangesService {
     if (changeFilter.limit) {
       changeCursor = changeCursor.limit(Number(changeFilter.limit))
     }
+    if (changeFilter.offset) {
+      const offset = Number(changeFilter.offset)
+      if (!Number.isInteger(offset) || offset < 0) {
+        throw new UnprocessableEntityException(
+          'offset must be an integer greater than or equal to 0',
+        )
+      }
+      changeCursor = changeCursor.skip(offset)
+    }
     const change = await changeCursor.exec()
 
     if (!change) {

packages/apollo-collaboration-server/src/changes/dto/find-change.dto.ts

@@ -5,6 +5,9 @@ export class FindChangeDto {
   readonly user?: string
   readonly typeName?: string
   readonly since?: string
+  // Timestamp lower bound for createdAt (ISO string recommended)
+  readonly createdAfter?: string
   readonly sort?: string
   readonly limit?: string
+  readonly offset?: string
 }