@serve.zone/interfaces 7.24.0 → 7.26.0

package/changelog.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 2026-06-17 - 7.26.0
+
+### Features
+
+- add node service reconciliation and runtime update interfaces (node)
+  - Add serveZoneServiceUpdate as a supported node action and expose serve.zone service runtime status on node runtime data.
+  - Add typed request contracts for reconciling node base services and pushing node runtime updates.
+
+## 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

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/data/clusternode.d.ts

@@ -22,7 +22,7 @@ export interface INodeMetricsSample {
     /** Host-level network transmit rate across non-loopback interfaces. */
     networkTxBytesPerSec?: number;
 }
-export type TNodeActionName = 'systemUpgrade' | 'reboot';
+export type TNodeActionName = 'systemUpgrade' | 'reboot' | 'serveZoneServiceUpdate';
 export type TNodeActionStatus = 'pending' | 'running' | 'succeeded' | 'failed';
 /**
  * An operator-requested action executed by spark on a node.
@@ -43,6 +43,19 @@ export interface INodeAction {
     finishedAt?: number;
     resultText?: string;
 }
+export interface IServeZoneServiceRuntimeInfo {
+    name: string;
+    serviceId?: string;
+    image?: string;
+    desiredImage?: string;
+    imageVersion?: string;
+    runningImageId?: string;
+    runningTaskCount?: number;
+    running: boolean;
+    checkedAt: number;
+    updatedAt?: number;
+    error?: string;
+}
 /** Spark -> Cloudly HTTP body for POST /spark/v1/nodes/metrics-sample */
 export interface ISparkMetricsSampleRequest {
     nodeId: string;
@@ -82,6 +95,7 @@ export interface ISparkNodeRuntimeInfo {
     cloudlyConnectionStatus: TSparkCloudlyConnectionStatus;
     dockerAvailable: boolean;
     swarmNodeId?: string;
+    serveZoneServices?: IServeZoneServiceRuntimeInfo[];
     checkedAt: number;
     lastError?: string;
 }

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

@@ -172,6 +172,19 @@ export interface IReq_Any_Cloudly_GetNodeResourceUsage extends plugins.typedrequ
         timestamp: number;
     };
 }
+export interface IReq_Any_Cloudly_ReconcileNodeBaseServices extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_ReconcileNodeBaseServices> {
+    method: 'reconcileNodeBaseServices';
+    request: {
+        identity: IIdentity;
+        nodeId: string;
+    };
+    response: {
+        nodeId: string;
+        nodeName: string;
+        success: boolean;
+        message?: string;
+    };
+}
 /**
  * Cloudly asks a node's coreflow for live per-deployment resource usage.
  */
@@ -204,3 +217,10 @@ export interface IReq_Cloudly_Any_PushNodeActionUpdate extends plugins.typedrequ
     };
     response: Record<string, never>;
 }
+export interface IReq_Cloudly_Any_PushNodeRuntimeUpdate extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Any_PushNodeRuntimeUpdate> {
+    method: 'pushNodeRuntimeUpdate';
+    request: {
+        node: IClusterNode;
+    };
+    response: Record<string, never>;
+}

package/package.json

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

package/ts/data/clusternode.ts

@@ -25,7 +25,7 @@ export interface INodeMetricsSample {
   networkTxBytesPerSec?: number;
 }
 
-export type TNodeActionName = 'systemUpgrade' | 'reboot';
+export type TNodeActionName = 'systemUpgrade' | 'reboot' | 'serveZoneServiceUpdate';
 
 export type TNodeActionStatus = 'pending' | 'running' | 'succeeded' | 'failed';
 
@@ -49,6 +49,20 @@ export interface INodeAction {
   resultText?: string;
 }
 
+export interface IServeZoneServiceRuntimeInfo {
+  name: string;
+  serviceId?: string;
+  image?: string;
+  desiredImage?: string;
+  imageVersion?: string;
+  runningImageId?: string;
+  runningTaskCount?: number;
+  running: boolean;
+  checkedAt: number;
+  updatedAt?: number;
+  error?: string;
+}
+
 /** Spark -> Cloudly HTTP body for POST /spark/v1/nodes/metrics-sample */
 export interface ISparkMetricsSampleRequest {
   nodeId: string;
@@ -98,6 +112,7 @@ export interface ISparkNodeRuntimeInfo {
   cloudlyConnectionStatus: TSparkCloudlyConnectionStatus;
   dockerAvailable: boolean;
   swarmNodeId?: string;
+  serveZoneServices?: IServeZoneServiceRuntimeInfo[];
   checkedAt: number;
   lastError?: string;
 }

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

@@ -217,6 +217,23 @@ export interface IReq_Any_Cloudly_GetNodeResourceUsage extends plugins.typedrequ
   };
 }
 
+export interface IReq_Any_Cloudly_ReconcileNodeBaseServices extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_ReconcileNodeBaseServices
+> {
+  method: 'reconcileNodeBaseServices';
+  request: {
+    identity: IIdentity;
+    nodeId: string;
+  };
+  response: {
+    nodeId: string;
+    nodeName: string;
+    success: boolean;
+    message?: string;
+  };
+}
+
 /**
  * Cloudly asks a node's coreflow for live per-deployment resource usage.
  */
@@ -260,3 +277,14 @@ export interface IReq_Cloudly_Any_PushNodeActionUpdate extends plugins.typedrequ
   };
   response: Record<string, never>;
 }
+
+export interface IReq_Cloudly_Any_PushNodeRuntimeUpdate extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Any_PushNodeRuntimeUpdate
+> {
+  method: 'pushNodeRuntimeUpdate';
+  request: {
+    node: IClusterNode;
+  };
+  response: Record<string, never>;
+}