Add helper method to initialize DotLottieFile with Data (#2090)

Sources/Public/DotLottie/DotLottieFileHelpers.swift

@@ -78,6 +78,26 @@ extension DotLottieFile {
         return .failure(error)
       }
     }
+
+    /// Loads an DotLottie from a data synchronously. Returns a `Result<DotLottieFile, Error>`
+    ///
+    /// Please use the asynchronous methods whenever possible. This operation will block the Thread it is running in.
+    ///
+    /// - Parameters:
+    ///   - data: The data(`Foundation.Data`) object to load DotLottie from
+    ///   - filename: The name of the lottie file without the lottie extension. eg. "StarAnimation"
+    public static func loadedFrom(
+      data: Data,
+      filename: String)
+      -> Result<DotLottieFile, Error>
+    {
+      do {
+        let dotLottieFile = try DotLottieFile(data: data, filename: filename)
+        return .success(dotLottieFile)
+      } catch {
+        return .failure(error)
+      }
+    }
   }
 
   /// Loads a DotLottie model from a bundle by its name. Returns `nil` if a file is not found.
@@ -289,4 +309,51 @@ extension DotLottieFile {
     }
   }
 
+  /// Loads an DotLottie from a data asynchronously.
+  ///
+  /// - Parameters:
+  ///   - data: The data(`Foundation.Data`) object to load DotLottie from
+  ///   - filename: The name of the lottie file without the lottie extension. eg. "StarAnimation"
+  ///   - dispatchQueue: A dispatch queue used to load animations. Defaults to `DispatchQueue.global()`. Optional.
+  ///   - handleResult: A closure to be called when the file has loaded.
+  public static func loadedFrom(
+    data: Data,
+    filename: String,
+    dispatchQueue: DispatchQueue = .global(),
+    handleResult: @escaping (Result<DotLottieFile, Error>) -> Void)
+  {
+    dispatchQueue.async {
+      do {
+        let dotLottie = try DotLottieFile(data: data, filename: filename)
+        DispatchQueue.main.async {
+          handleResult(.success(dotLottie))
+        }
+      } catch {
+        DispatchQueue.main.async {
+          handleResult(.failure(error))
+        }
+      }
+    }
+  }
+
+  /// Loads an DotLottie from a data asynchronously.
+  ///
+  /// - Parameters:
+  ///   - data: The data(`Foundation.Data`) object to load DotLottie from
+  ///   - filename: The name of the lottie file without the lottie extension. eg. "StarAnimation"
+  ///   - dispatchQueue: A dispatch queue used to load animations. Defaults to `DispatchQueue.global()`. Optional.
+  @available(iOS 13.0, macOS 10.15, tvOS 13.0, *)
+  public static func loadedFrom(
+    data: Data,
+    filename: String,
+    dispatchQueue: DispatchQueue = .global())
+    async throws -> DotLottieFile
+  {
+    try await withCheckedThrowingContinuation { continuation in
+      loadedFrom(data: data, filename: filename, dispatchQueue: dispatchQueue) { result in
+        continuation.resume(with: result)
+      }
+    }
+  }
+
 }