gifts-manager

🎁

Gift Manager

Gift Manager é uma biblioteca Node.js abrangente projetada para simplificar o gerenciamento de presentes. Seja para construir um sistema de recompensas, organizar eventos especiais ou implementar campanhas promocionais, o Gift Manager garante um manuseio eficiente e organizado de presentes.

📑 Índice

• Instalação
• Uso
  • Inicialização
  • Integração com Discord.js
• Estrutura do gifts.json
• Tratamento de Erros
• Documentação
• Contribuições
• Licença
• Status do Projeto
• Contato

🚀 Instalação

Instale o Gift Manager via npm:

npm install gifts-manager

📦 Uso

Inicialização

Comece importando a classe GiftManager:

const { GiftManager } = require('gifts-manager');

Em seguida, instancie o GiftManager:

const gm = new GiftManager();

Resgatar um Presente

(
    async () => {
        const giftId = 'seu_id_de_presente_aqui';
        const redeemResult = await gm.redeem(giftId);
        if (redeemResult.success) {
            console.log(`Presente resgatado com sucesso! Prêmio: ${redeemResult.amount} ${redeemResult.type}`);
        } else {
            console.log('Presente já foi resgatado ou é inválido.');
        }
    }
)();

Visualizar um Presente

(
    async () => {
        const giftId = 'seu_id_de_presente_aqui';
        const viewResult = await gm.view(giftId);
        if (viewResult.valid) {
            console.log(`Prêmio: ${viewResult.amount} ${viewResult.type}`);
        } else {
            console.log('ID de presente inválido.');
        }
    }
)();

Gerar um Presente

Para gerar um presente, você pode optar por valores predefinidos ou definidos pelo usuário:

// Gerar um presente com valores predefinidos
const giftId1 = await gm.generate();
console.log(`Gift ID gerado: ${giftId1}`);

// Gerar um presente com valores definidos pelo usuário
const giftId3 = await gm.generate({
    type: 'diamonds',
    amount: 100,
});
console.log(`Gift ID gerado: ${giftId3}`); 

Integração com Discord.js

Aqui está um exemplo simplificado demonstrando a integração do GiftManager com um bot Discord.js:

const Discord = require('discord.js');
const client = new Discord.Client();
const { GiftManager } = require('gifts-manager');
const gm = new GiftManager();
const { prefix } = require('./config.json') || '-';

client.once('ready', () => {
    console.log('Bot está operacional.');
});

client.on('messageCreate', async (message) => {
    if (message.author.bot) return;

    if (message.content.startsWith(prefix+'generate')) {
        const amount = Math.floor(
            Math.random() * (10000 - 1000 + 1)
            ) + 1000;
        const giftId = await gm.generate({
            type: 'daily',
            amount: amount,
        });
        message.channel.send(`Presente gerado! ID: ${giftId}`);
    }

    if (message.content.startsWith(prefix+'redeem')) {
        const giftId = message.content.split(' ')[1];
        const result = await gm.redeem(giftId);
        result.success ? message.channel.send(`Presente resgatado! Prêmio: ${result.amount} ${result.type}`) : message.channel.send('Presente já foi resgatado ou é inválido.');
    }

    if (message.content.startsWith(prefix+'view')) {
        const giftId = message.content.split(' ')[1];
        const result = await gm.view(giftId);
        result.valid ? message.channel.send(`Prêmio: ${result.amount} ${result.type}`) : message.channel.send('ID de presente inválido.');
    }
});

client.login('SEU_TOKEN_DO_DISCORD_BOT');

📜 Documentação

Para documentação detalhada, visite link_para_documentação.

🤝 Contribuições

Contribuições são bem-vindas! Consulte CONTRIBUTING.md para diretrizes.

📝 Licença

Este projeto está licenciado sob a Licença ISC.

📊 Status do Projeto

• Status: Ativo
• Última Atualização: Abril de 2024

---

Para perguntas, suporte ou feedback:

• Email: [e-mail]
• GitHub: yeyTaken

---

© 2020-2024 TakenStudios & Israel R. Jatobá