feathers-utils 10.0.4 → 10.2.0

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

@@ -1,4 +1,4 @@
-import { E as KeyOf, O as MaybeArray, f as HookType$1, j as UnpackMaybeArray, l as DispatchOption, n as ResultSingleHookContext, p as MethodName, t as DataSingleHookContext, y as TransformParamsFn } from "./hook-context-BsxU1vfN.mjs";
+import { E as KeyOf, O as MaybeArray, f as HookType$1, j as UnpackMaybeArray, k as NeverFallback, l as DispatchOption, n as ResultSingleHookContext, p as MethodName, t as DataSingleHookContext, y as TransformParamsFn } from "./hook-context-BsxU1vfN.mjs";
 import { d as InferFindParams, m as InferFindResultSingle } from "./infer-service-methods-C-9x7P40.mjs";
 import { Application, HookContext, HookOptions, HookType, Id, Paginated, Params, Query, Service } from "@feathersjs/feathers";
 import { PaginationOptions as PaginationOptions$1 } from "@feathersjs/adapter-commons";
@@ -464,18 +464,93 @@ declare const transformParams: <P extends Params = Params>(params: P, fn: Transf
  */
 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
+ * might emit.
+ */
+type ServiceEventName = 'created' | 'updated' | 'patched' | 'removed' | (string & {});
+type WaitForServiceEventOptions<Result = unknown> = {
+  /**
+   * Reject after this many milliseconds. Pass `false` to wait indefinitely.
+   *
+   * @default 5000
+   */
+  timeout?: number | false;
+  /**
+   * Only resolve for events whose data passes this predicate. Receives the
+   * emitted record and the `HookContext` (the second argument Feathers emits).
+   */
+  filter?: (data: Result, context: HookContext) => boolean;
+  /**
+   * Abort waiting via an `AbortSignal`. The promise rejects with the signal's
+   * `reason` (or a generic abort error) and all listeners are detached.
+   */
+  signal?: AbortSignal;
+};
+/**
+ * Service-agnostic defaults that can be bound once when currying with the app.
+ * `filter` is intentionally omitted because it depends on the per-service
+ * record type.
+ */
+type WaitForServiceEventDefaults = Pick<WaitForServiceEventOptions, 'timeout' | 'signal'>;
+type WaitForServiceEventResult<Event extends string, Result> = [/** The emitted record. */data: Result, meta: {
+  /** The event that fired (one of the requested events). */event: Event; /** The `HookContext` Feathers emitted alongside the record. */
+  context: HookContext;
+}];
+/**
+ * Wait for a service event to fire and resolve with the emitted record. Useful
+ * in tests to await the result of an asynchronous service event, a bit like
+ * `promisify` for Feathers events.
+ *
+ * Curried: bind the `app` (and optional defaults) once, then call the returned
+ * function per service/event. Resolves with a `[data, { event, context }]`
+ * tuple: `data` is typed as the service's record type, and `event` is the union
+ * of the requested events.
+ *
+ * Feathers emits events as `emit(event, record, context)` and fires one event
+ * per record, so each resolution carries a single record and its `HookContext`.
+ *
+ * @example
+ * ```ts
+ * import { waitForServiceEvent } from 'feathers-utils/utils'
+ *
+ * const app = feathers()
+ * const waitForEvent = waitForServiceEvent(app)
+ *
+ * // Wait for the next `users` record to be created.
+ * const [user] = await waitForEvent('users', 'created')
+ *
+ * // Wait for a specific record, with a custom timeout and filter.
+ * const [data, { event }] = await waitForEvent(
+ *   'users',
+ *   ['created', 'patched'],
+ *   { filter: (user) => user.email === 'jane@example.com', timeout: 1000 },
+ * )
+ * ```
+ *
+ * @see https://utils.feathersjs.com/utils/wait-for-service-event.html
+ */
+declare function waitForServiceEvent<Services>(app: Application<Services>, defaultOptions?: WaitForServiceEventDefaults): <Path extends KeyOf<Services>, const Event extends ServiceEventName, Service extends Services[Path] = Services[Path], Result = NeverFallback<InferFindResultSingle<Service>, unknown>>(servicePath: Path, eventOrEvents: Event | Event[], options?: WaitForServiceEventOptions<Result>) => Promise<WaitForServiceEventResult<Event, Result>>;
+//#endregion
 //#region src/utils/walk-query/walk-query.util.d.ts
 type WalkQueryOptions = {
   property: string;
   operator: string | undefined;
   value: any;
   path: (string | number)[];
+  /**
+   * Stops the traversal. Any replacement value returned from the current walker
+   * call is still applied, but no further properties are visited.
+   */
+  stop: () => void;
 };
 type WalkQueryCallback = (options: WalkQueryOptions) => any;
 /**
  * Walks every property of a Feathers query (including nested `$and`/`$or`/`$nor` arrays)
  * and calls the `walker` function for each one. The walker receives the property name, operator,
- * value, and path, and can return a replacement value. Returns a new query only if changes were made.
+ * value, path, and a `stop` function, and can return a replacement value. Calling `stop()` halts
+ * the traversal early. Returns a new query only if changes were made.
  *
  * @example
  * ```ts
@@ -487,10 +562,64 @@ type WalkQueryCallback = (options: WalkQueryOptions) => any;
  * // => { age: { $gt: 18 } }
  * ```
  *
+ * @example
+ * ```ts
+ * // stop early once a property is found
+ * let found = false
+ * walkQuery(query, ({ property, stop }) => {
+ *   if (property === 'isTemplate') {
+ *     found = true
+ *     stop()
+ *   }
+ * })
+ * ```
+ *
  * @see https://utils.feathersjs.com/utils/walk-query.html
  */
 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;
@@ -516,5 +645,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 { isContext as A, GetDataIsArrayReturn as C, CheckContextOptions as D, contextToJson as E, chunkFind as M, SkipHookName as N, checkContext as O, addSkip as P, getExposedMethods as S, defineHooks as T, iterateFind as _, WalkQueryOptions as a, getResultIsArray as b, transformParams as c, ReplaceResultOptions as d, replaceResult as f, patchBatch as g, PatchBatchResultItem as h, WalkQueryCallback as i, addToQuery as j, IsContextOptions as k, toPaginated as l, PatchBatchOptions as m, ZipDataResultOptions as n, walkQuery as o, replaceData as p, zipDataResult as r, sortQueryProperties as s, ZipDataResultItem as t, skipResult as u, GetResultIsArrayOptions as v, getDataIsArray as w, getPaginate as x, GetResultIsArrayReturn as y };
-//# sourceMappingURL=index-DXXeX7lF.d.mts.map
+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

package/dist/index.d.mts

@@ -3,8 +3,8 @@ import { C as InferResultFromPath, D as InferUpdateResultFromPath, E as InferUpd
 import { a as IffHook, i as skippable, n as ThrowIfOptions, o as iff, r as throwIf, s as iffElse, t as unless } from "./unless.hook-CVw1wX_x.mjs";
 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, HookSetDataOptions, OnDeleteAction, OnDeleteOptions, ParamsForServerOptions, PreventChangesOptions, RateLimitOptions, SetFieldOptions, SetResultOptions, SoftDeleteOptionFunction, SoftDeleteOptions, StashableOptions, ThrowIfIsIsProviderOptions, ThrowIfIsMultiOptions, TraverseOptions, cache, checkMulti, checkRequired, combine, createRelated, debug, disablePagination, disallow, onDelete, paramsForServer, paramsFromClient, paramsFromClientOptions, preventChanges, rateLimit, setData, setField, setResult, setSlug, softDelete, stashable, throwIfIsMulti, throwIfIsProvider, traverse } from "./hooks.mjs";
-import { C as GetDataIsArrayReturn, D as CheckContextOptions, E as contextToJson, M as chunkFind, N as SkipHookName, O as checkContext, P as addSkip, S as getExposedMethods, T as defineHooks, _ as iterateFind, a as WalkQueryOptions, b as getResultIsArray, c as transformParams, d as ReplaceResultOptions, f as replaceResult, g as patchBatch, h as PatchBatchResultItem, i as WalkQueryCallback, j as addToQuery, l as toPaginated, m as PatchBatchOptions, n as ZipDataResultOptions, o as walkQuery, p as replaceData, r as zipDataResult, s as sortQueryProperties, t as ZipDataResultItem, u as skipResult, v as GetResultIsArrayOptions, w as getDataIsArray, x as getPaginate, y as GetResultIsArrayReturn } from "./index-DXXeX7lF.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 { 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, 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, OnDeleteAction, OnDeleteOptions, PaginatedOrArray, ParamsForServerOptions, PatchBatchOptions, PatchBatchResultItem, PredicateContextAsync, PredicateContextSync, PredicateFn, PredicateItemWithContext, PreventChangesOptions, RateLimitOptions, ReplaceResultOptions, ResultSingleHookContext, SetFieldOptions, SetResultOptions, SkipHookName, SoftDeleteOptionFunction, SoftDeleteOptions, StashableOptions, StringFieldKey, ThrowIfIsIsProviderOptions, ThrowIfIsMultiOptions, ThrowIfOptions, TransformParamsFn, TransformResultOptions, TransformerFn, TransformerInputFn, TransportName, TraverseOptions, UnwrapPaginated, UnwrapPaginatedOrArray, WalkQueryCallback, WalkQueryOptions, ZipDataResultItem, ZipDataResultOptions, addSkip, addToQuery, cache, checkContext, checkMulti, checkRequired, chunkFind, combine, contextToJson, createRelated, debug, defineHooks, disablePagination, disallow, getDataIsArray, getExposedMethods, getPaginate, getResultIsArray, hookTypes, iff, iff as when, iffElse, iterateFind, methodNames, mutateData, mutateResult, onDelete, paramsForServer, paramsFromClient, paramsFromClientOptions, patchBatch, preventChanges, rateLimit, replaceData, replaceResult, resolve, resolveData, resolveQuery, resolveResult, setData, setField, setResult, setSlug, skipResult, skippable, softDelete, sortQueryProperties, stashable, throwIf, throwIfIsMulti, throwIfIsProvider, toPaginated, transformData, transformParams, transformQuery, transformResult, traverse, unless, 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, 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 };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,6 +1,6 @@
 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 { a as skipResult, c as getExposedMethods, d as checkContext, f as addToQuery, h as sortQueryProperties, i as toPaginated, l as defineHooks, m as addSkip, n as walkQuery, o as patchBatch, p as chunkFind, r as transformParams, s as iterateFind, t as zipDataResult, u as contextToJson } from "./utils-C2GLf_mV.mjs";
-import { _ as debug, a as softDelete, b as checkMulti, c as setField, d as preventChanges, f as paramsFromClient, g as disablePagination, h as disallow, i as stashable, l as setData, m as onDelete, n as throwIfIsProvider, o as setSlug, p as paramsForServer, r as throwIfIsMulti, s as setResult, t as traverse, u as rateLimit, v as createRelated, x as cache, y as checkRequired } from "./hooks-DzXD-3FR.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";
@@ -20,6 +20,6 @@ const methodNames = [
 	"remove"
 ];
 //#endregion
-export { addSkip, addToQuery, cache, checkContext, checkMulti, checkRequired, chunkFind, combine, contextToJson, createRelated, debug, defineHooks, disablePagination, disallow, getDataIsArray, getExposedMethods, getPaginate, getResultIsArray, hookTypes, iff, iff as when, iffElse, iterateFind, methodNames, mutateData, mutateResult, onDelete, paramsForServer, paramsFromClient, patchBatch, preventChanges, rateLimit, replaceData, replaceResult, resolve, resolveData, resolveQuery, resolveResult, setData, setField, setResult, setSlug, skipResult, skippable, softDelete, sortQueryProperties, stashable, throwIf, throwIfIsMulti, throwIfIsProvider, toPaginated, transformData, transformParams, transformQuery, transformResult, traverse, unless, 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, 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/predicates.d.mts

@@ -1,6 +1,6 @@
 import { S as TransportName, g as PredicateFn } from "./hook-context-BsxU1vfN.mjs";
 import { a as IffHook, i as skippable, n as ThrowIfOptions, o as iff, r as throwIf, s as iffElse, t as unless } from "./unless.hook-CVw1wX_x.mjs";
-import { A as isContext, N as SkipHookName, k as IsContextOptions } from "./index-DXXeX7lF.mjs";
+import { B as SkipHookName, I as IsContextOptions, L as isContext } from "./index-CKAzIogj.mjs";
 import { HookContext } from "@feathersjs/feathers";
 
 //#region src/predicates/and/and.predicate.d.ts

package/dist/transformers.mjs

@@ -3,8 +3,8 @@ import { r as mutateData, t as mutateResult } from "./mutate-result.util-Dqzepn1
 import { n as transformQuery, r as transformData, t as transformResult } from "./transform-result.hook-B65pTRJO.mjs";
 import { BadRequest } from "@feathersjs/errors";
 import _get from "lodash/get.js";
-import _omit from "lodash/omit.js";
 import _set from "lodash/set.js";
+import _omit from "lodash/omit.js";
 import _pick from "lodash/pick.js";
 //#region src/transformers/defaults/defaults.transformer.ts
 /**

package/dist/{utils-C2GLf_mV.mjs → utils-BAIcSl7u.mjs}

@@ -1,3 +1,4 @@
+import { r as toArray } from "./internal.utils-BMzV_-xp.mjs";
 import { d as isPaginated, m as isContext, p as isMulti } from "./predicates-puYa4nkf.mjs";
 import { a as getResultIsArray, o as getDataIsArray } from "./mutate-result.util-Dqzepn1M.mjs";
 import { dequal } from "dequal";
@@ -452,8 +453,92 @@ const transformParams = (params, fn) => {
 	return fn({ ...params }) ?? params;
 };
 //#endregion
+//#region src/utils/wait-for-service-event/wait-for-service-event.util.ts
+/**
+* Wait for a service event to fire and resolve with the emitted record. Useful
+* in tests to await the result of an asynchronous service event, a bit like
+* `promisify` for Feathers events.
+*
+* Curried: bind the `app` (and optional defaults) once, then call the returned
+* function per service/event. Resolves with a `[data, { event, context }]`
+* tuple: `data` is typed as the service's record type, and `event` is the union
+* of the requested events.
+*
+* Feathers emits events as `emit(event, record, context)` and fires one event
+* per record, so each resolution carries a single record and its `HookContext`.
+*
+* @example
+* ```ts
+* import { waitForServiceEvent } from 'feathers-utils/utils'
+*
+* const app = feathers()
+* const waitForEvent = waitForServiceEvent(app)
+*
+* // Wait for the next `users` record to be created.
+* const [user] = await waitForEvent('users', 'created')
+*
+* // Wait for a specific record, with a custom timeout and filter.
+* const [data, { event }] = await waitForEvent(
+*   'users',
+*   ['created', 'patched'],
+*   { filter: (user) => user.email === 'jane@example.com', timeout: 1000 },
+* )
+* ```
+*
+* @see https://utils.feathersjs.com/utils/wait-for-service-event.html
+*/
+function waitForServiceEvent(app, defaultOptions) {
+	return function waitForEvent(servicePath, eventOrEvents, options) {
+		const events = Array.isArray(eventOrEvents) ? eventOrEvents : [eventOrEvents];
+		const timeout = options?.timeout ?? defaultOptions?.timeout ?? 5e3;
+		const filter = options?.filter;
+		const signal = options?.signal ?? defaultOptions?.signal;
+		const service = app.service(servicePath);
+		return new Promise((resolve, reject) => {
+			let timer;
+			const listeners = events.map((event) => {
+				const listener = (data, context) => {
+					if (filter && !filter(data, context)) return;
+					cleanup();
+					resolve([data, {
+						event,
+						context
+					}]);
+				};
+				return [event, listener];
+			});
+			const abortError = () => signal?.reason ?? /* @__PURE__ */ new Error(`Aborted waiting for event "${events.join(", ")}" on service "${String(servicePath)}"`);
+			const onAbort = () => {
+				cleanup();
+				reject(abortError());
+			};
+			function cleanup() {
+				if (timer) {
+					clearTimeout(timer);
+					timer = void 0;
+				}
+				for (const [event, listener] of listeners) service.off(event, listener);
+				signal?.removeEventListener("abort", onAbort);
+			}
+			if (signal?.aborted) {
+				reject(abortError());
+				return;
+			}
+			if (timeout !== false) timer = setTimeout(() => {
+				cleanup();
+				reject(/* @__PURE__ */ new Error(`Timeout waiting for event "${events.join(", ")}" on service "${String(servicePath)}"`));
+			}, timeout);
+			signal?.addEventListener("abort", onAbort, { once: true });
+			for (const [event, listener] of listeners) service.on(event, listener);
+		});
+	};
+}
+//#endregion
 //#region src/utils/walk-query/walk-query.util.ts
-const _walkQueryUtil = (query, walker, options) => {
+const _walkQueryUtil = (query, walker, state, options) => {
+	const stop = () => {
+		state.stopped = true;
+	};
 	let cloned = false;
 	const clonedSecond = {};
 	function set(key, value, secondKey) {
@@ -471,64 +556,75 @@ const _walkQueryUtil = (query, walker, options) => {
 		}
 		query[key] = value;
 	}
-	for (const key in query) if ((key === "$or" || key === "$and" || key === "$nor") && Array.isArray(query[key])) {
-		let array = query[key];
-		let copiedArray = false;
-		for (let i = 0, n = array.length; i < n; i++) {
-			const nestedQuery = array[i];
-			const transformed = _walkQueryUtil(nestedQuery, walker, {
-				...options,
-				path: [
-					...options?.path || [],
-					key,
-					i
-				]
-			});
-			if (transformed !== nestedQuery) {
-				if (!copiedArray) {
-					array = [...array];
-					copiedArray = true;
+	for (const key in query) {
+		if (state.stopped) break;
+		if ((key === "$or" || key === "$and" || key === "$nor") && Array.isArray(query[key])) {
+			let array = query[key];
+			let copiedArray = false;
+			for (let i = 0, n = array.length; i < n; i++) {
+				if (state.stopped) break;
+				const nestedQuery = array[i];
+				const transformed = _walkQueryUtil(nestedQuery, walker, state, {
+					...options,
+					path: [
+						...options?.path || [],
+						key,
+						i
+					]
+				});
+				if (transformed !== nestedQuery) {
+					if (!copiedArray) {
+						array = [...array];
+						copiedArray = true;
+					}
+					array[i] = transformed;
 				}
-				array[i] = transformed;
 			}
-		}
-		if (copiedArray) set(key, array);
-	} else if (typeof query[key] === "object" && query[key] !== null && !Array.isArray(query[key])) {
-		let hasOperator = false;
-		for (const operator in query[key]) if (operator.startsWith("$")) {
-			hasOperator = true;
-			const value = walker({
-				operator,
-				path: [...options?.path ?? [], key],
-				property: key,
-				value: query[key][operator]
-			});
-			if (value !== void 0 && value !== query[key][operator]) set(key, value, operator);
-		}
-		if (!hasOperator) {
+			if (copiedArray) set(key, array);
+		} else if (typeof query[key] === "object" && query[key] !== null && !Array.isArray(query[key])) {
+			let hasOperator = false;
+			for (const operator in query[key]) {
+				if (state.stopped) break;
+				if (operator.startsWith("$")) {
+					hasOperator = true;
+					const value = walker({
+						operator,
+						path: [...options?.path ?? [], key],
+						property: key,
+						value: query[key][operator],
+						stop
+					});
+					if (value !== void 0 && value !== query[key][operator]) set(key, value, operator);
+				}
+			}
+			if (!hasOperator) {
+				const value = walker({
+					operator: void 0,
+					path: [...options?.path ?? [], key],
+					property: key,
+					value: query[key],
+					stop
+				});
+				if (value !== void 0 && value !== query[key]) set(key, value);
+			}
+		} else {
 			const value = walker({
 				operator: void 0,
 				path: [...options?.path ?? [], key],
 				property: key,
-				value: query[key]
+				value: query[key],
+				stop
 			});
 			if (value !== void 0 && value !== query[key]) set(key, value);
 		}
-	} else {
-		const value = walker({
-			operator: void 0,
-			path: [...options?.path ?? [], key],
-			property: key,
-			value: query[key]
-		});
-		if (value !== void 0 && value !== query[key]) set(key, value);
 	}
 	return query;
 };
 /**
 * Walks every property of a Feathers query (including nested `$and`/`$or`/`$nor` arrays)
 * and calls the `walker` function for each one. The walker receives the property name, operator,
-* value, and path, and can return a replacement value. Returns a new query only if changes were made.
+* value, path, and a `stop` function, and can return a replacement value. Calling `stop()` halts
+* the traversal early. Returns a new query only if changes were made.
 *
 * @example
 * ```ts
@@ -540,10 +636,79 @@ const _walkQueryUtil = (query, walker, options) => {
 * // => { age: { $gt: 18 } }
 * ```
 *
+* @example
+* ```ts
+* // stop early once a property is found
+* let found = false
+* walkQuery(query, ({ property, stop }) => {
+*   if (property === 'isTemplate') {
+*     found = true
+*     stop()
+*   }
+* })
+* ```
+*
 * @see https://utils.feathersjs.com/utils/walk-query.html
 */
 const walkQuery = (query, walker) => {
-	return _walkQueryUtil(query, walker);
+	return _walkQueryUtil(query, walker, { stopped: false });
+};
+//#endregion
+//#region src/utils/query-has-property/query-has-property.util.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
+*/
+const queryHasProperty = (query, property) => {
+	const properties = new Set(toArray(property));
+	let found = false;
+	walkQuery(query, ({ property: key, stop }) => {
+		if (properties.has(key)) {
+			found = true;
+			stop();
+		}
+	});
+	return found;
+};
+//#endregion
+//#region src/utils/query-defaults/query-defaults.util.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
+*/
+const queryDefaults = (query, defaults) => {
+	const source = query ?? {};
+	const toAdd = {};
+	for (const key in defaults) if (!queryHasProperty(source, key)) toAdd[key] = defaults[key];
+	return addToQuery(source, toAdd);
 };
 //#endregion
 //#region src/utils/zip-data-result/zip-data-result.util.ts
@@ -584,6 +749,6 @@ function zipDataResult(context, options) {
 	return result;
 }
 //#endregion
-export { skipResult as a, getExposedMethods as c, checkContext as d, addToQuery as f, sortQueryProperties as h, toPaginated as i, defineHooks as l, addSkip as m, walkQuery as n, patchBatch as o, chunkFind as p, transformParams as r, iterateFind as s, zipDataResult as t, contextToJson as u };
+export { addSkip as _, waitForServiceEvent as a, skipResult as c, getExposedMethods as d, defineHooks as f, chunkFind as g, addToQuery as h, walkQuery as i, patchBatch as l, checkContext as m, queryDefaults as n, transformParams as o, contextToJson as p, queryHasProperty as r, toPaginated as s, zipDataResult as t, iterateFind as u, sortQueryProperties as v };
 
-//# sourceMappingURL=utils-C2GLf_mV.mjs.map
+//# sourceMappingURL=utils-BAIcSl7u.mjs.map