@dudousxd/nestjs-durable-core 0.77.0 → 0.78.0

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
   EVENT_TOKEN_PREFIX: () => EVENT_TOKEN_PREFIX,
   Entities: () => Entities,
   EventAccumulators: () => EventAccumulators,
+  FAN_SUMMARY_FAILURES: () => FAN_SUMMARY_FAILURES,
   FatalError: () => FatalError,
   GatherError: () => GatherError,
   InMemoryAdmissionBackend: () => InMemoryAdmissionBackend,
@@ -60,6 +61,7 @@ __export(index_exports, {
   SINGLETON_ADMITTED_TAG: () => SINGLETON_ADMITTED_TAG,
   STATE_STORE: () => STATE_STORE,
   STATE_STORE_CANONICAL: () => STATE_STORE_CANONICAL,
+  SUMMARY_CHILD_LIMIT: () => SUMMARY_CHILD_LIMIT,
   ScheduleAlreadyExistsError: () => ScheduleAlreadyExistsError,
   ScheduleClient: () => ScheduleClient,
   ScheduleNotFoundError: () => ScheduleNotFoundError,
@@ -86,6 +88,7 @@ __export(index_exports, {
   buildWorkflowDirectory: () => buildWorkflowDirectory,
   canRoute: () => canRoute,
   capableWorkers: () => capableWorkers,
+  childIdsOf: () => childIdsOf,
   classifyWaiterToken: () => classifyWaiterToken,
   clearDurableExecutionWrappers: () => clearDurableExecutionWrappers,
   clearTerminalSingletonAdmission: () => clearTerminalSingletonAdmission,
@@ -114,6 +117,7 @@ __export(index_exports, {
   info: () => info,
   isEngineMintedTag: () => isEngineMintedTag,
   isEventToken: () => isEventToken,
+  isFailedMember: () => isFailedMember,
   isLegacyDescriptor: () => isLegacyDescriptor,
   isNonEmptyRunScope: () => isNonEmptyRunScope,
   isWorkflowControlFlowSignal: () => isWorkflowControlFlowSignal,
@@ -128,6 +132,7 @@ __export(index_exports, {
   normalizeAttributeRows: () => normalizeAttributeRows,
   normalizeDescriptor: () => normalizeDescriptor,
   observedAnnouncements: () => observedAnnouncements,
+  pageFan: () => pageFan,
   parentRunIdOf: () => parentRunIdOf,
   parseDuration: () => parseDuration,
   partitionOfToken: () => partitionOfToken,
@@ -157,6 +162,8 @@ __export(index_exports, {
   sub: () => sub,
   subEvent: () => subEvent,
   subProcess: () => subProcess,
+  summarizeFan: () => summarizeFan,
+  summarizeTimeline: () => summarizeTimeline,
   tenantGroup: () => tenantGroup,
   useDurableExecution: () => useDurableExecution,
   warn: () => warn,
@@ -1246,8 +1253,9 @@ function allChildId(runId, firstSeq, index, wave) {
   return `${allBase(runId, firstSeq, wave)}${index}`;
 }
 __name(allChildId, "allChildId");
-function allGroup(firstSeq, mode) {
-  return mode === "failFast" ? `all:${firstSeq}:failFast` : `all:${firstSeq}`;
+function allGroup(firstSeq, size, mode) {
+  const group = `all:${firstSeq}:n${size}`;
+  return mode === "failFast" ? `${group}:failFast` : group;
 }
 __name(allGroup, "allGroup");
 function stepFanGroup(firstSeq, size, mode) {
@@ -1256,14 +1264,26 @@ function stepFanGroup(firstSeq, size, mode) {
 }
 __name(stepFanGroup, "stepFanGroup");
 function parseStepFanGroup(group) {
-  const m = group ? /^steps:(\d+):(\d+)(?::failFast)?$/.exec(group) : null;
-  if (!m) return void 0;
+  const fan = parseFanGroup(group);
+  if (fan?.kind !== "steps" || fan.size === void 0) return void 0;
   return {
-    firstSeq: Number(m[1]),
-    size: Number(m[2])
+    firstSeq: fan.firstSeq,
+    size: fan.size
   };
 }
 __name(parseStepFanGroup, "parseStepFanGroup");
+function parseFanGroup(group) {
+  const m = group ? /^(all|steps):(\d+)(?::n?(\d+))?(:failFast)?$/.exec(group) : null;
+  if (!m) return void 0;
+  if (m[1] === "steps" && m[3] === void 0) return void 0;
+  return {
+    kind: m[1],
+    firstSeq: Number(m[2]),
+    size: m[3] === void 0 ? void 0 : Number(m[3]),
+    failFast: m[4] !== void 0
+  };
+}
+__name(parseFanGroup, "parseFanGroup");
 function allWait(runId, firstSeq, wave) {
   const base = allBase(runId, firstSeq, wave);
   return {
@@ -1313,7 +1333,7 @@ function parentRunIdOf(runId) {
   return ENGINE_CHILD_ID.exec(runId)?.[1];
 }
 __name(parentRunIdOf, "parentRunIdOf");
-var GROUP = /^all:(\d+)(:failFast)?$/;
+var GROUP = /^all:(\d+)(?::n\d+)?(:failFast)?$/;
 var REST = /^(?:w(\d+)\.)?\d+$/;
 function fanOfWaiter(waiter) {
   const group = waiter.parallelGroup ? GROUP.exec(waiter.parallelGroup) : null;
@@ -3313,7 +3333,7 @@ function createWorkflowCtx(host, runId, compensations, workflow = "", searchAttr
     const waves = allWaves(inputs.length, opts?.concurrency);
     const positions = inputs.map(() => pos.next());
     const firstSeq = positions[0];
-    const group = allGroup(firstSeq, mode);
+    const group = allGroup(firstSeq, inputs.length, mode);
     const waveOf = /* @__PURE__ */ __name((i) => waves ? Math.floor(i / waves.waveSize) : void 0, "waveOf");
     const id = /* @__PURE__ */ __name((i) => allChildId(runId, firstSeq, i, waveOf(i)), "id");
     const { checkpoints: existing, folded } = await readFan(positions, [
@@ -8098,6 +8118,110 @@ var RunGateway = class {
   }
 };
 
+// src/run-detail-summary.ts
+var FAN_SUMMARY_FAILURES = 20;
+var SUMMARY_CHILD_LIMIT = 200;
+var FAN_PAGE_MAX = 500;
+function foldedCount(cp) {
+  if (!cp.name.startsWith(FOLDED_PREFIX)) return void 0;
+  const values = cp.output?.values;
+  return Array.isArray(values) ? values.length : 0;
+}
+__name(foldedCount, "foldedCount");
+function isFailedMember(cp) {
+  if (cp.status === "failed") return true;
+  if (!cp.name.startsWith("signal:child:") || cp.status !== "completed") return false;
+  return cp.output?.ok === false;
+}
+__name(isFailedMember, "isFailedMember");
+function fanLabel(members) {
+  if (members.some((cp) => cp.name.startsWith("signal:child:") || foldedCount(cp) !== void 0)) {
+    return "child runs";
+  }
+  const first = members[0]?.name ?? "";
+  return members.every((cp) => cp.name === first) ? first : "steps";
+}
+__name(fanLabel, "fanLabel");
+function summarizeFan(group, members) {
+  const counts = {};
+  const failures = [];
+  let size = 0;
+  let startedAt;
+  let finishedAt;
+  let firstSeq = Number.POSITIVE_INFINITY;
+  let lastSeq = Number.NEGATIVE_INFINITY;
+  for (const cp of members) {
+    firstSeq = Math.min(firstSeq, cp.seq);
+    lastSeq = Math.max(lastSeq, cp.seq);
+    const folded = foldedCount(cp);
+    const n = folded ?? 1;
+    size += n;
+    const status = isFailedMember(cp) ? "failed" : cp.status;
+    counts[status] = (counts[status] ?? 0) + n;
+    if (status === "failed" && failures.length < FAN_SUMMARY_FAILURES) failures.push(cp);
+    if (cp.status !== "pending" && cp.status !== "running") {
+      if (!startedAt || cp.startedAt < startedAt) startedAt = cp.startedAt;
+      if (!finishedAt || cp.finishedAt > finishedAt) finishedAt = cp.finishedAt;
+    } else if (!startedAt || cp.enqueuedAt < startedAt) {
+      startedAt = cp.enqueuedAt;
+    }
+  }
+  const parsed = parseFanGroup(group);
+  const total = parsed?.size;
+  return {
+    group,
+    label: fanLabel(members),
+    firstSeq,
+    lastSeq,
+    size,
+    total,
+    notStarted: total === void 0 ? void 0 : Math.max(0, total - size),
+    failFast: parsed?.failFast ?? false,
+    counts,
+    startedAt,
+    finishedAt,
+    failures
+  };
+}
+__name(summarizeFan, "summarizeFan");
+function summarizeTimeline(timeline, over) {
+  const byGroup = /* @__PURE__ */ new Map();
+  for (const cp of timeline) {
+    if (cp.parallelGroup === void 0) continue;
+    const members = byGroup.get(cp.parallelGroup);
+    if (members) members.push(cp);
+    else byGroup.set(cp.parallelGroup, [
+      cp
+    ]);
+  }
+  const summarized = /* @__PURE__ */ new Set();
+  const fans = [];
+  for (const [group, members] of byGroup) {
+    if (members.length <= over && (parseFanGroup(group)?.size ?? 0) <= over) continue;
+    summarized.add(group);
+    fans.push(summarizeFan(group, members));
+  }
+  if (fans.length === 0) return {
+    timeline,
+    fans
+  };
+  return {
+    timeline: timeline.filter((cp) => cp.parallelGroup === void 0 || !summarized.has(cp.parallelGroup)),
+    fans: fans.sort((a, b) => a.firstSeq - b.firstSeq)
+  };
+}
+__name(summarizeTimeline, "summarizeTimeline");
+function pageFan(timeline, group, query) {
+  const matching = timeline.filter((cp) => cp.parallelGroup === group && (!query.failedOnly || isFailedMember(cp)));
+  const offset = query.offset !== void 0 && Number.isFinite(query.offset) ? Math.max(0, Math.floor(query.offset)) : 0;
+  const limit = query.limit !== void 0 && Number.isFinite(query.limit) ? Math.min(FAN_PAGE_MAX, Math.max(1, Math.floor(query.limit))) : 100;
+  return {
+    items: matching.slice(offset, offset + limit),
+    total: matching.length
+  };
+}
+__name(pageFan, "pageFan");
+
 // src/codec-state-store.ts
 var CodecStateStore = class {
   static {
@@ -9104,6 +9228,7 @@ var InMemoryTransport = class {
   EVENT_TOKEN_PREFIX,
   Entities,
   EventAccumulators,
+  FAN_SUMMARY_FAILURES,
   FatalError,
   GatherError,
   InMemoryAdmissionBackend,
@@ -9125,6 +9250,7 @@ var InMemoryTransport = class {
   SINGLETON_ADMITTED_TAG,
   STATE_STORE,
   STATE_STORE_CANONICAL,
+  SUMMARY_CHILD_LIMIT,
   ScheduleAlreadyExistsError,
   ScheduleClient,
   ScheduleNotFoundError,
@@ -9151,6 +9277,7 @@ var InMemoryTransport = class {
   buildWorkflowDirectory,
   canRoute,
   capableWorkers,
+  childIdsOf,
   classifyWaiterToken,
   clearDurableExecutionWrappers,
   clearTerminalSingletonAdmission,
@@ -9179,6 +9306,7 @@ var InMemoryTransport = class {
   info,
   isEngineMintedTag,
   isEventToken,
+  isFailedMember,
   isLegacyDescriptor,
   isNonEmptyRunScope,
   isWorkflowControlFlowSignal,
@@ -9193,6 +9321,7 @@ var InMemoryTransport = class {
   normalizeAttributeRows,
   normalizeDescriptor,
   observedAnnouncements,
+  pageFan,
   parentRunIdOf,
   parseDuration,
   partitionOfToken,
@@ -9222,6 +9351,8 @@ var InMemoryTransport = class {
   sub,
   subEvent,
   subProcess,
+  summarizeFan,
+  summarizeTimeline,
   tenantGroup,
   useDurableExecution,
   warn,