@mmstack/resource 19.7.0 → 19.7.1

package/lib/util/cache/cache.d.ts

@@ -265,6 +265,26 @@ type CacheOptions = {
      */
     version?: number;
 };
+/**
+ * Provides a deterministic, in-memory `QueryCache` for unit tests.
+ *
+ * Unlike {@link provideQueryCache} this never touches IndexedDB or BroadcastChannel
+ * and disables the cleanup sweep interval (`checkInterval: Infinity`), so it plays
+ * nicely with `vi.useFakeTimers()`. It's a real cache (not a stub), so you can
+ * assert cache hits via {@link injectQueryCache} / its `stats` signal.
+ *
+ * @example
+ * TestBed.configureTestingModule({
+ *   providers: [
+ *     provideMockQueryCache(),
+ *     provideHttpClient(withInterceptors([createCacheInterceptor()])),
+ *   ],
+ * });
+ */
+export declare function provideMockQueryCache(opt?: {
+    ttl?: number;
+    staleTime?: number;
+}): Provider;
 /**
  * Provides the instance of the QueryCache for queryResource. This should probably be called
  * in your application's root configuration, but can also be overriden with component/module providers.

package/lib/util/cache/index.d.ts

@@ -1,2 +1,2 @@
-export { Cache, injectCacheStats, injectQueryCache, provideQueryCache, } from './cache';
+export { Cache, injectCacheStats, injectQueryCache, provideMockQueryCache, provideQueryCache, } from './cache';
 export * from './cache-interceptor';

package/lib/util/cache/public_api.d.ts

@@ -1,2 +1,2 @@
-export { Cache, injectQueryCache, provideQueryCache, type CacheEntry, type CleanupType, } from './cache';
+export { Cache, injectQueryCache, provideMockQueryCache, provideQueryCache, type CacheEntry, type CleanupType, } from './cache';
 export { createCacheInterceptor } from './cache-interceptor';

package/lib/util/public_api.d.ts

@@ -2,3 +2,4 @@ export * from './cache/public_api';
 export { createCircuitBreaker, provideCircuitBreakerDefaultOptions, } from './circuit-breaker';
 export { createDedupeRequestsInterceptor, noDedupe, } from './dedupe-interceptor';
 export { hashRequest } from './hash-request';
+export { provideMockResourceSensors } from './sensors';

package/lib/util/sensors.d.ts

@@ -1,9 +1,32 @@
+import { type Provider, type Signal } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class ResourceSensors {
     readonly networkStatus: import("@mmstack/primitives").NetworkStatusSignal;
-    readonly pageVisibility: import("@angular/core").Signal<DocumentVisibilityState>;
+    readonly pageVisibility: Signal<DocumentVisibilityState>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ResourceSensors, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ResourceSensors>;
 }
 export declare function injectNetworkStatus(): import("@mmstack/primitives").NetworkStatusSignal;
-export declare function injectPageVisibility(): import("@angular/core").Signal<DocumentVisibilityState>;
+export declare function injectPageVisibility(): Signal<DocumentVisibilityState>;
+/**
+ * Provides controllable {@link ResourceSensors} for unit tests, letting you drive a
+ * resource's offline / page-hidden behavior deterministically instead of relying on
+ * the real `navigator.onLine` / `document.visibilityState`.
+ *
+ * Pass your own writable signals to toggle state mid-test; omit them for a static
+ * online + visible environment.
+ *
+ * @example
+ * import { signal } from '@angular/core';
+ *
+ * const online = signal(true);
+ * TestBed.configureTestingModule({
+ *   providers: [provideMockResourceSensors({ networkStatus: online })],
+ * });
+ * // ...later in the test
+ * online.set(false); // the resource now sees the network as down
+ */
+export declare function provideMockResourceSensors(opt?: {
+    networkStatus?: Signal<boolean>;
+    pageVisibility?: Signal<DocumentVisibilityState>;
+}): Provider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmstack/resource",
-  "version": "19.7.0",
+  "version": "19.7.1",
   "keywords": [
     "angular",
     "signals",