@cosmicdrift/kumiko-types 0.335.0 → 0.336.1

package/dist/define-handler.d.ts

@@ -47,6 +47,10 @@ export type QueryHandlerDefinition<TName extends string = string, TSchema extend
      *  that want boot-time column checks declare `outputSchema` explicitly,
      *  same as `schema` for the input side. */
     readonly outputSchema?: ZodType;
+    /** Entities whose changes this query reflects. Anonymous callers with
+     *  access to this query receive /api/sse change signals (no field values)
+     *  for these entities. Every name must be a registered entity. */
+    readonly liveEntities?: readonly string[];
 };
 export type StreamHandlerDefinition<TName extends string = string, TSchema extends ZodType = ZodType, TChunk = unknown, TMap extends object = KumikoEventTypeMap> = {
     readonly name: TName;

package/dist/entity-handlers.d.ts

@@ -22,7 +22,10 @@ export type EntityWriteHandlerOptions = EntityHandlerOptions & {
     /** Fields this handler never writes. They leave the payload schema as
      *  "must be absent": a payload that still carries one fails validation
      *  instead of being stripped silently. create rejects a required field
-     *  without default here, since the row could never be created. */
+     *  without default here, since the row could never be created. A readAsInstruction
+     *  field excluded here but derived by a preSave hook is invisible to the
+     *  define-time risk floor: declare `agent: { risk: "high" }` explicitly, or the
+     *  executor gate rejects every call. */
     readonly excludeFields?: readonly string[];
 };
 export type EntityQueryHandlerOptions = EntityHandlerOptions;

package/dist/feature.d.ts

@@ -225,6 +225,7 @@ export type FeatureRegistrar<TFeature extends string = string> = {
         access: AccessRule;
         rateLimit?: RateLimitDeclaration;
         outputSchema?: ZodType;
+        liveEntities?: readonly string[];
         description?: string;
         agent?: AgentHandlerHints;
         escapeHatch?: EscapeHatchDeclaration;

package/dist/handlers.d.ts

@@ -480,6 +480,10 @@ export type QueryHandlerDef = {
      *  `header`/`metrics`, dashboard `valueField`/`subField`/etc.) rather
      *  than requiring it retroactively. See fw#2493. */
     readonly outputSchema?: ZodType;
+    /** Entities whose changes this query reflects. Anonymous callers with
+     *  access to this query receive /api/sse change signals (no field values)
+     *  for these entities. Every name must be a registered entity. */
+    readonly liveEntities?: readonly string[];
     readonly escapeHatch?: EscapeHatchDeclaration;
 };
 export type StreamHandlerDef = {

package/dist/screen.d.ts

@@ -969,7 +969,8 @@ export type EditRelatedListSection = {
     readonly itemNoun?: string;
     readonly pageSize?: number;
     /** Initial sort on mount, applied client-side over the already-loaded rows
-     *  (this section has no pager, so there is no "loaded subset" to mislead).
+     *  (this section has no pager; if the fetch is truncated, `nextCursor !== null`,
+     *  the section shows a hint banner that the sort covers only the loaded rows).
      *  `field` must name a column with `sortable: true` — boot-validator pins
      *  that, same as `entityList.defaultSort`. */
     readonly defaultSort?: ListSortSpec;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.335.0",
+  "version": "0.336.1",
   "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/changes.json

@@ -1,4 +1,11 @@
 [
+  {
+    "version": "0.336.0",
+    "type": "improvement",
+    "title": "Query handlers can declare liveEntities",
+    "detail": "`QueryHandlerDefinition` and the inline `queryHandler` options accept `liveEntities`, the entities whose changes the query reflects. Anonymous callers with access to the query receive /api/sse change signals for them.",
+    "migration": "No code change needed."
+  },
   {
     "version": "0.335.0",
     "type": "improvement",