@angular-cool/repository 21.0.5 → 21.0.6

package/README.md

@@ -42,7 +42,7 @@ export class MyService {
 ```typescript
 import { signal } from '@angular/common';
 import { MyService } from './my-service.service';
-import { ItemId, ItemDTO } from './my-item.model';
+import { ItemDTO, ItemId } from './my-item.model';
 
 @Component(/*...*/)
 export class MyComponent {
@@ -55,13 +55,17 @@ export class MyComponent {
   protected async updateItem() {
     // Update item on the server here
 
-    await this._myService.items.reload(this.idParam()); // This reloads the item from the server and updates the signal for all subscribers
+    await this.myItem.reload(); // This reloads the item from the server and updates the signal for all subscribers
   }
 }
 ```
 
 ### Manually update value if needed
 
+```typescript
+this.myItem.set(newValue); // Updates the signal for all subscribers
+```
+OR 
 ```typescript
 await this._myService.items.setValue(this.idParam(), myValue); // Updates the signal for all subscribers
 ```

package/fesm2022/angular-cool-repository.mjs

@@ -1,5 +1,5 @@
 import { rxResource } from '@angular/core/rxjs-interop';
-import { ReplaySubject, firstValueFrom } from 'rxjs';
+import { ReplaySubject, BehaviorSubject, firstValueFrom } from 'rxjs';
 
 class ResourceCache {
     get isInvalid() {
@@ -8,44 +8,57 @@ class ResourceCache {
     constructor(loader, maxAge) {
         this.loader = loader;
         this.maxAge = maxAge;
-        this._subject = new ReplaySubject();
+        this._valueSubject = new ReplaySubject(1);
+        this._isLoading = false;
+        this._isLoadingSubject = new BehaviorSubject(false);
         this._validUntil = null;
     }
-    getObservable() {
-        return this._subject.asObservable();
+    getValueObservable() {
+        return this._valueSubject.asObservable();
     }
     async keepDataFreshAsync() {
         if (!this.isInvalid) {
             return;
         }
-        const data = await this.loader();
-        await this.setValueAsync(data);
+        await this._reloadValueAsync();
+    }
+    async _reloadValueAsync() {
+        if (this._isLoading) {
+            await firstValueFrom(this._isLoadingSubject);
+            return;
+        }
+        this._setIsLoading(true);
+        try {
+            const data = await this.loader();
+            await this.setValueAsync(data);
+        }
+        finally {
+            this._setIsLoading(false);
+        }
     }
     async setValueAsync(value) {
         this._validUntil = Date.now() + this.maxAge;
-        this._subject.next(value);
+        this._valueSubject.next(value);
     }
     async getValueAsync() {
         await this.keepDataFreshAsync();
-        return firstValueFrom(this._subject);
+        return firstValueFrom(this._valueSubject);
     }
     invalidate() {
         this._validUntil = null;
     }
+    _setIsLoading(isLoading) {
+        this._isLoading = isLoading;
+        this._isLoadingSubject.next(isLoading);
+    }
 }
 
 const DEFAULT_MAX_AGE = 5 * 60 * 1000;
-class ResourceRepository {
+class ResourceRepositoryImpl {
     constructor(options) {
         this.options = options;
         this._cacheStore = new Map();
     }
-    /**
-     * Retrieves a resource cache
-     *
-     * @param {Signal<TParams>} key - A signal function used to resolve the parameters for retrieving or initializing the resource.
-     * @return {ReloadableSignal<TItem | undefined>} A read-only signal containing the item associated with the provided key, already cached.
-     */
     get(key) {
         const resource = rxResource({
             params: () => key(),
@@ -58,22 +71,18 @@ class ResourceRepository {
                 }
                 // Do not wait for it to load
                 cache.keepDataFreshAsync();
-                return cache.getObservable();
+                return cache.getValueObservable();
+            }
+        });
+        return Object.assign(resource.asReadonly().value, {
+            reload: async () => {
+                await this.reload(key());
+            },
+            set: async (value) => {
+                await this.setValue(key(), value);
             }
         });
-        const resultSignal = resource.asReadonly().value;
-        resultSignal.reload = async () => {
-            await this.reload(key());
-        };
-        return resultSignal;
-    }
-    /**
-     * Reloads the cache associated with the given key, ensuring it is updated with fresh data.
-     *
-     * @param {TParams} key - The key used to identify the specific cache entry to reload.
-     * @return {Promise<void>} A promise that resolves when the cache has been refreshed.
-     * @throws {Error} If no cache is found for the provided key or if data loading fails.
-     */
+    }
     async reload(key) {
         const cacheKey = this._createCacheKey(key);
         const cache = this._cacheStore.get(cacheKey);
@@ -83,14 +92,6 @@ class ResourceRepository {
         cache.invalidate();
         await cache.keepDataFreshAsync();
     }
-    /**
-     * Retrieves a value from the cache associated with the specified key.
-     *
-     * @param {TParams} key - The key used to identify the cache entry.
-     * @return {Promise<TItem | undefined>} A promise that resolves with the retrieved value
-     * or undefined if the value does not exist.
-     * @throws {Error} If no cache is found for the given key.
-     */
     async getValue(key) {
         const cacheKey = this._createCacheKey(key);
         const cache = this._cacheStore.get(cacheKey);
@@ -99,13 +100,6 @@ class ResourceRepository {
         }
         return await cache.getValueAsync();
     }
-    /**
-     * Sets a value in the cache associated with the given key and update all value subscribers
-     *
-     * @param {TParams} key - The unique key used to identify the cache.
-     * @param {TItem} value - The value to be stored in the cache
-     * @return {Promise<void>} A promise that resolves when the value is successfully set.
-     */
     async setValue(key, value) {
         const cacheKey = this._createCacheKey(key);
         let cache = this._cacheStore.get(cacheKey);
@@ -114,13 +108,6 @@ class ResourceRepository {
         }
         await cache.setValueAsync(value);
     }
-    /**
-     * Updates the value associated with the given key by applying an update function and update all value subscribers
-     *
-     * @param {TParams} key - The key whose value needs to be updated.
-     * @param {function(value: TItem | undefined): Promise<TItem>} updateFn - An asynchronous function that takes the current value (or undefined if not present) and returns the updated value.
-     * @return {Promise<void>} A promise that resolves when the update operation is complete.
-     */
     async updateValue(key, updateFn) {
         const value = await this.getValue(key);
         await this.setValue(key, await updateFn(value));
@@ -129,6 +116,7 @@ class ResourceRepository {
         return (this.options.cacheKeyGenerator ?? JSON.stringify)(params);
     }
 }
+
 /**
  * Creates a new instance of a ResourceRepository with the specified options.
  *
@@ -136,7 +124,7 @@ class ResourceRepository {
  * @return {ResourceRepository<TParams, TItem>} A new instance of ResourceRepository configured with the given options.
  */
 function resourceRepository(options) {
-    return new ResourceRepository(options);
+    return new ResourceRepositoryImpl(options);
 }
 
 /**

package/fesm2022/angular-cool-repository.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"angular-cool-repository.mjs","sources":["../../../projects/repository/src/lib/resource-cache.ts","../../../projects/repository/src/lib/resource-repository.ts","../../../projects/repository/src/angular-cool-repository.ts"],"sourcesContent":["import { firstValueFrom, ReplaySubject } from 'rxjs';\n\nexport class ResourceCache<TItem> {\n  private _subject = new ReplaySubject<TItem | undefined>();\n  private _validUntil: number | null = null;\n\n  public get isInvalid(): boolean {\n    return this._validUntil === null || Date.now() > this._validUntil;\n  }\n\n  constructor(\n    private loader: () => Promise<TItem | undefined>,\n    private maxAge: number,\n  ) {\n  }\n\n  public getObservable() {\n    return this._subject.asObservable();\n  }\n\n  public async keepDataFreshAsync() {\n    if (!this.isInvalid) {\n      return;\n    }\n\n    const data = await this.loader();\n\n    await this.setValueAsync(data);\n  }\n\n  public async setValueAsync(value: TItem | undefined) {\n    this._validUntil = Date.now() + this.maxAge;\n    this._subject.next(value);\n  }\n\n  public async getValueAsync(): Promise<TItem | undefined> {\n    await this.keepDataFreshAsync();\n\n    return firstValueFrom(this._subject);\n  }\n\n  public invalidate() {\n    this._validUntil = null;\n  }\n}\n","import { Signal } from '@angular/core';\nimport { rxResource } from '@angular/core/rxjs-interop';\nimport { ResourceCache } from './resource-cache';\n\nconst DEFAULT_MAX_AGE = 5 * 60 * 1000;\n\ntype CacheKey = string;\n\nexport type ReloadableSignal<T> = Signal<T> & { reload: () => Promise<void> };\n\nclass ResourceRepository<TParams, TItem> {\n  private _cacheStore = new Map<CacheKey, ResourceCache<TItem>>();\n\n  constructor(private options: ResourceRepositoryOptions<TParams, TItem>) {\n  }\n\n  /**\n   * Retrieves a resource cache\n   *\n   * @param {Signal<TParams>} key - A signal function used to resolve the parameters for retrieving or initializing the resource.\n   * @return {ReloadableSignal<TItem | undefined>} A read-only signal containing the item associated with the provided key, already cached.\n   */\n  public get(key: Signal<TParams>): ReloadableSignal<TItem | undefined> {\n    const resource = rxResource<TItem | undefined, TParams>({\n      params: () => key(),\n      stream: ({ params }) => {\n        const cacheKey = this._createCacheKey(params);\n\n        let cache = this._cacheStore.get(cacheKey);\n\n        if (!cache) {\n          cache = new ResourceCache(\n            ((p) => () => this.options.loader(p))(params),\n            this.options.maxAge ?? DEFAULT_MAX_AGE,\n          );\n\n          this._cacheStore.set(cacheKey, cache);\n        }\n\n        // Do not wait for it to load\n        cache.keepDataFreshAsync();\n\n        return cache.getObservable();\n      }\n    });\n\n    const resultSignal = resource.asReadonly().value as ReloadableSignal<TItem | undefined>;\n\n    resultSignal.reload = async () => {\n      await this.reload(key());\n    };\n\n    return resultSignal;\n  }\n\n  /**\n   * Reloads the cache associated with the given key, ensuring it is updated with fresh data.\n   *\n   * @param {TParams} key - The key used to identify the specific cache entry to reload.\n   * @return {Promise<void>} A promise that resolves when the cache has been refreshed.\n   * @throws {Error} If no cache is found for the provided key or if data loading fails.\n   */\n  public async reload(key: TParams): Promise<void> {\n    const cacheKey = this._createCacheKey(key);\n\n    const cache = this._cacheStore.get(cacheKey);\n\n    if (!cache) {\n      throw new Error(`No cache found for the given key: ${key}`);\n    }\n\n    cache.invalidate();\n\n    await cache.keepDataFreshAsync();\n  }\n\n  /**\n   * Retrieves a value from the cache associated with the specified key.\n   *\n   * @param {TParams} key - The key used to identify the cache entry.\n   * @return {Promise<TItem | undefined>} A promise that resolves with the retrieved value\n   * or undefined if the value does not exist.\n   * @throws {Error} If no cache is found for the given key.\n   */\n  public async getValue(key: TParams): Promise<TItem | undefined> {\n    const cacheKey = this._createCacheKey(key);\n\n    const cache = this._cacheStore.get(cacheKey);\n\n    if (!cache) {\n      throw new Error(`No cache found for the given key: ${key}`);\n    }\n\n    return await cache.getValueAsync();\n  }\n\n  /**\n   * Sets a value in the cache associated with the given key and update all value subscribers\n   *\n   * @param {TParams} key - The unique key used to identify the cache.\n   * @param {TItem} value - The value to be stored in the cache\n   * @return {Promise<void>} A promise that resolves when the value is successfully set.\n   */\n  public async setValue(key: TParams, value: TItem): Promise<void> {\n    const cacheKey = this._createCacheKey(key);\n\n    let cache = this._cacheStore.get(cacheKey);\n\n    if (!cache) {\n      throw new Error(`No cache found for the given key: ${key}`);\n    }\n\n    await cache.setValueAsync(value);\n  }\n\n  /**\n   * Updates the value associated with the given key by applying an update function and update all value subscribers\n   *\n   * @param {TParams} key - The key whose value needs to be updated.\n   * @param {function(value: TItem | undefined): Promise<TItem>} updateFn - An asynchronous function that takes the current value (or undefined if not present) and returns the updated value.\n   * @return {Promise<void>} A promise that resolves when the update operation is complete.\n   */\n  public async updateValue(key: TParams, updateFn: (value: TItem | undefined) => Promise<TItem>): Promise<void> {\n    const value = await this.getValue(key);\n\n    await this.setValue(key, await updateFn(value));\n  }\n\n  private _createCacheKey(params: TParams): CacheKey {\n    return (this.options.cacheKeyGenerator ?? JSON.stringify)(params) as CacheKey;\n  }\n}\n\n/**\n * Configuration options for a ResourceRepository.\n * This interface provides options for customizing the behavior\n * of resource loading and caching mechanisms.\n *\n * @template TParams The type of the parameters used to load a resource.\n * @template TItem The type of the items being loaded or cached.\n *\n * @property loader A function responsible for loading a resource. It receives\n * parameters of type `TParams` and returns a Promise resolving to an item of type `TItem`.\n *\n * @property [maxAge] Optional. Specifies the maximum duration (in milliseconds)\n * for which a cached resource remains valid. Default: 5 minutes\n *\n * @property [cacheKeyGenerator] Optional. A function used to generate a unique\n * cache key based on the input parameters of type `TParams`. Default: JSON.stringify()\n */\nexport interface ResourceRepositoryOptions<TParams, TItem> {\n  loader: (params: TParams) => Promise<TItem>;\n\n  maxAge?: number;\n\n  cacheKeyGenerator?: (params: TParams) => string;\n}\n\n/**\n * Creates a new instance of a ResourceRepository with the specified options.\n *\n * @param {ResourceRepositoryOptions<TParams, TItem>} options - The configuration options for the resource repository.\n * @return {ResourceRepository<TParams, TItem>} A new instance of ResourceRepository configured with the given options.\n */\nexport function resourceRepository<TParams, TItem>(options: ResourceRepositoryOptions<TParams, TItem>): ResourceRepository<TParams, TItem> {\n  return new ResourceRepository<TParams, TItem>(options);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"angular-cool-repository.mjs","sources":["../../../projects/repository/src/lib/resource-cache.ts","../../../projects/repository/src/lib/resource-repository.ts","../../../projects/repository/src/public-api.ts","../../../projects/repository/src/angular-cool-repository.ts"],"sourcesContent":["import { BehaviorSubject, firstValueFrom, ReplaySubject } from 'rxjs';\n\nexport class ResourceCache<TItem> {\n  private _valueSubject = new ReplaySubject<TItem | undefined>(1);\n\n  private _isLoading = false;\n  private _isLoadingSubject = new BehaviorSubject<boolean>(false);\n\n  private _validUntil: number | null = null;\n\n  public get isInvalid(): boolean {\n    return this._validUntil === null || Date.now() > this._validUntil;\n  }\n\n  constructor(\n    private loader: () => Promise<TItem | undefined>,\n    private maxAge: number,\n  ) {\n  }\n\n  public getValueObservable() {\n    return this._valueSubject.asObservable();\n  }\n\n  public async keepDataFreshAsync() {\n    if (!this.isInvalid) {\n      return;\n    }\n\n    await this._reloadValueAsync();\n  }\n\n  private async _reloadValueAsync(): Promise<void> {\n    if (this._isLoading) {\n      await firstValueFrom(this._isLoadingSubject);\n\n      return;\n    }\n\n    this._setIsLoading(true);\n\n    try {\n      const data = await this.loader();\n\n      await this.setValueAsync(data);\n    } finally {\n      this._setIsLoading(false);\n    }\n  }\n\n  public async setValueAsync(value: TItem | undefined) {\n    this._validUntil = Date.now() + this.maxAge;\n    this._valueSubject.next(value);\n  }\n\n  public async getValueAsync(): Promise<TItem | undefined> {\n    await this.keepDataFreshAsync();\n\n    return firstValueFrom(this._valueSubject);\n  }\n\n  public invalidate() {\n    this._validUntil = null;\n  }\n\n  private _setIsLoading(isLoading: boolean) {\n    this._isLoading = isLoading;\n    this._isLoadingSubject.next(isLoading);\n  }\n}\n","import { Signal } from '@angular/core';\nimport { rxResource } from '@angular/core/rxjs-interop';\nimport { ResourceCache } from './resource-cache';\nimport { ResourceRepositorySignal } from '../interface/resource-repository-signal.interface';\nimport { ResourceRepository, ResourceRepositoryOptions } from '../interface/resource-repository.interface';\n\nconst DEFAULT_MAX_AGE = 5 * 60 * 1000;\n\ntype CacheKey = string;\n\nexport class ResourceRepositoryImpl<TParams, TItem> implements ResourceRepository<TParams, TItem> {\n  private _cacheStore = new Map<CacheKey, ResourceCache<TItem>>();\n\n  constructor(private options: ResourceRepositoryOptions<TParams, TItem>) {\n  }\n\n  public get(key: Signal<TParams>): ResourceRepositorySignal<TItem | undefined> {\n    const resource = rxResource<TItem | undefined, TParams>({\n      params: () => key(),\n      stream: ({ params }) => {\n        const cacheKey = this._createCacheKey(params);\n\n        let cache = this._cacheStore.get(cacheKey);\n\n        if (!cache) {\n          cache = new ResourceCache(\n            ((p) => () => this.options.loader(p))(params),\n            this.options.maxAge ?? DEFAULT_MAX_AGE,\n          );\n\n          this._cacheStore.set(cacheKey, cache);\n        }\n\n        // Do not wait for it to load\n        cache.keepDataFreshAsync();\n\n        return cache.getValueObservable();\n      }\n    });\n\n    return Object.assign(resource.asReadonly().value as ResourceRepositorySignal<TItem | undefined>, {\n      reload: async () => {\n        await this.reload(key());\n      },\n      set: async (value: TItem | undefined) => {\n        await this.setValue(key(), value as TItem);\n      }\n    });\n  }\n\n  public async reload(key: TParams): Promise<void> {\n    const cacheKey = this._createCacheKey(key);\n\n    const cache = this._cacheStore.get(cacheKey);\n\n    if (!cache) {\n      throw new Error(`No cache found for the given key: ${key}`);\n    }\n\n    cache.invalidate();\n\n    await cache.keepDataFreshAsync();\n  }\n\n  public async getValue(key: TParams): Promise<TItem | undefined> {\n    const cacheKey = this._createCacheKey(key);\n\n    const cache = this._cacheStore.get(cacheKey);\n\n    if (!cache) {\n      throw new Error(`No cache found for the given key: ${key}`);\n    }\n\n    return await cache.getValueAsync();\n  }\n\n  public async setValue(key: TParams, value: TItem): Promise<void> {\n    const cacheKey = this._createCacheKey(key);\n\n    let cache = this._cacheStore.get(cacheKey);\n\n    if (!cache) {\n      throw new Error(`No cache found for the given key: ${key}`);\n    }\n\n    await cache.setValueAsync(value);\n  }\n\n  public async updateValue(key: TParams, updateFn: (value: TItem | undefined) => Promise<TItem>): Promise<void> {\n    const value = await this.getValue(key);\n\n    await this.setValue(key, await updateFn(value));\n  }\n\n  private _createCacheKey(params: TParams): CacheKey {\n    return (this.options.cacheKeyGenerator ?? JSON.stringify)(params) as CacheKey;\n  }\n}\n","import { ResourceRepository, ResourceRepositoryOptions } from './interface/resource-repository.interface';\nimport { ResourceRepositoryImpl } from './lib/resource-repository';\n\nexport * from './interface/resource-repository-signal.interface';\nexport * from './interface/resource-repository.interface';\n\n/**\n * Creates a new instance of a ResourceRepository with the specified options.\n *\n * @param {ResourceRepositoryOptions<TParams, TItem>} options - The configuration options for the resource repository.\n * @return {ResourceRepository<TParams, TItem>} A new instance of ResourceRepository configured with the given options.\n */\nexport function resourceRepository<TParams, TItem>(options: ResourceRepositoryOptions<TParams, TItem>): ResourceRepository<TParams, TItem> {\n  return new ResourceRepositoryImpl<TParams, TItem>(options);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@angular-cool/repository",
   "description": "Cool stateful signal repository for angular",
-  "version": "21.0.5",
+  "version": "21.0.6",
   "peerDependencies": {
     "@angular/common": ">=21.0.0",
     "@angular/core": ">=21.0.0"

package/types/angular-cool-repository.d.ts

@@ -1,19 +1,24 @@
 import { Signal } from '@angular/core';
 
-type ReloadableSignal<T> = Signal<T> & {
-    reload: () => Promise<void>;
-};
-declare class ResourceRepository<TParams, TItem> {
-    private options;
-    private _cacheStore;
-    constructor(options: ResourceRepositoryOptions<TParams, TItem>);
+interface ResourceRepositorySignal<T> extends Signal<T> {
+    /**
+     * Reloads or refreshes the current value.
+     */
+    readonly reload: () => Promise<void>;
+    /**
+     * Sets current value.
+     */
+    readonly set: (value: T) => Promise<void>;
+}
+
+interface ResourceRepository<TParams, TItem> {
     /**
      * Retrieves a resource cache
      *
      * @param {Signal<TParams>} key - A signal function used to resolve the parameters for retrieving or initializing the resource.
-     * @return {ReloadableSignal<TItem | undefined>} A read-only signal containing the item associated with the provided key, already cached.
+     * @return {ResourceRepositorySignal<TItem | undefined>} A read-only signal containing the item associated with the provided key, already cached.
      */
-    get(key: Signal<TParams>): ReloadableSignal<TItem | undefined>;
+    get(key: Signal<TParams>): ResourceRepositorySignal<TItem | undefined>;
     /**
      * Reloads the cache associated with the given key, ensuring it is updated with fresh data.
      *
@@ -47,7 +52,6 @@ declare class ResourceRepository<TParams, TItem> {
      * @return {Promise<void>} A promise that resolves when the update operation is complete.
      */
     updateValue(key: TParams, updateFn: (value: TItem | undefined) => Promise<TItem>): Promise<void>;
-    private _createCacheKey;
 }
 /**
  * Configuration options for a ResourceRepository.
@@ -71,6 +75,7 @@ interface ResourceRepositoryOptions<TParams, TItem> {
     maxAge?: number;
     cacheKeyGenerator?: (params: TParams) => string;
 }
+
 /**
  * Creates a new instance of a ResourceRepository with the specified options.
  *
@@ -80,4 +85,4 @@ interface ResourceRepositoryOptions<TParams, TItem> {
 declare function resourceRepository<TParams, TItem>(options: ResourceRepositoryOptions<TParams, TItem>): ResourceRepository<TParams, TItem>;
 
 export { resourceRepository };
-export type { ReloadableSignal, ResourceRepositoryOptions };
+export type { ResourceRepository, ResourceRepositoryOptions, ResourceRepositorySignal };