@serve.zone/interfaces 7.18.0 → 7.20.0

package/changelog.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 2026-06-11 - 7.20.0
+
+### Features
+
+- add live proxy traffic stats request interfaces (requests)
+  - Add per-host traffic stats shape with byte rates, request rate, and active connections
+  - Add Cloudly, coreflow, and coretraffic request contracts for retrieving live traffic stats
+
+## 2026-06-11 - 7.19.0
+
+### Features
+
+- add per-node dcrouter target host mapping (settings)
+  - Adds optional dcrouterTargetHostsByNode setting for mapping swarm node hostnames to gateway-reachable targets.
+
 ## 2026-06-11 - 7.18.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/interfaces',
-    version: '7.18.0',
+    version: '7.20.0',
     description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=

package/dist_ts/data/settings.d.ts

@@ -9,6 +9,7 @@ export interface ICloudlySettings {
     backupExternalTargetType?: string;
     backupExternalTargetConfig?: string;
     backupNodeCacheKeepDays?: string;
+    dcrouterTargetHostsByNode?: string;
     baseosJoinToken?: string;
     corebuildWorkerUrl?: string;
     corebuildWorkerToken?: string;

package/dist_ts/requests/node.d.ts

@@ -128,6 +128,22 @@ export interface IReq_Any_Cloudly_GetNodeActions extends plugins.typedrequestInt
         actions: INodeAction[];
     };
 }
+/**
+ * Admin UI asks Cloudly for a node's live proxy traffic rates; Cloudly
+ * relays to the node's coreflow which queries its local coretraffic.
+ */
+export interface IReq_Any_Cloudly_GetNodeTrafficStats extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_GetNodeTrafficStats> {
+    method: 'getNodeTrafficStats';
+    request: {
+        identity: IIdentity;
+        nodeId: string;
+        windowSeconds?: number;
+    };
+    response: {
+        hosts: import('./routing.js').ITrafficHostStats[];
+        timestamp: number;
+    };
+}
 /**
  * Cloudly -> admin UIs: live node metrics relay (1s cadence, not persisted).
  */

package/dist_ts/requests/routing.d.ts

@@ -21,3 +21,41 @@ export interface IRequest_Coretraffic_Coreflow_GetCurrentRouting {
         reverseConfigs: IReverseProxyConfig[];
     };
 }
+/**
+ * Live proxy traffic rates for one served hostname.
+ */
+export interface ITrafficHostStats {
+    hostName: string;
+    bytesInPerSec: number;
+    bytesOutPerSec: number;
+    requestsPerSec: number;
+    connectionsActive: number;
+}
+/**
+ * Coreflow asks its local coretraffic for current per-hostname traffic
+ * rates (sourced from the proxy's metrics, not persisted).
+ */
+export interface IRequest_Coreflow_Coretraffic_GetTrafficStats {
+    method: 'getTrafficStats';
+    request: {
+        windowSeconds?: number;
+    };
+    response: {
+        hosts: ITrafficHostStats[];
+        timestamp: number;
+    };
+}
+/**
+ * Cloudly asks a node's coreflow for that node's current proxy traffic
+ * rates; coreflow relays to its local coretraffic.
+ */
+export interface IRequest_Cloudly_Coreflow_GetTrafficStats {
+    method: 'coreflowGetTrafficStats';
+    request: {
+        windowSeconds?: number;
+    };
+    response: {
+        hosts: ITrafficHostStats[];
+        timestamp: number;
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "7.18.0",
+  "version": "7.20.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@serve.zone/interfaces',
-  version: '7.18.0',
+  version: '7.20.0',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/data/settings.ts

@@ -24,6 +24,11 @@ export interface ICloudlySettings {
   // Node-local archive cache retention in days (corestore prune; default 30)
   backupNodeCacheKeepDays?: string;
 
+  // JSON map of swarm node hostname -> gateway-reachable IP/host. Routes for
+  // services pinned to a node target that node's coretraffic instead of the
+  // static dcrouterTargetHost (e.g. {"cloudlyworkergrasberg":"192.168.190.108"}).
+  dcrouterTargetHostsByNode?: string;
+
   // BaseOS enrollment
   baseosJoinToken?: string;
 

package/ts/requests/node.ts

@@ -164,6 +164,26 @@ export interface IReq_Any_Cloudly_GetNodeActions extends plugins.typedrequestInt
   };
 }
 
+/**
+ * Admin UI asks Cloudly for a node's live proxy traffic rates; Cloudly
+ * relays to the node's coreflow which queries its local coretraffic.
+ */
+export interface IReq_Any_Cloudly_GetNodeTrafficStats extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_GetNodeTrafficStats
+> {
+  method: 'getNodeTrafficStats';
+  request: {
+    identity: IIdentity;
+    nodeId: string;
+    windowSeconds?: number;
+  };
+  response: {
+    hosts: import('./routing.js').ITrafficHostStats[];
+    timestamp: number;
+  };
+}
+
 /**
  * Cloudly -> admin UIs: live node metrics relay (1s cadence, not persisted).
  */

package/ts/requests/routing.ts

@@ -23,3 +23,44 @@ export interface IRequest_Coretraffic_Coreflow_GetCurrentRouting {
     reverseConfigs: IReverseProxyConfig[];
   };
 }
+
+/**
+ * Live proxy traffic rates for one served hostname.
+ */
+export interface ITrafficHostStats {
+  hostName: string;
+  bytesInPerSec: number;
+  bytesOutPerSec: number;
+  requestsPerSec: number;
+  connectionsActive: number;
+}
+
+/**
+ * Coreflow asks its local coretraffic for current per-hostname traffic
+ * rates (sourced from the proxy's metrics, not persisted).
+ */
+export interface IRequest_Coreflow_Coretraffic_GetTrafficStats {
+  method: 'getTrafficStats';
+  request: {
+    windowSeconds?: number;
+  };
+  response: {
+    hosts: ITrafficHostStats[];
+    timestamp: number;
+  };
+}
+
+/**
+ * Cloudly asks a node's coreflow for that node's current proxy traffic
+ * rates; coreflow relays to its local coretraffic.
+ */
+export interface IRequest_Cloudly_Coreflow_GetTrafficStats {
+  method: 'coreflowGetTrafficStats';
+  request: {
+    windowSeconds?: number;
+  };
+  response: {
+    hosts: ITrafficHostStats[];
+    timestamp: number;
+  };
+}