@crouter/api 0.3.390 → 0.3.392

package/dist/api/index.d.ts

@@ -5,6 +5,7 @@ export type { ErrorBody } from './errors.js';
 export { errorCodes } from './error-codes.js';
 export type { ErrorCode, ErrorEnvelope, ErrorOrigin, ErrorType } from './error-codes.js';
 export { API_VERSION, routes } from './routes.js';
+export { RUNTIME_VERSION_HEADER, compareReleaseVersions } from './runtime-version.js';
 export * from '../shared/generated-context.js';
 export * from './dto/common.js';
 export * from './dto/health.js';

package/dist/api/index.js

@@ -5,6 +5,7 @@ export { CrtrClient, waitForDaemonAvailability } from './client.js';
 export { APIError, ApiError, isErrorBody } from './errors.js';
 export { errorCodes } from './error-codes.js';
 export { API_VERSION, routes } from './routes.js';
+export { RUNTIME_VERSION_HEADER, compareReleaseVersions } from './runtime-version.js';
 export * from '../shared/generated-context.js';
 export * from './dto/common.js';
 export * from './dto/health.js';

package/dist/api/runtime-version.d.ts

@@ -0,0 +1,6 @@
+/** Response header carrying the runtime's release version, e.g. `0.3.389`. */
+export declare const RUNTIME_VERSION_HEADER = "Crouter-Runtime-Version";
+/** Compares two `major.minor.patch` versions numerically (a prerelease or build
+ *  suffix is ignored). Negative when `a` is older, zero when equal, positive when
+ *  newer. A version that does not parse sorts below every version that does. */
+export declare function compareReleaseVersions(a: string, b: string): number;

package/dist/api/runtime-version.js

@@ -0,0 +1,28 @@
+// The runtime's release version on every response (P2: latest only).
+//
+// The runtime sends its package version (`crouter` `package.json`) in this
+// header on every `/v1` answer of the owner API and the app listener. A client
+// built from the same release set compares it with its own version and refuses
+// an older runtime: there is no capability negotiation, so a client's types are
+// true only for a runtime at or above its own release.
+//
+// PURITY (spec §3.1): Node built-ins + `src/api/*` only.
+/** Response header carrying the runtime's release version, e.g. `0.3.389`. */
+export const RUNTIME_VERSION_HEADER = 'Crouter-Runtime-Version';
+/** Compares two `major.minor.patch` versions numerically (a prerelease or build
+ *  suffix is ignored). Negative when `a` is older, zero when equal, positive when
+ *  newer. A version that does not parse sorts below every version that does. */
+export function compareReleaseVersions(a, b) {
+    const left = parseRelease(a);
+    const right = parseRelease(b);
+    if (left === null || right === null)
+        return left === right ? 0 : left === null ? -1 : 1;
+    for (let i = 0; i < 3; i++)
+        if (left[i] !== right[i])
+            return left[i] - right[i];
+    return 0;
+}
+function parseRelease(version) {
+    const match = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(version.trim());
+    return match === null ? null : [Number(match[1]), Number(match[2]), Number(match[3])];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouter/api",
-  "version": "0.3.390",
+  "version": "0.3.392",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",