Merge pull request #109 from khanavi272-spec/feat/creator-select-fields-103

feat: add select-fields query support for creator list (#103)

Author: Chucks1093

src/modules/creator/creator.controller.ts

@@ -20,6 +20,53 @@ import { normalizeCreatorListPage } from './creator-list-page.guard';
 // Legacy query schema
 import { LegacyCreatorQuerySchema } from '../creators/creators.schemas';
 
+const ALLOWED_CREATOR_SELECT_FIELDS = [
+  'id',
+  'handle',
+  'displayName',
+  'bio',
+  'avatarUrl',
+  'bannerUrl',
+  'isVerified',
+  'keysSupply',
+  'floorPrice',
+  'createdAt',
+  'updatedAt',
+] as const;
+
+type AllowedCreatorSelectField = (typeof ALLOWED_CREATOR_SELECT_FIELDS)[number];
+
+function parseSelectFields(raw: unknown): string[] {
+  if (typeof raw !== 'string' || !raw.trim()) {
+    return [];
+  }
+
+  return raw
+    .split(',')
+    .map((field) => field.trim())
+    .filter(Boolean);
+}
+
+function getInvalidSelectFields(fields: string[]): string[] {
+  return fields.filter(
+    (field) =>
+      !ALLOWED_CREATOR_SELECT_FIELDS.includes(field as AllowedCreatorSelectField)
+  );
+}
+
+function pickFields<T extends Record<string, unknown>>(
+  item: T,
+  fields: string[]
+): Partial<T> {
+  if (!fields.length) {
+    return item;
+  }
+
+  return Object.fromEntries(
+    Object.entries(item).filter(([key]) => fields.includes(key))
+  ) as Partial<T>;
+}
+
 // Typed Express handler
 export const listCreators: RequestHandler = async (req, res) => {
   try {
@@ -33,6 +80,18 @@ export const listCreators: RequestHandler = async (req, res) => {
       return sendValidationError(res, 'Invalid query parameters', parsed.details);
     }
 
+    const selectedFields = parseSelectFields(ctx.query['select-fields']);
+    const invalidFields = getInvalidSelectFields(selectedFields);
+
+    if (invalidFields.length > 0) {
+      return sendValidationError(res, 'Invalid query parameters', [
+        {
+          field: 'select-fields',
+          message: `Invalid select-fields: ${invalidFields.join(', ')}`,
+        },
+      ]);
+    }
+
     // Destructure using schema fields
     const { offset, limit, sort, order: sortOrder } = parsed.data;
 
@@ -49,15 +108,25 @@ export const listCreators: RequestHandler = async (req, res) => {
       sort: sortOptions,
     });
 
-    // Send success response
+    const response = wrapPublicCreatorListResponse(creators, meta);
+
+    const filteredItems = Array.isArray(response.items)
+      ? response.items.map((item) =>
+          pickFields(item as Record<string, unknown>, selectedFields)
+        )
+      : response.items;
+
     return sendSuccess(
       res,
-      wrapPublicCreatorListResponse(creators, meta),
+      {
+        ...response,
+        items: filteredItems,
+      },
       200,
       'Creators retrieved successfully'
     );
   } catch (error) {
     console.error('Error listing creators:', error);
     return sendError(res, 500, ErrorCode.INTERNAL_ERROR, 'Failed to retrieve creators');
   }
-};
+};