/**
 * Represents a storage item (file or directory).
 */
public class StorageItem {

    private final String name;
    private final String path;
    private final boolean directory;
    private final long size;
    private final ZonedDateTime lastModified;
    private final String encodedId;

    /**
     * Creates a new StorageItem instance.
     *
     * @param name the name of the item

        final StorageItem item = new StorageItem("", "/path/", false, 100L, null, "");

        assertEquals("", item.getName());
        assertEquals("/path/", item.getPath());
        assertEquals("", item.getEncodedId());
    }

    public void test_largeFileSize() {
        final long largeSize = 10737418240L; // 10 GB

     *
     * @param prefix the path prefix to list objects under (null or empty for root)
     * @param maxItems maximum number of items to return
     * @return list of storage items
     */
    List<StorageItem> listObjects(String prefix, int maxItems);

    /**
     * Gets tags/metadata for an object.
     *
     * @param objectName the name/path of the object
     * @return map of tag key-value pairs
     */