@serve.zone/interfaces 19.2.0 → 19.3.1

package/changelog.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 2026-07-24 - 19.3.1
+
+### Fixes
+
+- align immutable placement repair with Cloudly's authenticated admin identity guard
+
+## 2026-07-24 - 19.3.0
+
+### Features
+
+- add a fenced immutable-service placement repair contract (service)
+  - Require callers to fence the active rollout and rollout-status revision.
+  - Keep placement repair separate from generic immutable service updates.
+
 ## 2026-07-24 - 19.2.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/requests/service.d.ts

@@ -1,6 +1,7 @@
 import * as plugins from '../plugins.js';
 import type { IService } from '../data/service.js';
 import type { TServiceUpdateWritableData, TServiceWritableData } from '../data/service.js';
+import type { IServicePlacement } from '../data/service.js';
 import type { IRegistryTarget } from '../data/registry.js';
 import type { IIdentity, IIdentityCredential } from '../data/user.js';
 import type { IImageRelease } from '../data/immutableimage.js';
@@ -218,6 +219,28 @@ export interface IRequest_Any_Cloudly_UpdateService extends plugins.typedrequest
         service: IService;
     };
 }
+/**
+ * Narrow administrative repair for an immutable service whose persisted
+ * placement contradicts its already-active rollout target scope.
+ *
+ * The rollout and status fences make the mutation fail closed if runtime
+ * evidence changes between inspection and repair.
+ */
+export interface IRequest_Any_Cloudly_RepairImmutableServicePlacement extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IRequest_Any_Cloudly_RepairImmutableServicePlacement> {
+    method: 'repairImmutableServicePlacement';
+    request: {
+        identity: IIdentity;
+        serviceId: string;
+        expectedRolloutId: string;
+        expectedRolloutGeneration: number;
+        expectedRolloutStatusUpdatedAt: number;
+        placement: IServicePlacement;
+    };
+    response: {
+        service: IService;
+        changed: boolean;
+    };
+}
 export interface IRequest_Any_Cloudly_DeleteServiceById extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IRequest_Any_Cloudly_DeleteServiceById> {
     method: 'deleteServiceById';
     request: {

package/package.json

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

package/ts/requests/service.ts

@@ -1,6 +1,7 @@
 import * as plugins from '../plugins.js';
 import type { IService } from '../data/service.js';
 import type { TServiceUpdateWritableData, TServiceWritableData } from '../data/service.js';
+import type { IServicePlacement } from '../data/service.js';
 import type { IRegistryTarget } from '../data/registry.js';
 import type { IIdentity, IIdentityCredential } from '../data/user.js';
 import type { IServiceRessources } from '../data/docker.js';
@@ -326,6 +327,33 @@ extends plugins.typedrequestInterfaces.implementsTR<
   };
 }
 
+/**
+ * Narrow administrative repair for an immutable service whose persisted
+ * placement contradicts its already-active rollout target scope.
+ *
+ * The rollout and status fences make the mutation fail closed if runtime
+ * evidence changes between inspection and repair.
+ */
+export interface IRequest_Any_Cloudly_RepairImmutableServicePlacement
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IRequest_Any_Cloudly_RepairImmutableServicePlacement
+> {
+  method: 'repairImmutableServicePlacement';
+  request: {
+    identity: IIdentity;
+    serviceId: string;
+    expectedRolloutId: string;
+    expectedRolloutGeneration: number;
+    expectedRolloutStatusUpdatedAt: number;
+    placement: IServicePlacement;
+  };
+  response: {
+    service: IService;
+    changed: boolean;
+  };
+}
+
 export interface IRequest_Any_Cloudly_DeleteServiceById
 extends plugins.typedrequestInterfaces.implementsTR<
   plugins.typedrequestInterfaces.ITypedRequest,