@solvice/routing 0.17.2-beta.0 → 0.17.4-beta.0

package/dist/runs.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};

package/dist/v3.d.ts

@@ -731,6 +731,17 @@ export interface components {
              *     Not applied by decomposition: a problem that sets it solves monolithically.
              */
             assignment_costs?: components["schemas"]["AssignmentCost"][] | null;
+            /**
+             * @description Whether a break may pause this job's service. With `true`, a `fixed`
+             *     break, a `windowed` break or a duty-`triggered` break that falls
+             *     inside the service pauses it: the work resumes when the break ends,
+             *     the job departs the break's length later, and the stop reports the
+             *     paused seconds in `break_s`. A drive-`triggered` break never pauses a
+             *     job (it counts driving time only). Default `false`: the whole service
+             *     moves after the break, or the break is taken before the job starts.
+             * @example true
+             */
+            break_interruptible?: boolean | null;
             /**
              * @description Quantity delivered at this visit: comes off the vehicle here, having
              *     been loaded at a depot. Direction is carried by the field itself, never
@@ -757,7 +768,9 @@ export interface components {
              *     On a shipment the drop cost applies to the pair, charged once.
              *
              *     Must be finite, `>= 0` and at most `1e9`; combined with `priority` it
-             *     is rejected with HTTP 400 (`conflicting_fields`).
+             *     is rejected with HTTP 400 (`conflicting_fields`). Also rejected with
+             *     HTTP 400 (`not_supported`) while a positive `objective.per_delay_workday` is set,
+             *     since a droppable task could be dropped to avoid its delay charge.
              * @example 25
              */
             drop_cost?: number | null;
@@ -918,6 +931,22 @@ export interface components {
             currency?: string | null;
             /** @description Job-proximity cluster cohesion. See the `Grouping` schema. */
             grouping?: null | components["schemas"]["Grouping"];
+            /**
+             * Format: double
+             * @description ASAP scheduling: money charged for each served task per workday its
+             *     shift lies after the earliest workday in the request, in the request's
+             *     currency. A workday is a distinct calendar date, in the shift's own UTC
+             *     offset, on which at least one shift starts; shifts on one date share a
+             *     rank, and a date with no shift adds none. Unserved tasks pay nothing;
+             *     the charge never outranks `priority` and cannot be combined with
+             *     `drop_cost`. Absent or `0` = off; a single-date request is charged
+             *     nothing. A problem that sets it, even on one date, solves without
+             *     decomposition, like `assignment_costs`. Reported as `score.components.delay`. A positive
+             *     rate below `0.00001` is rejected, as is a rate whose total over the
+             *     later workdays exceeds `21474.83647` (`out_of_range`).
+             * @example 5
+             */
+            per_delay_workday?: number | null;
             /**
              * Format: double
              * @description Cost per hour of lateness: the default rate for every task window
@@ -1875,6 +1904,19 @@ export interface components {
              * @example 2026-07-01T08:10:00+02:00
              */
             arrival: string;
+            /**
+             * Format: int32
+             * @description Seconds of driver break taken inside this stop's service, pausing it:
+             *     a `fixed`, `windowed` or `triggered` break that fell mid-service on a
+             *     job with `break_interruptible: true`. Such a break gets no `break`
+             *     stop of its own; its time is counted here and in the route's
+             *     `time.break_s`. The stop reconciles as
+             *     `departure - service_start == service_s + setup + break_s`, where
+             *     setup is the unscaled `setup_duration_s` when paid, else 0. Present on
+             *     `job` stops only, when non-zero.
+             * @example 3600
+             */
+            break_s?: number | null;
             /**
              * Format: date-time
              * @description Departure. On `end` when the route finishes, after any depot
@@ -1951,10 +1993,10 @@ export interface components {
              *     On task stops, the **effective** on-site service time, not the
              *     nominal `service_duration_s` from the request: it already has the
              *     serving vehicle's `service_factor` applied. `departure -
-             *     service_start - service_s` is the stop's setup time: the request's
-             *     `setup_duration_s` (unscaled) for the first stop of a run at the same
-             *     location (setup is charged when the previous stop is elsewhere), and 0
-             *     for a co-located successor.
+             *     service_start - service_s - break_s` is the stop's setup time: the
+             *     request's `setup_duration_s` (unscaled) for the first stop of a run at
+             *     the same location (setup is charged when the previous stop is
+             *     elsewhere), and 0 for a co-located successor.
              *
              *     On `reload`, the depot's handling time (`departure - service_start
              *     == service_s`). On `start`/`end`, the depot handling time applied
@@ -1969,7 +2011,9 @@ export interface components {
             /**
              * Format: date-time
              * @description When service starts: `arrival + wait_s` plus the duration of any
-             *     windowed break taken on arrival here. On task and `reload` stops only.
+             *     break taken on arrival here (a `windowed` one; on a
+             *     `break_interruptible` job also a `fixed` or duty-`triggered` one that
+             *     falls in the wait). On task and `reload` stops only.
              * @example 2026-07-01T09:00:00+02:00
              */
             service_start?: string | null;
@@ -2023,6 +2067,7 @@ export interface components {
          * @example {
          *       "components": {
          *         "assignment": 0,
+         *         "delay": 0,
          *         "distance": 1.69,
          *         "drop_costs": 0,
          *         "grouping": 0,
@@ -2080,6 +2125,7 @@ export interface components {
          *     charges lands in exactly one of them.
          * @example {
          *       "assignment": 0,
+         *       "delay": 0,
          *       "distance": 1.69,
          *       "drop_costs": 0,
          *       "grouping": 0,
@@ -2104,6 +2150,13 @@ export interface components {
              *     default assignment cost), in currency units.
              */
             assignment: number;
+            /**
+             * Format: double
+             * @description Cost of delay, in currency units (`objective.per_delay_workday`): each
+             *     served task pays the rate once per workday its shift lies after the
+             *     earliest workday in the request.
+             */
+            delay: number;
             /**
              * Format: double
              * @description Distance cost, in currency units: each route's distance priced at
@@ -2610,7 +2663,9 @@ export interface components {
              *     On a shipment the drop cost applies to the pair, charged once.
              *
              *     Must be finite, `>= 0` and at most `1e9`; combined with `priority` it
-             *     is rejected with HTTP 400 (`conflicting_fields`).
+             *     is rejected with HTTP 400 (`conflicting_fields`). Also rejected with
+             *     HTTP 400 (`not_supported`) while a positive `objective.per_delay_workday` is set,
+             *     since a droppable task could be dropped to avoid its delay charge.
              * @example 25
              */
             drop_cost?: number | null;
@@ -3028,6 +3083,7 @@ export interface components {
          *         "score": {
          *           "components": {
          *             "assignment": 0,
+         *             "delay": 0,
          *             "distance": 1.69,
          *             "drop_costs": 0,
          *             "grouping": 0,
@@ -3362,6 +3418,7 @@ export interface components {
          *       "score": {
          *         "components": {
          *           "assignment": 0,
+         *           "delay": 0,
          *           "distance": 1.69,
          *           "drop_costs": 0,
          *           "grouping": 0,
@@ -3645,7 +3702,8 @@ export interface components {
         TimeTotals: {
             /**
              * Format: int64
-             * @description Time on driver breaks.
+             * @description Time on driver breaks: the `break` stops plus the breaks that paused
+             *     a job's service (the job stops' `break_s`).
              */
             break_s: number;
             /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvice/routing",
-  "version": "0.17.2-beta.0",
+  "version": "0.17.4-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",
@@ -28,7 +28,7 @@
     "node": ">=20"
   },
   "scripts": {
-    "generate": "openapi-typescript ../../mintlify/openapi.json -o src/v3.ts --default-non-nullable false",
+    "generate": "openapi-typescript ../../mintlify/openapi.json -o src/v3.ts --default-non-nullable false && openapi-typescript ../../mintlify/openapi-runs.json -o src/runs.ts --default-non-nullable false",
     "build": "tsc",
     "prepack": "npm run build",
     "publish:beta": "npm test && npm publish --tag beta",