@graphrefly/graphrefly 0.47.2 → 0.48.0

package/dist/base/index.d.cts

@@ -4,10 +4,10 @@ export { B as BundleTriad, E as EmitTriad, a as ExternalBundleOptions, b as Exte
 export { I as InteropObservable, a as InteropObserver, b as InteropSubscription, T as ToObservableOptions, t as toObservable } from '../observable-B25XqCbZ.cjs';
 export { AckableMessage, AdapterHandlers, BufferedSinkHandle, CSVRow, CheckpointToRedisOptions, CheckpointToS3Options, ClickHouseClientLike, ClickHouseInsertClientLike, ClickHouseRow, DrizzleQueryLike, FileWriterLike, FromCSVOptions, FromClickHouseWatchOptions, FromDrizzleOptions, FromHTTPOptions, FromHTTPPollOptions, FromHTTPStreamOptions, FromKafkaOptions, FromKyselyOptions, FromMCPOptions, FromNATSOptions, FromNDJSONOptions, FromOTelOptions, FromPrismaOptions, FromPrometheusOptions, FromPulsarOptions, FromRabbitMQOptions, FromRedisStreamOptions, FromSSEOptions, FromSqliteOptions, FromStatsDOptions, FromSyslogOptions, FromWebSocketReconnectOptions, HTTPBundle, KafkaConsumerLike, KafkaMessage, KafkaProducerLike, KyselyQueryLike, LokiClientLike, LokiStream, MCPClientLike, MongoCollectionLike, NATSClientLike, NATSMessage, NATSSubscriptionLike, OTelBundle, OTelLog, OTelMetric, OTelRegister, OTelSpan, ParseSSEStreamOptions, PostgresClientLike, PrismaModelLike, PrometheusMetric, PulsarConsumerLike, PulsarMessage, PulsarProducerLike, RabbitMQChannelLike, RabbitMQMessage, RedisCheckpointClientLike, RedisClientLike, RedisStreamEntry, S3ClientLike, SSEEvent, SinkHandle, SinkTransportError, SqliteDbLike, SqliteIterableDbLike, StatsDMetric, StatsDRegister, SyslogMessage, SyslogRegister, TempoClientLike, ToCSVOptions, ToClickHouseOptions, ToFileOptions, ToHTTPOptions, ToKafkaOptions, ToLokiOptions, ToMongoOptions, ToNATSOptions, ToPostgresOptions, ToPulsarOptions, ToRabbitMQOptions, ToRedisStreamOptions, ToS3Options, ToSSEOptions, ToSqliteOptions, ToTempoOptions, ToWebSocketOptions, WebSocketLike, WebSocketMessageEventLike, WebSocketRegister, WebhookRegister, checkpointToRedis, checkpointToS3, csvRows, fromCSV, fromClickHouseWatch, fromDrizzle, fromHTTP, fromHTTPPoll, fromHTTPStream, fromKafka, fromKysely, fromMCP, fromNATS, fromNDJSON, fromOTel, fromPrisma, fromPrometheus, fromPulsar, fromRabbitMQ, fromRedisStream, fromSSE, fromSqlite, fromSqliteCursor, fromStatsD, fromSyslog, fromWebSocket, fromWebSocketReconnect, fromWebhook, ndjsonRows, parsePrometheusText, parseSSEStream, parseStatsD, parseSyslog, toCSV, toClickHouse, toFile, toHTTP, toKafka, toLoki, toMongo, toNATS, toPostgres, toPulsar, toRabbitMQ, toReadableStream, toRedisStream, toS3, toSSE, toSSEBytes, toSqlite, toTempo, toWebSocket } from './io/index.cjs';
 export { domainMeta, emitToMeta } from './meta/index.cjs';
-export { AuditLogOpts, BaseAuditRecord, DEFAULT_AUDIT_GUARD, FailureMeta, MutateOpts, MutationAct, MutationFrame, SuccessMeta, appendAudit, bumpCursor, createAuditLog, mutate, registerCursor, registerCursorMap, tryIncrementBounded } from './mutation/index.cjs';
+export { AuditLogOpts, BaseAuditRecord, DEFAULT_AUDIT_GUARD, FailureMeta, MutateOpts, MutationAct, MutationFrame, ReadonlyAuditLog, SuccessMeta, appendAudit, bumpCursor, createAuditLog, mutate, readonlyAuditLog, registerCursor, registerCursorMap, tryIncrementBounded } from './mutation/index.cjs';
 export { DiagramDirection, GraphSpecToAsciiOptions, GraphSpecToD2Options, GraphSpecToJsonOptions, GraphSpecToMermaidOptions, GraphSpecToMermaidUrlOptions, GraphSpecToPrettyOptions, LayoutDirection, LayoutFrameToSvgOptions, MermaidLiveTheme, graphSpecToAscii, graphSpecToD2, graphSpecToJson, graphSpecToMermaid, graphSpecToMermaidUrl, graphSpecToPretty, layoutFrameToSvg, mermaidLiveUrl } from './render/index.cjs';
 export { ReactiveCounterBundle, awaitSettled, cached, defer, firstValueFrom, firstWhere, forEach, nodeSignal, reactiveCounter, replay, share, shareReplay, toArray } from './sources/index.cjs';
-export { CronSchedule, FromCronOptions, fromCron, matchesCron, parseCron } from './sources/event/index.cjs';
+export { CronSchedule, FromCronOptions, PushRegister, PushUnsubscribe, fromCron, fromPushNotification, matchesCron, parseCron } from './sources/event/index.cjs';
 export { DEFAULT_DECAY_RATE, decay } from './utils/index.cjs';
 export { BatchMessage, BridgeMessage, ErrorMessage, InitMessage, ReadyMessage, SignalMessage, ValueMessage, WorkerBridge, WorkerBridgeOptions, WorkerSelfHandle, WorkerSelfOptions, WorkerTransport, createTransport, deserializeError, nameToSignal, serializeError, signalToName, workerBridge, workerSelf } from './worker/index.cjs';
 import '@graphrefly/pure-ts/core';

package/dist/base/index.d.ts

@@ -4,10 +4,10 @@ export { B as BundleTriad, E as EmitTriad, a as ExternalBundleOptions, b as Exte
 export { I as InteropObservable, a as InteropObserver, b as InteropSubscription, T as ToObservableOptions, t as toObservable } from '../observable-B25XqCbZ.js';
 export { AckableMessage, AdapterHandlers, BufferedSinkHandle, CSVRow, CheckpointToRedisOptions, CheckpointToS3Options, ClickHouseClientLike, ClickHouseInsertClientLike, ClickHouseRow, DrizzleQueryLike, FileWriterLike, FromCSVOptions, FromClickHouseWatchOptions, FromDrizzleOptions, FromHTTPOptions, FromHTTPPollOptions, FromHTTPStreamOptions, FromKafkaOptions, FromKyselyOptions, FromMCPOptions, FromNATSOptions, FromNDJSONOptions, FromOTelOptions, FromPrismaOptions, FromPrometheusOptions, FromPulsarOptions, FromRabbitMQOptions, FromRedisStreamOptions, FromSSEOptions, FromSqliteOptions, FromStatsDOptions, FromSyslogOptions, FromWebSocketReconnectOptions, HTTPBundle, KafkaConsumerLike, KafkaMessage, KafkaProducerLike, KyselyQueryLike, LokiClientLike, LokiStream, MCPClientLike, MongoCollectionLike, NATSClientLike, NATSMessage, NATSSubscriptionLike, OTelBundle, OTelLog, OTelMetric, OTelRegister, OTelSpan, ParseSSEStreamOptions, PostgresClientLike, PrismaModelLike, PrometheusMetric, PulsarConsumerLike, PulsarMessage, PulsarProducerLike, RabbitMQChannelLike, RabbitMQMessage, RedisCheckpointClientLike, RedisClientLike, RedisStreamEntry, S3ClientLike, SSEEvent, SinkHandle, SinkTransportError, SqliteDbLike, SqliteIterableDbLike, StatsDMetric, StatsDRegister, SyslogMessage, SyslogRegister, TempoClientLike, ToCSVOptions, ToClickHouseOptions, ToFileOptions, ToHTTPOptions, ToKafkaOptions, ToLokiOptions, ToMongoOptions, ToNATSOptions, ToPostgresOptions, ToPulsarOptions, ToRabbitMQOptions, ToRedisStreamOptions, ToS3Options, ToSSEOptions, ToSqliteOptions, ToTempoOptions, ToWebSocketOptions, WebSocketLike, WebSocketMessageEventLike, WebSocketRegister, WebhookRegister, checkpointToRedis, checkpointToS3, csvRows, fromCSV, fromClickHouseWatch, fromDrizzle, fromHTTP, fromHTTPPoll, fromHTTPStream, fromKafka, fromKysely, fromMCP, fromNATS, fromNDJSON, fromOTel, fromPrisma, fromPrometheus, fromPulsar, fromRabbitMQ, fromRedisStream, fromSSE, fromSqlite, fromSqliteCursor, fromStatsD, fromSyslog, fromWebSocket, fromWebSocketReconnect, fromWebhook, ndjsonRows, parsePrometheusText, parseSSEStream, parseStatsD, parseSyslog, toCSV, toClickHouse, toFile, toHTTP, toKafka, toLoki, toMongo, toNATS, toPostgres, toPulsar, toRabbitMQ, toReadableStream, toRedisStream, toS3, toSSE, toSSEBytes, toSqlite, toTempo, toWebSocket } from './io/index.js';
 export { domainMeta, emitToMeta } from './meta/index.js';
-export { AuditLogOpts, BaseAuditRecord, DEFAULT_AUDIT_GUARD, FailureMeta, MutateOpts, MutationAct, MutationFrame, SuccessMeta, appendAudit, bumpCursor, createAuditLog, mutate, registerCursor, registerCursorMap, tryIncrementBounded } from './mutation/index.js';
+export { AuditLogOpts, BaseAuditRecord, DEFAULT_AUDIT_GUARD, FailureMeta, MutateOpts, MutationAct, MutationFrame, ReadonlyAuditLog, SuccessMeta, appendAudit, bumpCursor, createAuditLog, mutate, readonlyAuditLog, registerCursor, registerCursorMap, tryIncrementBounded } from './mutation/index.js';
 export { DiagramDirection, GraphSpecToAsciiOptions, GraphSpecToD2Options, GraphSpecToJsonOptions, GraphSpecToMermaidOptions, GraphSpecToMermaidUrlOptions, GraphSpecToPrettyOptions, LayoutDirection, LayoutFrameToSvgOptions, MermaidLiveTheme, graphSpecToAscii, graphSpecToD2, graphSpecToJson, graphSpecToMermaid, graphSpecToMermaidUrl, graphSpecToPretty, layoutFrameToSvg, mermaidLiveUrl } from './render/index.js';
 export { ReactiveCounterBundle, awaitSettled, cached, defer, firstValueFrom, firstWhere, forEach, nodeSignal, reactiveCounter, replay, share, shareReplay, toArray } from './sources/index.js';
-export { CronSchedule, FromCronOptions, fromCron, matchesCron, parseCron } from './sources/event/index.js';
+export { CronSchedule, FromCronOptions, PushRegister, PushUnsubscribe, fromCron, fromPushNotification, matchesCron, parseCron } from './sources/event/index.js';
 export { DEFAULT_DECAY_RATE, decay } from './utils/index.js';
 export { BatchMessage, BridgeMessage, ErrorMessage, InitMessage, ReadyMessage, SignalMessage, ValueMessage, WorkerBridge, WorkerBridgeOptions, WorkerSelfHandle, WorkerSelfOptions, WorkerTransport, createTransport, deserializeError, nameToSignal, serializeError, signalToName, workerBridge, workerSelf } from './worker/index.js';
 import '@graphrefly/pure-ts/core';

package/dist/base/index.js

@@ -1,7 +1,58 @@
 import "../chunk-CZQHCKKG.js";
+import {
+  checkpointToRedis,
+  checkpointToS3,
+  csvRows,
+  fromCSV,
+  fromClickHouseWatch,
+  fromDrizzle,
+  fromHTTP,
+  fromHTTPPoll,
+  fromHTTPStream,
+  fromKafka,
+  fromKysely,
+  fromMCP,
+  fromNATS,
+  fromNDJSON,
+  fromOTel,
+  fromPrisma,
+  fromPrometheus,
+  fromPulsar,
+  fromRabbitMQ,
+  fromRedisStream,
+  fromSqlite,
+  fromSqliteCursor,
+  fromStatsD,
+  fromSyslog,
+  fromWebSocket,
+  fromWebSocketReconnect,
+  fromWebhook,
+  ndjsonRows,
+  parsePrometheusText,
+  parseStatsD,
+  parseSyslog,
+  toCSV,
+  toClickHouse,
+  toFile,
+  toHTTP,
+  toKafka,
+  toLoki,
+  toMongo,
+  toNATS,
+  toPostgres,
+  toPulsar,
+  toRabbitMQ,
+  toRedisStream,
+  toS3,
+  toSqlite,
+  toTempo,
+  toWebSocket
+} from "../chunk-GGKHHG5Y.js";
 import "../chunk-KPG3DGLA.js";
 import "../chunk-T5BN5KG7.js";
-import "../chunk-W2BOPXTI.js";
+import {
+  fromPushNotification
+} from "../chunk-QSW4DFKE.js";
 import "../chunk-OQUIJT7A.js";
 import {
   createTransport,
@@ -32,6 +83,17 @@ import {
 } from "../chunk-PKGQG5QQ.js";
 import "../chunk-36NMM65U.js";
 import "../chunk-DMSNO6ZB.js";
+import {
+  fromSSE,
+  parseSSEStream,
+  toReadableStream,
+  toSSE,
+  toSSEBytes
+} from "../chunk-F7EKHR32.js";
+import "../chunk-JA67ZQG2.js";
+import "../chunk-KUFXLAEY.js";
+import "../chunk-TSBFTJKM.js";
+import "../chunk-P5LBT622.js";
 import {
   DEFAULT_DECAY_RATE,
   decay
@@ -45,17 +107,22 @@ import {
   bumpCursor,
   createAuditLog,
   mutate,
+  readonlyAuditLog,
   registerCursor,
   registerCursorMap,
   tryIncrementBounded
-} from "../chunk-BXGZFGZ4.js";
+} from "../chunk-C5QD5DQX.js";
 import {
   NativePubSubBackend,
   materialize,
   pubsub,
   selector,
   verifiable
-} from "../chunk-446I4EGD.js";
+} from "../chunk-J5TBZFBD.js";
+import {
+  externalBundle,
+  externalProducer
+} from "../chunk-VLDRAMP7.js";
 import {
   createWatermarkController,
   toObservable
@@ -63,10 +130,10 @@ import {
 import {
   singleFromAny,
   singleNodeFromAny
-} from "../chunk-IOJDYUA7.js";
+} from "../chunk-V46JWFGV.js";
 import {
   distill
-} from "../chunk-OXD5LFQP.js";
+} from "../chunk-G7H6PN7P.js";
 import {
   cached,
   defer,
@@ -75,7 +142,7 @@ import {
   share,
   shareReplay,
   toArray
-} from "../chunk-5GVURVIG.js";
+} from "../chunk-MMHGYX44.js";
 import {
   awaitSettled,
   firstValueFrom,
@@ -83,70 +150,6 @@ import {
   nodeSignal,
   reactiveCounter
 } from "../chunk-N6MNJNHB.js";
-import {
-  checkpointToRedis,
-  checkpointToS3,
-  csvRows,
-  fromCSV,
-  fromClickHouseWatch,
-  fromDrizzle,
-  fromHTTP,
-  fromHTTPPoll,
-  fromHTTPStream,
-  fromKafka,
-  fromKysely,
-  fromMCP,
-  fromNATS,
-  fromNDJSON,
-  fromOTel,
-  fromPrisma,
-  fromPrometheus,
-  fromPulsar,
-  fromRabbitMQ,
-  fromRedisStream,
-  fromSqlite,
-  fromSqliteCursor,
-  fromStatsD,
-  fromSyslog,
-  fromWebSocket,
-  fromWebSocketReconnect,
-  fromWebhook,
-  ndjsonRows,
-  parsePrometheusText,
-  parseStatsD,
-  parseSyslog,
-  toCSV,
-  toClickHouse,
-  toFile,
-  toHTTP,
-  toKafka,
-  toLoki,
-  toMongo,
-  toNATS,
-  toPostgres,
-  toPulsar,
-  toRabbitMQ,
-  toRedisStream,
-  toS3,
-  toSqlite,
-  toTempo,
-  toWebSocket
-} from "../chunk-EL5VHUGK.js";
-import {
-  fromSSE,
-  parseSSEStream,
-  toReadableStream,
-  toSSE,
-  toSSEBytes
-} from "../chunk-F7EKHR32.js";
-import "../chunk-JA67ZQG2.js";
-import "../chunk-KUFXLAEY.js";
-import "../chunk-TSBFTJKM.js";
-import "../chunk-P5LBT622.js";
-import {
-  externalBundle,
-  externalProducer
-} from "../chunk-VLDRAMP7.js";
 import "../chunk-AZDQPQ3V.js";
 export {
   DEFAULT_AUDIT_GUARD,
@@ -189,6 +192,7 @@ export {
   fromPrisma,
   fromPrometheus,
   fromPulsar,
+  fromPushNotification,
   fromRabbitMQ,
   fromRedisStream,
   fromSSE,
@@ -220,6 +224,7 @@ export {
   parseSyslog,
   pubsub,
   reactiveCounter,
+  readonlyAuditLog,
   registerCursor,
   registerCursorMap,
   replay,

package/dist/base/io/index.cjs

@@ -78,7 +78,12 @@ module.exports = __toCommonJS(io_exports);
 // src/base/io/checkpoint.ts
 var import_core = require("@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,
@@ -90,7 +95,7 @@ function checkpointToS3(graph, client, bucket, opts) {
       try {
         body = JSON.stringify(record);
       } catch (err) {
-        onError?.(err);
+        onError(err);
         return;
       }
       void client.putObject({
@@ -98,13 +103,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) {
@@ -112,7 +117,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 = {
@@ -124,23 +129,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)
   });
 }
 
@@ -711,7 +717,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;
@@ -3297,13 +3317,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,