@graphrefly/graphrefly 0.6.0 → 0.8.0

package/dist/extra/index.cjs

@@ -27,11 +27,14 @@ __export(extra_exports, {
   NS_PER_MS: () => NS_PER_MS,
   NS_PER_SEC: () => NS_PER_SEC,
   SqliteCheckpointAdapter: () => SqliteCheckpointAdapter,
+  TimeoutError: () => TimeoutError,
   audit: () => audit,
   buffer: () => buffer,
   bufferCount: () => bufferCount,
   bufferTime: () => bufferTime,
+  cache: () => cache,
   cached: () => cached,
+  cascadingCache: () => cascadingCache,
   catchError: () => catchError,
   checkpointNodeValue: () => checkpointNodeValue,
   checkpointToRedis: () => checkpointToRedis,
@@ -56,6 +59,7 @@ __export(extra_exports, {
   escapeRegexChar: () => escapeRegexChar,
   exhaustMap: () => exhaustMap,
   exponential: () => exponential,
+  fallback: () => fallback,
   fibonacci: () => fibonacci,
   filter: () => filter,
   find: () => find,
@@ -68,6 +72,7 @@ __export(extra_exports, {
   fromCSV: () => fromCSV,
   fromClickHouseWatch: () => fromClickHouseWatch,
   fromCron: () => fromCron,
+  fromDrizzle: () => fromDrizzle,
   fromEvent: () => fromEvent,
   fromFSWatch: () => fromFSWatch,
   fromGitHook: () => fromGitHook,
@@ -76,10 +81,12 @@ __export(extra_exports, {
   fromIDBTransaction: () => fromIDBTransaction,
   fromIter: () => fromIter,
   fromKafka: () => fromKafka,
+  fromKysely: () => fromKysely,
   fromMCP: () => fromMCP,
   fromNATS: () => fromNATS,
   fromNDJSON: () => fromNDJSON,
   fromOTel: () => fromOTel,
+  fromPrisma: () => fromPrisma,
   fromPrometheus: () => fromPrometheus,
   fromPromise: () => fromPromise,
   fromPulsar: () => fromPulsar,
@@ -97,6 +104,7 @@ __export(extra_exports, {
   last: () => last,
   linear: () => linear,
   logSlice: () => logSlice,
+  lru: () => lru,
   map: () => map,
   matchesAnyPattern: () => matchesAnyPattern,
   matchesCron: () => matchesCron,
@@ -146,6 +154,7 @@ __export(extra_exports, {
   throttle: () => throttle,
   throttleTime: () => throttleTime,
   throwError: () => throwError,
+  tieredStorage: () => tieredStorage,
   timeout: () => timeout,
   toArray: () => toArray,
   toCSV: () => toCSV,
@@ -330,10 +339,14 @@ function partitionForBatch(messages) {
   }
   return { immediate, deferred, terminal };
 }
-function emitWithBatch(emit, messages, phase = 2) {
+function emitWithBatch(emit, messages, phase = 2, options) {
   if (messages.length === 0) {
     return;
   }
+  if (options?.strategy === "sequential") {
+    _emitSequential(emit, messages, phase);
+    return;
+  }
   const queue = phase === 3 ? pendingPhase3 : pendingPhase2;
   if (messages.length === 1) {
     const t = messages[0][0];
@@ -374,6 +387,29 @@ function emitWithBatch(emit, messages, phase = 2) {
     }
   }
 }
+function _emitSequential(emit, messages, phase = 2) {
+  const dataQueue = phase === 3 ? pendingPhase3 : pendingPhase2;
+  for (const msg of messages) {
+    const tier = messageTier(msg[0]);
+    if (tier === 2) {
+      if (isBatching()) {
+        const m = msg;
+        dataQueue.push(() => emit([m]));
+      } else {
+        emit([msg]);
+      }
+    } else if (tier >= 3) {
+      if (isBatching()) {
+        const m = msg;
+        pendingPhase3.push(() => emit([m]));
+      } else {
+        emit([msg]);
+      }
+    } else {
+      emit([msg]);
+    }
+  }
+}
 
 // src/core/clock.ts
 function monotonicNs() {
@@ -472,6 +508,7 @@ function advanceVersion(info, newValue, hashFn) {
 }
 
 // src/core/node.ts
+var NO_VALUE = /* @__PURE__ */ Symbol.for("graphrefly/NO_VALUE");
 function createIntBitSet() {
   let bits = 0;
   return {
@@ -601,10 +638,10 @@ var NodeImpl = class {
     this._hasDeps = deps.length > 0;
     this._autoComplete = opts.completeWhenDepsComplete ?? true;
     this._isSingleDep = deps.length === 1 && fn != null;
-    this._cached = opts.initial;
+    this._cached = "initial" in opts ? opts.initial : NO_VALUE;
     this._status = this._hasDeps ? "disconnected" : "settled";
     this._hashFn = opts.versioningHash ?? defaultHash;
-    this._versioning = opts.versioning != null ? createVersioning(opts.versioning, this._cached, {
+    this._versioning = opts.versioning != null ? createVersioning(opts.versioning, this._cached === NO_VALUE ? void 0 : this._cached, {
       id: opts.versioningId,
       hash: this._hashFn
     }) : void 0;
@@ -688,10 +725,14 @@ var NodeImpl = class {
   _applyVersioning(level, opts) {
     if (this._versioning != null) return;
     this._hashFn = opts?.hash ?? this._hashFn;
-    this._versioning = createVersioning(level, this._cached, {
-      id: opts?.id,
-      hash: this._hashFn
-    });
+    this._versioning = createVersioning(
+      level,
+      this._cached === NO_VALUE ? void 0 : this._cached,
+      {
+        id: opts?.id,
+        hash: this._hashFn
+      }
+    );
   }
   hasGuard() {
     return this._guard != null;
@@ -701,7 +742,7 @@ var NodeImpl = class {
     return this._guard(normalizeActor(actor), "observe");
   }
   get() {
-    return this._cached;
+    return this._cached === NO_VALUE ? void 0 : this._cached;
   }
   down(messages, options) {
     if (messages.length === 0) return;
@@ -758,6 +799,7 @@ var NodeImpl = class {
     }
     if (this._terminal && this._opts.resubscribable) {
       this._terminal = false;
+      this._cached = NO_VALUE;
       this._status = this._hasDeps ? "disconnected" : "settled";
       this._opts.onResubscribe?.();
     }
@@ -857,7 +899,7 @@ var NodeImpl = class {
         const cleanupFn = this._cleanup;
         this._cleanup = void 0;
         cleanupFn?.();
-        this._cached = void 0;
+        this._cached = NO_VALUE;
         this._lastDepValues = void 0;
       }
       this._status = statusAfterMessage(this._status, m);
@@ -866,7 +908,7 @@ var NodeImpl = class {
       }
       if (t === TEARDOWN) {
         if (this._opts.resetOnTeardown) {
-          this._cached = void 0;
+          this._cached = NO_VALUE;
         }
         const teardownCleanup = this._cleanup;
         this._cleanup = void 0;
@@ -897,7 +939,15 @@ var NodeImpl = class {
   }
   _emitAutoValue(value) {
     const wasDirty = this._status === "dirty";
-    const unchanged = this._equals(this._cached, value);
+    let unchanged;
+    try {
+      unchanged = this._cached !== NO_VALUE && this._equals(this._cached, value);
+    } catch (eqErr) {
+      const eqMsg = eqErr instanceof Error ? eqErr.message : String(eqErr);
+      const wrapped = new Error(`Node "${this.name}": equals threw: ${eqMsg}`, { cause: eqErr });
+      this._downInternal([[ERROR, wrapped]]);
+      return;
+    }
     if (unchanged) {
       this._downInternal(wasDirty ? [[RESOLVED]] : [[DIRTY], [RESOLVED]]);
       return;
@@ -944,7 +994,9 @@ var NodeImpl = class {
       if (out === void 0) return;
       this._emitAutoValue(out);
     } catch (err) {
-      this._downInternal([[ERROR, err]]);
+      const errMsg = err instanceof Error ? err.message : String(err);
+      const wrapped = new Error(`Node "${this.name}": fn threw: ${errMsg}`, { cause: err });
+      this._downInternal([[ERROR, wrapped]]);
     }
   }
   _onDepDirty(index) {
@@ -979,7 +1031,11 @@ var NodeImpl = class {
         try {
           if (this._onMessage(msg, index, this._actions)) continue;
         } catch (err) {
-          this._downInternal([[ERROR, err]]);
+          const errMsg = err instanceof Error ? err.message : String(err);
+          const wrapped = new Error(`Node "${this.name}": onMessage threw: ${errMsg}`, {
+            cause: err
+          });
+          this._downInternal([[ERROR, wrapped]]);
           return;
         }
       }
@@ -1194,6 +1250,34 @@ function resolveBackoffPreset(name) {
   );
 }
 
+// src/core/timer.ts
+var ResettableTimer = class {
+  _timer;
+  _gen = 0;
+  /** Schedule callback after delayMs. Cancels any pending timer. */
+  start(delayMs, callback) {
+    this.cancel();
+    this._gen += 1;
+    const gen = this._gen;
+    this._timer = setTimeout(() => {
+      this._timer = void 0;
+      if (gen !== this._gen) return;
+      callback();
+    }, delayMs);
+  }
+  /** Cancel the pending timer (if any). */
+  cancel() {
+    if (this._timer !== void 0) {
+      clearTimeout(this._timer);
+      this._timer = void 0;
+    }
+  }
+  /** Whether a timer is currently pending. */
+  get pending() {
+    return this._timer !== void 0;
+  }
+};
+
 // src/extra/resilience.ts
 function operatorOpts(opts) {
   return { describeKind: "operator", ...opts };
@@ -1223,14 +1307,7 @@ function retry(source, opts) {
       let stopped = false;
       let prevDelay = null;
       let unsub;
-      let timer;
-      let timerGen = 0;
-      function cancelTimer() {
-        if (timer !== void 0) {
-          clearTimeout(timer);
-          timer = void 0;
-        }
-      }
+      const timer = new ResettableTimer();
       function disconnectUpstream() {
         unsub?.();
         unsub = void 0;
@@ -1246,20 +1323,18 @@ function retry(source, opts) {
         const delayNs = coerceDelayNs(raw === void 0 ? null : raw);
         prevDelay = delayNs;
         attempt += 1;
-        timerGen += 1;
-        const gen = timerGen;
         disconnectUpstream();
         const delayMs = delayNs > 0 ? delayNs / NS_PER_MS : 1;
-        timer = setTimeout(() => {
-          timer = void 0;
-          if (stopped || gen !== timerGen) return;
+        timer.start(delayMs, () => {
+          if (stopped) return;
           connect();
-        }, delayMs);
+        });
       }
       function connect() {
-        cancelTimer();
+        timer.cancel();
         disconnectUpstream();
         unsub = source.subscribe((msgs) => {
+          if (stopped) return;
           for (const m of msgs) {
             const t = m[0];
             if (t === DIRTY) a.down([[DIRTY]]);
@@ -1281,8 +1356,7 @@ function retry(source, opts) {
       connect();
       return () => {
         stopped = true;
-        timerGen += 1;
-        cancelTimer();
+        timer.cancel();
         disconnectUpstream();
       };
     },
@@ -1462,14 +1536,7 @@ function rateLimiter(source, maxEvents, windowNs) {
     (_d, a) => {
       const times = [];
       const pending = [];
-      let timer;
-      let timerGen = 0;
-      function cancelTimer() {
-        if (timer !== void 0) {
-          clearTimeout(timer);
-          timer = void 0;
-        }
-      }
+      const timer = new ResettableTimer();
       function prune(now) {
         const boundary = now - windowNs;
         while (times.length > 0 && times[0] <= boundary) times.shift();
@@ -1483,15 +1550,10 @@ function rateLimiter(source, maxEvents, windowNs) {
             a.emit(pending.shift());
           } else {
             const oldest = times[0];
-            cancelTimer();
-            timerGen += 1;
-            const gen = timerGen;
             const delayNs = Math.max(0, oldest + windowNs - monotonicNs());
-            timer = setTimeout(() => {
-              timer = void 0;
-              if (gen !== timerGen) return;
+            timer.start(delayNs / NS_PER_MS, () => {
               tryEmit();
-            }, delayNs / NS_PER_MS);
+            });
             return;
           }
         }
@@ -1505,14 +1567,12 @@ function rateLimiter(source, maxEvents, windowNs) {
             tryEmit();
           } else if (t === RESOLVED) a.down([[RESOLVED]]);
           else if (t === COMPLETE) {
-            timerGen += 1;
-            cancelTimer();
+            timer.cancel();
             pending.length = 0;
             times.length = 0;
             a.down([[COMPLETE]]);
           } else if (t === ERROR) {
-            timerGen += 1;
-            cancelTimer();
+            timer.cancel();
             pending.length = 0;
             times.length = 0;
             a.down([m]);
@@ -1520,8 +1580,7 @@ function rateLimiter(source, maxEvents, windowNs) {
         }
       });
       return () => {
-        timerGen += 1;
-        cancelTimer();
+        timer.cancel();
         unsub();
       };
     },
@@ -1582,6 +1641,147 @@ function withStatus(src, options) {
     error: out.meta.error
   };
 }
+var TimeoutError = class extends Error {
+  name = "TimeoutError";
+  constructor(ns) {
+    super(`Timed out after ${ns / NS_PER_MS}ms`);
+  }
+};
+function isNode(x) {
+  return x != null && typeof x.subscribe === "function" && typeof x.get === "function";
+}
+function fallback(source, fb) {
+  return producer(
+    (_d, a) => {
+      let fallbackUnsub;
+      let sourceUnsub;
+      sourceUnsub = source.subscribe((msgs) => {
+        for (const m of msgs) {
+          const t = m[0];
+          if (t === DIRTY) a.down([[DIRTY]]);
+          else if (t === DATA) a.emit(m[1]);
+          else if (t === RESOLVED) a.down([[RESOLVED]]);
+          else if (t === COMPLETE) a.down([[COMPLETE]]);
+          else if (t === ERROR) {
+            sourceUnsub?.();
+            if (isNode(fb)) {
+              fallbackUnsub = fb.subscribe((fMsgs) => {
+                a.down(fMsgs);
+              });
+              const cur = fb.get();
+              if (cur !== void 0) a.down([[DATA, cur]]);
+            } else {
+              a.emit(fb);
+              a.down([[COMPLETE]]);
+            }
+            return;
+          } else if (t === TEARDOWN) {
+            fallbackUnsub?.();
+            a.down([m]);
+            return;
+          } else a.down([m]);
+        }
+      });
+      return () => {
+        sourceUnsub?.();
+        fallbackUnsub?.();
+      };
+    },
+    {
+      ...operatorOpts(),
+      initial: source.get()
+    }
+  );
+}
+function timeout(source, timeoutNs) {
+  if (timeoutNs <= 0) throw new RangeError("timeoutNs must be > 0");
+  return producer(
+    (_d, a) => {
+      let stopped = false;
+      const timer = new ResettableTimer();
+      function startTimer() {
+        const delayMs = timeoutNs / NS_PER_MS;
+        timer.start(delayMs, () => {
+          if (stopped) return;
+          stopped = true;
+          unsub();
+          a.down([[ERROR, new TimeoutError(timeoutNs)]]);
+        });
+      }
+      const unsub = source.subscribe((msgs) => {
+        for (const m of msgs) {
+          if (stopped) return;
+          const t = m[0];
+          if (t === DIRTY) a.down([[DIRTY]]);
+          else if (t === DATA) {
+            startTimer();
+            a.emit(m[1]);
+          } else if (t === RESOLVED) a.down([[RESOLVED]]);
+          else if (t === COMPLETE) {
+            timer.cancel();
+            stopped = true;
+            a.down([[COMPLETE]]);
+            return;
+          } else if (t === ERROR) {
+            timer.cancel();
+            stopped = true;
+            a.down([m]);
+            return;
+          } else if (t === TEARDOWN) {
+            timer.cancel();
+            stopped = true;
+            a.down([m]);
+            return;
+          } else a.down([m]);
+        }
+      });
+      startTimer();
+      return () => {
+        stopped = true;
+        timer.cancel();
+        unsub();
+      };
+    },
+    {
+      ...operatorOpts(),
+      initial: source.get()
+    }
+  );
+}
+function cache(source, ttlNs) {
+  if (ttlNs <= 0) throw new RangeError("ttlNs must be > 0");
+  let cachedValue;
+  let cachedAt = 0;
+  let hasCached = false;
+  return producer(
+    (_d, a) => {
+      if (hasCached && monotonicNs() - cachedAt < ttlNs) {
+        a.down([[DATA, cachedValue]]);
+      }
+      const unsub = source.subscribe((msgs) => {
+        for (const m of msgs) {
+          const t = m[0];
+          if (t === DATA) {
+            cachedValue = m[1];
+            cachedAt = monotonicNs();
+            hasCached = true;
+            a.emit(cachedValue);
+          } else if (t === DIRTY) a.down([[DIRTY]]);
+          else if (t === RESOLVED) a.down([[RESOLVED]]);
+          else if (t === COMPLETE) a.down([[COMPLETE]]);
+          else if (t === ERROR) a.down([m]);
+          else a.down([m]);
+        }
+      });
+      return unsub;
+    },
+    {
+      ...operatorOpts(),
+      resubscribable: true,
+      initial: source.get()
+    }
+  );
+}
 
 // src/extra/sources.ts
 var import_node_fs = require("fs");
@@ -1939,11 +2139,11 @@ function fromAsyncIter(iterable, opts) {
     };
   }, sourceOpts(rest));
 }
-function isNode(x) {
+function isNode2(x) {
   return x != null && typeof x.subscribe === "function" && typeof x.get === "function";
 }
 function fromAny(input, opts) {
-  if (isNode(input)) {
+  if (isNode2(input)) {
     return input;
   }
   if (isThenable(input)) {
@@ -2075,6 +2275,17 @@ function firstValueFrom(source) {
 var shareReplay = replay;
 
 // src/extra/adapters.ts
+function createSinkErrorHandler(userHandler) {
+  const errorsNode = state(null);
+  const handler = (err) => {
+    userHandler?.(err);
+    try {
+      errorsNode.down([[DATA, err]]);
+    } catch {
+    }
+  };
+  return { errorsNode, handler };
+}
 function sourceOpts2(opts) {
   return { describeKind: "producer", ...opts };
 }
@@ -2825,6 +3036,7 @@ function toKafka(source, kafkaProducer, topic, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -2836,7 +3048,7 @@ function toKafka(source, kafkaProducer, topic, opts) {
         try {
           serialized = serialize(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -2847,7 +3059,7 @@ function toKafka(source, kafkaProducer, topic, opts) {
           topic,
           messages: [{ key, value: Buffer.from(serialized) }]
         }).catch((err) => {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -2858,8 +3070,15 @@ function toKafka(source, kafkaProducer, topic, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function fromRedisStream(client, key, opts) {
   const {
@@ -2924,6 +3143,7 @@ function toRedisStream(source, client, key, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -2934,7 +3154,7 @@ function toRedisStream(source, client, key, opts) {
         try {
           fields = serialize(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -2943,7 +3163,7 @@ function toRedisStream(source, client, key, opts) {
         }
         const send = maxLen !== void 0 ? client.xadd(key, "MAXLEN", "~", String(maxLen), "*", ...fields) : client.xadd(key, "*", ...fields);
         void send.catch((err) => {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -2954,8 +3174,15 @@ function toRedisStream(source, client, key, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function fromCSV(source, opts) {
   const {
@@ -3182,6 +3409,7 @@ function toPulsar(source, pulsarProducer, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -3192,7 +3420,7 @@ function toPulsar(source, pulsarProducer, opts) {
         try {
           data = serialize(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3204,7 +3432,7 @@ function toPulsar(source, pulsarProducer, opts) {
           partitionKey: keyExtractor?.(value),
           properties: propertiesExtractor?.(value)
         }).catch((err) => {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3215,8 +3443,15 @@ function toPulsar(source, pulsarProducer, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function fromNATS(client, subject, opts) {
   const decoder = new TextDecoder();
@@ -3272,6 +3507,7 @@ function toNATS(source, client, subject, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -3282,7 +3518,7 @@ function toNATS(source, client, subject, opts) {
         try {
           data = serialize(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3292,7 +3528,7 @@ function toNATS(source, client, subject, opts) {
         try {
           client.publish(subject, data);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3303,8 +3539,15 @@ function toNATS(source, client, subject, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function fromRabbitMQ(channel, queue, opts) {
   const {
@@ -3366,6 +3609,7 @@ function toRabbitMQ(source, channel, exchange, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -3376,7 +3620,7 @@ function toRabbitMQ(source, channel, exchange, opts) {
         try {
           routingKey = routingKeyExtractor(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "routing_key",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3387,7 +3631,7 @@ function toRabbitMQ(source, channel, exchange, opts) {
         try {
           content = serialize(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3397,7 +3641,7 @@ function toRabbitMQ(source, channel, exchange, opts) {
         try {
           channel.publish(exchange, routingKey, content);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3408,8 +3652,15 @@ function toRabbitMQ(source, channel, exchange, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function toFile(source, writer, opts) {
   const {
@@ -3421,8 +3672,10 @@ function toFile(source, writer, opts) {
     mode: _mode,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   let buffer2 = [];
   let timer;
+  let disposed = false;
   const doFlush = () => {
     if (buffer2.length === 0) return;
     const chunk = buffer2.join("");
@@ -3430,7 +3683,7 @@ function toFile(source, writer, opts) {
     try {
       writer.write(chunk);
     } catch (err) {
-      onTransportError?.({
+      handler({
         stage: "send",
         error: err instanceof Error ? err : new Error(String(err)),
         value: chunk
@@ -3438,7 +3691,7 @@ function toFile(source, writer, opts) {
     }
   };
   const scheduleFlush = () => {
-    if (flushIntervalMs > 0 && timer === void 0) {
+    if (flushIntervalMs > 0 && timer === void 0 && !disposed) {
       timer = setTimeout(() => {
         timer = void 0;
         doFlush();
@@ -3456,7 +3709,7 @@ function toFile(source, writer, opts) {
         try {
           line = serialize(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3471,7 +3724,7 @@ function toFile(source, writer, opts) {
           try {
             writer.write(line);
           } catch (err) {
-            onTransportError?.({
+            handler({
               stage: "send",
               error: err instanceof Error ? err : new Error(String(err)),
               value
@@ -3480,7 +3733,7 @@ function toFile(source, writer, opts) {
         }
         return true;
       }
-      if (msg[0] === COMPLETE || msg[0] === TEARDOWN) {
+      if (messageTier(msg[0]) >= 3) {
         doFlush();
       }
       return false;
@@ -3489,18 +3742,25 @@ function toFile(source, writer, opts) {
   const unsub = inner.subscribe(() => {
   });
   const dispose = () => {
+    if (disposed) return;
+    disposed = true;
     if (timer !== void 0) {
       clearTimeout(timer);
       timer = void 0;
     }
     doFlush();
-    writer.end();
+    try {
+      writer.end();
+    } catch {
+    }
     unsub();
+    errorsNode.down([[TEARDOWN]]);
   };
   return {
     dispose,
+    errors: errorsNode,
     flush: async () => {
-      doFlush();
+      if (!disposed) doFlush();
     }
   };
 }
@@ -3551,25 +3811,29 @@ function toClickHouse(source, client, table, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   let buffer2 = [];
   let timer;
-  let lastFlush = Promise.resolve();
+  let disposed = false;
+  const inFlight = /* @__PURE__ */ new Set();
   const doFlush = () => {
     if (buffer2.length === 0) return Promise.resolve();
     const batch2 = buffer2;
     buffer2 = [];
     try {
       const p = client.insert({ table, values: batch2, format }).catch((err) => {
-        onTransportError?.({
+        handler({
           stage: "send",
           error: err instanceof Error ? err : new Error(String(err)),
           value: batch2
         });
+      }).finally(() => {
+        inFlight.delete(p);
       });
-      lastFlush = p;
+      inFlight.add(p);
       return p;
     } catch (err) {
-      onTransportError?.({
+      handler({
         stage: "send",
         error: err instanceof Error ? err : new Error(String(err)),
         value: batch2
@@ -3578,7 +3842,7 @@ function toClickHouse(source, client, table, opts) {
     }
   };
   const scheduleFlush = () => {
-    if (timer === void 0) {
+    if (timer === void 0 && !disposed) {
       timer = setTimeout(() => {
         timer = void 0;
         doFlush();
@@ -3594,7 +3858,7 @@ function toClickHouse(source, client, table, opts) {
         try {
           buffer2.push(transform(value));
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3605,7 +3869,7 @@ function toClickHouse(source, client, table, opts) {
         else scheduleFlush();
         return true;
       }
-      if (msg[0] === COMPLETE || msg[0] === TEARDOWN) {
+      if (messageTier(msg[0]) >= 3) {
         doFlush();
       }
       return false;
@@ -3614,16 +3878,24 @@ function toClickHouse(source, client, table, opts) {
   const unsub = inner.subscribe(() => {
   });
   const dispose = () => {
+    if (disposed) return;
+    disposed = true;
     if (timer !== void 0) {
       clearTimeout(timer);
       timer = void 0;
     }
     doFlush();
     unsub();
+    errorsNode.down([[TEARDOWN]]);
   };
   return {
     dispose,
-    flush: () => doFlush().then(() => lastFlush)
+    errors: errorsNode,
+    flush: () => {
+      const p = disposed ? Promise.resolve() : doFlush();
+      return p.then(() => Promise.all(inFlight)).then(() => {
+      });
+    }
   };
 }
 function toS3(source, client, bucket, opts) {
@@ -3640,10 +3912,12 @@ function toS3(source, client, bucket, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   let buffer2 = [];
   let timer;
   let seq = 0;
-  let lastFlush = Promise.resolve();
+  let disposed = false;
+  const inFlight = /* @__PURE__ */ new Set();
   const doFlush = () => {
     if (buffer2.length === 0) return Promise.resolve();
     const batch2 = buffer2;
@@ -3656,16 +3930,18 @@ function toS3(source, client, bucket, opts) {
     try {
       const p = client.putObject({ Bucket: bucket, Key: key, Body: body, ContentType: contentType }).then(() => {
       }).catch((err) => {
-        onTransportError?.({
+        handler({
           stage: "send",
           error: err instanceof Error ? err : new Error(String(err)),
           value: batch2
         });
+      }).finally(() => {
+        inFlight.delete(p);
       });
-      lastFlush = p;
+      inFlight.add(p);
       return p;
     } catch (err) {
-      onTransportError?.({
+      handler({
         stage: "send",
         error: err instanceof Error ? err : new Error(String(err)),
         value: batch2
@@ -3674,7 +3950,7 @@ function toS3(source, client, bucket, opts) {
     }
   };
   const scheduleFlush = () => {
-    if (timer === void 0) {
+    if (timer === void 0 && !disposed) {
       timer = setTimeout(() => {
         timer = void 0;
         doFlush();
@@ -3690,7 +3966,7 @@ function toS3(source, client, bucket, opts) {
         try {
           buffer2.push(transform(value));
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3701,7 +3977,7 @@ function toS3(source, client, bucket, opts) {
         else scheduleFlush();
         return true;
       }
-      if (msg[0] === COMPLETE || msg[0] === TEARDOWN) {
+      if (messageTier(msg[0]) >= 3) {
         doFlush();
       }
       return false;
@@ -3710,16 +3986,24 @@ function toS3(source, client, bucket, opts) {
   const unsub = inner.subscribe(() => {
   });
   const dispose = () => {
+    if (disposed) return;
+    disposed = true;
     if (timer !== void 0) {
       clearTimeout(timer);
       timer = void 0;
     }
     doFlush();
     unsub();
+    errorsNode.down([[TEARDOWN]]);
   };
   return {
     dispose,
-    flush: () => doFlush().then(() => lastFlush)
+    errors: errorsNode,
+    flush: () => {
+      const p = disposed ? Promise.resolve() : doFlush();
+      return p.then(() => Promise.all(inFlight)).then(() => {
+      });
+    }
   };
 }
 function toPostgres(source, client, table, opts) {
@@ -3731,6 +4015,7 @@ function toPostgres(source, client, table, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -3741,7 +4026,7 @@ function toPostgres(source, client, table, opts) {
         try {
           query = toSQL(value, table);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3749,7 +4034,7 @@ function toPostgres(source, client, table, opts) {
           return true;
         }
         void client.query(query.sql, query.params).catch((err) => {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3760,11 +4045,19 @@ function toPostgres(source, client, table, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function toMongo(source, collection, opts) {
   const { toDocument = (v) => v, onTransportError, ...rest } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -3775,7 +4068,7 @@ function toMongo(source, collection, opts) {
         try {
           doc = toDocument(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3783,7 +4076,7 @@ function toMongo(source, collection, opts) {
           return true;
         }
         void collection.insertOne(doc).catch((err) => {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3794,8 +4087,15 @@ function toMongo(source, collection, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function toLoki(source, client, opts) {
   const {
@@ -3805,6 +4105,7 @@ function toLoki(source, client, opts) {
     onTransportError,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -3815,7 +4116,7 @@ function toLoki(source, client, opts) {
         try {
           line = toLine(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3826,7 +4127,7 @@ function toLoki(source, client, opts) {
         try {
           streamLabels = toLabels ? { ...labels, ...toLabels(value) } : labels;
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3835,7 +4136,7 @@ function toLoki(source, client, opts) {
         }
         const ts = `${wallClockNs()}`;
         void client.push({ streams: [{ stream: streamLabels, values: [[ts, line]] }] }).catch((err) => {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3846,11 +4147,19 @@ function toLoki(source, client, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function toTempo(source, client, opts) {
   const { toResourceSpans = (v) => [v], onTransportError, ...rest } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -3861,7 +4170,7 @@ function toTempo(source, client, opts) {
         try {
           spans = toResourceSpans(value);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3869,7 +4178,7 @@ function toTempo(source, client, opts) {
           return true;
         }
         void client.push({ resourceSpans: spans }).catch((err) => {
-          onTransportError?.({
+          handler({
             stage: "send",
             error: err instanceof Error ? err : new Error(String(err)),
             value
@@ -3880,15 +4189,22 @@ function toTempo(source, client, opts) {
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  return {
+    dispose: () => {
+      unsub();
+      errorsNode.down([[TEARDOWN]]);
+    },
+    errors: errorsNode
+  };
 }
 function checkpointToS3(graph, client, bucket, opts) {
   const { prefix = "checkpoints/", debounceMs, compactEvery, onError } = opts ?? {};
   const adapter = {
-    save(data) {
+    save(_key, data) {
       const ms = Math.floor(wallClockNs() / 1e6);
-      const key = `${prefix}${graph.name}/checkpoint-${ms}.json`;
+      const s3Key = `${prefix}${graph.name}/checkpoint-${ms}.json`;
       let body;
       try {
         body = JSON.stringify(data);
@@ -3898,7 +4214,7 @@ function checkpointToS3(graph, client, bucket, opts) {
       }
       void client.putObject({
         Bucket: bucket,
-        Key: key,
+        Key: s3Key,
         Body: body,
         ContentType: "application/json"
       }).catch((err) => onError?.(err));
@@ -3908,9 +4224,9 @@ function checkpointToS3(graph, client, bucket, opts) {
 }
 function checkpointToRedis(graph, client, opts) {
   const { prefix = "graphrefly:checkpoint:", debounceMs, compactEvery, onError } = opts ?? {};
-  const key = `${prefix}${graph.name}`;
+  const redisKey = `${prefix}${graph.name}`;
   const adapter = {
-    save(data) {
+    save(_key, data) {
       let body;
       try {
         body = JSON.stringify(data);
@@ -3918,7 +4234,7 @@ function checkpointToRedis(graph, client, opts) {
         onError?.(err);
         return;
       }
-      void client.set(key, body).catch((err) => onError?.(err));
+      void client.set(redisKey, body).catch((err) => onError?.(err));
     }
   };
   return graph.autoCheckpoint(adapter, { debounceMs, compactEvery, onError });
@@ -3956,8 +4272,67 @@ function toSqlite(source, db, table, opts) {
       params: [JSON.stringify(v)]
     }),
     onTransportError,
+    batchInsert = false,
+    maxBatchSize = 1e3,
+    flushIntervalMs = 0,
     ...rest
   } = opts ?? {};
+  const { errorsNode, handler } = createSinkErrorHandler(onTransportError);
+  const pendingInserts = [];
+  let flushing = false;
+  let disposed = false;
+  let timer;
+  function flushTransaction() {
+    if (pendingInserts.length === 0 || flushing) return;
+    flushing = true;
+    try {
+      db.query("BEGIN", []);
+    } catch (err) {
+      flushing = false;
+      handler({
+        stage: "send",
+        error: err instanceof Error ? err : new Error(String(err)),
+        value: void 0
+      });
+      return;
+    }
+    const batch2 = pendingInserts.splice(0);
+    let firstError;
+    for (const q of batch2) {
+      try {
+        db.query(q.sql, q.params);
+      } catch (err) {
+        firstError = err instanceof Error ? err : new Error(String(err));
+        break;
+      }
+    }
+    if (firstError) {
+      try {
+        db.query("ROLLBACK", []);
+      } catch {
+      }
+      handler({ stage: "send", error: firstError, value: void 0 });
+    } else {
+      try {
+        db.query("COMMIT", []);
+      } catch (err) {
+        handler({
+          stage: "send",
+          error: err instanceof Error ? err : new Error(String(err)),
+          value: void 0
+        });
+      }
+    }
+    flushing = false;
+  }
+  const scheduleFlush = () => {
+    if (batchInsert && flushIntervalMs > 0 && timer === void 0 && !disposed) {
+      timer = setTimeout(() => {
+        timer = void 0;
+        flushTransaction();
+      }, flushIntervalMs);
+    }
+  };
   const inner = node([source], () => void 0, {
     describeKind: "effect",
     ...rest,
@@ -3968,29 +4343,140 @@ function toSqlite(source, db, table, opts) {
         try {
           query = toSQL(value, table);
         } catch (err) {
-          onTransportError?.({
+          handler({
             stage: "serialize",
             error: err instanceof Error ? err : new Error(String(err)),
             value
           });
           return true;
         }
-        try {
-          db.query(query.sql, query.params);
-        } catch (err) {
-          onTransportError?.({
-            stage: "send",
-            error: err instanceof Error ? err : new Error(String(err)),
-            value
-          });
+        if (batchInsert) {
+          pendingInserts.push(query);
+          if (pendingInserts.length >= maxBatchSize) flushTransaction();
+          else scheduleFlush();
+        } else {
+          try {
+            db.query(query.sql, query.params);
+          } catch (err) {
+            handler({
+              stage: "send",
+              error: err instanceof Error ? err : new Error(String(err)),
+              value
+            });
+          }
         }
         return true;
       }
+      if (batchInsert && messageTier(msg[0]) >= 3) {
+        flushTransaction();
+      }
       return false;
     }
   });
-  return inner.subscribe(() => {
+  const unsub = inner.subscribe(() => {
   });
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    if (timer !== void 0) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    if (batchInsert) flushTransaction();
+    unsub();
+    errorsNode.down([[TEARDOWN]]);
+  };
+  return {
+    dispose,
+    errors: errorsNode,
+    flush: batchInsert ? async () => {
+      if (!disposed) flushTransaction();
+    } : void 0
+  };
+}
+function fromPrisma(model, opts) {
+  const { args, mapRow = (r) => r, ...rest } = opts ?? {};
+  return producer(
+    (_d, a) => {
+      let active = true;
+      void model.findMany(args).then((rows) => {
+        if (!active) return;
+        const mapped = rows.map(mapRow);
+        batch(() => {
+          for (const item of mapped) {
+            a.emit(item);
+          }
+        });
+        a.down([[COMPLETE]]);
+      }).catch((err) => {
+        if (!active) return;
+        try {
+          a.down([[ERROR, err instanceof Error ? err : new Error(String(err))]]);
+        } catch {
+        }
+      });
+      return () => {
+        active = false;
+      };
+    },
+    { ...rest, describeKind: "producer", completeWhenDepsComplete: false }
+  );
+}
+function fromDrizzle(query, opts) {
+  const { mapRow = (r) => r, ...rest } = opts ?? {};
+  return producer(
+    (_d, a) => {
+      let active = true;
+      void query.execute().then((rows) => {
+        if (!active) return;
+        const mapped = rows.map(mapRow);
+        batch(() => {
+          for (const item of mapped) {
+            a.emit(item);
+          }
+        });
+        a.down([[COMPLETE]]);
+      }).catch((err) => {
+        if (!active) return;
+        try {
+          a.down([[ERROR, err instanceof Error ? err : new Error(String(err))]]);
+        } catch {
+        }
+      });
+      return () => {
+        active = false;
+      };
+    },
+    { ...rest, describeKind: "producer", completeWhenDepsComplete: false }
+  );
+}
+function fromKysely(query, opts) {
+  const { mapRow = (r) => r, ...rest } = opts ?? {};
+  return producer(
+    (_d, a) => {
+      let active = true;
+      void query.execute().then((rows) => {
+        if (!active) return;
+        const mapped = rows.map(mapRow);
+        batch(() => {
+          for (const item of mapped) {
+            a.emit(item);
+          }
+        });
+        a.down([[COMPLETE]]);
+      }).catch((err) => {
+        if (!active) return;
+        try {
+          a.down([[ERROR, err instanceof Error ? err : new Error(String(err))]]);
+        } catch {
+        }
+      });
+      return () => {
+        active = false;
+      };
+    },
+    { ...rest, describeKind: "producer", completeWhenDepsComplete: false }
+  );
 }
 
 // src/extra/backpressure.ts
@@ -4037,6 +4523,205 @@ function createWatermarkController(sendUp, opts) {
   };
 }
 
+// src/extra/cascading-cache.ts
+function lru() {
+  const map2 = /* @__PURE__ */ new Map();
+  let head = null;
+  let tail = null;
+  function unlink(n) {
+    if (n.prev) n.prev.next = n.next;
+    else head = n.next;
+    if (n.next) n.next.prev = n.prev;
+    else tail = n.prev;
+    n.prev = null;
+    n.next = null;
+  }
+  function pushFront(n) {
+    n.next = head;
+    n.prev = null;
+    if (head) head.prev = n;
+    head = n;
+    if (tail === null) tail = n;
+  }
+  return {
+    insert(key) {
+      if (map2.has(key)) {
+        this.touch(key);
+        return;
+      }
+      const n = { key, prev: null, next: null };
+      map2.set(key, n);
+      pushFront(n);
+    },
+    touch(key) {
+      const n = map2.get(key);
+      if (!n) return;
+      unlink(n);
+      pushFront(n);
+    },
+    delete(key) {
+      const n = map2.get(key);
+      if (!n) return;
+      unlink(n);
+      map2.delete(key);
+    },
+    evict(count) {
+      const victims = [];
+      for (let i = 0; i < count && tail !== null; i++) {
+        const n = tail;
+        victims.push(n.key);
+        unlink(n);
+        map2.delete(n.key);
+      }
+      return victims;
+    },
+    size() {
+      return map2.size;
+    }
+  };
+}
+function cascadingCache(tiers, opts) {
+  const entries = /* @__PURE__ */ new Map();
+  const maxSize = opts?.maxSize ?? 0;
+  const policy = maxSize > 0 ? opts?.eviction ?? lru() : null;
+  const writeThrough = opts?.writeThrough ?? false;
+  function promote(key, value, hitTierIndex) {
+    for (let i = 0; i < hitTierIndex; i++) {
+      const tier = tiers[i];
+      if (tier.save) tier.save(key, value);
+    }
+  }
+  function cascade(key, nd) {
+    for (let tierIndex = 0; tierIndex < tiers.length; tierIndex++) {
+      let result;
+      try {
+        result = tiers[tierIndex].load(key);
+      } catch {
+        continue;
+      }
+      if (result != null) {
+        nd.down([[DATA, result]]);
+        promote(key, result, tierIndex);
+        return;
+      }
+    }
+  }
+  function evictIfNeeded() {
+    if (!policy || maxSize <= 0) return;
+    while (policy.size() >= maxSize) {
+      const victims = policy.evict(1);
+      if (victims.length === 0) break;
+      for (const key of victims) {
+        const nd = entries.get(key);
+        if (nd) {
+          const value = nd.get();
+          if (value !== void 0) {
+            for (let i = tiers.length - 1; i >= 0; i--) {
+              if (tiers[i].save) {
+                tiers[i].save(key, value);
+                for (let j = 0; j < i; j++) {
+                  if (tiers[j].clear) tiers[j].clear(key);
+                }
+                break;
+              }
+            }
+          }
+          nd.down([[TEARDOWN]]);
+        }
+        entries.delete(key);
+      }
+    }
+  }
+  return {
+    load(key) {
+      const existing = entries.get(key);
+      if (existing) {
+        policy?.touch(key);
+        return existing;
+      }
+      if (policy && maxSize > 0 && policy.size() >= maxSize) {
+        evictIfNeeded();
+      }
+      const nd = state(void 0);
+      entries.set(key, nd);
+      if (policy) {
+        policy.insert(key);
+      }
+      cascade(key, nd);
+      return nd;
+    },
+    save(key, value) {
+      if (writeThrough) {
+        for (const tier of tiers) {
+          if (tier.save) tier.save(key, value);
+        }
+      } else if (tiers[0]?.save) {
+        tiers[0].save(key, value);
+      }
+      const existing = entries.get(key);
+      if (existing) {
+        existing.down([[DATA, value]]);
+        policy?.touch(key);
+      } else {
+        if (policy && maxSize > 0 && policy.size() >= maxSize) {
+          evictIfNeeded();
+        }
+        const nd = state(value);
+        entries.set(key, nd);
+        if (policy) {
+          policy.insert(key);
+        }
+      }
+    },
+    invalidate(key) {
+      const existing = entries.get(key);
+      if (existing) {
+        cascade(key, existing);
+      }
+    },
+    delete(key) {
+      policy?.delete(key);
+      const nd = entries.get(key);
+      if (nd) nd.down([[TEARDOWN]]);
+      entries.delete(key);
+      for (const tier of tiers) {
+        if (tier.clear) tier.clear(key);
+      }
+    },
+    has(key) {
+      return entries.has(key);
+    },
+    get size() {
+      return entries.size;
+    }
+  };
+}
+function adapterToTier(adapter) {
+  return {
+    load: (key) => adapter.load(key),
+    save: (key, value) => adapter.save(key, value),
+    clear: (key) => adapter.clear(key)
+  };
+}
+function tieredStorage(adapters, opts) {
+  const inner = cascadingCache(adapters.map(adapterToTier), {
+    maxSize: opts?.maxSize,
+    eviction: opts?.eviction,
+    writeThrough: true
+  });
+  return {
+    load: (key) => inner.load(key),
+    save: (key, value) => inner.save(key, value),
+    invalidate: (key) => inner.invalidate(key),
+    delete: (key) => inner.delete(key),
+    has: (key) => inner.has(key),
+    get size() {
+      return inner.size;
+    },
+    cache: inner
+  };
+}
+
 // src/extra/checkpoint.ts
 var import_node_crypto2 = require("crypto");
 var import_node_fs2 = require("fs");
@@ -4057,60 +4742,61 @@ function sortJsonValue(value) {
   }
   return out;
 }
-function warnNonJsonValues(data) {
-  for (const [path, node2] of Object.entries(data.nodes)) {
-    const v = node2.value;
-    if (v === void 0 || v === null) continue;
-    if (typeof v === "function" || typeof v === "symbol" || typeof v === "bigint") {
-      console.warn(
-        `checkpoint: node "${path}" has non-JSON-serializable value (${typeof v}); it will be lost on round-trip`
-      );
-    }
-  }
-}
-function stableSnapshotJson(data) {
-  warnNonJsonValues(data);
+function stableJsonString(data) {
   return `${JSON.stringify(sortJsonValue(data), void 0, 0)}
 `;
 }
 var MemoryCheckpointAdapter = class {
-  #data = null;
-  save(data) {
-    this.#data = JSON.parse(JSON.stringify(data));
+  #data = /* @__PURE__ */ new Map();
+  save(key, data) {
+    this.#data.set(key, JSON.parse(JSON.stringify(data)));
+  }
+  load(key) {
+    const v = this.#data.get(key);
+    return v === void 0 ? null : JSON.parse(JSON.stringify(v));
   }
-  load() {
-    return this.#data === null ? null : JSON.parse(JSON.stringify(this.#data));
+  clear(key) {
+    this.#data.delete(key);
   }
 };
 var DictCheckpointAdapter = class {
   #storage;
-  #key;
-  constructor(storage, key = "graphrefly_checkpoint") {
+  constructor(storage) {
     this.#storage = storage;
-    this.#key = key;
   }
-  save(data) {
-    this.#storage[this.#key] = JSON.parse(JSON.stringify(data));
+  save(key, data) {
+    this.#storage[key] = JSON.parse(JSON.stringify(data));
+  }
+  load(key) {
+    const raw = this.#storage[key];
+    return raw === void 0 ? null : JSON.parse(JSON.stringify(raw));
   }
-  load() {
-    const raw = this.#storage[this.#key];
-    return raw !== null && typeof raw === "object" && !Array.isArray(raw) ? JSON.parse(JSON.stringify(raw)) : null;
+  clear(key) {
+    delete this.#storage[key];
   }
 };
 var FileCheckpointAdapter = class {
-  #path;
-  constructor(path) {
-    this.#path = path;
-  }
-  save(data) {
-    const dir = (0, import_node_path2.dirname)(this.#path);
-    (0, import_node_fs2.mkdirSync)(dir, { recursive: true });
-    const payload = stableSnapshotJson(data);
-    const base = (0, import_node_path2.basename)(this.#path);
+  #dir;
+  constructor(dir) {
+    this.#dir = dir;
+  }
+  #pathFor(key) {
+    const safeName = key.replace(
+      /[^a-zA-Z0-9_-]/g,
+      (c) => `%${c.charCodeAt(0).toString(16).padStart(2, "0")}`
+    );
+    return (0, import_node_path2.join)(this.#dir, `${safeName}.json`);
+  }
+  save(key, data) {
+    (0, import_node_fs2.mkdirSync)(this.#dir, { recursive: true });
+    const filePath = this.#pathFor(key);
+    const payload = stableJsonString(data);
+    const base = (0, import_node_path2.basename)(filePath);
+    const dir = (0, import_node_path2.dirname)(filePath);
     const tmp = (0, import_node_path2.join)(dir, `.${base}.${(0, import_node_crypto2.randomBytes)(8).toString("hex")}.tmp`);
     try {
       (0, import_node_fs2.writeFileSync)(tmp, payload, "utf8");
-      (0, import_node_fs2.renameSync)(tmp, this.#path);
+      (0, import_node_fs2.renameSync)(tmp, filePath);
     } catch (e) {
       try {
         (0, import_node_fs2.unlinkSync)(tmp);
@@ -4119,36 +4805,42 @@ var FileCheckpointAdapter = class {
       throw e;
     }
   }
-  load() {
+  load(key) {
     try {
-      const text = (0, import_node_fs2.readFileSync)(this.#path, "utf8").trim();
+      const text = (0, import_node_fs2.readFileSync)(this.#pathFor(key), "utf8").trim();
       if (!text) return null;
-      const data = JSON.parse(text);
-      return data !== null && typeof data === "object" && !Array.isArray(data) ? data : null;
+      return JSON.parse(text);
     } catch {
       return null;
     }
   }
+  clear(key) {
+    try {
+      (0, import_node_fs2.unlinkSync)(this.#pathFor(key));
+    } catch (e) {
+      if (e.code !== "ENOENT") throw e;
+    }
+  }
 };
 var SqliteCheckpointAdapter = class {
   #db;
-  #key;
-  constructor(path, key = "graphrefly_checkpoint") {
+  constructor(path) {
     this.#db = new import_node_sqlite.DatabaseSync(path);
-    this.#key = key;
     this.#db.exec(
       `CREATE TABLE IF NOT EXISTS graphrefly_checkpoint (k TEXT PRIMARY KEY, v TEXT NOT NULL)`
     );
   }
-  save(data) {
-    const payload = stableSnapshotJson(data).trimEnd();
-    this.#db.prepare(`INSERT OR REPLACE INTO graphrefly_checkpoint (k, v) VALUES (?, ?)`).run(this.#key, payload);
+  save(key, data) {
+    const payload = stableJsonString(data).trimEnd();
+    this.#db.prepare(`INSERT OR REPLACE INTO graphrefly_checkpoint (k, v) VALUES (?, ?)`).run(key, payload);
   }
-  load() {
-    const row = this.#db.prepare(`SELECT v FROM graphrefly_checkpoint WHERE k = ?`).get(this.#key);
+  load(key) {
+    const row = this.#db.prepare(`SELECT v FROM graphrefly_checkpoint WHERE k = ?`).get(key);
     if (row === void 0 || typeof row.v !== "string" || row.v.trim() === "") return null;
-    const parsed = JSON.parse(row.v);
-    return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+    return JSON.parse(row.v);
+  }
+  clear(key) {
+    this.#db.prepare(`DELETE FROM graphrefly_checkpoint WHERE k = ?`).run(key);
   }
   /** Close the underlying SQLite connection (safe to call more than once). */
   close() {
@@ -4159,10 +4851,10 @@ var SqliteCheckpointAdapter = class {
   }
 };
 function saveGraphCheckpoint(graph, adapter) {
-  adapter.save(graph.snapshot());
+  adapter.save(graph.name, graph.snapshot());
 }
 function restoreGraphCheckpoint(graph, adapter) {
-  const data = adapter.load();
+  const data = adapter.load(graph.name);
   if (data === null) return false;
   graph.restore(data);
   return true;
@@ -4451,7 +5143,7 @@ var DynamicNodeImpl = class {
   _actions;
   _boundEmitToSinks;
   // Mutable state
-  _cached;
+  _cached = NO_VALUE;
   _status = "disconnected";
   _terminal = false;
   _connected = false;
@@ -4545,7 +5237,7 @@ var DynamicNodeImpl = class {
     return this._guard(normalizeActor(actor), "observe");
   }
   get() {
-    return this._cached;
+    return this._cached === NO_VALUE ? void 0 : this._cached;
   }
   down(messages, options) {
     if (messages.length === 0) return;
@@ -4603,6 +5295,7 @@ var DynamicNodeImpl = class {
     }
     if (this._terminal && this._resubscribable) {
       this._terminal = false;
+      this._cached = NO_VALUE;
       this._status = "disconnected";
       this._onResubscribe?.();
     }
@@ -4680,10 +5373,13 @@ var DynamicNodeImpl = class {
       const t = m[0];
       if (t === DATA) this._cached = m[1];
       if (t === INVALIDATE) {
-        this._cached = void 0;
+        this._cached = NO_VALUE;
+        this._status = "dirty";
       }
-      if (t === DATA || t === RESOLVED) {
+      if (t === DATA) {
         this._status = "settled";
+      } else if (t === RESOLVED) {
+        this._status = "resolved";
       } else if (t === DIRTY) {
         this._status = "dirty";
       } else if (t === COMPLETE) {
@@ -4694,7 +5390,7 @@ var DynamicNodeImpl = class {
         this._terminal = true;
       }
       if (t === TEARDOWN) {
-        if (this._resetOnTeardown) this._cached = void 0;
+        if (this._resetOnTeardown) this._cached = NO_VALUE;
         try {
           this._propagateToMeta(t);
         } finally {
@@ -4717,7 +5413,15 @@ var DynamicNodeImpl = class {
   }
   _emitAutoValue(value) {
     const wasDirty = this._status === "dirty";
-    const unchanged = this._equals(this._cached, value);
+    let unchanged;
+    try {
+      unchanged = this._cached !== NO_VALUE && this._equals(this._cached, value);
+    } catch (eqErr) {
+      const eqMsg = eqErr instanceof Error ? eqErr.message : String(eqErr);
+      const wrapped = new Error(`Node "${this.name}": equals threw: ${eqMsg}`, { cause: eqErr });
+      this._downInternal([[ERROR, wrapped]]);
+      return;
+    }
     if (unchanged) {
       this._downInternal(wasDirty ? [[RESOLVED]] : [[DIRTY], [RESOLVED]]);
       return;
@@ -6027,48 +6731,6 @@ function audit(source, ms, opts) {
     }
   });
 }
-function timeout(source, ms, opts) {
-  const { with: withPayload, ...timeoutNodeOpts } = opts ?? {};
-  let timer;
-  const err = withPayload ?? new Error("timeout");
-  function arm(a) {
-    clearTimeout(timer);
-    timer = setTimeout(() => {
-      timer = void 0;
-      a.down([[ERROR, err]]);
-    }, ms);
-  }
-  return node(
-    [source],
-    ([_v], a) => {
-      arm(a);
-      return () => clearTimeout(timer);
-    },
-    {
-      ...operatorOpts3(timeoutNodeOpts),
-      completeWhenDepsComplete: false,
-      onMessage(msg, _i, a) {
-        const t = msg[0];
-        if (t === DATA) {
-          arm(a);
-          a.down([msg]);
-          return true;
-        }
-        if (t === COMPLETE || t === ERROR) {
-          clearTimeout(timer);
-          a.down([msg]);
-          return true;
-        }
-        if (t === DIRTY || t === RESOLVED) {
-          a.down([msg]);
-          return true;
-        }
-        a.down([msg]);
-        return true;
-      }
-    }
-  );
-}
 function buffer(source, notifier, opts) {
   const buf = [];
   return node([source, notifier], () => void 0, {
@@ -7625,11 +8287,14 @@ function workerSelf(target, opts) {
   NS_PER_MS,
   NS_PER_SEC,
   SqliteCheckpointAdapter,
+  TimeoutError,
   audit,
   buffer,
   bufferCount,
   bufferTime,
+  cache,
   cached,
+  cascadingCache,
   catchError,
   checkpointNodeValue,
   checkpointToRedis,
@@ -7654,6 +8319,7 @@ function workerSelf(target, opts) {
   escapeRegexChar,
   exhaustMap,
   exponential,
+  fallback,
   fibonacci,
   filter,
   find,
@@ -7666,6 +8332,7 @@ function workerSelf(target, opts) {
   fromCSV,
   fromClickHouseWatch,
   fromCron,
+  fromDrizzle,
   fromEvent,
   fromFSWatch,
   fromGitHook,
@@ -7674,10 +8341,12 @@ function workerSelf(target, opts) {
   fromIDBTransaction,
   fromIter,
   fromKafka,
+  fromKysely,
   fromMCP,
   fromNATS,
   fromNDJSON,
   fromOTel,
+  fromPrisma,
   fromPrometheus,
   fromPromise,
   fromPulsar,
@@ -7695,6 +8364,7 @@ function workerSelf(target, opts) {
   last,
   linear,
   logSlice,
+  lru,
   map,
   matchesAnyPattern,
   matchesCron,
@@ -7744,6 +8414,7 @@ function workerSelf(target, opts) {
   throttle,
   throttleTime,
   throwError,
+  tieredStorage,
   timeout,
   toArray,
   toCSV,