@dxos/echo 0.8.4-main.406dc2a → 0.8.4-main.52d7546f51

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 (537) hide show
  1. package/README.md +1 -2
  2. package/dist/lib/neutral/Annotation.mjs +35 -0
  3. package/dist/lib/neutral/Database.mjs +45 -0
  4. package/dist/lib/neutral/Entity.mjs +51 -0
  5. package/dist/lib/neutral/Err.mjs +12 -0
  6. package/dist/lib/neutral/Filter.mjs +61 -0
  7. package/dist/lib/neutral/Format.mjs +66 -0
  8. package/dist/lib/neutral/JsonSchema.mjs +19 -0
  9. package/dist/lib/neutral/JsonSchema.mjs.map +7 -0
  10. package/dist/lib/neutral/Key.mjs +12 -0
  11. package/dist/lib/neutral/Key.mjs.map +7 -0
  12. package/dist/lib/neutral/Obj.mjs +104 -0
  13. package/dist/lib/neutral/Obj.mjs.map +7 -0
  14. package/dist/lib/neutral/Order.mjs +12 -0
  15. package/dist/lib/neutral/Order.mjs.map +7 -0
  16. package/dist/lib/neutral/Query.mjs +26 -0
  17. package/dist/lib/neutral/Query.mjs.map +7 -0
  18. package/dist/lib/neutral/QueryResult.mjs +2 -0
  19. package/dist/lib/neutral/QueryResult.mjs.map +7 -0
  20. package/dist/lib/neutral/Ref.mjs +22 -0
  21. package/dist/lib/neutral/Ref.mjs.map +7 -0
  22. package/dist/lib/neutral/Relation.mjs +84 -0
  23. package/dist/lib/neutral/Relation.mjs.map +7 -0
  24. package/dist/lib/neutral/SchemaRegistry.mjs +2 -0
  25. package/dist/lib/neutral/SchemaRegistry.mjs.map +7 -0
  26. package/dist/lib/neutral/Tag.mjs +25 -0
  27. package/dist/lib/neutral/Tag.mjs.map +7 -0
  28. package/dist/lib/neutral/Type.mjs +47 -0
  29. package/dist/lib/neutral/Type.mjs.map +7 -0
  30. package/dist/lib/neutral/chunk-4L6DOFXP.mjs +7 -0
  31. package/dist/lib/neutral/chunk-4L6DOFXP.mjs.map +7 -0
  32. package/dist/lib/neutral/chunk-7WE7SBA2.mjs +402 -0
  33. package/dist/lib/neutral/chunk-7WE7SBA2.mjs.map +7 -0
  34. package/dist/lib/neutral/chunk-7YWDDFPH.mjs +251 -0
  35. package/dist/lib/neutral/chunk-7YWDDFPH.mjs.map +7 -0
  36. package/dist/lib/neutral/chunk-ANHVGJI4.mjs +21 -0
  37. package/dist/lib/neutral/chunk-ANHVGJI4.mjs.map +7 -0
  38. package/dist/lib/neutral/chunk-B4FLOYG7.mjs +130 -0
  39. package/dist/lib/neutral/chunk-B4FLOYG7.mjs.map +7 -0
  40. package/dist/lib/neutral/chunk-EXAYCLIM.mjs +56 -0
  41. package/dist/lib/neutral/chunk-EXAYCLIM.mjs.map +7 -0
  42. package/dist/lib/neutral/chunk-F6BTBXL7.mjs +171 -0
  43. package/dist/lib/neutral/chunk-F6BTBXL7.mjs.map +7 -0
  44. package/dist/lib/neutral/chunk-HQXQWXLH.mjs +269 -0
  45. package/dist/lib/neutral/chunk-HQXQWXLH.mjs.map +7 -0
  46. package/dist/lib/neutral/chunk-J5LGTIGS.mjs +10 -0
  47. package/dist/lib/neutral/chunk-J5LGTIGS.mjs.map +7 -0
  48. package/dist/lib/neutral/chunk-KB7RIVLK.mjs +67 -0
  49. package/dist/lib/neutral/chunk-KB7RIVLK.mjs.map +7 -0
  50. package/dist/lib/neutral/chunk-MXQJZCPY.mjs +51 -0
  51. package/dist/lib/neutral/chunk-MXQJZCPY.mjs.map +7 -0
  52. package/dist/lib/neutral/chunk-N2QNHMT5.mjs +73 -0
  53. package/dist/lib/neutral/chunk-N2QNHMT5.mjs.map +7 -0
  54. package/dist/lib/neutral/chunk-OMUPQMLR.mjs +7 -0
  55. package/dist/lib/neutral/chunk-OMUPQMLR.mjs.map +7 -0
  56. package/dist/lib/neutral/chunk-RCBBZLVM.mjs +142 -0
  57. package/dist/lib/neutral/chunk-RCBBZLVM.mjs.map +7 -0
  58. package/dist/lib/neutral/chunk-RIMHNJ3E.mjs +296 -0
  59. package/dist/lib/neutral/chunk-RIMHNJ3E.mjs.map +7 -0
  60. package/dist/lib/neutral/chunk-ROKO4RKJ.mjs +42 -0
  61. package/dist/lib/neutral/chunk-ROKO4RKJ.mjs.map +7 -0
  62. package/dist/lib/neutral/chunk-TMLVKIMX.mjs +40 -0
  63. package/dist/lib/neutral/chunk-TMLVKIMX.mjs.map +7 -0
  64. package/dist/lib/neutral/chunk-UMECVTXM.mjs +287 -0
  65. package/dist/lib/neutral/chunk-UMECVTXM.mjs.map +7 -0
  66. package/dist/lib/neutral/chunk-VJ2H5MOJ.mjs +3905 -0
  67. package/dist/lib/neutral/chunk-VJ2H5MOJ.mjs.map +7 -0
  68. package/dist/lib/neutral/chunk-VYEWMV5U.mjs +23 -0
  69. package/dist/lib/neutral/chunk-VYEWMV5U.mjs.map +7 -0
  70. package/dist/lib/neutral/chunk-X2MPMYYN.mjs +13 -0
  71. package/dist/lib/neutral/chunk-X2MPMYYN.mjs.map +7 -0
  72. package/dist/lib/neutral/chunk-XAJMXQ4H.mjs +43 -0
  73. package/dist/lib/neutral/chunk-XAJMXQ4H.mjs.map +7 -0
  74. package/dist/lib/neutral/chunk-YPIP3WGI.mjs +97 -0
  75. package/dist/lib/neutral/chunk-YPIP3WGI.mjs.map +7 -0
  76. package/dist/lib/neutral/index.mjs +84 -0
  77. package/dist/lib/neutral/index.mjs.map +7 -0
  78. package/dist/lib/{node-esm → neutral}/internal/index.mjs +251 -121
  79. package/dist/lib/neutral/internal/index.mjs.map +7 -0
  80. package/dist/lib/neutral/meta.json +1 -0
  81. package/dist/lib/neutral/testing/index.mjs +366 -0
  82. package/dist/lib/neutral/testing/index.mjs.map +7 -0
  83. package/dist/types/src/Annotation.d.ts +24 -0
  84. package/dist/types/src/Annotation.d.ts.map +1 -0
  85. package/dist/types/src/Database.d.ts +216 -0
  86. package/dist/types/src/Database.d.ts.map +1 -0
  87. package/dist/types/src/Entity.d.ts +142 -0
  88. package/dist/types/src/Entity.d.ts.map +1 -0
  89. package/dist/types/src/Entity.test.d.ts +2 -0
  90. package/dist/types/src/Entity.test.d.ts.map +1 -0
  91. package/dist/types/src/Err.d.ts +107 -0
  92. package/dist/types/src/Err.d.ts.map +1 -0
  93. package/dist/types/src/Filter.d.ts +120 -0
  94. package/dist/types/src/Filter.d.ts.map +1 -0
  95. package/dist/types/src/Format.d.ts +4 -0
  96. package/dist/types/src/Format.d.ts.map +1 -0
  97. package/dist/types/src/Hypergraph.d.ts +60 -0
  98. package/dist/types/src/Hypergraph.d.ts.map +1 -0
  99. package/dist/types/src/JsonSchema.d.ts +9 -0
  100. package/dist/types/src/JsonSchema.d.ts.map +1 -0
  101. package/dist/types/src/Key.d.ts +1 -0
  102. package/dist/types/src/Key.d.ts.map +1 -1
  103. package/dist/types/src/Obj.d.ts +382 -99
  104. package/dist/types/src/Obj.d.ts.map +1 -1
  105. package/dist/types/src/Obj.test.d.ts +2 -0
  106. package/dist/types/src/Obj.test.d.ts.map +1 -0
  107. package/dist/types/src/Order.d.ts +16 -0
  108. package/dist/types/src/Order.d.ts.map +1 -0
  109. package/dist/types/src/Query.d.ts +125 -0
  110. package/dist/types/src/Query.d.ts.map +1 -0
  111. package/dist/types/src/Query.test.d.ts +2 -0
  112. package/dist/types/src/Query.test.d.ts.map +1 -0
  113. package/dist/types/src/QueryResult.d.ts +80 -0
  114. package/dist/types/src/QueryResult.d.ts.map +1 -0
  115. package/dist/types/src/Ref.d.ts +13 -11
  116. package/dist/types/src/Ref.d.ts.map +1 -1
  117. package/dist/types/src/Relation.d.ts +243 -23
  118. package/dist/types/src/Relation.d.ts.map +1 -1
  119. package/dist/types/src/Relation.test.d.ts +2 -0
  120. package/dist/types/src/Relation.test.d.ts.map +1 -0
  121. package/dist/types/src/SchemaRegistry.d.ts +84 -0
  122. package/dist/types/src/SchemaRegistry.d.ts.map +1 -0
  123. package/dist/types/src/Tag.d.ts +17 -0
  124. package/dist/types/src/Tag.d.ts.map +1 -0
  125. package/dist/types/src/Type.d.ts +225 -72
  126. package/dist/types/src/Type.d.ts.map +1 -1
  127. package/dist/types/src/Type.test.d.ts +2 -0
  128. package/dist/types/src/Type.test.d.ts.map +1 -0
  129. package/dist/types/src/hierarchy.test.d.ts +2 -0
  130. package/dist/types/src/hierarchy.test.d.ts.map +1 -0
  131. package/dist/types/src/index.d.ts +15 -5
  132. package/dist/types/src/index.d.ts.map +1 -1
  133. package/dist/types/src/internal/annotations/annotations.d.ts +177 -0
  134. package/dist/types/src/internal/annotations/annotations.d.ts.map +1 -0
  135. package/dist/types/src/internal/annotations/annotations.test.d.ts.map +1 -0
  136. package/dist/types/src/internal/annotations/index.d.ts +3 -0
  137. package/dist/types/src/internal/annotations/index.d.ts.map +1 -0
  138. package/dist/types/src/internal/annotations/util.d.ts +39 -0
  139. package/dist/types/src/internal/annotations/util.d.ts.map +1 -0
  140. package/dist/types/src/internal/api/annotations.d.ts +23 -0
  141. package/dist/types/src/internal/api/annotations.d.ts.map +1 -0
  142. package/dist/types/src/internal/api/entity.d.ts +13 -0
  143. package/dist/types/src/internal/api/entity.d.ts.map +1 -0
  144. package/dist/types/src/internal/api/index.d.ts +15 -0
  145. package/dist/types/src/internal/api/index.d.ts.map +1 -0
  146. package/dist/types/src/internal/api/meta.d.ts +42 -0
  147. package/dist/types/src/internal/api/meta.d.ts.map +1 -0
  148. package/dist/types/src/internal/api/sorting.d.ts +24 -0
  149. package/dist/types/src/internal/api/sorting.d.ts.map +1 -0
  150. package/dist/types/src/internal/api/version.d.ts +42 -0
  151. package/dist/types/src/internal/api/version.d.ts.map +1 -0
  152. package/dist/types/src/internal/entities/entity.d.ts +20 -0
  153. package/dist/types/src/internal/entities/entity.d.ts.map +1 -0
  154. package/dist/types/src/internal/entities/index.d.ts +6 -0
  155. package/dist/types/src/internal/entities/index.d.ts.map +1 -0
  156. package/dist/types/src/internal/entities/model.d.ts +79 -0
  157. package/dist/types/src/internal/entities/model.d.ts.map +1 -0
  158. package/dist/types/src/internal/entities/object.d.ts +18 -0
  159. package/dist/types/src/internal/entities/object.d.ts.map +1 -0
  160. package/dist/types/src/internal/entities/relation.d.ts +62 -0
  161. package/dist/types/src/internal/entities/relation.d.ts.map +1 -0
  162. package/dist/types/src/internal/entities/util.d.ts +2 -0
  163. package/dist/types/src/internal/entities/util.d.ts.map +1 -0
  164. package/dist/types/src/internal/formats/format.d.ts +4 -2
  165. package/dist/types/src/internal/formats/format.d.ts.map +1 -1
  166. package/dist/types/src/internal/formats/select.d.ts +6 -4
  167. package/dist/types/src/internal/formats/select.d.ts.map +1 -1
  168. package/dist/types/src/internal/formats/string.d.ts +4 -0
  169. package/dist/types/src/internal/formats/string.d.ts.map +1 -1
  170. package/dist/types/src/internal/formats/types.d.ts +13 -9
  171. package/dist/types/src/internal/formats/types.d.ts.map +1 -1
  172. package/dist/types/src/internal/index.d.ts +7 -10
  173. package/dist/types/src/internal/index.d.ts.map +1 -1
  174. package/dist/types/src/internal/json-schema/annotations.d.ts.map +1 -0
  175. package/dist/types/src/internal/json-schema/effect-schema.test.d.ts.map +1 -0
  176. package/dist/types/src/internal/json-schema/index.d.ts +2 -0
  177. package/dist/types/src/internal/json-schema/index.d.ts.map +1 -1
  178. package/dist/types/src/internal/json-schema/json-schema-normalize.d.ts.map +1 -1
  179. package/dist/types/src/internal/json-schema/json-schema-type.d.ts +130 -29
  180. package/dist/types/src/internal/json-schema/json-schema-type.d.ts.map +1 -1
  181. package/dist/types/src/internal/{json → json-schema}/json-schema.d.ts +4 -2
  182. package/dist/types/src/internal/json-schema/json-schema.d.ts.map +1 -0
  183. package/dist/types/src/internal/json-schema/json-schema.test.d.ts.map +1 -0
  184. package/dist/types/src/internal/object/clone.d.ts +8 -0
  185. package/dist/types/src/internal/object/clone.d.ts.map +1 -0
  186. package/dist/types/src/internal/object/common.d.ts.map +1 -1
  187. package/dist/types/src/internal/object/{create.d.ts → create-object.d.ts} +10 -11
  188. package/dist/types/src/internal/object/create-object.d.ts.map +1 -0
  189. package/dist/types/src/internal/object/create-object.test.d.ts +2 -0
  190. package/dist/types/src/internal/object/create-object.test.d.ts.map +1 -0
  191. package/dist/types/src/internal/object/deleted.d.ts +2 -2
  192. package/dist/types/src/internal/object/deleted.d.ts.map +1 -1
  193. package/dist/types/src/internal/object/ids.d.ts.map +1 -1
  194. package/dist/types/src/internal/object/index.d.ts +6 -11
  195. package/dist/types/src/internal/object/index.d.ts.map +1 -1
  196. package/dist/types/src/internal/object/json-serializer.d.ts +14 -9
  197. package/dist/types/src/internal/object/json-serializer.d.ts.map +1 -1
  198. package/dist/types/src/internal/object/schema-validator.d.ts +1 -14
  199. package/dist/types/src/internal/object/schema-validator.d.ts.map +1 -1
  200. package/dist/types/src/internal/object/set-value.d.ts +7 -0
  201. package/dist/types/src/internal/object/set-value.d.ts.map +1 -0
  202. package/dist/types/src/internal/object/set-value.test.d.ts +2 -0
  203. package/dist/types/src/internal/object/set-value.test.d.ts.map +1 -0
  204. package/dist/types/src/internal/object/snapshot.d.ts +6 -0
  205. package/dist/types/src/internal/object/snapshot.d.ts.map +1 -0
  206. package/dist/types/src/internal/object/typed-object.d.ts +8 -14
  207. package/dist/types/src/internal/object/typed-object.d.ts.map +1 -1
  208. package/dist/types/src/internal/proxy/change-context.d.ts +55 -0
  209. package/dist/types/src/internal/proxy/change-context.d.ts.map +1 -0
  210. package/dist/types/src/internal/proxy/change.test.d.ts +2 -0
  211. package/dist/types/src/internal/proxy/change.test.d.ts.map +1 -0
  212. package/dist/types/src/internal/proxy/define-hidden-property.d.ts +5 -0
  213. package/dist/types/src/internal/proxy/define-hidden-property.d.ts.map +1 -0
  214. package/dist/types/src/internal/proxy/errors.d.ts +19 -0
  215. package/dist/types/src/internal/proxy/errors.d.ts.map +1 -0
  216. package/dist/types/src/internal/proxy/event-batch.d.ts +10 -0
  217. package/dist/types/src/internal/proxy/event-batch.d.ts.map +1 -0
  218. package/dist/types/src/internal/proxy/index.d.ts +14 -0
  219. package/dist/types/src/internal/proxy/index.d.ts.map +1 -0
  220. package/dist/types/src/internal/proxy/json-serializer.d.ts +6 -0
  221. package/dist/types/src/internal/proxy/json-serializer.d.ts.map +1 -0
  222. package/dist/types/src/internal/proxy/make-object.d.ts +14 -0
  223. package/dist/types/src/internal/proxy/make-object.d.ts.map +1 -0
  224. package/dist/types/src/internal/proxy/ownership.d.ts +57 -0
  225. package/dist/types/src/internal/proxy/ownership.d.ts.map +1 -0
  226. package/dist/types/src/internal/proxy/proxy-types.d.ts +18 -0
  227. package/dist/types/src/internal/proxy/proxy-types.d.ts.map +1 -0
  228. package/dist/types/src/internal/proxy/proxy-utils.d.ts +47 -0
  229. package/dist/types/src/internal/proxy/proxy-utils.d.ts.map +1 -0
  230. package/dist/types/src/internal/proxy/reactive-array.d.ts +8 -0
  231. package/dist/types/src/internal/proxy/reactive-array.d.ts.map +1 -0
  232. package/dist/types/src/internal/proxy/reactive.d.ts +39 -0
  233. package/dist/types/src/internal/proxy/reactive.d.ts.map +1 -0
  234. package/dist/types/src/internal/proxy/schema-validator.d.ts +15 -0
  235. package/dist/types/src/internal/proxy/schema-validator.d.ts.map +1 -0
  236. package/dist/types/src/internal/proxy/symbols.d.ts +3 -0
  237. package/dist/types/src/internal/proxy/symbols.d.ts.map +1 -0
  238. package/dist/types/src/internal/proxy/typed-handler.d.ts +16 -12
  239. package/dist/types/src/internal/proxy/typed-handler.d.ts.map +1 -1
  240. package/dist/types/src/internal/ref/ref-array.d.ts +4 -4
  241. package/dist/types/src/internal/ref/ref-array.d.ts.map +1 -1
  242. package/dist/types/src/internal/ref/ref.d.ts +43 -18
  243. package/dist/types/src/internal/ref/ref.d.ts.map +1 -1
  244. package/dist/types/src/internal/schema/compose.d.ts +7 -0
  245. package/dist/types/src/internal/schema/compose.d.ts.map +1 -0
  246. package/dist/types/src/internal/schema/compose.test.d.ts.map +1 -0
  247. package/dist/types/src/internal/schema/echo-schema.d.ts +25 -12
  248. package/dist/types/src/internal/schema/echo-schema.d.ts.map +1 -1
  249. package/dist/types/src/internal/schema/index.d.ts +1 -4
  250. package/dist/types/src/internal/schema/index.d.ts.map +1 -1
  251. package/dist/types/src/internal/schema/persistent-schema.d.ts +20 -0
  252. package/dist/types/src/internal/schema/persistent-schema.d.ts.map +1 -0
  253. package/dist/types/src/internal/types/base.d.ts +26 -0
  254. package/dist/types/src/internal/types/base.d.ts.map +1 -0
  255. package/dist/types/src/internal/types/entity.d.ts +37 -0
  256. package/dist/types/src/internal/types/entity.d.ts.map +1 -0
  257. package/dist/types/src/internal/types/index.d.ts +5 -2
  258. package/dist/types/src/internal/types/index.d.ts.map +1 -1
  259. package/dist/types/src/internal/{object → types}/meta.d.ts +17 -16
  260. package/dist/types/src/internal/types/meta.d.ts.map +1 -0
  261. package/dist/types/src/internal/types/typename.d.ts +21 -0
  262. package/dist/types/src/internal/types/typename.d.ts.map +1 -0
  263. package/dist/types/src/internal/{object → types}/version.d.ts +3 -2
  264. package/dist/types/src/internal/types/version.d.ts.map +1 -0
  265. package/dist/types/src/{test → testing}/api.test.d.ts.map +1 -1
  266. package/dist/types/src/testing/index.d.ts +3 -3
  267. package/dist/types/src/testing/index.d.ts.map +1 -1
  268. package/dist/types/src/testing/test-data.d.ts +18 -0
  269. package/dist/types/src/testing/test-data.d.ts.map +1 -0
  270. package/dist/types/src/testing/test-schema.d.ts +303 -0
  271. package/dist/types/src/testing/test-schema.d.ts.map +1 -0
  272. package/dist/types/src/testing/util.d.ts +21 -0
  273. package/dist/types/src/testing/util.d.ts.map +1 -0
  274. package/dist/types/tsconfig.tsbuildinfo +1 -1
  275. package/package.json +101 -65
  276. package/src/Annotation.ts +45 -0
  277. package/src/Database.ts +353 -0
  278. package/src/Entity.test.ts +22 -0
  279. package/src/Entity.ts +217 -0
  280. package/src/Err.ts +38 -0
  281. package/src/Filter.ts +376 -0
  282. package/src/Format.ts +9 -0
  283. package/src/Hypergraph.ts +74 -0
  284. package/src/JsonSchema.ts +16 -0
  285. package/src/Key.ts +3 -0
  286. package/src/Obj.test.ts +442 -0
  287. package/src/Obj.ts +574 -271
  288. package/src/Order.ts +44 -0
  289. package/src/Query.test.ts +465 -0
  290. package/src/Query.ts +324 -0
  291. package/src/QueryResult.ts +106 -0
  292. package/src/Ref.ts +26 -9
  293. package/src/Relation.test.ts +82 -0
  294. package/src/Relation.ts +414 -61
  295. package/src/SchemaRegistry.ts +105 -0
  296. package/src/{query/tag.ts → Tag.ts} +10 -7
  297. package/src/Type.test.ts +52 -0
  298. package/src/Type.ts +361 -114
  299. package/src/hierarchy.test.ts +33 -0
  300. package/src/index.ts +16 -6
  301. package/src/internal/README.md +102 -0
  302. package/src/internal/{ast → annotations}/annotations.test.ts +18 -20
  303. package/src/internal/annotations/annotations.ts +487 -0
  304. package/src/internal/annotations/index.ts +6 -0
  305. package/src/internal/annotations/util.ts +85 -0
  306. package/src/internal/api/annotations.ts +60 -0
  307. package/src/internal/api/entity.ts +29 -0
  308. package/src/internal/api/index.ts +19 -0
  309. package/src/internal/api/meta.ts +88 -0
  310. package/src/internal/api/sorting.ts +53 -0
  311. package/src/internal/api/version.ts +96 -0
  312. package/src/internal/entities/entity.ts +126 -0
  313. package/src/internal/entities/index.ts +9 -0
  314. package/src/internal/entities/model.ts +138 -0
  315. package/src/internal/entities/object.ts +58 -0
  316. package/src/internal/entities/relation.ts +171 -0
  317. package/src/internal/entities/util.ts +33 -0
  318. package/src/internal/formats/date.test.ts +1 -1
  319. package/src/internal/formats/date.ts +5 -5
  320. package/src/internal/formats/format.test.ts +6 -6
  321. package/src/internal/formats/format.ts +8 -6
  322. package/src/internal/formats/number.ts +5 -5
  323. package/src/internal/formats/object.ts +4 -4
  324. package/src/internal/formats/select.ts +6 -4
  325. package/src/internal/formats/string.ts +14 -9
  326. package/src/internal/formats/types.ts +53 -42
  327. package/src/internal/index.ts +30 -13
  328. package/src/internal/{json → json-schema}/annotations.ts +1 -1
  329. package/src/internal/json-schema/index.ts +2 -0
  330. package/src/internal/json-schema/json-schema-normalize.ts +4 -2
  331. package/src/internal/json-schema/json-schema-type.ts +35 -35
  332. package/src/internal/{json → json-schema}/json-schema.test.ts +73 -69
  333. package/src/internal/{json → json-schema}/json-schema.ts +27 -14
  334. package/src/internal/object/clone.ts +48 -0
  335. package/src/internal/object/common.ts +3 -4
  336. package/src/internal/object/{create.test.ts → create-object.test.ts} +31 -33
  337. package/src/internal/object/{create.ts → create-object.ts} +36 -37
  338. package/src/internal/object/deleted.ts +6 -6
  339. package/src/internal/object/ids.ts +1 -1
  340. package/src/internal/object/index.ts +6 -11
  341. package/src/internal/object/inspect.ts +5 -7
  342. package/src/internal/object/json-serializer.test.ts +36 -37
  343. package/src/internal/object/json-serializer.ts +74 -102
  344. package/src/internal/object/schema-validator.test.ts +3 -7
  345. package/src/internal/object/schema-validator.ts +2 -237
  346. package/src/internal/object/set-value.test.ts +281 -0
  347. package/src/internal/object/set-value.ts +165 -0
  348. package/src/internal/object/snapshot.ts +93 -0
  349. package/src/internal/object/typed-object.test.ts +11 -11
  350. package/src/internal/object/typed-object.ts +8 -66
  351. package/src/internal/proxy/change-context.ts +138 -0
  352. package/src/internal/proxy/change.test.ts +519 -0
  353. package/src/internal/proxy/define-hidden-property.ts +14 -0
  354. package/src/internal/proxy/errors.ts +42 -0
  355. package/src/internal/proxy/event-batch.ts +44 -0
  356. package/src/internal/proxy/handler.test.ts +51 -91
  357. package/src/internal/proxy/index.ts +17 -0
  358. package/src/internal/proxy/json-serializer.ts +87 -0
  359. package/src/internal/proxy/make-object.ts +106 -0
  360. package/src/internal/proxy/ownership.ts +253 -0
  361. package/src/internal/proxy/proxy-types.ts +23 -0
  362. package/src/internal/proxy/proxy-utils.ts +150 -0
  363. package/src/internal/proxy/reactive-array.ts +71 -0
  364. package/src/internal/proxy/reactive.ts +69 -0
  365. package/src/internal/proxy/schema-validator.ts +244 -0
  366. package/src/internal/proxy/schema.test.ts +27 -18
  367. package/src/internal/proxy/symbols.ts +7 -0
  368. package/src/internal/proxy/typed-handler.test.ts +260 -48
  369. package/src/internal/proxy/typed-handler.ts +283 -61
  370. package/src/internal/proxy/typed-object.test.ts +54 -38
  371. package/src/internal/ref/ref-array.ts +4 -4
  372. package/src/internal/ref/ref.test.ts +10 -9
  373. package/src/internal/ref/ref.ts +107 -56
  374. package/src/internal/{projection → schema}/compose.test.ts +8 -9
  375. package/src/internal/{projection → schema}/compose.ts +13 -8
  376. package/src/internal/schema/echo-schema.ts +74 -33
  377. package/src/internal/schema/index.ts +1 -4
  378. package/src/internal/schema/manipulation.ts +1 -1
  379. package/src/internal/schema/persistent-schema.ts +28 -0
  380. package/src/internal/types/base.ts +43 -0
  381. package/src/internal/types/entity.ts +54 -0
  382. package/src/internal/types/index.ts +5 -2
  383. package/src/internal/types/meta.ts +65 -0
  384. package/src/internal/types/typename.ts +55 -0
  385. package/src/internal/types/version.ts +20 -0
  386. package/src/testing/api.test.ts +126 -0
  387. package/src/testing/index.ts +3 -3
  388. package/src/testing/test-data.ts +130 -0
  389. package/src/testing/test-schema.ts +238 -0
  390. package/src/testing/util.ts +85 -0
  391. package/dist/lib/browser/chunk-HKFCK2GL.mjs +0 -175
  392. package/dist/lib/browser/chunk-HKFCK2GL.mjs.map +0 -7
  393. package/dist/lib/browser/chunk-MAAYELT7.mjs +0 -830
  394. package/dist/lib/browser/chunk-MAAYELT7.mjs.map +0 -7
  395. package/dist/lib/browser/chunk-MB6MMNFP.mjs +0 -3857
  396. package/dist/lib/browser/chunk-MB6MMNFP.mjs.map +0 -7
  397. package/dist/lib/browser/index.mjs +0 -35
  398. package/dist/lib/browser/internal/index.mjs +0 -332
  399. package/dist/lib/browser/meta.json +0 -1
  400. package/dist/lib/browser/query/index.mjs +0 -15
  401. package/dist/lib/browser/testing/index.mjs +0 -298
  402. package/dist/lib/browser/testing/index.mjs.map +0 -7
  403. package/dist/lib/node-esm/chunk-5NWDGIBT.mjs +0 -830
  404. package/dist/lib/node-esm/chunk-5NWDGIBT.mjs.map +0 -7
  405. package/dist/lib/node-esm/chunk-AUAH4E2J.mjs +0 -175
  406. package/dist/lib/node-esm/chunk-AUAH4E2J.mjs.map +0 -7
  407. package/dist/lib/node-esm/chunk-BQRA4VLX.mjs +0 -3857
  408. package/dist/lib/node-esm/chunk-BQRA4VLX.mjs.map +0 -7
  409. package/dist/lib/node-esm/index.mjs +0 -35
  410. package/dist/lib/node-esm/meta.json +0 -1
  411. package/dist/lib/node-esm/query/index.mjs +0 -15
  412. package/dist/lib/node-esm/testing/index.mjs +0 -298
  413. package/dist/lib/node-esm/testing/index.mjs.map +0 -7
  414. package/dist/types/src/errors.d.ts +0 -72
  415. package/dist/types/src/errors.d.ts.map +0 -1
  416. package/dist/types/src/internal/ast/annotation-helper.d.ts +0 -8
  417. package/dist/types/src/internal/ast/annotation-helper.d.ts.map +0 -1
  418. package/dist/types/src/internal/ast/annotations.d.ts +0 -125
  419. package/dist/types/src/internal/ast/annotations.d.ts.map +0 -1
  420. package/dist/types/src/internal/ast/annotations.test.d.ts.map +0 -1
  421. package/dist/types/src/internal/ast/entity-kind.d.ts +0 -10
  422. package/dist/types/src/internal/ast/entity-kind.d.ts.map +0 -1
  423. package/dist/types/src/internal/ast/index.d.ts +0 -5
  424. package/dist/types/src/internal/ast/index.d.ts.map +0 -1
  425. package/dist/types/src/internal/ast/types.d.ts +0 -6
  426. package/dist/types/src/internal/ast/types.d.ts.map +0 -1
  427. package/dist/types/src/internal/json/annotations.d.ts.map +0 -1
  428. package/dist/types/src/internal/json/effect-schema.test.d.ts.map +0 -1
  429. package/dist/types/src/internal/json/index.d.ts +0 -2
  430. package/dist/types/src/internal/json/index.d.ts.map +0 -1
  431. package/dist/types/src/internal/json/json-schema.d.ts.map +0 -1
  432. package/dist/types/src/internal/json/json-schema.test.d.ts.map +0 -1
  433. package/dist/types/src/internal/object/accessors.d.ts +0 -37
  434. package/dist/types/src/internal/object/accessors.d.ts.map +0 -1
  435. package/dist/types/src/internal/object/create.d.ts.map +0 -1
  436. package/dist/types/src/internal/object/create.test.d.ts +0 -2
  437. package/dist/types/src/internal/object/create.test.d.ts.map +0 -1
  438. package/dist/types/src/internal/object/entity.d.ts +0 -33
  439. package/dist/types/src/internal/object/entity.d.ts.map +0 -1
  440. package/dist/types/src/internal/object/expando.d.ts +0 -14
  441. package/dist/types/src/internal/object/expando.d.ts.map +0 -1
  442. package/dist/types/src/internal/object/meta.d.ts.map +0 -1
  443. package/dist/types/src/internal/object/model.d.ts +0 -117
  444. package/dist/types/src/internal/object/model.d.ts.map +0 -1
  445. package/dist/types/src/internal/object/relation.d.ts +0 -17
  446. package/dist/types/src/internal/object/relation.d.ts.map +0 -1
  447. package/dist/types/src/internal/object/typename.d.ts +0 -15
  448. package/dist/types/src/internal/object/typename.d.ts.map +0 -1
  449. package/dist/types/src/internal/object/version.d.ts.map +0 -1
  450. package/dist/types/src/internal/projection/compose.d.ts +0 -6
  451. package/dist/types/src/internal/projection/compose.d.ts.map +0 -1
  452. package/dist/types/src/internal/projection/compose.test.d.ts.map +0 -1
  453. package/dist/types/src/internal/projection/index.d.ts +0 -2
  454. package/dist/types/src/internal/projection/index.d.ts.map +0 -1
  455. package/dist/types/src/internal/proxy/reactive-object.d.ts +0 -15
  456. package/dist/types/src/internal/proxy/reactive-object.d.ts.map +0 -1
  457. package/dist/types/src/internal/query/index.d.ts +0 -2
  458. package/dist/types/src/internal/query/index.d.ts.map +0 -1
  459. package/dist/types/src/internal/query/query.d.ts +0 -17
  460. package/dist/types/src/internal/query/query.d.ts.map +0 -1
  461. package/dist/types/src/internal/schema/runtime-schema-registry.d.ts +0 -18
  462. package/dist/types/src/internal/schema/runtime-schema-registry.d.ts.map +0 -1
  463. package/dist/types/src/internal/schema/snapshot.d.ts +0 -6
  464. package/dist/types/src/internal/schema/snapshot.d.ts.map +0 -1
  465. package/dist/types/src/internal/schema/stored-schema.d.ts +0 -13
  466. package/dist/types/src/internal/schema/stored-schema.d.ts.map +0 -1
  467. package/dist/types/src/internal/testing/index.d.ts +0 -3
  468. package/dist/types/src/internal/testing/index.d.ts.map +0 -1
  469. package/dist/types/src/internal/testing/types.d.ts +0 -455
  470. package/dist/types/src/internal/testing/types.d.ts.map +0 -1
  471. package/dist/types/src/internal/testing/utils.d.ts +0 -10
  472. package/dist/types/src/internal/testing/utils.d.ts.map +0 -1
  473. package/dist/types/src/internal/types/types.d.ts +0 -79
  474. package/dist/types/src/internal/types/types.d.ts.map +0 -1
  475. package/dist/types/src/internal/types/types.test.d.ts +0 -2
  476. package/dist/types/src/internal/types/types.test.d.ts.map +0 -1
  477. package/dist/types/src/internal/types/util.d.ts +0 -5
  478. package/dist/types/src/internal/types/util.d.ts.map +0 -1
  479. package/dist/types/src/query/index.d.ts +0 -3
  480. package/dist/types/src/query/index.d.ts.map +0 -1
  481. package/dist/types/src/query/query.d.ts +0 -248
  482. package/dist/types/src/query/query.d.ts.map +0 -1
  483. package/dist/types/src/query/query.test.d.ts +0 -2
  484. package/dist/types/src/query/query.test.d.ts.map +0 -1
  485. package/dist/types/src/query/tag.d.ts +0 -17
  486. package/dist/types/src/query/tag.d.ts.map +0 -1
  487. package/dist/types/src/testing/echo-schema.d.ts +0 -7
  488. package/dist/types/src/testing/echo-schema.d.ts.map +0 -1
  489. package/dist/types/src/testing/types.d.ts +0 -113
  490. package/dist/types/src/testing/types.d.ts.map +0 -1
  491. package/src/errors.ts +0 -18
  492. package/src/internal/ast/annotation-helper.ts +0 -22
  493. package/src/internal/ast/annotations.ts +0 -219
  494. package/src/internal/ast/entity-kind.ts +0 -15
  495. package/src/internal/ast/index.ts +0 -8
  496. package/src/internal/ast/types.ts +0 -17
  497. package/src/internal/json/index.ts +0 -5
  498. package/src/internal/object/accessors.ts +0 -153
  499. package/src/internal/object/entity.ts +0 -248
  500. package/src/internal/object/expando.ts +0 -21
  501. package/src/internal/object/meta.ts +0 -61
  502. package/src/internal/object/model.ts +0 -170
  503. package/src/internal/object/relation.ts +0 -24
  504. package/src/internal/object/typename.ts +0 -61
  505. package/src/internal/object/version.ts +0 -22
  506. package/src/internal/projection/index.ts +0 -5
  507. package/src/internal/proxy/reactive-object.ts +0 -108
  508. package/src/internal/query/index.ts +0 -5
  509. package/src/internal/query/query.ts +0 -23
  510. package/src/internal/schema/runtime-schema-registry.ts +0 -78
  511. package/src/internal/schema/snapshot.ts +0 -25
  512. package/src/internal/schema/stored-schema.ts +0 -26
  513. package/src/internal/testing/index.ts +0 -6
  514. package/src/internal/testing/types.ts +0 -211
  515. package/src/internal/testing/utils.ts +0 -54
  516. package/src/internal/types/types.test.ts +0 -48
  517. package/src/internal/types/types.ts +0 -176
  518. package/src/internal/types/util.ts +0 -9
  519. package/src/query/index.ts +0 -6
  520. package/src/query/query.test.ts +0 -401
  521. package/src/query/query.ts +0 -789
  522. package/src/test/api.test.ts +0 -180
  523. package/src/testing/echo-schema.ts +0 -39
  524. package/src/testing/types.ts +0 -91
  525. /package/dist/lib/{browser/index.mjs.map → neutral/Annotation.mjs.map} +0 -0
  526. /package/dist/lib/{browser/internal/index.mjs.map → neutral/Database.mjs.map} +0 -0
  527. /package/dist/lib/{browser/query/index.mjs.map → neutral/Entity.mjs.map} +0 -0
  528. /package/dist/lib/{node-esm/index.mjs.map → neutral/Err.mjs.map} +0 -0
  529. /package/dist/lib/{node-esm/internal/index.mjs.map → neutral/Filter.mjs.map} +0 -0
  530. /package/dist/lib/{node-esm/query/index.mjs.map → neutral/Format.mjs.map} +0 -0
  531. /package/dist/types/src/internal/{ast → annotations}/annotations.test.d.ts +0 -0
  532. /package/dist/types/src/internal/{json → json-schema}/annotations.d.ts +0 -0
  533. /package/dist/types/src/internal/{json → json-schema}/effect-schema.test.d.ts +0 -0
  534. /package/dist/types/src/internal/{json → json-schema}/json-schema.test.d.ts +0 -0
  535. /package/dist/types/src/internal/{projection → schema}/compose.test.d.ts +0 -0
  536. /package/dist/types/src/{test → testing}/api.test.d.ts +0 -0
  537. /package/src/internal/{json → json-schema}/effect-schema.test.ts +0 -0
@@ -1,44 +1,74 @@
1
+ import * as Effect from 'effect/Effect';
2
+ import * as Option from 'effect/Option';
1
3
  import * as Schema from 'effect/Schema';
2
- import { type DXN } from '@dxos/keys';
3
- import * as LiveObject from '@dxos/live-object';
4
- import * as EchoSchema from './internal';
4
+ import type { ForeignKey } from '@dxos/echo-protocol';
5
+ import { type DXN, ObjectId } from '@dxos/keys';
6
+ import type * as Database from './Database';
7
+ import * as Entity from './Entity';
8
+ import * as Err from './Err';
9
+ import { type ObjectJSON as APIJSON, type AnyEntity, type AnyProperties, type Comparator as ApiComparator, type Meta as ApiMeta, type ReadonlyMeta as ApiReadonlyMeta, type EntityVersion as ApiVersion, type ChangeCallback, type KindId, type Mutable, type ObjectMeta, SnapshotKindId, type VersionCompareResult, VersionTypeId, compareVersions, decodeVersion, encodeVersion, isVersion, versionValid } from './internal';
5
10
  import type * as Ref from './Ref';
6
- import type * as Relation from './Relation';
7
- import * as Type from './Type';
11
+ import type * as Type from './Type';
8
12
  /**
9
- * NOTE: Don't export: Obj.Any and Obj.Obj form the public API.
13
+ * Base type for all ECHO objects.
10
14
  */
11
- interface BaseObj extends EchoSchema.HasId, Type.OfKind<EchoSchema.EntityKind.Object> {
15
+ interface BaseObj extends AnyEntity, Entity.OfKind<typeof Entity.Kind.Object> {
12
16
  }
13
17
  /**
14
18
  * Object type with specific properties.
15
19
  */
16
20
  export type Obj<Props> = BaseObj & Props;
17
21
  /**
18
- * Base type for all ECHO objects.
19
- * This type does not define any properties.
22
+ * Object with no known properties beyond id and kind.
23
+ * Use this when the object's schema/properties are not known.
24
+ * For objects with arbitrary properties, use `Obj.AnyProps`.
25
+ *
26
+ * NOTE: This is a TypeScript type only, not a schema.
27
+ * To validate that a value is an ECHO object, use `Schema.is(Type.Obj)`.
20
28
  */
21
- export interface Any extends BaseObj {
29
+ export interface Unknown extends BaseObj {
22
30
  }
23
31
  /**
24
32
  * Object with arbitrary properties.
25
33
  *
26
- * NOTE: Due to how typescript works, this type is not assignable to a specific schema type.
34
+ * NOTE: Due to how TypeScript works, this type is not assignable to a specific schema type.
27
35
  * In that case, use `Obj.instanceOf` to check if an object is of a specific type.
36
+ *
37
+ * Prefer using `Obj.Unknown` when you don't need to access arbitrary properties.
28
38
  */
29
- export interface AnyProps extends BaseObj {
30
- [key: string]: any;
39
+ export interface Any extends BaseObj, AnyProperties {
31
40
  }
32
- export declare const Any: Type.obj<Schema.Struct<{}>>;
41
+ /**
42
+ * Base type for snapshot objects (has SnapshotKindId instead of KindId).
43
+ */
44
+ interface BaseSnapshot extends AnyEntity {
45
+ readonly [SnapshotKindId]: typeof Entity.Kind.Object;
46
+ readonly id: ObjectId;
47
+ }
48
+ /**
49
+ * Immutable snapshot of an ECHO object.
50
+ * Branded with SnapshotKindId (not KindId).
51
+ * Property values are frozen at the time the snapshot was created.
52
+ * Returned by getSnapshot() and hooks like useObject().
53
+ *
54
+ * Snapshots are structurally identical to reactive objects but have a different brand,
55
+ * making them distinguishable at the TypeScript level. Neither is assignable to the other.
56
+ */
57
+ export type Snapshot<T extends Unknown = Unknown> = Omit<T, KindId> & BaseSnapshot;
33
58
  type Props<T = any> = {
34
- id?: EchoSchema.ObjectId;
59
+ id?: ObjectId;
60
+ [Meta]?: Partial<ObjectMeta>;
35
61
  } & Type.Properties<T>;
36
- export type MakeProps<T extends Type.Obj.Any> = NoInfer<Props<Schema.Schema.Type<T>>> & {
37
- [Meta]?: Partial<EchoSchema.ObjectMeta>;
38
- };
39
- export declare const Meta: unique symbol;
40
62
  /**
41
- * Creates new object.
63
+ * Props type for object creation with a given schema.
64
+ */
65
+ export type MakeProps<S extends Schema.Schema.AnyNoContext> = {
66
+ id?: ObjectId;
67
+ [Meta]?: Partial<ObjectMeta>;
68
+ [Parent]?: Unknown;
69
+ } & NoInfer<Props<Schema.Schema.Type<S>>>;
70
+ /**
71
+ * Creates a new echo object of the given schema.
42
72
  * @param schema - Object schema.
43
73
  * @param props - Object properties.
44
74
  * @param meta - Object metadata (deprecated) -- pass with Obj.Meta.
@@ -49,16 +79,178 @@ export declare const Meta: unique symbol;
49
79
  * ```ts
50
80
  * const obj = Obj.make(Person, { [Obj.Meta]: { keys: [...] }, name: 'John' });
51
81
  * ```
82
+ *
83
+ * Note: Only accepts object schemas, not relation schemas. Use `Relation.make` for relations.
84
+ */
85
+ export declare const make: {
86
+ <S extends Type.Obj.Any>(schema: S, props: MakeProps<S>): Obj<Schema.Schema.Type<S>>;
87
+ /**
88
+ * @deprecated Pass meta as in the example: `Obj.make(Person, { [Obj.Meta]: { keys: [...] }, name: 'John' })`.
89
+ */
90
+ <S extends Type.Obj.Any>(schema: S, props: MakeProps<S>, meta: Partial<ObjectMeta>): Obj<Schema.Schema.Type<S>>;
91
+ };
92
+ /**
93
+ * Determine if object is an ECHO object.
94
+ */
95
+ export declare const isObject: (obj: unknown) => obj is Unknown;
96
+ /**
97
+ * Subscribe to object updates.
98
+ * The callback is called synchronously when the object is modified.
99
+ * Only accepts reactive objects (not snapshots).
100
+ * @returns Unsubscribe function.
101
+ */
102
+ export declare const subscribe: (obj: Unknown, callback: () => void) => (() => void);
103
+ /**
104
+ * Returns an immutable snapshot of an object.
105
+ * The snapshot is branded with SnapshotKindId instead of KindId,
106
+ * making it distinguishable from the reactive object at the type level.
107
+ */
108
+ export declare const getSnapshot: <T extends Unknown>(obj: T) => Snapshot<T>;
109
+ /**
110
+ * Returns the reactive version of an object from the database, given its snapshot.
111
+ * Inverse of `Obj.getSnapshot`.
112
+ *
113
+ * Uses `Obj.getDatabase` internally to get the database from the snapshot,
114
+ * then resolves the reactive object by ID.
115
+ *
116
+ * @param snapshot - A snapshot of the object (from `Obj.getSnapshot`).
117
+ * @returns Effect that succeeds with the reactive object, or fails with `GetReactiveError`.
118
+ * @example
119
+ * ```ts
120
+ * const snapshot = Obj.getSnapshot(obj);
121
+ * const reactive = Obj.getReactive(snapshot).pipe(
122
+ * Effect.runSync
123
+ * );
124
+ * ```
125
+ */
126
+ export declare const getReactive: <T extends Unknown>(snapshot: Snapshot<T>) => Effect.Effect<T, Err.GetReactiveError>;
127
+ /**
128
+ * Like `Obj.getReactive` but returns `Option.none()` instead of failing when the object
129
+ * cannot be resolved (no database, object not found).
130
+ *
131
+ * @param snapshot - A snapshot of the object (from `Obj.getSnapshot`).
132
+ * @returns Effect that succeeds with `Option.some(reactive)` or `Option.none()`.
133
+ */
134
+ export declare const getReactiveOption: <T extends Unknown>(snapshot: Snapshot<T>) => Effect.Effect<Option.Option<T>, never>;
135
+ /**
136
+ * Synchronous version of `Obj.getReactive`. Returns the reactive object or throws
137
+ * `GetReactiveError` when the object cannot be resolved (no database, object not found).
138
+ *
139
+ * @param snapshot - A snapshot of the object (from `Obj.getSnapshot`).
140
+ * @returns The reactive object.
141
+ * @throws {Err.GetReactiveError} When the object cannot be resolved.
142
+ */
143
+ export declare const getReactiveOrThrow: <T extends Unknown>(snapshot: Snapshot<T>) => T;
144
+ export type CloneOptions = {
145
+ /**
146
+ * Retain the original object's ID.
147
+ * @default false
148
+ */
149
+ retainId?: boolean;
150
+ /**
151
+ * Recursively clone referenced objects.
152
+ * @default false
153
+ */
154
+ deep?: boolean;
155
+ };
156
+ /**
157
+ * Clones an object or relation.
158
+ * This does not clone referenced objects, only the properties in the object.
159
+ * @returns A new object with the same schema and properties.
160
+ */
161
+ export declare const clone: <T extends Unknown>(obj: T, opts?: CloneOptions) => T;
162
+ /**
163
+ * Makes all properties mutable recursively.
164
+ * Used to provide a mutable view of an object within `Obj.change`.
165
+ */
166
+ export type { Mutable };
167
+ /**
168
+ * Perform mutations on an echo object within a controlled context.
169
+ *
170
+ * All mutations within the callback are batched and trigger a single notification
171
+ * when the callback completes. Direct mutations outside of `Obj.change` will throw
172
+ * an error for echo objects.
173
+ *
174
+ * This function also works with nested objects within echo objects (e.g., Template structs)
175
+ * that are reactive at runtime.
176
+ *
177
+ * @param obj - The echo object to mutate. Use `Relation.change` for relations.
178
+ * @param callback - The callback that performs mutations on the object.
179
+ *
180
+ * @example
181
+ * ```ts
182
+ * const person = Obj.make(Person, { name: 'John', age: 25 });
183
+ *
184
+ * // Mutate within Obj.change
185
+ * Obj.change(person, (p) => {
186
+ * p.name = 'Jane';
187
+ * p.age = 30;
188
+ * });
189
+ * // ONE notification fires here
190
+ *
191
+ * // Direct mutation throws
192
+ * person.name = 'Bob'; // Error: Cannot modify outside Obj.change()
193
+ * ```
194
+ *
195
+ * Note: Only accepts objects. Use `Relation.change` for relations.
196
+ */
197
+ export declare const change: <T extends Unknown>(obj: T, callback: ChangeCallback<T>) => void;
198
+ /**
199
+ * Get a deeply nested property from an object.
200
+ *
201
+ * Similar to lodash.get and getDeep from @dxos/util.
202
+ * This is the complementary function to setValue.
203
+ * Accepts both reactive objects and snapshots.
204
+ *
205
+ * @param obj - The ECHO object to get the property from.
206
+ * @param path - Path to the property (array of keys).
207
+ * @returns The value at the path, or undefined if not found.
208
+ *
209
+ * @example
210
+ * ```ts
211
+ * const person = Obj.make(Person, {
212
+ * name: 'John',
213
+ * addresses: [{ street: '123 Main St' }]
214
+ * });
215
+ *
216
+ * Obj.getValue(person, ['addresses', 0, 'street']); // '123 Main St'
217
+ * Obj.getValue(person, ['addresses', 1, 'street']); // undefined
218
+ * ```
52
219
  */
53
- export declare const make: <S extends Type.Obj.Any>(schema: S, props: MakeProps<S>, meta?: Partial<EchoSchema.ObjectMeta>) => LiveObject.Live<Schema.Schema.Type<S>>;
54
- export declare const isObject: (obj: unknown) => obj is Any;
220
+ export declare const getValue: (obj: Unknown | Snapshot, path: readonly (string | number)[]) => any;
221
+ /**
222
+ * Set a deeply nested property on an object, using the object's schema to determine
223
+ * whether to initialize nested data as an empty object or array.
224
+ *
225
+ * Similar to lodash.set and setDeep from @dxos/util, but schema-aware.
226
+ * Must be called within an `Obj.change` callback.
227
+ *
228
+ * NOTE: TypeScript's structural typing allows readonly objects to be passed to `Mutable<T>`
229
+ * parameters, so there is no compile-time error. Enforcement is runtime-only.
230
+ *
231
+ * @param obj - The mutable ECHO object to set the property on.
232
+ * @param path - Path to the property (array of keys).
233
+ * @param value - Value to set.
234
+ * @returns The value that was set.
235
+ *
236
+ * @example
237
+ * ```ts
238
+ * const person = Obj.make(Person, { name: 'John' });
239
+ * // Person schema has: addresses: Schema.Array(Address)
240
+ * Obj.change(person, (p) => {
241
+ * Obj.setValue(p, ['addresses', 0, 'street'], '123 Main St');
242
+ * });
243
+ * // Creates: person.addresses = [{ street: '123 Main St' }]
244
+ * ```
245
+ */
246
+ export declare const setValue: (obj: Mutable<Unknown>, path: readonly (string | number)[], value: any) => void;
247
+ export declare const ID: import("@dxos/keys").ObjectIdClass;
248
+ export type ID = ObjectId;
55
249
  /**
56
250
  * Test if object or relation is an instance of a schema.
57
251
  * @example
58
252
  * ```ts
59
253
  * const john = Obj.make(Person, { name: 'John' });
60
- * const johnIsPerson = Obj.instanceOf(Person)(john);
61
- *
62
254
  * const isPerson = Obj.instanceOf(Person);
63
255
  * if (isPerson(john)) {
64
256
  * // john is Person
@@ -66,59 +258,185 @@ export declare const isObject: (obj: unknown) => obj is Any;
66
258
  * ```
67
259
  */
68
260
  export declare const instanceOf: {
69
- <S extends Type.Relation.Any | Type.Obj.Any>(schema: S): (value: unknown) => value is Schema.Schema.Type<S>;
70
- <S extends Type.Relation.Any | Type.Obj.Any>(schema: S, value: unknown): value is Schema.Schema.Type<S>;
261
+ <S extends Type.Entity.Any>(schema: S): (value: unknown) => value is Schema.Schema.Type<S>;
262
+ <S extends Type.Entity.Any>(schema: S, value: unknown): value is Schema.Schema.Type<S>;
71
263
  };
72
- export declare const getSchema: (obj: unknown | undefined) => Schema.Schema.AnyNoContext | undefined;
73
- export declare const getDXN: (obj: Any | Relation.Any) => DXN;
264
+ /**
265
+ * Test if a snapshot is an instance of a schema.
266
+ * Mirrors `instanceOf` but only accepts values branded with SnapshotKindId.
267
+ * Use when the value is known to be a snapshot (e.g. from `getSnapshot` or `useObject`).
268
+ *
269
+ * @example
270
+ * ```ts
271
+ * const snapshot = Obj.getSnapshot(person);
272
+ * if (Obj.snapshotOf(Person, snapshot)) {
273
+ * // snapshot is Obj.Snapshot<Person>
274
+ * }
275
+ * ```
276
+ */
277
+ export declare const snapshotOf: {
278
+ <S extends Type.Entity.Any>(schema: S): (value: unknown) => value is Snapshot<Schema.Schema.Type<S>>;
279
+ <S extends Type.Entity.Any>(schema: S, value: unknown): value is Snapshot<Schema.Schema.Type<S>>;
280
+ };
281
+ /**
282
+ * Get the DXN of the object.
283
+ * Accepts both reactive objects and snapshots.
284
+ */
285
+ export declare const getDXN: (entity: Unknown | Snapshot) => DXN;
74
286
  /**
75
287
  * @returns The DXN of the object's type.
76
- * @example dxn:example.com/type/Contact:1.0.0
288
+ * @example dxn:example.com/type/Person:1.0.0
289
+ */
290
+ export declare const getTypeDXN: (obj: unknown | undefined) => DXN | undefined;
291
+ /**
292
+ * Get the schema of the object.
293
+ * Returns the branded ECHO schema used to create the object.
77
294
  */
78
- export declare const getTypeDXN: (obj: EchoSchema.BaseObject) => DXN | undefined;
295
+ export declare const getSchema: (obj: unknown | undefined) => Type.Entity.Any | undefined;
79
296
  /**
80
297
  * @returns The typename of the object's type.
81
- * @example `example.com/type/Contact`
298
+ * Accepts both reactive objects and snapshots.
299
+ * @example `example.com/type/Person`
300
+ */
301
+ export declare const getTypename: (entity: Unknown | Snapshot) => string | undefined;
302
+ /**
303
+ * Get the database the object belongs to.
304
+ * Accepts both reactive objects and snapshots.
305
+ */
306
+ export declare const getDatabase: (entity: Entity.Unknown | Entity.Snapshot) => Database.Database | undefined;
307
+ export declare const Meta: unique symbol;
308
+ /**
309
+ * Deeply read-only version of ObjectMeta.
310
+ * Prevents mutation at all nesting levels (e.g., `meta.keys.push()` is a TypeScript error).
82
311
  */
83
- export declare const getTypename: (obj: Any | Relation.Any) => string | undefined;
84
- export declare const getMeta: (obj: Any | Relation.Any) => EchoSchema.ObjectMeta;
312
+ export type ReadonlyMeta = ApiReadonlyMeta;
313
+ /**
314
+ * Mutable meta type returned by `Obj.getMeta` inside an `Obj.change` callback.
315
+ */
316
+ export type Meta = ApiMeta;
317
+ /**
318
+ * Get the metadata for an object.
319
+ * Returns mutable meta when passed a mutable object (inside `Obj.change` callback).
320
+ * Returns read-only meta when passed a regular object or snapshot.
321
+ *
322
+ * @example
323
+ * ```ts
324
+ * // Read-only access outside change callback
325
+ * const meta = Obj.getMeta(person); // ReadonlyMeta
326
+ *
327
+ * // Mutable access inside change callback
328
+ * Obj.change(person, (p) => {
329
+ * const meta = Obj.getMeta(p); // ObjectMeta (mutable)
330
+ * meta.tags ??= [];
331
+ * meta.tags.push('important');
332
+ * });
333
+ * ```
334
+ */
335
+ export declare function getMeta(entity: Mutable<Unknown>): Meta;
336
+ export declare function getMeta(entity: Unknown | Snapshot): ReadonlyMeta;
85
337
  /**
86
338
  * @returns Foreign keys for the object from the specified source.
339
+ * Accepts both reactive objects and snapshots.
87
340
  */
88
341
  export declare const getKeys: {
89
- (obj: Any | Relation.Any, source: string): EchoSchema.ForeignKey[];
90
- (source: string): (obj: Any | Relation.Any) => EchoSchema.ForeignKey[];
342
+ (entity: Unknown | Snapshot, source: string): ForeignKey[];
343
+ (source: string): (entity: Unknown | Snapshot) => ForeignKey[];
91
344
  };
92
345
  /**
93
346
  * Delete all keys from the object for the specified source.
94
- * @param obj
95
- * @param source
96
- */
97
- export declare const deleteKeys: (obj: Any | Relation.Any, source: string) => void;
98
- export declare const isDeleted: (obj: Any | Relation.Any) => boolean;
99
- export declare const getLabel: (obj: Any | Relation.Any) => string | undefined;
100
- export declare const setLabel: (obj: Any | Relation.Any, label: string) => void;
101
- export declare const getDescription: (obj: Any | Relation.Any) => string | undefined;
102
- export declare const setDescription: (obj: Any | Relation.Any, description: string) => void;
103
- export type Comparator = (a: Any, b: Any) => number;
104
- export declare const sortByLabel: Comparator;
105
- export declare const sortByTypename: Comparator;
106
- export declare const sort: (...comparators: Comparator[]) => Comparator;
347
+ * Must be called within an `Obj.change` callback.
348
+ *
349
+ * NOTE: TypeScript's structural typing allows readonly objects to be passed to `Mutable<T>`
350
+ * parameters, so there is no compile-time error. Enforcement is runtime-only.
351
+ */
352
+ export declare const deleteKeys: (entity: Mutable<Unknown>, source: string) => void;
353
+ /**
354
+ * Add a tag to the object.
355
+ * Must be called within an `Obj.change` callback.
356
+ *
357
+ * NOTE: TypeScript's structural typing allows readonly objects to be passed to `Mutable<T>`
358
+ * parameters, so there is no compile-time error. Enforcement is runtime-only.
359
+ */
360
+ export declare const addTag: (entity: Mutable<Unknown>, tag: string) => void;
361
+ /**
362
+ * Remove a tag from the object.
363
+ * Must be called within an `Obj.change` callback.
364
+ *
365
+ * NOTE: TypeScript's structural typing allows readonly objects to be passed to `Mutable<T>`
366
+ * parameters, so there is no compile-time error. Enforcement is runtime-only.
367
+ */
368
+ export declare const removeTag: (entity: Mutable<Unknown>, tag: string) => void;
369
+ /**
370
+ * Check if the object is deleted.
371
+ * Accepts both reactive objects and snapshots.
372
+ */
373
+ export declare const isDeleted: (entity: Unknown | Snapshot) => boolean;
374
+ /**
375
+ * Get the label of the object.
376
+ * Accepts both reactive objects and snapshots.
377
+ */
378
+ export declare const getLabel: (entity: Unknown | Snapshot) => string | undefined;
379
+ /**
380
+ * Set the label of the object.
381
+ * Must be called within an `Obj.change` callback.
382
+ *
383
+ * NOTE: TypeScript's structural typing allows readonly objects to be passed to `Mutable<T>`
384
+ * parameters, so there is no compile-time error. Enforcement is runtime-only.
385
+ */
386
+ export declare const setLabel: (entity: Mutable<Unknown>, label: string) => void;
387
+ /**
388
+ * Get the description of the object.
389
+ * Accepts both reactive objects and snapshots.
390
+ */
391
+ export declare const getDescription: (entity: Unknown | Snapshot) => string | undefined;
392
+ /**
393
+ * Set the description of the object.
394
+ * Must be called within an `Obj.change` callback.
395
+ *
396
+ * NOTE: TypeScript's structural typing allows readonly objects to be passed to `Mutable<T>`
397
+ * parameters, so there is no compile-time error. Enforcement is runtime-only.
398
+ */
399
+ export declare const setDescription: (entity: Mutable<Unknown>, description: string) => void;
400
+ /**
401
+ * Symbol to set parent when creating objects with `Obj.make`.
402
+ * @example
403
+ * ```ts
404
+ * Obj.make(TestSchema.Person, {
405
+ * [Obj.Parent]: parentObject,
406
+ * name: 'John',
407
+ * })
408
+ * ```
409
+ */
410
+ export declare const Parent: unique symbol;
411
+ /**
412
+ * Get the parent of an object.
413
+ * The parent is always loaded together with the object.
414
+ * Only objects are allowed to have a parent
415
+ * @returns The parent object, or undefined if the object has no parent.
416
+ */
417
+ export declare const getParent: (entity: Unknown | Snapshot) => Unknown | undefined;
418
+ /**
419
+ * Sets the parent of an object.
420
+ * If a parent (or any transitive parent) is deleted, the object will be deleted.
421
+ * Only objects are allowed to have a parent.
422
+ */
423
+ export declare const setParent: (entity: Unknown, parent: Any | undefined) => void;
107
424
  /**
108
425
  * JSON representation of an object.
109
426
  */
110
- export type JSON = EchoSchema.ObjectJSON;
427
+ export type JSON = APIJSON;
111
428
  /**
112
429
  * Converts object to its JSON representation.
430
+ * Accepts both reactive objects and snapshots.
113
431
  *
114
432
  * The same algorithm is used when calling the standard `JSON.stringify(obj)` function.
115
433
  */
116
- export declare const toJSON: (obj: Any | Relation.Any) => JSON;
434
+ export declare const toJSON: (entity: Unknown | Snapshot) => JSON;
117
435
  /**
118
436
  * Creates an object from its json representation, performing schema validation.
119
437
  * References and schemas will be resolvable if the `refResolver` is provided.
120
438
  *
121
- * The function need to be async to support resolving the schema as well as the relation endpoints.
439
+ * The function must be async to support resolving the schema as well as the relation endpoints.
122
440
  *
123
441
  * @param options.refResolver - Resolver for references. Produces hydrated references that can be resolved.
124
442
  * @param options.dxn - Override object DXN. Changes the result of `Obj.getDXN`.
@@ -126,62 +444,27 @@ export declare const toJSON: (obj: Any | Relation.Any) => JSON;
126
444
  export declare const fromJSON: (json: unknown, options?: {
127
445
  refResolver?: Ref.Resolver;
128
446
  dxn?: DXN;
129
- }) => Promise<Any>;
130
- /**
131
- * Returns an immutable snapshot of an object.
132
- */
133
- export declare const getSnapshot: <T extends Any>(obj: Obj<T>) => T;
134
- export type CloneOptions = {
135
- /**
136
- * Retain the original object's ID.
137
- * @default false
138
- */
139
- retainId?: boolean;
140
- };
447
+ }) => Promise<Unknown>;
141
448
  /**
142
- * Clones an object or relation.
143
- * This does not clone referenced objects, only the properties in the object.
144
- * @returns A new object with the same schema and properties.
449
+ * Comparator function type for sorting objects.
450
+ * Accepts both reactive objects and snapshots.
145
451
  */
146
- export declare const clone: <T extends Any | Relation.Any>(obj: T, opts?: CloneOptions) => T;
147
- export declare const VersionTypeId: symbol;
148
- export type VersionType = typeof VersionTypeId;
452
+ export type Comparator = ApiComparator<Unknown | Snapshot>;
453
+ export declare const sortByLabel: Comparator;
454
+ export declare const sortByTypename: Comparator;
455
+ export declare const sort: (...comparators: Comparator[]) => Comparator;
456
+ export { VersionTypeId };
457
+ export type { VersionCompareResult };
149
458
  /**
150
459
  * Represent object version.
151
460
  * May be backed by Automerge.
152
461
  * Objects with no history are not versioned.
153
462
  */
154
- export interface Version {
155
- /**
156
- * Whether the object is versioned.
157
- */
158
- versioned: boolean;
159
- /**
160
- * Automerge heads.
161
- */
162
- automergeHeads?: string[];
163
- }
164
- /**
165
- * Checks that `obj` is a version object.
166
- */
167
- export declare const isVersion: (obj: unknown) => obj is Version;
463
+ export type Version = ApiVersion;
464
+ export { isVersion, versionValid, compareVersions, encodeVersion, decodeVersion };
168
465
  /**
169
466
  * Returns the version of the object.
467
+ * Accepts both reactive objects and snapshots.
170
468
  */
171
- export declare const version: (obj: Any | Relation.Any) => Version;
172
- /**
173
- * Checks that `version` is a valid version object.
174
- */
175
- export declare const versionValid: (version: Version) => boolean;
176
- export type VersionCompareResult = 'unversioned' | 'equal' | 'different';
177
- /**
178
- * Compares two versions.
179
- * @param version1
180
- * @param version2
181
- * @returns 'unversioned' if either object is unversioned, 'equal' if the versions are equal, 'different' if the versions are different.
182
- */
183
- export declare const compareVersions: (version1: Version, version2: Version) => VersionCompareResult;
184
- export declare const encodeVersion: (version: Version) => string;
185
- export declare const decodeVersion: (version: string) => Version;
186
- export {};
469
+ export declare const version: (entity: Unknown | Snapshot) => Version;
187
470
  //# sourceMappingURL=Obj.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"Obj.d.ts","sourceRoot":"","sources":["../../../src/Obj.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Obj.d.ts","sourceRoot":"","sources":["../../../src/Obj.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=Obj.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Obj.test.d.ts","sourceRoot":"","sources":["../../../src/Obj.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,16 @@
1
+ import { type QueryAST } from '@dxos/echo-protocol';
2
+ export interface Order<T> {
3
+ '~Order': {
4
+ value: T;
5
+ };
6
+ ast: QueryAST.Order;
7
+ }
8
+ export type Any = Order<any>;
9
+ export declare const natural: Order<any>;
10
+ export declare const property: <T>(property: keyof T & string, direction: QueryAST.OrderDirection) => Order<T>;
11
+ /**
12
+ * Order by relevance rank (for FTS/vector search results).
13
+ * Higher rank = better match. Default direction is 'desc' (best matches first).
14
+ */
15
+ export declare const rank: <T>(direction?: QueryAST.OrderDirection) => Order<T>;
16
+ //# sourceMappingURL=Order.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Order.d.ts","sourceRoot":"","sources":["../../../src/Order.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,KAAK,CAAC,CAAC;IAEtB,QAAQ,EAAE;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC;IAEvB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC;CACrB;AAED,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAc7B,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,GAAG,CAAuC,CAAC;AACvE,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,UAAU,MAAM,CAAC,GAAG,MAAM,EAAE,WAAW,QAAQ,CAAC,cAAc,KAAG,KAAK,CAAC,CAAC,CAKhG,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,YAAW,QAAQ,CAAC,cAAuB,KAAG,KAAK,CAAC,CAAC,CAIzE,CAAC"}