File System Operations

// Basic file operations
// Create a workspace
const workspace = await daytona.create();

// Create a directory
await workspace.fs.createFolder('/workspace/data', '755');

// Upload a file
const fileContent = new File(['content'], 'local_file.txt');
await workspace.fs.uploadFile('/workspace/data/file.txt', fileContent);

// List directory contents
const files = await workspace.fs.listFiles('/workspace');
files.forEach(file => {
  console.log(`Name: ${file.name}`);
  console.log(`Is directory: ${file.isDir}`);
  console.log(`Size: ${file.size}`);
  console.log(`Modified: ${file.modTime}`);
});

// Search file contents
const matches = await workspace.fs.findFiles(
  '/workspace/src',
  'text-of-interest'
);
matches.forEach(match => {
  console.log(`Absolute file path: ${match.file}`);
  console.log(`Line number: ${match.line}`);
  console.log(`Line content: ${match.content}\n`);
});

// File manipulation
// Move files
await workspace.fs.moveFiles(
  '/workspace/data/old.txt',
  '/workspace/data/new.txt'
);

// Replace text in files
const results = await workspace.fs.replaceInFiles(
  ['/workspace/data/new.txt'],
  'old_version',
  'new_version'
);

// Set permissions
await workspace.fs.setFilePermissions(
  '/workspace/data/script.sh',
  {
    mode: '755',
    owner: 'daytona'
  }
);

new FileSystem(instance: Workspace, toolboxApi: ToolboxApi): FileSystem

createFolder(path: string, mode: string): Promise<void>

// Create a directory with standard permissions
await fs.createFolder('/app/data', '755');

deleteFile(path: string): Promise<void>

// Delete a file
await fs.deleteFile('/app/temp.log');

downloadFile(path: string): Promise<Blob>

// Download and process a file
const fileBlob = await fs.downloadFile('/app/data.json');
console.log('File content:', fileBlob.toString());

findFiles(path: string, pattern: string): Promise<Match[]>

// Find all TODO comments in TypeScript files
const matches = await fs.findFiles('/app/src', 'TODO:');
matches.forEach(match => {
  console.log(`${match.file}:${match.line}: ${match.content}`);
});

getFileDetails(path: string): Promise<FileInfo>

// Get file details
const info = await fs.getFileDetails('/app/config.json');
console.log(`Size: ${info.size}, Modified: ${info.modTime}`);

listFiles(path: string): Promise<FileInfo[]>

// List directory contents
const files = await fs.listFiles('/app/src');
files.forEach(file => {
  console.log(`${file.name} (${file.size} bytes)`);
});

moveFiles(source: string, destination: string): Promise<void>

// Move a file to a new location
await fs.moveFiles('/app/temp/data.json', '/app/data/data.json');

replaceInFiles(
   files: string[],
   pattern: string,
newValue: string): Promise<ReplaceResult[]>

// Update version number across multiple files
const results = await fs.replaceInFiles(
  ['/app/package.json', '/app/version.ts'],
  '"version": "1.0.0"',
  '"version": "1.1.0"'
);

searchFiles(path: string, pattern: string): Promise<SearchFilesResponse>

// Find all TypeScript files
const result = await fs.searchFiles('/app', '*.ts');
result.files.forEach(file => console.log(file));

setFilePermissions(path: string, permissions: FilePermissionsParams): Promise<void>

// Set file permissions and ownership
await fs.setFilePermissions('/app/script.sh', {
  owner: 'daytona',
  group: 'users',
  mode: '755'  // Execute permission for shell script
});

uploadFile(path: string, file: File): Promise<void>

// Upload a configuration file
const configFile = new File(['{"setting": "value"}'], 'config.json');
await fs.uploadFile('/app/config.json', configFile);

const permissions: FilePermissionsParams = {
  mode: '644',
  owner: 'daytona',
  group: 'users'
};