@dxos/echo 0.10.0 → 0.11.1

package/dist/lib/neutral/chunk-3KTE2Y7Q.mjs

@@ -1,336 +0,0 @@
-import {
-  Feed,
-  getQueueUri
-} from "./chunk-XXWK4J53.mjs";
-import {
-  everything,
-  is,
-  props,
-  type
-} from "./chunk-SCT6FFCR.mjs";
-import {
-  getTypename,
-  getURI,
-  instanceOf
-} from "./chunk-HBXT3GSB.mjs";
-import {
-  prettyQuery
-} from "./chunk-ACFAOTKJ.mjs";
-import {
-  getTypeURIFromSpecifier,
-  isDatabase
-} from "./chunk-3TN2VMI4.mjs";
-import {
-  __export
-} from "./chunk-J5LGTIGS.mjs";
-
-// src/Query.ts
-var Query_exports = {};
-__export(Query_exports, {
-  all: () => all,
-  from: () => from,
-  fromAst: () => fromAst,
-  is: () => is2,
-  pretty: () => pretty,
-  select: () => select,
-  type: () => type2,
-  without: () => without
-});
-var QueryClass = class _QueryClass {
-  ast;
-  static "variance" = {};
-  constructor(ast) {
-    this.ast = ast;
-  }
-  "~Query" = _QueryClass.variance;
-  "select"(filter) {
-    if (is(filter)) {
-      return new _QueryClass({
-        type: "filter",
-        selection: this.ast,
-        filter: filter.ast
-      });
-    } else {
-      return new _QueryClass({
-        type: "filter",
-        selection: this.ast,
-        filter: props(filter).ast
-      });
-    }
-  }
-  "reference"(key) {
-    return new _QueryClass({
-      type: "reference-traversal",
-      anchor: this.ast,
-      property: key
-    });
-  }
-  "referencedBy"(target, key) {
-    const uri = target !== void 0 ? getTypeURIFromSpecifier(target) : null;
-    return new _QueryClass({
-      type: "incoming-references",
-      anchor: this.ast,
-      property: key ?? null,
-      typename: uri ?? null
-    });
-  }
-  "sourceOf"(relation, predicates) {
-    return new _QueryClass({
-      type: "relation",
-      anchor: this.ast,
-      direction: "outgoing",
-      filter: relation !== void 0 ? type(relation, predicates).ast : void 0
-    });
-  }
-  "targetOf"(relation, predicates) {
-    return new _QueryClass({
-      type: "relation",
-      anchor: this.ast,
-      direction: "incoming",
-      filter: relation !== void 0 ? type(relation, predicates).ast : void 0
-    });
-  }
-  "source"() {
-    return new _QueryClass({
-      type: "relation-traversal",
-      anchor: this.ast,
-      direction: "source"
-    });
-  }
-  "target"() {
-    return new _QueryClass({
-      type: "relation-traversal",
-      anchor: this.ast,
-      direction: "target"
-    });
-  }
-  "parent"() {
-    return new _QueryClass({
-      type: "hierarchy-traversal",
-      anchor: this.ast,
-      direction: "to-parent"
-    });
-  }
-  "children"() {
-    return new _QueryClass({
-      type: "hierarchy-traversal",
-      anchor: this.ast,
-      direction: "to-children"
-    });
-  }
-  "orderBy"(...order) {
-    return new _QueryClass({
-      type: "order",
-      query: this.ast,
-      order: order.map((o) => o.ast)
-    });
-  }
-  "limit"(limit) {
-    return new _QueryClass({
-      type: "limit",
-      query: this.ast,
-      limit
-    });
-  }
-  "from"(...args) {
-    if (args.length > 1 && args.every(_isRawScope)) {
-      return new _QueryClass({
-        type: "from",
-        query: this.ast,
-        from: {
-          _tag: "scope",
-          scopes: args
-        }
-      });
-    }
-    const [arg, options] = args;
-    if (arg == null) {
-      throw new TypeError('Query.from() requires a valid data source argument (database, feed, query, scope, or "all-accessible-spaces").');
-    }
-    if (is2(arg)) {
-      return new _QueryClass({
-        type: "from",
-        query: this.ast,
-        from: {
-          _tag: "query",
-          query: arg.ast
-        }
-      });
-    }
-    if (arg === "all-accessible-spaces") {
-      return new _QueryClass({
-        type: "from",
-        query: this.ast,
-        from: {
-          _tag: "scope",
-          scopes: []
-        }
-      });
-    }
-    if (Array.isArray(arg) && arg.every(_isRawScope)) {
-      return new _QueryClass({
-        type: "from",
-        query: this.ast,
-        from: {
-          _tag: "scope",
-          scopes: arg
-        }
-      });
-    }
-    if (_isRawScope(arg)) {
-      return new _QueryClass({
-        type: "from",
-        query: this.ast,
-        from: {
-          _tag: "scope",
-          scopes: [
-            arg
-          ]
-        }
-      });
-    }
-    const items = Array.isArray(arg) ? arg : [
-      arg
-    ];
-    if (items.length > 0 && isDatabase(items[0])) {
-      const databases = items;
-      return new _QueryClass({
-        type: "from",
-        query: this.ast,
-        from: {
-          _tag: "scope",
-          scopes: databases.map((db) => ({
-            _tag: "space",
-            spaceId: db.spaceId,
-            ...options?.includeFeeds ? {
-              includeAllFeeds: true
-            } : {}
-          }))
-        }
-      });
-    }
-    if (items.length > 0) {
-      const typename = getTypename(items[0]);
-      if (typename === "org.dxos.type.view") {
-        throw new Error("Query.from(view) is not yet supported.");
-      }
-      if (typename === "org.dxos.type.collection") {
-        throw new Error("Query.from(collection) is not yet supported.");
-      }
-      for (const item of items) {
-        if (!instanceOf(Feed, item)) {
-          throw new TypeError(`Query.from() expects Feed objects (org.dxos.type.feed), but received an object with typename '${typename ?? "unknown"}'.`);
-        }
-      }
-    }
-    const feedItems = items;
-    const feedScopes = feedItems.map((feed) => {
-      const uri = getQueueUri(feed);
-      if (!uri) {
-        throw new TypeError(`Query.from() expects persisted Feed objects with a queue URI; got feed without a space (id=${getURI(feed)}).`);
-      }
-      return {
-        _tag: "feed",
-        feedUri: String(uri)
-      };
-    });
-    return new _QueryClass({
-      type: "from",
-      query: this.ast,
-      from: {
-        _tag: "scope",
-        scopes: feedScopes
-      }
-    });
-  }
-  "options"(options) {
-    return new _QueryClass({
-      type: "options",
-      query: this.ast,
-      options
-    });
-  }
-  "debugLabel"(label) {
-    if (this.ast.type === "options") {
-      return new _QueryClass({
-        type: "options",
-        query: this.ast.query,
-        options: {
-          ...this.ast.options,
-          debugLabel: label
-        }
-      });
-    }
-    return new _QueryClass({
-      type: "options",
-      query: this.ast,
-      options: {
-        debugLabel: label
-      }
-    });
-  }
-};
-var is2 = (value) => {
-  return typeof value === "object" && value !== null && "~Query" in value;
-};
-var fromAst = (ast) => {
-  return new QueryClass(ast);
-};
-var select = (filter) => {
-  return new QueryClass({
-    type: "select",
-    filter: filter.ast
-  });
-};
-var type2 = (type3, predicates) => {
-  return new QueryClass({
-    type: "select",
-    filter: type(type3, predicates).ast
-  });
-};
-var all = (...queries) => {
-  if (queries.length === 0) {
-    throw new TypeError("Query.all combines results of multiple queries, to query all objects use Query.select(Filter.everything())");
-  }
-  return new QueryClass({
-    type: "union",
-    queries: queries.map((q) => q.ast)
-  });
-};
-var without = (source, exclude) => {
-  return new QueryClass({
-    type: "set-difference",
-    source: source.ast,
-    exclude: exclude.ast
-  });
-};
-var from = (...args) => {
-  const baseQuery = {
-    type: "select",
-    filter: everything().ast
-  };
-  const wrapper = new QueryClass(baseQuery);
-  return wrapper.from(...args);
-};
-var SCOPE_TAGS = /* @__PURE__ */ new Set([
-  "space",
-  "feed",
-  "registry"
-]);
-var _isRawScope = (value) => {
-  return typeof value === "object" && value !== null && !Array.isArray(value) && "_tag" in value && typeof value._tag === "string" && SCOPE_TAGS.has(value._tag);
-};
-var pretty = (query) => prettyQuery(query.ast);
-
-export {
-  is2 as is,
-  fromAst,
-  select,
-  type2 as type,
-  all,
-  without,
-  from,
-  pretty,
-  Query_exports
-};
-//# sourceMappingURL=chunk-3KTE2Y7Q.mjs.map

package/dist/lib/neutral/chunk-3KTE2Y7Q.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/Query.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as EffectArray from 'effect/Array';\nimport type * as Schema from 'effect/Schema';\n\nimport { type QueryAST } from '@dxos/echo-protocol';\nimport { type URI } from '@dxos/keys';\n\nimport type * as Collection from './Collection';\nimport * as Database from './Database';\nimport type * as Dataset from './Dataset';\nimport * as Feed from './Feed';\nimport * as Filter from './Filter';\nimport * as internal from './internal';\nimport * as Obj from './Obj';\nimport type * as Order from './Order';\nimport type * as Ref from './Ref';\nimport type * as Relation from './Relation';\n// eslint-disable-next-line @dxos/rules/import-as-namespace\nimport type * as Type$ from './Type';\nimport type * as View from './View';\n\n// TODO(dmaretskyi): Split up into interfaces for objects and relations so they can have separate verbs.\n// TODO(dmaretskyi): Undirected relation traversals.\n// TODO(wittjosiah): Make Filter & Query pipeable.\n\n/**\n * All property paths inside T that are references.\n */\n// TODO(dmaretskyi): Filter only properties that are references (or optional references, or unions that include references).\ntype RefPropKey<T> = keyof T & string;\n\ntype RefArrayElement<A> = A extends readonly (infer E)[] ? E : A extends (infer E)[] ? E : never;\n\n/** Target entity when traversing an outgoing ref or array-of-refs property. */\ntype ReferenceTraversalTarget<P> = P extends Ref.Unknown\n  ? Ref.Target<P>\n  : P extends Ref.Unknown | undefined\n    ? Ref.Target<Exclude<P, undefined>>\n    : RefArrayElement<P> extends Ref.Unknown\n      ? Ref.Target<RefArrayElement<P>>\n      : never;\n\n// TODO(burdon): Narrow T to Entity.Unknown?\nexport interface Query<T> {\n  // TODO(dmaretskyi): See new effect-schema approach to variance.\n  '~Query': { value: T };\n\n  'ast': QueryAST.Query;\n\n  /**\n   * Filter the current selection based on a filter.\n   * @param filter - Filter to select the objects.\n   * @returns Query for the selected objects.\n   */\n  'select'(filter: Filter.Filter<T>): Query<T>;\n  'select'(props: Filter.Props<T>): Query<T>;\n\n  /**\n   * Traverse an outgoing reference.\n   * @param key - Property path inside T that is a reference or optional reference.\n   * @returns Query for the target of the reference.\n   */\n  'reference'<K extends RefPropKey<T>>(key: K): Query<ReferenceTraversalTarget<T[K]>>;\n\n  /**\n   * Find objects referencing this object.\n   * @param target - Schema of the referencing object. If not provided, matches any type.\n   * @param key - Property path inside the referencing object that is a reference. If not provided, matches any property.\n   * @returns Query for the referencing objects.\n   */\n  // TODO(dmaretskyi): any way to enforce `Ref.Target<Schema.Schema.Type<S>[key]> == T`?\n  // TODO(dmaretskyi): Ability to go through arrays of references.\n  'referencedBy'<S extends Type$.AnyEntity>(\n    target: S | URI.URI,\n    key: RefPropKey<Type$.InstanceType<S>>,\n  ): Query<Type$.InstanceType<S>>;\n  'referencedBy'<S extends Type$.AnyEntity>(target: S | URI.URI): Query<Type$.InstanceType<S>>;\n  'referencedBy'(): Query<any>;\n\n  /**\n   * Find relations where this object is the source.\n   * @returns Query for the relation objects.\n   * @param relation - Schema of the relation.\n   * @param predicates - Predicates to filter the relation objects.\n   */\n  'sourceOf'<R extends Type$.AnyRelation>(\n    relation?: R | URI.URI,\n    predicates?: Filter.Props<Type$.InstanceType<R>>,\n  ): Query<Type$.InstanceType<R>>;\n\n  /**\n   * Find relations where this object is the target.\n   * @returns Query for the relation objects.\n   * @param relation - Type entity of the relation.\n   * @param predicates - Predicates to filter the relation objects.\n   */\n  'targetOf'<R extends Type$.AnyRelation>(\n    relation?: R | URI.URI,\n    predicates?: Filter.Props<Type$.InstanceType<R>>,\n  ): Query<Type$.InstanceType<R>>;\n\n  /**\n   * For a query for relations, get the source objects.\n   * @returns Query for the source objects.\n   */\n  'source'(): Query<Relation.SourceOf<T>>;\n\n  /**\n   * For a query for relations, get the target objects.\n   * @returns Query for the target objects.\n   */\n  'target'(): Query<Relation.TargetOf<T>>;\n\n  /**\n   * Get the parent object of the current selection.\n   * @returns Query for the parent objects.\n   */\n  'parent'(): Query<any>;\n\n  /**\n   * Get all child objects of the current selection.\n   * @returns Query for the child objects.\n   */\n  'children'(): Query<any>;\n\n  /**\n   * Order the query results.\n   * Orders are specified in priority order. The first order will be applied first, etc.\n   * @param order - Order to sort the results.\n   * @returns Query for the ordered results.\n   */\n  'orderBy'(...order: EffectArray.NonEmptyArray<Order.Order<T>>): Query<T>;\n\n  /**\n   * Limit the number of results.\n   * @param limit - Maximum number of results to return.\n   * @returns Query for the limited results.\n   */\n  'limit'(limit: number): Query<T>;\n\n  /**\n   * Query from selected databases only.\n   *\n   * Example:\n   *\n   * ```ts\n   * Query.select(Filter.type(Person)).from(db);\n   * ```\n   *\n   * @param options.includeFeeds [false] - Whether to include feeds in the query. Default is to query from automerge documents only.\n   */\n  'from'(database: Database.Database | Database.Database[], options?: { includeFeeds?: boolean }): Query<T>;\n\n  /**\n   * Query from selected feeds only.\n   *\n   * Example:\n   *\n   * ```ts\n   * Query.select(Filter.type(Person)).from(feed);\n   * ```\n   *\n   */\n  'from'(feeds: Feed.Feed | Feed.Feed[]): Query<T>;\n\n  /**\n   * Query from all accessible spaces.\n   *\n   * Example:\n   *\n   * ```ts\n   * Query.select(Filter.type(Person)).from('all-accessible-spaces');\n   * ```\n   *\n   * @param options.includeFeeds [false] - Whether to include feeds in the query. Default is to query from automerge documents only.\n   */\n  'from'(allSpaces: 'all-accessible-spaces', options?: { includeFeeds?: boolean }): Query<T>;\n\n  /**\n   * Query from a dataset.\n   * Currently only feeds are supported.\n   *\n   * Example:\n   *\n   * ```ts\n   * Query.type(Person).from(feed);\n   * ```\n   */\n  'from'(dataset: Dataset.Dataset): Query<T>;\n\n  /**\n   * Query from the results of another query.\n   *\n   * Example:\n   *\n   * ```ts\n   * Query.select(Filter.props({ foo: 'foo' })).from(Query.select(Filter.type(Contact)).reference('org'));\n   * ```\n   */\n  'from'(query: Any): Query<T>;\n\n  /**\n   * Query from one or more raw scopes.\n   *\n   * Use the {@link Scope} constructors rather than raw tagged objects:\n   *\n   * ```ts\n   * Query.select(Filter.type(Type.Type)).from(Scope.space(), Scope.registry());\n   * ```\n   */\n  'from'(...scopes: QueryAST.Scope[]): Query<T>;\n\n  /**\n   * Query from a raw scope or array of scopes.\n   */\n  'from'(scope: QueryAST.Scope | QueryAST.Scope[]): Query<T>;\n\n  /**\n   * Add options to a query.\n   */\n  'options'(options: QueryAST.QueryOptions): Query<T>;\n\n  /**\n   * Attach a diagnostic label for logs and tooling (execution semantics unchanged).\n   */\n  'debugLabel'(label: string): Query<T>;\n}\n\nexport type Any = Query<any>;\n\nexport type Type<Q extends Any> = Q extends Query<infer T> ? T : never;\n\nclass QueryClass implements Any {\n  private static 'variance': Any['~Query'] = {} as Any['~Query'];\n\n  'constructor'(public readonly ast: QueryAST.Query) {}\n\n  '~Query' = QueryClass.variance;\n\n  'select'(filter: Filter.Any | Filter.Props<any>): Any {\n    if (Filter.is(filter)) {\n      return new QueryClass({\n        type: 'filter',\n        selection: this.ast,\n        filter: filter.ast,\n      });\n    } else {\n      return new QueryClass({\n        type: 'filter',\n        selection: this.ast,\n        filter: Filter.props(filter).ast,\n      });\n    }\n  }\n\n  'reference'(key: string): Any {\n    return new QueryClass({\n      type: 'reference-traversal',\n      anchor: this.ast,\n      property: key,\n    });\n  }\n\n  'referencedBy'(target?: Type$.AnyEntity | URI.URI, key?: string): Any {\n    const uri = target !== undefined ? internal.getTypeURIFromSpecifier(target) : null;\n    return new QueryClass({\n      type: 'incoming-references',\n      anchor: this.ast,\n      property: key ?? null,\n      typename: uri ?? null,\n    });\n  }\n\n  'sourceOf'(relation?: Type$.AnyRelation | URI.URI, predicates?: Filter.Props<unknown> | undefined): Any {\n    return new QueryClass({\n      type: 'relation',\n      anchor: this.ast,\n      direction: 'outgoing',\n      filter: relation !== undefined ? Filter.type(relation, predicates).ast : undefined,\n    });\n  }\n\n  'targetOf'(relation?: Type$.AnyRelation | URI.URI, predicates?: Filter.Props<unknown> | undefined): Any {\n    return new QueryClass({\n      type: 'relation',\n      anchor: this.ast,\n      direction: 'incoming',\n      filter: relation !== undefined ? Filter.type(relation, predicates).ast : undefined,\n    });\n  }\n\n  'source'(): Any {\n    return new QueryClass({\n      type: 'relation-traversal',\n      anchor: this.ast,\n      direction: 'source',\n    });\n  }\n\n  'target'(): Any {\n    return new QueryClass({\n      type: 'relation-traversal',\n      anchor: this.ast,\n      direction: 'target',\n    });\n  }\n\n  'parent'(): Any {\n    return new QueryClass({\n      type: 'hierarchy-traversal',\n      anchor: this.ast,\n      direction: 'to-parent',\n    });\n  }\n\n  'children'(): Any {\n    return new QueryClass({\n      type: 'hierarchy-traversal',\n      anchor: this.ast,\n      direction: 'to-children',\n    });\n  }\n\n  'orderBy'(...order: Order.Order<any>[]): Any {\n    return new QueryClass({\n      type: 'order',\n      query: this.ast,\n      order: order.map((o) => o.ast),\n    });\n  }\n\n  'limit'(limit: number): Any {\n    return new QueryClass({\n      type: 'limit',\n      query: this.ast,\n      limit,\n    });\n  }\n\n  'from'(\n    ...args:\n      | [\n          (\n            | Database.Database\n            | Database.Database[]\n            | Feed.Feed\n            | Feed.Feed[]\n            | Collection.Collection\n            | View.View\n            | Any\n            | QueryAST.Scope\n            | QueryAST.Scope[]\n            | 'all-accessible-spaces'\n          ),\n          { includeFeeds?: boolean }?,\n        ]\n      | QueryAST.Scope[]\n  ): Any {\n    // Variadic raw scopes: `.from(Scope.space(), Scope.registry())`.\n    if (args.length > 1 && args.every(_isRawScope)) {\n      return new QueryClass({\n        type: 'from',\n        query: this.ast,\n        from: { _tag: 'scope', scopes: args as QueryAST.Scope[] },\n      });\n    }\n\n    const [arg, options] = args as [\n      (\n        | Database.Database\n        | Database.Database[]\n        | Feed.Feed\n        | Feed.Feed[]\n        | Collection.Collection\n        | View.View\n        | Any\n        | QueryAST.Scope\n        | QueryAST.Scope[]\n        | 'all-accessible-spaces'\n      ),\n      { includeFeeds?: boolean }?,\n    ];\n    if (arg == null) {\n      throw new TypeError(\n        'Query.from() requires a valid data source argument (database, feed, query, scope, or \"all-accessible-spaces\").',\n      );\n    }\n\n    if (is(arg)) {\n      return new QueryClass({\n        type: 'from',\n        query: this.ast,\n        from: { _tag: 'query', query: arg.ast },\n      });\n    }\n\n    if (arg === 'all-accessible-spaces') {\n      return new QueryClass({\n        type: 'from',\n        query: this.ast,\n        from: { _tag: 'scope', scopes: [] },\n      });\n    }\n\n    // Raw scope(s): tagged union objects with _tag 'space' | 'feed' | 'registry'.\n    if (Array.isArray(arg) && arg.every(_isRawScope)) {\n      return new QueryClass({\n        type: 'from',\n        query: this.ast,\n        from: { _tag: 'scope', scopes: arg as QueryAST.Scope[] },\n      });\n    }\n    if (_isRawScope(arg)) {\n      return new QueryClass({\n        type: 'from',\n        query: this.ast,\n        from: { _tag: 'scope', scopes: [arg] },\n      });\n    }\n\n    const items = Array.isArray(arg) ? arg : [arg];\n\n    if (items.length > 0 && Database.isDatabase(items[0])) {\n      const databases = items as Database.Database[];\n      return new QueryClass({\n        type: 'from',\n        query: this.ast,\n        from: {\n          _tag: 'scope',\n          scopes: databases.map((db) => ({\n            _tag: 'space' as const,\n            spaceId: db.spaceId,\n            ...(options?.includeFeeds ? { includeAllFeeds: true } : {}),\n          })),\n        },\n      });\n    }\n\n    if (items.length > 0) {\n      const typename = Obj.getTypename(items[0] as Obj.Unknown);\n      // TODO(dmaretskyi): Support querying from views.\n      if (typename === 'org.dxos.type.view') {\n        throw new Error('Query.from(view) is not yet supported.');\n      }\n      // TODO(dmaretskyi): Support querying from collections.\n      if (typename === 'org.dxos.type.collection') {\n        throw new Error('Query.from(collection) is not yet supported.');\n      }\n      // Validate that the items are Feed.Feed instances.\n      for (const item of items) {\n        if (!Obj.instanceOf(Feed.Feed, item)) {\n          throw new TypeError(\n            `Query.from() expects Feed objects (org.dxos.type.feed), but received an object with typename '${typename ?? 'unknown'}'.`,\n          );\n        }\n      }\n    }\n\n    const feedItems = items as Feed.Feed[];\n    const feedScopes = feedItems.map((feed) => {\n      const uri = Feed.getQueueUri(feed);\n      if (!uri) {\n        throw new TypeError(\n          `Query.from() expects persisted Feed objects with a queue URI; got feed without a space (id=${Obj.getURI(feed)}).`,\n        );\n      }\n      return { _tag: 'feed' as const, feedUri: String(uri) };\n    });\n    return new QueryClass({\n      type: 'from',\n      query: this.ast,\n      from: { _tag: 'scope', scopes: feedScopes },\n    });\n  }\n\n  'options'(options: QueryAST.QueryOptions): Any {\n    return new QueryClass({\n      type: 'options',\n      query: this.ast,\n      options,\n    });\n  }\n\n  'debugLabel'(label: string): Any {\n    if (this.ast.type === 'options') {\n      return new QueryClass({\n        type: 'options',\n        query: this.ast.query,\n        options: { ...this.ast.options, debugLabel: label },\n      });\n    }\n    return new QueryClass({\n      type: 'options',\n      query: this.ast,\n      options: { debugLabel: label },\n    });\n  }\n}\n\nexport const is = (value: unknown): value is Any => {\n  return typeof value === 'object' && value !== null && '~Query' in value;\n};\n\n/** Construct a query from an ast. */\nexport const fromAst = (ast: QueryAST.Query): Any => {\n  return new QueryClass(ast);\n};\n\n/**\n * Select objects based on a filter.\n * @param filter - Filter to select the objects.\n * @returns Query for the selected objects.\n */\nexport const select = <F extends Filter.Any>(filter: F): Query<Filter.Type<F>> => {\n  return new QueryClass({\n    type: 'select',\n    filter: filter.ast,\n  });\n};\n\n/**\n * Query for objects of a given schema.\n * @param schema - Schema of the objects.\n * @param predicates - Predicates to filter the objects.\n * @returns Query for the objects.\n *\n * Shorthand for: `Query.select(Filter.type(schema, predicates))`.\n */\nexport const type: {\n  <T extends Type$.AnyEntity>(type: T, predicates?: Filter.Props<Type$.InstanceType<T>>): Query<Type$.InstanceType<T>>;\n  // Brand-narrowed schema overload — only well-known unknown schemas pass.\n  <S extends internal.UnknownTypeSchema<any, any>>(\n    schema: S,\n    predicates?: Filter.Props<Schema.Schema.Type<S>>,\n  ): Query<Schema.Schema.Type<S>>;\n  <S extends Schema.Union<readonly Schema.Schema.AnyNoContext[]>>(\n    union: S,\n    predicates?: Filter.Props<Schema.Schema.Type<S>>,\n  ): Query<Schema.Schema.Type<S>>;\n  (uri: URI.URI, predicates?: Filter.Props<unknown>): Query<any>;\n} = (type: Type$.AnyEntity | URI.URI, predicates?: Filter.Props<unknown>): Any => {\n  return new QueryClass({\n    type: 'select',\n    filter: Filter.type(type, predicates).ast,\n  });\n};\n\n/**\n * Combine results of multiple queries.\n * @param queries - Queries to combine.\n * @returns Query for the combined results.\n */\n// TODO(dmaretskyi): Rename to `combine` or `union`.\nexport const all = (...queries: Any[]): Any => {\n  if (queries.length === 0) {\n    throw new TypeError(\n      'Query.all combines results of multiple queries, to query all objects use Query.select(Filter.everything())',\n    );\n  }\n  return new QueryClass({\n    type: 'union',\n    queries: queries.map((q) => q.ast),\n  });\n};\n\n/**\n * Subtract one query from another.\n * @param source - Query to subtract from.\n * @param exclude - Query to subtract.\n * @returns Query for the results of the source query minus the results of the exclude query.\n */\nexport const without = <T>(source: Query<T>, exclude: Query<T>): Query<T> => {\n  return new QueryClass({\n    type: 'set-difference',\n    source: source.ast,\n    exclude: exclude.ast,\n  });\n};\n\n/**\n * Create a query scoped to a data source.\n * The returned query selects everything from the source; chain `.select()` to narrow results.\n *\n * @param source - Data source: database, feed, 'all-accessible-spaces', or another query.\n * @returns Query scoped to the given source.\n */\nexport const from = (\n  ...args:\n    | [\n        (\n          | Database.Database\n          | Database.Database[]\n          | Feed.Feed\n          | Feed.Feed[]\n          | Any\n          | QueryAST.Scope\n          | QueryAST.Scope[]\n          | 'all-accessible-spaces'\n        ),\n        { includeFeeds?: boolean }?,\n      ]\n    | QueryAST.Scope[]\n): Any => {\n  const baseQuery: QueryAST.Query = {\n    type: 'select',\n    filter: Filter.everything().ast,\n  };\n  const wrapper = new QueryClass(baseQuery);\n  return (wrapper.from as (...args: unknown[]) => Any)(...args);\n};\n\nconst SCOPE_TAGS = new Set<string>(['space', 'feed', 'registry']);\n\n/** Detect a raw Scope tagged-union object. */\nconst _isRawScope = (value: unknown): value is QueryAST.Scope => {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !Array.isArray(value) &&\n    '_tag' in value &&\n    typeof value._tag === 'string' &&\n    SCOPE_TAGS.has(value._tag)\n  );\n};\n\n/**\n * Returns a human-readable string representation of a Query AST.\n */\nexport const pretty = (query: Any): string => internal.prettyQuery(query.ast);\n"],
-  "mappings": "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",
-  "names": ["is", "type", "QueryClass", "ast", "variance", "filter", "is", "type", "selection", "props", "key", "anchor", "property", "target", "uri", "undefined", "getTypeURIFromSpecifier", "typename", "relation", "predicates", "direction", "order", "query", "map", "o", "limit", "args", "length", "every", "_isRawScope", "from", "_tag", "scopes", "arg", "options", "TypeError", "Array", "isArray", "items", "isDatabase", "databases", "db", "spaceId", "includeFeeds", "includeAllFeeds", "getTypename", "Error", "item", "instanceOf", "Feed", "feedItems", "feedScopes", "feed", "getQueueUri", "getURI", "feedUri", "String", "label", "debugLabel", "value", "fromAst", "select", "all", "queries", "q", "without", "source", "exclude", "baseQuery", "everything", "wrapper", "SCOPE_TAGS", "Set", "has", "pretty", "prettyQuery"]
-}