incr ver. Don't re-use previously bad build number

ConfigApp.s need PublishReadyToRun and RuntimeIdentifies
bug fix: WindowsConfigApp must explicitly load a type from the Dinah.Core.WindowsDesktop asm since avalonia doesn't reference it
2026-08-07 04:42:17 -04:00 · 2022-08-15 22:03:51 -04:00 · 2022-08-15 22:01:38 -04:00 · 2022-08-15 10:20:41 -04:00 · 2022-08-15 09:41:33 -04:00 · 2022-08-14 21:53:34 -04:00
807 changed files with 50742 additions and 16616 deletions
@@ -0,0 +1,31 @@
 ---
 name: Bug report
 about: Create a report to help us improve Libation
 title: ''
 labels: bug
 assignees: ''
 ---
 **Describe the bug**
 A clear and concise description of what the bug is.
 **To Reproduce**
 Steps to reproduce the behavior:
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
 4. See error
 **Expected behavior**
 A clear and concise description of what you expected to happen.
 **Screenshots**
 If applicable, add screenshots to help explain your problem.
 **Platform**
 [e.g. Windows 10, Windows 11, Mac, Linux (State distribution)]
 **Log Files**
 Attach your Libation log file here.
@@ -0,0 +1,19 @@
 ---
 name: Feature request
 about: Suggest an idea for this project
 title: ''
 labels: enhancement
 assignees: ''
 ---
 **Is your feature request related to a problem? Please describe.**
 A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
 **Describe the solution you'd like**
 A clear and concise description of what you want to happen.
 **Describe alternatives you've considered**
 A clear and concise description of any alternative solutions or features you've considered.
 **Additional context**
 Add any other context or screenshots about the feature request here.
@@ -4,6 +4,7 @@
 ## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
 # User-specific files
 *.rsuser
 *.suo
 *.user
 *.userosscache
@@ -12,6 +13,9 @@
 # User-specific files (MonoDevelop/Xamarin Studio)
 *.userprefs
 # Mono auto generated files
 mono_crash.*
 # Build results
 [Dd]ebug/
 [Dd]ebugPublic/
@@ -19,10 +23,15 @@
 [Rr]eleases/
 x64/
 x86/
 [Ww][Ii][Nn]32/
 [Aa][Rr][Mm]/
 [Aa][Rr][Mm]64/
 bld/
 [Bb]in/
 [Oo]bj/
 [Oo]ut/
 [Ll]og/
 [Ll]ogs/
 # Visual Studio 2015/2017 cache/options directory
 .vs/
@@ -36,9 +45,10 @@ Generated\ Files/
 [Tt]est[Rr]esult*/
 [Bb]uild[Ll]og.*
-# NUNIT
+# NUnit
 *.VisualState.xml
 TestResult.xml
 nunit-*.xml
 # Build Results of an ATL Project
 [Dd]ebugPS/
@@ -52,7 +62,9 @@ BenchmarkDotNet.Artifacts/
 project.lock.json
 project.fragment.lock.json
 artifacts/
-**/Properties/launchSettings.json
+
 # ASP.NET Scaffolding
 ScaffoldingReadMe.txt
 # StyleCop
 StyleCopReport.xml
@@ -60,7 +72,7 @@ StyleCopReport.xml
 # Files built by Visual Studio
 *_i.c
 *_p.c
-*_i.h
+*_h.h
 *.ilk
 *.meta
 *.obj
@@ -77,6 +89,7 @@ StyleCopReport.xml
 *.tlh
 *.tmp
 *.tmp_proj
 *_wpftmp.csproj
 *.log
 *.vspscc
 *.vssscc
@@ -119,9 +132,6 @@ _ReSharper*/
 *.[Rr]e[Ss]harper
 *.DotSettings.user
 # JustCode is a .NET coding add-in
 .JustCode
 # TeamCity is a build add-in
 _TeamCity*
@@ -132,6 +142,11 @@ _TeamCity*
 .axoCover/*
 !.axoCover/settings.json
 # Coverlet is a free, cross platform Code Coverage Tool
 coverage*.json
 coverage*.xml
 coverage*.info
 # Visual Studio code coverage results
 *.coverage
 *.coveragexml
@@ -169,7 +184,7 @@ publish/
 *.azurePubxml
 # Note: Comment the next line if you want to checkin your web deploy settings,
 # but database connection strings (with potential passwords) will be unencrypted
-*.pubxml
+#*.pubxml
 *.publishproj
 # Microsoft Azure Web App publish settings. Comment the next line if you want to
@@ -179,6 +194,8 @@ PublishScripts/
 # NuGet Packages
 *.nupkg
 # NuGet Symbol Packages
 *.snupkg
 # The packages folder can be ignored because of Package Restore
 **/[Pp]ackages/*
 # except build/, which is used as an MSBuild target.
@@ -203,12 +220,14 @@ BundleArtifacts/
 Package.StoreAssociation.xml
 _pkginfo.txt
 *.appx
 *.appxbundle
 *.appxupload
 # Visual Studio cache files
 # files ending in .cache can be ignored
 *.[Cc]ache
 # but keep track of directories ending in .cache
-!*.[Cc]ache/
+!?*.[Cc]ache/
 # Others
 ClientBin/
@@ -221,7 +240,7 @@ ClientBin/
 *.publishsettings
 orleans.codegen.cs
-# Including strong name files can present a security risk 
+# Including strong name files can present a security risk
 # (https://github.com/github/gitignore/pull/2483#issue-259490424)
 #*.snk
@@ -252,6 +271,9 @@ ServiceFabricBackup/
 *.bim.layout
 *.bim_*.settings
 *.rptproj.rsuser
 *- [Bb]ackup.rdl
 *- [Bb]ackup ([0-9]).rdl
 *- [Bb]ackup ([0-9][0-9]).rdl
 # Microsoft Fakes
 FakesAssemblies/
@@ -287,12 +309,8 @@ paket-files/
 # FAKE - F# Make
 .fake/
-# JetBrains Rider
+# CodeRush personal settings
-.idea/
+.cr/personal
 *.sln.iml
 # CodeRush
 .cr/
 # Python Tools for Visual Studio (PTVS)
 __pycache__/
@@ -317,7 +335,7 @@ __pycache__/
 # OpenCover UI analysis results
 OpenCover/
-# Azure Stream Analytics local run output 
+# Azure Stream Analytics local run output
 ASALocalRun/
 # MSBuild Binary and Structured Log
@@ -326,10 +344,30 @@ ASALocalRun/
 # NVidia Nsight GPU debugger configuration file
 *.nvuser
-# MFractors (Xamarin productivity tool) working folder 
+# MFractors (Xamarin productivity tool) working folder
 .mfractor/
 # Local History for Visual Studio
 .localhistory/
 # BeatPulse healthcheck temp database
 healthchecksdb
 # Backup folder for Package Reference Convert tool in Visual Studio 2017
 MigrationBackup/
 # Ionide (cross platform F# VS Code tools) working folder
 .ionide/
 # Fody - auto-generated XML schema
 FodyWeavers.xsd
 ### manually ignored files
 # Windows shortcuts
 *.lnk
 # manually ignored files
 /__TODO.txt
 /DataLayer/LibationContext.db
 */bin-Avalonia
@@ -0,0 +1,6 @@
 {
   "WindowsClassic": "Libation\\.\\d+\\.\\d+\\.\\d+-win-classic\\.zip",
   "WindowsAvalonia":"Libation\\.\\d+\\.\\d+\\.\\d+-win-chardonnay\\.zip",
   "LinuxAvalonia":  "Libation\\.\\d+\\.\\d+\\.\\d+-linux-chardonnay",
   "MacOSAvalonia":  "Libation\\.\\d+\\.\\d+\\.\\d+-macos-chardonnay"
 }
@@ -1,123 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.1</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <Reference Include="taglib-sharp">
      <HintPath>lib\taglib-sharp.dll</HintPath>
    </Reference>
  </ItemGroup>
  <ItemGroup>
    <Folder Include="..\..\..\..\..\..\Dinah%2527s folder\coding\_NET\Visual Studio 2019\Libation\AaxDecrypter\UNTESTED\BytesCrackerLib\" />
  </ItemGroup>
  <ItemGroup>
    <ProjectReference Include="..\..\Dinah.Core\Dinah.Core\Dinah.Core.csproj" />
  </ItemGroup>
  <ItemGroup>
    <None Update="BytesCrackerLib\alglib1.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_0_10000x789935_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_1_10000x791425_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_2_10000x790991_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_3_10000x792120_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_4_10000x790743_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_5_10000x790568_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_6_10000x791458_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_7_10000x791707_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_8_10000x790202_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\audible_byte#4-4_9_10000x791022_0.rtc">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\ffmpeg.exe">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\ffprobe.exe">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="BytesCrackerLib\rcrack.exe">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\AtomicParsley.exe">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\avcodec-57.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\avdevice-57.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\avfilter-6.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\avformat-57.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\avutil-55.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\cygcrypto-1.0.0.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\cyggcc_s-1.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\cygmp4v2-2.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\cygstdc++-6.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\cygwin1.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\cygz.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\ffmpeg.exe">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\ffprobe.exe">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\mp4trackdump.exe">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\postproc-54.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\swresample-2.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\swscale-4.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
    <None Update="DecryptLib\taglib-sharp.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </None>
  </ItemGroup>
 </Project>
@@ -1,356 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Globalization;
 using System.IO;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using Dinah.Core;
 using Dinah.Core.Diagnostics;
 using Dinah.Core.IO;
 using Dinah.Core.StepRunner;
 namespace AaxDecrypter
 {
    public interface ISimpleAaxToM4bConverter
    {
        event EventHandler<int> DecryptProgressUpdate;
        bool Run();
        string AppName { get; set; }
        string inputFileName { get; }
        byte[] coverBytes { get;  }
        string outDir { get; }
        string outputFileName { get; }
        Chapters chapters { get; }
        Tags tags { get; }
        EncodingInfo encodingInfo { get; }
        void SetOutputFilename(string outFileName);
    }
    public interface IAdvancedAaxToM4bConverter : ISimpleAaxToM4bConverter
    {
        bool Step1_CreateDir();
        bool Step2_DecryptAax();
        bool Step3_Chapterize();
        bool Step4_InsertCoverArt();
        bool Step5_Cleanup();
        bool Step6_AddTags();
        bool End_CreateCue();
        bool End_CreateNfo();
    }
    /// <summary>full c# app. integrated logging. no UI</summary>
    public class AaxToM4bConverter : IAdvancedAaxToM4bConverter
    {
        public event EventHandler<int> DecryptProgressUpdate;
        public string inputFileName { get; }
        public string decryptKey { get; private set; }
        private StepSequence steps { get; }
        public byte[] coverBytes { get; private set; }
        public string AppName { get; set; } = nameof(AaxToM4bConverter);
        public string outDir { get; private set; }
        public string outputFileName { get; private set; }
        public Chapters chapters { get; private set; }
        public Tags tags { get; private set; }
        public EncodingInfo encodingInfo { get; private set; }
        public static async Task<AaxToM4bConverter> CreateAsync(string inputFile, string decryptKey)
        {
            var converter = new AaxToM4bConverter(inputFile, decryptKey);
            await converter.prelimProcessing();
            converter.printPrelim();
            return converter;
        }
        private AaxToM4bConverter(string inputFile, string decryptKey)
        {
 			ArgumentValidator.EnsureNotNullOrWhiteSpace(inputFile, nameof(inputFile));
            if (!File.Exists(inputFile))
                throw new ArgumentNullException(nameof(inputFile), "File does not exist");
            steps = new StepSequence
            {
                Name = "Convert Aax To M4b",
                ["Step 1: Create Dir"] = Step1_CreateDir,
                ["Step 2: Decrypt Aax"] = Step2_DecryptAax,
                ["Step 3: Chapterize and tag"] = Step3_Chapterize,
                ["Step 4: Insert Cover Art"] = Step4_InsertCoverArt,
                ["Step 5: Cleanup"] = Step5_Cleanup,
                ["Step 6: Add Tags"] = Step6_AddTags,
                ["End: Create Cue"] = End_CreateCue,
                ["End: Create Nfo"] = End_CreateNfo
            };
            inputFileName = inputFile;
            this.decryptKey = decryptKey;
        }
        private async Task prelimProcessing()
        {
            tags = new Tags(inputFileName);
            encodingInfo = new EncodingInfo(inputFileName);
            chapters = new Chapters(inputFileName, tags.duration.TotalSeconds);
            var defaultFilename = Path.Combine(
                Path.GetDirectoryName(inputFileName),
                getASCIITag(tags.author),
                getASCIITag(tags.title) + ".m4b"
                );
            SetOutputFilename(defaultFilename);
            await Task.Run(() => saveCover(inputFileName));
        }
        private string getASCIITag(string property)
        {
            foreach (char ch in new string(Path.GetInvalidFileNameChars()) + new string(Path.GetInvalidPathChars()))
                property = property.Replace(ch.ToString(), "");
            return property;
        }
        private void saveCover(string aaxFile)
        {
 			using var file = TagLib.File.Create(aaxFile, "audio/mp4", TagLib.ReadStyle.Average);
 			coverBytes = file.Tag.Pictures[0].Data.Data;
 		}
        private void printPrelim()
        {
            Console.WriteLine("Audible Book ID = " + tags.id);
            Console.WriteLine("Book: " + tags.title);
            Console.WriteLine("Author: " + tags.author);
            Console.WriteLine("Narrator: " + tags.narrator);
            Console.WriteLine("Year: " + tags.year);
            Console.WriteLine("Total Time: "
                + tags.duration.GetTotalTimeFormatted()
                + " in " + chapters.Count() + " chapters");
            Console.WriteLine("WARNING-Source is "
                + encodingInfo.originalBitrate + " kbits @ "
                + encodingInfo.sampleRate + "Hz, "
                + encodingInfo.channels + " channels");
        }
        public bool Run()
        {
            var (IsSuccess, Elapsed) = steps.Run();
            if (!IsSuccess)
            {
                Console.WriteLine("WARNING-Conversion failed");
                return false;
            }
            var speedup = (int)(tags.duration.TotalSeconds / (long)Elapsed.TotalSeconds);
            Console.WriteLine("Speedup is " + speedup + "x realtime.");
            Console.WriteLine("Done");
            return true;
        }
        public void SetOutputFilename(string outFileName)
        {
            outputFileName = outFileName;
            if (Path.GetExtension(outputFileName) != ".m4b")
                outputFileName = outputFileWithNewExt(".m4b");
            outDir = Path.GetDirectoryName(outputFileName);
        }
        private string outputFileWithNewExt(string extension)
            => Path.Combine(outDir, Path.GetFileNameWithoutExtension(outputFileName) + '.' + extension.Trim('.'));
        public bool Step1_CreateDir()
        {
            ProcessRunner.WorkingDir = outDir;
            Directory.CreateDirectory(outDir);
            return true;
        }
        public bool Step2_DecryptAax()
        {
            DecryptProgressUpdate?.Invoke(this, 0);
            var tempRipFile = Path.Combine(outDir, "funny.aac");
            var fail = "WARNING-Decrypt failure. ";
            int returnCode;
            if (string.IsNullOrWhiteSpace(decryptKey))
            {
                returnCode = getKey_decrypt(tempRipFile);
            }
            else
            {
                returnCode = decrypt(tempRipFile);
                if (returnCode == -99)
                {
                    Console.WriteLine($"{fail}Incorrect decrypt key: {decryptKey}");
                    decryptKey = null;
                    returnCode = getKey_decrypt(tempRipFile);
                }
            }
            if (returnCode == 100)
                Console.WriteLine($"{fail}Thread completed without changing return code. This shouldn't be possible");
            else if (returnCode == 0)
            {
                // success!
                FileExt.SafeMove(tempRipFile, outputFileWithNewExt(".mp4"));
                DecryptProgressUpdate?.Invoke(this, 100);
                return true;
            }
            else if (returnCode == -99)
                Console.WriteLine($"{fail}Incorrect decrypt key: {decryptKey}");
            else // any other returnCode
                Console.WriteLine($"{fail}Unknown failure code: {returnCode}");
            FileExt.SafeDelete(tempRipFile);
            DecryptProgressUpdate?.Invoke(this, 0);
            return false;
        }
        private int getKey_decrypt(string tempRipFile)
        {
            getKey();
            return decrypt(tempRipFile);
        }
        private void getKey()
        {
            Console.WriteLine("Discovering decrypt key");
            Console.WriteLine("Getting file hash");
            var checksum = BytesCracker.GetChecksum(inputFileName);
            Console.WriteLine("File hash calculated: " + checksum);
            Console.WriteLine("Cracking activation bytes");
            var activation_bytes = BytesCracker.GetActivationBytes(checksum);
            decryptKey = activation_bytes;
            Console.WriteLine("Activation bytes cracked. Decrypt key: " + activation_bytes);
        }
        private int decrypt(string tempRipFile)
        {
            FileExt.SafeDelete(tempRipFile);
            Console.WriteLine("Decrypting with key " + decryptKey);
            var returnCode = 100;
            var thread = new Thread(() => returnCode = ngDecrypt());
            thread.Start();
            double fileLen = new FileInfo(inputFileName).Length;
            while (thread.IsAlive && returnCode == 100)
            {
                Thread.Sleep(500);
                if (File.Exists(tempRipFile))
                {
                    double tempLen = new FileInfo(tempRipFile).Length;
                    var percentProgress = tempLen / fileLen * 100.0;
                    DecryptProgressUpdate?.Invoke(this, (int)percentProgress);
                }
            }
            return returnCode;
        }
        private int ngDecrypt()
        {
            var info = new ProcessStartInfo
            {
                FileName = DecryptSupportLibraries.mp4trackdumpPath,
                Arguments = "-c " + encodingInfo.channels + " -r " + encodingInfo.sampleRate + " \"" + inputFileName + "\""
            };
            info.EnvironmentVariables["VARIABLE"] = decryptKey;
            var (output, exitCode) = info.RunHidden();
            // bad checksum -- bad decrypt key
            if (output.Contains("checksums mismatch, aborting!"))
                return -99;
            return exitCode;
        }
        // temp file names for steps 3, 4, 5
        string tempChapsPath => Path.Combine(outDir, "tempChaps.mp4");
        string mp4_file => outputFileWithNewExt(".mp4");
        string ff_txt_file => mp4_file + ".ff.txt";
        public bool Step3_Chapterize()
        {
            string str1 = "";
            if (chapters.FirstChapterStart != 0.0)
            {
                str1 = " -ss " + chapters.FirstChapterStart.ToString("0.000", CultureInfo.InvariantCulture) + " -t " + (chapters.LastChapterStart - 1.0).ToString("0.000", CultureInfo.InvariantCulture) + " ";
            }
            string ffmpegTags = tags.GenerateFfmpegTags();
            string ffmpegChapters = chapters.GenerateFfmpegChapters();
            File.WriteAllText(ff_txt_file, ffmpegTags + ffmpegChapters);
            var tagAndChapterInfo = new ProcessStartInfo
            {
                FileName = DecryptSupportLibraries.ffmpegPath,
                Arguments = "-y -i \"" + mp4_file + "\" -f ffmetadata -i \"" + ff_txt_file + "\" -map_metadata 1  -bsf:a aac_adtstoasc -c:a copy" + str1 + " -map 0 \"" + tempChapsPath + "\""
            };
            tagAndChapterInfo.RunHidden();
            return true;
        }
        public bool Step4_InsertCoverArt()
        {
            // save cover image as temp file
            var coverPath = Path.Combine(outDir, "cover-" + Guid.NewGuid() + ".jpg");
            FileExt.CreateFile(coverPath, coverBytes);
            var insertCoverArtInfo = new ProcessStartInfo
            {
                FileName = DecryptSupportLibraries.atomicParsleyPath,
                Arguments = "\"" + tempChapsPath + "\" --encodingTool \"" + AppName + "\" --artwork \"" + coverPath + "\" --overWrite"
            };
            insertCoverArtInfo.RunHidden();
            // delete temp file
            FileExt.SafeDelete(coverPath);
            return true;
        }
        public bool Step5_Cleanup()
        {
            FileExt.SafeDelete(mp4_file);
            FileExt.SafeDelete(ff_txt_file);
            FileExt.SafeMove(tempChapsPath, outputFileName);
            return true;
        }
        public bool Step6_AddTags()
        {
            tags.AddAppleTags(outputFileName);
            return true;
        }
        public bool End_CreateCue()
        {
            File.WriteAllText(outputFileWithNewExt(".cue"), chapters.GetCuefromChapters(Path.GetFileName(outputFileName)));
            return true;
        }
        public bool End_CreateNfo()
        {
            File.WriteAllText(outputFileWithNewExt(".nfo"), NFO.CreateNfoContents(AppName, tags, encodingInfo, chapters));
            return true;
        }
    }
 }
@@ -1,53 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
 using System.Text;
 using System.Threading.Tasks;
 using Dinah.Core;
 using Dinah.Core.Diagnostics;
 namespace AaxDecrypter
 {
    public static class BytesCracker
    {
        public static string GetChecksum(string aaxPath)
        {
            var info = new ProcessStartInfo
            {
                FileName = BytesCrackerSupportLibraries.ffprobePath,
                Arguments = aaxPath.SurroundWithQuotes(),
                WorkingDirectory = Directory.GetCurrentDirectory()
            };
            // checksum is in the debug info. ffprobe's debug info is written to stderr, not stdout
            var readErrorOutput = true;
            var ffprobeStderr = info.RunHidden(readErrorOutput).Output;
            // example checksum line:
            // ... [aax] file checksum == 0c527840c4f18517157eb0b4f9d6f9317ce60cd1
            var checksum = ffprobeStderr.ExtractString("file checksum == ", 40);
            return checksum;
        }
        /// <summary>use checksum to get activation bytes. activation bytes are unique per audible customer. only have to do this 1x/customer</summary>
        public static string GetActivationBytes(string checksum)
        {
            var info = new ProcessStartInfo
            {
                FileName = BytesCrackerSupportLibraries.rcrackPath,
                Arguments = @". -h " + checksum,
                WorkingDirectory = Directory.GetCurrentDirectory()
            };
            var rcrackStdout = info.RunHidden().Output;
            // example result
            // 0c527840c4f18517157eb0b4f9d6f9317ce60cd1  \xbd\x89X\x09  hex:bd895809
            var activation_bytes = rcrackStdout.ExtractString("hex:", 8);
            return activation_bytes;
        }
    }
 }
@@ -1,28 +0,0 @@
 using System.IO;
 namespace AaxDecrypter
 {
    public static class BytesCrackerSupportLibraries
    {
        // GetActivationBytes dependencies
        //   rcrack.exe
        //   alglib1.dll
        //   RainbowCrack files to recover your own Audible activation data (activation_bytes) in an offline manner
        //   audible_byte#4-4_0_10000x789935_0.rtc
        //   audible_byte#4-4_1_10000x791425_0.rtc
        //   audible_byte#4-4_2_10000x790991_0.rtc
        //   audible_byte#4-4_3_10000x792120_0.rtc
        //   audible_byte#4-4_4_10000x790743_0.rtc
        //   audible_byte#4-4_5_10000x790568_0.rtc
        //   audible_byte#4-4_6_10000x791458_0.rtc
        //   audible_byte#4-4_7_10000x791707_0.rtc
        //   audible_byte#4-4_8_10000x790202_0.rtc
        //   audible_byte#4-4_9_10000x791022_0.rtc
        private static string appPath_ { get; } = Path.GetDirectoryName(Dinah.Core.Exe.FileLocationOnDisk);
        private static string bytesCrackerLib_ { get; } = Path.Combine(appPath_, "BytesCrackerLib");
        public static string ffprobePath { get; } = Path.Combine(bytesCrackerLib_, "ffprobe.exe");
        public static string rcrackPath { get; } = Path.Combine(bytesCrackerLib_, "rcrack.exe");
    }
 }
@@ -1,95 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Globalization;
 using System.Linq;
 using System.Text;
 using Dinah.Core.Diagnostics;
 namespace AaxDecrypter
 {
    public class Chapters
    {
        private List<double> markers { get; }
        public double FirstChapterStart => markers[0];
        public double LastChapterStart => markers[markers.Count - 1];
        public Chapters(string file, double totalTime)
        {
            this.markers = getAAXChapters(file);
            // add end time
            this.markers.Add(totalTime);
        }
        private static List<double> getAAXChapters(string file)
        {
            var info = new ProcessStartInfo
            {
                FileName = DecryptSupportLibraries.ffprobePath,
                Arguments = "-loglevel panic -show_chapters -print_format xml \"" + file + "\""
            };
            var xml = info.RunHidden().Output;
            var xmlDocument = new System.Xml.XmlDocument();
            xmlDocument.LoadXml(xml);
            var chapters = xmlDocument.SelectNodes("/ffprobe/chapters/chapter")
                .Cast<System.Xml.XmlNode>()
                .Select(xmlNode => double.Parse(xmlNode.Attributes["start_time"].Value.Replace(",", "."), CultureInfo.InvariantCulture))
                .ToList();
            return chapters;
        }
        // subtract 1 b/c end time marker is a real entry but isn't a real chapter
        public int Count() => this.markers.Count - 1;
        public string GetCuefromChapters(string fileName)
        {
            var stringBuilder = new StringBuilder();
            if (fileName != "")
            {
                stringBuilder.Append("FILE \"" + fileName + "\" MP4\n");
            }
            for (var i = 0; i < Count(); i++)
            {
                var chapter = i + 1;
                var timeSpan = TimeSpan.FromSeconds(this.markers[i]);
                var minutes = Math.Floor(timeSpan.TotalMinutes).ToString();
                var seconds = timeSpan.Seconds.ToString("D2");
                var milliseconds = (timeSpan.Milliseconds / 10).ToString("D2");
                string str = minutes + ":" + seconds + ":" + milliseconds;
                stringBuilder.Append("TRACK " + chapter + " AUDIO\n");
                stringBuilder.Append("  TITLE \"Chapter " + chapter.ToString("D2") + "\"\n");
                stringBuilder.Append("  INDEX 01 " + str + "\n");
            }
            return stringBuilder.ToString();
        }
        public string GenerateFfmpegChapters()
        {
            var stringBuilder = new StringBuilder();
            for (var i = 0; i < Count(); i++)
            {
                var chapter = i + 1;
                var start = this.markers[i] * 1000.0;
                var end = this.markers[i + 1] * 1000.0;
                var chapterName = chapter.ToString("D3");
                stringBuilder.Append("[CHAPTER]\n");
                stringBuilder.Append("TIMEBASE=1/1000\n");
                stringBuilder.Append("START=" + start + "\n");
                stringBuilder.Append("END=" + end + "\n");
                stringBuilder.Append("title=" + chapterName + "\n");
            }
            return stringBuilder.ToString();
        }
    }
 }
@@ -1,21 +0,0 @@
 using System.IO;
 namespace AaxDecrypter
 {
    public static class DecryptSupportLibraries
    {
        // OTHER EXTERNAL DEPENDENCIES
        // ffprobe has these pre-req.s as I'm using it:
        // avcodec-57.dll, avdevice-57.dll, avfilter-6.dll, avformat-57.dll, avutil-55.dll, postproc-54.dll, swresample-2.dll, swscale-4.dll, taglib-sharp.dll
        //
        // something else needs the cygwin files (cyg*.dll)
        private static string appPath_ { get; } = Path.GetDirectoryName(Dinah.Core.Exe.FileLocationOnDisk);
        private static string decryptLib_ { get; } = Path.Combine(appPath_, "DecryptLib");
        public static string ffmpegPath { get; } = Path.Combine(decryptLib_, "ffmpeg.exe");
        public static string ffprobePath { get; } = Path.Combine(decryptLib_, "ffprobe.exe");
        public static string atomicParsleyPath { get; } = Path.Combine(decryptLib_, "AtomicParsley.exe");
        public static string mp4trackdumpPath { get; } = Path.Combine(decryptLib_, "mp4trackdump.exe");
    }
 }
@@ -1,41 +0,0 @@
 using System;
 using System.Diagnostics;
 using Dinah.Core.Diagnostics;
 namespace AaxDecrypter
 {
    public class EncodingInfo
    {
        public int sampleRate { get; } = 44100;
        public int channels { get; } = 2;
        public int originalBitrate { get; }
        public EncodingInfo(string file)
        {
            var info = new ProcessStartInfo
            {
                FileName = DecryptSupportLibraries.ffprobePath,
                Arguments = "-loglevel panic -show_streams -print_format flat \"" + file + "\""
            };
            var end = info.RunHidden().Output;
            foreach (string str2 in end.Split('\n'))
            {
                string[] strArray = str2.Split('=');
                switch (strArray[0])
                {
                    case "streams.stream.0.channels":
                        this.channels = int.Parse(strArray[1].Replace("\"", "").TrimEnd('\r', '\n'));
                        break;
                    case "streams.stream.0.sample_rate":
                        this.sampleRate = int.Parse(strArray[1].Replace("\"", "").TrimEnd('\r', '\n'));
                        break;
                    case "streams.stream.0.bit_rate":
                        string s = strArray[1].Replace("\"", "").TrimEnd('\r', '\n');
                        this.originalBitrate = (int)Math.Round(double.Parse(s) / 1000.0, MidpointRounding.AwayFromZero);
                        break;
                }
            }
        }
    }
 }
@@ -1,56 +0,0 @@
 namespace AaxDecrypter
 {
    public static class NFO
    {
        public static string CreateNfoContents(string ripper, Tags tags, EncodingInfo encodingInfo, Chapters chapters)
        {
            int _hours = (int)tags.duration.TotalHours;
            string myDuration
                = (_hours > 0 ? _hours + " hours, " : "")
                + tags.duration.Minutes + " minutes, "
                + tags.duration.Seconds + " seconds";
            string str4
                = "General Information\r\n"
                + "===================\r\n"
                + " Title:                  " + tags.title + "\r\n"
                + " Author:                 " + tags.author + "\r\n"
                + " Read By:                " + tags.narrator + "\r\n"
                + " Copyright:              " + tags.year + "\r\n"
                + " Audiobook Copyright:    " + tags.year + "\r\n";
            if (tags.genre != "")
            {
                str4 = str4 + " Genre:                  " + tags.genre + "\r\n";
            }
            string s
                = str4
                + " Publisher:              " + tags.publisher + "\r\n"
                + " Duration:               " + myDuration + "\r\n"
                + " Chapters:               " + chapters.Count() + "\r\n"
                + "\r\n"
                + "\r\n"
                + "Media Information\r\n"
                + "=================\r\n"
                + " Source Format:          Audible AAX\r\n"
                + " Source Sample Rate:     " + encodingInfo.sampleRate + " Hz\r\n"
                + " Source Channels:        " + encodingInfo.channels + "\r\n"
                + " Source Bitrate:         " + encodingInfo.originalBitrate + " kbits\r\n"
                + "\r\n"
                + " Lossless Encode:        Yes\r\n"
                + " Encoded Codec:          AAC / M4B\r\n"
                + " Encoded Sample Rate:    " + encodingInfo.sampleRate + " Hz\r\n"
                + " Encoded Channels:       " + encodingInfo.channels + "\r\n"
                + " Encoded Bitrate:        " + encodingInfo.originalBitrate + " kbits\r\n"
                + "\r\n"
                + " Ripper:                 " + ripper + "\r\n"
                + "\r\n"
                + "\r\n"
                + "Book Description\r\n"
                + "================\r\n"
                + tags.comments;
            return s;
        }
    }
 }
@@ -1,74 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Globalization;
 using System.IO;
 using System.Text;
 using TagLib;
 using TagLib.Mpeg4;
 using Dinah.Core;
 namespace AaxDecrypter
 {
    public class Tags
    {
        public string title { get; }
        public string album { get; }
        public string author { get; }
        public string comments { get; }
        public string narrator { get; }
        public string year { get; }
        public string publisher { get; }
        public string id { get; }
        public string genre { get; }
        public TimeSpan duration { get; }
        public Tags(string file)
        {
 			using TagLib.File tagLibFile = TagLib.File.Create(file, "audio/mp4", ReadStyle.Average);
 			this.title = tagLibFile.Tag.Title.Replace(" (Unabridged)", "");
 			this.album = tagLibFile.Tag.Album.Replace(" (Unabridged)", "");
 			this.author = tagLibFile.Tag.FirstPerformer ?? "[unknown]";
 			this.year = tagLibFile.Tag.Year.ToString();
 			this.comments = tagLibFile.Tag.Comment;
 			this.duration = tagLibFile.Properties.Duration;
 			this.genre = tagLibFile.Tag.FirstGenre;
 			var tag = tagLibFile.GetTag(TagTypes.Apple, true);
 			this.publisher = tag.Publisher;
 			this.narrator = string.IsNullOrWhiteSpace(tagLibFile.Tag.FirstComposer) ? tag.Narrator : tagLibFile.Tag.FirstComposer;
 			this.comments = !string.IsNullOrWhiteSpace(tag.LongDescription) ? tag.LongDescription : tag.Description;
 			this.id = tag.AudibleCDEK;
 		}
        public void AddAppleTags(string file)
        {
 			using var file1 = TagLib.File.Create(file, "audio/mp4", ReadStyle.Average);
 			var tag = (AppleTag)file1.GetTag(TagTypes.Apple, true);
 			tag.Publisher = this.publisher;
 			tag.LongDescription = this.comments;
 			tag.Description = this.comments;
 			file1.Save();
 		}
        public string GenerateFfmpegTags()
        {
            StringBuilder stringBuilder = new StringBuilder();
            stringBuilder.Append(";FFMETADATA1\n");
            stringBuilder.Append("major_brand=aax\n");
            stringBuilder.Append("minor_version=1\n");
            stringBuilder.Append("compatible_brands=aax M4B mp42isom\n");
            stringBuilder.Append("date=" + this.year + "\n");
            stringBuilder.Append("genre=" + this.genre + "\n");
            stringBuilder.Append("title=" + this.title + "\n");
            stringBuilder.Append("artist=" + this.author + "\n");
            stringBuilder.Append("album=" + this.album + "\n");
            stringBuilder.Append("composer=" + this.narrator + "\n");
            stringBuilder.Append("comment=" + this.comments.Truncate(254) + "\n");
            stringBuilder.Append("description=" + this.comments + "\n");
            return stringBuilder.ToString();
        }
    }
 }
@@ -1,15 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.1</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <ProjectReference Include="..\..\audible api\AudibleApi\AudibleApiDTOs\AudibleApiDTOs.csproj" />
    <ProjectReference Include="..\..\audible api\AudibleApi\AudibleApi\AudibleApi.csproj" />
    <ProjectReference Include="..\DtoImporterService\DtoImporterService.csproj" />
    <ProjectReference Include="..\InternalUtilities\InternalUtilities.csproj" />
    <ProjectReference Include="..\LibationSearchEngine\LibationSearchEngine.csproj" />
  </ItemGroup>
 </Project>
@@ -1,57 +0,0 @@
 using System;
 using System.Threading.Tasks;
 using AudibleApi;
 using DataLayer;
 using DtoImporterService;
 using InternalUtilities;
 namespace ApplicationServices
 {
 	public static class LibraryCommands
 	{
 		public static async Task<(int totalCount, int newCount)> ImportLibraryAsync(ILoginCallback callback)
 		{
 			try
 			{
 				var audibleApiActions = new AudibleApiActions();
 				var items = await audibleApiActions.GetAllLibraryItemsAsync(callback);
 				var totalCount = items.Count;
 				Serilog.Log.Logger.Debug($"GetAllLibraryItems: Total count {totalCount}");
 				var libImporter = new LibraryImporter();
 				var newCount = await Task.Run(() => libImporter.Import(items));
 				Serilog.Log.Logger.Debug($"Import: New count {newCount}");
 				await Task.Run(() => SearchEngineCommands.FullReIndex());
 				Serilog.Log.Logger.Debug("FullReIndex: success");
 				return (totalCount, newCount);
 			}
 			catch (Exception ex)
 			{
 				Serilog.Log.Logger.Error(ex, "Error importing library");
 				throw;
 			}
 		}
 		public static int UpdateTags(this LibationContext context, Book book, string newTags)
 		{
 			try
 			{
 				book.UserDefinedItem.Tags = newTags;
 				var qtyChanges = context.SaveChanges();
 				if (qtyChanges > 0)
 					SearchEngineCommands.UpdateBookTags(book);
 				return qtyChanges;
 			}
 			catch (Exception ex)
 			{
 				Serilog.Log.Logger.Error(ex, "Error updating tags");
 				throw;
 			}
 		}
 	}
 }
@@ -1,42 +0,0 @@
 using DataLayer;
 using LibationSearchEngine;
 namespace ApplicationServices
 {
 	public static class SearchEngineCommands
 	{
 		public static void FullReIndex()
 		{
 			var engine = new SearchEngine();
 			engine.CreateNewIndex();
 		}
 		public static SearchResultSet Search(string searchString)
 		{
 			var engine = new SearchEngine();
 			try
 			{
 				return engine.Search(searchString);
 			}
 			catch (System.IO.FileNotFoundException)
 			{
 				FullReIndex();
 				return engine.Search(searchString);
 			}
 		}
 		public static void UpdateBookTags(Book book)
 		{
 			var engine = new SearchEngine();
 			try
 			{
 				engine.UpdateTags(book.AudibleProductId, book.UserDefinedItem.Tags);
 			}
 			catch (System.IO.FileNotFoundException)
 			{
 				FullReIndex();
 				engine.UpdateTags(book.AudibleProductId, book.UserDefinedItem.Tags);
 			}
 		}
 	}
 }
@@ -1,18 +0,0 @@
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Metadata.Builders;
 namespace DataLayer.Configurations
 {
    internal class LibraryBookConfig : IEntityTypeConfiguration<LibraryBook>
    {
        public void Configure(EntityTypeBuilder<LibraryBook> entity)
        {
            entity.HasKey(b => b.BookId);
            entity
                .HasOne(le => le.Book)
                .WithOne()
                .HasForeignKey<LibraryBook>(le => le.BookId);
        }
    }
 }
@@ -1,4 +0,0 @@
 namespace DataLayer
 {
    public enum Role { Author = 1, Narrator = 2, Publisher = 3 }
 }
@@ -1,40 +0,0 @@
 using Dinah.Core;
 namespace DataLayer
 {
    public class SeriesBook
    {
        internal int SeriesId { get; private set; }
        internal int BookId { get; private set; }
        /// <summary>
        /// <para>"index" not "order". This is both for sequence and display</para>
        /// <para>Float allows for in-between books. eg: 2.5</para>
        /// <para>To show 2 editions as the same book in a series, give them the same index</para>
        /// <para>null IS NOT the same as 0. Some series call a book "book 0"</para>
        /// </summary>
        public float? Index { get; private set; }
        public Series Series { get; private set; }
        public Book Book { get; private set; }
        private SeriesBook() { }
        internal SeriesBook(Series series, Book book, float? index = null)
        {
            ArgumentValidator.EnsureNotNull(series, nameof(series));
            ArgumentValidator.EnsureNotNull(book, nameof(book));
            Series = series;
            Book = book;
            Index = index;
        }
        public void UpdateIndex(float? index)
        {
            if (index.HasValue)
                Index = index.Value;
        }
 		public override string ToString() => $"Series={Series} Book={Book}";
 	}
 }
@@ -1,38 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Linq.Expressions;
 using Microsoft.EntityFrameworkCore;
 namespace DataLayer
 {
    public static class BookQueries
    {
        public static Book GetBook_Flat_NoTracking(string productId)
        {
 			using var context = LibationContext.Create();
 			return context
                .Books
                .AsNoTracking()
                .GetBook(productId);
 		}
        public static Book GetBook(this IQueryable<Book> books, string productId)
            => books
                .GetBooks()
                .SingleOrDefault(b => b.AudibleProductId == productId);
        /// <summary>This is still IQueryable. YOU MUST CALL ToList() YOURSELF</summary>
        public static IQueryable<Book> GetBooks(this IQueryable<Book> books, Expression<Func<Book, bool>> predicate)
            => books
                .GetBooks()
                .Where(predicate);
        public static IQueryable<Book> GetBooks(this IQueryable<Book> books)
            => books
                // owned items are always loaded. eg: book.UserDefinedItem, book.Supplements
                .Include(b => b.SeriesLink).ThenInclude(sb => sb.Series)
                .Include(b => b.ContributorsLink).ThenInclude(c => c.Contributor)
                .Include(b => b.Category).ThenInclude(c => c.ParentCategory);
    }
 }
@@ -1,19 +0,0 @@
 using System;
 using System.Linq;
 namespace DataLayer
 {
    public static class GenericPaging
    {
        public static IQueryable<T> Page<T>(this IQueryable<T> query, int pageNumZeroStart, int pageSize)
        {
            if (pageSize < 1)
                throw new ArgumentOutOfRangeException(nameof(pageSize), "pageSize must be at least 1");
            if (pageNumZeroStart > 0)
                query = query.Skip(pageNumZeroStart * pageSize);
            return query.Take(pageSize);
        }
    }
 }
@@ -1,47 +0,0 @@
 using System.Collections.Generic;
 using System.Linq;
 using Microsoft.EntityFrameworkCore;
 namespace DataLayer
 {
    public static class LibraryQueries
 	{
 		public static List<LibraryBook> GetLibrary_Flat_WithTracking(this LibationContext context)
 			=> context
 				.Library
 				.GetLibrary()
 				.ToList();
 		public static List<LibraryBook> GetLibrary_Flat_NoTracking()
        {
 			using var context = LibationContext.Create();
 			return context
                .Library
                .AsNoTracking()
                .GetLibrary()
                .ToList();
 		}
        public static LibraryBook GetLibraryBook_Flat_NoTracking(string productId)
        {
 			using var context = LibationContext.Create();
 			return context
                .Library
                .AsNoTracking()
 				.GetLibraryBook(productId);
 		}
        /// <summary>This is still IQueryable. YOU MUST CALL ToList() YOURSELF</summary>
        public static IQueryable<LibraryBook> GetLibrary(this IQueryable<LibraryBook> library)
            => library
                // owned items are always loaded. eg: book.UserDefinedItem, book.Supplements
                .Include(le => le.Book).ThenInclude(b => b.SeriesLink).ThenInclude(sb => sb.Series)
                .Include(le => le.Book).ThenInclude(b => b.ContributorsLink).ThenInclude(c => c.Contributor)
                .Include(le => le.Book).ThenInclude(b => b.Category).ThenInclude(c => c.ParentCategory);
        public static LibraryBook GetLibraryBook(this IQueryable<LibraryBook> library, string productId)
            => library
                .GetLibrary()
                .SingleOrDefault(le => le.Book.AudibleProductId == productId);
    }
 }
@@ -1,38 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using Dinah.Core.Collections.Generic;
 using Dinah.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.ChangeTracking;
 namespace DataLayer
 {
    internal class TagPersistenceInterceptor : IDbInterceptor
    {
        public void Executed(DbContext context) { }
        public void Executing(DbContext context)
 		{
 			// persist tags:
 			var modifiedEntities = context
 				.ChangeTracker
 				.Entries()
 				.Where(p => p.State.In(EntityState.Modified, EntityState.Added))
 				.ToList();
 			persistTags(modifiedEntities);
 		}
 		private static void persistTags(List<EntityEntry> modifiedEntities)
 		{
 			var tagSets = modifiedEntities
 				.Select(e => e.Entity as UserDefinedItem)
 				// filter by null but NOT by blank. blank is the valid way to show the absence of tags
 				.Where(a => a != null)
 				.ToList();
 			foreach (var t in tagSets)
 				FileManager.TagsPersistence.Save(t.Book.AudibleProductId, t.Tags);
 		}
 	}
 }
@@ -1,38 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
 namespace DataLayer.Utilities
 {
 	public static class LocalDatabaseInfo
 	{
 		public static List<string> GetLocalDBInstances()
 		{
 			// Start the child process.
 			using var p = new System.Diagnostics.Process
 			{
 				StartInfo = new System.Diagnostics.ProcessStartInfo
 				{
 					UseShellExecute = false,
 					RedirectStandardOutput = true,
 					FileName = "cmd.exe",
 					Arguments = "/C sqllocaldb info",
 					CreateNoWindow = true,
 					WindowStyle = System.Diagnostics.ProcessWindowStyle.Hidden
 				}
 			};
 			p.Start();
 			var output = p.StandardOutput.ReadToEnd();
 			p.WaitForExit();
 			// if LocalDb is not installed then it will return that 'sqllocaldb' is not recognized as an internal or external command operable program or batch file
 			return string.IsNullOrWhiteSpace(output) || output.Contains("not recognized")
 				? new List<string>()
 				: output
 					.Split(new string[] { Environment.NewLine }, StringSplitOptions.None)
 					.Select(i => i.Trim())
 					.Where(i => !string.IsNullOrEmpty(i))
 					.ToList();
 		}
 	}
 }
@@ -1,122 +0,0 @@
 using System;
 using Dinah.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore;
 namespace _scratch_pad
 {
    ////// to use this as a console, open properties and change from class library => console
    //// DON'T FORGET TO REVERT IT
    //public class Program
    //{
    //    public static void Main(string[] args)
    //    {
    //        var user = new Student() { Name = "Dinah Cheshire" };
    //        var udi = new UserDef { UserDefId = 1, TagsRaw = "my,tags" };
    //        using var context = new MyTestContextDesignTimeDbContextFactory().Create();
    //        context.Add(user);
    //        //context.Add(udi);
    //        context.Update(udi);
    //        context.SaveChanges();
    //        Console.WriteLine($"Student was saved in the database with id: {user.Id}");
    //    }
    //}
    public class MyTestContextDesignTimeDbContextFactory : DesignTimeDbContextFactoryBase<MyTestContext>
    {
        protected override MyTestContext CreateNewInstance(DbContextOptions<MyTestContext> options) => new MyTestContext(options);
        protected override void UseDatabaseEngine(DbContextOptionsBuilder optionsBuilder, string connectionString) => optionsBuilder.UseSqlite(connectionString);
    }
    public class MyTestContext : DbContext
    {
        // see DesignTimeDbContextFactoryBase for info about ctors and connection strings/OnConfiguring()
        public MyTestContext(DbContextOptions<MyTestContext> options) : base(options) { }
        #region classes for OnModelCreating() seed example
        class Blog
        {
            public int BlogId { get; set; }
            public string Url { get; set; }
            public System.Collections.Generic.ICollection<Post> Posts { get; set; }
        }
        class Post
        {
            public int PostId { get; set; }
            public string Content { get; set; }
            public string Title { get; set; }
            public int BlogId { get; set; }
            public Blog Blog { get; set; }
            public Name AuthorName { get; set; }
        }
        class Name
        {
            public string First { get; set; }
            public string Last { get; set; }
        }
        #endregion
        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);
            // config
            modelBuilder.Entity<Blog>(entity => entity.Property(e => e.Url).IsRequired());
            modelBuilder.Entity<Order>().OwnsOne(p => p.OrderDetails, cb =>
            {
                cb.OwnsOne(c => c.BillingAddress);
                cb.OwnsOne(c => c.ShippingAddress);
            });
            modelBuilder.Entity<Post>(entity =>
                entity
                    .HasOne(d => d.Blog)
                    .WithMany(p => p.Posts)
                    .HasForeignKey("BlogId"));
            // BlogSeed
            modelBuilder.Entity<Blog>().HasData(new Blog { BlogId = 1, Url = "http://sample.com" });
            // PostSeed
            modelBuilder.Entity<Post>().HasData(new Post() { BlogId = 1, PostId = 1, Title = "First post", Content = "Test 1" });
            // AnonymousPostSeed
            modelBuilder.Entity<Post>().HasData(new { BlogId = 1, PostId = 2, Title = "Second post", Content = "Test 2" });
            // OwnedTypeSeed
            modelBuilder.Entity<Post>().OwnsOne(p => p.AuthorName).HasData(
                new { PostId = 1, First = "Andriy", Last = "Svyryd" },
                new { PostId = 2, First = "Diego", Last = "Vega" });
        }
        public DbSet<Student> Students { get; set; }
        public DbSet<UserDef> UserDefs { get; set; }
        public DbSet<Order> Orders { get; set; }
    }
    public class Student
    {
        public int Id { get; set; }
        public string Name { get; set; }
    }
    public class UserDef
    {
        public int UserDefId { get; set; }
        public string TagsRaw { get; set; }
    }
    public class Order
    {
        public int Id { get; set; }
        public OrderDetails OrderDetails { get; set; }
    }
    public class OrderDetails
    {
        public StreetAddress BillingAddress { get; set; }
        public StreetAddress ShippingAddress { get; set; }
    }
    public class StreetAddress
    {
        public string Street { get; set; }
        public string City { get; set; }
    }
 }
@@ -1,46 +0,0 @@
 HOW TO CREATE: EF CORE PROJECT
 ==============================
 example is for sqlite but the same works with MsSql
 nuget
 Microsoft.EntityFrameworkCore.Tools (needed for using Package Manager Console)
 Microsoft.EntityFrameworkCore.Sqlite
 MIGRATIONS require standard, not core
 using standard instead of core. edit 3 things in csproj
 1of3: pluralize xml TargetFramework tag to TargetFrameworks
 2of2: TargetFrameworks from: netstandard2.1
 to: netcoreapp3.0;netstandard2.1
 3of3: add
  <PropertyGroup>
    <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
  </PropertyGroup>
 run. error
 SQLite Error 1: 'no such table: Blogs'.
 set project "Set as StartUp Project"
 Tools >> Nuget Package Manager >> Package Manager Console
 default project: Examples\SQLite_NETCore2_0
 PM> add-migration InitialCreate
 PM> Update-Database
 if add-migration xyz throws and error, don't take the error msg at face value. try again with add-migration xyz -verbose
 new sqlite .db file created: Copy always/Copy if newer
 or copy .db file to destination
 relative:
   optionsBuilder.UseSqlite("Data Source=blogging.db");
 absolute  (use fwd slashes):
   optionsBuilder.UseSqlite("Data Source=C:/foo/bar/blogging.db");
 REFERENCE ARTICLES
 ------------------
 https://docs.microsoft.com/en-us/ef/core/get-started/netcore/new-db-sqlite
 https://carlos.mendible.com/2016/07/11/step-by-step-dotnet-core-and-entity-framework-core/
 https://www.benday.com/2017/12/19/ef-core-2-0-migrations-without-hard-coded-connection-strings/
@@ -1,9 +0,0 @@
 {
  "ConnectionStrings": {
    "LibationContext_sqlserver": "Server=(LocalDb)\\MSSQLLocalDB;Database=DataLayer.LibationContext;Integrated Security=true;",
    "LibationContext": "Data Source=LibationContext.db;Foreign Keys=False;",
    "// on windows sqlite paths accept windows and/or unix slashes": "",
    "MyTestContext": "Data Source=%DESKTOP%/sample.db"
  }
 }
@@ -0,0 +1,79 @@
 ## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
 ### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PalPal.me](https://paypal.me/mcrackan?locale.x=en_us)
 ...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
 # Advanced: Table of Contents
 - [Files and folders](#files-and-folders)
 - [Linux and Mac (unofficial)](#linux-and-mac)
 - [Settings](#settings)
 - [Custom File Naming](#custom-file-naming)
 - [Command Line Interface](#command-line-interface)
 ### Files and folders
 To make upgrades and reinstalls easier, Libation separates all of its responsibilities to a few different folders. If you don't want to mess with this stuff: ignore it. Read on if you like a little more control over your files.
 * In Libation's initial folder are the files that make up the program. Since nothing else is here, just copy new files here to upgrade the program. Delete this folder to delete Libation.
 * In a separate folder, Libation keeps track of all of the files it creates like settings and downloaded images. After an upgrade, Libation might think that's its being run for the first time. Just click ADVANCED SETUP and point to this folder. Libation will reload your library and settings.
 * The last important folder is the "books location." This is where Libation looks for your downloaded and decrypted books. This is how it knows which books still need to be downloaded. The Audible id must be somewhere in the book's file or folder name for Libation to detect your downloaded book.
 ### Linux and Mac
 Although Libation only currently officially supports Windows, some users have had success with WINE. ([Linux](https://github.com/rmcrackan/Libation/issues/28#issuecomment-890594158), [OSX Crossover and WINE](https://github.com/rmcrackan/Libation/issues/150#issuecomment-1004918592), [Linux and WINE](https://github.com/rmcrackan/Libation/issues/28#issuecomment-1161111014))
 ### Settings
 * Allow Libation to fix up audiobook metadata. After decrypting a title, Libation attempts to fix details like chapters and cover art. Some power users and/or control freaks prefer to manage this themselves. By unchecking this setting, Libation will only decrypt the book and will leave metadata as-is, warts and all.
 ### Custom File Naming
 In Settings, on the Download/Decrypt tab, you can specify the format in which you want your files to be named. As you edit these templates, a live example will be shown. Parameters are listed for folders, files, and files split by chapter including an explanation of what each naming option means. For instance: you can use template `<title short> - <ch# 0> of <ch count> - <ch title>` to create the file `A Study in Scarlet - 04 of 10 - A Flight for Life.m4b`.
 These templates apply to GUI and CLI.
 ### Command Line Interface
 Libationcli.exe allows limited access to Libation's functionalities as a CLI.
 Warnings about relying solely on on the CLI:
 * CLI will not perform any upgrades.
 * It will show that there is an upgrade, but that will likely scroll by too fast to notice.
 * It will not perform all post-upgrade migrations. Some migrations are only be possible by launching GUI.
 ```
 help
  libationcli --help
 verb-specific help
  libationcli scan --help
 scan all libraries
  libationcli scan
 scan only libraries for specific accounts
  libationcli scan nickname1 nickname2
 convert all m4b files to mp3
  libationcli convert
 liberate all books and pdfs
  libationcli liberate
 liberate pdfs only
  libationcli liberate --pdf
  libationcli liberate -p
 export library to file
  libationcli export --path "C:\foo\bar\my.json" --json
  libationcli export -p "C:\foo\bar\my.json" -j
  libationcli export -p "C:\foo\bar\my.csv" --csv
  libationcli export -p "C:\foo\bar\my.csv" -c
  libationcli export -p "C:\foo\bar\my.xlsx" --xlsx
  libationcli export -p "C:\foo\bar\my.xlsx" -x
 ```
@@ -0,0 +1,138 @@
 ## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
 ### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PalPal.me](https://paypal.me/mcrackan?locale.x=en_us)
 ...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
 # Getting started: Table of Contents
 - [Download Libation](#download-libation-1)
 - [Installation](#installation)
 - [Create Accounts](#create-accounts)
 - [Import your library](#import-your-library)
 - [Download your books -- DRM-free!](#download-your-books----drm-free)
 - [Download PDF attachments](#download-pdf-attachments)
 - [Details of downloaded files](#details-of-downloaded-files)
 - [Export your library](#export-your-library)
 ### [Download Libation](https://github.com/rmcrackan/Libation/releases)
 ### Installation
 To install Libation, extract the zip file to a folder, for example `C:\Libation`, and then run Libation.exe from that folder to begin the configuration process and configure your account(s).
 ### Create Accounts
 Create your account(s):
 ![Create your accounts, menu](images/v40_accounts.png)
 New locale options include many more regions including old audible accounts which pre-date the amazon acquisition
 ![Choose your account locales](images/v40_locales.png)
 ### Import your library
 Be default, Libation will periodically scan the accounts you added above with a checkbox next to them. Nothing for you to do. You can also scan manually.
 Select Import > Scan Library:
 ![Import step 1](images/Import1.png)
 Or if you have multiple accounts, you'll get to choose whether to scan all accounts or just the ones you select:
 ![Import which accounts](images/v40_import.png)
 If this is a new installation, or you're scanning an account you haven't scanned before, you'll be prompted to enter your password for the Audible account.
 ![Login password](images/alt-login1.png)
 Enter the password and click Submit. Audible will prompt you with a CAPTCHA image. 
 ![Login captcha](images/alt-login2.png)
 Enter the CAPTCHA answer characters and click Submit. If all has gone well, Libation will start scanning the account. 
 In rare instances, the Captcha image/response will fail in an endless loop. If this happens, delete the problem account, and then click Save. Re-add the account and click Save again. Now try to scan the account again. This time, instead of typing your password, click the link that says "Or click here". This will open the Audible External Login dialog shown below.
 ![Login alternative setup](images/alt-login3.png)
 You can either copy the URL shown and paste it into your browser or launch the browser directly by clicking Launch in Browser. Audible will display its standard login page. Login, including answering the CAPTCHA on the next page. In some cases, you might have to approve the login from the email account associated with that login, but once the login is successful, you'll see an error message.
 ![Login alternative login result](images/alt-login4.png)
 This actually means you've successfully logged in. Copy the entire URL shown in your browser and return to Libation. Paste that URL into the text box at the bottom of the Audible External Login window and click Submit.
 You'll see this window while it's scanning:
 ![Import step 2](images/Import2.png)
 Success! We see how many new titles are imported:
 ![Import step 3](images/Import3.png)
 ### Download your books -- DRM-free!
 Automatically download some or all of your audible books. This shows you how much of your library is not yet downloaded and decrypted:
 The stoplights will tell you a title's status:
 * Green: downloaded and decrypted
 * Yellow: downloaded but still encrypted with DRM
 * Red: not downloaded
 * PDF icon without arrow: downloaded
 * PDF with arrow: not downloaded
 Or hover over the button to see the status.
 ![Liberate book step 1](images/LiberateBook1.png)
 Select Liberate > Begin Book Backups
 You can also click on the stop light to download only that title and its PDF
 ![Liberate book step 2](images/LiberateBook2.png)
 First the original book with DRM is downloaded
 ![Liberate book step 3](images/LiberateBook3.png)
 Then it's decrypted so you can use it on any device you choose. The very first time you decrypt a book, this step will take a while. Every other book will go much faster. The first time, Libation has to figure out the special decryption key which allows your personal books to be unlocked.
 ![Liberate book step 4](images/LiberateBook4.png)
 And voila! If you have multiple books not yet liberated, Libation will automatically move on to the next.
 ![Liberate book step 5](images/LiberateBook5.png)
 The Audible id must be somewhere in the book's file or folder name for Libation to detect your downloaded book.
 ### Download PDF attachments
 For books which include PDF downloads, Libation can download these for you as well and will attempt to store them with the book. "Book backup" will already download an available PDF. This additional option is useful when Audible adds a PDF to your book after you've already backed it up.
 Select Liberate > Begin PDF Backups
 ![PDF download step 2](images/PdfDownload2.png)
 The downloads work just like with books, only with no additional decryption needed.
 ![PDF download step 3](images/PdfDownload3.png)
 ### Details of downloaded files
 ![Post download](images/PostDownload.png)
 When you set up Libation, you'll specify a Books directory. Libation looks inside that directory and all subdirectories to look for files or folders with each library book's audible id. This way, organization is completely up to you. When you download + decrypt a book, you get several files
 * .m4b: your audiobook in m4b format. This is the most pure version of your audiobook and retains the highest quality. Now that it's decrypted, you can play it on any audio player and put it on any device. If you'd like, you can also use 3rd party tools to turn it into an mp3. The freedom to do what you want with your files was the original inspiration for Libation.
 * .cue: this is a file which logs where chapter breaks occur. Many tools are able to use this if you want to split your book into files along chapter lines.
 ### Export your library
 ![Export](images/Export.png)
 Export your library to Excel, CSV, or JSON
@@ -0,0 +1,79 @@
 ## [Download Libation](https://github.com/rmcrackan/Libation/releases/latest)
 ### If you found this useful, tell a friend. If you found this REALLY useful, you can click here to [PalPal.me](https://paypal.me/mcrackan?locale.x=en_us)
 ...or just tell more friends. As long as I'm maintaining this software, it will remain **free** and **open source**.
 # Searching and filtering: Table of Contents
 - [Tags](#tags)
 - [Searches](#searches)
 - [Search examples](#search-examples)
 - [Filters](#filters)
 ### Tags
 To add tags to a title, click the tags button
 ![Tags step 1](images/Tags1.png)
 Add as many tags as you'd like. Tags are separated by a space. Each tag can contain letters, numbers, and underscores
 ![Tags step 2](images/Tags2.png)
 Tags are saved non-case specific for easy search. There is one special tag "hidden" which will also grey-out the book
 ![Tags step 3](images/Tags3.png)
 To edit tags, just click the button again.
 ### Searches
 Libation's advanced searching is built on the powerful Lucene search engine. Simple searches are effortless and powerful searches are simple. To search, just type and click Filter or press enter
 * Type anything in the search box to search common fields: title, authors, narrators, and the book's audible id
 * Use Lucene's "Query Parser Syntax" for advanced searching.
    * Easy tutorial: http://www.lucenetutorial.com/lucene-query-syntax.html
    * Full official guide: https://lucene.apache.org/core/2_9_4/queryparsersyntax.html
 * Tons of search fields, specific to audiobooks
 * Synonyms so you don't have to memorize magic words. Eg: author and author**s** will both work
 * Click [?] button for a full list of search fields and synonyms ![Filter options](images/FilterOptionsButton.png)
 * Search by tag like \[this\]
 * When tags have an underscore you can use part of the tag. This is useful for quick categories. The below examples make this more clear.
 ### Search examples
 Search for anything with the word potter
 ![Search example: potter](images/SearchExamplePotter.png)
 If you only want to see Harry Potter
 ![Search example: "harry potter"](images/SearchExampleHarryPotter.png)
 If you only want to see potter except for Harry Potter. You can also use "-" instead of "NOT"
 ![Search example: "potter NOT harry"](images/SearchExamplePotterNotHarry.png)
 ![Search example: "potter -harry"](images/SearchExamplePotterNotHarry2.png)
 To see only books written by Neil Gaiman where he also narrates his own book. (If you don't include AND, you'll see everything written by Neil Gaiman and also all books in your library which are self-narrated.)
 ![Search example: author:gaiman AND authornarrated](images/SearchExampleGaimanAuthorNarrated.png)
 I tagged autobiographies as auto_bio and biographies written by someone else as bio. I can get only autobiographies with \[auto_bio\] or get both by searching \[bio\]
 ![Search example: \[bio\]](images/SearchExampleBio.png)
 ![Search example: \[auto_bio\]](images/SearchExampleAutoBio.png)
 ### Filters
 If you have a search you want to save, click Add To Quick Filters to save it in your Quick Filters list. To use it again, select it from the Quick Filters list.
 To edit this list go to Quick Filters > Edit quick filters. Here you can re-order the list, delete filters, double-click a filter to edit it, or double-click the bottom blank box to add a new filter.
 Check "Quick Filters > Start Libation with 1st filter Default" to have your top filter automatically applied when Libation starts. In this top example, I want to always start without these: at books I've tagged hidden, books I've tagged as free_audible_originals, and books which I have rated.
 ![default filters](images/FiltersDefault.png)
@@ -1,13 +0,0 @@
 <Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.1</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <ProjectReference Include="..\..\audible api\AudibleApi\AudibleApiDTOs\AudibleApiDTOs.csproj" />
    <ProjectReference Include="..\DataLayer\DataLayer.csproj" />
    <ProjectReference Include="..\InternalUtilities\InternalUtilities.csproj" />
  </ItemGroup>
 </Project>
@@ -1,137 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using AudibleApiDTOs;
 using DataLayer;
 using InternalUtilities;
 namespace DtoImporterService
 {
 	public class BookImporter : ItemsImporterBase
 	{
 		public override IEnumerable<Exception> Validate(IEnumerable<Item> items) => new BookValidator().Validate(items);
 		protected override int DoImport(IEnumerable<Item> items, LibationContext context)
 		{
 			// pre-req.s
 			new ContributorImporter().Import(items, context);
 			new SeriesImporter().Import(items, context);
 			new CategoryImporter().Import(items, context);
 			// get distinct
 			var productIds = items.Select(i => i.ProductId).ToList();
 			// load db existing => .Local
 			loadLocal_books(productIds, context);
 			// upsert
 			var qtyNew = upsertBooks(items, context);
 			return qtyNew;
 		}
 		private void loadLocal_books(List<string> productIds, LibationContext context)
 		{
 			var localProductIds = context.Books.Local.Select(b => b.AudibleProductId);
 			var remainingProductIds = productIds
 				.Distinct()
 				.Except(localProductIds)
 				.ToList();
 			// GetBooks() eager loads Series, category, et al
 			if (remainingProductIds.Any())
 				context.Books.GetBooks(b => remainingProductIds.Contains(b.AudibleProductId)).ToList();
 		}
 		private int upsertBooks(IEnumerable<Item> items, LibationContext context)
 		{
 			var qtyNew = 0;
 			foreach (var item in items)
 			{
 				var book = context.Books.Local.SingleOrDefault(p => p.AudibleProductId == item.ProductId);
 				if (book is null)
 				{
 					book = createNewBook(item, context);
 					qtyNew++;
 				}
 				updateBook(item, book, context);
 			}
 			return qtyNew;
 		}
 		private static Book createNewBook(Item item, LibationContext context)
 		{
 			// absence of authors is very rare, but possible
 			if (!item.Authors?.Any() ?? true)
 				item.Authors = new[] { new Person { Name = "", Asin = null } };
 			// nested logic is required so order of names is retained. else, contributors may appear in the order they were inserted into the db
 			var authors = item
 				.Authors
 				.Select(a => context.Contributors.Local.Single(c => a.Name == c.Name))
 				.ToList();
 			var narrators
 				= item.Narrators is null || !item.Narrators.Any()
 				// if no narrators listed, author is the narrator
 				? authors
 				// nested logic is required so order of names is retained. else, contributors may appear in the order they were inserted into the db
 				: item
 					.Narrators
 					.Select(n => context.Contributors.Local.Single(c => n.Name == c.Name))
 					.ToList();
 			// categories are laid out for a breadcrumb. category is 1st, subcategory is 2nd
 			// absence of categories is very rare, but possible
 			var lastCategory = item.Categories.LastOrDefault()?.CategoryId ?? "";
 			var category = context.Categories.Local.SingleOrDefault(c => c.AudibleCategoryId == lastCategory);
 			var book = context.Books.Add(new Book(
 				new AudibleProductId(item.ProductId),
 				item.Title,
 				item.Description,
 				item.LengthInMinutes,
 				authors,
 				narrators,
 				category)
 			).Entity;
 			var publisherName = item.Publisher;
 			if (!string.IsNullOrWhiteSpace(publisherName))
 			{
 				var publisher = context.Contributors.Local.Single(c => publisherName == c.Name);
 				book.ReplacePublisher(publisher);
 			}
 			book.UpdateBookDetails(item.IsAbridged, item.DatePublished);
 			if (!string.IsNullOrWhiteSpace(item.SupplementUrl))
 				book.AddSupplementDownloadUrl(item.SupplementUrl);
 			return book;
 		}
 		private static void updateBook(Item item, Book book, LibationContext context)
 		{
 			// set/update book-specific info which may have changed
 			book.PictureId = item.PictureId;
 			book.UpdateProductRating(item.Product_OverallStars, item.Product_PerformanceStars, item.Product_StoryStars);
 			// important to update user-specific info. this will have changed if user has rated/reviewed the book since last library import
 			book.UserDefinedItem.UpdateRating(item.MyUserRating_Overall, item.MyUserRating_Performance, item.MyUserRating_Story);
 			// update series even for existing books. these are occasionally updated
 			// these will upsert over library-scraped series, but will not leave orphans
 			if (item.Series != null)
 			{
 				foreach (var seriesEntry in item.Series)
 				{
 					var series = context.Series.Local.Single(s => seriesEntry.SeriesId == s.AudibleSeriesId);
 					book.UpsertSeries(series, seriesEntry.Index);
 				}
 			}
 		}
 	}
 }
@@ -1,73 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using AudibleApiDTOs;
 using DataLayer;
 using InternalUtilities;
 namespace DtoImporterService
 {
 	public class CategoryImporter : ItemsImporterBase
 	{
 		public override IEnumerable<Exception> Validate(IEnumerable<Item> items) => new CategoryValidator().Validate(items);
 		protected override int DoImport(IEnumerable<Item> items, LibationContext context)
 		{
 			// get distinct
 			var categoryIds = items.GetCategoriesDistinct().Select(c => c.CategoryId).ToList();
 			// load db existing => .Local
 			loadLocal_categories(categoryIds, context);
 			// upsert
 			var categoryPairs = items.GetCategoryPairsDistinct().ToList();
 			var qtyNew = upsertCategories(categoryPairs, context);
 			return qtyNew;
 		}
 		private void loadLocal_categories(List<string> categoryIds, LibationContext context)
 		{
 			var localIds = context.Categories.Local.Select(c => c.AudibleCategoryId);
 			var remainingCategoryIds = categoryIds
 				.Distinct()
 				.Except(localIds)
 				.ToList();
 			// load existing => local
 			// remember to include default/empty/missing
 			var emptyName = Contributor.GetEmpty().Name;
 			if (remainingCategoryIds.Any())
 				context.Categories.Where(c => remainingCategoryIds.Contains(c.AudibleCategoryId) || c.Name == emptyName).ToList();
 		}
 		// only use after loading contributors => local
 		private int upsertCategories(List<Ladder[]> categoryPairs, LibationContext context)
 		{
 			var qtyNew = 0;
 			foreach (var pair in categoryPairs)
 			{
 				for (var i = 0; i < pair.Length; i++)
 				{
 					var id = pair[i].CategoryId;
 					var name = pair[i].CategoryName;
 					Category parentCategory = null;
 					if (i == 1)
 						parentCategory = context.Categories.Local.Single(c => c.AudibleCategoryId == pair[0].CategoryId);
 					var category = context.Categories.Local.SingleOrDefault(c => c.AudibleCategoryId == id);
 					if (category is null)
 					{
 						category = context.Categories.Add(new Category(new AudibleCategoryId(id), name)).Entity;
 						qtyNew++;
 					}
 					category.UpdateParentCategory(parentCategory);
 				}
 			}
 			return qtyNew;
 		}
 	}
 }
@@ -1,91 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using AudibleApiDTOs;
 using DataLayer;
 using InternalUtilities;
 namespace DtoImporterService
 {
 	public class ContributorImporter : ItemsImporterBase
 	{
 		public override IEnumerable<Exception> Validate(IEnumerable<Item> items) => new ContributorValidator().Validate(items);
 		protected override int DoImport(IEnumerable<Item> items, LibationContext context)
 		{
 			// get distinct
 			var authors = items.GetAuthorsDistinct().ToList();
 			var narrators = items.GetNarratorsDistinct().ToList();
 			var publishers = items.GetPublishersDistinct().ToList();
 			// load db existing => .Local
 			var allNames = publishers
 				.Union(authors.Select(n => n.Name))
 				.Union(narrators.Select(n => n.Name))
 				.Where(name => !string.IsNullOrWhiteSpace(name))
 				.ToList();
 			loadLocal_contributors(allNames, context);
 			// upsert
 			var qtyNew = 0;
 			qtyNew += upsertPeople(authors, context);
 			qtyNew += upsertPeople(narrators, context);
 			qtyNew += upsertPublishers(publishers, context);
 			return qtyNew;
 		}
 		private void loadLocal_contributors(List<string> contributorNames, LibationContext context)
 		{
 			//// BAD: very inefficient
 			// var x = context.Contributors.Local.Where(c => !contribNames.Contains(c.Name));
 			// GOOD: Except() is efficient. Due to hashing, it's close to O(n)
 			var localNames = context.Contributors.Local.Select(c => c.Name);
 			var remainingContribNames = contributorNames
 				.Distinct()
 				.Except(localNames)
 				.ToList();
 			// load existing => local
 			// remember to include default/empty/missing
 			var emptyName = Contributor.GetEmpty().Name;
 			if (remainingContribNames.Any())
 				context.Contributors.Where(c => remainingContribNames.Contains(c.Name) || c.Name == emptyName).ToList();
 		}
 		// only use after loading contributors => local
 		private int upsertPeople(List<Person> people, LibationContext context)
 		{
 			var qtyNew = 0;
 			foreach (var p in people)
 			{
 				var person = context.Contributors.Local.SingleOrDefault(c => c.Name == p.Name);
 				if (person == null)
 				{
 					person = context.Contributors.Add(new Contributor(p.Name, p.Asin)).Entity;
 					qtyNew++;
 				}
 			}
 			return qtyNew;
 		}
 		// only use after loading contributors => local
 		private int upsertPublishers(List<string> publishers, LibationContext context)
 		{
 			var qtyNew = 0;
 			foreach (var publisherName in publishers)
 			{
 				if (context.Contributors.Local.SingleOrDefault(c => c.Name == publisherName) == null)
 				{
 					context.Contributors.Add(new Contributor(publisherName));
 					qtyNew++;
 				}
 			}
 			return qtyNew;
 		}
 	}
 }
@@ -1,60 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using AudibleApiDTOs;
 using DataLayer;
 namespace DtoImporterService
 {
 	public interface IContextRunner<T>
 	{
 		public TResult Run<TResult>(Func<T, LibationContext, TResult> func, T param, LibationContext context = null)
 		{
 			if (context is null)
 			{
 				using (context = LibationContext.Create())
 				{
 					var r = Run(func, param, context);
 					context.SaveChanges();
 					return r;
 				}
 			}
 			try
 			{
 				var exceptions = Validate(param);
 				if (exceptions != null && exceptions.Any())
 					throw new AggregateException($"Importer validation failed", exceptions);
 			}
 			catch (Exception ex)
 			{
 				Serilog.Log.Logger.Error(ex, "Import error: validation");
 				throw;
 			}
 			try
 			{
 				var result = func(param, context);
 				return result;
 			}
 			catch (Exception ex)
 			{
 				Serilog.Log.Logger.Error(ex, "Import error: post-validation importing");
 				throw;
 			}
 		}
 		IEnumerable<Exception> Validate(T param);
 	}
 	public abstract class ImporterBase<T> : IContextRunner<T>
 	{
 		/// <summary>LONG RUNNING. call with await Task.Run</summary>
 		public int Import(T param, LibationContext context = null)
 			=> ((IContextRunner<T>)this).Run(DoImport, param, context);
 		protected abstract int DoImport(T elements, LibationContext context);
 		public abstract IEnumerable<Exception> Validate(T param);
 	}
 	public abstract class ItemsImporterBase : ImporterBase<IEnumerable<Item>> { }
 }
@@ -1,39 +0,0 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using AudibleApiDTOs;
 using DataLayer;
 using InternalUtilities;
 namespace DtoImporterService
 {
 	public class LibraryImporter : ItemsImporterBase
 	{
 		public override IEnumerable<Exception> Validate(IEnumerable<Item> items) => new LibraryValidator().Validate(items);
 		protected override int DoImport(IEnumerable<Item> items, LibationContext context)
 		{
 			new BookImporter().Import(items, context);
 			var qtyNew = upsertLibraryBooks(items, context);
 			return qtyNew;
 		}
 		private int upsertLibraryBooks(IEnumerable<Item> items, LibationContext context)
 		{
 			var currentLibraryProductIds = context.Library.Select(l => l.Book.AudibleProductId).ToList();
 			var newItems = items.Where(dto => !currentLibraryProductIds.Contains(dto.ProductId)).ToList();
 			foreach (var newItem in newItems)
 			{
 				var libraryBook = new LibraryBook(
 					context.Books.Local.Single(b => b.AudibleProductId == newItem.ProductId),
 					newItem.DateAdded);
 				context.Library.Add(libraryBook);
 			}
 			var qtyNew = newItems.Count;
 			return qtyNew;
 		}
 	}
 }