rxfy 0.2.0 → 0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # rxfy
 
-rxfy (/ɑɹ ɪks faɪ/) — observables-based data flow management
+rxfy (/ɑɹ ɪks faɪ/) — stream-based data management. it utilizes rxjs under the hood.
 
 # install
 
@@ -12,3 +12,18 @@ rxfy (/ɑɹ ɪks faɪ/) — observables-based data flow management
 - Lens — lensed atom with getter and setter
 - Store — where all the data stored
 - Edge — data handler and accessor
+
+# example
+
+```ts
+import PQueue from "p-queue";
+import { of } from "rxjs";
+import { createAtom, createState, createStore } from "rxfy";
+
+const queue = new PQueue({ concurrency: 5 });
+const state = createAtom(createState({}));
+const store = createStore(queue, state);
+const userStore = store.factory("users", (id) => of({ id }));
+const user$ = userStore.get("42").toObservable();
+user$.subscribe((x) => console.log(x));
+```

package/dist/index.cjs

@@ -4883,6 +4883,31 @@ function createStore(queue, state$) {
       });
       return createStore(queue, lens);
     },
+    factory: (name, loader) => {
+      const cache = Map().asMutable();
+      return {
+        get: (key) => {
+          if (!cache.has(key)) {
+            const lens = createLens(
+              createLens(state$, {
+                get: (x) => {
+                  const value = x.value[name];
+                  return value ?? toBranded("edge", createIdle());
+                },
+                set: (x, xs) => ({
+                  ...xs,
+                  value: { ...xs.value, [name]: x }
+                })
+              }),
+              keyLens("value")
+            );
+            const edge = createEdge(lens, queue, () => loader(key));
+            cache.set(key, edge);
+          }
+          return cache.get(key);
+        }
+      };
+    },
     factoryBatch: (name, batch) => {
       const lens = createLens(state$, {
         get: (x) => x.value[name] ?? toBranded("map", {}),

package/dist/index.d.cts

@@ -73,6 +73,7 @@ type IStore<TState extends IStoreStateJS> = {
     state$: IAtom<TState>;
     collect: () => Promise<void>;
     node: (name: string) => IStore<IStoreStateJS>;
+    factory: <TData>(name: string, loader: (key: string) => Observable<TData>) => IFactory<TData>;
     factoryBatch: <TData>(name: string, batch: (key: string[]) => Observable<Record<string, TData>>) => IFactory<TData>;
 };
 declare function createState(val: IStoreState): IStoreStateJS;

package/dist/index.d.ts

@@ -73,6 +73,7 @@ type IStore<TState extends IStoreStateJS> = {
     state$: IAtom<TState>;
     collect: () => Promise<void>;
     node: (name: string) => IStore<IStoreStateJS>;
+    factory: <TData>(name: string, loader: (key: string) => Observable<TData>) => IFactory<TData>;
     factoryBatch: <TData>(name: string, batch: (key: string[]) => Observable<Record<string, TData>>) => IFactory<TData>;
 };
 declare function createState(val: IStoreState): IStoreStateJS;

package/dist/index.js

@@ -4843,6 +4843,31 @@ function createStore(queue, state$) {
       });
       return createStore(queue, lens);
     },
+    factory: (name, loader) => {
+      const cache = Map().asMutable();
+      return {
+        get: (key) => {
+          if (!cache.has(key)) {
+            const lens = createLens(
+              createLens(state$, {
+                get: (x) => {
+                  const value = x.value[name];
+                  return value ?? toBranded("edge", createIdle());
+                },
+                set: (x, xs) => ({
+                  ...xs,
+                  value: { ...xs.value, [name]: x }
+                })
+              }),
+              keyLens("value")
+            );
+            const edge = createEdge(lens, queue, () => loader(key));
+            cache.set(key, edge);
+          }
+          return cache.get(key);
+        }
+      };
+    },
     factoryBatch: (name, batch) => {
       const lens = createLens(state$, {
         get: (x) => x.value[name] ?? toBranded("map", {}),

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "rxfy",
-  "version": "0.2.0",
+  "version": "0.2.1",
+  "description": "stream-based data management",
   "license": "MIT",
-  "description": "Stream-based state manager",
   "type": "module",
   "exports": {
     ".": {
@@ -19,15 +19,14 @@
     "package.json"
   ],
   "dependencies": {
-    "type-fest": "^4.38.0"
+    "p-queue": "^8.1.0"
   },
   "devDependencies": {
     "@types/lodash": "^4.17.16",
     "eslint": "^9.21.0",
-    "jiti": "^2.4.2",
     "immutable": "^5.1.1",
+    "jiti": "^2.4.2",
     "lodash": "^4.17.21",
-    "p-queue": "^8.1.0",
     "rimraf": "^6.0.1",
     "rxjs": "^7.8.2",
     "tsup": "^8.3.6",