@getsolara/solara.canvas/functions/welcomeCard.js

Optional canvas and image manipulation functionality for @getsolara/solara.js

const { AttachmentBuilder } = require('discord.js');
module.exports = {
    name: "$welcomeCard",
    description: "Generates a welcome card image and attaches it. Args: title;description;[avatarURL?];[backgroundURL?];[borderColor?];[avatarBorderColor?];[overlayOpacity?]",
    takesBrackets: true,
    execute: async (context, args) => {
        if (context.client.canvasInitialized === false) {
            return "[Error: $welcomeCard requires canvas features to be enabled. Ensure @getsolara/solara.canvas is installed and configured correctly.]";
        }
        if (args.length < 2) return "[Error: $welcomeCard requires title and description]";
        const [title, description, avatar, background, border, avatarBorder, opacityStr] = args;
        const opacity = opacityStr ? parseFloat(opacityStr) : undefined;
        if (opacity !== undefined && isNaN(opacity)) return "[Error: Invalid opacity value for $welcomeCard. Must be a number.]";
        try {
            const canvafy = require("canvafy");
            const builder = new canvafy.WelcomeLeave().setTitle(title).setDescription(description);
            if (avatar) builder.setAvatar(avatar);
            else if (context.user) builder.setAvatar(context.user.displayAvatarURL({ forceStatic: true, extension: "png" }));
            if (background) builder.setBackground("image", background);
            if (border) builder.setBorder(border);
            if (avatarBorder) builder.setAvatarBorder(avatarBorder);
            if (opacity !== undefined) builder.setOverlayOpacity(opacity);
            const imageBuffer = await builder.build();
            const attachment = new AttachmentBuilder(imageBuffer, { name: `welcome-${context.user?.id || Date.now()}.png` });
            context.attachments = context.attachments || [];
            context.attachments.push(attachment);
            return "";
        } catch (e) {
            if (e.code === 'MODULE_NOT_FOUND' && e.message.includes('canvafy')) {
                console.error("Solara.canvas ($welcomeCard): 'canvafy' module not found. This is a dependency of @getsolara/solara.canvas.");
                return "[Error: $welcomeCard - canvafy module missing.]";
            }
            console.error("Solara.canvas Error ($welcomeCard):", e);
            return `[Error generating welcome card: ${e.message}]`;
        }
    }
};