feat: Refactor anime and character handling

- Removed old GetAnimeEpisodes and GetAnimeEpisodesByMALID functions, replaced with a new implementation in episodes.go.
- Added GetAnimeCharacters and GetAnimeCharacter functions to handle character retrieval.
- Introduced CharacterAnimeAppearance entity to track character appearances in anime.
- Updated repositories to manage character data and enrich character details.
- Implemented enriched_at timestamp for both anime and characters to track data updates.
- Added CharacterSync task to periodically enrich character data from the Jikan API.
- Updated router to include new character-related endpoints.

1 files changed, 19 insertions, 0 deletions

diff --git a/utils/api/jikan/jikan.go b/utils/api/jikan/jikan.go
index 8812c5a..507130a 100644
--- a/utils/api/jikan/jikan.go
+++ b/utils/api/jikan/jikan.go
@@ -316,3 +316,22 @@ func GetProducerByID(producerID int) (*types.JikanSingleProducerResponse, error)
 	}
 	return &response, nil
 }
+
+func GetCharacterByMALID(id int) (*types.JikanCharacterFullResponse, error) {
+	url := fmt.Sprintf("%s/characters/%d/full", jikanAPIBaseURL, id)
+	ctx, cancel := context.WithTimeout(context.Background(), contextTimeout)
+	defer cancel()
+
+	bytes, err := clientInstance.makeRequest(ctx, url)
+	if err != nil {
+		logger.Errorf("JikanClient", "GetCharacterByMALID failed for ID %d: %v", id, err)
+		return nil, errors.New("failed to fetch character data from Jikan API")
+	}
+
+	var response types.JikanCharacterFullResponse
+	if err := json.Unmarshal(bytes, &response); err != nil {
+		logger.Errorf("JikanClient", "Failed to unmarshal character response for ID %d: %v", id, err)
+		return nil, errors.New("failed to parse character data from Jikan API")
+	}
+	return &response, nil
+}