fandom.js 1.0.0 → 1.1.0

package/dist/managers/category-manager.js

@@ -0,0 +1,27 @@
+import { BaseManager } from "./base-manager.js";
+import { Page } from "../structures/page-structure.js";
+/**
+ * Manager for handling category-related operations.
+ */
+export class CategoryManager extends BaseManager {
+    /**
+     * Fetches members of a category.
+     * @param category - The name of the category.
+     * @param limit - The maximum number of members to fetch. Defaults to 50.
+     * @returns A Promise that resolves to an array of Page objects representing the category members.
+     */
+    async fetchMembers(category, limit = 50) {
+        const res = await this.client.requestManager.get({
+            action: "query",
+            list: "categorymembers",
+            cmtitle: category.startsWith("Category:")
+                ? category
+                : `Category:${category}`,
+            cmlimit: limit,
+            format: "json",
+        });
+        if (!res?.query?.categorymembers)
+            return [];
+        return res.query.categorymembers.map((data) => new Page(this.client, data));
+    }
+}

package/dist/managers/event-manager.d.ts

@@ -0,0 +1,48 @@
+import { FandomEmitter } from "../events/events.js";
+import type { Client } from "../client/client.js";
+/**
+ * Manager for handling wiki events via polling.
+ */
+export declare class EventManager extends FandomEmitter {
+    /**
+     * The client instance.
+     * @private
+     */
+    private client;
+    /**
+     * The polling interval.
+     * @private
+     */
+    private interval;
+    /**
+     * The timestamp of the last processed change.
+     * @private
+     */
+    private lastTimestamp;
+    /**
+     * Creates a new instance of the EventManager.
+     * @param client - The client instance.
+     */
+    constructor(client: Client);
+    /**
+     * Starts polling for recent changes.
+     * @param intervalMs - The polling interval in milliseconds. Defaults to 5000.
+     */
+    startPolling(intervalMs?: number): void;
+    /**
+     * Stops polling for recent changes.
+     */
+    stopPolling(): void;
+    /**
+     * Polls for recent changes.
+     * @private
+     */
+    private poll;
+    /**
+     * Processes a recent change and emits relevant events.
+     * @param change - The recent change to process.
+     * @private
+     */
+    private processChange;
+}
+//# sourceMappingURL=event-manager.d.ts.map

package/dist/managers/event-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-manager.d.ts","sourceRoot":"","sources":["../../src/managers/event-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAS;IACvB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA+B;IAC/C;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAuB;IAE5C;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAK1B;;;OAGG;IACI,YAAY,CAAC,UAAU,GAAE,MAAa;IAK7C;;OAEG;IACI,WAAW;IAOlB;;;OAGG;YACW,IAAI;IAsClB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAyBtB"}

package/dist/managers/event-manager.js

@@ -0,0 +1,110 @@
+import { FandomEmitter } from "../events/events.js";
+/**
+ * Manager for handling wiki events via polling.
+ */
+export class EventManager extends FandomEmitter {
+    /**
+     * Creates a new instance of the EventManager.
+     * @param client - The client instance.
+     */
+    constructor(client) {
+        super();
+        /**
+         * The polling interval.
+         * @private
+         */
+        this.interval = null;
+        /**
+         * The timestamp of the last processed change.
+         * @private
+         */
+        this.lastTimestamp = null;
+        this.client = client;
+    }
+    /**
+     * Starts polling for recent changes.
+     * @param intervalMs - The polling interval in milliseconds. Defaults to 5000.
+     */
+    startPolling(intervalMs = 5000) {
+        if (this.interval)
+            return;
+        this.interval = setInterval(() => this.poll(), intervalMs);
+    }
+    /**
+     * Stops polling for recent changes.
+     */
+    stopPolling() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    /**
+     * Polls for recent changes.
+     * @private
+     */
+    async poll() {
+        try {
+            const params = {
+                action: "query",
+                list: "recentchanges",
+                rcprop: "title|ids|timestamp|user|userid|comment|flags|loginfo",
+                rclimit: 50,
+                format: "json",
+            };
+            if (this.lastTimestamp) {
+                params.rcend = this.lastTimestamp;
+            }
+            const res = await this.client.requestManager.get(params);
+            const changes = res?.query?.recentchanges;
+            if (!changes || changes.length === 0)
+                return;
+            if (!this.lastTimestamp) {
+                this.lastTimestamp = changes[0].timestamp;
+                return;
+            }
+            for (const change of changes) {
+                if (change.timestamp <= this.lastTimestamp)
+                    continue;
+                this.processChange(change);
+            }
+            this.lastTimestamp = changes[0].timestamp;
+        }
+        catch (err) {
+            console.error("Polling error:", err);
+        }
+    }
+    /**
+     * Processes a recent change and emits relevant events.
+     * @param change - The recent change to process.
+     * @private
+     */
+    processChange(change) {
+        if (change.type === "edit") {
+            this.emit("pageUpdate", change);
+        }
+        else if (change.type === "new") {
+            this.emit("pageCreate", change);
+        }
+        else if (change.type === "log") {
+            if (change.logtype === "upload") {
+                this.emit("fileUpload", {
+                    title: change.title,
+                    user: change.user,
+                    timestamp: change.timestamp,
+                    comment: change.comment,
+                    url: "",
+                });
+            }
+            else if (change.logtype === "block") {
+                this.emit("userBlock", {
+                    user: change.title.replace("User:", ""),
+                    by: change.user,
+                    timestamp: change.timestamp,
+                    expiry: "",
+                    reason: change.comment,
+                });
+            }
+        }
+    }
+}

package/dist/managers/meta-manager.d.ts

@@ -0,0 +1,14 @@
+import { BaseManager } from "./base-manager.js";
+import type { SiteInfo } from "../types/index.js";
+/**
+ * Manager for handling metadata-related operations.
+ */
+export declare class MetaManager extends BaseManager {
+    /**
+     * Fetches site information.
+     * @param prop - The properties to fetch. Defaults to "general|namespaces|statistics".
+     * @returns A Promise that resolves to the site information.
+     */
+    fetchSiteInfo(prop?: string): Promise<Partial<SiteInfo>>;
+}
+//# sourceMappingURL=meta-manager.d.ts.map

package/dist/managers/meta-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-manager.d.ts","sourceRoot":"","sources":["../../src/managers/meta-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;OAIG;IACU,aAAa,CACxB,IAAI,GAAE,MAAwC,GAC7C,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;CAY9B"}

package/dist/managers/meta-manager.js

@@ -0,0 +1,20 @@
+import { BaseManager } from "./base-manager.js";
+/**
+ * Manager for handling metadata-related operations.
+ */
+export class MetaManager extends BaseManager {
+    /**
+     * Fetches site information.
+     * @param prop - The properties to fetch. Defaults to "general|namespaces|statistics".
+     * @returns A Promise that resolves to the site information.
+     */
+    async fetchSiteInfo(prop = "general|namespaces|statistics") {
+        const res = await this.client.requestManager.get({
+            action: "query",
+            meta: "siteinfo",
+            siprop: prop,
+            format: "json",
+        });
+        return res?.query || {};
+    }
+}

package/dist/managers/page-manager.d.ts

@@ -0,0 +1,26 @@
+import { BaseManager } from "./base-manager.js";
+import { Page } from "../structures/page-structure.js";
+import type { Client } from "../client/client.js";
+/**
+ * Manager for handling page-related operations.
+ */
+export declare class PageManager extends BaseManager {
+    /**
+     * Cache for storing fetched pages.
+     * @private
+     */
+    private cache;
+    /**
+     * Creates a new instance of the PageManager.
+     * @param client - The client instance.
+     */
+    constructor(client: Client);
+    /**
+     * Fetches a page by its title.
+     * @param title - The title of the page to fetch.
+     * @returns A Promise that resolves to the fetched Page.
+     * @throws {Error} If no page data is found.
+     */
+    fetch(title: string): Promise<Page>;
+}
+//# sourceMappingURL=page-manager.d.ts.map

package/dist/managers/page-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-manager.d.ts","sourceRoot":"","sources":["../../src/managers/page-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAOvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAyB;IAEtC;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAO1B;;;;;OAKG;IACU,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA+EjD"}

package/dist/managers/page-manager.js

@@ -0,0 +1,86 @@
+import { BaseManager } from "./base-manager.js";
+import { Page } from "../structures/page-structure.js";
+import { LRUCache } from "lru-cache";
+import { ARTICLES_DETAILS_PATH, DEFAULT_ABSTRACT_LENGTH, } from "../package-constants.js";
+/**
+ * Manager for handling page-related operations.
+ */
+export class PageManager extends BaseManager {
+    /**
+     * Creates a new instance of the PageManager.
+     * @param client - The client instance.
+     */
+    constructor(client) {
+        super(client);
+        this.cache = new LRUCache({
+            max: this.client.options.cacheSize ?? 100,
+        });
+    }
+    /**
+     * Fetches a page by its title.
+     * @param title - The title of the page to fetch.
+     * @returns A Promise that resolves to the fetched Page.
+     * @throws {Error} If no page data is found.
+     */
+    async fetch(title) {
+        const key = `page:${title}`;
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const res = await this.client.requestManager.get({
+            action: "query",
+            prop: "extracts|revisions|categories",
+            exintro: true,
+            explaintext: true,
+            rvprop: "content",
+            cllimit: "max",
+            redirects: true,
+            titles: title,
+            format: "json",
+        });
+        const pages = res?.query?.pages;
+        const firstPage = pages ? Object.values(pages)[0] : undefined;
+        if (!firstPage)
+            throw new Error("No page data");
+        const normalizedTitle = firstPage.title;
+        const redirectInfo = res?.query?.redirects;
+        const redirectTarget = redirectInfo?.length
+            ? redirectInfo[redirectInfo.length - 1]?.to
+            : undefined;
+        const fallbackTitle = redirectTarget ?? normalizedTitle ?? title;
+        let extract = typeof firstPage.extract === "string"
+            ? firstPage.extract.trim()
+            : undefined;
+        if (!extract) {
+            try {
+                const details = await this.client.requestManager.get({
+                    titles: fallbackTitle,
+                    abstract: DEFAULT_ABSTRACT_LENGTH,
+                }, { apiPath: ARTICLES_DETAILS_PATH });
+                const items = details?.items;
+                const firstItem = items ? Object.values(items)[0] : undefined;
+                const abstract = firstItem && typeof firstItem.abstract === "string"
+                    ? firstItem.abstract.trim()
+                    : undefined;
+                if (abstract) {
+                    extract = abstract;
+                }
+            }
+            catch {
+                // ignore fallback errors so we can still return basic page info
+            }
+        }
+        const pageSummary = {
+            pageid: firstPage.pageid,
+            ns: firstPage.ns,
+            title: fallbackTitle,
+            extract,
+            revisions: firstPage.revisions,
+            categories: firstPage.categories,
+        };
+        this.client.events.emit("pageFetched", pageSummary);
+        const page = new Page(this.client, pageSummary);
+        this.cache.set(key, page);
+        return page;
+    }
+}

package/dist/managers/revision-manager.d.ts

@@ -0,0 +1,32 @@
+import { BaseManager } from "./base-manager.js";
+import { Revision } from "../structures/revision-structure.js";
+import type { Client } from "../client/client.js";
+/**
+ * Manager for handling revision-related operations.
+ */
+export declare class RevisionManager extends BaseManager {
+    /**
+     * Cache for storing fetched revisions.
+     * @private
+     */
+    private cache;
+    /**
+     * Creates a new instance of the RevisionManager.
+     * @param client - The client instance.
+     */
+    constructor(client: Client);
+    /**
+     * Fetches a revision by its ID.
+     * @param id - The ID of the revision to fetch.
+     * @returns A Promise that resolves to the fetched Revision.
+     * @throws {Error} If the revision is not found.
+     */
+    fetch(id: number): Promise<Revision>;
+    /**
+     * Fetches recent changes from the wiki.
+     * @param limit - The maximum number of recent changes to fetch. Defaults to 10.
+     * @returns A Promise that resolves to an array of Revision objects representing the recent changes.
+     */
+    fetchRecent(limit?: number): Promise<Revision[]>;
+}
+//# sourceMappingURL=revision-manager.d.ts.map

package/dist/managers/revision-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-manager.d.ts","sourceRoot":"","sources":["../../src/managers/revision-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C;;;OAGG;IACH,OAAO,CAAC,KAAK,CAA6B;IAE1C;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAO1B;;;;;OAKG;IACU,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA0BjD;;;;OAIG;IACU,WAAW,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAyBlE"}

package/dist/managers/revision-manager.js

@@ -0,0 +1,69 @@
+import { BaseManager } from "./base-manager.js";
+import { Revision } from "../structures/revision-structure.js";
+import { LRUCache } from "lru-cache";
+/**
+ * Manager for handling revision-related operations.
+ */
+export class RevisionManager extends BaseManager {
+    /**
+     * Creates a new instance of the RevisionManager.
+     * @param client - The client instance.
+     */
+    constructor(client) {
+        super(client);
+        this.cache = new LRUCache({
+            max: this.client.options.cacheSize ?? 100,
+        });
+    }
+    /**
+     * Fetches a revision by its ID.
+     * @param id - The ID of the revision to fetch.
+     * @returns A Promise that resolves to the fetched Revision.
+     * @throws {Error} If the revision is not found.
+     */
+    async fetch(id) {
+        const cached = this.cache.get(id);
+        if (cached)
+            return cached;
+        const res = await this.client.requestManager.get({
+            action: "query",
+            prop: "revisions",
+            revids: id,
+            rvprop: "ids|timestamp|user|comment|content",
+            format: "json",
+        });
+        const pages = res?.query?.pages;
+        const firstPage = pages ? Object.values(pages)[0] : undefined;
+        const revisions = firstPage?.revisions;
+        const revisionData = revisions ? revisions[0] : undefined;
+        if (!revisionData)
+            throw new Error(`Revision ${id} not found`);
+        const revision = new Revision(this.client, revisionData);
+        this.cache.set(id, revision);
+        return revision;
+    }
+    /**
+     * Fetches recent changes from the wiki.
+     * @param limit - The maximum number of recent changes to fetch. Defaults to 10.
+     * @returns A Promise that resolves to an array of Revision objects representing the recent changes.
+     */
+    async fetchRecent(limit = 10) {
+        const res = await this.client.requestManager.get({
+            action: "query",
+            list: "recentchanges",
+            rcprop: "ids|timestamp|user|comment|title",
+            rclimit: limit,
+            format: "json",
+        });
+        const changes = res?.query?.recentchanges;
+        if (!changes)
+            return [];
+        return changes.map((data) => new Revision(this.client, {
+            revid: data.revid,
+            timestamp: data.timestamp,
+            user: data.user,
+            comment: data.comment,
+            title: data.title,
+        }));
+    }
+}

package/dist/managers/search-manager.d.ts

@@ -0,0 +1,14 @@
+import { BaseManager } from "./base-manager.js";
+/**
+ * Manager for handling search operations.
+ */
+export declare class SearchManager extends BaseManager {
+    /**
+     * Searches the wiki for pages matching the query.
+     * @param query - The search query.
+     * @param limit - The maximum number of results to return. Defaults to 10.
+     * @returns A Promise that resolves to an array of page titles matching the query.
+     */
+    search(query: string, limit?: number): Promise<string[]>;
+}
+//# sourceMappingURL=search-manager.d.ts.map

package/dist/managers/search-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-manager.d.ts","sourceRoot":"","sources":["../../src/managers/search-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C;;;;;OAKG;IACU,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAe1E"}

package/dist/managers/search-manager.js

@@ -0,0 +1,24 @@
+import { BaseManager } from "./base-manager.js";
+/**
+ * Manager for handling search operations.
+ */
+export class SearchManager extends BaseManager {
+    /**
+     * Searches the wiki for pages matching the query.
+     * @param query - The search query.
+     * @param limit - The maximum number of results to return. Defaults to 10.
+     * @returns A Promise that resolves to an array of page titles matching the query.
+     */
+    async search(query, limit = 10) {
+        const res = await this.client.requestManager.get({
+            action: "query",
+            list: "search",
+            srsearch: query,
+            srlimit: limit,
+            format: "json",
+        });
+        if (!res?.query?.search)
+            return [];
+        return res.query.search.map((item) => item.title);
+    }
+}

package/dist/managers/user-manager.d.ts

@@ -0,0 +1,34 @@
+import { BaseManager } from "./base-manager.js";
+import { User } from "../structures/user-structure.js";
+import type { Client } from "../client/client.js";
+import type { UserContribution } from "../types/index.js";
+/**
+ * Manager for handling user-related operations.
+ */
+export declare class UserManager extends BaseManager {
+    /**
+     * Cache for storing fetched users.
+     * @private
+     */
+    private cache;
+    /**
+     * Creates a new instance of the UserManager.
+     * @param client - The client instance.
+     */
+    constructor(client: Client);
+    /**
+     * Fetches a user by their username or ID.
+     * @param usernameOrID - The username or ID of the user to fetch.
+     * @returns A Promise that resolves to the fetched User.
+     * @throws {Error} If the user is not found.
+     */
+    fetch(usernameOrID: string | number): Promise<User>;
+    /**
+     * Fetches contributions for a specific user.
+     * @param username - The username to fetch contributions for.
+     * @param limit - The maximum number of contributions to fetch. Defaults to 10.
+     * @returns A Promise that resolves to an array of UserContribution objects.
+     */
+    fetchContributions(username: string, limit?: number): Promise<UserContribution[]>;
+}
+//# sourceMappingURL=user-manager.d.ts.map

package/dist/managers/user-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-manager.d.ts","sourceRoot":"","sources":["../../src/managers/user-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAyB;IAEtC;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAO1B;;;;;OAKG;IACU,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiChE;;;;;OAKG;IACU,kBAAkB,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAa/B"}

package/dist/managers/user-manager.js

@@ -0,0 +1,66 @@
+import { BaseManager } from "./base-manager.js";
+import { User } from "../structures/user-structure.js";
+import { LRUCache } from "lru-cache";
+/**
+ * Manager for handling user-related operations.
+ */
+export class UserManager extends BaseManager {
+    /**
+     * Creates a new instance of the UserManager.
+     * @param client - The client instance.
+     */
+    constructor(client) {
+        super(client);
+        this.cache = new LRUCache({
+            max: this.client.options.cacheSize ?? 100,
+        });
+    }
+    /**
+     * Fetches a user by their username or ID.
+     * @param usernameOrID - The username or ID of the user to fetch.
+     * @returns A Promise that resolves to the fetched User.
+     * @throws {Error} If the user is not found.
+     */
+    async fetch(usernameOrID) {
+        const key = `user:${usernameOrID}`;
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const params = {
+            action: "query",
+            list: "users",
+            usprop: "groups|registration",
+            format: "json",
+        };
+        if (typeof usernameOrID === "number") {
+            params.usids = usernameOrID;
+        }
+        else {
+            params.ususers = usernameOrID;
+        }
+        const res = await this.client.requestManager.get(params);
+        const user = res?.query?.users?.[0];
+        if (!user || "missing" in user) {
+            throw new Error("User not found");
+        }
+        const userObj = new User(this.client, user);
+        this.cache.set(key, userObj);
+        return userObj;
+    }
+    /**
+     * Fetches contributions for a specific user.
+     * @param username - The username to fetch contributions for.
+     * @param limit - The maximum number of contributions to fetch. Defaults to 10.
+     * @returns A Promise that resolves to an array of UserContribution objects.
+     */
+    async fetchContributions(username, limit = 10) {
+        const res = await this.client.requestManager.get({
+            action: "query",
+            list: "usercontribs",
+            ucuser: username,
+            uclimit: limit,
+            format: "json",
+        });
+        return res?.query?.usercontribs || [];
+    }
+}

package/dist/package-constants.d.ts

@@ -0,0 +1,5 @@
+export declare const USER_AGENT = "fandom.js/0.1.0 (https://github.com/fandomdevs/fandom.js)";
+export declare const DEFAULT_API_PATH = "/api.php";
+export declare const ARTICLES_DETAILS_PATH = "/api/v1/Articles/Details";
+export declare const DEFAULT_ABSTRACT_LENGTH = 500;
+//# sourceMappingURL=package-constants.d.ts.map

package/dist/package-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-constants.d.ts","sourceRoot":"","sources":["../src/package-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,8DAA8D,CAAC;AACtF,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAChE,eAAO,MAAM,uBAAuB,MAAM,CAAC"}

package/dist/package-constants.js

@@ -0,0 +1,4 @@
+export const USER_AGENT = `fandom.js/0.1.0 (https://github.com/fandomdevs/fandom.js)`;
+export const DEFAULT_API_PATH = "/api.php";
+export const ARTICLES_DETAILS_PATH = "/api/v1/Articles/Details";
+export const DEFAULT_ABSTRACT_LENGTH = 500;

package/dist/request/rate-limiter.d.ts

@@ -0,0 +1,13 @@
+export declare class RateLimiter {
+    private tokens;
+    private last;
+    private capacity;
+    private refillRatePerMs;
+    constructor({ capacity, refillPerSecond }?: {
+        capacity?: number | undefined;
+        refillPerSecond?: number | undefined;
+    });
+    private refill;
+    removeTokens(n?: number): Promise<void>;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/request/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/request/rate-limiter.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAS;gBAEpB,EAAE,QAAY,EAAE,eAAmB,EAAE;;;KAAK;IAOtD,OAAO,CAAC,MAAM;IAUD,YAAY,CAAC,CAAC,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAWhD"}

package/dist/request/rate-limiter.js

@@ -0,0 +1,28 @@
+export class RateLimiter {
+    constructor({ capacity = 5, refillPerSecond = 1 } = {}) {
+        this.capacity = capacity;
+        this.tokens = capacity;
+        this.last = Date.now();
+        this.refillRatePerMs = refillPerSecond / 1000;
+    }
+    refill() {
+        const now = Date.now();
+        const dt = now - this.last;
+        const add = dt * this.refillRatePerMs;
+        if (add > 0) {
+            this.tokens = Math.min(this.capacity, this.tokens + add);
+            this.last = now;
+        }
+    }
+    async removeTokens(n = 1) {
+        while (true) {
+            this.refill();
+            if (this.tokens >= n) {
+                this.tokens -= n;
+                return;
+            }
+            // sleep a bit
+            await new Promise((r) => setTimeout(r, 50));
+        }
+    }
+}