feat(core): devtools config (#173)

Author: webfansplz

packages/core/src/index.ts

@@ -1,3 +1,4 @@
+export * from './node/config'
 export { createDevToolsContext } from './node/context'
 export { DevTools } from './node/plugins'
 export { createDevToolsMiddleware } from './node/server'

packages/core/src/node/config.ts

@@ -0,0 +1,35 @@
+import type { StartOptions } from './cli-commands'
+import { isObject } from './utils'
+
+export interface DevToolsConfig extends Partial<StartOptions> {
+  enabled: boolean
+  /**
+   * Disable client authentication.
+   *
+   * Beware that if you disable client authentication,
+   * any browsers can connect to the devtools and access to your server and filesystem.
+   * (including other devices, if you open server `host` option to LAN or WAN)
+   *
+   * @default true
+   */
+  clientAuth?: boolean
+}
+
+export interface ResolvedDevToolsConfig {
+  config: Omit<DevToolsConfig, 'enabled'> & { host: string }
+  enabled: boolean
+}
+
+export function normalizeDevToolsConfig(
+  config: DevToolsConfig | boolean | undefined,
+  host: string,
+): ResolvedDevToolsConfig {
+  return {
+    enabled: config === true || !!(config && config.enabled),
+    config: {
+      ...(isObject(config) ? config : {}),
+      clientAuth: isObject(config) ? (config.clientAuth ?? true) : true,
+      host: isObject(config) ? (config.host ?? host) : host,
+    },
+  }
+}

packages/core/src/node/utils.ts

@@ -0,0 +1,3 @@
+export function isObject(value: unknown): value is Record<string, any> {
+  return Object.prototype.toString.call(value) === '[object Object]'
+}

test/exports/@vitejs/devtools.yaml

@@ -2,6 +2,7 @@
   createDevToolsContext: function
   createDevToolsMiddleware: function
   DevTools: function
+  normalizeDevToolsConfig: function
 ./cli-commands:
   build: function
   start: function