@fbltd/async 1.0.18 → 1.0.21

package/README.md

@@ -67,20 +67,25 @@ setInterval(() => {
 }, 1000)
 ```
 
+#### Stream utils
+##### onceStream
+##### raceStream
+##### next
+
 #### Framework integrations
 ##### React
-Of course, there is a React integration via useStream hook:
+Of course, there is a React integration via stream hooks.
+For example, here is classic react counter implementation via useRaceStream hook.
 
 ```typescript jsx
 type IController = {
-    controller: SomeController,
+    dependecy: Dependency,
 }
 export const Counter: React.FC<ITest> = React.memo(({
-                                                        controller,
+                                                        dependency,
                                                     }) => {
     // num is an instance of DependencyStream
-    const num = controller.num;
-    const {value, dispose} = useStream(num);
+    const {value, dispose} = useRaceStream({dependency});
 
     // resolving promises on component unmounting
     // This is won't cause of rerender
@@ -91,7 +96,7 @@ export const Counter: React.FC<ITest> = React.memo(({
             <button className={"incrementer"}
                 // Now result is array of streams values
                 // It should be object
-                    onClick={() => num.set(value![0] + 1)}>
+                    onClick={() => dependency.value++}>
                 +
             </button>
 
@@ -100,7 +105,7 @@ export const Counter: React.FC<ITest> = React.memo(({
                     // Now result is array of streams values
                     // It should be object                    
                 }
-                {value![0]}
+                {value.dependency}
             </div>
         </div>
     )

package/dist/bin/dependency-stream/index.js

@@ -1,4 +1,4 @@
 export * from "./dependency.js";
 export * from "./dependency.stream.js";
-export * from "./utils/index.js";
+export * from "./stream-utils/index.js";
 export * from "./integrations/index.js";

package/dist/bin/dependency-stream/integrations/react/index.js

@@ -1,17 +1 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./src/index.js"), exports);
+export * from "./use-race.stream.js";

package/dist/bin/dependency-stream/integrations/react/race-stream.controller.js

@@ -0,0 +1,34 @@
+import { isObjectsContentEqual } from "./utils.js";
+import { raceStream } from "../../stream-utils/index.js";
+export class RaceStreamController {
+    _value;
+    isFirstWas = false;
+    rerenderTrigger;
+    deps;
+    iterator;
+    constructor(streams) {
+        this.deps = streams;
+        this.init();
+    }
+    get value() {
+        return this._value;
+    }
+    async init() {
+        this.iterator = raceStream(this.deps);
+        this._value = Object.entries(this.deps)
+            .reduce((acc, [key, dep]) => {
+            acc[key] = dep.value;
+            return acc;
+        }, {});
+        for await (let value of this.iterator) {
+            this.rerenderTrigger?.(prev => !prev);
+            if (!this.isFirstWas && !isObjectsContentEqual(this._value, value)) {
+                this._value = value;
+            }
+            this.isFirstWas = true;
+        }
+    }
+    dispose = () => {
+        this.iterator.dispose();
+    };
+}

package/dist/bin/dependency-stream/integrations/react/use-race.stream.js

@@ -0,0 +1,17 @@
+import { useEffect, useState } from "react";
+import { RaceStreamController } from "./race-stream.controller.js";
+export function useRaceStream(deps) {
+    const [obj] = useState(() => ({ controller: new RaceStreamController(deps) }));
+    const [, setValue] = useState(false);
+    obj.controller.rerenderTrigger = setValue;
+    useEffect(() => {
+        return () => {
+            obj.controller.dispose();
+            obj.controller = undefined;
+        };
+    }, []);
+    return {
+        value: obj.controller.value,
+        dispose: obj.controller.dispose,
+    };
+}

package/dist/bin/dependency-stream/integrations/react/utils.js

@@ -0,0 +1,7 @@
+export function isObjectsContentEqual(obj1, obj2) {
+    for (let key in obj1) {
+        if (obj1[key] !== obj2[key])
+            return false;
+    }
+    return true;
+}

package/dist/bin/dependency-stream/stream-utils/contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/bin/dependency-stream/{utils → stream-utils}/index.js

@@ -1,3 +1,4 @@
 export * from "./once.stream.js";
 export * from "./race.stream.js";
 export * from "./next.js";
+export * from "./contracts.js";

package/dist/bin/dependency-stream/stream-utils/race.stream.js

@@ -0,0 +1,36 @@
+import { symAI } from "../../constants.js";
+import { PromiseConfiguration } from "../../promise-configuration.js";
+export function raceStream(deps) {
+    let externalDispose = new PromiseConfiguration();
+    const [keys, streams] = Object
+        .entries(deps)
+        .reduce((acc, [key, dep]) => {
+        acc[0].push(key);
+        acc[1].push(dep[symAI]({ externalDispose }));
+        return acc;
+    }, [[], []]);
+    function isDisposed() {
+        return streams.some((s) => s.isDisposed);
+    }
+    return {
+        dispose: () => !isDisposed() && externalDispose.resolve({ done: true, value: void 0 }),
+        get isDisposed() {
+            return isDisposed();
+        },
+        [symAI]() {
+            return {
+                next: async () => {
+                    const res = await Promise.race(streams.map(s => s.next()));
+                    if (res.done) {
+                        return res;
+                    }
+                    const value = keys.reduce((acc, key) => {
+                        acc[key] = deps[key].value;
+                        return acc;
+                    }, {});
+                    return { done: false, value };
+                }
+            };
+        }
+    };
+}

package/dist/types/dependency-stream/dependency.d.ts

@@ -1,4 +1,4 @@
-import { IAllStreamConfig, IThisStreamConfig } from "./contracts.ts";
+import { IAllStreamConfig, IStreamIterator, IThisStreamConfig } from "./contracts.ts";
 import { DependencyStream } from "./dependency.stream.ts";
 export declare class Dependency<T = any> {
     private _value;
@@ -10,17 +10,6 @@ export declare class Dependency<T = any> {
     set value(v: T);
     get value(): T;
     getStream(this: Dependency<T>): DependencyStream<T>;
-    [Symbol.asyncIterator](this: Dependency<T>, thisStreamConfig?: IThisStreamConfig): {
-        owner: Dependency<T>;
-        dispose: () => void;
-        readonly isDisposed: boolean;
-        next: () => Promise<{
-            done: true;
-            value: void;
-        } | {
-            done: boolean;
-            readonly value: T;
-        }>;
-    };
+    [Symbol.asyncIterator](this: Dependency<T>, thisStreamConfig?: IThisStreamConfig): IStreamIterator<T>;
     dispose(this: Dependency<T>): void;
 }

package/dist/types/dependency-stream/index.d.ts

@@ -1,4 +1,4 @@
 export * from './dependency.ts';
 export * from './dependency.stream.ts';
-export * from './utils/index.ts';
+export * from './stream-utils/index.ts';
 export * from './integrations/index.ts';

package/dist/types/dependency-stream/integrations/react/index.d.ts

@@ -1 +1 @@
-export * from './src/index.ts';
+export * from './use-race.stream.ts';

package/dist/types/dependency-stream/integrations/react/race-stream.controller.d.ts

@@ -0,0 +1,13 @@
+import { Dispatch, SetStateAction } from "react";
+import { IDepObjectArgument, IDepObjectReturn, raceStream } from "../../stream-utils/index.ts";
+export declare class RaceStreamController<T extends IDepObjectArgument> {
+    private _value;
+    private isFirstWas;
+    rerenderTrigger?: Dispatch<SetStateAction<boolean>>;
+    deps: T;
+    iterator: ReturnType<typeof raceStream<T>>;
+    constructor(streams: T);
+    get value(): IDepObjectReturn<T>;
+    init(): Promise<void>;
+    dispose: () => void;
+}

package/dist/types/dependency-stream/integrations/react/use-race.stream.d.ts

@@ -0,0 +1,5 @@
+import { IDepObjectArgument, IDepObjectReturn } from "../../index.ts";
+export declare function useRaceStream<T extends IDepObjectArgument>(deps: T): {
+    value: IDepObjectReturn<T>;
+    dispose: Function;
+};

package/dist/types/dependency-stream/integrations/react/utils.d.ts

@@ -0,0 +1 @@
+export declare function isObjectsContentEqual<T extends {}>(obj1: T, obj2: T): boolean;

package/dist/types/dependency-stream/stream-utils/contracts.d.ts

@@ -0,0 +1,7 @@
+import { Dependency } from "../dependency.js";
+export type IDepObjectArgument = {
+    [key: string]: Dependency;
+};
+export type IDepObjectReturn<T extends IDepObjectArgument> = {
+    [Key in keyof T]: T[Key]['value'];
+};

package/dist/types/dependency-stream/{utils → stream-utils}/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./once.stream.ts";
 export * from "./race.stream.ts";
 export * from "./next.ts";
+export * from "./contracts.ts";

package/dist/types/dependency-stream/stream-utils/race.stream.d.ts

@@ -0,0 +1,3 @@
+import { IDependencyStream } from "../contracts.js";
+import { IDepObjectArgument, IDepObjectReturn } from "./contracts.js";
+export declare function raceStream<T extends IDepObjectArgument>(deps: T): IDependencyStream<IDepObjectReturn<T>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fbltd/async",
-  "version": "1.0.18",
+  "version": "1.0.21",
   "description": "Miscellaneous async utils",
   "homepage": "https://github.com/GlennMiller1991/async",
   "type": "module",
@@ -24,8 +24,8 @@
     "clearDist": "rm dist -rf || true",
     "clearModules": "rm node_modules -rf || true",
     "clearAll": "npm run clearDist && npm run clearModules",
-    "build": "cd src/dependency-stream/integrations/react && npm run build && cd ../../../../ && npm run clearAll && npm i && mkdir dist && tsc",
-    "test": "jest --config=./__tests__/jest.config.cjs",
+    "build": "npm run clearAll && npm i && mkdir dist && tsc",
+    "test": "node --expose-gc node_modules/.bin/jest --config=./__tests__/jest.config.cjs",
     "postVersionCommit": "git commit -m='post version commit' || true",
     "postVersionPush": "git push || true",
     "patch": "npm version patch && npm run postVersionCommit && npm run postVersionPush",
@@ -33,7 +33,11 @@
   },
   "author": "",
   "license": "ISC",
+  "dependencies": {
+    "react": "^19.x.x"
+  },
   "devDependencies": {
+    "@types/react": "^19.x.x",
     "@types/jest": "^30.0.0",
     "jest": "^30.0.4",
     "ts-jest": "^29.4.0",

package/dist/bin/dependency-stream/integrations/react/src/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./use-stream.js"), exports);

package/dist/bin/dependency-stream/integrations/react/src/use-stream.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useStream = useStream;
-const index_1 = require("../../../index");
-const react_1 = require("react");
-class StreamController {
-    setValue;
-    streams;
-    iterator;
-    constructor(...streams) {
-        this.streams = streams;
-        this.init();
-    }
-    async init() {
-        this.iterator = (0, index_1.raceStream)(...this.streams);
-        for await (let chunk of this.iterator) {
-            console.log(chunk);
-            this.setValue?.(chunk);
-        }
-    }
-    dispose = () => {
-        this.iterator?.dispose();
-    };
-}
-function useStream(...streams) {
-    const [value, setValue] = (0, react_1.useState)(streams.map(s => s.value));
-    const [obj] = (0, react_1.useState)(() => ({ controller: new StreamController(...streams) }));
-    obj.controller.setValue = setValue;
-    (0, react_1.useEffect)(() => {
-        return () => {
-            obj.controller.dispose();
-            obj.controller = undefined;
-        };
-    }, []);
-    return {
-        value,
-        dispose: obj.controller.dispose,
-    };
-}

package/dist/bin/dependency-stream/utils/race.stream.js

@@ -1,25 +0,0 @@
-import { symAI } from "../../constants.js";
-import { PromiseConfiguration } from "../../promise-configuration.js";
-export function raceStream(...deps) {
-    let selfDisposePromise = new PromiseConfiguration();
-    let isDisposed = false;
-    const streams = deps.map((dep) => dep[symAI]({
-        externalDispose: selfDisposePromise
-    }));
-    return {
-        dispose: () => selfDisposePromise.resolve({ done: true, value: void 0 }),
-        get isDisposed() {
-            return isDisposed;
-        },
-        [symAI]() {
-            return {
-                next: async () => {
-                    const res = await Promise.race([selfDisposePromise.promise, ...streams.map(s => s.next())]);
-                    if (res.done)
-                        return res;
-                    return { done: false, value: streams.map(s => s.owner.value) };
-                }
-            };
-        }
-    };
-}

package/dist/types/dependency-stream/integrations/react/src/index.d.ts

@@ -1 +0,0 @@
-export * from './use-stream.ts';

package/dist/types/dependency-stream/integrations/react/src/use-stream.d.ts

@@ -1,5 +0,0 @@
-import { Dependency } from "../../../index";
-export declare function useStream(...streams: Dependency[]): {
-    value: Array<any> | undefined;
-    dispose: () => void;
-};

package/dist/types/dependency-stream/utils/race.stream.d.ts

@@ -1,12 +0,0 @@
-import { Dependency } from "../dependency.ts";
-import { symAI } from "../../constants.ts";
-export declare function raceStream<TArray extends Dependency[]>(...deps: NoInfer<TArray>): {
-    dispose: () => void;
-    readonly isDisposed: boolean;
-    [Symbol.asyncIterator](): {
-        next: () => Promise<{
-            done: boolean;
-            readonly value: any;
-        }>;
-    };
-};