listFilesWithMetadata()

// List files with metadata from the default branch
const metadata = await repo.listFilesWithMetadata();
console.log(metadata.files[0].lastCommitSha);
console.log(metadata.commits[metadata.files[0].lastCommitSha].author);

// List files with metadata from a specific branch or commit
const branchMetadata = await repo.listFilesWithMetadata({
  ref: 'feature-branch', // branch name or commit SHA
});
console.log(`Files in ${branchMetadata.ref}:`, branchMetadata.files.length);

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

const page = await repo.listFilesWithMetadata({
  path: 'src',
  limit: 100,
});
console.log(page.files[0].type, page.nextCursor);

# List files with metadata from the default branch
metadata = await repo.list_files_with_metadata()
print(metadata["files"][0]["last_commit_sha"])
print(metadata["commits"][metadata["files"][0]["last_commit_sha"]]["author"])

# List files with metadata from a specific branch or commit
branch_metadata = await repo.list_files_with_metadata(ref="feature-branch")
print(f"Files in {branch_metadata['ref']}:", len(branch_metadata["files"]))

# List files from the ephemeral namespace
ephemeral_metadata = await repo.list_files_with_metadata(
    ref="feature/demo-work",
    ephemeral=True,
)
print("Ephemeral files:", len(ephemeral_metadata["files"]))

page = await repo.list_files_with_metadata(
    path="src",
    limit=100,
)
print(page["files"][0].get("type"), page.get("next_cursor"))

// List files with metadata from the default branch
metadata, err := repo.ListFilesWithMetadata(context.Background(), storage.ListFilesWithMetadataOptions{
	Ref: "main",
})
fmt.Println(metadata.Files[0].LastCommitSHA)
fmt.Println(metadata.Commits[metadata.Files[0].LastCommitSHA].Author)

ephemeral := true
// List files from the ephemeral namespace
ephemeralMetadata, err := repo.ListFilesWithMetadata(context.Background(), storage.ListFilesWithMetadataOptions{
	Ref:       "feature/demo-work",
	Ephemeral: &ephemeral,
})
fmt.Println("Ephemeral files:", len(ephemeralMetadata.Files))

page, err := repo.ListFilesWithMetadata(context.Background(), storage.ListFilesWithMetadataOptions{
	Path:  "src",
	Limit: 100,
})
fmt.Println(page.Files[0].Type, page.NextCursor)