listFiles()

// List files from default branch
const files = await repo.listFiles();
console.log(files.paths); // Array of file paths

// List files from specific branch or commit
const branchFiles = await repo.listFiles({
  ref: 'feature-branch', // branch name or commit SHA
});
console.log(`Files in ${branchFiles.ref}:`, branchFiles.paths);

// List files from the ephemeral namespace
const ephemeralFiles = await repo.listFiles({
  ref: 'feature/demo-work',
  ephemeral: true,
});
console.log(`Ephemeral files:`, ephemeralFiles.paths);

const page = await repo.listFiles({
  path: 'docs',
  recursive: false,
  limit: 100,
});
console.log(page.entries, page.nextCursor);

# List files from the default branch
files = await repo.list_files(ref="main")
print(files["paths"])  # List of file paths

# List files from a specific branch or commit
branch_files = await repo.list_files(ref="feature-branch")
print(branch_files["paths"])

# List files from the ephemeral namespace
ephemeral_files = await repo.list_files(
    ref="feature/demo-work",
    ephemeral=True,
)
print(ephemeral_files["paths"])

page = await repo.list_files(
    path="docs",
    recursive=False,
    limit=100,
)
print(page["entries"], page.get("next_cursor"))

// List files from the default branch
files, err := repo.ListFiles(context.Background(), storage.ListFilesOptions{
	Ref: "main",
})
fmt.Println(files.Paths)

ephemeral := true
// List files from the ephemeral namespace
ephemeralFiles, err := repo.ListFiles(context.Background(), storage.ListFilesOptions{
	Ref:       "feature/demo-work",
	Ephemeral: &ephemeral,
})
fmt.Println(ephemeralFiles.Paths)

recursive := false
page, err := repo.ListFiles(context.Background(), storage.ListFilesOptions{
	Path:      "docs",
	Recursive: &recursive,
	Limit:     100,
})
fmt.Println(page.Entries, page.NextCursor)