Deprecate enableTimestampEpoch option

PiperOrigin-RevId: 886867078

Author: l46kok

bundle/src/main/java/dev/cel/bundle/CelExperimentalFactory.java

@@ -50,11 +50,7 @@ public static CelBuilder plannerCelBuilder() {
                 CelCheckerLegacyImpl.newBuilder().setStandardEnvironmentEnabled(true)),
             CelRuntimeImpl.newBuilder())
         // CEL-Internal-2
-        .setOptions(
-            CelOptions.current()
-                .enableHeterogeneousNumericComparisons(true)
-                .enableTimestampEpoch(true)
-                .build());
+        .setOptions(CelOptions.current().enableHeterogeneousNumericComparisons(true).build());
   }
 
   private CelExperimentalFactory() {}

bundle/src/test/java/dev/cel/bundle/CelImplTest.java

@@ -2109,7 +2109,6 @@ public void program_fdsContainsWktDependency_descriptorInstancesMatch() throws E
         standardCelBuilderWithMacros()
             .addMessageTypes(descriptors)
             // CEL-Internal-2
-            .setOptions(CelOptions.current().enableTimestampEpoch(true).build())
             .setContainer(CelContainer.ofName("cel.expr.conformance.proto3"))
             .build();
     CelAbstractSyntaxTree ast =

checker/src/test/java/dev/cel/checker/CelCheckerLegacyImplTest.java

@@ -63,7 +63,7 @@ public void toCheckerBuilder_isImmutable() {
   public void toCheckerBuilder_singularFields_copied() {
     CelStandardDeclarations subsetDecls =
         CelStandardDeclarations.newBuilder().includeFunctions(StandardFunction.BOOL).build();
-    CelOptions celOptions = CelOptions.current().enableTimestampEpoch(true).build();
+    CelOptions celOptions = CelOptions.current().build();
     CelContainer celContainer = CelContainer.ofName("foo");
     CelType expectedResultType = SimpleType.BOOL;
     CelTypeProvider customTypeProvider =

common/src/main/java/dev/cel/common/CelOptions.java

@@ -293,14 +293,20 @@ public abstract static class Builder {
     public abstract Builder enableHomogeneousLiterals(boolean value);
 
     /**
-     * Enable the {@code int64_to_timestamp} overload which creates a timestamp from Uxix epoch
+     * Enable the {@code int64_to_timestamp} overload which creates a timestamp from Unix epoch
      * seconds.
      *
-     * <p>This option will be automatically enabled after a sufficient period of time has elapsed to
-     * ensure that all runtimes support the implementation.
+     * <p>Historically used to opt-in to this feature, this option is now enabled by default across
+     * all runtimes.
      *
      * <p>TODO: Remove this feature once it has been auto-enabled.
+     *
+     * @deprecated This option is now enabled by default. If you are passing {@code true}, simply
+     *     remove this method call. If you are passing {@code false} to disable this feature, subset
+     *     the environment instead using {@code dev.cel.checker.CelStandardDeclarations} and {@code
+     *     dev.cel.runtime.CelStandardFunctions}.
      */
+    @Deprecated
     public abstract Builder enableTimestampEpoch(boolean value);
 
     /**

conformance/src/test/java/dev/cel/conformance/ConformanceTest.java

@@ -58,7 +58,6 @@ public final class ConformanceTest extends Statement {
 
   private static final CelOptions OPTIONS =
       CelOptions.current()
-          .enableTimestampEpoch(true)
           .enableHeterogeneousNumericComparisons(true)
           .enableProtoDifferencerEquality(true)
           .enableOptionalSyntax(true)

extensions/src/test/java/dev/cel/extensions/CelOptionalLibraryTest.java

@@ -123,11 +123,7 @@ private CelBuilder newCelBuilder(int version) {
     }
 
     return celBuilder
-        .setOptions(
-            CelOptions.current()
-                .enableTimestampEpoch(true)
-                .enableHeterogeneousNumericComparisons(true)
-                .build())
+        .setOptions(CelOptions.current().enableHeterogeneousNumericComparisons(true).build())
         .setStandardMacros(CelStandardMacro.STANDARD_MACROS)
         .setContainer(CelContainer.ofName("cel.expr.conformance.proto3"))
         .addMessageTypes(TestAllTypes.getDescriptor())

optimizer/src/test/java/dev/cel/optimizer/optimizers/ConstantFoldingOptimizerTest.java

@@ -47,7 +47,7 @@
 @RunWith(TestParameterInjector.class)
 public class ConstantFoldingOptimizerTest {
   private static final CelOptions CEL_OPTIONS =
-      CelOptions.current().populateMacroCalls(true).enableTimestampEpoch(true).build();
+      CelOptions.current().populateMacroCalls(true).build();
   private static final Cel CEL =
       CelFactory.standardCelBuilder()
           .addVar("x", SimpleType.DYN)

optimizer/src/test/java/dev/cel/optimizer/optimizers/InliningOptimizerTest.java

@@ -58,8 +58,7 @@ public class InliningOptimizerTest {
               "child",
               StructTypeReference.create(TestAllTypes.NestedMessage.getDescriptor().getFullName()))
           .addVar("shadowed_ident", SimpleType.INT)
-          .setOptions(
-              CelOptions.current().populateMacroCalls(true).enableTimestampEpoch(true).build())
+          .setOptions(CelOptions.current().populateMacroCalls(true).build())
           .build();
 
   @Test

optimizer/src/test/java/dev/cel/optimizer/optimizers/SubexpressionOptimizerBaselineTest.java

@@ -265,8 +265,7 @@ private static CelBuilder newCelBuilder() {
         .addMessageTypes(TestAllTypes.getDescriptor())
         .setContainer(CelContainer.ofName("cel.expr.conformance.proto3"))
         .setStandardMacros(CelStandardMacro.STANDARD_MACROS)
-        .setOptions(
-            CelOptions.current().enableTimestampEpoch(true).populateMacroCalls(true).build())
+        .setOptions(CelOptions.current().populateMacroCalls(true).build())
         .addCompilerLibraries(
             CelExtensions.optional(), CelExtensions.bindings(), CelExtensions.comprehensions())
         .addRuntimeLibraries(CelExtensions.optional(), CelExtensions.comprehensions())

optimizer/src/test/java/dev/cel/optimizer/optimizers/SubexpressionOptimizerTest.java

@@ -105,8 +105,7 @@ private static CelBuilder newCelBuilder() {
     return CelFactory.standardCelBuilder()
         .addMessageTypes(TestAllTypes.getDescriptor())
         .setStandardMacros(CelStandardMacro.STANDARD_MACROS)
-        .setOptions(
-            CelOptions.current().enableTimestampEpoch(true).populateMacroCalls(true).build())
+        .setOptions(CelOptions.current().populateMacroCalls(true).build())
         .addCompilerLibraries(CelExtensions.bindings())
         .addFunctionDeclarations(
             CelFunctionDecl.newFunctionDeclaration(