yuzuha 0.1.7 → 0.2.0

package/dist/cli/bot-template-commands.js

@@ -0,0 +1,358 @@
+export const extraCommands = {
+    'moderation/kick': `import { arg, defineCommand } from 'yuzuha';
+
+export default defineCommand({
+  name: 'kick',
+  description: 'Expulsa um membro e registra um caso.',
+  guildOnly: true,
+  args: {
+    membro: arg.user().required(),
+    motivo: arg.text().rest().min(1).max(400).required(),
+  },
+  async run(ctx) {
+    const record = await ctx.mod.kick(ctx.args.get('membro'), {
+      reason: ctx.args.get('motivo'),
+    });
+    await ctx.reply({ embeds: [{ title: 'Caso #' + record.id, color: 0x5865F2,
+      fields: [
+        { name: 'Ação', value: record.action, inline: true },
+        { name: 'Usuário (ID)', value: record.targetID, inline: true },
+        { name: 'Motivo', value: record.reason, inline: false },
+      ],
+    }] });
+  },
+});
+`,
+    'moderation/timeout': `import { arg, defineCommand } from 'yuzuha';
+
+export default defineCommand({
+  name: 'timeout',
+  description: 'Aplica timeout a um membro e registra um caso.',
+  guildOnly: true,
+  args: {
+    membro: arg.user().required(),
+    duracao: arg.duration().min(1000).max(2419200000).required(),
+    motivo: arg.text().rest().min(1).max(400).required(),
+  },
+  async run(ctx) {
+    const record = await ctx.mod.timeout(ctx.args.get('membro'), {
+      reason: ctx.args.get('motivo'),
+      duration: ctx.args.get('duracao'),
+    });
+    await ctx.reply({ embeds: [{ title: 'Caso #' + record.id, color: 0x5865F2,
+      fields: [
+        { name: 'Ação', value: record.action, inline: true },
+        { name: 'Usuário (ID)', value: record.targetID, inline: true },
+        { name: 'Motivo', value: record.reason, inline: false },
+      ],
+    }] });
+  },
+});
+`,
+    'moderation/unban': `import { arg, defineCommand } from 'yuzuha';
+
+export default defineCommand({
+  name: 'unban',
+  description: 'Remove um banimento e registra um caso.',
+  guildOnly: true,
+  args: {
+    membro: arg.user().required(),
+    motivo: arg.text().rest().min(1).max(400).required(),
+  },
+  async run(ctx) {
+    const record = await ctx.mod.unban(ctx.args.get('membro'), {
+      reason: ctx.args.get('motivo'),
+    });
+    await ctx.reply({ embeds: [{ title: 'Caso #' + record.id, color: 0x5865F2,
+      fields: [
+        { name: 'Ação', value: record.action, inline: true },
+        { name: 'Usuário (ID)', value: record.targetID, inline: true },
+        { name: 'Motivo', value: record.reason, inline: false },
+      ],
+    }] });
+  },
+});
+`,
+    'moderation/case': `import { arg, defineCommand } from 'yuzuha';
+
+export default defineCommand({
+  name: 'caso', description: 'Consulta um caso de moderação deste servidor.',
+  guildOnly: true, permissions: ['ManageGuild'],
+  args: { numero: arg.integer().min(1).required() },
+  async run(ctx) {
+    const record = await ctx.case(ctx.args.get('numero'));
+    if (!record) { await ctx.reply('Caso não encontrado neste servidor.'); return; }
+    await ctx.reply({ embeds: [{ title: 'Caso #' + record.id, color: 0x5865F2,
+      fields: [
+        { name: 'Ação', value: record.action, inline: true },
+        { name: 'Usuário (ID)', value: record.targetID, inline: true },
+        { name: 'Moderador (ID)', value: record.moderatorID, inline: true },
+        { name: 'Motivo', value: record.reason || 'Sem motivo informado.', inline: false },
+      ],
+    }] });
+  },
+});
+`,
+    'community/rules': `import { arg, assert, defineCommand } from 'yuzuha';
+
+export default defineCommand({
+  name: 'regras', description: 'Consulta ou configura as regras do servidor.', guildOnly: true,
+  subcommands: [
+    { name: 'ver', description: 'Mostra as regras.', async run(ctx) {
+      const text = await ctx.data.guild.get('regras', 'As regras ainda não foram configuradas.');
+      assert(typeof text === 'string' && text.length <= 3000, 'As regras salvas são inválidas.');
+      await ctx.reply({ embeds: [{ title: 'Regras do servidor', description: text, color: 0x5865F2 }] });
+    } },
+    defineCommand({ name: 'definir', description: 'Define as regras (ManageGuild).', permissions: ['ManageGuild'],
+      args: { texto: arg.text().rest().min(1).max(3000).required() },
+      async run(ctx) { await ctx.data.guild.set('regras', ctx.args.get('texto')); await ctx.reply('Regras atualizadas.'); },
+    }),
+  ],
+});
+`,
+    'community/suggestions': `import { arg, defineCommand } from 'yuzuha';
+import { readStrings } from '../../helpers/state.js';
+
+export default defineCommand({
+  name: 'sugestao', description: 'Envia e consulta as últimas 10 sugestões públicas.', guildOnly: true,
+  subcommands: [
+    defineCommand({ name: 'enviar', description: 'Envia uma sugestão pública.', cooldown: '30s',
+      args: { texto: arg.text().rest().min(1).max(250).required() },
+      async run(ctx) {
+        const line = ctx.authorID + ': ' + ctx.args.get('texto');
+        await ctx.data.guild.update('sugestoes', current => [...readStrings(current), line].slice(-10), []);
+        await ctx.reply('Sugestão registrada. Use sugestao listar para consultar.');
+      },
+    }),
+    { name: 'listar', description: 'Lista as sugestões públicas mais recentes.', async run(ctx) {
+      const lines = readStrings(await ctx.data.guild.get('sugestoes', []));
+      await ctx.reply({ embeds: [{ title: 'Sugestões da comunidade', color: 0x5865F2,
+        description: lines.join('\\n') || 'Ainda não há sugestões.',
+      }] });
+    } },
+  ],
+});
+`,
+    'community/poll': `import { arg, assert, defineCommand } from 'yuzuha';
+import { readPoll } from '../../helpers/state.js';
+
+export default defineCommand({
+  name: 'enquete', description: 'Enquete de sim ou não por canal; votos podem ser alterados.', guildOnly: true,
+  subcommands: [
+    defineCommand({ name: 'criar', description: 'Abre uma enquete (ManageGuild).', permissions: ['ManageGuild'],
+      args: { pergunta: arg.text().rest().min(1).max(500).required() },
+      async run(ctx) {
+        await ctx.data.guild.update('enquete:' + ctx.channelID, current => {
+          if (current !== null) assert(readPoll(current).closed, 'Feche a enquete atual antes de criar outra.');
+          return { question: ctx.args.get('pergunta'), authorID: ctx.authorID, closed: false, votes: [] };
+        });
+        await ctx.reply('Enquete aberta. Vote com enquete votar sim ou enquete votar nao.');
+      },
+    }),
+    defineCommand({ name: 'votar', description: 'Registra ou altera seu voto.',
+      args: { voto: arg.text().choices(['sim', 'nao']).required() },
+      async run(ctx) {
+        await ctx.data.guild.update('enquete:' + ctx.channelID, current => {
+          const poll = readPoll(current);
+          assert(!poll.closed, 'Esta enquete já foi encerrada.');
+          const votes = poll.votes.filter(vote => vote.id !== ctx.authorID);
+          assert(votes.length < 1000, 'Esta enquete atingiu o limite de participantes.');
+          return { ...poll, votes: [...votes, { id: ctx.authorID, choice: ctx.args.get('voto') }] };
+        });
+        await ctx.reply('Voto registrado.');
+      },
+    }),
+    { name: 'resultado', description: 'Mostra o resultado atual.', async run(ctx) {
+      const poll = readPoll(await ctx.data.guild.get('enquete:' + ctx.channelID));
+      await ctx.reply({ embeds: [{ title: poll.closed ? 'Enquete encerrada' : 'Enquete aberta',
+        description: poll.question, color: 0x5865F2,
+        fields: ['sim', 'nao'].map(choice => ({ name: choice === 'sim' ? 'Sim' : 'Não',
+          value: String(poll.votes.filter(vote => vote.choice === choice).length), inline: true })),
+      }] });
+    } },
+    { name: 'fechar', description: 'Encerra sua enquete.', async run(ctx) {
+      await ctx.data.guild.update('enquete:' + ctx.channelID, current => {
+        const poll = readPoll(current);
+        assert(poll.authorID === ctx.authorID, 'Somente o criador pode encerrar esta enquete.');
+        assert(!poll.closed, 'Esta enquete já foi encerrada.');
+        return { ...poll, closed: true };
+      });
+      await ctx.reply('Enquete encerrada. O resultado continua disponível.');
+    } },
+  ],
+});
+`,
+    'economy/balance': `import { arg, defineCommand } from 'yuzuha';
+import { readBalance } from '../../helpers/state.js';
+
+export default defineCommand({
+  name: 'saldo', description: 'Consulta moedas virtuais neste servidor.', guildOnly: true,
+  args: { usuario: arg.user() },
+  async run(ctx) {
+    const id = ctx.args.get('usuario') ?? ctx.authorID;
+    const balance = readBalance(await ctx.data.guild.get('saldo:' + id, 0));
+    await ctx.reply({ embeds: [{ title: 'Carteira', color: 0x5865F2, fields: [
+      { name: 'Usuário (ID)', value: id, inline: true },
+      { name: 'Moedas', value: String(balance), inline: true },
+    ] }] });
+  },
+});
+`,
+    'economy/daily': `import { assert, defineCommand } from 'yuzuha';
+import { readBalance } from '../../helpers/state.js';
+
+export default defineCommand({
+  name: 'diario', description: 'Recebe 100 moedas a cada 24 horas.', guildOnly: true,
+  async run(ctx) {
+    const balance = await ctx.data.transaction(data => {
+      const claim = 'diario:' + ctx.authorID;
+      assert(data.guild.get(claim) === null, 'Você já recebeu esta recompensa. Aguarde o prazo.');
+      const key = 'saldo:' + ctx.authorID;
+      const next = readBalance(readBalance(data.guild.get(key, 0)) + 100);
+      data.guild.set(key, next);
+      data.guild.set(claim, true, { ttlMs: 86400000 });
+      return next;
+    });
+    await ctx.reply({ embeds: [{ title: 'Recompensa recebida', color: 0x5865F2,
+      description: '100 moedas adicionadas.', fields: [{ name: 'Saldo', value: String(balance), inline: true }],
+    }] });
+  },
+});
+`,
+    'economy/work': `import { assert, defineCommand } from 'yuzuha';
+import { readBalance } from '../../helpers/state.js';
+
+export default defineCommand({
+  name: 'trabalhar', description: 'Recebe 25 moedas a cada hora.', guildOnly: true,
+  async run(ctx) {
+    const balance = await ctx.data.transaction(data => {
+      const claim = 'trabalhar:' + ctx.authorID;
+      assert(data.guild.get(claim) === null, 'Você já recebeu esta recompensa. Aguarde o prazo.');
+      const key = 'saldo:' + ctx.authorID;
+      const next = readBalance(readBalance(data.guild.get(key, 0)) + 25);
+      data.guild.set(key, next);
+      data.guild.set(claim, true, { ttlMs: 3600000 });
+      return next;
+    });
+    await ctx.reply({ embeds: [{ title: 'Recompensa recebida', color: 0x5865F2,
+      description: '25 moedas adicionadas.', fields: [{ name: 'Saldo', value: String(balance), inline: true }],
+    }] });
+  },
+});
+`,
+    'economy/pay': `import { arg, assert, defineCommand } from 'yuzuha';
+import { readBalance } from '../../helpers/state.js';
+
+export default defineCommand({
+  name: 'pagar', description: 'Transfere moedas virtuais para outra pessoa neste servidor.', guildOnly: true,
+  args: { usuario: arg.user().required(), quantidade: arg.integer().min(1).max(1000000).required() },
+  async run(ctx) {
+    const id = ctx.args.get('usuario');
+    const amount = ctx.args.get('quantidade');
+    assert(id !== ctx.authorID, 'Escolha outra pessoa.');
+    const user = await ctx.resources.users.user(id);
+    assert(!user.bot, 'Transferências para bots não são permitidas.');
+    await ctx.data.transaction(data => {
+      const fromKey = 'saldo:' + ctx.authorID;
+      const toKey = 'saldo:' + id;
+      const balance = readBalance(data.guild.get(fromKey, 0));
+      assert(balance >= amount, 'Saldo insuficiente.');
+      const received = readBalance(readBalance(data.guild.get(toKey, 0)) + amount);
+      data.guild.set(fromKey, balance - amount);
+      data.guild.set(toKey, received);
+    });
+    await ctx.reply('Transferência concluída: ' + amount + ' moedas para ' + id + '.');
+  },
+});
+`,
+    'fun/choose': `import { randomInt } from 'node:crypto';
+import { arg, assert, defineCommand } from 'yuzuha';
+
+export default defineCommand({
+  name: 'escolher', description: 'Escolhe entre 2 a 20 opções separadas por |.',
+  args: { opcoes: arg.text().rest().max(1500).required() },
+  async run(ctx) {
+    const options = ctx.args.get('opcoes').split('|').map(option => option.trim());
+    assert(options.length >= 2 && options.length <= 20 && options.every(option => option.length > 0 && option.length <= 100),
+      'Informe de 2 a 20 opções não vazias de até 100 caracteres, separadas por |.');
+    await ctx.reply({ embeds: [{ title: 'Minha escolha', description: options[randomInt(options.length)], color: 0x5865F2 }] });
+  },
+});
+`,
+    'fun/eightball': `import { randomInt } from 'node:crypto';
+import { arg, defineCommand } from 'yuzuha';
+
+const answers = ['Sim.', 'Não.', 'Talvez.', 'Pergunte outra vez.', 'Tudo indica que sim.', 'Melhor esperar.'];
+
+export default defineCommand({
+  name: 'bola8', aliases: ['8ball'], description: 'Responde uma pergunta por diversão.',
+  args: { pergunta: arg.text().rest().min(1).max(500).required() },
+  async run(ctx) {
+    await ctx.reply({ embeds: [{ title: 'Bola 8', description: ctx.args.get('pergunta'), color: 0x5865F2,
+      fields: [{ name: 'Resposta', value: answers[randomInt(answers.length)], inline: false }],
+      footer: { text: 'Resposta aleatória, só por diversão.' },
+    }] });
+  },
+});
+`,
+    'utilities/notes': `import { arg, assert, defineCommand } from 'yuzuha';
+import { readStrings } from '../../helpers/state.js';
+
+export default defineCommand({
+  name: 'notas', description: 'Notas pessoais, disponíveis apenas em mensagens diretas.',
+  checks: [ctx => !ctx.guildID || 'Use notas em uma mensagem direta com o bot.'],
+  subcommands: [
+    defineCommand({ name: 'adicionar', description: 'Adiciona uma nota (até 10 notas).',
+      args: { texto: arg.text().rest().min(1).max(300).required() },
+      async run(ctx) {
+        const count = await ctx.data.user.update('notas', current => {
+          const notes = readStrings(current);
+          assert(notes.length < 10, 'Você atingiu o limite de 10 notas. Apague uma antes de adicionar outra.');
+          return [...notes, ctx.args.get('texto')];
+        }, []);
+        await ctx.reply('Nota #' + count.length + ' salva.');
+      },
+    }),
+    { name: 'listar', description: 'Lista suas notas.', async run(ctx) {
+      const notes = readStrings(await ctx.data.user.get('notas', []));
+      await ctx.reply({ embeds: [{ title: 'Suas notas', color: 0x5865F2,
+        description: notes.map((note, index) => (index + 1) + '. ' + note).join('\\n') || 'Nenhuma nota salva.',
+      }] });
+    } },
+    defineCommand({ name: 'apagar', description: 'Apaga uma nota pelo número atual.',
+      args: { numero: arg.integer().min(1).max(10).required() },
+      async run(ctx) {
+        const index = ctx.args.get('numero') - 1;
+        await ctx.data.user.update('notas', current => {
+          const notes = readStrings(current);
+          assert(index < notes.length, 'Nota não encontrada.');
+          return notes.filter((_, position) => position !== index);
+        }, []);
+        await ctx.reply('Nota apagada. Os números das notas seguintes foram atualizados.');
+      },
+    }),
+  ],
+});
+`,
+    'utilities/timestamp': `import { arg, assert, defineCommand } from 'yuzuha';
+
+export default defineCommand({
+  name: 'data', description: 'Converte uma data ISO com fuso para UTC e Unix em segundos.',
+  args: { iso: arg.text().max(35).required() },
+  async run(ctx) {
+    const iso = ctx.args.get('iso');
+    assert(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:Z|[+-]\\d{2}:\\d{2})$/.test(iso),
+      'Use ISO com fuso, por exemplo 2026-01-20T18:30:00-03:00.');
+    const date = new Date(iso);
+    assert(Number.isFinite(date.getTime()), 'Data inválida.');
+    assert(new Date(iso.slice(0, 10) + 'T00:00:00Z').toISOString().slice(0, 10) === iso.slice(0, 10)
+      && Number(iso.slice(11, 13)) < 24, 'Data inválida.');
+    await ctx.reply({ embeds: [{ title: 'Data convertida', color: 0x5865F2, fields: [
+      { name: 'UTC', value: date.toISOString(), inline: false },
+      { name: 'Unix (segundos)', value: String(Math.floor(date.getTime() / 1000)), inline: false },
+    ] }] });
+  },
+});
+`,
+};
+//# sourceMappingURL=bot-template-commands.js.map

package/dist/cli/bot-template-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-template-commands.js","sourceRoot":"","sources":["../../src/cli/bot-template-commands.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBpB;IACC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB;IACC,kBAAkB,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBrB;IACC,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;CAmBpB;IACC,iBAAiB,EAAE;;;;;;;;;;;;;;;;CAgBpB;IACC,uBAAuB,EAAE;;;;;;;;;;;;;;;;;;;;;;CAsB1B;IACC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDnB;IACC,iBAAiB,EAAE;;;;;;;;;;;;;;;CAepB;IACC,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;CAoBlB;IACC,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;CAoBjB;IACC,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBhB;IACC,YAAY,EAAE;;;;;;;;;;;;;CAaf;IACC,eAAe,EAAE;;;;;;;;;;;;;;;CAelB;IACC,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCpB;IACC,qBAAqB,EAAE;;;;;;;;;;;;;;;;;;;CAmBxB;CACA,CAAC","sourcesContent":["export const extraCommands: Record<string, string> = {\n  'moderation/kick': `import { arg, defineCommand } from 'yuzuha';\n\nexport default defineCommand({\n  name: 'kick',\n  description: 'Expulsa um membro e registra um caso.',\n  guildOnly: true,\n  args: {\n    membro: arg.user().required(),\n    motivo: arg.text().rest().min(1).max(400).required(),\n  },\n  async run(ctx) {\n    const record = await ctx.mod.kick(ctx.args.get('membro'), {\n      reason: ctx.args.get('motivo'),\n    });\n    await ctx.reply({ embeds: [{ title: 'Caso #' + record.id, color: 0x5865F2,\n      fields: [\n        { name: 'Ação', value: record.action, inline: true },\n        { name: 'Usuário (ID)', value: record.targetID, inline: true },\n        { name: 'Motivo', value: record.reason, inline: false },\n      ],\n    }] });\n  },\n});\n`,\n  'moderation/timeout': `import { arg, defineCommand } from 'yuzuha';\n\nexport default defineCommand({\n  name: 'timeout',\n  description: 'Aplica timeout a um membro e registra um caso.',\n  guildOnly: true,\n  args: {\n    membro: arg.user().required(),\n    duracao: arg.duration().min(1000).max(2419200000).required(),\n    motivo: arg.text().rest().min(1).max(400).required(),\n  },\n  async run(ctx) {\n    const record = await ctx.mod.timeout(ctx.args.get('membro'), {\n      reason: ctx.args.get('motivo'),\n      duration: ctx.args.get('duracao'),\n    });\n    await ctx.reply({ embeds: [{ title: 'Caso #' + record.id, color: 0x5865F2,\n      fields: [\n        { name: 'Ação', value: record.action, inline: true },\n        { name: 'Usuário (ID)', value: record.targetID, inline: true },\n        { name: 'Motivo', value: record.reason, inline: false },\n      ],\n    }] });\n  },\n});\n`,\n  'moderation/unban': `import { arg, defineCommand } from 'yuzuha';\n\nexport default defineCommand({\n  name: 'unban',\n  description: 'Remove um banimento e registra um caso.',\n  guildOnly: true,\n  args: {\n    membro: arg.user().required(),\n    motivo: arg.text().rest().min(1).max(400).required(),\n  },\n  async run(ctx) {\n    const record = await ctx.mod.unban(ctx.args.get('membro'), {\n      reason: ctx.args.get('motivo'),\n    });\n    await ctx.reply({ embeds: [{ title: 'Caso #' + record.id, color: 0x5865F2,\n      fields: [\n        { name: 'Ação', value: record.action, inline: true },\n        { name: 'Usuário (ID)', value: record.targetID, inline: true },\n        { name: 'Motivo', value: record.reason, inline: false },\n      ],\n    }] });\n  },\n});\n`,\n  'moderation/case': `import { arg, defineCommand } from 'yuzuha';\n\nexport default defineCommand({\n  name: 'caso', description: 'Consulta um caso de moderação deste servidor.',\n  guildOnly: true, permissions: ['ManageGuild'],\n  args: { numero: arg.integer().min(1).required() },\n  async run(ctx) {\n    const record = await ctx.case(ctx.args.get('numero'));\n    if (!record) { await ctx.reply('Caso não encontrado neste servidor.'); return; }\n    await ctx.reply({ embeds: [{ title: 'Caso #' + record.id, color: 0x5865F2,\n      fields: [\n        { name: 'Ação', value: record.action, inline: true },\n        { name: 'Usuário (ID)', value: record.targetID, inline: true },\n        { name: 'Moderador (ID)', value: record.moderatorID, inline: true },\n        { name: 'Motivo', value: record.reason || 'Sem motivo informado.', inline: false },\n      ],\n    }] });\n  },\n});\n`,\n  'community/rules': `import { arg, assert, defineCommand } from 'yuzuha';\n\nexport default defineCommand({\n  name: 'regras', description: 'Consulta ou configura as regras do servidor.', guildOnly: true,\n  subcommands: [\n    { name: 'ver', description: 'Mostra as regras.', async run(ctx) {\n      const text = await ctx.data.guild.get('regras', 'As regras ainda não foram configuradas.');\n      assert(typeof text === 'string' && text.length <= 3000, 'As regras salvas são inválidas.');\n      await ctx.reply({ embeds: [{ title: 'Regras do servidor', description: text, color: 0x5865F2 }] });\n    } },\n    defineCommand({ name: 'definir', description: 'Define as regras (ManageGuild).', permissions: ['ManageGuild'],\n      args: { texto: arg.text().rest().min(1).max(3000).required() },\n      async run(ctx) { await ctx.data.guild.set('regras', ctx.args.get('texto')); await ctx.reply('Regras atualizadas.'); },\n    }),\n  ],\n});\n`,\n  'community/suggestions': `import { arg, defineCommand } from 'yuzuha';\nimport { readStrings } from '../../helpers/state.js';\n\nexport default defineCommand({\n  name: 'sugestao', description: 'Envia e consulta as últimas 10 sugestões públicas.', guildOnly: true,\n  subcommands: [\n    defineCommand({ name: 'enviar', description: 'Envia uma sugestão pública.', cooldown: '30s',\n      args: { texto: arg.text().rest().min(1).max(250).required() },\n      async run(ctx) {\n        const line = ctx.authorID + ': ' + ctx.args.get('texto');\n        await ctx.data.guild.update('sugestoes', current => [...readStrings(current), line].slice(-10), []);\n        await ctx.reply('Sugestão registrada. Use sugestao listar para consultar.');\n      },\n    }),\n    { name: 'listar', description: 'Lista as sugestões públicas mais recentes.', async run(ctx) {\n      const lines = readStrings(await ctx.data.guild.get('sugestoes', []));\n      await ctx.reply({ embeds: [{ title: 'Sugestões da comunidade', color: 0x5865F2,\n        description: lines.join('\\\\n') || 'Ainda não há sugestões.',\n      }] });\n    } },\n  ],\n});\n`,\n  'community/poll': `import { arg, assert, defineCommand } from 'yuzuha';\nimport { readPoll } from '../../helpers/state.js';\n\nexport default defineCommand({\n  name: 'enquete', description: 'Enquete de sim ou não por canal; votos podem ser alterados.', guildOnly: true,\n  subcommands: [\n    defineCommand({ name: 'criar', description: 'Abre uma enquete (ManageGuild).', permissions: ['ManageGuild'],\n      args: { pergunta: arg.text().rest().min(1).max(500).required() },\n      async run(ctx) {\n        await ctx.data.guild.update('enquete:' + ctx.channelID, current => {\n          if (current !== null) assert(readPoll(current).closed, 'Feche a enquete atual antes de criar outra.');\n          return { question: ctx.args.get('pergunta'), authorID: ctx.authorID, closed: false, votes: [] };\n        });\n        await ctx.reply('Enquete aberta. Vote com enquete votar sim ou enquete votar nao.');\n      },\n    }),\n    defineCommand({ name: 'votar', description: 'Registra ou altera seu voto.',\n      args: { voto: arg.text().choices(['sim', 'nao']).required() },\n      async run(ctx) {\n        await ctx.data.guild.update('enquete:' + ctx.channelID, current => {\n          const poll = readPoll(current);\n          assert(!poll.closed, 'Esta enquete já foi encerrada.');\n          const votes = poll.votes.filter(vote => vote.id !== ctx.authorID);\n          assert(votes.length < 1000, 'Esta enquete atingiu o limite de participantes.');\n          return { ...poll, votes: [...votes, { id: ctx.authorID, choice: ctx.args.get('voto') }] };\n        });\n        await ctx.reply('Voto registrado.');\n      },\n    }),\n    { name: 'resultado', description: 'Mostra o resultado atual.', async run(ctx) {\n      const poll = readPoll(await ctx.data.guild.get('enquete:' + ctx.channelID));\n      await ctx.reply({ embeds: [{ title: poll.closed ? 'Enquete encerrada' : 'Enquete aberta',\n        description: poll.question, color: 0x5865F2,\n        fields: ['sim', 'nao'].map(choice => ({ name: choice === 'sim' ? 'Sim' : 'Não',\n          value: String(poll.votes.filter(vote => vote.choice === choice).length), inline: true })),\n      }] });\n    } },\n    { name: 'fechar', description: 'Encerra sua enquete.', async run(ctx) {\n      await ctx.data.guild.update('enquete:' + ctx.channelID, current => {\n        const poll = readPoll(current);\n        assert(poll.authorID === ctx.authorID, 'Somente o criador pode encerrar esta enquete.');\n        assert(!poll.closed, 'Esta enquete já foi encerrada.');\n        return { ...poll, closed: true };\n      });\n      await ctx.reply('Enquete encerrada. O resultado continua disponível.');\n    } },\n  ],\n});\n`,\n  'economy/balance': `import { arg, defineCommand } from 'yuzuha';\nimport { readBalance } from '../../helpers/state.js';\n\nexport default defineCommand({\n  name: 'saldo', description: 'Consulta moedas virtuais neste servidor.', guildOnly: true,\n  args: { usuario: arg.user() },\n  async run(ctx) {\n    const id = ctx.args.get('usuario') ?? ctx.authorID;\n    const balance = readBalance(await ctx.data.guild.get('saldo:' + id, 0));\n    await ctx.reply({ embeds: [{ title: 'Carteira', color: 0x5865F2, fields: [\n      { name: 'Usuário (ID)', value: id, inline: true },\n      { name: 'Moedas', value: String(balance), inline: true },\n    ] }] });\n  },\n});\n`,\n  'economy/daily': `import { assert, defineCommand } from 'yuzuha';\nimport { readBalance } from '../../helpers/state.js';\n\nexport default defineCommand({\n  name: 'diario', description: 'Recebe 100 moedas a cada 24 horas.', guildOnly: true,\n  async run(ctx) {\n    const balance = await ctx.data.transaction(data => {\n      const claim = 'diario:' + ctx.authorID;\n      assert(data.guild.get(claim) === null, 'Você já recebeu esta recompensa. Aguarde o prazo.');\n      const key = 'saldo:' + ctx.authorID;\n      const next = readBalance(readBalance(data.guild.get(key, 0)) + 100);\n      data.guild.set(key, next);\n      data.guild.set(claim, true, { ttlMs: 86400000 });\n      return next;\n    });\n    await ctx.reply({ embeds: [{ title: 'Recompensa recebida', color: 0x5865F2,\n      description: '100 moedas adicionadas.', fields: [{ name: 'Saldo', value: String(balance), inline: true }],\n    }] });\n  },\n});\n`,\n  'economy/work': `import { assert, defineCommand } from 'yuzuha';\nimport { readBalance } from '../../helpers/state.js';\n\nexport default defineCommand({\n  name: 'trabalhar', description: 'Recebe 25 moedas a cada hora.', guildOnly: true,\n  async run(ctx) {\n    const balance = await ctx.data.transaction(data => {\n      const claim = 'trabalhar:' + ctx.authorID;\n      assert(data.guild.get(claim) === null, 'Você já recebeu esta recompensa. Aguarde o prazo.');\n      const key = 'saldo:' + ctx.authorID;\n      const next = readBalance(readBalance(data.guild.get(key, 0)) + 25);\n      data.guild.set(key, next);\n      data.guild.set(claim, true, { ttlMs: 3600000 });\n      return next;\n    });\n    await ctx.reply({ embeds: [{ title: 'Recompensa recebida', color: 0x5865F2,\n      description: '25 moedas adicionadas.', fields: [{ name: 'Saldo', value: String(balance), inline: true }],\n    }] });\n  },\n});\n`,\n  'economy/pay': `import { arg, assert, defineCommand } from 'yuzuha';\nimport { readBalance } from '../../helpers/state.js';\n\nexport default defineCommand({\n  name: 'pagar', description: 'Transfere moedas virtuais para outra pessoa neste servidor.', guildOnly: true,\n  args: { usuario: arg.user().required(), quantidade: arg.integer().min(1).max(1000000).required() },\n  async run(ctx) {\n    const id = ctx.args.get('usuario');\n    const amount = ctx.args.get('quantidade');\n    assert(id !== ctx.authorID, 'Escolha outra pessoa.');\n    const user = await ctx.resources.users.user(id);\n    assert(!user.bot, 'Transferências para bots não são permitidas.');\n    await ctx.data.transaction(data => {\n      const fromKey = 'saldo:' + ctx.authorID;\n      const toKey = 'saldo:' + id;\n      const balance = readBalance(data.guild.get(fromKey, 0));\n      assert(balance >= amount, 'Saldo insuficiente.');\n      const received = readBalance(readBalance(data.guild.get(toKey, 0)) + amount);\n      data.guild.set(fromKey, balance - amount);\n      data.guild.set(toKey, received);\n    });\n    await ctx.reply('Transferência concluída: ' + amount + ' moedas para ' + id + '.');\n  },\n});\n`,\n  'fun/choose': `import { randomInt } from 'node:crypto';\nimport { arg, assert, defineCommand } from 'yuzuha';\n\nexport default defineCommand({\n  name: 'escolher', description: 'Escolhe entre 2 a 20 opções separadas por |.',\n  args: { opcoes: arg.text().rest().max(1500).required() },\n  async run(ctx) {\n    const options = ctx.args.get('opcoes').split('|').map(option => option.trim());\n    assert(options.length >= 2 && options.length <= 20 && options.every(option => option.length > 0 && option.length <= 100),\n      'Informe de 2 a 20 opções não vazias de até 100 caracteres, separadas por |.');\n    await ctx.reply({ embeds: [{ title: 'Minha escolha', description: options[randomInt(options.length)], color: 0x5865F2 }] });\n  },\n});\n`,\n  'fun/eightball': `import { randomInt } from 'node:crypto';\nimport { arg, defineCommand } from 'yuzuha';\n\nconst answers = ['Sim.', 'Não.', 'Talvez.', 'Pergunte outra vez.', 'Tudo indica que sim.', 'Melhor esperar.'];\n\nexport default defineCommand({\n  name: 'bola8', aliases: ['8ball'], description: 'Responde uma pergunta por diversão.',\n  args: { pergunta: arg.text().rest().min(1).max(500).required() },\n  async run(ctx) {\n    await ctx.reply({ embeds: [{ title: 'Bola 8', description: ctx.args.get('pergunta'), color: 0x5865F2,\n      fields: [{ name: 'Resposta', value: answers[randomInt(answers.length)], inline: false }],\n      footer: { text: 'Resposta aleatória, só por diversão.' },\n    }] });\n  },\n});\n`,\n  'utilities/notes': `import { arg, assert, defineCommand } from 'yuzuha';\nimport { readStrings } from '../../helpers/state.js';\n\nexport default defineCommand({\n  name: 'notas', description: 'Notas pessoais, disponíveis apenas em mensagens diretas.',\n  checks: [ctx => !ctx.guildID || 'Use notas em uma mensagem direta com o bot.'],\n  subcommands: [\n    defineCommand({ name: 'adicionar', description: 'Adiciona uma nota (até 10 notas).',\n      args: { texto: arg.text().rest().min(1).max(300).required() },\n      async run(ctx) {\n        const count = await ctx.data.user.update('notas', current => {\n          const notes = readStrings(current);\n          assert(notes.length < 10, 'Você atingiu o limite de 10 notas. Apague uma antes de adicionar outra.');\n          return [...notes, ctx.args.get('texto')];\n        }, []);\n        await ctx.reply('Nota #' + count.length + ' salva.');\n      },\n    }),\n    { name: 'listar', description: 'Lista suas notas.', async run(ctx) {\n      const notes = readStrings(await ctx.data.user.get('notas', []));\n      await ctx.reply({ embeds: [{ title: 'Suas notas', color: 0x5865F2,\n        description: notes.map((note, index) => (index + 1) + '. ' + note).join('\\\\n') || 'Nenhuma nota salva.',\n      }] });\n    } },\n    defineCommand({ name: 'apagar', description: 'Apaga uma nota pelo número atual.',\n      args: { numero: arg.integer().min(1).max(10).required() },\n      async run(ctx) {\n        const index = ctx.args.get('numero') - 1;\n        await ctx.data.user.update('notas', current => {\n          const notes = readStrings(current);\n          assert(index < notes.length, 'Nota não encontrada.');\n          return notes.filter((_, position) => position !== index);\n        }, []);\n        await ctx.reply('Nota apagada. Os números das notas seguintes foram atualizados.');\n      },\n    }),\n  ],\n});\n`,\n  'utilities/timestamp': `import { arg, assert, defineCommand } from 'yuzuha';\n\nexport default defineCommand({\n  name: 'data', description: 'Converte uma data ISO com fuso para UTC e Unix em segundos.',\n  args: { iso: arg.text().max(35).required() },\n  async run(ctx) {\n    const iso = ctx.args.get('iso');\n    assert(/^\\\\d{4}-\\\\d{2}-\\\\d{2}T\\\\d{2}:\\\\d{2}:\\\\d{2}(?:Z|[+-]\\\\d{2}:\\\\d{2})$/.test(iso),\n      'Use ISO com fuso, por exemplo 2026-01-20T18:30:00-03:00.');\n    const date = new Date(iso);\n    assert(Number.isFinite(date.getTime()), 'Data inválida.');\n    assert(new Date(iso.slice(0, 10) + 'T00:00:00Z').toISOString().slice(0, 10) === iso.slice(0, 10)\n      && Number(iso.slice(11, 13)) < 24, 'Data inválida.');\n    await ctx.reply({ embeds: [{ title: 'Data convertida', color: 0x5865F2, fields: [\n      { name: 'UTC', value: date.toISOString(), inline: false },\n      { name: 'Unix (segundos)', value: String(Math.floor(date.getTime() / 1000)), inline: false },\n    ] }] });\n  },\n});\n`,\n};\n"]}

package/dist/cli/bot-template-content.d.ts

@@ -0,0 +1,13 @@
+import type { BotTemplate } from './bot-template-catalog.js';
+export declare const templateExamples: {
+    simple: string[];
+    multifunctional: string[];
+    moderation: string[];
+    community: string[];
+    economy: string[];
+    entertainment: string[];
+    utility: string[];
+};
+export declare function templateReadme(template: BotTemplate): string;
+export declare function templateHelpers(template: BotTemplate, language: 'js' | 'ts'): Record<string, string>;
+//# sourceMappingURL=bot-template-content.d.ts.map

package/dist/cli/bot-template-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-template-content.d.ts","sourceRoot":"","sources":["../../src/cli/bot-template-content.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,gBAAgB;;;;;;;;CAQY,CAAC;AAE1C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAc5D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoCpG"}

package/dist/cli/bot-template-content.js

@@ -0,0 +1,69 @@
+import { botTemplates } from './bot-template-catalog.js';
+export const templateExamples = {
+    simple: ['!ping', '!ajuda', '!sobre', '!avatar @usuario'],
+    multifunctional: ['!ajuda', '!regras definir Respeite os membros.', '!enquete criar Vamos jogar hoje?', '!enquete votar sim', '!diario', '!pagar @usuario 25', '!notas listar', '!caso 1'],
+    moderation: ['!ban @usuario spam', '!kick @usuario spam', '!timeout @usuario 10m spam', '!unban 123456789 revisão', '!caso 1'],
+    community: ['!regras definir Respeite os membros.', '!regras ver', '!sugestao enviar Adicionar um canal de jogos', '!sugestao listar', '!enquete criar Vamos jogar hoje?', '!enquete votar sim', '!enquete resultado', '!enquete fechar'],
+    economy: ['!saldo', '!saldo @usuario', '!diario', '!trabalhar', '!pagar @usuario 25'],
+    entertainment: ['!dado 20', '!moeda', '!escolher pizza | sushi | massa', '!bola8 Vai chover?'],
+    utility: ['!perfil @usuario', '!servidor', '!data 2026-01-20T18:30:00-03:00', '!notas adicionar Comprar café', '!notas listar', '!notas apagar 1'],
+};
+export function templateReadme(template) {
+    const paths = botTemplates[template].paths;
+    const paragraphs = [
+        `Base: **${template}**. ${botTemplates[template].description}`,
+        'Todas as bases incluem `!ping`, `!ajuda` (aliases `help`, `comandos`), `!sobre` e `!avatar [@usuario]`. Ajuda e consultas de informações usam embeds. As pastas de commands são carregadas recursivamente.',
+        `Exemplos:\n\n${templateExamples[template].map(value => `- \`${value}\``).join('\n')}`,
+    ];
+    if (paths.includes('moderation/ban'))
+        paragraphs.push('Moderação exige permissões de autor e bot e hierarquia sobre o alvo. `caso` exige ManageGuild. Kick, timeout e unban exigem motivo; timeout aceita de 1 segundo a 28 dias. Falha depois da ação é parcial: não repita a ação para tentar salvar o caso.');
+    if (paths.includes('community/rules'))
+        paragraphs.push('Regras e criação de enquetes exigem ManageGuild. Há uma enquete de sim/não por canal, até 1000 participantes, com alteração de voto. Somente o criador encerra; o resultado permanece disponível. Sugestões são públicas, limitadas às 10 mais recentes, com cooldown de 30 segundos por autor/canal.');
+    if (paths.includes('economy/daily'))
+        paragraphs.push('Moedas são virtuais e isoladas por servidor. Diário concede 100 a cada 24 horas; trabalho, 25 a cada hora. Prazos persistem após reinício. Transferências de 1 a 1000000 moedas são atômicas, não permitem saldo negativo, autoenvio ou bots. Não há dinheiro real ou pagamentos externos.');
+    if (paths.includes('utilities/notes'))
+        paragraphs.push('Notas funcionam somente em DM, são isoladas por usuário e limitadas a 10 entradas de 300 caracteres. Apagar uma nota renumera as seguintes. `data` exige ISO com fuso explícito e retorna UTC e Unix em segundos.');
+    if (paths.includes('fun/choose'))
+        paragraphs.push('`escolher` aceita de 2 a 20 opções não vazias de até 100 caracteres, separadas por |. `dado` aceita de 2 a 100 lados. `bola8` responde aleatoriamente, apenas por diversão.');
+    paragraphs.push('Os testes usam MockTransport, recursos simulados e store em memória. `check` valida sem login; `npm test` exercita comandos e guards. Dados reais usam o store configurado pela CLI; reinicie o processo após mudar helpers fora de commands/.');
+    return paragraphs.join('\n\n');
+}
+export function templateHelpers(template, language) {
+    const paths = botTemplates[template].paths;
+    if (!paths.some(path => path.startsWith('community/') || path.startsWith('economy/') || path === 'utilities/notes'))
+        return {};
+    const input = language === 'ts' ? ': unknown' : '';
+    return { [`helpers/state.${language}`]: `import { assert } from 'yuzuha';
+
+export function readStrings(value${input}) {
+  assert(Array.isArray(value) && value.length <= 10, 'A lista salva é inválida.');
+  return value.map(item => {
+    assert(typeof item === 'string' && item.length <= 400, 'A entrada salva é inválida.');
+    return item;
+  });
+}
+
+export function readBalance(value${input}) {
+  assert(typeof value === 'number' && Number.isSafeInteger(value) && value >= 0, 'O saldo salvo é inválido ou atingiu o limite.');
+  return value;
+}
+
+function readVote(value${input}) {
+  assert(value !== null && typeof value === 'object' && 'id' in value && 'choice' in value, 'Voto salvo inválido.');
+  assert(typeof value.id === 'string' && (value.choice === 'sim' || value.choice === 'nao'), 'Voto salvo inválido.');
+  return { id: value.id, choice: value.choice };
+}
+
+export function readPoll(value${input}) {
+  assert(value !== null && typeof value === 'object' && 'question' in value && 'authorID' in value && 'closed' in value && 'votes' in value,
+    'Nenhuma enquete válida neste canal.');
+  assert(typeof value.question === 'string' && value.question.length <= 500 && typeof value.authorID === 'string'
+    && typeof value.closed === 'boolean' && Array.isArray(value.votes) && value.votes.length <= 1000,
+    'A enquete salva é inválida.');
+  const votes = value.votes.map(readVote);
+  assert(new Set(votes.map(vote => vote.id)).size === votes.length, 'Há votos duplicados na enquete salva.');
+  return { question: value.question, authorID: value.authorID, closed: value.closed, votes };
+}
+` };
+}
+//# sourceMappingURL=bot-template-content.js.map

package/dist/cli/bot-template-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-template-content.js","sourceRoot":"","sources":["../../src/cli/bot-template-content.ts"],"names":[],"mappings":"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","sourcesContent":["import { botTemplates } from './bot-template-catalog.js';\nimport type { BotTemplate } from './bot-template-catalog.js';\n\nexport const templateExamples = {\n  simple: ['!ping', '!ajuda', '!sobre', '!avatar @usuario'],\n  multifunctional: ['!ajuda', '!regras definir Respeite os membros.', '!enquete criar Vamos jogar hoje?', '!enquete votar sim', '!diario', '!pagar @usuario 25', '!notas listar', '!caso 1'],\n  moderation: ['!ban @usuario spam', '!kick @usuario spam', '!timeout @usuario 10m spam', '!unban 123456789 revisão', '!caso 1'],\n  community: ['!regras definir Respeite os membros.', '!regras ver', '!sugestao enviar Adicionar um canal de jogos', '!sugestao listar', '!enquete criar Vamos jogar hoje?', '!enquete votar sim', '!enquete resultado', '!enquete fechar'],\n  economy: ['!saldo', '!saldo @usuario', '!diario', '!trabalhar', '!pagar @usuario 25'],\n  entertainment: ['!dado 20', '!moeda', '!escolher pizza | sushi | massa', '!bola8 Vai chover?'],\n  utility: ['!perfil @usuario', '!servidor', '!data 2026-01-20T18:30:00-03:00', '!notas adicionar Comprar café', '!notas listar', '!notas apagar 1'],\n} satisfies Record<BotTemplate, string[]>;\n\nexport function templateReadme(template: BotTemplate): string {\n  const paths: readonly string[] = botTemplates[template].paths;\n  const paragraphs = [\n    `Base: **${template}**. ${botTemplates[template].description}`,\n    'Todas as bases incluem `!ping`, `!ajuda` (aliases `help`, `comandos`), `!sobre` e `!avatar [@usuario]`. Ajuda e consultas de informações usam embeds. As pastas de commands são carregadas recursivamente.',\n    `Exemplos:\\n\\n${templateExamples[template].map(value => `- \\`${value}\\``).join('\\n')}`,\n  ];\n  if (paths.includes('moderation/ban')) paragraphs.push('Moderação exige permissões de autor e bot e hierarquia sobre o alvo. `caso` exige ManageGuild. Kick, timeout e unban exigem motivo; timeout aceita de 1 segundo a 28 dias. Falha depois da ação é parcial: não repita a ação para tentar salvar o caso.');\n  if (paths.includes('community/rules')) paragraphs.push('Regras e criação de enquetes exigem ManageGuild. Há uma enquete de sim/não por canal, até 1000 participantes, com alteração de voto. Somente o criador encerra; o resultado permanece disponível. Sugestões são públicas, limitadas às 10 mais recentes, com cooldown de 30 segundos por autor/canal.');\n  if (paths.includes('economy/daily')) paragraphs.push('Moedas são virtuais e isoladas por servidor. Diário concede 100 a cada 24 horas; trabalho, 25 a cada hora. Prazos persistem após reinício. Transferências de 1 a 1000000 moedas são atômicas, não permitem saldo negativo, autoenvio ou bots. Não há dinheiro real ou pagamentos externos.');\n  if (paths.includes('utilities/notes')) paragraphs.push('Notas funcionam somente em DM, são isoladas por usuário e limitadas a 10 entradas de 300 caracteres. Apagar uma nota renumera as seguintes. `data` exige ISO com fuso explícito e retorna UTC e Unix em segundos.');\n  if (paths.includes('fun/choose')) paragraphs.push('`escolher` aceita de 2 a 20 opções não vazias de até 100 caracteres, separadas por |. `dado` aceita de 2 a 100 lados. `bola8` responde aleatoriamente, apenas por diversão.');\n  paragraphs.push('Os testes usam MockTransport, recursos simulados e store em memória. `check` valida sem login; `npm test` exercita comandos e guards. Dados reais usam o store configurado pela CLI; reinicie o processo após mudar helpers fora de commands/.');\n  return paragraphs.join('\\n\\n');\n}\n\nexport function templateHelpers(template: BotTemplate, language: 'js' | 'ts'): Record<string, string> {\n  const paths: readonly string[] = botTemplates[template].paths;\n  if (!paths.some(path => path.startsWith('community/') || path.startsWith('economy/') || path === 'utilities/notes')) return {};\n  const input = language === 'ts' ? ': unknown' : '';\n  return { [`helpers/state.${language}`]: `import { assert } from 'yuzuha';\n\nexport function readStrings(value${input}) {\n  assert(Array.isArray(value) && value.length <= 10, 'A lista salva é inválida.');\n  return value.map(item => {\n    assert(typeof item === 'string' && item.length <= 400, 'A entrada salva é inválida.');\n    return item;\n  });\n}\n\nexport function readBalance(value${input}) {\n  assert(typeof value === 'number' && Number.isSafeInteger(value) && value >= 0, 'O saldo salvo é inválido ou atingiu o limite.');\n  return value;\n}\n\nfunction readVote(value${input}) {\n  assert(value !== null && typeof value === 'object' && 'id' in value && 'choice' in value, 'Voto salvo inválido.');\n  assert(typeof value.id === 'string' && (value.choice === 'sim' || value.choice === 'nao'), 'Voto salvo inválido.');\n  return { id: value.id, choice: value.choice };\n}\n\nexport function readPoll(value${input}) {\n  assert(value !== null && typeof value === 'object' && 'question' in value && 'authorID' in value && 'closed' in value && 'votes' in value,\n    'Nenhuma enquete válida neste canal.');\n  assert(typeof value.question === 'string' && value.question.length <= 500 && typeof value.authorID === 'string'\n    && typeof value.closed === 'boolean' && Array.isArray(value.votes) && value.votes.length <= 1000,\n    'A enquete salva é inválida.');\n  const votes = value.votes.map(readVote);\n  assert(new Set(votes.map(vote => vote.id)).size === votes.length, 'Há votos duplicados na enquete salva.');\n  return { question: value.question, authorID: value.authorID, closed: value.closed, votes };\n}\n` };\n}\n"]}

package/dist/cli/bot-template-feature-tests.d.ts

@@ -0,0 +1,2 @@
+export declare function featureTests(paths: readonly string[]): string;
+//# sourceMappingURL=bot-template-feature-tests.d.ts.map

package/dist/cli/bot-template-feature-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-template-feature-tests.d.ts","sourceRoot":"","sources":["../../src/cli/bot-template-feature-tests.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CA8J7D"}