feat: add getInternalApiOrigin method to ExpressHttpServer interface for internal API calls

Author: NoOne7135

adminforth/servers/express.ts

@@ -10,6 +10,7 @@ import { WebSocketServer } from 'ws';
 import { WebSocketClient } from './common.js';
 import { AdminUser } from '../types/Common.js';
 import http from 'http';
+import type { AddressInfo } from 'net';
 import { randomUUID } from 'crypto';
 import { listify } from '../modules/utils.js';
 import { afLogger } from '../modules/logger.js';
@@ -285,6 +286,16 @@ class ExpressServer implements IExpressHttpServer {
     this.server.listen(...args);
   }
 
+  getInternalApiOrigin(): string | undefined {
+    const address = this.server?.address();
+
+    if (!address || typeof address === 'string') {
+      return undefined;
+    }
+
+    return `http://127.0.0.1:${(address as AddressInfo).port}`;
+  }
+
   async processAuthorizeCallbacks(adminUser: AdminUser, toReturn: { error?: string, allowed: boolean }, response: Response, extra: HttpExtra) {
     const adminUserAuthorize = this.adminforth.config.auth.adminUserAuthorize as (AdminUserAuthorizeFunction[] | undefined);
 

adminforth/types/Back.ts

@@ -153,6 +153,11 @@ export interface IExpressHttpServer extends IHttpServer {
   listen(port: number, callback: Function): void;
   listen(port: number, host: string, callback: Function): void;
 
+  /**
+   * Returns an internal HTTP origin for same-process/server API calls.
+   */
+  getInternalApiOrigin(): string | undefined;
+
   /**
    * Method (middleware) to wrap express endpoints with authorization check.
    * Adds adminUser to request object if user is authorized. Drops request with 401 status if user is not authorized.
@@ -2328,4 +2333,4 @@ export interface PluginsCommonOptions {
      * It is required if you want to log custom actions, otherwise it is optional.
     */
     id?: string;
-}
+}