@mmstack/resource 21.5.0 → 21.5.1

package/package.json

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

package/types/mmstack-resource.d.ts

@@ -273,6 +273,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()])),
+ *   ],
+ * });
+ */
+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.
@@ -606,6 +626,29 @@ type RetryOptions = number | {
     backoff?: number;
 };
 
+/**
+ * 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
+ */
+declare function provideMockResourceSensors(opt?: {
+    networkStatus?: Signal<boolean>;
+    pageVisibility?: Signal<DocumentVisibilityState>;
+}): Provider;
+
 /**
  * Options for enabling and configuring caching for a resource.
  *
@@ -1314,5 +1357,5 @@ declare function mutationResource<TResult, TRaw = TResult, TMutation = TResult,
     body: TMutation;
 }) | undefined | void, options0?: MutationResourceOptions<TResult, TRaw, TMutation, TCTX, TICTX>): MutationResourceRef<TResult, TMutation, TICTX>;
 
-export { Cache, MutationCancelledError, PAUSED, applyResourceRegistration, createCacheInterceptor, createCircuitBreaker, createDedupeRequestsInterceptor, hashRequest, infiniteQueryResource, injectQueryCache, injectResourceOptions, manualQueryResource, mutationResource, noDedupe, provideCircuitBreakerDefaultOptions, provideMutationResourceOptions, provideQueryCache, provideQueryResourceOptions, provideResourceOptions, provideTypedResourceOptions, queryResource };
+export { Cache, MutationCancelledError, PAUSED, applyResourceRegistration, createCacheInterceptor, createCircuitBreaker, createDedupeRequestsInterceptor, hashRequest, infiniteQueryResource, injectQueryCache, injectResourceOptions, manualQueryResource, mutationResource, noDedupe, provideCircuitBreakerDefaultOptions, provideMockQueryCache, provideMockResourceSensors, provideMutationResourceOptions, provideQueryCache, provideQueryResourceOptions, provideResourceOptions, provideTypedResourceOptions, queryResource };
 export type { CacheEntry, CleanupType, CommonResourceOptions, DisabledReason, InfiniteQueryResourceOptions, InfiniteQueryResourceRef, InfiniteRequestContext, ManualQueryResourceRef, MutationCancellationReason, MutationQueueOptions, MutationResourceOptions, MutationResourceRef, QueryResourceOptions, QueryResourceRef, RefreshOptions, RequestContext, ResourceCacheOptions, ResourceRequestFn, TransitionRegistration };