@cosmicdrift/kumiko-types 0.185.0 → 0.186.0

package/package.json

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

@@ -504,6 +504,20 @@ export type HandlerContext<TMap extends object = KumikoEventTypeMap> = SharedCon
   // Feature code can call ctx.metrics.inc(...) / ctx.tracer.startSpan(...)
   // without null-checks.
   readonly metrics: MetricsHandle;
+
+  // For shared/library code invoked from many features' HandlerContext
+  // (e.g. a helper package called by several consumer features): binds to
+  // `featureName` instead of the dispatching handler's own feature, so the
+  // library counts under one stable kumiko_<featureName>_x name instead of
+  // splintering per caller. `featureName` accepts the same kebab-case form
+  // used as the feature's own name at defineFeature() — normalized to
+  // snake_case internally before resolving the metric name.
+  //
+  // Unlike ctx.metrics, an unregistered metric name here is a silent
+  // no-op, not a throw (framework#1844) — this handle is meant for
+  // error/catch-path counters in shared code, where a missing registration
+  // must not turn an already-swallowed error into a thrown one.
+  readonly metricsFor: (featureName: string) => MetricsHandle;
   readonly tracer: Tracer;
 
   // Time + TZ helper. Feature code MUST go through this instead of