@farm.js/devtools 0.1.0-beta.109 → 0.1.1-beta.1
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.
- package/dist/client.js +19 -17
- package/dist/index.js +62 -62
- package/dist/modules.js +84 -102
- package/dist/server.js +103 -117
- package/dist/types.js +4 -1
- package/package.json +2 -2
package/dist/client.js
CHANGED
|
@@ -1,13 +1,12 @@
|
|
|
1
1
|
"use client";
|
|
2
2
|
import "@fontsource-variable/geist-mono/wght.css";
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
shadow.innerHTML = `<style>
|
|
3
|
+
function startDevtoolsLauncher(runtimeWindow = window) {
|
|
4
|
+
const document = runtimeWindow.document;
|
|
5
|
+
const existing = document.querySelector("farm-devtools-launcher");
|
|
6
|
+
existing?.remove();
|
|
7
|
+
const host = document.createElement("farm-devtools-launcher");
|
|
8
|
+
const shadow = host.attachShadow({ mode: "open", delegatesFocus: true });
|
|
9
|
+
shadow.innerHTML = `<style>
|
|
11
10
|
:host{--bg:#ffffff;--surface:#fafafa;--line:#d9d9d3;--text:#1b1b19;position:fixed;left:18px;bottom:18px;z-index:2147483645}
|
|
12
11
|
button{box-sizing:border-box;display:flex;align-items:center;gap:9px;min-height:42px;margin:0;padding:0 12px;border:1px solid var(--line);border-radius:999px;background:var(--bg);color:var(--text);box-shadow:0 10px 32px rgb(0 0 0 / 16%);font:11px/1.45 "Geist Mono Variable","Geist Mono",ui-monospace,SFMono-Regular,Menlo,monospace;font-variation-settings:"wght" 620;letter-spacing:0;text-transform:uppercase;text-rendering:geometricPrecision;white-space:nowrap;cursor:pointer;-webkit-tap-highlight-color:transparent}
|
|
13
12
|
@media(hover:hover){button:hover{background:var(--surface)}}
|
|
@@ -18,13 +17,16 @@ export function startDevtoolsLauncher(runtimeWindow = window) {
|
|
|
18
17
|
@media(max-width:520px){:host{left:8px;bottom:8px}}
|
|
19
18
|
@media(pointer:coarse){button{min-height:44px}}
|
|
20
19
|
</style><button type="button" aria-label="Open Farm DevTools"><img src="/__farm/devtools/assets/logo.svg" alt=""><span>DevTools</span></button>`;
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
20
|
+
const button = shadow.querySelector("button");
|
|
21
|
+
button.onclick = () => runtimeWindow.__FARM_DEVTOOLS__?.open();
|
|
22
|
+
document.body.append(host);
|
|
23
|
+
return {
|
|
24
|
+
dispose() {
|
|
25
|
+
button.onclick = null;
|
|
26
|
+
host.remove();
|
|
27
|
+
}
|
|
28
|
+
};
|
|
30
29
|
}
|
|
30
|
+
export {
|
|
31
|
+
startDevtoolsLauncher
|
|
32
|
+
};
|
package/dist/index.js
CHANGED
|
@@ -1,67 +1,67 @@
|
|
|
1
1
|
import { definePlugin } from "@farm.js/core/plugin";
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
throw new TypeError(`[farm:devtools] ${name} must be a boolean`);
|
|
7
|
-
}
|
|
8
|
-
}
|
|
9
|
-
if (options.shortcut !== undefined &&
|
|
10
|
-
options.shortcut !== false &&
|
|
11
|
-
(typeof options.shortcut !== "string" ||
|
|
12
|
-
!options.shortcut.trim() ||
|
|
13
|
-
!/^[a-z0-9+.,/ -]+$/i.test(options.shortcut))) {
|
|
14
|
-
throw new TypeError("[farm:devtools] shortcut must be a keyboard shortcut such as mod+shift+d, or false");
|
|
2
|
+
function devtools(options = {}) {
|
|
3
|
+
for (const name of ["launcher", "inspect"]) {
|
|
4
|
+
if (options[name] !== void 0 && typeof options[name] !== "boolean") {
|
|
5
|
+
throw new TypeError(`[farm:devtools] ${name} must be a boolean`);
|
|
15
6
|
}
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
7
|
+
}
|
|
8
|
+
if (options.shortcut !== void 0 && options.shortcut !== false && (typeof options.shortcut !== "string" || !options.shortcut.trim() || !/^[a-z0-9+.,/ -]+$/i.test(options.shortcut))) {
|
|
9
|
+
throw new TypeError(
|
|
10
|
+
"[farm:devtools] shortcut must be a keyboard shortcut such as mod+shift+d, or false"
|
|
11
|
+
);
|
|
12
|
+
}
|
|
13
|
+
const inspect = options.inspect ?? true;
|
|
14
|
+
const launcher = options.launcher ?? true;
|
|
15
|
+
return definePlugin({
|
|
16
|
+
name: "farm:devtools",
|
|
17
|
+
enforce: "pre",
|
|
18
|
+
configure(config, context) {
|
|
19
|
+
if (context.isProd) {
|
|
20
|
+
return {
|
|
21
|
+
...config,
|
|
22
|
+
plugins: config.plugins?.filter((candidate) => candidate.name !== "farm:devtools")
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
if ((config.plugins ?? []).filter((candidate) => candidate.name === "farm:devtools").length > 1) {
|
|
26
|
+
throw new Error("[farm:devtools] Configure one devtools() plugin instance");
|
|
27
|
+
}
|
|
28
|
+
if (config.devtools === false || typeof config.devtools === "object" && config.devtools.enabled === false) {
|
|
29
|
+
throw new Error(
|
|
30
|
+
"[farm:devtools] Remove devtools: false (or enabled: false) when using the devtools() plugin"
|
|
31
|
+
);
|
|
32
|
+
}
|
|
33
|
+
const vitePlugin = {
|
|
34
|
+
name: "farm:devtools-ui",
|
|
20
35
|
enforce: "pre",
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
throw new Error("[farm:devtools] Remove devtools: false (or enabled: false) when using the devtools() plugin");
|
|
34
|
-
}
|
|
35
|
-
const vitePlugin = {
|
|
36
|
-
name: "farm:devtools-ui",
|
|
37
|
-
enforce: "pre",
|
|
38
|
-
apply: "serve",
|
|
39
|
-
async configureServer(server) {
|
|
40
|
-
const { installDevtoolsServer } = await import("./server.js");
|
|
41
|
-
installDevtoolsServer(server, { inspect });
|
|
42
|
-
},
|
|
43
|
-
};
|
|
44
|
-
return {
|
|
45
|
-
...config,
|
|
46
|
-
devtools: {
|
|
47
|
-
...(typeof config.devtools === "object" ? config.devtools : {}),
|
|
48
|
-
enabled: true,
|
|
49
|
-
...(options.shortcut === undefined ? {} : { shortcut: options.shortcut }),
|
|
50
|
-
},
|
|
51
|
-
vite: { ...config.vite, plugins: [vitePlugin, ...(config.vite?.plugins ?? [])] },
|
|
52
|
-
};
|
|
53
|
-
},
|
|
54
|
-
client: {
|
|
55
|
-
public: { launcher },
|
|
56
|
-
async setup({ isDev, public: config }) {
|
|
57
|
-
if (!isDev || !config.launcher)
|
|
58
|
-
return;
|
|
59
|
-
const { startDevtoolsLauncher } = await import("@farm.js/devtools/client");
|
|
60
|
-
return startDevtoolsLauncher();
|
|
61
|
-
},
|
|
62
|
-
close({ state }) {
|
|
63
|
-
state?.dispose();
|
|
64
|
-
},
|
|
36
|
+
apply: "serve",
|
|
37
|
+
async configureServer(server) {
|
|
38
|
+
const { installDevtoolsServer } = await import("./server.js");
|
|
39
|
+
installDevtoolsServer(server, { inspect });
|
|
40
|
+
}
|
|
41
|
+
};
|
|
42
|
+
return {
|
|
43
|
+
...config,
|
|
44
|
+
devtools: {
|
|
45
|
+
...typeof config.devtools === "object" ? config.devtools : {},
|
|
46
|
+
enabled: true,
|
|
47
|
+
...options.shortcut === void 0 ? {} : { shortcut: options.shortcut }
|
|
65
48
|
},
|
|
66
|
-
|
|
49
|
+
vite: { ...config.vite, plugins: [vitePlugin, ...config.vite?.plugins ?? []] }
|
|
50
|
+
};
|
|
51
|
+
},
|
|
52
|
+
client: {
|
|
53
|
+
public: { launcher },
|
|
54
|
+
async setup({ isDev, public: config }) {
|
|
55
|
+
if (!isDev || !config.launcher) return;
|
|
56
|
+
const { startDevtoolsLauncher } = await import("@farm.js/devtools/client");
|
|
57
|
+
return startDevtoolsLauncher();
|
|
58
|
+
},
|
|
59
|
+
close({ state }) {
|
|
60
|
+
state?.dispose();
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
});
|
|
67
64
|
}
|
|
65
|
+
export {
|
|
66
|
+
devtools
|
|
67
|
+
};
|
package/dist/modules.js
CHANGED
|
@@ -4,113 +4,95 @@ import { open, realpath } from "node:fs/promises";
|
|
|
4
4
|
const SOURCE_LIMIT = 1024 * 1024;
|
|
5
5
|
const MODULE_LIMIT = 500;
|
|
6
6
|
const SOURCE_EXTENSION = /\.(?:[cm]?[jt]sx?|css|vue|svelte)$/i;
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
7
|
+
class ModuleInspectionError extends Error {
|
|
8
|
+
constructor(message, status) {
|
|
9
|
+
super(message);
|
|
10
|
+
this.status = status;
|
|
11
|
+
}
|
|
12
|
+
status;
|
|
13
13
|
}
|
|
14
14
|
function contained(root, file) {
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
!relative.startsWith(`..${path.sep}`) &&
|
|
18
|
-
relative !== ".." &&
|
|
19
|
-
!path.isAbsolute(relative));
|
|
15
|
+
const relative = path.relative(root, file);
|
|
16
|
+
return relative !== "" && !relative.startsWith(`..${path.sep}`) && relative !== ".." && !path.isAbsolute(relative);
|
|
20
17
|
}
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
18
|
+
function createModuleInspector(server) {
|
|
19
|
+
const root = path.resolve(server.config.root);
|
|
20
|
+
const rootReal = realpath(root);
|
|
21
|
+
function entries() {
|
|
22
|
+
return [...server.moduleGraph.idToModuleMap.values()].filter(
|
|
23
|
+
(module) => module.id && module.file && module.transformResult && contained(root, module.file) && SOURCE_EXTENSION.test(module.file) && !path.relative(root, module.file).split(path.sep).some((part) => part.startsWith(".") || part === "node_modules")
|
|
24
|
+
).sort((a, b) => a.id.localeCompare(b.id));
|
|
25
|
+
}
|
|
26
|
+
function summary(module) {
|
|
27
|
+
return {
|
|
28
|
+
id: createHash("sha256").update(module.id).digest("hex"),
|
|
29
|
+
path: path.relative(root, module.file).split(path.sep).join("/"),
|
|
30
|
+
url: module.url
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
async function safe(module) {
|
|
34
|
+
try {
|
|
35
|
+
const canonical = await realpath(module.file);
|
|
36
|
+
const realRoot = await rootReal;
|
|
37
|
+
return contained(realRoot, canonical) && SOURCE_EXTENSION.test(canonical) && !path.relative(realRoot, canonical).split(path.sep).some((part) => part.startsWith(".") || part === "node_modules") ? canonical : void 0;
|
|
38
|
+
} catch {
|
|
39
|
+
return void 0;
|
|
37
40
|
}
|
|
38
|
-
|
|
41
|
+
}
|
|
42
|
+
return {
|
|
43
|
+
async list() {
|
|
44
|
+
const candidates = entries();
|
|
45
|
+
const modules = [];
|
|
46
|
+
for (const module of candidates) {
|
|
47
|
+
if (await safe(module)) modules.push(summary(module));
|
|
48
|
+
if (modules.length === MODULE_LIMIT) break;
|
|
49
|
+
}
|
|
50
|
+
return {
|
|
51
|
+
modules,
|
|
52
|
+
limited: candidates.length > modules.length && modules.length === MODULE_LIMIT
|
|
53
|
+
};
|
|
54
|
+
},
|
|
55
|
+
async read(id) {
|
|
56
|
+
if (!/^[a-f0-9]{64}$/.test(id))
|
|
57
|
+
throw new ModuleInspectionError("Unknown browser module", 404);
|
|
58
|
+
const module = entries().find((entry) => summary(entry).id === id);
|
|
59
|
+
const canonical = module && await safe(module);
|
|
60
|
+
const transformed = module?.transformResult?.code;
|
|
61
|
+
if (!module || !canonical || transformed === void 0)
|
|
62
|
+
throw new ModuleInspectionError(
|
|
63
|
+
"Module is no longer available. Reload the app and refresh Inspect.",
|
|
64
|
+
404
|
|
65
|
+
);
|
|
66
|
+
if (Buffer.byteLength(transformed) > SOURCE_LIMIT)
|
|
67
|
+
throw new ModuleInspectionError("Module exceeds the 1 MiB inspection limit", 413);
|
|
68
|
+
const file = await open(canonical, "r");
|
|
69
|
+
try {
|
|
70
|
+
const stat = await file.stat();
|
|
71
|
+
if (!stat.isFile() || stat.size > SOURCE_LIMIT)
|
|
72
|
+
throw new ModuleInspectionError("Source exceeds the 1 MiB inspection limit", 413);
|
|
73
|
+
const buffer = Buffer.alloc(SOURCE_LIMIT + 1);
|
|
74
|
+
let bytesRead = 0;
|
|
75
|
+
while (bytesRead < buffer.length) {
|
|
76
|
+
const chunk = await file.read(buffer, bytesRead, buffer.length - bytesRead, bytesRead);
|
|
77
|
+
if (!chunk.bytesRead) break;
|
|
78
|
+
bytesRead += chunk.bytesRead;
|
|
79
|
+
}
|
|
80
|
+
if (bytesRead > SOURCE_LIMIT)
|
|
81
|
+
throw new ModuleInspectionError("Source exceeds the 1 MiB inspection limit", 413);
|
|
39
82
|
return {
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
83
|
+
...summary(module),
|
|
84
|
+
source: buffer.subarray(0, bytesRead).toString("utf8"),
|
|
85
|
+
transformed,
|
|
86
|
+
imports: [...module.importedModules].map((entry) => entry.url).sort(),
|
|
87
|
+
importers: [...module.importers].map((entry) => entry.url).sort()
|
|
43
88
|
};
|
|
89
|
+
} finally {
|
|
90
|
+
await file.close();
|
|
91
|
+
}
|
|
44
92
|
}
|
|
45
|
-
|
|
46
|
-
try {
|
|
47
|
-
const canonical = await realpath(module.file);
|
|
48
|
-
const realRoot = await rootReal;
|
|
49
|
-
return contained(realRoot, canonical) &&
|
|
50
|
-
SOURCE_EXTENSION.test(canonical) &&
|
|
51
|
-
!path
|
|
52
|
-
.relative(realRoot, canonical)
|
|
53
|
-
.split(path.sep)
|
|
54
|
-
.some((part) => part.startsWith(".") || part === "node_modules")
|
|
55
|
-
? canonical
|
|
56
|
-
: undefined;
|
|
57
|
-
}
|
|
58
|
-
catch {
|
|
59
|
-
return undefined;
|
|
60
|
-
}
|
|
61
|
-
}
|
|
62
|
-
return {
|
|
63
|
-
async list() {
|
|
64
|
-
const candidates = entries();
|
|
65
|
-
const modules = [];
|
|
66
|
-
for (const module of candidates) {
|
|
67
|
-
if (await safe(module))
|
|
68
|
-
modules.push(summary(module));
|
|
69
|
-
if (modules.length === MODULE_LIMIT)
|
|
70
|
-
break;
|
|
71
|
-
}
|
|
72
|
-
return {
|
|
73
|
-
modules,
|
|
74
|
-
limited: candidates.length > modules.length && modules.length === MODULE_LIMIT,
|
|
75
|
-
};
|
|
76
|
-
},
|
|
77
|
-
async read(id) {
|
|
78
|
-
if (!/^[a-f0-9]{64}$/.test(id))
|
|
79
|
-
throw new ModuleInspectionError("Unknown browser module", 404);
|
|
80
|
-
const module = entries().find((entry) => summary(entry).id === id);
|
|
81
|
-
const canonical = module && (await safe(module));
|
|
82
|
-
// Vite can invalidate the transform while the filesystem check is pending.
|
|
83
|
-
const transformed = module?.transformResult?.code;
|
|
84
|
-
if (!module || !canonical || transformed === undefined)
|
|
85
|
-
throw new ModuleInspectionError("Module is no longer available. Reload the app and refresh Inspect.", 404);
|
|
86
|
-
if (Buffer.byteLength(transformed) > SOURCE_LIMIT)
|
|
87
|
-
throw new ModuleInspectionError("Module exceeds the 1 MiB inspection limit", 413);
|
|
88
|
-
const file = await open(canonical, "r");
|
|
89
|
-
try {
|
|
90
|
-
const stat = await file.stat();
|
|
91
|
-
if (!stat.isFile() || stat.size > SOURCE_LIMIT)
|
|
92
|
-
throw new ModuleInspectionError("Source exceeds the 1 MiB inspection limit", 413);
|
|
93
|
-
const buffer = Buffer.alloc(SOURCE_LIMIT + 1);
|
|
94
|
-
let bytesRead = 0;
|
|
95
|
-
while (bytesRead < buffer.length) {
|
|
96
|
-
const chunk = await file.read(buffer, bytesRead, buffer.length - bytesRead, bytesRead);
|
|
97
|
-
if (!chunk.bytesRead)
|
|
98
|
-
break;
|
|
99
|
-
bytesRead += chunk.bytesRead;
|
|
100
|
-
}
|
|
101
|
-
if (bytesRead > SOURCE_LIMIT)
|
|
102
|
-
throw new ModuleInspectionError("Source exceeds the 1 MiB inspection limit", 413);
|
|
103
|
-
return {
|
|
104
|
-
...summary(module),
|
|
105
|
-
source: buffer.subarray(0, bytesRead).toString("utf8"),
|
|
106
|
-
transformed,
|
|
107
|
-
imports: [...module.importedModules].map((entry) => entry.url).sort(),
|
|
108
|
-
importers: [...module.importers].map((entry) => entry.url).sort(),
|
|
109
|
-
};
|
|
110
|
-
}
|
|
111
|
-
finally {
|
|
112
|
-
await file.close();
|
|
113
|
-
}
|
|
114
|
-
},
|
|
115
|
-
};
|
|
93
|
+
};
|
|
116
94
|
}
|
|
95
|
+
export {
|
|
96
|
+
ModuleInspectionError,
|
|
97
|
+
createModuleInspector
|
|
98
|
+
};
|
package/dist/server.js
CHANGED
|
@@ -2,125 +2,111 @@ import { readFile } from "node:fs/promises";
|
|
|
2
2
|
import { isIP } from "node:net";
|
|
3
3
|
import { createModuleInspector, ModuleInspectionError } from "./modules.js";
|
|
4
4
|
import { DEVTOOLS_PATH } from "./types.js";
|
|
5
|
-
|
|
6
|
-
|
|
5
|
+
function isTrustedRequest(req, server) {
|
|
6
|
+
try {
|
|
7
|
+
const authority = req.headers.host ?? "";
|
|
8
|
+
if (!authority || /[\s/@\\?#]/.test(authority)) return false;
|
|
9
|
+
const protocol = req.socket?.encrypted ? "https:" : "http:";
|
|
10
|
+
const host = new URL(`${protocol}//${authority}`);
|
|
11
|
+
const hostname = host.hostname.replace(/^\[|\]$/g, "");
|
|
12
|
+
const allowed = server.config.server.allowedHosts;
|
|
13
|
+
const explicitHost = server.config.server.host;
|
|
14
|
+
const trusted = hostname === "localhost" || hostname.endsWith(".localhost") || isIP(hostname) !== 0 || typeof explicitHost === "string" && hostname === explicitHost || Array.isArray(allowed) && allowed.some(
|
|
15
|
+
(value) => value.startsWith(".") ? hostname === value.slice(1) || hostname.endsWith(value) : hostname === value
|
|
16
|
+
);
|
|
17
|
+
if (!trusted || req.headers["sec-fetch-site"] === "cross-site") return false;
|
|
18
|
+
if (req.headers.origin && new URL(req.headers.origin).origin !== host.origin) return false;
|
|
19
|
+
return true;
|
|
20
|
+
} catch {
|
|
21
|
+
return false;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
function installDevtoolsServer(server, options) {
|
|
25
|
+
const inspector = createModuleInspector(server);
|
|
26
|
+
const assetRoot = new URL("./ui/", import.meta.url);
|
|
27
|
+
const assets = /* @__PURE__ */ new Map();
|
|
28
|
+
let closed = false;
|
|
29
|
+
server.httpServer?.once("close", () => {
|
|
30
|
+
closed = true;
|
|
31
|
+
assets.clear();
|
|
32
|
+
});
|
|
33
|
+
server.middlewares.use(async (req, res, next) => {
|
|
34
|
+
let url;
|
|
7
35
|
try {
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
const protocol = req.socket?.encrypted
|
|
12
|
-
? "https:"
|
|
13
|
-
: "http:";
|
|
14
|
-
const host = new URL(`${protocol}//${authority}`);
|
|
15
|
-
const hostname = host.hostname.replace(/^\[|\]$/g, "");
|
|
16
|
-
const allowed = server.config.server.allowedHosts;
|
|
17
|
-
const explicitHost = server.config.server.host;
|
|
18
|
-
const trusted = hostname === "localhost" ||
|
|
19
|
-
hostname.endsWith(".localhost") ||
|
|
20
|
-
isIP(hostname) !== 0 ||
|
|
21
|
-
(typeof explicitHost === "string" && hostname === explicitHost) ||
|
|
22
|
-
(Array.isArray(allowed) &&
|
|
23
|
-
allowed.some((value) => value.startsWith(".")
|
|
24
|
-
? hostname === value.slice(1) || hostname.endsWith(value)
|
|
25
|
-
: hostname === value));
|
|
26
|
-
if (!trusted || req.headers["sec-fetch-site"] === "cross-site")
|
|
27
|
-
return false;
|
|
28
|
-
if (req.headers.origin && new URL(req.headers.origin).origin !== host.origin)
|
|
29
|
-
return false;
|
|
30
|
-
return true;
|
|
36
|
+
url = new URL(req.url || "/", "http://localhost");
|
|
37
|
+
} catch {
|
|
38
|
+
return next();
|
|
31
39
|
}
|
|
32
|
-
|
|
33
|
-
|
|
40
|
+
if (url.pathname !== DEVTOOLS_PATH && url.pathname !== `${DEVTOOLS_PATH}.json` && !url.pathname.startsWith(`${DEVTOOLS_PATH}/`))
|
|
41
|
+
return next();
|
|
42
|
+
if (closed) return next();
|
|
43
|
+
res.setHeader("Cache-Control", "no-store");
|
|
44
|
+
res.setHeader("X-Content-Type-Options", "nosniff");
|
|
45
|
+
res.setHeader("X-Frame-Options", "SAMEORIGIN");
|
|
46
|
+
res.setHeader("Referrer-Policy", "no-referrer");
|
|
47
|
+
if (!isTrustedRequest(req, server)) {
|
|
48
|
+
res.statusCode = 403;
|
|
49
|
+
res.end("DevTools requires a trusted, same-origin development request.");
|
|
50
|
+
return;
|
|
34
51
|
}
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
};
|
|
78
|
-
try {
|
|
79
|
-
if (url.pathname === `${DEVTOOLS_PATH}.json`)
|
|
80
|
-
return next();
|
|
81
|
-
if (url.pathname === DEVTOOLS_PATH) {
|
|
82
|
-
if (url.searchParams.get("embedded") !== "1")
|
|
83
|
-
return next();
|
|
84
|
-
res.setHeader("Content-Security-Policy", "default-src 'none'; script-src 'self'; style-src 'self' 'unsafe-inline'; font-src 'self'; img-src 'self'; connect-src 'self'; frame-ancestors 'self'; base-uri 'none'; form-action 'none'");
|
|
85
|
-
send(`<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="dark light"><title>Farm.js DevTools</title><link rel="stylesheet" href="${DEVTOOLS_PATH}/assets/panel.css"></head><body><div id="farm-devtools" data-inspect="${options.inspect}"></div><script type="module" src="${DEVTOOLS_PATH}/assets/panel.js"></script></body></html>`, "text/html; charset=utf-8");
|
|
86
|
-
return;
|
|
87
|
-
}
|
|
88
|
-
if (url.pathname === `${DEVTOOLS_PATH}/modules.json` && options.inspect) {
|
|
89
|
-
send(JSON.stringify(await inspector.list()), "application/json; charset=utf-8");
|
|
90
|
-
return;
|
|
91
|
-
}
|
|
92
|
-
if (url.pathname === `${DEVTOOLS_PATH}/module.json` && options.inspect) {
|
|
93
|
-
send(JSON.stringify(await inspector.read(url.searchParams.get("id") ?? "")), "application/json; charset=utf-8");
|
|
94
|
-
return;
|
|
95
|
-
}
|
|
96
|
-
if (url.pathname.startsWith(`${DEVTOOLS_PATH}/assets/`)) {
|
|
97
|
-
const name = url.pathname.slice(`${DEVTOOLS_PATH}/assets/`.length);
|
|
98
|
-
const type = name === "panel.js"
|
|
99
|
-
? "text/javascript; charset=utf-8"
|
|
100
|
-
: name === "panel.css"
|
|
101
|
-
? "text/css; charset=utf-8"
|
|
102
|
-
: name === "logo.svg"
|
|
103
|
-
? "image/svg+xml"
|
|
104
|
-
: /^[a-zA-Z0-9_-]+\.woff2$/.test(name)
|
|
105
|
-
? "font/woff2"
|
|
106
|
-
: undefined;
|
|
107
|
-
if (type) {
|
|
108
|
-
if (!assets.has(name))
|
|
109
|
-
assets.set(name, readFile(new URL(name, assetRoot)));
|
|
110
|
-
send(await assets.get(name), type);
|
|
111
|
-
return;
|
|
112
|
-
}
|
|
113
|
-
}
|
|
114
|
-
res.statusCode = 404;
|
|
115
|
-
send("Not found", "text/plain; charset=utf-8");
|
|
116
|
-
}
|
|
117
|
-
catch (error) {
|
|
118
|
-
res.statusCode = error instanceof ModuleInspectionError ? error.status : 500;
|
|
119
|
-
send(JSON.stringify({
|
|
120
|
-
error: error instanceof ModuleInspectionError
|
|
121
|
-
? error.message
|
|
122
|
-
: "DevTools could not read this resource. Refresh the app and try again.",
|
|
123
|
-
}), "application/json; charset=utf-8");
|
|
52
|
+
if (req.method !== "GET" && req.method !== "HEAD") {
|
|
53
|
+
res.statusCode = 405;
|
|
54
|
+
res.setHeader("Allow", "GET, HEAD");
|
|
55
|
+
res.end();
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
const send = (body, type) => {
|
|
59
|
+
res.setHeader("Content-Type", type);
|
|
60
|
+
res.end(req.method === "HEAD" ? void 0 : body);
|
|
61
|
+
};
|
|
62
|
+
try {
|
|
63
|
+
if (url.pathname === `${DEVTOOLS_PATH}.json`) return next();
|
|
64
|
+
if (url.pathname === DEVTOOLS_PATH) {
|
|
65
|
+
if (url.searchParams.get("embedded") !== "1") return next();
|
|
66
|
+
res.setHeader(
|
|
67
|
+
"Content-Security-Policy",
|
|
68
|
+
"default-src 'none'; script-src 'self'; style-src 'self' 'unsafe-inline'; font-src 'self'; img-src 'self'; connect-src 'self'; frame-ancestors 'self'; base-uri 'none'; form-action 'none'"
|
|
69
|
+
);
|
|
70
|
+
send(
|
|
71
|
+
`<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="dark light"><title>Farm.js DevTools</title><link rel="stylesheet" href="${DEVTOOLS_PATH}/assets/panel.css"></head><body><div id="farm-devtools" data-inspect="${options.inspect}"></div><script type="module" src="${DEVTOOLS_PATH}/assets/panel.js"></script></body></html>`,
|
|
72
|
+
"text/html; charset=utf-8"
|
|
73
|
+
);
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
if (url.pathname === `${DEVTOOLS_PATH}/modules.json` && options.inspect) {
|
|
77
|
+
send(JSON.stringify(await inspector.list()), "application/json; charset=utf-8");
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
if (url.pathname === `${DEVTOOLS_PATH}/module.json` && options.inspect) {
|
|
81
|
+
send(
|
|
82
|
+
JSON.stringify(await inspector.read(url.searchParams.get("id") ?? "")),
|
|
83
|
+
"application/json; charset=utf-8"
|
|
84
|
+
);
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
if (url.pathname.startsWith(`${DEVTOOLS_PATH}/assets/`)) {
|
|
88
|
+
const name = url.pathname.slice(`${DEVTOOLS_PATH}/assets/`.length);
|
|
89
|
+
const type = name === "panel.js" ? "text/javascript; charset=utf-8" : name === "panel.css" ? "text/css; charset=utf-8" : name === "logo.svg" ? "image/svg+xml" : /^[a-zA-Z0-9_-]+\.woff2$/.test(name) ? "font/woff2" : void 0;
|
|
90
|
+
if (type) {
|
|
91
|
+
if (!assets.has(name)) assets.set(name, readFile(new URL(name, assetRoot)));
|
|
92
|
+
send(await assets.get(name), type);
|
|
93
|
+
return;
|
|
124
94
|
}
|
|
125
|
-
|
|
95
|
+
}
|
|
96
|
+
res.statusCode = 404;
|
|
97
|
+
send("Not found", "text/plain; charset=utf-8");
|
|
98
|
+
} catch (error) {
|
|
99
|
+
res.statusCode = error instanceof ModuleInspectionError ? error.status : 500;
|
|
100
|
+
send(
|
|
101
|
+
JSON.stringify({
|
|
102
|
+
error: error instanceof ModuleInspectionError ? error.message : "DevTools could not read this resource. Refresh the app and try again."
|
|
103
|
+
}),
|
|
104
|
+
"application/json; charset=utf-8"
|
|
105
|
+
);
|
|
106
|
+
}
|
|
107
|
+
});
|
|
126
108
|
}
|
|
109
|
+
export {
|
|
110
|
+
installDevtoolsServer,
|
|
111
|
+
isTrustedRequest
|
|
112
|
+
};
|
package/dist/types.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@farm.js/devtools",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1-beta.1",
|
|
4
4
|
"description": "Development workspace inspector for Farm.js routes, runtime, and browser modules",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"devtools",
|
|
@@ -52,7 +52,7 @@
|
|
|
52
52
|
"typescript": "^5.3.3",
|
|
53
53
|
"vite": "^5.0.10",
|
|
54
54
|
"vitest": "^3.2.7",
|
|
55
|
-
"@farm.js/core": "0.1.
|
|
55
|
+
"@farm.js/core": "0.1.1-beta.1"
|
|
56
56
|
},
|
|
57
57
|
"peerDependencies": {
|
|
58
58
|
"@farm.js/core": ">=0.1.0-beta.96 <0.2.0"
|