booru 2.6.2 → 2.6.3

package/dist/Constants.js

@@ -1 +1,91 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(r){return r&&r.__esModule?r:{default:r}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.defaultOptions=exports.searchURI=exports.USER_AGENT=exports.BooruError=exports.sites=void 0;const sites_json_1=__importDefault(require("./sites.json")),Utils_1=require("./Utils"),expandedTags={"rating:e":"rating:explicit","rating:q":"rating:questionable","rating:s":"rating:safe"};exports.sites=sites_json_1.default;class BooruError extends Error{constructor(r){super(r instanceof Error?r.message:r),r instanceof Error?this.stack=r.stack:Error.captureStackTrace(this,BooruError),this.name="BooruError"}}function expandTags(r){return r.map((r=>expandedTags[r.toLowerCase()]??r))}function searchURI(r,t=[],e=100,s=0,o={}){const a=(0,Utils_1.querystring)({[r.tagQuery]:expandTags(t),limit:e,[r.paginate]:s,...o},{arrayJoin:r.tagJoin});return`http${r.insecure?"":"s"}://${r.domain}${r.api.search}`+a}exports.BooruError=BooruError,exports.USER_AGENT="booru (https://github.com/AtoraSuunva/booru)",exports.searchURI=searchURI,exports.defaultOptions={headers:{Accept:"application/json, application/xml;q=0.9, */*;q=0.8","User-Agent":exports.USER_AGENT}};
+"use strict";
+/**
+ * @packageDocumentation
+ * @module Constants
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultOptions = exports.searchURI = exports.USER_AGENT = exports.BooruError = exports.sites = void 0;
+const sites_json_1 = __importDefault(require("./sites.json"));
+const Utils_1 = require("./Utils");
+const expandedTags = {
+    'rating:e': 'rating:explicit',
+    'rating:q': 'rating:questionable',
+    'rating:s': 'rating:safe',
+};
+/**
+ * A map of site url/{@link SiteInfo}
+ */
+exports.sites = sites_json_1.default;
+/**
+ * Custom error type for when the boorus error or for user-side error, not my code (probably)
+ * <p>The name of the error is 'BooruError'
+ * @type {Error}
+ */
+class BooruError extends Error {
+    constructor(message) {
+        super(message instanceof Error ? message.message : message);
+        if (message instanceof Error) {
+            this.stack = message.stack;
+        }
+        else {
+            Error.captureStackTrace(this, BooruError);
+        }
+        this.name = 'BooruError';
+    }
+}
+exports.BooruError = BooruError;
+/**
+ * The user-agent to use for searches
+ * @private
+ */
+exports.USER_AGENT = `booru (https://github.com/AtoraSuunva/booru)`;
+/**
+ * Expands tags based on a simple map, used for gelbooru/safebooru/etc compat :(
+ *
+ * @private
+ * @param {String[]} tags The tags to expand
+ */
+function expandTags(tags) {
+    return tags.map((v) => expandedTags[v.toLowerCase()] ?? v);
+}
+/**
+ * Create a full uri to search with
+ *
+ * @private
+ * @param {string} domain The domain to search
+ * @param {Site} site The site to search
+ * @param {string[]} [tags=[]] The tags to search for
+ * @param {number} [limit=100] The limit for images to return
+ * @param {number} [page=0] The page to get
+ * @param {BooryCredentials} [credentials] The credentials to use for the search, appended to the querystring
+ */
+function searchURI(site, tags = [], limit = 100, page = 0, credentials = {}) {
+    const query = (0, Utils_1.querystring)({
+        [site.tagQuery]: expandTags(tags),
+        limit,
+        [site.paginate]: page,
+        ...credentials,
+    }, {
+        arrayJoin: site.tagJoin,
+    });
+    return (`http${site.insecure ? '' : 's'}://` +
+        `${site.domain}${site.api.search}` +
+        query);
+}
+exports.searchURI = searchURI;
+/**
+ * The default options to use for requests
+ * <p>I could document this better but meh
+ *
+ * @private
+ */
+exports.defaultOptions = {
+    headers: {
+        Accept: 'application/json, application/xml;q=0.9, */*;q=0.8',
+        'User-Agent': exports.USER_AGENT,
+    },
+};
+//# sourceMappingURL=Constants.js.map

package/dist/Utils.js

@@ -1 +1,185 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.encodeURIQueryValue=exports.querystring=exports.compareArrays=exports.validateSearchParams=exports.randInt=exports.shuffle=exports.tryParseJSON=exports.jsonfy=exports.resolveSite=void 0;const Constants_1=require("./Constants"),fast_xml_parser_1=require("fast-xml-parser");function resolveSite(r){if("string"!=typeof r)return null;r=r.toLowerCase();for(const[e,t]of Object.entries(Constants_1.sites))if(e===r||t.domain===r||t.aliases.includes(r))return e;return null}exports.resolveSite=resolveSite;const xmlParser=new fast_xml_parser_1.XMLParser({ignoreAttributes:!1,attributeNamePrefix:""});function jsonfy(r){if("object"==typeof r)return r;const e=xmlParser.parse(r);if(e.html||e["!doctype"]){const r=e.html||e["!doctype"]?.html,t=[];throw r.body.h1&&t.push(r.body.h1),r.body.p&&t.push(r.body.p["#text"]),new Constants_1.BooruError(`The Booru sent back an error: '${t.join(": ")}'`)}return e.posts.post?e.posts.post:e.posts.tag?Array.isArray(e.posts.tag)?e.posts.tag:[e.posts.tag]:[]}function tryParseJSON(r){return""===r?[]:JSON.parse(r)}function shuffle(r){let e,t,o=r.length;for(;0!==o;)t=Math.floor(Math.random()*o),o-=1,e=r[o],r[o]=r[t],r[t]=e;return r}function randInt(r,e){return r=Math.ceil(r),e=Math.floor(e),Math.floor(Math.random()*(e-r+1))+r}function validateSearchParams(r,e){const t=resolveSite(r);if("number"!=typeof e&&(e=parseInt(e,10)),null===t)throw new Constants_1.BooruError("Site not supported");if("number"!=typeof e||Number.isNaN(e))throw new Constants_1.BooruError("`limit` should be an int");return{site:t,limit:e}}function compareArrays(r,e){return r.filter((r=>e.some((e=>r.toLowerCase()===e.toLowerCase()))))}function querystring(r,{arrayJoin:e="+"}={}){return Object.entries(r).map((([r,t])=>`${encodeURIComponent(r)}=${encodeURIQueryValue(t,{arrayJoin:e})}`)).join("&")}function encodeURIQueryValue(r,{arrayJoin:e="+"}={}){return Array.isArray(r)?r.map(encodeURIComponent).join(e):encodeURIComponent(r)}exports.jsonfy=jsonfy,exports.tryParseJSON=tryParseJSON,exports.shuffle=shuffle,exports.randInt=randInt,exports.validateSearchParams=validateSearchParams,exports.compareArrays=compareArrays,exports.querystring=querystring,exports.encodeURIQueryValue=encodeURIQueryValue;
+"use strict";
+/**
+ * @packageDocumentation
+ * @module Utils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeURIQueryValue = exports.querystring = exports.compareArrays = exports.validateSearchParams = exports.randInt = exports.shuffle = exports.tryParseJSON = exports.jsonfy = exports.resolveSite = void 0;
+const Constants_1 = require("./Constants");
+const fast_xml_parser_1 = require("fast-xml-parser");
+/**
+ * Check if `site` is a supported site (and check if it's an alias and return the sites's true name)
+ *
+ * @param  {String} domain The site to resolveSite
+ * @return {String?} null if site is not supported, the site otherwise
+ */
+function resolveSite(domain) {
+    if (typeof domain !== 'string') {
+        return null;
+    }
+    domain = domain.toLowerCase();
+    for (const [site, info] of Object.entries(Constants_1.sites)) {
+        if (site === domain ||
+            info.domain === domain ||
+            info.aliases.includes(domain)) {
+            return site;
+        }
+    }
+    return null;
+}
+exports.resolveSite = resolveSite;
+const xmlParser = new fast_xml_parser_1.XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: '',
+});
+/**
+ * Parses xml to json, which can be used with js
+ *
+ * @private
+ * @param  {String} xml The xml to convert to json
+ * @return {Object[]} A Promise with an array of objects created from the xml
+ */
+function jsonfy(xml) {
+    if (typeof xml === 'object')
+        return xml;
+    const data = xmlParser.parse(xml);
+    if (data.html || data['!doctype']) {
+        // Some boorus return HTML error pages instead of JSON responses on errors
+        // So try scraping off what we can in that case
+        const page = data.html || data['!doctype']?.html;
+        const message = [];
+        if (page.body.h1) {
+            message.push(page.body.h1);
+        }
+        if (page.body.p) {
+            message.push(page.body.p['#text']);
+        }
+        throw new Constants_1.BooruError(`The Booru sent back an error: '${message.join(': ')}'`);
+    }
+    if (data.posts.post) {
+        return data.posts.post;
+    }
+    if (data.posts.tag) {
+        return Array.isArray(data.posts.tag) ? data.posts.tag : [data.posts.tag];
+    }
+    return [];
+}
+exports.jsonfy = jsonfy;
+/**
+ * Try to parse JSON, and then return an empty array if data is an empty string, or the parsed JSON
+ *
+ * Blame rule34.xxx for returning literally an empty response with HTTP 200 for this
+ * @param data The data to try and parse
+ * @returns Either the parsed data, or an empty array
+ */
+function tryParseJSON(data) {
+    if (data === '') {
+        return [];
+    }
+    return JSON.parse(data);
+}
+exports.tryParseJSON = tryParseJSON;
+/**
+ * Yay fisher-bates
+ * Taken from http://stackoverflow.com/a/2450976
+ *
+ * @private
+ * @param  {Array} array Array of something
+ * @return {Array}       Shuffled array of something
+ */
+function shuffle(array) {
+    let currentIndex = array.length;
+    let temporaryValue;
+    let randomIndex;
+    while (currentIndex !== 0) {
+        randomIndex = Math.floor(Math.random() * currentIndex);
+        currentIndex -= 1;
+        temporaryValue = array[currentIndex];
+        array[currentIndex] = array[randomIndex];
+        array[randomIndex] = temporaryValue;
+    }
+    return array;
+}
+exports.shuffle = shuffle;
+// Thanks mdn and damnit derpibooru
+/**
+ * Generate a random int between [min, max]
+ *
+ * @private
+ * @param {Number} min The minimum (inclusive)
+ * @param {Number} max The maximum (inclusive)
+ */
+function randInt(min, max) {
+    min = Math.ceil(min);
+    max = Math.floor(max);
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+exports.randInt = randInt;
+/**
+ * Performs some basic search validation
+ *
+ * @private
+ * @param {String} site The site to resolve
+ * @param {Number|String} limit The limit for the amount of images to fetch
+ */
+function validateSearchParams(site, limit) {
+    const resolvedSite = resolveSite(site);
+    if (typeof limit !== 'number') {
+        limit = parseInt(limit, 10);
+    }
+    if (resolvedSite === null) {
+        throw new Constants_1.BooruError('Site not supported');
+    }
+    if (typeof limit !== 'number' || Number.isNaN(limit)) {
+        throw new Constants_1.BooruError('`limit` should be an int');
+    }
+    return { site: resolvedSite, limit };
+}
+exports.validateSearchParams = validateSearchParams;
+/**
+ * Finds the matching strings between two arrays
+ *
+ * @private
+ * @param {String[]} arr1 The first array
+ * @param {String[]} arr2 The second array
+ * @return {String[]} The shared strings between the arrays
+ */
+function compareArrays(arr1, arr2) {
+    return arr1.filter((e1) => arr2.some((e2) => e1.toLowerCase() === e2.toLowerCase()));
+}
+exports.compareArrays = compareArrays;
+/**
+ * Turns an object into a query string, correctly encoding uri components
+ *
+ * @example
+ * const options = { page: 10, limit: 100 }
+ * const query = querystring(options) // 'page=10&limit=100'
+ * console.log(`https://example.com?${query}`)
+ *
+ * @param query An object with key/value pairs that will be turned into a string
+ * @returns A string that can be appended to a url (after `?`)
+ */
+function querystring(query, { arrayJoin = '+' } = {}) {
+    return Object.entries(query)
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIQueryValue(value, {
+        arrayJoin,
+    })}`)
+        .join('&');
+}
+exports.querystring = querystring;
+/**
+ * Encodes a single value or an array of values to be usable in as a URI component,
+ * joining array elements with '+'
+ * @param value The value to encode
+ * @returns An encoded value that can be passed to a querystring
+ */
+function encodeURIQueryValue(value, { arrayJoin = '+' } = {}) {
+    if (Array.isArray(value)) {
+        return value.map(encodeURIComponent).join(arrayJoin);
+    }
+    else {
+        return encodeURIComponent(value);
+    }
+}
+exports.encodeURIQueryValue = encodeURIQueryValue;
+//# sourceMappingURL=Utils.js.map

package/dist/boorus/Booru.js

@@ -1 +1,237 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.Booru=void 0;const undici_1=require("undici"),Constants_1=require("../Constants"),Utils_1=require("../Utils"),Post_1=__importDefault(require("../structures/Post")),SearchResults_1=__importDefault(require("../structures/SearchResults")),resolvedFetch="undefined"!=typeof window?window.fetch.bind(window):undici_1.fetch;class Booru{domain;site;credentials;constructor(t,e){const s=(0,Utils_1.resolveSite)(t.domain);if(null===s)throw new Error(`Invalid site passed: ${t}`);this.domain=s,this.site=t,this.credentials=e}async search(t,{limit:e=1,random:s=!1,page:r=0,showUnavailable:i=!1}={}){const o=s&&!this.site.random?100:0;try{const a=await this.doSearchRequest(t,{limit:e,random:s,page:r,showUnavailable:i});return this.parseSearchResult(a,{fakeLimit:o,tags:t,limit:e,random:s,page:r,showUnavailable:i})}catch(t){throw t instanceof Error?new Constants_1.BooruError(t):t}}postView(t){if("string"==typeof t&&Number.isNaN(parseInt(t,10)))throw new Constants_1.BooruError(`Not a valid id for postView: ${t}`);return`http${this.site.insecure?"":"s"}://${this.domain}${this.site.api.postView}${t}`}async doSearchRequest(t,{uri:e=null,limit:s=1,random:r=!1,page:i=0}={}){let o;Array.isArray(t)||(t=[t]),r&&(this.site.random?t.push("order:random"):o=100),this.site.defaultTags&&(t=t.concat(this.site.defaultTags.filter((e=>!t.includes(e)))));const a=e||this.getSearchUrl({tags:t,limit:o||s,page:i}),n=Constants_1.defaultOptions,l="xml"===this.site.type;try{const t=await resolvedFetch(a,n);if(503===t.status){if((await t.clone().text()).includes("cf-browser-verification"))throw new Constants_1.BooruError("Received a CloudFlare browser verification request. Can't proceed.")}const e=await t.text(),s=l?(0,Utils_1.jsonfy)(e):(0,Utils_1.tryParseJSON)(e);if(t.ok)return s;throw new Constants_1.BooruError(`Received HTTP ${t.status} from booru: '${s.error||s.message||JSON.stringify(s)}'`)}catch(t){if("invalid-json"===t.type)return"";throw t}}getSearchUrl({tags:t=[],limit:e=100,page:s=1}={}){return(0,Constants_1.searchURI)(this.site,t,e,s,this.credentials)}parseSearchResult(t,{fakeLimit:e,tags:s,limit:r,random:i,page:o,showUnavailable:a}){if(!1===t.success)throw new Constants_1.BooruError(t.message||t.reason);if(t["@attributes"]){t="0"!==t["@attributes"].count&&t.post?Array.isArray(t.post)?t.post:[t.post]:[]}let n;t.posts&&(t=t.posts),t.images&&(t=t.images),""===t?n=[]:e?n=(0,Utils_1.shuffle)(t):t.constructor===Object&&(n=[t]);let l=(n||t).slice(0,r).map((t=>new Post_1.default(t,this)));const u={limit:r,random:i,page:o,showUnavailable:a};return void 0===s&&(s=[]),Array.isArray(s)||(s=[s]),a||(l=l.filter((t=>t.available))),new SearchResults_1.default(l,s,u,this)}}exports.Booru=Booru,exports.default=Booru;
+"use strict";
+/**
+ * @packageDocumentation
+ * @module Boorus
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Booru = void 0;
+const undici_1 = require("undici");
+const Constants_1 = require("../Constants");
+const Utils_1 = require("../Utils");
+const Post_1 = __importDefault(require("../structures/Post"));
+const SearchResults_1 = __importDefault(require("../structures/SearchResults"));
+const resolvedFetch = typeof window !== 'undefined' ? window.fetch.bind(window) : undici_1.fetch;
+/*
+ - new Booru
+ => Constructor, params {name, {nsfw, {search, postView, ...}, random}, {apiTokens...}}
+ => .search([tags...], {limit, random})
+ => .postView(id)
+ => .site
+ */
+/**
+ * A basic, JSON booru
+ * @example
+ * ```
+ * const Booru = require('booru')
+ * // Aliases are supported
+ * const e9 = Booru('e9')
+ *
+ * // You can then search the site
+ * const imgs = await e9.search(['cat', 'cute'], {limit: 3})
+ *
+ * // And use the images
+ * imgs.forEach(i => console.log(i.fileUrl))
+ *
+ * // Or access other methods on the Booru
+ * e9.postView(imgs[0].id)
+ * ```
+ */
+class Booru {
+    /** The domain of the booru */
+    domain;
+    /** The site object representing this booru */
+    site;
+    /** The credentials to use for this booru */
+    credentials;
+    /**
+     * Create a new booru from a site
+     *
+     * @private
+     * @param site The site to use
+     * @param credentials Credentials for the API (Currently not used)
+     */
+    constructor(site, credentials) {
+        const domain = (0, Utils_1.resolveSite)(site.domain);
+        if (domain === null) {
+            throw new Error(`Invalid site passed: ${site}`);
+        }
+        this.domain = domain;
+        this.site = site;
+        this.credentials = credentials;
+    }
+    /**
+     * Search for images on this booru
+     * @param {String|String[]} tags The tag(s) to search for
+     * @param {SearchParameters} searchArgs The arguments for the search
+     * @return {Promise<SearchResults>} The results as an array of Posts
+     */
+    async search(tags, { limit = 1, random = false, page = 0, showUnavailable = false, } = {}) {
+        const fakeLimit = random && !this.site.random ? 100 : 0;
+        try {
+            const searchResult = await this.doSearchRequest(tags, {
+                limit,
+                random,
+                page,
+                showUnavailable,
+            });
+            return this.parseSearchResult(searchResult, {
+                fakeLimit,
+                tags,
+                limit,
+                random,
+                page,
+                showUnavailable,
+            });
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                throw new Constants_1.BooruError(err);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    /**
+     * Gets the url you'd see in your browser from a post id for this booru
+     *
+     * @param {String} id The id to get the postView for
+     * @return {String} The url to the post
+     */
+    postView(id) {
+        if (typeof id === 'string' && Number.isNaN(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}`;
+    }
+    /**
+     * The internal & common searching logic, pls dont use this use .search instead
+     *
+     * @protected
+     * @param {String[]|String} tags The tags to search with
+     * @param {InternalSearchParameters} searchArgs The arguments for the search
+     * @return {Promise<Object>}
+     */
+    async doSearchRequest(tags, { uri = null, limit = 1, random = false, page = 0, } = {}) {
+        if (!Array.isArray(tags))
+            tags = [tags];
+        // Used for random on sites without order:random
+        let fakeLimit;
+        if (random) {
+            if (this.site.random) {
+                tags.push('order:random');
+            }
+            else {
+                fakeLimit = 100;
+            }
+        }
+        if (this.site.defaultTags) {
+            tags = tags.concat(this.site.defaultTags.filter((v) => !tags.includes(v)));
+        }
+        const fetchuri = uri || this.getSearchUrl({ tags, limit: fakeLimit || limit, page });
+        const options = Constants_1.defaultOptions;
+        const xml = this.site.type === 'xml';
+        try {
+            const response = await resolvedFetch(fetchuri, 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.");
+                }
+            }
+            const data = await response.text();
+            const posts = xml ? (0, Utils_1.jsonfy)(data) : (0, Utils_1.tryParseJSON)(data);
+            if (!response.ok) {
+                throw new Constants_1.BooruError(`Received HTTP ${response.status} ` +
+                    `from booru: '${posts.error ||
+                        posts.message ||
+                        JSON.stringify(posts)}'`);
+            }
+            else {
+                return posts;
+            }
+        }
+        catch (err) {
+            if (err.type === 'invalid-json')
+                return '';
+            throw err;
+        }
+    }
+    /**
+     * Generates a URL to search the booru with, mostly for debugging purposes
+     * @param opt
+     * @param {string[]} [opt.tags] The tags to search for
+     * @param {number} [opt.limit] The limit of results to return
+     * @param {number} [opt.page] The page of results to return
+     * @returns A URL to search the booru
+     */
+    getSearchUrl({ tags = [], limit = 100, page = 1, } = {}) {
+        return (0, Constants_1.searchURI)(this.site, tags, limit, page, this.credentials);
+    }
+    /**
+     * Parse the response from the booru
+     *
+     * @protected
+     * @param {Object} result The response of the booru
+     * @param {InternalSearchParameters} searchArgs The arguments used for the search
+     * @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);
+        }
+        // Gelbooru
+        if (result['@attributes']) {
+            const attributes = result['@attributes'];
+            if (attributes.count === '0' || !result.post) {
+                result = [];
+            }
+            else if (Array.isArray(result.post)) {
+                result = result.post;
+            }
+            else {
+                result = [result.post];
+            }
+        }
+        if (result.posts) {
+            result = result.posts;
+        }
+        if (result.images) {
+            result = result.images;
+        }
+        let r;
+        // If gelbooru/other booru decides to return *nothing* instead of an empty array
+        if (result === '') {
+            r = [];
+        }
+        else if (fakeLimit) {
+            r = (0, Utils_1.shuffle)(result);
+        }
+        else if (result.constructor === Object) {
+            // For XML based sites
+            r = [result];
+        }
+        const results = r || result;
+        let posts = results
+            .slice(0, limit)
+            .map((v) => new Post_1.default(v, this));
+        const options = { limit, random, page, showUnavailable };
+        if (tags === undefined) {
+            tags = [];
+        }
+        if (!Array.isArray(tags)) {
+            tags = [tags];
+        }
+        if (!showUnavailable) {
+            posts = posts.filter((p) => p.available);
+        }
+        return new SearchResults_1.default(posts, tags, options, this);
+    }
+}
+exports.Booru = Booru;
+exports.default = Booru;
+//# sourceMappingURL=Booru.js.map

package/dist/boorus/Derpibooru.js

@@ -1 +1,49 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const Constants_1=require("../Constants"),Booru_1=__importDefault(require("./Booru"));class Derpibooru extends Booru_1.default{constructor(e,t){super(e,t)}search(e,{limit:t=1,random:r=!1,page:s=0}={}){Array.isArray(e)||(e=[e]),void 0===e[0]&&(e[0]="*"),s+=1;const o=this.getSearchUrl({tags:e,limit:t,page:s})+(r&&"string"===this.site.random?`&${this.site.random}`:"")+(this.credentials?`&key=${this.credentials.token}`:"");return super.doSearchRequest(e,{limit:t,random:r,page:s,uri:o}).then((o=>super.parseSearchResult(o,{fakeLimit:0,tags:e,limit:t,random:r,page:s}))).catch((e=>Promise.reject(new Constants_1.BooruError(e))))}}exports.default=Derpibooru;
+"use strict";
+/**
+ * @packageDocumentation
+ * @module Boorus
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Constants_1 = require("../Constants");
+const Booru_1 = __importDefault(require("./Booru"));
+/**
+ * A class designed for Derpibooru
+ * >:(
+ * @private
+ * @extends 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 } = {}) {
+        if (!Array.isArray(tags)) {
+            tags = [tags];
+        }
+        // For any image, you must supply *
+        if (tags[0] === undefined) {
+            tags[0] = '*';
+        }
+        // Derpibooru offsets the pages by 1
+        page += 1;
+        const uri = this.getSearchUrl({ tags, limit, page }) +
+            (random && this.site.random === 'string' ? `&${this.site.random}` : '') +
+            (this.credentials ? `&key=${this.credentials.token}` : '');
+        return super
+            .doSearchRequest(tags, { limit, random, page, uri })
+            .then((r) => super.parseSearchResult(r, { fakeLimit: 0, tags, limit, random, page }))
+            .catch((e) => Promise.reject(new Constants_1.BooruError(e)));
+    }
+}
+exports.default = Derpibooru;
+//# sourceMappingURL=Derpibooru.js.map

package/dist/boorus/XmlBooru.js

@@ -1 +1,28 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const Booru_1=__importDefault(require("./Booru"));class XmlBooru extends Booru_1.default{constructor(e,t){super(e,t)}}exports.default=XmlBooru;
+"use strict";
+/**
+ * @packageDocumentation
+ * @module Boorus
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Booru_1 = __importDefault(require("./Booru"));
+/**
+ * A class designed for Xml-returning boorus
+ *
+ * @extends 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/index.d.ts

@@ -3,9 +3,12 @@
  * @module Index
  */
 import Booru, { 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 SearchResults from './structures/SearchResults';
+import Site from './structures/Site';
 /**
  * Create a new booru to search with
  *
@@ -50,3 +53,5 @@ export { Booru as BooruClass } from './boorus/Booru';
 export { sites } from './Constants';
 export { resolveSite } from './Utils';
 export { BooruError } from './Constants';
+export { Derpibooru, XmlBooru, Post, SearchResults, Site };
+export type { BooruCredentials, SearchParameters };