@elara-services/packages 5.3.1 → 6.0.0

package/dist/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "@elara-services/packages",
+    "version": "6.0.0",
+    "description": "",
+    "main": "./dist/src/index.js",
+    "author": "SUPERCHIEFYT (Elara-Discord-Bots, Elara-Services)",
+    "license": "ISC",
+    "scripts": {
+        "build": "rm -rf dist && rm -rf docs && tsc && npx typedoc src/index.ts",
+        "pub": "npm run build && npm publish",
+        "lint": "eslint .",
+        "prettier:format": "prettier --write src/**/*.ts",
+        "prettier:check": "prettier --check src/**/*.ts"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/elara-bots/npm/tree/main/packages"
+    },
+    "files": [
+        "dist",
+        "docs"
+    ],
+    "devDependencies": {
+        "@types/node": "20.3.0",
+        "@types/node-schedule": "2.1.0",
+        "@typescript-eslint/eslint-plugin": "5.59.9",
+        "@typescript-eslint/parser": "5.59.9",
+        "dotenv": "16.1.4",
+        "eslint": "8.42.0",
+        "nodemon": "2.0.22",
+        "prettier": "3.0.0",
+        "ts-node": "10.9.1",
+        "typedoc": "0.24.8",
+        "typescript": "5.1.3"
+    },
+    "optionalDependencies": {
+        "@elara-services/fetch": "2.0.1",
+        "node-schedule": "2.1.1"
+    },
+    "dependencies": {
+        "@elara-services/utils": "1.2.14",
+        "discord-api-types": "0.37.48"
+    }
+}

package/dist/src/index.d.ts

@@ -0,0 +1 @@
+export * from "./lib";

package/dist/src/index.js

@@ -0,0 +1,17 @@
+"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("./lib"), exports);

package/dist/src/interfaces/discord.d.ts

@@ -0,0 +1,91 @@
+import { APIModalActionRowComponent, APISelectMenuOption, ComponentType } from "discord-api-types/v10";
+export type ButtonStyles = 'PRIMARY' | 'BLURPLE' | 'SECONDARY' | 'GREY' | 'SUCCESS' | 'GREEN' | 'DANGER' | 'RED' | 'LINK' | 'URL';
+export type ButtonNumberStyles = 1 | 2 | 3 | 4 | 5;
+export interface ButtonOptions {
+    type?: number;
+    style?: ButtonNumberStyles | ButtonStyles;
+    emoji?: {
+        name?: string | null;
+        id?: string | null;
+        animated?: boolean;
+    };
+    disabled?: boolean;
+    id?: string;
+    title?: string;
+    custom_id?: string;
+    label?: string;
+    url?: string;
+}
+export interface SelectOptions {
+    id?: string;
+    custom_id?: string;
+    holder?: string;
+    placeholder?: string;
+    min?: number;
+    max?: number;
+    max_values?: number;
+    min_values?: number;
+    type?: ComponentType.ChannelSelect | ComponentType.MentionableSelect | ComponentType.RoleSelect | ComponentType.StringSelect | ComponentType.UserSelect;
+    disabled?: boolean;
+    options?: APISelectMenuOption[];
+}
+export interface ModalOptions {
+    title?: string;
+    label?: string;
+    custom_id?: string;
+    id?: string;
+    components: {
+        type: 1 | ComponentType.ActionRow;
+        components: APIModalActionRowComponent[];
+    }[];
+}
+export interface TextInputOptions {
+    type?: ComponentType.TextInput | 4;
+    id?: string;
+    custom_id?: string;
+    title?: string;
+    label?: string;
+    style?: 1 | 2;
+    min?: number;
+    max?: number;
+    max_length?: number;
+    min_length?: number;
+    placeholder?: string;
+    holder?: string;
+    required?: boolean;
+    value?: string;
+}
+export interface Slash {
+    type?: number;
+    dm_permission?: boolean;
+    dmPermission?: boolean;
+    defaultMemberPermissions?: string;
+    default_member_permissions?: string;
+    options?: unknown[];
+    locale?: {
+        names?: Record<string, string>;
+        descriptions?: Record<string, string>;
+    };
+}
+export type ChannelTypes = 'GUILD_TEXT' | 'DM' | 'GUILD_VOICE' | 'GROUP_DM' | 'GUILD_CATEGORY' | 'GUILD_NEWS' | 'GUILD_STORE' | 'GUILD_NEWS_THREAD' | 'GUILD_PUBLIC_THREAD' | 'GUILD_PRIVATE_THREAD' | 'GUILD_STAGE_VOICE';
+export interface SlashOptions {
+    type: number;
+    name: string;
+    description: string;
+    required?: boolean;
+    channel_types?: ChannelTypes[];
+    autocomplete?: boolean;
+    min_value?: number;
+    max_value?: number;
+    min_length?: number;
+    max_length?: number;
+    choices?: {
+        name: string;
+        value: string;
+    }[];
+    options?: SlashOptions[];
+    locale?: {
+        names?: Record<string, string>;
+        descriptions?: Record<string, string>;
+    };
+}

package/dist/src/interfaces/discord.js

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

package/dist/src/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from "./discord";

package/dist/src/interfaces/index.js

@@ -0,0 +1,17 @@
+"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("./discord"), exports);

package/dist/src/lib/AES.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="node" />
+export declare class AES {
+    private key;
+    constructor(key: string);
+    encrypt(input: string | Buffer): string | Buffer;
+    decrypt(encrypted: string | Buffer): string | Buffer;
+}

package/dist/src/lib/AES.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AES = void 0;
+const utils_1 = require("@elara-services/utils");
+const crypto_1 = require("crypto");
+const package_json_1 = require("../../package.json");
+const header = `[${package_json_1.name}, v${package_json_1.version}]: [AES]`;
+class AES {
+    constructor(key) {
+        if (!utils_1.is.string(key)) {
+            throw new Error(`${header} You didn't include a key in the constructor.`);
+        }
+        this.key = key;
+    }
+    encrypt(input) {
+        const isString = utils_1.is.string(input);
+        const isBuffer = Buffer.isBuffer(input);
+        if (!(isString || isBuffer) || (isString && !input) || (isBuffer && !Buffer.byteLength(input))) {
+            throw new Error(`${header} Provided invalid 'input', must be a non-empty string or buffer.`);
+        }
+        const sha = (0, crypto_1.createHash)("sha256");
+        sha.update(this.key);
+        const iv = (0, crypto_1.randomBytes)(16);
+        const cipher = (0, crypto_1.createCipheriv)("aes-256-ctr", sha.digest(), iv);
+        let buffer = input;
+        if (isString) {
+            buffer = Buffer.from(input);
+        }
+        const text = cipher.update(buffer);
+        let encrypted = Buffer.concat([iv, text, cipher.final()]);
+        if (isString) {
+            encrypted = encrypted.toString('base64');
+        }
+        return encrypted;
+    }
+    decrypt(encrypted) {
+        const isString = utils_1.is.string(encrypted);
+        const isBuffer = Buffer.isBuffer(encrypted);
+        if (!(isString || isBuffer) || (isString && !encrypted) || (isBuffer && !Buffer.byteLength(encrypted))) {
+            throw new Error(`${header} Provided "encrypted" must be a non-empty string or buffer`);
+        }
+        const sha256 = (0, crypto_1.createHash)('sha256');
+        sha256.update(this.key);
+        let input = encrypted;
+        if (isString) {
+            // @ts-expect-error
+            input = Buffer.from(encrypted, 'base64');
+            if (input.length < 17) {
+                throw new Error(`${header} Provided "encrypted" must decrypt to a non-empty string or buffer`);
+            }
+        }
+        else {
+            if (Buffer.byteLength(encrypted) < 17) {
+                throw new Error(`${header} Provided "encrypted" must decrypt to a non-empty string or buffer`);
+            }
+        }
+        const decipher = (0, crypto_1.createDecipheriv)("aes-256-ctr", sha256.digest(), input.slice(0, 16));
+        const ciphertext = input.slice(16);
+        let output;
+        if (isString) {
+            // @ts-expect-error
+            output = decipher.update(ciphertext) + decipher.final();
+        }
+        else {
+            // @ts-expect-error
+            output = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+        }
+        return output;
+    }
+}
+exports.AES = AES;

package/dist/src/lib/discord.d.ts

@@ -0,0 +1,136 @@
+import { ComponentType } from "discord-api-types/v10";
+import type { ButtonOptions, ModalOptions, SelectOptions, Slash, SlashOptions, TextInputOptions } from "../interfaces";
+export declare const ButtonStyle: {
+    PRIMARY: number;
+    BLURPLE: number;
+    SECONDARY: number;
+    GREY: number;
+    SUCCESS: number;
+    GREEN: number;
+    DANGER: number;
+    RED: number;
+    LINK: number;
+    URL: number;
+};
+export declare const Interactions: {
+    button: (options?: ButtonOptions) => {
+        custom_id: string;
+        label: string;
+        type: number;
+        style: 1 | 2 | 3 | 4 | 5;
+        disabled: boolean;
+        emoji: {
+            name?: string | null | undefined;
+            id?: string | null | undefined;
+            animated?: boolean | undefined;
+        } | undefined;
+        url: string | undefined;
+    };
+    select: (options?: SelectOptions) => {
+        custom_id: string;
+        placeholder: string;
+        min_values: number;
+        max_values: number;
+        options: never[];
+        type: number;
+        disabled: boolean;
+    };
+    modal: (options?: ModalOptions) => {
+        custom_id: string;
+        title: string;
+        components: {
+            type: 1 | ComponentType.ActionRow;
+            components: import("discord-api-types/v10").APITextInputComponent[];
+        }[];
+    };
+    textInput: (options?: TextInputOptions, row?: boolean) => {
+        type: number;
+        custom_id: string;
+        style: number;
+        label: string;
+        min_length: number;
+        max_length: number;
+        placeholder: string;
+        value: string;
+        required: boolean;
+    } | {
+        type: number;
+        components: {
+            type: number;
+            custom_id: string;
+            style: number;
+            label: string;
+            min_length: number;
+            max_length: number;
+            placeholder: string;
+            value: string;
+            required: boolean;
+        }[];
+    };
+};
+export declare const Duration: {
+    parse: (value: string) => number | null;
+    determineTimeType: (str: string) => number;
+    validate: (value: string) => boolean;
+    timeIds: Set<string>;
+};
+export declare const SlashBuilder: {
+    TEXT_BASED_CHANNELS: number[];
+    types: {
+        sub_command: number;
+        sub_group: number;
+        string: number;
+        integer: number;
+        boolean: number;
+        user: number;
+        channel: number;
+        role: number;
+        mentionable: number;
+        number: number;
+        context: {
+            user: number;
+            message: number;
+        };
+    };
+    context: {
+        user: (name: string, options: object) => {
+            name: string;
+            description: string;
+            name_localizations: Record<string, string> | undefined;
+            description_localizations: Record<string, string> | undefined;
+            options: unknown[];
+            type: number;
+            dm_permission: boolean;
+            default_member_permissions: string;
+        };
+        message: (name: string, options: object) => {
+            name: string;
+            description: string;
+            name_localizations: Record<string, string> | undefined;
+            description_localizations: Record<string, string> | undefined;
+            options: unknown[];
+            type: number;
+            dm_permission: boolean;
+            default_member_permissions: string;
+        };
+    };
+    choice: (name: string, value: string, name_localizations: Record<string, string>) => {
+        name: string;
+        value: string;
+        name_localizations: Record<string, string>;
+    };
+    option: (data: SlashOptions) => SlashOptions & {
+        name_localizations: Record<string, string>;
+        description_localizations: Record<string, string>;
+    };
+    create: (name: string, description: string, options?: Slash) => {
+        name: string;
+        description: string;
+        name_localizations: Record<string, string> | undefined;
+        description_localizations: Record<string, string> | undefined;
+        options: unknown[];
+        type: number;
+        dm_permission: boolean;
+        default_member_permissions: string;
+    };
+};