@dxos/echo 0.8.4-main.406dc2a → 0.8.4-main.59c2e9b

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.
Files changed (600) hide show
  1. package/README.md +1 -2
  2. package/dist/lib/browser/Annotation.mjs +33 -0
  3. package/dist/lib/browser/Database.mjs +18 -0
  4. package/dist/lib/browser/Entity.mjs +52 -0
  5. package/dist/lib/browser/Entity.mjs.map +7 -0
  6. package/dist/lib/browser/Err.mjs +11 -0
  7. package/dist/lib/browser/Err.mjs.map +7 -0
  8. package/dist/lib/browser/Filter.mjs +62 -0
  9. package/dist/lib/browser/Filter.mjs.map +7 -0
  10. package/dist/lib/browser/Format.mjs +67 -0
  11. package/dist/lib/browser/Format.mjs.map +7 -0
  12. package/dist/lib/browser/JsonSchema.mjs +20 -0
  13. package/dist/lib/browser/JsonSchema.mjs.map +7 -0
  14. package/dist/lib/browser/Key.mjs +13 -0
  15. package/dist/lib/browser/Key.mjs.map +7 -0
  16. package/dist/lib/browser/Obj.mjs +91 -0
  17. package/dist/lib/browser/Obj.mjs.map +7 -0
  18. package/dist/lib/browser/Order.mjs +13 -0
  19. package/dist/lib/browser/Order.mjs.map +7 -0
  20. package/dist/lib/browser/Query.mjs +27 -0
  21. package/dist/lib/browser/Query.mjs.map +7 -0
  22. package/dist/lib/browser/QueryResult.mjs +3 -0
  23. package/dist/lib/browser/QueryResult.mjs.map +7 -0
  24. package/dist/lib/browser/Ref.mjs +23 -0
  25. package/dist/lib/browser/Ref.mjs.map +7 -0
  26. package/dist/lib/browser/Relation.mjs +85 -0
  27. package/dist/lib/browser/Relation.mjs.map +7 -0
  28. package/dist/lib/browser/SchemaRegistry.mjs +3 -0
  29. package/dist/lib/browser/SchemaRegistry.mjs.map +7 -0
  30. package/dist/lib/browser/Tag.mjs +26 -0
  31. package/dist/lib/browser/Tag.mjs.map +7 -0
  32. package/dist/lib/browser/Type.mjs +48 -0
  33. package/dist/lib/browser/Type.mjs.map +7 -0
  34. package/dist/lib/browser/chunk-22JMFST2.mjs +24 -0
  35. package/dist/lib/browser/chunk-22JMFST2.mjs.map +7 -0
  36. package/dist/lib/browser/chunk-2SBB7OWV.mjs +250 -0
  37. package/dist/lib/browser/chunk-2SBB7OWV.mjs.map +7 -0
  38. package/dist/lib/browser/chunk-6L5HHUVU.mjs +158 -0
  39. package/dist/lib/browser/chunk-6L5HHUVU.mjs.map +7 -0
  40. package/dist/lib/browser/chunk-7STIBCP7.mjs +133 -0
  41. package/dist/lib/browser/chunk-7STIBCP7.mjs.map +7 -0
  42. package/dist/lib/browser/chunk-BJPE6CIC.mjs +3847 -0
  43. package/dist/lib/browser/chunk-BJPE6CIC.mjs.map +7 -0
  44. package/dist/lib/browser/chunk-CGS2ULMK.mjs +11 -0
  45. package/dist/lib/browser/chunk-CGS2ULMK.mjs.map +7 -0
  46. package/dist/lib/browser/chunk-CJ5YELTO.mjs +39 -0
  47. package/dist/lib/browser/chunk-CJ5YELTO.mjs.map +7 -0
  48. package/dist/lib/browser/chunk-FPOISFQK.mjs +40 -0
  49. package/dist/lib/browser/chunk-FPOISFQK.mjs.map +7 -0
  50. package/dist/lib/browser/chunk-FRDT7RA4.mjs +403 -0
  51. package/dist/lib/browser/chunk-FRDT7RA4.mjs.map +7 -0
  52. package/dist/lib/browser/chunk-INHXFXY5.mjs +22 -0
  53. package/dist/lib/browser/chunk-INHXFXY5.mjs.map +7 -0
  54. package/dist/lib/browser/chunk-IXVWLTG7.mjs +9 -0
  55. package/dist/lib/browser/chunk-IXVWLTG7.mjs.map +7 -0
  56. package/dist/lib/browser/chunk-JMKVF2YQ.mjs +43 -0
  57. package/dist/lib/browser/chunk-JMKVF2YQ.mjs.map +7 -0
  58. package/dist/lib/browser/chunk-KQQGVHFN.mjs +143 -0
  59. package/dist/lib/browser/chunk-KQQGVHFN.mjs.map +7 -0
  60. package/dist/lib/browser/chunk-MYCCGG2T.mjs +15 -0
  61. package/dist/lib/browser/chunk-MYCCGG2T.mjs.map +7 -0
  62. package/dist/lib/browser/chunk-NOPVNWPT.mjs +204 -0
  63. package/dist/lib/browser/chunk-NOPVNWPT.mjs.map +7 -0
  64. package/dist/lib/browser/chunk-PQZW3S6L.mjs +74 -0
  65. package/dist/lib/browser/chunk-PQZW3S6L.mjs.map +7 -0
  66. package/dist/lib/browser/chunk-RK4Z4JUZ.mjs +283 -0
  67. package/dist/lib/browser/chunk-RK4Z4JUZ.mjs.map +7 -0
  68. package/dist/lib/browser/chunk-U2J7TA7K.mjs +57 -0
  69. package/dist/lib/browser/chunk-U2J7TA7K.mjs.map +7 -0
  70. package/dist/lib/browser/chunk-W5D2GWAW.mjs +98 -0
  71. package/dist/lib/browser/chunk-W5D2GWAW.mjs.map +7 -0
  72. package/dist/lib/browser/chunk-XDIUHAAX.mjs +41 -0
  73. package/dist/lib/browser/chunk-XDIUHAAX.mjs.map +7 -0
  74. package/dist/lib/browser/chunk-YKTSSMDS.mjs +69 -0
  75. package/dist/lib/browser/chunk-YKTSSMDS.mjs.map +7 -0
  76. package/dist/lib/browser/chunk-ZAGAOZVY.mjs +288 -0
  77. package/dist/lib/browser/chunk-ZAGAOZVY.mjs.map +7 -0
  78. package/dist/lib/browser/chunk-ZHXZGIXD.mjs +9 -0
  79. package/dist/lib/browser/chunk-ZHXZGIXD.mjs.map +7 -0
  80. package/dist/lib/browser/index.mjs +72 -22
  81. package/dist/lib/browser/internal/index.mjs +245 -120
  82. package/dist/lib/browser/meta.json +1 -1
  83. package/dist/lib/browser/testing/index.mjs +295 -226
  84. package/dist/lib/browser/testing/index.mjs.map +4 -4
  85. package/dist/lib/node-esm/Annotation.mjs +33 -0
  86. package/dist/lib/node-esm/Annotation.mjs.map +7 -0
  87. package/dist/lib/node-esm/Database.mjs +18 -0
  88. package/dist/lib/node-esm/Database.mjs.map +7 -0
  89. package/dist/lib/node-esm/Entity.mjs +52 -0
  90. package/dist/lib/node-esm/Entity.mjs.map +7 -0
  91. package/dist/lib/node-esm/Err.mjs +11 -0
  92. package/dist/lib/node-esm/Err.mjs.map +7 -0
  93. package/dist/lib/node-esm/Filter.mjs +62 -0
  94. package/dist/lib/node-esm/Filter.mjs.map +7 -0
  95. package/dist/lib/node-esm/Format.mjs +67 -0
  96. package/dist/lib/node-esm/Format.mjs.map +7 -0
  97. package/dist/lib/node-esm/JsonSchema.mjs +20 -0
  98. package/dist/lib/node-esm/JsonSchema.mjs.map +7 -0
  99. package/dist/lib/node-esm/Key.mjs +13 -0
  100. package/dist/lib/node-esm/Key.mjs.map +7 -0
  101. package/dist/lib/node-esm/Obj.mjs +91 -0
  102. package/dist/lib/node-esm/Obj.mjs.map +7 -0
  103. package/dist/lib/node-esm/Order.mjs +13 -0
  104. package/dist/lib/node-esm/Order.mjs.map +7 -0
  105. package/dist/lib/node-esm/Query.mjs +27 -0
  106. package/dist/lib/node-esm/Query.mjs.map +7 -0
  107. package/dist/lib/node-esm/QueryResult.mjs +3 -0
  108. package/dist/lib/node-esm/QueryResult.mjs.map +7 -0
  109. package/dist/lib/node-esm/Ref.mjs +23 -0
  110. package/dist/lib/node-esm/Ref.mjs.map +7 -0
  111. package/dist/lib/node-esm/Relation.mjs +85 -0
  112. package/dist/lib/node-esm/Relation.mjs.map +7 -0
  113. package/dist/lib/node-esm/SchemaRegistry.mjs +3 -0
  114. package/dist/lib/node-esm/SchemaRegistry.mjs.map +7 -0
  115. package/dist/lib/node-esm/Tag.mjs +26 -0
  116. package/dist/lib/node-esm/Tag.mjs.map +7 -0
  117. package/dist/lib/node-esm/Type.mjs +48 -0
  118. package/dist/lib/node-esm/Type.mjs.map +7 -0
  119. package/dist/lib/node-esm/chunk-4PNXQA64.mjs +250 -0
  120. package/dist/lib/node-esm/chunk-4PNXQA64.mjs.map +7 -0
  121. package/dist/lib/node-esm/chunk-5OBN7GZW.mjs +158 -0
  122. package/dist/lib/node-esm/chunk-5OBN7GZW.mjs.map +7 -0
  123. package/dist/lib/node-esm/chunk-AJEMYSIR.mjs +22 -0
  124. package/dist/lib/node-esm/chunk-AJEMYSIR.mjs.map +7 -0
  125. package/dist/lib/node-esm/chunk-ANLVLWME.mjs +98 -0
  126. package/dist/lib/node-esm/chunk-ANLVLWME.mjs.map +7 -0
  127. package/dist/lib/node-esm/chunk-DMR7OAFK.mjs +57 -0
  128. package/dist/lib/node-esm/chunk-DMR7OAFK.mjs.map +7 -0
  129. package/dist/lib/node-esm/chunk-FWTSPIFF.mjs +133 -0
  130. package/dist/lib/node-esm/chunk-FWTSPIFF.mjs.map +7 -0
  131. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs +11 -0
  132. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs.map +7 -0
  133. package/dist/lib/node-esm/chunk-ILMLLM4R.mjs +204 -0
  134. package/dist/lib/node-esm/chunk-ILMLLM4R.mjs.map +7 -0
  135. package/dist/lib/node-esm/chunk-K37NA7PO.mjs +43 -0
  136. package/dist/lib/node-esm/chunk-K37NA7PO.mjs.map +7 -0
  137. package/dist/lib/node-esm/chunk-LT3H4JOX.mjs +3847 -0
  138. package/dist/lib/node-esm/chunk-LT3H4JOX.mjs.map +7 -0
  139. package/dist/lib/node-esm/chunk-MOLNWFNL.mjs +9 -0
  140. package/dist/lib/node-esm/chunk-MOLNWFNL.mjs.map +7 -0
  141. package/dist/lib/node-esm/chunk-MOWUEW5P.mjs +15 -0
  142. package/dist/lib/node-esm/chunk-MOWUEW5P.mjs.map +7 -0
  143. package/dist/lib/node-esm/chunk-NBWL7UCZ.mjs +40 -0
  144. package/dist/lib/node-esm/chunk-NBWL7UCZ.mjs.map +7 -0
  145. package/dist/lib/node-esm/chunk-NRN3ZW2T.mjs +143 -0
  146. package/dist/lib/node-esm/chunk-NRN3ZW2T.mjs.map +7 -0
  147. package/dist/lib/node-esm/chunk-QLI2EIJ2.mjs +41 -0
  148. package/dist/lib/node-esm/chunk-QLI2EIJ2.mjs.map +7 -0
  149. package/dist/lib/node-esm/chunk-QYR67VBV.mjs +288 -0
  150. package/dist/lib/node-esm/chunk-QYR67VBV.mjs.map +7 -0
  151. package/dist/lib/node-esm/chunk-UKGVOINP.mjs +9 -0
  152. package/dist/lib/node-esm/chunk-UKGVOINP.mjs.map +7 -0
  153. package/dist/lib/node-esm/chunk-W6QIEBTQ.mjs +403 -0
  154. package/dist/lib/node-esm/chunk-W6QIEBTQ.mjs.map +7 -0
  155. package/dist/lib/node-esm/chunk-XHJRMQZD.mjs +69 -0
  156. package/dist/lib/node-esm/chunk-XHJRMQZD.mjs.map +7 -0
  157. package/dist/lib/node-esm/chunk-Y75VU7LB.mjs +74 -0
  158. package/dist/lib/node-esm/chunk-Y75VU7LB.mjs.map +7 -0
  159. package/dist/lib/node-esm/chunk-YOLH5KS4.mjs +283 -0
  160. package/dist/lib/node-esm/chunk-YOLH5KS4.mjs.map +7 -0
  161. package/dist/lib/node-esm/chunk-YQ2NWGL5.mjs +39 -0
  162. package/dist/lib/node-esm/chunk-YQ2NWGL5.mjs.map +7 -0
  163. package/dist/lib/node-esm/chunk-ZBB67AKD.mjs +24 -0
  164. package/dist/lib/node-esm/chunk-ZBB67AKD.mjs.map +7 -0
  165. package/dist/lib/node-esm/index.mjs +72 -22
  166. package/dist/lib/node-esm/internal/index.mjs +245 -120
  167. package/dist/lib/node-esm/meta.json +1 -1
  168. package/dist/lib/node-esm/testing/index.mjs +295 -226
  169. package/dist/lib/node-esm/testing/index.mjs.map +4 -4
  170. package/dist/types/src/Annotation.d.ts +2 -0
  171. package/dist/types/src/Annotation.d.ts.map +1 -0
  172. package/dist/types/src/Database.d.ts +194 -0
  173. package/dist/types/src/Database.d.ts.map +1 -0
  174. package/dist/types/src/Entity.d.ts +142 -0
  175. package/dist/types/src/Entity.d.ts.map +1 -0
  176. package/dist/types/src/Entity.test.d.ts +2 -0
  177. package/dist/types/src/Entity.test.d.ts.map +1 -0
  178. package/dist/types/src/{errors.d.ts → Err.d.ts} +23 -31
  179. package/dist/types/src/Err.d.ts.map +1 -0
  180. package/dist/types/src/Filter.d.ts +120 -0
  181. package/dist/types/src/Filter.d.ts.map +1 -0
  182. package/dist/types/src/Format.d.ts +4 -0
  183. package/dist/types/src/Format.d.ts.map +1 -0
  184. package/dist/types/src/Hypergraph.d.ts +60 -0
  185. package/dist/types/src/Hypergraph.d.ts.map +1 -0
  186. package/dist/types/src/JsonSchema.d.ts +9 -0
  187. package/dist/types/src/JsonSchema.d.ts.map +1 -0
  188. package/dist/types/src/Key.d.ts +1 -0
  189. package/dist/types/src/Key.d.ts.map +1 -1
  190. package/dist/types/src/Obj.d.ts +302 -99
  191. package/dist/types/src/Obj.d.ts.map +1 -1
  192. package/dist/types/src/Obj.test.d.ts +2 -0
  193. package/dist/types/src/Obj.test.d.ts.map +1 -0
  194. package/dist/types/src/Order.d.ts +16 -0
  195. package/dist/types/src/Order.d.ts.map +1 -0
  196. package/dist/types/src/Query.d.ts +115 -0
  197. package/dist/types/src/Query.d.ts.map +1 -0
  198. package/dist/types/src/Query.test.d.ts +2 -0
  199. package/dist/types/src/Query.test.d.ts.map +1 -0
  200. package/dist/types/src/QueryResult.d.ts +80 -0
  201. package/dist/types/src/QueryResult.d.ts.map +1 -0
  202. package/dist/types/src/Ref.d.ts +13 -11
  203. package/dist/types/src/Ref.d.ts.map +1 -1
  204. package/dist/types/src/Relation.d.ts +242 -22
  205. package/dist/types/src/Relation.d.ts.map +1 -1
  206. package/dist/types/src/Relation.test.d.ts +2 -0
  207. package/dist/types/src/Relation.test.d.ts.map +1 -0
  208. package/dist/types/src/SchemaRegistry.d.ts +84 -0
  209. package/dist/types/src/SchemaRegistry.d.ts.map +1 -0
  210. package/dist/types/src/Tag.d.ts +17 -0
  211. package/dist/types/src/Tag.d.ts.map +1 -0
  212. package/dist/types/src/Type.d.ts +225 -72
  213. package/dist/types/src/Type.d.ts.map +1 -1
  214. package/dist/types/src/Type.test.d.ts +2 -0
  215. package/dist/types/src/Type.test.d.ts.map +1 -0
  216. package/dist/types/src/index.d.ts +15 -5
  217. package/dist/types/src/index.d.ts.map +1 -1
  218. package/dist/types/src/internal/annotations/annotations.d.ts +170 -0
  219. package/dist/types/src/internal/annotations/annotations.d.ts.map +1 -0
  220. package/dist/types/src/internal/annotations/annotations.test.d.ts.map +1 -0
  221. package/dist/types/src/internal/annotations/index.d.ts +3 -0
  222. package/dist/types/src/internal/annotations/index.d.ts.map +1 -0
  223. package/dist/types/src/internal/annotations/util.d.ts +27 -0
  224. package/dist/types/src/internal/annotations/util.d.ts.map +1 -0
  225. package/dist/types/src/internal/api/annotations.d.ts +23 -0
  226. package/dist/types/src/internal/api/annotations.d.ts.map +1 -0
  227. package/dist/types/src/internal/api/entity.d.ts +13 -0
  228. package/dist/types/src/internal/api/entity.d.ts.map +1 -0
  229. package/dist/types/src/internal/api/index.d.ts +15 -0
  230. package/dist/types/src/internal/api/index.d.ts.map +1 -0
  231. package/dist/types/src/internal/api/meta.d.ts +42 -0
  232. package/dist/types/src/internal/api/meta.d.ts.map +1 -0
  233. package/dist/types/src/internal/api/sorting.d.ts +24 -0
  234. package/dist/types/src/internal/api/sorting.d.ts.map +1 -0
  235. package/dist/types/src/internal/api/version.d.ts +42 -0
  236. package/dist/types/src/internal/api/version.d.ts.map +1 -0
  237. package/dist/types/src/internal/entities/entity.d.ts +20 -0
  238. package/dist/types/src/internal/entities/entity.d.ts.map +1 -0
  239. package/dist/types/src/internal/entities/index.d.ts +6 -0
  240. package/dist/types/src/internal/entities/index.d.ts.map +1 -0
  241. package/dist/types/src/internal/entities/model.d.ts +77 -0
  242. package/dist/types/src/internal/entities/model.d.ts.map +1 -0
  243. package/dist/types/src/internal/entities/object.d.ts +18 -0
  244. package/dist/types/src/internal/entities/object.d.ts.map +1 -0
  245. package/dist/types/src/internal/entities/relation.d.ts +62 -0
  246. package/dist/types/src/internal/entities/relation.d.ts.map +1 -0
  247. package/dist/types/src/internal/entities/util.d.ts +2 -0
  248. package/dist/types/src/internal/entities/util.d.ts.map +1 -0
  249. package/dist/types/src/internal/formats/format.d.ts +4 -2
  250. package/dist/types/src/internal/formats/format.d.ts.map +1 -1
  251. package/dist/types/src/internal/formats/select.d.ts +5 -3
  252. package/dist/types/src/internal/formats/select.d.ts.map +1 -1
  253. package/dist/types/src/internal/formats/string.d.ts +4 -0
  254. package/dist/types/src/internal/formats/string.d.ts.map +1 -1
  255. package/dist/types/src/internal/formats/types.d.ts +13 -9
  256. package/dist/types/src/internal/formats/types.d.ts.map +1 -1
  257. package/dist/types/src/internal/index.d.ts +7 -10
  258. package/dist/types/src/internal/index.d.ts.map +1 -1
  259. package/dist/types/src/internal/json-schema/annotations.d.ts.map +1 -0
  260. package/dist/types/src/internal/json-schema/effect-schema.test.d.ts.map +1 -0
  261. package/dist/types/src/internal/json-schema/index.d.ts +2 -0
  262. package/dist/types/src/internal/json-schema/index.d.ts.map +1 -1
  263. package/dist/types/src/internal/json-schema/json-schema-type.d.ts.map +1 -1
  264. package/dist/types/src/internal/{json → json-schema}/json-schema.d.ts +2 -1
  265. package/dist/types/src/internal/json-schema/json-schema.d.ts.map +1 -0
  266. package/dist/types/src/internal/json-schema/json-schema.test.d.ts.map +1 -0
  267. package/dist/types/src/internal/object/clone.d.ts +8 -0
  268. package/dist/types/src/internal/object/clone.d.ts.map +1 -0
  269. package/dist/types/src/internal/object/common.d.ts.map +1 -1
  270. package/dist/types/src/internal/object/{create.d.ts → create-object.d.ts} +10 -11
  271. package/dist/types/src/internal/object/create-object.d.ts.map +1 -0
  272. package/dist/types/src/internal/object/create-object.test.d.ts +2 -0
  273. package/dist/types/src/internal/object/create-object.test.d.ts.map +1 -0
  274. package/dist/types/src/internal/object/deleted.d.ts +2 -2
  275. package/dist/types/src/internal/object/deleted.d.ts.map +1 -1
  276. package/dist/types/src/internal/object/ids.d.ts.map +1 -1
  277. package/dist/types/src/internal/object/index.d.ts +6 -11
  278. package/dist/types/src/internal/object/index.d.ts.map +1 -1
  279. package/dist/types/src/internal/object/json-serializer.d.ts +14 -9
  280. package/dist/types/src/internal/object/json-serializer.d.ts.map +1 -1
  281. package/dist/types/src/internal/object/schema-validator.d.ts +1 -14
  282. package/dist/types/src/internal/object/schema-validator.d.ts.map +1 -1
  283. package/dist/types/src/internal/object/set-value.d.ts +7 -0
  284. package/dist/types/src/internal/object/set-value.d.ts.map +1 -0
  285. package/dist/types/src/internal/object/set-value.test.d.ts +2 -0
  286. package/dist/types/src/internal/object/set-value.test.d.ts.map +1 -0
  287. package/dist/types/src/internal/object/snapshot.d.ts +6 -0
  288. package/dist/types/src/internal/object/snapshot.d.ts.map +1 -0
  289. package/dist/types/src/internal/object/typed-object.d.ts +8 -14
  290. package/dist/types/src/internal/object/typed-object.d.ts.map +1 -1
  291. package/dist/types/src/internal/proxy/change-context.d.ts +55 -0
  292. package/dist/types/src/internal/proxy/change-context.d.ts.map +1 -0
  293. package/dist/types/src/internal/proxy/change.test.d.ts +2 -0
  294. package/dist/types/src/internal/proxy/change.test.d.ts.map +1 -0
  295. package/dist/types/src/internal/proxy/define-hidden-property.d.ts +5 -0
  296. package/dist/types/src/internal/proxy/define-hidden-property.d.ts.map +1 -0
  297. package/dist/types/src/internal/proxy/errors.d.ts +19 -0
  298. package/dist/types/src/internal/proxy/errors.d.ts.map +1 -0
  299. package/dist/types/src/internal/proxy/event-batch.d.ts +10 -0
  300. package/dist/types/src/internal/proxy/event-batch.d.ts.map +1 -0
  301. package/dist/types/src/internal/proxy/index.d.ts +14 -0
  302. package/dist/types/src/internal/proxy/index.d.ts.map +1 -0
  303. package/dist/types/src/internal/proxy/json-serializer.d.ts +6 -0
  304. package/dist/types/src/internal/proxy/json-serializer.d.ts.map +1 -0
  305. package/dist/types/src/internal/proxy/make-object.d.ts +14 -0
  306. package/dist/types/src/internal/proxy/make-object.d.ts.map +1 -0
  307. package/dist/types/src/internal/proxy/ownership.d.ts +57 -0
  308. package/dist/types/src/internal/proxy/ownership.d.ts.map +1 -0
  309. package/dist/types/src/internal/proxy/proxy-types.d.ts +18 -0
  310. package/dist/types/src/internal/proxy/proxy-types.d.ts.map +1 -0
  311. package/dist/types/src/internal/proxy/proxy-utils.d.ts +47 -0
  312. package/dist/types/src/internal/proxy/proxy-utils.d.ts.map +1 -0
  313. package/dist/types/src/internal/proxy/reactive-array.d.ts +8 -0
  314. package/dist/types/src/internal/proxy/reactive-array.d.ts.map +1 -0
  315. package/dist/types/src/internal/proxy/reactive.d.ts +39 -0
  316. package/dist/types/src/internal/proxy/reactive.d.ts.map +1 -0
  317. package/dist/types/src/internal/proxy/schema-validator.d.ts +15 -0
  318. package/dist/types/src/internal/proxy/schema-validator.d.ts.map +1 -0
  319. package/dist/types/src/internal/proxy/symbols.d.ts +3 -0
  320. package/dist/types/src/internal/proxy/symbols.d.ts.map +1 -0
  321. package/dist/types/src/internal/proxy/typed-handler.d.ts +15 -12
  322. package/dist/types/src/internal/proxy/typed-handler.d.ts.map +1 -1
  323. package/dist/types/src/internal/ref/ref-array.d.ts +4 -4
  324. package/dist/types/src/internal/ref/ref-array.d.ts.map +1 -1
  325. package/dist/types/src/internal/ref/ref.d.ts +27 -16
  326. package/dist/types/src/internal/ref/ref.d.ts.map +1 -1
  327. package/dist/types/src/internal/schema/compose.d.ts.map +1 -0
  328. package/dist/types/src/internal/schema/compose.test.d.ts.map +1 -0
  329. package/dist/types/src/internal/schema/echo-schema.d.ts +24 -12
  330. package/dist/types/src/internal/schema/echo-schema.d.ts.map +1 -1
  331. package/dist/types/src/internal/schema/index.d.ts +1 -4
  332. package/dist/types/src/internal/schema/index.d.ts.map +1 -1
  333. package/dist/types/src/internal/schema/persistent-schema.d.ts +20 -0
  334. package/dist/types/src/internal/schema/persistent-schema.d.ts.map +1 -0
  335. package/dist/types/src/internal/types/base.d.ts +26 -0
  336. package/dist/types/src/internal/types/base.d.ts.map +1 -0
  337. package/dist/types/src/internal/types/entity.d.ts +37 -0
  338. package/dist/types/src/internal/types/entity.d.ts.map +1 -0
  339. package/dist/types/src/internal/types/index.d.ts +5 -2
  340. package/dist/types/src/internal/types/index.d.ts.map +1 -1
  341. package/dist/types/src/internal/{object → types}/meta.d.ts +12 -11
  342. package/dist/types/src/internal/types/meta.d.ts.map +1 -0
  343. package/dist/types/src/internal/types/typename.d.ts +13 -0
  344. package/dist/types/src/internal/types/typename.d.ts.map +1 -0
  345. package/dist/types/src/internal/{object → types}/version.d.ts +3 -2
  346. package/dist/types/src/internal/types/version.d.ts.map +1 -0
  347. package/dist/types/src/{test → testing}/api.test.d.ts.map +1 -1
  348. package/dist/types/src/testing/index.d.ts +3 -3
  349. package/dist/types/src/testing/index.d.ts.map +1 -1
  350. package/dist/types/src/testing/test-data.d.ts +18 -0
  351. package/dist/types/src/testing/test-data.d.ts.map +1 -0
  352. package/dist/types/src/testing/test-schema.d.ts +303 -0
  353. package/dist/types/src/testing/test-schema.d.ts.map +1 -0
  354. package/dist/types/src/testing/util.d.ts +21 -0
  355. package/dist/types/src/testing/util.d.ts.map +1 -0
  356. package/dist/types/tsconfig.tsbuildinfo +1 -1
  357. package/package.json +160 -45
  358. package/src/Annotation.ts +18 -0
  359. package/src/Database.ts +336 -0
  360. package/src/Entity.test.ts +22 -0
  361. package/src/Entity.ts +217 -0
  362. package/src/{errors.ts → Err.ts} +2 -2
  363. package/src/Filter.ts +376 -0
  364. package/src/Format.ts +9 -0
  365. package/src/Hypergraph.ts +74 -0
  366. package/src/JsonSchema.ts +16 -0
  367. package/src/Key.ts +3 -0
  368. package/src/Obj.test.ts +386 -0
  369. package/src/Obj.ts +449 -275
  370. package/src/Order.ts +44 -0
  371. package/src/Query.test.ts +465 -0
  372. package/src/Query.ts +296 -0
  373. package/src/QueryResult.ts +106 -0
  374. package/src/Ref.ts +26 -9
  375. package/src/Relation.test.ts +82 -0
  376. package/src/Relation.ts +411 -60
  377. package/src/SchemaRegistry.ts +105 -0
  378. package/src/{query/tag.ts → Tag.ts} +10 -7
  379. package/src/Type.test.ts +52 -0
  380. package/src/Type.ts +361 -114
  381. package/src/index.ts +16 -6
  382. package/src/internal/README.md +100 -0
  383. package/src/internal/{ast → annotations}/annotations.test.ts +18 -20
  384. package/src/internal/annotations/annotations.ts +460 -0
  385. package/src/internal/annotations/index.ts +6 -0
  386. package/src/internal/annotations/util.ts +72 -0
  387. package/src/internal/api/annotations.ts +60 -0
  388. package/src/internal/api/entity.ts +29 -0
  389. package/src/internal/api/index.ts +19 -0
  390. package/src/internal/api/meta.ts +88 -0
  391. package/src/internal/api/sorting.ts +53 -0
  392. package/src/internal/api/version.ts +96 -0
  393. package/src/internal/entities/entity.ts +126 -0
  394. package/src/internal/entities/index.ts +9 -0
  395. package/src/internal/entities/model.ts +134 -0
  396. package/src/internal/entities/object.ts +60 -0
  397. package/src/internal/entities/relation.ts +173 -0
  398. package/src/internal/entities/util.ts +33 -0
  399. package/src/internal/formats/date.test.ts +1 -1
  400. package/src/internal/formats/date.ts +5 -5
  401. package/src/internal/formats/format.test.ts +5 -5
  402. package/src/internal/formats/format.ts +8 -6
  403. package/src/internal/formats/number.ts +5 -5
  404. package/src/internal/formats/object.ts +4 -4
  405. package/src/internal/formats/select.ts +5 -3
  406. package/src/internal/formats/string.ts +14 -9
  407. package/src/internal/formats/types.ts +53 -42
  408. package/src/internal/index.ts +30 -13
  409. package/src/internal/{json → json-schema}/annotations.ts +1 -1
  410. package/src/internal/json-schema/index.ts +2 -0
  411. package/src/internal/json-schema/json-schema-type.ts +5 -4
  412. package/src/internal/{json → json-schema}/json-schema.test.ts +73 -69
  413. package/src/internal/{json → json-schema}/json-schema.ts +17 -8
  414. package/src/internal/object/clone.ts +48 -0
  415. package/src/internal/object/common.ts +3 -4
  416. package/src/internal/object/{create.test.ts → create-object.test.ts} +31 -33
  417. package/src/internal/object/{create.ts → create-object.ts} +36 -37
  418. package/src/internal/object/deleted.ts +6 -6
  419. package/src/internal/object/ids.ts +1 -1
  420. package/src/internal/object/index.ts +6 -11
  421. package/src/internal/object/inspect.ts +5 -7
  422. package/src/internal/object/json-serializer.test.ts +35 -37
  423. package/src/internal/object/json-serializer.ts +65 -102
  424. package/src/internal/object/schema-validator.ts +2 -237
  425. package/src/internal/object/set-value.test.ts +281 -0
  426. package/src/internal/object/set-value.ts +165 -0
  427. package/src/internal/object/snapshot.ts +70 -0
  428. package/src/internal/object/typed-object.test.ts +11 -11
  429. package/src/internal/object/typed-object.ts +8 -66
  430. package/src/internal/proxy/change-context.ts +138 -0
  431. package/src/internal/proxy/change.test.ts +519 -0
  432. package/src/internal/proxy/define-hidden-property.ts +14 -0
  433. package/src/internal/proxy/errors.ts +42 -0
  434. package/src/internal/proxy/event-batch.ts +44 -0
  435. package/src/internal/proxy/handler.test.ts +51 -91
  436. package/src/internal/proxy/index.ts +17 -0
  437. package/src/internal/proxy/json-serializer.ts +87 -0
  438. package/src/internal/proxy/make-object.ts +96 -0
  439. package/src/internal/proxy/ownership.ts +253 -0
  440. package/src/internal/proxy/proxy-types.ts +23 -0
  441. package/src/internal/proxy/proxy-utils.ts +150 -0
  442. package/src/internal/proxy/reactive-array.ts +71 -0
  443. package/src/internal/proxy/reactive.ts +69 -0
  444. package/src/internal/proxy/schema-validator.ts +244 -0
  445. package/src/internal/proxy/schema.test.ts +27 -18
  446. package/src/internal/proxy/symbols.ts +7 -0
  447. package/src/internal/proxy/typed-handler.test.ts +264 -48
  448. package/src/internal/proxy/typed-handler.ts +275 -61
  449. package/src/internal/proxy/typed-object.test.ts +43 -27
  450. package/src/internal/ref/ref-array.ts +4 -4
  451. package/src/internal/ref/ref.test.ts +9 -8
  452. package/src/internal/ref/ref.ts +81 -54
  453. package/src/internal/{projection → schema}/compose.test.ts +8 -9
  454. package/src/internal/{projection → schema}/compose.ts +1 -1
  455. package/src/internal/schema/echo-schema.ts +73 -33
  456. package/src/internal/schema/index.ts +1 -4
  457. package/src/internal/schema/manipulation.ts +1 -1
  458. package/src/internal/schema/persistent-schema.ts +27 -0
  459. package/src/internal/types/base.ts +43 -0
  460. package/src/internal/types/entity.ts +54 -0
  461. package/src/internal/types/index.ts +5 -2
  462. package/src/internal/{object → types}/meta.ts +22 -17
  463. package/src/internal/types/typename.ts +45 -0
  464. package/src/internal/types/version.ts +20 -0
  465. package/src/testing/api.test.ts +126 -0
  466. package/src/testing/index.ts +3 -3
  467. package/src/testing/test-data.ts +130 -0
  468. package/src/testing/test-schema.ts +238 -0
  469. package/src/testing/util.ts +85 -0
  470. package/dist/lib/browser/chunk-HKFCK2GL.mjs +0 -175
  471. package/dist/lib/browser/chunk-HKFCK2GL.mjs.map +0 -7
  472. package/dist/lib/browser/chunk-MAAYELT7.mjs +0 -830
  473. package/dist/lib/browser/chunk-MAAYELT7.mjs.map +0 -7
  474. package/dist/lib/browser/chunk-MB6MMNFP.mjs +0 -3857
  475. package/dist/lib/browser/chunk-MB6MMNFP.mjs.map +0 -7
  476. package/dist/lib/browser/query/index.mjs +0 -15
  477. package/dist/lib/node-esm/chunk-5NWDGIBT.mjs +0 -830
  478. package/dist/lib/node-esm/chunk-5NWDGIBT.mjs.map +0 -7
  479. package/dist/lib/node-esm/chunk-AUAH4E2J.mjs +0 -175
  480. package/dist/lib/node-esm/chunk-AUAH4E2J.mjs.map +0 -7
  481. package/dist/lib/node-esm/chunk-BQRA4VLX.mjs +0 -3857
  482. package/dist/lib/node-esm/chunk-BQRA4VLX.mjs.map +0 -7
  483. package/dist/lib/node-esm/query/index.mjs +0 -15
  484. package/dist/types/src/errors.d.ts.map +0 -1
  485. package/dist/types/src/internal/ast/annotation-helper.d.ts +0 -8
  486. package/dist/types/src/internal/ast/annotation-helper.d.ts.map +0 -1
  487. package/dist/types/src/internal/ast/annotations.d.ts +0 -125
  488. package/dist/types/src/internal/ast/annotations.d.ts.map +0 -1
  489. package/dist/types/src/internal/ast/annotations.test.d.ts.map +0 -1
  490. package/dist/types/src/internal/ast/entity-kind.d.ts +0 -10
  491. package/dist/types/src/internal/ast/entity-kind.d.ts.map +0 -1
  492. package/dist/types/src/internal/ast/index.d.ts +0 -5
  493. package/dist/types/src/internal/ast/index.d.ts.map +0 -1
  494. package/dist/types/src/internal/ast/types.d.ts +0 -6
  495. package/dist/types/src/internal/ast/types.d.ts.map +0 -1
  496. package/dist/types/src/internal/json/annotations.d.ts.map +0 -1
  497. package/dist/types/src/internal/json/effect-schema.test.d.ts.map +0 -1
  498. package/dist/types/src/internal/json/index.d.ts +0 -2
  499. package/dist/types/src/internal/json/index.d.ts.map +0 -1
  500. package/dist/types/src/internal/json/json-schema.d.ts.map +0 -1
  501. package/dist/types/src/internal/json/json-schema.test.d.ts.map +0 -1
  502. package/dist/types/src/internal/object/accessors.d.ts +0 -37
  503. package/dist/types/src/internal/object/accessors.d.ts.map +0 -1
  504. package/dist/types/src/internal/object/create.d.ts.map +0 -1
  505. package/dist/types/src/internal/object/create.test.d.ts +0 -2
  506. package/dist/types/src/internal/object/create.test.d.ts.map +0 -1
  507. package/dist/types/src/internal/object/entity.d.ts +0 -33
  508. package/dist/types/src/internal/object/entity.d.ts.map +0 -1
  509. package/dist/types/src/internal/object/expando.d.ts +0 -14
  510. package/dist/types/src/internal/object/expando.d.ts.map +0 -1
  511. package/dist/types/src/internal/object/meta.d.ts.map +0 -1
  512. package/dist/types/src/internal/object/model.d.ts +0 -117
  513. package/dist/types/src/internal/object/model.d.ts.map +0 -1
  514. package/dist/types/src/internal/object/relation.d.ts +0 -17
  515. package/dist/types/src/internal/object/relation.d.ts.map +0 -1
  516. package/dist/types/src/internal/object/typename.d.ts +0 -15
  517. package/dist/types/src/internal/object/typename.d.ts.map +0 -1
  518. package/dist/types/src/internal/object/version.d.ts.map +0 -1
  519. package/dist/types/src/internal/projection/compose.d.ts.map +0 -1
  520. package/dist/types/src/internal/projection/compose.test.d.ts.map +0 -1
  521. package/dist/types/src/internal/projection/index.d.ts +0 -2
  522. package/dist/types/src/internal/projection/index.d.ts.map +0 -1
  523. package/dist/types/src/internal/proxy/reactive-object.d.ts +0 -15
  524. package/dist/types/src/internal/proxy/reactive-object.d.ts.map +0 -1
  525. package/dist/types/src/internal/query/index.d.ts +0 -2
  526. package/dist/types/src/internal/query/index.d.ts.map +0 -1
  527. package/dist/types/src/internal/query/query.d.ts +0 -17
  528. package/dist/types/src/internal/query/query.d.ts.map +0 -1
  529. package/dist/types/src/internal/schema/runtime-schema-registry.d.ts +0 -18
  530. package/dist/types/src/internal/schema/runtime-schema-registry.d.ts.map +0 -1
  531. package/dist/types/src/internal/schema/snapshot.d.ts +0 -6
  532. package/dist/types/src/internal/schema/snapshot.d.ts.map +0 -1
  533. package/dist/types/src/internal/schema/stored-schema.d.ts +0 -13
  534. package/dist/types/src/internal/schema/stored-schema.d.ts.map +0 -1
  535. package/dist/types/src/internal/testing/index.d.ts +0 -3
  536. package/dist/types/src/internal/testing/index.d.ts.map +0 -1
  537. package/dist/types/src/internal/testing/types.d.ts +0 -455
  538. package/dist/types/src/internal/testing/types.d.ts.map +0 -1
  539. package/dist/types/src/internal/testing/utils.d.ts +0 -10
  540. package/dist/types/src/internal/testing/utils.d.ts.map +0 -1
  541. package/dist/types/src/internal/types/types.d.ts +0 -79
  542. package/dist/types/src/internal/types/types.d.ts.map +0 -1
  543. package/dist/types/src/internal/types/types.test.d.ts +0 -2
  544. package/dist/types/src/internal/types/types.test.d.ts.map +0 -1
  545. package/dist/types/src/internal/types/util.d.ts +0 -5
  546. package/dist/types/src/internal/types/util.d.ts.map +0 -1
  547. package/dist/types/src/query/index.d.ts +0 -3
  548. package/dist/types/src/query/index.d.ts.map +0 -1
  549. package/dist/types/src/query/query.d.ts +0 -248
  550. package/dist/types/src/query/query.d.ts.map +0 -1
  551. package/dist/types/src/query/query.test.d.ts +0 -2
  552. package/dist/types/src/query/query.test.d.ts.map +0 -1
  553. package/dist/types/src/query/tag.d.ts +0 -17
  554. package/dist/types/src/query/tag.d.ts.map +0 -1
  555. package/dist/types/src/testing/echo-schema.d.ts +0 -7
  556. package/dist/types/src/testing/echo-schema.d.ts.map +0 -1
  557. package/dist/types/src/testing/types.d.ts +0 -113
  558. package/dist/types/src/testing/types.d.ts.map +0 -1
  559. package/src/internal/ast/annotation-helper.ts +0 -22
  560. package/src/internal/ast/annotations.ts +0 -219
  561. package/src/internal/ast/entity-kind.ts +0 -15
  562. package/src/internal/ast/index.ts +0 -8
  563. package/src/internal/ast/types.ts +0 -17
  564. package/src/internal/json/index.ts +0 -5
  565. package/src/internal/object/accessors.ts +0 -153
  566. package/src/internal/object/entity.ts +0 -248
  567. package/src/internal/object/expando.ts +0 -21
  568. package/src/internal/object/model.ts +0 -170
  569. package/src/internal/object/relation.ts +0 -24
  570. package/src/internal/object/typename.ts +0 -61
  571. package/src/internal/object/version.ts +0 -22
  572. package/src/internal/projection/index.ts +0 -5
  573. package/src/internal/proxy/reactive-object.ts +0 -108
  574. package/src/internal/query/index.ts +0 -5
  575. package/src/internal/query/query.ts +0 -23
  576. package/src/internal/schema/runtime-schema-registry.ts +0 -78
  577. package/src/internal/schema/snapshot.ts +0 -25
  578. package/src/internal/schema/stored-schema.ts +0 -26
  579. package/src/internal/testing/index.ts +0 -6
  580. package/src/internal/testing/types.ts +0 -211
  581. package/src/internal/testing/utils.ts +0 -54
  582. package/src/internal/types/types.test.ts +0 -48
  583. package/src/internal/types/types.ts +0 -176
  584. package/src/internal/types/util.ts +0 -9
  585. package/src/query/index.ts +0 -6
  586. package/src/query/query.test.ts +0 -401
  587. package/src/query/query.ts +0 -789
  588. package/src/test/api.test.ts +0 -180
  589. package/src/testing/echo-schema.ts +0 -39
  590. package/src/testing/types.ts +0 -91
  591. /package/dist/lib/browser/{query/index.mjs.map → Annotation.mjs.map} +0 -0
  592. /package/dist/lib/{node-esm/query/index.mjs.map → browser/Database.mjs.map} +0 -0
  593. /package/dist/types/src/internal/{ast → annotations}/annotations.test.d.ts +0 -0
  594. /package/dist/types/src/internal/{json → json-schema}/annotations.d.ts +0 -0
  595. /package/dist/types/src/internal/{json → json-schema}/effect-schema.test.d.ts +0 -0
  596. /package/dist/types/src/internal/{json → json-schema}/json-schema.test.d.ts +0 -0
  597. /package/dist/types/src/internal/{projection → schema}/compose.d.ts +0 -0
  598. /package/dist/types/src/internal/{projection → schema}/compose.test.d.ts +0 -0
  599. /package/dist/types/src/{test → testing}/api.test.d.ts +0 -0
  600. /package/src/internal/{json → json-schema}/effect-schema.test.ts +0 -0
package/src/Type.ts CHANGED
@@ -2,150 +2,302 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- import type * as EffectSchema from 'effect/Schema';
5
+ import * as Schema from 'effect/Schema';
6
6
 
7
7
  import { type EncodedReference } from '@dxos/echo-protocol';
8
8
  import { invariant } from '@dxos/invariant';
9
- import type * as Keys from '@dxos/keys';
9
+ import { type DXN, type ObjectId } from '@dxos/keys';
10
+ import { type ToMutable } from '@dxos/util';
11
+
12
+ import type * as Entity$ from './Entity';
13
+ import {
14
+ ANY_OBJECT_TYPENAME,
15
+ ANY_OBJECT_VERSION,
16
+ type ATTR_RELATION_SOURCE,
17
+ type ATTR_RELATION_TARGET,
18
+ type AnyEntity,
19
+ type AnyProperties,
20
+ EchoObjectSchema,
21
+ EchoRelationSchema,
22
+ type EchoRelationSchemaOptions,
23
+ EchoSchema,
24
+ EntityKind,
25
+ PersistentSchema,
26
+ Ref as Ref$,
27
+ type RefFn,
28
+ type RefSchema,
29
+ SchemaKindId,
30
+ type TypeAnnotation,
31
+ type TypeMeta,
32
+ getSchemaDXN,
33
+ getSchemaTypename,
34
+ getSchemaVersion,
35
+ getTypeAnnotation,
36
+ isMutable as isMutable$,
37
+ toEffectSchema,
38
+ toJsonSchema,
39
+ } from './internal';
40
+ import type * as Relation$ from './Relation';
41
+
42
+ // TODO(burdon): Remove toEffectSchema, toJsonSchema (moved to JsonSchema export).
43
+ export { toEffectSchema, toJsonSchema };
10
44
 
11
- import { type ToMutable } from './internal';
12
- import * as EchoSchema from './internal';
13
- import type * as RelationModule from './Relation';
45
+ /**
46
+ * Returns all properties of an object or relation except for the id and kind.
47
+ */
48
+ export type Properties<T = any> = Omit<T, 'id' | Entity$.KindId | Relation$.Source | Relation$.Target>;
14
49
 
15
50
  //
16
- // Kind
51
+ // Internal types (not exported)
17
52
  //
18
53
 
19
- export const KindId: unique symbol = EchoSchema.EntityKindId as any;
20
- export type KindId = typeof KindId;
21
-
22
- export const Kind = EchoSchema.EntityKind;
23
-
24
54
  /**
25
- * Assigns a kind to an Object or Relation instance.
55
+ * Type that marks a schema as an ECHO schema.
56
+ * The value indicates the entity kind (Object or Relation).
26
57
  */
27
- // NOTE: Needed to make `isRelation` and `isObject` checks work.
28
- export interface OfKind<Kind extends EchoSchema.EntityKind> {
29
- readonly id: Keys.ObjectId;
30
- readonly [KindId]: Kind;
31
- }
58
+ type EchoSchemaKind<K extends EntityKind = EntityKind> = {
59
+ readonly [SchemaKindId]: K;
60
+ };
32
61
 
33
62
  /**
34
- * Base ECHO schema type.
63
+ * JSON-encoded properties for objects.
35
64
  */
36
- export type Schema = EchoSchema.EchoSchema;
65
+ interface ObjJsonProps {
66
+ id: string;
67
+ }
37
68
 
38
69
  /**
39
- * Returns all properties of an object or relation except for the id and kind.
70
+ * JSON-encoded properties for relations.
40
71
  */
41
- export type Properties<T = any> = Omit<T, 'id' | KindId | RelationModule.Source | RelationModule.Target>;
72
+ interface RelationJsonProps {
73
+ id: string;
74
+ [ATTR_RELATION_SOURCE]: string;
75
+ [ATTR_RELATION_TARGET]: string;
76
+ }
42
77
 
43
78
  //
44
- // Obj
79
+ // Obj - Runtime schema for any ECHO object
45
80
  //
46
81
 
47
- interface ObjJsonProps {
48
- id: string;
49
- }
82
+ // Internal type for the Obj schema constant.
83
+ // NOTE: The `any` in the type intersection is intentional - it makes this type bidirectionally
84
+ // assignable with specific object types (e.g., Type.Obj can be assigned to/from Meeting.Meeting).
85
+ // This is needed because operation schemas erase type information.
86
+ // TODO(wittjosiah): Consider alternatives to the `any` intersection hack:
87
+ // - Generic operation schemas that preserve input type in output
88
+ // - Branded types that specific schemas also carry
89
+ // - Accept the limitation and require explicit type narrowing at call sites
90
+ type ObjSchemaType = Schema.Schema<
91
+ any & AnyEntity & Entity$.OfKind<typeof Entity$.Kind.Object> & AnyProperties,
92
+ { id: string } & AnyProperties
93
+ > &
94
+ EchoSchemaKind<EntityKind.Object> &
95
+ TypeMeta;
96
+
97
+ // Internal schema definition.
98
+ // NOTE: The EchoObjectSchema annotation is required for Type.Ref(Type.Obj) to work.
99
+ // The typename/version only satisfy ECHO schema machinery for reference targets.
100
+ const ObjSchema = Schema.Struct({
101
+ id: Schema.String,
102
+ }).pipe(
103
+ Schema.extend(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
104
+ EchoObjectSchema({ typename: ANY_OBJECT_TYPENAME, version: ANY_OBJECT_VERSION }),
105
+ );
50
106
 
51
107
  /**
52
- * Return type of the `Obj` schema constructor.
108
+ * Runtime Effect schema for any ECHO object.
109
+ * Use for validation, parsing, or as a reference target for collections.
53
110
  *
54
- * This typedef avoids `TS4023` error (name from external module cannot be used named).
55
- * See Effect's note on interface types.
111
+ * NOTE: `Schema.is(Type.Obj)` does STRUCTURAL validation only (checks for `id` field).
112
+ * Use `Obj.isObject()` for proper ECHO instance type guards that check the KindId brand.
113
+ *
114
+ * @example
115
+ * ```ts
116
+ * // Structural type guard (accepts any object with id field)
117
+ * if (Schema.is(Type.Obj)(unknownValue)) { ... }
118
+ *
119
+ * // ECHO instance type guard (checks KindId brand)
120
+ * if (Obj.isObject(unknownValue)) { ... }
121
+ *
122
+ * // Reference to any object type
123
+ * const Collection = Schema.Struct({
124
+ * objects: Schema.Array(Type.Ref(Type.Obj)),
125
+ * }).pipe(Type.object({ typename: 'Collection', version: '0.1.0' }));
126
+ * ```
56
127
  */
57
- export interface obj<Self extends EffectSchema.Schema.Any>
58
- extends EchoSchema.TypeMeta,
59
- EffectSchema.AnnotableClass<
60
- obj<Self>,
61
- OfKind<EchoSchema.EntityKind.Object> & ToMutable<EffectSchema.Schema.Type<Self>>,
62
- EffectSchema.Simplify<ObjJsonProps & ToMutable<EffectSchema.Schema.Encoded<Self>>>,
63
- EffectSchema.Schema.Context<Self>
64
- > {}
128
+ // TODO(wittjosiah): Investigate if Schema.filter can validate KindId on ECHO instances.
129
+ // Effect Schema normalizes proxy objects to plain objects before calling filter predicates.
130
+ // Possible approaches: custom Schema.declare, AST manipulation, or upstream contribution.
131
+ export const Obj: ObjSchemaType = Object.assign(ObjSchema, {
132
+ [SchemaKindId]: (ObjSchema as any)[SchemaKindId],
133
+ }) as unknown as ObjSchemaType;
65
134
 
66
135
  /**
67
- * Object schema.
136
+ * TypeScript type for an ECHO object schema.
137
+ * `T` is the instance type produced by the schema.
138
+ * `Fields` is the optional struct fields type for introspection.
139
+ *
140
+ * @example
141
+ * ```ts
142
+ * const PersonSchema: Type.Obj<Person> = Schema.Struct({
143
+ * name: Schema.String,
144
+ * }).pipe(Type.object({ typename: 'Person', version: '0.1.0' }));
145
+ *
146
+ * // Access fields for introspection:
147
+ * Object.keys(PersonSchema.fields); // ['name']
148
+ * ```
68
149
  */
69
- export const Obj: {
70
- (opts: EchoSchema.TypeMeta): <Self extends EffectSchema.Schema.Any>(self: Self) => obj<Self>;
71
- } = EchoSchema.EchoObject as any;
150
+ export interface Obj<T = any, Fields extends Schema.Struct.Fields = Schema.Struct.Fields>
151
+ extends TypeMeta,
152
+ EchoSchemaKind<EntityKind.Object>,
153
+ Schema.AnnotableClass<
154
+ Obj<T, Fields>,
155
+ Entity$.OfKind<typeof Entity$.Kind.Object> & T,
156
+ Schema.Simplify<ObjJsonProps & ToMutable<T>>,
157
+ never
158
+ > {
159
+ /**
160
+ * The fields defined in the original struct schema.
161
+ * Allows accessing field definitions for introspection.
162
+ */
163
+ readonly fields: Fields;
164
+ }
72
165
 
73
166
  /**
74
- * Object schema type definitions.
167
+ * Structural base type for any ECHO object schema.
168
+ * Accepts both static schemas (created with Type.object()) and EchoSchema.
169
+ * NOTE: Does not include the brand symbol to avoid TS4053 declaration portability issues.
170
+ * Use Type.isObjectSchema() for runtime type guards.
75
171
  */
76
- export declare namespace Obj {
172
+ type ObjectSchemaBase = Schema.Schema.AnyNoContext & {
173
+ readonly typename: string;
174
+ readonly version: string;
175
+ };
176
+
177
+ export namespace Obj {
77
178
  /**
78
- * Type that represents an arbitrary schema type of an object.
79
- * NOTE: This is not an instance type.
179
+ * Type that represents any ECHO object schema.
180
+ * Accepts both static schemas (Type.object()) and mutable schemas (EchoSchema).
80
181
  */
81
- // TODO(dmaretskyi): If schema was covariant, we could specify props in here, like `id: ObjectId`.
82
- // TODO(burdon): This erases the ECHO type info (e.g., id, typename).
83
- export type Any = EffectSchema.Schema.AnyNoContext;
182
+ export type Any = ObjectSchemaBase;
84
183
  }
85
184
 
185
+ /**
186
+ * Factory function to create an ECHO object schema.
187
+ * Adds object metadata annotations to an Effect schema.
188
+ *
189
+ * @example
190
+ * ```ts
191
+ * const Person = Schema.Struct({
192
+ * name: Schema.String,
193
+ * }).pipe(Type.object({ typename: 'example.com/type/Person', version: '0.1.0' }));
194
+ * ```
195
+ */
196
+ export const object: {
197
+ (opts: TypeMeta): <Self extends Schema.Schema.Any>(self: Self) => Obj<Schema.Schema.Type<Self>>;
198
+ } = EchoObjectSchema as any;
199
+
86
200
  //
87
- // Expando
201
+ // PersistentType (Schema stored in database)
88
202
  //
89
203
 
90
- // TODO(burdon): We're using Expando in many places as a base type.
91
- export interface Expando extends OfKind<EchoSchema.EntityKind.Object> {
92
- [key: string]: any;
93
- }
204
+ export const PersistentType: Obj<PersistentSchema> = PersistentSchema as any;
94
205
 
95
- type ExpandoEncoded = EffectSchema.Simplify<ObjJsonProps & { [key: string]: any }>;
206
+ export interface PersistentType extends Schema.Schema.Type<typeof PersistentType> {}
96
207
 
97
- export const Expando: EffectSchema.Schema<Expando, ExpandoEncoded, never> = EchoSchema.Expando as any;
208
+ export { EchoSchema as RuntimeType };
98
209
 
99
210
  //
100
- // Relation
211
+ // Relation - Runtime schema for any ECHO relation
101
212
  //
102
213
 
103
- interface RelationJsonProps {
104
- id: string;
105
- [EchoSchema.ATTR_RELATION_SOURCE]: string;
106
- [EchoSchema.ATTR_RELATION_TARGET]: string;
107
- }
214
+ // Internal type for the Relation schema constant.
215
+ type RelationSchemaType = Schema.Schema<
216
+ { id: ObjectId } & Record<string, unknown>,
217
+ { id: string } & Record<string, unknown>
218
+ > &
219
+ EchoSchemaKind<EntityKind.Relation> &
220
+ TypeMeta;
221
+
222
+ // Internal schema definition.
223
+ // NOTE: The EchoRelationSchema annotation is required for Type.Ref(Type.Relation) to work.
224
+ // The typename/version/source/target only satisfy ECHO schema machinery for reference targets.
225
+ const RelationSchema = Schema.Struct({
226
+ id: Schema.String,
227
+ }).pipe(
228
+ Schema.extend(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
229
+ EchoRelationSchema({
230
+ typename: 'dxos.org/schema/AnyRelation',
231
+ version: '0.0.0',
232
+ source: ObjSchema,
233
+ target: ObjSchema,
234
+ }),
235
+ );
108
236
 
109
237
  /**
110
- * Return type of the `Relation` schema constructor.
238
+ * Runtime Effect schema for any ECHO relation.
239
+ * Use for validation, parsing, or as a reference target for collections.
240
+ * A relation has `id`, source, and target fields plus any additional properties.
111
241
  *
112
- * This typedef avoids `TS4023` error (name from external module cannot be used named).
113
- * See Effect's note on interface types.
242
+ * NOTE: `Schema.is(Type.Relation)` does STRUCTURAL validation only (checks for `id` field).
243
+ * Use `Relation.isRelation()` for proper ECHO instance type guards that check the KindId brand.
244
+ *
245
+ * @example
246
+ * ```ts
247
+ * // Structural type guard (accepts any object with id field)
248
+ * if (Schema.is(Type.Relation)(unknownValue)) { ... }
249
+ *
250
+ * // ECHO instance type guard (checks KindId brand)
251
+ * if (Relation.isRelation(unknownValue)) { ... }
252
+ * ```
114
253
  */
115
- export interface relation<
116
- Self extends EffectSchema.Schema.Any,
117
- SourceSchema extends EffectSchema.Schema.Any,
118
- TargetSchema extends EffectSchema.Schema.Any,
119
- > extends EchoSchema.TypeMeta,
120
- EffectSchema.AnnotableClass<
121
- relation<Self, SourceSchema, TargetSchema>,
122
- OfKind<EchoSchema.EntityKind.Relation> &
123
- Relation.Endpoints<EffectSchema.Schema.Type<SourceSchema>, EffectSchema.Schema.Type<TargetSchema>> &
124
- ToMutable<EffectSchema.Schema.Type<Self>>,
125
- EffectSchema.Simplify<RelationJsonProps & ToMutable<EffectSchema.Schema.Encoded<Self>>>,
126
- EffectSchema.Schema.Context<Self>
127
- > {}
254
+ export const Relation: RelationSchemaType = Object.assign(RelationSchema, {
255
+ [SchemaKindId]: (RelationSchema as any)[SchemaKindId],
256
+ }) as unknown as RelationSchemaType;
128
257
 
129
258
  /**
130
- * Relation schema.
259
+ * TypeScript type for an ECHO relation schema.
260
+ * `T` is the instance type produced by the schema (excluding source/target).
261
+ * `Source` and `Target` are the endpoint types.
262
+ * `Fields` is the optional struct fields type for introspection.
131
263
  */
132
- // TODO(dmaretskyi): I have to redefine the type here so that the definition uses symbols from @dxos/echo/Relation.
133
- export const Relation: {
134
- <Source extends EffectSchema.Schema.AnyNoContext, Target extends EffectSchema.Schema.AnyNoContext>(
135
- opts: EchoSchema.EchoRelationOptions<Source, Target>,
136
- ): <Self extends EffectSchema.Schema.Any>(self: Self) => relation<Self, Source, Target>;
137
- } = EchoSchema.EchoRelation as any;
264
+ export interface Relation<
265
+ T = any,
266
+ Source = any,
267
+ Target = any,
268
+ Fields extends Schema.Struct.Fields = Schema.Struct.Fields,
269
+ > extends TypeMeta,
270
+ EchoSchemaKind<EntityKind.Relation>,
271
+ Schema.AnnotableClass<
272
+ Relation<T, Source, Target, Fields>,
273
+ Entity$.OfKind<typeof Entity$.Kind.Relation> & Relation.Endpoints<Source, Target> & T,
274
+ Schema.Simplify<RelationJsonProps & ToMutable<T>>,
275
+ never
276
+ > {
277
+ /**
278
+ * The fields defined in the original struct schema.
279
+ * Allows accessing field definitions for introspection.
280
+ */
281
+ readonly fields: Fields;
282
+ }
138
283
 
139
284
  /**
140
- * Relation schema type definitions.
285
+ * Structural base type for any ECHO relation schema.
286
+ * Accepts static schemas (created with Type.relation()).
287
+ * NOTE: Does not include the brand symbol to avoid TS4053 declaration portability issues.
288
+ * Use Type.isRelationSchema() for runtime type guards.
141
289
  */
290
+ type RelationSchemaBase = Schema.Schema.AnyNoContext & {
291
+ readonly typename: string;
292
+ readonly version: string;
293
+ };
294
+
142
295
  export namespace Relation {
143
296
  /**
144
- * Type that represents an arbitrary schema type of a relation.
145
- * NOTE: This is not an instance type.
297
+ * Type that represents any ECHO relation schema.
298
+ * Accepts static schemas (Type.relation()).
146
299
  */
147
- // TODO(dmaretskyi): If schema was covariant, we could specify props in here, like `id: ObjectId`.
148
- export type Any = EffectSchema.Schema.AnyNoContext;
300
+ export type Any = RelationSchemaBase;
149
301
 
150
302
  /**
151
303
  * Get relation source type.
@@ -158,14 +310,90 @@ export namespace Relation {
158
310
  export type Target<A> = A extends Relation.Endpoints<infer _S, infer T> ? T : never;
159
311
 
160
312
  export type Endpoints<Source, Target> = {
161
- [RelationModule.Source]: Source;
162
- [RelationModule.Target]: Target;
313
+ [Relation$.Source]: Source;
314
+ [Relation$.Target]: Target;
163
315
  };
164
316
  }
165
317
 
318
+ /**
319
+ * Factory function to create an ECHO relation schema.
320
+ * Adds relation metadata annotations to an Effect schema.
321
+ *
322
+ * @example
323
+ * ```ts
324
+ * const WorksFor = Schema.Struct({
325
+ * role: Schema.String,
326
+ * }).pipe(Type.relation({
327
+ * typename: 'example.com/type/WorksFor',
328
+ * version: '0.1.0',
329
+ * source: Person,
330
+ * target: Company,
331
+ * }));
332
+ * ```
333
+ */
334
+ export const relation: {
335
+ <SourceSchema extends Schema.Schema.AnyNoContext, TargetSchema extends Schema.Schema.AnyNoContext>(
336
+ opts: EchoRelationSchemaOptions<SourceSchema, TargetSchema>,
337
+ ): <Self extends Schema.Schema.Any>(
338
+ self: Self,
339
+ ) => Relation<Schema.Schema.Type<Self>, Schema.Schema.Type<SourceSchema>, Schema.Schema.Type<TargetSchema>>;
340
+ } = EchoRelationSchema as any;
341
+
342
+ //
343
+ // Entity - Entity schema types (union of Object | Relation)
344
+ //
345
+
346
+ export namespace Entity {
347
+ /**
348
+ * Runtime Effect schema for any ECHO entity (object or relation).
349
+ * Use for validation, parsing, or type guards on unknown values.
350
+ *
351
+ * @example
352
+ * ```ts
353
+ * if (Schema.is(Type.Entity.Any)(unknownValue)) {
354
+ * // unknownValue is an ECHO entity
355
+ * }
356
+ * ```
357
+ */
358
+ export const Any: Schema.Schema<
359
+ { id: ObjectId } & Record<string, unknown>,
360
+ { id: string } & Record<string, unknown>
361
+ > = Schema.Union(Obj, Relation);
362
+
363
+ /**
364
+ * Type alias for any ECHO entity schema (object or relation).
365
+ * Use this in type annotations for schema parameters.
366
+ */
367
+ export type Any = Obj.Any | Relation.Any;
368
+ }
369
+
370
+ /**
371
+ * Type guard to check if a schema is an object schema.
372
+ * NOTE: This checks SCHEMAS, not instances. Use Obj.isObject for instances.
373
+ */
374
+ export const isObjectSchema = (schema: Entity.Any): schema is Obj.Any => {
375
+ return (schema as any)[SchemaKindId] === EntityKind.Object;
376
+ };
377
+
378
+ /**
379
+ * Type guard to check if a schema is a relation schema.
380
+ * NOTE: This checks SCHEMAS, not instances. Use Relation.isRelation for instances.
381
+ */
382
+ export const isRelationSchema = (schema: Entity.Any): schema is Relation.Any => {
383
+ return (schema as any)[SchemaKindId] === EntityKind.Relation;
384
+ };
385
+
166
386
  //
167
387
  // Ref
168
388
  //
389
+ // NOTE: `Type.Ref` vs `Ref.Ref`:
390
+ // - `Type.Ref<T>` is the SCHEMA type - a schema that produces `Ref.Ref<T>` instances.
391
+ // - `Ref.Ref<T>` is the INSTANCE type - the actual runtime ref object.
392
+ //
393
+ // Example:
394
+ // const taskRef: Ref.Ref<Task> = Ref.make(task); // Instance
395
+ // const schema: Type.Ref<Task> = Type.Ref(Task); // Schema
396
+ //
169
397
 
170
398
  /**
171
399
  * Return type of the `Ref` schema constructor.
@@ -173,41 +401,65 @@ export namespace Relation {
173
401
  * This typedef avoids `TS4023` error (name from external module cannot be used named).
174
402
  * See Effect's note on interface types.
175
403
  */
176
- export interface ref<TargetSchema extends EffectSchema.Schema.Any>
177
- extends EchoSchema.Ref$<EffectSchema.Schema.Type<TargetSchema>> {}
404
+ export interface ref<TargetSchema extends Schema.Schema.Any> extends RefSchema<Schema.Schema.Type<TargetSchema>> {}
178
405
 
179
406
  /**
180
- * Ref schema.
407
+ * Factory function to create a Ref schema for the given target schema.
408
+ * Use this in schema definitions to declare reference fields.
409
+ *
410
+ * @example
411
+ * ```ts
412
+ * const Task = Schema.Struct({
413
+ * assignee: Type.Ref(Person), // Creates a Ref schema
414
+ * }).pipe(Type.object({ typename: 'Task', version: '0.1.0' }));
415
+ * ```
181
416
  */
182
- export const Ref: <S extends Obj.Any>(schema: S) => ref<S> = EchoSchema.Ref;
417
+ export const Ref: RefFn = Ref$;
183
418
 
184
- export interface Ref<T> extends EffectSchema.SchemaClass<EchoSchema.Ref<T>, EncodedReference> {}
419
+ /**
420
+ * TypeScript type for a Ref schema.
421
+ * This is the type of the SCHEMA itself, not the runtime ref instance.
422
+ * For the instance type, use `Ref.Ref<T>` from the Ref module.
423
+ *
424
+ * @example
425
+ * ```ts
426
+ * // Schema type annotation (rarely needed, usually inferred):
427
+ * const refSchema: Type.Ref<Task> = Type.Ref(Task);
428
+ *
429
+ * // Instance type annotation (use Ref.Ref instead):
430
+ * const refInstance: Ref.Ref<Task> = Ref.make(task);
431
+ * ```
432
+ */
433
+ export interface Ref<T> extends Schema.SchemaClass<Ref$<T>, EncodedReference> {}
185
434
 
186
- // TODO(buurdon): Move to Ref?
187
435
  export namespace Ref {
188
436
  /**
189
- * Type that represents an arbitrary schema type of a reference.
190
- * NOTE: This is not an instance type.
437
+ * Type that represents any Ref schema (with unknown target type).
438
+ * This is a schema type, not an instance type.
191
439
  */
192
- export type Any = EffectSchema.Schema<EchoSchema.Ref<any>, EncodedReference>;
440
+ export type Any = Schema.Schema<Ref$<any>, EncodedReference>;
193
441
  }
194
442
 
443
+ //
444
+ // Schema utility functions
445
+ //
446
+
195
447
  /**
196
448
  * Gets the full DXN of the schema.
197
449
  * Will include the version if it's a `type` DXN.
198
450
  * @example "dxn:example.com/type/Person:0.1.0"
199
451
  * @example "dxn:echo:SSSSSSSSSS:XXXXXXXXXXXXX"
200
452
  */
201
- export const getDXN = (schema: Obj.Any | Relation.Any): Keys.DXN | undefined => {
202
- return EchoSchema.getSchemaDXN(schema);
453
+ export const getDXN = (schema: Entity.Any): DXN | undefined => {
454
+ return getSchemaDXN(schema);
203
455
  };
204
456
 
205
457
  /**
206
458
  * @param schema - Schema to get the typename from.
207
459
  * @returns The typename of the schema. Example: `example.com/type/Person`.
208
460
  */
209
- export const getTypename = (schema: Obj.Any | Relation.Any): string => {
210
- const typename = EchoSchema.getSchemaTypename(schema);
461
+ export const getTypename = (schema: Entity.Any): string => {
462
+ const typename = getSchemaTypename(schema);
211
463
  invariant(typeof typename === 'string' && !typename.startsWith('dxn:'), 'Invalid typename');
212
464
  return typename;
213
465
  };
@@ -216,8 +468,8 @@ export const getTypename = (schema: Obj.Any | Relation.Any): string => {
216
468
  * Gets the version of the schema.
217
469
  * @example 0.1.0
218
470
  */
219
- export const getVersion = (schema: Obj.Any | Relation.Any): string => {
220
- const version = EchoSchema.getSchemaVersion(schema);
471
+ export const getVersion = (schema: Entity.Any): string => {
472
+ const version = getSchemaVersion(schema);
221
473
  invariant(typeof version === 'string' && version.match(/^\d+\.\d+\.\d+$/), 'Invalid version');
222
474
  return version;
223
475
  };
@@ -225,21 +477,16 @@ export const getVersion = (schema: Obj.Any | Relation.Any): string => {
225
477
  /**
226
478
  * @returns True if the schema is mutable.
227
479
  */
228
- export const isMutable = EchoSchema.isMutable;
480
+ export const isMutable = isMutable$;
229
481
 
230
482
  /**
231
483
  * ECHO type metadata.
232
484
  */
233
- export type Meta = EchoSchema.TypeAnnotation;
485
+ export type Meta = TypeAnnotation;
234
486
 
235
487
  /**
236
488
  * Gets the meta data of the schema.
237
489
  */
238
- export const getMeta = (schema: Obj.Any | Relation.Any): Meta | undefined => {
239
- return EchoSchema.getTypeAnnotation(schema);
490
+ export const getMeta = (schema: Entity.Any): Meta | undefined => {
491
+ return getTypeAnnotation(schema);
240
492
  };
241
-
242
- // TODO(dmaretskyi): Remove re-exports.
243
- export { SpaceId, ObjectId, DXN } from '@dxos/keys';
244
-
245
- export { Format, JsonSchemaType as JsonSchema, toEffectSchema, toJsonSchema } from './internal';
package/src/index.ts CHANGED
@@ -2,15 +2,25 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- export * from './errors';
6
- export * from './query';
5
+ export { QueryAST } from '@dxos/echo-protocol';
6
+ // TODO(wittjosiah): Refactor DXN to not use statics similar to Query.
7
+ export { DXN } from '@dxos/keys';
7
8
 
9
+ export * as Annotation from './Annotation';
10
+ export * as Database from './Database';
11
+ export * as Entity from './Entity';
12
+ export * as Err from './Err';
13
+ export * as Filter from './Filter';
14
+ export * as Format from './Format';
15
+ export * as Hypergraph from './Hypergraph';
16
+ export * as JsonSchema from './JsonSchema';
8
17
  export * as Key from './Key';
9
18
  export * as Obj from './Obj';
19
+ export * as Order from './Order';
20
+ export * as Query from './Query';
21
+ export * as QueryResult from './QueryResult';
10
22
  export * as Ref from './Ref';
11
23
  export * as Relation from './Relation';
24
+ export * as SchemaRegistry from './SchemaRegistry';
25
+ export * as Tag from './Tag';
12
26
  export * as Type from './Type';
13
-
14
- export { QueryAST } from '@dxos/echo-protocol';
15
- export { DXN } from '@dxos/keys';
16
- export { type Live } from '@dxos/live-object';