feat: added cursor-based pagination to checklistitems

src/common/DTO/cursor-pagination.dto.ts

@@ -0,0 +1,18 @@
+import { ApiPropertyOptional } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import { IsInt, IsISO8601, IsOptional, Max, Min } from "class-validator";
+
+export class CursorPaginationDto {
+  @IsOptional()
+  @IsISO8601()
+  @ApiPropertyOptional({ type: "string", description: "Cursor (createdAt of last seen item)", example: "2026-07-01T10:00:00.000Z" })
+  cursor?: string;
+
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  @Max(50)
+  @Type(() => Number)
+  @ApiPropertyOptional({ type: "number", required: false, default: 10 })
+  limit?: number;
+}

src/common/helpers/cursor-paginated.helper.ts

@@ -0,0 +1,25 @@
+import { CursorPaginatedResult } from "../interfaces/cursor-paginated-result.interface";
+
+export function buildCursorPageFormat<T extends { createdAt: Date }>(
+  data: T[],
+  limit: number,
+  previousCursor?: Date,
+): CursorPaginatedResult<T> {
+  const hasMore = data.length > limit;
+
+  if (hasMore) data.pop();
+
+  const nextCursor = hasMore ? data[data.length - 1].createdAt.toISOString() : null;
+
+  const prevCursor = previousCursor ? previousCursor.toISOString() : null;
+
+  return {
+    data,
+    meta: {
+      nextCursor,
+      prevCursor,
+      hasMore,
+      limit,
+    },
+  };
+}

src/common/interfaces/cursor-paginated-result.interface.ts

@@ -0,0 +1,9 @@
+export interface CursorPaginatedResult<T> {
+  data: T[];
+  meta: {
+    nextCursor: string | null;
+    prevCursor: string | null;
+    hasMore: boolean;
+    limit: number;
+  };
+}