@cosmicdrift/kumiko-types 0.225.0 → 0.226.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.225.0",
+  "version": "0.226.0",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/define-handler.ts

@@ -91,6 +91,13 @@ export type QueryHandlerDefinition<
     query: QueryEvent<z.infer<TSchema>>,
     context: HandlerContext<TMap>,
   ) => Promise<TResult>;
+  /** Zod schema of `handler`'s actual return value — see QueryHandlerDef's
+   *  doc (handlers.ts) for the boot-validator checks this unlocks. Not
+   *  inferred from `TResult`: TResult is a compile-time-only type param
+   *  (this function never receives a runtime schema for it), so callers
+   *  that want boot-time column checks declare `outputSchema` explicitly,
+   *  same as `schema` for the input side. */
+  readonly outputSchema?: ZodType;
 };
 
 // --- Stream Handler Definition ---

package/src/feature.ts

@@ -463,7 +463,7 @@ export type FeatureRegistrar<TFeature extends string = string> = {
     name: string,
     schema: TSchema,
     handler: QueryHandlerFn<z.infer<TSchema>>,
-    options?: { access?: AccessRule; rateLimit?: RateLimitOption },
+    options?: { access?: AccessRule; rateLimit?: RateLimitOption; outputSchema?: ZodType },
   ): HandlerRef;
 
   streamHandler<TName extends string, TSchema extends ZodType>(

package/src/handlers.ts

@@ -952,6 +952,15 @@ export type QueryHandlerDef = {
   readonly handler: QueryHandlerFn;
   readonly access?: AccessRule;
   readonly rateLimit?: RateLimitOption;
+  /** Zod schema of the handler's actual return value — the paged envelope
+   *  `{ rows, nextCursor, total? }` for a `definePagedQueryHandler`, or the
+   *  flat record (optionally `.nullable()`) for a plain query handler.
+   *  Optional and purely additive: absent on every existing handler, and
+   *  the boot-validator skips any column-reference check that would need
+   *  it (screens.ts projectionList/relatedList `columns`, projectionDetail
+   *  `header`/`metrics`, dashboard `valueField`/`subField`/etc.) rather
+   *  than requiring it retroactively. See fw#2493. */
+  readonly outputSchema?: ZodType;
 };
 
 export type StreamHandlerDef = {