@diegofemello/bitbot-types 1.0.3 → 1.1.0

package/README.md

@@ -23,22 +23,25 @@ npm install github:diegofemello/bitbot-types#master
 
 ```typescript
 // Importando interfaces e enums específicos
-import { User, Bot, Card, Pokemon, Auction, UserRole, CommandIndex } from '@diegofemello/bitbot-types';
+import { IUser, Bot, Card, Pokemon, Auction, UserRole, CommandIndex } from '@diegofemello/bitbot-types';
+
+// Importando funções utilitárias
+import { logUserInfo, hasUserRole, formatBitCoins, logCommandExecution, logCardInfo } from '@diegofemello/bitbot-types';
 
 // Importando tudo
 import * as BitBotTypes from '@diegofemello/bitbot-types';
 
-// Exemplos de uso
-const user: BitBotTypes.User = {
+// Exemplos de uso das interfaces
+const user: BitBotTypes.IUser = {
   // ... propriedades do usuário
   roles: [UserRole.User, UserRole.Vip]
 };
 
-const command = CommandIndex.abracar;
-
-const card: BitBotTypes.Card = {
-  // ... propriedades do card
-};
+// Exemplos de uso das funções utilitárias
+logUserInfo(user, '[DEBUG]');
+hasUserRole(user, UserRole.Admin);
+formatBitCoins(12500); // "12.500 BitCoins"
+logCommandExecution(CommandIndex.abracar, user.id_usuario, true);
 ```
 
 ## 📋 Interfaces Disponíveis
@@ -63,26 +66,63 @@ const card: BitBotTypes.Card = {
 | `CommandIndex` | Índice de comandos do bot | `abracar`, `addgrupo`, `atividade`, etc. |
 | `UserRole` | Níveis de acesso do usuário | `User`, `Admin`, `GameMaster`, `SuperAdmin`, `Moderator`, `Vip` |
 
+## 🛠️ Funções Utilitárias
+
+### 👤 User Utils
+- `logUserInfo(user, prefix?)` - Faz log das informações do usuário
+- `hasUserRole(user, role)` - Verifica se usuário tem uma role específica
+- `formatBitCoins(amount)` - Formata valor de BitCoins com separadores
+
+### ⚡ Command Utils
+- `logCommandExecution(command, userId, success?)` - Loga execução de comandos
+- `isGameCommand(command)` - Verifica se é um comando de jogo
+- `formatExecutionTime(startTime, endTime?)` - Formata tempo de execução
+
+### 🃏 Card Utils
+- `logCardInfo(card, context?)` - Faz log das informações da carta
+- `isRareCard(card)` - Verifica se a carta é rara (raridade >= 8)
+- `calculateCardValue(card, baseValue?)` - Calcula valor da carta baseado na raridade
+- `getCardsStats(cards)` - Gera estatísticas de múltiplas cartas
+
 ## ✅ Testando a Instalação
 
 Para testar se a instalação funcionou corretamente, você pode criar um arquivo de teste:
 
 ```typescript
 // test.ts
-import { User, CommandIndex, Card, Pokemon, UserRole } from '@diegofemello/bitbot-types';
-
-// Teste de enum
-console.log('Comando:', CommandIndex.abracar);
-console.log('Role:', UserRole.Admin);
-
-// Teste de interface
-const user: User = {
-  id: '123',
-  roles: [UserRole.User],
-  // ... outras propriedades
+import { 
+  IUser, 
+  CommandIndex, 
+  UserRole, 
+  logUserInfo, 
+  hasUserRole, 
+  formatBitCoins,
+  logCommandExecution 
+} from '@diegofemello/bitbot-types';
+
+// Teste de interface e funções utilitárias
+const user: IUser = {
+  _id: '123',
+  id_usuario: 'user123',
+  nome: 'João',
+  bitbcoins: 12500,
+  slots: 5,
+  frags: 10,
+  xp: 500,
+  createdAt: new Date(),
+  updatedAt: new Date(),
+  pontuacao: 100,
+  discord_id: 'discord123',
+  roles: [UserRole.User, UserRole.Vip]
 };
 
-console.log('Tipos importados com sucesso!');
+// Testando as funções utilitárias
+logUserInfo(user, '[TEST]');
+hasUserRole(user, UserRole.Admin);
+console.log(formatBitCoins(user.bitbcoins));
+logCommandExecution(CommandIndex.abracar, user.id_usuario, true);
+
+console.log('✅ Tipos e funções importados com sucesso!');
 ```
 
 ## 🛠️ Desenvolvimento

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./interfaces";
 export * from "./enum";
+export * from "./utils";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAG7B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAG7B,cAAc,QAAQ,CAAC;AAGvB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -18,3 +18,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./interfaces"), exports);
 // Export all enums
 __exportStar(require("./enum"), exports);
+// Export all utilities
+__exportStar(require("./utils"), exports);

package/dist/utils/card.utils.d.ts

@@ -0,0 +1,31 @@
+import { ICard } from '../interfaces';
+/**
+ * Função utilitária para logar informações de uma carta
+ * @param card - Objeto carta do tipo ICard
+ * @param context - Contexto do log (opcional)
+ */
+export declare function logCardInfo(card: ICard, context?: string): void;
+/**
+ * Verifica se uma carta é rara (raridade >= 8)
+ * @param card - Carta a ser verificada
+ * @returns true se a carta é rara
+ */
+export declare function isRareCard(card: ICard): boolean;
+/**
+ * Calcula o valor de uma carta baseado em sua raridade
+ * @param card - Carta para calcular o valor
+ * @param baseValue - Valor base (padrão: 100)
+ * @returns Valor calculado
+ */
+export declare function calculateCardValue(card: ICard, baseValue?: number): number;
+/**
+ * Gera um resumo rápido de múltiplas cartas
+ * @param cards - Array de cartas
+ * @returns Objeto com estatísticas
+ */
+export declare function getCardsStats(cards: ICard[]): {
+    total: number;
+    raras: number;
+    valorTotal: number;
+};
+//# sourceMappingURL=card.utils.d.ts.map

package/dist/utils/card.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.utils.d.ts","sourceRoot":"","sources":["../../src/utils/card.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,GAAE,MAAiB,GAAG,IAAI,CAczE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAI/C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAO/E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAUlG"}

package/dist/utils/card.utils.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logCardInfo = logCardInfo;
+exports.isRareCard = isRareCard;
+exports.calculateCardValue = calculateCardValue;
+exports.getCardsStats = getCardsStats;
+/**
+ * Função utilitária para logar informações de uma carta
+ * @param card - Objeto carta do tipo ICard
+ * @param context - Contexto do log (opcional)
+ */
+function logCardInfo(card, context = '[CARD]') {
+    console.log(`${context} Nome: ${card.name} | Raridade: ${card.rarity} | ID: ${card.id}`);
+    if (card.price) {
+        console.log(`${context} Preço: ${card.price} BitCoins`);
+    }
+    if (card.title) {
+        console.log(`${context} Título: ${card.title}`);
+    }
+    if (card.description) {
+        console.log(`${context} Descrição: ${card.description.substring(0, 100)}...`);
+    }
+}
+/**
+ * Verifica se uma carta é rara (raridade >= 8)
+ * @param card - Carta a ser verificada
+ * @returns true se a carta é rara
+ */
+function isRareCard(card) {
+    const isRare = card.rarity >= 8;
+    console.log(`[RARITY_CHECK] Carta ${card.name} ${isRare ? 'É' : 'NÃO É'} rara (raridade: ${card.rarity})`);
+    return isRare;
+}
+/**
+ * Calcula o valor de uma carta baseado em sua raridade
+ * @param card - Carta para calcular o valor
+ * @param baseValue - Valor base (padrão: 100)
+ * @returns Valor calculado
+ */
+function calculateCardValue(card, baseValue = 100) {
+    const multiplier = Math.pow(1.5, card.rarity);
+    const calculatedValue = Math.floor(baseValue * multiplier);
+    console.log(`[CARD_VALUE] Carta ${card.name} (raridade ${card.rarity}) vale ${calculatedValue} BitCoins`);
+    return calculatedValue;
+}
+/**
+ * Gera um resumo rápido de múltiplas cartas
+ * @param cards - Array de cartas
+ * @returns Objeto com estatísticas
+ */
+function getCardsStats(cards) {
+    const stats = {
+        total: cards.length,
+        raras: cards.filter(card => isRareCard(card)).length,
+        valorTotal: cards.reduce((total, card) => total + calculateCardValue(card), 0)
+    };
+    console.log(`[CARDS_STATS] Total: ${stats.total} | Raras: ${stats.raras} | Valor Total: ${stats.valorTotal} BitCoins`);
+    return stats;
+}

package/dist/utils/command.utils.d.ts

@@ -0,0 +1,22 @@
+import { CommandIndex } from '../enum';
+/**
+ * Função utilitária para logar execução de comandos
+ * @param command - Comando executado
+ * @param userId - ID do usuário que executou
+ * @param success - Se o comando foi executado com sucesso
+ */
+export declare function logCommandExecution(command: CommandIndex, userId: string, success?: boolean): void;
+/**
+ * Verifica se um comando é relacionado a jogos
+ * @param command - Comando a ser verificado
+ * @returns true se é um comando de jogo
+ */
+export declare function isGameCommand(command: CommandIndex): boolean;
+/**
+ * Formata tempo de execução de comando
+ * @param startTime - Timestamp de início
+ * @param endTime - Timestamp de fim (opcional, usa Date.now() se não fornecido)
+ * @returns Tempo formatado em ms
+ */
+export declare function formatExecutionTime(startTime: number, endTime?: number): string;
+//# sourceMappingURL=command.utils.d.ts.map

package/dist/utils/command.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.utils.d.ts","sourceRoot":"","sources":["../../src/utils/command.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAc,GAAG,IAAI,CAKxG;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAa5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAW/E"}

package/dist/utils/command.utils.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logCommandExecution = logCommandExecution;
+exports.isGameCommand = isGameCommand;
+exports.formatExecutionTime = formatExecutionTime;
+const enum_1 = require("../enum");
+/**
+ * Função utilitária para logar execução de comandos
+ * @param command - Comando executado
+ * @param userId - ID do usuário que executou
+ * @param success - Se o comando foi executado com sucesso
+ */
+function logCommandExecution(command, userId, success = true) {
+    const status = success ? '✅ SUCESSO' : '❌ ERRO';
+    const timestamp = new Date().toISOString();
+    console.log(`[COMMAND] ${timestamp} - ${status} - Usuário: ${userId} - Comando: ${command}`);
+}
+/**
+ * Verifica se um comando é relacionado a jogos
+ * @param command - Comando a ser verificado
+ * @returns true se é um comando de jogo
+ */
+function isGameCommand(command) {
+    const gameCommands = [
+        enum_1.CommandIndex.bicho,
+        enum_1.CommandIndex.bingo,
+        enum_1.CommandIndex.capturar,
+        enum_1.CommandIndex.caracoroa,
+        // Adicione mais comandos de jogo conforme necessário
+    ];
+    const isGame = gameCommands.includes(command);
+    console.log(`[GAME_CHECK] Comando ${command} ${isGame ? 'É' : 'NÃO É'} um comando de jogo`);
+    return isGame;
+}
+/**
+ * Formata tempo de execução de comando
+ * @param startTime - Timestamp de início
+ * @param endTime - Timestamp de fim (opcional, usa Date.now() se não fornecido)
+ * @returns Tempo formatado em ms
+ */
+function formatExecutionTime(startTime, endTime) {
+    const end = endTime || Date.now();
+    const duration = end - startTime;
+    console.log(`[PERFORMANCE] Comando executado em ${duration}ms`);
+    if (duration > 1000) {
+        return `${(duration / 1000).toFixed(2)}s`;
+    }
+    return `${duration}ms`;
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './user.utils';
+export * from './command.utils';
+export * from './card.utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Export all utility functions
+__exportStar(require("./user.utils"), exports);
+__exportStar(require("./command.utils"), exports);
+__exportStar(require("./card.utils"), exports);

package/dist/utils/user.utils.d.ts

@@ -0,0 +1,21 @@
+import { IUser, UserRole } from '../interfaces';
+/**
+ * Função utilitária para fazer log de informações do usuário
+ * @param user - Objeto usuário do tipo IUser
+ * @param prefix - Prefixo para o log (opcional)
+ */
+export declare function logUserInfo(user: IUser, prefix?: string): void;
+/**
+ * Verifica se um usuário tem uma role específica
+ * @param user - Objeto usuário
+ * @param role - Role a ser verificada
+ * @returns true se o usuário tem a role
+ */
+export declare function hasUserRole(user: IUser, role: UserRole): boolean;
+/**
+ * Formata BitCoins com separadores de milhares
+ * @param amount - Quantidade de BitCoins
+ * @returns String formatada
+ */
+export declare function formatBitCoins(amount: number): string;
+//# sourceMappingURL=user.utils.d.ts.map

package/dist/utils/user.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.utils.d.ts","sourceRoot":"","sources":["../../src/utils/user.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,GAAE,MAAiB,GAAG,IAAI,CAUxE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/utils/user.utils.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logUserInfo = logUserInfo;
+exports.hasUserRole = hasUserRole;
+exports.formatBitCoins = formatBitCoins;
+/**
+ * Função utilitária para fazer log de informações do usuário
+ * @param user - Objeto usuário do tipo IUser
+ * @param prefix - Prefixo para o log (opcional)
+ */
+function logUserInfo(user, prefix = '[USER]') {
+    console.log(`${prefix} ID: ${user.id_usuario}, Nome: ${user.nome}, BitCoins: ${user.bitbcoins}`);
+    if (user.roles && user.roles.length > 0) {
+        console.log(`${prefix} Roles: ${user.roles.join(', ')}`);
+    }
+    if (user.vip?.status) {
+        console.log(`${prefix} VIP até: ${user.vip.until}`);
+    }
+}
+/**
+ * Verifica se um usuário tem uma role específica
+ * @param user - Objeto usuário
+ * @param role - Role a ser verificada
+ * @returns true se o usuário tem a role
+ */
+function hasUserRole(user, role) {
+    const hasRole = user.roles?.includes(role) || false;
+    console.log(`[ROLE_CHECK] Usuário ${user.nome} ${hasRole ? 'TEM' : 'NÃO TEM'} a role: ${role}`);
+    return hasRole;
+}
+/**
+ * Formata BitCoins com separadores de milhares
+ * @param amount - Quantidade de BitCoins
+ * @returns String formatada
+ */
+function formatBitCoins(amount) {
+    const formatted = amount.toLocaleString('pt-BR');
+    console.log(`[BITCOINS] Formatando ${amount} -> ${formatted} BitCoins`);
+    return `${formatted} BitCoins`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegofemello/bitbot-types",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "Interfaces e tipos compartilhados do Bit Bot",
   "license": "MIT",
   "author": "Diego Mello <diegofemello@example.com>",
@@ -42,6 +42,7 @@
     "gaming"
   ],
   "devDependencies": {
+    "@types/node": "^24.0.13",
     "rimraf": "^5.0.10",
     "typescript": "^5.0.0"
   },