@stella_project/stellalib 1.0.0

package/LICENSE

@@ -0,0 +1,213 @@
+Open Software License v. 3.0 (OSL-3.0)
+
+Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel
+
+This Open Software License (the "License") applies to any original work of
+authorship (the "Original Work") whose owner (the "Licensor") has placed the
+following licensing notice adjacent to the copyright notice for the Original
+Work:
+
+Licensed under the Open Software License version 3.0
+
+1) Grant of Copyright License. Licensor grants You a worldwide, royalty-free,
+non-exclusive, sublicensable license, for the duration of the copyright, to do
+the following:
+
+  a) to reproduce the Original Work in copies, either alone or as part of a
+     collective work;
+  b) to translate, adapt, alter, transform, modify, or arrange the Original
+     Work, thereby creating derivative works ("Derivative Works") based upon
+     the Original Work;
+  c) to distribute or communicate copies of the Original Work and Derivative
+     Works to the public, with the proviso that copies of Original Work or
+     Derivative Works that You distribute or communicate shall be licensed
+     under this Open Software License;
+  d) to perform the Original Work publicly; and
+  e) to display the Original Work publicly.
+
+2) Grant of Patent License. Licensor grants You a worldwide, royalty-free,
+non-exclusive, sublicensable license, under patent claims owned or controlled
+by the Licensor that are embodied in the Original Work as furnished by the
+Licensor, for the duration of the patents, to make, use, sell, offer for sale,
+have made, and import the Original Work and Derivative Works.
+
+3) Grant of Source Code License. The term "Source Code" means the preferred
+form of the Original Work for making modifications to it and all available
+documentation describing how to modify the Original Work. Licensor agrees to
+provide a machine-readable copy of the Source Code of the Original Work along
+with each copy of the Original Work that Licensor distributes. Licensor
+reserves the right to satisfy this obligation by placing a machine-readable
+copy of the Source Code in an information repository reasonably calculated to
+permit inexpensive and convenient access by You for as long as Licensor
+continues to distribute the Original Work.
+
+4) Exclusions From License Grant. Neither the names of Licensor, nor the names
+of any contributors to the Original Work, nor any of their trademarks or
+service marks, may be used to endorse or promote products derived from this
+Original Work without express prior permission of the Licensor. Except as
+expressly stated herein, nothing in this License grants any license to
+Licensor's trademarks, copyrights, patents, trade secrets or any other
+intellectual property. No patent license is granted to make, use, sell, offer
+for sale, have made, or import embodiments of any patent claims other than the
+licensed claims defined in Section 2. No license is granted to the trademarks
+of Licensor even if such marks are included in the Original Work. Nothing in
+this License shall be interpreted to prohibit Licensor from licensing under
+terms different from this License any Original Work that Licensor otherwise
+would have a right to license.
+
+5) External Deployment. The term "External Deployment" means the use,
+distribution, or communication of the Original Work or Derivative Works in any
+way such that the Original Work or Derivative Works may be used by anyone
+other than You, whether those works are distributed or communicated to those
+persons or made available as an application intended for use over a network.
+As an express condition for the grants of license hereunder, You must treat
+any External Deployment by You of the Original Work or a Derivative Work as a
+distribution under section 1(c).
+
+6) Attribution Rights. You must retain, in the Source Code of any Derivative
+Works that You create, all copyright, patent, or trademark notices from the
+Source Code of the Original Work, as well as any notices of licensing and any
+descriptive text identified therein as an "Attribution Notice." You must cause
+the Source Code for any Derivative Works that You create to carry a prominent
+Attribution Notice reasonably calculated to inform recipients that You have
+modified the Original Work.
+
+7) Warranty of Provenance and Disclaimer of Warranty. Licensor warrants that
+the copyright in and to the Original Work and the patent rights granted herein
+by Licensor are owned by the Licensor or are sublicensed to You under the
+terms of this License with the permission of the contributor(s) of those
+copyrights and patent rights. Except as expressly stated in the immediately
+preceding sentence, the Original Work is provided under this License on an
+"AS IS" BASIS and WITHOUT WARRANTY, either express or implied, including,
+without limitation, the warranties of non-infringement, merchantability or
+fitness for a particular purpose. THE ENTIRE RISK AS TO THE QUALITY OF THE
+ORIGINAL WORK IS WITH YOU. This DISCLAIMER OF WARRANTY constitutes an
+essential part of this License. No license to the Original Work is granted by
+this License except under this disclaimer.
+
+8) Limitation of Liability. Under no circumstances and under no legal theory,
+whether in tort (including negligence), contract, or otherwise, shall the
+Licensor be liable to anyone for any indirect, special, incidental, or
+consequential damages of any character arising as a result of this License or
+the use of the Original Work including, without limitation, damages for loss
+of goodwill, work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses. This limitation of liability shall not
+apply to the extent applicable law prohibits such limitation.
+
+9) Acceptance and Termination. If, at any time, You expressly assented to
+this License, that assent indicates your clear and irrevocable acceptance of
+this License and all of its terms and conditions. If You distribute or
+communicate copies of the Original Work or a Derivative Work, You must make a
+reasonable effort under the circumstances to obtain the express assent of
+recipients to the terms of this License. This License conditions your rights
+to undertake the activities listed in Section 1, including your right to
+create Derivative Works based upon the Original Work, and doing so without
+honoring these terms and conditions is prohibited by copyright law and
+international treaty. Nothing in this License is intended to affect copyright
+exceptions and limitations (including "fair use" or "fair dealing"). This
+License shall terminate immediately and You may no longer exercise any of the
+rights granted to You by this License upon your failure to honor the
+conditions in Section 1(c).
+
+10) Termination for Patent Action. This License shall terminate automatically
+and You may no longer exercise any of the rights granted to You by this
+License as of the date You commence an action, including a cross-claim or
+counterclaim, against Licensor or any licensee alleging that the Original Work
+infringes a patent. This termination provision shall not apply for an action
+alleging patent infringement by combinations of the Original Work with other
+software or hardware.
+
+11) Jurisdiction, Venue and Governing Law. Any action or suit relating to this
+License may be brought only in the courts of a jurisdiction wherein the
+Licensor resides or in which Licensor conducts its primary business, and under
+the laws of that jurisdiction excluding its conflict-of-law provisions. The
+application of the United Nations Convention on Contracts for the
+International Sale of Goods is expressly excluded. Any use of the Original
+Work outside the scope of this License or after its termination shall be
+subject to the requirements and penalties of copyright or patent law in the
+appropriate jurisdiction. This section shall survive the termination of this
+License.
+
+12) Attorneys' Fees. In any action to enforce the terms of this License or
+seeking damages relating thereto, the prevailing party shall be entitled to
+recover its costs and expenses, including, without limitation, reasonable
+attorneys' fees and costs incurred in connection with such action, including
+any appeal of such action. This section shall survive the termination of this
+License.
+
+13) Miscellaneous. If any provision of this License is held to be
+unenforceable, such provision shall be reformed only to the extent necessary
+to make it enforceable.
+
+14) Definition of "You" in This License. "You" throughout this License,
+whether in upper or lower case, means an individual or a legal entity
+exercising rights under, and complying with all of the terms of, this License.
+For legal entities, "You" includes any entity that controls, is controlled by,
+or is under common control with you. For purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the direction or
+management of such entity, whether by contract or otherwise, or (ii) ownership
+of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial
+ownership of such entity.
+
+15) Right to Use. You may use the Original Work in all ways not otherwise
+restricted or conditioned by this License or by law, and Licensor promises not
+to interfere with or be responsible for such uses by You.
+
+16) Modification of This License. This License is Copyright (c) 2005 Lawrence
+Rosen. Permission is granted to copy, distribute, or communicate this License
+without modification. Nothing in this License permits You to modify this
+License as applied to the Original Work or to Derivative Works. However, You
+may modify the text of this License and copy, distribute or communicate your
+modified version (the "Modified License") and apply it to other original works
+of authorship subject to the following conditions: (i) You may not indicate in
+any way that your Modified License is the "Open Software License" or "OSL"
+and you may not use those names in the name of your Modified License;
+(ii) You must replace the notice specified in the first paragraph above with
+the notice "Licensed under <insert your license name here>" or with a notice
+of your own that is not confusingly similar to the notice in this License; and
+(iii) You may not claim that your original works are open source software
+unless your Modified License has been approved by Open Source Initiative (OSI)
+and You comply with its license review and certification process.
+
+================================================================================
+
+NOTICE — UPSTREAM DERIVATIVE WORK
+
+This software, StellaLib, is a derivative work based in part on LithiumX.
+The original LithiumX source code is Copyright (c) 2025 Anantix Network and
+was released under the MIT License. In compliance with the MIT License, the
+original copyright notice and permission notice are reproduced below.
+
+StellaLib as a whole is licensed under the Open Software License v3.0 (above).
+However, the portions derived from LithiumX remain available under the
+original MIT License terms. Recipients of this software receive rights under
+BOTH licenses: the OSL-3.0 for the StellaLib original contributions and the
+MIT License for the LithiumX-derived portions.
+
+See THIRD-PARTY-NOTICES.md for the full upstream license text and details of
+which components are derived from LithiumX.
+
+--------------------------------------------------------------------------------
+
+MIT License
+
+Copyright (c) 2025 Anantix Network
+https://github.com/anantix-network/LithiumX
+
+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,285 @@
+# StellaLib
+
+A powerful, modern Lavalink client library for TypeScript/JavaScript with auto version detection (v3 + v4), session persistence, smart autoplay, and graceful shutdown.
+
+[![npm version](https://img.shields.io/npm/v/stellalib.svg)](https://www.npmjs.com/package/stellalib)
+[![License: OSL-3.0](https://img.shields.io/badge/License-OSL--3.0-blue.svg)](LICENSE)
+
+## Features
+
+- **Lavalink v3 + v4** — Auto-detects server version and adapts protocol automatically
+- **Session Persistence** — Save/restore session IDs across bot restarts with `FileSessionStore`
+- **Smart Autoplay** — Auto-mix engine with transition scoring, multi-seed recommendations, and history tracking
+- **Graceful Shutdown** — Persist sessions, close nodes cleanly, and flush stores on SIGINT/SIGTERM
+- **Voice Readiness** — Promise-based voice connection waiting before playback
+- **Audio Filters** — Built-in presets: bassboost, nightcore, vaporwave, 8D, slowmo, and more
+- **Search Caching** — LRU cache with TTL for search results to reduce API calls
+- **Search Fallback** — Automatic fallback across platforms (Spotify → SoundCloud → YouTube)
+- **Node Selection** — Penalty-based, least-load, least-players, or priority-based node selection
+- **Heartbeat** — WebSocket ping/pong to detect dead connections and auto-reconnect
+- **REST Resilience** — Auto-retry on 429 rate limits, GET deduplication, request timeouts
+- **Reconnect** — Exponential backoff with jitter to prevent thundering herd
+- **Plugin System** — Extensible via plugins
+- **Typed Events** — Fully typed event emitter for all manager events
+- **Strict TypeScript** — Written with strict TypeScript
+
+## Installation
+
+```bash
+npm install stellalib
+# or
+yarn add stellalib
+# or
+bun add stellalib
+```
+
+## Quick Start
+
+```ts
+import { Client, GatewayIntentBits } from "discord.js";
+import { StellaManager, FileSessionStore } from "stellalib";
+
+const client = new Client({
+  intents: [
+    GatewayIntentBits.Guilds,
+    GatewayIntentBits.GuildVoiceStates,
+    GatewayIntentBits.GuildMessages,
+    GatewayIntentBits.MessageContent,
+  ],
+});
+
+const manager = new StellaManager({
+  nodes: [
+    {
+      identifier: "main",
+      host: "localhost",
+      port: 2333,
+      password: "youshallnotpass",
+      resumeStatus: true,
+      resumeTimeout: 120,
+      heartbeatInterval: 30000,
+    },
+  ],
+  autoPlay: true,
+  defaultSearchPlatform: "spotify",
+  searchFallback: ["soundcloud", "youtube music", "youtube"],
+  sessionStore: new FileSessionStore("./sessions.json"),
+  caches: { enabled: true, time: 60000, maxSize: 200 },
+  send(id, payload) {
+    const guild = client.guilds.cache.get(id);
+    if (guild) guild.shard.send(payload);
+  },
+});
+
+// Forward raw Discord events to StellaLib
+client.on("raw", (d) => manager.updateVoiceState(d));
+
+client.on("ready", () => {
+  console.log(`Bot ready as ${client.user?.tag}`);
+  manager.init(client.user!.id);
+});
+
+// Graceful shutdown
+for (const sig of ["SIGINT", "SIGTERM"]) {
+  process.on(sig, async () => {
+    await manager.shutdown();
+    process.exit(0);
+  });
+}
+
+// Play a track
+manager.on("NodeConnect", async () => {
+  const player = manager.create({
+    guild: "GUILD_ID",
+    voiceChannel: "VOICE_CHANNEL_ID",
+    textChannel: "TEXT_CHANNEL_ID",
+  });
+  player.connect();
+
+  const res = await manager.search("never gonna give you up");
+  if (res.tracks.length) {
+    player.queue.add(res.tracks[0]);
+    player.play();
+  }
+});
+
+client.login("YOUR_BOT_TOKEN");
+```
+
+## Session Persistence
+
+StellaLib can persist Lavalink session IDs across bot restarts, so players keep playing without interruption:
+
+```ts
+import { FileSessionStore } from "stellalib";
+
+const manager = new StellaManager({
+  sessionStore: new FileSessionStore("./sessions.json"),
+  nodes: [{
+    resumeStatus: true,
+    resumeTimeout: 120, // seconds Lavalink waits for reconnect
+    // ...
+  }],
+  // ...
+});
+
+// On shutdown, sessions are saved automatically
+await manager.shutdown();
+```
+
+You can also implement your own store (e.g., Redis) by implementing the `SessionStore` interface:
+
+```ts
+interface SessionStore {
+  get(nodeId: string): Promise<string | null> | string | null;
+  set(nodeId: string, sessionId: string): Promise<void> | void;
+  delete(nodeId: string): Promise<void> | void;
+}
+```
+
+## Smart Autoplay
+
+When the queue ends and autoplay is enabled, StellaLib's auto-mix engine finds the best next track:
+
+```ts
+// Enable autoplay for a player
+player.setAutoplay(true, { id: user.id, tag: user.tag });
+```
+
+The engine scores candidates based on:
+- **Duration similarity** — Prefer tracks close in length to recent plays
+- **Author/title overlap** — Prioritize same artist or related keywords
+- **Source consistency** — Stay on the same platform when possible
+- **Diversity** — Avoid repeating the same artist too many times
+- **History tracking** — Never replay recently heard tracks (last 50)
+
+Uses multi-seed context from the last 5 tracks for Spotify recommendations, theme keyword extraction, and cross-artist transitions.
+
+## Search with Fallback
+
+```ts
+const manager = new StellaManager({
+  defaultSearchPlatform: "spotify",
+  searchFallback: ["soundcloud", "youtube music", "youtube"],
+  // ...
+});
+
+// If Spotify returns empty, automatically tries SoundCloud, then YouTube Music, then YouTube
+const result = await manager.search("natori セレナーデ");
+```
+
+## Audio Filters
+
+```ts
+// Toggle filters
+await player.filters.setFilter("nightcore", true);
+await player.filters.setFilter("bassboost", true);
+await player.filters.setFilter("vaporwave", true);
+await player.filters.setFilter("eightD", true);
+
+// Clear all filters
+await player.filters.clearFilters();
+```
+
+Available: `bassboost`, `nightcore`, `vaporwave`, `eightD`, `slowmo`, `soft`, `trebleBass`, `tv`, `distort`
+
+## Manager Stats
+
+```ts
+const stats = manager.getStats();
+// { nodes, players, playingPlayers, cacheSize, cacheMemoryEstimate }
+```
+
+## Events
+
+```ts
+manager.on("NodeConnect", (node) => { });
+manager.on("NodeDisconnect", (node, reason) => { });
+manager.on("NodeError", (node, error) => { });
+manager.on("NodeReconnect", (node) => { });
+manager.on("NodeRaw", (payload) => { });
+manager.on("TrackStart", (player, track, payload) => { });
+manager.on("TrackEnd", (player, track, payload) => { });
+manager.on("TrackStuck", (player, track, payload) => { });
+manager.on("TrackError", (player, track, payload) => { });
+manager.on("QueueEnd", (player, track, payload) => { });
+manager.on("SocketClosed", (player, payload) => { });
+manager.on("PlayerCreate", (player) => { });
+manager.on("PlayerDestroy", (player) => { });
+manager.on("PlayerMove", (player, oldChannel, newChannel) => { });
+manager.on("PlayerDisconnect", (player, oldChannel) => { });
+manager.on("PlayerStateUpdate", (oldPlayer, newPlayer) => { });
+manager.on("Debug", (message) => { });
+```
+
+## Project Structure
+
+```
+src/
+  Structures/
+    Manager.ts      — Main hub: manages nodes, players, search, voice updates
+    Node.ts         — Lavalink node: WebSocket, reconnect, session resume, autoplay
+    Player.ts       — Guild player: playback, queue, voice readiness, filters
+    Queue.ts        — Queue: extends Array with add/remove/shuffle
+    Rest.ts         — REST client with retry, timeout, and deduplication
+    Filters.ts      — Audio filters and presets
+    LRUCache.ts     — Bounded LRU cache with TTL
+    SessionStore.ts — FileSessionStore for session persistence
+    Types.ts        — All TypeScript interfaces and types
+    Utils.ts        — TrackUtils, Structure, Plugin helpers
+  Utils/
+    FiltersEqualizers.ts — Equalizer band presets
+    ManagerCheck.ts      — Manager option validation
+    NodeCheck.ts         — Node option validation
+    PlayerCheck.ts       — Player option validation
+  index.ts               — Re-exports everything
+```
+
+## Multi-Version Support
+
+StellaLib auto-detects your Lavalink server version on connect and adapts:
+
+| Feature | Lavalink v3 | Lavalink v4 |
+|---|---|---|
+| **WebSocket URL** | `ws://host:port` | `ws://host:port/v4/websocket` |
+| **Player ops** | WebSocket ops (`play`, `stop`, `pause`, etc.) | REST PATCH |
+| **Session resume** | `Resume-Key` header + WS `configureResuming` | `Session-Id` header + REST PATCH |
+| **Load tracks** | `/loadtracks` (normalized to v4 format) | `/v4/loadtracks` |
+| **Server info** | `/version` | `/v4/info` |
+| **Player sync** | Not available | Full player state sync |
+
+```ts
+// No configuration needed — version is auto-detected
+const manager = new StellaManager({
+  nodes: [{ host: "my-v3-server.com", port: 2333 }],
+  // ...
+});
+
+// Check detected version after connect
+manager.on("NodeConnect", (node) => {
+  console.log(`Connected to Lavalink v${node.version}`); // 3 or 4
+});
+```
+
+## Requirements
+
+- **Node.js** >= 18.0.0
+- **Lavalink** v3.x or v4.x
+
+## License
+
+**StellaLib** is licensed under the [Open Software License v3.0 (OSL-3.0)](LICENSE).
+
+Copyright (c) 2026 AntonyZ, x2sadddDM, SynX, Astel
+
+### Upstream License (MIT)
+
+StellaLib is a derivative work based on [LithiumX](https://github.com/anantix-network/LithiumX) by Anantix Network. The original LithiumX code is Copyright (c) 2025 Anantix Network and was released under the **MIT License**.
+
+In compliance with the MIT License, the original copyright and permission notices are preserved in:
+
+- [LICENSE](LICENSE) — Contains both the OSL-3.0 text and the upstream MIT notice
+- [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md) — Full details of derived components and the complete MIT license text
+- Every derived source file carries a `@license` header attributing both copyrights
+
+Recipients of this software receive rights under **both** licenses: OSL-3.0 for StellaLib's original contributions, and MIT for the LithiumX-derived portions.

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,84 @@
+# Third-Party Notices
+
+This file contains notices and licenses for third-party software included in
+or used by StellaLib.
+
+---
+
+## LithiumX
+
+- **Project:** LithiumX
+- **Repository:** https://github.com/anantix-network/LithiumX
+- **Copyright:** Copyright (c) 2025 Anantix Network
+- **License:** MIT License
+
+### Scope of Derived Work
+
+StellaLib's architecture, class structure, and significant portions of its
+source code are derived from LithiumX. The following components contain code
+originally authored by Anantix Network and subsequently modified:
+
+| File | Derived From |
+|---|---|
+| `src/Structures/Manager.ts` | `LithiumX/src/Structures/Manager.ts` |
+| `src/Structures/Node.ts` | `LithiumX/src/Structures/Node.ts` |
+| `src/Structures/Player.ts` | `LithiumX/src/Structures/Player.ts` |
+| `src/Structures/Queue.ts` | `LithiumX/src/Structures/Queue.ts` |
+| `src/Structures/Rest.ts` | `LithiumX/src/Structures/Rest.ts` |
+| `src/Structures/Filters.ts` | `LithiumX/src/Structures/Filters.ts` |
+| `src/Structures/Utils.ts` | `LithiumX/src/Structures/Utils.ts` |
+| `src/Structures/Types.ts` | Extracted from multiple LithiumX source files |
+| `src/Utils/FiltersEqualizers.ts` | `LithiumX/src/Utils/FiltersEqualizers.ts` |
+| `src/Utils/ManagerCheck.ts` | `LithiumX/src/Utils/ManagerCheck.ts` |
+| `src/Utils/NodeCheck.ts` | `LithiumX/src/Utils/NodeCheck.ts` |
+| `src/Utils/PlayerCheck.ts` | `LithiumX/src/Utils/PlayerCheck.ts` |
+
+### Modifications Made by StellaLib Authors
+
+- Added `channelId` to voice PATCH payloads (Lavalink v4 compliance)
+- Implemented promise-based voice readiness system
+- Added session resume with `Session-Id` header and player state sync
+- Replaced `@discordjs/collection` with native `Map` iteration
+- Added exponential backoff on WebSocket reconnect
+- Extracted shared types into `Types.ts` to eliminate circular dependencies
+- Added `Debug` event for internal logging
+- Improved error handling to prevent unhandled promise rejections
+- Added search result caching
+
+### Full MIT License Text
+
+```
+MIT License
+
+Copyright (c) 2025 Anantix Network
+
+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.
+```
+
+---
+
+## tiny-typed-emitter
+
+- **Repository:** https://github.com/binier/tiny-typed-emitter
+- **License:** MIT License
+
+## ws
+
+- **Repository:** https://github.com/websockets/ws
+- **License:** MIT License