@synapticon/motion-master-client 6.0.0-alpha.52 → 6.0.0-alpha.54

package/dist/index.d.ts

@@ -8,3 +8,4 @@ export * from './hex.js';
 export * from './sdo.js';
 export * from './somanet.js';
 export * from './mmpd.js';
+export * from './wire-time.js';

package/dist/index.js

@@ -14,3 +14,4 @@ export * from './hex.js';
 export * from './sdo.js';
 export * from './somanet.js';
 export * from './mmpd.js';
+export * from './wire-time.js';

package/dist/wire-time.d.ts

@@ -0,0 +1,2 @@
+export declare const WIRE_TIME_HEADER = "X-Wire-Us";
+export declare function wireTimeMs(res: Response): number | null;

package/dist/wire-time.js

@@ -0,0 +1,18 @@
+// Helper for the server-measured wire-time channel.
+//
+// Endpoints that perform a fieldbus transaction (SDO, FoE, ...) report the on-device wire cost —
+// control-plane lock acquire + the mailbox/ESC round-trip — via the `X-Wire-Us` response header
+// (microseconds), independent of the response body shape. A cross-origin client subtracts this
+// from its own observed HTTP round-trip to separate the device cost from browser/transport
+// overhead. The header is CORS-exposed by the server so it is readable cross-origin.
+// Name of the wire-time response header (microseconds, integer).
+export const WIRE_TIME_HEADER = 'X-Wire-Us';
+// Reads the server-measured wire time from a response, in milliseconds, or null if the header is
+// absent or unparseable. Accepts any `Response` (the generated client's `HttpResponse` extends it).
+export function wireTimeMs(res) {
+    const raw = res.headers.get(WIRE_TIME_HEADER);
+    if (raw === null)
+        return null;
+    const us = Number(raw);
+    return Number.isFinite(us) ? us / 1000 : null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synapticon/motion-master-client",
-  "version": "6.0.0-alpha.52",
+  "version": "6.0.0-alpha.54",
   "description": "Isomorphic TypeScript client for Motion Master: the generated HTTP API client, the WebSocket connection, and helpers.",
   "license": "MIT",
   "repository": {