@cosmicdrift/kumiko-dev-server 0.341.0 → 0.343.0

package/dist/create-kumiko-server.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="bun-types" preserve="true" />
 import { type AuthRoutesConfig, type ExtraRouteDefinition } from "@cosmicdrift/kumiko-framework/api";
 import { type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
+import type { ErrorDocsConfig } from "@cosmicdrift/kumiko-framework/errors";
 import { type TestStack, type TestStackOptions } from "@cosmicdrift/kumiko-framework/stack";
 import { type PageHeadResolver, type PageHeadSystemQuery } from "@cosmicdrift/kumiko-headless/apex";
 import { type SystemWireDeps } from "@cosmicdrift/kumiko-server-runtime/extra-routes-deps";
@@ -163,6 +164,8 @@ export type CreateKumikoServerOptions = {
      *  `ServerOptions.trustedProxyHops`. Dev usually runs unproxied, so this
      *  is normally left unset (default 0). */
     readonly trustedProxyHops?: number;
+    /** Links the app's own error reasons to its own docs (`docsUrl` in error responses); framework reasons keep the framework docs link. */
+    readonly errorDocs?: ErrorDocsConfig;
     /** Hook for app-wired co-running components that need the system-write
      *  dispatcher — runs after buildServer, before onAfterSetup (seeds), with
      *  NO `app` (routes are declared via `extraRoutes`, not wired here). */

package/dist/create-kumiko-server.js

@@ -602,6 +602,7 @@ export async function createKumikoServer(options) {
         }),
         ...(options.extraRoutes !== undefined && { extraRoutes: options.extraRoutes }),
         ...(options.trustedProxyHops !== undefined && { trustedProxyHops: options.trustedProxyHops }),
+        ...(options.errorDocs && { errorDocs: options.errorDocs }),
         // jobs.consumerLane unset = enqueuer-only; startDevJobRunners below is
         // the sole consumer/cron-scheduler per lane, so runOnBoot/cron jobs
         // don't double-fire. queueNamePrefix keeps this boot's queues isolated

package/dist/run-dev-app.d.ts

@@ -2,6 +2,7 @@ import { type SeedAdminOptions } from "@cosmicdrift/kumiko-bundled-features/auth
 import type { PostAuthLandingResolver } from "@cosmicdrift/kumiko-framework/api";
 import { type KmsAdapter } from "@cosmicdrift/kumiko-framework/crypto";
 import { type FeatureDefinition, type Registry, type ValidateBootOptions } from "@cosmicdrift/kumiko-framework/engine";
+import type { ErrorDocsConfig } from "@cosmicdrift/kumiko-framework/errors";
 import type { EnvelopeCipher, MasterKeyProvider } from "@cosmicdrift/kumiko-framework/secrets";
 import type { TestStack } from "@cosmicdrift/kumiko-framework/stack";
 import type { PageHeadResolver } from "@cosmicdrift/kumiko-headless/apex";
@@ -169,6 +170,8 @@ export type RunDevAppOptions = {
      *  env var. Dev usually runs unproxied, so this is normally left unset
      *  (default 0). */
     readonly trustedProxyHops?: number;
+    /** Links the app's own error reasons to its own docs (`docsUrl` in error responses); framework reasons keep the framework docs link. */
+    readonly errorDocs?: ErrorDocsConfig;
 };
 export declare function runDevApp(options: RunDevAppOptions): Promise<KumikoServerHandle>;
 export declare function mergeConfigResolverDefault(ctx: CreateKumikoServerOptions["extraContext"], registry: Registry, envSource: Record<string, string | undefined>, cipher?: EnvelopeCipher): CreateKumikoServerOptions["extraContext"];

package/dist/run-dev-app.js

@@ -32,7 +32,7 @@ import { assertSessionBootInvariants } from "@cosmicdrift/kumiko-server-runtime/
 import { watchAndRegenerate } from "./codegen/index.js";
 import { createKumikoServer, } from "./create-kumiko-server.js";
 import { renderWelcomeBanner } from "./welcome-banner.js";
-import { addConfigAccessorFactory, buildBootExtraContext, requireEnv, resolveAuthMail, } from "@cosmicdrift/kumiko-server-runtime/run-prod-app";
+import { addConfigAccessorFactory, buildBootExtraContext, loggerFromExtraContext, requireEnv, resolveAuthMail, } from "@cosmicdrift/kumiko-server-runtime/run-prod-app";
 export async function runDevApp(options) {
     // Auto-mix Standard-Features im auth-mode via composeFeatures (single
     // source of truth — auch runProdApp und der per-app drizzle-Schema-
@@ -156,6 +156,8 @@ export async function runDevApp(options) {
     // mit hasAuth:false (configResolver kommt schon aus cfgExtra), App-Werte
     // (cfgExtra) gewinnen über die Boot-Defaults.
     const extraContext = (deps) => {
+        const base = typeof cfgExtra === "function" ? cfgExtra(deps) : (cfgExtra ?? {});
+        const bootLogger = loggerFromExtraContext(base);
         const boot = buildBootExtraContext({
             db: deps.db,
             features,
@@ -164,8 +166,8 @@ export async function runDevApp(options) {
             hasAuth: false,
             sseBroker: deps.sseBroker,
             crypto: bootCrypto,
+            ...(bootLogger && { log: bootLogger }),
         });
-        const base = typeof cfgExtra === "function" ? cfgExtra(deps) : (cfgExtra ?? {});
         return {
             ...boot,
             ...(options.defaultLocale !== undefined && { defaultLocale: options.defaultLocale }),
@@ -219,6 +221,7 @@ export async function runDevApp(options) {
     const handle = await createKumikoServer({
         features,
         ...(options.clientEntry !== undefined && { clientEntry: options.clientEntry }),
+        ...(options.errorDocs && { errorDocs: options.errorDocs }),
         ...(options.clientEntries !== undefined && { clientEntries: options.clientEntries }),
         ...(options.hostDispatch !== undefined && { hostDispatch: options.hostDispatch }),
         ...(options.resolvePageHead !== undefined && { resolvePageHead: options.resolvePageHead }),

package/dist/scaffold-app.js

@@ -37,6 +37,8 @@ export async function scaffoldApp(options) {
     files.push("package.json");
     write(join(destination, "tsconfig.json"), renderTsconfig());
     files.push("tsconfig.json");
+    write(join(destination, "kumiko.json"), renderKumikoManifest());
+    files.push("kumiko.json");
     write(join(destination, "biome.json"), renderBiomeJson());
     files.push("biome.json");
     if (testSetup === undefined) {
@@ -752,6 +754,16 @@ function renderKumikoSchema() {
         "",
     ].join("\n");
 }
+// `kumiko check` fails a kind "app" without uiRoots, so a fresh app must declare them.
+function renderKumikoManifest() {
+    return `${JSON.stringify({
+        kind: "app",
+        sourceRoots: ["src", "bin"],
+        testGlobs: ["src/**/*.{test,integration}.{ts,tsx}"],
+        uiRoots: ["src/features/*/web"],
+        excludes: ["**/node_modules/**", "**/dist/**"],
+    }, null, 2)}\n`;
+}
 function renderBinKumiko() {
     return [
         "#!/usr/bin/env bun",
@@ -761,8 +773,10 @@ function renderBinKumiko() {
         "// consumer status|restart <name>` to recover a dead event consumer without",
         "// ad-hoc SQL. kumiko-build bundles this file to dist-server/kumiko.js.",
         "",
+        'import { frameworkCoreEnvSchema } from "@cosmicdrift/kumiko-dev-server/env-schema";',
         'import { composeFeatures } from "@cosmicdrift/kumiko-server-runtime/compose-features";',
         'import { runConsumerCli } from "@cosmicdrift/kumiko-framework/consumer-cli";',
+        'import { composeEnvSchema, kmsSlotsOf } from "@cosmicdrift/kumiko-framework/env";',
         'import { runSchemaCli } from "@cosmicdrift/kumiko-framework/schema-cli";',
         'import { APP_FEATURES, HAS_AUTH } from "../src/run-config";',
         "",
@@ -772,7 +786,8 @@ function renderBinKumiko() {
         "",
         'if (cmd === "schema") {',
         "  const features = composeFeatures([...APP_FEATURES], { includeBundled: HAS_AUTH });",
-        "  process.exit(await runSchemaCli(rest, process.env.INIT_CWD ?? process.cwd(), out, { features }));",
+        "  const kmsSlots = kmsSlotsOf(composeEnvSchema({ core: frameworkCoreEnvSchema, features }).schema);",
+        "  process.exit(await runSchemaCli(rest, process.env.INIT_CWD ?? process.cwd(), out, { features, kmsSlots }));",
         "}",
         "",
         'if (cmd === "consumer") {',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.341.0",
+  "version": "0.343.0",
   "description": "Dev-tooling for Kumiko apps: local dev-server bootstrap (runDevApp), scaffolding, codegen. Its compose-stacks/env-schema subpaths are consumed at prod boot too — see @cosmicdrift/kumiko-server-runtime for the prod runner itself.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -64,11 +64,11 @@
     "kumiko-upgrade": "./bin/kumiko-upgrade.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.341.0",
-    "@cosmicdrift/kumiko-framework": "0.341.0",
-    "@cosmicdrift/kumiko-headless": "0.341.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.341.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.341.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.343.0",
+    "@cosmicdrift/kumiko-framework": "0.343.0",
+    "@cosmicdrift/kumiko-headless": "0.343.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.343.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.343.0",
     "bun-types": "^1.3.13",
     "ts-morph": "^28.0.0",
     "zod": "^4.4.3"