react-rx 4.1.31 → 4.2.0

package/dist/index.cjs

@@ -6,19 +6,23 @@ function getValue(value) {
   return typeof value == "function" ? value() : value;
 }
 const cache = /* @__PURE__ */ new WeakMap();
-function useObservable(observable, initialValue) {
-  const $ = reactCompilerRuntime.c(9);
-  let t0;
+function useObservable(observable, initialValue, t0) {
+  const $ = reactCompilerRuntime.c(12);
+  let t1;
+  $[0] !== t0 ? (t1 = t0 === void 0 ? {} : t0, $[0] = t0, $[1] = t1) : t1 = $[1];
+  const options = t1, {
+    disabled: t2
+  } = options, disabled = t2 === void 0 ? !1 : t2;
   if (!cache.has(observable)) {
     const state = {
       didEmit: !1
     }, entry = {
       state,
-      observable: observable.pipe(operators.map(_temp$1), rxjs.catchError(_temp2), operators.tap((t12) => {
+      observable: observable.pipe(operators.map(_temp$1), rxjs.catchError(_temp2), operators.tap((t32) => {
         const {
           snapshot,
           error: error_0
-        } = t12;
+        } = t32;
         state.didEmit = !0, state.snapshot = snapshot, state.error = error_0;
       }), operators.map(_temp3), rxjs.finalize(() => cache.delete(observable)), rxjs.share({
         resetOnRefCountZero: _temp4
@@ -31,21 +35,25 @@ function useObservable(observable, initialValue) {
     };
     entry.observable.subscribe().unsubscribe(), cache.set(observable, entry);
   }
-  let t1;
-  $[0] !== observable ? (t1 = cache.get(observable), $[0] = observable, $[1] = t1) : t1 = $[1], t0 = t1;
-  const instance = t0;
-  let t2;
-  $[2] !== instance.observable ? (t2 = (onStoreChange) => {
+  let t3;
+  $[2] !== observable ? (t3 = cache.get(observable), $[2] = observable, $[3] = t3) : t3 = $[3];
+  const instance = t3;
+  let t4;
+  $[4] !== disabled || $[5] !== instance.observable ? (t4 = (onStoreChange) => {
+    if (disabled)
+      return _temp5;
     const subscription_0 = instance.observable.subscribe(onStoreChange);
     return () => {
       subscription_0.unsubscribe();
     };
-  }, $[2] = instance.observable, $[3] = t2) : t2 = $[3];
-  const subscribe = t2;
-  let t3;
-  $[4] !== initialValue || $[5] !== instance ? (t3 = () => instance.getSnapshot(initialValue), $[4] = initialValue, $[5] = instance, $[6] = t3) : t3 = $[6];
-  let t4;
-  return $[7] !== initialValue ? (t4 = typeof initialValue > "u" ? void 0 : () => getValue(initialValue), $[7] = initialValue, $[8] = t4) : t4 = $[8], react.useSyncExternalStore(subscribe, t3, t4);
+  }, $[4] = disabled, $[5] = instance.observable, $[6] = t4) : t4 = $[6];
+  const subscribe = t4;
+  let t5;
+  $[7] !== initialValue || $[8] !== instance ? (t5 = () => instance.getSnapshot(initialValue), $[7] = initialValue, $[8] = instance, $[9] = t5) : t5 = $[9];
+  let t6;
+  return $[10] !== initialValue ? (t6 = typeof initialValue > "u" ? void 0 : () => getValue(initialValue), $[10] = initialValue, $[11] = t6) : t6 = $[11], react.useSyncExternalStore(subscribe, t5, t6);
+}
+function _temp5() {
 }
 function _temp4() {
   return rxjs.timer(0, rxjs.asapScheduler);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/useObservable.ts","../src/useObservableEvent.ts"],"sourcesContent":["import {useCallback, useMemo, useSyncExternalStore} from 'react'\nimport {\n  asapScheduler,\n  catchError,\n  finalize,\n  type Observable,\n  type ObservedValueOf,\n  of,\n  share,\n  timer,\n} from 'rxjs'\nimport {map, tap} from 'rxjs/operators'\n\nfunction getValue<T>(value: T): T extends () => infer U ? U : T {\n  return (typeof value === 'function' ? (value as () => any)() : value) as T extends () => infer U\n    ? U\n    : T\n}\n\ninterface ObservableState<T> {\n  didEmit: boolean\n  snapshot?: T\n  error?: unknown\n}\n\ninterface CacheRecord<T> {\n  observable: Observable<void>\n  state: {\n    didEmit: boolean\n    snapshot?: T\n    error?: unknown\n  }\n  getSnapshot: (initialValue: unknown) => T\n}\n\nconst cache = new WeakMap<Observable<any>, CacheRecord<any>>()\n\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>>(\n  observable: ObservableType,\n  initialValue: ObservedValueOf<ObservableType> | (() => ObservedValueOf<ObservableType>),\n): ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>>(\n  observable: ObservableType,\n): undefined | ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>, InitialValue>(\n  observable: ObservableType,\n  initialValue: InitialValue | (() => InitialValue),\n): InitialValue | ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>, InitialValue>(\n  observable: ObservableType,\n  initialValue?: InitialValue | (() => InitialValue),\n): InitialValue | ObservedValueOf<ObservableType> {\n  const instance = useMemo(() => {\n    if (!cache.has(observable)) {\n      // This separate object is used as a stable reference to the cache entry's snapshot and error.\n      // It's used by the `getSnapshot` closure.\n      const state: ObservableState<ObservedValueOf<ObservableType>> = {\n        didEmit: false,\n      }\n      const entry: CacheRecord<ObservedValueOf<ObservableType>> = {\n        state,\n        observable: observable.pipe(\n          map((value) => ({snapshot: value, error: undefined})),\n          catchError((error) => of({snapshot: undefined, error})),\n          tap(({snapshot, error}) => {\n            state.didEmit = true\n            state.snapshot = snapshot\n            state.error = error\n          }),\n          // Note: any value or error emitted by the provided observable will be mapped to the cache entry's mutable state\n          // and the observable is thereafter only used as a notifier to call `onStoreChange`, hence the `void` return type.\n          map((value) => void value),\n          // Ensure that the cache entry is deleted when the observable completes or errors.\n          finalize(() => cache.delete(observable)),\n          share({resetOnRefCountZero: () => timer(0, asapScheduler)}),\n        ),\n        getSnapshot: (initialValue) => {\n          if (state.error) {\n            throw state.error\n          }\n          return (\n            state.didEmit ? state.snapshot : getValue(initialValue)\n          ) as ObservedValueOf<ObservableType>\n        },\n      }\n\n      // Eagerly subscribe to sync set `state.snapshot` to what the observable returns, and keep the observable alive until the component unmounts.\n      const subscription = entry.observable.subscribe()\n      subscription.unsubscribe()\n\n      cache.set(observable, entry)\n    }\n    return cache.get(observable)!\n  }, [observable])\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      const subscription = instance.observable.subscribe(onStoreChange)\n      return () => {\n        subscription.unsubscribe()\n      }\n    },\n    [instance.observable],\n  )\n\n  return useSyncExternalStore<ObservedValueOf<ObservableType>>(\n    subscribe,\n    () => {\n      return instance.getSnapshot(initialValue)\n    },\n    typeof initialValue === 'undefined'\n      ? undefined\n      : () => getValue(initialValue) as ObservedValueOf<ObservableType>,\n  )\n}\n","import {observableCallback} from 'observable-callback'\nimport {useEffect, useState} from 'react'\nimport {type Observable} from 'rxjs'\nimport {useEffectEvent} from 'use-effect-event'\n\n/** @public */\nexport function useObservableEvent<T, U>(\n  handleEvent: (arg: Observable<T>) => Observable<U>,\n): (arg: T) => void {\n  const [[calls$, call]] = useState(() => observableCallback<T>())\n\n  const onEvent = useEffectEvent((observable: Observable<T>) => handleEvent(observable))\n\n  useEffect(() => {\n    const subscription = calls$.pipe((observable) => onEvent(observable)).subscribe()\n    return () => subscription.unsubscribe()\n  }, [calls$])\n\n  return call\n}\n"],"names":["getValue","value","cache","WeakMap","useObservable","observable","initialValue","$","_c","t0","has","state","didEmit","entry","pipe","map","_temp","catchError","_temp2","tap","t1","snapshot","error","error_0","_temp3","finalize","delete","share","resetOnRefCountZero","_temp4","getSnapshot","initialValue_0","subscribe","unsubscribe","set","get","instance","t2","onStoreChange","subscription_0","subscription","t3","t4","undefined","useSyncExternalStore","timer","asapScheduler","value_0","of","useObservableEvent","handleEvent","useState","calls$","call","onEvent","useEffectEvent","observable_0","useEffect","observableCallback"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/useObservable.ts","../src/useObservableEvent.ts"],"sourcesContent":["import {useCallback, useMemo, useSyncExternalStore} from 'react'\nimport {\n  asapScheduler,\n  catchError,\n  finalize,\n  type Observable,\n  type ObservedValueOf,\n  of,\n  share,\n  timer,\n} from 'rxjs'\nimport {map, tap} from 'rxjs/operators'\n\nfunction getValue<T>(value: T): T extends () => infer U ? U : T {\n  return (typeof value === 'function' ? (value as () => any)() : value) as T extends () => infer U\n    ? U\n    : T\n}\n\ninterface ObservableState<T> {\n  didEmit: boolean\n  snapshot?: T\n  error?: unknown\n}\n\ninterface CacheRecord<T> {\n  observable: Observable<void>\n  state: {\n    didEmit: boolean\n    snapshot?: T\n    error?: unknown\n  }\n  getSnapshot: (initialValue: unknown) => T\n}\n\nconst cache = new WeakMap<Observable<any>, CacheRecord<any>>()\n\n/** @public */\nexport interface UseObservableOptions {\n  disabled?: boolean\n}\n\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>>(\n  observable: ObservableType,\n  initialValue: ObservedValueOf<ObservableType> | (() => ObservedValueOf<ObservableType>),\n  options?: UseObservableOptions,\n): ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>>(\n  observable: ObservableType,\n): undefined | ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>, InitialValue>(\n  observable: ObservableType,\n  initialValue: InitialValue | (() => InitialValue),\n  options?: UseObservableOptions,\n): InitialValue | ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>, InitialValue>(\n  observable: ObservableType,\n  initialValue?: InitialValue | (() => InitialValue),\n  options: UseObservableOptions = {},\n): InitialValue | ObservedValueOf<ObservableType> {\n  const {disabled = false} = options\n\n  const instance = useMemo(() => {\n    if (!cache.has(observable)) {\n      // This separate object is used as a stable reference to the cache entry's snapshot and error.\n      // It's used by the `getSnapshot` closure.\n      const state: ObservableState<ObservedValueOf<ObservableType>> = {\n        didEmit: false,\n      }\n      const entry: CacheRecord<ObservedValueOf<ObservableType>> = {\n        state,\n        observable: observable.pipe(\n          map((value) => ({snapshot: value, error: undefined})),\n          catchError((error) => of({snapshot: undefined, error})),\n          tap(({snapshot, error}) => {\n            state.didEmit = true\n            state.snapshot = snapshot\n            state.error = error\n          }),\n          // Note: any value or error emitted by the provided observable will be mapped to the cache entry's mutable state\n          // and the observable is thereafter only used as a notifier to call `onStoreChange`, hence the `void` return type.\n          map((value) => void value),\n          // Ensure that the cache entry is deleted when the observable completes or errors.\n          finalize(() => cache.delete(observable)),\n          share({resetOnRefCountZero: () => timer(0, asapScheduler)}),\n        ),\n        getSnapshot: (initialValue) => {\n          if (state.error) {\n            throw state.error\n          }\n          return (\n            state.didEmit ? state.snapshot : getValue(initialValue)\n          ) as ObservedValueOf<ObservableType>\n        },\n      }\n\n      // Eagerly subscribe to sync set `state.snapshot` to what the observable returns, and keep the observable alive until the component unmounts.\n      const subscription = entry.observable.subscribe()\n      subscription.unsubscribe()\n\n      cache.set(observable, entry)\n    }\n    return cache.get(observable)!\n  }, [observable])\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      if (disabled) {\n        return () => {}\n      }\n\n      const subscription = instance.observable.subscribe(onStoreChange)\n      return () => {\n        subscription.unsubscribe()\n      }\n    },\n    [instance.observable, disabled],\n  )\n\n  return useSyncExternalStore<ObservedValueOf<ObservableType>>(\n    subscribe,\n    () => {\n      return instance.getSnapshot(initialValue)\n    },\n    typeof initialValue === 'undefined'\n      ? undefined\n      : () => getValue(initialValue) as ObservedValueOf<ObservableType>,\n  )\n}\n","import {observableCallback} from 'observable-callback'\nimport {useEffect, useState} from 'react'\nimport {type Observable} from 'rxjs'\nimport {useEffectEvent} from 'use-effect-event'\n\n/** @public */\nexport function useObservableEvent<T, U>(\n  handleEvent: (arg: Observable<T>) => Observable<U>,\n): (arg: T) => void {\n  const [[calls$, call]] = useState(() => observableCallback<T>())\n\n  const onEvent = useEffectEvent((observable: Observable<T>) => handleEvent(observable))\n\n  useEffect(() => {\n    const subscription = calls$.pipe((observable) => onEvent(observable)).subscribe()\n    return () => subscription.unsubscribe()\n  }, [calls$])\n\n  return call\n}\n"],"names":["getValue","value","cache","WeakMap","useObservable","observable","initialValue","t0","$","_c","t1","undefined","options","disabled","t2","has","state","didEmit","entry","pipe","map","_temp","catchError","_temp2","tap","t3","snapshot","error","error_0","_temp3","finalize","delete","share","resetOnRefCountZero","_temp4","getSnapshot","initialValue_0","subscribe","unsubscribe","set","get","instance","t4","onStoreChange","_temp5","subscription_0","subscription","t5","t6","useSyncExternalStore","timer","asapScheduler","value_0","of","useObservableEvent","handleEvent","useState","calls$","call","onEvent","useEffectEvent","observable_0","useEffect","observableCallback"],"mappings":"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"}

package/dist/index.d.cts

@@ -5,6 +5,7 @@ import {ObservedValueOf} from 'rxjs'
 export declare function useObservable<ObservableType extends Observable<any>>(
   observable: ObservableType,
   initialValue: ObservedValueOf<ObservableType> | (() => ObservedValueOf<ObservableType>),
+  options?: UseObservableOptions,
 ): ObservedValueOf<ObservableType>
 
 /** @public */
@@ -16,6 +17,7 @@ export declare function useObservable<ObservableType extends Observable<any>>(
 export declare function useObservable<ObservableType extends Observable<any>, InitialValue>(
   observable: ObservableType,
   initialValue: InitialValue | (() => InitialValue),
+  options?: UseObservableOptions,
 ): InitialValue | ObservedValueOf<ObservableType>
 
 /** @public */
@@ -23,4 +25,9 @@ export declare function useObservableEvent<T, U>(
   handleEvent: (arg: Observable<T>) => Observable<U>,
 ): (arg: T) => void
 
+/** @public */
+export declare interface UseObservableOptions {
+  disabled?: boolean
+}
+
 export {}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import {ObservedValueOf} from 'rxjs'
 export declare function useObservable<ObservableType extends Observable<any>>(
   observable: ObservableType,
   initialValue: ObservedValueOf<ObservableType> | (() => ObservedValueOf<ObservableType>),
+  options?: UseObservableOptions,
 ): ObservedValueOf<ObservableType>
 
 /** @public */
@@ -16,6 +17,7 @@ export declare function useObservable<ObservableType extends Observable<any>>(
 export declare function useObservable<ObservableType extends Observable<any>, InitialValue>(
   observable: ObservableType,
   initialValue: InitialValue | (() => InitialValue),
+  options?: UseObservableOptions,
 ): InitialValue | ObservedValueOf<ObservableType>
 
 /** @public */
@@ -23,4 +25,9 @@ export declare function useObservableEvent<T, U>(
   handleEvent: (arg: Observable<T>) => Observable<U>,
 ): (arg: T) => void
 
+/** @public */
+export declare interface UseObservableOptions {
+  disabled?: boolean
+}
+
 export {}

package/dist/index.js

@@ -9,19 +9,23 @@ function getValue(value) {
   return typeof value == "function" ? value() : value;
 }
 const cache = /* @__PURE__ */ new WeakMap();
-function useObservable(observable, initialValue) {
-  const $ = c(9);
-  let t0;
+function useObservable(observable, initialValue, t0) {
+  const $ = c(12);
+  let t1;
+  $[0] !== t0 ? (t1 = t0 === void 0 ? {} : t0, $[0] = t0, $[1] = t1) : t1 = $[1];
+  const options = t1, {
+    disabled: t2
+  } = options, disabled = t2 === void 0 ? !1 : t2;
   if (!cache.has(observable)) {
     const state = {
       didEmit: !1
     }, entry = {
       state,
-      observable: observable.pipe(map(_temp$1), catchError(_temp2), tap((t12) => {
+      observable: observable.pipe(map(_temp$1), catchError(_temp2), tap((t32) => {
         const {
           snapshot,
           error: error_0
-        } = t12;
+        } = t32;
         state.didEmit = !0, state.snapshot = snapshot, state.error = error_0;
       }), map(_temp3), finalize(() => cache.delete(observable)), share({
         resetOnRefCountZero: _temp4
@@ -34,21 +38,25 @@ function useObservable(observable, initialValue) {
     };
     entry.observable.subscribe().unsubscribe(), cache.set(observable, entry);
   }
-  let t1;
-  $[0] !== observable ? (t1 = cache.get(observable), $[0] = observable, $[1] = t1) : t1 = $[1], t0 = t1;
-  const instance = t0;
-  let t2;
-  $[2] !== instance.observable ? (t2 = (onStoreChange) => {
+  let t3;
+  $[2] !== observable ? (t3 = cache.get(observable), $[2] = observable, $[3] = t3) : t3 = $[3];
+  const instance = t3;
+  let t4;
+  $[4] !== disabled || $[5] !== instance.observable ? (t4 = (onStoreChange) => {
+    if (disabled)
+      return _temp5;
     const subscription_0 = instance.observable.subscribe(onStoreChange);
     return () => {
       subscription_0.unsubscribe();
     };
-  }, $[2] = instance.observable, $[3] = t2) : t2 = $[3];
-  const subscribe = t2;
-  let t3;
-  $[4] !== initialValue || $[5] !== instance ? (t3 = () => instance.getSnapshot(initialValue), $[4] = initialValue, $[5] = instance, $[6] = t3) : t3 = $[6];
-  let t4;
-  return $[7] !== initialValue ? (t4 = typeof initialValue > "u" ? void 0 : () => getValue(initialValue), $[7] = initialValue, $[8] = t4) : t4 = $[8], useSyncExternalStore(subscribe, t3, t4);
+  }, $[4] = disabled, $[5] = instance.observable, $[6] = t4) : t4 = $[6];
+  const subscribe = t4;
+  let t5;
+  $[7] !== initialValue || $[8] !== instance ? (t5 = () => instance.getSnapshot(initialValue), $[7] = initialValue, $[8] = instance, $[9] = t5) : t5 = $[9];
+  let t6;
+  return $[10] !== initialValue ? (t6 = typeof initialValue > "u" ? void 0 : () => getValue(initialValue), $[10] = initialValue, $[11] = t6) : t6 = $[11], useSyncExternalStore(subscribe, t5, t6);
+}
+function _temp5() {
 }
 function _temp4() {
   return timer(0, asapScheduler);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/useObservable.ts","../src/useObservableEvent.ts"],"sourcesContent":["import {useCallback, useMemo, useSyncExternalStore} from 'react'\nimport {\n  asapScheduler,\n  catchError,\n  finalize,\n  type Observable,\n  type ObservedValueOf,\n  of,\n  share,\n  timer,\n} from 'rxjs'\nimport {map, tap} from 'rxjs/operators'\n\nfunction getValue<T>(value: T): T extends () => infer U ? U : T {\n  return (typeof value === 'function' ? (value as () => any)() : value) as T extends () => infer U\n    ? U\n    : T\n}\n\ninterface ObservableState<T> {\n  didEmit: boolean\n  snapshot?: T\n  error?: unknown\n}\n\ninterface CacheRecord<T> {\n  observable: Observable<void>\n  state: {\n    didEmit: boolean\n    snapshot?: T\n    error?: unknown\n  }\n  getSnapshot: (initialValue: unknown) => T\n}\n\nconst cache = new WeakMap<Observable<any>, CacheRecord<any>>()\n\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>>(\n  observable: ObservableType,\n  initialValue: ObservedValueOf<ObservableType> | (() => ObservedValueOf<ObservableType>),\n): ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>>(\n  observable: ObservableType,\n): undefined | ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>, InitialValue>(\n  observable: ObservableType,\n  initialValue: InitialValue | (() => InitialValue),\n): InitialValue | ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>, InitialValue>(\n  observable: ObservableType,\n  initialValue?: InitialValue | (() => InitialValue),\n): InitialValue | ObservedValueOf<ObservableType> {\n  const instance = useMemo(() => {\n    if (!cache.has(observable)) {\n      // This separate object is used as a stable reference to the cache entry's snapshot and error.\n      // It's used by the `getSnapshot` closure.\n      const state: ObservableState<ObservedValueOf<ObservableType>> = {\n        didEmit: false,\n      }\n      const entry: CacheRecord<ObservedValueOf<ObservableType>> = {\n        state,\n        observable: observable.pipe(\n          map((value) => ({snapshot: value, error: undefined})),\n          catchError((error) => of({snapshot: undefined, error})),\n          tap(({snapshot, error}) => {\n            state.didEmit = true\n            state.snapshot = snapshot\n            state.error = error\n          }),\n          // Note: any value or error emitted by the provided observable will be mapped to the cache entry's mutable state\n          // and the observable is thereafter only used as a notifier to call `onStoreChange`, hence the `void` return type.\n          map((value) => void value),\n          // Ensure that the cache entry is deleted when the observable completes or errors.\n          finalize(() => cache.delete(observable)),\n          share({resetOnRefCountZero: () => timer(0, asapScheduler)}),\n        ),\n        getSnapshot: (initialValue) => {\n          if (state.error) {\n            throw state.error\n          }\n          return (\n            state.didEmit ? state.snapshot : getValue(initialValue)\n          ) as ObservedValueOf<ObservableType>\n        },\n      }\n\n      // Eagerly subscribe to sync set `state.snapshot` to what the observable returns, and keep the observable alive until the component unmounts.\n      const subscription = entry.observable.subscribe()\n      subscription.unsubscribe()\n\n      cache.set(observable, entry)\n    }\n    return cache.get(observable)!\n  }, [observable])\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      const subscription = instance.observable.subscribe(onStoreChange)\n      return () => {\n        subscription.unsubscribe()\n      }\n    },\n    [instance.observable],\n  )\n\n  return useSyncExternalStore<ObservedValueOf<ObservableType>>(\n    subscribe,\n    () => {\n      return instance.getSnapshot(initialValue)\n    },\n    typeof initialValue === 'undefined'\n      ? undefined\n      : () => getValue(initialValue) as ObservedValueOf<ObservableType>,\n  )\n}\n","import {observableCallback} from 'observable-callback'\nimport {useEffect, useState} from 'react'\nimport {type Observable} from 'rxjs'\nimport {useEffectEvent} from 'use-effect-event'\n\n/** @public */\nexport function useObservableEvent<T, U>(\n  handleEvent: (arg: Observable<T>) => Observable<U>,\n): (arg: T) => void {\n  const [[calls$, call]] = useState(() => observableCallback<T>())\n\n  const onEvent = useEffectEvent((observable: Observable<T>) => handleEvent(observable))\n\n  useEffect(() => {\n    const subscription = calls$.pipe((observable) => onEvent(observable)).subscribe()\n    return () => subscription.unsubscribe()\n  }, [calls$])\n\n  return call\n}\n"],"names":["getValue","value","cache","WeakMap","useObservable","observable","initialValue","$","_c","t0","has","state","didEmit","entry","pipe","map","_temp","catchError","_temp2","tap","t1","snapshot","error","error_0","_temp3","finalize","delete","share","resetOnRefCountZero","_temp4","getSnapshot","initialValue_0","subscribe","unsubscribe","set","get","instance","t2","onStoreChange","subscription_0","subscription","t3","t4","undefined","useSyncExternalStore","timer","asapScheduler","value_0","of","useObservableEvent","handleEvent","useState","calls$","call","onEvent","useEffectEvent","observable_0","useEffect","observableCallback"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/useObservable.ts","../src/useObservableEvent.ts"],"sourcesContent":["import {useCallback, useMemo, useSyncExternalStore} from 'react'\nimport {\n  asapScheduler,\n  catchError,\n  finalize,\n  type Observable,\n  type ObservedValueOf,\n  of,\n  share,\n  timer,\n} from 'rxjs'\nimport {map, tap} from 'rxjs/operators'\n\nfunction getValue<T>(value: T): T extends () => infer U ? U : T {\n  return (typeof value === 'function' ? (value as () => any)() : value) as T extends () => infer U\n    ? U\n    : T\n}\n\ninterface ObservableState<T> {\n  didEmit: boolean\n  snapshot?: T\n  error?: unknown\n}\n\ninterface CacheRecord<T> {\n  observable: Observable<void>\n  state: {\n    didEmit: boolean\n    snapshot?: T\n    error?: unknown\n  }\n  getSnapshot: (initialValue: unknown) => T\n}\n\nconst cache = new WeakMap<Observable<any>, CacheRecord<any>>()\n\n/** @public */\nexport interface UseObservableOptions {\n  disabled?: boolean\n}\n\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>>(\n  observable: ObservableType,\n  initialValue: ObservedValueOf<ObservableType> | (() => ObservedValueOf<ObservableType>),\n  options?: UseObservableOptions,\n): ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>>(\n  observable: ObservableType,\n): undefined | ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>, InitialValue>(\n  observable: ObservableType,\n  initialValue: InitialValue | (() => InitialValue),\n  options?: UseObservableOptions,\n): InitialValue | ObservedValueOf<ObservableType>\n/** @public */\nexport function useObservable<ObservableType extends Observable<any>, InitialValue>(\n  observable: ObservableType,\n  initialValue?: InitialValue | (() => InitialValue),\n  options: UseObservableOptions = {},\n): InitialValue | ObservedValueOf<ObservableType> {\n  const {disabled = false} = options\n\n  const instance = useMemo(() => {\n    if (!cache.has(observable)) {\n      // This separate object is used as a stable reference to the cache entry's snapshot and error.\n      // It's used by the `getSnapshot` closure.\n      const state: ObservableState<ObservedValueOf<ObservableType>> = {\n        didEmit: false,\n      }\n      const entry: CacheRecord<ObservedValueOf<ObservableType>> = {\n        state,\n        observable: observable.pipe(\n          map((value) => ({snapshot: value, error: undefined})),\n          catchError((error) => of({snapshot: undefined, error})),\n          tap(({snapshot, error}) => {\n            state.didEmit = true\n            state.snapshot = snapshot\n            state.error = error\n          }),\n          // Note: any value or error emitted by the provided observable will be mapped to the cache entry's mutable state\n          // and the observable is thereafter only used as a notifier to call `onStoreChange`, hence the `void` return type.\n          map((value) => void value),\n          // Ensure that the cache entry is deleted when the observable completes or errors.\n          finalize(() => cache.delete(observable)),\n          share({resetOnRefCountZero: () => timer(0, asapScheduler)}),\n        ),\n        getSnapshot: (initialValue) => {\n          if (state.error) {\n            throw state.error\n          }\n          return (\n            state.didEmit ? state.snapshot : getValue(initialValue)\n          ) as ObservedValueOf<ObservableType>\n        },\n      }\n\n      // Eagerly subscribe to sync set `state.snapshot` to what the observable returns, and keep the observable alive until the component unmounts.\n      const subscription = entry.observable.subscribe()\n      subscription.unsubscribe()\n\n      cache.set(observable, entry)\n    }\n    return cache.get(observable)!\n  }, [observable])\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      if (disabled) {\n        return () => {}\n      }\n\n      const subscription = instance.observable.subscribe(onStoreChange)\n      return () => {\n        subscription.unsubscribe()\n      }\n    },\n    [instance.observable, disabled],\n  )\n\n  return useSyncExternalStore<ObservedValueOf<ObservableType>>(\n    subscribe,\n    () => {\n      return instance.getSnapshot(initialValue)\n    },\n    typeof initialValue === 'undefined'\n      ? undefined\n      : () => getValue(initialValue) as ObservedValueOf<ObservableType>,\n  )\n}\n","import {observableCallback} from 'observable-callback'\nimport {useEffect, useState} from 'react'\nimport {type Observable} from 'rxjs'\nimport {useEffectEvent} from 'use-effect-event'\n\n/** @public */\nexport function useObservableEvent<T, U>(\n  handleEvent: (arg: Observable<T>) => Observable<U>,\n): (arg: T) => void {\n  const [[calls$, call]] = useState(() => observableCallback<T>())\n\n  const onEvent = useEffectEvent((observable: Observable<T>) => handleEvent(observable))\n\n  useEffect(() => {\n    const subscription = calls$.pipe((observable) => onEvent(observable)).subscribe()\n    return () => subscription.unsubscribe()\n  }, [calls$])\n\n  return call\n}\n"],"names":["getValue","value","cache","WeakMap","useObservable","observable","initialValue","t0","$","_c","t1","undefined","options","disabled","t2","has","state","didEmit","entry","pipe","map","_temp","catchError","_temp2","tap","t3","snapshot","error","error_0","_temp3","finalize","delete","share","resetOnRefCountZero","_temp4","getSnapshot","initialValue_0","subscribe","unsubscribe","set","get","instance","t4","onStoreChange","_temp5","subscription_0","subscription","t5","t6","useSyncExternalStore","timer","asapScheduler","value_0","of","useObservableEvent","handleEvent","useState","calls$","call","onEvent","useEffectEvent","observable_0","useEffect","observableCallback"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-rx",
-  "version": "4.1.31",
+  "version": "4.2.0",
   "description": "React + RxJS = <3",
   "keywords": [
     "action",
@@ -75,36 +75,38 @@
   "prettier": "@sanity/prettier-config",
   "dependencies": {
     "observable-callback": "^1.0.3",
-    "react-compiler-runtime": "19.1.0-rc.2",
+    "react-compiler-runtime": "19.1.0-rc.3",
     "use-effect-event": "^2.0.3"
   },
   "devDependencies": {
-    "@sanity/pkg-utils": "^7.8.0",
-    "@sanity/prettier-config": "^1.0.5",
+    "@sanity/browserslist-config": "^1.0.5",
+    "@sanity/pkg-utils": "^8.1.4",
+    "@sanity/prettier-config": "^1.0.6",
     "@sanity/semantic-release-preset": "^5.0.0",
-    "@testing-library/dom": "^10.4.0",
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
-    "@types/node": "^22.15.3",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
-    "@typescript-eslint/eslint-plugin": "^8.34.1",
-    "@typescript-eslint/parser": "^8.34.1",
-    "@vitejs/plugin-react": "^4.5.2",
-    "babel-plugin-react-compiler": "19.1.0-rc.2",
-    "eslint": "^9.29.0",
-    "eslint-config-prettier": "^10.1.5",
+    "@types/node": "^24.3.0",
+    "@types/react": "^19.1.12",
+    "@types/react-dom": "^19.1.9",
+    "@typescript-eslint/eslint-plugin": "^8.41.0",
+    "@typescript-eslint/parser": "^8.41.0",
+    "@vitejs/plugin-react": "^5.0.2",
+    "babel-plugin-react-compiler": "19.1.0-rc.3",
+    "eslint": "^9.34.0",
+    "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-hooks": "0.0.0-experimental-79d9aed7-20250620",
+    "eslint-plugin-react-hooks": "6.0.0-rc.2",
+    "eslint-plugin-react-hooks-with-use-effect-event": "npm:eslint-plugin-react-hooks@0.0.0-experimental-d415fd3e-20250919",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "jsdom": "^24.1.0",
-    "prettier": "^3.5.3",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
-    "react-test-renderer": "^19.1.0",
+    "jsdom": "^26.1.0",
+    "prettier": "^3.6.2",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "react-test-renderer": "^19.1.1",
     "rxjs": "^7.8.2",
-    "semantic-release": "^24.2.5",
-    "typescript": "5.8.3",
-    "typescript-eslint": "^8.34.1",
+    "semantic-release": "^24.2.7",
+    "typescript": "5.9.2",
+    "typescript-eslint": "^8.41.0",
     "vitest": "^3.2.4"
   },
   "peerDependencies": {

package/src/__tests__/useObservable.test-d.ts

@@ -15,13 +15,13 @@ test('useObservable with no initial value can be undefined', () => {
 test('return type of useObservable with initial value is not undefined', () => {
   const observable = of('foo')
   //@ts-expect-error - because initial value is given, the return type can never be undefined
-  expectTypeOf(useObservable(observable, 'bar')).toEqualTypeOf<string | undefined>()
+  expectTypeOf(useObservable(observable, {initialValue: 'bar'})).toEqualTypeOf<string | undefined>()
 })
 
 test('useObservable with initial value if a different type returns a union of the observed type and the initial value type', () => {
   const observable = of('foo')
 
-  expectTypeOf(useObservable(observable, 1)).toEqualTypeOf<string | number>()
-  expectTypeOf(useObservable(observable, () => 1)).toEqualTypeOf<string | number>()
-  expectTypeOf(useObservable(observable, 'foo')).toEqualTypeOf<string>()
+  expectTypeOf(useObservable(observable, {initialValue: 1})).toEqualTypeOf<string | number>()
+  expectTypeOf(useObservable(observable, {initialValue: () => 1})).toEqualTypeOf<string | number>()
+  expectTypeOf(useObservable(observable, {initialValue: 'foo'})).toEqualTypeOf<string>()
 })

package/src/__tests__/useObservable.test.tsx

@@ -5,7 +5,7 @@ import {asyncScheduler, Observable, of, ReplaySubject, scheduled, share, Subject
 import {map} from 'rxjs/operators'
 import {expect, test} from 'vitest'
 
-import {useObservable} from '../useObservable'
+import {useObservable, type UseObservableOptions} from '../useObservable'
 
 test('should subscribe immediately on component mount and unsubscribe on component unmount', async () => {
   let subscribed = false
@@ -309,3 +309,67 @@ test('should throw during SSR if no initial value is defined', () => {
     `[Error: Missing getServerSnapshot, which is required for server-rendered content. Will revert to client rendering.]`,
   )
 })
+
+test('should not subscribe if the disabled prop is present', () => {
+  const values$ = new Subject<string | undefined>()
+  const {result, unmount} = renderHook(() => useObservable(values$, 'initial', {disabled: true}))
+
+  act(() => values$.next('something'))
+  expect(result.current).toBe('initial')
+
+  unmount()
+})
+
+test('should return the last value instead of the initial value when the hook is disabled after running', () => {
+  const values$ = new Subject<string | undefined>()
+  const {result, unmount, rerender} = renderHook<string | undefined, UseObservableOptions>(
+    (props) => useObservable(values$, 'initial', props),
+  )
+  expect(result.current).toBe('initial')
+  act(() => values$.next('something'))
+  expect(result.current).toBe('something')
+
+  rerender({
+    disabled: true,
+  })
+
+  act(() => values$.next('something else'))
+
+  expect(result.current).toBe('something')
+
+  unmount()
+})
+
+test('should return the actual value when the hook is disabled and then re-enabled', () => {
+  const values$ = new Subject<string | undefined>()
+  const {result, unmount, rerender} = renderHook<string | undefined, UseObservableOptions>(
+    (props) => useObservable(values$, 'initial', props),
+  )
+  expect(result.current).toBe('initial')
+  act(() => values$.next('something'))
+  expect(result.current).toBe('something')
+
+  rerender({
+    disabled: true,
+  })
+
+  act(() => values$.next('something else'))
+
+  expect(result.current).toBe('something')
+
+  act(() => values$.next('something again'))
+
+  expect(result.current).toBe('something')
+
+  rerender({
+    disabled: false,
+  })
+
+  expect(result.current).toBe('something again')
+
+  act(() => values$.next('something ending'))
+
+  expect(result.current).toBe('something ending')
+
+  unmount()
+})

package/src/useObservable.ts

@@ -35,10 +35,16 @@ interface CacheRecord<T> {
 
 const cache = new WeakMap<Observable<any>, CacheRecord<any>>()
 
+/** @public */
+export interface UseObservableOptions {
+  disabled?: boolean
+}
+
 /** @public */
 export function useObservable<ObservableType extends Observable<any>>(
   observable: ObservableType,
   initialValue: ObservedValueOf<ObservableType> | (() => ObservedValueOf<ObservableType>),
+  options?: UseObservableOptions,
 ): ObservedValueOf<ObservableType>
 /** @public */
 export function useObservable<ObservableType extends Observable<any>>(
@@ -48,12 +54,16 @@ export function useObservable<ObservableType extends Observable<any>>(
 export function useObservable<ObservableType extends Observable<any>, InitialValue>(
   observable: ObservableType,
   initialValue: InitialValue | (() => InitialValue),
+  options?: UseObservableOptions,
 ): InitialValue | ObservedValueOf<ObservableType>
 /** @public */
 export function useObservable<ObservableType extends Observable<any>, InitialValue>(
   observable: ObservableType,
   initialValue?: InitialValue | (() => InitialValue),
+  options: UseObservableOptions = {},
 ): InitialValue | ObservedValueOf<ObservableType> {
+  const {disabled = false} = options
+
   const instance = useMemo(() => {
     if (!cache.has(observable)) {
       // This separate object is used as a stable reference to the cache entry's snapshot and error.
@@ -99,12 +109,16 @@ export function useObservable<ObservableType extends Observable<any>, InitialVal
 
   const subscribe = useCallback(
     (onStoreChange: () => void) => {
+      if (disabled) {
+        return () => {}
+      }
+
       const subscription = instance.observable.subscribe(onStoreChange)
       return () => {
         subscription.unsubscribe()
       }
     },
-    [instance.observable],
+    [instance.observable, disabled],
   )
 
   return useSyncExternalStore<ObservedValueOf<ObservableType>>(