@firstpick/pi-package-webui 0.11.1 → 0.11.2

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 (309) hide show
  1. package/DEVELOPMENT.md +151 -12
  2. package/README.md +34 -6
  3. package/TECHNICAL.md +75 -8
  4. package/bin/pi-webui.mjs +5390 -11423
  5. package/index.ts +10 -3
  6. package/lib/component-update-state.mjs +2 -2
  7. package/lib/git-workflow-preference-values.mjs +122 -0
  8. package/lib/git-workflow-preferences.mjs +35 -563
  9. package/lib/package-updates.mjs +260 -0
  10. package/lib/rpc-supervisor-client.mjs +8 -4
  11. package/lib/server/app-runners.mjs +1667 -0
  12. package/lib/server/codex-fast-mode.mjs +161 -0
  13. package/lib/server/conversation-mode.mjs +218 -0
  14. package/lib/server/conversation-voice.mjs +318 -0
  15. package/lib/server/extension-ui-requests.mjs +114 -0
  16. package/lib/server/git-generation.mjs +459 -0
  17. package/lib/server/git-mutations.mjs +1827 -0
  18. package/lib/server/git-reads.mjs +608 -0
  19. package/lib/server/git-worktree-sessions.mjs +408 -0
  20. package/lib/server/helper-requests.mjs +82 -0
  21. package/lib/server/no-project-workspaces.mjs +103 -0
  22. package/lib/server/rpc-transports.mjs +394 -0
  23. package/lib/server/settings-store.mjs +544 -0
  24. package/lib/server/sse-delivery.mjs +138 -0
  25. package/lib/server/workspace-files.mjs +563 -0
  26. package/lib/update/supervisor.mjs +4 -0
  27. package/lib/webui-workspaces.mjs +2 -0
  28. package/package.json +4 -4
  29. package/public/activity-agents-controller.mjs +269 -0
  30. package/public/activity-events-controller.mjs +236 -0
  31. package/public/activity-intercom-controller.mjs +627 -0
  32. package/public/activity-queue-controller.mjs +534 -0
  33. package/public/activity-todo-view.mjs +89 -0
  34. package/public/activity-usage-controller.mjs +589 -0
  35. package/public/app.js +3761 -3886
  36. package/public/conversation-overview.css +84 -0
  37. package/public/conversation-overview.mjs +193 -0
  38. package/public/draft-conversations.mjs +135 -0
  39. package/public/focused-composer-controls.css +111 -0
  40. package/public/focused-composer-controls.mjs +143 -0
  41. package/public/focused-composer-disclosure.mjs +223 -0
  42. package/public/focused-shell-adapter.css +264 -0
  43. package/public/focused-shell-adapter.mjs +257 -0
  44. package/public/index.html +137 -80
  45. package/public/model-catalog-order.mjs +63 -0
  46. package/public/platform-event-stream.mjs +64 -0
  47. package/public/project-artifact-controller.mjs +218 -0
  48. package/public/project-file-viewer-controller.mjs +383 -0
  49. package/public/project-git-tools-controller.mjs +181 -0
  50. package/public/project-runners-controller.mjs +220 -0
  51. package/public/service-worker.js +52 -1
  52. package/public/session-attention-scheduler.mjs +182 -0
  53. package/public/session-composer-store.mjs +56 -0
  54. package/public/session-context.mjs +51 -0
  55. package/public/session-extension-requests.mjs +63 -0
  56. package/public/session-shelf-state.mjs +151 -0
  57. package/public/session-shelves.css +171 -0
  58. package/public/session-shelves.mjs +95 -0
  59. package/public/settings-navigation-controller.mjs +249 -0
  60. package/public/settings-navigation.css +61 -0
  61. package/public/settings-resource-controller.mjs +232 -0
  62. package/public/settings-workspace.css +19 -0
  63. package/public/settings-workspace.mjs +175 -0
  64. package/public/shell-actions.mjs +87 -0
  65. package/public/shell-attention-inbox.css +72 -0
  66. package/public/shell-attention-inbox.mjs +198 -0
  67. package/public/shell-context-actions.css +61 -0
  68. package/public/shell-context-actions.mjs +168 -0
  69. package/public/shell-inspector-resize.mjs +124 -0
  70. package/public/shell-navigation-resize.mjs +107 -0
  71. package/public/shell-navigation.mjs +127 -0
  72. package/public/shell-preferences.mjs +108 -0
  73. package/public/shell-surfaces.mjs +99 -0
  74. package/public/shell-tools-launcher.css +97 -0
  75. package/public/shell-tools-launcher.mjs +222 -0
  76. package/public/shell-view-host.mjs +115 -0
  77. package/public/shell-workspace.css +266 -0
  78. package/public/shell-workspace.mjs +402 -0
  79. package/public/sidebar-update-menu.css +190 -0
  80. package/public/sidebar-update-menu.mjs +512 -0
  81. package/public/styles.css +320 -169
  82. package/public/subagent-launch-slot-state.mjs +2 -2
  83. package/public/themed-selects.css +156 -0
  84. package/public/workspace-choices.mjs +104 -0
  85. package/tests/activity-agents-controller.test.mjs +652 -0
  86. package/tests/activity-events-controller.test.mjs +511 -0
  87. package/tests/app-runner-terminal-static.test.mjs +3 -3
  88. package/tests/append-system-http.test.mjs +7 -6
  89. package/tests/append-system-selector-static.test.mjs +6 -6
  90. package/tests/aur-review-widget-static.test.mjs +11 -3
  91. package/tests/boot-failure-diagnostics.test.mjs +8 -3
  92. package/tests/browser/activity-intercom-controller.spec.mjs +457 -0
  93. package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
  94. package/tests/browser/activity-owner-integration.spec.mjs +201 -0
  95. package/tests/browser/activity-queue-controller.spec.mjs +405 -0
  96. package/tests/browser/activity-section-picker.spec.mjs +294 -0
  97. package/tests/browser/activity-todo-view.spec.mjs +60 -0
  98. package/tests/browser/activity-usage-controller.spec.mjs +416 -0
  99. package/tests/browser/compact-layout-integration.spec.mjs +58 -0
  100. package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
  101. package/tests/browser/composer-disclosure.spec.mjs +389 -0
  102. package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
  103. package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
  104. package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
  105. package/tests/browser/control-visibility.spec.mjs +5 -0
  106. package/tests/browser/controls-layout.spec.mjs +21 -2
  107. package/tests/browser/conversation-overview.spec.mjs +251 -0
  108. package/tests/browser/draft-conversations.spec.mjs +276 -0
  109. package/tests/browser/empty-startup-fixture.mjs +135 -0
  110. package/tests/browser/empty-startup.spec.mjs +282 -0
  111. package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
  112. package/tests/browser/focused-composer-more.spec.mjs +127 -0
  113. package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
  114. package/tests/browser/focused-navigation-fixture.mjs +32 -0
  115. package/tests/browser/focused-project-activity.spec.mjs +111 -0
  116. package/tests/browser/focused-shell-integration.spec.mjs +208 -0
  117. package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
  118. package/tests/browser/folder-picker-layout.spec.mjs +302 -0
  119. package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
  120. package/tests/browser/git-setup-cancel.spec.mjs +251 -0
  121. package/tests/browser/guided-git-fallback.spec.mjs +40 -21
  122. package/tests/browser/inspector-header.spec.mjs +221 -0
  123. package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
  124. package/tests/browser/inspector-resize.spec.mjs +227 -0
  125. package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
  126. package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
  127. package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
  128. package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
  129. package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
  130. package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
  131. package/tests/browser/interaction-continuity.spec.mjs +50 -26
  132. package/tests/browser/interaction-model-picker.spec.mjs +86 -0
  133. package/tests/browser/last-terminal-close.spec.mjs +280 -0
  134. package/tests/browser/mobile-foundation.spec.mjs +172 -20
  135. package/tests/browser/model-catalog-groups.spec.mjs +104 -0
  136. package/tests/browser/more-row-menus.spec.mjs +258 -0
  137. package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
  138. package/tests/browser/no-project-conversation.spec.mjs +113 -0
  139. package/tests/browser/optimistic-prompt.spec.mjs +3 -0
  140. package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
  141. package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
  142. package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
  143. package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
  144. package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
  145. package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
  146. package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
  147. package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
  148. package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
  149. package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
  150. package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
  151. package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
  152. package/tests/browser/project-artifact-controller.spec.mjs +324 -0
  153. package/tests/browser/project-artifact-integration.spec.mjs +103 -0
  154. package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
  155. package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
  156. package/tests/browser/session-fixture.mjs +118 -0
  157. package/tests/browser/session-ownership.spec.mjs +175 -0
  158. package/tests/browser/session-shelves-integration.spec.mjs +219 -0
  159. package/tests/browser/session-shelves.spec.mjs +340 -0
  160. package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
  161. package/tests/browser/session-summary.spec.mjs +17 -12
  162. package/tests/browser/settings-complete-home.spec.mjs +463 -0
  163. package/tests/browser/settings-entrypoint.spec.mjs +104 -0
  164. package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
  165. package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
  166. package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
  167. package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
  168. package/tests/browser/shell-ownership.spec.mjs +398 -0
  169. package/tests/browser/shell-rollout-fixture.mjs +259 -0
  170. package/tests/browser/shell-rollout.spec.mjs +357 -0
  171. package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
  172. package/tests/browser/shell-workspace.spec.mjs +433 -0
  173. package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
  174. package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
  175. package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
  176. package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
  177. package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
  178. package/tests/browser/stream-output-isolation.spec.mjs +6 -3
  179. package/tests/browser/themed-selects.spec.mjs +297 -0
  180. package/tests/browser/thread-start-flow.spec.mjs +481 -0
  181. package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
  182. package/tests/browser/ui-polish-features.spec.mjs +85 -0
  183. package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
  184. package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
  185. package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
  186. package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
  187. package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
  188. package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
  189. package/tests/browser/windows-drive-parent.spec.mjs +4 -2
  190. package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
  191. package/tests/codex-fast-mode-static.test.mjs +16 -11
  192. package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
  193. package/tests/codex-usage-source.test.mjs +4 -3
  194. package/tests/component-update-api-static.test.mjs +2 -2
  195. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  196. package/tests/control-deck-component-updates-static.test.mjs +9 -4
  197. package/tests/control-visibility-static.test.mjs +3 -3
  198. package/tests/controls-layout-static.test.mjs +5 -5
  199. package/tests/conversation-overview-adapter.test.mjs +100 -0
  200. package/tests/document-artifact-static.test.mjs +2 -1
  201. package/tests/draft-conversations.test.mjs +205 -0
  202. package/tests/empty-startup-launcher.test.mjs +197 -0
  203. package/tests/events-tree-context-menu-static.test.mjs +22 -18
  204. package/tests/fake-pi-session-ownership.test.mjs +302 -0
  205. package/tests/fast-mode-client-static.test.mjs +1 -1
  206. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  207. package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
  208. package/tests/file-viewer-image-static.test.mjs +15 -11
  209. package/tests/file-viewer-search-static.test.mjs +5 -5
  210. package/tests/fixtures/fake-pi.mjs +41 -9
  211. package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
  212. package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
  213. package/tests/git-footer-context-menu-static.test.mjs +1 -1
  214. package/tests/git-panel-file-preview-static.test.mjs +41 -48
  215. package/tests/git-panel-live-updates-static.test.mjs +2 -1
  216. package/tests/git-workflow-dispatch.test.mjs +66 -0
  217. package/tests/git-workflow-preferences.test.mjs +9 -1
  218. package/tests/guided-git-activation-static.test.mjs +14 -11
  219. package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
  220. package/tests/guided-git-message-reliability-static.test.mjs +10 -6
  221. package/tests/guided-git-publication-backend-static.test.mjs +16 -11
  222. package/tests/http-endpoints-harness.test.mjs +21 -9
  223. package/tests/interaction-state-stability-static.test.mjs +4 -3
  224. package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
  225. package/tests/intercom-tag-layout-static.test.mjs +13 -12
  226. package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
  227. package/tests/main-output-loading-static.test.mjs +4 -4
  228. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  229. package/tests/mobile-compact-layout.test.mjs +2 -2
  230. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  231. package/tests/mobile-foundation-static.test.mjs +10 -7
  232. package/tests/mobile-phone-experience-static.test.mjs +3 -2
  233. package/tests/mobile-static.test.mjs +173 -135
  234. package/tests/model-catalog-order.test.mjs +103 -0
  235. package/tests/native-parity.test.mjs +6 -4
  236. package/tests/native-session-choice-owner.test.mjs +102 -0
  237. package/tests/native-update-lifecycle.test.mjs +10 -5
  238. package/tests/no-project-http-harness.test.mjs +328 -0
  239. package/tests/no-project-navigation.test.mjs +54 -0
  240. package/tests/no-project-workspaces.test.mjs +77 -0
  241. package/tests/open-issue-wizard-static.test.mjs +1 -1
  242. package/tests/optional-feature-migration-frontend.test.mjs +4 -4
  243. package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
  244. package/tests/package-updates.test.mjs +630 -0
  245. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  246. package/tests/platform-event-stream.test.mjs +253 -0
  247. package/tests/project-file-viewer-controller.test.mjs +652 -0
  248. package/tests/project-git-tools-adapter.test.mjs +103 -0
  249. package/tests/project-git-tools-controller.test.mjs +577 -0
  250. package/tests/project-runners-controller.test.mjs +453 -0
  251. package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
  252. package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
  253. package/tests/questionnaire-dialog.test.mjs +6 -6
  254. package/tests/queue-edit-reorder-static.test.mjs +48 -51
  255. package/tests/rpc-supervisor-host.test.mjs +4 -1
  256. package/tests/safety-guard-auto-review-static.test.mjs +1 -1
  257. package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
  258. package/tests/server-app-runners.test.mjs +536 -0
  259. package/tests/server-codex-fast-mode.test.mjs +346 -0
  260. package/tests/server-conversation-mode.test.mjs +386 -0
  261. package/tests/server-conversation-voice.test.mjs +426 -0
  262. package/tests/server-extension-ui-requests.test.mjs +357 -0
  263. package/tests/server-git-generation.test.mjs +558 -0
  264. package/tests/server-git-mutations.test.mjs +729 -0
  265. package/tests/server-git-reads.test.mjs +381 -0
  266. package/tests/server-git-worktree-sessions.test.mjs +502 -0
  267. package/tests/server-helper-requests.test.mjs +364 -0
  268. package/tests/server-rpc-transports.test.mjs +553 -0
  269. package/tests/server-settings-store.test.mjs +132 -0
  270. package/tests/server-shell-rollout.test.mjs +478 -0
  271. package/tests/server-sse-delivery.test.mjs +410 -0
  272. package/tests/server-workspace-files.test.mjs +546 -0
  273. package/tests/session-attention-scheduler.test.mjs +514 -0
  274. package/tests/session-composer-store.test.mjs +153 -0
  275. package/tests/session-context.test.mjs +134 -0
  276. package/tests/session-extension-requests.test.mjs +193 -0
  277. package/tests/session-ownership-adapter.test.mjs +130 -0
  278. package/tests/session-sampling-ui-static.test.mjs +10 -4
  279. package/tests/session-send-lifetime.test.mjs +140 -0
  280. package/tests/session-shelf-state.test.mjs +348 -0
  281. package/tests/session-shelves-adapter.test.mjs +79 -0
  282. package/tests/session-summary-lifetime.test.mjs +54 -0
  283. package/tests/settings-resource-controller.test.mjs +548 -0
  284. package/tests/shell-action-adapter.test.mjs +169 -0
  285. package/tests/shell-actions.test.mjs +182 -0
  286. package/tests/shell-navigation.test.mjs +348 -0
  287. package/tests/shell-preferences.test.mjs +367 -0
  288. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  289. package/tests/stream-output-isolation-static.test.mjs +1 -1
  290. package/tests/subagent-gate-visibility.test.mjs +1 -1
  291. package/tests/subagent-launch-slot-state.test.mjs +2 -2
  292. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  293. package/tests/subagent-observability-static.test.mjs +2 -2
  294. package/tests/subagent-reliability-integration.test.mjs +13 -30
  295. package/tests/syntax-highlighting-static.test.mjs +3 -3
  296. package/tests/tab-close-continuity-static.test.mjs +1 -1
  297. package/tests/tab-metadata-ordering.test.mjs +99 -0
  298. package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
  299. package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
  300. package/tests/terminal-tab-workspace-static.test.mjs +5 -4
  301. package/tests/terminal-tabs-resize-static.test.mjs +1 -1
  302. package/tests/theme-customizer-static.test.mjs +1 -1
  303. package/tests/thread-display-title.test.mjs +44 -0
  304. package/tests/update-api-harness.test.mjs +15 -14
  305. package/tests/update-tab-restore-harness.test.mjs +3 -0
  306. package/tests/webui-settings-locking.test.mjs +2 -2
  307. package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
  308. package/tests/workspace-choices.test.mjs +114 -0
  309. package/tests/workspace-save-load-static.test.mjs +7 -4
@@ -0,0 +1,253 @@
1
+ import assert from "node:assert/strict";
2
+ import { test } from "node:test";
3
+ import { createSessionEventStream } from "../public/platform-event-stream.mjs";
4
+
5
+ function harness() {
6
+ let context = Object.freeze({ tabId: "tab-a", generation: 1 });
7
+ const sources = [];
8
+ const calls = [];
9
+ const createSource = (url) => {
10
+ const source = {
11
+ url,
12
+ readyState: 0,
13
+ closes: 0,
14
+ onopen: null,
15
+ onmessage: null,
16
+ onerror: null,
17
+ close() { this.closes += 1; this.readyState = 2; },
18
+ };
19
+ sources.push(source);
20
+ return source;
21
+ };
22
+ const stream = createSessionEventStream({
23
+ createSource,
24
+ isCurrent: (captured) => captured === context,
25
+ onOpen: (event, captured) => calls.push(["open", event, captured]),
26
+ onMessage: (event, captured) => calls.push(["message", event, captured]),
27
+ onError: (event, captured) => calls.push(["error", event, captured]),
28
+ });
29
+ return {
30
+ stream, sources, calls,
31
+ get context() { return context; },
32
+ activate(tabId = context.tabId) { context = Object.freeze({ tabId, generation: context.generation + 1 }); },
33
+ };
34
+ }
35
+
36
+ function callbacks(source) {
37
+ return [source.onopen, source.onmessage, source.onerror];
38
+ }
39
+
40
+ function assertReleased(source) {
41
+ assert.equal(source.closes, 1);
42
+ assert.deepEqual(callbacks(source), [null, null, null]);
43
+ }
44
+
45
+ test("constructs no resource until connect and forwards original events and context", () => {
46
+ const h = harness();
47
+ assert.equal(h.stream.source, null);
48
+ assert.equal(h.sources.length, 0);
49
+ const source = h.stream.connect("/events?tab=tab-a&mode=auto", h.context);
50
+ assert.equal(h.stream.source, source);
51
+ assert.equal(source.url, "/events?tab=tab-a&mode=auto");
52
+ const events = [Object.freeze({ type: "open" }), Object.freeze({ data: "not JSON" }), Object.freeze({ type: "error" })];
53
+ callbacks(source).forEach((callback, i) => callback(events[i]));
54
+ assert.deepEqual(h.calls.map(([type]) => type), ["open", "message", "error"]);
55
+ h.calls.forEach(([, event, context], i) => {
56
+ assert.equal(event, events[i]);
57
+ assert.equal(context, h.context);
58
+ });
59
+ assert.equal(source.closes, 0);
60
+ });
61
+
62
+ test("replacement closes the previous resource and suppresses its queued callbacks", async () => {
63
+ const h = harness();
64
+ const first = h.stream.connect("/first", h.context);
65
+ const oldCallbacks = callbacks(first);
66
+ const queued = Promise.resolve().then(() => oldCallbacks.forEach((callback) => callback({ late: true })));
67
+ const second = h.stream.connect("/second", h.context);
68
+ assert.notEqual(first, second);
69
+ assertReleased(first);
70
+ assert.equal(second.closes, 0);
71
+ await queued;
72
+ assert.deepEqual(h.calls, []);
73
+ second.onmessage({ data: "current" });
74
+ assert.equal(h.calls.length, 1);
75
+ assert.equal(h.stream.source, second);
76
+ });
77
+
78
+ test("stale connect cannot close or replace a current source", () => {
79
+ const h = harness();
80
+ const staleContext = h.context;
81
+ h.activate("tab-b");
82
+ const current = h.stream.connect("/tab-b", h.context);
83
+ assert.equal(h.stream.connect("/stale", staleContext), null);
84
+ assert.equal(h.sources.length, 1);
85
+ assert.equal(h.stream.source, current);
86
+ assert.equal(current.closes, 0);
87
+ current.onopen({ type: "open" });
88
+ assert.equal(h.calls.length, 1);
89
+ });
90
+
91
+ test("each callback rechecks context even while its source remains owned", () => {
92
+ const h = harness();
93
+ const source = h.stream.connect("/events", h.context);
94
+ h.activate();
95
+ callbacks(source).forEach((callback) => callback({ stale: true }));
96
+ assert.deepEqual(h.calls, []);
97
+ assert.equal(source.closes, 0);
98
+ assert.equal(h.stream.source, source);
99
+ });
100
+
101
+ test("close detaches handlers, invalidates captured callbacks and permits reconnect", async () => {
102
+ const h = harness();
103
+ const source = h.stream.connect("/first", h.context);
104
+ const oldCallbacks = callbacks(source);
105
+ h.stream.close();
106
+ h.stream.close();
107
+ assertReleased(source);
108
+ assert.equal(h.stream.source, null);
109
+ await Promise.resolve().then(() => oldCallbacks.forEach((callback) => callback({ late: true })));
110
+ assert.deepEqual(h.calls, []);
111
+ const replacement = h.stream.connect("/second", h.context);
112
+ assert.equal(h.stream.source, replacement);
113
+ assert.equal(h.sources.length, 2);
114
+ });
115
+
116
+ test("ownership is invalidated before source.close can deliver callbacks", () => {
117
+ const h = harness();
118
+ const source = h.stream.connect("/events", h.context);
119
+ const oldCallbacks = callbacks(source);
120
+ const close = source.close.bind(source);
121
+ source.close = () => {
122
+ oldCallbacks.forEach((callback) => callback({ duringClose: true }));
123
+ close();
124
+ };
125
+ h.stream.close();
126
+ assertReleased(source);
127
+ assert.deepEqual(h.calls, []);
128
+ });
129
+
130
+ test("dispose is terminal and suppresses queued callbacks", async () => {
131
+ const h = harness();
132
+ const source = h.stream.connect("/events", h.context);
133
+ const oldCallbacks = callbacks(source);
134
+ h.stream.dispose();
135
+ h.stream.dispose();
136
+ h.stream.close();
137
+ assertReleased(source);
138
+ await Promise.resolve().then(() => oldCallbacks.forEach((callback) => callback({ late: true })));
139
+ assert.deepEqual(h.calls, []);
140
+ assert.equal(h.stream.connect("/after-dispose", h.context), null);
141
+ assert.equal(h.stream.source, null);
142
+ assert.equal(h.sources.length, 1);
143
+ });
144
+
145
+ test("source errors forward without changing resource, retry, or parsing policy", () => {
146
+ const h = harness();
147
+ const source = h.stream.connect("/events", h.context);
148
+ const error = Object.freeze({ type: "error", message: "connection lost" });
149
+ source.onerror(error);
150
+ source.onerror(error);
151
+ source.onmessage({ data: "{malformed" });
152
+ assert.equal(h.calls.length, 3);
153
+ assert.equal(h.calls[0][1], error);
154
+ assert.equal(h.calls[1][1], error);
155
+ assert.equal(h.stream.source, source);
156
+ assert.equal(source.closes, 0);
157
+ assert.equal(h.sources.length, 1);
158
+ });
159
+
160
+ test("factory failure propagates after releasing the previous resource", () => {
161
+ const source = { close() { this.closed = true; } };
162
+ const error = new Error("source unavailable");
163
+ let attempts = 0;
164
+ const stream = createSessionEventStream({
165
+ createSource() { if (attempts++ === 0) return source; throw error; },
166
+ isCurrent: () => true,
167
+ });
168
+ stream.connect("/first", {});
169
+ assert.throws(() => stream.connect("/failure", {}), (actual) => actual === error);
170
+ assert.equal(stream.source, null);
171
+ assert.equal(source.closed, true);
172
+ });
173
+
174
+ test("construction that invalidates context or disposes releases the new source", () => {
175
+ for (const action of ["invalidate", "close", "dispose"]) {
176
+ const source = { closes: 0, close() { this.closes += 1; } };
177
+ let current = true;
178
+ const stream = createSessionEventStream({
179
+ createSource() {
180
+ if (action === "invalidate") current = false;
181
+ else stream[action]();
182
+ return source;
183
+ },
184
+ isCurrent: () => current,
185
+ });
186
+ assert.equal(stream.connect("/events", {}), null);
187
+ assert.equal(stream.source, null);
188
+ assertReleased(source);
189
+ }
190
+ });
191
+
192
+ test("reentrant replacement during construction keeps the later resource", () => {
193
+ const first = { closes: 0, close() { this.closes += 1; } };
194
+ const second = { closes: 0, close() { this.closes += 1; } };
195
+ const context = {};
196
+ const stream = createSessionEventStream({
197
+ createSource(url) {
198
+ if (url === "/first") {
199
+ stream.connect("/second", context);
200
+ return first;
201
+ }
202
+ return second;
203
+ },
204
+ isCurrent: () => true,
205
+ });
206
+ assert.equal(stream.connect("/first", context), null);
207
+ assert.equal(stream.source, second);
208
+ assertReleased(first);
209
+ assert.equal(second.closes, 0);
210
+ stream.dispose();
211
+ assertReleased(second);
212
+ });
213
+
214
+ test("source is read-only and callback failures propagate without replacing it", () => {
215
+ const error = new Error("parent callback failed");
216
+ const source = { close() {} };
217
+ const stream = createSessionEventStream({
218
+ createSource: () => source,
219
+ isCurrent: () => true,
220
+ onMessage() { throw error; },
221
+ });
222
+ stream.connect("/events", {});
223
+ assert.throws(() => { stream.source = null; }, TypeError);
224
+ assert.throws(() => source.onmessage({ data: "message" }), (actual) => actual === error);
225
+ assert.equal(stream.source, source);
226
+ });
227
+
228
+ test("invalid factories and callbacks fail before acquiring resources", () => {
229
+ assert.throws(() => createSessionEventStream(), TypeError);
230
+ for (const field of ["createSource", "isCurrent", "onOpen", "onMessage", "onError"]) {
231
+ assert.throws(() => createSessionEventStream({ createSource() {}, isCurrent() {}, [field]: null }), TypeError);
232
+ }
233
+ });
234
+
235
+ test("omitted event callbacks are safe and disposal before connect acquires nothing", () => {
236
+ let created = 0;
237
+ const stream = createSessionEventStream({
238
+ createSource() { created += 1; return { close() {} }; },
239
+ isCurrent: () => true,
240
+ });
241
+ const source = stream.connect("/events", {});
242
+ callbacks(source).forEach((callback) => callback({ type: "ignored" }));
243
+ stream.dispose();
244
+ assert.equal(created, 1);
245
+
246
+ const neverConnected = createSessionEventStream({
247
+ createSource() { assert.fail("created after disposal"); },
248
+ isCurrent() { assert.fail("checked context after disposal"); },
249
+ });
250
+ neverConnected.dispose();
251
+ assert.equal(neverConnected.connect("/events", {}), null);
252
+ assert.equal(neverConnected.source, null);
253
+ });