@graphrefly/graphrefly 0.47.1 → 0.48.0

package/dist/{chunk-OCUDSN63.js → chunk-GGKHHG5Y.js}

@@ -1,12 +1,12 @@
 import {
   sourceOpts
-} from "./chunk-SOOKUYVM.js";
+} from "./chunk-F7EKHR32.js";
 import {
   withStatus
-} from "./chunk-Y52CS6YA.js";
+} from "./chunk-JA67ZQG2.js";
 import {
   retry
-} from "./chunk-Z4YXAUDN.js";
+} from "./chunk-KUFXLAEY.js";
 import {
   NS_PER_MS,
   NS_PER_SEC,
@@ -15,12 +15,17 @@ import {
 import {
   externalBundle,
   externalProducer
-} from "./chunk-IJRR6YAI.js";
+} from "./chunk-VLDRAMP7.js";
 
 // src/base/io/checkpoint.ts
 import { wallClockNs } from "@graphrefly/pure-ts/core";
 function checkpointToS3(graph, client, bucket, opts) {
-  const { prefix = "checkpoints/", debounceMs = 500, compactEvery = 10, onError } = opts ?? {};
+  const {
+    prefix = "checkpoints/",
+    debounceMs = 500,
+    compactEvery = 10,
+    onError = (err) => console.error(`checkpointToS3(${bucket}): checkpoint persistence failed`, err)
+  } = opts ?? {};
   const tier = {
     name: `s3:${bucket}`,
     debounceMs,
@@ -32,7 +37,7 @@ function checkpointToS3(graph, client, bucket, opts) {
       try {
         body = JSON.stringify(record);
       } catch (err) {
-        onError?.(err);
+        onError(err);
         return;
       }
       void client.putObject({
@@ -40,13 +45,13 @@ function checkpointToS3(graph, client, bucket, opts) {
         Key: s3Key,
         Body: body,
         ContentType: "application/json"
-      }).catch((err) => onError?.(err));
+      }).catch((err) => onError(err));
     }
     // S3 tier is write-only here — one object per checkpoint timestamp,
     // no canonical "latest" key for load.
   };
   return graph.attachSnapshotStorage([{ snapshot: tier }], {
-    onError: (err) => onError?.(err)
+    onError: (err) => onError(err)
   });
 }
 function checkpointToRedis(graph, client, opts) {
@@ -54,7 +59,7 @@ function checkpointToRedis(graph, client, opts) {
     prefix = "graphrefly:checkpoint:",
     debounceMs = 500,
     compactEvery = 10,
-    onError
+    onError = (err) => console.error(`checkpointToRedis(${graph.name}): checkpoint persistence failed`, err)
   } = opts ?? {};
   const redisKey = `${prefix}${graph.name}`;
   const tier = {
@@ -66,23 +71,24 @@ function checkpointToRedis(graph, client, opts) {
       try {
         body = JSON.stringify(record);
       } catch (err) {
-        onError?.(err);
+        onError(err);
         return;
       }
-      void client.set(redisKey, body).catch((err) => onError?.(err));
+      void client.set(redisKey, body).catch((err) => onError(err));
     },
     async load() {
       const raw = await client.get(redisKey);
       if (raw == null) return void 0;
       try {
         return JSON.parse(raw);
-      } catch {
+      } catch (err) {
+        onError(err);
         return void 0;
       }
     }
   };
   return graph.attachSnapshotStorage([{ snapshot: tier }], {
-    onError: (err) => onError?.(err)
+    onError: (err) => onError(err)
   });
 }
 
@@ -120,8 +126,10 @@ function fromClickHouseWatch(client, query, opts) {
         }
       };
       void run();
-      return () => {
-        active = false;
+      return {
+        onDeactivation: () => {
+          active = false;
+        }
       };
     })
   );
@@ -185,8 +193,10 @@ function fromCSV(source, opts) {
         }
       };
       void run();
-      return () => {
-        cancelled = true;
+      return {
+        onDeactivation: () => {
+          cancelled = true;
+        }
       };
     },
     sourceOpts(rest)
@@ -290,8 +300,10 @@ function fromDrizzle(query, opts) {
         } catch {
         }
       });
-      return () => {
-        active = false;
+      return {
+        onDeactivation: () => {
+          active = false;
+        }
       };
     },
     { ...rest, describeKind: "producer", completeWhenDepsComplete: false }
@@ -476,7 +488,21 @@ function reactiveSink(source, config) {
     }
     return run();
   };
-  const maxBuf = backpressure?.maxBuffer ?? Number.POSITIVE_INFINITY;
+  let maxBuf = Number.POSITIVE_INFINITY;
+  if (backpressure) {
+    const mb = backpressure.maxBuffer;
+    if (mb === void 0) {
+      throw new RangeError(
+        "reactiveSink: backpressure requires explicit maxBuffer (use Infinity to opt in to unbounded)"
+      );
+    }
+    if (mb !== Number.POSITIVE_INFINITY && (!Number.isInteger(mb) || mb < 1)) {
+      throw new RangeError(
+        "reactiveSink: backpressure.maxBuffer must be a positive integer (or Infinity for unbounded)"
+      );
+    }
+    maxBuf = mb;
+  }
   const buffer = new BackpressureBuffer(maxBuf);
   let flushTimer;
   let disposed = false;
@@ -796,9 +822,11 @@ function fromHTTP(url, opts) {
   };
   const sourceNode = node5(
     [],
-    (_data, a) => runFetch({
-      emit: (v) => a.emit(v),
-      down: (msgs) => a.down(msgs)
+    (_data, a) => ({
+      onDeactivation: runFetch({
+        emit: (v) => a.emit(v),
+        down: (msgs) => a.down(msgs)
+      })
     }),
     {
       ...sourceOpts(rest),
@@ -899,8 +927,8 @@ function fromHTTPStream(url, opts) {
       const abort = new AbortController();
       if (externalSignal?.aborted) {
         a.down([[ERROR5, externalSignal.reason ?? new Error("Aborted")]]);
-        return () => {
-        };
+        return { onDeactivation: () => {
+        } };
       }
       externalSignal?.addEventListener("abort", () => abort.abort(externalSignal.reason), {
         once: true
@@ -926,9 +954,11 @@ function fromHTTPStream(url, opts) {
         }
       };
       void run();
-      return () => {
-        active = false;
-        abort.abort();
+      return {
+        onDeactivation: () => {
+          active = false;
+          abort.abort();
+        }
       };
     },
     sourceOpts(rest)
@@ -990,8 +1020,10 @@ function fromKafka(consumer, topic, opts) {
         }
       };
       void start();
-      return () => {
-        active = false;
+      return {
+        onDeactivation: () => {
+          active = false;
+        }
       };
     },
     sourceOpts(rest)
@@ -1031,8 +1063,10 @@ function fromKysely(query, opts) {
         } catch {
         }
       });
-      return () => {
-        active = false;
+      return {
+        onDeactivation: () => {
+          active = false;
+        }
       };
     },
     { ...rest, describeKind: "producer", completeWhenDepsComplete: false }
@@ -1096,8 +1130,10 @@ function fromNATS(client, subject, opts) {
         }
       };
       void loop();
-      return () => {
-        active = false;
+      return {
+        onDeactivation: () => {
+          active = false;
+        }
       };
     },
     sourceOpts(rest)
@@ -1181,8 +1217,10 @@ function fromNDJSON(source, opts) {
         }
       };
       void run();
-      return () => {
-        cancelled = true;
+      return {
+        onDeactivation: () => {
+          cancelled = true;
+        }
       };
     },
     sourceOpts(opts)
@@ -1238,8 +1276,10 @@ function fromPrisma(model, opts) {
         } catch {
         }
       });
-      return () => {
-        active = false;
+      return {
+        onDeactivation: () => {
+          active = false;
+        }
       };
     },
     { ...rest, describeKind: "producer", completeWhenDepsComplete: false }
@@ -1294,10 +1334,12 @@ function fromPrometheus(endpoint, opts) {
         }
       };
       void run();
-      return () => {
-        active = false;
-        clearTimeout(timeoutId);
-        abort.abort();
+      return {
+        onDeactivation: () => {
+          active = false;
+          clearTimeout(timeoutId);
+          abort.abort();
+        }
       };
     })
   );
@@ -1447,8 +1489,10 @@ function fromPulsar(consumer, opts) {
         }
       };
       void loop();
-      return () => {
-        active = false;
+      return {
+        onDeactivation: () => {
+          active = false;
+        }
       };
     },
     sourceOpts(rest)
@@ -1569,10 +1613,12 @@ function fromRabbitMQ(channel, queue, opts) {
         }
       };
       void start();
-      return () => {
-        active = false;
-        if (consumerTag !== void 0) {
-          void channel.cancel(consumerTag);
+      return {
+        onDeactivation: () => {
+          active = false;
+          if (consumerTag !== void 0) {
+            void channel.cancel(consumerTag);
+          }
         }
       };
     },
@@ -1650,8 +1696,10 @@ function fromRedisStream(client, key, opts) {
         }
       };
       void poll();
-      return () => {
-        active = false;
+      return {
+        onDeactivation: () => {
+          active = false;
+        }
       };
     },
     sourceOpts(rest)
@@ -2217,9 +2265,11 @@ function fromWebSocket(socketOrRegister, opts) {
         } catch (err) {
           terminate([ERROR16, err]);
         }
-        return () => {
-          active = false;
-          runCleanup();
+        return {
+          onDeactivation: () => {
+            active = false;
+            runCleanup();
+          }
         };
       }
       const ws = socketOrRegister;
@@ -2235,9 +2285,11 @@ function fromWebSocket(socketOrRegister, opts) {
         ws.removeEventListener("close", onClose);
         if (closeOnTeardown) ws.close();
       };
-      return () => {
-        active = false;
-        runCleanup();
+      return {
+        onDeactivation: () => {
+          active = false;
+          runCleanup();
+        }
       };
     },
     sourceOpts(rest)
@@ -2317,13 +2369,7 @@ function toWebSocket(source, socket, opts) {
   return handle;
 }
 function fromWebSocketReconnect(factory, opts) {
-  const {
-    parse,
-    maxRetries,
-    backoff = "exponential",
-    closeOnTeardown = true,
-    ...rest
-  } = opts ?? {};
+  const { parse, maxRetries, backoff = "exponential", closeOnTeardown = true, ...rest } = opts;
   return retry(
     () => fromWebSocket(factory(), {
       parse,
@@ -2383,4 +2429,4 @@ export {
   toWebSocket,
   fromWebSocketReconnect
 };
-//# sourceMappingURL=chunk-OCUDSN63.js.map
+//# sourceMappingURL=chunk-GGKHHG5Y.js.map