feat(resources): add cursor, group by on /api/favorites/resources

static/js/core/types.js

@@ -333,6 +333,22 @@
  * @property {string|undefined}    [next_cursor]  - Absent when the last page is reached.
  */
 
+/**
+ * One item returned by `GET /api/favorites/resources`.
+ * `resource_type` discriminates the shape of `resource`.
+ * @typedef {Object} FavoritesResourceItem
+ * @property {ResourceTypeEnum}    resource_type  - 'file' | 'folder'
+ * @property {string}              favorited_at   - ISO-8601 timestamp when the item was starred.
+ * @property {FileItem|FolderItem} resource       - Full resource details; shape follows resource_type.
+ */
+
+/**
+ * Response for `GET /api/favorites/resources`.
+ * @typedef {Object} FavoritesResourcesResponse
+ * @property {FavoritesResourceItem[]}  items
+ * @property {string|undefined}         [next_cursor]  - Absent when the last page is reached.
+ */
+
 /**
  * @typedef {Object} ContactEmail
  * @property {string}  email