@dxos/echo 0.8.2 → 0.8.3-main.7f5a14c

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -26,28 +26,30 @@ License: [MIT](./LICENSE) Copyright 2022 © DXOS
26
26
  import { Type, Obj, Relation, Ref, Query, Filter } from '@dxos/echo';
27
27
  ```
28
28
 
29
- | | Object | Relation | Ref |
30
- | ----------------------------- | ------------------------------- | ------------------------------------------- | --------------- |
29
+ | | Object | Relation (extends Obj) | Ref |
30
+ | ----------------------------- | -------------------------- | -------------------------- | -------------- |
31
31
  | **SCHEMA API** |
32
- | Define schema | `Type.Obj()` | `Type.Relation()` | `Type.Ref()` |
33
- | Any schema type | `Type.Obj.Any` | `Type.Relation.Any` | `Type.Ref.Any` |
34
- | Get DXN (of schema) | `Type.getDXN(schema)` | `Type.getDXN(schema)` | |
35
- | Get typename (of schema) | `Type.getTypename(schema)` | `Type.getTypename(schema)` | |
36
- | Get type metadata (of schema) | `Type.getMeta(schema)` | `Type.getMeta(schema)` | |
37
- | Is mutable schema | `Type.isMutable(schema)` | `Type.isMutable(schema)` |
38
- | **DATA API** |
39
- | Any instance type | `Obj.Any` | `Relation.Any` | `Ref.Any` |
40
- | Create object | `Obj.make(Schema, { ... })` | `Relation.make(Schema, { ... })` | `Ref.make(obj)` |
41
- | Check kind | `Obj.isObject(x): x is Obj.Any` | `Relation.isRelation(x): x is Relation.Any` | `Ref.isRef(x)` |
42
- | Check instance of | `Obj.instanceOf(Schema, obj)` | `Obj.instanceOf(Schema, rel)` | |
43
- | Get schema | `Obj.getSchema(obj)` | `Obj.getSchema(obj)` | |
44
- | Get DXN (of instance) | `Obj.getDXN(obj)` | `Obj.getDXN(obj)` | |
45
- | Get typename (of instance) | `Obj.getTypename(obj)` | `Obj.getTypename(obj)` | |
46
- | Get Meta | `Obj.getMeta(obj)` | `Obj.getMeta(relation)` | |
47
- | Is deleted | `Obj.isDeleted(obj)` | `Obj.isDeleted(obj)` | |
48
- | Get relation source | | `Relation.getSource(relation)` |
49
- | Get relation target | | `Relation.getTarget(relation)` | |
50
- | Expando | `Expando` |
32
+ | Define schema | `Type.Obj()` | `Type.Relation()` | `Type.Ref()` |
33
+ | Any schema type | `Type.Obj.Any` | `Type.Relation.Any` | `Type.Ref.Any` |
34
+ | Get DXN (of schema) | `Type.getDXN(schema)` | `Type.getDXN(schema)` | |
35
+ | Get typename (of schema) | `Type.getTypename(schema)` | `Type.getTypename(schema)` | |
36
+ | Get type metadata (of schema) | `Type.getMeta(schema)` | `Type.getMeta(schema)` | |
37
+ | Is mutable schema | `Type.isMutable(schema)` | `Type.isMutable(schema)` | |
38
+ | Expando | `Type.Expando` |
39
+
40
+ |
41
+ | **DATA API** |
42
+ | Any instance type | `Obj.Any` | `Relation.Any` | `Ref.Any` |
43
+ | Create object | `Obj.make(Schema, { ... })` | `Relation.make(Schema, { ... })` | `Ref.make(obj)` |
44
+ | Check kind | `Obj.isObject(obj)` | `Relation.isRelation(obj)` | `Ref.isRef(ref)` |
45
+ | Get relation source | | `Relation.getSource(relation)` | |
46
+ | Get relation target | | `Relation.getTarget(relation)` | |
47
+ | Check instance of | `Obj.instanceOf(Schema, obj)` |
48
+ | Get schema | `Obj.getSchema(obj)` |
49
+ | Get DXN (of instance) | `Obj.getDXN(obj)` |
50
+ | Get typename (of instance) | `Obj.getTypename(obj)` |
51
+ | Get Meta | `Obj.getMeta(obj)` |
52
+ | Is deleted | `Obj.isDeleted(obj)` |
51
53
 
52
54
  ```ts
53
55
  Type.getDXN(schema) == DXN.parse('dxn:type:example.com/type/Person:0.1.0');
@@ -58,12 +60,12 @@ Type.getVersion(schema) === '0.1.0'
58
60
  Obj.getDXN(obj) === DXN.parse('dxn:echo:SSSSSSSSSS:XXXXXXXXXXXXX')
59
61
 
60
62
  // We need this for objects that have typename defined, but their schema can't be resolved (Obj.getSchema(obj) === undefined)
61
- Obj.getSchemaDXN(obj) === DXN.parse('dxn:type:example.com/type/Person:0.1.0');
63
+ Obj.getTypeDXN(obj) === DXN.parse('dxn:type:example.com/type/Person:0.1.0');
62
64
 
63
65
  /**
64
66
  * @deprecated
65
67
  **/
66
- // TODO(dmaretskyi): Consider keeping it as a shorthand for zType.getTypename(Obj.getSchema(obj)) ?? Obj.getSchemaDXN(obj)?.asTypeDXN()?.type`
68
+ // TODO(dmaretskyi): Consider keeping it as a shorthand for zType.getTypename(Obj.getSchema(obj)) ?? Obj.getTypeDXN(obj)?.asTypeDXN()?.type`
67
69
  Obj.getTypename(obj) === 'example.com/type/Person'
68
70
  ```
69
71
 
@@ -117,18 +119,22 @@ Obj.fromJSON(json, { graph, db });
117
119
 
118
120
  Defines attributes and encoding placed on objects.
119
121
 
120
- | | Optional | Runtime prop | Runtime type | JSON prop | JSON type | Description |
121
- | ---------------- | ---------------------- | ----------------------------------- | ---------------------- | --------------------------- | --------- | ------------------------------------ |
122
- | Id | No | `id` | `ObjectID` ULID string | `id` | string | Unique object ID |
123
- | Self DXN | Yes | `Symbol(@dxos/echo/Self)` | `DXN` | `@self` | string | DXN to the object itself |
124
- | Typename | No | `Symbol(@dxos/echo/Typename)` | `DXN` | `@type` | string | DXN to the object type |
125
- | Tombstone marker | Yes | `Symbol(@dxos/echo/Deleted)` | `boolean` | `@deleted` | boolean | Deletion marker |
126
- | Metadata | Yes | `Symbol(@dxos/echo/Meta)` | Metadata object | `@meta` | object | Metadata section |
127
- | Entity kind | No | `Symbol(@dxos/echo/EntityKind)` | `EntityKind` | (inferred from other props) | string | Obj vs Relation |
128
- | Relation Source | No (only on relations) | `Symbol(@dxos/echo/RelationSource)` | `DXN` | `@relationSource` | string | Relation source DXN |
129
- | Relation Target | No (only on relations) | `Symbol(@dxos/echo/RelationTarget)` | `DXN` | `@relationTarget` | string | Relation target DXN |
130
- | Hypergraph | Yes | `Symbol(@dxos/echo/Hypergraph)` | `Hypergraph` | - | - | Pointer to runtime hypergraph object |
131
- | Database | Yes | `Symbol(@dxos/echo/Database)` | `Database` | - | - | Pointer to runtime database object |
122
+ | | Optional | Runtime prop | Runtime type | JSON prop | JSON type | Description |
123
+ | ------------------- | ----------------------- | -------------------------------------- | ---------------------- | --------------------------- | ---------- | ------------------------------ |
124
+ | Id | No | `id` | `ObjectID` ULID string | `id` | string | Unique object ID |
125
+ | Self DXN | Yes | `Symbol(@dxos/echo/Self)` | `DXN` | `@self` | string | DXN to the object itself |
126
+ | Type | No | `Symbol(@dxos/echo/Type)` | `DXN` | `@type` | string | DXN to the object type |
127
+ | Schema | Yes | `Symbol(@dxos/echo/Schema)` | Effect-Schema | - | | Reference to the object schema |
128
+ | Tombstone marker | Yes | `Symbol(@dxos/echo/Deleted)` | `boolean` | `@deleted` | boolean | Deletion marker |
129
+ | Metadata | Yes | `Symbol(@dxos/echo/Meta)` | Metadata object | `@meta` | object | Metadata section |
130
+ | Entity kind | No | `Symbol(@dxos/echo/EntityKind)` | `EntityKind` | (inferred from other props) | string | Obj vs Relation |
131
+ | Relation Source DXN | No (only on relations) | `Symbol(@dxos/echo/RelationSourceDXN)` | `DXN` | `@relationSource` | DXN string | Relation source DXN |
132
+ | Relation Target DXN | No (only on relations) | `Symbol(@dxos/echo/RelationTargetDXN)` | `DXN` | `@relationTarget` | DXN string | Relation target DXN |
133
+ | Relation Source | Yes (only on relations) | `Symbol(@dxos/echo/RelationSource)` | `Object` | - | | Relation source object |
134
+ | Relation Target | Yes (only on relations) | `Symbol(@dxos/echo/RelationTarget)` | `Object` | - | | Relation target object |
135
+
136
+ > NOTE: All of the API functions can return `undefined` since they are also designed to work with objects outside of the database.
137
+ > TODO: Consider how Database, Hypergraph, and RefResolver are attached to the object.
132
138
 
133
139
  ### Value representation
134
140
 
@@ -5,111 +5,54 @@ var __export = (target, all) => {
5
5
  __defProp(target, name, { get: all[name], enumerable: true });
6
6
  };
7
7
 
8
- // packages/core/echo/echo/src/Type.ts
9
- var Type_exports = {};
10
- __export(Type_exports, {
11
- DXN: () => DXN,
12
- Expando: () => Expando,
13
- Format: () => Format,
14
- JsonSchema: () => JsonSchemaType,
15
- Kind: () => EntityKind,
16
- Obj: () => Obj,
8
+ // packages/core/echo/echo/src/Key.ts
9
+ var Key_exports = {};
10
+ __export(Key_exports, {
17
11
  ObjectId: () => ObjectId,
18
- Ref: () => Ref2,
19
- Relation: () => Relation,
20
- SpaceId: () => SpaceId,
21
- getDXN: () => getDXN,
22
- getMeta: () => getMeta,
23
- getTypename: () => getTypename,
24
- getVersion: () => getVersion,
25
- isMutable: () => isMutable2,
26
- toJsonSchema: () => toJsonSchema
12
+ SpaceId: () => SpaceId
27
13
  });
28
- import * as EchoSchema from "@dxos/echo-schema";
29
- import { invariant } from "@dxos/invariant";
30
- import { EntityKind } from "@dxos/echo-schema";
31
- import { SpaceId, ObjectId, DXN } from "@dxos/keys";
32
- import {
33
- Expando,
34
- JsonSchemaType,
35
- toJsonSchema,
36
- Format
37
- } from "@dxos/echo-schema";
38
- var __dxlog_file = "/home/runner/work/dxos/dxos/packages/core/echo/echo/src/Type.ts";
39
- var Obj = EchoSchema.EchoObject;
40
- var Relation = EchoSchema.EchoRelation;
41
- var Ref2 = EchoSchema.Ref;
42
- var getDXN = (schema) => {
43
- return EchoSchema.getSchemaDXN(schema);
44
- };
45
- var getTypename = (schema) => {
46
- const typename = EchoSchema.getSchemaTypename(schema);
47
- invariant(typeof typename === "string" && !typename.startsWith("dxn:"), "Invalid typename", {
48
- F: __dxlog_file,
49
- L: 84,
50
- S: void 0,
51
- A: [
52
- "typeof typename === 'string' && !typename.startsWith('dxn:')",
53
- "'Invalid typename'"
54
- ]
55
- });
56
- return typename;
57
- };
58
- var getVersion = (schema) => {
59
- const version = EchoSchema.getSchemaVersion(schema);
60
- invariant(typeof version === "string" && version.match(/^\d+\.\d+\.\d+$/), "Invalid version", {
61
- F: __dxlog_file,
62
- L: 94,
63
- S: void 0,
64
- A: [
65
- "typeof version === 'string' && version.match(/^\\d+\\.\\d+\\.\\d+$/)",
66
- "'Invalid version'"
67
- ]
68
- });
69
- return version;
70
- };
71
- var getMeta = (schema) => {
72
- return EchoSchema.getTypeAnnotation(schema);
73
- };
74
- var isMutable2 = (schema) => {
75
- return EchoSchema.isMutable(schema);
76
- };
14
+ import { SpaceId, ObjectId } from "@dxos/keys";
77
15
 
78
16
  // packages/core/echo/echo/src/Obj.ts
79
17
  var Obj_exports = {};
80
18
  __export(Obj_exports, {
81
- getDXN: () => getDXN3,
82
- getMeta: () => getMeta3,
19
+ fromJSON: () => fromJSON,
20
+ getDXN: () => getDXN,
21
+ getLabel: () => getLabel2,
22
+ getMeta: () => getMeta2,
83
23
  getSchema: () => getSchema2,
84
- getSchemaDXN: () => getSchemaDXN2,
85
- getTypename: () => getTypename3,
24
+ getTypeDXN: () => getTypeDXN,
25
+ getTypename: () => getTypename,
86
26
  instanceOf: () => instanceOf,
87
27
  isDeleted: () => isDeleted2,
88
28
  isObject: () => isObject,
89
- make: () => make
29
+ make: () => make,
30
+ toJSON: () => toJSON
90
31
  });
91
32
  import { Schema } from "effect";
92
- import * as EchoSchema2 from "@dxos/echo-schema";
93
- import { assertArgument, invariant as invariant2 } from "@dxos/invariant";
33
+ import * as EchoSchema from "@dxos/echo-schema";
34
+ import { assertArgument, invariant } from "@dxos/invariant";
94
35
  import * as LiveObject from "@dxos/live-object";
95
- var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/core/echo/echo/src/Obj.ts";
36
+ import { assumeType } from "@dxos/util";
37
+ var __dxlog_file = "/home/runner/work/dxos/dxos/packages/core/echo/echo/src/Obj.ts";
96
38
  var make = LiveObject.live;
97
39
  var isObject = (obj) => {
98
- return LiveObject.isLiveObject(obj);
40
+ assumeType(obj);
41
+ return typeof obj === "object" && obj !== null && obj[EchoSchema.EntityKindId] === EchoSchema.EntityKind.Object;
99
42
  };
100
43
  var instanceOf = (...args) => {
101
44
  if (args.length === 1) {
102
- return (obj) => EchoSchema2.isInstanceOf(args[0], obj);
45
+ return (obj) => EchoSchema.isInstanceOf(args[0], obj);
103
46
  }
104
- return EchoSchema2.isInstanceOf(args[0], args[1]);
47
+ return EchoSchema.isInstanceOf(args[0], args[1]);
105
48
  };
106
- var getSchema2 = EchoSchema2.getSchema;
107
- var getDXN3 = (obj) => {
49
+ var getSchema2 = EchoSchema.getSchema;
50
+ var getDXN = (obj) => {
108
51
  assertArgument(!Schema.isSchema(obj), "Object should not be a schema.");
109
- const dxn = EchoSchema2.getDXN(obj);
110
- invariant2(dxn != null, "Invalid object.", {
111
- F: __dxlog_file2,
112
- L: 48,
52
+ const dxn = EchoSchema.getObjectDXN(obj);
53
+ invariant(dxn != null, "Invalid object.", {
54
+ F: __dxlog_file,
55
+ L: 58,
113
56
  S: void 0,
114
57
  A: [
115
58
  "dxn != null",
@@ -118,31 +61,19 @@ var getDXN3 = (obj) => {
118
61
  });
119
62
  return dxn;
120
63
  };
121
- var getSchemaDXN2 = (obj) => {
122
- const type = EchoSchema2.getType(obj);
123
- invariant2(type != null, "Invalid object.", {
124
- F: __dxlog_file2,
125
- L: 58,
126
- S: void 0,
127
- A: [
128
- "type != null",
129
- "'Invalid object.'"
130
- ]
131
- });
132
- return type;
133
- };
134
- var getTypename3 = (obj) => {
64
+ var getTypeDXN = EchoSchema.getType;
65
+ var getTypename = (obj) => {
135
66
  const schema = getSchema2(obj);
136
67
  if (schema == null) {
137
- return getSchemaDXN2(obj)?.asTypeDXN()?.type;
68
+ return EchoSchema.getType(obj)?.asTypeDXN()?.type;
138
69
  }
139
- return EchoSchema2.getTypename(schema);
70
+ return EchoSchema.getSchemaTypename(schema);
140
71
  };
141
- var getMeta3 = (obj) => {
142
- const meta = EchoSchema2.getMeta(obj);
143
- invariant2(meta != null, "Invalid object.", {
144
- F: __dxlog_file2,
145
- L: 78,
72
+ var getMeta2 = (obj) => {
73
+ const meta = EchoSchema.getMeta(obj);
74
+ invariant(meta != null, "Invalid object.", {
75
+ F: __dxlog_file,
76
+ L: 86,
146
77
  S: void 0,
147
78
  A: [
148
79
  "meta != null",
@@ -152,10 +83,10 @@ var getMeta3 = (obj) => {
152
83
  return meta;
153
84
  };
154
85
  var isDeleted2 = (obj) => {
155
- const deleted = EchoSchema2.isDeleted(obj);
156
- invariant2(typeof deleted === "boolean", "Invalid object.", {
157
- F: __dxlog_file2,
158
- L: 84,
86
+ const deleted = EchoSchema.isDeleted(obj);
87
+ invariant(typeof deleted === "boolean", "Invalid object.", {
88
+ F: __dxlog_file,
89
+ L: 93,
159
90
  S: void 0,
160
91
  A: [
161
92
  "typeof deleted === 'boolean'",
@@ -164,20 +95,50 @@ var isDeleted2 = (obj) => {
164
95
  });
165
96
  return deleted;
166
97
  };
98
+ var getLabel2 = (obj) => {
99
+ const schema = getSchema2(obj);
100
+ if (schema != null) {
101
+ return EchoSchema.getLabel(schema, obj);
102
+ }
103
+ };
104
+ var toJSON = (obj) => EchoSchema.objectToJSON(obj);
105
+ var fromJSON = EchoSchema.objectFromJSON;
106
+
107
+ // packages/core/echo/echo/src/Ref.ts
108
+ var Ref_exports = {};
109
+ __export(Ref_exports, {
110
+ Array: () => Array,
111
+ fromDXN: () => fromDXN,
112
+ isRef: () => isRef,
113
+ make: () => make2
114
+ });
115
+ import * as EchoSchema2 from "@dxos/echo-schema";
116
+ var Array = EchoSchema2.RefArray;
117
+ var isRef = EchoSchema2.Ref.isRef;
118
+ var make2 = EchoSchema2.Ref.make;
119
+ var fromDXN = EchoSchema2.Ref.fromDXN;
167
120
 
168
121
  // packages/core/echo/echo/src/Relation.ts
169
122
  var Relation_exports = {};
170
123
  __export(Relation_exports, {
124
+ Source: () => Source,
125
+ Target: () => Target,
171
126
  getSource: () => getSource,
127
+ getSourceDXN: () => getSourceDXN,
172
128
  getTarget: () => getTarget,
129
+ getTargetDXN: () => getTargetDXN,
173
130
  isRelation: () => isRelation,
174
- make: () => make2
131
+ make: () => make3
175
132
  });
176
133
  import * as EchoSchema3 from "@dxos/echo-schema";
177
- import { invariant as invariant3 } from "@dxos/invariant";
134
+ import { assertArgument as assertArgument2, invariant as invariant2 } from "@dxos/invariant";
135
+ import { DXN } from "@dxos/keys";
178
136
  import * as LiveObject2 from "@dxos/live-object";
179
- var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/core/echo/echo/src/Relation.ts";
180
- var make2 = LiveObject2.live;
137
+ import { assumeType as assumeType2 } from "@dxos/util";
138
+ var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/core/echo/echo/src/Relation.ts";
139
+ var Source = EchoSchema3.RelationSourceId;
140
+ var Target = EchoSchema3.RelationTargetId;
141
+ var make3 = LiveObject2.live;
181
142
  var isRelation = (value) => {
182
143
  if (typeof value !== "object" || value === null) {
183
144
  return false;
@@ -185,23 +146,45 @@ var isRelation = (value) => {
185
146
  if (EchoSchema3.ATTR_RELATION_SOURCE in value || EchoSchema3.ATTR_RELATION_TARGET in value) {
186
147
  return true;
187
148
  }
188
- const kind = value[EchoSchema3.EntityKindPropertyId];
149
+ const kind = value[EchoSchema3.EntityKindId];
189
150
  return kind === EchoSchema3.EntityKind.Relation;
190
151
  };
191
- var getSource = (relation) => {
192
- invariant3(isRelation(relation), void 0, {
193
- F: __dxlog_file3,
194
- L: 30,
152
+ var getSourceDXN = (value) => {
153
+ assertArgument2(isRelation(value), "Expected a relation");
154
+ assumeType2(value);
155
+ const dxn = value[EchoSchema3.RelationSourceDXNId];
156
+ invariant2(dxn instanceof DXN, void 0, {
157
+ F: __dxlog_file2,
158
+ L: 38,
159
+ S: void 0,
160
+ A: [
161
+ "dxn instanceof DXN",
162
+ ""
163
+ ]
164
+ });
165
+ return dxn;
166
+ };
167
+ var getTargetDXN = (value) => {
168
+ assertArgument2(isRelation(value), "Expected a relation");
169
+ assumeType2(value);
170
+ const dxn = value[EchoSchema3.RelationTargetDXNId];
171
+ invariant2(dxn instanceof DXN, void 0, {
172
+ F: __dxlog_file2,
173
+ L: 50,
195
174
  S: void 0,
196
175
  A: [
197
- "isRelation(relation)",
176
+ "dxn instanceof DXN",
198
177
  ""
199
178
  ]
200
179
  });
180
+ return dxn;
181
+ };
182
+ var getSource = (relation) => {
183
+ assertArgument2(isRelation(relation), "Expected a relation");
201
184
  const obj = relation[EchoSchema3.RelationSourceId];
202
- invariant3(obj !== void 0, `Invalid source: ${relation.id}`, {
203
- F: __dxlog_file3,
204
- L: 32,
185
+ invariant2(obj !== void 0, `Invalid source: ${relation.id}`, {
186
+ F: __dxlog_file2,
187
+ L: 61,
205
188
  S: void 0,
206
189
  A: [
207
190
  "obj !== undefined",
@@ -211,19 +194,11 @@ var getSource = (relation) => {
211
194
  return obj;
212
195
  };
213
196
  var getTarget = (relation) => {
214
- invariant3(isRelation(relation), void 0, {
215
- F: __dxlog_file3,
216
- L: 41,
217
- S: void 0,
218
- A: [
219
- "isRelation(relation)",
220
- ""
221
- ]
222
- });
197
+ assertArgument2(isRelation(relation), "Expected a relation");
223
198
  const obj = relation[EchoSchema3.RelationTargetId];
224
- invariant3(obj !== void 0, `Invalid target: ${relation.id}`, {
225
- F: __dxlog_file3,
226
- L: 43,
199
+ invariant2(obj !== void 0, `Invalid target: ${relation.id}`, {
200
+ F: __dxlog_file2,
201
+ L: 72,
227
202
  S: void 0,
228
203
  A: [
229
204
  "obj !== undefined",
@@ -233,22 +208,83 @@ var getTarget = (relation) => {
233
208
  return obj;
234
209
  };
235
210
 
236
- // packages/core/echo/echo/src/Ref.ts
237
- var Ref_exports = {};
238
- __export(Ref_exports, {
239
- fromDXN: () => fromDXN,
240
- isRef: () => isRef,
241
- make: () => make3
211
+ // packages/core/echo/echo/src/Type.ts
212
+ var Type_exports = {};
213
+ __export(Type_exports, {
214
+ DXN: () => DXN2,
215
+ Expando: () => Expando,
216
+ Format: () => Format,
217
+ JsonSchema: () => JsonSchemaType,
218
+ Kind: () => EntityKind3,
219
+ Obj: () => Obj,
220
+ ObjectId: () => ObjectId2,
221
+ Ref: () => Ref3,
222
+ Relation: () => Relation,
223
+ SpaceId: () => SpaceId2,
224
+ getDXN: () => getDXN2,
225
+ getMeta: () => getMeta3,
226
+ getTypename: () => getTypename2,
227
+ getVersion: () => getVersion,
228
+ isMutable: () => isMutable2,
229
+ toEffectSchema: () => toEffectSchema,
230
+ toJsonSchema: () => toJsonSchema
242
231
  });
243
232
  import * as EchoSchema4 from "@dxos/echo-schema";
244
- var make3 = EchoSchema4.Ref.make;
245
- var isRef = EchoSchema4.Ref.isRef;
246
- var fromDXN = EchoSchema4.Ref.fromDXN;
233
+ import { invariant as invariant3 } from "@dxos/invariant";
234
+ import { EntityKind as EntityKind3 } from "@dxos/echo-schema";
235
+ import { SpaceId as SpaceId2, ObjectId as ObjectId2, DXN as DXN2 } from "@dxos/keys";
236
+ import {
237
+ Expando,
238
+ Format,
239
+ JsonSchemaType,
240
+ toEffectSchema,
241
+ toJsonSchema
242
+ } from "@dxos/echo-schema";
243
+ var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/core/echo/echo/src/Type.ts";
244
+ var Obj = EchoSchema4.EchoObject;
245
+ var Relation = EchoSchema4.EchoRelation;
246
+ var Ref3 = EchoSchema4.Ref;
247
+ var getDXN2 = (schema) => {
248
+ return EchoSchema4.getSchemaDXN(schema);
249
+ };
250
+ var getTypename2 = (schema) => {
251
+ const typename = EchoSchema4.getSchemaTypename(schema);
252
+ invariant3(typeof typename === "string" && !typename.startsWith("dxn:"), "Invalid typename", {
253
+ F: __dxlog_file3,
254
+ L: 89,
255
+ S: void 0,
256
+ A: [
257
+ "typeof typename === 'string' && !typename.startsWith('dxn:')",
258
+ "'Invalid typename'"
259
+ ]
260
+ });
261
+ return typename;
262
+ };
263
+ var getVersion = (schema) => {
264
+ const version = EchoSchema4.getSchemaVersion(schema);
265
+ invariant3(typeof version === "string" && version.match(/^\d+\.\d+\.\d+$/), "Invalid version", {
266
+ F: __dxlog_file3,
267
+ L: 99,
268
+ S: void 0,
269
+ A: [
270
+ "typeof version === 'string' && version.match(/^\\d+\\.\\d+\\.\\d+$/)",
271
+ "'Invalid version'"
272
+ ]
273
+ });
274
+ return version;
275
+ };
276
+ var getMeta3 = (schema) => {
277
+ return EchoSchema4.getTypeAnnotation(schema);
278
+ };
279
+ var isMutable2 = EchoSchema4.isMutable;
247
280
 
248
281
  // packages/core/echo/echo/src/index.ts
282
+ import { DXN as DXN3 } from "@dxos/keys";
249
283
  import { Filter, Query } from "@dxos/echo-schema";
250
284
  export {
285
+ DXN3 as DXN,
251
286
  Filter,
287
+ Key_exports as Key,
252
288
  Obj_exports as Obj,
253
289
  Query,
254
290
  Ref_exports as Ref,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
- "sources": ["../../../src/Type.ts", "../../../src/Obj.ts", "../../../src/Relation.ts", "../../../src/Ref.ts", "../../../src/index.ts"],
4
- "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Schema } from 'effect';\n\nimport type { EncodedReference } from '@dxos/echo-protocol';\nimport * as EchoSchema from '@dxos/echo-schema';\nimport { invariant } from '@dxos/invariant';\nimport type * as Keys from '@dxos/keys';\n\n/**\n * ECHO schema.\n */\nexport type Schema = EchoSchema.EchoSchema;\n\n/**\n * EchoObject schema.\n */\nexport const Obj = EchoSchema.EchoObject;\n\n/**\n * EchoRelation schema.\n */\nexport const Relation = EchoSchema.EchoRelation;\n\n/**\n * Ref schema.\n */\nexport const Ref: <S extends Obj.Any>(schema: S) => EchoSchema.Ref$<Schema.Schema.Type<S>> = EchoSchema.Ref;\n\nexport namespace Obj {\n /**\n * Type that represents an arbitrary schema type of an object.\n * NOTE: This is not an instance type.\n */\n // TODO(dmaretskyi): If schema was covariant, we could specify props in here, like `id: ObjectId`.\n export type Any = Schema.Schema.AnyNoContext;\n}\n\nexport namespace Relation {\n /**\n * Type that represents an arbitrary schema type of a relation.\n * NOTE: This is not an instance type.\n */\n // TODO(dmaretskyi): If schema was covariant, we could specify props in here, like `id: ObjectId`.\n export type Any = Schema.Schema.AnyNoContext;\n\n /**\n * Get relation target type.\n */\n export type Target<A> = A extends EchoSchema.RelationSourceTargetRefs<infer T, infer _S> ? T : never;\n\n /**\n * Get relation source type.\n */\n export type Source<A> = A extends EchoSchema.RelationSourceTargetRefs<infer _T, infer S> ? S : never;\n}\n\nexport namespace Ref {\n /**\n * Type that represents an arbitrary schema type of a reference.\n * NOTE: This is not an instance type.\n */\n export type Any = Schema.Schema<EchoSchema.Ref<any>, EncodedReference>;\n}\n\n/**\n * Gets the full DXN of the schema.\n * Will include the version if it's a `type` DXN.\n * @example \"dxn:example.com/type/Person:0.1.0\"\n * @example \"dxn:echo:SSSSSSSSSS:XXXXXXXXXXXXX\"\n */\nexport const getDXN = (schema: Obj.Any | Relation.Any): Keys.DXN | undefined => {\n return EchoSchema.getSchemaDXN(schema);\n};\n\n/**\n * @param schema - Schema to get the typename from.\n * @returns The typename of the schema. Example: `example.com/type/Person`.\n */\nexport const getTypename = (schema: Obj.Any | Relation.Any): string => {\n const typename = EchoSchema.getSchemaTypename(schema);\n invariant(typeof typename === 'string' && !typename.startsWith('dxn:'), 'Invalid typename');\n return typename;\n};\n\n/**\n * Gets the version of the schema.\n * @example 0.1.0\n */\nexport const getVersion = (schema: Obj.Any | Relation.Any): string => {\n const version = EchoSchema.getSchemaVersion(schema);\n invariant(typeof version === 'string' && version.match(/^\\d+\\.\\d+\\.\\d+$/), 'Invalid version');\n return version;\n};\n\n/**\n * ECHO type metadata.\n */\nexport type Meta = EchoSchema.TypeAnnotation;\n\n/**\n * Gets the meta data of the schema.\n */\nexport const getMeta = (schema: Obj.Any | Relation.Any): Meta | undefined => {\n return EchoSchema.getTypeAnnotation(schema);\n};\n\nexport { EntityKind as Kind } from '@dxos/echo-schema';\n\n/**\n * @returns True if the schema is mutable.\n */\nexport const isMutable = (schema: Obj.Any | Relation.Any): boolean => {\n return EchoSchema.isMutable(schema);\n};\n\nexport { SpaceId, ObjectId, DXN } from '@dxos/keys';\n\nexport {\n //\n Expando,\n JsonSchemaType as JsonSchema,\n toJsonSchema,\n Format,\n} from '@dxos/echo-schema';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Schema } from 'effect';\n\nimport * as EchoSchema from '@dxos/echo-schema';\nimport { assertArgument, invariant } from '@dxos/invariant';\nimport type { DXN } from '@dxos/keys';\nimport * as LiveObject from '@dxos/live-object';\n\nimport type * as Type from './Type';\n\nexport type Any = EchoSchema.AnyEchoObject;\n\nexport const make = LiveObject.live;\n\n// TODO(dmaretskyi): Currently broken\nexport const isObject = (obj: unknown): obj is Any => {\n return LiveObject.isLiveObject(obj);\n};\n\n/**\n * Check that object or relation is an instance of a schema.\n * @example\n * ```ts\n * const person = Obj.make(Person, { name: 'John' });\n * const isPerson = Obj.instanceOf(Person);\n * isPerson(person); // true\n * ```\n */\nexport const instanceOf: {\n <S extends Type.Relation.Any | Type.Obj.Any>(schema: S): (value: unknown) => value is S;\n <S extends Type.Relation.Any | Type.Obj.Any>(schema: S, value: unknown): value is S;\n} = ((...args: any[]) => {\n if (args.length === 1) {\n return (obj: unknown) => EchoSchema.isInstanceOf(args[0], obj);\n }\n\n return EchoSchema.isInstanceOf(args[0], args[1]);\n}) as any;\n\nexport const getSchema = EchoSchema.getSchema;\n\nexport const getDXN = (obj: Any): DXN => {\n assertArgument(!Schema.isSchema(obj), 'Object should not be a schema.');\n const dxn = EchoSchema.getDXN(obj);\n invariant(dxn != null, 'Invalid object.');\n return dxn;\n};\n\n/**\n * @returns The DXN of the object's type.\n * @example dxn:example.com/type/Contact:1.0.0\n */\nexport const getSchemaDXN = (obj: Any): DXN => {\n const type = EchoSchema.getType(obj);\n invariant(type != null, 'Invalid object.');\n return type;\n};\n\n/**\n * @returns The typename of the object's type.\n * @example `example.com/type/Contact`\n */\nexport const getTypename = (obj: Any): string | undefined => {\n const schema = getSchema(obj);\n if (schema == null) {\n // Try to extract typename from DXN.\n return getSchemaDXN(obj)?.asTypeDXN()?.type;\n }\n\n return EchoSchema.getTypename(schema);\n};\n\nexport const getMeta = (obj: Any): EchoSchema.ObjectMeta => {\n const meta = EchoSchema.getMeta(obj);\n invariant(meta != null, 'Invalid object.');\n return meta;\n};\n\nexport const isDeleted = (obj: Any): boolean => {\n const deleted = EchoSchema.isDeleted(obj);\n invariant(typeof deleted === 'boolean', 'Invalid object.');\n return deleted;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as EchoSchema from '@dxos/echo-schema';\nimport { invariant } from '@dxos/invariant';\nimport * as LiveObject from '@dxos/live-object';\n\nexport type Any = EchoSchema.AnyEchoObject & EchoSchema.RelationSourceTargetRefs;\n\nexport const make = LiveObject.live;\n\nexport const isRelation = (value: unknown): value is Any => {\n if (typeof value !== 'object' || value === null) {\n return false;\n }\n if (EchoSchema.ATTR_RELATION_SOURCE in value || EchoSchema.ATTR_RELATION_TARGET in value) {\n return true;\n }\n\n const kind = (value as any)[EchoSchema.EntityKindPropertyId];\n return kind === EchoSchema.EntityKind.Relation;\n};\n\n/**\n * @returns Relation source.\n * @throws If the object is not a relation.\n */\nexport const getSource = <T extends Any>(relation: T): EchoSchema.RelationSource<T> => {\n invariant(isRelation(relation));\n const obj = relation[EchoSchema.RelationSourceId];\n invariant(obj !== undefined, `Invalid source: ${relation.id}`);\n return obj;\n};\n\n/**\n * @returns Relation target.\n * @throws If the object is not a relation.\n */\nexport const getTarget = <T extends Any>(relation: T): EchoSchema.RelationTarget<T> => {\n invariant(isRelation(relation));\n const obj = relation[EchoSchema.RelationTargetId];\n invariant(obj !== undefined, `Invalid target: ${relation.id}`);\n return obj;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as EchoSchema from '@dxos/echo-schema';\n\nimport type * as Obj from './Obj';\n\nexport type Any = EchoSchema.Ref<Obj.Any>;\n\nexport const make = EchoSchema.Ref.make;\n\nexport const isRef: (value: unknown) => value is Any = EchoSchema.Ref.isRef;\n\n// TODO(dmaretskyi): Consider just allowing `make` to accept DXN.\nexport const fromDXN = EchoSchema.Ref.fromDXN;\n\n/**\n * Extract reference target.\n */\nexport type Target<R extends Any> = R extends EchoSchema.Ref<infer T> ? T : never;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nexport * as Type from './Type';\nexport * as Obj from './Obj';\nexport * as Relation from './Relation';\nexport * as Ref from './Ref';\n\nexport { type Live } from '@dxos/live-object';\nexport { Filter, Query } from '@dxos/echo-schema';\n"],
5
- "mappings": "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",
6
- "names": ["Ref", "isMutable", "EchoSchema", "invariant", "Kind", "SpaceId", "ObjectId", "DXN", "Expando", "JsonSchema", "toJsonSchema", "Format", "Obj", "EchoObject", "Relation", "EchoRelation", "getDXN", "schema", "getSchemaDXN", "getTypename", "typename", "getSchemaTypename", "startsWith", "getVersion", "version", "getSchemaVersion", "match", "getMeta", "getTypeAnnotation", "getDXN", "getMeta", "getSchema", "getSchemaDXN", "getTypename", "isDeleted", "Schema", "EchoSchema", "assertArgument", "invariant", "LiveObject", "make", "live", "isObject", "obj", "isLiveObject", "instanceOf", "args", "length", "isInstanceOf", "isSchema", "dxn", "type", "getType", "schema", "asTypeDXN", "meta", "deleted", "make", "EchoSchema", "invariant", "LiveObject", "live", "isRelation", "value", "ATTR_RELATION_SOURCE", "ATTR_RELATION_TARGET", "kind", "EntityKindPropertyId", "EntityKind", "Relation", "getSource", "relation", "obj", "RelationSourceId", "undefined", "id", "getTarget", "RelationTargetId", "make", "EchoSchema", "make", "Ref", "isRef", "fromDXN", "Filter", "Query"]
3
+ "sources": ["../../../src/Key.ts", "../../../src/Obj.ts", "../../../src/Ref.ts", "../../../src/Relation.ts", "../../../src/Type.ts", "../../../src/index.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nexport { SpaceId, ObjectId } from '@dxos/keys';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Schema } from 'effect';\n\nimport * as EchoSchema from '@dxos/echo-schema';\nimport { assertArgument, invariant } from '@dxos/invariant';\nimport { type DXN } from '@dxos/keys';\nimport * as LiveObject from '@dxos/live-object';\nimport { assumeType } from '@dxos/util';\n\nimport type * as Ref from './Ref';\nimport type * as Type from './Type';\n\nexport type Obj<T = any> = EchoSchema.AnyEchoObject & T;\nexport type Any = EchoSchema.AnyEchoObject;\n\nexport const make = LiveObject.live;\n\nexport const isObject = (obj: unknown): obj is Any => {\n assumeType<EchoSchema.InternalObjectProps>(obj);\n return typeof obj === 'object' && obj !== null && obj[EchoSchema.EntityKindId] === EchoSchema.EntityKind.Object;\n};\n\n/**\n * Test if object or relation is an instance of a schema.\n * @example\n * ```ts\n * const john = Obj.make(Person, { name: 'John' });\n * const johnIsPerson = Obj.instanceOf(Person)(john);\n *\n * const isPerson = Obj.instanceOf(Person);\n * if(isPerson(john)) {\n * // john is Person\n * }\n * ```\n */\nexport const instanceOf: {\n <S extends Type.Relation.Any | Type.Obj.Any>(schema: S): (value: unknown) => value is Schema.Schema.Type<S>;\n <S extends Type.Relation.Any | Type.Obj.Any>(schema: S, value: unknown): value is Schema.Schema.Type<S>;\n} = ((\n ...args: [schema: Type.Relation.Any | Type.Obj.Any, value: unknown] | [schema: Type.Relation.Any | Type.Obj.Any]\n) => {\n if (args.length === 1) {\n return (obj: unknown) => EchoSchema.isInstanceOf(args[0], obj);\n }\n\n return EchoSchema.isInstanceOf(args[0], args[1]);\n}) as any;\n\nexport const getSchema = EchoSchema.getSchema;\n\n// TODO(dmaretskyi): Allow returning undefined.\nexport const getDXN = (obj: Any): DXN => {\n assertArgument(!Schema.isSchema(obj), 'Object should not be a schema.');\n const dxn = EchoSchema.getObjectDXN(obj);\n invariant(dxn != null, 'Invalid object.');\n return dxn;\n};\n\n/**\n * @returns The DXN of the object's type.\n * @example dxn:example.com/type/Contact:1.0.0\n */\n// TODO(burdon): Expando does not have a type.\nexport const getTypeDXN = EchoSchema.getType;\n\n/**\n * @returns The typename of the object's type.\n * @example `example.com/type/Contact`\n */\nexport const getTypename = (obj: Any): string | undefined => {\n const schema = getSchema(obj);\n if (schema == null) {\n // Try to extract typename from DXN.\n return EchoSchema.getType(obj)?.asTypeDXN()?.type;\n }\n\n return EchoSchema.getSchemaTypename(schema);\n};\n\n// TODO(dmaretskyi): Allow returning undefined.\nexport const getMeta = (obj: Any): EchoSchema.ObjectMeta => {\n const meta = EchoSchema.getMeta(obj);\n invariant(meta != null, 'Invalid object.');\n return meta;\n};\n\n// TODO(dmaretskyi): Default to `false`.\nexport const isDeleted = (obj: Any): boolean => {\n const deleted = EchoSchema.isDeleted(obj);\n invariant(typeof deleted === 'boolean', 'Invalid object.');\n return deleted;\n};\n\nexport const getLabel = (obj: Any): string | undefined => {\n const schema = getSchema(obj);\n if (schema != null) {\n return EchoSchema.getLabel(schema, obj);\n }\n};\n\n/**\n * JSON representation of an object.\n */\nexport type JSON = EchoSchema.ObjectJSON;\n\n/**\n * Converts object to its JSON representation.\n *\n * The same algorithm is used when calling the standard `JSON.stringify(obj)` function.\n */\nexport const toJSON = (obj: Any): JSON => EchoSchema.objectToJSON(obj);\n\n/**\n * Creates an object from its json representation, performing schema validation.\n * References and schemas will be resolvable if the `refResolver` is provided.\n *\n * The function need to be async to support resolving the schema as well as the relation endpoints.\n */\nexport const fromJSON: (json: unknown, options?: { refResolver?: Ref.Resolver }) => Promise<Any> =\n EchoSchema.objectFromJSON;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as EchoSchema from '@dxos/echo-schema';\n\nimport type * as Obj from './Obj';\n\nexport type Ref<T extends Obj.Any> = EchoSchema.Ref<T>;\nexport type Any = EchoSchema.Ref<Obj.Any>;\n\nexport const Array = EchoSchema.RefArray;\n\n/**\n * Extract reference target.\n */\nexport type Target<R extends Any> = R extends EchoSchema.Ref<infer T> ? T : never;\n\n/**\n * Reference resolver.\n */\nexport type Resolver = EchoSchema.RefResolver;\n\nexport const isRef: (value: unknown) => value is Any = EchoSchema.Ref.isRef;\n\nexport const make = EchoSchema.Ref.make;\n\n// TODO(dmaretskyi): Consider just allowing `make` to accept DXN.\nexport const fromDXN = EchoSchema.Ref.fromDXN;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as EchoSchema from '@dxos/echo-schema';\nimport { assertArgument, invariant } from '@dxos/invariant';\nimport { DXN } from '@dxos/keys';\nimport * as LiveObject from '@dxos/live-object';\nimport { assumeType } from '@dxos/util';\n\nexport type Any = EchoSchema.AnyEchoObject & EchoSchema.RelationSourceTargetRefs;\n\nexport const Source = EchoSchema.RelationSourceId;\nexport const Target = EchoSchema.RelationTargetId;\n\nexport const make = LiveObject.live;\n\nexport const isRelation = (value: unknown): value is Any => {\n if (typeof value !== 'object' || value === null) {\n return false;\n }\n if (EchoSchema.ATTR_RELATION_SOURCE in value || EchoSchema.ATTR_RELATION_TARGET in value) {\n return true;\n }\n\n const kind = (value as any)[EchoSchema.EntityKindId];\n return kind === EchoSchema.EntityKind.Relation;\n};\n\n/**\n * @returns Relation source DXN.\n * @throws If the object is not a relation.\n */\nexport const getSourceDXN = (value: Any): DXN => {\n assertArgument(isRelation(value), 'Expected a relation');\n assumeType<EchoSchema.InternalObjectProps>(value);\n const dxn = value[EchoSchema.RelationSourceDXNId];\n invariant(dxn instanceof DXN);\n return dxn;\n};\n\n/**\n * @returns Relation target DXN.\n * @throws If the object is not a relation.\n */\nexport const getTargetDXN = (value: Any): DXN => {\n assertArgument(isRelation(value), 'Expected a relation');\n assumeType<EchoSchema.InternalObjectProps>(value);\n const dxn = value[EchoSchema.RelationTargetDXNId];\n invariant(dxn instanceof DXN);\n return dxn;\n};\n\n/**\n * @returns Relation source.\n * @throws If the object is not a relation.\n */\nexport const getSource = <T extends Any>(relation: T): EchoSchema.RelationSource<T> => {\n assertArgument(isRelation(relation), 'Expected a relation');\n const obj = relation[EchoSchema.RelationSourceId];\n invariant(obj !== undefined, `Invalid source: ${relation.id}`);\n return obj;\n};\n\n/**\n * @returns Relation target.\n * @throws If the object is not a relation.\n */\nexport const getTarget = <T extends Any>(relation: T): EchoSchema.RelationTarget<T> => {\n assertArgument(isRelation(relation), 'Expected a relation');\n const obj = relation[EchoSchema.RelationTargetId];\n invariant(obj !== undefined, `Invalid target: ${relation.id}`);\n return obj;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Schema } from 'effect';\n\nimport type { EncodedReference } from '@dxos/echo-protocol';\nimport * as EchoSchema from '@dxos/echo-schema';\nimport { invariant } from '@dxos/invariant';\nimport type * as Keys from '@dxos/keys';\n\n/**\n * ECHO schema.\n */\nexport type Schema = EchoSchema.EchoSchema;\n\n/**\n * EchoObject schema.\n */\nexport const Obj = EchoSchema.EchoObject;\n\n// TODO(buurdon): Move to Obj?\nexport namespace Obj {\n /**\n * Type that represents an arbitrary schema type of an object.\n * NOTE: This is not an instance type.\n */\n // TODO(dmaretskyi): If schema was covariant, we could specify props in here, like `id: ObjectId`.\n export type Any = Schema.Schema.AnyNoContext;\n}\n\n/**\n * EchoRelation schema.\n */\nexport const Relation = EchoSchema.EchoRelation;\n\n// TODO(buurdon): Move to Relation?\nexport namespace Relation {\n /**\n * Type that represents an arbitrary schema type of a relation.\n * NOTE: This is not an instance type.\n */\n // TODO(dmaretskyi): If schema was covariant, we could specify props in here, like `id: ObjectId`.\n export type Any = Schema.Schema.AnyNoContext;\n\n /**\n * Get relation target type.\n */\n export type Target<A> = A extends EchoSchema.RelationSourceTargetRefs<infer T, infer _S> ? T : never;\n\n /**\n * Get relation source type.\n */\n export type Source<A> = A extends EchoSchema.RelationSourceTargetRefs<infer _T, infer S> ? S : never;\n}\n\n/**\n * Ref schema.\n */\nexport const Ref: <S extends Obj.Any>(schema: S) => EchoSchema.Ref$<Schema.Schema.Type<S>> = EchoSchema.Ref;\n\nexport interface Ref<T> extends Schema.SchemaClass<EchoSchema.Ref<T>, EncodedReference> {}\n\n// TODO(buurdon): Move to Ref?\nexport namespace Ref {\n /**\n * Type that represents an arbitrary schema type of a reference.\n * NOTE: This is not an instance type.\n */\n export type Any = Schema.Schema<EchoSchema.Ref<any>, EncodedReference>;\n}\n\n/**\n * Gets the full DXN of the schema.\n * Will include the version if it's a `type` DXN.\n * @example \"dxn:example.com/type/Person:0.1.0\"\n * @example \"dxn:echo:SSSSSSSSSS:XXXXXXXXXXXXX\"\n */\nexport const getDXN = (schema: Obj.Any | Relation.Any): Keys.DXN | undefined => {\n return EchoSchema.getSchemaDXN(schema);\n};\n\n/**\n * @param schema - Schema to get the typename from.\n * @returns The typename of the schema. Example: `example.com/type/Person`.\n */\nexport const getTypename = (schema: Obj.Any | Relation.Any): string => {\n const typename = EchoSchema.getSchemaTypename(schema);\n invariant(typeof typename === 'string' && !typename.startsWith('dxn:'), 'Invalid typename');\n return typename;\n};\n\n/**\n * Gets the version of the schema.\n * @example 0.1.0\n */\nexport const getVersion = (schema: Obj.Any | Relation.Any): string => {\n const version = EchoSchema.getSchemaVersion(schema);\n invariant(typeof version === 'string' && version.match(/^\\d+\\.\\d+\\.\\d+$/), 'Invalid version');\n return version;\n};\n\n/**\n * ECHO type metadata.\n */\nexport type Meta = EchoSchema.TypeAnnotation;\n\n/**\n * Gets the meta data of the schema.\n */\nexport const getMeta = (schema: Obj.Any | Relation.Any): Meta | undefined => {\n return EchoSchema.getTypeAnnotation(schema);\n};\n\nexport { EntityKind as Kind } from '@dxos/echo-schema';\n\n/**\n * @returns True if the schema is mutable.\n */\nexport const isMutable = EchoSchema.isMutable;\n\nexport { SpaceId, ObjectId, DXN } from '@dxos/keys';\n\nexport {\n //\n Expando,\n // TODO(burdon): Standardize.\n Format,\n JsonSchemaType as JsonSchema,\n toEffectSchema,\n toJsonSchema,\n} from '@dxos/echo-schema';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nexport * as Key from './Key';\nexport * as Obj from './Obj';\nexport * as Ref from './Ref';\nexport * as Relation from './Relation';\nexport * as Type from './Type';\n\nexport { DXN } from '@dxos/keys';\nexport { Filter, Query } from '@dxos/echo-schema';\nexport { type Live } from '@dxos/live-object';\n"],
5
+ "mappings": "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",
6
+ "names": ["SpaceId", "ObjectId", "getLabel", "getMeta", "getSchema", "isDeleted", "Schema", "EchoSchema", "assertArgument", "invariant", "LiveObject", "assumeType", "make", "live", "isObject", "obj", "EntityKindId", "EntityKind", "Object", "instanceOf", "args", "length", "isInstanceOf", "getDXN", "isSchema", "dxn", "getObjectDXN", "getTypeDXN", "getType", "getTypename", "schema", "asTypeDXN", "type", "getSchemaTypename", "meta", "deleted", "toJSON", "objectToJSON", "fromJSON", "objectFromJSON", "make", "EchoSchema", "Array", "RefArray", "isRef", "Ref", "make", "fromDXN", "make", "EchoSchema", "assertArgument", "invariant", "DXN", "LiveObject", "assumeType", "Source", "RelationSourceId", "Target", "RelationTargetId", "live", "isRelation", "value", "ATTR_RELATION_SOURCE", "ATTR_RELATION_TARGET", "kind", "EntityKindId", "EntityKind", "Relation", "getSourceDXN", "dxn", "RelationSourceDXNId", "getTargetDXN", "RelationTargetDXNId", "getSource", "relation", "obj", "undefined", "id", "getTarget", "DXN", "EntityKind", "ObjectId", "Ref", "SpaceId", "getDXN", "getMeta", "getTypename", "isMutable", "EchoSchema", "invariant", "Kind", "Expando", "Format", "JsonSchema", "toEffectSchema", "toJsonSchema", "Obj", "EchoObject", "Relation", "EchoRelation", "schema", "getSchemaDXN", "typename", "getSchemaTypename", "startsWith", "getVersion", "version", "getSchemaVersion", "match", "getTypeAnnotation", "DXN", "Filter", "Query"]
7
7
  }