@fallencodes/seyfert-utils 1.2.8 → 1.3.1

package/build/components/message.d.ts

@@ -23,15 +23,21 @@ interface ContainerOptions {
 }
 export declare function createContainer(components: ContainerBuilderComponents[], options?: ContainerOptions): Container;
 export declare function createActionRow<T extends ActionBuilderComponents>(...components: FixedComponents<T>[]): ActionRow<T>;
-interface ButtonData {
-    url?: string;
-    label: string;
-    skuId?: string;
-    customId: string;
-    style: ButtonStyle;
+interface BaseButtonData {
+    label?: string;
     disabled?: boolean;
     emoji?: APIMessageComponentEmoji;
 }
+type ButtonData = (BaseButtonData & {
+    url: string;
+    style: ButtonStyle.Link;
+}) | (BaseButtonData & {
+    skuId: string;
+    style: ButtonStyle.Premium;
+}) | (BaseButtonData & {
+    customId: string;
+    style: ButtonStyle;
+});
 export declare function createButton(data: ButtonData): Button;
 export {};
 //# sourceMappingURL=message.d.ts.map

package/build/components/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/components/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,0BAA0B,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAa,MAAM,SAAS,CAAC;AACzK,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE5F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAE9D;AAED,KAAK,gBAAgB,GAAG,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC,GAAG,CAAC;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,CAAA;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAqBvF;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,aAEnE;AAED,UAAU,gBAAgB;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,0BAA0B,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAW/G;AAGD,wBAAgB,eAAe,CAAC,CAAC,SAAS,uBAAuB,EAAE,GAAG,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAEpH;AAED,UAAU,UAAU;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIrD"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/components/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,0BAA0B,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAa,MAAM,SAAS,CAAC;AACzK,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE5F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAE9D;AAED,KAAK,gBAAgB,GAAG,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC,GAAG,CAAC;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,CAAA;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAqBvF;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,aAEnE;AAED,UAAU,gBAAgB;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,0BAA0B,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAW/G;AAGD,wBAAgB,eAAe,CAAC,CAAC,SAAS,uBAAuB,EAAE,GAAG,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAEpH;AAED,UAAU,cAAc;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAED,KAAK,UAAU,GAAG,CAAC,cAAc,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC;CAC3B,CAAC,GAAG,CAAC,cAAc,GAAG;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;CAC9B,CAAC,GAAG,CAAC,cAAc,GAAG;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;CACtB,CAAC,CAAA;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAKrD"}

package/build/components/message.js

@@ -51,8 +51,10 @@ export function createActionRow(...components) {
 }
 ;
 export function createButton(data) {
-    const button = new Button(data).setCustomId(data.customId);
-    if (data.skuId)
+    const button = new Button(data);
+    if ('customId' in data)
+        button.setCustomId(data.customId);
+    if ('skuId' in data)
         button.setSKUId(data.skuId);
     return button;
 }

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/build/index.js

@@ -1,3 +1,6 @@
+import dayjs from 'dayjs';
+import utcPlugin from 'dayjs/plugin/utc.js';
+dayjs.extend(utcPlugin);
 export * from './utilities.js';
 export * from './variables.js';
 // export * from './components/modal.js';

package/build/options.d.ts

@@ -0,0 +1,13 @@
+import { OKFunction, GuildRole, StopFunction, AllGuildChannels, CommandContext } from 'seyfert';
+interface StringOption {
+    value: string;
+    context: CommandContext;
+}
+export declare const snowflakeOptionValue: ({ value }: StringOption, ok: OKFunction<string>, fail: StopFunction) => void;
+export declare const colorHexOptionValue: ({ value }: StringOption, ok: OKFunction<number>, fail: StopFunction) => void;
+export declare function dateOptionValue({ value }: StringOption, ok: OKFunction<Date>, fail: StopFunction): void;
+export declare function relativeTimeOptionValue({ value }: StringOption, ok: OKFunction<number>, fail: StopFunction): void;
+export declare function rolesOptionValue({ value: values, context }: StringOption, ok: OKFunction<[GuildRole, ...GuildRole[]]>, fail: StopFunction): Promise<void>;
+export declare function channelsOptionValue({ value: values, context }: StringOption, ok: OKFunction<[AllGuildChannels, ...AllGuildChannels[]]>, fail: StopFunction): Promise<void>;
+export {};
+//# sourceMappingURL=options.d.ts.map

package/build/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAOhG,UAAU,YAAY;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;CAC3B;AAGD,eAAO,MAAM,oBAAoB,GAAI,WAAW,YAAY,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,YAAY,SAGvG,CAAC;AAGF,eAAO,MAAM,mBAAmB,GAAI,WAAW,YAAY,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,YAAY,SAStG,CAAC;AAGF,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,QAIhG;AAGD,wBAAgB,uBAAuB,CAAC,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,QAI1G;AAGD,wBAAsB,gBAAgB,CAClC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,YAAY,EACxC,EAAE,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,EAC3C,IAAI,EAAE,YAAY,iBA4BrB;AAGD,wBAAsB,mBAAmB,CACrC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,YAAY,EACxC,EAAE,EAAE,UAAU,CAAC,CAAC,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAAC,CAAC,EACzD,IAAI,EAAE,YAAY,iBA8BrB"}

package/build/options.js

@@ -0,0 +1,108 @@
+import { isValidSnowflake } from './utilities.js';
+import dayjs from 'dayjs';
+import ms from 'ms';
+import fuzzy from 'fuzzysort';
+import { channelMentionRegex, hexRegex, roleMentionRegex } from './variables.js';
+/* Returns a valid string snowflake value. */
+export const snowflakeOptionValue = ({ value }, ok, fail) => {
+    if (isValidSnowflake(value))
+        return ok(value);
+    return fail(`The provided string isn't a valid snowflake.`);
+};
+/* Returns a valid numerical color code for the Discord API. */
+export const colorHexOptionValue = ({ value }, ok, fail) => {
+    if (!value.startsWith('#'))
+        value = `#${value}`;
+    if (value.match(hexRegex)) {
+        if (value === '#000000')
+            value = '#000001';
+        return ok(parseInt(value.replace('#', '0x')));
+    }
+    ;
+    return fail(`The specified color "${value}" isn't a valid HEX code (format: #faff6d).`);
+};
+/* Returns a valid date object from the provided string value. */
+export function dateOptionValue({ value }, ok, fail) {
+    const date = dayjs.utc(value);
+    if (date.isValid())
+        return ok(date.toDate());
+    else
+        return fail(`The specified date "${date}" isn't a valid date.`);
+}
+;
+/* Returns a valid date object from the provided string value. */
+export function relativeTimeOptionValue({ value }, ok, fail) {
+    const relativeMs = ms(value);
+    if (isNaN(relativeMs))
+        return fail(`The provided time value isn't a valid amount of time.`);
+    return ok(relativeMs);
+}
+;
+/* Returns an array of roles from the provided string value. */
+export async function rolesOptionValue({ value: values, context }, ok, fail) {
+    const guild = await context.guild();
+    if (!guild)
+        return fail("The guild this command was used in wasn't found.");
+    const resolvedRoles = [];
+    const roles = await guild.roles.list();
+    for (const value of values.split(',').map((value) => value.trim())) {
+        let role;
+        const mentionMatch = roleMentionRegex.exec(value)?.[1];
+        if (mentionMatch)
+            role = roles.find(({ id }) => mentionMatch === id);
+        if (!role && isValidSnowflake(value))
+            role = roles.find(({ id }) => value === id);
+        if (!role) {
+            const formattedRoles = roles.map(({ id, name }) => ({ id: id, name: fuzzy.prepare(name) }));
+            const match = fuzzy.go(value, formattedRoles, { key: 'name' })[0];
+            if (match)
+                role = roles.find(({ id }) => match.obj.id === id);
+        }
+        ;
+        if (role)
+            resolvedRoles.push(role);
+        else
+            return fail(`Hold up! | The specified role "${value}" wasn't found.`);
+    }
+    ;
+    if (resolvedRoles.length < 1)
+        return fail(`Hold up! | You didn't specify any valid roles.`);
+    // @ts-expect-error
+    ok(resolvedRoles);
+}
+;
+/* Returns an array of channels from the provided string value. */
+export async function channelsOptionValue({ value: values, context }, ok, fail) {
+    const guild = await context.guild();
+    if (!guild)
+        return fail("The guild this command was used in wasn't found.");
+    const resolvedChannels = [];
+    let channels = (await guild.channels.list());
+    channels = channels.filter((ch) => !ch.isThread() && ('name' in ch));
+    for (const value of values.split(',').map((value) => value.trim())) {
+        let channel;
+        const mentionMatch = channelMentionRegex.exec(value)?.[1];
+        if (mentionMatch)
+            channel = channels.find(({ id }) => mentionMatch === id);
+        if (!channel && isValidSnowflake(value))
+            channel = channels.find(({ id }) => value === id);
+        if (!channel) {
+            // @ts-expect-error
+            const formattedChannels = channels.map(({ id, name }) => ({ id: id, name: fuzzy.prepare(name) }));
+            const match = fuzzy.go(value, formattedChannels, { key: 'name' })[0];
+            if (match)
+                channel = channels.find(({ id }) => match.obj.id === id);
+        }
+        ;
+        if (channel)
+            resolvedChannels.push(channel);
+        else
+            return fail(`Hold up! | The specified channel "${channel}" wasn't found.`);
+    }
+    ;
+    if (resolvedChannels.length < 1)
+        return fail(`Hold up! | You didn't specify any valid channels.`);
+    // @ts-expect-error
+    ok(resolvedChannels);
+}
+;

package/build/variables.d.ts

@@ -2,4 +2,8 @@ export declare const trueOrFalse: {
     name: string;
     value: string;
 }[];
+export declare const hexRegex: RegExp;
+export declare const userMentionRegex: RegExp;
+export declare const roleMentionRegex: RegExp;
+export declare const channelMentionRegex: RegExp;
 //# sourceMappingURL=variables.d.ts.map

package/build/variables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../src/variables.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW;;;GAGvB,CAAC"}
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../src/variables.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW;;;GAGvB,CAAC;AAGF,eAAO,MAAM,QAAQ,QAA2B,CAAC;AAGjD,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AAGtD,eAAO,MAAM,gBAAgB,QAAyB,CAAC;AAGvD,eAAO,MAAM,mBAAmB,QAAwB,CAAC"}

package/build/variables.js

@@ -3,3 +3,11 @@ export const trueOrFalse = [
     { name: 'Yes', value: 'true' },
     { name: 'No', value: 'false' }
 ];
+/* A regex that matches HEX color codes. */
+export const hexRegex = /^#([0-9A-F]{3}){1,2}$/i;
+/* A regex that matches user mentions. */
+export const userMentionRegex = /<@(?<id>\d{17,20})>/;
+/* A regex that matches role mentions */
+export const roleMentionRegex = /<@&(?<id>\d{17,20})>/;
+/* A regex that matches channel mentions. */
+export const channelMentionRegex = /<#(?<id>\d{17,20})>/;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fallencodes/seyfert-utils",
   "type": "module",
-  "version": "1.2.8",
+  "version": "1.3.1",
   "license": "MIT",
   "description": "A collection of various utility/helper code I use in my Seyfert projects.",
   "main": "build/index.js",
@@ -28,17 +28,21 @@
   "exports": {
     ".": "./build/index.js",
     "./logger": "./build/logger.js",
+    "./options": "./build/options.js",
     "./components/*": "./build/components/*.js",
     "./handleCommand": "./build/handleCommand.js"
   },
   "dependencies": {
     "@sapphire/snowflake": "^3.5.5",
     "dayjs": "^1.11.19",
+    "fuzzysort": "^3.1.0",
+    "ms": "^2.1.3",
     "multibyte": "^1.0.5",
     "nanoid": "^5.1.6",
     "seyfert": "4.0.1-dev-21273098940.0"
   },
   "devDependencies": {
+    "@types/ms": "^2.1.0",
     "@types/node": "^25.0.8",
     "typescript": "^5.9.3"
   },