Merged PR 54616: Implement parallel update, token check, api class

Heavily refactored the figma update method
Implemented per-update NodeMetadata
Implement filtering shallow update
Cleanup code with analyzers
Implement token verification
Implement base FigmaApi class

Author: ivan-trackman

Editor/Core/JsonUtility.cs

@@ -34,7 +34,7 @@ public static void Initialize()
             #endregion
         }
 
-        public abstract class ArrayConverter<T, U> : JsonConverter
+        public abstract class ArrayConverter<T, TEnum> : JsonConverter
         {
             #region Methods
             public override bool CanConvert(Type objectType) => objectType == typeof(T[]);
@@ -52,7 +52,7 @@ public override void WriteJson(JsonWriter writer, object value, JsonSerializer s
                 foreach (T node in array) serializer.Serialize(writer, node);
                 writer.WriteEndArray();
             }
-            protected U GetValue(JObject obj, string name = "type") => (U)Enum.Parse(typeof(U), obj[name].Value<string>());
+            protected TEnum GetValue(JObject obj, string name = "type") => (TEnum)Enum.Parse(typeof(TEnum), obj[name].Value<string>());
             protected abstract T ToObject(JObject obj, JsonSerializer serializer);
             #endregion
         }

Editor/Core/NodeMetadata.cs

@@ -0,0 +1,48 @@
+using System.Collections.Generic;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+using Trackman;
+
+namespace Figma.Inspectors
+{
+    using global;
+
+    abstract class FigmaApi
+    {
+        const string api = "https://api.figma.com/v1";
+
+        #region Fields
+        protected readonly string title;
+        protected readonly Dictionary<string, string> headers;
+        #endregion
+
+        #region Constructors
+        protected FigmaApi(string personalAccessToken = default, string title = default)
+        {
+            this.title = title;
+            headers = new Dictionary<string, string> { { "X-FIGMA-TOKEN", personalAccessToken } };
+        }
+        #endregion
+
+        #region Support Methods
+        protected async Task<string> GetJsonAsync(string get, CancellationToken token = default)
+        {
+            return GetString(await $"{api}/{get}".HttpGetAsync(headers, cancellationToken: token));
+        }
+        protected async Task<T> ConvertOnBackgroundAsync<T>(string json, CancellationToken token) where T : class
+        {
+            return await Task.Run(() => Task.FromResult(JsonUtility.FromJson<T>(json)), token);
+        }
+        protected async Task<T> GetAsync<T>(string get, CancellationToken token = default) where T : class
+        {
+            string json = await GetJsonAsync(get, token);
+            return await ConvertOnBackgroundAsync<T>(json, token);
+        }
+        string GetString(byte[] bytes)
+        {
+            return Encoding.UTF8.GetString(bytes);
+        }
+        #endregion
+    }
+}

Editor/Core/NodeMetadata.cs.meta

@@ -0,0 +1,21 @@
+using System.Threading.Tasks;
+
+namespace Figma.Inspectors
+{
+    using global;
+
+    class FigmaTokenTest : FigmaApi
+    {
+        #region Constructors
+        internal FigmaTokenTest(string personalAccessToken = default) : base(personalAccessToken) { }
+        #endregion
+
+        #region Methods
+        internal async Task<bool> TestAsync()
+        {
+            Me me = await GetAsync<Me>("me");
+            return string.IsNullOrEmpty(me.err) && me.email.Contains("@");
+        }
+        #endregion
+    }
+}