final String region) {
        this.bucket = bucket;

        final AwsBasicCredentials credentials = AwsBasicCredentials.create(accessKey, secretKey);
        final S3ClientBuilder builder =
                S3Client.builder().credentialsProvider(StaticCredentialsProvider.create(credentials)).region(Region.of(getRegion(region)));

        // For non-AWS endpoints (MinIO, etc.), set custom endpoint with path-style access

    public static final String LABELS_label_type = "{labels.label_type}";

    /** The key of the message: Create */
    public static final String LABELS_file_crawling_button_create = "{labels.file_crawling_button_create}";

    /** The key of the message: Create New Job */
    public static final String LABELS_file_crawling_button_create_job = "{labels.file_crawling_button_create_job}";

    public void ensureBucketExists() {
        try {
            final Bucket existingBucket = storage.get(bucket);
            if (existingBucket == null) {
                storage.create(BucketInfo.newBuilder(bucket).build());
                logger.info("Created storage bucket: {}", bucket);
            }
        } catch (final Exception e) {
            logger.warn("Failed to ensure bucket exists: {}", bucket, e);
        }
    }

        return StringUtil.isEmpty(path) ? StringUtil.EMPTY : path + "/";
    }

    /**
     * Combines path and name to create a full object name.
     *
     * @param path the directory path
     * @param name the file or directory name
     * @return the full object name
     */
    public static String getObjectName(final String path, final String name) {
        return getPathPrefix(path) + name;
    }

    /**

                request.getSession().setAttribute(SAML_STATE, UuidUtil.create());
                return new ActionResponseCredential(() -> HtmlResponse.fromRedirectPathAsIs(loginUrl));
            } catch (final Exception e) {
                throw new SsoLoginException("Invalid SAML redirect URL.", e);
            }

        }).orElse(null);
    }

    /**
     * Creates a login credential.
     * @param request The HTTP request.

     *
     * @param request the HTTP servlet request
     * @return the authorization URL
     */
    protected String getAuthUrl(final HttpServletRequest request) {
        final String state = UuidUtil.create();
        request.getSession().setAttribute(OIC_STATE, state);
        return new AuthorizationCodeRequestUrl(getOicAuthServerUrl(), getOicClientId())//
                .setScopes(Arrays.asList(getOicScope()))//

    }

    /**
     * Creates a temporary file.
     *
     * @param prefix The prefix for the file name.
     * @param suffix The suffix for the file name.
     * @return The created temporary file.
     * @throws IORuntimeException if the file cannot be created.
     */
    public File createTempFile(final String prefix, final String suffix) {
        try {

     * @return The authorization URL to redirect the user to.
     */
    protected String getAuthUrl(final HttpServletRequest request) {
        final String state = UuidUtil.create();
        final String nonce = UuidUtil.create();
        storeStateInSession(request.getSession(), state, nonce);
        final String authUrl;

        if (useV2Endpoint) {
            // v2.0 endpoint with MSAL4J (recommended)

            return StorageType.S3;
        }

        // Default to S3-compatible (MinIO, etc.)
        return StorageType.S3_COMPAT;
    }

    /**
     * Creates a StorageClient based on FessConfig.
     *
     * @param fessConfig the Fess configuration
     * @return configured StorageClient
     */
    public static StorageClient createClient(final FessConfig fessConfig) {

    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 path the path of the item
     * @param directory true if this item is a directory
     * @param size the size of the item in bytes