add initial files

Author: brmur

.doc_gen/metadata/location_metadata.yaml

@@ -23,6 +23,15 @@ location_Hello:
             - description:
               snippet_tags:
                 - location.java2.hello.main
+    JavaScript:
+      versions:
+        - sdk_version: 3
+          github: javascriptv3/example_code/location/
+          sdkguide:
+          excerpts:
+            - description:
+              snippet_tags:
+                - javascript.v3.location.hello
   services:
     location: {ListGeofencesPaginator}
 location_CreateMap:

javascriptv3/example_code/location/hello.js

@@ -0,0 +1,44 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+// snippet-start:[javascript.v3.location.hello]
+import { fileURLToPath } from "node:url";
+import {
+  LocationClient,
+  ListGeofenceCollectionsCommand,
+} from "@aws-sdk/client-location";
+
+/**
+ * Lists geofences from a specified geofence collection asynchronously.
+ */
+export const main = async () => {
+  const region = "eu-west-1";
+  const locationClient = new LocationClient({ region: region });
+  const listGeofenceCollParams = {
+    MaxResults: 100,
+  };
+  try {
+    const command = new ListGeofenceCollectionsCommand(listGeofenceCollParams);
+    const response = await locationClient.send(command);
+    const geofenceEntries = response.Entries;
+    if (geofenceEntries.length === 0) {
+      console.log("No Geofences were found in the collection.");
+    } else {
+      for (const geofenceEntry of geofenceEntries) {
+        console.log(`Geofence ID: ${geofenceEntry.CollectionName}`);
+      }
+    }
+  } catch (error) {
+    console.error(
+      `A validation error occurred while creating geofence: ${error} \n Exiting program.`,
+    );
+    return;
+  }
+};
+
+// snippet-end:[javascript.v3.location.hello]
+
+// Invoke main function if this file was run directly.
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  main();
+}

javascriptv3/example_code/location/tests/hello.integration.test.js

@@ -0,0 +1,15 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { describe, it } from "vitest";
+import { main } from "../hello.js";
+
+describe("test hello", () => {
+  it(
+    "should not re-throw service exceptions",
+    async () => {
+      await main();
+    },
+    { timeout: 600000 },
+  );
+});