@zoodogood/utils 4.2.1-change.3358 → 5.1.0-change.4236

package/lib/discordjs/chain/configuration.d.ts

@@ -0,0 +1,7 @@
+import type { DiscordContentLimites } from "../message_content_limits.js";
+export interface MaySplitConfiguration {
+    fields?: (keyof typeof DiscordContentLimites)[];
+    separateBy?: string;
+    splay: "balanced" | "rest";
+}
+//# sourceMappingURL=configuration.d.ts.map

package/lib/discordjs/chain/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/discordjs/chain/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACrC,MAAM,CAAC,EAAE,CAAC,MAAM,OAAO,qBAAqB,CAAC,EAAE,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC;CAC3B"}

package/lib/discordjs/chain/get_chain_array.d.ts

@@ -0,0 +1,7 @@
+import type { Client, Message } from "discord.js";
+export declare const _chain_parent: unique symbol;
+export declare const _chain_child: unique symbol;
+export declare function get_chain_array(partId: string, client: Client): Promise<Array<Message | {
+    id: string;
+}>>;
+//# sourceMappingURL=get_chain_array.d.ts.map

package/lib/discordjs/chain/get_chain_array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_chain_array.d.ts","sourceRoot":"","sources":["../../../src/discordjs/chain/get_chain_array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAoB,MAAM,YAAY,CAAC;AAGpE,eAAO,MAAM,aAAa,eAAmB,CAAC;AAC9C,eAAO,MAAM,YAAY,eAAkB,CAAC;AAE5C,wBAAsB,eAAe,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAe1C"}

package/lib/discordjs/chain/get_chain_array.js

@@ -0,0 +1,14 @@
+import { chain_map } from "./map.js";
+export const _chain_parent = Symbol("parent");
+export const _chain_child = Symbol("child");
+export async function get_chain_array(partId, client) {
+    // В порядке от потомка к родителю
+    const [channelId, ...parts] = chain_map.get(partId);
+    const channel = client.channels.cache.get(channelId);
+    return await Promise.all(parts.map((id) => channel.messages.fetch(id).catch((error) => {
+        if (error.message !== "Unknown Message") {
+            throw error;
+        }
+        return { id };
+    })));
+}

package/lib/discordjs/chain/lifecycle.d.ts

@@ -0,0 +1,5 @@
+import { Message } from "discord.js";
+export declare const propogate: any;
+export declare function onMessageDelete(message: Message): Promise<void>;
+export declare function onPropogableEvent(eventType: string, direct_target: Message, rest: unknown): Promise<void>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/lib/discordjs/chain/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/discordjs/chain/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrC,eAAO,MAAM,SAAS,KAAqB,CAAC;AAC5C,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,iBAerD;AAED,wBAAsB,iBAAiB,CACtC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,OAAO,iBASb"}

package/lib/discordjs/chain/lifecycle.js

@@ -0,0 +1,25 @@
+import { Message } from "discord.js";
+import { EventEmitter } from "node:events";
+import { get_chain_array } from "./get_chain_array.js";
+import { chain_map } from "./map.js";
+export const propogate = new EventEmitter();
+export async function onMessageDelete(message) {
+    const messages = chain_map.has(message.id) &&
+        (await get_chain_array(message.id, message.client));
+    if (!chain_map.has(message.id)) {
+        return;
+    }
+    for (const message of messages) {
+        chain_map.delete(message.id);
+        message instanceof Message && message.delete();
+    }
+}
+export async function onPropogableEvent(eventType, direct_target, rest) {
+    const chain = chain_map.has(direct_target.id) &&
+        (await get_chain_array(direct_target.id, direct_target.client));
+    if (!chain)
+        return;
+    for (const message of chain) {
+        propogate.emit(eventType, message, rest, direct_target, chain);
+    }
+}

package/lib/discordjs/chain/map.d.ts

@@ -0,0 +1,8 @@
+import type { Message } from "discord.js";
+declare class Cache extends Map<string, string[]> {
+    constructor();
+    update(parent: Message, child: Message, channelId: string): string[] | undefined;
+}
+export declare const chain_map: Cache;
+export {};
+//# sourceMappingURL=map.d.ts.map

package/lib/discordjs/chain/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/discordjs/chain/map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,cAAM,KAAM,SAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;;IAqBxC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM;CAYzD;AAED,eAAO,MAAM,SAAS,OAAc,CAAC"}

package/lib/discordjs/chain/map.js

@@ -0,0 +1,28 @@
+class Cache extends Map {
+    constructor() {
+        super();
+        setInterval(() => {
+            const { size } = this;
+            if (size < /* threshold */ 100) {
+                return;
+            }
+            const keys = this.keys();
+            for (let index = 0; index < Math.floor(size * /* strong */ 0.5); index++) {
+                this.delete(keys.next().value);
+            }
+        }, 60 * 1000 * 30);
+    }
+    update(parent, child, channelId) {
+        if (this.has(parent.id)) {
+            return;
+        }
+        if (!this.has(child.id)) {
+            this.set(child.id, [channelId, child.id]);
+        }
+        const cell = this.get(child.id);
+        cell.indexOf(parent.id) === -1 && cell.push(parent.id);
+        this.set(parent.id, cell);
+        return cell;
+    }
+}
+export const chain_map = new Cache();

package/lib/discordjs/chain/move_partial_data_to_chain.d.ts

@@ -0,0 +1,6 @@
+import { type diagnosticLimits } from "../message_content_limits.js";
+import { type AdvancedPayload, type createMessage } from "../message_lifecycle.js";
+import type { MaySplitConfiguration } from "./configuration.js";
+export declare function move_partial_data_to_chain(mut_original: AdvancedPayload, splitConfigutation: MaySplitConfiguration, limitsDiagnostic: ReturnType<typeof diagnosticLimits>): undefined;
+export declare function _rob_already_prepared(mut_message_data: ReturnType<typeof createMessage>, mut_payload: AdvancedPayload): void;
+//# sourceMappingURL=move_partial_data_to_chain.d.ts.map

package/lib/discordjs/chain/move_partial_data_to_chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move_partial_data_to_chain.d.ts","sourceRoot":"","sources":["../../../src/discordjs/chain/move_partial_data_to_chain.ts"],"names":[],"mappings":"AAKA,OAAO,EAEN,KAAK,gBAAgB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAgBhE,wBAAgB,0BAA0B,CACzC,YAAY,EAAE,eAAe,EAC7B,kBAAkB,EAAE,qBAAqB,EACzC,gBAAgB,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,aA6LrD;AAID,wBAAgB,qBAAqB,CACpC,gBAAgB,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,EAClD,WAAW,EAAE,eAAe,QAY5B"}

package/lib/discordjs/chain/move_partial_data_to_chain.js

@@ -0,0 +1,176 @@
+// declare state in file://./readme.md
+import { DEFAULT } from "../../primitives/symbols.js";
+import { main_embed_of } from "../main_embed_of.js";
+import { DiscordContentLimites, } from "../message_content_limits.js";
+import { isEmptyEmbed, } from "../message_lifecycle.js";
+function tryMultipleMap(callback, limit = 10) {
+    let iteration = 0;
+    while (true) {
+        try {
+            return callback(iteration++);
+        }
+        catch (error) {
+            if (iteration >= limit) {
+                throw error;
+            }
+            /* continue*/
+        }
+    }
+}
+export function move_partial_data_to_chain(mut_original, splitConfigutation, limitsDiagnostic) {
+    const chain_child = {};
+    mut_original._chain_child = chain_child;
+    move_static_down(mut_original, chain_child);
+    if (!limitsDiagnostic.isExceeding) {
+        // Вернуть визуально пустые значения для рассматриваемых полей
+        return void 0;
+    }
+    const exceeding = Object.entries(limitsDiagnostic.exceeding).filter(([_key, value]) => value > 0);
+    const { separateBy = "\n" } = splitConfigutation;
+    const prepared = exceeding.map(([key]) => {
+        switch (key) {
+            case "content":
+            case "description":
+                return (() => {
+                    const chunks = mut_original[key]
+                        .split(separateBy)
+                        .map((chunk) => ({
+                        chunk,
+                        codeblock_lang: (() => {
+                            const markers = Array.from(chunk.matchAll(/```(?<lang>\S+)?/g));
+                            if (markers.length % 2 === 0) {
+                                return;
+                            }
+                            return markers.at(-1).groups.lang || DEFAULT;
+                        })(),
+                    }));
+                    chunks.forEach(($) => {
+                        if ($.chunk.length > DiscordContentLimites[key]) {
+                            throw new Error("As a result of splitting large text, spliceBy did not find any potential separation points (https://github.com/zoodogood/1119/issues/8)");
+                        }
+                    });
+                    return [key, chunks];
+                })();
+            case "fields_count":
+                return ["fields", mut_original.fields];
+            default:
+                return [key, mut_original[key]];
+        }
+    });
+    const predicated_chain_length = Math.max(...exceeding.map(([key, value]) => value /
+        DiscordContentLimites[key])) + 1;
+    const [for_original, for_child] = tryMultipleMap((iteration) => {
+        return resolve(predicated_chain_length + iteration);
+    });
+    Object.assign(chain_child, for_child);
+    Object.assign(mut_original, for_original, {
+        _chain_child: chain_child,
+    });
+    return void 0;
+    function resolve(predicated_chain_length) {
+        return prepared
+            .map(([key, value]) => {
+            switch (key) {
+                case "content":
+                case "description":
+                    return [
+                        key,
+                        (() => {
+                            const average = mut_original[key].length /
+                                Math.ceil(predicated_chain_length);
+                            const chunks_to_keep = [];
+                            let remain_symbols_count = 0;
+                            let opened_codeblock = null;
+                            const pull = value;
+                            const CLOSE_CODEBLOCK = "\n```";
+                            const close_codeblock_length = CLOSE_CODEBLOCK.length;
+                            while (pull.length) {
+                                const { chunk, codeblock_lang } = pull[0];
+                                if (codeblock_lang) {
+                                    opened_codeblock = opened_codeblock
+                                        ? null
+                                        : codeblock_lang;
+                                }
+                                if (remain_symbols_count +
+                                    chunk.length +
+                                    (opened_codeblock ? close_codeblock_length : 0) >
+                                    DiscordContentLimites[key] ||
+                                    remain_symbols_count > average) {
+                                    opened_codeblock && chunks_to_keep.push(CLOSE_CODEBLOCK);
+                                    break;
+                                }
+                                pull.shift();
+                                chunks_to_keep.push(chunk);
+                                remain_symbols_count += chunk.length;
+                            }
+                            const chunks_to_shift = pull.map(({ chunk }) => chunk);
+                            opened_codeblock &&
+                                chunks_to_shift.unshift(
+                                // @ts-expect-error
+                                `\`\`\`${opened_codeblock === DEFAULT ? "" : opened_codeblock}\n`);
+                            return [
+                                chunks_to_keep.join(separateBy),
+                                chunks_to_shift.join(separateBy),
+                            ];
+                        })(),
+                    ];
+                case "fields":
+                    return [
+                        key,
+                        Object.values(Object.groupBy(value, (_value, index) => String(index <
+                            value.length /
+                                Math.ceil(predicated_chain_length)))),
+                    ];
+                default:
+                    throw new Error(`Unknown key: ${key}`);
+            }
+        })
+            .reduce((acc, item) => {
+            const [key, [keep, move]] = item;
+            // @ts-expect-error
+            acc[0][key] = keep;
+            // @ts-expect-error
+            acc[1][key] = move;
+            return acc;
+        }, [{}, {}]);
+    }
+    function move_static_down(from, to) {
+        // components, footer, reactions, files: окажутся в последнем сообщении
+        // color: скопируется
+        // если в оригинальном сообщении есть description или content — во втором сообщении им на смену прийдут визуально пустые значения
+        const is_started_as_empty = isEmptyEmbed(from);
+        to.color = from.color;
+        to.maySplitMessage = from.maySplitMessage;
+        to.image = from.image;
+        from.image = undefined;
+        to.timestamp = from.timestamp;
+        from.timestamp = undefined;
+        to.components = from.components;
+        from.components = undefined;
+        to.footer = from.footer;
+        from.footer = undefined;
+        to.reactions = from.reactions;
+        from.reactions = undefined;
+        to.files = from.files;
+        from.files = undefined;
+        from.description && (to.description = "-# (пусто)");
+        from.content && (to.content = "-# (пусто)");
+        !is_started_as_empty &&
+            isEmptyEmbed(from) &&
+            (from.description = "-# (пусто)");
+    }
+}
+// Решает прецендент когда целью становится сообщение в цепочке у которого есть потомки, и это выясняется только в момент отправки
+// Хотя по хорошему данные сообщения должны быть собраны до отправки, этого невозможно сделать не целевого айди, а оно при редактировании не подразумевается
+export function _rob_already_prepared(mut_message_data, mut_payload) {
+    const embed = main_embed_of(mut_message_data);
+    if (embed) {
+        embed.footer = undefined;
+        embed.image = undefined;
+        embed.timestamp = undefined;
+        embed.video = undefined;
+    }
+    mut_message_data.files = undefined;
+    mut_message_data.components = undefined;
+    mut_payload.reactions = undefined;
+}

package/lib/discordjs/helpers.d.ts

@@ -1,18 +1,3 @@
-export type APIBaseButton = import("discord-api-types/v10").APIButtonComponentBase<any>;
-/**
- * @typedef {import("discord-api-types/v10").APIButtonComponentBase} APIBaseButton
- */
-/**
- *
- * @param {Partial<APIBaseButton>[]} resolable
- */
-export function justButtonComponents(...resolable: Partial<APIBaseButton>[]): {
-    label?: string | undefined;
-    style: any;
-    emoji?: import("discord-api-types/v10").APIMessageComponentEmoji | undefined;
-    disabled?: boolean | undefined;
-    type: import("discord-api-types/v10").ComponentType.Button | ComponentType;
-    customId: string;
-}[];
-export function justSendMessage(target: any, options: any): Promise<any>;
-import { ComponentType } from "discord.js";
+import type { Emoji } from "discord.js";
+export declare function codeOfEmoji(emoji: Emoji): any;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/discordjs/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/discordjs/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,OAEvC"}

package/lib/discordjs/helpers.js

@@ -1,47 +1,3 @@
-import { BaseInteraction, ButtonStyle, ComponentType } from "discord.js";
-import { CreateMessage } from "./simplify.js";
-const DEFAULTS_FOR_BUTTON = {
-    type: ComponentType.Button,
-    style: ButtonStyle.Secondary,
-};
-/**
- * @typedef {import("discord-api-types/v10").APIButtonComponentBase} APIBaseButton
- */
-/**
- *
- * @param {Partial<APIBaseButton>[]} resolable
- */
-function justButtonComponents(...resolable) {
-    const buttons = resolable.map((data, i) => ({
-        ...DEFAULTS_FOR_BUTTON,
-        customId: `button.${i + 1}`,
-        ...data,
-    }));
-    return buttons;
+export function codeOfEmoji(emoji) {
+    return emoji.id || emoji.name;
 }
-async function justSendMessage(target, options) {
-    const messagePayload = CreateMessage(options);
-    const message = target instanceof BaseInteraction
-        ? await (options.edit
-            ? target.replied
-                ? target.editReply(messagePayload)
-                : target.update(messagePayload)
-            : target.reply(messagePayload))
-        : await (options.edit
-            ? target.edit(messagePayload)
-            : target.send(messagePayload));
-    if (options.delete) {
-        setTimeout(() => message.delete(), options.delete);
-    }
-    if (options.reactions) {
-        options.reactions
-            .filter(Boolean)
-            .filter((react) => {
-            var _a;
-            return !((_a = message.reactions) === null || _a === void 0 ? void 0 : _a.cache.some((compared) => compared.emoji.code === react));
-        })
-            .forEach((react) => message.react(react));
-    }
-    return message;
-}
-export { justButtonComponents, justSendMessage };

package/lib/discordjs/main_embed_of.d.ts

@@ -0,0 +1,4 @@
+import type { APIEmbed } from "discord-api-types/v10";
+import type { Embed, Message, MessageCreateOptions } from "discord.js";
+export declare function main_embed_of(message: Message | MessageCreateOptions): Embed | APIEmbed | undefined;
+//# sourceMappingURL=main_embed_of.d.ts.map

package/lib/discordjs/main_embed_of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main_embed_of.d.ts","sourceRoot":"","sources":["../../src/discordjs/main_embed_of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EACX,KAAK,EAEL,OAAO,EACP,oBAAoB,EACpB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,aAAa,CAC5B,OAAO,EAAE,OAAO,GAAG,oBAAoB,GACrC,KAAK,GAAG,QAAQ,GAAG,SAAS,CAK9B"}

package/lib/discordjs/main_embed_of.js

@@ -0,0 +1,3 @@
+export function main_embed_of(message) {
+    return message.embeds?.[0];
+}

package/lib/discordjs/message_components.d.ts

@@ -0,0 +1,37 @@
+import { type ActionRow, type BaseSelectMenuComponentData, ButtonStyle, ComponentType } from "discord.js";
+interface ButtonConfiguration {
+    customId?: string;
+    label?: string;
+    emoji?: string;
+    disabled?: boolean;
+    url?: string;
+    style?: ButtonStyle;
+    type?: ComponentType.Button;
+}
+export declare function justButtonComponents(...resolable: ButtonConfiguration[]): {
+    customId: string;
+    label?: string;
+    emoji?: string;
+    disabled?: boolean;
+    url?: string;
+    style: ButtonStyle;
+    type: ComponentType.Button;
+}[];
+export declare function justSelectMenuComponent({ placeholder, labels, addable, }: {
+    placeholder?: string;
+    labels: string[];
+    addable?: Partial<BaseSelectMenuComponentData>;
+}): any;
+type ItemOfActionRow<T> = {
+    type: ComponentType;
+} & {
+    [key: string]: any;
+};
+type ActionRowSource<T> = ItemOfActionRow<T> | ItemOfActionRow<T>[] | ItemOfActionRow<T>[][] | ActionRow<any> | ActionRow<any>[];
+type SimpleActionRow<T> = {
+    type: ComponentType.ActionRow;
+    components: ItemOfActionRow<T>[];
+}[];
+export declare function justComponents<T>(state: ActionRowSource<T>): SimpleActionRow<T>;
+export {};
+//# sourceMappingURL=message_components.d.ts.map

package/lib/discordjs/message_components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_components.d.ts","sourceRoot":"","sources":["../../src/discordjs/message_components.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EACd,KAAK,2BAA2B,EAChC,WAAW,EACX,aAAa,EACb,MAAM,YAAY,CAAC;AAOpB,UAAU,mBAAmB;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC;CAC5B;AAED,wBAAgB,oBAAoB,CAAC,GAAG,SAAS,EAAE,mBAAmB,EAAE;cAT5D,MAAM;YACT,MAAM;YACN,MAAM;eACH,OAAO;UACZ,MAAM;WACJ,WAAW;UACZ,aAAa,CAAC,MAAM;IAW3B;AAED,wBAAgB,uBAAuB,CAAC,EACvC,WAAW,EACX,MAAM,EACN,OAAY,GACZ,EAAE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC/C,OAOA;AAED,KAAK,eAAe,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC;AAC3E,KAAK,eAAe,CAAC,CAAC,IACnB,eAAe,CAAC,CAAC,CAAC,GAClB,eAAe,CAAC,CAAC,CAAC,EAAE,GACpB,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,GACtB,SAAS,CAAC,GAAG,CAAC,GACd,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AAEpB,KAAK,eAAe,CAAC,CAAC,IAAI;IACzB,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC;IAC9B,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;CACjC,EAAE,CAAC;AAGJ,wBAAgB,cAAc,CAAC,CAAC,EAC/B,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,eAAe,CAAC,CAAC,CAAC,CA0CpB"}

package/lib/discordjs/message_components.js

@@ -0,0 +1,63 @@
+import { ButtonStyle, ComponentType, } from "discord.js";
+const DEFAULTS_FOR_BUTTON = {
+    type: ComponentType.Button,
+    style: ButtonStyle.Secondary,
+};
+export function justButtonComponents(...resolable) {
+    const buttons = resolable.map((data, i) => ({
+        ...DEFAULTS_FOR_BUTTON,
+        customId: `button.${i + 1}`,
+        ...data,
+    }));
+    return buttons;
+}
+export function justSelectMenuComponent({ placeholder, labels, addable = {}, }) {
+    return {
+        type: ComponentType.StringSelect,
+        placeholder,
+        options: labels.map((label, index) => ({ label, value: String(index) })),
+        ...addable,
+    };
+}
+// MARK: Components
+export function justComponents(state) {
+    switch (true) {
+        // isEmptyArray ↴ ➞ return []
+        case Array.isArray(state) && state.length === 0:
+            return [];
+        // isSingleActionRow ↴ ➞ ActionRowArray ➞ return SimpleActionRow
+        case isSingleActionRow(state):
+            state = [state];
+        // fallthrough ¯\_(ツ)_/¯
+        // isActionRowArray ↴ ➞ return SimpleActionRow
+        case Array.isArray(state) && isSingleActionRow(state[0]):
+            return state;
+        // isSingleComponent ↴ ➞ ComponentsFlat ➞ ComponentsMatrix ➞ return ActionRowArray
+        case isSingleComponent(state):
+            state = [state];
+        // fallthrough ¯\_(ツ)_/¯
+        // isComponentsFlat ↴
+        case isComponentsFlat(state):
+            state = [state];
+        // fallthrough ¯\_(ツ)_/¯
+        // isComponentsMatrix ↴
+        case Array.isArray(state) && isComponentsFlat(state[0]):
+            return state.map((row) => ({
+                type: ComponentType.ActionRow,
+                components: row,
+            }));
+        default:
+            throw new TypeError("Unknown case");
+    }
+    function isSingleActionRow(component) {
+        // @ts-expect-error
+        return component.type === ComponentType.ActionRow;
+    }
+    function isSingleComponent(component) {
+        // @ts-expect-error
+        return "type" in component;
+    }
+    function isComponentsFlat(component) {
+        return Array.isArray(component) && isSingleComponent(component[0]);
+    }
+}

package/lib/discordjs/message_content_limits.d.ts

@@ -0,0 +1,13 @@
+import type { AdvancedPayload } from "./mod.js";
+export declare const DiscordContentLimites: {
+    content: number;
+    description: number;
+    field_count: number;
+};
+export declare function diagnosticLimits(payload: AdvancedPayload, watchOnly?: string[]): {
+    isExceeding: boolean;
+    exceeding: {
+        [key in keyof typeof DiscordContentLimites]?: number;
+    };
+};
+//# sourceMappingURL=message_content_limits.d.ts.map

package/lib/discordjs/message_content_limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_content_limits.d.ts","sourceRoot":"","sources":["../../src/discordjs/message_content_limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,eAAO,MAAM,qBAAqB;;;;CAIjC,CAAC;AAEF,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,eAAe,EACxB,SAAS,WAA4C,GACnD;IACF,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE;SAAG,GAAG,IAAI,MAAM,OAAO,qBAAqB,CAAC,CAAC,EAAE,MAAM;KAAE,CAAC;CACpE,CAwBA"}

package/lib/discordjs/message_content_limits.js

@@ -0,0 +1,29 @@
+export const DiscordContentLimites = {
+    content: 2048,
+    description: 4096,
+    field_count: 20,
+};
+export function diagnosticLimits(payload, watchOnly = ["content", "description", "field_count"]) {
+    let watchOnlyLocal = watchOnly;
+    !Array.isArray(watchOnlyLocal) && (watchOnlyLocal = [watchOnlyLocal]);
+    const diagnostic = watchOnlyLocal.map((field) => [
+        field,
+        exceeding_field(field),
+    ]);
+    return {
+        exceeding: Object.fromEntries(diagnostic),
+        isExceeding: diagnostic
+            .map(($) => $[1])
+            .some((exceeding) => exceeding > 0),
+    };
+    function exceeding_field(field) {
+        switch (field) {
+            case "content":
+                return (payload.content?.length ?? 0) - DiscordContentLimites.content;
+            case "description":
+                return (payload[field]?.length ?? 0) - DiscordContentLimites[field];
+            case "field_count":
+                return (payload.fields?.length ?? 0) - DiscordContentLimites[field];
+        }
+    }
+}

package/lib/discordjs/message_lifecycle.d.ts

@@ -0,0 +1,56 @@
+import { type AttachmentBuilder, type ColorResolvable, EmbedBuilder, Message, type MessageCreateOptions, type SendableChannels, User } from "discord.js";
+import { justComponents } from "./message_components.js";
+import { type MaySplitConfiguration } from "./mod.js";
+declare function sendableOf<T extends User | SendableChannels | Message | ({} & {
+    channel: SendableChannels;
+}) | ({} & {
+    send: (payload: MessageCreateOptions) => Promise<Message>;
+})>(target: T): {
+    send: (payload: MessageCreateOptions) => Promise<Message>;
+};
+export interface AdvancedPayload {
+    content?: string;
+    reference?: string;
+    ephemeral?: boolean;
+    fetchReply?: boolean;
+    title?: string;
+    url?: string;
+    edit?: boolean;
+    author?: {
+        name: string;
+        iconURL?: string;
+    };
+    thumbnail?: string;
+    color?: ColorResolvable;
+    description?: string;
+    fields?: {
+        name: string;
+        value: string;
+        inline?: boolean;
+    }[];
+    image?: string;
+    video?: string;
+    footer?: {
+        text: string;
+        iconURL?: string;
+    };
+    timestamp?: string;
+    delete?: number;
+    reactions?: string[];
+    maySplitMessage?: MaySplitConfiguration;
+    _chain_child?: AdvancedPayload;
+    components?: ReturnType<typeof justComponents>;
+    files?: AttachmentBuilder[];
+}
+export declare function isEmptyEmbed(embed: {
+    [key in keyof EmbedBuilder["data"]]: unknown;
+}): boolean;
+export declare function createMessage(mut_payload: AdvancedPayload): MessageCreateOptions;
+/**
+ *
+ * @param {Partial<APIBaseButton>[]} resolable
+ */
+export declare function justSendMessage<InGuild extends boolean>(target: Parameters<typeof sendableOf>[0], payload: AdvancedPayload): Promise<Message<InGuild_1>>;
+export declare function sendMessage<InGuild extends boolean>(target: Parameters<typeof sendableOf>[0], message_data: ReturnType<typeof createMessage>, mut_payload: AdvancedPayload): Promise<Message<InGuild>>;
+export {};
+//# sourceMappingURL=message_lifecycle.d.ts.map

package/lib/discordjs/message_lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_lifecycle.d.ts","sourceRoot":"","sources":["../../src/discordjs/message_lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EACpB,YAAY,EACZ,OAAO,EACP,KAAK,oBAAoB,EAEzB,KAAK,gBAAgB,EACrB,IAAI,EAEJ,MAAM,YAAY,CAAC;AASpB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAEN,KAAK,qBAAqB,EAG1B,MAAM,UAAU,CAAC;AAElB,iBAAS,UAAU,CAClB,CAAC,SACE,IAAI,GACJ,gBAAgB,GAChB,OAAO,GACP,CAAC,EAAE,GAAG;IAAE,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC,GACpC,CAAC,EAAE,GAAG;IAAE,IAAI,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,EAEvE,MAAM,EAAE,CAAC,GACP;IACF,IAAI,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D,CAWA;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC/C,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,wBAAgB,YAAY,CAC3B,KAAK,EAAE;KAAG,GAAG,IAAI,MAAM,YAAY,CAAC,MAAM,CAAC,GAAG,OAAO;CAAE,WAmBvD;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,eAAe,wBA2DzD;AAED;;;GAGG;AAEH,wBAAsB,eAAe,CAAC,OAAO,SAAS,OAAO,EAC5D,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,EACxC,OAAO,EAAE,eAAe,+BAIxB;AAED,wBAAsB,WAAW,CAAC,OAAO,SAAS,OAAO,EACxD,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,EACxC,YAAY,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,EAC9C,WAAW,EAAE,eAAe,GAC1B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAsG3B"}