@mkody/twitch-emoticons 2.9.6 → 3.0.0-beta.2

package/dist/TwitchEmoticons.cjs

@@ -0,0 +1,950 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.js
+var index_exports = {};
+__export(index_exports, {
+  BTTVEmote: () => BTTVEmote_default,
+  Channel: () => Channel_default,
+  Collection: () => Collection_default,
+  Constants: () => Constants_default,
+  Emote: () => Emote_default,
+  EmoteFetcher: () => EmoteFetcher_default,
+  EmoteParser: () => EmoteParser_default,
+  FFZEmote: () => FFZEmote_default,
+  SevenTVEmote: () => SevenTVEmote_default,
+  TwitchEmote: () => TwitchEmote_default,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/struct/Emote.js
+var Emote = class _Emote {
+  /**
+   * Base class for emotes.
+   * This constructor is not to be used.
+   * @param {Channel} channel - Channel this emote belongs to.
+   * @param {string} id - ID of the emote.
+   * @param {data} data - The raw emote data.
+   * @throws {Error} When trying to use the base Emote class directly.
+   */
+  constructor(channel, id, data) {
+    if (new.target.name === _Emote.name) {
+      throw new Error("Base Emote class cannot be used");
+    }
+    this.fetcher = channel.fetcher;
+    this.channel = channel;
+    this.id = id;
+    this.type = null;
+    this._setup(data);
+  }
+  _setup(data) {
+    this.code = data.code;
+  }
+  /**
+   * Gets the image link of the emote.
+   * @param {number} size - The size of the image.
+   * @returns {string} - The URL to the emote.
+   */
+  /* c8 ignore next 3 */
+  toLink() {
+    return null;
+  }
+  /**
+   * Override for `toString`.
+   * Will give the emote's name.
+   * @returns {string} - The emote code.
+   */
+  /* c8 ignore next 3 */
+  toString() {
+    return this.code;
+  }
+  /**
+   * Override for `toObject`.
+   * Will result in an Object representation of an Emote
+   * @returns {object} - Object representation of the Emote.
+   */
+  toObject() {
+    return {
+      code: this.code,
+      id: this.id,
+      channel_id: this.channel.channel_id
+    };
+  }
+};
+var Emote_default = Emote;
+
+// src/util/Constants.js
+var Constants_default = {
+  Twitch: {
+    CDN: (id, size = 0, forceStatic = false, theme = "dark") => `https://static-cdn.jtvnw.net/emoticons/v2/${id}/${forceStatic ? "static" : "default"}/${theme}/${size + 1}.0`
+  },
+  BTTV: {
+    Global: "https://api.betterttv.net/3/cached/emotes/global",
+    Channel: (id) => `https://api.betterttv.net/3/cached/users/twitch/${id}`,
+    CDN: (id, size = 0, forceStatic = false) => `https://cdn.betterttv.net/emote/${id}/${size + 1}x.${forceStatic ? "png" : "webp"}`
+  },
+  SevenTV: {
+    Global: "https://7tv.io/v3/emote-sets/global",
+    Channel: (id) => `https://7tv.io/v3/users/twitch/${id}`,
+    CDN: (id, format, size = 1, forceStatic = false) => `https://cdn.7tv.app/emote/${id}/${size}x${forceStatic ? "_static" : ""}.${format}`
+  },
+  FFZ: {
+    sets: {
+      Global: 3,
+      Modifiers: 1532818
+    },
+    Set: (id) => `https://api.frankerfacez.com/v1/set/${id}`,
+    Channel: (id) => `https://api.frankerfacez.com/v1/room/id/${id}`,
+    CDN: (id, size = 1) => `https://cdn.frankerfacez.com/emote/${id}/${size}`,
+    CDNAnimated: (id, size = 1) => `https://cdn.frankerfacez.com/emote/${id}/animated/${size}.webp`
+  },
+  Templates: {
+    html: '<img alt="{name}" title="{name}" class="twitch-emote" src="{link}">',
+    markdown: '![{name}]({link} "{name}")',
+    bbcode: "[img]{link}[/img]",
+    plain: "{link}"
+  }
+};
+
+// src/struct/BTTVEmote.js
+var BTTVEmote = class _BTTVEmote extends Emote_default {
+  /**
+   * A BTTV emote.
+   * @param {Channel} channel - Channel this emote belongs to.
+   * @param {string} id - ID of the emote.
+   * @param {data} data - The raw emote data.
+   */
+  constructor(channel, id, data) {
+    super(channel, id, data);
+    this.type = "bttv";
+  }
+  _setup(data) {
+    super._setup(data);
+    this.ownerName = "user" in data ? data.user.name : null;
+    this.animated = data.animated;
+    this.imageType = "webp";
+  }
+  /**
+   * Gets the image link of the emote.
+   * @param {object} [options] - Options for the link.
+   * @param {number} [options.size=0] - Size (scale) for the emote.
+   * @param {boolean} [options.forceStatic] - Whether to force the emote to be static (non-animated). Defaults to the fetcher's forceStatic or `false`.
+   * @returns {string} - The URL to the emote.
+   */
+  toLink(options) {
+    const {
+      size = 0,
+      forceStatic = this.fetcher.forceStatic || false
+    } = options || {};
+    return Constants_default.BTTV.CDN(this.id, size, forceStatic);
+  }
+  /**
+   * Override for `toObject`.
+   * Will result in an Object representation of a BTTVEmote
+   * @returns {object} - Object representation of the BTTVEmote.
+   */
+  toObject() {
+    return {
+      ...super.toObject(),
+      animated: this.animated,
+      ownerName: this.ownerName,
+      type: this.type
+    };
+  }
+  /**
+   * Converts an emote Object into a BTTVEmote
+   * @param {object} [emoteObject] - Object representation of this emote
+   * @param {Channel} [channel] - Channel this emote belongs to.
+   * @returns {BTTVEmote} - A BTTVEmote instance.
+   */
+  static fromObject(emoteObject, channel) {
+    return new _BTTVEmote(
+      channel,
+      emoteObject.id,
+      {
+        code: emoteObject.code,
+        animated: emoteObject.animated,
+        user: {
+          name: emoteObject.ownerName
+        }
+      }
+    );
+  }
+};
+var BTTVEmote_default = BTTVEmote;
+
+// src/util/Collection.js
+var Collection = class extends Map {
+  /**
+   * Finds first matching value by property or function.
+   * Same as `Array#find`.
+   * @param {string|Function} propOrFunc - Property or function to test.
+   * @param {any} [value] - Value to find.
+   * @returns {any|null} - The found item or null if none found.
+   */
+  find(propOrFunc, value) {
+    if (typeof propOrFunc === "string") {
+      if (value === void 0) {
+        return null;
+      }
+      for (const item of this.values()) {
+        if (item[propOrFunc] === value) {
+          return item;
+        }
+      }
+      return null;
+    }
+    if (typeof propOrFunc === "function") {
+      let i = 0;
+      for (const item of this.values()) {
+        if (propOrFunc(item, i, this)) {
+          return item;
+        }
+        i++;
+      }
+      return null;
+    }
+    return null;
+  }
+  /**
+   * Filters cache by function.
+   * Same as `Array#filter`.
+   * @param {Function} func - Function to test.
+   * @param {any} [thisArg] - The context for the function.
+   * @returns {Collection} - A new collection with the filtered items.
+   */
+  filter(func, thisArg) {
+    if (thisArg) {
+      func = func.bind(thisArg);
+    }
+    const results = new this.constructor();
+    let i = 0;
+    for (const [key, item] of this) {
+      if (func(item, i, this)) {
+        results.set(key, item);
+      }
+      i++;
+    }
+    return results;
+  }
+  /**
+   * Maps cache by function.
+   * Same as `Array#map`.
+   * @param {Function} func - Function to use.
+   * @param {any} [thisArg] - The context for the function.
+   * @returns {any[]} - An array with the mapped items.
+   */
+  map(func, thisArg) {
+    if (thisArg) {
+      func = func.bind(thisArg);
+    }
+    const array = new Array(this.size);
+    let i = 0;
+    for (const item of this.values()) {
+      array[i] = func(item, i, this);
+      i++;
+    }
+    return array;
+  }
+};
+var Collection_default = Collection;
+
+// src/struct/Channel.js
+var Channel = class {
+  /**
+   * A Twitch channel.
+   * @param {EmoteFetcher} fetcher - The emote fetcher.
+   * @param {number} id - ID of the channel.
+   */
+  constructor(fetcher, id) {
+    this.fetcher = fetcher;
+    this.channel_id = id || null;
+    this.emotes = new Collection_default();
+  }
+  /* There are tests that those are returning Collections, but c8 doesn't get it. */
+  /* c8 ignore start */
+  /**
+   * Fetches the BTTV emotes for this channel.
+   * @returns {Promise<Collection<string, BTTVEmote>>} - A promise that resolves to a collection of BTTVEmotes.
+   */
+  fetchBTTVEmotes() {
+    return this.fetcher.fetchBTTVEmotes(this.id);
+  }
+  /**
+   * Fetches the FFZ emotes for this channel.
+   * @returns {Promise<Collection<string, FFZEmote>>} - A promise that resolves to a collection of FFZEmotes.
+   */
+  fetchFFZEmotes() {
+    return this.fetcher.fetchFFZEmotes(this.id);
+  }
+  /**
+   * Fetches the 7TV emotes for this channel.
+   * @returns {Promise<Collection<string, SevenTVEmote>>} - A promise that resolves to a collection of SevenTVEmotes.
+   */
+  fetchSevenTVEmotes() {
+    return this.fetcher.fetchSevenTVEmotes(this.id);
+  }
+  /* c8 ignore end */
+};
+var Channel_default = Channel;
+
+// src/struct/FFZEmote.js
+var FFZEmote = class _FFZEmote extends Emote_default {
+  /**
+   * An FFZ emote.
+   * @param {Channel} channel - Channel this emote belongs to.
+   * @param {string} id - ID of the emote.
+   * @param {data} data - The raw emote data.
+   */
+  constructor(channel, id, data) {
+    super(channel, id, data);
+    this.type = "ffz";
+  }
+  _setup(data) {
+    super._setup(data);
+    this.code = data.name;
+    this.ownerName = "owner" in data ? data.owner.name : null;
+    this.sizes = "animated" in data ? Object.keys(data.animated) : Object.keys(data.urls);
+    this.animated = "animated" in data;
+    this.imageType = "animated" in data ? "webp" : "png";
+    this.modifier = data.modifier && (data.modifier_flags & 1) !== 0;
+  }
+  /**
+   * Gets the image link of the emote.
+   * @param {object} [options] - Options for the link.
+   * @param {number} [options.size=0] - Size (scale) for the emote.
+   * @param {boolean} [options.forceStatic] - Whether to force the emote to be static (non-animated). Defaults to the fetcher's forceStatic or `false`.
+   * @returns {string} - The URL to the emote.
+   */
+  toLink(options) {
+    const {
+      size = 0,
+      forceStatic = this.fetcher.forceStatic || false
+    } = options || {};
+    const sizeKey = this.sizes[size];
+    if (this.animated && !forceStatic) return Constants_default.FFZ.CDNAnimated(this.id, sizeKey);
+    return Constants_default.FFZ.CDN(this.id, sizeKey);
+  }
+  /**
+   * Override for `toObject`.
+   * Will result in an Object representation of a FFZEmote
+   * @returns {object} - Object representation of the FFZEmote.
+   */
+  toObject() {
+    return {
+      ...super.toObject(),
+      animated: this.animated,
+      sizes: this.sizes,
+      ownerName: this.ownerName,
+      type: this.type,
+      modifier: this.modifier
+    };
+  }
+  /**
+   * Converts an emote Object into a FFZEmote
+   * @param {object} [emoteObject] - Object representation of this emote
+   * @param {Channel} [channel] - Channel this emote belongs to.
+   * @returns {FFZEmote} - A FFZEmote instance.
+   */
+  static fromObject(emoteObject, channel) {
+    const sizesObj = emoteObject.sizes.reduce((acc, curr) => {
+      acc[curr] = curr;
+      return acc;
+    }, {});
+    return new _FFZEmote(
+      channel,
+      emoteObject.id,
+      {
+        code: emoteObject.code,
+        name: emoteObject.code,
+        urls: sizesObj,
+        ...emoteObject.animated ? { animated: sizesObj } : {},
+        owner: { name: emoteObject.ownerName },
+        modifier: emoteObject.modifier,
+        modifier_flags: emoteObject.modifier
+      }
+    );
+  }
+};
+var FFZEmote_default = FFZEmote;
+
+// src/struct/SevenTVEmote.js
+var SevenTVEmote = class _SevenTVEmote extends Emote_default {
+  /**
+   * A 7TV emote.
+   * @param {Channel} channel - Channel this emote belongs to.
+   * @param {string} id - ID of the emote.
+   * @param {data} data - The raw emote data.
+   */
+  constructor(channel, id, data) {
+    super(channel, id, data);
+    this.type = "7tv";
+  }
+  _setup(data) {
+    super._setup(data);
+    this.code = data.name;
+    this.ownerName = "owner" in data.data ? data.data.owner.display_name : null;
+    this.sizes = data.data.host.files.filter((el) => el.format === this.channel.format.toUpperCase()).map((el) => el.name.replace(/x\.(\w+)/, ""));
+    this.animated = data.data.animated;
+    this.imageType = this.channel.format;
+  }
+  /**
+   * Gets the image link of the emote.
+   * @param {object} [options] - Options for the link.
+   * @param {number} [options.size=0] - Size (scale) for the emote.
+   * @param {boolean} [options.forceStatic] - Whether to force the emote to be static (non-animated). Defaults to the fetcher's forceStatic or `false`.
+   * @returns {string} - The URL to the emote.
+   */
+  toLink(options) {
+    const {
+      size = 0,
+      forceStatic = this.fetcher.forceStatic || false
+    } = options || {};
+    const sizeKey = this.sizes[size];
+    return Constants_default.SevenTV.CDN(this.id, this.imageType, sizeKey, forceStatic);
+  }
+  /**
+   * Override for `toObject`.
+   * Will result in an Object representation of a SevenTVEmote
+   * @returns {object} - Object representation of the SevenTVEmote.
+   */
+  toObject() {
+    return {
+      ...super.toObject(),
+      animated: this.animated,
+      sizes: this.sizes,
+      ownerName: this.ownerName,
+      type: this.type,
+      imageType: this.imageType
+    };
+  }
+  /**
+   * Converts an emote Object into a SevenTVEmote
+   * @param {object} [emoteObject] - Object representation of this emote
+   * @param {Channel} [channel] - Channel this emote belongs to.
+   * @returns {SevenTVEmote} - A SevenTVEmote instance.
+   */
+  static fromObject(emoteObject, channel) {
+    const sizes = emoteObject.sizes.map((size) => {
+      return { format: channel.format.toUpperCase(), name: size };
+    });
+    return new _SevenTVEmote(
+      channel,
+      emoteObject.id,
+      {
+        code: emoteObject.code,
+        name: emoteObject.code,
+        data: {
+          animated: emoteObject.animated,
+          owner: {
+            display_name: emoteObject.ownerName
+          },
+          host: {
+            files: sizes
+          }
+        }
+      }
+    );
+  }
+};
+var SevenTVEmote_default = SevenTVEmote;
+
+// src/struct/TwitchEmote.js
+var TwitchEmote = class _TwitchEmote extends Emote_default {
+  /**
+   * A Twitch emote.
+   * @param {Channel} channel - Channel this emote belongs to.
+   * @param {string} id - ID of the emote.
+   * @param {data} data - The raw emote data.
+   */
+  constructor(channel, id, data) {
+    super(channel, id, data);
+    this.type = "twitch";
+  }
+  _setup(data) {
+    super._setup(data);
+    this.set = data.emoticon_set;
+    this.animated = "animated" in data.formats;
+    this.imageType = "animated" in data.formats ? "gif" : "png";
+  }
+  /**
+   * Gets the image link of the emote.
+   * @param {object} [options] - Options for the link.
+   * @param {number} [options.size=0] - Size (scale) for the emote.
+   * @param {boolean} [options.forceStatic] - Whether to force the emote to be static (non-animated). Defaults to the fetcher's forceStatic or `false`.
+   * @param {'dark' | 'light'} [options.themeMode] - Only for Twitch: the preferred theme mode. Defaults to the fetcher's twitchThemeMode or `dark`.
+   * @returns {string} - The URL to the emote.
+   */
+  toLink(options) {
+    const {
+      size = 0,
+      forceStatic = this.fetcher.forceStatic || false,
+      themeMode = this.fetcher.twitchThemeMode || "dark"
+    } = options || {};
+    return Constants_default.Twitch.CDN(this.id, size, forceStatic, themeMode);
+  }
+  /**
+   * Override for `toObject`.
+   * Will result in an Object representation of a TwitchEmote
+   * @returns {object} - Object representation of the TwitchEmote.
+   */
+  toObject() {
+    return {
+      ...super.toObject(),
+      animated: this.animated,
+      set: this.set,
+      type: this.type
+    };
+  }
+  /**
+   * Converts an emote Object into a TwitchEmote
+   * @param {object} [emoteObject] - Object representation of this emote
+   * @param {Channel} [channel] - Channel this emote belongs to.
+   * @returns {TwitchEmote} - A TwitchEmote instance.
+   */
+  static fromObject(emoteObject, channel) {
+    return new _TwitchEmote(
+      channel,
+      emoteObject.id,
+      {
+        code: emoteObject.code,
+        animated: emoteObject.animated,
+        emoticon_set: emoteObject.set,
+        formats: emoteObject.animated ? { animated: emoteObject.animated } : {}
+      }
+    );
+  }
+};
+var TwitchEmote_default = TwitchEmote;
+
+// src/struct/EmoteFetcher.js
+var import_api = require("@twurple/api");
+var import_auth = require("@twurple/auth");
+var EmoteFetcher = class {
+  /**
+   * Fetches and caches emotes.
+   * @param {object} [options={}] Fetcher's options.
+   * @param {string} [options.twitchAppID] Your app ID for the Twitch API.
+   * @param {string} [options.twitchAppSecret] Your app secret for the Twitch API.
+   * @param {ApiClient} [options.apiClient] - Bring your own Twurple ApiClient.
+   * @param {boolean} [options.forceStatic=false] - Force emotes to be static (non-animated).
+   * @param {'dark' | 'light'} [options.twitchThemeMode='dark'] - Theme mode (background color) preference for Twitch emotes.
+   */
+  constructor(options = {}) {
+    if (options.apiClient) {
+      this.apiClient = options.apiClient;
+    } else if (options.twitchAppID && options.twitchAppSecret) {
+      const authProvider = new import_auth.AppTokenAuthProvider(options.twitchAppID, options.twitchAppSecret);
+      this.apiClient = new import_api.ApiClient({ authProvider });
+    }
+    this.forceStatic = options.forceStatic || false;
+    this.twitchThemeMode = options.twitchThemeMode || "dark";
+    this.emotes = new Collection_default();
+    this.channels = new Collection_default();
+    this.ffzModifiersFetched = false;
+  }
+  /**
+   * The global channel for Twitch, BTTV and 7TV.
+   * @readonly
+   * @type {?Channel}
+   */
+  get globalChannel() {
+    return this.channels.get(null);
+  }
+  /**
+   * Sets up a channel
+   * @private
+   * @param {number} channelId - ID of the channel.
+   * @param {string} [format] - The type file format to use (webp/avif).
+   * @throws {Error} When Twitch Client ID or Client Secret were not provided.
+   * @returns {Channel} - A Channel instance.
+   */
+  _setupChannel(channelId, format) {
+    let channel = this.channels.get(channelId);
+    if (!channel) {
+      channel = new Channel_default(this, channelId);
+      this.channels.set(channelId, channel);
+    }
+    if (format) channel.format = format.toLowerCase();
+    return channel;
+  }
+  /**
+   * Gets the raw Twitch emotes data for a channel.
+   * @private
+   * @param {number} id - ID of the channel.
+   * @returns {Promise<object[]>} - A promise that resolves to an array of raw Twitch emote data.
+   */
+  _getRawTwitchEmotes(id) {
+    if (!this.apiClient) {
+      throw new Error("Client id or client secret not provided.");
+    }
+    if (id) {
+      return this.apiClient.chat.getChannelEmotes(id);
+    } else {
+      return this.apiClient.chat.getGlobalEmotes();
+    }
+  }
+  /**
+   * Converts and caches a raw twitch emote.
+   * @private
+   * @param {number} channelId - ID of the channel.
+   * @param {object} data - Raw data.
+   * @param {TwitchEmote} [existingEmote] - Existing emote to cache.
+   * @returns {TwitchEmote} - A TwitchEmote instance.
+   */
+  _cacheTwitchEmote(channelId, data, existingEmote) {
+    const channel = this._setupChannel(channelId);
+    const emote = existingEmote || new TwitchEmote_default(channel, data.id, data);
+    this.emotes.set(emote.code, emote);
+    channel.emotes.set(emote.code, emote);
+    return emote;
+  }
+  /**
+   * Gets the raw BTTV emotes data for a channel.
+   * Use `null` for the global emotes channel.
+   * @private
+   * @param {number} [id] - ID of the channel.
+   * @returns {Promise<object[]>} - A promise that resolves to an array of raw BTTV emote data.
+   */
+  _getRawBTTVEmotes(id) {
+    const endpoint = id ? Constants_default.BTTV.Channel(id) : Constants_default.BTTV.Global;
+    return fetch(endpoint).then((response) => response.json()).then((data) => {
+      if (Array.isArray(data)) return data;
+      if (data?.channelEmotes && data?.sharedEmotes) {
+        return [
+          ...data.channelEmotes,
+          ...data.sharedEmotes
+        ];
+      }
+      return data || [];
+    });
+  }
+  /**
+   * Converts and caches a raw BTTV emote.
+   * @private
+   * @param {number} channelId - ID of the channel.
+   * @param {object} data - Raw data.
+   * @param {BTTVEmote} [existingEmote] - Existing emote to cache.
+   * @returns {BTTVEmote} - A BTTVEmote instance.
+   */
+  _cacheBTTVEmote(channelId, data, existingEmote) {
+    const channel = this._setupChannel(channelId);
+    const emote = existingEmote || new BTTVEmote_default(channel, data.id, data);
+    this.emotes.set(emote.code, emote);
+    channel.emotes.set(emote.code, emote);
+    return emote;
+  }
+  /**
+   * Gets the raw FFZ emote data from a set.
+   * @private
+   * @param {number} id - ID of the set.
+   * @returns {Promise<object[]>} - A promise that resolves to an array of raw FFZ emote data.
+   */
+  _getRawFFZEmoteSet(id) {
+    const endpoint = Constants_default.FFZ.Set(id);
+    return fetch(endpoint).then((response) => response.json()).then((data) => {
+      return data.set.emoticons;
+    });
+  }
+  /**
+   * Gets the raw FFZ emotes data for a channel.
+   * @private
+   * @param {number} id - ID of the channel.
+   * @returns {Promise<object[]>} - A promise that resolves to an array of raw FFZ emote data.
+   */
+  _getRawFFZEmotes(id) {
+    const endpoint = Constants_default.FFZ.Channel(id);
+    return fetch(endpoint).then((response) => response.json()).then((data) => {
+      const emotes = [];
+      for (const key of Object.keys(data.sets)) {
+        const set = data.sets[key];
+        emotes.push(...set.emoticons);
+      }
+      return emotes;
+    });
+  }
+  /**
+   * Converts and caches a raw FFZ emote.
+   * @private
+   * @param {number} channelId - ID of the channel.
+   * @param {object} data - Raw data.
+   * @param {FFZEmote} [existingEmote] - Existing emote to cache.
+   * @returns {FFZEmote} - A FFZEmote instance.
+   */
+  _cacheFFZEmote(channelId, data, existingEmote) {
+    const channel = this._setupChannel(channelId);
+    const emote = existingEmote || new FFZEmote_default(channel, data.id, data);
+    this.emotes.set(emote.code, emote);
+    channel.emotes.set(emote.code, emote);
+    return emote;
+  }
+  /**
+   * Gets the raw 7TV emotes data for a channel.
+   * @private
+   * @param {number} [id] - ID of the channel.
+   * @returns {Promise<object[]>} - A promise that resolves to an array of raw 7TV emote data.
+   */
+  _getRawSevenTVEmotes(id) {
+    const endpoint = id ? Constants_default.SevenTV.Channel(id) : Constants_default.SevenTV.Global;
+    return fetch(endpoint).then((response) => response.json());
+  }
+  /**
+   * Converts and caches a raw 7TV emote.
+   * @private
+   * @param {number} channelId - ID of the channel.
+   * @param {object} data - Raw data.
+   * @param {string} format - The type file format to use (webp/avif).
+   * @param {SevenTVEmote} [existingEmote] - Existing emote to cache.
+   * @returns {SevenTVEmote} - A SevenTVEmote instance.
+   */
+  _cacheSevenTVEmote(channelId, data, format, existingEmote) {
+    const channel = this._setupChannel(channelId, format);
+    const emote = existingEmote || new SevenTVEmote_default(channel, data.id, data);
+    this.emotes.set(emote.code, emote);
+    channel.emotes.set(emote.code, emote);
+    return emote;
+  }
+  /**
+   * Fetches the Twitch emotes for a channel.
+   * Use `null` for the global emotes channel.
+   * @param {number} [channel] - ID of the channel.
+   * @returns {Promise<Collection<string, TwitchEmote>>} - A promise that resolves to a collection of TwitchEmotes.
+   */
+  fetchTwitchEmotes(channel) {
+    return this._getRawTwitchEmotes(channel).then((rawEmotes) => {
+      for (const emote of rawEmotes) {
+        this._cacheTwitchEmote(channel, {
+          code: emote.name,
+          id: emote.id,
+          formats: emote.formats
+        });
+      }
+      return this.channels.get(channel).emotes.filter((e) => e.type === "twitch");
+    });
+  }
+  /**
+   * Fetches the BTTV emotes for a channel.
+   * Use `null` for the global emotes channel.
+   * @param {number} [channel] - ID of the channel.
+   * @returns {Promise<Collection<string, BTTVEmote>>} - A promise that resolves to a collection of BTTVEmotes.
+   */
+  fetchBTTVEmotes(channel) {
+    return this._getRawBTTVEmotes(channel).then((rawEmotes) => {
+      for (const data of rawEmotes) {
+        this._cacheBTTVEmote(channel, data);
+      }
+      return this.channels.get(channel).emotes.filter((e) => e.type === "bttv");
+    });
+  }
+  /**
+   * Fetches the FFZ emotes for a channel.
+   * @param {number} [channel] - ID of the channel.
+   * @returns {Promise<Collection<string, FFZEmote>>} - A promise that resolves to a collection of FFZEmotes.
+   */
+  async fetchFFZEmotes(channel) {
+    if (!this.ffzModifiersFetched) {
+      this.ffzModifiersFetched = true;
+      await this._getRawFFZEmoteSet(Constants_default.FFZ.sets.Modifiers).then((rawEmotes) => {
+        for (const data of rawEmotes) {
+          this._cacheFFZEmote(null, data);
+        }
+      });
+    }
+    if (!channel) {
+      return this._getRawFFZEmoteSet(Constants_default.FFZ.sets.Global).then((rawEmotes) => {
+        for (const data of rawEmotes) {
+          this._cacheFFZEmote(channel, data);
+        }
+        return this.channels.get(channel).emotes.filter((e) => e.type === "ffz");
+      });
+    }
+    return this._getRawFFZEmotes(channel).then((rawEmotes) => {
+      for (const data of rawEmotes) {
+        this._cacheFFZEmote(channel, data);
+      }
+      return this.channels.get(channel).emotes.filter((e) => e.type === "ffz");
+    });
+  }
+  /**
+   * Fetches the 7TV emotes for a channel.
+   * @param {number} [channel] - ID of the channel.
+   * @param {object} [options] - Options for fetching.
+   * @param {('webp'|'avif')} [options.format] - The type file format to use (webp/avif).
+   * @returns {Promise<Collection<string, SevenTVEmote>>} - A promise that resolves to a collection of SevenTVEmotes.
+   */
+  fetchSevenTVEmotes(channel, options) {
+    const {
+      format = "webp"
+    } = options || {};
+    return this._getRawSevenTVEmotes(channel).then((rawEmotes) => {
+      if (Object.hasOwn(rawEmotes, "emotes")) {
+        for (const data of rawEmotes.emotes) {
+          this._cacheSevenTVEmote(channel, data, format);
+        }
+      } else {
+        for (const data of rawEmotes.emote_set.emotes) {
+          this._cacheSevenTVEmote(channel, data, format);
+        }
+      }
+      return this.channels.get(channel).emotes.filter((e) => e.type === "7tv");
+    });
+  }
+  /**
+   * Converts emote Objects to emotes
+   * @param {object} [emotesArray] - An array of emote objects
+   * @throws {TypeError} When an emote has an unknown type.
+   * @returns {Emote[]} - An array of Emote instances.
+   */
+  fromObject(emotesArray) {
+    const emotes = [];
+    const classMap = {
+      "bttv": { class: BTTVEmote_default, cache: (emoteObject, channelId, existingEmote) => this._cacheBTTVEmote(channelId, null, existingEmote) },
+      "ffz": { class: FFZEmote_default, cache: (emoteObject, channelId, existingEmote) => this._cacheFFZEmote(channelId, null, existingEmote) },
+      "7tv": { class: SevenTVEmote_default, cache: (emoteObject, channelId, existingEmote) => this._cacheSevenTVEmote(channelId, null, emoteObject.imageType, existingEmote) },
+      "twitch": { class: TwitchEmote_default, cache: (emoteObject, channelId, existingEmote) => this._cacheTwitchEmote(channelId, null, existingEmote) }
+    };
+    for (const emoteObject of emotesArray) {
+      const { type } = emoteObject;
+      if (!Object.keys(classMap).includes(type)) {
+        throw new TypeError(`Unknown type: ${type}`);
+      }
+      const emoteClass = classMap[type].class;
+      this._setupChannel(emoteObject.channel_id, type === "7tv" ? emoteObject.imageType : null);
+      const emote = emoteClass.fromObject(emoteObject, this.channels.get(emoteObject.channel_id));
+      classMap[type].cache(emoteObject, emoteObject.channel_id, emote);
+      emotes.push(emote);
+    }
+    return emotes;
+  }
+};
+var EmoteFetcher_default = EmoteFetcher;
+
+// src/struct/EmoteParser.js
+var EmoteParser = class {
+  /**
+   * A parser to replace text with emotes.
+   * @param {EmoteFetcher} fetcher - The fetcher to use the cache of.
+   * @param {object} [options={}] - Options for the parser.
+   * @param {string} [options.template=''] - The template to be used.
+   * The strings that can be interpolated are:
+   * - `{link}` The link of the emote.
+   * - `{name}` The name of the emote.
+   * - `{size}` The size index of the image.
+   * - `{creator}` The channel/owner name of the emote.
+   * @param {'html' | 'markdown' | 'bbcode' | 'plain'} [options.type='html'] - The type of the parser.
+   * Can be one of `html`, `markdown`, `bbcode`, or `plain`.
+   * If the `template` option is provided, this is ignored.
+   * @param {RegExp} [options.match=/(\w+)/g] - The regular expression that matches an emote.
+   * Must be a global regex, with one capture group for the emote code.
+   */
+  constructor(fetcher, options = {}) {
+    this.fetcher = fetcher;
+    this.options = {
+      template: "",
+      type: "html",
+      match: /(\w+)/g,
+      ...options
+    };
+    this._validateOptions(this.options);
+  }
+  /**
+   * Validates the parser options.
+   * @private
+   * @param {object} [options] - Options for the parser.
+   * @param {string} [options.template] - The template to be used.
+   * The strings that can be interpolated are:
+   * - `{link}` The link of the emote.
+   * - `{name}` The name of the emote.
+   * - `{size}` The size of the image.
+   * - `{creator}` The channel/owner name of the emote.
+   * @param {'html' | 'markdown' | 'bbcode' | 'plain'} [options.type] - The type of the parser.
+   * Can be one of `html`, `markdown`, `bbcode`, or `plain`.
+   * If the `template` option is provided, this is ignored.
+   * @param {RegExp} [options.match] - The regular expression that matches an emote.
+   * Must be a global regex, with one capture group for the emote code.
+   * @throws {TypeError} When template is not a string.
+   * @throws {TypeError} When type is not one of the supported types.
+   * @throws {TypeError} When match is not a global RegExp.
+   */
+  _validateOptions(options) {
+    if (options.template && typeof options.template !== "string") {
+      throw new TypeError("Template must be a string");
+    }
+    if (!["html", "markdown", "bbcode", "plain"].includes(options.type)) {
+      throw new TypeError("Parse type must be one of `html`, `markdown`, `bbcode`, or `plain`");
+    }
+    if (!(options.match instanceof RegExp) || !options.match.global) {
+      throw new TypeError("Match must be a global RegExp.");
+    }
+  }
+  /**
+   * Parses text.
+   * @param {string} text - Text to parse.
+   * @param {object} [options] - Parameters for parsing.
+   * @param {number} [options.size] - Size (scale) for emotes.
+   * @param {boolean} [options.forceStatic] - Whether to force the emote to be static (non-animated). Defaults to the fetcher's forceStatic or `false`.
+   * @param {'dark' | 'light'} [options.themeMode] - Only for Twitch: the preferred theme mode. Defaults to the fetcher's twitchThemeMode or `dark`.
+   * @returns {string} - The parsed text.
+   */
+  parse(text, options) {
+    const {
+      size,
+      forceStatic,
+      themeMode
+    } = options || {};
+    const parsed = text.replace(this.options.match, (matched, id) => {
+      const emote = this.fetcher.emotes.get(id);
+      if (!emote) return matched;
+      if (emote.modifier) return "";
+      const template = this.options.template || Constants_default.Templates[this.options.type];
+      const link = emote.toLink({ size, forceStatic, themeMode });
+      const res = template.replaceAll("{link}", link).replaceAll("{name}", emote.code).replaceAll("{size}", size).replaceAll("{creator}", emote.ownerName || "global");
+      return res;
+    });
+    return parsed;
+  }
+};
+var EmoteParser_default = EmoteParser;
+
+// src/index.js
+var index_default = {
+  BTTVEmote: BTTVEmote_default,
+  Channel: Channel_default,
+  Collection: Collection_default,
+  Constants: Constants_default,
+  Emote: Emote_default,
+  EmoteFetcher: EmoteFetcher_default,
+  EmoteParser: EmoteParser_default,
+  FFZEmote: FFZEmote_default,
+  SevenTVEmote: SevenTVEmote_default,
+  TwitchEmote: TwitchEmote_default
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BTTVEmote,
+  Channel,
+  Collection,
+  Constants,
+  Emote,
+  EmoteFetcher,
+  EmoteParser,
+  FFZEmote,
+  SevenTVEmote,
+  TwitchEmote
+});