@jubbio/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Jubbio Team
+
+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.

package/README.md

@@ -0,0 +1,166 @@
+<p align="center">
+  <img src="https://jubbio.com/logo.png" alt="Jubbio" width="120" />
+</p>
+
+<h1 align="center">@jubbio/core</h1>
+
+<p align="center">
+  <strong>Core bot library for Jubbio platform</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@jubbio/core"><img src="https://img.shields.io/npm/v/@jubbio/core?color=blue" alt="npm"></a>
+  <a href="https://github.com/jubbio/jubbio.js/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen" alt="Node.js">
+</p>
+
+---
+
+## Installation
+
+```bash
+npm install @jubbio/core
+```
+
+## Quick Start
+
+```typescript
+import { Client, GatewayIntentBits } from '@jubbio/core';
+
+const client = new Client({
+  intents: [
+    GatewayIntentBits.Guilds,
+    GatewayIntentBits.GuildMessages
+  ]
+});
+
+client.on('ready', () => {
+  console.log(`✅ ${client.user?.username} is online!`);
+});
+
+client.on('messageCreate', async (message) => {
+  if (message.content === '!ping') {
+    await message.reply('🏓 Pong!');
+  }
+});
+
+client.on('interactionCreate', async (interaction) => {
+  if (!interaction.isCommand()) return;
+  
+  if (interaction.commandName === 'hello') {
+    await interaction.reply('Hello! 👋');
+  }
+});
+
+client.login(process.env.BOT_TOKEN);
+```
+
+## Features
+
+- 🔌 **WebSocket Gateway** - Real-time events with auto-reconnection
+- 🌐 **REST API Client** - Full API coverage
+- ⚡ **Slash Commands** - Easy interaction handling
+- 📦 **Builders** - Embed, Button, SelectMenu, Modal builders
+- 🔄 **Collectors** - Message and interaction collectors
+- 🎯 **Sharding** - Multi-process support for large bots
+- 📝 **TypeScript** - Full type definitions
+
+## Client Options
+
+```typescript
+const client = new Client({
+  intents: [...],           // Required gateway intents
+  shards: [0, 1],           // Optional: [shard_id, total_shards]
+  gatewayUrl: 'ws://...',   // Optional: Custom gateway URL
+  apiUrl: 'http://...'      // Optional: Custom API URL
+});
+```
+
+## Gateway Intents
+
+```typescript
+GatewayIntentBits.Guilds              // Guild events
+GatewayIntentBits.GuildMembers        // Member events  
+GatewayIntentBits.GuildMessages       // Message events
+GatewayIntentBits.GuildVoiceStates    // Voice state events
+GatewayIntentBits.MessageContent      // Message content access
+```
+
+## Events
+
+| Event | Description |
+|-------|-------------|
+| `ready` | Bot is connected and ready |
+| `messageCreate` | New message received |
+| `interactionCreate` | Slash command or component interaction |
+| `guildCreate` | Bot joined a guild |
+| `guildDelete` | Bot left a guild |
+| `voiceStateUpdate` | Voice state changed |
+| `error` | Error occurred |
+| `debug` | Debug information |
+
+## Builders
+
+### EmbedBuilder
+
+```typescript
+import { EmbedBuilder, Colors } from '@jubbio/core';
+
+const embed = new EmbedBuilder()
+  .setTitle('Hello!')
+  .setDescription('This is an embed')
+  .setColor(Colors.Blue)
+  .addFields(
+    { name: 'Field 1', value: 'Value 1', inline: true },
+    { name: 'Field 2', value: 'Value 2', inline: true }
+  )
+  .setFooter({ text: 'Footer text' })
+  .setTimestamp();
+
+await message.reply({ embeds: [embed] });
+```
+
+### ButtonBuilder
+
+```typescript
+import { ButtonBuilder, ButtonStyle, ActionRowBuilder } from '@jubbio/core';
+
+const button = new ButtonBuilder()
+  .setCustomId('my-button')
+  .setLabel('Click me!')
+  .setStyle(ButtonStyle.Primary);
+
+const row = new ActionRowBuilder().addComponents(button);
+
+await interaction.reply({ components: [row] });
+```
+
+### SlashCommandBuilder
+
+```typescript
+import { SlashCommandBuilder } from '@jubbio/core';
+
+const command = new SlashCommandBuilder()
+  .setName('greet')
+  .setDescription('Greet a user')
+  .addUserOption(option =>
+    option.setName('user')
+      .setDescription('User to greet')
+      .setRequired(true)
+  );
+```
+
+## Voice Support
+
+Use with `@jubbio/voice` for voice channel support:
+
+```typescript
+import { Client, GatewayIntentBits } from '@jubbio/core';
+import { joinVoiceChannel, createAudioPlayer } from '@jubbio/voice';
+
+// See @jubbio/voice documentation for full voice support
+```
+
+## License
+
+MIT © [Jubbio Team](https://jubbio.com)

package/dist/Client.d.ts

@@ -0,0 +1,147 @@
+import { EventEmitter } from 'events';
+import { ClientOptions } from './types';
+import { GatewayIntentBits } from './enums';
+import { Collection } from './structures/Collection';
+import { User } from './structures/User';
+import { Guild } from './structures/Guild';
+import { BaseChannel } from './structures/Channel';
+import { REST } from './rest/REST';
+/**
+ * Voice adapter creator type for @jubbio/voice compatibility
+ */
+type VoiceAdapterCreator = (methods: {
+    onVoiceServerUpdate(data: any): void;
+    onVoiceStateUpdate(data: any): void;
+    destroy(): void;
+}) => {
+    sendPayload(payload: any): boolean;
+    destroy(): void;
+};
+/**
+ * Main client class
+ */
+export declare class Client extends EventEmitter {
+    /** Client options */
+    readonly options: ClientOptions;
+    /** REST API client */
+    readonly rest: REST;
+    /** The bot user */
+    user: User | null;
+    /** Application ID */
+    applicationId: string | null;
+    /** Cached guilds */
+    guilds: Collection<string, Guild>;
+    /** Cached channels */
+    channels: Collection<string, BaseChannel>;
+    /** Cached users */
+    users: Collection<string, User>;
+    /** Voice adapter management */
+    voice: {
+        adapters: Map<string, VoiceAdapterCreator>;
+    };
+    /** WebSocket connection */
+    private ws;
+    /** Bot token */
+    private token;
+    /** Session ID */
+    private sessionId;
+    /** Sequence number */
+    private sequence;
+    /** Heartbeat interval */
+    private heartbeatInterval;
+    /** Gateway URL */
+    private gatewayUrl;
+    /** Voice state update handlers (for voice adapters) */
+    private voiceStateHandlers;
+    private voiceServerHandlers;
+    constructor(options: ClientOptions);
+    /**
+     * Calculate intents value
+     */
+    private getIntentsValue;
+    /**
+     * Login to the gateway
+     */
+    login(token: string): Promise<string>;
+    /**
+     * Connect to the gateway
+     */
+    private connect;
+    /**
+     * Handle incoming gateway message
+     */
+    private handleMessage;
+    /**
+     * Handle gateway payload
+     */
+    private handlePayload;
+    /**
+     * Handle Hello payload
+     */
+    private handleHello;
+    /**
+     * Handle Dispatch events
+     */
+    private handleDispatch;
+    /**
+     * Handle Ready event
+     */
+    private handleReady;
+    /**
+     * Setup voice adapters for all guilds
+     */
+    private setupVoiceAdapters;
+    /**
+     * Create a voice adapter for a guild
+     */
+    private createVoiceAdapter;
+    /**
+     * Handle Guild Create event
+     */
+    private handleGuildCreate;
+    /**
+     * Handle Guild Update event
+     */
+    private handleGuildUpdate;
+    /**
+     * Handle Guild Delete event
+     */
+    private handleGuildDelete;
+    /**
+     * Handle Message Create event
+     */
+    private handleMessageCreate;
+    /**
+     * Handle Interaction Create event
+     */
+    private handleInteractionCreate;
+    /**
+     * Handle Voice State Update event
+     */
+    private handleVoiceStateUpdate;
+    /**
+     * Handle Voice Server Update event
+     */
+    private handleVoiceServerUpdate;
+    /**
+     * Send Identify payload
+     */
+    private identify;
+    /**
+     * Start heartbeat
+     */
+    private startHeartbeat;
+    /**
+     * Send payload to gateway
+     */
+    private send;
+    /**
+     * Cleanup on disconnect
+     */
+    private cleanup;
+    /**
+     * Destroy the client
+     */
+    destroy(): void;
+}
+export { GatewayIntentBits };