@metal-stack/api 0.0.59 → 0.0.61

package/js/metalstack/infra/v2/bmc_pb.ts

@@ -18,20 +18,20 @@ export const file_metalstack_infra_v2_bmc: GenFile = /*@__PURE__*/
   fileDesc("Ch1tZXRhbHN0YWNrL2luZnJhL3YyL2JtYy5wcm90bxITbWV0YWxzdGFjay5pbmZyYS52MiLtAQoUVXBkYXRlQk1DSW5mb1JlcXVlc3QSHgoJcGFydGl0aW9uGAEgASgJQgu6SAhyBtCzrrECARJdCgtibWNfcmVwb3J0cxgCIAMoCzI5Lm1ldGFsc3RhY2suaW5mcmEudjIuVXBkYXRlQk1DSW5mb1JlcXVlc3QuQm1jUmVwb3J0c0VudHJ5Qg26SAqaAQciBXIDsAEBGlYKD0JtY1JlcG9ydHNFbnRyeRILCgNrZXkYASABKAkSMgoFdmFsdWUYAiABKAsyIy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DUmVwb3J0OgI4ASJLChVVcGRhdGVCTUNJbmZvUmVzcG9uc2USGAoQdXBkYXRlZF9tYWNoaW5lcxgBIAMoCRIYChBjcmVhdGVkX21hY2hpbmVzGAIgAygJIjoKGFdhaXRGb3JCTUNDb21tYW5kUmVxdWVzdBIeCglwYXJ0aXRpb24YASABKAlCC7pICHIG0LOusQIBIrYBChlXYWl0Rm9yQk1DQ29tbWFuZFJlc3BvbnNlEhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEjkKC2JtY19jb21tYW5kGAIgASgOMiQubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUJNQ0NvbW1hbmQSMgoLbWFjaGluZV9ibWMYAyABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DEhIKCmNvbW1hbmRfaWQYBCABKAkiSQoVQk1DQ29tbWFuZERvbmVSZXF1ZXN0EhIKCmNvbW1hbmRfaWQYASABKAkSEgoFZXJyb3IYAiABKAlIAIgBAUIICgZfZXJyb3IiGAoWQk1DQ29tbWFuZERvbmVSZXNwb25zZTL2AgoKQk1DU2VydmljZRJxCg1VcGRhdGVCTUNJbmZvEikubWV0YWxzdGFjay5pbmZyYS52Mi5VcGRhdGVCTUNJbmZvUmVxdWVzdBoqLm1ldGFsc3RhY2suaW5mcmEudjIuVXBkYXRlQk1DSW5mb1Jlc3BvbnNlIgng8xgC6vMYAQESfwoRV2FpdEZvckJNQ0NvbW1hbmQSLS5tZXRhbHN0YWNrLmluZnJhLnYyLldhaXRGb3JCTUNDb21tYW5kUmVxdWVzdBouLm1ldGFsc3RhY2suaW5mcmEudjIuV2FpdEZvckJNQ0NvbW1hbmRSZXNwb25zZSIJ4PMYAurzGAEBMAESdAoOQk1DQ29tbWFuZERvbmUSKi5tZXRhbHN0YWNrLmluZnJhLnYyLkJNQ0NvbW1hbmREb25lUmVxdWVzdBorLm1ldGFsc3RhY2suaW5mcmEudjIuQk1DQ29tbWFuZERvbmVSZXNwb25zZSIJ4PMYAerzGAEBQswBChdjb20ubWV0YWxzdGFjay5pbmZyYS52MkIIQm1jUHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9pbmZyYS92MjtpbmZyYXYyogIDTUlYqgITTWV0YWxzdGFjay5JbmZyYS5WMsoCE01ldGFsc3RhY2tcSW5mcmFcVjLiAh9NZXRhbHN0YWNrXEluZnJhXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6SW5mcmE6OlYyYgZwcm90bzM", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_machine, file_metalstack_api_v2_predefined_rules]);
 
 /**
- * UpdateBMCInfoRequest
+ * UpdateBMCInfoRequest is the request payload for updating BMC information.
  *
  * @generated from message metalstack.infra.v2.UpdateBMCInfoRequest
  */
 export type UpdateBMCInfoRequest = Message<"metalstack.infra.v2.UpdateBMCInfoRequest"> & {
   /**
-   * Partition the partition id where metal-bmc wants to receive events
+   * Partition is the partition ID where metal-bmc wants to receive events
    *
    * @generated from field: string partition = 1;
    */
   partition: string;
 
   /**
-   * BmcReports contains maps the bmc report per machine uuid
+   * BmcReports contains maps the BMC report per machine UUID
    *
    * @generated from field: map<string, metalstack.api.v2.MachineBMCReport> bmc_reports = 2;
    */
@@ -46,20 +46,20 @@ export const UpdateBMCInfoRequestSchema: GenMessage<UpdateBMCInfoRequest> = /*@_
   messageDesc(file_metalstack_infra_v2_bmc, 0);
 
 /**
- * UpdateBMCInfoResponse
+ * UpdateBMCInfoResponse is the response payload for updating BMC information.
  *
  * @generated from message metalstack.infra.v2.UpdateBMCInfoResponse
  */
 export type UpdateBMCInfoResponse = Message<"metalstack.infra.v2.UpdateBMCInfoResponse"> & {
   /**
-   * UpdatedMachines is a slice of machine uuids which were updated
+   * UpdatedMachines is a slice of machine UUIDs which were updated
    *
    * @generated from field: repeated string updated_machines = 1;
    */
   updatedMachines: string[];
 
   /**
-   * CreatedMachines is a slice of machine uuids which were created
+   * CreatedMachines is a slice of machine UUIDs which were created
    *
    * @generated from field: repeated string created_machines = 2;
    */
@@ -74,13 +74,13 @@ export const UpdateBMCInfoResponseSchema: GenMessage<UpdateBMCInfoResponse> = /*
   messageDesc(file_metalstack_infra_v2_bmc, 1);
 
 /**
- * WaitForBMCCommandRequest
+ * WaitForBMCCommandRequest is the request payload for waiting for a BMC command.
  *
  * @generated from message metalstack.infra.v2.WaitForBMCCommandRequest
  */
 export type WaitForBMCCommandRequest = Message<"metalstack.infra.v2.WaitForBMCCommandRequest"> & {
   /**
-   * Partition the partition id where metal-bmc wants to receive bmc commands
+   * Partition is the partition ID where metal-bmc wants to receive BMC commands
    *
    * @generated from field: string partition = 1;
    */
@@ -95,7 +95,7 @@ export const WaitForBMCCommandRequestSchema: GenMessage<WaitForBMCCommandRequest
   messageDesc(file_metalstack_infra_v2_bmc, 2);
 
 /**
- * WaitForBMCCommandResponse
+ * WaitForBMCCommandResponse is the response payload for waiting for a BMC command.
  *
  * @generated from message metalstack.infra.v2.WaitForBMCCommandResponse
  */
@@ -108,14 +108,14 @@ export type WaitForBMCCommandResponse = Message<"metalstack.infra.v2.WaitForBMCC
   uuid: string;
 
   /**
-   * BmcCommand to execute against the bmc of the machine
+   * BmcCommand to execute against the BMC of the machine
    *
    * @generated from field: metalstack.api.v2.MachineBMCCommand bmc_command = 2;
    */
   bmcCommand: MachineBMCCommand;
 
   /**
-   * MachineBmc contains connection details of the machine to issue the bmcCommand to
+   * MachineBmc contains connection details of the machine to issue the BMC command to
    *
    * @generated from field: metalstack.api.v2.MachineBMC machine_bmc = 3;
    */
@@ -123,7 +123,7 @@ export type WaitForBMCCommandResponse = Message<"metalstack.infra.v2.WaitForBMCC
 
   /**
    * CommandId is a unique ID which must be sent back after execution
-   * it is usually in the form: <machine-uuid>:machine-bmc-command:<command>
+   * It is usually in the form: <machine-uuid>:machine-bmc-command:<command>
    *
    * @generated from field: string command_id = 4;
    */
@@ -138,14 +138,14 @@ export const WaitForBMCCommandResponseSchema: GenMessage<WaitForBMCCommandRespon
   messageDesc(file_metalstack_infra_v2_bmc, 3);
 
 /**
- * BMCCommandDoneRequest must be returned after command execution
+ * BMCCommandDoneRequest must be returned after command execution.
  *
  * @generated from message metalstack.infra.v2.BMCCommandDoneRequest
  */
 export type BMCCommandDoneRequest = Message<"metalstack.infra.v2.BMCCommandDoneRequest"> & {
   /**
    * CommandId is a unique ID which must be sent back after execution
-   * it is usually in the form: <machine-uuid>:machine-bmc-command
+   * It is usually in the form: <machine-uuid>:machine-bmc-command
    *
    * @generated from field: string command_id = 1;
    */
@@ -167,7 +167,7 @@ export const BMCCommandDoneRequestSchema: GenMessage<BMCCommandDoneRequest> = /*
   messageDesc(file_metalstack_infra_v2_bmc, 4);
 
 /**
- * BMCCommandDoneResponse
+ * BMCCommandDoneResponse is the response payload for BMC command completion.
  *
  * @generated from message metalstack.infra.v2.BMCCommandDoneResponse
  */
@@ -182,13 +182,13 @@ export const BMCCommandDoneResponseSchema: GenMessage<BMCCommandDoneResponse> =
   messageDesc(file_metalstack_infra_v2_bmc, 5);
 
 /**
- * BMCService serves bmc related functions
+ * BMCService provides BMC management operations.
  *
  * @generated from service metalstack.infra.v2.BMCService
  */
 export const BMCService: GenService<{
   /**
-   * UpdateBMCInfo
+   * Updates BMC information.
    *
    * @generated from rpc metalstack.infra.v2.BMCService.UpdateBMCInfo
    */
@@ -198,7 +198,7 @@ export const BMCService: GenService<{
     output: typeof UpdateBMCInfoResponseSchema;
   },
   /**
-   * WaitForBMCCommand is called by the metal-bmc and is returned with a bmc command to execute.
+   * WaitForBMCCommand is called by the metal-bmc and returns a BMC command to execute.
    *
    * @generated from rpc metalstack.infra.v2.BMCService.WaitForBMCCommand
    */
@@ -208,7 +208,7 @@ export const BMCService: GenService<{
     output: typeof WaitForBMCCommandResponseSchema;
   },
   /**
-   * BMCCommandDone must be called from metal-bmc after the command execution
+   * BMCCommandDone must be called from metal-bmc after the command execution.
    *
    * @generated from rpc metalstack.infra.v2.BMCService.BMCCommandDone
    */

package/js/metalstack/infra/v2/boot_pb.d.ts

@@ -298,7 +298,7 @@ export type BootServiceSuperUserPasswordResponse = Message<"metalstack.infra.v2.
  */
 export declare const BootServiceSuperUserPasswordResponseSchema: GenMessage<BootServiceSuperUserPasswordResponse>;
 /**
- * BootService is used for all boot related requests, either pixiecore or metal-hammer
+ * BootService provides boot-related operations for pixiecore and metal-hammer.
  *
  * Pixiecore
  *
@@ -306,7 +306,7 @@ export declare const BootServiceSuperUserPasswordResponseSchema: GenMessage<Boot
  */
 export declare const BootService: GenService<{
     /**
-     * Dhcp is the first dhcp request (option 97). A ProvisioningEventPXEBooting is fired
+     * Dhcp handles the first DHCP request (option 97). A ProvisioningEventPXEBooting is fired.
      *
      * @generated from rpc metalstack.infra.v2.BootService.Dhcp
      */
@@ -316,7 +316,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceDhcpResponseSchema;
     };
     /**
-     * Boot is called from pixie once the machine got the first dhcp response and ipxie asks for subsequent kernel and initrd
+     * Boot is called from pixie once the machine got the first DHCP response and ipxe asks for subsequent kernel and initrd.
      *
      * @generated from rpc metalstack.infra.v2.BootService.Boot
      */
@@ -326,7 +326,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceBootResponseSchema;
     };
     /**
-     * SuperUserPassword metal-hammer takes the configured root password for the bmc from metal-apiserver and configure the bmc accordingly
+     * SuperUserPassword returns the configured root password for the BMC.
      *
      * @generated from rpc metalstack.infra.v2.BootService.SuperUserPassword
      */
@@ -336,7 +336,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceSuperUserPasswordResponseSchema;
     };
     /**
-     * Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all gory details about that machine
+     * Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all details about that machine.
      *
      * @generated from rpc metalstack.infra.v2.BootService.Register
      */
@@ -346,7 +346,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceRegisterResponseSchema;
     };
     /**
-     * Wait is a hanging call that waits until the machine gets allocated by a user
+     * Wait is a hanging call that waits until the machine gets allocated by a user.
      *
      * @generated from rpc metalstack.infra.v2.BootService.Wait
      */
@@ -356,7 +356,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceWaitResponseSchema;
     };
     /**
-     * InstallationSucceeded tells metal-apiserver installation was either successful
+     * InstallationSucceeded tells metal-apiserver that installation was successful.
      *
      * @generated from rpc metalstack.infra.v2.BootService.InstallationSucceeded
      */

package/js/metalstack/infra/v2/boot_pb.js

@@ -71,7 +71,7 @@ export const BootServiceSuperUserPasswordRequestSchema = /*@__PURE__*/ messageDe
  */
 export const BootServiceSuperUserPasswordResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_infra_v2_boot, 11);
 /**
- * BootService is used for all boot related requests, either pixiecore or metal-hammer
+ * BootService provides boot-related operations for pixiecore and metal-hammer.
  *
  * Pixiecore
  *

package/js/metalstack/infra/v2/boot_pb.ts

@@ -363,7 +363,7 @@ export const BootServiceSuperUserPasswordResponseSchema: GenMessage<BootServiceS
   messageDesc(file_metalstack_infra_v2_boot, 11);
 
 /**
- * BootService is used for all boot related requests, either pixiecore or metal-hammer
+ * BootService provides boot-related operations for pixiecore and metal-hammer.
  *
  * Pixiecore
  *
@@ -371,7 +371,7 @@ export const BootServiceSuperUserPasswordResponseSchema: GenMessage<BootServiceS
  */
 export const BootService: GenService<{
   /**
-   * Dhcp is the first dhcp request (option 97). A ProvisioningEventPXEBooting is fired
+   * Dhcp handles the first DHCP request (option 97). A ProvisioningEventPXEBooting is fired.
    *
    * @generated from rpc metalstack.infra.v2.BootService.Dhcp
    */
@@ -381,7 +381,7 @@ export const BootService: GenService<{
     output: typeof BootServiceDhcpResponseSchema;
   },
   /**
-   * Boot is called from pixie once the machine got the first dhcp response and ipxie asks for subsequent kernel and initrd
+   * Boot is called from pixie once the machine got the first DHCP response and ipxe asks for subsequent kernel and initrd.
    *
    * @generated from rpc metalstack.infra.v2.BootService.Boot
    */
@@ -391,7 +391,7 @@ export const BootService: GenService<{
     output: typeof BootServiceBootResponseSchema;
   },
   /**
-   * SuperUserPassword metal-hammer takes the configured root password for the bmc from metal-apiserver and configure the bmc accordingly
+   * SuperUserPassword returns the configured root password for the BMC.
    *
    * @generated from rpc metalstack.infra.v2.BootService.SuperUserPassword
    */
@@ -401,7 +401,7 @@ export const BootService: GenService<{
     output: typeof BootServiceSuperUserPasswordResponseSchema;
   },
   /**
-   * Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all gory details about that machine
+   * Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all details about that machine.
    *
    * @generated from rpc metalstack.infra.v2.BootService.Register
    */
@@ -411,7 +411,7 @@ export const BootService: GenService<{
     output: typeof BootServiceRegisterResponseSchema;
   },
   /**
-   * Wait is a hanging call that waits until the machine gets allocated by a user
+   * Wait is a hanging call that waits until the machine gets allocated by a user.
    *
    * @generated from rpc metalstack.infra.v2.BootService.Wait
    */
@@ -421,7 +421,7 @@ export const BootService: GenService<{
     output: typeof BootServiceWaitResponseSchema;
   },
   /**
-   * InstallationSucceeded tells metal-apiserver installation was either successful
+   * InstallationSucceeded tells metal-apiserver that installation was successful.
    *
    * @generated from rpc metalstack.infra.v2.BootService.InstallationSucceeded
    */

package/js/metalstack/infra/v2/component_pb.d.ts

@@ -8,7 +8,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_infra_v2_component: GenFile;
 /**
- * ComponentServicePingRequest is sent from a microservice to report its state regularly
+ * ComponentServicePingRequest is the request payload for pinging a microservice.
  *
  * @generated from message metalstack.infra.v2.ComponentServicePingRequest
  */
@@ -20,21 +20,19 @@ export type ComponentServicePingRequest = Message<"metalstack.infra.v2.Component
      */
     type: ComponentType;
     /**
-     * Identifier is a unique identifier of this service, e.g. if two instance are running, this might be the pod id.
-     * micro_service and identifier guarantee uniqueness.
+     * Identifier is a unique identifier of this service, for example if two instances are running, this might be the pod ID
      *
      * @generated from field: string identifier = 2;
      */
     identifier: string;
     /**
-     * StartedAt is the timestamp this service was started.
+     * StartedAt is the timestamp this service was started
      *
      * @generated from field: google.protobuf.Timestamp started_at = 3;
      */
     startedAt?: Timestamp;
     /**
-     * Interval at which the ping is scheduled, must be between 5 seconds and 1 hour.
-     * Also gets validated in the same way in go/client/ping.go.
+     * Interval at which the ping is scheduled, must be between 5 seconds and 1 hour
      *
      * @generated from field: google.protobuf.Duration interval = 4;
      */
@@ -52,7 +50,7 @@ export type ComponentServicePingRequest = Message<"metalstack.infra.v2.Component
  */
 export declare const ComponentServicePingRequestSchema: GenMessage<ComponentServicePingRequest>;
 /**
- * ComponentServicePingResponse is the response to a ping request
+ * ComponentServicePingResponse is the response payload for pinging a microservice.
  *
  * @generated from message metalstack.infra.v2.ComponentServicePingResponse
  */
@@ -63,14 +61,13 @@ export type ComponentServicePingResponse = Message<"metalstack.infra.v2.Componen
  */
 export declare const ComponentServicePingResponseSchema: GenMessage<ComponentServicePingResponse>;
 /**
- * ComponentService serves component, e.g. microservices related functions.
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.infra.v2.ComponentService
  */
 export declare const ComponentService: GenService<{
     /**
-     * Ping must be called from every connected microservice in a recurring manner
-     * to get visibility of all registered microservices.
+     * Returns the ping response to register or report the microservice state.
      *
      * @generated from rpc metalstack.infra.v2.ComponentService.Ping
      */

package/js/metalstack/infra/v2/component_pb.js

@@ -23,7 +23,7 @@ export const ComponentServicePingRequestSchema = /*@__PURE__*/ messageDesc(file_
  */
 export const ComponentServicePingResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_infra_v2_component, 1);
 /**
- * ComponentService serves component, e.g. microservices related functions.
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.infra.v2.ComponentService
  */

package/js/metalstack/infra/v2/component_pb.ts

@@ -22,7 +22,7 @@ export const file_metalstack_infra_v2_component: GenFile = /*@__PURE__*/
   fileDesc("CiNtZXRhbHN0YWNrL2luZnJhL3YyL2NvbXBvbmVudC5wcm90bxITbWV0YWxzdGFjay5pbmZyYS52MiKdAgobQ29tcG9uZW50U2VydmljZVBpbmdSZXF1ZXN0EjgKBHR5cGUYASABKA4yIC5tZXRhbHN0YWNrLmFwaS52Mi5Db21wb25lbnRUeXBlQgi6SAWCAQIQARIfCgppZGVudGlmaWVyGAIgASgJQgu6SAhyBsCzrrECARI4CgpzdGFydGVkX2F0GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEIIukgFsgECOAESPAoIaW50ZXJ2YWwYBCABKAsyGS5nb29nbGUucHJvdG9idWYuRHVyYXRpb25CD7pIDKoBCSIDCJAcMgIIBRIrCgd2ZXJzaW9uGAUgASgLMhoubWV0YWxzdGFjay5hcGkudjIuVmVyc2lvbiIeChxDb21wb25lbnRTZXJ2aWNlUGluZ1Jlc3BvbnNlMooBChBDb21wb25lbnRTZXJ2aWNlEnYKBFBpbmcSMC5tZXRhbHN0YWNrLmluZnJhLnYyLkNvbXBvbmVudFNlcnZpY2VQaW5nUmVxdWVzdBoxLm1ldGFsc3RhY2suaW5mcmEudjIuQ29tcG9uZW50U2VydmljZVBpbmdSZXNwb25zZSIJ4PMYAurzGAEBQtIBChdjb20ubWV0YWxzdGFjay5pbmZyYS52MkIOQ29tcG9uZW50UHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9pbmZyYS92MjtpbmZyYXYyogIDTUlYqgITTWV0YWxzdGFjay5JbmZyYS5WMsoCE01ldGFsc3RhY2tcSW5mcmFcVjLiAh9NZXRhbHN0YWNrXEluZnJhXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6SW5mcmE6OlYyYgZwcm90bzM", [file_buf_validate_validate, file_google_protobuf_duration, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_component, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_version]);
 
 /**
- * ComponentServicePingRequest is sent from a microservice to report its state regularly
+ * ComponentServicePingRequest is the request payload for pinging a microservice.
  *
  * @generated from message metalstack.infra.v2.ComponentServicePingRequest
  */
@@ -35,23 +35,21 @@ export type ComponentServicePingRequest = Message<"metalstack.infra.v2.Component
   type: ComponentType;
 
   /**
-   * Identifier is a unique identifier of this service, e.g. if two instance are running, this might be the pod id.
-   * micro_service and identifier guarantee uniqueness.
+   * Identifier is a unique identifier of this service, for example if two instances are running, this might be the pod ID
    *
    * @generated from field: string identifier = 2;
    */
   identifier: string;
 
   /**
-   * StartedAt is the timestamp this service was started.
+   * StartedAt is the timestamp this service was started
    *
    * @generated from field: google.protobuf.Timestamp started_at = 3;
    */
   startedAt?: Timestamp;
 
   /**
-   * Interval at which the ping is scheduled, must be between 5 seconds and 1 hour.
-   * Also gets validated in the same way in go/client/ping.go.
+   * Interval at which the ping is scheduled, must be between 5 seconds and 1 hour
    *
    * @generated from field: google.protobuf.Duration interval = 4;
    */
@@ -73,7 +71,7 @@ export const ComponentServicePingRequestSchema: GenMessage<ComponentServicePingR
   messageDesc(file_metalstack_infra_v2_component, 0);
 
 /**
- * ComponentServicePingResponse is the response to a ping request
+ * ComponentServicePingResponse is the response payload for pinging a microservice.
  *
  * @generated from message metalstack.infra.v2.ComponentServicePingResponse
  */
@@ -88,14 +86,13 @@ export const ComponentServicePingResponseSchema: GenMessage<ComponentServicePing
   messageDesc(file_metalstack_infra_v2_component, 1);
 
 /**
- * ComponentService serves component, e.g. microservices related functions.
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.infra.v2.ComponentService
  */
 export const ComponentService: GenService<{
   /**
-   * Ping must be called from every connected microservice in a recurring manner
-   * to get visibility of all registered microservices.
+   * Returns the ping response to register or report the microservice state.
    *
    * @generated from rpc metalstack.infra.v2.ComponentService.Ping
    */

package/js/metalstack/infra/v2/event_pb.d.ts

@@ -6,13 +6,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_infra_v2_event: GenFile;
 /**
- * EventServiceSendRequest.
+ * EventServiceSendRequest is the request payload for sending provisioning events.
  *
  * @generated from message metalstack.infra.v2.EventServiceSendRequest
  */
 export type EventServiceSendRequest = Message<"metalstack.infra.v2.EventServiceSendRequest"> & {
     /**
-     * Events grouped by machine IDs.
+     * Events grouped by machine IDs
      *
      * @generated from field: map<string, metalstack.infra.v2.MachineProvisioningEvent> events = 1;
      */
@@ -26,19 +26,19 @@ export type EventServiceSendRequest = Message<"metalstack.infra.v2.EventServiceS
  */
 export declare const EventServiceSendRequestSchema: GenMessage<EventServiceSendRequest>;
 /**
- * EventServiceSendResponse.
+ * EventServiceSendResponse is the response payload for sending provisioning events.
  *
  * @generated from message metalstack.infra.v2.EventServiceSendResponse
  */
 export type EventServiceSendResponse = Message<"metalstack.infra.v2.EventServiceSendResponse"> & {
     /**
-     * Events counts the number of events successfully stored in the database.
+     * Events counts the number of events successfully stored in the database
      *
      * @generated from field: uint64 events = 1;
      */
     events: bigint;
     /**
-     * Failed contains IDs of all machines whose events could not be stored in the database.
+     * Failed contains IDs of all machines whose events could not be stored in the database
      *
      * @generated from field: repeated string failed = 2;
      */
@@ -56,19 +56,19 @@ export declare const EventServiceSendResponseSchema: GenMessage<EventServiceSend
  */
 export type MachineProvisioningEvent = Message<"metalstack.infra.v2.MachineProvisioningEvent"> & {
     /**
-     * Time the event occurred at.
+     * Time the event occurred at
      *
      * @generated from field: google.protobuf.Timestamp time = 1;
      */
     time?: Timestamp;
     /**
-     * Event that occurred.
+     * Event that occurred
      *
      * @generated from field: metalstack.infra.v2.ProvisioningEventType event = 2;
      */
     event: ProvisioningEventType;
     /**
-     * Message describing the event in more detail.
+     * Message describes the event in more detail
      *
      * @generated from field: string message = 3;
      */
@@ -86,73 +86,73 @@ export declare const MachineProvisioningEventSchema: GenMessage<MachineProvision
  */
 export declare enum ProvisioningEventType {
     /**
-     * PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified.
+     * PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,
     /**
-     * PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago.
+     * PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_ALIVE = 1;
      */
     ALIVE = 1,
     /**
-     * PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle.
+     * PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_CRASHED = 2;
      */
     CRASHED = 2,
     /**
-     * PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE.
+     * PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PXE_BOOTING = 3;
      */
     PXE_BOOTING = 3,
     /**
-     * PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot.
+     * PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PLANNED_REBOOT = 4;
      */
     PLANNED_REBOOT = 4,
     /**
-     * PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started.
+     * PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PREPARING = 5;
      */
     PREPARING = 5,
     /**
-     * PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API.
+     * PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_REGISTERING = 6;
      */
     REGISTERING = 6,
     /**
-     * PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation.
+     * PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_WAITING = 7;
      */
     WAITING = 7,
     /**
-     * PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed.
+     * PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_INSTALLING = 8;
      */
     INSTALLING = 8,
     /**
-     * PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS.
+     * PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL = 9;
      */
     BOOTING_NEW_KERNEL = 9,
     /**
-     * PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness.
+     * PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PHONED_HOME = 10;
      */
     PHONED_HOME = 10,
     /**
-     * PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines.
+     * PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM = 11;
      */
@@ -163,13 +163,13 @@ export declare enum ProvisioningEventType {
  */
 export declare const ProvisioningEventTypeSchema: GenEnum<ProvisioningEventType>;
 /**
- * EventService serves event related functions.
+ * EventService provides machine provisioning event logging operations.
  *
  * @generated from service metalstack.infra.v2.EventService
  */
 export declare const EventService: GenService<{
     /**
-     * Send a series of machine provisioning events.
+     * Sends a series of machine provisioning events.
      *
      * @generated from rpc metalstack.infra.v2.EventService.Send
      */