@cosmicdrift/kumiko-types 0.334.0 → 0.336.0

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;
@@ -473,6 +474,7 @@ export type Registry = {
     isHandlerSystemScoped(qualifiedHandler: string): boolean;
     isJobSystemScoped(qualifiedJobName: string): boolean;
     getHandlerFeature(qualifiedHandler: string): string | undefined;
+    getJobFeature(qualifiedJobName: string): string | undefined;
     hasRateLimitedHandler(): boolean;
     getAllMetrics(): ReadonlyMap<string, FeatureMetricDef & {
         readonly featureName: string;

package/dist/fields.d.ts

@@ -99,7 +99,9 @@ export type TextFieldDef = {
      *  {rows} / flat results; an unbound custom query handler that returns
      *  executor rows must call maskWriteOnlyFields itself (same scope limit as
      *  access.read). Requires `sensitive` (via `find: "secret"`); forbidden with
-     *  default/searchable/sortable/filterable/lookupable and on screen/form fields. */
+     *  default/searchable/sortable/filterable/lookupable and on inline form fields
+     *  (actionForm/wizard). Allowed on configEdit text fields only over an
+     *  encrypted-at-rest config key, where it is also set automatically. */
     readonly writeOnly?: boolean;
     /** A later run reads this field's value as an instruction — prompt, rule,
      *  template. Every create/update whose payload writes it requires agent.risk

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

@@ -115,12 +115,14 @@ export type ListColumnSpec = string | {
     readonly hideOnNarrow?: boolean;
     /** Dashboard list panels only. "bar": field holds a 0..1 fraction, drawn
      *  as bar + percent. "badge": field holds a label, drawn as a pill whose
-     *  tone comes from `badgeToneField`. Other list renderers ignore it. */
+     *  tone comes from `badgeToneField`. "datetime": field holds an ISO string or
+     *  epoch ms, shown in the user's locale and time zone. Other list renderers
+     *  ignore it. */
     readonly display?: ListColumnDisplay;
     /** Row field naming the badge tone; only with `display: "badge"`. */
     readonly badgeToneField?: string;
 };
-export type ListColumnDisplay = "bar" | "badge";
+export type ListColumnDisplay = "bar" | "badge" | "datetime";
 export type ListBadgeTone = "positive" | "warn" | "negative" | "neutral";
 export type ListPaginationMode = "pages" | "infinite" | false;
 export type ListSortDir = "asc" | "desc";
@@ -194,6 +196,14 @@ export type RowActionWriteHandler = {
     readonly icon?: IconKey;
     /** Inline render form in the row-action column — see `RowActionDisplay`. */
     readonly display?: RowActionDisplay;
+    /** Where to go after the write succeeded instead of staying on the shown
+     *  record. Same forms as entityEdit `redirect`. Honored on record actions
+     *  (projectionDetail header/section actions, entityEdit header/section
+     *  actions); a valid `returnTo` wins under the same rule as
+     *  entityEdit.redirect. Not used by list row actions. Without it, an action
+     *  deleting the shown record (`<feature>:write:<entity>:delete` with that
+     *  record's id) leaves to `returnTo`/the list; any other action refetches. */
+    readonly redirect?: string | ActionFormRedirect;
 };
 export type RowActionNavigateBase = {
     readonly kind: "navigate";

package/package.json

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

@@ -1,4 +1,18 @@
 [
+  {
+    "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",
+    "title": "RowActionWriteHandler gets an optional redirect for record actions",
+    "detail": "`redirect` takes the same forms as entityEdit `redirect` and is honored on projectionDetail and entityEdit header and section actions, not on list row actions.",
+    "migration": "No code change needed."
+  },
   {
     "version": "0.328.1",
     "type": "improvement",