server-devtools 0.1.0

package/dist/src/types/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../src/types/dashboard.ts"],"names":[],"mappings":""}

package/dist/src/types/database.d.ts

@@ -0,0 +1,16 @@
+import { IDevToolsError } from "./dashboard";
+export interface IDatabaseOperation {
+    spanId: string;
+    system?: string;
+    operation?: string;
+    database?: string;
+    collection?: string;
+    query?: string;
+    durationMs: number;
+    status: {
+        code: number;
+        message?: string;
+    };
+    error?: IDevToolsError;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/src/types/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/types/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB"}

package/dist/src/types/database.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=database.js.map

package/dist/src/types/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../src/types/database.ts"],"names":[],"mappings":""}

package/dist/src/types/http-client.d.ts

@@ -0,0 +1,8 @@
+export interface IHttpClientDetails {
+    spanId: string;
+    requestHeaders?: Record<string, string | string[]>;
+    requestBody?: unknown;
+    responseHeaders?: Record<string, string | string[]>;
+    responseBody?: unknown;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/src/types/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/types/http-client.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/src/types/http-client.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=http-client.js.map

package/dist/src/types/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../../src/types/http-client.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,7 @@
+export * from "./span";
+export * from "./trace";
+export * from "./dashboard";
+export * from "./misc";
+export * from "./database";
+export * from "./http-client";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA"}

package/dist/src/types/index.js

@@ -0,0 +1,23 @@
+"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("./span"), exports);
+__exportStar(require("./trace"), exports);
+__exportStar(require("./dashboard"), exports);
+__exportStar(require("./misc"), exports);
+__exportStar(require("./database"), exports);
+__exportStar(require("./http-client"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,yCAAuB;AACvB,0CAAwB;AACxB,8CAA4B;AAC5B,yCAAuB;AACvB,6CAA0B;AAC1B,gDAA6B"}

package/dist/src/types/misc.d.ts

@@ -0,0 +1,25 @@
+import { IncomingMessage } from "node:http";
+export interface IDevToolsRequest {
+    method: string;
+    path: string;
+    route?: string;
+    headers: Record<string, string | string[]>;
+    query: Record<string, string | string[]>;
+    params: Record<string, string>;
+    body?: unknown;
+}
+export interface IDevToolsCurrentUser {
+    [key: string]: unknown;
+}
+export interface IServerDevlToolsParams {
+    encryption?: {
+        key: string;
+        fields?: string[];
+    };
+    auth: {
+        password: string;
+        username: string;
+    };
+    getCurrentUser?: (req: IncomingMessage) => IDevToolsCurrentUser | undefined;
+}
+//# sourceMappingURL=misc.d.ts.map

package/dist/src/types/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../src/types/misc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,oBAAoB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACnC,UAAU,CAAC,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAC;IACF,IAAI,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAA;KACnB,CAAC;IACF,cAAc,CAAC,EAAE,CACb,GAAG,EAAE,eAAe,KACnB,oBAAoB,GAAG,SAAS,CAAC;CACzC"}

package/dist/src/types/misc.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=misc.js.map

package/dist/src/types/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../../src/types/misc.ts"],"names":[],"mappings":""}

package/dist/src/types/span.d.ts

@@ -0,0 +1,25 @@
+export type IDevToolsSpanType = 'http.server' | 'http.client' | 'database' | 'framework' | 'unknown';
+export interface IDevToolsSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    type: IDevToolsSpanType;
+    name: string;
+    startedAt: number;
+    durationMs: number;
+    attributes: Record<string, unknown>;
+    status: {
+        code: number;
+        message?: string;
+    };
+    error?: {
+        type?: string;
+        message?: string;
+        stack?: string;
+    };
+}
+export interface IExecutionNode {
+    span: IDevToolsSpan;
+    children: IExecutionNode[];
+}
+//# sourceMappingURL=span.d.ts.map

package/dist/src/types/span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../../src/types/span.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,aAAa,GACb,UAAU,GACV,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,IAAI,EAAE,iBAAiB,CAAC;IAExB,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC9B"}

package/dist/src/types/span.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=span.js.map

package/dist/src/types/span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.js","sourceRoot":"","sources":["../../../src/types/span.ts"],"names":[],"mappings":""}

package/dist/src/types/trace.d.ts

@@ -0,0 +1,32 @@
+import { IDevToolsCurrentUser } from './misc';
+import type { IDevToolsSpan } from './span';
+export interface IDevToolsTrace {
+    traceId: string;
+    rootSpanId?: string;
+    spans: IDevToolsSpan[];
+    startedAt: number;
+    durationMs?: number;
+    user?: IDevToolsCurrentUser;
+}
+export interface ITraceMetadata {
+    request?: {
+        body?: unknown;
+    };
+    response?: {
+        body?: unknown;
+    };
+    user?: IDevToolsCurrentUser;
+}
+export interface ITraceSummary {
+    traceId: string;
+    rootSpanId?: string;
+    startedAt: number;
+    durationMs?: number;
+    method?: string;
+    path?: string;
+    route?: string;
+    statusCode?: number;
+    hasError: boolean;
+    user?: IDevToolsCurrentUser;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/src/types/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/types/trace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AACD,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IAEF,QAAQ,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC/B"}

package/dist/src/types/trace.js

@@ -0,0 +1,4 @@
+"use strict";
+// src/core/trace.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=trace.js.map

package/dist/src/types/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/types/trace.ts"],"names":[],"mappings":";AAAA,oBAAoB"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,2 @@
+export declare function debugLog(message: string, data?: unknown): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAa9D"}

package/dist/src/utils/logger.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debugLog = debugLog;
+const config_1 = __importDefault(require("../config"));
+function debugLog(message, data) {
+    if (!config_1.default.SERVER_DEVTOOLS_DEBUG) {
+        return;
+    }
+    const prefix = `[ServerDevTools] ${message}`;
+    if (data === undefined) {
+        console.debug(prefix);
+        return;
+    }
+    console.debug(prefix, data);
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":";;;;;;AAAA,uDAA+B;AAE/B,kBAAyB,OAAe,EAAE,IAAc;IACpD,IAAI,CAAC,gBAAM,CAAC,qBAAqB,EAAE,CAAC;QAChC,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,OAAO,EAAE,CAAC;IAE7C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO;IACX,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "server-devtools",
+  "version": "0.1.0",
+  "description": "Chrome DevTools for your backend. Inspect HTTP requests, database operations, outbound calls, errors, and execution timing from an embedded dashboard.",
+"license": "Apache-2.0",
+  "author": "Godwin Ehikhamhen",
+  "type": "commonjs",
+
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "require": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    },
+    "./nestjs": {
+      "types": "./dist/src/nestjs.d.ts",
+      "require": "./dist/src/nestjs.js",
+      "default": "./dist/src/nestjs.js"
+    }
+  },
+
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+
+ "scripts": {
+  "clean": "rm -rf dist",
+  "build:sdk": "tsc -p tsconfig.build.json && node scripts/finalize-commonjs-entry.cjs",
+  "build:dashboard": "npm --prefix dashboard run build",
+  "build": "npm run clean && npm run build:sdk && npm run build:dashboard",
+  "test": "tsx --test tests/*.test.ts",
+  "typecheck": "tsc --noEmit",
+  "prepublishOnly": "npm run test && npm run typecheck && npm run build"
+},
+
+  "keywords": [
+    "nodejs",
+    "debugging",
+    "devtools",
+    "backend",
+    "opentelemetry",
+    "observability",
+    "tracing",
+    "express",
+    "nestjs",
+    "mongodb"
+  ],
+
+  "engines": {
+    "node": ">=20"
+  },
+
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/auto-instrumentations-node": "^0.79.0",
+    "@opentelemetry/instrumentation-express": "^0.69.0",
+    "@opentelemetry/instrumentation-mongodb": "^0.74.0",
+    "@opentelemetry/instrumentation-undici": "^0.31.0",
+    "@opentelemetry/sdk-metrics": "^2.10.0",
+    "@opentelemetry/sdk-node": "^0.221.0",
+    "@opentelemetry/sdk-trace-node": "^2.10.0"
+  },
+
+  "devDependencies": {
+    "@nestjs/common": "^11.2.3",
+    "@nestjs/core": "^11.2.3",
+    "@nestjs/platform-express": "^11.2.3",
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.6.1",
+    "express": "^5.2.1",
+    "mongodb": "^7.6.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2"
+  }
+}