@solvice/routing 0.1.0-beta.1 → 0.17.0-beta.0

package/README.md

@@ -24,7 +24,7 @@ try {
           location: [4.7005, 50.8798], // [longitude, latitude]
           service_duration_s: 300,
           time_windows: [{ from: '2026-04-01T09:00:00+02:00', to: '2026-04-01T12:00:00+02:00' }],
-          delivery: { weight: 10 },
+          delivery_load: { weight: 10 },
         },
       ],
       vehicles: [
@@ -53,7 +53,7 @@ try {
     }
   }
   for (const job of solution.unassigned) {
-    console.log(`unassigned ${job.job_id}: ${job.category}`);
+    console.log(`unassigned ${job.task}: ${job.category}`);
   }
 } catch (err) {
   if (!(err instanceof SolviceError)) throw err;
@@ -69,7 +69,7 @@ try {
 | `solve(request)` | `POST /v3/routing/solve` |
 | `evaluate(request)` | `POST /v3/routing/evaluate` |
 | `suggest(request)` | `POST /v3/routing/suggest` |
-| `validate.solve(request)`, `validate.evaluate(request)`, `validate.suggest(request)` | the same three with `?validate_only=true` |
+| `validate.solve(request)`, `validate.evaluate(request)`, `validate.suggest(request)` | the same three sent to `/v3/routing/validate/solve`, `/evaluate`, `/suggest`: checked, not run |
 
 Any non-2xx response throws a `SolviceError` with the HTTP `status`, the
 `response`, and, when the response carried one, the API's error `body`. A `401`
@@ -94,13 +94,16 @@ Documentation: <https://docs.solvice.io>
 
 ```bash
 npm run generate   # from mintlify/openapi.json
-npm test           # builds, typechecks tests/types.ts and examples/, runs the unit tests
+npm test           # builds, typechecks tests/types.ts and examples/, runs the unit tests and the solve-response fixture check
 npm run smoke      # live calls; needs SOLVICE_API_KEY
 ```
 
-To release, bump `version` to the next `0.x.y-beta.n`, merge it to `main`, then run
-the "Publish TypeScript SDK" workflow on `main` (Actions → Run workflow). It runs
-`npm run publish:beta` through npm trusted publishing; never publish
+Releases are automatic: when release-plz publishes the GitHub release `vX.Y.Z`, the
+"Publish TypeScript SDK" workflow publishes `X.Y.Z-beta.0`. `version` in `package.json`
+is a placeholder (`0.0.0-development`); the workflow sets the real one from the tag, so
+never bump it. To publish a release that triggered nothing, or re-run a failed one, use
+Actions → Run workflow on `main`: it publishes the latest tag, or the one typed into `tag`.
+It runs `npm run publish:beta` through npm trusted publishing; never publish
 from a branch. The explicit `--tag beta` matters: npm 11 ignores
 `publishConfig.tag` and would move `latest` to the prerelease. Until a stable version
 exists, `latest` still points at the first prerelease (npm gives a package's first

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export type EvaluateRequest = Schemas["EvaluateRequest"];
 export type SuggestRequest = Schemas["SuggestRequest"];
 export type SolveResponse = Schemas["SolveResponse"];
 export type SuggestResponse = Schemas["SuggestResponse"];
-export type ValidateOnlyResponse = Schemas["ValidateOnlyResponse"];
+export type ValidateResponse = Schemas["ValidateResponse"];
 export type ErrorBody = Schemas["ErrorBody"];
 export interface SolviceOptions {
     /** Sent as the `Authorization` header value, with no scheme prefix. */
@@ -45,11 +45,11 @@ export declare function createSolvice({ apiKey, baseUrl, fetch }: SolviceOptions
     solve: (body: SolveRequest, options?: RequestOptions) => Promise<SolveResponse>;
     evaluate: (body: EvaluateRequest, options?: RequestOptions) => Promise<SolveResponse>;
     suggest: (body: SuggestRequest, options?: RequestOptions) => Promise<SuggestResponse>;
-    /** The same requests with `?validate_only=true`: no matrix fetch, no search. */
+    /** The same requests sent to `/v3/routing/validate/*`: no matrix fetch, no search, not billed. */
     validate: {
-        solve: (body: SolveRequest, options?: RequestOptions) => Promise<ValidateOnlyResponse>;
-        evaluate: (body: EvaluateRequest, options?: RequestOptions) => Promise<ValidateOnlyResponse>;
-        suggest: (body: SuggestRequest, options?: RequestOptions) => Promise<ValidateOnlyResponse>;
+        solve: (body: SolveRequest, options?: RequestOptions) => Promise<ValidateResponse>;
+        evaluate: (body: EvaluateRequest, options?: RequestOptions) => Promise<ValidateResponse>;
+        suggest: (body: SuggestRequest, options?: RequestOptions) => Promise<ValidateResponse>;
     };
     /** The underlying openapi-fetch client, for anything the methods above do not cover. */
     client: import("openapi-fetch").Client<paths, `${string}/${string}`>;

package/dist/index.js

@@ -43,23 +43,17 @@ function unwrap({ data, error, response }) {
     }
     return data;
 }
-// The spec types every 200 as `Response | ValidateOnlyResponse` (#1626 H).
-// Which one comes back is decided by `validate_only`, which each method below
-// fixes, so these two pick the matching side of the union.
-const result = (r) => unwrap(r);
-const validation = (r) => unwrap(r);
-const VALIDATE_ONLY = { query: { validate_only: true } };
 export function createSolvice({ apiKey, baseUrl = "https://api.solvice.io", fetch }) {
     const client = createClient({ baseUrl, headers: { Authorization: apiKey }, fetch });
     return {
-        solve: async (body, options) => result(await client.POST("/v3/routing/solve", { body, ...options })),
-        evaluate: async (body, options) => result(await client.POST("/v3/routing/evaluate", { body, ...options })),
-        suggest: async (body, options) => result(await client.POST("/v3/routing/suggest", { body, ...options })),
-        /** The same requests with `?validate_only=true`: no matrix fetch, no search. */
+        solve: async (body, options) => unwrap(await client.POST("/v3/routing/solve", { body, ...options })),
+        evaluate: async (body, options) => unwrap(await client.POST("/v3/routing/evaluate", { body, ...options })),
+        suggest: async (body, options) => unwrap(await client.POST("/v3/routing/suggest", { body, ...options })),
+        /** The same requests sent to `/v3/routing/validate/*`: no matrix fetch, no search, not billed. */
         validate: {
-            solve: async (body, options) => validation(await client.POST("/v3/routing/solve", { body, params: VALIDATE_ONLY, ...options })),
-            evaluate: async (body, options) => validation(await client.POST("/v3/routing/evaluate", { body, params: VALIDATE_ONLY, ...options })),
-            suggest: async (body, options) => validation(await client.POST("/v3/routing/suggest", { body, params: VALIDATE_ONLY, ...options })),
+            solve: async (body, options) => unwrap(await client.POST("/v3/routing/validate/solve", { body, ...options })),
+            evaluate: async (body, options) => unwrap(await client.POST("/v3/routing/validate/evaluate", { body, ...options })),
+            suggest: async (body, options) => unwrap(await client.POST("/v3/routing/validate/suggest", { body, ...options })),
         },
         /** The underlying openapi-fetch client, for anything the methods above do not cover. */
         client,