@cosmicdrift/kumiko-types 0.184.0 → 0.186.0

package/package.json

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

@@ -400,13 +400,31 @@ type EmbeddedSubFieldBase = {
  *  could describe. */
 export type EmbeddedSubFieldDef =
   | (EmbeddedSubFieldBase & {
-      readonly type: "text" | "number" | "boolean" | "date" | "money";
+      readonly type: "text" | "number" | "boolean" | "date" | "money" | "timestamp";
     })
   | (EmbeddedSubFieldBase & {
       readonly type: "decimal";
       readonly scale: number;
+    })
+  | (EmbeddedSubFieldBase & {
+      readonly type: "select";
+      readonly options: readonly string[];
+    })
+  | (EmbeddedSubFieldBase & {
+      readonly type: "reference";
+      readonly entity: string;
+      readonly labelField?: string;
     });
 
+/** A cell computed from other cells of the same row. `from` names the
+ *  sub-fields the operation reads (order matters for `subtract`). Purely
+ *  renderer metadata — the derived value is still validated like any other
+ *  value of its declared sub-field type in `schema`. */
+export type EmbeddedDerivedCellDef = {
+  readonly op: "multiply" | "sum" | "subtract";
+  readonly from: readonly string[];
+};
+
 export type EmbeddedFieldDef = {
   readonly type: "embedded";
   readonly required?: boolean;
@@ -424,6 +442,21 @@ export type EmbeddedFieldDef = {
    *  the head — an embedded array is rewritten whole on every change and has
    *  no per-row history. */
   readonly multiple?: boolean;
+  /** Minimum row count for an embedded list. Only valid with `multiple: true`. */
+  readonly minItems?: number;
+  /** Maximum row count for an embedded list. Only valid with `multiple: true`. */
+  readonly maxItems?: number;
+  /** Renderer metadata: sub-field name → how to compute its cell from other
+   *  sub-fields of the same row. Only valid with `multiple: true`. */
+  readonly derived?: Readonly<Record<string, EmbeddedDerivedCellDef>>;
+  /** Renderer metadata: numeric sub-field names to sum in a totals row. Only
+   *  valid with `multiple: true`. */
+  readonly totals?: readonly string[];
+  /** Maps an embedded-list subfield name to a sibling top-level money field
+   *  name — the sum of that subfield across all rows must equal the sibling
+   *  field's amount. Validated both client- and server-side (schema-builder
+   *  superRefine). Only meaningful with `multiple: true`. */
+  readonly totalsMatch?: Readonly<Record<string, string>>;
 } & PiiAnnotations;
 
 // Free-form jsonb — keys/shape NOT validated at write-time. Use for:

package/src/handlers.ts

@@ -338,6 +338,9 @@ export type AppContext = SharedContextFields & {
 // type-map (runtime-pluggable events) uses `unsafeAppendEvent`.
 export type HandlerContext<TMap extends object = KumikoEventTypeMap> = SharedContextFields & {
   readonly db: TenantDb;
+  // Same tenant scoping as `db`, but never bound to the handler's tx: writes
+  // through it survive a rollback, for side effects that already happened outside the DB.
+  readonly dbOutsideTransaction: TenantDb;
   readonly registry: Registry;
   /** Aktiver SessionUser des Handler-Aufrufs — Convenience-Alias zu
    *  `event.user`. Existiert weil Handler intuitiv `ctx.user.tenantId`
@@ -501,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