@dudousxd/nestjs-durable-core 0.62.0 → 0.63.0

package/dist/index.d.cts

@@ -627,6 +627,24 @@ interface WorkflowRun {
      * store persists it as `'default'`. Read paths (dashboard, `getRun`) are NOT namespace-scoped.
      */
     namespace?: string | undefined;
+    /**
+     * The npm package that DECLARED this run's workflow — e.g. `@dudousxd/nestjs-catalog-pipeline` for
+     * a workflow shipped by a library, or the host app's own `package.json` `name` for one written in
+     * the app. This is a CODE-PROVENANCE axis ("which lib owns this body"), NOT a tenancy axis — for
+     * that, see {@link namespace}.
+     *
+     * Stamped at creation from the workflow's registration, exactly as {@link namespace} is stamped
+     * from the creating engine. It is DERIVED, never caller input: `StartOptions` has no `origin`, so
+     * nothing a caller passes to `start` can make a run claim another lib's name.
+     *
+     * `undefined` means UNKNOWN — never "the app". It is what you get for a run created before this
+     * field existed, for a registration path that carries no origin (`registerRemote`, convention
+     * routing, a synthesized remote child, or a bare `engine.register` with no `origin` option), and
+     * for a workflow whose declaring package could not be resolved with confidence. A wrong origin is
+     * worse than an absent one: a filter that silently drops runs looks exactly like runs that never
+     * existed, so callers must render unknown as unknown and never fold it into a real package.
+     */
+    origin?: string | undefined;
     /**
      * Dispatch priority for a REMOTE run (one advanced by a {@link WorkflowExecutor} over a broker):
      * carried onto each {@link WorkflowTask} so an urgent child workflow can jump ahead of enqueued
@@ -1045,6 +1063,15 @@ interface RunQuery {
     attributes?: AttributeFilter[] | undefined;
     /** Restrict to runs in this namespace (exact match), ANDed with the other predicates. */
     namespace?: string | undefined;
+    /**
+     * Restrict to runs whose workflow was declared by this package (exact match against
+     * {@link WorkflowRun.origin}), ANDed with the other predicates.
+     *
+     * A run with NO origin (unknown — see the field) matches no `origin` value at all, so a UI facet
+     * built on this must keep an "all origins" option: filtering by any single package silently hides
+     * every unattributed run, which reads to an operator as "those runs do not exist".
+     */
+    origin?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }
@@ -2262,7 +2289,14 @@ declare class EventAccumulators {
 }
 
 type WorkflowFn = (ctx: InternalWorkflowCtx, input: unknown) => Promise<unknown>;
-/** Options for {@link WorkflowEngine.start}. */
+/**
+ * Options for {@link WorkflowEngine.start}.
+ *
+ * Note the absence of `origin`: {@link WorkflowRun.origin} says which PACKAGE declared the workflow,
+ * which is a property of the registered code, not of whoever started it. It is taken from the
+ * registration and nothing here can override it — otherwise one caller could label its runs as
+ * another lib's, and an origin filter would quietly lie.
+ */
 interface StartOptions {
     /** Run-scoped tags, merged with the workflow's static `@Workflow({ tags })` onto the run. */
     tags?: string[] | undefined;
@@ -2596,6 +2630,12 @@ declare class WorkflowEngine {
         /** Capabilities a live worker must advertise to run this workflow's turns (handshake §7.5).
          *  Only meaningful with `group`/`executor` (a remote/group-served workflow). Absent = runs anywhere. */
         requires?: string[] | undefined;
+        /** The package that DECLARED this workflow, stamped onto every run started from it (see
+         *  {@link WorkflowRun.origin}). Supplied by the registering integration — `@dudousxd/nestjs-durable`
+         *  derives it from the `@Workflow` class's declaring file — never by whoever calls `start`. Omit
+         *  when it cannot be derived with confidence: absent means UNKNOWN, and an absent origin is far
+         *  cheaper to live with than a wrong one. */
+        origin?: string | undefined;
     }): void;
     /**
      * The retained in-process body for `name@version`, for an IN-APP worker that consumes this engine's

package/dist/index.d.ts

@@ -627,6 +627,24 @@ interface WorkflowRun {
      * store persists it as `'default'`. Read paths (dashboard, `getRun`) are NOT namespace-scoped.
      */
     namespace?: string | undefined;
+    /**
+     * The npm package that DECLARED this run's workflow — e.g. `@dudousxd/nestjs-catalog-pipeline` for
+     * a workflow shipped by a library, or the host app's own `package.json` `name` for one written in
+     * the app. This is a CODE-PROVENANCE axis ("which lib owns this body"), NOT a tenancy axis — for
+     * that, see {@link namespace}.
+     *
+     * Stamped at creation from the workflow's registration, exactly as {@link namespace} is stamped
+     * from the creating engine. It is DERIVED, never caller input: `StartOptions` has no `origin`, so
+     * nothing a caller passes to `start` can make a run claim another lib's name.
+     *
+     * `undefined` means UNKNOWN — never "the app". It is what you get for a run created before this
+     * field existed, for a registration path that carries no origin (`registerRemote`, convention
+     * routing, a synthesized remote child, or a bare `engine.register` with no `origin` option), and
+     * for a workflow whose declaring package could not be resolved with confidence. A wrong origin is
+     * worse than an absent one: a filter that silently drops runs looks exactly like runs that never
+     * existed, so callers must render unknown as unknown and never fold it into a real package.
+     */
+    origin?: string | undefined;
     /**
      * Dispatch priority for a REMOTE run (one advanced by a {@link WorkflowExecutor} over a broker):
      * carried onto each {@link WorkflowTask} so an urgent child workflow can jump ahead of enqueued
@@ -1045,6 +1063,15 @@ interface RunQuery {
     attributes?: AttributeFilter[] | undefined;
     /** Restrict to runs in this namespace (exact match), ANDed with the other predicates. */
     namespace?: string | undefined;
+    /**
+     * Restrict to runs whose workflow was declared by this package (exact match against
+     * {@link WorkflowRun.origin}), ANDed with the other predicates.
+     *
+     * A run with NO origin (unknown — see the field) matches no `origin` value at all, so a UI facet
+     * built on this must keep an "all origins" option: filtering by any single package silently hides
+     * every unattributed run, which reads to an operator as "those runs do not exist".
+     */
+    origin?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
 }
@@ -2262,7 +2289,14 @@ declare class EventAccumulators {
 }
 
 type WorkflowFn = (ctx: InternalWorkflowCtx, input: unknown) => Promise<unknown>;
-/** Options for {@link WorkflowEngine.start}. */
+/**
+ * Options for {@link WorkflowEngine.start}.
+ *
+ * Note the absence of `origin`: {@link WorkflowRun.origin} says which PACKAGE declared the workflow,
+ * which is a property of the registered code, not of whoever started it. It is taken from the
+ * registration and nothing here can override it — otherwise one caller could label its runs as
+ * another lib's, and an origin filter would quietly lie.
+ */
 interface StartOptions {
     /** Run-scoped tags, merged with the workflow's static `@Workflow({ tags })` onto the run. */
     tags?: string[] | undefined;
@@ -2596,6 +2630,12 @@ declare class WorkflowEngine {
         /** Capabilities a live worker must advertise to run this workflow's turns (handshake §7.5).
          *  Only meaningful with `group`/`executor` (a remote/group-served workflow). Absent = runs anywhere. */
         requires?: string[] | undefined;
+        /** The package that DECLARED this workflow, stamped onto every run started from it (see
+         *  {@link WorkflowRun.origin}). Supplied by the registering integration — `@dudousxd/nestjs-durable`
+         *  derives it from the `@Workflow` class's declaring file — never by whoever calls `start`. Omit
+         *  when it cannot be derived with confidence: absent means UNKNOWN, and an absent origin is far
+         *  cheaper to live with than a wrong one. */
+        origin?: string | undefined;
     }): void;
     /**
      * The retained in-process body for `name@version`, for an IN-APP worker that consumes this engine's

package/dist/index.js

@@ -2558,6 +2558,7 @@ var WorkflowEngine = class {
       onEvent: opts?.onEvent,
       eventBatch: opts?.eventBatch,
       requires: opts?.requires,
+      origin: opts?.origin,
       // A real, retained in-process body — so `workflowBody` can hand it to an in-app worker, and so
       // it is NOT confused with the throwing stub `registerRemote` installs for a body-less remote.
       hasBody: true
@@ -2784,6 +2785,11 @@ var WorkflowEngine = class {
       workflowVersion: registered.version,
       status: "pending",
       namespace: opts?.namespace ?? this.namespace,
+      // DERIVED from the registration, exactly like `namespace` is derived from this engine — there is
+      // deliberately no `opts.origin`, so a caller cannot label its run as another package's work.
+      // `undefined` when the registration carried none (remote/convention/synthesized child, or a
+      // registrar that could not resolve the declaring package): unknown, not "the app".
+      origin: registered.origin,
       input,
       tags,
       searchAttributes: opts?.searchAttributes,
@@ -5658,6 +5664,43 @@ __name(collectMetrics, "collectMetrics");
 
 // src/scheduler.ts
 import { createRequire } from "node:module";
+
+// src/cron-compat.ts
+function isIndexable(value) {
+  return typeof value === "object" && value !== null || typeof value === "function";
+}
+__name(isIndexable, "isIndexable");
+function unwrapDefault(module_) {
+  if (!isIndexable(module_)) return module_;
+  if (Reflect.get(module_, "parseExpression") !== void 0) return module_;
+  if (Reflect.get(module_, "CronExpressionParser") !== void 0) return module_;
+  const inner = Reflect.get(module_, "default");
+  return inner === void 0 ? module_ : inner;
+}
+__name(unwrapDefault, "unwrapDefault");
+function v4Entry(module_) {
+  if (!isIndexable(module_)) return void 0;
+  const parse = Reflect.get(module_, "parseExpression");
+  if (typeof parse !== "function") return void 0;
+  return (expr, options) => parse.call(module_, expr, options);
+}
+__name(v4Entry, "v4Entry");
+function v5Entry(module_) {
+  if (!isIndexable(module_)) return void 0;
+  const parser = Reflect.get(module_, "CronExpressionParser");
+  if (!isIndexable(parser)) return void 0;
+  const parse = Reflect.get(parser, "parse");
+  if (typeof parse !== "function") return void 0;
+  return (expr, options) => parse.call(parser, expr, options);
+}
+__name(v5Entry, "v5Entry");
+function resolveCronParse(module_) {
+  const resolved = unwrapDefault(module_);
+  return v4Entry(resolved) ?? v5Entry(resolved);
+}
+__name(resolveCronParse, "resolveCronParse");
+
+// src/scheduler.ts
 var nodeRequire = createRequire(import.meta.url);
 var defaultSleep = /* @__PURE__ */ __name((ms) => new Promise((r) => setTimeout(r, ms)), "defaultSleep");
 function scheduledRunId(key, everyMs, nowMs) {
@@ -5666,7 +5709,7 @@ function scheduledRunId(key, everyMs, nowMs) {
 __name(scheduledRunId, "scheduledRunId");
 var cronParser;
 function loadCronParser() {
-  if (cronParser) return cronParser;
+  if (cronParser !== void 0) return cronParser;
   try {
     cronParser = nodeRequire("cron-parser");
   } catch {
@@ -5676,12 +5719,14 @@ function loadCronParser() {
 }
 __name(loadCronParser, "loadCronParser");
 function prevCronFireMs(expr, nowMs, timezone = "UTC") {
-  const parser = loadCronParser();
-  const it = parser.parseExpression(expr, {
+  const parse = resolveCronParse(loadCronParser());
+  if (!parse) {
+    throw new Error(`the installed "cron-parser" exposes neither v4's parseExpression nor v5's CronExpressionParser.parse \u2014 the supported range is ^4.0.0 || ^5.0.0.`);
+  }
+  return parse(expr, {
     currentDate: new Date(nowMs + 1),
     tz: timezone
-  });
-  return it.prev().toDate().getTime();
+  }).prev().toDate().getTime();
 }
 __name(prevCronFireMs, "prevCronFireMs");
 function scheduleRunIdAt(s, nowMs) {
@@ -6090,6 +6135,7 @@ var InMemoryStateStore = class {
     if (query.statuses) runs = runs.filter((r) => query.statuses?.includes(r.status));
     if (query.tag) runs = runs.filter((r) => r.tags?.includes(query.tag));
     if (query.namespace !== void 0) runs = runs.filter((r) => r.namespace === query.namespace);
+    if (query.origin !== void 0) runs = runs.filter((r) => r.origin === query.origin);
     if (query.attributes?.length) {
       let candidates = null;
       for (const f of query.attributes) {