@dxos/echo 0.8.4-main.f9ba587 → 0.8.4-main.fcfe5033a5

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 (527) hide show
  1. package/README.md +4 -5
  2. package/dist/lib/neutral/Annotation.mjs +37 -0
  3. package/dist/lib/neutral/Database.mjs +49 -0
  4. package/dist/lib/neutral/Entity.mjs +59 -0
  5. package/dist/lib/neutral/Entity.mjs.map +7 -0
  6. package/dist/lib/neutral/Err.mjs +12 -0
  7. package/dist/lib/neutral/Err.mjs.map +7 -0
  8. package/dist/lib/neutral/Extension.mjs +18 -0
  9. package/dist/lib/neutral/Extension.mjs.map +7 -0
  10. package/dist/lib/neutral/Feed.mjs +50 -0
  11. package/dist/lib/neutral/Feed.mjs.map +7 -0
  12. package/dist/lib/neutral/Filter.mjs +72 -0
  13. package/dist/lib/neutral/Filter.mjs.map +7 -0
  14. package/dist/lib/neutral/Format.mjs +66 -0
  15. package/dist/lib/neutral/Format.mjs.map +7 -0
  16. package/dist/lib/neutral/JsonSchema.mjs +19 -0
  17. package/dist/lib/neutral/JsonSchema.mjs.map +7 -0
  18. package/dist/lib/neutral/Key.mjs +12 -0
  19. package/dist/lib/neutral/Key.mjs.map +7 -0
  20. package/dist/lib/neutral/Migration.mjs +17 -0
  21. package/dist/lib/neutral/Migration.mjs.map +7 -0
  22. package/dist/lib/neutral/Obj.mjs +113 -0
  23. package/dist/lib/neutral/Obj.mjs.map +7 -0
  24. package/dist/lib/neutral/Order.mjs +12 -0
  25. package/dist/lib/neutral/Order.mjs.map +7 -0
  26. package/dist/lib/neutral/Query.mjs +38 -0
  27. package/dist/lib/neutral/Query.mjs.map +7 -0
  28. package/dist/lib/neutral/QueryResult.mjs +2 -0
  29. package/dist/lib/neutral/QueryResult.mjs.map +7 -0
  30. package/dist/lib/neutral/Ref.mjs +24 -0
  31. package/dist/lib/neutral/Ref.mjs.map +7 -0
  32. package/dist/lib/neutral/Relation.mjs +94 -0
  33. package/dist/lib/neutral/Relation.mjs.map +7 -0
  34. package/dist/lib/neutral/SchemaRegistry.mjs +2 -0
  35. package/dist/lib/neutral/SchemaRegistry.mjs.map +7 -0
  36. package/dist/lib/neutral/Tag.mjs +29 -0
  37. package/dist/lib/neutral/Tag.mjs.map +7 -0
  38. package/dist/lib/neutral/Type.mjs +37 -0
  39. package/dist/lib/neutral/Type.mjs.map +7 -0
  40. package/dist/lib/neutral/chunk-2DJT26P7.mjs +286 -0
  41. package/dist/lib/neutral/chunk-2DJT26P7.mjs.map +7 -0
  42. package/dist/lib/neutral/chunk-3Y6LSSJR.mjs +132 -0
  43. package/dist/lib/neutral/chunk-3Y6LSSJR.mjs.map +7 -0
  44. package/dist/lib/neutral/chunk-4U7YKZUA.mjs +361 -0
  45. package/dist/lib/neutral/chunk-4U7YKZUA.mjs.map +7 -0
  46. package/dist/lib/neutral/chunk-6ZQHG2VX.mjs +27 -0
  47. package/dist/lib/neutral/chunk-6ZQHG2VX.mjs.map +7 -0
  48. package/dist/lib/neutral/chunk-ANHVGJI4.mjs +21 -0
  49. package/dist/lib/neutral/chunk-ANHVGJI4.mjs.map +7 -0
  50. package/dist/lib/neutral/chunk-B4NP3BY3.mjs +299 -0
  51. package/dist/lib/neutral/chunk-B4NP3BY3.mjs.map +7 -0
  52. package/dist/lib/neutral/chunk-BNCCGLJN.mjs +7 -0
  53. package/dist/lib/neutral/chunk-BNCCGLJN.mjs.map +7 -0
  54. package/dist/lib/neutral/chunk-DQYLD2RB.mjs +402 -0
  55. package/dist/lib/neutral/chunk-DQYLD2RB.mjs.map +7 -0
  56. package/dist/lib/neutral/chunk-F7EQRJWJ.mjs +56 -0
  57. package/dist/lib/neutral/chunk-F7EQRJWJ.mjs.map +7 -0
  58. package/dist/lib/neutral/chunk-GMAUO3CE.mjs +45 -0
  59. package/dist/lib/neutral/chunk-GMAUO3CE.mjs.map +7 -0
  60. package/dist/lib/neutral/chunk-GZQTCRJB.mjs +73 -0
  61. package/dist/lib/neutral/chunk-GZQTCRJB.mjs.map +7 -0
  62. package/dist/lib/neutral/chunk-HQSGCJPL.mjs +136 -0
  63. package/dist/lib/neutral/chunk-HQSGCJPL.mjs.map +7 -0
  64. package/dist/lib/neutral/chunk-IKAO54M4.mjs +121 -0
  65. package/dist/lib/neutral/chunk-IKAO54M4.mjs.map +7 -0
  66. package/dist/lib/neutral/chunk-J5LGTIGS.mjs +10 -0
  67. package/dist/lib/neutral/chunk-J5LGTIGS.mjs.map +7 -0
  68. package/dist/lib/neutral/chunk-LLK3YB3N.mjs +2834 -0
  69. package/dist/lib/neutral/chunk-LLK3YB3N.mjs.map +7 -0
  70. package/dist/lib/neutral/chunk-LSMJDE57.mjs +415 -0
  71. package/dist/lib/neutral/chunk-LSMJDE57.mjs.map +7 -0
  72. package/dist/lib/neutral/chunk-LZR62GOA.mjs +34 -0
  73. package/dist/lib/neutral/chunk-LZR62GOA.mjs.map +7 -0
  74. package/dist/lib/neutral/chunk-OMUPQMLR.mjs +7 -0
  75. package/dist/lib/neutral/chunk-OMUPQMLR.mjs.map +7 -0
  76. package/dist/lib/neutral/chunk-OX5WOJZ2.mjs +97 -0
  77. package/dist/lib/neutral/chunk-OX5WOJZ2.mjs.map +7 -0
  78. package/dist/lib/neutral/chunk-SRYQFSA4.mjs +396 -0
  79. package/dist/lib/neutral/chunk-SRYQFSA4.mjs.map +7 -0
  80. package/dist/lib/neutral/chunk-SZJKLCFE.mjs +787 -0
  81. package/dist/lib/neutral/chunk-SZJKLCFE.mjs.map +7 -0
  82. package/dist/lib/neutral/chunk-TBKX6JQO.mjs +67 -0
  83. package/dist/lib/neutral/chunk-TBKX6JQO.mjs.map +7 -0
  84. package/dist/lib/neutral/chunk-UBEZSGXY.mjs +51 -0
  85. package/dist/lib/neutral/chunk-UBEZSGXY.mjs.map +7 -0
  86. package/dist/lib/neutral/chunk-UI6MWK5W.mjs +42 -0
  87. package/dist/lib/neutral/chunk-UI6MWK5W.mjs.map +7 -0
  88. package/dist/lib/neutral/chunk-WABNQYKV.mjs +45 -0
  89. package/dist/lib/neutral/chunk-WABNQYKV.mjs.map +7 -0
  90. package/dist/lib/neutral/chunk-WOEEIQWU.mjs +159 -0
  91. package/dist/lib/neutral/chunk-WOEEIQWU.mjs.map +7 -0
  92. package/dist/lib/neutral/chunk-XL5OYQ4X.mjs +354 -0
  93. package/dist/lib/neutral/chunk-XL5OYQ4X.mjs.map +7 -0
  94. package/dist/lib/neutral/chunk-YP4SEMT6.mjs +36 -0
  95. package/dist/lib/neutral/chunk-YP4SEMT6.mjs.map +7 -0
  96. package/dist/lib/neutral/chunk-YS6Q3XAD.mjs +50 -0
  97. package/dist/lib/neutral/chunk-YS6Q3XAD.mjs.map +7 -0
  98. package/dist/lib/neutral/index.mjs +105 -0
  99. package/dist/lib/neutral/index.mjs.map +7 -0
  100. package/dist/lib/neutral/internal/index.mjs +474 -0
  101. package/dist/lib/neutral/internal/index.mjs.map +7 -0
  102. package/dist/lib/neutral/meta.json +1 -0
  103. package/dist/lib/neutral/testing/index.mjs +375 -0
  104. package/dist/lib/neutral/testing/index.mjs.map +7 -0
  105. package/dist/types/src/Annotation.d.ts +24 -0
  106. package/dist/types/src/Annotation.d.ts.map +1 -0
  107. package/dist/types/src/Collection.d.ts +16 -0
  108. package/dist/types/src/Collection.d.ts.map +1 -0
  109. package/dist/types/src/Database.d.ts +201 -0
  110. package/dist/types/src/Database.d.ts.map +1 -0
  111. package/dist/types/src/Dataset.d.ts +19 -0
  112. package/dist/types/src/Dataset.d.ts.map +1 -0
  113. package/dist/types/src/Entity.d.ts +168 -0
  114. package/dist/types/src/Entity.d.ts.map +1 -0
  115. package/dist/types/src/Entity.test.d.ts +2 -0
  116. package/dist/types/src/Entity.test.d.ts.map +1 -0
  117. package/dist/types/src/Err.d.ts +107 -0
  118. package/dist/types/src/Err.d.ts.map +1 -0
  119. package/dist/types/src/Extension.d.ts +80 -0
  120. package/dist/types/src/Extension.d.ts.map +1 -0
  121. package/dist/types/src/Extension.test.d.ts +2 -0
  122. package/dist/types/src/Extension.test.d.ts.map +1 -0
  123. package/dist/types/src/Feed.d.ts +182 -0
  124. package/dist/types/src/Feed.d.ts.map +1 -0
  125. package/dist/types/src/Filter.d.ts +149 -0
  126. package/dist/types/src/Filter.d.ts.map +1 -0
  127. package/dist/types/src/Filter.test.d.ts +2 -0
  128. package/dist/types/src/Filter.test.d.ts.map +1 -0
  129. package/dist/types/src/Format.d.ts +4 -0
  130. package/dist/types/src/Format.d.ts.map +1 -0
  131. package/dist/types/src/Hypergraph.d.ts +65 -0
  132. package/dist/types/src/Hypergraph.d.ts.map +1 -0
  133. package/dist/types/src/JsonSchema.d.ts +16 -0
  134. package/dist/types/src/JsonSchema.d.ts.map +1 -0
  135. package/dist/types/src/Key.d.ts +1 -0
  136. package/dist/types/src/Key.d.ts.map +1 -1
  137. package/dist/types/src/Migration.d.ts +57 -0
  138. package/dist/types/src/Migration.d.ts.map +1 -0
  139. package/dist/types/src/Obj.d.ts +473 -35
  140. package/dist/types/src/Obj.d.ts.map +1 -1
  141. package/dist/types/src/Obj.test.d.ts +2 -0
  142. package/dist/types/src/Obj.test.d.ts.map +1 -0
  143. package/dist/types/src/Order.d.ts +16 -0
  144. package/dist/types/src/Order.d.ts.map +1 -0
  145. package/dist/types/src/Query.d.ts +209 -0
  146. package/dist/types/src/Query.d.ts.map +1 -0
  147. package/dist/types/src/Query.test.d.ts +2 -0
  148. package/dist/types/src/Query.test.d.ts.map +1 -0
  149. package/dist/types/src/QueryResult.d.ts +80 -0
  150. package/dist/types/src/QueryResult.d.ts.map +1 -0
  151. package/dist/types/src/Ref.d.ts +61 -11
  152. package/dist/types/src/Ref.d.ts.map +1 -1
  153. package/dist/types/src/Relation.d.ts +290 -21
  154. package/dist/types/src/Relation.d.ts.map +1 -1
  155. package/dist/types/src/Relation.test.d.ts +2 -0
  156. package/dist/types/src/Relation.test.d.ts.map +1 -0
  157. package/dist/types/src/SchemaRegistry.d.ts +84 -0
  158. package/dist/types/src/SchemaRegistry.d.ts.map +1 -0
  159. package/dist/types/src/Tag.d.ts +18 -0
  160. package/dist/types/src/Tag.d.ts.map +1 -0
  161. package/dist/types/src/Type.d.ts +123 -100
  162. package/dist/types/src/Type.d.ts.map +1 -1
  163. package/dist/types/src/Type.test.d.ts +2 -0
  164. package/dist/types/src/Type.test.d.ts.map +1 -0
  165. package/dist/types/src/View.d.ts +68 -0
  166. package/dist/types/src/View.d.ts.map +1 -0
  167. package/dist/types/src/hierarchy.test.d.ts +2 -0
  168. package/dist/types/src/hierarchy.test.d.ts.map +1 -0
  169. package/dist/types/src/index.d.ts +21 -3
  170. package/dist/types/src/index.d.ts.map +1 -1
  171. package/dist/types/src/internal/Annotation/annotations.d.ts +231 -0
  172. package/dist/types/src/internal/Annotation/annotations.d.ts.map +1 -0
  173. package/dist/types/src/internal/Annotation/annotations.test.d.ts +2 -0
  174. package/dist/types/src/internal/Annotation/annotations.test.d.ts.map +1 -0
  175. package/dist/types/src/internal/Annotation/index.d.ts +4 -0
  176. package/dist/types/src/internal/Annotation/index.d.ts.map +1 -0
  177. package/dist/types/src/internal/Annotation/sorting.d.ts +24 -0
  178. package/dist/types/src/internal/Annotation/sorting.d.ts.map +1 -0
  179. package/dist/types/src/internal/Annotation/util.d.ts +39 -0
  180. package/dist/types/src/internal/Annotation/util.d.ts.map +1 -0
  181. package/dist/types/src/internal/Entity/api.d.ts +13 -0
  182. package/dist/types/src/internal/Entity/api.d.ts.map +1 -0
  183. package/dist/types/src/internal/Entity/entity.d.ts +20 -0
  184. package/dist/types/src/internal/Entity/entity.d.ts.map +1 -0
  185. package/dist/types/src/internal/Entity/index.d.ts +8 -0
  186. package/dist/types/src/internal/Entity/index.d.ts.map +1 -0
  187. package/dist/types/src/internal/Entity/model.d.ts +55 -0
  188. package/dist/types/src/internal/Entity/model.d.ts.map +1 -0
  189. package/dist/types/src/internal/Entity/object.d.ts +18 -0
  190. package/dist/types/src/internal/Entity/object.d.ts.map +1 -0
  191. package/dist/types/src/internal/Entity/relation.d.ts +35 -0
  192. package/dist/types/src/internal/Entity/relation.d.ts.map +1 -0
  193. package/dist/types/src/internal/Entity/util.d.ts +2 -0
  194. package/dist/types/src/internal/Entity/util.d.ts.map +1 -0
  195. package/dist/types/src/internal/Entity/version.d.ts +42 -0
  196. package/dist/types/src/internal/Entity/version.d.ts.map +1 -0
  197. package/dist/types/src/internal/Format/date.d.ts +63 -0
  198. package/dist/types/src/internal/Format/date.d.ts.map +1 -0
  199. package/dist/types/src/internal/Format/date.test.d.ts +2 -0
  200. package/dist/types/src/internal/Format/date.test.d.ts.map +1 -0
  201. package/dist/types/src/internal/Format/format.d.ts +32 -0
  202. package/dist/types/src/internal/Format/format.d.ts.map +1 -0
  203. package/dist/types/src/internal/Format/format.test.d.ts +2 -0
  204. package/dist/types/src/internal/Format/format.test.d.ts.map +1 -0
  205. package/dist/types/src/internal/Format/index.d.ts +8 -0
  206. package/dist/types/src/internal/Format/index.d.ts.map +1 -0
  207. package/dist/types/src/internal/Format/number.d.ts +31 -0
  208. package/dist/types/src/internal/Format/number.d.ts.map +1 -0
  209. package/dist/types/src/internal/Format/object.d.ts +35 -0
  210. package/dist/types/src/internal/Format/object.d.ts.map +1 -0
  211. package/dist/types/src/internal/Format/select.d.ts +13 -0
  212. package/dist/types/src/internal/Format/select.d.ts.map +1 -0
  213. package/dist/types/src/internal/Format/string.d.ts +42 -0
  214. package/dist/types/src/internal/Format/string.d.ts.map +1 -0
  215. package/dist/types/src/internal/Format/types.d.ts +72 -0
  216. package/dist/types/src/internal/Format/types.d.ts.map +1 -0
  217. package/dist/types/src/internal/JsonSchema/annotations.d.ts +19 -0
  218. package/dist/types/src/internal/JsonSchema/annotations.d.ts.map +1 -0
  219. package/dist/types/src/internal/JsonSchema/effect-schema.test.d.ts +2 -0
  220. package/dist/types/src/internal/JsonSchema/effect-schema.test.d.ts.map +1 -0
  221. package/dist/types/src/internal/JsonSchema/index.d.ts +5 -0
  222. package/dist/types/src/internal/JsonSchema/index.d.ts.map +1 -0
  223. package/dist/types/src/internal/JsonSchema/json-schema-normalize.d.ts +7 -0
  224. package/dist/types/src/internal/JsonSchema/json-schema-normalize.d.ts.map +1 -0
  225. package/dist/types/src/internal/JsonSchema/json-schema-type.d.ts +351 -0
  226. package/dist/types/src/internal/JsonSchema/json-schema-type.d.ts.map +1 -0
  227. package/dist/types/src/internal/JsonSchema/json-schema.d.ts +30 -0
  228. package/dist/types/src/internal/JsonSchema/json-schema.d.ts.map +1 -0
  229. package/dist/types/src/internal/JsonSchema/json-schema.test.d.ts +2 -0
  230. package/dist/types/src/internal/JsonSchema/json-schema.test.d.ts.map +1 -0
  231. package/dist/types/src/internal/Obj/clone.d.ts +8 -0
  232. package/dist/types/src/internal/Obj/clone.d.ts.map +1 -0
  233. package/dist/types/src/internal/Obj/common.d.ts +18 -0
  234. package/dist/types/src/internal/Obj/common.d.ts.map +1 -0
  235. package/dist/types/src/internal/Obj/create-object.d.ts +39 -0
  236. package/dist/types/src/internal/Obj/create-object.d.ts.map +1 -0
  237. package/dist/types/src/internal/Obj/create-object.test.d.ts +2 -0
  238. package/dist/types/src/internal/Obj/create-object.test.d.ts.map +1 -0
  239. package/dist/types/src/internal/Obj/deleted.d.ts +6 -0
  240. package/dist/types/src/internal/Obj/deleted.d.ts.map +1 -0
  241. package/dist/types/src/internal/Obj/ids.d.ts +6 -0
  242. package/dist/types/src/internal/Obj/ids.d.ts.map +1 -0
  243. package/dist/types/src/internal/Obj/index.d.ts +11 -0
  244. package/dist/types/src/internal/Obj/index.d.ts.map +1 -0
  245. package/dist/types/src/internal/Obj/inspect.d.ts +2 -0
  246. package/dist/types/src/internal/Obj/inspect.d.ts.map +1 -0
  247. package/dist/types/src/internal/Obj/json-serializer.d.ts +45 -0
  248. package/dist/types/src/internal/Obj/json-serializer.d.ts.map +1 -0
  249. package/dist/types/src/internal/Obj/json-serializer.test.d.ts +2 -0
  250. package/dist/types/src/internal/Obj/json-serializer.test.d.ts.map +1 -0
  251. package/dist/types/src/internal/Obj/schema-validator.d.ts +2 -0
  252. package/dist/types/src/internal/Obj/schema-validator.d.ts.map +1 -0
  253. package/dist/types/src/internal/Obj/schema-validator.test.d.ts +2 -0
  254. package/dist/types/src/internal/Obj/schema-validator.test.d.ts.map +1 -0
  255. package/dist/types/src/internal/Obj/set-value.d.ts +7 -0
  256. package/dist/types/src/internal/Obj/set-value.d.ts.map +1 -0
  257. package/dist/types/src/internal/Obj/set-value.test.d.ts +2 -0
  258. package/dist/types/src/internal/Obj/set-value.test.d.ts.map +1 -0
  259. package/dist/types/src/internal/Obj/snapshot.d.ts +6 -0
  260. package/dist/types/src/internal/Obj/snapshot.d.ts.map +1 -0
  261. package/dist/types/src/internal/Obj/typed-object.d.ts +25 -0
  262. package/dist/types/src/internal/Obj/typed-object.d.ts.map +1 -0
  263. package/dist/types/src/internal/Obj/typed-object.test.d.ts +2 -0
  264. package/dist/types/src/internal/Obj/typed-object.test.d.ts.map +1 -0
  265. package/dist/types/src/internal/Query.d.ts +10 -0
  266. package/dist/types/src/internal/Query.d.ts.map +1 -0
  267. package/dist/types/src/internal/Ref/index.d.ts +3 -0
  268. package/dist/types/src/internal/Ref/index.d.ts.map +1 -0
  269. package/dist/types/src/internal/Ref/ref-array.d.ts +21 -0
  270. package/dist/types/src/internal/Ref/ref-array.d.ts.map +1 -0
  271. package/dist/types/src/internal/Ref/ref.d.ts +231 -0
  272. package/dist/types/src/internal/Ref/ref.d.ts.map +1 -0
  273. package/dist/types/src/internal/Ref/ref.test.d.ts +2 -0
  274. package/dist/types/src/internal/Ref/ref.test.d.ts.map +1 -0
  275. package/dist/types/src/internal/Type/compose.d.ts +7 -0
  276. package/dist/types/src/internal/Type/compose.d.ts.map +1 -0
  277. package/dist/types/src/internal/Type/compose.test.d.ts +2 -0
  278. package/dist/types/src/internal/Type/compose.test.d.ts.map +1 -0
  279. package/dist/types/src/internal/Type/echo-schema.d.ts +181 -0
  280. package/dist/types/src/internal/Type/echo-schema.d.ts.map +1 -0
  281. package/dist/types/src/internal/Type/index.d.ts +4 -0
  282. package/dist/types/src/internal/Type/index.d.ts.map +1 -0
  283. package/dist/types/src/internal/Type/manipulation.d.ts +10 -0
  284. package/dist/types/src/internal/Type/manipulation.d.ts.map +1 -0
  285. package/dist/types/src/internal/Type/persistent-schema.d.ts +20 -0
  286. package/dist/types/src/internal/Type/persistent-schema.d.ts.map +1 -0
  287. package/dist/types/src/internal/common/api/index.d.ts +11 -0
  288. package/dist/types/src/internal/common/api/index.d.ts.map +1 -0
  289. package/dist/types/src/internal/common/api/meta.d.ts +42 -0
  290. package/dist/types/src/internal/common/api/meta.d.ts.map +1 -0
  291. package/dist/types/src/internal/common/index.d.ts +4 -0
  292. package/dist/types/src/internal/common/index.d.ts.map +1 -0
  293. package/dist/types/src/internal/common/proxy/change-context.d.ts +55 -0
  294. package/dist/types/src/internal/common/proxy/change-context.d.ts.map +1 -0
  295. package/dist/types/src/internal/common/proxy/change.test.d.ts +2 -0
  296. package/dist/types/src/internal/common/proxy/change.test.d.ts.map +1 -0
  297. package/dist/types/src/internal/common/proxy/define-hidden-property.d.ts +5 -0
  298. package/dist/types/src/internal/common/proxy/define-hidden-property.d.ts.map +1 -0
  299. package/dist/types/src/internal/common/proxy/errors.d.ts +19 -0
  300. package/dist/types/src/internal/common/proxy/errors.d.ts.map +1 -0
  301. package/dist/types/src/internal/common/proxy/event-batch.d.ts +10 -0
  302. package/dist/types/src/internal/common/proxy/event-batch.d.ts.map +1 -0
  303. package/dist/types/src/internal/common/proxy/handler.test.d.ts +2 -0
  304. package/dist/types/src/internal/common/proxy/handler.test.d.ts.map +1 -0
  305. package/dist/types/src/internal/common/proxy/index.d.ts +14 -0
  306. package/dist/types/src/internal/common/proxy/index.d.ts.map +1 -0
  307. package/dist/types/src/internal/common/proxy/json-serializer.d.ts +6 -0
  308. package/dist/types/src/internal/common/proxy/json-serializer.d.ts.map +1 -0
  309. package/dist/types/src/internal/common/proxy/make-object.d.ts +14 -0
  310. package/dist/types/src/internal/common/proxy/make-object.d.ts.map +1 -0
  311. package/dist/types/src/internal/common/proxy/ownership.d.ts +57 -0
  312. package/dist/types/src/internal/common/proxy/ownership.d.ts.map +1 -0
  313. package/dist/types/src/internal/common/proxy/proxy-types.d.ts +18 -0
  314. package/dist/types/src/internal/common/proxy/proxy-types.d.ts.map +1 -0
  315. package/dist/types/src/internal/common/proxy/proxy-utils.d.ts +47 -0
  316. package/dist/types/src/internal/common/proxy/proxy-utils.d.ts.map +1 -0
  317. package/dist/types/src/internal/common/proxy/reactive-array.d.ts +8 -0
  318. package/dist/types/src/internal/common/proxy/reactive-array.d.ts.map +1 -0
  319. package/dist/types/src/internal/common/proxy/reactive.d.ts +39 -0
  320. package/dist/types/src/internal/common/proxy/reactive.d.ts.map +1 -0
  321. package/dist/types/src/internal/common/proxy/schema-validator.d.ts +15 -0
  322. package/dist/types/src/internal/common/proxy/schema-validator.d.ts.map +1 -0
  323. package/dist/types/src/internal/common/proxy/schema.test.d.ts +2 -0
  324. package/dist/types/src/internal/common/proxy/schema.test.d.ts.map +1 -0
  325. package/dist/types/src/internal/common/proxy/symbols.d.ts +3 -0
  326. package/dist/types/src/internal/common/proxy/symbols.d.ts.map +1 -0
  327. package/dist/types/src/internal/common/proxy/typed-handler.d.ts +48 -0
  328. package/dist/types/src/internal/common/proxy/typed-handler.d.ts.map +1 -0
  329. package/dist/types/src/internal/common/proxy/typed-handler.test.d.ts +2 -0
  330. package/dist/types/src/internal/common/proxy/typed-handler.test.d.ts.map +1 -0
  331. package/dist/types/src/internal/common/proxy/typed-object.test.d.ts +2 -0
  332. package/dist/types/src/internal/common/proxy/typed-object.test.d.ts.map +1 -0
  333. package/dist/types/src/internal/common/types/base.d.ts +27 -0
  334. package/dist/types/src/internal/common/types/base.d.ts.map +1 -0
  335. package/dist/types/src/internal/common/types/entity.d.ts +37 -0
  336. package/dist/types/src/internal/common/types/entity.d.ts.map +1 -0
  337. package/dist/types/src/internal/common/types/index.d.ts +7 -0
  338. package/dist/types/src/internal/common/types/index.d.ts.map +1 -0
  339. package/dist/types/src/internal/common/types/meta.d.ts +33 -0
  340. package/dist/types/src/internal/common/types/meta.d.ts.map +1 -0
  341. package/dist/types/src/internal/common/types/model-symbols.d.ts +54 -0
  342. package/dist/types/src/internal/common/types/model-symbols.d.ts.map +1 -0
  343. package/dist/types/src/internal/common/types/typename.d.ts +21 -0
  344. package/dist/types/src/internal/common/types/typename.d.ts.map +1 -0
  345. package/dist/types/src/internal/common/types/version.d.ts +15 -0
  346. package/dist/types/src/internal/common/types/version.d.ts.map +1 -0
  347. package/dist/types/src/internal/index.d.ts +11 -0
  348. package/dist/types/src/internal/index.d.ts.map +1 -0
  349. package/dist/types/src/{test → testing}/api.test.d.ts.map +1 -1
  350. package/dist/types/src/testing/index.d.ts +3 -1
  351. package/dist/types/src/testing/index.d.ts.map +1 -1
  352. package/dist/types/src/testing/test-data.d.ts +18 -0
  353. package/dist/types/src/testing/test-data.d.ts.map +1 -0
  354. package/dist/types/src/testing/test-schema.d.ts +304 -0
  355. package/dist/types/src/testing/test-schema.d.ts.map +1 -0
  356. package/dist/types/src/testing/util.d.ts +21 -0
  357. package/dist/types/src/testing/util.d.ts.map +1 -0
  358. package/dist/types/tsconfig.tsbuildinfo +1 -1
  359. package/package.json +122 -53
  360. package/src/Annotation.ts +48 -0
  361. package/src/Collection.ts +37 -0
  362. package/src/Database.ts +352 -0
  363. package/src/Dataset.ts +26 -0
  364. package/src/Entity.test.ts +22 -0
  365. package/src/Entity.ts +236 -0
  366. package/src/Err.ts +40 -0
  367. package/src/Extension.test.ts +235 -0
  368. package/src/Extension.ts +122 -0
  369. package/src/Feed.ts +304 -0
  370. package/src/Filter.test.ts +90 -0
  371. package/src/Filter.ts +454 -0
  372. package/src/Format.ts +9 -0
  373. package/src/Hypergraph.ts +79 -0
  374. package/src/JsonSchema.ts +26 -0
  375. package/src/Key.ts +3 -0
  376. package/src/Migration.ts +94 -0
  377. package/src/Obj.test.ts +539 -0
  378. package/src/Obj.ts +766 -80
  379. package/src/Order.ts +46 -0
  380. package/src/Query.test.ts +806 -0
  381. package/src/Query.ts +547 -0
  382. package/src/QueryResult.ts +106 -0
  383. package/src/Ref.ts +78 -9
  384. package/src/Relation.test.ts +88 -0
  385. package/src/Relation.ts +455 -54
  386. package/src/SchemaRegistry.ts +106 -0
  387. package/src/Tag.ts +41 -0
  388. package/src/Type.test.ts +52 -0
  389. package/src/Type.ts +168 -153
  390. package/src/View.ts +107 -0
  391. package/src/hierarchy.test.ts +33 -0
  392. package/src/index.ts +24 -4
  393. package/src/internal/Annotation/annotations.test.ts +145 -0
  394. package/src/internal/Annotation/annotations.ts +577 -0
  395. package/src/internal/Annotation/index.ts +7 -0
  396. package/src/internal/Annotation/sorting.ts +51 -0
  397. package/src/internal/Annotation/util.ts +85 -0
  398. package/src/internal/Entity/api.ts +30 -0
  399. package/src/internal/Entity/entity.ts +128 -0
  400. package/src/internal/Entity/index.ts +11 -0
  401. package/src/internal/Entity/model.ts +109 -0
  402. package/src/internal/Entity/object.ts +57 -0
  403. package/src/internal/Entity/relation.ts +154 -0
  404. package/src/internal/Entity/util.ts +33 -0
  405. package/src/internal/Entity/version.ts +96 -0
  406. package/src/internal/Format/date.test.ts +55 -0
  407. package/src/internal/Format/date.ts +217 -0
  408. package/src/internal/Format/format.test.ts +76 -0
  409. package/src/internal/Format/format.ts +54 -0
  410. package/src/internal/Format/index.ts +12 -0
  411. package/src/internal/Format/number.ts +89 -0
  412. package/src/internal/Format/object.ts +80 -0
  413. package/src/internal/Format/select.ts +18 -0
  414. package/src/internal/Format/string.ts +81 -0
  415. package/src/internal/Format/types.ts +186 -0
  416. package/src/internal/JsonSchema/annotations.ts +50 -0
  417. package/src/internal/JsonSchema/effect-schema.test.ts +143 -0
  418. package/src/internal/JsonSchema/index.ts +8 -0
  419. package/src/internal/JsonSchema/json-schema-normalize.ts +111 -0
  420. package/src/internal/JsonSchema/json-schema-type.ts +403 -0
  421. package/src/internal/JsonSchema/json-schema.test.ts +860 -0
  422. package/src/internal/JsonSchema/json-schema.ts +533 -0
  423. package/src/internal/Obj/clone.ts +48 -0
  424. package/src/internal/Obj/common.ts +75 -0
  425. package/src/internal/Obj/create-object.test.ts +114 -0
  426. package/src/internal/Obj/create-object.ts +94 -0
  427. package/src/internal/Obj/deleted.ts +19 -0
  428. package/src/internal/Obj/ids.ts +12 -0
  429. package/src/internal/Obj/index.ts +14 -0
  430. package/src/internal/Obj/inspect.ts +46 -0
  431. package/src/internal/Obj/json-serializer.test.ts +120 -0
  432. package/src/internal/Obj/json-serializer.ts +222 -0
  433. package/src/internal/Obj/schema-validator.test.ts +182 -0
  434. package/src/internal/Obj/schema-validator.ts +6 -0
  435. package/src/internal/Obj/set-value.test.ts +281 -0
  436. package/src/internal/Obj/set-value.ts +165 -0
  437. package/src/internal/Obj/snapshot.ts +105 -0
  438. package/src/internal/Obj/typed-object.test.ts +34 -0
  439. package/src/internal/Obj/typed-object.ts +30 -0
  440. package/src/internal/Query.ts +134 -0
  441. package/src/internal/Ref/index.ts +6 -0
  442. package/src/internal/Ref/ref-array.ts +38 -0
  443. package/src/internal/Ref/ref.test.ts +100 -0
  444. package/src/internal/Ref/ref.ts +572 -0
  445. package/src/internal/Type/compose.test.ts +41 -0
  446. package/src/internal/Type/compose.ts +41 -0
  447. package/src/internal/Type/echo-schema.ts +423 -0
  448. package/src/internal/Type/index.ts +7 -0
  449. package/src/internal/Type/manipulation.ts +92 -0
  450. package/src/internal/Type/persistent-schema.ts +33 -0
  451. package/src/internal/common/README.md +102 -0
  452. package/src/internal/common/api/index.ts +15 -0
  453. package/src/internal/common/api/meta.ts +88 -0
  454. package/src/internal/common/index.ts +7 -0
  455. package/src/internal/common/proxy/change-context.ts +138 -0
  456. package/src/internal/common/proxy/change.test.ts +519 -0
  457. package/src/internal/common/proxy/define-hidden-property.ts +14 -0
  458. package/src/internal/common/proxy/errors.ts +42 -0
  459. package/src/internal/common/proxy/event-batch.ts +44 -0
  460. package/src/internal/common/proxy/handler.test.ts +121 -0
  461. package/src/internal/common/proxy/index.ts +17 -0
  462. package/src/internal/common/proxy/json-serializer.ts +90 -0
  463. package/src/internal/common/proxy/make-object.ts +105 -0
  464. package/src/internal/common/proxy/ownership.ts +252 -0
  465. package/src/internal/common/proxy/proxy-types.ts +23 -0
  466. package/src/internal/common/proxy/proxy-utils.ts +150 -0
  467. package/src/internal/common/proxy/reactive-array.ts +71 -0
  468. package/src/internal/common/proxy/reactive.ts +68 -0
  469. package/src/internal/common/proxy/schema-validator.ts +244 -0
  470. package/src/internal/common/proxy/schema.test.ts +145 -0
  471. package/src/internal/common/proxy/symbols.ts +7 -0
  472. package/src/internal/common/proxy/typed-handler.test.ts +313 -0
  473. package/src/internal/common/proxy/typed-handler.ts +447 -0
  474. package/src/internal/common/proxy/typed-object.test.ts +115 -0
  475. package/src/internal/common/types/base.ts +43 -0
  476. package/src/internal/common/types/entity.ts +54 -0
  477. package/src/internal/common/types/index.ts +10 -0
  478. package/src/internal/common/types/meta.ts +67 -0
  479. package/src/internal/common/types/model-symbols.ts +69 -0
  480. package/src/internal/common/types/typename.ts +55 -0
  481. package/src/internal/common/types/version.ts +19 -0
  482. package/src/internal/index.ts +17 -0
  483. package/src/testing/api.test.ts +125 -0
  484. package/src/testing/index.ts +3 -1
  485. package/src/testing/test-data.ts +129 -0
  486. package/src/testing/test-schema.ts +240 -0
  487. package/src/testing/util.ts +85 -0
  488. package/dist/lib/browser/chunk-SVSJEELN.mjs +0 -619
  489. package/dist/lib/browser/chunk-SVSJEELN.mjs.map +0 -7
  490. package/dist/lib/browser/index.mjs +0 -22
  491. package/dist/lib/browser/meta.json +0 -1
  492. package/dist/lib/browser/testing/index.mjs +0 -70
  493. package/dist/lib/browser/testing/index.mjs.map +0 -7
  494. package/dist/lib/node-esm/chunk-53HXWYR6.mjs +0 -619
  495. package/dist/lib/node-esm/chunk-53HXWYR6.mjs.map +0 -7
  496. package/dist/lib/node-esm/index.mjs +0 -22
  497. package/dist/lib/node-esm/meta.json +0 -1
  498. package/dist/lib/node-esm/testing/index.mjs +0 -70
  499. package/dist/lib/node-esm/testing/index.mjs.map +0 -7
  500. package/dist/types/src/experimental/database.d.ts +0 -8
  501. package/dist/types/src/experimental/database.d.ts.map +0 -1
  502. package/dist/types/src/experimental/index.d.ts +0 -1
  503. package/dist/types/src/experimental/index.d.ts.map +0 -1
  504. package/dist/types/src/experimental/queue.d.ts +0 -8
  505. package/dist/types/src/experimental/queue.d.ts.map +0 -1
  506. package/dist/types/src/experimental/space.d.ts +0 -8
  507. package/dist/types/src/experimental/space.d.ts.map +0 -1
  508. package/dist/types/src/query/dsl.d.ts +0 -218
  509. package/dist/types/src/query/dsl.d.ts.map +0 -1
  510. package/dist/types/src/query/dsl.test.d.ts +0 -2
  511. package/dist/types/src/query/dsl.test.d.ts.map +0 -1
  512. package/dist/types/src/query/index.d.ts +0 -2
  513. package/dist/types/src/query/index.d.ts.map +0 -1
  514. package/dist/types/src/testing/types.d.ts +0 -113
  515. package/dist/types/src/testing/types.d.ts.map +0 -1
  516. package/src/experimental/database.ts +0 -11
  517. package/src/experimental/index.ts +0 -7
  518. package/src/experimental/queue.ts +0 -11
  519. package/src/experimental/space.ts +0 -11
  520. package/src/query/dsl.test.ts +0 -323
  521. package/src/query/dsl.ts +0 -646
  522. package/src/query/index.ts +0 -5
  523. package/src/test/api.test.ts +0 -173
  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/{node-esm/index.mjs.map → neutral/Database.mjs.map} +0 -0
  527. /package/dist/types/src/{test → testing}/api.test.d.ts +0 -0
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/Type.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Schema from 'effect/Schema';\n\nimport { type EncodedReference } from '@dxos/echo-protocol';\nimport { invariant } from '@dxos/invariant';\nimport { type DXN } from '@dxos/keys';\nimport { type ToMutable } from '@dxos/util';\n\nimport type * as Entity from './Entity';\nimport * as internal from './internal';\nimport * as typeInternal from './internal/Type';\nimport type * as ObjModule from './Obj';\nimport type * as RelationModule from './Relation';\n\n/**\n * Dynamic type that can be constructed, mutated, and persisted in the ECHO database.\n */\nexport const RuntimeType = typeInternal.EchoSchema;\n\n/**\n * Dynamic type that can be constructed, mutated, and persisted in the ECHO database.\n */\nexport type RuntimeType = typeInternal.EchoSchema;\n\n//\n// Internal types (not exported)\n//\n\n/**\n * Type that marks a schema as an ECHO schema.\n * The value indicates the entity kind (Object or Relation).\n */\ntype EchoSchemaKind<K extends internal.EntityKind = internal.EntityKind> = {\n readonly [internal.SchemaKindId]: K;\n};\n\n//\n// Obj - Runtime schema for any ECHO object\n//\n\n/**\n * TypeScript type for an ECHO object schema.\n * `T` is the instance type produced by the schema.\n * `Fields` is the optional struct fields type for introspection.\n *\n * @example\n * ```ts\n * const PersonSchema: Type.Obj<Person> = Schema.Struct({\n * name: Schema.String,\n * }).pipe(Type.object({ typename: 'Person', version: '0.1.0' }));\n *\n * // Access fields for introspection:\n * Object.keys(PersonSchema.fields); // ['name']\n * ```\n */\nexport interface Obj<T, Fields extends Schema.Struct.Fields = Schema.Struct.Fields>\n extends\n internal.TypeMeta,\n EchoSchemaKind<internal.EntityKind.Object>,\n Schema.AnnotableClass<\n Obj<T, Fields>,\n Entity.OfKind<typeof Entity.Kind.Object> & T,\n Schema.Simplify<ObjModule.BaseObjJson & ToMutable<T>>,\n never\n > {\n /**\n * The fields defined in the original struct schema.\n * Allows accessing field definitions for introspection.\n */\n readonly fields: Fields;\n}\n\n/**\n * Structural base type for any ECHO object schema.\n * Accepts both static schemas (created with Type.object()) and EchoSchema.\n * NOTE: Does not include the brand symbol to avoid TS4053 declaration portability issues.\n * Use Type.isObjectSchema() for runtime type guards.\n */\ntype ObjectSchemaBase = Schema.Schema.AnyNoContext & {\n readonly typename: string;\n readonly version: string;\n};\n\n/**\n * Type that represents any ECHO object schema.\n * Accepts both static schemas (Type.object()) and mutable schemas (EchoSchema).\n */\nexport type AnyObj = ObjectSchemaBase;\n\n/**\n * Factory function to create an ECHO object schema.\n * Adds object metadata annotations to an Effect schema.\n *\n * @example\n * ```ts\n * const Person = Schema.Struct({\n * name: Schema.String,\n * }).pipe(Type.object({ typename: 'com.example.type.person', version: '0.1.0' }));\n * ```\n */\nexport const object: {\n (opts: internal.TypeMeta): <Self extends Schema.Schema.Any>(self: Self) => Obj<Schema.Schema.Type<Self>>;\n} = internal.EchoObjectSchema as any;\n\n//\n// PersistentType (Schema stored in database)\n//\n\nexport const PersistentType: Obj<typeInternal.PersistentSchema> = typeInternal.PersistentSchema as any;\n\nexport interface PersistentType extends Schema.Schema.Type<typeof PersistentType> {}\n\n/**\n * TypeScript type for an ECHO relation schema.\n * `T` is the instance type produced by the schema (excluding source/target).\n * `Source` and `Target` are the endpoint types.\n * `Fields` is the optional struct fields type for introspection.\n */\nexport interface Relation<T, Source, Target, Fields extends Schema.Struct.Fields = Schema.Struct.Fields>\n extends\n internal.TypeMeta,\n EchoSchemaKind<internal.EntityKind.Relation>,\n Schema.AnnotableClass<\n Relation<T, Source, Target, Fields>,\n Entity.OfKind<typeof Entity.Kind.Relation> & RelationModule.Endpoints<Source, Target> & T,\n Schema.Simplify<RelationModule.BaseRelationJson & ToMutable<T>>,\n never\n > {\n /**\n * The fields defined in the original struct schema.\n * Allows accessing field definitions for introspection.\n */\n readonly fields: Fields;\n}\n\n/**\n * Structural base type for any ECHO relation schema.\n * Accepts static schemas (created with Type.relation()).\n * NOTE: Does not include the brand symbol to avoid TS4053 declaration portability issues.\n * Use Type.isRelationSchema() for runtime type guards.\n */\ntype RelationSchemaBase = Schema.Schema.AnyNoContext & {\n readonly typename: string;\n readonly version: string;\n};\n\n/**\n * Type that represents any ECHO relation schema.\n * Accepts static schemas (Type.relation()).\n */\nexport type AnyRelation = RelationSchemaBase;\n\n/**\n * Factory function to create an ECHO relation schema.\n * Adds relation metadata annotations to an Effect schema.\n *\n * @example\n * ```ts\n * const WorksFor = Schema.Struct({\n * role: Schema.String,\n * }).pipe(Type.relation({\n * typename: 'com.example.type.works-for',\n * version: '0.1.0',\n * source: Person,\n * target: Company,\n * }));\n * ```\n */\nexport const relation: {\n <SourceSchema extends Schema.Schema.AnyNoContext, TargetSchema extends Schema.Schema.AnyNoContext>(\n opts: internal.EchoRelationSchemaOptions<SourceSchema, TargetSchema>,\n ): <Self extends Schema.Schema.Any>(\n self: Self,\n ) => Relation<Schema.Schema.Type<Self>, Schema.Schema.Type<SourceSchema>, Schema.Schema.Type<TargetSchema>>;\n} = internal.EchoRelationSchema as any;\n\n/**\n * Type alias for any ECHO entity schema (object or relation).\n * Use this in type annotations for schema parameters.\n */\nexport type AnyEntity = AnyObj | AnyRelation;\n\n/**\n * Type guard to check if a schema is an object schema.\n * NOTE: This checks SCHEMAS, not instances. Use Obj.isObject for instances.\n */\nexport const isObjectSchema = (schema: AnyEntity): schema is AnyObj => {\n return (schema as any)[internal.SchemaKindId] === internal.EntityKind.Object;\n};\n\n/**\n * Type guard to check if a schema is a relation schema.\n * NOTE: This checks SCHEMAS, not instances. Use Relation.isRelation for instances.\n */\nexport const isRelationSchema = (schema: AnyEntity): schema is AnyRelation => {\n return (schema as any)[internal.SchemaKindId] === internal.EntityKind.Relation;\n};\n\n/**\n * Type that represents any Ref schema (with unknown target type).\n * This is a schema type, not an instance type.\n */\nexport type AnyRef = Schema.Schema<internal.Ref<any>, EncodedReference>;\n\n//\n// Schema utility functions\n//\n\n/**\n * Gets the full DXN of the schema.\n * Will include the version if it's a `type` DXN.\n * @example \"dxn:com.example.type.person:0.1.0\"\n * @example \"dxn:echo:SSSSSSSSSS:XXXXXXXXXXXXX\"\n */\nexport const getDXN = (schema: AnyEntity): DXN | undefined => {\n return internal.getSchemaDXN(schema);\n};\n\n/**\n * @param schema - Schema to get the typename from.\n * @returns The typename of the schema. Example: `com.example.type.person`.\n */\nexport const getTypename = (schema: AnyEntity): string => {\n const typename = internal.getSchemaTypename(schema);\n invariant(typeof typename === 'string' && !typename.startsWith('dxn:'), 'Invalid typename');\n return typename;\n};\n\n/**\n * Gets the version of the schema.\n * @example 0.1.0\n */\nexport const getVersion = (schema: AnyEntity): string => {\n const version = internal.getSchemaVersion(schema);\n invariant(typeof version === 'string' && version.match(/^\\d+\\.\\d+\\.\\d+$/), 'Invalid version');\n return version;\n};\n\n/**\n * @returns True if the schema is mutable.\n */\nexport const isMutable = typeInternal.isMutable;\n\n/**\n * ECHO type metadata.\n */\nexport type Meta = internal.TypeAnnotation;\n\n/**\n * Gets the meta data of the schema.\n */\nexport const getMeta = (schema: AnyEntity): Meta | undefined => {\n return internal.getTypeAnnotation(schema);\n};\n"],
5
+ "mappings": ";;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;mBAAAA;EAAA;;;;;AASA,SAASC,iBAAiB;;AAanB,IAAMC,cAA2BC;AAmFjC,IAAMC,SAEAC;AAMN,IAAMC,iBAAkEC;AA4DxE,IAAMC,WAMAC;AAYN,IAAMC,iBAAiB,CAACC,WAAAA;AAC7B,SAAQA,OAAwBC,YAAY,MAAeC,WAAWC;AACxE;AAMO,IAAMC,mBAAmB,CAACJ,WAAAA;AAC/B,SAAQA,OAAwBC,YAAY,MAAeC,WAAWG;AACxE;AAkBO,IAAMC,SAAS,CAACN,WAAAA;AACrB,SAAgBO,aAAaP,MAAAA;AAC/B;AAMO,IAAMQ,cAAc,CAACR,WAAAA;AAC1B,QAAMS,WAAoBC,kBAAkBV,MAAAA;AAC5CW,YAAU,OAAOF,aAAa,YAAY,CAACA,SAASG,WAAW,MAAA,GAAS,oBAAA;;;;;;;;;AACxE,SAAOH;AACT;AAMO,IAAMI,aAAa,CAACb,WAAAA;AACzB,QAAMc,UAAmBC,iBAAiBf,MAAAA;AAC1CW,YAAU,OAAOG,YAAY,YAAYA,QAAQE,MAAM,iBAAA,GAAoB,mBAAA;;;;;;;;;AAC3E,SAAOF;AACT;AAKO,IAAMG,aAAyBA;AAU/B,IAAMC,UAAU,CAAClB,WAAAA;AACtB,SAAgBmB,kBAAkBnB,MAAAA;AACpC;",
6
+ "names": ["isMutable", "invariant", "RuntimeType", "EchoSchema", "object", "EchoObjectSchema", "PersistentType", "PersistentSchema", "relation", "EchoRelationSchema", "isObjectSchema", "schema", "SchemaKindId", "EntityKind", "Object", "isRelationSchema", "Relation", "getDXN", "getSchemaDXN", "getTypename", "typename", "getSchemaTypename", "invariant", "startsWith", "getVersion", "version", "getSchemaVersion", "match", "isMutable", "getMeta", "getTypeAnnotation"]
7
+ }
@@ -0,0 +1,396 @@
1
+ import {
2
+ Service
3
+ } from "./chunk-HQSGCJPL.mjs";
4
+ import {
5
+ ReferenceAnnotationId,
6
+ getSchemaDXN,
7
+ getTypeAnnotation,
8
+ getTypeIdentifierAnnotation
9
+ } from "./chunk-4U7YKZUA.mjs";
10
+
11
+ // src/internal/Ref/ref.ts
12
+ import * as Effect from "effect/Effect";
13
+ import * as Equal from "effect/Equal";
14
+ import * as Hash from "effect/Hash";
15
+ import * as Option from "effect/Option";
16
+ import * as ParseResult from "effect/ParseResult";
17
+ import * as Pipeable from "effect/Pipeable";
18
+ import * as Schema from "effect/Schema";
19
+ import * as SchemaAST from "effect/SchemaAST";
20
+ import { Event } from "@dxos/async";
21
+ import { inspectCustom } from "@dxos/debug";
22
+ import { EncodedReference } from "@dxos/echo-protocol";
23
+ import { assertArgument, invariant } from "@dxos/invariant";
24
+ import { DXN, ObjectId } from "@dxos/keys";
25
+ var __dxlog_file = "/__w/dxos/dxos/packages/core/echo/echo/src/internal/Ref/ref.ts";
26
+ var JSON_SCHEMA_ECHO_REF_ID = "/schemas/echo/ref";
27
+ var getSchemaReference = (property) => {
28
+ const { $id, reference: { schema: { $ref } = {} } = {} } = property;
29
+ if ($id === JSON_SCHEMA_ECHO_REF_ID && $ref) {
30
+ return {
31
+ typename: DXN.parse($ref).typename
32
+ };
33
+ }
34
+ };
35
+ var createSchemaReference = (typename) => {
36
+ return {
37
+ $id: JSON_SCHEMA_ECHO_REF_ID,
38
+ reference: {
39
+ schema: {
40
+ $ref: DXN.fromTypename(typename).toString()
41
+ }
42
+ }
43
+ };
44
+ };
45
+ var getReferenceAst = (ast) => {
46
+ if (ast._tag !== "Declaration" || !ast.annotations[ReferenceAnnotationId]) {
47
+ return void 0;
48
+ }
49
+ return {
50
+ typename: ast.annotations[ReferenceAnnotationId].typename,
51
+ version: ast.annotations[ReferenceAnnotationId].version
52
+ };
53
+ };
54
+ var RefTypeId = /* @__PURE__ */ Symbol("@dxos/echo/internal/Ref");
55
+ var Ref = (schema) => {
56
+ assertArgument(Schema.isSchema(schema), "schema", "Must call with an instance of effect-schema");
57
+ const annotation = getTypeAnnotation(schema);
58
+ if (annotation == null) {
59
+ throw new Error("Reference target must be an ECHO schema.");
60
+ }
61
+ return createEchoReferenceSchema(getTypeIdentifierAnnotation(schema), annotation.typename, annotation.version);
62
+ };
63
+ Ref.isRef = (obj) => {
64
+ return obj && typeof obj === "object" && RefTypeId in obj;
65
+ };
66
+ Ref.hasObjectId = (id) => (ref) => ref.dxn.isLocalObjectId() && ref.dxn.parts[1] === id;
67
+ Ref.isRefSchema = (schema) => {
68
+ return Ref.isRefSchemaAST(schema.ast);
69
+ };
70
+ Ref.isRefSchemaAST = (ast) => {
71
+ return SchemaAST.getAnnotation(ast, ReferenceAnnotationId).pipe(Option.isSome);
72
+ };
73
+ Ref.make = (obj) => {
74
+ if (typeof obj !== "object" || obj === null) {
75
+ throw new TypeError("Expected: ECHO object.");
76
+ }
77
+ const id = obj.id;
78
+ invariant(ObjectId.isValid(id), "Invalid object ID", {
79
+ F: __dxlog_file,
80
+ L: 225,
81
+ S: void 0,
82
+ A: [
83
+ "ObjectId.isValid(id)",
84
+ "'Invalid object ID'"
85
+ ]
86
+ });
87
+ const dxn = DXN.fromLocalObjectId(id);
88
+ return new RefImpl(dxn, obj);
89
+ };
90
+ Ref.fromDXN = (dxn) => {
91
+ assertArgument(dxn instanceof DXN, "dxn", "Expected DXN");
92
+ return new RefImpl(dxn);
93
+ };
94
+ var createEchoReferenceSchema = (echoId, typename, version) => {
95
+ if (!echoId && !typename) {
96
+ throw new TypeError("Either echoId or typename must be provided.");
97
+ }
98
+ const referenceInfo = {
99
+ schema: {
100
+ // TODO(dmaretskyi): Include version?
101
+ $ref: echoId ?? DXN.fromTypename(typename).toString()
102
+ },
103
+ schemaVersion: version
104
+ };
105
+ const refSchema = Schema.declare([], {
106
+ encode: () => {
107
+ return (value) => Effect.gen(function* () {
108
+ if (Ref.isRef(value)) {
109
+ return EncodedReference.fromDXN(value.dxn);
110
+ } else if (EncodedReference.isEncodedReference(value)) {
111
+ return value;
112
+ }
113
+ throw new Error("Invalid reference");
114
+ });
115
+ },
116
+ decode: () => {
117
+ return (value) => Effect.gen(function* () {
118
+ const dbService = yield* Effect.serviceOption(Service);
119
+ if (Ref.isRef(value)) {
120
+ if (Option.isSome(dbService)) {
121
+ return dbService.value.db.makeRef(value.dxn);
122
+ } else {
123
+ return value;
124
+ }
125
+ }
126
+ if (!EncodedReference.isEncodedReference(value)) {
127
+ return yield* Effect.fail(new ParseResult.Unexpected(value, "reference"));
128
+ }
129
+ if (Option.isSome(dbService)) {
130
+ return dbService.value.db.makeRef(EncodedReference.toDXN(value));
131
+ } else {
132
+ return Ref.fromDXN(EncodedReference.toDXN(value));
133
+ }
134
+ });
135
+ }
136
+ }, {
137
+ jsonSchema: {
138
+ // TODO(dmaretskyi): We should remove `$id` and keep `$ref` with a fully qualified name.
139
+ $id: JSON_SCHEMA_ECHO_REF_ID,
140
+ $ref: JSON_SCHEMA_ECHO_REF_ID,
141
+ reference: referenceInfo
142
+ },
143
+ [ReferenceAnnotationId]: {
144
+ typename: typename ?? "",
145
+ version
146
+ }
147
+ });
148
+ return refSchema;
149
+ };
150
+ var RefImpl = class _RefImpl {
151
+ #dxn;
152
+ #resolver = void 0;
153
+ #resolved = new Event();
154
+ /**
155
+ * Target is set when the reference is created from a specific object.
156
+ * In this case, the target might not be in the database.
157
+ */
158
+ #target = void 0;
159
+ /**
160
+ * Callback to issue a reactive notification when object is resolved.
161
+ */
162
+ #resolverCallback = () => {
163
+ this.#resolved.emit();
164
+ };
165
+ constructor(dxn, target) {
166
+ this.#dxn = dxn;
167
+ this.#target = target;
168
+ }
169
+ /**
170
+ * @inheritdoc
171
+ */
172
+ get dxn() {
173
+ return this.#dxn;
174
+ }
175
+ /**
176
+ * @inheritdoc
177
+ */
178
+ get isAvailable() {
179
+ return this.#target !== void 0 || this.#resolver !== void 0;
180
+ }
181
+ /**
182
+ * @inheritdoc
183
+ */
184
+ get target() {
185
+ if (this.#target) {
186
+ return this.#target;
187
+ }
188
+ invariant(this.#resolver, "Resolver is not set", {
189
+ F: __dxlog_file,
190
+ L: 393,
191
+ S: this,
192
+ A: [
193
+ "this.#resolver",
194
+ "'Resolver is not set'"
195
+ ]
196
+ });
197
+ return this.#resolver.resolveSync(this.#dxn, true, this.#resolverCallback);
198
+ }
199
+ /**
200
+ * @inheritdoc
201
+ */
202
+ async load() {
203
+ if (this.#target) {
204
+ return this.#target;
205
+ }
206
+ invariant(this.#resolver, "Resolver is not set", {
207
+ F: __dxlog_file,
208
+ L: 404,
209
+ S: this,
210
+ A: [
211
+ "this.#resolver",
212
+ "'Resolver is not set'"
213
+ ]
214
+ });
215
+ const obj = await this.#resolver.resolve(this.#dxn);
216
+ if (obj == null) {
217
+ throw new Error("Object not found");
218
+ }
219
+ return obj;
220
+ }
221
+ /**
222
+ * @inheritdoc
223
+ */
224
+ async tryLoad() {
225
+ if (this.#target) {
226
+ return this.#target;
227
+ }
228
+ invariant(this.#resolver, "Resolver is not set", {
229
+ F: __dxlog_file,
230
+ L: 419,
231
+ S: this,
232
+ A: [
233
+ "this.#resolver",
234
+ "'Resolver is not set'"
235
+ ]
236
+ });
237
+ return await this.#resolver.resolve(this.#dxn);
238
+ }
239
+ /**
240
+ * Do not inline the target object in the reference.
241
+ * Makes .target unavailable unless the reference is connected to a database context.
242
+ * Clones the reference object.
243
+ */
244
+ noInline() {
245
+ const ref = new _RefImpl(this.#dxn, void 0);
246
+ ref.#resolver = this.#resolver;
247
+ return ref;
248
+ }
249
+ encode() {
250
+ return {
251
+ "/": this.#dxn.toString(),
252
+ ...this.#target ? {
253
+ target: this.#target
254
+ } : {}
255
+ };
256
+ }
257
+ /**
258
+ * Serializes the reference to a JSON object.
259
+ * The serialization format is compatible with the IPLD-style encoded references.
260
+ * When a reference has a saved target (i.e. the target or object holding the reference is not in the database),
261
+ * the target is included in the serialized object.
262
+ */
263
+ toJSON() {
264
+ return this.encode();
265
+ }
266
+ toString() {
267
+ if (this.#target) {
268
+ return `Ref(${this.#target.toString()})`;
269
+ }
270
+ return `Ref(${this.#dxn.toString()})`;
271
+ }
272
+ [inspectCustom] = (depth, options, inspect) => {
273
+ return this.toString();
274
+ };
275
+ [RefTypeId] = refVariance;
276
+ /**
277
+ * Effect Hash trait. Required for MutableHashMap-based caches (e.g., Atom.family)
278
+ * to deduplicate Ref instances that point to the same object.
279
+ * ECHO proxies return new RefImpl instances on every property access,
280
+ * so without this, each access would create a separate cache entry.
281
+ */
282
+ [Hash.symbol]() {
283
+ return Hash.hash(this.#dxn.toString());
284
+ }
285
+ /** Effect Equal trait. See {@link Hash.symbol} for rationale. */
286
+ [Equal.symbol](that) {
287
+ return that instanceof _RefImpl && this.#dxn.toString() === that.dxn.toString();
288
+ }
289
+ /**
290
+ * Internal method to set the resolver.
291
+ *
292
+ * @internal
293
+ */
294
+ _setResolver(resolver) {
295
+ this.#resolver = resolver;
296
+ }
297
+ /**
298
+ * @internal
299
+ */
300
+ _getSavedTarget() {
301
+ return this.#target;
302
+ }
303
+ pipe() {
304
+ return Pipeable.pipeArguments(this, arguments);
305
+ }
306
+ };
307
+ var setRefResolver = (ref, resolver) => {
308
+ invariant(ref instanceof RefImpl, "Ref is not an instance of RefImpl", {
309
+ F: __dxlog_file,
310
+ L: 506,
311
+ S: void 0,
312
+ A: [
313
+ "ref instanceof RefImpl",
314
+ "'Ref is not an instance of RefImpl'"
315
+ ]
316
+ });
317
+ ref._setResolver(resolver);
318
+ };
319
+ var getRefSavedTarget = (ref) => {
320
+ invariant(ref instanceof RefImpl, "Ref is not an instance of RefImpl", {
321
+ F: __dxlog_file,
322
+ L: 514,
323
+ S: void 0,
324
+ A: [
325
+ "ref instanceof RefImpl",
326
+ "'Ref is not an instance of RefImpl'"
327
+ ]
328
+ });
329
+ return ref._getSavedTarget();
330
+ };
331
+ var refVariance = {
332
+ _T: null
333
+ };
334
+ var refFromEncodedReference = (encodedReference, resolver) => {
335
+ const dxn = DXN.parse(encodedReference["/"]);
336
+ const ref = new RefImpl(dxn);
337
+ if (resolver) {
338
+ setRefResolver(ref, resolver);
339
+ }
340
+ return ref;
341
+ };
342
+ var StaticRefResolver = class {
343
+ objects = /* @__PURE__ */ new Map();
344
+ schemas = /* @__PURE__ */ new Map();
345
+ addObject(obj) {
346
+ this.objects.set(obj.id, obj);
347
+ return this;
348
+ }
349
+ addSchema(schema) {
350
+ const dxn = getSchemaDXN(schema);
351
+ invariant(dxn, "Schema has no DXN", {
352
+ F: __dxlog_file,
353
+ L: 546,
354
+ S: this,
355
+ A: [
356
+ "dxn",
357
+ "'Schema has no DXN'"
358
+ ]
359
+ });
360
+ this.schemas.set(dxn.toString(), schema);
361
+ return this;
362
+ }
363
+ resolveSync(dxn, _load, _onLoad) {
364
+ const id = dxn?.asEchoDXN()?.echoId;
365
+ if (id == null) {
366
+ return void 0;
367
+ }
368
+ return this.objects.get(id);
369
+ }
370
+ async resolve(dxn) {
371
+ const id = dxn?.asEchoDXN()?.echoId;
372
+ if (id == null) {
373
+ return void 0;
374
+ }
375
+ return this.objects.get(id);
376
+ }
377
+ async resolveSchema(dxn) {
378
+ return this.schemas.get(dxn.toString());
379
+ }
380
+ };
381
+
382
+ export {
383
+ JSON_SCHEMA_ECHO_REF_ID,
384
+ getSchemaReference,
385
+ createSchemaReference,
386
+ getReferenceAst,
387
+ RefTypeId,
388
+ Ref,
389
+ createEchoReferenceSchema,
390
+ RefImpl,
391
+ setRefResolver,
392
+ getRefSavedTarget,
393
+ refFromEncodedReference,
394
+ StaticRefResolver
395
+ };
396
+ //# sourceMappingURL=chunk-SRYQFSA4.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/internal/Ref/ref.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Equal from 'effect/Equal';\nimport * as Hash from 'effect/Hash';\nimport * as Option from 'effect/Option';\nimport * as ParseResult from 'effect/ParseResult';\nimport * as Pipeable from 'effect/Pipeable';\nimport * as Schema from 'effect/Schema';\nimport * as SchemaAST from 'effect/SchemaAST';\nimport type * as Types from 'effect/Types';\n\nimport { Event } from '@dxos/async';\nimport { type CustomInspectFunction, inspectCustom } from '@dxos/debug';\nimport { EncodedReference } from '@dxos/echo-protocol';\nimport { assertArgument, invariant } from '@dxos/invariant';\nimport { DXN, ObjectId } from '@dxos/keys';\n\nimport * as Database from '../../Database';\nimport { ReferenceAnnotationId, getSchemaDXN, getTypeAnnotation, getTypeIdentifierAnnotation } from '../Annotation';\nimport type { AnyEntity, AnyProperties } from '../common/types';\nimport { type JsonSchemaType } from '../JsonSchema';\n\n/**\n * The `$id` and `$ref` fields for an ECHO reference schema.\n */\nexport const JSON_SCHEMA_ECHO_REF_ID = '/schemas/echo/ref';\n\nexport const getSchemaReference = (property: JsonSchemaType): { typename: string } | undefined => {\n const { $id, reference: { schema: { $ref } = {} } = {} } = property;\n if ($id === JSON_SCHEMA_ECHO_REF_ID && $ref) {\n return { typename: DXN.parse($ref).typename };\n }\n};\n\nexport const createSchemaReference = (typename: string): Types.DeepMutable<JsonSchemaType> => {\n return {\n $id: JSON_SCHEMA_ECHO_REF_ID,\n reference: {\n schema: {\n $ref: DXN.fromTypename(typename).toString(),\n },\n },\n };\n};\n\n/**\n * Runtime type-info for a reference extracted from effect AST.\n */\nexport type RefereneAST = {\n /**\n * Typename of linked schema.\n */\n typename: string;\n\n /**\n * Version of linked schema.\n */\n version: string;\n};\n\nexport const getReferenceAst = (ast: SchemaAST.AST): RefereneAST | undefined => {\n if (ast._tag !== 'Declaration' || !ast.annotations[ReferenceAnnotationId]) {\n return undefined;\n }\n return {\n typename: (ast.annotations[ReferenceAnnotationId] as any).typename,\n version: (ast.annotations[ReferenceAnnotationId] as any).version,\n };\n};\n\nexport const RefTypeId: unique symbol = Symbol('@dxos/echo/internal/Ref');\n\n/**\n * Reference Schema.\n */\nexport interface RefSchema<T extends AnyEntity> extends Schema.SchemaClass<Ref<T>, EncodedReference> {}\n\n/**\n * Type of the `Ref` function and extra methods attached to it.\n */\nexport interface RefFn {\n <S extends Schema.Schema.Any>(schema: S): RefSchema<Schema.Schema.Type<S>>;\n\n /**\n * @returns True if the object is a reference.\n */\n isRef: (obj: unknown) => obj is Ref<any>;\n\n /**\n * @returns True if the reference points to the given object id.\n */\n hasObjectId: (id: ObjectId) => (ref: Ref<any>) => boolean;\n\n /**\n * @returns True if the schema is a reference schema.\n */\n isRefSchema: (schema: Schema.Schema<any, any>) => schema is RefSchema<any>;\n\n /**\n * @returns True if the schema AST is a reference schema.\n */\n isRefSchemaAST: (ast: SchemaAST.AST) => boolean;\n\n /**\n * Constructs a reference that points to the given object.\n */\n // TODO(burdon): Narrow to Obj.Unknown?\n make: <T extends AnyEntity>(object: T) => Ref<T>;\n\n /**\n * Constructs a reference that points to the object specified by the provided DXN.\n */\n fromDXN: (dxn: DXN) => Ref<any>;\n}\n\n/**\n * Schema builder for references.\n */\nexport const Ref: RefFn = <S extends Schema.Schema.Any>(schema: S): RefSchema<Schema.Schema.Type<S>> => {\n assertArgument(Schema.isSchema(schema), 'schema', 'Must call with an instance of effect-schema');\n const annotation = getTypeAnnotation(schema);\n if (annotation == null) {\n throw new Error('Reference target must be an ECHO schema.');\n }\n\n return createEchoReferenceSchema(getTypeIdentifierAnnotation(schema), annotation.typename, annotation.version);\n};\n\n/**\n * Represents materialized reference to a target.\n * This is the data type for the fields marked as ref.\n */\nexport interface Ref<T> extends Pipeable.Pipeable {\n /**\n * Target object DXN.\n */\n get dxn(): DXN;\n\n /**\n * Returns true if the reference has a target available (inlined or resolver set).\n */\n get isAvailable(): boolean;\n\n /**\n * @returns The reference target.\n * May return `undefined` if the object is not loaded in the working set.\n * Accessing this property, even if it returns `undefined` will trigger the object to be loaded to the working set.\n */\n get target(): T | undefined;\n\n /**\n * @returns Promise that will resolves with the target object.\n * Will load the object from disk if it is not present in the working set.\n * @throws If the object is not available locally.\n */\n load(): Promise<T>;\n\n /**\n * @returns Promise that will resolves with the target object or undefined if the object is not loaded locally.\n */\n\n tryLoad(): Promise<T | undefined>;\n\n /**\n * Do not inline the target object in the reference.\n * Makes .target unavailable unless the reference is connected to a database context.\n *\n * When serialized with toJSON, the difference is between:\n * `{ \"/\": \"dxn:...\" }`\n * and\n * `{ \"/\": \"dxn:...\", \"target\": { ... } }`\n *\n * Clones the reference object.\n */\n noInline(): Ref<T>;\n\n /**\n * Serializes the reference to a JSON object.\n * The serialization format is compatible with the IPLD-style encoded references.\n * When a reference has a saved target (i.e. the target or object holding the reference is not in the database),\n * the target is included in the serialized object.\n *\n * Examples:\n * `{ \"/\": \"dxn:...\" }`\n * `{ \"/\": \"dxn:...\", \"target\": { ... } }`\n */\n encode(): EncodedReference;\n\n [RefTypeId]: {\n _T: T;\n };\n}\n\nexport declare namespace Ref {\n /**\n * Target of the reference.\n */\n export type Target<R> = R extends Ref<infer U> ? U : never;\n}\n\nRef.isRef = (obj: any): obj is Ref<any> => {\n return obj && typeof obj === 'object' && RefTypeId in obj;\n};\n\nRef.hasObjectId = (id: ObjectId) => (ref: Ref<any>) => ref.dxn.isLocalObjectId() && ref.dxn.parts[1] === id;\n\nRef.isRefSchema = (schema: Schema.Schema<any, any>): schema is RefSchema<any> => {\n return Ref.isRefSchemaAST(schema.ast);\n};\n\nRef.isRefSchemaAST = (ast: SchemaAST.AST): boolean => {\n return SchemaAST.getAnnotation(ast, ReferenceAnnotationId).pipe(Option.isSome);\n};\n\nRef.make = <T extends AnyProperties>(obj: T): Ref<T> => {\n if (typeof obj !== 'object' || obj === null) {\n throw new TypeError('Expected: ECHO object.');\n }\n\n // TODO(dmaretskyi): Extract to `getObjectDXN` function.\n const id = obj.id;\n invariant(ObjectId.isValid(id), 'Invalid object ID');\n const dxn = DXN.fromLocalObjectId(id);\n return new RefImpl(dxn, obj);\n};\n\nRef.fromDXN = (dxn: DXN): Ref<any> => {\n assertArgument(dxn instanceof DXN, 'dxn', 'Expected DXN');\n return new RefImpl(dxn);\n};\n\n/**\n * `reference` field on the schema object.\n */\nexport type JsonSchemaReferenceInfo = {\n schema: { $ref: string };\n schemaVersion?: string;\n};\n\n/**\n * @internal\n */\n// TODO(burdon): Move to json schema and make private?\nexport const createEchoReferenceSchema = (\n echoId: string | undefined,\n typename: string | undefined,\n version: string | undefined,\n): Schema.SchemaClass<Ref<any>, EncodedReference> => {\n if (!echoId && !typename) {\n throw new TypeError('Either echoId or typename must be provided.');\n }\n\n const referenceInfo: JsonSchemaReferenceInfo = {\n schema: {\n // TODO(dmaretskyi): Include version?\n $ref: echoId ?? DXN.fromTypename(typename!).toString(),\n },\n schemaVersion: version,\n };\n\n // TODO(dmaretskyi): Add name and description.\n const refSchema = Schema.declare<Ref<any>, EncodedReference, []>(\n [],\n {\n encode: () => {\n return (value) =>\n Effect.gen(function* () {\n if (Ref.isRef(value)) {\n return EncodedReference.fromDXN((value as Ref<any>).dxn);\n } else if (EncodedReference.isEncodedReference(value)) {\n return value;\n }\n throw new Error('Invalid reference');\n });\n },\n decode: () => {\n return (value) =>\n Effect.gen(function* () {\n const dbService = yield* Effect.serviceOption(Database.Service);\n\n // TODO(dmaretskyi): This branch seems to be taken by Schema.is\n if (Ref.isRef(value)) {\n if (Option.isSome(dbService)) {\n return dbService.value.db.makeRef(value.dxn);\n } else {\n return value;\n }\n }\n\n if (!EncodedReference.isEncodedReference(value)) {\n return yield* Effect.fail(new ParseResult.Unexpected(value, 'reference'));\n }\n if (Option.isSome(dbService)) {\n return dbService.value.db.makeRef(EncodedReference.toDXN(value));\n } else {\n return Ref.fromDXN(EncodedReference.toDXN(value));\n }\n });\n },\n },\n {\n jsonSchema: {\n // TODO(dmaretskyi): We should remove `$id` and keep `$ref` with a fully qualified name.\n $id: JSON_SCHEMA_ECHO_REF_ID,\n $ref: JSON_SCHEMA_ECHO_REF_ID,\n reference: referenceInfo,\n },\n [ReferenceAnnotationId]: {\n typename: typename ?? '',\n version,\n },\n },\n );\n\n return refSchema;\n};\n\nconst getSchemaExpectedName = (ast: SchemaAST.Annotated): string | undefined => {\n return SchemaAST.getIdentifierAnnotation(ast).pipe(\n Option.orElse(() => SchemaAST.getTitleAnnotation(ast)),\n Option.orElse(() => SchemaAST.getDescriptionAnnotation(ast)),\n Option.getOrElse(() => undefined),\n );\n};\n\nexport interface RefResolver {\n /**\n * Resolve ref synchronously from the objects in the working set.\n *\n * @param dxn\n * @param load If true the resolver should attempt to load the object from disk.\n * @param onLoad Callback to call when the object is loaded.\n */\n resolveSync(dxn: DXN, load: boolean, onLoad?: () => void): AnyProperties | undefined;\n\n /**\n * Resolver ref asynchronously.\n */\n resolve(dxn: DXN): Promise<AnyProperties | undefined>;\n\n // TODO(dmaretskyi): Combine with `resolve`.\n resolveSchema(dxn: DXN): Promise<Schema.Schema.AnyNoContext | undefined>;\n}\n\nexport class RefImpl<T> implements Ref<T> {\n #dxn: DXN;\n #resolver?: RefResolver = undefined;\n #resolved = new Event<void>();\n\n /**\n * Target is set when the reference is created from a specific object.\n * In this case, the target might not be in the database.\n */\n #target: T | undefined = undefined;\n\n /**\n * Callback to issue a reactive notification when object is resolved.\n */\n #resolverCallback = () => {\n this.#resolved.emit();\n };\n\n constructor(dxn: DXN, target?: T) {\n this.#dxn = dxn;\n this.#target = target;\n }\n\n /**\n * @inheritdoc\n */\n get dxn(): DXN {\n return this.#dxn;\n }\n\n /**\n * @inheritdoc\n */\n get isAvailable(): boolean {\n return this.#target !== undefined || this.#resolver !== undefined;\n }\n\n /**\n * @inheritdoc\n */\n get target(): T | undefined {\n if (this.#target) {\n return this.#target;\n }\n\n invariant(this.#resolver, 'Resolver is not set');\n return this.#resolver.resolveSync(this.#dxn, true, this.#resolverCallback) as T | undefined;\n }\n\n /**\n * @inheritdoc\n */\n async load(): Promise<T> {\n if (this.#target) {\n return this.#target;\n }\n invariant(this.#resolver, 'Resolver is not set');\n const obj = await this.#resolver.resolve(this.#dxn);\n if (obj == null) {\n throw new Error('Object not found');\n }\n return obj as T;\n }\n\n /**\n * @inheritdoc\n */\n async tryLoad(): Promise<T | undefined> {\n if (this.#target) {\n return this.#target;\n }\n invariant(this.#resolver, 'Resolver is not set');\n return (await this.#resolver.resolve(this.#dxn)) as T | undefined;\n }\n\n /**\n * Do not inline the target object in the reference.\n * Makes .target unavailable unless the reference is connected to a database context.\n * Clones the reference object.\n */\n noInline(): RefImpl<T> {\n const ref = new RefImpl<T>(this.#dxn, undefined);\n ref.#resolver = this.#resolver;\n return ref;\n }\n\n encode(): EncodedReference {\n return {\n '/': this.#dxn.toString(),\n ...(this.#target ? { target: this.#target } : {}),\n };\n }\n\n /**\n * Serializes the reference to a JSON object.\n * The serialization format is compatible with the IPLD-style encoded references.\n * When a reference has a saved target (i.e. the target or object holding the reference is not in the database),\n * the target is included in the serialized object.\n */\n toJSON(): EncodedReference {\n return this.encode();\n }\n\n toString(): string {\n if (this.#target) {\n return `Ref(${this.#target.toString()})`;\n }\n\n return `Ref(${this.#dxn.toString()})`;\n }\n\n [inspectCustom]: CustomInspectFunction = (depth, options, inspect) => {\n return this.toString();\n };\n\n [RefTypeId] = refVariance;\n\n /**\n * Effect Hash trait. Required for MutableHashMap-based caches (e.g., Atom.family)\n * to deduplicate Ref instances that point to the same object.\n * ECHO proxies return new RefImpl instances on every property access,\n * so without this, each access would create a separate cache entry.\n */\n [Hash.symbol](): number {\n return Hash.hash(this.#dxn.toString());\n }\n\n /** Effect Equal trait. See {@link Hash.symbol} for rationale. */\n [Equal.symbol](that: Equal.Equal): boolean {\n return that instanceof RefImpl && this.#dxn.toString() === that.dxn.toString();\n }\n\n /**\n * Internal method to set the resolver.\n *\n * @internal\n */\n _setResolver(resolver: RefResolver): void {\n this.#resolver = resolver;\n }\n\n /**\n * @internal\n */\n _getSavedTarget(): T | undefined {\n return this.#target;\n }\n\n pipe() {\n // eslint-disable-next-line prefer-rest-params\n return Pipeable.pipeArguments(this, arguments);\n }\n}\n\n/**\n * Internal API for setting the reference resolver.\n */\nexport const setRefResolver = (ref: Ref<any>, resolver: RefResolver) => {\n invariant(ref instanceof RefImpl, 'Ref is not an instance of RefImpl');\n ref._setResolver(resolver);\n};\n\n/**\n * Internal API for getting the saved target on a reference.\n */\nexport const getRefSavedTarget = (ref: Ref<any>): AnyProperties | undefined => {\n invariant(ref instanceof RefImpl, 'Ref is not an instance of RefImpl');\n return ref._getSavedTarget();\n};\n\n// Used to validate reference target type.\nconst refVariance: Ref<any>[typeof RefTypeId] = {\n _T: null as any,\n};\n\nexport const refFromEncodedReference = (encodedReference: EncodedReference, resolver?: RefResolver): Ref<any> => {\n const dxn = DXN.parse(encodedReference['/']);\n const ref = new RefImpl(dxn);\n\n // TODO(dmaretskyi): Handle inline target in the encoded reference.\n\n if (resolver) {\n setRefResolver(ref, resolver);\n }\n return ref;\n};\n\nexport class StaticRefResolver implements RefResolver {\n public objects = new Map<ObjectId, AnyProperties>();\n public schemas = new Map<DXN.String, Schema.Schema.AnyNoContext>();\n\n addObject(obj: AnyProperties): this {\n this.objects.set(obj.id, obj);\n return this;\n }\n\n addSchema(schema: Schema.Schema.AnyNoContext): this {\n const dxn = getSchemaDXN(schema);\n invariant(dxn, 'Schema has no DXN');\n this.schemas.set(dxn.toString(), schema);\n return this;\n }\n\n resolveSync(dxn: DXN, _load: boolean, _onLoad?: () => void): AnyProperties | undefined {\n const id = dxn?.asEchoDXN()?.echoId;\n if (id == null) {\n return undefined;\n }\n\n return this.objects.get(id);\n }\n\n async resolve(dxn: DXN): Promise<AnyProperties | undefined> {\n const id = dxn?.asEchoDXN()?.echoId;\n if (id == null) {\n return undefined;\n }\n\n return this.objects.get(id);\n }\n\n async resolveSchema(dxn: DXN): Promise<Schema.Schema.AnyNoContext | undefined> {\n return this.schemas.get(dxn.toString());\n }\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["Effect", "Equal", "Hash", "Option", "ParseResult", "Pipeable", "Schema", "SchemaAST", "Event", "inspectCustom", "EncodedReference", "assertArgument", "invariant", "DXN", "ObjectId", "JSON_SCHEMA_ECHO_REF_ID", "getSchemaReference", "property", "$id", "reference", "schema", "$ref", "typename", "DXN", "parse", "createSchemaReference", "fromTypename", "toString", "getReferenceAst", "ast", "_tag", "annotations", "ReferenceAnnotationId", "undefined", "version", "RefTypeId", "Symbol", "Ref", "assertArgument", "isSchema", "annotation", "getTypeAnnotation", "Error", "createEchoReferenceSchema", "getTypeIdentifierAnnotation", "isRef", "obj", "hasObjectId", "id", "ref", "dxn", "isLocalObjectId", "parts", "isRefSchema", "isRefSchemaAST", "getAnnotation", "pipe", "isSome", "make", "TypeError", "invariant", "ObjectId", "isValid", "fromLocalObjectId", "RefImpl", "fromDXN", "echoId", "referenceInfo", "schemaVersion", "refSchema", "declare", "encode", "value", "gen", "EncodedReference", "isEncodedReference", "decode", "dbService", "serviceOption", "Service", "db", "makeRef", "fail", "Unexpected", "toDXN", "jsonSchema", "RefImpl", "undefined", "Event", "emit", "dxn", "target", "isAvailable", "invariant", "resolveSync", "load", "obj", "resolve", "Error", "tryLoad", "noInline", "ref", "encode", "toString", "toJSON", "inspectCustom", "depth", "options", "inspect", "RefTypeId", "refVariance", "symbol", "hash", "that", "_setResolver", "resolver", "_getSavedTarget", "pipe", "pipeArguments", "arguments", "setRefResolver", "getRefSavedTarget", "_T", "refFromEncodedReference", "encodedReference", "DXN", "parse", "StaticRefResolver", "objects", "Map", "schemas", "addObject", "set", "id", "addSchema", "schema", "getSchemaDXN", "_load", "_onLoad", "asEchoDXN", "echoId", "get", "resolveSchema"]
7
+ }