@cosmicdrift/kumiko-types 0.289.0 → 0.290.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.289.0",
+  "version": "0.290.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,10 @@
 [
+  {
+    "version": "0.290.0",
+    "type": "improvement",
+    "title": "EventMetadata: feature + handler + UNATTRIBUTED_ORIGIN",
+    "detail": "EventMetadata traegt zwei neue optionale Felder (feature, handler) und exportiert die Sentinel-Konstante UNATTRIBUTED_ORIGIN fuer Appends ausserhalb eines attribuierten Ausfuehrungsscopes. Additiv, bestehende Zeilen bleiben ohne Backfill lesbar."
+  },
   {
     "version": "0.289.0",
     "type": "improvement",

package/src/event-store-types.ts

@@ -37,8 +37,21 @@ export type EventMetadata = {
   // app reads them when filtering/auditing. Keep values JSON-primitive
   // (string|number|boolean) so JSON serialization stays bulletproof.
   readonly headers?: Readonly<Record<string, string | number | boolean>>;
+  // Feature that owned the execution scope which wrote this event, and the
+  // qualified name of the handler/consumer/job inside it. Derived in
+  // event-store.append() from the ambient request scope, never passed in by
+  // the writer — attribution handed over can lie, attribution derived cannot.
+  // Optional so rows written before #3043 stay readable without a backfill;
+  // every new row carries both, falling back to UNATTRIBUTED_ORIGIN.
+  readonly feature?: string;
+  readonly handler?: string;
 };
 
+// Stamped when an append runs outside any attributed scope (seed scripts,
+// tests, direct event-store use). A distinct value, not an omission —
+// omitted would be indistinguishable from a pre-#3043 row.
+export const UNATTRIBUTED_ORIGIN = "unknown";
+
 // Generic over the payload shape. Default = Record<string, unknown> keeps
 // all existing consumers backwards-compatible; annotate `StoredEvent<MyEventPayload>`
 // where a typed payload read is needed.