CodeQL: add resolvePacks()

Author: cklin

src/codeql.ts

@@ -127,6 +127,12 @@ export interface CodeQL {
     queries: string[],
     extraSearchPath: string | undefined,
   ): Promise<ResolveQueriesOutput>;
+
+  /**
+   * Run 'codeql resolve packs'
+   */
+  resolvePacks(): Promise<ResolvePacksOutput>;
+
   /**
    * Run 'codeql resolve build-environment'
    */
@@ -261,6 +267,39 @@ export interface ResolveBuildEnvironmentOutput {
   };
 }
 
+export interface PackInfo {
+  kind: string;
+  path: string;
+  version?: string; // Present only under ByNameScan
+}
+
+export interface ByNameScan {
+  paths: string[];
+  found: {
+    [packName: string]: PackInfo;
+  };
+}
+
+export interface StepByName {
+  type: "by-name";
+  scans: ByNameScan[];
+}
+
+export interface StepByNameAndVersion {
+  type: "by-name-and-version";
+  found: {
+    [packName: string]: {
+      [version: string]: PackInfo;
+    };
+  };
+}
+
+export type ResolvePacksStep = StepByName | StepByNameAndVersion;
+
+export interface ResolvePacksOutput {
+  steps: ResolvePacksStep[];
+}
+
 export interface PackDownloadOutput {
   packs: PackDownloadItem[];
 }
@@ -468,6 +507,7 @@ export function setCodeQL(partialCodeql: Partial<CodeQL>): CodeQL {
       async () => ({ aliases: {}, extractors: {} }),
     ),
     resolveQueries: resolveFunction(partialCodeql, "resolveQueries"),
+    resolvePacks: resolveFunction(partialCodeql, "resolvePacks"),
     resolveBuildEnvironment: resolveFunction(
       partialCodeql,
       "resolveBuildEnvironment",
@@ -786,6 +826,25 @@ export async function getCodeQLForCmd(
         throw new Error(`Unexpected output from codeql resolve queries: ${e}`);
       }
     },
+    async resolvePacks(): Promise<ResolvePacksOutput> {
+      const codeqlArgs = [
+        "resolve",
+        "packs",
+        "--format=json",
+        ...getExtraOptionsFromEnv(["resolve", "packs"]),
+      ];
+      // Resolve packs generate a lot of output, so we want to keep the output
+      // out of the Action logs.
+      const output = await runCli(cmd, codeqlArgs, {
+        noStreamStdout: true,
+      });
+
+      try {
+        return JSON.parse(output) as ResolvePacksOutput;
+      } catch (e) {
+        throw new Error(`Unexpected output from codeql resolve packs: ${e}`);
+      }
+    },
     async resolveBuildEnvironment(
       workingDir: string | undefined,
       language: string,