From f7bbc7427f0d7020402f8c89ada72a8a0ac29855 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 15 Apr 2026 04:52:45 +0000
Subject: [PATCH] jsweep: improve type annotations in add_reviewer.cjs

- Add HandlerConfig, ResolvedTemporaryIds, and HandlerResult typedef imports
- Add AddReviewerMessage typedef with specific field types
- Add HANDLER_TYPE constant for consistency with other handler files
- Replace generic {Object} JSDoc param types with specific typed references

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 actions/setup/js/add_reviewer.cjs | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/actions/setup/js/add_reviewer.cjs b/actions/setup/js/add_reviewer.cjs
index 28b7660d77c..3d83903f80c 100644
--- a/actions/setup/js/add_reviewer.cjs
+++ b/actions/setup/js/add_reviewer.cjs
@@ -3,8 +3,18 @@
 
 /**
  * @typedef {import('./types/handler-factory').HandlerFactoryFunction} HandlerFactoryFunction
+ * @typedef {import('./types/handler-factory').HandlerConfig} HandlerConfig
+ * @typedef {import('./types/handler-factory').ResolvedTemporaryIds} ResolvedTemporaryIds
+ * @typedef {import('./types/handler-factory').HandlerResult} HandlerResult
  */
 
+/**
+ * @typedef {{ reviewers?: Array<string|null|undefined|false>, pull_request_number?: number|string }} AddReviewerMessage
+ */
+
+/** @type {string} Safe output type handled by this module */
+const HANDLER_TYPE = "add_reviewer";
+
 const { processItems } = require("./safe_output_processor.cjs");
 const { getErrorMessage } = require("./error_helpers.cjs");
 const { getPullRequestNumber } = require("./pr_helpers.cjs");
@@ -32,9 +42,9 @@ async function main(config = {}) {
   let processedCount = 0;
 
   /**
-   * @param {Object} message - The add_reviewer message to process
-   * @param {Object} resolvedTemporaryIds - Map of temporary IDs to {repo, number}
-   * @returns {Promise<Object>} Result with success/error status
+   * @param {AddReviewerMessage} message - The add_reviewer message to process
+   * @param {ResolvedTemporaryIds} resolvedTemporaryIds - Map of temporary IDs to {repo, number}
+   * @returns {Promise<HandlerResult>} Result with success/error status
    */
   return async function handleAddReviewer(message, resolvedTemporaryIds) {
     if (processedCount >= maxCount) {