@wolfstar/cli 2.3.1 → 2.6.0-next-20261007120201

package/README.md

@@ -24,8 +24,9 @@ package has no install-time dependency on `@wolfstar/http-framework` in return,
 - `stars dev` builds the project, starts the bot, restarts it (or leaves the change to the bot's hot reload) and shows what is happening in a full-screen dashboard: status, log channels and levels you can filter, and a prompt before changed commands are redeployed (or plain logs).
 - `stars build` runs the configured build tool once.
 - `stars info` prints the resolved configuration and environment (`--json` for scripts).
-- `stars codegen` runs the configured code generators (`--check` for CI).
-- `stars prepare` generates `.stars/tsconfig.json` and the auto imports declaration file (`--check` for CI).
+- `stars codegen` runs the configured code generators: i18next types and the typed options of your commands (`--check` for CI).
+- `stars prepare` generates the TypeScript configuration in `.stars/` (`tsconfig.app.json` and `tsconfig.node.json`) and the auto imports declaration file (`--check` for CI).
+- `stars typecheck` regenerates `.stars/` and type-checks every project once, the way `nuxt typecheck` does.
 - `stars commands` inspects, compares, deploys and cleans the application commands Discord has deployed.
 - `stars doctor` checks that the project is ready: runtime, framework, credentials, interactions endpoint, generated files.
 - `stars completions` prints the shell completion script for bash, zsh or fish.
@@ -66,14 +67,17 @@ const config = await loadStarsConfig({ cwd: process.cwd() });
 console.log(config.entry, config.build.output);
 ```
 
+`loadStarsConfig` only validates what the schema owns. A top-level key that is not built in is kept as `config.moduleOptions` (it may be the options of a module, `meta.configKey`), not rejected, so a misspelled key is reported by the `stars` commands once the modules are set up, not by `loadStarsConfig`. A tool that loads the configuration on its own and wants that check calls `assertModuleOptionsClaimed(config, claimedKeys)` from `@wolfstar/schema` (also exported by `@wolfstar/http-framework/config`) with the `meta.configKey`s of the modules it installed, or `[]` when it installs none.
+
 ## Commands
 
 ```sh
-stars dev [--no-tui] [--layout <auto|dashboard|panel>] [--channel <name>] [--level <level>] [--theme <name>] [--config <file>] [--cwd <dir>]
+stars dev [--no-tui] [--tunnel|--no-tunnel] [--layout <auto|dashboard|panel>] [--channel <name>] [--level <level>] [--theme <name>] [--config <file>] [--cwd <dir>]
 stars build [--config <file>] [--cwd <dir>]
 stars info [--json] [--config <file>] [--cwd <dir>]
 stars codegen [--check] [--json] [--config <file>] [--cwd <dir>]
 stars prepare [--check] [--json] [--config <file>] [--cwd <dir>]
+stars typecheck [--config <file>] [--cwd <dir>]
 stars commands [list|clean|diff|deploy] [--guild <id>] [--name <name>] [--check] [--yes] [--json]
 stars doctor [--online] [--json] [--config <file>] [--cwd <dir>]
 stars completions <bash|zsh|fish>
@@ -275,6 +279,48 @@ fills in on its own (`id`, `version`, defaults such as `nsfw: false`) are ignore
 overwrite: a deployed command the project no longer defines is deleted, which is why it asks first and refuses to
 run without `--yes` outside a terminal, or with `--json`.
 
+### `stars codegen`
+
+Runs the code generators `codegen` in `stars.config` enables, writing their files (`--check` fails with
+`CODEGEN_OUTDATED` instead when one is stale, `--json` prints `{ check, results }`):
+
+- `codegen.i18n` types the i18next resources with `@wolfstar/i18next-type-generator`. It is on by default when
+  `src/locales/en-US` exists.
+- `codegen.commands` types the options of every command from its builder. It is off by default: `true` writes
+  `src/@types/commands.d.ts`, `{ output }` picks another file.
+
+```typescript
+export default defineConfig({ codegen: { commands: true } });
+```
+
+The generated file augments `CommandOptionsRegistry` with one entry per command path (`'ping'`, `'math add'`,
+`'subscriptions twitch add'`), and `Command.OptionsOf<'math add'>` reads it, so the handler needs no hand-written
+`interface Options` that can drift from the builder:
+
+```typescript
+public add(interaction: Command.ChatInputInteraction, { left, right }: Command.OptionsOf<'math add'>) {}
+```
+
+Every option has the shape the framework resolves it to at runtime (`user` is `TransformedArguments.User`, `role` is
+`APIRole`, ...), a `required` option is not optional, `choices` are a literal union and `channel_types` narrow a
+channel. A localized command is keyed by its default name, the one the handler receives. Context menu commands have no
+options and are skipped. For an autocomplete, `Command.AutocompleteArguments<Command.OptionsOf<'math add'>>` types
+`focused` from the same entry.
+
+The types come from what the bot registers, so loops and factories need no special care: `stars codegen` reads the
+commands from the built bot the way `stars commands diff` does (run `stars build` first), by starting it in a mode
+that loads its pieces, reports its registry and exits before it listens or talks to Discord. It does not call
+`client.login`, but the bot still has to get through its own setup: values it reads while starting (`DISCORD_CLIENT_ID`,
+`DISCORD_PUBLIC_KEY`, ...) have to be set, with placeholders in CI where the real secrets are not available:
+
+```sh
+DISCORD_CLIENT_ID=1 DISCORD_TOKEN=x DISCORD_PUBLIC_KEY=0 stars codegen --check
+```
+
+It is not part of `stars dev` or `stars prepare` (which has no build to read from yet): run `stars codegen` after
+changing an option, and `stars codegen --check` in CI to keep the file up to date. A path registered more than once
+(a command restricted to several guilds) keeps its first definition.
+
 ### `stars doctor`
 
 Checks what a project needs before `stars dev` can do its job, and says what to do about each problem:
@@ -291,7 +337,7 @@ stars doctor v2.3.0
                 → Stop it, or set another HTTP_PORT, unless it is this bot running.
   ℹ tunnel      No tunnel: Discord cannot reach a bot on localhost
                 → Set `dev.tunnel: true` for a cloudflared quick tunnel, or press t in `stars dev`.
-  ⚠ prepare     Out of date: .stars/tsconfig.json
+  ⚠ prepare     Out of date: .stars/tsconfig.app.json, .stars/tsconfig.node.json
                 → Run `stars prepare`.
 
   1 error(s), 2 warning(s)
@@ -325,7 +371,8 @@ Three `dev` options round out the dev loop (all documented in
   mode), `tsz` (the tsc-compatible checker, re-run after every build since it has no watch mode), or `auto` — the
   default, which uses `golar` when the project depends on it and `tsc` otherwise.
 - Pressing `t` opens and closes a `cloudflared` quick tunnel without configuration. `dev.tunnel: true` opens it at startup so Discord can reach the bot's interactions endpoint from the
-  internet; a string is an https URL you already serve, which the CLI only probes. `dev.tunnel.updateEndpoint` writes
+  internet, and so does `stars dev --tunnel` for one session, whatever `dev.tunnel` says (`--no-tunnel` keeps it closed at
+  start; `t` still opens it). With `--no-tui` the URL is printed on the `tunnel` channel; a string is an https URL you already serve, which the CLI only probes. `dev.tunnel.updateEndpoint` writes
   the URL to the Discord application, and is opt-in because it edits a live application.
 - `dev.logFile` (default `.stars/dev.log`) mirrors the session's logs to disk, so a run can be read back after the
   terminal UI is gone. Set it to `false` to disable it. It is truncated on every run; `dev.logs.dir` (for example
@@ -368,7 +415,8 @@ and which options the block sets.
 | ------------- | ----------------------------------------------------------------------------------------------------------------------------- |
 | `3` (EOL)     | Legacy behaviour: a `tsdown.config.*` drives the build, auto imports off unless asked for; prints `COMPATIBILITY_VERSION_EOL` |
 | `4`           | `tsdown` configured from `stars.config` alone, auto imports on and wired in, `'auto'` picks `tsdown` for TypeScript           |
-| `5` (default) | Everything in `4`, plus `env` registered automatically when the project depends on `@wolfstar/env-utilities`                  |
+| `5`           | Everything in `4`, plus `env` registered automatically when the project depends on `@wolfstar/env-utilities`                  |
+| `6` (default) | Everything in `5`, plus the generated tsconfig split into `.stars/tsconfig.app.json` and `.stars/tsconfig.node.json`          |
 
 ### Environment and hooks
 
@@ -435,7 +483,30 @@ package.json imports, and ESNext/DOM libraries. Use `import type` and `export ty
 These options apply to tsdown and Vite; tsc keeps its emit-compatible settings. Sapphire's decorator options and
 the ES2022 target remain in effect. This does not enable Stars' experimental Nitro runtime integration.
 
-Run `stars prepare` and extend the generated config from your project's `tsconfig.json`:
+From compatibility version 6, `stars prepare` writes two files, the way a Nuxt 4 project has them:
+
+- `.stars/tsconfig.app.json` is the bot: everything under the entry's directory plus the auto imports declaration,
+  with the `~`/`@`/`~~`/`@@` paths and the options above. `tsdown` builds with it.
+- `.stars/tsconfig.node.json` is what Node runs without a bundler: `stars.config.*`, `vitest.config.*`,
+  `tsdown.config.*`, `vite.config.*` and `scripts/**`. It uses `NodeNext` resolution, `types: ["node"]`, no DOM
+  library, no aliases or auto imports and no decorators, and leaves the entry's directory to the app project.
+
+Your own `tsconfig.json` only references them:
+
+```json
+{
+	"files": [],
+	"references": [{ "path": "./.stars/tsconfig.app.json" }, { "path": "./.stars/tsconfig.node.json" }]
+}
+```
+
+`stars typecheck` regenerates `.stars/` and runs your checker (`dev.typecheck.checker`: `golar` or `tsc`; bare `tsc -p`
+on that root would check nothing) once per project. `stars dev`'s `dev.typecheck` watches the app project. A root
+`tsconfig.json` that still extends `./.stars/tsconfig.json` gets a `TSCONFIG_LEGACY_EXTENDS` warning from
+`stars prepare` and `stars doctor`: update it once, or keep `future.compatibilityVersion` at `5`.
+
+On `5` and `4` nothing changes: `stars prepare` writes the single `.stars/tsconfig.json`, which you extend from your
+project's `tsconfig.json`:
 
 ```json
 {
@@ -443,18 +514,17 @@ Run `stars prepare` and extend the generated config from your project's `tsconfi
 }
 ```
 
-New tsdown projects already extend this file and run `stars prepare` through `postinstall`.
-Keep your existing compiler options alongside `extends`. `stars dev` and `stars build` also regenerate this file.
-For tsdown builds, `@/` and `~/` resolve to the entry file's directory (normally `src/`), while `@@/` and `~~/`
+Keep your existing compiler options alongside `extends`. `stars dev` and `stars build` also regenerate the generated
+files. For tsdown builds, `@/` and `~/` resolve to the entry file's directory (normally `src/`), while `@@/` and `~~/`
 resolve to the project root. Filesystem aliases in `stars.config.ts`'s `tsdown.alias` are included too, with custom
 values taking precedence. Legacy builds using a separate tsdown config only include aliases declared in
 `stars.config.ts`. Other build tools do not get tsdown aliases, since TypeScript alone does not rewrite imports.
 
-The generated config includes source files and the auto imports declaration, including a custom `imports.dts`
+The generated app config includes source files and the auto imports declaration, including a custom `imports.dts`
 location. Explicit `include` or `compilerOptions.paths` in your own tsconfig replace the inherited values;
 remove manually duplicated paths to use the generated aliases. Generation works with `imports: false` too.
-Use `stars prepare --check` to check both generated files without writing them. Do not edit `.stars/tsconfig.json`
-by hand; keep `.stars/` ignored by Git and run `stars prepare` after installing dependencies on a fresh checkout.
+Use `stars prepare --check` to check the generated files without writing them. Do not edit anything in `.stars/` by
+hand; keep `.stars/` ignored by Git and run `stars prepare` after installing dependencies on a fresh checkout.
 
 ## Server integrations
 

package/dist/{_shared-BIQK0Bhm.js → _shared-CyzTojMA.js}

@@ -1,20 +1,69 @@
 import { r as formatError } from "./errors-COFWKKKw.js";
+import { t as cliDiagnostics } from "./diagnostics-Dn3CXa8J.js";
 import { t as loadAutoImportsModule } from "./framework-auto-imports-Gu_PXSyr.js";
-import { a as modulesPreloadWarning, o as prepareModulesPreload } from "./hooks-Cy6F2bhH.js";
+import { a as modulesPreloadWarning, o as prepareModulesPreload } from "./hooks-D_RVS0ba.js";
 import { createRequire } from "node:module";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { SPLIT_TSCONFIG_VERSION } from "@wolfstar/schema";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 
 //#region src/utils/tsconfig.ts
 const require = createRequire(import.meta.url);
-const sapphireOptions = Object.assign({}, ...[
+const presetOptions = (ids) => Object.assign({}, ...ids.map((id) => require(id).compilerOptions));
+const strictOptions = presetOptions(["@sapphire/ts-config", "@sapphire/ts-config/extra-strict"]);
+const sapphireOptions = presetOptions([
 	"@sapphire/ts-config",
 	"@sapphire/ts-config/extra-strict",
 	"@sapphire/ts-config/decorators"
-].map((id) => require(id).compilerOptions));
-/** Generates an extendable config without changing the project's own tsconfig. */
+]);
+/** The root config files that run in Node and never go through the bundler. */
+const NODE_PROJECT_FILES = [
+	"stars.config.*",
+	"vitest.config.*",
+	"tsdown.config.*",
+	"vite.config.*",
+	"scripts/**/*"
+];
+/**
+* Generates the TypeScript configuration without changing the project's own tsconfig: one extendable
+* `.stars/tsconfig.json` below compatibility version 6, and from 6 the `.stars/tsconfig.app.json` (the bot sources) and
+* `.stars/tsconfig.node.json` (the root files that run in Node) a solution-style `tsconfig.json` references.
+* Returns one status per file.
+*/
 async function prepareTsconfig(config, check = false) {
-	const path = join(config.root, ".stars", "tsconfig.json");
+	if (config.future.compatibilityVersion < SPLIT_TSCONFIG_VERSION) return [await emit(config, "tsconfig", appTsconfig(config, "tsconfig"), check)];
+	return [await emit(config, "app", appTsconfig(config, "app"), check), await emit(config, "node", nodeTsconfig(config), check)];
+}
+/**
+* Reports a root `tsconfig.json` that still extends the single `.stars/tsconfig.json` of compatibility versions below 6,
+* a file `stars prepare` no longer writes from version 6 on. A project moving to 6 updates it once.
+*/
+async function findLegacyRootTsconfig(config) {
+	if (config.future.compatibilityVersion < SPLIT_TSCONFIG_VERSION) return null;
+	const path = join(config.root, "tsconfig.json");
+	const content = await readFile(path, "utf-8").catch(() => null);
+	if (content === null || !/["']extends["']\s*:\s*(?:\[[^\]]*)?["']\.\/\.stars\/tsconfig\.json["']/.test(content)) return null;
+	return cliDiagnostics.TSCONFIG_LEGACY_EXTENDS({ file: relative(config.root, path) || "tsconfig.json" });
+}
+async function emit(config, name, compilerConfig, check) {
+	const path = join(config.root, ".stars", name === "tsconfig" ? "tsconfig.json" : `tsconfig.${name}.json`);
+	const content = `${JSON.stringify(compilerConfig, null, 2)}\n`;
+	if (check) return {
+		name,
+		path,
+		status: await readFile(path, "utf-8").catch(() => null) === content ? "up-to-date" : "outdated"
+	};
+	await mkdir(dirname(path), { recursive: true });
+	await writeFile(path, content);
+	return {
+		name,
+		path,
+		status: "written"
+	};
+}
+/** What `.stars/tsconfig.json` has always been: the bot sources, with the aliases and the bundler's compiler options. */
+function appTsconfig(config, name) {
+	const path = join(config.root, ".stars", name === "tsconfig" ? "tsconfig.json" : `tsconfig.${name}.json`);
 	const fromGenerated = (target) => `./${relative(dirname(path), target).replaceAll("\\", "/")}`;
 	const paths = {};
 	if (config.build.tool === "tsdown") {
@@ -48,7 +97,7 @@ async function prepareTsconfig(config, check = false) {
 			paths[`${alias}/*`] = [`${resolved}/*`];
 		}
 	}
-	const content = `${JSON.stringify({
+	return {
 		compilerOptions: {
 			...sapphireOptions,
 			...config.build.tool === "tsdown" || config.build.tool === "vite" ? {
@@ -66,21 +115,44 @@ async function prepareTsconfig(config, check = false) {
 			target: "ES2022",
 			forceConsistentCasingInFileNames: true,
 			skipLibCheck: true,
-			tsBuildInfoFile: "./tsconfig.tsbuildinfo",
+			tsBuildInfoFile: name === "tsconfig" ? "./tsconfig.tsbuildinfo" : `./tsconfig.${name}.tsbuildinfo`,
 			paths
 		},
 		include: [`${fromGenerated(dirname(config.entry))}/**/*`, ...config.imports.enabled ? [fromGenerated(config.imports.dts)] : []],
 		exclude: [fromGenerated(join(config.root, "node_modules")), fromGenerated(config.build.outDir)]
-	}, null, 2)}\n`;
-	if (check) return {
-		path,
-		status: await readFile(path, "utf-8").catch(() => null) === content ? "up-to-date" : "outdated"
 	};
-	await mkdir(dirname(path), { recursive: true });
-	await writeFile(path, content);
+}
+/**
+* The root files that run in Node: `stars.config.*`, `vitest.config.*`, `scripts/**` and the like. No DOM, no
+* bundler resolution, no aliases or auto imports (none of it applies to a file Node loads itself), and no decorators.
+*/
+function nodeTsconfig(config) {
+	const path = join(config.root, ".stars", "tsconfig.node.json");
+	const fromGenerated = (target) => `./${relative(dirname(path), target).replaceAll("\\", "/")}`;
+	const source = dirname(config.entry);
+	const include = NODE_PROJECT_FILES.map((pattern) => fromGenerated(join(config.root, pattern)));
+	if (config.configFile !== null) include.push(fromGenerated(config.configFile));
 	return {
-		path,
-		status: "written"
+		compilerOptions: {
+			...strictOptions,
+			target: "ES2022",
+			module: "NodeNext",
+			moduleResolution: "NodeNext",
+			moduleDetection: "force",
+			lib: ["ESNext"],
+			types: ["node"],
+			allowJs: true,
+			noEmit: true,
+			forceConsistentCasingInFileNames: true,
+			skipLibCheck: true,
+			tsBuildInfoFile: "./tsconfig.node.tsbuildinfo"
+		},
+		include: [...new Set(include)],
+		exclude: [
+			fromGenerated(join(config.root, "node_modules")),
+			fromGenerated(config.build.outDir),
+			...source === config.root ? [] : [fromGenerated(source)]
+		]
 	};
 }
 
@@ -120,10 +192,11 @@ async function prepareAutoImports(config, check = false) {
 /** Prepares TypeScript configuration and auto import declarations before building. */
 async function prepareProject(config, hooks, check = false) {
 	await hooks?.callHook("prepare:before", config);
-	const tsconfig = await prepareTsconfig(config, check);
+	const tsconfigs = await prepareTsconfig(config, check);
 	const result = {
 		...await prepareAutoImports(config, check),
-		tsconfig,
+		tsconfig: tsconfigs[0],
+		tsconfigs,
 		modules: await prepareModulesPreload(config, check)
 	};
 	await hooks?.callHook("prepare:done", config, {
@@ -133,15 +206,17 @@ async function prepareProject(config, hooks, check = false) {
 	return result;
 }
 /**
-* Prints the non-fatal configuration diagnostics (e.g. an end-of-life compatibility version), and, unless `production`
+* Prints the non-fatal configuration diagnostics (e.g. an end-of-life compatibility version, or a root `tsconfig.json` still extending `.stars/tsconfig.json`), and, unless `production`
 * is `false` (`stars dev`, which does that itself), what a production start of the project still needs to do.
 */
 async function reportWarnings(config, write, options = {}) {
 	for (const warning of config.warnings) write(await formatError(warning));
+	const legacyTsconfig = await findLegacyRootTsconfig(config);
+	if (legacyTsconfig) write(await formatError(legacyTsconfig));
 	const preload = options.production === false ? null : modulesPreloadWarning(config);
 	if (preload) write(await formatError(preload));
 }
 
 //#endregion
-export { reportWarnings as n, prepareProject as t };
-//# sourceMappingURL=_shared-BIQK0Bhm.js.map
+export { reportWarnings as n, findLegacyRootTsconfig as r, prepareProject as t };
+//# sourceMappingURL=_shared-CyzTojMA.js.map

package/dist/_shared-CyzTojMA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared-CyzTojMA.js","names":[],"sources":["../src/utils/tsconfig.ts","../src/commands/_shared.ts"],"sourcesContent":["import { SPLIT_TSCONFIG_VERSION, type ResolvedStarsConfig } from '@wolfstar/schema';\nimport { createRequire } from 'node:module';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, join, relative, resolve } from 'node:path';\nimport type { Diagnostic } from 'nostics';\nimport { cliDiagnostics } from './diagnostics.js';\n\nconst require = createRequire(import.meta.url);\nconst presetOptions = (ids: string[]) =>\n\tObject.assign({}, ...ids.map((id) => (require(id) as { compilerOptions: Record<string, unknown> }).compilerOptions)) as Record<string, unknown>;\n// Strictness belongs to every project; the decorator options only to the code the bundler compiles.\nconst strictOptions = presetOptions(['@sapphire/ts-config', '@sapphire/ts-config/extra-strict']);\nconst sapphireOptions = presetOptions(['@sapphire/ts-config', '@sapphire/ts-config/extra-strict', '@sapphire/ts-config/decorators']);\n\nexport type TsconfigName = 'tsconfig' | 'app' | 'node';\n\nexport interface TsconfigStatus {\n\t/** `tsconfig` is the single file of compatibility versions below 6, `app` and `node` the split ones. */\n\tname: TsconfigName;\n\tpath: string;\n\tstatus: 'written' | 'up-to-date' | 'outdated';\n}\n\n/** The root config files that run in Node and never go through the bundler. */\nconst NODE_PROJECT_FILES = ['stars.config.*', 'vitest.config.*', 'tsdown.config.*', 'vite.config.*', 'scripts/**/*'] as const;\n\n/**\n * Generates the TypeScript configuration without changing the project's own tsconfig: one extendable\n * `.stars/tsconfig.json` below compatibility version 6, and from 6 the `.stars/tsconfig.app.json` (the bot sources) and\n * `.stars/tsconfig.node.json` (the root files that run in Node) a solution-style `tsconfig.json` references.\n * Returns one status per file.\n */\nexport async function prepareTsconfig(config: ResolvedStarsConfig, check = false): Promise<TsconfigStatus[]> {\n\tif (config.future.compatibilityVersion < SPLIT_TSCONFIG_VERSION) {\n\t\treturn [await emit(config, 'tsconfig', appTsconfig(config, 'tsconfig'), check)];\n\t}\n\n\t// Written for every build tool: the node project is about files Node runs whatever builds the bot. A `tsc` or `none`\n\t// project keeps its own tsconfig for the bot sources, so for it the app file is generated but nothing references it.\n\treturn [await emit(config, 'app', appTsconfig(config, 'app'), check), await emit(config, 'node', nodeTsconfig(config), check)];\n}\n\n/**\n * Reports a root `tsconfig.json` that still extends the single `.stars/tsconfig.json` of compatibility versions below 6,\n * a file `stars prepare` no longer writes from version 6 on. A project moving to 6 updates it once.\n */\nexport async function findLegacyRootTsconfig(config: ResolvedStarsConfig): Promise<Diagnostic | null> {\n\tif (config.future.compatibilityVersion < SPLIT_TSCONFIG_VERSION) return null;\n\n\tconst path = join(config.root, 'tsconfig.json');\n\tconst content = await readFile(path, 'utf-8').catch(() => null);\n\tif (content === null || !/[\"']extends[\"']\\s*:\\s*(?:\\[[^\\]]*)?[\"']\\.\\/\\.stars\\/tsconfig\\.json[\"']/.test(content)) return null;\n\n\treturn cliDiagnostics.TSCONFIG_LEGACY_EXTENDS({ file: relative(config.root, path) || 'tsconfig.json' });\n}\n\nasync function emit(config: ResolvedStarsConfig, name: TsconfigName, compilerConfig: object, check: boolean): Promise<TsconfigStatus> {\n\tconst path = join(config.root, '.stars', name === 'tsconfig' ? 'tsconfig.json' : `tsconfig.${name}.json`);\n\tconst content = `${JSON.stringify(compilerConfig, null, 2)}\\n`;\n\tif (check) {\n\t\tconst existing = await readFile(path, 'utf-8').catch(() => null);\n\t\treturn { name, path, status: existing === content ? 'up-to-date' : 'outdated' };\n\t}\n\tawait mkdir(dirname(path), { recursive: true });\n\tawait writeFile(path, content);\n\treturn { name, path, status: 'written' };\n}\n\n/** What `.stars/tsconfig.json` has always been: the bot sources, with the aliases and the bundler's compiler options. */\nfunction appTsconfig(config: ResolvedStarsConfig, name: TsconfigName) {\n\tconst path = join(config.root, '.stars', name === 'tsconfig' ? 'tsconfig.json' : `tsconfig.${name}.json`);\n\tconst fromGenerated = (target: string) => `./${relative(dirname(path), target).replaceAll('\\\\', '/')}`;\n\tconst paths: Record<string, string[]> = {};\n\tif (config.build.tool === 'tsdown') {\n\t\tconst source = dirname(config.entry);\n\t\tconst defaults = config.build.configFile === null ? { '~': source, '@': source, '~~': config.root, '@@': config.root } : {};\n\t\tconst aliases = { ...defaults, ...(config.tsdown.alias as Record<string, unknown> | undefined) };\n\t\tfor (const [alias, target] of Object.entries(aliases)) {\n\t\t\t// Module redirects belong to the bundler; only filesystem targets become TypeScript paths.\n\t\t\tif (typeof target !== 'string' || (!isAbsolute(target) && !/^\\.\\.?[/\\\\]/.test(target))) continue;\n\t\t\tconst resolved = fromGenerated(resolve(config.root, target));\n\t\t\tpaths[alias] = [resolved];\n\t\t\tpaths[`${alias}/*`] = [`${resolved}/*`];\n\t\t}\n\t} else if (config.experimental.enableNitro) {\n\t\t// `NitroBuilder` turns on Vite's native `resolve.tsconfigPaths` (see https://nitro.build/examples/import-alias),\n\t\t// which reads these `paths` straight out of the generated tsconfig — no `tsdown.alias` equivalent to merge\n\t\t// with, `vite`/Nitro projects only have this file's own `compilerOptions.paths` to extend or replace.\n\t\tconst source = dirname(config.entry);\n\t\tconst defaults = { '~': source, '@': source, '~~': config.root, '@@': config.root };\n\t\tfor (const [alias, target] of Object.entries(defaults)) {\n\t\t\tconst resolved = fromGenerated(resolve(config.root, target));\n\t\t\tpaths[alias] = [resolved];\n\t\t\tpaths[`${alias}/*`] = [`${resolved}/*`];\n\t\t}\n\t}\n\treturn {\n\t\tcompilerOptions: {\n\t\t\t...sapphireOptions,\n\t\t\t// Bundlers emit the application; TypeScript only checks it. Keep Node16 emit for tsc.\n\t\t\t...(config.build.tool === 'tsdown' || config.build.tool === 'vite'\n\t\t\t\t? {\n\t\t\t\t\t\tmodule: 'ESNext',\n\t\t\t\t\t\tmoduleResolution: 'Bundler',\n\t\t\t\t\t\tmoduleDetection: 'force',\n\t\t\t\t\t\tisolatedModules: true,\n\t\t\t\t\t\tverbatimModuleSyntax: true,\n\t\t\t\t\t\tallowJs: true,\n\t\t\t\t\t\tallowImportingTsExtensions: true,\n\t\t\t\t\t\tresolvePackageJsonImports: true,\n\t\t\t\t\t\tlib: ['ESNext', 'DOM'],\n\t\t\t\t\t\tnoEmit: true\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t\ttarget: 'ES2022',\n\t\t\tforceConsistentCasingInFileNames: true,\n\t\t\tskipLibCheck: true,\n\t\t\ttsBuildInfoFile: name === 'tsconfig' ? './tsconfig.tsbuildinfo' : `./tsconfig.${name}.tsbuildinfo`,\n\t\t\tpaths\n\t\t},\n\t\tinclude: [`${fromGenerated(dirname(config.entry))}/**/*`, ...(config.imports.enabled ? [fromGenerated(config.imports.dts)] : [])],\n\t\texclude: [fromGenerated(join(config.root, 'node_modules')), fromGenerated(config.build.outDir)]\n\t};\n}\n\n/**\n * The root files that run in Node: `stars.config.*`, `vitest.config.*`, `scripts/**` and the like. No DOM, no\n * bundler resolution, no aliases or auto imports (none of it applies to a file Node loads itself), and no decorators.\n */\nfunction nodeTsconfig(config: ResolvedStarsConfig) {\n\tconst path = join(config.root, '.stars', 'tsconfig.node.json');\n\tconst fromGenerated = (target: string) => `./${relative(dirname(path), target).replaceAll('\\\\', '/')}`;\n\tconst source = dirname(config.entry);\n\tconst include = NODE_PROJECT_FILES.map((pattern) => fromGenerated(join(config.root, pattern)));\n\t// A custom `--config` file name is not covered by the globs.\n\tif (config.configFile !== null) include.push(fromGenerated(config.configFile));\n\n\treturn {\n\t\tcompilerOptions: {\n\t\t\t...strictOptions,\n\t\t\ttarget: 'ES2022',\n\t\t\tmodule: 'NodeNext',\n\t\t\tmoduleResolution: 'NodeNext',\n\t\t\tmoduleDetection: 'force',\n\t\t\tlib: ['ESNext'],\n\t\t\ttypes: ['node'],\n\t\t\tallowJs: true,\n\t\t\tnoEmit: true,\n\t\t\tforceConsistentCasingInFileNames: true,\n\t\t\tskipLibCheck: true,\n\t\t\ttsBuildInfoFile: './tsconfig.node.tsbuildinfo'\n\t\t},\n\t\tinclude: [...new Set(include)],\n\t\t// The two projects must not overlap: the bot sources belong to the app one. An entry in the project root has\n\t\t// no directory of its own to leave out.\n\t\texclude: [\n\t\t\tfromGenerated(join(config.root, 'node_modules')),\n\t\t\tfromGenerated(config.build.outDir),\n\t\t\t...(source === config.root ? [] : [fromGenerated(source)])\n\t\t]\n\t};\n}\n","import type { ResolvedStarsConfig } from '@wolfstar/schema';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { loadAutoImportsModule } from '../utils/framework-auto-imports.js';\nimport { formatError } from '../utils/errors.js';\nimport type { StarsHookable } from '../utils/hooks.js';\nimport { modulesPreloadWarning, prepareModulesPreload } from '../utils/modules.js';\nimport { findLegacyRootTsconfig, prepareTsconfig } from '../utils/tsconfig.js';\n\nexport type PrepareResult =\n\t| { enabled: false; dts: null; status: null }\n\t| { enabled: true; dts: string; status: 'written' | 'up-to-date' | 'outdated' };\n\n/**\n * Regenerates `imports.dts` unconditionally, used by `stars dev`/`stars build` before the first build so the\n * declaration file exists (and is current) even when the user never ran `stars prepare` themselves.\n */\nexport async function prepareAutoImports(config: ResolvedStarsConfig, check = false): Promise<PrepareResult> {\n\tif (!config.imports.enabled) return { enabled: false, dts: null, status: null };\n\n\tconst { dirs, presets, exclude, dts } = config.imports;\n\tconst { generateAutoImportsDts } = await loadAutoImportsModule(config.root);\n\tconst content = await generateAutoImportsDts({ root: config.root, dirs, presets, exclude });\n\n\tif (check) {\n\t\tconst existing = await readFile(dts, 'utf-8').catch(() => null);\n\t\treturn { enabled: true, dts, status: existing === content ? 'up-to-date' : 'outdated' };\n\t}\n\n\tawait mkdir(dirname(dts), { recursive: true });\n\tawait writeFile(dts, content);\n\treturn { enabled: true, dts, status: 'written' };\n}\n\n/** Prepares TypeScript configuration and auto import declarations before building. */\nexport async function prepareProject(config: ResolvedStarsConfig, hooks?: StarsHookable, check = false) {\n\tawait hooks?.callHook('prepare:before', config);\n\tconst tsconfigs = await prepareTsconfig(config, check);\n\tconst result = {\n\t\t...(await prepareAutoImports(config, check)),\n\t\t// The app config from version 6, the single file below it; `tsconfigs` has every generated file.\n\t\ttsconfig: tsconfigs[0]!,\n\t\ttsconfigs,\n\t\tmodules: await prepareModulesPreload(config, check)\n\t};\n\tawait hooks?.callHook('prepare:done', config, { dts: result.dts, status: result.status });\n\treturn result;\n}\n\n/**\n * Prints the non-fatal configuration diagnostics (e.g. an end-of-life compatibility version, or a root `tsconfig.json` still extending `.stars/tsconfig.json`), and, unless `production`\n * is `false` (`stars dev`, which does that itself), what a production start of the project still needs to do.\n */\nexport async function reportWarnings(\n\tconfig: ResolvedStarsConfig,\n\twrite: (text: string) => void,\n\toptions: { production?: boolean } = {}\n): Promise<void> {\n\tfor (const warning of config.warnings) write(await formatError(warning));\n\n\tconst legacyTsconfig = await findLegacyRootTsconfig(config);\n\tif (legacyTsconfig) write(await formatError(legacyTsconfig));\n\n\tconst preload = options.production === false ? null : modulesPreloadWarning(config);\n\tif (preload) write(await formatError(preload));\n}\n"],"mappings":"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"}

package/dist/{bridge-BegCt_n2.js → bridge-Cbm0jX9h.js}

@@ -1,240 +1,7 @@
-import { t as findInstalledVersion } from "./project-zlQStwsf.js";
-import { i as readProjectEnv } from "./hooks-Cy6F2bhH.js";
+import { t as findInstalledVersion } from "./project-DBqQMFCk.js";
 import { pathToFileURL } from "node:url";
-import { EventEmitter } from "node:events";
 import { resolveSync } from "mlly";
-import { startTunnel } from "untun";
 
-//#region src/dev/tunnel.ts
-const SIGNALS = [
-	"SIGINT",
-	"SIGTERM",
-	"SIGHUP"
-];
-function isCloudflaredExit(reason) {
-	return reason instanceof Error && reason.message.startsWith("cloudflared exited (");
-}
-/**
-* Exposes the bot's interactions endpoint publicly while `stars dev` runs.
-*
-* `dev.tunnel: true` opens a `cloudflared` quick tunnel via `untun` (it changes on every run); a configured https
-* URL is only probed, since the user already serves it. Writing the URL to the Discord application is opt-in
-* through `dev.tunnel.updateEndpoint`, because it edits a live application.
-*/
-var Tunnel = class extends EventEmitter {
-	config;
-	#startTunnel;
-	#tunnel = null;
-	#state = "off";
-	#url = null;
-	#wanted = false;
-	#rejectionGuard = null;
-	constructor(config, options = {}) {
-		super();
-		this.config = config;
-		this.#startTunnel = options.startTunnel ?? startTunnel;
-	}
-	get state() {
-		return this.#state;
-	}
-	/** The public URL of the interactions endpoint, `null` until the tunnel is up. */
-	get url() {
-		return this.#url;
-	}
-	async start(forceQuick = false) {
-		if (this.#state === "starting" || this.#state === "up") return;
-		const configured = this.config.dev.tunnel;
-		const tunnel = forceQuick && configured.mode === "off" ? {
-			mode: "quick",
-			path: "/",
-			updateEndpoint: false
-		} : configured;
-		if (tunnel.mode === "off") return;
-		this.#wanted = true;
-		this.#setState("starting", null);
-		const url = tunnel.mode === "url" ? await this.#useConfiguredUrl(tunnel) : await this.#openQuickTunnel();
-		if (!url || !this.#wanted) return;
-		this.#setState("up", endpointUrl(url, tunnel.path));
-		this.emit("log", "success", `Tunnel ready at ${this.#url}`);
-		if (tunnel.updateEndpoint) await this.#updateInteractionsEndpoint(this.#url);
-	}
-	/** Toggles the configured tunnel, opening a quick tunnel when the project did not configure one. */
-	toggle() {
-		return this.#state === "starting" || this.#state === "up" ? this.close() : this.start(true);
-	}
-	async close() {
-		this.#wanted = false;
-		const tunnel = this.#tunnel;
-		this.#tunnel = null;
-		this.#setState("off", null);
-		if (!tunnel) return;
-		try {
-			await tunnel.close();
-		} finally {
-			this.#releaseRejectionGuard();
-		}
-	}
-	async #useConfiguredUrl(tunnel) {
-		if (!await probe(endpointUrl(tunnel.url, tunnel.path))) this.emit("log", "warn", `${tunnel.url} did not answer; make sure it forwards to ${this.config.dev.url ?? "the bot"}`);
-		return tunnel.url;
-	}
-	async #openQuickTunnel() {
-		const target = this.config.dev.url;
-		if (!target) {
-			this.emit("log", "error", "A quick tunnel needs `dev.url` to know what to forward to");
-			this.#setState("failed", null);
-			return null;
-		}
-		this.emit("log", "info", "Opening a cloudflared quick tunnel…");
-		this.#installRejectionGuard();
-		try {
-			const tunnel = await this.#startWithoutSignalHandlers(target);
-			if (!this.#wanted) {
-				await tunnel?.close();
-				this.#releaseRejectionGuard();
-				return null;
-			}
-			if (!tunnel) {
-				this.emit("log", "error", "cloudflared setup was cancelled");
-				this.#setState("failed", null);
-				this.#releaseRejectionGuard();
-				return null;
-			}
-			this.#tunnel = tunnel;
-			return await tunnel.getURL();
-		} catch (error) {
-			this.#releaseRejectionGuard();
-			if (!this.#wanted) return null;
-			this.emit("log", "error", `cloudflared failed: ${error instanceof Error ? error.message : String(error)}`);
-			this.#setState("failed", null);
-			return null;
-		}
-	}
-	/**
-	* `untun` adds its own `SIGINT`/`SIGTERM`/`SIGHUP` listeners that call `process.exit()` once cloudflared is closed,
-	* which races `stars dev`'s graceful shutdown (it closes the tunnel through {@link close} anyway), so they are removed.
-	*/
-	async #startWithoutSignalHandlers(target) {
-		const before = SIGNALS.map((signal) => new Set(process.listeners(signal)));
-		try {
-			return await this.#startTunnel({
-				url: target,
-				acceptCloudflareNotice: true
-			});
-		} finally {
-			SIGNALS.forEach((signal, index) => {
-				for (const listener of process.listeners(signal)) if (!before[index].has(listener)) process.off(signal, listener);
-			});
-		}
-	}
-	/**
-	* `untun` rejects a promise per connection when cloudflared exits and never handles it (and its location pattern
-	* does not match lowercase codes such as `mxp03`, so that promise is never settled before), which Node reports as an
-	* unhandled rejection that ends the process, whenever the tunnel closes. The guard swallows that one error for as
-	* long as this tunnel exists; anything else it sees is thrown again, as if it was not installed.
-	*/
-	#installRejectionGuard() {
-		if (this.#rejectionGuard) return;
-		const guard = (reason) => {
-			if (!isCloudflaredExit(reason)) {
-				if (process.listeners("unhandledRejection").length === 1) throw reason;
-				return;
-			}
-			if (this.#state !== "up" || !this.#wanted) return;
-			this.#tunnel = null;
-			this.emit("log", "error", `cloudflared stopped unexpectedly: ${reason.message}`);
-			this.#setState("failed", null);
-			this.#releaseRejectionGuard();
-		};
-		this.#rejectionGuard = guard;
-		process.on("unhandledRejection", guard);
-	}
-	/** Node reports an unhandled rejection after the microtasks that follow it, so the guard has to outlive them. */
-	#releaseRejectionGuard() {
-		const guard = this.#rejectionGuard;
-		this.#rejectionGuard = null;
-		if (guard) setImmediate(() => process.off("unhandledRejection", guard));
-	}
-	/**
-	* Points the Discord application's interactions endpoint at the tunnel. Discord validates the endpoint with a
-	* signed ping before accepting it, so the bot has to be up already — this runs after the first successful build.
-	*/
-	async #updateInteractionsEndpoint(url) {
-		const credentials = readDiscordCredentials(this.config);
-		if (!credentials) {
-			this.emit("log", "warn", "Skipped the interactions endpoint update: DISCORD_TOKEN is not set");
-			return;
-		}
-		try {
-			const response = await fetch("https://discord.com/api/v10/applications/@me", {
-				method: "PATCH",
-				headers: {
-					authorization: `Bot ${credentials.token}`,
-					"content-type": "application/json"
-				},
-				body: JSON.stringify({ interactions_endpoint_url: url }),
-				signal: AbortSignal.timeout(1e4)
-			});
-			if (response.ok) this.emit("log", "success", `Interactions endpoint set to ${url}`);
-			else this.emit("log", "error", `Discord rejected the interactions endpoint (${response.status}): ${(await response.text()).slice(0, 300)}`);
-		} catch (error) {
-			this.emit("log", "error", `Failed to update the interactions endpoint: ${error instanceof Error ? error.message : String(error)}`);
-		}
-	}
-	#setState(state, url) {
-		this.#state = state;
-		this.#url = url;
-		this.emit("state", state, url);
-	}
-};
-/**
-* Joins the tunnel's origin with the path the interactions endpoint is served on.
-*/
-function endpointUrl(origin, path) {
-	return path === "/" ? origin : new URL(path, origin.endsWith("/") ? origin : `${origin}/`).href;
-}
-async function probe(url) {
-	try {
-		return (await fetch(url, {
-			method: "HEAD",
-			signal: AbortSignal.timeout(5e3)
-		})).status < 500;
-	} catch {
-		return false;
-	}
-}
-/**
-* Reads the Discord credentials the CLI needs from the environment, falling back to the project's `.env` files the
-* way the bot itself does once it starts.
-*/
-function readDiscordCredentials(config, env = process.env) {
-	const fromFiles = readProjectEnvFilesCached(config);
-	const read = (...keys) => {
-		for (const key of keys) {
-			const value = config.dev.env[key] ?? env[key] ?? fromFiles[key];
-			if (value) return value;
-		}
-		return null;
-	};
-	const token = read("DISCORD_TOKEN", "TOKEN");
-	if (!token) return null;
-	return {
-		token,
-		applicationId: read("DISCORD_APPLICATION_ID", "APPLICATION_ID", "DISCORD_CLIENT_ID", "CLIENT_ID")
-	};
-}
-let envFileCache = null;
-/** The variables the bot loads (see {@link readProjectEnv}), once per project and `env` options. */
-function readProjectEnvFilesCached(config) {
-	const key = JSON.stringify([config.root, config.env.options]);
-	if (envFileCache?.key !== key) envFileCache = {
-		key,
-		values: readProjectEnv(config)
-	};
-	return envFileCache.values;
-}
-
-//#endregion
 //#region src/dev/bridge.ts
 /** Marks a message of the bridge, so a bot using the IPC channel for something else is left alone. */
 const BRIDGE_SOURCE = "stars:bridge";
@@ -467,5 +234,5 @@ function isAtLeast(version, minimum) {
 }
 
 //#endregion
-export { isAtLeast as a, endpointUrl as c, bridgeImportArgs as i, readDiscordCredentials as l, CLI_SOURCE as n, parseBridgeMessage as o, DUMP_ENV as r, Tunnel as s, BRIDGE_FRAMEWORK_VERSION as t };
-//# sourceMappingURL=bridge-BegCt_n2.js.map
+export { isAtLeast as a, bridgeImportArgs as i, CLI_SOURCE as n, parseBridgeMessage as o, DUMP_ENV as r, BRIDGE_FRAMEWORK_VERSION as t };
+//# sourceMappingURL=bridge-Cbm0jX9h.js.map