@graphrefly/graphrefly 0.10.0 → 0.12.0

package/dist/{index-BYEgosAX.d.cts → index-QfbXNW1N.d.cts}

@@ -1,4 +1,4 @@
-import { k as Messages, N as Node, l as NodeDescribeKind, m as NodeGuard, a as NodeOptions, a3 as NodeInspectorHook, o as NodeStatus, A as Actor, p as NodeTransportOptions, n as NodeSink, S as SubscribeHints, c as NodeFn, C as COMPLETE, D as DATA, d as DEFAULT_ACTOR, e as DIRTY, f as DescribeDetail, g as DescribeField, h as DescribeNodeOutput, E as ERROR, G as GuardAction, i as GuardDenied, j as GuardDeniedDetails, H as HashFn, I as INVALIDATE, M as Message, b as NodeActions, q as NodeVersionInfo, O as OnMessageHandler, P as PAUSE, r as PolicyAllow, s as PolicyDeny, t as PolicyRuleData, R as RESOLVED, u as RESUME, T as TEARDOWN, V as V0, v as V1, w as VersioningLevel, x as VersioningOptions, y as accessHintForGuard, z as advanceVersion, B as createVersioning, F as defaultHash, J as describeNode, K as isKnownMessageType, L as isPhase2Message, Q as isTerminalMessage, U as isV1, W as knownMessageTypes, X as messageTier, Y as metaSnapshot, Z as node, _ as normalizeActor, $ as policy, a0 as policyFromRules, a1 as propagatesToMeta, a2 as resolveDescribeFields } from './meta-BJEU8fYz.cjs';
+import { m as Messages, N as Node, n as NodeDescribeKind, o as NodeGuard, a as NodeOptions, a6 as NodeInspectorHook, q as NodeStatus, A as Actor, r as NodeTransportOptions, p as NodeSink, S as SubscribeHints, c as NodeFn, C as CLEANUP_RESULT, d as COMPLETE, e as CleanupResult, D as DATA, f as DEFAULT_ACTOR, g as DIRTY, h as DescribeDetail, i as DescribeField, j as DescribeNodeOutput, E as ERROR, G as GuardAction, k as GuardDenied, l as GuardDeniedDetails, H as HashFn, I as INVALIDATE, M as Message, b as NodeActions, s as NodeVersionInfo, O as OnMessageHandler, P as PAUSE, t as PolicyAllow, u as PolicyDeny, v as PolicyRuleData, R as RESOLVED, w as RESUME, T as TEARDOWN, V as V0, x as V1, y as VersioningLevel, z as VersioningOptions, B as accessHintForGuard, F as advanceVersion, J as cleanupResult, K as createVersioning, L as defaultHash, Q as describeNode, U as isKnownMessageType, W as isPhase2Message, X as isTerminalMessage, Y as isV1, Z as knownMessageTypes, _ as messageTier, $ as metaSnapshot, a0 as node, a1 as normalizeActor, a2 as policy, a3 as policyFromRules, a4 as propagatesToMeta, a5 as resolveDescribeFields } from './meta-BcuDhtwu.cjs';
 
 /**
  * Returns whether the current call stack is inside a batch scope **or** while
@@ -116,6 +116,85 @@ declare function emitWithBatch(emit: (messages: Messages) => void, messages: Mes
     strategy?: "partition" | "sequential";
 }): void;
 
+/**
+ * bridge — graph-visible message forwarding between two nodes.
+ *
+ * Replaces ad-hoc `subscribe()` bridges that bypass graph topology.
+ * The returned node is an effect that intercepts messages from `from`
+ * and forwards them to `to.down()`. Register it with `graph.add()` to
+ * make the bridge visible in `describe()` and `snapshot()`.
+ *
+ * **Upstream path:** The bridge node has `from` as its dep, so anything
+ * downstream of the bridge that calls `up()` naturally reaches `from`.
+ * If `to` is used as a dep by other nodes and those nodes send `up()`,
+ * the messages reach `to`'s deps (not `from`). For full upstream relay
+ * across the bridge boundary, wire the bridge as a dep of `to`'s
+ * consumers or use `graph.connect()`.
+ *
+ * **ABAC / guards:** `to.down()` is called without `NodeTransportOptions`,
+ * so any ABAC guard on `to` receives `actor = undefined`. Upstream (`up()`)
+ * messages propagate through the dep chain the same way — no actor is
+ * injected on either path. Both paths are intentionally unguarded; if `to`
+ * requires a specific actor, provide a guarded wrapper node and bridge to
+ * that instead.
+ *
+ * **Default forwarding:** All standard message types are forwarded by
+ * default, including TEARDOWN, PAUSE, RESUME, and INVALIDATE. Use the
+ * `down` option to restrict which types are forwarded. Callers that need
+ * to exclude TEARDOWN (e.g. inter-stage wiring in `funnel()`) pass an
+ * explicit `down` array without TEARDOWN.
+ *
+ * @module
+ */
+
+/** Options for {@link bridge}. */
+type BridgeOptions = {
+    /** Node name (for graph registration / describe). */
+    name?: string;
+    /**
+     * Standard message types to forward downstream. Default: all standard
+     * types. Unknown (non-standard) types always forward per spec §1.3.6
+     * regardless of this option.
+     */
+    down?: readonly symbol[];
+};
+/** All standard types forwarded by default. Export for callers that
+ *  need to customize (e.g. exclude TEARDOWN). */
+declare const DEFAULT_DOWN: readonly symbol[];
+/**
+ * Create a graph-visible bridge node that forwards messages from `from` to `to`.
+ *
+ * The bridge is a real node (effect) — it shows up in `describe()`, participates
+ * in two-phase push, and cleans up on TEARDOWN. Register it via `graph.add()`
+ * to make it part of the graph topology.
+ *
+ * **Unknown message types** (custom domain signals not in the standard protocol
+ * set) are always forwarded to `to`, regardless of the `down` option. This
+ * satisfies spec §1.3.6 ("unknown types forward unchanged").
+ *
+ * **COMPLETE / ERROR**: when forwarded, the bridge also transitions to terminal
+ * state so graph-wide completion detection works correctly.
+ *
+ * @param from - Source node to observe.
+ * @param to - Target node to forward messages to via `to.down()`.
+ * @param opts - Optional configuration.
+ * @returns A bridge effect node. Add it to a graph with `graph.add(name, bridge(...))`.
+ *
+ * @example
+ * ```ts
+ * import { bridge, state } from "@graphrefly/graphrefly-ts";
+ *
+ * const a = state(0);
+ * const b = state(0);
+ * const br = bridge(a, b, { name: "__bridge_a_b" });
+ * graph.add("__bridge_a_b", br);
+ * // Now a's messages flow to b, visible in describe()
+ * ```
+ *
+ * @category core
+ */
+declare function bridge<T = unknown>(from: Node<T>, to: Node, opts?: BridgeOptions): Node<unknown>;
+
 /**
  * Centralised timestamp utilities.
  *
@@ -414,9 +493,13 @@ declare class ResettableTimer {
  */
 
 declare const index_Actor: typeof Actor;
+type index_BridgeOptions = BridgeOptions;
+declare const index_CLEANUP_RESULT: typeof CLEANUP_RESULT;
 declare const index_COMPLETE: typeof COMPLETE;
+declare const index_CleanupResult: typeof CleanupResult;
 declare const index_DATA: typeof DATA;
 declare const index_DEFAULT_ACTOR: typeof DEFAULT_ACTOR;
+declare const index_DEFAULT_DOWN: typeof DEFAULT_DOWN;
 declare const index_DIRTY: typeof DIRTY;
 declare const index_DescribeDetail: typeof DescribeDetail;
 declare const index_DescribeField: typeof DescribeField;
@@ -463,6 +546,8 @@ declare const index_VersioningOptions: typeof VersioningOptions;
 declare const index_accessHintForGuard: typeof accessHintForGuard;
 declare const index_advanceVersion: typeof advanceVersion;
 declare const index_batch: typeof batch;
+declare const index_bridge: typeof bridge;
+declare const index_cleanupResult: typeof cleanupResult;
 declare const index_createVersioning: typeof createVersioning;
 declare const index_defaultHash: typeof defaultHash;
 declare const index_derived: typeof derived;
@@ -491,7 +576,7 @@ declare const index_resolveDescribeFields: typeof resolveDescribeFields;
 declare const index_state: typeof state;
 declare const index_wallClockNs: typeof wallClockNs;
 declare namespace index {
-  export { index_Actor as Actor, index_COMPLETE as COMPLETE, index_DATA as DATA, index_DEFAULT_ACTOR as DEFAULT_ACTOR, index_DIRTY as DIRTY, index_DescribeDetail as DescribeDetail, index_DescribeField as DescribeField, index_DescribeNodeOutput as DescribeNodeOutput, type index_DynGet as DynGet, type index_DynamicNodeFn as DynamicNodeFn, index_DynamicNodeImpl as DynamicNodeImpl, type index_DynamicNodeOptions as DynamicNodeOptions, index_ERROR as ERROR, index_GuardAction as GuardAction, index_GuardDenied as GuardDenied, index_GuardDeniedDetails as GuardDeniedDetails, index_HashFn as HashFn, index_INVALIDATE as INVALIDATE, index_Message as Message, index_Messages as Messages, index_Node as Node, index_NodeActions as NodeActions, index_NodeDescribeKind as NodeDescribeKind, index_NodeFn as NodeFn, index_NodeGuard as NodeGuard, index_NodeOptions as NodeOptions, index_NodeSink as NodeSink, index_NodeStatus as NodeStatus, index_NodeTransportOptions as NodeTransportOptions, index_NodeVersionInfo as NodeVersionInfo, index_OnMessageHandler as OnMessageHandler, index_PAUSE as PAUSE, type index_PipeOperator as PipeOperator, index_PolicyAllow as PolicyAllow, index_PolicyDeny as PolicyDeny, index_PolicyRuleData as PolicyRuleData, index_RESOLVED as RESOLVED, index_RESUME as RESUME, index_ResettableTimer as ResettableTimer, index_SubscribeHints as SubscribeHints, index_TEARDOWN as TEARDOWN, index_V0 as V0, index_V1 as V1, index_VersioningLevel as VersioningLevel, index_VersioningOptions as VersioningOptions, index_accessHintForGuard as accessHintForGuard, index_advanceVersion as advanceVersion, index_batch as batch, index_createVersioning as createVersioning, index_defaultHash as defaultHash, index_derived as derived, index_describeNode as describeNode, index_dynamicNode as dynamicNode, index_effect as effect, index_emitWithBatch as emitWithBatch, index_isBatching as isBatching, index_isKnownMessageType as isKnownMessageType, index_isPhase2Message as isPhase2Message, index_isTerminalMessage as isTerminalMessage, index_isV1 as isV1, index_knownMessageTypes as knownMessageTypes, index_messageTier as messageTier, index_metaSnapshot as metaSnapshot, index_monotonicNs as monotonicNs, index_node as node, index_normalizeActor as normalizeActor, index_partitionForBatch as partitionForBatch, index_pipe as pipe, index_policy as policy, index_policyFromRules as policyFromRules, index_producer as producer, index_propagatesToMeta as propagatesToMeta, index_resolveDescribeFields as resolveDescribeFields, index_state as state, index_wallClockNs as wallClockNs };
+  export { index_Actor as Actor, type index_BridgeOptions as BridgeOptions, index_CLEANUP_RESULT as CLEANUP_RESULT, index_COMPLETE as COMPLETE, index_CleanupResult as CleanupResult, index_DATA as DATA, index_DEFAULT_ACTOR as DEFAULT_ACTOR, index_DEFAULT_DOWN as DEFAULT_DOWN, index_DIRTY as DIRTY, index_DescribeDetail as DescribeDetail, index_DescribeField as DescribeField, index_DescribeNodeOutput as DescribeNodeOutput, type index_DynGet as DynGet, type index_DynamicNodeFn as DynamicNodeFn, index_DynamicNodeImpl as DynamicNodeImpl, type index_DynamicNodeOptions as DynamicNodeOptions, index_ERROR as ERROR, index_GuardAction as GuardAction, index_GuardDenied as GuardDenied, index_GuardDeniedDetails as GuardDeniedDetails, index_HashFn as HashFn, index_INVALIDATE as INVALIDATE, index_Message as Message, index_Messages as Messages, index_Node as Node, index_NodeActions as NodeActions, index_NodeDescribeKind as NodeDescribeKind, index_NodeFn as NodeFn, index_NodeGuard as NodeGuard, index_NodeOptions as NodeOptions, index_NodeSink as NodeSink, index_NodeStatus as NodeStatus, index_NodeTransportOptions as NodeTransportOptions, index_NodeVersionInfo as NodeVersionInfo, index_OnMessageHandler as OnMessageHandler, index_PAUSE as PAUSE, type index_PipeOperator as PipeOperator, index_PolicyAllow as PolicyAllow, index_PolicyDeny as PolicyDeny, index_PolicyRuleData as PolicyRuleData, index_RESOLVED as RESOLVED, index_RESUME as RESUME, index_ResettableTimer as ResettableTimer, index_SubscribeHints as SubscribeHints, index_TEARDOWN as TEARDOWN, index_V0 as V0, index_V1 as V1, index_VersioningLevel as VersioningLevel, index_VersioningOptions as VersioningOptions, index_accessHintForGuard as accessHintForGuard, index_advanceVersion as advanceVersion, index_batch as batch, index_bridge as bridge, index_cleanupResult as cleanupResult, index_createVersioning as createVersioning, index_defaultHash as defaultHash, index_derived as derived, index_describeNode as describeNode, index_dynamicNode as dynamicNode, index_effect as effect, index_emitWithBatch as emitWithBatch, index_isBatching as isBatching, index_isKnownMessageType as isKnownMessageType, index_isPhase2Message as isPhase2Message, index_isTerminalMessage as isTerminalMessage, index_isV1 as isV1, index_knownMessageTypes as knownMessageTypes, index_messageTier as messageTier, index_metaSnapshot as metaSnapshot, index_monotonicNs as monotonicNs, index_node as node, index_normalizeActor as normalizeActor, index_partitionForBatch as partitionForBatch, index_pipe as pipe, index_policy as policy, index_policyFromRules as policyFromRules, index_producer as producer, index_propagatesToMeta as propagatesToMeta, index_resolveDescribeFields as resolveDescribeFields, index_state as state, index_wallClockNs as wallClockNs };
 }
 
-export { type DynGet as D, type PipeOperator as P, ResettableTimer as R, type DynamicNodeFn as a, DynamicNodeImpl as b, type DynamicNodeOptions as c, batch as d, derived as e, dynamicNode as f, effect as g, emitWithBatch as h, index as i, isBatching as j, pipe as k, producer as l, monotonicNs as m, partitionForBatch as p, state as s, wallClockNs as w };
+export { type BridgeOptions as B, DEFAULT_DOWN as D, type PipeOperator as P, ResettableTimer as R, type DynGet as a, type DynamicNodeFn as b, DynamicNodeImpl as c, type DynamicNodeOptions as d, batch as e, bridge as f, derived as g, dynamicNode as h, index as i, effect as j, emitWithBatch as k, isBatching as l, monotonicNs as m, pipe as n, producer as o, partitionForBatch as p, state as s, wallClockNs as w };

package/dist/{index-BYa2YMat.d.cts → index-aBZ2RoP0.d.cts}

@@ -1,8 +1,8 @@
-import { R as ReactiveLogSnapshot, o as observeGraph$, c as observeNode$, t as toMessages$, d as toObservable } from './reactive-log-BfX6bOSZ.cjs';
+import { R as ReactiveLogSnapshot, o as observeGraph$, c as observeNode$, t as toMessages$, d as toObservable } from './reactive-log-OULQssZg.cjs';
 import { OnModuleInit, OnModuleDestroy, ExecutionContext, CanActivate, DynamicModule } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import { G as Graph, a as GraphOptions, r as GraphPersistSnapshot } from './graph-DqTICAY2.cjs';
-import { A as Actor, N as Node } from './meta-BJEU8fYz.cjs';
+import { G as Graph, a as GraphOptions, r as GraphPersistSnapshot } from './graph-BE10ujU9.cjs';
+import { A as Actor, N as Node } from './meta-BcuDhtwu.cjs';
 
 /** Class constructor key for decorator registries and Nest `ModuleRef.get()`. */
 type DecoratorHostConstructor = abstract new (...args: unknown[]) => unknown;

package/dist/{index-DbwgQ4Cw.d.cts → index-nRulwTr-.d.cts}

@@ -1,4 +1,4 @@
-import { r as GraphPersistSnapshot, A as AutoCheckpointAdapter, D as DescribeFilter, d as GRAPH_META_SEGMENT, G as Graph, e as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, f as GraphCheckpointRecord, g as GraphDescribeOptions, h as GraphDescribeOutput, i as GraphDiagramDirection, j as GraphDiagramOptions, k as GraphDiffChange, l as GraphDiffResult, m as GraphDumpOptions, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, s as GraphSpyHandle, t as GraphSpyOptions, u as GraphSpyTheme, v as GraphSpyThemeName, O as ObserveDetail, w as ObserveEvent, x as ObserveOptions, y as ObserveResult, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as reachable } from './graph-DqTICAY2.cjs';
+import { r as GraphPersistSnapshot, A as AutoCheckpointAdapter, D as DescribeFilter, d as GRAPH_META_SEGMENT, G as Graph, e as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, f as GraphCheckpointRecord, g as GraphDescribeOptions, h as GraphDescribeOutput, i as GraphDiagramDirection, j as GraphDiagramOptions, k as GraphDiffChange, l as GraphDiffResult, m as GraphDumpOptions, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, s as GraphSpyHandle, t as GraphSpyOptions, u as GraphSpyTheme, v as GraphSpyThemeName, O as ObserveDetail, w as ObserveEvent, x as ObserveOptions, y as ObserveResult, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as reachable } from './graph-BE10ujU9.cjs';
 
 /**
  * GraphCodec — pluggable serialization for graph snapshots (Phase 8.6).