@crouter/sdk 0.3.396 → 0.3.397

package/README.md

@@ -47,7 +47,7 @@ const client = new Crouter({
 
 ## Runtime version
 
-The SDK talks only to a runtime at or above its own version (`SDK_VERSION`), and has no compatibility mode for older ones: its types, such as `RunObject.activity`, describe what a runtime at its release sends. Every runtime answer carries a `Crouter-Runtime-Version` header. When that version is older than the SDK, or the header is missing (every runtime released before this rule shipped), the call throws `RuntimeVersionError` before the SDK reads the response: `code` is `runtime_version_unsupported`, `status` is 426, `retryable` is false, and `sdkVersion` and `runtimeVersion` name both versions. Upgrade the runtime first, then the SDK.
+The SDK talks only to a runtime at or above its own version (`SDK_VERSION`), and has no compatibility mode for older ones: its types, such as `RunObject.activity`, describe what a runtime at its release sends. Every runtime answer carries a `Crouter-Runtime-Version` header. When that version is older than the SDK, or the header is missing (every runtime released before this rule shipped), the call throws `RuntimeVersionError` before the SDK reads the response: `code` is `runtime_version_unsupported`, `status` is 426, `retryable` is false, and `sdkVersion` and `runtimeVersion` name both versions. The SDK also sends its own version on every request except `/healthz` as `Crouter-Minimum-Runtime-Version`; the hosting router and a runtime at this release or later refuse an older runtime with the same 426 *before* any handler runs, so nothing is accepted and no `Idempotency-Key` is recorded (a retry after the roll is a first send). Upgrade the runtime first, then the SDK.
 
 Pin `@crouter/sdk` to an exact version. One release is one version set: `@crouter/sdk@X` depends on exactly `@crouter/api@X` and `@crouter/identity@X`, so the pin fixes all three.
 

package/dist/client.js

@@ -1,4 +1,4 @@
-import { APIError, CrtrClient, RUNTIME_VERSION_HEADER, compareReleaseVersions, routes, } from '@crouter/api';
+import { APIError, CrtrClient, MINIMUM_RUNTIME_VERSION_HEADER, RUNTIME_VERSION_HEADER, compareReleaseVersions, routes, } from '@crouter/api';
 import { APIConnectionError, APIUserAbortError, AuthenticationError, CrouterError, mapError } from './errors.js';
 import { Bash } from './resources/bash.js';
 import { Canvas } from './resources/canvas.js';
@@ -478,8 +478,16 @@ function isNodeRuntime() {
  */
 function requireCurrentRuntime(inner) {
     const checked = async (input, init) => {
-        const response = await (inner ?? globalThis.fetch)(input, init);
         const url = new URL(input instanceof Request ? input.url : String(input), 'http://localhost');
+        // Say which runtime this SDK accepts, so the router in front of a hosted runtime, or the runtime itself, refuses
+        // an older one before any handler runs. `/healthz` is exempt from both checks.
+        let sentInit = init;
+        if (url.pathname !== '/healthz') {
+            const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
+            headers.set(MINIMUM_RUNTIME_VERSION_HEADER, SDK_VERSION);
+            sentInit = { ...init, headers };
+        }
+        const response = await (inner ?? globalThis.fetch)(input, sentInit);
         if (url.pathname === '/healthz')
             return response;
         const runtimeVersion = response.headers.get(RUNTIME_VERSION_HEADER);

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** This SDK's release version. It is also the oldest runtime the SDK accepts: one release is one version set. */
-export declare const SDK_VERSION = "0.3.396";
+export declare const SDK_VERSION = "0.3.397";

package/dist/version.js

@@ -1,3 +1,3 @@
 // Written by scripts/release-version.mjs on every release; do not edit by hand.
 /** This SDK's release version. It is also the oldest runtime the SDK accepts: one release is one version set. */
-export const SDK_VERSION = '0.3.396';
+export const SDK_VERSION = '0.3.397';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouter/sdk",
-  "version": "0.3.396",
+  "version": "0.3.397",
   "description": "Typed Node and browser client for running crouter agents through the crtrd /v1 API.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,8 +31,8 @@
     "build": "tsc -p tsconfig.json && chmod 755 dist/keygen-cli.js"
   },
   "dependencies": {
-    "@crouter/api": "0.3.396",
-    "@crouter/identity": "0.3.396",
+    "@crouter/api": "0.3.397",
+    "@crouter/identity": "0.3.397",
     "jose": "^6.2.1"
   },
   "peerDependencies": {