Remove refresh() method from public API surface area.

Author: phipag

docs/utilities/lambda_metadata.md

@@ -160,29 +160,6 @@ For [Lambda Managed Instances](https://docs.aws.amazon.com/lambda/latest/dg/lamb
     }
     ```
 
-### Forcing a refresh
-
-In rare cases where you need to force a refresh of the cached metadata, use the `refresh()` method:
-
-=== "RefreshExample.java"
-
-    ```java hl_lines="10"
-    import software.amazon.lambda.powertools.metadata.LambdaMetadata;
-    import software.amazon.lambda.powertools.metadata.LambdaMetadataClient;
-
-    public class RefreshExample implements RequestHandler<Object, String> {
-
-        @Override
-        public String handleRequest(Object input, Context context) {
-            // Force a refresh of the cached metadata
-            // This makes a new HTTP request to the metadata endpoint
-            LambdaMetadata metadata = LambdaMetadataClient.refresh();
-            return "{\"az\": \"" + metadata.getAvailabilityZoneId() + "\"}";
-        }
-    }
-    ```
-
-
 ### Error handling
 
 The utility throws `LambdaMetadataException` when the metadata endpoint is unavailable or returns an error:

powertools-lambda-metadata/src/main/java/software/amazon/lambda/powertools/metadata/LambdaMetadataClient.java

@@ -114,13 +114,13 @@ public static LambdaMetadata get() {
      * Forces a refresh of the cached metadata.
      * <p>
      * This method clears the cache and fetches fresh metadata from the endpoint.
-     * Use this only for advanced use cases where you need to force a refresh.
+     * Used internally for SnapStart cache invalidation.
      * </p>
      *
      * @return the refreshed LambdaMetadata instance
      * @throws LambdaMetadataException if the metadata endpoint is unavailable or returns an error
      */
-    public static LambdaMetadata refresh() {
+    static LambdaMetadata refresh() {
         cachedInstance.set(null);
         return get();
     }