@dxos/echo-query 0.8.4-main.c85a9c8dae → 0.8.4-main.d05539e30a

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.
@@ -7874,8 +7891,8 @@ type QueueSubspaceTag = (typeof QueueSubspaceTags)[keyof typeof QueueSubspaceTag
7874
7891
  * dxn:echo:<space key>:<echo id>
7875
7892
  * dxn:echo:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE:01J00J9B45YHYSGZQTQMSKMGJ6
7876
7893
  * dxn:echo:@:01J00J9B45YHYSGZQTQMSKMGJ6
7877
- * dxn:type:dxos.org/type/Calendar
7878
- * dxn:plugin:dxos.org/agent/plugin/functions
7894
+ * dxn:type:org.dxos.type.calendar
7895
+ * dxn:plugin:org.dxos.agent.plugin.functions
7879
7896
  * ```
7880
7897
  */
7881
7898
  declare class DXN {
@@ -7912,11 +7929,11 @@ declare class DXN {
7912
7929
  static parse(dxn: string): DXN;
7913
7930
  static tryParse(dxn: string): DXN | undefined;
7914
7931
  /**
7915
- * @example `dxn:type:example.com/type/Person`
7932
+ * @example `dxn:type:com.example.type.person`
7916
7933
  */
7917
7934
  static fromTypename(typename: string): DXN;
7918
7935
  /**
7919
- * @example `dxn:type:example.com/type/Person:0.1.0`
7936
+ * @example `dxn:type:com.example.type.person:0.1.0`
7920
7937
  */
7921
7938
  static fromTypenameAndVersion(typename: string, version: string): DXN;
7922
7939
  /**
@@ -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;
@@ -8394,7 +8451,23 @@ declare global {
8394
8451
  * @category Constructors
8395
8452
  */
8396
8453
  //#endregion
8397
- //#region ../echo/dist/types/src/internal/json-schema/json-schema-type.d.ts
8454
+ //#region ../echo/dist/types/src/internal/Entity/entity.d.ts
8455
+ type EchoTypeSchemaProps<T$1, ExtraFields = {}> = Simplify$1<AnyEntity & ToMutable<T$1> & ExtraFields>;
8456
+ interface EchoTypeSchema<Self extends Schema.Any, ExtraFields = {}, K$1 extends EntityKind = EntityKind, Fields extends Struct.Fields = Struct.Fields> extends TypeMeta, AnnotableClass<EchoTypeSchema<Self, ExtraFields, K$1, Fields>, EchoTypeSchemaProps<Schema.Type<Self>, ExtraFields>, EchoTypeSchemaProps<Schema.Encoded<Self>, ExtraFields>, Schema.Context<Self>> {
8457
+ /**
8458
+ * Schema kind key that marks this as an ECHO schema and indicates its kind.
8459
+ * Makes EchoTypeSchema satisfy the Type.AnyObj or Type.Relation.Any type.
8460
+ */
8461
+ readonly [SchemaKindId]: K$1;
8462
+ /**
8463
+ * The fields defined in the original struct schema.
8464
+ * Allows accessing field definitions for introspection.
8465
+ */
8466
+ readonly fields: Fields;
8467
+ instanceOf(value: unknown): boolean;
8468
+ }
8469
+ //#endregion
8470
+ //#region ../echo/dist/types/src/internal/JsonSchema/json-schema-type.d.ts
8398
8471
  /**
8399
8472
  * Describes a schema for the JSON-schema objects stored in ECHO.
8400
8473
  * Contains extensions for ECHO (e.g., references).
@@ -8427,7 +8500,7 @@ declare const _JsonSchemaType: Struct<{
8427
8500
  * Typename of this schema.
8428
8501
  * Only on schema representing an ECHO object.
8429
8502
  *
8430
- * @example 'example.com/type/MyType'
8503
+ * @example 'com.example.type.my-type'
8431
8504
  */
8432
8505
  typename: optional<typeof String$>;
8433
8506
  /**
@@ -8606,7 +8679,7 @@ declare const _JsonSchemaType: Struct<{
8606
8679
  interface JsonSchemaType extends Schema.Type<typeof _JsonSchemaType> {}
8607
8680
  declare const JsonSchemaType: Schema<JsonSchemaType>;
8608
8681
  //#endregion
8609
- //#region ../echo/dist/types/src/internal/ref/ref.d.ts
8682
+ //#region ../echo/dist/types/src/internal/Ref/ref.d.ts
8610
8683
  declare const RefTypeId: unique symbol;
8611
8684
  /**
8612
8685
  * Reference Schema.
@@ -8675,6 +8748,15 @@ interface Ref<T$1> extends Pipeable {
8675
8748
  * @returns Promise that will resolves with the target object or undefined if the object is not loaded locally.
8676
8749
  */
8677
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;
8678
8760
  /**
8679
8761
  * Do not inline the target object in the reference.
8680
8762
  * Makes .target unavailable unless the reference is connected to a database context.
@@ -8724,167 +8806,256 @@ interface RefResolver {
8724
8806
  resolveSchema(dxn: DXN): Promise<Schema.AnyNoContext | undefined>;
8725
8807
  }
8726
8808
  //#endregion
8727
- //#region ../echo/dist/types/src/internal/entities/entity.d.ts
8728
- type EchoTypeSchemaProps<T$1, ExtraFields = {}> = Simplify$1<AnyEntity & ToMutable<T$1> & ExtraFields>;
8729
- interface EchoTypeSchema<Self extends Schema.Any, ExtraFields = {}, K$1 extends EntityKind = EntityKind, Fields extends Struct.Fields = Struct.Fields> extends TypeMeta, AnnotableClass<EchoTypeSchema<Self, ExtraFields, K$1, Fields>, EchoTypeSchemaProps<Schema.Type<Self>, ExtraFields>, EchoTypeSchemaProps<Schema.Encoded<Self>, ExtraFields>, Schema.Context<Self>> {
8730
- /**
8731
- * Schema kind key that marks this as an ECHO schema and indicates its kind.
8732
- * Makes EchoTypeSchema satisfy the Type.AnyObj or Type.Relation.Any type.
8733
- */
8734
- readonly [SchemaKindId]: K$1;
8735
- /**
8736
- * The fields defined in the original struct schema.
8737
- * Allows accessing field definitions for introspection.
8738
- */
8739
- readonly fields: Fields;
8740
- instanceOf(value: unknown): boolean;
8741
- }
8742
- declare namespace Filter_d_exports {
8743
- 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 };
8744
- }
8745
- interface Filter<T$1> {
8746
- '~Filter': {
8747
- value: Contravariant<T$1>;
8748
- };
8749
- ast: Filter$1;
8750
- }
8751
- type Props<T$1> = { [K in keyof T$1 & string]?: Filter<T$1[K]> | T$1[K] };
8752
- type Any$3 = Filter<any>;
8753
- type Type$2<F extends Any$3> = F extends Filter<infer T> ? T : never;
8754
- declare class FilterClass implements Any$3 {
8755
- readonly ast: Filter$1;
8756
- private static 'variance';
8757
- constructor(ast: Filter$1);
8758
- '~Filter': {
8759
- value: Contravariant<any>;
8760
- };
8761
- }
8762
- declare const is$1: (value: unknown) => value is Any$3;
8763
- /** Construct a filter from an ast. */
8764
- declare const fromAst$1: (ast: Filter$1) => Any$3;
8765
- /**
8766
- * Filter that matches all objects.
8767
- */
8768
- declare const everything: () => FilterClass;
8769
- /**
8770
- * Filter that matches no objects.
8771
- */
8772
- declare const nothing: () => FilterClass;
8773
- declare const id: (...ids: ObjectId[]) => Any$3;
8774
- /**
8775
- * Filter by type.
8776
- */
8777
- declare const type$2: <S$1 extends Schema.All>(schema: S$1 | string, props?: Props<Schema.Type<S$1>>) => Filter<Schema.Type<S$1>>;
8778
- /**
8779
- * Filter by non-qualified typename.
8780
- */
8781
- declare const typename$1: (typename: string) => Any$3;
8782
- /**
8783
- * Filter by fully qualified type DXN.
8784
- */
8785
- declare const typeDXN: (dxn: DXN) => Any$3;
8786
- /**
8787
- * Filter by tag.
8788
- */
8789
- declare const tag: (tag: string) => Any$3;
8790
- /**
8791
- * Filter by properties.
8792
- */
8793
- declare const props: <T$1>(props: Props<T$1>) => Filter<T$1>;
8794
- type TextSearchOptions = {
8795
- type?: 'full-text' | 'vector';
8796
- };
8797
- /**
8798
- * Full-text or vector search.
8799
- */
8800
- declare const text: (text: string, options?: TextSearchOptions) => Any$3;
8801
- /**
8802
- * Filter by foreign keys.
8803
- */
8804
- declare const foreignKeys: <S$1 extends Schema.All>(schema: S$1 | string, keys: ForeignKey[]) => Filter<Schema.Type<S$1>>;
8805
- /**
8806
- * Predicate for property to be equal to the provided value.
8807
- */
8808
- declare const eq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8809
- /**
8810
- * Predicate for property to be not equal to the provided value.
8811
- */
8812
- declare const neq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8813
- /**
8814
- * Predicate for property to be greater than the provided value.
8815
- */
8816
- declare const gt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8817
- /**
8818
- * Predicate for property to be greater than or equal to the provided value.
8819
- */
8820
- declare const gte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8821
- /**
8822
- * Predicate for property to be less than the provided value.
8823
- */
8824
- declare const lt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8825
- /**
8826
- * Predicate for property to be less than or equal to the provided value.
8827
- */
8828
- declare const lte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8829
- /**
8830
- * Predicate for property to be in the provided array.
8831
- * @param values - Values to check against.
8832
- */
8833
- declare const in$: <T$1>(...values: T$1[]) => Filter<T$1 | undefined>;
8809
+ //#region ../echo/dist/types/src/Ref.d.ts
8834
8810
  /**
8835
- * Predicate for an array property to contain the provided value.
8836
- * @param value - Value to check against.
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
+ * ```
8837
8827
  */
8838
- declare const contains: <T$1>(value: T$1) => Filter<readonly T$1[] | undefined>;
8828
+ type Ref$1<T$1> = Ref<T$1>;
8829
+ type Unknown$2 = Ref<Unknown$1>;
8839
8830
  /**
8840
- * Predicate for property to be in the provided range.
8841
- * @param from - Start of the range (inclusive).
8842
- * @param to - End of the range (exclusive).
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
+ * ```
8843
8840
  */
8844
- declare const between: <T$1>(from: T$1, to: T$1) => Filter<unknown>;
8841
+ declare const Ref$1: <S$1 extends Schema.Any>(schema: S$1) => RefSchema<Schema.Type<S$1>>;
8845
8842
  /**
8846
- * Negate the filter.
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
+ * ```
8847
8855
  */
8848
- declare const not: <F extends Any$3>(filter: F) => Filter<Type$2<F>>;
8856
+ interface RefSchema<T$1 extends Unknown> extends RefSchema$1<T$1> {}
8849
8857
  /**
8850
- * Combine filters with a logical AND.
8858
+ * Extract reference target.
8851
8859
  */
8852
- declare const and: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
8860
+ type Target<R$1 extends Unknown$2> = R$1 extends Ref<infer T> ? T : never;
8853
8861
  /**
8854
- * Combine filters with a logical OR.
8862
+ * Reference resolver.
8855
8863
  */
8856
- declare const or: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
8864
+ type Resolver = RefResolver;
8857
8865
  //#endregion
8858
- //#region ../echo/dist/types/src/Relation.d.ts
8859
- type Endpoints$1<Source, Target$1> = {
8860
- [Source]: Source;
8861
- [Target$1]: Target$1;
8862
- };
8866
+ //#region ../echo/dist/types/src/internal/Obj/typed-object.d.ts
8863
8867
  /**
8864
- * Get relation source type.
8868
+ * Definition for an object type that can be stored in an ECHO database.
8869
+ * Implements effect schema to define object properties.
8870
+ * Has a typename and version.
8871
+ *
8872
+ * In contrast to {@link EchoSchema} this definition is not recorded in the database.
8873
+ *
8874
+ * @deprecated Use `Type.AnyObj` from `@dxos/echo` instead.
8865
8875
  */
8866
- type SourceOf<A$1> = A$1 extends Endpoints$1<infer S, infer _T> ? S : never;
8876
+ interface TypedObject<A$1 = any, I$1 = any> extends TypeMeta, Schema<A$1, I$1> {}
8867
8877
  /**
8868
- * Get relation target type.
8878
+ * Typed object that could be used as a prototype in class definitions.
8879
+ * This is an internal API type.
8880
+ *
8881
+ * @deprecated Use `Type.AnyObj` from `@dxos/echo` instead.
8869
8882
  */
8870
- type TargetOf<A$1> = A$1 extends Endpoints$1<infer _S, infer T> ? T : never;
8883
+ interface TypedObjectPrototype<A$1 = any, I$1 = any> extends TypedObject<A$1, I$1> {
8884
+ /** Type constructor. */
8885
+ new (): AnyEntity & A$1;
8886
+ }
8871
8887
  //#endregion
8872
- //#region ../echo/dist/types/src/Type.d.ts
8888
+ //#region ../echo/dist/types/src/internal/Type/persistent-schema.d.ts
8873
8889
  /**
8874
- * Dynamic type that can be constructed, mutated, and persisted in the ECHO database.
8890
+ * Persistent representation of a schema.
8875
8891
  */
8876
- declare const RuntimeType: typeof EchoSchema;
8892
+ declare const PersistentSchema: EchoObjectSchema<Struct<{
8893
+ name: optional<typeof String$>;
8894
+ typename: refine<string, typeof String$>;
8895
+ version: refine<string, typeof String$>;
8896
+ jsonSchema: Schema<JsonSchemaType, JsonSchemaType, never>;
8897
+ }>, Readonly<{
8898
+ name: optional<typeof String$>;
8899
+ typename: refine<string, typeof String$>;
8900
+ version: refine<string, typeof String$>;
8901
+ jsonSchema: Schema<JsonSchemaType, JsonSchemaType, never>;
8902
+ }>>;
8903
+ interface PersistentSchema extends Schema.Type<typeof PersistentSchema> {}
8904
+ //#endregion
8905
+ //#region ../echo/dist/types/src/internal/Type/echo-schema.d.ts
8877
8906
  /**
8878
- * Dynamic type that can be constructed, mutated, and persisted in the ECHO database.
8907
+ * Base schema type.
8879
8908
  */
8880
- type RuntimeType = EchoSchema;
8909
+ interface BaseSchema<A$1 = any, I$1 = any> extends TypedObject<A$1, I$1> {
8910
+ get readonly(): boolean;
8911
+ get mutable(): EchoSchema<A$1, I$1>;
8912
+ get snapshot(): Schema<A$1, I$1>;
8913
+ get jsonSchema(): JsonSchemaType;
8914
+ }
8915
+ declare const EchoSchema_base: TypedObjectPrototype<any, any>;
8881
8916
  /**
8882
- * Type that marks a schema as an ECHO schema.
8883
- * The value indicates the entity kind (Object or Relation).
8884
- */
8885
- type EchoSchemaKind<K$1 extends EntityKind = EntityKind> = {
8886
- readonly [SchemaKindId]: K$1;
8887
- };
8917
+ * Represents a schema that is persisted in the ECHO database.
8918
+ * Schema can me mutable or readonly (specified by the {@link EchoSchema.readonly} field).
8919
+ *
8920
+ * Schema that can be modified at runtime via the API.
8921
+ * Is an instance of effect-schema (`Schema.Schema.AnyNoContext`) so it can be used in the same way as a regular schema.
8922
+ * IMPORTANT: The schema AST will change reactively when the schema is updated, including synced updates from remote peers.
8923
+ *
8924
+ * The class constructor is a schema instance itself, and can be used in the echo object definitions:
8925
+ *
8926
+ * @example
8927
+ * ```ts
8928
+ * export class TableType extends Schema.Struct({...}).pipe(Type.object({ typename: 'com.example.type.table', version: '0.1.0' })){
8929
+ * title: Schema.String,
8930
+ * schema: Schema.optional(ref(EchoSchema)),
8931
+ * props: Schema.mutable(S.Array(TablePropSchema)),
8932
+ * }) {}
8933
+ * ```
8934
+ *
8935
+ * The ECHO API will translate any references to PersistentSchema objects to be resolved as EchoSchema objects.
8936
+ */
8937
+ declare class EchoSchema<A$1 = any, I$1 = any> extends EchoSchema_base implements BaseSchema<A$1, I$1> {
8938
+ private readonly _persistentSchema;
8939
+ private _schema;
8940
+ private _isDirty;
8941
+ /**
8942
+ * Schema kind key that marks this as an ECHO schema.
8943
+ * Makes EchoSchema satisfy the Type.AnyObj type.
8944
+ */
8945
+ readonly [SchemaKindId]: EntityKind.Object;
8946
+ constructor(_persistentSchema: PersistentSchema);
8947
+ get [TypeId$1](): {
8948
+ _A: (_: any) => any;
8949
+ _I: (_: any) => any;
8950
+ _R: (_: never) => never;
8951
+ };
8952
+ get Type(): A$1;
8953
+ get Encoded(): I$1;
8954
+ get Context(): never;
8955
+ get ast(): AST;
8956
+ get annotations(): (annotations: Annotations.GenericSchema<any>) => Schema<any, any, never>;
8957
+ get pipe(): Schema.AnyNoContext['pipe'];
8958
+ get kind(): EntityKind.Object;
8959
+ get typename(): string;
8960
+ get version(): string;
8961
+ get readonly(): boolean;
8962
+ /**
8963
+ * Returns an immutable schema snapshot of the current state of the schema.
8964
+ */
8965
+ get snapshot(): Schema.AnyNoContext;
8966
+ /**
8967
+ * Returns the JSON schema for the schema.
8968
+ */
8969
+ get jsonSchema(): JsonSchemaType;
8970
+ /**
8971
+ * Returns a mutable schema.
8972
+ */
8973
+ get mutable(): EchoSchema;
8974
+ /**
8975
+ * Id of the ECHO object containing the schema.
8976
+ */
8977
+ get id(): ObjectId;
8978
+ /**
8979
+ * Short name of the schema.
8980
+ */
8981
+ get name(): string | undefined;
8982
+ get [SchemaMetaSymbol](): SchemaMeta;
8983
+ /**
8984
+ * Reference to the underlying persistent schema object.
8985
+ */
8986
+ get persistentSchema(): PersistentType;
8987
+ getProperties(): PropertySignature$1[];
8988
+ /**
8989
+ * @throws Error if the schema is readonly.
8990
+ */
8991
+ updateTypename(typename: string): void;
8992
+ /**
8993
+ * @throws Error if the schema is readonly.
8994
+ */
8995
+ addFields(fields: Struct.Fields): void;
8996
+ /**
8997
+ * @throws Error if the schema is readonly.
8998
+ */
8999
+ updateFields(fields: Struct.Fields): void;
9000
+ /**
9001
+ * @throws Error if the schema is readonly.
9002
+ */
9003
+ updateFieldPropertyName({
9004
+ before,
9005
+ after
9006
+ }: {
9007
+ before: PropertyKey;
9008
+ after: PropertyKey;
9009
+ }): void;
9010
+ /**
9011
+ * @throws Error if the schema is readonly.
9012
+ */
9013
+ removeFields(fieldNames: string[]): void;
9014
+ /**
9015
+ * Wrapper for Obj.update that handles the change context for the persistent schema.
9016
+ */
9017
+ private _change;
9018
+ /**
9019
+ * Called by DatabaseSchemaRegistry on update.
9020
+ */
9021
+ _invalidate(): void;
9022
+ /**
9023
+ * Rebuilds this schema if it is dirty.
9024
+ */
9025
+ _rebuild(): void;
9026
+ _getSchema(): Schema.AnyNoContext;
9027
+ }
9028
+ //#endregion
9029
+ //#region ../echo/dist/types/src/Relation.d.ts
9030
+ type Endpoints$1<Source, Target$1> = {
9031
+ [Source]: Source;
9032
+ [Target$1]: Target$1;
9033
+ };
9034
+ /**
9035
+ * Get relation source type.
9036
+ */
9037
+ type SourceOf<A$1> = A$1 extends Endpoints$1<infer S, infer _T> ? S : never;
9038
+ /**
9039
+ * Get relation target type.
9040
+ */
9041
+ type TargetOf<A$1> = A$1 extends Endpoints$1<infer _S, infer T> ? T : never;
9042
+ //#endregion
9043
+ //#region ../echo/dist/types/src/Type.d.ts
9044
+ /**
9045
+ * Dynamic type that can be constructed, mutated, and persisted in the ECHO database.
9046
+ */
9047
+ declare const RuntimeType: typeof EchoSchema;
9048
+ /**
9049
+ * Dynamic type that can be constructed, mutated, and persisted in the ECHO database.
9050
+ */
9051
+ type RuntimeType = EchoSchema;
9052
+ /**
9053
+ * Type that marks a schema as an ECHO schema.
9054
+ * The value indicates the entity kind (Object or Relation).
9055
+ */
9056
+ type EchoSchemaKind<K$1 extends EntityKind = EntityKind> = {
9057
+ readonly [SchemaKindId]: K$1;
9058
+ };
8888
9059
  /**
8889
9060
  * TypeScript type for an ECHO object schema.
8890
9061
  * `T` is the instance type produced by the schema.
@@ -8962,7 +9133,7 @@ type OfShape<Props$1> = BaseObj & Props$1;
8962
9133
  * NOTE: This is a TypeScript type only, not a schema.
8963
9134
  * To validate that a value is an ECHO object, use `Schema.is(Type.Obj)`.
8964
9135
  */
8965
- interface Unknown$2 extends BaseObj {}
9136
+ interface Unknown$1 extends BaseObj {}
8966
9137
  /**
8967
9138
  * Runtime Effect schema for any ECHO object.
8968
9139
  * Use for validation, parsing, or as a reference target for collections.
@@ -8984,70 +9155,176 @@ interface Unknown$2 extends BaseObj {}
8984
9155
  * }).pipe(Type.object({ typename: 'Collection', version: '0.1.0' }));
8985
9156
  * ```
8986
9157
  */
8987
- declare const Unknown$2: Obj$1<Unknown$2>;
9158
+ declare const Unknown$1: Obj$1<Unknown$1>;
8988
9159
  /**
8989
9160
  * JSON-encoded properties for objects.
8990
9161
  */
8991
9162
  interface BaseObjJson {
8992
9163
  id: string;
8993
9164
  }
8994
- //#endregion
8995
- //#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;
8996
9188
  /**
8997
- * Instance type for a reference.
8998
- *
8999
- * Reference can point to any object or relation.
9000
- * References are lazy loaded.
9001
- *
9002
- * `ref.dxn` is the DXN of the referenced object.
9003
- *
9004
- * @example
9005
- * ```ts
9006
- * const taskRef: Ref<Task> = Ref.make(task);
9007
- *
9008
- * await taskRef.load(); // Returns Promise<Task>
9009
- * yield* Database.load(taskRef); // Effectful version.
9010
- *
9011
- * database.makeRef(dxn); // Create a ref from a DXN.
9012
- * ```
9189
+ * Filter that matches all objects.
9013
9190
  */
9014
- type Ref$1<T$1> = Ref<T$1>;
9015
- type Unknown$1 = Ref<Unknown$2>;
9191
+ declare const everything: () => FilterClass;
9016
9192
  /**
9017
- * Factory function to create a Ref schema for the given target schema.
9018
- * Use this in schema definitions to declare reference fields.
9019
- *
9020
- * @example
9021
- * ```ts
9022
- * const Task = Schema.Struct({
9023
- * assignee: Ref.Ref(Person), // Creates a Ref schema
9024
- * }).pipe(Type.object({ typename: 'Task', version: '0.1.0' }));
9025
- * ```
9193
+ * Filter that matches no objects.
9026
9194
  */
9027
- 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;
9028
9197
  /**
9029
- * TypeScript type for a Ref schema.
9030
- * This is the type of the SCHEMA itself, not the runtime ref instance.
9031
- * 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.
9032
9226
  *
9033
9227
  * @example
9034
9228
  * ```ts
9035
- * // Schema type annotation (rarely needed, usually inferred):
9036
- * const refSchema: Ref.RefSchema<typeof Task> = Ref.Ref(Task);
9037
- *
9038
- * // Instance type annotation (use Ref.Ref instead):
9039
- * 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' });
9040
9231
  * ```
9041
9232
  */
9042
- interface RefSchema<T$1 extends Unknown> extends RefSchema$1<T$1> {}
9233
+ declare const key$1: (key: string, options?: KeyFilterOptions) => Any$3;
9043
9234
  /**
9044
- * Extract reference target.
9235
+ * Filter by properties.
9045
9236
  */
9046
- 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
+ };
9047
9241
  /**
9048
- * Reference resolver.
9242
+ * Full-text or vector search.
9049
9243
  */
9050
- 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;
9051
9328
  //#endregion
9052
9329
  //#region ../echo/dist/types/src/JsonSchema.d.ts
9053
9330
  /**
@@ -9164,7 +9441,7 @@ type Query$1 = {
9164
9441
  * @default false
9165
9442
  *
9166
9443
  * The system schema include but are not limited to:
9167
- * - dxos.org/type/Schema
9444
+ * - org.dxos.type.schema
9168
9445
  */
9169
9446
  includeSystem?: boolean;
9170
9447
  };
@@ -9222,10 +9499,10 @@ interface RefResolutionContext {
9222
9499
  */
9223
9500
  space?: SpaceId;
9224
9501
  /**
9225
- * Queue that the resolution is happening from.
9226
- * 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.
9227
9504
  */
9228
- queue?: DXN;
9505
+ feed?: DXN;
9229
9506
  }
9230
9507
  interface RefResolverOptions {
9231
9508
  /**
@@ -9240,7 +9517,7 @@ interface RefResolverOptions {
9240
9517
  middleware?: (obj: AnyProperties) => AnyProperties;
9241
9518
  }
9242
9519
  /**
9243
- *
9520
+ * Manages cross-space database interactions.
9244
9521
  */
9245
9522
  interface Hypergraph extends Queryable {
9246
9523
  get schemaRegistry(): SchemaRegistry;
@@ -9263,6 +9540,11 @@ interface Hypergraph extends Queryable {
9263
9540
  * @returns Result of `onLoad`.
9264
9541
  */
9265
9542
  createRefResolver(options: RefResolverOptions): Resolver;
9543
+ /**
9544
+ * Get a database by space ID.
9545
+ * @returns The database for the given space ID, or undefined if not found.
9546
+ */
9547
+ getDatabase(spaceId: SpaceId): Database | undefined;
9266
9548
  }
9267
9549
  //#endregion
9268
9550
  //#region ../echo/dist/types/src/Collection.d.ts
@@ -9271,7 +9553,7 @@ interface Hypergraph extends Queryable {
9271
9553
  */
9272
9554
  declare const Collection: Obj$1<{
9273
9555
  readonly name?: string | undefined;
9274
- readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$2>[];
9556
+ readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$1>[];
9275
9557
  }, Struct.Fields>;
9276
9558
  interface Collection extends Schema.Type<typeof Collection> {}
9277
9559
  //#endregion
@@ -9281,12 +9563,13 @@ interface Collection extends Schema.Type<typeof Collection> {}
9281
9563
  *
9282
9564
  * @example
9283
9565
  * ```ts
9284
- * const feed = Obj.make(Feed.Feed, { name: 'notifications', kind: 'dxos.org/plugin/notifications/v1' });
9566
+ * const feed = Obj.make(Feed.Feed, { name: 'notifications', kind: 'org.dxos.plugin.notifications.v1' });
9285
9567
  * ```
9286
9568
  */
9287
9569
  declare const Feed: Obj$1<{
9288
- readonly kind?: string | undefined;
9289
9570
  readonly name?: string | undefined;
9571
+ readonly kind?: string | undefined;
9572
+ readonly namespace?: "data" | "trace" | undefined;
9290
9573
  }, Struct.Fields>;
9291
9574
  /**
9292
9575
  * TypeScript instance type for a Feed object.
@@ -9300,8 +9583,8 @@ interface Feed extends Schema.Type<typeof Feed> {}
9300
9583
  */
9301
9584
  declare const ViewSchema: Obj$1<{
9302
9585
  readonly query: {
9303
- readonly ast: QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause;
9304
9586
  readonly raw?: string | undefined;
9587
+ readonly ast: QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause;
9305
9588
  };
9306
9589
  readonly projection: {
9307
9590
  readonly schema?: JsonSchemaType | undefined;
@@ -9325,11 +9608,12 @@ declare const View: Obj$1<View>;
9325
9608
  * Abstart set of objects, represented by a view, feed, or collection.
9326
9609
  */
9327
9610
  declare const Dataset: Union<[Obj$1<{
9328
- readonly kind?: string | undefined;
9329
9611
  readonly name?: string | undefined;
9612
+ readonly kind?: string | undefined;
9613
+ readonly namespace?: "data" | "trace" | undefined;
9330
9614
  }, Struct.Fields>, Obj$1<{
9331
9615
  readonly name?: string | undefined;
9332
- readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$2>[];
9616
+ readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$1>[];
9333
9617
  }, Struct.Fields>, Obj$1<View, Struct.Fields>]>;
9334
9618
  type Dataset = Feed | Collection | View;
9335
9619
  declare namespace Order_d_exports {
@@ -9350,7 +9634,7 @@ declare const property: <T$1>(property: keyof T$1 & string, direction: OrderDire
9350
9634
  */
9351
9635
  declare const rank: <T$1>(direction?: OrderDirection) => Order<T$1>;
9352
9636
  declare namespace Query_d_exports {
9353
- 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 };
9354
9638
  }
9355
9639
  /**
9356
9640
  * All property paths inside T that are references.
@@ -9373,7 +9657,7 @@ interface Query<T$1> {
9373
9657
  * @param key - Property path inside T that is a reference or optional reference.
9374
9658
  * @returns Query for the target of the reference.
9375
9659
  */
9376
- '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>;
9377
9661
  /**
9378
9662
  * Find objects referencing this object.
9379
9663
  * @param target - Schema of the referencing object. If not provided, matches any type.
@@ -9498,6 +9782,10 @@ interface Query<T$1> {
9498
9782
  * Add options to a query.
9499
9783
  */
9500
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>;
9501
9789
  }
9502
9790
  type Any$1 = Query<any>;
9503
9791
  type Type$1<Q extends Any$1> = Q extends Query<infer T> ? T : never;
@@ -9518,7 +9806,10 @@ declare const select: <F extends Any$3>(filter: F) => Query<Type$2<F>>;
9518
9806
  *
9519
9807
  * Shorthand for: `Query.select(Filter.type(schema, predicates))`.
9520
9808
  */
9521
- 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
+ };
9522
9813
  /**
9523
9814
  * Combine results of multiple queries.
9524
9815
  * @param queries - Queries to combine.
@@ -9539,9 +9830,13 @@ declare const without: <T$1>(source: Query<T$1>, exclude: Query<T$1>) => Query<T
9539
9830
  * @param source - Data source: database, feed, 'all-accessible-spaces', or another query.
9540
9831
  * @returns Query scoped to the given source.
9541
9832
  */
9542
- 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?: {
9543
9834
  includeFeeds?: boolean;
9544
9835
  }) => Any$1;
9836
+ /**
9837
+ * Returns a human-readable string representation of a Query AST.
9838
+ */
9839
+ declare const pretty: (query: Any$1) => string;
9545
9840
  //#endregion
9546
9841
  //#region ../echo/dist/types/src/Database.d.ts
9547
9842
  /**
@@ -9552,7 +9847,7 @@ interface QueryFn {
9552
9847
  <F extends Any$3>(filter: F): QueryResult<Type$2<F>>;
9553
9848
  }
9554
9849
  /**
9555
- * Common interface for Database and Queue.
9850
+ * Common interface for Database, Feed, and Hypergraph.
9556
9851
  */
9557
9852
  interface Queryable {
9558
9853
  query: QueryFn;
@@ -9580,7 +9875,7 @@ type FlushOptions = {
9580
9875
  disk?: boolean;
9581
9876
  /**
9582
9877
  * Wait for pending index updates.
9583
- * @default false
9878
+ * @default true
9584
9879
  */
9585
9880
  indexes?: boolean;
9586
9881
  /**
@@ -9606,7 +9901,7 @@ interface Database extends Queryable {
9606
9901
  /**
9607
9902
  * Return object by local ID.
9608
9903
  */
9609
- 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;
9610
9905
  /**
9611
9906
  * Query objects.
9612
9907
  */
@@ -9636,7 +9931,7 @@ interface Database extends Queryable {
9636
9931
  }
9637
9932
  declare const Database: Schema<Database>;
9638
9933
  //#endregion
9639
- //#region ../echo/dist/types/src/internal/entities/object.d.ts
9934
+ //#region ../echo/dist/types/src/internal/Entity/object.d.ts
9640
9935
  /**
9641
9936
  * Object schema type with kind marker.
9642
9937
  */
@@ -9651,169 +9946,6 @@ declare const EchoObjectSchema: {
9651
9946
  }) => EchoObjectSchema<Self, Fields>;
9652
9947
  };
9653
9948
  //#endregion
9654
- //#region ../echo/dist/types/src/internal/object/typed-object.d.ts
9655
- /**
9656
- * Definition for an object type that can be stored in an ECHO database.
9657
- * Implements effect schema to define object properties.
9658
- * Has a typename and version.
9659
- *
9660
- * In contrast to {@link EchoSchema} this definition is not recorded in the database.
9661
- *
9662
- * @deprecated Use `Type.AnyObj` from `@dxos/echo` instead.
9663
- */
9664
- interface TypedObject<A$1 = any, I$1 = any> extends TypeMeta, Schema<A$1, I$1> {}
9665
- /**
9666
- * Typed object that could be used as a prototype in class definitions.
9667
- * This is an internal API type.
9668
- *
9669
- * @deprecated Use `Type.AnyObj` from `@dxos/echo` instead.
9670
- */
9671
- interface TypedObjectPrototype<A$1 = any, I$1 = any> extends TypedObject<A$1, I$1> {
9672
- /** Type constructor. */
9673
- new (): AnyEntity & A$1;
9674
- }
9675
- //#endregion
9676
- //#region ../echo/dist/types/src/internal/schema/persistent-schema.d.ts
9677
- /**
9678
- * Persistent representation of a schema.
9679
- */
9680
- declare const PersistentSchema: EchoObjectSchema<Struct<{
9681
- name: optional<typeof String$>;
9682
- typename: refine<string, typeof String$>;
9683
- version: refine<string, typeof String$>;
9684
- jsonSchema: Schema<JsonSchemaType, JsonSchemaType, never>;
9685
- }>, Readonly<{
9686
- name: optional<typeof String$>;
9687
- typename: refine<string, typeof String$>;
9688
- version: refine<string, typeof String$>;
9689
- jsonSchema: Schema<JsonSchemaType, JsonSchemaType, never>;
9690
- }>>;
9691
- interface PersistentSchema extends Schema.Type<typeof PersistentSchema> {}
9692
- //#endregion
9693
- //#region ../echo/dist/types/src/internal/schema/echo-schema.d.ts
9694
- /**
9695
- * Base schema type.
9696
- */
9697
- interface BaseSchema<A$1 = any, I$1 = any> extends TypedObject<A$1, I$1> {
9698
- get readonly(): boolean;
9699
- get mutable(): EchoSchema<A$1, I$1>;
9700
- get snapshot(): Schema<A$1, I$1>;
9701
- get jsonSchema(): JsonSchemaType;
9702
- }
9703
- declare const EchoSchema_base: TypedObjectPrototype<any, any>;
9704
- /**
9705
- * Represents a schema that is persisted in the ECHO database.
9706
- * Schema can me mutable or readonly (specified by the {@link EchoSchema.readonly} field).
9707
- *
9708
- * Schema that can be modified at runtime via the API.
9709
- * Is an instance of effect-schema (`Schema.Schema.AnyNoContext`) so it can be used in the same way as a regular schema.
9710
- * IMPORTANT: The schema AST will change reactively when the schema is updated, including synced updates from remote peers.
9711
- *
9712
- * The class constructor is a schema instance itself, and can be used in the echo object definitions:
9713
- *
9714
- * @example
9715
- * ```ts
9716
- * export class TableType extends Schema.Struct({...}).pipe(Type.object({ typename: 'example.org/type/Table', version: '0.1.0' })){
9717
- * title: Schema.String,
9718
- * schema: Schema.optional(ref(EchoSchema)),
9719
- * props: Schema.mutable(S.Array(TablePropSchema)),
9720
- * }) {}
9721
- * ```
9722
- *
9723
- * The ECHO API will translate any references to PersistentSchema objects to be resolved as EchoSchema objects.
9724
- */
9725
- declare class EchoSchema<A$1 = any, I$1 = any> extends EchoSchema_base implements BaseSchema<A$1, I$1> {
9726
- private readonly _persistentSchema;
9727
- private _schema;
9728
- private _isDirty;
9729
- /**
9730
- * Schema kind key that marks this as an ECHO schema.
9731
- * Makes EchoSchema satisfy the Type.AnyObj type.
9732
- */
9733
- readonly [SchemaKindId]: EntityKind.Object;
9734
- constructor(_persistentSchema: PersistentSchema);
9735
- get [TypeId$1](): {
9736
- _A: (_: any) => any;
9737
- _I: (_: any) => any;
9738
- _R: (_: never) => never;
9739
- };
9740
- get Type(): A$1;
9741
- get Encoded(): I$1;
9742
- get Context(): never;
9743
- get ast(): AST;
9744
- get annotations(): (annotations: Annotations.GenericSchema<any>) => Schema<any, any, never>;
9745
- get pipe(): Schema.AnyNoContext['pipe'];
9746
- get kind(): EntityKind.Object;
9747
- get typename(): string;
9748
- get version(): string;
9749
- get readonly(): boolean;
9750
- /**
9751
- * Returns an immutable schema snapshot of the current state of the schema.
9752
- */
9753
- get snapshot(): Schema.AnyNoContext;
9754
- /**
9755
- * Returns the JSON schema for the schema.
9756
- */
9757
- get jsonSchema(): JsonSchemaType;
9758
- /**
9759
- * Returns a mutable schema.
9760
- */
9761
- get mutable(): EchoSchema;
9762
- /**
9763
- * Id of the ECHO object containing the schema.
9764
- */
9765
- get id(): ObjectId;
9766
- /**
9767
- * Short name of the schema.
9768
- */
9769
- get name(): string | undefined;
9770
- get [SchemaMetaSymbol](): SchemaMeta;
9771
- /**
9772
- * Reference to the underlying persistent schema object.
9773
- */
9774
- get persistentSchema(): PersistentType;
9775
- getProperties(): PropertySignature$1[];
9776
- /**
9777
- * @throws Error if the schema is readonly.
9778
- */
9779
- updateTypename(typename: string): void;
9780
- /**
9781
- * @throws Error if the schema is readonly.
9782
- */
9783
- addFields(fields: Struct.Fields): void;
9784
- /**
9785
- * @throws Error if the schema is readonly.
9786
- */
9787
- updateFields(fields: Struct.Fields): void;
9788
- /**
9789
- * @throws Error if the schema is readonly.
9790
- */
9791
- updateFieldPropertyName({
9792
- before,
9793
- after
9794
- }: {
9795
- before: PropertyKey;
9796
- after: PropertyKey;
9797
- }): void;
9798
- /**
9799
- * @throws Error if the schema is readonly.
9800
- */
9801
- removeFields(fieldNames: string[]): void;
9802
- /**
9803
- * Wrapper for Obj.change that handles the change context for the persistent schema.
9804
- */
9805
- private _change;
9806
- /**
9807
- * Called by DatabaseSchemaRegistry on update.
9808
- */
9809
- _invalidate(): void;
9810
- /**
9811
- * Rebuilds this schema if it is dirty.
9812
- */
9813
- _rebuild(): void;
9814
- _getSchema(): Schema.AnyNoContext;
9815
- }
9816
- //#endregion
9817
9949
  //#region ../echo/dist/types/src/Entity.d.ts
9818
9950
  declare const KindId$1: "~@dxos/echo/Kind";
9819
9951
  type KindId$1 = typeof KindId;
@@ -9832,7 +9964,7 @@ interface OfKind<K$1 extends Kind> {
9832
9964
  */
9833
9965
  interface Unknown extends OfKind<Kind> {}
9834
9966
  //#endregion
9835
- //#region ../echo/dist/types/src/internal/types/base.d.ts
9967
+ //#region ../echo/dist/types/src/internal/common/types/base.d.ts
9836
9968
  /**
9837
9969
  * Base type for all data objects (reactive, ECHO, and other raw objects).
9838
9970
  * NOTE: This describes the base type for all database objects.
@@ -9847,17 +9979,17 @@ interface AnyEntity {
9847
9979
  readonly id: ObjectId;
9848
9980
  }
9849
9981
  //#endregion
9850
- //#region ../echo/dist/types/src/internal/types/entity.d.ts
9982
+ //#region ../echo/dist/types/src/internal/common/types/entity.d.ts
9851
9983
  /**
9852
9984
  * String key used to identify the kind of an entity instance (object or relation).
9853
9985
  */
9854
- declare const KindId: "~@dxos/echo/Kind";
9986
+ declare const KindId: '~@dxos/echo/Kind';
9855
9987
  type KindId = typeof KindId;
9856
9988
  /**
9857
9989
  * String key used to identify the kind of a schema (object schema or relation schema).
9858
9990
  * Parallels KindId which identifies instance kinds.
9859
9991
  */
9860
- declare const SchemaKindId: "~@dxos/echo/SchemaKind";
9992
+ declare const SchemaKindId: '~@dxos/echo/SchemaKind';
9861
9993
  type SchemaKindId = typeof SchemaKindId;
9862
9994
  /**
9863
9995
  * Kinds of entities stored in ECHO: objects and relations.
@@ -9867,7 +9999,7 @@ declare enum EntityKind {
9867
9999
  Relation = "relation",
9868
10000
  }
9869
10001
  //#endregion
9870
- //#region ../echo/dist/types/src/internal/annotations/annotations.d.ts
10002
+ //#region ../echo/dist/types/src/internal/Annotation/annotations.d.ts
9871
10003
  declare const TypeMeta: Struct<{
9872
10004
  typename: refine<string, typeof String$>;
9873
10005
  version: refine<string, typeof String$>;