feathers-utils 10.0.0-rc.9 → 10.0.0

package/dist/guards.mjs

@@ -25,7 +25,7 @@
 function hasQuery(params) {
 	return !!params.query;
 }
-
 //#endregion
 export { hasQuery };
+
 //# sourceMappingURL=guards.mjs.map

package/dist/guards.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"guards.mjs","names":[],"sources":["../src/guards/has-query/has-query.guard.ts"],"sourcesContent":["import type { Params } from '@feathersjs/feathers'\nimport type { RequiredQuery } from '../../utility-types/required-query.js'\n\n/**\n * Type guard to check if the `query` property of `Params` is present and non-nullable.\n *\n * @param params - The `Params` object to check.\n * @returns `true` if `params.query` is present and non-nullable, otherwise `false`.\n *\n * @see https://utils.feathersjs.com/guards/has-query.html\n *\n * @example\n * ```ts\n * import { hasQuery } from 'feathers-utils/guards'\n *\n * function example(params: Params) {\n *   // `params.query` is optional and can be undefined at this point\n *   if (!hasQuery(params)) {\n *     return;\n *   }\n *\n *   // TypeScript now knows that params.query is present and non-nullable\n *   // You can safely access params.query here without additional checks\n * }\n * ```\n */\nexport function hasQuery<P extends Params>(\n  params: P,\n): params is RequiredQuery<P> {\n  return !!params.query\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,SACd,QAC4B;AAC5B,QAAO,CAAC,CAAC,OAAO"}
+{"version":3,"file":"guards.mjs","names":[],"sources":["../src/guards/has-query/has-query.guard.ts"],"sourcesContent":["import type { Params } from '@feathersjs/feathers'\nimport type { RequiredQuery } from '../../utility-types/required-query.js'\n\n/**\n * Type guard to check if the `query` property of `Params` is present and non-nullable.\n *\n * @param params - The `Params` object to check.\n * @returns `true` if `params.query` is present and non-nullable, otherwise `false`.\n *\n * @see https://utils.feathersjs.com/guards/has-query.html\n *\n * @example\n * ```ts\n * import { hasQuery } from 'feathers-utils/guards'\n *\n * function example(params: Params) {\n *   // `params.query` is optional and can be undefined at this point\n *   if (!hasQuery(params)) {\n *     return;\n *   }\n *\n *   // TypeScript now knows that params.query is present and non-nullable\n *   // You can safely access params.query here without additional checks\n * }\n * ```\n */\nexport function hasQuery<P extends Params>(\n  params: P,\n): params is RequiredQuery<P> {\n  return !!params.query\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,SACd,QAC4B;CAC5B,OAAO,CAAC,CAAC,OAAO"}

package/dist/{hook-context-D16ztLk5.d.mts → hook-context-aHkq1h0N.d.mts}

@@ -2,6 +2,7 @@ import { HookContext, NextFunction, Paginated, Params } from "@feathersjs/feathe
 
 //#region src/internal.utils.d.ts
 type MaybeArray<T> = T | readonly T[];
+type UnpackMaybeArray<T> = T extends readonly (infer E)[] ? E : T;
 type Promisable<T> = T | Promise<T>;
 type KeyOf<T> = Extract<keyof T, string>;
 type UnwrapArray<T> = T extends Array<infer U> ? U : T;
@@ -46,5 +47,5 @@ type UnwrapPaginatedOrArray<T> = T extends Paginated<infer D> ? D : T extends an
 type ResultSingleHookContext<H extends HookContext> = UnwrapPaginatedOrArray<NonNullable<H['result']>>;
 type DataSingleHookContext<H extends HookContext> = UnwrapArray<NonNullable<H['data']>>;
 //#endregion
-export { Promisable as A, hookTypes as C, KeyOfOrDotNotation as D, KeyOf as E, MaybeArray as O, TransportName as S, AnyFallback as T, PredicateItemWithContext as _, ContextFunction as a, TransformerFn as b, DefaultsInput as c, HookFunction as d, HookType$1 as f, PredicateFn as g, PredicateContextSync as h, UnwrapPaginatedOrArray as i, UnwrapArray as j, NeverFallback as k, DispatchOption as l, PredicateContextAsync as m, ResultSingleHookContext as n, ContextFunctionAsync as o, MethodName as p, UnwrapPaginated as r, ContextFunctionSync as s, DataSingleHookContext as t, FieldKey as u, StringFieldKey as v, methodNames as w, TransformerInputFn as x, TransformParamsFn as y };
-//# sourceMappingURL=hook-context-D16ztLk5.d.mts.map
+export { Promisable as A, hookTypes as C, KeyOfOrDotNotation as D, KeyOf as E, UnwrapArray as M, MaybeArray as O, TransportName as S, AnyFallback as T, PredicateItemWithContext as _, ContextFunction as a, TransformerFn as b, DefaultsInput as c, HookFunction as d, HookType$1 as f, PredicateFn as g, PredicateContextSync as h, UnwrapPaginatedOrArray as i, UnpackMaybeArray as j, NeverFallback as k, DispatchOption as l, PredicateContextAsync as m, ResultSingleHookContext as n, ContextFunctionAsync as o, MethodName as p, UnwrapPaginated as r, ContextFunctionSync as s, DataSingleHookContext as t, FieldKey as u, StringFieldKey as v, methodNames as w, TransformerInputFn as x, TransformParamsFn as y };
+//# sourceMappingURL=hook-context-aHkq1h0N.d.mts.map

package/dist/{traverse.hook-C2VIvQrn.mjs → hooks-DPFxxjBu.mjs}

@@ -1,18 +1,18 @@
-import { f as isMulti, l as isProvider, m as every, t as throwIf } from "./throw-if.hook-CiuUMtny.mjs";
-import { d as checkContext, f as addToQuery, h as sortQueryProperties, r as transformParams, u as contextToJson } from "./zip-data-result.util-CVD17gWe.mjs";
-import { a as traverse$1, i as isPromise, r as toArray, t as early } from "./internal.utils-C8LH1H55.mjs";
-import { i as getDataIsArray, r as getResultIsArray } from "./mutate-result.util-C8ZumXWd.mjs";
-import { r as transformData } from "./transform-result.hook-BZ55kPq7.mjs";
+import { g as every, p as isMulti, t as throwIf, u as isProvider } from "./predicates-CT08opkD.mjs";
+import { d as checkContext, f as addToQuery, h as sortQueryProperties, r as transformParams, u as contextToJson } from "./utils-1I_iPZkV.mjs";
+import { a as traverse$1, i as isPromise, r as toArray, t as early } from "./internal.utils-BWQ25nOd.mjs";
+import { i as getDataIsArray, r as getResultIsArray } from "./mutate-result.util-CCBWix-G.mjs";
+import { r as transformData } from "./transform-result.hook-CevWK5TA.mjs";
+import "./resolve-Cx9osy8O.mjs";
 import isObject from "lodash/isObject.js";
 import { copy } from "fast-copy";
-import { BadRequest, Forbidden, MethodNotAllowed } from "@feathersjs/errors";
+import { BadRequest, Forbidden, MethodNotAllowed, TooManyRequests } from "@feathersjs/errors";
 import _get from "lodash/get.js";
 import _has from "lodash/has.js";
 import _omit from "lodash/omit.js";
 import _set from "lodash/set.js";
 import _setWith from "lodash/setWith.js";
 import _clone from "lodash/clone.js";
-
 //#region src/hooks/cache/cache-utils.ts
 const stableStringify = (obj) => {
 	if (obj.query) obj = {
@@ -28,7 +28,6 @@ const stableStringify = (obj) => {
 		return value;
 	});
 };
-
 //#endregion
 //#region src/hooks/cache/cache.hook.ts
 /**
@@ -175,7 +174,6 @@ var ContextCacheMap = class {
 		return context;
 	}
 };
-
 //#endregion
 //#region src/hooks/check-multi/check-multi.hook.ts
 /**
@@ -197,13 +195,13 @@ var ContextCacheMap = class {
 function checkMulti(options) {
 	return (context, next) => {
 		const { service, method } = context;
-		if (!service.allowsMulti || !isMulti(context) || method === "find") return context;
-		if (!service.allowsMulti(method)) throw options?.error ? options.error(context) : new MethodNotAllowed(`Can not ${method} multiple entries`);
-		if (next) return next();
-		return context;
+		if (!service.allowsMulti || !isMulti(context) || method === "find" || service.allowsMulti(method)) {
+			if (next) return next();
+			return context;
+		}
+		throw options?.error ? options.error(context) : new MethodNotAllowed(`Can not ${method} multiple entries`);
 	};
 }
-
 //#endregion
 //#region src/hooks/check-required/check-required.hook.ts
 /**
@@ -225,11 +223,15 @@ function checkMulti(options) {
 function checkRequired(fieldNames) {
 	const fieldNamesArray = toArray(fieldNames);
 	return (context, next) => {
-		checkContext(context, ["before", "around"], [
-			"create",
-			"update",
-			"patch"
-		], "checkRequired");
+		checkContext(context, {
+			type: ["before", "around"],
+			method: [
+				"create",
+				"update",
+				"patch"
+			],
+			label: "checkRequired"
+		});
 		const { data } = getDataIsArray(context);
 		for (let i = 0; i < data.length; i++) {
 			const item = data[i];
@@ -243,7 +245,6 @@ function checkRequired(fieldNames) {
 		if (next) return next();
 	};
 }
-
 //#endregion
 //#region src/hooks/create-related/create-related.hook.ts
 /**
@@ -266,7 +267,11 @@ function checkRequired(fieldNames) {
 */
 function createRelated(options) {
 	return async (context, next) => {
-		checkContext(context, ["after", "around"], ["create"], "createRelated");
+		checkContext(context, {
+			type: ["after", "around"],
+			method: ["create"],
+			label: "createRelated"
+		});
 		if (next) await next();
 		const { result } = getResultIsArray(context);
 		const entries = Array.isArray(options) ? options : [options];
@@ -279,7 +284,6 @@ function createRelated(options) {
 		}));
 	};
 }
-
 //#endregion
 //#region src/hooks/debug/debug.hook.ts
 /**
@@ -315,7 +319,6 @@ const debug = (msg, ...fieldNames) => async (context, next) => {
 	});
 	if (context.error) console.log("error", context.error);
 };
-
 //#endregion
 //#region src/hooks/disable-pagination/disable-pagination.hook.ts
 /**
@@ -336,7 +339,11 @@ const debug = (msg, ...fieldNames) => async (context, next) => {
 * @see https://utils.feathersjs.com/hooks/disable-pagination.html
 */
 const disablePagination = () => (context, next) => {
-	checkContext(context, ["before", "around"], ["find"], "disablePagination");
+	checkContext(context, {
+		type: ["before", "around"],
+		method: ["find"],
+		label: "disablePagination"
+	});
 	const $limit = context.params?.query?.$limit;
 	if ($limit === "-1" || $limit === -1) {
 		context.params.paginate = false;
@@ -345,7 +352,6 @@ const disablePagination = () => (context, next) => {
 	if (next) return next();
 	return context;
 };
-
 //#endregion
 //#region src/hooks/disallow/disallow.hook.ts
 /**
@@ -371,17 +377,20 @@ const disallow = (transports) => {
 	const transportsArr = toArray(transports);
 	return (context, next) => {
 		if (!transports) throw new MethodNotAllowed("Method not allowed");
-		if (isProvider(...transportsArr)(context)) throw new MethodNotAllowed(`Provider '${context.params.provider}' can not call '${context.method}'. (disallow)`);
+		if (isProvider(...transportsArr)(context)) throw new MethodNotAllowed(`Provider '${context.params.provider}' can not call '${context.method}' on '${context.path}'. (disallow)`);
 		if (next) return next().then(() => context);
 	};
 };
-
 //#endregion
 //#region src/hooks/on-delete/on-delete.hook.ts
 const onDelete = (options) => {
 	const optionsMulti = Array.isArray(options) ? options : [options];
 	return async (context, next) => {
-		checkContext(context, ["after", "around"], "remove", "onDelete");
+		checkContext(context, {
+			type: ["after", "around"],
+			method: "remove",
+			label: "onDelete"
+		});
 		if (next) await next();
 		const { result } = getResultIsArray(context);
 		if (!result.length) return;
@@ -408,11 +417,9 @@ const onDelete = (options) => {
 		if (promises.length) await Promise.all(promises);
 	};
 };
-
 //#endregion
 //#region src/hooks/params-for-server/params-for-from-shared.ts
 const FROM_CLIENT_FOR_SERVER_DEFAULT_KEY = "_$client";
-
 //#endregion
 //#region src/hooks/params-for-server/params-for-server.hook.ts
 /**
@@ -454,7 +461,6 @@ const paramsForServer = (whitelist, options) => {
 		return context;
 	};
 };
-
 //#endregion
 //#region src/hooks/params-from-client/params-from-client.hook.ts
 /**
@@ -478,7 +484,10 @@ const paramsFromClient = (whitelist, options) => {
 	const whitelistArr = toArray(whitelist);
 	const { keyToHide = FROM_CLIENT_FOR_SERVER_DEFAULT_KEY } = options || {};
 	return (context, next) => {
-		if (!context.params?.query?.[keyToHide] || typeof context.params.query[keyToHide] !== "object") return context;
+		if (!context.params?.query?.[keyToHide] || typeof context.params.query[keyToHide] !== "object") {
+			if (next) return next();
+			return context;
+		}
 		const params = {
 			...context.params,
 			query: {
@@ -499,7 +508,6 @@ const paramsFromClient = (whitelist, options) => {
 		return context;
 	};
 };
-
 //#endregion
 //#region src/hooks/prevent-changes/prevent-changes.hook.ts
 /**
@@ -531,7 +539,47 @@ const preventChanges = (fieldNames, options) => {
 		return item;
 	});
 };
-
+//#endregion
+//#region src/hooks/rate-limit/rate-limit.hook.ts
+/**
+* Rate limits service method calls using `rate-limiter-flexible`.
+* You provide a pre-configured `RateLimiterAbstract` instance
+* (Memory, Redis, Mongo, etc.) and the hook consumes points per request.
+*
+* @example
+* ```ts
+* import { rateLimit } from 'feathers-utils/hooks'
+* import { RateLimiterMemory } from 'rate-limiter-flexible'
+*
+* const rateLimiter = new RateLimiterMemory({ points: 10, duration: 1 })
+*
+* app.service('users').hooks({
+*   before: { find: [rateLimit(rateLimiter)] }
+* })
+* ```
+*
+* @see https://utils.feathersjs.com/hooks/rate-limit.html
+*/
+const rateLimit = (rateLimiter, options) => {
+	const key = options?.key ?? ((context) => context.path);
+	const points = options?.points ?? (() => 1);
+	return async (context, next) => {
+		checkContext(context, {
+			type: ["before", "around"],
+			label: "rateLimit"
+		});
+		const resolvedKey = await key(context);
+		const resolvedPoints = await points(context);
+		try {
+			const res = await rateLimiter.consume(resolvedKey, resolvedPoints);
+			context.params.rateLimit = res;
+		} catch (res) {
+			context.params.rateLimit = res;
+			throw new TooManyRequests("Too many requests", { rateLimitRes: res });
+		}
+		if (next) return await next();
+	};
+};
 //#endregion
 //#region src/hooks/set-data/set-data.hook.ts
 /**
@@ -556,8 +604,14 @@ function setData(from, to, options) {
 		const { data } = getDataIsArray(context);
 		const contextJson = contextToJson(context);
 		if (!_has(contextJson, from)) {
-			if (!context.params?.provider || allowUndefined === true) return context;
-			if (!overwrite && data.every((item) => _has(item, to))) return context;
+			if (!context.params?.provider || allowUndefined === true) {
+				if (next) return next();
+				return context;
+			}
+			if (!overwrite && data.every((item) => _has(item, to))) {
+				if (next) return next();
+				return context;
+			}
 			throw options?.error ? options.error(context, from) : new Forbidden(`Expected field ${from.toString()} not available`);
 		}
 		const val = _get(contextJson, from);
@@ -570,7 +624,6 @@ function setData(from, to, options) {
 		return context;
 	};
 }
-
 //#endregion
 //#region src/hooks/set-field/set-field.hook.ts
 /**
@@ -591,17 +644,22 @@ function setData(from, to, options) {
 */
 const setField = ({ as, from, allowUndefined = false, error }) => (context, next) => {
 	const { params } = context;
-	checkContext(context, ["before", "around"], null, "setField");
+	checkContext(context, {
+		type: ["before", "around"],
+		label: "setField"
+	});
 	const value = _get(context, from);
 	if (value === void 0) {
-		if (!params.provider || allowUndefined) return context;
+		if (!params.provider || allowUndefined) {
+			if (next) return next();
+			return context;
+		}
 		throw error ? error(context, from) : new Forbidden(`Expected field ${as} not available`);
 	}
 	context = _setWith(context, as, value, _clone);
 	if (next) return next();
 	return context;
 };
-
 //#endregion
 //#region src/hooks/set-result/set-result.hook.ts
 /**
@@ -646,11 +704,10 @@ function setResult(from, to, options) {
 		return forResultOrDispatch(context, !!options?.dispatch);
 	};
 	return (context, next) => {
-		if (next) next().then(() => fn(context));
+		if (next) return next().then(() => fn(context));
 		return fn(context);
 	};
 }
-
 //#endregion
 //#region src/hooks/set-slug/set-slug.hook.ts
 /**
@@ -680,7 +737,6 @@ const setSlug = (slug, fieldName) => {
 		return context;
 	};
 };
-
 //#endregion
 //#region src/hooks/soft-delete/soft-delete.hook.ts
 /**
@@ -704,7 +760,10 @@ const setSlug = (slug, fieldName) => {
 const softDelete = (options) => {
 	if (!options?.deletedQuery || !options?.removeData) throw new Error("You must provide `deletedQuery` and `removeData` options to the softDelete hook.");
 	return async (context, next) => {
-		checkContext(context, ["before", "around"], null, "softDelete");
+		checkContext(context, {
+			type: ["before", "around"],
+			label: "softDelete"
+		});
 		const { disableSoftDeleteKey = "disableSoftDelete" } = options;
 		if (context.params[disableSoftDeleteKey]) return early(context, next);
 		const { deletedQuery, removeData } = options;
@@ -730,7 +789,6 @@ const getValue = (value, ...args) => {
 	if (typeof value === "function") return value(...args);
 	return value;
 };
-
 //#endregion
 //#region src/hooks/stashable/stashable.hook.ts
 const defaultStashFunc = (context) => {
@@ -770,18 +828,21 @@ function stashable(options) {
 			if (next) return next();
 			return context;
 		}
-		checkContext(context, ["before", "around"], [
-			"update",
-			"patch",
-			"remove"
-		], "stashable");
+		checkContext(context, {
+			type: ["before", "around"],
+			method: [
+				"update",
+				"patch",
+				"remove"
+			],
+			label: "stashable"
+		});
 		const promise = stashFunc(context).catch(() => void 0);
 		context.params[propName] = () => promise;
 		if (next) return next();
 		return context;
 	});
 }
-
 //#endregion
 //#region src/hooks/throw-if-is-multi/throw-if-is-multi.hook.ts
 const defaultError$1 = (context) => new BadRequest(`Cannot perform multi operation on method '${context.method}'`);
@@ -802,7 +863,6 @@ const defaultError$1 = (context) => new BadRequest(`Cannot perform multi operati
 * @see https://utils.feathersjs.com/hooks/throw-if-is-multi.html
 */
 const throwIfIsMulti = (options) => throwIf(every(every(isMulti, (context) => context.method !== "find"), options?.filter), { error: options?.error ?? defaultError$1 });
-
 //#endregion
 //#region src/hooks/throw-if-is-provider/throw-if-is-provider.hook.ts
 const defaultError = (context) => new MethodNotAllowed(`Provider '${context.params.provider}' can not call '${context.method}'.`);
@@ -825,7 +885,6 @@ const defaultError = (context) => new MethodNotAllowed(`Provider '${context.para
 const throwIfIsProvider = (transports, options) => {
 	return throwIf(every(isProvider(...toArray(transports)), options?.filter), { error: options?.error ?? defaultError });
 };
-
 //#endregion
 //#region src/hooks/traverse/traverse.hook.ts
 /**
@@ -851,7 +910,7 @@ const traverse = ({ transformer, getObject }) => (context, next) => {
 	if (next) return next();
 	return context;
 };
-
 //#endregion
-export { createRelated as _, softDelete as a, cache as b, setField as c, paramsFromClient as d, paramsForServer as f, debug as g, disablePagination as h, stashable as i, setData as l, disallow as m, throwIfIsProvider as n, setSlug as o, onDelete as p, throwIfIsMulti as r, setResult as s, traverse as t, preventChanges as u, checkRequired as v, checkMulti as y };
-//# sourceMappingURL=traverse.hook-C2VIvQrn.mjs.map
+export { debug as _, softDelete as a, checkMulti as b, setField as c, preventChanges as d, paramsFromClient as f, disablePagination as g, disallow as h, stashable as i, setData as l, onDelete as m, throwIfIsProvider as n, setSlug as o, paramsForServer as p, throwIfIsMulti as r, setResult as s, traverse as t, rateLimit as u, createRelated as v, cache as x, checkRequired as y };
+
+//# sourceMappingURL=hooks-DPFxxjBu.mjs.map

package/dist/hooks-DPFxxjBu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-DPFxxjBu.mjs","names":["defaultError"],"sources":["../src/hooks/cache/cache-utils.ts","../src/hooks/cache/cache.hook.ts","../src/hooks/check-multi/check-multi.hook.ts","../src/hooks/check-required/check-required.hook.ts","../src/hooks/create-related/create-related.hook.ts","../src/hooks/debug/debug.hook.ts","../src/hooks/disable-pagination/disable-pagination.hook.ts","../src/hooks/disallow/disallow.hook.ts","../src/hooks/on-delete/on-delete.hook.ts","../src/hooks/params-for-server/params-for-from-shared.ts","../src/hooks/params-for-server/params-for-server.hook.ts","../src/hooks/params-from-client/params-from-client.hook.ts","../src/hooks/prevent-changes/prevent-changes.hook.ts","../src/hooks/rate-limit/rate-limit.hook.ts","../src/hooks/set-data/set-data.hook.ts","../src/hooks/set-field/set-field.hook.ts","../src/hooks/set-result/set-result.hook.ts","../src/hooks/set-slug/set-slug.hook.ts","../src/hooks/soft-delete/soft-delete.hook.ts","../src/hooks/stashable/stashable.hook.ts","../src/hooks/throw-if-is-multi/throw-if-is-multi.hook.ts","../src/hooks/throw-if-is-provider/throw-if-is-provider.hook.ts","../src/hooks/traverse/traverse.hook.ts"],"sourcesContent":["import isObject from 'lodash/isObject.js'\nimport { sortQueryProperties } from '../../utils/sort-query-properties/sort-query-properties.util.js'\n\nexport { sortQueryProperties }\n\nexport const stableStringify = (obj: Record<string, any>) => {\n  if (obj.query) {\n    obj = { ...obj, query: sortQueryProperties(obj.query) }\n  }\n\n  return JSON.stringify(obj, (key, value) => {\n    if (typeof value === 'function') {\n      throw new Error('Cannot stringify non JSON value')\n    }\n\n    if (isObject(value)) {\n      return Object.keys(value)\n        .sort()\n        .reduce(\n          (result, key) => {\n            result[key] = (value as any)[key]\n            return result\n          },\n          {} as Record<string, any>,\n        )\n    }\n\n    return value\n  })\n}\n","import type { HookContext, NextFunction, Params } from '@feathersjs/feathers'\nimport { stableStringify } from './cache-utils.js'\nimport { copy } from 'fast-copy'\nimport type { Promisable } from '../../internal.utils.js'\n\ntype Cache = {\n  get: (key: string) => Promisable<any>\n  set: (key: string, value: any) => Promisable<any>\n  delete: (key: string) => Promisable<any>\n  clear: () => any\n  keys: () => IterableIterator<string>\n}\n\nexport type CacheEvent =\n  | { type: 'hit'; method: string; key: string }\n  | { type: 'miss'; method: string; key: string }\n  | { type: 'set'; method: string; key: string }\n  | { type: 'invalidate'; method: string; key: string }\n  | { type: 'clear'; method: string }\n\nexport type CacheOptions = {\n  /**\n   * The cache implementation to use. It should implement the methods `get`, `set`, `delete`, `clear`, and `keys`.\n   * This can be a Map, Redis client, or any other cache implementation.\n   *\n   * Use 'lru-cache' for an LRU cache implementation.\n   */\n  map: Cache\n  /**\n   * The id field to use for caching. Defaults to `service.options.id` and if not found, then 'id'.\n   */\n  id?: string\n  /**\n   * params are stringified for the key-value cache.\n   * There are params properties you don't want to include in the cache key.\n   * You can use this function to transform the params before they are stringified.\n   */\n  transformParams: (params: Params) => Params\n  /**\n   * Custom serialization function for converting params into a cache key string.\n   * By default, uses `stableStringify` which sorts object keys and normalizes\n   * query operator arrays (`$or`, `$and`, `$in`, etc.) for order-independent caching.\n   *\n   * Override this to use a custom serialization strategy.\n   *\n   * @example\n   * ```ts\n   * cache({\n   *   map: new Map(),\n   *   transformParams: (params) => ({ query: params.query }),\n   *   serialize: (params) => JSON.stringify(params),\n   * })\n   * ```\n   */\n  serialize?: (params: Params) => string\n  /**\n   * Optional logger callback for cache events (hit, miss, set, invalidate, clear).\n   * Useful for debugging and monitoring cache behavior.\n   *\n   * @example\n   * ```ts\n   * cache({\n   *   map: new Map(),\n   *   transformParams: (params) => ({ query: params.query }),\n   *   logger: (event) => console.log(`cache ${event.type}`, event),\n   * })\n   * ```\n   */\n  logger?: (event: CacheEvent) => void\n}\n\n/**\n * Caches `get` and `find` results based on `params`. On mutating methods (`create`, `update`,\n * `patch`, `remove`), affected cache entries are automatically invalidated.\n * Works as a `before`, `after`, or `around` hook.\n *\n * @example\n * ```ts\n * import { cache } from 'feathers-utils/hooks'\n *\n * const myCache = new Map()\n *\n * app.service('users').hooks({\n *   around: {\n *     all: [cache({ map: myCache, transformParams: (params) => ({ query: params.query }) })]\n *   }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/cache.html\n */\nexport const cache = <H extends HookContext = HookContext>(\n  options: CacheOptions,\n) => {\n  const cacheMap = new ContextCacheMap(options)\n  return async (context: H, next?: NextFunction) => {\n    if (context.type === 'before') {\n      return await cacheBefore(context, cacheMap)\n    }\n    if (context.type === 'after') {\n      return await cacheAfter(context, cacheMap)\n    }\n\n    if (context.type === 'around' && next) {\n      await cacheBefore(context, cacheMap)\n      await next()\n      await cacheAfter(context, cacheMap)\n      return\n    }\n  }\n}\n\nconst cacheBefore = async (context: HookContext, cacheMap: ContextCacheMap) => {\n  if (context.method === 'get' || context.method === 'find') {\n    const value = await cacheMap.get(context)\n    if (value) {\n      context.result = value\n    }\n  }\n\n  return context\n}\n\nconst cacheAfter = async (context: HookContext, cacheMap: ContextCacheMap) => {\n  if (context.method === 'get' || context.method === 'find') {\n    await cacheMap.set(context)\n  } else {\n    await cacheMap.clear(context)\n  }\n\n  return context\n}\n\nclass ContextCacheMap {\n  map: Cache\n  private delimiter = ':'\n  private options: CacheOptions\n  private log: ((event: CacheEvent) => void) | undefined\n  private serialize: (params: Params) => string\n\n  constructor(options: CacheOptions) {\n    this.map = options.map\n    this.options = options\n    this.log = options.logger\n    this.serialize = options.serialize ?? stableStringify\n  }\n\n  private stringifyCacheKey(context: HookContext) {\n    if (context.method !== 'get' && context.method !== 'find') {\n      throw new Error(\n        `Cache can only be used with 'get' or 'find' methods, not '${context.method}'`,\n      )\n    }\n\n    const stringifiedParams = this.serialize(\n      this.options.transformParams(context.params ?? {}),\n    )\n\n    return `${context.id ?? 'null'}${this.delimiter}${stringifiedParams}`\n  }\n\n  private getCachedId(key: string) {\n    const index = key.indexOf(this.delimiter)\n    if (index === -1) {\n      throw new Error(\n        `Cache key '${key}' does not contain a delimiter '${this.delimiter}'`,\n      )\n    }\n    return key.substring(0, index)\n  }\n\n  private getId(item: Record<string, any>, context: HookContext) {\n    const idField = context.service.options?.id || this.options.id || 'id'\n    const id = item[idField]\n    return id && id.toString ? id.toString() : id\n  }\n\n  /**\n   * Called before get() and find()\n   *\n   * returns a cached result for the given context if it exists.\n   */\n  async get(context: HookContext) {\n    const key = this.stringifyCacheKey(context)\n    const result = this.map.get(key)\n    if (result) {\n      this.log?.({ type: 'hit', method: context.method, key })\n      return copy(result) // Use copy to avoid mutation of the original result\n    }\n    this.log?.({ type: 'miss', method: context.method, key })\n  }\n\n  /**\n   * Called after get() and find()\n   *\n   * Caches the result for the given context.\n   */\n  async set(context: HookContext) {\n    const key = this.stringifyCacheKey(context)\n    this.log?.({ type: 'set', method: context.method, key })\n    return this.map.set(key, copy(context.result)) // Use copy to avoid mutation of the original result\n  }\n\n  // Called after create(), update(), patch(), and remove()\n  async clear<H extends HookContext>(context: H): Promise<H> {\n    const results = Array.isArray(context.result)\n      ? context.result\n      : [context.result]\n\n    const promises: Promise<any>[] = []\n\n    const itemIds = results\n      .map((item: any) => this.getId(item, context))\n      .filter(Boolean)\n\n    // If no itemIds are found, clear the entire cache to avoid stale data\n    if (!itemIds.length) {\n      this.log?.({ type: 'clear', method: context.method })\n      await this.map.clear()\n      return context\n    }\n\n    for (const key of this.map.keys()) {\n      const cachedId = this.getCachedId(key)\n      if (cachedId === 'null') {\n        // This is a cached `find` request. Any create/patch/update/del\n        // could affect the results of this query so it should be deleted\n        this.log?.({ type: 'invalidate', method: context.method, key })\n        promises.push(this.map.delete(key))\n        continue\n      }\n\n      // This is a cached `get` request\n\n      if (context.method === 'create') {\n        // If this is a create, we don't need to delete any cached get requests\n        continue\n      }\n\n      for (const itemId of itemIds) {\n        if (cachedId === itemId) {\n          // If the cached id matches the item id, delete the cached get\n          this.log?.({ type: 'invalidate', method: context.method, key })\n          promises.push(this.map.delete(key))\n        }\n      }\n    }\n\n    await Promise.all(promises)\n\n    return context\n  }\n}\n","import type { FeathersError } from '@feathersjs/errors'\nimport { MethodNotAllowed } from '@feathersjs/errors'\nimport type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { isMulti } from '../../predicates/index.js'\n\nexport type CheckMultiOptions = {\n  /**\n   * Customize the error that is thrown if the service does not allow multi operations.\n   *\n   * If not provided, throws a `MethodNotAllowed` error with a message indicating the operation.\n   */\n  error?: (context: HookContext) => FeathersError\n}\n\n/**\n * Checks if the `multi` option is enabled for the current method and throws a\n * `MethodNotAllowed` error if multi operations are not permitted.\n * Useful to guard against accidental bulk `create`, `patch`, or `remove` calls.\n *\n * @example\n * ```ts\n * import { checkMulti } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   before: { create: [checkMulti()] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/check-multi.html\n */\nexport function checkMulti<H extends HookContext = HookContext>(\n  options?: CheckMultiOptions,\n) {\n  return (context: H, next?: NextFunction) => {\n    const { service, method } = context\n    if (\n      !service.allowsMulti ||\n      !isMulti(context) ||\n      method === 'find' ||\n      service.allowsMulti(method)\n    ) {\n      if (next) return next()\n      return context\n    }\n\n    throw options?.error\n      ? options.error(context)\n      : new MethodNotAllowed(`Can not ${method} multiple entries`)\n  }\n}\n","import _get from 'lodash/get.js'\nimport _has from 'lodash/has.js'\nimport { BadRequest } from '@feathersjs/errors'\n\nimport { checkContext, getDataIsArray } from '../../utils/index.js'\nimport type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport type { MaybeArray } from '../../internal.utils.js'\nimport { toArray } from '../../internal.utils.js'\n\n/**\n * Validates that the specified fields exist on `context.data` and are not falsy.\n * Numeric `0` and boolean `false` are treated as valid values.\n * Throws a `BadRequest` error if any required field is missing or null.\n *\n * @example\n * ```ts\n * import { checkRequired } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   before: { create: [checkRequired(['email', 'password'])] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/check-required.html\n */\nexport function checkRequired<H extends HookContext = HookContext>(\n  fieldNames: MaybeArray<string>,\n) {\n  const fieldNamesArray = toArray(fieldNames)\n  return (context: H, next?: NextFunction) => {\n    checkContext(context, {\n      type: ['before', 'around'],\n      method: ['create', 'update', 'patch'],\n      label: 'checkRequired',\n    })\n\n    const { data } = getDataIsArray(context)\n\n    for (let i = 0; i < data.length; i++) {\n      const item = data[i]\n\n      for (let j = 0; j < fieldNamesArray.length; j++) {\n        const name = fieldNamesArray[j]\n\n        if (!_has(item, name)) {\n          throw new BadRequest(`Field ${name} does not exist. (required)`)\n        }\n\n        const value = _get(item, name)\n\n        if (!value && value !== 0 && value !== false) {\n          throw new BadRequest(`Field ${name} is null. (required)`)\n        }\n      }\n    }\n\n    if (next) return next()\n  }\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { checkContext, getResultIsArray } from '../../utils/index.js'\nimport type { MaybeArray, Promisable } from '../../internal.utils.js'\nimport type { InferCreateDataSingle } from '../../utility-types/infer-service-methods.js'\nimport type { ResultSingleHookContext } from '../../utility-types/hook-context.js'\n\nexport interface CreateRelatedOptions<\n  H extends HookContext = HookContext,\n  Services extends H['app']['services'] = H['app']['services'],\n  S extends keyof Services = keyof Services,\n> {\n  service: S\n  /**\n   * Is relevant when the current context result is an array.\n   *\n   * If true, will create multiple related records in a single call to the related service's create method.\n   * If false or not provided, will create related records one by one.\n   *\n   * @default false\n   */\n  multi?: boolean\n  /**\n   * A function that returns the data to be created in the related service.\n   *\n   * Receives the current item from the context result and the full hook context as arguments.\n   * Can return a single data object, an array of data objects, or a promise that resolves to either.\n   *\n   * If the function returns undefined, no related record will be created for that item.\n   */\n  data: (\n    item: ResultSingleHookContext<H>,\n    context: H,\n  ) => Promisable<MaybeArray<InferCreateDataSingle<Services[S]>> | undefined>\n}\n\n/**\n * Creates related records in other services after a successful `create` call.\n * For each result item, a `data` function produces the record to create in the target service.\n * Supports creating records one-by-one or in a single multi-create when `multi: true`.\n *\n * @example\n * ```ts\n * import { createRelated } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   after: {\n *     create: [createRelated({ service: 'profiles', data: (user) => ({ userId: user.id }) })]\n *   }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/create-related.html\n */\nexport function createRelated<H extends HookContext = HookContext>(\n  options: MaybeArray<CreateRelatedOptions<H>>,\n) {\n  return async (context: H, next?: NextFunction) => {\n    checkContext(context, {\n      type: ['after', 'around'],\n      method: ['create'],\n      label: 'createRelated',\n    })\n\n    if (next) {\n      await next()\n    }\n\n    const { result } = getResultIsArray(context)\n\n    const entries = Array.isArray(options) ? options : [options]\n\n    await Promise.all(\n      entries.map(async (entry) => {\n        const { data, service, multi } = entry\n\n        const dataToCreate = (\n          await Promise.all(result.map(async (item) => data(item, context)))\n        )\n          .flat()\n          .filter((x) => !!x)\n\n        if (!dataToCreate || dataToCreate.length <= 0) {\n          return context\n        }\n\n        if (multi || dataToCreate.length === 1) {\n          await context.app\n            .service(service as string)\n            .create(\n              dataToCreate.length === 1\n                ? (dataToCreate[0] as any)\n                : (dataToCreate as any),\n            )\n        } else {\n          await Promise.all(\n            dataToCreate.map(async (item) =>\n              context.app.service(service as string).create(item as any),\n            ),\n          )\n        }\n      }),\n    )\n  }\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\n\n/**\n * Logs the current hook context to the console for debugging purposes.\n * Displays timestamp, service path, method, type, id, data, query, result, and\n * any additional param fields you specify.\n *\n * @example\n * ```ts\n * import { debug } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   before: { find: [debug('before find', 'user')] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/debug.html\n */\nexport const debug =\n  <H extends HookContext = HookContext>(msg: string, ...fieldNames: string[]) =>\n  async (context: H, next?: NextFunction) => {\n    if (next) {\n      await next()\n    }\n\n    // display timestamp\n    const now = new Date()\n    console.log(\n      `${now.getFullYear()}-${\n        now.getMonth() + 1\n      }-${now.getDate()} ${now.getHours()}:${now.getMinutes()}:${now.getSeconds()}`,\n    )\n\n    if (msg) {\n      console.log(msg)\n    }\n\n    // display service, method & type of hook (before/after/error)\n    console.log(\n      `${context.type} service('${context.path}').${context.method}()`,\n    )\n\n    // display id for get, patch, update & remove\n    if (!['find', 'create'].includes(context.method) && 'id' in context) {\n      console.log('id:', context.id)\n    }\n\n    if (context.data) {\n      console.log('data:', context.data)\n    }\n\n    if (context.params?.query) {\n      console.log('query:', context.params.query)\n    }\n\n    if (context.result) {\n      console.log('result:', context.result)\n    }\n\n    // display additional params\n    const params = context.params || {}\n    console.log('params props:', Object.keys(params).sort())\n\n    fieldNames.forEach((name) => {\n      console.log(`params.${name}:`, params[name])\n    })\n\n    if (context.error) {\n      console.log('error', context.error)\n    }\n  }\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { checkContext } from '../../utils/index.js'\n\n/**\n * Disables pagination when `query.$limit` is `-1` or `'-1'`.\n * Removes the `$limit` from the query and sets `params.paginate = false`.\n * Must be used as a `before` or `around` hook on the `find` method.\n *\n * @example\n * ```ts\n * import { disablePagination } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   before: { find: [disablePagination()] }\n * })\n * // Then call: app.service('users').find({ query: { $limit: -1 } })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/disable-pagination.html\n */\nexport const disablePagination =\n  <H extends HookContext = HookContext>() =>\n  (context: H, next?: NextFunction) => {\n    checkContext(context, {\n      type: ['before', 'around'],\n      method: ['find'],\n      label: 'disablePagination',\n    })\n    const $limit = context.params?.query?.$limit\n\n    if ($limit === '-1' || $limit === -1) {\n      context.params.paginate = false\n      delete context.params.query.$limit\n    }\n\n    if (next) return next()\n\n    return context\n  }\n","import { MethodNotAllowed } from '@feathersjs/errors'\nimport type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport type { TransportName } from '../../types.js'\nimport { isProvider } from '../../predicates/index.js'\nimport type { MaybeArray } from '../../internal.utils.js'\nimport { toArray } from '../../internal.utils.js'\n\n/**\n * Prevents access to a service method completely or for specific transports.\n * When called without arguments, the method is blocked for all callers.\n * When called with transport names, only those transports are blocked.\n *\n * @example\n * ```ts\n * import { disallow } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   before: {\n *     remove: [disallow('external')], // block external access\n *     update: [disallow()],           // block completely\n *   }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/disallow.html\n */\nexport const disallow = <H extends HookContext = HookContext>(\n  transports?: MaybeArray<TransportName>,\n) => {\n  const transportsArr = toArray(transports)\n  return (context: H, next?: NextFunction) => {\n    if (!transports) {\n      throw new MethodNotAllowed('Method not allowed')\n    }\n\n    if (isProvider(...(transportsArr as TransportName[]))(context)) {\n      throw new MethodNotAllowed(\n        `Provider '${context.params.provider}' can not call '${context.method}' on '${context.path}'. (disallow)`,\n      )\n    }\n\n    if (next) return next().then(() => context)\n  }\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { checkContext, getResultIsArray } from '../../utils/index.js'\nimport type { MaybeArray, NeverFallback } from '../../internal.utils.js'\nimport type {\n  InferFindParams,\n  InferGetResult,\n} from '../../utility-types/infer-service-methods.js'\nimport type { ResultSingleHookContext } from '../../utility-types/hook-context.js'\n\nexport type OnDeleteAction = 'cascade' | 'set null'\n\nexport interface OnDeleteOptions<\n  H extends HookContext = HookContext,\n  S extends keyof H['app']['services'] = keyof H['app']['services'],\n> {\n  /**\n   * The related service where related items should be manipulated\n   */\n  service: S\n  /**\n   * The propertyKey in the related service\n   */\n  keyThere: NeverFallback<keyof InferGetResult<H['app']['services'][S]>, string>\n  /**\n   * The propertyKey in the current service.\n   */\n  keyHere: keyof ResultSingleHookContext<H>\n  /**\n   * The action to perform on the related items.\n   *\n   * - `cascade`: remove related items\n   * - `set null`: set the related property to null\n   */\n  onDelete: OnDeleteAction\n  /**\n   * Additional query to merge into the service call.\n   * Typed based on the related service's query type.\n   */\n  query?: InferFindParams<H['app']['services'][S]>['query']\n  /**\n   * If true, the hook will wait for the service to finish before continuing\n   *\n   * @default false\n   */\n  blocking?: boolean\n}\n\n/**\n * Manipulates related items when a record is deleted, similar to SQL foreign key actions.\n * Supports `'cascade'` (remove related records) and `'set null'` (nullify the foreign key).\n * Unlike database-level cascades, this hook triggers service events and hooks for related items.\n *\n * @example\n * ```ts\n * import { onDelete } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   after: {\n *     remove: [onDelete({ service: 'posts', keyHere: 'id', keyThere: 'userId', onDelete: 'cascade' })]\n *   }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/on-delete.html\n */\ntype OnDeleteOptionsDistributed<H extends HookContext> = {\n  [S in keyof H['app']['services'] & string]: OnDeleteOptions<H, S>\n}[keyof H['app']['services'] & string]\n\nexport const onDelete = <H extends HookContext = HookContext>(\n  options: MaybeArray<OnDeleteOptionsDistributed<H>>,\n) => {\n  const optionsMulti = Array.isArray(options) ? options : [options]\n\n  return async (context: H, next?: NextFunction) => {\n    checkContext(context, {\n      type: ['after', 'around'],\n      method: 'remove',\n      label: 'onDelete',\n    })\n\n    if (next) {\n      await next()\n    }\n\n    const { result } = getResultIsArray(context)\n\n    if (!result.length) {\n      return\n    }\n\n    const promises: Promise<any>[] = []\n\n    optionsMulti.forEach(\n      async ({ keyHere, keyThere, onDelete, service, blocking, query }) => {\n        let ids = result.map((x) => x[keyHere]).filter((x) => !!x)\n        ids = [...new Set(ids)]\n\n        if (!ids || ids.length <= 0) {\n          return context\n        }\n\n        const params = {\n          query: {\n            ...query,\n            ...(ids.length === 1\n              ? { [keyThere]: ids[0] }\n              : { [keyThere]: { $in: ids } }),\n          },\n          paginate: false,\n        }\n\n        let promise: Promise<any> | undefined = undefined\n\n        if (onDelete === 'cascade') {\n          promise = context.app.service(service as string).remove(null, params)\n        } else if (onDelete === 'set null') {\n          const data = { [keyThere]: null }\n          promise = context.app\n            .service(service as string)\n            .patch(null, data, params)\n        }\n\n        if (promise && blocking) {\n          promises.push(promise)\n        }\n      },\n    )\n\n    if (promises.length) {\n      await Promise.all(promises)\n    }\n\n    return\n  }\n}\n","export const FROM_CLIENT_FOR_SERVER_DEFAULT_KEY = '_$client' as const\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport type { MaybeArray } from '../../internal.utils.js'\nimport { toArray } from '../../internal.utils.js'\nimport { FROM_CLIENT_FOR_SERVER_DEFAULT_KEY } from './params-for-from-shared.js'\n\nexport type ParamsForServerOptions = {\n  /**\n   * @default '_$client'\n   */\n  keyToHide?: string\n}\n\n/**\n * Client-side hook that moves whitelisted `params` properties into `query._$client`\n * so they survive the client-to-server transport. The server only receives `query`\n * from params — use `paramsFromClient` on the server to restore them.\n *\n * @example\n * ```ts\n * import { paramsForServer } from 'feathers-utils/hooks'\n *\n * // Client-side\n * app.service('users').hooks({\n *   before: { all: [paramsForServer('populateParams')] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/params-for-server.html\n */\nexport const paramsForServer = (\n  whitelist: MaybeArray<string>,\n  options?: ParamsForServerOptions,\n) => {\n  const whitelistArr = toArray(whitelist)\n\n  const { keyToHide = FROM_CLIENT_FOR_SERVER_DEFAULT_KEY } = options || {}\n\n  return <H extends HookContext>(context: H, next?: NextFunction) => {\n    // clone params on demand\n    let clonedParams: any\n\n    Object.keys(context.params).forEach((key) => {\n      if (key === 'query') {\n        return\n      }\n\n      if (whitelistArr.includes(key)) {\n        if (!clonedParams) {\n          clonedParams = {\n            ...context.params,\n            query: {\n              ...context.params.query,\n            },\n          }\n        }\n\n        if (!clonedParams.query[keyToHide]) {\n          clonedParams.query[keyToHide] = {}\n        }\n\n        clonedParams.query[keyToHide][key] = clonedParams[key]\n        delete clonedParams[key]\n      }\n    })\n\n    if (clonedParams) {\n      context.params = clonedParams\n    }\n\n    if (next) {\n      return next()\n    }\n\n    return context\n  }\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport type { MaybeArray } from '../../internal.utils.js'\nimport { toArray } from '../../internal.utils.js'\nimport { FROM_CLIENT_FOR_SERVER_DEFAULT_KEY } from '../params-for-server/params-for-from-shared.js'\n\nexport type paramsFromClientOptions = {\n  /**\n   * @default '_$client'\n   */\n  keyToHide?: string\n}\n\n/**\n * Server-side hook that extracts whitelisted properties from `query._$client` back\n * into `context.params`. This is the counterpart to `paramsForServer`, which encodes\n * params on the client side for transport.\n *\n * @example\n * ```ts\n * import { paramsFromClient } from 'feathers-utils/hooks'\n *\n * // Server-side\n * app.service('users').hooks({\n *   before: { all: [paramsFromClient('populateParams')] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/params-from-client.html\n */\nexport const paramsFromClient = (\n  whitelist: MaybeArray<string>,\n  options?: paramsFromClientOptions,\n) => {\n  const whitelistArr = toArray(whitelist)\n  const { keyToHide = FROM_CLIENT_FOR_SERVER_DEFAULT_KEY } = options || {}\n  return (context: HookContext, next?: NextFunction) => {\n    if (\n      !context.params?.query?.[keyToHide] ||\n      typeof context.params.query[keyToHide] !== 'object'\n    ) {\n      if (next) return next()\n      return context\n    }\n\n    const params = {\n      ...context.params,\n      query: {\n        ...context.params.query,\n        [keyToHide]: {\n          ...context.params.query[keyToHide],\n        },\n      },\n    }\n\n    const client = params.query[keyToHide]\n\n    whitelistArr.forEach((key) => {\n      if (key in client) {\n        params[key] = client[key]\n        delete client[key]\n      }\n    })\n\n    if (Object.keys(client).length === 0) {\n      delete params.query[keyToHide]\n    }\n\n    context.params = params\n\n    if (next) {\n      return next()\n    }\n\n    return context\n  }\n}\n","import _has from 'lodash/has.js'\nimport _omit from 'lodash/omit.js'\nimport type { FeathersError } from '@feathersjs/errors'\nimport { BadRequest } from '@feathersjs/errors'\nimport { transformData } from '../transform-data/transform-data.hook.js'\nimport type { KeyOfOrDotNotation, MaybeArray } from '../../internal.utils.js'\nimport { toArray } from '../../internal.utils.js'\nimport type { HookContext } from '@feathersjs/feathers'\nimport type { DataSingleHookContext } from '../../utility-types/hook-context.js'\n\nexport type PreventChangesOptions<D, Keys extends KeyOfOrDotNotation<D>> = {\n  /**\n   * Customize the error that is thrown if the service tries to patch a field that is not allowed.\n   *\n   * If not provided, throws a `BadRequest` error with a message indicating the field that is not allowed.\n   */\n  error?: boolean | ((item: D, name: Keys) => FeathersError)\n}\n\n/**\n * Prevents `patch` calls from modifying certain fields. By default, the protected\n * fields are silently removed from `context.data`. When `error` is set, a `BadRequest`\n * is thrown if any protected field is present.\n *\n * Supports dot.notation for nested fields.\n *\n * @example\n * ```ts\n * import { preventChanges } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   before: { patch: [preventChanges(['email', 'role'], { error: true })] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/prevent-changes.html\n */\nexport const preventChanges = <\n  H extends HookContext = HookContext,\n  D extends DataSingleHookContext<H> = DataSingleHookContext<H>,\n  Keys extends KeyOfOrDotNotation<D> = KeyOfOrDotNotation<D>,\n>(\n  fieldNames: MaybeArray<Keys>,\n  options?: PreventChangesOptions<D, Keys>,\n) => {\n  const fieldNamesArr = toArray(fieldNames)\n\n  return transformData<H>((item) => {\n    if (options?.error) {\n      for (let i = 0; i < fieldNamesArr.length; i++) {\n        const name = fieldNamesArr[i]\n\n        if (_has(item, name)) {\n          const error =\n            typeof options.error === 'function'\n              ? options.error(item as D, name)\n              : new BadRequest(\n                  `Field ${String(name)} may not be patched. (preventChanges)`,\n                )\n\n          throw error\n        }\n      }\n    } else {\n      return _omit(item, fieldNamesArr)\n    }\n\n    return item\n  })\n}\n","import { TooManyRequests } from '@feathersjs/errors'\nimport type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport type { RateLimiterAbstract, RateLimiterRes } from 'rate-limiter-flexible'\nimport { checkContext } from '../../utils/index.js'\nimport type { Promisable } from '../../internal.utils.js'\n\nexport type RateLimitOptions<H extends HookContext = HookContext> = {\n  /** Generate the rate-limiting key. Defaults to `context.path`. */\n  key?: (context: H) => Promisable<string>\n  /** Number of points to consume per request. Defaults to `1`. */\n  points?: (context: H) => Promisable<number>\n}\n\n/**\n * Rate limits service method calls using `rate-limiter-flexible`.\n * You provide a pre-configured `RateLimiterAbstract` instance\n * (Memory, Redis, Mongo, etc.) and the hook consumes points per request.\n *\n * @example\n * ```ts\n * import { rateLimit } from 'feathers-utils/hooks'\n * import { RateLimiterMemory } from 'rate-limiter-flexible'\n *\n * const rateLimiter = new RateLimiterMemory({ points: 10, duration: 1 })\n *\n * app.service('users').hooks({\n *   before: { find: [rateLimit(rateLimiter)] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/rate-limit.html\n */\nexport const rateLimit = <H extends HookContext = HookContext>(\n  rateLimiter: RateLimiterAbstract,\n  options?: RateLimitOptions<H>,\n) => {\n  const key = options?.key ?? ((context: HookContext) => context.path)\n  const points = options?.points ?? (() => 1)\n\n  return async (context: H, next?: NextFunction) => {\n    checkContext(context, { type: ['before', 'around'], label: 'rateLimit' })\n\n    const resolvedKey = await key(context)\n    const resolvedPoints = await points(context)\n\n    try {\n      const res = await rateLimiter.consume(resolvedKey, resolvedPoints)\n      context.params.rateLimit = res\n    } catch (res) {\n      context.params.rateLimit = res as RateLimiterRes\n      throw new TooManyRequests('Too many requests', {\n        rateLimitRes: res as RateLimiterRes,\n      })\n    }\n\n    if (next) return await next()\n  }\n}\n","import _get from 'lodash/get.js'\nimport _set from 'lodash/set.js'\nimport _has from 'lodash/has.js'\n\nimport type { FeathersError } from '@feathersjs/errors'\nimport { Forbidden } from '@feathersjs/errors'\n\nimport type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport type { PropertyPath } from 'lodash'\nimport { contextToJson } from '../../utils/context-to-json/context-to-json.util.js'\nimport { getDataIsArray } from '../../utils/index.js'\nimport type { PredicateItemWithContext } from '../../types.js'\n\nexport interface HookSetDataOptions {\n  /**\n   * Wether to throw if the context[from] is undefined.\n   *\n   * @default false\n   */\n  allowUndefined?: boolean\n  /**\n   * @default true\n   */\n  overwrite?: boolean | PredicateItemWithContext\n  /**\n   * Customize the error that is thrown if the context[from] is not available.\n   * If not provided, throws a `Forbidden` error with a message indicating the missing field.\n   */\n  error?: (context: HookContext, from: PropertyPath) => FeathersError\n}\n\n/**\n * Sets a property on each item in `context.data` from another property on the hook context.\n * Supports dot-notation paths for both source and target. Throws a `Forbidden` error\n * if the source field is missing (unless `allowUndefined` is `true`).\n *\n * @example\n * ```ts\n * import { setData } from 'feathers-utils/hooks'\n *\n * app.service('posts').hooks({\n *   before: { create: [setData('params.user.id', 'userId')] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/set-data.html\n */\nexport function setData<H extends HookContext = HookContext>(\n  /**\n   * The property path of the context to set the value from. 'dot.notation' is supported.\n   *\n   * If the property does not exist, the hook will throw an error unless `allowUndefined` is set to true.\n   * If the property exists, it will be set to the value of the `to` property path of the data item.\n   *\n   * @example 'params.user.id'\n   */\n  from: PropertyPath,\n  /**\n   * The property path of the data item to set the value to. 'dot.notation' is supported.\n   *\n   * If the property does not exist, it will be created.\n   * If the property exists, it will be overwritten unless `overwrite` is set to false.\n   *\n   * @example 'userId'\n   */\n  to: PropertyPath,\n  options?: HookSetDataOptions,\n) {\n  const { allowUndefined = false, overwrite = true } = options ?? {}\n\n  return (context: H, next?: NextFunction) => {\n    const { data } = getDataIsArray(context)\n\n    const contextJson = contextToJson(context)\n\n    if (!_has(contextJson, from)) {\n      if (!context.params?.provider || allowUndefined === true) {\n        if (next) return next()\n        return context\n      }\n\n      if (\n        !overwrite &&\n        data.every((item: Record<string, unknown>) => _has(item, to))\n      ) {\n        if (next) return next()\n        return context\n      }\n\n      throw options?.error\n        ? options.error(context, from)\n        : new Forbidden(`Expected field ${from.toString()} not available`)\n    }\n\n    const val = _get(contextJson, from)\n\n    for (let i = 0, len = data.length; i < len; i++) {\n      const item: Record<string, unknown> = data[i]\n\n      const currentOverwrite =\n        typeof overwrite === 'function' ? overwrite(item, context) : overwrite\n\n      if (!currentOverwrite && _has(item, to)) {\n        continue\n      }\n\n      _set(item, to, val)\n    }\n\n    if (next) {\n      return next()\n    }\n\n    return context\n  }\n}\n","import _get from 'lodash/get.js'\nimport _setWith from 'lodash/setWith.js'\nimport _clone from 'lodash/clone.js'\nimport { checkContext } from '../../utils/index.js'\nimport type { FeathersError } from '@feathersjs/errors'\nimport { Forbidden } from '@feathersjs/errors'\nimport type { HookContext, NextFunction } from '@feathersjs/feathers'\n\nexport interface SetFieldOptions {\n  as: string\n  from: string\n  /**\n   * If set to `true`, allows the field to be undefined.\n   * If the field is not available and this is `true`, the hook will not throw an error.\n   *\n   * If set to `false`, the hook will throw an error if the field is not available.\n   *\n   * @default false\n   */\n  allowUndefined?: boolean\n  /**\n   * Customize the error that is thrown if the field is not available.\n   *\n   * If not provided, throws a `Forbidden` error with a message indicating the missing field.\n   */\n  error?: (context: HookContext, from: string) => FeathersError\n}\n\n/**\n * Sets a field on the hook context (e.g. `params.query`) based on the value of another\n * context field (e.g. `params.user.id`). Useful for scoping queries to the authenticated user.\n * Throws a `Forbidden` error if the source field is missing (unless `allowUndefined` is `true`).\n *\n * @example\n * ```ts\n * import { setField } from 'feathers-utils/hooks'\n *\n * app.service('posts').hooks({\n *   before: { all: [setField({ from: 'params.user.id', as: 'params.query.userId' })] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/set-field.html\n */\nexport const setField =\n  <H extends HookContext = HookContext>({\n    as,\n    from,\n    allowUndefined = false,\n    error,\n  }: SetFieldOptions) =>\n  (context: H, next?: NextFunction) => {\n    const { params } = context\n\n    checkContext(context, { type: ['before', 'around'], label: 'setField' })\n\n    const value = _get(context, from)\n\n    if (value === undefined) {\n      if (!params.provider || allowUndefined) {\n        if (next) return next()\n        return context\n      }\n\n      throw error\n        ? error(context, from)\n        : new Forbidden(`Expected field ${as} not available`)\n    }\n\n    context = _setWith(context, as, value, _clone)\n\n    if (next) return next()\n\n    return context\n  }\n","import _get from 'lodash/get.js'\nimport _set from 'lodash/set.js'\nimport _has from 'lodash/has.js'\n\nimport type { FeathersError } from '@feathersjs/errors'\nimport { Forbidden } from '@feathersjs/errors'\n\nimport type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport type { PropertyPath } from 'lodash'\nimport { contextToJson } from '../../utils/context-to-json/context-to-json.util.js'\nimport { getResultIsArray } from '../../utils/index.js'\nimport type { DispatchOption, PredicateItemWithContext } from '../../types.js'\n\nexport interface SetResultOptions {\n  /**\n   * Wether to throw if the context[from] is undefined.\n   *\n   * @default false\n   */\n  allowUndefined?: boolean\n  /**\n   * @default true\n   */\n  overwrite?: boolean | PredicateItemWithContext\n  /**\n   * Customize the error that is thrown if the context[from] is not available.\n   * If not provided, throws a `Forbidden` error with a message indicating the missing field.\n   */\n  error?: (context: HookContext, from: PropertyPath) => FeathersError\n  dispatch?: DispatchOption\n}\n\n/**\n * Sets a property on each item in `context.result` from another property on the hook context.\n * Supports dot-notation paths for both source and target, and can optionally\n * operate on `context.dispatch` as well.\n *\n * @example\n * ```ts\n * import { setResult } from 'feathers-utils/hooks'\n *\n * app.service('posts').hooks({\n *   after: { all: [setResult('params.user.id', 'currentUserId')] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/set-result.html\n */\nexport function setResult<H extends HookContext = HookContext>(\n  /**\n   * The property path of the context to set the value from. 'dot.notation' is supported.\n   *\n   * If the property does not exist, the hook will throw an error unless `allowUndefined` is set to true.\n   * If the property exists, it will be set to the value of the `to` property path of the data item.\n   *\n   * @example 'params.user.id'\n   */\n  from: PropertyPath,\n  /**\n   * The property path of the data item to set the value to. 'dot.notation' is supported.\n   *\n   * If the property does not exist, it will be created.\n   * If the property exists, it will be overwritten unless `overwrite` is set to false.\n   *\n   * @example 'userId'\n   */\n  to: PropertyPath,\n  options?: SetResultOptions,\n) {\n  const { allowUndefined = false, overwrite = true } = options ?? {}\n\n  const forResultOrDispatch = (context: H, dispatch: boolean) => {\n    const { result } = getResultIsArray(context, { dispatch })\n\n    const contextJson = contextToJson(context)\n\n    if (!_has(contextJson, from)) {\n      if (!context.params?.provider || allowUndefined === true) {\n        return context\n      }\n\n      if (\n        !overwrite &&\n        result.every((item: Record<string, unknown>) => _has(item, to))\n      ) {\n        return context\n      }\n\n      throw options?.error\n        ? options.error(context, from)\n        : new Forbidden(`Expected field ${from.toString()} not available`)\n    }\n\n    const val = _get(contextJson, from)\n\n    for (let i = 0; i < result.length; i++) {\n      const item: Record<string, unknown> = result[i]\n\n      const currentOverwrite =\n        typeof overwrite === 'function' ? overwrite(item, context) : overwrite\n\n      if (!currentOverwrite && _has(item, to)) {\n        continue\n      }\n\n      _set(item, to, val)\n    }\n\n    return context\n  }\n\n  const fn = (context: H) => {\n    if (options?.dispatch === 'both') {\n      forResultOrDispatch(context, true)\n      return forResultOrDispatch(context, false)\n    }\n\n    return forResultOrDispatch(context, !!options?.dispatch)\n  }\n\n  return (context: H, next?: NextFunction) => {\n    if (next) {\n      return next().then(() => fn(context))\n    }\n\n    return fn(context)\n  }\n}\n","import _set from 'lodash/set.js'\nimport type { HookContext, NextFunction } from '@feathersjs/feathers'\n\n/**\n * Extracts URL route parameters (slugs) and sets them on `params.query`.\n * For example, given a route `/stores/:storeId`, this hook copies the resolved\n * `storeId` value from `params.route` into the query. Only applies to the `rest` provider.\n *\n * @example\n * ```ts\n * import { setSlug } from 'feathers-utils/hooks'\n *\n * app.service('stores/:storeId/products').hooks({\n *   before: { all: [setSlug('storeId')] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/set-slug.html\n */\nexport const setSlug = <H extends HookContext = HookContext>(\n  slug: string,\n  fieldName?: string,\n) => {\n  if (typeof fieldName !== 'string') {\n    fieldName = `query.${slug}`\n  }\n\n  return (context: H, next?: NextFunction) => {\n    if (context.params && context.params.provider === 'rest') {\n      const value = context.params.route[slug]\n      if (typeof value === 'string' && value[0] !== ':') {\n        _set(context.params, fieldName, value)\n      }\n    }\n\n    if (next) return next()\n\n    return context\n  }\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { addToQuery, checkContext } from '../../utils/index.js'\nimport type { TransformParamsFn } from '../../types.js'\nimport { transformParams } from '../../utils/transform-params/transform-params.util.js'\nimport { early, type Promisable } from '../../internal.utils.js'\nimport { isPromise } from '../../common/index.js'\n\nexport type SoftDeleteOptionFunction<H extends HookContext = HookContext> = (\n  context?: H,\n) => Promisable<{ [key: string]: any }>\n\nexport interface SoftDeleteOptions<H extends HookContext = HookContext> {\n  /**\n   * @example { deletedAt: null }\n   */\n  deletedQuery: { [key: string]: any } | SoftDeleteOptionFunction<H>\n  /**\n   * @example { deletedAt: new Date() }\n   */\n  removeData: { [key: string]: any } | SoftDeleteOptionFunction<H>\n  /**\n   * Transform the params before calling the service method. E.g. remove 'params.provider' or add custom params.\n   */\n  transformParams?: TransformParamsFn\n\n  /**\n   * Key in `params` to disable the soft delete functionality.\n   *\n   * @default 'disableSoftDelete'\n   */\n  disableSoftDeleteKey?: string\n\n  /**\n   * `softDelete` uses `._patch()` internally to mark items as deleted.\n   *\n   * If you set this option to `true`, it will use the `.patch()` method with hooks instead.\n   */\n  usePatchWithHooks?: boolean\n}\n\n/**\n * Marks items as deleted instead of physically removing them. On `remove`, the hook\n * patches the record with `removeData` (e.g. `{ deletedAt: new Date() }`). On all other\n * methods, it appends `deletedQuery` (e.g. `{ deletedAt: null }`) to filter out soft-deleted items.\n *\n * @example\n * ```ts\n * import { softDelete } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   around: {\n *     all: [softDelete({ deletedQuery: { deletedAt: null }, removeData: { deletedAt: new Date() } })]\n *   }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/soft-delete.html\n */\nexport const softDelete = <H extends HookContext = HookContext>(\n  options: SoftDeleteOptions<H>,\n) => {\n  if (!options?.deletedQuery || !options?.removeData) {\n    throw new Error(\n      'You must provide `deletedQuery` and `removeData` options to the softDelete hook.',\n    )\n  }\n\n  return async (context: H, next?: NextFunction) => {\n    checkContext(context, { type: ['before', 'around'], label: 'softDelete' })\n\n    const { disableSoftDeleteKey = 'disableSoftDelete' } = options\n\n    if (context.params[disableSoftDeleteKey]) {\n      return early(context, next)\n    }\n\n    const { deletedQuery, removeData } = options\n\n    let deleteQuery = getValue(deletedQuery, context)\n    if (isPromise(deleteQuery)) {\n      deleteQuery = await deleteQuery\n    }\n\n    const query = addToQuery(context.params.query, deleteQuery)\n\n    const params = transformParams(\n      {\n        ...context.params,\n        query,\n      },\n      options.transformParams,\n    )\n\n    context.params = params\n\n    if (context.method === 'remove') {\n      let data = getValue(removeData, context)\n      if (isPromise(data)) {\n        data = await data\n      }\n      const method = options.usePatchWithHooks ? 'patch' : '_patch'\n      const result = await context.service[method](context.id, data, params)\n\n      context.result = result\n    }\n\n    if (next) {\n      return await next()\n    }\n\n    return context\n  }\n}\n\nconst getValue = (value: any, ...args: any[]) => {\n  if (typeof value === 'function') {\n    return value(...args)\n  }\n  return value\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { checkContext } from '../../utils/index.js'\n\nexport type StashableOptions = {\n  /** The property name on `context.params` to store the stash function. @default 'stashed' */\n  propName?: string\n  /** Custom function to fetch the pre-mutation state. Defaults to `service.get` or `service.find`. */\n  stashFunc?: (context: HookContext) => Promise<any>\n}\n\nconst defaultStashFunc = (context: HookContext) => {\n  const isMulti = context.id == null\n\n  const params = {\n    ...context.params,\n    _stashable: true,\n    ...(isMulti ? { paginate: false } : {}),\n  }\n\n  return isMulti\n    ? context.service.find(params)\n    : context.service.get(context.id, params)\n}\n\n/**\n * Stashes the pre-mutation state of a record into `context.params`.\n * Eagerly starts the fetch but exposes a memoized function — calling it\n * multiple times only hits the database once.\n * Use in `before` hooks on `update`, `patch`, or `remove` methods.\n *\n * @example\n * ```ts\n * import { stashable } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   before: { patch: [stashable()] }\n * })\n *\n * // In a later hook (before or after):\n * const before = await context.params.stashed()\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/stashable.html\n */\nexport function stashable<H extends HookContext = HookContext>(\n  options?: StashableOptions,\n): {\n  (context: H, next: NextFunction): Promise<void>\n  (context: H): H\n} {\n  const propName = options?.propName ?? 'stashed'\n  const stashFunc = options?.stashFunc ?? defaultStashFunc\n\n  return ((context: H, next?: NextFunction) => {\n    if (context.params._stashable) {\n      if (next) return next()\n      return context\n    }\n\n    checkContext(context, {\n      type: ['before', 'around'],\n      method: ['update', 'patch', 'remove'],\n      label: 'stashable',\n    })\n\n    const promise = stashFunc(context).catch(() => undefined)\n\n    context.params[propName] = () => promise\n\n    if (next) return next()\n    return context\n  }) as any\n}\n","import type { HookContext } from '@feathersjs/feathers'\nimport type { PredicateFn } from '../../types.js'\nimport { BadRequest, type FeathersError } from '@feathersjs/errors'\nimport { every, isMulti } from '../../predicates/index.js'\nimport { throwIf } from '../throw-if/throw-if.hook.js'\n\nexport type ThrowIfIsMultiOptions = {\n  /**\n   * A predicate function to filter the contexts that should be checked for multi operations.\n   * If provided, only contexts that pass this predicate will be checked for multi operations.\n   */\n  filter?: PredicateFn\n  /**\n   * Customize the error that is thrown if the context is multi and the service does not allow it.\n   * If not provided, throws a `BadRequest` error.\n   */\n  error?: (context: HookContext) => FeathersError\n}\n\nconst defaultError = (context: HookContext) =>\n  new BadRequest(`Cannot perform multi operation on method '${context.method}'`)\n\n/**\n * Throws a `BadRequest` error when the current operation is a multi operation\n * (array data on `create`, or `id === null` on `patch`/`remove`).\n * Useful to prevent bulk operations on services that should only handle single items.\n *\n * @example\n * ```ts\n * import { throwIfIsMulti } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   before: { all: [throwIfIsMulti()] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/throw-if-is-multi.html\n */\nexport const throwIfIsMulti = <H extends HookContext = HookContext>(\n  options?: ThrowIfIsMultiOptions,\n) =>\n  throwIf<H>(\n    every(\n      every(isMulti, (context) => context.method !== 'find'),\n      options?.filter,\n    ),\n    {\n      error: options?.error ?? defaultError,\n    },\n  )\n","import type { HookContext } from '@feathersjs/feathers'\nimport type { PredicateFn, TransportName } from '../../types.js'\nimport { throwIf } from '../throw-if/throw-if.hook.js'\nimport { every, isProvider } from '../../predicates/index.js'\nimport type { FeathersError } from '@feathersjs/errors'\nimport { MethodNotAllowed } from '@feathersjs/errors'\nimport { toArray } from '../../internal.utils.js'\n\nconst defaultError = (context: HookContext) =>\n  new MethodNotAllowed(\n    `Provider '${context.params.provider}' can not call '${context.method}'.`,\n  )\n\nexport type ThrowIfIsIsProviderOptions = {\n  filter?: PredicateFn\n  /**\n   * Customize the error that is thrown if the context is a provider and the service does not allow it.\n   * If not provided, throws a `MethodNotAllowed` error.\n   */\n  error?: (context: HookContext) => FeathersError\n}\n\n/**\n * Throws a `MethodNotAllowed` error when the request comes from one of the specified transports.\n * Combines `throwIf` with the `isProvider` predicate for a convenient one-liner.\n * Use this to restrict methods to server-only or specific transport types.\n *\n * @example\n * ```ts\n * import { throwIfIsProvider } from 'feathers-utils/hooks'\n *\n * app.service('internal').hooks({\n *   before: { all: [throwIfIsProvider('external')] }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/throw-if-is-provider.html\n */\nexport const throwIfIsProvider = <H extends HookContext = HookContext>(\n  transports: TransportName | TransportName[],\n  options?: ThrowIfIsIsProviderOptions,\n) => {\n  const disallowTransports = toArray(transports)\n\n  return throwIf<H>(\n    every(isProvider(...(disallowTransports as any)), options?.filter),\n    {\n      error: options?.error ?? defaultError,\n    },\n  )\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { traverse as _traverse } from '../../common/index.js'\n\nexport type TraverseOptions = {\n  transformer: (transformContext: any) => any\n  getObject: (\n    context: HookContext,\n  ) => Record<string, any> | Record<string, any>[]\n}\n\n/**\n * Recursively walks and transforms fields in record(s) using `neotraverse`.\n * The `getObject` function extracts the target from the context, and `transformer`\n * is called for every node during traversal --- ideal for deep, structural transformations.\n *\n * @example\n * ```ts\n * import { traverse } from 'feathers-utils/hooks'\n *\n * app.service('users').hooks({\n *   after: {\n *     all: [traverse({ getObject: (ctx) => ctx.result, transformer: function () { if (this.key === 'password') this.remove() } })]\n *   }\n * })\n * ```\n *\n * @see https://utils.feathersjs.com/hooks/traverse.html\n */\nexport const traverse =\n  <H extends HookContext = HookContext>({\n    transformer,\n    getObject,\n  }: TraverseOptions) =>\n  (context: H, next?: NextFunction) => {\n    _traverse(getObject(context), transformer)\n\n    if (next) {\n      return next()\n    }\n\n    return context\n  }\n"],"mappings":"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"}