feathers-utils 1.11.0 → 1.13.0

package/README.md

@@ -21,6 +21,7 @@ npm i feathers-utils
 
 - `checkMulti`: throws if the request is **multi** data, but the service has `allowsMulti(method)` returns `false`
 - `createRelated`: simply create related items from a hook.
+- `onDelete`: simply remove/set null related items from a hook.
 - `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`

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

@@ -0,0 +1,8 @@
+import type { ReturnAsyncHook, Promisable } from "../types";
+import type { HookContext } from "@feathersjs/feathers";
+import type { GetItemsIsArrayOptions } from "../utils/getItemsIsArray";
+export interface HookForEachOptions {
+    wait?: "sequential" | "parallel" | false;
+    items?: GetItemsIsArrayOptions["from"];
+}
+export declare const forEach: (actionPerItem: (item: any, context: HookContext) => Promisable<any>, _options?: HookForEachOptions) => ReturnAsyncHook;

package/dist/esm/hooks/forEach.js

@@ -0,0 +1,31 @@
+import { shouldSkip } from "../utils/shouldSkip";
+import { getItemsIsArray } from "../utils/getItemsIsArray";
+export const forEach = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+actionPerItem, _options) => {
+    const options = {
+        wait: "parallel",
+        items: "automatic",
+        ..._options
+    };
+    return async (context) => {
+        if (shouldSkip("runForItems", context)) {
+            return context;
+        }
+        const { items } = getItemsIsArray(context, { from: options.items });
+        const promises = [];
+        for (const item of items) {
+            const promise = actionPerItem(item, context);
+            if (options.wait === "sequential") {
+                await promise;
+            }
+            else {
+                promises.push(promise);
+            }
+        }
+        if (options.wait === "parallel") {
+            await Promise.all(promises);
+        }
+        return context;
+    };
+};

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

@@ -0,0 +1,8 @@
+import type { HookContext } from "@feathersjs/feathers";
+/**
+ * Parse fields to date or number
+ * skips undefined fields
+ */
+export declare const parseFields: (type: "date" | "number", options: {
+    fields: string[];
+}) => (context: HookContext) => HookContext<any, import("@feathersjs/feathers").Service<any>>;

package/dist/esm/hooks/parseFields.js

@@ -0,0 +1,23 @@
+import { getItemsIsArray } from "../utils/getItemsIsArray";
+/**
+ * Parse fields to date or number
+ * skips undefined fields
+ */
+export const parseFields = (type, options) => (context) => {
+    const { items } = getItemsIsArray(context);
+    items.forEach(item => {
+        options.fields.forEach(field => {
+            // ignore undefined fields
+            if (!(field in item)) {
+                return;
+            }
+            if (type === "date") {
+                item[field] = new Date(item[field]);
+            }
+            else if (type === "number") {
+                item[field] = Number(item[field]);
+            }
+        });
+    });
+    return context;
+};

package/dist/esm/index.d.ts

@@ -11,6 +11,8 @@ export { createRelated } from "./hooks/createRelated";
 export { setData };
 export { removeRelated } from "./hooks/removeRelated";
 export { runPerItem };
+export * from "./hooks/forEach";
+export * from "./hooks/parseFields";
 import { debounceMixin, DebouncedStore } from "./mixins/debounce-mixin";
 export declare const mixins: {
     debounceMixin: typeof debounceMixin;
@@ -32,3 +34,4 @@ export { getItemsIsArray } from "./utils/getItemsIsArray";
 export { onDelete } from "./hooks/onDelete";
 export { shouldSkip } from "./utils/shouldSkip";
 export * from "./types";
+export * from "./utility-types/utility-types";

package/dist/esm/index.js

@@ -5,17 +5,19 @@ import { runPerItem } from "./hooks/runPerItem";
 export const hooks = {
     checkMulti,
     setData,
-    runPerItem
+    runPerItem,
 };
 export { checkMulti };
 export { createRelated } from "./hooks/createRelated";
 export { setData };
 export { removeRelated } from "./hooks/removeRelated";
 export { runPerItem };
+export * from "./hooks/forEach";
+export * from "./hooks/parseFields";
 import { debounceMixin, DebouncedStore } from "./mixins/debounce-mixin";
 export const mixins = {
     debounceMixin,
-    DebouncedStore
+    DebouncedStore,
 };
 export { debounceMixin };
 export { DebouncedStore };
@@ -33,3 +35,4 @@ export { getItemsIsArray } from "./utils/getItemsIsArray";
 export { onDelete } from "./hooks/onDelete";
 export { shouldSkip } from "./utils/shouldSkip";
 export * from "./types";
+export * from "./utility-types/utility-types";

package/dist/esm/types.d.ts

@@ -82,7 +82,7 @@ export interface FilterQueryResult {
     paginate?: unknown;
     [key: string]: unknown;
 }
-export interface GetItemsIsArrayOptions<T = any> {
+export interface GetItemsIsArrayResult<T = any> {
     items: T[];
     isArray: boolean;
 }

package/dist/esm/utility-types/utility-types.d.ts

@@ -0,0 +1,33 @@
+export declare type InferCreateData<S> = S extends {
+    create: (data: infer D, params: any) => any;
+} ? D : never;
+export declare type InferCreateDataSingle<S> = S extends {
+    create: (data: infer D, params: any) => any;
+} ? D extends Array<infer T> ? T : D : never;
+export declare type InferUpdateData<S> = S extends {
+    update: (id: any, data: infer D, params: any) => any;
+} ? D : never;
+export declare type InferPatchData<S> = S extends {
+    patch: (id: any, data: infer D, params: any) => any;
+} ? D : never;
+export declare type InferGetResult<S> = S extends {
+    get: (id: any, params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferFindResult<S> = S extends {
+    find: (params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferCreateResult<S, D = any> = S extends {
+    create: (data: D, params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferCreateResultSingle<S> = S extends {
+    create: (data: any, params: any) => infer R;
+} ? Awaited<R> extends Array<infer T> ? T : Awaited<R> : never;
+export declare type InferUpdateResult<S> = S extends {
+    update: (id: any, data: any, params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferPatchResult<S, Id = any> = S extends {
+    patch: (id: Id, data: any, params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferRemoveResult<S, Id = any> = S extends {
+    remove: (id: Id, params: any) => infer R;
+} ? Awaited<R> : never;

package/dist/esm/utility-types/utility-types.js

@@ -0,0 +1 @@
+export {};

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

@@ -1,3 +1,6 @@
 import type { HookContext } from "@feathersjs/feathers";
-import type { GetItemsIsArrayOptions } from "..";
-export declare const getItemsIsArray: <T = any>(context: HookContext) => GetItemsIsArrayOptions<T>;
+import type { GetItemsIsArrayResult } from "..";
+export declare type GetItemsIsArrayOptions = {
+    from: "data" | "result" | "automatic";
+};
+export declare const getItemsIsArray: <T = any>(context: HookContext, options?: GetItemsIsArrayOptions) => GetItemsIsArrayResult<T>;

package/dist/esm/utils/getItemsIsArray.js

@@ -1,11 +1,21 @@
 // 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;
+export const getItemsIsArray = (context, options) => {
+    const { from = "automatic" } = options || {};
+    let itemOrItems;
+    if (from === "automatic") {
+        itemOrItems = context.type === "before"
+            ? context.data
+            : context.result;
+        itemOrItems = itemOrItems && context.method === "find"
+            ? (itemOrItems.data || itemOrItems)
+            : itemOrItems;
+    }
+    else if (from === "data") {
+        itemOrItems = context.data;
+    }
+    else if (from === "result") {
+        itemOrItems = context.result;
+    }
     const isArray = Array.isArray(itemOrItems);
     return {
         items: (isArray)

package/dist/hooks/forEach.d.ts

@@ -0,0 +1,8 @@
+import type { ReturnAsyncHook, Promisable } from "../types";
+import type { HookContext } from "@feathersjs/feathers";
+import type { GetItemsIsArrayOptions } from "../utils/getItemsIsArray";
+export interface HookForEachOptions {
+    wait?: "sequential" | "parallel" | false;
+    items?: GetItemsIsArrayOptions["from"];
+}
+export declare const forEach: (actionPerItem: (item: any, context: HookContext) => Promisable<any>, _options?: HookForEachOptions) => ReturnAsyncHook;

package/dist/hooks/forEach.js

@@ -0,0 +1,40 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forEach = void 0;
+const shouldSkip_1 = require("../utils/shouldSkip");
+const getItemsIsArray_1 = require("../utils/getItemsIsArray");
+const forEach = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+actionPerItem, _options) => {
+    const options = Object.assign({ wait: "parallel", items: "automatic" }, _options);
+    return (context) => __awaiter(void 0, void 0, void 0, function* () {
+        if ((0, shouldSkip_1.shouldSkip)("runForItems", context)) {
+            return context;
+        }
+        const { items } = (0, getItemsIsArray_1.getItemsIsArray)(context, { from: options.items });
+        const promises = [];
+        for (const item of items) {
+            const promise = actionPerItem(item, context);
+            if (options.wait === "sequential") {
+                yield promise;
+            }
+            else {
+                promises.push(promise);
+            }
+        }
+        if (options.wait === "parallel") {
+            yield Promise.all(promises);
+        }
+        return context;
+    });
+};
+exports.forEach = forEach;

package/dist/hooks/parseFields.d.ts

@@ -0,0 +1,8 @@
+import type { HookContext } from "@feathersjs/feathers";
+/**
+ * Parse fields to date or number
+ * skips undefined fields
+ */
+export declare const parseFields: (type: "date" | "number", options: {
+    fields: string[];
+}) => (context: HookContext) => HookContext<any, import("@feathersjs/feathers").Service<any>>;

package/dist/hooks/parseFields.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFields = void 0;
+const getItemsIsArray_1 = require("../utils/getItemsIsArray");
+/**
+ * Parse fields to date or number
+ * skips undefined fields
+ */
+const parseFields = (type, options) => (context) => {
+    const { items } = (0, getItemsIsArray_1.getItemsIsArray)(context);
+    items.forEach(item => {
+        options.fields.forEach(field => {
+            // ignore undefined fields
+            if (!(field in item)) {
+                return;
+            }
+            if (type === "date") {
+                item[field] = new Date(item[field]);
+            }
+            else if (type === "number") {
+                item[field] = Number(item[field]);
+            }
+        });
+    });
+    return context;
+};
+exports.parseFields = parseFields;

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export { createRelated } from "./hooks/createRelated";
 export { setData };
 export { removeRelated } from "./hooks/removeRelated";
 export { runPerItem };
+export * from "./hooks/forEach";
+export * from "./hooks/parseFields";
 import { debounceMixin, DebouncedStore } from "./mixins/debounce-mixin";
 export declare const mixins: {
     debounceMixin: typeof debounceMixin;
@@ -32,3 +34,4 @@ export { getItemsIsArray } from "./utils/getItemsIsArray";
 export { onDelete } from "./hooks/onDelete";
 export { shouldSkip } from "./utils/shouldSkip";
 export * from "./types";
+export * from "./utility-types/utility-types";

package/dist/index.js

@@ -25,18 +25,20 @@ Object.defineProperty(exports, "runPerItem", { enumerable: true, get: function (
 exports.hooks = {
     checkMulti: checkMulti_1.checkMulti,
     setData: setData_1.setData,
-    runPerItem: runPerItem_1.runPerItem
+    runPerItem: runPerItem_1.runPerItem,
 };
 var createRelated_1 = require("./hooks/createRelated");
 Object.defineProperty(exports, "createRelated", { enumerable: true, get: function () { return createRelated_1.createRelated; } });
 var removeRelated_1 = require("./hooks/removeRelated");
 Object.defineProperty(exports, "removeRelated", { enumerable: true, get: function () { return removeRelated_1.removeRelated; } });
+__exportStar(require("./hooks/forEach"), exports);
+__exportStar(require("./hooks/parseFields"), exports);
 const debounce_mixin_1 = require("./mixins/debounce-mixin");
 Object.defineProperty(exports, "debounceMixin", { enumerable: true, get: function () { return debounce_mixin_1.debounceMixin; } });
 Object.defineProperty(exports, "DebouncedStore", { enumerable: true, get: function () { return debounce_mixin_1.DebouncedStore; } });
 exports.mixins = {
     debounceMixin: debounce_mixin_1.debounceMixin,
-    DebouncedStore: debounce_mixin_1.DebouncedStore
+    DebouncedStore: debounce_mixin_1.DebouncedStore,
 };
 var addHook_1 = require("./utils/addHook");
 Object.defineProperty(exports, "addHook", { enumerable: true, get: function () { return addHook_1.addHook; } });
@@ -65,3 +67,4 @@ Object.defineProperty(exports, "onDelete", { enumerable: true, get: function ()
 var shouldSkip_1 = require("./utils/shouldSkip");
 Object.defineProperty(exports, "shouldSkip", { enumerable: true, get: function () { return shouldSkip_1.shouldSkip; } });
 __exportStar(require("./types"), exports);
+__exportStar(require("./utility-types/utility-types"), exports);

package/dist/types.d.ts

@@ -82,7 +82,7 @@ export interface FilterQueryResult {
     paginate?: unknown;
     [key: string]: unknown;
 }
-export interface GetItemsIsArrayOptions<T = any> {
+export interface GetItemsIsArrayResult<T = any> {
     items: T[];
     isArray: boolean;
 }

package/dist/utility-types/utility-types.d.ts

@@ -0,0 +1,33 @@
+export declare type InferCreateData<S> = S extends {
+    create: (data: infer D, params: any) => any;
+} ? D : never;
+export declare type InferCreateDataSingle<S> = S extends {
+    create: (data: infer D, params: any) => any;
+} ? D extends Array<infer T> ? T : D : never;
+export declare type InferUpdateData<S> = S extends {
+    update: (id: any, data: infer D, params: any) => any;
+} ? D : never;
+export declare type InferPatchData<S> = S extends {
+    patch: (id: any, data: infer D, params: any) => any;
+} ? D : never;
+export declare type InferGetResult<S> = S extends {
+    get: (id: any, params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferFindResult<S> = S extends {
+    find: (params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferCreateResult<S, D = any> = S extends {
+    create: (data: D, params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferCreateResultSingle<S> = S extends {
+    create: (data: any, params: any) => infer R;
+} ? Awaited<R> extends Array<infer T> ? T : Awaited<R> : never;
+export declare type InferUpdateResult<S> = S extends {
+    update: (id: any, data: any, params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferPatchResult<S, Id = any> = S extends {
+    patch: (id: Id, data: any, params: any) => infer R;
+} ? Awaited<R> : never;
+export declare type InferRemoveResult<S, Id = any> = S extends {
+    remove: (id: Id, params: any) => infer R;
+} ? Awaited<R> : never;

package/dist/utility-types/utility-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/getItemsIsArray.d.ts

@@ -1,3 +1,6 @@
 import type { HookContext } from "@feathersjs/feathers";
-import type { GetItemsIsArrayOptions } from "..";
-export declare const getItemsIsArray: <T = any>(context: HookContext) => GetItemsIsArrayOptions<T>;
+import type { GetItemsIsArrayResult } from "..";
+export declare type GetItemsIsArrayOptions = {
+    from: "data" | "result" | "automatic";
+};
+export declare const getItemsIsArray: <T = any>(context: HookContext, options?: GetItemsIsArrayOptions) => GetItemsIsArrayResult<T>;

package/dist/utils/getItemsIsArray.js

@@ -2,13 +2,23 @@
 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 getItemsIsArray = (context, options) => {
+    const { from = "automatic" } = options || {};
+    let itemOrItems;
+    if (from === "automatic") {
+        itemOrItems = context.type === "before"
+            ? context.data
+            : context.result;
+        itemOrItems = itemOrItems && context.method === "find"
+            ? (itemOrItems.data || itemOrItems)
+            : itemOrItems;
+    }
+    else if (from === "data") {
+        itemOrItems = context.data;
+    }
+    else if (from === "result") {
+        itemOrItems = context.result;
+    }
     const isArray = Array.isArray(itemOrItems);
     return {
         items: (isArray)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feathers-utils",
-  "version": "1.11.0",
+  "version": "1.13.0",
   "description": "Some utils for projects using '@feathersjs/feathers'",
   "author": "fratzinger",
   "repository": {

package/src/hooks/forEach.ts

@@ -0,0 +1,47 @@
+import { shouldSkip } from "../utils/shouldSkip";
+
+import type { ReturnAsyncHook, Promisable } from "../types";
+import type { HookContext } from "@feathersjs/feathers";
+import type { GetItemsIsArrayOptions } from "../utils/getItemsIsArray";
+import { getItemsIsArray } from "../utils/getItemsIsArray";
+
+export interface HookForEachOptions {
+  wait?: "sequential" | "parallel" | false
+  items?: GetItemsIsArrayOptions["from"]
+}
+
+export const forEach = (
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  actionPerItem: (item: any, context: HookContext) => Promisable<any>, 
+  _options?: HookForEachOptions
+): ReturnAsyncHook => {
+  const options: Required<HookForEachOptions> = {
+    wait: "parallel",
+    items: "automatic",
+    ..._options
+  };
+
+  return async (context: HookContext): Promise<HookContext> => {
+    if (shouldSkip("runForItems", context)) { return context; }
+
+    const { items } =  getItemsIsArray(context, { from: options.items });
+
+    const promises: Promise<any>[] = [];
+
+    for (const item of items) {
+      const promise = actionPerItem(item, context);
+
+      if (options.wait === "sequential") {
+        await promise;
+      } else {
+        promises.push(promise);
+      }
+    }
+
+    if (options.wait === "parallel") {
+      await Promise.all(promises);
+    }
+
+    return context;
+  };
+};

package/src/hooks/parseFields.ts

@@ -0,0 +1,27 @@
+import type { HookContext } from "@feathersjs/feathers";
+import { getItemsIsArray } from "../utils/getItemsIsArray";
+
+/**
+ * Parse fields to date or number
+ * skips undefined fields
+ */
+export const parseFields = (type: "date" | "number", options: { fields: string[] }) => (context: HookContext) => {
+  const { items } = getItemsIsArray(context);
+  
+  items.forEach(item => {
+    options.fields.forEach(field => {
+      // ignore undefined fields
+      if (!(field in item)) {
+        return;
+      }
+  
+      if (type === "date") {
+        item[field] = new Date(item[field]);
+      } else if (type === "number") {
+        item[field] = Number(item[field]);
+      }
+    });
+  });
+
+  return context;
+};

package/src/index.ts

@@ -7,7 +7,7 @@ import { runPerItem } from "./hooks/runPerItem";
 export const hooks = {
   checkMulti,
   setData,
-  runPerItem
+  runPerItem,
 };
 
 export { checkMulti };
@@ -15,12 +15,14 @@ export { createRelated } from "./hooks/createRelated";
 export { setData };
 export { removeRelated } from "./hooks/removeRelated";
 export { runPerItem };
+export * from "./hooks/forEach";
+export * from "./hooks/parseFields";
 
 import { debounceMixin, DebouncedStore } from "./mixins/debounce-mixin";
 
 export const mixins = {
   debounceMixin,
-  DebouncedStore
+  DebouncedStore,
 };
 
 export { debounceMixin };
@@ -41,5 +43,5 @@ export { getItemsIsArray } from "./utils/getItemsIsArray";
 export { onDelete } from "./hooks/onDelete";
 export { shouldSkip } from "./utils/shouldSkip";
 
-
-export * from "./types";
+export * from "./types";
+export * from "./utility-types/utility-types";

package/src/types.ts

@@ -120,7 +120,7 @@ export interface FilterQueryResult {
 }
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-export interface GetItemsIsArrayOptions<T = any> {
+export interface GetItemsIsArrayResult<T = any> {
   items: T[]
   isArray: boolean
 }

package/src/utility-types/utility-types.ts

@@ -0,0 +1,69 @@
+export type InferCreateData<S> = S extends {
+  create: (data: infer D, params: any) => any;
+}
+  ? D
+  : never;
+
+export type InferCreateDataSingle<S> = S extends {
+  create: (data: infer D, params: any) => any;
+}
+  ? D extends Array<infer T>
+    ? T
+    : D
+  : never;
+
+export type InferUpdateData<S> = S extends {
+  update: (id: any, data: infer D, params: any) => any;
+}
+  ? D
+  : never;
+
+export type InferPatchData<S> = S extends {
+  patch: (id: any, data: infer D, params: any) => any;
+}
+  ? D
+  : never;
+
+export type InferGetResult<S> = S extends {
+  get: (id: any, params: any) => infer R;
+}
+  ? Awaited<R>
+  : never;
+
+export type InferFindResult<S> = S extends {
+  find: (params: any) => infer R;
+}
+  ? Awaited<R>
+  : never;
+
+export type InferCreateResult<S, D = any> = S extends {
+  create: (data: D, params: any) => infer R;
+}
+  ? Awaited<R>
+  : never;
+
+export type InferCreateResultSingle<S> = S extends {
+  create: (data: any, params: any) => infer R;
+}
+  ? Awaited<R> extends Array<infer T>
+    ? T
+    : Awaited<R>
+  : never;
+
+export type InferUpdateResult<S> = S extends {
+  update: (id: any, data: any, params: any) => infer R;
+}
+  ? Awaited<R>
+  : never;
+
+export type InferPatchResult<S, Id = any> = S extends {
+  patch: (id: Id, data: any, params: any) => infer R;
+}
+  ? Awaited<R>
+  : never;
+
+export type InferRemoveResult<S, Id = any> = S extends {
+  remove: (id: Id, params: any) => infer R;
+}
+  ? Awaited<R>
+  : never;

package/src/utils/getItemsIsArray.ts

@@ -1,16 +1,34 @@
 import type { HookContext } from "@feathersjs/feathers";
-import type { GetItemsIsArrayOptions } from "..";
+import type { GetItemsIsArrayResult } from "..";
+
+export type GetItemsIsArrayOptions = {
+  from: "data" | "result" | "automatic"
+}
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const getItemsIsArray = <T = any>(
-  context: HookContext
-): GetItemsIsArrayOptions<T> => {
-  let itemOrItems = context.type === "before" 
-    ? context.data 
-    : context.result;
-  itemOrItems = itemOrItems && context.method === "find" 
-    ? (itemOrItems.data || itemOrItems) 
-    : itemOrItems;
+  context: HookContext,
+  options?: GetItemsIsArrayOptions
+): GetItemsIsArrayResult<T> => {
+  const {
+    from = "automatic"
+  } = options || {};
+
+  let itemOrItems;
+
+  if (from === "automatic") {
+    itemOrItems = context.type === "before" 
+      ? context.data 
+      : context.result;
+    itemOrItems = itemOrItems && context.method === "find" 
+      ? (itemOrItems.data || itemOrItems) 
+      : itemOrItems;
+  } else if (from === "data") {
+    itemOrItems = context.data;
+  } else if (from === "result") {
+    itemOrItems = context.result;
+  }
+  
   const isArray = Array.isArray(itemOrItems);
   return {
     items: (isArray)