@hotbunny/hackhub-content-sdk 0.9.5 → 0.9.6

package/README.md

@@ -42,7 +42,7 @@ export default class MyMod extends Bootstrap {
 Quests use a generic type parameter for type-safe data. `CreateData()` initializes the data once when the quest is first claimed. After that, access via `this.Data` and update via `this.SetData()`:
 
 ```typescript
-import { Quest, Events, Network, RegisterQuest } from "@hotbunny/hackhub-content-sdk";
+import { Quest, Network, RegisterQuest } from "@hotbunny/hackhub-content-sdk";
 
 interface InfiltrationData {
     targetIp: string;
@@ -81,14 +81,16 @@ class InfiltrationQuest extends Quest<InfiltrationData> {
             children: [],
         });
 
-        Events.on("Terminal.NmapScan", (data) => {
+        // Use this.Events.on() — listeners are automatically cleaned up
+        // when the quest completes or is abandoned. No memory leaks!
+        this.Events.on("Terminal.NmapScan", (data) => {
             if (data.ip === this.Data.targetIp) {
                 this.SetData("attempts", this.Data.attempts + 1);  // type-safe key & value
                 this.completeObjective("scan");
             }
         });
 
-        Events.on("Terminal.SSH.Connected", (data) => {
+        this.Events.on("Terminal.SSH.Connected", (data) => {
             if (data.ip === this.Data.targetIp) this.completeObjective("connect");
         });
     }

package/index.d.ts

@@ -1077,9 +1077,30 @@ export declare abstract class Bootstrap {
 	/** Called when the mod is being unloaded (e.g. disabled by user). */
 	OnModPackageUnloaded(): void;
 }
+/**
+ * Scoped event manager for a quest. All listeners registered via
+ * `this.Events.on()` are automatically removed when the quest
+ * completes or is abandoned, preventing memory leaks.
+ */
+export declare class QuestEvents {
+	private _listeners;
+	/** @internal */ _globalOn?: (event: string, callback: Function) => () => void;
+	/**
+	 * Listen to a game event or custom event. The listener is automatically
+	 * removed when the quest completes or is abandoned.
+	 */
+	on<T extends string>(event: T, callback: (data: T extends keyof ModEventMap ? ModEventMap[T] : any) => void): () => void;
+	/** Remove a specific listener. */
+	off(event: string, callback: Function): void;
+	/** Remove all listeners registered through this quest. */
+	offAll(): void;
+}
 /**
  * Base class for mod quests. Extend with a generic type for type-safe quest data.
  *
+ * Use `this.Events.on()` instead of the global `Events.on()` so listeners
+ * are automatically cleaned up when the quest completes or is abandoned.
+ *
  * @example
  * ```ts
  * interface MyData { targetIp: string; attempts: number; }
@@ -1097,8 +1118,9 @@ export declare abstract class Bootstrap {
  *     }
  *
  *     OnStart() {
- *         console.log(this.Data.targetIp); // fully typed
- *         this.SetData("attempts", 1);     // type-safe key & value
+ *         this.Events.on("Terminal.NmapScan", (data) => {
+ *             if (data.ip === this.Data.targetIp) this.completeObjective("scan");
+ *         });
  *     }
  * }
  * ```
@@ -1132,9 +1154,14 @@ export declare abstract class Quest<T extends Record<string, any> = Record<strin
 	Dialog?: QuestDialogDefinition;
 	/** Quest data created by CreateData(). Populated at runtime by the game engine. */
 	Data: T;
+	/**
+	 * Scoped event manager. Listeners registered here are automatically
+	 * cleaned up when the quest completes or is abandoned.
+	 */
+	Events: QuestEvents;
 	/**
 	 * Called when the quest is first claimed/started.
-	 * Use this to set up event listeners for objective completion.
+	 * Use this to set up event listeners via `this.Events.on()`.
 	 */
 	OnStart(): void | Promise<void>;
 	/** Called when all objectives are completed and the quest finishes. */
@@ -1316,6 +1343,7 @@ export declare abstract class App {
 	 */
 	Exports?: Record<string, any>;
 }
+type () => void$1 = () => void;
 /**
  * Game events API. Allows mods to listen to in-game events
  * such as terminal commands, file operations, network events, etc.
@@ -1353,7 +1381,7 @@ export declare namespace Events {
 	 * For known `ModEventMap` keys, the callback is fully typed.
 	 * For custom string events, the callback receives `any`.
 	 */
-	export function on<T extends string>(event: T, callback: (data: T extends keyof ModEventMap ? ModEventMap[T] : any) => void): () => void;
+	export function on<T extends string>(event: T, callback: (data: T extends keyof ModEventMap ? ModEventMap[T] : any) => void): () => void$1;
 	/** Remove a specific event listener. */
 	export function off(event: string, callback: Function): void;
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hotbunny/hackhub-content-sdk",
-    "version": "0.9.5",
+    "version": "0.9.6",
     "description": "Official modding SDK for HackHub - Ultimate Hacker Simulator on Steam. Create custom quests, websites, terminal commands, and desktop apps.",
     "types": "index.d.ts",
     "exports": {