@n24q02m/workspace 0.0.0-stage → 0.5.0

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,161 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { z } from 'zod';
7
+ import * as path from 'node:path';
8
+ /**
9
+ * Email validation schema
10
+ * Validates email format according to RFC 5322
11
+ */
12
+ export const emailSchema = z.string().email('Invalid email format');
13
+ /**
14
+ * Validates multiple email addresses (for CC/BCC fields)
15
+ */
16
+ export const emailArraySchema = z.union([emailSchema, z.array(emailSchema)]);
17
+ /**
18
+ * Gmail draft attachment input. Single source of truth shared by the MCP
19
+ * tool schema (index.ts) and GmailService's AttachmentInput type so the two
20
+ * definitions cannot drift apart.
21
+ *
22
+ * Note: empty-string filename/mimeType are intentionally accepted here —
23
+ * GmailService falls back to path-derived defaults for them.
24
+ */
25
+ export const gmailAttachmentSchema = z.object({
26
+ filePath: z
27
+ .string()
28
+ .refine((p) => path.isAbsolute(p), {
29
+ message: 'filePath must be an absolute path',
30
+ })
31
+ .describe('Absolute local filesystem path to the file to attach (e.g., "/Users/name/downloads/report.pdf"). Use gmail.downloadAttachment first to save an email attachment locally before referencing it here.'),
32
+ filename: z
33
+ .string()
34
+ .optional()
35
+ .describe('Display name for the attachment in the email. Defaults to the filename portion of filePath.'),
36
+ mimeType: z
37
+ .string()
38
+ .optional()
39
+ .describe('MIME type of the attachment (e.g., "application/pdf"). Inferred from the file extension when omitted; falls back to "application/octet-stream".'),
40
+ });
41
+ /**
42
+ * ISO 8601 datetime validation schema
43
+ * Accepts formats like:
44
+ * - 2024-01-15T10:30:00Z
45
+ * - 2024-01-15T10:30:00-05:00
46
+ * - 2024-01-15T10:30:00.000Z
47
+ */
48
+ export const iso8601DateTimeSchema = z.string().refine((val) => {
49
+ const iso8601Regex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?(Z|[+-]\d{2}:\d{2})$/;
50
+ if (!iso8601Regex.test(val))
51
+ return false;
52
+ // Additional check: ensure it's a valid date
53
+ return !isNaN(Date.parse(val));
54
+ }, {
55
+ message: 'Invalid ISO 8601 datetime format. Expected format: YYYY-MM-DDTHH:mm:ss[.sss][Z|±HH:mm]',
56
+ });
57
+ /**
58
+ * Google Drive document/file ID validation
59
+ * Google IDs are typically alphanumeric strings with hyphens and underscores
60
+ */
61
+ export const googleDocumentIdSchema = z
62
+ .string()
63
+ .regex(/^[a-zA-Z0-9_-]+$/, 'Invalid document ID format. Document IDs should only contain letters, numbers, hyphens, and underscores');
64
+ /**
65
+ * Google Drive URL validation
66
+ * Accepts various Google Workspace URLs and extracts the document ID
67
+ */
68
+ export const googleWorkspaceUrlSchema = z
69
+ .string()
70
+ .regex(/^https:\/\/(docs|drive|sheets|slides)\.google\.com\/.+\/d\/([a-zA-Z0-9_-]+)/, 'Invalid Google Workspace URL format');
71
+ /**
72
+ * Folder name validation
73
+ * Prevents problematic characters in folder names
74
+ */
75
+ export const folderNameSchema = z
76
+ .string()
77
+ .min(1, 'Folder name cannot be empty')
78
+ .max(255, 'Folder name too long (max 255 characters)')
79
+ .refine((val) => !/[<>:"/\\|?*\x00-\x1F]/.test(val), 'Folder name contains invalid characters');
80
+ /**
81
+ * Calendar ID validation
82
+ * Can be 'primary' or an email address
83
+ */
84
+ export const calendarIdSchema = z.union([z.literal('primary'), emailSchema]);
85
+ /**
86
+ * Search query sanitization
87
+ * Escapes potentially dangerous characters from search queries
88
+ * Preserves quotes for exact phrase searching
89
+ */
90
+ export const searchQuerySchema = z.string().transform((val) => {
91
+ // Escape backslashes first, then escape quotes
92
+ // This preserves the ability to search for exact phrases
93
+ return val
94
+ .replace(/\\/g, '\\\\') // Escape backslashes
95
+ .replace(/'/g, "\\'") // Escape single quotes
96
+ .replace(/"/g, '\\"'); // Escape double quotes
97
+ });
98
+ /**
99
+ * Page size validation for pagination
100
+ */
101
+ export const pageSizeSchema = z
102
+ .number()
103
+ .int('Page size must be an integer')
104
+ .min(1, 'Page size must be at least 1')
105
+ .max(100, 'Page size cannot exceed 100');
106
+ /**
107
+ * Helper function to create a validator from a Zod schema
108
+ */
109
+ function createValidator(schema, fallbackErrorMessage) {
110
+ return (value) => {
111
+ try {
112
+ schema.parse(value);
113
+ return { success: true };
114
+ }
115
+ catch (error) {
116
+ if (error instanceof z.ZodError) {
117
+ return { success: false, error: error.issues[0].message };
118
+ }
119
+ return { success: false, error: fallbackErrorMessage };
120
+ }
121
+ };
122
+ }
123
+ /**
124
+ * Helper function to validate email
125
+ */
126
+ export const validateEmail = createValidator(emailSchema, 'Invalid email format');
127
+ /**
128
+ * Helper function to validate ISO 8601 datetime
129
+ */
130
+ export const validateDateTime = createValidator(iso8601DateTimeSchema, 'Invalid datetime format');
131
+ /**
132
+ * Helper function to validate Google document ID
133
+ */
134
+ export const validateDocumentId = createValidator(googleDocumentIdSchema, 'Invalid document ID');
135
+ /**
136
+ * Helper function to extract document ID from URL or return the ID if already valid
137
+ */
138
+ export function extractDocumentId(urlOrId) {
139
+ // First check if it's already a valid ID
140
+ if (googleDocumentIdSchema.safeParse(urlOrId).success) {
141
+ return urlOrId;
142
+ }
143
+ // Try to extract from URL
144
+ const urlMatch = urlOrId.match(/\/d\/([a-zA-Z0-9_-]+)/);
145
+ if (urlMatch && urlMatch[1]) {
146
+ return urlMatch[1];
147
+ }
148
+ throw new Error('Invalid document ID or URL');
149
+ }
150
+ /**
151
+ * Validation error class for consistent error handling
152
+ */
153
+ export class ValidationError extends Error {
154
+ constructor(message, field, value) {
155
+ super(message);
156
+ this.field = field;
157
+ this.value = value;
158
+ this.name = 'ValidationError';
159
+ }
160
+ }
161
+ //# sourceMappingURL=validation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/vendored/utils/validation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare function getPackageVersion(): string;
2
+ //# sourceMappingURL=version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAkBA,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Version của package, đọc lúc chạy từ `package.json`.
3
+ *
4
+ * Module riêng vì CẢ HAI transport cần nó: stdio (`main.ts`) và http
5
+ * (`transports/http.ts`). Để hàm này nằm private trong `main.ts` thì http chỉ
6
+ * còn hai lựa chọn tệ -- hardcode một chuỗi (nó đã từng báo `'0.0.0'` trong khi
7
+ * stdio báo version thật), hoặc import ngược `http.ts` -> `main.ts` và tạo vòng
8
+ * phụ thuộc với chính module đang dynamic-import nó.
9
+ *
10
+ * Đường phân giải tính từ chính file này. Trong artifact ship thật (bundle
11
+ * `bin/cli.mjs`, esbuild giữ `import.meta.url` trỏ tới bundle) thì `..` là gốc
12
+ * repo/package -- đúng chỗ có `package.json`. PSR ghi version vào file đó lúc
13
+ * release, nên KHÔNG được thay bằng hằng số.
14
+ */
15
+ import { readFileSync } from 'node:fs';
16
+ import { dirname, join } from 'node:path';
17
+ import { fileURLToPath } from 'node:url';
18
+ export function getPackageVersion() {
19
+ try {
20
+ const here = dirname(fileURLToPath(import.meta.url));
21
+ const pkgPath = join(here, '..', 'package.json');
22
+ const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
23
+ return pkg.version ?? '0.0.0';
24
+ }
25
+ catch {
26
+ return '0.0.0';
27
+ }
28
+ }
29
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAA;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAyB,CAAA;QAC9E,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAA;IAChB,CAAC;AACH,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=version.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.test.d.ts","sourceRoot":"","sources":["../../src/version.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,19 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { describe, expect, it } from 'vitest';
4
+ import { getPackageVersion } from './version.js';
5
+ describe('getPackageVersion', () => {
6
+ it('reports the version declared in package.json', () => {
7
+ // Đọc package.json qua process.cwd() -- một đường phân giải KHÁC với đường
8
+ // của implementation (import.meta.url), nên test không pass chỉ vì cả hai
9
+ // sai giống nhau. Và KHÔNG assert một chuỗi hằng: PSR bump package.json mỗi
10
+ // lần release, hằng số trong test sẽ mục ngay sau lần release kế.
11
+ const declared = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf-8'))
12
+ .version;
13
+ expect(getPackageVersion()).toBe(declared);
14
+ });
15
+ it('returns a non-empty version string', () => {
16
+ expect(getPackageVersion()).toMatch(/^\d+\.\d+\.\d+/);
17
+ });
18
+ });
19
+ //# sourceMappingURL=version.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.test.js","sourceRoot":"","sources":["../../src/version.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,2EAA2E;QAC3E,0EAA0E;QAC1E,4EAA4E;QAC5E,kEAAkE;QAClE,MAAM,QAAQ,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAyB;aAC7G,OAAO,CAAA;QACV,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}