@cosmicdrift/kumiko-types 0.167.1 → 0.170.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.167.1",
+  "version": "0.170.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

@@ -18,6 +18,8 @@ export type RegisterEntityCrudOptions = {
   readonly write?: EntityHandlerOptions;
   readonly read?: EntityQueryHandlerOptions;
   readonly verbs?: Partial<Record<EntityCrudVerb, boolean>>;
+  /** Per-verb access override — falls back to `write.access`/`read.access` when unset for a verb. */
+  readonly verbAccess?: Partial<Record<EntityCrudVerb, AccessRule>>;
   /** Default true. Set false when the entity was already registered (e.g. before r.relation). */
   readonly registerEntity?: boolean;
 };

package/src/event-store-executor-types.ts

@@ -5,18 +5,29 @@ import type { EntityId } from "./identifiers";
 import type { SearchAdapter } from "./search-adapter";
 import type { TenantDb } from "./tenant-db-types";
 
+// Runs the caller's preSave hooks against changes not yet persisted, for
+// the executor's create()/update() only — restore/delete/forget have no
+// `changes` to shape. See HandlerContext.runPreSave for how this gets bound
+// to a specific handler name + AppContext.
+export type PreSaveRunner = (
+  changes: Record<string, unknown>,
+  previous: Readonly<Record<string, unknown>>,
+  isNew: boolean,
+) => Promise<Record<string, unknown>>;
+
 export type EventStoreExecutor = {
   create: (
     payload: Record<string, unknown>,
     user: SessionUser,
     db: TenantDb,
+    options?: { preSave?: PreSaveRunner },
   ) => Promise<WriteResult<SaveContext>>;
 
   update: (
     payload: { id: EntityId; version?: number | undefined; changes: Record<string, unknown> },
     user: SessionUser,
     db: TenantDb,
-    options?: { skipOptimisticLock?: boolean; skipUnchanged?: boolean },
+    options?: { skipOptimisticLock?: boolean; skipUnchanged?: boolean; preSave?: PreSaveRunner },
   ) => Promise<WriteResult<SaveContext>>;
 
   delete: (

package/src/handlers.ts

@@ -354,6 +354,21 @@ export type HandlerContext<TMap extends object = KumikoEventTypeMap> = SharedCon
   // still apply, so this never widens what a user may see beyond the live list.
   readonly includeDeleted?: boolean;
 
+  // Wired by the write dispatcher whenever a lifecycle pipeline is active;
+  // runs the registered `preSave` hooks (+ system preSave hooks) for
+  // `handlerName`, returning the hook-transformed `changes`. Entity CRUD
+  // handlers (create/update) forward this to the executor so preSave hooks
+  // actually run before persistence (kumiko-framework#1672). A custom
+  // `r.writeHandler` handler that doesn't go through the executor must call
+  // this itself to get preSave semantics — undefined when no lifecycle
+  // pipeline is wired (e.g. bare HandlerContext stubs in unit tests).
+  readonly runPreSave?: (
+    handlerName: string,
+    changes: Record<string, unknown>,
+    previous: Readonly<Record<string, unknown>>,
+    isNew: boolean,
+  ) => Promise<Record<string, unknown>>;
+
   readonly query: (qn: string, payload: unknown) => Promise<unknown>;
   readonly queryAs: (user: SessionUser, qn: string, payload: unknown) => Promise<unknown>;
   readonly write: (qn: string, payload: unknown) => Promise<WriteResult>;