Utility data structure used in telegramsjs
A powerful Map-based data structure with additional utility methods. This library extends JavaScript's native Map with methods inspired by Arrays, making it perfect for managing collections of data with unique identifiers.
- 🚀 Extends Native Map - Full compatibility with JavaScript's Map API
- 📦 Rich Utility Methods - 50+ methods for working with collections
- 🎯 Type-Safe - Written in TypeScript with full type inference
- ⚡ Performance Optimized - Caching and efficient iteration patterns
- 🔗 Chainable API - Fluent interface for method chaining
- 🛠️ Array-like Methods - Familiar methods like filter, map, reduce, and more
``bash`
npm install @telegram.ts/collection
`bash`
yarn add @telegram.ts/collection
`bash`
pnpm add @telegram.ts/collection
`typescript
import { Collection } from "@telegram.ts/collection";
// Create a collection
const users = new Collection
// Add items
users.set("123", { id: "123", name: "Alice", age: 25 });
users.set("456", { id: "456", name: "Bob", age: 30 });
// Use utility methods
const adults = users.filter((user) => user.age >= 18);
const names = users.map((user) => user.name);
const oldest = users.reduce((prev, curr) =>
curr.age > prev.age ? curr : prev,
);
// Chain operations
users
.filter((user) => user.age > 20)
.each((user) => console.log(user.name))
.map((user) => user.age);
`
This library is inspired by @discordjs/collection and adapted for telegram.ts use cases.
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! If you find any issues or have suggestions for improvements, please create a GitHub issue or submit a pull request. Additionally, feel free to reach out to me on Telegram via my username @SempaiJS or on Discord using my username sempaika_chess`.