feathers-utils 10.2.0 → 10.3.0

package/dist/hooks.d.mts

@@ -249,6 +249,54 @@ declare function createRelated<H extends HookContext = HookContext>(options: May
  */
 declare const debug: <H extends HookContext = HookContext>(msg: string, ...fieldNames: string[]) => (context: H, next?: NextFunction) => Promise<void>;
 //#endregion
+//#region src/hooks/disable-pagination/disable-pagination.hook.d.ts
+/**
+ * Disables pagination when `query.$limit` is `-1` or `'-1'`.
+ * Removes the `$limit` from the query and sets `params.paginate = false`.
+ * Must be used as a `before` or `around` hook on the `find` method.
+ *
+ * @example
+ * ```ts
+ * import { disablePagination } from 'feathers-utils/hooks'
+ *
+ * app.service('users').hooks({
+ *   before: { find: [disablePagination()] }
+ * })
+ * // Then call: app.service('users').find({ query: { $limit: -1 } })
+ * ```
+ *
+ * @see https://utils.feathersjs.com/hooks/disable-pagination.html
+ */
+declare const disablePagination: <H extends HookContext = HookContext>() => {
+  (context: H): void;
+  (context: H, next: NextFunction): Promise<void>;
+};
+//#endregion
+//#region src/hooks/disallow/disallow.hook.d.ts
+/**
+ * Prevents access to a service method completely or for specific transports.
+ * When called without arguments, the method is blocked for all callers.
+ * When called with transport names, only those transports are blocked.
+ *
+ * @example
+ * ```ts
+ * import { disallow } from 'feathers-utils/hooks'
+ *
+ * app.service('users').hooks({
+ *   before: {
+ *     remove: [disallow('external')], // block external access
+ *     update: [disallow()],           // block completely
+ *   }
+ * })
+ * ```
+ *
+ * @see https://utils.feathersjs.com/hooks/disallow.html
+ */
+declare const disallow: <H extends HookContext = HookContext>(transports?: MaybeArray<TransportName>) => {
+  (context: H): void;
+  (context: H, next: NextFunction): Promise<void>;
+};
+//#endregion
 //#region src/hooks/find-or-create/find-or-create.hook.d.ts
 /**
  * The valid `uniqueBy` paths for a service's create data. Falls back to a plain
@@ -303,54 +351,6 @@ interface FindOrCreateOptions<H extends HookContext = HookContext, Services exte
  */
 declare function findOrCreate<H extends HookContext = HookContext>(options: FindOrCreateOptions<H>): (context: H, next?: NextFunction) => Promise<void>;
 //#endregion
-//#region src/hooks/disable-pagination/disable-pagination.hook.d.ts
-/**
- * Disables pagination when `query.$limit` is `-1` or `'-1'`.
- * Removes the `$limit` from the query and sets `params.paginate = false`.
- * Must be used as a `before` or `around` hook on the `find` method.
- *
- * @example
- * ```ts
- * import { disablePagination } from 'feathers-utils/hooks'
- *
- * app.service('users').hooks({
- *   before: { find: [disablePagination()] }
- * })
- * // Then call: app.service('users').find({ query: { $limit: -1 } })
- * ```
- *
- * @see https://utils.feathersjs.com/hooks/disable-pagination.html
- */
-declare const disablePagination: <H extends HookContext = HookContext>() => {
-  (context: H): void;
-  (context: H, next: NextFunction): Promise<void>;
-};
-//#endregion
-//#region src/hooks/disallow/disallow.hook.d.ts
-/**
- * Prevents access to a service method completely or for specific transports.
- * When called without arguments, the method is blocked for all callers.
- * When called with transport names, only those transports are blocked.
- *
- * @example
- * ```ts
- * import { disallow } from 'feathers-utils/hooks'
- *
- * app.service('users').hooks({
- *   before: {
- *     remove: [disallow('external')], // block external access
- *     update: [disallow()],           // block completely
- *   }
- * })
- * ```
- *
- * @see https://utils.feathersjs.com/hooks/disallow.html
- */
-declare const disallow: <H extends HookContext = HookContext>(transports?: MaybeArray<TransportName>) => {
-  (context: H): void;
-  (context: H, next: NextFunction): Promise<void>;
-};
-//#endregion
 //#region src/hooks/mute-event/mute-event.hook.d.ts
 type MuteEventOptions<H extends HookContext = HookContext> = {
   /**

package/dist/hooks.mjs

@@ -1,5 +1,5 @@
-import { _ as combine, a as iffElse, i as iff, n as skippable, r as unless, t as throwIf } from "./predicates-puYa4nkf.mjs";
-import { C as checkMulti, S as checkRequired, _ as disallow, a as softDelete, b as debug, c as setQueryDefaults, d as rateLimit, f as preventChanges, g as muteEvent, h as onDelete, i as stashable, l as setField, m as paramsForServer, n as throwIfIsProvider, o as setSlug, p as paramsFromClient, r as throwIfIsMulti, s as setResult, t as traverse, u as setData, v as disablePagination, w as cache, x as createRelated, y as findOrCreate } from "./hooks-tfw03iVM.mjs";
-import { n as transformQuery, r as transformData, t as transformResult } from "./transform-result.hook-B65pTRJO.mjs";
-import { i as resolveData, n as resolveQuery, r as resolveResult, t as resolve } from "./resolve-B9hRleHY.mjs";
+import { _ as combine, a as iffElse, i as iff, n as throwIf, r as skippable, t as unless } from "./predicates-NOnUyMic.mjs";
+import { C as checkMulti, S as checkRequired, _ as findOrCreate, a as softDelete, b as debug, c as setQueryDefaults, d as rateLimit, f as preventChanges, g as muteEvent, h as onDelete, i as stashable, l as setField, m as paramsForServer, n as throwIfIsProvider, o as setSlug, p as paramsFromClient, r as throwIfIsMulti, s as setResult, t as traverse, u as setData, v as disallow, w as cache, x as createRelated, y as disablePagination } from "./hooks-DpFQfcFa.mjs";
+import { n as transformQuery, r as transformData, t as transformResult } from "./transform-result.hook-V2QYN2K0.mjs";
+import { i as resolveData, n as resolveQuery, r as resolveResult, t as resolve } from "./resolve-BflgIVD8.mjs";
 export { cache, checkMulti, checkRequired, combine, createRelated, debug, disablePagination, disallow, findOrCreate, iff, iff as when, iffElse, muteEvent, onDelete, paramsForServer, paramsFromClient, preventChanges, rateLimit, resolve, resolveData, resolveQuery, resolveResult, setData, setField, setQueryDefaults, setResult, setSlug, skippable, softDelete, stashable, throwIf, throwIfIsMulti, throwIfIsProvider, transformData, transformQuery, transformResult, traverse, unless };

package/dist/{index-CKAzIogj.d.mts → index-C6MN6wag.d.mts}

@@ -23,45 +23,13 @@ type SkipHookName = 'all' | HookType | `${HookType}:${string}` | (string & {});
  */
 declare const addSkip: <H extends HookContext>(context: H, hooks: MaybeArray<SkipHookName>) => void;
 //#endregion
-//#region src/utils/chunk-find/chunk-find.util.d.ts
-type PaginateOption$1 = {
-  default?: number;
-  max?: number;
-};
-type ChunkFindOptions<P extends Params = Params> = {
-  params?: P & {
-    paginate?: PaginateOption$1;
-  };
-};
-/**
- * Use `for await` to iterate over chunks (pages) of results from a `find` method.
- *
- * This function is useful for processing large datasets in batches without loading everything into memory at once.
- * It uses pagination to fetch results in chunks, yielding each page's data array.
- *
- * @example
- * ```ts
- * import { chunkFind } from 'feathers-utils/utils'
- *
- * const app = feathers()
- *
- * // Assuming 'users' service has many records
- * for await (const users of chunkFind(app, 'users', {
- *  params: { query: { active: true }, // Custom query parameters
- * } })) {
- *  console.log(users) // Process each chunk of user records
- * }
- * ```
- *
- * @see https://utils.feathersjs.com/utils/chunk-find.html
- */
-declare function chunkFind<Services, Path extends KeyOf<Services>, Service extends Services[Path] = Services[Path], P extends Params = InferFindParams<Service>, Item = InferFindResultSingle<Service>>(app: Application<Services>, servicePath: Path, options?: ChunkFindOptions<P>): AsyncGenerator<Item[], void, unknown>;
-//#endregion
 //#region src/utils/add-to-query/add-to-query.util.d.ts
 /**
  * Safely merges properties into a Feathers query object. If a property already exists
  * with a different value, it wraps both in a `$and` array to preserve both conditions.
- * If the exact same key-value pair already exists, no changes are made.
+ * If the exact same key-value pair already exists, no changes are made. When the added
+ * query is itself a pure `$and` (`{ $and: [...] }`), its branches are flattened into the
+ * target's `$and` rather than nested.
  *
  * @example
  * ```ts
@@ -143,6 +111,40 @@ declare function checkContext<H extends HookContext, const T extends HookType$1
   method: M;
 }>;
 //#endregion
+//#region src/utils/chunk-find/chunk-find.util.d.ts
+type PaginateOption$1 = {
+  default?: number;
+  max?: number;
+};
+type ChunkFindOptions<P extends Params = Params> = {
+  params?: P & {
+    paginate?: PaginateOption$1;
+  };
+};
+/**
+ * Use `for await` to iterate over chunks (pages) of results from a `find` method.
+ *
+ * This function is useful for processing large datasets in batches without loading everything into memory at once.
+ * It uses pagination to fetch results in chunks, yielding each page's data array.
+ *
+ * @example
+ * ```ts
+ * import { chunkFind } from 'feathers-utils/utils'
+ *
+ * const app = feathers()
+ *
+ * // Assuming 'users' service has many records
+ * for await (const users of chunkFind(app, 'users', {
+ *  params: { query: { active: true }, // Custom query parameters
+ * } })) {
+ *  console.log(users) // Process each chunk of user records
+ * }
+ * ```
+ *
+ * @see https://utils.feathersjs.com/utils/chunk-find.html
+ */
+declare function chunkFind<Services, Path extends KeyOf<Services>, Service extends Services[Path] = Services[Path], P extends Params = InferFindParams<Service>, Item = InferFindResultSingle<Service>>(app: Application<Services>, servicePath: Path, options?: ChunkFindOptions<P>): AsyncGenerator<Item[], void, unknown>;
+//#endregion
 //#region src/utils/context-to-json/context-to-json.util.d.ts
 /**
  * Converts a FeathersJS HookContext to a plain JSON object by calling `toJSON()` if available.
@@ -308,6 +310,61 @@ type IterateFindOptions<P extends Params = Params> = {
  */
 declare function iterateFind<Services, Path extends KeyOf<Services>, Service extends Services[Path] = Services[Path], P extends Params = InferFindParams<Service>, Item = InferFindResultSingle<Service>>(app: Application<Services>, servicePath: Path, options?: IterateFindOptions<P>): AsyncGenerator<Item, void, unknown>;
 //#endregion
+//#region src/utils/merge-query/merge-query.util.d.ts
+type MergeQueryMode = 'target' | 'source' | 'combine' | 'intersect';
+interface MergeQueryOptions {
+  /**
+   * How to merge query properties that both queries constrain.
+   *
+   * - `combine` (default): broaden — the two queries always become branches of an `$or`.
+   * - `intersect`: narrow — non-conflicting properties merge flat, conflicts become an `$and`.
+   * - `target`: keep the target's value on conflict.
+   * - `source`: keep the source's value on conflict.
+   */
+  mode?: MergeQueryMode;
+}
+/**
+ * Properties are combined with a logical operator rather than merged at the value
+ * level, so the result is always a valid query: `combine` always wraps the two
+ * queries in `$or` (broaden — OR has no flat form), while `intersect` merges
+ * non-conflicting properties flat and wraps conflicts in `$and` (narrow). The
+ * special filters `$select`, `$limit`, `$skip` and `$sort` are merged separately.
+ * Inputs are never mutated.
+ *
+ * This is well suited to merging a client-provided query with a server-side
+ * restriction inside a hook.
+ *
+ * @param target Query to be merged into
+ * @param source Query to be merged from
+ * @param options
+ * @returns the merged query
+ *
+ * @example
+ * ```ts
+ * import { mergeQuery } from 'feathers-utils/utils'
+ *
+ * // combine (default): the two queries always become an $or
+ * mergeQuery({ id: 1 }, { id: 2 })
+ * // => { $or: [{ id: 1 }, { id: 2 }] }
+ *
+ * mergeQuery({ status: 'active' }, { authorId: 5 })
+ * // => { $or: [{ status: 'active' }, { authorId: 5 }] }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // intersect: non-conflicting properties merge flat, conflicts become an $and
+ * mergeQuery({ status: 'active' }, { authorId: 5 }, { mode: 'intersect' })
+ * // => { status: 'active', authorId: 5 }
+ *
+ * mergeQuery({ id: 1 }, { id: 2 }, { mode: 'intersect' })
+ * // => { $and: [{ id: 1 }, { id: 2 }] }
+ * ```
+ *
+ * @see https://utils.feathersjs.com/utils/merge-query.html
+ */
+declare function mergeQuery(target: Query, source: Query, options?: MergeQueryOptions): Query;
+//#endregion
 //#region src/utils/patch-batch/patch-batch.util.d.ts
 type PatchBatchOptions<IdKey extends string> = {
   /** the key of the id property */id?: IdKey;
@@ -340,6 +397,48 @@ type PatchBatchResultItem<T = Record<string, unknown>, P = Params> = [Id | null,
  */
 declare function patchBatch<T extends Record<string, any>, IdKey extends KeyOf<T>, P extends Params, R extends Omit<T, IdKey> = Omit<T, IdKey>>(items: T[], options?: PatchBatchOptions<IdKey>): PatchBatchResultItem<R, P>[];
 //#endregion
+//#region src/utils/query-defaults/query-defaults.util.d.ts
+/**
+ * Adds default properties to a Feathers query — but only for fields the query does
+ * not already constrain. Presence is checked with {@link queryHasProperty}, so a field
+ * referenced anywhere (including nested in `$and`/`$or`/`$nor`) is left untouched and
+ * the caller keeps control over it. The query is treated as the `data` equivalent of
+ * the `defaults` transformer. Each default is applied independently (per-field).
+ *
+ * @example
+ * ```ts
+ * import { queryDefaults } from 'feathers-utils/utils'
+ *
+ * queryDefaults({ status: 'active' }, { isTemplate: false })
+ * // => { status: 'active', isTemplate: false }
+ *
+ * queryDefaults({ $or: [{ isTemplate: true }] }, { isTemplate: false })
+ * // => { $or: [{ isTemplate: true }] } (untouched — already referenced)
+ * ```
+ *
+ * @see https://utils.feathersjs.com/utils/query-defaults.html
+ */
+declare const queryDefaults: (query: Query | undefined, defaults: Query) => Query;
+//#endregion
+//#region src/utils/query-has-property/query-has-property.util.d.ts
+/**
+ * Checks whether a Feathers query contains one or more properties — including
+ * properties nested inside `$and`/`$or`/`$nor` arrays. Returns `true` as soon as
+ * any of the given property names is found. The query is not mutated.
+ *
+ * @example
+ * ```ts
+ * import { queryHasProperty } from 'feathers-utils/utils'
+ *
+ * queryHasProperty({ isTemplate: true }, 'isTemplate') // true
+ * queryHasProperty({ $or: [{ isTemplate: true }] }, 'isTemplate') // true
+ * queryHasProperty({ age: { $gt: 18 } }, ['isTemplate', 'status']) // false
+ * ```
+ *
+ * @see https://utils.feathersjs.com/utils/query-has-property.html
+ */
+declare const queryHasProperty: (query: Query, property: MaybeArray<string>) => boolean;
+//#endregion
 //#region src/utils/replace-data/replace-data.util.d.ts
 /**
  * Replaces `context.data` wholesale with the given items, preserving the original
@@ -403,6 +502,32 @@ declare function replaceResult<H extends HookContext = HookContext>(context: H,
  */
 declare const skipResult: <H extends HookContext = HookContext>(context: H) => H;
 //#endregion
+//#region src/utils/sort-query-properties/sort-query-properties.util.d.ts
+/**
+ * Recursively normalizes a Feathers query object for order-independent comparison.
+ * Sorts object keys and sorts arrays within `$or`, `$and`, `$nor`, `$not`, `$in`,
+ * and `$nin` operators so that different orderings produce the same result.
+ *
+ * This is useful for generating stable cache keys where
+ * `{ $or: [{ a: 1 }, { b: 2 }] }` and `{ $or: [{ b: 2 }, { a: 1 }] }`
+ * should be treated as equivalent.
+ *
+ * @example
+ * ```ts
+ * import { sortQueryProperties } from 'feathers-utils/utils'
+ *
+ * const normalized = sortQueryProperties({
+ *   $or: [{ name: 'Jane' }, { name: 'John' }],
+ *   age: { $in: [30, 25] },
+ * })
+ * // => { $or: [{ name: 'John' }, { name: 'Jane' }], age: { $in: [25, 30] } }
+ * // (sorted by stable stringify comparison)
+ * ```
+ *
+ * @see https://utils.feathersjs.com/utils/sort-query-properties.html
+ */
+declare const sortQueryProperties: <Q extends Query>(query: Q) => Q;
+//#endregion
 //#region src/utils/to-paginated/to-paginated.util.d.ts
 /**
  * Ensures a result is in Feathers paginated format (`{ total, limit, skip, data }`).
@@ -438,32 +563,6 @@ declare function toPaginated<R>(result: R[] | Paginated<R>): Paginated<R>;
  */
 declare const transformParams: <P extends Params = Params>(params: P, fn: TransformParamsFn<P> | undefined) => P;
 //#endregion
-//#region src/utils/sort-query-properties/sort-query-properties.util.d.ts
-/**
- * Recursively normalizes a Feathers query object for order-independent comparison.
- * Sorts object keys and sorts arrays within `$or`, `$and`, `$nor`, `$not`, `$in`,
- * and `$nin` operators so that different orderings produce the same result.
- *
- * This is useful for generating stable cache keys where
- * `{ $or: [{ a: 1 }, { b: 2 }] }` and `{ $or: [{ b: 2 }, { a: 1 }] }`
- * should be treated as equivalent.
- *
- * @example
- * ```ts
- * import { sortQueryProperties } from 'feathers-utils/utils'
- *
- * const normalized = sortQueryProperties({
- *   $or: [{ name: 'Jane' }, { name: 'John' }],
- *   age: { $in: [30, 25] },
- * })
- * // => { $or: [{ name: 'John' }, { name: 'Jane' }], age: { $in: [25, 30] } }
- * // (sorted by stable stringify comparison)
- * ```
- *
- * @see https://utils.feathersjs.com/utils/sort-query-properties.html
- */
-declare const sortQueryProperties: <Q extends Query>(query: Q) => Q;
-//#endregion
 //#region src/utils/wait-for-service-event/wait-for-service-event.util.d.ts
 /**
  * The standard Feathers service events, plus any custom event name a service
@@ -578,48 +677,6 @@ type WalkQueryCallback = (options: WalkQueryOptions) => any;
  */
 declare const walkQuery: <Q extends Query>(query: Q, walker: WalkQueryCallback) => Q;
 //#endregion
-//#region src/utils/query-has-property/query-has-property.util.d.ts
-/**
- * Checks whether a Feathers query contains one or more properties — including
- * properties nested inside `$and`/`$or`/`$nor` arrays. Returns `true` as soon as
- * any of the given property names is found. The query is not mutated.
- *
- * @example
- * ```ts
- * import { queryHasProperty } from 'feathers-utils/utils'
- *
- * queryHasProperty({ isTemplate: true }, 'isTemplate') // true
- * queryHasProperty({ $or: [{ isTemplate: true }] }, 'isTemplate') // true
- * queryHasProperty({ age: { $gt: 18 } }, ['isTemplate', 'status']) // false
- * ```
- *
- * @see https://utils.feathersjs.com/utils/query-has-property.html
- */
-declare const queryHasProperty: (query: Query, property: MaybeArray<string>) => boolean;
-//#endregion
-//#region src/utils/query-defaults/query-defaults.util.d.ts
-/**
- * Adds default properties to a Feathers query — but only for fields the query does
- * not already constrain. Presence is checked with {@link queryHasProperty}, so a field
- * referenced anywhere (including nested in `$and`/`$or`/`$nor`) is left untouched and
- * the caller keeps control over it. The query is treated as the `data` equivalent of
- * the `defaults` transformer. Each default is applied independently (per-field).
- *
- * @example
- * ```ts
- * import { queryDefaults } from 'feathers-utils/utils'
- *
- * queryDefaults({ status: 'active' }, { isTemplate: false })
- * // => { status: 'active', isTemplate: false }
- *
- * queryDefaults({ $or: [{ isTemplate: true }] }, { isTemplate: false })
- * // => { $or: [{ isTemplate: true }] } (untouched — already referenced)
- * ```
- *
- * @see https://utils.feathersjs.com/utils/query-defaults.html
- */
-declare const queryDefaults: (query: Query | undefined, defaults: Query) => Query;
-//#endregion
 //#region src/utils/zip-data-result/zip-data-result.util.d.ts
 type ZipDataResultOptions = {
   onMismatch?: (context: HookContext) => void;
@@ -645,5 +702,5 @@ type ZipDataResultItem<D, R> = {
  */
 declare function zipDataResult<H extends HookContext, D extends DataSingleHookContext<H> = DataSingleHookContext<H>, R extends ResultSingleHookContext<H> = ResultSingleHookContext<H>>(context: H, options?: ZipDataResultOptions): ZipDataResultItem<D, R>[];
 //#endregion
-export { GetDataIsArrayReturn as A, SkipHookName as B, patchBatch as C, getResultIsArray as D, GetResultIsArrayReturn as E, checkContext as F, IsContextOptions as I, isContext as L, defineHooks as M, contextToJson as N, getPaginate as O, CheckContextOptions as P, addToQuery as R, PatchBatchResultItem as S, GetResultIsArrayOptions as T, addSkip as V, skipResult as _, queryHasProperty as a, replaceData as b, walkQuery as c, WaitForServiceEventOptions as d, WaitForServiceEventResult as f, toPaginated as g, transformParams as h, queryDefaults as i, getDataIsArray as j, getExposedMethods as k, ServiceEventName as l, sortQueryProperties as m, ZipDataResultOptions as n, WalkQueryCallback as o, waitForServiceEvent as p, zipDataResult as r, WalkQueryOptions as s, ZipDataResultItem as t, WaitForServiceEventDefaults as u, ReplaceResultOptions as v, iterateFind as w, PatchBatchOptions as x, replaceResult as y, chunkFind as z };
-//# sourceMappingURL=index-CKAzIogj.d.mts.map
+export { getResultIsArray as A, IsContextOptions as B, patchBatch as C, iterateFind as D, mergeQuery as E, defineHooks as F, addToQuery as H, contextToJson as I, chunkFind as L, getExposedMethods as M, GetDataIsArrayReturn as N, GetResultIsArrayOptions as O, getDataIsArray as P, CheckContextOptions as R, PatchBatchResultItem as S, MergeQueryOptions as T, SkipHookName as U, isContext as V, addSkip as W, replaceResult as _, WalkQueryOptions as a, queryDefaults as b, WaitForServiceEventDefaults as c, waitForServiceEvent as d, transformParams as f, ReplaceResultOptions as g, skipResult as h, WalkQueryCallback as i, getPaginate as j, GetResultIsArrayReturn as k, WaitForServiceEventOptions as l, sortQueryProperties as m, ZipDataResultOptions as n, walkQuery as o, toPaginated as p, zipDataResult as r, ServiceEventName as s, ZipDataResultItem as t, WaitForServiceEventResult as u, replaceData as v, MergeQueryMode as w, PatchBatchOptions as x, queryHasProperty as y, checkContext as z };
+//# sourceMappingURL=index-C6MN6wag.d.mts.map

package/dist/index.d.mts

@@ -4,7 +4,7 @@ import { a as IffHook, i as skippable, n as ThrowIfOptions, o as iff, r as throw
 import { i as transformData, n as transformResult, r as transformQuery, t as TransformResultOptions } from "./transform-result.hook-C9wMLWs2.mjs";
 import { i as resolveData, n as resolveQuery, r as resolveResult, t as resolve } from "./resolve-Cmxskunj.mjs";
 import { CacheEvent, CacheOptions, CheckMultiOptions, CreateRelatedOptions, FindOrCreateOptions, HookSetDataOptions, MuteEventOptions, OnDeleteAction, OnDeleteOptions, ParamsForServerOptions, PreventChangesOptions, RateLimitOptions, SetFieldOptions, SetResultOptions, SoftDeleteOptionFunction, SoftDeleteOptions, StashableOptions, ThrowIfIsIsProviderOptions, ThrowIfIsMultiOptions, TraverseOptions, cache, checkMulti, checkRequired, combine, createRelated, debug, disablePagination, disallow, findOrCreate, muteEvent, onDelete, paramsForServer, paramsFromClient, paramsFromClientOptions, preventChanges, rateLimit, setData, setField, setQueryDefaults, setResult, setSlug, softDelete, stashable, throwIfIsMulti, throwIfIsProvider, traverse } from "./hooks.mjs";
-import { A as GetDataIsArrayReturn, B as SkipHookName, C as patchBatch, D as getResultIsArray, E as GetResultIsArrayReturn, F as checkContext, M as defineHooks, N as contextToJson, O as getPaginate, P as CheckContextOptions, R as addToQuery, S as PatchBatchResultItem, T as GetResultIsArrayOptions, V as addSkip, _ as skipResult, a as queryHasProperty, b as replaceData, c as walkQuery, d as WaitForServiceEventOptions, f as WaitForServiceEventResult, g as toPaginated, h as transformParams, i as queryDefaults, j as getDataIsArray, k as getExposedMethods, l as ServiceEventName, m as sortQueryProperties, n as ZipDataResultOptions, o as WalkQueryCallback, p as waitForServiceEvent, r as zipDataResult, s as WalkQueryOptions, t as ZipDataResultItem, u as WaitForServiceEventDefaults, v as ReplaceResultOptions, w as iterateFind, x as PatchBatchOptions, y as replaceResult, z as chunkFind } from "./index-CKAzIogj.mjs";
+import { A as getResultIsArray, C as patchBatch, D as iterateFind, E as mergeQuery, F as defineHooks, H as addToQuery, I as contextToJson, L as chunkFind, M as getExposedMethods, N as GetDataIsArrayReturn, O as GetResultIsArrayOptions, P as getDataIsArray, R as CheckContextOptions, S as PatchBatchResultItem, T as MergeQueryOptions, U as SkipHookName, W as addSkip, _ as replaceResult, a as WalkQueryOptions, b as queryDefaults, c as WaitForServiceEventDefaults, d as waitForServiceEvent, f as transformParams, g as ReplaceResultOptions, h as skipResult, i as WalkQueryCallback, j as getPaginate, k as GetResultIsArrayReturn, l as WaitForServiceEventOptions, m as sortQueryProperties, n as ZipDataResultOptions, o as walkQuery, p as toPaginated, r as zipDataResult, s as ServiceEventName, t as ZipDataResultItem, u as WaitForServiceEventResult, v as replaceData, w as MergeQueryMode, x as PatchBatchOptions, y as queryHasProperty, z as checkContext } from "./index-C6MN6wag.mjs";
 import { n as mutateResult, r as mutateData, t as MutateResultOptions } from "./mutate-result.util-DR9JMsvl.mjs";
 import { Paginated, PaginationOptions } from "@feathersjs/feathers";
 
@@ -15,5 +15,5 @@ type PaginatedOrArray<R, P = undefined> = P extends {
   paginate: PaginationOptions;
 } ? Paginated<R> : Paginated<R> | R[];
 //#endregion
-export { CacheEvent, CacheOptions, CheckContextOptions, CheckMultiOptions, ContextFunction, ContextFunctionAsync, ContextFunctionSync, CreateRelatedOptions, DataSingleHookContext, DefaultsInput, DispatchOption, FieldKey, FindOrCreateOptions, GetDataIsArrayReturn, GetResultIsArrayOptions, GetResultIsArrayReturn, GetService, HookFunction, HookSetDataOptions, HookType, IffHook, InferCreateData, InferCreateDataFromPath, InferCreateDataSingle, InferCreateDataSingleFromPath, InferCreateResult, InferCreateResultFromPath, InferCreateResultSingle, InferCreateResultSingleFromPath, InferDataFromPath, InferFindParams, InferFindResult, InferFindResultFromPath, InferFindResultSingle, InferGetResult, InferGetResultFromPath, InferPatchData, InferPatchDataFromPath, InferPatchResult, InferPatchResultFromPath, InferRemoveResult, InferRemoveResultFromPath, InferResultFromPath, InferUpdateData, InferUpdateDataFromPath, InferUpdateResult, InferUpdateResultFromPath, MethodName, MutateResultOptions, MuteEventOptions, OnDeleteAction, OnDeleteOptions, PaginatedOrArray, ParamsForServerOptions, PatchBatchOptions, PatchBatchResultItem, PredicateContextAsync, PredicateContextSync, PredicateFn, PredicateItemWithContext, PreventChangesOptions, RateLimitOptions, ReplaceResultOptions, ResultSingleHookContext, ServiceEventName, SetFieldOptions, SetResultOptions, SkipHookName, SoftDeleteOptionFunction, SoftDeleteOptions, StashableOptions, StringFieldKey, ThrowIfIsIsProviderOptions, ThrowIfIsMultiOptions, ThrowIfOptions, TransformParamsFn, TransformResultOptions, TransformerFn, TransformerInputFn, TransportName, TraverseOptions, UnwrapPaginated, UnwrapPaginatedOrArray, WaitForServiceEventDefaults, WaitForServiceEventOptions, WaitForServiceEventResult, WalkQueryCallback, WalkQueryOptions, ZipDataResultItem, ZipDataResultOptions, addSkip, addToQuery, cache, checkContext, checkMulti, checkRequired, chunkFind, combine, contextToJson, createRelated, debug, defineHooks, disablePagination, disallow, findOrCreate, getDataIsArray, getExposedMethods, getPaginate, getResultIsArray, hookTypes, iff, iff as when, iffElse, iterateFind, methodNames, mutateData, mutateResult, muteEvent, onDelete, paramsForServer, paramsFromClient, paramsFromClientOptions, patchBatch, preventChanges, queryDefaults, queryHasProperty, rateLimit, replaceData, replaceResult, resolve, resolveData, resolveQuery, resolveResult, setData, setField, setQueryDefaults, setResult, setSlug, skipResult, skippable, softDelete, sortQueryProperties, stashable, throwIf, throwIfIsMulti, throwIfIsProvider, toPaginated, transformData, transformParams, transformQuery, transformResult, traverse, unless, waitForServiceEvent, walkQuery, zipDataResult };
+export { CacheEvent, CacheOptions, CheckContextOptions, CheckMultiOptions, ContextFunction, ContextFunctionAsync, ContextFunctionSync, CreateRelatedOptions, DataSingleHookContext, DefaultsInput, DispatchOption, FieldKey, FindOrCreateOptions, GetDataIsArrayReturn, GetResultIsArrayOptions, GetResultIsArrayReturn, GetService, HookFunction, HookSetDataOptions, HookType, IffHook, InferCreateData, InferCreateDataFromPath, InferCreateDataSingle, InferCreateDataSingleFromPath, InferCreateResult, InferCreateResultFromPath, InferCreateResultSingle, InferCreateResultSingleFromPath, InferDataFromPath, InferFindParams, InferFindResult, InferFindResultFromPath, InferFindResultSingle, InferGetResult, InferGetResultFromPath, InferPatchData, InferPatchDataFromPath, InferPatchResult, InferPatchResultFromPath, InferRemoveResult, InferRemoveResultFromPath, InferResultFromPath, InferUpdateData, InferUpdateDataFromPath, InferUpdateResult, InferUpdateResultFromPath, MergeQueryMode, MergeQueryOptions, MethodName, MutateResultOptions, MuteEventOptions, OnDeleteAction, OnDeleteOptions, PaginatedOrArray, ParamsForServerOptions, PatchBatchOptions, PatchBatchResultItem, PredicateContextAsync, PredicateContextSync, PredicateFn, PredicateItemWithContext, PreventChangesOptions, RateLimitOptions, ReplaceResultOptions, ResultSingleHookContext, ServiceEventName, SetFieldOptions, SetResultOptions, SkipHookName, SoftDeleteOptionFunction, SoftDeleteOptions, StashableOptions, StringFieldKey, ThrowIfIsIsProviderOptions, ThrowIfIsMultiOptions, ThrowIfOptions, TransformParamsFn, TransformResultOptions, TransformerFn, TransformerInputFn, TransportName, TraverseOptions, UnwrapPaginated, UnwrapPaginatedOrArray, WaitForServiceEventDefaults, WaitForServiceEventOptions, WaitForServiceEventResult, WalkQueryCallback, WalkQueryOptions, ZipDataResultItem, ZipDataResultOptions, addSkip, addToQuery, cache, checkContext, checkMulti, checkRequired, chunkFind, combine, contextToJson, createRelated, debug, defineHooks, disablePagination, disallow, findOrCreate, getDataIsArray, getExposedMethods, getPaginate, getResultIsArray, hookTypes, iff, iff as when, iffElse, iterateFind, mergeQuery, methodNames, mutateData, mutateResult, muteEvent, onDelete, paramsForServer, paramsFromClient, paramsFromClientOptions, patchBatch, preventChanges, queryDefaults, queryHasProperty, rateLimit, replaceData, replaceResult, resolve, resolveData, resolveQuery, resolveResult, setData, setField, setQueryDefaults, setResult, setSlug, skipResult, skippable, softDelete, sortQueryProperties, stashable, throwIf, throwIfIsMulti, throwIfIsProvider, toPaginated, transformData, transformParams, transformQuery, transformResult, traverse, unless, waitForServiceEvent, walkQuery, zipDataResult };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import { _ as combine, a as iffElse, f as getPaginate, i as iff, n as skippable, r as unless, t as throwIf } from "./predicates-puYa4nkf.mjs";
-import { _ as addSkip, a as waitForServiceEvent, c as skipResult, d as getExposedMethods, f as defineHooks, g as chunkFind, h as addToQuery, i as walkQuery, l as patchBatch, m as checkContext, n as queryDefaults, o as transformParams, p as contextToJson, r as queryHasProperty, s as toPaginated, t as zipDataResult, u as iterateFind, v as sortQueryProperties } from "./utils-BAIcSl7u.mjs";
-import { C as checkMulti, S as checkRequired, _ as disallow, a as softDelete, b as debug, c as setQueryDefaults, d as rateLimit, f as preventChanges, g as muteEvent, h as onDelete, i as stashable, l as setField, m as paramsForServer, n as throwIfIsProvider, o as setSlug, p as paramsFromClient, r as throwIfIsMulti, s as setResult, t as traverse, u as setData, v as disablePagination, w as cache, x as createRelated, y as findOrCreate } from "./hooks-tfw03iVM.mjs";
-import { a as getResultIsArray, i as replaceData, n as replaceResult, o as getDataIsArray, r as mutateData, t as mutateResult } from "./mutate-result.util-Dqzepn1M.mjs";
-import { n as transformQuery, r as transformData, t as transformResult } from "./transform-result.hook-B65pTRJO.mjs";
-import { i as resolveData, n as resolveQuery, r as resolveResult, t as resolve } from "./resolve-B9hRleHY.mjs";
+import { _ as combine, a as iffElse, f as getPaginate, i as iff, n as throwIf, r as skippable, t as unless } from "./predicates-NOnUyMic.mjs";
+import { _ as addToQuery, a as skipResult, c as walkQuery, d as iterateFind, f as getExposedMethods, g as checkContext, h as chunkFind, i as toPaginated, l as patchBatch, m as contextToJson, n as waitForServiceEvent, o as queryDefaults, p as defineHooks, r as transformParams, s as queryHasProperty, t as zipDataResult, u as mergeQuery, v as addSkip, y as sortQueryProperties } from "./utils-DByCpAsf.mjs";
+import { C as checkMulti, S as checkRequired, _ as findOrCreate, a as softDelete, b as debug, c as setQueryDefaults, d as rateLimit, f as preventChanges, g as muteEvent, h as onDelete, i as stashable, l as setField, m as paramsForServer, n as throwIfIsProvider, o as setSlug, p as paramsFromClient, r as throwIfIsMulti, s as setResult, t as traverse, u as setData, v as disallow, w as cache, x as createRelated, y as disablePagination } from "./hooks-DpFQfcFa.mjs";
+import { a as getResultIsArray, i as replaceData, n as replaceResult, o as getDataIsArray, r as mutateData, t as mutateResult } from "./mutate-result.util-C0nY6L7i.mjs";
+import { n as transformQuery, r as transformData, t as transformResult } from "./transform-result.hook-V2QYN2K0.mjs";
+import { i as resolveData, n as resolveQuery, r as resolveResult, t as resolve } from "./resolve-BflgIVD8.mjs";
 //#region src/types.ts
 const hookTypes = [
 	"around",
@@ -20,6 +20,6 @@ const methodNames = [
 	"remove"
 ];
 //#endregion
-export { addSkip, addToQuery, cache, checkContext, checkMulti, checkRequired, chunkFind, combine, contextToJson, createRelated, debug, defineHooks, disablePagination, disallow, findOrCreate, getDataIsArray, getExposedMethods, getPaginate, getResultIsArray, hookTypes, iff, iff as when, iffElse, iterateFind, methodNames, mutateData, mutateResult, muteEvent, onDelete, paramsForServer, paramsFromClient, patchBatch, preventChanges, queryDefaults, queryHasProperty, rateLimit, replaceData, replaceResult, resolve, resolveData, resolveQuery, resolveResult, setData, setField, setQueryDefaults, setResult, setSlug, skipResult, skippable, softDelete, sortQueryProperties, stashable, throwIf, throwIfIsMulti, throwIfIsProvider, toPaginated, transformData, transformParams, transformQuery, transformResult, traverse, unless, waitForServiceEvent, walkQuery, zipDataResult };
+export { addSkip, addToQuery, cache, checkContext, checkMulti, checkRequired, chunkFind, combine, contextToJson, createRelated, debug, defineHooks, disablePagination, disallow, findOrCreate, getDataIsArray, getExposedMethods, getPaginate, getResultIsArray, hookTypes, iff, iff as when, iffElse, iterateFind, mergeQuery, methodNames, mutateData, mutateResult, muteEvent, onDelete, paramsForServer, paramsFromClient, patchBatch, preventChanges, queryDefaults, queryHasProperty, rateLimit, replaceData, replaceResult, resolve, resolveData, resolveQuery, resolveResult, setData, setField, setQueryDefaults, setResult, setSlug, skipResult, skippable, softDelete, sortQueryProperties, stashable, throwIf, throwIfIsMulti, throwIfIsProvider, toPaginated, transformData, transformParams, transformQuery, transformResult, traverse, unless, waitForServiceEvent, walkQuery, zipDataResult };
 
 //# sourceMappingURL=index.mjs.map

package/dist/{internal.utils-BMzV_-xp.mjs → internal.utils-BBB-b6Ud.mjs}

@@ -15,6 +15,20 @@ function traverse(items, converter) {
 	});
 }
 //#endregion
+//#region src/common/is-empty-object.ts
+/**
+* Returns `true` only for a plain empty object (`{}`). Arrays, `null`, primitives
+* and non-empty objects are all `false`.
+*
+* @example
+* ```ts
+* isEmptyObject({}) // => true
+* isEmptyObject({ a: 1 }) // => false
+* isEmptyObject([]) // => false
+* ```
+*/
+const isEmptyObject = (obj) => !!obj && typeof obj === "object" && !Array.isArray(obj) && Object.keys(obj).length === 0;
+//#endregion
 //#region src/common/index.ts
 /**
 * Type guard that checks if a value is a `Promise` instance.
@@ -50,6 +64,6 @@ const early = (context, next) => {
 	if (next) return next(context);
 };
 //#endregion
-export { traverse as a, isPromise as i, hasOwnProperty as n, toArray as r, early as t };
+export { isEmptyObject as a, isPromise as i, hasOwnProperty as n, traverse as o, toArray as r, early as t };
 
-//# sourceMappingURL=internal.utils-BMzV_-xp.mjs.map
+//# sourceMappingURL=internal.utils-BBB-b6Ud.mjs.map

package/dist/internal.utils-BBB-b6Ud.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.utils-BBB-b6Ud.mjs","names":[],"sources":["../src/common/traverse.ts","../src/common/is-empty-object.ts","../src/common/index.ts","../src/internal.utils.ts"],"sourcesContent":["import _traverse from 'neotraverse'\n\n/**\n * Recursively traverses items (or an array of items) and applies a converter function\n * to every node using `neotraverse`. Modifications happen in place.\n *\n * @example\n * ```ts\n * traverse(items, function () { if (this.key === 'secret') this.remove() })\n * ```\n */\nexport function traverse<T extends Record<string, any>>(\n  items: T | T[],\n  converter: (item: T) => void,\n) {\n  ;(Array.isArray(items) ? items : [items]).forEach((item) => {\n    _traverse(item).forEach(converter) // replacement is in place\n  })\n}\n","/**\n * Returns `true` only for a plain empty object (`{}`). Arrays, `null`, primitives\n * and non-empty objects are all `false`.\n *\n * @example\n * ```ts\n * isEmptyObject({}) // => true\n * isEmptyObject({ a: 1 }) // => false\n * isEmptyObject([]) // => false\n * ```\n */\nexport const isEmptyObject = (obj: unknown): boolean =>\n  !!obj &&\n  typeof obj === 'object' &&\n  !Array.isArray(obj) &&\n  Object.keys(obj).length === 0\n\nif (import.meta.vitest) {\n  const { describe, it, expect } = import.meta.vitest\n\n  describe('isEmptyObject', () => {\n    it('is true only for a plain empty object', () => {\n      expect(isEmptyObject({})).toBe(true)\n    })\n\n    it('is false for a non-empty object', () => {\n      expect(isEmptyObject({ a: 1 })).toBe(false)\n    })\n\n    it('is false for arrays, null, undefined and primitives', () => {\n      expect(isEmptyObject([])).toBe(false)\n      expect(isEmptyObject(null)).toBe(false)\n      expect(isEmptyObject(undefined)).toBe(false)\n      expect(isEmptyObject('')).toBe(false)\n      expect(isEmptyObject(0)).toBe(false)\n    })\n  })\n}\n","/**\n * Type guard that checks if a value is a `Promise` instance.\n *\n * @example\n * ```ts\n * const result = maybeSyncFn()\n * if (isPromise(result)) {\n *   await result\n * }\n * ```\n */\nexport function isPromise(p: any): p is Promise<any> {\n  return p instanceof Promise\n}\n\nexport { traverse } from './traverse.js'\nexport { clone } from './clone.js'\nexport { isEmptyObject } from './is-empty-object.js'\n","import type { HookContext } from '@feathersjs/feathers'\n\nexport 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 | readonly T[]\nexport type UnpackMaybeArray<T> = T extends readonly (infer E)[] ? E : T\n/**\n * Normalizes a value or array into an array. The returned array MUST be treated\n * as read-only — when the input is already an array it is returned as-is (no copy)\n * to avoid a per-call allocation on hook hot paths.\n */\nexport const toArray = <T>(value: T | readonly T[]): T[] =>\n  Array.isArray(value) ? (value as T[]) : [value as T]\n\nexport type Promisable<T> = T | Promise<T>\nexport type KeyOf<T> = Extract<keyof T, string>\n\nexport type UnwrapArray<T> = T extends Array<infer U> ? U : T\n\nexport type IsAny<T> = 0 extends 1 & T ? true : false\n\nexport type AnyFallback<T, Fallback> = IsAny<T> extends true ? Fallback : T\n\nexport type NeverFallback<Never, Fallback> = [Never] extends [never]\n  ? Fallback\n  : Never\n\nexport type KeyOfOrDotNotation<D> = KeyOf<D> | `${KeyOf<D>}.${string}`\n\n/**+\n * Can be used to early return a hook.\n *\n * If it's an around hook, it will call `next` if provided.\n */\nexport const early = <H extends HookContext>(\n  context: H,\n  next?: (context: H) => Promisable<void>,\n): Promisable<void> => {\n  if (next) {\n    return next(context)\n  }\n  return\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,SACd,OACA,WACA;CACC,CAAC,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAA,CAAG,SAAS,SAAS;EAC1D,UAAU,IAAI,CAAC,CAAC,QAAQ,SAAS;CACnC,CAAC;AACH;;;;;;;;;;;;;;ACPA,MAAa,iBAAiB,QAC5B,CAAC,CAAC,OACF,OAAO,QAAQ,YACf,CAAC,MAAM,QAAQ,GAAG,KAClB,OAAO,KAAK,GAAG,CAAC,CAAC,WAAW;;;;;;;;;;;;;;ACJ9B,SAAgB,UAAU,GAA2B;CACnD,OAAO,aAAa;AACtB;;;ACXA,MAAa,kBACX,KACA,GAAG,SACS;CACZ,OAAO,KAAK,MAAM,MAAM,OAAO,UAAU,eAAe,KAAK,KAAK,CAAC,CAAC;AACtE;;;;;;AASA,MAAa,WAAc,UACzB,MAAM,QAAQ,KAAK,IAAK,QAAgB,CAAC,KAAU;;;;;;AAsBrD,MAAa,SACX,SACA,SACqB;CACrB,IAAI,MACF,OAAO,KAAK,OAAO;AAGvB"}

package/dist/{mutate-result.util-Dqzepn1M.mjs → mutate-result.util-C0nY6L7i.mjs}

@@ -1,4 +1,4 @@
-import { i as isPromise } from "./internal.utils-BMzV_-xp.mjs";
+import { i as isPromise } from "./internal.utils-BBB-b6Ud.mjs";
 import { copy } from "fast-copy";
 //#region src/utils/get-data-is-array/get-data-is-array.util.ts
 /**
@@ -220,4 +220,4 @@ function mutateResult(context, transformer, options) {
 //#endregion
 export { getResultIsArray as a, replaceData as i, replaceResult as n, getDataIsArray as o, mutateData as r, mutateResult as t };
 
-//# sourceMappingURL=mutate-result.util-Dqzepn1M.mjs.map
+//# sourceMappingURL=mutate-result.util-C0nY6L7i.mjs.map

package/dist/{mutate-result.util-Dqzepn1M.mjs.map → mutate-result.util-C0nY6L7i.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"mutate-result.util-Dqzepn1M.mjs","names":[],"sources":["../src/utils/get-data-is-array/get-data-is-array.util.ts","../src/utils/get-result-is-array/get-result-is-array.util.ts","../src/utils/replace-data/replace-data.util.ts","../src/utils/mutate-data/mutate-data.util.ts","../src/utils/replace-result/replace-result.util.ts","../src/utils/mutate-result/mutate-result.util.ts"],"sourcesContent":["import type { HookContext } from '@feathersjs/feathers'\nimport type { DataSingleHookContext } from '../../utility-types/hook-context.js'\n\nexport type GetDataIsArrayReturn<H extends HookContext = HookContext> = {\n  isArray: boolean\n  data: DataSingleHookContext<H>[]\n}\n\n/**\n * Normalizes `context.data` into an array for uniform processing.\n * Returns `{ data, isArray }` where `data` is always an array and `isArray` indicates\n * whether the original value was already an array.\n *\n * @example\n * ```ts\n * import { getDataIsArray } from 'feathers-utils/utils'\n *\n * const { data, isArray } = getDataIsArray(context)\n * data.forEach(item => { /* process each item *\\/ })\n * ```\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): GetDataIsArrayReturn<H> {\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 { HookContext } from '@feathersjs/feathers'\nimport { copy } from 'fast-copy'\nimport type { ResultSingleHookContext } from '../../utility-types/hook-context.js'\n\nexport type GetResultIsArrayOptions = {\n  dispatch?: boolean\n}\n\nexport type GetResultIsArrayReturn<H extends HookContext = HookContext> = {\n  isArray: boolean\n  result: ResultSingleHookContext<H>[]\n  key: 'dispatch' | 'result'\n}\n\n/**\n * Normalizes `context.result` (or `context.dispatch`) into an array for uniform processing.\n * Handles paginated results by extracting the `data` array. Returns `{ result, isArray, key }`\n * where `key` indicates whether `'result'` or `'dispatch'` was used.\n *\n * @example\n * ```ts\n * import { getResultIsArray } from 'feathers-utils/utils'\n *\n * const { result, isArray } = getResultIsArray(context)\n * result.forEach(item => { /* process each item *\\/ })\n * ```\n *\n * @see https://utils.feathersjs.com/utils/get-result-is-array.html\n */\nexport function getResultIsArray<H extends HookContext = HookContext>(\n  context: H,\n  options?: GetResultIsArrayOptions,\n): GetResultIsArrayReturn<H> {\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 { HookContext } from \"@feathersjs/feathers\";\nimport type { DataSingleHookContext } from \"../../utility-types/hook-context.js\";\n\n/**\n * Replaces `context.data` wholesale with the given items, preserving the original\n * single-vs-array shape. This is the explicit inverse of `getDataIsArray`: get the\n * data as an array, modify or replace the items, then write them back.\n *\n * @example\n * ```ts\n * import { getDataIsArray, replaceData } from 'feathers-utils/utils'\n *\n * const { data } = getDataIsArray(context)\n * const next = data.map((item) => ({ ...item, slug: slugify(item.name) }))\n * replaceData(context, next)\n * ```\n *\n * @see https://utils.feathersjs.com/utils/replace-data.html\n */\nexport function replaceData<H extends HookContext = HookContext>(\n  context: H,\n  data: DataSingleHookContext<H>[],\n): H {\n  context.data = Array.isArray(context.data) ? data : data[0];\n  return context;\n}\n","import type { HookContext } from '@feathersjs/feathers'\nimport { getDataIsArray } from '../get-data-is-array/get-data-is-array.util.js'\nimport { replaceData } from '../replace-data/replace-data.util.js'\nimport { isPromise } from '../../common/index.js'\nimport type { Promisable } from '../../internal.utils.js'\nimport type { TransformerInputFn } from '../../types.js'\n\n/**\n * Applies a transformer function to each item in `context.data`, updating it in place.\n * If the transformer returns a new object, it replaces the original item.\n * Correctly handles both single-item and array data, preserving the original shape.\n *\n * @example\n * ```ts\n * import { mutateData } from 'feathers-utils/utils'\n *\n * await mutateData(context, (item) => { item.name = item.name.trim() })\n * ```\n *\n * @see https://utils.feathersjs.com/utils/mutate-data.html\n */\nexport function mutateData<H extends HookContext = HookContext>(\n  context: H,\n  transformer: TransformerInputFn<any, H>,\n): Promisable<H> {\n  if (!context.data) {\n    return context\n  }\n\n  // single-item fast path: avoid allocating a wrapper array + a mapped array\n  // for the common single create/update/patch case.\n  if (!Array.isArray(context.data)) {\n    const item = context.data\n    const result = transformer(item, { context, i: 0 })\n\n    if (isPromise(result)) {\n      return result.then((res: any) => {\n        context.data = res ?? item\n        return context\n      })\n    }\n\n    context.data = result ?? item\n    return context\n  }\n\n  const { data } = 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    // delegate the array writeback (single is handled by the fast path above)\n    return replaceData(context, data)\n  }\n\n  if (hasPromises) {\n    return Promise.all(results).then(mutate)\n  } else {\n    return mutate(results)\n  }\n}\n","import type { HookContext } from \"@feathersjs/feathers\";\nimport { copy } from \"fast-copy\";\nimport { getResultIsArray } from \"../get-result-is-array/get-result-is-array.util.js\";\nimport type { DispatchOption } from \"../../types.js\";\nimport type { ResultSingleHookContext } from \"../../utility-types/hook-context.js\";\n\nexport type ReplaceResultOptions = {\n  /**\n   * Also (or only) write to `context.dispatch`. `true` writes dispatch, `'both'`\n   * writes both `result` and `dispatch`. When dispatch is requested and not yet\n   * present, it is seeded from a clone of `context.result`.\n   */\n  dispatch?: DispatchOption;\n};\n\n/**\n * Replaces `context.result` (and/or `context.dispatch`) wholesale with the given\n * items, preserving the original shape: single item, array, or paginated `{ data }`.\n * This is the explicit inverse of `getResultIsArray`.\n *\n * @example\n * ```ts\n * import { getResultIsArray, replaceResult } from 'feathers-utils/utils'\n *\n * const { result } = getResultIsArray(context)\n * replaceResult(context, result.filter((item) => item.public))\n * ```\n *\n * @see https://utils.feathersjs.com/utils/replace-result.html\n */\nexport function replaceResult<H extends HookContext = HookContext>(\n  context: H,\n  result: ResultSingleHookContext<H>[],\n  options?: ReplaceResultOptions,\n): H {\n  if (!!options?.dispatch && !context.dispatch) {\n    context.dispatch = copy(context.result);\n  }\n\n  const write = (dispatch: boolean) => {\n    const { isArray, key } = getResultIsArray(context, { dispatch });\n\n    if (!isArray) {\n      context[key] = result[0];\n    } else if (!Array.isArray(context[key]) && context[key]?.data) {\n      context[key].data = result;\n    } else {\n      context[key] = result;\n    }\n  };\n\n  if (options?.dispatch === \"both\") {\n    write(true);\n    write(false);\n  } else {\n    write(!!options?.dispatch);\n  }\n\n  return context;\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { getResultIsArray } from '../get-result-is-array/get-result-is-array.util.js'\nimport { replaceResult } from '../replace-result/replace-result.util.js'\nimport { isPromise } from '../../common/index.js'\nimport { copy } from 'fast-copy'\nimport type { Promisable } from '../../internal.utils.js'\nimport type { DispatchOption, TransformerInputFn } from '../../types.js'\n\nexport type MutateResultOptions = {\n  next?: NextFunction\n  transform?: (items: any[]) => any[]\n  dispatch?: DispatchOption\n}\n\n/**\n * Applies a transformer function to each item in `context.result` (and optionally `context.dispatch`).\n * Handles paginated results, single items, and arrays transparently.\n * Use the `dispatch` option to control whether result, dispatch, or both are transformed.\n *\n * @example\n * ```ts\n * import { mutateResult } from 'feathers-utils/utils'\n *\n * await mutateResult(context, (item) => { delete item.password })\n * ```\n *\n * @see https://utils.feathersjs.com/utils/mutate-result.html\n */\nexport function mutateResult<H extends HookContext = HookContext>(\n  context: H,\n  transformer: TransformerInputFn<any, H>,\n  options?: MutateResultOptions,\n): Promisable<H> {\n  if (!!options?.dispatch && !context.dispatch) {\n    context.dispatch = copy(context.result)\n  }\n\n  function forResult(dispatch: boolean): Promisable<H> {\n    const { result } = 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      // delegate the single/array/paginated writeback to replaceResult\n      return replaceResult(context, r, { dispatch })\n    }\n\n    if (hasPromises) {\n      return Promise.all(results).then(mutate)\n    } else {\n      return mutate(results)\n    }\n  }\n\n  function run(): Promisable<H> {\n    if (options?.dispatch === 'both') {\n      const a = forResult(true)\n      const b = forResult(false)\n\n      if (isPromise(a) || isPromise(b)) {\n        return Promise.all([a, b]).then(() => context)\n      }\n\n      return context\n    }\n\n    return forResult(options?.dispatch ?? false)\n  }\n\n  if (options?.next) {\n    return options.next().then(run)\n  }\n\n  return run()\n}\n"],"mappings":"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"}
+{"version":3,"file":"mutate-result.util-C0nY6L7i.mjs","names":[],"sources":["../src/utils/get-data-is-array/get-data-is-array.util.ts","../src/utils/get-result-is-array/get-result-is-array.util.ts","../src/utils/replace-data/replace-data.util.ts","../src/utils/mutate-data/mutate-data.util.ts","../src/utils/replace-result/replace-result.util.ts","../src/utils/mutate-result/mutate-result.util.ts"],"sourcesContent":["import type { HookContext } from '@feathersjs/feathers'\nimport type { DataSingleHookContext } from '../../utility-types/hook-context.js'\n\nexport type GetDataIsArrayReturn<H extends HookContext = HookContext> = {\n  isArray: boolean\n  data: DataSingleHookContext<H>[]\n}\n\n/**\n * Normalizes `context.data` into an array for uniform processing.\n * Returns `{ data, isArray }` where `data` is always an array and `isArray` indicates\n * whether the original value was already an array.\n *\n * @example\n * ```ts\n * import { getDataIsArray } from 'feathers-utils/utils'\n *\n * const { data, isArray } = getDataIsArray(context)\n * data.forEach(item => { /* process each item *\\/ })\n * ```\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): GetDataIsArrayReturn<H> {\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 { HookContext } from '@feathersjs/feathers'\nimport { copy } from 'fast-copy'\nimport type { ResultSingleHookContext } from '../../utility-types/hook-context.js'\n\nexport type GetResultIsArrayOptions = {\n  dispatch?: boolean\n}\n\nexport type GetResultIsArrayReturn<H extends HookContext = HookContext> = {\n  isArray: boolean\n  result: ResultSingleHookContext<H>[]\n  key: 'dispatch' | 'result'\n}\n\n/**\n * Normalizes `context.result` (or `context.dispatch`) into an array for uniform processing.\n * Handles paginated results by extracting the `data` array. Returns `{ result, isArray, key }`\n * where `key` indicates whether `'result'` or `'dispatch'` was used.\n *\n * @example\n * ```ts\n * import { getResultIsArray } from 'feathers-utils/utils'\n *\n * const { result, isArray } = getResultIsArray(context)\n * result.forEach(item => { /* process each item *\\/ })\n * ```\n *\n * @see https://utils.feathersjs.com/utils/get-result-is-array.html\n */\nexport function getResultIsArray<H extends HookContext = HookContext>(\n  context: H,\n  options?: GetResultIsArrayOptions,\n): GetResultIsArrayReturn<H> {\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 { HookContext } from \"@feathersjs/feathers\";\nimport type { DataSingleHookContext } from \"../../utility-types/hook-context.js\";\n\n/**\n * Replaces `context.data` wholesale with the given items, preserving the original\n * single-vs-array shape. This is the explicit inverse of `getDataIsArray`: get the\n * data as an array, modify or replace the items, then write them back.\n *\n * @example\n * ```ts\n * import { getDataIsArray, replaceData } from 'feathers-utils/utils'\n *\n * const { data } = getDataIsArray(context)\n * const next = data.map((item) => ({ ...item, slug: slugify(item.name) }))\n * replaceData(context, next)\n * ```\n *\n * @see https://utils.feathersjs.com/utils/replace-data.html\n */\nexport function replaceData<H extends HookContext = HookContext>(\n  context: H,\n  data: DataSingleHookContext<H>[],\n): H {\n  context.data = Array.isArray(context.data) ? data : data[0];\n  return context;\n}\n","import type { HookContext } from '@feathersjs/feathers'\nimport { getDataIsArray } from '../get-data-is-array/get-data-is-array.util.js'\nimport { replaceData } from '../replace-data/replace-data.util.js'\nimport { isPromise } from '../../common/index.js'\nimport type { Promisable } from '../../internal.utils.js'\nimport type { TransformerInputFn } from '../../types.js'\n\n/**\n * Applies a transformer function to each item in `context.data`, updating it in place.\n * If the transformer returns a new object, it replaces the original item.\n * Correctly handles both single-item and array data, preserving the original shape.\n *\n * @example\n * ```ts\n * import { mutateData } from 'feathers-utils/utils'\n *\n * await mutateData(context, (item) => { item.name = item.name.trim() })\n * ```\n *\n * @see https://utils.feathersjs.com/utils/mutate-data.html\n */\nexport function mutateData<H extends HookContext = HookContext>(\n  context: H,\n  transformer: TransformerInputFn<any, H>,\n): Promisable<H> {\n  if (!context.data) {\n    return context\n  }\n\n  // single-item fast path: avoid allocating a wrapper array + a mapped array\n  // for the common single create/update/patch case.\n  if (!Array.isArray(context.data)) {\n    const item = context.data\n    const result = transformer(item, { context, i: 0 })\n\n    if (isPromise(result)) {\n      return result.then((res: any) => {\n        context.data = res ?? item\n        return context\n      })\n    }\n\n    context.data = result ?? item\n    return context\n  }\n\n  const { data } = 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    // delegate the array writeback (single is handled by the fast path above)\n    return replaceData(context, data)\n  }\n\n  if (hasPromises) {\n    return Promise.all(results).then(mutate)\n  } else {\n    return mutate(results)\n  }\n}\n","import type { HookContext } from \"@feathersjs/feathers\";\nimport { copy } from \"fast-copy\";\nimport { getResultIsArray } from \"../get-result-is-array/get-result-is-array.util.js\";\nimport type { DispatchOption } from \"../../types.js\";\nimport type { ResultSingleHookContext } from \"../../utility-types/hook-context.js\";\n\nexport type ReplaceResultOptions = {\n  /**\n   * Also (or only) write to `context.dispatch`. `true` writes dispatch, `'both'`\n   * writes both `result` and `dispatch`. When dispatch is requested and not yet\n   * present, it is seeded from a clone of `context.result`.\n   */\n  dispatch?: DispatchOption;\n};\n\n/**\n * Replaces `context.result` (and/or `context.dispatch`) wholesale with the given\n * items, preserving the original shape: single item, array, or paginated `{ data }`.\n * This is the explicit inverse of `getResultIsArray`.\n *\n * @example\n * ```ts\n * import { getResultIsArray, replaceResult } from 'feathers-utils/utils'\n *\n * const { result } = getResultIsArray(context)\n * replaceResult(context, result.filter((item) => item.public))\n * ```\n *\n * @see https://utils.feathersjs.com/utils/replace-result.html\n */\nexport function replaceResult<H extends HookContext = HookContext>(\n  context: H,\n  result: ResultSingleHookContext<H>[],\n  options?: ReplaceResultOptions,\n): H {\n  if (!!options?.dispatch && !context.dispatch) {\n    context.dispatch = copy(context.result);\n  }\n\n  const write = (dispatch: boolean) => {\n    const { isArray, key } = getResultIsArray(context, { dispatch });\n\n    if (!isArray) {\n      context[key] = result[0];\n    } else if (!Array.isArray(context[key]) && context[key]?.data) {\n      context[key].data = result;\n    } else {\n      context[key] = result;\n    }\n  };\n\n  if (options?.dispatch === \"both\") {\n    write(true);\n    write(false);\n  } else {\n    write(!!options?.dispatch);\n  }\n\n  return context;\n}\n","import type { HookContext, NextFunction } from '@feathersjs/feathers'\nimport { getResultIsArray } from '../get-result-is-array/get-result-is-array.util.js'\nimport { replaceResult } from '../replace-result/replace-result.util.js'\nimport { isPromise } from '../../common/index.js'\nimport { copy } from 'fast-copy'\nimport type { Promisable } from '../../internal.utils.js'\nimport type { DispatchOption, TransformerInputFn } from '../../types.js'\n\nexport type MutateResultOptions = {\n  next?: NextFunction\n  transform?: (items: any[]) => any[]\n  dispatch?: DispatchOption\n}\n\n/**\n * Applies a transformer function to each item in `context.result` (and optionally `context.dispatch`).\n * Handles paginated results, single items, and arrays transparently.\n * Use the `dispatch` option to control whether result, dispatch, or both are transformed.\n *\n * @example\n * ```ts\n * import { mutateResult } from 'feathers-utils/utils'\n *\n * await mutateResult(context, (item) => { delete item.password })\n * ```\n *\n * @see https://utils.feathersjs.com/utils/mutate-result.html\n */\nexport function mutateResult<H extends HookContext = HookContext>(\n  context: H,\n  transformer: TransformerInputFn<any, H>,\n  options?: MutateResultOptions,\n): Promisable<H> {\n  if (!!options?.dispatch && !context.dispatch) {\n    context.dispatch = copy(context.result)\n  }\n\n  function forResult(dispatch: boolean): Promisable<H> {\n    const { result } = 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      // delegate the single/array/paginated writeback to replaceResult\n      return replaceResult(context, r, { dispatch })\n    }\n\n    if (hasPromises) {\n      return Promise.all(results).then(mutate)\n    } else {\n      return mutate(results)\n    }\n  }\n\n  function run(): Promisable<H> {\n    if (options?.dispatch === 'both') {\n      const a = forResult(true)\n      const b = forResult(false)\n\n      if (isPromise(a) || isPromise(b)) {\n        return Promise.all([a, b]).then(() => context)\n      }\n\n      return context\n    }\n\n    return forResult(options?.dispatch ?? false)\n  }\n\n  if (options?.next) {\n    return options.next().then(run)\n  }\n\n  return run()\n}\n"],"mappings":"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"}