@chaosity/location-client 0.11.0 → 0.13.0

package/dist/cjs/auth/TokenProvider.js

@@ -7,8 +7,14 @@ exports.TokenProvider = void 0;
 const debug_1 = __importDefault(require("debug"));
 const LocationServiceException_js_1 = require("../errors/LocationServiceException.js");
 const http_js_1 = require("../transport/http.js");
+const tokenHold_js_1 = require("./tokenHold.js");
 const tokenRefresh_js_1 = require("./tokenRefresh.js");
 const log = (0, debug_1.default)('location-client:auth');
+/**
+ * #63: how close to its own `exp` a cached token may still be sent when a
+ * refresh fails. A margin for the clocks of this host and the API to disagree.
+ */
+const EXPIRY_SKEW_MS = 5000;
 /**
  * TokenProvider - SERVER-SIDE ONLY
  *
@@ -39,6 +45,8 @@ const log = (0, debug_1.default)('location-client:auth');
  */
 class TokenProvider {
     constructor(config) {
+        /** A refusal or a Retry-After from `/auth/token`, until it lapses (#38). */
+        this.hold = new tokenHold_js_1.TokenHold();
         // Runtime check: prevent usage in browser
         if (typeof window !== 'undefined') {
             throw new Error('TokenProvider cannot be used in browser environments. ' +
@@ -48,7 +56,7 @@ class TokenProvider {
         log('Initializing TokenProvider for %s', config.apiUrl);
         this.config = config;
     }
-    async getToken(forceRefresh = false) {
+    async getToken(forceRefresh = false, options = {}) {
         if (!forceRefresh && this.cachedToken && !this.isExpired()) {
             const expiresIn = this.cachedExpiresAt
                 ? Math.floor((this.cachedExpiresAt - Date.now()) / 1000)
@@ -60,10 +68,27 @@ class TokenProvider {
                 expiresAt: this.cachedExpiresAt,
             };
         }
+        // The endpoint refused these credentials, or asked us to wait, a moment
+        // ago: answer with that rather than ask again (#38). Forced or not — a
+        // forced refresh asks for a different token, and these credentials will
+        // not get one until the hold lapses.
+        const held = this.hold.check()?.error;
+        if (held) {
+            log('Token request held: %s', held.message);
+            const fallback = this.fallback(forceRefresh, options, held);
+            if (fallback)
+                return fallback;
+            throw held;
+        }
         // If token fetch is already in progress, wait for it
         if (this.tokenPromise) {
             log('Token fetch in progress, waiting for existing request...');
-            return this.tokenPromise;
+            return this.tokenPromise.catch((error) => {
+                const fallback = this.fallback(forceRefresh, options, error);
+                if (fallback)
+                    return fallback;
+                throw error;
+            });
         }
         // Start new token fetch
         const reason = forceRefresh
@@ -77,6 +102,12 @@ class TokenProvider {
             const result = await this.tokenPromise;
             return result;
         }
+        catch (error) {
+            const fallback = this.fallback(forceRefresh, options, error);
+            if (fallback)
+                return fallback;
+            throw error;
+        }
         finally {
             // Clear promise after completion (success or failure)
             this.tokenPromise = undefined;
@@ -99,16 +130,32 @@ class TokenProvider {
     async fetchToken() {
         const { clientId, clientSecret, apiUrl } = this.config;
         const credentials = btoa(`${clientId}:${clientSecret}`);
-        const data = await (0, http_js_1.requestJson)(`${apiUrl}/auth/token`, {
-            method: 'POST',
-            headers: {
-                Authorization: `Basic ${credentials}`,
-                'Content-Type': 'application/x-www-form-urlencoded',
-            },
-            body: new URLSearchParams({
-                grant_type: 'client_credentials',
-            }).toString(),
-        }, { retry: { maxAttempts: 3 } });
+        let data;
+        try {
+            data = await (0, http_js_1.requestJson)(`${apiUrl}/auth/token`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Basic ${credentials}`,
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body: new URLSearchParams({
+                    grant_type: 'client_credentials',
+                }).toString(),
+            }, { retry: { maxAttempts: 3 } });
+        }
+        catch (error) {
+            // Remembered, so the next call is answered without a request (#38), and
+            // a Retry-After is honoured across calls rather than only within this
+            // one (#63).
+            this.hold.remember(error);
+            // A refusal is about the credentials, so every token they minted is
+            // refused too — a suspended application's on its next use, a rotated
+            // secret's at once. Never hand the cached one out again. A Retry-After
+            // says nothing about it, and keeps it.
+            if ((0, tokenHold_js_1.isTokenRefusal)(error))
+                this.clearCache();
+            throw error;
+        }
         if (!data.access_token) {
             throw new LocationServiceException_js_1.LocationServiceException({
                 code: 'InvalidCredentialsException',
@@ -116,6 +163,7 @@ class TokenProvider {
                 details: { source: 'client' },
             });
         }
+        this.hold.forget();
         this.cachedToken = data.access_token;
         // The token's own `exp` claim first — it is the only value that cannot
         // disagree with what the API will actually accept. `expires_at` and
@@ -131,6 +179,27 @@ class TokenProvider {
             expiresAt: this.cachedExpiresAt,
         };
     }
+    /**
+     * #63: the cached token, when the caller asked for it and the failure is one
+     * that waiting fixes. A refusal has already cleared the cache in fetchToken,
+     * so it can never be the cached token handed back here.
+     */
+    fallback(forceRefresh, options, error) {
+        if (forceRefresh || !options.cachedUntilExpiry)
+            return undefined;
+        if ((0, tokenHold_js_1.isTokenRefusal)(error))
+            return undefined;
+        if (!this.cachedToken || !this.cachedExpiresAt)
+            return undefined;
+        if (Date.now() >= this.cachedExpiresAt - EXPIRY_SKEW_MS)
+            return undefined;
+        log('Refresh failed (%s); the cached token is valid for %ds more, sending it', error instanceof Error ? error.message : String(error), Math.floor((this.cachedExpiresAt - Date.now()) / 1000));
+        return {
+            success: true,
+            token: this.cachedToken,
+            expiresAt: this.cachedExpiresAt,
+        };
+    }
     isExpired(bufferSeconds = tokenRefresh_js_1.TOKEN_REFRESH_BUFFER_SECONDS) {
         if (!this.cachedExpiresAt)
             return true;

package/dist/cjs/auth/tokenHold.d.ts

@@ -0,0 +1,81 @@
+import { LocationServiceException } from '../errors/LocationServiceException.js';
+/**
+ * How long a refusal is remembered: a token the API refused, or a token
+ * request `/auth/token` refused (#38).
+ *
+ * A refusal — a 401 or a 403 — is not something asking again can change. A
+ * suspended application is refused on every data route and on `/auth/token`
+ * alike, and nothing used to remember that, so every request a busy server
+ * served paid for a doomed data request and a doomed token request, all
+ * against the application's own token-route throttle.
+ *
+ * Thirty seconds is short beside the API's own waits: it accepts a
+ * reactivated application again within five minutes, and refuses a newly
+ * created or reactivated one for up to about thirty seconds while its key goes
+ * live. So this side adds at most thirty seconds to either, and turns a
+ * request rate into a trickle meanwhile.
+ */
+export declare const TOKEN_REFUSAL_HOLD_MS = 30000;
+/**
+ * A 401 or a 403: the server refused, and a retry gets the same answer.
+ *
+ * Wider than `isTokenRejected`, which is the 401 a new token can fix. This is
+ * about the token SOURCE: `/auth/token` refusing the credentials (401), or
+ * the application's key not live on its plan (403), and neither changes by
+ * asking again.
+ */
+export declare function isTokenRefusal(err: unknown): boolean;
+/**
+ * How long `err` says asking again cannot help, in milliseconds; 0 when it
+ * says nothing, and the next call may ask at once.
+ *
+ * Only the server's own word counts: a refusal, or a `Retry-After`. A network
+ * fault, a timeout or a 500 carries neither, so it is not remembered, and the
+ * next call tries again as it always has — the transport has already retried
+ * it with backoff inside the call that failed.
+ */
+export declare function holdFor(err: unknown): number;
+/**
+ * One remembered failure, re-thrown instead of asking again until it lapses.
+ *
+ * Shared by every place that used to ask again on every call: the server
+ * `TokenProvider` (a refused or throttled token request), and the two send
+ * paths (a token the API refused, and the refresh that could not replace it,
+ * or — in `GeoPlacesClient` — could not supply a first one). A send path
+ * remembers the failure against the token it concerns, because a DIFFERENT
+ * token is a new situation — a background refresh that landed, or a caller's
+ * own source that moved on — and ends the hold at once.
+ *
+ * `askAgain` is the one case where the source may still be asked: the API
+ * refused the token, and the refresh that followed failed with nothing to say
+ * about when to try again — a network fault, or a rejection that lost its
+ * fields crossing a Server Action boundary, as `@chaosity/location-client-react`
+ * delivers one. The token is still refused, so it is not sent again; the
+ * source is asked on the next send, as it always was.
+ */
+export declare class TokenHold {
+    private held?;
+    /** Remember `err` for as long as it says; a failure that says nothing is not remembered. */
+    remember(err: unknown, token?: string, { askAgain }?: {
+        askAgain?: boolean | undefined;
+    }): void;
+    /**
+     * The remembered failure while it stands, as a new exception to throw — for
+     * `token`, if one was remembered with it — and whether the source may still
+     * be asked. Anything else ends the hold.
+     */
+    check(token?: string): {
+        error: LocationServiceException;
+        askAgain: boolean;
+    } | undefined;
+    forget(): void;
+}
+/**
+ * Send with `token`, and after a 401 once more with `refresh()`'s token when it
+ * is a DIFFERENT one, remembering on `hold` what the API and the source said,
+ * against the token it concerns (#38).
+ *
+ * The one copy of the 401 retry: both send paths and the two map fetches (#72)
+ * call it, so when to ask again is decided here and nowhere else.
+ */
+export declare function sendRetryingOnce<T>(hold: TokenHold, token: string, send: (token: string) => Promise<T>, refresh: () => Promise<string | undefined>, onRetry?: () => void): Promise<T>;

package/dist/cjs/auth/tokenHold.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenHold = exports.TOKEN_REFUSAL_HOLD_MS = void 0;
+exports.isTokenRefusal = isTokenRefusal;
+exports.holdFor = holdFor;
+exports.sendRetryingOnce = sendRetryingOnce;
+const LocationServiceException_js_1 = require("../errors/LocationServiceException.js");
+const errors_js_1 = require("../transport/errors.js");
+/**
+ * How long a refusal is remembered: a token the API refused, or a token
+ * request `/auth/token` refused (#38).
+ *
+ * A refusal — a 401 or a 403 — is not something asking again can change. A
+ * suspended application is refused on every data route and on `/auth/token`
+ * alike, and nothing used to remember that, so every request a busy server
+ * served paid for a doomed data request and a doomed token request, all
+ * against the application's own token-route throttle.
+ *
+ * Thirty seconds is short beside the API's own waits: it accepts a
+ * reactivated application again within five minutes, and refuses a newly
+ * created or reactivated one for up to about thirty seconds while its key goes
+ * live. So this side adds at most thirty seconds to either, and turns a
+ * request rate into a trickle meanwhile.
+ */
+exports.TOKEN_REFUSAL_HOLD_MS = 30000;
+/**
+ * A 401 or a 403: the server refused, and a retry gets the same answer.
+ *
+ * Wider than `isTokenRejected`, which is the 401 a new token can fix. This is
+ * about the token SOURCE: `/auth/token` refusing the credentials (401), or
+ * the application's key not live on its plan (403), and neither changes by
+ * asking again.
+ */
+function isTokenRefusal(err) {
+    return (err instanceof LocationServiceException_js_1.LocationServiceException &&
+        (err.statusCode === 401 || err.statusCode === 403));
+}
+/**
+ * How long `err` says asking again cannot help, in milliseconds; 0 when it
+ * says nothing, and the next call may ask at once.
+ *
+ * Only the server's own word counts: a refusal, or a `Retry-After`. A network
+ * fault, a timeout or a 500 carries neither, so it is not remembered, and the
+ * next call tries again as it always has — the transport has already retried
+ * it with backoff inside the call that failed.
+ */
+function holdFor(err) {
+    if (!(err instanceof LocationServiceException_js_1.LocationServiceException))
+        return 0;
+    return Math.max(isTokenRefusal(err) ? exports.TOKEN_REFUSAL_HOLD_MS : 0, err.retryAfterMs ?? 0);
+}
+/**
+ * One remembered failure, re-thrown instead of asking again until it lapses.
+ *
+ * Shared by every place that used to ask again on every call: the server
+ * `TokenProvider` (a refused or throttled token request), and the two send
+ * paths (a token the API refused, and the refresh that could not replace it,
+ * or — in `GeoPlacesClient` — could not supply a first one). A send path
+ * remembers the failure against the token it concerns, because a DIFFERENT
+ * token is a new situation — a background refresh that landed, or a caller's
+ * own source that moved on — and ends the hold at once.
+ *
+ * `askAgain` is the one case where the source may still be asked: the API
+ * refused the token, and the refresh that followed failed with nothing to say
+ * about when to try again — a network fault, or a rejection that lost its
+ * fields crossing a Server Action boundary, as `@chaosity/location-client-react`
+ * delivers one. The token is still refused, so it is not sent again; the
+ * source is asked on the next send, as it always was.
+ */
+class TokenHold {
+    /** Remember `err` for as long as it says; a failure that says nothing is not remembered. */
+    remember(err, token, { askAgain = false } = {}) {
+        const ms = holdFor(err);
+        if (ms > 0) {
+            this.held = {
+                error: err,
+                until: Date.now() + ms,
+                token,
+                askAgain,
+            };
+        }
+    }
+    /**
+     * The remembered failure while it stands, as a new exception to throw — for
+     * `token`, if one was remembered with it — and whether the source may still
+     * be asked. Anything else ends the hold.
+     */
+    check(token) {
+        const held = this.held;
+        if (!held)
+            return undefined;
+        const remaining = held.until - Date.now();
+        if (remaining <= 0 || (held.token !== undefined && held.token !== token)) {
+            this.held = undefined;
+            return undefined;
+        }
+        const { error, askAgain } = held;
+        return {
+            askAgain,
+            error: new LocationServiceException_js_1.LocationServiceException({
+                code: error.code,
+                message: error.message,
+                statusCode: error.statusCode,
+                requestId: error.requestId,
+                details: error.details,
+                // What is left of a Retry-After, so a caller that schedules on it waits
+                // the right amount. A refusal carries none, and gains none here.
+                retryAfterMs: error.retryAfterMs === undefined ? undefined : remaining,
+                cause: error,
+            }),
+        };
+    }
+    forget() {
+        this.held = undefined;
+    }
+}
+exports.TokenHold = TokenHold;
+/**
+ * Send with `token`, and after a 401 once more with `refresh()`'s token when it
+ * is a DIFFERENT one, remembering on `hold` what the API and the source said,
+ * against the token it concerns (#38).
+ *
+ * The one copy of the 401 retry: both send paths and the two map fetches (#72)
+ * call it, so when to ask again is decided here and nowhere else.
+ */
+async function sendRetryingOnce(hold, token, send, refresh, onRetry) {
+    // This token was refused a moment ago and nothing has replaced it: answer
+    // with that refusal rather than send it, and ask the source again. A
+    // different token ends the hold. When the refresh that followed said nothing
+    // about when to ask again, it is asked now — but the refused token is still
+    // not sent.
+    const held = hold.check(token);
+    if (held && !held.askAgain)
+        throw held.error;
+    let rejected = held?.error;
+    if (!held) {
+        try {
+            return await send(token);
+        }
+        catch (err) {
+            if (!(0, errors_js_1.isTokenRejected)(err))
+                throw err;
+            rejected = err;
+        }
+    }
+    // One retry, and only when the replacement is genuinely a different token.
+    // That single comparison covers every source: a fixed `token` string, a
+    // `getToken` that ignores `forceRefresh`, a `refreshToken` that hands back
+    // what it had, and a cached token the API has revoked before its `exp` —
+    // re-sending any of them is a second doomed request for the same answer.
+    let fresh;
+    try {
+        fresh = await refresh();
+    }
+    catch (refusal) {
+        // A rotated secret's token route refuses the refresh as the data route
+        // refused its token. Without this, every send asked again. A refusal that
+        // says nothing — a network fault, or a Server Action's error without its
+        // fields — leaves the source to be asked again, but not the token sent.
+        if (holdFor(refusal) > 0)
+            hold.remember(refusal, token);
+        // Only when no hold stands: one already standing keeps its own end, so
+        // the refused token is tried again once per hold rather than never.
+        else if (!held)
+            hold.remember(rejected, token, { askAgain: true });
+        throw refusal;
+    }
+    if (!fresh || fresh === token) {
+        hold.remember(rejected, token);
+        throw rejected;
+    }
+    onRetry?.();
+    try {
+        return await send(fresh);
+    }
+    catch (again) {
+        if ((0, errors_js_1.isTokenRejected)(again))
+            hold.remember(again, fresh);
+        throw again;
+    }
+}

package/dist/cjs/aws.d.ts

@@ -0,0 +1,4 @@
+export type * from '@aws-sdk/client-geo-places';
+export { $Command, AccessDeniedException, AccessDeniedException$, AccessPoint$, AccessPointType, AccessRestriction$, Address$, AddressComponentMatchScores$, AddressComponentPhonemes$, AddressTranslationComponent, AdminNames$, AdminNamesPreference, Autocomplete$, AutocompleteAdditionalFeature, AutocompleteAddressHighlights$, AutocompleteFilter$, AutocompleteFilterPlaceType, AutocompleteHighlights$, AutocompleteIntendedUse, AutocompleteRequest$, AutocompleteResponse$, AutocompleteResultItem$, BusinessChain$, Category$, ComponentMatchScores$, ContactDetails$, Contacts$, Country$, CountryHighlights$, CrossReference$, FilterCircle$, FoodType$, GeoPlacesServiceException, GeoPlacesServiceException$, Geocode$, GeocodeAdditionalFeature, GeocodeAddressNamesMode, GeocodeFilter$, GeocodeFilterPlaceType, GeocodeIntendedUse, GeocodeParsedQuery$, GeocodeParsedQueryAddressComponents$, GeocodeQueryComponents$, GeocodeRequest$, GeocodeResponse$, GeocodeResultItem$, GetPlace$, GetPlaceAdditionalFeature, GetPlaceAddressNamesMode, GetPlaceIntendedUse, GetPlaceRequest$, GetPlaceResponse$, Highlight$, InternalServerException, InternalServerException$, Intersection$, MatchScoreDetails$, OpeningHours$, OpeningHoursComponents$, ParsedQueryComponent$, ParsedQuerySecondaryAddressComponent$, PhonemeDetails$, PhonemeTranscription$, PlaceAttribute, PlaceType, PostalAuthority, PostalCodeDetails$, PostalCodeMode, PostalCodeType, QueryRefinement$, QueryType, RecordTypeCode, Region$, RegionHighlights$, RelatedPlace$, ReverseGeocode$, ReverseGeocodeAdditionalFeature, ReverseGeocodeAddressNamesMode, ReverseGeocodeFilter$, ReverseGeocodeFilterPlaceType, ReverseGeocodeIntendedUse, ReverseGeocodeRequest$, ReverseGeocodeResponse$, ReverseGeocodeResultItem$, SearchNearby$, SearchNearbyAdditionalFeature, SearchNearbyFilter$, SearchNearbyIntendedUse, SearchNearbyRequest$, SearchNearbyResponse$, SearchNearbyResultItem$, SearchText$, SearchTextAdditionalFeature, SearchTextFilter$, SearchTextIntendedUse, SearchTextRequest$, SearchTextResponse$, SearchTextResultItem$, SearchTextTravelMode, SecondaryAddressComponent$, SecondaryAddressComponentMatchScore$, StreetComponents$, SubRegion$, SubRegionHighlights$, Suggest$, SuggestAdditionalFeature, SuggestAddressHighlights$, SuggestFilter$, SuggestHighlights$, SuggestIntendedUse, SuggestPlaceResult$, SuggestQueryResult$, SuggestRequest$, SuggestResponse$, SuggestResultItem$, SuggestResultItemType, SuggestTravelMode, ThrottlingException, ThrottlingException$, TimeZone$, TranslationDetails$, TranslationName$, TranslationNameType, TypePlacement, UspsZip$, UspsZipPlus4$, ValidationException, ValidationException$, ValidationExceptionField$, ValidationExceptionReason, ZipClassificationCode, __Client, errorTypeRegistries, } from '@aws-sdk/client-geo-places';
+export type * from '@aws/amazon-location-utilities-datatypes';
+export { calculateIsolinesResponseToFeatureCollection, calculateRoutesResponseToFeatureCollections, devicePositionsToFeatureCollection, featureCollectionToGeofence, geocodeResponseToFeatureCollection, geofencesToFeatureCollection, getPlaceResponseToFeatureCollection, optimizeWaypointsResponseToFeatureCollection, placeToFeatureCollection, reverseGeocodeResponseToFeatureCollection, routeToFeatureCollection, searchNearbyResponseToFeatureCollection, searchTextResponseToFeatureCollection, snapToRoadsResponseToFeatureCollection, suggestResponseToFeatureCollection, } from '@aws/amazon-location-utilities-datatypes';

package/dist/cjs/aws.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetPlaceIntendedUse = exports.GetPlaceAddressNamesMode = exports.GetPlaceAdditionalFeature = exports.GetPlace$ = exports.GeocodeResultItem$ = exports.GeocodeResponse$ = exports.GeocodeRequest$ = exports.GeocodeQueryComponents$ = exports.GeocodeParsedQueryAddressComponents$ = exports.GeocodeParsedQuery$ = exports.GeocodeIntendedUse = exports.GeocodeFilterPlaceType = exports.GeocodeFilter$ = exports.GeocodeAddressNamesMode = exports.GeocodeAdditionalFeature = exports.Geocode$ = exports.GeoPlacesServiceException$ = exports.GeoPlacesServiceException = exports.FoodType$ = exports.FilterCircle$ = exports.CrossReference$ = exports.CountryHighlights$ = exports.Country$ = exports.Contacts$ = exports.ContactDetails$ = exports.ComponentMatchScores$ = exports.Category$ = exports.BusinessChain$ = exports.AutocompleteResultItem$ = exports.AutocompleteResponse$ = exports.AutocompleteRequest$ = exports.AutocompleteIntendedUse = exports.AutocompleteHighlights$ = exports.AutocompleteFilterPlaceType = exports.AutocompleteFilter$ = exports.AutocompleteAddressHighlights$ = exports.AutocompleteAdditionalFeature = exports.Autocomplete$ = exports.AdminNamesPreference = exports.AdminNames$ = exports.AddressTranslationComponent = exports.AddressComponentPhonemes$ = exports.AddressComponentMatchScores$ = exports.Address$ = exports.AccessRestriction$ = exports.AccessPointType = exports.AccessPoint$ = exports.AccessDeniedException$ = exports.AccessDeniedException = exports.$Command = void 0;
+exports.SecondaryAddressComponent$ = exports.SearchTextTravelMode = exports.SearchTextResultItem$ = exports.SearchTextResponse$ = exports.SearchTextRequest$ = exports.SearchTextIntendedUse = exports.SearchTextFilter$ = exports.SearchTextAdditionalFeature = exports.SearchText$ = exports.SearchNearbyResultItem$ = exports.SearchNearbyResponse$ = exports.SearchNearbyRequest$ = exports.SearchNearbyIntendedUse = exports.SearchNearbyFilter$ = exports.SearchNearbyAdditionalFeature = exports.SearchNearby$ = exports.ReverseGeocodeResultItem$ = exports.ReverseGeocodeResponse$ = exports.ReverseGeocodeRequest$ = exports.ReverseGeocodeIntendedUse = exports.ReverseGeocodeFilterPlaceType = exports.ReverseGeocodeFilter$ = exports.ReverseGeocodeAddressNamesMode = exports.ReverseGeocodeAdditionalFeature = exports.ReverseGeocode$ = exports.RelatedPlace$ = exports.RegionHighlights$ = exports.Region$ = exports.RecordTypeCode = exports.QueryType = exports.QueryRefinement$ = exports.PostalCodeType = exports.PostalCodeMode = exports.PostalCodeDetails$ = exports.PostalAuthority = exports.PlaceType = exports.PlaceAttribute = exports.PhonemeTranscription$ = exports.PhonemeDetails$ = exports.ParsedQuerySecondaryAddressComponent$ = exports.ParsedQueryComponent$ = exports.OpeningHoursComponents$ = exports.OpeningHours$ = exports.MatchScoreDetails$ = exports.Intersection$ = exports.InternalServerException$ = exports.InternalServerException = exports.Highlight$ = exports.GetPlaceResponse$ = exports.GetPlaceRequest$ = void 0;
+exports.suggestResponseToFeatureCollection = exports.snapToRoadsResponseToFeatureCollection = exports.searchTextResponseToFeatureCollection = exports.searchNearbyResponseToFeatureCollection = exports.routeToFeatureCollection = exports.reverseGeocodeResponseToFeatureCollection = exports.placeToFeatureCollection = exports.optimizeWaypointsResponseToFeatureCollection = exports.getPlaceResponseToFeatureCollection = exports.geofencesToFeatureCollection = exports.geocodeResponseToFeatureCollection = exports.featureCollectionToGeofence = exports.devicePositionsToFeatureCollection = exports.calculateRoutesResponseToFeatureCollections = exports.calculateIsolinesResponseToFeatureCollection = exports.errorTypeRegistries = exports.__Client = exports.ZipClassificationCode = exports.ValidationExceptionReason = exports.ValidationExceptionField$ = exports.ValidationException$ = exports.ValidationException = exports.UspsZipPlus4$ = exports.UspsZip$ = exports.TypePlacement = exports.TranslationNameType = exports.TranslationName$ = exports.TranslationDetails$ = exports.TimeZone$ = exports.ThrottlingException$ = exports.ThrottlingException = exports.SuggestTravelMode = exports.SuggestResultItemType = exports.SuggestResultItem$ = exports.SuggestResponse$ = exports.SuggestRequest$ = exports.SuggestQueryResult$ = exports.SuggestPlaceResult$ = exports.SuggestIntendedUse = exports.SuggestHighlights$ = exports.SuggestFilter$ = exports.SuggestAddressHighlights$ = exports.SuggestAdditionalFeature = exports.Suggest$ = exports.SubRegionHighlights$ = exports.SubRegion$ = exports.StreetComponents$ = exports.SecondaryAddressComponentMatchScore$ = void 0;
+var client_geo_places_1 = require("@aws-sdk/client-geo-places");
+Object.defineProperty(exports, "$Command", { enumerable: true, get: function () { return client_geo_places_1.$Command; } });
+Object.defineProperty(exports, "AccessDeniedException", { enumerable: true, get: function () { return client_geo_places_1.AccessDeniedException; } });
+Object.defineProperty(exports, "AccessDeniedException$", { enumerable: true, get: function () { return client_geo_places_1.AccessDeniedException$; } });
+Object.defineProperty(exports, "AccessPoint$", { enumerable: true, get: function () { return client_geo_places_1.AccessPoint$; } });
+Object.defineProperty(exports, "AccessPointType", { enumerable: true, get: function () { return client_geo_places_1.AccessPointType; } });
+Object.defineProperty(exports, "AccessRestriction$", { enumerable: true, get: function () { return client_geo_places_1.AccessRestriction$; } });
+Object.defineProperty(exports, "Address$", { enumerable: true, get: function () { return client_geo_places_1.Address$; } });
+Object.defineProperty(exports, "AddressComponentMatchScores$", { enumerable: true, get: function () { return client_geo_places_1.AddressComponentMatchScores$; } });
+Object.defineProperty(exports, "AddressComponentPhonemes$", { enumerable: true, get: function () { return client_geo_places_1.AddressComponentPhonemes$; } });
+Object.defineProperty(exports, "AddressTranslationComponent", { enumerable: true, get: function () { return client_geo_places_1.AddressTranslationComponent; } });
+Object.defineProperty(exports, "AdminNames$", { enumerable: true, get: function () { return client_geo_places_1.AdminNames$; } });
+Object.defineProperty(exports, "AdminNamesPreference", { enumerable: true, get: function () { return client_geo_places_1.AdminNamesPreference; } });
+Object.defineProperty(exports, "Autocomplete$", { enumerable: true, get: function () { return client_geo_places_1.Autocomplete$; } });
+Object.defineProperty(exports, "AutocompleteAdditionalFeature", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteAdditionalFeature; } });
+Object.defineProperty(exports, "AutocompleteAddressHighlights$", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteAddressHighlights$; } });
+Object.defineProperty(exports, "AutocompleteFilter$", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteFilter$; } });
+Object.defineProperty(exports, "AutocompleteFilterPlaceType", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteFilterPlaceType; } });
+Object.defineProperty(exports, "AutocompleteHighlights$", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteHighlights$; } });
+Object.defineProperty(exports, "AutocompleteIntendedUse", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteIntendedUse; } });
+Object.defineProperty(exports, "AutocompleteRequest$", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteRequest$; } });
+Object.defineProperty(exports, "AutocompleteResponse$", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteResponse$; } });
+Object.defineProperty(exports, "AutocompleteResultItem$", { enumerable: true, get: function () { return client_geo_places_1.AutocompleteResultItem$; } });
+Object.defineProperty(exports, "BusinessChain$", { enumerable: true, get: function () { return client_geo_places_1.BusinessChain$; } });
+Object.defineProperty(exports, "Category$", { enumerable: true, get: function () { return client_geo_places_1.Category$; } });
+Object.defineProperty(exports, "ComponentMatchScores$", { enumerable: true, get: function () { return client_geo_places_1.ComponentMatchScores$; } });
+Object.defineProperty(exports, "ContactDetails$", { enumerable: true, get: function () { return client_geo_places_1.ContactDetails$; } });
+Object.defineProperty(exports, "Contacts$", { enumerable: true, get: function () { return client_geo_places_1.Contacts$; } });
+Object.defineProperty(exports, "Country$", { enumerable: true, get: function () { return client_geo_places_1.Country$; } });
+Object.defineProperty(exports, "CountryHighlights$", { enumerable: true, get: function () { return client_geo_places_1.CountryHighlights$; } });
+Object.defineProperty(exports, "CrossReference$", { enumerable: true, get: function () { return client_geo_places_1.CrossReference$; } });
+Object.defineProperty(exports, "FilterCircle$", { enumerable: true, get: function () { return client_geo_places_1.FilterCircle$; } });
+Object.defineProperty(exports, "FoodType$", { enumerable: true, get: function () { return client_geo_places_1.FoodType$; } });
+Object.defineProperty(exports, "GeoPlacesServiceException", { enumerable: true, get: function () { return client_geo_places_1.GeoPlacesServiceException; } });
+Object.defineProperty(exports, "GeoPlacesServiceException$", { enumerable: true, get: function () { return client_geo_places_1.GeoPlacesServiceException$; } });
+Object.defineProperty(exports, "Geocode$", { enumerable: true, get: function () { return client_geo_places_1.Geocode$; } });
+Object.defineProperty(exports, "GeocodeAdditionalFeature", { enumerable: true, get: function () { return client_geo_places_1.GeocodeAdditionalFeature; } });
+Object.defineProperty(exports, "GeocodeAddressNamesMode", { enumerable: true, get: function () { return client_geo_places_1.GeocodeAddressNamesMode; } });
+Object.defineProperty(exports, "GeocodeFilter$", { enumerable: true, get: function () { return client_geo_places_1.GeocodeFilter$; } });
+Object.defineProperty(exports, "GeocodeFilterPlaceType", { enumerable: true, get: function () { return client_geo_places_1.GeocodeFilterPlaceType; } });
+Object.defineProperty(exports, "GeocodeIntendedUse", { enumerable: true, get: function () { return client_geo_places_1.GeocodeIntendedUse; } });
+Object.defineProperty(exports, "GeocodeParsedQuery$", { enumerable: true, get: function () { return client_geo_places_1.GeocodeParsedQuery$; } });
+Object.defineProperty(exports, "GeocodeParsedQueryAddressComponents$", { enumerable: true, get: function () { return client_geo_places_1.GeocodeParsedQueryAddressComponents$; } });
+Object.defineProperty(exports, "GeocodeQueryComponents$", { enumerable: true, get: function () { return client_geo_places_1.GeocodeQueryComponents$; } });
+Object.defineProperty(exports, "GeocodeRequest$", { enumerable: true, get: function () { return client_geo_places_1.GeocodeRequest$; } });
+Object.defineProperty(exports, "GeocodeResponse$", { enumerable: true, get: function () { return client_geo_places_1.GeocodeResponse$; } });
+Object.defineProperty(exports, "GeocodeResultItem$", { enumerable: true, get: function () { return client_geo_places_1.GeocodeResultItem$; } });
+Object.defineProperty(exports, "GetPlace$", { enumerable: true, get: function () { return client_geo_places_1.GetPlace$; } });
+Object.defineProperty(exports, "GetPlaceAdditionalFeature", { enumerable: true, get: function () { return client_geo_places_1.GetPlaceAdditionalFeature; } });
+Object.defineProperty(exports, "GetPlaceAddressNamesMode", { enumerable: true, get: function () { return client_geo_places_1.GetPlaceAddressNamesMode; } });
+Object.defineProperty(exports, "GetPlaceIntendedUse", { enumerable: true, get: function () { return client_geo_places_1.GetPlaceIntendedUse; } });
+Object.defineProperty(exports, "GetPlaceRequest$", { enumerable: true, get: function () { return client_geo_places_1.GetPlaceRequest$; } });
+Object.defineProperty(exports, "GetPlaceResponse$", { enumerable: true, get: function () { return client_geo_places_1.GetPlaceResponse$; } });
+Object.defineProperty(exports, "Highlight$", { enumerable: true, get: function () { return client_geo_places_1.Highlight$; } });
+Object.defineProperty(exports, "InternalServerException", { enumerable: true, get: function () { return client_geo_places_1.InternalServerException; } });
+Object.defineProperty(exports, "InternalServerException$", { enumerable: true, get: function () { return client_geo_places_1.InternalServerException$; } });
+Object.defineProperty(exports, "Intersection$", { enumerable: true, get: function () { return client_geo_places_1.Intersection$; } });
+Object.defineProperty(exports, "MatchScoreDetails$", { enumerable: true, get: function () { return client_geo_places_1.MatchScoreDetails$; } });
+Object.defineProperty(exports, "OpeningHours$", { enumerable: true, get: function () { return client_geo_places_1.OpeningHours$; } });
+Object.defineProperty(exports, "OpeningHoursComponents$", { enumerable: true, get: function () { return client_geo_places_1.OpeningHoursComponents$; } });
+Object.defineProperty(exports, "ParsedQueryComponent$", { enumerable: true, get: function () { return client_geo_places_1.ParsedQueryComponent$; } });
+Object.defineProperty(exports, "ParsedQuerySecondaryAddressComponent$", { enumerable: true, get: function () { return client_geo_places_1.ParsedQuerySecondaryAddressComponent$; } });
+Object.defineProperty(exports, "PhonemeDetails$", { enumerable: true, get: function () { return client_geo_places_1.PhonemeDetails$; } });
+Object.defineProperty(exports, "PhonemeTranscription$", { enumerable: true, get: function () { return client_geo_places_1.PhonemeTranscription$; } });
+Object.defineProperty(exports, "PlaceAttribute", { enumerable: true, get: function () { return client_geo_places_1.PlaceAttribute; } });
+Object.defineProperty(exports, "PlaceType", { enumerable: true, get: function () { return client_geo_places_1.PlaceType; } });
+Object.defineProperty(exports, "PostalAuthority", { enumerable: true, get: function () { return client_geo_places_1.PostalAuthority; } });
+Object.defineProperty(exports, "PostalCodeDetails$", { enumerable: true, get: function () { return client_geo_places_1.PostalCodeDetails$; } });
+Object.defineProperty(exports, "PostalCodeMode", { enumerable: true, get: function () { return client_geo_places_1.PostalCodeMode; } });
+Object.defineProperty(exports, "PostalCodeType", { enumerable: true, get: function () { return client_geo_places_1.PostalCodeType; } });
+Object.defineProperty(exports, "QueryRefinement$", { enumerable: true, get: function () { return client_geo_places_1.QueryRefinement$; } });
+Object.defineProperty(exports, "QueryType", { enumerable: true, get: function () { return client_geo_places_1.QueryType; } });
+Object.defineProperty(exports, "RecordTypeCode", { enumerable: true, get: function () { return client_geo_places_1.RecordTypeCode; } });
+Object.defineProperty(exports, "Region$", { enumerable: true, get: function () { return client_geo_places_1.Region$; } });
+Object.defineProperty(exports, "RegionHighlights$", { enumerable: true, get: function () { return client_geo_places_1.RegionHighlights$; } });
+Object.defineProperty(exports, "RelatedPlace$", { enumerable: true, get: function () { return client_geo_places_1.RelatedPlace$; } });
+Object.defineProperty(exports, "ReverseGeocode$", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocode$; } });
+Object.defineProperty(exports, "ReverseGeocodeAdditionalFeature", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocodeAdditionalFeature; } });
+Object.defineProperty(exports, "ReverseGeocodeAddressNamesMode", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocodeAddressNamesMode; } });
+Object.defineProperty(exports, "ReverseGeocodeFilter$", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocodeFilter$; } });
+Object.defineProperty(exports, "ReverseGeocodeFilterPlaceType", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocodeFilterPlaceType; } });
+Object.defineProperty(exports, "ReverseGeocodeIntendedUse", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocodeIntendedUse; } });
+Object.defineProperty(exports, "ReverseGeocodeRequest$", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocodeRequest$; } });
+Object.defineProperty(exports, "ReverseGeocodeResponse$", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocodeResponse$; } });
+Object.defineProperty(exports, "ReverseGeocodeResultItem$", { enumerable: true, get: function () { return client_geo_places_1.ReverseGeocodeResultItem$; } });
+Object.defineProperty(exports, "SearchNearby$", { enumerable: true, get: function () { return client_geo_places_1.SearchNearby$; } });
+Object.defineProperty(exports, "SearchNearbyAdditionalFeature", { enumerable: true, get: function () { return client_geo_places_1.SearchNearbyAdditionalFeature; } });
+Object.defineProperty(exports, "SearchNearbyFilter$", { enumerable: true, get: function () { return client_geo_places_1.SearchNearbyFilter$; } });
+Object.defineProperty(exports, "SearchNearbyIntendedUse", { enumerable: true, get: function () { return client_geo_places_1.SearchNearbyIntendedUse; } });
+Object.defineProperty(exports, "SearchNearbyRequest$", { enumerable: true, get: function () { return client_geo_places_1.SearchNearbyRequest$; } });
+Object.defineProperty(exports, "SearchNearbyResponse$", { enumerable: true, get: function () { return client_geo_places_1.SearchNearbyResponse$; } });
+Object.defineProperty(exports, "SearchNearbyResultItem$", { enumerable: true, get: function () { return client_geo_places_1.SearchNearbyResultItem$; } });
+Object.defineProperty(exports, "SearchText$", { enumerable: true, get: function () { return client_geo_places_1.SearchText$; } });
+Object.defineProperty(exports, "SearchTextAdditionalFeature", { enumerable: true, get: function () { return client_geo_places_1.SearchTextAdditionalFeature; } });
+Object.defineProperty(exports, "SearchTextFilter$", { enumerable: true, get: function () { return client_geo_places_1.SearchTextFilter$; } });
+Object.defineProperty(exports, "SearchTextIntendedUse", { enumerable: true, get: function () { return client_geo_places_1.SearchTextIntendedUse; } });
+Object.defineProperty(exports, "SearchTextRequest$", { enumerable: true, get: function () { return client_geo_places_1.SearchTextRequest$; } });
+Object.defineProperty(exports, "SearchTextResponse$", { enumerable: true, get: function () { return client_geo_places_1.SearchTextResponse$; } });
+Object.defineProperty(exports, "SearchTextResultItem$", { enumerable: true, get: function () { return client_geo_places_1.SearchTextResultItem$; } });
+Object.defineProperty(exports, "SearchTextTravelMode", { enumerable: true, get: function () { return client_geo_places_1.SearchTextTravelMode; } });
+Object.defineProperty(exports, "SecondaryAddressComponent$", { enumerable: true, get: function () { return client_geo_places_1.SecondaryAddressComponent$; } });
+Object.defineProperty(exports, "SecondaryAddressComponentMatchScore$", { enumerable: true, get: function () { return client_geo_places_1.SecondaryAddressComponentMatchScore$; } });
+Object.defineProperty(exports, "StreetComponents$", { enumerable: true, get: function () { return client_geo_places_1.StreetComponents$; } });
+Object.defineProperty(exports, "SubRegion$", { enumerable: true, get: function () { return client_geo_places_1.SubRegion$; } });
+Object.defineProperty(exports, "SubRegionHighlights$", { enumerable: true, get: function () { return client_geo_places_1.SubRegionHighlights$; } });
+Object.defineProperty(exports, "Suggest$", { enumerable: true, get: function () { return client_geo_places_1.Suggest$; } });
+Object.defineProperty(exports, "SuggestAdditionalFeature", { enumerable: true, get: function () { return client_geo_places_1.SuggestAdditionalFeature; } });
+Object.defineProperty(exports, "SuggestAddressHighlights$", { enumerable: true, get: function () { return client_geo_places_1.SuggestAddressHighlights$; } });
+Object.defineProperty(exports, "SuggestFilter$", { enumerable: true, get: function () { return client_geo_places_1.SuggestFilter$; } });
+Object.defineProperty(exports, "SuggestHighlights$", { enumerable: true, get: function () { return client_geo_places_1.SuggestHighlights$; } });
+Object.defineProperty(exports, "SuggestIntendedUse", { enumerable: true, get: function () { return client_geo_places_1.SuggestIntendedUse; } });
+Object.defineProperty(exports, "SuggestPlaceResult$", { enumerable: true, get: function () { return client_geo_places_1.SuggestPlaceResult$; } });
+Object.defineProperty(exports, "SuggestQueryResult$", { enumerable: true, get: function () { return client_geo_places_1.SuggestQueryResult$; } });
+Object.defineProperty(exports, "SuggestRequest$", { enumerable: true, get: function () { return client_geo_places_1.SuggestRequest$; } });
+Object.defineProperty(exports, "SuggestResponse$", { enumerable: true, get: function () { return client_geo_places_1.SuggestResponse$; } });
+Object.defineProperty(exports, "SuggestResultItem$", { enumerable: true, get: function () { return client_geo_places_1.SuggestResultItem$; } });
+Object.defineProperty(exports, "SuggestResultItemType", { enumerable: true, get: function () { return client_geo_places_1.SuggestResultItemType; } });
+Object.defineProperty(exports, "SuggestTravelMode", { enumerable: true, get: function () { return client_geo_places_1.SuggestTravelMode; } });
+Object.defineProperty(exports, "ThrottlingException", { enumerable: true, get: function () { return client_geo_places_1.ThrottlingException; } });
+Object.defineProperty(exports, "ThrottlingException$", { enumerable: true, get: function () { return client_geo_places_1.ThrottlingException$; } });
+Object.defineProperty(exports, "TimeZone$", { enumerable: true, get: function () { return client_geo_places_1.TimeZone$; } });
+Object.defineProperty(exports, "TranslationDetails$", { enumerable: true, get: function () { return client_geo_places_1.TranslationDetails$; } });
+Object.defineProperty(exports, "TranslationName$", { enumerable: true, get: function () { return client_geo_places_1.TranslationName$; } });
+Object.defineProperty(exports, "TranslationNameType", { enumerable: true, get: function () { return client_geo_places_1.TranslationNameType; } });
+Object.defineProperty(exports, "TypePlacement", { enumerable: true, get: function () { return client_geo_places_1.TypePlacement; } });
+Object.defineProperty(exports, "UspsZip$", { enumerable: true, get: function () { return client_geo_places_1.UspsZip$; } });
+Object.defineProperty(exports, "UspsZipPlus4$", { enumerable: true, get: function () { return client_geo_places_1.UspsZipPlus4$; } });
+Object.defineProperty(exports, "ValidationException", { enumerable: true, get: function () { return client_geo_places_1.ValidationException; } });
+Object.defineProperty(exports, "ValidationException$", { enumerable: true, get: function () { return client_geo_places_1.ValidationException$; } });
+Object.defineProperty(exports, "ValidationExceptionField$", { enumerable: true, get: function () { return client_geo_places_1.ValidationExceptionField$; } });
+Object.defineProperty(exports, "ValidationExceptionReason", { enumerable: true, get: function () { return client_geo_places_1.ValidationExceptionReason; } });
+Object.defineProperty(exports, "ZipClassificationCode", { enumerable: true, get: function () { return client_geo_places_1.ZipClassificationCode; } });
+Object.defineProperty(exports, "__Client", { enumerable: true, get: function () { return client_geo_places_1.__Client; } });
+Object.defineProperty(exports, "errorTypeRegistries", { enumerable: true, get: function () { return client_geo_places_1.errorTypeRegistries; } });
+var amazon_location_utilities_datatypes_1 = require("@aws/amazon-location-utilities-datatypes");
+Object.defineProperty(exports, "calculateIsolinesResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.calculateIsolinesResponseToFeatureCollection; } });
+Object.defineProperty(exports, "calculateRoutesResponseToFeatureCollections", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.calculateRoutesResponseToFeatureCollections; } });
+Object.defineProperty(exports, "devicePositionsToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.devicePositionsToFeatureCollection; } });
+Object.defineProperty(exports, "featureCollectionToGeofence", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.featureCollectionToGeofence; } });
+Object.defineProperty(exports, "geocodeResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.geocodeResponseToFeatureCollection; } });
+Object.defineProperty(exports, "geofencesToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.geofencesToFeatureCollection; } });
+Object.defineProperty(exports, "getPlaceResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.getPlaceResponseToFeatureCollection; } });
+Object.defineProperty(exports, "optimizeWaypointsResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.optimizeWaypointsResponseToFeatureCollection; } });
+Object.defineProperty(exports, "placeToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.placeToFeatureCollection; } });
+Object.defineProperty(exports, "reverseGeocodeResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.reverseGeocodeResponseToFeatureCollection; } });
+Object.defineProperty(exports, "routeToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.routeToFeatureCollection; } });
+Object.defineProperty(exports, "searchNearbyResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.searchNearbyResponseToFeatureCollection; } });
+Object.defineProperty(exports, "searchTextResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.searchTextResponseToFeatureCollection; } });
+Object.defineProperty(exports, "snapToRoadsResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.snapToRoadsResponseToFeatureCollection; } });
+Object.defineProperty(exports, "suggestResponseToFeatureCollection", { enumerable: true, get: function () { return amazon_location_utilities_datatypes_1.suggestResponseToFeatureCollection; } });