@magicyan/discord 1.0.8 → 1.0.10

package/README.md

@@ -92,4 +92,37 @@ new EmbedBuilder({
     author: createEmbedAuthor({ user }),
     description: "My embed description"
 })
+```
+
+Function to find a channel from the guild cache
+```ts
+const { guild } = interaction
+
+const channel = findChannel(guild, ChannelType.GuildVoice).byName("Lounge 01") // VoiceChannel  | undefined
+```
+
+Function to find a role from the guild cache
+```ts
+const { guild } = interaction
+
+const role = findChannel(guild).byName("Administrator") // Role  | undefined
+```
+
+Function to create embed asset
+If the method used to obtain a url returns null or undefined the function will set undefined in the image property
+```ts
+const embed = new EmbedBuilder({
+    image: createEmbedAsset(guild.iconURL()) // { url: guild.iconUrl() } | undefined
+})
+```
+
+When passing an attachment to the function, it will return the url with local attachments
+```ts
+const image = new AttachmentBuilder(buffer, { name: "myImage.png" });
+
+const embed = new EmbedBuilder({
+    image: createEmbedAsset(image) // { url: attachment://myImage.png }
+});
+
+channel.send({ embeds: [embed], files: [image]})
 ```

package/dist/functions/channels.js

@@ -6,10 +6,10 @@ function findChannel(guild, type) {
     const channelType = type || discord_js_1.ChannelType.GuildText;
     return {
         byName(name) {
-            return guild.channels.cache.find(c => c.name === name && c.type === channelType);
+            return guild.channels.cache.find(channel => channel.name === name && channel.type === channelType);
         },
         byId(id) {
-            return guild.channels.cache.find(c => c.id === id && c.type === channelType);
+            return guild.channels.cache.find(channel => channel.id === id && channel.type === channelType);
         }
     };
 }

package/dist/functions/embeds.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createEmbedAuthor = void 0;
+exports.createEmbedAsset = exports.createEmbedAuthor = void 0;
+const discord_js_1 = require("discord.js");
 function createEmbedAuthor(options) {
     const { user, property = "displayName", imageSize: size = 512, iconURL, url, prefix = "", suffix = "" } = options;
     return {
@@ -9,3 +10,10 @@ function createEmbedAuthor(options) {
     };
 }
 exports.createEmbedAuthor = createEmbedAuthor;
+function createEmbedAsset(source, options) {
+    if (source instanceof discord_js_1.Attachment || source instanceof discord_js_1.AttachmentBuilder) {
+        return { url: `attachment://${source.name}`, ...options };
+    }
+    return source ? { url: source, ...options } : undefined;
+}
+exports.createEmbedAsset = createEmbedAsset;

package/dist/index.js

@@ -15,6 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./constants/client"), exports);
-__exportStar(require("./functions/utils"), exports);
+__exportStar(require("./functions/channels"), exports);
 __exportStar(require("./functions/embeds"), exports);
+__exportStar(require("./functions/roles"), exports);
+__exportStar(require("./functions/utils"), exports);
 __exportStar(require("@magicyan/core"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicyan/discord",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "publishConfig": {
     "access": "public"
   },

package/types/functions/embeds.d.ts

@@ -1,4 +1,4 @@
-import type { EmbedAuthorData, ImageURLOptions, User } from "discord.js";
+import { EmbedAuthorData, ImageURLOptions, User, EmbedAssetData, Attachment, AttachmentBuilder } from "discord.js";
 interface CreateEmbedAuthorOptions {
     user: User;
     property?: "username" | "displayName" | "id" | "globalName";
@@ -9,4 +9,7 @@ interface CreateEmbedAuthorOptions {
     suffix?: string;
 }
 export declare function createEmbedAuthor(options: CreateEmbedAuthorOptions): EmbedAuthorData;
+type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
+type AssetSource = string | null | Attachment | AttachmentBuilder;
+export declare function createEmbedAsset(source?: AssetSource, options?: EmbedAssetOptions): EmbedAssetData | undefined;
 export {};

package/types/functions/utils.d.ts

@@ -1,5 +1,5 @@
 import type { AnyComponentBuilder, LinkButtonComponentData, TextInputComponentData } from "discord.js";
-import { ActionRowBuilder, TextInputBuilder, ButtonBuilder } from "discord.js";
+import { ActionRowBuilder, ButtonBuilder, TextInputBuilder } from "discord.js";
 export declare function createRow<Component extends AnyComponentBuilder>(...components: Component[]): ActionRowBuilder<Component>;
 export declare function createModalInput(data: Omit<TextInputComponentData, "type">): ActionRowBuilder<TextInputBuilder>;
 type CreateLinkButtonData = Omit<LinkButtonComponentData, "style" | "type">;

package/types/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./constants/client";
-export * from "./functions/utils";
+export * from "./functions/channels";
 export * from "./functions/embeds";
+export * from "./functions/roles";
+export * from "./functions/utils";
 export * from "@magicyan/core";