@cosmicdrift/kumiko-dev-server 0.342.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.342.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.342.0",
-    "@cosmicdrift/kumiko-framework": "0.342.0",
-    "@cosmicdrift/kumiko-headless": "0.342.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.342.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.342.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"