@pi-chamber/web 1.0.4-rc.4 → 1.0.5-rc.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 (204) hide show
  1. package/README.md +1 -1
  2. package/bin/cli.js +21 -2
  3. package/bin/cli.test.js +164 -4
  4. package/bin/lib/DOCUMENTATION.md +3 -3
  5. package/bin/lib/cli-args.js +96 -13
  6. package/bin/lib/commands-connect-url-tailscale.test.js +136 -0
  7. package/bin/lib/commands-connect-url.js +146 -39
  8. package/bin/lib/commands-connect-url.test.js +126 -0
  9. package/bin/lib/commands-serve.js +45 -2
  10. package/bin/lib/commands-status.js +28 -5
  11. package/bin/lib/commands-status.test.js +107 -0
  12. package/bin/lib/commands-tunnel.js +36 -10
  13. package/dist/assets/{DiagramView--BGR3PRZ.js → DiagramView-D-OSWTbO.js} +1 -1
  14. package/dist/assets/DiffView-BKT-MIH4.js +18 -0
  15. package/dist/assets/{FileSaveConflictDialog-CcrWHRvd.js → FileSaveConflictDialog-DBkVFssC.js} +2 -2
  16. package/dist/assets/FilesView-B7GIuRlh.js +6 -0
  17. package/dist/assets/{GitHubDetailScaffold-BZhP67Va.js → GitHubDetailScaffold-C9rCZMUT.js} +2 -2
  18. package/dist/assets/{GitHubLinkPicker-CJZmDljp.js → GitHubLinkPicker-Bm09hvhJ.js} +1 -1
  19. package/dist/assets/{GitHubListPrimitives-DhF42guB.js → GitHubListPrimitives-DlhAlxI6.js} +1 -1
  20. package/dist/assets/{GitView-JK-QCK9R.js → GitView-BgqdMb0m.js} +4 -4
  21. package/dist/assets/{IssuesSurface-CAqQzrsv.js → IssuesSurface-BZXAvt49.js} +3 -3
  22. package/dist/assets/{JsonTreeView-CKTqB1CD.js → JsonTreeView-BKgCQjh_.js} +1 -1
  23. package/dist/assets/{MarkdownRendererImpl-B5kJy9Nt.js → MarkdownRendererImpl-BdcyMPw-.js} +1 -1
  24. package/dist/assets/{PatchDiff-BQnRFN30.js → PatchDiff-2MmWXcGe.js} +1 -1
  25. package/dist/assets/PierreDiffViewer-D1F2WvD0.js +135 -0
  26. package/dist/assets/PullRequestsSurface-CN2z3DFv.js +2 -0
  27. package/dist/assets/SessionSwitcherContent-CCljxAZb.js +1 -0
  28. package/dist/assets/SessionSwitcherDropdown-DtNt3qw4.js +2 -0
  29. package/dist/assets/SessionUnreadDot-B9bHMy5q.js +1 -0
  30. package/dist/assets/SettingsView-DaZVCInW.js +6 -0
  31. package/dist/assets/{SettingsWindow-CAxKgYOu.js → SettingsWindow-C-ydfopH.js} +1 -1
  32. package/dist/assets/StickyHorizontalScrollbar-BMITjK4e.js +8 -0
  33. package/dist/assets/{ToolOutputDialog-lz5exVQ4.js → ToolOutputDialog-DJUAx_Oj.js} +4 -4
  34. package/dist/assets/{ToolPartDiffPreview-nIUiNLpP.js → ToolPartDiffPreview-DFyuJM4c.js} +1 -1
  35. package/dist/assets/{VirtualizedFileDiff-IWqCJNXu.js → VirtualizedFileDiff-BS-af6rn.js} +4 -4
  36. package/dist/assets/{Virtualizer-Cp_cJWbI.js → Virtualizer-DP6HbEeC.js} +1 -1
  37. package/dist/assets/{collapsible-C7oyikVm.js → collapsible-BOcd0lzY.js} +1 -1
  38. package/dist/assets/{computeVirtualFileMetrics-CyhUKEfv.js → computeVirtualFileMetrics-BI6wORhM.js} +1 -1
  39. package/dist/assets/{contextFileOpenGuard-DkjmJ-NU.js → contextFileOpenGuard-DUMSGR4M.js} +1 -1
  40. package/dist/assets/{gitStatusPredicates-DBmUY3kA.js → gitStatusPredicates-FdKYDZe3.js} +1 -1
  41. package/dist/assets/{githubLink-BdbPMMAK.js → githubLink-B3-BaGpb.js} +5 -5
  42. package/dist/assets/index-DWSrsQWl.js +11 -0
  43. package/dist/assets/{index-CKgYIOis.js → index-Df-vmvzu.js} +1 -1
  44. package/dist/assets/index-DsQIBAWK.css +1 -0
  45. package/dist/assets/main-61_cd7S7.js +2 -0
  46. package/dist/assets/main-q43jqZ2I.js +136 -0
  47. package/dist/assets/{markdownCore-D7V46WY9.js → markdownCore-CqHYlXi_.js} +2 -2
  48. package/dist/assets/{miniChat-PanPmbEK.js → miniChat-vOuWN5pV.js} +2 -2
  49. package/dist/assets/mobile-mrXWV5ky.js +2 -0
  50. package/dist/assets/{nativeFileSave-BzhtrDoD.js → nativeFileSave-CFuugNKV.js} +1 -1
  51. package/dist/assets/pi-session-focus-preference-BEufpwC6.js +9 -0
  52. package/dist/assets/{renderDiffWithHighlighter-ByZtK9za.js → renderDiffWithHighlighter-BD9CAhZU.js} +1 -1
  53. package/dist/assets/renderElectronMiniChatApp-QQFXkY5Y.js +2 -0
  54. package/dist/assets/{renderFileWithHighlighter-CnN0Tv_8.js → renderFileWithHighlighter-KiEWMtzI.js} +1 -1
  55. package/dist/assets/renderMobileApp-DIZYvrhi.js +11 -0
  56. package/dist/assets/runtimeEndpointReset-BA2uP2rj.js +62 -0
  57. package/dist/assets/{runtimeSurface-DBiUWYK2.js → runtimeSurface-Der4qUnI.js} +1 -1
  58. package/dist/assets/useAppFontEffects-Bfw_d5eB.js +212 -0
  59. package/dist/assets/{useFilesViewSearch-BWABG6pS.js → useFilesViewSearch-Budwejnx.js} +3 -3
  60. package/dist/assets/useGitHubRemoteSearch-gUdylYy3.js +1 -0
  61. package/dist/assets/{useSwitcherItems-BSTSev5C.js → useSwitcherItems-yHSMduoo.js} +1 -1
  62. package/dist/assets/{vendor-aparajita-capacitor-secure-storage-BYohCVY0.js → vendor-aparajita-capacitor-secure-storage-BDrMx_CE.js} +1 -1
  63. package/dist/assets/{vendor-base-ui-BscvGUFt.js → vendor-base-ui-CKRUCG-f.js} +1 -1
  64. package/dist/assets/{vendor-boot-Dgb9NVFe.js → vendor-boot-EC6IyLt1.js} +13 -13
  65. package/dist/assets/{vendor-capacitor-app-BjdQVib9.js → vendor-capacitor-app-BaupizkW.js} +1 -1
  66. package/dist/assets/{vendor-capacitor-keyboard-eTtI5go3.js → vendor-capacitor-keyboard-9BVxykO7.js} +1 -1
  67. package/dist/assets/{vendor-capacitor-status-bar-9rNIGxlO.js → vendor-capacitor-status-bar-BsrUwiaA.js} +1 -1
  68. package/dist/assets/{vendor-codemirror-autocomplete-DxS3jwvE.js → vendor-codemirror-autocomplete-CGpAsPWp.js} +1 -1
  69. package/dist/assets/{vendor-codemirror-lang-angular-DdjXl9e2.js → vendor-codemirror-lang-angular-CDJoHJSY.js} +1 -1
  70. package/dist/assets/{vendor-codemirror-lang-cpp--aMr7NVt.js → vendor-codemirror-lang-cpp-BmHofQls.js} +1 -1
  71. package/dist/assets/{vendor-codemirror-lang-css-CZ_qxZY9.js → vendor-codemirror-lang-css-RM2HqXZ0.js} +1 -1
  72. package/dist/assets/{vendor-codemirror-lang-go-Ca-y2Alu.js → vendor-codemirror-lang-go-Crwca_X7.js} +1 -1
  73. package/dist/assets/{vendor-codemirror-lang-html-COZ0L5wT.js → vendor-codemirror-lang-html-CHSHUpwq.js} +1 -1
  74. package/dist/assets/{vendor-codemirror-lang-java-D3Rf3QNJ.js → vendor-codemirror-lang-java-lhQXgWu0.js} +1 -1
  75. package/dist/assets/{vendor-codemirror-lang-javascript-DwJ-IvCs.js → vendor-codemirror-lang-javascript-Dw4kFO4e.js} +1 -1
  76. package/dist/assets/{vendor-codemirror-lang-jinja-D_5lod6k.js → vendor-codemirror-lang-jinja-_pAC3UTN.js} +1 -1
  77. package/dist/assets/{vendor-codemirror-lang-json-BG8C7OpC.js → vendor-codemirror-lang-json-B-b1vAv-.js} +1 -1
  78. package/dist/assets/{vendor-codemirror-lang-less-CVEkoaTw.js → vendor-codemirror-lang-less-xIgOi1ze.js} +1 -1
  79. package/dist/assets/{vendor-codemirror-lang-liquid-U9vj0m8w.js → vendor-codemirror-lang-liquid-CP49m5dB.js} +1 -1
  80. package/dist/assets/{vendor-codemirror-lang-markdown-DqlYH9gY.js → vendor-codemirror-lang-markdown-BTht2ATe.js} +1 -1
  81. package/dist/assets/{vendor-codemirror-lang-php-BFEiEVA1.js → vendor-codemirror-lang-php-BguZDhaO.js} +1 -1
  82. package/dist/assets/{vendor-codemirror-lang-python-Cz1dQXQd.js → vendor-codemirror-lang-python-CH6_em9L.js} +1 -1
  83. package/dist/assets/{vendor-codemirror-lang-rust-C_CoD9mj.js → vendor-codemirror-lang-rust-EG_DtGyi.js} +1 -1
  84. package/dist/assets/{vendor-codemirror-lang-sass-BuR0aKh5.js → vendor-codemirror-lang-sass-BknY5Qpo.js} +1 -1
  85. package/dist/assets/{vendor-codemirror-lang-sql-DggNUjdM.js → vendor-codemirror-lang-sql-B0f-qCZo.js} +1 -1
  86. package/dist/assets/{vendor-codemirror-lang-vue-DFZHi2J3.js → vendor-codemirror-lang-vue-CyGn9snv.js} +1 -1
  87. package/dist/assets/{vendor-codemirror-lang-wast-zuTN3SHT.js → vendor-codemirror-lang-wast-CsFfSyyB.js} +1 -1
  88. package/dist/assets/{vendor-codemirror-lang-xml-CrcvhI-k.js → vendor-codemirror-lang-xml-Cdan_Jp1.js} +1 -1
  89. package/dist/assets/{vendor-codemirror-lang-yaml-DcVWsakb.js → vendor-codemirror-lang-yaml-COI5hck8.js} +1 -1
  90. package/dist/assets/{vendor-codemirror-language-data-CCLITgCF.js → vendor-codemirror-language-data-CqU7kHmg.js} +2 -2
  91. package/dist/assets/{vendor-codemirror-search-H7NOEdbX.js → vendor-codemirror-search-DUfSCF9S.js} +1 -1
  92. package/dist/assets/{vendor-lezer-cpp-C8aD2KAr.js → vendor-lezer-cpp-DMZOJzBa.js} +1 -1
  93. package/dist/assets/{vendor-lezer-css-2lbTJF-Y.js → vendor-lezer-css-DUkkbMp7.js} +1 -1
  94. package/dist/assets/{vendor-lezer-go-Bw6LFTrZ.js → vendor-lezer-go-CHIhCNY6.js} +1 -1
  95. package/dist/assets/{vendor-lezer-html-D7ym2z7S.js → vendor-lezer-html-B3h0MOrG.js} +1 -1
  96. package/dist/assets/{vendor-lezer-java-CZhK7w21.js → vendor-lezer-java-tMazV_6X.js} +1 -1
  97. package/dist/assets/{vendor-lezer-javascript-rpKeTHZp.js → vendor-lezer-javascript-ctwLWf4v.js} +1 -1
  98. package/dist/assets/{vendor-lezer-json-C7jwsd2G.js → vendor-lezer-json-BP_UAzLL.js} +1 -1
  99. package/dist/assets/{vendor-lezer-lr-DR-ylqNN.js → vendor-lezer-lr-B8TQctNw.js} +1 -1
  100. package/dist/assets/{vendor-lezer-markdown-Bir0m5nB.js → vendor-lezer-markdown-aGLZf_3h.js} +1 -1
  101. package/dist/assets/{vendor-lezer-php-y0hIEfo1.js → vendor-lezer-php-D5zCNzlt.js} +1 -1
  102. package/dist/assets/{vendor-lezer-python-D64A9lNV.js → vendor-lezer-python-EJ4Im4y2.js} +1 -1
  103. package/dist/assets/{vendor-lezer-rust-E3ZA9T2L.js → vendor-lezer-rust-DO5c7OtA.js} +1 -1
  104. package/dist/assets/{vendor-lezer-sass-C5UFI9SP.js → vendor-lezer-sass-CMi6zfXI.js} +1 -1
  105. package/dist/assets/{vendor-lezer-xml-DOy7FzCR.js → vendor-lezer-xml-0MHMeZDp.js} +1 -1
  106. package/dist/assets/{vendor-lezer-yaml-kEjaSCvZ.js → vendor-lezer-yaml-BE2EFjpA.js} +1 -1
  107. package/dist/assets/{vendor-replit-codemirror-vim-BLfh0LPy.js → vendor-replit-codemirror-vim-AnOuN8yJ.js} +1 -1
  108. package/dist/assets/{web-components-CdMfsnXE.js → web-components-CeHLxvED.js} +3 -3
  109. package/dist/index.html +4 -4
  110. package/dist/mini-chat.html +3 -3
  111. package/dist/mobile.html +3 -3
  112. package/dist/sw.js +1 -1
  113. package/package.json +1 -2
  114. package/server/index.js +69 -30
  115. package/server/lib/client-auth/DOCUMENTATION.md +15 -1
  116. package/server/lib/client-auth/pairing.js +2 -12
  117. package/server/lib/client-auth/remote-clients.js +2 -12
  118. package/server/lib/cloudflare-tunnel.js +0 -132
  119. package/server/lib/fs/DOCUMENTATION.md +8 -0
  120. package/server/lib/fs/atomic-write.js +111 -0
  121. package/server/lib/fs/atomic-write.test.js +133 -0
  122. package/server/lib/notifications/DOCUMENTATION.md +43 -32
  123. package/server/lib/notifications/pi-notification-watcher.js +8 -7
  124. package/server/lib/notifications/pi-notification-watcher.test.js +88 -2
  125. package/server/lib/pi/routes-extension-events.test.js +231 -0
  126. package/server/lib/pi/routes.js +137 -4
  127. package/server/lib/pi/routes.test.js +248 -2
  128. package/server/lib/pi/session-daemon/DOCUMENTATION.md +17 -4
  129. package/server/lib/pi/session-daemon/daemon-process.js +2 -0
  130. package/server/lib/pi/session-daemon/engines/index.js +6 -0
  131. package/server/lib/pi/session-daemon/extension-bridge-draft.test.js +1 -1
  132. package/server/lib/pi/session-daemon/extension-bridge.js +24 -0
  133. package/server/lib/pi/session-daemon/extension-message-render.js +74 -0
  134. package/server/lib/pi/session-daemon/extension-message-render.test.js +164 -0
  135. package/server/lib/pi/session-daemon/extension-tool-render.js +13 -6
  136. package/server/lib/pi/session-daemon/pending-input.js +188 -0
  137. package/server/lib/pi/session-daemon/pending-input.test.js +202 -0
  138. package/server/lib/pi/session-daemon/session-daemon-engines.test.js +828 -0
  139. package/server/lib/pi/session-daemon/session-daemon-extensions.test.js +296 -6
  140. package/server/lib/pi/session-daemon/session-daemon-turn.e2e.test.js +9 -0
  141. package/server/lib/pi/session-daemon/session-daemon.js +219 -19
  142. package/server/lib/pi/session-daemon/session-daemon.test.js +30 -2
  143. package/server/lib/pi/session-daemon/session-engine-router.js +390 -0
  144. package/server/lib/pi/session-daemon/session-engine-router.test.js +515 -0
  145. package/server/lib/pi/session-daemon/session-engines.js +467 -0
  146. package/server/lib/pi/session-daemon/session-engines.test.js +383 -0
  147. package/server/lib/pi/snippets-store.js +8 -17
  148. package/server/lib/pi/ui-settings-store.js +6 -10
  149. package/server/lib/pi/ui-settings-store.test.js +37 -1
  150. package/server/lib/relay/DOCUMENTATION.md +6 -4
  151. package/server/lib/relay/identity-store.js +116 -0
  152. package/server/lib/relay/identity-store.test.js +169 -0
  153. package/server/lib/relay/identity.js +6 -4
  154. package/server/lib/relay/server-id.js +63 -0
  155. package/server/lib/relay/server-id.test.js +132 -0
  156. package/server/lib/relay/signing-key.js +14 -11
  157. package/server/lib/security/bind-host.js +6 -2
  158. package/server/lib/security/bind-host.test.js +17 -0
  159. package/server/lib/server/core-routes.js +27 -1
  160. package/server/lib/server/lan-addresses.js +18 -6
  161. package/server/lib/server/lan-addresses.test.js +28 -0
  162. package/server/lib/server/tunnel-auth.js +47 -7
  163. package/server/lib/server/tunnel-auth.rate-limit.test.js +164 -0
  164. package/server/lib/server/tunnel-service.DOCUMENTATION.md +3 -4
  165. package/server/lib/server/tunnel-service.js +23 -20
  166. package/server/lib/server/tunnel-service.test.js +19 -2
  167. package/server/lib/stt/config-store.js +5 -15
  168. package/server/lib/tailscale/DOCUMENTATION.md +264 -0
  169. package/server/lib/tailscale/routes.js +45 -0
  170. package/server/lib/tailscale/service.js +959 -0
  171. package/server/lib/tailscale/tailscale.js +302 -0
  172. package/server/lib/tailscale/tailscale.test.js +1861 -0
  173. package/server/lib/tunnels/DOCUMENTATION.md +3 -4
  174. package/server/lib/tunnels/providers/cloudflare.js +1 -22
  175. package/server/lib/tunnels/types.js +0 -2
  176. package/server/lib/ui-auth/DOCUMENTATION.md +31 -0
  177. package/server/lib/ui-auth/ui-auth.js +80 -6
  178. package/server/lib/ui-auth/ui-auth.test.js +136 -0
  179. package/server/lib/ui-auth/ui-passkeys.js +2 -13
  180. package/server/lib/update-job-store.js +4 -6
  181. package/dist/assets/DiffView-hz90_htv.js +0 -18
  182. package/dist/assets/FilesView-DaqkPMqx.js +0 -6
  183. package/dist/assets/PierreDiffViewer-BeGpdI0x.js +0 -134
  184. package/dist/assets/PullRequestsSurface-D9beq2x9.js +0 -2
  185. package/dist/assets/SessionSwitcherContent-DElQ_cjm.js +0 -1
  186. package/dist/assets/SessionSwitcherDropdown-JaIDcDIj.js +0 -2
  187. package/dist/assets/SessionUnreadDot-Czfvjbdi.js +0 -1
  188. package/dist/assets/SettingsView-C_GC1Mx3.js +0 -6
  189. package/dist/assets/index-BnZVqcki.js +0 -11
  190. package/dist/assets/index-BnieExes.css +0 -1
  191. package/dist/assets/main-6YKi4QM2.js +0 -2
  192. package/dist/assets/main-CWdWdhdL.js +0 -136
  193. package/dist/assets/mobile-0LY-2fxw.js +0 -2
  194. package/dist/assets/pi-session-focus-preference-BC-ze1oC.js +0 -10
  195. package/dist/assets/renderElectronMiniChatApp-DETQLjFi.js +0 -2
  196. package/dist/assets/renderMobileApp-DS0FDQLg.js +0 -11
  197. package/dist/assets/runtimeEndpointReset-BqqXMwE9.js +0 -62
  198. package/dist/assets/useAppFontEffects-BisjofNZ.js +0 -212
  199. package/dist/assets/useGitHubRemoteSearch-Bsf2YeQP.js +0 -1
  200. package/dist/assets/vendor-capacitor-push-notifications-CBKq2Arn.js +0 -1
  201. package/server/lib/notifications/delivery-runtime.js +0 -314
  202. package/server/lib/notifications/delivery-runtime.test.js +0 -85
  203. package/server/lib/notifications/routes.js +0 -74
  204. package/server/lib/relay/service.js +0 -9
@@ -0,0 +1,302 @@
1
+ /**
2
+ * Tailscale remote-access helpers (pure, dependency-free).
3
+ *
4
+ * `tailscale serve --bg --https=<port> http://127.0.0.1:<localPort>` publishes
5
+ * a local port at `https://<machine>.<tailnet>.ts.net[:port]` reachable only
6
+ * by devices in the user's tailnet. `tailscale funnel` is identical but
7
+ * reachable from the public internet. Funnel only allows HTTPS ports 443,
8
+ * 8443 and 10000.
9
+ *
10
+ * This module owns parsing, validation, conflict detection and the security
11
+ * gate. Process spawning, persistence and lifecycle live in `service.js` so
12
+ * they can be tested with an injected fake runner. Keep this file free of
13
+ * Node builtins beyond `path`/`os` string handling so it stays unit-testable.
14
+ */
15
+
16
+ const TAILSCALE_MODES = ['private', 'public'];
17
+ const TAILSCALE_HTTPS_PORTS = [443, 8443, 10000];
18
+ export const TAILSCALE_DEFAULT_MODE = 'private';
19
+ export const TAILSCALE_DEFAULT_HTTPS_PORT = 443;
20
+
21
+ // Bounded waits: serve/funnel may block on approval, status probes must not.
22
+ export const TAILSCALE_STATUS_TIMEOUT_MS = 10_000;
23
+ export const TAILSCALE_APPLY_TIMEOUT_MS = 30_000;
24
+ export const TAILSCALE_REMOVE_TIMEOUT_MS = 15_000;
25
+ export const TAILSCALE_PROBE_TIMEOUT_MS = 5_000;
26
+ export const TAILSCALE_APPROVAL_WAIT_MS = 5 * 60 * 1000;
27
+
28
+ const TAILSCALE_STATES = [
29
+ 'off',
30
+ 'unavailable',
31
+ 'blocked',
32
+ 'starting',
33
+ 'needs-approval',
34
+ 'active',
35
+ 'conflict',
36
+ 'error',
37
+ ];
38
+
39
+ const TAILSCALE_ERROR_CODES = [
40
+ 'auth_required',
41
+ 'not_installed',
42
+ 'not_running',
43
+ 'not_logged_in',
44
+ 'permission_denied',
45
+ 'needs_approval',
46
+ 'conflict',
47
+ 'apply_failed',
48
+ 'remove_failed',
49
+ 'status_query_failed',
50
+ 'probe_failed',
51
+ 'invalid_config',
52
+ 'timeout',
53
+ 'unknown',
54
+ ];
55
+
56
+ const DEFAULT_TAILSCALE_CONFIG = Object.freeze({
57
+ enabled: false,
58
+ mode: TAILSCALE_DEFAULT_MODE,
59
+ httpsPort: TAILSCALE_DEFAULT_HTTPS_PORT,
60
+ });
61
+
62
+ export const validateTailscaleConfig = (input) => {
63
+ const errors = [];
64
+ if (!input || typeof input !== 'object' || Array.isArray(input)) {
65
+ return { ok: false, errors: ['Config must be an object'] };
66
+ }
67
+ if (Object.hasOwn(input, 'enabled') && typeof input.enabled !== 'boolean') {
68
+ errors.push('enabled must be a boolean');
69
+ }
70
+ if (Object.hasOwn(input, 'mode') && !TAILSCALE_MODES.includes(input.mode)) {
71
+ errors.push(`mode must be one of: ${TAILSCALE_MODES.join(', ')}`);
72
+ }
73
+ if (
74
+ Object.hasOwn(input, 'httpsPort')
75
+ && !(Number.isInteger(input.httpsPort) && TAILSCALE_HTTPS_PORTS.includes(input.httpsPort))
76
+ ) {
77
+ errors.push(`httpsPort must be one of: ${TAILSCALE_HTTPS_PORTS.join(', ')}`);
78
+ }
79
+ return errors.length === 0 ? { ok: true, errors } : { ok: false, errors };
80
+ };
81
+
82
+ export const normalizeTailscaleConfig = (input) => ({
83
+ enabled: typeof input?.enabled === 'boolean' ? input.enabled : DEFAULT_TAILSCALE_CONFIG.enabled,
84
+ mode: TAILSCALE_MODES.includes(input?.mode) ? input.mode : DEFAULT_TAILSCALE_CONFIG.mode,
85
+ httpsPort:
86
+ Number.isInteger(input?.httpsPort) && TAILSCALE_HTTPS_PORTS.includes(input.httpsPort)
87
+ ? input.httpsPort
88
+ : DEFAULT_TAILSCALE_CONFIG.httpsPort,
89
+ });
90
+
91
+ /**
92
+ * Security gate (core-enforced, not just UI): Tailscale proxies to loopback,
93
+ * which bypasses the "refuse a network-exposed bind without a UI password"
94
+ * rule. Enabling Tailscale therefore requires UI auth (a UI password).
95
+ * `private` mode honors the same `PICHAMBER_ALLOW_UNAUTHENTICATED_LAN`
96
+ * escape hatch as a LAN bind; `public` mode has no escape hatch.
97
+ */
98
+ export const checkTailscaleAuthGate = ({ enabled, mode, uiPasswordConfigured, unsafeUnauthenticatedLanAllowed }) => {
99
+ if (enabled !== true) return { allowed: true };
100
+ if (uiPasswordConfigured === true) return { allowed: true };
101
+ if (mode === 'private' && unsafeUnauthenticatedLanAllowed === true) return { allowed: true };
102
+ return {
103
+ allowed: false,
104
+ code: 'auth_required',
105
+ message:
106
+ mode === 'public'
107
+ ? 'Tailscale public (Funnel) access requires a UI password. Set --ui-password or PICHAMBER_UI_PASSWORD.'
108
+ : 'Tailscale private access requires a UI password. Set --ui-password or PICHAMBER_UI_PASSWORD, '
109
+ + 'or set PICHAMBER_ALLOW_UNAUTHENTICATED_LAN=true to accept the risk.',
110
+ };
111
+ };
112
+
113
+ export const tailscaleCommandForPlatform = (platform) =>
114
+ platform === 'win32' ? 'tailscale.exe' : 'tailscale';
115
+
116
+ /**
117
+ * Resolve the executable: the macOS/Windows well-known install location when
118
+ * `existsSync` reports it present (GUI installs often leave no CLI on PATH,
119
+ * and Electron launched from Finder has a minimal PATH), otherwise the PATH
120
+ * command. Returns `{ command, source, fallback? }`. Uses argument arrays
121
+ * (no shell) at the call site.
122
+ */
123
+ export const resolveTailscaleExecutable = ({ platform = process.platform, env = process.env, existsSync = null } = {}) => {
124
+ const command = tailscaleCommandForPlatform(platform);
125
+ if (platform === 'darwin') {
126
+ const macOsBundle = '/Applications/Tailscale.app/Contents/MacOS/Tailscale';
127
+ if (typeof existsSync === 'function') {
128
+ try {
129
+ if (existsSync(macOsBundle)) return { command: macOsBundle, source: 'bundle' };
130
+ } catch {
131
+ // Fall through to PATH lookup.
132
+ }
133
+ }
134
+ return { command, source: 'path', fallback: macOsBundle };
135
+ }
136
+ if (platform === 'win32') {
137
+ const programFiles = env?.ProgramFiles || env?.PROGRAMFILES || 'C:\\Program Files';
138
+ const installed = `${programFiles}\\Tailscale\\tailscale.exe`;
139
+ if (typeof existsSync === 'function') {
140
+ try {
141
+ if (existsSync(installed)) return { command: installed, source: 'installed' };
142
+ } catch {
143
+ // Fall through to PATH lookup.
144
+ }
145
+ }
146
+ return { command, source: 'path', fallback: installed };
147
+ }
148
+ return { command, source: 'path' };
149
+ };
150
+
151
+ export const buildTailscaleServeArgs = ({ mode, httpsPort, localPort }) => {
152
+ const subcommand = mode === 'public' ? 'funnel' : 'serve';
153
+ return [subcommand, '--bg', `--https=${httpsPort}`, `http://127.0.0.1:${localPort}`];
154
+ };
155
+
156
+ export const buildTailscaleRemoveArgs = ({ mode, httpsPort }) => {
157
+ const subcommand = mode === 'public' ? 'funnel' : 'serve';
158
+ return [subcommand, `--https=${httpsPort}`, 'off'];
159
+ };
160
+
161
+ export const buildTailscaleUrl = ({ magicDnsName, httpsPort }) => {
162
+ if (!magicDnsName) return null;
163
+ const portSuffix = httpsPort === 443 ? '' : `:${httpsPort}`;
164
+ return `https://${magicDnsName}${portSuffix}`;
165
+ };
166
+
167
+ /**
168
+ * `tailscale status --json` → `{ loggedIn, magicDnsName }`. Self.DNSName has a
169
+ * trailing dot; `BackendState: "Running"` means the daemon is up. A missing or
170
+ * empty Self means logged out. Never throws: malformed JSON reports logged out
171
+ * with a null name so callers surface `not_logged_in` instead of crashing.
172
+ */
173
+ export const parseTailscaleStatus = (rawJson) => {
174
+ let parsed = null;
175
+ try {
176
+ parsed = JSON.parse(String(rawJson ?? ''));
177
+ } catch {
178
+ return { running: false, loggedIn: false, magicDnsName: null, httpsCertsAvailable: null };
179
+ }
180
+ if (!parsed || typeof parsed !== 'object') {
181
+ return { running: false, loggedIn: false, magicDnsName: null, httpsCertsAvailable: null };
182
+ }
183
+ const running = parsed.BackendState === 'Running';
184
+ const self = parsed.Self && typeof parsed.Self === 'object' ? parsed.Self : null;
185
+ const rawDns = typeof self?.DNSName === 'string' ? self.DNSName.trim().replace(/\.$/, '') : '';
186
+ const magicDnsName = rawDns ? rawDns : null;
187
+ const loggedIn = Boolean(self) && magicDnsName !== null;
188
+ // `CertDomains` (when present) lists the DNS names with provisioned HTTPS
189
+ // certs; absent on older clients → unknown (null), never assumed false.
190
+ const certDomains = Array.isArray(parsed.CertDomains) ? parsed.CertDomains : null;
191
+ const httpsCertsAvailable = certDomains === null
192
+ ? null
193
+ : Boolean(magicDnsName && certDomains.some((entry) => typeof entry === 'string' && entry.replace(/\.$/, '') === magicDnsName));
194
+ return { running, loggedIn, magicDnsName, httpsCertsAvailable };
195
+ };
196
+
197
+ /**
198
+ * `tailscale serve status --json` shape (verified against real output):
199
+ * `{ TCP: { "443": {"HTTPS": true}}, Web: { "<host>:<port>": { Handlers: {...}, AllowFunnel: {...}}}, AllowFunnel: {...} }`.
200
+ * Returns the entry fronting `httpsPort`, or null when unmapped.
201
+ */
202
+ export const findServeMappingForPort = (serveStatus, httpsPort) => {
203
+ if (!serveStatus || typeof serveStatus !== 'object') return null;
204
+ const web = serveStatus.Web && typeof serveStatus.Web === 'object' ? serveStatus.Web : {};
205
+ const wanted = Number(httpsPort);
206
+ for (const [key, entry] of Object.entries(web)) {
207
+ if (typeof key !== 'string') continue;
208
+ // Keys are `<host>:<port>` (or bare `<port>`); compare the port segment
209
+ // exactly so port 443 never matches e.g. 8443 via a suffix check.
210
+ const portSegment = key.includes(':') ? key.slice(key.lastIndexOf(':') + 1) : key;
211
+ if (portSegment === String(wanted)) {
212
+ return { key, entry };
213
+ }
214
+ }
215
+ return null;
216
+ };
217
+
218
+ const collectServeTargets = (entry) => {
219
+ const targets = [];
220
+ const handlers = entry && typeof entry === 'object' ? entry.Handlers : null;
221
+ if (handlers && typeof handlers === 'object') {
222
+ for (const handler of Object.values(handlers)) {
223
+ if (typeof handler === 'string') {
224
+ targets.push(handler);
225
+ } else if (handler && typeof handler === 'object') {
226
+ for (const value of Object.values(handler)) {
227
+ if (typeof value === 'string') targets.push(value);
228
+ }
229
+ }
230
+ }
231
+ }
232
+ return targets;
233
+ };
234
+
235
+ /**
236
+ * Conflict rule: never replace a mapping fronting
237
+ * something else. A mapping is OURS only when every handler target points at
238
+ * our own `http://127.0.0.1:<boundPort>` (trailing slashes ignored).
239
+ */
240
+ export const classifyServeMapping = ({ mapping, httpsPort, boundPort }) => {
241
+ if (!mapping) return { kind: 'absent' };
242
+ const expected = `http://127.0.0.1:${boundPort}`;
243
+ const normalize = (value) => String(value ?? '').trim().replace(/\/+$/, '');
244
+ const targets = collectServeTargets(mapping.entry);
245
+ if (targets.length === 0) return { kind: 'foreign', targets };
246
+ const ours = targets.every((target) => normalize(target) === expected);
247
+ if (ours) return { kind: 'ours', targets };
248
+ return { kind: 'foreign', targets };
249
+ };
250
+
251
+ export const conflictMessageForPort = (httpsPort) => {
252
+ const alternatives = TAILSCALE_HTTPS_PORTS.filter((port) => port !== httpsPort);
253
+ return `Port ${httpsPort} already serves another destination in Tailscale. `
254
+ + 'PiChamber will not overwrite a mapping it did not create. '
255
+ + `Choose another HTTPS port (${alternatives.join(' or ')}).`;
256
+ };
257
+
258
+ /**
259
+ * Approval flow: when HTTPS certs or Funnel are not enabled for the tailnet,
260
+ * serve/funnel prints `https://login.tailscale.com/f/serve?node=...` (or
261
+ * `/f/funnel?...`) and blocks. Extract the first approval URL from streamed
262
+ * output so the service can surface `needs-approval` while it keeps waiting.
263
+ */
264
+ export const extractApprovalUrl = (output) => {
265
+ if (typeof output !== 'string' || !output) return null;
266
+ const match = output.match(/https:\/\/login\.tailscale\.com\/[^\s"'<>]*/);
267
+ return match ? match[0].replace(/[.,;:!?)\]]+$/, '') : null;
268
+ };
269
+
270
+ const PERMISSION_PATTERNS = [
271
+ /access\s*denied/i,
272
+ /permission\s*denied/i,
273
+ /serve config denied/i,
274
+ /operator/i,
275
+ /must be root/i,
276
+ /operation not permitted/i,
277
+ ];
278
+
279
+ /**
280
+ * Linux non-root without operator rights fails with an access/permission
281
+ * style error. Detect it and surface `permission_denied` with the
282
+ * `sudo tailscale set --operator=$USER` fix hint. Matches against the
283
+ * combined stdout+stderr; never logs the raw text (it can contain node names).
284
+ */
285
+ export const isPermissionDeniedOutput = (output) =>
286
+ typeof output === 'string' && PERMISSION_PATTERNS.some((pattern) => pattern.test(output));
287
+
288
+ const permissionDeniedHint = () =>
289
+ 'Tailscale denied the serve configuration (missing operator rights). Run: sudo tailscale set --operator=$USER';
290
+
291
+ export const classifyApplyFailure = (output) => {
292
+ if (isPermissionDeniedOutput(output)) {
293
+ return { code: 'permission_denied', message: permissionDeniedHint() };
294
+ }
295
+ if (extractApprovalUrl(output)) {
296
+ return { code: 'needs_approval', message: 'Tailscale is waiting for tailnet approval.' };
297
+ }
298
+ if (/not logged in|logged out|needs login/i.test(output ?? '')) {
299
+ return { code: 'not_logged_in', message: 'Tailscale is not logged in. Run: tailscale up' };
300
+ }
301
+ return null;
302
+ };