flurryx 0.0.3 → 0.5.0

package/README.md

@@ -21,12 +21,18 @@
 flurryx bridges the gap between RxJS async operations and Angular signals. Define a store, pipe your HTTP calls through an operator, read signals in your templates. No actions, no reducers, no effects boilerplate.
 
 ```typescript
+// Store — declare your slots in 3 lines
+export const ProductStore = Store
+  .resource('LIST').as<Product[]>()
+  .resource('DETAIL').as<Product>()
+  .build();
+
 // Facade
-@SkipIfCached(StoreKey.LIST, (i) => i.store)
-@Loading(StoreKey.LIST, (i) => i.store)
+@SkipIfCached('LIST', (i) => i.store)
+@Loading('LIST', (i) => i.store)
 loadProducts() {
   this.http.get<Product[]>('/api/products')
-    .pipe(syncToStore(this.store, StoreKey.LIST))
+    .pipe(syncToStore(this.store, 'LIST'))
     .subscribe();
 }
 
@@ -49,7 +55,7 @@ No `async` pipe. No `subscribe` in templates. No manual unsubscription.
 - [Getting Started](#getting-started)
 - [How to Use](#how-to-use)
   - [ResourceState](#resourcestate)
-  - [BaseStore API](#basestore-api)
+  - [Store API](#store-api)
   - [syncToStore](#synctostore)
   - [syncToKeyedStore](#synctokeyedstore)
   - [@SkipIfCached](#skipifcached)
@@ -75,7 +81,7 @@ Angular signals are great for synchronous reactivity, but real applications stil
 | Duplicate requests | Manual `distinctUntilChanged`, inflight tracking   | `@SkipIfCached` deduplicates while loading     |
 | Keyed resources    | Separate state per ID, boilerplate explosion       | `KeyedResourceData` with per-key loading/error |
 
-flurryx gives you **one abstract class**, **two RxJS operators**, and **two decorators**. That's the entire API.
+flurryx gives you **one fluent builder**, **two RxJS operators**, and **two decorators**. That's the entire API.
 
 ---
 
@@ -88,7 +94,7 @@ npm install flurryx
 That's it. The `flurryx` package re-exports everything from the three internal packages (`@flurryx/core`, `@flurryx/store`, `@flurryx/rx`), so every import comes from a single place:
 
 ```typescript
-import { BaseStore, syncToStore, SkipIfCached, Loading } from "flurryx";
+import { Store, syncToStore, SkipIfCached, Loading } from "flurryx";
 import type { ResourceState, KeyedResourceData } from "flurryx";
 ```
 
@@ -137,33 +143,19 @@ npm install @flurryx/core @flurryx/store @flurryx/rx
 
 ### Step 1 — Define your store
 
-A store is an enum of named slots + a type map. Each slot holds a `ResourceState<T>`.
+Use the `Store` fluent builder to declare named slots. Each slot holds a `ResourceState<T>`.
 
 ```typescript
-import { Injectable } from "@angular/core";
-import { BaseStore, type ResourceState } from "flurryx";
-
-enum ProductStoreEnum {
-  LIST = "LIST",
-  DETAIL = "DETAIL",
-}
+import { Store } from "flurryx";
 
-interface ProductStoreData {
-  [ProductStoreEnum.LIST]: ResourceState<Product[]>;
-  [ProductStoreEnum.DETAIL]: ResourceState<Product>;
-}
-
-@Injectable({ providedIn: "root" })
-export class ProductStore extends BaseStore<
-  typeof ProductStoreEnum,
-  ProductStoreData
-> {
-  constructor() {
-    super(ProductStoreEnum);
-  }
-}
+export const ProductStore = Store
+  .resource('LIST').as<Product[]>()
+  .resource('DETAIL').as<Product>()
+  .build();
 ```
 
+That's it. No enum, no interface, no class, no constructor. The builder returns an `InjectionToken` with `providedIn: 'root'`.
+
 ### Step 2 — Create a facade
 
 The facade owns the store and exposes signals + data-fetching methods.
@@ -179,23 +171,23 @@ export class ProductFacade {
   readonly store = inject(ProductStore);
 
   // Expose signals for templates
-  readonly list = this.store.get(ProductStoreEnum.LIST);
-  readonly detail = this.store.get(ProductStoreEnum.DETAIL);
+  readonly list = this.store.get('LIST');
+  readonly detail = this.store.get('DETAIL');
 
-  @SkipIfCached(ProductStoreEnum.LIST, (i: ProductFacade) => i.store)
-  @Loading(ProductStoreEnum.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, ProductStoreEnum.LIST))
+      .pipe(syncToStore(this.store, 'LIST'))
       .subscribe();
   }
 
-  @Loading(ProductStoreEnum.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, ProductStoreEnum.DETAIL))
+      .pipe(syncToStore(this.store, 'DETAIL'))
       .subscribe();
   }
 }
@@ -258,9 +250,18 @@ A slot starts as `{ data: undefined, isLoading: false, status: undefined, errors
                                └───────────┘
 ```
 
-### BaseStore API
+### Store API
 
-`BaseStore<TEnum, TData>` manages a `Map<keyof TEnum, WritableSignal<ResourceState>>`.
+The `Store` builder creates a store backed by `WritableSignal<ResourceState>` per slot.
+
+```typescript
+export const MyStore = Store
+  .resource('USERS').as<User[]>()
+  .resource('SELECTED').as<User>()
+  .build();
+```
+
+Once injected, the store exposes these methods:
 
 | Method                    | Description                                                                           |
 | ------------------------- | ------------------------------------------------------------------------------------- |
@@ -289,7 +290,7 @@ RxJS pipeable operator that bridges an `Observable` to a store slot.
 ```typescript
 this.http
   .get<Product[]>("/api/products")
-  .pipe(syncToStore(this.store, ProductStoreEnum.LIST))
+  .pipe(syncToStore(this.store, 'LIST'))
   .subscribe();
 ```
 
@@ -316,7 +317,7 @@ Same pattern, but targets a specific resource key within a `KeyedResourceData` s
 ```typescript
 this.http
   .get<Invoice>(`/api/invoices/${id}`)
-  .pipe(syncToKeyedStore(this.store, InvoiceStoreEnum.ITEMS, id))
+  .pipe(syncToKeyedStore(this.store, 'ITEMS', id))
   .subscribe();
 ```
 
@@ -325,7 +326,7 @@ Only the targeted resource key is updated. Other keys in the same slot are untou
 **`mapResponse`** — transform the API response before writing to the store:
 
 ```typescript
-syncToKeyedStore(this.store, StoreKey.ITEMS, id, {
+syncToKeyedStore(this.store, 'ITEMS', id, {
   mapResponse: (response) => response.data,
 });
 ```
@@ -335,7 +336,7 @@ syncToKeyedStore(this.store, StoreKey.ITEMS, id, {
 Method decorator that skips execution when the store already has valid data.
 
 ```typescript
-@SkipIfCached(StoreKey.LIST, (i) => i.store)
+@SkipIfCached('LIST', (i) => i.store)
 loadProducts() { /* only runs when cache is stale */ }
 ```
 
@@ -356,10 +357,10 @@ loadProducts() { /* only runs when cache is stale */ }
 
 ```typescript
 @SkipIfCached(
-  storeKey,                   // which store slot to check
+  'LIST',                       // which store slot to check
   (instance) => instance.store, // how to get the store from `this`
-  returnObservable?,          // false (default): void methods; true: returns Observable
-  timeoutMs?                  // default: 300_000 (5 min). Use CACHE_NO_TIMEOUT for infinite
+  returnObservable?,            // false (default): void methods; true: returns Observable
+  timeoutMs?                    // default: 300_000 (5 min). Use CACHE_NO_TIMEOUT for infinite
 )
 ```
 
@@ -375,7 +376,7 @@ loadProducts() { /* only runs when cache is stale */ }
 Method decorator that calls `store.startLoading(key)` before the original method executes.
 
 ```typescript
-@Loading(StoreKey.LIST, (i) => i.store)
+@Loading('LIST', (i) => i.store)
 loadProducts() { /* store.isLoading is already true when this runs */ }
 ```
 
@@ -384,11 +385,11 @@ loadProducts() { /* store.isLoading is already true when this runs */ }
 **Compose both decorators** for the common pattern:
 
 ```typescript
-@SkipIfCached(StoreKey.LIST, (i) => i.store)
-@Loading(StoreKey.LIST, (i) => i.store)
+@SkipIfCached('LIST', (i) => i.store)
+@Loading('LIST', (i) => i.store)
 loadProducts() {
   this.http.get('/api/products')
-    .pipe(syncToStore(this.store, StoreKey.LIST))
+    .pipe(syncToStore(this.store, 'LIST'))
     .subscribe();
 }
 ```
@@ -418,7 +419,7 @@ import { httpErrorNormalizer } from "flurryx/http";
 this.http
   .get("/api/data")
   .pipe(
-    syncToStore(this.store, Key.DATA, {
+    syncToStore(this.store, 'DATA', {
       errorNormalizer: httpErrorNormalizer,
     }),
   )
@@ -467,37 +468,26 @@ Each resource key gets **independent** loading, status, and error tracking. The
 
 ```typescript
 // Store
-enum InvoiceStoreEnum {
-  ITEMS = "ITEMS",
-}
-
-interface InvoiceStoreData {
-  [InvoiceStoreEnum.ITEMS]: ResourceState<KeyedResourceData<string, Invoice>>;
-}
+import { Store } from "flurryx";
+import type { KeyedResourceData } from "flurryx";
 
-@Injectable({ providedIn: "root" })
-export class InvoiceStore extends BaseStore<
-  typeof InvoiceStoreEnum,
-  InvoiceStoreData
-> {
-  constructor() {
-    super(InvoiceStoreEnum);
-  }
-}
+export const InvoiceStore = Store
+  .resource('ITEMS').as<KeyedResourceData<string, Invoice>>()
+  .build();
 
 // Facade
 @Injectable({ providedIn: "root" })
 export class InvoiceFacade {
   private readonly http = inject(HttpClient);
   readonly store = inject(InvoiceStore);
-  readonly items = this.store.get(InvoiceStoreEnum.ITEMS);
+  readonly items = this.store.get('ITEMS');
 
-  @SkipIfCached(InvoiceStoreEnum.ITEMS, (i: InvoiceFacade) => i.store)
-  @Loading(InvoiceStoreEnum.ITEMS, (i: InvoiceFacade) => i.store)
+  @SkipIfCached('ITEMS', (i: InvoiceFacade) => i.store)
+  @Loading('ITEMS', (i: InvoiceFacade) => i.store)
   loadInvoice(id: string) {
     this.http
       .get<Invoice>(`/api/invoices/${id}`)
-      .pipe(syncToKeyedStore(this.store, InvoiceStoreEnum.ITEMS, id))
+      .pipe(syncToKeyedStore(this.store, 'ITEMS', id))
       .subscribe();
   }
 }

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   DEFAULT_CACHE_TTL_MS: () => import_core.DEFAULT_CACHE_TTL_MS,
   Loading: () => import_rx.Loading,
   SkipIfCached: () => import_rx.SkipIfCached,
+  Store: () => import_store.Store,
   createKeyedResourceData: () => import_core.createKeyedResourceData,
   defaultErrorNormalizer: () => import_rx.defaultErrorNormalizer,
   isAnyKeyLoading: () => import_core.isAnyKeyLoading,
@@ -43,6 +44,7 @@ var import_rx = require("@flurryx/rx");
   DEFAULT_CACHE_TTL_MS,
   Loading,
   SkipIfCached,
+  Store,
   createKeyedResourceData,
   defaultErrorNormalizer,
   isAnyKeyLoading,

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 } 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;AASA,kBAMO;AAGP,mBAA0B;AAG1B,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 { BaseStore, Store } 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;AASA,kBAMO;AAGP,mBAAiC;AAGjC,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 } from '@flurryx/store';
+export { BaseStore, Store } 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 } from '@flurryx/store';
+export { BaseStore, Store } from '@flurryx/store';
 export { ErrorNormalizer, Loading, SkipIfCached, SyncToKeyedStoreOptions, SyncToStoreOptions, defaultErrorNormalizer, syncToKeyedStore, syncToStore } from '@flurryx/rx';

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   CACHE_NO_TIMEOUT,
   DEFAULT_CACHE_TTL_MS
 } from "@flurryx/core";
-import { BaseStore } from "@flurryx/store";
+import { BaseStore, Store } from "@flurryx/store";
 import {
   syncToStore,
   syncToKeyedStore,
@@ -20,6 +20,7 @@ export {
   DEFAULT_CACHE_TTL_MS,
   Loading,
   SkipIfCached,
+  Store,
   createKeyedResourceData,
   defaultErrorNormalizer,
   isAnyKeyLoading,

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 } 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,iBAAiB;AAG1B;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 { BaseStore, Store } 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,aAAa;AAGjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/package.json

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