@graphrefly/graphrefly 0.47.2 → 0.48.0

package/dist/compat/index.d.cts

@@ -1,6 +1,6 @@
 export { i as jotai } from '../index-dX9IzPqj.cjs';
 export { i as nanostores } from '../index-Brp888t0.cjs';
-export { i as nestjs } from '../index-B_p8tnvf.cjs';
+export { i as nestjs } from '../index-D1z3XcF9.cjs';
 export { i as react } from '../index-BFsng6v1.cjs';
 import { Node } from '@graphrefly/pure-ts/core';
 export { i as solid } from '../index-B6pxYJzO.cjs';

package/dist/compat/index.d.ts

@@ -1,6 +1,6 @@
 export { i as jotai } from '../index-dX9IzPqj.js';
 export { i as nanostores } from '../index-Brp888t0.js';
-export { i as nestjs } from '../index-_HDSmPyp.js';
+export { i as nestjs } from '../index-DZ6yua0Q.js';
 export { i as react } from '../index-BFsng6v1.js';
 import { Node } from '@graphrefly/pure-ts/core';
 export { i as solid } from '../index-B6pxYJzO.js';

package/dist/compat/index.js

@@ -1,6 +1,9 @@
+import {
+  nanostores_exports
+} from "../chunk-TP7244Y6.js";
 import {
   nestjs_exports
-} from "../chunk-3O3NKZJW.js";
+} from "../chunk-7T7WLEPM.js";
 import {
   react_exports
 } from "../chunk-3MUSLI6E.js";
@@ -19,13 +22,10 @@ import {
 import {
   jotai_exports
 } from "../chunk-URQ2CBBF.js";
-import {
-  nanostores_exports
-} from "../chunk-TP7244Y6.js";
 import "../chunk-7BULJTL6.js";
-import "../chunk-NY2PYHNC.js";
+import "../chunk-5UY3PNFY.js";
 import "../chunk-FMPF42Q4.js";
-import "../chunk-BXGZFGZ4.js";
+import "../chunk-C5QD5DQX.js";
 import "../chunk-Z65DVDEQ.js";
 import {
   __export

package/dist/compat/nestjs/index.cjs

@@ -293,6 +293,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();
@@ -523,11 +529,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;
   }
 };
 
@@ -970,6 +988,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;
     }
   };
@@ -1027,6 +1048,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)) {
@@ -1292,7 +1333,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;
@@ -1307,7 +1351,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,
@@ -1492,6 +1536,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_core7.node)(
         [entries],
         (batchData, actions, ctx) => {
@@ -1993,7 +2040,7 @@ var CqrsGraph = class extends import_graph2.Graph {
     return {
       node: sagaNode,
       invocations,
-      audit: invocations,
+      audit: readonlyAuditLog(invocations),
       cursors
     };
   }