BinaryObjectScanner/BinaryObjectScanner/Protection/Steam.cs

using System.Collections.Generic;
using BinaryObjectScanner.Interfaces;
using SabreTools.IO;
using SabreTools.IO.Extensions;
using SabreTools.IO.Matching;
using SabreTools.Serialization.Wrappers;

namespace BinaryObjectScanner.Protection
{
    public class Steam : IExecutableCheck<PortableExecutable>, IPathCheck
    {
        /// <inheritdoc/>
        public string? CheckExecutable(string file, PortableExecutable exe, bool includeDebug)
        {
            string? name = exe.FileDescription;

            if (name.OptionalContains("Steam Autorun Setup"))
                return "Steam";
            else if (name.OptionalContains("Steam Client API"))
                return "Steam";
            else if (name.OptionalContains("Steam Client Engine"))
                return $"Steam Client Engine {exe.GetInternalVersion()}";
            else if (name.OptionalContains("Steam Client Service"))
                return "Steam";

            name = exe.ProductName;

            if (name.OptionalContains("Steam Autorun Setup"))
                return "Steam";
            else if (name.OptionalContains("Steam Client API"))
                return "Steam";
            else if (name.OptionalContains("Steam Client Service"))
                return "Steam";

            /// TODO: Add entry point checks
            /// https://github.com/horsicq/Detect-It-Easy/blob/master/db/PE/Steam.2.sg

            return null;
        }

        /// <inheritdoc/>
        public List<string> CheckDirectoryPath(string path, List<string>? files)
        {
            var matchers = new List<PathMatchSet>
            {
                // (.sis/.sim/.sid) - Redump entry 12943
                new(
                [
                    new PathMatch(".sis", matchCase: false, useEndsWith: true),
                    new PathMatch(".sim", matchCase: false, useEndsWith: true),
                    new PathMatch(".sid", matchCase: false, useEndsWith: true),
                ], "Steam (.sis/.sim/.sid)"),

                // (.sis/.csm/.csd) - Redump entry 101916
                new(
                [
                    new PathMatch(".sis", matchCase: false, useEndsWith: true),
                    new PathMatch(".csm", matchCase: false, useEndsWith: true),
                    new PathMatch(".csd", matchCase: false, useEndsWith: true),
                ], "Steam (.sis/.csm/.csd)"),

                // These checks are grouped together due to the names being generic on their own (Redump entry 91450).
                new(new List<PathMatch>
                {
                    // TODO: Identify based on "Steam(TM)" being present in "Description" but not in "File Description".
                    // Overmatches on some files, such as IA item "ASMEsMechanicalEngineeringToolkit1997December".
                    // new FilePathMatch("steam.exe"),

                    new FilePathMatch("steam.ini"),
                    
                    // TODO: Identify file using MSI property parsing.
                    new FilePathMatch("steam.msi"),
                }, "Steam"),

                new(new FilePathMatch("steam_api.dll"), "Steam"),
                new(new FilePathMatch("steam_api64.dll"), "Steam"),
                new(new FilePathMatch("steam_install_agreement.rtf"), "Steam"),
                new(new FilePathMatch("SteamInstall.bom"), "Steam"),
                new(new FilePathMatch("SteamInstall.exe"), "Steam"),
                new(new FilePathMatch("SteamInstall.info"), "Steam"),
                new(new FilePathMatch("SteamInstall.ini"), "Steam"),
                new(new FilePathMatch("SteamInstall.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall.pax.gz"), "Steam"),
                new(new FilePathMatch("SteamInstall.pkg"), "Steam"),
                new(new FilePathMatch("SteamInstall.sizes"), "Steam"),
                new(new FilePathMatch("SteamInstall_Czech.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_English.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_French.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_German.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_Italian.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_Polish.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_Russian.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_Spanish.msi"), "Steam"),
                new(new FilePathMatch("SteamRetailInstaller"), "Steam"),
                new(new FilePathMatch("SteamRetailInstaller.dmg"), "Steam"),
                new(new FilePathMatch("SteamService.exe"), "Steam"),
                new(new FilePathMatch("SteamSetup.exe"), "Steam"),
                new(new FilePathMatch("steamxboxutil64.exe"), "Steam"),
            };

            return MatchUtil.GetAllMatches(files, matchers, any: false);
        }

        /// <inheritdoc/>
        public string? CheckFilePath(string path)
        {
            var matchers = new List<PathMatchSet>
            {
                new(new FilePathMatch("steam_api.dll"), "Steam"),
                new(new FilePathMatch("steam_api64.dll"), "Steam"),
                new(new FilePathMatch("steam_install_agreement.rtf"), "Steam"),
                new(new FilePathMatch("SteamInstall.bom"), "Steam"),
                new(new FilePathMatch("SteamInstall.exe"), "Steam"),
                new(new FilePathMatch("SteamInstall.info"), "Steam"),
                new(new FilePathMatch("SteamInstall.ini"), "Steam"),
                new(new FilePathMatch("SteamInstall.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall.pax.gz"), "Steam"),
                new(new FilePathMatch("SteamInstall.pkg"), "Steam"),
                new(new FilePathMatch("SteamInstall.sizes"), "Steam"),
                new(new FilePathMatch("SteamInstall_Czech.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_English.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_French.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_German.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_Italian.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_Polish.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_Russian.msi"), "Steam"),
                new(new FilePathMatch("SteamInstall_Spanish.msi"), "Steam"),
                new(new FilePathMatch("SteamRetailInstaller"), "Steam"),
                new(new FilePathMatch("SteamRetailInstaller.dmg"), "Steam"),
                new(new FilePathMatch("SteamService.exe"), "Steam"),
                new(new FilePathMatch("SteamSetup.exe"), "Steam"),
                new(new FilePathMatch("steamxboxutil64.exe"), "Steam"),
            };

            return MatchUtil.GetFirstMatch(path, matchers, any: true);
        }
    }
}