@powerhousedao/shared 6.2.3-dev.7 → 6.2.3-dev.71

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 (317) hide show
  1. package/dist/analytics/index.d.ts +4 -4
  2. package/dist/analytics/index.d.ts.map +1 -1
  3. package/dist/analytics/index.js +25 -24
  4. package/dist/analytics/index.js.map +1 -1
  5. package/dist/clis/args/{access-token-To5LaIfL.mjs → access-token-3Hqv_U8I.mjs} +2 -2
  6. package/dist/clis/args/{access-token-To5LaIfL.mjs.map → access-token-3Hqv_U8I.mjs.map} +1 -1
  7. package/dist/clis/args/access-token-C5sKsH2O.d.mts +16 -0
  8. package/dist/clis/args/access-token-C5sKsH2O.d.mts.map +1 -0
  9. package/dist/clis/args/access-token.d.mts +3 -2
  10. package/dist/clis/args/access-token.mjs +1 -1
  11. package/dist/clis/args/{common-CcYbXrBx.mjs → common-BXabdhiO.mjs} +30 -7
  12. package/dist/clis/args/common-BXabdhiO.mjs.map +1 -0
  13. package/dist/clis/args/common-Bnm859xU.d.mts +186 -0
  14. package/dist/clis/args/common-Bnm859xU.d.mts.map +1 -0
  15. package/dist/clis/args/common.d.mts +3 -2
  16. package/dist/clis/args/common.mjs +1 -1
  17. package/dist/clis/args/{connect-BVVvCmL9.mjs → connect-BLAht4dO.mjs} +9 -4
  18. package/dist/clis/args/connect-BLAht4dO.mjs.map +1 -0
  19. package/dist/clis/args/connect-DjeiqXus.d.mts +450 -0
  20. package/dist/clis/args/connect-DjeiqXus.d.mts.map +1 -0
  21. package/dist/clis/args/connect.d.mts +3 -2
  22. package/dist/clis/args/connect.mjs +1 -1
  23. package/dist/clis/args/dist-CorQTQL-.mjs +1533 -0
  24. package/dist/clis/args/dist-CorQTQL-.mjs.map +1 -0
  25. package/dist/clis/args/{generate-CA916Fvj.mjs → generate-BOItUNvP.mjs} +40 -2
  26. package/dist/clis/args/generate-BOItUNvP.mjs.map +1 -0
  27. package/dist/clis/args/generate-BPBBLeUD.d.mts +103 -0
  28. package/dist/clis/args/generate-BPBBLeUD.d.mts.map +1 -0
  29. package/dist/clis/args/generate.d.mts +3 -2
  30. package/dist/clis/args/generate.mjs +1 -1
  31. package/dist/clis/args/{help-Bqbgbalu.mjs → help-Dejwe6Bz.mjs} +43 -16
  32. package/dist/clis/args/help-Dejwe6Bz.mjs.map +1 -0
  33. package/dist/clis/args/help-KuqI-EEG.d.mts +203 -0
  34. package/dist/clis/args/help-KuqI-EEG.d.mts.map +1 -0
  35. package/dist/clis/args/help.d.mts +3 -2
  36. package/dist/clis/args/help.mjs +1 -1
  37. package/dist/clis/args/index.d.mts +20 -19
  38. package/dist/clis/args/index.mjs +18 -18
  39. package/dist/clis/args/init-CTaK80wE.d.mts +55 -0
  40. package/dist/clis/args/init-CTaK80wE.d.mts.map +1 -0
  41. package/dist/clis/args/{init-rz9Ei7nq.mjs → init-xlCNZ8Oe.mjs} +7 -2
  42. package/dist/clis/args/{init-rz9Ei7nq.mjs.map → init-xlCNZ8Oe.mjs.map} +1 -1
  43. package/dist/clis/args/init.d.mts +3 -2
  44. package/dist/clis/args/init.mjs +1 -1
  45. package/dist/clis/args/inspect-BjRmtB86.d.mts +13 -0
  46. package/dist/clis/args/inspect-BjRmtB86.d.mts.map +1 -0
  47. package/dist/clis/args/{inspect-tckH8mSw.mjs → inspect-UNQgtuR0.mjs} +2 -2
  48. package/dist/clis/args/{inspect-tckH8mSw.mjs.map → inspect-UNQgtuR0.mjs.map} +1 -1
  49. package/dist/clis/args/inspect.d.mts +3 -2
  50. package/dist/clis/args/inspect.mjs +1 -1
  51. package/dist/clis/args/install-B0tMyUMw.d.mts +37 -0
  52. package/dist/clis/args/install-B0tMyUMw.d.mts.map +1 -0
  53. package/dist/clis/args/{install-Sz2DlCHh.mjs → install-F-27kF6m.mjs} +2 -2
  54. package/dist/clis/args/{install-Sz2DlCHh.mjs.map → install-F-27kF6m.mjs.map} +1 -1
  55. package/dist/clis/args/install.d.mts +3 -2
  56. package/dist/clis/args/install.mjs +1 -1
  57. package/dist/clis/args/{list-DM2d6f1m.mjs → list-Bkfn8Yuo.mjs} +2 -2
  58. package/dist/clis/args/{list-DM2d6f1m.mjs.map → list-Bkfn8Yuo.mjs.map} +1 -1
  59. package/dist/clis/args/list-DrbxA7JJ.d.mts +10 -0
  60. package/dist/clis/args/list-DrbxA7JJ.d.mts.map +1 -0
  61. package/dist/clis/args/list.d.mts +3 -2
  62. package/dist/clis/args/list.mjs +1 -1
  63. package/dist/clis/args/{login-DiKT5Jfu.mjs → login-CIFkQExi.mjs} +2 -2
  64. package/dist/clis/args/{login-DiKT5Jfu.mjs.map → login-CIFkQExi.mjs.map} +1 -1
  65. package/dist/clis/args/login-CXRJXg71.d.mts +25 -0
  66. package/dist/clis/args/login-CXRJXg71.d.mts.map +1 -0
  67. package/dist/clis/args/login.d.mts +3 -2
  68. package/dist/clis/args/login.mjs +1 -1
  69. package/dist/clis/args/migrate-DkCQRL2D.d.mts +19 -0
  70. package/dist/clis/args/migrate-DkCQRL2D.d.mts.map +1 -0
  71. package/dist/clis/args/{migrate-CG_gWc4k.mjs → migrate-DwJGhc2d.mjs} +2 -2
  72. package/dist/clis/args/{migrate-CG_gWc4k.mjs.map → migrate-DwJGhc2d.mjs.map} +1 -1
  73. package/dist/clis/args/migrate.d.mts +3 -2
  74. package/dist/clis/args/migrate.mjs +1 -1
  75. package/dist/clis/args/publish-CeW4bOrl.d.mts +16 -0
  76. package/dist/clis/args/publish-CeW4bOrl.d.mts.map +1 -0
  77. package/dist/clis/args/{publish-DDZYsUfV.mjs → publish-DHqlGWmL.mjs} +2 -2
  78. package/dist/clis/args/{publish-DDZYsUfV.mjs.map → publish-DHqlGWmL.mjs.map} +1 -1
  79. package/dist/clis/args/publish.d.mts +3 -2
  80. package/dist/clis/args/publish.mjs +1 -1
  81. package/dist/clis/args/{registry-C_OVFQmI.mjs → registry-DIwES3l2.mjs} +2 -2
  82. package/dist/clis/args/{registry-C_OVFQmI.mjs.map → registry-DIwES3l2.mjs.map} +1 -1
  83. package/dist/clis/args/registry-DNH8xuaE.d.mts +17 -0
  84. package/dist/clis/args/registry-DNH8xuaE.d.mts.map +1 -0
  85. package/dist/clis/args/registry.d.mts +3 -2
  86. package/dist/clis/args/registry.mjs +1 -1
  87. package/dist/clis/args/run-l_LiMplO.mjs +28 -0
  88. package/dist/clis/args/run-l_LiMplO.mjs.map +1 -0
  89. package/dist/clis/args/run.d.mts +18 -0
  90. package/dist/clis/args/run.d.mts.map +1 -0
  91. package/dist/clis/args/run.mjs +2 -0
  92. package/dist/clis/args/{service-CHOOr0Gg.mjs → service-Cpjlyeu5.mjs} +2 -2
  93. package/dist/clis/args/{service-CHOOr0Gg.mjs.map → service-Cpjlyeu5.mjs.map} +1 -1
  94. package/dist/clis/args/service-DiTFThbn.d.mts +27 -0
  95. package/dist/clis/args/service-DiTFThbn.d.mts.map +1 -0
  96. package/dist/clis/args/service.d.mts +3 -2
  97. package/dist/clis/args/service.mjs +1 -1
  98. package/dist/clis/args/{switchboard-Dsp7nosi.mjs → switchboard-CCaAtU56.mjs} +2 -2
  99. package/dist/clis/args/{switchboard-Dsp7nosi.mjs.map → switchboard-CCaAtU56.mjs.map} +1 -1
  100. package/dist/clis/args/switchboard-RrNb1fUH.d.mts +70 -0
  101. package/dist/clis/args/switchboard-RrNb1fUH.d.mts.map +1 -0
  102. package/dist/clis/args/switchboard.d.mts +3 -2
  103. package/dist/clis/args/switchboard.mjs +1 -1
  104. package/dist/clis/args/{uninstall-CTwTX0u_.mjs → uninstall-3U0B8g5c.mjs} +2 -2
  105. package/dist/clis/args/{uninstall-CTwTX0u_.mjs.map → uninstall-3U0B8g5c.mjs.map} +1 -1
  106. package/dist/clis/args/uninstall-CDx7lwxn.d.mts +28 -0
  107. package/dist/clis/args/uninstall-CDx7lwxn.d.mts.map +1 -0
  108. package/dist/clis/args/uninstall.d.mts +3 -2
  109. package/dist/clis/args/uninstall.mjs +1 -1
  110. package/dist/clis/args/unpublish-CEDsk6uv.d.mts +22 -0
  111. package/dist/clis/args/unpublish-CEDsk6uv.d.mts.map +1 -0
  112. package/dist/clis/args/{unpublish-BPMkGEg5.mjs → unpublish-s9zUh6Gw.mjs} +2 -2
  113. package/dist/clis/args/{unpublish-BPMkGEg5.mjs.map → unpublish-s9zUh6Gw.mjs.map} +1 -1
  114. package/dist/clis/args/unpublish.d.mts +3 -2
  115. package/dist/clis/args/unpublish.mjs +1 -1
  116. package/dist/clis/args/{vetra-b4KUu1Ax.mjs → vetra-BUNlAAPp.mjs} +2 -2
  117. package/dist/clis/args/{vetra-b4KUu1Ax.mjs.map → vetra-BUNlAAPp.mjs.map} +1 -1
  118. package/dist/clis/args/vetra-DkDaWFPi.d.mts +111 -0
  119. package/dist/clis/args/vetra-DkDaWFPi.d.mts.map +1 -0
  120. package/dist/clis/args/vetra-ports.test.d.mts +2 -1
  121. package/dist/clis/args/vetra-ports.test.mjs +7366 -5728
  122. package/dist/clis/args/vetra-ports.test.mjs.map +1 -1
  123. package/dist/clis/args/vetra.d.mts +3 -2
  124. package/dist/clis/args/vetra.mjs +1 -1
  125. package/dist/clis/build-config-tJhHVdPm.mjs +277 -0
  126. package/dist/clis/build-config-tJhHVdPm.mjs.map +1 -0
  127. package/dist/clis/build-config.d.mts +56 -10616
  128. package/dist/clis/build-config.d.mts.map +1 -1
  129. package/dist/clis/build-config.mjs +2 -88
  130. package/dist/clis/build-pieces.d.mts +160 -0
  131. package/dist/clis/build-pieces.d.mts.map +1 -0
  132. package/dist/clis/build-pieces.mjs +549 -0
  133. package/dist/clis/build-pieces.mjs.map +1 -0
  134. package/dist/clis/command-names.d.mts +2 -2
  135. package/dist/clis/command-names.d.mts.map +1 -1
  136. package/dist/clis/command-names.mjs +1 -0
  137. package/dist/clis/command-names.mjs.map +1 -1
  138. package/dist/clis/constants.d.mts +3 -462
  139. package/dist/clis/constants.mjs +46 -13
  140. package/dist/clis/constants.mjs.map +1 -1
  141. package/dist/clis/feature-flags.d.mts +17 -0
  142. package/dist/clis/feature-flags.d.mts.map +1 -0
  143. package/dist/clis/feature-flags.mjs +21 -0
  144. package/dist/clis/feature-flags.mjs.map +1 -0
  145. package/dist/clis/index-DnZYG-8g.d.mts +11154 -0
  146. package/dist/clis/index-DnZYG-8g.d.mts.map +1 -0
  147. package/dist/clis/index.d.mts +3390 -1963
  148. package/dist/clis/index.d.mts.map +1 -1
  149. package/dist/clis/index.mjs +1052 -854
  150. package/dist/clis/index.mjs.map +1 -1
  151. package/dist/clis/package-style.d.mts +32 -0
  152. package/dist/clis/package-style.d.mts.map +1 -0
  153. package/dist/clis/package-style.mjs +102 -0
  154. package/dist/clis/package-style.mjs.map +1 -0
  155. package/dist/clis/ph-dir.d.mts +26 -0
  156. package/dist/clis/ph-dir.d.mts.map +1 -0
  157. package/dist/clis/ph-dir.mjs +37 -0
  158. package/dist/clis/ph-dir.mjs.map +1 -0
  159. package/dist/clis/project-env.d.mts +4 -4
  160. package/dist/clis/project-env.d.mts.map +1 -1
  161. package/dist/clis/project-env.mjs.map +1 -1
  162. package/dist/clis/project-ports.d.mts +5 -5
  163. package/dist/clis/project-ports.d.mts.map +1 -1
  164. package/dist/clis/project-ports.mjs +1 -1
  165. package/dist/clis/project-ports.mjs.map +1 -1
  166. package/dist/clis/rolldown-runtime-B4iAMlE-.mjs +35 -0
  167. package/dist/clis/services/telemetry.d.mts +7 -7
  168. package/dist/clis/services/telemetry.d.mts.map +1 -1
  169. package/dist/clis/services/telemetry.mjs.map +1 -1
  170. package/dist/clis/types-DT6KawYx.d.mts +2317 -0
  171. package/dist/clis/types-DT6KawYx.d.mts.map +1 -0
  172. package/dist/clis/utils.d.mts +4 -4
  173. package/dist/clis/utils.d.mts.map +1 -1
  174. package/dist/clis/utils.mjs.map +1 -1
  175. package/dist/{config-loader-B845Hidf.js → config-loader-BWt0c0eU.js} +48 -11
  176. package/dist/config-loader-BWt0c0eU.js.map +1 -0
  177. package/dist/connect/config-loader.d.ts +21 -8
  178. package/dist/connect/config-loader.d.ts.map +1 -1
  179. package/dist/connect/config-loader.js +2 -2
  180. package/dist/connect/connect-config-schema.d.ts +3 -0
  181. package/dist/connect/connect-config-schema.js +445 -0
  182. package/dist/connect/connect-config-schema.js.map +1 -0
  183. package/dist/connect/image-ref.d.ts +32 -0
  184. package/dist/connect/image-ref.d.ts.map +1 -0
  185. package/dist/connect/image-ref.js +80 -0
  186. package/dist/connect/image-ref.js.map +1 -0
  187. package/dist/connect/index.d.ts +220 -643
  188. package/dist/connect/index.d.ts.map +1 -1
  189. package/dist/connect/index.js +432 -507
  190. package/dist/connect/index.js.map +1 -1
  191. package/dist/connect/json-adapter.d.ts +3 -4
  192. package/dist/connect/json-adapter.d.ts.map +1 -1
  193. package/dist/connect/json-adapter.js.map +1 -1
  194. package/dist/connect-config-schema-1-O1CQ4v.d.ts +1731 -0
  195. package/dist/connect-config-schema-1-O1CQ4v.d.ts.map +1 -0
  196. package/dist/constants-CcaK3k1D.d.ts +9 -0
  197. package/dist/constants-CcaK3k1D.d.ts.map +1 -0
  198. package/dist/constants.d.ts +3 -2
  199. package/dist/constants.js +15 -5
  200. package/dist/constants.js.map +1 -1
  201. package/dist/document-drive/index.d.ts +103 -101
  202. package/dist/document-drive/index.d.ts.map +1 -1
  203. package/dist/document-drive/index.js +40 -31
  204. package/dist/document-drive/index.js.map +1 -1
  205. package/dist/document-model/errors.d.ts +3 -0
  206. package/dist/document-model/errors.js +152 -0
  207. package/dist/document-model/errors.js.map +1 -0
  208. package/dist/document-model/index.d.ts +5 -4
  209. package/dist/document-model/index.js +298 -391
  210. package/dist/document-model/index.js.map +1 -1
  211. package/dist/document-model/mock.d.ts +2 -3
  212. package/dist/document-model/mock.d.ts.map +1 -1
  213. package/dist/document-model/mock.js +2 -1
  214. package/dist/document-model/mock.js.map +1 -1
  215. package/dist/document-model/utils.d.ts +3 -2
  216. package/dist/document-model/utils.js +1 -1
  217. package/dist/document-model/version.d.ts +3 -0
  218. package/dist/document-model/version.js +8 -0
  219. package/dist/document-model/version.js.map +1 -0
  220. package/dist/host-tokens/index.d.ts +3 -0
  221. package/dist/host-tokens/index.js +278 -0
  222. package/dist/host-tokens/index.js.map +1 -0
  223. package/dist/index-DIM6qtzj.d.ts +227 -0
  224. package/dist/index-DIM6qtzj.d.ts.map +1 -0
  225. package/dist/index-DvbhwImT.d.ts +36 -0
  226. package/dist/index-DvbhwImT.d.ts.map +1 -0
  227. package/dist/index.d.ts +7 -6
  228. package/dist/index.js.map +1 -1
  229. package/dist/processors/index.d.ts +3 -2
  230. package/dist/processors/index.js +63 -4
  231. package/dist/processors/index.js.map +1 -1
  232. package/dist/purge-v06m_oGz.js +381 -0
  233. package/dist/purge-v06m_oGz.js.map +1 -0
  234. package/dist/registry/index.d.ts +15 -15
  235. package/dist/registry/index.d.ts.map +1 -1
  236. package/dist/registry/index.js +25 -7
  237. package/dist/registry/index.js.map +1 -1
  238. package/dist/registry/manifest-slim.d.ts +4 -3
  239. package/dist/registry/manifest-slim.d.ts.map +1 -1
  240. package/dist/registry/manifest-slim.js +21 -0
  241. package/dist/registry/manifest-slim.js.map +1 -1
  242. package/dist/registry/updates.d.ts +3 -3
  243. package/dist/registry/updates.d.ts.map +1 -1
  244. package/dist/registry/updates.js.map +1 -1
  245. package/dist/registry/urls.d.ts +2 -2
  246. package/dist/registry/urls.d.ts.map +1 -1
  247. package/dist/registry/urls.js.map +1 -1
  248. package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
  249. package/dist/{types-CpnWmiFY.d.ts → types-BpO4LIKj.d.ts} +2149 -985
  250. package/dist/types-BpO4LIKj.d.ts.map +1 -0
  251. package/dist/{types-C1in4fl3.d.ts → types-Bsp8VL2y.d.ts} +2 -2
  252. package/dist/types-Bsp8VL2y.d.ts.map +1 -0
  253. package/dist/{types-YqLqb0Zb.d.ts → types-OXIqeH8W.d.ts} +39 -43
  254. package/dist/types-OXIqeH8W.d.ts.map +1 -0
  255. package/dist/{utils-DP122OSS.d.ts → utils-BrKxCmKx.d.ts} +2 -2
  256. package/dist/utils-BrKxCmKx.d.ts.map +1 -0
  257. package/dist/{utils-aaTmfxFW.js → utils-CSF716ux.js} +10 -3
  258. package/dist/utils-CSF716ux.js.map +1 -0
  259. package/dist/version-BxLITo9P.d.ts +6 -0
  260. package/dist/version-BxLITo9P.d.ts.map +1 -0
  261. package/package.json +28 -7
  262. package/dist/clis/args/access-token--9H57y8J.d.mts +0 -18
  263. package/dist/clis/args/access-token--9H57y8J.d.mts.map +0 -1
  264. package/dist/clis/args/common-CcYbXrBx.mjs.map +0 -1
  265. package/dist/clis/args/common-zPBoTNJF.d.mts +0 -183
  266. package/dist/clis/args/common-zPBoTNJF.d.mts.map +0 -1
  267. package/dist/clis/args/connect-BVVvCmL9.mjs.map +0 -1
  268. package/dist/clis/args/connect-BtU0MTTc.d.mts +0 -443
  269. package/dist/clis/args/connect-BtU0MTTc.d.mts.map +0 -1
  270. package/dist/clis/args/generate-CA916Fvj.mjs.map +0 -1
  271. package/dist/clis/args/generate-DnV-bfXt.d.mts +0 -87
  272. package/dist/clis/args/generate-DnV-bfXt.d.mts.map +0 -1
  273. package/dist/clis/args/help-Bqbgbalu.mjs.map +0 -1
  274. package/dist/clis/args/help-CjAsudUn.d.mts +0 -193
  275. package/dist/clis/args/help-CjAsudUn.d.mts.map +0 -1
  276. package/dist/clis/args/init-CUXyfquF.d.mts +0 -55
  277. package/dist/clis/args/init-CUXyfquF.d.mts.map +0 -1
  278. package/dist/clis/args/inspect-DtZeoA5c.d.mts +0 -15
  279. package/dist/clis/args/inspect-DtZeoA5c.d.mts.map +0 -1
  280. package/dist/clis/args/install-CkP8zcHb.d.mts +0 -40
  281. package/dist/clis/args/install-CkP8zcHb.d.mts.map +0 -1
  282. package/dist/clis/args/list-BGf8s_gj.d.mts +0 -12
  283. package/dist/clis/args/list-BGf8s_gj.d.mts.map +0 -1
  284. package/dist/clis/args/login-DNsHwvqk.d.mts +0 -27
  285. package/dist/clis/args/login-DNsHwvqk.d.mts.map +0 -1
  286. package/dist/clis/args/magic-string.es-h_0HDQBQ.mjs +0 -1013
  287. package/dist/clis/args/magic-string.es-h_0HDQBQ.mjs.map +0 -1
  288. package/dist/clis/args/migrate-sixkWhxm.d.mts +0 -21
  289. package/dist/clis/args/migrate-sixkWhxm.d.mts.map +0 -1
  290. package/dist/clis/args/publish-Dqe5DUst.d.mts +0 -18
  291. package/dist/clis/args/publish-Dqe5DUst.d.mts.map +0 -1
  292. package/dist/clis/args/registry-C_RfTsKB.d.mts +0 -19
  293. package/dist/clis/args/registry-C_RfTsKB.d.mts.map +0 -1
  294. package/dist/clis/args/service-DhIkf8-O.d.mts +0 -22
  295. package/dist/clis/args/service-DhIkf8-O.d.mts.map +0 -1
  296. package/dist/clis/args/switchboard-BlPaq2at.d.mts +0 -72
  297. package/dist/clis/args/switchboard-BlPaq2at.d.mts.map +0 -1
  298. package/dist/clis/args/uninstall-BpA3YYbw.d.mts +0 -31
  299. package/dist/clis/args/uninstall-BpA3YYbw.d.mts.map +0 -1
  300. package/dist/clis/args/unpublish-CvwaIimG.d.mts +0 -24
  301. package/dist/clis/args/unpublish-CvwaIimG.d.mts.map +0 -1
  302. package/dist/clis/args/vetra-CoMvTJK7.d.mts +0 -113
  303. package/dist/clis/args/vetra-CoMvTJK7.d.mts.map +0 -1
  304. package/dist/clis/build-config.mjs.map +0 -1
  305. package/dist/clis/constants.d.mts.map +0 -1
  306. package/dist/config-loader-B845Hidf.js.map +0 -1
  307. package/dist/constants-BP_gjn8g.d.ts +0 -8
  308. package/dist/constants-BP_gjn8g.d.ts.map +0 -1
  309. package/dist/index-C_iVZe7f.d.ts +0 -7
  310. package/dist/index-C_iVZe7f.d.ts.map +0 -1
  311. package/dist/index-DyYIJtVy.d.ts +0 -836
  312. package/dist/index-DyYIJtVy.d.ts.map +0 -1
  313. package/dist/types-C1in4fl3.d.ts.map +0 -1
  314. package/dist/types-CpnWmiFY.d.ts.map +0 -1
  315. package/dist/types-YqLqb0Zb.d.ts.map +0 -1
  316. package/dist/utils-DP122OSS.d.ts.map +0 -1
  317. package/dist/utils-aaTmfxFW.js.map +0 -1
@@ -0,0 +1,445 @@
1
+ import { tokenable } from "../host-tokens/index.js";
2
+ import { z } from "zod";
3
+ //#region connect/connect-config-schema.ts
4
+ const IMAGE_REF = "Image reference: a project-relative file path, a URL, or a data URI.";
5
+ const IMAGE_REF_OR_DEFAULT = "Image reference: a project-relative file path (resolved by the Connect build), a URL, or a data URI. null keeps the default.";
6
+ /** An image reference: a project-relative file path (the Connect build turns
7
+ * it into a data URI or an emitted file), a URL, or a data URI. */
8
+ const connectImageRefSchema = z.string().describe(IMAGE_REF);
9
+ /** An image reference where `null` (or omitting it) keeps the default. */
10
+ const optionalImageRef = (description = IMAGE_REF_OR_DEFAULT) => connectImageRefSchema.nullable().optional().describe(description);
11
+ /** An image per colour scheme: one reference for both, or `{ light, dark }`
12
+ * (`dark` falls back to `light`). */
13
+ const connectSchemedImageSchema = z.union([connectImageRefSchema, z.strictObject({
14
+ light: connectImageRefSchema,
15
+ dark: connectImageRefSchema.nullable().optional()
16
+ })]).describe("One image for both colour schemes, or { light, dark } (dark falls back to light).");
17
+ /** A CSS colour per colour scheme (`dark` falls back to `light`). */
18
+ const connectSchemedColorSchema = z.union([z.string(), z.strictObject({
19
+ light: z.string(),
20
+ dark: z.string().nullable().optional()
21
+ })]);
22
+ /** A CSS length: a number is px, a string is passed through as written. */
23
+ const connectLengthSchema = z.union([z.number(), z.string()]);
24
+ const optionalLength = () => connectLengthSchema.nullable().optional().describe("A CSS length: a number is px; a string is used as written (\"40%\", \"min(55%, 880px)\", \"calc(50% - 120px)\").");
25
+ /** Distances to the four edges; each is optional. */
26
+ const connectEdgesSchema = z.strictObject({
27
+ top: optionalLength(),
28
+ right: optionalLength(),
29
+ bottom: optionalLength(),
30
+ left: optionalLength()
31
+ });
32
+ /** One image of a decorated pane, absolutely positioned inside it. */
33
+ const connectBackgroundLayerSchema = z.strictObject({
34
+ src: connectSchemedImageSchema,
35
+ position: connectEdgesSchema.nullable().optional().describe("Distances to the pane's edges; at most one per axis. Omitted: centred both ways."),
36
+ width: optionalLength(),
37
+ height: optionalLength(),
38
+ minWidth: optionalLength(),
39
+ minHeight: optionalLength(),
40
+ maxWidth: optionalLength(),
41
+ maxHeight: optionalLength(),
42
+ opacity: z.number().min(0).max(1).nullable().optional().describe("0 to 1 (default 1)."),
43
+ fade: connectEdgesSchema.nullable().optional().describe("Feather depth per edge, fading the layer into the page colour.")
44
+ }).describe("An image laid over the page, absolutely positioned: the edges set in `position` pin it, an axis with neither edge set is centred.");
45
+ /** A decorated pane: the page colour and the images laid over it. */
46
+ const connectBackgroundLayersSchema = z.strictObject({
47
+ color: connectSchemedColorSchema.nullable().optional().describe("The page colour, or { light, dark }. Omitted or null: the theme's page background."),
48
+ layers: z.array(connectBackgroundLayerSchema).describe("Painted in order; the first is at the back.")
49
+ });
50
+ /** A pane's background: layers over a page colour, or one image as
51
+ * shorthand for a single layer pinned bottom-right. */
52
+ const connectBackgroundSchema = z.union([connectImageRefSchema, connectBackgroundLayersSchema]).describe("Layered images over a page colour, or a single image pinned to the bottom-right corner. null keeps the default.");
53
+ /** The loading image and the motion applied to it. */
54
+ const connectLoaderSchema = z.strictObject({
55
+ src: connectImageRefSchema,
56
+ animation: z.enum([
57
+ "pulse",
58
+ "spin",
59
+ "none"
60
+ ]).nullable().optional().describe("Motion applied to the image (default pulse)."),
61
+ size: z.number().min(16).max(512).nullable().optional().describe("Rendered width in CSS pixels (default 96); the height follows the image.")
62
+ });
63
+ /** `connect.branding`: Connect's identity and look. */
64
+ const connectBrandingSchema = z.strictObject({
65
+ appName: z.string().nullable().optional().describe("Browser tab title, installed-app name and in-app brand text. null or omitted: 'Powerhouse Connect'."),
66
+ icon: optionalImageRef("App icon master (1024x1024 PNG recommended, or an SVG). The favicons and installed-app icons are found next to it as <name>_16x16.png, _32x32, _64x64, _192x192 and _512x512; the 64 px one is the in-app logo. null or omitted: Connect's icon."),
67
+ favicon: z.string().nullable().optional().describe("The browser tab icon: a file (.ico, .svg or .png) relative to the project, served and built as icon.ico. A build input; the built runtime config leaves it out. `ph connect build --favicon` wins over it."),
68
+ loader: z.union([connectImageRefSchema, connectLoaderSchema]).nullable().optional().describe("The loading image (first paint, app start, drive and editor loading). A path gets a gentle pulse; { src, animation, size } says otherwise, with animation \"none\" for an image that animates itself (animated SVG, GIF or WebP). null or omitted: Connect's animated logo.")
69
+ }).describe("App identity and visual branding. Every field is optional; null means the default.");
70
+ /** `connect.home`: the home screen (the generic chrome's landing page). */
71
+ const connectHomeSchema = z.strictObject({ background: connectBackgroundSchema.nullable().optional().describe("The home screen's background: { color, layers } with each image positioned and sized, or one image pinned bottom-right. null or omitted: the bundled gradient.") }).describe("The home screen (the generic chrome's landing page).");
72
+ const connectAppSchema = z.strictObject({
73
+ logLevel: z.enum([
74
+ "debug",
75
+ "info",
76
+ "warn",
77
+ "error"
78
+ ]).optional().meta({
79
+ description: "Log level applied by Connect's logger at boot. Affects browser-side output only.",
80
+ default: "info"
81
+ }),
82
+ basePath: z.string().optional().meta({
83
+ description: "Base path Connect is mounted under (e.g. '/connect' for subpath deploys). Normalised at runtime to start and end with '/'. Defaults to the build-time BASE_URL.",
84
+ default: "/"
85
+ }),
86
+ offline: z.boolean().optional().meta({
87
+ description: "When true (default), the build emits a precaching service worker so Connect's app shell works offline, and the SPA registers it at boot. Set false to opt this deployment out: no service worker is built, the SPA skips registration, and any previously-installed worker is unregistered.",
88
+ default: true
89
+ }),
90
+ studioMode: z.boolean().optional().meta({
91
+ description: "Studio mode. Enables builder-only capabilities: Connect loads the vetra package and exposes DocumentModel (and vetra spec types) as creatable documents. Forced on by `ph vetra` / `ph connect studio`; false by default.",
92
+ default: false
93
+ }),
94
+ workflowsEnabled: z.boolean().optional().describe("Powerhouse workflows in Connect. When true the tab loads the @powerhousedao/workflow package (workflow + connection documents, their editors and Workflow Studio) and the reactor worker registers its document models. Falls back to the top-level `workflows.enabled`; set it to override that for Connect. Independent of studioMode. False when neither is set.")
95
+ }).describe("Top-level Connect application behaviour.");
96
+ const connectAiSchema = z.strictObject({ assistantEnabled: z.boolean().optional().meta({
97
+ description: "When true, Connect mounts the in-browser AI assistant (bottom-right chat FAB that talks to a user-configured OpenAI-compatible endpoint and acts on the reactor). Disabled by default.",
98
+ default: false
99
+ }) }).describe("AI assistant (chat) behaviour.");
100
+ const connectPackagesSchema = z.strictObject({
101
+ externalEnabled: z.boolean().optional().meta({
102
+ description: "When false, Connect refuses to load any package that wasn't bundled at build time. Affirmative replacement for the legacy PH_CONNECT_EXTERNAL_PACKAGES_DISABLED env var.",
103
+ default: true
104
+ }),
105
+ liveReload: z.boolean().optional().meta({
106
+ description: "When true, Connect subscribes to the static-mode `/__packages` SSE channel so live publishes flow into the running tab without a page reload. Only works under hosting that serves this channel (e.g. ph-clint static mode).",
107
+ default: false
108
+ })
109
+ }).describe("Runtime behaviour for the Connect package manager (separate from top-level `packages[]`, which lists which packages to load).");
110
+ const EXPLORER_ICONS_DESCRIPTION = "The drive explorer's icons (the generic plugin's); each null keeps the built-in icon.";
111
+ /** The drive explorer's icons: the generic chrome's, owned by the generic
112
+ * plugin. Each `null` keeps the built-in icon. */
113
+ const connectExplorerIconsSchema = z.strictObject({
114
+ localDrive: optionalImageRef("Local drives without an icon of their own."),
115
+ remoteDrive: optionalImageRef("Remote drives without an icon of their own."),
116
+ folder: optionalImageRef("Folders."),
117
+ document: optionalImageRef("Documents whose type has no icon in `documents`."),
118
+ documents: z.record(z.string(), connectImageRefSchema).nullable().optional().describe("Per document type, e.g. \"acme/invoice\".")
119
+ }).describe(EXPLORER_ICONS_DESCRIPTION);
120
+ const connectDefaultDriveRemoteSchema = z.strictObject({
121
+ url: z.string(),
122
+ name: z.string().nullable().optional(),
123
+ icon: z.string().nullable().optional()
124
+ });
125
+ const connectDefaultDriveLocalSchema = z.strictObject({
126
+ local: z.literal(true).describe("Discriminator: this entry is a local drive created on first boot."),
127
+ id: z.string().describe("Stable drive id. The drive is created with this id on first boot and is not re-created on later boots."),
128
+ name: z.string().nullable().optional(),
129
+ icon: z.string().nullable().optional(),
130
+ app: z.string().optional().describe("Drive app (preferred editor) to open on the drive.")
131
+ });
132
+ const connectDefaultDriveSchema = z.union([connectDefaultDriveRemoteSchema, connectDefaultDriveLocalSchema]);
133
+ /** `connect.drives.sections.{remote,local}`: three affirmative toggles. */
134
+ const connectDriveSectionSchema = z.strictObject({
135
+ enabled: z.boolean().optional().meta({
136
+ description: "When false, the section is hidden in the sidebar.",
137
+ default: true
138
+ }),
139
+ allowAdd: z.boolean().optional().meta({
140
+ description: "When false, the section's 'add drive' affordance is hidden.",
141
+ default: true
142
+ }),
143
+ allowDelete: z.boolean().optional().meta({
144
+ description: "When false, drives in this section cannot be deleted from the UI.",
145
+ default: true
146
+ })
147
+ }).describe("Visibility and add/delete affordances for a drive section in the sidebar.");
148
+ const connectDriveSectionsSchema = z.strictObject({
149
+ remote: connectDriveSectionSchema.optional(),
150
+ local: connectDriveSectionSchema.optional()
151
+ }).describe("Per-section visibility and affordance toggles. `remote` covers what was historically split into 'public' + 'cloud'; `local` is browser-local drives.");
152
+ /** Mirrors DRIVES_PRESERVE_STRATEGIES (../clis/constants.ts, which imports
153
+ * node: modules, so it is not imported here); a test pins the two. */
154
+ const connectDrivePreserveStrategySchema = z.enum(["preserve-all", "preserve-by-url-and-detach"]);
155
+ const connectDrivesSchema = z.strictObject({
156
+ allowAddDrive: z.boolean().optional().meta({
157
+ description: "When false, the SPA hides the 'add drive' affordance entirely (top-level). Per-section overrides live in `sections.{remote,local}.allowAdd`.",
158
+ default: true
159
+ }),
160
+ defaultDrives: z.array(connectDefaultDriveSchema).optional().meta({
161
+ description: "Drives the SPA auto-connects to on first load. Each entry is either a remote drive (a URL, with optional name/icon overrides) or a local drive (created locally on first boot, with a stable id and optional name/icon/app).",
162
+ default: []
163
+ }),
164
+ preserveStrategy: connectDrivePreserveStrategySchema.optional().describe("Strategy applied when defaultDrives change between deploys. 'preserve-all' keeps user-added drives untouched; 'preserve-by-url-and-detach' detaches removed default drives. No schema default — opt-in only."),
165
+ sections: connectDriveSectionsSchema.optional(),
166
+ icons: connectExplorerIconsSchema.nullable().optional().describe(EXPLORER_ICONS_DESCRIPTION)
167
+ }).describe("Default-drive and add-drive UI behaviour.");
168
+ const connectRenownRainbowAdapterSchema = z.strictObject({
169
+ walletConnectProjectId: z.string().optional().describe("WalletConnect project id; required for this adapter to function."),
170
+ infuraProjectId: z.string().optional().describe("Optional Infura project id used to build RPC transports.")
171
+ }).describe("wagmi + RainbowKit external-wallet adapter config.");
172
+ const connectRenownPrivyAdapterSchema = z.strictObject({
173
+ appId: z.string().optional().describe("Privy application id; required for this adapter to function."),
174
+ clientId: z.string().optional().describe("Optional Privy client id."),
175
+ methods: z.array(z.string()).optional().describe("Login methods this adapter offers; default per adapter when omitted.")
176
+ }).describe("Privy embedded/social adapter config.");
177
+ const connectRenownAdaptersSchema = z.strictObject({
178
+ rainbow: connectRenownRainbowAdapterSchema.optional(),
179
+ privy: connectRenownPrivyAdapterSchema.optional()
180
+ }).describe("Per-adapter wallet config for in-page auth. Presence of an adapter key enables it; omit or leave empty for redirect-only behaviour.");
181
+ const connectRenownSchema = z.strictObject({
182
+ url: z.string().optional().meta({
183
+ description: "Renown auth service URL.",
184
+ default: "https://www.renown.id"
185
+ }),
186
+ networkId: z.string().optional().meta({
187
+ description: "CAIP-2 network namespace (e.g. 'eip155').",
188
+ default: "eip155"
189
+ }),
190
+ chainId: z.number().optional().meta({
191
+ description: "CAIP-2 chain reference within the network namespace.",
192
+ default: 1
193
+ }),
194
+ namespace: z.string().optional().describe("Renown localStorage namespace; share it across Connects to share login."),
195
+ switchboardUrl: z.string().optional().describe("Switchboard GraphQL URL. When set, Connect enables in-page (no-redirect) Renown sign-in; otherwise it falls back to the redirect flow via `url`."),
196
+ adapters: connectRenownAdaptersSchema.optional()
197
+ }).describe("Renown identity / authentication coordinates.");
198
+ const connectSentrySchema = z.strictObject({
199
+ dsn: z.string().nullable().optional().meta({
200
+ description: "Sentry DSN URL. `null` disables Sentry entirely; the SPA never loads the Sentry SDK chunk.",
201
+ default: null
202
+ }),
203
+ env: z.string().optional().meta({
204
+ description: "Sentry environment label, surfaced as the `environment` tag on every event.",
205
+ default: "dev"
206
+ }),
207
+ tracing: z.boolean().optional().meta({
208
+ description: "Enable Sentry performance tracing.",
209
+ default: false
210
+ })
211
+ }).describe("Sentry error-tracking coordinates. Set `dsn` to enable Sentry; leave `dsn` null to disable. The Sentry release tag stays build-time (stamped via Vite's `define` from WORKSPACE_VERSION) so it always matches the sourcemaps uploaded by CI.");
212
+ const connectOpenPanelSchema = z.strictObject({
213
+ clientId: z.string().optional().meta({
214
+ description: "OpenPanel client id. Empty string disables OpenPanel entirely.",
215
+ default: ""
216
+ }),
217
+ apiUrl: z.string().optional().describe("OpenPanel API URL for self-hosted instances (e.g. 'https://openpanel.example/api'). Omit to use OpenPanel's hosted API."),
218
+ trackUiEvents: z.boolean().optional().meta({
219
+ description: "Track UI events.",
220
+ default: true
221
+ }),
222
+ trackOperations: z.boolean().optional().meta({
223
+ description: "Track document operations.",
224
+ default: true
225
+ })
226
+ }).describe("OpenPanel product analytics. Set `clientId` to enable; an empty `clientId` disables it. Events are only sent after the user accepts analytics cookies. Takes precedence over the build-time PH_CONNECT_OPENPANEL_* env vars.");
227
+ /** Which reactor client Connect runs (see PHReactorClientMode). */
228
+ const connectReactorClientModeSchema = z.enum([
229
+ "in-process",
230
+ "worker",
231
+ "remote",
232
+ "router"
233
+ ]);
234
+ const connectInstanceSchema = z.strictObject({
235
+ namespace: z.string().nullable().meta({
236
+ description: "Explicit storage/SharedWorker namespace for this instance. `null` derives it from the base path (and, later, the configured endpoint), so root deployments stay byte-identical.",
237
+ default: null
238
+ }),
239
+ reactorWorker: z.boolean().meta({
240
+ description: "Host the reactor in a shared worker instead of on the main thread. Off by default; the main-thread reactor stays the proven path until cutover is verified. Packaged deployments load the worker from the prebuilt bundle `ph connect build` emits under __reactor_worker__/ (the dev server builds it lazily at the same path); when that bundle is absent the feature reports itself unavailable instead of starting a worker that cannot load.",
241
+ default: false
242
+ }),
243
+ multiReactor: z.boolean().optional().meta({
244
+ description: "Opt-in multi-reactor routing. When on, Connect routes through the in-browser reactor plus remote backends instead of the single in-browser reactor. Off by default; the single-reactor path is unchanged.",
245
+ default: false
246
+ })
247
+ }).describe("Per-instance identity. Lets one origin host multiple isolated Connect instances, each with its own storage + SharedWorker namespace.");
248
+ const connectReactorFeatureFlagsSchema = z.strictObject({
249
+ documentDecisions: z.boolean().optional().meta({
250
+ description: "Decide writes from the document stream rather than the document meta cache, so a backdated deletion denies the operations that sort after it.",
251
+ default: false
252
+ }),
253
+ authEnforcement: z.boolean().optional().meta({
254
+ description: "Enforce the auth scope's policy at admission, replay, and read. Requires documentDecisions.",
255
+ default: false
256
+ }),
257
+ authGroups: z.boolean().optional().meta({
258
+ description: "Let `{ group }` principals match against the rosters of the group documents a policy names. Requires authEnforcement.",
259
+ default: false
260
+ }),
261
+ authConditions: z.boolean().optional().meta({
262
+ description: "Evaluate `where` and `match` conditions on grants. Requires authGroups. Do not enable on a fleet `preflight:auth` reports as crossing a reducer version.",
263
+ default: false
264
+ })
265
+ }).describe("Enforcement flags. Each implies its predecessors, and the reactor refuses to boot on a set that names a later flag without an earlier one. These are consensus settings: a Connect syncing with a fleet must carry the same flags the fleet does, or the two reach different replay outcomes for the same history and diverge.");
266
+ const connectReactorSchema = z.strictObject({
267
+ featureFlags: connectReactorFeatureFlagsSchema.optional(),
268
+ createSignaturePolicy: z.enum(["legacy", "v2-required"]).optional().meta({
269
+ description: "What new documents are created as. `v2-required` documents accept only v2 action signatures and take content-addressed ids; set `legacy` while any peer Connect syncs with predates them. Existing documents keep their policy.",
270
+ default: "v2-required"
271
+ }),
272
+ unsupportedStoredDocuments: z.enum(["refuse", "read-only"]).optional().meta({
273
+ description: "What the reactor does when this browser's store holds documents at protocol versions this build does not run. `refuse` fails the boot and names the versions; `read-only` boots and keeps those documents read-only.",
274
+ default: "refuse"
275
+ })
276
+ }).describe("Settings for the reactor Connect runs in the browser, on the main thread or in the shared worker alike.");
277
+ /** A runtime-caching / denylist URL match. A string is handed to Workbox
278
+ * verbatim; `{ source, flags }` is rebuilt into a RegExp at build time. */
279
+ const connectPwaUrlPatternSchema = z.union([z.string(), z.strictObject({
280
+ source: z.string().describe("RegExp source."),
281
+ flags: z.string().optional().describe("RegExp flags (e.g. 'i').")
282
+ }).refine((p) => {
283
+ try {
284
+ new RegExp(p.source, p.flags);
285
+ return true;
286
+ } catch {
287
+ return false;
288
+ }
289
+ }, { message: "source/flags do not compile to a valid RegExp" })]).describe("URL match. A string is matched verbatim by Workbox; { source, flags } is rebuilt into a RegExp at build time.");
290
+ const connectPwaCacheStrategySchema = z.enum([
291
+ "CacheFirst",
292
+ "CacheOnly",
293
+ "NetworkFirst",
294
+ "NetworkOnly",
295
+ "StaleWhileRevalidate"
296
+ ]);
297
+ /** Serialisable subset of a Workbox `RuntimeCaching` rule. */
298
+ const connectPwaRuntimeCachingSchema = z.strictObject({
299
+ urlPattern: connectPwaUrlPatternSchema,
300
+ handler: connectPwaCacheStrategySchema,
301
+ method: z.enum([
302
+ "GET",
303
+ "POST",
304
+ "PUT",
305
+ "DELETE",
306
+ "HEAD",
307
+ "PATCH"
308
+ ]).optional(),
309
+ options: z.strictObject({
310
+ cacheName: z.string().optional(),
311
+ networkTimeoutSeconds: z.number().optional().describe("Seconds a NetworkFirst rule waits for the network before falling back to the cache."),
312
+ expiration: z.strictObject({
313
+ maxEntries: z.number().optional(),
314
+ maxAgeSeconds: z.number().optional()
315
+ }).optional(),
316
+ cacheableResponse: z.strictObject({
317
+ statuses: z.array(z.number()).optional(),
318
+ headers: z.record(z.string(), z.string()).optional()
319
+ }).optional()
320
+ }).optional()
321
+ });
322
+ const connectPwaIconSchema = z.strictObject({
323
+ src: z.string(),
324
+ sizes: z.string().optional(),
325
+ type: z.string().optional(),
326
+ purpose: z.string().optional()
327
+ });
328
+ /** A File Handling API entry. No `action`: every handler opens at Connect's
329
+ * app root, because consuming launched files needs Connect's own code. */
330
+ const connectPwaFileHandlerSchema = z.strictObject({
331
+ accept: z.record(z.string(), z.array(z.string().regex(/^\./, "file extensions must start with '.'"))).describe("MIME type → file extensions. Each extension must start with '.'; browsers ignore entries without it."),
332
+ icons: z.array(connectPwaIconSchema).optional().describe("OS-level file-type icons."),
333
+ launch_type: z.enum(["single-client", "multiple-clients"]).optional()
334
+ });
335
+ /** Web-app-manifest fields a package or project may override. */
336
+ const connectPwaManifestSchema = z.strictObject({
337
+ name: z.string().optional(),
338
+ short_name: z.string().optional(),
339
+ description: z.string().optional(),
340
+ theme_color: z.string().optional(),
341
+ background_color: z.string().optional(),
342
+ display: z.enum([
343
+ "fullscreen",
344
+ "standalone",
345
+ "minimal-ui",
346
+ "browser"
347
+ ]).optional(),
348
+ start_url: z.string().optional(),
349
+ scope: z.string().optional(),
350
+ icons: z.array(connectPwaIconSchema).optional().describe("Icons appended to the built-in set and de-duplicated by (src, sizes, purpose)."),
351
+ file_handlers: z.array(connectPwaFileHandlerSchema).optional().describe("File associations appended after Connect's built-in .phd/.phdm handler and de-duplicated on the whole entry. Entries only declare accepted types; there is no action field, because opening the files requires Connect's own runtime handling, so every handler opens at the app root."),
352
+ launch_handler: z.strictObject({ client_mode: z.enum([
353
+ "auto",
354
+ "focus-existing",
355
+ "navigate-existing",
356
+ "navigate-new"
357
+ ]) }).optional().describe("How the OS launches the app for handled files/links. Connect defaults to focus-existing.")
358
+ }).describe("Web-app-manifest field overrides.");
359
+ const pwaShape = {
360
+ globPatterns: z.array(z.string()).optional().describe("Extra Workbox precache globs, unioned with the built-ins."),
361
+ globIgnores: z.array(z.string()).optional().describe("Extra precache ignore globs, unioned with the built-ins."),
362
+ maximumFileSizeToCacheInBytes: z.number().optional().describe("Raise the precache file-size ceiling. The max across all contributors wins, so no contributor can shrink another's limit."),
363
+ runtimeCaching: z.array(connectPwaRuntimeCachingSchema).optional().describe("Runtime-caching rules appended after the built-in rules. Workbox is first-match-wins, so these cannot override a built-in rule matching the same URL."),
364
+ navigateFallbackDenylist: z.array(connectPwaUrlPatternSchema).optional().describe("Extra SPA navigate-fallback denylist patterns, unioned with the built-ins.")
365
+ };
366
+ const PWA_DESCRIPTION = "Progressive-web-app / service-worker overrides, layered on Connect's built-in PWA defaults at build time. Scalar fields deep-merge (this layer wins); the array members (icons, file_handlers, globs, runtimeCaching and denylist patterns) are additive; maximumFileSizeToCacheInBytes takes the max across contributors. (categories is not set here — it is derived from the manifest's category field.) Only applied when connect.app.offline is true.";
367
+ /** `connect.pwa` as authored. */
368
+ const connectPwaSchema = z.strictObject({
369
+ manifest: connectPwaManifestSchema.optional(),
370
+ ...pwaShape
371
+ }).describe(PWA_DESCRIPTION);
372
+ /**
373
+ * The `connect` block as authored: powerhouse.config.json's `connect`, the
374
+ * connect host's `config`, and `ph connect config` writes. Every field is
375
+ * optional; omit the section entirely for default behaviour.
376
+ */
377
+ const connectConfigSchema = z.strictObject({
378
+ branding: connectBrandingSchema.optional(),
379
+ home: connectHomeSchema.optional(),
380
+ app: connectAppSchema.optional(),
381
+ ai: connectAiSchema.optional(),
382
+ packages: connectPackagesSchema.optional(),
383
+ drives: connectDrivesSchema.optional(),
384
+ renown: connectRenownSchema.optional(),
385
+ sentry: connectSentrySchema.optional(),
386
+ openPanel: connectOpenPanelSchema.optional(),
387
+ instance: connectInstanceSchema.optional(),
388
+ reactor: connectReactorSchema.optional(),
389
+ pwa: connectPwaSchema.optional()
390
+ }).describe("Connect-specific UI customisations. All fields optional; omit the section entirely for default behaviour.");
391
+ /** `schema` carrying `source`'s description and meta (zod keeps them per
392
+ * instance, so `.extend()` and a rebuilt field drop them). */
393
+ function withMetaOf(schema, source) {
394
+ const meta = source.meta();
395
+ return meta ? schema.meta(meta) : schema;
396
+ }
397
+ /**
398
+ * The `connect` block with its token-able fields wrapped by `field`: the
399
+ * fields that name another host's outputs, which a connect host's `config`
400
+ * may write as output tokens (`ph run` resolves them before the verb).
401
+ *
402
+ * - `drives.defaultDrives[].url` (a remote entry): e.g. a switchboard's
403
+ * `drives.<slug>.url` output.
404
+ * - `renown.switchboardUrl`: a switchboard's `endpoints.graphql` output.
405
+ *
406
+ * The connect runner builds it with host-core's `s.tokenable` (declared:
407
+ * tokens in; resolved: plain values only). The output type is
408
+ * {@link ConnectConfig} either way. powerhouse.config.json's `connect` block,
409
+ * the served config and their JSON Schemas stay {@link connectConfigSchema},
410
+ * which takes no tokens.
411
+ */
412
+ function connectConfigSchemaWith(field) {
413
+ const remoteDrive = connectDefaultDriveRemoteSchema.extend({ url: field(z.string()) });
414
+ const shape = connectDrivesSchema.shape;
415
+ const drives = withMetaOf(connectDrivesSchema.extend({ defaultDrives: withMetaOf(z.array(z.union([remoteDrive, connectDefaultDriveLocalSchema])).optional(), shape.defaultDrives) }), connectDrivesSchema);
416
+ const renown = withMetaOf(connectRenownSchema.extend({ switchboardUrl: withMetaOf(field(z.string()).optional(), connectRenownSchema.shape.switchboardUrl) }), connectRenownSchema);
417
+ return withMetaOf(connectConfigSchema.extend({
418
+ drives: drives.optional(),
419
+ renown: renown.optional()
420
+ }), connectConfigSchema);
421
+ }
422
+ /** The declared `connect` block: {@link connectConfigSchemaWith} with every
423
+ * token accepted in its token-able fields. */
424
+ const declaredConnectConfigSchema = /* @__PURE__ */ connectConfigSchemaWith(tokenable);
425
+ /** One entry of the host.js composition, projected into the served config as
426
+ * data (module specifier + validated config). */
427
+ const connectCompositionEntrySchema = z.strictObject({
428
+ module: z.string(),
429
+ config: z.record(z.string(), z.unknown()).optional()
430
+ });
431
+ /** `instance` plus `reactorClient`, derived from the host's reactor backends. */
432
+ const connectRuntimeInstanceSchema = connectInstanceSchema.extend({ reactorClient: connectReactorClientModeSchema.optional() });
433
+ /** The manifest plus `categories`, derived from contributors' `category`. */
434
+ const connectRuntimePwaManifestSchema = connectPwaManifestSchema.extend({ categories: z.array(z.string()).optional() });
435
+ const connectRuntimePwaSchema = connectPwaSchema.extend({ manifest: connectRuntimePwaManifestSchema.optional() });
436
+ /** The served `connect` block (runtime powerhouse.config.json). */
437
+ const connectRuntimeConfigSchema = connectConfigSchema.extend({
438
+ composition: z.array(connectCompositionEntrySchema).optional(),
439
+ instance: connectRuntimeInstanceSchema.optional(),
440
+ pwa: connectRuntimePwaSchema.optional()
441
+ });
442
+ //#endregion
443
+ export { connectAiSchema, connectAppSchema, connectBackgroundLayerSchema, connectBackgroundLayersSchema, connectBackgroundSchema, connectBrandingSchema, connectCompositionEntrySchema, connectConfigSchema, connectConfigSchemaWith, connectDefaultDriveLocalSchema, connectDefaultDriveRemoteSchema, connectDefaultDriveSchema, connectDrivePreserveStrategySchema, connectDriveSectionSchema, connectDriveSectionsSchema, connectDrivesSchema, connectEdgesSchema, connectExplorerIconsSchema, connectHomeSchema, connectImageRefSchema, connectInstanceSchema, connectLengthSchema, connectLoaderSchema, connectOpenPanelSchema, connectPackagesSchema, connectPwaCacheStrategySchema, connectPwaFileHandlerSchema, connectPwaIconSchema, connectPwaManifestSchema, connectPwaRuntimeCachingSchema, connectPwaSchema, connectPwaUrlPatternSchema, connectReactorClientModeSchema, connectReactorFeatureFlagsSchema, connectReactorSchema, connectRenownAdaptersSchema, connectRenownPrivyAdapterSchema, connectRenownRainbowAdapterSchema, connectRenownSchema, connectRuntimeConfigSchema, connectRuntimeInstanceSchema, connectRuntimePwaManifestSchema, connectRuntimePwaSchema, connectSchemedColorSchema, connectSchemedImageSchema, connectSentrySchema, declaredConnectConfigSchema };
444
+
445
+ //# sourceMappingURL=connect-config-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connect-config-schema.js","names":[],"sources":["../../connect/connect-config-schema.ts"],"sourcesContent":["// Single source of Connect's config (browser-safe, zod only). The PHConnect*\n// types (../clis/types.ts) and the JSON Schema fragments Ajv consumes\n// (./schema-fragments.ts) are derived from it.\n//\n// Never `.default(x)`: it fills values on parse; use `.meta({ default })`.\n// Never `.meta({ id })`: it emits `$defs`, whose refs break once the fragment\n// is embedded in another schema root.\n\nimport { z } from \"zod\";\nimport { tokenable, type TokenField } from \"../host-tokens/index.js\";\n\n// ---------------------------------------------------------------------------\n// Images, colours, lengths and backgrounds\n// ---------------------------------------------------------------------------\n\nconst IMAGE_REF =\n \"Image reference: a project-relative file path, a URL, or a data URI.\";\nconst IMAGE_REF_OR_DEFAULT =\n \"Image reference: a project-relative file path (resolved by the Connect build), a URL, or a data URI. null keeps the default.\";\n\n/** An image reference: a project-relative file path (the Connect build turns\n * it into a data URI or an emitted file), a URL, or a data URI. */\nexport const connectImageRefSchema = z.string().describe(IMAGE_REF);\n\n/** An image reference where `null` (or omitting it) keeps the default. */\nconst optionalImageRef = (description = IMAGE_REF_OR_DEFAULT) =>\n connectImageRefSchema.nullable().optional().describe(description);\n\n/** An image per colour scheme: one reference for both, or `{ light, dark }`\n * (`dark` falls back to `light`). */\nexport const connectSchemedImageSchema = z\n .union([\n connectImageRefSchema,\n z.strictObject({\n light: connectImageRefSchema,\n dark: connectImageRefSchema.nullable().optional(),\n }),\n ])\n .describe(\n \"One image for both colour schemes, or { light, dark } (dark falls back to light).\",\n );\n\n/** A CSS colour per colour scheme (`dark` falls back to `light`). */\nexport const connectSchemedColorSchema = z.union([\n z.string(),\n z.strictObject({\n light: z.string(),\n dark: z.string().nullable().optional(),\n }),\n]);\n\n/** A CSS length: a number is px, a string is passed through as written. */\nexport const connectLengthSchema = z.union([z.number(), z.string()]);\n\nconst optionalLength = () =>\n connectLengthSchema\n .nullable()\n .optional()\n .describe(\n 'A CSS length: a number is px; a string is used as written (\"40%\", \"min(55%, 880px)\", \"calc(50% - 120px)\").',\n );\n\n/** Distances to the four edges; each is optional. */\nexport const connectEdgesSchema = z.strictObject({\n top: optionalLength(),\n right: optionalLength(),\n bottom: optionalLength(),\n left: optionalLength(),\n});\n\n/** One image of a decorated pane, absolutely positioned inside it. */\nexport const connectBackgroundLayerSchema = z\n .strictObject({\n src: connectSchemedImageSchema,\n position: connectEdgesSchema\n .nullable()\n .optional()\n .describe(\n \"Distances to the pane's edges; at most one per axis. Omitted: centred both ways.\",\n ),\n width: optionalLength(),\n height: optionalLength(),\n minWidth: optionalLength(),\n minHeight: optionalLength(),\n maxWidth: optionalLength(),\n maxHeight: optionalLength(),\n opacity: z\n .number()\n .min(0)\n .max(1)\n .nullable()\n .optional()\n .describe(\"0 to 1 (default 1).\"),\n fade: connectEdgesSchema\n .nullable()\n .optional()\n .describe(\n \"Feather depth per edge, fading the layer into the page colour.\",\n ),\n })\n .describe(\n \"An image laid over the page, absolutely positioned: the edges set in `position` pin it, an axis with neither edge set is centred.\",\n );\n\n/** A decorated pane: the page colour and the images laid over it. */\nexport const connectBackgroundLayersSchema = z.strictObject({\n color: connectSchemedColorSchema\n .nullable()\n .optional()\n .describe(\n \"The page colour, or { light, dark }. Omitted or null: the theme's page background.\",\n ),\n layers: z\n .array(connectBackgroundLayerSchema)\n .describe(\"Painted in order; the first is at the back.\"),\n});\n\n/** A pane's background: layers over a page colour, or one image as\n * shorthand for a single layer pinned bottom-right. */\nexport const connectBackgroundSchema = z\n .union([connectImageRefSchema, connectBackgroundLayersSchema])\n .describe(\n \"Layered images over a page colour, or a single image pinned to the bottom-right corner. null keeps the default.\",\n );\n\n// ---------------------------------------------------------------------------\n// branding, home\n// ---------------------------------------------------------------------------\n\n/** The loading image and the motion applied to it. */\nexport const connectLoaderSchema = z.strictObject({\n src: connectImageRefSchema,\n animation: z\n .enum([\"pulse\", \"spin\", \"none\"])\n .nullable()\n .optional()\n .describe(\"Motion applied to the image (default pulse).\"),\n size: z\n .number()\n .min(16)\n .max(512)\n .nullable()\n .optional()\n .describe(\n \"Rendered width in CSS pixels (default 96); the height follows the image.\",\n ),\n});\n\n/** `connect.branding`: Connect's identity and look. */\nexport const connectBrandingSchema = z\n .strictObject({\n appName: z\n .string()\n .nullable()\n .optional()\n .describe(\n \"Browser tab title, installed-app name and in-app brand text. null or omitted: 'Powerhouse Connect'.\",\n ),\n icon: optionalImageRef(\n \"App icon master (1024x1024 PNG recommended, or an SVG). The favicons and installed-app icons are found next to it as <name>_16x16.png, _32x32, _64x64, _192x192 and _512x512; the 64 px one is the in-app logo. null or omitted: Connect's icon.\",\n ),\n favicon: z\n .string()\n .nullable()\n .optional()\n .describe(\n \"The browser tab icon: a file (.ico, .svg or .png) relative to the project, served and built as icon.ico. A build input; the built runtime config leaves it out. `ph connect build --favicon` wins over it.\",\n ),\n loader: z\n .union([connectImageRefSchema, connectLoaderSchema])\n .nullable()\n .optional()\n .describe(\n 'The loading image (first paint, app start, drive and editor loading). A path gets a gentle pulse; { src, animation, size } says otherwise, with animation \"none\" for an image that animates itself (animated SVG, GIF or WebP). null or omitted: Connect\\'s animated logo.',\n ),\n })\n .describe(\n \"App identity and visual branding. Every field is optional; null means the default.\",\n );\n\n/** `connect.home`: the home screen (the generic chrome's landing page). */\nexport const connectHomeSchema = z\n .strictObject({\n background: connectBackgroundSchema\n .nullable()\n .optional()\n .describe(\n \"The home screen's background: { color, layers } with each image positioned and sized, or one image pinned bottom-right. null or omitted: the bundled gradient.\",\n ),\n })\n .describe(\"The home screen (the generic chrome's landing page).\");\n\n// ---------------------------------------------------------------------------\n// app, ai, packages\n// ---------------------------------------------------------------------------\n\nexport const connectAppSchema = z\n .strictObject({\n logLevel: z.enum([\"debug\", \"info\", \"warn\", \"error\"]).optional().meta({\n description:\n \"Log level applied by Connect's logger at boot. Affects browser-side output only.\",\n default: \"info\",\n }),\n basePath: z.string().optional().meta({\n description:\n \"Base path Connect is mounted under (e.g. '/connect' for subpath deploys). Normalised at runtime to start and end with '/'. Defaults to the build-time BASE_URL.\",\n default: \"/\",\n }),\n offline: z.boolean().optional().meta({\n description:\n \"When true (default), the build emits a precaching service worker so Connect's app shell works offline, and the SPA registers it at boot. Set false to opt this deployment out: no service worker is built, the SPA skips registration, and any previously-installed worker is unregistered.\",\n default: true,\n }),\n studioMode: z.boolean().optional().meta({\n description:\n \"Studio mode. Enables builder-only capabilities: Connect loads the vetra package and exposes DocumentModel (and vetra spec types) as creatable documents. Forced on by `ph vetra` / `ph connect studio`; false by default.\",\n default: false,\n }),\n workflowsEnabled: z\n .boolean()\n .optional()\n .describe(\n \"Powerhouse workflows in Connect. When true the tab loads the @powerhousedao/workflow package (workflow + connection documents, their editors and Workflow Studio) and the reactor worker registers its document models. Falls back to the top-level `workflows.enabled`; set it to override that for Connect. Independent of studioMode. False when neither is set.\",\n ),\n })\n .describe(\"Top-level Connect application behaviour.\");\n\nexport const connectAiSchema = z\n .strictObject({\n assistantEnabled: z.boolean().optional().meta({\n description:\n \"When true, Connect mounts the in-browser AI assistant (bottom-right chat FAB that talks to a user-configured OpenAI-compatible endpoint and acts on the reactor). Disabled by default.\",\n default: false,\n }),\n })\n .describe(\"AI assistant (chat) behaviour.\");\n\nexport const connectPackagesSchema = z\n .strictObject({\n externalEnabled: z.boolean().optional().meta({\n description:\n \"When false, Connect refuses to load any package that wasn't bundled at build time. Affirmative replacement for the legacy PH_CONNECT_EXTERNAL_PACKAGES_DISABLED env var.\",\n default: true,\n }),\n liveReload: z.boolean().optional().meta({\n description:\n \"When true, Connect subscribes to the static-mode `/__packages` SSE channel so live publishes flow into the running tab without a page reload. Only works under hosting that serves this channel (e.g. ph-clint static mode).\",\n default: false,\n }),\n })\n .describe(\n \"Runtime behaviour for the Connect package manager (separate from top-level `packages[]`, which lists which packages to load).\",\n );\n\n// ---------------------------------------------------------------------------\n// drives\n// ---------------------------------------------------------------------------\n\nconst EXPLORER_ICONS_DESCRIPTION =\n \"The drive explorer's icons (the generic plugin's); each null keeps the built-in icon.\";\n\n/** The drive explorer's icons: the generic chrome's, owned by the generic\n * plugin. Each `null` keeps the built-in icon. */\nexport const connectExplorerIconsSchema = z\n .strictObject({\n localDrive: optionalImageRef(\"Local drives without an icon of their own.\"),\n remoteDrive: optionalImageRef(\n \"Remote drives without an icon of their own.\",\n ),\n folder: optionalImageRef(\"Folders.\"),\n document: optionalImageRef(\n \"Documents whose type has no icon in `documents`.\",\n ),\n documents: z\n .record(z.string(), connectImageRefSchema)\n .nullable()\n .optional()\n .describe('Per document type, e.g. \"acme/invoice\".'),\n })\n .describe(EXPLORER_ICONS_DESCRIPTION);\n\nexport const connectDefaultDriveRemoteSchema = z.strictObject({\n url: z.string(),\n name: z.string().nullable().optional(),\n icon: z.string().nullable().optional(),\n});\n\nexport const connectDefaultDriveLocalSchema = z.strictObject({\n local: z\n .literal(true)\n .describe(\n \"Discriminator: this entry is a local drive created on first boot.\",\n ),\n id: z\n .string()\n .describe(\n \"Stable drive id. The drive is created with this id on first boot and is not re-created on later boots.\",\n ),\n name: z.string().nullable().optional(),\n icon: z.string().nullable().optional(),\n app: z\n .string()\n .optional()\n .describe(\"Drive app (preferred editor) to open on the drive.\"),\n});\n\nexport const connectDefaultDriveSchema = z.union([\n connectDefaultDriveRemoteSchema,\n connectDefaultDriveLocalSchema,\n]);\n\n/** `connect.drives.sections.{remote,local}`: three affirmative toggles. */\nexport const connectDriveSectionSchema = z\n .strictObject({\n enabled: z.boolean().optional().meta({\n description: \"When false, the section is hidden in the sidebar.\",\n default: true,\n }),\n allowAdd: z.boolean().optional().meta({\n description:\n \"When false, the section's 'add drive' affordance is hidden.\",\n default: true,\n }),\n allowDelete: z.boolean().optional().meta({\n description:\n \"When false, drives in this section cannot be deleted from the UI.\",\n default: true,\n }),\n })\n .describe(\n \"Visibility and add/delete affordances for a drive section in the sidebar.\",\n );\n\nexport const connectDriveSectionsSchema = z\n .strictObject({\n remote: connectDriveSectionSchema.optional(),\n local: connectDriveSectionSchema.optional(),\n })\n .describe(\n \"Per-section visibility and affordance toggles. `remote` covers what was historically split into 'public' + 'cloud'; `local` is browser-local drives.\",\n );\n\n/** Mirrors DRIVES_PRESERVE_STRATEGIES (../clis/constants.ts, which imports\n * node: modules, so it is not imported here); a test pins the two. */\nexport const connectDrivePreserveStrategySchema = z.enum([\n \"preserve-all\",\n \"preserve-by-url-and-detach\",\n]);\n\nexport const connectDrivesSchema = z\n .strictObject({\n allowAddDrive: z.boolean().optional().meta({\n description:\n \"When false, the SPA hides the 'add drive' affordance entirely (top-level). Per-section overrides live in `sections.{remote,local}.allowAdd`.\",\n default: true,\n }),\n defaultDrives: z.array(connectDefaultDriveSchema).optional().meta({\n description:\n \"Drives the SPA auto-connects to on first load. Each entry is either a remote drive (a URL, with optional name/icon overrides) or a local drive (created locally on first boot, with a stable id and optional name/icon/app).\",\n default: [],\n }),\n preserveStrategy: connectDrivePreserveStrategySchema\n .optional()\n .describe(\n \"Strategy applied when defaultDrives change between deploys. 'preserve-all' keeps user-added drives untouched; 'preserve-by-url-and-detach' detaches removed default drives. No schema default — opt-in only.\",\n ),\n sections: connectDriveSectionsSchema.optional(),\n icons: connectExplorerIconsSchema\n .nullable()\n .optional()\n .describe(EXPLORER_ICONS_DESCRIPTION),\n })\n .describe(\"Default-drive and add-drive UI behaviour.\");\n\n// ---------------------------------------------------------------------------\n// renown, sentry, openPanel\n// ---------------------------------------------------------------------------\n\nexport const connectRenownRainbowAdapterSchema = z\n .strictObject({\n walletConnectProjectId: z\n .string()\n .optional()\n .describe(\n \"WalletConnect project id; required for this adapter to function.\",\n ),\n infuraProjectId: z\n .string()\n .optional()\n .describe(\"Optional Infura project id used to build RPC transports.\"),\n })\n .describe(\"wagmi + RainbowKit external-wallet adapter config.\");\n\nexport const connectRenownPrivyAdapterSchema = z\n .strictObject({\n appId: z\n .string()\n .optional()\n .describe(\"Privy application id; required for this adapter to function.\"),\n clientId: z.string().optional().describe(\"Optional Privy client id.\"),\n methods: z\n .array(z.string())\n .optional()\n .describe(\n \"Login methods this adapter offers; default per adapter when omitted.\",\n ),\n })\n .describe(\"Privy embedded/social adapter config.\");\n\nexport const connectRenownAdaptersSchema = z\n .strictObject({\n rainbow: connectRenownRainbowAdapterSchema.optional(),\n privy: connectRenownPrivyAdapterSchema.optional(),\n })\n .describe(\n \"Per-adapter wallet config for in-page auth. Presence of an adapter key enables it; omit or leave empty for redirect-only behaviour.\",\n );\n\nexport const connectRenownSchema = z\n .strictObject({\n url: z.string().optional().meta({\n description: \"Renown auth service URL.\",\n default: \"https://www.renown.id\",\n }),\n networkId: z.string().optional().meta({\n description: \"CAIP-2 network namespace (e.g. 'eip155').\",\n default: \"eip155\",\n }),\n chainId: z.number().optional().meta({\n description: \"CAIP-2 chain reference within the network namespace.\",\n default: 1,\n }),\n namespace: z\n .string()\n .optional()\n .describe(\n \"Renown localStorage namespace; share it across Connects to share login.\",\n ),\n switchboardUrl: z\n .string()\n .optional()\n .describe(\n \"Switchboard GraphQL URL. When set, Connect enables in-page (no-redirect) Renown sign-in; otherwise it falls back to the redirect flow via `url`.\",\n ),\n adapters: connectRenownAdaptersSchema.optional(),\n })\n .describe(\"Renown identity / authentication coordinates.\");\n\nexport const connectSentrySchema = z\n .strictObject({\n dsn: z.string().nullable().optional().meta({\n description:\n \"Sentry DSN URL. `null` disables Sentry entirely; the SPA never loads the Sentry SDK chunk.\",\n default: null,\n }),\n env: z.string().optional().meta({\n description:\n \"Sentry environment label, surfaced as the `environment` tag on every event.\",\n default: \"dev\",\n }),\n tracing: z.boolean().optional().meta({\n description: \"Enable Sentry performance tracing.\",\n default: false,\n }),\n })\n .describe(\n \"Sentry error-tracking coordinates. Set `dsn` to enable Sentry; leave `dsn` null to disable. The Sentry release tag stays build-time (stamped via Vite's `define` from WORKSPACE_VERSION) so it always matches the sourcemaps uploaded by CI.\",\n );\n\nexport const connectOpenPanelSchema = z\n .strictObject({\n clientId: z.string().optional().meta({\n description:\n \"OpenPanel client id. Empty string disables OpenPanel entirely.\",\n default: \"\",\n }),\n apiUrl: z\n .string()\n .optional()\n .describe(\n \"OpenPanel API URL for self-hosted instances (e.g. 'https://openpanel.example/api'). Omit to use OpenPanel's hosted API.\",\n ),\n trackUiEvents: z.boolean().optional().meta({\n description: \"Track UI events.\",\n default: true,\n }),\n trackOperations: z.boolean().optional().meta({\n description: \"Track document operations.\",\n default: true,\n }),\n })\n .describe(\n \"OpenPanel product analytics. Set `clientId` to enable; an empty `clientId` disables it. Events are only sent after the user accepts analytics cookies. Takes precedence over the build-time PH_CONNECT_OPENPANEL_* env vars.\",\n );\n\n// ---------------------------------------------------------------------------\n// instance, reactor\n// ---------------------------------------------------------------------------\n\n/** Which reactor client Connect runs (see PHReactorClientMode). */\nexport const connectReactorClientModeSchema = z.enum([\n \"in-process\",\n \"worker\",\n \"remote\",\n \"router\",\n]);\n\nexport const connectInstanceSchema = z\n .strictObject({\n namespace: z.string().nullable().meta({\n description:\n \"Explicit storage/SharedWorker namespace for this instance. `null` derives it from the base path (and, later, the configured endpoint), so root deployments stay byte-identical.\",\n default: null,\n }),\n reactorWorker: z.boolean().meta({\n description:\n \"Host the reactor in a shared worker instead of on the main thread. Off by default; the main-thread reactor stays the proven path until cutover is verified. Packaged deployments load the worker from the prebuilt bundle `ph connect build` emits under __reactor_worker__/ (the dev server builds it lazily at the same path); when that bundle is absent the feature reports itself unavailable instead of starting a worker that cannot load.\",\n default: false,\n }),\n multiReactor: z.boolean().optional().meta({\n description:\n \"Opt-in multi-reactor routing. When on, Connect routes through the in-browser reactor plus remote backends instead of the single in-browser reactor. Off by default; the single-reactor path is unchanged.\",\n default: false,\n }),\n })\n .describe(\n \"Per-instance identity. Lets one origin host multiple isolated Connect instances, each with its own storage + SharedWorker namespace.\",\n );\n\nexport const connectReactorFeatureFlagsSchema = z\n .strictObject({\n documentDecisions: z.boolean().optional().meta({\n description:\n \"Decide writes from the document stream rather than the document meta cache, so a backdated deletion denies the operations that sort after it.\",\n default: false,\n }),\n authEnforcement: z.boolean().optional().meta({\n description:\n \"Enforce the auth scope's policy at admission, replay, and read. Requires documentDecisions.\",\n default: false,\n }),\n authGroups: z.boolean().optional().meta({\n description:\n \"Let `{ group }` principals match against the rosters of the group documents a policy names. Requires authEnforcement.\",\n default: false,\n }),\n authConditions: z.boolean().optional().meta({\n description:\n \"Evaluate `where` and `match` conditions on grants. Requires authGroups. Do not enable on a fleet `preflight:auth` reports as crossing a reducer version.\",\n default: false,\n }),\n })\n .describe(\n \"Enforcement flags. Each implies its predecessors, and the reactor refuses to boot on a set that names a later flag without an earlier one. These are consensus settings: a Connect syncing with a fleet must carry the same flags the fleet does, or the two reach different replay outcomes for the same history and diverge.\",\n );\n\nexport const connectReactorSchema = z\n .strictObject({\n featureFlags: connectReactorFeatureFlagsSchema.optional(),\n createSignaturePolicy: z.enum([\"legacy\", \"v2-required\"]).optional().meta({\n description:\n \"What new documents are created as. `v2-required` documents accept only v2 action signatures and take content-addressed ids; set `legacy` while any peer Connect syncs with predates them. Existing documents keep their policy.\",\n default: \"v2-required\",\n }),\n unsupportedStoredDocuments: z\n .enum([\"refuse\", \"read-only\"])\n .optional()\n .meta({\n description:\n \"What the reactor does when this browser's store holds documents at protocol versions this build does not run. `refuse` fails the boot and names the versions; `read-only` boots and keeps those documents read-only.\",\n default: \"refuse\",\n }),\n })\n .describe(\n \"Settings for the reactor Connect runs in the browser, on the main thread or in the shared worker alike.\",\n );\n\n// ---------------------------------------------------------------------------\n// pwa\n// ---------------------------------------------------------------------------\n\n/** A runtime-caching / denylist URL match. A string is handed to Workbox\n * verbatim; `{ source, flags }` is rebuilt into a RegExp at build time. */\nexport const connectPwaUrlPatternSchema = z\n .union([\n z.string(),\n z\n .strictObject({\n source: z.string().describe(\"RegExp source.\"),\n flags: z.string().optional().describe(\"RegExp flags (e.g. 'i').\"),\n })\n // Not expressible in JSON Schema, so only the zod path checks it.\n .refine(\n (p) => {\n try {\n new RegExp(p.source, p.flags);\n return true;\n } catch {\n return false;\n }\n },\n { message: \"source/flags do not compile to a valid RegExp\" },\n ),\n ])\n .describe(\n \"URL match. A string is matched verbatim by Workbox; { source, flags } is rebuilt into a RegExp at build time.\",\n );\n\nexport const connectPwaCacheStrategySchema = z.enum([\n \"CacheFirst\",\n \"CacheOnly\",\n \"NetworkFirst\",\n \"NetworkOnly\",\n \"StaleWhileRevalidate\",\n]);\n\n/** Serialisable subset of a Workbox `RuntimeCaching` rule. */\nexport const connectPwaRuntimeCachingSchema = z.strictObject({\n urlPattern: connectPwaUrlPatternSchema,\n handler: connectPwaCacheStrategySchema,\n method: z.enum([\"GET\", \"POST\", \"PUT\", \"DELETE\", \"HEAD\", \"PATCH\"]).optional(),\n options: z\n .strictObject({\n cacheName: z.string().optional(),\n networkTimeoutSeconds: z\n .number()\n .optional()\n .describe(\n \"Seconds a NetworkFirst rule waits for the network before falling back to the cache.\",\n ),\n expiration: z\n .strictObject({\n maxEntries: z.number().optional(),\n maxAgeSeconds: z.number().optional(),\n })\n .optional(),\n cacheableResponse: z\n .strictObject({\n statuses: z.array(z.number()).optional(),\n headers: z.record(z.string(), z.string()).optional(),\n })\n .optional(),\n })\n .optional(),\n});\n\nexport const connectPwaIconSchema = z.strictObject({\n src: z.string(),\n sizes: z.string().optional(),\n type: z.string().optional(),\n purpose: z.string().optional(),\n});\n\n/** A File Handling API entry. No `action`: every handler opens at Connect's\n * app root, because consuming launched files needs Connect's own code. */\nexport const connectPwaFileHandlerSchema = z.strictObject({\n accept: z\n .record(\n z.string(),\n z.array(z.string().regex(/^\\./, \"file extensions must start with '.'\")),\n )\n .describe(\n \"MIME type → file extensions. Each extension must start with '.'; browsers ignore entries without it.\",\n ),\n icons: z\n .array(connectPwaIconSchema)\n .optional()\n .describe(\"OS-level file-type icons.\"),\n launch_type: z.enum([\"single-client\", \"multiple-clients\"]).optional(),\n});\n\n/** Web-app-manifest fields a package or project may override. */\nexport const connectPwaManifestSchema = z\n .strictObject({\n name: z.string().optional(),\n short_name: z.string().optional(),\n description: z.string().optional(),\n theme_color: z.string().optional(),\n background_color: z.string().optional(),\n display: z\n .enum([\"fullscreen\", \"standalone\", \"minimal-ui\", \"browser\"])\n .optional(),\n start_url: z.string().optional(),\n scope: z.string().optional(),\n icons: z\n .array(connectPwaIconSchema)\n .optional()\n .describe(\n \"Icons appended to the built-in set and de-duplicated by (src, sizes, purpose).\",\n ),\n file_handlers: z\n .array(connectPwaFileHandlerSchema)\n .optional()\n .describe(\n \"File associations appended after Connect's built-in .phd/.phdm handler and de-duplicated on the whole entry. Entries only declare accepted types; there is no action field, because opening the files requires Connect's own runtime handling, so every handler opens at the app root.\",\n ),\n launch_handler: z\n .strictObject({\n client_mode: z.enum([\n \"auto\",\n \"focus-existing\",\n \"navigate-existing\",\n \"navigate-new\",\n ]),\n })\n .optional()\n .describe(\n \"How the OS launches the app for handled files/links. Connect defaults to focus-existing.\",\n ),\n })\n .describe(\"Web-app-manifest field overrides.\");\n\nconst pwaShape = {\n globPatterns: z\n .array(z.string())\n .optional()\n .describe(\"Extra Workbox precache globs, unioned with the built-ins.\"),\n globIgnores: z\n .array(z.string())\n .optional()\n .describe(\"Extra precache ignore globs, unioned with the built-ins.\"),\n maximumFileSizeToCacheInBytes: z\n .number()\n .optional()\n .describe(\n \"Raise the precache file-size ceiling. The max across all contributors wins, so no contributor can shrink another's limit.\",\n ),\n runtimeCaching: z\n .array(connectPwaRuntimeCachingSchema)\n .optional()\n .describe(\n \"Runtime-caching rules appended after the built-in rules. Workbox is first-match-wins, so these cannot override a built-in rule matching the same URL.\",\n ),\n navigateFallbackDenylist: z\n .array(connectPwaUrlPatternSchema)\n .optional()\n .describe(\n \"Extra SPA navigate-fallback denylist patterns, unioned with the built-ins.\",\n ),\n};\n\nconst PWA_DESCRIPTION =\n \"Progressive-web-app / service-worker overrides, layered on Connect's built-in PWA defaults at build time. Scalar fields deep-merge (this layer wins); the array members (icons, file_handlers, globs, runtimeCaching and denylist patterns) are additive; maximumFileSizeToCacheInBytes takes the max across contributors. (categories is not set here — it is derived from the manifest's category field.) Only applied when connect.app.offline is true.\";\n\n/** `connect.pwa` as authored. */\nexport const connectPwaSchema = z\n .strictObject({ manifest: connectPwaManifestSchema.optional(), ...pwaShape })\n .describe(PWA_DESCRIPTION);\n\n// ---------------------------------------------------------------------------\n// The connect block\n// ---------------------------------------------------------------------------\n\n/**\n * The `connect` block as authored: powerhouse.config.json's `connect`, the\n * connect host's `config`, and `ph connect config` writes. Every field is\n * optional; omit the section entirely for default behaviour.\n */\nexport const connectConfigSchema = z\n .strictObject({\n branding: connectBrandingSchema.optional(),\n home: connectHomeSchema.optional(),\n app: connectAppSchema.optional(),\n ai: connectAiSchema.optional(),\n packages: connectPackagesSchema.optional(),\n drives: connectDrivesSchema.optional(),\n renown: connectRenownSchema.optional(),\n sentry: connectSentrySchema.optional(),\n openPanel: connectOpenPanelSchema.optional(),\n instance: connectInstanceSchema.optional(),\n reactor: connectReactorSchema.optional(),\n pwa: connectPwaSchema.optional(),\n })\n .describe(\n \"Connect-specific UI customisations. All fields optional; omit the section entirely for default behaviour.\",\n );\n\nexport type ConnectConfig = z.output<typeof connectConfigSchema>;\nexport type ConnectConfigInput = z.input<typeof connectConfigSchema>;\n\n// ---------------------------------------------------------------------------\n// The declared form: a connect host's `config`\n// ---------------------------------------------------------------------------\n\n/** `schema` carrying `source`'s description and meta (zod keeps them per\n * instance, so `.extend()` and a rebuilt field drop them). */\nfunction withMetaOf<S extends z.ZodType>(schema: S, source: z.ZodType): S {\n const meta = source.meta();\n return meta ? schema.meta(meta) : schema;\n}\n\n/**\n * The `connect` block with its token-able fields wrapped by `field`: the\n * fields that name another host's outputs, which a connect host's `config`\n * may write as output tokens (`ph run` resolves them before the verb).\n *\n * - `drives.defaultDrives[].url` (a remote entry): e.g. a switchboard's\n * `drives.<slug>.url` output.\n * - `renown.switchboardUrl`: a switchboard's `endpoints.graphql` output.\n *\n * The connect runner builds it with host-core's `s.tokenable` (declared:\n * tokens in; resolved: plain values only). The output type is\n * {@link ConnectConfig} either way. powerhouse.config.json's `connect` block,\n * the served config and their JSON Schemas stay {@link connectConfigSchema},\n * which takes no tokens.\n */\nexport function connectConfigSchemaWith(field: TokenField) {\n const remoteDrive = connectDefaultDriveRemoteSchema.extend({\n url: field(z.string()),\n });\n const shape = connectDrivesSchema.shape;\n const drives = withMetaOf(\n connectDrivesSchema.extend({\n defaultDrives: withMetaOf(\n z\n .array(z.union([remoteDrive, connectDefaultDriveLocalSchema]))\n .optional(),\n shape.defaultDrives,\n ),\n }),\n connectDrivesSchema,\n );\n const renown = withMetaOf(\n connectRenownSchema.extend({\n switchboardUrl: withMetaOf(\n field(z.string()).optional(),\n connectRenownSchema.shape.switchboardUrl,\n ),\n }),\n connectRenownSchema,\n );\n return withMetaOf(\n connectConfigSchema.extend({\n drives: drives.optional(),\n renown: renown.optional(),\n }),\n connectConfigSchema,\n );\n}\n\n/** The declared `connect` block: {@link connectConfigSchemaWith} with every\n * token accepted in its token-able fields. */\nexport const declaredConnectConfigSchema =\n /* @__PURE__ */ connectConfigSchemaWith(tokenable);\n\n/** What a connect host's `config` may hold (tokens in token-able fields). */\nexport type DeclaredConnectConfigInput = z.input<\n typeof declaredConnectConfigSchema\n>;\n\n// ---------------------------------------------------------------------------\n// The served runtime config: authored fields plus what is derived or\n// projected. These fields are never authored, so the authored schema (and\n// the JSON Schema fragment emitted from it) rejects them.\n// ---------------------------------------------------------------------------\n\n/** One entry of the host.js composition, projected into the served config as\n * data (module specifier + validated config). */\nexport const connectCompositionEntrySchema = z.strictObject({\n module: z.string(),\n config: z.record(z.string(), z.unknown()).optional(),\n});\n\n/** `instance` plus `reactorClient`, derived from the host's reactor backends. */\nexport const connectRuntimeInstanceSchema = connectInstanceSchema.extend({\n reactorClient: connectReactorClientModeSchema.optional(),\n});\n\n/** The manifest plus `categories`, derived from contributors' `category`. */\nexport const connectRuntimePwaManifestSchema = connectPwaManifestSchema.extend({\n categories: z.array(z.string()).optional(),\n});\n\nexport const connectRuntimePwaSchema = connectPwaSchema.extend({\n manifest: connectRuntimePwaManifestSchema.optional(),\n});\n\n/** The served `connect` block (runtime powerhouse.config.json). */\nexport const connectRuntimeConfigSchema = connectConfigSchema.extend({\n composition: z.array(connectCompositionEntrySchema).optional(),\n instance: connectRuntimeInstanceSchema.optional(),\n pwa: connectRuntimePwaSchema.optional(),\n});\n\nexport type ConnectRuntimeConfig = z.output<typeof connectRuntimeConfigSchema>;\n"],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ //#region connect/image-ref.d.ts
2
+ /** A reference that is already usable by the browser (URL or data URI). */
3
+ export declare function isPassthroughImageRef(ref: string): boolean;
4
+ /** The media type an image file's extension implies, if supported. */
5
+ export declare function imageMimeType(file: string): string | undefined;
6
+ /** The favicon sizes found next to an app icon master by naming convention. */
7
+ export declare const APP_ICON_VARIANT_SIZES: readonly [16, 32, 64];
8
+ /** The installed-app (web manifest) sizes, by the same convention. */
9
+ export declare const PWA_ICON_VARIANT_SIZES: readonly [192, 512];
10
+ /** Drive icons live in synced document state: keep them small. */
11
+ export declare const DRIVE_ICON_MAX_BYTES: number;
12
+ /** UI icons embedded in the runtime config: generous, but not a 1 MB master. */
13
+ export declare const UI_ICON_MAX_BYTES: number;
14
+ /** A background image is fetched once with the runtime config. */
15
+ export declare const BACKGROUND_MAX_BYTES: number;
16
+ export interface ImageRefOptions {
17
+ /** Refuse files larger than this (bytes). */
18
+ maxBytes?: number;
19
+ /** Where warnings go (missing files, oversize, unsupported type). */
20
+ warn?: (message: string) => void;
21
+ }
22
+ /**
23
+ * A project-relative path → data URI; URLs and data URIs unchanged; a
24
+ * missing, unsupported or oversize file → undefined (with a warning), so a
25
+ * bad image never breaks a boot or a build.
26
+ */
27
+ export declare function resolveImageRef(projectRoot: string, ref: string | undefined | null, options?: ImageRefOptions): string | undefined;
28
+ /** The `<name>_<n>x<n>.<ext>` sibling of a master, if it exists. */
29
+ export declare function iconVariantPath(projectRoot: string, master: string, size: number): string | undefined;
30
+ //#endregion
31
+ export {};
32
+ //# sourceMappingURL=image-ref.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"image-ref.d.ts","names":[],"sources":["../../connect/image-ref.ts"],"mappings":";;wBAwBgB,sBAAsB;;wBAKtB,cAAc;;qBAKjB;;qBAEA;;qBAGA;;qBAEA;;qBAEA;iBAEI;;EAEf;;EAEA,QAAQ;;;;;;;wBAQM,gBACd,qBACA,gCACA,UAAS;;wBA2BK,gBACd,qBACA,gBACA"}