@dxos/echo-query 0.8.4-main.9be5663bfe → 0.8.4-main.abd8ff62ef

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.
@@ -8034,7 +8034,7 @@ declare const FilterObject_: Struct<{
8034
8034
  * Filter by property.
8035
8035
  * Must not include object ID.
8036
8036
  */
8037
- props: Record$<SchemaClass<string, string, never>, suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, never>>;
8037
+ 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
8038
  /**
8039
8039
  * Objects that have any of the given foreign keys.
8040
8040
  */
@@ -8126,7 +8126,7 @@ declare const FilterTextSearch: Schema<FilterTextSearch>;
8126
8126
  */
8127
8127
  declare const FilterNot_: Struct<{
8128
8128
  type: Literal<["not"]>;
8129
- filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, never>;
8129
+ 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>;
8130
8130
  }>;
8131
8131
  interface FilterNot extends Schema.Type<typeof FilterNot_> {}
8132
8132
  declare const FilterNot: Schema<FilterNot>;
@@ -8135,7 +8135,7 @@ declare const FilterNot: Schema<FilterNot>;
8135
8135
  */
8136
8136
  declare const FilterAnd_: Struct<{
8137
8137
  type: Literal<["and"]>;
8138
- filters: Array$<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, never>>;
8138
+ 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>>;
8139
8139
  }>;
8140
8140
  interface FilterAnd extends Schema.Type<typeof FilterAnd_> {}
8141
8141
  declare const FilterAnd: Schema<FilterAnd>;
@@ -8144,7 +8144,7 @@ declare const FilterAnd: Schema<FilterAnd>;
8144
8144
  */
8145
8145
  declare const FilterOr_: Struct<{
8146
8146
  type: Literal<["or"]>;
8147
- filters: Array$<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, never>>;
8147
+ 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>>;
8148
8148
  }>;
8149
8149
  interface FilterOr extends Schema.Type<typeof FilterOr_> {}
8150
8150
  declare const FilterOr: Schema<FilterOr>;
@@ -8171,7 +8171,7 @@ type Filter$1 = Schema.Type<typeof Filter$1>;
8171
8171
  */
8172
8172
  declare const QuerySelectClause_: Struct<{
8173
8173
  type: Literal<["select"]>;
8174
- filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, never>;
8174
+ 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>;
8175
8175
  }>;
8176
8176
  interface QuerySelectClause extends Schema.Type<typeof QuerySelectClause_> {}
8177
8177
  declare const QuerySelectClause: Schema<QuerySelectClause>;
@@ -8180,8 +8180,8 @@ declare const QuerySelectClause: Schema<QuerySelectClause>;
8180
8180
  */
8181
8181
  declare const QueryFilterClause_: Struct<{
8182
8182
  type: Literal<["filter"]>;
8183
- 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>;
8184
- filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, never>;
8183
+ 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>;
8184
+ 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>;
8185
8185
  }>;
8186
8186
  interface QueryFilterClause extends Schema.Type<typeof QueryFilterClause_> {}
8187
8187
  declare const QueryFilterClause: Schema<QueryFilterClause>;
@@ -8190,7 +8190,7 @@ declare const QueryFilterClause: Schema<QueryFilterClause>;
8190
8190
  */
8191
8191
  declare const QueryReferenceTraversalClause_: Struct<{
8192
8192
  type: Literal<["reference-traversal"]>;
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>;
8193
+ 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
8194
  property: typeof String$;
8195
8195
  }>;
8196
8196
  interface QueryReferenceTraversalClause extends Schema.Type<typeof QueryReferenceTraversalClause_> {}
@@ -8200,7 +8200,7 @@ declare const QueryReferenceTraversalClause: Schema<QueryReferenceTraversalClaus
8200
8200
  */
8201
8201
  declare const QueryIncomingReferencesClause_: Struct<{
8202
8202
  type: Literal<["incoming-references"]>;
8203
- 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>;
8203
+ 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>;
8204
8204
  /**
8205
8205
  * Property path where the reference is located.
8206
8206
  * If null, matches references from any property.
@@ -8215,14 +8215,14 @@ declare const QueryIncomingReferencesClause: Schema<QueryIncomingReferencesClaus
8215
8215
  */
8216
8216
  declare const QueryRelationClause_: Struct<{
8217
8217
  type: Literal<["relation"]>;
8218
- 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>;
8218
+ 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>;
8219
8219
  /**
8220
8220
  * outgoing: anchor is the source of the relation.
8221
8221
  * incoming: anchor is the target of the relation.
8222
8222
  * both: anchor is either the source or target of the relation.
8223
8223
  */
8224
8224
  direction: Literal<["outgoing", "incoming", "both"]>;
8225
- filter: optional<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterChildOf | FilterNot | FilterAnd | FilterOr, never>>;
8225
+ 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>>;
8226
8226
  }>;
8227
8227
  interface QueryRelationClause extends Schema.Type<typeof QueryRelationClause_> {}
8228
8228
  declare const QueryRelationClause: Schema<QueryRelationClause>;
@@ -8231,7 +8231,7 @@ declare const QueryRelationClause: Schema<QueryRelationClause>;
8231
8231
  */
8232
8232
  declare const QueryRelationTraversalClause_: Struct<{
8233
8233
  type: Literal<["relation-traversal"]>;
8234
- 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>;
8234
+ 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>;
8235
8235
  direction: Literal<["source", "target", "both"]>;
8236
8236
  }>;
8237
8237
  interface QueryRelationTraversalClause extends Schema.Type<typeof QueryRelationTraversalClause_> {}
@@ -8241,7 +8241,7 @@ declare const QueryRelationTraversalClause: Schema<QueryRelationTraversalClause>
8241
8241
  */
8242
8242
  declare const QueryHierarchyTraversalClause_: Struct<{
8243
8243
  type: Literal<["hierarchy-traversal"]>;
8244
- 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>;
8245
8245
  /**
8246
8246
  * to-parent: traverse from child to parent.
8247
8247
  * to-children: traverse from parent to children.
@@ -8255,7 +8255,7 @@ declare const QueryHierarchyTraversalClause: Schema<QueryHierarchyTraversalClaus
8255
8255
  */
8256
8256
  declare const QueryUnionClause_: Struct<{
8257
8257
  type: Literal<["union"]>;
8258
- 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>>;
8258
+ 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>>;
8259
8259
  }>;
8260
8260
  interface QueryUnionClause extends Schema.Type<typeof QueryUnionClause_> {}
8261
8261
  declare const QueryUnionClause: Schema<QueryUnionClause>;
@@ -8264,8 +8264,8 @@ declare const QueryUnionClause: Schema<QueryUnionClause>;
8264
8264
  */
8265
8265
  declare const QuerySetDifferenceClause_: Struct<{
8266
8266
  type: Literal<["set-difference"]>;
8267
- 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>;
8268
- 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>;
8267
+ 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>;
8268
+ 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>;
8269
8269
  }>;
8270
8270
  interface QuerySetDifferenceClause extends Schema.Type<typeof QuerySetDifferenceClause_> {}
8271
8271
  declare const QuerySetDifferenceClause: Schema<QuerySetDifferenceClause>;
@@ -8289,7 +8289,7 @@ declare const Order$1: Schema<Order$1>;
8289
8289
  */
8290
8290
  declare const QueryOrderClause_: Struct<{
8291
8291
  type: Literal<["order"]>;
8292
- 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>;
8292
+ 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>;
8293
8293
  order: Array$<Schema<{
8294
8294
  readonly kind: "natural";
8295
8295
  } | {
@@ -8317,11 +8317,13 @@ declare const QueryOrderClause: Schema<QueryOrderClause>;
8317
8317
  */
8318
8318
  declare const QueryOptionsClause_: Struct<{
8319
8319
  type: Literal<["options"]>;
8320
- 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>;
8320
+ 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>;
8321
8321
  options: suspend<{
8322
- readonly deleted?: "include" | "exclude" | "only" | undefined;
8322
+ readonly deleted?: "exclude" | "include" | "only" | undefined;
8323
+ readonly debugLabel?: string | undefined;
8323
8324
  }, {
8324
- readonly deleted?: "include" | "exclude" | "only" | undefined;
8325
+ readonly debugLabel?: string | undefined;
8326
+ readonly deleted?: "exclude" | "include" | "only" | undefined;
8325
8327
  }, never>;
8326
8328
  }>;
8327
8329
  interface QueryOptionsClause extends Schema.Type<typeof QueryOptionsClause_> {}
@@ -8331,26 +8333,26 @@ declare const QueryOptionsClause: Schema<QueryOptionsClause>;
8331
8333
  */
8332
8334
  declare const QueryLimitClause_: Struct<{
8333
8335
  type: Literal<["limit"]>;
8334
- 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>;
8336
+ 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>;
8335
8337
  limit: typeof Number$;
8336
8338
  }>;
8337
8339
  interface QueryLimitClause extends Schema.Type<typeof QueryLimitClause_> {}
8338
8340
  declare const QueryLimitClause: Schema<QueryLimitClause>;
8339
8341
  declare const QueryFromClause_: Struct<{
8340
8342
  type: Literal<["from"]>;
8341
- 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>;
8343
+ 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>;
8342
8344
  from: Union<[TaggedStruct<"scope", {
8343
8345
  scope: suspend<{
8344
8346
  readonly spaceIds?: readonly string[] | undefined;
8345
8347
  readonly allQueuesFromSpaces?: boolean | undefined;
8346
8348
  readonly queues?: readonly string[] | undefined;
8347
8349
  }, {
8348
- readonly spaceIds?: readonly string[] | undefined;
8349
8350
  readonly allQueuesFromSpaces?: boolean | undefined;
8350
8351
  readonly queues?: readonly string[] | undefined;
8352
+ readonly spaceIds?: readonly string[] | undefined;
8351
8353
  }, never>;
8352
8354
  }>, TaggedStruct<"query", {
8353
- 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>;
8355
+ 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>;
8354
8356
  }>]>;
8355
8357
  }>;
8356
8358
  interface QueryFromClause extends Schema.Type<typeof QueryFromClause_> {}
@@ -8363,6 +8365,10 @@ declare const QueryOptions: Struct<{
8363
8365
  * Nested select statements will use this option to filter deleted objects.
8364
8366
  */
8365
8367
  deleted: optional<Literal<["include", "exclude", "only"]>>;
8368
+ /**
8369
+ * Diagnostics-only label for logs / tooling (not used by execution semantics).
8370
+ */
8371
+ debugLabel: optional<typeof String$>;
8366
8372
  }>;
8367
8373
  interface QueryOptions extends Schema.Type<typeof QueryOptions> {}
8368
8374
  /**
@@ -8434,147 +8440,6 @@ interface EchoTypeSchema<Self extends Schema.Any, ExtraFields = {}, K$1 extends
8434
8440
  readonly fields: Fields;
8435
8441
  instanceOf(value: unknown): boolean;
8436
8442
  }
8437
- declare namespace Filter_d_exports {
8438
- export { Any$3 as Any, ChildOfOptions, Filter, 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, lt, lte, neq, not, nothing, or, pretty$1 as pretty, props, tag, text, type$2 as type, typeDXN, typename$1 as typename, updated };
8439
- }
8440
- interface Filter<T$1> {
8441
- '~Filter': {
8442
- value: Covariant<T$1>;
8443
- };
8444
- ast: Filter$1;
8445
- }
8446
- type Props<T$1> = { [K in keyof T$1 & string]?: Filter<T$1[K]> | T$1[K] };
8447
- type Any$3 = Filter<any>;
8448
- type Type$2<F extends Any$3> = F extends Filter<infer T> ? T : never;
8449
- declare class FilterClass implements Any$3 {
8450
- readonly ast: Filter$1;
8451
- private static 'variance';
8452
- constructor(ast: Filter$1);
8453
- '~Filter': {
8454
- value: Covariant<any>;
8455
- };
8456
- }
8457
- declare const is$1: (value: unknown) => value is Any$3;
8458
- /** Construct a filter from an ast. */
8459
- declare const fromAst$1: (ast: Filter$1) => Any$3;
8460
- /**
8461
- * Filter that matches all objects.
8462
- */
8463
- declare const everything: () => FilterClass;
8464
- /**
8465
- * Filter that matches no objects.
8466
- */
8467
- declare const nothing: () => FilterClass;
8468
- declare const id: (...ids: ObjectId[]) => Any$3;
8469
- /**
8470
- * Filter by type.
8471
- */
8472
- declare const type$2: <S$1 extends Schema.All>(schema: S$1 | string, props?: Props<Schema.Type<S$1>>) => Filter<Schema.Type<S$1>>;
8473
- /**
8474
- * Filter by non-qualified typename.
8475
- */
8476
- declare const typename$1: (typename: string) => Any$3;
8477
- /**
8478
- * Filter by fully qualified type DXN.
8479
- */
8480
- declare const typeDXN: (dxn: DXN) => Any$3;
8481
- /**
8482
- * Filter by tag.
8483
- */
8484
- declare const tag: (tag: string) => Any$3;
8485
- /**
8486
- * Filter by properties.
8487
- */
8488
- declare const props: <T$1>(props: Props<T$1>) => Filter<T$1>;
8489
- type TextSearchOptions = {
8490
- type?: 'full-text' | 'vector';
8491
- };
8492
- /**
8493
- * Full-text or vector search.
8494
- */
8495
- declare const text: (text: string, options?: TextSearchOptions) => Any$3;
8496
- /**
8497
- * Filter by foreign keys.
8498
- */
8499
- declare const foreignKeys: <S$1 extends Schema.All>(schema: S$1 | string, keys: ForeignKey[]) => Filter<Schema.Type<S$1>>;
8500
- /**
8501
- * Predicate for property to be equal to the provided value.
8502
- */
8503
- declare const eq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8504
- /**
8505
- * Predicate for property to be not equal to the provided value.
8506
- */
8507
- declare const neq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8508
- /**
8509
- * Predicate for property to be greater than the provided value.
8510
- */
8511
- declare const gt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8512
- /**
8513
- * Predicate for property to be greater than or equal to the provided value.
8514
- */
8515
- declare const gte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8516
- /**
8517
- * Predicate for property to be less than the provided value.
8518
- */
8519
- declare const lt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8520
- /**
8521
- * Predicate for property to be less than or equal to the provided value.
8522
- */
8523
- declare const lte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
8524
- /**
8525
- * Predicate for property to be in the provided array.
8526
- * @param values - Values to check against.
8527
- */
8528
- declare const in$: <T$1>(...values: T$1[]) => Filter<T$1>;
8529
- /**
8530
- * Predicate for an array property to contain the provided value.
8531
- * @param value - Value to check against.
8532
- */
8533
- declare const contains: <T$1>(value: T$1) => Filter<readonly T$1[] | undefined>;
8534
- /**
8535
- * Predicate for property to be in the provided range.
8536
- * @param from - Start of the range (inclusive).
8537
- * @param to - End of the range (exclusive).
8538
- */
8539
- declare const between: <T$1>(from: T$1, to: T$1) => Filter<T$1>;
8540
- type TimeRange = {
8541
- after?: Date | number;
8542
- before?: Date | number;
8543
- };
8544
- /**
8545
- * Filter objects by updatedAt timestamp.
8546
- */
8547
- declare const updated: (range: TimeRange) => Any$3;
8548
- /**
8549
- * Filter objects by createdAt timestamp.
8550
- */
8551
- declare const created: (range: TimeRange) => Any$3;
8552
- type ChildOfOptions = {
8553
- /** Whether to match transitively (grandchildren, etc.). Defaults to true. */
8554
- transitive?: boolean;
8555
- };
8556
- /**
8557
- * Filter objects that are children of the specified parent(s).
8558
- * Accepts ECHO objects, DXN values, or arrays of either.
8559
- * With transitive=true (default), also matches grandchildren and beyond.
8560
- */
8561
- declare const childOf: (parents: Unknown | DXN | (Unknown | DXN)[], options?: ChildOfOptions) => Any$3;
8562
- /**
8563
- * Negate the filter.
8564
- */
8565
- declare const not: <F extends Any$3>(filter: F) => Filter<Type$2<F>>;
8566
- /**
8567
- * Combine filters with a logical AND.
8568
- */
8569
- declare const and: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
8570
- /**
8571
- * Combine filters with a logical OR.
8572
- */
8573
- declare const or: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
8574
- /**
8575
- * Returns a human-readable string representation of a Filter AST.
8576
- */
8577
- declare const pretty$1: (filter: Any$3) => string;
8578
8443
  //#endregion
8579
8444
  //#region ../echo/dist/types/src/internal/JsonSchema/json-schema-type.d.ts
8580
8445
  /**
@@ -8702,7 +8567,7 @@ declare const _JsonSchemaType: Struct<{
8702
8567
  patternProperties: optional<Record$<typeof String$, suspend<JsonSchemaType, JsonSchemaType, never>>>;
8703
8568
  propertyNames: optional<suspend<JsonSchemaType, JsonSchemaType, never>>;
8704
8569
  definitions: optional<Record$<typeof String$, suspend<JsonSchemaType, JsonSchemaType, never>>>;
8705
- dependencies: optional<Record$<typeof String$, suspend<string | readonly string[] | JsonSchemaType, string | readonly string[] | JsonSchemaType, never>>>;
8570
+ dependencies: optional<Record$<typeof String$, suspend<string | JsonSchemaType | readonly string[], string | JsonSchemaType | readonly string[], never>>>;
8706
8571
  contentMediaType: optional<typeof String$>;
8707
8572
  contentEncoding: optional<typeof String$>;
8708
8573
  if: optional<suspend<JsonSchemaType, JsonSchemaType, never>>;
@@ -8857,6 +8722,15 @@ interface Ref<T$1> extends Pipeable {
8857
8722
  * @returns Promise that will resolves with the target object or undefined if the object is not loaded locally.
8858
8723
  */
8859
8724
  tryLoad(): Promise<T$1 | undefined>;
8725
+ /**
8726
+ * Subscribe to the ref's resolution event.
8727
+ * The callback fires when the target object becomes available in the working set
8728
+ * (e.g. when its document is loaded after sibling-client mutation).
8729
+ * Note: the resolver only schedules a notification when the target is requested
8730
+ * via {@link target} while it is not yet loaded.
8731
+ * @returns Function that unsubscribes the callback.
8732
+ */
8733
+ onResolved(callback: () => void): () => void;
8860
8734
  /**
8861
8735
  * Do not inline the target object in the reference.
8862
8736
  * Makes .target unavailable unless the reference is connected to a database context.
@@ -8906,6 +8780,63 @@ interface RefResolver {
8906
8780
  resolveSchema(dxn: DXN): Promise<Schema.AnyNoContext | undefined>;
8907
8781
  }
8908
8782
  //#endregion
8783
+ //#region ../echo/dist/types/src/Ref.d.ts
8784
+ /**
8785
+ * Instance type for a reference.
8786
+ *
8787
+ * Reference can point to any object or relation.
8788
+ * References are lazy loaded.
8789
+ *
8790
+ * `ref.dxn` is the DXN of the referenced object.
8791
+ *
8792
+ * @example
8793
+ * ```ts
8794
+ * const taskRef: Ref<Task> = Ref.make(task);
8795
+ *
8796
+ * await taskRef.load(); // Returns Promise<Task>
8797
+ * yield* Database.load(taskRef); // Effectful version.
8798
+ *
8799
+ * database.makeRef(dxn); // Create a ref from a DXN.
8800
+ * ```
8801
+ */
8802
+ type Ref$1<T$1> = Ref<T$1>;
8803
+ type Unknown$2 = Ref<Unknown$1>;
8804
+ /**
8805
+ * Factory function to create a Ref schema for the given target schema.
8806
+ * Use this in schema definitions to declare reference fields.
8807
+ *
8808
+ * @example
8809
+ * ```ts
8810
+ * const Task = Schema.Struct({
8811
+ * assignee: Ref.Ref(Person), // Creates a Ref schema
8812
+ * }).pipe(Type.object({ typename: 'Task', version: '0.1.0' }));
8813
+ * ```
8814
+ */
8815
+ declare const Ref$1: <S$1 extends Schema.Any>(schema: S$1) => RefSchema<Schema.Type<S$1>>;
8816
+ /**
8817
+ * TypeScript type for a Ref schema.
8818
+ * This is the type of the SCHEMA itself, not the runtime ref instance.
8819
+ * For the instance type, use `Ref.Ref<T>` from the Ref module.
8820
+ *
8821
+ * @example
8822
+ * ```ts
8823
+ * // Schema type annotation (rarely needed, usually inferred):
8824
+ * const refSchema: Ref.RefSchema<typeof Task> = Ref.Ref(Task);
8825
+ *
8826
+ * // Instance type annotation (use Ref.Ref instead):
8827
+ * const refInstance: Ref.Ref<Task> = Ref.make(task);
8828
+ * ```
8829
+ */
8830
+ interface RefSchema<T$1 extends Unknown> extends RefSchema$1<T$1> {}
8831
+ /**
8832
+ * Extract reference target.
8833
+ */
8834
+ type Target<R$1 extends Unknown$2> = R$1 extends Ref<infer T> ? T : never;
8835
+ /**
8836
+ * Reference resolver.
8837
+ */
8838
+ type Resolver = RefResolver;
8839
+ //#endregion
8909
8840
  //#region ../echo/dist/types/src/internal/Obj/typed-object.d.ts
8910
8841
  /**
8911
8842
  * Definition for an object type that can be stored in an ECHO database.
@@ -9055,7 +8986,7 @@ declare class EchoSchema<A$1 = any, I$1 = any> extends EchoSchema_base implement
9055
8986
  */
9056
8987
  removeFields(fieldNames: string[]): void;
9057
8988
  /**
9058
- * Wrapper for Obj.change that handles the change context for the persistent schema.
8989
+ * Wrapper for Obj.update that handles the change context for the persistent schema.
9059
8990
  */
9060
8991
  private _change;
9061
8992
  /**
@@ -9176,7 +9107,7 @@ type OfShape<Props$1> = BaseObj & Props$1;
9176
9107
  * NOTE: This is a TypeScript type only, not a schema.
9177
9108
  * To validate that a value is an ECHO object, use `Schema.is(Type.Obj)`.
9178
9109
  */
9179
- interface Unknown$2 extends BaseObj {}
9110
+ interface Unknown$1 extends BaseObj {}
9180
9111
  /**
9181
9112
  * Runtime Effect schema for any ECHO object.
9182
9113
  * Use for validation, parsing, or as a reference target for collections.
@@ -9198,70 +9129,155 @@ interface Unknown$2 extends BaseObj {}
9198
9129
  * }).pipe(Type.object({ typename: 'Collection', version: '0.1.0' }));
9199
9130
  * ```
9200
9131
  */
9201
- declare const Unknown$2: Obj$1<Unknown$2>;
9132
+ declare const Unknown$1: Obj$1<Unknown$1>;
9202
9133
  /**
9203
9134
  * JSON-encoded properties for objects.
9204
9135
  */
9205
9136
  interface BaseObjJson {
9206
9137
  id: string;
9207
9138
  }
9208
- //#endregion
9209
- //#region ../echo/dist/types/src/Ref.d.ts
9139
+ declare namespace Filter_d_exports {
9140
+ export { Any$3 as Any, ChildOfOptions, Filter, 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, lt, lte, neq, not, nothing, or, pretty$1 as pretty, props, tag, text, type$2 as type, typeDXN, typename$1 as typename, updated };
9141
+ }
9142
+ interface Filter<T$1> {
9143
+ '~Filter': {
9144
+ value: Covariant<T$1>;
9145
+ };
9146
+ ast: Filter$1;
9147
+ }
9148
+ type Props<T$1> = { [K in keyof T$1 & string]?: Filter<T$1[K]> | T$1[K] };
9149
+ type Any$3 = Filter<any>;
9150
+ type Type$2<F extends Any$3> = F extends Filter<infer T> ? T : never;
9151
+ declare class FilterClass implements Any$3 {
9152
+ readonly ast: Filter$1;
9153
+ private static 'variance';
9154
+ constructor(ast: Filter$1);
9155
+ '~Filter': {
9156
+ value: Covariant<any>;
9157
+ };
9158
+ }
9159
+ declare const is$1: (value: unknown) => value is Any$3;
9160
+ /** Construct a filter from an ast. */
9161
+ declare const fromAst$1: (ast: Filter$1) => Any$3;
9210
9162
  /**
9211
- * Instance type for a reference.
9212
- *
9213
- * Reference can point to any object or relation.
9214
- * References are lazy loaded.
9215
- *
9216
- * `ref.dxn` is the DXN of the referenced object.
9217
- *
9218
- * @example
9219
- * ```ts
9220
- * const taskRef: Ref<Task> = Ref.make(task);
9221
- *
9222
- * await taskRef.load(); // Returns Promise<Task>
9223
- * yield* Database.load(taskRef); // Effectful version.
9224
- *
9225
- * database.makeRef(dxn); // Create a ref from a DXN.
9226
- * ```
9163
+ * Filter that matches all objects.
9227
9164
  */
9228
- type Ref$1<T$1> = Ref<T$1>;
9229
- type Unknown$1 = Ref<Unknown$2>;
9165
+ declare const everything: () => FilterClass;
9230
9166
  /**
9231
- * Factory function to create a Ref schema for the given target schema.
9232
- * Use this in schema definitions to declare reference fields.
9233
- *
9234
- * @example
9235
- * ```ts
9236
- * const Task = Schema.Struct({
9237
- * assignee: Ref.Ref(Person), // Creates a Ref schema
9238
- * }).pipe(Type.object({ typename: 'Task', version: '0.1.0' }));
9239
- * ```
9167
+ * Filter that matches no objects.
9240
9168
  */
9241
- declare const Ref$1: <S$1 extends Schema.Any>(schema: S$1) => RefSchema<Schema.Type<S$1>>;
9169
+ declare const nothing: () => FilterClass;
9170
+ declare const id: (...ids: ObjectId[]) => Any$3;
9242
9171
  /**
9243
- * TypeScript type for a Ref schema.
9244
- * This is the type of the SCHEMA itself, not the runtime ref instance.
9245
- * For the instance type, use `Ref.Ref<T>` from the Ref module.
9246
- *
9247
- * @example
9248
- * ```ts
9249
- * // Schema type annotation (rarely needed, usually inferred):
9250
- * const refSchema: Ref.RefSchema<typeof Task> = Ref.Ref(Task);
9251
- *
9252
- * // Instance type annotation (use Ref.Ref instead):
9253
- * const refInstance: Ref.Ref<Task> = Ref.make(task);
9254
- * ```
9172
+ * Filter by type.
9255
9173
  */
9256
- interface RefSchema<T$1 extends Unknown> extends RefSchema$1<T$1> {}
9174
+ declare const type$2: <S$1 extends Schema.All>(schema: S$1 | string, props?: Props<Schema.Type<S$1>>) => Filter<Schema.Type<S$1>>;
9257
9175
  /**
9258
- * Extract reference target.
9176
+ * Filter by non-qualified typename.
9259
9177
  */
9260
- type Target<R$1 extends Unknown$1> = R$1 extends Ref<infer T> ? T : never;
9178
+ declare const typename$1: (typename: string) => Any$3;
9261
9179
  /**
9262
- * Reference resolver.
9180
+ * Filter by fully qualified type DXN.
9263
9181
  */
9264
- type Resolver = RefResolver;
9182
+ declare const typeDXN: (dxn: DXN) => Any$3;
9183
+ /**
9184
+ * Filter by tag.
9185
+ */
9186
+ declare const tag: (tag: string) => Any$3;
9187
+ /**
9188
+ * Filter by properties.
9189
+ */
9190
+ declare const props: <T$1>(props: Props<T$1>) => Filter<T$1>;
9191
+ type TextSearchOptions = {
9192
+ type?: 'full-text' | 'vector';
9193
+ };
9194
+ /**
9195
+ * Full-text or vector search.
9196
+ */
9197
+ declare const text: (text: string, options?: TextSearchOptions) => Any$3;
9198
+ /**
9199
+ * Filter by foreign keys.
9200
+ */
9201
+ declare const foreignKeys: <S$1 extends Schema.All>(schema: S$1 | string, keys: ForeignKey[]) => Filter<Schema.Type<S$1>>;
9202
+ /**
9203
+ * Predicate for property to be equal to the provided value.
9204
+ */
9205
+ declare const eq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9206
+ /**
9207
+ * Predicate for property to be not equal to the provided value.
9208
+ */
9209
+ declare const neq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9210
+ /**
9211
+ * Predicate for property to be greater than the provided value.
9212
+ */
9213
+ declare const gt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9214
+ /**
9215
+ * Predicate for property to be greater than or equal to the provided value.
9216
+ */
9217
+ declare const gte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9218
+ /**
9219
+ * Predicate for property to be less than the provided value.
9220
+ */
9221
+ declare const lt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9222
+ /**
9223
+ * Predicate for property to be less than or equal to the provided value.
9224
+ */
9225
+ declare const lte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
9226
+ /**
9227
+ * Predicate for property to be in the provided array.
9228
+ * @param values - Values to check against.
9229
+ */
9230
+ declare const in$: <T$1>(...values: T$1[]) => Filter<T$1>;
9231
+ /**
9232
+ * Predicate for an array property to contain the provided value.
9233
+ * @param value - Value to check against.
9234
+ */
9235
+ declare const contains: <T$1>(value: T$1) => Filter<readonly T$1[] | undefined>;
9236
+ /**
9237
+ * Predicate for property to be in the provided range.
9238
+ * @param from - Start of the range (inclusive).
9239
+ * @param to - End of the range (exclusive).
9240
+ */
9241
+ declare const between: <T$1>(from: T$1, to: T$1) => Filter<T$1>;
9242
+ type TimeRange = {
9243
+ after?: Date | number;
9244
+ before?: Date | number;
9245
+ };
9246
+ /**
9247
+ * Filter objects by updatedAt timestamp.
9248
+ */
9249
+ declare const updated: (range: TimeRange) => Any$3;
9250
+ /**
9251
+ * Filter objects by createdAt timestamp.
9252
+ */
9253
+ declare const created: (range: TimeRange) => Any$3;
9254
+ type ChildOfOptions = {
9255
+ /** Whether to match transitively (grandchildren, etc.). Defaults to true. */
9256
+ transitive?: boolean;
9257
+ };
9258
+ /**
9259
+ * Filter objects that are children of the specified parent(s).
9260
+ * Accepts ECHO objects, Refs, or arrays of either.
9261
+ * Refs are resolved to DXNs without loading; objects use {@link Obj.getDXN}.
9262
+ * With transitive=true (default), also matches grandchildren and beyond.
9263
+ */
9264
+ declare const childOf: (parents: Unknown$1 | Unknown$2 | readonly (Unknown$1 | Unknown$2)[], options?: ChildOfOptions) => Any$3;
9265
+ /**
9266
+ * Negate the filter.
9267
+ */
9268
+ declare const not: <F extends Any$3>(filter: F) => Filter<Type$2<F>>;
9269
+ /**
9270
+ * Combine filters with a logical AND.
9271
+ */
9272
+ declare const and: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
9273
+ /**
9274
+ * Combine filters with a logical OR.
9275
+ */
9276
+ declare const or: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
9277
+ /**
9278
+ * Returns a human-readable string representation of a Filter AST.
9279
+ */
9280
+ declare const pretty$1: (filter: Any$3) => string;
9265
9281
  //#endregion
9266
9282
  //#region ../echo/dist/types/src/JsonSchema.d.ts
9267
9283
  /**
@@ -9490,7 +9506,7 @@ interface Hypergraph extends Queryable {
9490
9506
  */
9491
9507
  declare const Collection: Obj$1<{
9492
9508
  readonly name?: string | undefined;
9493
- readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$2>[];
9509
+ readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$1>[];
9494
9510
  }, Struct.Fields>;
9495
9511
  interface Collection extends Schema.Type<typeof Collection> {}
9496
9512
  //#endregion
@@ -9504,8 +9520,8 @@ interface Collection extends Schema.Type<typeof Collection> {}
9504
9520
  * ```
9505
9521
  */
9506
9522
  declare const Feed: Obj$1<{
9507
- readonly kind?: string | undefined;
9508
9523
  readonly name?: string | undefined;
9524
+ readonly kind?: string | undefined;
9509
9525
  readonly namespace?: "data" | "trace" | undefined;
9510
9526
  }, Struct.Fields>;
9511
9527
  /**
@@ -9520,8 +9536,8 @@ interface Feed extends Schema.Type<typeof Feed> {}
9520
9536
  */
9521
9537
  declare const ViewSchema: Obj$1<{
9522
9538
  readonly query: {
9523
- readonly ast: QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause;
9524
9539
  readonly raw?: string | undefined;
9540
+ readonly ast: QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause;
9525
9541
  };
9526
9542
  readonly projection: {
9527
9543
  readonly schema?: JsonSchemaType | undefined;
@@ -9545,12 +9561,12 @@ declare const View: Obj$1<View>;
9545
9561
  * Abstart set of objects, represented by a view, feed, or collection.
9546
9562
  */
9547
9563
  declare const Dataset: Union<[Obj$1<{
9548
- readonly kind?: string | undefined;
9549
9564
  readonly name?: string | undefined;
9565
+ readonly kind?: string | undefined;
9550
9566
  readonly namespace?: "data" | "trace" | undefined;
9551
9567
  }, Struct.Fields>, Obj$1<{
9552
9568
  readonly name?: string | undefined;
9553
- readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$2>[];
9569
+ readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$1>[];
9554
9570
  }, Struct.Fields>, Obj$1<View, Struct.Fields>]>;
9555
9571
  type Dataset = Feed | Collection | View;
9556
9572
  declare namespace Order_d_exports {
@@ -9594,7 +9610,7 @@ interface Query<T$1> {
9594
9610
  * @param key - Property path inside T that is a reference or optional reference.
9595
9611
  * @returns Query for the target of the reference.
9596
9612
  */
9597
- '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>;
9613
+ '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>;
9598
9614
  /**
9599
9615
  * Find objects referencing this object.
9600
9616
  * @param target - Schema of the referencing object. If not provided, matches any type.
@@ -9719,6 +9735,10 @@ interface Query<T$1> {
9719
9735
  * Add options to a query.
9720
9736
  */
9721
9737
  'options'(options: QueryOptions): Query<T$1>;
9738
+ /**
9739
+ * Attach a diagnostic label for logs and tooling (execution semantics unchanged).
9740
+ */
9741
+ 'debugLabel'(label: string): Query<T$1>;
9722
9742
  }
9723
9743
  type Any$1 = Query<any>;
9724
9744
  type Type$1<Q extends Any$1> = Q extends Query<infer T> ? T : never;
@@ -9763,7 +9783,7 @@ declare const without: <T$1>(source: Query<T$1>, exclude: Query<T$1>) => Query<T
9763
9783
  * @param source - Data source: database, feed, 'all-accessible-spaces', or another query.
9764
9784
  * @returns Query scoped to the given source.
9765
9785
  */
9766
- declare const from: (source: Database | Database[] | Feed | Feed[] | Any$1 | Scope | "all-accessible-spaces", options?: {
9786
+ declare const from: (source: Database | Database[] | Feed | Feed[] | Any$1 | Scope | 'all-accessible-spaces', options?: {
9767
9787
  includeFeeds?: boolean;
9768
9788
  }) => Any$1;
9769
9789
  /**
@@ -9834,7 +9854,7 @@ interface Database extends Queryable {
9834
9854
  /**
9835
9855
  * Return object by local ID.
9836
9856
  */
9837
- getObjectById<T$1 extends Unknown$2 = OfShape<AnyProperties>>(id: string, opts?: GetObjectByIdOptions): T$1 | undefined;
9857
+ getObjectById<T$1 extends Unknown$1 = OfShape<AnyProperties>>(id: string, opts?: GetObjectByIdOptions): T$1 | undefined;
9838
9858
  /**
9839
9859
  * Query objects.
9840
9860
  */
@@ -9916,13 +9936,13 @@ interface AnyEntity {
9916
9936
  /**
9917
9937
  * String key used to identify the kind of an entity instance (object or relation).
9918
9938
  */
9919
- declare const KindId: "~@dxos/echo/Kind";
9939
+ declare const KindId: '~@dxos/echo/Kind';
9920
9940
  type KindId = typeof KindId;
9921
9941
  /**
9922
9942
  * String key used to identify the kind of a schema (object schema or relation schema).
9923
9943
  * Parallels KindId which identifies instance kinds.
9924
9944
  */
9925
- declare const SchemaKindId: "~@dxos/echo/SchemaKind";
9945
+ declare const SchemaKindId: '~@dxos/echo/SchemaKind';
9926
9946
  type SchemaKindId = typeof SchemaKindId;
9927
9947
  /**
9928
9948
  * Kinds of entities stored in ECHO: objects and relations.