@deepbounty/sdk 1.1.2 → 1.1.4

package/dist/events.d.ts

@@ -0,0 +1,41 @@
+import { HttpTraffic } from "./types/burpsuite";
+/**
+ * Predefined core events emitted by the server
+ * Modules can also emit custom events for inter-module communication
+ */
+export interface CoreEvents {
+    "http:traffic": HttpTraffic;
+}
+/**
+ * Event handler function signature
+ */
+export type EventHandler<T = any> = (data: T) => void | Promise<void>;
+/**
+ * Subscription object returned when subscribing to events
+ */
+export interface EventSubscription {
+    unsubscribe: () => void;
+}
+export interface IEventBus {
+    /**
+     * Subscribe to an event
+     * @param event - Event name (type-safe for CoreEvents, flexible for custom events)
+     * @param handler - Async handler function called when event is emitted
+     * @returns Subscription object with unsubscribe method
+     */
+    subscribe<K extends keyof CoreEvents>(event: K, handler: EventHandler<CoreEvents[K]>): EventSubscription;
+    subscribe<T = any>(event: string, handler: EventHandler<T>): EventSubscription;
+    /**
+     * Emit an event with data
+     * Non-blocking, async execution with rate limiting and error isolation
+     * @param event - Event name
+     * @param data - Event data
+     */
+    emit<K extends keyof CoreEvents>(event: K, data: CoreEvents[K]): void;
+    emit<T = any>(event: string, data: T): void;
+    /**
+     * Clear all listeners for a specific event or all events
+     * @param event - Optional event name to clear (clears all if not provided)
+     */
+    clear(event?: string): void;
+}

package/dist/events.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { ModuleSetting, TaskContent, TaskResult, Tool } from "./types";
+import { Alert, ModuleSetting, TaskContent, TaskResult, Tool } from "./types";
+import { IEventBus } from "./events";
 export interface Logger {
     info: (...args: any[]) => void;
     warn: (...args: any[]) => void;
@@ -81,6 +82,7 @@ export interface ServerAPI {
     logger: Logger;
     config: ConfigAPI;
     storage: StorageAPI;
+    events: IEventBus;
     /**
      * Register a task template that can be scheduled for all targets
      * @param uniqueKey Unique identifier for this task within the module (e.g., "subdomain-scan")
@@ -102,11 +104,24 @@ export interface ServerAPI {
      * @param tool The tool to register
      */
     registerTool(tool: Tool): void;
+    /**
+     * Create a new alert for a target
+     * @param targetId The ID of the target
+     * @param name The title of the alert
+     * @param subdomain The subdomain where the vulnerability was found
+     * @param score The severity score (0=Informational, 1=Low, 2=Medium, 3=High, 4=Critical)
+     * @param description Detailed description of the alert
+     * @param endpoint Specific endpoint/path where the vulnerability was found
+     * @param confirmed Whether the vulnerability has been confirmed (default: false)
+     * @returns The created alert ID
+     */
+    createAlert(targetId: number, name: string, subdomain: string, score: number, description: string, endpoint: string, confirmed?: boolean): Promise<Alert>;
 }
 export interface PluginLifecycle {
     run?(api: ServerAPI): Promise<void> | void;
     stop?(): Promise<void> | void;
 }
 export type PluginFactory = (api: ServerAPI) => PluginLifecycle | Promise<PluginLifecycle>;
+export { IEventBus, EventSubscription, CoreEvents, EventHandler, } from "./events";
 declare const _default: any;
 export default _default;

package/dist/types/burpsuite.d.ts

@@ -0,0 +1,15 @@
+/**
+ * HTTP traffic data from Burp Suite
+ */
+export interface HttpTraffic {
+    url: string;
+    method: string;
+    statusCode: number;
+    requestHeaders: Record<string, string>;
+    responseHeaders: Record<string, string>;
+    requestBody: string;
+    responseBody: string;
+    mimeType: string;
+    timestamp: Date;
+    targetId?: number;
+}

package/dist/types/burpsuite.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -5,3 +5,4 @@ export * from "./workers.js";
 export * from "./websockets.js";
 export * from "./tasks.js";
 export * from "./tools.js";
+export * from "./notifications.js";

package/dist/types/index.js

@@ -5,3 +5,4 @@ export * from "./workers.js";
 export * from "./websockets.js";
 export * from "./tasks.js";
 export * from "./tools.js";
+export * from "./notifications.js";

package/dist/types/notifications.d.ts

@@ -0,0 +1,30 @@
+export type NotificationService = {
+    provider: "discord";
+    config: DiscordConfig;
+    enabled: boolean;
+} | {
+    provider: "ntfysh";
+    config: ntfyshConfig;
+    enabled: boolean;
+};
+export interface DiscordConfig {
+    webhookUrl: string;
+    notificationRoleID?: string;
+}
+export interface ntfyshConfig {
+    serverRootUrl: string;
+    topic: string;
+    username?: string;
+    password?: string;
+    token?: string;
+}
+export interface NotificationConfigField {
+    name: string;
+    type: "text" | "password";
+    placeholder?: string;
+    required?: boolean;
+}
+export interface NotificationProvider {
+    label: string;
+    fields: NotificationConfigField[];
+}

package/dist/types/notifications.js

@@ -0,0 +1 @@
+export {};

package/dist/types/workers.d.ts

@@ -2,6 +2,8 @@ import { TaskExecution } from "./tasks";
 import { Tool } from "./tools";
 export interface Worker {
     id: number;
+    ip?: string;
     currentTasks: TaskExecution[];
     availableTools: Tool[];
+    connectedAt: Date;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@deepbounty/sdk",
-	"version": "1.1.2",
+	"version": "1.1.4",
 	"description": "DeepBounty SDK for module development",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",