@cosmicdrift/kumiko-types 0.282.0 → 0.284.0

package/package.json

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

@@ -984,6 +984,12 @@ export type AggregateStreamHandle = {
   // expectedVersion from the handle automatically. Multiple calls in a
   // row bump the handle's internal version and the events-table in order.
   readonly appendOne: (args: { readonly type: string; readonly payload: unknown }) => Promise<void>;
+  // Idempotency check against `events` (fetch-time snapshot only — an
+  // appendOne in the same handler isn't reflected). Guards a handler that
+  // may run twice against the same stream without risking a false
+  // "already succeeded" read that appendIfAbsent-style helpers would give
+  // on a genuine optimistic-concurrency conflict.
+  readonly hasEvent: (type: string) => boolean;
 };
 
 // --- Event Upcasters (schema migration) ---