@deepbounty/sdk 1.0.0

package/README.md

@@ -0,0 +1,20 @@
+# DeepBounty SDK
+
+The official SDK for developing modules for the DeepBounty project.
+
+## 📦 Installation
+
+```bash
+npm install @deepbounty/sdk
+```
+
+## 🔧 Build & Publish
+
+1. Build the SDK:
+   ```bash
+   npm run build
+   ```
+2. Publish to npm:
+   ```bash
+   npm publish --access public
+   ```

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { ModuleSetting } from "./types";
+export interface Logger {
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+}
+export interface ConfigAPI {
+    get<T = any>(key: string, defaultValue?: T): Promise<T>;
+    set<T = any>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    getAll(): Promise<Record<string, any>>;
+    getSetting(name: string): Promise<ModuleSetting>;
+    setSetting(name: string, value: any): Promise<void>;
+    getAllSettings(): Promise<ModuleSetting[]>;
+}
+export interface ServerAPI {
+    version: string;
+    logger: Logger;
+    config: ConfigAPI;
+}
+export interface PluginLifecycle {
+    run?(api: ServerAPI): Promise<void> | void;
+    stop?(): Promise<void> | void;
+}
+export type PluginFactory = (api: ServerAPI) => PluginLifecycle | Promise<PluginLifecycle>;
+declare const _default: any;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACzB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxD,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GAAG,CAC3B,GAAG,EAAE,SAAS,KACV,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;wBAE3B,GAAG;AAAxB,wBAAyB"}

package/dist/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = {}; // Type-only module for plugins to import types during compile

package/dist/types/alerts.d.ts

@@ -0,0 +1,13 @@
+export interface Alert {
+    id: number;
+    name: string;
+    targetName: string;
+    domain: string;
+    subdomain: string;
+    score: number;
+    confirmed: boolean;
+    description: string;
+    endpoint: string;
+    createdAt: string;
+}
+//# sourceMappingURL=alerts.d.ts.map

package/dist/types/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/types/alerts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/alerts.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./modules.js";
+export * from "./targets.js";
+export * from "./alerts.js";
+export * from "./workers.js";
+export * from "./websockets.js";
+export * from "./tasks.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./modules.js"), exports);
+__exportStar(require("./targets.js"), exports);
+__exportStar(require("./alerts.js"), exports);
+__exportStar(require("./workers.js"), exports);
+__exportStar(require("./websockets.js"), exports);
+__exportStar(require("./tasks.js"), exports);

package/dist/types/modules.d.ts

@@ -0,0 +1,19 @@
+export interface ModuleSetting {
+    name: string;
+    type: "checkbox" | "text" | "select" | "info";
+    default: string | boolean;
+    label: string;
+    value?: string | boolean;
+    options?: string[];
+}
+export interface Module {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    settings?: ModuleSetting[];
+}
+export interface LoadedModule extends Module {
+    run: () => Promise<any>;
+}
+//# sourceMappingURL=modules.d.ts.map

package/dist/types/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/types/modules.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IAEtB,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC3C,GAAG,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;CACxB"}

package/dist/types/modules.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/targets.d.ts

@@ -0,0 +1,12 @@
+export interface Target {
+    id: number;
+    name: string;
+    domain: string;
+    subdomains: string[];
+    activeScan: boolean;
+    settings?: {
+        userAgent?: string;
+        customHeader?: string;
+    };
+}
+//# sourceMappingURL=targets.d.ts.map

package/dist/types/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/types/targets.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IAEpB,QAAQ,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACF"}

package/dist/types/targets.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/tasks.d.ts

@@ -0,0 +1,15 @@
+export interface Task {
+    id: number;
+    type: "tool" | "command";
+    payload: Record<string, any>;
+    workerId: number;
+    status: "pending" | "running" | "completed" | "failed";
+    createdAt: Date;
+}
+export interface TaskResult {
+    taskId: number;
+    success: boolean;
+    output?: any;
+    error?: string;
+}
+//# sourceMappingURL=tasks.d.ts.map

package/dist/types/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/types/tasks.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvD,SAAS,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IAEjB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types/tasks.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/websockets.d.ts

@@ -0,0 +1,5 @@
+export interface WebSocketMessage {
+    type: string;
+    data: any;
+}
+//# sourceMappingURL=websockets.d.ts.map

package/dist/types/websockets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websockets.d.ts","sourceRoot":"","sources":["../../src/types/websockets.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;CACV"}

package/dist/types/websockets.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/workers.d.ts

@@ -0,0 +1,14 @@
+import { Task } from "./tasks";
+export interface Worker {
+    id: number;
+    currentTasks: Task[];
+    availableTools: Tool[];
+    loadFactor: number;
+}
+export interface Tool {
+    name: string;
+    downloadUrl: string;
+    version: string;
+    description?: string;
+}
+//# sourceMappingURL=workers.d.ts.map

package/dist/types/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../src/types/workers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,WAAW,MAAM;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB,cAAc,EAAE,IAAI,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/workers.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@deepbounty/sdk",
+	"version": "1.0.0",
+	"description": "DeepBounty SDK for module development",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.js"
+		},
+		"./types": {
+			"types": "./dist/types/index.d.ts"
+		},
+		"./types/*": {
+			"types": "./dist/types/*.d.ts"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "tsc",
+		"publish": "npm run build && npm publish --access public"
+	},
+	"keywords": [
+		"deepbounty",
+		"sdk",
+		"types",
+		"module",
+		"plugin"
+	],
+	"author": "dd_06",
+	"license": "GPL-3.0-only",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/dd060606/DeepBounty.git",
+		"directory": "sdk"
+	},
+	"homepage": "https://github.com/dd060606/DeepBounty#readme",
+	"bugs": {
+		"url": "https://github.com/dd060606/DeepBounty/issues"
+	},
+	"devDependencies": {
+		"typescript": "^5.9.2"
+	}
+}