feat(aws): add apigateway_domain_name_pqc_tls_enabled check - #11316

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/user-guide/cli/tutorials/configuration_file.mdx`:
- Line 58: The newly documented configurable check mapping for
`apigateway_domain_name_pqc_tls_enabled` to
`apigateway_pqc_tls_allowed_policies` is missing a Version Badge component.
Locate the section header or title that introduces this new configuration
mapping and add a VersionBadge component on its own line immediately after the
header using the format `<VersionBadge version="X.Y.Z" />` where X.Y.Z is the
appropriate version number when this feature was introduced in Prowler.

In
`@prowler/providers/aws/services/apigateway/apigateway_domain_name_pqc_tls_enabled/apigateway_domain_name_pqc_tls_enabled.py`:
- Line 18: The execute method is missing a docstring which is required for all
public methods in Python. Add a docstring immediately after the method
definition of execute that clearly describes what the method does, its
parameters if any, and its return type (list[Check_Report_AWS]). The docstring
should follow the project's documentation conventions and provide clear context
about the method's purpose and behavior.
- Around line 20-27: The code retrieves pqc_policies from audit_config using a
get method that could return null or a non-iterable value if misconfigured in
the audit settings. Before the membership check `if domain.security_policy in
pqc_policies` on line 26, add validation to ensure pqc_policies is actually
iterable (a list or set). If the value is null or not iterable, either assign it
to a default empty list or the PQC_APIGATEWAY_POLICIES_DEFAULT constant to
prevent a TypeError when the in operator is executed.

In `@prowler/providers/aws/services/apigateway/apigateway_service.py`:
- Line 24: Add Google-style docstrings to the `_get_domain_names` method and to
the class/definition at line 281. Each docstring should follow Google's
documentation format, including a brief summary of what the method/class does, a
description of parameters (Args), return value (Returns), and any exceptions
(Raises) if applicable. Place the docstring immediately after the method/class
definition line, enclosed in triple quotes.

---

Outside diff comments:
In
`@tests/providers/aws/services/apigateway/apigateway_domain_name_pqc_tls_enabled/apigateway_domain_name_pqc_tls_enabled_test.py`:
- Around line 27-156: The test class
`Test_apigateway_domain_name_pqc_tls_enabled` needs to be refactored to use
moto's `@mock_aws` decorator in addition to the existing `MagicMock` setup to
follow AWS check testing standards. Import `mock_aws` from the moto library and
apply it as a decorator to the test class, then verify that all test methods
(test_no_domains, test_pq_policy, test_legacy_tls_1_2,
test_missing_security_policy, and test_configurable_allowlist) continue to work
with the combined moto and MagicMock mocking approach.

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
`@prowler/providers/aws/services/apigateway/apigateway_domain_name_pqc_tls_enabled/apigateway_domain_name_pqc_tls_enabled.py`:
- Around line 11-15: The _get_allowed_policies helper function parameter
`configured_policies` is missing a type annotation. Add an explicit type hint
`Any` to the `configured_policies` parameter to clarify that this helper
function accepts any type before validating it with isinstance. This improves
code clarity and aligns with coding guidelines for type hints.

---

Outside diff comments:
In `@prowler/providers/aws/services/apigateway/apigateway_service.py`:
- Line 47: Remove the list wrapping around the tags field in the DomainName,
RestAPI, and Stage model initializations. In the DomainName initialization at
line 47, change tags=[item.get("tags", {})] to tags=item.get("tags") to pass the
tags dict directly instead of wrapping it in a list. Similarly, update line 71
in the RestAPI initialization from tags=[apigw.get("tags")] to
tags=apigw.get("tags"), and apply the same fix to the Stage model initialization
around line 173. This allows Pydantic to apply the model default of an empty
list when tags are absent or None, rather than creating inconsistent data
structures like [{}] or [None].