@deepbounty/sdk 1.1.1 → 1.1.3

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ModuleSetting, TaskContent, TaskResult, Tool } from "./types";
+import { Alert, ModuleSetting, TaskContent, TaskResult, Tool } from "./types";
 export interface Logger {
     info: (...args: any[]) => void;
     warn: (...args: any[]) => void;
@@ -39,10 +39,48 @@ export interface ConfigAPI {
      */
     getAllSettings(): Promise<ModuleSetting[]>;
 }
+export interface StorageAPI {
+    /**
+     * Execute a raw SQL query (SELECT)
+     * @param sql The SQL query to execute
+     * @param params Optional parameters for the query
+     * @returns All matching rows
+     */
+    query<T = any>(sql: string, params?: any[]): T[];
+    /**
+     * Execute a raw SQL query and return the first row
+     * @param sql The SQL query to execute
+     * @param params Optional parameters for the query
+     * @returns The first matching row or undefined
+     */
+    queryOne<T = any>(sql: string, params?: any[]): T | undefined;
+    /**
+     * Execute a raw SQL statement (INSERT, UPDATE, DELETE)
+     * @param sql The SQL statement to execute
+     * @param params Optional parameters for the statement
+     * @returns Information about the execution (changes, lastInsertRowid)
+     */
+    execute(sql: string, params?: any[]): {
+        changes: number | bigint;
+        lastInsertRowid: number | bigint;
+    };
+    /**
+     * Helper method to create a table if it doesn't exist
+     * @param tableName The name of the table to create
+     * @param schema The schema definition for the table
+     */
+    createTable(tableName: string, schema: string): void;
+    /**
+     * Helper method to drop a table
+     * @param tableName The name of the table to drop
+     */
+    dropTable(tableName: string): void;
+}
 export interface ServerAPI {
     version: string;
     logger: Logger;
     config: ConfigAPI;
+    storage: StorageAPI;
     /**
      * 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")
@@ -64,6 +102,18 @@ 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;

package/dist/types/modules.d.ts

@@ -16,4 +16,5 @@ export interface ModuleSetting {
 }
 export interface LoadedModule extends Module {
     run: () => Promise<any>;
+    stop?: () => void;
 }

package/dist/types/tasks.d.ts

@@ -13,7 +13,6 @@ export interface TaskTemplate {
     content: TaskContent;
     interval: number;
     active: boolean;
-    createdAt: Date;
 }
 export interface ScheduledTask {
     id: number;
@@ -48,5 +47,4 @@ export interface TargetTaskOverride {
     targetId: number;
     taskTemplateId: number;
     active: boolean;
-    createdAt: Date;
 }

package/dist/types/workers.d.ts

@@ -4,5 +4,4 @@ export interface Worker {
     id: number;
     currentTasks: TaskExecution[];
     availableTools: Tool[];
-    loadFactor: number;
 }

package/package.json

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