fandom.js 1.0.0 → 1.1.0

package/dist/request/request-manager.d.ts

@@ -0,0 +1,29 @@
+import type { QueryParams, APIResponse } from "../types/index.js";
+import { TokenType } from "../enums/index.js";
+export interface RequestManagerOptions {
+    baseURL: string;
+    apiPath?: string;
+    userAgent?: string;
+    maxRetries?: number;
+}
+export declare class RequestManager {
+    private baseURL;
+    private apiPath;
+    private userAgent?;
+    private maxRetries;
+    private limiter;
+    private tokenCache;
+    private cookies;
+    constructor(opt: RequestManagerOptions);
+    private buildURL;
+    get<T = APIResponse>(params: QueryParams, options?: {
+        apiPath?: string;
+    }): Promise<T>;
+    post<T = APIResponse>(params: QueryParams, options?: {
+        apiPath?: string;
+        tokenType?: TokenType;
+    }): Promise<T>;
+    fetchToken(type: TokenType): Promise<string>;
+    private request;
+}
+//# sourceMappingURL=request-manager.d.ts.map

package/dist/request/request-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-manager.d.ts","sourceRoot":"","sources":["../../src/request/request-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,OAAO,CAAgB;gBAEnB,GAAG,EAAE,qBAAqB;IAQtC,OAAO,CAAC,QAAQ;IAaH,GAAG,CAAC,CAAC,GAAG,WAAW,EAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,CAAC,CAAC;IAKA,IAAI,CAAC,CAAC,GAAG,WAAW,EAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE,GACpD,OAAO,CAAC,CAAC,CAAC;IAyBA,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;YAmB3C,OAAO;CAwCtB"}

package/dist/request/request-manager.js

@@ -0,0 +1,106 @@
+import fetch from "cross-fetch";
+import { RateLimiter } from "./rate-limiter.js";
+import { APIError } from "../errors/api-error.js";
+export class RequestManager {
+    constructor(opt) {
+        this.tokenCache = new Map();
+        this.cookies = [];
+        this.baseURL = opt.baseURL;
+        this.apiPath = opt.apiPath ?? "/api.php";
+        this.userAgent = opt.userAgent;
+        this.maxRetries = opt.maxRetries ?? 3;
+        this.limiter = new RateLimiter({ capacity: 5, refillPerSecond: 1 });
+    }
+    buildURL(params, apiPath) {
+        const url = new URL(apiPath ?? this.apiPath, this.baseURL);
+        Object.entries(params).forEach(([k, v]) => {
+            if (v === undefined)
+                return;
+            if (Array.isArray(v)) {
+                v.forEach((item) => url.searchParams.append(k, String(item)));
+            }
+            else {
+                url.searchParams.set(k, String(v));
+            }
+        });
+        return url.toString();
+    }
+    async get(params, options) {
+        const url = this.buildURL(params, options?.apiPath);
+        return this.request(url, { method: "GET" });
+    }
+    async post(params, options) {
+        const body = new URLSearchParams();
+        if (options?.tokenType) {
+            const token = await this.fetchToken(options.tokenType);
+            body.append("token", token);
+        }
+        Object.entries(params).forEach(([k, v]) => {
+            if (v === undefined)
+                return;
+            if (Array.isArray(v)) {
+                v.forEach((item) => body.append(k, String(item)));
+            }
+            else {
+                body.append(k, String(v));
+            }
+        });
+        const url = this.buildURL({}, options?.apiPath);
+        return this.request(url, {
+            method: "POST",
+            body,
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        });
+    }
+    async fetchToken(type) {
+        if (this.tokenCache.has(type))
+            return this.tokenCache.get(type);
+        const res = await this.get({
+            action: "query",
+            meta: "tokens",
+            type: type,
+            format: "json",
+        });
+        const token = res?.query?.tokens?.[`${type}token`];
+        if (!token)
+            throw new Error(`Failed to fetch token of type ${type}`);
+        this.tokenCache.set(type, token);
+        return token;
+    }
+    async request(url, init, attempt = 0) {
+        await this.limiter.removeTokens(1);
+        const headers = new Headers(init.headers);
+        if (this.userAgent)
+            headers.set("User-Agent", this.userAgent);
+        if (this.cookies.length > 0)
+            headers.set("Cookie", this.cookies.join("; "));
+        try {
+            const res = await fetch(url, { ...init, headers });
+            const setCookie = res.headers.get("set-cookie");
+            if (setCookie) {
+                this.cookies.push(setCookie);
+            }
+            if (!res.ok) {
+                if (attempt < this.maxRetries) {
+                    const backoff = 2 ** attempt * 200;
+                    await new Promise((r) => setTimeout(r, backoff));
+                    return this.request(url, init, attempt + 1);
+                }
+                throw new Error(`HTTP ${res.status} ${res.statusText}`);
+            }
+            const data = await res.json();
+            if (data.error) {
+                throw new APIError(data.error.code, data.error.info);
+            }
+            return data;
+        }
+        catch (err) {
+            if (attempt < this.maxRetries) {
+                const backoff = 2 ** attempt * 200;
+                await new Promise((r) => setTimeout(r, backoff));
+                return this.request(url, init, attempt + 1);
+            }
+            throw err;
+        }
+    }
+}

package/dist/structures/base-structure.d.ts

@@ -0,0 +1,24 @@
+import type { Client } from "../client/client.js";
+/**
+ * The base structure class that all other structures extend.
+ * @template T - The type of data this structure holds.
+ */
+export declare abstract class BaseStructure<T = unknown> {
+    /**
+     * The client that instantiated this structure.
+     */
+    client: Client;
+    /**
+     * Creates a new instance of the BaseStructure.
+     * @param client - The client instance.
+     */
+    constructor(client: Client);
+    /**
+     * Patches the structure with new data.
+     * @param data - The data to patch with.
+     * @returns The updated structure.
+     * @internal
+     */
+    abstract _patch(data: T): this;
+}
+//# sourceMappingURL=base-structure.d.ts.map

package/dist/structures/base-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-structure.d.ts","sourceRoot":"","sources":["../../src/structures/base-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;GAGG;AACH,8BAAsB,aAAa,CAAC,CAAC,GAAG,OAAO;IAC7C;;OAEG;IACI,MAAM,EAAE,MAAM,CAAC;IAEtB;;;OAGG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;OAKG;aACa,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;CACtC"}

package/dist/structures/base-structure.js

@@ -0,0 +1,13 @@
+/**
+ * The base structure class that all other structures extend.
+ * @template T - The type of data this structure holds.
+ */
+export class BaseStructure {
+    /**
+     * Creates a new instance of the BaseStructure.
+     * @param client - The client instance.
+     */
+    constructor(client) {
+        this.client = client;
+    }
+}

package/dist/structures/page-structure.d.ts

@@ -0,0 +1,81 @@
+import { BaseStructure } from "./base-structure.js";
+import type { Client } from "../client/client.js";
+import { ProtectionLevel } from "../enums/index.js";
+import { Revision } from "./revision-structure.js";
+import type { APIPage } from "../types/index.js";
+/**
+ * Represents a wiki page.
+ */
+export declare class Page extends BaseStructure<Partial<APIPage>> {
+    /**
+     * The ID of the page.
+     */
+    pageid: number;
+    /**
+     * The namespace ID of the page.
+     */
+    ns: number;
+    /**
+     * The title of the page.
+     */
+    title: string;
+    /**
+     * The extract (summary) of the page.
+     */
+    extract?: string;
+    /**
+     * The content of the page.
+     */
+    content?: string;
+    /**
+     * The categories the page belongs to.
+     */
+    categories: string[];
+    /**
+     * Creates a new instance of the Page.
+     * @param client - The client instance.
+     * @param data - The data to initialize the page with.
+     */
+    constructor(client: Client, data: Partial<APIPage>);
+    /**
+     * Patches the page with new data.
+     * @param data - The data to patch with.
+     * @returns The updated page.
+     * @internal
+     */
+    _patch(data: Partial<APIPage>): this;
+    /**
+     * Edits the page content.
+     * @param text - The new content of the page.
+     * @param summary - The edit summary.
+     * @returns A Promise that resolves to the updated Page.
+     */
+    edit(text: string, summary?: string): Promise<Page>;
+    /**
+     * Deletes the page.
+     * @param reason - The reason for deletion.
+     * @returns A Promise that resolves when the page is deleted.
+     */
+    delete(reason?: string): Promise<void>;
+    /**
+     * Protects the page.
+     * @param level - The protection level.
+     * @param expiry - The expiry time for the protection.
+     * @param reason - The reason for protection.
+     * @returns A Promise that resolves when the page is protected.
+     */
+    protect(level: ProtectionLevel, expiry: string, reason?: string): Promise<void>;
+    /**
+     * Fetches the revision history of the page.
+     * @returns A Promise that resolves to an array of Revision objects.
+     */
+    fetchHistory(): Promise<Revision[]>;
+    /**
+     * Reverts the page to a specific revision.
+     * @param revid - The revision ID to revert to.
+     * @param summary - The edit summary.
+     * @returns A Promise that resolves to the updated Page.
+     */
+    revertTo(revid: number, summary?: string): Promise<Page>;
+}
+//# sourceMappingURL=page-structure.d.ts.map

package/dist/structures/page-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-structure.d.ts","sourceRoot":"","sources":["../../src/structures/page-structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAa,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,EACV,OAAO,EAIR,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,qBAAa,IAAK,SAAQ,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD;;OAEG;IACI,MAAM,EAAG,MAAM,CAAC;IACvB;;OAEG;IACI,EAAE,EAAG,MAAM,CAAC;IACnB;;OAEG;IACI,KAAK,EAAG,MAAM,CAAC;IACtB;;OAEG;IACI,OAAO,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACI,OAAO,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACI,UAAU,EAAE,MAAM,EAAE,CAAM;IAEjC;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC;IAKlD;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAyB3C;;;;;OAKG;IACU,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAehE;;;;OAIG;IACU,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAanD;;;;;;OAMG;IACU,OAAO,CAClB,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAehB;;;OAGG;IACU,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAuBhD;;;;;OAKG;IACU,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BtE"}

package/dist/structures/page-structure.js

@@ -0,0 +1,164 @@
+import { BaseStructure } from "./base-structure.js";
+import { TokenType } from "../enums/index.js";
+import { Revision } from "./revision-structure.js";
+/**
+ * Represents a wiki page.
+ */
+export class Page extends BaseStructure {
+    /**
+     * Creates a new instance of the Page.
+     * @param client - The client instance.
+     * @param data - The data to initialize the page with.
+     */
+    constructor(client, data) {
+        super(client);
+        /**
+         * The categories the page belongs to.
+         */
+        this.categories = [];
+        this._patch(data);
+    }
+    /**
+     * Patches the page with new data.
+     * @param data - The data to patch with.
+     * @returns The updated page.
+     * @internal
+     */
+    _patch(data) {
+        if (data.pageid !== undefined)
+            this.pageid = data.pageid;
+        if (data.ns !== undefined)
+            this.ns = data.ns;
+        if (data.title !== undefined)
+            this.title = data.title;
+        if (data.extract !== undefined)
+            this.extract = data.extract;
+        if (data.revisions &&
+            Array.isArray(data.revisions) &&
+            data.revisions.length > 0) {
+            const rev = data.revisions[0];
+            if (rev["*"])
+                this.content = rev["*"];
+            else if (rev.slots) {
+                const main = rev.slots.main || rev.slots.Main;
+                if (main && main["*"])
+                    this.content = main["*"];
+            }
+        }
+        if (data.categories && Array.isArray(data.categories)) {
+            this.categories = data.categories.map((c) => c.title);
+        }
+        return this;
+    }
+    /**
+     * Edits the page content.
+     * @param text - The new content of the page.
+     * @param summary - The edit summary.
+     * @returns A Promise that resolves to the updated Page.
+     */
+    async edit(text, summary) {
+        const params = {
+            action: "edit",
+            title: this.title,
+            text: text,
+            format: "json",
+        };
+        if (summary)
+            params.summary = summary;
+        await this.client.requestManager.post(params, {
+            tokenType: TokenType.Csrf,
+        });
+        return this;
+    }
+    /**
+     * Deletes the page.
+     * @param reason - The reason for deletion.
+     * @returns A Promise that resolves when the page is deleted.
+     */
+    async delete(reason) {
+        const params = {
+            action: "delete",
+            title: this.title,
+            format: "json",
+        };
+        if (reason)
+            params.reason = reason;
+        await this.client.requestManager.post(params, {
+            tokenType: TokenType.Csrf,
+        });
+    }
+    /**
+     * Protects the page.
+     * @param level - The protection level.
+     * @param expiry - The expiry time for the protection.
+     * @param reason - The reason for protection.
+     * @returns A Promise that resolves when the page is protected.
+     */
+    async protect(level, expiry, reason) {
+        const params = {
+            action: "protect",
+            title: this.title,
+            protections: `edit=${level}|move=${level}`,
+            expiry: expiry,
+            format: "json",
+        };
+        if (reason)
+            params.reason = reason;
+        await this.client.requestManager.post(params, {
+            tokenType: TokenType.Csrf,
+        });
+    }
+    /**
+     * Fetches the revision history of the page.
+     * @returns A Promise that resolves to an array of Revision objects.
+     */
+    async fetchHistory() {
+        const res = await this.client.requestManager.get({
+            action: "query",
+            prop: "revisions",
+            titles: this.title,
+            rvprop: "ids|timestamp|user|content",
+            rvlimit: 50,
+            format: "json",
+        });
+        const pages = res?.query?.pages || {};
+        const pageId = Object.keys(pages)[0];
+        const page = pages[pageId];
+        if (!page || !page.revisions)
+            return [];
+        return page.revisions.map((rev) => new Revision(this.client, rev));
+    }
+    /**
+     * Reverts the page to a specific revision.
+     * @param revid - The revision ID to revert to.
+     * @param summary - The edit summary.
+     * @returns A Promise that resolves to the updated Page.
+     */
+    async revertTo(revid, summary) {
+        const res = await this.client.requestManager.get({
+            action: "query",
+            prop: "info",
+            titles: this.title,
+            format: "json",
+        });
+        const pages = res?.query?.pages || {};
+        const pageId = Object.keys(pages)[0];
+        const page = pages[pageId];
+        const currentRevid = page.lastrevid;
+        if (currentRevid === revid)
+            return this;
+        const params = {
+            action: "edit",
+            title: this.title,
+            undo: currentRevid,
+            undoafter: revid,
+            format: "json",
+        };
+        if (summary)
+            params.summary = summary;
+        await this.client.requestManager.post(params, {
+            tokenType: TokenType.Csrf,
+        });
+        return this;
+    }
+}

package/dist/structures/revision-structure.d.ts

@@ -0,0 +1,46 @@
+import { BaseStructure } from "./base-structure.js";
+import type { Client } from "../client/client.js";
+import type { APIRevision } from "../types/index.js";
+/**
+ * Represents a revision of a page.
+ */
+export declare class Revision extends BaseStructure<Partial<APIRevision>> {
+    /**
+     * The ID of the revision.
+     */
+    revid: number;
+    /**
+     * The timestamp of the revision.
+     */
+    timestamp: Date;
+    /**
+     * The user who created the revision.
+     */
+    user: string;
+    /**
+     * The content of the revision.
+     */
+    content?: string;
+    /**
+     * The comment associated with the revision.
+     */
+    comment?: string;
+    /**
+     * The title of the page this revision belongs to.
+     */
+    title?: string;
+    /**
+     * Creates a new instance of the Revision.
+     * @param client - The client instance.
+     * @param data - The data to initialize the revision with.
+     */
+    constructor(client: Client, data: Partial<APIRevision>);
+    /**
+     * Patches the revision with new data.
+     * @param data - The data to patch with.
+     * @returns The updated revision.
+     * @internal
+     */
+    _patch(data: Partial<APIRevision>): this;
+}
+//# sourceMappingURL=revision-structure.d.ts.map

package/dist/structures/revision-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-structure.d.ts","sourceRoot":"","sources":["../../src/structures/revision-structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,qBAAa,QAAS,SAAQ,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D;;OAEG;IACI,KAAK,EAAG,MAAM,CAAC;IACtB;;OAEG;IACI,SAAS,EAAG,IAAI,CAAC;IACxB;;OAEG;IACI,IAAI,EAAG,MAAM,CAAC;IACrB;;OAEG;IACI,OAAO,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACI,OAAO,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACI,KAAK,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC;IAKtD;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;CAchD"}

package/dist/structures/revision-structure.js

@@ -0,0 +1,41 @@
+import { BaseStructure } from "./base-structure.js";
+/**
+ * Represents a revision of a page.
+ */
+export class Revision extends BaseStructure {
+    /**
+     * Creates a new instance of the Revision.
+     * @param client - The client instance.
+     * @param data - The data to initialize the revision with.
+     */
+    constructor(client, data) {
+        super(client);
+        this._patch(data);
+    }
+    /**
+     * Patches the revision with new data.
+     * @param data - The data to patch with.
+     * @returns The updated revision.
+     * @internal
+     */
+    _patch(data) {
+        if (data.revid !== undefined)
+            this.revid = data.revid;
+        if (data.timestamp !== undefined)
+            this.timestamp = new Date(data.timestamp);
+        if (data.user !== undefined)
+            this.user = data.user;
+        if (data.comment !== undefined)
+            this.comment = data.comment;
+        if (data.title)
+            this.title = data.title;
+        if (data["*"])
+            this.content = data["*"];
+        else if (data.slots) {
+            const main = data.slots.main || data.slots.Main;
+            if (main && main["*"])
+                this.content = main["*"];
+        }
+        return this;
+    }
+}

package/dist/structures/user-structure.d.ts

@@ -0,0 +1,45 @@
+import { BaseStructure } from "./base-structure.js";
+import type { Client } from "../client/client.js";
+import type { APIUser } from "../types/index.js";
+/**
+ * Represents a wiki user.
+ */
+export declare class User extends BaseStructure<Partial<APIUser>> {
+    /**
+     * The ID of the user.
+     */
+    id: number;
+    /**
+     * The name of the user.
+     */
+    name: string;
+    /**
+     * The registration date of the user.
+     */
+    registrationDate?: Date;
+    /**
+     * The groups the user belongs to.
+     */
+    groups: string[];
+    /**
+     * Creates a new instance of the User.
+     * @param client - The client instance.
+     * @param data - The data to initialize the user with.
+     */
+    constructor(client: Client, data: Partial<APIUser>);
+    /**
+     * Patches the user with new data.
+     * @param data - The data to patch with.
+     * @returns The updated user.
+     * @internal
+     */
+    _patch(data: Partial<APIUser>): this;
+    /**
+     * Blocks the user.
+     * @param expiry - The expiry time for the block.
+     * @param reason - The reason for the block.
+     * @returns A Promise that resolves when the user is blocked.
+     */
+    block(expiry: string, reason: string): Promise<void>;
+}
+//# sourceMappingURL=user-structure.d.ts.map

package/dist/structures/user-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-structure.d.ts","sourceRoot":"","sources":["../../src/structures/user-structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,qBAAa,IAAK,SAAQ,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD;;OAEG;IACI,EAAE,EAAG,MAAM,CAAC;IACnB;;OAEG;IACI,IAAI,EAAG,MAAM,CAAC;IACrB;;OAEG;IACI,gBAAgB,CAAC,EAAE,IAAI,CAAC;IAC/B;;OAEG;IACI,MAAM,EAAE,MAAM,EAAE,CAAM;IAE7B;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC;IAKlD;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAQ3C;;;;;OAKG;IACU,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYlE"}

package/dist/structures/user-structure.js

@@ -0,0 +1,52 @@
+import { BaseStructure } from "./base-structure.js";
+import { TokenType } from "../enums/index.js";
+/**
+ * Represents a wiki user.
+ */
+export class User extends BaseStructure {
+    /**
+     * Creates a new instance of the User.
+     * @param client - The client instance.
+     * @param data - The data to initialize the user with.
+     */
+    constructor(client, data) {
+        super(client);
+        /**
+         * The groups the user belongs to.
+         */
+        this.groups = [];
+        this._patch(data);
+    }
+    /**
+     * Patches the user with new data.
+     * @param data - The data to patch with.
+     * @returns The updated user.
+     * @internal
+     */
+    _patch(data) {
+        if (data.userid !== undefined)
+            this.id = data.userid;
+        if (data.name !== undefined)
+            this.name = data.name;
+        if (data.registration)
+            this.registrationDate = new Date(data.registration);
+        if (data.groups)
+            this.groups = data.groups;
+        return this;
+    }
+    /**
+     * Blocks the user.
+     * @param expiry - The expiry time for the block.
+     * @param reason - The reason for the block.
+     * @returns A Promise that resolves when the user is blocked.
+     */
+    async block(expiry, reason) {
+        await this.client.requestManager.post({
+            action: "block",
+            user: this.name,
+            expiry: expiry,
+            reason: reason,
+            format: "json",
+        }, { tokenType: TokenType.Csrf });
+    }
+}

package/dist/types/api.d.ts

@@ -0,0 +1,14 @@
+export interface QueryParams {
+    [key: string]: string | number | boolean | (string | number | boolean)[] | undefined;
+}
+export interface APIResponse<T = unknown> {
+    batchcomplete?: string;
+    continue?: Record<string, string>;
+    query?: T;
+    error?: {
+        code: string;
+        info: string;
+        [key: string]: unknown;
+    };
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,GAC7B,SAAS,CAAC;CACf;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH"}

package/dist/types/api.js

@@ -0,0 +1 @@
+export {};