@mmstack/resource 19.3.2 → 19.4.1

package/lib/mutation-resource.d.ts

@@ -1,5 +1,5 @@
 import { type HttpResourceRequest } from '@angular/common/http';
-import { Signal, ValueEqualityFn } from '@angular/core';
+import { type Signal, type ValueEqualityFn } from '@angular/core';
 import { type QueryResourceOptions, type QueryResourceRef } from './query-resource';
 /**
  * @internal

package/lib/util/dedupe-interceptor.d.ts

@@ -1,4 +1,4 @@
-import { HttpContext, HttpInterceptorFn } from '@angular/common/http';
+import { HttpContext, type HttpInterceptorFn, type HttpRequest } from '@angular/common/http';
 /**
  * Disables request deduplication for a specific HTTP request.
  *
@@ -24,6 +24,9 @@ export declare function noDedupe(ctx?: HttpContext): HttpContext;
  *
  * @param allowed - An array of HTTP methods for which deduplication should be enabled.
  *                  Defaults to `['GET', 'DELETE', 'HEAD', 'OPTIONS']`.
+ * @param keyFn - Optional function to compute the dedupe key from a request.
+ *                Defaults to `hashRequest`, which includes method, URL,
+ *                response type, params, and body.
  *
  * @returns An `HttpInterceptorFn` that implements the request deduplication logic.
  *
@@ -47,4 +50,4 @@ export declare function noDedupe(ctx?: HttpContext): HttpContext;
  *   ],
  * };
  */
-export declare function createDedupeRequestsInterceptor(allowed?: string[]): HttpInterceptorFn;
+export declare function createDedupeRequestsInterceptor(allowed?: string[], keyFn?: (req: HttpRequest<unknown>) => string): HttpInterceptorFn;

package/lib/util/hash-request.d.ts

@@ -0,0 +1,21 @@
+import { type HttpRequest, type HttpResourceRequest } from '@angular/common/http';
+type HashableRequest = {
+    method?: string;
+    url: string;
+    responseType?: string;
+    params?: HttpResourceRequest['params'] | HttpRequest<unknown>['params'];
+    body?: unknown;
+};
+/**
+ * Builds a stable cache/dedupe key from an HTTP request shape (accepts both
+ * `HttpRequest` and `HttpResourceRequest`).
+ *
+ * Key composition: `${method}:${url}:${responseType}[:${params}][:${body}]`
+ * - `method` defaults to `'GET'`, `responseType` to `'json'` (Angular defaults).
+ * - Query params are sorted alphabetically and URL-encoded for stability.
+ * - Body hashing handles `File`/`Blob`/`FormData`/`URLSearchParams`/`ArrayBuffer`
+ *   and typed arrays explicitly; everything else flows through key-sorted
+ *   `JSON.stringify` via `hash()`.
+ */
+export declare function hashRequest(req: HashableRequest): string;
+export {};

package/lib/util/hash-unknown.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Generates a stable, unique string hash from one or more arguments.
+ * Useful for creating cache keys or identifiers where object key order shouldn't matter.
+ *
+ * How it works:
+ * - Object-like values (plain objects, class instances, `Object.create(null)`) have
+ *   their own enumerable keys sorted alphabetically before hashing. This ensures
+ *   `{ a: 1, b: 2 }` and `{ b: 2, a: 1 }` produce the same hash.
+ * - `Map` and `Set` are serialized via stable, sorted markers (`__map__` / `__set__`).
+ * - Arrays preserve positional order; `Date` uses its ISO string via `toJSON`.
+ *
+ * @param {...unknown} args Values to include in the hash.
+ * @returns A stable string hash representing the input arguments.
+ * @example
+ * hash('posts', 10);
+ * // => '["posts",10]'
+ *
+ * hash({ a: 1, b: 2 }) === hash({ b: 2, a: 1 }); // true
+ *
+ * hash(new Map([['a', 1]])) === hash(new Map([['a', 1]])); // true
+ *
+ * // Be mindful of values JSON.stringify cannot handle (functions, undefined, Symbols)
+ * // hash('a', undefined, function() {}) => '["a",null,null]'
+ */
+export declare function hash(...args: unknown[]): string;

package/lib/util/index.d.ts

@@ -4,9 +4,9 @@ export * from './circuit-breaker';
 export * from './dedupe-interceptor';
 export * from './equality';
 export * from './has-slow-connection';
+export * from './hash-request';
 export * from './persist';
 export * from './refresh';
 export * from './retry-on-error';
 export * from './sensors';
 export * from './to-resource-object';
-export * from './url-with-params';

package/package.json

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

package/lib/util/url-with-params.d.ts

@@ -1,2 +0,0 @@
-import { type HttpResourceRequest } from '@angular/common/http';
-export declare function urlWithParams(req: HttpResourceRequest): string;