feat(port-management): add findFreePort method for automatic port discovery within a range

ts/smartnetwork.classes.smartnetwork.ts

@@ -143,6 +143,33 @@ export class SmartNetwork {
     return result;
   }
 
+  /**
+   * Find the first available port within a given range
+   * @param startPort The start of the port range (inclusive)
+   * @param endPort The end of the port range (inclusive)
+   * @returns The first available port number, or null if no ports are available
+   */
+  public async findFreePort(startPort: number, endPort: number): Promise<number | null> {
+    // Validate port range
+    if (startPort < 1 || startPort > 65535 || endPort < 1 || endPort > 65535) {
+      throw new NetworkError('Port numbers must be between 1 and 65535', 'EINVAL');
+    }
+    if (startPort > endPort) {
+      throw new NetworkError('Start port must be less than or equal to end port', 'EINVAL');
+    }
+
+    // Check each port in the range
+    for (let port = startPort; port <= endPort; port++) {
+      const isUnused = await this.isLocalPortUnused(port);
+      if (isUnused) {
+        return port;
+      }
+    }
+
+    // No free port found in the range
+    return null;
+  }
+
   /**
    * checks wether a remote port is available
    * @param domainArg