@n24q02m/workspace 0.0.0-stage → 0.6.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (331) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +46 -0
  3. package/README.md +342 -2
  4. package/bin/cli.mjs +144 -0
  5. package/build/src/auth/account-context.d.ts +3 -0
  6. package/build/src/auth/account-context.d.ts.map +1 -0
  7. package/build/src/auth/account-context.js +17 -0
  8. package/build/src/auth/account-context.js.map +1 -0
  9. package/build/src/auth/account-context.test.d.ts +2 -0
  10. package/build/src/auth/account-context.test.d.ts.map +1 -0
  11. package/build/src/auth/account-context.test.js +30 -0
  12. package/build/src/auth/account-context.test.js.map +1 -0
  13. package/build/src/auth/account-store.d.ts +87 -0
  14. package/build/src/auth/account-store.d.ts.map +1 -0
  15. package/build/src/auth/account-store.js +187 -0
  16. package/build/src/auth/account-store.js.map +1 -0
  17. package/build/src/auth/account-store.test.d.ts +2 -0
  18. package/build/src/auth/account-store.test.d.ts.map +1 -0
  19. package/build/src/auth/account-store.test.js +264 -0
  20. package/build/src/auth/account-store.test.js.map +1 -0
  21. package/build/src/auth/add-account.d.ts +12 -0
  22. package/build/src/auth/add-account.d.ts.map +1 -0
  23. package/build/src/auth/add-account.js +95 -0
  24. package/build/src/auth/add-account.js.map +1 -0
  25. package/build/src/auth/add-account.test.d.ts +2 -0
  26. package/build/src/auth/add-account.test.d.ts.map +1 -0
  27. package/build/src/auth/add-account.test.js +155 -0
  28. package/build/src/auth/add-account.test.js.map +1 -0
  29. package/build/src/auth/cli-auth.d.ts +2 -0
  30. package/build/src/auth/cli-auth.d.ts.map +1 -0
  31. package/build/src/auth/cli-auth.js +47 -0
  32. package/build/src/auth/cli-auth.js.map +1 -0
  33. package/build/src/auth/cli-auth.test.d.ts +2 -0
  34. package/build/src/auth/cli-auth.test.d.ts.map +1 -0
  35. package/build/src/auth/cli-auth.test.js +78 -0
  36. package/build/src/auth/cli-auth.test.js.map +1 -0
  37. package/build/src/auth/consent-server.d.ts +43 -0
  38. package/build/src/auth/consent-server.d.ts.map +1 -0
  39. package/build/src/auth/consent-server.js +56 -0
  40. package/build/src/auth/consent-server.js.map +1 -0
  41. package/build/src/auth/credential-state.d.ts +7 -0
  42. package/build/src/auth/credential-state.d.ts.map +1 -0
  43. package/build/src/auth/credential-state.js +64 -0
  44. package/build/src/auth/credential-state.js.map +1 -0
  45. package/build/src/auth/credential-state.test.d.ts +2 -0
  46. package/build/src/auth/credential-state.test.d.ts.map +1 -0
  47. package/build/src/auth/credential-state.test.js +142 -0
  48. package/build/src/auth/credential-state.test.js.map +1 -0
  49. package/build/src/auth/loopback-consent.d.ts +23 -0
  50. package/build/src/auth/loopback-consent.d.ts.map +1 -0
  51. package/build/src/auth/loopback-consent.js +145 -0
  52. package/build/src/auth/loopback-consent.js.map +1 -0
  53. package/build/src/auth/loopback-consent.test.d.ts +2 -0
  54. package/build/src/auth/loopback-consent.test.d.ts.map +1 -0
  55. package/build/src/auth/loopback-consent.test.js +131 -0
  56. package/build/src/auth/loopback-consent.test.js.map +1 -0
  57. package/build/src/auth/oauth-setup.d.ts +10 -0
  58. package/build/src/auth/oauth-setup.d.ts.map +1 -0
  59. package/build/src/auth/oauth-setup.js +92 -0
  60. package/build/src/auth/oauth-setup.js.map +1 -0
  61. package/build/src/auth/oauth-setup.test.d.ts +2 -0
  62. package/build/src/auth/oauth-setup.test.d.ts.map +1 -0
  63. package/build/src/auth/oauth-setup.test.js +164 -0
  64. package/build/src/auth/oauth-setup.test.js.map +1 -0
  65. package/build/src/auth/subject-context.d.ts +2 -0
  66. package/build/src/auth/subject-context.d.ts.map +1 -0
  67. package/build/src/auth/subject-context.js +16 -0
  68. package/build/src/auth/subject-context.js.map +1 -0
  69. package/build/src/auth/subject-context.test.d.ts +2 -0
  70. package/build/src/auth/subject-context.test.d.ts.map +1 -0
  71. package/build/src/auth/subject-context.test.js +34 -0
  72. package/build/src/auth/subject-context.test.js.map +1 -0
  73. package/build/src/auth/workspace-auth.d.ts +47 -0
  74. package/build/src/auth/workspace-auth.d.ts.map +1 -0
  75. package/build/src/auth/workspace-auth.js +123 -0
  76. package/build/src/auth/workspace-auth.js.map +1 -0
  77. package/build/src/auth/workspace-auth.test.d.ts +2 -0
  78. package/build/src/auth/workspace-auth.test.d.ts.map +1 -0
  79. package/build/src/auth/workspace-auth.test.js +242 -0
  80. package/build/src/auth/workspace-auth.test.js.map +1 -0
  81. package/build/src/constants.d.ts +6 -0
  82. package/build/src/constants.d.ts.map +1 -0
  83. package/build/src/constants.js +11 -0
  84. package/build/src/constants.js.map +1 -0
  85. package/build/src/create-server.d.ts +13 -0
  86. package/build/src/create-server.d.ts.map +1 -0
  87. package/build/src/create-server.js +34 -0
  88. package/build/src/create-server.js.map +1 -0
  89. package/build/src/create-server.test.d.ts +2 -0
  90. package/build/src/create-server.test.d.ts.map +1 -0
  91. package/build/src/create-server.test.js +13 -0
  92. package/build/src/create-server.test.js.map +1 -0
  93. package/build/src/docs/calendar.md +15 -0
  94. package/build/src/docs/chat.md +15 -0
  95. package/build/src/docs/config.md +117 -0
  96. package/build/src/docs/docs.md +36 -0
  97. package/build/src/docs/drive.md +15 -0
  98. package/build/src/docs/forms.md +119 -0
  99. package/build/src/docs/gmail.md +18 -0
  100. package/build/src/docs/overview.md +52 -0
  101. package/build/src/docs/people.md +10 -0
  102. package/build/src/docs/sheets.md +10 -0
  103. package/build/src/docs/slides.md +26 -0
  104. package/build/src/docs/tasks.md +13 -0
  105. package/build/src/docs/time.md +11 -0
  106. package/build/src/init-server.d.ts +10 -0
  107. package/build/src/init-server.d.ts.map +1 -0
  108. package/build/src/init-server.js +13 -0
  109. package/build/src/init-server.js.map +1 -0
  110. package/build/src/init-server.test.d.ts +2 -0
  111. package/build/src/init-server.test.d.ts.map +1 -0
  112. package/build/src/init-server.test.js +15 -0
  113. package/build/src/init-server.test.js.map +1 -0
  114. package/build/src/main.d.ts +33 -0
  115. package/build/src/main.d.ts.map +1 -0
  116. package/build/src/main.js +120 -0
  117. package/build/src/main.js.map +1 -0
  118. package/build/src/main.test.d.ts +2 -0
  119. package/build/src/main.test.d.ts.map +1 -0
  120. package/build/src/main.test.js +204 -0
  121. package/build/src/main.test.js.map +1 -0
  122. package/build/src/services/FormsService.d.ts +89 -0
  123. package/build/src/services/FormsService.d.ts.map +1 -0
  124. package/build/src/services/FormsService.js +140 -0
  125. package/build/src/services/FormsService.js.map +1 -0
  126. package/build/src/services/FormsService.test.d.ts +2 -0
  127. package/build/src/services/FormsService.test.d.ts.map +1 -0
  128. package/build/src/services/FormsService.test.js +173 -0
  129. package/build/src/services/FormsService.test.js.map +1 -0
  130. package/build/src/tools/config.d.ts +19 -0
  131. package/build/src/tools/config.d.ts.map +1 -0
  132. package/build/src/tools/config.js +100 -0
  133. package/build/src/tools/config.js.map +1 -0
  134. package/build/src/tools/config.test.d.ts +2 -0
  135. package/build/src/tools/config.test.d.ts.map +1 -0
  136. package/build/src/tools/config.test.js +201 -0
  137. package/build/src/tools/config.test.js.map +1 -0
  138. package/build/src/tools/domains/calendar.d.ts +3 -0
  139. package/build/src/tools/domains/calendar.d.ts.map +1 -0
  140. package/build/src/tools/domains/calendar.js +14 -0
  141. package/build/src/tools/domains/calendar.js.map +1 -0
  142. package/build/src/tools/domains/chat.d.ts +3 -0
  143. package/build/src/tools/domains/chat.d.ts.map +1 -0
  144. package/build/src/tools/domains/chat.js +16 -0
  145. package/build/src/tools/domains/chat.js.map +1 -0
  146. package/build/src/tools/domains/docs.d.ts +8 -0
  147. package/build/src/tools/domains/docs.d.ts.map +1 -0
  148. package/build/src/tools/domains/docs.js +11 -0
  149. package/build/src/tools/domains/docs.js.map +1 -0
  150. package/build/src/tools/domains/docs.test.d.ts +2 -0
  151. package/build/src/tools/domains/docs.test.d.ts.map +1 -0
  152. package/build/src/tools/domains/docs.test.js +111 -0
  153. package/build/src/tools/domains/docs.test.js.map +1 -0
  154. package/build/src/tools/domains/drive.d.ts +3 -0
  155. package/build/src/tools/domains/drive.d.ts.map +1 -0
  156. package/build/src/tools/domains/drive.js +14 -0
  157. package/build/src/tools/domains/drive.js.map +1 -0
  158. package/build/src/tools/domains/factory.d.ts +24 -0
  159. package/build/src/tools/domains/factory.d.ts.map +1 -0
  160. package/build/src/tools/domains/factory.js +43 -0
  161. package/build/src/tools/domains/factory.js.map +1 -0
  162. package/build/src/tools/domains/factory.test.d.ts +2 -0
  163. package/build/src/tools/domains/factory.test.d.ts.map +1 -0
  164. package/build/src/tools/domains/factory.test.js +48 -0
  165. package/build/src/tools/domains/factory.test.js.map +1 -0
  166. package/build/src/tools/domains/forms.d.ts +9 -0
  167. package/build/src/tools/domains/forms.d.ts.map +1 -0
  168. package/build/src/tools/domains/forms.js +12 -0
  169. package/build/src/tools/domains/forms.js.map +1 -0
  170. package/build/src/tools/domains/forms.test.d.ts +2 -0
  171. package/build/src/tools/domains/forms.test.d.ts.map +1 -0
  172. package/build/src/tools/domains/forms.test.js +93 -0
  173. package/build/src/tools/domains/forms.test.js.map +1 -0
  174. package/build/src/tools/domains/gmail.d.ts +3 -0
  175. package/build/src/tools/domains/gmail.d.ts.map +1 -0
  176. package/build/src/tools/domains/gmail.js +17 -0
  177. package/build/src/tools/domains/gmail.js.map +1 -0
  178. package/build/src/tools/domains/index.d.ts +20 -0
  179. package/build/src/tools/domains/index.d.ts.map +1 -0
  180. package/build/src/tools/domains/index.js +230 -0
  181. package/build/src/tools/domains/index.js.map +1 -0
  182. package/build/src/tools/domains/people.d.ts +3 -0
  183. package/build/src/tools/domains/people.d.ts.map +1 -0
  184. package/build/src/tools/domains/people.js +5 -0
  185. package/build/src/tools/domains/people.js.map +1 -0
  186. package/build/src/tools/domains/sheets.d.ts +3 -0
  187. package/build/src/tools/domains/sheets.d.ts.map +1 -0
  188. package/build/src/tools/domains/sheets.js +5 -0
  189. package/build/src/tools/domains/sheets.js.map +1 -0
  190. package/build/src/tools/domains/slides.d.ts +3 -0
  191. package/build/src/tools/domains/slides.d.ts.map +1 -0
  192. package/build/src/tools/domains/slides.js +25 -0
  193. package/build/src/tools/domains/slides.js.map +1 -0
  194. package/build/src/tools/domains/tasks.d.ts +3 -0
  195. package/build/src/tools/domains/tasks.d.ts.map +1 -0
  196. package/build/src/tools/domains/tasks.js +14 -0
  197. package/build/src/tools/domains/tasks.js.map +1 -0
  198. package/build/src/tools/domains/time.d.ts +3 -0
  199. package/build/src/tools/domains/time.d.ts.map +1 -0
  200. package/build/src/tools/domains/time.js +6 -0
  201. package/build/src/tools/domains/time.js.map +1 -0
  202. package/build/src/tools/helpers/errors.d.ts +48 -0
  203. package/build/src/tools/helpers/errors.d.ts.map +1 -0
  204. package/build/src/tools/helpers/errors.js +290 -0
  205. package/build/src/tools/helpers/errors.js.map +1 -0
  206. package/build/src/tools/helpers/errors.test.d.ts +2 -0
  207. package/build/src/tools/helpers/errors.test.d.ts.map +1 -0
  208. package/build/src/tools/helpers/errors.test.js +220 -0
  209. package/build/src/tools/helpers/errors.test.js.map +1 -0
  210. package/build/src/tools/registry.d.ts +14 -0
  211. package/build/src/tools/registry.d.ts.map +1 -0
  212. package/build/src/tools/registry.js +276 -0
  213. package/build/src/tools/registry.js.map +1 -0
  214. package/build/src/tools/registry.test.d.ts +2 -0
  215. package/build/src/tools/registry.test.d.ts.map +1 -0
  216. package/build/src/tools/registry.test.js +321 -0
  217. package/build/src/tools/registry.test.js.map +1 -0
  218. package/build/src/transports/http.d.ts +7 -0
  219. package/build/src/transports/http.d.ts.map +1 -0
  220. package/build/src/transports/http.js +56 -0
  221. package/build/src/transports/http.js.map +1 -0
  222. package/build/src/transports/http.test.d.ts +2 -0
  223. package/build/src/transports/http.test.d.ts.map +1 -0
  224. package/build/src/transports/http.test.js +76 -0
  225. package/build/src/transports/http.test.js.map +1 -0
  226. package/build/src/vendored/auth/AuthManager.d.ts +7 -0
  227. package/build/src/vendored/auth/AuthManager.d.ts.map +1 -0
  228. package/build/src/vendored/auth/AuthManager.js +11 -0
  229. package/build/src/vendored/auth/AuthManager.js.map +1 -0
  230. package/build/src/vendored/services/CalendarService.d.ts +164 -0
  231. package/build/src/vendored/services/CalendarService.d.ts.map +1 -0
  232. package/build/src/vendored/services/CalendarService.js +726 -0
  233. package/build/src/vendored/services/CalendarService.js.map +1 -0
  234. package/build/src/vendored/services/CalendarValidation.d.ts +9 -0
  235. package/build/src/vendored/services/CalendarValidation.d.ts.map +1 -0
  236. package/build/src/vendored/services/CalendarValidation.js +125 -0
  237. package/build/src/vendored/services/CalendarValidation.js.map +1 -0
  238. package/build/src/vendored/services/ChatService.d.ts +90 -0
  239. package/build/src/vendored/services/ChatService.d.ts.map +1 -0
  240. package/build/src/vendored/services/ChatService.js +451 -0
  241. package/build/src/vendored/services/ChatService.js.map +1 -0
  242. package/build/src/vendored/services/DocsService.d.ts +109 -0
  243. package/build/src/vendored/services/DocsService.d.ts.map +1 -0
  244. package/build/src/vendored/services/DocsService.js +663 -0
  245. package/build/src/vendored/services/DocsService.js.map +1 -0
  246. package/build/src/vendored/services/DocsService.test.d.ts +2 -0
  247. package/build/src/vendored/services/DocsService.test.d.ts.map +1 -0
  248. package/build/src/vendored/services/DocsService.test.js +77 -0
  249. package/build/src/vendored/services/DocsService.test.js.map +1 -0
  250. package/build/src/vendored/services/DriveService.d.ts +117 -0
  251. package/build/src/vendored/services/DriveService.d.ts.map +1 -0
  252. package/build/src/vendored/services/DriveService.js +527 -0
  253. package/build/src/vendored/services/DriveService.js.map +1 -0
  254. package/build/src/vendored/services/DriveService.test.d.ts +2 -0
  255. package/build/src/vendored/services/DriveService.test.d.ts.map +1 -0
  256. package/build/src/vendored/services/DriveService.test.js +115 -0
  257. package/build/src/vendored/services/DriveService.test.js.map +1 -0
  258. package/build/src/vendored/services/GmailService.d.ts +137 -0
  259. package/build/src/vendored/services/GmailService.d.ts.map +1 -0
  260. package/build/src/vendored/services/GmailService.js +681 -0
  261. package/build/src/vendored/services/GmailService.js.map +1 -0
  262. package/build/src/vendored/services/PeopleService.d.ts +42 -0
  263. package/build/src/vendored/services/PeopleService.d.ts.map +1 -0
  264. package/build/src/vendored/services/PeopleService.js +168 -0
  265. package/build/src/vendored/services/PeopleService.js.map +1 -0
  266. package/build/src/vendored/services/SheetsService.d.ts +52 -0
  267. package/build/src/vendored/services/SheetsService.d.ts.map +1 -0
  268. package/build/src/vendored/services/SheetsService.js +262 -0
  269. package/build/src/vendored/services/SheetsService.js.map +1 -0
  270. package/build/src/vendored/services/SheetsService.test.d.ts +2 -0
  271. package/build/src/vendored/services/SheetsService.test.d.ts.map +1 -0
  272. package/build/src/vendored/services/SheetsService.test.js +104 -0
  273. package/build/src/vendored/services/SheetsService.test.js.map +1 -0
  274. package/build/src/vendored/services/SlidesService.d.ts +167 -0
  275. package/build/src/vendored/services/SlidesService.d.ts.map +1 -0
  276. package/build/src/vendored/services/SlidesService.js +887 -0
  277. package/build/src/vendored/services/SlidesService.js.map +1 -0
  278. package/build/src/vendored/services/TasksService.d.ts +97 -0
  279. package/build/src/vendored/services/TasksService.d.ts.map +1 -0
  280. package/build/src/vendored/services/TasksService.js +234 -0
  281. package/build/src/vendored/services/TasksService.js.map +1 -0
  282. package/build/src/vendored/services/TimeService.d.ts +29 -0
  283. package/build/src/vendored/services/TimeService.d.ts.map +1 -0
  284. package/build/src/vendored/services/TimeService.js +71 -0
  285. package/build/src/vendored/services/TimeService.js.map +1 -0
  286. package/build/src/vendored/utils/DriveQueryBuilder.d.ts +15 -0
  287. package/build/src/vendored/utils/DriveQueryBuilder.d.ts.map +1 -0
  288. package/build/src/vendored/utils/DriveQueryBuilder.js +17 -0
  289. package/build/src/vendored/utils/DriveQueryBuilder.js.map +1 -0
  290. package/build/src/vendored/utils/GaxiosConfig.d.ts +9 -0
  291. package/build/src/vendored/utils/GaxiosConfig.d.ts.map +1 -0
  292. package/build/src/vendored/utils/GaxiosConfig.js +30 -0
  293. package/build/src/vendored/utils/GaxiosConfig.js.map +1 -0
  294. package/build/src/vendored/utils/IdUtils.d.ts +13 -0
  295. package/build/src/vendored/utils/IdUtils.d.ts.map +1 -0
  296. package/build/src/vendored/utils/IdUtils.js +29 -0
  297. package/build/src/vendored/utils/IdUtils.js.map +1 -0
  298. package/build/src/vendored/utils/MimeHelper.d.ts +64 -0
  299. package/build/src/vendored/utils/MimeHelper.d.ts.map +1 -0
  300. package/build/src/vendored/utils/MimeHelper.js +174 -0
  301. package/build/src/vendored/utils/MimeHelper.js.map +1 -0
  302. package/build/src/vendored/utils/MimeHelper.test.d.ts +2 -0
  303. package/build/src/vendored/utils/MimeHelper.test.d.ts.map +1 -0
  304. package/build/src/vendored/utils/MimeHelper.test.js +47 -0
  305. package/build/src/vendored/utils/MimeHelper.test.js.map +1 -0
  306. package/build/src/vendored/utils/constants.d.ts +9 -0
  307. package/build/src/vendored/utils/constants.d.ts.map +1 -0
  308. package/build/src/vendored/utils/constants.js +9 -0
  309. package/build/src/vendored/utils/constants.js.map +1 -0
  310. package/build/src/vendored/utils/logger.d.ts +3 -0
  311. package/build/src/vendored/utils/logger.d.ts.map +1 -0
  312. package/build/src/vendored/utils/logger.js +15 -0
  313. package/build/src/vendored/utils/logger.js.map +1 -0
  314. package/build/src/vendored/utils/paths.d.ts +2 -0
  315. package/build/src/vendored/utils/paths.d.ts.map +1 -0
  316. package/build/src/vendored/utils/paths.js +19 -0
  317. package/build/src/vendored/utils/paths.js.map +1 -0
  318. package/build/src/vendored/utils/validation.d.ts +100 -0
  319. package/build/src/vendored/utils/validation.d.ts.map +1 -0
  320. package/build/src/vendored/utils/validation.js +161 -0
  321. package/build/src/vendored/utils/validation.js.map +1 -0
  322. package/build/src/version.d.ts +2 -0
  323. package/build/src/version.d.ts.map +1 -0
  324. package/build/src/version.js +29 -0
  325. package/build/src/version.js.map +1 -0
  326. package/build/src/version.test.d.ts +2 -0
  327. package/build/src/version.test.d.ts.map +1 -0
  328. package/build/src/version.test.js +19 -0
  329. package/build/src/version.test.js.map +1 -0
  330. package/build/tsconfig.tsbuildinfo +1 -0
  331. package/package.json +69 -4
@@ -0,0 +1,204 @@
1
+ import { join } from 'node:path';
2
+ import { fileURLToPath } from 'node:url';
3
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
4
+ import { buildCli } from '@n24q02m/hull';
5
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
6
+ // startServer/bootstrap need every I/O-touching dependency mocked so the
7
+ // suite stays hermetic: no real Google OAuth, no real stdio transport.
8
+ vi.mock('./auth/credential-state.js', () => ({
9
+ getState: vi.fn(),
10
+ resolveCredentialState: vi.fn()
11
+ }));
12
+ vi.mock('./auth/oauth-setup.js', () => ({ runOAuthSetup: vi.fn() }));
13
+ vi.mock('./tools/registry.js', () => ({ registerTools: vi.fn() }));
14
+ // main.ts loads the http transport through a static import; vi.mock replaces it here.
15
+ vi.mock('./transports/http.js', () => ({ startHttp: vi.fn() }));
16
+ // main.ts builds the console script with hull buildCli; keep the rest of hull real.
17
+ vi.mock('@n24q02m/hull', async (importOriginal) => ({
18
+ ...(await importOriginal()),
19
+ buildCli: vi.fn()
20
+ }));
21
+ vi.mock('@modelcontextprotocol/sdk/server/stdio.js', () => ({
22
+ // Must be `new`-able (main.ts does `new StdioServerTransport()`) -- an
23
+ // arrow-function mock implementation cannot be a constructor.
24
+ StdioServerTransport: vi.fn(function StdioServerTransport() {
25
+ this.start = vi.fn().mockResolvedValue(undefined);
26
+ })
27
+ }));
28
+ import { getState, resolveCredentialState } from './auth/credential-state.js';
29
+ import { runOAuthSetup } from './auth/oauth-setup.js';
30
+ import { bootstrap, getTransportMode, isMain, runCli, startServer } from './main.js';
31
+ import { registerTools } from './tools/registry.js';
32
+ import { startHttp } from './transports/http.js';
33
+ describe('getTransportMode', () => {
34
+ const originalEnv = process.env;
35
+ const originalArgv = process.argv;
36
+ beforeEach(() => {
37
+ process.env = { ...originalEnv };
38
+ process.argv = [...originalArgv];
39
+ });
40
+ afterEach(() => {
41
+ process.env = originalEnv;
42
+ process.argv = originalArgv;
43
+ vi.unstubAllEnvs();
44
+ });
45
+ it('defaults to stdio when no flag or env is set', () => {
46
+ expect(getTransportMode({}, [])).toBe('stdio');
47
+ });
48
+ it('selects http via the --http flag', () => {
49
+ expect(getTransportMode({}, ['--http'])).toBe('http');
50
+ });
51
+ it('does not match a flag that merely starts with --http', () => {
52
+ expect(getTransportMode({}, ['--http-proxy'])).toBe('stdio');
53
+ });
54
+ it('selects http via MCP_TRANSPORT=http', () => {
55
+ expect(getTransportMode({ MCP_TRANSPORT: 'http' }, [])).toBe('http');
56
+ });
57
+ it('selects http via TRANSPORT_MODE=http', () => {
58
+ expect(getTransportMode({ TRANSPORT_MODE: 'http' }, [])).toBe('http');
59
+ });
60
+ it('reads current process.env / process.argv when no arguments are provided', () => {
61
+ vi.stubEnv('TRANSPORT_MODE', 'http');
62
+ expect(getTransportMode()).toBe('http');
63
+ });
64
+ });
65
+ describe('startServer', () => {
66
+ const originalEnv = process.env;
67
+ let errorSpy;
68
+ beforeEach(() => {
69
+ // Fresh copy each test -- startServer mutates BETTER_WORKSPACE_MCP_BOOTSTRAPPED
70
+ // as a side effect, so this must not leak between tests.
71
+ process.env = { ...originalEnv };
72
+ vi.clearAllMocks();
73
+ errorSpy = vi.spyOn(console, 'error').mockImplementation(() => undefined);
74
+ });
75
+ afterEach(() => {
76
+ process.env = originalEnv;
77
+ errorSpy.mockRestore();
78
+ });
79
+ it('hands http mode to the http transport without touching the stdio OAuth path', async () => {
80
+ vi.mocked(startHttp).mockResolvedValue(undefined);
81
+ await startServer('http');
82
+ expect(startHttp).toHaveBeenCalledOnce();
83
+ // The stdio branch runs the Google consent in the browser. Over HTTP that consent is
84
+ // handled by the host CLI `auth` command, so it must NOT run in http mode.
85
+ expect(runOAuthSetup).not.toHaveBeenCalled();
86
+ expect(resolveCredentialState).not.toHaveBeenCalled();
87
+ expect(registerTools).not.toHaveBeenCalled();
88
+ });
89
+ it('serves directly without OAuth setup when already configured', async () => {
90
+ vi.mocked(resolveCredentialState).mockResolvedValue('configured');
91
+ vi.mocked(getState).mockReturnValue('configured');
92
+ await startServer('stdio');
93
+ expect(runOAuthSetup).not.toHaveBeenCalled();
94
+ expect(resolveCredentialState).toHaveBeenCalledOnce();
95
+ expect(registerTools).toHaveBeenCalledWith(expect.any(Server));
96
+ });
97
+ it('runs OAuth setup before serving when not yet configured', async () => {
98
+ vi.mocked(resolveCredentialState).mockResolvedValue('awaiting_setup');
99
+ vi.mocked(getState).mockReturnValue('awaiting_setup');
100
+ vi.mocked(runOAuthSetup).mockResolvedValue(undefined);
101
+ await startServer('stdio');
102
+ expect(runOAuthSetup).toHaveBeenCalledOnce();
103
+ expect(resolveCredentialState).toHaveBeenCalledTimes(2);
104
+ expect(registerTools).toHaveBeenCalledWith(expect.any(Server));
105
+ });
106
+ it('returns early on a second call in the same process (fork-bomb guard)', async () => {
107
+ process.env.BETTER_WORKSPACE_MCP_BOOTSTRAPPED = 'true';
108
+ await expect(startServer('http')).resolves.toBeUndefined();
109
+ expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining('Startup aborted'));
110
+ // Không transport nào được dựng: guard phải chặn TRƯỚC cả nhánh mode. `startHttp`
111
+ // là bằng chứng cho nhánh http (trước đây là cái throw Milestone-3, nay không còn).
112
+ expect(startHttp).not.toHaveBeenCalled();
113
+ expect(resolveCredentialState).not.toHaveBeenCalled();
114
+ expect(registerTools).not.toHaveBeenCalled();
115
+ });
116
+ });
117
+ describe('bootstrap', () => {
118
+ const originalEnv = process.env;
119
+ let exitSpy;
120
+ let errorSpy;
121
+ beforeEach(() => {
122
+ process.env = { ...originalEnv };
123
+ vi.clearAllMocks();
124
+ exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => undefined);
125
+ errorSpy = vi.spyOn(console, 'error').mockImplementation(() => undefined);
126
+ });
127
+ afterEach(() => {
128
+ process.env = originalEnv;
129
+ exitSpy.mockRestore();
130
+ errorSpy.mockRestore();
131
+ });
132
+ it('catches a thrown error and exits the process with code 1', async () => {
133
+ // A transport that cannot start (for example http mode without CREDENTIAL_SECRET) must
134
+ // surface through bootstrap. The throw is simulated here: startHttp is mocked.
135
+ vi.mocked(startHttp).mockRejectedValue(new Error('CREDENTIAL_SECRET is required for http mode: per-user credential stores derive their encryption key from it.'));
136
+ await bootstrap('http');
137
+ expect(errorSpy).toHaveBeenCalledWith('Failed to start server:', 'CREDENTIAL_SECRET is required for http mode: per-user credential stores derive their encryption key from it.');
138
+ expect(exitSpy).toHaveBeenCalledWith(1);
139
+ });
140
+ });
141
+ describe('isMain', () => {
142
+ const originalArgv = process.argv;
143
+ const originalPlatform = process.platform;
144
+ afterEach(() => {
145
+ process.argv = originalArgv;
146
+ Object.defineProperty(process, 'platform', { value: originalPlatform });
147
+ });
148
+ it('matches the module against its own entry path', () => {
149
+ process.argv = ['node', fileURLToPath(import.meta.url)];
150
+ expect(isMain(import.meta.url)).toBe(true);
151
+ });
152
+ it('compares normalized paths on win32 and rejects a different entry', () => {
153
+ Object.defineProperty(process, 'platform', { value: 'win32' });
154
+ process.argv = ['node', fileURLToPath(import.meta.url)];
155
+ expect(isMain(import.meta.url)).toBe(true);
156
+ process.argv = ['node', join(process.cwd(), 'package.json')];
157
+ expect(isMain(import.meta.url)).toBe(false);
158
+ });
159
+ it('returns false when the entry path cannot be resolved', () => {
160
+ process.argv = ['node', join(process.cwd(), 'does-not-exist.js')];
161
+ expect(isMain(import.meta.url)).toBe(false);
162
+ });
163
+ });
164
+ describe('runCli', () => {
165
+ it('builds the CLI, delegates serve to bootstrap, and propagates the exit code', async () => {
166
+ const run = vi.fn().mockResolvedValue(3);
167
+ vi.mocked(buildCli).mockReturnValue(run);
168
+ const originalExitCode = process.exitCode;
169
+ const originalGuard = process.env.BETTER_WORKSPACE_MCP_BOOTSTRAPPED;
170
+ // Pre-set the guard so serve() logs and returns without starting a real transport.
171
+ process.env.BETTER_WORKSPACE_MCP_BOOTSTRAPPED = 'true';
172
+ const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => undefined);
173
+ try {
174
+ await runCli(['status']);
175
+ expect(run).toHaveBeenCalledWith(['status']);
176
+ expect(process.exitCode).toBe(3);
177
+ const options = vi.mocked(buildCli).mock.calls[0]?.[1];
178
+ await options.serve();
179
+ expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining('already running'));
180
+ }
181
+ finally {
182
+ process.exitCode = originalExitCode;
183
+ errorSpy.mockRestore();
184
+ if (originalGuard === undefined)
185
+ delete process.env.BETTER_WORKSPACE_MCP_BOOTSTRAPPED;
186
+ else
187
+ process.env.BETTER_WORKSPACE_MCP_BOOTSTRAPPED = originalGuard;
188
+ }
189
+ });
190
+ it('refuses the removed hull relay built-in with exit 2 and a pointer to auth', async () => {
191
+ vi.mocked(buildCli).mockReturnValue(vi.fn().mockResolvedValue(0));
192
+ const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => undefined);
193
+ try {
194
+ await runCli(['relay']);
195
+ const options = vi.mocked(buildCli).mock.calls.at(-1)?.[1];
196
+ expect(await options.extra.relay()).toBe(2);
197
+ expect(errorSpy).toHaveBeenCalledWith('relay was removed; run `workspace auth` (see README)');
198
+ }
199
+ finally {
200
+ errorSpy.mockRestore();
201
+ }
202
+ });
203
+ });
204
+ //# sourceMappingURL=main.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"main.test.js","sourceRoot":"","sources":["../../src/main.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * Google Forms service. Ours, not vendored: gemini-cli-extensions/workspace has
3
+ * no Forms coverage, so this file lives outside src/vendored/ where the upstream
4
+ * sync would otherwise report it as drift (see NOTICE). It follows the vendored
5
+ * services' shape -- constructed with an AuthManager, a private client getter,
6
+ * public arrow-fn properties returning the MCP CallTool result -- so the domain
7
+ * factory dispatches into it exactly like the other ten domains.
8
+ *
9
+ * One deliberate difference: API failures are thrown, not caught and returned as
10
+ * a success-shaped result whose text happens to be {"error": ...}. The tool
11
+ * layer (withErrorHandling -> registry) renders a thrown error as a real
12
+ * isError result with sanitized details; swallowing it here would tell the
13
+ * caller the call succeeded.
14
+ *
15
+ * Scope note: everything here is covered by the two Forms scopes already in
16
+ * WORKSPACE_SCOPES -- forms.body for create/get/batchUpdate, and
17
+ * forms.responses.readonly for the two response reads.
18
+ */
19
+ import { type forms_v1 } from 'googleapis';
20
+ import type { AuthManager } from '../vendored/auth/AuthManager.js';
21
+ export declare class FormsService {
22
+ private authManager;
23
+ constructor(authManager: AuthManager);
24
+ /**
25
+ * A new client per call, on purpose. Caching one in a field would pin the
26
+ * OAuth2Client of whichever account called first and hand it to every later
27
+ * caller -- the credential-isolation bug multi-account exists to prevent.
28
+ */
29
+ private getFormsClient;
30
+ /**
31
+ * Create an empty form. The API copies only `info.title` and
32
+ * `info.documentTitle`; questions, description and settings are rejected here
33
+ * and must follow in a `batchUpdate`.
34
+ */
35
+ create: ({ title, documentTitle }: {
36
+ title: string;
37
+ documentTitle?: string;
38
+ }) => Promise<{
39
+ content: {
40
+ type: "text";
41
+ text: string;
42
+ }[];
43
+ }>;
44
+ /** Read a form's definition: metadata, items, and the responder URI. */
45
+ get: ({ formId }: {
46
+ formId: string;
47
+ }) => Promise<{
48
+ content: {
49
+ type: "text";
50
+ text: string;
51
+ }[];
52
+ }>;
53
+ /**
54
+ * Apply a batch of update requests -- this is the only way to add or change
55
+ * questions, the description, or form settings after creation.
56
+ */
57
+ batchUpdate: ({ formId, requests }: {
58
+ formId: string;
59
+ requests: forms_v1.Schema$Request[];
60
+ }) => Promise<{
61
+ content: {
62
+ type: "text";
63
+ text: string;
64
+ }[];
65
+ }>;
66
+ /** List submitted responses. Read-only: the API has no way to write one. */
67
+ listResponses: ({ formId, pageSize, pageToken, filter }: {
68
+ formId: string;
69
+ pageSize?: number;
70
+ pageToken?: string;
71
+ filter?: string;
72
+ }) => Promise<{
73
+ content: {
74
+ type: "text";
75
+ text: string;
76
+ }[];
77
+ }>;
78
+ /** Read one submitted response by ID. */
79
+ getResponse: ({ formId, responseId }: {
80
+ formId: string;
81
+ responseId: string;
82
+ }) => Promise<{
83
+ content: {
84
+ type: "text";
85
+ text: string;
86
+ }[];
87
+ }>;
88
+ }
89
+ //# sourceMappingURL=FormsService.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FormsService.d.ts","sourceRoot":"","sources":["../../../src/services/FormsService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAU,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AA4ClE,qBAAa,YAAY;IACX,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE5C;;;;OAIG;YACW,cAAc;IAK5B;;;;OAIG;IACI,MAAM,GAAU,0BAA0B;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;OAczF;IAED,wEAAwE;IACjE,GAAG,GAAU,YAAY;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;;;;;OAMjD;IAED;;;OAGG;IACI,WAAW,GAAU,sBAAsB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAA;KAAE;;;;;OASxG;IAED,4EAA4E;IACrE,aAAa,GAAU,yCAK3B;QACD,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB;;;;;OAgBA;IAED,yCAAyC;IAClC,WAAW,GAAU,wBAAwB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;;;;;OASzF;CACF"}
@@ -0,0 +1,140 @@
1
+ /**
2
+ * Google Forms service. Ours, not vendored: gemini-cli-extensions/workspace has
3
+ * no Forms coverage, so this file lives outside src/vendored/ where the upstream
4
+ * sync would otherwise report it as drift (see NOTICE). It follows the vendored
5
+ * services' shape -- constructed with an AuthManager, a private client getter,
6
+ * public arrow-fn properties returning the MCP CallTool result -- so the domain
7
+ * factory dispatches into it exactly like the other ten domains.
8
+ *
9
+ * One deliberate difference: API failures are thrown, not caught and returned as
10
+ * a success-shaped result whose text happens to be {"error": ...}. The tool
11
+ * layer (withErrorHandling -> registry) renders a thrown error as a real
12
+ * isError result with sanitized details; swallowing it here would tell the
13
+ * caller the call succeeded.
14
+ *
15
+ * Scope note: everything here is covered by the two Forms scopes already in
16
+ * WORKSPACE_SCOPES -- forms.body for create/get/batchUpdate, and
17
+ * forms.responses.readonly for the two response reads.
18
+ */
19
+ import { google } from 'googleapis';
20
+ import { gaxiosOptions } from '../vendored/utils/GaxiosConfig.js';
21
+ import { logToFile } from '../vendored/utils/logger.js';
22
+ /** `.../forms/d/e/<responderId>/viewform` -- the public link, checked first. */
23
+ const RESPONDER_URL = /\/forms\/d\/e\/[\w-]+/;
24
+ /** `.../forms/d/<formId>/edit` -- the editor URL, whose ID the API accepts. */
25
+ const EDITOR_URL = /\/forms\/d\/([\w-]+)/;
26
+ /**
27
+ * Forms IDs reach us either bare or pasted inside a URL, and Forms has two URL
28
+ * shapes of which only one carries a usable ID. The editor URL
29
+ * (`/forms/d/<formId>/edit`) holds the API's form ID; the public responder link
30
+ * (`/forms/d/e/<responderId>/viewform`) holds a different identifier the API
31
+ * does not accept. The shared `/d/([\w-]+)/` rule the other domains use would
32
+ * quietly return the literal `"e"` for a responder link, so that shape is
33
+ * refused by name instead of failing later as an opaque 404.
34
+ */
35
+ function extractFormId(input) {
36
+ const value = input?.trim() ?? '';
37
+ if (!value) {
38
+ throw new Error('formId is required.');
39
+ }
40
+ if (!value.includes('/')) {
41
+ return value;
42
+ }
43
+ if (RESPONDER_URL.test(value)) {
44
+ throw new Error(`"${value}" is a form's public responder link, which carries a different ID than the API uses. Open the form for editing and pass the ID from https://docs.google.com/forms/d/<formId>/edit instead.`);
45
+ }
46
+ const editor = value.match(EDITOR_URL);
47
+ if (editor) {
48
+ return editor[1];
49
+ }
50
+ throw new Error(`Could not extract a form ID from "${value}". Pass the ID itself, or the editor URL https://docs.google.com/forms/d/<formId>/edit.`);
51
+ }
52
+ function asText(payload) {
53
+ return { content: [{ type: 'text', text: JSON.stringify(payload) }] };
54
+ }
55
+ export class FormsService {
56
+ constructor(authManager) {
57
+ this.authManager = authManager;
58
+ /**
59
+ * Create an empty form. The API copies only `info.title` and
60
+ * `info.documentTitle`; questions, description and settings are rejected here
61
+ * and must follow in a `batchUpdate`.
62
+ */
63
+ this.create = async ({ title, documentTitle }) => {
64
+ logToFile(`[FormsService] create title=${title}`);
65
+ if (!title?.trim()) {
66
+ throw new Error('title is required to create a form.');
67
+ }
68
+ const forms = await this.getFormsClient();
69
+ const res = await forms.forms.create({
70
+ requestBody: { info: { title, ...(documentTitle ? { documentTitle } : {}) } }
71
+ });
72
+ return asText({
73
+ formId: res.data.formId,
74
+ title: res.data.info?.title,
75
+ responderUri: res.data.responderUri
76
+ });
77
+ };
78
+ /** Read a form's definition: metadata, items, and the responder URI. */
79
+ this.get = async ({ formId }) => {
80
+ const id = extractFormId(formId);
81
+ logToFile(`[FormsService] get formId=${id}`);
82
+ const forms = await this.getFormsClient();
83
+ const res = await forms.forms.get({ formId: id });
84
+ return asText(res.data);
85
+ };
86
+ /**
87
+ * Apply a batch of update requests -- this is the only way to add or change
88
+ * questions, the description, or form settings after creation.
89
+ */
90
+ this.batchUpdate = async ({ formId, requests }) => {
91
+ const id = extractFormId(formId);
92
+ if (!Array.isArray(requests) || requests.length === 0) {
93
+ throw new Error('batchUpdate needs at least one request in `requests`.');
94
+ }
95
+ logToFile(`[FormsService] batchUpdate formId=${id}, ${requests.length} request(s)`);
96
+ const forms = await this.getFormsClient();
97
+ const res = await forms.forms.batchUpdate({ formId: id, requestBody: { requests } });
98
+ return asText(res.data);
99
+ };
100
+ /** List submitted responses. Read-only: the API has no way to write one. */
101
+ this.listResponses = async ({ formId, pageSize, pageToken, filter }) => {
102
+ const id = extractFormId(formId);
103
+ logToFile(`[FormsService] listResponses formId=${id}`);
104
+ const forms = await this.getFormsClient();
105
+ const res = await forms.forms.responses.list({
106
+ formId: id,
107
+ ...(pageSize === undefined ? {} : { pageSize }),
108
+ ...(pageToken === undefined ? {} : { pageToken }),
109
+ ...(filter === undefined ? {} : { filter })
110
+ });
111
+ // `responses` is absent, not empty, when a form has none -- report the
112
+ // distinction the caller cares about (no responses) rather than a hole.
113
+ return asText({
114
+ responses: res.data.responses ?? [],
115
+ ...(res.data.nextPageToken ? { nextPageToken: res.data.nextPageToken } : {})
116
+ });
117
+ };
118
+ /** Read one submitted response by ID. */
119
+ this.getResponse = async ({ formId, responseId }) => {
120
+ const id = extractFormId(formId);
121
+ if (!responseId?.trim()) {
122
+ throw new Error('responseId is required.');
123
+ }
124
+ logToFile(`[FormsService] getResponse formId=${id}, responseId=${responseId}`);
125
+ const forms = await this.getFormsClient();
126
+ const res = await forms.forms.responses.get({ formId: id, responseId });
127
+ return asText(res.data);
128
+ };
129
+ }
130
+ /**
131
+ * A new client per call, on purpose. Caching one in a field would pin the
132
+ * OAuth2Client of whichever account called first and hand it to every later
133
+ * caller -- the credential-isolation bug multi-account exists to prevent.
134
+ */
135
+ async getFormsClient() {
136
+ const auth = await this.authManager.getAuthenticatedClient();
137
+ return google.forms({ version: 'v1', ...gaxiosOptions, auth });
138
+ }
139
+ }
140
+ //# sourceMappingURL=FormsService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FormsService.js","sourceRoot":"","sources":["../../../src/services/FormsService.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=FormsService.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FormsService.test.d.ts","sourceRoot":"","sources":["../../../src/services/FormsService.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,173 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ // vi.mock() factories are hoisted above regular const declarations, so the
3
+ // mocks referenced inside must be created via vi.hoisted().
4
+ const { formsApi, formsFactory } = vi.hoisted(() => {
5
+ const formsApi = {
6
+ forms: {
7
+ create: vi.fn(),
8
+ get: vi.fn(),
9
+ batchUpdate: vi.fn(),
10
+ responses: { list: vi.fn(), get: vi.fn() }
11
+ }
12
+ };
13
+ return { formsApi, formsFactory: vi.fn(() => formsApi) };
14
+ });
15
+ vi.mock('googleapis', () => ({ google: { forms: formsFactory } }));
16
+ import { FormsService } from './FormsService.js';
17
+ /** Stands in for the AuthManager shim -- the service's only collaborator. */
18
+ function stubAuth() {
19
+ const client = { credentials: {} };
20
+ const getAuthenticatedClient = vi.fn(async () => client);
21
+ return { auth: { getAuthenticatedClient }, getAuthenticatedClient, client };
22
+ }
23
+ function textOf(result) {
24
+ return result.content[0]?.text ?? '';
25
+ }
26
+ describe('FormsService', () => {
27
+ let svc;
28
+ let auth;
29
+ beforeEach(() => {
30
+ vi.clearAllMocks();
31
+ auth = stubAuth();
32
+ svc = new FormsService(auth.auth);
33
+ });
34
+ describe('create', () => {
35
+ it('sends only info.title and returns the new form ID, title and responder URI', async () => {
36
+ formsApi.forms.create.mockResolvedValue({
37
+ data: {
38
+ formId: 'form-1',
39
+ info: { title: 'Survey' },
40
+ responderUri: 'https://docs.google.com/forms/d/e/x/viewform'
41
+ }
42
+ });
43
+ const result = await svc.create({ title: 'Survey' });
44
+ expect(formsApi.forms.create).toHaveBeenCalledWith({ requestBody: { info: { title: 'Survey' } } });
45
+ expect(JSON.parse(textOf(result))).toEqual({
46
+ formId: 'form-1',
47
+ title: 'Survey',
48
+ responderUri: 'https://docs.google.com/forms/d/e/x/viewform'
49
+ });
50
+ });
51
+ it('includes documentTitle only when it is given', async () => {
52
+ formsApi.forms.create.mockResolvedValue({ data: { formId: 'form-1', info: { title: 'Survey' } } });
53
+ await svc.create({ title: 'Survey', documentTitle: 'Q3 survey' });
54
+ expect(formsApi.forms.create).toHaveBeenCalledWith({
55
+ requestBody: { info: { title: 'Survey', documentTitle: 'Q3 survey' } }
56
+ });
57
+ });
58
+ it('rejects a missing title instead of creating an untitled form', async () => {
59
+ await expect(svc.create({ title: '' })).rejects.toThrow(/title is required/i);
60
+ expect(formsApi.forms.create).not.toHaveBeenCalled();
61
+ });
62
+ });
63
+ describe('get', () => {
64
+ it('returns the form definition for a bare form ID', async () => {
65
+ formsApi.forms.get.mockResolvedValue({ data: { formId: 'form-1', info: { title: 'Survey' } } });
66
+ const result = await svc.get({ formId: 'form-1' });
67
+ expect(formsApi.forms.get).toHaveBeenCalledWith({ formId: 'form-1' });
68
+ expect(JSON.parse(textOf(result))).toEqual({ formId: 'form-1', info: { title: 'Survey' } });
69
+ });
70
+ it('extracts the form ID from an editor URL', async () => {
71
+ formsApi.forms.get.mockResolvedValue({ data: { formId: 'form-1' } });
72
+ await svc.get({ formId: 'https://docs.google.com/forms/d/form-1/edit' });
73
+ expect(formsApi.forms.get).toHaveBeenCalledWith({ formId: 'form-1' });
74
+ });
75
+ it('refuses a public responder link by name rather than sending a wrong ID', async () => {
76
+ await expect(svc.get({ formId: 'https://docs.google.com/forms/d/e/1FAIpQLSc-abc/viewform' })).rejects.toThrow(/responder link/i);
77
+ expect(formsApi.forms.get).not.toHaveBeenCalled();
78
+ });
79
+ it('refuses a URL it cannot read a form ID out of', async () => {
80
+ await expect(svc.get({ formId: 'https://forms.gle/abcd1234' })).rejects.toThrow(/Could not extract a form ID/i);
81
+ expect(formsApi.forms.get).not.toHaveBeenCalled();
82
+ });
83
+ it('rejects an empty formId', async () => {
84
+ await expect(svc.get({ formId: ' ' })).rejects.toThrow(/formId is required/i);
85
+ });
86
+ });
87
+ describe('batchUpdate', () => {
88
+ it('forwards the requests array and returns the API replies', async () => {
89
+ const requests = [{ createItem: { item: { title: 'Q1' }, location: { index: 0 } } }];
90
+ formsApi.forms.batchUpdate.mockResolvedValue({ data: { replies: [{ createItem: { itemId: 'i1' } }] } });
91
+ const result = await svc.batchUpdate({ formId: 'form-1', requests });
92
+ expect(formsApi.forms.batchUpdate).toHaveBeenCalledWith({ formId: 'form-1', requestBody: { requests } });
93
+ expect(JSON.parse(textOf(result))).toEqual({ replies: [{ createItem: { itemId: 'i1' } }] });
94
+ });
95
+ it('rejects an empty requests array instead of sending a no-op batch', async () => {
96
+ await expect(svc.batchUpdate({ formId: 'form-1', requests: [] })).rejects.toThrow(/at least one request/i);
97
+ expect(formsApi.forms.batchUpdate).not.toHaveBeenCalled();
98
+ });
99
+ });
100
+ describe('listResponses', () => {
101
+ it('lists responses and surfaces the next page token', async () => {
102
+ formsApi.forms.responses.list.mockResolvedValue({
103
+ data: { responses: [{ responseId: 'r1' }], nextPageToken: 'tok' }
104
+ });
105
+ const result = await svc.listResponses({ formId: 'form-1' });
106
+ expect(formsApi.forms.responses.list).toHaveBeenCalledWith({ formId: 'form-1' });
107
+ expect(JSON.parse(textOf(result))).toEqual({ responses: [{ responseId: 'r1' }], nextPageToken: 'tok' });
108
+ });
109
+ it('passes paging and filter params through only when supplied', async () => {
110
+ formsApi.forms.responses.list.mockResolvedValue({ data: {} });
111
+ await svc.listResponses({
112
+ formId: 'form-1',
113
+ pageSize: 10,
114
+ pageToken: 'tok',
115
+ filter: 'timestamp > 2026-01-01T00:00:00Z'
116
+ });
117
+ expect(formsApi.forms.responses.list).toHaveBeenCalledWith({
118
+ formId: 'form-1',
119
+ pageSize: 10,
120
+ pageToken: 'tok',
121
+ filter: 'timestamp > 2026-01-01T00:00:00Z'
122
+ });
123
+ });
124
+ it('reports an empty response list as an empty array, not a missing field', async () => {
125
+ formsApi.forms.responses.list.mockResolvedValue({ data: {} });
126
+ const result = await svc.listResponses({ formId: 'form-1' });
127
+ expect(JSON.parse(textOf(result))).toEqual({ responses: [] });
128
+ });
129
+ });
130
+ describe('getResponse', () => {
131
+ it('returns one response by ID', async () => {
132
+ formsApi.forms.responses.get.mockResolvedValue({ data: { responseId: 'r1', answers: {} } });
133
+ const result = await svc.getResponse({ formId: 'form-1', responseId: 'r1' });
134
+ expect(formsApi.forms.responses.get).toHaveBeenCalledWith({ formId: 'form-1', responseId: 'r1' });
135
+ expect(JSON.parse(textOf(result))).toEqual({ responseId: 'r1', answers: {} });
136
+ });
137
+ it('rejects a missing responseId', async () => {
138
+ await expect(svc.getResponse({ formId: 'form-1', responseId: '' })).rejects.toThrow(/responseId is required/i);
139
+ expect(formsApi.forms.responses.get).not.toHaveBeenCalled();
140
+ });
141
+ });
142
+ // Tool arguments arrive as untyped JSON: the factory forwards whatever the
143
+ // client sent, so a required param can be absent at runtime even though the
144
+ // method signature says it cannot. Name it instead of throwing a TypeError
145
+ // from inside .trim().
146
+ describe('omitted required params', () => {
147
+ it.each([
148
+ ['get', () => svc.get({}), /formId is required/i],
149
+ ['create', () => svc.create({}), /title is required/i],
150
+ ['getResponse', () => svc.getResponse({ formId: 'form-1' }), /responseId is required/i]
151
+ ])('%s names the missing param', async (_action, call, expected) => {
152
+ await expect(call()).rejects.toThrow(expected);
153
+ });
154
+ });
155
+ describe('auth and error plumbing', () => {
156
+ it('asks for a fresh authenticated client on every call (no cached client field)', async () => {
157
+ formsApi.forms.get.mockResolvedValue({ data: {} });
158
+ await svc.get({ formId: 'form-1' });
159
+ await svc.get({ formId: 'form-2' });
160
+ expect(auth.getAuthenticatedClient).toHaveBeenCalledTimes(2);
161
+ expect(formsFactory).toHaveBeenCalledTimes(2);
162
+ expect(formsFactory).toHaveBeenLastCalledWith(expect.objectContaining({ version: 'v1', auth: auth.client }));
163
+ });
164
+ it('lets an API failure reject so the tool layer can mark it isError', async () => {
165
+ // The vendored services swallow errors into a success-shaped result whose
166
+ // text happens to be {"error": ...}; a client cannot tell that from data.
167
+ // Ours throws, and withErrorHandling/registry turn it into isError: true.
168
+ formsApi.forms.get.mockRejectedValue(new Error('Requested entity was not found.'));
169
+ await expect(svc.get({ formId: 'form-1' })).rejects.toThrow('Requested entity was not found.');
170
+ });
171
+ });
172
+ });
173
+ //# sourceMappingURL=FormsService.test.js.map