@thi.ng/rstream 8.3.19 → 8.4.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-03-27T09:53:45Z
+- **Last updated**: 2024-04-11T12:32:44Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,18 @@ 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.
 
+## [8.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@8.4.0) (2024-04-11)
+
+#### 🚀 Features
+
+- add fromAsync() / asAsync() converters & tests ([df57056](https://github.com/thi-ng/umbrella/commit/df57056))
+
+### [8.3.20](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@8.3.20) (2024-04-08)
+
+#### ♻️ Refactoring
+
+- update reducer handling due to updates in [@thi.ng/transducers](https://github.com/thi-ng/umbrella/tree/main/packages/transducers) pkg ([e0e5654](https://github.com/thi-ng/umbrella/commit/e0e5654))
+
 ### [8.3.6](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@8.3.6) (2024-02-22)
 
 #### ♻️ 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 190 standalone projects, maintained as part
+> This is one of 192 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -194,7 +194,13 @@ src.transformTopic("foo", map((e) => e.value), { error: handleError })
 yarn add @thi.ng/rstream
 ```
 
-ES module import:
+ESM import:
+
+```ts
+import * as rs from "@thi.ng/rstream";
+```
+
+Browser ESM import:
 
 ```html
 <script type="module" src="https://cdn.skypack.dev/@thi.ng/rstream"></script>
@@ -205,10 +211,10 @@ ES module import:
 For Node.js REPL:
 
 ```js
-const rstream = await import("@thi.ng/rstream");
+const rs = await import("@thi.ng/rstream");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 6.16 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 6.32 KB
 
 ## Dependencies
 

package/api.d.ts

@@ -75,7 +75,7 @@ export interface TransformableOpts<A, B> extends CommonOpts, WithTransform<A, B>
 export type ErrorHandler = Fn<any, boolean>;
 export interface WithErrorHandler {
     /**
-     * Optional error handler to use for this
+     * Optional error handler to use for this stream/subscription
      */
     error: ErrorHandler;
 }

package/async.d.ts

@@ -0,0 +1,17 @@
+import { type ISubscription, type WithErrorHandlerOpts } from "./api.js";
+/**
+ * Creates a new {@link stream} from given async iterable `src` and `opts`.
+ *
+ * @param src
+ * @param opts
+ */
+export declare const fromAsync: <T>(src: AsyncIterable<T>, opts?: Partial<WithErrorHandlerOpts>) => import("./stream.js").Stream<T>;
+/**
+ * Reverse operation of {@link fromAsync}. Returns an async iterator which
+ * subscribes to given `src` sub and yields values as long as the `src` is
+ * intact.
+ *
+ * @param src
+ */
+export declare function asAsync<T>(src: ISubscription<any, T>): AsyncGenerator<Awaited<T>, void, unknown>;
+//# sourceMappingURL=async.d.ts.map

package/async.js

@@ -0,0 +1,57 @@
+import { SEMAPHORE } from "@thi.ng/api/api";
+import { State } from "./api.js";
+import { stream } from "./stream.js";
+const fromAsync = (src, opts) => stream(($stream) => {
+  let active = true;
+  (async () => {
+    try {
+      for await (let x of src) {
+        if (!active)
+          return;
+        $stream.next(x);
+      }
+      $stream.done();
+    } catch (e) {
+      $stream.error(e);
+    }
+  })();
+  return () => active = false;
+}, opts);
+async function* asAsync(src) {
+  let resolve;
+  let initial;
+  const $newInitial = () => {
+    return initial = new Promise(($resolve) => {
+      resolve = $resolve;
+    });
+  };
+  const promises = [$newInitial()];
+  src.subscribe({
+    next(x) {
+      if (initial) {
+        resolve(x);
+        initial = void 0;
+      } else
+        promises.push(Promise.resolve(x));
+    },
+    done() {
+      if (initial) {
+        resolve(SEMAPHORE);
+        initial = void 0;
+      } else
+        promises.push(Promise.resolve(SEMAPHORE));
+    }
+  });
+  while (promises.length && src.getState() < State.ERROR) {
+    const res = await promises.shift();
+    if (res === SEMAPHORE)
+      break;
+    if (!promises.length)
+      promises[0] = $newInitial();
+    yield res;
+  }
+}
+export {
+  asAsync,
+  fromAsync
+};

package/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./api.js";
 export * from "./asidechain.js";
+export * from "./async.js";
 export * from "./atom.js";
 export * from "./bisect.js";
 export * from "./checks.js";

package/index.js

@@ -1,5 +1,6 @@
 export * from "./api.js";
 export * from "./asidechain.js";
+export * from "./async.js";
 export * from "./atom.js";
 export * from "./bisect.js";
 export * from "./checks.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/rstream",
-  "version": "8.3.19",
+  "version": "8.4.0",
   "description": "Reactive streams & subscription primitives for constructing dataflow graphs / pipelines",
   "type": "module",
   "module": "./index.js",
@@ -40,14 +40,14 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.31",
-    "@thi.ng/arrays": "^2.9.1",
-    "@thi.ng/associative": "^6.3.54",
-    "@thi.ng/atom": "^5.2.41",
-    "@thi.ng/checks": "^3.5.5",
-    "@thi.ng/errors": "^2.5.2",
-    "@thi.ng/logger": "^3.0.7",
-    "@thi.ng/transducers": "^8.9.18"
+    "@thi.ng/api": "^8.10.1",
+    "@thi.ng/arrays": "^2.9.3",
+    "@thi.ng/associative": "^6.3.56",
+    "@thi.ng/atom": "^5.2.43",
+    "@thi.ng/checks": "^3.6.1",
+    "@thi.ng/errors": "^2.5.4",
+    "@thi.ng/logger": "^3.0.9",
+    "@thi.ng/transducers": "^9.0.1"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.43.0",
@@ -94,6 +94,9 @@
     "./asidechain": {
       "default": "./asidechain.js"
     },
+    "./async": {
+      "default": "./async.js"
+    },
     "./atom": {
       "default": "./atom.js"
     },
@@ -207,6 +210,7 @@
     }
   },
   "thi.ng": {
+    "alias": "rs",
     "related": [
       "atom",
       "hdom",
@@ -215,5 +219,5 @@
     ],
     "year": 2017
   },
-  "gitHead": "ce5ae2a322d50a7ce8ecccbd94fa55c496ba04fd\n"
+  "gitHead": "18a0c063a7b33d790e5bc2486c106f45f663ac28\n"
 }

package/subscription.d.ts

@@ -60,7 +60,7 @@ export declare class Subscription<A, B> implements ISubscription<A, B> {
     closeOut: CloseMode;
     parent?: ISubscription<any, A>;
     __owner?: ISubscription<any, any>;
-    protected xform?: Reducer<B[], A>;
+    protected xform?: Reducer<A, B[]>;
     protected cacheLast: boolean;
     protected last: any;
     protected state: State;

package/transduce.d.ts

@@ -27,5 +27,5 @@ import type { Subscription } from "./subscription.js";
  * @param rfn -
  * @param init -
  */
-export declare const transduce: <A, B, C>(src: Subscription<any, A>, xform: Transducer<A, B>, rfn: Reducer<C, B>, init?: C) => Promise<C>;
+export declare const transduce: <A, B, C>(src: Subscription<any, A>, xform: Transducer<A, B>, rfn: Reducer<B, C>, init?: C) => Promise<C>;
 //# sourceMappingURL=transduce.d.ts.map