@thi.ng/rstream 7.1.0 → 7.2.2

package/CHANGELOG.md

@@ -1,12 +1,29 @@
 # Change Log
 
-Last updated: 2021-11-17T23:24:59Z
+- **Last updated**: 2021-12-13T10:26:00Z
+- **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org/) for commit guidelines.
 
-**Note:** Unlisted _patch_ versions only involve non-code changes and/or
-version bumps of transitive dependencies.
+**Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
+and/or version bumps of transitive dependencies.
+
+## [7.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@7.2.0) (2021-11-21)
+
+#### 🚀 Features
+
+- update defWorker() arg types ([e07521e](https://github.com/thi-ng/umbrella/commit/e07521e))
+  - add `WorkerSource` type alias
+  - add support for zero-arg fns returning a worker instance
+    - helps v. much with Vite's `xxx?worker` imports
+    - see /examples/mandelbrot for usage
+
+### [7.1.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@7.1.1) (2021-11-19)
+
+#### 🩹 Bug fixes
+
+- add note about Awaited<T> type sig (1c82afa7e) ([efd8647](https://github.com/thi-ng/umbrella/commit/efd8647))
 
 ## [7.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@7.1.0) (2021-11-17)
 
@@ -720,7 +737,7 @@ version bumps of transitive dependencies.
 
 - minor fix StreamSync.addAll() ([cc286e1](https://github.com/thi-ng/umbrella/commit/cc286e1))
 
-## [1.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@1.6.0) (2018-04-25)
+## [1.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@1.6.0) (2018-04-24)
 
 #### 🚀 Features
 

package/api.d.ts

@@ -183,4 +183,5 @@ export interface IStream<T> extends ISubscriber<T> {
 }
 export declare type StreamCancel = () => void;
 export declare type StreamSource<T> = (sub: Stream<T>) => StreamCancel | void;
+export declare type WorkerSource = Worker | Blob | Fn0<Worker> | string;
 //# sourceMappingURL=api.d.ts.map

package/defworker.d.ts

@@ -1,3 +1,4 @@
+import type { WorkerSource } from "./api.js";
 export declare const defInlineWorker: (src: string) => Worker;
-export declare const defWorker: (worker: Worker | string | Blob) => Worker;
+export declare const defWorker: (worker: WorkerSource) => Worker;
 //# sourceMappingURL=defworker.d.ts.map

package/defworker.js

@@ -1,4 +1,7 @@
+import { isFunction } from "@thi.ng/checks/is-function";
 export const defInlineWorker = (src) => defWorker(new Blob([src], { type: "text/javascript" }));
 export const defWorker = (worker) => worker instanceof Worker
     ? worker
-    : new Worker(worker instanceof Blob ? URL.createObjectURL(worker) : worker);
+    : isFunction(worker)
+        ? worker()
+        : new Worker(worker instanceof Blob ? URL.createObjectURL(worker) : worker);

package/forkjoin.d.ts

@@ -1,5 +1,5 @@
 import type { ArrayLikeIterable, Fn, Fn3 } from "@thi.ng/api";
-import type { CommonOpts, ITransformable } from "./api.js";
+import type { CommonOpts, ITransformable, WorkerSource } from "./api.js";
 import type { Subscription } from "./subscription.js";
 export interface ForkJoinOpts<IN, MSG, RES, OUT> extends Partial<CommonOpts> {
     /**
@@ -38,7 +38,7 @@ export interface ForkJoinOpts<IN, MSG, RES, OUT> extends Partial<CommonOpts> {
      * string. In the latter two cases, a worker is created
      * automatically using `makeWorker()`.
      */
-    worker: string | Worker | Blob;
+    worker: WorkerSource;
     /**
      * Optional max number of workers to use. Defaults to
      * `navigator.hardwareConcurrency` (or if unavailable, then 4 as

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/rstream",
-  "version": "7.1.0",
+  "version": "7.2.2",
   "description": "Reactive streams & subscription primitives for constructing dataflow graphs / pipelines",
   "type": "module",
   "module": "./index.js",
@@ -30,26 +30,26 @@
     "doc:ae": "mkdir -p .ae/doc .ae/temp && api-extractor run --local --verbose",
     "doc:readme": "yarn doc:stats && tools:readme",
     "doc:stats": "tools:module-stats",
-    "pub": "yarn build && yarn npm publish --access public",
+    "pub": "yarn npm publish --access public",
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.0",
-    "@thi.ng/arrays": "^2.1.0",
-    "@thi.ng/associative": "^6.1.0",
-    "@thi.ng/atom": "^5.1.0",
-    "@thi.ng/checks": "^3.1.0",
-    "@thi.ng/errors": "^2.1.0",
-    "@thi.ng/logger": "^1.1.0",
-    "@thi.ng/transducers": "^8.1.0"
+    "@thi.ng/api": "^8.3.3",
+    "@thi.ng/arrays": "^2.1.3",
+    "@thi.ng/associative": "^6.1.4",
+    "@thi.ng/atom": "^5.1.3",
+    "@thi.ng/checks": "^3.1.3",
+    "@thi.ng/errors": "^2.1.3",
+    "@thi.ng/logger": "^1.1.3",
+    "@thi.ng/transducers": "^8.2.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.18.19",
-    "@thi.ng/testament": "^0.2.0",
+    "@microsoft/api-extractor": "^7.19.2",
+    "@thi.ng/testament": "^0.2.3",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.22.8",
-    "typescript": "^4.4.4"
+    "typedoc": "^0.22.10",
+    "typescript": "^4.5.3"
   },
   "keywords": [
     "async",
@@ -201,5 +201,5 @@
     ],
     "year": 2017
   },
-  "gitHead": "519eedf95c076202f3429eb8e46ccff275bfe446\n"
+  "gitHead": "1ba92c6b9509e74e509b4c0b875fc380a97bbbc1\n"
 }

package/promises.d.ts

@@ -1,12 +1,15 @@
 import type { ISubscription, WithErrorHandlerOpts } from "./api.js";
 /**
- * Wraps given iterable in `Promise.all()` to yield {@link Stream} of
- * results in same order as arguments, then closes.
+ * Wraps given iterable in `Promise.all()` to yield {@link Stream} of results in
+ * same order as arguments, then closes.
  *
  * @remarks
- * If any of the promises rejects, all others will do so too. In this
- * case the stream calls {@link ISubscriber.error} in all of its
- * subscribers.
+ * If any of the promises rejects, all others will do so too. In this case the
+ * stream calls {@link ISubscriber.error} in all of its subscribers.
+ *
+ * @remarks
+ * Type signature updated to use `Awaited<T>`, a new core type introduced in
+ * TypeScript 4.5.
  *
  * @example
  * ```ts
@@ -36,5 +39,5 @@ import type { ISubscription, WithErrorHandlerOpts } from "./api.js";
  * @param promises -
  * @param opts -
  */
-export declare const fromPromises: <T>(promises: Iterable<T | PromiseLike<T>>, opts?: Partial<WithErrorHandlerOpts> | undefined) => ISubscription<T[], T>;
+export declare const fromPromises: <T>(promises: Iterable<T | PromiseLike<T>>, opts?: Partial<WithErrorHandlerOpts> | undefined) => ISubscription<Awaited<T>[], Awaited<T>>;
 //# sourceMappingURL=promises.d.ts.map

package/promises.js

@@ -2,13 +2,16 @@ import { mapcat } from "@thi.ng/transducers/mapcat";
 import { __optsWithID } from "./idgen.js";
 import { fromPromise } from "./promise.js";
 /**
- * Wraps given iterable in `Promise.all()` to yield {@link Stream} of
- * results in same order as arguments, then closes.
+ * Wraps given iterable in `Promise.all()` to yield {@link Stream} of results in
+ * same order as arguments, then closes.
  *
  * @remarks
- * If any of the promises rejects, all others will do so too. In this
- * case the stream calls {@link ISubscriber.error} in all of its
- * subscribers.
+ * If any of the promises rejects, all others will do so too. In this case the
+ * stream calls {@link ISubscriber.error} in all of its subscribers.
+ *
+ * @remarks
+ * Type signature updated to use `Awaited<T>`, a new core type introduced in
+ * TypeScript 4.5.
  *
  * @example
  * ```ts

package/tunnel.d.ts

@@ -1,11 +1,11 @@
-import type { Fn } from "@thi.ng/api";
+import type { Fn, Fn0 } from "@thi.ng/api";
 import { Subscription } from "./subscription.js";
 export interface TunnelOpts<A> {
     /**
      * Tunnelled worker instance, source blob or script URL.
      * If `interrupt` is enabled, the worker MUST be given as blob or URL.
      */
-    src: Worker | Blob | string;
+    src: Worker | Blob | string | Fn0<Worker>;
     /**
      * Max. number of worker instances to use. Only useful if
      * `interrupt` is disabled. If more than one worker is used,
@@ -62,7 +62,7 @@ export declare const tunnel: <A, B>(opts: TunnelOpts<A>) => Tunnel<A, B>;
  */
 export declare class Tunnel<A, B> extends Subscription<A, B> {
     workers: Worker[];
-    src: Worker | Blob | string;
+    src: Worker | Blob | string | Fn0<Worker>;
     transferables?: Fn<A, any[]>;
     terminate: number;
     interrupt: boolean;

package/worker.d.ts

@@ -1,4 +1,4 @@
-import type { WithErrorHandlerOpts } from "./api.js";
+import type { WithErrorHandlerOpts, WorkerSource } from "./api.js";
 export interface FromWorkerOpts extends WithErrorHandlerOpts {
     /**
      * If true, the worker will be terminated when the stream
@@ -31,5 +31,5 @@ export interface FromWorkerOpts extends WithErrorHandlerOpts {
  * @param worker -
  * @param opts -
  */
-export declare const fromWorker: <T>(worker: Worker | Blob | string, opts?: Partial<FromWorkerOpts> | undefined) => import("./stream.js").Stream<T>;
+export declare const fromWorker: <T>(worker: WorkerSource, opts?: Partial<FromWorkerOpts> | undefined) => import("./stream.js").Stream<T>;
 //# sourceMappingURL=worker.d.ts.map