oceanic.js 1.10.3-dev.c6c9f52 → 1.10.3-dev.ca8b6e8

package/dist/lib/util/SimpleCollection.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/** @module SimpleCollection */
+const Collection_1 = tslib_1.__importDefault(require("./Collection"));
+/** This is an internal class, you should not use it in your projects. If you want a collection type for your own projects, look at {@link Collection}. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+class SimpleCollection extends Collection_1.default {
+    conversionFunc;
+    key;
+    onDuplicate;
+    limit;
+    constructor(conversionFunc, limit = Infinity, onDuplicate = "throw", key) {
+        super();
+        this.limit = limit;
+        Object.defineProperties(this, {
+            conversionFunc: { value: conversionFunc, enumerable: false },
+            key: { value: key ?? "id", enumerable: false },
+            onDuplicate: { value: onDuplicate, enumerable: false }
+        });
+    }
+    add(value) {
+        if (this.key in value) {
+            if (this.limit === 0) {
+                return value;
+            }
+            if (this.has(value[this.key])) {
+                switch (this.onDuplicate) {
+                    case "merge": {
+                        value = { ...this.get(value[this.key]), ...value };
+                        break;
+                    }
+                    // we don't have the raw data, so we can't update
+                    case "update":
+                    case "throw": {
+                        const err = new Error(`${this.constructor.name}#add: duplicate ${this.key} ${value[this.key]}`);
+                        Object.defineProperty(err, "_object", { value });
+                        throw err;
+                    }
+                }
+            }
+            this.set(value[this.key], value);
+            if (this.limit && this.size > this.limit) {
+                const iter = this.keys();
+                while (this.size > this.limit) {
+                    this.delete(iter.next().value);
+                }
+            }
+            return value;
+        }
+        else {
+            const err = new Error(`${this.constructor.name}#add: value must have a ${this.key} property`);
+            Object.defineProperty(err, "_object", { value });
+            throw err;
+        }
+    }
+    update(value) {
+        if (this.key in value) {
+            if (this.has(value[this.key]) && this.onDuplicate === "update") {
+                const obj = this.get(value[this.key]);
+                if ("update" in obj && typeof obj.update === "function") {
+                    obj.update(value);
+                    return obj;
+                }
+                else {
+                    const err = new Error(`${this.constructor.name}#update: existing object for ${value[this.key]} does not have an update method`);
+                    Object.defineProperty(err, "_object", { value });
+                    throw err;
+                }
+            }
+            return this.add(this.conversionFunc(value));
+        }
+        else {
+            const err = new Error(`${this.constructor.name}#update: value must have a ${this.key} property`);
+            Object.defineProperty(err, "_object", { value });
+            throw err;
+        }
+    }
+}
+exports.default = SimpleCollection;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiU2ltcGxlQ29sbGVjdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL2xpYi91dGlsL1NpbXBsZUNvbGxlY3Rpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsK0JBQStCO0FBQy9CLHNFQUFzQztBQUV0QywwSkFBMEo7QUFDMUosOERBQThEO0FBQzlELE1BQXFCLGdCQUFzSixTQUFRLG9CQUFnQjtJQUN2TCxjQUFjLENBQWtCO0lBQzlCLEdBQUcsQ0FBTztJQUNWLFdBQVcsQ0FBNEM7SUFDakUsS0FBSyxDQUFTO0lBQ2QsWUFBWSxjQUE4QixFQUFFLEtBQUssR0FBRyxRQUFRLEVBQUUsY0FBd0QsT0FBTyxFQUFFLEdBQVM7UUFDcEksS0FBSyxFQUFFLENBQUM7UUFDUixJQUFJLENBQUMsS0FBSyxHQUFHLEtBQUssQ0FBQztRQUNuQixNQUFNLENBQUMsZ0JBQWdCLENBQUMsSUFBSSxFQUFFO1lBQzFCLGNBQWMsRUFBRSxFQUFFLEtBQUssRUFBRSxjQUFjLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRTtZQUM1RCxHQUFHLEVBQWEsRUFBRSxLQUFLLEVBQUUsR0FBRyxJQUFJLElBQUksRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFO1lBQ3pELFdBQVcsRUFBSyxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRTtTQUM1RCxDQUFDLENBQUM7SUFDUCxDQUFDO0lBRUQsR0FBRyxDQUFjLEtBQVE7UUFDckIsSUFBSSxJQUFJLENBQUMsR0FBRyxJQUFJLEtBQUssRUFBRSxDQUFDO1lBQ3BCLElBQUksSUFBSSxDQUFDLEtBQUssS0FBSyxDQUFDLEVBQUUsQ0FBQztnQkFDbkIsT0FBTyxLQUFLLENBQUM7WUFDakIsQ0FBQztZQUNELElBQUksSUFBSSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDNUIsUUFBUSxJQUFJLENBQUMs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

package/dist/lib/util/TypedCollection.d.ts

@@ -0,0 +1,24 @@
+/** @module TypedCollection */
+import Collection from "./Collection";
+import type Client from "../Client";
+import Base from "../structures/Base";
+import type { AnyClass } from "../types/misc";
+export interface ExtraOptions<M extends Record<string, any>, C extends Base, E extends Array<unknown> = []> {
+    construct?(this: void, data: M, ...extra: E): C;
+    delete?(this: void, key: string): void;
+}
+/** This is an internal class, you should not use it in your projects. If you want a collection type for your own projects, look at {@link Collection}. */
+export default class TypedCollection<M extends Record<string, any>, C extends Base, E extends Array<unknown> = []> extends Collection<string, C> {
+    private _baseObject;
+    extraOptions: Required<ExtraOptions<M, C, E>>;
+    limit: number;
+    constructor(baseObject: AnyClass<M, C, E>, client: Client, limit?: number, extraOptions?: ExtraOptions<M, C, E>);
+    /** @hidden */
+    add<T extends C>(value: T): T;
+    clear(): void;
+    delete(key: string): boolean;
+    /** @hidden */
+    update(value: C | Partial<M> & {
+        id?: string;
+    }, ...extra: E): C;
+}

package/dist/lib/util/TypedCollection.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/** @module TypedCollection */
+const Collection_1 = tslib_1.__importDefault(require("./Collection"));
+const Base_1 = tslib_1.__importDefault(require("../structures/Base"));
+/** This is an internal class, you should not use it in your projects. If you want a collection type for your own projects, look at {@link Collection}. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+class TypedCollection extends Collection_1.default {
+    _baseObject;
+    extraOptions;
+    limit;
+    constructor(baseObject, client, limit = Infinity, extraOptions) {
+        super();
+        if (!(baseObject.prototype instanceof Base_1.default)) {
+            throw new TypeError("baseObject must be a class that extends Base.");
+        }
+        this._baseObject = baseObject;
+        this.limit = limit;
+        this.extraOptions = {
+            construct: extraOptions?.construct ?? ((data, ...extra) => new baseObject(data, client, ...extra)),
+            delete: extraOptions?.delete ?? (() => { })
+        };
+    }
+    /** @hidden */
+    add(value) {
+        if ("id" in value) {
+            if (this.limit === 0) {
+                return value;
+            }
+            this.set(value.id, value);
+            if (this.limit && this.size > this.limit) {
+                const iter = this.keys();
+                while (this.size > this.limit) {
+                    this.delete(iter.next().value);
+                }
+            }
+            return value;
+        }
+        else {
+            const err = new Error(`${this.constructor.name}#add: value must have an id property`);
+            Object.defineProperty(err, "_object", { value });
+            throw err;
+        }
+    }
+    clear() {
+        for (const key of this.keys()) {
+            this.extraOptions.delete(key);
+        }
+        super.clear();
+    }
+    delete(key) {
+        this.extraOptions.delete(key);
+        return super.delete(key);
+    }
+    /** @hidden */
+    update(value, ...extra) {
+        if (value instanceof this._baseObject) {
+            if ("update" in value) {
+                value["update"].call(value, value);
+            }
+            return value;
+        }
+        // if the object does not have a direct id, we're forced to construct a whole new object
+        let item = "id" in value && value.id ? this.get(value.id) : undefined;
+        if (!item) {
+            item = this.add(this.extraOptions.construct(value, ...extra));
+        }
+        else if ("update" in item) {
+            item["update"].call(item, value);
+        }
+        return item;
+    }
+}
+exports.default = TypedCollection;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVHlwZWRDb2xsZWN0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vbGliL3V0aWwvVHlwZWRDb2xsZWN0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDhCQUE4QjtBQUM5QixzRUFBc0M7QUFFdEMsc0VBQXNDO0FBU3RDLDBKQUEwSjtBQUMxSiw4REFBOEQ7QUFDOUQsTUFBcUIsZUFBOEYsU0FBUSxvQkFBcUI7SUFDcEksV0FBVyxDQUFvQjtJQUN2QyxZQUFZLENBQWtDO0lBQzlDLEtBQUssQ0FBUztJQUNkLFlBQVksVUFBNkIsRUFBRSxNQUFjLEVBQUUsS0FBSyxHQUFHLFFBQVEsRUFBRSxZQUFvQztRQUM3RyxLQUFLLEVBQUUsQ0FBQztRQUNSLElBQUksQ0FBQyxDQUFDLFVBQVUsQ0FBQyxTQUFTLFlBQVksY0FBSSxDQUFDLEVBQUUsQ0FBQztZQUMxQyxNQUFNLElBQUksU0FBUyxDQUFDLCtDQUErQyxDQUFDLENBQUM7UUFDekUsQ0FBQztRQUNELElBQUksQ0FBQyxXQUFXLEdBQUcsVUFBVSxDQUFDO1FBQzlCLElBQUksQ0FBQyxLQUFLLEdBQUcsS0FBSyxDQUFDO1FBQ25CLElBQUksQ0FBQyxZQUFZLEdBQUc7WUFDaEIsU0FBUyxFQUFFLFlBQVksRUFBRSxTQUFTLElBQUksQ0FBQyxDQUFDLElBQUksRUFBRSxHQUFHLEtBQUssRUFBSyxFQUFFLENBQUMsSUFBSSxVQUFVLENBQUMsSUFBSSxFQUFFLE1BQU0sRUFBRSxHQUFHLEtBQUssQ0FBQyxDQUFDO1lBQ3JHLE1BQU0sRUFBSyxZQUFZLEVBQUUsTUFBTSxJQUFJLENBQUMsR0FBUyxFQUFFLEdBQUUsQ0FBQyxDQUFDO1NBQ3RELENBQUM7SUFDTixDQUFDO0lBRUQsY0FBYztJQUNkLEdBQUcsQ0FBYyxLQUFRO1FBQ3JCLElBQUksSUFBSSxJQUFJLEtBQUssRUFBRSxDQUFDO1lBQ2hCLElBQUksSUFBSSxDQUFDLEtBQUssS0FBSyxDQUFDLEVBQUUsQ0FB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

package/dist/lib/util/TypedEmitter.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="node" />
+import EventEmitter from "node:events";
+declare interface TypedEmitter<Events extends Record<string | symbol, any>> extends EventEmitter {
+    addListener<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    emit<K extends keyof Events>(eventName: K, ...args: Events[K]): boolean;
+    listenerCount(eventName: keyof Events): number;
+    listeners(eventName: keyof Events): Array<Function>;
+    off<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    on<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    once<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    prependListener<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    prependOnceListener<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    rawListeners(eventName: keyof Events): Array<Function>;
+    removeAllListeners(event?: keyof Events): this;
+    removeListener<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+}
+declare class TypedEmitter<Events extends Record<string | symbol, any>> extends EventEmitter {
+}
+export default TypedEmitter;

package/dist/lib/util/TypedEmitter.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/** @module TypedEmitter */
+const Errors_1 = require("./Errors");
+const node_events_1 = tslib_1.__importDefault(require("node:events"));
+class TypedEmitter extends node_events_1.default {
+    emit(eventName, ...args) {
+        if (this.listenerCount(eventName) === 0) {
+            if (eventName === "error") {
+                throw new Errors_1.UncaughtError(args[0]);
+            }
+            return false;
+        }
+        return super.emit(eventName, ...args);
+    }
+}
+exports.default = TypedEmitter;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVHlwZWRFbWl0dGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vbGliL3V0aWwvVHlwZWRFbWl0dGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDJCQUEyQjtBQUMzQixxQ0FBeUM7QUFDekMsc0VBQXVDO0FBbUJ2QyxNQUFNLFlBQTBELFNBQVEscUJBQVk7SUFDdkUsSUFBSSxDQUF5QixTQUFZLEVBQUUsR0FBRyxJQUFlO1FBQ2xFLElBQUksSUFBSSxDQUFDLGFBQWEsQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUN0QyxJQUFJLFNBQVMsS0FBSyxPQUFPLEVBQUUsQ0FBQztnQkFDeEIsTUFBTSxJQUFJLHNCQUFhLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDckMsQ0FBQztZQUNELE9BQU8sS0FBSyxDQUFDO1FBQ2pCLENBQUM7UUFDRCxPQUFPLEtBQUssQ0FBQyxJQUFJLENBQUMsU0FBbUIsRUFBRSxHQUFHLElBQWtCLENBQUMsQ0FBQztJQUNsRSxDQUFDO0NBQ0o7QUFFRCxrQkFBZSxZQUFZLENBQUMifQ==

package/dist/lib/util/Util.d.ts

@@ -0,0 +1,58 @@
+/// <reference types="node" />
+import type Client from "../Client";
+import { type ImageFormat, type PrivilegedIntentNames } from "../Constants";
+import type { AllowedMentions, AnyChannel, AnyThreadChannel, Component, Embed, EmbedOptions, MessageActionRow, ModalActionRow, RawAllowedMentions, RawChannel, RawComponent, RawEmbed, RawEmbedOptions, RawMessageActionRow, RawModalActionRow, RawThreadChannel, ToComponentFromRaw, ToRawFromComponent } from "../types/channels";
+import type { RawMember, RawSticker, RESTMember, Sticker } from "../types/guilds";
+import type { ApplicationCommandOptions, RawApplicationCommandOption } from "../types/applications";
+import Member from "../structures/Member";
+import type { AnyTextableChannel, CollectionLimitsOptions, GuildEmoji, ModalSubmitComponentsActionRow, RawGuildEmoji, RawMessage, RawModalSubmitComponents, RawModalSubmitComponentsActionRow, ToModalSubmitComponentFromRaw, Uncached, RawBaseEntitlement } from "../types";
+import Message from "../structures/Message";
+import Entitlement from "../structures/Entitlement";
+import TestEntitlement from "../structures/TestEntitlement";
+import type Poll from "../structures/Poll";
+/** A general set of utilities. These are intentionally poorly documented, as they serve almost no usefulness to outside developers. */
+export default class Util {
+    private _client;
+    constructor(client: Client);
+    static rawEmbeds(embeds: RawEmbed): Embed;
+    static rawEmbeds(embeds: Array<RawEmbed>): Array<Embed>;
+    static rawMessageComponents(components: RawMessageActionRow): MessageActionRow;
+    static rawMessageComponents(components: Array<RawMessageActionRow>): Array<MessageActionRow>;
+    static rawModalComponents(components: RawModalActionRow): ModalActionRow;
+    static rawModalComponents(components: Array<RawModalActionRow>): Array<ModalActionRow>;
+    /** @hidden intentionally not documented - this is an internal function */
+    _convertImage(image: Buffer | string, name: string): string;
+    /** @hidden intended for internal use only */
+    _getLimit(name: Exclude<keyof CollectionLimitsOptions, "users">, id?: string): number;
+    _setLimit(values?: Record<string, number> | number, defaultValue?: number): Record<string, number> | number;
+    componentToParsed<T extends RawComponent>(component: T): ToComponentFromRaw<T>;
+    componentToRaw<T extends Component>(component: T): ToRawFromComponent<T>;
+    componentsToParsed<T extends RawModalActionRow | RawMessageActionRow>(components: Array<T>): T extends RawModalActionRow ? Array<ModalActionRow> : T extends RawMessageActionRow ? Array<MessageActionRow> : never;
+    componentsToRaw<T extends ModalActionRow | MessageActionRow>(components: Array<T>): T extends ModalActionRow ? Array<RawModalActionRow> : T extends MessageActionRow ? Array<RawMessageActionRow> : never;
+    convertEmoji(raw: RawGuildEmoji): GuildEmoji;
+    convertImage(img: Buffer | string): string;
+    convertSticker(raw: RawSticker): Sticker;
+    detectMissingPrivilegedIntents(intents?: number): Promise<Array<PrivilegedIntentNames>>;
+    embedsToParsed(embeds: Array<RawEmbed>): Array<Embed>;
+    embedsToRaw(embeds: Array<EmbedOptions>): Array<RawEmbedOptions>;
+    formatAllowedMentions(allowed?: AllowedMentions | null): RawAllowedMentions;
+    formatImage(url: string, format?: ImageFormat, size?: number): string;
+    getMagic(file: Buffer, len?: number): string;
+    modalSubmitComponentToParsed<T extends RawModalSubmitComponents>(component: T): ToModalSubmitComponentFromRaw<T>;
+    modalSubmitComponentsToParsed<T extends RawModalSubmitComponentsActionRow>(components: Array<T>): Array<ModalSubmitComponentsActionRow>;
+    optionToParsed(option: RawApplicationCommandOption): ApplicationCommandOptions;
+    optionToRaw(option: ApplicationCommandOptions): RawApplicationCommandOption;
+    /** @internal */
+    replacePollAnswer(poll: Poll, answerID: number, count: number, users?: Array<string>): void;
+    updateChannel<T extends AnyChannel>(channelData: RawChannel): T;
+    /** @internal */
+    updateEntitlement<T extends Entitlement | TestEntitlement = Entitlement | TestEntitlement>(data: RawBaseEntitlement): T;
+    /** @internal */
+    updateMember(guildID: string, memberID: string, member: RawMember | RESTMember): Member;
+    /** @internal */
+    updateMessage<T extends AnyTextableChannel | Uncached>(data: RawMessage): Message<T>;
+    /** @internal */
+    updatePollAnswer(poll: Poll, answerID: number, count: number, user?: string): void;
+    /** @internal */
+    updateThread<T extends AnyThreadChannel>(threadData: RawThreadChannel): T;
+}