feat: allow scaffolder tasks pagination in the backend

Still requires the UI to take use of this. Relates to #25856

Signed-off-by: Heikki Hellgren <heikki.hellgren@op.fi>

plugins/scaffolder-node/src/tasks/types.ts

@@ -181,7 +181,22 @@ export interface TaskBroker {
   get(taskId: string): Promise<SerializedTask>;
 
   list?(options?: {
+    filters?: {
+      createdBy?: string | string[];
+      status?: TaskStatus | TaskStatus[];
+    };
+    pagination?: {
+      limit?: number;
+      offset?: number;
+    };
+    order?: { order: 'asc' | 'desc'; field: string }[];
+  }): Promise<{ tasks: SerializedTask[]; totalTasks?: number }>;
+
+  /**
+   * @deprecated Make sure to pass `createdBy` and `status` in the `filters` parameter instead
+   */
+  list?(options: {
     createdBy?: string;
     status?: TaskStatus;
-  }): Promise<{ tasks: SerializedTask[] }>;
+  }): Promise<{ tasks: SerializedTask[]; totalTasks?: number }>;
 }