import java.time.ZonedDateTime;

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

/**
 * Google Cloud Storage client implementation.
 */
public class GcsStorageClient implements StorageClient {

    private static final Logger logger = LogManager.getLogger(GcsStorageClient.class);

    private final Storage storage;
    private final String bucket;

    /**
     * Creates a new GcsStorageClient instance.
     *
     * @param projectId the GCS project ID

 * Supports Amazon S3, MinIO, and other S3-compatible storage systems.
 */
public class S3StorageClient implements StorageClient {

    private static final Logger logger = LogManager.getLogger(S3StorageClient.class);

    private final S3Client s3Client;
    private final String bucket;

    /**
     * Creates a new S3StorageClient instance.
     *
     * @param endpoint the S3 endpoint URL (null for AWS default)

/**
 * Factory for creating appropriate StorageClient based on configuration.
 */
public final class StorageClientFactory {

    private static final Logger logger = LogManager.getLogger(StorageClientFactory.class);

    private StorageClientFactory() {
        // Utility class
    }

    /**
     * Auto-detect storage type from endpoint URL.
     *

    public AdminGeneralAction() {
        super();
    }

    /** The role name for general settings administration. */
    public static final String ROLE = "admin-general";

    private static final String DUMMY_PASSWORD = "**********";

    private static final Logger logger = LogManager.getLogger(AdminGeneralAction.class);

    // ===================================================================================

        });
    }

    /**
     * Container class for path information containing separate path and name components.
     */
    public static class PathInfo {
        private final String path;
        private final String name;

        /**
         * Creates a new PathInfo instance.
         *
         * @param path the directory path component

     */
    public OpenIdConnectAuthenticator() {
        // Default constructor
    }

    private static final Logger logger = LogManager.getLogger(OpenIdConnectAuthenticator.class);

    private static final BaseEncoding BASE64_DECODER = BaseEncoding.base64().withSeparator("\n", 64);

    private static final BaseEncoding BASE64URL_DECODER = BaseEncoding.base64Url().withSeparator("\n", 64);

 * from its source file.
 */
public class StemmerOverrideFile extends DictionaryFile<StemmerOverrideItem> {
    private static final Logger logger = LogManager.getLogger(StemmerOverrideFile.class);

    private static final String STEMMER_OVERRIDE = "stemmeroverride";

    /** The list of stemmer override items loaded from the dictionary file. */

 */
public class CharMappingFile extends DictionaryFile<CharMappingItem> {
    /** Logger instance for this class. */
    private static final Logger logger = LogManager.getLogger(CharMappingFile.class);

    /** Type identifier for character mapping dictionaries. */
    private static final String MAPPING = "mapping";

    /** List of character mapping items loaded from the mapping file. */

    /** The product version string. */
    protected String productVersion;

    /** The end-of-life timestamp for the application. */
    protected long eolTime;

    private short systemCpuPercent;

    private long systemCpuCheckTime;

    private long systemCpuCheckInterval = 1000L;

    /** A map of listeners for configuration updates. */
    protected Map<String, Supplier<String>> updateConfigListenerMap = new HashMap<>();