SNOW-1880020: Add marker annotation for Snowflake internal API (#2028)

Author: sfc-gh-dprzybysz

src/main/java/net/snowflake/client/core/SnowflakeOrgInternalApi.java

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2025 Snowflake Computing Inc. All right reserved.
+ */
+package net.snowflake.client.core;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Elements marked with this annotation should be considered as internal API and are public API only
+ * for Snowflake internal tools. Starting from version 4.x there will be no guarantees that
+ * annotated elements will maintain backward compatibility.
+ */
+@Target({
+  ElementType.PACKAGE,
+  ElementType.TYPE,
+  ElementType.FIELD,
+  ElementType.CONSTRUCTOR,
+  ElementType.METHOD
+})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface SnowflakeOrgInternalApi {}

src/main/java/net/snowflake/client/jdbc/SnowflakeFileTransferAgent.java

@@ -57,6 +57,7 @@
 import net.snowflake.client.core.SFFixedViewResultSet;
 import net.snowflake.client.core.SFSession;
 import net.snowflake.client.core.SFStatement;
+import net.snowflake.client.core.SnowflakeOrgInternalApi;
 import net.snowflake.client.jdbc.cloud.storage.SnowflakeStorageClient;
 import net.snowflake.client.jdbc.cloud.storage.StageInfo;
 import net.snowflake.client.jdbc.cloud.storage.StorageClientFactory;
@@ -2199,6 +2200,7 @@ private static void pushFileToRemoteStore(
    * @param config Configuration to upload a file to cloud storage
    * @throws Exception if error occurs while data upload.
    */
+  @SnowflakeOrgInternalApi
   public static void uploadWithoutConnection(SnowflakeFileTransferConfig config) throws Exception {
     logger.trace("Entering uploadWithoutConnection...");
 

src/main/java/net/snowflake/client/jdbc/SnowflakeFileTransferConfig.java

@@ -8,10 +8,12 @@
 import java.util.Properties;
 import net.snowflake.client.core.OCSPMode;
 import net.snowflake.client.core.SFSession;
+import net.snowflake.client.core.SnowflakeOrgInternalApi;
 
 /**
  * This class manages the parameters to call SnowflakeFileTransferAgent.uploadWithoutConnection()
  */
+@SnowflakeOrgInternalApi
 public class SnowflakeFileTransferConfig {
   private SnowflakeFileTransferMetadata metadata;
   private InputStream uploadStream;