skybridge 0.0.0-dev.e28afb2 → 0.0.0-dev.e28f13b

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 (447) hide show
  1. package/README.md +125 -124
  2. package/dist/cli/build-helpers.d.ts +11 -0
  3. package/dist/cli/build-helpers.js +107 -0
  4. package/dist/cli/build-helpers.js.map +1 -0
  5. package/dist/cli/build-helpers.test.js +130 -0
  6. package/dist/cli/build-helpers.test.js.map +1 -0
  7. package/dist/cli/build-steps.d.ts +2 -0
  8. package/dist/cli/build-steps.js +73 -0
  9. package/dist/cli/build-steps.js.map +1 -0
  10. package/dist/cli/build-steps.test.js +52 -0
  11. package/dist/cli/build-steps.test.js.map +1 -0
  12. package/dist/cli/detect-port.d.ts +2 -2
  13. package/dist/cli/detect-port.js +9 -20
  14. package/dist/cli/detect-port.js.map +1 -1
  15. package/dist/cli/header.d.ts +1 -1
  16. package/dist/cli/header.js.map +1 -1
  17. package/dist/cli/resolve-skybridge-config.d.ts +5 -0
  18. package/dist/cli/resolve-skybridge-config.js +18 -0
  19. package/dist/cli/resolve-skybridge-config.js.map +1 -0
  20. package/dist/cli/run-command.js.map +1 -1
  21. package/dist/cli/run-plain.d.ts +18 -0
  22. package/dist/cli/run-plain.js +89 -0
  23. package/dist/cli/run-plain.js.map +1 -0
  24. package/dist/cli/telemetry.js.map +1 -1
  25. package/dist/cli/tunnel-control-server.d.ts +9 -0
  26. package/dist/cli/tunnel-control-server.js +31 -0
  27. package/dist/cli/tunnel-control-server.js.map +1 -0
  28. package/dist/cli/tunnel-control-server.test.js +39 -0
  29. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  30. package/dist/cli/tunnel-handler.d.ts +3 -0
  31. package/dist/cli/tunnel-handler.js +48 -0
  32. package/dist/cli/tunnel-handler.js.map +1 -0
  33. package/dist/cli/tunnel-handler.test.d.ts +1 -0
  34. package/dist/cli/tunnel-handler.test.js +105 -0
  35. package/dist/cli/tunnel-handler.test.js.map +1 -0
  36. package/dist/cli/tunnel.d.ts +57 -0
  37. package/dist/cli/tunnel.js +154 -0
  38. package/dist/cli/tunnel.js.map +1 -0
  39. package/dist/cli/tunnel.test.d.ts +1 -0
  40. package/dist/cli/tunnel.test.js +190 -0
  41. package/dist/cli/tunnel.test.js.map +1 -0
  42. package/dist/cli/types.js.map +1 -1
  43. package/dist/cli/use-execute-steps.js.map +1 -1
  44. package/dist/cli/use-messages.js.map +1 -1
  45. package/dist/cli/use-nodemon.d.ts +14 -0
  46. package/dist/cli/use-nodemon.js +72 -52
  47. package/dist/cli/use-nodemon.js.map +1 -1
  48. package/dist/cli/use-open-browser.d.ts +1 -0
  49. package/dist/cli/use-open-browser.js +44 -0
  50. package/dist/cli/use-open-browser.js.map +1 -0
  51. package/dist/cli/use-tunnel.d.ts +1 -1
  52. package/dist/cli/use-tunnel.js +102 -68
  53. package/dist/cli/use-tunnel.js.map +1 -1
  54. package/dist/cli/use-typescript-check.d.ts +9 -2
  55. package/dist/cli/use-typescript-check.js +89 -51
  56. package/dist/cli/use-typescript-check.js.map +1 -1
  57. package/dist/commands/build.d.ts +0 -3
  58. package/dist/commands/build.js +3 -18
  59. package/dist/commands/build.js.map +1 -1
  60. package/dist/commands/create.d.ts +9 -0
  61. package/dist/commands/create.js +30 -0
  62. package/dist/commands/create.js.map +1 -0
  63. package/dist/commands/dev.d.ts +2 -0
  64. package/dist/commands/dev.js +81 -2
  65. package/dist/commands/dev.js.map +1 -1
  66. package/dist/commands/start.js +8 -7
  67. package/dist/commands/start.js.map +1 -1
  68. package/dist/commands/telemetry/disable.js.map +1 -1
  69. package/dist/commands/telemetry/enable.js.map +1 -1
  70. package/dist/commands/telemetry/status.js.map +1 -1
  71. package/dist/server/asset-base-url-transform-plugin.d.ts +1 -0
  72. package/dist/server/asset-base-url-transform-plugin.js +17 -2
  73. package/dist/server/asset-base-url-transform-plugin.js.map +1 -1
  74. package/dist/server/asset-base-url-transform-plugin.test.js +80 -1
  75. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -1
  76. package/dist/server/auth/discovery.d.ts +32 -0
  77. package/dist/server/auth/discovery.js +56 -0
  78. package/dist/server/auth/discovery.js.map +1 -0
  79. package/dist/server/auth/discovery.test.d.ts +1 -0
  80. package/dist/server/auth/discovery.test.js +93 -0
  81. package/dist/server/auth/discovery.test.js.map +1 -0
  82. package/dist/server/auth/index.d.ts +18 -0
  83. package/dist/server/auth/index.js +2 -0
  84. package/dist/server/auth/index.js.map +1 -0
  85. package/dist/server/auth/providers/auth0.d.ts +18 -0
  86. package/dist/server/auth/providers/auth0.js +31 -0
  87. package/dist/server/auth/providers/auth0.js.map +1 -0
  88. package/dist/server/auth/providers/auth0.test.d.ts +1 -0
  89. package/dist/server/auth/providers/auth0.test.js +48 -0
  90. package/dist/server/auth/providers/auth0.test.js.map +1 -0
  91. package/dist/server/auth/providers/authplane.d.ts +47 -0
  92. package/dist/server/auth/providers/authplane.js +57 -0
  93. package/dist/server/auth/providers/authplane.js.map +1 -0
  94. package/dist/server/auth/providers/authplane.test.d.ts +1 -0
  95. package/dist/server/auth/providers/authplane.test.js +138 -0
  96. package/dist/server/auth/providers/authplane.test.js.map +1 -0
  97. package/dist/server/auth/providers/clerk.d.ts +14 -0
  98. package/dist/server/auth/providers/clerk.js +16 -0
  99. package/dist/server/auth/providers/clerk.js.map +1 -0
  100. package/dist/server/auth/providers/clerk.test.d.ts +1 -0
  101. package/dist/server/auth/providers/clerk.test.js +28 -0
  102. package/dist/server/auth/providers/clerk.test.js.map +1 -0
  103. package/dist/server/auth/providers/custom.d.ts +32 -0
  104. package/dist/server/auth/providers/custom.js +49 -0
  105. package/dist/server/auth/providers/custom.js.map +1 -0
  106. package/dist/server/auth/providers/custom.test.d.ts +1 -0
  107. package/dist/server/auth/providers/custom.test.js +156 -0
  108. package/dist/server/auth/providers/custom.test.js.map +1 -0
  109. package/dist/server/auth/providers/descope.d.ts +15 -0
  110. package/dist/server/auth/providers/descope.js +44 -0
  111. package/dist/server/auth/providers/descope.js.map +1 -0
  112. package/dist/server/auth/providers/descope.test.d.ts +1 -0
  113. package/dist/server/auth/providers/descope.test.js +60 -0
  114. package/dist/server/auth/providers/descope.test.js.map +1 -0
  115. package/dist/server/auth/providers/shared.d.ts +2 -0
  116. package/dist/server/auth/providers/shared.js +6 -0
  117. package/dist/server/auth/providers/shared.js.map +1 -0
  118. package/dist/server/auth/providers/shared.test.d.ts +1 -0
  119. package/dist/server/auth/providers/shared.test.js +10 -0
  120. package/dist/server/auth/providers/shared.test.js.map +1 -0
  121. package/dist/server/auth/providers/stytch.d.ts +12 -0
  122. package/dist/server/auth/providers/stytch.js +13 -0
  123. package/dist/server/auth/providers/stytch.js.map +1 -0
  124. package/dist/server/auth/providers/workos.d.ts +11 -0
  125. package/dist/server/auth/providers/workos.js +12 -0
  126. package/dist/server/auth/providers/workos.js.map +1 -0
  127. package/dist/server/auth/security-schemes.d.ts +23 -0
  128. package/dist/server/auth/security-schemes.js +64 -0
  129. package/dist/server/auth/security-schemes.js.map +1 -0
  130. package/dist/server/auth/security-schemes.test.d.ts +1 -0
  131. package/dist/server/auth/security-schemes.test.js +99 -0
  132. package/dist/server/auth/security-schemes.test.js.map +1 -0
  133. package/dist/server/auth/setup.d.ts +6 -0
  134. package/dist/server/auth/setup.js +92 -0
  135. package/dist/server/auth/setup.js.map +1 -0
  136. package/dist/server/auth/setup.test.d.ts +1 -0
  137. package/dist/server/auth/setup.test.js +474 -0
  138. package/dist/server/auth/setup.test.js.map +1 -0
  139. package/dist/server/auth/verify.d.ts +12 -0
  140. package/dist/server/auth/verify.js +38 -0
  141. package/dist/server/auth/verify.js.map +1 -0
  142. package/dist/server/auth/verify.test.d.ts +1 -0
  143. package/dist/server/auth/verify.test.js +100 -0
  144. package/dist/server/auth/verify.test.js.map +1 -0
  145. package/dist/server/auth.d.ts +20 -0
  146. package/dist/server/auth.js +28 -0
  147. package/dist/server/auth.js.map +1 -0
  148. package/dist/server/build-manifest.test.d.ts +1 -0
  149. package/dist/server/build-manifest.test.js +27 -0
  150. package/dist/server/build-manifest.test.js.map +1 -0
  151. package/dist/server/content-helpers.d.ts +67 -0
  152. package/dist/server/content-helpers.js +79 -0
  153. package/dist/server/content-helpers.js.map +1 -0
  154. package/dist/server/content-helpers.test.d.ts +1 -0
  155. package/dist/server/content-helpers.test.js +70 -0
  156. package/dist/server/content-helpers.test.js.map +1 -0
  157. package/dist/server/express.d.ts +1 -5
  158. package/dist/server/express.js +34 -10
  159. package/dist/server/express.js.map +1 -1
  160. package/dist/server/express.test.js +310 -71
  161. package/dist/server/express.test.js.map +1 -1
  162. package/dist/server/file-ref.d.ts +28 -0
  163. package/dist/server/file-ref.js +27 -0
  164. package/dist/server/file-ref.js.map +1 -0
  165. package/dist/server/host.d.ts +2 -0
  166. package/dist/server/host.js +11 -0
  167. package/dist/server/host.js.map +1 -0
  168. package/dist/server/host.test.d.ts +1 -0
  169. package/dist/server/host.test.js +13 -0
  170. package/dist/server/host.test.js.map +1 -0
  171. package/dist/server/index.d.ts +15 -3
  172. package/dist/server/index.js +13 -2
  173. package/dist/server/index.js.map +1 -1
  174. package/dist/server/inferUtilityTypes.d.ts +6 -6
  175. package/dist/server/inferUtilityTypes.js.map +1 -1
  176. package/dist/server/metric.js.map +1 -1
  177. package/dist/server/middleware.d.ts +16 -3
  178. package/dist/server/middleware.js.map +1 -1
  179. package/dist/server/middleware.test-d.js.map +1 -1
  180. package/dist/server/middleware.test.js +12 -9
  181. package/dist/server/middleware.test.js.map +1 -1
  182. package/dist/server/requestOrigin.d.ts +7 -0
  183. package/dist/server/requestOrigin.js +25 -0
  184. package/dist/server/requestOrigin.js.map +1 -0
  185. package/dist/server/server.d.ts +376 -71
  186. package/dist/server/server.js +603 -177
  187. package/dist/server/server.js.map +1 -1
  188. package/dist/server/skills-integration.test.d.ts +1 -0
  189. package/dist/server/skills-integration.test.js +73 -0
  190. package/dist/server/skills-integration.test.js.map +1 -0
  191. package/dist/server/skills.d.ts +22 -0
  192. package/dist/server/skills.js +193 -0
  193. package/dist/server/skills.js.map +1 -0
  194. package/dist/server/skills.test.d.ts +1 -0
  195. package/dist/server/skills.test.js +232 -0
  196. package/dist/server/skills.test.js.map +1 -0
  197. package/dist/server/templateHelper.d.ts +5 -7
  198. package/dist/server/templateHelper.js +3 -22
  199. package/dist/server/templateHelper.js.map +1 -1
  200. package/dist/server/templates.generated.d.ts +4 -0
  201. package/dist/server/templates.generated.js +47 -0
  202. package/dist/server/templates.generated.js.map +1 -0
  203. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  204. package/dist/server/tunnel-proxy-router.js +110 -0
  205. package/dist/server/tunnel-proxy-router.js.map +1 -0
  206. package/dist/server/tunnel-proxy-router.test.d.ts +1 -0
  207. package/dist/server/tunnel-proxy-router.test.js +229 -0
  208. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  209. package/dist/server/view-name.test-d.d.ts +1 -0
  210. package/dist/server/view-name.test-d.js +8 -0
  211. package/dist/server/view-name.test-d.js.map +1 -0
  212. package/dist/server/view-resource-resolution.test.d.ts +6 -0
  213. package/dist/server/view-resource-resolution.test.js +171 -0
  214. package/dist/server/view-resource-resolution.test.js.map +1 -0
  215. package/dist/server/viewsDevServer.d.ts +14 -0
  216. package/dist/server/viewsDevServer.js +48 -0
  217. package/dist/server/viewsDevServer.js.map +1 -0
  218. package/dist/test/utils.d.ts +8 -20
  219. package/dist/test/utils.js +39 -35
  220. package/dist/test/utils.js.map +1 -1
  221. package/dist/test/view.test.d.ts +1 -0
  222. package/dist/test/view.test.js +536 -0
  223. package/dist/test/view.test.js.map +1 -0
  224. package/dist/version.js +1 -3
  225. package/dist/version.js.map +1 -1
  226. package/dist/web/bridges/adaptor.d.ts +51 -0
  227. package/dist/web/bridges/adaptor.js +341 -0
  228. package/dist/web/bridges/adaptor.js.map +1 -0
  229. package/dist/web/bridges/adaptor.test.d.ts +1 -0
  230. package/dist/web/bridges/adaptor.test.js +224 -0
  231. package/dist/web/bridges/adaptor.test.js.map +1 -0
  232. package/dist/web/bridges/apps-sdk/bridge.d.ts +6 -1
  233. package/dist/web/bridges/apps-sdk/bridge.js +15 -3
  234. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -1
  235. package/dist/web/bridges/apps-sdk/index.d.ts +0 -1
  236. package/dist/web/bridges/apps-sdk/index.js +0 -1
  237. package/dist/web/bridges/apps-sdk/index.js.map +1 -1
  238. package/dist/web/bridges/apps-sdk/types.d.ts +8 -1
  239. package/dist/web/bridges/apps-sdk/types.js.map +1 -1
  240. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +11 -0
  241. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js +11 -0
  242. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -1
  243. package/dist/web/bridges/get-adaptor.d.ts +7 -0
  244. package/dist/web/bridges/get-adaptor.js +9 -7
  245. package/dist/web/bridges/get-adaptor.js.map +1 -1
  246. package/dist/web/bridges/get-adaptor.test.d.ts +1 -0
  247. package/dist/web/bridges/get-adaptor.test.js +32 -0
  248. package/dist/web/bridges/get-adaptor.test.js.map +1 -0
  249. package/dist/web/bridges/index.js.map +1 -1
  250. package/dist/web/bridges/mcp-app/bridge.d.ts +15 -2
  251. package/dist/web/bridges/mcp-app/bridge.js +73 -7
  252. package/dist/web/bridges/mcp-app/bridge.js.map +1 -1
  253. package/dist/web/bridges/mcp-app/bridge.test.d.ts +1 -0
  254. package/dist/web/bridges/mcp-app/bridge.test.js +17 -0
  255. package/dist/web/bridges/mcp-app/bridge.test.js.map +1 -0
  256. package/dist/web/bridges/mcp-app/index.d.ts +0 -1
  257. package/dist/web/bridges/mcp-app/index.js +0 -1
  258. package/dist/web/bridges/mcp-app/index.js.map +1 -1
  259. package/dist/web/bridges/mcp-app/types.d.ts +2 -0
  260. package/dist/web/bridges/mcp-app/types.js.map +1 -1
  261. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +12 -0
  262. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +12 -0
  263. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -1
  264. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -1
  265. package/dist/web/bridges/mcp-app/view-tools.test.d.ts +1 -0
  266. package/dist/web/bridges/mcp-app/view-tools.test.js +143 -0
  267. package/dist/web/bridges/mcp-app/view-tools.test.js.map +1 -0
  268. package/dist/web/bridges/types.d.ts +115 -10
  269. package/dist/web/bridges/types.js +14 -1
  270. package/dist/web/bridges/types.js.map +1 -1
  271. package/dist/web/bridges/types.test.d.ts +1 -0
  272. package/dist/web/bridges/types.test.js +19 -0
  273. package/dist/web/bridges/types.test.js.map +1 -0
  274. package/dist/web/bridges/use-host-context.d.ts +5 -0
  275. package/dist/web/bridges/use-host-context.js +5 -0
  276. package/dist/web/bridges/use-host-context.js.map +1 -1
  277. package/dist/web/components/modal-provider.d.ts +1 -1
  278. package/dist/web/components/modal-provider.js +4 -3
  279. package/dist/web/components/modal-provider.js.map +1 -1
  280. package/dist/web/create-store.d.ts +26 -0
  281. package/dist/web/create-store.js +35 -9
  282. package/dist/web/create-store.js.map +1 -1
  283. package/dist/web/create-store.test.js +22 -21
  284. package/dist/web/create-store.test.js.map +1 -1
  285. package/dist/web/data-llm.d.ts +35 -2
  286. package/dist/web/data-llm.js +31 -3
  287. package/dist/web/data-llm.js.map +1 -1
  288. package/dist/web/data-llm.test.js +39 -27
  289. package/dist/web/data-llm.test.js.map +1 -1
  290. package/dist/web/generate-helpers.d.ts +22 -18
  291. package/dist/web/generate-helpers.js +22 -18
  292. package/dist/web/generate-helpers.js.map +1 -1
  293. package/dist/web/generate-helpers.test-d.js +30 -28
  294. package/dist/web/generate-helpers.test-d.js.map +1 -1
  295. package/dist/web/generate-helpers.test.js.map +1 -1
  296. package/dist/web/helpers/state.d.ts +2 -2
  297. package/dist/web/helpers/state.js +11 -11
  298. package/dist/web/helpers/state.js.map +1 -1
  299. package/dist/web/helpers/state.test.js +9 -9
  300. package/dist/web/helpers/state.test.js.map +1 -1
  301. package/dist/web/hooks/index.d.ts +6 -1
  302. package/dist/web/hooks/index.js +6 -1
  303. package/dist/web/hooks/index.js.map +1 -1
  304. package/dist/web/hooks/test/utils.d.ts +7 -2
  305. package/dist/web/hooks/test/utils.js +14 -3
  306. package/dist/web/hooks/test/utils.js.map +1 -1
  307. package/dist/web/hooks/use-call-tool.d.ts +45 -0
  308. package/dist/web/hooks/use-call-tool.js +28 -0
  309. package/dist/web/hooks/use-call-tool.js.map +1 -1
  310. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -1
  311. package/dist/web/hooks/use-call-tool.test.js +62 -27
  312. package/dist/web/hooks/use-call-tool.test.js.map +1 -1
  313. package/dist/web/hooks/use-display-mode.d.ts +20 -0
  314. package/dist/web/hooks/use-display-mode.js +20 -0
  315. package/dist/web/hooks/use-display-mode.js.map +1 -1
  316. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -1
  317. package/dist/web/hooks/use-display-mode.test.js +56 -20
  318. package/dist/web/hooks/use-display-mode.test.js.map +1 -1
  319. package/dist/web/hooks/use-download.d.ts +5 -0
  320. package/dist/web/hooks/use-download.js +8 -0
  321. package/dist/web/hooks/use-download.js.map +1 -0
  322. package/dist/web/hooks/use-download.test.d.ts +1 -0
  323. package/dist/web/hooks/use-download.test.js +103 -0
  324. package/dist/web/hooks/use-download.test.js.map +1 -0
  325. package/dist/web/hooks/use-files.d.ts +32 -0
  326. package/dist/web/hooks/use-files.js +32 -0
  327. package/dist/web/hooks/use-files.js.map +1 -1
  328. package/dist/web/hooks/use-files.test.js +10 -2
  329. package/dist/web/hooks/use-files.test.js.map +1 -1
  330. package/dist/web/hooks/use-host-info.d.ts +22 -0
  331. package/dist/web/hooks/use-host-info.js +30 -0
  332. package/dist/web/hooks/use-host-info.js.map +1 -0
  333. package/dist/web/hooks/use-host-info.test.d.ts +1 -0
  334. package/dist/web/hooks/use-host-info.test.js +59 -0
  335. package/dist/web/hooks/use-host-info.test.js.map +1 -0
  336. package/dist/web/hooks/use-layout.d.ts +2 -0
  337. package/dist/web/hooks/use-layout.js +2 -0
  338. package/dist/web/hooks/use-layout.js.map +1 -1
  339. package/dist/web/hooks/use-layout.test.js +59 -26
  340. package/dist/web/hooks/use-layout.test.js.map +1 -1
  341. package/dist/web/hooks/use-open-external.d.ts +17 -0
  342. package/dist/web/hooks/use-open-external.js +16 -0
  343. package/dist/web/hooks/use-open-external.js.map +1 -1
  344. package/dist/web/hooks/use-open-external.test.js +13 -3
  345. package/dist/web/hooks/use-open-external.test.js.map +1 -1
  346. package/dist/web/hooks/use-register-view-tool.d.ts +38 -0
  347. package/dist/web/hooks/use-register-view-tool.js +50 -0
  348. package/dist/web/hooks/use-register-view-tool.js.map +1 -0
  349. package/dist/web/hooks/use-request-close.d.ts +16 -0
  350. package/dist/web/hooks/use-request-close.js +21 -0
  351. package/dist/web/hooks/use-request-close.js.map +1 -0
  352. package/dist/web/hooks/use-request-close.test.d.ts +1 -0
  353. package/dist/web/hooks/use-request-close.test.js +47 -0
  354. package/dist/web/hooks/use-request-close.test.js.map +1 -0
  355. package/dist/web/hooks/use-request-modal.d.ts +16 -1
  356. package/dist/web/hooks/use-request-modal.js +19 -4
  357. package/dist/web/hooks/use-request-modal.js.map +1 -1
  358. package/dist/web/hooks/use-request-modal.test.js +11 -1
  359. package/dist/web/hooks/use-request-modal.test.js.map +1 -1
  360. package/dist/web/hooks/use-request-size.d.ts +20 -0
  361. package/dist/web/hooks/use-request-size.js +24 -0
  362. package/dist/web/hooks/use-request-size.js.map +1 -0
  363. package/dist/web/hooks/use-request-size.test.d.ts +1 -0
  364. package/dist/web/hooks/use-request-size.test.js +47 -0
  365. package/dist/web/hooks/use-request-size.test.js.map +1 -0
  366. package/dist/web/hooks/use-send-follow-up-message.d.ts +19 -1
  367. package/dist/web/hooks/use-send-follow-up-message.js +19 -2
  368. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -1
  369. package/dist/web/hooks/use-set-open-in-app-url.d.ts +17 -0
  370. package/dist/web/hooks/use-set-open-in-app-url.js +17 -0
  371. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -1
  372. package/dist/web/hooks/use-set-open-in-app-url.test.js +28 -8
  373. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -1
  374. package/dist/web/hooks/use-tool-info.d.ts +53 -2
  375. package/dist/web/hooks/use-tool-info.js +30 -7
  376. package/dist/web/hooks/use-tool-info.js.map +1 -1
  377. package/dist/web/hooks/use-tool-info.test-d.js +11 -29
  378. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -1
  379. package/dist/web/hooks/use-tool-info.test.js +42 -32
  380. package/dist/web/hooks/use-tool-info.test.js.map +1 -1
  381. package/dist/web/hooks/use-user.d.ts +2 -0
  382. package/dist/web/hooks/use-user.js +2 -0
  383. package/dist/web/hooks/use-user.js.map +1 -1
  384. package/dist/web/hooks/use-user.test.js +81 -35
  385. package/dist/web/hooks/use-user.test.js.map +1 -1
  386. package/dist/web/hooks/use-view-state.d.ts +25 -0
  387. package/dist/web/hooks/use-view-state.js +42 -0
  388. package/dist/web/hooks/use-view-state.js.map +1 -0
  389. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  390. package/dist/web/hooks/{use-widget-state.test.js → use-view-state.test.js} +54 -19
  391. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  392. package/dist/web/index.d.ts +1 -2
  393. package/dist/web/index.js +1 -2
  394. package/dist/web/index.js.map +1 -1
  395. package/dist/web/mount-view.d.ts +20 -0
  396. package/dist/web/{mount-widget.js → mount-view.js} +21 -2
  397. package/dist/web/mount-view.js.map +1 -0
  398. package/dist/web/plugin/data-llm.test.js.map +1 -1
  399. package/dist/web/plugin/plugin.d.ts +38 -1
  400. package/dist/web/plugin/plugin.js +160 -25
  401. package/dist/web/plugin/plugin.js.map +1 -1
  402. package/dist/web/plugin/scan-views.d.ts +16 -0
  403. package/dist/web/plugin/scan-views.js +88 -0
  404. package/dist/web/plugin/scan-views.js.map +1 -0
  405. package/dist/web/plugin/scan-views.test.d.ts +1 -0
  406. package/dist/web/plugin/scan-views.test.js +99 -0
  407. package/dist/web/plugin/scan-views.test.js.map +1 -0
  408. package/dist/web/plugin/transform-data-llm.js.map +1 -1
  409. package/dist/web/plugin/transform-data-llm.test.js.map +1 -1
  410. package/dist/web/plugin/validate-view.d.ts +1 -0
  411. package/dist/web/plugin/validate-view.js +9 -0
  412. package/dist/web/plugin/validate-view.js.map +1 -0
  413. package/dist/web/plugin/validate-view.test.d.ts +1 -0
  414. package/dist/web/plugin/validate-view.test.js +24 -0
  415. package/dist/web/plugin/validate-view.test.js.map +1 -0
  416. package/dist/web/proxy.js.map +1 -1
  417. package/dist/web/types.d.ts +4 -0
  418. package/dist/web/types.js.map +1 -1
  419. package/package.json +39 -22
  420. package/tsconfig.base.json +2 -0
  421. package/dist/server/templates/development.hbs +0 -12
  422. package/dist/server/templates/production.hbs +0 -6
  423. package/dist/server/widgetsDevServer.d.ts +0 -13
  424. package/dist/server/widgetsDevServer.js +0 -52
  425. package/dist/server/widgetsDevServer.js.map +0 -1
  426. package/dist/test/widget.test.js +0 -334
  427. package/dist/test/widget.test.js.map +0 -1
  428. package/dist/web/bridges/apps-sdk/adaptor.d.ts +0 -24
  429. package/dist/web/bridges/apps-sdk/adaptor.js +0 -87
  430. package/dist/web/bridges/apps-sdk/adaptor.js.map +0 -1
  431. package/dist/web/bridges/mcp-app/adaptor.d.ts +0 -48
  432. package/dist/web/bridges/mcp-app/adaptor.js +0 -268
  433. package/dist/web/bridges/mcp-app/adaptor.js.map +0 -1
  434. package/dist/web/hooks/use-widget-state.d.ts +0 -4
  435. package/dist/web/hooks/use-widget-state.js +0 -32
  436. package/dist/web/hooks/use-widget-state.js.map +0 -1
  437. package/dist/web/hooks/use-widget-state.test.js.map +0 -1
  438. package/dist/web/mount-widget.d.ts +0 -1
  439. package/dist/web/mount-widget.js.map +0 -1
  440. package/dist/web/plugin/validate-widget.d.ts +0 -5
  441. package/dist/web/plugin/validate-widget.js +0 -27
  442. package/dist/web/plugin/validate-widget.js.map +0 -1
  443. package/dist/web/plugin/validate-widget.test.js +0 -42
  444. package/dist/web/plugin/validate-widget.test.js.map +0 -1
  445. /package/dist/{test/widget.test.d.ts → cli/build-helpers.test.d.ts} +0 -0
  446. /package/dist/{web/hooks/use-widget-state.test.d.ts → cli/build-steps.test.d.ts} +0 -0
  447. /package/dist/{web/plugin/validate-widget.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
@@ -0,0 +1,24 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { hasDefaultExport } from "./validate-view.js";
3
+ describe("hasDefaultExport", () => {
4
+ it("detects export default declaration", () => {
5
+ expect(hasDefaultExport("export default MyView;")).toBe(true);
6
+ });
7
+ it("detects export default function", () => {
8
+ expect(hasDefaultExport("export default function MyView() {}")).toBe(true);
9
+ });
10
+ it("detects re-export as default", () => {
11
+ expect(hasDefaultExport("export { Foo as default };")).toBe(true);
12
+ });
13
+ it("returns false when no default export", () => {
14
+ expect(hasDefaultExport("export const Foo = 1;")).toBe(false);
15
+ });
16
+ it("ignores commented-out default exports", () => {
17
+ const code = `
18
+ // export default MyView;
19
+ /* export default MyView; */
20
+ `;
21
+ expect(hasDefaultExport(code)).toBe(false);
22
+ });
23
+ });
24
+ //# sourceMappingURL=validate-view.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-view.test.js","sourceRoot":"","sources":["../../../src/web/plugin/validate-view.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,gBAAgB,CAAC,qCAAqC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,gBAAgB,CAAC,4BAA4B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,IAAI,GAAG;;;KAGZ,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { hasDefaultExport } from \"./validate-view.js\";\n\ndescribe(\"hasDefaultExport\", () => {\n it(\"detects export default declaration\", () => {\n expect(hasDefaultExport(\"export default MyView;\")).toBe(true);\n });\n\n it(\"detects export default function\", () => {\n expect(hasDefaultExport(\"export default function MyView() {}\")).toBe(true);\n });\n\n it(\"detects re-export as default\", () => {\n expect(hasDefaultExport(\"export { Foo as default };\")).toBe(true);\n });\n\n it(\"returns false when no default export\", () => {\n expect(hasDefaultExport(\"export const Foo = 1;\")).toBe(false);\n });\n\n it(\"ignores commented-out default exports\", () => {\n const code = `\n // export default MyView;\n /* export default MyView; */\n `;\n expect(hasDefaultExport(code)).toBe(false);\n });\n});\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/web/proxy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/web/proxy.ts"],"names":[],"mappings":"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","sourcesContent":["const colors = {\n brand: \"#6366f1\",\n info: \"#22223b\",\n success: \"#22c55e\",\n error: \"#ef4444\",\n} as const;\n\nexport function installOpenAILoggingProxy() {\n if (typeof window === \"undefined\" || !window.openai) {\n return;\n }\n\n const descriptor = Object.getOwnPropertyDescriptor(window, \"openai\");\n if (descriptor?.configurable === false || descriptor?.writable === false) {\n console.warn(\n \"[openai-proxy] window.openai is not configurable or writable, skipping proxy installation\",\n );\n return;\n }\n\n const originalOpenAI = window.openai;\n\n const handler: ProxyHandler<typeof originalOpenAI> = {\n get(target, prop, receiver) {\n const value = Reflect.get(target, prop, receiver);\n\n if (typeof value !== \"function\") {\n return value;\n }\n\n return (...args: unknown[]) => {\n const methodName = String(prop);\n\n console.group(\n `%c[openai] %cmethod %c${methodName}`,\n `color: ${colors.brand}; font-weight: normal`,\n `color: ${colors.info}; font-weight: normal`,\n `color: ${colors.success}`,\n );\n console.log(\"%c← args:\", `color: ${colors.info}`, args);\n\n const result = value.apply(target, args);\n\n if (result && typeof result.then === \"function\") {\n return result.then(\n (resolved: unknown) => {\n console.log(\n \"%c→ resolved:\",\n `color: ${colors.success}`,\n resolved,\n );\n console.groupEnd();\n return resolved;\n },\n (error: unknown) => {\n console.error(\"%c→ rejected:\", `color: ${colors.error}`, error);\n console.groupEnd();\n throw error;\n },\n );\n }\n\n console.log(\"%c→ returned:\", `color: ${colors.success}`, result);\n console.groupEnd();\n\n return result;\n };\n },\n\n set(target, prop, value, receiver) {\n console.log(\n `%c[openai] %cupdate %c${String(prop)}`,\n `color: ${colors.brand}`,\n `color: ${colors.info}`,\n `color: ${colors.success}; font-weight: bold`,\n \"←\",\n value,\n );\n\n return Reflect.set(target, prop, value, receiver);\n },\n };\n\n window.openai = new Proxy(originalOpenAI, handler);\n\n console.log(\n \"%c[openai-proxy] %cInstalled logging proxy for window.openai\",\n `color: ${colors.brand}`,\n `color: ${colors.info}`,\n );\n}\n"]}
@@ -4,13 +4,17 @@ declare module "react" {
4
4
  "data-llm"?: string;
5
5
  }
6
6
  }
7
+ /** Shorthand for an arbitrary plain object — `Record<string, unknown>`. */
7
8
  export type UnknownObject = Record<string, unknown>;
9
+ /** Flatten an intersection so it appears as a single object type in hovers and error messages. */
8
10
  export type Prettify<T> = {
9
11
  [K in keyof T]: T[K];
10
12
  } & {};
13
+ /** Widen `T` to also satisfy {@link UnknownObject}, useful for tool input/output narrowing. */
11
14
  export type Objectify<T> = T & UnknownObject;
12
15
  type RequiredKeys<T> = {
13
16
  [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;
14
17
  }[keyof T];
18
+ /** `true` if `T` has at least one required key, `false` if every key is optional. */
15
19
  export type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;
16
20
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,CAAC","sourcesContent":["import \"react\";\n\ndeclare module \"react\" {\n interface HTMLAttributes<T> {\n \"data-llm\"?: string;\n }\n}\n\n/** Shorthand for an arbitrary plain object — `Record<string, unknown>`. */\nexport type UnknownObject = Record<string, unknown>;\n\n/** Flatten an intersection so it appears as a single object type in hovers and error messages. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n/** Widen `T` to also satisfy {@link UnknownObject}, useful for tool input/output narrowing. */\nexport type Objectify<T> = T & UnknownObject;\n\ntype RequiredKeys<T> = {\n [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;\n}[keyof T];\n/** `true` if `T` has at least one required key, `false` if every key is optional. */\nexport type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;\n"]}
package/package.json CHANGED
@@ -1,12 +1,16 @@
1
1
  {
2
2
  "name": "skybridge",
3
- "version": "0.0.0-dev.e28afb2",
3
+ "version": "0.0.0-dev.e28f13b",
4
4
  "description": "Skybridge is a framework for building ChatGPT and MCP Apps",
5
5
  "repository": {
6
6
  "type": "git",
7
7
  "url": "https://github.com/alpic-ai/skybridge.git"
8
8
  },
9
9
  "type": "module",
10
+ "sideEffects": false,
11
+ "engines": {
12
+ "node": ">=22.23.1"
13
+ },
10
14
  "files": [
11
15
  "dist",
12
16
  "README.md",
@@ -22,6 +26,10 @@
22
26
  "./web": {
23
27
  "types": "./dist/web/index.d.ts",
24
28
  "default": "./dist/web/index.js"
29
+ },
30
+ "./vite": {
31
+ "types": "./dist/web/plugin/plugin.d.ts",
32
+ "default": "./dist/web/plugin/plugin.js"
25
33
  }
26
34
  },
27
35
  "keywords": [
@@ -34,26 +42,31 @@
34
42
  "license": "ISC",
35
43
  "peerDependencies": {
36
44
  "@modelcontextprotocol/sdk": ">=1.27.0",
37
- "@skybridge/devtools": ">=0.35.14 <1.0.0",
45
+ "@skybridge/devtools": "^1.1.0",
38
46
  "nodemon": ">=3.0.0",
39
47
  "react": ">=18.0.0",
40
48
  "react-dom": ">=18.0.0",
41
49
  "vite": ">=7.3.1"
42
50
  },
43
51
  "dependencies": {
44
- "@babel/core": "^7.29.0",
45
- "@modelcontextprotocol/ext-apps": "^1.7.0",
46
- "@oclif/core": "^4.10.6",
52
+ "@babel/core": "^7.29.7",
53
+ "@modelcontextprotocol/ext-apps": "^1.7.4",
54
+ "@oclif/core": "^4.11.14",
47
55
  "ci-info": "^4.4.0",
48
56
  "cors": "^2.8.6",
57
+ "cross-spawn": "^7.0.6",
49
58
  "dequal": "^2.0.3",
50
- "es-toolkit": "^1.46.0",
59
+ "es-toolkit": "^1.49.0",
60
+ "esbuild": "^0.28.1",
51
61
  "express": "^5.2.1",
52
62
  "handlebars": "^4.7.9",
53
- "ink": "^7.0.1",
54
- "posthog-node": "^5.30.4",
63
+ "ink": "^7.1.1",
64
+ "jose": "^6.2.3",
65
+ "open": "^11.0.0",
66
+ "posthog-node": "^5.45.2",
55
67
  "superjson": "^2.2.6",
56
- "zustand": "^5.0.12"
68
+ "yaml": "^2.9.0",
69
+ "zustand": "^5.0.14"
57
70
  },
58
71
  "devDependencies": {
59
72
  "@modelcontextprotocol/sdk": "^1.29.0",
@@ -62,19 +75,20 @@
62
75
  "@total-typescript/tsconfig": "^1.0.4",
63
76
  "@types/babel__core": "^7.20.5",
64
77
  "@types/cors": "^2.8.19",
78
+ "@types/cross-spawn": "^6.0.6",
65
79
  "@types/express": "^5.0.6",
66
- "@types/jsdom": "^28.0.1",
67
- "@types/node": "^24.12.2",
68
- "@types/react": "^19.2.14",
80
+ "@types/jsdom": "^28.0.3",
81
+ "@types/node": "^24.13.3",
82
+ "@types/react": "^19.2.17",
69
83
  "@types/react-dom": "^19.2.3",
70
- "@vitest/ui": "^4.1.5",
71
- "jsdom": "^29.0.2",
84
+ "@vitest/ui": "^4.1.10",
85
+ "jsdom": "^29.1.1",
72
86
  "shx": "^0.4.0",
73
87
  "ts-node": "^10.9.2",
74
88
  "typescript": "^6.0.3",
75
- "vite": "^8.0.0",
76
- "vitest": "^4.1.5",
77
- "zod": "^4.3.6"
89
+ "vite": "^8.1.5",
90
+ "vitest": "^4.1.10",
91
+ "zod": "^4.4.3"
78
92
  },
79
93
  "bin": {
80
94
  "sb": "./bin/run.js",
@@ -85,17 +99,20 @@
85
99
  "commands": "./dist/commands",
86
100
  "dirname": "skybridge",
87
101
  "topicSeparator": " ",
102
+ "helpClass": {
103
+ "target": "./dist/commands/create",
104
+ "identifier": "SkybridgeHelp"
105
+ },
88
106
  "hooks": {
89
107
  "finally": "./dist/cli/telemetry"
90
108
  }
91
109
  },
92
110
  "scripts": {
93
- "build": "shx rm -rf dist && tsc && pnpm run build:templates",
94
- "build:templates": "cp -r src/server/templates dist/server/",
111
+ "build": "shx rm -rf dist && pnpm run build:templates && tsc",
112
+ "build:templates": "node scripts/precompile-templates.mjs",
95
113
  "format": "biome check --write --error-on-warnings",
96
- "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
97
- "test:unit": "vitest run",
98
- "test:type": "tsc --noEmit",
114
+ "test": "pnpm run test:unit && pnpm run test:format",
115
+ "test:unit": "pnpm run build:templates && vitest run",
99
116
  "test:format": "biome ci"
100
117
  }
101
118
  }
@@ -6,6 +6,8 @@
6
6
  "verbatimModuleSyntax": true,
7
7
 
8
8
  // Output options
9
+ "rootDir": "${configDir}/src",
10
+ "outDir": "${configDir}/dist",
9
11
  "noEmit": false,
10
12
  "incremental": true,
11
13
  "sourceMap": true,
@@ -1,12 +0,0 @@
1
- <script type="module">window.skybridge = { hostType: "{{hostType}}", serverUrl: "{{serverUrl}}" };</script>
2
- <script type="module">
3
- import { injectIntoGlobalHook } from "{{serverUrl}}/assets/@react-refresh";
4
- injectIntoGlobalHook(window); window.$RefreshReg$ = () => {};
5
- window.$RefreshSig$ = () => (type) => type;
6
- window.__vite_plugin_react_preamble_installed__ = true;
7
- </script>
8
- <script type="module" src="{{serverUrl}}/@vite/client"></script>
9
- <div id="root"></div>
10
- <script type="module" id="dev-widget-entry">
11
- import('{{serverUrl}}/src/widgets/{{widgetName}}');
12
- </script>
@@ -1,6 +0,0 @@
1
- <script type="module">window.skybridge = { hostType: "{{hostType}}", serverUrl: "{{serverUrl}}" };</script>
2
- <div id="root"></div>
3
- <script type="module">
4
- import('{{serverUrl}}/assets/{{widgetFile}}');
5
- </script>
6
- <link rel="stylesheet" crossorigin href="{{serverUrl}}/assets/{{styleFile}}" />
@@ -1,13 +0,0 @@
1
- import type http from "node:http";
2
- import { type Router } from "express";
3
- /**
4
- * Install Vite dev server
5
- * This router MUST be installed at the application root, like so:
6
- *
7
- * const app = express();
8
- *
9
- * if (env.NODE_ENV !== "production") {
10
- * app.use(await widgetsRouter());
11
- * }
12
- */
13
- export declare const widgetsDevServer: (httpServer: http.Server) => Promise<Router>;
@@ -1,52 +0,0 @@
1
- import { existsSync } from "node:fs";
2
- import path from "node:path";
3
- import cors from "cors";
4
- import express, {} from "express";
5
- import { assetBaseUrlTransformPlugin } from "./asset-base-url-transform-plugin.js";
6
- /**
7
- * Install Vite dev server
8
- * This router MUST be installed at the application root, like so:
9
- *
10
- * const app = express();
11
- *
12
- * if (env.NODE_ENV !== "production") {
13
- * app.use(await widgetsRouter());
14
- * }
15
- */
16
- export const widgetsDevServer = async (httpServer) => {
17
- const router = express.Router();
18
- const { createServer, searchForWorkspaceRoot, loadConfigFromFile } = await import("vite");
19
- // Since 0.16.0, the template is a single package that does not rely on workspace.
20
- // It means that, when starting the server, the working dir is the template root
21
- // hence we don't need to walk up the tree to find the workspace, which does not exist anymore.
22
- let webAppRoot = path.join(process.cwd(), "web");
23
- // fallback to the old behavior for backward compatibility
24
- const hasWebAppRoot = existsSync(webAppRoot);
25
- if (!hasWebAppRoot) {
26
- const workspaceRoot = searchForWorkspaceRoot(process.cwd());
27
- webAppRoot = path.join(workspaceRoot, "web");
28
- }
29
- const configResult = await loadConfigFromFile({ command: "serve", mode: "development" }, path.join(webAppRoot, "vite.config.ts"), webAppRoot);
30
- const { build, preview, plugins: userPlugins = [], ...devConfig } = configResult?.config || {};
31
- const vite = await createServer({
32
- ...devConfig,
33
- configFile: false, // Keep this to prevent vite from trying to resolve path in the target config file
34
- appType: "custom",
35
- server: {
36
- allowedHosts: true,
37
- middlewareMode: true,
38
- hmr: {
39
- server: httpServer,
40
- },
41
- },
42
- root: webAppRoot,
43
- optimizeDeps: {
44
- include: ["react", "react-dom/client"],
45
- },
46
- plugins: [...userPlugins, assetBaseUrlTransformPlugin()],
47
- });
48
- router.use(cors());
49
- router.use("/", vite.middlewares);
50
- return router;
51
- };
52
- //# sourceMappingURL=widgetsDevServer.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"widgetsDevServer.js","sourceRoot":"","sources":["../../src/server/widgetsDevServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,OAAO,EAAE,EAAe,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,UAAuB,EACN,EAAE;IACnB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,GAChE,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAEvB,kFAAkF;IAClF,gFAAgF;IAChF,+FAA+F;IAC/F,IAAI,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IAEjD,0DAA0D;IAC1D,MAAM,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,aAAa,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5D,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAC3C,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,EACzC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EACvC,UAAU,CACX,CAAC;IAEF,MAAM,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EAAE,WAAW,GAAG,EAAE,EACzB,GAAG,SAAS,EACb,GAAG,YAAY,EAAE,MAAM,IAAI,EAAE,CAAC;IAE/B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;QAC9B,GAAG,SAAS;QACZ,UAAU,EAAE,KAAK,EAAE,kFAAkF;QACrG,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE;YACN,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,GAAG,EAAE;gBACH,MAAM,EAAE,UAAU;aACnB;SACF;QACD,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC;SACvC;QACD,OAAO,EAAE,CAAC,GAAG,WAAW,EAAE,2BAA2B,EAAE,CAAC;KACzD,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
@@ -1,334 +0,0 @@
1
- import crypto from "node:crypto";
2
- import { afterEach, beforeEach, describe, expect, it, vi, } from "vitest";
3
- import { createMockExtra, createMockMcpServer, resetTestEnv, setTestEnv, } from "./utils.js";
4
- const mockManifest = {
5
- "src/widgets/my-widget.tsx": { file: "my-widget.js" },
6
- "src/widgets/folder-widget/index.tsx": { file: "folder-widget.js" },
7
- "style.css": { file: "style.css" },
8
- };
9
- const actual = vi.hoisted(() => require("node:fs"));
10
- vi.mock("node:fs", () => {
11
- const readFileSyncImpl = (path, ...args) => {
12
- if (typeof path === "string" && path.includes("manifest.json")) {
13
- return JSON.stringify(mockManifest);
14
- }
15
- return actual.readFileSync(path, ...args);
16
- };
17
- const readFileSync = vi.fn(readFileSyncImpl);
18
- return {
19
- readFileSync,
20
- default: {
21
- readFileSync,
22
- },
23
- };
24
- });
25
- describe("McpServer.registerWidget", () => {
26
- let server;
27
- let mockRegisterResource;
28
- let mockRegisterTool;
29
- beforeEach(() => {
30
- ({ server, mockRegisterResource, mockRegisterTool } =
31
- createMockMcpServer());
32
- });
33
- afterEach(() => {
34
- vi.clearAllMocks();
35
- resetTestEnv();
36
- });
37
- it("should generate correct HTML for development mode", async () => {
38
- setTestEnv({ NODE_ENV: "development" });
39
- const mockToolCallback = vi.fn();
40
- const mockRegisterResourceConfig = { description: "Test widget" };
41
- const mockToolConfig = { description: "Test tool" };
42
- server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
43
- // Get the resource callback function
44
- const appsSdkResourceCallback = mockRegisterResource.mock
45
- .calls[0]?.[3];
46
- expect(appsSdkResourceCallback).toBeDefined();
47
- const host = "localhost:3000";
48
- const serverUrl = `http://${host}`;
49
- const hmrUrl = `ws://${host}`;
50
- const mockExtra = createMockExtra(host);
51
- const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), mockExtra);
52
- expect(mockRegisterTool).toHaveBeenCalled();
53
- expect(result).toEqual({
54
- contents: [
55
- {
56
- uri: "ui://widgets/apps-sdk/my-widget.html",
57
- mimeType: "text/html+skybridge",
58
- text: expect.stringContaining('<div id="root"></div>'),
59
- _meta: {
60
- "openai/widgetCSP": {
61
- resource_domains: [serverUrl],
62
- connect_domains: [serverUrl, hmrUrl],
63
- },
64
- "openai/widgetDomain": serverUrl,
65
- "openai/widgetDescription": "Test widget",
66
- },
67
- },
68
- ],
69
- });
70
- // Check development-specific content
71
- expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/@react-refresh`);
72
- expect(result.contents[0]?.text).toContain(`${serverUrl}/@vite/client`);
73
- expect(result.contents[0]?.text).toContain(`${serverUrl}/src/widgets/my-widget`);
74
- expect(result.contents[0]?.text).not.toContain(`${serverUrl}/src/widgets/my-widget.tsx`);
75
- });
76
- it("should generate correct HTML for production mode", async () => {
77
- setTestEnv({ NODE_ENV: "production" });
78
- const mockToolCallback = vi.fn();
79
- const mockRegisterResourceConfig = { description: "Test widget" };
80
- const mockToolConfig = { description: "Test tool" };
81
- server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
82
- // Get the resource callback function
83
- const appsSdkResourceCallback = mockRegisterResource.mock
84
- .calls[0]?.[3];
85
- expect(appsSdkResourceCallback).toBeDefined();
86
- const host = "myapp.com";
87
- const serverUrl = `https://${host}`;
88
- const mockExtra = createMockExtra(host);
89
- const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), mockExtra);
90
- expect(result).toEqual({
91
- contents: [
92
- {
93
- uri: "ui://widgets/apps-sdk/my-widget.html",
94
- mimeType: "text/html+skybridge",
95
- text: expect.stringContaining('<div id="root"></div>'),
96
- _meta: {
97
- "openai/widgetCSP": {
98
- resource_domains: [serverUrl],
99
- connect_domains: [serverUrl],
100
- },
101
- "openai/widgetDomain": serverUrl,
102
- "openai/widgetDescription": "Test widget",
103
- },
104
- },
105
- ],
106
- });
107
- // Check production-specific content
108
- expect(result.contents[0]?.text).not.toContain(`${serverUrl}/assets/@react-refresh`);
109
- expect(result.contents[0]?.text).not.toContain(`${serverUrl}@vite/client`);
110
- expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/my-widget.js`);
111
- expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/style.css`);
112
- });
113
- it("should prefer x-alpic-forwarded-url when hashing Claude widget domains", async () => {
114
- setTestEnv({ NODE_ENV: "production" });
115
- const mockToolCallback = vi.fn();
116
- server.registerWidget("my-widget", { description: "Test widget" }, { description: "Test tool" }, mockToolCallback);
117
- const extAppsResourceCallback = mockRegisterResource.mock
118
- .calls[1]?.[3];
119
- expect(extAppsResourceCallback).toBeDefined();
120
- const forwardedUrl = "https://everything-3a2c1264.staging.alpic.live/mcp?foo=bar";
121
- const expectedDomain = `${crypto
122
- .createHash("sha256")
123
- .update(forwardedUrl)
124
- .digest("hex")
125
- .slice(0, 32)}.claudemcpcontent.com`;
126
- const result = await extAppsResourceCallback(new URL("ui://widgets/ext-apps/my-widget.html"), createMockExtra("localhost:3000", {
127
- headers: {
128
- "user-agent": "Claude-User",
129
- "x-alpic-forwarded-url": forwardedUrl,
130
- },
131
- url: "http://localhost:3000/mcp",
132
- }));
133
- expect(result.contents[0]?._meta).toEqual({
134
- ui: {
135
- csp: {
136
- resourceDomains: ["http://localhost:3000"],
137
- connectDomains: ["http://localhost:3000"],
138
- },
139
- domain: expectedDomain,
140
- },
141
- });
142
- });
143
- it("should resolve folder-based widgets (barrel files) in production mode", async () => {
144
- setTestEnv({ NODE_ENV: "production" });
145
- const mockToolCallback = vi.fn();
146
- const mockRegisterResourceConfig = { description: "Folder widget" };
147
- const mockToolConfig = { description: "Folder tool" };
148
- server.registerWidget("folder-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
149
- const appsSdkResourceCallback = mockRegisterResource.mock
150
- .calls[0]?.[3];
151
- expect(appsSdkResourceCallback).toBeDefined();
152
- const host = "myapp.com";
153
- const serverUrl = `https://${host}`;
154
- const mockExtra = createMockExtra(host);
155
- const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/folder-widget.html"), mockExtra);
156
- // Should resolve to folder-widget.js from the manifest entry "src/widgets/folder-widget/index.tsx"
157
- expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/folder-widget.js`);
158
- });
159
- it("should register resources with correct hostType for both apps-sdk and ext-apps formats", async () => {
160
- const mockToolCallback = vi.fn();
161
- const mockRegisterResourceConfig = {
162
- description: "Test widget",
163
- _meta: { "openai/widgetPrefersBorder": true },
164
- };
165
- const mockToolConfig = { description: "Test tool" };
166
- server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
167
- expect(mockRegisterResource).toHaveBeenCalledTimes(2);
168
- const appsSdkCallback = mockRegisterResource.mock
169
- .calls[0]?.[3];
170
- const appsSdkResult = await appsSdkCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), createMockExtra("localhost:3000"));
171
- const host = "localhost:3000";
172
- const serverUrl = `http://${host}`;
173
- const hmrUrl = `ws://${host}`;
174
- expect(appsSdkResult).toEqual({
175
- contents: [
176
- {
177
- uri: "ui://widgets/apps-sdk/my-widget.html",
178
- mimeType: "text/html+skybridge",
179
- text: expect.stringContaining('<div id="root"></div>'),
180
- _meta: {
181
- "openai/widgetCSP": {
182
- resource_domains: [serverUrl],
183
- connect_domains: [serverUrl, hmrUrl],
184
- },
185
- "openai/widgetDomain": serverUrl,
186
- "openai/widgetDescription": "Test widget",
187
- "openai/widgetPrefersBorder": true,
188
- },
189
- },
190
- ],
191
- });
192
- expect(appsSdkResult.contents[0]?.text).toContain('window.skybridge = { hostType: "apps-sdk", serverUrl: "http://localhost:3000" };');
193
- const extAppsResourceCallback = mockRegisterResource.mock
194
- .calls[1]?.[3];
195
- expect(extAppsResourceCallback).toBeDefined();
196
- const extAppsResult = await extAppsResourceCallback(new URL("ui://widgets/ext-apps/my-widget.html"), createMockExtra(host));
197
- expect(extAppsResult).toEqual({
198
- contents: [
199
- {
200
- uri: "ui://widgets/ext-apps/my-widget.html",
201
- mimeType: "text/html;profile=mcp-app",
202
- text: expect.stringContaining('<div id="root"></div>'),
203
- _meta: {
204
- ui: {
205
- csp: {
206
- resourceDomains: [serverUrl],
207
- connectDomains: [serverUrl, hmrUrl],
208
- },
209
- domain: serverUrl,
210
- },
211
- },
212
- },
213
- ],
214
- });
215
- expect(extAppsResult.contents[0]?.text).toContain('window.skybridge = { hostType: "mcp-app", serverUrl: "http://localhost:3000" };');
216
- });
217
- it("should register tool with ui.resourceUri metadata (not deprecated ui/resourceUri)", async () => {
218
- const mockToolCallback = vi.fn();
219
- const mockRegisterResourceConfig = { description: "Test widget" };
220
- const mockToolConfig = { description: "Test tool" };
221
- server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
222
- expect(mockRegisterTool).toHaveBeenCalledTimes(1);
223
- const toolCallArgs = mockRegisterTool.mock.calls[0];
224
- const toolConfig = toolCallArgs?.[1];
225
- expect(toolConfig._meta).toHaveProperty("ui");
226
- expect(toolConfig._meta?.ui).toEqual({
227
- resourceUri: "ui://widgets/ext-apps/my-widget.html",
228
- });
229
- });
230
- it("should apply meta overrides in correct priority: defaults < ui.* < direct openai/* keys", async () => {
231
- const mockToolCallback = vi.fn();
232
- const mockRegisterResourceConfig = {
233
- description: "Test widget",
234
- _meta: {
235
- // ui.csp overrides (middle priority)
236
- ui: {
237
- csp: {
238
- resourceDomains: ["https://from-ui-csp.com"],
239
- connectDomains: ["https://from-ui-csp.com"],
240
- },
241
- domain: "https://from-ui-domain.com",
242
- prefersBorder: false,
243
- },
244
- // Direct openai/* keys (highest priority) - should override ui.*
245
- "openai/widgetDomain": "https://direct-override.com",
246
- "openai/widgetPrefersBorder": true,
247
- },
248
- };
249
- const mockToolConfig = { description: "Test tool" };
250
- server.registerWidget("override-test", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
251
- const appsSdkCallback = mockRegisterResource.mock
252
- .calls[0]?.[3];
253
- const host = `localhost:3000`;
254
- const serverUrl = `http://${host}`;
255
- const hmrUrl = `ws://${host}`;
256
- const result = await appsSdkCallback(new URL("ui://widgets/apps-sdk/override-test.html"), createMockExtra(host));
257
- const meta = result.contents[0]?._meta;
258
- // CSP arrays are merged with union - all unique domains from defaults and user config are preserved
259
- expect(meta["openai/widgetCSP"]).toEqual({
260
- resource_domains: [serverUrl, "https://from-ui-csp.com"],
261
- connect_domains: [serverUrl, hmrUrl, "https://from-ui-csp.com"],
262
- frame_domains: undefined,
263
- redirect_domains: undefined,
264
- });
265
- // Domain should be overridden by direct openai/* key (highest priority)
266
- expect(meta["openai/widgetDomain"]).toBe("https://direct-override.com");
267
- // PrefersBorder should be overridden by direct openai/* key (highest priority)
268
- expect(meta["openai/widgetPrefersBorder"]).toBe(true);
269
- // Description should be from defaults (toolConfig.description)
270
- expect(meta["openai/widgetDescription"]).toBe("Test widget");
271
- });
272
- it("should register tool with ui.resourceUri metadata only", async () => {
273
- const mockToolCallback = vi.fn();
274
- server.registerWidget("my-widget", { description: "Test widget", hosts: ["mcp-app"] }, { description: "Test tool" }, mockToolCallback);
275
- expect(mockRegisterTool).toHaveBeenCalledTimes(1);
276
- const toolCallArgs = mockRegisterTool.mock.calls[0];
277
- const toolConfig = toolCallArgs?.[1];
278
- expect(toolConfig._meta).toHaveProperty("ui");
279
- expect(toolConfig._meta?.ui).toEqual({
280
- resourceUri: "ui://widgets/ext-apps/my-widget.html",
281
- });
282
- expect(toolConfig._meta?.["openai/outputTemplate"]).to.be.undefined;
283
- });
284
- it("should inject viewUUID into _meta of tool callback results", async () => {
285
- const mockToolCallback = vi.fn().mockResolvedValue({
286
- content: [{ type: "text", text: "result" }],
287
- structuredContent: { data: "test" },
288
- });
289
- server.registerWidget("my-widget", { description: "Test widget" }, { description: "Test tool" }, mockToolCallback);
290
- // The registerTool should have been called with a wrapped callback
291
- const wrappedCallback = mockRegisterTool.mock.calls[0]?.[2];
292
- expect(wrappedCallback).toBeDefined();
293
- const result = await wrappedCallback({}, {});
294
- expect(result._meta).toBeDefined();
295
- expect(result._meta?.viewUUID).toBeDefined();
296
- expect(typeof result._meta?.viewUUID).toBe("string");
297
- // UUID v4 format
298
- expect(result._meta?.viewUUID).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/);
299
- });
300
- it("should preserve existing _meta when injecting viewUUID", async () => {
301
- const mockToolCallback = vi.fn().mockResolvedValue({
302
- content: [{ type: "text", text: "result" }],
303
- structuredContent: { data: "test" },
304
- _meta: { requestId: "req-123", cached: true },
305
- });
306
- server.registerWidget("my-widget", { description: "Test widget" }, { description: "Test tool" }, mockToolCallback);
307
- const wrappedCallback = mockRegisterTool.mock.calls[0]?.[2];
308
- const result = await wrappedCallback({}, {});
309
- expect(result._meta?.requestId).toBe("req-123");
310
- expect(result._meta?.cached).toBe(true);
311
- expect(result._meta?.viewUUID).toBeDefined();
312
- });
313
- it("should generate unique viewUUIDs across calls", async () => {
314
- const mockToolCallback = vi.fn().mockResolvedValue({
315
- content: [{ type: "text", text: "result" }],
316
- structuredContent: {},
317
- });
318
- server.registerWidget("my-widget", { description: "Test widget" }, { description: "Test tool" }, mockToolCallback);
319
- const wrappedCallback = mockRegisterTool.mock.calls[0]?.[2];
320
- const result1 = await wrappedCallback({}, {});
321
- const result2 = await wrappedCallback({}, {});
322
- expect(result1._meta?.viewUUID).not.toBe(result2._meta?.viewUUID);
323
- });
324
- it("should register tool with uopenai/outputTemplate metadata only", async () => {
325
- const mockToolCallback = vi.fn();
326
- server.registerWidget("my-widget", { description: "Test widget", hosts: ["apps-sdk"] }, { description: "Test tool" }, mockToolCallback);
327
- expect(mockRegisterTool).toHaveBeenCalledTimes(1);
328
- const toolCallArgs = mockRegisterTool.mock.calls[0];
329
- const toolConfig = toolCallArgs?.[1];
330
- expect(toolConfig._meta).not.toHaveProperty("ui");
331
- expect(toolConfig._meta?.["openai/outputTemplate"]).to.eq("ui://widgets/apps-sdk/my-widget.html");
332
- });
333
- });
334
- //# sourceMappingURL=widget.test.js.map