fix(providers/amazon): S3DagBundle does not delete stale dag recursively

[jerryzhou196]

• Closes S3DagBundle does not delete stale dag recursively #62622

This copies the implementation made for GCS so that we are pruning stale files and directories in a S3Bundle.

Testing:

• It handles infinite symlinks as we call the .resolve() which resolves symlinks to their absolute path.
• It tests nested stale file deletion, preservation of non-stale nested files, and cleanup of empty subdirectories
• I also manually tested by uploading some files to S3, reading them in an S3 bundle, and then removing them and checking the old ones were removed

---

Was generative AI tooling used to co-author this PR?

• Yes (please specify the tool below)
• Cursor + Claude Code

[boring-cyborg]

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

• Pay attention to the quality of your code (ruff, mypy and type annotations). Our prek-hooks will help you with that.
• In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
• Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
• Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
• Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
• Be sure to read the Airflow Coding style.
• Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
  Apache Airflow is a community-driven project and together we are making it better 🚀.
  In case of doubts contact the developers at:
  Mailing List: dev@airflow.apache.org
  Slack: https://s.apache.org/airflow-slack

[jerryzhou196]

Ah, fixed the failing test. Not sure how to re-run CI.

[boring-cyborg]

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.