analytica-frontend-lib/dist/hooks/useActivityModels/index.mjs.map

Repositório público dos componentes utilizados nas plataformas da Analytica Ensino

{"version":3,"sources":["../../../src/hooks/useActivityModels.ts","../../../src/types/activitiesHistory.ts","../../../src/utils/hookErrorHandler.ts"],"sourcesContent":["import { useState, useCallback } from 'react';\nimport { z } from 'zod';\nimport dayjs from 'dayjs';\nimport { ActivityDraftType } from '../types/activitiesHistory';\nimport type {\n  ActivityModelResponse,\n  ActivityModelTableItem,\n  ActivityModelsApiResponse,\n  ActivityModelFilters,\n  ActivityPagination,\n} from '../types/activitiesHistory';\nimport { createFetchErrorHandler } from '../utils/hookErrorHandler';\n\n/**\n * Zod schema for activity draft filters\n */\nconst activityDraftFiltersSchema = z\n  .object({\n    questionTypes: z.array(z.string()).optional(),\n    questionBanks: z.array(z.string()).optional(),\n    subjects: z.array(z.string()).optional(),\n    topics: z.array(z.string()).optional(),\n    subtopics: z.array(z.string()).optional(),\n    contents: z.array(z.string()).optional(),\n  })\n  .nullable();\n\n/**\n * Zod schema for activity model response validation\n */\nconst activityModelResponseSchema = z.object({\n  id: z.string().uuid(),\n  type: z.nativeEnum(ActivityDraftType),\n  title: z.string().nullable(),\n  creatorUserInstitutionId: z.string().uuid().nullable(),\n  subjectId: z.string().uuid().nullable(),\n  filters: activityDraftFiltersSchema,\n  createdAt: z.string(),\n  updatedAt: z.string(),\n});\n\n/**\n * Zod schema for activity models API response validation\n */\nexport const activityModelsApiResponseSchema = z.object({\n  message: z.string(),\n  data: z.object({\n    activityDrafts: z.array(activityModelResponseSchema),\n    total: z.number(),\n  }),\n});\n\n/**\n * Hook state interface\n */\nexport interface UseActivityModelsState {\n  models: ActivityModelTableItem[];\n  loading: boolean;\n  error: string | null;\n  pagination: ActivityPagination;\n}\n\n/**\n * Hook return type\n */\nexport interface UseActivityModelsReturn extends UseActivityModelsState {\n  fetchModels: (\n    filters?: ActivityModelFilters,\n    subjectsMap?: Map<string, string>\n  ) => Promise<void>;\n  deleteModel: (id: string) => Promise<boolean>;\n}\n\n/**\n * Default pagination values\n */\nexport const DEFAULT_MODELS_PAGINATION: ActivityPagination = {\n  total: 0,\n  page: 1,\n  limit: 10,\n  totalPages: 0,\n};\n\n/**\n * Transform API response to table item format\n * @param model - Activity model from API response\n * @param subjectsMap - Map of subject IDs to subject names\n * @returns Formatted model for table display\n */\nexport const transformModelToTableItem = (\n  model: ActivityModelResponse,\n  subjectsMap?: Map<string, string>\n): ActivityModelTableItem => {\n  const subjectName = model.subjectId\n    ? subjectsMap?.get(model.subjectId) || ''\n    : '';\n\n  return {\n    id: model.id,\n    title: model.title || 'Sem título',\n    savedAt: dayjs(model.createdAt).format('DD/MM/YYYY'),\n    subject: subjectName,\n    subjectId: model.subjectId,\n  };\n};\n\n/**\n * Handle errors during model fetch\n * Uses the generic error handler factory to reduce code duplication\n */\nexport const handleModelFetchError = createFetchErrorHandler(\n  'Erro ao validar dados de modelos de atividades',\n  'Erro ao carregar modelos de atividades'\n);\n\n/**\n * Factory function to create useActivityModels hook\n *\n * @param fetchActivityModels - Function to fetch models from API\n * @param deleteActivityModel - Function to delete a model\n * @returns Hook for managing activity models\n *\n * @example\n * ```tsx\n * // In your app setup\n * const fetchActivityModels = async (filters) => {\n *   const response = await api.get('/activity-drafts', { params: { ...filters, type: 'MODELO' } });\n *   return response.data;\n * };\n *\n * const deleteActivityModel = async (id) => {\n *   await api.delete(`/activity-drafts/${id}`);\n * };\n *\n * const useActivityModels = createUseActivityModels(fetchActivityModels, deleteActivityModel);\n *\n * // In your component\n * const { models, loading, error, pagination, fetchModels, deleteModel } = useActivityModels();\n * ```\n */\nexport const createUseActivityModels = (\n  fetchActivityModels: (\n    filters?: ActivityModelFilters\n  ) => Promise<ActivityModelsApiResponse>,\n  deleteActivityModel: (id: string) => Promise<void>\n) => {\n  return (): UseActivityModelsReturn => {\n    const [state, setState] = useState<UseActivityModelsState>({\n      models: [],\n      loading: false,\n      error: null,\n      pagination: DEFAULT_MODELS_PAGINATION,\n    });\n\n    /**\n     * Fetch activity models from API\n     * @param filters - Optional filters for pagination, search, etc.\n     * @param subjectsMap - Map of subject IDs to subject names for display\n     */\n    const fetchModels = useCallback(\n      async (\n        filters?: ActivityModelFilters,\n        subjectsMap?: Map<string, string>\n      ) => {\n        setState((prev) => ({ ...prev, loading: true, error: null }));\n\n        try {\n          // Fetch data from API\n          const responseData = await fetchActivityModels(filters);\n\n          // Validate response with Zod\n          const validatedData =\n            activityModelsApiResponseSchema.parse(responseData);\n\n          // Transform models to table format\n          const tableItems = validatedData.data.activityDrafts.map((model) =>\n            transformModelToTableItem(model, subjectsMap)\n          );\n\n          // Calculate pagination\n          const limit = filters?.limit || 10;\n          const page = filters?.page || 1;\n          const total = validatedData.data.total;\n          const totalPages = Math.ceil(total / limit);\n\n          // Update state with validated and transformed data\n          setState({\n            models: tableItems,\n            loading: false,\n            error: null,\n            pagination: {\n              total,\n              page,\n              limit,\n              totalPages,\n            },\n          });\n        } catch (error) {\n          const errorMessage = handleModelFetchError(error);\n          setState((prev) => ({\n            ...prev,\n            loading: false,\n            error: errorMessage,\n          }));\n        }\n      },\n      [fetchActivityModels]\n    );\n\n    /**\n     * Delete an activity model\n     * @param id - Model ID to delete\n     * @returns True if deletion was successful\n     */\n    const deleteModel = useCallback(\n      async (id: string): Promise<boolean> => {\n        try {\n          await deleteActivityModel(id);\n          return true;\n        } catch (error) {\n          console.error('Erro ao deletar modelo:', error);\n          return false;\n        }\n      },\n      [deleteActivityModel]\n    );\n\n    return {\n      ...state,\n      fetchModels,\n      deleteModel,\n    };\n  };\n};\n\n/**\n * Alias for createUseActivityModels\n */\nexport const createActivityModelsHook = createUseActivityModels;\n","/**\n * Activities History Type Definitions\n * Types and interfaces for activities history and models functionality\n * Based on /activities/history and /activity-drafts endpoints\n */\n\nimport {\n  GenericApiStatus,\n  GenericDisplayStatus,\n  BadgeActionType,\n  getStatusBadgeAction,\n  mapApiStatusToDisplay,\n} from './common';\n\n/**\n * Activity status from backend API /activities/history\n * Re-exported from common for backward compatibility\n */\nexport { GenericApiStatus as ActivityApiStatus } from './common';\n\n/**\n * Activity status for display in UI (Badge component)\n * Re-exported from common for backward compatibility\n */\nexport { GenericDisplayStatus as ActivityDisplayStatus } from './common';\n\n/**\n * Badge action types for activity status visualization\n * Re-exported from common for backward compatibility\n */\nexport { BadgeActionType as ActivityBadgeActionType } from './common';\n\n/**\n * Activity draft type enum (matches backend ACTIVITY_DRAFT_TYPE)\n */\nexport enum ActivityDraftType {\n  MODELO = 'MODELO',\n  RASCUNHO = 'RASCUNHO',\n}\n\n/**\n * Activity history response from backend API /activities/history\n */\nexport interface ActivityHistoryResponse {\n  id: string;\n  title: string;\n  startDate: string | null;\n  finalDate: string | null;\n  status: GenericApiStatus;\n  completionPercentage: number;\n  subjectId?: string | null;\n  schoolId?: string;\n  schoolName?: string;\n  year?: string;\n  className?: string;\n  subjectName?: string;\n}\n\n/**\n * Activity table item interface for activities list table\n */\nexport interface ActivityTableItem extends Record<string, unknown> {\n  id: string;\n  startDate: string | null;\n  deadline: string | null;\n  title: string;\n  school: string;\n  year: string;\n  subject: string;\n  class: string;\n  status: GenericDisplayStatus;\n  completionPercentage: number;\n}\n\n/**\n * Pagination info from API\n */\nexport interface ActivityPagination {\n  total: number;\n  page: number;\n  limit: number;\n  totalPages: number;\n}\n\n/**\n * Activities history API complete response\n */\nexport interface ActivitiesHistoryApiResponse {\n  message: string;\n  data: {\n    activities: ActivityHistoryResponse[];\n    pagination: ActivityPagination;\n  };\n}\n\n/**\n * Activity history filters for API query parameters\n */\nexport interface ActivityHistoryFilters {\n  page?: number;\n  limit?: number;\n  status?: GenericApiStatus;\n  search?: string;\n  startDate?: string;\n  finalDate?: string;\n  subjectId?: string;\n  schoolId?: string;\n  sortBy?: 'finalDate' | 'title' | 'completionPercentage';\n  sortOrder?: 'asc' | 'desc';\n}\n\n/**\n * Activity draft filters object from backend\n */\nexport interface ActivityDraftFilters {\n  questionTypes?: string[];\n  questionBanks?: string[];\n  subjects?: string[];\n  topics?: string[];\n  subtopics?: string[];\n  contents?: string[];\n}\n\n/**\n * Activity model response from backend API (/activity-drafts)\n */\nexport interface ActivityModelResponse {\n  id: string;\n  type: ActivityDraftType;\n  title: string | null;\n  creatorUserInstitutionId: string | null;\n  subjectId: string | null;\n  filters: ActivityDraftFilters | null;\n  createdAt: string;\n  updatedAt: string;\n}\n\n/**\n * Activity model table item for display\n */\nexport interface ActivityModelTableItem extends Record<string, unknown> {\n  id: string;\n  title: string;\n  savedAt: string;\n  subject: string;\n  subjectId: string | null;\n}\n\n/**\n * Activity models API response\n */\nexport interface ActivityModelsApiResponse {\n  message: string;\n  data: {\n    activityDrafts: ActivityModelResponse[];\n    total: number;\n  };\n}\n\n/**\n * Activity model filters for API query\n */\nexport interface ActivityModelFilters {\n  page?: number;\n  limit?: number;\n  search?: string;\n  subjectId?: string;\n  type?: ActivityDraftType;\n}\n\n/**\n * Filter option for dropdowns\n * Extends with index signature to be compatible with CheckBoxGroup Item type\n */\nexport interface ActivityFilterOption {\n  id: string;\n  name: string;\n  [key: string]: unknown;\n}\n\n/**\n * User data for filter options (schools, classes, subjects)\n */\nexport interface ActivityUserFilterData {\n  schools?: Array<{ id: string; name: string }>;\n  classes?: Array<{ id: string; name: string; schoolId?: string }>;\n  subjects?: Array<{ id: string; name: string }>;\n  schoolYears?: Array<{ id: string; name: string }>;\n}\n\n/**\n * Get status badge action based on activity display status\n * @param status - Activity display status\n * @returns Badge action type for styling\n */\nexport const getActivityStatusBadgeAction = (\n  status: GenericDisplayStatus\n): BadgeActionType => getStatusBadgeAction(status);\n\n/**\n * Activity status options for filter\n */\nexport const ACTIVITY_FILTER_STATUS_OPTIONS: ActivityFilterOption[] = [\n  { id: GenericApiStatus.A_VENCER, name: 'A Vencer' },\n  { id: GenericApiStatus.VENCIDA, name: 'Vencida' },\n  { id: GenericApiStatus.CONCLUIDA, name: 'Concluída' },\n];\n\n/**\n * Map API status to display status\n * @param apiStatus - Status from backend API\n * @returns Formatted status for UI display\n */\nexport const mapActivityStatusToDisplay = (\n  apiStatus: GenericApiStatus\n): GenericDisplayStatus => mapApiStatusToDisplay(apiStatus);\n","import { z } from 'zod';\n\n/**\n * Factory function to create a fetch error handler\n * This reduces code duplication across data fetching hooks\n *\n * @param validationErrorMessage - Message to display for Zod validation errors\n * @param genericErrorMessage - Message to display for other errors\n * @returns Error handler function that returns appropriate error message\n *\n * @example\n * ```typescript\n * const handleFetchError = createFetchErrorHandler(\n *   'Erro ao validar dados',\n *   'Erro ao carregar dados'\n * );\n *\n * try {\n *   // fetch data\n * } catch (error) {\n *   const errorMessage = handleFetchError(error);\n * }\n * ```\n */\nexport const createFetchErrorHandler =\n  (validationErrorMessage: string, genericErrorMessage: string) =>\n  (error: unknown): string => {\n    if (error instanceof z.ZodError) {\n      console.error(validationErrorMessage, error);\n      return validationErrorMessage;\n    }\n\n    console.error(genericErrorMessage, error);\n    return genericErrorMessage;\n  };\n"],"mappings":"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","names":["z","ActivityDraftType","z"]}