@fallencodes/seyfert-utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Liam L
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,2 @@
+# Seyfert Utils
+A collection of various utility/helper code I use in my Seyfert projects.

package/build/components.d.ts

@@ -0,0 +1,26 @@
+import { Container, ContainerBuilderComponents, Section, Separator, TextDisplay } from 'seyfert';
+import { ButtonStyle, Spacing } from 'seyfert/lib/types/index.js';
+export declare function createTextDisplay(content: string): TextDisplay;
+type SectionAccessory = ({
+    url?: string;
+    type: 'button';
+    label?: string;
+    skuId?: string;
+    customId?: string;
+    style: ButtonStyle;
+    disabled?: boolean;
+}) | ({
+    url: string;
+    type: 'thumbnail';
+    spoiler?: boolean;
+    description?: string;
+});
+export declare function createTextSection(content: string, accessory: SectionAccessory): Section;
+export declare function createSeparator(spacing?: Spacing, divider?: boolean): Separator;
+interface ContainerOptions {
+    color?: number | string;
+    spoiler?: boolean;
+}
+export declare function createContainer(components: ContainerBuilderComponents[], options?: ContainerOptions): Container;
+export {};
+//# sourceMappingURL=components.d.ts.map

package/build/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,SAAS,EAAE,0BAA0B,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAa,MAAM,SAAS,CAAC;AACpH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAElE,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"}

package/build/components.js

@@ -0,0 +1,48 @@
+import { Button, Container, Section, Separator, TextDisplay, Thumbnail } from 'seyfert';
+export function createTextDisplay(content) {
+    return new TextDisplay({ content });
+}
+;
+export function createTextSection(content, accessory) {
+    const section = new Section().addComponents(new TextDisplay({ content }));
+    switch (accessory.type) {
+        case 'button':
+            section.setAccessory(new Button({
+                url: accessory.url,
+                label: accessory.label,
+                style: accessory.style,
+                sku_id: accessory.skuId,
+                disabled: accessory.disabled,
+                custom_id: accessory.customId
+            }));
+            break;
+        case 'thumbnail':
+            section.setAccessory(new Thumbnail({
+                spoiler: accessory.spoiler,
+                media: { url: accessory.url },
+                description: accessory.description
+            }));
+            break;
+    }
+    ;
+    return section;
+}
+;
+export function createSeparator(spacing, divider) {
+    return new Separator({ spacing, divider });
+}
+;
+export function createContainer(components, options) {
+    const container = new Container({ spoiler: options?.spoiler }).setComponents(components);
+    if (options?.color) {
+        let color;
+        if (typeof options.color === 'number')
+            color = options.color;
+        if (typeof options.color === 'string')
+            color = parseInt(options.color.toString().replace('#', '0x'));
+        container.setColor(color);
+    }
+    ;
+    return container;
+}
+;

package/build/index.d.ts

@@ -0,0 +1,3 @@
+export * from './utilities.js';
+export * from './components.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,2 @@
+export * from './utilities.js';
+export * from './components.js';

package/build/utilities.d.ts

@@ -0,0 +1,10 @@
+import { User, GuildMember } from 'seyfert';
+export declare function s(content: string): string;
+export declare function randomId(length: number): string;
+export declare function wait(time: number): Promise<unknown>;
+export declare function isValidSnowflake(snowflake: string): boolean;
+export declare function truncateString(string: string, maxLength?: number): string;
+type NameType = 'display' | 'display-s' | 'display-username' | 'display-username-s' | 'username-id' | 'username-id-s';
+export declare function name(user: User | GuildMember, type?: NameType): string;
+export {};
+//# sourceMappingURL=utilities.d.ts.map

package/build/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG5C,wBAAgB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzC;AAGD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C;AAGD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnD;AAGD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAI3D;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAI9E;AAED,KAAK,QAAQ,GACX,SAAS,GACT,WAAW,GACX,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,GACb,eAAe,CAAA;AAGjB,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,EAAE,IAAI,GAAE,QAAoB,GAAG,MAAM,CAWjF"}

package/build/utilities.js

@@ -0,0 +1,49 @@
+import { DiscordSnowflake, Snowflake } from '@sapphire/snowflake';
+import { customAlphabet } from 'nanoid';
+import { length, slice } from 'multibyte';
+import { User } from 'seyfert';
+/* Sanitises a string, disabling all simple Discord markdown by prepending "\". */
+export function s(content) {
+    return content.replace(/`/g, '\\`').replace(/\*/g, '\\*').replace(/\|/g, '\\|').replace(/_/g, '\\_');
+}
+;
+/* Generates a random alphanumeric string with the provided length. */
+export function randomId(length) {
+    return customAlphabet('0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz')(length);
+}
+;
+/* Pauses code execution for the provided milliseconds, allowing for in-line code pauses. */
+export function wait(time) {
+    return new Promise((resolve) => setTimeout(resolve, time));
+}
+;
+/* Checks if a provided string is a valid Discord snowflake. */
+export function isValidSnowflake(snowflake) {
+    if (!/^\d{17,19}$/.test(snowflake))
+        return false;
+    const epoch = DiscordSnowflake.generate({ timestamp: DiscordSnowflake.epoch });
+    return Snowflake.compare(epoch, snowflake) < 0 && Snowflake.compare(snowflake, DiscordSnowflake.generate()) < 0;
+}
+;
+/* Truncates a string using UTF-8 safe encoding. */
+export function truncateString(string, maxLength = 100) {
+    const strLength = length(string);
+    if (strLength <= maxLength)
+        return string;
+    return `${slice(string, 0, maxLength - 3)}...`;
+}
+;
+/* Formats a User or GuildMember username or display name with or without sanitisation. */
+export function name(user, type = 'display') {
+    const display = user instanceof User ? user.globalName : user.displayName;
+    switch (type) {
+        case 'display': return display ?? user.username;
+        case 'display-s': return s(display ?? user.username);
+        case 'display-username': return display ? `${display} (${user.username})` : user.username;
+        case 'display-username-s': return s(display ? `${display} (${user.username})` : user.username);
+        case 'username-id': return `${user.username} (${user.id})`;
+        case 'username-id-s': return s(`${user.username} (${user.id})`);
+    }
+    ;
+}
+;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@fallencodes/seyfert-utils",
+  "type": "module",
+  "version": "1.0.0",
+  "license": "MIT",
+  "description": "A collection of various utility/helper code I use in my Seyfert projects.",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "url": "https://github.com/TheFallenSpirit/seyfert-utils"
+  },
+  "author": {
+    "name": "Liam L",
+    "email": "thefallenspirit@outlook.com",
+    "url": "https://github.com/TheFallenSpirit"
+  },
+  "files": [
+    "build",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@sapphire/snowflake": "^3.5.5",
+    "multibyte": "^1.0.5",
+    "nanoid": "^5.1.6",
+    "seyfert": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "rm -r build; tsc"
+  }
+}