sequelize-game-bank 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, RPM-programmer (GitHub) / prm-programer (npm)
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+> # sequelize-game-bank
+
+<img src="./src/logo/icon.png" alt="sequelize-game-bank logo" width="160" height="160" style="border-radius: 12%; margin-bottom: 20px;" />
+
+## npm модуль для создания полноценного банка на express, sequelize (sqlite).
+
+## О проекте
+
+**sequelize-game-bank** — это готовый бэкенд-модуль, который за пару строк кода разворачивает изолированную банковскую систему для вашей игры или тестовой среды. Он автоматически создает базу данных SQLite через Sequelize и монтирует защищенные REST API роуты для Express.
+
+* **Изолированная песочница:** Идеально для безопасной симуляции балансов, переводов и транзакций без риска реальных денег.
+* **Всё включено:** База данных (SQLite), модели (Sequelize) и готовые эндпоинты (Express) поставляются в одном пакете.
+* **Быстрый старт:** Не требует настройки внешних баз данных — всё работает "из коробки" в локальном файле или памяти.
+* **Поддержка Nodemailer** Возможность отправлять сообщения на gmail
+
+## 🚀 Установка
+
+Установите пакет через ваш любимый менеджер пакетов:
+
+```bash
+npm install sequelize-game-bank
+```
+
+## 💻 Быстрый старт
+
+Просто подключите модуль в ваше существующее Express-приложение:
+
+```javascript
+const BANK = require('./index.js');
+
+const app = (async function initBank(){
+    try {
+        return await BANK();
+    } catch {
+        console.log("Ошибка при инициализации банка!");
+    }
+})();
+
+// Далее ваш код
+```

package/database/models/Account.js

@@ -1,7 +1,6 @@
 const { DataTypes } = require('sequelize');
 const sequelize = require('../config/init-db');
 const User = require('./User');
-
 const Account = sequelize.define('account', {
   id: {
     type: DataTypes.INTEGER,
@@ -37,8 +36,6 @@ const Account = sequelize.define('account', {
     field: '2FA-status'
   }
 });
-
 User.hasMany(Account, { foreignKey: 'user', sourceKey: 'name' });
 Account.belongsTo(User, { foreignKey: 'user', targetKey: 'name', as: 'owner' });
-
-module.exports = Account;
+module.exports = Account;

package/database/models/Credit.js

@@ -1,7 +1,6 @@
 const { DataTypes } = require('sequelize');
 const sequelize = require('../config/init-db');
 const Account = require('./Account');
-
 const Credit = sequelize.define('credit', {
   id: {
     type: DataTypes.INTEGER,
@@ -32,8 +31,6 @@ const Credit = sequelize.define('credit', {
     defaultValue: false
   }
 });
-
 Account.hasMany(Credit, { foreignKey: 'account_id' });
 Credit.belongsTo(Account, { foreignKey: 'account_id', as: 'linkedAccount' });
-
-module.exports = Credit;
+module.exports = Credit;

package/database/models/Transaction.js

@@ -1,7 +1,5 @@
-// database/models/Transaction.js
 const { DataTypes } = require('sequelize');
 const sequelize = require('../config/init-db');
-
 module.exports = sequelize.define('transaction_log', {
   id: {
     type: DataTypes.INTEGER,
@@ -17,11 +15,11 @@ module.exports = sequelize.define('transaction_log', {
     allowNull: false
   },
   sender_or_receiver: {
-    type: DataTypes.STRING, // Никнейм контрагента (для переводов) или описание
+    type: DataTypes.STRING,
     allowNull: true
   },
   amount: {
     type: DataTypes.DECIMAL(15, 2),
     allowNull: false
   }
-});
+});

package/database/models/User.js

@@ -1,6 +1,5 @@
 const { DataTypes } = require('sequelize');
 const sequelize = require('../config/init-db');
-
 const User = sequelize.define('user', {
   name: {
     type: DataTypes.STRING,
@@ -8,11 +7,11 @@ const User = sequelize.define('user', {
     allowNull: false
   },
   user_name: {
-    type: DataTypes.STRING, // Настоящее имя (bcrypt)
+    type: DataTypes.STRING,
     allowNull: false
   },
   user_surname: {
-    type: DataTypes.STRING, // Настоящая фамилия (bcrypt)
+    type: DataTypes.STRING,
     allowNull: false
   },
   user_gmail: {
@@ -27,12 +26,12 @@ const User = sequelize.define('user', {
     field: '2FA-status'
   },
   two_fa_token: {
-    type: DataTypes.STRING, // Хешированный секрет аутентификатора
+    type: DataTypes.STRING,
     allowNull: true,
     field: '2FA-token'
   },
   token: {
-    type: DataTypes.STRING, // Хешированный токен аварийного входа
+    type: DataTypes.STRING,
     allowNull: false
   },
   password: {
@@ -42,9 +41,7 @@ const User = sequelize.define('user', {
   avatar: {
     type: DataTypes.STRING,
     allowNull: true,
-    defaultValue: '/uploads/avatars/default.png' // Стандартная аватарка для всех
+    defaultValue: '/uploads/avatars/default.png'
   }
-
 });
-
-module.exports = User;
+module.exports = User;

package/database/services/account/add-manny.js

@@ -1,19 +1,15 @@
 const Account = require('../../models/Account');
-
+const Transaction = require('../../models/Transaction');
 module.exports = async function addManny(accountId, amount) {
   try {
     const acc = await Account.findByPk(accountId);
     if (!acc) return { status: false, statusCode: -2, message: 'Счет не найден' };
-
     const numericAmount = parseFloat(amount);
     if (isNaN(numericAmount) || numericAmount <= 0) return { status: false, statusCode: -2 };
-
     await acc.increment('manny', { by: numericAmount });
-        const Transaction = require('../../models/Transaction');
     await Transaction.create({ account_id: accountId, type: 'DEPOSIT', sender_or_receiver: 'Администрация (ROOT)', amount: numericAmount });
-
     return { status: true, statusCode: 1 };
   } catch (err) {
     return { status: false, statusCode: -10 };
   }
-};
+};

package/database/services/account/change-pincode.js

@@ -1,23 +1,18 @@
 const bcrypt = require('bcrypt');
 const Account = require('../../models/Account');
-
 module.exports = async function changePincode(accountId, oldPin, newPin) {
   try {
     const acc = await Account.findByPk(accountId);
     if (!acc) return { status: false, statusCode: -2, message: 'Счет не найден' };
-
     const isPinValid = await bcrypt.compare(oldPin, acc.pin_code);
     if (!isPinValid) return { status: false, statusCode: -2, message: 'Неверный текущий пин-код' };
-
     if (!newPin || newPin.length > 8) {
       return { status: false, statusCode: -2, message: 'Новый пин-код должен быть до 8 символов' };
     }
-
     acc.pin_code = await bcrypt.hash(newPin, 10);
     await acc.save();
-
     return { status: true, statusCode: 1 };
   } catch (err) {
     return { status: false, statusCode: -10 };
   }
-};
+};

package/database/services/account/create-credit.js

@@ -1,106 +1,55 @@
-const bcrypt = require('bcrypt');
-const Account = require('../../models/Account');
-const Credit = require('../../models/Credit');
-const User = require('../../models/User');
-const nodemailer = require('nodemailer');
-
-module.exports = async function creatCredit(username, targetAccountId, amount, pinCode, paymentsCount, autoWithdrawal) {
+const Account = require('./../../models/Account');
+const Credit = require('./../../models/Credit');
+const sequelize = require('./../../config/init-db');
+async function createCredit({ accountId, amount, autoRepay = false, rate = 0.1, termMonths = 12 }) {
+  const numericAmount = parseFloat(amount);
+  const numericRate = parseFloat(rate);
+  const numericTerm = parseInt(termMonths, 10);
+  if (!accountId || isNaN(numericAmount) || numericAmount <= 0) {
+    return { success: false, error: 'Некорректные параметры для создания кредита' };
+  }
+  if (isNaN(numericRate) || numericRate < 0 || isNaN(numericTerm) || numericTerm <= 0) {
+    return { success: false, error: 'Некорректная процентная ставка или срок кредитования' };
+  }
+  const transaction = await sequelize.transaction();
   try {
-    const targetAcc = await Account.findByPk(targetAccountId);
-    if (!targetAcc || targetAcc.user !== username) {
-      return { status: false, statusCode: -2, message: 'Целевой счет не найден' };
-    }
-
-    // Проверка пин-кода (-23)
-    const isPinValid = await bcrypt.compare(pinCode, targetAcc.pin_code);
-    if (!isPinValid) return { status: false, statusCode: -23, message: 'Неверный пин-код счета' };
-
-    const creditAmount = parseFloat(amount);
-    if (isNaN(creditAmount) || creditAmount <= 0) return { status: false, statusCode: -2 };
-
-    const paymentAmount = parseFloat((creditAmount / paymentsCount).toFixed(2));
-
-    // 1. Создаем технический счет кредита, куда начисляются заемные деньги
-    const creditAccount = await Account.create({
-      user: username,
-      pin_code: targetAcc.pin_code,
-      manny: creditAmount,
-      active: true,
-      two_fa_status: false
+    const account = await Account.findOne({
+      where: { id: accountId },
+      lock: transaction.LOCK.UPDATE,
+      transaction
     });
-
-    // 2. Регистрируем кредит в таблице мониторинга
-    const newCredit = await Credit.create({
-      account_id: creditAccount.id,
-      total_payments: paymentsCount,
-      remaining_payments: paymentsCount,
-      payment_amount: paymentAmount,
-      auto_withdrawal: autoWithdrawal
+    if (!account) throw new Error('Аккаунт не найден');
+    if (account.status === 'blocked') throw new Error('Аккаунт заблокирован');
+    const existingCredit = await Credit.findOne({
+      where: { accountId: account.id, status: 'active' },
+      transaction,
+      lock: transaction.LOCK.UPDATE
     });
-
-    /**
-     * Автономный метод обработки биллинга (вызывать раз в период через крон / интервал)
-     */
-    async function processCreditBilling(creditId) {
-      try {
-        const credit = await Credit.findByPk(creditId, { include: [{ model: Account, as: 'linkedAccount' }] });
-        if (!credit) return;
-
-        const linkedAcc = credit.linkedAccount;
-        const owner = await User.findByPk(username);
-
-        let paymentSuccess = false;
-
-        // Если автономное списание разрешено ТЗ
-        if (credit.auto_withdrawal && linkedAcc) {
-          if (parseFloat(linkedAcc.manny) >= parseFloat(credit.payment_amount)) {
-            await linkedAcc.decrement('manny', { by: credit.payment_amount });
-            credit.remaining_payments -= 1;
-            await credit.save();
-            paymentSuccess = true;
-          } else {
-            // Если денег не хватило, переводим в ручной режим для отправки предупреждений
-            credit.auto_withdrawal = false;
-            await credit.save();
-          }
-        }
-
-        // Если автосписание выключено или не удалось — отправляем предупреждение на почту по ТЗ
-        if (!paymentSuccess && owner) {
-          const transporter = nodemailer.createTransport({
-            service: 'gmail',
-            auth: { user: process.env.GMAIL, pass: process.env.GOOGLE_APP_PASSWORD }
-          });
-
-          await transporter.sendMail({
-            from: `"City-bank Биллинг" <${process.env.GMAIL}>`,
-            to: owner.user_gmail,
-            subject: '⚠️ Требуется оплата по кредиту | City-bank',
-            text: `Уважаемый клиент! По вашему кредитному счету #${credit.account_id} зафиксирован обязательный платеж. Вам необходимо внести ${credit.payment_amount} руб.`
-          });
-        }
-
-        // Если все платежи закрыты — полностью удаляем и закрываем кредит и технический счет по ТЗ
-        if (credit.remaining_payments <= 0) {
-          if (linkedAcc) await linkedAcc.destroy();
-          await credit.destroy();
-          console.log(`🎉 Кредит #${creditId} полностью погашен и закрыт.`);
-        }
-      } catch (billingErr) {
-        console.error("Ошибка процессинга кредита:", billingErr.message);
-      }
+    if (existingCredit) {
+      throw new Error('У этого аккаунта уже есть активный кредит');
     }
-
-    // Сохраняем ссылку на обработчик в глобальный крон или интервал (в рамках игровой сессии)
-    // Для симуляции можно вызывать функцию через setInterval()
-    
-    return { 
-      status: true, 
-      statusCode: 1, 
-      creditAccountId: creditAccount.id, 
-      password: pinCode 
+    const totalRepay = numericAmount * (1 + numericRate);
+    const credit = await Credit.create({
+      accountId: account.id,
+      amount: numericAmount,
+      totalRepay: totalRepay,
+      remainingRepay: totalRepay,
+      status: 'active',
+      autoRepay: !!autoRepay,
+      termMonths: numericTerm
+    }, { transaction });
+    await account.increment('balance', { by: numericAmount, transaction });
+    await transaction.commit();
+    return {
+      success: true,
+      message: 'Кредит успешно оформлен',
+      creditId: credit.id
     };
-  } catch (err) {
-    return { status: false, statusCode: -10, message: err.message };
+  } catch (error) {
+    if (transaction && !transaction.finished) {
+      await transaction.rollback();
+    }
+    return { success: false, error: error.message };
   }
-};
+}
+module.exports = createCredit;

package/database/services/account/create.js

@@ -1,24 +1,20 @@
 const bcrypt = require('bcrypt');
 const Account = require('../../models/Account');
-
 module.exports = async function createAccount(username, pinCode, enable2FA) {
   try {
-    // Валидация длины пин-кода (до 8 символов по ТЗ)
     if (!pinCode || pinCode.length > 8) {
       return { status: false, statusCode: -2, message: 'Пин-код должен быть до 8 символов' };
     }
-
     const hashedPin = await bcrypt.hash(pinCode, 10);
     const newAccount = await Account.create({
       user: username,
       pin_code: hashedPin,
-      manny: 0.00, // Строго нулевой баланс для игроков
+      manny: 0.00,
       active: true,
       two_fa_status: enable2FA
     });
-
     return { status: true, statusCode: 1, accountId: newAccount.id };
   } catch (err) {
     return { status: false, statusCode: -10, message: err.message };
   }
-};
+};

package/database/services/account/find-manny.js

@@ -1,12 +1,10 @@
 const Account = require('../../models/Account');
-
 module.exports = async function findManny(accountId) {
   try {
     const acc = await Account.findByPk(accountId);
     if (!acc) return { status: false, statusCode: -2, message: 'Счет не найден' };
-
     return { status: true, statusCode: 1, manny: parseFloat(acc.manny) };
   } catch (err) {
     return { status: false, statusCode: -10 };
   }
-};
+};

package/database/services/account/logs.js

@@ -1,26 +1,19 @@
-// database/services/account/logs.js
 const Account = require('../../models/Account');
 const Transaction = require('../../models/Transaction');
-
 module.exports = async function getAccountLogs(username) {
   try {
-    // Находим все ID счетов, принадлежащих этому пользователю
     const myAccounts = await Account.findAll({
       where: { user: username },
       attributes: ['id']
     });
-    
     const accountIds = myAccounts.map(acc => acc.id);
-
-    // Запрашиваем логи по этим счетам
     const logs = await Transaction.findAll({
       where: { account_id: accountIds },
-      order: [['createdAt', 'DESC']], // Сначала самые свежие
-      limit: 50 // Ограничим вывод последними 50 операциями
+      order: [['createdAt', 'DESC']],
+      limit: 50
     });
-
     return { status: true, statusCode: 1, logs };
   } catch (err) {
     return { status: false, statusCode: -10, message: err.message };
   }
-};
+};

package/database/services/account/remove-manny.js

@@ -1,18 +1,15 @@
 const Account = require('../../models/Account');
-
+const Transaction = require('../../models/Transaction');
 module.exports = async function removeManny(accountId, amount) {
   try {
     const acc = await Account.findByPk(accountId);
     if (!acc) return { status: false, statusCode: -2, message: 'Счет не найден' };
-
     const numericAmount = parseFloat(amount);
     if (isNaN(numericAmount) || numericAmount <= 0) return { status: false, statusCode: -2 };
-
     await acc.decrement('manny', { by: numericAmount });
-        const Transaction = require('../../models/Transaction');
     await Transaction.create({ account_id: accountId, type: 'WITHDRAW', sender_or_receiver: 'Администрация (ROOT)', amount: numericAmount });
     return { status: true, statusCode: 1 };
   } catch (err) {
     return { status: false, statusCode: -10 };
   }
-};
+};

package/database/services/account/transfer.js

@@ -1,49 +1,46 @@
 const bcrypt = require('bcrypt');
 const Account = require('../../models/Account');
 const User = require('../../models/User');
+const Transaction = require('../../models/Transaction');
 const sequelize = require('../../config/init-db');
 const { sendBotNotification } = require('../bot/bot');
-
+const logger = require("custom-color-logs").print;
 module.exports = async function transferManny(fromId, toId, amount, pinCode, totpCode = null) {
   const t = await sequelize.transaction();
   try {
-    // Подгружаем счета с блокировкой строк для обновления (FOR UPDATE)
-    const fromAcc = await Account.findByPk(fromId, { transaction: t });
-    const toAcc = await Account.findByPk(toId, { transaction: t });
-
+    const numericAmount = parseFloat(amount);
+    if (isNaN(numericAmount) || numericAmount <= 0) {
+      await t.rollback();
+      return { status: false, statusCode: -2, message: 'Некорректная сумма перевода' };
+    }
+    const fromAcc = await Account.findByPk(fromId, { 
+      transaction: t, 
+      lock: t.LOCK.UPDATE 
+    });
+    const toAcc = await Account.findByPk(toId, { 
+      transaction: t, 
+      lock: t.LOCK.UPDATE 
+    });
     if (!fromAcc || !toAcc) {
       await t.rollback();
       return { status: false, statusCode: -2, message: 'Один из счетов не найден' };
     }
-
     if (!fromAcc.active || !toAcc.active) {
       await t.rollback();
       return { status: false, statusCode: -11, message: 'Один из счетов заблокирован' };
     }
-
-    // Проверка пин-кода отправителя по вашему ТЗ (-23)
     const isPinValid = await bcrypt.compare(pinCode, fromAcc.pin_code);
     if (!isPinValid) {
       await t.rollback();
-      return { status: false, statusCode: -23, message: 'Неверный пароль щета отправителя' };
+      return { status: false, statusCode: -23, message: 'Неверный пароль счета отправителя' };
     }
-
-    const numericAmount = parseFloat(amount);
-    if (isNaN(numericAmount) || numericAmount <= 0) {
-      await t.rollback();
-      return { status: false, statusCode: -2, message: 'Некорректная сумма перевода' };
-    }
-
-    // Проверка баланса (root-пользователь игнорирует лимиты средств)
     if (fromAcc.user !== 'root' && parseFloat(fromAcc.manny) < numericAmount) {
       await t.rollback();
       return { status: false, statusCode: -11, message: 'Недостаточно средств на счете' };
     }
-
-    // Если на счете включена индивидуальная проверка 2FA
     if (fromAcc.two_fa_status) {
       const owner = await User.findByPk(fromAcc.user, { transaction: t });
-      if (owner.two_fa_status) {
+      if (owner && owner.two_fa_status) {
         if (!totpCode) {
           await t.rollback();
           return { status: false, statusCode: -2, message: 'Требуется токен подтверждения 2FA' };
@@ -55,29 +52,34 @@ module.exports = async function transferManny(fromId, toId, amount, pinCode, tot
         }
       }
     }
-
-    // Проведение атомарного перевода
     await fromAcc.decrement('manny', { by: numericAmount, transaction: t });
     await toAcc.increment('manny', { by: numericAmount, transaction: t });
-        const Transaction = require('../../models/Transaction'); // Импорт в начало файла
-
-    // Вставить перед t.commit():
-    await Transaction.create({ account_id: fromId, type: 'TRANSFER_OUT', sender_or_receiver: `На счет #${toId} (${to.user})`, amount: numAmount }, { transaction: t });
-    await Transaction.create({ account_id: toId, type: 'TRANSFER_IN', sender_or_receiver: `Со счета #${fromId} (${from.user})`, amount: numAmount }, { transaction: t });
-
+    await Transaction.create({ 
+      account_id: fromId, 
+      type: 'TRANSFER_OUT', 
+      sender_or_receiver: `На счет #${toId} (${toAcc.user})`, 
+      amount: numericAmount 
+    }, { transaction: t });
+    await Transaction.create({ 
+      account_id: toId, 
+      type: 'TRANSFER_IN', 
+      sender_or_receiver: `Со счета #${fromId} (${fromAcc.user})`, 
+      amount: numericAmount 
+    }, { transaction: t });
     await t.commit();
-
-    // Обновляем модели для считывания актуального баланса ботом
     await fromAcc.reload();
     await toAcc.reload();
-
-    // Асинхронные уведомления через шаблоны бота
-    await sendBotNotification('transfer-from-bot', { fromId, toId, amount: numericAmount, balance: fromAcc.manny });
-    await sendBotNotification('transfer-to-bot', { toId, fromId, amount: numericAmount, balance: toAcc.manny });
-
+    try {
+      await sendBotNotification('transfer-from-bot', { fromId, toId, amount: numericAmount, balance: fromAcc.manny });
+      await sendBotNotification('transfer-to-bot', { toId, fromId, amount: numericAmount, balance: toAcc.manny });
+    } catch (botErr) {
+      console.log(logger.DatabaseError('Ошибка отправки уведомления боту:', botErr.message))
+    }
     return { status: true, statusCode: 1 };
   } catch (err) {
-    await t.rollback();
+    if (!t.finished) {
+      await t.rollback();
+    }
     return { status: false, statusCode: -10, message: err.message };
   }
-};
+};

package/database/services/bot/bot.js

@@ -1,38 +1,23 @@
-// database/services/bot/bot.js
 const fs = require('fs').promises;
 const path = require('path');
-
-/**
- * Вспомогательный метод для асинхронного рендеринга и подстановки данных
- */
+const logger = require("custom-color-logs").print;
 async function renderTemplate(templateName, ext, vars) {
   try {
-    // 🔑 СТРОГО ВЫЧИСЛЯЕМ АБСОЛЮТНЫЙ ПУТЬ к папке generators
     const filePath = path.resolve(__dirname, 'generators', `${templateName}.${ext}`);
-    
-    // Читаем файл с диска
     let data = await fs.readFile(filePath, 'utf-8');
-    
-    // Подставляем переменные
     for (const [key, value] of Object.entries(vars)) {
       data = data.replace(new RegExp(`{${key}}`, 'g'), value);
     }
     return data;
   } catch (err) {
-    console.error(`[Bot Render Error] Не найден файл ${templateName}.${ext}:`, err.message);
-    return ""; // Возвращаем пустую строку вместо падения или перехвата статики
+    console.log(logger.NodemailerError(`[Bot Render Error] Не найден файл ${templateName}.${ext}:`, err.message))
+    return "";
   }
 }
-
-/**
- * Главный движок компиляции сообщений бота
- */
 async function sendBotNotification(templateName, variables) {
   const txtContent = await renderTemplate(templateName, 'txt', variables);
   const htmlContent = await renderTemplate(templateName, 'html', variables);
-  
-  console.log(`\n🤖 [City-Bank Bot Engine]: Сгенерировано событие уведомления [${templateName}]`);
+  console.log(logger.NodemailerInfo(`Сгенерировано событие уведомления [${templateName}]`))
   return { txt: txtContent, html: htmlContent };
 }
-
-module.exports = { sendBotNotification };
+module.exports = { sendBotNotification };