@thi.ng/transducers-async 0.3.10 → 0.4.0

package/CHANGELOG.md

@@ -1,14 +1,22 @@
 # Change Log
 
-- **Last updated**: 2025-01-21T15:46:53Z
+- **Last updated**: 2025-01-29T16:25:48Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
+Only versions published since **2022-01-01** are listed here.
+Please consult the Git history for older version information.
 See [Conventional Commits](https://conventionalcommits.org/) for commit guidelines.
 
 **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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/transducers-async",
-  "version": "0.3.10",
+  "version": "0.4.0",
   "description": "Async versions of various highly composable transducers, reducers and iterators",
   "type": "module",
   "module": "./index.js",
@@ -33,26 +33,24 @@
     "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.17",
-    "@thi.ng/buffers": "^1.0.2",
-    "@thi.ng/checks": "^3.6.20",
-    "@thi.ng/compose": "^3.0.20",
-    "@thi.ng/errors": "^2.5.23",
-    "@thi.ng/timestamp": "^1.1.2",
-    "@thi.ng/transducers": "^9.2.15"
+    "@thi.ng/api": "^8.11.19",
+    "@thi.ng/buffers": "^1.0.4",
+    "@thi.ng/checks": "^3.6.22",
+    "@thi.ng/compose": "^3.0.22",
+    "@thi.ng/errors": "^2.5.25",
+    "@thi.ng/timestamp": "^1.1.4",
+    "@thi.ng/transducers": "^9.2.17"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.48.1",
     "esbuild": "^0.24.2",
     "typedoc": "^0.27.6",
-    "typescript": "^5.7.2"
+    "typescript": "^5.7.3"
   },
   "keywords": [
     "async",
@@ -213,5 +211,5 @@
     "status": "alpha",
     "year": 2018
   },
-  "gitHead": "22f6d518aed5951bb37b406c8ae85a6c3e6be517\n"
+  "gitHead": "fc1d498e8d4b690db873c30cc594352a804e7a65\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);