@graphrefly/graphrefly 0.47.2 → 0.48.0

package/dist/compat/index.cjs

@@ -621,6 +621,12 @@ var GraphReflyEventExplorer = class {
   }
   disposers = [];
   scheduleNodeNames = [];
+  // F-CATCH D-1 (qa F-b): de-dup the DI-miss warning. `resolveInstance` is
+  // called once per handler-registry that a host appears in (EVENT / CRON /
+  // CQRS / …), so an unresolvable host decorated in multiple families would
+  // otherwise emit one warning per registry for a single root cause. Scoped
+  // per explorer instance (one instance per module via the useFactory).
+  warnedUnresolved = /* @__PURE__ */ new Set();
   onModuleInit() {
     this.wireEvents();
     this.wireIntervals();
@@ -851,11 +857,23 @@ var GraphReflyEventExplorer = class {
     }
   }
   resolveInstance(ctor) {
+    let instance = null;
     try {
-      return this.moduleRef.get(ctor, { strict: false });
+      instance = this.moduleRef.get(ctor, { strict: false }) ?? null;
     } catch {
+      instance = null;
+    }
+    if (instance == null) {
+      if (!this.warnedUnresolved.has(ctor)) {
+        this.warnedUnresolved.add(ctor);
+        const name = ctor.name ?? String(ctor);
+        console.warn(
+          `[GraphReFly] decorator host "${name}" not resolvable from DI \u2014 is it registered as a provider in the same module as GraphReflyModule? Its @OnGraphEvent/@Cron/@CqrsHandler handlers will NOT be wired.`
+        );
+      }
       return null;
     }
+    return instance;
   }
 };
 
@@ -1298,6 +1316,9 @@ function fromHeader(headerName = "x-graphrefly-actor") {
     try {
       return JSON.parse(raw);
     } catch {
+      console.warn(
+        `[GraphReFly] fromHeader: header "${headerName}" is present but not valid JSON \u2014 ignoring it and falling back to DEFAULT_ACTOR.`
+      );
       return void 0;
     }
   };
@@ -1355,6 +1376,26 @@ function createAuditLog(opts) {
   }
   return log;
 }
+function readonlyAuditLog(log) {
+  return Object.freeze({
+    get entries() {
+      return log.entries;
+    },
+    get size() {
+      return log.size;
+    },
+    get lastValue() {
+      return log.lastValue;
+    },
+    get mutationLog() {
+      return log.mutationLog;
+    },
+    at: log.at.bind(log),
+    withLatest: log.withLatest.bind(log),
+    view: log.view.bind(log),
+    scan: log.scan.bind(log)
+  });
+}
 function deepFreeze(value) {
   if (value === null || typeof value !== "object" || Object.isFrozen(value)) return value;
   for (const k of Object.keys(value)) {
@@ -1620,7 +1661,10 @@ var CqrsGraph = class extends import_graph2.Graph {
   _dispatchSeqCursor;
   /** Audit log of every command dispatch (Audit 2). */
   dispatches;
-  /** Alias for {@link CqrsGraph.dispatches} (Audit 2 `.audit` duplication). */
+  /**
+   * Read-only view of {@link CqrsGraph.dispatches} (Audit 2 `.audit`
+   * duplication; M7 — cannot mutate the canonical log via the alias).
+   */
   audit;
   /** Per-aggregate LRU eviction observability; secondary log to `dispatches`. */
   aggregateEvictions;
@@ -1635,7 +1679,7 @@ var CqrsGraph = class extends import_graph2.Graph {
       retainedLimit: this._retainedLimit,
       graph: this
     });
-    this.audit = this.dispatches;
+    this.audit = readonlyAuditLog(this.dispatches);
     this.aggregateEvictions = createAuditLog({
       name: "aggregateEvictions",
       retainedLimit: this._retainedLimit,
@@ -1820,6 +1864,9 @@ var CqrsGraph = class extends import_graph2.Graph {
         }
       );
     } catch {
+      console.warn(
+        `[GraphReFly] cqrs: per-aggregate event node "${mountName}" hit a name-collision race (event "${type}", aggregate "${aggregateId}") \u2014 falling back to an unmounted node; this aggregate's stream still works but will NOT appear in graph.describe()/observe().`
+      );
       guarded = (0, import_core9.node)(
         [entries],
         (batchData, actions, ctx) => {
@@ -2321,7 +2368,7 @@ var CqrsGraph = class extends import_graph2.Graph {
     return {
       node: sagaNode,
       invocations,
-      audit: invocations,
+      audit: readonlyAuditLog(invocations),
       cursors
     };
   }