@talismn/util 0.0.0-pr2075-20250708160640 → 0.0.0-pr2075-20250709134044

package/dist/declarations/src/index.d.ts

@@ -30,3 +30,4 @@ export * from "./isNotNil";
 export * from "./isTruthy";
 export * from "./isAbortError";
 export * from "./getSharedObservable";
+export * from "./keepAlive";

package/dist/declarations/src/keepAlive.d.ts

@@ -0,0 +1,17 @@
+import type { MonoTypeOperatorFunction } from "rxjs";
+/**
+ * An RxJS operator that keeps the source observable alive for a specified duration
+ * after all subscribers have unsubscribed. This prevents expensive re-subscriptions
+ * when subscribers come and go frequently.
+ *
+ * @param keepAliveMs - Duration in milliseconds to keep the source alive after last unsubscription
+ * @returns MonoTypeOperatorFunction that can be used in pipe()
+ *
+ * @example
+ * ```typescript
+ * const data$ = expensive_api_call$.pipe(
+ *   keepAlive(3000) // Keep alive for 3 seconds
+ * );
+ * ```
+ */
+export declare const keepAlive: <T>(keepAliveMs: number) => MonoTypeOperatorFunction<T>;

package/dist/talismn-util.cjs.dev.js

@@ -345,6 +345,88 @@ const getSharedObservable = (namespace, args, createObservable, serializer = arg
   return sharedObs;
 };
 
+/**
+ * An RxJS operator that keeps the source observable alive for a specified duration
+ * after all subscribers have unsubscribed. This prevents expensive re-subscriptions
+ * when subscribers come and go frequently.
+ *
+ * @param keepAliveMs - Duration in milliseconds to keep the source alive after last unsubscription
+ * @returns MonoTypeOperatorFunction that can be used in pipe()
+ *
+ * @example
+ * ```typescript
+ * const data$ = expensive_api_call$.pipe(
+ *   keepAlive(3000) // Keep alive for 3 seconds
+ * );
+ * ```
+ */
+const keepAlive = keepAliveMs => {
+  return source => {
+    let refCount = 0;
+    let sourceSubscription = null;
+    let cleanupTimer = null;
+    let hasCompleted = false;
+    let hasErrored = false;
+    let error = null;
+    const cleanup = () => {
+      if (sourceSubscription) {
+        sourceSubscription.unsubscribe();
+        sourceSubscription = null;
+      }
+      cleanupTimer = null;
+      hasCompleted = false;
+      hasErrored = false;
+      error = null;
+    };
+    return new rxjs.Observable(subscriber => {
+      // Cancel any pending cleanup
+      if (cleanupTimer) {
+        clearTimeout(cleanupTimer);
+        cleanupTimer = null;
+      }
+      refCount++;
+
+      // Handle already completed/errored states
+      if (hasCompleted) {
+        subscriber.complete();
+        return () => {
+          refCount--;
+        };
+      }
+      if (hasErrored) {
+        subscriber.error(error);
+        return () => {
+          refCount--;
+        };
+      }
+
+      // Create source subscription if it doesn't exist
+      if (!sourceSubscription) {
+        sourceSubscription = source.subscribe({
+          next: value => {
+            subscriber.next(value);
+          },
+          error: err => {
+            hasErrored = true;
+            error = err;
+            subscriber.error(err);
+          },
+          complete: () => {
+            hasCompleted = true;
+            subscriber.complete();
+          }
+        });
+      }
+      return () => {
+        refCount--;
+        if (refCount === 0) {
+          cleanupTimer = setTimeout(cleanup, keepAliveMs);
+        }
+      };
+    });
+  };
+};
+
 exports.BigMath = BigMath;
 exports.Deferred = Deferred;
 exports.MAX_DECIMALS_FORMAT = MAX_DECIMALS_FORMAT;
@@ -370,6 +452,7 @@ exports.isEthereumAddress = isEthereumAddress;
 exports.isNotNil = isNotNil;
 exports.isTruthy = isTruthy;
 exports.isValidSubstrateAddress = isValidSubstrateAddress;
+exports.keepAlive = keepAlive;
 exports.normalizeAddress = normalizeAddress;
 exports.planckToTokens = planckToTokens;
 exports.sleep = sleep;

package/dist/talismn-util.cjs.prod.js

@@ -345,6 +345,88 @@ const getSharedObservable = (namespace, args, createObservable, serializer = arg
   return sharedObs;
 };
 
+/**
+ * An RxJS operator that keeps the source observable alive for a specified duration
+ * after all subscribers have unsubscribed. This prevents expensive re-subscriptions
+ * when subscribers come and go frequently.
+ *
+ * @param keepAliveMs - Duration in milliseconds to keep the source alive after last unsubscription
+ * @returns MonoTypeOperatorFunction that can be used in pipe()
+ *
+ * @example
+ * ```typescript
+ * const data$ = expensive_api_call$.pipe(
+ *   keepAlive(3000) // Keep alive for 3 seconds
+ * );
+ * ```
+ */
+const keepAlive = keepAliveMs => {
+  return source => {
+    let refCount = 0;
+    let sourceSubscription = null;
+    let cleanupTimer = null;
+    let hasCompleted = false;
+    let hasErrored = false;
+    let error = null;
+    const cleanup = () => {
+      if (sourceSubscription) {
+        sourceSubscription.unsubscribe();
+        sourceSubscription = null;
+      }
+      cleanupTimer = null;
+      hasCompleted = false;
+      hasErrored = false;
+      error = null;
+    };
+    return new rxjs.Observable(subscriber => {
+      // Cancel any pending cleanup
+      if (cleanupTimer) {
+        clearTimeout(cleanupTimer);
+        cleanupTimer = null;
+      }
+      refCount++;
+
+      // Handle already completed/errored states
+      if (hasCompleted) {
+        subscriber.complete();
+        return () => {
+          refCount--;
+        };
+      }
+      if (hasErrored) {
+        subscriber.error(error);
+        return () => {
+          refCount--;
+        };
+      }
+
+      // Create source subscription if it doesn't exist
+      if (!sourceSubscription) {
+        sourceSubscription = source.subscribe({
+          next: value => {
+            subscriber.next(value);
+          },
+          error: err => {
+            hasErrored = true;
+            error = err;
+            subscriber.error(err);
+          },
+          complete: () => {
+            hasCompleted = true;
+            subscriber.complete();
+          }
+        });
+      }
+      return () => {
+        refCount--;
+        if (refCount === 0) {
+          cleanupTimer = setTimeout(cleanup, keepAliveMs);
+        }
+      };
+    });
+  };
+};
+
 exports.BigMath = BigMath;
 exports.Deferred = Deferred;
 exports.MAX_DECIMALS_FORMAT = MAX_DECIMALS_FORMAT;
@@ -370,6 +452,7 @@ exports.isEthereumAddress = isEthereumAddress;
 exports.isNotNil = isNotNil;
 exports.isTruthy = isTruthy;
 exports.isValidSubstrateAddress = isValidSubstrateAddress;
+exports.keepAlive = keepAlive;
 exports.normalizeAddress = normalizeAddress;
 exports.planckToTokens = planckToTokens;
 exports.sleep = sleep;

package/dist/talismn-util.esm.js

@@ -2,7 +2,7 @@ import { u8aToHex, u8aConcat, u8aToU8a, hexToU8a } from '@polkadot/util';
 import { blake2AsU8a, isEthereumAddress as isEthereumAddress$1, ethereumEncode, decodeAddress as decodeAddress$1, base58Decode, checkAddressChecksum, xxhashAsU8a } from '@polkadot/util-crypto';
 import { twMerge } from 'tailwind-merge';
 import { encodeAddress, decodeAddress } from '@polkadot/keyring';
-import { concat, take, skip, debounceTime, shareReplay } from 'rxjs';
+import { concat, take, skip, debounceTime, shareReplay, Observable } from 'rxjs';
 import BigNumber from 'bignumber.js';
 
 const addTrailingSlash = url => {
@@ -339,4 +339,86 @@ const getSharedObservable = (namespace, args, createObservable, serializer = arg
   return sharedObs;
 };
 
-export { BigMath, Deferred, MAX_DECIMALS_FORMAT, addTrailingSlash, blake2Concat, classNames, convertAddress, decodeAnyAddress, decodeSs58Format, encodeAnyAddress, firstThenDebounce, formatDecimals, formatPrice, getSharedObservable, hasOwnProperty, isAbortError, isAddressEqual, isArrayOf, isAscii, isBigInt, isBooleanTrue, isEthereumAddress, isNotNil, isTruthy, isValidSubstrateAddress, normalizeAddress, planckToTokens, sleep, throwAfter, tokensToPlanck, twox64Concat, validateHexString };
+/**
+ * An RxJS operator that keeps the source observable alive for a specified duration
+ * after all subscribers have unsubscribed. This prevents expensive re-subscriptions
+ * when subscribers come and go frequently.
+ *
+ * @param keepAliveMs - Duration in milliseconds to keep the source alive after last unsubscription
+ * @returns MonoTypeOperatorFunction that can be used in pipe()
+ *
+ * @example
+ * ```typescript
+ * const data$ = expensive_api_call$.pipe(
+ *   keepAlive(3000) // Keep alive for 3 seconds
+ * );
+ * ```
+ */
+const keepAlive = keepAliveMs => {
+  return source => {
+    let refCount = 0;
+    let sourceSubscription = null;
+    let cleanupTimer = null;
+    let hasCompleted = false;
+    let hasErrored = false;
+    let error = null;
+    const cleanup = () => {
+      if (sourceSubscription) {
+        sourceSubscription.unsubscribe();
+        sourceSubscription = null;
+      }
+      cleanupTimer = null;
+      hasCompleted = false;
+      hasErrored = false;
+      error = null;
+    };
+    return new Observable(subscriber => {
+      // Cancel any pending cleanup
+      if (cleanupTimer) {
+        clearTimeout(cleanupTimer);
+        cleanupTimer = null;
+      }
+      refCount++;
+
+      // Handle already completed/errored states
+      if (hasCompleted) {
+        subscriber.complete();
+        return () => {
+          refCount--;
+        };
+      }
+      if (hasErrored) {
+        subscriber.error(error);
+        return () => {
+          refCount--;
+        };
+      }
+
+      // Create source subscription if it doesn't exist
+      if (!sourceSubscription) {
+        sourceSubscription = source.subscribe({
+          next: value => {
+            subscriber.next(value);
+          },
+          error: err => {
+            hasErrored = true;
+            error = err;
+            subscriber.error(err);
+          },
+          complete: () => {
+            hasCompleted = true;
+            subscriber.complete();
+          }
+        });
+      }
+      return () => {
+        refCount--;
+        if (refCount === 0) {
+          cleanupTimer = setTimeout(cleanup, keepAliveMs);
+        }
+      };
+    });
+  };
+};
+
+export { BigMath, Deferred, MAX_DECIMALS_FORMAT, addTrailingSlash, blake2Concat, classNames, convertAddress, decodeAnyAddress, decodeSs58Format, encodeAnyAddress, firstThenDebounce, formatDecimals, formatPrice, getSharedObservable, hasOwnProperty, isAbortError, isAddressEqual, isArrayOf, isAscii, isBigInt, isBooleanTrue, isEthereumAddress, isNotNil, isTruthy, isValidSubstrateAddress, keepAlive, normalizeAddress, planckToTokens, sleep, throwAfter, tokensToPlanck, twox64Concat, validateHexString };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talismn/util",
-  "version": "0.0.0-pr2075-20250708160640",
+  "version": "0.0.0-pr2075-20250709134044",
   "author": "Talisman",
   "homepage": "https://talisman.xyz",
   "license": "GPL-3.0-or-later",