@cosmicdrift/kumiko-types 0.291.0 → 0.293.0

package/package.json

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

@@ -49,6 +49,12 @@ export function isSystemTenant(tenantId: TenantId | null | undefined): boolean {
   return !tenantId || tenantId === SYSTEM_TENANT_ID;
 }
 
+// "No human caller" marker on event-store `createdBy`. Stringified so it
+// round-trips through SessionUser.id; not a real UUID, and createdBy is text.
+// Lives here rather than next to createSystemUser() so client-side code (the
+// reference-label map) can read it without importing a runtime module.
+export const SYSTEM_USER_ID = "00000000-0000-0000-0000-000000000000";
+
 // Primary-key identifier for any entity row. Two shapes coexist because of
 // the entity-def `idType` switch: classic CRUD entities keep `serial` (number),
 // while tenant + ES aggregates run on `uuid` (string). Call sites that pass

package/src/screen.ts

@@ -473,6 +473,8 @@ export type EntityListScreenDefinition = {
 // `falseLabel`) are i18n keys resolved via `translate()` with passthrough
 // for unknown keys (fw#2373) — not raw display strings. Sent to the server
 // as `{field, op:"in", value}` in `payload.filters`, ANDed with `filter`.
+// Exception: "dateRange" sends its bounds as the two top-level payload keys
+// named in `params`, not as a `filters` entry.
 export type ListFacetSpec =
   | {
       readonly field: string;
@@ -497,6 +499,20 @@ export type ListFacetSpec =
       /** Row field on the referenced entity shown as the option label
        *  (default "id"). */
       readonly labelField?: string;
+    }
+  | {
+      /** Declarative only — the date field the range narrows. It is NOT sent
+       *  to the server (the bounds go under `params`); it namespaces the
+       *  facet's URL keys and tells a reading agent which column this list
+       *  is time-rangeable on. */
+      readonly field: string;
+      readonly type: "dateRange";
+      readonly label: string;
+      /** Query-payload keys the chosen bounds are sent under as ISO instants.
+       *  Explicit rather than a `from`/`to` convention — a query is free to
+       *  name its time bounds anything, and the boot-validator checks these
+       *  keys against the handler's Zod schema. */
+      readonly params: { readonly from: string; readonly to: string };
     };
 
 export type ProjectionListScreenDefinition = {
@@ -535,7 +551,9 @@ export type ProjectionListScreenDefinition = {
   readonly filter?: ScreenFilter;
   /** User-toggleable facet dropdowns — see `ListFacetSpec` doc. `field`
    *  must be a declared column; the bound query handler must accept
-   *  `filters` in its Zod schema — the boot-validator checks both. */
+   *  `filters` in its Zod schema — the boot-validator checks both. A
+   *  "dateRange" facet instead needs its two `params` keys in that schema;
+   *  it sends no `filters` entry. */
   readonly facets?: readonly ListFacetSpec[];
   readonly slots?: ScreenSlots;
   readonly access?: AccessRule;