@graphrefly/graphrefly 0.17.0 → 0.19.0

package/dist/{chunk-R6OHUUYB.js → chunk-AHRKWMNI.js}

@@ -2,10 +2,8 @@ import {
   ResettableTimer
 } from "./chunk-WZ2Z2CRV.js";
 import {
-  describeNode,
-  metaSnapshot,
   resolveDescribeFields
-} from "./chunk-F2ULI3Q3.js";
+} from "./chunk-XUOY3YKN.js";
 import {
   CLEANUP_RESULT,
   COMPLETE,
@@ -19,6 +17,7 @@ import {
   PAUSE,
   RESOLVED,
   RESUME,
+  START,
   TEARDOWN,
   __export,
   accessHintForGuard,
@@ -33,6 +32,7 @@ import {
   effect,
   isBatching,
   isKnownMessageType,
+  isLocalOnly,
   isPhase2Message,
   isTerminalMessage,
   isV1,
@@ -49,7 +49,7 @@ import {
   propagatesToMeta,
   state,
   wallClockNs
-} from "./chunk-BV3TPSBK.js";
+} from "./chunk-YXR3WW3Q.js";
 
 // src/core/index.ts
 var core_exports = {};
@@ -68,6 +68,7 @@ __export(core_exports, {
   RESOLVED: () => RESOLVED,
   RESUME: () => RESUME,
   ResettableTimer: () => ResettableTimer,
+  START: () => START,
   TEARDOWN: () => TEARDOWN,
   accessHintForGuard: () => accessHintForGuard,
   advanceVersion: () => advanceVersion,
@@ -77,18 +78,17 @@ __export(core_exports, {
   createVersioning: () => createVersioning,
   defaultHash: () => defaultHash,
   derived: () => derived,
-  describeNode: () => describeNode,
   downWithBatch: () => downWithBatch,
   dynamicNode: () => dynamicNode,
   effect: () => effect,
   isBatching: () => isBatching,
   isKnownMessageType: () => isKnownMessageType,
+  isLocalOnly: () => isLocalOnly,
   isPhase2Message: () => isPhase2Message,
   isTerminalMessage: () => isTerminalMessage,
   isV1: () => isV1,
   knownMessageTypes: () => knownMessageTypes,
   messageTier: () => messageTier,
-  metaSnapshot: () => metaSnapshot,
   monotonicNs: () => monotonicNs,
   node: () => node,
   normalizeActor: () => normalizeActor,
@@ -159,4 +159,4 @@ export {
   bridge,
   core_exports
 };
-//# sourceMappingURL=chunk-R6OHUUYB.js.map
+//# sourceMappingURL=chunk-AHRKWMNI.js.map

package/dist/chunk-AHRKWMNI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/index.ts","../src/core/bridge.ts"],"sourcesContent":["/**\n * Core layer: message protocol, node primitive, lifecycle (Phase 0).\n */\nexport * from \"./actor.js\";\nexport * from \"./batch.js\";\nexport { type BridgeOptions, bridge, DEFAULT_DOWN } from \"./bridge.js\";\nexport { monotonicNs, wallClockNs } from \"./clock.js\";\nexport * from \"./dynamic-node.js\";\nexport * from \"./guard.js\";\nexport * from \"./messages.js\";\nexport {\n\ttype DescribeDetail,\n\ttype DescribeField,\n\ttype DescribeNodeOutput,\n\tresolveDescribeFields,\n} from \"./meta.js\";\nexport {\n\tCLEANUP_RESULT,\n\ttype CleanupResult,\n\tcleanupResult,\n\ttype Node,\n\ttype NodeActions,\n\ttype NodeDescribeKind,\n\ttype NodeFn,\n\ttype NodeOptions,\n\ttype NodeSink,\n\ttype NodeStatus,\n\ttype NodeTransportOptions,\n\tnode,\n\ttype OnMessageHandler,\n\ttype SubscribeHints,\n} from \"./node.js\";\nexport * from \"./sugar.js\";\nexport { ResettableTimer } from \"./timer.js\";\nexport {\n\tadvanceVersion,\n\tcreateVersioning,\n\tdefaultHash,\n\ttype HashFn,\n\tisV1,\n\ttype NodeVersionInfo,\n\ttype V0,\n\ttype V1,\n\ttype VersioningLevel,\n\ttype VersioningOptions,\n} from \"./versioning.js\";\n","/**\n * bridge — graph-visible message forwarding between two nodes.\n *\n * Replaces ad-hoc `subscribe()` bridges that bypass graph topology.\n * The returned node is an effect that intercepts messages from `from`\n * and forwards them to `to.down()`. Register it with `graph.add()` to\n * make the bridge visible in `describe()` and `snapshot()`.\n *\n * **Upstream path:** The bridge node has `from` as its dep, so anything\n * downstream of the bridge that calls `up()` naturally reaches `from`.\n * If `to` is used as a dep by other nodes and those nodes send `up()`,\n * the messages reach `to`'s deps (not `from`). For full upstream relay\n * across the bridge boundary, wire the bridge as a dep of `to`'s\n * consumers or use `graph.connect()`.\n *\n * **ABAC / guards:** `to.down()` is called without `NodeTransportOptions`,\n * so any ABAC guard on `to` receives `actor = undefined`. Upstream (`up()`)\n * messages propagate through the dep chain the same way — no actor is\n * injected on either path. Both paths are intentionally unguarded; if `to`\n * requires a specific actor, provide a guarded wrapper node and bridge to\n * that instead.\n *\n * **Default forwarding:** All standard message types are forwarded by\n * default, including TEARDOWN, PAUSE, RESUME, and INVALIDATE. Use the\n * `down` option to restrict which types are forwarded. Callers that need\n * to exclude TEARDOWN (e.g. inter-stage wiring in `funnel()`) pass an\n * explicit `down` array without TEARDOWN.\n *\n * @module\n */\n\nimport {\n\tCOMPLETE,\n\tDATA,\n\tDIRTY,\n\tERROR,\n\tINVALIDATE,\n\ttype Message,\n\tPAUSE,\n\tRESOLVED,\n\tRESUME,\n\tTEARDOWN,\n} from \"./messages.js\";\nimport { type Node, type NodeActions, node, type OnMessageHandler } from \"./node.js\";\n\n/** Options for {@link bridge}. */\nexport type BridgeOptions = {\n\t/** Node name (for graph registration / describe). */\n\tname?: string;\n\t/**\n\t * Standard message types to forward downstream. Default: all standard\n\t * types. Unknown (non-standard) types always forward per spec §1.3.6\n\t * regardless of this option.\n\t */\n\tdown?: readonly symbol[];\n};\n\n/** All standard types forwarded by default. Export for callers that\n *  need to customize (e.g. exclude TEARDOWN). */\nexport const DEFAULT_DOWN: readonly symbol[] = [\n\tDATA,\n\tDIRTY,\n\tRESOLVED,\n\tCOMPLETE,\n\tERROR,\n\tTEARDOWN,\n\tPAUSE,\n\tRESUME,\n\tINVALIDATE,\n];\n\n/**\n * All standard message types the bridge understands. Types outside this set\n * are \"unknown\" and must always be forwarded (spec §1.3.6).\n */\nconst STANDARD_TYPES = new Set<symbol>([\n\tDATA,\n\tDIRTY,\n\tRESOLVED,\n\tCOMPLETE,\n\tERROR,\n\tTEARDOWN,\n\tPAUSE,\n\tRESUME,\n\tINVALIDATE,\n]);\n\n/**\n * Create a graph-visible bridge node that forwards messages from `from` to `to`.\n *\n * The bridge is a real node (effect) — it shows up in `describe()`, participates\n * in two-phase push, and cleans up on TEARDOWN. Register it via `graph.add()`\n * to make it part of the graph topology.\n *\n * **Unknown message types** (custom domain signals not in the standard protocol\n * set) are always forwarded to `to`, regardless of the `down` option. This\n * satisfies spec §1.3.6 (\"unknown types forward unchanged\").\n *\n * **COMPLETE / ERROR**: when forwarded, the bridge also transitions to terminal\n * state so graph-wide completion detection works correctly.\n *\n * @param from - Source node to observe.\n * @param to - Target node to forward messages to via `to.down()`.\n * @param opts - Optional configuration.\n * @returns A bridge effect node. Add it to a graph with `graph.add(name, bridge(...))`.\n *\n * @example\n * ```ts\n * import { bridge, state } from \"@graphrefly/graphrefly-ts\";\n *\n * const a = state(0);\n * const b = state(0);\n * const br = bridge(a, b, { name: \"__bridge_a_b\" });\n * graph.add(\"__bridge_a_b\", br);\n * // Now a's messages flow to b, visible in describe()\n * ```\n *\n * @category core\n */\nexport function bridge<T = unknown>(from: Node<T>, to: Node, opts?: BridgeOptions): Node<unknown> {\n\tconst allowedDown = new Set(opts?.down ?? DEFAULT_DOWN);\n\n\tconst onMessage: OnMessageHandler = (\n\t\tmsg: Message,\n\t\t_depIndex: number,\n\t\t_actions: NodeActions,\n\t): boolean => {\n\t\tconst type = msg[0];\n\n\t\t// Unknown types (custom domain signals) always forward — spec §1.3.6.\n\t\tif (!STANDARD_TYPES.has(type)) {\n\t\t\tto.down([msg]);\n\t\t\treturn true;\n\t\t}\n\n\t\t// Terminal types: always transition the bridge to terminal state\n\t\t// (return false → default dispatch). Only forward to `to` if allowed.\n\t\tif (type === COMPLETE || type === ERROR) {\n\t\t\tif (allowedDown.has(type)) {\n\t\t\t\tto.down([msg]);\n\t\t\t}\n\t\t\treturn false;\n\t\t}\n\n\t\t// Known type, not in allowedDown — consume without forwarding.\n\t\tif (!allowedDown.has(type)) {\n\t\t\treturn true;\n\t\t}\n\n\t\t// Forward the message to the target.\n\t\tto.down([msg]);\n\t\treturn true;\n\t};\n\n\treturn node([from as Node], undefined, {\n\t\tname: opts?.name,\n\t\tdescribeKind: \"effect\",\n\t\tonMessage,\n\t\tmeta: { _internal: true },\n\t});\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC2DO,IAAM,eAAkC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD;AAMA,IAAM,iBAAiB,oBAAI,IAAY;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,CAAC;AAkCM,SAAS,OAAoB,MAAe,IAAU,MAAqC;AACjG,QAAM,cAAc,IAAI,IAAI,MAAM,QAAQ,YAAY;AAEtD,QAAM,YAA8B,CACnC,KACA,WACA,aACa;AACb,UAAM,OAAO,IAAI,CAAC;AAGlB,QAAI,CAAC,eAAe,IAAI,IAAI,GAAG;AAC9B,SAAG,KAAK,CAAC,GAAG,CAAC;AACb,aAAO;AAAA,IACR;AAIA,QAAI,SAAS,YAAY,SAAS,OAAO;AACxC,UAAI,YAAY,IAAI,IAAI,GAAG;AAC1B,WAAG,KAAK,CAAC,GAAG,CAAC;AAAA,MACd;AACA,aAAO;AAAA,IACR;AAGA,QAAI,CAAC,YAAY,IAAI,IAAI,GAAG;AAC3B,aAAO;AAAA,IACR;AAGA,OAAG,KAAK,CAAC,GAAG,CAAC;AACb,WAAO;AAAA,EACR;AAEA,SAAO,KAAK,CAAC,IAAY,GAAG,QAAW;AAAA,IACtC,MAAM,MAAM;AAAA,IACZ,cAAc;AAAA,IACd;AAAA,IACA,MAAM,EAAE,WAAW,KAAK;AAAA,EACzB,CAAC;AACF;","names":[]}

package/dist/{chunk-2PORF4RP.js → chunk-BER7UYLM.js}

@@ -4,6 +4,7 @@ import {
   empty,
   escapeRegexChar,
   firstValueFrom,
+  firstWhere,
   forEach,
   fromAny,
   fromAsyncIter,
@@ -18,8 +19,6 @@ import {
   matchesAnyPattern,
   matchesCron,
   never,
-  observeGraph$,
-  observeNode$,
   of,
   parseCron,
   reactiveLog,
@@ -28,9 +27,8 @@ import {
   shareReplay,
   throwError,
   toArray,
-  toMessages$,
   toObservable
-} from "./chunk-646OG3PO.js";
+} from "./chunk-IRZAGZUB.js";
 import {
   ResettableTimer
 } from "./chunk-WZ2Z2CRV.js";
@@ -44,6 +42,7 @@ import {
   PAUSE,
   RESOLVED,
   RESUME,
+  START,
   TEARDOWN,
   __export,
   __require,
@@ -51,14 +50,14 @@ import {
   derived,
   dynamicNode,
   effect,
-  knownMessageTypes,
+  isLocalOnly,
   messageTier,
   monotonicNs,
   node,
   producer,
   state,
   wallClockNs
-} from "./chunk-BV3TPSBK.js";
+} from "./chunk-YXR3WW3Q.js";
 
 // src/extra/index.ts
 var extra_exports = {};
@@ -108,6 +107,7 @@ __export(extra_exports, {
   find: () => find,
   first: () => first,
   firstValueFrom: () => firstValueFrom,
+  firstWhere: () => firstWhere,
   flatMap: () => flatMap,
   forEach: () => forEach,
   fromAny: () => fromAny,
@@ -154,8 +154,6 @@ __export(extra_exports, {
   mergeMap: () => mergeMap,
   nameToSignal: () => nameToSignal,
   never: () => never,
-  observeGraph$: () => observeGraph$,
-  observeNode$: () => observeNode$,
   of: () => of,
   pairwise: () => pairwise,
   parseCron: () => parseCron,
@@ -187,7 +185,6 @@ __export(extra_exports, {
   shareReplay: () => shareReplay,
   signalToName: () => signalToName,
   skip: () => skip,
-  startWith: () => startWith,
   switchMap: () => switchMap,
   take: () => take,
   takeUntil: () => takeUntil,
@@ -204,7 +201,6 @@ __export(extra_exports, {
   toFile: () => toFile,
   toKafka: () => toKafka,
   toLoki: () => toLoki,
-  toMessages$: () => toMessages$,
   toMongo: () => toMongo,
   toNATS: () => toNATS,
   toObservable: () => toObservable,
@@ -1071,6 +1067,10 @@ function toSSE(source, opts) {
       unsub = source.subscribe((msgs) => {
         for (const msg of msgs) {
           const t = msg[0];
+          if (isLocalOnly(t)) {
+            if (t === DIRTY && includeDirty) {
+            } else continue;
+          }
           if (t === DATA) {
             write(dataEvent, serializeSseData(msg[1], serialize));
             continue;
@@ -1086,7 +1086,6 @@ function toSSE(source, opts) {
             return;
           }
           if (!includeResolved && t === RESOLVED) continue;
-          if (!includeDirty && t === DIRTY) continue;
           write(
             eventNameResolver(t),
             msg.length > 1 ? serializeSseData(msg[1], serialize) : void 0
@@ -3688,9 +3687,12 @@ function reduce(source, reducer, seed, opts) {
 }
 function take(source, count, opts) {
   if (count <= 0) {
+    let completed = false;
     return node(
       [source],
       (_d, a) => {
+        if (completed) return void 0;
+        completed = true;
         a.down([[COMPLETE]]);
         return void 0;
       },
@@ -3698,8 +3700,15 @@ function take(source, count, opts) {
         ...operatorOpts2(opts),
         completeWhenDepsComplete: false,
         onMessage(msg, _i, a) {
-          if (msg[0] === COMPLETE) {
+          if (msg[0] === START && !completed) {
+            completed = true;
+            a.down([[COMPLETE]]);
+            return true;
+          }
+          if (msg[0] === COMPLETE && !completed) {
+            completed = true;
             a.down([[COMPLETE]]);
+            return true;
           }
           return true;
         }
@@ -3881,21 +3890,6 @@ function find(source, predicate, opts) {
 function elementAt(source, index, opts) {
   return take(skip(source, index, opts), 1, opts);
 }
-function startWith(source, initial, opts) {
-  let prepended = false;
-  return node(
-    [source],
-    ([v], a) => {
-      if (!prepended) {
-        prepended = true;
-        a.emit(initial);
-      }
-      a.emit(v);
-      return void 0;
-    },
-    operatorOpts2(opts)
-  );
-}
 function tap(source, fnOrObserver, opts) {
   if (typeof fnOrObserver === "function") {
     return derived(
@@ -4231,6 +4225,7 @@ function forwardInner(inner, a, onInnerComplete) {
     let sawError = false;
     const out = [];
     for (const m of msgs) {
+      if (messageTier(m[0]) < 1) continue;
       if (m[0] === DATA) emitted = true;
       if (m[0] === COMPLETE) sawComplete = true;
       else {
@@ -4715,7 +4710,7 @@ function sample(source, notifier, opts) {
       if (terminated) return true;
       const t = msg[0];
       const tier = messageTier(t);
-      if (tier >= 3) {
+      if (tier >= 4) {
         if (t === ERROR) {
           terminated = true;
           a.down([msg]);
@@ -4731,6 +4726,7 @@ function sample(source, notifier, opts) {
           a.down([msg]);
           return true;
         }
+        terminated = true;
         a.down([msg]);
         return true;
       }
@@ -5903,7 +5899,7 @@ function workerBridge(target, opts) {
       for (const m of msgs) {
         const type = m[0];
         if (type === DATA) continue;
-        if (knownMessageTypes.includes(type) && messageTier(type) < 2) continue;
+        if (isLocalOnly(type)) continue;
         if (type === ERROR) {
           transport.post({
             t: "e",
@@ -6029,7 +6025,7 @@ function workerSelf(target, opts) {
       for (const m of msgs) {
         const type = m[0];
         if (type === DATA) continue;
-        if (knownMessageTypes.includes(type) && messageTier(type) < 2) continue;
+        if (isLocalOnly(type)) continue;
         if (type === ERROR) {
           transport.post({
             t: "e",
@@ -6217,7 +6213,6 @@ export {
   last,
   find,
   elementAt,
-  startWith,
   tap,
   distinctUntilChanged,
   pairwise,
@@ -6267,4 +6262,4 @@ export {
   workerSelf,
   extra_exports
 };
-//# sourceMappingURL=chunk-2PORF4RP.js.map
+//# sourceMappingURL=chunk-BER7UYLM.js.map