fix(telegram): resolve type-check errors in tgApi module and tests

Replace em-dash characters in JSDoc with hyphens and add inline type
assertions for server.address() to satisfy jsconfig checkJs.

Signed-off-by: Tommy Lin <tommylin@signalpro.com.tw>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: tommylin-signalpro

bin/lib/telegram-api.js

@@ -14,14 +14,14 @@ const DEFAULT_TIMEOUT_MS = 60000;
 /**
  * Call a Telegram Bot API method.
  *
- * @param {string} token  — Bot token from @BotFather
- * @param {string} method — API method name (e.g. "getUpdates")
- * @param {object} body   — JSON-serialisable request body
+ * @param {string} token  - Bot token from BotFather
+ * @param {string} method - API method name (e.g. "getUpdates")
+ * @param {object} body   - JSON-serialisable request body
  * @param {object} [opts]
- * @param {number} [opts.timeout]  — socket idle timeout in ms (default 60 000)
- * @param {string} [opts.hostname] — override hostname (useful for tests)
- * @param {number} [opts.port]     — override port (useful for tests)
- * @param {boolean} [opts.rejectUnauthorized] — TLS cert check (default true)
+ * @param {number} [opts.timeout]  - socket idle timeout in ms (default 60 000)
+ * @param {string} [opts.hostname] - override hostname (useful for tests)
+ * @param {number} [opts.port]     - override port (useful for tests)
+ * @param {boolean} [opts.rejectUnauthorized] - TLS cert check (default true)
  * @returns {Promise<object>} parsed JSON response
  */
 function tgApi(token, method, body, opts = {}) {

test/telegram-api.test.js

@@ -53,15 +53,16 @@ const servers = [];
 /**
  * Create a local HTTPS test server with the given request handler.
  *
- * @param {Function} handler — Node.js (req, res) request handler
+ * @param {import("http").RequestListener} handler - Node.js (req, res) request handler
  * @returns {Promise<{server: import("https").Server, port: number}>}
  */
 function createServer(handler) {
   return new Promise((resolve) => {
     const server = https.createServer({ key, cert }, handler);
     server.listen(0, "127.0.0.1", () => {
       servers.push(server);
-      const { port } = server.address();
+      const addr = server.address();
+      const port = /** @type {import("net").AddressInfo} */ (addr).port;
       resolve({ server, port });
     });
   });
@@ -165,8 +166,8 @@ describe("tgApi (bin/lib/telegram-api)", () => {
 
   it("handles connection refused (server down)", async () => {
     const tempServer = net.createServer();
-    await new Promise((r) => tempServer.listen(0, "127.0.0.1", r));
-    const { port } = tempServer.address();
+    await new Promise((r) => tempServer.listen(0, "127.0.0.1", () => r()));
+    const port = /** @type {import("net").AddressInfo} */ (tempServer.address()).port;
     await new Promise((resolve, reject) =>
       tempServer.close((err) => (err ? reject(err) : resolve())),
     );