Support Fee Extension standard in rfc 8748 (#2855)

* Support Fee Extension standard in rfc 8748

Adding support to the final version of RFC 8748.

Compared with draft-0.12, the only meaningful change is in the namespace.
The rest is either schema-tightening that reflects actual usage, or
optional server-side features that we do not support.

We reuse draft-0.12 tests, only changing namespace uris in the input and
output files for the new version.

* Addressing reviews

Author: weiminyu

core/src/main/java/google/registry/flows/domain/DomainDeleteFlow.java

@@ -77,6 +77,7 @@
 import google.registry.model.domain.fee06.FeeDeleteResponseExtensionV06;
 import google.registry.model.domain.fee11.FeeDeleteResponseExtensionV11;
 import google.registry.model.domain.fee12.FeeDeleteResponseExtensionV12;
+import google.registry.model.domain.feestdv1.FeeDeleteResponseExtensionStdV1;
 import google.registry.model.domain.metadata.MetadataExtension;
 import google.registry.model.domain.rgp.GracePeriodStatus;
 import google.registry.model.domain.secdns.SecDnsCreateExtension;
@@ -428,6 +429,9 @@ private Money getGracePeriodCost(
   @Nullable
   private FeeTransformResponseExtension.Builder getDeleteResponseBuilder() {
     Set<String> uris = nullToEmpty(sessionMetadata.getServiceExtensionUris());
+    if (uris.contains(ServiceExtension.FEE_1_00.getUri())) {
+      return new FeeDeleteResponseExtensionStdV1.Builder();
+    }
     if (uris.contains(ServiceExtension.FEE_0_12.getUri())) {
       return new FeeDeleteResponseExtensionV12.Builder();
     }

core/src/main/java/google/registry/model/domain/fee/Fee.java

@@ -64,6 +64,7 @@ private static Fee createWithCustomDescription(
 
   public static final ImmutableSet<String> FEE_EXTENSION_URIS =
       ImmutableSet.of(
+          ServiceExtension.FEE_1_00.getUri(),
           ServiceExtension.FEE_0_12.getUri(),
           ServiceExtension.FEE_0_11.getUri(),
           ServiceExtension.FEE_0_6.getUri());

core/src/main/java/google/registry/model/domain/feestdv1/FeeCheckCommandExtensionItemStdV1.java

@@ -0,0 +1,112 @@
+// Copyright 2025 The Nomulus Authors. All Rights Reserved.
+//
+// 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.
+
+package google.registry.model.domain.feestdv1;
+
+import com.google.common.base.Ascii;
+import google.registry.model.domain.Period;
+import google.registry.model.domain.fee.FeeCheckCommandExtensionItem;
+import jakarta.xml.bind.annotation.XmlAttribute;
+import jakarta.xml.bind.annotation.XmlElement;
+import jakarta.xml.bind.annotation.XmlType;
+import java.util.Locale;
+import java.util.Optional;
+import org.joda.money.CurrencyUnit;
+import org.joda.time.DateTime;
+
+/**
+ * An individual price check item in version 1.0 of the fee extension on domain check commands.
+ * Items look like:
+ *
+ * <pre>{@code
+ * <fee:command name="renew" phase="sunrise" subphase="hello">
+ *   <fee:period unit="y">1</fee:period>
+ *   <fee:class>premium</fee:class>
+ *   <fee:date>2017-05-17T13:22:21.0Z</fee:date>
+ * </fee:command>
+ * }</pre>
+ */
+@XmlType(propOrder = {"period", "feeClass", "feeDate"})
+public class FeeCheckCommandExtensionItemStdV1 extends FeeCheckCommandExtensionItem {
+
+  /** The default validity period (if not specified) is 1 year for all operations. */
+  static final Period DEFAULT_PERIOD = Period.create(1, Period.Unit.YEARS);
+
+  @XmlAttribute(name = "name")
+  String commandName;
+
+  @XmlAttribute String phase;
+
+  @XmlAttribute String subphase;
+
+  @XmlElement(name = "class")
+  String feeClass;
+
+  @XmlElement(name = "date")
+  DateTime feeDate;
+
+  /** Version 1.0 does not support domain name or currency in fee extension items. */
+  @Override
+  public boolean isDomainNameSupported() {
+    return false;
+  }
+
+  @Override
+  public String getDomainName() {
+    throw new UnsupportedOperationException("Domain not supported");
+  }
+
+  @Override
+  public CurrencyUnit getCurrency() {
+    return null; // This version of the fee extension doesn't specify currency per-item.
+  }
+
+  @Override
+  public String getUnparsedCommandName() {
+    return commandName;
+  }
+
+  @Override
+  public CommandName getCommandName() {
+    // Require the xml string to be lowercase.
+    if (commandName != null && commandName.toLowerCase(Locale.ENGLISH).equals(commandName)) {
+      try {
+        return CommandName.valueOf(Ascii.toUpperCase(commandName));
+      } catch (IllegalArgumentException e) {
+        // Swallow this and return UNKNOWN below because there's no matching CommandName.
+      }
+    }
+    return CommandName.UNKNOWN;
+  }
+
+  @Override
+  public String getPhase() {
+    return phase;
+  }
+
+  @Override
+  public String getSubphase() {
+    return subphase;
+  }
+
+  @Override
+  public FeeCheckResponseExtensionItemStdV1.Builder createResponseBuilder() {
+    return new FeeCheckResponseExtensionItemStdV1.Builder();
+  }
+
+  @Override
+  public Optional<DateTime> getEffectiveDate() {
+    return Optional.ofNullable(feeDate);
+  }
+}

core/src/main/java/google/registry/model/domain/feestdv1/FeeCheckCommandExtensionStdV1.java

@@ -0,0 +1,63 @@
+// Copyright 2025 The Nomulus Authors. All Rights Reserved.
+//
+// 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.
+
+package google.registry.model.domain.feestdv1;
+
+import static google.registry.util.CollectionUtils.nullToEmptyImmutableCopy;
+
+import com.google.common.collect.ImmutableList;
+import google.registry.model.ImmutableObject;
+import google.registry.model.domain.fee.FeeCheckCommandExtension;
+import google.registry.model.domain.fee.FeeCheckResponseExtensionItem;
+import jakarta.xml.bind.annotation.XmlElement;
+import jakarta.xml.bind.annotation.XmlRootElement;
+import jakarta.xml.bind.annotation.XmlType;
+import java.util.List;
+import org.joda.money.CurrencyUnit;
+
+/** Version 1.0 of the fee extension that may be present on domain check commands. */
+@XmlRootElement(name = "check")
+@XmlType(propOrder = {"currency", "items"})
+public class FeeCheckCommandExtensionStdV1 extends ImmutableObject
+    implements FeeCheckCommandExtension<
+        FeeCheckCommandExtensionItemStdV1, FeeCheckResponseExtensionStdV1> {
+
+  CurrencyUnit currency;
+
+  @Override
+  public CurrencyUnit getCurrency() {
+    return currency;
+  }
+
+  @XmlElement(name = "command")
+  List<FeeCheckCommandExtensionItemStdV1> items;
+
+  @Override
+  public ImmutableList<FeeCheckCommandExtensionItemStdV1> getItems() {
+    return nullToEmptyImmutableCopy(items);
+  }
+
+  @Override
+  public FeeCheckResponseExtensionStdV1 createResponse(
+      ImmutableList<? extends FeeCheckResponseExtensionItem> items) {
+    ImmutableList.Builder<FeeCheckResponseExtensionItemStdV1> builder =
+        new ImmutableList.Builder<>();
+    for (FeeCheckResponseExtensionItem item : items) {
+      if (item instanceof FeeCheckResponseExtensionItemStdV1) {
+        builder.add((FeeCheckResponseExtensionItemStdV1) item);
+      }
+    }
+    return FeeCheckResponseExtensionStdV1.create(currency, builder.build());
+  }
+}

core/src/main/java/google/registry/model/domain/feestdv1/FeeCheckResponseExtensionItemCommandStdV1.java

@@ -0,0 +1,119 @@
+// Copyright 2025 The Nomulus Authors. All Rights Reserved.
+//
+// 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.
+
+package google.registry.model.domain.feestdv1;
+
+import static google.registry.util.CollectionUtils.forceEmptyToNull;
+
+import com.google.common.base.Ascii;
+import com.google.common.collect.ImmutableList;
+import google.registry.model.Buildable;
+import google.registry.model.ImmutableObject;
+import google.registry.model.domain.Period;
+import google.registry.model.domain.fee.Fee;
+import google.registry.model.domain.fee.FeeQueryCommandExtensionItem.CommandName;
+import jakarta.xml.bind.annotation.XmlAttribute;
+import jakarta.xml.bind.annotation.XmlElement;
+import jakarta.xml.bind.annotation.XmlType;
+import java.util.List;
+import org.joda.time.DateTime;
+
+/** The version 1.0 response command entity for a domain check on a single resource. */
+@XmlType(propOrder = {"period", "fee", "feeClass", "effectiveDate", "notAfterDate"})
+public class FeeCheckResponseExtensionItemCommandStdV1 extends ImmutableObject {
+
+  /** The command that was checked. */
+  @XmlAttribute(name = "name")
+  String commandName;
+
+  /** The phase that was checked. */
+  @XmlAttribute String phase;
+
+  /** The subphase that was checked. */
+  @XmlAttribute String subphase;
+
+  /** The period that was checked. */
+  Period period;
+
+  /**
+   * The magnitude of the fee, in the specified units, with an optional description.
+   *
+   * <p>This is a list because a single operation can involve multiple fees.
+   */
+  List<Fee> fee;
+
+  /**
+   * The type of the fee.
+   *
+   * <p>We will use "premium" for fees on premium names, and omit the field otherwise.
+   */
+  @XmlElement(name = "class")
+  String feeClass;
+
+  /** The effective date that the check is to be performed on (if specified in the query). */
+  @XmlElement(name = "date")
+  DateTime effectiveDate;
+
+  /** The date after which the quoted fee is no longer valid (if applicable). */
+  @XmlElement(name = "notAfter")
+  DateTime notAfterDate;
+
+  public String getFeeClass() {
+    return feeClass;
+  }
+
+  /** Builder for {@link FeeCheckResponseExtensionItemCommandStdV1}. */
+  public static class Builder extends Buildable.Builder<FeeCheckResponseExtensionItemCommandStdV1> {
+
+    public Builder setCommandName(CommandName commandName) {
+      getInstance().commandName = Ascii.toLowerCase(commandName.name());
+      return this;
+    }
+
+    public Builder setPhase(String phase) {
+      getInstance().phase = phase;
+      return this;
+    }
+
+    public Builder setSubphase(String subphase) {
+      getInstance().subphase = subphase;
+      return this;
+    }
+
+    public Builder setPeriod(Period period) {
+      getInstance().period = period;
+      return this;
+    }
+
+    public Builder setEffectiveDate(DateTime effectiveDate) {
+      getInstance().effectiveDate = effectiveDate;
+      return this;
+    }
+
+    public Builder setNotAfterDate(DateTime notAfterDate) {
+      getInstance().notAfterDate = notAfterDate;
+      return this;
+    }
+
+    public Builder setFee(List<Fee> fees) {
+      getInstance().fee = forceEmptyToNull(ImmutableList.copyOf(fees));
+      return this;
+    }
+
+    public Builder setClass(String feeClass) {
+      getInstance().feeClass = feeClass;
+      return this;
+    }
+  }
+}