An IronY / FSociety Production
Since this is an IRC bot, and one cannot predict the type of character the bot may encounter in the wild, this project makes use of the Snyk vulnerabilitie
patching system. You should regularly check the snyk patching system by running npm run snyk-protect.
The bot currently depends on NickServ services supporting the ACC command for certain command authentication types. Networks confirmed to work include
- freenode
- DALnet
- A Database engine, either MySql, MariaDB, Postgres, Sqlite3
- node-gyp (python 2, and some sort of c build tools such as gcc or visual studio)
- Install Node Modules
npm install - Create a configuration file from a template
cp config.sample.js config.js - Edit the configuration file
- Configure a database
- By default, the bot will use SQLite 3,
npm install sqlite3 - If using MySQL,
npm install mysql2(Knex supports both the node-mysql and node-mysql2 flavours, with the second being faster and more secure)- Create a Schema and be sure to give it a utf8mb4_unicode_ci character set (CREATE DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci)
- Modify the config.js accordingly
- Once properly configured and run for the first time, the Bot will provision the database schema using migrations
- By default, the bot will use SQLite 3,
- Start the bot
node index.js [--config config.js-path]ornpm start
Included in the root directory is a sample systemd script (misc/mrnodebot.service), you can do it this way or use forever or any other node task runner. If you want to be able to use commands like update, restart, and halt while having the Bot come back it is important you take this into consideration.
- Logging / Analytics
- SED Corrections
- URL Announce
- Popularity (upvote/downvote) system
- Mention system
- A Seen/Last-seen command to track usage
- API Endpoints connected to Analytics
- Express/Pug Web Front end
- SocketIO connected to Express to deliver real time notifictions and bi-directional communication with the client
You will find various debugging flags inside the config file. These will granually conroll file based debugging options. This framework does take advantage of SocketIO and express, which
both utilize the Debug module. If you would like to see very intricate debugging for both express and socketIO, start the bot with the following command DEBUG=* node index.js.
Unit testing is being introduced and has a long way to go to catch up. To run available tests npm test
I am currently in the processes of providing jsdoc style docblocks for documentation generation. You can generate the documentation by running npm run generate-docs
- Query Builder / Migrations Knex.js
- ORM Bookshelf.js
- Central Model Repository bookshelf-model-loader
- Web Server Express.js
- Request Body Parsing body-parser
- Wrapper for File Uploads express-fileupload
- API Rate Limiting express-rate-limit
- Favicon Middleware serve-favicon
- HTML Template language pug
- Route Name Helper named-routes
- Basic Authentication basic-auth
- Scheduler node-scheduler
- Logging Winston
- Log File Rotation winston-daily-rotate-file
- Express Web Server Request Logging express-winston
- Time Moment
- Localization i18next
- File System Loader i18next-sync-fs-backend
- Functional Lodash
- Additional Convenience Methods Lodash Addons
- HTTP Request Request
- Native Promise Implementation Request-Promise
- IRC node-irc fork
- Utilities
- file-type Detect the file type by checking the magic number of a Buffer/Uint8Array
- irc-colors IRC Colors
- freeport Get an available open port on current host
- gitlog Git log parser
- rand-token Generate random tokens
- rand-js A mathematically correct random number generator library for JavaScript
- URIjs Javascript URL mutation library
- shelljs Portable Unix shell commands
- x-ray The next web scraper
- socket.io Realtime application framework (Node.JS server)
- bot Feeling lonely? You personal bot is here.
- bcrypt Bcrypt for Node (crypto)
- twit Twitter API Client for Node (REST & Streaming API)
- minimist Parse argument options
- money Convert exchange rates
- currency-symbol-map A function to lookup the currency symbol for a given currency code and vice versa
- accounting-js Number, money and currency formatting library
- Testing
- mocha
- chai
- chai-as-promised
- [chai-moment](date assertions for chai, powered by moment)
- chai-bookshelf sinon-chai
- sinon
- Documentation
- Firebase API Key - The preferred URL shortner requires this (google is deprecating their other service), if not it will fall back to another option
- Google API Key - For most features a Google API key with SafeSearch service, and YouTube search service enabled is required, however, if one is not provided, the bot will try to gracefully fall back onto is.gd
- Imgur API Key - A Imgur API key is required to extract meta data on Imgur links in the URL announcer
- Twitter API Key A Twitter API key is required to be able to send tweets, subscribe to tweets, or have a tweet sent out during the announce process
- Bitly API Key A Bitly API key assists the amount of url shortners you have available to you
- OMDB API Key Used in the imdb command and in the link matcher to pull info for imdb links
The Url shortner service, found in scripts/libs/_getShortService will provide a url shortner based on your API key availability.
const shortService = require('../lib/_getShortService')(DOMAIN?)
- DOMAIN is optional, but useful for things like avoiding googles blocking of certain domains.
- If a firebase api key and url short domain is provided, the Firebase API will be used to shorten
- After Firebase, if a Bitly API key is provided, Bitly will be used to shorten
- If neither API key is available, isGd will be used to shorten (no key required, but certain pitfalls attached)
When dealing with the API, you will find a code property on most errors.
- 501 Token not provided
- 503 Token is invalid
- owner - The Command can only be run by the bot owner (hard coded username/host combo in config.js)
- admin - The Command can be run by the owner or anyone in the admin list
- identified - The Command can be run by anyone using a nick identified with services
- guest - The Command can be run by anyone
- channelOp - The Command can be run by the owner, or anyone with ops in the channel it is being originated from
- channelOpIdentified - the Command can be run by the owner, the admins, or anyone with ops in the channel who are also identified
- channelVoice - the Command can be run by the owner, the the ops, and the voices in the channel it is originated from
- channelVoiceIdentified - the Command can be run by identified voices, ops in the channel originated from, or owner and admins
If a script exports the following functions, they will be run at the respective run level
- onLoad Runs on initial load, and reload
- unUnload Runs during reload prior to the destruction of the require / loadedScripts cache
This project is powered by knexjs and takes advantage of its migration system. In order to use migrations npm install -g knex and use the knex command, e.g. knex migrate:make add_users_table . More instructions can be found here. The bot will check for and install new migrations on startup.
Have questions? Looking to chat? Join us on #fsociety on irc.freenode.net
Pull Requests Welcome
- Yarn - Fast, Reliable, and secure Dep Management
- Node Publish - A better NPM Publish
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent