@thi.ng/transducers-async 0.3.11 → 0.4.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-01-23T13:39:11Z
+- **Last updated**: 2025-02-13T16:03:11Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [0.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers-async@0.4.0) (2025-01-29)
+
+#### 🚀 Features
+
+- add PubSub.subscribeOnce(), add tests ([34beec5](https://github.com/thi-ng/umbrella/commit/34beec5))
+
 ### [0.3.8](https://github.com/thi-ng/umbrella/tree/@thi.ng/transducers-async@0.3.8) (2025-01-14)
 
 #### ♻️ Refactoring

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 200 standalone projects, maintained as part
+> This is one of 201 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -116,7 +116,7 @@ For Node.js REPL:
 const txa = await import("@thi.ng/transducers-async");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 3.22 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 3.25 KB
 
 ## Dependencies
 

package/delayed.d.ts

@@ -1,6 +1,8 @@
 /**
- * Same as [thi.ng/compose `delayed()`](). Re-exported for convenience. Yields
- * `x` as promise which only resolves after `delay` milliseconds.
+ * Same as [thi.ng/compose
+ * `delayed()`](https://docs.thi.ng/umbrella/compose/functions/delayed.html).
+ * Re-exported for convenience. Yields `x` as promise which only resolves after
+ * `delay` milliseconds.
  *
  * @remarks
  * Also see {@link wait}.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers-async",
-  "version": "0.3.11",
+  "version": "0.4.1",
   "description": "Async versions of various highly composable transducers, reducers and iterators",
   "type": "module",
   "module": "./index.js",
@@ -33,24 +33,23 @@
     "build:esbuild": "esbuild --format=esm --platform=neutral --target=es2022 --tsconfig=tsconfig.json --outdir=. src/**/*.ts",
     "clean": "bun ../../tools/src/clean-package.ts",
     "doc": "typedoc --options ../../typedoc.json --out doc src/index.ts",
-    "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
     "doc:readme": "bun ../../tools/src/module-stats.ts && bun ../../tools/src/readme.ts",
     "pub": "yarn npm publish --access public",
     "test": "bun test",
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.18",
-    "@thi.ng/buffers": "^1.0.3",
-    "@thi.ng/checks": "^3.6.21",
-    "@thi.ng/compose": "^3.0.21",
-    "@thi.ng/errors": "^2.5.24",
-    "@thi.ng/timestamp": "^1.1.3",
-    "@thi.ng/transducers": "^9.2.16"
+    "@thi.ng/api": "^8.11.20",
+    "@thi.ng/buffers": "^1.0.5",
+    "@thi.ng/checks": "^3.6.23",
+    "@thi.ng/compose": "^3.0.23",
+    "@thi.ng/errors": "^2.5.26",
+    "@thi.ng/timestamp": "^1.1.5",
+    "@thi.ng/transducers": "^9.2.18"
   },
   "devDependencies": {
-    "esbuild": "^0.24.2",
-    "typedoc": "^0.27.6",
+    "esbuild": "^0.25.0",
+    "typedoc": "^0.27.7",
     "typescript": "^5.7.3"
   },
   "keywords": [
@@ -212,5 +211,5 @@
     "status": "alpha",
     "year": 2018
   },
-  "gitHead": "b92b48abda9941d608be8a2e1c83447e679a6f79\n"
+  "gitHead": "9a0b33253fef092aaf301decf6ecd54317874d4c\n"
 }

package/pubsub.d.ts

@@ -14,6 +14,16 @@ export declare class PubSub<K, V> {
      * {@link PubSub.unsubscribeTopic}.
      */
     subscribeTopic(id: K): AsyncIterable<V>;
+    /**
+     * Similar to {@link PubSub.subscribeTopic}, but for one-off event handling.
+     * Creates a new subscription for topic `id` and waits for next value. Once
+     * received, it immediately unsubscribes again and then calls `fn` with
+     * value.
+     *
+     * @param id
+     * @param fn
+     */
+    subscribeOnce(id: K, fn: Fn<V, void>): void;
     /**
      * Attempts to remove given child subscription (presumably created via
      * {@link PubSub.subscribeTopic}). Returns true if removal was successful.

package/pubsub.js

@@ -26,6 +26,25 @@ class PubSub {
     }
     return sub;
   }
+  /**
+   * Similar to {@link PubSub.subscribeTopic}, but for one-off event handling.
+   * Creates a new subscription for topic `id` and waits for next value. Once
+   * received, it immediately unsubscribes again and then calls `fn` with
+   * value.
+   *
+   * @param id
+   * @param fn
+   */
+  subscribeOnce(id, fn) {
+    const sub = this.subscribeTopic(id);
+    const $this = this;
+    (async () => {
+      for await (let x of sub) {
+        $this.unsubscribeTopic(id, sub);
+        fn(x);
+      }
+    })();
+  }
   /**
    * Attempts to remove given child subscription (presumably created via
    * {@link PubSub.subscribeTopic}). Returns true if removal was successful.
@@ -35,7 +54,7 @@ class PubSub {
   unsubscribeTopic(id, sub) {
     const subs = this.topics.get(id);
     if (!subs) return false;
-    const idx = subs.findIndex((x) => x === sub) ?? -1;
+    const idx = subs.findIndex((x) => x === sub);
     if (idx >= 0) {
       subs.splice(idx, 1);
       sub.resolve(void 0);

package/raf.d.ts

@@ -4,17 +4,17 @@ export interface RAFOpts {
     /**
      * If true (default: false), passes the timestamps received
      * via `requestAnimationFrame()` as iterator values. If false, a simple
-     * counter [0..∞) will be emitted.
+     * counter `[0,∞)` will be emitted.
      *
      * @defaultValue false
      */
     timestamp: boolean;
     /**
-     * Only used if {@link RAFOpts.timestamp} is enabled. If given as
-     * number, the value will be subtracted from all emitted timestamps. If this
-     * option is set to true, the timestamps will be automatically zero-adjusted
-     * such that the first emitted value will be zero. If undefined (default),
-     * the browser supplied timestamps will be used as is.
+     * Only used if {@link RAFOpts.timestamp} is enabled. If given as number,
+     * the value will be subtracted from all emitted timestamps. If this option
+     * is set to true, the timestamps will be automatically zero-adjusted such
+     * that the first emitted value will be zero. If undefined (default), the
+     * browser supplied timestamps will be used as is.
      */
     t0: number | boolean;
 }

package/source.d.ts

@@ -48,7 +48,7 @@ export interface Source<T> extends ClosableAsyncGenerator<T>, IDeref<Maybe<T>> {
  * @remarks
  * See [thi.ng/buffers](https://thi.ng/buffers) for available buffer
  * implementations. By default a
- * [`fifo()`](https://docs.thi.ng/umbrella/buffers/functions/fifo.html) buffer
+ * [`fifo`](https://docs.thi.ng/umbrella/buffers/functions/fifo.html) buffer
  * with capacity=1 is used.
  *
  * If `initial` is given, the source will immediately deliver this value once a