com.github.twitch4j.chat.util.TwitchChatLimitHelper Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of twitch4j-chat Show documentation
Chat dependency
The newest version!
package com.github.twitch4j.chat.util;

import com.github.twitch4j.common.enums.TwitchLimitType;
import com.github.twitch4j.common.util.BucketUtils;
import io.github.bucket4j.Bandwidth;
import io.github.bucket4j.Bucket;
import lombok.experimental.UtilityClass;
import org.jetbrains.annotations.ApiStatus;

import java.time.Duration;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;

/**
 * Utility class for retrieving standard rate limits for {@link com.github.twitch4j.chat.TwitchChat}
 *
 * @see Official documentation
 */
@UtilityClass
public class TwitchChatLimitHelper {

    public final String MESSAGE_BANDWIDTH_ID = TwitchLimitType.CHAT_MESSAGE_LIMIT.getBandwidthId();
    public final String JOIN_BANDWIDTH_ID = TwitchLimitType.CHAT_JOIN_LIMIT.getBandwidthId();
    public final String AUTH_BANDWIDTH_ID = TwitchLimitType.CHAT_AUTH_LIMIT.getBandwidthId();
    public final String WHISPER_MINUTE_BANDWIDTH_ID = TwitchLimitType.CHAT_WHISPER_LIMIT.getBandwidthId() + "-minute";
    public final String WHISPER_SECOND_BANDWIDTH_ID = TwitchLimitType.CHAT_WHISPER_LIMIT.getBandwidthId() + "-second";

    /**
     * Users sending commands or messages to channels in which they do not have Moderator or Operator status
     */
    public final Bandwidth USER_MESSAGE_LIMIT = BucketUtils.simple(20, Duration.ofSeconds(30), MESSAGE_BANDWIDTH_ID);

    /**
     * Users sending commands or messages to channels in which they have Moderator or Operator status
     */
    public final Bandwidth MOD_MESSAGE_LIMIT = BucketUtils.simple(100, Duration.ofSeconds(30), MESSAGE_BANDWIDTH_ID);

    /**
     * Known bots
     */
    public final Bandwidth KNOWN_MESSAGE_LIMIT = BucketUtils.simple(50, Duration.ofSeconds(30), MESSAGE_BANDWIDTH_ID);

    /**
     * Verified bots
     */
    public final Bandwidth VERIFIED_MESSAGE_LIMIT = BucketUtils.simple(7500, Duration.ofSeconds(30), MESSAGE_BANDWIDTH_ID);

    /**
     * Users (not bots)
     * 
     * Note: this does not implement the target user count restriction.
     */
    public final List USER_WHISPER_LIMIT = Collections.unmodifiableList(
        Arrays.asList(
            BucketUtils.simple(100, Duration.ofSeconds(60), WHISPER_MINUTE_BANDWIDTH_ID),
            BucketUtils.simple(3, Duration.ofSeconds(1), WHISPER_SECOND_BANDWIDTH_ID)
        )
    );

    /**
     * Known bots
     * 

     * Note: this does not implement the target user count restriction.
     */
    public final List KNOWN_WHISPER_LIMIT = Collections.unmodifiableList(
        Arrays.asList(
            BucketUtils.simple(200, Duration.ofSeconds(60), WHISPER_MINUTE_BANDWIDTH_ID),
            BucketUtils.simple(10, Duration.ofSeconds(1), WHISPER_SECOND_BANDWIDTH_ID)
        )
    );

    /**
     * Verified bots
     * 

     * Note: this does not implement the target user count restriction.
     * 
     * Note: this only applies to legacy verified bots (pre July 2021)
     */
    public final List VERIFIED_WHISPER_LIMIT = Collections.unmodifiableList(
        Arrays.asList(
            BucketUtils.simple(1200, Duration.ofSeconds(60), WHISPER_MINUTE_BANDWIDTH_ID),
            BucketUtils.simple(20, Duration.ofSeconds(1), WHISPER_SECOND_BANDWIDTH_ID)
        )
    );

    /**
     * Join rate for users
     */
    public final Bandwidth USER_JOIN_LIMIT = BucketUtils.simple(20, Duration.ofSeconds(10), JOIN_BANDWIDTH_ID);

    /**
     * Join rate for verified bots
     */
    public final Bandwidth VERIFIED_JOIN_LIMIT = BucketUtils.simple(2000, Duration.ofSeconds(10), JOIN_BANDWIDTH_ID);

    /**
     * Authentication rate for users
     */
    public final Bandwidth USER_AUTH_LIMIT = BucketUtils.simple(20, Duration.ofSeconds(10), AUTH_BANDWIDTH_ID);

    /**
     * Authentication rate for verified bots
     */
    public final Bandwidth VERIFIED_AUTH_LIMIT = BucketUtils.simple(200, Duration.ofSeconds(10), AUTH_BANDWIDTH_ID);

    /**
     * @param limit bandwidth
     * @return bucket
     * @deprecated in favor of BucketUtils
     */
    @Deprecated
    @ApiStatus.ScheduledForRemoval(inVersion = "2.0.0")
    public Bucket createBucket(Bandwidth limit) {
        return BucketUtils.createBucket(limit);
    }

    /**
     * @param limits bandwidths
     * @return bucket
     * @deprecated in favor of BucketUtils
     */
    @Deprecated
    @ApiStatus.ScheduledForRemoval(inVersion = "2.0.0")
    public Bucket createBucket(Bandwidth... limits) {
        return BucketUtils.createBucket(limits);
    }

    /**
     * @param limits bandwidths
     * @return bucket
     * @deprecated in favor of BucketUtils
     */
    @Deprecated
    @ApiStatus.ScheduledForRemoval(inVersion = "2.0.0")
    public Bucket createBucket(Iterable limits) {
        return BucketUtils.createBucket(limits);
    }

}