@dxos/echo 0.8.1-staging.31c3ee1

package/LICENSE

@@ -0,0 +1,8 @@
+MIT License 
+Copyright (c) 2022 DXOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @dxos/echo
+
+ECHO API.
+
+## Installation
+
+```bash
+pnpm i @dxos/echo
+```
+
+## DXOS Resources
+
+- [Website](https://dxos.org)
+- [Developer Documentation](https://docs.dxos.org)
+- Talk to us on [Discord](https://dxos.org/discord)
+
+## Contributions
+
+Your ideas, issues, and code are most welcome. Please take a look at our [community code of conduct](https://github.com/dxos/dxos/blob/main/CODE_OF_CONDUCT.md), the [issue guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-issues), and the [PR contribution guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-prs).
+
+License: [MIT](./LICENSE) Copyright 2022 © DXOS

package/dist/lib/browser/index.mjs

@@ -0,0 +1,49 @@
+import "@dxos/node-std/globals";
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// packages/core/echo/echo/src/index.ts
+import { DXN } from "@dxos/keys";
+
+// packages/core/echo/echo/src/Database.ts
+var Database_exports = {};
+
+// packages/core/echo/echo/src/Queue.ts
+var Queue_exports = {};
+
+// packages/core/echo/echo/src/Space.ts
+var Space_exports = {};
+
+// packages/core/echo/echo/src/Type.ts
+var Type_exports = {};
+__export(Type_exports, {
+  Kind: () => EntityKind,
+  ObjectId: () => ObjectId,
+  Ref: () => Ref,
+  create: () => create,
+  def: () => def,
+  getDXN: () => getSchemaDXN,
+  getMeta: () => getTypeAnnotation,
+  getSchema: () => getSchema,
+  getTypename: () => getSchemaTypename,
+  getVersion: () => getSchemaVersion,
+  instanceOf: () => isInstanceOf,
+  ref: () => ref
+});
+import { EchoObject, EntityKind, ObjectId, Ref as Ref$, getTypeAnnotation, getSchema, getSchemaDXN, getSchemaTypename, getSchemaVersion, isInstanceOf } from "@dxos/echo-schema";
+import { create as create$, makeRef } from "@dxos/live-object";
+var ref = makeRef;
+var create = create$;
+var def = (meta) => EchoObject(meta);
+var Ref = (self) => Ref$(self);
+export {
+  DXN,
+  Database_exports as Database,
+  Queue_exports as Queue,
+  Space_exports as Space,
+  Type_exports as Type
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/index.ts", "../../../src/Database.ts", "../../../src/Queue.ts", "../../../src/Space.ts", "../../../src/Type.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { DXN } from '@dxos/keys';\n\nexport { DXN };\n\nexport * as Database from './Database';\nexport * as Queue from './Queue';\nexport * as Space from './Space';\nexport * as Type from './Type';\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Database API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Database {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Queue API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Queue {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Space API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Space {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Schema } from 'effect';\n\nimport {\n  type BaseSchema,\n  type EchoSchema,\n  type Expando as Expando$,\n  type ImmutableSchema,\n  type JsonSchemaType,\n  type TypeMeta,\n  EchoObject,\n  EntityKind,\n  ObjectId,\n  Ref as Ref$,\n  getTypeAnnotation,\n  getSchema,\n  getSchemaDXN,\n  getSchemaTypename,\n  getSchemaVersion,\n  isInstanceOf,\n} from '@dxos/echo-schema';\nimport { create as create$, makeRef } from '@dxos/live-object';\n\n// NOTES:\n// - New Echo package and namespaces allow for incremental migration; vastly simplifies imports.\n// - Split into separate ECHO namespaces: Database, Space, Type, Query, Queue.\n//  - Example; import { Database, Type, Query, Queue } from '@dxos/echo';\n// - Use `declare namespace` for types (no code is generated). See Effect pattern, where Schema is a namespace, interface, and function.\n// - Test with @dxos/schema/testing types.\n// - Define user (Composer) types in namespace (e.g., of plugin) and drop Type suffix; remove all deprecated Braneframe types.\n\nexport type { TypeMeta as Meta, JsonSchemaType as JsonSchema };\nexport {\n  EntityKind as Kind,\n  ObjectId,\n  getTypeAnnotation as getMeta,\n  getSchema,\n  getSchemaDXN as getDXN,\n  getSchemaTypename as getTypename,\n  getSchemaVersion as getVersion,\n  isInstanceOf as instanceOf,\n};\n\n/**\n * Type API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Type {\n  /**\n   * A schema that can be extended with arbitrary properties.\n   */\n  export type Expando = Expando$;\n\n  export type Abstract<T = any> = BaseSchema<T>;\n  export type ImmutableType<T> = ImmutableSchema<T>;\n  export type MutableType<T> = EchoSchema<T>;\n}\n\n//\n// Constructors\n//\n\nexport const ref = makeRef;\nexport const create = create$;\n\n//\n// Combinators\n//\n\n/**\n * Defines an ECHO type.\n *\n * @example\n * ```ts\n * const Org = S.Struct({\n *   name: S.String,\n * }).pipe(Type.def({ typename: 'example.com/type/Org', version: '1.0.0' }));\n * ```\n */\nexport const def = (meta: TypeMeta) => EchoObject(meta);\n\n/**\n * Defines a reference to an ECHO object.\n *\n * @example\n * ```ts\n * import { Type } from '@dxos/echo';\n * const Contact = S.Struct({\n *   name: S.String,\n *   employer: Type.Ref(Org),\n * }).pipe(Type.def({ typename: 'example.com/type/Contact', version: '1.0.0' }));\n * ```\n */\nexport const Ref = <S extends Schema.Schema.AnyNoContext>(self: S) => Ref$<Schema.Schema.Type<S>>(self);\n"],
+  "mappings": ";;;;;;;;AAIA,SAASA,WAAW;;;ACJpB;;;ACAA;;;ACAA;;;ACAA;;;;;;;;;;;;;;;AAMA,SAOEC,YACAC,YACAC,UACAC,OAAOC,MACPC,mBACAC,WACAC,cACAC,mBACAC,kBACAC,oBACK;AACP,SAASC,UAAUC,SAASC,eAAe;AA2CpC,IAAMC,MAAMC;AACZ,IAAMC,SAASC;AAgBf,IAAMC,MAAM,CAACC,SAAmBC,WAAWD,IAAAA;AAc3C,IAAME,MAAM,CAAuCC,SAAYC,KAA4BD,IAAAA;",
+  "names": ["DXN", "EchoObject", "EntityKind", "ObjectId", "Ref", "Ref$", "getTypeAnnotation", "getSchema", "getSchemaDXN", "getSchemaTypename", "getSchemaVersion", "isInstanceOf", "create", "create$", "makeRef", "ref", "makeRef", "create", "create$", "def", "meta", "EchoObject", "Ref", "self", "Ref$"]
+}

package/dist/lib/browser/meta.json

@@ -0,0 +1 @@
+{"inputs":{"packages/core/echo/echo/src/Database.ts":{"bytes":689,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Queue.ts":{"bytes":671,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Space.ts":{"bytes":671,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Type.ts":{"bytes":6001,"imports":[{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"format":"esm"},"packages/core/echo/echo/src/index.ts":{"bytes":1157,"imports":[{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"packages/core/echo/echo/src/Database.ts","kind":"import-statement","original":"./Database"},{"path":"packages/core/echo/echo/src/Queue.ts","kind":"import-statement","original":"./Queue"},{"path":"packages/core/echo/echo/src/Space.ts","kind":"import-statement","original":"./Space"},{"path":"packages/core/echo/echo/src/Type.ts","kind":"import-statement","original":"./Type"}],"format":"esm"}},"outputs":{"packages/core/echo/echo/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4021},"packages/core/echo/echo/dist/lib/browser/index.mjs":{"imports":[{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"exports":["DXN","Database","Queue","Space","Type"],"entryPoint":"packages/core/echo/echo/src/index.ts","inputs":{"packages/core/echo/echo/src/index.ts":{"bytesInOutput":34},"packages/core/echo/echo/src/Database.ts":{"bytesInOutput":27},"packages/core/echo/echo/src/Queue.ts":{"bytesInOutput":24},"packages/core/echo/echo/src/Space.ts":{"bytesInOutput":24},"packages/core/echo/echo/src/Type.ts":{"bytesInOutput":744}},"bytes":1421}}}

package/dist/lib/node/index.cjs

@@ -0,0 +1,66 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var node_exports = {};
+__export(node_exports, {
+  DXN: () => import_keys.DXN,
+  Database: () => Database_exports,
+  Queue: () => Queue_exports,
+  Space: () => Space_exports,
+  Type: () => Type_exports
+});
+module.exports = __toCommonJS(node_exports);
+var import_keys = require("@dxos/keys");
+var import_echo_schema = require("@dxos/echo-schema");
+var import_live_object = require("@dxos/live-object");
+var __defProp2 = Object.defineProperty;
+var __export2 = (target, all) => {
+  for (var name in all)
+    __defProp2(target, name, { get: all[name], enumerable: true });
+};
+var Database_exports = {};
+var Queue_exports = {};
+var Space_exports = {};
+var Type_exports = {};
+__export2(Type_exports, {
+  Kind: () => import_echo_schema.EntityKind,
+  ObjectId: () => import_echo_schema.ObjectId,
+  Ref: () => Ref,
+  create: () => create,
+  def: () => def,
+  getDXN: () => import_echo_schema.getSchemaDXN,
+  getMeta: () => import_echo_schema.getTypeAnnotation,
+  getSchema: () => import_echo_schema.getSchema,
+  getTypename: () => import_echo_schema.getSchemaTypename,
+  getVersion: () => import_echo_schema.getSchemaVersion,
+  instanceOf: () => import_echo_schema.isInstanceOf,
+  ref: () => ref
+});
+var ref = import_live_object.makeRef;
+var create = import_live_object.create;
+var def = (meta) => (0, import_echo_schema.EchoObject)(meta);
+var Ref = (self) => (0, import_echo_schema.Ref)(self);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DXN,
+  Database,
+  Queue,
+  Space,
+  Type
+});
+//# sourceMappingURL=index.cjs.map

package/dist/lib/node/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/index.ts", "../../../src/Database.ts", "../../../src/Queue.ts", "../../../src/Space.ts", "../../../src/Type.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { DXN } from '@dxos/keys';\n\nexport { DXN };\n\nexport * as Database from './Database';\nexport * as Queue from './Queue';\nexport * as Space from './Space';\nexport * as Type from './Type';\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Database API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Database {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Queue API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Queue {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Space API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Space {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Schema } from 'effect';\n\nimport {\n  type BaseSchema,\n  type EchoSchema,\n  type Expando as Expando$,\n  type ImmutableSchema,\n  type JsonSchemaType,\n  type TypeMeta,\n  EchoObject,\n  EntityKind,\n  ObjectId,\n  Ref as Ref$,\n  getTypeAnnotation,\n  getSchema,\n  getSchemaDXN,\n  getSchemaTypename,\n  getSchemaVersion,\n  isInstanceOf,\n} from '@dxos/echo-schema';\nimport { create as create$, makeRef } from '@dxos/live-object';\n\n// NOTES:\n// - New Echo package and namespaces allow for incremental migration; vastly simplifies imports.\n// - Split into separate ECHO namespaces: Database, Space, Type, Query, Queue.\n//  - Example; import { Database, Type, Query, Queue } from '@dxos/echo';\n// - Use `declare namespace` for types (no code is generated). See Effect pattern, where Schema is a namespace, interface, and function.\n// - Test with @dxos/schema/testing types.\n// - Define user (Composer) types in namespace (e.g., of plugin) and drop Type suffix; remove all deprecated Braneframe types.\n\nexport type { TypeMeta as Meta, JsonSchemaType as JsonSchema };\nexport {\n  EntityKind as Kind,\n  ObjectId,\n  getTypeAnnotation as getMeta,\n  getSchema,\n  getSchemaDXN as getDXN,\n  getSchemaTypename as getTypename,\n  getSchemaVersion as getVersion,\n  isInstanceOf as instanceOf,\n};\n\n/**\n * Type API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Type {\n  /**\n   * A schema that can be extended with arbitrary properties.\n   */\n  export type Expando = Expando$;\n\n  export type Abstract<T = any> = BaseSchema<T>;\n  export type ImmutableType<T> = ImmutableSchema<T>;\n  export type MutableType<T> = EchoSchema<T>;\n}\n\n//\n// Constructors\n//\n\nexport const ref = makeRef;\nexport const create = create$;\n\n//\n// Combinators\n//\n\n/**\n * Defines an ECHO type.\n *\n * @example\n * ```ts\n * const Org = S.Struct({\n *   name: S.String,\n * }).pipe(Type.def({ typename: 'example.com/type/Org', version: '1.0.0' }));\n * ```\n */\nexport const def = (meta: TypeMeta) => EchoObject(meta);\n\n/**\n * Defines a reference to an ECHO object.\n *\n * @example\n * ```ts\n * import { Type } from '@dxos/echo';\n * const Contact = S.Struct({\n *   name: S.String,\n *   employer: Type.Ref(Org),\n * }).pipe(Type.def({ typename: 'example.com/type/Contact', version: '1.0.0' }));\n * ```\n */\nexport const Ref = <S extends Schema.Schema.AnyNoContext>(self: S) => Ref$<Schema.Schema.Type<S>>(self);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,kBAAoB;AIEpB,yBAiBO;AACP,yBAA2C;;;;;;AHxB3C,IAAA,mBAAA,CAAA;ACAA,IAAA,gBAAA,CAAA;ACAA,IAAA,gBAAA,CAAA;ACAA,IAAA,eAAA,CAAA;;;;;;;;;;;;;;;AAmEO,IAAMA,MAAMC;AACZ,IAAMC,SAASC,mBAAAA;AAgBf,IAAMC,MAAM,CAACC,aAAmBC,+BAAWD,IAAAA;AAc3C,IAAME,MAAM,CAAuCC,aAAYC,mBAAAA,KAA4BD,IAAAA;",
+  "names": ["ref", "makeRef", "create", "create$", "def", "meta", "EchoObject", "Ref", "self", "Ref$"]
+}

package/dist/lib/node/meta.json

@@ -0,0 +1 @@
+{"inputs":{"packages/core/echo/echo/src/Database.ts":{"bytes":689,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Queue.ts":{"bytes":671,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Space.ts":{"bytes":671,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Type.ts":{"bytes":6001,"imports":[{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"format":"esm"},"packages/core/echo/echo/src/index.ts":{"bytes":1157,"imports":[{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"packages/core/echo/echo/src/Database.ts","kind":"import-statement","original":"./Database"},{"path":"packages/core/echo/echo/src/Queue.ts","kind":"import-statement","original":"./Queue"},{"path":"packages/core/echo/echo/src/Space.ts","kind":"import-statement","original":"./Space"},{"path":"packages/core/echo/echo/src/Type.ts","kind":"import-statement","original":"./Type"}],"format":"esm"}},"outputs":{"packages/core/echo/echo/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4020},"packages/core/echo/echo/dist/lib/node/index.cjs":{"imports":[{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"exports":["DXN","Database","Queue","Space","Type"],"entryPoint":"packages/core/echo/echo/src/index.ts","inputs":{"packages/core/echo/echo/src/index.ts":{"bytesInOutput":34},"packages/core/echo/echo/src/Database.ts":{"bytesInOutput":27},"packages/core/echo/echo/src/Queue.ts":{"bytesInOutput":24},"packages/core/echo/echo/src/Space.ts":{"bytesInOutput":24},"packages/core/echo/echo/src/Type.ts":{"bytesInOutput":744}},"bytes":1388}}}

package/dist/lib/node-esm/index.mjs

@@ -0,0 +1,49 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// packages/core/echo/echo/src/index.ts
+import { DXN } from "@dxos/keys";
+
+// packages/core/echo/echo/src/Database.ts
+var Database_exports = {};
+
+// packages/core/echo/echo/src/Queue.ts
+var Queue_exports = {};
+
+// packages/core/echo/echo/src/Space.ts
+var Space_exports = {};
+
+// packages/core/echo/echo/src/Type.ts
+var Type_exports = {};
+__export(Type_exports, {
+  Kind: () => EntityKind,
+  ObjectId: () => ObjectId,
+  Ref: () => Ref,
+  create: () => create,
+  def: () => def,
+  getDXN: () => getSchemaDXN,
+  getMeta: () => getTypeAnnotation,
+  getSchema: () => getSchema,
+  getTypename: () => getSchemaTypename,
+  getVersion: () => getSchemaVersion,
+  instanceOf: () => isInstanceOf,
+  ref: () => ref
+});
+import { EchoObject, EntityKind, ObjectId, Ref as Ref$, getTypeAnnotation, getSchema, getSchemaDXN, getSchemaTypename, getSchemaVersion, isInstanceOf } from "@dxos/echo-schema";
+import { create as create$, makeRef } from "@dxos/live-object";
+var ref = makeRef;
+var create = create$;
+var def = (meta) => EchoObject(meta);
+var Ref = (self) => Ref$(self);
+export {
+  DXN,
+  Database_exports as Database,
+  Queue_exports as Queue,
+  Space_exports as Space,
+  Type_exports as Type
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/index.ts", "../../../src/Database.ts", "../../../src/Queue.ts", "../../../src/Space.ts", "../../../src/Type.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { DXN } from '@dxos/keys';\n\nexport { DXN };\n\nexport * as Database from './Database';\nexport * as Queue from './Queue';\nexport * as Space from './Space';\nexport * as Type from './Type';\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Database API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Database {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Queue API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Queue {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Space API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Space {}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Schema } from 'effect';\n\nimport {\n  type BaseSchema,\n  type EchoSchema,\n  type Expando as Expando$,\n  type ImmutableSchema,\n  type JsonSchemaType,\n  type TypeMeta,\n  EchoObject,\n  EntityKind,\n  ObjectId,\n  Ref as Ref$,\n  getTypeAnnotation,\n  getSchema,\n  getSchemaDXN,\n  getSchemaTypename,\n  getSchemaVersion,\n  isInstanceOf,\n} from '@dxos/echo-schema';\nimport { create as create$, makeRef } from '@dxos/live-object';\n\n// NOTES:\n// - New Echo package and namespaces allow for incremental migration; vastly simplifies imports.\n// - Split into separate ECHO namespaces: Database, Space, Type, Query, Queue.\n//  - Example; import { Database, Type, Query, Queue } from '@dxos/echo';\n// - Use `declare namespace` for types (no code is generated). See Effect pattern, where Schema is a namespace, interface, and function.\n// - Test with @dxos/schema/testing types.\n// - Define user (Composer) types in namespace (e.g., of plugin) and drop Type suffix; remove all deprecated Braneframe types.\n\nexport type { TypeMeta as Meta, JsonSchemaType as JsonSchema };\nexport {\n  EntityKind as Kind,\n  ObjectId,\n  getTypeAnnotation as getMeta,\n  getSchema,\n  getSchemaDXN as getDXN,\n  getSchemaTypename as getTypename,\n  getSchemaVersion as getVersion,\n  isInstanceOf as instanceOf,\n};\n\n/**\n * Type API.\n *\n * @category api namespace\n * @since 0.9.0\n */\nexport declare namespace Type {\n  /**\n   * A schema that can be extended with arbitrary properties.\n   */\n  export type Expando = Expando$;\n\n  export type Abstract<T = any> = BaseSchema<T>;\n  export type ImmutableType<T> = ImmutableSchema<T>;\n  export type MutableType<T> = EchoSchema<T>;\n}\n\n//\n// Constructors\n//\n\nexport const ref = makeRef;\nexport const create = create$;\n\n//\n// Combinators\n//\n\n/**\n * Defines an ECHO type.\n *\n * @example\n * ```ts\n * const Org = S.Struct({\n *   name: S.String,\n * }).pipe(Type.def({ typename: 'example.com/type/Org', version: '1.0.0' }));\n * ```\n */\nexport const def = (meta: TypeMeta) => EchoObject(meta);\n\n/**\n * Defines a reference to an ECHO object.\n *\n * @example\n * ```ts\n * import { Type } from '@dxos/echo';\n * const Contact = S.Struct({\n *   name: S.String,\n *   employer: Type.Ref(Org),\n * }).pipe(Type.def({ typename: 'example.com/type/Contact', version: '1.0.0' }));\n * ```\n */\nexport const Ref = <S extends Schema.Schema.AnyNoContext>(self: S) => Ref$<Schema.Schema.Type<S>>(self);\n"],
+  "mappings": ";;;;;;;;AAIA,SAASA,WAAW;;;ACJpB;;;ACAA;;;ACAA;;;ACAA;;;;;;;;;;;;;;;AAMA,SAOEC,YACAC,YACAC,UACAC,OAAOC,MACPC,mBACAC,WACAC,cACAC,mBACAC,kBACAC,oBACK;AACP,SAASC,UAAUC,SAASC,eAAe;AA2CpC,IAAMC,MAAMC;AACZ,IAAMC,SAASC;AAgBf,IAAMC,MAAM,CAACC,SAAmBC,WAAWD,IAAAA;AAc3C,IAAME,MAAM,CAAuCC,SAAYC,KAA4BD,IAAAA;",
+  "names": ["DXN", "EchoObject", "EntityKind", "ObjectId", "Ref", "Ref$", "getTypeAnnotation", "getSchema", "getSchemaDXN", "getSchemaTypename", "getSchemaVersion", "isInstanceOf", "create", "create$", "makeRef", "ref", "makeRef", "create", "create$", "def", "meta", "EchoObject", "Ref", "self", "Ref$"]
+}

package/dist/lib/node-esm/meta.json

@@ -0,0 +1 @@
+{"inputs":{"packages/core/echo/echo/src/Database.ts":{"bytes":689,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Queue.ts":{"bytes":671,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Space.ts":{"bytes":671,"imports":[],"format":"esm"},"packages/core/echo/echo/src/Type.ts":{"bytes":6001,"imports":[{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"format":"esm"},"packages/core/echo/echo/src/index.ts":{"bytes":1157,"imports":[{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"packages/core/echo/echo/src/Database.ts","kind":"import-statement","original":"./Database"},{"path":"packages/core/echo/echo/src/Queue.ts","kind":"import-statement","original":"./Queue"},{"path":"packages/core/echo/echo/src/Space.ts","kind":"import-statement","original":"./Space"},{"path":"packages/core/echo/echo/src/Type.ts","kind":"import-statement","original":"./Type"}],"format":"esm"}},"outputs":{"packages/core/echo/echo/dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4021},"packages/core/echo/echo/dist/lib/node-esm/index.mjs":{"imports":[{"path":"@dxos/keys","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"exports":["DXN","Database","Queue","Space","Type"],"entryPoint":"packages/core/echo/echo/src/index.ts","inputs":{"packages/core/echo/echo/src/index.ts":{"bytesInOutput":34},"packages/core/echo/echo/src/Database.ts":{"bytesInOutput":27},"packages/core/echo/echo/src/Queue.ts":{"bytesInOutput":24},"packages/core/echo/echo/src/Space.ts":{"bytesInOutput":24},"packages/core/echo/echo/src/Type.ts":{"bytesInOutput":744}},"bytes":1480}}}

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

@@ -0,0 +1,8 @@
+/**
+ * Database API.
+ *
+ * @category api namespace
+ * @since 0.9.0
+ */
+export declare namespace Database { }
+//# 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":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC,GAAE"}

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

@@ -0,0 +1,8 @@
+/**
+ * Queue API.
+ *
+ * @category api namespace
+ * @since 0.9.0
+ */
+export declare namespace Queue { }
+//# sourceMappingURL=Queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../src/Queue.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC,GAAE"}

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

@@ -0,0 +1,8 @@
+/**
+ * Space API.
+ *
+ * @category api namespace
+ * @since 0.9.0
+ */
+export declare namespace Space { }
+//# sourceMappingURL=Space.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Space.d.ts","sourceRoot":"","sources":["../../../src/Space.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC,GAAE"}

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

@@ -0,0 +1,49 @@
+import { type Schema } from 'effect';
+import { type BaseSchema, type EchoSchema, type Expando as Expando$, type ImmutableSchema, type JsonSchemaType, type TypeMeta, EntityKind, ObjectId, Ref as Ref$, getTypeAnnotation, getSchema, getSchemaDXN, getSchemaTypename, getSchemaVersion, isInstanceOf } from '@dxos/echo-schema';
+export type { TypeMeta as Meta, JsonSchemaType as JsonSchema };
+export { EntityKind as Kind, ObjectId, getTypeAnnotation as getMeta, getSchema, getSchemaDXN as getDXN, getSchemaTypename as getTypename, getSchemaVersion as getVersion, isInstanceOf as instanceOf, };
+/**
+ * Type API.
+ *
+ * @category api namespace
+ * @since 0.9.0
+ */
+export declare namespace Type {
+    /**
+     * A schema that can be extended with arbitrary properties.
+     */
+    type Expando = Expando$;
+    type Abstract<T = any> = BaseSchema<T>;
+    type ImmutableType<T> = ImmutableSchema<T>;
+    type MutableType<T> = EchoSchema<T>;
+}
+export declare const ref: <T extends import("@dxos/echo-schema").BaseObject>(obj: T) => Ref$<T>;
+export declare const create: {
+    <T extends import("@dxos/echo-schema").BaseObject>(obj: T): import("@dxos/live-object").ReactiveObject<T>;
+    <T extends import("@dxos/echo-schema").BaseObject>(schema: Schema.Schema<T, any, never>, obj: NoInfer<import("@dxos/echo-schema").ExcludeId<T>>, meta?: import("@dxos/echo-schema").ObjectMeta): import("@dxos/live-object").ReactiveObject<T>;
+};
+/**
+ * Defines an ECHO type.
+ *
+ * @example
+ * ```ts
+ * const Org = S.Struct({
+ *   name: S.String,
+ * }).pipe(Type.def({ typename: 'example.com/type/Org', version: '1.0.0' }));
+ * ```
+ */
+export declare const def: (meta: TypeMeta) => <Self extends Schema.Schema.Any>(self: Self) => import("@dxos/echo-schema").EchoObjectSchema<Self>;
+/**
+ * Defines a reference to an ECHO object.
+ *
+ * @example
+ * ```ts
+ * import { Type } from '@dxos/echo';
+ * const Contact = S.Struct({
+ *   name: S.String,
+ *   employer: Type.Ref(Org),
+ * }).pipe(Type.def({ typename: 'example.com/type/Contact', version: '1.0.0' }));
+ * ```
+ */
+export declare const Ref: <S extends Schema.Schema.AnyNoContext>(self: S) => import("@dxos/echo-schema").Ref$<Schema.Schema.Type<S>>;
+//# sourceMappingURL=Type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Type.d.ts","sourceRoot":"","sources":["../../../src/Type.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,OAAO,IAAI,QAAQ,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,QAAQ,EAEb,UAAU,EACV,QAAQ,EACR,GAAG,IAAI,IAAI,EACX,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAW3B,YAAY,EAAE,QAAQ,IAAI,IAAI,EAAE,cAAc,IAAI,UAAU,EAAE,CAAC;AAC/D,OAAO,EACL,UAAU,IAAI,IAAI,EAClB,QAAQ,EACR,iBAAiB,IAAI,OAAO,EAC5B,SAAS,EACT,YAAY,IAAI,MAAM,EACtB,iBAAiB,IAAI,WAAW,EAChC,gBAAgB,IAAI,UAAU,EAC9B,YAAY,IAAI,UAAU,GAC3B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B;;OAEG;IACH,KAAY,OAAO,GAAG,QAAQ,CAAC;IAE/B,KAAY,QAAQ,CAAC,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9C,KAAY,aAAa,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;IAClD,KAAY,WAAW,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;CAC5C;AAMD,eAAO,MAAM,GAAG,uEAAU,CAAC;AAC3B,eAAO,MAAM,MAAM;;;CAAU,CAAC;AAM9B;;;;;;;;;GASG;AACH,eAAO,MAAM,GAAG,SAAU,QAAQ,uGAAqB,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,QAAQ,CAAC,4DAAsC,CAAC"}

package/dist/types/src/api.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.test.d.ts.map

package/dist/types/src/api.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.test.d.ts","sourceRoot":"","sources":["../../../src/api.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,7 @@
+import { DXN } from '@dxos/keys';
+export { DXN };
+export * as Database from './Database';
+export * as Queue from './Queue';
+export * as Space from './Space';
+export * as Type from './Type';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,GAAG,EAAE,CAAC;AAEf,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC"}

package/dist/types/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"version":"5.7.3"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@dxos/echo",
+  "version": "0.8.1-staging.31c3ee1",
+  "description": "ECHO API",
+  "homepage": "https://dxos.org",
+  "bugs": "https://github.com/dxos/dxos/issues",
+  "license": "MIT",
+  "author": "info@dxos.org",
+  "sideEffects": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types/src/index.d.ts",
+      "browser": "./dist/lib/browser/index.mjs",
+      "node": "./dist/lib/node-esm/index.mjs"
+    }
+  },
+  "types": "dist/types/src/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@preact/signals-core": "^1.6.0",
+    "effect": "3.13.3",
+    "@dxos/debug": "0.8.1-staging.31c3ee1",
+    "@dxos/echo-db": "0.8.1-staging.31c3ee1",
+    "@dxos/echo-signals": "0.8.1-staging.31c3ee1",
+    "@dxos/echo-schema": "0.8.1-staging.31c3ee1",
+    "@dxos/echo-protocol": "0.8.1-staging.31c3ee1",
+    "@dxos/effect": "0.8.1-staging.31c3ee1",
+    "@dxos/invariant": "0.8.1-staging.31c3ee1",
+    "@dxos/keys": "0.8.1-staging.31c3ee1",
+    "@dxos/live-object": "0.8.1-staging.31c3ee1",
+    "@dxos/log": "0.8.1-staging.31c3ee1",
+    "@dxos/node-std": "0.8.1-staging.31c3ee1",
+    "@dxos/util": "0.8.1-staging.31c3ee1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "beast": {}
+}

package/src/Database.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+/**
+ * Database API.
+ *
+ * @category api namespace
+ * @since 0.9.0
+ */
+export declare namespace Database {}

package/src/Queue.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+/**
+ * Queue API.
+ *
+ * @category api namespace
+ * @since 0.9.0
+ */
+export declare namespace Queue {}

package/src/Space.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+/**
+ * Space API.
+ *
+ * @category api namespace
+ * @since 0.9.0
+ */
+export declare namespace Space {}

package/src/Type.ts

@@ -0,0 +1,99 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { type Schema } from 'effect';
+
+import {
+  type BaseSchema,
+  type EchoSchema,
+  type Expando as Expando$,
+  type ImmutableSchema,
+  type JsonSchemaType,
+  type TypeMeta,
+  EchoObject,
+  EntityKind,
+  ObjectId,
+  Ref as Ref$,
+  getTypeAnnotation,
+  getSchema,
+  getSchemaDXN,
+  getSchemaTypename,
+  getSchemaVersion,
+  isInstanceOf,
+} from '@dxos/echo-schema';
+import { create as create$, makeRef } from '@dxos/live-object';
+
+// NOTES:
+// - New Echo package and namespaces allow for incremental migration; vastly simplifies imports.
+// - Split into separate ECHO namespaces: Database, Space, Type, Query, Queue.
+//  - Example; import { Database, Type, Query, Queue } from '@dxos/echo';
+// - Use `declare namespace` for types (no code is generated). See Effect pattern, where Schema is a namespace, interface, and function.
+// - Test with @dxos/schema/testing types.
+// - Define user (Composer) types in namespace (e.g., of plugin) and drop Type suffix; remove all deprecated Braneframe types.
+
+export type { TypeMeta as Meta, JsonSchemaType as JsonSchema };
+export {
+  EntityKind as Kind,
+  ObjectId,
+  getTypeAnnotation as getMeta,
+  getSchema,
+  getSchemaDXN as getDXN,
+  getSchemaTypename as getTypename,
+  getSchemaVersion as getVersion,
+  isInstanceOf as instanceOf,
+};
+
+/**
+ * Type API.
+ *
+ * @category api namespace
+ * @since 0.9.0
+ */
+export declare namespace Type {
+  /**
+   * A schema that can be extended with arbitrary properties.
+   */
+  export type Expando = Expando$;
+
+  export type Abstract<T = any> = BaseSchema<T>;
+  export type ImmutableType<T> = ImmutableSchema<T>;
+  export type MutableType<T> = EchoSchema<T>;
+}
+
+//
+// Constructors
+//
+
+export const ref = makeRef;
+export const create = create$;
+
+//
+// Combinators
+//
+
+/**
+ * Defines an ECHO type.
+ *
+ * @example
+ * ```ts
+ * const Org = S.Struct({
+ *   name: S.String,
+ * }).pipe(Type.def({ typename: 'example.com/type/Org', version: '1.0.0' }));
+ * ```
+ */
+export const def = (meta: TypeMeta) => EchoObject(meta);
+
+/**
+ * Defines a reference to an ECHO object.
+ *
+ * @example
+ * ```ts
+ * import { Type } from '@dxos/echo';
+ * const Contact = S.Struct({
+ *   name: S.String,
+ *   employer: Type.Ref(Org),
+ * }).pipe(Type.def({ typename: 'example.com/type/Contact', version: '1.0.0' }));
+ * ```
+ */
+export const Ref = <S extends Schema.Schema.AnyNoContext>(self: S) => Ref$<Schema.Schema.Type<S>>(self);

package/src/api.test.ts

@@ -0,0 +1,94 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Schema as S } from 'effect';
+import { describe, test } from 'vitest';
+
+import { raise } from '@dxos/debug';
+import { FormatEnum, FormatAnnotation } from '@dxos/echo-schema';
+
+// Deliberately testing top-level import as if external consumer for @dxos/echo.
+import { Type } from '.';
+
+namespace Testing {
+  export const Org = S.Struct({
+    id: Type.ObjectId,
+    name: S.String,
+  }).pipe(
+    Type.def({
+      typename: 'example.com/type/Org',
+      version: '0.1.0',
+    }),
+  );
+
+  export interface Org extends S.Schema.Type<typeof Org> {}
+
+  export const Contact = S.Struct({
+    name: S.String,
+    dob: S.optional(S.String),
+    email: S.optional(S.String.pipe(FormatAnnotation.set(FormatEnum.Email))),
+    org: S.optional(Type.Ref(Org)),
+  }).pipe(
+    Type.def({
+      typename: 'example.com/type/Contact',
+      version: '0.1.0',
+    }),
+  );
+
+  export interface Contact extends S.Schema.Type<typeof Contact> {}
+
+  export const Message = S.Struct({
+    // TODO(burdon): Support S.Date; Custom Timestamp (with defaults).
+    // TODO(burdon): Support defaults (update create and createStatic).
+    timestamp: S.String.pipe(
+      S.propertySignature,
+      S.withConstructorDefault(() => new Date().toISOString()),
+    ),
+  });
+
+  // TODO(burdon): Fix (Type.def currently removes TypeLiteral that implements the `make` function)..
+  // }).pipe(
+  //   Type.def({
+  //     typename: 'example.com/type/Message',
+  //     version: '0.1.0',
+  //   }),
+  // );
+
+  export interface Message extends S.Schema.Type<typeof Message> {}
+}
+
+describe('Experimental API review', () => {
+  test('type checks', ({ expect }) => {
+    const contact = Type.create(Testing.Contact, { name: 'Test' });
+    const type: S.Schema<Testing.Contact> = Type.getSchema(contact) ?? raise(new Error('No schema found'));
+
+    expect(Type.getDXN(type)?.typename).to.eq(Testing.Contact.typename);
+    expect(Type.getTypename(type)).to.eq('example.com/type/Contact');
+    expect(Type.getVersion(type)).to.eq('0.1.0');
+    expect(Type.getMeta(type)).to.deep.eq({
+      kind: Type.Kind.Object,
+      typename: 'example.com/type/Contact',
+      version: '0.1.0',
+    });
+  });
+
+  test('instance checks', ({ expect }) => {
+    // TODO(burdon): Implement.
+    // const org = Org.create({ name: 'DXOS' });
+    const org = Type.create(Testing.Org, { name: 'DXOS' });
+    const contact = Type.create(Testing.Contact, { name: 'Test', org: Type.ref(org) });
+
+    expect(S.is(Testing.Contact)(contact)).to.be.true;
+    expect(Testing.Contact.instanceOf(contact)).to.be.true;
+    expect(Type.instanceOf(Testing.Contact, contact)).to.be.true;
+    expect(Type.instanceOf(Testing.Org, contact.org?.target)).to.be.true;
+  });
+
+  test('default props', ({ expect }) => {
+    // TODO(burdon): Doesn't work after pipe(Type.def).
+    // Property 'make' does not exist on type 'EchoObjectSchema<Struct<{ timestamp: PropertySignature<":", string, never, ":", string, true, never>; }>>'.ts(2339)
+    const message = Type.create(Testing.Message, Testing.Message.make({}));
+    expect(message.timestamp).to.exist;
+  });
+});

package/src/index.ts

@@ -0,0 +1,12 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { DXN } from '@dxos/keys';
+
+export { DXN };
+
+export * as Database from './Database';
+export * as Queue from './Queue';
+export * as Space from './Space';
+export * as Type from './Type';