booru 2.6.9 → 2.8.0

package/dist/boorus/Booru.js

@@ -8,11 +8,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Booru = void 0;
-const Constants_1 = require("../Constants");
-const Utils_1 = require("../Utils");
 const undici_1 = require("undici");
+const Constants_1 = require("../Constants");
 const Post_1 = __importDefault(require("../structures/Post"));
 const SearchResults_1 = __importDefault(require("../structures/SearchResults"));
+const Tag_1 = __importDefault(require("../structures/Tag"));
+const TagListResults_1 = __importDefault(require("../structures/TagListResults"));
+const Utils_1 = require("../Utils");
 const resolvedFetch = typeof window !== 'undefined' ? window.fetch.bind(window) : undici_1.fetch;
 /*
  - new Booru
@@ -66,9 +68,7 @@ class Booru {
         if (!Array.isArray(tags)) {
             return [tags];
         }
-        else {
-            return tags.slice();
-        }
+        return tags.slice();
     }
     /**
      * Search for images on this booru
@@ -99,9 +99,7 @@ class Booru {
             if (err instanceof Error) {
                 throw new Constants_1.BooruError(err);
             }
-            else {
-                throw err;
-            }
+            throw err;
         }
     }
     /**
@@ -111,11 +109,55 @@ class Booru {
      * @return {String} The url to the post
      */
     postView(id) {
-        if (typeof id === 'string' && Number.isNaN(parseInt(id, 10))) {
+        if (typeof id === 'string' && Number.isNaN(Number.parseInt(id, 10))) {
             throw new Constants_1.BooruError(`Not a valid id for postView: ${id}`);
         }
         return `http${this.site.insecure ? '' : 's'}://${this.domain}${this.site.api.postView}${id}`;
     }
+    /**
+     * Gets a list of tags from the booru
+     * @param {Partial<TagsURLParams>} [params] The parameters for the tags list
+     * @param {number} [params.limit=100] The limit of tags to return
+     * @param {number} [params.page=1] The page of tags to return
+     * @return {Promise<any[]>} A promise with the tags as an array
+     */
+    async tagList({ limit = 100, page = 1, } = {}) {
+        const url = this.getTagListUrl({ limit, page });
+        const options = Constants_1.defaultOptions;
+        try {
+            const response = await resolvedFetch(url, options);
+            // Check for CloudFlare ratelimiting
+            if (response.status === 503) {
+                const body = await response.clone().text();
+                if (body.includes('cf-browser-verification')) {
+                    throw new Constants_1.BooruError("Received a CloudFlare browser verification request. Can't proceed.");
+                }
+            }
+            if (!response.ok) {
+                throw new Constants_1.BooruError(`Received HTTP ${response.status} from booru: '${await response.text()}'`);
+            }
+            const data = await response.text();
+            /**
+             * Many boorus don't support JSON parameter for tag listing
+             * So attempt JSON parsing, but if it fails default to XML parsing
+             **/
+            let tags = [];
+            try {
+                tags = (0, Utils_1.tryParseJSON)(data);
+            }
+            catch (_e) {
+                tags = (0, Utils_1.jsonifyTags)(data);
+            }
+            return this.parseTagListResult(tags, { limit, page });
+        }
+        catch (err) {
+            if (err.type === 'invalid-json')
+                if (err instanceof Error) {
+                    throw new Constants_1.BooruError(err);
+                }
+            throw err;
+        }
+    }
     /**
      * The internal & common searching logic, pls dont use this use .search instead
      *
@@ -127,18 +169,20 @@ class Booru {
     async doSearchRequest(tags, { uri = null, limit = 1, random = false, page = 0, } = {}) {
         // Used for random on sites without order:random
         let fakeLimit;
+        let searchTags = tags.slice();
         if (random) {
             if (this.site.random) {
-                tags.push('order:random');
+                searchTags.push('order:random');
             }
             else {
                 fakeLimit = 100;
             }
         }
         if (this.site.defaultTags) {
-            tags = tags.concat(this.site.defaultTags.filter((v) => !tags.includes(v)));
+            searchTags = searchTags.concat(this.site.defaultTags.filter((v) => !searchTags.includes(v)));
         }
-        const fetchuri = uri || this.getSearchUrl({ tags, limit: fakeLimit || limit, page });
+        const fetchuri = uri ??
+            this.getSearchUrl({ tags: searchTags, limit: fakeLimit ?? limit, page });
         const options = Constants_1.defaultOptions;
         const xml = this.site.type === 'xml';
         try {
@@ -151,16 +195,14 @@ class Booru {
                 }
             }
             const data = await response.text();
-            const posts = xml ? (0, Utils_1.jsonfy)(data) : (0, Utils_1.tryParseJSON)(data);
+            const posts = xml ? (0, Utils_1.jsonifyPosts)(data) : (0, Utils_1.tryParseJSON)(data);
             if (!response.ok) {
                 throw new Constants_1.BooruError(`Received HTTP ${response.status} ` +
-                    `from booru: '${posts.error ||
-                        posts.message ||
+                    `from booru: '${posts.error ??
+                        posts.message ??
                         JSON.stringify(posts)}'`);
             }
-            else {
-                return posts;
-            }
+            return posts;
         }
         catch (err) {
             if (err.type === 'invalid-json')
@@ -179,6 +221,19 @@ class Booru {
     getSearchUrl({ tags = [], limit = 100, page = 1, } = {}) {
         return (0, Constants_1.searchURI)(this.site, tags, limit, page, this.credentials);
     }
+    /**
+     * Generates a URL to get a list of tags from the booru
+     * @param opt
+     * @param {number} [opt.limit] The limit of tags to return
+     * @param {number} [opt.page] The page of tags to return
+     * @returns {string} A URL to get the tags list
+     */
+    getTagListUrl({ limit = 100, page = 1, } = {}) {
+        if (!this.site.api.tagList) {
+            throw new Constants_1.BooruError(`This booru does not support tag listing: ${this.site.domain}`);
+        }
+        return (0, Constants_1.tagListURI)(this.site, limit, page, this.credentials);
+    }
     /**
      * Parse the response from the booru
      *
@@ -188,42 +243,42 @@ class Booru {
      * @return {SearchResults} The results of this search
      */
     parseSearchResult(result, { fakeLimit, tags, limit, random, page, showUnavailable, }) {
-        if (result.success === false) {
-            throw new Constants_1.BooruError(result.message || result.reason);
+        let outResult = result;
+        if (outResult.success === false) {
+            throw new Constants_1.BooruError(outResult.message ?? outResult.reason);
         }
         // Gelbooru
-        if (result['@attributes']) {
-            const attributes = result['@attributes'];
-            if (attributes.count === '0' || !result.post) {
-                result = [];
+        if (outResult['@attributes']) {
+            const attributes = outResult['@attributes'];
+            if (attributes.count === '0' || !outResult.post) {
+                outResult = [];
             }
-            else if (Array.isArray(result.post)) {
-                result = result.post;
+            else if (Array.isArray(outResult.post)) {
+                outResult = outResult.post;
             }
             else {
-                result = [result.post];
+                outResult = [outResult.post];
             }
         }
-        if (result.posts) {
-            result = result.posts;
+        if (outResult.posts) {
+            outResult = outResult.posts;
         }
-        if (result.images) {
-            result = result.images;
+        if (outResult.images) {
+            outResult = outResult.images;
         }
         let r;
         // If gelbooru/other booru decides to return *nothing* instead of an empty array
-        if (result === '') {
+        if (outResult === '') {
             r = [];
         }
         else if (fakeLimit) {
-            r = (0, Utils_1.shuffle)(result);
+            r = (0, Utils_1.shuffle)(outResult);
         }
-        else if (result.constructor === Object) {
+        else if (outResult.constructor === Object) {
             // For XML based sites
-            r = [result];
+            r = [outResult];
         }
-        const results = r || result;
-        let posts = results
+        let posts = (r ?? outResult)
             .slice(0, limit)
             .map((v) => new Post_1.default(v, this));
         const options = { limit, random, page, showUnavailable };
@@ -235,6 +290,28 @@ class Booru {
         }
         return new SearchResults_1.default(posts, tags, options, this);
     }
+    /**
+     * Parse the response from the booru for a tag list
+     *
+     * @param result
+     * @param param1
+     * @returns
+     */
+    parseTagListResult(result, { limit = 100, page = 1 } = {}) {
+        if (result.success === false) {
+            throw new Constants_1.BooruError(result.message ?? result.reason);
+        }
+        let tags = [];
+        if (result) {
+            if (Array.isArray(result)) {
+                tags = result.map((v) => new Tag_1.default(v, this));
+            }
+            else {
+                tags = [new Tag_1.default(result, this)];
+            }
+        }
+        return new TagListResults_1.default(tags, { limit, page }, this);
+    }
 }
 exports.Booru = Booru;
 exports.default = Booru;

package/dist/boorus/Booru.js.map

@@ -1 +1 @@
-{"version":3,"file":"Booru.js","sourceRoot":"","sources":["../../src/boorus/Booru.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Booru.js","sourceRoot":"","sources":["../../src/boorus/Booru.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @packageDocumentation\n * @module Boorus\n */\n\nimport { fetch } from 'undici'\nimport { BooruError, defaultOptions, searchURI, tagListURI } from '../Constants'\nimport type InternalSearchParameters from '../structures/InternalSearchParameters'\nimport Post from '../structures/Post'\nimport type SearchParameters from '../structures/SearchParameters'\nimport SearchResults from '../structures/SearchResults'\nimport type Site from '../structures/Site'\nimport Tag from '../structures/Tag'\nimport TagListResults from '../structures/TagListResults'\nimport {\n  jsonifyPosts,\n  jsonifyTags,\n  resolveSite,\n  shuffle,\n  tryParseJSON,\n} from '../Utils'\n\n// Shut up the compiler\n// This attempts to find and use the native browser fetch, if possible\n// Fixes https://github.com/AtoraSuunva/booru/issues/51\ndeclare const window: any\nconst resolvedFetch: typeof fetch =\n  typeof window !== 'undefined' ? window.fetch.bind(window) : fetch\n\nexport type BooruCredentials = Record<string, string>\n\ninterface SearchUrlParams {\n  tags: string[]\n  limit: number\n  page: number\n}\n\ninterface TagsURLParams {\n  limit?: number | undefined\n  page?: number | undefined\n}\n\n/*\n - new Booru\n => Constructor, params {name, {nsfw, {search, postView, ...}, random}, {apiTokens...}}\n => .search([tags...], {limit, random})\n => .postView(id)\n => .site\n */\n\n/**\n * A basic, JSON booru\n * @example\n * ```\n * const Booru = require('booru')\n * // Aliases are supported\n * const e9 = Booru('e9')\n *\n * // You can then search the site\n * const imgs = await e9.search(['cat', 'cute'], {limit: 3})\n *\n * // And use the images\n * imgs.forEach(i => console.log(i.fileUrl))\n *\n * // Or access other methods on the Booru\n * e9.postView(imgs[0].id)\n * ```\n */\nexport class Booru {\n  /** The domain of the booru */\n  public domain: string\n  /** The site object representing this booru */\n  public site: Site\n  /** The credentials to use for this booru */\n  public credentials?: BooruCredentials | undefined\n\n  /**\n   * Create a new booru from a site\n   *\n   * @private\n   * @param site The site to use\n   * @param credentials Credentials for the API (Currently not used)\n   */\n  constructor(site: Site, credentials?: BooruCredentials) {\n    const domain = resolveSite(site.domain)\n\n    if (domain === null) {\n      throw new Error(`Invalid site passed: ${site.domain}`)\n    }\n\n    this.domain = domain\n    this.site = site\n    this.credentials = credentials\n  }\n\n  protected normalizeTags(tags: string | string[]): string[] {\n    if (!Array.isArray(tags)) {\n      return [tags]\n    }\n\n    return tags.slice()\n  }\n\n  /**\n   * Search for images on this booru\n   * @param {String|String[]} tags The tag(s) to search for\n   * @param {SearchParameters} searchArgs The arguments for the search\n   * @return {Promise<SearchResults>} The results as an array of Posts\n   */\n  public async search(\n    tags: string | string[],\n    {\n      limit = 1,\n      random = false,\n      page = 0,\n      showUnavailable = false,\n    }: SearchParameters = {},\n  ): Promise<SearchResults> {\n    const fakeLimit: number = random && !this.site.random ? 100 : 0\n    const tagArray = this.normalizeTags(tags)\n\n    try {\n      const searchResult = await this.doSearchRequest(tagArray, {\n        limit,\n        random,\n        page,\n        showUnavailable,\n      })\n      return this.parseSearchResult(searchResult, {\n        fakeLimit,\n        tags: tagArray,\n        limit,\n        random,\n        page,\n        showUnavailable,\n      })\n    } catch (err) {\n      if (err instanceof Error) {\n        throw new BooruError(err)\n      }\n\n      throw err\n    }\n  }\n\n  /**\n   * Gets the url you'd see in your browser from a post id for this booru\n   *\n   * @param {String} id The id to get the postView for\n   * @return {String} The url to the post\n   */\n  public postView(id: string | number): string {\n    if (typeof id === 'string' && Number.isNaN(Number.parseInt(id, 10))) {\n      throw new BooruError(`Not a valid id for postView: ${id}`)\n    }\n\n    return `http${this.site.insecure ? '' : 's'}://${this.domain}${\n      this.site.api.postView\n    }${id}`\n  }\n\n  /**\n   * Gets a list of tags from the booru\n   * @param {Partial<TagsURLParams>} [params] The parameters for the tags list\n   * @param {number} [params.limit=100] The limit of tags to return\n   * @param {number} [params.page=1] The page of tags to return\n   * @return {Promise<any[]>} A promise with the tags as an array\n   */\n  public async tagList({\n    limit = 100,\n    page = 1,\n  }: Partial<TagsURLParams> = {}): Promise<TagListResults> {\n    const url = this.getTagListUrl({ limit, page })\n    const options = defaultOptions\n    try {\n      const response = await resolvedFetch(url, options)\n\n      // Check for CloudFlare ratelimiting\n      if (response.status === 503) {\n        const body = await response.clone().text()\n        if (body.includes('cf-browser-verification')) {\n          throw new BooruError(\n            \"Received a CloudFlare browser verification request. Can't proceed.\",\n          )\n        }\n      }\n\n      if (!response.ok) {\n        throw new BooruError(\n          `Received HTTP ${response.status} from booru: '${await response.text()}'`,\n        )\n      }\n\n      const data = await response.text()\n      /**\n       * Many boorus don't support JSON parameter for tag listing\n       * So attempt JSON parsing, but if it fails default to XML parsing\n       **/\n      let tags = []\n      try {\n        tags = tryParseJSON(data)\n      } catch (_e) {\n        tags = jsonifyTags(data)\n      }\n\n      return this.parseTagListResult(tags, { limit, page })\n    } catch (err) {\n      if ((err as any).type === 'invalid-json')\n        if (err instanceof Error) {\n          throw new BooruError(err)\n        }\n\n      throw err\n    }\n  }\n\n  /**\n   * The internal & common searching logic, pls dont use this use .search instead\n   *\n   * @protected\n   * @param {String[]|String} tags The tags to search with\n   * @param {InternalSearchParameters} searchArgs The arguments for the search\n   * @return {Promise<Object>}\n   */\n  protected async doSearchRequest(\n    tags: string[],\n    {\n      uri = null,\n      limit = 1,\n      random = false,\n      page = 0,\n    }: InternalSearchParameters = {},\n  ): Promise<any> {\n    // Used for random on sites without order:random\n    let fakeLimit: number | undefined\n    let searchTags = tags.slice()\n\n    if (random) {\n      if (this.site.random) {\n        searchTags.push('order:random')\n      } else {\n        fakeLimit = 100\n      }\n    }\n\n    if (this.site.defaultTags) {\n      searchTags = searchTags.concat(\n        this.site.defaultTags.filter((v) => !searchTags.includes(v)),\n      )\n    }\n\n    const fetchuri =\n      uri ??\n      this.getSearchUrl({ tags: searchTags, limit: fakeLimit ?? limit, page })\n    const options = defaultOptions\n    const xml = this.site.type === 'xml'\n\n    try {\n      const response = await resolvedFetch(fetchuri, options)\n\n      // Check for CloudFlare ratelimiting\n      if (response.status === 503) {\n        const body = await response.clone().text()\n        if (body.includes('cf-browser-verification')) {\n          throw new BooruError(\n            \"Received a CloudFlare browser verification request. Can't proceed.\",\n          )\n        }\n      }\n\n      const data = await response.text()\n      const posts = xml ? jsonifyPosts(data) : tryParseJSON(data)\n\n      if (!response.ok) {\n        throw new BooruError(\n          `Received HTTP ${response.status} ` +\n            `from booru: '${\n              (posts as any).error ??\n              (posts as any).message ??\n              JSON.stringify(posts)\n            }'`,\n        )\n      }\n\n      return posts\n    } catch (err) {\n      if ((err as any).type === 'invalid-json') return ''\n      throw err\n    }\n  }\n\n  /**\n   * Generates a URL to search the booru with, mostly for debugging purposes\n   * @param opt\n   * @param {string[]} [opt.tags] The tags to search for\n   * @param {number} [opt.limit] The limit of results to return\n   * @param {number} [opt.page] The page of results to return\n   * @returns A URL to search the booru\n   */\n  getSearchUrl({\n    tags = [],\n    limit = 100,\n    page = 1,\n  }: Partial<SearchUrlParams> = {}): string {\n    return searchURI(this.site, tags, limit, page, this.credentials)\n  }\n\n  /**\n   * Generates a URL to get a list of tags from the booru\n   * @param opt\n   * @param {number} [opt.limit] The limit of tags to return\n   * @param {number} [opt.page] The page of tags to return\n   * @returns {string} A URL to get the tags list\n   */\n  getTagListUrl({\n    limit = 100,\n    page = 1,\n  }: Partial<TagsURLParams> = {}): string {\n    if (!this.site.api.tagList) {\n      throw new BooruError(\n        `This booru does not support tag listing: ${this.site.domain}`,\n      )\n    }\n    return tagListURI(this.site, limit, page, this.credentials)\n  }\n\n  /**\n   * Parse the response from the booru\n   *\n   * @protected\n   * @param {Object} result The response of the booru\n   * @param {InternalSearchParameters} searchArgs The arguments used for the search\n   * @return {SearchResults} The results of this search\n   */\n  protected parseSearchResult(\n    result: any,\n    {\n      fakeLimit,\n      tags,\n      limit,\n      random,\n      page,\n      showUnavailable,\n    }: InternalSearchParameters,\n  ): SearchResults {\n    let outResult = result\n\n    if (outResult.success === false) {\n      throw new BooruError(outResult.message ?? outResult.reason)\n    }\n\n    // Gelbooru\n    if (outResult['@attributes']) {\n      const attributes = outResult['@attributes']\n\n      if (attributes.count === '0' || !outResult.post) {\n        outResult = []\n      } else if (Array.isArray(outResult.post)) {\n        outResult = outResult.post\n      } else {\n        outResult = [outResult.post]\n      }\n    }\n\n    if (outResult.posts) {\n      outResult = outResult.posts\n    }\n\n    if (outResult.images) {\n      outResult = outResult.images\n    }\n\n    let r: string[] | undefined\n    // If gelbooru/other booru decides to return *nothing* instead of an empty array\n    if (outResult === '') {\n      r = []\n    } else if (fakeLimit) {\n      r = shuffle(outResult)\n    } else if (outResult.constructor === Object) {\n      // For XML based sites\n      r = [outResult]\n    }\n\n    let posts: Post[] = (r ?? outResult)\n      .slice(0, limit)\n      .map((v: any) => new Post(v, this))\n    const options = { limit, random, page, showUnavailable }\n\n    if (tags === undefined) {\n      tags = []\n    }\n\n    if (!showUnavailable) {\n      posts = posts.filter((p) => p.available)\n    }\n\n    return new SearchResults(posts, tags, options, this)\n  }\n\n  /**\n   * Parse the response from the booru for a tag list\n   *\n   * @param result\n   * @param param1\n   * @returns\n   */\n  protected parseTagListResult(\n    result: any,\n    { limit = 100, page = 1 }: Partial<TagsURLParams> = {},\n  ): TagListResults {\n    if (result.success === false) {\n      throw new BooruError(result.message ?? result.reason)\n    }\n\n    let tags: any[] = []\n\n    if (result) {\n      if (Array.isArray(result)) {\n        tags = result.map((v) => new Tag(v, this))\n      } else {\n        tags = [new Tag(result, this)]\n      }\n    }\n\n    return new TagListResults(tags, { limit, page }, this)\n  }\n}\n\nexport default Booru\n"]}

package/dist/boorus/Derpibooru.d.ts

@@ -2,10 +2,9 @@
  * @packageDocumentation
  * @module Boorus
  */
-import SearchParameters from '../structures/SearchParameters';
-import SearchResults from '../structures/SearchResults';
-import Site from '../structures/Site';
-import Booru, { BooruCredentials } from './Booru';
+import type SearchParameters from '../structures/SearchParameters';
+import type SearchResults from '../structures/SearchResults';
+import Booru from './Booru';
 /**
  * A class designed for Derpibooru
  * >:(
@@ -14,12 +13,7 @@ import Booru, { BooruCredentials } from './Booru';
  * @inheritDoc
  */
 export default class Derpibooru extends Booru {
-    /**
-     * Create a new booru for Derpibooru from a site
-     * @param site The site to use
-     * @param credentials Credentials for the API (Currently not used)
-     */
-    constructor(site: Site, credentials?: BooruCredentials);
     /** @inheritDoc */
     search(tags: string[] | string, { limit, random, page }?: SearchParameters): Promise<SearchResults>;
 }
+//# sourceMappingURL=Derpibooru.d.ts.map

package/dist/boorus/Derpibooru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Derpibooru.d.ts","sourceRoot":"","sources":["../../src/boorus/Derpibooru.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,gBAAgB,MAAM,gCAAgC,CAAA;AAClE,OAAO,KAAK,aAAa,MAAM,6BAA6B,CAAA;AAC5D,OAAO,KAAK,MAAM,SAAS,CAAA;AAE3B;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,KAAK;IAC3C,kBAAkB;IACF,MAAM,CACpB,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EACvB,EAAE,KAAS,EAAE,MAAc,EAAE,IAAQ,EAAE,GAAE,gBAAqB,GAC7D,OAAO,CAAC,aAAa,CAAC;CA6B1B"}

package/dist/boorus/Derpibooru.js

@@ -17,14 +17,6 @@ const Booru_1 = __importDefault(require("./Booru"));
  * @inheritDoc
  */
 class Derpibooru extends Booru_1.default {
-    /**
-     * Create a new booru for Derpibooru from a site
-     * @param site The site to use
-     * @param credentials Credentials for the API (Currently not used)
-     */
-    constructor(site, credentials) {
-        super(site, credentials);
-    }
     /** @inheritDoc */
     search(tags, { limit = 1, random = false, page = 0 } = {}) {
         const tagArray = this.normalizeTags(tags);

package/dist/boorus/Derpibooru.js.map

@@ -1 +1 @@
-{"version":3,"file":"Derpibooru.js","sourceRoot":"","sources":["../../src/boorus/Derpibooru.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,4CAAyC;AAIzC,oDAAiD;AAEjD;;;;;;GAMG;AACH,MAAqB,UAAW,SAAQ,eAAK;IAC3C;;;;OAIG;IACH,YAAY,IAAU,EAAE,WAA8B;QACpD,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAC1B,CAAC;IAED,kBAAkB;IACF,MAAM,CACpB,IAAuB,EACvB,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,KAAuB,EAAE;QAE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QAEzC,mCAAmC;QACnC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9B,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;QACnB,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,CAAA;QAET,MAAM,GAAG,GACP,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAClD,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAE5D,OAAO,KAAK;aACT,eAAe,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;aACvD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACV,KAAK,CAAC,iBAAiB,CAAC,CAAC,EAAE;YACzB,SAAS,EAAE,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,KAAK;YACL,MAAM;YACN,IAAI;SACL,CAAC,CACH;aACA,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,sBAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACpD,CAAC;CACF;AA3CD,6BA2CC"}
+{"version":3,"file":"Derpibooru.js","sourceRoot":"","sources":["../../src/boorus/Derpibooru.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,4CAAyC;AAGzC,oDAA2B;AAE3B;;;;;;GAMG;AACH,MAAqB,UAAW,SAAQ,eAAK;IAC3C,kBAAkB;IACF,MAAM,CACpB,IAAuB,EACvB,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,KAAuB,EAAE;QAE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QAEzC,mCAAmC;QACnC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9B,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;QACnB,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,CAAA;QAET,MAAM,GAAG,GACP,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAClD,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAE5D,OAAO,KAAK;aACT,eAAe,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;aACvD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACV,KAAK,CAAC,iBAAiB,CAAC,CAAC,EAAE;YACzB,SAAS,EAAE,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,KAAK;YACL,MAAM;YACN,IAAI;SACL,CAAC,CACH;aACA,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,sBAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACpD,CAAC;CACF;AAlCD,6BAkCC","sourcesContent":["/**\n * @packageDocumentation\n * @module Boorus\n */\n\nimport { BooruError } from '../Constants'\nimport type SearchParameters from '../structures/SearchParameters'\nimport type SearchResults from '../structures/SearchResults'\nimport Booru from './Booru'\n\n/**\n * A class designed for Derpibooru\n * >:(\n * @private\n * @extends Booru\n * @inheritDoc\n */\nexport default class Derpibooru extends Booru {\n  /** @inheritDoc */\n  public override search(\n    tags: string[] | string,\n    { limit = 1, random = false, page = 0 }: SearchParameters = {},\n  ): Promise<SearchResults> {\n    const tagArray = this.normalizeTags(tags)\n\n    // For any image, you must supply *\n    if (tagArray[0] === undefined) {\n      tagArray[0] = '*'\n    }\n\n    // Derpibooru offsets the pages by 1\n    page += 1\n\n    const uri =\n      this.getSearchUrl({ tags: tagArray, limit, page }) +\n      (random && this.site.random === 'string' ? `&${this.site.random}` : '') +\n      (this.credentials ? `&key=${this.credentials.token}` : '')\n\n    return super\n      .doSearchRequest(tagArray, { limit, random, page, uri })\n      .then((r) =>\n        super.parseSearchResult(r, {\n          fakeLimit: 0,\n          tags: tagArray,\n          limit,\n          random,\n          page,\n        }),\n      )\n      .catch((e) => Promise.reject(new BooruError(e)))\n  }\n}\n"]}

package/dist/boorus/XmlBooru.d.ts

@@ -2,8 +2,7 @@
  * @packageDocumentation
  * @module Boorus
  */
-import Site from '../structures/Site';
-import Booru, { BooruCredentials } from './Booru';
+import Booru from './Booru';
 /**
  * A class designed for Xml-returning boorus
  *
@@ -11,10 +10,5 @@ import Booru, { BooruCredentials } from './Booru';
  * @inheritDoc
  */
 export default class XmlBooru extends Booru {
-    /**
-     * Create a new booru using XML from a site
-     * @param {Site} site The site to use
-     * @param {Object?} credentials Credentials for the API (Currently not used)
-     */
-    constructor(site: Site, credentials?: BooruCredentials);
 }
+//# sourceMappingURL=XmlBooru.d.ts.map

package/dist/boorus/XmlBooru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XmlBooru.d.ts","sourceRoot":"","sources":["../../src/boorus/XmlBooru.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,SAAS,CAAA;AAE3B;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,KAAK;CAAG"}

package/dist/boorus/XmlBooru.js

@@ -15,14 +15,6 @@ const Booru_1 = __importDefault(require("./Booru"));
  * @inheritDoc
  */
 class XmlBooru extends Booru_1.default {
-    /**
-     * Create a new booru using XML from a site
-     * @param {Site} site The site to use
-     * @param {Object?} credentials Credentials for the API (Currently not used)
-     */
-    constructor(site, credentials) {
-        super(site, credentials);
-    }
 }
 exports.default = XmlBooru;
 //# sourceMappingURL=XmlBooru.js.map

package/dist/boorus/XmlBooru.js.map

@@ -1 +1 @@
-{"version":3,"file":"XmlBooru.js","sourceRoot":"","sources":["../../src/boorus/XmlBooru.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAGH,oDAAiD;AAEjD;;;;;GAKG;AACH,MAAqB,QAAS,SAAQ,eAAK;IACzC;;;;OAIG;IACH,YAAY,IAAU,EAAE,WAA8B;QACpD,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAC1B,CAAC;CACF;AATD,2BASC"}
+{"version":3,"file":"XmlBooru.js","sourceRoot":"","sources":["../../src/boorus/XmlBooru.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,oDAA2B;AAE3B;;;;;GAKG;AACH,MAAqB,QAAS,SAAQ,eAAK;CAAG;AAA9C,2BAA8C","sourcesContent":["/**\n * @packageDocumentation\n * @module Boorus\n */\n\nimport Booru from './Booru'\n\n/**\n * A class designed for Xml-returning boorus\n *\n * @extends Booru\n * @inheritDoc\n */\nexport default class XmlBooru extends Booru {}\n"]}

package/dist/index.d.ts

@@ -2,13 +2,15 @@
  * @packageDocumentation
  * @module Index
  */
-import Booru, { BooruCredentials } from './boorus/Booru';
+import Booru, { type BooruCredentials } from './boorus/Booru';
 import Derpibooru from './boorus/Derpibooru';
 import XmlBooru from './boorus/XmlBooru';
 import Post from './structures/Post';
-import SearchParameters from './structures/SearchParameters';
+import type SearchParameters from './structures/SearchParameters';
 import SearchResults from './structures/SearchResults';
 import Site from './structures/Site';
+import type TagListParameters from './structures/TagListParameters';
+import type TagListResults from './structures/TagListResults';
 /**
  * Create a new booru to search with
  *
@@ -23,6 +25,9 @@ export default booruForSite;
 export interface BooruSearch extends SearchParameters {
     credentials?: BooruCredentials;
 }
+export interface BooruTagList extends TagListParameters {
+    credentials?: BooruCredentials;
+}
 /**
  * Searches a site for images with tags and returns the results
  * @param {String} site The site to search
@@ -39,6 +44,20 @@ export interface BooruSearch extends SearchParameters {
  * ```
  */
 export declare function search(site: string, tags?: string[] | string, { limit, random, page, credentials }?: BooruSearch): Promise<SearchResults>;
+/**
+ * Get a list of tags from a site
+ * @param {String} site The site to get the tags from
+ * @param {TagListParameters} [options={}] The options for the tag list
+ * @return {Promise<TagListResults>} A promise with the tags as an array of objects
+ *
+ * @example
+ * ```
+ * const Booru = require('booru')
+ * // Returns a promise with the first 100 tags from e926
+ * Booru.tagList('e926')
+ * ```
+ */
+export declare function tagList(site: string, { limit, page, credentials }?: BooruTagList): Promise<TagListResults>;
 /**
  * Deprecated, now a noop
  * <p>This will be removed *soon* please stop using it</p>
@@ -54,3 +73,4 @@ export { BooruError, sites } from './Constants';
 export { resolveSite } from './Utils';
 export { Derpibooru, Post, SearchResults, Site, XmlBooru };
 export type { BooruCredentials, SearchParameters };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,UAAU,MAAM,qBAAqB,CAAA;AAC5C,OAAO,QAAQ,MAAM,mBAAmB,CAAA;AAExC,OAAO,IAAI,MAAM,mBAAmB,CAAA;AACpC,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAA;AACjE,OAAO,aAAa,MAAM,4BAA4B,CAAA;AACtD,OAAO,IAAI,MAAM,mBAAmB,CAAA;AACpC,OAAO,KAAK,iBAAiB,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAA;AAyB7D;;;;;;;GAOG;AACH,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,gBAAgB,GAAG,KAAK,CASzE;AAED,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,CAAA;AAClC,eAAe,YAAY,CAAA;AAE3B,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,WAAW,CAAC,EAAE,gBAAgB,CAAA;CAC/B;AAED,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,WAAW,CAAC,EAAE,gBAAgB,CAAA;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,EAAE,GAAG,MAAW,EAC5B,EAAE,KAAS,EAAE,MAAc,EAAE,IAAQ,EAAE,WAAgB,EAAE,GAAE,WAAgB,GAC1E,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,EAAE,KAAS,EAAE,IAAQ,EAAE,WAAgB,EAAE,GAAE,YAAiB,GAC3D,OAAO,CAAC,cAAc,CAAC,CAezB;AAOD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAGxD;AAED,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAC1D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/index.js

@@ -10,14 +10,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.XmlBooru = exports.Site = exports.SearchResults = exports.Post = exports.Derpibooru = exports.resolveSite = exports.sites = exports.BooruError = exports.BooruClass = void 0;
 exports.forSite = booruForSite;
 exports.search = search;
+exports.tagList = tagList;
 exports.commonfy = commonfy;
-const Constants_1 = require("./Constants");
-const util_1 = require("util");
+const node_util_1 = require("node:util");
 const Booru_1 = __importDefault(require("./boorus/Booru"));
 const Derpibooru_1 = __importDefault(require("./boorus/Derpibooru"));
 exports.Derpibooru = Derpibooru_1.default;
 const XmlBooru_1 = __importDefault(require("./boorus/XmlBooru"));
 exports.XmlBooru = XmlBooru_1.default;
+const Constants_1 = require("./Constants");
 const Post_1 = __importDefault(require("./structures/Post"));
 exports.Post = Post_1.default;
 const SearchResults_1 = __importDefault(require("./structures/SearchResults"));
@@ -77,7 +78,7 @@ exports.default = booruForSite;
 function search(site, tags = [], { limit = 1, random = false, page = 0, credentials = {} } = {}) {
     const rSite = (0, Utils_1.resolveSite)(site);
     if (typeof limit === 'string') {
-        limit = parseInt(limit, 10);
+        limit = Number.parseInt(limit, 10);
     }
     if (rSite === null) {
         throw new Constants_1.BooruError('Site not supported');
@@ -96,8 +97,32 @@ function search(site, tags = [], { limit = 1, random = false, page = 0, credenti
     booruCache[rSite].credentials = credentials;
     return booruCache[rSite].search(tags, { limit, random, page });
 }
-// eslint-disable-next-line no-empty,@typescript-eslint/no-empty-function
-const deprecatedCommonfy = (0, util_1.deprecate)(() => { }, 'Common is now deprecated, just access the properties directly');
+/**
+ * Get a list of tags from a site
+ * @param {String} site The site to get the tags from
+ * @param {TagListParameters} [options={}] The options for the tag list
+ * @return {Promise<TagListResults>} A promise with the tags as an array of objects
+ *
+ * @example
+ * ```
+ * const Booru = require('booru')
+ * // Returns a promise with the first 100 tags from e926
+ * Booru.tagList('e926')
+ * ```
+ */
+function tagList(site, { limit = 1, page = 0, credentials = {} } = {}) {
+    const rSite = (0, Utils_1.resolveSite)(site);
+    if (rSite === null) {
+        throw new Constants_1.BooruError('Site not supported');
+    }
+    const booruSite = new Site_1.default(Constants_1.sites[rSite]);
+    if (!booruCache[rSite]) {
+        booruCache[rSite] = booruFrom(booruSite, credentials);
+    }
+    booruCache[rSite].credentials = credentials;
+    return booruCache[rSite].tagList({ limit, page });
+}
+const deprecatedCommonfy = (0, node_util_1.deprecate)(() => { }, 'Common is now deprecated, just access the properties directly');
 /**
  * Deprecated, now a noop
  * <p>This will be removed *soon* please stop using it</p>

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @packageDocumentation\n * @module Index\n */\n\nimport { deprecate } from 'node:util'\nimport Booru, { type BooruCredentials } from './boorus/Booru'\nimport Derpibooru from './boorus/Derpibooru'\nimport XmlBooru from './boorus/XmlBooru'\nimport { type AnySite, BooruError, sites } from './Constants'\nimport Post from './structures/Post'\nimport type SearchParameters from './structures/SearchParameters'\nimport SearchResults from './structures/SearchResults'\nimport Site from './structures/Site'\nimport type TagListParameters from './structures/TagListParameters'\nimport type TagListResults from './structures/TagListResults'\nimport { resolveSite } from './Utils'\n\nconst BooruTypes: Record<string, typeof Booru> = {\n  derpi: Derpibooru,\n  xml: XmlBooru,\n}\n\nconst booruCache: Partial<Record<AnySite, Booru>> = {}\n\n/**\n * Create a new booru, if special type, use that booru, else use default Booru\n *\n * @param booruSite The site to use\n * @param credentials The credentials to use, if any\n * @return A new booru\n */\nfunction booruFrom(booruSite: Site, credentials?: BooruCredentials): Booru {\n  return new (\n    booruSite.type !== undefined && BooruTypes[booruSite.type]\n      ? BooruTypes[booruSite.type]\n      : Booru\n  )(booruSite, credentials)\n}\n\n/**\n * Create a new booru to search with\n *\n * @constructor\n * @param {String} site The {@link Site} domain (or alias of it) to create a booru from\n * @param {BooruCredentials} credentials The credentials to use on this booru\n * @return {Booru} A booru to use\n */\nfunction booruForSite(site: string, credentials?: BooruCredentials): Booru {\n  const rSite = resolveSite(site)\n\n  if (!rSite) throw new BooruError('Site not supported')\n\n  const booruSite = new Site(sites[rSite])\n\n  // If special type, use that booru, else use default Booru\n  return booruFrom(booruSite, credentials)\n}\n\nexport { booruForSite as forSite }\nexport default booruForSite\n\nexport interface BooruSearch extends SearchParameters {\n  credentials?: BooruCredentials\n}\n\nexport interface BooruTagList extends TagListParameters {\n  credentials?: BooruCredentials\n}\n\n/**\n * Searches a site for images with tags and returns the results\n * @param {String} site The site to search\n * @param {String[]|String} [tags=[]] Tags to search with\n * @param {SearchParameters} [searchOptions={}] The options for searching\n *  if provided (Unused)\n * @return {Promise<SearchResults>} A promise with the images as an array of objects\n *\n * @example\n * ```\n * const Booru = require('booru')\n * // Returns a promise with the latest cute glace pic from e926\n * Booru.search('e926', ['glaceon', 'cute'])\n * ```\n */\nexport function search(\n  site: string,\n  tags: string[] | string = [],\n  { limit = 1, random = false, page = 0, credentials = {} }: BooruSearch = {},\n): Promise<SearchResults> {\n  const rSite = resolveSite(site)\n\n  if (typeof limit === 'string') {\n    limit = Number.parseInt(limit, 10)\n  }\n\n  if (rSite === null) {\n    throw new BooruError('Site not supported')\n  }\n\n  if (!Array.isArray(tags) && typeof tags !== 'string') {\n    throw new BooruError('`tags` should be an array or string')\n  }\n\n  if (typeof limit !== 'number' || Number.isNaN(limit)) {\n    throw new BooruError('`limit` should be an int')\n  }\n\n  const booruSite = new Site(sites[rSite])\n\n  if (!booruCache[rSite]) {\n    booruCache[rSite] = booruFrom(booruSite, credentials)\n  }\n\n  // This is ugly and a hack, I know this\n  booruCache[rSite].credentials = credentials\n  return booruCache[rSite].search(tags, { limit, random, page })\n}\n\n/**\n * Get a list of tags from a site\n * @param {String} site The site to get the tags from\n * @param {TagListParameters} [options={}] The options for the tag list\n * @return {Promise<TagListResults>} A promise with the tags as an array of objects\n *\n * @example\n * ```\n * const Booru = require('booru')\n * // Returns a promise with the first 100 tags from e926\n * Booru.tagList('e926')\n * ```\n */\nexport function tagList(\n  site: string,\n  { limit = 1, page = 0, credentials = {} }: BooruTagList = {},\n): Promise<TagListResults> {\n  const rSite = resolveSite(site)\n\n  if (rSite === null) {\n    throw new BooruError('Site not supported')\n  }\n\n  const booruSite = new Site(sites[rSite])\n\n  if (!booruCache[rSite]) {\n    booruCache[rSite] = booruFrom(booruSite, credentials)\n  }\n\n  booruCache[rSite].credentials = credentials\n  return booruCache[rSite].tagList({ limit, page })\n}\n\nconst deprecatedCommonfy = deprecate(\n  () => {},\n  'Common is now deprecated, just access the properties directly',\n)\n\n/**\n * Deprecated, now a noop\n * <p>This will be removed *soon* please stop using it</p>\n * <p>Just access <code>&lt;{@link Post}&gt;.prop</code>, no need to commonfy anymore\n *\n * @deprecated Just use <code>&lt;{@link Post}&gt;.prop</code> instead\n * @param  {Post[]} images   Array of {@link Post} objects\n * @return {Promise<Post[]>} Array of {@link Post} objects\n */\nexport function commonfy(images: Post[]): Promise<Post[]> {\n  deprecatedCommonfy()\n  return Promise.resolve(images)\n}\n\nexport { Booru as BooruClass } from './boorus/Booru'\nexport { BooruError, sites } from './Constants'\nexport { resolveSite } from './Utils'\nexport { Derpibooru, Post, SearchResults, Site, XmlBooru }\nexport type { BooruCredentials, SearchParameters }\n"]}