From 10a19a066ded4a29ce7888c713e7e7afb7e97ad8 Mon Sep 17 00:00:00 2001
From: Rafi Arrafif <rafiarrafif05@gmail.com>
Date: Fri, 30 Jan 2026 04:23:47 +0700
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs:=20add=20documentation=20fo?=
 =?UTF-8?q?r=20bulk=20insert=20media?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../controllers/bulkInsertAnime.controller.ts | 21 -------
 .../controllers/bulkInsertMedia.controller.ts | 56 +++++++++++++++++++
 src/modules/internal/index.ts                 |  4 +-
 3 files changed, 58 insertions(+), 23 deletions(-)
 delete mode 100644 src/modules/internal/controllers/bulkInsertAnime.controller.ts
 create mode 100644 src/modules/internal/controllers/bulkInsertMedia.controller.ts

diff --git a/src/modules/internal/controllers/bulkInsertAnime.controller.ts b/src/modules/internal/controllers/bulkInsertAnime.controller.ts
deleted file mode 100644
index 6b06b0a..0000000
--- a/src/modules/internal/controllers/bulkInsertAnime.controller.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { Context } from "elysia";
-import { mainErrorHandler } from "../../../helpers/error/handler";
-import { bulkInsertAnimeService } from "../services/http/bulkInsertAnime.service";
-import { returnWriteResponse } from "../../../helpers/callback/httpResponse";
-import { bulkInsertCharWithVAService } from "../services/internal/bulkInsertCharWithVA.service";
-
-export const bulkInsertAnimeController = async (
-  ctx: Context & { body: { mal_id: number } },
-) => {
-  try {
-    const bulkInsertResult = await bulkInsertAnimeService(ctx.body.mal_id);
-    return returnWriteResponse(
-      ctx.set,
-      201,
-      "Bulk insert anime operation completed successfully",
-      bulkInsertResult,
-    );
-  } catch (error) {
-    return mainErrorHandler(ctx.set, error);
-  }
-};
diff --git a/src/modules/internal/controllers/bulkInsertMedia.controller.ts b/src/modules/internal/controllers/bulkInsertMedia.controller.ts
new file mode 100644
index 0000000..a505f20
--- /dev/null
+++ b/src/modules/internal/controllers/bulkInsertMedia.controller.ts
@@ -0,0 +1,56 @@
+import { Context } from "elysia";
+import { mainErrorHandler } from "../../../helpers/error/handler";
+import { bulkInsertAnimeService } from "../services/http/bulkInsertAnime.service";
+import { returnWriteResponse } from "../../../helpers/callback/httpResponse";
+
+/**
+ * @function bulkInsertAnimeController
+ * @description Insert new anime to the database only with mal_id. This operation including inserting related data such as genres, studios, producers, licensors, themes, demographics, and relations.
+ *
+ * @param {Context & { body: { mal_id: number } }} ctx
+ * The context object containing the request body.
+ * The body must include:
+ * - mal_id: number - The MyAnimeList ID of the anime to be inserted.
+ *
+ * @example
+ * Request route: POST /internal/anime/bulk-insert
+ * Request body:
+ * {
+ *   "mal_id": 12345
+ * }
+ *
+ * @returns {Promise<Object>}
+ * A response object indicating success or failure.
+ * Return example:
+ * {
+ *   success: true,
+ *   status: 201,
+ *   message: "Bulk insert anime operation completed successfully",
+ *   data: { ...bulkInsertResult } // Data returned only if the env run on development mode
+ * }
+ *
+ * @throws {Object}
+ * An error response object if validation fails or an error occurs during bulk insert operation.
+ * Return example:
+ * {
+ *   success: false,
+ *   status: <Status Code>,
+ *   message: "<Error Message>",
+ *   error: { ...errorDetails } // Additional error details if available and the env run on development mode
+ * }
+ */
+export const bulkInsertMediaController = async (
+  ctx: Context & { body: { mal_id: number } },
+) => {
+  try {
+    const bulkInsertResult = await bulkInsertAnimeService(ctx.body.mal_id);
+    return returnWriteResponse(
+      ctx.set,
+      201,
+      "Bulk insert anime operation completed successfully",
+      bulkInsertResult,
+    );
+  } catch (error) {
+    return mainErrorHandler(ctx.set, error);
+  }
+};
diff --git a/src/modules/internal/index.ts b/src/modules/internal/index.ts
index e7838c8..b7321b5 100644
--- a/src/modules/internal/index.ts
+++ b/src/modules/internal/index.ts
@@ -1,7 +1,7 @@
 import Elysia from "elysia";
-import { bulkInsertAnimeController } from "./controllers/bulkInsertAnime.controller";
 import { bulkInsertEpisodeController } from "./controllers/bulkInsertEpisode.controller";
+import { bulkInsertMediaController } from "./controllers/bulkInsertMedia.controller";
 
 export const internalModule = new Elysia({ prefix: "/internal" })
-  .post("/media/bulk-insert", bulkInsertAnimeController)
+  .post("/media/bulk-insert", bulkInsertMediaController)
   .post("/episode/bulk-insert", bulkInsertEpisodeController);