feat: @robojs/events-manager plugin for event management

packages/plugin-events-manager/.gitignore

@@ -0,0 +1,8 @@
+node_modules/
+dist/
+.robo/build/
+*.log
+.env*
+.DS_Store
+coverage/
+.nyc_output/

packages/plugin-events-manager/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Discord Events Manager Plugin Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/plugin-events-manager/README.md

@@ -0,0 +1,213 @@
+<p align="center">✨ <strong>Generated with <a href="https://robojs.dev/create-robo">create-robo</a> magic!</strong> ✨</p>
+
+---
+
+# 📅 Discord Events Manager
+
+**A comprehensive Discord events management plugin for Robo.js** that helps communities organize events with RSVP tracking, automated reminders, and seamless Discord integration.
+
+![Version](https://img.shields.io/badge/version-1.0.0-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Robo.js](https://img.shields.io/badge/robo.js-plugin-purple)
+
+## ✨ Features
+
+- **🎯 Event Creation**: Create detailed events with dates, descriptions, locations, and attendance limits
+- **📝 RSVP System**: Track who's going, maybe attending, or can't attend (persisted in Flashcore)
+- **⏰ Smart Reminders**: Automated event reminders (1 hour to 1 week before, stored in Flashcore)
+- **📊 Attendee Management**: View and manage event participants
+- **🔍 Event Discovery**: List and filter events by date, creator, or status
+- **👥 Interactive UI**: Easy event creation through Discord modals
+- **🎨 Rich Embeds**: Beautiful Discord embeds with interactive buttons
+- **🔒 Permissions**: Role-based event management with proper permissions
+
+## 📦 Installation
+
+To add this plugin to your **Robo.js** project:
+
+```bash
+npx robo add events-manager
+```
+
+New to **Robo.js**? Start your project with this plugin pre-installed:
+
+```bash
+npx create-robo <project-name> -p events-manager
+```
+
+## 🎮 Commands
+
+### `/event-create` - Create New Events
+
+Create detailed events with full customization:
+
+```bash
+/event-create
+```
+
+This opens a modal where you can specify:
+- Event title
+- Description
+- Date & Time (format: `YYYY-MM-DD HH:MM`)
+- Location (optional)
+- Max attendees (optional)
+
+### `/event-list` - Browse Events
+
+View and filter community events:
+
+```bash
+/event-list                           # Show upcoming events
+/event-list filter:past              # Show past events
+/event-list filter:all               # Show all events
+/event-list user:@SomeUser           # Show events by specific user
+```
+
+### `/event-remind` - Set Reminders
+
+Schedule automatic event reminders:
+
+```bash
+/event-remind event:"Gaming Night" time:"1 day before" channel:#events
+```
+
+**Reminder Options:**
+- 1 hour before
+- 6 hours before  
+- 1 day before
+- 3 days before
+- 1 week before
+
+## 🎯 Usage Examples
+
+### Creating a Gaming Event
+
+```bash
+/event-create
+```
+
+Then fill in the modal with:
+- **Title**: "Weekly Gaming Session"
+- **Description**: "Join us for multiplayer fun!"
+- **Date & Time**: "2025-12-01 20:00"
+- **Location**: "Gaming Voice Channel"
+- **Max Attendees**: "12"
+
+### Setting Up a Community Meeting
+
+1. Use `/event-create` (without quick-event parameter)
+2. Fill in the modal:
+   - **Title**: "Monthly Community Meeting"
+   - **Description**: "Discuss server updates, new features, and community feedback"
+   - **Date & Time**: "2025-10-20 19:00"
+   - **Location**: "General Voice Channel"
+   - **Max Attendees**: "50"
+
+### Managing RSVPs
+
+Users can interact with event posts using buttons:
+- **✅ Going** - Confirm attendance (automatically tracked in Flashcore)
+- **❓ Maybe** - Tentative attendance (with capacity overflow protection)
+- **❌ Can't Go** - Decline attendance
+- **👥 View Attendees** - See actual user names and attendance counts
+
+### Setting Reminders
+
+```bash
+/event-remind event:"Community Meeting" time:"1 day before" channel:#announcements
+```
+
+**Note:** Reminders are scheduled and stored in Flashcore, persisting across bot restarts.
+
+## 🔧 Configuration
+
+### Required Permissions
+
+**For Event Creators:**
+- `Manage Guild` permission OR `Administrator`
+
+**For All Users:**
+- `Use Application Commands`
+- `Read Message History`
+- `Send Messages`
+
+### Channel Setup
+
+Recommended channel setup:
+- **#events** - For event announcements
+- **#event-reminders** - For automated reminders  
+- Voice channels for event locations
+
+## 🎨 Customization
+
+### Event Embed Colors
+- **Upcoming Events**: Blue (`#5865F2`)
+- **Past Events**: Gray (`#99AAB5`)
+- **Reminders**: Orange (`#FFAA00`)
+- **Confirmations**: Green (`#00FF00`)
+
+### Date/Time Format
+
+Events use ISO 8601 date format:
+- Format: `YYYY-MM-DD HH:MM`
+- Example: `2025-12-25 14:30`
+- Uses 24-hour time format
+
+## 💾 Data Storage
+
+This plugin uses **Flashcore**, Robo.js's built-in key-value storage system, to persist:
+- Event details (title, description, date/time, location, attendees)
+- RSVP responses (going, maybe, not going)
+- Event reminders with scheduling information
+
+All data is automatically saved and persists across bot restarts. No additional database setup required!
+
+## 🛠️ Development
+
+To contribute to this plugin:
+
+```bash
+git clone https://github.com/Wave-Play/robo.js
+cd robo.js/packages/plugin-events-manager
+pnpm install
+pnpm dev
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! This plugin was created for **Hacktoberfest 2025**. Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
+
+## 📋 Roadmap
+
+- [x] **Database Integration** - Persistent event storage using Flashcore
+- [x] **RSVP Tracking** - Full Yes/Maybe/No response tracking with user data
+- [x] **Event Reminders** - Scheduled reminders with Flashcore persistence
+- [x] **Event Listing** - Filter events by date, creator, or status
+- [ ] **Recurring Events** - Weekly/monthly event templates
+- [ ] **Event Categories** - Gaming, Social, Educational, etc.
+- [ ] **Calendar Integration** - Export to Google Calendar/Outlook
+- [ ] **Event Analytics** - Attendance statistics and insights
+- [ ] **Custom RSVP Options** - More than just Yes/No/Maybe
+- [ ] **Event Templates** - Quick event creation from templates
+- [ ] **Advanced Time Zone Support** - Automatic time zone conversion
+- [ ] **Advanced Natural Language Processing** - Enhanced date parsing
+
+## 📞 Support
+
+- **Documentation**: [Robo.js Documentation](https://robojs.dev)
+- **Discord**: [Robo.js Community](https://robojs.dev/discord)
+- **Issues**: Create an issue in this repository
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+**Made with ❤️ by DevArqf for the Discord community and Hacktoberfest 2025**

packages/plugin-events-manager/config/robo.mjs

@@ -0,0 +1,12 @@
+// @ts-check
+
+/**
+ * @type {import('robo.js').Config}
+ **/
+export default {
+	clientOptions: {
+		intents: ['Guilds', 'GuildMessages']
+	},
+	plugins: [],
+	type: 'plugin'
+}

packages/plugin-events-manager/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "@robojs/events-manager",
+	"description": "A comprehensive Discord events management plugin for Robo.js that helps communities organize events with RSVP tracking, automated reminders, and seamless Discord integration.",
+	"version": "0.0.0",
+	"private": false,
+	"type": "module",
+	"main": ".robo/build/index.js",
+	"license": "MIT",
+	"author": "DevArqf",
+	"contributors": [
+		"DevArqf"
+	],
+	"files": [
+		".robo/",
+		"src/",
+		"config/",
+		"LICENSE",
+		"README.md"
+	],
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/Wave-Play/robo.git",
+		"directory": "packages/plugin-events-manager"
+	},
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"scripts": {
+		"build": "robo build plugin",
+		"dev": "NODE_OPTIONS=--enable-source-maps robo build plugin --watch",
+		"lint": "pnpm lint:eslint && pnpm lint:style",
+		"lint:eslint": "eslint . --ext js,jsx,ts,tsx",
+		"lint:style": "prettier --write ."
+	},
+	"devDependencies": {
+		"@swc/core": "^1.11.29",
+		"@types/node": "^20.16.5",
+		"@typescript-eslint/eslint-plugin": "^5.56.0",
+		"@typescript-eslint/parser": "^5.56.0",
+		"discord.js": "^14.7.1",
+		"eslint": "^8.36.0",
+		"prettier": "^2.8.5",
+		"robo.js": "workspace:*",
+		"typescript": "^5.0.0"
+	},
+	"keywords": [
+		"discord",
+		"events",
+		"rsvp",
+		"bot",
+		"robo",
+		"plugin",
+		"community",
+		"management"
+	]
+}

packages/plugin-events-manager/src/commands/event-create.js

@@ -0,0 +1,73 @@
+import { createCommandConfig, logger } from 'robo.js'
+import { ModalBuilder, TextInputBuilder, TextInputStyle, ActionRowBuilder } from 'discord.js'
+
+export const config = createCommandConfig({
+	description: 'Create a new community event'
+})
+
+export default async (interaction) => {
+	logger.info(`Event create command used by ${interaction.user.tag}`)
+
+	if (!interaction.member.permissions.has('ManageGuild') && !interaction.member.permissions.has('Administrator')) {
+		return interaction.reply({
+			content: '❌ You need the "Manage Guild" permission to create events.',
+			ephemeral: true
+		})
+	}
+
+	const modal = createEventModal()
+	await interaction.showModal(modal)
+}
+
+
+function createEventModal() {
+	const modal = new ModalBuilder()
+		.setCustomId('event-create-modal')
+		.setTitle('Create New Event')
+
+	const titleInput = new TextInputBuilder()
+		.setCustomId('event-title')
+		.setLabel('Event Title')
+		.setStyle(TextInputStyle.Short)
+		.setRequired(true)
+		.setMaxLength(100)
+
+	const descriptionInput = new TextInputBuilder()
+		.setCustomId('event-description')
+		.setLabel('Event Description')
+		.setStyle(TextInputStyle.Paragraph)
+		.setRequired(true)
+		.setMaxLength(1000)
+
+	const dateTimeInput = new TextInputBuilder()
+		.setCustomId('event-datetime')
+		.setLabel('Date & Time (format: YYYY-MM-DD HH:MM)')
+		.setStyle(TextInputStyle.Short)
+		.setRequired(true)
+
+	const locationInput = new TextInputBuilder()
+		.setCustomId('event-location')
+		.setLabel('Location (optional)')
+		.setStyle(TextInputStyle.Short)
+		.setRequired(false)
+		.setMaxLength(100)
+		.setPlaceholder('Discord Voice Channel, Online, etc.')
+
+	const maxAttendeesInput = new TextInputBuilder()
+		.setCustomId('event-max-attendees')
+		.setLabel('Max Attendees (optional)')
+		.setStyle(TextInputStyle.Short)
+		.setRequired(false)
+		.setPlaceholder('Leave empty for unlimited')
+
+	const rows = [
+		new ActionRowBuilder().addComponents(titleInput),
+		new ActionRowBuilder().addComponents(descriptionInput),
+		new ActionRowBuilder().addComponents(dateTimeInput),
+		new ActionRowBuilder().addComponents(locationInput),
+		new ActionRowBuilder().addComponents(maxAttendeesInput)
+	]
+
+	modal.addComponents(...rows)
+	return modal
+}