@serve.zone/interfaces 7.5.0 → 7.7.0

package/changelog.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2026-06-10 - 7.7.0
+
+### Features
+
+- add reporter node scoping to deployment snapshots (deployment)
+  - Adds optional reporterNodeNames to deployment snapshot requests to identify the node hostnames a report is authoritative for.
+  - Preserves existing full-service replacement behavior when reporterNodeNames is omitted.
+
+## 2026-06-10 - 7.6.0
+
+### Features
+
+- add deployment snapshot and reconciliation request contracts (requests/deployment)
+  - Add typed request contract for reporting deployment snapshots with service metadata and deployment data.
+  - Add push request contracts for deployment updates and service reconciliation status.
+
 ## 2026-06-09 - 7.5.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/requests/deployment.d.ts

@@ -295,3 +295,37 @@ export interface IReq_Cloudly_Coreflow_DeploymentWorkspaceExec extends plugins.t
         exitCode?: number;
     };
 }
+export interface IReq_Coreflow_Cloudly_ReportDeploymentSnapshots extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Coreflow_Cloudly_ReportDeploymentSnapshots> {
+    method: 'reportDeploymentSnapshots';
+    request: {
+        identity: IIdentity;
+        serviceId: string;
+        serviceName?: string;
+        deployments: IDeployment[];
+        /**
+         * Node hostnames this snapshot is authoritative for (the reporter's swarm).
+         * Cloudly prunes stale deployments for the service only on these nodes, so
+         * reports from different swarms/nodes do not delete each other's records.
+         * When absent, the snapshot replaces all persisted deployments of the service.
+         */
+        reporterNodeNames?: string[];
+        reportedAt: number;
+    };
+    response: Record<string, never>;
+}
+export interface IReq_Cloudly_Any_PushDeploymentUpdate extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Any_PushDeploymentUpdate> {
+    method: 'pushDeploymentUpdate';
+    request: {
+        serviceId: string;
+        deployments: IDeployment[];
+    };
+    response: Record<string, never>;
+}
+export interface IReq_Cloudly_Any_PushServiceReconciliationStatus extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Cloudly_Any_PushServiceReconciliationStatus> {
+    method: 'pushServiceReconciliationStatus';
+    request: {
+        serviceId: string;
+        reconciliationStatus: NonNullable<IService['data']['reconciliationStatus']>;
+    };
+    response: Record<string, never>;
+}

package/package.json

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

package/ts/requests/deployment.ts

@@ -431,3 +431,52 @@ extends plugins.typedrequestInterfaces.implementsTR<
     exitCode?: number;
   };
 }
+
+export interface IReq_Coreflow_Cloudly_ReportDeploymentSnapshots
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Coreflow_Cloudly_ReportDeploymentSnapshots
+> {
+  method: 'reportDeploymentSnapshots';
+  request: {
+    identity: IIdentity;
+    serviceId: string;
+    serviceName?: string;
+    deployments: IDeployment[];
+    /**
+     * Node hostnames this snapshot is authoritative for (the reporter's swarm).
+     * Cloudly prunes stale deployments for the service only on these nodes, so
+     * reports from different swarms/nodes do not delete each other's records.
+     * When absent, the snapshot replaces all persisted deployments of the service.
+     */
+    reporterNodeNames?: string[];
+    reportedAt: number;
+  };
+  response: Record<string, never>;
+}
+
+export interface IReq_Cloudly_Any_PushDeploymentUpdate
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Any_PushDeploymentUpdate
+> {
+  method: 'pushDeploymentUpdate';
+  request: {
+    serviceId: string;
+    deployments: IDeployment[];
+  };
+  response: Record<string, never>;
+}
+
+export interface IReq_Cloudly_Any_PushServiceReconciliationStatus
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Cloudly_Any_PushServiceReconciliationStatus
+> {
+  method: 'pushServiceReconciliationStatus';
+  request: {
+    serviceId: string;
+    reconciliationStatus: NonNullable<IService['data']['reconciliationStatus']>;
+  };
+  response: Record<string, never>;
+}