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

package/dist/esm/{resolve-CBovxOO3.d.ts → resolve-B0J5V4xC.d.ts}

@@ -23,31 +23,247 @@ declare function discoverConfigFile(cwd: string): string | null;
 declare function loadConfigFile(options: LoadConfigFileOptions): Promise<LoadedConfigFile>;
 //#endregion
 //#region src/lib/config/errors.d.ts
-interface ConfigErrorOptions {
-  /** A stable, machine readable code, e.g. `INVALID_TYPE`. */
-  code: string;
-  /** A short, actionable suggestion. */
-  hint?: string;
-  /** The dotted path of the offending option, e.g. `dev.debounce`. */
-  path?: string;
-  /** The configuration file the error originates from. */
-  file?: string | null;
-  cause?: unknown;
-}
 /**
- * A `stars.config.*` error: an invalid option, or a file that failed to load or parse.
+ * Structured, stable diagnostic codes for every way a `stars.config.*` can fail to load or validate.
+ *
+ * This is a plain data error (no exit code or terminal formatting), so nothing here reports anywhere on its own —
+ * `reporters` stays empty and each call only builds and returns a `Diagnostic`. That keeps it meaningful outside a
+ * CLI, e.g. for a dashboard or test that calls {@link loadStarsConfig} directly; `@wolfstar/cli` is what renders it
+ * and picks an exit code (`exitCodeOf`).
  *
- * This is a plain data error (no exit code or terminal formatting) so it stays meaningful outside a CLI, e.g. for a
- * dashboard or test that calls {@link loadStarsConfig} directly. `@wolfstar/cli` maps it to exit code `2` and renders
- * `message`, `path`, `file` and `hint` for the terminal.
+ * The `sources` field (populated with the configuration file, when there is one) carries the "which file" grounding
+ * `ConfigError` used to expose as `.file`; the "which option" grounding it exposed as `.path` is folded directly into
+ * every `why`/`fix` message instead, the way every other diagnostic code already reads.
+ *
+ * `why` and `fix` are always given the same, fully-typed params object (even when one of them ignores part of it):
+ * a bare `() => value` loses nostics' param-type inference (a zero-arg function widens to `unknown` params), so every
+ * entry here spells out its shape on both sides instead.
  */
-declare class ConfigError extends Error {
-  readonly code: string;
-  readonly hint: string | null;
-  readonly path: string | null;
-  readonly file: string | null;
-  constructor(message: string, options: ConfigErrorOptions);
-}
+declare const configDiagnostics: import("nostics").Diagnostics<{
+  readonly ROOT_NOT_FOUND: {
+    why: (p: {
+      root: string;
+    }) => string;
+    fix: (_p: {
+      root: string;
+    }) => string;
+  };
+  readonly PACKAGE_JSON_INVALID: {
+    why: (p: {
+      file: string;
+      message: string;
+    }) => string;
+    fix: (_p: {
+      file: string;
+      message: string;
+    }) => string;
+  };
+  readonly ENTRY_NOT_FOUND: {
+    why: (p: {
+      entry: string;
+    }) => string;
+    fix: (_p: {
+      entry: string;
+    }) => string;
+  };
+  readonly ENTRY_DEFAULT_NOT_FOUND: {
+    why: (p: {
+      root: string;
+      defaults: string;
+    }) => string;
+    fix: (p: {
+      root: string;
+      defaults: string;
+    }) => string;
+  };
+  readonly INVALID_BUILD_TOOL: {
+    why: (p: {
+      tool: string;
+    }) => string;
+    fix: (_p: {
+      tool: string;
+    }) => string;
+  };
+  readonly EXPERIMENTAL_BUILD_TOOL: {
+    why: (p: {
+      tool: string;
+      flag: string;
+    }) => string;
+    fix: (p: {
+      tool: string;
+      flag: string;
+    }) => string;
+  };
+  readonly BUILD_TOOL_REQUIRED: {
+    why: (p: {
+      entry: string;
+    }) => string;
+    fix: (_p: {
+      entry: string;
+    }) => string;
+  };
+  readonly TSCONFIG_EXPLICIT_NOT_FOUND: {
+    why: (p: {
+      tsconfig: string;
+      path: string;
+    }) => string;
+    fix: (p: {
+      tsconfig: string;
+      path: string;
+    }) => string;
+  };
+  readonly TSCONFIG_NOT_FOUND: {
+    why: (p: {
+      root: string;
+      suggestion: string;
+    }) => string;
+    fix: (p: {
+      root: string;
+      suggestion: string;
+    }) => string;
+  };
+  readonly TSDOWN_OPTIONS_REQUIRE_TSDOWN: {
+    why: (_p: {
+      tool: string;
+    }) => string;
+    fix: (p: {
+      tool: string;
+    }) => string;
+  };
+  readonly VITE_OPTIONS_REQUIRE_VITE: {
+    why: (_p: {
+      tool: string;
+    }) => string;
+    fix: (p: {
+      tool: string;
+    }) => string;
+  };
+  readonly TSDOWN_CONFIG_FILE_UNSUPPORTED: {
+    why: (p: {
+      file: string;
+      version: number;
+      legacyVersion: number;
+    }) => string;
+    fix: (p: {
+      file: string;
+      version: number;
+      legacyVersion: number;
+    }) => string;
+  };
+  readonly INVALID_TYPE: {
+    why: (p: {
+      path: string;
+      expected: string;
+      value: unknown;
+      fix: string;
+    }) => string;
+    fix: (p: {
+      path: string;
+      expected: string;
+      value: unknown;
+      fix: string;
+    }) => string;
+  };
+  readonly INVALID_COMPATIBILITY_VERSION: {
+    why: (p: {
+      value: unknown;
+      legacyVersion: number;
+      latestVersion: number;
+    }) => string;
+    fix: (p: {
+      value: unknown;
+      legacyVersion: number;
+      latestVersion: number;
+    }) => string;
+  };
+  readonly UNKNOWN_OPTION: {
+    why: (p: {
+      path: string;
+      parent: string;
+      known: string;
+    }) => string;
+    fix: (p: {
+      path: string;
+      parent: string;
+      known: string;
+    }) => string;
+  };
+  readonly EXPERIMENT_REQUIRED: {
+    why: (p: {
+      path: string;
+      requires: string;
+      drop: string;
+    }) => string;
+    fix: (p: {
+      path: string;
+      requires: string;
+      drop: string;
+    }) => string;
+  };
+  readonly IMPORTS_REQUIRE_TSDOWN: {
+    why: (_p: {}) => string;
+    fix: (_p: {}) => string;
+  };
+  readonly LOCALES_NOT_FOUND: {
+    why: (p: {
+      locales: string;
+    }) => string;
+    fix: (_p: {
+      locales: string;
+    }) => string;
+  };
+  readonly INVALID_URL: {
+    why: (p: {
+      url: string;
+      fix: string;
+    }) => string;
+    fix: (p: {
+      url: string;
+      fix: string;
+    }) => string;
+  };
+  readonly TUNNEL_URL_NOT_HTTPS: {
+    why: (p: {
+      url: string;
+    }) => string;
+    fix: (_p: {
+      url: string;
+    }) => string;
+  };
+  readonly INVALID_TYPECHECKER: {
+    why: (p: {
+      checker: string;
+    }) => string;
+    fix: (_p: {
+      checker: string;
+    }) => string;
+  };
+  readonly CONFIG_NOT_FOUND: {
+    why: (p: {
+      file: string;
+      cwd: string;
+      names: string;
+    }) => string;
+    fix: (p: {
+      file: string;
+      cwd: string;
+      names: string;
+    }) => string;
+  };
+  readonly CONFIG_LOAD_FAILED: {
+    why: (p: {
+      message: string;
+    }) => string;
+    fix: (_p: {
+      message: string;
+    }) => string;
+  };
+  readonly CONFIG_NOT_OBJECT: {
+    why: (_p: {}) => string;
+    fix: (_p: {}) => string;
+  };
+}, readonly []>;
+type ConfigDiagnosticCode = keyof typeof configDiagnostics;
 //#endregion
 //#region src/lib/config/index.d.ts
 interface LoadStarsConfigOptions {
@@ -67,7 +283,7 @@ interface LoadStarsConfigOptions {
 /**
  * Loads, validates and resolves a project's `stars.config.*`.
  *
- * @throws {ConfigError} when the configuration file cannot be loaded or contains an invalid option.
+ * @throws {Diagnostic} (from `nostics`, via {@link configDiagnostics}) when the configuration file cannot be loaded or contains an invalid option.
  */
 declare function loadStarsConfig(options?: LoadStarsConfigOptions): Promise<ResolvedStarsConfig>;
 //#endregion
@@ -374,7 +590,7 @@ interface StarsNitroConfig {
  *
  * `enableExternalVite`, `enableNitro` and `nitro` build on `enableVite` (and `nitro` on `enableNitro` too): the type
  * only accepts them once their prerequisite is `true`, so turning one on without the other is a type error here
- * instead of a `ConfigError` at load time.
+ * instead of a diagnostic at load time.
  */
 type StarsExperimentalConfig = {
   enableVite?: false;
@@ -390,9 +606,8 @@ type StarsExperimentalConfig = {
   /**
    * Runs the bot through Vite itself, the way `nuxt dev` runs on Vite's own dev server: instead of
    * building then restarting a child `node` process on every change, `stars dev` loads the entry through
-   * Vite's SSR module graph and serves it — through `@wolfstar/http-framework/fetch`'s
-   * `createFetchHandler` — from one long-lived process, invalidating and re-evaluating just the entry's
-   * module graph on a change instead of restarting.
+   * Vite's SSR module graph and serves it — through `Client#fetch` — from one long-lived process,
+   * invalidating and re-evaluating just the entry's module graph on a change instead of restarting.
    *
    * With this on, the entry's default export must be the `Client` instance (already `load()`ed, not
    * `listen()`ed) rather than a script that calls `client.listen()` itself — `stars dev` owns the socket.
@@ -406,12 +621,14 @@ type StarsExperimentalConfig = {
   /**
    * Builds the bot through [Nitro](https://nitro.build) instead of a `node:http` server, so `stars build`
    * produces a server deployable to any of Nitro's presets (`node-server` locally, `cloudflare-module`,
-   * `aws-lambda`, `vercel`, `netlify`, `bun`, `deno-deploy`, and more) from the same
-   * `@wolfstar/http-framework/fetch` handler `enableExternalVite` already runs in dev — no per-platform
-   * adapter to maintain.
+   * `aws-lambda`, `vercel`, `netlify`, `bun`, `deno-deploy`, and more). Nitro v3 is itself a Vite plugin, so
+   * this builds through the project's own `vite.config.*`/{@link StarsConfig.vite} the same way `build.tool:
+   * 'vite'` does, with a generated server entry that wraps the entry's default export (the `Client`
+   * instance, already `load()`ed rather than `listen()`ed — `stars build`/`stars dev` own the socket) in a
+   * call to `Client#fetch` — no per-preset adapter to maintain.
    *
-   * Output goes to `.output/` (Nitro's own convention) instead of `build.outDir`. The entry's default
-   * export must be the `Client` instance, the same as `enableExternalVite`.
+   * Output goes to `.output/` (Nitro's own convention) instead of `build.outDir`. `stars dev` rebuilds and
+   * restarts on every change, the same as the other build tools.
    */
   enableNitro: true;
   /** Nitro-specific options, reachable only with `enableNitro: true`. */
@@ -591,7 +808,7 @@ interface ResolveConfigOptions {
 /**
  * Applies defaults, validates every option and resolves all paths to absolute ones.
  *
- * @throws {ConfigError} with an actionable `hint` on the first invalid option.
+ * @throws {Diagnostic} (from `nostics`, via {@link configDiagnostics}) with an actionable `fix` on the first invalid option.
  */
 declare function resolveStarsConfig(options: ResolveConfigOptions): ResolvedStarsConfig;
 /**
@@ -608,5 +825,5 @@ declare function displayPath(root: string, path: string): string;
  */
 declare function readProjectEnvFiles(root: string, environment?: string): Record<string, string>;
 //#endregion
-export { StarsTypecheckConfig as A, LoadConfigFileOptions as B, StarsExperimentalConfig as C, StarsNitroConfig as D, StarsImportsConfig as E, loadStarsConfig as F, discoverConfigFile as H, ConfigError as I, ConfigErrorOptions as L, StarsViteConfig as M, defineConfig as N, StarsTsdownConfig as O, LoadStarsConfigOptions as P, CONFIG_EXTENSIONS as R, StarsDevConfig as S, StarsI18nCodegenConfig as T, loadConfigFile as U, LoadedConfigFile as V, StarsBuildConfig as _, ResolvedDevConfig as a, StarsCompatibilityVersion as b, ResolvedI18nCodegenConfig as c, ResolvedStarsConfig as d, ResolvedTunnelConfig as f, resolveStarsConfig as g, readProjectEnvFiles as h, ResolvedCodegenConfig as i, StarsTypechecker as j, StarsTunnelConfig as k, ResolvedImportsConfig as l, displayPath as m, ResolveConfigOptions as n, ResolvedExperimentalConfig as o, ResolvedTypecheckConfig as p, ResolvedBuildConfig as r, ResolvedFutureConfig as s, PackageJsonLike as t, ResolvedNitroConfig as u, StarsBuildTool as v, StarsFutureConfig as w, StarsConfig as x, StarsCodegenConfig as y, CONFIG_FILE_NAMES as z };
-//# sourceMappingURL=resolve-CBovxOO3.d.ts.map
+export { StarsTypecheckConfig as A, LoadConfigFileOptions as B, StarsExperimentalConfig as C, StarsNitroConfig as D, StarsImportsConfig as E, loadStarsConfig as F, discoverConfigFile as H, ConfigDiagnosticCode as I, configDiagnostics as L, StarsViteConfig as M, defineConfig as N, StarsTsdownConfig as O, LoadStarsConfigOptions as P, CONFIG_EXTENSIONS as R, StarsDevConfig as S, StarsI18nCodegenConfig as T, loadConfigFile as U, LoadedConfigFile as V, StarsBuildConfig as _, ResolvedDevConfig as a, StarsCompatibilityVersion as b, ResolvedI18nCodegenConfig as c, ResolvedStarsConfig as d, ResolvedTunnelConfig as f, resolveStarsConfig as g, readProjectEnvFiles as h, ResolvedCodegenConfig as i, StarsTypechecker as j, StarsTunnelConfig as k, ResolvedImportsConfig as l, displayPath as m, ResolveConfigOptions as n, ResolvedExperimentalConfig as o, ResolvedTypecheckConfig as p, ResolvedBuildConfig as r, ResolvedFutureConfig as s, PackageJsonLike as t, ResolvedNitroConfig as u, StarsBuildTool as v, StarsFutureConfig as w, StarsConfig as x, StarsCodegenConfig as y, CONFIG_FILE_NAMES as z };
+//# sourceMappingURL=resolve-B0J5V4xC.d.ts.map

package/dist/esm/resolve-B0J5V4xC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-B0J5V4xC.d.ts","names":[],"sources":["../../src/lib/config/load.ts","../../src/lib/config/errors.ts","../../src/lib/config/index.ts","../../src/config.ts","../../src/lib/config/resolve.ts"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wolfstar/http-framework",
-  "version": "4.0.2",
+  "version": "5.0.0-next-20260919162943",
   "description": "The framework for Star Network's HTTP-only bots",
   "keywords": [
     "api",
@@ -47,12 +47,6 @@
         "types": "./dist/esm/auto-imports.d.ts",
         "default": "./dist/esm/auto-imports.js"
       }
-    },
-    "./fetch": {
-      "import": {
-        "types": "./dist/esm/fetch.d.ts",
-        "default": "./dist/esm/fetch.js"
-      }
     }
   },
   "publishConfig": {
@@ -72,6 +66,7 @@
     "chokidar": "^5.0.0",
     "discord-api-types": "^0.38.8",
     "mlly": "^1.8.2",
+    "nostics": "^1.2.0",
     "unimport": "^7.0.2"
   },
   "devDependencies": {