/**
 * 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

     *
     * @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
     */