@wolfstar/http-framework 4.0.2 → 5.0.0-next-20260919094537

package/dist/esm/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["isFile"],"sources":["../../src/lib/config/errors.ts","../../src/lib/config/load.ts","../../src/lib/config/resolve.ts","../../src/lib/config/index.ts","../../src/config.ts"],"sourcesContent":["export interface ConfigErrorOptions {\n\t/** A stable, machine readable code, e.g. `INVALID_TYPE`. */\n\tcode: string;\n\t/** A short, actionable suggestion. */\n\thint?: string;\n\t/** The dotted path of the offending option, e.g. `dev.debounce`. */\n\tpath?: string;\n\t/** The configuration file the error originates from. */\n\tfile?: string | null;\n\tcause?: unknown;\n}\n\n/**\n * A `stars.config.*` error: an invalid option, or a file that failed to load or parse.\n *\n * This is a plain data error (no exit code or terminal formatting) so it stays meaningful outside a CLI, e.g. for a\n * dashboard or test that calls {@link loadStarsConfig} directly. `@wolfstar/cli` maps it to exit code `2` and renders\n * `message`, `path`, `file` and `hint` for the terminal.\n */\nexport class ConfigError extends Error {\n\tpublic readonly code: string;\n\tpublic readonly hint: string | null;\n\tpublic readonly path: string | null;\n\tpublic readonly file: string | null;\n\n\tpublic constructor(message: string, options: ConfigErrorOptions) {\n\t\tsuper(message, options.cause === undefined ? undefined : { cause: options.cause });\n\t\tthis.name = 'ConfigError';\n\t\tthis.code = options.code;\n\t\tthis.hint = options.hint ?? null;\n\t\tthis.path = options.path ?? null;\n\t\tthis.file = options.file ?? null;\n\t}\n}\n","import { existsSync, statSync } from 'node:fs';\nimport { basename, dirname, join, resolve } from 'node:path';\nimport type { StarsConfig } from '../../config.js';\nimport { ConfigError } from './errors.js';\n\nexport const CONFIG_EXTENSIONS = ['ts', 'mts', 'cts', 'js', 'mjs', 'cjs'] as const;\nexport const CONFIG_FILE_NAMES = CONFIG_EXTENSIONS.map((extension) => `stars.config.${extension}`);\n\nexport interface LoadConfigFileOptions {\n\t/** The directory to discover the configuration file from. */\n\tcwd: string;\n\t/** An explicit configuration file (`--config`), resolved from `cwd`. */\n\tconfigFile?: string | null;\n}\n\nexport interface LoadedConfigFile {\n\t/** The absolute path of the loaded file, `null` when running on defaults. */\n\tconfigFile: string | null;\n\tconfig: StarsConfig;\n}\n\n/**\n * Finds the first `stars.config.*` file in `cwd`, in {@link CONFIG_FILE_NAMES} order.\n */\nexport function discoverConfigFile(cwd: string): string | null {\n\tfor (const name of CONFIG_FILE_NAMES) {\n\t\tconst candidate = join(cwd, name);\n\t\tif (isFile(candidate)) return candidate;\n\t}\n\n\treturn null;\n}\n\n/**\n * Loads the raw configuration object. The loader (`c12`) is imported lazily so\n * commands that never touch the configuration stay fast.\n */\nexport async function loadConfigFile(options: LoadConfigFileOptions): Promise<LoadedConfigFile> {\n\tconst cwd = resolve(options.cwd);\n\tlet file: string | null;\n\n\tif (options.configFile) {\n\t\tfile = resolve(cwd, options.configFile);\n\t\tif (!isFile(file)) {\n\t\t\tthrow new ConfigError(`Configuration file not found: ${file}`, {\n\t\t\t\tcode: 'CONFIG_NOT_FOUND',\n\t\t\t\thint: `Pass an existing file to --config, or create one of ${CONFIG_FILE_NAMES.join(', ')} in ${cwd}.`\n\t\t\t});\n\t\t}\n\t} else {\n\t\tfile = discoverConfigFile(cwd);\n\t\tif (!file) return { configFile: null, config: {} };\n\t}\n\n\tconst { loadConfig } = await import('c12');\n\n\tlet loaded: unknown;\n\ttry {\n\t\tconst result = await loadConfig<StarsConfig>({\n\t\t\tname: 'stars',\n\t\t\tcwd: dirname(file),\n\t\t\tconfigFile: basename(file),\n\t\t\trcFile: false,\n\t\t\tglobalRc: false,\n\t\t\tdotenv: false,\n\t\t\tpackageJson: false,\n\t\t\tdefaults: {}\n\t\t});\n\t\t// c12 merges every layer with the defaults, which turns non-object exports into `{}`: inspect the raw layer.\n\t\tconst layer = result.layers?.find(\n\t\t\t(candidate) => candidate.configFile && resolve(candidate.cwd ?? dirname(file), candidate.configFile) === file\n\t\t);\n\t\tloaded = layer ? layer.config : result.config;\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new ConfigError(`Failed to load the configuration: ${message}`, {\n\t\t\tcode: 'CONFIG_LOAD_FAILED',\n\t\t\tfile,\n\t\t\thint: 'The file must be valid TypeScript/JavaScript and export the configuration as its default export.',\n\t\t\tcause: error\n\t\t});\n\t}\n\n\tif (loaded === null || typeof loaded !== 'object' || Array.isArray(loaded)) {\n\t\tthrow new ConfigError('The configuration file must export an object as its default export.', {\n\t\t\tcode: 'CONFIG_NOT_OBJECT',\n\t\t\tfile,\n\t\t\thint: \"Use `export default defineConfig({ ... })` from '@wolfstar/http-framework/config'.\"\n\t\t});\n\t}\n\n\treturn { configFile: file, config: loaded as StarsConfig };\n}\n\nfunction isFile(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n","import { existsSync, readFileSync, statSync } from 'node:fs';\nimport { basename, dirname, extname, isAbsolute, join, relative, resolve } from 'node:path';\nimport type {\n\tStarsBuildTool,\n\tStarsCompatibilityVersion,\n\tStarsConfig,\n\tStarsDevConfig,\n\tStarsExperimentalConfig,\n\tStarsFutureConfig,\n\tStarsTypechecker\n} from '../../config.js';\nimport { ConfigError } from './errors.js';\n\nexport interface PackageJsonLike {\n\tname?: string;\n\t/** `tsdown` reads its options from here as well as from a `tsdown.config.*`. */\n\ttsdown?: unknown;\n\tversion?: string;\n\tmain?: string;\n\ttype?: string;\n\tscripts?: Record<string, string>;\n\tdependencies?: Record<string, string>;\n\tdevDependencies?: Record<string, string>;\n}\n\nexport interface ResolvedBuildConfig {\n\treadonly tool: StarsBuildTool;\n\t/** Absolute output directory. */\n\treadonly outDir: string;\n\t/** Absolute `tsconfig.json` used by `tsc`, `null` for the other tools. */\n\treadonly tsconfig: string | null;\n\t/** Absolute path of the file `node` runs, i.e. the built entry (or the entry itself when `tool` is `none`). */\n\treadonly output: string;\n\t/**\n\t * Absolute path of the build tool's own configuration file (`tsdown.config.*`, `vite.config.*`), `null` when the\n\t * tool has none — which is always the case for `tsdown` with `future.compatibilityVersion` 4, where the build is\n\t * configured from `stars.config` alone.\n\t */\n\treadonly configFile: string | null;\n}\n\nexport interface ResolvedTypecheckConfig {\n\treadonly enabled: boolean;\n\t/** Absolute `tsconfig.json` the type checker runs against, `null` when it could not be found. */\n\treadonly tsconfig: string | null;\n\t/** The type checker to run, with `'auto'` already resolved. */\n\treadonly checker: StarsTypechecker;\n}\n\nexport type ResolvedTunnelConfig =\n\t| { readonly mode: 'off' }\n\t/** A `cloudflared` quick tunnel, whose hostname is only known once it is up. */\n\t| { readonly mode: 'quick'; readonly path: string; readonly updateEndpoint: boolean }\n\t/** An https URL the user already serves. */\n\t| { readonly mode: 'url'; readonly url: string; readonly path: string; readonly updateEndpoint: boolean };\n\nexport interface ResolvedDevConfig {\n\treadonly banner: readonly string[] | false | null;\n\treadonly watch: readonly string[];\n\treadonly ignore: readonly string[];\n\treadonly debounce: number;\n\treadonly env: Readonly<Record<string, string>>;\n\treadonly nodeArgs: readonly string[];\n\treadonly args: readonly string[];\n\treadonly url: string | null;\n\treadonly health: string | null;\n\treadonly killTimeout: number;\n\treadonly typecheck: ResolvedTypecheckConfig;\n\treadonly tunnel: ResolvedTunnelConfig;\n\t/** Absolute path of the file the dev session's logs are mirrored into, `null` when disabled. */\n\treadonly logFile: string | null;\n}\n\nexport interface ResolvedNitroConfig {\n\treadonly preset: string;\n}\n\nexport interface ResolvedExperimentalConfig {\n\treadonly enableVite: boolean;\n\treadonly enableExternalVite: boolean;\n\treadonly enableNitro: boolean;\n\treadonly nitro: ResolvedNitroConfig;\n}\n\nexport interface ResolvedFutureConfig {\n\treadonly compatibilityVersion: StarsCompatibilityVersion;\n}\n\nexport interface ResolvedImportsConfig {\n\treadonly enabled: boolean;\n\t/** Directory glob patterns, relative to the project root (the way `unimport` scans them). */\n\treadonly dirs: readonly string[];\n\treadonly presets: readonly string[];\n\treadonly exclude: readonly string[];\n\t/** Absolute path of the generated declaration file. */\n\treadonly dts: string;\n}\n\nexport interface ResolvedI18nCodegenConfig {\n\treadonly locales: string;\n\treadonly output: string;\n}\n\nexport interface ResolvedCodegenConfig {\n\treadonly i18n: ResolvedI18nCodegenConfig | null;\n}\n\nexport interface ResolvedStarsConfig {\n\t/** Absolute path of the configuration file, `null` when running on defaults. */\n\treadonly configFile: string | null;\n\t/** The directory the CLI was invoked from. */\n\treadonly cwd: string;\n\t/** Absolute project root. */\n\treadonly root: string;\n\treadonly packageJson: PackageJsonLike | null;\n\t/** Absolute source entry. */\n\treadonly entry: string;\n\treadonly build: ResolvedBuildConfig;\n\treadonly dev: ResolvedDevConfig;\n\treadonly codegen: ResolvedCodegenConfig;\n\treadonly imports: ResolvedImportsConfig;\n\treadonly experimental: ResolvedExperimentalConfig;\n\treadonly future: ResolvedFutureConfig;\n\t/** Raw options merged into `vite.config.*`. */\n\treadonly vite: Readonly<Record<string, unknown>>;\n\t/** The `tsdown` build's options: merged over `tsdown.config.*` at compatibility version 3, the whole build at 4. */\n\treadonly tsdown: Readonly<Record<string, unknown>>;\n}\n\nexport interface ResolveConfigOptions {\n\tcwd: string;\n\tconfigFile: string | null;\n\tconfig: StarsConfig;\n\tenv?: NodeJS.ProcessEnv;\n}\n\nexport const DEFAULT_ENTRIES = ['src/main.ts', 'src/main.js', 'src/index.ts', 'src/index.js'] as const;\nexport const DEFAULT_IGNORE = ['**/node_modules/**', '**/dist/**', '**/.git/**'] as const;\nexport const DEFAULT_DEBOUNCE = 150;\nexport const DEFAULT_KILL_TIMEOUT = 5000;\nexport const DEFAULT_NODE_ARGS = ['--enable-source-maps'] as const;\nexport const DEFAULT_DEV_PORT = 3000;\nexport const DEFAULT_I18N_LOCALES = 'src/locales/en-US';\nexport const DEFAULT_I18N_OUTPUT = 'src/@types/i18next.d.ts';\nexport const DEFAULT_IMPORTS_DIRS = ['src/lib/**', 'src/utils/**'] as const;\nexport const DEFAULT_IMPORTS_PRESETS = ['@wolfstar/http-framework', '@wolfstar/env-utilities'] as const;\nexport const DEFAULT_IMPORTS_DTS = '.stars/imports.d.ts';\nexport const DEFAULT_DEV_LOG_FILE = '.stars/dev.log';\nexport const DEFAULT_TUNNEL_PATH = '/';\n\nexport const DEFAULT_COMPATIBILITY_VERSION = 4;\nexport const LEGACY_COMPATIBILITY_VERSION = 3;\nexport const LATEST_COMPATIBILITY_VERSION = 4;\n\nconst COMPATIBILITY_VERSIONS = new Set<number>([LEGACY_COMPATIBILITY_VERSION, LATEST_COMPATIBILITY_VERSION]);\nconst BUILD_TOOLS = new Set<string>(['tsdown', 'tsc', 'none', 'vite', 'auto']);\nconst TYPECHECKERS = new Set<string>(['tsc', 'golar', 'tsz', 'auto']);\nconst VITE_CONFIG_FILES = ['vite.config.ts', 'vite.config.mts', 'vite.config.cts', 'vite.config.js', 'vite.config.mjs', 'vite.config.cjs'];\nconst TSDOWN_CONFIG_FILES = [\n\t'tsdown.config.ts',\n\t'tsdown.config.mts',\n\t'tsdown.config.cts',\n\t'tsdown.config.js',\n\t'tsdown.config.mjs',\n\t'tsdown.config.cjs',\n\t'tsdown.config.json'\n];\nconst TYPESCRIPT_EXTENSIONS = new Set(['.ts', '.mts', '.cts']);\n\n/**\n * Applies defaults, validates every option and resolves all paths to absolute ones.\n *\n * @throws {ConfigError} with an actionable `hint` on the first invalid option.\n */\nexport function resolveStarsConfig(options: ResolveConfigOptions): ResolvedStarsConfig {\n\tconst cwd = resolve(options.cwd);\n\tconst env = options.env ?? process.env;\n\tconst file = options.configFile;\n\tconst config = options.config;\n\tconst validator = new Validator(file);\n\n\tvalidator.knownKeys(config, '', ['root', 'entry', 'build', 'dev', 'codegen', 'imports', 'experimental', 'future', 'vite', 'tsdown']);\n\tconst baseDirectory = file ? dirname(file) : cwd;\n\n\tconst root = resolve(baseDirectory, validator.string(config.root, 'root') ?? '.');\n\tif (!isDirectory(root)) {\n\t\tthrow validator.error(\n\t\t\t`The project root does not exist: ${root}`,\n\t\t\t'root',\n\t\t\t'ROOT_NOT_FOUND',\n\t\t\t'Point `root` to an existing directory, relative to the configuration file.'\n\t\t);\n\t}\n\n\tconst packageJson = readPackageJson(root);\n\tconst experimental = resolveExperimental(config.experimental ?? {}, validator);\n\tconst future = resolveFuture(config.future ?? {}, validator);\n\tconst entry = resolveEntry(root, validator.string(config.entry, 'entry'), validator);\n\t// The tool-specific blocks are read before the build so a project that only declares `tsdown: {}` still resolves\n\t// `build.tool: 'auto'` to `tsdown`: configuring a tool is as clear a signal as depending on it.\n\tconst vite = validator.plainObject(config.vite, 'vite') ?? {};\n\tconst tsdown = validator.plainObject(config.tsdown, 'tsdown') ?? {};\n\tconst build = resolveBuild(root, entry, packageJson, config.build ?? {}, experimental, future, Object.keys(tsdown).length > 0, validator);\n\tconst dev = resolveDev(root, entry, packageJson, config.dev ?? {}, env, validator);\n\tconst codegen = resolveCodegen(root, config.codegen ?? {}, validator);\n\tconst imports = resolveImports(root, build.tool, future, config.imports, validator);\n\n\tif (Object.keys(tsdown).length > 0 && build.tool !== 'tsdown') {\n\t\tthrow validator.error(\n\t\t\t'`tsdown` options need the `tsdown` build tool',\n\t\t\t'tsdown',\n\t\t\t'TSDOWN_OPTIONS_REQUIRE_TSDOWN',\n\t\t\t`Set \\`build.tool\\` to 'tsdown', or remove \\`tsdown\\` (the build tool is '${build.tool}').`\n\t\t);\n\t}\n\n\tif (Object.keys(vite).length > 0 && build.tool !== 'vite') {\n\t\tthrow validator.error(\n\t\t\t'`vite` options need the `vite` build tool',\n\t\t\t'vite',\n\t\t\t'VITE_OPTIONS_REQUIRE_VITE',\n\t\t\t`Set \\`build.tool\\` to 'vite' with \\`experimental.enableVite\\`, or remove \\`vite\\` (the build tool is '${build.tool}').`\n\t\t);\n\t}\n\n\treturn { configFile: file, cwd, root, packageJson, entry, build, dev, codegen, imports, experimental, future, vite, tsdown };\n}\n\n/**\n * Presents an absolute path relative to `root` when possible, for display purposes.\n */\nexport function displayPath(root: string, path: string): string {\n\tconst rel = relative(root, path);\n\tif (!rel) return '.';\n\treturn rel.startsWith('..') || isAbsolute(rel) ? path : rel;\n}\n\nfunction resolveEntry(root: string, configured: string | undefined, validator: Validator): string {\n\tif (configured !== undefined) {\n\t\tconst entry = resolve(root, configured);\n\t\tif (!isFile(entry)) {\n\t\t\tthrow validator.error(\n\t\t\t\t`The entry file does not exist: ${entry}`,\n\t\t\t\t'entry',\n\t\t\t\t'ENTRY_NOT_FOUND',\n\t\t\t\t'Point `entry` to the file that starts the bot, relative to the project root.'\n\t\t\t);\n\t\t}\n\t\treturn entry;\n\t}\n\n\tfor (const candidate of DEFAULT_ENTRIES) {\n\t\tconst entry = join(root, candidate);\n\t\tif (isFile(entry)) return entry;\n\t}\n\n\tthrow validator.error(\n\t\t`Could not find the entry file in ${root}`,\n\t\t'entry',\n\t\t'ENTRY_NOT_FOUND',\n\t\t`Set \\`entry\\` in the configuration, or create one of ${DEFAULT_ENTRIES.join(', ')}.`\n\t);\n}\n\nfunction resolveBuild(\n\troot: string,\n\tentry: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: NonNullable<StarsConfig['build']>,\n\texperimental: ResolvedExperimentalConfig,\n\tfuture: ResolvedFutureConfig,\n\thasTsdownOptions: boolean,\n\tvalidator: Validator\n): ResolvedBuildConfig {\n\tvalidator.knownKeys(config, 'build', ['tool', 'outDir', 'tsconfig']);\n\n\tconst requested = validator.string(config.tool, 'build.tool') ?? 'auto';\n\tif (!BUILD_TOOLS.has(requested)) {\n\t\tthrow validator.error(\n\t\t\t`Unknown build tool \"${requested}\"`,\n\t\t\t'build.tool',\n\t\t\t'INVALID_BUILD_TOOL',\n\t\t\t\"Use one of 'tsdown', 'tsc', 'vite', 'none' or 'auto'.\"\n\t\t);\n\t}\n\n\tif (requested === 'vite' && !experimental.enableVite) {\n\t\tthrow validator.error(\n\t\t\t\"The 'vite' build tool is experimental\",\n\t\t\t'build.tool',\n\t\t\t'EXPERIMENT_REQUIRED',\n\t\t\t'Set `experimental.enableVite` to true to use it.'\n\t\t);\n\t}\n\n\tconst isTypeScriptEntry = TYPESCRIPT_EXTENSIONS.has(extname(entry));\n\tconst tool: StarsBuildTool =\n\t\trequested === 'auto'\n\t\t\t? detectBuildTool(root, packageJson, isTypeScriptEntry, experimental, future, hasTsdownOptions)\n\t\t\t: (requested as StarsBuildTool);\n\n\tif (tool === 'none' && isTypeScriptEntry) {\n\t\tthrow validator.error(\n\t\t\t`The entry ${displayPath(root, entry)} is TypeScript but the build tool is 'none'`,\n\t\t\t'build.tool',\n\t\t\t'BUILD_TOOL_REQUIRED',\n\t\t\t\"Set `build.tool` to 'tsdown' or 'tsc', or point `entry` to a JavaScript file.\"\n\t\t);\n\t}\n\n\t// Nitro owns its own output layout; anything else keeps the plain `dist` convention.\n\tconst defaultOutDir = experimental.enableNitro ? '.output' : 'dist';\n\tconst outDir = resolve(root, validator.string(config.outDir, 'build.outDir') ?? defaultOutDir);\n\n\tlet tsconfig: string | null = null;\n\tconst configuredTsconfig = validator.string(config.tsconfig, 'build.tsconfig');\n\tif (configuredTsconfig !== undefined) {\n\t\ttsconfig = resolve(root, configuredTsconfig);\n\t\tif (!isFile(tsconfig)) {\n\t\t\tthrow validator.error(\n\t\t\t\t`The tsconfig file does not exist: ${tsconfig}`,\n\t\t\t\t'build.tsconfig',\n\t\t\t\t'TSCONFIG_NOT_FOUND',\n\t\t\t\t'Point `build.tsconfig` to an existing tsconfig.json, relative to the project root.'\n\t\t\t);\n\t\t}\n\t} else if (tool === 'tsc' || tool === 'tsdown') {\n\t\t// `tsdown` only looks for a `tsconfig.json` next to the project root, so a bot keeping its sources' one in\n\t\t// `src/` (the layout both the scaffold and the examples use) would silently build without its paths and\n\t\t// target. Resolving it here is what makes the `tsdown` build need no configuration of its own.\n\t\ttsconfig = [join(root, 'src', 'tsconfig.json'), join(root, 'tsconfig.json')].find((candidate) => isFile(candidate)) ?? null;\n\t\tif (!tsconfig && tool === 'tsc') {\n\t\t\tthrow validator.error(\n\t\t\t\t`Could not find a tsconfig.json in ${root}`,\n\t\t\t\t'build.tsconfig',\n\t\t\t\t'TSCONFIG_NOT_FOUND',\n\t\t\t\t'Create src/tsconfig.json or tsconfig.json, or set `build.tsconfig`.'\n\t\t\t);\n\t\t}\n\t}\n\n\t// Nitro always writes its server entry to `<outDir>/server/index.mjs`, regardless of the project's own entry\n\t// file name or `package.json#main` — it is Nitro's output, not a build of the project's own entry file.\n\tconst output = experimental.enableNitro\n\t\t? join(outDir, 'server', 'index.mjs')\n\t\t: tool === 'none'\n\t\t\t? entry\n\t\t\t: resolveBuildOutput(root, entry, outDir, packageJson);\n\n\tlet configFile = findConfigFile(root, tool === 'tsdown' ? TSDOWN_CONFIG_FILES : tool === 'vite' ? VITE_CONFIG_FILES : []);\n\t// `tsdown` reads `package.json#tsdown` when no configuration file is around, so it counts as one here.\n\tif (tool === 'tsdown' && configFile === null && packageJson?.tsdown !== undefined) configFile = join(root, 'package.json');\n\n\t// Compatibility version 4 builds `tsdown` from this file alone. A `tsdown.config.*` left behind would keep the\n\t// plugins and entry points it declares out of the build, so it is reported rather than quietly ignored.\n\tif (tool === 'tsdown' && configFile !== null && future.compatibilityVersion >= LATEST_COMPATIBILITY_VERSION) {\n\t\tthrow validator.error(\n\t\t\t`\\`${displayPath(root, configFile)}\\` is not used with compatibility version ${future.compatibilityVersion}`,\n\t\t\t'tsdown',\n\t\t\t'TSDOWN_CONFIG_FILE_UNSUPPORTED',\n\t\t\t`Move its options into \\`tsdown\\` here, drop the ${displayPath(root, configFile)} configuration, or set \\`future.compatibilityVersion\\` to ${LEGACY_COMPATIBILITY_VERSION}.`\n\t\t);\n\t}\n\n\treturn { tool, outDir, tsconfig, output, configFile };\n}\n\nfunction findConfigFile(root: string, names: readonly string[]): string | null {\n\tfor (const name of names) {\n\t\tconst candidate = join(root, name);\n\t\tif (isFile(candidate)) return candidate;\n\t}\n\n\treturn null;\n}\n\nfunction detectBuildTool(\n\troot: string,\n\tpackageJson: PackageJsonLike | null,\n\tisTypeScriptEntry: boolean,\n\texperimental: ResolvedExperimentalConfig,\n\tfuture: ResolvedFutureConfig,\n\thasTsdownOptions: boolean\n): StarsBuildTool {\n\t// Vite only wins the detection once the project opted into it; without the flag a `vite.config.*` is somebody\n\t// else's (a dashboard, a docs site) and must not take the bot's build over.\n\tif (experimental.enableVite) {\n\t\tconst hasVite = VITE_CONFIG_FILES.some((name) => isFile(join(root, name))) || hasDependency(packageJson, 'vite');\n\t\tif (hasVite) return 'vite';\n\t}\n\n\tif (hasTsdownOptions) return 'tsdown';\n\n\t// From compatibility version 4 on, `tsdown` is the build of a TypeScript project rather than one of the options:\n\t// there is no `tsdown.config.*` left to detect it from, and a missing dependency is reported by the builder with\n\t// an install hint instead of silently falling back to `tsc`.\n\tif (future.compatibilityVersion >= LATEST_COMPATIBILITY_VERSION) return isTypeScriptEntry ? 'tsdown' : 'none';\n\n\tconst hasTsdown = TSDOWN_CONFIG_FILES.some((name) => isFile(join(root, name))) || hasDependency(packageJson, 'tsdown');\n\tif (hasTsdown) return 'tsdown';\n\tif (isTypeScriptEntry) return 'tsc';\n\treturn 'none';\n}\n\n/**\n * Resolves the Nuxt-style compatibility block. Version 4 is the default; version 3 remains an explicit legacy mode.\n */\nfunction resolveFuture(config: StarsFutureConfig, validator: Validator): ResolvedFutureConfig {\n\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\tthrow validator.error('`future` must be an object', 'future', 'INVALID_TYPE', 'Use `{ compatibilityVersion }`.');\n\t}\n\n\tvalidator.knownKeys(config, 'future', ['compatibilityVersion']);\n\tconst version = config.compatibilityVersion;\n\tif (version === undefined) return { compatibilityVersion: DEFAULT_COMPATIBILITY_VERSION };\n\n\tif (typeof version !== 'number' || !COMPATIBILITY_VERSIONS.has(version)) {\n\t\tthrow validator.error(\n\t\t\t`Unknown compatibility version ${describe(version)}`,\n\t\t\t'future.compatibilityVersion',\n\t\t\t'INVALID_COMPATIBILITY_VERSION',\n\t\t\t`Use ${LEGACY_COMPATIBILITY_VERSION} for the legacy build pipeline or ${LATEST_COMPATIBILITY_VERSION} for today's defaults.`\n\t\t);\n\t}\n\n\treturn { compatibilityVersion: version as StarsCompatibilityVersion };\n}\n\n/**\n * Resolves the `experimental` block. Every flag is a boolean defaulting to `false`, the way Nuxt's own experimental\n * flags are declared, and the ones that build on each other are checked here rather than surfacing later as a\n * confusing runtime failure.\n */\nfunction resolveExperimental(config: StarsExperimentalConfig, validator: Validator): ResolvedExperimentalConfig {\n\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\tthrow validator.error(\n\t\t\t'`experimental` must be an object',\n\t\t\t'experimental',\n\t\t\t'INVALID_TYPE',\n\t\t\t'Use `{ enableVite, enableExternalVite, enableNitro, nitro }`.'\n\t\t);\n\t}\n\n\tvalidator.knownKeys(config, 'experimental', ['enableVite', 'enableExternalVite', 'enableNitro', 'nitro']);\n\tconst enableVite = validator.boolean(config.enableVite, 'experimental.enableVite') ?? false;\n\tconst enableExternalVite = validator.boolean(config.enableExternalVite, 'experimental.enableExternalVite') ?? false;\n\tconst enableNitro = validator.boolean(config.enableNitro, 'experimental.enableNitro') ?? false;\n\n\tif (enableExternalVite && !enableVite) {\n\t\tthrow validator.error(\n\t\t\t'`experimental.enableExternalVite` needs `experimental.enableVite`',\n\t\t\t'experimental.enableExternalVite',\n\t\t\t'EXPERIMENT_REQUIRED',\n\t\t\t'Set `experimental.enableVite` to true as well, or drop `enableExternalVite`.'\n\t\t);\n\t}\n\n\tif (enableNitro && !enableVite) {\n\t\tthrow validator.error(\n\t\t\t'`experimental.enableNitro` needs `experimental.enableVite`',\n\t\t\t'experimental.enableNitro',\n\t\t\t'EXPERIMENT_REQUIRED',\n\t\t\t'Set `experimental.enableVite` to true as well, or drop `enableNitro`.'\n\t\t);\n\t}\n\n\tconst rawNitro = 'nitro' in config ? config.nitro : undefined;\n\tif (rawNitro !== undefined && !enableNitro) {\n\t\tthrow validator.error(\n\t\t\t'`experimental.nitro` needs `experimental.enableNitro`',\n\t\t\t'experimental.nitro',\n\t\t\t'EXPERIMENT_REQUIRED',\n\t\t\t'Set `experimental.enableNitro` to true as well, or drop `nitro`.'\n\t\t);\n\t}\n\tif (rawNitro !== undefined && (rawNitro === null || typeof rawNitro !== 'object' || Array.isArray(rawNitro))) {\n\t\tthrow validator.error('`experimental.nitro` must be an object', 'experimental.nitro', 'INVALID_TYPE', 'Use `{ preset }`.');\n\t}\n\tif (rawNitro) validator.knownKeys(rawNitro, 'experimental.nitro', ['preset']);\n\tconst preset = validator.string(rawNitro?.preset, 'experimental.nitro.preset') ?? 'node-server';\n\n\treturn { enableVite, enableExternalVite, enableNitro, nitro: { preset } };\n}\n\nfunction resolveBuildOutput(root: string, entry: string, outDir: string, packageJson: PackageJsonLike | null): string {\n\tif (packageJson?.main) return resolve(root, packageJson.main);\n\n\tconst extension = extname(entry);\n\tconst outputExtension = extension === '.mts' ? '.mjs' : extension === '.cts' ? '.cjs' : '.js';\n\treturn join(outDir, `${basename(entry, extension)}${outputExtension}`);\n}\n\nconst ENV_PORT_KEYS = ['HTTP_PORT', 'PORT'] as const;\n\n/**\n * Reads the project's environment layers from `src/.env*` and `.env*` into a plain object, the way `stars dev` and\n * `stars commands` need it:\n * these files are only loaded into `process.env` by the bot itself once it starts (see `@wolfstar/env-utilities`),\n * so by the time the CLI runs they are not there yet. This is a minimal line reader, not a full dotenv\n * implementation — quoting is stripped, but expansion (`dotenv-expand`) is not. Earlier files win, matching\n * dotenv's own precedence.\n */\nexport function readProjectEnvFiles(root: string, environment = 'development'): Record<string, string> {\n\tconst result: Record<string, string> = {};\n\tconst suffixes = [`.${environment}.local`, ...(environment === 'test' ? [] : ['.local']), `.${environment}`, ''];\n\tconst files = suffixes.flatMap((suffix) => [join('src', `.env${suffix}`), `.env${suffix}`]);\n\n\tfor (const file of files) {\n\t\tconst path = join(root, file);\n\t\tif (!isFile(path)) continue;\n\n\t\tlet contents: string;\n\t\ttry {\n\t\t\tcontents = readFileSync(path, 'utf-8');\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const line of contents.split(/\\r?\\n/)) {\n\t\t\tconst match = /^\\s*(?:export\\s+)?([A-Za-z_][A-Za-z0-9_]*)\\s*=\\s*(.*)$/.exec(line);\n\t\t\tif (!match) continue;\n\n\t\t\tconst key = match[1]!;\n\t\t\tif (key in result) continue;\n\t\t\tresult[key] = match[2]!.trim().replace(/^['\"]|['\"]$/g, '');\n\t\t}\n\t}\n\n\treturn result;\n}\n\nfunction readDevPortFromEnvFile(root: string, environment: string): string | null {\n\tconst values = readProjectEnvFiles(root, environment);\n\tfor (const key of ENV_PORT_KEYS) {\n\t\tif (values[key]) return values[key];\n\t}\n\n\treturn null;\n}\n\nfunction resolveDev(\n\troot: string,\n\tentry: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: NonNullable<StarsConfig['dev']>,\n\tenv: NodeJS.ProcessEnv,\n\tvalidator: Validator\n): ResolvedDevConfig {\n\tvalidator.knownKeys(config, 'dev', [\n\t\t'banner',\n\t\t'watch',\n\t\t'ignore',\n\t\t'debounce',\n\t\t'env',\n\t\t'nodeArgs',\n\t\t'args',\n\t\t'url',\n\t\t'health',\n\t\t'killTimeout',\n\t\t'typecheck',\n\t\t'tunnel',\n\t\t'logFile'\n\t]);\n\n\tconst watch = (validator.stringArray(config.watch, 'dev.watch') ?? [displayPath(root, dirname(entry))]).map((path) => resolve(root, path));\n\tconst ignore = validator.stringArray(config.ignore, 'dev.ignore') ?? [...DEFAULT_IGNORE];\n\tconst debounce = validator.nonNegativeNumber(config.debounce, 'dev.debounce') ?? DEFAULT_DEBOUNCE;\n\tconst devEnv = validator.stringRecord(config.env, 'dev.env') ?? {};\n\tconst nodeArgs = validator.stringArray(config.nodeArgs, 'dev.nodeArgs') ?? [...DEFAULT_NODE_ARGS];\n\tconst args = validator.stringArray(config.args, 'dev.args') ?? [];\n\tconst killTimeout = validator.nonNegativeNumber(config.killTimeout, 'dev.killTimeout') ?? DEFAULT_KILL_TIMEOUT;\n\tconst health = validator.string(config.health, 'dev.health') ?? null;\n\n\tlet url = validator.string(config.url, 'dev.url') ?? null;\n\tif (url !== null) {\n\t\ttry {\n\t\t\tnew URL(url);\n\t\t} catch {\n\t\t\tthrow validator.error(`Invalid URL \"${url}\"`, 'dev.url', 'INVALID_URL', 'Use an absolute URL such as http://localhost:3000.');\n\t\t}\n\t} else {\n\t\t// Mirrors Vite's and Nuxt's own dev servers: a URL is shown without any configuration. The exact host\n\t\t// (`localhost` vs `127.0.0.1`) is resolved at runtime by `stars dev`, once it knows which one is actually reachable.\n\t\tconst port = devEnv.HTTP_PORT ?? env.HTTP_PORT ?? readDevPortFromEnvFile(root, env.NODE_ENV ?? 'development') ?? String(DEFAULT_DEV_PORT);\n\t\turl = /^\\d+$/.test(port) ? `http://localhost:${port}` : `http://localhost:${DEFAULT_DEV_PORT}`;\n\t}\n\n\tconst typecheck = resolveTypecheck(root, packageJson, config.typecheck, validator);\n\tconst tunnel = resolveTunnel(config.tunnel, validator);\n\tconst logFile = config.logFile === false ? null : resolve(root, validator.string(config.logFile, 'dev.logFile') ?? DEFAULT_DEV_LOG_FILE);\n\tconst banner =\n\t\tconfig.banner === false\n\t\t\t? false\n\t\t\t: typeof config.banner === 'string'\n\t\t\t\t? config.banner.split('\\n')\n\t\t\t\t: (validator.stringArray(config.banner, 'dev.banner') ?? null);\n\n\treturn { watch, ignore, debounce, env: devEnv, nodeArgs, args, url, health, killTimeout, typecheck, tunnel, logFile, banner };\n}\n\n/**\n * Resolves `dev.typecheck`. The tsconfig is looked up the same way the `tsc` build tool looks up its own, so a\n * project building with `tsdown` still gets `tsc --watch --noEmit` on the right project file.\n */\nfunction resolveTypecheck(\n\troot: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: StarsDevConfig['typecheck'],\n\tvalidator: Validator\n): ResolvedTypecheckConfig {\n\tif (config === undefined || config === false) return { enabled: false, tsconfig: null, checker: detectTypechecker(packageJson) };\n\n\tlet configured: string | undefined;\n\tlet requestedChecker = 'auto';\n\tif (config !== true) {\n\t\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\t\tthrow validator.error(\n\t\t\t\t'`dev.typecheck` must be a boolean or an object',\n\t\t\t\t'dev.typecheck',\n\t\t\t\t'INVALID_TYPE',\n\t\t\t\t'Use `true` to type-check with the project tsconfig, `{ tsconfig }` to pick one, or `false` to disable it.'\n\t\t\t);\n\t\t}\n\n\t\tvalidator.knownKeys(config, 'dev.typecheck', ['tsconfig', 'checker']);\n\t\tconfigured = validator.string(config.tsconfig, 'dev.typecheck.tsconfig');\n\t\trequestedChecker = validator.string(config.checker, 'dev.typecheck.checker') ?? 'auto';\n\t\tif (!TYPECHECKERS.has(requestedChecker)) {\n\t\t\tthrow validator.error(\n\t\t\t\t`Unknown type checker \"${requestedChecker}\"`,\n\t\t\t\t'dev.typecheck.checker',\n\t\t\t\t'INVALID_TYPECHECKER',\n\t\t\t\t\"Use one of 'tsc', 'golar', 'tsz' or 'auto'.\"\n\t\t\t);\n\t\t}\n\t}\n\n\tconst checker: StarsTypechecker = requestedChecker === 'auto' ? detectTypechecker(packageJson) : (requestedChecker as StarsTypechecker);\n\n\tif (configured !== undefined) {\n\t\tconst tsconfig = resolve(root, configured);\n\t\tif (!isFile(tsconfig)) {\n\t\t\tthrow validator.error(\n\t\t\t\t`The tsconfig file does not exist: ${tsconfig}`,\n\t\t\t\t'dev.typecheck.tsconfig',\n\t\t\t\t'TSCONFIG_NOT_FOUND',\n\t\t\t\t'Point `dev.typecheck.tsconfig` to an existing tsconfig.json, relative to the project root.'\n\t\t\t);\n\t\t}\n\t\treturn { enabled: true, tsconfig, checker };\n\t}\n\n\tconst found = [join(root, 'src', 'tsconfig.json'), join(root, 'tsconfig.json')].find((candidate) => isFile(candidate)) ?? null;\n\tif (!found) {\n\t\tthrow validator.error(\n\t\t\t`Could not find a tsconfig.json in ${root}`,\n\t\t\t'dev.typecheck',\n\t\t\t'TSCONFIG_NOT_FOUND',\n\t\t\t'Create src/tsconfig.json or tsconfig.json, or set `dev.typecheck.tsconfig`.'\n\t\t);\n\t}\n\n\treturn { enabled: true, tsconfig: found, checker };\n}\n\n/**\n * Picks the type checker when `dev.typecheck.checker` is `auto`: `golar` when the project already depends on it\n * (it wraps TypeScript and is what this repository's own `typecheck` scripts run), `tsc` otherwise. `tsz` is never\n * picked automatically — it is an early, tsc-compatible alternative a project opts into.\n */\nfunction detectTypechecker(packageJson: PackageJsonLike | null): StarsTypechecker {\n\treturn hasDependency(packageJson, 'golar') ? 'golar' : 'tsc';\n}\n\n/**\n * Resolves `dev.tunnel`: `true` (or `{}`) opens a `cloudflared` quick tunnel, a string (or `{ url }`) is an https\n * URL the user already serves and the CLI only checks.\n */\nfunction resolveTunnel(config: StarsDevConfig['tunnel'], validator: Validator): ResolvedTunnelConfig {\n\tif (config === undefined || config === false) return { mode: 'off' };\n\n\tlet url: string | undefined;\n\tlet updateEndpoint = false;\n\tlet path = DEFAULT_TUNNEL_PATH;\n\n\tif (typeof config === 'string') {\n\t\turl = config;\n\t} else if (config !== true) {\n\t\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\t\tthrow validator.error(\n\t\t\t\t'`dev.tunnel` must be a boolean, an https URL or an object',\n\t\t\t\t'dev.tunnel',\n\t\t\t\t'INVALID_TYPE',\n\t\t\t\t'Use `true` for a cloudflared quick tunnel, an https URL you already serve, or `false` to disable it.'\n\t\t\t);\n\t\t}\n\n\t\tvalidator.knownKeys(config, 'dev.tunnel', ['url', 'updateEndpoint', 'path']);\n\t\turl = validator.string(config.url, 'dev.tunnel.url');\n\t\tupdateEndpoint = validator.boolean(config.updateEndpoint, 'dev.tunnel.updateEndpoint') ?? false;\n\t\tpath = validator.string(config.path, 'dev.tunnel.path') ?? DEFAULT_TUNNEL_PATH;\n\t}\n\n\tif (url === undefined) return { mode: 'quick', path, updateEndpoint };\n\n\t// Discord only accepts an https interactions endpoint.\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(url);\n\t} catch {\n\t\tthrow validator.error(`Invalid URL \"${url}\"`, 'dev.tunnel', 'INVALID_URL', 'Use an absolute https URL such as https://bot.example.com.');\n\t}\n\n\tif (parsed.protocol !== 'https:') {\n\t\tthrow validator.error(\n\t\t\t`The tunnel URL must be https, received \"${url}\"`,\n\t\t\t'dev.tunnel',\n\t\t\t'INVALID_URL',\n\t\t\t'Discord only accepts an https interactions endpoint.'\n\t\t);\n\t}\n\n\treturn { mode: 'url', url, path, updateEndpoint };\n}\n\nfunction resolveCodegen(root: string, config: NonNullable<StarsConfig['codegen']>, validator: Validator): ResolvedCodegenConfig {\n\tvalidator.knownKeys(config, 'codegen', ['i18n']);\n\n\tif (config.i18n === false) return { i18n: null };\n\n\tif (config.i18n === undefined) {\n\t\tconst locales = join(root, DEFAULT_I18N_LOCALES);\n\t\treturn { i18n: isDirectory(locales) ? { locales, output: join(root, DEFAULT_I18N_OUTPUT) } : null };\n\t}\n\n\tif (config.i18n === null || typeof config.i18n !== 'object') {\n\t\tthrow validator.error(\n\t\t\t'`codegen.i18n` must be an object or `false`',\n\t\t\t'codegen.i18n',\n\t\t\t'INVALID_TYPE',\n\t\t\t'Use `{ locales, output }` to configure it or `false` to disable it.'\n\t\t);\n\t}\n\n\tvalidator.knownKeys(config.i18n, 'codegen.i18n', ['locales', 'output']);\n\tconst locales = resolve(root, validator.string(config.i18n.locales, 'codegen.i18n.locales') ?? DEFAULT_I18N_LOCALES);\n\tif (!isDirectory(locales)) {\n\t\tthrow validator.error(\n\t\t\t`The locales directory does not exist: ${locales}`,\n\t\t\t'codegen.i18n.locales',\n\t\t\t'LOCALES_NOT_FOUND',\n\t\t\t'Point `codegen.i18n.locales` to the base locale directory, relative to the project root.'\n\t\t);\n\t}\n\n\tconst output = resolve(root, validator.string(config.i18n.output, 'codegen.i18n.output') ?? DEFAULT_I18N_OUTPUT);\n\treturn { i18n: { locales, output } };\n}\n\n/**\n * The transform that injects auto imports (`@wolfstar/http-framework/auto-imports`) only runs through `tsdown`'s\n * rolldown pipeline, the same way Nuxt's own auto imports only run through its Vite/webpack build: `tsc` and `none`\n * have no transform step to hook into. `tsdown` is picked as `build.tool` first (see {@link detectBuildTool}) for the\n * same reason — it is the only tool this feature, and this build config in general, treats as the default choice.\n *\n * They are on by default from compatibility version 4 on, where `stars` wires the plugin into the build itself. At 3\n * the plugin is the project's to add, so defaulting them on would promise imports that never get injected.\n */\nfunction resolveImports(\n\troot: string,\n\tbuildTool: StarsBuildTool,\n\tfuture: ResolvedFutureConfig,\n\tconfig: StarsConfig['imports'],\n\tvalidator: Validator\n): ResolvedImportsConfig {\n\tconst defaultDirs = DEFAULT_IMPORTS_DIRS.map((dir) => resolve(root, dir));\n\tconst defaultPresets = [...DEFAULT_IMPORTS_PRESETS];\n\tconst defaultDts = resolve(root, DEFAULT_IMPORTS_DTS);\n\n\tif (config === false) {\n\t\treturn { enabled: false, dirs: defaultDirs, presets: defaultPresets, exclude: [], dts: defaultDts };\n\t}\n\n\tconst forcedOn = config === true;\n\tconst options = forcedOn || config === undefined ? {} : config;\n\tif (typeof options !== 'object' || options === null || Array.isArray(options)) {\n\t\tthrow validator.error(\n\t\t\t'`imports` must be an object, `true` or `false`',\n\t\t\t'imports',\n\t\t\t'INVALID_TYPE',\n\t\t\t'Use `{ dirs, presets, exclude, dts }`, `true` to enable with defaults, or `false` to disable.'\n\t\t);\n\t}\n\n\tvalidator.knownKeys(options, 'imports', ['enabled', 'dirs', 'presets', 'exclude', 'dts']);\n\n\tconst requestedOn = forcedOn || validator.boolean(options.enabled, 'imports.enabled');\n\tif (requestedOn && buildTool !== 'tsdown') {\n\t\tthrow validator.error(\n\t\t\t'`imports` requires the `tsdown` build tool',\n\t\t\t'imports.enabled',\n\t\t\t'IMPORTS_REQUIRE_TSDOWN',\n\t\t\t\"Set `build.tool` to 'tsdown', or remove `imports`/set it to `false`.\"\n\t\t);\n\t}\n\n\tconst dirs = (validator.stringArray(options.dirs, 'imports.dirs') ?? [...DEFAULT_IMPORTS_DIRS]).map((dir) => resolve(root, dir));\n\tconst presets = validator.stringArray(options.presets, 'imports.presets') ?? defaultPresets;\n\tconst exclude = validator.stringArray(options.exclude, 'imports.exclude') ?? [];\n\tconst dts = resolve(root, validator.string(options.dts, 'imports.dts') ?? DEFAULT_IMPORTS_DTS);\n\n\tconst enabledByDefault = buildTool === 'tsdown' && future.compatibilityVersion >= LATEST_COMPATIBILITY_VERSION;\n\treturn { enabled: requestedOn ?? enabledByDefault, dirs, presets, exclude, dts };\n}\n\nclass Validator {\n\tpublic constructor(private readonly file: string | null) {}\n\n\tpublic error(message: string, path: string, code: string, hint: string): ConfigError {\n\t\treturn new ConfigError(message, { code, path, hint, file: this.file });\n\t}\n\n\tpublic knownKeys(value: object, path: string, keys: readonly string[]): void {\n\t\tfor (const key of Object.keys(value)) {\n\t\t\tif (keys.includes(key)) continue;\n\t\t\tconst fullPath = path ? `${path}.${key}` : key;\n\t\t\tthrow this.error(\n\t\t\t\t`Unknown option \\`${fullPath}\\``,\n\t\t\t\tfullPath,\n\t\t\t\t'UNKNOWN_OPTION',\n\t\t\t\t`Known options${path ? ` of \\`${path}\\`` : ''}: ${keys.join(', ')}.`\n\t\t\t);\n\t\t}\n\t}\n\n\tpublic string(value: unknown, path: string): string | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'string' || value.length === 0) throw this.typeError(path, 'a non-empty string', value);\n\t\treturn value;\n\t}\n\n\tpublic boolean(value: unknown, path: string): boolean | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'boolean') throw this.typeError(path, 'a boolean', value);\n\t\treturn value;\n\t}\n\n\t/** A plain object passed through as-is (e.g. raw `vite`/`tsdown` config merged into the project's own). */\n\tpublic plainObject(value: unknown, path: string): Record<string, unknown> | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (value === null || typeof value !== 'object' || Array.isArray(value)) throw this.typeError(path, 'an object', value);\n\t\treturn value as Record<string, unknown>;\n\t}\n\n\tpublic stringArray(value: unknown, path: string): string[] | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (!Array.isArray(value) || !value.every((item) => typeof item === 'string')) throw this.typeError(path, 'an array of strings', value);\n\t\treturn value;\n\t}\n\n\tpublic nonNegativeNumber(value: unknown, path: string): number | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value) || value < 0) throw this.typeError(path, 'a non-negative number', value);\n\t\treturn value;\n\t}\n\n\tpublic stringRecord(value: unknown, path: string): Record<string, string> | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (value === null || typeof value !== 'object' || Array.isArray(value) || !Object.values(value).every((item) => typeof item === 'string')) {\n\t\t\tthrow this.typeError(path, 'an object of string values', value);\n\t\t}\n\t\treturn value as Record<string, string>;\n\t}\n\n\tprivate typeError(path: string, expected: string, value: unknown): ConfigError {\n\t\treturn this.error(\n\t\t\t`\\`${path}\\` must be ${expected}, received ${describe(value)}`,\n\t\t\tpath,\n\t\t\t'INVALID_TYPE',\n\t\t\t`Set \\`${path}\\` to ${expected} or remove it to use the default.`\n\t\t);\n\t}\n}\n\nfunction describe(value: unknown): string {\n\tif (value === null) return 'null';\n\tif (Array.isArray(value)) return 'an array';\n\tif (typeof value === 'string') return `\"${value}\"`;\n\treturn typeof value === 'object' ? 'an object' : `${typeof value} ${String(value)}`;\n}\n\nfunction hasDependency(packageJson: PackageJsonLike | null, name: string): boolean {\n\treturn Boolean(packageJson?.dependencies?.[name] ?? packageJson?.devDependencies?.[name]);\n}\n\nfunction readPackageJson(root: string): PackageJsonLike | null {\n\tconst file = join(root, 'package.json');\n\tif (!isFile(file)) return null;\n\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(readFileSync(file, 'utf-8'));\n\t\treturn parsed !== null && typeof parsed === 'object' ? (parsed as PackageJsonLike) : null;\n\t} catch (error) {\n\t\tthrow new ConfigError(`Failed to parse ${file}: ${error instanceof Error ? error.message : String(error)}`, {\n\t\t\tcode: 'PACKAGE_JSON_INVALID',\n\t\t\thint: 'Fix the JSON syntax of the package.json file.',\n\t\t\tcause: error\n\t\t});\n\t}\n}\n\nfunction isFile(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isDirectory(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n","import { loadConfigFile } from './load.js';\nimport { resolveStarsConfig, type ResolvedStarsConfig } from './resolve.js';\n\nexport interface LoadStarsConfigOptions {\n\t/**\n\t * The directory to discover `stars.config.*` from.\n\t * @default process.cwd()\n\t */\n\tcwd?: string;\n\t/** An explicit configuration file, resolved from `cwd`. */\n\tconfigFile?: string | null;\n\t/**\n\t * Environment used for defaults such as `HTTP_PORT`.\n\t * @default process.env\n\t */\n\tenv?: NodeJS.ProcessEnv;\n}\n\n/**\n * Loads, validates and resolves a project's `stars.config.*`.\n *\n * @throws {ConfigError} when the configuration file cannot be loaded or contains an invalid option.\n */\nexport async function loadStarsConfig(options: LoadStarsConfigOptions = {}): Promise<ResolvedStarsConfig> {\n\tconst cwd = options.cwd ?? process.cwd();\n\tconst loaded = await loadConfigFile({ cwd, configFile: options.configFile });\n\treturn resolveStarsConfig({ cwd, configFile: loaded.configFile, config: loaded.config, env: options.env });\n}\n\nexport { CONFIG_EXTENSIONS, CONFIG_FILE_NAMES, discoverConfigFile, loadConfigFile } from './load.js';\nexport type { LoadConfigFileOptions, LoadedConfigFile } from './load.js';\nexport { ConfigError } from './errors.js';\nexport type { ConfigErrorOptions } from './errors.js';\nexport { displayPath, readProjectEnvFiles, resolveStarsConfig } from './resolve.js';\nexport type {\n\tPackageJsonLike,\n\tResolveConfigOptions,\n\tResolvedBuildConfig,\n\tResolvedCodegenConfig,\n\tResolvedDevConfig,\n\tResolvedExperimentalConfig,\n\tResolvedFutureConfig,\n\tResolvedNitroConfig,\n\tResolvedI18nCodegenConfig,\n\tResolvedImportsConfig,\n\tResolvedStarsConfig,\n\tResolvedTunnelConfig,\n\tResolvedTypecheckConfig\n} from './resolve.js';\n","/**\n * Public, side-effect free configuration surface of `@wolfstar/cli`.\n *\n * This module is intentionally tiny: importing it from a `stars.config.ts`\n * file must never start the bot nor pull the heavy runtime of the CLI.\n *\n * @module @wolfstar/http-framework/config\n */\n\n/**\n * The build tool used to turn the project sources into runnable JavaScript.\n *\n * - `tsdown`: run the project's own `tsdown` programmatically, configured from {@link StarsConfig.tsdown} (and, with\n *   {@link StarsFutureConfig.compatibilityVersion} `3`, from the project's `tsdown.config.*` too).\n * - `tsc`: run the project's `tsc -b` on the configured `tsconfig`.\n * - `vite`: run the project's own `vite` (configuration file included), requires `experimental.enableVite`.\n * - `none`: the entry is runnable as-is (JavaScript projects), no build step.\n * - `auto`: detect from the project (default).\n */\nexport type StarsBuildTool = 'tsdown' | 'tsc' | 'none' | 'vite';\n\nexport interface StarsBuildConfig {\n\t/**\n\t * The build tool to use.\n\t * @default 'auto'\n\t */\n\ttool?: StarsBuildTool | 'auto';\n\t/**\n\t * The directory, relative to {@link StarsConfig.root}, the build writes into.\n\t * @default 'dist', or '.output' when `experimental.enableNitro` is on (Nitro's own convention)\n\t */\n\toutDir?: string;\n\t/**\n\t * The `tsconfig.json` the `tsc` and `tsdown` build tools use, relative to {@link StarsConfig.root}.\n\t * @default 'src/tsconfig.json' when it exists, 'tsconfig.json' otherwise\n\t */\n\ttsconfig?: string;\n}\n\n/**\n * Raw options merged into the project's own `vite.config.*`, the way `vite: {}` in a Nuxt config is merged into\n * Nuxt's own Vite config. Kept as `unknown` here (the CLI, not the framework, depends on `vite`'s types) and passed\n * to Vite's `mergeConfig` as-is.\n */\nexport type StarsViteConfig = Record<string, unknown>;\n\n/**\n * Options for `tsdown`, the bundler `stars build` uses by default.\n *\n * With {@link StarsFutureConfig.compatibilityVersion} `4` these replace `tsdown.config.*` outright: the build is\n * derived from `stars.config` (the entry's directory, `build.outDir`, `build.tsconfig`) and these options are layered\n * on top, so a project keeps one configuration file instead of two. With `3` the project's own `tsdown.config.*` is\n * still loaded and these are merged over it, the way `vite: {}` in a Nuxt config is merged into the project's own\n * Vite config: values here win, and `plugins` are appended rather than replaced.\n *\n * The options named below are the ones a bot usually reaches for. Every other `tsdown` option is accepted as-is —\n * the framework does not depend on `tsdown`, so they stay loosely typed here and `tsdown`'s own `UserConfig` is the\n * reference.\n */\nexport interface StarsTsdownConfig {\n\t/** Entry files or glob patterns, relative to the project root. Defaults to every source file next to `entry`. */\n\tentry?: string | readonly string[] | Record<string, string>;\n\t/** @default 'esm' */\n\tformat?: 'esm' | 'cjs' | 'iife' | 'umd' | readonly string[] | Record<string, unknown>;\n\t/** @default 'node' */\n\tplatform?: 'node' | 'neutral' | 'browser';\n\ttarget?: string | readonly string[] | false;\n\t/**\n\t * Emits one output file per source file instead of a single bundle, so pieces stay loadable from `dist/commands`\n\t * and friends at runtime.\n\t * @default true\n\t */\n\tunbundle?: boolean;\n\t/** Rolldown plugins. Appended to the ones `stars` adds (auto imports) and to those of a `tsdown.config.*`. */\n\tplugins?: readonly unknown[];\n\talias?: Record<string, string>;\n\tdefine?: Record<string, string>;\n\texternal?: unknown;\n\tnoExternal?: unknown;\n\tdeps?: Record<string, unknown>;\n\t/** @default () => ({ js: extname(build.output) }) */\n\toutExtensions?: unknown;\n\t/** @default true */\n\tsourcemap?: boolean | 'inline' | 'hidden';\n\tminify?: unknown;\n\t/** @default false — a bot is not a library, so no declaration files are emitted. */\n\tdts?: boolean | Record<string, unknown>;\n\t/** @default true */\n\tclean?: boolean | readonly string[];\n\ttreeshake?: boolean;\n\tcopy?: unknown;\n\thooks?: Record<string, unknown>;\n\t[option: string]: unknown;\n}\n\n/**\n * The build-default generation the project runs on. Version 4 is current; version 3 remains available for projects\n * that still load a standalone `tsdown.config.*`.\n */\nexport type StarsCompatibilityVersion = 3 | 4;\n\n/**\n * Nuxt-style compatibility block. New projects need not set it; version 3 is retained as an explicit migration\n * escape hatch for projects that still use a standalone `tsdown.config.*`.\n */\nexport interface StarsFutureConfig {\n\t/**\n\t * The major whose defaults apply.\n\t *\n\t * `4` is the default build pipeline:\n\t * - auto imports are on by default with the `tsdown` build tool ({@link StarsImportsConfig}), and the\n\t *   `autoImports()` plugin is wired into the build by `stars` itself.\n\t * - `tsdown` is configured from {@link StarsConfig.tsdown} only. A `tsdown.config.*` in the project root is\n\t *   rejected rather than silently ignored, so a build never loses the plugins it declares.\n\t * - `build.tool: 'auto'` resolves to `tsdown` for any TypeScript entry, without looking for a `tsdown.config.*`\n\t *   or a `tsdown` dependency first.\n\t *\n\t * `3` keeps the legacy behaviour: auto imports off unless asked for, and a `tsdown.config.*` loaded and merged with\n\t * {@link StarsConfig.tsdown}.\n\t * @default 4\n\t */\n\tcompatibilityVersion?: StarsCompatibilityVersion;\n}\n\n/**\n * The type checker `stars dev` runs next to the bot.\n *\n * - `tsc`: the project's own TypeScript, in watch mode.\n * - `golar`: the project's `golar`, forwarding to TypeScript (`golar tsc`), in watch mode.\n * - `tsz`: the project's `tsz` (or `try-tsz`). It has no watch mode, so it is re-run after every build instead.\n * - `auto`: `golar` when the project depends on it, `tsc` otherwise (default).\n */\nexport type StarsTypechecker = 'tsc' | 'golar' | 'tsz';\n\nexport interface StarsTypecheckConfig {\n\t/**\n\t * The `tsconfig.json` the type checker runs against, relative to {@link StarsConfig.root}.\n\t * @default the build tool's tsconfig, 'src/tsconfig.json' or 'tsconfig.json'\n\t */\n\ttsconfig?: string;\n\t/**\n\t * Which type checker to run.\n\t * @default 'auto'\n\t */\n\tchecker?: StarsTypechecker | 'auto';\n}\n\nexport interface StarsTunnelConfig {\n\t/**\n\t * An https URL you already serve; when unset a `cloudflared` quick tunnel is opened instead.\n\t */\n\turl?: string;\n\t/**\n\t * Writes the tunnel's URL to the Discord application's `interactions_endpoint_url` when it changes.\n\t *\n\t * This edits a live Discord application, so it is opt-in: it needs `DISCORD_TOKEN` and `DISCORD_APPLICATION_ID`\n\t * (or `APPLICATION_ID`) in the environment or the project's `.env`.\n\t * @default false\n\t */\n\tupdateEndpoint?: boolean;\n\t/**\n\t * The path the interactions endpoint is served on, appended to the tunnel URL.\n\t * @default '/'\n\t */\n\tpath?: string;\n}\n\nexport interface StarsDevConfig {\n\t/** Custom terminal wordmark (one or more lines), or `false` to hide it. Defaults to the Stars wordmark. */\n\tbanner?: string | readonly string[] | false;\n\t/**\n\t * Extra paths to watch, relative to {@link StarsConfig.root}. Only used when\n\t * the build tool is `none`; `tsdown` and `tsc` watch through their own build.\n\t * @default [dirname(entry)]\n\t */\n\twatch?: string[];\n\t/**\n\t * Glob patterns or paths to ignore while watching, relative to {@link StarsConfig.root}.\n\t * @default ['**\\/node_modules/**', '**\\/dist/**', '**\\/.git/**']\n\t */\n\tignore?: string[];\n\t/**\n\t * Milliseconds to wait after a change before restarting the bot.\n\t * @default 150\n\t */\n\tdebounce?: number;\n\t/**\n\t * Environment variables added to the bot process.\n\t */\n\tenv?: Record<string, string>;\n\t/**\n\t * Arguments passed to `node` before the entry file.\n\t * @default ['--enable-source-maps']\n\t */\n\tnodeArgs?: string[];\n\t/**\n\t * Arguments passed to the bot after the entry file.\n\t * @default []\n\t */\n\targs?: string[];\n\t/**\n\t * The URL the bot listens on, shown in the dev UI's status line and used for {@link StarsDevConfig.health}.\n\t *\n\t * Resolved automatically, the way Vite's and Nuxt's dev servers do, from (in order) `dev.env.HTTP_PORT`, the\n\t * process's `HTTP_PORT`, the project's `src/.env*`/`.env*` (`HTTP_PORT` or `PORT`), or `3000`. `stars dev` also\n\t * resolves whether `localhost` should be shown as `127.0.0.1` instead, the same DNS-order check Vite does, so the\n\t * printed URL is always the one that is actually reachable.\n\t * @default `http://localhost:3000` (or whichever port is found)\n\t */\n\turl?: string;\n\t/**\n\t * A path, relative to {@link StarsDevConfig.url}, polled to report the bot's health in the dev UI.\n\t * When unset the dev UI only reports process state.\n\t */\n\thealth?: string;\n\t/**\n\t * Milliseconds to wait for the bot to exit after `SIGTERM` before killing it.\n\t * @default 5000\n\t */\n\tkillTimeout?: number;\n\t/**\n\t * Runs a type checker next to the bot and reports type errors on the dev UI's `tsc` channel, without blocking\n\t * builds or restarts. `true` uses the project's own tsconfig and type checker, an object picks either\n\t * ({@link StarsTypecheckConfig.checker}).\n\t * @default false\n\t */\n\ttypecheck?: boolean | StarsTypecheckConfig;\n\t/**\n\t * Exposes the bot's HTTP interactions endpoint publicly while `stars dev` runs, so Discord can reach it.\n\t *\n\t * `true` opens a `cloudflared` quick tunnel (its hostname changes on every run), a string is an https URL you\n\t * already serve yourself (named tunnel, reverse proxy, …) that the CLI only checks for reachability.\n\t * @default false\n\t */\n\ttunnel?: boolean | string | StarsTunnelConfig;\n\t/**\n\t * The file `stars dev` mirrors its logs into, relative to {@link StarsConfig.root}, so a session can be read back\n\t * after the terminal UI is gone. `false` disables it.\n\t * @default '.stars/dev.log'\n\t */\n\tlogFile?: string | false;\n}\n\nexport interface StarsI18nCodegenConfig {\n\t/**\n\t * The base locale directory, relative to {@link StarsConfig.root}.\n\t * @default 'src/locales/en-US'\n\t */\n\tlocales?: string;\n\t/**\n\t * The generated declaration file, relative to {@link StarsConfig.root}.\n\t * @default 'src/@types/i18next.d.ts'\n\t */\n\toutput?: string;\n}\n\nexport interface StarsCodegenConfig {\n\t/**\n\t * i18next type generation through `@wolfstar/i18next-type-generator`.\n\t * `false` disables it, an object enables it, unset auto-detects from the presence of the locales directory.\n\t */\n\ti18n?: StarsI18nCodegenConfig | false;\n}\n\nexport interface StarsImportsConfig {\n\t/**\n\t * Whether auto imports are enabled. Requires the `tsdown` build tool: the imports are injected at build time by\n\t * the `autoImports()` plugin from `@wolfstar/http-framework/auto-imports`, which the other tools cannot run.\n\t * @default true when the build tool is 'tsdown', false otherwise\n\t */\n\tenabled?: boolean;\n\t/**\n\t * Directories, relative to {@link StarsConfig.root}, whose exported values are auto-importable. Entries are glob\n\t * path patterns: `'src/lib'` scans only the files directly inside it, `'src/lib/**'` scans recursively.\n\t * @default ['src/lib/**', 'src/utils/**']\n\t */\n\tdirs?: string[];\n\t/**\n\t * Packages whose exports are auto-importable. Packages that are not installed are skipped.\n\t * @default ['@wolfstar/http-framework', '@wolfstar/env-utilities']\n\t */\n\tpresets?: string[];\n\t/**\n\t * Export names excluded from auto imports, e.g. to avoid clashes with project-local names.\n\t * @default []\n\t */\n\texclude?: string[];\n\t/**\n\t * The generated declaration file that types the auto imports, relative to {@link StarsConfig.root}.\n\t * Include it in the project's tsconfig and add its directory to .gitignore.\n\t * @default '.stars/imports.d.ts'\n\t */\n\tdts?: string;\n}\n\n/**\n * The [Nitro preset](https://nitro.build/deploy) `stars build` targets, only reachable once\n * {@link StarsExperimentalConfig.enableNitro} (itself gated on {@link StarsExperimentalConfig.enableVite}) is `true`\n * — see {@link StarsExperimentalConfig}.\n */\nexport interface StarsNitroConfig {\n\t/**\n\t * `'node-server'` (the default, runs locally with plain `node`), `'cloudflare-module'`, `'aws-lambda'`,\n\t * `'vercel'`, `'netlify'`, `'bun'`, `'deno-deploy'`, and more — see Nitro's own preset list.\n\t * @default 'node-server'\n\t */\n\tpreset?: string;\n}\n\n/**\n * Opt-in flags for work that is still landing, in the shape Nuxt's own `experimental` block has: every flag is a\n * boolean, defaults to `false`, and is documented with what it changes and what it still needs. A flag stays here\n * until the behaviour it guards is the default (or is dropped), so enabling one is a statement that breakage is\n * acceptable in exchange for the feature.\n *\n * `enableExternalVite`, `enableNitro` and `nitro` build on `enableVite` (and `nitro` on `enableNitro` too): the type\n * only accepts them once their prerequisite is `true`, so turning one on without the other is a type error here\n * instead of a `ConfigError` at load time.\n */\nexport type StarsExperimentalConfig =\n\t| { enableVite?: false; enableExternalVite?: false; enableNitro?: false }\n\t| {\n\t\t\t/**\n\t\t\t * Uses Vite as the project's build tool, in place of `tsdown`. `build.tool` may then be set to `'vite'`\n\t\t\t * (and `'auto'` detects a `vite.config.*`); the bot keeps calling `client.listen()` and running as a\n\t\t\t * plain `node:http` process, restarted on every change — this only swaps the bundler.\n\t\t\t */\n\t\t\tenableVite: true;\n\t\t\t/**\n\t\t\t * Runs the bot through Vite itself, the way `nuxt dev` runs on Vite's own dev server: instead of\n\t\t\t * building then restarting a child `node` process on every change, `stars dev` loads the entry through\n\t\t\t * Vite's SSR module graph and serves it — through `@wolfstar/http-framework/fetch`'s\n\t\t\t * `createFetchHandler` — from one long-lived process, invalidating and re-evaluating just the entry's\n\t\t\t * module graph on a change instead of restarting.\n\t\t\t *\n\t\t\t * With this on, the entry's default export must be the `Client` instance (already `load()`ed, not\n\t\t\t * `listen()`ed) rather than a script that calls `client.listen()` itself — `stars dev` owns the socket.\n\t\t\t * @default false\n\t\t\t */\n\t\t\tenableExternalVite?: boolean;\n\t\t\tenableNitro?: false;\n\t  }\n\t| {\n\t\t\tenableVite: true;\n\t\t\tenableExternalVite?: boolean;\n\t\t\t/**\n\t\t\t * Builds the bot through [Nitro](https://nitro.build) instead of a `node:http` server, so `stars build`\n\t\t\t * produces a server deployable to any of Nitro's presets (`node-server` locally, `cloudflare-module`,\n\t\t\t * `aws-lambda`, `vercel`, `netlify`, `bun`, `deno-deploy`, and more) from the same\n\t\t\t * `@wolfstar/http-framework/fetch` handler `enableExternalVite` already runs in dev — no per-platform\n\t\t\t * adapter to maintain.\n\t\t\t *\n\t\t\t * Output goes to `.output/` (Nitro's own convention) instead of `build.outDir`. The entry's default\n\t\t\t * export must be the `Client` instance, the same as `enableExternalVite`.\n\t\t\t */\n\t\t\tenableNitro: true;\n\t\t\t/** Nitro-specific options, reachable only with `enableNitro: true`. */\n\t\t\tnitro?: StarsNitroConfig;\n\t  };\n\nexport interface StarsConfig {\n\t/**\n\t * The project root. Relative paths are resolved from the configuration file.\n\t * @default dirname(configFile)\n\t */\n\troot?: string;\n\t/**\n\t * The source entry point of the bot, relative to {@link StarsConfig.root}.\n\t * @default the first of 'src/main.ts', 'src/main.js', 'src/index.ts', 'src/index.js' that exists\n\t */\n\tentry?: string;\n\tbuild?: StarsBuildConfig;\n\tdev?: StarsDevConfig;\n\tcodegen?: StarsCodegenConfig;\n\t/**\n\t * Nuxt-style auto imports of the framework's exports and the project's own modules.\n\t * `false` disables them, `true` forces them on (requires the `tsdown` build tool). On by default with\n\t * `future.compatibilityVersion: 4`.\n\t */\n\timports?: StarsImportsConfig | boolean;\n\t/** Opt-in flags for behaviour that is still landing. */\n\texperimental?: StarsExperimentalConfig;\n\t/** Build-default compatibility. Omit for version 4; set version 3 only while migrating a standalone tsdown config. */\n\tfuture?: StarsFutureConfig;\n\t/**\n\t * Raw options merged into `vite.config.*`, the way `vite: {}` in a Nuxt config is merged into Nuxt's own Vite\n\t * config. Only used with `build.tool: 'vite'` (see `experimental.enableVite`).\n\t */\n\tvite?: StarsViteConfig;\n\t/**\n\t * The project's `tsdown` build. Replaces `tsdown.config.*` with `future.compatibilityVersion: 4`, and is merged\n\t * over it with `3`. Only used with `build.tool: 'tsdown'`.\n\t */\n\ttsdown?: StarsTsdownConfig;\n}\n\n/**\n * Typed helper for `stars.config.{ts,mts,cts,js,mjs,cjs}` files.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@wolfstar/http-framework/config';\n *\n * export default defineConfig({\n * \tentry: 'src/main.ts',\n * \tbuild: { tool: 'tsdown' }\n * });\n * ```\n */\nexport function defineConfig(config: StarsConfig): StarsConfig {\n\treturn config;\n}\n\nexport * from './lib/config/index.js';\n"],"mappings":"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"}
+{"version":3,"file":"config.js","names":["isFile"],"sources":["../../src/lib/config/errors.ts","../../src/lib/config/load.ts","../../src/lib/config/resolve.ts","../../src/lib/config/index.ts","../../src/config.ts"],"sourcesContent":["import { defineDiagnostics } from 'nostics';\n\n/**\n * Structured, stable diagnostic codes for every way a `stars.config.*` can fail to load or validate.\n *\n * This is a plain data error (no exit code or terminal formatting), so nothing here reports anywhere on its own —\n * `reporters` stays empty and each call only builds and returns a `Diagnostic`. That keeps it meaningful outside a\n * CLI, e.g. for a dashboard or test that calls {@link loadStarsConfig} directly; `@wolfstar/cli` is what renders it\n * and picks an exit code (`exitCodeOf`).\n *\n * The `sources` field (populated with the configuration file, when there is one) carries the \"which file\" grounding\n * `ConfigError` used to expose as `.file`; the \"which option\" grounding it exposed as `.path` is folded directly into\n * every `why`/`fix` message instead, the way every other diagnostic code already reads.\n *\n * `why` and `fix` are always given the same, fully-typed params object (even when one of them ignores part of it):\n * a bare `() => value` loses nostics' param-type inference (a zero-arg function widens to `unknown` params), so every\n * entry here spells out its shape on both sides instead.\n */\nexport const configDiagnostics = defineDiagnostics({\n\tdocsBase: (code) => `https://stars-components.js.org/docs/config/errors#${code.toLowerCase()}`,\n\treporters: [],\n\tcodes: {\n\t\tROOT_NOT_FOUND: {\n\t\t\twhy: (p: { root: string }) => `The project root does not exist: ${p.root}`,\n\t\t\tfix: (_p: { root: string }) => 'Point `root` to an existing directory, relative to the configuration file.'\n\t\t},\n\t\tPACKAGE_JSON_INVALID: {\n\t\t\twhy: (p: { file: string; message: string }) => `Failed to parse ${p.file}: ${p.message}`,\n\t\t\tfix: (_p: { file: string; message: string }) => 'Fix the JSON syntax of the package.json file.'\n\t\t},\n\t\tENTRY_NOT_FOUND: {\n\t\t\twhy: (p: { entry: string }) => `The entry file does not exist: ${p.entry}`,\n\t\t\tfix: (_p: { entry: string }) => 'Point `entry` to the file that starts the bot, relative to the project root.'\n\t\t},\n\t\tENTRY_DEFAULT_NOT_FOUND: {\n\t\t\twhy: (p: { root: string; defaults: string }) => `Could not find the entry file in ${p.root}`,\n\t\t\tfix: (p: { root: string; defaults: string }) => `Set \\`entry\\` in the configuration, or create one of ${p.defaults}.`\n\t\t},\n\t\tINVALID_BUILD_TOOL: {\n\t\t\twhy: (p: { tool: string }) => `Unknown build tool \"${p.tool}\"`,\n\t\t\tfix: (_p: { tool: string }) => \"Use one of 'tsdown', 'tsc', 'vite', 'none' or 'auto'.\"\n\t\t},\n\t\tEXPERIMENTAL_BUILD_TOOL: {\n\t\t\twhy: (p: { tool: string; flag: string }) => `The '${p.tool}' build tool is experimental`,\n\t\t\tfix: (p: { tool: string; flag: string }) => `Set \\`${p.flag}\\` to true to use it.`\n\t\t},\n\t\tBUILD_TOOL_REQUIRED: {\n\t\t\twhy: (p: { entry: string }) => `The entry ${p.entry} is TypeScript but the build tool is 'none'`,\n\t\t\tfix: (_p: { entry: string }) => \"Set `build.tool` to 'tsdown' or 'tsc', or point `entry` to a JavaScript file.\"\n\t\t},\n\t\tTSCONFIG_EXPLICIT_NOT_FOUND: {\n\t\t\twhy: (p: { tsconfig: string; path: string }) => `The tsconfig file does not exist: ${p.tsconfig}`,\n\t\t\tfix: (p: { tsconfig: string; path: string }) => `Point \\`${p.path}\\` to an existing tsconfig.json, relative to the project root.`\n\t\t},\n\t\tTSCONFIG_NOT_FOUND: {\n\t\t\twhy: (p: { root: string; suggestion: string }) => `Could not find a tsconfig.json in ${p.root}`,\n\t\t\tfix: (p: { root: string; suggestion: string }) => `Create src/tsconfig.json or tsconfig.json, or set \\`${p.suggestion}\\`.`\n\t\t},\n\t\tTSDOWN_OPTIONS_REQUIRE_TSDOWN: {\n\t\t\twhy: (_p: { tool: string }) => '`tsdown` options need the `tsdown` build tool',\n\t\t\tfix: (p: { tool: string }) => `Set \\`build.tool\\` to 'tsdown', or remove \\`tsdown\\` (the build tool is '${p.tool}').`\n\t\t},\n\t\tVITE_OPTIONS_REQUIRE_VITE: {\n\t\t\twhy: (_p: { tool: string }) => '`vite` options need the `vite` build tool',\n\t\t\tfix: (p: { tool: string }) =>\n\t\t\t\t`Set \\`build.tool\\` to 'vite' with \\`experimental.enableVite\\`, or remove \\`vite\\` (the build tool is '${p.tool}').`\n\t\t},\n\t\tTSDOWN_CONFIG_FILE_UNSUPPORTED: {\n\t\t\twhy: (p: { file: string; version: number; legacyVersion: number }) => `\\`${p.file}\\` is not used with compatibility version ${p.version}`,\n\t\t\tfix: (p: { file: string; version: number; legacyVersion: number }) =>\n\t\t\t\t`Move its options into \\`tsdown\\` here, drop the ${p.file} configuration, or set \\`future.compatibilityVersion\\` to ${p.legacyVersion}.`\n\t\t},\n\t\tINVALID_TYPE: {\n\t\t\twhy: (p: { path: string; expected: string; value: unknown; fix: string }) =>\n\t\t\t\t`\\`${p.path}\\` must be ${p.expected}, received ${describeValue(p.value)}`,\n\t\t\tfix: (p: { path: string; expected: string; value: unknown; fix: string }) => p.fix\n\t\t},\n\t\tINVALID_COMPATIBILITY_VERSION: {\n\t\t\twhy: (p: { value: unknown; legacyVersion: number; latestVersion: number }) => `Unknown compatibility version ${describeValue(p.value)}`,\n\t\t\tfix: (p: { value: unknown; legacyVersion: number; latestVersion: number }) =>\n\t\t\t\t`Use ${p.legacyVersion} for the legacy build pipeline or ${p.latestVersion} for today's defaults.`\n\t\t},\n\t\tUNKNOWN_OPTION: {\n\t\t\twhy: (p: { path: string; parent: string; known: string }) => `Unknown option \\`${p.path}\\``,\n\t\t\tfix: (p: { path: string; parent: string; known: string }) => `Known options${p.parent ? ` of \\`${p.parent}\\`` : ''}: ${p.known}.`\n\t\t},\n\t\tEXPERIMENT_REQUIRED: {\n\t\t\twhy: (p: { path: string; requires: string; drop: string }) => `\\`${p.path}\\` needs \\`${p.requires}\\``,\n\t\t\tfix: (p: { path: string; requires: string; drop: string }) => `Set \\`${p.requires}\\` to true as well, or drop \\`${p.drop}\\`.`\n\t\t},\n\t\tIMPORTS_REQUIRE_TSDOWN: {\n\t\t\twhy: (_p: {}) => '`imports` requires the `tsdown` build tool',\n\t\t\tfix: (_p: {}) => \"Set `build.tool` to 'tsdown', or remove `imports`/set it to `false`.\"\n\t\t},\n\t\tLOCALES_NOT_FOUND: {\n\t\t\twhy: (p: { locales: string }) => `The locales directory does not exist: ${p.locales}`,\n\t\t\tfix: (_p: { locales: string }) => 'Point `codegen.i18n.locales` to the base locale directory, relative to the project root.'\n\t\t},\n\t\tINVALID_URL: {\n\t\t\twhy: (p: { url: string; fix: string }) => `Invalid URL \"${p.url}\"`,\n\t\t\tfix: (p: { url: string; fix: string }) => p.fix\n\t\t},\n\t\tTUNNEL_URL_NOT_HTTPS: {\n\t\t\twhy: (p: { url: string }) => `The tunnel URL must be https, received \"${p.url}\"`,\n\t\t\tfix: (_p: { url: string }) => 'Discord only accepts an https interactions endpoint.'\n\t\t},\n\t\tINVALID_TYPECHECKER: {\n\t\t\twhy: (p: { checker: string }) => `Unknown type checker \"${p.checker}\"`,\n\t\t\tfix: (_p: { checker: string }) => \"Use one of 'tsc', 'golar', 'tsz' or 'auto'.\"\n\t\t},\n\t\tCONFIG_NOT_FOUND: {\n\t\t\twhy: (p: { file: string; cwd: string; names: string }) => `Configuration file not found: ${p.file}`,\n\t\t\tfix: (p: { file: string; cwd: string; names: string }) => `Pass an existing file to --config, or create one of ${p.names} in ${p.cwd}.`\n\t\t},\n\t\tCONFIG_LOAD_FAILED: {\n\t\t\twhy: (p: { message: string }) => `Failed to load the configuration: ${p.message}`,\n\t\t\tfix: (_p: { message: string }) => 'The file must be valid TypeScript/JavaScript and export the configuration as its default export.'\n\t\t},\n\t\tCONFIG_NOT_OBJECT: {\n\t\t\twhy: (_p: {}) => 'The configuration file must export an object as its default export.',\n\t\t\tfix: (_p: {}) => \"Use `export default defineConfig({ ... })` from '@wolfstar/http-framework/config'.\"\n\t\t}\n\t}\n});\n\nexport type ConfigDiagnosticCode = keyof typeof configDiagnostics;\n\nfunction describeValue(value: unknown): string {\n\tif (value === null) return 'null';\n\tif (Array.isArray(value)) return 'an array';\n\tif (typeof value === 'string') return `\"${value}\"`;\n\treturn typeof value === 'object' ? 'an object' : `${typeof value} ${String(value)}`;\n}\n","import { existsSync, statSync } from 'node:fs';\nimport { basename, dirname, join, resolve } from 'node:path';\nimport type { StarsConfig } from '../../config.js';\nimport { configDiagnostics } from './errors.js';\n\nexport const CONFIG_EXTENSIONS = ['ts', 'mts', 'cts', 'js', 'mjs', 'cjs'] as const;\nexport const CONFIG_FILE_NAMES = CONFIG_EXTENSIONS.map((extension) => `stars.config.${extension}`);\n\nexport interface LoadConfigFileOptions {\n\t/** The directory to discover the configuration file from. */\n\tcwd: string;\n\t/** An explicit configuration file (`--config`), resolved from `cwd`. */\n\tconfigFile?: string | null;\n}\n\nexport interface LoadedConfigFile {\n\t/** The absolute path of the loaded file, `null` when running on defaults. */\n\tconfigFile: string | null;\n\tconfig: StarsConfig;\n}\n\n/**\n * Finds the first `stars.config.*` file in `cwd`, in {@link CONFIG_FILE_NAMES} order.\n */\nexport function discoverConfigFile(cwd: string): string | null {\n\tfor (const name of CONFIG_FILE_NAMES) {\n\t\tconst candidate = join(cwd, name);\n\t\tif (isFile(candidate)) return candidate;\n\t}\n\n\treturn null;\n}\n\n/**\n * Loads the raw configuration object. The loader (`c12`) is imported lazily so\n * commands that never touch the configuration stay fast.\n */\nexport async function loadConfigFile(options: LoadConfigFileOptions): Promise<LoadedConfigFile> {\n\tconst cwd = resolve(options.cwd);\n\tlet file: string | null;\n\n\tif (options.configFile) {\n\t\tfile = resolve(cwd, options.configFile);\n\t\tif (!isFile(file)) {\n\t\t\tthrow configDiagnostics.CONFIG_NOT_FOUND({ file, cwd, names: CONFIG_FILE_NAMES.join(', ') });\n\t\t}\n\t} else {\n\t\tfile = discoverConfigFile(cwd);\n\t\tif (!file) return { configFile: null, config: {} };\n\t}\n\n\tconst { loadConfig } = await import('c12');\n\n\tlet loaded: unknown;\n\ttry {\n\t\tconst result = await loadConfig<StarsConfig>({\n\t\t\tname: 'stars',\n\t\t\tcwd: dirname(file),\n\t\t\tconfigFile: basename(file),\n\t\t\trcFile: false,\n\t\t\tglobalRc: false,\n\t\t\tdotenv: false,\n\t\t\tpackageJson: false,\n\t\t\tdefaults: {}\n\t\t});\n\t\t// c12 merges every layer with the defaults, which turns non-object exports into `{}`: inspect the raw layer.\n\t\tconst layer = result.layers?.find(\n\t\t\t(candidate) => candidate.configFile && resolve(candidate.cwd ?? dirname(file), candidate.configFile) === file\n\t\t);\n\t\tloaded = layer ? layer.config : result.config;\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow configDiagnostics.CONFIG_LOAD_FAILED({ message, cause: error, sources: [file] });\n\t}\n\n\tif (loaded === null || typeof loaded !== 'object' || Array.isArray(loaded)) {\n\t\tthrow configDiagnostics.CONFIG_NOT_OBJECT({ sources: [file] });\n\t}\n\n\treturn { configFile: file, config: loaded as StarsConfig };\n}\n\nfunction isFile(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n","import { existsSync, readFileSync, statSync } from 'node:fs';\nimport { basename, dirname, extname, isAbsolute, join, relative, resolve } from 'node:path';\nimport type { Diagnostic } from 'nostics';\nimport type {\n\tStarsBuildTool,\n\tStarsCompatibilityVersion,\n\tStarsConfig,\n\tStarsDevConfig,\n\tStarsExperimentalConfig,\n\tStarsFutureConfig,\n\tStarsTypechecker\n} from '../../config.js';\nimport { configDiagnostics } from './errors.js';\n\nexport interface PackageJsonLike {\n\tname?: string;\n\t/** `tsdown` reads its options from here as well as from a `tsdown.config.*`. */\n\ttsdown?: unknown;\n\tversion?: string;\n\tmain?: string;\n\ttype?: string;\n\tscripts?: Record<string, string>;\n\tdependencies?: Record<string, string>;\n\tdevDependencies?: Record<string, string>;\n}\n\nexport interface ResolvedBuildConfig {\n\treadonly tool: StarsBuildTool;\n\t/** Absolute output directory. */\n\treadonly outDir: string;\n\t/** Absolute `tsconfig.json` used by `tsc`, `null` for the other tools. */\n\treadonly tsconfig: string | null;\n\t/** Absolute path of the file `node` runs, i.e. the built entry (or the entry itself when `tool` is `none`). */\n\treadonly output: string;\n\t/**\n\t * Absolute path of the build tool's own configuration file (`tsdown.config.*`, `vite.config.*`), `null` when the\n\t * tool has none — which is always the case for `tsdown` with `future.compatibilityVersion` 4, where the build is\n\t * configured from `stars.config` alone.\n\t */\n\treadonly configFile: string | null;\n}\n\nexport interface ResolvedTypecheckConfig {\n\treadonly enabled: boolean;\n\t/** Absolute `tsconfig.json` the type checker runs against, `null` when it could not be found. */\n\treadonly tsconfig: string | null;\n\t/** The type checker to run, with `'auto'` already resolved. */\n\treadonly checker: StarsTypechecker;\n}\n\nexport type ResolvedTunnelConfig =\n\t| { readonly mode: 'off' }\n\t/** A `cloudflared` quick tunnel, whose hostname is only known once it is up. */\n\t| { readonly mode: 'quick'; readonly path: string; readonly updateEndpoint: boolean }\n\t/** An https URL the user already serves. */\n\t| { readonly mode: 'url'; readonly url: string; readonly path: string; readonly updateEndpoint: boolean };\n\nexport interface ResolvedDevConfig {\n\treadonly banner: readonly string[] | false | null;\n\treadonly watch: readonly string[];\n\treadonly ignore: readonly string[];\n\treadonly debounce: number;\n\treadonly env: Readonly<Record<string, string>>;\n\treadonly nodeArgs: readonly string[];\n\treadonly args: readonly string[];\n\treadonly url: string | null;\n\treadonly health: string | null;\n\treadonly killTimeout: number;\n\treadonly typecheck: ResolvedTypecheckConfig;\n\treadonly tunnel: ResolvedTunnelConfig;\n\t/** Absolute path of the file the dev session's logs are mirrored into, `null` when disabled. */\n\treadonly logFile: string | null;\n}\n\nexport interface ResolvedNitroConfig {\n\treadonly preset: string;\n}\n\nexport interface ResolvedExperimentalConfig {\n\treadonly enableVite: boolean;\n\treadonly enableExternalVite: boolean;\n\treadonly enableNitro: boolean;\n\treadonly nitro: ResolvedNitroConfig;\n}\n\nexport interface ResolvedFutureConfig {\n\treadonly compatibilityVersion: StarsCompatibilityVersion;\n}\n\nexport interface ResolvedImportsConfig {\n\treadonly enabled: boolean;\n\t/** Directory glob patterns, relative to the project root (the way `unimport` scans them). */\n\treadonly dirs: readonly string[];\n\treadonly presets: readonly string[];\n\treadonly exclude: readonly string[];\n\t/** Absolute path of the generated declaration file. */\n\treadonly dts: string;\n}\n\nexport interface ResolvedI18nCodegenConfig {\n\treadonly locales: string;\n\treadonly output: string;\n}\n\nexport interface ResolvedCodegenConfig {\n\treadonly i18n: ResolvedI18nCodegenConfig | null;\n}\n\nexport interface ResolvedStarsConfig {\n\t/** Absolute path of the configuration file, `null` when running on defaults. */\n\treadonly configFile: string | null;\n\t/** The directory the CLI was invoked from. */\n\treadonly cwd: string;\n\t/** Absolute project root. */\n\treadonly root: string;\n\treadonly packageJson: PackageJsonLike | null;\n\t/** Absolute source entry. */\n\treadonly entry: string;\n\treadonly build: ResolvedBuildConfig;\n\treadonly dev: ResolvedDevConfig;\n\treadonly codegen: ResolvedCodegenConfig;\n\treadonly imports: ResolvedImportsConfig;\n\treadonly experimental: ResolvedExperimentalConfig;\n\treadonly future: ResolvedFutureConfig;\n\t/** Raw options merged into `vite.config.*`. */\n\treadonly vite: Readonly<Record<string, unknown>>;\n\t/** The `tsdown` build's options: merged over `tsdown.config.*` at compatibility version 3, the whole build at 4. */\n\treadonly tsdown: Readonly<Record<string, unknown>>;\n}\n\nexport interface ResolveConfigOptions {\n\tcwd: string;\n\tconfigFile: string | null;\n\tconfig: StarsConfig;\n\tenv?: NodeJS.ProcessEnv;\n}\n\nexport const DEFAULT_ENTRIES = ['src/main.ts', 'src/main.js', 'src/index.ts', 'src/index.js'] as const;\nexport const DEFAULT_IGNORE = ['**/node_modules/**', '**/dist/**', '**/.git/**'] as const;\nexport const DEFAULT_DEBOUNCE = 150;\nexport const DEFAULT_KILL_TIMEOUT = 5000;\nexport const DEFAULT_NODE_ARGS = ['--enable-source-maps'] as const;\nexport const DEFAULT_DEV_PORT = 3000;\nexport const DEFAULT_I18N_LOCALES = 'src/locales/en-US';\nexport const DEFAULT_I18N_OUTPUT = 'src/@types/i18next.d.ts';\nexport const DEFAULT_IMPORTS_DIRS = ['src/lib/**', 'src/utils/**'] as const;\nexport const DEFAULT_IMPORTS_PRESETS = ['@wolfstar/http-framework', '@wolfstar/env-utilities'] as const;\nexport const DEFAULT_IMPORTS_DTS = '.stars/imports.d.ts';\nexport const DEFAULT_DEV_LOG_FILE = '.stars/dev.log';\nexport const DEFAULT_TUNNEL_PATH = '/';\n\nexport const DEFAULT_COMPATIBILITY_VERSION = 4;\nexport const LEGACY_COMPATIBILITY_VERSION = 3;\nexport const LATEST_COMPATIBILITY_VERSION = 4;\n\nconst COMPATIBILITY_VERSIONS = new Set<number>([LEGACY_COMPATIBILITY_VERSION, LATEST_COMPATIBILITY_VERSION]);\nconst BUILD_TOOLS = new Set<string>(['tsdown', 'tsc', 'none', 'vite', 'auto']);\nconst TYPECHECKERS = new Set<string>(['tsc', 'golar', 'tsz', 'auto']);\nconst VITE_CONFIG_FILES = ['vite.config.ts', 'vite.config.mts', 'vite.config.cts', 'vite.config.js', 'vite.config.mjs', 'vite.config.cjs'];\nconst TSDOWN_CONFIG_FILES = [\n\t'tsdown.config.ts',\n\t'tsdown.config.mts',\n\t'tsdown.config.cts',\n\t'tsdown.config.js',\n\t'tsdown.config.mjs',\n\t'tsdown.config.cjs',\n\t'tsdown.config.json'\n];\nconst TYPESCRIPT_EXTENSIONS = new Set(['.ts', '.mts', '.cts']);\n\n/**\n * Applies defaults, validates every option and resolves all paths to absolute ones.\n *\n * @throws {Diagnostic} (from `nostics`, via {@link configDiagnostics}) with an actionable `fix` on the first invalid option.\n */\nexport function resolveStarsConfig(options: ResolveConfigOptions): ResolvedStarsConfig {\n\tconst cwd = resolve(options.cwd);\n\tconst env = options.env ?? process.env;\n\tconst file = options.configFile;\n\tconst config = options.config;\n\tconst validator = new Validator(file);\n\n\tvalidator.knownKeys(config, '', ['root', 'entry', 'build', 'dev', 'codegen', 'imports', 'experimental', 'future', 'vite', 'tsdown']);\n\tconst baseDirectory = file ? dirname(file) : cwd;\n\n\tconst root = resolve(baseDirectory, validator.string(config.root, 'root') ?? '.');\n\tif (!isDirectory(root)) {\n\t\tthrow validator.error(configDiagnostics.ROOT_NOT_FOUND, { root });\n\t}\n\n\tconst packageJson = readPackageJson(root, validator);\n\tconst experimental = resolveExperimental(config.experimental ?? {}, validator);\n\tconst future = resolveFuture(config.future ?? {}, validator);\n\tconst entry = resolveEntry(root, validator.string(config.entry, 'entry'), validator);\n\t// The tool-specific blocks are read before the build so a project that only declares `tsdown: {}` still resolves\n\t// `build.tool: 'auto'` to `tsdown`: configuring a tool is as clear a signal as depending on it.\n\tconst vite = validator.plainObject(config.vite, 'vite') ?? {};\n\tconst tsdown = validator.plainObject(config.tsdown, 'tsdown') ?? {};\n\tconst build = resolveBuild(root, entry, packageJson, config.build ?? {}, experimental, future, Object.keys(tsdown).length > 0, validator);\n\tconst dev = resolveDev(root, entry, packageJson, config.dev ?? {}, env, validator);\n\tconst codegen = resolveCodegen(root, config.codegen ?? {}, validator);\n\tconst imports = resolveImports(root, build.tool, future, config.imports, validator);\n\n\tif (Object.keys(tsdown).length > 0 && build.tool !== 'tsdown') {\n\t\tthrow validator.error(configDiagnostics.TSDOWN_OPTIONS_REQUIRE_TSDOWN, { tool: build.tool });\n\t}\n\n\tif (Object.keys(vite).length > 0 && build.tool !== 'vite') {\n\t\tthrow validator.error(configDiagnostics.VITE_OPTIONS_REQUIRE_VITE, { tool: build.tool });\n\t}\n\n\treturn { configFile: file, cwd, root, packageJson, entry, build, dev, codegen, imports, experimental, future, vite, tsdown };\n}\n\n/**\n * Presents an absolute path relative to `root` when possible, for display purposes.\n */\nexport function displayPath(root: string, path: string): string {\n\tconst rel = relative(root, path);\n\tif (!rel) return '.';\n\treturn rel.startsWith('..') || isAbsolute(rel) ? path : rel;\n}\n\nfunction resolveEntry(root: string, configured: string | undefined, validator: Validator): string {\n\tif (configured !== undefined) {\n\t\tconst entry = resolve(root, configured);\n\t\tif (!isFile(entry)) {\n\t\t\tthrow validator.error(configDiagnostics.ENTRY_NOT_FOUND, { entry });\n\t\t}\n\t\treturn entry;\n\t}\n\n\tfor (const candidate of DEFAULT_ENTRIES) {\n\t\tconst entry = join(root, candidate);\n\t\tif (isFile(entry)) return entry;\n\t}\n\n\tthrow validator.error(configDiagnostics.ENTRY_DEFAULT_NOT_FOUND, { root, defaults: DEFAULT_ENTRIES.join(', ') });\n}\n\nfunction resolveBuild(\n\troot: string,\n\tentry: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: NonNullable<StarsConfig['build']>,\n\texperimental: ResolvedExperimentalConfig,\n\tfuture: ResolvedFutureConfig,\n\thasTsdownOptions: boolean,\n\tvalidator: Validator\n): ResolvedBuildConfig {\n\tvalidator.knownKeys(config, 'build', ['tool', 'outDir', 'tsconfig']);\n\n\tconst requested = validator.string(config.tool, 'build.tool') ?? 'auto';\n\tif (!BUILD_TOOLS.has(requested)) {\n\t\tthrow validator.error(configDiagnostics.INVALID_BUILD_TOOL, { tool: requested });\n\t}\n\n\tif (requested === 'vite' && !experimental.enableVite) {\n\t\tthrow validator.error(configDiagnostics.EXPERIMENTAL_BUILD_TOOL, { tool: 'vite', flag: 'experimental.enableVite' });\n\t}\n\n\tconst isTypeScriptEntry = TYPESCRIPT_EXTENSIONS.has(extname(entry));\n\tconst tool: StarsBuildTool =\n\t\trequested === 'auto'\n\t\t\t? detectBuildTool(root, packageJson, isTypeScriptEntry, experimental, future, hasTsdownOptions)\n\t\t\t: (requested as StarsBuildTool);\n\n\tif (tool === 'none' && isTypeScriptEntry) {\n\t\tthrow validator.error(configDiagnostics.BUILD_TOOL_REQUIRED, { entry: displayPath(root, entry) });\n\t}\n\n\t// Nitro owns its own output layout; anything else keeps the plain `dist` convention.\n\tconst defaultOutDir = experimental.enableNitro ? '.output' : 'dist';\n\tconst outDir = resolve(root, validator.string(config.outDir, 'build.outDir') ?? defaultOutDir);\n\n\tlet tsconfig: string | null = null;\n\tconst configuredTsconfig = validator.string(config.tsconfig, 'build.tsconfig');\n\tif (configuredTsconfig !== undefined) {\n\t\ttsconfig = resolve(root, configuredTsconfig);\n\t\tif (!isFile(tsconfig)) {\n\t\t\tthrow validator.error(configDiagnostics.TSCONFIG_EXPLICIT_NOT_FOUND, { tsconfig, path: 'build.tsconfig' });\n\t\t}\n\t} else if (tool === 'tsc' || tool === 'tsdown') {\n\t\t// `tsdown` only looks for a `tsconfig.json` next to the project root, so a bot keeping its sources' one in\n\t\t// `src/` (the layout both the scaffold and the examples use) would silently build without its paths and\n\t\t// target. Resolving it here is what makes the `tsdown` build need no configuration of its own.\n\t\ttsconfig = [join(root, 'src', 'tsconfig.json'), join(root, 'tsconfig.json')].find((candidate) => isFile(candidate)) ?? null;\n\t\tif (!tsconfig && tool === 'tsc') {\n\t\t\tthrow validator.error(configDiagnostics.TSCONFIG_NOT_FOUND, { root, suggestion: 'build.tsconfig' });\n\t\t}\n\t}\n\n\t// Nitro always writes its server entry to `<outDir>/server/index.mjs`, regardless of the project's own entry\n\t// file name or `package.json#main` — it is Nitro's output, not a build of the project's own entry file.\n\tconst output = experimental.enableNitro\n\t\t? join(outDir, 'server', 'index.mjs')\n\t\t: tool === 'none'\n\t\t\t? entry\n\t\t\t: resolveBuildOutput(root, entry, outDir, packageJson);\n\n\tlet configFile = findConfigFile(root, tool === 'tsdown' ? TSDOWN_CONFIG_FILES : tool === 'vite' ? VITE_CONFIG_FILES : []);\n\t// `tsdown` reads `package.json#tsdown` when no configuration file is around, so it counts as one here.\n\tif (tool === 'tsdown' && configFile === null && packageJson?.tsdown !== undefined) configFile = join(root, 'package.json');\n\n\t// Compatibility version 4 builds `tsdown` from this file alone. A `tsdown.config.*` left behind would keep the\n\t// plugins and entry points it declares out of the build, so it is reported rather than quietly ignored.\n\tif (tool === 'tsdown' && configFile !== null && future.compatibilityVersion >= LATEST_COMPATIBILITY_VERSION) {\n\t\tthrow validator.error(configDiagnostics.TSDOWN_CONFIG_FILE_UNSUPPORTED, {\n\t\t\tfile: displayPath(root, configFile),\n\t\t\tversion: future.compatibilityVersion,\n\t\t\tlegacyVersion: LEGACY_COMPATIBILITY_VERSION\n\t\t});\n\t}\n\n\treturn { tool, outDir, tsconfig, output, configFile };\n}\n\nfunction findConfigFile(root: string, names: readonly string[]): string | null {\n\tfor (const name of names) {\n\t\tconst candidate = join(root, name);\n\t\tif (isFile(candidate)) return candidate;\n\t}\n\n\treturn null;\n}\n\nfunction detectBuildTool(\n\troot: string,\n\tpackageJson: PackageJsonLike | null,\n\tisTypeScriptEntry: boolean,\n\texperimental: ResolvedExperimentalConfig,\n\tfuture: ResolvedFutureConfig,\n\thasTsdownOptions: boolean\n): StarsBuildTool {\n\t// Vite only wins the detection once the project opted into it; without the flag a `vite.config.*` is somebody\n\t// else's (a dashboard, a docs site) and must not take the bot's build over.\n\tif (experimental.enableVite) {\n\t\tconst hasVite = VITE_CONFIG_FILES.some((name) => isFile(join(root, name))) || hasDependency(packageJson, 'vite');\n\t\tif (hasVite) return 'vite';\n\t}\n\n\tif (hasTsdownOptions) return 'tsdown';\n\n\t// From compatibility version 4 on, `tsdown` is the build of a TypeScript project rather than one of the options:\n\t// there is no `tsdown.config.*` left to detect it from, and a missing dependency is reported by the builder with\n\t// an install hint instead of silently falling back to `tsc`.\n\tif (future.compatibilityVersion >= LATEST_COMPATIBILITY_VERSION) return isTypeScriptEntry ? 'tsdown' : 'none';\n\n\tconst hasTsdown = TSDOWN_CONFIG_FILES.some((name) => isFile(join(root, name))) || hasDependency(packageJson, 'tsdown');\n\tif (hasTsdown) return 'tsdown';\n\tif (isTypeScriptEntry) return 'tsc';\n\treturn 'none';\n}\n\n/**\n * Resolves the Nuxt-style compatibility block. Version 4 is the default; version 3 remains an explicit legacy mode.\n */\nfunction resolveFuture(config: StarsFutureConfig, validator: Validator): ResolvedFutureConfig {\n\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\tthrow validator.typeError('future', 'an object', config, 'Use `{ compatibilityVersion }`.');\n\t}\n\n\tvalidator.knownKeys(config, 'future', ['compatibilityVersion']);\n\tconst version = config.compatibilityVersion;\n\tif (version === undefined) return { compatibilityVersion: DEFAULT_COMPATIBILITY_VERSION };\n\n\tif (typeof version !== 'number' || !COMPATIBILITY_VERSIONS.has(version)) {\n\t\tthrow validator.error(configDiagnostics.INVALID_COMPATIBILITY_VERSION, {\n\t\t\tvalue: version,\n\t\t\tlegacyVersion: LEGACY_COMPATIBILITY_VERSION,\n\t\t\tlatestVersion: LATEST_COMPATIBILITY_VERSION\n\t\t});\n\t}\n\n\treturn { compatibilityVersion: version as StarsCompatibilityVersion };\n}\n\n/**\n * Resolves the `experimental` block. Every flag is a boolean defaulting to `false`, the way Nuxt's own experimental\n * flags are declared, and the ones that build on each other are checked here rather than surfacing later as a\n * confusing runtime failure.\n */\nfunction resolveExperimental(config: StarsExperimentalConfig, validator: Validator): ResolvedExperimentalConfig {\n\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\tthrow validator.typeError('experimental', 'an object', config, 'Use `{ enableVite, enableExternalVite, enableNitro, nitro }`.');\n\t}\n\n\tvalidator.knownKeys(config, 'experimental', ['enableVite', 'enableExternalVite', 'enableNitro', 'nitro']);\n\tconst enableVite = validator.boolean(config.enableVite, 'experimental.enableVite') ?? false;\n\tconst enableExternalVite = validator.boolean(config.enableExternalVite, 'experimental.enableExternalVite') ?? false;\n\tconst enableNitro = validator.boolean(config.enableNitro, 'experimental.enableNitro') ?? false;\n\n\tif (enableExternalVite && !enableVite) {\n\t\tthrow validator.error(configDiagnostics.EXPERIMENT_REQUIRED, {\n\t\t\tpath: 'experimental.enableExternalVite',\n\t\t\trequires: 'experimental.enableVite',\n\t\t\tdrop: 'enableExternalVite'\n\t\t});\n\t}\n\n\tif (enableNitro && !enableVite) {\n\t\tthrow validator.error(configDiagnostics.EXPERIMENT_REQUIRED, {\n\t\t\tpath: 'experimental.enableNitro',\n\t\t\trequires: 'experimental.enableVite',\n\t\t\tdrop: 'enableNitro'\n\t\t});\n\t}\n\n\tconst rawNitro = 'nitro' in config ? config.nitro : undefined;\n\tif (rawNitro !== undefined && !enableNitro) {\n\t\tthrow validator.error(configDiagnostics.EXPERIMENT_REQUIRED, {\n\t\t\tpath: 'experimental.nitro',\n\t\t\trequires: 'experimental.enableNitro',\n\t\t\tdrop: 'nitro'\n\t\t});\n\t}\n\tif (rawNitro !== undefined && (rawNitro === null || typeof rawNitro !== 'object' || Array.isArray(rawNitro))) {\n\t\tthrow validator.typeError('experimental.nitro', 'an object', rawNitro, 'Use `{ preset }`.');\n\t}\n\tif (rawNitro) validator.knownKeys(rawNitro, 'experimental.nitro', ['preset']);\n\tconst preset = validator.string(rawNitro?.preset, 'experimental.nitro.preset') ?? 'node-server';\n\n\treturn { enableVite, enableExternalVite, enableNitro, nitro: { preset } };\n}\n\nfunction resolveBuildOutput(root: string, entry: string, outDir: string, packageJson: PackageJsonLike | null): string {\n\tif (packageJson?.main) return resolve(root, packageJson.main);\n\n\tconst extension = extname(entry);\n\tconst outputExtension = extension === '.mts' ? '.mjs' : extension === '.cts' ? '.cjs' : '.js';\n\treturn join(outDir, `${basename(entry, extension)}${outputExtension}`);\n}\n\nconst ENV_PORT_KEYS = ['HTTP_PORT', 'PORT'] as const;\n\n/**\n * Reads the project's environment layers from `src/.env*` and `.env*` into a plain object, the way `stars dev` and\n * `stars commands` need it:\n * these files are only loaded into `process.env` by the bot itself once it starts (see `@wolfstar/env-utilities`),\n * so by the time the CLI runs they are not there yet. This is a minimal line reader, not a full dotenv\n * implementation — quoting is stripped, but expansion (`dotenv-expand`) is not. Earlier files win, matching\n * dotenv's own precedence.\n */\nexport function readProjectEnvFiles(root: string, environment = 'development'): Record<string, string> {\n\tconst result: Record<string, string> = {};\n\tconst suffixes = [`.${environment}.local`, ...(environment === 'test' ? [] : ['.local']), `.${environment}`, ''];\n\tconst files = suffixes.flatMap((suffix) => [join('src', `.env${suffix}`), `.env${suffix}`]);\n\n\tfor (const file of files) {\n\t\tconst path = join(root, file);\n\t\tif (!isFile(path)) continue;\n\n\t\tlet contents: string;\n\t\ttry {\n\t\t\tcontents = readFileSync(path, 'utf-8');\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const line of contents.split(/\\r?\\n/)) {\n\t\t\tconst match = /^\\s*(?:export\\s+)?([A-Za-z_][A-Za-z0-9_]*)\\s*=\\s*(.*)$/.exec(line);\n\t\t\tif (!match) continue;\n\n\t\t\tconst key = match[1]!;\n\t\t\tif (key in result) continue;\n\t\t\tresult[key] = match[2]!.trim().replace(/^['\"]|['\"]$/g, '');\n\t\t}\n\t}\n\n\treturn result;\n}\n\nfunction readDevPortFromEnvFile(root: string, environment: string): string | null {\n\tconst values = readProjectEnvFiles(root, environment);\n\tfor (const key of ENV_PORT_KEYS) {\n\t\tif (values[key]) return values[key];\n\t}\n\n\treturn null;\n}\n\nfunction resolveDev(\n\troot: string,\n\tentry: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: NonNullable<StarsConfig['dev']>,\n\tenv: NodeJS.ProcessEnv,\n\tvalidator: Validator\n): ResolvedDevConfig {\n\tvalidator.knownKeys(config, 'dev', [\n\t\t'banner',\n\t\t'watch',\n\t\t'ignore',\n\t\t'debounce',\n\t\t'env',\n\t\t'nodeArgs',\n\t\t'args',\n\t\t'url',\n\t\t'health',\n\t\t'killTimeout',\n\t\t'typecheck',\n\t\t'tunnel',\n\t\t'logFile'\n\t]);\n\n\tconst watch = (validator.stringArray(config.watch, 'dev.watch') ?? [displayPath(root, dirname(entry))]).map((path) => resolve(root, path));\n\tconst ignore = validator.stringArray(config.ignore, 'dev.ignore') ?? [...DEFAULT_IGNORE];\n\tconst debounce = validator.nonNegativeNumber(config.debounce, 'dev.debounce') ?? DEFAULT_DEBOUNCE;\n\tconst devEnv = validator.stringRecord(config.env, 'dev.env') ?? {};\n\tconst nodeArgs = validator.stringArray(config.nodeArgs, 'dev.nodeArgs') ?? [...DEFAULT_NODE_ARGS];\n\tconst args = validator.stringArray(config.args, 'dev.args') ?? [];\n\tconst killTimeout = validator.nonNegativeNumber(config.killTimeout, 'dev.killTimeout') ?? DEFAULT_KILL_TIMEOUT;\n\tconst health = validator.string(config.health, 'dev.health') ?? null;\n\n\tlet url = validator.string(config.url, 'dev.url') ?? null;\n\tif (url !== null) {\n\t\ttry {\n\t\t\tnew URL(url);\n\t\t} catch {\n\t\t\tthrow validator.error(configDiagnostics.INVALID_URL, { url, fix: 'Use an absolute URL such as http://localhost:3000.' });\n\t\t}\n\t} else {\n\t\t// Mirrors Vite's and Nuxt's own dev servers: a URL is shown without any configuration. The exact host\n\t\t// (`localhost` vs `127.0.0.1`) is resolved at runtime by `stars dev`, once it knows which one is actually reachable.\n\t\tconst port = devEnv.HTTP_PORT ?? env.HTTP_PORT ?? readDevPortFromEnvFile(root, env.NODE_ENV ?? 'development') ?? String(DEFAULT_DEV_PORT);\n\t\turl = /^\\d+$/.test(port) ? `http://localhost:${port}` : `http://localhost:${DEFAULT_DEV_PORT}`;\n\t}\n\n\tconst typecheck = resolveTypecheck(root, packageJson, config.typecheck, validator);\n\tconst tunnel = resolveTunnel(config.tunnel, validator);\n\tconst logFile = config.logFile === false ? null : resolve(root, validator.string(config.logFile, 'dev.logFile') ?? DEFAULT_DEV_LOG_FILE);\n\tconst banner =\n\t\tconfig.banner === false\n\t\t\t? false\n\t\t\t: typeof config.banner === 'string'\n\t\t\t\t? config.banner.split('\\n')\n\t\t\t\t: (validator.stringArray(config.banner, 'dev.banner') ?? null);\n\n\treturn { watch, ignore, debounce, env: devEnv, nodeArgs, args, url, health, killTimeout, typecheck, tunnel, logFile, banner };\n}\n\n/**\n * Resolves `dev.typecheck`. The tsconfig is looked up the same way the `tsc` build tool looks up its own, so a\n * project building with `tsdown` still gets `tsc --watch --noEmit` on the right project file.\n */\nfunction resolveTypecheck(\n\troot: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: StarsDevConfig['typecheck'],\n\tvalidator: Validator\n): ResolvedTypecheckConfig {\n\tif (config === undefined || config === false) return { enabled: false, tsconfig: null, checker: detectTypechecker(packageJson) };\n\n\tlet configured: string | undefined;\n\tlet requestedChecker = 'auto';\n\tif (config !== true) {\n\t\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\t\tthrow validator.typeError(\n\t\t\t\t'dev.typecheck',\n\t\t\t\t'a boolean or an object',\n\t\t\t\tconfig,\n\t\t\t\t'Use `true` to type-check with the project tsconfig, `{ tsconfig }` to pick one, or `false` to disable it.'\n\t\t\t);\n\t\t}\n\n\t\tvalidator.knownKeys(config, 'dev.typecheck', ['tsconfig', 'checker']);\n\t\tconfigured = validator.string(config.tsconfig, 'dev.typecheck.tsconfig');\n\t\trequestedChecker = validator.string(config.checker, 'dev.typecheck.checker') ?? 'auto';\n\t\tif (!TYPECHECKERS.has(requestedChecker)) {\n\t\t\tthrow validator.error(configDiagnostics.INVALID_TYPECHECKER, { checker: requestedChecker });\n\t\t}\n\t}\n\n\tconst checker: StarsTypechecker = requestedChecker === 'auto' ? detectTypechecker(packageJson) : (requestedChecker as StarsTypechecker);\n\n\tif (configured !== undefined) {\n\t\tconst tsconfig = resolve(root, configured);\n\t\tif (!isFile(tsconfig)) {\n\t\t\tthrow validator.error(configDiagnostics.TSCONFIG_EXPLICIT_NOT_FOUND, { tsconfig, path: 'dev.typecheck.tsconfig' });\n\t\t}\n\t\treturn { enabled: true, tsconfig, checker };\n\t}\n\n\tconst found = [join(root, 'src', 'tsconfig.json'), join(root, 'tsconfig.json')].find((candidate) => isFile(candidate)) ?? null;\n\tif (!found) {\n\t\tthrow validator.error(configDiagnostics.TSCONFIG_NOT_FOUND, { root, suggestion: 'dev.typecheck.tsconfig' });\n\t}\n\n\treturn { enabled: true, tsconfig: found, checker };\n}\n\n/**\n * Picks the type checker when `dev.typecheck.checker` is `auto`: `golar` when the project already depends on it\n * (it wraps TypeScript and is what this repository's own `typecheck` scripts run), `tsc` otherwise. `tsz` is never\n * picked automatically — it is an early, tsc-compatible alternative a project opts into.\n */\nfunction detectTypechecker(packageJson: PackageJsonLike | null): StarsTypechecker {\n\treturn hasDependency(packageJson, 'golar') ? 'golar' : 'tsc';\n}\n\n/**\n * Resolves `dev.tunnel`: `true` (or `{}`) opens a `cloudflared` quick tunnel, a string (or `{ url }`) is an https\n * URL the user already serves and the CLI only checks.\n */\nfunction resolveTunnel(config: StarsDevConfig['tunnel'], validator: Validator): ResolvedTunnelConfig {\n\tif (config === undefined || config === false) return { mode: 'off' };\n\n\tlet url: string | undefined;\n\tlet updateEndpoint = false;\n\tlet path = DEFAULT_TUNNEL_PATH;\n\n\tif (typeof config === 'string') {\n\t\turl = config;\n\t} else if (config !== true) {\n\t\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\t\tthrow validator.typeError(\n\t\t\t\t'dev.tunnel',\n\t\t\t\t'a boolean, an https URL or an object',\n\t\t\t\tconfig,\n\t\t\t\t'Use `true` for a cloudflared quick tunnel, an https URL you already serve, or `false` to disable it.'\n\t\t\t);\n\t\t}\n\n\t\tvalidator.knownKeys(config, 'dev.tunnel', ['url', 'updateEndpoint', 'path']);\n\t\turl = validator.string(config.url, 'dev.tunnel.url');\n\t\tupdateEndpoint = validator.boolean(config.updateEndpoint, 'dev.tunnel.updateEndpoint') ?? false;\n\t\tpath = validator.string(config.path, 'dev.tunnel.path') ?? DEFAULT_TUNNEL_PATH;\n\t}\n\n\tif (url === undefined) return { mode: 'quick', path, updateEndpoint };\n\n\t// Discord only accepts an https interactions endpoint.\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(url);\n\t} catch {\n\t\tthrow validator.error(configDiagnostics.INVALID_URL, { url, fix: 'Use an absolute https URL such as https://bot.example.com.' });\n\t}\n\n\tif (parsed.protocol !== 'https:') {\n\t\tthrow validator.error(configDiagnostics.TUNNEL_URL_NOT_HTTPS, { url });\n\t}\n\n\treturn { mode: 'url', url, path, updateEndpoint };\n}\n\nfunction resolveCodegen(root: string, config: NonNullable<StarsConfig['codegen']>, validator: Validator): ResolvedCodegenConfig {\n\tvalidator.knownKeys(config, 'codegen', ['i18n']);\n\n\tif (config.i18n === false) return { i18n: null };\n\n\tif (config.i18n === undefined) {\n\t\tconst locales = join(root, DEFAULT_I18N_LOCALES);\n\t\treturn { i18n: isDirectory(locales) ? { locales, output: join(root, DEFAULT_I18N_OUTPUT) } : null };\n\t}\n\n\tif (config.i18n === null || typeof config.i18n !== 'object') {\n\t\tthrow validator.typeError(\n\t\t\t'codegen.i18n',\n\t\t\t'an object or `false`',\n\t\t\tconfig.i18n,\n\t\t\t'Use `{ locales, output }` to configure it or `false` to disable it.'\n\t\t);\n\t}\n\n\tvalidator.knownKeys(config.i18n, 'codegen.i18n', ['locales', 'output']);\n\tconst locales = resolve(root, validator.string(config.i18n.locales, 'codegen.i18n.locales') ?? DEFAULT_I18N_LOCALES);\n\tif (!isDirectory(locales)) {\n\t\tthrow validator.error(configDiagnostics.LOCALES_NOT_FOUND, { locales });\n\t}\n\n\tconst output = resolve(root, validator.string(config.i18n.output, 'codegen.i18n.output') ?? DEFAULT_I18N_OUTPUT);\n\treturn { i18n: { locales, output } };\n}\n\n/**\n * The transform that injects auto imports (`@wolfstar/http-framework/auto-imports`) only runs through `tsdown`'s\n * rolldown pipeline, the same way Nuxt's own auto imports only run through its Vite/webpack build: `tsc` and `none`\n * have no transform step to hook into. `tsdown` is picked as `build.tool` first (see {@link detectBuildTool}) for the\n * same reason — it is the only tool this feature, and this build config in general, treats as the default choice.\n *\n * They are on by default from compatibility version 4 on, where `stars` wires the plugin into the build itself. At 3\n * the plugin is the project's to add, so defaulting them on would promise imports that never get injected.\n */\nfunction resolveImports(\n\troot: string,\n\tbuildTool: StarsBuildTool,\n\tfuture: ResolvedFutureConfig,\n\tconfig: StarsConfig['imports'],\n\tvalidator: Validator\n): ResolvedImportsConfig {\n\tconst defaultDirs = DEFAULT_IMPORTS_DIRS.map((dir) => resolve(root, dir));\n\tconst defaultPresets = [...DEFAULT_IMPORTS_PRESETS];\n\tconst defaultDts = resolve(root, DEFAULT_IMPORTS_DTS);\n\n\tif (config === false) {\n\t\treturn { enabled: false, dirs: defaultDirs, presets: defaultPresets, exclude: [], dts: defaultDts };\n\t}\n\n\tconst forcedOn = config === true;\n\tconst options = forcedOn || config === undefined ? {} : config;\n\tif (typeof options !== 'object' || options === null || Array.isArray(options)) {\n\t\tthrow validator.typeError(\n\t\t\t'imports',\n\t\t\t'an object, `true` or `false`',\n\t\t\toptions,\n\t\t\t'Use `{ dirs, presets, exclude, dts }`, `true` to enable with defaults, or `false` to disable.'\n\t\t);\n\t}\n\n\tvalidator.knownKeys(options, 'imports', ['enabled', 'dirs', 'presets', 'exclude', 'dts']);\n\n\tconst requestedOn = forcedOn || validator.boolean(options.enabled, 'imports.enabled');\n\tif (requestedOn && buildTool !== 'tsdown') {\n\t\tthrow validator.error(configDiagnostics.IMPORTS_REQUIRE_TSDOWN, {});\n\t}\n\n\tconst dirs = (validator.stringArray(options.dirs, 'imports.dirs') ?? [...DEFAULT_IMPORTS_DIRS]).map((dir) => resolve(root, dir));\n\tconst presets = validator.stringArray(options.presets, 'imports.presets') ?? defaultPresets;\n\tconst exclude = validator.stringArray(options.exclude, 'imports.exclude') ?? [];\n\tconst dts = resolve(root, validator.string(options.dts, 'imports.dts') ?? DEFAULT_IMPORTS_DTS);\n\n\tconst enabledByDefault = buildTool === 'tsdown' && future.compatibilityVersion >= LATEST_COMPATIBILITY_VERSION;\n\treturn { enabled: requestedOn ?? enabledByDefault, dirs, presets, exclude, dts };\n}\n\nclass Validator {\n\tpublic constructor(private readonly file: string | null) {}\n\n\tprivate get sources(): string[] | undefined {\n\t\treturn this.file ? [this.file] : undefined;\n\t}\n\n\tpublic error<Handle extends (params: any) => Diagnostic>(handle: Handle, params: Parameters<Handle>[0]): Diagnostic {\n\t\treturn handle({ ...params, sources: this.sources });\n\t}\n\n\tpublic knownKeys(value: object, path: string, keys: readonly string[]): void {\n\t\tfor (const key of Object.keys(value)) {\n\t\t\tif (keys.includes(key)) continue;\n\t\t\tconst fullPath = path ? `${path}.${key}` : key;\n\t\t\tthrow this.error(configDiagnostics.UNKNOWN_OPTION, { path: fullPath, parent: path, known: keys.join(', ') });\n\t\t}\n\t}\n\n\tpublic string(value: unknown, path: string): string | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'string' || value.length === 0) throw this.typeError(path, 'a non-empty string', value);\n\t\treturn value;\n\t}\n\n\tpublic boolean(value: unknown, path: string): boolean | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'boolean') throw this.typeError(path, 'a boolean', value);\n\t\treturn value;\n\t}\n\n\t/** A plain object passed through as-is (e.g. raw `vite`/`tsdown` config merged into the project's own). */\n\tpublic plainObject(value: unknown, path: string): Record<string, unknown> | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (value === null || typeof value !== 'object' || Array.isArray(value)) throw this.typeError(path, 'an object', value);\n\t\treturn value as Record<string, unknown>;\n\t}\n\n\tpublic stringArray(value: unknown, path: string): string[] | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (!Array.isArray(value) || !value.every((item) => typeof item === 'string')) throw this.typeError(path, 'an array of strings', value);\n\t\treturn value;\n\t}\n\n\tpublic nonNegativeNumber(value: unknown, path: string): number | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value) || value < 0) throw this.typeError(path, 'a non-negative number', value);\n\t\treturn value;\n\t}\n\n\tpublic stringRecord(value: unknown, path: string): Record<string, string> | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (value === null || typeof value !== 'object' || Array.isArray(value) || !Object.values(value).every((item) => typeof item === 'string')) {\n\t\t\tthrow this.typeError(path, 'an object of string values', value);\n\t\t}\n\t\treturn value as Record<string, string>;\n\t}\n\n\t/** A generic \"wrong type\" diagnostic. `fix` defaults to the standard \"set it or remove it\" wording. */\n\tpublic typeError(path: string, expected: string, value: unknown, fix?: string): Diagnostic {\n\t\treturn this.error(configDiagnostics.INVALID_TYPE, {\n\t\t\tpath,\n\t\t\texpected,\n\t\t\tvalue,\n\t\t\tfix: fix ?? `Set \\`${path}\\` to ${expected} or remove it to use the default.`\n\t\t});\n\t}\n}\n\nfunction hasDependency(packageJson: PackageJsonLike | null, name: string): boolean {\n\treturn Boolean(packageJson?.dependencies?.[name] ?? packageJson?.devDependencies?.[name]);\n}\n\nfunction readPackageJson(root: string, validator: Validator): PackageJsonLike | null {\n\tconst file = join(root, 'package.json');\n\tif (!isFile(file)) return null;\n\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(readFileSync(file, 'utf-8'));\n\t\treturn parsed !== null && typeof parsed === 'object' ? (parsed as PackageJsonLike) : null;\n\t} catch (error) {\n\t\tthrow validator.error(configDiagnostics.PACKAGE_JSON_INVALID, {\n\t\t\tfile,\n\t\t\tmessage: error instanceof Error ? error.message : String(error),\n\t\t\tcause: error\n\t\t});\n\t}\n}\n\nfunction isFile(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isDirectory(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n","import { loadConfigFile } from './load.js';\nimport { resolveStarsConfig, type ResolvedStarsConfig } from './resolve.js';\n\nexport interface LoadStarsConfigOptions {\n\t/**\n\t * The directory to discover `stars.config.*` from.\n\t * @default process.cwd()\n\t */\n\tcwd?: string;\n\t/** An explicit configuration file, resolved from `cwd`. */\n\tconfigFile?: string | null;\n\t/**\n\t * Environment used for defaults such as `HTTP_PORT`.\n\t * @default process.env\n\t */\n\tenv?: NodeJS.ProcessEnv;\n}\n\n/**\n * Loads, validates and resolves a project's `stars.config.*`.\n *\n * @throws {Diagnostic} (from `nostics`, via {@link configDiagnostics}) when the configuration file cannot be loaded or contains an invalid option.\n */\nexport async function loadStarsConfig(options: LoadStarsConfigOptions = {}): Promise<ResolvedStarsConfig> {\n\tconst cwd = options.cwd ?? process.cwd();\n\tconst loaded = await loadConfigFile({ cwd, configFile: options.configFile });\n\treturn resolveStarsConfig({ cwd, configFile: loaded.configFile, config: loaded.config, env: options.env });\n}\n\nexport { CONFIG_EXTENSIONS, CONFIG_FILE_NAMES, discoverConfigFile, loadConfigFile } from './load.js';\nexport type { LoadConfigFileOptions, LoadedConfigFile } from './load.js';\nexport { configDiagnostics } from './errors.js';\nexport type { ConfigDiagnosticCode } from './errors.js';\nexport { displayPath, readProjectEnvFiles, resolveStarsConfig } from './resolve.js';\nexport type {\n\tPackageJsonLike,\n\tResolveConfigOptions,\n\tResolvedBuildConfig,\n\tResolvedCodegenConfig,\n\tResolvedDevConfig,\n\tResolvedExperimentalConfig,\n\tResolvedFutureConfig,\n\tResolvedNitroConfig,\n\tResolvedI18nCodegenConfig,\n\tResolvedImportsConfig,\n\tResolvedStarsConfig,\n\tResolvedTunnelConfig,\n\tResolvedTypecheckConfig\n} from './resolve.js';\n","/**\n * Public, side-effect free configuration surface of `@wolfstar/cli`.\n *\n * This module is intentionally tiny: importing it from a `stars.config.ts`\n * file must never start the bot nor pull the heavy runtime of the CLI.\n *\n * @module @wolfstar/http-framework/config\n */\n\n/**\n * The build tool used to turn the project sources into runnable JavaScript.\n *\n * - `tsdown`: run the project's own `tsdown` programmatically, configured from {@link StarsConfig.tsdown} (and, with\n *   {@link StarsFutureConfig.compatibilityVersion} `3`, from the project's `tsdown.config.*` too).\n * - `tsc`: run the project's `tsc -b` on the configured `tsconfig`.\n * - `vite`: run the project's own `vite` (configuration file included), requires `experimental.enableVite`.\n * - `none`: the entry is runnable as-is (JavaScript projects), no build step.\n * - `auto`: detect from the project (default).\n */\nexport type StarsBuildTool = 'tsdown' | 'tsc' | 'none' | 'vite';\n\nexport interface StarsBuildConfig {\n\t/**\n\t * The build tool to use.\n\t * @default 'auto'\n\t */\n\ttool?: StarsBuildTool | 'auto';\n\t/**\n\t * The directory, relative to {@link StarsConfig.root}, the build writes into.\n\t * @default 'dist', or '.output' when `experimental.enableNitro` is on (Nitro's own convention)\n\t */\n\toutDir?: string;\n\t/**\n\t * The `tsconfig.json` the `tsc` and `tsdown` build tools use, relative to {@link StarsConfig.root}.\n\t * @default 'src/tsconfig.json' when it exists, 'tsconfig.json' otherwise\n\t */\n\ttsconfig?: string;\n}\n\n/**\n * Raw options merged into the project's own `vite.config.*`, the way `vite: {}` in a Nuxt config is merged into\n * Nuxt's own Vite config. Kept as `unknown` here (the CLI, not the framework, depends on `vite`'s types) and passed\n * to Vite's `mergeConfig` as-is.\n */\nexport type StarsViteConfig = Record<string, unknown>;\n\n/**\n * Options for `tsdown`, the bundler `stars build` uses by default.\n *\n * With {@link StarsFutureConfig.compatibilityVersion} `4` these replace `tsdown.config.*` outright: the build is\n * derived from `stars.config` (the entry's directory, `build.outDir`, `build.tsconfig`) and these options are layered\n * on top, so a project keeps one configuration file instead of two. With `3` the project's own `tsdown.config.*` is\n * still loaded and these are merged over it, the way `vite: {}` in a Nuxt config is merged into the project's own\n * Vite config: values here win, and `plugins` are appended rather than replaced.\n *\n * The options named below are the ones a bot usually reaches for. Every other `tsdown` option is accepted as-is —\n * the framework does not depend on `tsdown`, so they stay loosely typed here and `tsdown`'s own `UserConfig` is the\n * reference.\n */\nexport interface StarsTsdownConfig {\n\t/** Entry files or glob patterns, relative to the project root. Defaults to every source file next to `entry`. */\n\tentry?: string | readonly string[] | Record<string, string>;\n\t/** @default 'esm' */\n\tformat?: 'esm' | 'cjs' | 'iife' | 'umd' | readonly string[] | Record<string, unknown>;\n\t/** @default 'node' */\n\tplatform?: 'node' | 'neutral' | 'browser';\n\ttarget?: string | readonly string[] | false;\n\t/**\n\t * Emits one output file per source file instead of a single bundle, so pieces stay loadable from `dist/commands`\n\t * and friends at runtime.\n\t * @default true\n\t */\n\tunbundle?: boolean;\n\t/** Rolldown plugins. Appended to the ones `stars` adds (auto imports) and to those of a `tsdown.config.*`. */\n\tplugins?: readonly unknown[];\n\talias?: Record<string, string>;\n\tdefine?: Record<string, string>;\n\texternal?: unknown;\n\tnoExternal?: unknown;\n\tdeps?: Record<string, unknown>;\n\t/** @default () => ({ js: extname(build.output) }) */\n\toutExtensions?: unknown;\n\t/** @default true */\n\tsourcemap?: boolean | 'inline' | 'hidden';\n\tminify?: unknown;\n\t/** @default false — a bot is not a library, so no declaration files are emitted. */\n\tdts?: boolean | Record<string, unknown>;\n\t/** @default true */\n\tclean?: boolean | readonly string[];\n\ttreeshake?: boolean;\n\tcopy?: unknown;\n\thooks?: Record<string, unknown>;\n\t[option: string]: unknown;\n}\n\n/**\n * The build-default generation the project runs on. Version 4 is current; version 3 remains available for projects\n * that still load a standalone `tsdown.config.*`.\n */\nexport type StarsCompatibilityVersion = 3 | 4;\n\n/**\n * Nuxt-style compatibility block. New projects need not set it; version 3 is retained as an explicit migration\n * escape hatch for projects that still use a standalone `tsdown.config.*`.\n */\nexport interface StarsFutureConfig {\n\t/**\n\t * The major whose defaults apply.\n\t *\n\t * `4` is the default build pipeline:\n\t * - auto imports are on by default with the `tsdown` build tool ({@link StarsImportsConfig}), and the\n\t *   `autoImports()` plugin is wired into the build by `stars` itself.\n\t * - `tsdown` is configured from {@link StarsConfig.tsdown} only. A `tsdown.config.*` in the project root is\n\t *   rejected rather than silently ignored, so a build never loses the plugins it declares.\n\t * - `build.tool: 'auto'` resolves to `tsdown` for any TypeScript entry, without looking for a `tsdown.config.*`\n\t *   or a `tsdown` dependency first.\n\t *\n\t * `3` keeps the legacy behaviour: auto imports off unless asked for, and a `tsdown.config.*` loaded and merged with\n\t * {@link StarsConfig.tsdown}.\n\t * @default 4\n\t */\n\tcompatibilityVersion?: StarsCompatibilityVersion;\n}\n\n/**\n * The type checker `stars dev` runs next to the bot.\n *\n * - `tsc`: the project's own TypeScript, in watch mode.\n * - `golar`: the project's `golar`, forwarding to TypeScript (`golar tsc`), in watch mode.\n * - `tsz`: the project's `tsz` (or `try-tsz`). It has no watch mode, so it is re-run after every build instead.\n * - `auto`: `golar` when the project depends on it, `tsc` otherwise (default).\n */\nexport type StarsTypechecker = 'tsc' | 'golar' | 'tsz';\n\nexport interface StarsTypecheckConfig {\n\t/**\n\t * The `tsconfig.json` the type checker runs against, relative to {@link StarsConfig.root}.\n\t * @default the build tool's tsconfig, 'src/tsconfig.json' or 'tsconfig.json'\n\t */\n\ttsconfig?: string;\n\t/**\n\t * Which type checker to run.\n\t * @default 'auto'\n\t */\n\tchecker?: StarsTypechecker | 'auto';\n}\n\nexport interface StarsTunnelConfig {\n\t/**\n\t * An https URL you already serve; when unset a `cloudflared` quick tunnel is opened instead.\n\t */\n\turl?: string;\n\t/**\n\t * Writes the tunnel's URL to the Discord application's `interactions_endpoint_url` when it changes.\n\t *\n\t * This edits a live Discord application, so it is opt-in: it needs `DISCORD_TOKEN` and `DISCORD_APPLICATION_ID`\n\t * (or `APPLICATION_ID`) in the environment or the project's `.env`.\n\t * @default false\n\t */\n\tupdateEndpoint?: boolean;\n\t/**\n\t * The path the interactions endpoint is served on, appended to the tunnel URL.\n\t * @default '/'\n\t */\n\tpath?: string;\n}\n\nexport interface StarsDevConfig {\n\t/** Custom terminal wordmark (one or more lines), or `false` to hide it. Defaults to the Stars wordmark. */\n\tbanner?: string | readonly string[] | false;\n\t/**\n\t * Extra paths to watch, relative to {@link StarsConfig.root}. Only used when\n\t * the build tool is `none`; `tsdown` and `tsc` watch through their own build.\n\t * @default [dirname(entry)]\n\t */\n\twatch?: string[];\n\t/**\n\t * Glob patterns or paths to ignore while watching, relative to {@link StarsConfig.root}.\n\t * @default ['**\\/node_modules/**', '**\\/dist/**', '**\\/.git/**']\n\t */\n\tignore?: string[];\n\t/**\n\t * Milliseconds to wait after a change before restarting the bot.\n\t * @default 150\n\t */\n\tdebounce?: number;\n\t/**\n\t * Environment variables added to the bot process.\n\t */\n\tenv?: Record<string, string>;\n\t/**\n\t * Arguments passed to `node` before the entry file.\n\t * @default ['--enable-source-maps']\n\t */\n\tnodeArgs?: string[];\n\t/**\n\t * Arguments passed to the bot after the entry file.\n\t * @default []\n\t */\n\targs?: string[];\n\t/**\n\t * The URL the bot listens on, shown in the dev UI's status line and used for {@link StarsDevConfig.health}.\n\t *\n\t * Resolved automatically, the way Vite's and Nuxt's dev servers do, from (in order) `dev.env.HTTP_PORT`, the\n\t * process's `HTTP_PORT`, the project's `src/.env*`/`.env*` (`HTTP_PORT` or `PORT`), or `3000`. `stars dev` also\n\t * resolves whether `localhost` should be shown as `127.0.0.1` instead, the same DNS-order check Vite does, so the\n\t * printed URL is always the one that is actually reachable.\n\t * @default `http://localhost:3000` (or whichever port is found)\n\t */\n\turl?: string;\n\t/**\n\t * A path, relative to {@link StarsDevConfig.url}, polled to report the bot's health in the dev UI.\n\t * When unset the dev UI only reports process state.\n\t */\n\thealth?: string;\n\t/**\n\t * Milliseconds to wait for the bot to exit after `SIGTERM` before killing it.\n\t * @default 5000\n\t */\n\tkillTimeout?: number;\n\t/**\n\t * Runs a type checker next to the bot and reports type errors on the dev UI's `tsc` channel, without blocking\n\t * builds or restarts. `true` uses the project's own tsconfig and type checker, an object picks either\n\t * ({@link StarsTypecheckConfig.checker}).\n\t * @default false\n\t */\n\ttypecheck?: boolean | StarsTypecheckConfig;\n\t/**\n\t * Exposes the bot's HTTP interactions endpoint publicly while `stars dev` runs, so Discord can reach it.\n\t *\n\t * `true` opens a `cloudflared` quick tunnel (its hostname changes on every run), a string is an https URL you\n\t * already serve yourself (named tunnel, reverse proxy, …) that the CLI only checks for reachability.\n\t * @default false\n\t */\n\ttunnel?: boolean | string | StarsTunnelConfig;\n\t/**\n\t * The file `stars dev` mirrors its logs into, relative to {@link StarsConfig.root}, so a session can be read back\n\t * after the terminal UI is gone. `false` disables it.\n\t * @default '.stars/dev.log'\n\t */\n\tlogFile?: string | false;\n}\n\nexport interface StarsI18nCodegenConfig {\n\t/**\n\t * The base locale directory, relative to {@link StarsConfig.root}.\n\t * @default 'src/locales/en-US'\n\t */\n\tlocales?: string;\n\t/**\n\t * The generated declaration file, relative to {@link StarsConfig.root}.\n\t * @default 'src/@types/i18next.d.ts'\n\t */\n\toutput?: string;\n}\n\nexport interface StarsCodegenConfig {\n\t/**\n\t * i18next type generation through `@wolfstar/i18next-type-generator`.\n\t * `false` disables it, an object enables it, unset auto-detects from the presence of the locales directory.\n\t */\n\ti18n?: StarsI18nCodegenConfig | false;\n}\n\nexport interface StarsImportsConfig {\n\t/**\n\t * Whether auto imports are enabled. Requires the `tsdown` build tool: the imports are injected at build time by\n\t * the `autoImports()` plugin from `@wolfstar/http-framework/auto-imports`, which the other tools cannot run.\n\t * @default true when the build tool is 'tsdown', false otherwise\n\t */\n\tenabled?: boolean;\n\t/**\n\t * Directories, relative to {@link StarsConfig.root}, whose exported values are auto-importable. Entries are glob\n\t * path patterns: `'src/lib'` scans only the files directly inside it, `'src/lib/**'` scans recursively.\n\t * @default ['src/lib/**', 'src/utils/**']\n\t */\n\tdirs?: string[];\n\t/**\n\t * Packages whose exports are auto-importable. Packages that are not installed are skipped.\n\t * @default ['@wolfstar/http-framework', '@wolfstar/env-utilities']\n\t */\n\tpresets?: string[];\n\t/**\n\t * Export names excluded from auto imports, e.g. to avoid clashes with project-local names.\n\t * @default []\n\t */\n\texclude?: string[];\n\t/**\n\t * The generated declaration file that types the auto imports, relative to {@link StarsConfig.root}.\n\t * Include it in the project's tsconfig and add its directory to .gitignore.\n\t * @default '.stars/imports.d.ts'\n\t */\n\tdts?: string;\n}\n\n/**\n * The [Nitro preset](https://nitro.build/deploy) `stars build` targets, only reachable once\n * {@link StarsExperimentalConfig.enableNitro} (itself gated on {@link StarsExperimentalConfig.enableVite}) is `true`\n * — see {@link StarsExperimentalConfig}.\n */\nexport interface StarsNitroConfig {\n\t/**\n\t * `'node-server'` (the default, runs locally with plain `node`), `'cloudflare-module'`, `'aws-lambda'`,\n\t * `'vercel'`, `'netlify'`, `'bun'`, `'deno-deploy'`, and more — see Nitro's own preset list.\n\t * @default 'node-server'\n\t */\n\tpreset?: string;\n}\n\n/**\n * Opt-in flags for work that is still landing, in the shape Nuxt's own `experimental` block has: every flag is a\n * boolean, defaults to `false`, and is documented with what it changes and what it still needs. A flag stays here\n * until the behaviour it guards is the default (or is dropped), so enabling one is a statement that breakage is\n * acceptable in exchange for the feature.\n *\n * `enableExternalVite`, `enableNitro` and `nitro` build on `enableVite` (and `nitro` on `enableNitro` too): the type\n * only accepts them once their prerequisite is `true`, so turning one on without the other is a type error here\n * instead of a diagnostic at load time.\n */\nexport type StarsExperimentalConfig =\n\t| { enableVite?: false; enableExternalVite?: false; enableNitro?: false }\n\t| {\n\t\t\t/**\n\t\t\t * Uses Vite as the project's build tool, in place of `tsdown`. `build.tool` may then be set to `'vite'`\n\t\t\t * (and `'auto'` detects a `vite.config.*`); the bot keeps calling `client.listen()` and running as a\n\t\t\t * plain `node:http` process, restarted on every change — this only swaps the bundler.\n\t\t\t */\n\t\t\tenableVite: true;\n\t\t\t/**\n\t\t\t * Runs the bot through Vite itself, the way `nuxt dev` runs on Vite's own dev server: instead of\n\t\t\t * building then restarting a child `node` process on every change, `stars dev` loads the entry through\n\t\t\t * Vite's SSR module graph and serves it — through `@wolfstar/http-framework/fetch`'s\n\t\t\t * `createFetchHandler` — from one long-lived process, invalidating and re-evaluating just the entry's\n\t\t\t * module graph on a change instead of restarting.\n\t\t\t *\n\t\t\t * With this on, the entry's default export must be the `Client` instance (already `load()`ed, not\n\t\t\t * `listen()`ed) rather than a script that calls `client.listen()` itself — `stars dev` owns the socket.\n\t\t\t * @default false\n\t\t\t */\n\t\t\tenableExternalVite?: boolean;\n\t\t\tenableNitro?: false;\n\t  }\n\t| {\n\t\t\tenableVite: true;\n\t\t\tenableExternalVite?: boolean;\n\t\t\t/**\n\t\t\t * Builds the bot through [Nitro](https://nitro.build) instead of a `node:http` server, so `stars build`\n\t\t\t * produces a server deployable to any of Nitro's presets (`node-server` locally, `cloudflare-module`,\n\t\t\t * `aws-lambda`, `vercel`, `netlify`, `bun`, `deno-deploy`, and more) from the same\n\t\t\t * `@wolfstar/http-framework/fetch` handler `enableExternalVite` already runs in dev — no per-platform\n\t\t\t * adapter to maintain.\n\t\t\t *\n\t\t\t * Output goes to `.output/` (Nitro's own convention) instead of `build.outDir`. The entry's default\n\t\t\t * export must be the `Client` instance, the same as `enableExternalVite`.\n\t\t\t */\n\t\t\tenableNitro: true;\n\t\t\t/** Nitro-specific options, reachable only with `enableNitro: true`. */\n\t\t\tnitro?: StarsNitroConfig;\n\t  };\n\nexport interface StarsConfig {\n\t/**\n\t * The project root. Relative paths are resolved from the configuration file.\n\t * @default dirname(configFile)\n\t */\n\troot?: string;\n\t/**\n\t * The source entry point of the bot, relative to {@link StarsConfig.root}.\n\t * @default the first of 'src/main.ts', 'src/main.js', 'src/index.ts', 'src/index.js' that exists\n\t */\n\tentry?: string;\n\tbuild?: StarsBuildConfig;\n\tdev?: StarsDevConfig;\n\tcodegen?: StarsCodegenConfig;\n\t/**\n\t * Nuxt-style auto imports of the framework's exports and the project's own modules.\n\t * `false` disables them, `true` forces them on (requires the `tsdown` build tool). On by default with\n\t * `future.compatibilityVersion: 4`.\n\t */\n\timports?: StarsImportsConfig | boolean;\n\t/** Opt-in flags for behaviour that is still landing. */\n\texperimental?: StarsExperimentalConfig;\n\t/** Build-default compatibility. Omit for version 4; set version 3 only while migrating a standalone tsdown config. */\n\tfuture?: StarsFutureConfig;\n\t/**\n\t * Raw options merged into `vite.config.*`, the way `vite: {}` in a Nuxt config is merged into Nuxt's own Vite\n\t * config. Only used with `build.tool: 'vite'` (see `experimental.enableVite`).\n\t */\n\tvite?: StarsViteConfig;\n\t/**\n\t * The project's `tsdown` build. Replaces `tsdown.config.*` with `future.compatibilityVersion: 4`, and is merged\n\t * over it with `3`. Only used with `build.tool: 'tsdown'`.\n\t */\n\ttsdown?: StarsTsdownConfig;\n}\n\n/**\n * Typed helper for `stars.config.{ts,mts,cts,js,mjs,cjs}` files.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@wolfstar/http-framework/config';\n *\n * export default defineConfig({\n * \tentry: 'src/main.ts',\n * \tbuild: { tool: 'tsdown' }\n * });\n * ```\n */\nexport function defineConfig(config: StarsConfig): StarsConfig {\n\treturn config;\n}\n\nexport * from './lib/config/index.js';\n"],"mappings":"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"}

package/dist/esm/fetch.js

@@ -1,5 +1,4 @@
-import { t as _defineProperty } from "./defineProperty-DeZQsruP.js";
-import { i as _classPrivateFieldGet2, o as _classPrivateFieldInitSpec, r as _classPrivateFieldSet2, t as makeKey } from "./security-pO7x9isF.js";
+import { c as _defineProperty, i as _classPrivateFieldGet2, o as _classPrivateFieldInitSpec, r as _classPrivateFieldSet2, t as makeKey } from "./security-CDI6548c.js";
 import { EventEmitter } from "node:events";
 import { Readable } from "node:stream";
 

package/dist/esm/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","names":[],"sources":["../../src/fetch.ts"],"sourcesContent":["/**\n * Fetch (Web `Request`/`Response`) entry point for `@wolfstar/http-framework`, so a bot can be served by anything\n * that speaks Fetch — Vite's dev middleware, Nitro, Cloudflare Workers, `Bun.serve`, `Deno.serve` — instead of only\n * `Client#listen()`'s own `node:http` server.\n *\n * @module @wolfstar/http-framework/fetch\n */\nimport type { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'node:http';\nimport { EventEmitter } from 'node:events';\nimport { Readable } from 'node:stream';\nimport type { Client } from './lib/Client.js';\nimport { makeKey, type Key } from './lib/utils/security.js';\n\nexport interface FetchHandlerOptions {\n\t/**\n\t * The bot's Discord public key, used to verify interaction signatures.\n\t * @default process.env.DISCORD_PUBLIC_KEY\n\t */\n\tdiscordPublicKey?: string;\n\t/**\n\t * The path interactions are posted to.\n\t * @default process.env.HTTP_POST_PATH ?? '/'\n\t */\n\tpostPath?: string;\n}\n\nexport type FetchHandler = (request: Request) => Promise<Response>;\n\ntype Dispatch = (request: IncomingMessage, response: ServerResponse, path: string, key: Key) => Promise<ServerResponse>;\n\n/**\n * Wraps `Client`'s own dispatch — signature verification, routing, replies, the exact same code `listen()` runs —\n * behind a Fetch handler, by bridging a `Request` to the `IncomingMessage`/`ServerResponse` shape it expects.\n *\n * This changes nothing about the framework's internals: `handleRawHttpMessage` is `protected`, not private, and is\n * called here exactly as `Client#listen()` calls it on every request. `Client` never has to know which transport\n * (`node:http`, Vite, Nitro, a Worker) produced the request.\n */\nexport async function createFetchHandler(client: Client, options: FetchHandlerOptions = {}): Promise<FetchHandler> {\n\tconst discordPublicKey = options.discordPublicKey ?? process.env.DISCORD_PUBLIC_KEY;\n\tif (!discordPublicKey) throw new Error('The discordPublicKey cannot be empty');\n\n\tconst key = await makeKey(discordPublicKey);\n\tconst path = options.postPath ?? process.env.HTTP_POST_PATH ?? '/';\n\tconst dispatch = (client as unknown as { handleRawHttpMessage: Dispatch }).handleRawHttpMessage.bind(client);\n\n\treturn async (request: Request): Promise<Response> => {\n\t\tconst incoming = toIncomingMessage(request);\n\t\tconst outgoing = new FetchServerResponse();\n\t\tawait dispatch(incoming, outgoing as unknown as ServerResponse, path, key);\n\t\treturn outgoing.toResponse();\n\t};\n}\n\nfunction toIncomingMessage(request: Request): IncomingMessage {\n\tconst headers: IncomingHttpHeaders = {};\n\trequest.headers.forEach((value, name) => {\n\t\theaders[name] = value;\n\t});\n\n\tconst body = request.body ? Readable.fromWeb(request.body as never) : Readable.from([]);\n\treturn Object.assign(body, { url: new URL(request.url).pathname, method: request.method, headers }) as unknown as IncomingMessage;\n}\n\n/**\n * The minimum of `http.ServerResponse` `Client`'s dispatch touches: `setHeader`, `statusCode`, `end`,\n * `writableEnded`, and a `'close'` event once the response is done (`BaseInteraction`'s `_sendReply` awaits it\n * before resolving, so a caller here has to fire it too, or every reply would hang forever).\n */\nclass FetchServerResponse extends EventEmitter {\n\tpublic statusCode = 200;\n\tpublic writableEnded = false;\n\tpublic closed = false;\n\treadonly #headers = new Headers();\n\t#body: string | undefined;\n\n\tpublic setHeader(name: string, value: string): void {\n\t\tthis.#headers.set(name, value);\n\t}\n\n\tpublic end(chunk?: string): this {\n\t\tthis.#body = chunk;\n\t\tthis.writableEnded = true;\n\t\tthis.closed = true;\n\t\tqueueMicrotask(() => this.emit('close'));\n\t\treturn this;\n\t}\n\n\tpublic toResponse(): Response {\n\t\treturn new Response(this.#body ?? null, { status: this.statusCode, headers: this.#headers });\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAsCA,eAAsB,mBAAmB,QAAgB,UAA+B,CAAC,GAA0B;CAClH,MAAM,mBAAmB,QAAQ,oBAAoB,QAAQ,IAAI;CACjE,IAAI,CAAC,kBAAkB,MAAM,IAAI,MAAM,sCAAsC;CAE7E,MAAM,MAAM,MAAM,QAAQ,gBAAgB;CAC1C,MAAM,OAAO,QAAQ,YAAY,QAAQ,IAAI,kBAAkB;CAC/D,MAAM,WAAY,OAAyD,qBAAqB,KAAK,MAAM;CAE3G,OAAO,OAAO,YAAwC;EACrD,MAAM,WAAW,kBAAkB,OAAO;EAC1C,MAAM,WAAW,IAAI,oBAAoB;EACzC,MAAM,SAAS,UAAU,UAAuC,MAAM,GAAG;EACzE,OAAO,SAAS,WAAW;CAC5B;AACD;AAEA,SAAS,kBAAkB,SAAmC;CAC7D,MAAM,UAA+B,CAAC;CACtC,QAAQ,QAAQ,SAAS,OAAO,SAAS;EACxC,QAAQ,QAAQ;CACjB,CAAC;CAED,MAAM,OAAO,QAAQ,OAAO,SAAS,QAAQ,QAAQ,IAAa,IAAI,SAAS,KAAK,CAAC,CAAC;CACtF,OAAO,OAAO,OAAO,MAAM;EAAE,KAAK,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;EAAU,QAAQ,QAAQ;EAAQ;CAAQ,CAAC;AACnG;;;;;;;;AAOA,IAAM,sBAAN,cAAkC,aAAa;;;wBACvC,cAAa;wBACb,iBAAgB;wBAChB,UAAS;6CACI,IAAI,QAAQ;;;CAGhC,AAAO,UAAU,MAAc,OAAqB;EACnD,uCAAc,IAAI,MAAM,KAAK;CAC9B;CAEA,AAAO,IAAI,OAAsB;EAChC,oCAAa;EACb,KAAK,gBAAgB;EACrB,KAAK,SAAS;EACd,qBAAqB,KAAK,KAAK,OAAO,CAAC;EACvC,OAAO;CACR;CAEA,AAAO,aAAuB;EAC7B,OAAO,IAAI,uCAAS,SAAc,MAAM;GAAE,QAAQ,KAAK;GAAY,0CAAS;EAAc,CAAC;CAC5F;AACD"}
+{"version":3,"file":"fetch.js","names":[],"sources":["../../src/fetch.ts"],"sourcesContent":["/**\n * Fetch (Web `Request`/`Response`) entry point for `@wolfstar/http-framework`, so a bot can be served by anything\n * that speaks Fetch — Vite's dev middleware, Nitro, Cloudflare Workers, `Bun.serve`, `Deno.serve` — instead of only\n * `Client#listen()`'s own `node:http` server.\n *\n * @module @wolfstar/http-framework/fetch\n */\nimport type { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'node:http';\nimport { EventEmitter } from 'node:events';\nimport { Readable } from 'node:stream';\nimport type { Client } from './lib/Client.js';\nimport { makeKey, type Key } from './lib/utils/security.js';\n\nexport interface FetchHandlerOptions {\n\t/**\n\t * The bot's Discord public key, used to verify interaction signatures.\n\t * @default process.env.DISCORD_PUBLIC_KEY\n\t */\n\tdiscordPublicKey?: string;\n\t/**\n\t * The path interactions are posted to.\n\t * @default process.env.HTTP_POST_PATH ?? '/'\n\t */\n\tpostPath?: string;\n}\n\nexport type FetchHandler = (request: Request) => Promise<Response>;\n\ntype Dispatch = (request: IncomingMessage, response: ServerResponse, path: string, key: Key) => Promise<ServerResponse>;\n\n/**\n * Wraps `Client`'s own dispatch — signature verification, routing, replies, the exact same code `listen()` runs —\n * behind a Fetch handler, by bridging a `Request` to the `IncomingMessage`/`ServerResponse` shape it expects.\n *\n * This changes nothing about the framework's internals: `handleRawHttpMessage` is `protected`, not private, and is\n * called here exactly as `Client#listen()` calls it on every request. `Client` never has to know which transport\n * (`node:http`, Vite, Nitro, a Worker) produced the request.\n */\nexport async function createFetchHandler(client: Client, options: FetchHandlerOptions = {}): Promise<FetchHandler> {\n\tconst discordPublicKey = options.discordPublicKey ?? process.env.DISCORD_PUBLIC_KEY;\n\tif (!discordPublicKey) throw new Error('The discordPublicKey cannot be empty');\n\n\tconst key = await makeKey(discordPublicKey);\n\tconst path = options.postPath ?? process.env.HTTP_POST_PATH ?? '/';\n\tconst dispatch = (client as unknown as { handleRawHttpMessage: Dispatch }).handleRawHttpMessage.bind(client);\n\n\treturn async (request: Request): Promise<Response> => {\n\t\tconst incoming = toIncomingMessage(request);\n\t\tconst outgoing = new FetchServerResponse();\n\t\tawait dispatch(incoming, outgoing as unknown as ServerResponse, path, key);\n\t\treturn outgoing.toResponse();\n\t};\n}\n\nfunction toIncomingMessage(request: Request): IncomingMessage {\n\tconst headers: IncomingHttpHeaders = {};\n\trequest.headers.forEach((value, name) => {\n\t\theaders[name] = value;\n\t});\n\n\tconst body = request.body ? Readable.fromWeb(request.body as never) : Readable.from([]);\n\treturn Object.assign(body, { url: new URL(request.url).pathname, method: request.method, headers }) as unknown as IncomingMessage;\n}\n\n/**\n * The minimum of `http.ServerResponse` `Client`'s dispatch touches: `setHeader`, `statusCode`, `end`,\n * `writableEnded`, and a `'close'` event once the response is done (`BaseInteraction`'s `_sendReply` awaits it\n * before resolving, so a caller here has to fire it too, or every reply would hang forever).\n */\nclass FetchServerResponse extends EventEmitter {\n\tpublic statusCode = 200;\n\tpublic writableEnded = false;\n\tpublic closed = false;\n\treadonly #headers = new Headers();\n\t#body: string | undefined;\n\n\tpublic setHeader(name: string, value: string): void {\n\t\tthis.#headers.set(name, value);\n\t}\n\n\tpublic end(chunk?: string): this {\n\t\tthis.#body = chunk;\n\t\tthis.writableEnded = true;\n\t\tthis.closed = true;\n\t\tqueueMicrotask(() => this.emit('close'));\n\t\treturn this;\n\t}\n\n\tpublic toResponse(): Response {\n\t\treturn new Response(this.#body ?? null, { status: this.statusCode, headers: this.#headers });\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;AAsCA,eAAsB,mBAAmB,QAAgB,UAA+B,CAAC,GAA0B;CAClH,MAAM,mBAAmB,QAAQ,oBAAoB,QAAQ,IAAI;CACjE,IAAI,CAAC,kBAAkB,MAAM,IAAI,MAAM,sCAAsC;CAE7E,MAAM,MAAM,MAAM,QAAQ,gBAAgB;CAC1C,MAAM,OAAO,QAAQ,YAAY,QAAQ,IAAI,kBAAkB;CAC/D,MAAM,WAAY,OAAyD,qBAAqB,KAAK,MAAM;CAE3G,OAAO,OAAO,YAAwC;EACrD,MAAM,WAAW,kBAAkB,OAAO;EAC1C,MAAM,WAAW,IAAI,oBAAoB;EACzC,MAAM,SAAS,UAAU,UAAuC,MAAM,GAAG;EACzE,OAAO,SAAS,WAAW;CAC5B;AACD;AAEA,SAAS,kBAAkB,SAAmC;CAC7D,MAAM,UAA+B,CAAC;CACtC,QAAQ,QAAQ,SAAS,OAAO,SAAS;EACxC,QAAQ,QAAQ;CACjB,CAAC;CAED,MAAM,OAAO,QAAQ,OAAO,SAAS,QAAQ,QAAQ,IAAa,IAAI,SAAS,KAAK,CAAC,CAAC;CACtF,OAAO,OAAO,OAAO,MAAM;EAAE,KAAK,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;EAAU,QAAQ,QAAQ;EAAQ;CAAQ,CAAC;AACnG;;;;;;;;AAOA,IAAM,sBAAN,cAAkC,aAAa;;;wBACvC,cAAa;wBACb,iBAAgB;wBAChB,UAAS;6CACI,IAAI,QAAQ;;;CAGhC,AAAO,UAAU,MAAc,OAAqB;EACnD,uCAAc,IAAI,MAAM,KAAK;CAC9B;CAEA,AAAO,IAAI,OAAsB;EAChC,oCAAa;EACb,KAAK,gBAAgB;EACrB,KAAK,SAAS;EACd,qBAAqB,KAAK,KAAK,OAAO,CAAC;EACvC,OAAO;CACR;CAEA,AAAO,aAAuB;EAC7B,OAAO,IAAI,uCAAS,SAAc,MAAM;GAAE,QAAQ,KAAK;GAAY,0CAAS;EAAc,CAAC;CAC5F;AACD"}

package/dist/esm/index.js

@@ -1,5 +1,4 @@
-import { t as _defineProperty } from "./defineProperty-DeZQsruP.js";
-import { a as _assertClassBrand, i as _classPrivateFieldGet2, n as verifyBody, o as _classPrivateFieldInitSpec, r as _classPrivateFieldSet2, s as _checkPrivateRedeclaration, t as makeKey } from "./security-pO7x9isF.js";
+import { a as _assertClassBrand, c as _defineProperty, i as _classPrivateFieldGet2, n as verifyBody, o as _classPrivateFieldInitSpec, r as _classPrivateFieldSet2, s as _checkPrivateRedeclaration, t as makeKey } from "./security-CDI6548c.js";
 import { AliasPiece, AliasStore, LoaderError, LoaderStrategy, MissingExportsError, Piece, Piece as Piece$1, Store, Store as Store$1, StoreRegistry, container, container as container$1 } from "@sapphire/pieces";
 import { REST, makeURLSearchParams } from "@discordjs/rest";
 import { isFunction, isNullish, isNullishOrEmpty } from "@sapphire/utilities";