@dxos/echo 0.8.4-main.937b3ca → 0.8.4-main.9735255

package/dist/lib/node-esm/chunk-MOLNWFNL.mjs

@@ -1,9 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-
-// src/SchemaRegistry.ts
-var SchemaRegistry_exports = {};
-
-export {
-  SchemaRegistry_exports
-};
-//# sourceMappingURL=chunk-MOLNWFNL.mjs.map

package/dist/lib/node-esm/chunk-MOLNWFNL.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/SchemaRegistry.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport type * as Types from 'effect/Types';\n\nimport type * as JsonSchema from './JsonSchema';\nimport type * as Key from './Key';\nimport type * as QueryResult from './QueryResult';\nimport type * as Type from './Type';\n\n// TODO(wittjosiah): Replace w/ Query.Query.\nexport type Query = {\n  /**\n   * Filter by schema ID.\n   * Schema id is a DXN with `echo` or `type` kind.\n   */\n  id?: string | string[];\n\n  /**\n   * Id of the backing ECHO object.\n   */\n  backingObjectId?: Key.ObjectId | Key.ObjectId[];\n\n  /**\n   * One or more typenames to filter by.\n   */\n  typename?: string | string[];\n\n  /**\n   * [Semver Range](https://docs.npmjs.com/cli/v6/using-npm/semver#ranges) for the schema version.\n   */\n  version?: string;\n\n  /**\n   * Where to look for the schema.\n   *\n   * Database schema are stored in the database of the current space.\n   * Runtime schema are registered in the runtime.\n   *\n   * @default ['database']\n   */\n  location?: ('database' | 'runtime')[];\n\n  /**\n   * Include system schemas.\n   * @default false\n   *\n   * The system schema include but are not limited to:\n   *  - dxos.org/type/Schema\n   */\n  includeSystem?: boolean;\n};\n\n/**\n * Input for schema registration.\n * The typename, version and schema mutability metadata is read from the schema annotations.\n *\n * Accepts:\n * - Branded ECHO schemas created with Type.Obj() or Type.Relation()\n * - JSON schema with typename and version\n */\nexport type RegisterSchemaInput =\n  | Type.Entity.Any\n  | {\n      typename: string;\n      version: string;\n      jsonSchema: JsonSchema.JsonSchema;\n      /**\n       * Display name of the schema.\n       */\n      name?: string;\n    };\n\nexport type ExtractQueryResult<Query> = Query extends { location: ('database' | 'runtime')[] }\n  ? Type.Entity.Any\n  : Type.RuntimeType;\n\nexport interface SchemaRegistry {\n  /**\n   * Checks if the provided schema is registered.\n   */\n  // TODO(burdon): Type?\n  hasSchema(schema: Type.Entity.Any): boolean;\n\n  /**\n   * Registers the provided schema.\n   *\n   * @returns Mutable runtime instances of schemas that were registered.\n   *\n   * The behavior of this method depends on the state of the database.\n   * The general principle is that the schema will be upserted into the space.\n   * If an equivalent schema with the same name and version already exists, the method does nothing.\n   * If a different schema with the same name and version exists, the method throws an error.\n   * If no schema with the same name and version exists, a new schema will be inserted based on semantic versioning rules.\n   */\n  register(input: RegisterSchemaInput[]): Promise<Type.RuntimeType[]>;\n\n  /**\n   *\n   */\n  query<Q extends Types.NoExcessProperties<Query, Q>>(\n    query?: Q & Query,\n  ): QueryResult.QueryResult<ExtractQueryResult<Q>>;\n}\n"],
-  "mappings": ";;;AAAA;",
-  "names": []
-}

package/dist/lib/node-esm/chunk-MOWUEW5P.mjs

@@ -1,15 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-
-// src/index.ts
-import { QueryAST } from "@dxos/echo-protocol";
-import { DXN } from "@dxos/keys";
-
-// src/Hypergraph.ts
-var Hypergraph_exports = {};
-
-export {
-  Hypergraph_exports,
-  QueryAST,
-  DXN
-};
-//# sourceMappingURL=chunk-MOWUEW5P.mjs.map

package/dist/lib/node-esm/chunk-NBWL7UCZ.mjs

@@ -1,40 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-import {
-  DescriptionAnnotation,
-  FormInputAnnotation,
-  GeneratorAnnotation,
-  LabelAnnotation,
-  ReferenceAnnotation,
-  SystemTypeAnnotation,
-  TypeAnnotation,
-  getDescriptionWithSchema,
-  getLabelWithSchema,
-  getTypeAnnotation,
-  setDescriptionWithSchema,
-  setLabelWithSchema
-} from "./chunk-YOLH5KS4.mjs";
-import {
-  __export
-} from "./chunk-HSLMI22Q.mjs";
-
-// src/Annotation.ts
-var Annotation_exports = {};
-__export(Annotation_exports, {
-  DescriptionAnnotation: () => DescriptionAnnotation,
-  FormInputAnnotation: () => FormInputAnnotation,
-  GeneratorAnnotation: () => GeneratorAnnotation,
-  LabelAnnotation: () => LabelAnnotation,
-  ReferenceAnnotation: () => ReferenceAnnotation,
-  SystemTypeAnnotation: () => SystemTypeAnnotation,
-  TypeAnnotation: () => TypeAnnotation,
-  getDescriptionWithSchema: () => getDescriptionWithSchema,
-  getLabelWithSchema: () => getLabelWithSchema,
-  getTypeAnnotation: () => getTypeAnnotation,
-  setDescriptionWithSchema: () => setDescriptionWithSchema,
-  setLabelWithSchema: () => setLabelWithSchema
-});
-
-export {
-  Annotation_exports
-};
-//# sourceMappingURL=chunk-NBWL7UCZ.mjs.map

package/dist/lib/node-esm/chunk-NRN3ZW2T.mjs

@@ -1,143 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-import {
-  EchoObjectSchema,
-  EchoRelationSchema,
-  EchoSchema,
-  PersistentSchema,
-  Ref,
-  isMutable,
-  toEffectSchema,
-  toJsonSchema
-} from "./chunk-LT3H4JOX.mjs";
-import {
-  getSchemaDXN,
-  getSchemaTypename,
-  getSchemaVersion,
-  getTypeAnnotation
-} from "./chunk-YOLH5KS4.mjs";
-import {
-  ANY_OBJECT_TYPENAME,
-  ANY_OBJECT_VERSION,
-  EntityKind,
-  SchemaKindId
-} from "./chunk-XHJRMQZD.mjs";
-import {
-  __export
-} from "./chunk-HSLMI22Q.mjs";
-
-// src/Type.ts
-var Type_exports = {};
-__export(Type_exports, {
-  Entity: () => Entity,
-  Obj: () => Obj,
-  PersistentType: () => PersistentType,
-  Ref: () => Ref2,
-  Relation: () => Relation,
-  RuntimeType: () => EchoSchema,
-  getDXN: () => getDXN,
-  getMeta: () => getMeta,
-  getTypename: () => getTypename,
-  getVersion: () => getVersion,
-  isMutable: () => isMutable2,
-  isObjectSchema: () => isObjectSchema,
-  isRelationSchema: () => isRelationSchema,
-  object: () => object,
-  relation: () => relation,
-  toEffectSchema: () => toEffectSchema,
-  toJsonSchema: () => toJsonSchema
-});
-import * as Schema from "effect/Schema";
-import { invariant } from "@dxos/invariant";
-var __dxlog_file = "/__w/dxos/dxos/packages/core/echo/echo/src/Type.ts";
-var ObjSchema = Schema.Struct({
-  id: Schema.String
-}).pipe(Schema.extend(Schema.Record({
-  key: Schema.String,
-  value: Schema.Unknown
-})), EchoObjectSchema({
-  typename: ANY_OBJECT_TYPENAME,
-  version: ANY_OBJECT_VERSION
-}));
-var Obj = Object.assign(ObjSchema, {
-  [SchemaKindId]: ObjSchema[SchemaKindId]
-});
-var object = EchoObjectSchema;
-var PersistentType = PersistentSchema;
-var RelationSchema = Schema.Struct({
-  id: Schema.String
-}).pipe(Schema.extend(Schema.Record({
-  key: Schema.String,
-  value: Schema.Unknown
-})), EchoRelationSchema({
-  typename: "dxos.org/schema/AnyRelation",
-  version: "0.0.0",
-  source: ObjSchema,
-  target: ObjSchema
-}));
-var Relation = Object.assign(RelationSchema, {
-  [SchemaKindId]: RelationSchema[SchemaKindId]
-});
-var relation = EchoRelationSchema;
-(function(Entity2) {
-  Entity2.Any = Schema.Union(Obj, Relation);
-})(Entity || (Entity = {}));
-var isObjectSchema = (schema) => {
-  return schema[SchemaKindId] === EntityKind.Object;
-};
-var isRelationSchema = (schema) => {
-  return schema[SchemaKindId] === EntityKind.Relation;
-};
-var Ref2 = Ref;
-var getDXN = (schema) => {
-  return getSchemaDXN(schema);
-};
-var getTypename = (schema) => {
-  const typename = getSchemaTypename(schema);
-  invariant(typeof typename === "string" && !typename.startsWith("dxn:"), "Invalid typename", {
-    F: __dxlog_file,
-    L: 463,
-    S: void 0,
-    A: [
-      "typeof typename === 'string' && !typename.startsWith('dxn:')",
-      "'Invalid typename'"
-    ]
-  });
-  return typename;
-};
-var getVersion = (schema) => {
-  const version = getSchemaVersion(schema);
-  invariant(typeof version === "string" && version.match(/^\d+\.\d+\.\d+$/), "Invalid version", {
-    F: __dxlog_file,
-    L: 473,
-    S: void 0,
-    A: [
-      "typeof version === 'string' && version.match(/^\\d+\\.\\d+\\.\\d+$/)",
-      "'Invalid version'"
-    ]
-  });
-  return version;
-};
-var isMutable2 = isMutable;
-var getMeta = (schema) => {
-  return getTypeAnnotation(schema);
-};
-var Entity;
-
-export {
-  Obj,
-  object,
-  PersistentType,
-  Relation,
-  relation,
-  isObjectSchema,
-  isRelationSchema,
-  Ref2 as Ref,
-  getDXN,
-  getTypename,
-  getVersion,
-  isMutable2 as isMutable,
-  getMeta,
-  Entity,
-  Type_exports
-};
-//# sourceMappingURL=chunk-NRN3ZW2T.mjs.map

package/dist/lib/node-esm/chunk-QLI2EIJ2.mjs

@@ -1,41 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-import {
-  Ref,
-  RefArray,
-  getSchemaReference
-} from "./chunk-LT3H4JOX.mjs";
-import {
-  __export
-} from "./chunk-HSLMI22Q.mjs";
-
-// src/Ref.ts
-var Ref_exports = {};
-__export(Ref_exports, {
-  Array: () => Array,
-  fromDXN: () => fromDXN,
-  isRef: () => isRef,
-  isRefType: () => isRefType,
-  make: () => make
-});
-import * as Option from "effect/Option";
-import * as SchemaAST from "effect/SchemaAST";
-var Array = RefArray;
-var isRef = Ref.isRef;
-var make = Ref.make;
-var fromDXN = Ref.fromDXN;
-var isRefType = (ast) => {
-  return SchemaAST.getAnnotation(ast, SchemaAST.JSONSchemaAnnotationId).pipe(Option.flatMap((jsonSchema) => "$id" in jsonSchema ? Option.some(jsonSchema) : Option.none()), Option.flatMap((jsonSchema) => {
-    const { typename } = getSchemaReference(jsonSchema) ?? {};
-    return typename ? Option.some(true) : Option.some(false);
-  }), Option.getOrElse(() => false));
-};
-
-export {
-  Array,
-  isRef,
-  make,
-  fromDXN,
-  isRefType,
-  Ref_exports
-};
-//# sourceMappingURL=chunk-QLI2EIJ2.mjs.map

package/dist/lib/node-esm/chunk-QYR67VBV.mjs

@@ -1,288 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-import {
-  isRef
-} from "./chunk-QLI2EIJ2.mjs";
-import {
-  getTypeDXNFromSpecifier
-} from "./chunk-YOLH5KS4.mjs";
-import {
-  __export
-} from "./chunk-HSLMI22Q.mjs";
-
-// src/Filter.ts
-var Filter_exports = {};
-__export(Filter_exports, {
-  and: () => and,
-  between: () => between,
-  contains: () => contains,
-  eq: () => eq,
-  everything: () => everything,
-  foreignKeys: () => foreignKeys,
-  fromAst: () => fromAst,
-  gt: () => gt,
-  gte: () => gte,
-  id: () => id,
-  in: () => in$,
-  is: () => is,
-  lt: () => lt,
-  lte: () => lte,
-  neq: () => neq,
-  not: () => not,
-  nothing: () => nothing,
-  or: () => or,
-  props: () => props,
-  tag: () => tag,
-  text: () => text,
-  type: () => type,
-  typeDXN: () => typeDXN,
-  typename: () => typename
-});
-import * as Match from "effect/Match";
-import * as Schema from "effect/Schema";
-import { assertArgument } from "@dxos/invariant";
-import { DXN, ObjectId } from "@dxos/keys";
-var FilterClass = class _FilterClass {
-  ast;
-  static variance = {};
-  constructor(ast) {
-    this.ast = ast;
-  }
-  "~Filter" = _FilterClass.variance;
-};
-var is = (value2) => {
-  return typeof value2 === "object" && value2 !== null && "~Filter" in value2;
-};
-var fromAst = (ast) => {
-  return new FilterClass(ast);
-};
-var everything = () => {
-  return new FilterClass({
-    type: "object",
-    typename: null,
-    props: {}
-  });
-};
-var nothing = () => {
-  return new FilterClass({
-    type: "not",
-    filter: {
-      type: "object",
-      typename: null,
-      props: {}
-    }
-  });
-};
-var id = (...ids) => {
-  assertArgument(ids.every((id2) => ObjectId.isValid(id2)), "ids", "ids must be valid");
-  if (ids.length === 0) {
-    return nothing();
-  }
-  return new FilterClass({
-    type: "object",
-    typename: null,
-    id: ids,
-    props: {}
-  });
-};
-var type = (schema, props2) => {
-  const dxn = getTypeDXNFromSpecifier(schema);
-  return new FilterClass({
-    type: "object",
-    typename: dxn.toString(),
-    ...propsFilterToAst(props2 ?? {})
-  });
-};
-var typename = (typename2) => {
-  assertArgument(!typename2.startsWith("dxn:"), "typename", "Typename must no be qualified");
-  return new FilterClass({
-    type: "object",
-    typename: DXN.fromTypename(typename2).toString(),
-    props: {}
-  });
-};
-var typeDXN = (dxn) => {
-  return new FilterClass({
-    type: "object",
-    typename: dxn.toString(),
-    props: {}
-  });
-};
-var tag = (tag2) => {
-  return new FilterClass({
-    type: "tag",
-    tag: tag2
-  });
-};
-var props = (props2) => {
-  return new FilterClass({
-    type: "object",
-    typename: null,
-    ...propsFilterToAst(props2)
-  });
-};
-var text = (text2, options) => {
-  return new FilterClass({
-    type: "text-search",
-    text: text2,
-    searchKind: options?.type
-  });
-};
-var foreignKeys = (schema, keys) => {
-  const dxn = getTypeDXNFromSpecifier(schema);
-  return new FilterClass({
-    type: "object",
-    typename: dxn.toString(),
-    props: {},
-    foreignKeys: keys
-  });
-};
-var eq = (value2) => {
-  if (!isRef(value2) && typeof value2 === "object" && value2 !== null) {
-    throw new TypeError("Cannot use object as a value for eq filter");
-  }
-  return new FilterClass({
-    type: "compare",
-    operator: "eq",
-    value: isRef(value2) ? value2.noInline().encode() : value2
-  });
-};
-var neq = (value2) => {
-  return new FilterClass({
-    type: "compare",
-    operator: "neq",
-    value: value2
-  });
-};
-var gt = (value2) => {
-  return new FilterClass({
-    type: "compare",
-    operator: "gt",
-    value: value2
-  });
-};
-var gte = (value2) => {
-  return new FilterClass({
-    type: "compare",
-    operator: "gte",
-    value: value2
-  });
-};
-var lt = (value2) => {
-  return new FilterClass({
-    type: "compare",
-    operator: "lt",
-    value: value2
-  });
-};
-var lte = (value2) => {
-  return new FilterClass({
-    type: "compare",
-    operator: "lte",
-    value: value2
-  });
-};
-var in$ = (...values) => {
-  return new FilterClass({
-    type: "in",
-    values
-  });
-};
-var contains = (value2) => {
-  return new FilterClass({
-    type: "contains",
-    value: value2
-  });
-};
-var between = (from, to) => {
-  return new FilterClass({
-    type: "range",
-    from,
-    to
-  });
-};
-var not = (filter) => {
-  return new FilterClass({
-    type: "not",
-    filter: filter.ast
-  });
-};
-var and = (...filters) => {
-  return new FilterClass({
-    type: "and",
-    filters: filters.map((f) => f.ast)
-  });
-};
-var or = (...filters) => {
-  return new FilterClass({
-    type: "or",
-    filters: filters.map((f) => f.ast)
-  });
-};
-var propsFilterToAst = (predicates) => {
-  let idFilter;
-  if ("id" in predicates) {
-    assertArgument(typeof predicates.id === "string" || Array.isArray(predicates.id), "predicates.id", "invalid id filter");
-    idFilter = typeof predicates.id === "string" ? [
-      predicates.id
-    ] : predicates.id;
-    Schema.Array(ObjectId).pipe(Schema.validateSync)(idFilter);
-  }
-  return {
-    id: idFilter,
-    props: Object.fromEntries(Object.entries(predicates).filter(([prop, _value]) => prop !== "id").map(([prop, predicate]) => [
-      prop,
-      processPredicate(predicate)
-    ]))
-  };
-};
-var processPredicate = (predicate) => {
-  return Match.value(predicate).pipe(
-    Match.withReturnType(),
-    Match.when(is, (predicate2) => predicate2.ast),
-    // TODO(wittjosiah): Add support for array predicates.
-    Match.when(Array.isArray, (_predicate) => {
-      throw new Error("Array predicates are not yet supported.");
-    }),
-    Match.when((predicate2) => !isRef(predicate2) && typeof predicate2 === "object" && predicate2 !== null, (predicate2) => {
-      const nestedProps = Object.fromEntries(Object.entries(predicate2).map(([key, value2]) => [
-        key,
-        processPredicate(value2)
-      ]));
-      return {
-        type: "object",
-        typename: null,
-        props: nestedProps
-      };
-    }),
-    Match.orElse((value2) => eq(value2).ast)
-  );
-};
-
-export {
-  is,
-  fromAst,
-  everything,
-  nothing,
-  id,
-  type,
-  typename,
-  typeDXN,
-  tag,
-  props,
-  text,
-  foreignKeys,
-  eq,
-  neq,
-  gt,
-  gte,
-  lt,
-  lte,
-  in$,
-  contains,
-  between,
-  not,
-  and,
-  or,
-  Filter_exports
-};
-//# sourceMappingURL=chunk-QYR67VBV.mjs.map

package/dist/lib/node-esm/chunk-UKGVOINP.mjs

@@ -1,9 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-
-// src/QueryResult.ts
-var QueryResult_exports = {};
-
-export {
-  QueryResult_exports
-};
-//# sourceMappingURL=chunk-UKGVOINP.mjs.map

package/dist/lib/node-esm/chunk-UKGVOINP.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/QueryResult.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type CleanupFn } from '@dxos/async';\n\nimport type * as Entity from './Entity';\n\n/**\n * Individual query result entry.\n */\nexport type Entry<T> = {\n  id: string;\n\n  /**\n   * May not be present for remote results.\n   */\n  result?: T;\n\n  match?: {\n    // TODO(dmaretskyi): text positional info.\n\n    /**\n     * Higher means better match.\n     */\n    rank: number;\n  };\n\n  /**\n   * Query resolution metadata.\n   */\n  // TODO(dmaretskyi): Rename to meta?\n  resolution?: {\n    // TODO(dmaretskyi): Make this more generic.\n    source: 'remote' | 'local' | 'index';\n\n    /**\n     * Query resolution time in milliseconds.\n     */\n    time: number;\n  };\n};\n\n/**\n * Invidual query result entry for a database Entity.\n */\nexport type EntityEntry<T extends Entity.Unknown = Entity.Unknown> = Entry<T>;\n\nexport type RunOptions = {\n  timeout?: number;\n};\n\nexport type SubscriptionOptions = {\n  /**\n   * Fire the callback immediately.\n   */\n  fire?: boolean;\n};\n\n// TODO(burdon): Should T be constrained to Entity.Any?\nexport interface QueryResult<T> {\n  /**\n   * Currently available results along with their match metadata.\n   */\n  readonly entries: Entry<T>[];\n\n  /**\n   * Currently available results.\n   */\n  readonly results: T[];\n\n  /**\n   * Returns all known results.\n   */\n  run(opts?: RunOptions): Promise<T[]>;\n\n  /**\n   * Returns all known results along with their match metadata.\n   */\n  runEntries(opts?: RunOptions): Promise<Entry<T>[]>;\n\n  /**\n   * Returns currently available results synchronously.\n   */\n  runSync(): T[];\n\n  /**\n   * Returns currently available results synchronously along with their match metadata.\n   */\n  runSyncEntries(): Entry<T>[];\n\n  /**\n   * Returns first result.\n   */\n  first(opts?: RunOptions): Promise<T>;\n\n  /**\n   * Returns first result if there is one.\n   */\n  firstOrUndefined(opts?: RunOptions): Promise<T | undefined>;\n\n  /**\n   * Subscribes to changes in query results.\n   */\n  subscribe(callback?: (query: QueryResult<T>) => void, opts?: SubscriptionOptions): CleanupFn;\n}\n"],
-  "mappings": ";;;AAAA;",
-  "names": []
-}