@cosmicdrift/kumiko-types 0.311.0 → 0.313.0

package/package.json

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

@@ -354,7 +354,12 @@ export type JobTrigger =
   // event-consumer (createJobTriggerEventConsumer, pipeline/system-
   // hooks.ts) — cursor delivery, at-least-once. Handlers triggered on an
   // r.defineEvent QN must be idempotent.
-  | { readonly on: import("./handlers").NameOrRef | readonly import("./handlers").NameOrRef[] }
+  | {
+      readonly on: import("./handlers").NameOrRef | readonly import("./handlers").NameOrRef[];
+      // Equality filter on top-level payload fields, checked before enqueue —
+      // lets N jobs share one broad event QN, partitioned by a discriminant.
+      readonly where?: Readonly<Record<string, string | number | boolean>>;
+    }
   | { readonly cron: string }
   | { readonly manual: true };
 

package/src/handlers.ts

@@ -4,7 +4,7 @@ import type { ConfigAccessor, ConfigAccessorFactory, ConfigResolver } from "./co
 import type { DbConnection } from "./db-connection";
 import type { DerivativesContext } from "./derivatives-types";
 import type { EntityCache } from "./entity-cache";
-import type { WriteOrigin } from "./event-store-types";
+import type { EventMetadata, WriteOrigin } from "./event-store-types";
 import type { KumikoEventTypeMap } from "./event-type-map";
 import type { FileContext } from "./file-handle-types";
 import type { FileProviderResolver } from "./file-provider-resolver-types";
@@ -245,12 +245,21 @@ import type { UncheckedSystemDb } from "./tenant-db-types";
 // The framework resolves the member internally, so no hand-built SessionUser reaches app code.
 export type MemberReader = (userId: string, qn: string, payload: unknown) => Promise<unknown>;
 
+// The stored event that made an r.job trigger fire, carried through so the
+// job handler can key an idempotency check on it (at-least-once delivery via
+// the job-trigger event consumer, see pipeline/system-hooks.ts).
+export type JobTriggerEvent = {
+  readonly id: string;
+  readonly headers: NonNullable<EventMetadata["headers"]>;
+};
+
 // Minimal interface for job event triggers (framework-owned, concrete type in jobs/)
 export type JobRunnerRef = {
   handleEvent(
     eventName: string,
     payload: Record<string, unknown>,
     user?: SessionUser,
+    triggerEvent?: JobTriggerEvent,
   ): Promise<void>;
 };
 
@@ -754,6 +763,13 @@ export type JobContext = SharedContextFields & {
   // Multi-trigger jobs (`on: [...]`) use this to tell which trigger fired —
   // undefined for cron/manual jobs. Mirrors AppContext.triggerName.
   readonly triggerName?: string;
+  // The stored event that triggered this job run, when reached via the
+  // job-trigger event consumer (async, at-least-once). Undefined for
+  // cron/manual jobs and for the synchronous handler-QN dispatch path, which
+  // has no stored event to hand over. Use triggerEvent.id (or a header) as
+  // an idempotency key — at-least-once delivery can run the same trigger
+  // more than once.
+  readonly triggerEvent?: JobTriggerEvent;
   // Fallback tenant/user when systemUser doesn't carry it (tenant-less cron
   // jobs). Mirrors AppContext._tenantId/_userId — see the tenant-scoping
   // footgun above.

package/src/multi-stream-apply-context-types.ts

@@ -1,6 +1,7 @@
 import type { DerivativesContext } from "./derivatives-types";
 import type { StoredEvent } from "./event-store-types";
 import type { KumikoEventTypeMap } from "./event-type-map";
+import type { Registry } from "./feature";
 import type { FileContext } from "./file-handle-types";
 import type { AppendEventFn, UnsafeAppendEventFn } from "./handlers";
 
@@ -30,6 +31,10 @@ export type MultiStreamApplyContext<TMap extends object = KumikoEventTypeMap> =
     aggregateId: string,
     options?: { readonly asOf?: Temporal.Instant },
   ) => Promise<readonly StoredEvent[]>;
+  // The app registry — same instance HandlerContext/JobContext expose. Lets
+  // an apply resolve extension-point usages (registry.getExtensionUsages),
+  // e.g. a provider-routed MSP picking a handler by payload discriminant.
+  readonly registry: Registry;
   // Binary storage handle factory, mirrors AppContext.files. Present when
   // the app booted with `files.storageProvider`; undefined otherwise.
   // Post-processing MSPs (resize, EXIF-strip, virus-scan) read bytes via