@cosmicdrift/kumiko-types 0.229.1 → 0.231.0

package/package.json

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

@@ -16,4 +16,5 @@ export type FileHandle = {
 // GDPR jobs all hit the same store by construction.
 export type FileContext = {
   ref(key: string): FileHandle;
+  list(prefix: string): Promise<readonly string[]>;
 };

package/src/step.ts

@@ -76,6 +76,27 @@ export type PipelineCtx<
  */
 export type StepResolver<T, TPayload = unknown> = T | ((ctx: PipelineCtx<TPayload>) => T);
 
+// Serializable AST for r.step.waitForEvent's `match` argument. Persisted
+// verbatim into the waiting-for-event suspension payload (jsonb), so it
+// must survive a JSON round-trip — a closure cannot.
+export type EventMatchValue = string | number | boolean | null;
+
+export type EventMatchOp =
+  | { readonly kind: "eq"; readonly value: EventMatchValue }
+  | { readonly kind: "ne"; readonly value: EventMatchValue }
+  | { readonly kind: "in"; readonly values: readonly EventMatchValue[] }
+  | { readonly kind: "gt"; readonly value: number | string }
+  | { readonly kind: "gte"; readonly value: number | string }
+  | { readonly kind: "lt"; readonly value: number | string }
+  | { readonly kind: "lte"; readonly value: number | string };
+
+export type EventMatchExpr =
+  | { readonly kind: "and"; readonly nodes: readonly EventMatchExpr[] }
+  | { readonly kind: "or"; readonly nodes: readonly EventMatchExpr[] }
+  | { readonly kind: "atom"; readonly path: readonly string[]; readonly op: EventMatchOp };
+
+export type EventMatch = { readonly version: 1; readonly expr: EventMatchExpr };
+
 /**
  * Per-step error strategy. M.1.1 only supports "throw" — the type is
  * deliberately narrowed so callers cannot pass an unsupported strategy
@@ -319,7 +340,7 @@ export type StepNamespace = {
   readonly wait: (args: { readonly for: StepResolver<string> }) => StepInstance;
   readonly waitForEvent: (args: {
     readonly event: string;
-    readonly match?: StepResolver<(payload: unknown) => boolean>;
+    readonly match?: StepResolver<EventMatch>;
     readonly timeout: StepResolver<string>;
   }) => StepInstance;
   readonly retry: (args: {