@dudousxd/nestjs-durable-store-mikro-orm 0.22.0 → 0.24.0

package/dist/index.d.cts

@@ -1,6 +1,34 @@
 import * as _mikro_orm_core from '@mikro-orm/core';
-import { EntitySchema, MikroORM } from '@mikro-orm/core';
-import { StepKind, RunStatus, StateStore, WorkflowRun, RetentionPolicy, StepCheckpoint, RunQuery, RunFacetQuery, RunFacetRow, SignalWaiter } from '@dudousxd/nestjs-durable-core';
+import { EntityRepository, EntityRepositoryType, EntitySchema, MikroORM } from '@mikro-orm/core';
+import { StepKind, RunStatus, StateStore, WorkflowRun, RetentionPolicy, StepCheckpoint, RunQuery, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, SignalWaiter } from '@dudousxd/nestjs-durable-core';
+
+/**
+ * Custom repositories for the durable entities, so a host app can `@InjectRepository`/inject a
+ * `WorkflowRunRepository` by type instead of repeating `em.find(WorkflowRunEntity, …)` with the
+ * entity class as the first argument everywhere.
+ *
+ * They are wired per-schema inside `durableEntities()` (not with a decorator), because that factory
+ * can be called more than once with different column naming and each call must produce schemas that
+ * still point at these classes. Each entity also declares `[EntityRepositoryType]`, which is what
+ * makes `em.getRepository(WorkflowRunEntity)` resolve to the specific type rather than the base
+ * `EntityRepository`.
+ *
+ * The bodies are intentionally empty: the durable engine's own queries go through
+ * `MikroOrmStateStore`, and a durable-owned query added here would be a second, unversioned read
+ * path over the same tables. They exist as an injectable, correctly-typed handle for host code.
+ */
+declare class WorkflowRunRepository extends EntityRepository<WorkflowRunEntity> {
+}
+declare class StepCheckpointRepository extends EntityRepository<StepCheckpointEntity> {
+}
+declare class RunAttributeRepository extends EntityRepository<RunAttributeEntity> {
+}
+declare class SignalWaiterRepository extends EntityRepository<SignalWaiterEntity> {
+}
+declare class BufferedSignalRepository extends EntityRepository<BufferedSignalEntity> {
+}
+declare class BufferedEventRepository extends EntityRepository<BufferedEventEntity> {
+}
 
 /**
  * How property names map to physical column names. The durable tables are adapter-agnostic: a run
@@ -16,6 +44,7 @@ import { StepKind, RunStatus, StateStore, WorkflowRun, RetentionPolicy, StepChec
  */
 type DurableColumnNaming = 'snake_case' | 'preserve' | ((property: string) => string);
 declare class WorkflowRunEntity {
+    [EntityRepositoryType]?: WorkflowRunRepository;
     id: string;
     workflow: string;
     workflowVersion: string;
@@ -37,6 +66,7 @@ declare class WorkflowRunEntity {
     updatedAt: Date;
 }
 declare class StepCheckpointEntity {
+    [EntityRepositoryType]?: StepCheckpointRepository;
     runId: string;
     seq: number;
     name: string;
@@ -62,18 +92,21 @@ declare class StepCheckpointEntity {
  * `numValue`, strings/booleans in `strValue` (booleans as "true"/"false"); see normalizeAttributeRows.
  */
 declare class RunAttributeEntity {
+    [EntityRepositoryType]?: RunAttributeRepository;
     runId: string;
     key: string;
     strValue?: string | null;
     numValue?: number | null;
 }
 declare class SignalWaiterEntity {
+    [EntityRepositoryType]?: SignalWaiterRepository;
     token: string;
     runId: string;
     seq: number;
     parallelGroup?: string | null;
 }
 declare class BufferedSignalEntity {
+    [EntityRepositoryType]?: BufferedSignalRepository;
     id: number;
     token: string;
     payload?: unknown;
@@ -82,6 +115,7 @@ declare class BufferedSignalEntity {
  *  caller-minted `id` (a uuid, not autoincrement — `removeBufferedEvent` targets it directly), not by
  *  `runId`: events are name-based pub/sub, not tied to any one run. */
 declare class BufferedEventEntity {
+    [EntityRepositoryType]?: BufferedEventRepository;
     id: string;
     name: string;
     payload?: unknown;
@@ -162,15 +196,25 @@ declare class MikroOrmStateStore implements StateStore {
      *  predicates only raw SQL can express — the `tag` JSON LIKE and one EXISTS per attribute filter.
      *  Shared so a facet count and the page it labels are taken over the SAME set. */
     private runQueryBuilder;
+    /** `tags LIKE '%"etl"%'` — the quoted token, so `etl` doesn't match `etl-foo`. See the note in
+     *  {@link listRuns} for why this is raw SQL rather than a MikroORM condition. */
+    private tagLikeSql;
     /** `GROUP BY status, origin` over the same predicates {@link listRuns} pages — one aggregate, so a
      *  console can show whole-set counts next to a bounded page instead of downloading every run to
      *  count them in the browser. */
     runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
+    /** Distinct values of one filter axis over the same predicates {@link listRuns} pages. A run-table
+     *  column is a `GROUP BY` like {@link runFacets}, exact over the whole matching set; the tag and
+     *  attribute axes live outside the row (json array / side table) and are counted from a bounded
+     *  page of runs instead — see {@link RunValueFacetOptions.scan}. */
+    runValueFacets(axis: RunValueAxis, query: RunFacetQuery, opts?: RunValueFacetOptions): Promise<RunValueFacetRow[]>;
     /** One attribute predicate as a raw EXISTS subquery on the side-table, correlated to the outer run
      *  alias. `<>` (ne) also excludes runs where the attribute is absent (missing-key-never-matches):
      *  EXISTS already requires a present row, so EXISTS(... <> ...) is exactly ne-with-present. Numeric
-     *  operands compare the num column, everything else the str column. Identifiers are quoted per
-     *  driver and operands are inlined as literals (string operands are escaped by doubling quotes). */
+     *  operands compare the num column, everything else the str column. `in` contributes one comparison
+     *  per member, ORed inside the single EXISTS — one subquery either way, and an `in` over no values
+     *  yields no comparison and so matches nothing. Identifiers are quoted per driver and operands are
+     *  inlined as literals (string operands are escaped by doubling quotes). */
     private attributeExistsSql;
     /** Resolve the side-table's actual column names from MikroORM metadata, so the raw EXISTS matches
      *  the active naming strategy (underscore vs camelCase) rather than guessing. The run PK column is
@@ -254,4 +298,4 @@ declare function durableManagedTables(): string[];
  */
 declare function ensureMikroOrmDurableSchema(orm: MikroORM): Promise<void>;
 
-export { BufferedEventEntity, BufferedSignalEntity, type DurableColumnNaming, ENTITIES, MikroOrmStateStore, type MikroOrmStateStoreOptions, RunAttributeEntity, SignalWaiterEntity, StepCheckpointEntity, WorkflowRunEntity, durableEntities, durableManagedTables, ensureMikroOrmDurableSchema };
+export { BufferedEventEntity, BufferedEventRepository, BufferedSignalEntity, BufferedSignalRepository, type DurableColumnNaming, ENTITIES, MikroOrmStateStore, type MikroOrmStateStoreOptions, RunAttributeEntity, RunAttributeRepository, SignalWaiterEntity, SignalWaiterRepository, StepCheckpointEntity, StepCheckpointRepository, WorkflowRunEntity, WorkflowRunRepository, durableEntities, durableManagedTables, ensureMikroOrmDurableSchema };

package/dist/index.d.ts

@@ -1,6 +1,34 @@
 import * as _mikro_orm_core from '@mikro-orm/core';
-import { EntitySchema, MikroORM } from '@mikro-orm/core';
-import { StepKind, RunStatus, StateStore, WorkflowRun, RetentionPolicy, StepCheckpoint, RunQuery, RunFacetQuery, RunFacetRow, SignalWaiter } from '@dudousxd/nestjs-durable-core';
+import { EntityRepository, EntityRepositoryType, EntitySchema, MikroORM } from '@mikro-orm/core';
+import { StepKind, RunStatus, StateStore, WorkflowRun, RetentionPolicy, StepCheckpoint, RunQuery, RunFacetQuery, RunFacetRow, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, SignalWaiter } from '@dudousxd/nestjs-durable-core';
+
+/**
+ * Custom repositories for the durable entities, so a host app can `@InjectRepository`/inject a
+ * `WorkflowRunRepository` by type instead of repeating `em.find(WorkflowRunEntity, …)` with the
+ * entity class as the first argument everywhere.
+ *
+ * They are wired per-schema inside `durableEntities()` (not with a decorator), because that factory
+ * can be called more than once with different column naming and each call must produce schemas that
+ * still point at these classes. Each entity also declares `[EntityRepositoryType]`, which is what
+ * makes `em.getRepository(WorkflowRunEntity)` resolve to the specific type rather than the base
+ * `EntityRepository`.
+ *
+ * The bodies are intentionally empty: the durable engine's own queries go through
+ * `MikroOrmStateStore`, and a durable-owned query added here would be a second, unversioned read
+ * path over the same tables. They exist as an injectable, correctly-typed handle for host code.
+ */
+declare class WorkflowRunRepository extends EntityRepository<WorkflowRunEntity> {
+}
+declare class StepCheckpointRepository extends EntityRepository<StepCheckpointEntity> {
+}
+declare class RunAttributeRepository extends EntityRepository<RunAttributeEntity> {
+}
+declare class SignalWaiterRepository extends EntityRepository<SignalWaiterEntity> {
+}
+declare class BufferedSignalRepository extends EntityRepository<BufferedSignalEntity> {
+}
+declare class BufferedEventRepository extends EntityRepository<BufferedEventEntity> {
+}
 
 /**
  * How property names map to physical column names. The durable tables are adapter-agnostic: a run
@@ -16,6 +44,7 @@ import { StepKind, RunStatus, StateStore, WorkflowRun, RetentionPolicy, StepChec
  */
 type DurableColumnNaming = 'snake_case' | 'preserve' | ((property: string) => string);
 declare class WorkflowRunEntity {
+    [EntityRepositoryType]?: WorkflowRunRepository;
     id: string;
     workflow: string;
     workflowVersion: string;
@@ -37,6 +66,7 @@ declare class WorkflowRunEntity {
     updatedAt: Date;
 }
 declare class StepCheckpointEntity {
+    [EntityRepositoryType]?: StepCheckpointRepository;
     runId: string;
     seq: number;
     name: string;
@@ -62,18 +92,21 @@ declare class StepCheckpointEntity {
  * `numValue`, strings/booleans in `strValue` (booleans as "true"/"false"); see normalizeAttributeRows.
  */
 declare class RunAttributeEntity {
+    [EntityRepositoryType]?: RunAttributeRepository;
     runId: string;
     key: string;
     strValue?: string | null;
     numValue?: number | null;
 }
 declare class SignalWaiterEntity {
+    [EntityRepositoryType]?: SignalWaiterRepository;
     token: string;
     runId: string;
     seq: number;
     parallelGroup?: string | null;
 }
 declare class BufferedSignalEntity {
+    [EntityRepositoryType]?: BufferedSignalRepository;
     id: number;
     token: string;
     payload?: unknown;
@@ -82,6 +115,7 @@ declare class BufferedSignalEntity {
  *  caller-minted `id` (a uuid, not autoincrement — `removeBufferedEvent` targets it directly), not by
  *  `runId`: events are name-based pub/sub, not tied to any one run. */
 declare class BufferedEventEntity {
+    [EntityRepositoryType]?: BufferedEventRepository;
     id: string;
     name: string;
     payload?: unknown;
@@ -162,15 +196,25 @@ declare class MikroOrmStateStore implements StateStore {
      *  predicates only raw SQL can express — the `tag` JSON LIKE and one EXISTS per attribute filter.
      *  Shared so a facet count and the page it labels are taken over the SAME set. */
     private runQueryBuilder;
+    /** `tags LIKE '%"etl"%'` — the quoted token, so `etl` doesn't match `etl-foo`. See the note in
+     *  {@link listRuns} for why this is raw SQL rather than a MikroORM condition. */
+    private tagLikeSql;
     /** `GROUP BY status, origin` over the same predicates {@link listRuns} pages — one aggregate, so a
      *  console can show whole-set counts next to a bounded page instead of downloading every run to
      *  count them in the browser. */
     runFacets(query: RunFacetQuery): Promise<RunFacetRow[]>;
+    /** Distinct values of one filter axis over the same predicates {@link listRuns} pages. A run-table
+     *  column is a `GROUP BY` like {@link runFacets}, exact over the whole matching set; the tag and
+     *  attribute axes live outside the row (json array / side table) and are counted from a bounded
+     *  page of runs instead — see {@link RunValueFacetOptions.scan}. */
+    runValueFacets(axis: RunValueAxis, query: RunFacetQuery, opts?: RunValueFacetOptions): Promise<RunValueFacetRow[]>;
     /** One attribute predicate as a raw EXISTS subquery on the side-table, correlated to the outer run
      *  alias. `<>` (ne) also excludes runs where the attribute is absent (missing-key-never-matches):
      *  EXISTS already requires a present row, so EXISTS(... <> ...) is exactly ne-with-present. Numeric
-     *  operands compare the num column, everything else the str column. Identifiers are quoted per
-     *  driver and operands are inlined as literals (string operands are escaped by doubling quotes). */
+     *  operands compare the num column, everything else the str column. `in` contributes one comparison
+     *  per member, ORed inside the single EXISTS — one subquery either way, and an `in` over no values
+     *  yields no comparison and so matches nothing. Identifiers are quoted per driver and operands are
+     *  inlined as literals (string operands are escaped by doubling quotes). */
     private attributeExistsSql;
     /** Resolve the side-table's actual column names from MikroORM metadata, so the raw EXISTS matches
      *  the active naming strategy (underscore vs camelCase) rather than guessing. The run PK column is
@@ -254,4 +298,4 @@ declare function durableManagedTables(): string[];
  */
 declare function ensureMikroOrmDurableSchema(orm: MikroORM): Promise<void>;
 
-export { BufferedEventEntity, BufferedSignalEntity, type DurableColumnNaming, ENTITIES, MikroOrmStateStore, type MikroOrmStateStoreOptions, RunAttributeEntity, SignalWaiterEntity, StepCheckpointEntity, WorkflowRunEntity, durableEntities, durableManagedTables, ensureMikroOrmDurableSchema };
+export { BufferedEventEntity, BufferedEventRepository, BufferedSignalEntity, BufferedSignalRepository, type DurableColumnNaming, ENTITIES, MikroOrmStateStore, type MikroOrmStateStoreOptions, RunAttributeEntity, RunAttributeRepository, SignalWaiterEntity, SignalWaiterRepository, StepCheckpointEntity, StepCheckpointRepository, WorkflowRunEntity, WorkflowRunRepository, durableEntities, durableManagedTables, ensureMikroOrmDurableSchema };

package/dist/index.js

@@ -2,7 +2,42 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/entities.ts
-import { EntitySchema } from "@mikro-orm/core";
+import { EntityRepositoryType, EntitySchema } from "@mikro-orm/core";
+
+// src/repositories.ts
+import { EntityRepository } from "@mikro-orm/core";
+var WorkflowRunRepository = class extends EntityRepository {
+  static {
+    __name(this, "WorkflowRunRepository");
+  }
+};
+var StepCheckpointRepository = class extends EntityRepository {
+  static {
+    __name(this, "StepCheckpointRepository");
+  }
+};
+var RunAttributeRepository = class extends EntityRepository {
+  static {
+    __name(this, "RunAttributeRepository");
+  }
+};
+var SignalWaiterRepository = class extends EntityRepository {
+  static {
+    __name(this, "SignalWaiterRepository");
+  }
+};
+var BufferedSignalRepository = class extends EntityRepository {
+  static {
+    __name(this, "BufferedSignalRepository");
+  }
+};
+var BufferedEventRepository = class extends EntityRepository {
+  static {
+    __name(this, "BufferedEventRepository");
+  }
+};
+
+// src/entities.ts
 function snakeCase(property) {
   return property.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
 }
@@ -17,6 +52,7 @@ var WorkflowRunEntity = class {
   static {
     __name(this, "WorkflowRunEntity");
   }
+  [EntityRepositoryType];
   id;
   workflow;
   workflowVersion;
@@ -41,6 +77,7 @@ var StepCheckpointEntity = class {
   static {
     __name(this, "StepCheckpointEntity");
   }
+  [EntityRepositoryType];
   runId;
   seq;
   name;
@@ -63,6 +100,7 @@ var RunAttributeEntity = class {
   static {
     __name(this, "RunAttributeEntity");
   }
+  [EntityRepositoryType];
   runId;
   key;
   strValue;
@@ -72,6 +110,7 @@ var SignalWaiterEntity = class {
   static {
     __name(this, "SignalWaiterEntity");
   }
+  [EntityRepositoryType];
   token;
   runId;
   seq;
@@ -81,6 +120,7 @@ var BufferedSignalEntity = class {
   static {
     __name(this, "BufferedSignalEntity");
   }
+  [EntityRepositoryType];
   id;
   token;
   payload;
@@ -89,6 +129,7 @@ var BufferedEventEntity = class {
   static {
     __name(this, "BufferedEventEntity");
   }
+  [EntityRepositoryType];
   id;
   name;
   payload;
@@ -106,6 +147,9 @@ function durableEntities(options = {}) {
   const workflowRuns = new EntitySchema({
     class: WorkflowRunEntity,
     tableName: "durable_workflow_runs",
+    // Wired per schema rather than once on the class: `durableEntities` can be called again with a
+    // different `naming`, and each call builds a distinct EntitySchema over the same class.
+    repository: /* @__PURE__ */ __name(() => WorkflowRunRepository, "repository"),
     // Global filter: confines every read to the tenant's namespace when the store is scoped.
     // The `cond` returns `{}` (no-op) when the `namespace` arg is `undefined`, so an unscoped
     // (operator / control-plane) store sees all rows unchanged — existing behaviour is preserved.
@@ -269,6 +313,7 @@ function durableEntities(options = {}) {
   const stepCheckpoints = new EntitySchema({
     class: StepCheckpointEntity,
     tableName: "durable_step_checkpoints",
+    repository: /* @__PURE__ */ __name(() => StepCheckpointRepository, "repository"),
     properties: {
       runId: {
         type: "string",
@@ -357,6 +402,7 @@ function durableEntities(options = {}) {
   const runAttributes = new EntitySchema({
     class: RunAttributeEntity,
     tableName: "durable_run_attributes",
+    repository: /* @__PURE__ */ __name(() => RunAttributeRepository, "repository"),
     // The search-attribute EXISTS join (see the class docstring) pushes equality/range predicates down
     // onto `(key, numValue)` / `(key, strValue)`; mirror the Prisma adapter so those scans stay indexed.
     indexes: [
@@ -402,6 +448,7 @@ function durableEntities(options = {}) {
   const signalWaiters = new EntitySchema({
     class: SignalWaiterEntity,
     tableName: "durable_signal_waiters",
+    repository: /* @__PURE__ */ __name(() => SignalWaiterRepository, "repository"),
     properties: {
       token: {
         type: "string",
@@ -429,6 +476,7 @@ function durableEntities(options = {}) {
   const bufferedSignals = new EntitySchema({
     class: BufferedSignalEntity,
     tableName: "durable_buffered_signals",
+    repository: /* @__PURE__ */ __name(() => BufferedSignalRepository, "repository"),
     properties: {
       id: {
         type: "integer",
@@ -451,6 +499,7 @@ function durableEntities(options = {}) {
   const bufferedEvents = new EntitySchema({
     class: BufferedEventEntity,
     tableName: "durable_buffered_events",
+    repository: /* @__PURE__ */ __name(() => BufferedEventRepository, "repository"),
     // `(name, publishedAt)` serves both `listBufferedEvents`'s name-scoped scan and its oldest-first
     // ordering in one index.
     indexes: [
@@ -498,7 +547,7 @@ __name(durableEntities, "durableEntities");
 var ENTITIES = durableEntities();
 
 // src/mikro-orm-state-store.ts
-import { attributeColumnFor, attributeOperand, mergeRunFacetRows, normalizeAttributeRows, parseDuration, sqlComparator } from "@dudousxd/nestjs-durable-core";
+import { RUN_VALUE_FACET_SCAN, attributePredicateOperands, axisIsRunColumn, mergeRunFacetRows, mergeRunValueFacetRows, normalizeAttributeRows, parseDuration, runValueFacetsFromRuns } from "@dudousxd/nestjs-durable-core";
 import { raw } from "@mikro-orm/core";
 
 // src/schema.ts
@@ -982,20 +1031,47 @@ var MikroOrmStateStore = class _MikroOrmStateStore {
   *  applied by the QueryBuilder path in both callers. */
   runWhere(query) {
     const where = {};
+    const and = [];
     if (query.workflow) where.workflow = query.workflow;
+    if (query.workflows) and.push({
+      workflow: {
+        $in: query.workflows
+      }
+    });
     if (query.namespace !== void 0) where.namespace = query.namespace;
+    if (query.namespaces) and.push({
+      namespace: {
+        $in: query.namespaces
+      }
+    });
     if (query.origin !== void 0) where.origin = query.origin;
+    if (query.origins) {
+      const named = query.origins.filter((o) => o !== null);
+      const branches = [];
+      if (named.length) branches.push({
+        origin: {
+          $in: named
+        }
+      });
+      if (query.origins.some((o) => o === null)) branches.push({
+        origin: null
+      });
+      and.push(branches.length ? {
+        $or: branches
+      } : {
+        origin: {
+          $in: []
+        }
+      });
+    }
     if (query.status && query.statuses) {
-      where.$and = [
-        {
-          status: query.status
-        },
-        {
-          status: {
-            $in: query.statuses
-          }
+      and.push({
+        status: query.status
+      }, {
+        status: {
+          $in: query.statuses
         }
-      ];
+      });
     } else if (query.status) {
       where.status = query.status;
     } else if (query.statuses) {
@@ -1003,6 +1079,7 @@ var MikroOrmStateStore = class _MikroOrmStateStore {
         $in: query.statuses
       };
     }
+    if (and.length) where.$and = and;
     return where;
   }
   async listRuns(query) {
@@ -1011,7 +1088,7 @@ var MikroOrmStateStore = class _MikroOrmStateStore {
     const orderBy = {
       createdAt: "desc"
     };
-    if (query.tag || query.attributes?.length) {
+    if (query.tag || query.tags || query.attributes?.length) {
       const qb = this.runQueryBuilder(em, query, where).orderBy(orderBy);
       if (query.limit != null) qb.limit(query.limit);
       if (query.offset != null) qb.offset(query.offset);
@@ -1037,17 +1114,23 @@ var MikroOrmStateStore = class _MikroOrmStateStore {
     const quote = this.idQuote(em);
     const cols = this.attributeColumns(em);
     const qb = em.createQueryBuilder(WorkflowRunEntity, "r").where(where);
-    if (query.tag) {
-      const tagsCol = this.tagsColumn(em);
-      const pattern = `%"${query.tag.replace(/'/g, "''")}"%`;
-      const colExpr = this.jsonAsText(em, `${quote("r")}.${quote(tagsCol)}`);
-      qb.andWhere(`${colExpr} LIKE '${pattern}'`);
+    if (query.tag) qb.andWhere(this.tagLikeSql(em, query.tag, quote));
+    if (query.tags) {
+      const branches = query.tags.map((t) => this.tagLikeSql(em, t, quote));
+      qb.andWhere(branches.length ? `(${branches.join(" OR ")})` : "1 = 0");
     }
     for (const f of query.attributes ?? []) {
       qb.andWhere(this.attributeExistsSql(f, quote, "r", cols));
     }
     return qb;
   }
+  /** `tags LIKE '%"etl"%'` — the quoted token, so `etl` doesn't match `etl-foo`. See the note in
+  *  {@link listRuns} for why this is raw SQL rather than a MikroORM condition. */
+  tagLikeSql(em, tag, quote) {
+    const pattern = `%"${tag.replace(/'/g, "''")}"%`;
+    const colExpr = this.jsonAsText(em, `${quote("r")}.${quote(this.tagsColumn(em))}`);
+    return `${colExpr} LIKE '${pattern}'`;
+  }
   /** `GROUP BY status, origin` over the same predicates {@link listRuns} pages — one aggregate, so a
   *  console can show whole-set counts next to a bounded page instead of downloading every run to
   *  count them in the browser. */
@@ -1068,20 +1151,50 @@ var MikroOrmStateStore = class _MikroOrmStateStore {
       count: Number(r.count)
     })));
   }
+  /** Distinct values of one filter axis over the same predicates {@link listRuns} pages. A run-table
+  *  column is a `GROUP BY` like {@link runFacets}, exact over the whole matching set; the tag and
+  *  attribute axes live outside the row (json array / side table) and are counted from a bounded
+  *  page of runs instead — see {@link RunValueFacetOptions.scan}. */
+  async runValueFacets(axis, query, opts) {
+    if (!axisIsRunColumn(axis)) {
+      const runs = await this.listRuns({
+        ...query,
+        limit: opts?.scan ?? RUN_VALUE_FACET_SCAN
+      });
+      return runValueFacetsFromRuns(runs, axis, opts);
+    }
+    const em = this.fork();
+    const meta = em.getMetadata().get(WorkflowRunEntity);
+    const col = meta.properties[axis.field]?.fieldNames?.[0] ?? axis.field;
+    const rows = await this.runQueryBuilder(em, query, this.runWhere(query)).select([
+      `r.${col}`
+    ]).addSelect(raw("count(*) as count")).groupBy([
+      `r.${col}`
+    ]).execute();
+    return mergeRunValueFacetRows(rows.map((row) => ({
+      value: row[axis.field] ?? null,
+      count: Number(row.count)
+    })), opts);
+  }
   /** One attribute predicate as a raw EXISTS subquery on the side-table, correlated to the outer run
   *  alias. `<>` (ne) also excludes runs where the attribute is absent (missing-key-never-matches):
   *  EXISTS already requires a present row, so EXISTS(... <> ...) is exactly ne-with-present. Numeric
-  *  operands compare the num column, everything else the str column. Identifiers are quoted per
-  *  driver and operands are inlined as literals (string operands are escaped by doubling quotes). */
+  *  operands compare the num column, everything else the str column. `in` contributes one comparison
+  *  per member, ORed inside the single EXISTS — one subquery either way, and an `in` over no values
+  *  yields no comparison and so matches nothing. Identifiers are quoted per driver and operands are
+  *  inlined as literals (string operands are escaped by doubling quotes). */
   attributeExistsSql(f, quote, alias, cols) {
-    const col = attributeColumnFor(f) === "numValue" ? cols.numValue : cols.strValue;
-    const cmp = sqlComparator(f.op);
-    const operand = attributeOperand(f);
-    const literal = typeof operand === "number" ? String(operand) : `'${String(operand).replace(/'/g, "''")}'`;
+    const comparisons = attributePredicateOperands(f).map(({ column, comparator, operand }) => {
+      const col = column === "numValue" ? cols.numValue : cols.strValue;
+      const literal = typeof operand === "number" ? String(operand) : `'${String(operand).replace(/'/g, "''")}'`;
+      return `${quote("a")}.${quote(col)} ${comparator} ${literal}`;
+    });
+    if (comparisons.length === 0) return "1 = 0";
     const a = quote(cols.table);
     const sub = quote("a");
     const outerId = `${quote(alias)}.${quote(cols.runPk)}`;
-    return `EXISTS (SELECT 1 FROM ${a} ${sub} WHERE ${sub}.${quote(cols.runId)} = ${outerId} AND ${sub}.${quote(cols.key)} = '${f.key.replace(/'/g, "''")}' AND ${sub}.${quote(col)} ${cmp} ${literal})`;
+    const match = comparisons.length === 1 ? comparisons[0] : `(${comparisons.join(" OR ")})`;
+    return `EXISTS (SELECT 1 FROM ${a} ${sub} WHERE ${sub}.${quote(cols.runId)} = ${outerId} AND ${sub}.${quote(cols.key)} = '${f.key.replace(/'/g, "''")}' AND ${match})`;
   }
   /** Resolve the side-table's actual column names from MikroORM metadata, so the raw EXISTS matches
   *  the active naming strategy (underscore vs camelCase) rather than guessing. The run PK column is
@@ -1361,13 +1474,19 @@ function fromCheckpointEntity(e) {
 __name(fromCheckpointEntity, "fromCheckpointEntity");
 export {
   BufferedEventEntity,
+  BufferedEventRepository,
   BufferedSignalEntity,
+  BufferedSignalRepository,
   ENTITIES,
   MikroOrmStateStore,
   RunAttributeEntity,
+  RunAttributeRepository,
   SignalWaiterEntity,
+  SignalWaiterRepository,
   StepCheckpointEntity,
+  StepCheckpointRepository,
   WorkflowRunEntity,
+  WorkflowRunRepository,
   durableEntities,
   durableManagedTables,
   ensureMikroOrmDurableSchema