@dudousxd/nestjs-durable-core 0.49.4 → 0.50.0

package/dist/index.cjs

@@ -71,6 +71,7 @@ __export(index_exports, {
   normalizeAttributeRows: () => normalizeAttributeRows,
   parseDuration: () => parseDuration,
   prevCronFireMs: () => prevCronFireMs,
+  readSearchAttributes: () => readSearchAttributes,
   resolveRunWaiting: () => resolveRunWaiting,
   runInWorkflowCtx: () => runInWorkflowCtx,
   runSchedules: () => runSchedules,
@@ -1185,6 +1186,11 @@ function normalizeChildOptions(options) {
   } : options ?? {};
 }
 __name(normalizeChildOptions, "normalizeChildOptions");
+function formatIssuePath(path) {
+  if (!path || path.length === 0) return "(root)";
+  return path.map((segment) => String(typeof segment === "object" ? segment.key : segment)).join(".");
+}
+__name(formatIssuePath, "formatIssuePath");
 function resolveStepPolicy(config, opts) {
   const policy = {};
   const retries = opts?.retries ?? config?.retries;
@@ -1215,7 +1221,7 @@ var Position = class Position2 {
     this.seq -= 1;
   }
 };
-function createWorkflowCtx(host, runId, compensations, workflow = "") {
+function createWorkflowCtx(host, runId, compensations, workflow = "", searchAttributesSchema) {
   const { store, replay } = host;
   const pos = new Position();
   const readCheckpoint = /* @__PURE__ */ __name((seq) => {
@@ -1684,6 +1690,24 @@ function createWorkflowCtx(host, runId, compensations, workflow = "") {
       }
       return;
     }
+    if (searchAttributesSchema) {
+      const run = await store.getRun(runId);
+      const merged = {
+        ...run?.searchAttributes ?? {},
+        ...attrs
+      };
+      const result = searchAttributesSchema["~standard"].validate(merged);
+      if (result instanceof Promise) {
+        throw new Error(`workflow "${workflow}": ctx.upsertSearchAttributes schema validation must be synchronous (the searchAttributes schema's \`~standard.validate\` returned a Promise) \u2014 replay-determinism requires a sync validator; drop any async refinement from the schema passed to @Workflow({ searchAttributes }).`);
+      }
+      if (result.issues) {
+        const offendingKeys = [
+          ...new Set(result.issues.map((issue) => formatIssuePath(issue.path)))
+        ];
+        const details = result.issues.map((issue) => `${formatIssuePath(issue.path)}: ${issue.message}`).join("; ");
+        throw new Error(`workflow "${workflow}": ctx.upsertSearchAttributes rejected by its searchAttributes schema \u2014 offending key(s) ${offendingKeys.join(", ")} \u2014 ${details}`);
+      }
+    }
     await host.upsertSearchAttributes(runId, attrs);
     await writeCheckpoint(instantCheckpoint({
       runId,
@@ -2039,6 +2063,7 @@ var WorkflowEngine = class {
       singleton: opts?.singleton,
       executionTimeoutMs: opts?.executionTimeout != null ? parseDuration(opts.executionTimeout) : void 0,
       validateInput: opts?.validateInput,
+      searchAttributesSchema: opts?.searchAttributesSchema,
       onEvent: opts?.onEvent,
       eventBatch: opts?.eventBatch,
       // A real, retained in-process body — so `workflowBody` can hand it to an in-app worker, and so
@@ -3738,7 +3763,7 @@ var WorkflowEngine = class {
     const snapshot = await this.store.listCheckpoints(run.id);
     const replay = /* @__PURE__ */ new Map();
     for (const cp of snapshot) replay.set(cp.seq, cp);
-    const ctx = createWorkflowCtx(this.ctxHostFor(replay, run.namespace), run.id, compensations, run.workflow);
+    const ctx = createWorkflowCtx(this.ctxHostFor(replay, run.namespace), run.id, compensations, run.workflow, registered?.searchAttributesSchema);
     try {
       const output = await runInWorkflowCtx(ctx, () => fn(ctx, run.input));
       if (this.cancelRequested.has(run.id)) {
@@ -4494,12 +4519,17 @@ var TERMINAL_RUN_STATUSES = [
 // src/run-waiting.ts
 var WEBHOOK_PREFIX = "wh:";
 var CHILD_PREFIX = "child:";
+var BREAKPOINT_PREFIX = "bp:";
 var EVENT_PREFIX = "event:";
 function classifyWaiterToken(token) {
   if (token.startsWith(WEBHOOK_PREFIX)) return {
     on: "webhook",
     name: token
   };
+  if (token.startsWith(BREAKPOINT_PREFIX)) return {
+    on: "breakpoint",
+    name: "breakpoint"
+  };
   if (token.startsWith(CHILD_PREFIX)) return {
     on: "child",
     name: token.slice(CHILD_PREFIX.length)
@@ -4920,6 +4950,19 @@ function attributeOperand(filter) {
 }
 __name(attributeOperand, "attributeOperand");
 
+// src/search-attributes-schema.ts
+function readSearchAttributes(schema, run) {
+  const result = schema["~standard"].validate(run.searchAttributes ?? {});
+  if (result instanceof Promise) {
+    throw new Error("readSearchAttributes: schema validation must be synchronous (the searchAttributes schema's `~standard.validate` returned a Promise) \u2014 async Standard Schema validators are not supported.");
+  }
+  if (result.issues) {
+    return {};
+  }
+  return result.value;
+}
+__name(readSearchAttributes, "readSearchAttributes");
+
 // src/tokens.ts
 var STATE_STORE = Symbol.for("nestjs-durable:STATE_STORE");
 var TRANSPORT = Symbol.for("nestjs-durable:TRANSPORT");
@@ -5296,6 +5339,7 @@ var InMemoryTransport = class {
   normalizeAttributeRows,
   parseDuration,
   prevCronFireMs,
+  readSearchAttributes,
   resolveRunWaiting,
   runInWorkflowCtx,
   runSchedules,