@dxos/echo 0.8.4-main.ae835ea → 0.8.4-main.bc674ce

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

@@ -0,0 +1,366 @@
+import "../chunk-X2MPMYYN.mjs";
+import "../chunk-IP2GHXWA.mjs";
+import "../chunk-ROKO4RKJ.mjs";
+import "../chunk-ANHVGJI4.mjs";
+import {
+  Obj,
+  Ref,
+  Type_exports,
+  object,
+  relation
+} from "../chunk-XMIDBDE6.mjs";
+import "../chunk-4TT624YA.mjs";
+import "../chunk-VR4A4WGG.mjs";
+import "../chunk-3ZEAZF7T.mjs";
+import "../chunk-OMUPQMLR.mjs";
+import "../chunk-XK5OUUBY.mjs";
+import "../chunk-VB5HVDCA.mjs";
+import "../chunk-HMOXCO27.mjs";
+import "../chunk-4L6DOFXP.mjs";
+import "../chunk-2MTHJ5UW.mjs";
+import "../chunk-6QPSGMEF.mjs";
+import {
+  EchoSchema,
+  PersistentSchema,
+  makeObject,
+  subscribe,
+  toJsonSchema
+} from "../chunk-SU2LVM7J.mjs";
+import "../chunk-62DWJ6CE.mjs";
+import "../chunk-NWUO5FKZ.mjs";
+import "../chunk-KRHDMXSU.mjs";
+import {
+  getSchemaTypename
+} from "../chunk-CUDIBUM4.mjs";
+import "../chunk-YQYMWZAD.mjs";
+import "../chunk-RPB6V4BE.mjs";
+import "../chunk-J5LGTIGS.mjs";
+
+// src/testing/test-data.ts
+import { DatabaseDirectory, ObjectStructure } from "@dxos/echo-protocol";
+import { DXN, ObjectId, PublicKey } from "@dxos/keys";
+
+// src/testing/test-schema.ts
+import * as Schema from "effect/Schema";
+(function(TestSchema2) {
+  TestSchema2.Expando = Schema.Struct({}, {
+    key: Schema.String,
+    value: Schema.Any
+  }).pipe(object({
+    typename: "example.com/type/Expando",
+    version: "0.1.0"
+  }));
+  const Nested = Schema.Struct({
+    field: Schema.String
+  });
+  class TestClass {
+    field = "value";
+    toJSON() {
+      return {
+        field: this.field
+      };
+    }
+  }
+  TestSchema2.TestClass = TestClass;
+  TestSchema2.ExampleSchema = Schema.Struct({
+    string: Schema.String,
+    number: Schema.Number,
+    boolean: Schema.Boolean,
+    null: Schema.Null,
+    undefined: Schema.Undefined,
+    stringArray: Schema.Array(Schema.String),
+    twoDimNumberArray: Schema.Array(Schema.Array(Schema.Number)),
+    nested: Nested,
+    nestedArray: Schema.Array(Nested),
+    nestedNullableArray: Schema.Array(Schema.Union(Nested, Schema.Null)),
+    reference: Schema.suspend(() => Ref(TestSchema2.Example)),
+    referenceArray: Schema.Array(Schema.suspend(() => Ref(TestSchema2.Example))),
+    classInstance: Schema.instanceOf(TestClass),
+    other: Schema.Any
+  }).pipe(Schema.partial);
+  TestSchema2.Example = TestSchema2.ExampleSchema.pipe(object({
+    typename: "example.com/type/Example",
+    version: "0.1.0"
+  }));
+  TestSchema2.MessageStruct = Schema.Struct({
+    // TODO(burdon): Support S.Date; Custom Timestamp (with defaults).
+    // TODO(burdon): Support defaults (update create and create).
+    timestamp: Schema.String.pipe(Schema.propertySignature, Schema.withConstructorDefault(() => (/* @__PURE__ */ new Date()).toISOString()))
+  });
+  TestSchema2.Message = TestSchema2.MessageStruct.pipe(object({
+    typename: "example.com/type/Message",
+    version: "0.1.0"
+  }));
+  TestSchema2.Organization = Schema.Struct({
+    name: Schema.String,
+    properties: Schema.optional(Schema.Record({
+      key: Schema.String,
+      value: Schema.String
+    }))
+  }).pipe(object({
+    typename: "example.com/type/Organization",
+    version: "0.1.0"
+  }));
+  TestSchema2.Person = Schema.Struct({
+    name: Schema.String,
+    username: Schema.String,
+    email: Schema.String,
+    age: Schema.Number.pipe(Schema.optional),
+    tasks: Schema.Array(Schema.suspend(() => Ref(TestSchema2.Task))),
+    employer: Schema.optional(Ref(TestSchema2.Organization)),
+    address: Schema.Struct({
+      city: Schema.optional(Schema.String),
+      state: Schema.optional(Schema.String),
+      zip: Schema.optional(Schema.String),
+      coordinates: Schema.Struct({
+        lat: Schema.optional(Schema.Number),
+        lng: Schema.optional(Schema.Number)
+      })
+    }),
+    fields: Schema.Struct({
+      label: Schema.String,
+      value: Schema.String
+    }).pipe(Schema.Array, Schema.optional)
+  }).pipe(Schema.partial, object({
+    typename: "example.com/type/Person",
+    version: "0.1.0"
+  }));
+  TestSchema2.Task = Schema.Struct({
+    title: Schema.optional(Schema.String),
+    deadline: Schema.optional(Schema.String),
+    completed: Schema.optional(Schema.Boolean),
+    assignee: Schema.optional(Ref(TestSchema2.Person)),
+    previous: Schema.optional(Schema.suspend(() => Ref(TestSchema2.Task))),
+    subTasks: Schema.optional(Schema.Array(Schema.suspend(() => Ref(TestSchema2.Task)))),
+    description: Schema.optional(Schema.String)
+  }).pipe(Schema.partial, object({
+    typename: "example.com/type/Task",
+    version: "0.1.0"
+  }));
+  TestSchema2.HasManager = Schema.Struct({}).pipe(relation({
+    typename: "example.com/type/HasManager",
+    version: "0.1.0",
+    source: TestSchema2.Person,
+    target: TestSchema2.Person
+  }));
+  TestSchema2.EmployedBy = Schema.Struct({
+    role: Schema.String,
+    since: Schema.optional(Schema.String)
+  }).pipe(relation({
+    typename: "example.com/type/EmployedBy",
+    version: "0.1.0",
+    source: TestSchema2.Person,
+    target: TestSchema2.Organization
+  }));
+  (function(RecordType) {
+    RecordType[RecordType["UNDEFINED"] = 0] = "UNDEFINED";
+    RecordType[RecordType["PERSONAL"] = 1] = "PERSONAL";
+    RecordType[RecordType["WORK"] = 2] = "WORK";
+  })(TestSchema2.RecordType || (TestSchema2.RecordType = {}));
+  TestSchema2.Container = Schema.Struct({
+    objects: Schema.Array(Ref(Obj)),
+    records: Schema.Array(Schema.partial(Schema.Struct({
+      title: Schema.String,
+      description: Schema.String,
+      contacts: Schema.Array(Ref(TestSchema2.Person)),
+      type: Schema.Enums(TestSchema2.RecordType)
+    })))
+  }).pipe(Schema.partial, object({
+    typename: "example.com/type/Container",
+    version: "0.1.0"
+  }));
+})(TestSchema || (TestSchema = {}));
+var TestSchema;
+
+// src/testing/test-data.ts
+var spaceKey = PublicKey.random();
+var PEOPLE = {
+  alice: DatabaseDirectory.make({
+    spaceKey: spaceKey.toHex(),
+    objects: {
+      [ObjectId.random()]: ObjectStructure.makeObject({
+        type: Type_exports.getDXN(TestSchema.Person).toString(),
+        data: {
+          name: "Alice"
+        }
+      })
+    }
+  }),
+  bob: DatabaseDirectory.make({
+    spaceKey: spaceKey.toHex(),
+    objects: {
+      [ObjectId.random()]: ObjectStructure.makeObject({
+        type: Type_exports.getDXN(TestSchema.Person).toString(),
+        data: {
+          name: "Bob"
+        }
+      })
+    }
+  })
+};
+var ORGS = {
+  dxos: DatabaseDirectory.make({
+    spaceKey: spaceKey.toHex(),
+    objects: {
+      [ObjectId.random()]: ObjectStructure.makeObject({
+        type: Type_exports.getDXN(TestSchema.Organization).toString(),
+        data: {
+          name: "DXOS",
+          founded: "2023"
+        }
+      })
+    }
+  }),
+  cyberdyne: DatabaseDirectory.make({
+    spaceKey: spaceKey.toHex(),
+    objects: {
+      [ObjectId.random()]: ObjectStructure.makeObject({
+        type: Type_exports.getDXN(TestSchema.Organization).toString(),
+        data: {
+          name: "Cyberdyne Systems",
+          founded: "1984"
+        }
+      })
+    }
+  })
+};
+var WORKS_FOR = {
+  fredWorksForCyberdyne: DatabaseDirectory.make({
+    spaceKey: spaceKey.toHex(),
+    objects: {
+      [ObjectId.random()]: ObjectStructure.makeRelation({
+        type: Type_exports.getDXN(TestSchema.EmployedBy).toString(),
+        source: {
+          "/": DXN.fromLocalObjectId(Object.keys(PEOPLE.bob.objects)[0]).toString()
+        },
+        target: {
+          "/": DXN.fromLocalObjectId(Object.keys(ORGS.cyberdyne.objects)[0]).toString()
+        },
+        data: {
+          since: "2020",
+          position: "Engineer"
+        }
+      })
+    }
+  }),
+  aliceWorksForAperture: DatabaseDirectory.make({
+    spaceKey: spaceKey.toHex(),
+    objects: {
+      [ObjectId.random()]: ObjectStructure.makeRelation({
+        type: Type_exports.getDXN(TestSchema.EmployedBy).toString(),
+        source: {
+          "/": DXN.fromLocalObjectId(Object.keys(PEOPLE.alice.objects)[0]).toString()
+        },
+        target: {
+          "/": DXN.fromLocalObjectId(Object.keys(ORGS.dxos.objects)[0]).toString()
+        },
+        data: {
+          since: "2018",
+          position: "Research Scientist"
+        }
+      })
+    }
+  })
+};
+var TASKS = {
+  task1: DatabaseDirectory.make({
+    spaceKey: spaceKey.toHex(),
+    objects: {
+      [ObjectId.random()]: ObjectStructure.makeObject({
+        type: Type_exports.getDXN(TestSchema.Task).toString(),
+        data: {
+          title: "Complete project documentation",
+          description: "Write comprehensive documentation for the new system",
+          status: "in-progress",
+          dueDate: "2023-12-31",
+          assignee: {
+            "/": DXN.fromLocalObjectId(Object.keys(PEOPLE.bob.objects)[0]).toString()
+          }
+        }
+      })
+    }
+  }),
+  task2: DatabaseDirectory.make({
+    spaceKey: spaceKey.toHex(),
+    objects: {
+      [ObjectId.random()]: ObjectStructure.makeObject({
+        type: Type_exports.getDXN(TestSchema.Task).toString(),
+        data: {
+          title: "Run experiments",
+          description: "Conduct series of experiments on the portal device",
+          status: "pending",
+          dueDate: "2023-11-15",
+          assignee: {
+            "/": DXN.fromLocalObjectId(Object.keys(PEOPLE.alice.objects)[0]).toString()
+          }
+        }
+      })
+    }
+  })
+};
+
+// src/testing/util.ts
+import { assertArgument } from "@dxos/invariant";
+import { deepMapValues } from "@dxos/util";
+var createEchoSchema = (schema, version = "0.1.0") => {
+  const jsonSchema = toJsonSchema(schema);
+  const typename = getSchemaTypename(schema);
+  assertArgument(typename, "typename", "Schema does not have a typename.");
+  const echoSchema = new EchoSchema(makeObject(PersistentSchema, {
+    typename,
+    version,
+    jsonSchema
+  }));
+  subscribe(echoSchema.persistentSchema, () => {
+    echoSchema._invalidate();
+  });
+  return echoSchema;
+};
+var prepareAstForCompare = (obj) => deepMapValues(obj, (value, recurse) => {
+  if (typeof value === "function") {
+    return null;
+  }
+  if (value instanceof RegExp) {
+    return value;
+  }
+  if (typeof value === "object") {
+    const clone = {
+      ...value
+    };
+    for (const sym of Object.getOwnPropertySymbols(clone)) {
+      clone[sym.toString()] = clone[sym];
+      delete clone[sym];
+    }
+    return recurse(clone);
+  }
+  return recurse(value);
+});
+var updateCounter = (...objects) => {
+  let updateCount = 0;
+  const unsubscribes = objects.map((obj) => subscribe(obj, () => {
+    updateCount++;
+  }));
+  const unsubscribeAll = () => {
+    for (const unsub of unsubscribes) {
+      unsub();
+    }
+  };
+  return {
+    // https://github.com/tc39/proposal-explicit-resource-management
+    [Symbol.dispose]: unsubscribeAll,
+    get count() {
+      return updateCount;
+    }
+  };
+};
+export {
+  ORGS,
+  PEOPLE,
+  TASKS,
+  TestSchema,
+  WORKS_FOR,
+  createEchoSchema,
+  prepareAstForCompare,
+  updateCounter
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/testing/test-data.ts", "../../../../src/testing/test-schema.ts", "../../../../src/testing/util.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { DatabaseDirectory, ObjectStructure } from '@dxos/echo-protocol';\nimport { DXN, ObjectId, PublicKey } from '@dxos/keys';\n\nimport { Type } from '../index';\n\nimport { TestSchema } from './test-schema';\n\nconst spaceKey = PublicKey.random();\n\n// TODO(burdon): Use Obj.make.\n\nexport const PEOPLE = {\n  alice: DatabaseDirectory.make({\n    spaceKey: spaceKey.toHex(),\n    objects: {\n      [ObjectId.random()]: ObjectStructure.makeObject({\n        type: Type.getDXN(TestSchema.Person)!.toString(),\n        data: {\n          name: 'Alice',\n        },\n      }),\n    },\n  }),\n  bob: DatabaseDirectory.make({\n    spaceKey: spaceKey.toHex(),\n    objects: {\n      [ObjectId.random()]: ObjectStructure.makeObject({\n        type: Type.getDXN(TestSchema.Person)!.toString(),\n        data: {\n          name: 'Bob',\n        },\n      }),\n    },\n  }),\n};\n\nexport const ORGS = {\n  dxos: DatabaseDirectory.make({\n    spaceKey: spaceKey.toHex(),\n    objects: {\n      [ObjectId.random()]: ObjectStructure.makeObject({\n        type: Type.getDXN(TestSchema.Organization)!.toString(),\n        data: {\n          name: 'DXOS',\n          founded: '2023',\n        },\n      }),\n    },\n  }),\n  cyberdyne: DatabaseDirectory.make({\n    spaceKey: spaceKey.toHex(),\n    objects: {\n      [ObjectId.random()]: ObjectStructure.makeObject({\n        type: Type.getDXN(TestSchema.Organization)!.toString(),\n        data: {\n          name: 'Cyberdyne Systems',\n          founded: '1984',\n        },\n      }),\n    },\n  }),\n};\n\nexport const WORKS_FOR = {\n  fredWorksForCyberdyne: DatabaseDirectory.make({\n    spaceKey: spaceKey.toHex(),\n    objects: {\n      [ObjectId.random()]: ObjectStructure.makeRelation({\n        type: Type.getDXN(TestSchema.EmployedBy)!.toString(),\n        source: { '/': DXN.fromLocalObjectId(Object.keys(PEOPLE.bob.objects!)[0]).toString() },\n        target: { '/': DXN.fromLocalObjectId(Object.keys(ORGS.cyberdyne.objects!)[0]).toString() },\n        data: {\n          since: '2020',\n          position: 'Engineer',\n        },\n      }),\n    },\n  }),\n  aliceWorksForAperture: DatabaseDirectory.make({\n    spaceKey: spaceKey.toHex(),\n    objects: {\n      [ObjectId.random()]: ObjectStructure.makeRelation({\n        type: Type.getDXN(TestSchema.EmployedBy)!.toString(),\n        source: { '/': DXN.fromLocalObjectId(Object.keys(PEOPLE.alice.objects!)[0]).toString() },\n        target: { '/': DXN.fromLocalObjectId(Object.keys(ORGS.dxos.objects!)[0]).toString() },\n        data: {\n          since: '2018',\n          position: 'Research Scientist',\n        },\n      }),\n    },\n  }),\n};\n\nexport const TASKS = {\n  task1: DatabaseDirectory.make({\n    spaceKey: spaceKey.toHex(),\n    objects: {\n      [ObjectId.random()]: ObjectStructure.makeObject({\n        type: Type.getDXN(TestSchema.Task)!.toString(),\n        data: {\n          title: 'Complete project documentation',\n          description: 'Write comprehensive documentation for the new system',\n          status: 'in-progress',\n          dueDate: '2023-12-31',\n          assignee: { '/': DXN.fromLocalObjectId(Object.keys(PEOPLE.bob.objects!)[0]).toString() },\n        },\n      }),\n    },\n  }),\n  task2: DatabaseDirectory.make({\n    spaceKey: spaceKey.toHex(),\n    objects: {\n      [ObjectId.random()]: ObjectStructure.makeObject({\n        type: Type.getDXN(TestSchema.Task)!.toString(),\n        data: {\n          title: 'Run experiments',\n          description: 'Conduct series of experiments on the portal device',\n          status: 'pending',\n          dueDate: '2023-11-15',\n          assignee: { '/': DXN.fromLocalObjectId(Object.keys(PEOPLE.alice.objects!)[0]).toString() },\n        },\n      }),\n    },\n  }),\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Type from '../Type';\n\nexport namespace TestSchema {\n  //\n  // Expando\n  //\n\n  /**\n   * Expando object is an object with an arbitrary set of properties.\n   * This is the test variant with example.com namespace.\n   */\n  export const Expando = Schema.Struct({}, { key: Schema.String, value: Schema.Any }).pipe(\n    Type.object({\n      typename: 'example.com/type/Expando',\n      version: '0.1.0',\n    }),\n  );\n\n  export interface Expando extends Schema.Schema.Type<typeof Expando> {}\n\n  //\n  // Example\n  //\n\n  const Nested = Schema.Struct({\n    field: Schema.String,\n  });\n\n  export class TestClass {\n    field = 'value';\n    toJSON() {\n      return { field: this.field };\n    }\n  }\n\n  /** @deprecated Use another test schema or create a specific local test schema. */\n  export const ExampleSchema = Schema.Struct({\n    string: Schema.String,\n    number: Schema.Number,\n    boolean: Schema.Boolean,\n    null: Schema.Null,\n    undefined: Schema.Undefined,\n    stringArray: Schema.Array(Schema.String),\n    twoDimNumberArray: Schema.Array(Schema.Array(Schema.Number)),\n    nested: Nested,\n    nestedArray: Schema.Array(Nested),\n    nestedNullableArray: Schema.Array(Schema.Union(Nested, Schema.Null)),\n    reference: Schema.suspend((): Type.Ref<Example> => Type.Ref(Example)),\n    referenceArray: Schema.Array(Schema.suspend((): Type.Ref<Example> => Type.Ref(Example))),\n    classInstance: Schema.instanceOf(TestClass),\n    other: Schema.Any,\n  }).pipe(Schema.partial);\n\n  /** @deprecated Use another test schema or create a specific local test schema. */\n  export interface ExampleSchema extends Schema.Schema.Type<typeof ExampleSchema> {}\n\n  /** @deprecated Use another test schema or create a specific local test schema. */\n  export const Example = ExampleSchema.pipe(\n    Type.object({\n      typename: 'example.com/type/Example',\n      version: '0.1.0',\n    }),\n  );\n\n  /** @deprecated Use another test schema or create a specific local test schema. */\n  export interface Example extends Schema.Schema.Type<typeof Example> {}\n\n  //\n  // Message\n  //\n\n  // TODO(burdon): Support defaults directly on Type: `make` is erased by `pipe(Type.Obj)`.\n  export const MessageStruct = Schema.Struct({\n    // TODO(burdon): Support S.Date; Custom Timestamp (with defaults).\n    // TODO(burdon): Support defaults (update create and create).\n    timestamp: Schema.String.pipe(\n      Schema.propertySignature,\n      Schema.withConstructorDefault(() => new Date().toISOString()),\n    ),\n  });\n\n  export const Message = MessageStruct.pipe(\n    Type.object({\n      typename: 'example.com/type/Message',\n      version: '0.1.0',\n    }),\n  );\n\n  export interface Message extends Schema.Schema.Type<typeof Message> {}\n\n  //\n  // Organization\n  //\n\n  export const Organization = Schema.Struct({\n    name: Schema.String,\n    properties: Schema.optional(\n      Schema.Record({\n        key: Schema.String,\n        value: Schema.String,\n      }),\n    ),\n  }).pipe(\n    Type.object({\n      typename: 'example.com/type/Organization',\n      version: '0.1.0',\n    }),\n  );\n\n  export interface Organization extends Schema.Schema.Type<typeof Organization> {}\n\n  //\n  // Person\n  //\n\n  export const Person = Schema.Struct({\n    name: Schema.String,\n    username: Schema.String,\n    email: Schema.String,\n    age: Schema.Number.pipe(Schema.optional),\n    tasks: Schema.Array(Schema.suspend((): Type.Ref<Task> => Type.Ref(Task))),\n    employer: Schema.optional(Type.Ref(Organization)),\n    address: Schema.Struct({\n      city: Schema.optional(Schema.String),\n      state: Schema.optional(Schema.String),\n      zip: Schema.optional(Schema.String),\n      coordinates: Schema.Struct({\n        lat: Schema.optional(Schema.Number),\n        lng: Schema.optional(Schema.Number),\n      }),\n    }),\n    fields: Schema.Struct({\n      label: Schema.String,\n      value: Schema.String,\n    }).pipe(Schema.Array, Schema.optional),\n  }).pipe(\n    Schema.partial,\n    Type.object({\n      typename: 'example.com/type/Person',\n      version: '0.1.0',\n    }),\n  );\n\n  export interface Person extends Schema.Schema.Type<typeof Person> {}\n\n  //\n  // Task\n  //\n\n  export const Task = Schema.Struct({\n    title: Schema.optional(Schema.String),\n    deadline: Schema.optional(Schema.String),\n    completed: Schema.optional(Schema.Boolean),\n    assignee: Schema.optional(Type.Ref(Person)),\n    previous: Schema.optional(Schema.suspend((): Type.Ref<Task> => Type.Ref(Task))),\n    subTasks: Schema.optional(Schema.Array(Schema.suspend((): Type.Ref<Task> => Type.Ref(Task)))),\n    description: Schema.optional(Schema.String),\n  }).pipe(\n    Schema.partial,\n    Type.object({\n      typename: 'example.com/type/Task',\n      version: '0.1.0',\n    }),\n  );\n\n  export interface Task extends Schema.Schema.Type<typeof Task> {}\n\n  //\n  // HasManager\n  //\n\n  export const HasManager = Schema.Struct({}).pipe(\n    Type.relation({\n      typename: 'example.com/type/HasManager',\n      version: '0.1.0',\n      source: Person,\n      target: Person,\n    }),\n  );\n\n  export interface HasManager extends Schema.Schema.Type<typeof HasManager> {}\n\n  //\n  // EmployedBy\n  //\n\n  export const EmployedBy = Schema.Struct({\n    role: Schema.String,\n    since: Schema.optional(Schema.String),\n  }).pipe(\n    Type.relation({\n      typename: 'example.com/type/EmployedBy',\n      version: '0.1.0',\n      source: Person,\n      target: Organization,\n    }),\n  );\n\n  export interface EmployedBy extends Schema.Schema.Type<typeof EmployedBy> {}\n\n  //\n  // RecordType\n  //\n\n  export enum RecordType {\n    UNDEFINED = 0,\n    PERSONAL = 1,\n    WORK = 2,\n  }\n\n  export const Container = Schema.Struct({\n    objects: Schema.Array(Type.Ref(Type.Obj)),\n    records: Schema.Array(\n      Schema.partial(\n        Schema.Struct({\n          title: Schema.String,\n          description: Schema.String,\n          contacts: Schema.Array(Type.Ref(Person)),\n          type: Schema.Enums(RecordType),\n        }),\n      ),\n    ),\n  }).pipe(\n    Schema.partial,\n    Type.object({\n      typename: 'example.com/type/Container',\n      version: '0.1.0',\n    }),\n  );\n\n  export interface Container extends Schema.Schema.Type<typeof Container> {}\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport type * as Schema from 'effect/Schema';\nimport type * as SchemaAST from 'effect/SchemaAST';\n\nimport { assertArgument } from '@dxos/invariant';\nimport { deepMapValues } from '@dxos/util';\n\nimport { EchoSchema, PersistentSchema, getSchemaTypename, makeObject, subscribe, toJsonSchema } from '../internal';\n\n/**\n * Create a reactive mutable schema that updates when the JSON schema is updated.\n */\n// TODO(dmaretskyi): Should be replaced by registration of typed object.\nexport const createEchoSchema = (schema: Schema.Schema.AnyNoContext, version = '0.1.0'): EchoSchema => {\n  const jsonSchema = toJsonSchema(schema);\n  const typename = getSchemaTypename(schema);\n  assertArgument(typename, 'typename', 'Schema does not have a typename.');\n  const echoSchema = new EchoSchema(makeObject(PersistentSchema, { typename, version, jsonSchema }));\n\n  // TODO(burdon): Unsubscribe is never called.\n  subscribe(echoSchema.persistentSchema, () => {\n    echoSchema._invalidate();\n  });\n\n  return echoSchema;\n};\n\n/**\n * Converts AST to a format that can be compared with test matchers.\n */\nexport const prepareAstForCompare = (obj: SchemaAST.AST): any =>\n  deepMapValues(obj, (value: any, recurse: any) => {\n    if (typeof value === 'function') {\n      return null;\n    }\n\n    if (value instanceof RegExp) {\n      return value;\n    }\n\n    // Convert symbols to strings.\n    if (typeof value === 'object') {\n      const clone = { ...value };\n      for (const sym of Object.getOwnPropertySymbols(clone as any)) {\n        clone[sym.toString()] = clone[sym];\n        delete clone[sym];\n      }\n\n      return recurse(clone);\n    }\n\n    return recurse(value);\n  });\n\n/**\n * Creates an update counter that tracks changes to reactive objects.\n * @param objects - Reactive objects to subscribe to.\n * @returns An object with a count property and Symbol.dispose for cleanup.\n */\nexport const updateCounter = (...objects: object[]) => {\n  let updateCount = 0;\n\n  const unsubscribes = objects.map((obj) =>\n    subscribe(obj, () => {\n      updateCount++;\n    }),\n  );\n\n  const unsubscribeAll = () => {\n    for (const unsub of unsubscribes) {\n      unsub();\n    }\n  };\n\n  return {\n    // https://github.com/tc39/proposal-explicit-resource-management\n    [Symbol.dispose]: unsubscribeAll,\n    get count() {\n      return updateCount;\n    },\n  };\n};\n"],
+  "mappings": "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",
+  "names": ["DatabaseDirectory", "ObjectStructure", "DXN", "ObjectId", "PublicKey", "Schema", "TestSchema", "Expando", "Struct", "key", "String", "value", "Any", "pipe", "object", "typename", "version", "Nested", "field", "TestClass", "toJSON", "ExampleSchema", "string", "number", "Number", "boolean", "Boolean", "null", "Null", "undefined", "Undefined", "stringArray", "Array", "twoDimNumberArray", "nested", "nestedArray", "nestedNullableArray", "Union", "reference", "suspend", "Ref", "Example", "referenceArray", "classInstance", "instanceOf", "other", "partial", "MessageStruct", "timestamp", "propertySignature", "withConstructorDefault", "Date", "toISOString", "Message", "Organization", "name", "properties", "optional", "Record", "Person", "username", "email", "age", "tasks", "Task", "employer", "address", "city", "state", "zip", "coordinates", "lat", "lng", "fields", "label", "title", "deadline", "completed", "assignee", "previous", "subTasks", "description", "HasManager", "relation", "source", "target", "EmployedBy", "role", "since", "RecordType", "Container", "objects", "Obj", "records", "contacts", "type", "Enums", "spaceKey", "PublicKey", "random", "PEOPLE", "alice", "DatabaseDirectory", "make", "toHex", "objects", "ObjectId", "ObjectStructure", "makeObject", "type", "Type", "getDXN", "TestSchema", "Person", "toString", "data", "name", "bob", "ORGS", "dxos", "Organization", "founded", "cyberdyne", "WORKS_FOR", "fredWorksForCyberdyne", "makeRelation", "EmployedBy", "source", "DXN", "fromLocalObjectId", "Object", "keys", "target", "since", "position", "aliceWorksForAperture", "TASKS", "task1", "Task", "title", "description", "status", "dueDate", "assignee", "task2", "assertArgument", "deepMapValues", "createEchoSchema", "schema", "version", "jsonSchema", "toJsonSchema", "typename", "getSchemaTypename", "assertArgument", "echoSchema", "EchoSchema", "makeObject", "PersistentSchema", "subscribe", "persistentSchema", "_invalidate", "prepareAstForCompare", "obj", "deepMapValues", "value", "recurse", "RegExp", "clone", "sym", "Object", "getOwnPropertySymbols", "toString", "updateCounter", "objects", "updateCount", "unsubscribes", "map", "unsubscribeAll", "unsub", "Symbol", "dispose", "count"]
+}

package/dist/types/src/Annotation.d.ts

@@ -0,0 +1,2 @@
+export { DescriptionAnnotation, FormInputAnnotation, GeneratorAnnotation, LabelAnnotation, ReferenceAnnotation, SystemTypeAnnotation, TypeAnnotation, getDescriptionWithSchema, getLabelWithSchema, getTypeAnnotation, setDescriptionWithSchema, setLabelWithSchema, } from './internal/annotations';
+//# sourceMappingURL=Annotation.d.ts.map

package/dist/types/src/Annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Annotation.d.ts","sourceRoot":"","sources":["../../../src/Annotation.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/types/src/Database.d.ts

@@ -0,0 +1,194 @@
+import * as Context from 'effect/Context';
+import * as Effect from 'effect/Effect';
+import * as Layer from 'effect/Layer';
+import * as Option from 'effect/Option';
+import * as Schema from 'effect/Schema';
+import type * as Types from 'effect/Types';
+import { type QueryAST } from '@dxos/echo-protocol';
+import { DXN, type PublicKey, type SpaceId } from '@dxos/keys';
+import { type QueryOptions as QueryOptionsProto } from '@dxos/protocols/proto/dxos/echo/filter';
+import type * as Entity from './Entity';
+import * as Err from './Err';
+import type * as Filter from './Filter';
+import type * as Hypergraph from './Hypergraph';
+import type { Ref } from './internal/ref/ref';
+import { type AnyProperties } from './internal/types';
+import type * as Obj from './Obj';
+import type * as Query from './Query';
+import type * as QueryResult from './QueryResult';
+import type * as SchemaRegistry from './SchemaRegistry';
+import type * as Type from './Type';
+/**
+ * @deprecated Use `QueryAST.QueryOptions` instead.
+ */
+export type QueryOptions = {
+    /**
+     * @deprecated Use `spaceIds` instead.
+     */
+    spaces?: PublicKey[];
+    /**
+     * Query only in specific spaces.
+     */
+    spaceIds?: string[];
+    /**
+     * Return only the first `limit` results.
+     */
+    limit?: number;
+    /**
+     * Query only local spaces, or remote on agent.
+     * @default `QueryOptions.DataLocation.LOCAL`
+     *
+     * Options:
+     *   - proto3_optional = true
+     */
+    dataLocation?: QueryOptionsProto.DataLocation;
+};
+/**
+ * `query` API function declaration.
+ */
+export interface QueryFn {
+    <Q extends Query.Any>(query: Q, options?: (QueryAST.QueryOptions & QueryOptions) | undefined): QueryResult.QueryResult<Query.Type<Q>>;
+    <F extends Filter.Any>(filter: F, options?: (QueryAST.QueryOptions & QueryOptions) | undefined): QueryResult.QueryResult<Filter.Type<F>>;
+}
+/**
+ * Common interface for Database and Queue.
+ */
+export interface Queryable {
+    query: QueryFn;
+}
+export type GetObjectByIdOptions = {
+    deleted?: boolean;
+};
+export type ObjectPlacement = 'root-doc' | 'linked-doc';
+export type AddOptions = {
+    /**
+     * Where to place the object in the Automerge document tree.
+     * Root document is always loaded with the space.
+     * Linked documents are loaded lazily.
+     * Placing large number of objects in the root document may slow down the initial load.
+     *
+     * @default 'linked-doc'
+     */
+    placeIn?: ObjectPlacement;
+};
+export type FlushOptions = {
+    /**
+     * Write any pending changes to disk.
+     * @default true
+     */
+    disk?: boolean;
+    /**
+     * Wait for pending index updates.
+     * @default false
+     */
+    indexes?: boolean;
+    /**
+     * Flush pending updates to objects and queries.
+     * @default false
+     */
+    updates?: boolean;
+};
+/**
+ * Identifier denoting an ECHO Database.
+ */
+export declare const TypeId: unique symbol;
+export type TypeId = typeof TypeId;
+/**
+ * ECHO Database interface.
+ */
+export interface Database extends Queryable {
+    readonly [TypeId]: TypeId;
+    get spaceId(): SpaceId;
+    get schemaRegistry(): SchemaRegistry.SchemaRegistry;
+    get graph(): Hypergraph.Hypergraph;
+    toJSON(): object;
+    /**
+     * Return object by local ID.
+     */
+    getObjectById<T extends Obj.Unknown = Obj.Obj<AnyProperties>>(id: string, opts?: GetObjectByIdOptions): T | undefined;
+    /**
+     * Query objects.
+     */
+    query: QueryFn;
+    /**
+     * Creates a reference to an existing object in the database.
+     *
+     * NOTE: The reference may be dangling if the object is not present in the database.
+     * NOTE: Difference from `Ref.fromDXN`
+     * `Ref.fromDXN(dxn)` returns an unhydrated reference. The `.load` and `.target` APIs will not work.
+     * `db.makeRef(dxn)` is preferable in cases with access to the database.
+     */
+    makeRef<T extends Entity.Unknown = Entity.Unknown>(dxn: DXN): Ref<T>;
+    /**
+     * Adds object to the database.
+     */
+    add<T extends Entity.Unknown = Entity.Unknown>(obj: T, opts?: AddOptions): T;
+    /**
+     * Removes object from the database.
+     */
+    remove(obj: Entity.Unknown): void;
+    /**
+     * Wait for all pending changes to be saved to disk.
+     * Optionaly waits for changes to be propagated to indexes and event handlers.
+     */
+    flush(opts?: FlushOptions): Promise<void>;
+}
+export declare const isDatabase: (obj: unknown) => obj is Database;
+export declare const Database: Schema.Schema<Database>;
+declare const Service_base: Context.TagClass<Service, "@dxos/echo/Database/Service", {
+    readonly db: Database;
+}>;
+export declare class Service extends Service_base {
+    static notAvailable: Layer.Layer<Service, never, never>;
+    static make: (db: Database) => Context.Tag.Service<Service>;
+    static layer: (db: Database) => Layer.Layer<Service>;
+    /**
+     * Returns the space ID of the database.
+     */
+    static spaceId: Effect.Effect<SpaceId, never, Service>;
+    /**
+     * Resolves an object by its DXN.
+     */
+    static resolve: {
+        (ref: DXN | Ref<any>): Effect.Effect<Entity.Unknown, never, Service>;
+        <S extends Type.Entity.Any>(ref: DXN | Ref<any>, schema: S): Effect.Effect<Schema.Schema.Type<S>, Err.ObjectNotFoundError, Service>;
+    };
+    /**
+     * Loads an object reference.
+     */
+    static load: <T>(ref: Ref<T>) => Effect.Effect<T, Err.ObjectNotFoundError, never>;
+    /**
+     * Loads an object reference option.
+     */
+    static loadOption: <T>(ref: Ref<T>) => Effect.Effect<Option.Option<T>, never, never>;
+    /**
+     * @link EchoDatabase.add
+     */
+    static add: <T extends Entity.Unknown>(obj: T) => Effect.Effect<T, never, Service>;
+    /**
+     * @link EchoDatabase.remove
+     */
+    static remove: <T extends Entity.Unknown>(obj: T) => Effect.Effect<void, never, Service>;
+    /**
+     * @link EchoDatabase.flush
+     */
+    static flush: (opts?: FlushOptions) => Effect.Effect<void, never, Service>;
+    /**
+     * Creates a `QueryResult` object that can be subscribed to.
+     */
+    static query: {
+        <Q extends Query.Any>(query: Q): Effect.Effect<QueryResult.QueryResult<Query.Type<Q>>, never, Service>;
+        <F extends Filter.Any>(filter: F): Effect.Effect<QueryResult.QueryResult<Filter.Type<F>>, never, Service>;
+    };
+    /**
+     * Executes the query once and returns the results.
+     */
+    static runQuery: {
+        <Q extends Query.Any>(query: Q): Effect.Effect<Query.Type<Q>[], never, Service>;
+        <F extends Filter.Any>(filter: F): Effect.Effect<Filter.Type<F>[], never, Service>;
+    };
+    static schemaQuery: <Q extends Types.NoExcessProperties<SchemaRegistry.Query, Q>>(query?: Q & SchemaRegistry.Query) => Effect.Effect<QueryResult.QueryResult<SchemaRegistry.ExtractQueryResult<Q>>, never, Service>;
+    static runSchemaQuery: <Q extends Types.NoExcessProperties<SchemaRegistry.Query, Q>>(query?: Q & SchemaRegistry.Query) => Effect.Effect<SchemaRegistry.ExtractQueryResult<Q>[], never, Service>;
+}
+export {};
+//# sourceMappingURL=Database.d.ts.map

package/dist/types/src/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../../src/Database.ts"],"names":[],"mappings":"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"}