@aws-sdk/client-location 3.1032.0 → 3.1034.0

package/README.md

@@ -22,16 +22,16 @@ To install this package, use the CLI of your favorite package manager:
 
 The AWS SDK is modulized by clients and commands.
 To send a request, you only need to import the `LocationClient` and
-the commands you need, for example `ListKeysCommand`:
+the commands you need, for example `ListJobsCommand`:
 
 ```js
 // ES5 example
-const { LocationClient, ListKeysCommand } = require("@aws-sdk/client-location");
+const { LocationClient, ListJobsCommand } = require("@aws-sdk/client-location");
 ```
 
 ```ts
 // ES6+ example
-import { LocationClient, ListKeysCommand } from "@aws-sdk/client-location";
+import { LocationClient, ListJobsCommand } from "@aws-sdk/client-location";
 ```
 
 ### Usage
@@ -48,7 +48,7 @@ To send a request:
 const client = new LocationClient({ region: "REGION" });
 
 const params = { /** input parameters */ };
-const command = new ListKeysCommand(params);
+const command = new ListJobsCommand(params);
 ```
 
 #### Async/await
@@ -104,7 +104,7 @@ const client = new Location({ region: "REGION" });
 
 // async/await.
 try {
-  const data = await client.listKeys(params);
+  const data = await client.listJobs(params);
   // process data.
 } catch (error) {
   // error handling.
@@ -112,7 +112,7 @@ try {
 
 // Promises.
 client
-  .listKeys(params)
+  .listJobs(params)
   .then((data) => {
     // process data.
   })
@@ -121,7 +121,7 @@ client
   });
 
 // callbacks (not recommended).
-client.listKeys(params, (err, data) => {
+client.listJobs(params, (err, data) => {
   // process err and data.
 });
 ```
@@ -244,6 +244,13 @@ CalculateRouteMatrix
 </details>
 <details>
 <summary>
+CancelJob
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/location/command/CancelJobCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-location/Interface/CancelJobCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-location/Interface/CancelJobCommandOutput/)
+</details>
+<details>
+<summary>
 CreateGeofenceCollection
 </summary>
 
@@ -405,6 +412,13 @@ GetGeofence
 </details>
 <details>
 <summary>
+GetJob
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/location/command/GetJobCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-location/Interface/GetJobCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-location/Interface/GetJobCommandOutput/)
+</details>
+<details>
+<summary>
 GetMapGlyphs
 </summary>
 
@@ -461,6 +475,13 @@ ListGeofences
 </details>
 <details>
 <summary>
+ListJobs
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/location/command/ListJobsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-location/Interface/ListJobsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-location/Interface/ListJobsCommandOutput/)
+</details>
+<details>
+<summary>
 ListKeys
 </summary>
 
@@ -538,6 +559,13 @@ SearchPlaceIndexForText
 </details>
 <details>
 <summary>
+StartJob
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/location/command/StartJobCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-location/Interface/StartJobCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-location/Interface/StartJobCommandOutput/)
+</details>
+<details>
+<summary>
 TagResource
 </summary>
 

package/dist-cjs/endpoint/bdd.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bdd = void 0;
+const util_endpoints_1 = require("@smithy/util-endpoints");
+const k = "ref";
+const a = -1, b = true, c = "isSet", d = "PartitionResult", e = "booleanEquals", f = "getAttr", g = { [k]: "Endpoint" }, h = { [k]: d }, i = {}, j = [{ [k]: "Region" }];
+const _data = {
+    conditions: [
+        [c, [g]],
+        [c, j],
+        ["aws.partition", j, d],
+        [e, [{ [k]: "UseFIPS" }, b]],
+        [e, [{ [k]: "UseDualStack" }, b]],
+        [e, [{ fn: f, argv: [h, "supportsDualStack"] }, b]],
+        [e, [{ fn: f, argv: [h, "supportsFIPS"] }, b]]
+    ],
+    results: [
+        [a],
+        [a, "Invalid Configuration: FIPS and custom endpoint are not supported"],
+        [a, "Invalid Configuration: Dualstack and custom endpoint are not supported"],
+        [g, i],
+        ["https://geo-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", i],
+        [a, "FIPS and DualStack are enabled, but this partition does not support one or both"],
+        ["https://geo-fips.{Region}.{PartitionResult#dnsSuffix}", i],
+        [a, "FIPS is enabled but this partition does not support FIPS"],
+        ["https://geo.{Region}.{PartitionResult#dualStackDnsSuffix}", i],
+        [a, "DualStack is enabled but this partition does not support DualStack"],
+        ["https://geo.{Region}.{PartitionResult#dnsSuffix}", i],
+        [a, "Invalid Configuration: Missing Region"]
+    ]
+};
+const root = 2;
+const r = 100_000_000;
+const nodes = new Int32Array([
+    -1, 1, -1,
+    0, 12, 3,
+    1, 4, r + 11,
+    2, 5, r + 11,
+    3, 8, 6,
+    4, 7, r + 10,
+    5, r + 8, r + 9,
+    4, 10, 9,
+    6, r + 6, r + 7,
+    5, 11, r + 5,
+    6, r + 4, r + 5,
+    3, r + 1, 13,
+    4, r + 2, r + 3,
+]);
+exports.bdd = util_endpoints_1.BinaryDecisionDiagram.from(nodes, root, _data.conditions, _data.results);

package/dist-cjs/endpoint/endpointResolver.js

@@ -3,13 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultEndpointResolver = void 0;
 const util_endpoints_1 = require("@aws-sdk/util-endpoints");
 const util_endpoints_2 = require("@smithy/util-endpoints");
-const ruleset_1 = require("./ruleset");
+const bdd_1 = require("./bdd");
 const cache = new util_endpoints_2.EndpointCache({
     size: 50,
     params: ["Endpoint", "Region", "UseDualStack", "UseFIPS"],
 });
 const defaultEndpointResolver = (endpointParams, context = {}) => {
-    return cache.get(endpointParams, () => (0, util_endpoints_2.resolveEndpoint)(ruleset_1.ruleSet, {
+    return cache.get(endpointParams, () => (0, util_endpoints_2.decideEndpoint)(bdd_1.bdd, {
         endpointParams: endpointParams,
         logger: context.logger,
     }));

package/dist-cjs/index.js

@@ -16,6 +16,7 @@ var runtimeConfig = require('./runtimeConfig');
 var regionConfigResolver = require('@aws-sdk/region-config-resolver');
 var protocolHttp = require('@smithy/protocol-http');
 var schemas_0 = require('./schemas/schemas_0');
+var utilWaiter = require('@smithy/util-waiter');
 var errors = require('./models/errors');
 var LocationServiceException = require('./models/LocationServiceException');
 
@@ -221,6 +222,18 @@ class CalculateRouteMatrixCommand extends smithyClient.Command
     .build() {
 }
 
+class CancelJobCommand extends smithyClient.Command
+    .classBuilder()
+    .ep(commonParams)
+    .m(function (Command, cs, config, o) {
+    return [middlewareEndpoint.getEndpointPlugin(config, Command.getEndpointParameterInstructions())];
+})
+    .s("LocationService", "CancelJob", {})
+    .n("LocationClient", "CancelJobCommand")
+    .sc(schemas_0.CancelJob$)
+    .build() {
+}
+
 class CreateGeofenceCollectionCommand extends smithyClient.Command
     .classBuilder()
     .ep(commonParams)
@@ -497,6 +510,18 @@ class GetGeofenceCommand extends smithyClient.Command
     .build() {
 }
 
+class GetJobCommand extends smithyClient.Command
+    .classBuilder()
+    .ep(commonParams)
+    .m(function (Command, cs, config, o) {
+    return [middlewareEndpoint.getEndpointPlugin(config, Command.getEndpointParameterInstructions())];
+})
+    .s("LocationService", "GetJob", {})
+    .n("LocationClient", "GetJobCommand")
+    .sc(schemas_0.GetJob$)
+    .build() {
+}
+
 class GetMapGlyphsCommand extends smithyClient.Command
     .classBuilder()
     .ep(commonParams)
@@ -593,6 +618,18 @@ class ListGeofencesCommand extends smithyClient.Command
     .build() {
 }
 
+class ListJobsCommand extends smithyClient.Command
+    .classBuilder()
+    .ep(commonParams)
+    .m(function (Command, cs, config, o) {
+    return [middlewareEndpoint.getEndpointPlugin(config, Command.getEndpointParameterInstructions())];
+})
+    .s("LocationService", "ListJobs", {})
+    .n("LocationClient", "ListJobsCommand")
+    .sc(schemas_0.ListJobs$)
+    .build() {
+}
+
 class ListKeysCommand extends smithyClient.Command
     .classBuilder()
     .ep(commonParams)
@@ -725,6 +762,18 @@ class SearchPlaceIndexForTextCommand extends smithyClient.Command
     .build() {
 }
 
+class StartJobCommand extends smithyClient.Command
+    .classBuilder()
+    .ep(commonParams)
+    .m(function (Command, cs, config, o) {
+    return [middlewareEndpoint.getEndpointPlugin(config, Command.getEndpointParameterInstructions())];
+})
+    .s("LocationService", "StartJob", {})
+    .n("LocationClient", "StartJobCommand")
+    .sc(schemas_0.StartJob$)
+    .build() {
+}
+
 class TagResourceCommand extends smithyClient.Command
     .classBuilder()
     .ep(commonParams)
@@ -843,6 +892,8 @@ const paginateListGeofenceCollections = core.createPaginator(LocationClient, Lis
 
 const paginateListGeofences = core.createPaginator(LocationClient, ListGeofencesCommand, "NextToken", "NextToken", "MaxResults");
 
+const paginateListJobs = core.createPaginator(LocationClient, ListJobsCommand, "NextToken", "NextToken", "MaxResults");
+
 const paginateListKeys = core.createPaginator(LocationClient, ListKeysCommand, "NextToken", "NextToken", "MaxResults");
 
 const paginateListMaps = core.createPaginator(LocationClient, ListMapsCommand, "NextToken", "NextToken", "MaxResults");
@@ -855,6 +906,54 @@ const paginateListTrackerConsumers = core.createPaginator(LocationClient, ListTr
 
 const paginateListTrackers = core.createPaginator(LocationClient, ListTrackersCommand, "NextToken", "NextToken", "MaxResults");
 
+const checkState = async (client, input) => {
+    let reason;
+    try {
+        let result = await client.send(new GetJobCommand(input));
+        reason = result;
+        try {
+            const returnComparator = () => {
+                return result.Status;
+            };
+            if (returnComparator() === "Completed") {
+                return { state: utilWaiter.WaiterState.SUCCESS, reason };
+            }
+        }
+        catch (e) { }
+        try {
+            const returnComparator = () => {
+                return result.Status;
+            };
+            if (returnComparator() === "Failed") {
+                return { state: utilWaiter.WaiterState.FAILURE, reason };
+            }
+        }
+        catch (e) { }
+        try {
+            const returnComparator = () => {
+                return result.Status;
+            };
+            if (returnComparator() === "Cancelled") {
+                return { state: utilWaiter.WaiterState.FAILURE, reason };
+            }
+        }
+        catch (e) { }
+    }
+    catch (exception) {
+        reason = exception;
+    }
+    return { state: utilWaiter.WaiterState.RETRY, reason };
+};
+const waitForJobCompleted = async (params, input) => {
+    const serviceDefaults = { minDelay: 60, maxDelay: 120 };
+    return utilWaiter.createWaiter({ ...serviceDefaults, ...params }, input, checkState);
+};
+const waitUntilJobCompleted = async (params, input) => {
+    const serviceDefaults = { minDelay: 60, maxDelay: 120 };
+    const result = await utilWaiter.createWaiter({ ...serviceDefaults, ...params }, input, checkState);
+    return utilWaiter.checkExceptions(result);
+};
+
 const commands = {
     AssociateTrackerConsumerCommand,
     BatchDeleteDevicePositionHistoryCommand,
@@ -865,6 +964,7 @@ const commands = {
     BatchUpdateDevicePositionCommand,
     CalculateRouteCommand,
     CalculateRouteMatrixCommand,
+    CancelJobCommand,
     CreateGeofenceCollectionCommand,
     CreateKeyCommand,
     CreateMapCommand,
@@ -888,6 +988,7 @@ const commands = {
     GetDevicePositionCommand,
     GetDevicePositionHistoryCommand,
     GetGeofenceCommand,
+    GetJobCommand,
     GetMapGlyphsCommand,
     GetMapSpritesCommand,
     GetMapStyleDescriptorCommand,
@@ -896,6 +997,7 @@ const commands = {
     ListDevicePositionsCommand,
     ListGeofenceCollectionsCommand,
     ListGeofencesCommand,
+    ListJobsCommand,
     ListKeysCommand,
     ListMapsCommand,
     ListPlaceIndexesCommand,
@@ -907,6 +1009,7 @@ const commands = {
     SearchPlaceIndexForPositionCommand,
     SearchPlaceIndexForSuggestionsCommand,
     SearchPlaceIndexForTextCommand,
+    StartJobCommand,
     TagResourceCommand,
     UntagResourceCommand,
     UpdateGeofenceCollectionCommand,
@@ -923,6 +1026,7 @@ const paginators = {
     paginateListDevicePositions,
     paginateListGeofenceCollections,
     paginateListGeofences,
+    paginateListJobs,
     paginateListKeys,
     paginateListMaps,
     paginateListPlaceIndexes,
@@ -930,9 +1034,38 @@ const paginators = {
     paginateListTrackerConsumers,
     paginateListTrackers,
 };
+const waiters = {
+    waitUntilJobCompleted,
+};
 class Location extends LocationClient {
 }
-smithyClient.createAggregatedClient(commands, Location, { paginators });
+smithyClient.createAggregatedClient(commands, Location, { paginators, waiters });
+
+const JobStatus = {
+    CANCELLED: "Cancelled",
+    CANCELLING: "Cancelling",
+    COMPLETED: "Completed",
+    FAILED: "Failed",
+    PENDING: "Pending",
+    RUNNING: "Running",
+};
+const JobAction = {
+    VALIDATE_ADDRESS: "ValidateAddress",
+};
+const ValidateAddressAdditionalFeature = {
+    COUNTRY_SPECIFIC_ATTRIBUTES: "CountrySpecificAttributes",
+    POSITION: "Position",
+};
+const JobErrorCode = {
+    INTERNAL_SERVER_ERROR: "InternalServerError",
+    VALIDATION_ERROR: "ValidationError",
+};
+const JobInputFormat = {
+    PARQUET: "Parquet",
+};
+const JobOutputFormat = {
+    PARQUET: "Parquet",
+};
 
 exports.$Command = smithyClient.Command;
 exports.__Client = smithyClient.Client;
@@ -946,6 +1079,7 @@ exports.BatchPutGeofenceCommand = BatchPutGeofenceCommand;
 exports.BatchUpdateDevicePositionCommand = BatchUpdateDevicePositionCommand;
 exports.CalculateRouteCommand = CalculateRouteCommand;
 exports.CalculateRouteMatrixCommand = CalculateRouteMatrixCommand;
+exports.CancelJobCommand = CancelJobCommand;
 exports.CreateGeofenceCollectionCommand = CreateGeofenceCollectionCommand;
 exports.CreateKeyCommand = CreateKeyCommand;
 exports.CreateMapCommand = CreateMapCommand;
@@ -969,14 +1103,21 @@ exports.ForecastGeofenceEventsCommand = ForecastGeofenceEventsCommand;
 exports.GetDevicePositionCommand = GetDevicePositionCommand;
 exports.GetDevicePositionHistoryCommand = GetDevicePositionHistoryCommand;
 exports.GetGeofenceCommand = GetGeofenceCommand;
+exports.GetJobCommand = GetJobCommand;
 exports.GetMapGlyphsCommand = GetMapGlyphsCommand;
 exports.GetMapSpritesCommand = GetMapSpritesCommand;
 exports.GetMapStyleDescriptorCommand = GetMapStyleDescriptorCommand;
 exports.GetMapTileCommand = GetMapTileCommand;
 exports.GetPlaceCommand = GetPlaceCommand;
+exports.JobAction = JobAction;
+exports.JobErrorCode = JobErrorCode;
+exports.JobInputFormat = JobInputFormat;
+exports.JobOutputFormat = JobOutputFormat;
+exports.JobStatus = JobStatus;
 exports.ListDevicePositionsCommand = ListDevicePositionsCommand;
 exports.ListGeofenceCollectionsCommand = ListGeofenceCollectionsCommand;
 exports.ListGeofencesCommand = ListGeofencesCommand;
+exports.ListJobsCommand = ListJobsCommand;
 exports.ListKeysCommand = ListKeysCommand;
 exports.ListMapsCommand = ListMapsCommand;
 exports.ListPlaceIndexesCommand = ListPlaceIndexesCommand;
@@ -990,6 +1131,7 @@ exports.PutGeofenceCommand = PutGeofenceCommand;
 exports.SearchPlaceIndexForPositionCommand = SearchPlaceIndexForPositionCommand;
 exports.SearchPlaceIndexForSuggestionsCommand = SearchPlaceIndexForSuggestionsCommand;
 exports.SearchPlaceIndexForTextCommand = SearchPlaceIndexForTextCommand;
+exports.StartJobCommand = StartJobCommand;
 exports.TagResourceCommand = TagResourceCommand;
 exports.UntagResourceCommand = UntagResourceCommand;
 exports.UpdateGeofenceCollectionCommand = UpdateGeofenceCollectionCommand;
@@ -998,18 +1140,22 @@ exports.UpdateMapCommand = UpdateMapCommand;
 exports.UpdatePlaceIndexCommand = UpdatePlaceIndexCommand;
 exports.UpdateRouteCalculatorCommand = UpdateRouteCalculatorCommand;
 exports.UpdateTrackerCommand = UpdateTrackerCommand;
+exports.ValidateAddressAdditionalFeature = ValidateAddressAdditionalFeature;
 exports.VerifyDevicePositionCommand = VerifyDevicePositionCommand;
 exports.paginateForecastGeofenceEvents = paginateForecastGeofenceEvents;
 exports.paginateGetDevicePositionHistory = paginateGetDevicePositionHistory;
 exports.paginateListDevicePositions = paginateListDevicePositions;
 exports.paginateListGeofenceCollections = paginateListGeofenceCollections;
 exports.paginateListGeofences = paginateListGeofences;
+exports.paginateListJobs = paginateListJobs;
 exports.paginateListKeys = paginateListKeys;
 exports.paginateListMaps = paginateListMaps;
 exports.paginateListPlaceIndexes = paginateListPlaceIndexes;
 exports.paginateListRouteCalculators = paginateListRouteCalculators;
 exports.paginateListTrackerConsumers = paginateListTrackerConsumers;
 exports.paginateListTrackers = paginateListTrackers;
+exports.waitForJobCompleted = waitForJobCompleted;
+exports.waitUntilJobCompleted = waitUntilJobCompleted;
 Object.prototype.hasOwnProperty.call(schemas_0, '__proto__') &&
     !Object.prototype.hasOwnProperty.call(exports, '__proto__') &&
     Object.defineProperty(exports, '__proto__', {