feathers-utils 1.7.2 → 1.9.2

package/README.md

@@ -1,11 +1,11 @@
 # feathers-utils
 
-![npm](https://img.shields.io/npm/v/feathers-utils)
-![GitHub Workflow Status](https://img.shields.io/github/workflow/status/fratzinger/feathers-utils/Node.js%20CI)
-![Code Climate maintainability](https://img.shields.io/codeclimate/maintainability/fratzinger/feathers-utils)
-![Code Climate coverage](https://img.shields.io/codeclimate/coverage/fratzinger/feathers-utils)
-![David](https://img.shields.io/david/fratzinger/feathers-casl)
-![npm](https://img.shields.io/npm/dm/feathers-utils)
+[![npm](https://img.shields.io/npm/v/feathers-utils)](https://www.npmjs.com/package/feathers-utils)
+[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/fratzinger/feathers-utils/Node.js%20CI)](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)
+[![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)
 
 
@@ -19,8 +19,9 @@ npm i feathers-utils
 
 ### Hooks
 
-- `hooks/checkMulti()`: throws if the request is **multi** data, but the service has `allowsMulti(method)` returns `false`
-- `hooks/setData({ allowUndefined: Boolean })`
+- `checkMulti()`: throws if the request is **multi** data, but the service has `allowsMulti(method)` returns `false`
+- `runPerItem`
+- `setData({ allowUndefined: Boolean })`
 
 ### Mixins
 
@@ -30,9 +31,13 @@ npm i feathers-utils
 
 - `addHook`: add hooks to specific services
 - `filterQuery`
+- `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*
+- `setResultEmpty`
 - `shouldSkip`: checks `context.params.skipHooks` for `'all' | '${hookName}' | '${type}:${hookName}'` - also see `markHookForSkip`

package/dist/esm/hooks/checkMulti.d.ts

@@ -1,2 +1,2 @@
-import type { HookContext } from "@feathersjs/feathers";
-export declare function checkMulti(): ((context: HookContext) => HookContext);
+import type { ReturnSyncHook } from "../types";
+export declare function checkMulti(): ReturnSyncHook;

package/dist/esm/hooks/runPerItem.d.ts

@@ -1,4 +1,3 @@
-import type { HookRunPerItemOptions } from "../types";
+import type { HookRunPerItemOptions, ReturnAsyncHook, Promisable } from "../types";
 import type { HookContext } from "@feathersjs/feathers";
-import type { Promisable } from "type-fest";
-export declare const runPerItem: (actionPerItem: (item: any, context: HookContext) => Promisable<any>, options: HookRunPerItemOptions) => (context: HookContext) => Promise<HookContext>;
+export declare const runPerItem: (actionPerItem: (item: any, context: HookContext) => Promisable<any>, options: HookRunPerItemOptions) => ReturnAsyncHook;

package/dist/esm/hooks/runPerItem.js

@@ -1,19 +1,20 @@
-import { getItems } from "feathers-hooks-common";
 import { shouldSkip } from "../utils/shouldSkip";
+import { getItemsIsArray } from "../utils/getItemsIsArray";
 const makeOptions = (options) => {
     options = options || {};
     return Object.assign({
         wait: true
     }, options);
 };
-export const runPerItem = (actionPerItem, options) => {
+export const runPerItem = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+actionPerItem, options) => {
     options = makeOptions(options);
     return async (context) => {
         if (shouldSkip("runForItems", context)) {
             return context;
         }
-        let items = getItems(context);
-        items = (Array.isArray(items)) ? items : [items];
+        const { items } = getItemsIsArray(context);
         const promises = items.map(async (item) => {
             await actionPerItem(item, context);
         });

package/dist/esm/hooks/setData.d.ts

@@ -1,4 +1,3 @@
-import type { HookContext } from "@feathersjs/feathers";
-import type { HookSetDataOptions } from "../types";
 import type { PropertyPath } from "lodash";
-export declare function setData(from: PropertyPath, to: PropertyPath, _options?: HookSetDataOptions): ((context: HookContext) => HookContext);
+import type { HookSetDataOptions, ReturnSyncHook } from "../types";
+export declare function setData(from: PropertyPath, to: PropertyPath, _options?: HookSetDataOptions): ReturnSyncHook;

package/dist/esm/hooks/setData.js

@@ -1,8 +1,8 @@
 import _get from "lodash/get";
 import _set from "lodash/set";
 import _has from "lodash/has";
-import { getItems } from "feathers-hooks-common";
 import { Forbidden } from "@feathersjs/errors";
+import { getItemsIsArray } from "../utils/getItemsIsArray";
 const defaultOptions = {
     allowUndefined: false,
     overwrite: true
@@ -10,8 +10,7 @@ const defaultOptions = {
 export function setData(from, to, _options) {
     const options = Object.assign({}, defaultOptions, _options);
     return (context) => {
-        let items = getItems(context);
-        items = (Array.isArray(items)) ? items : [items];
+        const { items } = getItemsIsArray(context);
         if (!_has(context, from)) {
             if (!context.params?.provider || options.allowUndefined === true) {
                 return context;
@@ -23,7 +22,14 @@ export function setData(from, to, _options) {
         }
         const val = _get(context, from);
         items.forEach((item) => {
-            if (!options.overwrite && _has(item, to)) {
+            let overwrite;
+            if (typeof options.overwrite === "function") {
+                overwrite = options.overwrite(item, context);
+            }
+            else {
+                overwrite = options.overwrite;
+            }
+            if (!overwrite && _has(item, to)) {
                 return;
             }
             _set(item, to, val);

package/dist/esm/index.d.ts

@@ -4,7 +4,7 @@ import { runPerItem } from "./hooks/runPerItem";
 export declare const hooks: {
     checkMulti: typeof checkMulti;
     setData: typeof setData;
-    runPerItem: (actionPerItem: (item: any, context: import("@feathersjs/feathers").HookContext<any, import("@feathersjs/feathers").Service<any>>) => any, options: import("./types").HookRunPerItemOptions) => (context: import("@feathersjs/feathers").HookContext<any, import("@feathersjs/feathers").Service<any>>) => Promise<import("@feathersjs/feathers").HookContext<any, import("@feathersjs/feathers").Service<any>>>;
+    runPerItem: (actionPerItem: (item: any, context: import("@feathersjs/feathers").HookContext<any, import("@feathersjs/feathers").Service<any>>) => any, options: import("./types").HookRunPerItemOptions) => import("./types").ReturnAsyncHook;
 };
 export { checkMulti };
 export { setData };
@@ -25,6 +25,7 @@ export { mergeArrays } from "./utils/mergeQuery/mergeArrays";
 export { pushSet } from "./utils/pushSet";
 export { setResultEmpty } from "./utils/setResultEmpty";
 export { markHookForSkip } from "./utils/markHookForSkip";
-export { shouldSkip } from "./utils/shouldSkip";
 export { filterQuery } from "./utils/filterQuery";
+export { getItemsIsArray } from "./utils/getItemsIsArray";
+export { shouldSkip } from "./utils/shouldSkip";
 export * from "./types";

package/dist/esm/index.js

@@ -26,6 +26,7 @@ export { mergeArrays } from "./utils/mergeQuery/mergeArrays";
 export { pushSet } from "./utils/pushSet";
 export { setResultEmpty } from "./utils/setResultEmpty";
 export { markHookForSkip } from "./utils/markHookForSkip";
-export { shouldSkip } from "./utils/shouldSkip";
 export { filterQuery } from "./utils/filterQuery";
+export { getItemsIsArray } from "./utils/getItemsIsArray";
+export { shouldSkip } from "./utils/shouldSkip";
 export * from "./types";

package/dist/esm/types.d.ts

@@ -1,12 +1,18 @@
-import type { Application, Service } from "@feathersjs/feathers";
+import type { Application, HookContext, Service } from "@feathersjs/feathers";
 export declare type Path = Array<string | number>;
+export declare type MaybeArray<T> = T | T[];
+export declare type Promisable<T> = T | Promise<T>;
 export declare type HookType = "before" | "after" | "error";
 export declare type ServiceMethodName = "find" | "get" | "create" | "update" | "patch" | "remove";
+export declare type ReturnSyncHook = (context: HookContext) => HookContext;
+export declare type ReturnAsyncHook = (context: HookContext) => Promise<HookContext>;
 export declare type Handle = "target" | "source" | "combine" | "intersect" | "intersectOrFull";
 export declare type FirstLast = "first" | "last";
+export declare type Predicate<T = any> = (item: T) => boolean;
+export declare type PredicateWithContext<T = any> = (item: T, context: HookContext) => boolean;
 export interface HookSetDataOptions {
     allowUndefined?: boolean;
-    overwrite?: boolean;
+    overwrite?: boolean | PredicateWithContext;
 }
 export interface AddHookOptions {
     types: HookType[];
@@ -57,3 +63,7 @@ export interface FilterQueryResult {
     paginate?: unknown;
     [key: string]: unknown;
 }
+export interface GetItemsIsArrayOptions<T = any> {
+    items: T[];
+    isArray: boolean;
+}

package/dist/esm/utils/getItemsIsArray.d.ts

@@ -0,0 +1,3 @@
+import type { HookContext } from "@feathersjs/feathers";
+import type { GetItemsIsArrayOptions } from "..";
+export declare const getItemsIsArray: <T = any>(context: HookContext) => GetItemsIsArrayOptions<T>;

package/dist/esm/utils/getItemsIsArray.js

@@ -0,0 +1,10 @@
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const getItemsIsArray = (context) => {
+    let itemOrItems = context.type === "before" ? context.data : context.result;
+    itemOrItems = itemOrItems && context.method === "find" ? (itemOrItems.data || itemOrItems) : itemOrItems;
+    const isArray = Array.isArray(itemOrItems);
+    return {
+        items: (isArray) ? itemOrItems : [itemOrItems],
+        isArray
+    };
+};

package/dist/esm/utils/getPaginate.d.ts

@@ -1,2 +1,2 @@
-import { HookContext, PaginationOptions } from "@feathersjs/feathers";
+import type { HookContext, PaginationOptions } from "@feathersjs/feathers";
 export declare const getPaginate: (context: HookContext) => PaginationOptions | undefined;

package/dist/esm/utils/isPaginated.d.ts

@@ -1,2 +1,2 @@
-import { HookContext } from "@feathersjs/feathers";
+import type { HookContext } from "@feathersjs/feathers";
 export declare const isPaginated: (context: HookContext) => boolean;

package/dist/esm/utils/markHookForSkip.d.ts

@@ -1,3 +1,3 @@
 import type { HookContext } from "@feathersjs/feathers";
-import type { HookType } from "feathers-hooks-common/types";
-export declare function markHookForSkip<T>(hookName: string, type: "all" | HookType | HookType[], context?: Partial<HookContext<T>>): Partial<HookContext<T>>;
+import type { HookType, MaybeArray } from "../types";
+export declare function markHookForSkip<T>(hookName: string, type: "all" | MaybeArray<HookType>, context?: Partial<HookContext<T>>): Partial<HookContext<T>>;

package/dist/esm/utils/setResultEmpty.d.ts

@@ -1,2 +1,2 @@
-import { HookContext } from "@feathersjs/feathers";
+import type { HookContext } from "@feathersjs/feathers";
 export declare const setResultEmpty: (context: HookContext) => HookContext;

package/dist/hooks/checkMulti.d.ts

@@ -1,2 +1,2 @@
-import type { HookContext } from "@feathersjs/feathers";
-export declare function checkMulti(): ((context: HookContext) => HookContext);
+import type { ReturnSyncHook } from "../types";
+export declare function checkMulti(): ReturnSyncHook;

package/dist/hooks/checkMulti.js

@@ -6,11 +6,11 @@ const shouldSkip_1 = require("../utils/shouldSkip");
 const isMulti_1 = require("../utils/isMulti");
 function checkMulti() {
     return (context) => {
-        if (shouldSkip_1.shouldSkip("checkMulti", context)) {
+        if ((0, shouldSkip_1.shouldSkip)("checkMulti", context)) {
             return context;
         }
         const { service, method } = context;
-        if (!service.allowsMulti || !isMulti_1.isMulti(context) || method === "find") {
+        if (!service.allowsMulti || !(0, isMulti_1.isMulti)(context) || method === "find") {
             return context;
         }
         if (!service.allowsMulti(method)) {

package/dist/hooks/runPerItem.d.ts

@@ -1,4 +1,3 @@
-import type { HookRunPerItemOptions } from "../types";
+import type { HookRunPerItemOptions, ReturnAsyncHook, Promisable } from "../types";
 import type { HookContext } from "@feathersjs/feathers";
-import type { Promisable } from "type-fest";
-export declare const runPerItem: (actionPerItem: (item: any, context: HookContext) => Promisable<any>, options: HookRunPerItemOptions) => (context: HookContext) => Promise<HookContext>;
+export declare const runPerItem: (actionPerItem: (item: any, context: HookContext) => Promisable<any>, options: HookRunPerItemOptions) => ReturnAsyncHook;

package/dist/hooks/runPerItem.js

@@ -10,22 +10,23 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runPerItem = void 0;
-const feathers_hooks_common_1 = require("feathers-hooks-common");
 const shouldSkip_1 = require("../utils/shouldSkip");
+const getItemsIsArray_1 = require("../utils/getItemsIsArray");
 const makeOptions = (options) => {
     options = options || {};
     return Object.assign({
         wait: true
     }, options);
 };
-const runPerItem = (actionPerItem, options) => {
+const runPerItem = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+actionPerItem, options) => {
     options = makeOptions(options);
     return (context) => __awaiter(void 0, void 0, void 0, function* () {
-        if (shouldSkip_1.shouldSkip("runForItems", context)) {
+        if ((0, shouldSkip_1.shouldSkip)("runForItems", context)) {
             return context;
         }
-        let items = feathers_hooks_common_1.getItems(context);
-        items = (Array.isArray(items)) ? items : [items];
+        const { items } = (0, getItemsIsArray_1.getItemsIsArray)(context);
         const promises = items.map((item) => __awaiter(void 0, void 0, void 0, function* () {
             yield actionPerItem(item, context);
         }));

package/dist/hooks/setData.d.ts

@@ -1,4 +1,3 @@
-import type { HookContext } from "@feathersjs/feathers";
-import type { HookSetDataOptions } from "../types";
 import type { PropertyPath } from "lodash";
-export declare function setData(from: PropertyPath, to: PropertyPath, _options?: HookSetDataOptions): ((context: HookContext) => HookContext);
+import type { HookSetDataOptions, ReturnSyncHook } from "../types";
+export declare function setData(from: PropertyPath, to: PropertyPath, _options?: HookSetDataOptions): ReturnSyncHook;

package/dist/hooks/setData.js

@@ -7,8 +7,8 @@ exports.setData = void 0;
 const get_1 = __importDefault(require("lodash/get"));
 const set_1 = __importDefault(require("lodash/set"));
 const has_1 = __importDefault(require("lodash/has"));
-const feathers_hooks_common_1 = require("feathers-hooks-common");
 const errors_1 = require("@feathersjs/errors");
+const getItemsIsArray_1 = require("../utils/getItemsIsArray");
 const defaultOptions = {
     allowUndefined: false,
     overwrite: true
@@ -17,23 +17,29 @@ function setData(from, to, _options) {
     const options = Object.assign({}, defaultOptions, _options);
     return (context) => {
         var _a;
-        let items = feathers_hooks_common_1.getItems(context);
-        items = (Array.isArray(items)) ? items : [items];
-        if (!has_1.default(context, from)) {
+        const { items } = (0, getItemsIsArray_1.getItemsIsArray)(context);
+        if (!(0, has_1.default)(context, from)) {
             if (!((_a = context.params) === null || _a === void 0 ? void 0 : _a.provider) || options.allowUndefined === true) {
                 return context;
             }
-            if (!options.overwrite && items.every((item) => has_1.default(item, to))) {
+            if (!options.overwrite && items.every((item) => (0, has_1.default)(item, to))) {
                 return context;
             }
             throw new errors_1.Forbidden(`Expected field ${from.toString()} not available`);
         }
-        const val = get_1.default(context, from);
+        const val = (0, get_1.default)(context, from);
         items.forEach((item) => {
-            if (!options.overwrite && has_1.default(item, to)) {
+            let overwrite;
+            if (typeof options.overwrite === "function") {
+                overwrite = options.overwrite(item, context);
+            }
+            else {
+                overwrite = options.overwrite;
+            }
+            if (!overwrite && (0, has_1.default)(item, to)) {
                 return;
             }
-            set_1.default(item, to, val);
+            (0, set_1.default)(item, to, val);
         });
         return context;
     };

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { runPerItem } from "./hooks/runPerItem";
 export declare const hooks: {
     checkMulti: typeof checkMulti;
     setData: typeof setData;
-    runPerItem: (actionPerItem: (item: any, context: import("@feathersjs/feathers").HookContext<any, import("@feathersjs/feathers").Service<any>>) => any, options: import("./types").HookRunPerItemOptions) => (context: import("@feathersjs/feathers").HookContext<any, import("@feathersjs/feathers").Service<any>>) => Promise<import("@feathersjs/feathers").HookContext<any, import("@feathersjs/feathers").Service<any>>>;
+    runPerItem: (actionPerItem: (item: any, context: import("@feathersjs/feathers").HookContext<any, import("@feathersjs/feathers").Service<any>>) => any, options: import("./types").HookRunPerItemOptions) => import("./types").ReturnAsyncHook;
 };
 export { checkMulti };
 export { setData };
@@ -25,6 +25,7 @@ export { mergeArrays } from "./utils/mergeQuery/mergeArrays";
 export { pushSet } from "./utils/pushSet";
 export { setResultEmpty } from "./utils/setResultEmpty";
 export { markHookForSkip } from "./utils/markHookForSkip";
-export { shouldSkip } from "./utils/shouldSkip";
 export { filterQuery } from "./utils/filterQuery";
+export { getItemsIsArray } from "./utils/getItemsIsArray";
+export { shouldSkip } from "./utils/shouldSkip";
 export * from "./types";

package/dist/index.js

@@ -10,7 +10,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterQuery = exports.shouldSkip = exports.markHookForSkip = exports.setResultEmpty = exports.pushSet = exports.mergeArrays = exports.mergeQuery = exports.isPaginated = exports.isMulti = exports.getPaginate = exports.addHook = exports.DebouncedStore = exports.debounceMixin = exports.mixins = exports.runPerItem = exports.setData = exports.checkMulti = exports.hooks = void 0;
+exports.shouldSkip = exports.getItemsIsArray = exports.filterQuery = exports.markHookForSkip = exports.setResultEmpty = exports.pushSet = exports.mergeArrays = exports.mergeQuery = exports.isPaginated = exports.isMulti = exports.getPaginate = exports.addHook = exports.DebouncedStore = exports.debounceMixin = exports.mixins = exports.runPerItem = exports.setData = exports.checkMulti = exports.hooks = void 0;
 // hooks
 const checkMulti_1 = require("./hooks/checkMulti");
 Object.defineProperty(exports, "checkMulti", { enumerable: true, get: function () { return checkMulti_1.checkMulti; } });
@@ -48,8 +48,10 @@ var setResultEmpty_1 = require("./utils/setResultEmpty");
 Object.defineProperty(exports, "setResultEmpty", { enumerable: true, get: function () { return setResultEmpty_1.setResultEmpty; } });
 var markHookForSkip_1 = require("./utils/markHookForSkip");
 Object.defineProperty(exports, "markHookForSkip", { enumerable: true, get: function () { return markHookForSkip_1.markHookForSkip; } });
-var shouldSkip_1 = require("./utils/shouldSkip");
-Object.defineProperty(exports, "shouldSkip", { enumerable: true, get: function () { return shouldSkip_1.shouldSkip; } });
 var filterQuery_1 = require("./utils/filterQuery");
 Object.defineProperty(exports, "filterQuery", { enumerable: true, get: function () { return filterQuery_1.filterQuery; } });
+var getItemsIsArray_1 = require("./utils/getItemsIsArray");
+Object.defineProperty(exports, "getItemsIsArray", { enumerable: true, get: function () { return getItemsIsArray_1.getItemsIsArray; } });
+var shouldSkip_1 = require("./utils/shouldSkip");
+Object.defineProperty(exports, "shouldSkip", { enumerable: true, get: function () { return shouldSkip_1.shouldSkip; } });
 __exportStar(require("./types"), exports);

package/dist/mixins/debounce-mixin/DebouncedStore.js

@@ -26,7 +26,7 @@ exports.makeDefaultOptions = makeDefaultOptions;
 class DebouncedStore {
     constructor(app, options) {
         this._app = app;
-        this._options = Object.assign(exports.makeDefaultOptions(), options);
+        this._options = Object.assign((0, exports.makeDefaultOptions)(), options);
         this._queueById = {};
         this._isRunningById = {};
         //this._waitingById = {};
@@ -52,7 +52,7 @@ class DebouncedStore {
             if (typeof this._queueById[id] === "function") {
                 return this._queueById[id](id, action);
             }
-            this._queueById[id] = debounce_1.default((id, action) => {
+            this._queueById[id] = (0, debounce_1.default)((id, action) => {
                 this.unbounced(id, action);
             }, wait, Object.assign(Object.assign({}, options), { leading: false })); // leading required for return promise
             return this._queueById[id](id, action);

package/dist/mixins/debounce-mixin/index.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "DebouncedStore", { enumerable: true, get: functi
 function debounceMixin(options) {
     return (app) => {
         options = options || {};
-        const defaultOptions = Object.assign(DebouncedStore_1.makeDefaultOptions(), options === null || options === void 0 ? void 0 : options.default);
+        const defaultOptions = Object.assign((0, DebouncedStore_1.makeDefaultOptions)(), options === null || options === void 0 ? void 0 : options.default);
         app.mixins.push((service, path) => {
             // if path is on blacklist, don't add debouncedStore to service
             if ((options === null || options === void 0 ? void 0 : options.blacklist) && options.blacklist.includes(path))

package/dist/types.d.ts

@@ -1,12 +1,18 @@
-import type { Application, Service } from "@feathersjs/feathers";
+import type { Application, HookContext, Service } from "@feathersjs/feathers";
 export declare type Path = Array<string | number>;
+export declare type MaybeArray<T> = T | T[];
+export declare type Promisable<T> = T | Promise<T>;
 export declare type HookType = "before" | "after" | "error";
 export declare type ServiceMethodName = "find" | "get" | "create" | "update" | "patch" | "remove";
+export declare type ReturnSyncHook = (context: HookContext) => HookContext;
+export declare type ReturnAsyncHook = (context: HookContext) => Promise<HookContext>;
 export declare type Handle = "target" | "source" | "combine" | "intersect" | "intersectOrFull";
 export declare type FirstLast = "first" | "last";
+export declare type Predicate<T = any> = (item: T) => boolean;
+export declare type PredicateWithContext<T = any> = (item: T, context: HookContext) => boolean;
 export interface HookSetDataOptions {
     allowUndefined?: boolean;
-    overwrite?: boolean;
+    overwrite?: boolean | PredicateWithContext;
 }
 export interface AddHookOptions {
     types: HookType[];
@@ -57,3 +63,7 @@ export interface FilterQueryResult {
     paginate?: unknown;
     [key: string]: unknown;
 }
+export interface GetItemsIsArrayOptions<T = any> {
+    items: T[];
+    isArray: boolean;
+}

package/dist/utils/filterQuery.js

@@ -25,9 +25,9 @@ function filterQuery(query, options) {
             return service.filterQuery({ query }, optionsForFilterQuery);
         }
         else {
-            return adapter_commons_1.filterQuery(query, optionsForFilterQuery);
+            return (0, adapter_commons_1.filterQuery)(query, optionsForFilterQuery);
         }
     }
-    return adapter_commons_1.filterQuery(query, options);
+    return (0, adapter_commons_1.filterQuery)(query, options);
 }
 exports.filterQuery = filterQuery;

package/dist/utils/getItemsIsArray.d.ts

@@ -0,0 +1,3 @@
+import type { HookContext } from "@feathersjs/feathers";
+import type { GetItemsIsArrayOptions } from "..";
+export declare const getItemsIsArray: <T = any>(context: HookContext) => GetItemsIsArrayOptions<T>;

package/dist/utils/getItemsIsArray.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getItemsIsArray = void 0;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const getItemsIsArray = (context) => {
+    let itemOrItems = context.type === "before" ? context.data : context.result;
+    itemOrItems = itemOrItems && context.method === "find" ? (itemOrItems.data || itemOrItems) : itemOrItems;
+    const isArray = Array.isArray(itemOrItems);
+    return {
+        items: (isArray) ? itemOrItems : [itemOrItems],
+        isArray
+    };
+};
+exports.getItemsIsArray = getItemsIsArray;

package/dist/utils/getPaginate.d.ts

@@ -1,2 +1,2 @@
-import { HookContext, PaginationOptions } from "@feathersjs/feathers";
+import type { HookContext, PaginationOptions } from "@feathersjs/feathers";
 export declare const getPaginate: (context: HookContext) => PaginationOptions | undefined;

package/dist/utils/isPaginated.d.ts

@@ -1,2 +1,2 @@
-import { HookContext } from "@feathersjs/feathers";
+import type { HookContext } from "@feathersjs/feathers";
 export declare const isPaginated: (context: HookContext) => boolean;

package/dist/utils/isPaginated.js

@@ -6,7 +6,7 @@ const isPaginated = (context) => {
     if (context.params.paginate === false) {
         return false;
     }
-    const paginate = getPaginate_1.getPaginate(context);
+    const paginate = (0, getPaginate_1.getPaginate)(context);
     return !!paginate;
 };
 exports.isPaginated = isPaginated;

package/dist/utils/markHookForSkip.d.ts

@@ -1,3 +1,3 @@
 import type { HookContext } from "@feathersjs/feathers";
-import type { HookType } from "feathers-hooks-common/types";
-export declare function markHookForSkip<T>(hookName: string, type: "all" | HookType | HookType[], context?: Partial<HookContext<T>>): Partial<HookContext<T>>;
+import type { HookType, MaybeArray } from "../types";
+export declare function markHookForSkip<T>(hookName: string, type: "all" | MaybeArray<HookType>, context?: Partial<HookContext<T>>): Partial<HookContext<T>>;

package/dist/utils/markHookForSkip.js

@@ -10,7 +10,7 @@ function markHookForSkip(hookName, type, context) {
         const combinedName = (t === "all")
             ? hookName
             : `${type}:${hookName}`;
-        pushSet_1.pushSet(params, ["skipHooks"], combinedName, { unique: true });
+        (0, pushSet_1.pushSet)(params, ["skipHooks"], combinedName, { unique: true });
     });
     context.params = params;
     return context;