last ...

Interfaces/IXStorageProvider.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.Http;
 using Microsoft.Extensions.FileProviders;
@@ -11,7 +12,8 @@ using xStorageService.Models;
 
 namespace xStorageService.Interfaces
 {
-    public partial interface IXStorageProvider {
+    public partial interface IXStorageProvider
+    {
         XStorageConfiguration Configuration { get; }
         XStorageHelper StorageHelper { get; }
         IFileProvider FileProvider { get; }
@@ -19,84 +21,101 @@ namespace xStorageService.Interfaces
 
         //
         #region Special Folders Path Getter (s) ...
-        string GetStorageFolderPath ();
-        string GetTempFolderPath ();
-        string GetThumbFolderPath ();
-        string GetUploadsFolderPath ();
-        string GetWidgetsFolderPath ();
-        string GetImageFolderPath ();
-        string GetAudioFolderPath ();
-        string GetVideoFolderPath ();
-        string GetDocumentFolderPath ();
-        string FilePathResolver (string fullPath);
+        string GetStorageFolderPath();
+        string GetTempFolderPath();
+        string GetThumbFolderPath();
+        string GetUploadsFolderPath();
+        string GetWidgetsFolderPath();
+        string GetImageFolderPath();
+        string GetAudioFolderPath();
+        string GetVideoFolderPath();
+        string GetDocumentFolderPath();
+        string FilePathResolver(string fullPath);
+        string ConvertToFileUrl(string fullPath);
         #endregion
 
         //
         #region Prepare Storage Structure ...
-        void Prepare ();
+        void Prepare();
         #endregion
 
         //
         #region Validators ...
-        bool IsFolderExists (string path);
-        bool IsFileExists (string filePath);
-        bool IsSupportThumb (string fileName);
-        bool IsSupportThumb (XFileType type);
-        void ValidateFileExists (string filePath);
-        void ValidateFileModel (XFileDto file);
-        void ValidateFile (IFormFile file);
-        void ValidateProfileImage (IFormFile file);
+        bool IsFolderExists(string path);
+        bool IsFileExists(string filePath);
+        bool IsSupportThumb(string fileName);
+        bool IsSupportThumb(XFileType type);
+        void ValidateFileExists(string filePath);
+        void ValidateFileModel(XFileDto file);
+        void ValidateFile(IFormFile file);
+        void ValidateProfileImage(IFormFile file);
         #endregion
 
         //
         #region Generators ...
-        string NewFileName ();
-        string GenerateThumbName (string fileName);
-        string GetNewFileName (string fileName);
+        string NewFileName();
+        string GenerateThumbName(string fileName);
+        string GetNewFileName(string fileName);
         #endregion
 
         //
         #region Tools Actions ...
 
-        string GetFileExtension (string fileName);
-        string GetFileNameWithoutExtension (string fileName);
-        FileExtensions GetFileExtensionType (string fileName);
-        XFileType GetFileType (string fileName);
-        XFileType GetFileType (FileExtensions fileExtension);
-        string GetThumbnailFileFullPath (string thumFileName);
-        string GetRelatedThumbnailFullPath (string fileName);
-        string GetFileTypeFolderPath (XFileType type);
-        string GetFileFolderPath (
+        string GetFileExtension(string fileName);
+        string GetFileNameWithoutExtension(string fileName);
+        FileExtensions GetFileExtensionType(string fileName);
+        XFileType GetFileType(string fileName);
+        XFileType GetFileType(FileExtensions fileExtension);
+        string GetThumbnailFileFullPath(string thumFileName);
+        string GetRelatedThumbnailFullPath(string fileName);
+        string GetFileTypeFolderPath(XFileType type);
+        string GetFileFolderPath(
             string fileName,
             bool isTemp = false,
             bool isWidget = false
         );
-        string GetFileFullPath (
+        string GetFileFullPath(
             string fileName,
             bool isTemp = false,
             bool isWidget = false
         );
-        Task<string> SaveFileAsync (
+        Task<string> SaveFileAsync(
             IFormFile file,
             bool isTemp = false,
-            bool isWidget = false
+            bool isWidget = false,
+            CancellationToken cancellationToken = default
         );
-        void DeleteFile (
+        void DeleteFile(
             string fileFullPath,
             bool forceFileExists = true,
             Exception exception = null
         );
-        ICollection<string> DeleteFiles (
+        ICollection<string> DeleteFiles(
             ICollection<string> fileFullPaths,
             bool forceFileExists = true,
             Exception exception = null
         );
         // Task CreateThumbnail (XFile file);
-        Task CreateThumbnail (XFileDto file);
-        Task CreateThumbnail (string fileName);
-        Task<XFileResult> HandleProfileImageSave (IFormFile file);
-        Task<XFileResult> HandleFileSave (IFormFile file);
-        Task<IEnumerable<XFileResult>> HandleFilesSave (IFormFileCollection files);
+        Task CreateThumbnail(
+            XFileDto file,
+            CancellationToken cancellationToken = default
+        );
+        Task CreateThumbnail(
+            string fileName,
+            CancellationToken cancellationToken = default
+        );
+        Task<XFileResult> HandleProfileImageSave(
+            IFormFile file,
+            CancellationToken cancellationToken = default
+        );
+        Task<XFileResult> HandleFileSave(
+            IFormFile file,
+            CancellationToken cancellationToken = default
+        );
+        Task<IEnumerable<XFileResult>> HandleFilesSave(
+            IFormFileCollection files,
+            CancellationToken cancellationToken = default
+        );
         #endregion    
     }
 }

nuget.config

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <configuration>
   <packageSources>
+    <!-- <add key="megan" value="https://hub.megan.ir/nuget/index.json" /> -->
     <add key="nuget" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
-    <add key="liget" value="https://nuget.saherelmhub.ir/v3/index.json" protocolVersion="3" />
+    <add key="baget" value="https://nuget.saherelmhub.ir/v3/index.json" protocolVersion="3" disableTLSCertificateValidation="true" />
   </packageSources>
 </configuration>

xStorageService.csproj

@@ -2,13 +2,15 @@
 
   <!-- Runtime Definition -->
   <PropertyGroup>
-    <TargetFramework>netstandard2.0</TargetFramework>
-    <PackageId>xDashboard.xStorageService</PackageId>
     <Version>1.0.0</Version>
+    <LangVersion>12.0</LangVersion>
     <Authors>Hadi Khazaee Asl</Authors>
     <Company>SaherElm IT Center</Company>
+    <TargetFramework>netstandard2.0</TargetFramework>
+    <PackageId>xDashboard.xStorageService</PackageId>
+
     <Description>
-    provide File Storage/Validating/Handling and etc tools to xDashboard project.
+      provide File Storage/Validating/Handling and etc tools to xDashboard project.
     </Description>
 
     <!-- Icon Definition -->
@@ -17,19 +19,30 @@
 
   <!-- Icon Handling -->
   <ItemGroup>
-    <None Include="../../Resources/Images/favicon.png" Link="icon.png" Pack="true" PackagePath="\icon.png" />
+    <None Include="../../Resources/Images/favicon.png" Link="icon.png" Pack="true"
+      PackagePath="\icon.png" />
   </ItemGroup>
 
   <!-- Local Modules -->
   <ItemGroup>
-    <PackageReference Include="xDashboard.xModels" Version="1.0.0" />
-    <!-- <ProjectReference Include="../xModels/xModels.csproj" /> -->
+  </ItemGroup>
+
+  <!-- Local Dependencies -->
+  <ItemGroup>
+    <ProjectReference Include="../xModels/xModels.csproj" />
   </ItemGroup>
 
   <!-- Dependencies -->
   <ItemGroup>
     <PackageReference Include="Magick.NET-Q8-AnyCPU" Version="7.23.1" />
-    <PackageReference Include="Microsoft.Extensions.FileProviders.Physical" Version="5.0.0" />
+    <PackageReference Include="Microsoft.Extensions.FileProviders.Physical" Version="3.1.32.0" />
   </ItemGroup>
 
+  <!-- For XML Documentation Support -->
+  <PropertyGroup>
+    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
+  </PropertyGroup>
+
 </Project>