@cosmicdrift/kumiko-types 0.184.0 → 0.185.0

package/package.json

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