@treenity/core 1.0.47 → 3.0.0

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 (696) hide show
  1. package/dist/chain.d.ts +20 -0
  2. package/dist/chain.d.ts.map +1 -0
  3. package/dist/chain.js +59 -0
  4. package/dist/chain.js.map +1 -0
  5. package/dist/client/handle.d.ts +13 -0
  6. package/dist/client/handle.d.ts.map +1 -0
  7. package/dist/client/handle.js +46 -0
  8. package/dist/client/handle.js.map +1 -0
  9. package/dist/client/index.d.ts +21 -0
  10. package/dist/client/index.d.ts.map +1 -0
  11. package/dist/client/index.js +5 -0
  12. package/dist/client/index.js.map +1 -0
  13. package/dist/client/trpc.d.ts +13 -0
  14. package/dist/client/trpc.d.ts.map +1 -0
  15. package/dist/client/trpc.js +78 -0
  16. package/dist/client/trpc.js.map +1 -0
  17. package/dist/client.d.ts +2 -0
  18. package/dist/client.d.ts.map +1 -0
  19. package/dist/client.js +2 -0
  20. package/dist/client.js.map +1 -0
  21. package/dist/comp/handle.d.ts +14 -0
  22. package/dist/comp/handle.d.ts.map +1 -0
  23. package/dist/comp/handle.js +21 -0
  24. package/dist/comp/handle.js.map +1 -0
  25. package/dist/comp/index.d.ts +42 -0
  26. package/dist/comp/index.d.ts.map +1 -0
  27. package/dist/comp/index.js +126 -0
  28. package/dist/comp/index.js.map +1 -0
  29. package/dist/comp/needs.d.ts +26 -0
  30. package/dist/comp/needs.d.ts.map +1 -0
  31. package/dist/comp/needs.js +101 -0
  32. package/dist/comp/needs.js.map +1 -0
  33. package/dist/comp/validate.d.ts +13 -0
  34. package/dist/comp/validate.d.ts.map +1 -0
  35. package/dist/comp/validate.js +117 -0
  36. package/dist/comp/validate.js.map +1 -0
  37. package/dist/comp.d.ts +2 -0
  38. package/dist/comp.d.ts.map +1 -0
  39. package/dist/comp.js +2 -0
  40. package/dist/comp.js.map +1 -0
  41. package/dist/contexts/schema/index.d.ts +7 -0
  42. package/dist/contexts/schema/index.d.ts.map +1 -0
  43. package/dist/contexts/schema/index.js +2 -0
  44. package/dist/contexts/schema/index.js.map +1 -0
  45. package/dist/contexts/schema.d.ts +2 -0
  46. package/dist/contexts/schema.d.ts.map +1 -0
  47. package/dist/contexts/schema.js +2 -0
  48. package/dist/contexts/schema.js.map +1 -0
  49. package/dist/contexts/service/index.d.ts +31 -0
  50. package/dist/contexts/service/index.d.ts.map +1 -0
  51. package/dist/contexts/service/index.js +16 -0
  52. package/dist/contexts/service/index.js.map +1 -0
  53. package/dist/contexts/service.d.ts +1 -14
  54. package/dist/contexts/service.d.ts.map +1 -1
  55. package/dist/contexts/service.js +2 -0
  56. package/dist/contexts/service.js.map +1 -0
  57. package/dist/contexts/telegram/index.d.ts +19 -0
  58. package/dist/contexts/telegram/index.d.ts.map +1 -0
  59. package/dist/contexts/telegram/index.js +89 -0
  60. package/dist/contexts/telegram/index.js.map +1 -0
  61. package/dist/contexts/text/index.d.ts +7 -0
  62. package/dist/contexts/text/index.d.ts.map +1 -0
  63. package/dist/contexts/text/index.js +9 -0
  64. package/dist/contexts/text/index.js.map +1 -0
  65. package/dist/contexts/text.d.ts +2 -0
  66. package/dist/contexts/text.d.ts.map +1 -0
  67. package/dist/contexts/text.js +2 -0
  68. package/dist/contexts/text.js.map +1 -0
  69. package/dist/core/component.d.ts +41 -0
  70. package/dist/core/component.d.ts.map +1 -0
  71. package/dist/core/component.js +105 -0
  72. package/dist/core/component.js.map +1 -0
  73. package/dist/core/context.d.ts +5 -0
  74. package/dist/core/context.d.ts.map +1 -0
  75. package/dist/core/context.js +3 -0
  76. package/dist/core/context.js.map +1 -0
  77. package/dist/core/index.d.ts +5 -0
  78. package/dist/core/index.d.ts.map +1 -0
  79. package/dist/core/index.js +8 -0
  80. package/dist/core/index.js.map +1 -0
  81. package/dist/core/path.d.ts +7 -0
  82. package/dist/core/path.d.ts.map +1 -0
  83. package/dist/core/path.js +37 -0
  84. package/dist/core/path.js.map +1 -0
  85. package/dist/core/registry.d.ts +16 -0
  86. package/dist/core/registry.d.ts.map +1 -0
  87. package/dist/core/registry.js +100 -0
  88. package/dist/core/registry.js.map +1 -0
  89. package/dist/core.d.ts +2 -0
  90. package/dist/core.d.ts.map +1 -0
  91. package/dist/core.js +2 -0
  92. package/dist/core.js.map +1 -0
  93. package/dist/log.d.ts +8 -0
  94. package/dist/log.d.ts.map +1 -0
  95. package/dist/log.js +31 -0
  96. package/dist/log.js.map +1 -0
  97. package/dist/mod/discover.d.ts +4 -0
  98. package/dist/mod/discover.d.ts.map +1 -0
  99. package/dist/mod/discover.js +103 -0
  100. package/dist/mod/discover.js.map +1 -0
  101. package/dist/mod/examples/ticker/seed.d.ts +3 -0
  102. package/dist/mod/examples/ticker/seed.d.ts.map +1 -0
  103. package/dist/mod/examples/ticker/seed.js +16 -0
  104. package/dist/mod/examples/ticker/seed.js.map +1 -0
  105. package/dist/mod/examples/ticker/service.d.ts +2 -0
  106. package/dist/mod/examples/ticker/service.d.ts.map +1 -0
  107. package/dist/mod/examples/ticker/service.js +18 -0
  108. package/dist/mod/examples/ticker/service.js.map +1 -0
  109. package/dist/mod/examples/ticker/types.d.ts +16 -0
  110. package/dist/mod/examples/ticker/types.d.ts.map +1 -0
  111. package/dist/mod/examples/ticker/types.js +20 -0
  112. package/dist/mod/examples/ticker/types.js.map +1 -0
  113. package/dist/mod/examples/ticker/view.d.ts +2 -0
  114. package/dist/mod/examples/ticker/view.d.ts.map +1 -0
  115. package/dist/mod/examples/ticker/view.js +10 -0
  116. package/dist/mod/examples/ticker/view.js.map +1 -0
  117. package/dist/mod/index.d.ts +11 -0
  118. package/dist/mod/index.d.ts.map +1 -0
  119. package/dist/mod/index.js +8 -0
  120. package/dist/mod/index.js.map +1 -0
  121. package/dist/mod/loader.d.ts +18 -0
  122. package/dist/mod/loader.d.ts.map +1 -0
  123. package/dist/mod/loader.js +154 -0
  124. package/dist/mod/loader.js.map +1 -0
  125. package/dist/mod/optimistic.d.ts +34 -0
  126. package/dist/mod/optimistic.d.ts.map +1 -0
  127. package/dist/mod/optimistic.js +176 -0
  128. package/dist/mod/optimistic.js.map +1 -0
  129. package/dist/mod/prefab.d.ts +18 -0
  130. package/dist/mod/prefab.d.ts.map +1 -0
  131. package/dist/mod/prefab.js +42 -0
  132. package/dist/mod/prefab.js.map +1 -0
  133. package/dist/mod/tracking.d.ts +8 -0
  134. package/dist/mod/tracking.d.ts.map +1 -0
  135. package/dist/mod/tracking.js +44 -0
  136. package/dist/mod/tracking.js.map +1 -0
  137. package/dist/mod/types.d.ts +31 -0
  138. package/dist/mod/types.d.ts.map +1 -0
  139. package/dist/mod/types.js +5 -0
  140. package/dist/mod/types.js.map +1 -0
  141. package/dist/mod.d.ts +2 -0
  142. package/dist/mod.d.ts.map +1 -0
  143. package/dist/mod.js +2 -0
  144. package/dist/mod.js.map +1 -0
  145. package/dist/mods/autostart/server.d.ts +2 -0
  146. package/dist/mods/autostart/server.d.ts.map +1 -0
  147. package/dist/mods/autostart/server.js +2 -0
  148. package/dist/mods/autostart/server.js.map +1 -0
  149. package/dist/mods/autostart/service.d.ts +14 -0
  150. package/dist/mods/autostart/service.d.ts.map +1 -0
  151. package/dist/mods/autostart/service.js +88 -0
  152. package/dist/mods/autostart/service.js.map +1 -0
  153. package/dist/mods/llm/index.d.ts +13 -0
  154. package/dist/mods/llm/index.d.ts.map +1 -0
  155. package/dist/mods/llm/index.js +43 -0
  156. package/dist/mods/llm/index.js.map +1 -0
  157. package/dist/mods/llm/server.d.ts +2 -0
  158. package/dist/mods/llm/server.d.ts.map +1 -0
  159. package/dist/mods/llm/server.js +2 -0
  160. package/dist/mods/llm/server.js.map +1 -0
  161. package/dist/mods/mcp/server.d.ts +3 -0
  162. package/dist/mods/mcp/server.d.ts.map +1 -0
  163. package/dist/mods/mcp/server.js +3 -0
  164. package/dist/mods/mcp/server.js.map +1 -0
  165. package/dist/mods/mcp/service.d.ts +2 -0
  166. package/dist/mods/mcp/service.d.ts.map +1 -0
  167. package/dist/mods/mcp/service.js +17 -0
  168. package/dist/mods/mcp/service.js.map +1 -0
  169. package/dist/mods/mcp/types.d.ts +5 -0
  170. package/dist/mods/mcp/types.d.ts.map +1 -0
  171. package/dist/mods/mcp/types.js +7 -0
  172. package/dist/mods/mcp/types.js.map +1 -0
  173. package/dist/mods/treenity/agent-port.d.ts +2 -0
  174. package/dist/mods/treenity/agent-port.d.ts.map +1 -0
  175. package/dist/mods/treenity/agent-port.js +76 -0
  176. package/dist/mods/treenity/agent-port.js.map +1 -0
  177. package/dist/mods/treenity/groups.d.ts +2 -0
  178. package/dist/mods/treenity/groups.d.ts.map +1 -0
  179. package/dist/mods/treenity/groups.js +18 -0
  180. package/dist/mods/treenity/groups.js.map +1 -0
  181. package/dist/mods/treenity/mod-type.d.ts +2 -0
  182. package/dist/mods/treenity/mod-type.d.ts.map +1 -0
  183. package/dist/mods/treenity/mod-type.js +9 -0
  184. package/dist/mods/treenity/mod-type.js.map +1 -0
  185. package/dist/mods/treenity/seed.d.ts +2 -0
  186. package/dist/mods/treenity/seed.d.ts.map +1 -0
  187. package/dist/mods/treenity/seed.js +53 -0
  188. package/dist/mods/treenity/seed.js.map +1 -0
  189. package/dist/mods/treenity/server.d.ts +5 -0
  190. package/dist/mods/treenity/server.d.ts.map +1 -0
  191. package/dist/mods/treenity/server.js +5 -0
  192. package/dist/mods/treenity/server.js.map +1 -0
  193. package/dist/mods/treenity/system.d.ts +36 -0
  194. package/dist/mods/treenity/system.d.ts.map +1 -0
  195. package/dist/mods/treenity/system.js +61 -0
  196. package/dist/mods/treenity/system.js.map +1 -0
  197. package/dist/mods/uix/client.d.ts +3 -0
  198. package/dist/mods/uix/client.d.ts.map +1 -0
  199. package/dist/mods/uix/client.js +96 -0
  200. package/dist/mods/uix/client.js.map +1 -0
  201. package/dist/mods/uix/compile.d.ts +7 -0
  202. package/dist/mods/uix/compile.d.ts.map +1 -0
  203. package/dist/mods/uix/compile.js +94 -0
  204. package/dist/mods/uix/compile.js.map +1 -0
  205. package/dist/mods/uix/jsx-parser.d.ts +2 -0
  206. package/dist/mods/uix/jsx-parser.d.ts.map +1 -0
  207. package/dist/mods/uix/jsx-parser.js +565 -0
  208. package/dist/mods/uix/jsx-parser.js.map +1 -0
  209. package/dist/mods/uix/verify.d.ts +7 -0
  210. package/dist/mods/uix/verify.d.ts.map +1 -0
  211. package/dist/mods/uix/verify.js +59 -0
  212. package/dist/mods/uix/verify.js.map +1 -0
  213. package/dist/schema/catalog.d.ts +23 -0
  214. package/dist/schema/catalog.d.ts.map +1 -0
  215. package/dist/schema/catalog.js +82 -0
  216. package/dist/schema/catalog.js.map +1 -0
  217. package/dist/schema/extract-schemas.d.ts +5 -0
  218. package/dist/schema/extract-schemas.d.ts.map +1 -0
  219. package/dist/schema/extract-schemas.js +444 -0
  220. package/dist/schema/extract-schemas.js.map +1 -0
  221. package/dist/schema/load.d.ts +2 -0
  222. package/dist/schema/load.d.ts.map +1 -0
  223. package/dist/schema/load.js +23 -0
  224. package/dist/schema/load.js.map +1 -0
  225. package/dist/schema/test-fixture.types.d.ts +2 -0
  226. package/dist/schema/test-fixture.types.d.ts.map +1 -0
  227. package/dist/schema/test-fixture.types.js +19 -0
  228. package/dist/schema/test-fixture.types.js.map +1 -0
  229. package/dist/schema/test-opaque.d.ts +3 -0
  230. package/dist/schema/test-opaque.d.ts.map +1 -0
  231. package/dist/schema/test-opaque.js +43 -0
  232. package/dist/schema/test-opaque.js.map +1 -0
  233. package/dist/schema/types.d.ts +37 -0
  234. package/dist/schema/types.d.ts.map +1 -0
  235. package/dist/schema/types.js +3 -0
  236. package/dist/schema/types.js.map +1 -0
  237. package/dist/server/actions.d.ts +35 -0
  238. package/dist/server/actions.d.ts.map +1 -0
  239. package/dist/server/actions.js +170 -0
  240. package/dist/server/actions.js.map +1 -0
  241. package/dist/server/agent.d.ts +6 -0
  242. package/dist/server/agent.d.ts.map +1 -0
  243. package/dist/server/agent.js +15 -0
  244. package/dist/server/agent.js.map +1 -0
  245. package/dist/server/auth.d.ts +39 -0
  246. package/dist/server/auth.d.ts.map +1 -0
  247. package/dist/server/auth.js +335 -0
  248. package/dist/server/auth.js.map +1 -0
  249. package/dist/server/client.d.ts +183 -0
  250. package/dist/server/client.d.ts.map +1 -0
  251. package/dist/server/client.js +22 -0
  252. package/dist/server/client.js.map +1 -0
  253. package/dist/server/cookies.d.ts +5 -0
  254. package/dist/server/cookies.d.ts.map +1 -0
  255. package/dist/server/cookies.js +24 -0
  256. package/dist/server/cookies.js.map +1 -0
  257. package/dist/server/doc-index.d.ts +38 -0
  258. package/dist/server/doc-index.d.ts.map +1 -0
  259. package/dist/server/doc-index.js +244 -0
  260. package/dist/server/doc-index.js.map +1 -0
  261. package/dist/server/errors.d.ts +7 -0
  262. package/dist/server/errors.d.ts.map +1 -0
  263. package/dist/server/errors.js +11 -0
  264. package/dist/server/errors.js.map +1 -0
  265. package/dist/server/factory.d.ts +23 -0
  266. package/dist/server/factory.d.ts.map +1 -0
  267. package/dist/server/factory.js +70 -0
  268. package/dist/server/factory.js.map +1 -0
  269. package/dist/server/main.d.ts +6 -0
  270. package/dist/server/main.d.ts.map +1 -0
  271. package/dist/server/main.js +45 -0
  272. package/dist/server/main.js.map +1 -0
  273. package/dist/server/mcp.d.ts +5 -0
  274. package/dist/server/mcp.d.ts.map +1 -0
  275. package/dist/server/mcp.js +280 -0
  276. package/dist/server/mcp.js.map +1 -0
  277. package/dist/server/migrate.d.ts +3 -0
  278. package/dist/server/migrate.d.ts.map +1 -0
  279. package/dist/server/migrate.js +56 -0
  280. package/dist/server/migrate.js.map +1 -0
  281. package/dist/server/mod-catalog.d.ts +14 -0
  282. package/dist/server/mod-catalog.d.ts.map +1 -0
  283. package/dist/server/mod-catalog.js +40 -0
  284. package/dist/server/mod-catalog.js.map +1 -0
  285. package/dist/server/mods-mount.d.ts +4 -0
  286. package/dist/server/mods-mount.d.ts.map +1 -0
  287. package/dist/server/mods-mount.js +169 -0
  288. package/dist/server/mods-mount.js.map +1 -0
  289. package/dist/server/mount-adapters.d.ts +9 -0
  290. package/dist/server/mount-adapters.d.ts.map +1 -0
  291. package/dist/server/mount-adapters.js +75 -0
  292. package/dist/server/mount-adapters.js.map +1 -0
  293. package/dist/server/mount.d.ts +3 -0
  294. package/dist/server/mount.d.ts.map +1 -0
  295. package/dist/server/mount.js +195 -0
  296. package/dist/server/mount.js.map +1 -0
  297. package/dist/server/prefab.d.ts +18 -0
  298. package/dist/server/prefab.d.ts.map +1 -0
  299. package/dist/server/prefab.js +70 -0
  300. package/dist/server/prefab.js.map +1 -0
  301. package/dist/server/seed/index.d.ts +6 -0
  302. package/dist/server/seed/index.d.ts.map +1 -0
  303. package/dist/server/seed/index.js +16 -0
  304. package/dist/server/seed/index.js.map +1 -0
  305. package/dist/server/server.d.ts +28 -0
  306. package/dist/server/server.d.ts.map +1 -0
  307. package/dist/server/server.js +117 -0
  308. package/dist/server/server.js.map +1 -0
  309. package/dist/server/sub.d.ts +34 -0
  310. package/dist/server/sub.d.ts.map +1 -0
  311. package/dist/server/sub.js +174 -0
  312. package/dist/server/sub.js.map +1 -0
  313. package/dist/server/trpc.d.ts +192 -0
  314. package/dist/server/trpc.d.ts.map +1 -0
  315. package/dist/server/trpc.js +319 -0
  316. package/dist/server/trpc.js.map +1 -0
  317. package/dist/server/types-mount.d.ts +3 -0
  318. package/dist/server/types-mount.d.ts.map +1 -0
  319. package/dist/server/types-mount.js +144 -0
  320. package/dist/server/types-mount.js.map +1 -0
  321. package/dist/server/validate.d.ts +3 -0
  322. package/dist/server/validate.d.ts.map +1 -0
  323. package/dist/server/validate.js +20 -0
  324. package/dist/server/validate.js.map +1 -0
  325. package/dist/server/volatile.d.ts +11 -0
  326. package/dist/server/volatile.d.ts.map +1 -0
  327. package/dist/server/volatile.js +26 -0
  328. package/dist/server/volatile.js.map +1 -0
  329. package/dist/server/watch.d.ts +23 -0
  330. package/dist/server/watch.d.ts.map +1 -0
  331. package/dist/server/watch.js +178 -0
  332. package/dist/server/watch.js.map +1 -0
  333. package/dist/tree/cache.d.ts +3 -0
  334. package/dist/tree/cache.d.ts.map +1 -0
  335. package/dist/tree/cache.js +48 -0
  336. package/dist/tree/cache.js.map +1 -0
  337. package/dist/tree/fs.d.ts +3 -0
  338. package/dist/tree/fs.d.ts.map +1 -0
  339. package/dist/tree/fs.js +274 -0
  340. package/dist/tree/fs.js.map +1 -0
  341. package/dist/tree/index.d.ts +38 -0
  342. package/dist/tree/index.d.ts.map +1 -0
  343. package/dist/tree/index.js +182 -0
  344. package/dist/tree/index.js.map +1 -0
  345. package/dist/tree/inflight.d.ts +2 -0
  346. package/dist/tree/inflight.d.ts.map +1 -0
  347. package/dist/tree/inflight.js +15 -0
  348. package/dist/tree/inflight.js.map +1 -0
  349. package/dist/tree/json-codec.d.ts +2 -0
  350. package/dist/tree/json-codec.d.ts.map +1 -0
  351. package/dist/tree/json-codec.js +13 -0
  352. package/dist/tree/json-codec.js.map +1 -0
  353. package/dist/tree/mimefs.d.ts +13 -0
  354. package/dist/tree/mimefs.d.ts.map +1 -0
  355. package/dist/tree/mimefs.js +124 -0
  356. package/dist/tree/mimefs.js.map +1 -0
  357. package/dist/tree/mongo.d.ts +5 -0
  358. package/dist/tree/mongo.d.ts.map +1 -0
  359. package/dist/tree/mongo.js +110 -0
  360. package/dist/tree/mongo.js.map +1 -0
  361. package/dist/tree/patch.d.ts +30 -0
  362. package/dist/tree/patch.d.ts.map +1 -0
  363. package/dist/tree/patch.js +112 -0
  364. package/dist/tree/patch.js.map +1 -0
  365. package/dist/tree/query.d.ts +12 -0
  366. package/dist/tree/query.d.ts.map +1 -0
  367. package/dist/tree/query.js +61 -0
  368. package/dist/tree/query.js.map +1 -0
  369. package/dist/tree/repath.d.ts +3 -0
  370. package/dist/tree/repath.d.ts.map +1 -0
  371. package/dist/tree/repath.js +38 -0
  372. package/dist/tree/repath.js.map +1 -0
  373. package/dist/tree-chain.d.ts +18 -0
  374. package/dist/tree-chain.d.ts.map +1 -0
  375. package/dist/tree-chain.js +109 -0
  376. package/dist/tree-chain.js.map +1 -0
  377. package/dist/tree.d.ts +2 -0
  378. package/dist/tree.d.ts.map +1 -0
  379. package/dist/tree.js +2 -0
  380. package/dist/tree.js.map +1 -0
  381. package/dist/uri.d.ts +11 -0
  382. package/dist/uri.d.ts.map +1 -0
  383. package/dist/uri.js +79 -0
  384. package/dist/uri.js.map +1 -0
  385. package/package.json +39 -40
  386. package/src/chain.test.ts +190 -0
  387. package/src/chain.ts +82 -0
  388. package/src/client/client.test.ts +192 -0
  389. package/src/client/handle.ts +53 -0
  390. package/src/client/index.ts +18 -0
  391. package/src/client/trpc.ts +91 -0
  392. package/src/client.ts +1 -0
  393. package/src/comp/CLAUDE.md +14 -0
  394. package/src/comp/handle.ts +36 -0
  395. package/src/comp/index.test.ts +129 -0
  396. package/src/comp/index.ts +175 -0
  397. package/src/comp/needs.test.ts +499 -0
  398. package/src/comp/needs.ts +113 -0
  399. package/src/comp/validate.test.ts +304 -0
  400. package/src/comp/validate.ts +125 -0
  401. package/src/comp.ts +1 -0
  402. package/src/contexts/schema/index.ts +7 -0
  403. package/src/contexts/schema.ts +1 -0
  404. package/src/contexts/service/index.test.ts +323 -0
  405. package/src/contexts/service/index.ts +43 -0
  406. package/src/contexts/service.ts +1 -0
  407. package/src/contexts/telegram/index.ts +115 -0
  408. package/src/contexts/text/index.test.ts +31 -0
  409. package/src/contexts/text/index.ts +18 -0
  410. package/src/contexts/text.ts +1 -0
  411. package/src/core/component.ts +151 -0
  412. package/src/core/context.ts +14 -0
  413. package/src/core/index.test.ts +203 -0
  414. package/src/core/index.ts +9 -0
  415. package/src/core/path.ts +35 -0
  416. package/src/core/registry.ts +115 -0
  417. package/src/core.ts +1 -0
  418. package/src/log.test.ts +70 -0
  419. package/src/log.ts +28 -0
  420. package/src/mod/discover.test.ts +133 -0
  421. package/src/mod/discover.ts +100 -0
  422. package/src/mod/docs/00-index.md +19 -0
  423. package/src/mod/docs/01-primitives.md +38 -0
  424. package/src/mod/docs/02-core-api.md +68 -0
  425. package/src/mod/docs/03-registry.md +30 -0
  426. package/src/mod/docs/04-store.md +62 -0
  427. package/src/mod/docs/05-comp.md +111 -0
  428. package/src/mod/docs/06-actions.md +193 -0
  429. package/src/mod/docs/07-realtime.md +100 -0
  430. package/src/mod/docs/08-services.md +33 -0
  431. package/src/mod/docs/09-mounts.md +43 -0
  432. package/src/mod/docs/10-acl.md +60 -0
  433. package/src/mod/docs/11-server.md +62 -0
  434. package/src/mod/docs/12-conventions.md +65 -0
  435. package/src/mod/docs/13-example.md +132 -0
  436. package/src/mod/docs/14-mod-format.md +304 -0
  437. package/src/mod/docs/15-documenting-types.md +156 -0
  438. package/src/mod/examples/ticker/seed.ts +19 -0
  439. package/src/mod/examples/ticker/service.ts +20 -0
  440. package/src/mod/examples/ticker/ticker.test.ts +18 -0
  441. package/src/mod/examples/ticker/types.ts +22 -0
  442. package/src/mod/examples/ticker/view.tsx +19 -0
  443. package/src/mod/index.ts +12 -0
  444. package/src/mod/loader.test.ts +168 -0
  445. package/src/mod/loader.ts +174 -0
  446. package/src/mod/optimistic.test.ts +446 -0
  447. package/src/mod/optimistic.ts +210 -0
  448. package/src/mod/prefab.ts +62 -0
  449. package/src/mod/tracking.test.ts +59 -0
  450. package/src/mod/tracking.ts +51 -0
  451. package/src/mod/types.ts +40 -0
  452. package/src/mod.ts +1 -0
  453. package/src/mods/autostart/CLAUDE.md +6 -0
  454. package/src/mods/autostart/autostart.test.ts +85 -0
  455. package/src/mods/autostart/server.ts +1 -0
  456. package/src/mods/autostart/service.ts +98 -0
  457. package/src/mods/llm/CLAUDE.md +6 -0
  458. package/src/mods/llm/index.ts +57 -0
  459. package/src/mods/llm/llm.test.ts +109 -0
  460. package/src/mods/llm/server.ts +1 -0
  461. package/src/mods/mcp/CLAUDE.md +6 -0
  462. package/src/mods/mcp/server.ts +2 -0
  463. package/src/mods/mcp/service.ts +19 -0
  464. package/src/mods/mcp/types.ts +7 -0
  465. package/src/mods/treenity/agent-port.ts +93 -0
  466. package/src/mods/treenity/groups.ts +19 -0
  467. package/src/mods/treenity/mod-type.ts +10 -0
  468. package/src/mods/treenity/seed.ts +56 -0
  469. package/src/mods/treenity/server.ts +4 -0
  470. package/src/mods/treenity/system.ts +70 -0
  471. package/src/mods/uix/CLAUDE.md +7 -0
  472. package/src/mods/uix/client.ts +117 -0
  473. package/src/mods/uix/compile.test.ts +228 -0
  474. package/src/mods/uix/compile.ts +110 -0
  475. package/src/mods/uix/jsx-parser.test.ts +554 -0
  476. package/src/mods/uix/jsx-parser.ts +489 -0
  477. package/src/mods/uix/lazy-load.test.ts +261 -0
  478. package/src/mods/uix/uix-repomix.md +3509 -0
  479. package/src/mods/uix/verify.ts +68 -0
  480. package/src/schema/CLAUDE.md +13 -0
  481. package/src/schema/catalog.ts +101 -0
  482. package/src/schema/extract-schemas.test.ts +84 -0
  483. package/src/schema/extract-schemas.ts +462 -0
  484. package/src/schema/generated/autostart.json +44 -0
  485. package/src/schema/generated/board.column.json +25 -0
  486. package/src/schema/generated/board.task.json +147 -0
  487. package/src/schema/generated/brahman.action.back.json +12 -0
  488. package/src/schema/generated/brahman.action.broadcast.json +31 -0
  489. package/src/schema/generated/brahman.action.call.json +57 -0
  490. package/src/schema/generated/brahman.action.emittext.json +23 -0
  491. package/src/schema/generated/brahman.action.eval.json +23 -0
  492. package/src/schema/generated/brahman.action.file.json +28 -0
  493. package/src/schema/generated/brahman.action.forward.json +29 -0
  494. package/src/schema/generated/brahman.action.getvalue.json +28 -0
  495. package/src/schema/generated/brahman.action.ifelse.json +42 -0
  496. package/src/schema/generated/brahman.action.keywordselect.json +46 -0
  497. package/src/schema/generated/brahman.action.message.json +127 -0
  498. package/src/schema/generated/brahman.action.onerror.json +29 -0
  499. package/src/schema/generated/brahman.action.page.json +22 -0
  500. package/src/schema/generated/brahman.action.params.json +36 -0
  501. package/src/schema/generated/brahman.action.question.json +43 -0
  502. package/src/schema/generated/brahman.action.remove.json +12 -0
  503. package/src/schema/generated/brahman.action.resethistory.json +12 -0
  504. package/src/schema/generated/brahman.action.resetsession.json +12 -0
  505. package/src/schema/generated/brahman.action.selectlang.json +20 -0
  506. package/src/schema/generated/brahman.action.setvalue.json +27 -0
  507. package/src/schema/generated/brahman.action.tag.json +27 -0
  508. package/src/schema/generated/brahman.bot.json +68 -0
  509. package/src/schema/generated/brahman.page.json +25 -0
  510. package/src/schema/generated/brahman.session.json +29 -0
  511. package/src/schema/generated/brahman.user.json +58 -0
  512. package/src/schema/generated/cafe.contact.json +56 -0
  513. package/src/schema/generated/cafe.mail.json +29 -0
  514. package/src/schema/generated/default.json +15 -0
  515. package/src/schema/generated/doc.page.json +23 -0
  516. package/src/schema/generated/examples.demo.generator.json +16 -0
  517. package/src/schema/generated/examples.demo.sensor.json +35 -0
  518. package/src/schema/generated/groups.json +20 -0
  519. package/src/schema/generated/launcher.json +91 -0
  520. package/src/schema/generated/mcp.server.json +15 -0
  521. package/src/schema/generated/mindmap.map.json +22 -0
  522. package/src/schema/generated/sim.agent.json +24 -0
  523. package/src/schema/generated/sim.ai.json +24 -0
  524. package/src/schema/generated/sim.config.json +38 -0
  525. package/src/schema/generated/sim.descriptive.json +26 -0
  526. package/src/schema/generated/sim.events.json +47 -0
  527. package/src/schema/generated/sim.item.json +20 -0
  528. package/src/schema/generated/sim.memory.json +17 -0
  529. package/src/schema/generated/sim.nearby.json +17 -0
  530. package/src/schema/generated/sim.position.json +25 -0
  531. package/src/schema/generated/sim.round.json +64 -0
  532. package/src/schema/generated/sim.world.json +32 -0
  533. package/src/schema/generated/t.agent.port.json +74 -0
  534. package/src/schema/generated/t.llm.json +20 -0
  535. package/src/schema/generated/t.mod.json +27 -0
  536. package/src/schema/generated/t3d.animator.json +46 -0
  537. package/src/schema/generated/t3d.audio.json +58 -0
  538. package/src/schema/generated/t3d.camera.json +50 -0
  539. package/src/schema/generated/t3d.collider.json +84 -0
  540. package/src/schema/generated/t3d.light.json +90 -0
  541. package/src/schema/generated/t3d.line.json +47 -0
  542. package/src/schema/generated/t3d.lod.json +28 -0
  543. package/src/schema/generated/t3d.material.json +131 -0
  544. package/src/schema/generated/t3d.mesh.json +65 -0
  545. package/src/schema/generated/t3d.object.json +64 -0
  546. package/src/schema/generated/t3d.particles.json +109 -0
  547. package/src/schema/generated/t3d.rigidbody.json +81 -0
  548. package/src/schema/generated/t3d.scene.json +7 -0
  549. package/src/schema/generated/t3d.script.json +23 -0
  550. package/src/schema/generated/t3d.text.json +86 -0
  551. package/src/schema/generated/t3d.trail.json +45 -0
  552. package/src/schema/generated/task.json +96 -0
  553. package/src/schema/generated/test.fixture.json +43 -0
  554. package/src/schema/generated/ticker.config.json +43 -0
  555. package/src/schema/generated/ticker.price.json +20 -0
  556. package/src/schema/generated/todo.item.json +25 -0
  557. package/src/schema/generated/todo.list.json +33 -0
  558. package/src/schema/generated/treenity.system.json +259 -0
  559. package/src/schema/generated/whisper.audio.json +25 -0
  560. package/src/schema/generated/whisper.checklist.json +17 -0
  561. package/src/schema/generated/whisper.config.json +30 -0
  562. package/src/schema/generated/whisper.inbox.json +24 -0
  563. package/src/schema/generated/whisper.meta.json +35 -0
  564. package/src/schema/generated/whisper.text.json +16 -0
  565. package/src/schema/load.ts +24 -0
  566. package/src/schema/schema.test.ts +86 -0
  567. package/src/schema/test-fixture.types.ts +21 -0
  568. package/src/schema/test-opaque.ts +42 -0
  569. package/src/schema/types.ts +33 -0
  570. package/src/server/CLAUDE.md +26 -0
  571. package/src/server/actions.test.ts +272 -0
  572. package/src/server/actions.ts +274 -0
  573. package/src/server/agent-sub.test.ts +90 -0
  574. package/src/server/agent.test.ts +305 -0
  575. package/src/server/agent.ts +17 -0
  576. package/src/server/api.test.ts +454 -0
  577. package/src/server/auth.test.ts +441 -0
  578. package/src/server/auth.ts +386 -0
  579. package/src/server/client.ts +24 -0
  580. package/src/server/conditions.test.ts +128 -0
  581. package/src/server/cookies.ts +25 -0
  582. package/src/server/coverage.test.ts +827 -0
  583. package/src/server/doc-index.ts +286 -0
  584. package/src/server/e2e.test.ts +966 -0
  585. package/src/server/errors.ts +11 -0
  586. package/src/server/factory.ts +99 -0
  587. package/src/server/main.ts +56 -0
  588. package/src/server/mcp.ts +326 -0
  589. package/src/server/migrate.test.ts +123 -0
  590. package/src/server/migrate.ts +62 -0
  591. package/src/server/mod-catalog.ts +59 -0
  592. package/src/server/mods-mount.ts +179 -0
  593. package/src/server/mount-adapters.ts +82 -0
  594. package/src/server/mount.parametrized.test.ts +52 -0
  595. package/src/server/mount.query.test.ts +127 -0
  596. package/src/server/mount.test.ts +497 -0
  597. package/src/server/mount.ts +208 -0
  598. package/src/server/prefab.test.ts +415 -0
  599. package/src/server/prefab.ts +104 -0
  600. package/src/server/seed/index.ts +24 -0
  601. package/src/server/server.ts +153 -0
  602. package/src/server/stress.test.ts +844 -0
  603. package/src/server/sub.test.ts +55 -0
  604. package/src/server/sub.ts +224 -0
  605. package/src/server/trpc.ts +369 -0
  606. package/src/server/types-mount.ts +142 -0
  607. package/src/server/validate.test.ts +91 -0
  608. package/src/server/validate.ts +22 -0
  609. package/src/server/volatile.test.ts +140 -0
  610. package/src/server/volatile.ts +32 -0
  611. package/src/server/watch.test.ts +594 -0
  612. package/src/server/watch.ts +202 -0
  613. package/src/server/workflow.test.ts +82 -0
  614. package/src/tree/CLAUDE.md +13 -0
  615. package/src/tree/cache.test.ts +213 -0
  616. package/src/tree/cache.ts +51 -0
  617. package/src/tree/fs.test.ts +247 -0
  618. package/src/tree/fs.ts +251 -0
  619. package/src/tree/index.test.ts +164 -0
  620. package/src/tree/index.ts +216 -0
  621. package/src/tree/inflight.ts +15 -0
  622. package/src/tree/json-codec.ts +16 -0
  623. package/src/tree/mimefs.test.ts +289 -0
  624. package/src/tree/mimefs.ts +142 -0
  625. package/src/tree/mongo.ts +125 -0
  626. package/src/tree/patch.test.ts +192 -0
  627. package/src/tree/patch.ts +133 -0
  628. package/src/tree/query.test.ts +110 -0
  629. package/src/tree/query.ts +70 -0
  630. package/src/tree/repath.test.ts +86 -0
  631. package/src/tree/repath.ts +53 -0
  632. package/src/tree-chain.test.ts +723 -0
  633. package/src/tree-chain.ts +144 -0
  634. package/src/tree.ts +1 -0
  635. package/src/uri.test.ts +86 -0
  636. package/src/uri.ts +82 -0
  637. package/CHANGELOG.md +0 -305
  638. package/README.md +0 -18
  639. package/dist/context.d.ts +0 -41
  640. package/dist/context.d.ts.map +0 -1
  641. package/dist/context.mjs +0 -81
  642. package/dist/context.mjs.map +0 -1
  643. package/dist/contexts/node-engine.d.ts +0 -12
  644. package/dist/contexts/node-engine.d.ts.map +0 -1
  645. package/dist/contexts/node-engine.mjs +0 -7
  646. package/dist/contexts/node-engine.mjs.map +0 -1
  647. package/dist/contexts/noflo/types.d.ts +0 -20
  648. package/dist/contexts/noflo/types.d.ts.map +0 -1
  649. package/dist/contexts/object.d.ts +0 -11
  650. package/dist/contexts/object.d.ts.map +0 -1
  651. package/dist/contexts/object.mjs +0 -15
  652. package/dist/contexts/object.mjs.map +0 -1
  653. package/dist/contexts/proto.d.ts +0 -11
  654. package/dist/contexts/proto.d.ts.map +0 -1
  655. package/dist/contexts/proto.mjs +0 -7
  656. package/dist/contexts/proto.mjs.map +0 -1
  657. package/dist/contexts/react-context.d.ts +0 -21
  658. package/dist/contexts/react-context.d.ts.map +0 -1
  659. package/dist/contexts/react-context.mjs +0 -24
  660. package/dist/contexts/react-context.mjs.map +0 -1
  661. package/dist/contexts/service.mjs +0 -7
  662. package/dist/contexts/service.mjs.map +0 -1
  663. package/dist/get-type-cache.d.ts +0 -2
  664. package/dist/get-type-cache.d.ts.map +0 -1
  665. package/dist/get-type-cache.mjs +0 -7
  666. package/dist/get-type-cache.mjs.map +0 -1
  667. package/dist/index.d.ts +0 -13
  668. package/dist/index.d.ts.map +0 -1
  669. package/dist/index.mjs +0 -10
  670. package/dist/index.mjs.map +0 -1
  671. package/dist/link/link.d.ts +0 -25
  672. package/dist/link/link.d.ts.map +0 -1
  673. package/dist/link/link.mjs +0 -72
  674. package/dist/link/link.mjs.map +0 -1
  675. package/dist/link/link.test.d.ts +0 -2
  676. package/dist/link/link.test.d.ts.map +0 -1
  677. package/dist/loading.d.ts +0 -9
  678. package/dist/loading.d.ts.map +0 -1
  679. package/dist/meta-type.d.ts +0 -58
  680. package/dist/meta-type.d.ts.map +0 -1
  681. package/dist/meta-type.mjs +0 -104
  682. package/dist/meta-type.mjs.map +0 -1
  683. package/dist/meta.d.ts +0 -20
  684. package/dist/meta.d.ts.map +0 -1
  685. package/dist/meta.mjs +0 -16
  686. package/dist/meta.mjs.map +0 -1
  687. package/dist/node/index.d.ts +0 -2
  688. package/dist/node/index.d.ts.map +0 -1
  689. package/dist/node/types.d.ts +0 -37
  690. package/dist/node/types.d.ts.map +0 -1
  691. package/dist/test/context.test.d.ts +0 -2
  692. package/dist/test/context.test.d.ts.map +0 -1
  693. package/dist/types.d.ts +0 -14
  694. package/dist/types.d.ts.map +0 -1
  695. package/dist/types.mjs +0 -16
  696. package/dist/types.mjs.map +0 -1
@@ -0,0 +1,844 @@
1
+ // Treenity Stress Tests — E2E through full server pipeline
2
+ // Tests: throughput, race conditions, OCC, subscriptions, CDC, query mounts, watch fan-out
3
+
4
+ import { createNode, type NodeData, register } from '#core';
5
+ import { clearRegistry } from '#core/index.test';
6
+ import { createMemoryTree, type Tree } from '#tree';
7
+ import { createQueryTree } from '#tree/query';
8
+ import { enablePatches } from 'immer';
9
+ import assert from 'node:assert/strict';
10
+ import { beforeEach, describe, it } from 'node:test';
11
+ import { executeAction } from './actions';
12
+ import { withMounts } from './mount';
13
+ import { type NodeEvent, type ReactiveTree, unwatchAllQueries, watchQuery, withSubscriptions } from './sub';
14
+ import { withValidation } from './validate';
15
+ import { withVolatile } from './volatile';
16
+ import { createWatchManager, type WatchManager } from './watch';
17
+
18
+ enablePatches();
19
+
20
+ // ── Helpers ──
21
+
22
+ function fullPipeline() {
23
+ const bootstrap = createMemoryTree();
24
+ const mountable = withMounts(bootstrap);
25
+ const volatile = withVolatile(mountable);
26
+ const validated = withValidation(volatile);
27
+ const watcher = createWatchManager();
28
+ const store = withSubscriptions(validated, (e) => watcher.notify(e));
29
+ return { bootstrap, mountable, store, watcher };
30
+ }
31
+
32
+ function timer() {
33
+ const start = performance.now();
34
+ return {
35
+ elapsed: () => performance.now() - start,
36
+ opsPerSec: (ops: number) => Math.round(ops / ((performance.now() - start) / 1000)),
37
+ };
38
+ }
39
+
40
+ async function timeBatch(label: string, ops: number, fn: (i: number) => Promise<void>, progressEvery = 0) {
41
+ const t = timer();
42
+ for (let i = 0; i < ops; i++) {
43
+ await fn(i);
44
+ if (progressEvery && (i + 1) % progressEvery === 0) {
45
+ const rate = t.opsPerSec(i + 1);
46
+ console.log(` ...${i + 1}/${ops} (${rate} ops/s)`);
47
+ }
48
+ }
49
+ const elapsed = t.elapsed();
50
+ const rate = t.opsPerSec(ops);
51
+ console.log(` ✓ [${label}] ${ops} ops in ${elapsed.toFixed(0)}ms — ${rate} ops/s`);
52
+ return { elapsed, rate };
53
+ }
54
+
55
+ // ── 1. Raw Throughput ──
56
+
57
+ describe('Stress: throughput', () => {
58
+ let store: ReactiveTree;
59
+
60
+ beforeEach(() => {
61
+ clearRegistry();
62
+ ({ store } = fullPipeline());
63
+ });
64
+
65
+ it('set throughput — 2k nodes', async () => {
66
+ const { rate } = await timeBatch('set', 2_000, (i) =>
67
+ store.set(createNode(`/bench/n${i}`, 'item', { value: i })),
68
+ 500);
69
+ assert.ok(rate > 100, `Expected > 100 ops/s, got ${rate}`);
70
+ });
71
+
72
+ it('get throughput — 5k reads', async () => {
73
+ console.log(' seeding 500 nodes...');
74
+ for (let i = 0; i < 500; i++)
75
+ await store.set(createNode(`/bench/n${i}`, 'item', { value: i }));
76
+
77
+ const { rate } = await timeBatch('get', 5_000, (i) =>
78
+ store.get(`/bench/n${i % 500}`) as Promise<any>,
79
+ 1000);
80
+ assert.ok(rate > 3000, `Expected > 3000 ops/s, got ${rate}`);
81
+ });
82
+
83
+ it('getChildren throughput — 500 queries over 200 children', async () => {
84
+ console.log(' seeding 200 children...');
85
+ for (let i = 0; i < 200; i++)
86
+ await store.set(createNode(`/list/c${i}`, 'item', { value: i }));
87
+
88
+ const { rate } = await timeBatch('getChildren', 500, () =>
89
+ store.getChildren('/list', { limit: 50 }) as Promise<any>,
90
+ 100);
91
+ assert.ok(rate > 200, `Expected > 200 ops/s, got ${rate}`);
92
+ });
93
+
94
+ it('mixed read/write — 2k random ops', async () => {
95
+ console.log(' seeding 100 nodes...');
96
+ for (let i = 0; i < 100; i++)
97
+ await store.set(createNode(`/mixed/n${i}`, 'item', { value: i }));
98
+
99
+ let reads = 0, writes = 0;
100
+ const { rate } = await timeBatch('mixed r/w', 2_000, async (i) => {
101
+ if (Math.random() < 0.7) {
102
+ await store.get(`/mixed/n${i % 100}`);
103
+ reads++;
104
+ } else {
105
+ await store.set(createNode(`/mixed/n${i % 100}`, 'item', { value: i }));
106
+ writes++;
107
+ }
108
+ }, 500);
109
+ console.log(` reads=${reads} writes=${writes}`);
110
+ assert.ok(rate > 500, `Expected > 500 ops/s, got ${rate}`);
111
+ });
112
+ });
113
+
114
+ // ── 2. Concurrent Writes + OCC ──
115
+
116
+ describe('Stress: OCC race conditions', () => {
117
+ let store: ReactiveTree;
118
+
119
+ beforeEach(() => {
120
+ clearRegistry();
121
+ ({ store } = fullPipeline());
122
+ });
123
+
124
+ it('concurrent writes to same node — exactly one wins per round', async () => {
125
+ await store.set(createNode('/race/target', 'counter', { count: 0 }));
126
+
127
+ let conflicts = 0;
128
+ let successes = 0;
129
+ const rounds = 100;
130
+
131
+ for (let round = 0; round < rounds; round++) {
132
+ const node = (await store.get('/race/target'))!;
133
+ const writers = 5;
134
+ const results = await Promise.allSettled(
135
+ Array.from({ length: writers }, (_, w) =>
136
+ store.set({ ...node, count: (node as any).count + 1, writer: w } as NodeData),
137
+ ),
138
+ );
139
+
140
+ const ok = results.filter((r) => r.status === 'fulfilled').length;
141
+ const fail = results.filter((r) => r.status === 'rejected').length;
142
+ successes += ok;
143
+ conflicts += fail;
144
+ assert.equal(ok, 1, `Round ${round}: exactly 1 writer should succeed, got ${ok}`);
145
+
146
+ if ((round + 1) % 25 === 0) console.log(` round ${round + 1}/${rounds}...`);
147
+ }
148
+
149
+ console.log(` ✓ [OCC] ${rounds} rounds: ${successes} wins, ${conflicts} conflicts`);
150
+ const final = (await store.get('/race/target')) as any;
151
+ assert.equal(final.$rev, rounds + 1);
152
+ });
153
+
154
+ it('interleaved read-modify-write with retry', async () => {
155
+ await store.set(createNode('/race/counter', 'counter', { count: 0 }));
156
+
157
+ const workers = 10;
158
+ const incrementsPerWorker = 30;
159
+
160
+ async function worker(_id: number) {
161
+ let retries = 0;
162
+ for (let i = 0; i < incrementsPerWorker; i++) {
163
+ let done = false;
164
+ while (!done) {
165
+ const node = (await store.get('/race/counter'))!;
166
+ try {
167
+ await store.set({ ...node, count: (node as any).count + 1 } as NodeData);
168
+ done = true;
169
+ } catch {
170
+ retries++;
171
+ }
172
+ }
173
+ }
174
+ return retries;
175
+ }
176
+
177
+ console.log(` ${workers} workers x ${incrementsPerWorker} increments...`);
178
+ const results = await Promise.all(Array.from({ length: workers }, (_, i) => worker(i)));
179
+ const totalRetries = results.reduce((a, b) => a + b, 0);
180
+
181
+ const final = (await store.get('/race/counter')) as any;
182
+ console.log(` ✓ [retry] final count=${final.count}, retries=${totalRetries}`);
183
+ assert.equal(final.count, workers * incrementsPerWorker);
184
+ });
185
+ });
186
+
187
+ // ── 3. Subscription Flooding ──
188
+
189
+ describe('Stress: subscriptions', () => {
190
+ let store: ReactiveTree;
191
+
192
+ beforeEach(() => {
193
+ clearRegistry();
194
+ ({ store } = fullPipeline());
195
+ });
196
+
197
+ it('500 rapid writes — all events delivered in order', async () => {
198
+ const events: NodeEvent[] = [];
199
+ store.subscribe('/flood', (e) => events.push(e), { children: true });
200
+
201
+ await timeBatch('sub flood', 500, (i) =>
202
+ store.set(createNode(`/flood/n${i}`, 'item', { seq: i })),
203
+ 100);
204
+
205
+ assert.equal(events.length, 500);
206
+ for (let i = 0; i < 500; i++) {
207
+ assert.equal((events[i] as { path: string }).path, `/flood/n${i}`);
208
+ }
209
+ });
210
+
211
+ it('multiple subscribers — all receive all events', async () => {
212
+ const N = 200;
213
+ const subs = 10;
214
+ const buckets: NodeEvent[][] = [];
215
+
216
+ for (let s = 0; s < subs; s++) {
217
+ const events: NodeEvent[] = [];
218
+ buckets.push(events);
219
+ store.subscribe('/multi', (e) => events.push(e), { children: true });
220
+ }
221
+ console.log(` ${subs} subscribers, ${N} writes...`);
222
+
223
+ for (let i = 0; i < N; i++)
224
+ await store.set(createNode(`/multi/n${i}`, 'item'));
225
+
226
+ for (let s = 0; s < subs; s++) {
227
+ assert.equal(buckets[s].length, N, `Subscriber ${s} missed events`);
228
+ }
229
+ console.log(` ✓ all ${subs} subscribers got all ${N} events`);
230
+ });
231
+
232
+ it('nested path subscriptions — parent catches child events', async () => {
233
+ const rootEvents: NodeEvent[] = [];
234
+ const childEvents: NodeEvent[] = [];
235
+
236
+ store.subscribe('/', (e) => rootEvents.push(e), { children: true });
237
+ store.subscribe('/deep/path', (e) => childEvents.push(e), { children: true });
238
+
239
+ await store.set(createNode('/deep/path/to/node', 'item'));
240
+ await store.set(createNode('/other/place', 'item'));
241
+
242
+ assert.equal(rootEvents.length, 2, 'Root should catch all');
243
+ assert.equal(childEvents.length, 1, 'Child sub should only catch nested');
244
+ assert.equal((childEvents[0] as { path: string }).path, '/deep/path/to/node');
245
+ console.log(' ✓ nested subscriptions route correctly');
246
+ });
247
+
248
+ it('subscribe + unsubscribe — no leaks', async () => {
249
+ const events: NodeEvent[] = [];
250
+ const unsub = store.subscribe('/leak', (e) => events.push(e), { children: true });
251
+
252
+ await store.set(createNode('/leak/before', 'item'));
253
+ assert.equal(events.length, 1);
254
+
255
+ unsub();
256
+ await store.set(createNode('/leak/after', 'item'));
257
+ assert.equal(events.length, 1, 'Should not receive events after unsub');
258
+ console.log(' ✓ no events after unsubscribe');
259
+ });
260
+ });
261
+
262
+ // ── 4. WatchManager Fan-out ──
263
+
264
+ describe('Stress: watch fan-out', () => {
265
+ let store: ReactiveTree;
266
+ let watcher: WatchManager;
267
+
268
+ beforeEach(() => {
269
+ clearRegistry();
270
+ ({ store, watcher } = fullPipeline());
271
+ });
272
+
273
+ it('100 users watching same path — all notified', async () => {
274
+ const received = new Map<string, NodeEvent[]>();
275
+
276
+ for (let u = 0; u < 100; u++) {
277
+ const uid = `user-${u}`;
278
+ const events: NodeEvent[] = [];
279
+ received.set(uid, events);
280
+ watcher.connect(uid, uid, (e) => events.push(e));
281
+ watcher.watch(uid, ['/shared/doc']);
282
+ }
283
+ console.log(' 100 users connected, writing...');
284
+
285
+ await store.set(createNode('/shared/doc', 'doc', { text: 'hello' }));
286
+
287
+ let ok = 0;
288
+ for (const [, events] of received) {
289
+ assert.equal(events.length, 1);
290
+ ok++;
291
+ }
292
+ console.log(` ✓ all ${ok} users received event`);
293
+ });
294
+
295
+ it('watchChildren — 50 new nodes auto-notified', async () => {
296
+ const events: NodeEvent[] = [];
297
+ watcher.connect('watcher', 'watcher', (e) => events.push(e));
298
+ watcher.watch('watcher', ['/items'], { children: true });
299
+
300
+ for (let i = 0; i < 50; i++)
301
+ await store.set(createNode(`/items/item-${i}`, 'item'));
302
+
303
+ assert.equal(events.length, 50);
304
+ console.log(' ✓ 50/50 child events received');
305
+ });
306
+
307
+ it('autoWatch — subsequent updates delivered via exact watch', async () => {
308
+ const events: NodeEvent[] = [];
309
+ watcher.connect('auto', 'auto', (e) => events.push(e));
310
+ watcher.watch('auto', ['/auto'], { children: true, autoWatch: true });
311
+
312
+ await store.set(createNode('/auto/target', 'item', { v: 1 }));
313
+ assert.equal(events.length, 1);
314
+
315
+ const node = (await store.get('/auto/target'))!;
316
+ await store.set({ ...node, v: 2 } as NodeData);
317
+ assert.equal(events.length, 2);
318
+ console.log(' ✓ autoWatch promoted prefix → exact watch');
319
+ });
320
+
321
+ it('disconnected user stops receiving events', async () => {
322
+ const events: NodeEvent[] = [];
323
+ watcher.connect('ephemeral', 'ephemeral', (e) => events.push(e));
324
+ watcher.watch('ephemeral', ['/bye/node']);
325
+
326
+ await store.set(createNode('/bye/node', 'item'));
327
+ assert.equal(events.length, 1);
328
+
329
+ watcher.disconnect('ephemeral');
330
+ await store.set(createNode('/bye/node', 'item', { v: 2 }));
331
+ assert.equal(events.length, 1, 'Disconnected user should not receive events');
332
+ console.log(' ✓ disconnect stops delivery');
333
+ });
334
+ });
335
+
336
+ // ── 5. Query Mount + CDC Matrix ──
337
+
338
+ describe('Stress: query mounts + CDC', () => {
339
+ let bootstrap: Tree;
340
+ let store: ReactiveTree;
341
+ let watcher: WatchManager;
342
+
343
+ beforeEach(() => {
344
+ clearRegistry();
345
+ register('t.mount.query', 'mount', (config: any, parentStore: Tree) => {
346
+ const query = config['query'] as unknown as { source: string; match: Record<string, unknown> };
347
+ return createQueryTree({ source: query.source, match: query.match }, parentStore);
348
+ });
349
+ ({ bootstrap, store, watcher } = fullPipeline());
350
+ });
351
+
352
+ it('query mount filters correctly under load', async () => {
353
+ await bootstrap.set(
354
+ createNode('/views/active', 'folder', {}, {
355
+ mount: { $type: 't.mount.query' },
356
+ query: { $type: 'query', source: '/entities/tasks', match: { status: 'active' } },
357
+ }),
358
+ );
359
+
360
+ console.log(' creating 200 tasks (half active)...');
361
+ for (let i = 0; i < 200; i++) {
362
+ await store.set(
363
+ createNode(`/entities/tasks/t${i}`, 'task', {
364
+ status: i % 2 === 0 ? 'active' : 'done',
365
+ title: `Task ${i}`,
366
+ }),
367
+ );
368
+ }
369
+
370
+ const result = await store.getChildren('/views/active');
371
+ assert.equal(result.items.length, 100);
372
+
373
+ for (const item of result.items) {
374
+ assert.equal((item as any).status, 'active');
375
+ }
376
+ console.log(` ✓ query mount returned ${result.items.length}/100 active tasks`);
377
+ });
378
+
379
+ it('CDC: node entering/leaving virtual parent', async () => {
380
+ await bootstrap.set(
381
+ createNode('/views/urgent', 'folder', {}, {
382
+ mount: { $type: 't.mount.query' },
383
+ query: { $type: 'query', source: '/entities/tickets', match: { priority: 'high' } },
384
+ }),
385
+ );
386
+
387
+ watchQuery('/views/urgent', '/entities/tickets', { priority: 'high' }, 'user1');
388
+ const events: NodeEvent[] = [];
389
+ watcher.connect('user1', 'user1', (e) => events.push(e));
390
+ watcher.watch('user1', ['/views/urgent'], { children: true });
391
+
392
+ // Low priority — no CDC
393
+ await store.set(createNode('/entities/tickets/t1', 'ticket', { priority: 'low' }));
394
+ assert.equal(events.length, 0, 'Low priority should not trigger CDC');
395
+ console.log(' low-priority → no event ✓');
396
+
397
+ // High priority — enters VP
398
+ await store.set(createNode('/entities/tickets/t2', 'ticket', { priority: 'high' }));
399
+ assert.equal(events.length, 1);
400
+ assert.deepEqual((events[0] as any).addVps, ['/views/urgent']);
401
+ console.log(' high-priority → addVps ✓');
402
+
403
+ // Downgrade — leaves VP
404
+ const t2 = (await store.get('/entities/tickets/t2'))!;
405
+ await store.set({ ...t2, priority: 'low' } as NodeData);
406
+ assert.equal(events.length, 2);
407
+ assert.deepEqual((events[1] as any).rmVps, ['/views/urgent']);
408
+ console.log(' downgrade → rmVps ✓');
409
+
410
+ unwatchAllQueries('user1');
411
+ });
412
+
413
+ it('CDC under load — 100 create + 50 transition', async () => {
414
+ await bootstrap.set(
415
+ createNode('/views/new', 'folder', {}, {
416
+ mount: { $type: 't.mount.query' },
417
+ query: { $type: 'query', source: '/entities/orders', match: { status: 'new' } },
418
+ }),
419
+ );
420
+
421
+ watchQuery('/views/new', '/entities/orders', { status: 'new' }, 'watcher');
422
+
423
+ const adds: string[] = [];
424
+ const removes: string[] = [];
425
+ watcher.connect('watcher', 'watcher', (e) => {
426
+ if ('addVps' in e && (e as any).addVps?.length) adds.push((e as any).path);
427
+ if ((e as any).rmVps?.length) removes.push((e as any).path);
428
+ });
429
+ watcher.watch('watcher', ['/views/new'], { children: true });
430
+
431
+ console.log(' creating 100 "new" orders...');
432
+ for (let i = 0; i < 100; i++)
433
+ await store.set(createNode(`/entities/orders/o${i}`, 'order', { status: 'new' }));
434
+
435
+ assert.equal(adds.length, 100);
436
+ console.log(` ${adds.length} addVps events ✓`);
437
+
438
+ console.log(' transitioning 50 to "done"...');
439
+ for (let i = 0; i < 50; i++) {
440
+ const order = (await store.get(`/entities/orders/o${i}`))!;
441
+ await store.set({ ...order, status: 'done' } as NodeData);
442
+ }
443
+
444
+ assert.equal(removes.length, 50);
445
+ console.log(` ${removes.length} rmVps events ✓`);
446
+
447
+ const result = await store.getChildren('/views/new');
448
+ assert.equal(result.items.length, 50);
449
+ console.log(` ✓ query mount shows ${result.items.length} remaining`);
450
+
451
+ unwatchAllQueries('watcher');
452
+ });
453
+
454
+ it('multiple query mounts on same source — CDC dispatches to both', async () => {
455
+ await bootstrap.set(
456
+ createNode('/views/new', 'folder', {}, {
457
+ mount: { $type: 't.mount.query' },
458
+ query: { $type: 'query', source: '/entities/items', match: { status: 'new' } },
459
+ }),
460
+ );
461
+ await bootstrap.set(
462
+ createNode('/views/flagged', 'folder', {}, {
463
+ mount: { $type: 't.mount.query' },
464
+ query: { $type: 'query', source: '/entities/items', match: { flagged: true } },
465
+ }),
466
+ );
467
+
468
+ watchQuery('/views/new', '/entities/items', { status: 'new' }, 'u1');
469
+ watchQuery('/views/flagged', '/entities/items', { flagged: true }, 'u1');
470
+
471
+ const events: NodeEvent[] = [];
472
+ watcher.connect('u1', 'u1', (e) => events.push(e));
473
+ watcher.watch('u1', ['/views/new', '/views/flagged'], { children: true });
474
+
475
+ await store.set(createNode('/entities/items/x', 'item', { status: 'new', flagged: true }));
476
+ assert.equal(events.length, 1, 'Single event despite matching two queries');
477
+ assert.deepEqual((events[0] as any).addVps?.sort(), ['/views/flagged', '/views/new']);
478
+ console.log(' ✓ single event with both VPs');
479
+
480
+ unwatchAllQueries('u1');
481
+ });
482
+ });
483
+
484
+ // ── 6. Action Execute + Patch Pipeline ──
485
+
486
+ describe('Stress: actions + patches', () => {
487
+ let store: ReactiveTree;
488
+
489
+ beforeEach(() => {
490
+ clearRegistry();
491
+
492
+ register('counter', 'action:increment', (ctx: any) => {
493
+ ctx.node.count = (ctx.node.count ?? 0) + 1;
494
+ return ctx.node.count;
495
+ });
496
+
497
+ register('counter', 'action:add', (ctx: any, data: any) => {
498
+ ctx.node.count = (ctx.node.count ?? 0) + (data?.amount ?? 1);
499
+ return ctx.node.count;
500
+ });
501
+
502
+ ({ store } = fullPipeline());
503
+ });
504
+
505
+ it('execute generates patches — 50 increments', async () => {
506
+ await store.set(createNode('/counters/c1', 'counter', { count: 0 }));
507
+
508
+ const patchEvents: NodeEvent[] = [];
509
+ store.subscribe('/counters', (e) => {
510
+ if (e.type === 'patch') patchEvents.push(e);
511
+ }, { children: true });
512
+
513
+ await timeBatch('execute', 50, () =>
514
+ executeAction(store, '/counters/c1', undefined, undefined, 'increment') as Promise<any>,
515
+ 10);
516
+
517
+ const final = (await store.get('/counters/c1')) as any;
518
+ assert.equal(final.count, 50);
519
+ assert.equal(patchEvents.length, 50);
520
+
521
+ for (const evt of patchEvents) {
522
+ if (evt.type === 'patch') {
523
+ assert.ok(evt.patches.length > 0);
524
+ }
525
+ }
526
+ console.log(` ✓ ${patchEvents.length} patch events, final count=${final.count}`);
527
+ });
528
+
529
+ it('concurrent execute — OCC serializes correctly', async () => {
530
+ await store.set(createNode('/counters/race', 'counter', { count: 0 }));
531
+
532
+ const N = 30;
533
+ let conflicts = 0;
534
+
535
+ for (let i = 0; i < N; i++) {
536
+ const results = await Promise.allSettled([
537
+ executeAction(store, '/counters/race', undefined, undefined, 'increment'),
538
+ executeAction(store, '/counters/race', undefined, undefined, 'increment'),
539
+ executeAction(store, '/counters/race', undefined, undefined, 'increment'),
540
+ ]);
541
+ conflicts += results.filter((r) => r.status === 'rejected').length;
542
+ if ((i + 1) % 10 === 0) console.log(` batch ${i + 1}/${N}...`);
543
+ }
544
+
545
+ const final = (await store.get('/counters/race')) as any;
546
+ console.log(` ✓ [execute race] final count=${final.count}, conflicts=${conflicts}`);
547
+ assert.ok(final.count >= N);
548
+ assert.ok(final.count <= 3 * N);
549
+ });
550
+ });
551
+
552
+ // ── 7. Deep Tree ──
553
+
554
+ describe('Stress: deep trees', () => {
555
+ let store: ReactiveTree;
556
+
557
+ beforeEach(() => {
558
+ clearRegistry();
559
+ ({ store } = fullPipeline());
560
+ });
561
+
562
+ it('deeply nested path — 50 levels deep', async () => {
563
+ let path = '';
564
+ for (let i = 0; i < 50; i++) {
565
+ path += `/d${i}`;
566
+ await store.set(createNode(path, 'dir'));
567
+ }
568
+
569
+ const deep = await store.get(path);
570
+ assert.ok(deep);
571
+ assert.equal(deep!.$type, 't.dir');
572
+ console.log(` ✓ read node at depth 50: ${path.slice(0, 40)}...`);
573
+
574
+ let current = '';
575
+ for (let i = 0; i < 49; i++) {
576
+ current += `/d${i}`;
577
+ const children = await store.getChildren(current, { limit: 10 });
578
+ assert.equal(children.items.length, 1);
579
+ }
580
+ console.log(' ✓ getChildren works at every level');
581
+ });
582
+
583
+ it('wide tree — 1000 children + pagination', async () => {
584
+ console.log(' creating 1000 children...');
585
+ for (let i = 0; i < 1000; i++)
586
+ await store.set(createNode(`/wide/c${i}`, 'item', { idx: i }));
587
+
588
+ const all = await store.getChildren('/wide');
589
+ assert.equal(all.total, 1000);
590
+ console.log(` total=${all.total} ✓`);
591
+
592
+ const page1 = await store.getChildren('/wide', { limit: 100, offset: 0 });
593
+ assert.equal(page1.items.length, 100);
594
+
595
+ const page10 = await store.getChildren('/wide', { limit: 100, offset: 900 });
596
+ assert.equal(page10.items.length, 100);
597
+ console.log(' ✓ pagination correct');
598
+ });
599
+ });
600
+
601
+ // ── 8. Remove + Subscription Correctness ──
602
+
603
+ describe('Stress: remove operations', () => {
604
+ let store: ReactiveTree;
605
+
606
+ beforeEach(() => {
607
+ clearRegistry();
608
+ ({ store } = fullPipeline());
609
+ });
610
+
611
+ it('bulk create then remove — subscriptions fire for both', async () => {
612
+ const sets: string[] = [];
613
+ const removes: string[] = [];
614
+
615
+ store.subscribe('/tmp', (e) => {
616
+ if (e.type === 'set') sets.push(e.path);
617
+ if (e.type === 'remove') removes.push(e.path);
618
+ }, { children: true });
619
+
620
+ const N = 200;
621
+ console.log(` creating ${N} nodes...`);
622
+ for (let i = 0; i < N; i++)
623
+ await store.set(createNode(`/tmp/n${i}`, 'item'));
624
+ assert.equal(sets.length, N);
625
+
626
+ console.log(` removing ${N} nodes...`);
627
+ for (let i = 0; i < N; i++)
628
+ await store.remove(`/tmp/n${i}`);
629
+ assert.equal(removes.length, N);
630
+
631
+ const children = await store.getChildren('/tmp');
632
+ assert.equal(children.items.length, 0);
633
+ console.log(` ✓ ${N} set + ${N} remove events, 0 remaining`);
634
+ });
635
+
636
+ it('remove non-existent node — no event', async () => {
637
+ const events: NodeEvent[] = [];
638
+ store.subscribe('/phantom', (e) => events.push(e));
639
+
640
+ const result = await store.remove('/phantom/ghost');
641
+ assert.equal(result, false);
642
+ assert.equal(events.length, 0);
643
+ console.log(' ✓ no event for phantom remove');
644
+ });
645
+ });
646
+
647
+ // ── 9. Volatile + Validation Pipeline ──
648
+
649
+ describe('Stress: volatile + validation', () => {
650
+ let store: ReactiveTree;
651
+
652
+ beforeEach(() => {
653
+ clearRegistry();
654
+ register('ephemeral', 'volatile', () => true);
655
+ register('validated', 'schema', () => ({
656
+ properties: {
657
+ name: { type: 'string' },
658
+ count: { type: 'number' },
659
+ },
660
+ }));
661
+ ({ store } = fullPipeline());
662
+ });
663
+
664
+ it('volatile nodes stored in memory layer', async () => {
665
+ for (let i = 0; i < 50; i++)
666
+ await store.set(createNode(`/live/s${i}`, 'ephemeral', { value: i }));
667
+
668
+ for (let i = 0; i < 50; i++) {
669
+ const node = await store.get(`/live/s${i}`);
670
+ assert.ok(node);
671
+ assert.equal((node as any).value, i);
672
+ }
673
+ console.log(' ✓ 50 volatile nodes readable');
674
+ });
675
+
676
+ it('validation rejects bad data — all errors propagate', async () => {
677
+ let rejected = 0;
678
+
679
+ for (let i = 0; i < 50; i++) {
680
+ const bad = i % 2 !== 0;
681
+ try {
682
+ await store.set(
683
+ createNode(`/valid/n${i}`, 'item', {}, {
684
+ data: {
685
+ $type: 'validated',
686
+ name: bad ? 42 as any : 'ok',
687
+ count: i,
688
+ },
689
+ }),
690
+ );
691
+ assert.ok(!bad, `expected rejection for i=${i}`);
692
+ } catch (e: any) {
693
+ assert.ok(bad, `unexpected throw for i=${i}: ${e.message}`);
694
+ assert.ok(e.message, 'validation error should have a message');
695
+ rejected++;
696
+ }
697
+ }
698
+
699
+ assert.equal(rejected, 25);
700
+ });
701
+ });
702
+
703
+ // ── 10. Random Access Pattern ──
704
+
705
+ describe('Stress: random access', () => {
706
+ let store: ReactiveTree;
707
+
708
+ beforeEach(() => {
709
+ clearRegistry();
710
+ ({ store } = fullPipeline());
711
+ });
712
+
713
+ it('random CRUD — 1000 ops, no crashes', async () => {
714
+ const paths = new Set<string>();
715
+ let creates = 0, reads = 0, updates = 0, deletes = 0;
716
+
717
+ for (let i = 0; i < 1000; i++) {
718
+ const op = Math.random();
719
+ const id = Math.floor(Math.random() * 100);
720
+ const path = `/random/n${id}`;
721
+
722
+ if (op < 0.3) {
723
+ await store.set(createNode(path, 'item', { i, rnd: Math.random() }));
724
+ paths.add(path);
725
+ creates++;
726
+ } else if (op < 0.6) {
727
+ await store.get(path);
728
+ reads++;
729
+ } else if (op < 0.8) {
730
+ await store.set(createNode(path, 'item', { i, updated: true }));
731
+ paths.add(path);
732
+ updates++;
733
+ } else {
734
+ await store.remove(path);
735
+ paths.delete(path);
736
+ deletes++;
737
+ }
738
+ }
739
+
740
+ assert.ok(creates > 0, 'should have creates');
741
+ assert.ok(reads > 0, 'should have reads');
742
+
743
+ for (const path of paths) {
744
+ const node = await store.get(path);
745
+ if (node) {
746
+ assert.equal(node.$path, path);
747
+ assert.equal(node.$type, 't.item');
748
+ }
749
+ }
750
+ });
751
+ });
752
+
753
+ // ── 11. Full Watch Pipeline Integration ──
754
+
755
+ describe('Stress: full watch pipeline', () => {
756
+ beforeEach(() => {
757
+ clearRegistry();
758
+ });
759
+
760
+ it('watch + watchChildren + CDC — mixed scenario', async () => {
761
+ register('t.mount.query', 'mount', (config: any, parentStore: Tree) => {
762
+ const query = config['query'] as unknown as { source: string; match: Record<string, unknown> };
763
+ return createQueryTree({ source: query.source, match: query.match }, parentStore);
764
+ });
765
+
766
+ const { bootstrap: bs2, store: store2, watcher: w2 } = fullPipeline();
767
+
768
+ await bs2.set(
769
+ createNode('/views/hot', 'folder', {}, {
770
+ mount: { $type: 't.mount.query' },
771
+ query: { $type: 'query', source: '/data', match: { hot: true } },
772
+ }),
773
+ );
774
+
775
+ watchQuery('/views/hot', '/data', { hot: true }, 'observer');
776
+
777
+ const exactEvents: NodeEvent[] = [];
778
+ const childEvents: NodeEvent[] = [];
779
+ const cdcEvents: NodeEvent[] = [];
780
+
781
+ w2.connect('observer', 'observer', (e) => {
782
+ const path = 'path' in e ? e.path : '';
783
+ if (path === '/data/tracked') exactEvents.push(e);
784
+ if ('addVps' in e && (e as any).addVps?.includes('/views/hot')) cdcEvents.push(e);
785
+ if (path.startsWith('/data/') && path !== '/data/tracked') childEvents.push(e);
786
+ });
787
+
788
+ w2.watch('observer', ['/data/tracked']);
789
+ w2.watch('observer', ['/data'], { children: true });
790
+
791
+ await store2.set(createNode('/data/tracked', 'item', { v: 1 }));
792
+ assert.equal(exactEvents.length, 1);
793
+ console.log(' exact watch ✓');
794
+
795
+ await store2.set(createNode('/data/child1', 'item', { hot: false }));
796
+ assert.equal(childEvents.length, 1);
797
+ console.log(' children watch ✓');
798
+
799
+ await store2.set(createNode('/data/hotitem', 'item', { hot: true }));
800
+ assert.ok(cdcEvents.length >= 1);
801
+ console.log(' CDC watch ✓');
802
+
803
+ unwatchAllQueries('observer');
804
+ console.log(' ✓ all 3 watch modes work together');
805
+ });
806
+ });
807
+
808
+ // ── 12. Memory Pressure (reduced) ──
809
+
810
+ describe('Stress: memory', () => {
811
+ let store: ReactiveTree;
812
+
813
+ beforeEach(() => {
814
+ clearRegistry();
815
+ ({ store } = fullPipeline());
816
+ });
817
+
818
+ it('5k nodes — memory stays bounded', async () => {
819
+ const before = process.memoryUsage().heapUsed;
820
+ const N = 5_000;
821
+
822
+ await timeBatch('mem fill', N, (i) =>
823
+ store.set(createNode(`/mem/n${i}`, 'item', { data: `payload-${i}`, idx: i })),
824
+ 1000);
825
+
826
+ const after = process.memoryUsage().heapUsed;
827
+ const deltaBytes = after - before;
828
+ const perNodeBytes = deltaBytes / N;
829
+
830
+ console.log(` [memory] ${N} nodes: ${(deltaBytes / 1024 / 1024).toFixed(1)}MB total, ${perNodeBytes.toFixed(0)} bytes/node`);
831
+
832
+ // No hard assert — V8 profiler inflates heap significantly
833
+ if (perNodeBytes >= 4096) console.log(` ⚠ ${perNodeBytes.toFixed(0)} bytes/node exceeds 4KB (profiler overhead?)`);
834
+
835
+ // Spot-check random reads
836
+ for (let i = 0; i < 50; i++) {
837
+ const idx = Math.floor(Math.random() * N);
838
+ const node = await store.get(`/mem/n${idx}`);
839
+ assert.ok(node);
840
+ assert.equal((node as any).idx, idx);
841
+ }
842
+ console.log(' ✓ spot-check reads OK');
843
+ });
844
+ });