// Copyright 2025 CNCF xDS API Working Group (xDS-WG) Authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// 
//     http://www.apache.org/licenses/LICENSE-2.0
// 
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

// THIS FILE IS DEPRECATED
// Users should instead use the corresponding proto in the xds tree.
// No new changes will be accepted here.

syntax = "proto3";

package udpa.annotations;

import "google/protobuf/descriptor.proto";

option go_package = "github.com/cncf/xds/go/udpa/annotations";

// Magic number in this file derived from top 28bit of SHA256 digest of
// "udpa.annotation.status".
extend google.protobuf.FileOptions {
  StatusAnnotation file_status = 222707719;
}

enum PackageVersionStatus {
  // Unknown package version status.
  UNKNOWN = 0;

  // This version of the package is frozen.
  FROZEN = 1;

  // This version of the package is the active development version.
  ACTIVE = 2;

  // This version of the package is the candidate for the next major version. It
  // is typically machine generated from the active development version.
  NEXT_MAJOR_VERSION_CANDIDATE = 3;
}

message StatusAnnotation {
  // The entity is work-in-progress and subject to breaking changes.
  bool work_in_progress = 1;

  // The entity belongs to a package with the given version status.
  PackageVersionStatus package_version_status = 2;
}
