arethesis 0.1.5 → 0.2.1

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 (383) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/README.md +5 -4
  3. package/dist/arethesis.js +2 -147
  4. package/dist/binding/data-binder.d.ts +8 -0
  5. package/dist/binding/data-binder.d.ts.map +1 -1
  6. package/dist/binding/data-binder.js +605 -0
  7. package/dist/binding/data-binder.js.map +1 -0
  8. package/dist/binding/types.d.ts +20 -0
  9. package/dist/binding/types.d.ts.map +1 -1
  10. package/dist/binding/validation-engine.js +160 -0
  11. package/dist/binding/validation-engine.js.map +1 -0
  12. package/dist/cdn/arethesis.min.js +2 -0
  13. package/dist/cdn/arethesis.min.js.map +1 -0
  14. package/dist/cdn/chunks/CdTL-MEv.min.js +3 -0
  15. package/dist/cdn/chunks/CdTL-MEv.min.js.map +1 -0
  16. package/dist/cdn/components.min.js +81 -0
  17. package/dist/cdn/components.min.js.map +1 -0
  18. package/dist/collab/index.d.ts +22 -0
  19. package/dist/collab/index.d.ts.map +1 -0
  20. package/dist/collab/index.js +23 -0
  21. package/dist/collab/index.js.map +1 -0
  22. package/dist/components/component.d.ts +17 -0
  23. package/dist/components/component.d.ts.map +1 -1
  24. package/dist/components/component.js +765 -0
  25. package/dist/components/component.js.map +1 -0
  26. package/dist/components/decorators.js +27 -0
  27. package/dist/components/decorators.js.map +1 -0
  28. package/dist/components/form-associated.d.ts +55 -0
  29. package/dist/components/form-associated.d.ts.map +1 -0
  30. package/dist/components/form-associated.js +180 -0
  31. package/dist/components/form-associated.js.map +1 -0
  32. package/dist/components/runtime.d.ts +2 -0
  33. package/dist/components/runtime.d.ts.map +1 -1
  34. package/dist/components/runtime.js +18 -0
  35. package/dist/components/runtime.js.map +1 -0
  36. package/dist/components/template-loader.js +90 -0
  37. package/dist/components/template-loader.js.map +1 -0
  38. package/dist/components.js +2 -606
  39. package/dist/core/arethesis.d.ts +13 -9
  40. package/dist/core/arethesis.d.ts.map +1 -1
  41. package/dist/core/arethesis.js +249 -0
  42. package/dist/core/arethesis.js.map +1 -0
  43. package/dist/core/hooks.d.ts +19 -0
  44. package/dist/core/hooks.d.ts.map +1 -0
  45. package/dist/core/hooks.js +23 -0
  46. package/dist/core/hooks.js.map +1 -0
  47. package/dist/core/index.d.ts +57 -0
  48. package/dist/core/index.d.ts.map +1 -0
  49. package/dist/core/index.js +25 -0
  50. package/dist/data/list-view-registry.js +300 -0
  51. package/dist/data/list-view-registry.js.map +1 -0
  52. package/dist/data/object-store.js +280 -0
  53. package/dist/data/object-store.js.map +1 -0
  54. package/dist/data/optimistic-updates.js +168 -0
  55. package/dist/data/optimistic-updates.js.map +1 -0
  56. package/dist/data/persistence-manager.js +233 -0
  57. package/dist/data/persistence-manager.js.map +1 -0
  58. package/dist/defaults.d.ts +1 -0
  59. package/dist/defaults.d.ts.map +1 -0
  60. package/dist/defaults.js +17 -0
  61. package/dist/defaults.js.map +1 -0
  62. package/dist/http/auth-manager.js +260 -0
  63. package/dist/http/auth-manager.js.map +1 -0
  64. package/dist/http/http-client.d.ts +7 -0
  65. package/dist/http/http-client.d.ts.map +1 -1
  66. package/dist/http/http-client.js +501 -0
  67. package/dist/http/http-client.js.map +1 -0
  68. package/dist/http/http-error.js +53 -0
  69. package/dist/http/http-error.js.map +1 -0
  70. package/dist/http/mapping.js +64 -0
  71. package/dist/http/mapping.js.map +1 -0
  72. package/dist/index.d.ts +3 -52
  73. package/dist/index.d.ts.map +1 -1
  74. package/dist/index.js +55 -0
  75. package/dist/kit/calendar.d.ts +43 -0
  76. package/dist/kit/calendar.d.ts.map +1 -0
  77. package/dist/kit/calendar.js +423 -0
  78. package/dist/kit/calendar.js.map +1 -0
  79. package/dist/kit/cell-editor.d.ts +47 -0
  80. package/dist/kit/cell-editor.d.ts.map +1 -0
  81. package/dist/kit/cell-editor.js +191 -0
  82. package/dist/kit/cell-editor.js.map +1 -0
  83. package/dist/kit/chart.d.ts +57 -0
  84. package/dist/kit/chart.d.ts.map +1 -0
  85. package/dist/kit/chart.js +541 -0
  86. package/dist/kit/chart.js.map +1 -0
  87. package/dist/kit/combobox.d.ts +57 -0
  88. package/dist/kit/combobox.d.ts.map +1 -0
  89. package/dist/kit/combobox.js +379 -0
  90. package/dist/kit/combobox.js.map +1 -0
  91. package/dist/kit/command-palette.d.ts +54 -0
  92. package/dist/kit/command-palette.d.ts.map +1 -0
  93. package/dist/kit/command-palette.js +315 -0
  94. package/dist/kit/command-palette.js.map +1 -0
  95. package/dist/kit/data-table.d.ts +17 -1
  96. package/dist/kit/data-table.d.ts.map +1 -1
  97. package/dist/kit/data-table.js +373 -0
  98. package/dist/kit/data-table.js.map +1 -0
  99. package/dist/kit/dialog.d.ts +31 -0
  100. package/dist/kit/dialog.d.ts.map +1 -0
  101. package/dist/kit/dialog.js +157 -0
  102. package/dist/kit/dialog.js.map +1 -0
  103. package/dist/kit/elements/calendar.d.ts +3 -0
  104. package/dist/kit/elements/calendar.d.ts.map +1 -0
  105. package/dist/kit/elements/calendar.js +11 -0
  106. package/dist/kit/elements/calendar.js.map +1 -0
  107. package/dist/kit/elements/chart.d.ts +3 -0
  108. package/dist/kit/elements/chart.d.ts.map +1 -0
  109. package/dist/kit/elements/chart.js +11 -0
  110. package/dist/kit/elements/chart.js.map +1 -0
  111. package/dist/kit/elements/combobox.d.ts +3 -0
  112. package/dist/kit/elements/combobox.d.ts.map +1 -0
  113. package/dist/kit/elements/combobox.js +11 -0
  114. package/dist/kit/elements/combobox.js.map +1 -0
  115. package/dist/kit/elements/command-palette.d.ts +3 -0
  116. package/dist/kit/elements/command-palette.d.ts.map +1 -0
  117. package/dist/kit/elements/command-palette.js +11 -0
  118. package/dist/kit/elements/command-palette.js.map +1 -0
  119. package/dist/kit/elements/data-table.d.ts +3 -0
  120. package/dist/kit/elements/data-table.d.ts.map +1 -0
  121. package/dist/kit/elements/data-table.js +11 -0
  122. package/dist/kit/elements/data-table.js.map +1 -0
  123. package/dist/kit/elements/dialog.d.ts +4 -0
  124. package/dist/kit/elements/dialog.d.ts.map +1 -0
  125. package/dist/kit/elements/dialog.js +11 -0
  126. package/dist/kit/elements/dialog.js.map +1 -0
  127. package/dist/kit/elements/flex-view.d.ts +3 -0
  128. package/dist/kit/elements/flex-view.d.ts.map +1 -0
  129. package/dist/kit/elements/flex-view.js +11 -0
  130. package/dist/kit/elements/flex-view.js.map +1 -0
  131. package/dist/kit/elements/form.d.ts +3 -0
  132. package/dist/kit/elements/form.d.ts.map +1 -0
  133. package/dist/kit/elements/form.js +11 -0
  134. package/dist/kit/elements/form.js.map +1 -0
  135. package/dist/kit/elements/kanban.d.ts +3 -0
  136. package/dist/kit/elements/kanban.d.ts.map +1 -0
  137. package/dist/kit/elements/kanban.js +11 -0
  138. package/dist/kit/elements/kanban.js.map +1 -0
  139. package/dist/kit/elements/list.d.ts +3 -0
  140. package/dist/kit/elements/list.d.ts.map +1 -0
  141. package/dist/kit/elements/list.js +11 -0
  142. package/dist/kit/elements/list.js.map +1 -0
  143. package/dist/kit/elements/markdown-editor.d.ts +3 -0
  144. package/dist/kit/elements/markdown-editor.d.ts.map +1 -0
  145. package/dist/kit/elements/markdown-editor.js +11 -0
  146. package/dist/kit/elements/markdown-editor.js.map +1 -0
  147. package/dist/kit/elements/presence.d.ts +3 -0
  148. package/dist/kit/elements/presence.d.ts.map +1 -0
  149. package/dist/kit/elements/presence.js +11 -0
  150. package/dist/kit/elements/presence.js.map +1 -0
  151. package/dist/kit/elements/sheet.d.ts +3 -0
  152. package/dist/kit/elements/sheet.d.ts.map +1 -0
  153. package/dist/kit/elements/sheet.js +11 -0
  154. package/dist/kit/elements/sheet.js.map +1 -0
  155. package/dist/kit/elements/tabs.d.ts +3 -0
  156. package/dist/kit/elements/tabs.d.ts.map +1 -0
  157. package/dist/kit/elements/tabs.js +11 -0
  158. package/dist/kit/elements/tabs.js.map +1 -0
  159. package/dist/kit/elements/toast.d.ts +4 -0
  160. package/dist/kit/elements/toast.d.ts.map +1 -0
  161. package/dist/kit/elements/toast.js +11 -0
  162. package/dist/kit/elements/toast.js.map +1 -0
  163. package/dist/kit/elements/tree.d.ts +3 -0
  164. package/dist/kit/elements/tree.d.ts.map +1 -0
  165. package/dist/kit/elements/tree.js +11 -0
  166. package/dist/kit/elements/tree.js.map +1 -0
  167. package/dist/kit/flex-view.d.ts +2 -0
  168. package/dist/kit/flex-view.d.ts.map +1 -1
  169. package/dist/kit/flex-view.js +346 -0
  170. package/dist/kit/flex-view.js.map +1 -0
  171. package/dist/kit/form.d.ts +2 -0
  172. package/dist/kit/form.d.ts.map +1 -1
  173. package/dist/kit/form.js +211 -0
  174. package/dist/kit/form.js.map +1 -0
  175. package/dist/kit/index.d.ts +33 -16
  176. package/dist/kit/index.d.ts.map +1 -1
  177. package/dist/kit/index.js +40 -0
  178. package/dist/kit/internal/modal.d.ts +26 -0
  179. package/dist/kit/internal/modal.d.ts.map +1 -0
  180. package/dist/kit/internal/modal.js +59 -0
  181. package/dist/kit/internal/modal.js.map +1 -0
  182. package/dist/kit/kanban.d.ts +73 -0
  183. package/dist/kit/kanban.d.ts.map +1 -0
  184. package/dist/kit/kanban.js +404 -0
  185. package/dist/kit/kanban.js.map +1 -0
  186. package/dist/kit/list.d.ts +4 -0
  187. package/dist/kit/list.d.ts.map +1 -1
  188. package/dist/kit/list.js +106 -0
  189. package/dist/kit/list.js.map +1 -0
  190. package/dist/kit/markdown/highlight.d.ts +29 -0
  191. package/dist/kit/markdown/highlight.d.ts.map +1 -0
  192. package/dist/kit/markdown/highlight.js +106 -0
  193. package/dist/kit/markdown/highlight.js.map +1 -0
  194. package/dist/kit/markdown/render.d.ts +31 -0
  195. package/dist/kit/markdown/render.d.ts.map +1 -0
  196. package/dist/kit/markdown/render.js +260 -0
  197. package/dist/kit/markdown/render.js.map +1 -0
  198. package/dist/kit/markdown-editor.d.ts +54 -0
  199. package/dist/kit/markdown-editor.d.ts.map +1 -0
  200. package/dist/kit/markdown-editor.js +797 -0
  201. package/dist/kit/markdown-editor.js.map +1 -0
  202. package/dist/kit/presence.d.ts +36 -0
  203. package/dist/kit/presence.d.ts.map +1 -0
  204. package/dist/kit/presence.js +262 -0
  205. package/dist/kit/presence.js.map +1 -0
  206. package/dist/kit/sheet/formula.d.ts +106 -0
  207. package/dist/kit/sheet/formula.d.ts.map +1 -0
  208. package/dist/kit/sheet/formula.js +364 -0
  209. package/dist/kit/sheet/formula.js.map +1 -0
  210. package/dist/kit/sheet/model.d.ts +28 -0
  211. package/dist/kit/sheet/model.d.ts.map +1 -0
  212. package/dist/kit/sheet/model.js +136 -0
  213. package/dist/kit/sheet/model.js.map +1 -0
  214. package/dist/kit/sheet/sheet.d.ts +47 -0
  215. package/dist/kit/sheet/sheet.d.ts.map +1 -0
  216. package/dist/kit/sheet/sheet.js +676 -0
  217. package/dist/kit/sheet/sheet.js.map +1 -0
  218. package/dist/kit/tabs.d.ts +17 -0
  219. package/dist/kit/tabs.d.ts.map +1 -0
  220. package/dist/kit/tabs.js +192 -0
  221. package/dist/kit/tabs.js.map +1 -0
  222. package/dist/kit/theme-boot.generated.d.ts +2 -0
  223. package/dist/kit/theme-boot.generated.d.ts.map +1 -1
  224. package/dist/kit/theme-boot.generated.js +8 -0
  225. package/dist/kit/theme-boot.generated.js.map +1 -0
  226. package/dist/kit/theme.d.ts +5 -3
  227. package/dist/kit/theme.d.ts.map +1 -1
  228. package/dist/kit/theme.js +89 -0
  229. package/dist/kit/theme.js.map +1 -0
  230. package/dist/kit/toast.d.ts +46 -0
  231. package/dist/kit/toast.d.ts.map +1 -0
  232. package/dist/kit/toast.js +154 -0
  233. package/dist/kit/toast.js.map +1 -0
  234. package/dist/kit/tree.d.ts +41 -0
  235. package/dist/kit/tree.d.ts.map +1 -0
  236. package/dist/kit/tree.js +422 -0
  237. package/dist/kit/tree.js.map +1 -0
  238. package/dist/mixins/context-menu.d.ts.map +1 -1
  239. package/dist/mixins/context-menu.js +183 -0
  240. package/dist/mixins/context-menu.js.map +1 -0
  241. package/dist/mixins/draggable.d.ts.map +1 -1
  242. package/dist/mixins/draggable.js +140 -0
  243. package/dist/mixins/draggable.js.map +1 -0
  244. package/dist/mixins/dropdown.d.ts.map +1 -1
  245. package/dist/mixins/dropdown.js +216 -0
  246. package/dist/mixins/dropdown.js.map +1 -0
  247. package/dist/mixins/editable.d.ts.map +1 -1
  248. package/dist/mixins/editable.js +175 -0
  249. package/dist/mixins/editable.js.map +1 -0
  250. package/dist/mixins/grid-navigation.d.ts.map +1 -1
  251. package/dist/mixins/grid-navigation.js +194 -0
  252. package/dist/mixins/grid-navigation.js.map +1 -0
  253. package/dist/mixins/index.d.ts +8 -2
  254. package/dist/mixins/index.d.ts.map +1 -1
  255. package/dist/mixins/index.js +38 -0
  256. package/dist/mixins/index.js.map +1 -0
  257. package/dist/mixins/infinite-scroll.d.ts.map +1 -1
  258. package/dist/mixins/infinite-scroll.js +83 -0
  259. package/dist/mixins/infinite-scroll.js.map +1 -0
  260. package/dist/mixins/listbox.d.ts +19 -0
  261. package/dist/mixins/listbox.d.ts.map +1 -0
  262. package/dist/mixins/listbox.js +208 -0
  263. package/dist/mixins/listbox.js.map +1 -0
  264. package/dist/mixins/popup.d.ts +36 -0
  265. package/dist/mixins/popup.d.ts.map +1 -0
  266. package/dist/mixins/popup.js +113 -0
  267. package/dist/mixins/popup.js.map +1 -0
  268. package/dist/mixins/registry.d.ts +6 -0
  269. package/dist/mixins/registry.d.ts.map +1 -1
  270. package/dist/mixins/registry.js +167 -0
  271. package/dist/mixins/registry.js.map +1 -0
  272. package/dist/mixins/resizable.d.ts.map +1 -1
  273. package/dist/mixins/resizable.js +128 -0
  274. package/dist/mixins/resizable.js.map +1 -0
  275. package/dist/mixins/sortable.d.ts.map +1 -1
  276. package/dist/mixins/sortable.js +511 -0
  277. package/dist/mixins/sortable.js.map +1 -0
  278. package/dist/mixins/tooltip.d.ts.map +1 -1
  279. package/dist/mixins/tooltip.js +80 -0
  280. package/dist/mixins/tooltip.js.map +1 -0
  281. package/dist/mixins/utils.js +105 -0
  282. package/dist/mixins/utils.js.map +1 -0
  283. package/dist/plugins/async-validators.js +118 -0
  284. package/dist/plugins/async-validators.js.map +1 -0
  285. package/dist/plugins/builtins.d.ts +1 -1
  286. package/dist/plugins/builtins.d.ts.map +1 -1
  287. package/dist/plugins/builtins.js +20 -0
  288. package/dist/plugins/builtins.js.map +1 -0
  289. package/dist/plugins/date-utils.js +128 -0
  290. package/dist/plugins/date-utils.js.map +1 -0
  291. package/dist/plugins/plugin-manager.d.ts.map +1 -1
  292. package/dist/plugins/plugin-manager.js +99 -0
  293. package/dist/plugins/plugin-manager.js.map +1 -0
  294. package/dist/plugins/rich-text.js +365 -0
  295. package/dist/plugins/rich-text.js.map +1 -0
  296. package/dist/realtime/azure-pubsub-manager.js +273 -0
  297. package/dist/realtime/azure-pubsub-manager.js.map +1 -0
  298. package/dist/realtime/collab/anchors.d.ts +10 -0
  299. package/dist/realtime/collab/anchors.d.ts.map +1 -0
  300. package/dist/realtime/collab/anchors.js +19 -0
  301. package/dist/realtime/collab/anchors.js.map +1 -0
  302. package/dist/realtime/collab/collab-session.d.ts +46 -1
  303. package/dist/realtime/collab/collab-session.d.ts.map +1 -1
  304. package/dist/realtime/collab/collab-session.js +396 -0
  305. package/dist/realtime/collab/collab-session.js.map +1 -0
  306. package/dist/realtime/collab/cursor-overlay.d.ts +10 -0
  307. package/dist/realtime/collab/cursor-overlay.d.ts.map +1 -1
  308. package/dist/realtime/collab/cursor-overlay.js +187 -0
  309. package/dist/realtime/collab/cursor-overlay.js.map +1 -0
  310. package/dist/realtime/collab/textarea-adapter.d.ts +13 -0
  311. package/dist/realtime/collab/textarea-adapter.d.ts.map +1 -1
  312. package/dist/realtime/collab/textarea-adapter.js +125 -0
  313. package/dist/realtime/collab/textarea-adapter.js.map +1 -0
  314. package/dist/realtime/collab/undo-manager.d.ts +44 -0
  315. package/dist/realtime/collab/undo-manager.d.ts.map +1 -0
  316. package/dist/realtime/collab/undo-manager.js +148 -0
  317. package/dist/realtime/collab/undo-manager.js.map +1 -0
  318. package/dist/realtime/index.d.ts +11 -0
  319. package/dist/realtime/index.d.ts.map +1 -0
  320. package/dist/realtime/index.js +22 -0
  321. package/dist/realtime/index.js.map +1 -0
  322. package/dist/realtime/ot/client.d.ts +1 -1
  323. package/dist/realtime/ot/client.d.ts.map +1 -1
  324. package/dist/realtime/ot/client.js +74 -0
  325. package/dist/realtime/ot/client.js.map +1 -0
  326. package/dist/realtime/ot/server.d.ts +13 -1
  327. package/dist/realtime/ot/server.d.ts.map +1 -1
  328. package/dist/realtime/ot/server.js +292 -0
  329. package/dist/realtime/ot/server.js.map +1 -0
  330. package/dist/realtime/ot/text-operation.js +282 -0
  331. package/dist/realtime/ot/text-operation.js.map +1 -0
  332. package/dist/realtime/reconnect.js +58 -0
  333. package/dist/realtime/reconnect.js.map +1 -0
  334. package/dist/realtime/sse-manager.js +172 -0
  335. package/dist/realtime/sse-manager.js.map +1 -0
  336. package/dist/realtime/types.d.ts +29 -1
  337. package/dist/realtime/types.d.ts.map +1 -1
  338. package/dist/realtime/websocket-manager.js +180 -0
  339. package/dist/realtime/websocket-manager.js.map +1 -0
  340. package/dist/theme-polychrome-boot.js +17 -0
  341. package/dist/theme-polychrome.css +310 -0
  342. package/dist/theme.css +490 -1
  343. package/dist/tokens/base.tokens.json +18 -0
  344. package/dist/tokens/dark-high-contrast.tokens.json +11 -0
  345. package/dist/tokens/dark.tokens.json +81 -0
  346. package/dist/tokens/light-high-contrast.tokens.json +11 -0
  347. package/dist/tokens/light.tokens.json +81 -0
  348. package/dist/tokens/polychrome.base.tokens.json +45 -0
  349. package/dist/tokens/polychrome.dark-high-contrast.tokens.json +183 -0
  350. package/dist/tokens/polychrome.dark.tokens.json +321 -0
  351. package/dist/tokens/polychrome.light-high-contrast.tokens.json +115 -0
  352. package/dist/tokens/polychrome.light.tokens.json +418 -0
  353. package/dist/tokens/polychrome.resolver.json +78 -0
  354. package/dist/utils/backoff.js +30 -0
  355. package/dist/utils/backoff.js.map +1 -0
  356. package/dist/utils/dates.js +67 -0
  357. package/dist/utils/dates.js.map +1 -0
  358. package/dist/utils/dom.js +30 -0
  359. package/dist/utils/dom.js.map +1 -0
  360. package/dist/utils/emitter.js +40 -0
  361. package/dist/utils/emitter.js.map +1 -0
  362. package/dist/utils/fuzzy.d.ts +23 -0
  363. package/dist/utils/fuzzy.d.ts.map +1 -0
  364. package/dist/utils/fuzzy.js +95 -0
  365. package/dist/utils/fuzzy.js.map +1 -0
  366. package/dist/utils/path.js +99 -0
  367. package/dist/utils/path.js.map +1 -0
  368. package/dist/utils/sanitize.js +161 -0
  369. package/dist/utils/sanitize.js.map +1 -0
  370. package/dist/utils/url.js +44 -0
  371. package/dist/utils/url.js.map +1 -0
  372. package/dist/utils/virtual-window.d.ts +25 -0
  373. package/dist/utils/virtual-window.d.ts.map +1 -0
  374. package/dist/utils/virtual-window.js +19 -0
  375. package/dist/utils/virtual-window.js.map +1 -0
  376. package/dist/version.d.ts +1 -1
  377. package/dist/version.js +6 -0
  378. package/dist/version.js.map +1 -0
  379. package/package.json +63 -11
  380. package/dist/arethesis-jPH9QdQE.js +0 -5345
  381. package/dist/arethesis-jPH9QdQE.js.map +0 -1
  382. package/dist/arethesis.js.map +0 -1
  383. package/dist/components.js.map +0 -1
@@ -0,0 +1,58 @@
1
+ import { computeBackoff } from "../utils/backoff.js";
2
+ import { Emitter } from "../utils/emitter.js";
3
+ // src/realtime/reconnect.ts
4
+ var ReconnectPolicy = class extends Emitter {
5
+ options;
6
+ attempts = 0;
7
+ timer = null;
8
+ _status = "idle";
9
+ constructor(options) {
10
+ super();
11
+ this.options = options;
12
+ }
13
+ get status() {
14
+ return this._status;
15
+ }
16
+ set status(next) {
17
+ if (next === this._status) return;
18
+ this._status = next;
19
+ this.emit("status", next);
20
+ }
21
+ get attempt() {
22
+ return this.attempts;
23
+ }
24
+ /** Call on a successful connection. */
25
+ succeeded() {
26
+ this.attempts = 0;
27
+ this.status = "open";
28
+ }
29
+ /** Schedule `connect` after a backoff; returns false if giving up. */
30
+ schedule(connect) {
31
+ if (this.options.reconnect === false || this.attempts >= (this.options.maxReconnectAttempts ?? Infinity)) {
32
+ this.status = "closed";
33
+ return false;
34
+ }
35
+ if (this.timer) return true;
36
+ const delay = computeBackoff(this.attempts, {
37
+ baseDelay: this.options.baseDelay ?? 1e3,
38
+ maxDelay: this.options.maxDelay ?? 3e4,
39
+ jitter: this.options.jitter ?? .3
40
+ });
41
+ this.attempts++;
42
+ this.status = "reconnecting";
43
+ this.timer = setTimeout(() => {
44
+ this.timer = null;
45
+ connect();
46
+ }, delay);
47
+ return true;
48
+ }
49
+ /** Cancel a pending reconnect and reset. */
50
+ cancel() {
51
+ if (this.timer) clearTimeout(this.timer);
52
+ this.timer = null;
53
+ this.attempts = 0;
54
+ }
55
+ };
56
+ export { ReconnectPolicy };
57
+
58
+ //# sourceMappingURL=reconnect.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reconnect.js","names":[],"sources":["../../src/realtime/reconnect.ts"],"sourcesContent":["/**\n * Shared reconnect policy with exponential backoff and status tracking.\n *\n * @module realtime/reconnect\n * @internal\n */\n\nimport type { ConnectionStatus, ReconnectOptions } from './types';\nimport { computeBackoff } from '../utils/backoff';\nimport { Emitter } from '../utils/emitter';\n\nexport interface StatusEvents extends Record<string, unknown> {\n status: ConnectionStatus;\n}\n\nexport class ReconnectPolicy extends Emitter<StatusEvents> {\n private attempts = 0;\n private timer: ReturnType<typeof setTimeout> | null = null;\n private _status: ConnectionStatus = 'idle';\n\n constructor(private options: ReconnectOptions) {\n super();\n }\n\n get status(): ConnectionStatus {\n return this._status;\n }\n\n set status(next: ConnectionStatus) {\n if (next === this._status) return;\n this._status = next;\n this.emit('status', next);\n }\n\n get attempt(): number {\n return this.attempts;\n }\n\n /** Call on a successful connection. */\n succeeded(): void {\n this.attempts = 0;\n this.status = 'open';\n }\n\n /** Schedule `connect` after a backoff; returns false if giving up. */\n schedule(connect: () => void): boolean {\n if (this.options.reconnect === false || this.attempts >= (this.options.maxReconnectAttempts ?? Infinity)) {\n this.status = 'closed';\n return false;\n }\n if (this.timer) return true;\n const delay = computeBackoff(this.attempts, {\n baseDelay: this.options.baseDelay ?? 1000,\n maxDelay: this.options.maxDelay ?? 30000,\n jitter: this.options.jitter ?? 0.3,\n });\n this.attempts++;\n this.status = 'reconnecting';\n this.timer = setTimeout(() => {\n this.timer = null;\n connect();\n }, delay);\n return true;\n }\n\n /** Cancel a pending reconnect and reset. */\n cancel(): void {\n if (this.timer) clearTimeout(this.timer);\n this.timer = null;\n this.attempts = 0;\n }\n}\n"],"mappings":";;;AAeA,IAAa,kBAAb,cAAqC,QAAsB;CAKrC;CAJpB,WAAmB;CACnB,QAAsD;CACtD,UAAoC;CAEpC,YAAY,SAAmC;EAC7C,MAAM;EADY,KAAA,UAAA;CAEpB;CAEA,IAAI,SAA2B;EAC7B,OAAO,KAAK;CACd;CAEA,IAAI,OAAO,MAAwB;EACjC,IAAI,SAAS,KAAK,SAAS;EAC3B,KAAK,UAAU;EACf,KAAK,KAAK,UAAU,IAAI;CAC1B;CAEA,IAAI,UAAkB;EACpB,OAAO,KAAK;CACd;;CAGA,YAAkB;EAChB,KAAK,WAAW;EAChB,KAAK,SAAS;CAChB;;CAGA,SAAS,SAA8B;EACrC,IAAI,KAAK,QAAQ,cAAc,SAAS,KAAK,aAAa,KAAK,QAAQ,wBAAwB,WAAW;GACxG,KAAK,SAAS;GACd,OAAO;EACT;EACA,IAAI,KAAK,OAAO,OAAO;EACvB,MAAM,QAAQ,eAAe,KAAK,UAAU;GAC1C,WAAW,KAAK,QAAQ,aAAa;GACrC,UAAU,KAAK,QAAQ,YAAY;GACnC,QAAQ,KAAK,QAAQ,UAAU;EACjC,CAAC;EACD,KAAK;EACL,KAAK,SAAS;EACd,KAAK,QAAQ,iBAAiB;GAC5B,KAAK,QAAQ;GACb,QAAQ;EACV,GAAG,KAAK;EACR,OAAO;CACT;;CAGA,SAAe;EACb,IAAI,KAAK,OAAO,aAAa,KAAK,KAAK;EACvC,KAAK,QAAQ;EACb,KAAK,WAAW;CAClB;AACF"}
@@ -0,0 +1,172 @@
1
+ import { ReconnectPolicy } from "./reconnect.js";
2
+ import { Emitter } from "../utils/emitter.js";
3
+ // src/realtime/sse-manager.ts
4
+ var SSEManager = class {
5
+ config;
6
+ source = null;
7
+ store = null;
8
+ listViews = null;
9
+ getToken = null;
10
+ policy;
11
+ generation = 0;
12
+ lastEventId = null;
13
+ handlers = new Emitter();
14
+ customEvents = /* @__PURE__ */ new Set();
15
+ constructor(config) {
16
+ this.config = config;
17
+ this.policy = new ReconnectPolicy(config);
18
+ }
19
+ connectStore(store, listViews) {
20
+ this.store = store;
21
+ this.listViews = listViews ?? null;
22
+ }
23
+ setTokenProvider(getter) {
24
+ this.getToken = getter;
25
+ }
26
+ get status() {
27
+ return this.policy.status;
28
+ }
29
+ get isConnected() {
30
+ return this.policy.status === "open";
31
+ }
32
+ /** Listen for status changes. */
33
+ onStatusChange(handler) {
34
+ return this.policy.on("status", handler);
35
+ }
36
+ /** Listen for a named event (including built-ins). Returns an unsubscribe function. */
37
+ on(event, handler) {
38
+ if (![
39
+ "invalidate",
40
+ "delete",
41
+ "upsert",
42
+ "message",
43
+ "ping"
44
+ ].includes(event) && !this.customEvents.has(event)) {
45
+ this.customEvents.add(event);
46
+ this.source?.addEventListener(event, (e) => this.dispatch(event, e));
47
+ }
48
+ return this.handlers.on(event, ({ data, event: e }) => handler(data, e));
49
+ }
50
+ /** Open the stream. Safe to call repeatedly. */
51
+ async connect() {
52
+ if (this.source || this.policy.status === "connecting") return;
53
+ const gen = ++this.generation;
54
+ this.policy.status = "connecting";
55
+ const url = await this.buildUrl();
56
+ if (gen !== this.generation) return;
57
+ let source;
58
+ try {
59
+ const init = { withCredentials: this.config.withCredentials };
60
+ source = this.config.eventSourceFactory ? this.config.eventSourceFactory(url, init) : new EventSource(url, init);
61
+ } catch (err) {
62
+ console.error("SSE connection error:", err);
63
+ this.source = null;
64
+ this.policy.status = "idle";
65
+ this.policy.schedule(() => void this.connect());
66
+ return;
67
+ }
68
+ this.source = source;
69
+ source.onopen = () => {
70
+ if (this.source === source) this.policy.succeeded();
71
+ };
72
+ source.onerror = () => {
73
+ if (this.source !== source) return;
74
+ source.close();
75
+ this.source = null;
76
+ this.policy.status = "idle";
77
+ this.policy.schedule(() => void this.connect());
78
+ };
79
+ source.onmessage = (e) => this.handleGeneric(e);
80
+ for (const name of [
81
+ "invalidate",
82
+ "delete",
83
+ "upsert",
84
+ "ping",
85
+ ...this.customEvents
86
+ ]) source.addEventListener(name, (e) => this.dispatch(name, e));
87
+ }
88
+ async buildUrl() {
89
+ const params = [];
90
+ const tokenParam = this.config.tokenParam ?? "token";
91
+ if (tokenParam && this.getToken) {
92
+ const token = await this.getToken();
93
+ if (token) params.push(`${encodeURIComponent(tokenParam)}=${encodeURIComponent(token)}`);
94
+ }
95
+ const idParam = this.config.lastEventIdParam ?? "lastEventId";
96
+ if (idParam && this.lastEventId) params.push(`${encodeURIComponent(idParam)}=${encodeURIComponent(this.lastEventId)}`);
97
+ if (!params.length) return this.config.url;
98
+ return `${this.config.url}${this.config.url.includes("?") ? "&" : "?"}${params.join("&")}`;
99
+ }
100
+ parse(event) {
101
+ if (event.lastEventId) this.lastEventId = event.lastEventId;
102
+ if (typeof event.data !== "string") return event.data;
103
+ try {
104
+ return JSON.parse(event.data);
105
+ } catch {
106
+ return event.data;
107
+ }
108
+ }
109
+ dispatch(name, event) {
110
+ const data = this.parse(event);
111
+ this.applyBuiltIn(name, data);
112
+ this.handlers.emit(name, {
113
+ data,
114
+ event
115
+ });
116
+ }
117
+ /** Generic `message` events: `{ action: 'invalidate' | 'delete' | 'upsert', type, ... }`. */
118
+ handleGeneric(event) {
119
+ const data = this.parse(event);
120
+ const action = typeof data === "object" && data !== null ? data.action ?? data.event : void 0;
121
+ if (action) {
122
+ this.applyBuiltIn(action, data);
123
+ this.handlers.emit(action, {
124
+ data,
125
+ event
126
+ });
127
+ }
128
+ this.handlers.emit("message", {
129
+ data,
130
+ event
131
+ });
132
+ }
133
+ applyBuiltIn(name, data) {
134
+ if (!this.store || typeof data !== "object" || data === null) return;
135
+ const payload = data;
136
+ if (typeof payload.type !== "string") return;
137
+ switch (name) {
138
+ case "invalidate": {
139
+ const p = payload;
140
+ const ids = p.ids ?? (p.id !== void 0 ? [p.id] : null);
141
+ if (ids) this.store.batch(() => ids.forEach((id) => this.store.invalidate(p.type, id)));
142
+ else this.store.invalidateByType(p.type);
143
+ this.listViews?.invalidateByType(p.type);
144
+ break;
145
+ }
146
+ case "delete": {
147
+ const p = payload;
148
+ if (p.id === void 0) return;
149
+ this.listViews?.removeFromAll(p.type, String(p.id));
150
+ this.store.delete(p.type, p.id);
151
+ break;
152
+ }
153
+ case "upsert": {
154
+ const p = payload;
155
+ const id = p.id ?? this.store.getId(p.type, p.data);
156
+ if (id !== void 0) this.store.upsert(p.type, id, p.data, { source: "sse" });
157
+ break;
158
+ }
159
+ }
160
+ }
161
+ /** Close the stream and stop reconnecting. */
162
+ disconnect() {
163
+ this.generation++;
164
+ this.policy.cancel();
165
+ this.source?.close();
166
+ this.source = null;
167
+ this.policy.status = "closed";
168
+ }
169
+ };
170
+ export { SSEManager };
171
+
172
+ //# sourceMappingURL=sse-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sse-manager.js","names":[],"sources":["../../src/realtime/sse-manager.ts"],"sourcesContent":["/**\n * SSEManager: Server-Sent Events for cache invalidation and live data.\n *\n * Built-in events (named SSE events, or a generic message whose `action` field\n * names the event):\n * - `invalidate` `{ type, id? , ids? }`: mark objects stale (bound components refetch)\n * - `delete` `{ type, id }`: remove an object and drop it from list views\n * - `upsert` `{ type, id?, data }`: write fresh data into the store\n *\n * Any other event is available through `on(name, handler)`.\n *\n * Reconnects are handled here, not by EventSource itself, so each attempt\n * uses a freshly refreshed access token.\n *\n * @module realtime/sse-manager\n */\n\nimport type { ConnectionStatus, DeletePayload, InvalidatePayload, SSEConfig, UpsertPayload } from './types';\nimport type { ObjectStore } from '../data/object-store';\nimport type { ListViewRegistry } from '../data/list-view-registry';\nimport { ReconnectPolicy } from './reconnect';\nimport { Emitter } from '../utils/emitter';\n\ntype Handler = (data: unknown, event: MessageEvent) => void;\n\nexport class SSEManager {\n readonly config: SSEConfig;\n private source: EventSource | null = null;\n private store: ObjectStore | null = null;\n private listViews: ListViewRegistry | null = null;\n private getToken: (() => Promise<string | null> | string | null) | null = null;\n private policy: ReconnectPolicy;\n private generation = 0;\n private lastEventId: string | null = null;\n private handlers = new Emitter<Record<string, { data: unknown; event: MessageEvent }>>();\n private customEvents = new Set<string>();\n\n constructor(config: SSEConfig) {\n this.config = config;\n this.policy = new ReconnectPolicy(config);\n }\n\n connectStore(store: ObjectStore, listViews?: ListViewRegistry): void {\n this.store = store;\n this.listViews = listViews ?? null;\n }\n\n setTokenProvider(getter: () => Promise<string | null> | string | null): void {\n this.getToken = getter;\n }\n\n get status(): ConnectionStatus {\n return this.policy.status;\n }\n\n get isConnected(): boolean {\n return this.policy.status === 'open';\n }\n\n /** Listen for status changes. */\n onStatusChange(handler: (status: ConnectionStatus) => void): () => void {\n return this.policy.on('status', handler);\n }\n\n /** Listen for a named event (including built-ins). Returns an unsubscribe function. */\n on(event: string, handler: Handler): () => void {\n if (!['invalidate', 'delete', 'upsert', 'message', 'ping'].includes(event) && !this.customEvents.has(event)) {\n this.customEvents.add(event);\n this.source?.addEventListener(event, e => this.dispatch(event, e as MessageEvent));\n }\n return this.handlers.on(event, ({ data, event: e }) => handler(data, e));\n }\n\n /** Open the stream. Safe to call repeatedly. */\n async connect(): Promise<void> {\n if (this.source || this.policy.status === 'connecting') return;\n const gen = ++this.generation;\n this.policy.status = 'connecting';\n const url = await this.buildUrl();\n if (gen !== this.generation) return; // disconnected while fetching the token\n\n let source: EventSource;\n try {\n const init: EventSourceInit = { withCredentials: this.config.withCredentials };\n source = this.config.eventSourceFactory ? this.config.eventSourceFactory(url, init) : new EventSource(url, init);\n } catch (err) {\n console.error('SSE connection error:', err);\n this.source = null;\n this.policy.status = 'idle';\n this.policy.schedule(() => void this.connect());\n return;\n }\n this.source = source;\n\n source.onopen = () => {\n if (this.source === source) this.policy.succeeded();\n };\n source.onerror = () => {\n if (this.source !== source) return;\n // Take over reconnection so the next attempt gets a fresh token.\n source.close();\n this.source = null;\n this.policy.status = 'idle';\n this.policy.schedule(() => void this.connect());\n };\n source.onmessage = e => this.handleGeneric(e);\n for (const name of ['invalidate', 'delete', 'upsert', 'ping', ...this.customEvents]) {\n source.addEventListener(name, e => this.dispatch(name, e as MessageEvent));\n }\n }\n\n private async buildUrl(): Promise<string> {\n const params: string[] = [];\n const tokenParam = this.config.tokenParam ?? 'token';\n if (tokenParam && this.getToken) {\n const token = await this.getToken();\n if (token) params.push(`${encodeURIComponent(tokenParam)}=${encodeURIComponent(token)}`);\n }\n const idParam = this.config.lastEventIdParam ?? 'lastEventId';\n if (idParam && this.lastEventId) params.push(`${encodeURIComponent(idParam)}=${encodeURIComponent(this.lastEventId)}`);\n if (!params.length) return this.config.url;\n return `${this.config.url}${this.config.url.includes('?') ? '&' : '?'}${params.join('&')}`;\n }\n\n private parse(event: MessageEvent): unknown {\n if (event.lastEventId) this.lastEventId = event.lastEventId;\n if (typeof event.data !== 'string') return event.data;\n try {\n return JSON.parse(event.data);\n } catch {\n return event.data;\n }\n }\n\n private dispatch(name: string, event: MessageEvent): void {\n const data = this.parse(event);\n this.applyBuiltIn(name, data);\n this.handlers.emit(name, { data, event });\n }\n\n /** Generic `message` events: `{ action: 'invalidate' | 'delete' | 'upsert', type, ... }`. */\n private handleGeneric(event: MessageEvent): void {\n const data = this.parse(event);\n const action = typeof data === 'object' && data !== null\n ? ((data as Record<string, unknown>).action ?? (data as Record<string, unknown>).event) as string | undefined\n : undefined;\n if (action) {\n this.applyBuiltIn(action, data);\n this.handlers.emit(action, { data, event });\n }\n this.handlers.emit('message', { data, event });\n }\n\n private applyBuiltIn(name: string, data: unknown): void {\n if (!this.store || typeof data !== 'object' || data === null) return;\n const payload = data as Record<string, unknown>;\n if (typeof payload.type !== 'string') return;\n switch (name) {\n case 'invalidate': {\n const p = payload as unknown as InvalidatePayload;\n const ids = p.ids ?? (p.id !== undefined ? [p.id] : null);\n if (ids) this.store.batch(() => ids.forEach(id => this.store!.invalidate(p.type, id)));\n else this.store.invalidateByType(p.type);\n this.listViews?.invalidateByType(p.type);\n break;\n }\n case 'delete': {\n const p = payload as unknown as DeletePayload;\n if (p.id === undefined) return;\n this.listViews?.removeFromAll(p.type, String(p.id));\n this.store.delete(p.type, p.id);\n break;\n }\n case 'upsert': {\n const p = payload as unknown as UpsertPayload;\n const id = p.id ?? this.store.getId(p.type, p.data);\n if (id !== undefined) this.store.upsert(p.type, id, p.data, { source: 'sse' });\n break;\n }\n }\n }\n\n /** Close the stream and stop reconnecting. */\n disconnect(): void {\n this.generation++;\n this.policy.cancel();\n this.source?.close();\n this.source = null;\n this.policy.status = 'closed';\n }\n}\n"],"mappings":"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"}
@@ -109,11 +109,39 @@ export interface PresencePayload {
109
109
  selection?: CollabSelection;
110
110
  revision?: number;
111
111
  }
112
- export type CollabMessageType = 'collab:join' | 'collab:init' | 'collab:op' | 'collab:ack' | 'collab:presence' | 'collab:leave' | 'collab:error';
112
+ export type CollabMessageType = 'collab:join' | 'collab:init' | 'collab:op' | 'collab:ack' | 'collab:presence' | 'collab:leave' | 'collab:annotate' | 'collab:error';
113
113
  export interface CollabMessage extends WebSocketMessage {
114
114
  type: CollabMessageType;
115
115
  channel: string;
116
116
  }
117
+ /**
118
+ * A comment (or any note) attached to a range of a shared document. The
119
+ * range moves with the text as people edit; text typed exactly at either end
120
+ * stays outside it. If its text is deleted, the range collapses (`from === to`).
121
+ */
122
+ export interface CollabAnnotation {
123
+ id: string;
124
+ from: number;
125
+ to: number;
126
+ body: string;
127
+ user?: CollabUser;
128
+ resolved?: boolean;
129
+ /** Milliseconds since the epoch. */
130
+ createdAt?: number;
131
+ replies?: Array<{
132
+ body: string;
133
+ user?: CollabUser;
134
+ createdAt?: number;
135
+ }>;
136
+ }
137
+ /** `collab:annotate` payload: add, change or remove an annotation. Positions are at `revision`. */
138
+ export interface AnnotatePayload {
139
+ action: 'add' | 'update' | 'remove';
140
+ annotation: Partial<CollabAnnotation> & {
141
+ id: string;
142
+ };
143
+ revision?: number;
144
+ }
117
145
  export interface RemoteCursor {
118
146
  clientId: string;
119
147
  user?: CollabUser;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,180 @@
1
+ import { ReconnectPolicy } from "./reconnect.js";
2
+ // src/realtime/websocket-manager.ts
3
+ var SYSTEM_TYPES = /* @__PURE__ */ new Set(["ping", "pong"]);
4
+ var WebSocketManager = class {
5
+ config;
6
+ socket = null;
7
+ channels = /* @__PURE__ */ new Map();
8
+ queue = [];
9
+ getToken = null;
10
+ policy;
11
+ pingTimer = null;
12
+ generation = 0;
13
+ openListeners = /* @__PURE__ */ new Set();
14
+ constructor(config) {
15
+ this.config = {
16
+ pingInterval: 3e4,
17
+ maxQueue: 1e3,
18
+ ...config
19
+ };
20
+ this.policy = new ReconnectPolicy(config);
21
+ }
22
+ setTokenProvider(getter) {
23
+ this.getToken = getter;
24
+ }
25
+ get status() {
26
+ return this.policy.status;
27
+ }
28
+ get isConnected() {
29
+ return this.socket?.readyState === 1;
30
+ }
31
+ onStatusChange(handler) {
32
+ return this.policy.on("status", handler);
33
+ }
34
+ /** Called every time the connection opens (initially and after reconnects). */
35
+ onOpen(handler) {
36
+ this.openListeners.add(handler);
37
+ return () => this.openListeners.delete(handler);
38
+ }
39
+ async connect() {
40
+ if (this.socket || this.policy.status === "connecting") return;
41
+ const gen = ++this.generation;
42
+ this.policy.status = "connecting";
43
+ let url = this.config.url;
44
+ const tokenParam = this.config.tokenParam ?? "token";
45
+ if (tokenParam && this.getToken) {
46
+ const token = await this.getToken();
47
+ if (token) url += `${url.includes("?") ? "&" : "?"}${encodeURIComponent(tokenParam)}=${encodeURIComponent(token)}`;
48
+ }
49
+ if (gen !== this.generation) return;
50
+ let socket;
51
+ try {
52
+ socket = this.config.socketFactory ? this.config.socketFactory(url, this.config.protocols) : new WebSocket(url, this.config.protocols);
53
+ } catch (err) {
54
+ console.error("WebSocket connection error:", err);
55
+ this.policy.status = "idle";
56
+ this.policy.schedule(() => void this.connect());
57
+ return;
58
+ }
59
+ this.socket = socket;
60
+ socket.onopen = () => {
61
+ if (this.socket !== socket) return;
62
+ this.policy.succeeded();
63
+ this.startPing();
64
+ for (const channel of this.channels.keys()) if (channel !== "*") this.rawSend({
65
+ type: "subscribe",
66
+ channel
67
+ });
68
+ this.flush();
69
+ for (const fn of [...this.openListeners]) fn();
70
+ };
71
+ socket.onclose = (event) => {
72
+ if (this.socket !== socket) return;
73
+ this.socket = null;
74
+ this.stopPing();
75
+ this.policy.status = "idle";
76
+ if (event.code !== 1e3) this.policy.schedule(() => void this.connect());
77
+ else this.policy.status = "closed";
78
+ };
79
+ socket.onerror = () => {};
80
+ socket.onmessage = (event) => {
81
+ if (this.socket !== socket) return;
82
+ let message;
83
+ try {
84
+ message = JSON.parse(String(event.data));
85
+ } catch {
86
+ console.error("WebSocket: ignoring non-JSON message");
87
+ return;
88
+ }
89
+ if (!message || typeof message.type !== "string" || SYSTEM_TYPES.has(message.type)) return;
90
+ this.dispatch(message);
91
+ };
92
+ }
93
+ dispatch(message) {
94
+ const targets = [message.channel ? this.channels.get(message.channel) : void 0, this.channels.get("*")];
95
+ for (const set of targets) {
96
+ if (!set) continue;
97
+ for (const cb of [...set]) try {
98
+ cb(message);
99
+ } catch (err) {
100
+ console.error("WebSocket subscriber error:", err);
101
+ }
102
+ }
103
+ }
104
+ /** Subscribe to a channel. The first subscriber sends `subscribe`; the last unsubscribe sends `unsubscribe`. */
105
+ subscribe(channel, callback) {
106
+ let set = this.channels.get(channel);
107
+ if (!set) {
108
+ set = /* @__PURE__ */ new Set();
109
+ this.channels.set(channel, set);
110
+ if (channel !== "*" && this.isConnected) this.rawSend({
111
+ type: "subscribe",
112
+ channel
113
+ });
114
+ }
115
+ set.add(callback);
116
+ return () => {
117
+ const s = this.channels.get(channel);
118
+ if (!s?.delete(callback) || s.size > 0) return;
119
+ this.channels.delete(channel);
120
+ if (channel !== "*" && this.isConnected) this.rawSend({
121
+ type: "unsubscribe",
122
+ channel
123
+ });
124
+ };
125
+ }
126
+ /** Send a message, or queue it until connected. */
127
+ send(message) {
128
+ if (this.isConnected) {
129
+ this.rawSend(message);
130
+ return;
131
+ }
132
+ this.queue.push(message);
133
+ const max = this.config.maxQueue ?? 1e3;
134
+ if (this.queue.length > max) this.queue.splice(0, this.queue.length - max);
135
+ }
136
+ /** Broadcast presence data on a channel. */
137
+ sendPresence(channel, payload) {
138
+ this.send({
139
+ type: "presence",
140
+ channel,
141
+ payload
142
+ });
143
+ }
144
+ rawSend(message) {
145
+ this.socket?.send(JSON.stringify(message));
146
+ }
147
+ flush() {
148
+ const queued = this.queue.splice(0);
149
+ for (const m of queued) this.rawSend(m);
150
+ }
151
+ startPing() {
152
+ this.stopPing();
153
+ if (!this.config.pingInterval) return;
154
+ this.pingTimer = setInterval(() => {
155
+ if (this.isConnected) this.rawSend({ type: "ping" });
156
+ }, this.config.pingInterval);
157
+ }
158
+ stopPing() {
159
+ if (this.pingTimer) clearInterval(this.pingTimer);
160
+ this.pingTimer = null;
161
+ }
162
+ /** Close the connection and stop reconnecting. */
163
+ disconnect() {
164
+ this.generation++;
165
+ this.policy.cancel();
166
+ this.stopPing();
167
+ const socket = this.socket;
168
+ this.socket = null;
169
+ if (socket) {
170
+ socket.onopen = socket.onmessage = socket.onerror = socket.onclose = null;
171
+ try {
172
+ socket.close(1e3, "Client disconnect");
173
+ } catch {}
174
+ }
175
+ this.policy.status = "closed";
176
+ }
177
+ };
178
+ export { WebSocketManager };
179
+
180
+ //# sourceMappingURL=websocket-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"websocket-manager.js","names":[],"sources":["../../src/realtime/websocket-manager.ts"],"sourcesContent":["/**\n * WebSocketManager: channels, presence and edits over one WebSocket.\n *\n * Messages are JSON `{ type, channel?, payload? }`. Subscribing to a channel\n * sends `{ type: 'subscribe', channel }`; channels are re-subscribed after a\n * reconnect, and messages sent while offline are queued. Subscribe to `'*'`\n * to receive everything.\n *\n * @module realtime/websocket-manager\n */\n\nimport type { ChannelCallback, ConnectionStatus, WebSocketConfig, WebSocketMessage } from './types';\nimport { ReconnectPolicy } from './reconnect';\n\nconst SYSTEM_TYPES = new Set(['ping', 'pong']);\n\nexport class WebSocketManager {\n readonly config: WebSocketConfig;\n private socket: WebSocket | null = null;\n private channels = new Map<string, Set<ChannelCallback>>();\n private queue: WebSocketMessage[] = [];\n private getToken: (() => Promise<string | null> | string | null) | null = null;\n private policy: ReconnectPolicy;\n private pingTimer: ReturnType<typeof setInterval> | null = null;\n private generation = 0;\n private openListeners = new Set<() => void>();\n\n constructor(config: WebSocketConfig) {\n this.config = { pingInterval: 30000, maxQueue: 1000, ...config };\n this.policy = new ReconnectPolicy(config);\n }\n\n setTokenProvider(getter: () => Promise<string | null> | string | null): void {\n this.getToken = getter;\n }\n\n get status(): ConnectionStatus {\n return this.policy.status;\n }\n\n get isConnected(): boolean {\n return this.socket?.readyState === 1;\n }\n\n onStatusChange(handler: (status: ConnectionStatus) => void): () => void {\n return this.policy.on('status', handler);\n }\n\n /** Called every time the connection opens (initially and after reconnects). */\n onOpen(handler: () => void): () => void {\n this.openListeners.add(handler);\n return () => this.openListeners.delete(handler);\n }\n\n async connect(): Promise<void> {\n if (this.socket || this.policy.status === 'connecting') return;\n const gen = ++this.generation;\n this.policy.status = 'connecting';\n\n let url = this.config.url;\n const tokenParam = this.config.tokenParam ?? 'token';\n if (tokenParam && this.getToken) {\n const token = await this.getToken();\n if (token) url += `${url.includes('?') ? '&' : '?'}${encodeURIComponent(tokenParam)}=${encodeURIComponent(token)}`;\n }\n if (gen !== this.generation) return;\n\n let socket: WebSocket;\n try {\n socket = this.config.socketFactory ? this.config.socketFactory(url, this.config.protocols) : new WebSocket(url, this.config.protocols);\n } catch (err) {\n console.error('WebSocket connection error:', err);\n this.policy.status = 'idle';\n this.policy.schedule(() => void this.connect());\n return;\n }\n this.socket = socket;\n\n socket.onopen = () => {\n if (this.socket !== socket) return;\n this.policy.succeeded();\n this.startPing();\n for (const channel of this.channels.keys()) if (channel !== '*') this.rawSend({ type: 'subscribe', channel });\n this.flush();\n for (const fn of [...this.openListeners]) fn();\n };\n socket.onclose = (event: CloseEvent) => {\n // Ignore late events from a socket we already replaced.\n if (this.socket !== socket) return;\n this.socket = null;\n this.stopPing();\n this.policy.status = 'idle';\n if (event.code !== 1000) this.policy.schedule(() => void this.connect());\n else this.policy.status = 'closed';\n };\n socket.onerror = () => {\n /* onclose follows and handles reconnection */\n };\n socket.onmessage = (event: MessageEvent) => {\n if (this.socket !== socket) return;\n let message: WebSocketMessage;\n try {\n message = JSON.parse(String(event.data));\n } catch {\n console.error('WebSocket: ignoring non-JSON message');\n return;\n }\n if (!message || typeof message.type !== 'string' || SYSTEM_TYPES.has(message.type)) return;\n this.dispatch(message);\n };\n }\n\n private dispatch(message: WebSocketMessage): void {\n const targets = [message.channel ? this.channels.get(message.channel) : undefined, this.channels.get('*')];\n for (const set of targets) {\n if (!set) continue;\n for (const cb of [...set]) {\n try {\n cb(message);\n } catch (err) {\n console.error('WebSocket subscriber error:', err);\n }\n }\n }\n }\n\n /** Subscribe to a channel. The first subscriber sends `subscribe`; the last unsubscribe sends `unsubscribe`. */\n subscribe<M extends WebSocketMessage = WebSocketMessage>(channel: string, callback: ChannelCallback<M>): () => void {\n let set = this.channels.get(channel);\n if (!set) {\n set = new Set();\n this.channels.set(channel, set);\n if (channel !== '*' && this.isConnected) this.rawSend({ type: 'subscribe', channel });\n }\n set.add(callback as ChannelCallback);\n return () => {\n const s = this.channels.get(channel);\n if (!s?.delete(callback as ChannelCallback) || s.size > 0) return;\n this.channels.delete(channel);\n if (channel !== '*' && this.isConnected) this.rawSend({ type: 'unsubscribe', channel });\n };\n }\n\n /** Send a message, or queue it until connected. */\n send(message: WebSocketMessage): void {\n if (this.isConnected) {\n this.rawSend(message);\n return;\n }\n this.queue.push(message);\n const max = this.config.maxQueue ?? 1000;\n if (this.queue.length > max) this.queue.splice(0, this.queue.length - max);\n }\n\n /** Broadcast presence data on a channel. */\n sendPresence(channel: string, payload: Record<string, unknown>): void {\n this.send({ type: 'presence', channel, payload });\n }\n\n private rawSend(message: WebSocketMessage): void {\n this.socket?.send(JSON.stringify(message));\n }\n\n private flush(): void {\n const queued = this.queue.splice(0);\n for (const m of queued) this.rawSend(m);\n }\n\n private startPing(): void {\n this.stopPing();\n if (!this.config.pingInterval) return;\n this.pingTimer = setInterval(() => {\n if (this.isConnected) this.rawSend({ type: 'ping' });\n }, this.config.pingInterval);\n }\n\n private stopPing(): void {\n if (this.pingTimer) clearInterval(this.pingTimer);\n this.pingTimer = null;\n }\n\n /** Close the connection and stop reconnecting. */\n disconnect(): void {\n this.generation++;\n this.policy.cancel();\n this.stopPing();\n const socket = this.socket;\n this.socket = null;\n if (socket) {\n socket.onopen = socket.onmessage = socket.onerror = socket.onclose = null;\n try {\n socket.close(1000, 'Client disconnect');\n } catch {\n /* ignore */\n }\n }\n this.policy.status = 'closed';\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ /* Arethesis theme boot: load in <head> with a plain <script src> (not a module) so it runs before the first paint. */
2
+ (function () {
3
+ var script = document.currentScript;
4
+ var themeKey = (script && script.getAttribute('data-theme-key')) || "ar-theme";
5
+ var contrastKey = (script && script.getAttribute('data-contrast-key')) || "ar-contrast";
6
+ try {
7
+ var root = document.documentElement;
8
+ var theme = localStorage.getItem(themeKey);
9
+ var contrast = localStorage.getItem(contrastKey);
10
+ if (theme === 'light' || theme === 'dark') root.setAttribute('data-theme', theme);
11
+ if (contrast === 'more' || contrast === 'standard') root.setAttribute('data-contrast', contrast);
12
+ } catch (e) {}
13
+ var style = document.createElement('style');
14
+ style.setAttribute('data-arethesis-boot', '');
15
+ style.textContent = ":root{background:#f5eedf;color:#1d1712;color-scheme:light}@media (prefers-color-scheme: dark){:root:not([data-theme='light']){background:#14100c;color:#efe4d0;color-scheme:dark}}:root[data-theme='dark']{background:#14100c;color:#efe4d0;color-scheme:dark}@media (prefers-contrast: more){:root:not([data-contrast='standard']){background:#f5eedf;color:#000000;color-scheme:light}}:root[data-contrast='more']{background:#f5eedf;color:#000000;color-scheme:light}@media (prefers-contrast: more) and (prefers-color-scheme: dark){:root:not([data-contrast='standard']):not([data-theme='light']){background:#000000;color:#ffffff;color-scheme:dark}}@media (prefers-contrast: more){:root[data-theme='dark']:not([data-contrast='standard']){background:#000000;color:#ffffff;color-scheme:dark}}@media (prefers-color-scheme: dark){:root[data-contrast='more']:not([data-theme='light']){background:#000000;color:#ffffff;color-scheme:dark}}:root[data-theme='dark'][data-contrast='more']{background:#000000;color:#ffffff;color-scheme:dark}";
16
+ document.head.appendChild(style);
17
+ })();