flurryx 0.7.6 → 0.8.1

package/README.md

@@ -29,18 +29,37 @@ interface ProductStoreConfig {
 export const ProductStore = Store.for<ProductStoreConfig>().build();
 
 // Facade
-@SkipIfCached('LIST', (i) => i.store)
-@Loading('LIST', (i) => i.store)
-loadProducts() {
-  this.http.get<Product[]>('/api/products')
-    .pipe(syncToStore(this.store, 'LIST'))
-    .subscribe();
+@Injectable()
+export class ProductFacade {
+  @SkipIfCached("LIST", (i) => i.store)
+  @Loading("LIST", (i) => i.store)
+  loadProducts() {
+    this.http
+      .get<Product[]>("/api/products")
+      .pipe(syncToStore(this.store, "LIST"))
+      .subscribe();
+  }
+
+  // Read signals from the facade
+  getProducts() {
+    return this.store.get("LIST");
+  }
 }
 
-// Component template — just read the signal
-@if (facade.list().isLoading) { <spinner /> }
-@for (product of facade.list().data; track product.id) {
-  <product-card [product]="product" />
+// Component — read the facade signal once, use it in the template
+@Component({
+  selector: "app-product-list",
+  template: `
+    @if (productsState().isLoading) {
+    <spinner />
+    } @for (product of productsState().data; track product.id) {
+    <product-card [product]="product" />
+    }
+  `,
+})
+export class ProductListComponent {
+  private readonly facade = inject(ProductFacade);
+  readonly productsState = this.facade.getProducts();
 }
 ```
 
@@ -67,6 +86,7 @@ No `async` pipe. No `subscribe` in templates. No manual unsubscription.
 - [Keyed Resources](#keyed-resources)
 - [Store Mirroring](#store-mirroring)
   - [Builder .mirror()](#builder-mirror)
+  - [Builder .mirrorSelf()](#builder-mirrorself)
   - [Builder .mirrorKeyed()](#builder-mirrorkeyed)
   - [mirrorKey](#mirrorkey)
   - [collectKeyed](#collectkeyed)
@@ -174,29 +194,33 @@ import { Injectable, inject } from "@angular/core";
 import { HttpClient } from "@angular/common/http";
 import { syncToStore, SkipIfCached, Loading } from "flurryx";
 
-@Injectable({ providedIn: "root" })
+@Injectable()
 export class ProductFacade {
   private readonly http = inject(HttpClient);
   readonly store = inject(ProductStore);
 
-  // Expose signals for templates
-  readonly list = this.store.get('LIST');
-  readonly detail = this.store.get('DETAIL');
+  getProducts() {
+    return this.store.get("LIST");
+  }
+
+  getProductDetail() {
+    return this.store.get("DETAIL");
+  }
 
-  @SkipIfCached('LIST', (i: ProductFacade) => i.store)
-  @Loading('LIST', (i: ProductFacade) => i.store)
+  @SkipIfCached("LIST", (i: ProductFacade) => i.store)
+  @Loading("LIST", (i: ProductFacade) => i.store)
   loadProducts() {
     this.http
       .get<Product[]>("/api/products")
-      .pipe(syncToStore(this.store, 'LIST'))
+      .pipe(syncToStore(this.store, "LIST"))
       .subscribe();
   }
 
-  @Loading('DETAIL', (i: ProductFacade) => i.store)
+  @Loading("DETAIL", (i: ProductFacade) => i.store)
   loadProduct(id: string) {
     this.http
       .get<Product>(`/api/products/${id}`)
-      .pipe(syncToStore(this.store, 'DETAIL'))
+      .pipe(syncToStore(this.store, "DETAIL"))
       .subscribe();
   }
 }
@@ -207,18 +231,19 @@ export class ProductFacade {
 ```typescript
 @Component({
   template: `
-    @if (facade.list().isLoading) {
+    @if (productsState().isLoading) {
     <spinner />
-    } @if (facade.list().status === 'Success') { @for (product of
-    facade.list().data; track product.id) {
+    } @if (productsState().status === 'Success') { @for (product of
+    productsState().data; track product.id) {
     <product-card [product]="product" />
-    } } @if (facade.list().status === 'Error') {
-    <error-banner [errors]="facade.list().errors" />
+    } } @if (productsState().status === 'Error') {
+    <error-banner [errors]="productsState().errors" />
     }
   `,
 })
 export class ProductListComponent {
-  readonly facade = inject(ProductFacade);
+  private readonly facade = inject(ProductFacade);
+  readonly productsState = this.facade.getProducts();
 
   constructor() {
     this.facade.loadProducts();
@@ -291,7 +316,8 @@ Once injected, the store exposes these methods:
 | `get(key)`                | Returns the `Signal` for a slot                                               |
 | `update(key, partial)`    | Merges partial state (immutable spread)                                               |
 | `clear(key)`              | Resets a slot to its initial empty state                                              |
-| `clearAll()`              | Resets every slot                                                                     |
+| `clearAll()`              | Resets every slot in one store                                                        |
+| `clearAllStores()`        | Resets every tracked store instance                                                   |
 | `startLoading(key)`       | Sets `isLoading: true`, clears `status` and `errors`                                  |
 | `stopLoading(key)`        | Sets `isLoading: false`, clears `status` and `errors`                                 |
 | `onUpdate(key, callback)` | Registers a listener fired after `update` or `clear`. Returns an unsubscribe function |
@@ -696,6 +722,45 @@ export const SessionStore = Store.for<{ ARTICLES: Item[] }>()
 
 The builder calls `inject()` under the hood, so source stores are resolved through Angular's DI. Everything — data, loading, status, errors — is mirrored automatically. No manual cleanup needed; the mirrors live as long as the store.
 
+### Builder .mirrorSelf()
+
+Use `.mirrorSelf()` when one slot in a store should mirror another slot in the same store. It is useful for aliases, local snapshots, or secondary slots that should stay in sync with a primary slot without wiring `onUpdate` manually.
+
+```typescript
+interface SessionStoreConfig {
+  CUSTOMER_DETAILS: Customer;
+  CUSTOMER_SNAPSHOT: Customer;
+}
+
+export const SessionStore = Store.for<SessionStoreConfig>()
+  .mirrorSelf('CUSTOMER_DETAILS', 'CUSTOMER_SNAPSHOT')
+  .build();
+```
+
+It mirrors the full resource state one way — `data`, `isLoading`, `status`, and `errors` all flow from the source key to the target key. The target key must be different from the source key.
+
+Because it listens to updates on the built store itself, `.mirrorSelf()` also reacts when the source key is updated by another mirror:
+
+```typescript
+interface CustomerStoreConfig {
+  CUSTOMERS: Customer[];
+}
+
+interface SessionStoreConfig {
+  CUSTOMERS: Customer[];
+  CUSTOMER_COPY: Customer[];
+}
+
+export const CustomerStore = Store.for<CustomerStoreConfig>().build();
+
+export const SessionStore = Store.for<SessionStoreConfig>()
+  .mirror(CustomerStore, 'CUSTOMERS')
+  .mirrorSelf('CUSTOMERS', 'CUSTOMER_COPY')
+  .build();
+```
+
+`.mirrorSelf()` is available on all builder styles. For fluent builders, declare both slots first, then chain `.mirrorSelf(sourceKey, targetKey)` before `.build()`.
+
 ### Builder .mirrorKeyed()
 
 When the source store holds a single-entity slot (e.g. `CUSTOMER_DETAILS: Customer`) and you want to accumulate those fetches into a `KeyedResourceData` cache on the target, use `.mirrorKeyed()`. It is the builder equivalent of [`collectKeyed`](#collectkeyed).

package/dist/index.cjs

@@ -26,6 +26,7 @@ __export(index_exports, {
   Loading: () => import_rx.Loading,
   SkipIfCached: () => import_rx.SkipIfCached,
   Store: () => import_store.Store,
+  clearAllStores: () => import_store.clearAllStores,
   collectKeyed: () => import_store.collectKeyed,
   createKeyedResourceData: () => import_core.createKeyedResourceData,
   defaultErrorNormalizer: () => import_rx.defaultErrorNormalizer,
@@ -47,6 +48,7 @@ var import_rx = require("@flurryx/rx");
   Loading,
   SkipIfCached,
   Store,
+  clearAllStores,
   collectKeyed,
   createKeyedResourceData,
   defaultErrorNormalizer,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @flurryx/core\nexport type {\n  ResourceState,\n  StoreEnum,\n  KeyedResourceData,\n  KeyedResourceKey,\n  ResourceStatus,\n  ResourceErrors,\n} from \"@flurryx/core\";\nexport {\n  isKeyedResourceData,\n  createKeyedResourceData,\n  isAnyKeyLoading,\n  CACHE_NO_TIMEOUT,\n  DEFAULT_CACHE_TTL_MS,\n} from \"@flurryx/core\";\n\n// @flurryx/store\nexport { BaseStore, Store, mirrorKey, collectKeyed } from \"@flurryx/store\";\nexport type { MirrorOptions, CollectKeyedOptions } from \"@flurryx/store\";\n\n// @flurryx/rx\nexport {\n  syncToStore,\n  syncToKeyedStore,\n  SkipIfCached,\n  Loading,\n  defaultErrorNormalizer,\n} from \"@flurryx/rx\";\nexport type {\n  SyncToStoreOptions,\n  SyncToKeyedStoreOptions,\n  ErrorNormalizer,\n} from \"@flurryx/rx\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,kBAMO;AAGP,mBAA0D;AAI1D,gBAMO;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @flurryx/core\nexport type {\n  ResourceState,\n  StoreEnum,\n  KeyedResourceData,\n  KeyedResourceKey,\n  ResourceStatus,\n  ResourceErrors,\n} from \"@flurryx/core\";\nexport {\n  isKeyedResourceData,\n  createKeyedResourceData,\n  isAnyKeyLoading,\n  CACHE_NO_TIMEOUT,\n  DEFAULT_CACHE_TTL_MS,\n} from \"@flurryx/core\";\n\n// @flurryx/store\nexport {\n  BaseStore,\n  Store,\n  clearAllStores,\n  mirrorKey,\n  collectKeyed,\n} from \"@flurryx/store\";\nexport type { MirrorOptions, CollectKeyedOptions } from \"@flurryx/store\";\n\n// @flurryx/rx\nexport {\n  syncToStore,\n  syncToKeyedStore,\n  SkipIfCached,\n  Loading,\n  defaultErrorNormalizer,\n} from \"@flurryx/rx\";\nexport type {\n  SyncToStoreOptions,\n  SyncToKeyedStoreOptions,\n  ErrorNormalizer,\n} from \"@flurryx/rx\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,kBAMO;AAGP,mBAMO;AAIP,gBAMO;","names":[]}

package/dist/index.d.cts

@@ -1,3 +1,3 @@
 export { CACHE_NO_TIMEOUT, DEFAULT_CACHE_TTL_MS, KeyedResourceData, KeyedResourceKey, ResourceErrors, ResourceState, ResourceStatus, StoreEnum, createKeyedResourceData, isAnyKeyLoading, isKeyedResourceData } from '@flurryx/core';
-export { BaseStore, CollectKeyedOptions, MirrorOptions, Store, collectKeyed, mirrorKey } from '@flurryx/store';
+export { BaseStore, CollectKeyedOptions, MirrorOptions, Store, clearAllStores, collectKeyed, mirrorKey } from '@flurryx/store';
 export { ErrorNormalizer, Loading, SkipIfCached, SyncToKeyedStoreOptions, SyncToStoreOptions, defaultErrorNormalizer, syncToKeyedStore, syncToStore } from '@flurryx/rx';

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { CACHE_NO_TIMEOUT, DEFAULT_CACHE_TTL_MS, KeyedResourceData, KeyedResourceKey, ResourceErrors, ResourceState, ResourceStatus, StoreEnum, createKeyedResourceData, isAnyKeyLoading, isKeyedResourceData } from '@flurryx/core';
-export { BaseStore, CollectKeyedOptions, MirrorOptions, Store, collectKeyed, mirrorKey } from '@flurryx/store';
+export { BaseStore, CollectKeyedOptions, MirrorOptions, Store, clearAllStores, collectKeyed, mirrorKey } from '@flurryx/store';
 export { ErrorNormalizer, Loading, SkipIfCached, SyncToKeyedStoreOptions, SyncToStoreOptions, defaultErrorNormalizer, syncToKeyedStore, syncToStore } from '@flurryx/rx';

package/dist/index.js

@@ -6,7 +6,13 @@ import {
   CACHE_NO_TIMEOUT,
   DEFAULT_CACHE_TTL_MS
 } from "@flurryx/core";
-import { BaseStore, Store, mirrorKey, collectKeyed } from "@flurryx/store";
+import {
+  BaseStore,
+  Store,
+  clearAllStores,
+  mirrorKey,
+  collectKeyed
+} from "@flurryx/store";
 import {
   syncToStore,
   syncToKeyedStore,
@@ -21,6 +27,7 @@ export {
   Loading,
   SkipIfCached,
   Store,
+  clearAllStores,
   collectKeyed,
   createKeyedResourceData,
   defaultErrorNormalizer,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @flurryx/core\nexport type {\n  ResourceState,\n  StoreEnum,\n  KeyedResourceData,\n  KeyedResourceKey,\n  ResourceStatus,\n  ResourceErrors,\n} from \"@flurryx/core\";\nexport {\n  isKeyedResourceData,\n  createKeyedResourceData,\n  isAnyKeyLoading,\n  CACHE_NO_TIMEOUT,\n  DEFAULT_CACHE_TTL_MS,\n} from \"@flurryx/core\";\n\n// @flurryx/store\nexport { BaseStore, Store, mirrorKey, collectKeyed } from \"@flurryx/store\";\nexport type { MirrorOptions, CollectKeyedOptions } from \"@flurryx/store\";\n\n// @flurryx/rx\nexport {\n  syncToStore,\n  syncToKeyedStore,\n  SkipIfCached,\n  Loading,\n  defaultErrorNormalizer,\n} from \"@flurryx/rx\";\nexport type {\n  SyncToStoreOptions,\n  SyncToKeyedStoreOptions,\n  ErrorNormalizer,\n} from \"@flurryx/rx\";\n"],"mappings":";AASA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,WAAW,OAAO,WAAW,oBAAoB;AAI1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @flurryx/core\nexport type {\n  ResourceState,\n  StoreEnum,\n  KeyedResourceData,\n  KeyedResourceKey,\n  ResourceStatus,\n  ResourceErrors,\n} from \"@flurryx/core\";\nexport {\n  isKeyedResourceData,\n  createKeyedResourceData,\n  isAnyKeyLoading,\n  CACHE_NO_TIMEOUT,\n  DEFAULT_CACHE_TTL_MS,\n} from \"@flurryx/core\";\n\n// @flurryx/store\nexport {\n  BaseStore,\n  Store,\n  clearAllStores,\n  mirrorKey,\n  collectKeyed,\n} from \"@flurryx/store\";\nexport type { MirrorOptions, CollectKeyedOptions } from \"@flurryx/store\";\n\n// @flurryx/rx\nexport {\n  syncToStore,\n  syncToKeyedStore,\n  SkipIfCached,\n  Loading,\n  defaultErrorNormalizer,\n} from \"@flurryx/rx\";\nexport type {\n  SyncToStoreOptions,\n  SyncToKeyedStoreOptions,\n  ErrorNormalizer,\n} from \"@flurryx/rx\";\n"],"mappings":";AASA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flurryx",
-  "version": "0.7.6",
+  "version": "0.8.1",
   "description": "Signal-first reactive state management for Angular",
   "license": "MIT",
   "type": "module",
@@ -38,9 +38,9 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@flurryx/core": "0.7.6",
-    "@flurryx/store": "0.7.6",
-    "@flurryx/rx": "0.7.6"
+    "@flurryx/core": "0.8.0",
+    "@flurryx/store": "0.8.1",
+    "@flurryx/rx": "0.8.1"
   },
   "peerDependencies": {
     "@angular/core": ">=17.0.0",