feat: implement sas file system for IOM/COM connections (#1388)

**Summary**
This adds sas file system support for sas9 file system for IOM/COM connection types. Additionally, it includes a small refactor to the way interop libraries are loaded. Loading them at SASRunner construction occurs too late, and doesn't provide the type-checking necessary for file service.

**Testing**
 - [x] Test entering incorrect password **(note: an issue remains here that is present on main. You can't attempt to re-log in if you've entered a wrong password unless you reload window)**
 - [x] File/folder creation
    - [x] Create file/folder w/ context menu
    - [x] Create file/folder by upload
    - [x] Create file/folder by drag & drop (create multiple files)
 - [x] File/folder deletion
    - [x] Test file deletion with context menu
    - [x] Test multi-file deletion with context menu
 - [x] File/folder updates
    - [x] Test updating file/folder name
    - [x] Test updating file contents
    - [x] Test moving file/folder (multiple files/folders)
 - [x] Test downloading files/folders
 - [x] Make sure refresh works as expected
    - [x] Make sure connections are automatically refreshed after they become stale
 - [x] Make sure we're displaying all files/folders for sas server and that items are sorted by type (directories before files), then alphabetically
 - [x] Make sure we can collapse all folders
 - [x] Cases to test from previous rest implementation
    - [x] Create folder with special character, like `/`
    - [x] Create folder in same spot as folder with same name
    - [x] Create a .txt file named as `NewFile+!@$%^&*.txt` **(NOTE: File is not created in this instance. sas9's file service rejects this file name)**
    - [x] Check multi-selection behavior to make sure things work as expected
    - [x] Rename file (and folder) as same name as existing file
    - [x]  Create file in folder, keep file open, delete folder (make sure file goes away)
    - [x] Create a file named `!@$%^&*(.txt`, attempt to download it  **(NOTE: File is not created in this instance. sas9's file service rejects this file name)**
    - [x] Try dropping a file into a folder where there's already a file sharing the same name
    - [x] Try renaming an open file

Author: scottdover

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). If you introduce breaking changes, please group them together in the "Changed" section using the **BREAKING:** prefix.
 
+## [Unreleased]
+
+### Added
+
+- Add sas file system support for ITC-based (IOM/COM) connections ([#1388](https://github.com/sassoftware/vscode-sas-extension/pull/1388))
+
 ## [v1.14.0] - 2025-04-28
 
 ### Added

client/src/commands/authorize.ts

@@ -41,6 +41,7 @@ export const checkProfileAndAuthorize =
       case ConnectionType.IOM:
       case ConnectionType.COM:
         commands.executeCommand("setContext", "SAS.librariesDisplayed", true);
+        commands.executeCommand("setContext", "SAS.serverDisplayed", true);
         libraryNavigator.refresh();
         return finishAuthorization(profileConfig);
       default:

client/src/commands/run.ts

@@ -273,6 +273,8 @@ const isErrorRep = (err: unknown): err is ErrorRepresentation => {
 
 export const onRunError = (err) => {
   console.dir(err);
+  commands.executeCommand("setContext", "SAS.librariesDisplayed", false);
+  commands.executeCommand("setContext", "SAS.serverDisplayed", false);
 
   if (err.response) {
     // The request was made and we got a status code that falls out side of the 2xx range

client/src/components/ContentNavigator/ContentAdapterFactory.ts

@@ -1,5 +1,6 @@
 // Copyright © 2024, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
+import ITCSASServerAdapter from "../../connection/itc/ITCSASServerAdapter";
 import RestSASServerAdapter from "../../connection/rest/RestSASServerAdapter";
 import SASContentAdapter from "../../connection/rest/SASContentAdapter";
 import { ConnectionType } from "../profile";
@@ -10,7 +11,6 @@ import {
 } from "./types";
 
 class ContentAdapterFactory {
-  // TODO #889 Update this to return ITCSASServerAdapter
   public create(
     connectionType: ConnectionType,
     sourceType: ContentNavigatorConfig["sourceType"],
@@ -19,6 +19,9 @@ class ContentAdapterFactory {
     switch (key) {
       case `${ConnectionType.Rest}.${ContentSourceType.SASServer}`:
         return new RestSASServerAdapter();
+      case `${ConnectionType.IOM}.${ContentSourceType.SASServer}`:
+      case `${ConnectionType.COM}.${ContentSourceType.SASServer}`:
+        return new ITCSASServerAdapter();
       case `${ConnectionType.Rest}.${ContentSourceType.SASContent}`:
       default:
         return new SASContentAdapter();

client/src/components/ContentNavigator/ContentDataProvider.ts

@@ -585,7 +585,7 @@ class ContentDataProvider
     } else if (target.type === FAVORITES_FOLDER_TYPE) {
       success = await this.addToMyFavorites(item);
     } else {
-      const targetUri = target.resourceId;
+      const targetUri = target.resourceId ?? target.uri;
       success = await this.moveItem(item, targetUri);
       if (success) {
         this.refresh();

client/src/components/ContentNavigator/utils.ts

@@ -9,9 +9,10 @@ import {
   window,
 } from "vscode";
 
+import { resourceType } from "../../connection/rest/util";
 import { DEFAULT_FILE_CONTENT_TYPE } from "./const";
 import mimeTypes from "./mime-types";
-import { ContentItem } from "./types";
+import { ContentItem, Permission } from "./types";
 
 export const isContainer = (item: ContentItem): boolean =>
   item.fileStat.type === FileType.Directory;
@@ -84,6 +85,28 @@ export const createStaticFolder = (
   ],
 });
 
+export const convertStaticFolderToContentItem = (
+  staticFolder: ReturnType<typeof createStaticFolder>,
+  permission: Permission,
+): ContentItem => {
+  const item: ContentItem = {
+    ...staticFolder,
+    uid: staticFolder.id,
+    creationTimeStamp: 0,
+    modifiedTimeStamp: 0,
+    permission,
+    fileStat: {
+      ctime: 0,
+      mtime: 0,
+      size: 0,
+      type: FileType.Directory,
+    },
+  };
+  item.contextValue = resourceType(item);
+  item.typeName = staticFolder.type;
+  return item;
+};
+
 export const getEditorTabsForItem = (item: ContentItem) => {
   const fileUri = item.vscUri;
   const tabs: Tab[] = window.tabGroups.all.map((tg) => tg.tabs).flat();
@@ -94,3 +117,16 @@ export const getEditorTabsForItem = (item: ContentItem) => {
       tab.input.uri.query.includes(fileUri.query), // compare the file id
   );
 };
+
+export const sortedContentItems = (items: ContentItem[]) =>
+  items.sort((a, b) => {
+    const aIsDirectory = a.fileStat?.type === FileType.Directory;
+    const bIsDirectory = b.fileStat?.type === FileType.Directory;
+    if (aIsDirectory && !bIsDirectory) {
+      return -1;
+    } else if (!aIsDirectory && bIsDirectory) {
+      return 1;
+    } else {
+      return a.name.localeCompare(b.name);
+    }
+  });

client/src/connection/itc/CodeRunner.ts

@@ -2,25 +2,55 @@
 // SPDX-License-Identifier: Apache-2.0
 import { commands } from "vscode";
 
+import { v4 } from "uuid";
+
 import { ITCSession } from ".";
 import { LogLine, getSession } from "..";
 import { useRunStore } from "../../store";
+import { Session } from "../session";
+import { extractTextBetweenTags } from "../util";
 
 let wait: Promise<string> | undefined;
 
+export async function executeRawCode(code: string): Promise<string> {
+  const randomId = v4();
+  const startTag = `<${randomId}>`;
+  const endTag = `</${randomId}>`;
+  const task = () =>
+    _runCode(
+      async (session) => {
+        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+        await (session as ITCSession).execute(
+          `Write-Host "${startTag}"\n${code}\nWrite-Host "${endTag}"\n`,
+        );
+      },
+      startTag,
+      endTag,
+    );
+
+  wait = wait ? wait.then(task) : task();
+  return wait;
+}
+
 export async function runCode(
   code: string,
   startTag: string = "",
   endTag: string = "",
 ): Promise<string> {
-  const task = () => _runCode(code, startTag, endTag);
+  const task = () =>
+    _runCode(
+      // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+      async (session) => await (session as ITCSession).run(code, true),
+      startTag,
+      endTag,
+    );
 
   wait = wait ? wait.then(task) : task();
   return wait;
 }
 
 async function _runCode(
-  code: string,
+  runCallback: (session: Session) => void,
   startTag: string = "",
   endTag: string = "",
 ): Promise<string> {
@@ -45,30 +75,20 @@ async function _runCode(
   const onExecutionLogFn = session.onExecutionLogFn;
   const outputLines = [];
 
-  const addLine = (logLines: LogLine[]) =>
+  const addLine = (logLines: LogLine[]) => {
     outputLines.push(...logLines.map(({ line }) => line));
+  };
 
   try {
     await session.setup(true);
 
     // Lets capture output to use it on
     session.onExecutionLogFn = addLine;
 
-    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    await (session as ITCSession).run(code, true);
+    await runCallback(session);
 
     const logOutput = outputLines.filter((line) => line.trim()).join("");
-
-    logText =
-      startTag && endTag
-        ? logOutput
-            .slice(
-              logOutput.lastIndexOf(startTag),
-              logOutput.lastIndexOf(endTag),
-            )
-            .replace(startTag, "")
-            .replace(endTag, "")
-        : logOutput;
+    logText = extractTextBetweenTags(logOutput, startTag, endTag);
   } finally {
     unsubscribe && unsubscribe();
     // Lets update our session to write to the log