feathers-utils 7.0.0 → 10.0.0-0

package/CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

package/LICENSE

@@ -1,6 +1,6 @@
-MIT License
+The MIT License (MIT)
 
-Copyright (c) 2023 Frederik Schmatz
+Copyright (c) 2025 Feathers
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,54 +1,114 @@
-# feathers-utils
+## feathers-utils
+
+#### hooks
+
+- added transformData, transformResult, rm alterItems
+- added discardData, discardResult, rm discard
+  - moved to omitData, omitResult, rm omit
+  - MaybeArray
+- added keepData, keepResult, rm keep
+  - moved to pickData, pickResult, rm pick
+  - MaybeArray
+- added lowercaseData, lowercaseResult, rm lowercase
+  - MaybeArray
+- added setNowData, setNowResult, rm setNow
+
+- removed several checks that are handled by typescript
+- removed check for `preventChanges(true, ...fieldNames)`
+  - switch `true` to second argument options
+  - async
+
+- renamed 'keepQuery' to 'pickQuery', added alias
+- renamed 'required' to 'checkRequired', added alias
+
+- removed 'runParallel'
+
+- removed 'actOn', 'actOnDefault', 'actOnDispatch'
+
+- added throwIf
+- added throwIfIsProvider
+- added throwIfIsMulti
+
+- removed old paramsForServer & changed to hook
+
+- removed 'callingParams'
+
+- removed 'checkContextIf'
+
+- added 'onDelete' & 'createRelated'
+- added 'checkMulti'
+- added 'shouldSkip' & 'skippable'
+
+- stashBefore multi
+
+- softDelete: added 'transformParams' & added 'key' option
+
+- disallow: MaybeArray
+
+- rm support for spread argument
+
+- rm 'actOnDispatch' & 'actOnDefault'
+
+- rm 'validate', 'validateSchema', 'setNow', 'sequelizeConvert', 'serialize', 'required', 'runHook', 'populate', 'pick', 'omit', 'mongoKeys', 'lowercase', 'lowerCase', 'keepQuery', 'keepQueryInArray', 'isNot', fgraphql', 'fastJoin', 'discard...', 'dePopulate', 'actOnDefault', 'actOnDispatch', 'sifter'
+
+- softDelete: need to pass 'deletedQuery' and 'removeData'
+
+- traverse options object & getObject explicitly required
+
+- cache changed
+
+#### predicates
+
+- renamed 'isNot' to 'not' (added alias for 'isNot')
+- added predicate isMulti
+- added predicate isPaginated
+- added predicate isContext
+
+#### utils
+
+- added getDataIsArray, getResultIsArray, rm getItems
+- added mutateData, mutateResult, rm replaceItems
+- added util getPaginate
+- added util skipResult
+- rm 'runHook'
+
+### Hooks to discuss
+
+- cache
+- populate
+- dePopulate
+- fgraphql
+- fastJoin
+- sequelizeConvert
+- serialize
+
+<p align="center">
+  <img src="https://utils.feathersjs.com/feathers-utils-logo.png" width="200">
+</p>
 
 [![npm](https://img.shields.io/npm/v/feathers-utils)](https://www.npmjs.com/package/feathers-utils)
-[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/fratzinger/feathers-utils/node.js.yml?branch=main)](https://github.com/fratzinger/feathers-utils/actions/workflows/node.js.yml?query=branch%3Amain)
-[![Code Climate maintainability](https://img.shields.io/codeclimate/maintainability/fratzinger/feathers-utils)](https://codeclimate.com/github/fratzinger/feathers-utils)
-[![Code Climate coverage](https://img.shields.io/codeclimate/coverage/fratzinger/feathers-utils)](https://codeclimate.com/github/fratzinger/feathers-utils)
+[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/feathersjs/feathers-utils/CI/master)](https://github.com/feathersjs/feathers-utils/actions/workflows/nodejs.yml?query=branch%3Amaster)
+[![libraries.io](https://img.shields.io/librariesio/release/npm/feathers-utils)](https://libraries.io/npm/feathers-utils)
 [![npm](https://img.shields.io/npm/dm/feathers-utils)](https://www.npmjs.com/package/feathers-utils)
-[![GitHub license](https://img.shields.io/github/license/fratzinger/feathers-utils)](https://github.com/fratzinger/feathers-utils/blob/main/LICENSE.md)
-
-> NOTE: This is the version for Feathers v5. For Feathers v4 use [feathers-utils v1](https://github.com/fratzinger/feathers-utils/tree/crow)
+[![GitHub license](https://img.shields.io/github/license/feathersjs/feathers-utils)](https://github.com/feathersjs/feathers-utils/blob/master/LICENSE)
+[![Discord](https://badgen.net/badge/icon/discord?icon=discord&label)](https://discord.gg/qa8kez8QBx)
 
+A collection of useful hooks and utils to use with Feathers services.
 
-## Installation
+> NOTE: This is the version for Feathers v5. For Feathers v4 use [feathers-utils v6](https://github.com/feathersjs/feathers-utils/tree/crow)
 
-```shell
-npm i feathers-utils
 ```
+npm install feathers-utils --save
+```
+
+## Documentation
+
+For the full list and API of available hooks and utilities, refer to the [feathers-utils documentation](https://utils.feathersjs.com/).
+
+## Tests
+
+`npm test` to run tests.
+
+## License
 
-## Usage
-
-### Hooks
-
-- `checkMulti`: throws if the request is **multi** data, but the services `allowsMulti(method)` returns `false`
-- `createRelated`: simply create related items from a hook.
-- `forEach`
-- `onDelete`: simply remove/set null related items from a hook.
-- `paramsForServer`
-- `paramsFromClient`
-- `parseFields`
-- `removeRelated`: simple remove related items from a hook. Basically `cascade` at feathers level.
-- `runPerItem`: run a function for every item. Meant for `multi:true`.
-- `setData`: map properties from `context` to `data`. Something like `userId: context.params.user.id`
-
-### Mixins
-
-- `mixins/debounceMixin` & `mixins/DebouncedStore`
-
-### Utils
-
-- `defineHooks`
-- `filterQuery`
-- `flattenQuery`
-- `deflattenQuery`
-- `getItemsIsArray(context)`: returns `{ items: any[], isArray: boolean }`
-- `getPaginate`
-- `isMulti(context) => Boolean`: returns true, if `find`, `create/patch/remove`: multi
-- `isPaginated`
-- `markHookForSkip`: add hookName to `context.params.skipHooks` - also see `shouldSkip`
-- `mergeQuery`: deeply merges queries
-- `mergeArrays`: merges arrays with intersection options
-- `pushSet`: if existing array: *push*, else *set*
-- `setQueryKeySafely`
-- `setResultEmpty`
-- `shouldSkip`: checks `context.params.skipHooks` for `'all' | '${hookName}' | '${type}:${hookName}'` - also see `markHookForSkip`
+See [LICENSE](LICENSE).

package/dist/add-skip.util-BoYO28ie.d.ts

@@ -0,0 +1,10 @@
+import { HookType, HookContext } from '@feathersjs/feathers';
+import { M as MaybeArray } from './internal.utils-CskQ4psU.js';
+
+type SkipHookName = 'all' | HookType | `${HookType}:${string}` | (string & {});
+/**
+ * Add names to `context.params.skipHooks` for `skippable` hooks.
+ */
+declare const addSkip: <H extends HookContext>(context: H, hooks: MaybeArray<SkipHookName>) => void;
+
+export { type SkipHookName as S, addSkip as a };

package/dist/chunk-DKP457HT.js

@@ -0,0 +1,9 @@
+// src/internal.utils.ts
+var hasOwnProperty = (obj, ...keys) => {
+  return keys.some((x) => Object.prototype.hasOwnProperty.call(obj, x));
+};
+var toArray = (value) => Array.isArray(value) ? value : [value];
+
+export { hasOwnProperty, toArray };
+//# sourceMappingURL=chunk-DKP457HT.js.map
+//# sourceMappingURL=chunk-DKP457HT.js.map

package/dist/chunk-DKP457HT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal.utils.ts"],"names":[],"mappings":";AAAO,IAAM,cAAA,GAAiB,CAC5B,GAAA,EAAA,GACG,IAAA,KACS;AACZ,EAAA,OAAO,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,KAAM,MAAA,CAAO,UAAU,cAAA,CAAe,IAAA,CAAK,GAAA,EAAK,CAAC,CAAC,CAAA;AACtE;AAGO,IAAM,OAAA,GAAU,CAAI,KAAA,KACzB,KAAA,CAAM,QAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,CAAC,KAAK","file":"chunk-DKP457HT.js","sourcesContent":["export const hasOwnProperty = (\n  obj: Record<string, unknown>,\n  ...keys: string[]\n): boolean => {\n  return keys.some((x) => Object.prototype.hasOwnProperty.call(obj, x))\n}\n\nexport type MaybeArray<T> = T | T[]\nexport const toArray = <T>(value: T | T[]): T[] =>\n  Array.isArray(value) ? value : [value]\n\nexport type Promisable<T> = T | Promise<T>\nexport type KeyOf<T> = Extract<keyof T, string>\n"]}

package/dist/chunk-DYLA6A4I.js

@@ -0,0 +1,250 @@
+import { isContext, isPromise, isMulti, isPaginated } from './chunk-KSCPQLU3.js';
+import { SERVICE } from '@feathersjs/feathers';
+import copy from 'fast-copy';
+import { deepEqual } from 'fast-equals';
+
+// src/utils/add-skip/add-skip.util.ts
+var addSkip = (context, hooks) => {
+  const names = Array.isArray(hooks) ? hooks : [hooks];
+  if (context.params.skipHooks === void 0) {
+    context.params = {
+      ...context.params,
+      skipHooks: [...names]
+    };
+  } else {
+    if (!Array.isArray(context.params.skipHooks)) {
+      throw new Error("Invalid skipHooks parameter");
+    }
+    context.params = {
+      ...context.params,
+      skipHooks: [.../* @__PURE__ */ new Set([...context.params.skipHooks, ...names])]
+    };
+  }
+};
+
+// src/utils/check-context/check-context.util.ts
+function checkContext(context, type, methods, label = "anonymous") {
+  if (!isContext({
+    method: methods ?? void 0,
+    type: type ?? void 0
+  })(context)) {
+    throw new Error(`The '${label}' hook has invalid context.`);
+  }
+}
+
+// src/utils/context-to-json/context-to-json.util.ts
+var contextToJson = (context) => {
+  if (context.toJSON) {
+    return context.toJSON();
+  }
+  return context;
+};
+
+// src/utils/define-hooks/define-hooks.util.ts
+function defineHooks(hooks) {
+  return hooks;
+}
+
+// src/utils/get-data-is-array/get-data-is-array.util.ts
+function getDataIsArray(context) {
+  if (!context.data) {
+    return {
+      isArray: false,
+      data: []
+    };
+  }
+  const isArray = Array.isArray(context.data);
+  return {
+    isArray,
+    data: isArray ? context.data : [context.data]
+  };
+}
+function getExposedMethods(service) {
+  const result = service[SERVICE].methods;
+  if (!result || !Array.isArray(result)) {
+    throw new Error(`Service does not have exposed methods`);
+  }
+  return result;
+}
+function getResultIsArray(context, options) {
+  const { dispatch = false } = options || {};
+  const isDispatch = dispatch && context.dispatch !== void 0;
+  const result = dispatch ? isDispatch ? context.dispatch : copy(context.result) : context.result;
+  if (!result) {
+    return {
+      isArray: false,
+      result: [],
+      key: isDispatch ? "dispatch" : "result"
+    };
+  }
+  const items = context.method === "find" ? result.data || result : result;
+  const isArray = Array.isArray(items);
+  return {
+    isArray,
+    result: isArray ? items : items ? [items] : [],
+    key: isDispatch ? "dispatch" : "result"
+  };
+}
+
+// src/utils/iterate-find/iterate-find.util.ts
+async function* iterateFind(app, servicePath, options) {
+  const service = app.service(servicePath);
+  if (!service || !("find" in service)) {
+    throw new Error(`Service '${servicePath}' does not have a 'find' method.`);
+  }
+  const params = {
+    ...options?.params,
+    query: {
+      ...options?.params?.query ?? {},
+      $limit: options?.params?.query?.$limit ?? 10,
+      $skip: options?.params?.query?.$skip ?? 0
+    }
+  };
+  let result;
+  do {
+    result = await service.find(params);
+    for (const item of result.data) {
+      yield item;
+    }
+    params.query.$skip = (params.query.$skip ?? 0) + result.data.length;
+  } while (result.total > params.query.$skip);
+}
+
+// src/utils/mutate-data/mutate-data.util.ts
+function mutateData(context, transformer) {
+  if (!context.data) {
+    return context;
+  }
+  const { data, isArray } = getDataIsArray(context);
+  if (!data.length) {
+    return context;
+  }
+  let hasPromises = false;
+  const results = data.map((item, i) => {
+    const result = transformer(item, { context, i });
+    if (isPromise(result)) {
+      hasPromises = true;
+      return result.then((res) => res ?? item);
+    }
+    return result ?? item;
+  });
+  function mutate(data2) {
+    context.data = isArray ? data2 : data2[0];
+    return context;
+  }
+  if (hasPromises) {
+    return Promise.all(results).then(mutate);
+  } else {
+    return mutate(results);
+  }
+}
+async function mutateResult(context, transformer, options) {
+  if (options?.next) {
+    await options.next();
+  }
+  if (!!options?.dispatch && !context.dispatch) {
+    context.dispatch = copy(context.result);
+  }
+  async function forResult(dispatch) {
+    const { result, isArray, key } = getResultIsArray(context, { dispatch });
+    if (!result.length) {
+      return context;
+    }
+    let hasPromises = false;
+    const results = result.map((item, i) => {
+      const result2 = transformer(item, { context, i });
+      if (isPromise(result2)) {
+        hasPromises = true;
+        return result2.then((res) => res ?? item);
+      }
+      return result2 ?? item;
+    });
+    function mutate(r) {
+      if (options?.transform) {
+        r = options.transform(r);
+      }
+      if (!isArray) {
+        context[key] = r[0];
+      } else if (isArray && !Array.isArray(context[key]) && context[key].data) {
+        context[key].data = r;
+      } else {
+        context[key] = r;
+      }
+      return context;
+    }
+    if (hasPromises) {
+      return await Promise.all(results).then(mutate);
+    } else {
+      return mutate(results);
+    }
+  }
+  if (options?.dispatch === "both") {
+    await Promise.all([forResult(true), forResult(false)]);
+    return context;
+  }
+  return await forResult(options?.dispatch ?? false);
+}
+
+// src/utils/skip-result/skip-result.util.ts
+var skipResult = (context) => {
+  if (context.result) {
+    return context;
+  }
+  const multi = isMulti(context);
+  if (multi) {
+    if (context.method === "find" && isPaginated(context)) {
+      context.result = {
+        total: 0,
+        skip: 0,
+        limit: 0,
+        data: []
+      };
+    } else {
+      context.result = [];
+    }
+  } else {
+    context.result = null;
+  }
+  return context;
+};
+
+// src/utils/transform-params/transform-params.util.ts
+var transformParams = (params, fn) => {
+  if (!fn) {
+    return params;
+  }
+  const result = fn({ ...params });
+  return result ?? params;
+};
+function patchBatch(items, options) {
+  const map = [];
+  const idKey = options?.id ?? "id";
+  for (const _data of items) {
+    const data = _data;
+    const id = _data[idKey];
+    delete data[idKey];
+    const index = map.findIndex((item) => {
+      return deepEqual(item.data, data);
+    });
+    if (index === -1) {
+      map.push({ ids: [id], data });
+    } else {
+      map[index].ids.push(id);
+    }
+  }
+  return map.map(({ ids, data }) => {
+    return ids.length === 1 ? [ids[0], data, void 0] : [
+      null,
+      data,
+      {
+        query: {
+          [idKey]: { $in: ids }
+        }
+      }
+    ];
+  });
+}
+
+export { addSkip, checkContext, contextToJson, defineHooks, getDataIsArray, getExposedMethods, getResultIsArray, iterateFind, mutateData, mutateResult, patchBatch, skipResult, transformParams };
+//# sourceMappingURL=chunk-DYLA6A4I.js.map
+//# sourceMappingURL=chunk-DYLA6A4I.js.map

package/dist/chunk-DYLA6A4I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/add-skip/add-skip.util.ts","../src/utils/check-context/check-context.util.ts","../src/utils/context-to-json/context-to-json.util.ts","../src/utils/define-hooks/define-hooks.util.ts","../src/utils/get-data-is-array/get-data-is-array.util.ts","../src/utils/get-exposed-methods/get-exposed-methods.util.ts","../src/utils/get-result-is-array/get-result-is-array.util.ts","../src/utils/iterate-find/iterate-find.util.ts","../src/utils/mutate-data/mutate-data.util.ts","../src/utils/mutate-result/mutate-result.util.ts","../src/utils/skip-result/skip-result.util.ts","../src/utils/transform-params/transform-params.util.ts","../src/utils/patch-batch/patch-batch.util.ts"],"names":["data","copy","result"],"mappings":"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","file":"chunk-DYLA6A4I.js","sourcesContent":["import type { HookContext, HookType } from '@feathersjs/feathers'\nimport type { MaybeArray } from '../../internal.utils.js'\n\nexport type SkipHookName =\n  | 'all'\n  | HookType\n  | `${HookType}:${string}`\n  | (string & {})\n\n/**\n * Add names to `context.params.skipHooks` for `skippable` hooks.\n */\nexport const addSkip = <H extends HookContext>(\n  context: H,\n  hooks: MaybeArray<SkipHookName>,\n) => {\n  const names = Array.isArray(hooks) ? hooks : [hooks]\n\n  if (context.params.skipHooks === undefined) {\n    context.params = {\n      ...context.params,\n      skipHooks: [...names],\n    }\n  } else {\n    if (!Array.isArray(context.params.skipHooks)) {\n      throw new Error('Invalid skipHooks parameter')\n    }\n\n    context.params = {\n      ...context.params,\n      skipHooks: [...new Set([...context.params.skipHooks, ...names])],\n    }\n  }\n}\n","import type { HookContext } from '@feathersjs/feathers'\nimport type { HookType, MethodName } from '../../types.js'\nimport { isContext } from '../../predicates/is-context/is-context.predicate.js'\n\n/**\n * Restrict a hook to run for certain methods and method types.\n *\n * @see https://utils.feathersjs.com/utils/check-context.html\n */\nexport function checkContext<H extends HookContext = HookContext>(\n  context: H,\n  type?: HookType | HookType[] | null,\n  methods?: MethodName | MethodName[] | null,\n  label = 'anonymous',\n): void {\n  if (\n    !isContext({\n      method: methods ?? undefined,\n      type: type ?? undefined,\n    })(context)\n  ) {\n    throw new Error(`The '${label}' hook has invalid context.`)\n  }\n}\n","import type { HookContext } from '@feathersjs/feathers'\n\n/**\n * Converts a FeathersJS HookContext to JSON.\n * If the context has a `toJSON` method, it will call that method.\n * Otherwise, it will return the context as is.\n *\n * This is useful for serializing the context for logging or debugging purposes.\n * E.g. when you use 'has'/'get' from lodash to access properties of the context.\n *\n * @see https://utils.feathersjs.com/utils/context-to-json.html\n */\nexport const contextToJson = (context: HookContext) => {\n  if (context.toJSON) {\n    return context.toJSON()\n  }\n  return context\n}\n","import type { Application, HookOptions } from '@feathersjs/feathers'\n\n/**\n * Typescript helper function to define hooks with type safety.\n *\n * @see https://utils.feathersjs.com/utils/define-hooks.html\n */\nexport function defineHooks<\n  A extends Application = Application,\n  S = {\n    find: any\n    get: any\n    create: any\n    update: any\n    patch: any\n    remove: any\n  },\n  Options = HookOptions<A, S>,\n>(hooks: Options): Options {\n  return hooks\n}\n","import type { HookContext } from '@feathersjs/feathers'\n\n/**\n * Always returns the `context.data` as an array.\n * If `context.data` is not an array, it will be wrapped in an array.\n *\n * @see https://utils.feathersjs.com/utils/get-data-is-array.html\n */\nexport function getDataIsArray<H extends HookContext = HookContext>(\n  context: H,\n): { data: any[]; isArray: boolean } {\n  if (!context.data) {\n    return {\n      isArray: false,\n      data: [],\n    }\n  }\n\n  const isArray = Array.isArray(context.data)\n\n  return {\n    isArray,\n    data: isArray ? context.data : [context.data],\n  }\n}\n","import type { Service } from '@feathersjs/feathers'\nimport { SERVICE } from '@feathersjs/feathers'\n\n/**\n * Little helper to get methods are publicly exposed by a service.\n *\n * @see https://utils.feathersjs.com/utils/get-exposed-methods.html\n */\nexport function getExposedMethods(service: Service) {\n  const result = (service as any)[SERVICE].methods\n\n  if (!result || !Array.isArray(result)) {\n    throw new Error(`Service does not have exposed methods`)\n  }\n\n  return result\n}\n","import type { HookContext } from '@feathersjs/feathers'\nimport copy from 'fast-copy'\n\ntype GetResultIsArrayOptions = {\n  dispatch?: boolean\n}\n\nexport function getResultIsArray<H extends HookContext = HookContext>(\n  context: H,\n  options?: GetResultIsArrayOptions,\n): { isArray: boolean; result: any[]; key: 'dispatch' | 'result' } {\n  const { dispatch = false } = options || {}\n\n  const isDispatch: boolean = dispatch && context.dispatch !== undefined\n\n  const result = dispatch\n    ? isDispatch\n      ? context.dispatch\n      : copy(context.result)\n    : context.result\n\n  if (!result) {\n    return {\n      isArray: false,\n      result: [],\n      key: isDispatch ? 'dispatch' : 'result',\n    }\n  }\n\n  const items = context.method === 'find' ? result.data || result : result\n\n  const isArray = Array.isArray(items)\n\n  return {\n    isArray,\n    result: isArray ? items : items ? [items] : [],\n    key: isDispatch ? 'dispatch' : 'result',\n  }\n}\n","import type { Application, Params } from '@feathersjs/feathers'\nimport type { KeyOf } from '../../internal.utils.js'\nimport type {\n  InferFindParams,\n  InferFindResultSingle,\n} from '../../utility-types/infer-service-methods.js'\n\ntype IterateFindOptions<P extends Params = Params> = {\n  params?: P\n}\n\n/**\n * Use `for await` to iterate over the results of a `find` method.\n *\n * This function is useful for iterating over large datasets without loading everything into memory at once.\n * It uses pagination to fetch results in chunks, allowing you to process each item as it is retrieved.\n */\nexport async function* iterateFind<\n  Services,\n  Path extends KeyOf<Services>,\n  Service extends Services[Path] = Services[Path],\n  P extends Params = InferFindParams<Service>,\n  Item = InferFindResultSingle<Service>,\n>(\n  app: Application<Services>,\n  servicePath: Path,\n  options?: IterateFindOptions<P>,\n): AsyncGenerator<Item, void, unknown> {\n  const service = app.service(servicePath)\n\n  if (!service || !('find' in service)) {\n    throw new Error(`Service '${servicePath}' does not have a 'find' method.`)\n  }\n\n  const params = {\n    ...options?.params,\n    query: {\n      ...(options?.params?.query ?? {}),\n      $limit: options?.params?.query?.$limit ?? 10,\n      $skip: options?.params?.query?.$skip ?? 0,\n    },\n  }\n\n  let result\n\n  do {\n    result = await (service as any).find(params)\n\n    for (const item of result.data) {\n      yield item\n    }\n\n    params.query.$skip = (params.query.$skip ?? 0) + result.data.length\n  } while (result.total > params.query.$skip)\n}\n","import type { HookContext } from '@feathersjs/feathers'\nimport { getDataIsArray } from '../get-data-is-array/get-data-is-array.util.js'\nimport { isPromise } from '../../common/index.js'\nimport type { Promisable } from '../../internal.utils.js'\nimport type { TransformerFn } from '../../types.js'\n\nexport function mutateData<H extends HookContext = HookContext>(\n  context: H,\n  transformer: TransformerFn<any, H>,\n): Promisable<H> {\n  if (!context.data) {\n    return context\n  }\n\n  const { data, isArray } = getDataIsArray(context)\n\n  if (!data.length) {\n    return context\n  }\n\n  let hasPromises = false\n\n  const results = data.map((item, i) => {\n    const result = transformer(item, { context, i })\n\n    if (isPromise(result)) {\n      hasPromises = true\n      return result.then((res: any) => res ?? item)\n    }\n\n    return result ?? item\n  })\n\n  function mutate(data: any) {\n    context.data = isArray ? data : data[0]\n\n    return context\n  }\n\n  if (hasPromises) {\n    return Promise.all(results).then(mutate)\n  } else {\n    return mutate(results)\n  }\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { getResultIsArray } from '../get-result-is-array/get-result-is-array.util.js'\nimport { isPromise } from '../../common/index.js'\nimport copy from 'fast-copy'\nimport type { DispatchOption, TransformerFn } from '../../types.js'\n\nexport type MutateResultOptions = {\n  next?: NextFunction\n  transform?: (items: any[]) => any[]\n  dispatch?: DispatchOption\n}\n\nexport async function mutateResult<H extends HookContext = HookContext>(\n  context: H,\n  transformer: TransformerFn<any, H>,\n  options?: MutateResultOptions,\n): Promise<H> {\n  if (options?.next) {\n    await options.next()\n  }\n\n  if (!!options?.dispatch && !context.dispatch) {\n    context.dispatch = copy(context.result)\n  }\n\n  async function forResult(dispatch: boolean) {\n    const { result, isArray, key } = getResultIsArray(context, { dispatch })\n\n    if (!result.length) {\n      return context\n    }\n\n    let hasPromises = false\n\n    const results = result.map((item, i) => {\n      const result = transformer(item, { context, i })\n\n      if (isPromise(result)) {\n        hasPromises = true\n        return result.then((res: any) => res ?? item)\n      }\n\n      return result ?? item\n    })\n\n    function mutate(r: any) {\n      if (options?.transform) {\n        r = options.transform(r)\n      }\n\n      if (!isArray) {\n        context[key] = r[0]\n      } else if (isArray && !Array.isArray(context[key]) && context[key].data) {\n        context[key].data = r\n      } else {\n        context[key] = r\n      }\n\n      return context\n    }\n\n    if (hasPromises) {\n      return await Promise.all(results).then(mutate)\n    } else {\n      return mutate(results)\n    }\n  }\n\n  if (options?.dispatch === 'both') {\n    await Promise.all([forResult(true), forResult(false)])\n    return context\n  }\n\n  return await forResult(options?.dispatch ?? false)\n}\n","import type { HookContext } from '@feathersjs/feathers'\nimport { isMulti, isPaginated } from '../../predicates/index.js'\n\n/**\n * Set `context.result` to an empty array or object, depending on the hook type\n */\nexport const skipResult = <H extends HookContext = HookContext>(context: H) => {\n  if (context.result) {\n    return context\n  }\n\n  const multi = isMulti(context)\n\n  if (multi) {\n    if (context.method === 'find' && isPaginated(context)) {\n      context.result = {\n        total: 0,\n        skip: 0,\n        limit: 0,\n        data: [],\n      }\n    } else {\n      context.result = []\n    }\n  } else {\n    context.result = null\n  }\n\n  return context\n}\n","import type { Params } from '@feathersjs/feathers'\nimport type { TransformParamsFn } from '../../types.js'\n\n/**\n * Safely use a transformParams function to modify params.\n */\nexport const transformParams = <P extends Params = Params>(\n  params: P,\n  fn: TransformParamsFn<P> | undefined,\n): P => {\n  if (!fn) {\n    return params\n  }\n\n  const result = fn({ ...params })\n\n  return result ?? params\n}\n","import type { Id, Params } from '@feathersjs/feathers'\nimport { deepEqual } from 'fast-equals'\nimport type { KeyOf } from '../../internal.utils.js'\n\nexport type PatchBatchOptions<IdKey extends string> = {\n  /** the key of the id property */\n  id?: IdKey\n}\n\nexport type PatchBatchResultItem<T = Record<string, unknown>, P = Params> = [\n  Id | null,\n  T,\n  P | undefined,\n]\n\n/**\n * Batch patching utility that takes an array of items to be changed and returns an array of arguments to be called with the `patch` method.\n *\n * This utility is useful when you need to patch multiple items with varying data in as few requests as possible.\n *\n * @example\n * ```ts\n * const items = [\n *   { id: 1, value: 10 },\n *   { id: 2, value: 10 },\n *   { id: 3, value: 20 },\n * ];\n *\n * const batched = patchBatch(items, { id: 'id' });\n * // batched will be:\n * // [\n * //   [null, { value: 10 }, { query: { id: { $in: [1, 2] } } }],\n * //   [3, { value: 20 }, undefined],\n * // ]\n *\n * await Promise.all(batched.map(args => service.patch(...args)));\n * ```\n */\nexport function patchBatch<\n  T extends Record<string, any>,\n  IdKey extends KeyOf<T>,\n  P extends Params,\n  R extends Omit<T, IdKey> = Omit<T, IdKey>,\n>(\n  items: T[],\n  options?: PatchBatchOptions<IdKey>,\n): PatchBatchResultItem<R, P>[] {\n  const map: { ids: Id[]; data: R }[] = []\n\n  const idKey = options?.id ?? 'id'\n\n  for (const _data of items) {\n    const data = _data as unknown as R\n    const id = _data[idKey]\n    delete (data as any)[idKey as any]\n\n    const index = map.findIndex((item) => {\n      return deepEqual(item.data, data)\n    })\n\n    if (index === -1) {\n      map.push({ ids: [id], data })\n    } else {\n      map[index].ids.push(id)\n    }\n  }\n\n  return map.map(({ ids, data }) => {\n    return ids.length === 1\n      ? ([ids[0], data, undefined] as PatchBatchResultItem<R, P>)\n      : ([\n          null,\n          data,\n          {\n            query: {\n              [idKey]: { $in: ids },\n            },\n          },\n        ] as PatchBatchResultItem<R, P>)\n  })\n}\n"]}