@solvice/routing 0.17.9-beta.0 → 0.18.1-beta.0

package/dist/runs.d.ts

@@ -697,10 +697,11 @@ export interface components {
             time_windows?: components["schemas"]["TimeWindow"][] | null;
         };
         /**
-         * @description Which road-network data prices travel times and distances.
+         * @description Which data prices travel times and distances. Omitted, it follows
+         *     `travel.departure_time`: `osm` without one, `tomtom` with one.
          *
-         *     - `tomtom` (default): TomTom historical-typical traffic at the departure
-         *       time.
+         *     - `tomtom`: TomTom historical-typical traffic at the departure time, or at
+         *       the moment of the request without one.
          *     - `osm`: OpenStreetMap free-flow times. No traffic, so
          *       `travel.departure_time` is rejected with 400.
          *     - `tomtom_real_time`: TomTom live traffic at the moment of the request.
@@ -708,10 +709,13 @@ export interface components {
          *       `travel.departure_time` is rejected; every vehicle must use the `car`
          *       profile; at most 100 distinct locations; up to ~25 s of matrix fetch at
          *       100 locations.
+         *     - `straight_line`: great-circle distance at `travel.speed_kmh`, no road
+         *       network. `travel.departure_time`, `options.polyline` and any vehicle
+         *       `profile` other than `car` are rejected with 400.
          * @example osm
          * @enum {string}
          */
-        MatrixEngine: "tomtom" | "osm" | "tomtom_real_time";
+        MatrixEngine: "tomtom" | "osm" | "tomtom_real_time" | "straight_line";
         /**
          * @description Top-level objective configuration.
          *
@@ -1983,7 +1987,7 @@ export interface components {
             seed?: number | null;
             /**
              * Format: double
-             * @description Search time budget in seconds, fractions allowed. Default when omitted:
+             * @description Upper bound on the search time in seconds, fractions allowed. Default when omitted:
              *     150 ms plus 4 ms per task (jobs and shipments combined), so 100 tasks
              *     search for 0.55 s. Maximum 3600: a larger value is rejected with HTTP 400.
              *     A value below 0.1 is raised to a 100 ms floor. Pure search time:
@@ -1997,6 +2001,7 @@ export interface components {
              *     `estimate` (the default) solves on estimated travel and sets
              *     `summary.travel_estimated`; `fail` returns the 502/503 instead.
              *     Locations that Maps rejects for spanning more than one region are a 400.
+             *     No effect with `travel.engine: "straight_line"`, which fetches nothing.
              * @default estimate
              */
             travel_fallback?: null | components["schemas"]["TravelFallback"];
@@ -3219,7 +3224,8 @@ export interface components {
              *     `score.violation_count` hold only against it, and no `routes[].polyline`
              *     is returned. Solve again once Maps is back if the plan must hold on the
              *     road; on a solve, `options.travel_fallback: "fail"` returns the error
-             *     instead. Absent when travel is road-routed.
+             *     instead. Absent when travel came from the requested engine,
+             *     `straight_line` included.
              */
             travel_estimated?: boolean;
             /**
@@ -3245,7 +3251,8 @@ export interface components {
             /**
              * Format: double
              * @description Cost, in the objective's currency, incurred when a task without this
-             *     tag is served. Must be finite and `>= 0`.
+             *     tag is served. Must be finite and `>= 0`, and one vehicle's entries
+             *     must sum to at most 21474.83647 (a task lacking every tag pays them all).
              * @example 25
              */
             violation_cost: number;
@@ -3487,11 +3494,13 @@ export interface components {
         /**
          * @description Where travel times and distances come from.
          *
-         *     Matrices are traffic-aware (historical-typical traffic); by default travel
-         *     times reflect traffic at the moment the request is processed. Set
-         *     `departure_time` to plan against another instant — e.g. tomorrow's 08:00
-         *     routes with morning-rush travel times, or a replay of a past run under its
-         *     original conditions.
+         *     Omitted altogether, travel times are free-flow (`osm`): the same request
+         *     prices the same at any hour. Set `departure_time` to plan against an
+         *     instant's traffic — e.g. tomorrow's 08:00 routes with morning-rush travel
+         *     times, or a replay of a past run under its original conditions; the engine
+         *     is then `tomtom`. Set `engine: tomtom` alone for traffic at the moment the
+         *     request is processed. `engine: "straight_line"` skips the road network for
+         *     great-circle travel at `speed_kmh`.
          * @example {
          *       "departure_time": "2026-07-01T08:00:00+02:00",
          *       "engine": "tomtom"
@@ -3501,16 +3510,27 @@ export interface components {
             /**
              * Format: date-time
              * @description Departure time for the traffic lookup (RFC 3339 instant, any offset).
-             *     Omitted → traffic at solve time. An explicit departure time bypasses
-             *     the server-side matrix cache.
+             *     Omitted → free-flow times, or traffic at solve time with `engine:
+             *     tomtom`. An explicit departure time bypasses the server-side matrix
+             *     cache.
              * @example 2026-07-01T08:00:00+02:00
              */
             departure_time?: string | null;
             /**
-             * @description Road-network data behind travel times and distances. Omitted →
-             *     `tomtom`.
+             * @description Data behind travel times and distances. Omitted → `osm`, or `tomtom`
+             *     when `departure_time` is set.
              */
             engine?: null | components["schemas"]["MatrixEngine"];
+            /**
+             * Format: double
+             * @description Travel speed for `engine: "straight_line"`, in km/h: each leg takes its
+             *     great-circle distance at this speed, rounded to the whole second. `1` to
+             *     `1000`, default `50`; `vehicles[].speed_factor` still scales it per
+             *     vehicle. Any other engine rejects it (HTTP 400 `conflicting_fields`).
+             * @default 50
+             * @example 50
+             */
+            speed_kmh?: number | null;
         };
         /**
          * @description `options.travel_fallback`: what a solve does when travel times cannot be

package/dist/v3.d.ts

@@ -34,7 +34,7 @@ export interface paths {
         put?: never;
         /**
          * Solve a vehicle routing problem
-         * @description Assigns the jobs and shipments in `problem` to the vehicles' shifts and returns the routes, the `plan` they follow and any tasks left unassigned, each with the reasons. The request is validated first: an invalid one is rejected with a 400 whose `errors[]` says what to fix. Travel times and distances for the request's locations are then looked up, and the search runs for `options.time_limit_s` seconds (default 150 ms plus 4 ms per task; maximum 60). Send a previous result's `plan` to re-optimize starting from it. `POST /v3/routing/evaluate` and `POST /v3/routing/suggest` take the same `problem`.
+         * @description Assigns the jobs and shipments in `problem` to the vehicles' shifts and returns the routes, the `plan` they follow and any tasks left unassigned, each with the reasons. The request is validated first: an invalid one is rejected with a 400 whose `errors[]` says what to fix. Travel times and distances for the request's locations are then looked up, and the search runs for up to `options.time_limit_s` seconds (default 150 ms plus 4 ms per task; maximum 60). Send a previous result's `plan` to re-optimize starting from it. `POST /v3/routing/evaluate` and `POST /v3/routing/suggest` take the same `problem`.
          */
         post: operations["solve"];
         delete?: never;
@@ -883,10 +883,11 @@ export interface components {
             time_windows?: components["schemas"]["TimeWindow"][] | null;
         };
         /**
-         * @description Which road-network data prices travel times and distances.
+         * @description Which data prices travel times and distances. Omitted, it follows
+         *     `travel.departure_time`: `osm` without one, `tomtom` with one.
          *
-         *     - `tomtom` (default): TomTom historical-typical traffic at the departure
-         *       time.
+         *     - `tomtom`: TomTom historical-typical traffic at the departure time, or at
+         *       the moment of the request without one.
          *     - `osm`: OpenStreetMap free-flow times. No traffic, so
          *       `travel.departure_time` is rejected with 400.
          *     - `tomtom_real_time`: TomTom live traffic at the moment of the request.
@@ -894,10 +895,13 @@ export interface components {
          *       `travel.departure_time` is rejected; every vehicle must use the `car`
          *       profile; at most 100 distinct locations; up to ~25 s of matrix fetch at
          *       100 locations.
+         *     - `straight_line`: great-circle distance at `travel.speed_kmh`, no road
+         *       network. `travel.departure_time`, `options.polyline` and any vehicle
+         *       `profile` other than `car` are rejected with 400.
          * @example osm
          * @enum {string}
          */
-        MatrixEngine: "tomtom" | "osm" | "tomtom_real_time";
+        MatrixEngine: "tomtom" | "osm" | "tomtom_real_time" | "straight_line";
         /**
          * @description Top-level objective configuration.
          *
@@ -2864,7 +2868,7 @@ export interface components {
             seed?: number | null;
             /**
              * Format: double
-             * @description Search time budget in seconds, fractions allowed. Default when omitted:
+             * @description Upper bound on the search time in seconds, fractions allowed. Default when omitted:
              *     150 ms plus 4 ms per task (jobs and shipments combined), so 100 tasks
              *     search for 0.55 s. Maximum 60: a larger value is rejected with HTTP 400.
              *     A value below 0.1 is raised to a 100 ms floor. Pure search time:
@@ -2878,6 +2882,7 @@ export interface components {
              *     `estimate` (the default) solves on estimated travel and sets
              *     `summary.travel_estimated`; `fail` returns the 502/503 instead.
              *     Locations that Maps rejects for spanning more than one region are a 400.
+             *     No effect with `travel.engine: "straight_line"`, which fetches nothing.
              * @default estimate
              */
             travel_fallback?: null | components["schemas"]["TravelFallback"];
@@ -3523,7 +3528,8 @@ export interface components {
              *     `score.violation_count` hold only against it, and no `routes[].polyline`
              *     is returned. Solve again once Maps is back if the plan must hold on the
              *     road; on a solve, `options.travel_fallback: "fail"` returns the error
-             *     instead. Absent when travel is road-routed.
+             *     instead. Absent when travel came from the requested engine,
+             *     `straight_line` included.
              */
             travel_estimated?: boolean;
             /**
@@ -3549,7 +3555,8 @@ export interface components {
             /**
              * Format: double
              * @description Cost, in the objective's currency, incurred when a task without this
-             *     tag is served. Must be finite and `>= 0`.
+             *     tag is served. Must be finite and `>= 0`, and one vehicle's entries
+             *     must sum to at most 21474.83647 (a task lacking every tag pays them all).
              * @example 25
              */
             violation_cost: number;
@@ -3850,11 +3857,13 @@ export interface components {
         /**
          * @description Where travel times and distances come from.
          *
-         *     Matrices are traffic-aware (historical-typical traffic); by default travel
-         *     times reflect traffic at the moment the request is processed. Set
-         *     `departure_time` to plan against another instant — e.g. tomorrow's 08:00
-         *     routes with morning-rush travel times, or a replay of a past run under its
-         *     original conditions.
+         *     Omitted altogether, travel times are free-flow (`osm`): the same request
+         *     prices the same at any hour. Set `departure_time` to plan against an
+         *     instant's traffic — e.g. tomorrow's 08:00 routes with morning-rush travel
+         *     times, or a replay of a past run under its original conditions; the engine
+         *     is then `tomtom`. Set `engine: tomtom` alone for traffic at the moment the
+         *     request is processed. `engine: "straight_line"` skips the road network for
+         *     great-circle travel at `speed_kmh`.
          * @example {
          *       "departure_time": "2026-07-01T08:00:00+02:00",
          *       "engine": "tomtom"
@@ -3864,16 +3873,27 @@ export interface components {
             /**
              * Format: date-time
              * @description Departure time for the traffic lookup (RFC 3339 instant, any offset).
-             *     Omitted → traffic at solve time. An explicit departure time bypasses
-             *     the server-side matrix cache.
+             *     Omitted → free-flow times, or traffic at solve time with `engine:
+             *     tomtom`. An explicit departure time bypasses the server-side matrix
+             *     cache.
              * @example 2026-07-01T08:00:00+02:00
              */
             departure_time?: string | null;
             /**
-             * @description Road-network data behind travel times and distances. Omitted →
-             *     `tomtom`.
+             * @description Data behind travel times and distances. Omitted → `osm`, or `tomtom`
+             *     when `departure_time` is set.
              */
             engine?: null | components["schemas"]["MatrixEngine"];
+            /**
+             * Format: double
+             * @description Travel speed for `engine: "straight_line"`, in km/h: each leg takes its
+             *     great-circle distance at this speed, rounded to the whole second. `1` to
+             *     `1000`, default `50`; `vehicles[].speed_factor` still scales it per
+             *     vehicle. Any other engine rejects it (HTTP 400 `conflicting_fields`).
+             * @default 50
+             * @example 50
+             */
+            speed_kmh?: number | null;
         };
         /**
          * @description `options.travel_fallback`: what a solve does when travel times cannot be

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvice/routing",
-  "version": "0.17.9-beta.0",
+  "version": "0.18.1-beta.0",
   "description": "TypeScript client for the Solvice V3 routing API, generated from its OpenAPI spec.",
   "license": "Apache-2.0",
   "homepage": "https://docs.solvice.io/guides/platform/sdks/typescript",