@svadmin/devtools 0.3.11 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,14 @@
1
+ import type { DevtoolsSnapshot } from '@svadmin/devtools-contract';
2
+ export interface DevtoolsServerOptions {
3
+ snapshot: () => DevtoolsSnapshot | Promise<DevtoolsSnapshot>;
4
+ host?: string;
5
+ port?: number;
6
+ /** Optional bearer token; when omitted the server binds to localhost only. */
7
+ token?: string;
8
+ }
9
+ export interface DevtoolsServerHandle {
10
+ readonly url: string;
11
+ close: () => Promise<void>;
12
+ }
13
+ export declare function startDevtoolsServer(options: DevtoolsServerOptions): Promise<DevtoolsServerHandle>;
14
+ export type DevtoolsServer = typeof startDevtoolsServer;
package/dist/server.js ADDED
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Minimal read-only DevTools snapshot server.
3
+ *
4
+ * Intended for local development only: it exposes the same redacted snapshot
5
+ * contract used by the in-app DevTools overlay so a separate inspector process
6
+ * can poll it. Never mount this in production.
7
+ */
8
+ import { createServer } from 'node:http';
9
+ function unauthorized(response) {
10
+ response.writeHead(401, { 'content-type': 'application/json' });
11
+ response.end(JSON.stringify({ error: 'unauthorized' }));
12
+ }
13
+ export async function startDevtoolsServer(options) {
14
+ const host = options.host ?? '127.0.0.1';
15
+ const port = options.port ?? 0;
16
+ const token = options.token;
17
+ const handler = async (request, response) => {
18
+ const url = new URL(request.url ?? '/', `http://${request.headers.host ?? `${host}:${port}`}`);
19
+ if (request.method !== 'GET' || url.pathname !== '/snapshot') {
20
+ response.writeHead(404, { 'content-type': 'application/json' });
21
+ response.end(JSON.stringify({ error: 'not_found' }));
22
+ return;
23
+ }
24
+ if (token !== undefined && request.headers.authorization !== `Bearer ${token}`) {
25
+ unauthorized(response);
26
+ return;
27
+ }
28
+ try {
29
+ const snapshot = await options.snapshot();
30
+ response.writeHead(200, { 'content-type': 'application/json', 'cache-control': 'no-store' });
31
+ response.end(JSON.stringify(snapshot));
32
+ }
33
+ catch {
34
+ response.writeHead(500, { 'content-type': 'application/json' });
35
+ response.end(JSON.stringify({ error: 'snapshot_unavailable' }));
36
+ }
37
+ };
38
+ const server = createServer((request, response) => { void handler(request, response); });
39
+ await new Promise((resolve, reject) => {
40
+ server.once('error', reject);
41
+ server.listen(port, host, () => { server.off('error', reject); resolve(); });
42
+ });
43
+ const address = server.address();
44
+ const selectedPort = typeof address === 'object' && address !== null ? address.port : port;
45
+ return {
46
+ url: `http://${host}:${selectedPort}`,
47
+ close: () => new Promise((resolve, reject) => {
48
+ server.close(error => error ? reject(error) : resolve());
49
+ }),
50
+ };
51
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@svadmin/devtools",
3
- "version": "0.3.11",
3
+ "version": "0.4.2",
4
4
  "type": "module",
5
5
  "description": "Headless diagnostics core for svadmin — query traces, provider diagnostics, permission/resource/route inspection",
6
6
  "license": "MIT",
@@ -21,6 +21,10 @@
21
21
  ".": {
22
22
  "types": "./dist/index.d.ts",
23
23
  "import": "./dist/index.js"
24
+ },
25
+ "./server": {
26
+ "types": "./dist/server.d.ts",
27
+ "import": "./dist/server.js"
24
28
  }
25
29
  },
26
30
  "main": "./dist/index.js",
@@ -43,7 +47,7 @@
43
47
  "@svadmin/devtools-contract": "^0.3.1"
44
48
  },
45
49
  "peerDependencies": {
46
- "@svadmin/core": "^0.67.0"
50
+ "@svadmin/core": "^0.69.2"
47
51
  },
48
52
  "peerDependenciesMeta": {
49
53
  "@svadmin/core": {