@dxos/echo-protocol 0.8.4-main.1f223c7 → 0.8.4-main.2244d791bb

package/dist/lib/{browser → neutral}/index.mjs

@@ -11,20 +11,16 @@ import { visitValues } from "@dxos/util";
 // src/reference.ts
 import { assertArgument } from "@dxos/invariant";
 import { DXN, LOCAL_SPACE_TAG } from "@dxos/keys";
-function _define_property(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var Reference = class _Reference {
+  _objectId;
+  _protocol;
+  _host;
+  _dxn;
+  /**
+  * Protocol references to runtime registered types.
+  * @deprecated
+  */
+  static TYPE_PROTOCOL = "protobuf";
   static fromDXN(dxn) {
     switch (dxn.kind) {
       case DXN.kind.TYPE:
@@ -39,8 +35,8 @@ var Reference = class _Reference {
         return new _Reference(dxn.parts[0], void 0, dxn.parts[0], dxn);
     }
   }
-  static fromValue(value) {
-    return new _Reference(value.objectId, value.protocol, value.host);
+  static fromValue(value2) {
+    return new _Reference(value2.objectId, value2.protocol, value2.host);
   }
   /**
   * Reference an object in the local space.
@@ -62,6 +58,13 @@ var Reference = class _Reference {
   static fromObjectIdAndSpaceKey(objectId, spaceKey) {
     return new _Reference(objectId, void 0, spaceKey.toHex());
   }
+  // prettier-ignore
+  constructor(_objectId, _protocol, _host, _dxn) {
+    this._objectId = _objectId;
+    this._protocol = _protocol;
+    this._host = _host;
+    this._dxn = _dxn;
+  }
   get dxn() {
     return this._dxn;
   }
@@ -116,45 +119,40 @@ var Reference = class _Reference {
       }
     }
   }
-  // prettier-ignore
-  constructor(_objectId, _protocol, _host, _dxn) {
-    _define_property(this, "_objectId", void 0);
-    _define_property(this, "_protocol", void 0);
-    _define_property(this, "_host", void 0);
-    _define_property(this, "_dxn", void 0);
-    this._objectId = _objectId;
-    this._protocol = _protocol;
-    this._host = _host;
-    this._dxn = _dxn;
-  }
 };
-_define_property(Reference, "TYPE_PROTOCOL", "protobuf");
 var REFERENCE_TYPE_TAG = "dxos.echo.model.document.Reference";
 var encodeReference = (reference) => ({
   "/": reference.toDXN().toString()
 });
-var decodeReference = (value) => {
-  if (typeof value !== "object" || value === null || typeof value["/"] !== "string") {
+var decodeReference = (value2) => {
+  if (typeof value2 !== "object" || value2 === null || typeof value2["/"] !== "string") {
     throw new Error("Invalid reference");
   }
-  const dxnString = value["/"];
+  const dxnString = value2["/"];
   if (dxnString.length % 2 === 0 && dxnString.slice(0, dxnString.length / 2) === dxnString.slice(dxnString.length / 2) && dxnString.includes("dxn:echo")) {
     throw new Error("Automerge bug detected!");
   }
   return Reference.fromDXN(DXN.parse(dxnString));
 };
-var isEncodedReference = (value) => typeof value === "object" && value !== null && Object.keys(value).length === 1 && typeof value["/"] === "string";
+var isEncodedReference = (value2) => typeof value2 === "object" && value2 !== null && Object.keys(value2).length === 1 && typeof value2["/"] === "string";
 var EncodedReference = Object.freeze({
   isEncodedReference,
-  getReferenceString: (value) => {
-    assertArgument(isEncodedReference(value), "value", "invalid reference");
-    return value["/"];
+  getReferenceString: (value2) => {
+    assertArgument(isEncodedReference(value2), "value", "invalid reference");
+    return value2["/"];
   },
-  toDXN: (value) => {
-    return DXN.parse(EncodedReference.getReferenceString(value));
+  toDXN: (value2) => {
+    return DXN.parse(EncodedReference.getReferenceString(value2));
   },
   fromDXN: (dxn) => {
-    return encodeReference(Reference.fromDXN(dxn));
+    return {
+      "/": dxn.toString()
+    };
+  },
+  fromLegacyTypename: (typename) => {
+    return {
+      "/": DXN.fromTypename(typename).toString()
+    };
   }
 });
 
@@ -227,29 +225,35 @@ var ObjectStructure = Object.freeze({
   getRelationTarget: (object) => {
     return object.system?.target;
   },
+  getParent: (object) => {
+    return object.system?.parent;
+  },
   /**
   * @returns All references in the data section of the object.
   */
   getAllOutgoingReferences: (object) => {
     const references = [];
-    const visit2 = (path, value) => {
-      if (isEncodedReference(value)) {
+    const visit2 = (path, value2) => {
+      if (isEncodedReference(value2)) {
         references.push({
           path,
-          reference: value
+          reference: value2
         });
       } else {
-        visitValues(value, (value2, key) => visit2([
+        visitValues(value2, (value3, key) => visit2([
           ...path,
           String(key)
-        ], value2));
+        ], value3));
       }
     };
-    visitValues(object.data, (value, key) => visit2([
+    visitValues(object.data, (value2, key) => visit2([
       String(key)
-    ], value));
+    ], value2));
     return references;
   },
+  getTags: (object) => {
+    return object.meta.tags ?? [];
+  },
   makeObject: ({ type, data, keys }) => {
     return {
       system: {
@@ -285,37 +289,63 @@ var ObjectStructure = Object.freeze({
 var PROPERTY_ID = "id";
 var DATA_NAMESPACE = "data";
 
-// src/space-doc-version.ts
-var SpaceDocVersion = Object.freeze({
+// src/echo-feed-codec.ts
+import { FeedProtocol } from "@dxos/protocols";
+var ATTR_META = "@meta";
+var EchoFeedCodec = class _EchoFeedCodec {
+  static #encoder = new TextEncoder();
+  static #decoder = new TextDecoder();
   /**
-  * For the documents created before the versioning was introduced.
+  * Prepares a value for feed storage (strips queue position from metadata) and encodes to bytes.
   */
-  LEGACY: 0,
+  static encode(value2) {
+    const prepared = _EchoFeedCodec.#stripQueuePosition(value2);
+    return _EchoFeedCodec.#encoder.encode(JSON.stringify(prepared));
+  }
   /**
-  * Current version.
+  * Decodes feed block bytes to a JSON value.
+  * If position is provided, injects queue position into the decoded object's metadata.
   */
-  CURRENT: 1
-});
-
-// src/space-id.ts
-import { subtleCrypto } from "@dxos/crypto";
-import { PublicKey, SpaceId } from "@dxos/keys";
-import { ComplexMap } from "@dxos/util";
-var SPACE_IDS_CACHE = new ComplexMap(PublicKey.hash);
-var createIdFromSpaceKey = async (spaceKey) => {
-  const cachedValue = SPACE_IDS_CACHE.get(spaceKey);
-  if (cachedValue !== void 0) {
-    return cachedValue;
+  static decode(data, position) {
+    const decoded = JSON.parse(_EchoFeedCodec.#decoder.decode(data));
+    if (position !== void 0 && typeof decoded === "object" && decoded !== null) {
+      _EchoFeedCodec.#setQueuePosition(decoded, position);
+    }
+    return decoded;
+  }
+  static #stripQueuePosition(value2) {
+    if (typeof value2 !== "object" || value2 === null) {
+      return value2;
+    }
+    const obj = structuredClone(value2);
+    const meta = obj[ATTR_META];
+    if (meta?.keys?.some((key) => key.source === FeedProtocol.KEY_QUEUE_POSITION)) {
+      meta.keys = meta.keys.filter((key) => key.source !== FeedProtocol.KEY_QUEUE_POSITION);
+    }
+    return obj;
+  }
+  static #setQueuePosition(obj, position) {
+    obj[ATTR_META] ??= {
+      keys: []
+    };
+    obj[ATTR_META].keys ??= [];
+    const keys = obj[ATTR_META].keys;
+    for (let i = 0; i < keys.length; i++) {
+      if (keys[i].source === FeedProtocol.KEY_QUEUE_POSITION) {
+        keys.splice(i, 1);
+        i--;
+      }
+    }
+    keys.push({
+      source: FeedProtocol.KEY_QUEUE_POSITION,
+      id: position.toString()
+    });
   }
-  const digest = await subtleCrypto.digest("SHA-256", spaceKey.asUint8Array());
-  const bytes = new Uint8Array(digest).slice(0, SpaceId.byteLength);
-  const spaceId = SpaceId.encode(bytes);
-  SPACE_IDS_CACHE.set(spaceKey, spaceId);
-  return spaceId;
 };
 
 // src/foreign-key.ts
-import { Schema, SchemaAST } from "effect";
+import * as Schema from "effect/Schema";
+import * as SchemaAST from "effect/SchemaAST";
 var ForeignKey_ = Schema.Struct({
   /**
   * Name of the foreign database/system.
@@ -326,9 +356,9 @@ var ForeignKey_ = Schema.Struct({
   * Id within the foreign database.
   */
   // TODO(wittjosiah): This annotation is currently used to ensure id field shows up in forms.
-  // TODO(dmaretskyi): `false` is not a valid value for the annotation.
+  // TODO(dmaretskyi): `false` is not a valid value for the annotation. Use a different annotation.
   id: Schema.String.annotations({
-    [SchemaAST.IdentifierAnnotationId]: false
+    [SchemaAST.IdentifierAnnotationId]: "false"
   })
 });
 var ForeignKey = ForeignKey_;
@@ -345,12 +375,15 @@ __export(ast_exports, {
   FilterObject: () => FilterObject,
   FilterOr: () => FilterOr,
   FilterRange: () => FilterRange,
+  FilterTag: () => FilterTag,
   FilterTextSearch: () => FilterTextSearch,
   Order: () => Order,
   OrderDirection: () => OrderDirection,
   Query: () => Query,
   QueryFilterClause: () => QueryFilterClause,
+  QueryHierarchyTraversalClause: () => QueryHierarchyTraversalClause,
   QueryIncomingReferencesClause: () => QueryIncomingReferencesClause,
+  QueryLimitClause: () => QueryLimitClause,
   QueryOptions: () => QueryOptions,
   QueryOptionsClause: () => QueryOptionsClause,
   QueryOrderClause: () => QueryOrderClause,
@@ -363,10 +396,11 @@ __export(ast_exports, {
   fold: () => fold,
   visit: () => visit
 });
-import { Match, Schema as Schema2 } from "effect";
+import * as Match from "effect/Match";
+import * as Schema2 from "effect/Schema";
 import { DXN as DXN2, ObjectId } from "@dxos/keys";
 var TypenameSpecifier = Schema2.Union(DXN2.Schema, Schema2.Null).annotations({
-  description: "DXN or null. Null means any type will match"
+  description: "DXN or null; null matches any type"
 });
 var FilterObject_ = Schema2.Struct({
   type: Schema2.Literal("object"),
@@ -404,6 +438,11 @@ var FilterContains_ = Schema2.Struct({
   value: Schema2.Any
 });
 var FilterContains = FilterContains_;
+var FilterTag_ = Schema2.Struct({
+  type: Schema2.Literal("tag"),
+  tag: Schema2.String
+});
+var FilterTag = FilterTag_;
 var FilterRange_ = Schema2.Struct({
   type: Schema2.Literal("range"),
   from: Schema2.Any,
@@ -431,7 +470,9 @@ var FilterOr_ = Schema2.Struct({
   filters: Schema2.Array(Schema2.suspend(() => Filter))
 });
 var FilterOr = FilterOr_;
-var Filter = Schema2.Union(FilterObject, FilterTextSearch, FilterCompare, FilterIn, FilterContains, FilterRange, FilterNot, FilterAnd, FilterOr);
+var Filter = Schema2.Union(FilterObject, FilterCompare, FilterIn, FilterContains, FilterTag, FilterRange, FilterTextSearch, FilterNot, FilterAnd, FilterOr).annotations({
+  identifier: "dxos.org/schema/Filter"
+});
 var QuerySelectClause_ = Schema2.Struct({
   type: Schema2.Literal("select"),
   filter: Schema2.suspend(() => Filter)
@@ -452,7 +493,11 @@ var QueryReferenceTraversalClause = QueryReferenceTraversalClause_;
 var QueryIncomingReferencesClause_ = Schema2.Struct({
   type: Schema2.Literal("incoming-references"),
   anchor: Schema2.suspend(() => Query),
-  property: Schema2.String,
+  /**
+  * Property path where the reference is located.
+  * If null, matches references from any property.
+  */
+  property: Schema2.NullOr(Schema2.String),
   typename: TypenameSpecifier
 });
 var QueryIncomingReferencesClause = QueryIncomingReferencesClause_;
@@ -474,6 +519,16 @@ var QueryRelationTraversalClause_ = Schema2.Struct({
   direction: Schema2.Literal("source", "target", "both")
 });
 var QueryRelationTraversalClause = QueryRelationTraversalClause_;
+var QueryHierarchyTraversalClause_ = Schema2.Struct({
+  type: Schema2.Literal("hierarchy-traversal"),
+  anchor: Schema2.suspend(() => Query),
+  /**
+  * to-parent: traverse from child to parent.
+  * to-children: traverse from parent to children.
+  */
+  direction: Schema2.Literal("to-parent", "to-children")
+});
+var QueryHierarchyTraversalClause = QueryHierarchyTraversalClause_;
 var QueryUnionClause_ = Schema2.Struct({
   type: Schema2.Literal("union"),
   queries: Schema2.Array(Schema2.suspend(() => Query))
@@ -493,6 +548,11 @@ var Order_ = Schema2.Union(Schema2.Struct({
   kind: Schema2.Literal("property"),
   property: Schema2.String,
   direction: OrderDirection
+}), Schema2.Struct({
+  // Order by relevance rank (for FTS/vector search results).
+  // Default direction is 'desc' (higher rank = better match first).
+  kind: Schema2.Literal("rank"),
+  direction: OrderDirection
 }));
 var Order = Order_;
 var QueryOrderClause_ = Schema2.Struct({
@@ -507,7 +567,15 @@ var QueryOptionsClause_ = Schema2.Struct({
   options: Schema2.suspend(() => QueryOptions)
 });
 var QueryOptionsClause = QueryOptionsClause_;
-var Query_ = Schema2.Union(QuerySelectClause, QueryFilterClause, QueryReferenceTraversalClause, QueryIncomingReferencesClause, QueryRelationClause, QueryRelationTraversalClause, QueryUnionClause, QuerySetDifferenceClause, QueryOrderClause, QueryOptionsClause);
+var QueryLimitClause_ = Schema2.Struct({
+  type: Schema2.Literal("limit"),
+  query: Schema2.suspend(() => Query),
+  limit: Schema2.Number
+});
+var QueryLimitClause = QueryLimitClause_;
+var Query_ = Schema2.Union(QuerySelectClause, QueryFilterClause, QueryReferenceTraversalClause, QueryIncomingReferencesClause, QueryRelationClause, QueryRelationTraversalClause, QueryHierarchyTraversalClause, QueryUnionClause, QuerySetDifferenceClause, QueryOrderClause, QueryOptionsClause, QueryLimitClause).annotations({
+  identifier: "dxos.org/schema/Query"
+});
 var Query = Query_;
 var QueryOptions = Schema2.Struct({
   /**
@@ -517,6 +585,10 @@ var QueryOptions = Schema2.Struct({
   */
   spaceIds: Schema2.optional(Schema2.Array(Schema2.String)),
   /**
+  * If true, the nested select statements will select from all queues in the spaces specified by `spaceIds`.
+  */
+  allQueuesFromSpaces: Schema2.optional(Schema2.Boolean),
+  /**
   * The nested select statemets will select from the given queues.
   *
   * NOTE: Spaces and queues are unioned together if both are specified.
@@ -541,6 +613,8 @@ var visit = (query, visitor) => {
     type: "options"
   }, ({ query: query2 }) => visit(query2, visitor)), Match.when({
     type: "relation-traversal"
+  }, ({ anchor }) => visit(anchor, visitor)), Match.when({
+    type: "hierarchy-traversal"
   }, ({ anchor }) => visit(anchor, visitor)), Match.when({
     type: "union"
   }, ({ queries }) => queries.forEach((q) => visit(q, visitor))), Match.when({
@@ -550,6 +624,8 @@ var visit = (query, visitor) => {
     visit(exclude, visitor);
   }), Match.when({
     type: "order"
+  }, ({ query: query2 }) => visit(query2, visitor)), Match.when({
+    type: "limit"
   }, ({ query: query2 }) => visit(query2, visitor)), Match.when({
     type: "select"
   }, () => {
@@ -568,19 +644,53 @@ var fold = (query, reducer) => {
     type: "options"
   }, ({ query: query2 }) => fold(query2, reducer)), Match.when({
     type: "relation-traversal"
+  }, ({ anchor }) => fold(anchor, reducer)), Match.when({
+    type: "hierarchy-traversal"
   }, ({ anchor }) => fold(anchor, reducer)), Match.when({
     type: "union"
   }, ({ queries }) => queries.flatMap((q) => fold(q, reducer))), Match.when({
     type: "set-difference"
   }, ({ source, exclude }) => fold(source, reducer).concat(fold(exclude, reducer))), Match.when({
     type: "order"
+  }, ({ query: query2 }) => fold(query2, reducer)), Match.when({
+    type: "limit"
   }, ({ query: query2 }) => fold(query2, reducer)), Match.when({
     type: "select"
   }, () => []), Match.exhaustive);
 };
+
+// src/space-doc-version.ts
+var SpaceDocVersion = Object.freeze({
+  /**
+  * For the documents created before the versioning was introduced.
+  */
+  LEGACY: 0,
+  /**
+  * Current version.
+  */
+  CURRENT: 1
+});
+
+// src/space-id.ts
+import { subtleCrypto } from "@dxos/crypto";
+import { PublicKey, SpaceId } from "@dxos/keys";
+import { ComplexMap } from "@dxos/util";
+var SPACE_IDS_CACHE = new ComplexMap(PublicKey.hash);
+var createIdFromSpaceKey = async (spaceKey) => {
+  const cachedValue = SPACE_IDS_CACHE.get(spaceKey);
+  if (cachedValue !== void 0) {
+    return cachedValue;
+  }
+  const digest = await subtleCrypto.digest("SHA-256", spaceKey.asUint8Array());
+  const bytes = new Uint8Array(digest).slice(0, SpaceId.byteLength);
+  const spaceId = SpaceId.encode(bytes);
+  SPACE_IDS_CACHE.set(spaceKey, spaceId);
+  return spaceId;
+};
 export {
   DATA_NAMESPACE,
   DatabaseDirectory,
+  EchoFeedCodec,
   EncodedReference,
   ForeignKey,
   ObjectStructure,

package/dist/lib/neutral/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/document-structure.ts", "../../../src/reference.ts", "../../../src/echo-feed-codec.ts", "../../../src/foreign-key.ts", "../../../src/query/ast.ts", "../../../src/space-doc-version.ts", "../../../src/space-id.ts"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { invariant } from '@dxos/invariant';\nimport type { DXN, ObjectId } from '@dxos/keys';\nimport { visitValues } from '@dxos/util';\n\nimport { type RawString } from './automerge';\nimport type { ForeignKey } from './foreign-key';\nimport { type EncodedReference, isEncodedReference } from './reference';\nimport { type SpaceDocVersion } from './space-doc-version';\n\nexport type SpaceState = {\n  // Url of the root automerge document.\n  rootUrl?: string;\n};\n\n/**\n * Array indexes get converted to strings.\n */\nexport type ObjectProp = string;\nexport type ObjectPropPath = ObjectProp[];\n\n/**\n * Link to all documents that hold objects in the space.\n */\nexport interface DatabaseDirectory {\n  version?: SpaceDocVersion;\n\n  access?: {\n    spaceKey: string;\n  };\n  /**\n   * Objects inlined in the current document.\n   */\n  objects?: {\n    [id: string]: ObjectStructure;\n  };\n  /**\n   * Object id points to an automerge doc url where the object is embedded.\n   */\n  links?: {\n    [echoId: string]: string | RawString;\n  };\n\n  /**\n   * @deprecated\n   * For backward compatibility.\n   */\n  experimental_spaceKey?: string;\n}\n\nexport const DatabaseDirectory = Object.freeze({\n  /**\n   * @returns Space key in hex of the space that owns the document. In hex format. Without 0x prefix.\n   */\n  getSpaceKey: (doc: DatabaseDirectory): string | null => {\n    // experimental_spaceKey is set on old documents, new ones are created with doc.access.spaceKey\n    const rawSpaceKey = doc.access?.spaceKey ?? doc.experimental_spaceKey;\n    if (rawSpaceKey == null) {\n      return null;\n    }\n\n    const rawKey = String(rawSpaceKey);\n    invariant(!rawKey.startsWith('0x'), 'Space key must not start with 0x');\n    return rawKey;\n  },\n\n  getInlineObject: (doc: DatabaseDirectory, id: ObjectId): ObjectStructure | undefined => {\n    return doc.objects?.[id];\n  },\n\n  getLink: (doc: DatabaseDirectory, id: ObjectId): string | undefined => {\n    return doc.links?.[id]?.toString();\n  },\n\n  make: ({\n    spaceKey,\n    objects,\n    links,\n  }: {\n    spaceKey: string;\n    objects?: Record<string, ObjectStructure>;\n    links?: Record<string, RawString>;\n  }): DatabaseDirectory => ({\n    access: {\n      spaceKey,\n    },\n    objects: objects ?? {},\n    links: links ?? {},\n  }),\n});\n\n/**\n * Representation of an ECHO object in an AM document.\n */\nexport type ObjectStructure = {\n  // TODO(dmaretskyi): Missing in some cases.\n  system?: ObjectSystem;\n\n  meta: ObjectMeta;\n  /**\n   * User-defined data.\n   * Adheres to schema in `system.type`\n   */\n  data: Record<string, any>;\n};\n\n// Helper methods to interact with the {@link ObjectStructure}.\nexport const ObjectStructure = Object.freeze({\n  /**\n   * @throws On invalid object structure.\n   */\n  getTypeReference: (object: ObjectStructure): EncodedReference | undefined => {\n    return object.system?.type;\n  },\n\n  /**\n   * @throws On invalid object structure.\n   */\n  getEntityKind: (object: ObjectStructure): 'object' | 'relation' => {\n    const kind = object.system?.kind ?? 'object';\n    invariant(kind === 'object' || kind === 'relation', 'Invalid kind');\n    return kind;\n  },\n\n  isDeleted: (object: ObjectStructure): boolean => {\n    return object.system?.deleted ?? false;\n  },\n\n  getRelationSource: (object: ObjectStructure): EncodedReference | undefined => {\n    return object.system?.source;\n  },\n\n  getRelationTarget: (object: ObjectStructure): EncodedReference | undefined => {\n    return object.system?.target;\n  },\n\n  getParent: (object: ObjectStructure): EncodedReference | undefined => {\n    return object.system?.parent;\n  },\n\n  /**\n   * @returns All references in the data section of the object.\n   */\n  getAllOutgoingReferences: (object: ObjectStructure): { path: ObjectPropPath; reference: EncodedReference }[] => {\n    const references: { path: ObjectPropPath; reference: EncodedReference }[] = [];\n    const visit = (path: ObjectPropPath, value: unknown) => {\n      if (isEncodedReference(value)) {\n        references.push({ path, reference: value });\n      } else {\n        visitValues(value, (value, key) => visit([...path, String(key)], value));\n      }\n    };\n    visitValues(object.data, (value, key) => visit([String(key)], value));\n    return references;\n  },\n\n  getTags: (object: ObjectStructure): string[] => {\n    return object.meta.tags ?? [];\n  },\n\n  makeObject: ({\n    type,\n    data,\n    keys,\n  }: {\n    type: DXN.String;\n    deleted?: boolean;\n    keys?: ForeignKey[];\n    data?: unknown;\n  }): ObjectStructure => {\n    return {\n      system: {\n        kind: 'object',\n        type: { '/': type },\n      },\n      meta: {\n        keys: keys ?? [],\n      },\n      data: data ?? {},\n    };\n  },\n\n  makeRelation: ({\n    type,\n    source,\n    target,\n    deleted,\n    keys,\n    data,\n  }: {\n    type: DXN.String;\n    source: EncodedReference;\n    target: EncodedReference;\n    deleted?: boolean;\n    keys?: ForeignKey[];\n    data?: unknown;\n  }): ObjectStructure => {\n    return {\n      system: {\n        kind: 'relation',\n        type: { '/': type },\n        source,\n        target,\n        deleted: deleted ?? false,\n      },\n      meta: {\n        keys: keys ?? [],\n      },\n      data: data ?? {},\n    };\n  },\n});\n\n/**\n * Echo object metadata.\n */\nexport type ObjectMeta = {\n  /**\n   * Foreign keys.\n   */\n  keys: ForeignKey[];\n\n  /**\n   * Tags.\n   * An array of DXNs of Tag objects within the space.\n   *\n   * NOTE: Optional for backwards compatibilty.\n   */\n  tags?: string[];\n};\n\n/**\n * Automerge object system properties.\n * (Is automerge specific.)\n */\nexport type ObjectSystem = {\n  /**\n   * Entity kind.\n   */\n  kind?: 'object' | 'relation';\n\n  /**\n   * Object reference ('protobuf' protocol) type.\n   */\n  type?: EncodedReference;\n\n  /**\n   * Deletion marker.\n   */\n  deleted?: boolean;\n\n  /**\n   * Object parent.\n   * Objects with no parent are at the top level of the object hierarchy in the space.\n   */\n  parent?: EncodedReference;\n\n  /**\n   * Only for relations.\n   */\n  source?: EncodedReference;\n\n  /**\n   * Only for relations.\n   */\n  target?: EncodedReference;\n};\n\n/**\n * Id property name.\n */\nexport const PROPERTY_ID = 'id';\n\n/**\n * Data namespace.\n * The key on {@link ObjectStructure} that contains the user-defined data.\n */\nexport const DATA_NAMESPACE = 'data';\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { assertArgument } from '@dxos/invariant';\nimport { DXN, LOCAL_SPACE_TAG, type PublicKey } from '@dxos/keys';\nimport { type ObjectId } from '@dxos/protocols';\nimport { type Reference as ReferenceProto } from '@dxos/protocols/proto/dxos/echo/model/document';\n\n/**\n * Runtime representation of an reference in ECHO.\n * Implemented as a DXN, but we might extend it to other URIs in the future.\n * @deprecated Use `EncodedReference` instead.\n */\nexport class Reference {\n  /**\n   * Protocol references to runtime registered types.\n   * @deprecated\n   */\n  static TYPE_PROTOCOL = 'protobuf';\n\n  static fromDXN(dxn: DXN): Reference {\n    switch (dxn.kind) {\n      case DXN.kind.TYPE:\n        return new Reference(dxn.parts[0], Reference.TYPE_PROTOCOL, 'dxos.org', dxn);\n      case DXN.kind.ECHO:\n        if (dxn.parts[0] === LOCAL_SPACE_TAG) {\n          return new Reference(dxn.parts[1], undefined, undefined, dxn);\n        } else {\n          return new Reference(dxn.parts[1], undefined, dxn.parts[0], dxn);\n        }\n      default:\n        return new Reference(dxn.parts[0], undefined, dxn.parts[0], dxn);\n    }\n  }\n\n  static fromValue(value: ReferenceProto): Reference {\n    return new Reference(value.objectId, value.protocol, value.host);\n  }\n\n  /**\n   * Reference an object in the local space.\n   */\n  static localObjectReference(objectId: ObjectId): Reference {\n    return new Reference(objectId);\n  }\n\n  /**\n   * @deprecated\n   */\n  // TODO(dmaretskyi): Remove.\n  static fromLegacyTypename(type: string): Reference {\n    return new Reference(type, Reference.TYPE_PROTOCOL, 'dxos.org');\n  }\n\n  /**\n   * @deprecated\n   */\n  // TODO(dmaretskyi): Remove\n  static fromObjectIdAndSpaceKey(objectId: ObjectId, spaceKey: PublicKey): Reference {\n    // TODO(dmaretskyi): FIX ME! This should be a space ID not a space key.\n    return new Reference(objectId, undefined, spaceKey.toHex());\n  }\n\n  // prettier-ignore\n  private constructor(\n    // TODO(dmaretskyi): Remove and just leave DXN.\n    private readonly _objectId: ObjectId,\n    private readonly _protocol?: string,\n    private readonly _host?: string,\n    private readonly _dxn?: DXN,\n  ) {}\n\n  get dxn(): DXN | undefined {\n    return this._dxn;\n  }\n\n  /**\n   * @deprecated\n   */\n  // TODO(dmaretskyi): Remove.\n  get objectId(): ObjectId {\n    return this._objectId;\n  }\n\n  /**\n   * @deprecated\n   */\n  // TODO(dmaretskyi): Remove.\n  get protocol(): string | undefined {\n    return this._protocol;\n  }\n\n  /**\n   * @deprecated\n   */\n  // TODO(dmaretskyi): Remove.\n  get host(): string | undefined {\n    return this._host;\n  }\n\n  encode(): ReferenceProto {\n    return { objectId: this.objectId, host: this.host, protocol: this.protocol };\n  }\n\n  // TODO(dmaretskyi): Remove in favor of `reference.dxn`.\n  toDXN(): DXN {\n    if (this._dxn) {\n      return this._dxn;\n    }\n\n    if (this.protocol === Reference.TYPE_PROTOCOL) {\n      return new DXN(DXN.kind.TYPE, [this.objectId]);\n    } else {\n      if (this.host) {\n        // Host is assumed to be the space key.\n        // The DXN should actually have the space ID.\n        // TODO(dmaretskyi): Migrate to space id.\n        return new DXN(DXN.kind.ECHO, [this.host, this.objectId]);\n      } else {\n        return new DXN(DXN.kind.ECHO, [LOCAL_SPACE_TAG, this.objectId]);\n      }\n    }\n  }\n}\n\n// TODO(dmaretskyi): Is this used anywhere?\nexport const REFERENCE_TYPE_TAG = 'dxos.echo.model.document.Reference';\n\n/**\n * Reference as it is stored in Automerge document.\n */\nexport type EncodedReference = {\n  '/': string;\n};\n\n/**\n * @deprecated Use `EncodedReference.fromDXN` instead.\n */\nexport const encodeReference = (reference: Reference): EncodedReference => ({\n  '/': reference.toDXN().toString(),\n});\n\n/**\n * @deprecated Use `EncodedReference.toDXN` instead.\n */\nexport const decodeReference = (value: any) => {\n  if (typeof value !== 'object' || value === null || typeof value['/'] !== 'string') {\n    throw new Error('Invalid reference');\n  }\n  const dxnString = value['/'];\n\n  if (\n    dxnString.length % 2 === 0 &&\n    dxnString.slice(0, dxnString.length / 2) === dxnString.slice(dxnString.length / 2) &&\n    dxnString.includes('dxn:echo')\n  ) {\n    throw new Error('Automerge bug detected!');\n  }\n\n  return Reference.fromDXN(DXN.parse(dxnString));\n};\n\n/**\n * @deprecated Use `EncodedReference.isEncodedReference` instead.\n */\nexport const isEncodedReference = (value: any): value is EncodedReference =>\n  typeof value === 'object' && value !== null && Object.keys(value).length === 1 && typeof value['/'] === 'string';\n\nexport const EncodedReference = Object.freeze({\n  isEncodedReference,\n  getReferenceString: (value: EncodedReference): string => {\n    assertArgument(isEncodedReference(value), 'value', 'invalid reference');\n    return value['/'];\n  },\n  toDXN: (value: EncodedReference): DXN => {\n    return DXN.parse(EncodedReference.getReferenceString(value));\n  },\n  fromDXN: (dxn: DXN): EncodedReference => {\n    return { '/': dxn.toString() };\n  },\n  fromLegacyTypename: (typename: string): EncodedReference => {\n    return { '/': DXN.fromTypename(typename).toString() };\n  },\n});\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { FeedProtocol } from '@dxos/protocols';\n\nimport type { ForeignKey } from './foreign-key';\n\n/** Property name for meta when object is serialized to JSON. Matches @dxos/echo/internal ATTR_META. */\nconst ATTR_META = '@meta';\n\n/**\n * Codec for ECHO objects in feed block payload: JSON object ↔ UTF-8 bytes.\n * Encodes with queue position stripped; decodes with optional position injection.\n */\nexport class EchoFeedCodec {\n  static readonly #encoder = new TextEncoder();\n  static readonly #decoder = new TextDecoder();\n\n  /**\n   * Prepares a value for feed storage (strips queue position from metadata) and encodes to bytes.\n   */\n  static encode(value: Record<string, unknown>): Uint8Array {\n    const prepared = EchoFeedCodec.#stripQueuePosition(value);\n    return EchoFeedCodec.#encoder.encode(JSON.stringify(prepared));\n  }\n\n  /**\n   * Decodes feed block bytes to a JSON value.\n   * If position is provided, injects queue position into the decoded object's metadata.\n   */\n  static decode(data: Uint8Array, position?: number): Record<string, unknown> {\n    const decoded = JSON.parse(EchoFeedCodec.#decoder.decode(data));\n    if (position !== undefined && typeof decoded === 'object' && decoded !== null) {\n      EchoFeedCodec.#setQueuePosition(decoded, position);\n    }\n    return decoded;\n  }\n\n  static #stripQueuePosition(value: Record<string, unknown>): Record<string, unknown> {\n    if (typeof value !== 'object' || value === null) {\n      return value;\n    }\n    const obj = structuredClone(value);\n    const meta = obj[ATTR_META] as { keys?: ForeignKey[] } | undefined;\n    if (meta?.keys?.some((key: ForeignKey) => key.source === FeedProtocol.KEY_QUEUE_POSITION)) {\n      meta.keys = meta.keys.filter((key: ForeignKey) => key.source !== FeedProtocol.KEY_QUEUE_POSITION);\n    }\n    return obj;\n  }\n\n  static #setQueuePosition(obj: Record<string, any>, position: number): void {\n    obj[ATTR_META] ??= { keys: [] };\n    obj[ATTR_META]!.keys ??= [];\n    const keys = obj[ATTR_META]!.keys!;\n    for (let i = 0; i < keys.length; i++) {\n      if (keys[i].source === FeedProtocol.KEY_QUEUE_POSITION) {\n        keys.splice(i, 1);\n        i--;\n      }\n    }\n    keys.push({\n      source: FeedProtocol.KEY_QUEUE_POSITION,\n      id: position.toString(),\n    });\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\nimport * as SchemaAST from 'effect/SchemaAST';\n\nconst ForeignKey_ = Schema.Struct({\n  /**\n   * Name of the foreign database/system.\n   * E.g., `github.com`.\n   */\n  source: Schema.String,\n\n  /**\n   * Id within the foreign database.\n   */\n  // TODO(wittjosiah): This annotation is currently used to ensure id field shows up in forms.\n  // TODO(dmaretskyi): `false` is not a valid value for the annotation. Use a different annotation.\n  id: Schema.String.annotations({ [SchemaAST.IdentifierAnnotationId]: 'false' }),\n});\n\nexport type ForeignKey = Schema.Schema.Type<typeof ForeignKey_>;\n\n/**\n * Reference to an object in a foreign database.\n */\nexport const ForeignKey: Schema.Schema<ForeignKey> = ForeignKey_;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Match from 'effect/Match';\nimport * as Schema from 'effect/Schema';\n\nimport { DXN, ObjectId } from '@dxos/keys';\n\nimport { ForeignKey } from '../foreign-key';\n\nconst TypenameSpecifier = Schema.Union(DXN.Schema, Schema.Null).annotations({\n  description: 'DXN or null; null matches any type',\n});\n\n// NOTE: This pattern with 3 definitions per schema is need to make the types opaque, and circular references in AST to not cause compiler errors.\n\n/**\n * Filter by object type and properties.\n *\n * Clauses are combined using logical AND.\n */\n// TODO(burdon): Filter object vs. relation.\nconst FilterObject_ = Schema.Struct({\n  type: Schema.Literal('object'),\n\n  typename: TypenameSpecifier,\n\n  id: Schema.optional(Schema.Array(ObjectId)),\n\n  /**\n   * Filter by property.\n   * Must not include object ID.\n   */\n  props: Schema.Record({\n    key: Schema.String.annotations({ description: 'Property name' }),\n    value: Schema.suspend(() => Filter),\n  }),\n\n  /**\n   * Objects that have any of the given foreign keys.\n   */\n  foreignKeys: Schema.optional(Schema.Array(ForeignKey)),\n\n  // NOTE: Make sure to update `FilterStep.isNoop` if you change this.\n});\nexport interface FilterObject extends Schema.Schema.Type<typeof FilterObject_> {}\nexport const FilterObject: Schema.Schema<FilterObject> = FilterObject_;\n\n/**\n * Compare.\n */\nconst FilterCompare_ = Schema.Struct({\n  type: Schema.Literal('compare'),\n  operator: Schema.Literal('eq', 'neq', 'gt', 'gte', 'lt', 'lte'),\n  value: Schema.Unknown,\n});\nexport interface FilterCompare extends Schema.Schema.Type<typeof FilterCompare_> {}\nexport const FilterCompare: Schema.Schema<FilterCompare> = FilterCompare_;\n\n/**\n * In.\n */\nconst FilterIn_ = Schema.Struct({\n  type: Schema.Literal('in'),\n  values: Schema.Array(Schema.Any),\n});\nexport interface FilterIn extends Schema.Schema.Type<typeof FilterIn_> {}\nexport const FilterIn: Schema.Schema<FilterIn> = FilterIn_;\n\n/**\n * Contains.\n */\nconst FilterContains_ = Schema.Struct({\n  type: Schema.Literal('contains'),\n  value: Schema.Any,\n});\n\nexport interface FilterContains extends Schema.Schema.Type<typeof FilterContains_> {}\n\n/**\n * Predicate for an array property to contain the provided value.\n * Nested objects are matched using strict structural matching.\n */\nexport const FilterContains: Schema.Schema<FilterContains> = FilterContains_;\n\n/**\n * Filters objects that have certain tag.\n */\nconst FilterTag_ = Schema.Struct({\n  type: Schema.Literal('tag'),\n  tag: Schema.String, // TODO(burdon): Make OR-collection?\n});\n\nexport interface FilterTag extends Schema.Schema.Type<typeof FilterTag_> {}\nexport const FilterTag: Schema.Schema<FilterTag> = FilterTag_;\n\n/**\n * Range.\n */\nconst FilterRange_ = Schema.Struct({\n  type: Schema.Literal('range'),\n  from: Schema.Any,\n  to: Schema.Any,\n});\n\nexport interface FilterRange extends Schema.Schema.Type<typeof FilterRange_> {}\nexport const FilterRange: Schema.Schema<FilterRange> = FilterRange_;\n\n/**\n * Text search.\n */\nconst FilterTextSearch_ = Schema.Struct({\n  type: Schema.Literal('text-search'),\n  text: Schema.String,\n  searchKind: Schema.optional(Schema.Literal('full-text', 'vector')),\n});\n\nexport interface FilterTextSearch extends Schema.Schema.Type<typeof FilterTextSearch_> {}\nexport const FilterTextSearch: Schema.Schema<FilterTextSearch> = FilterTextSearch_;\n\n/**\n * Not.\n */\nconst FilterNot_ = Schema.Struct({\n  type: Schema.Literal('not'),\n  filter: Schema.suspend(() => Filter),\n});\n\nexport interface FilterNot extends Schema.Schema.Type<typeof FilterNot_> {}\nexport const FilterNot: Schema.Schema<FilterNot> = FilterNot_;\n\n/**\n * And.\n */\nconst FilterAnd_ = Schema.Struct({\n  type: Schema.Literal('and'),\n  filters: Schema.Array(Schema.suspend(() => Filter)),\n});\n\nexport interface FilterAnd extends Schema.Schema.Type<typeof FilterAnd_> {}\nexport const FilterAnd: Schema.Schema<FilterAnd> = FilterAnd_;\n\n/**\n * Or.\n */\nconst FilterOr_ = Schema.Struct({\n  type: Schema.Literal('or'),\n  filters: Schema.Array(Schema.suspend(() => Filter)),\n});\n\nexport interface FilterOr extends Schema.Schema.Type<typeof FilterOr_> {}\nexport const FilterOr: Schema.Schema<FilterOr> = FilterOr_;\n\n/**\n * Union of filters.\n */\nexport const Filter = Schema.Union(\n  FilterObject,\n  FilterCompare,\n  FilterIn,\n  FilterContains,\n  FilterTag,\n  FilterRange,\n  FilterTextSearch,\n  FilterNot,\n  FilterAnd,\n  FilterOr,\n).annotations({ identifier: 'dxos.org/schema/Filter' });\n\nexport type Filter = Schema.Schema.Type<typeof Filter>;\n\n/**\n * Query objects by type, id, and/or predicates.\n */\nconst QuerySelectClause_ = Schema.Struct({\n  type: Schema.Literal('select'),\n  filter: Schema.suspend(() => Filter),\n});\n\nexport interface QuerySelectClause extends Schema.Schema.Type<typeof QuerySelectClause_> {}\nexport const QuerySelectClause: Schema.Schema<QuerySelectClause> = QuerySelectClause_;\n\n/**\n * Filter objects from selection.\n */\nconst QueryFilterClause_ = Schema.Struct({\n  type: Schema.Literal('filter'),\n  selection: Schema.suspend(() => Query),\n  filter: Schema.suspend(() => Filter),\n});\n\nexport interface QueryFilterClause extends Schema.Schema.Type<typeof QueryFilterClause_> {}\nexport const QueryFilterClause: Schema.Schema<QueryFilterClause> = QueryFilterClause_;\n\n/**\n * Traverse references from an anchor object.\n */\nconst QueryReferenceTraversalClause_ = Schema.Struct({\n  type: Schema.Literal('reference-traversal'),\n  anchor: Schema.suspend(() => Query),\n  property: Schema.String, // TODO(dmaretskyi): Change to EscapedPropPath.\n});\n\nexport interface QueryReferenceTraversalClause extends Schema.Schema.Type<typeof QueryReferenceTraversalClause_> {}\nexport const QueryReferenceTraversalClause: Schema.Schema<QueryReferenceTraversalClause> =\n  QueryReferenceTraversalClause_;\n\n/**\n * Traverse incoming references to an anchor object.\n */\nconst QueryIncomingReferencesClause_ = Schema.Struct({\n  type: Schema.Literal('incoming-references'),\n  anchor: Schema.suspend(() => Query),\n  /**\n   * Property path where the reference is located.\n   * If null, matches references from any property.\n   */\n  property: Schema.NullOr(Schema.String),\n  typename: TypenameSpecifier,\n});\n\nexport interface QueryIncomingReferencesClause extends Schema.Schema.Type<typeof QueryIncomingReferencesClause_> {}\nexport const QueryIncomingReferencesClause: Schema.Schema<QueryIncomingReferencesClause> =\n  QueryIncomingReferencesClause_;\n\n/**\n * Traverse relations connecting to an anchor object.\n */\nconst QueryRelationClause_ = Schema.Struct({\n  type: Schema.Literal('relation'),\n  anchor: Schema.suspend(() => Query),\n  /**\n   * outgoing: anchor is the source of the relation.\n   * incoming: anchor is the target of the relation.\n   * both: anchor is either the source or target of the relation.\n   */\n  direction: Schema.Literal('outgoing', 'incoming', 'both'),\n  filter: Schema.optional(Schema.suspend(() => Filter)),\n});\n\nexport interface QueryRelationClause extends Schema.Schema.Type<typeof QueryRelationClause_> {}\nexport const QueryRelationClause: Schema.Schema<QueryRelationClause> = QueryRelationClause_;\n\n/**\n * Traverse into the source or target of a relation.\n */\nconst QueryRelationTraversalClause_ = Schema.Struct({\n  type: Schema.Literal('relation-traversal'),\n  anchor: Schema.suspend(() => Query),\n  direction: Schema.Literal('source', 'target', 'both'),\n});\n\nexport interface QueryRelationTraversalClause extends Schema.Schema.Type<typeof QueryRelationTraversalClause_> {}\nexport const QueryRelationTraversalClause: Schema.Schema<QueryRelationTraversalClause> = QueryRelationTraversalClause_;\n\n/**\n * Traverse parent-child hierarchy.\n */\nconst QueryHierarchyTraversalClause_ = Schema.Struct({\n  type: Schema.Literal('hierarchy-traversal'),\n  anchor: Schema.suspend(() => Query),\n  /**\n   * to-parent: traverse from child to parent.\n   * to-children: traverse from parent to children.\n   */\n  direction: Schema.Literal('to-parent', 'to-children'),\n});\n\nexport interface QueryHierarchyTraversalClause extends Schema.Schema.Type<typeof QueryHierarchyTraversalClause_> {}\nexport const QueryHierarchyTraversalClause: Schema.Schema<QueryHierarchyTraversalClause> =\n  QueryHierarchyTraversalClause_;\n\n/**\n * Union of multiple queries.\n */\nconst QueryUnionClause_ = Schema.Struct({\n  type: Schema.Literal('union'),\n  queries: Schema.Array(Schema.suspend(() => Query)),\n});\n\nexport interface QueryUnionClause extends Schema.Schema.Type<typeof QueryUnionClause_> {}\nexport const QueryUnionClause: Schema.Schema<QueryUnionClause> = QueryUnionClause_;\n\n/**\n * Set difference of two queries.\n */\nconst QuerySetDifferenceClause_ = Schema.Struct({\n  type: Schema.Literal('set-difference'),\n  source: Schema.suspend(() => Query),\n  exclude: Schema.suspend(() => Query),\n});\n\nexport interface QuerySetDifferenceClause extends Schema.Schema.Type<typeof QuerySetDifferenceClause_> {}\nexport const QuerySetDifferenceClause: Schema.Schema<QuerySetDifferenceClause> = QuerySetDifferenceClause_;\n\nexport const OrderDirection = Schema.Literal('asc', 'desc');\nexport type OrderDirection = Schema.Schema.Type<typeof OrderDirection>;\n\nconst Order_ = Schema.Union(\n  Schema.Struct({\n    // How database wants to order them (in practice - by id).\n    kind: Schema.Literal('natural'),\n  }),\n  Schema.Struct({\n    kind: Schema.Literal('property'),\n    property: Schema.String,\n    direction: OrderDirection,\n  }),\n  Schema.Struct({\n    // Order by relevance rank (for FTS/vector search results).\n    // Default direction is 'desc' (higher rank = better match first).\n    kind: Schema.Literal('rank'),\n    direction: OrderDirection,\n  }),\n);\n\nexport type Order = Schema.Schema.Type<typeof Order_>;\nexport const Order: Schema.Schema<Order> = Order_;\n\n/**\n * Order the query results.\n * Left-to-right the orders dominate.\n */\nconst QueryOrderClause_ = Schema.Struct({\n  type: Schema.Literal('order'),\n  query: Schema.suspend(() => Query),\n  order: Schema.Array(Order),\n});\n\nexport interface QueryOrderClause extends Schema.Schema.Type<typeof QueryOrderClause_> {}\nexport const QueryOrderClause: Schema.Schema<QueryOrderClause> = QueryOrderClause_;\n\n/**\n * Add options to a query.\n */\nconst QueryOptionsClause_ = Schema.Struct({\n  type: Schema.Literal('options'),\n  query: Schema.suspend(() => Query),\n  options: Schema.suspend(() => QueryOptions),\n});\n\nexport interface QueryOptionsClause extends Schema.Schema.Type<typeof QueryOptionsClause_> {}\nexport const QueryOptionsClause: Schema.Schema<QueryOptionsClause> = QueryOptionsClause_;\n\n/**\n * Limit the number of results.\n */\nconst QueryLimitClause_ = Schema.Struct({\n  type: Schema.Literal('limit'),\n  query: Schema.suspend(() => Query),\n  limit: Schema.Number,\n});\n\nexport interface QueryLimitClause extends Schema.Schema.Type<typeof QueryLimitClause_> {}\nexport const QueryLimitClause: Schema.Schema<QueryLimitClause> = QueryLimitClause_;\n\nconst Query_ = Schema.Union(\n  QuerySelectClause,\n  QueryFilterClause,\n  QueryReferenceTraversalClause,\n  QueryIncomingReferencesClause,\n  QueryRelationClause,\n  QueryRelationTraversalClause,\n  QueryHierarchyTraversalClause,\n  QueryUnionClause,\n  QuerySetDifferenceClause,\n  QueryOrderClause,\n  QueryOptionsClause,\n  QueryLimitClause,\n).annotations({ identifier: 'dxos.org/schema/Query' });\n\nexport type Query = Schema.Schema.Type<typeof Query_>;\nexport const Query: Schema.Schema<Query> = Query_;\n\nexport const QueryOptions = Schema.Struct({\n  /**\n   * The nested select statemets will select from the given spaces.\n   *\n   * NOTE: Spaces and queues are unioned together if both are specified.\n   */\n  spaceIds: Schema.optional(Schema.Array(Schema.String)),\n\n  /**\n   * If true, the nested select statements will select from all queues in the spaces specified by `spaceIds`.\n   */\n  allQueuesFromSpaces: Schema.optional(Schema.Boolean),\n\n  /**\n   * The nested select statemets will select from the given queues.\n   *\n   * NOTE: Spaces and queues are unioned together if both are specified.\n   */\n  queues: Schema.optional(Schema.Array(DXN.Schema)),\n\n  /**\n   * Nested select statements will use this option to filter deleted objects.\n   */\n  deleted: Schema.optional(Schema.Literal('include', 'exclude', 'only')),\n});\n\nexport interface QueryOptions extends Schema.Schema.Type<typeof QueryOptions> {}\n\nexport const visit = (query: Query, visitor: (node: Query) => void) => {\n  visitor(query);\n\n  Match.value(query).pipe(\n    Match.when({ type: 'filter' }, ({ selection }) => visit(selection, visitor)),\n    Match.when({ type: 'reference-traversal' }, ({ anchor }) => visit(anchor, visitor)),\n    Match.when({ type: 'incoming-references' }, ({ anchor }) => visit(anchor, visitor)),\n    Match.when({ type: 'relation' }, ({ anchor }) => visit(anchor, visitor)),\n    Match.when({ type: 'options' }, ({ query }) => visit(query, visitor)),\n    Match.when({ type: 'relation-traversal' }, ({ anchor }) => visit(anchor, visitor)),\n    Match.when({ type: 'hierarchy-traversal' }, ({ anchor }) => visit(anchor, visitor)),\n    Match.when({ type: 'union' }, ({ queries }) => queries.forEach((q) => visit(q, visitor))),\n    Match.when({ type: 'set-difference' }, ({ source, exclude }) => {\n      visit(source, visitor);\n      visit(exclude, visitor);\n    }),\n    Match.when({ type: 'order' }, ({ query }) => visit(query, visitor)),\n    Match.when({ type: 'limit' }, ({ query }) => visit(query, visitor)),\n    Match.when({ type: 'select' }, () => {}),\n    Match.exhaustive,\n  );\n};\n\nexport const fold = <T>(query: Query, reducer: (node: Query) => T): T[] => {\n  return Match.value(query).pipe(\n    Match.withReturnType<T[]>(),\n    Match.when({ type: 'filter' }, ({ selection }) => fold(selection, reducer)),\n    Match.when({ type: 'reference-traversal' }, ({ anchor }) => fold(anchor, reducer)),\n    Match.when({ type: 'incoming-references' }, ({ anchor }) => fold(anchor, reducer)),\n    Match.when({ type: 'relation' }, ({ anchor }) => fold(anchor, reducer)),\n    Match.when({ type: 'options' }, ({ query }) => fold(query, reducer)),\n    Match.when({ type: 'relation-traversal' }, ({ anchor }) => fold(anchor, reducer)),\n    Match.when({ type: 'hierarchy-traversal' }, ({ anchor }) => fold(anchor, reducer)),\n    Match.when({ type: 'union' }, ({ queries }) => queries.flatMap((q) => fold(q, reducer))),\n    Match.when({ type: 'set-difference' }, ({ source, exclude }) =>\n      fold(source, reducer).concat(fold(exclude, reducer)),\n    ),\n    Match.when({ type: 'order' }, ({ query }) => fold(query, reducer)),\n    Match.when({ type: 'limit' }, ({ query }) => fold(query, reducer)),\n    Match.when({ type: 'select' }, () => []),\n    Match.exhaustive,\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\n/**\n * Denotes the data version of the space automerge document as well as the leaf documents for each individual ECHO object.\n */\nexport type SpaceDocVersion = number & { __type: 'SpaceDocVersion' };\n\nexport const SpaceDocVersion = Object.freeze({\n  /**\n   * For the documents created before the versioning was introduced.\n   */\n  LEGACY: 0 as SpaceDocVersion,\n\n  /**\n   * Current version.\n   */\n  CURRENT: 1 as SpaceDocVersion,\n});\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { subtleCrypto } from '@dxos/crypto';\nimport { PublicKey, SpaceId } from '@dxos/keys';\nimport { ComplexMap } from '@dxos/util';\n\nconst SPACE_IDS_CACHE = new ComplexMap<PublicKey, SpaceId>(PublicKey.hash);\n\n/**\n * Space keys are generated by creating a keypair, and then taking the first 20 bytes of the SHA-256 hash of the public key and encoding them to multibase RFC4648 base-32 format (prefixed with B, see Multibase Table).\n * Inspired by how ethereum addresses are derived.\n */\nexport const createIdFromSpaceKey = async (spaceKey: PublicKey): Promise<SpaceId> => {\n  const cachedValue = SPACE_IDS_CACHE.get(spaceKey);\n  if (cachedValue !== undefined) {\n    return cachedValue;\n  }\n\n  const digest = await subtleCrypto.digest('SHA-256', spaceKey.asUint8Array() as Uint8Array<ArrayBuffer>);\n\n  const bytes = new Uint8Array(digest).slice(0, SpaceId.byteLength);\n  const spaceId = SpaceId.encode(bytes);\n  SPACE_IDS_CACHE.set(spaceKey, spaceId);\n  return spaceId;\n};\n"],
+  "mappings": "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",
+  "names": ["invariant", "visitValues", "assertArgument", "DXN", "LOCAL_SPACE_TAG", "Reference", "TYPE_PROTOCOL", "fromDXN", "dxn", "kind", "DXN", "TYPE", "parts", "ECHO", "LOCAL_SPACE_TAG", "undefined", "fromValue", "value", "objectId", "protocol", "host", "localObjectReference", "fromLegacyTypename", "type", "fromObjectIdAndSpaceKey", "spaceKey", "toHex", "_objectId", "_protocol", "_host", "_dxn", "encode", "toDXN", "REFERENCE_TYPE_TAG", "encodeReference", "reference", "toString", "decodeReference", "Error", "dxnString", "length", "slice", "includes", "parse", "isEncodedReference", "Object", "keys", "EncodedReference", "freeze", "getReferenceString", "assertArgument", "typename", "fromTypename", "DatabaseDirectory", "Object", "freeze", "getSpaceKey", "doc", "rawSpaceKey", "access", "spaceKey", "experimental_spaceKey", "rawKey", "String", "invariant", "startsWith", "getInlineObject", "id", "objects", "getLink", "links", "toString", "make", "ObjectStructure", "getTypeReference", "object", "system", "type", "getEntityKind", "kind", "isDeleted", "deleted", "getRelationSource", "source", "getRelationTarget", "target", "getParent", "parent", "getAllOutgoingReferences", "references", "visit", "path", "value", "isEncodedReference", "push", "reference", "visitValues", "key", "data", "getTags", "meta", "tags", "makeObject", "keys", "makeRelation", "PROPERTY_ID", "DATA_NAMESPACE", "FeedProtocol", "ATTR_META", "EchoFeedCodec", "TextEncoder", "TextDecoder", "encode", "value", "prepared", "JSON", "stringify", "decode", "data", "position", "decoded", "parse", "undefined", "obj", "structuredClone", "meta", "keys", "some", "key", "source", "FeedProtocol", "KEY_QUEUE_POSITION", "filter", "i", "length", "splice", "push", "id", "toString", "Schema", "SchemaAST", "ForeignKey_", "Struct", "source", "String", "id", "annotations", "IdentifierAnnotationId", "ForeignKey", "Match", "Schema", "DXN", "ObjectId", "TypenameSpecifier", "Union", "DXN", "Schema", "Null", "annotations", "description", "FilterObject_", "Struct", "type", "Literal", "typename", "id", "optional", "Array", "ObjectId", "props", "Record", "key", "String", "value", "suspend", "Filter", "foreignKeys", "ForeignKey", "FilterObject", "FilterCompare_", "operator", "Unknown", "FilterCompare", "FilterIn_", "values", "Any", "FilterIn", "FilterContains_", "FilterContains", "FilterTag_", "tag", "FilterTag", "FilterRange_", "from", "to", "FilterRange", "FilterTextSearch_", "text", "searchKind", "FilterTextSearch", "FilterNot_", "filter", "FilterNot", "FilterAnd_", "filters", "FilterAnd", "FilterOr_", "FilterOr", "identifier", "QuerySelectClause_", "QuerySelectClause", "QueryFilterClause_", "selection", "Query", "QueryFilterClause", "QueryReferenceTraversalClause_", "anchor", "property", "QueryReferenceTraversalClause", "QueryIncomingReferencesClause_", "NullOr", "QueryIncomingReferencesClause", "QueryRelationClause_", "direction", "QueryRelationClause", "QueryRelationTraversalClause_", "QueryRelationTraversalClause", "QueryHierarchyTraversalClause_", "QueryHierarchyTraversalClause", "QueryUnionClause_", "queries", "QueryUnionClause", "QuerySetDifferenceClause_", "source", "exclude", "QuerySetDifferenceClause", "OrderDirection", "Order_", "kind", "Order", "QueryOrderClause_", "query", "order", "QueryOrderClause", "QueryOptionsClause_", "options", "QueryOptions", "QueryOptionsClause", "QueryLimitClause_", "limit", "Number", "QueryLimitClause", "Query_", "spaceIds", "allQueuesFromSpaces", "Boolean", "queues", "deleted", "visit", "visitor", "Match", "pipe", "when", "forEach", "q", "exhaustive", "fold", "reducer", "withReturnType", "flatMap", "concat", "SpaceDocVersion", "Object", "freeze", "LEGACY", "CURRENT", "subtleCrypto", "PublicKey", "SpaceId", "ComplexMap", "SPACE_IDS_CACHE", "ComplexMap", "PublicKey", "hash", "createIdFromSpaceKey", "spaceKey", "cachedValue", "get", "undefined", "digest", "subtleCrypto", "asUint8Array", "bytes", "Uint8Array", "slice", "SpaceId", "byteLength", "spaceId", "encode", "set"]
+}

package/dist/lib/neutral/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/reference.ts":{"bytes":17438,"imports":[{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true}],"format":"esm"},"src/document-structure.ts":{"bytes":16741,"imports":[{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"src/reference.ts","kind":"import-statement","original":"./reference"}],"format":"esm"},"src/echo-feed-codec.ts":{"bytes":7835,"imports":[{"path":"@dxos/protocols","kind":"import-statement","external":true}],"format":"esm"},"src/foreign-key.ts":{"bytes":2618,"imports":[{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"effect/SchemaAST","kind":"import-statement","external":true}],"format":"esm"},"src/query/ast.ts":{"bytes":44393,"imports":[{"path":"effect/Match","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"src/foreign-key.ts","kind":"import-statement","original":"../foreign-key"}],"format":"esm"},"src/query/index.ts":{"bytes":516,"imports":[{"path":"src/query/ast.ts","kind":"import-statement","original":"./ast"}],"format":"esm"},"src/space-doc-version.ts":{"bytes":1538,"imports":[],"format":"esm"},"src/space-id.ts":{"bytes":3547,"imports":[{"path":"@dxos/crypto","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":1118,"imports":[{"path":"src/document-structure.ts","kind":"import-statement","original":"./document-structure"},{"path":"src/echo-feed-codec.ts","kind":"import-statement","original":"./echo-feed-codec"},{"path":"src/foreign-key.ts","kind":"import-statement","original":"./foreign-key"},{"path":"src/query/index.ts","kind":"import-statement","original":"./query"},{"path":"src/reference.ts","kind":"import-statement","original":"./reference"},{"path":"src/space-doc-version.ts","kind":"import-statement","original":"./space-doc-version"},{"path":"src/space-id.ts","kind":"import-statement","original":"./space-id"}],"format":"esm"}},"outputs":{"dist/lib/neutral/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":48581},"dist/lib/neutral/index.mjs":{"imports":[{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@dxos/protocols","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"effect/SchemaAST","kind":"import-statement","external":true},{"path":"effect/Match","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@dxos/crypto","kind":"import-statement","external":true},{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["DATA_NAMESPACE","DatabaseDirectory","EchoFeedCodec","EncodedReference","ForeignKey","ObjectStructure","PROPERTY_ID","QueryAST","REFERENCE_TYPE_TAG","Reference","SpaceDocVersion","createIdFromSpaceKey","decodeReference","encodeReference","isEncodedReference"],"entryPoint":"src/index.ts","inputs":{"src/document-structure.ts":{"bytesInOutput":3165},"src/reference.ts":{"bytesInOutput":3823},"src/index.ts":{"bytesInOutput":0},"src/echo-feed-codec.ts":{"bytesInOutput":1719},"src/foreign-key.ts":{"bytesInOutput":586},"src/query/ast.ts":{"bytesInOutput":10839},"src/query/index.ts":{"bytesInOutput":0},"src/space-doc-version.ts":{"bytesInOutput":179},"src/space-id.ts":{"bytesInOutput":604}},"bytes":21618}}}

package/dist/types/src/document-structure.d.ts

@@ -74,6 +74,7 @@ export declare const ObjectStructure: Readonly<{
     isDeleted: (object: ObjectStructure) => boolean;
     getRelationSource: (object: ObjectStructure) => EncodedReference | undefined;
     getRelationTarget: (object: ObjectStructure) => EncodedReference | undefined;
+    getParent: (object: ObjectStructure) => EncodedReference | undefined;
     /**
      * @returns All references in the data section of the object.
      */
@@ -81,6 +82,7 @@ export declare const ObjectStructure: Readonly<{
         path: ObjectPropPath;
         reference: EncodedReference;
     }[];
+    getTags: (object: ObjectStructure) => string[];
     makeObject: ({ type, data, keys, }: {
         type: DXN.String;
         deleted?: boolean;
@@ -104,6 +106,13 @@ export type ObjectMeta = {
      * Foreign keys.
      */
     keys: ForeignKey[];
+    /**
+     * Tags.
+     * An array of DXNs of Tag objects within the space.
+     *
+     * NOTE: Optional for backwards compatibilty.
+     */
+    tags?: string[];
 };
 /**
  * Automerge object system properties.
@@ -122,12 +131,17 @@ export type ObjectSystem = {
      * Deletion marker.
      */
     deleted?: boolean;
+    /**
+     * Object parent.
+     * Objects with no parent are at the top level of the object hierarchy in the space.
+     */
+    parent?: EncodedReference;
     /**
      * Only for relations.
      */
     source?: EncodedReference;
     /**
-     * Only for relations.w
+     * Only for relations.
      */
     target?: EncodedReference;
 };