feat: gdb support

[karenc-bq]

Summary

Adds Aurora Global Database (GDB) support to the AWS Advanced NodeJS Wrapper, along with the supporting refactors that make it possible.

Description

New GDB features

• GDB Failover Plugin (gdbFailover) — built on Failover v2, adds the notion of a home region and lets applications configure distinct failover behavior for in-home (primary region matches the configured home region) and out-of-home (primary has switched to another region) cases. See UsingTheGdbFailoverPlugin.md.
• GDB Read/Write Splitting Plugin (gdbReadWriteSplitting) — extends read/write splitting with a home-region constraint so new connections can be kept in-region, avoiding cross-region latency. See UsingTheGdbReadWriteSplittingPlugin.md.
• Global Aurora Accessible Regions (gdbAccessibleRegions) — a comma-separated allowlist of reachable AWS regions. When set, hosts in excluded regions are filtered out of topology monitoring, failover candidates, read/write splitting targets, and initial connection strategy. See UsingGlobalAuroraAccessibleRegions.md.
• GDB database dialects and IAM authentication support for GDB.

Supporting refactors

• EFM plugin restructure — split into efm/v1 and efm/v2 with shared efm/base classes (host_monitor, host_monitor_service, connection_context); removed the legacy efm/ and efm2/ monitor implementations.
• Topology handling — introduced topology_utils, aurora_topology_utils, global_topology_utils, global_aurora_host_list_provider, and dedicated monitoring connection handlers (aurora_monitoring_connection_handler, gdb_monitoring_connection_handler, global_aurora_topology_monitor).
• Read/write splitting moved into its own directory and refactored.
• Storage service refactoring and consolidation of cache items into a single location.
• Added partial_plugin_service; cleanups removing duplicated getHostAndPort, the suggested cluster id, and alias usage.
• Federated auth / SAML providers consolidated.

Docs & CI

• New GDB plugin guides plus updated compatibility documentation.
• GitHub Actions workflows updated to run on dev/v3.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[sophia-bq]

I did a little audit of all the messages and here are the ones that are

In code and not in the messages file:

• PluginService.errorIdentifyConnection
• Failover2.unableToConnect
• LimitlessConnectionPlugin.failedToConnectToHost
• RdsHostListProvider.parsedListEmpty
• RdsHostListProvider.invalidPattern.suggestedClusterId
• RdsHostListProvider.clusterInstanceHostPatternNotSupportedForRDSProxy
• RdsHostListProvider.clusterInstanceHostPatternNotSupportedForRdsCustom

Fewer args than %s (literal %s leaks — add missing arg)

• Failover.unexpectedReaderRole — %s: 2, args: 1
• Bgd.stillInProgressTryMethodLater — %s: 2, args: 1
• MonitorService.monitorClassMismatch — %s: 4, args: 3
  -PluginManager.unknownPluginCode — %s: 1, args: 0

More args than %s (extra arg dropped)

• AwsSecretsManagerConnectionPlugin.unhandledError — %s: 1, args: 2
• HostResponseTimeMonitor.interruptedErrorDuringMonitoring — %s: 1, args: 2
• LimitlessRouterMonitor.errorDuringMonitoringStop — %s: 1, args: 2
• HostMonitor.detectedWriter — %s: 1, args: 2
• LimitlessRouterServiceImpl.nullLimitlessRouterMonitor — %s: 0, args: 1
• ConfigurationProfileBuilder.profileNameRequired — %s: 0, args: 1

In the messages file and not in the code:
AuroraInitialConnectionStrategyPlugin.requireDynamicProvider
Authentication.unsupportedHostname
Bgd.inProgressConnectionClosed
Bgd.interrupted
Bgd.unhandledNetworkError
Bgd.usesVersion
ClientUtils.connectTimeout
ClusterAwareReaderFailoverHandler.failedReaderConnection
ClusterTopologyMonitor.endMonitoring
ClusterTopologyMonitor.errorDuringMonitoring
ClusterTopologyMonitor.startingHostMonitors
ClusterTopologyMonitor.unableToConnect
ClusterTopologyMonitoring.ignoringNewTopologyRequest
ConnectionStringHostListProvider.errorIdentifyConnection
Failover.TransactionResolutionUnknownError
Failover.connectionExplicitlyClosed
Failover.noOperationsAfterConnectionClosed
Failover.strictReaderUnknownHostRole
Failover2.failoverReaderNotConnectedToReader
GlobalDbFailoverPlugin.unableToConnect
HostMonitor.writerIsStale
HostResponseTimeMonitor.stopped
MonitorImpl.startMonitoringTaskNewContext
MonitorImpl.stopMonitoringTaskNewContext
MonitorImpl.stopped
OpenedConnectionTracker.unableToPopulateOpenedConnectionQueue
PluginService.failedToRetrieveHostPort
PluginService.releaseResources
PluginService.requiredBlockingHostListProvider
PluginServiceImpl.failedToRetrieveHostPort
RdsHostListProvider.noClusterId
RdsMultiAzDatabaseDialect.invalidTopology
ReadWriteSplittingPlugin.closingInternalClients
ReadWriteSplittingPlugin.failedToConnectToWriter
StaleDnsHelper.clusterEndpointDns
StaleDnsHelper.writerInetAddress
StaleDnsPlugin.requireDynamicProvider

[karenc-bq]

Thanks for catching this. Addressed.