@serve.zone/interfaces 7.21.0 → 7.22.1

package/changelog.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 2026-06-12 - 7.22.1
+
+### Fixes
+
+- document the unit of deployment CPU usage (deployment)
+  - resourceUsage.cpuUsagePercent is percent of the whole node's CPU capacity (0-100), not the per-core docker stats convention; pins the scale that node-level metrics already use so producers and views stay consistent.
+
+## 2026-06-11 - 7.22.0
+
+### Features
+
+- add source profile references to route interfaces (gateway)
+  - Expose optional sourceProfileRef on service domain entries
+  - Expose optional sourceProfileRef on gateway route sync requests
+
 ## 2026-06-11 - 7.21.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/data/deployment.d.ts

@@ -58,6 +58,12 @@ export interface IDeployment {
      * Resource usage for this deployment
      */
     resourceUsage?: {
+        /**
+         * Percent of the whole node's CPU capacity (0-100), NOT per-core:
+         * a deployment saturating one core of an 8-core node reports 12.5.
+         * Matches the scale of node-level metrics (IClusterNodeMetrics,
+         * INodeMetricsSample), not the docker stats CLI convention.
+         */
         cpuUsagePercent: number;
         memoryUsedMB: number;
         lastUpdated: number;

package/dist_ts/data/service.d.ts

@@ -135,6 +135,11 @@ export interface IService {
              * The protocol for this domain entry
              */
             protocol?: 'http' | 'https' | 'ssh';
+            /**
+             * Gateway source profile for this domain's route (e.g. 'standard'
+             * for internal-only access). Defaults to the gateway's public profile.
+             */
+            sourceProfileRef?: string;
         }[];
         deploymentIds: string[];
     };

package/dist_ts/requests/gateway.d.ts

@@ -62,6 +62,11 @@ export interface IReq_SyncGatewayClientRoute extends plugins.typedrequestInterfa
         route?: IGatewayRouteConfig;
         enabled?: boolean;
         delete?: boolean;
+        /**
+         * Gateway source profile to bind the route to (by ref or name).
+         * Defaults to the gateway's public profile when omitted.
+         */
+        sourceProfileRef?: string;
     };
     response: IGatewayRouteSyncResult;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "7.21.0",
+  "version": "7.22.1",
   "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.21.0',
+  version: '7.22.1',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/data/deployment.ts

@@ -77,6 +77,12 @@ export interface IDeployment {
    * Resource usage for this deployment
    */
   resourceUsage?: {
+    /**
+     * Percent of the whole node's CPU capacity (0-100), NOT per-core:
+     * a deployment saturating one core of an 8-core node reports 12.5.
+     * Matches the scale of node-level metrics (IClusterNodeMetrics,
+     * INodeMetricsSample), not the docker stats CLI convention.
+     */
     cpuUsagePercent: number;
     memoryUsedMB: number;
     lastUpdated: number;

package/ts/data/service.ts

@@ -143,6 +143,11 @@ export interface IService {
        * The protocol for this domain entry
        */
       protocol?: 'http' | 'https' | 'ssh';
+      /**
+       * Gateway source profile for this domain's route (e.g. 'standard'
+       * for internal-only access). Defaults to the gateway's public profile.
+       */
+      sourceProfileRef?: string;
     }[];
     deploymentIds: string[];
   };

package/ts/requests/gateway.ts

@@ -92,6 +92,11 @@ export interface IReq_SyncGatewayClientRoute extends plugins.typedrequestInterfa
     route?: IGatewayRouteConfig;
     enabled?: boolean;
     delete?: boolean;
+    /**
+     * Gateway source profile to bind the route to (by ref or name).
+     * Defaults to the gateway's public profile when omitted.
+     */
+    sourceProfileRef?: string;
   };
   response: IGatewayRouteSyncResult;
 }