@cosmicdrift/kumiko-types 0.316.0 → 0.318.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.316.0",
+  "version": "0.318.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/entity-handlers.ts

@@ -25,6 +25,15 @@ export type EntityHandlerOptions = {
   readonly crossTenant?: boolean;
 };
 
+/** Options for the generic create/update handlers. */
+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. */
+  readonly excludeFields?: readonly string[];
+};
+
 export type EntityQueryHandlerOptions = EntityHandlerOptions;
 
 export type EntityCrudVerb = "create" | "update" | "delete" | "restore" | "list" | "detail";
@@ -44,6 +53,9 @@ export type RegisterEntityCrudOptions = {
    *  manifest exposes only the verbs described here (fail-closed, same rule as
    *  hand-written handlers). Falls back to `write.description`/`read.description`. */
   readonly descriptions?: Partial<Record<EntityCrudVerb, string>>;
+  /** Per-verb `excludeFields` for the generic create/update handlers — see
+   *  EntityWriteHandlerOptions. */
+  readonly excludeFields?: Partial<Record<"create" | "update", readonly string[]>>;
   /** Default true. Set false when the entity was already registered (e.g. before r.relation). */
   readonly registerEntity?: boolean;
 };