feat: allow collectors to incrementally emit

.changeset/selfish-dolphin-film.md

@@ -0,0 +1,5 @@
+---
+"guilded.js": patch
+---
+
+feat: add a collect event to collectors

packages/guilded.js/lib/structures/collectors/Collector.ts

@@ -1,6 +1,8 @@
 import { Collection } from "@discordjs/collection";
 import type { MaybePromise } from "../../typings";
 import type { Client } from "../Client";
+import EventEmitter from "events";
+import type TypedEmitter from "typed-emitter";
 
 /**
  * A collector is just a wrapper over a set of events for collecting a structure.
@@ -23,6 +25,8 @@ export abstract class Collector<T extends CollectableStructure> {
     /** Bound function for item receiving */
     protected boundItemReceiver = this.itemReceived.bind(this);
 
+    public emitter = new EventEmitter() as TypedEmitter<CollectorEvents<T>>;
+
     constructor(public readonly client: Client, public options: Partial<CollectorOptions<T>>) {
         /** Check if timeLimit is specified */
         if (!options.timeLimit) throw new Error("You must specify a time limit in milliseconds for this collector.");
@@ -64,6 +68,7 @@ export abstract class Collector<T extends CollectableStructure> {
                 this.isActive = false;
             }
 
+            this.emitter.emit("collect", entry);
             return true;
         }
 
@@ -137,3 +142,8 @@ export type CollectorOptions<T> = {
     /** the max amount of entries allowed to be collected */
     max?: number;
 };
+
+/** events that collectors can emit */
+export type CollectorEvents<T> = {
+    collect: (item: T) => unknown;
+};