@serve.zone/interfaces 32.22.0 → 32.24.0

package/ts/requests/platform.ts

@@ -5,6 +5,7 @@ import type {
   IPlatformCapability,
   IPlatformProviderConfig,
   TPlatformBindingStatus,
+  TPlatformBindingStatusReason,
 } from '../platform/types.js';
 
 export interface IReq_Any_Cloudly_GetPlatformDesiredState
@@ -162,6 +163,11 @@ extends plugins.typedrequestInterfaces.implementsTR<
     endpoints?: IPlatformBinding['endpoints'];
     /** Reports the exact provider-returned bucket for an objectstorage binding. */
     objectstorageBucketName?: IPlatformBinding['objectstorageBucketName'];
+    /**
+     * Why the binding holds `status`; `validatePlatformBindingStatusReason` pairs each reason with
+     * its one status. Absent clears a stored reason.
+     */
+    statusReason?: TPlatformBindingStatusReason;
     errorText?: string;
   };
   response: {

package/ts/requests/service.ts

@@ -2,6 +2,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 { TServiceVolumeInitialization } from '../data/servicevolumeinitialization.js';
 import type { IRegistryTarget } from '../data/registry.js';
 import type { IIdentity, IIdentityCredential } from '../data/user.js';
 import type { IServiceRessources } from '../data/docker.js';
@@ -390,6 +391,33 @@ extends plugins.typedrequestInterfaces.implementsTR<
   };
 }
 
+/**
+ * Sets how one declared volume's node-local storage claim starts, the only write of
+ * `IServiceVolume.initialization`.
+ *
+ * The volume is named by its exact declared `mountPath`. `expected` is the initialization the
+ * caller read, or `null` when the volume has none; any other stored value refuses as `conflict`.
+ * While a bound local storage claim of the volume exists, a different initialization refuses as
+ * `volume-initialization-bound`. Refusals travel as `IServiceVolumeInitializationErrorData`.
+ */
+export interface IRequest_Any_Cloudly_SetServiceVolumeInitialization
+extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IRequest_Any_Cloudly_SetServiceVolumeInitialization
+> {
+  method: 'setServiceVolumeInitialization';
+  request: {
+    identity: IIdentity;
+    serviceId: string;
+    mountPath: string;
+    expected: TServiceVolumeInitialization | null;
+    initialization: TServiceVolumeInitialization;
+  };
+  response: {
+    service: IService;
+  };
+}
+
 /**
  * Writes the complete runtime spec of one service.
  *