@serve.zone/interfaces 7.23.0 → 7.25.0

package/changelog.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2026-06-16 - 7.25.0
+
+### Features
+
+- add Cloudly base service reconciliation request contracts (requests)
+  - Add reconciliation result and TypedRequest interfaces for triggering and reporting base service reconciliation.
+  - Use a type-only import for identity interfaces in admin request contracts.
+  - Bump @git.zone/tsdoc to ^2.1.1 and @types/node to ^25.9.2.
+
+## 2026-06-12 - 7.24.0
+
+### Features
+
+- add live health status to node resource usage entries (node)
+  - INodeDeploymentResourceUsage gains an optional healthStatus reported by coreflow's in-process health prober.
+
 ## 2026-06-12 - 7.23.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/requests/admin.d.ts

@@ -1,5 +1,5 @@
 import * as plugins from '../plugins.js';
-import * as userInterfaces from '../data/user.js';
+import type { IIdentity } from '../data/user.js';
 export interface IReq_Admin_LoginWithUsernameAndPassword extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Admin_LoginWithUsernameAndPassword> {
     method: 'adminLoginWithUsernameAndPassword';
     request: {
@@ -7,6 +7,30 @@ export interface IReq_Admin_LoginWithUsernameAndPassword extends plugins.typedre
         password: string;
     };
     response: {
-        identity: userInterfaces.IIdentity;
+        identity: IIdentity;
+    };
+}
+export interface ICoreflowBaseServiceReconciliationResult {
+    status: 'fulfilled' | 'rejected';
+    nodeNames: string[];
+    message?: string;
+}
+export interface IReq_Any_Cloudly_ReconcileBaseServices extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_ReconcileBaseServices> {
+    method: 'reconcileBaseServices';
+    request: {
+        identity: IIdentity;
+    };
+    response: {
+        triggeredCoreflows: number;
+        successfulCoreflows: number;
+        failedCoreflows: number;
+        results: ICoreflowBaseServiceReconciliationResult[];
+    };
+}
+export interface IReq_Cloudly_Coreflow_ReconcileBaseServices extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Coreflow_ReconcileBaseServices> {
+    method: 'coreflowReconcileBaseServices';
+    request: Record<string, never>;
+    response: {
+        success: boolean;
     };
 }

package/dist_ts/requests/admin.js

@@ -1,3 +1,2 @@
 import * as plugins from '../plugins.js';
-import * as userInterfaces from '../data/user.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRtaW4uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9yZXF1ZXN0cy9hZG1pbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEtBQUssY0FBYyxNQUFNLGlCQUFpQixDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRtaW4uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9yZXF1ZXN0cy9hZG1pbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQyJ9

package/dist_ts/requests/node.d.ts

@@ -153,6 +153,8 @@ export interface INodeDeploymentResourceUsage {
     deploymentId: string;
     cpuUsagePercent: number;
     memoryUsedMB: number;
+    /** Live verdict from coreflow's in-process health prober, when available. */
+    healthStatus?: 'healthy' | 'unhealthy' | 'unknown';
 }
 /**
  * Admin UI asks Cloudly for a node's live per-deployment resource usage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "7.23.0",
+  "version": "7.25.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {
@@ -16,10 +16,10 @@
   },
   "devDependencies": {
     "@git.zone/tsbuild": "^4.4.2",
-    "@git.zone/tsdoc": "^2.0.6",
+    "@git.zone/tsdoc": "^2.1.1",
     "@git.zone/tsrun": "^2.0.4",
     "@git.zone/tstest": "^3.6.6",
-    "@types/node": "^25.9.1"
+    "@types/node": "^25.9.2"
   },
   "files": [
     "ts/**/*",

package/ts/00_commitinfo_data.ts

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

package/ts/requests/admin.ts

@@ -1,5 +1,5 @@
 import * as plugins from '../plugins.js';
-import * as userInterfaces from '../data/user.js';
+import type { IIdentity } from '../data/user.js';
 
 export interface IReq_Admin_LoginWithUsernameAndPassword extends plugins.typedrequestInterfaces.implementsTR<
   plugins.typedrequestInterfaces.ITypedRequest,
@@ -11,6 +11,39 @@ export interface IReq_Admin_LoginWithUsernameAndPassword extends plugins.typedre
     password: string;
   };
   response: {
-    identity: userInterfaces.IIdentity;
+    identity: IIdentity;
   }
-}
+}
+
+export interface ICoreflowBaseServiceReconciliationResult {
+  status: 'fulfilled' | 'rejected';
+  nodeNames: string[];
+  message?: string;
+}
+
+export interface IReq_Any_Cloudly_ReconcileBaseServices extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_ReconcileBaseServices
+> {
+  method: 'reconcileBaseServices';
+  request: {
+    identity: IIdentity;
+  };
+  response: {
+    triggeredCoreflows: number;
+    successfulCoreflows: number;
+    failedCoreflows: number;
+    results: ICoreflowBaseServiceReconciliationResult[];
+  };
+}
+
+export interface IReq_Cloudly_Coreflow_ReconcileBaseServices extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Coreflow_ReconcileBaseServices
+> {
+  method: 'coreflowReconcileBaseServices';
+  request: Record<string, never>;
+  response: {
+    success: boolean;
+  };
+}

package/ts/requests/node.ts

@@ -193,6 +193,8 @@ export interface INodeDeploymentResourceUsage {
   deploymentId: string;
   cpuUsagePercent: number;
   memoryUsedMB: number;
+  /** Live verdict from coreflow's in-process health prober, when available. */
+  healthStatus?: 'healthy' | 'unhealthy' | 'unknown';
 }
 
 /**