seyfert 0.1.0

package/lib/builders/SelectMenu.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringSelectOption = exports.StringSelectMenu = exports.ChannelSelectMenu = exports.MentionableSelectMenu = exports.RoleSelectMenu = exports.UserSelectMenu = exports.SelectMenu = void 0;
+const common_1 = require("../common");
+const Base_1 = require("./Base");
+/**
+ * Maps default values for Select Menus.
+ * @template T - The type of SelectMenuDefaultValueType.
+ * @param ids - The IDs of items to be mapped as default.
+ * @param type - The type of default values.
+ * @returns An array of default values.
+ */
+function mappedDefault(ids, type) {
+    return (0, common_1.fastMap)((0, common_1.fastFlat)(ids), id => ({ id, type }));
+}
+/**
+ * Represents a base class for building Select Menus.
+ * @template Select - The type of APISelectMenuComponent.
+ * @template Interaction - The type of interaction.
+ * @example
+ * const selectMenu = new SelectMenu<APIUserSelectComponent, UserSelectMenuInteraction>();
+ * selectMenu.setCustomId("user-select-menu");
+ * selectMenu.setPlaceholder("Select a user");
+ * selectMenu.run((interaction) => {
+ *   // Handle select menu interaction
+ * });
+ */
+class SelectMenu extends Base_1.BaseComponentBuilder {
+    /** @internal */
+    __exec;
+    /**
+     * Sets the custom ID for the select menu.
+     * @param id - The custom ID for the select menu.
+     * @returns The current SelectMenu instance.
+     */
+    setCustomId(id) {
+        this.data.custom_id = id;
+        return this;
+    }
+    /**
+     * Sets the placeholder text for the select menu.
+     * @param placeholder - The placeholder text.
+     * @returns The current SelectMenu instance.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder;
+        return this;
+    }
+    /**
+     * Sets the maximum and minimum number of selected values for the select menu.
+     * @param options - The maximum and minimum values.
+     * @returns The current SelectMenu instance.
+     */
+    setValuesLength({ max, min }) {
+        this.data.max_values = max;
+        this.data.min_values = min;
+        return this;
+    }
+    /**
+     * Sets whether the select menu is disabled.
+     *  [disabled=true] - Indicates whether the select menu is disabled.
+     * @returns The current SelectMenu instance.
+     */
+    setDisabled(disabled = true) {
+        this.data.disabled = disabled;
+        return this;
+    }
+    /**
+     * Sets the callback function to be executed when the select menu is interacted with.
+     *  func - The callback function.
+     * @returns The current SelectMenu instance.
+     */
+    run(func) {
+        this.__exec = func;
+        return this;
+    }
+}
+exports.SelectMenu = SelectMenu;
+/**
+ * Represents a Select Menu for selecting users.
+ * @example
+ * const userSelectMenu = new UserSelectMenu();
+ * userSelectMenu.setCustomId("user-select");
+ * userSelectMenu.addDefaultUsers("123456789", "987654321");
+ */
+class UserSelectMenu extends SelectMenu {
+    constructor(data = {}) {
+        super({ ...data, type: common_1.ComponentType.UserSelect });
+    }
+    /**
+     * Adds default selected users to the select menu.
+     * @param users - User IDs to be added as default.
+     * @returns The current UserSelectMenu instance.
+     */
+    addDefaultUsers(...users) {
+        this.data.default_values = (this.data.default_values ?? []).concat(mappedDefault(users, common_1.SelectMenuDefaultValueType.User));
+        return this;
+    }
+    /**
+     * Sets the default selected users for the select menu.
+     * @param users - User IDs to be set as default.
+     * @returns The current UserSelectMenu instance.
+     */
+    setDefaultUsers(...users) {
+        this.data.default_values = mappedDefault(users, common_1.SelectMenuDefaultValueType.User);
+        return this;
+    }
+}
+exports.UserSelectMenu = UserSelectMenu;
+/**
+ * Represents a Select Menu for selecting roles.
+ * @example
+ * const roleSelectMenu = new RoleSelectMenu();
+ * roleSelectMenu.setCustomId("role-select");
+ * roleSelectMenu.addDefaultRoles("123456789", "987654321");
+ */
+class RoleSelectMenu extends SelectMenu {
+    constructor(data = {}) {
+        super({ ...data, type: common_1.ComponentType.RoleSelect });
+    }
+    /**
+     * Adds default selected roles to the select menu.
+     * @param roles - Role IDs to be added as default.
+     * @returns The current RoleSelectMenu instance.
+     */
+    addDefaultRoles(...roles) {
+        this.data.default_values = (this.data.default_values ?? []).concat(mappedDefault(roles, common_1.SelectMenuDefaultValueType.Role));
+        return this;
+    }
+    /**
+     * Sets the default selected roles for the select menu.
+     * @param roles - Role IDs to be set as default.
+     * @returns The current RoleSelectMenu instance.
+     */
+    setDefaultRoles(...roles) {
+        this.data.default_values = mappedDefault(roles, common_1.SelectMenuDefaultValueType.Role);
+        return this;
+    }
+}
+exports.RoleSelectMenu = RoleSelectMenu;
+/**
+ * Represents a Select Menu for selecting mentionable entities.
+ * @example
+ * const mentionableSelectMenu = new MentionableSelectMenu();
+ * mentionableSelectMenu.setCustomId("mentionable-select");
+ */
+class MentionableSelectMenu extends SelectMenu {
+    constructor(data = {}) {
+        super({ ...data, type: common_1.ComponentType.MentionableSelect });
+    }
+}
+exports.MentionableSelectMenu = MentionableSelectMenu;
+/**
+ * Represents a Select Menu for selecting channels.
+ * @example
+ * const channelSelectMenu = new ChannelSelectMenu();
+ * channelSelectMenu.setCustomId("channel-select");
+ * channelSelectMenu.addDefaultChannels("123456789", "987654321");
+ * channelSelectMenu.setChannelTypes([ChannelType.GuildText, ChannelType.GuildVoice]);
+ */
+class ChannelSelectMenu extends SelectMenu {
+    constructor(data = {}) {
+        super({ ...data, type: common_1.ComponentType.ChannelSelect });
+    }
+    /**
+     * Adds default selected channels to the select menu.
+     * @param channels - Channel IDs to be added as default.
+     * @returns The current ChannelSelectMenu instance.
+     */
+    addDefaultChannels(...channels) {
+        this.data.default_values = (this.data.default_values ?? []).concat(mappedDefault(channels, common_1.SelectMenuDefaultValueType.Channel));
+        return this;
+    }
+    /**
+     * Sets the default selected channels for the select menu.
+     * @param channels - Channel IDs to be set as default.
+     * @returns The current ChannelSelectMenu instance.
+     */
+    setDefaultChannels(...channels) {
+        this.data.default_values = mappedDefault(channels, common_1.SelectMenuDefaultValueType.Channel);
+        return this;
+    }
+    /**
+     * Sets the types of channels that can be selected in the menu.
+     *  types - The types of channels.
+     * @returns The current ChannelSelectMenu instance.
+     */
+    setChannelTypes(types) {
+        this.data.channel_types = types;
+        return this;
+    }
+}
+exports.ChannelSelectMenu = ChannelSelectMenu;
+/**
+ * Represents a Select Menu for selecting string options.
+ * @example
+ * const stringSelectMenu = new StringSelectMenu();
+ * stringSelectMenu.setCustomId("string-select");
+ * stringSelectMenu.addOption(new StringSelectOption().setLabel("Option 1").setValue("option_1"));
+ * stringSelectMenu.setOptions([
+ *   { label: "Option 2", value: "option_2" },
+ *   { label: "Option 3", value: "option_3" },
+ * ]);
+ */
+class StringSelectMenu extends SelectMenu {
+    constructor(data = {}) {
+        super({ ...data, type: common_1.ComponentType.StringSelect });
+    }
+    /**
+     * Adds options to the string select menu.
+     * @param {...RestOrArray<APISelectMenuOption>} options - Options to be added.
+     * @returns The current StringSelectMenu instance.
+     */
+    addOption(...options) {
+        this.data.options ??= [];
+        this.data.options = this.data.options.concat((0, common_1.fastFlat)(options));
+        return this;
+    }
+    /**
+     * Sets the options for the string select menu.
+     *  options - Options to be set.
+     * @returns The current StringSelectMenu instance.
+     */
+    setOptions(options) {
+        this.data.options = options;
+        return this;
+    }
+}
+exports.StringSelectMenu = StringSelectMenu;
+/**
+ * Represents an individual option for a string select menu.
+ * @example
+ * const option = new StringSelectOption().setLabel("Option 1").setValue("option_1");
+ */
+class StringSelectOption {
+    data;
+    constructor(data = {}) {
+        this.data = data;
+    }
+    /**
+     * Sets the label for the option.
+     *  label - The label for the option.
+     * @returns The current StringSelectOption instance.
+     */
+    setLabel(label) {
+        this.data.label = label;
+        return this;
+    }
+    /**
+     * Sets the value for the option.
+     *  value - The value for the option.
+     * @returns The current StringSelectOption instance.
+     */
+    setValue(value) {
+        this.data.value = value;
+        return this;
+    }
+    /**
+     * Sets the description for the option.
+     *  description - The description for the option.
+     * @returns The current StringSelectOption instance.
+     */
+    setDescription(description) {
+        this.data.description = description;
+        return this;
+    }
+    /**
+     * Sets whether the option is the default.
+     *  [Default=true] - Indicates whether the option is the default.
+     * @returns The current StringSelectOption instance.
+     */
+    setDefault(Default = true) {
+        this.data.default = Default;
+        return this;
+    }
+    /**
+     * Sets the emoji for the option.
+     *  emoji - The emoji for the option.
+     * @returns The current StringSelectOption instance.
+     */
+    setEmoji(emoji) {
+        this.data.emoji = emoji;
+        return this;
+    }
+    /**
+     * Converts the option to JSON format.
+     * @returns The option data in JSON format.
+     */
+    toJSON() {
+        return { ...this.data };
+    }
+}
+exports.StringSelectOption = StringSelectOption;

package/lib/builders/index.d.ts

@@ -0,0 +1,12 @@
+import { type APIActionRowComponent, type APIActionRowComponentTypes } from '../common';
+import { ActionRow } from './ActionRow';
+import type { BuilderComponents } from './types';
+export * from './ActionRow';
+export * from './Attachment';
+export * from './Base';
+export * from './Button';
+export * from './MessageEmbed';
+export * from './Modal';
+export * from './SelectMenu';
+export * from './types';
+export declare function fromComponent(data: BuilderComponents | APIActionRowComponentTypes | APIActionRowComponent<APIActionRowComponentTypes> | ActionRow<BuilderComponents>): BuilderComponents | ActionRow<BuilderComponents>;

package/lib/builders/index.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromComponent = void 0;
+const common_1 = require("../common");
+const ActionRow_1 = require("./ActionRow");
+const Button_1 = require("./Button");
+const Modal_1 = require("./Modal");
+const SelectMenu_1 = require("./SelectMenu");
+__exportStar(require("./ActionRow"), exports);
+__exportStar(require("./Attachment"), exports);
+__exportStar(require("./Base"), exports);
+__exportStar(require("./Button"), exports);
+__exportStar(require("./MessageEmbed"), exports);
+__exportStar(require("./Modal"), exports);
+__exportStar(require("./SelectMenu"), exports);
+__exportStar(require("./types"), exports);
+function fromComponent(data) {
+    if ('toJSON' in data) {
+        return data;
+    }
+    switch (data.type) {
+        case common_1.ComponentType.Button:
+            return new Button_1.Button(data);
+        case common_1.ComponentType.StringSelect:
+            return new SelectMenu_1.StringSelectMenu(data);
+        case common_1.ComponentType.TextInput:
+            return new Modal_1.TextInput(data);
+        case common_1.ComponentType.UserSelect:
+            return new SelectMenu_1.UserSelectMenu(data);
+        case common_1.ComponentType.RoleSelect:
+            return new SelectMenu_1.RoleSelectMenu(data);
+        case common_1.ComponentType.MentionableSelect:
+            return new SelectMenu_1.MentionableSelectMenu(data);
+        case common_1.ComponentType.ChannelSelect:
+            return new SelectMenu_1.ChannelSelectMenu(data);
+        case common_1.ComponentType.ActionRow:
+            return new ActionRow_1.ActionRow(data);
+    }
+}
+exports.fromComponent = fromComponent;

package/lib/builders/types.d.ts

@@ -0,0 +1,21 @@
+import type { ComponentInteraction, ModalSubmitInteraction } from '../structures/Interaction';
+import type { Button } from './Button';
+import type { TextInput } from './Modal';
+import type { BuilderSelectMenus } from './SelectMenu';
+export type ComponentCallback<T = ComponentInteraction> = (interaction: T, stop: ComponentStopCallback, refresh: ComponentRefreshCallback) => any;
+export type ComponentFilterCallback<T = ComponentInteraction> = (interaction: T) => any;
+export type ComponentStopCallback = (reason?: string, refresh?: ComponentRefreshCallback) => any;
+export type ComponentRefreshCallback = () => any;
+export type ModalSubmitCallback<T = ModalSubmitInteraction> = (interaction: T) => any;
+export type ButtonLink = Omit<Button, 'setCustomId'>;
+export type ButtonID = Omit<Button, 'setURL'>;
+export type MessageBuilderComponents = FixedComponents<Button> | BuilderSelectMenus;
+export type ModalBuilderComponents = TextInput;
+export type BuilderComponents = MessageBuilderComponents | TextInput;
+export type FixedComponents<T = Button> = T extends Button ? ButtonLink | ButtonID : T;
+export interface ListenerOptions {
+    timeout?: number;
+    idle?: number;
+    filter?: ComponentFilterCallback;
+    onStop?: ComponentStopCallback;
+}

package/lib/builders/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cache/adapters/default.d.ts

@@ -0,0 +1,24 @@
+import type { Adapter } from './types';
+export declare class MemoryAdapter implements Adapter {
+    readonly storage: Map<string, string>;
+    readonly relationships: Map<string, string[]>;
+    scan(query: string, keys?: false): any[];
+    scan(query: string, keys: true): string[];
+    get(keys: string): any;
+    get(keys: string[]): any[];
+    set(keys: string, data: any): void;
+    set(keys: [string, any][]): void;
+    patch(updateOnly: boolean, keys: string, data: any): void;
+    patch(updateOnly: boolean, keys: [string, any][]): void;
+    values(to: string): any[];
+    keys(to: string): string[];
+    count(to: string): number;
+    remove(keys: string): void;
+    remove(keys: string[]): void;
+    contains(to: string, keys: string): boolean;
+    getToRelationship(to: string): string[];
+    bulkAddToRelationShip(data: Record<string, string[]>): void;
+    addToRelationship(to: string, keys: string | string[]): void;
+    removeToRelationship(to: string, keys: string | string[]): void;
+    removeRelationship(to: string | string[]): void;
+}

package/lib/cache/adapters/default.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryAdapter = void 0;
+class MemoryAdapter {
+    storage = new Map();
+    relationships = new Map();
+    scan(query, keys = false) {
+        const values = [];
+        const sq = query.split('.');
+        for (const [key, value] of this.storage.entries()) {
+            if (key.split('.').every((value, i) => (sq[i] === '*' ? !!value : sq[i] === value))) {
+                values.push(keys ? key : JSON.parse(value));
+            }
+        }
+        return values;
+    }
+    get(keys) {
+        if (!Array.isArray(keys)) {
+            const data = this.storage.get(keys);
+            return data ? JSON.parse(data) : null;
+        }
+        return keys
+            .map(x => {
+            const data = this.storage.get(x);
+            return data ? JSON.parse(data) : null;
+        })
+            .filter(x => x);
+    }
+    set(keys, data) {
+        if (Array.isArray(keys)) {
+            for (const [key, value] of keys) {
+                this.storage.set(key, JSON.stringify(value));
+            }
+        }
+        else {
+            this.storage.set(keys, JSON.stringify(data));
+        }
+    }
+    patch(updateOnly, keys, data) {
+        if (Array.isArray(keys)) {
+            for (const [key, value] of keys) {
+                const oldData = this.get(key);
+                if (updateOnly && !oldData) {
+                    continue;
+                }
+                this.storage.set(key, JSON.stringify({ ...(oldData ?? {}), ...value }));
+            }
+        }
+        else {
+            const oldData = this.get(keys);
+            if (updateOnly && !oldData) {
+                return;
+            }
+            this.storage.set(keys, JSON.stringify({ ...(oldData ?? {}), ...data }));
+        }
+    }
+    values(to) {
+        const array = [];
+        const data = this.keys(to);
+        for (const key of data) {
+            const content = this.get(key);
+            if (content) {
+                array.push(content);
+            }
+        }
+        return array;
+    }
+    keys(to) {
+        return this.getToRelationship(to).map(id => `${to}.${id}`);
+    }
+    count(to) {
+        return this.getToRelationship(to).length;
+    }
+    remove(keys) {
+        for (const i of Array.isArray(keys) ? keys : [keys]) {
+            this.storage.delete(i);
+        }
+    }
+    contains(to, keys) {
+        return this.getToRelationship(to).includes(keys);
+    }
+    getToRelationship(to) {
+        return this.relationships.get(to) || [];
+    }
+    bulkAddToRelationShip(data) {
+        for (const i in data) {
+            this.addToRelationship(i, data[i]);
+        }
+    }
+    addToRelationship(to, keys) {
+        if (!this.relationships.has(to)) {
+            this.relationships.set(to, []);
+        }
+        const data = this.getToRelationship(to);
+        for (const key of Array.isArray(keys) ? keys : [keys]) {
+            if (!data.includes(key)) {
+                data.push(key);
+            }
+        }
+    }
+    removeToRelationship(to, keys) {
+        const data = this.getToRelationship(to);
+        if (data) {
+            for (const key of Array.isArray(keys) ? keys : [keys]) {
+                const idx = data.indexOf(key);
+                if (idx !== -1) {
+                    data.splice(idx, 1);
+                }
+            }
+        }
+    }
+    removeRelationship(to) {
+        for (const i of Array.isArray(to) ? to : [to]) {
+            this.relationships.delete(i);
+        }
+    }
+}
+exports.MemoryAdapter = MemoryAdapter;

package/lib/cache/adapters/index.d.ts

@@ -0,0 +1,4 @@
+export * from './default';
+export * from './redis';
+export * from './types';
+export * from './workeradapter';

package/lib/cache/adapters/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./default"), exports);
+__exportStar(require("./redis"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./workeradapter"), exports);

package/lib/cache/adapters/redis.d.ts

@@ -0,0 +1,35 @@
+import type { RedisOptions } from 'ioredis';
+import { Redis } from 'ioredis';
+import type { Adapter } from './types';
+interface RedisAdapterOptions {
+    namespace?: string;
+}
+export declare class RedisAdapter implements Adapter {
+    client: Redis;
+    namespace: string;
+    constructor(data: ({
+        client: Redis;
+    } | {
+        redisOptions: RedisOptions;
+    }) & RedisAdapterOptions);
+    scan(query: string, returnKeys?: false): Promise<any[]>;
+    scan(query: string, returnKeys: true): Promise<string[]>;
+    get(keys: string[]): Promise<any[]>;
+    get(keys: string): Promise<any>;
+    set(id: [string, any][]): Promise<void>;
+    set(id: string, data: any): Promise<void>;
+    patch(updateOnly: boolean, id: [string, any][]): Promise<void>;
+    patch(updateOnly: boolean, id: string, data: any): Promise<void>;
+    values(to: string): Promise<any[]>;
+    keys(to: string): Promise<string[]>;
+    count(to: string): Promise<number>;
+    remove(keys: string | string[]): Promise<void>;
+    contains(to: string, keys: string): Promise<boolean>;
+    getToRelationship(to: string): Promise<string[]>;
+    bulkAddToRelationShip(data: Record<string, string[]>): Promise<void>;
+    addToRelationship(to: string, keys: string | string[]): Promise<void>;
+    removeToRelationship(to: string, keys: string | string[]): Promise<void>;
+    removeRelationship(to: string | string[]): Promise<void>;
+    protected buildKey(key: string): string;
+}
+export {};