@dudousxd/nestjs-durable-core 0.62.1 → 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,
@@ -6129,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) {