@serve.zone/interfaces 21.0.0 → 21.1.0

package/changelog.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2026-07-29 - 21.1.0
+
+### Features
+
+- bind reconciliation reports to immutable image rollouts (status)
+  - Adds a both-or-neither `rolloutId` and `rolloutGeneration` pair to
+    `reportReconciliationStatus` requests.
+  - Enables Cloudly to ignore delayed immutable-image reports from superseded
+    rollouts instead of mutating the current rollout state.
+
 ## 2026-07-29 - 21.0.0
 
 ### Breaking Changes

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/requests/status.d.ts

@@ -1,6 +1,13 @@
 import * as plugins from '../plugins.js';
 import * as serviceInterfaces from '../data/service.js';
 import * as userInterfaces from '../data/user.js';
+type TReportReconciliationRolloutIdentity = {
+    rolloutId: string;
+    rolloutGeneration: number;
+} | {
+    rolloutId?: never;
+    rolloutGeneration?: never;
+};
 /**
  * a status update dashboard
  */
@@ -24,6 +31,7 @@ export interface IRequest_Coreflow_Cloudly_ReportReconciliationStatus extends pl
         message?: string;
         errorText?: string;
         reportedAt?: number;
-    };
+    } & TReportReconciliationRolloutIdentity;
     response: {};
 }
+export {};

package/package.json

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

package/ts/requests/status.ts

@@ -2,6 +2,16 @@ import * as plugins from '../plugins.js';
 import * as serviceInterfaces from '../data/service.js';
 import * as userInterfaces from '../data/user.js';
 
+type TReportReconciliationRolloutIdentity =
+  | {
+      rolloutId: string;
+      rolloutGeneration: number;
+    }
+  | {
+      rolloutId?: never;
+      rolloutGeneration?: never;
+    };
+
 /**
  * a status update dashboard
  */
@@ -23,17 +33,19 @@ export interface IRequest_Coreflow_Cloudly_ReportReconciliationStatus
     IRequest_Coreflow_Cloudly_ReportReconciliationStatus
   > {
   method: 'reportReconciliationStatus';
-  request: {
-    identity: userInterfaces.IIdentity;
-    serviceId: string;
-    serviceName?: string;
-    stage: string;
-    stageKey?: string;
-    status: serviceInterfaces.TServiceReconciliationStatus;
-    domainName?: string;
-    message?: string;
-    errorText?: string;
-    reportedAt?: number;
-  };
+  request:
+    & {
+      identity: userInterfaces.IIdentity;
+      serviceId: string;
+      serviceName?: string;
+      stage: string;
+      stageKey?: string;
+      status: serviceInterfaces.TServiceReconciliationStatus;
+      domainName?: string;
+      message?: string;
+      errorText?: string;
+      reportedAt?: number;
+    }
+    & TReportReconciliationRolloutIdentity;
   response: {};
 }