backupy-agent/packages/proto/gen/go/backupv1/envelope.pb.go
TronoSfera 8b0c978337 feat(initial): Backupy agent + backupy-decrypt CLI
Source ports from the TronoSfera/backupy-cloud monorepo:
- apps/agent/        — Go agent (WSS client, persistent queue, Docker
                       discovery, 5 DB drivers: PG/MySQL/Mongo/Redis/SQLite,
                       pre/post hooks, Prometheus metrics)
- apps/backupy-decrypt/ — standalone CLI for client-side decryption
- packages/proto/    — protobuf wire format (generated .pb.go committed
                       so the repo builds without protoc)
- docs/              — agent spec + wire-protocol contract

Apache-2.0 license. Image published to ghcr.io/tronosfera/backupy-agent
on every v* tag via .github/workflows/release.yml (multi-arch amd64+arm64).
2026-05-17 20:22:35 +03:00

497 lines
15 KiB
Go

// Backupy protobuf v1 — see docs/07-api-contract.md
//
// Envelope is the single top-level wrapper carried in every WSS binary frame
// in either direction. The `payload` oneof selects which concrete message is
// being transported; field numbers must remain stable forever.
// Code generated by protoc-gen-go. DO NOT EDIT.
// versions:
// protoc-gen-go v1.36.11
// protoc (unknown)
// source: backupv1/envelope.proto
package backupv1
import (
protoreflect "google.golang.org/protobuf/reflect/protoreflect"
protoimpl "google.golang.org/protobuf/runtime/protoimpl"
reflect "reflect"
sync "sync"
unsafe "unsafe"
)
const (
// Verify that this generated code is sufficiently up-to-date.
_ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion)
// Verify that runtime/protoimpl is sufficiently up-to-date.
_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
)
// Envelope wraps every WSS message in both directions.
// See docs/07-api-contract.md §3.
type Envelope struct {
state protoimpl.MessageState `protogen:"open.v1"`
Seq uint64 `protobuf:"varint,1,opt,name=seq,proto3" json:"seq,omitempty"` // monotonic, per-direction
TsMs uint64 `protobuf:"varint,2,opt,name=ts_ms,json=tsMs,proto3" json:"ts_ms,omitempty"` // unix milliseconds, set by sender
CorrelationId string `protobuf:"bytes,3,opt,name=correlation_id,json=correlationId,proto3" json:"correlation_id,omitempty"` // links request/response pairs (e.g. Ping/Ack)
// Types that are valid to be assigned to Payload:
//
// *Envelope_Register
// *Envelope_Heartbeat
// *Envelope_Discovery
// *Envelope_JobUpdate
// *Envelope_BackupCompleted
// *Envelope_HealthResult
// *Envelope_Log
// *Envelope_RestoreUpdate
// *Envelope_Ack
// *Envelope_RegisterAck
// *Envelope_ConfigUpdate
// *Envelope_RunBackup
// *Envelope_CancelJob
// *Envelope_RunHealthCheck
// *Envelope_SelfUpdate
// *Envelope_Ping
Payload isEnvelope_Payload `protobuf_oneof:"payload"`
unknownFields protoimpl.UnknownFields
sizeCache protoimpl.SizeCache
}
func (x *Envelope) Reset() {
*x = Envelope{}
mi := &file_backupv1_envelope_proto_msgTypes[0]
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
ms.StoreMessageInfo(mi)
}
func (x *Envelope) String() string {
return protoimpl.X.MessageStringOf(x)
}
func (*Envelope) ProtoMessage() {}
func (x *Envelope) ProtoReflect() protoreflect.Message {
mi := &file_backupv1_envelope_proto_msgTypes[0]
if x != nil {
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
if ms.LoadMessageInfo() == nil {
ms.StoreMessageInfo(mi)
}
return ms
}
return mi.MessageOf(x)
}
// Deprecated: Use Envelope.ProtoReflect.Descriptor instead.
func (*Envelope) Descriptor() ([]byte, []int) {
return file_backupv1_envelope_proto_rawDescGZIP(), []int{0}
}
func (x *Envelope) GetSeq() uint64 {
if x != nil {
return x.Seq
}
return 0
}
func (x *Envelope) GetTsMs() uint64 {
if x != nil {
return x.TsMs
}
return 0
}
func (x *Envelope) GetCorrelationId() string {
if x != nil {
return x.CorrelationId
}
return ""
}
func (x *Envelope) GetPayload() isEnvelope_Payload {
if x != nil {
return x.Payload
}
return nil
}
func (x *Envelope) GetRegister() *Register {
if x != nil {
if x, ok := x.Payload.(*Envelope_Register); ok {
return x.Register
}
}
return nil
}
func (x *Envelope) GetHeartbeat() *Heartbeat {
if x != nil {
if x, ok := x.Payload.(*Envelope_Heartbeat); ok {
return x.Heartbeat
}
}
return nil
}
func (x *Envelope) GetDiscovery() *DiscoveryReport {
if x != nil {
if x, ok := x.Payload.(*Envelope_Discovery); ok {
return x.Discovery
}
}
return nil
}
func (x *Envelope) GetJobUpdate() *JobUpdate {
if x != nil {
if x, ok := x.Payload.(*Envelope_JobUpdate); ok {
return x.JobUpdate
}
}
return nil
}
func (x *Envelope) GetBackupCompleted() *BackupCompleted {
if x != nil {
if x, ok := x.Payload.(*Envelope_BackupCompleted); ok {
return x.BackupCompleted
}
}
return nil
}
func (x *Envelope) GetHealthResult() *HealthCheckResult {
if x != nil {
if x, ok := x.Payload.(*Envelope_HealthResult); ok {
return x.HealthResult
}
}
return nil
}
func (x *Envelope) GetLog() *LogEvent {
if x != nil {
if x, ok := x.Payload.(*Envelope_Log); ok {
return x.Log
}
}
return nil
}
func (x *Envelope) GetRestoreUpdate() *RestoreUpdate {
if x != nil {
if x, ok := x.Payload.(*Envelope_RestoreUpdate); ok {
return x.RestoreUpdate
}
}
return nil
}
func (x *Envelope) GetAck() *Ack {
if x != nil {
if x, ok := x.Payload.(*Envelope_Ack); ok {
return x.Ack
}
}
return nil
}
func (x *Envelope) GetRegisterAck() *RegisterAck {
if x != nil {
if x, ok := x.Payload.(*Envelope_RegisterAck); ok {
return x.RegisterAck
}
}
return nil
}
func (x *Envelope) GetConfigUpdate() *ConfigUpdate {
if x != nil {
if x, ok := x.Payload.(*Envelope_ConfigUpdate); ok {
return x.ConfigUpdate
}
}
return nil
}
func (x *Envelope) GetRunBackup() *RunBackup {
if x != nil {
if x, ok := x.Payload.(*Envelope_RunBackup); ok {
return x.RunBackup
}
}
return nil
}
func (x *Envelope) GetCancelJob() *CancelJob {
if x != nil {
if x, ok := x.Payload.(*Envelope_CancelJob); ok {
return x.CancelJob
}
}
return nil
}
func (x *Envelope) GetRunHealthCheck() *RunHealthCheck {
if x != nil {
if x, ok := x.Payload.(*Envelope_RunHealthCheck); ok {
return x.RunHealthCheck
}
}
return nil
}
func (x *Envelope) GetSelfUpdate() *SelfUpdate {
if x != nil {
if x, ok := x.Payload.(*Envelope_SelfUpdate); ok {
return x.SelfUpdate
}
}
return nil
}
func (x *Envelope) GetPing() *Ping {
if x != nil {
if x, ok := x.Payload.(*Envelope_Ping); ok {
return x.Ping
}
}
return nil
}
type isEnvelope_Payload interface {
isEnvelope_Payload()
}
type Envelope_Register struct {
// ---------------- agent -> server ----------------
Register *Register `protobuf:"bytes,10,opt,name=register,proto3,oneof"`
}
type Envelope_Heartbeat struct {
Heartbeat *Heartbeat `protobuf:"bytes,11,opt,name=heartbeat,proto3,oneof"`
}
type Envelope_Discovery struct {
Discovery *DiscoveryReport `protobuf:"bytes,12,opt,name=discovery,proto3,oneof"`
}
type Envelope_JobUpdate struct {
JobUpdate *JobUpdate `protobuf:"bytes,13,opt,name=job_update,json=jobUpdate,proto3,oneof"`
}
type Envelope_BackupCompleted struct {
BackupCompleted *BackupCompleted `protobuf:"bytes,14,opt,name=backup_completed,json=backupCompleted,proto3,oneof"`
}
type Envelope_HealthResult struct {
HealthResult *HealthCheckResult `protobuf:"bytes,15,opt,name=health_result,json=healthResult,proto3,oneof"`
}
type Envelope_Log struct {
Log *LogEvent `protobuf:"bytes,16,opt,name=log,proto3,oneof"`
}
type Envelope_RestoreUpdate struct {
RestoreUpdate *RestoreUpdate `protobuf:"bytes,17,opt,name=restore_update,json=restoreUpdate,proto3,oneof"`
}
type Envelope_Ack struct {
Ack *Ack `protobuf:"bytes,18,opt,name=ack,proto3,oneof"`
}
type Envelope_RegisterAck struct {
// ---------------- server -> agent ----------------
RegisterAck *RegisterAck `protobuf:"bytes,50,opt,name=register_ack,json=registerAck,proto3,oneof"`
}
type Envelope_ConfigUpdate struct {
ConfigUpdate *ConfigUpdate `protobuf:"bytes,51,opt,name=config_update,json=configUpdate,proto3,oneof"`
}
type Envelope_RunBackup struct {
RunBackup *RunBackup `protobuf:"bytes,52,opt,name=run_backup,json=runBackup,proto3,oneof"`
}
type Envelope_CancelJob struct {
CancelJob *CancelJob `protobuf:"bytes,53,opt,name=cancel_job,json=cancelJob,proto3,oneof"`
}
type Envelope_RunHealthCheck struct {
RunHealthCheck *RunHealthCheck `protobuf:"bytes,54,opt,name=run_health_check,json=runHealthCheck,proto3,oneof"`
}
type Envelope_SelfUpdate struct {
// 55 reserved: previously RunRestore (removed in MVP, see docs/07 §5).
SelfUpdate *SelfUpdate `protobuf:"bytes,56,opt,name=self_update,json=selfUpdate,proto3,oneof"`
}
type Envelope_Ping struct {
Ping *Ping `protobuf:"bytes,57,opt,name=ping,proto3,oneof"`
}
func (*Envelope_Register) isEnvelope_Payload() {}
func (*Envelope_Heartbeat) isEnvelope_Payload() {}
func (*Envelope_Discovery) isEnvelope_Payload() {}
func (*Envelope_JobUpdate) isEnvelope_Payload() {}
func (*Envelope_BackupCompleted) isEnvelope_Payload() {}
func (*Envelope_HealthResult) isEnvelope_Payload() {}
func (*Envelope_Log) isEnvelope_Payload() {}
func (*Envelope_RestoreUpdate) isEnvelope_Payload() {}
func (*Envelope_Ack) isEnvelope_Payload() {}
func (*Envelope_RegisterAck) isEnvelope_Payload() {}
func (*Envelope_ConfigUpdate) isEnvelope_Payload() {}
func (*Envelope_RunBackup) isEnvelope_Payload() {}
func (*Envelope_CancelJob) isEnvelope_Payload() {}
func (*Envelope_RunHealthCheck) isEnvelope_Payload() {}
func (*Envelope_SelfUpdate) isEnvelope_Payload() {}
func (*Envelope_Ping) isEnvelope_Payload() {}
var File_backupv1_envelope_proto protoreflect.FileDescriptor
const file_backupv1_envelope_proto_rawDesc = "" +
"\n" +
"\x17backupv1/envelope.proto\x12\tbackup.v1\x1a\x1ebackupv1/agent_to_server.proto\x1a\x1ebackupv1/server_to_agent.proto\"\xf6\a\n" +
"\bEnvelope\x12\x10\n" +
"\x03seq\x18\x01 \x01(\x04R\x03seq\x12\x13\n" +
"\x05ts_ms\x18\x02 \x01(\x04R\x04tsMs\x12%\n" +
"\x0ecorrelation_id\x18\x03 \x01(\tR\rcorrelationId\x121\n" +
"\bregister\x18\n" +
" \x01(\v2\x13.backup.v1.RegisterH\x00R\bregister\x124\n" +
"\theartbeat\x18\v \x01(\v2\x14.backup.v1.HeartbeatH\x00R\theartbeat\x12:\n" +
"\tdiscovery\x18\f \x01(\v2\x1a.backup.v1.DiscoveryReportH\x00R\tdiscovery\x125\n" +
"\n" +
"job_update\x18\r \x01(\v2\x14.backup.v1.JobUpdateH\x00R\tjobUpdate\x12G\n" +
"\x10backup_completed\x18\x0e \x01(\v2\x1a.backup.v1.BackupCompletedH\x00R\x0fbackupCompleted\x12C\n" +
"\rhealth_result\x18\x0f \x01(\v2\x1c.backup.v1.HealthCheckResultH\x00R\fhealthResult\x12'\n" +
"\x03log\x18\x10 \x01(\v2\x13.backup.v1.LogEventH\x00R\x03log\x12A\n" +
"\x0erestore_update\x18\x11 \x01(\v2\x18.backup.v1.RestoreUpdateH\x00R\rrestoreUpdate\x12\"\n" +
"\x03ack\x18\x12 \x01(\v2\x0e.backup.v1.AckH\x00R\x03ack\x12;\n" +
"\fregister_ack\x182 \x01(\v2\x16.backup.v1.RegisterAckH\x00R\vregisterAck\x12>\n" +
"\rconfig_update\x183 \x01(\v2\x17.backup.v1.ConfigUpdateH\x00R\fconfigUpdate\x125\n" +
"\n" +
"run_backup\x184 \x01(\v2\x14.backup.v1.RunBackupH\x00R\trunBackup\x125\n" +
"\n" +
"cancel_job\x185 \x01(\v2\x14.backup.v1.CancelJobH\x00R\tcancelJob\x12E\n" +
"\x10run_health_check\x186 \x01(\v2\x19.backup.v1.RunHealthCheckH\x00R\x0erunHealthCheck\x128\n" +
"\vself_update\x188 \x01(\v2\x15.backup.v1.SelfUpdateH\x00R\n" +
"selfUpdate\x12%\n" +
"\x04ping\x189 \x01(\v2\x0f.backup.v1.PingH\x00R\x04pingB\t\n" +
"\apayloadJ\x04\b7\x108B\xa7\x01\n" +
"\rcom.backup.v1B\rEnvelopeProtoP\x01ZBgithub.com/backupy/backupy/packages/proto/gen/go/backupv1;backupv1\xa2\x02\x03BXX\xaa\x02\tBackup.V1\xca\x02\tBackup\\V1\xe2\x02\x15Backup\\V1\\GPBMetadata\xea\x02\n" +
"Backup::V1b\x06proto3"
var (
file_backupv1_envelope_proto_rawDescOnce sync.Once
file_backupv1_envelope_proto_rawDescData []byte
)
func file_backupv1_envelope_proto_rawDescGZIP() []byte {
file_backupv1_envelope_proto_rawDescOnce.Do(func() {
file_backupv1_envelope_proto_rawDescData = protoimpl.X.CompressGZIP(unsafe.Slice(unsafe.StringData(file_backupv1_envelope_proto_rawDesc), len(file_backupv1_envelope_proto_rawDesc)))
})
return file_backupv1_envelope_proto_rawDescData
}
var file_backupv1_envelope_proto_msgTypes = make([]protoimpl.MessageInfo, 1)
var file_backupv1_envelope_proto_goTypes = []any{
(*Envelope)(nil), // 0: backup.v1.Envelope
(*Register)(nil), // 1: backup.v1.Register
(*Heartbeat)(nil), // 2: backup.v1.Heartbeat
(*DiscoveryReport)(nil), // 3: backup.v1.DiscoveryReport
(*JobUpdate)(nil), // 4: backup.v1.JobUpdate
(*BackupCompleted)(nil), // 5: backup.v1.BackupCompleted
(*HealthCheckResult)(nil), // 6: backup.v1.HealthCheckResult
(*LogEvent)(nil), // 7: backup.v1.LogEvent
(*RestoreUpdate)(nil), // 8: backup.v1.RestoreUpdate
(*Ack)(nil), // 9: backup.v1.Ack
(*RegisterAck)(nil), // 10: backup.v1.RegisterAck
(*ConfigUpdate)(nil), // 11: backup.v1.ConfigUpdate
(*RunBackup)(nil), // 12: backup.v1.RunBackup
(*CancelJob)(nil), // 13: backup.v1.CancelJob
(*RunHealthCheck)(nil), // 14: backup.v1.RunHealthCheck
(*SelfUpdate)(nil), // 15: backup.v1.SelfUpdate
(*Ping)(nil), // 16: backup.v1.Ping
}
var file_backupv1_envelope_proto_depIdxs = []int32{
1, // 0: backup.v1.Envelope.register:type_name -> backup.v1.Register
2, // 1: backup.v1.Envelope.heartbeat:type_name -> backup.v1.Heartbeat
3, // 2: backup.v1.Envelope.discovery:type_name -> backup.v1.DiscoveryReport
4, // 3: backup.v1.Envelope.job_update:type_name -> backup.v1.JobUpdate
5, // 4: backup.v1.Envelope.backup_completed:type_name -> backup.v1.BackupCompleted
6, // 5: backup.v1.Envelope.health_result:type_name -> backup.v1.HealthCheckResult
7, // 6: backup.v1.Envelope.log:type_name -> backup.v1.LogEvent
8, // 7: backup.v1.Envelope.restore_update:type_name -> backup.v1.RestoreUpdate
9, // 8: backup.v1.Envelope.ack:type_name -> backup.v1.Ack
10, // 9: backup.v1.Envelope.register_ack:type_name -> backup.v1.RegisterAck
11, // 10: backup.v1.Envelope.config_update:type_name -> backup.v1.ConfigUpdate
12, // 11: backup.v1.Envelope.run_backup:type_name -> backup.v1.RunBackup
13, // 12: backup.v1.Envelope.cancel_job:type_name -> backup.v1.CancelJob
14, // 13: backup.v1.Envelope.run_health_check:type_name -> backup.v1.RunHealthCheck
15, // 14: backup.v1.Envelope.self_update:type_name -> backup.v1.SelfUpdate
16, // 15: backup.v1.Envelope.ping:type_name -> backup.v1.Ping
16, // [16:16] is the sub-list for method output_type
16, // [16:16] is the sub-list for method input_type
16, // [16:16] is the sub-list for extension type_name
16, // [16:16] is the sub-list for extension extendee
0, // [0:16] is the sub-list for field type_name
}
func init() { file_backupv1_envelope_proto_init() }
func file_backupv1_envelope_proto_init() {
if File_backupv1_envelope_proto != nil {
return
}
file_backupv1_agent_to_server_proto_init()
file_backupv1_server_to_agent_proto_init()
file_backupv1_envelope_proto_msgTypes[0].OneofWrappers = []any{
(*Envelope_Register)(nil),
(*Envelope_Heartbeat)(nil),
(*Envelope_Discovery)(nil),
(*Envelope_JobUpdate)(nil),
(*Envelope_BackupCompleted)(nil),
(*Envelope_HealthResult)(nil),
(*Envelope_Log)(nil),
(*Envelope_RestoreUpdate)(nil),
(*Envelope_Ack)(nil),
(*Envelope_RegisterAck)(nil),
(*Envelope_ConfigUpdate)(nil),
(*Envelope_RunBackup)(nil),
(*Envelope_CancelJob)(nil),
(*Envelope_RunHealthCheck)(nil),
(*Envelope_SelfUpdate)(nil),
(*Envelope_Ping)(nil),
}
type x struct{}
out := protoimpl.TypeBuilder{
File: protoimpl.DescBuilder{
GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
RawDescriptor: unsafe.Slice(unsafe.StringData(file_backupv1_envelope_proto_rawDesc), len(file_backupv1_envelope_proto_rawDesc)),
NumEnums: 0,
NumMessages: 1,
NumExtensions: 0,
NumServices: 0,
},
GoTypes: file_backupv1_envelope_proto_goTypes,
DependencyIndexes: file_backupv1_envelope_proto_depIdxs,
MessageInfos: file_backupv1_envelope_proto_msgTypes,
}.Build()
File_backupv1_envelope_proto = out.File
file_backupv1_envelope_proto_goTypes = nil
file_backupv1_envelope_proto_depIdxs = nil
}