@dxos/echo-query 0.8.4-main.8360d9e660 → 0.8.4-main.8baae0fced

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4711,7 +4711,7 @@ declare namespace FastCheck_d_exports {
4711
4711
  export { Arbitrary, ArrayConstraints$1 as ArrayConstraints, AsyncCommand, AsyncPropertyHookFunction, BigIntArrayConstraints, BigIntConstraints$1 as BigIntConstraints, BigUintConstraints, CloneValue, Command, CommandsContraints, ContextValue, DateConstraints$1 as DateConstraints, DepthContext, DepthIdentifier, DepthSize, DictionaryConstraints, DomainConstraints, DoubleConstraints, EmailAddressConstraints, ExecutionStatus, ExecutionTree, FalsyContraints, FalsyValue, Float32ArrayConstraints, Float64ArrayConstraints, FloatConstraints, GeneratorValue, GlobalAsyncPropertyHookFunction, GlobalParameters, GlobalPropertyHookFunction, IAsyncProperty, IAsyncPropertyWithHooks, ICommand, IProperty, IPropertyWithHooks, IRawProperty, IntArrayConstraints, IntegerConstraints, JsonSharedConstraints, JsonValue, LetrecLooselyTypedBuilder, LetrecLooselyTypedTie, LetrecTypedBuilder, LetrecTypedTie, LetrecValue, LoremConstraints, MaybeWeightedArbitrary, Memo, MixedCaseConstraints, ModelRunAsyncSetup, ModelRunSetup, NatConstraints, ObjectConstraints, OneOfConstraints, OneOfValue, OptionConstraints, Parameters$1 as Parameters, PreconditionFailure, PropertyFailure, PropertyHookFunction, Random, RandomType, RecordConstraints, RecordValue, RunDetails, RunDetailsCommon, RunDetailsFailureInterrupted, RunDetailsFailureProperty, RunDetailsFailureTooManySkips, RunDetailsSuccess, Scheduler, SchedulerAct, SchedulerConstraints, SchedulerReportItem, SchedulerSequenceItem, ShuffledSubarrayConstraints, Size, SizeForArbitrary, SparseArrayConstraints, Stream$1 as Stream, StringConstraints$1 as StringConstraints, StringMatchingConstraints, StringSharedConstraints, SubarrayConstraints, UnicodeJsonSharedConstraints, UniqueArrayConstraints, UniqueArrayConstraintsCustomCompare, UniqueArrayConstraintsCustomCompareSelect, UniqueArrayConstraintsRecommended, UniqueArraySharedConstraints, UuidConstraints, Value$1 as Value, VerbosityLevel, WebAuthorityConstraints, WebFragmentsConstraints, WebPathConstraints, WebQueryParametersConstraints, WebSegmentConstraints, WebUrlConstraints, WeightedArbitrary, WithAsyncToStringMethod, WithCloneMethod, WithToStringMethod, __commitHash, __type, __version, anything, array, ascii, asciiString, assert, asyncDefaultReportMessage, asyncModelRun, asyncProperty, asyncStringify, asyncToStringMethod, base64, base64String, bigInt, bigInt64Array, bigIntN, bigUint, bigUint64Array, bigUintN, boolean, char, char16bits, check, clone, cloneIfNeeded, cloneMethod, commands, compareBooleanFunc, compareFunc, configureGlobal, constant, constantFrom, context, createDepthIdentifier, date, defaultReportMessage, dictionary, domain, double, emailAddress, falsy, float, float32Array, float64Array, fullUnicode, fullUnicodeString, func, gen, getDepthContextFor, hasAsyncToStringMethod, hasCloneMethod, hasToStringMethod, hash, hexa, hexaString, infiniteStream, int16Array, int32Array, int8Array, integer, ipV4, ipV4Extended, ipV6, json, jsonValue, letrec, limitShrink, lorem, mapToConstant, maxSafeInteger, maxSafeNat, memo, mixedCase, modelRun, nat, noBias, noShrink, object, oneof, option, pre, property$1 as property, readConfigureGlobal, record, resetConfigureGlobal, sample, scheduledModelRun, scheduler, schedulerFor, shuffledSubarray, sparseArray, statistics, stream, string, string16bits, stringMatching, stringOf, stringify, subarray, toStringMethod, tuple, uint16Array, uint32Array, uint8Array, uint8ClampedArray, ulid, unicode, unicodeJson, unicodeJsonValue, unicodeString, uniqueArray, uuid, uuidV, webAuthority, webFragments, webPath, webQueryParameters, webSegment, webUrl };
4712
4712
  }
4713
4713
  //#endregion
4714
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Arbitrary.d.ts
4714
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Arbitrary.d.ts
4715
4715
  /**
4716
4716
  * @category model
4717
4717
  * @since 3.10.0
@@ -4756,7 +4756,7 @@ interface DateConstraints {
4756
4756
  readonly constraints: DateConstraints$1;
4757
4757
  }
4758
4758
  //#endregion
4759
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Types.d.ts
4759
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Types.d.ts
4760
4760
  /**
4761
4761
  * A utility type that transforms a union type `T` into an intersection type.
4762
4762
  *
@@ -4851,7 +4851,7 @@ declare namespace Contravariant {
4851
4851
  */
4852
4852
  type NoExcessProperties<T$1, U$1> = T$1 & { readonly [K in Exclude<keyof U$1, keyof T$1>]: never };
4853
4853
  //#endregion
4854
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Equivalence.d.ts
4854
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Equivalence.d.ts
4855
4855
  /**
4856
4856
  * @category type class
4857
4857
  * @since 2.0.0
@@ -4860,7 +4860,7 @@ interface Equivalence<in A$1> {
4860
4860
  (self: A$1, that: A$1): boolean;
4861
4861
  }
4862
4862
  //#endregion
4863
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Hash.d.ts
4863
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Hash.d.ts
4864
4864
  /**
4865
4865
  * @since 2.0.0
4866
4866
  * @category models
@@ -4869,7 +4869,7 @@ interface Hash {
4869
4869
  [symbol](): number;
4870
4870
  }
4871
4871
  //#endregion
4872
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Equal.d.ts
4872
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Equal.d.ts
4873
4873
  /**
4874
4874
  * @since 2.0.0
4875
4875
  * @category models
@@ -4878,7 +4878,7 @@ interface Equal extends Hash {
4878
4878
  [symbol](that: Equal): boolean;
4879
4879
  }
4880
4880
  //#endregion
4881
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Pipeable.d.ts
4881
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Pipeable.d.ts
4882
4882
  /**
4883
4883
  * @since 2.0.0
4884
4884
  * @category Models
@@ -4908,7 +4908,7 @@ interface Pipeable {
4908
4908
  pipe<A$1, B$1 = never, C = never, D = never, E$1 = never, F = never, G = never, H$1 = never, I$1 = never, J = never, K$1 = never, L$1 = never, M = never, N = never, O = never, P$1 = never, Q = never, R$1 = never, S$1 = never, T$1 = never, U$1 = never>(this: A$1, ab: (_: A$1) => B$1, bc: (_: B$1) => C, cd: (_: C) => D, de: (_: D) => E$1, ef: (_: E$1) => F, fg: (_: F) => G, gh: (_: G) => H$1, hi: (_: H$1) => I$1, ij: (_: I$1) => J, jk: (_: J) => K$1, kl: (_: K$1) => L$1, lm: (_: L$1) => M, mn: (_: M) => N, no: (_: N) => O, op: (_: O) => P$1, pq: (_: P$1) => Q, qr: (_: Q) => R$1, rs: (_: R$1) => S$1, st: (_: S$1) => T$1, tu: (_: T$1) => U$1): U$1;
4909
4909
  }
4910
4910
  //#endregion
4911
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Unify.d.ts
4911
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Unify.d.ts
4912
4912
  /**
4913
4913
  * @since 2.0.0
4914
4914
  */
@@ -4937,7 +4937,7 @@ declare const ignoreSymbol: unique symbol;
4937
4937
  */
4938
4938
  type ignoreSymbol = typeof ignoreSymbol;
4939
4939
  //#endregion
4940
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Utils.d.ts
4940
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Utils.d.ts
4941
4941
  /**
4942
4942
  * @since 3.0.6
4943
4943
  */
@@ -4954,7 +4954,7 @@ declare class YieldWrap<T$1> {
4954
4954
  [YieldWrapTypeId](): T$1;
4955
4955
  }
4956
4956
  //#endregion
4957
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Option.d.ts
4957
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Option.d.ts
4958
4958
  /**
4959
4959
  * The `Option` data type represents optional values. An `Option<A>` can either
4960
4960
  * be `Some<A>`, containing a value of type `A`, or `None`, representing the
@@ -5055,7 +5055,7 @@ declare namespace Option {
5055
5055
  */
5056
5056
  interface OptionUnifyIgnore {}
5057
5057
  //#endregion
5058
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Context.d.ts
5058
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Context.d.ts
5059
5059
  /**
5060
5060
  * @since 2.0.0
5061
5061
  * @category symbol
@@ -5180,7 +5180,7 @@ interface Context$1<in Services> extends Equal, Pipeable, Inspectable {
5180
5180
  */
5181
5181
  declare const Tag$2: <const Id$1 extends string>(id: Id$1) => <Self, Shape>() => TagClass<Self, Id$1, Shape>;
5182
5182
  //#endregion
5183
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Sink.d.ts
5183
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Sink.d.ts
5184
5184
  /**
5185
5185
  * @since 2.0.0
5186
5186
  * @category symbols
@@ -5236,7 +5236,7 @@ declare namespace Sink {
5236
5236
  }
5237
5237
  }
5238
5238
  //#endregion
5239
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/STM.d.ts
5239
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/STM.d.ts
5240
5240
  /**
5241
5241
  * @since 2.0.0
5242
5242
  * @category symbols
@@ -5355,7 +5355,7 @@ declare namespace STM {
5355
5355
  }
5356
5356
  }
5357
5357
  //#endregion
5358
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Stream.d.ts
5358
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Stream.d.ts
5359
5359
  /**
5360
5360
  * @since 2.0.0
5361
5361
  * @category symbols
@@ -5468,7 +5468,7 @@ declare namespace Stream {
5468
5468
  type DynamicTupleOf<T$1, N extends number, R$1 extends Array<unknown>> = R$1["length"] extends N ? R$1 : DynamicTupleOf<T$1, N, [T$1, ...R$1]>;
5469
5469
  }
5470
5470
  //#endregion
5471
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Channel.d.ts
5471
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Channel.d.ts
5472
5472
  /**
5473
5473
  * @since 2.0.0
5474
5474
  * @category symbols
@@ -5562,7 +5562,7 @@ declare namespace Channel {
5562
5562
  }
5563
5563
  }
5564
5564
  //#endregion
5565
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Cause.d.ts
5565
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Cause.d.ts
5566
5566
  /**
5567
5567
  * A unique symbol identifying the `NoSuchElementException` type.
5568
5568
  *
@@ -5702,7 +5702,7 @@ declare const NoSuchElementException: new (message?: string | undefined) => NoSu
5702
5702
  */
5703
5703
  declare const UnknownException: new (error: unknown, message?: string | undefined) => UnknownException;
5704
5704
  //#endregion
5705
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Effect.d.ts
5705
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Effect.d.ts
5706
5706
  /**
5707
5707
  * @since 2.0.0
5708
5708
  * @category Symbols
@@ -5932,7 +5932,7 @@ declare const Tag$1: <const Id$1 extends string>(id: Id$1) => <Self, Type$5 exte
5932
5932
  use: <X>(body: (_: Type$5) => X) => [X] extends [Effect<infer A, infer E, infer R>] ? Effect<A, E, R | Self> : [X] extends [PromiseLike<infer A>] ? Effect<A, UnknownException, Self> : Effect<X, never, Self>;
5933
5933
  };
5934
5934
  //#endregion
5935
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Inspectable.d.ts
5935
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Inspectable.d.ts
5936
5936
  /**
5937
5937
  * @since 2.0.0
5938
5938
  * @category models
@@ -5943,7 +5943,7 @@ interface Inspectable {
5943
5943
  [NodeInspectSymbol](): unknown;
5944
5944
  }
5945
5945
  //#endregion
5946
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Either.d.ts
5946
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Either.d.ts
5947
5947
  /**
5948
5948
  * @category models
5949
5949
  * @since 2.0.0
@@ -6021,7 +6021,7 @@ declare namespace Either {
6021
6021
  type Right<T$1 extends Either<any, any>> = [T$1] extends [Either<infer _A, infer _E>] ? _A : never;
6022
6022
  }
6023
6023
  //#endregion
6024
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Array.d.ts
6024
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Array.d.ts
6025
6025
  /**
6026
6026
  * @category models
6027
6027
  * @since 2.0.0
@@ -6033,7 +6033,7 @@ type NonEmptyReadonlyArray<A$1> = readonly [A$1, ...Array<A$1>];
6033
6033
  */
6034
6034
  type NonEmptyArray<A$1> = [A$1, ...Array<A$1>];
6035
6035
  //#endregion
6036
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/SchemaAST.d.ts
6036
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/SchemaAST.d.ts
6037
6037
  /**
6038
6038
  * @category model
6039
6039
  * @since 3.10.0
@@ -6845,7 +6845,7 @@ declare class TypeLiteralTransformation {
6845
6845
  constructor(propertySignatureTransformations: ReadonlyArray<PropertySignatureTransformation$1>);
6846
6846
  }
6847
6847
  //#endregion
6848
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/ParseResult.d.ts
6848
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/ParseResult.d.ts
6849
6849
  /**
6850
6850
  * `ParseIssue` is a type that represents the different types of errors that can occur when decoding/encoding a value.
6851
6851
  *
@@ -7017,7 +7017,7 @@ declare class Forbidden {
7017
7017
  constructor(ast: AST, actual: unknown, message?: string | undefined);
7018
7018
  }
7019
7019
  //#endregion
7020
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Pretty.d.ts
7020
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Pretty.d.ts
7021
7021
  /**
7022
7022
  * @category model
7023
7023
  * @since 3.10.0
@@ -7031,7 +7031,7 @@ interface Pretty<To> {
7031
7031
  */
7032
7032
  type PrettyAnnotation<A$1, TypeParameters extends ReadonlyArray<any> = readonly []> = (...pretties: { readonly [K in keyof TypeParameters]: Pretty<TypeParameters[K]> }) => Pretty<A$1>;
7033
7033
  //#endregion
7034
- //#region ../../../../node_modules/.pnpm/effect@3.19.16/node_modules/effect/dist/dts/Schema.d.ts
7034
+ //#region ../../../../node_modules/.pnpm/effect@3.20.0/node_modules/effect/dist/dts/Schema.d.ts
7035
7035
  /**
7036
7036
  * @since 3.10.0
7037
7037
  */
@@ -7830,6 +7830,23 @@ interface ObjectIdClass extends SchemaClass<ObjectId, string> {
7830
7830
  * NOTE: The generated IDs depend on the order of ObjectId.random() calls, which might be affected by test order, scheduling, etc.
7831
7831
  */
7832
7832
  dangerouslyDisableRandomness(): void;
7833
+ /**
7834
+ * WARNING: To be used only within tests.
7835
+ *
7836
+ * Pins the time component of generated ObjectIds and seeds the PRNG used for the random component,
7837
+ * causing the same sequence of IDs to be generated across runs.
7838
+ * Do not use in production code as this will cause data collisions.
7839
+ *
7840
+ * @param time - Fixed timestamp (ms since epoch) used as the ULID time component.
7841
+ * @param seed - Seed value for the PRNG used for the ULID random component.
7842
+ *
7843
+ * ```ts
7844
+ * ObjectId.dangerouslySetSeed(new Date('2025-01-01').getTime(), 42);
7845
+ * ```
7846
+ *
7847
+ * NOTE: The generated IDs depend on the order of ObjectId.random() calls, which might be affected by test order, scheduling, etc.
7848
+ */
7849
+ dangerouslySetSeed(time: number, seed: number): void;
7833
7850
  }
7834
7851
  /**
7835
7852
  * Randomly generated unique identifier for an object.
@@ -8034,7 +8051,7 @@ declare const FilterObject_: Struct<{
8034
8051
  * Filter by property.
8035
8052
  * Must not include object ID.
8036
8053
  */
8037
- props: Record$<SchemaClass<string, string, never>, suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>>;
8054
+ props: Record$<SchemaClass<string, string, never>, suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>>;
8038
8055
  /**
8039
8056
  * Objects that have any of the given foreign keys.
8040
8057
  */
@@ -8045,6 +8062,15 @@ declare const FilterObject_: Struct<{
8045
8062
  readonly source: string;
8046
8063
  readonly id: string;
8047
8064
  }, never>>>;
8065
+ /**
8066
+ * Match objects whose meta `key` equals this fully-qualified registry key (FQN format).
8067
+ */
8068
+ metaKey: optional<typeof String$>;
8069
+ /**
8070
+ * Semver range matched against the object's meta `version`.
8071
+ * Only consulted when {@link metaKey} is set. Objects with no `version` do not satisfy a version-constrained filter.
8072
+ */
8073
+ metaVersion: optional<typeof String$>;
8048
8074
  }>;
8049
8075
  interface FilterObject extends Schema.Type<typeof FilterObject_> {}
8050
8076
  declare const FilterObject: Schema<FilterObject>;
@@ -8099,6 +8125,18 @@ declare const FilterRange_: Struct<{
8099
8125
  }>;
8100
8126
  interface FilterRange extends Schema.Type<typeof FilterRange_> {}
8101
8127
  declare const FilterRange: Schema<FilterRange>;
8128
+ /**
8129
+ * Filter by system timestamp (createdAt / updatedAt).
8130
+ * Timestamps are unix milliseconds stored in the object meta index.
8131
+ */
8132
+ declare const FilterTimestamp_: Struct<{
8133
+ type: Literal<["timestamp"]>;
8134
+ field: Literal<["createdAt", "updatedAt"]>;
8135
+ operator: Literal<["gt", "gte", "lt", "lte"]>;
8136
+ value: typeof Number$;
8137
+ }>;
8138
+ interface FilterTimestamp extends Schema.Type<typeof FilterTimestamp_> {}
8139
+ declare const FilterTimestamp: Schema<FilterTimestamp>;
8102
8140
  /**
8103
8141
  * Text search.
8104
8142
  */
@@ -8114,7 +8152,7 @@ declare const FilterTextSearch: Schema<FilterTextSearch>;
8114
8152
  */
8115
8153
  declare const FilterNot_: Struct<{
8116
8154
  type: Literal<["not"]>;
8117
- filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>;
8155
+ filter: suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>;
8118
8156
  }>;
8119
8157
  interface FilterNot extends Schema.Type<typeof FilterNot_> {}
8120
8158
  declare const FilterNot: Schema<FilterNot>;
@@ -8123,7 +8161,7 @@ declare const FilterNot: Schema<FilterNot>;
8123
8161
  */
8124
8162
  declare const FilterAnd_: Struct<{
8125
8163
  type: Literal<["and"]>;
8126
- filters: Array$<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>>;
8164
+ filters: Array$<suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>>;
8127
8165
  }>;
8128
8166
  interface FilterAnd extends Schema.Type<typeof FilterAnd_> {}
8129
8167
  declare const FilterAnd: Schema<FilterAnd>;
@@ -8132,21 +8170,34 @@ declare const FilterAnd: Schema<FilterAnd>;
8132
8170
  */
8133
8171
  declare const FilterOr_: Struct<{
8134
8172
  type: Literal<["or"]>;
8135
- filters: Array$<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>>;
8173
+ filters: Array$<suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>>;
8136
8174
  }>;
8137
8175
  interface FilterOr extends Schema.Type<typeof FilterOr_> {}
8138
8176
  declare const FilterOr: Schema<FilterOr>;
8177
+ /**
8178
+ * Filter objects that are children of the specified parents.
8179
+ * With transitive=true (default), matches grandchildren and beyond.
8180
+ */
8181
+ declare const FilterChildOf_: Struct<{
8182
+ type: Literal<["child-of"]>;
8183
+ /** Parent DXNs to match children of. */
8184
+ parents: Array$<refine<string, typeof NonEmptyString>>;
8185
+ /** Whether to match transitively (grandchildren, etc.). Defaults to true. */
8186
+ transitive: typeof Boolean$;
8187
+ }>;
8188
+ interface FilterChildOf extends Schema.Type<typeof FilterChildOf_> {}
8189
+ declare const FilterChildOf: Schema<FilterChildOf>;
8139
8190
  /**
8140
8191
  * Union of filters.
8141
8192
  */
8142
- declare const Filter$1: Union<[Schema<FilterObject, FilterObject, never>, Schema<FilterCompare, FilterCompare, never>, Schema<FilterIn, FilterIn, never>, Schema<FilterContains, FilterContains, never>, Schema<FilterTag, FilterTag, never>, Schema<FilterRange, FilterRange, never>, Schema<FilterTextSearch, FilterTextSearch, never>, Schema<FilterNot, FilterNot, never>, Schema<FilterAnd, FilterAnd, never>, Schema<FilterOr, FilterOr, never>]>;
8193
+ declare const Filter$1: Union<[Schema<FilterObject, FilterObject, never>, Schema<FilterCompare, FilterCompare, never>, Schema<FilterIn, FilterIn, never>, Schema<FilterContains, FilterContains, never>, Schema<FilterTag, FilterTag, never>, Schema<FilterRange, FilterRange, never>, Schema<FilterTimestamp, FilterTimestamp, never>, Schema<FilterTextSearch, FilterTextSearch, never>, Schema<FilterChildOf, FilterChildOf, never>, Schema<FilterNot, FilterNot, never>, Schema<FilterAnd, FilterAnd, never>, Schema<FilterOr, FilterOr, never>]>;
8143
8194
  type Filter$1 = Schema.Type<typeof Filter$1>;
8144
8195
  /**
8145
8196
  * Query objects by type, id, and/or predicates.
8146
8197
  */
8147
8198
  declare const QuerySelectClause_: Struct<{
8148
8199
  type: Literal<["select"]>;
8149
- filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>;
8200
+ filter: suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>;
8150
8201
  }>;
8151
8202
  interface QuerySelectClause extends Schema.Type<typeof QuerySelectClause_> {}
8152
8203
  declare const QuerySelectClause: Schema<QuerySelectClause>;
@@ -8155,8 +8206,8 @@ declare const QuerySelectClause: Schema<QuerySelectClause>;
8155
8206
  */
8156
8207
  declare const QueryFilterClause_: Struct<{
8157
8208
  type: Literal<["filter"]>;
8158
- selection: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8159
- filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>;
8209
+ selection: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8210
+ filter: suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>;
8160
8211
  }>;
8161
8212
  interface QueryFilterClause extends Schema.Type<typeof QueryFilterClause_> {}
8162
8213
  declare const QueryFilterClause: Schema<QueryFilterClause>;
@@ -8165,7 +8216,7 @@ declare const QueryFilterClause: Schema<QueryFilterClause>;
8165
8216
  */
8166
8217
  declare const QueryReferenceTraversalClause_: Struct<{
8167
8218
  type: Literal<["reference-traversal"]>;
8168
- anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8219
+ anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8169
8220
  property: typeof String$;
8170
8221
  }>;
8171
8222
  interface QueryReferenceTraversalClause extends Schema.Type<typeof QueryReferenceTraversalClause_> {}
@@ -8175,7 +8226,7 @@ declare const QueryReferenceTraversalClause: Schema<QueryReferenceTraversalClaus
8175
8226
  */
8176
8227
  declare const QueryIncomingReferencesClause_: Struct<{
8177
8228
  type: Literal<["incoming-references"]>;
8178
- anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8229
+ anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8179
8230
  /**
8180
8231
  * Property path where the reference is located.
8181
8232
  * If null, matches references from any property.
@@ -8190,14 +8241,14 @@ declare const QueryIncomingReferencesClause: Schema<QueryIncomingReferencesClaus
8190
8241
  */
8191
8242
  declare const QueryRelationClause_: Struct<{
8192
8243
  type: Literal<["relation"]>;
8193
- anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8244
+ anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8194
8245
  /**
8195
8246
  * outgoing: anchor is the source of the relation.
8196
8247
  * incoming: anchor is the target of the relation.
8197
8248
  * both: anchor is either the source or target of the relation.
8198
8249
  */
8199
8250
  direction: Literal<["outgoing", "incoming", "both"]>;
8200
- filter: optional<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>>;
8251
+ filter: optional<suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>>;
8201
8252
  }>;
8202
8253
  interface QueryRelationClause extends Schema.Type<typeof QueryRelationClause_> {}
8203
8254
  declare const QueryRelationClause: Schema<QueryRelationClause>;
@@ -8206,7 +8257,7 @@ declare const QueryRelationClause: Schema<QueryRelationClause>;
8206
8257
  */
8207
8258
  declare const QueryRelationTraversalClause_: Struct<{
8208
8259
  type: Literal<["relation-traversal"]>;
8209
- anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8260
+ anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8210
8261
  direction: Literal<["source", "target", "both"]>;
8211
8262
  }>;
8212
8263
  interface QueryRelationTraversalClause extends Schema.Type<typeof QueryRelationTraversalClause_> {}
@@ -8216,7 +8267,7 @@ declare const QueryRelationTraversalClause: Schema<QueryRelationTraversalClause>
8216
8267
  */
8217
8268
  declare const QueryHierarchyTraversalClause_: Struct<{
8218
8269
  type: Literal<["hierarchy-traversal"]>;
8219
- anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8270
+ anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8220
8271
  /**
8221
8272
  * to-parent: traverse from child to parent.
8222
8273
  * to-children: traverse from parent to children.
@@ -8230,7 +8281,7 @@ declare const QueryHierarchyTraversalClause: Schema<QueryHierarchyTraversalClaus
8230
8281
  */
8231
8282
  declare const QueryUnionClause_: Struct<{
8232
8283
  type: Literal<["union"]>;
8233
- queries: Array$<suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>>;
8284
+ queries: Array$<suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>>;
8234
8285
  }>;
8235
8286
  interface QueryUnionClause extends Schema.Type<typeof QueryUnionClause_> {}
8236
8287
  declare const QueryUnionClause: Schema<QueryUnionClause>;
@@ -8239,8 +8290,8 @@ declare const QueryUnionClause: Schema<QueryUnionClause>;
8239
8290
  */
8240
8291
  declare const QuerySetDifferenceClause_: Struct<{
8241
8292
  type: Literal<["set-difference"]>;
8242
- source: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8243
- exclude: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8293
+ source: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8294
+ exclude: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8244
8295
  }>;
8245
8296
  interface QuerySetDifferenceClause extends Schema.Type<typeof QuerySetDifferenceClause_> {}
8246
8297
  declare const QuerySetDifferenceClause: Schema<QuerySetDifferenceClause>;
@@ -8264,7 +8315,7 @@ declare const Order$1: Schema<Order$1>;
8264
8315
  */
8265
8316
  declare const QueryOrderClause_: Struct<{
8266
8317
  type: Literal<["order"]>;
8267
- query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8318
+ query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8268
8319
  order: Array$<Schema<{
8269
8320
  readonly kind: "natural";
8270
8321
  } | {
@@ -8292,11 +8343,13 @@ declare const QueryOrderClause: Schema<QueryOrderClause>;
8292
8343
  */
8293
8344
  declare const QueryOptionsClause_: Struct<{
8294
8345
  type: Literal<["options"]>;
8295
- query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8346
+ query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8296
8347
  options: suspend<{
8297
- readonly deleted?: "include" | "exclude" | "only" | undefined;
8348
+ readonly deleted?: "exclude" | "include" | "only" | undefined;
8349
+ readonly debugLabel?: string | undefined;
8298
8350
  }, {
8299
- readonly deleted?: "include" | "exclude" | "only" | undefined;
8351
+ readonly debugLabel?: string | undefined;
8352
+ readonly deleted?: "exclude" | "include" | "only" | undefined;
8300
8353
  }, never>;
8301
8354
  }>;
8302
8355
  interface QueryOptionsClause extends Schema.Type<typeof QueryOptionsClause_> {}
@@ -8306,26 +8359,26 @@ declare const QueryOptionsClause: Schema<QueryOptionsClause>;
8306
8359
  */
8307
8360
  declare const QueryLimitClause_: Struct<{
8308
8361
  type: Literal<["limit"]>;
8309
- query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8362
+ query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8310
8363
  limit: typeof Number$;
8311
8364
  }>;
8312
8365
  interface QueryLimitClause extends Schema.Type<typeof QueryLimitClause_> {}
8313
8366
  declare const QueryLimitClause: Schema<QueryLimitClause>;
8314
8367
  declare const QueryFromClause_: Struct<{
8315
8368
  type: Literal<["from"]>;
8316
- query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8369
+ query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8317
8370
  from: Union<[TaggedStruct<"scope", {
8318
8371
  scope: suspend<{
8319
8372
  readonly spaceIds?: readonly string[] | undefined;
8320
- readonly allQueuesFromSpaces?: boolean | undefined;
8321
- readonly queues?: readonly string[] | undefined;
8373
+ readonly allFeedsFromSpaces?: boolean | undefined;
8374
+ readonly feeds?: readonly string[] | undefined;
8322
8375
  }, {
8376
+ readonly allFeedsFromSpaces?: boolean | undefined;
8377
+ readonly feeds?: readonly string[] | undefined;
8323
8378
  readonly spaceIds?: readonly string[] | undefined;
8324
- readonly allQueuesFromSpaces?: boolean | undefined;
8325
- readonly queues?: readonly string[] | undefined;
8326
8379
  }, never>;
8327
8380
  }>, TaggedStruct<"query", {
8328
- query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
8381
+ query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
8329
8382
  }>]>;
8330
8383
  }>;
8331
8384
  interface QueryFromClause extends Schema.Type<typeof QueryFromClause_> {}
@@ -8338,6 +8391,10 @@ declare const QueryOptions: Struct<{
8338
8391
  * Nested select statements will use this option to filter deleted objects.
8339
8392
  */
8340
8393
  deleted: optional<Literal<["include", "exclude", "only"]>>;
8394
+ /**
8395
+ * Diagnostics-only label for logs / tooling (not used by execution semantics).
8396
+ */
8397
+ debugLabel: optional<typeof String$>;
8341
8398
  }>;
8342
8399
  interface QueryOptions extends Schema.Type<typeof QueryOptions> {}
8343
8400
  /**
@@ -8347,19 +8404,19 @@ declare const Scope: Struct<{
8347
8404
  /**
8348
8405
  * The nested select statemets will select from the given spaces.
8349
8406
  *
8350
- * NOTE: Spaces and queues are unioned together if both are specified.
8407
+ * NOTE: Spaces and feeds are unioned together if both are specified.
8351
8408
  */
8352
8409
  spaceIds: optional<Array$<typeof String$>>;
8353
8410
  /**
8354
- * If true, the nested select statements will select from all queues in the spaces specified by `spaceIds`.
8411
+ * If true, the nested select statements will select from all feeds in the spaces specified by `spaceIds`.
8355
8412
  */
8356
- allQueuesFromSpaces: optional<typeof Boolean$>;
8413
+ allFeedsFromSpaces: optional<typeof Boolean$>;
8357
8414
  /**
8358
- * The nested select statemets will select from the given queues.
8415
+ * The nested select statemets will select from the given feeds (by underlying queue DXN).
8359
8416
  *
8360
- * NOTE: Spaces and queues are unioned together if both are specified.
8417
+ * NOTE: Spaces and feeds are unioned together if both are specified.
8361
8418
  */
8362
- queues: optional<Array$<refine<string, typeof NonEmptyString>>>;
8419
+ feeds: optional<Array$<refine<string, typeof NonEmptyString>>>;
8363
8420
  }>;
8364
8421
  interface Scope extends Schema.Type<typeof Scope> {}
8365
8422
  //#endregion
@@ -8372,7 +8429,7 @@ type JsonPath = string & {
8372
8429
  */
8373
8430
  declare const JsonPath: Schema<JsonPath>;
8374
8431
  //#endregion
8375
- //#region ../../../../node_modules/.pnpm/@effect-atom+atom@0.5.1_@effect+experimental@0.58.0_@effect+platform@0.94.4_effect@3.19_2781dcea2245861d5b097a0ab57df73a/node_modules/@effect-atom/atom/dist/dts/AtomHttpApi.d.ts
8432
+ //#region ../../../../node_modules/.pnpm/@effect-atom+atom@0.5.1_@effect+experimental@0.58.0_@effect+platform@0.94.4_effect@3.20_0d92fe5e7b61f71046b89ef5357c0767/node_modules/@effect-atom/atom/dist/dts/AtomHttpApi.d.ts
8376
8433
  declare global {
8377
8434
  interface ErrorConstructor {
8378
8435
  stackTraceLimit: number;
@@ -8383,7 +8440,7 @@ declare global {
8383
8440
  * @category Constructors
8384
8441
  */
8385
8442
  //#endregion
8386
- //#region ../../../../node_modules/.pnpm/@effect-atom+atom@0.5.1_@effect+experimental@0.58.0_@effect+platform@0.94.4_effect@3.19_2781dcea2245861d5b097a0ab57df73a/node_modules/@effect-atom/atom/dist/dts/AtomRpc.d.ts
8443
+ //#region ../../../../node_modules/.pnpm/@effect-atom+atom@0.5.1_@effect+experimental@0.58.0_@effect+platform@0.94.4_effect@3.20_0d92fe5e7b61f71046b89ef5357c0767/node_modules/@effect-atom/atom/dist/dts/AtomRpc.d.ts
8387
8444
  declare global {
8388
8445
  interface ErrorConstructor {
8389
8446
  stackTraceLimit: number;
@@ -8409,121 +8466,6 @@ interface EchoTypeSchema<Self extends Schema.Any, ExtraFields = {}, K$1 extends
8409
8466
  readonly fields: Fields;
8410
8467
  instanceOf(value: unknown): boolean;
8411
8468
  }
8412
- declare namespace Filter_d_exports {
8413
- export { Any$3 as Any, Filter, Props, TextSearchOptions, Type$2 as Type, and, between, contains, eq, everything, foreignKeys, fromAst$1 as fromAst, gt, gte, id, in$ as in, is$1 as is, lt, lte, neq, not, nothing, or, props, tag, text, type$2 as type, typeDXN, typename$1 as typename };
8414
- }
8415
- interface Filter<T$1> {
8416
- '~Filter': {
8417
- value: Contravariant<T$1>;
8418
- };
8419
- ast: Filter$1;
8420
- }
8421
- type Props<T$1> = { [K in keyof T$1 & string]?: Filter<T$1[K]> | T$1[K] };
8422
- type Any$3 = Filter<any>;
8423
- type Type$2<F extends Any$3> = F extends Filter<infer T> ? T : never;
8424
- declare class FilterClass implements Any$3 {
8425
- readonly ast: Filter$1;
8426
- private static 'variance';
8427
- constructor(ast: Filter$1);
8428
- '~Filter': {
8429
- value: Contravariant<any>;
8430
- };
8431
- }
8432
- declare const is$1: (value: unknown) => value is Any$3;
8433
- /** Construct a filter from an ast. */
8434
- declare const fromAst$1: (ast: Filter$1) => Any$3;
8435
- /**
8436
- * Filter that matches all objects.
8437
- */
8438
- declare const everything: () => FilterClass;
8439
- /**
8440
- * Filter that matches no objects.
8441
- */
8442
- declare const nothing: () => FilterClass;
8443
- declare const id: (...ids: ObjectId[]) => Any$3;
8444
- /**
8445
- * Filter by type.
8446
- */
8447
- declare const type$2: <S$1 extends Schema.All>(schema: S$1 | string, props?: Props<Schema.Type<S$1>>) => Filter<Schema.Type<S$1>>;
8448
- /**
8449
- * Filter by non-qualified typename.
8450
- */
8451
- declare const typename$1: (typename: string) => Any$3;
8452
- /**
8453
- * Filter by fully qualified type DXN.
8454
- */
8455
- declare const typeDXN: (dxn: DXN) => Any$3;
8456
- /**
8457
- * Filter by tag.
8458
- */
8459
- declare const tag: (tag: string) => Any$3;
8460
- /**
8461
- * Filter by properties.
8462
- */
8463
- declare const props: <T$1>(props: Props<T$1>) => Filter<T$1>;
8464
- type TextSearchOptions = {
8465
- type?: 'full-text' | 'vector';
8466
- };
8467
- /**
8468
- * Full-text or vector search.
8469
- */
8470
- declare const text: (text: string, options?: TextSearchOptions) => Any$3;
8471
- /**
8472
- * Filter by foreign keys.
8473
- */
8474
- declare const foreignKeys: <S$1 extends Schema.All>(schema: S$1 | string, keys: ForeignKey[]) => Filter<Schema.Type<S$1>>;
8475
- /**
8476
- * Predicate for property to be equal to the provided value.
8477
- */
8478
- declare const eq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8479
- /**
8480
- * Predicate for property to be not equal to the provided value.
8481
- */
8482
- declare const neq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8483
- /**
8484
- * Predicate for property to be greater than the provided value.
8485
- */
8486
- declare const gt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8487
- /**
8488
- * Predicate for property to be greater than or equal to the provided value.
8489
- */
8490
- declare const gte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8491
- /**
8492
- * Predicate for property to be less than the provided value.
8493
- */
8494
- declare const lt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8495
- /**
8496
- * Predicate for property to be less than or equal to the provided value.
8497
- */
8498
- declare const lte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8499
- /**
8500
- * Predicate for property to be in the provided array.
8501
- * @param values - Values to check against.
8502
- */
8503
- declare const in$: <T$1>(...values: T$1[]) => Filter<T$1 | undefined>;
8504
- /**
8505
- * Predicate for an array property to contain the provided value.
8506
- * @param value - Value to check against.
8507
- */
8508
- declare const contains: <T$1>(value: T$1) => Filter<readonly T$1[] | undefined>;
8509
- /**
8510
- * Predicate for property to be in the provided range.
8511
- * @param from - Start of the range (inclusive).
8512
- * @param to - End of the range (exclusive).
8513
- */
8514
- declare const between: <T$1>(from: T$1, to: T$1) => Filter<unknown>;
8515
- /**
8516
- * Negate the filter.
8517
- */
8518
- declare const not: <F extends Any$3>(filter: F) => Filter<Type$2<F>>;
8519
- /**
8520
- * Combine filters with a logical AND.
8521
- */
8522
- declare const and: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
8523
- /**
8524
- * Combine filters with a logical OR.
8525
- */
8526
- declare const or: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
8527
8469
  //#endregion
8528
8470
  //#region ../echo/dist/types/src/internal/JsonSchema/json-schema-type.d.ts
8529
8471
  /**
@@ -8651,7 +8593,7 @@ declare const _JsonSchemaType: Struct<{
8651
8593
  patternProperties: optional<Record$<typeof String$, suspend<JsonSchemaType, JsonSchemaType, never>>>;
8652
8594
  propertyNames: optional<suspend<JsonSchemaType, JsonSchemaType, never>>;
8653
8595
  definitions: optional<Record$<typeof String$, suspend<JsonSchemaType, JsonSchemaType, never>>>;
8654
- dependencies: optional<Record$<typeof String$, suspend<string | readonly string[] | JsonSchemaType, string | readonly string[] | JsonSchemaType, never>>>;
8596
+ dependencies: optional<Record$<typeof String$, suspend<string | JsonSchemaType | readonly string[], string | JsonSchemaType | readonly string[], never>>>;
8655
8597
  contentMediaType: optional<typeof String$>;
8656
8598
  contentEncoding: optional<typeof String$>;
8657
8599
  if: optional<suspend<JsonSchemaType, JsonSchemaType, never>>;
@@ -8806,6 +8748,15 @@ interface Ref<T$1> extends Pipeable {
8806
8748
  * @returns Promise that will resolves with the target object or undefined if the object is not loaded locally.
8807
8749
  */
8808
8750
  tryLoad(): Promise<T$1 | undefined>;
8751
+ /**
8752
+ * Subscribe to the ref's resolution event.
8753
+ * The callback fires when the target object becomes available in the working set
8754
+ * (e.g. when its document is loaded after sibling-client mutation).
8755
+ * Note: the resolver only schedules a notification when the target is requested
8756
+ * via {@link target} while it is not yet loaded.
8757
+ * @returns Function that unsubscribes the callback.
8758
+ */
8759
+ onResolved(callback: () => void): () => void;
8809
8760
  /**
8810
8761
  * Do not inline the target object in the reference.
8811
8762
  * Makes .target unavailable unless the reference is connected to a database context.
@@ -8855,6 +8806,63 @@ interface RefResolver {
8855
8806
  resolveSchema(dxn: DXN): Promise<Schema.AnyNoContext | undefined>;
8856
8807
  }
8857
8808
  //#endregion
8809
+ //#region ../echo/dist/types/src/Ref.d.ts
8810
+ /**
8811
+ * Instance type for a reference.
8812
+ *
8813
+ * Reference can point to any object or relation.
8814
+ * References are lazy loaded.
8815
+ *
8816
+ * `ref.dxn` is the DXN of the referenced object.
8817
+ *
8818
+ * @example
8819
+ * ```ts
8820
+ * const taskRef: Ref<Task> = Ref.make(task);
8821
+ *
8822
+ * await taskRef.load(); // Returns Promise<Task>
8823
+ * yield* Database.load(taskRef); // Effectful version.
8824
+ *
8825
+ * database.makeRef(dxn); // Create a ref from a DXN.
8826
+ * ```
8827
+ */
8828
+ type Ref$1<T$1> = Ref<T$1>;
8829
+ type Unknown$2 = Ref<Unknown$1>;
8830
+ /**
8831
+ * Factory function to create a Ref schema for the given target schema.
8832
+ * Use this in schema definitions to declare reference fields.
8833
+ *
8834
+ * @example
8835
+ * ```ts
8836
+ * const Task = Schema.Struct({
8837
+ * assignee: Ref.Ref(Person), // Creates a Ref schema
8838
+ * }).pipe(Type.object({ typename: 'Task', version: '0.1.0' }));
8839
+ * ```
8840
+ */
8841
+ declare const Ref$1: <S$1 extends Schema.Any>(schema: S$1) => RefSchema<Schema.Type<S$1>>;
8842
+ /**
8843
+ * TypeScript type for a Ref schema.
8844
+ * This is the type of the SCHEMA itself, not the runtime ref instance.
8845
+ * For the instance type, use `Ref.Ref<T>` from the Ref module.
8846
+ *
8847
+ * @example
8848
+ * ```ts
8849
+ * // Schema type annotation (rarely needed, usually inferred):
8850
+ * const refSchema: Ref.RefSchema<typeof Task> = Ref.Ref(Task);
8851
+ *
8852
+ * // Instance type annotation (use Ref.Ref instead):
8853
+ * const refInstance: Ref.Ref<Task> = Ref.make(task);
8854
+ * ```
8855
+ */
8856
+ interface RefSchema<T$1 extends Unknown> extends RefSchema$1<T$1> {}
8857
+ /**
8858
+ * Extract reference target.
8859
+ */
8860
+ type Target<R$1 extends Unknown$2> = R$1 extends Ref<infer T> ? T : never;
8861
+ /**
8862
+ * Reference resolver.
8863
+ */
8864
+ type Resolver = RefResolver;
8865
+ //#endregion
8858
8866
  //#region ../echo/dist/types/src/internal/Obj/typed-object.d.ts
8859
8867
  /**
8860
8868
  * Definition for an object type that can be stored in an ECHO database.
@@ -9004,7 +9012,7 @@ declare class EchoSchema<A$1 = any, I$1 = any> extends EchoSchema_base implement
9004
9012
  */
9005
9013
  removeFields(fieldNames: string[]): void;
9006
9014
  /**
9007
- * Wrapper for Obj.change that handles the change context for the persistent schema.
9015
+ * Wrapper for Obj.update that handles the change context for the persistent schema.
9008
9016
  */
9009
9017
  private _change;
9010
9018
  /**
@@ -9125,7 +9133,7 @@ type OfShape<Props$1> = BaseObj & Props$1;
9125
9133
  * NOTE: This is a TypeScript type only, not a schema.
9126
9134
  * To validate that a value is an ECHO object, use `Schema.is(Type.Obj)`.
9127
9135
  */
9128
- interface Unknown$2 extends BaseObj {}
9136
+ interface Unknown$1 extends BaseObj {}
9129
9137
  /**
9130
9138
  * Runtime Effect schema for any ECHO object.
9131
9139
  * Use for validation, parsing, or as a reference target for collections.
@@ -9147,70 +9155,176 @@ interface Unknown$2 extends BaseObj {}
9147
9155
  * }).pipe(Type.object({ typename: 'Collection', version: '0.1.0' }));
9148
9156
  * ```
9149
9157
  */
9150
- declare const Unknown$2: Obj$1<Unknown$2>;
9158
+ declare const Unknown$1: Obj$1<Unknown$1>;
9151
9159
  /**
9152
9160
  * JSON-encoded properties for objects.
9153
9161
  */
9154
9162
  interface BaseObjJson {
9155
9163
  id: string;
9156
9164
  }
9157
- //#endregion
9158
- //#region ../echo/dist/types/src/Ref.d.ts
9165
+ declare namespace Filter_d_exports {
9166
+ export { Any$3 as Any, ChildOfOptions, Filter, KeyFilterOptions, Props, TextSearchOptions, Type$2 as Type, and, between, childOf, contains, created, eq, everything, foreignKeys, fromAst$1 as fromAst, gt, gte, id, in$ as in, is$1 as is, key$1 as key, lt, lte, neq, not, nothing, or, pretty$1 as pretty, props, tag, text, type$2 as type, typeDXN, typename$1 as typename, updated };
9167
+ }
9168
+ interface Filter<T$1> {
9169
+ '~Filter': {
9170
+ value: Covariant<T$1>;
9171
+ };
9172
+ ast: Filter$1;
9173
+ }
9174
+ type Props<T$1> = { [K in keyof T$1 & string]?: Filter<T$1[K]> | T$1[K] };
9175
+ type Any$3 = Filter<any>;
9176
+ type Type$2<F extends Any$3> = F extends Filter<infer T> ? T : never;
9177
+ declare class FilterClass implements Any$3 {
9178
+ readonly ast: Filter$1;
9179
+ private static 'variance';
9180
+ constructor(ast: Filter$1);
9181
+ '~Filter': {
9182
+ value: Covariant<any>;
9183
+ };
9184
+ }
9185
+ declare const is$1: (value: unknown) => value is Any$3;
9186
+ /** Construct a filter from an ast. */
9187
+ declare const fromAst$1: (ast: Filter$1) => Any$3;
9159
9188
  /**
9160
- * Instance type for a reference.
9161
- *
9162
- * Reference can point to any object or relation.
9163
- * References are lazy loaded.
9164
- *
9165
- * `ref.dxn` is the DXN of the referenced object.
9166
- *
9167
- * @example
9168
- * ```ts
9169
- * const taskRef: Ref<Task> = Ref.make(task);
9170
- *
9171
- * await taskRef.load(); // Returns Promise<Task>
9172
- * yield* Database.load(taskRef); // Effectful version.
9173
- *
9174
- * database.makeRef(dxn); // Create a ref from a DXN.
9175
- * ```
9189
+ * Filter that matches all objects.
9176
9190
  */
9177
- type Ref$1<T$1> = Ref<T$1>;
9178
- type Unknown$1 = Ref<Unknown$2>;
9191
+ declare const everything: () => FilterClass;
9179
9192
  /**
9180
- * Factory function to create a Ref schema for the given target schema.
9181
- * Use this in schema definitions to declare reference fields.
9182
- *
9183
- * @example
9184
- * ```ts
9185
- * const Task = Schema.Struct({
9186
- * assignee: Ref.Ref(Person), // Creates a Ref schema
9187
- * }).pipe(Type.object({ typename: 'Task', version: '0.1.0' }));
9188
- * ```
9193
+ * Filter that matches no objects.
9189
9194
  */
9190
- declare const Ref$1: <S$1 extends Schema.Any>(schema: S$1) => RefSchema<Schema.Type<S$1>>;
9195
+ declare const nothing: () => FilterClass;
9196
+ declare const id: (...ids: ObjectId[]) => Any$3;
9191
9197
  /**
9192
- * TypeScript type for a Ref schema.
9193
- * This is the type of the SCHEMA itself, not the runtime ref instance.
9194
- * For the instance type, use `Ref.Ref<T>` from the Ref module.
9198
+ * Filter by type.
9199
+ */
9200
+ declare const type$2: <S$1 extends Schema.All>(schema: S$1 | string, props?: Props<Schema.Type<S$1>>) => Filter<Schema.Type<S$1>>;
9201
+ /**
9202
+ * Filter by non-qualified typename.
9203
+ */
9204
+ declare const typename$1: (typename: string) => Any$3;
9205
+ /**
9206
+ * Filter by fully qualified type DXN.
9207
+ */
9208
+ declare const typeDXN: (dxn: DXN) => Any$3;
9209
+ /**
9210
+ * Filter by tag.
9211
+ */
9212
+ declare const tag: (tag: string) => Any$3;
9213
+ /**
9214
+ * Options for {@link key} filter.
9215
+ */
9216
+ type KeyFilterOptions = {
9217
+ /**
9218
+ * Optional semver range expression (e.g. `^1.2.3`, `~2.0.0`, `>=1.0.0 <2.0.0`).
9219
+ * Matches the object's meta `version` field against the range.
9220
+ * If omitted, matches any version (including objects with no version).
9221
+ */
9222
+ version?: string;
9223
+ };
9224
+ /**
9225
+ * Filter by registry key stored in object meta.
9195
9226
  *
9196
9227
  * @example
9197
9228
  * ```ts
9198
- * // Schema type annotation (rarely needed, usually inferred):
9199
- * const refSchema: Ref.RefSchema<typeof Task> = Ref.Ref(Task);
9200
- *
9201
- * // Instance type annotation (use Ref.Ref instead):
9202
- * const refInstance: Ref.Ref<Task> = Ref.make(task);
9229
+ * Filter.key('org.example.type.foo');
9230
+ * Filter.key('org.example.type.foo', { version: '^1.2.3' });
9203
9231
  * ```
9204
9232
  */
9205
- interface RefSchema<T$1 extends Unknown> extends RefSchema$1<T$1> {}
9233
+ declare const key$1: (key: string, options?: KeyFilterOptions) => Any$3;
9206
9234
  /**
9207
- * Extract reference target.
9235
+ * Filter by properties.
9208
9236
  */
9209
- type Target<R$1 extends Unknown$1> = R$1 extends Ref<infer T> ? T : never;
9237
+ declare const props: <T$1>(props: Props<T$1>) => Filter<T$1>;
9238
+ type TextSearchOptions = {
9239
+ type?: 'full-text' | 'vector';
9240
+ };
9210
9241
  /**
9211
- * Reference resolver.
9242
+ * Full-text or vector search.
9212
9243
  */
9213
- type Resolver = RefResolver;
9244
+ declare const text: (text: string, options?: TextSearchOptions) => Any$3;
9245
+ /**
9246
+ * Filter by foreign keys.
9247
+ */
9248
+ declare const foreignKeys: <S$1 extends Schema.All>(schema: S$1 | string, keys: ForeignKey[]) => Filter<Schema.Type<S$1>>;
9249
+ /**
9250
+ * Predicate for property to be equal to the provided value.
9251
+ */
9252
+ declare const eq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9253
+ /**
9254
+ * Predicate for property to be not equal to the provided value.
9255
+ */
9256
+ declare const neq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9257
+ /**
9258
+ * Predicate for property to be greater than the provided value.
9259
+ */
9260
+ declare const gt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9261
+ /**
9262
+ * Predicate for property to be greater than or equal to the provided value.
9263
+ */
9264
+ declare const gte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9265
+ /**
9266
+ * Predicate for property to be less than the provided value.
9267
+ */
9268
+ declare const lt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9269
+ /**
9270
+ * Predicate for property to be less than or equal to the provided value.
9271
+ */
9272
+ declare const lte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9273
+ /**
9274
+ * Predicate for property to be in the provided array.
9275
+ * @param values - Values to check against.
9276
+ */
9277
+ declare const in$: <T$1>(...values: T$1[]) => Filter<T$1>;
9278
+ /**
9279
+ * Predicate for an array property to contain the provided value.
9280
+ * @param value - Value to check against.
9281
+ */
9282
+ declare const contains: <T$1>(value: T$1) => Filter<readonly T$1[] | undefined>;
9283
+ /**
9284
+ * Predicate for property to be in the provided range.
9285
+ * @param from - Start of the range (inclusive).
9286
+ * @param to - End of the range (exclusive).
9287
+ */
9288
+ declare const between: <T$1>(from: T$1, to: T$1) => Filter<T$1>;
9289
+ type TimeRange = {
9290
+ after?: Date | number;
9291
+ before?: Date | number;
9292
+ };
9293
+ /**
9294
+ * Filter objects by updatedAt timestamp.
9295
+ */
9296
+ declare const updated: (range: TimeRange) => Any$3;
9297
+ /**
9298
+ * Filter objects by createdAt timestamp.
9299
+ */
9300
+ declare const created: (range: TimeRange) => Any$3;
9301
+ type ChildOfOptions = {
9302
+ /** Whether to match transitively (grandchildren, etc.). Defaults to true. */
9303
+ transitive?: boolean;
9304
+ };
9305
+ /**
9306
+ * Filter objects that are children of the specified parent(s).
9307
+ * Accepts ECHO objects, Refs, or arrays of either.
9308
+ * Refs are resolved to DXNs without loading; objects use {@link Obj.getDXN}.
9309
+ * With transitive=true (default), also matches grandchildren and beyond.
9310
+ */
9311
+ declare const childOf: (parents: Unknown$1 | Unknown$2 | readonly (Unknown$1 | Unknown$2)[], options?: ChildOfOptions) => Any$3;
9312
+ /**
9313
+ * Negate the filter.
9314
+ */
9315
+ declare const not: <F extends Any$3>(filter: F) => Filter<Type$2<F>>;
9316
+ /**
9317
+ * Combine filters with a logical AND.
9318
+ */
9319
+ declare const and: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
9320
+ /**
9321
+ * Combine filters with a logical OR.
9322
+ */
9323
+ declare const or: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
9324
+ /**
9325
+ * Returns a human-readable string representation of a Filter AST.
9326
+ */
9327
+ declare const pretty$1: (filter: Any$3) => string;
9214
9328
  //#endregion
9215
9329
  //#region ../echo/dist/types/src/JsonSchema.d.ts
9216
9330
  /**
@@ -9385,10 +9499,10 @@ interface RefResolutionContext {
9385
9499
  */
9386
9500
  space?: SpaceId;
9387
9501
  /**
9388
- * Queue that the resolution is happening from.
9389
- * This queue will be searched first, and then the space it belongs to.
9502
+ * Feed that the resolution is happening from (as the underlying queue DXN).
9503
+ * This feed will be searched first, and then the space it belongs to.
9390
9504
  */
9391
- queue?: DXN;
9505
+ feed?: DXN;
9392
9506
  }
9393
9507
  interface RefResolverOptions {
9394
9508
  /**
@@ -9439,7 +9553,7 @@ interface Hypergraph extends Queryable {
9439
9553
  */
9440
9554
  declare const Collection: Obj$1<{
9441
9555
  readonly name?: string | undefined;
9442
- readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$2>[];
9556
+ readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$1>[];
9443
9557
  }, Struct.Fields>;
9444
9558
  interface Collection extends Schema.Type<typeof Collection> {}
9445
9559
  //#endregion
@@ -9453,8 +9567,9 @@ interface Collection extends Schema.Type<typeof Collection> {}
9453
9567
  * ```
9454
9568
  */
9455
9569
  declare const Feed: Obj$1<{
9456
- readonly kind?: string | undefined;
9457
9570
  readonly name?: string | undefined;
9571
+ readonly kind?: string | undefined;
9572
+ readonly namespace?: "data" | "trace" | undefined;
9458
9573
  }, Struct.Fields>;
9459
9574
  /**
9460
9575
  * TypeScript instance type for a Feed object.
@@ -9468,8 +9583,8 @@ interface Feed extends Schema.Type<typeof Feed> {}
9468
9583
  */
9469
9584
  declare const ViewSchema: Obj$1<{
9470
9585
  readonly query: {
9471
- readonly ast: QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause;
9472
9586
  readonly raw?: string | undefined;
9587
+ readonly ast: QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause;
9473
9588
  };
9474
9589
  readonly projection: {
9475
9590
  readonly schema?: JsonSchemaType | undefined;
@@ -9493,11 +9608,12 @@ declare const View: Obj$1<View>;
9493
9608
  * Abstart set of objects, represented by a view, feed, or collection.
9494
9609
  */
9495
9610
  declare const Dataset: Union<[Obj$1<{
9496
- readonly kind?: string | undefined;
9497
9611
  readonly name?: string | undefined;
9612
+ readonly kind?: string | undefined;
9613
+ readonly namespace?: "data" | "trace" | undefined;
9498
9614
  }, Struct.Fields>, Obj$1<{
9499
9615
  readonly name?: string | undefined;
9500
- readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$2>[];
9616
+ readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$1>[];
9501
9617
  }, Struct.Fields>, Obj$1<View, Struct.Fields>]>;
9502
9618
  type Dataset = Feed | Collection | View;
9503
9619
  declare namespace Order_d_exports {
@@ -9518,7 +9634,7 @@ declare const property: <T$1>(property: keyof T$1 & string, direction: OrderDire
9518
9634
  */
9519
9635
  declare const rank: <T$1>(direction?: OrderDirection) => Order<T$1>;
9520
9636
  declare namespace Query_d_exports {
9521
- export { Any$1 as Any, Query, Type$1 as Type, all, from, fromAst, is, select, type$1 as type, without };
9637
+ export { Any$1 as Any, Query, Type$1 as Type, all, from, fromAst, is, pretty, select, type$1 as type, without };
9522
9638
  }
9523
9639
  /**
9524
9640
  * All property paths inside T that are references.
@@ -9541,7 +9657,7 @@ interface Query<T$1> {
9541
9657
  * @param key - Property path inside T that is a reference or optional reference.
9542
9658
  * @returns Query for the target of the reference.
9543
9659
  */
9544
- 'reference'<K$1 extends RefPropKey<T$1>>(key: K$1): Query<T$1[K$1] extends Unknown$1 ? Target<T$1[K$1]> : T$1[K$1] extends Unknown$1 | undefined ? Target<Exclude<T$1[K$1], undefined>> : never>;
9660
+ 'reference'<K$1 extends RefPropKey<T$1>>(key: K$1): Query<T$1[K$1] extends Unknown$2 ? Target<T$1[K$1]> : T$1[K$1] extends Unknown$2 | undefined ? Target<Exclude<T$1[K$1], undefined>> : never>;
9545
9661
  /**
9546
9662
  * Find objects referencing this object.
9547
9663
  * @param target - Schema of the referencing object. If not provided, matches any type.
@@ -9666,6 +9782,10 @@ interface Query<T$1> {
9666
9782
  * Add options to a query.
9667
9783
  */
9668
9784
  'options'(options: QueryOptions): Query<T$1>;
9785
+ /**
9786
+ * Attach a diagnostic label for logs and tooling (execution semantics unchanged).
9787
+ */
9788
+ 'debugLabel'(label: string): Query<T$1>;
9669
9789
  }
9670
9790
  type Any$1 = Query<any>;
9671
9791
  type Type$1<Q extends Any$1> = Q extends Query<infer T> ? T : never;
@@ -9686,7 +9806,10 @@ declare const select: <F extends Any$3>(filter: F) => Query<Type$2<F>>;
9686
9806
  *
9687
9807
  * Shorthand for: `Query.select(Filter.type(schema, predicates))`.
9688
9808
  */
9689
- declare const type$1: (schema: Schema.All | string, predicates?: Props<unknown>) => Any$1;
9809
+ declare const type$1: {
9810
+ <S$1 extends Schema.All>(schema: S$1, predicates?: Props<Schema.Type<S$1>>): Query<Schema.Type<S$1>>;
9811
+ (schema: string, predicates?: Props<unknown>): Query<any>;
9812
+ };
9690
9813
  /**
9691
9814
  * Combine results of multiple queries.
9692
9815
  * @param queries - Queries to combine.
@@ -9707,9 +9830,13 @@ declare const without: <T$1>(source: Query<T$1>, exclude: Query<T$1>) => Query<T
9707
9830
  * @param source - Data source: database, feed, 'all-accessible-spaces', or another query.
9708
9831
  * @returns Query scoped to the given source.
9709
9832
  */
9710
- declare const from: (source: Database | Database[] | Feed | Feed[] | Any$1 | Scope | "all-accessible-spaces", options?: {
9833
+ declare const from: (source: Database | Database[] | Feed | Feed[] | Any$1 | Scope | 'all-accessible-spaces', options?: {
9711
9834
  includeFeeds?: boolean;
9712
9835
  }) => Any$1;
9836
+ /**
9837
+ * Returns a human-readable string representation of a Query AST.
9838
+ */
9839
+ declare const pretty: (query: Any$1) => string;
9713
9840
  //#endregion
9714
9841
  //#region ../echo/dist/types/src/Database.d.ts
9715
9842
  /**
@@ -9720,7 +9847,7 @@ interface QueryFn {
9720
9847
  <F extends Any$3>(filter: F): QueryResult<Type$2<F>>;
9721
9848
  }
9722
9849
  /**
9723
- * Common interface for Database and Queue.
9850
+ * Common interface for Database, Feed, and Hypergraph.
9724
9851
  */
9725
9852
  interface Queryable {
9726
9853
  query: QueryFn;
@@ -9774,7 +9901,7 @@ interface Database extends Queryable {
9774
9901
  /**
9775
9902
  * Return object by local ID.
9776
9903
  */
9777
- getObjectById<T$1 extends Unknown$2 = OfShape<AnyProperties>>(id: string, opts?: GetObjectByIdOptions): T$1 | undefined;
9904
+ getObjectById<T$1 extends Unknown$1 = OfShape<AnyProperties>>(id: string, opts?: GetObjectByIdOptions): T$1 | undefined;
9778
9905
  /**
9779
9906
  * Query objects.
9780
9907
  */
@@ -9856,13 +9983,13 @@ interface AnyEntity {
9856
9983
  /**
9857
9984
  * String key used to identify the kind of an entity instance (object or relation).
9858
9985
  */
9859
- declare const KindId: "~@dxos/echo/Kind";
9986
+ declare const KindId: '~@dxos/echo/Kind';
9860
9987
  type KindId = typeof KindId;
9861
9988
  /**
9862
9989
  * String key used to identify the kind of a schema (object schema or relation schema).
9863
9990
  * Parallels KindId which identifies instance kinds.
9864
9991
  */
9865
- declare const SchemaKindId: "~@dxos/echo/SchemaKind";
9992
+ declare const SchemaKindId: '~@dxos/echo/SchemaKind';
9866
9993
  type SchemaKindId = typeof SchemaKindId;
9867
9994
  /**
9868
9995
  * Kinds of entities stored in ECHO: objects and relations.