@cosmicdrift/kumiko-types 0.200.1 → 0.202.0

package/package.json

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

@@ -364,7 +364,10 @@ export type HandlerContext<TMap extends object = KumikoEventTypeMap> = SharedCon
   // 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. `undefined` when the pipeline has no outside-tx source
-  // for this dispatch (see dispatch-shared.ts) — callers must check before use.
+  // for this dispatch (see dispatch-shared.ts) — callers must check before
+  // use. For r.systemScope() handlers this is fail-closed instead, same as
+  // `db` above — a truthy Proxy that throws on first property read, so a
+  // system handler must reach for `systemDb.outsideTransaction` below.
   readonly dbOutsideTransaction: TenantDb | undefined;
   // Only present for r.systemScope() handlers. Non-system handlers never
   // receive this — reach for `db` instead, which is fail-closed for them.

package/src/screen.ts

@@ -806,6 +806,13 @@ export type ScreenNavSugar = {
   readonly order?: number;
 };
 
+// `detailFor` sits on the intersection, not on one variant, because any
+// screen kind can be the detail view for an entity — including `custom`:
+// in app repos, detail screens are overwhelmingly custom screens today
+// (projectionDetail doesn't carry entity semantics). Value is an entity
+// name in the same (unqualified, globally-unique) form as `entity` on
+// `EntityListScreenDefinition` (screen.ts:259-262) — entities are never
+// feature-prefixed, so there's no separate qualification step.
 export type ScreenDefinition = (
   | EntityListScreenDefinition
   | ProjectionListScreenDefinition
@@ -815,4 +822,4 @@ export type ScreenDefinition = (
   | ActionFormScreenDefinition
   | ConfigEditScreenDefinition
   | CustomScreenDefinition
-) & { readonly nav?: ScreenNavSugar };
+) & { readonly nav?: ScreenNavSugar; readonly detailFor?: string };

package/src/tenant-db-types.ts

@@ -68,4 +68,14 @@ export type UncheckedSystemDb = {
   assertTenantMatch(tenantId: TenantId): TenantDb;
   assertRowsTenant<T>(rows: readonly T[], tenantField: keyof T): readonly T[];
   acknowledgeCrossTenant(reason: string): TenantDb;
+  // Same self-check pair as above, but hands back the caller's
+  // ctx.dbOutsideTransaction TenantDb instead of the in-tx one — for
+  // durability writes that must survive a rollback of the handler's own
+  // transaction. Throws if the dispatch has no outside-transaction source
+  // configured (e.g. a hand-built UncheckedSystemDb that only ever passed
+  // the in-tx db to createUncheckedSystemDb).
+  readonly outsideTransaction: {
+    assertTenantMatch(tenantId: TenantId): TenantDb;
+    acknowledgeCrossTenant(reason: string): TenantDb;
+  };
 };