@googlemaps/routing 0.6.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [1.0.1](https://github.com/googleapis/google-cloud-node/compare/routing-v1.0.0...routing-v1.0.1) (2023-09-06)
+
+
+### Bug Fixes
+
+* [Many APIs] simplify logic for HTTP/1.1 REST fallback option ([#4589](https://github.com/googleapis/google-cloud-node/issues/4589)) ([07967ad](https://github.com/googleapis/google-cloud-node/commit/07967add1b5fc28b548cf74721b595ea0ba90d5b))
+
+## [1.0.0](https://github.com/googleapis/google-cloud-node/compare/routing-v0.6.0...routing-v1.0.0) (2023-08-06)
+
+
+### ⚠ BREAKING CHANGES
+
+* migrate to Node 14 ([#4443](https://github.com/googleapis/google-cloud-node/issues/4443))
+
+### Bug Fixes
+
+* [Many APIs] fix typings for IAM methods ([#4466](https://github.com/googleapis/google-cloud-node/issues/4466)) ([fa1520c](https://github.com/googleapis/google-cloud-node/commit/fa1520c3eb526efd3523d9cea349ed31683d5889))
+
+
+### Miscellaneous Chores
+
+* Migrate to Node 14 ([#4443](https://github.com/googleapis/google-cloud-node/issues/4443)) ([2260f12](https://github.com/googleapis/google-cloud-node/commit/2260f12543d171bda95345e53475f5f0fdc45770))
+
 ## [0.6.0](https://github.com/googleapis/google-cloud-node/compare/routing-v0.5.1...routing-v0.6.0) (2023-07-04)
 
 

package/README.md

@@ -173,7 +173,7 @@ also contains samples.
 
 ## Supported Node.js Versions
 
-Our client libraries follow the [Node.js release schedule](https://nodejs.org/en/about/releases/).
+Our client libraries follow the [Node.js release schedule](https://github.com/nodejs/release#release-schedule).
 Libraries are compatible with all current _active_ and _maintenance_ versions of
 Node.js.
 If you are using an end-of-life version of Node.js, we recommend that you update

package/build/src/v2/routes_client.d.ts

@@ -51,8 +51,7 @@ export declare class RoutesClient {
      *     API remote host.
      * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
      *     Follows the structure of {@link gapicConfig}.
-     * @param {boolean | "rest"} [options.fallback] - Use HTTP fallback mode.
-     *     Pass "rest" to use HTTP/1.1 REST API instead of gRPC.
+     * @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
      *     For more information, please check the
      *     {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
      * @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
@@ -60,7 +59,7 @@ export declare class RoutesClient {
      *     HTTP implementation. Load only fallback version and pass it to the constructor:
      *     ```
      *     const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
-     *     const client = new RoutesClient({fallback: 'rest'}, gax);
+     *     const client = new RoutesClient({fallback: true}, gax);
      *     ```
      */
     constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
@@ -165,12 +164,12 @@ export declare class RoutesClient {
      *   Optional. The departure time. If you don't set this value, then this value
      *   defaults to the time that you made the request.
      *   NOTE: You can only specify a `departure_time` in the past when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`.
      * @param {google.protobuf.Timestamp} [request.arrivalTime]
      *   Optional. The arrival time.
      *   NOTE: Can only be set when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`. You can specify either departure_time or arrival_time, but not
      *   both.
      * @param {boolean} [request.computeAlternativeRoutes]
@@ -194,7 +193,7 @@ export declare class RoutesClient {
      * @param {google.maps.routing.v2.Units} [request.units]
      *   Optional. Specifies the units of measure for the display fields. These
      *   fields include the `instruction` field in
-     *   {@link google.maps.routing.v2.NavigationInstruction|NavigationInstruction}. The
+     *   {@link protos.google.maps.routing.v2.NavigationInstruction|NavigationInstruction}. The
      *   units of measure used for the route, leg, step distance, and duration are
      *   not affected by this value. If you don't provide this value, then the
      *   display units are inferred from the location of the first origin.
@@ -223,26 +222,25 @@ export declare class RoutesClient {
      * @param {google.maps.routing.v2.TrafficModel} [request.trafficModel]
      *   Optional. Specifies the assumptions to use when calculating time in
      *   traffic. This setting affects the value returned in the duration field in
-     *   the {@link google.maps.routing.v2.Route|Route} and
-     *   {@link google.maps.routing.v2.RouteLeg|RouteLeg} which contains the predicted
+     *   the {@link protos.google.maps.routing.v2.Route|Route} and
+     *   {@link protos.google.maps.routing.v2.RouteLeg|RouteLeg} which contains the predicted
      *   time in traffic based on historical averages.
      *   `TrafficModel` is only available for requests that have set
-     *   {@link google.maps.routing.v2.RoutingPreference|RoutingPreference} to
+     *   {@link protos.google.maps.routing.v2.RoutingPreference|RoutingPreference} to
      *   `TRAFFIC_AWARE_OPTIMAL` and
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.
      *   Defaults to `BEST_GUESS` if traffic is requested and `TrafficModel` is not
      *   specified.
      * @param {google.maps.routing.v2.TransitPreferences} [request.transitPreferences]
      *   Optional. Specifies preferences that influence the route returned for
      *   `TRANSIT` routes. NOTE: You can only specify a `transit_preferences` when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Promise} - The promise which resolves to an array.
-     *   The first element of the array is an object representing {@link google.maps.routing.v2.ComputeRoutesResponse | ComputeRoutesResponse}.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+     *   The first element of the array is an object representing {@link protos.google.maps.routing.v2.ComputeRoutesResponse|ComputeRoutesResponse}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
      *   for more details and examples.
      * @example <caption>include:samples/generated/v2/routes.compute_routes.js</caption>
      * region_tag:routes_v2_generated_Routes_ComputeRoutes_async
@@ -319,12 +317,12 @@ export declare class RoutesClient {
      *   Optional. The departure time. If you don't set this value, then this value
      *   defaults to the time that you made the request.
      *   NOTE: You can only specify a `departure_time` in the past when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`.
      * @param {google.protobuf.Timestamp} [request.arrivalTime]
      *   Optional. The arrival time.
      *   NOTE: Can only be set when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`. You can specify either departure_time or arrival_time, but not
      *   both.
      * @param {string} [request.languageCode]
@@ -346,24 +344,23 @@ export declare class RoutesClient {
      * @param {google.maps.routing.v2.TrafficModel} [request.trafficModel]
      *   Optional. Specifies the assumptions to use when calculating time in
      *   traffic. This setting affects the value returned in the duration field in
-     *   the {@link google.maps.routing.v2.RouteMatrixElement|RouteMatrixElement} which
+     *   the {@link protos.google.maps.routing.v2.RouteMatrixElement|RouteMatrixElement} which
      *   contains the predicted time in traffic based on historical averages.
-     *   {@link google.maps.routing.v2.RoutingPreference|RoutingPreference} to
+     *   {@link protos.google.maps.routing.v2.RoutingPreference|RoutingPreference} to
      *   `TRAFFIC_AWARE_OPTIMAL` and
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.
      *   Defaults to `BEST_GUESS` if traffic is requested and `TrafficModel` is not
      *   specified.
      * @param {google.maps.routing.v2.TransitPreferences} [request.transitPreferences]
      *   Optional. Specifies preferences that influence the route returned for
      *   `TRANSIT` routes. NOTE: You can only specify a `transit_preferences` when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
-     *   An object stream which emits {@link google.maps.routing.v2.RouteMatrixElement | RouteMatrixElement} on 'data' event.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#server-streaming)
+     *   An object stream which emits {@link protos.google.maps.routing.v2.RouteMatrixElement|RouteMatrixElement} on 'data' event.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#server-streaming | documentation }
      *   for more details and examples.
      * @example <caption>include:samples/generated/v2/routes.compute_route_matrix.js</caption>
      * region_tag:routes_v2_generated_Routes_ComputeRouteMatrix_async

package/build/src/v2/routes_client.js

@@ -61,8 +61,7 @@ class RoutesClient {
      *     API remote host.
      * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
      *     Follows the structure of {@link gapicConfig}.
-     * @param {boolean | "rest"} [options.fallback] - Use HTTP fallback mode.
-     *     Pass "rest" to use HTTP/1.1 REST API instead of gRPC.
+     * @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
      *     For more information, please check the
      *     {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
      * @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
@@ -70,7 +69,7 @@ class RoutesClient {
      *     HTTP implementation. Load only fallback version and pass it to the constructor:
      *     ```
      *     const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
-     *     const client = new RoutesClient({fallback: 'rest'}, gax);
+     *     const client = new RoutesClient({fallback: true}, gax);
      *     ```
      */
     constructor(opts, gaxInstance) {
@@ -127,7 +126,7 @@ class RoutesClient {
         if (!opts.fallback) {
             clientHeader.push(`grpc/${this._gaxGrpc.grpcVersion}`);
         }
-        else if (opts.fallback === 'rest') {
+        else {
             clientHeader.push(`rest/${this._gaxGrpc.grpcVersion}`);
         }
         if (opts.libName && opts.libVersion) {
@@ -138,7 +137,7 @@ class RoutesClient {
         // Some of the methods on this service provide streaming responses.
         // Provide descriptors for these.
         this.descriptors.stream = {
-            computeRouteMatrix: new this._gaxModule.StreamDescriptor(this._gaxModule.StreamType.SERVER_STREAMING, opts.fallback === 'rest'),
+            computeRouteMatrix: new this._gaxModule.StreamDescriptor(this._gaxModule.StreamType.SERVER_STREAMING, !!opts.fallback),
         };
         // Put together the default options sent with requests.
         this._defaults = this._gaxGrpc.constructSettings('google.maps.routing.v2.Routes', gapicConfig, opts.clientConfig || {}, { 'x-goog-api-client': clientHeader.join(' ') });
@@ -319,12 +318,12 @@ class RoutesClient {
      *   Optional. The departure time. If you don't set this value, then this value
      *   defaults to the time that you made the request.
      *   NOTE: You can only specify a `departure_time` in the past when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`.
      * @param {google.protobuf.Timestamp} [request.arrivalTime]
      *   Optional. The arrival time.
      *   NOTE: Can only be set when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`. You can specify either departure_time or arrival_time, but not
      *   both.
      * @param {string} [request.languageCode]
@@ -346,24 +345,23 @@ class RoutesClient {
      * @param {google.maps.routing.v2.TrafficModel} [request.trafficModel]
      *   Optional. Specifies the assumptions to use when calculating time in
      *   traffic. This setting affects the value returned in the duration field in
-     *   the {@link google.maps.routing.v2.RouteMatrixElement|RouteMatrixElement} which
+     *   the {@link protos.google.maps.routing.v2.RouteMatrixElement|RouteMatrixElement} which
      *   contains the predicted time in traffic based on historical averages.
-     *   {@link google.maps.routing.v2.RoutingPreference|RoutingPreference} to
+     *   {@link protos.google.maps.routing.v2.RoutingPreference|RoutingPreference} to
      *   `TRAFFIC_AWARE_OPTIMAL` and
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} to `DRIVE`.
      *   Defaults to `BEST_GUESS` if traffic is requested and `TrafficModel` is not
      *   specified.
      * @param {google.maps.routing.v2.TransitPreferences} [request.transitPreferences]
      *   Optional. Specifies preferences that influence the route returned for
      *   `TRANSIT` routes. NOTE: You can only specify a `transit_preferences` when
-     *   {@link google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
+     *   {@link protos.google.maps.routing.v2.RouteTravelMode|RouteTravelMode} is set to
      *   `TRANSIT`.
      * @param {object} [options]
      *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
      * @returns {Stream}
-     *   An object stream which emits {@link google.maps.routing.v2.RouteMatrixElement | RouteMatrixElement} on 'data' event.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#server-streaming)
+     *   An object stream which emits {@link protos.google.maps.routing.v2.RouteMatrixElement|RouteMatrixElement} on 'data' event.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#server-streaming | documentation }
      *   for more details and examples.
      * @example <caption>include:samples/generated/v2/routes.compute_route_matrix.js</caption>
      * region_tag:routes_v2_generated_Routes_ComputeRouteMatrix_async

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@googlemaps/routing",
-  "version": "0.6.0",
+  "version": "1.0.1",
   "description": " client for Node.js",
   "repository": {
     "type": "git",
@@ -46,29 +46,26 @@
     "test": "c8 mocha build/test"
   },
   "dependencies": {
-    "google-gax": "^3.5.8"
+    "google-gax": "^4.0.3"
   },
   "devDependencies": {
     "@types/mocha": "^9.0.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.4.5",
     "@types/sinon": "^10.0.0",
-    "c8": "^7.3.5",
-    "gts": "^3.1.0",
+    "c8": "^8.0.1",
+    "gapic-tools": "^0.1.8",
+    "gts": "^5.0.0",
     "jsdoc": "^4.0.0",
-    "jsdoc-fresh": "^2.0.0",
-    "jsdoc-region-tag": "^2.0.0",
+    "jsdoc-fresh": "^3.0.0",
+    "jsdoc-region-tag": "^3.0.0",
     "linkinator": "4.1.2",
     "long": "^5.2.3",
     "mocha": "^9.2.2",
-    "null-loader": "^4.0.1",
     "pack-n-play": "^1.0.0-2",
     "sinon": "^15.0.0",
-    "ts-loader": "^9.0.0",
-    "typescript": "^4.6.4",
-    "webpack": "^5.9.0",
-    "webpack-cli": "^5.0.0"
+    "typescript": "^5.1.6"
   },
   "engines": {
-    "node": ">=12.0.0"
+    "node": ">=14.0.0"
   }
 }