content: /*
   * Licensed to the Apache Software Foundation (ASF) under one or more
   * contributor license agreements. See the NOTICE file distributed with
   * this work for additional information regarding copyright ownership.
   * The ASF licenses this file to You 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.
   */
  package org.apache.kafka.server.common;
  
  import java.util.Map;
  
  public enum StreamsVersion implements FeatureVersion {
  
      // Version 0 keeps "streams" groups disabled (KIP-1071).
      SV_0(0, MetadataVersion.MINIMUM_VERSION, Map.of()),
  
      // Version 1 enables "streams" groups (KIP-1071).
      // Using metadata version IBP_4_2_IV1 disables it by default in AK 4.1 release, and enables it by default in AK 4.2 release.
      //  - in AK 4.1, this can be enabled as "early access [unstable]"
      //  - in AK 4.2, it is planned to go GA (cf `LATEST_PRODUCTION`)
      SV_1(1, MetadataVersion.IBP_4_2_IV1, Map.of());
  
      public static final String FEATURE_NAME = "streams.version";
  
      // Mark "streams" group as unstable in AK 4.1 release
      // Needs to be updated to SV_1 in AK 4.2, to mark as stable
      public static final StreamsVersion LATEST_PRODUCTION = SV_0;
  
      private final short featureLevel;
      private final MetadataVersion bootstrapMetadataVersion;
      private final Map<String, Short> dependencies;
  
      StreamsVersion(
          int featureLevel,
          MetadataVersion bootstrapMetadataVersion,
          Map<String, Short> dependencies
      ) {
          this.featureLevel = (short) featureLevel;
          this.bootstrapMetadataVersion = bootstrapMetadataVersion;
          this.dependencies = dependencies;
      }
  
      @Override
      public short featureLevel() {
          return featureLevel;
      }
  
      @Override
      public String featureName() {
          return FEATURE_NAME;
      }
  
      @Override
      public MetadataVersion bootstrapMetadataVersion() {
          return bootstrapMetadataVersion;
      }
  
      @Override
      public Map<String, Short> dependencies() {
          return dependencies;
      }
  
      public boolean streamsGroupSupported() {
          return featureLevel >= SV_1.featureLevel;
      }
  
      public static StreamsVersion fromFeatureLevel(short version) {
          return switch (version) {
              case 0 -> SV_0;
              case 1 -> SV_1;
              default -> throw new RuntimeException("Unknown streams feature level: " + (int) version);
          };
      }
  }
  