@graphrefly/graphrefly 0.47.1 → 0.48.0

package/dist/base/sources/index.cjs

@@ -27,11 +27,11 @@ function operatorOpts(opts) {
 function isNode(x) {
   return x != null && typeof x === "object" && "cache" in x && typeof x.subscribe === "function";
 }
-var import_core3;
+var import_core4;
 var init_internal = __esm({
   "src/base/resilience/_internal.ts"() {
     "use strict";
-    import_core3 = require("@graphrefly/pure-ts/core");
+    import_core4 = require("@graphrefly/pure-ts/core");
   }
 });
 
@@ -180,21 +180,21 @@ function withTimeout(source, opts, extraOpts) {
   }
   const callerMeta = extraOpts?.meta;
   const factoryArgs = isReactive ? { ns: "Node<Partial<TimeoutOptions>>" } : { ns: latestOpts.ns };
-  const timeoutState = (0, import_core4.node)([], {
+  const timeoutState = (0, import_core5.node)([], {
     name: "timeoutState",
     describeKind: "state",
     initial: { status: "pending" },
     equals: (a, b) => a === b || a != null && b != null && typeof a === "object" && typeof b === "object" && a.status === b.status && JSON.stringify(a) === JSON.stringify(b)
   });
-  const out = (0, import_core4.node)(
+  const out = (0, import_core5.node)(
     (_data, a) => {
       let stopped = false;
       let lastDeadlineNs = 0;
-      const timer = new import_core4.ResettableTimer();
+      const timer = new import_core5.ResettableTimer();
       let optsUnsub = null;
       let srcUnsub = null;
       function emitState(next) {
-        timeoutState.down([[import_core4.DIRTY], [import_core4.DATA, next]]);
+        timeoutState.down([[import_core5.DIRTY], [import_core5.DATA, next]]);
       }
       function startTimer() {
         if (stopped) return;
@@ -203,7 +203,7 @@ function withTimeout(source, opts, extraOpts) {
         }
         const ns = latestOpts.ns;
         lastDeadlineNs = ns;
-        const startedAt = (0, import_core4.monotonicNs)();
+        const startedAt = (0, import_core5.monotonicNs)();
         const delayMs = ns / NS_PER_MS;
         emitState({
           status: "running",
@@ -216,10 +216,10 @@ function withTimeout(source, opts, extraOpts) {
           srcUnsub?.();
           emitState({
             status: "errored",
-            firedAt_ns: (0, import_core4.monotonicNs)(),
+            firedAt_ns: (0, import_core5.monotonicNs)(),
             deadline_ns: ns
           });
-          a.down([[import_core4.ERROR, new TimeoutError(ns)]]);
+          a.down([[import_core5.ERROR, new TimeoutError(ns)]]);
         });
       }
       function attachSource() {
@@ -228,31 +228,31 @@ function withTimeout(source, opts, extraOpts) {
           for (const m of msgs) {
             if (stopped) return;
             const t = m[0];
-            if (t === import_core4.DIRTY) a.down([[import_core4.DIRTY]]);
-            else if (t === import_core4.DATA) {
+            if (t === import_core5.DIRTY) a.down([[import_core5.DIRTY]]);
+            else if (t === import_core5.DATA) {
               startTimer();
               a.emit(m[1]);
-            } else if (t === import_core4.RESOLVED) a.down([[import_core4.RESOLVED]]);
-            else if (t === import_core4.COMPLETE) {
+            } else if (t === import_core5.RESOLVED) a.down([[import_core5.RESOLVED]]);
+            else if (t === import_core5.COMPLETE) {
               timer.cancel();
               stopped = true;
               emitState({
                 status: "completed",
-                settledAt_ns: (0, import_core4.monotonicNs)()
+                settledAt_ns: (0, import_core5.monotonicNs)()
               });
-              a.down([[import_core4.COMPLETE]]);
+              a.down([[import_core5.COMPLETE]]);
               return;
-            } else if (t === import_core4.ERROR) {
+            } else if (t === import_core5.ERROR) {
               timer.cancel();
               stopped = true;
               emitState({
                 status: "errored",
-                firedAt_ns: (0, import_core4.monotonicNs)(),
+                firedAt_ns: (0, import_core5.monotonicNs)(),
                 deadline_ns: lastDeadlineNs
               });
               a.down([m]);
               return;
-            } else if (t === import_core4.TEARDOWN) {
+            } else if (t === import_core5.TEARDOWN) {
               timer.cancel();
               stopped = true;
               a.down([m]);
@@ -268,7 +268,7 @@ function withTimeout(source, opts, extraOpts) {
         const optsNode = opts;
         optsUnsub = optsNode.subscribe((msgs) => {
           for (const m of msgs) {
-            if (m[0] !== import_core4.DATA) continue;
+            if (m[0] !== import_core5.DATA) continue;
             const next = m[1];
             if (next == null || typeof next !== "object") continue;
             const keys = Object.keys(next);
@@ -279,7 +279,7 @@ function withTimeout(source, opts, extraOpts) {
                   stopped = true;
                   a.down([
                     [
-                      import_core4.ERROR,
+                      import_core5.ERROR,
                       new RangeError(
                         "withTimeout: opts.ns must be a positive finite number on first settle"
                       )
@@ -304,26 +304,28 @@ function withTimeout(source, opts, extraOpts) {
       if (latestOpts != null) {
         attachSource();
       }
-      return () => {
-        stopped = true;
-        timer.cancel();
-        if (srcUnsub) srcUnsub();
-        if (optsUnsub) optsUnsub();
+      return {
+        onDeactivation: () => {
+          stopped = true;
+          timer.cancel();
+          if (srcUnsub) srcUnsub();
+          if (optsUnsub) optsUnsub();
+        }
       };
     },
     {
       ...operatorOpts(),
       initial: source.cache,
-      meta: { ...callerMeta ?? {}, ...(0, import_core4.factoryTag)("withTimeout", factoryArgs) }
+      meta: { ...callerMeta ?? {}, ...(0, import_core5.factoryTag)("withTimeout", factoryArgs) }
     }
   );
   return { node: out, timeoutState };
 }
-var import_core4, TimeoutError;
+var import_core5, TimeoutError;
 var init_timeout = __esm({
   "src/base/resilience/timeout.ts"() {
     "use strict";
-    import_core4 = require("@graphrefly/pure-ts/core");
+    import_core5 = require("@graphrefly/pure-ts/core");
     init_internal();
     init_backoff();
     TimeoutError = class extends Error {
@@ -345,6 +347,7 @@ __export(sources_exports, {
   firstWhere: () => firstWhere,
   forEach: () => forEach,
   fromCron: () => fromCron,
+  fromPushNotification: () => fromPushNotification,
   matchesCron: () => matchesCron,
   nodeSignal: () => nodeSignal,
   parseCron: () => parseCron,
@@ -394,9 +397,11 @@ function defer(thunk, opts) {
       const safe = err === void 0 ? new Error("defer: thunk threw undefined") : err;
       a.down([[import_core.ERROR, safe]]);
     }
-    return () => {
-      stopped = true;
-      unsub?.();
+    return {
+      onDeactivation: () => {
+        stopped = true;
+        unsub?.();
+      }
     };
   }, merged);
 }
@@ -445,15 +450,27 @@ function toArray(source, opts) {
     },
     {
       describeKind: "derived",
+      ...opts,
+      // Operator-required flags spread AFTER user `opts` so a caller
+      // cannot accidentally override them (QA F2 spread-order fix,
+      // DS-2.7.A `/qa` 2026-05-20 — matches the
+      // `reduce`/`scan`/`take`/`last` substrate pattern). Spec §2.7
+      // R2.7.1 (DS-2.7.A): Reduce-class shape — fn must fire on
+      // upstream COMPLETE to emit the accumulated array (or `[]` for an
+      // empty source) followed by its own `[[COMPLETE]]`. Required
+      // because `completeWhenDepsComplete: false` means auto-COMPLETE
+      // is OFF; without the opt-in `toArray(empty())` never completes.
       completeWhenDepsComplete: false,
-      ...opts
+      terminalAsRealInput: true
     }
   );
 }
 function share(source, opts) {
   return (0, import_core.node)(
-    (_data, a) => source.subscribe((msgs) => {
-      a.down(msgs);
+    (_data, a) => ({
+      onDeactivation: source.subscribe((msgs) => {
+        a.down(msgs);
+      })
     }),
     { ...(0, import_extra.sourceOpts)(opts), initial: source.cache }
   );
@@ -461,8 +478,10 @@ function share(source, opts) {
 function replay(source, bufferSize, opts) {
   if (bufferSize < 1) throw new RangeError("replay expects bufferSize >= 1");
   return (0, import_core.node)(
-    (_data, a) => source.subscribe((msgs) => {
-      a.down(msgs);
+    (_data, a) => ({
+      onDeactivation: source.subscribe((msgs) => {
+        a.down(msgs);
+      })
     }),
     { ...(0, import_extra.sourceOpts)(opts), initial: source.cache, replayBuffer: bufferSize }
   );
@@ -536,14 +555,41 @@ function fromCron(expr, opts) {
       };
       check();
       const id = setInterval(check, tickMs);
-      return () => clearInterval(id);
+      return { onDeactivation: () => clearInterval(id) };
     },
     { ...sourceOpts2(rest), name: rest.name ?? `cron:${expr}` }
   );
 }
 
+// src/base/sources/event/push.ts
+var import_core3 = require("@graphrefly/pure-ts/core");
+function sourceOpts3(opts) {
+  return { describeKind: "producer", ...opts };
+}
+function fromPushNotification(register, opts) {
+  if (typeof register !== "function") {
+    throw new TypeError(
+      "fromPushNotification: a (deliver) => unsubscribe registration function is required"
+    );
+  }
+  return (0, import_core3.node)((_data, a) => {
+    let done = false;
+    const deliver = (payload) => {
+      if (done) return;
+      a.emit(payload);
+    };
+    const unsubscribe = register(deliver);
+    return {
+      onDeactivation: () => {
+        done = true;
+        if (typeof unsubscribe === "function") unsubscribe();
+      }
+    };
+  }, sourceOpts3(opts));
+}
+
 // src/base/sources/settled.ts
-var import_core5 = require("@graphrefly/pure-ts/core");
+var import_core6 = require("@graphrefly/pure-ts/core");
 function firstValueFrom(source) {
   return new Promise((resolve, reject) => {
     let settled = false;
@@ -552,7 +598,7 @@ function firstValueFrom(source) {
     unsub = source.subscribe((msgs) => {
       for (const m of msgs) {
         if (settled) return;
-        if (m[0] === import_core5.DATA) {
+        if (m[0] === import_core6.DATA) {
           settled = true;
           resolve(m[1]);
           if (unsub) {
@@ -561,7 +607,7 @@ function firstValueFrom(source) {
           } else shouldUnsub = true;
           return;
         }
-        if (m[0] === import_core5.ERROR) {
+        if (m[0] === import_core6.ERROR) {
           settled = true;
           reject(m[1]);
           if (unsub) {
@@ -570,7 +616,7 @@ function firstValueFrom(source) {
           } else shouldUnsub = true;
           return;
         }
-        if (m[0] === import_core5.COMPLETE) {
+        if (m[0] === import_core6.COMPLETE) {
           settled = true;
           reject(new Error("completed without DATA"));
           if (unsub) {
@@ -624,8 +670,8 @@ function firstWhere(source, predicate, opts) {
     if (settled) return;
     for (const m of msgs) {
       if (settled) return;
-      if (inInitialSyncPhase && m[0] === import_core5.DATA) continue;
-      if (m[0] === import_core5.DATA) {
+      if (inInitialSyncPhase && m[0] === import_core6.DATA) continue;
+      if (m[0] === import_core6.DATA) {
         const v = m[1];
         if (predicate(v)) {
           settleData(v);
@@ -633,12 +679,12 @@ function firstWhere(source, predicate, opts) {
           return;
         }
       }
-      if (m[0] === import_core5.ERROR) {
+      if (m[0] === import_core6.ERROR) {
         settleError(m[1]);
         detach();
         return;
       }
-      if (m[0] === import_core5.COMPLETE) {
+      if (m[0] === import_core6.COMPLETE) {
         settleComplete();
         detach();
         return;
@@ -704,17 +750,17 @@ function nodeSignal(source, opts) {
   unsub = source.subscribe((msgs) => {
     if (ctrl.signal.aborted) return;
     for (const m of msgs) {
-      if (m[0] === import_core5.DATA && m[1] === true) {
+      if (m[0] === import_core6.DATA && m[1] === true) {
         ctrl.abort(reason);
         done();
         return;
       }
-      if (m[0] === import_core5.ERROR) {
+      if (m[0] === import_core6.ERROR) {
         ctrl.abort(m[1]);
         done();
         return;
       }
-      if (m[0] === import_core5.COMPLETE) {
+      if (m[0] === import_core6.COMPLETE) {
         done();
         return;
       }
@@ -735,13 +781,13 @@ function nodeSignal(source, opts) {
   };
 }
 function reactiveCounter(cap) {
-  const counter = (0, import_core5.node)([], { initial: 0 });
+  const counter = (0, import_core6.node)([], { initial: 0 });
   return {
     node: counter,
     increment() {
       const current = counter.cache ?? 0;
       if (current >= cap) return false;
-      counter.down([[import_core5.DIRTY], [import_core5.DATA, current + 1]]);
+      counter.down([[import_core6.DIRTY], [import_core6.DATA, current + 1]]);
       return true;
     },
     get() {