@serve.zone/interfaces 32.53.0 → 32.54.0

package/changelog.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2026-10-12 - 32.54.0
+
+### Features
+
+- `IRequest_Any_Cloudly_ReadServiceDeploymentStatus` (`readServiceDeploymentStatus`) reads one
+  deployment operation's status without changing it. It takes the request of
+  `getServiceDeploymentStatus` (`identity`, `serviceId`, `operationId`) and answers the same
+  `IServiceDeploymentStatus`, but Cloudly transitions nothing, records no failure and schedules no
+  recovery for it. A rollout failure or an expired startup grace shows only in the returned
+  evidence. `getServiceDeploymentStatus` keeps advancing a rolling-out operation for a deployment
+  that polls its own rollout. An inspection such as `tsdeploy deploy-status` uses the read.
+
+### Maintenance
+
+- release tooling: @git.zone/tsbuild 6.0.2, @git.zone/tsrun 3.0.3, @types/node 26.6.4, pnpm 12.9.1
+
 ## 2026-10-08 - 32.53.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/requests/service.d.ts

@@ -173,6 +173,11 @@ export interface IRequest_Any_Cloudly_ReserveServiceDeployment extends plugins.t
         registryTarget: IRegistryTarget;
     };
 }
+/**
+ * Answers one deployment operation's status and advances it: a rolling-out operation whose runtime
+ * evidence proves success or failure is transitioned before the answer. A deployment that polls
+ * its own rollout uses it; an inspection uses `readServiceDeploymentStatus`.
+ */
 export interface IRequest_Any_Cloudly_GetServiceDeploymentStatus extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IRequest_Any_Cloudly_GetServiceDeploymentStatus> {
     method: 'getServiceDeploymentStatus';
     request: {
@@ -184,6 +189,24 @@ export interface IRequest_Any_Cloudly_GetServiceDeploymentStatus extends plugins
         status: IServiceDeploymentStatus;
     };
 }
+/**
+ * Answers one deployment operation's status, as `getServiceDeploymentStatus` projects it, and
+ * changes nothing: no transition, no failure recorded, no recovery scheduled. A rollout failure or
+ * an expired startup grace shows in the returned evidence only, and the persisted operation keeps
+ * its state, revision, timestamps and evidence. It takes the same identity and the
+ * `deployment:status` capability.
+ */
+export interface IRequest_Any_Cloudly_ReadServiceDeploymentStatus extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IRequest_Any_Cloudly_ReadServiceDeploymentStatus> {
+    method: 'readServiceDeploymentStatus';
+    request: {
+        identity: IIdentityCredential;
+        serviceId: string;
+        operationId: string;
+    };
+    response: {
+        status: IServiceDeploymentStatus;
+    };
+}
 export interface IRequest_Any_Cloudly_PromoteServiceDeploymentRoute extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IRequest_Any_Cloudly_PromoteServiceDeploymentRoute> {
     method: 'promoteServiceDeploymentRoute';
     request: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "32.53.0",
+  "version": "32.54.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {
@@ -27,11 +27,11 @@
     "@tsclass/tsclass": "^9.5.1"
   },
   "devDependencies": {
-    "@git.zone/tsbuild": "^6.0.0",
+    "@git.zone/tsbuild": "^6.0.2",
     "@git.zone/tsdoc": "^3.0.2",
-    "@git.zone/tsrun": "^3.0.2",
+    "@git.zone/tsrun": "^3.0.3",
     "@git.zone/tstest": "^7.2.0",
-    "@types/node": "26.6.3",
+    "@types/node": "26.6.4",
     "typescript": "^6.0.3"
   },
   "files": [

package/readme.md

@@ -3662,7 +3662,7 @@ The immutable deployment workflow is:
 1. Reserve the exact service, namespace, registry repository/tag, and route intent with `reserveServiceDeployment`.
 2. Push the OCI index to the returned exact tag with the authenticated deployer identity.
 3. Promote the authenticated release evidence with `promoteServiceImageRelease`.
-4. Observe exact rollout and runtime-digest evidence with `getServiceDeploymentStatus`.
+4. Observe exact rollout and runtime-digest evidence with `getServiceDeploymentStatus`. That request is for a deployment polling its own rollout: Cloudly transitions a rolling-out operation to success or failure as its evidence proves either. An inspection, such as `tsdeploy deploy-status`, uses `readServiceDeploymentStatus` instead. It takes the same request and answers the same `IServiceDeploymentStatus`, but changes nothing.
 5. For a greenfield service, expose and verify its public route with `promoteServiceDeploymentRoute` only after the immutable rollout succeeds.
 
 A legacy `deployOnPush` service without deployable source moves to a greenfield successor by a legacy import, which replaces step 2:

package/ts/00_commitinfo_data.ts

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

package/ts/requests/service.ts

@@ -262,6 +262,11 @@ extends plugins.typedrequestInterfaces.implementsTR<
   };
 }
 
+/**
+ * Answers one deployment operation's status and advances it: a rolling-out operation whose runtime
+ * evidence proves success or failure is transitioned before the answer. A deployment that polls
+ * its own rollout uses it; an inspection uses `readServiceDeploymentStatus`.
+ */
 export interface IRequest_Any_Cloudly_GetServiceDeploymentStatus
 extends plugins.typedrequestInterfaces.implementsTR<
   plugins.typedrequestInterfaces.ITypedRequest,
@@ -278,6 +283,29 @@ extends plugins.typedrequestInterfaces.implementsTR<
   };
 }
 
+/**
+ * Answers one deployment operation's status, as `getServiceDeploymentStatus` projects it, and
+ * changes nothing: no transition, no failure recorded, no recovery scheduled. A rollout failure or
+ * an expired startup grace shows in the returned evidence only, and the persisted operation keeps
+ * its state, revision, timestamps and evidence. It takes the same identity and the
+ * `deployment:status` capability.
+ */
+export interface IRequest_Any_Cloudly_ReadServiceDeploymentStatus
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IRequest_Any_Cloudly_ReadServiceDeploymentStatus
+> {
+  method: 'readServiceDeploymentStatus';
+  request: {
+    identity: IIdentityCredential;
+    serviceId: string;
+    operationId: string;
+  };
+  response: {
+    status: IServiceDeploymentStatus;
+  };
+}
+
 export interface IRequest_Any_Cloudly_PromoteServiceDeploymentRoute
 extends plugins.typedrequestInterfaces.implementsTR<
   plugins.typedrequestInterfaces.ITypedRequest,