@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.
- package/LICENSE +202 -0
- package/NOTICE +46 -0
- package/README.md +342 -2
- package/bin/cli.mjs +144 -0
- package/build/src/auth/account-context.d.ts +3 -0
- package/build/src/auth/account-context.d.ts.map +1 -0
- package/build/src/auth/account-context.js +17 -0
- package/build/src/auth/account-context.js.map +1 -0
- package/build/src/auth/account-context.test.d.ts +2 -0
- package/build/src/auth/account-context.test.d.ts.map +1 -0
- package/build/src/auth/account-context.test.js +30 -0
- package/build/src/auth/account-context.test.js.map +1 -0
- package/build/src/auth/account-store.d.ts +87 -0
- package/build/src/auth/account-store.d.ts.map +1 -0
- package/build/src/auth/account-store.js +187 -0
- package/build/src/auth/account-store.js.map +1 -0
- package/build/src/auth/account-store.test.d.ts +2 -0
- package/build/src/auth/account-store.test.d.ts.map +1 -0
- package/build/src/auth/account-store.test.js +264 -0
- package/build/src/auth/account-store.test.js.map +1 -0
- package/build/src/auth/add-account.d.ts +12 -0
- package/build/src/auth/add-account.d.ts.map +1 -0
- package/build/src/auth/add-account.js +95 -0
- package/build/src/auth/add-account.js.map +1 -0
- package/build/src/auth/add-account.test.d.ts +2 -0
- package/build/src/auth/add-account.test.d.ts.map +1 -0
- package/build/src/auth/add-account.test.js +155 -0
- package/build/src/auth/add-account.test.js.map +1 -0
- package/build/src/auth/cli-auth.d.ts +2 -0
- package/build/src/auth/cli-auth.d.ts.map +1 -0
- package/build/src/auth/cli-auth.js +47 -0
- package/build/src/auth/cli-auth.js.map +1 -0
- package/build/src/auth/cli-auth.test.d.ts +2 -0
- package/build/src/auth/cli-auth.test.d.ts.map +1 -0
- package/build/src/auth/cli-auth.test.js +78 -0
- package/build/src/auth/cli-auth.test.js.map +1 -0
- package/build/src/auth/consent-server.d.ts +43 -0
- package/build/src/auth/consent-server.d.ts.map +1 -0
- package/build/src/auth/consent-server.js +56 -0
- package/build/src/auth/consent-server.js.map +1 -0
- package/build/src/auth/credential-state.d.ts +7 -0
- package/build/src/auth/credential-state.d.ts.map +1 -0
- package/build/src/auth/credential-state.js +64 -0
- package/build/src/auth/credential-state.js.map +1 -0
- package/build/src/auth/credential-state.test.d.ts +2 -0
- package/build/src/auth/credential-state.test.d.ts.map +1 -0
- package/build/src/auth/credential-state.test.js +142 -0
- package/build/src/auth/credential-state.test.js.map +1 -0
- package/build/src/auth/loopback-consent.d.ts +23 -0
- package/build/src/auth/loopback-consent.d.ts.map +1 -0
- package/build/src/auth/loopback-consent.js +145 -0
- package/build/src/auth/loopback-consent.js.map +1 -0
- package/build/src/auth/loopback-consent.test.d.ts +2 -0
- package/build/src/auth/loopback-consent.test.d.ts.map +1 -0
- package/build/src/auth/loopback-consent.test.js +131 -0
- package/build/src/auth/loopback-consent.test.js.map +1 -0
- package/build/src/auth/oauth-setup.d.ts +10 -0
- package/build/src/auth/oauth-setup.d.ts.map +1 -0
- package/build/src/auth/oauth-setup.js +92 -0
- package/build/src/auth/oauth-setup.js.map +1 -0
- package/build/src/auth/oauth-setup.test.d.ts +2 -0
- package/build/src/auth/oauth-setup.test.d.ts.map +1 -0
- package/build/src/auth/oauth-setup.test.js +164 -0
- package/build/src/auth/oauth-setup.test.js.map +1 -0
- package/build/src/auth/subject-context.d.ts +2 -0
- package/build/src/auth/subject-context.d.ts.map +1 -0
- package/build/src/auth/subject-context.js +16 -0
- package/build/src/auth/subject-context.js.map +1 -0
- package/build/src/auth/subject-context.test.d.ts +2 -0
- package/build/src/auth/subject-context.test.d.ts.map +1 -0
- package/build/src/auth/subject-context.test.js +34 -0
- package/build/src/auth/subject-context.test.js.map +1 -0
- package/build/src/auth/workspace-auth.d.ts +47 -0
- package/build/src/auth/workspace-auth.d.ts.map +1 -0
- package/build/src/auth/workspace-auth.js +123 -0
- package/build/src/auth/workspace-auth.js.map +1 -0
- package/build/src/auth/workspace-auth.test.d.ts +2 -0
- package/build/src/auth/workspace-auth.test.d.ts.map +1 -0
- package/build/src/auth/workspace-auth.test.js +242 -0
- package/build/src/auth/workspace-auth.test.js.map +1 -0
- package/build/src/constants.d.ts +6 -0
- package/build/src/constants.d.ts.map +1 -0
- package/build/src/constants.js +11 -0
- package/build/src/constants.js.map +1 -0
- package/build/src/create-server.d.ts +13 -0
- package/build/src/create-server.d.ts.map +1 -0
- package/build/src/create-server.js +34 -0
- package/build/src/create-server.js.map +1 -0
- package/build/src/create-server.test.d.ts +2 -0
- package/build/src/create-server.test.d.ts.map +1 -0
- package/build/src/create-server.test.js +13 -0
- package/build/src/create-server.test.js.map +1 -0
- package/build/src/docs/calendar.md +15 -0
- package/build/src/docs/chat.md +15 -0
- package/build/src/docs/config.md +117 -0
- package/build/src/docs/docs.md +36 -0
- package/build/src/docs/drive.md +15 -0
- package/build/src/docs/forms.md +119 -0
- package/build/src/docs/gmail.md +18 -0
- package/build/src/docs/overview.md +52 -0
- package/build/src/docs/people.md +10 -0
- package/build/src/docs/sheets.md +10 -0
- package/build/src/docs/slides.md +26 -0
- package/build/src/docs/tasks.md +13 -0
- package/build/src/docs/time.md +11 -0
- package/build/src/init-server.d.ts +10 -0
- package/build/src/init-server.d.ts.map +1 -0
- package/build/src/init-server.js +13 -0
- package/build/src/init-server.js.map +1 -0
- package/build/src/init-server.test.d.ts +2 -0
- package/build/src/init-server.test.d.ts.map +1 -0
- package/build/src/init-server.test.js +15 -0
- package/build/src/init-server.test.js.map +1 -0
- package/build/src/main.d.ts +33 -0
- package/build/src/main.d.ts.map +1 -0
- package/build/src/main.js +120 -0
- package/build/src/main.js.map +1 -0
- package/build/src/main.test.d.ts +2 -0
- package/build/src/main.test.d.ts.map +1 -0
- package/build/src/main.test.js +204 -0
- package/build/src/main.test.js.map +1 -0
- package/build/src/services/FormsService.d.ts +89 -0
- package/build/src/services/FormsService.d.ts.map +1 -0
- package/build/src/services/FormsService.js +140 -0
- package/build/src/services/FormsService.js.map +1 -0
- package/build/src/services/FormsService.test.d.ts +2 -0
- package/build/src/services/FormsService.test.d.ts.map +1 -0
- package/build/src/services/FormsService.test.js +173 -0
- package/build/src/services/FormsService.test.js.map +1 -0
- package/build/src/tools/config.d.ts +19 -0
- package/build/src/tools/config.d.ts.map +1 -0
- package/build/src/tools/config.js +100 -0
- package/build/src/tools/config.js.map +1 -0
- package/build/src/tools/config.test.d.ts +2 -0
- package/build/src/tools/config.test.d.ts.map +1 -0
- package/build/src/tools/config.test.js +201 -0
- package/build/src/tools/config.test.js.map +1 -0
- package/build/src/tools/domains/calendar.d.ts +3 -0
- package/build/src/tools/domains/calendar.d.ts.map +1 -0
- package/build/src/tools/domains/calendar.js +14 -0
- package/build/src/tools/domains/calendar.js.map +1 -0
- package/build/src/tools/domains/chat.d.ts +3 -0
- package/build/src/tools/domains/chat.d.ts.map +1 -0
- package/build/src/tools/domains/chat.js +16 -0
- package/build/src/tools/domains/chat.js.map +1 -0
- package/build/src/tools/domains/docs.d.ts +8 -0
- package/build/src/tools/domains/docs.d.ts.map +1 -0
- package/build/src/tools/domains/docs.js +11 -0
- package/build/src/tools/domains/docs.js.map +1 -0
- package/build/src/tools/domains/docs.test.d.ts +2 -0
- package/build/src/tools/domains/docs.test.d.ts.map +1 -0
- package/build/src/tools/domains/docs.test.js +111 -0
- package/build/src/tools/domains/docs.test.js.map +1 -0
- package/build/src/tools/domains/drive.d.ts +3 -0
- package/build/src/tools/domains/drive.d.ts.map +1 -0
- package/build/src/tools/domains/drive.js +14 -0
- package/build/src/tools/domains/drive.js.map +1 -0
- package/build/src/tools/domains/factory.d.ts +24 -0
- package/build/src/tools/domains/factory.d.ts.map +1 -0
- package/build/src/tools/domains/factory.js +43 -0
- package/build/src/tools/domains/factory.js.map +1 -0
- package/build/src/tools/domains/factory.test.d.ts +2 -0
- package/build/src/tools/domains/factory.test.d.ts.map +1 -0
- package/build/src/tools/domains/factory.test.js +48 -0
- package/build/src/tools/domains/factory.test.js.map +1 -0
- package/build/src/tools/domains/forms.d.ts +9 -0
- package/build/src/tools/domains/forms.d.ts.map +1 -0
- package/build/src/tools/domains/forms.js +12 -0
- package/build/src/tools/domains/forms.js.map +1 -0
- package/build/src/tools/domains/forms.test.d.ts +2 -0
- package/build/src/tools/domains/forms.test.d.ts.map +1 -0
- package/build/src/tools/domains/forms.test.js +93 -0
- package/build/src/tools/domains/forms.test.js.map +1 -0
- package/build/src/tools/domains/gmail.d.ts +3 -0
- package/build/src/tools/domains/gmail.d.ts.map +1 -0
- package/build/src/tools/domains/gmail.js +17 -0
- package/build/src/tools/domains/gmail.js.map +1 -0
- package/build/src/tools/domains/index.d.ts +20 -0
- package/build/src/tools/domains/index.d.ts.map +1 -0
- package/build/src/tools/domains/index.js +230 -0
- package/build/src/tools/domains/index.js.map +1 -0
- package/build/src/tools/domains/people.d.ts +3 -0
- package/build/src/tools/domains/people.d.ts.map +1 -0
- package/build/src/tools/domains/people.js +5 -0
- package/build/src/tools/domains/people.js.map +1 -0
- package/build/src/tools/domains/sheets.d.ts +3 -0
- package/build/src/tools/domains/sheets.d.ts.map +1 -0
- package/build/src/tools/domains/sheets.js +5 -0
- package/build/src/tools/domains/sheets.js.map +1 -0
- package/build/src/tools/domains/slides.d.ts +3 -0
- package/build/src/tools/domains/slides.d.ts.map +1 -0
- package/build/src/tools/domains/slides.js +25 -0
- package/build/src/tools/domains/slides.js.map +1 -0
- package/build/src/tools/domains/tasks.d.ts +3 -0
- package/build/src/tools/domains/tasks.d.ts.map +1 -0
- package/build/src/tools/domains/tasks.js +14 -0
- package/build/src/tools/domains/tasks.js.map +1 -0
- package/build/src/tools/domains/time.d.ts +3 -0
- package/build/src/tools/domains/time.d.ts.map +1 -0
- package/build/src/tools/domains/time.js +6 -0
- package/build/src/tools/domains/time.js.map +1 -0
- package/build/src/tools/helpers/errors.d.ts +48 -0
- package/build/src/tools/helpers/errors.d.ts.map +1 -0
- package/build/src/tools/helpers/errors.js +290 -0
- package/build/src/tools/helpers/errors.js.map +1 -0
- package/build/src/tools/helpers/errors.test.d.ts +2 -0
- package/build/src/tools/helpers/errors.test.d.ts.map +1 -0
- package/build/src/tools/helpers/errors.test.js +220 -0
- package/build/src/tools/helpers/errors.test.js.map +1 -0
- package/build/src/tools/registry.d.ts +14 -0
- package/build/src/tools/registry.d.ts.map +1 -0
- package/build/src/tools/registry.js +276 -0
- package/build/src/tools/registry.js.map +1 -0
- package/build/src/tools/registry.test.d.ts +2 -0
- package/build/src/tools/registry.test.d.ts.map +1 -0
- package/build/src/tools/registry.test.js +321 -0
- package/build/src/tools/registry.test.js.map +1 -0
- package/build/src/transports/http.d.ts +7 -0
- package/build/src/transports/http.d.ts.map +1 -0
- package/build/src/transports/http.js +56 -0
- package/build/src/transports/http.js.map +1 -0
- package/build/src/transports/http.test.d.ts +2 -0
- package/build/src/transports/http.test.d.ts.map +1 -0
- package/build/src/transports/http.test.js +76 -0
- package/build/src/transports/http.test.js.map +1 -0
- package/build/src/vendored/auth/AuthManager.d.ts +7 -0
- package/build/src/vendored/auth/AuthManager.d.ts.map +1 -0
- package/build/src/vendored/auth/AuthManager.js +11 -0
- package/build/src/vendored/auth/AuthManager.js.map +1 -0
- package/build/src/vendored/services/CalendarService.d.ts +164 -0
- package/build/src/vendored/services/CalendarService.d.ts.map +1 -0
- package/build/src/vendored/services/CalendarService.js +726 -0
- package/build/src/vendored/services/CalendarService.js.map +1 -0
- package/build/src/vendored/services/CalendarValidation.d.ts +9 -0
- package/build/src/vendored/services/CalendarValidation.d.ts.map +1 -0
- package/build/src/vendored/services/CalendarValidation.js +125 -0
- package/build/src/vendored/services/CalendarValidation.js.map +1 -0
- package/build/src/vendored/services/ChatService.d.ts +90 -0
- package/build/src/vendored/services/ChatService.d.ts.map +1 -0
- package/build/src/vendored/services/ChatService.js +451 -0
- package/build/src/vendored/services/ChatService.js.map +1 -0
- package/build/src/vendored/services/DocsService.d.ts +109 -0
- package/build/src/vendored/services/DocsService.d.ts.map +1 -0
- package/build/src/vendored/services/DocsService.js +663 -0
- package/build/src/vendored/services/DocsService.js.map +1 -0
- package/build/src/vendored/services/DocsService.test.d.ts +2 -0
- package/build/src/vendored/services/DocsService.test.d.ts.map +1 -0
- package/build/src/vendored/services/DocsService.test.js +77 -0
- package/build/src/vendored/services/DocsService.test.js.map +1 -0
- package/build/src/vendored/services/DriveService.d.ts +117 -0
- package/build/src/vendored/services/DriveService.d.ts.map +1 -0
- package/build/src/vendored/services/DriveService.js +527 -0
- package/build/src/vendored/services/DriveService.js.map +1 -0
- package/build/src/vendored/services/DriveService.test.d.ts +2 -0
- package/build/src/vendored/services/DriveService.test.d.ts.map +1 -0
- package/build/src/vendored/services/DriveService.test.js +115 -0
- package/build/src/vendored/services/DriveService.test.js.map +1 -0
- package/build/src/vendored/services/GmailService.d.ts +137 -0
- package/build/src/vendored/services/GmailService.d.ts.map +1 -0
- package/build/src/vendored/services/GmailService.js +681 -0
- package/build/src/vendored/services/GmailService.js.map +1 -0
- package/build/src/vendored/services/PeopleService.d.ts +42 -0
- package/build/src/vendored/services/PeopleService.d.ts.map +1 -0
- package/build/src/vendored/services/PeopleService.js +168 -0
- package/build/src/vendored/services/PeopleService.js.map +1 -0
- package/build/src/vendored/services/SheetsService.d.ts +52 -0
- package/build/src/vendored/services/SheetsService.d.ts.map +1 -0
- package/build/src/vendored/services/SheetsService.js +262 -0
- package/build/src/vendored/services/SheetsService.js.map +1 -0
- package/build/src/vendored/services/SheetsService.test.d.ts +2 -0
- package/build/src/vendored/services/SheetsService.test.d.ts.map +1 -0
- package/build/src/vendored/services/SheetsService.test.js +104 -0
- package/build/src/vendored/services/SheetsService.test.js.map +1 -0
- package/build/src/vendored/services/SlidesService.d.ts +167 -0
- package/build/src/vendored/services/SlidesService.d.ts.map +1 -0
- package/build/src/vendored/services/SlidesService.js +887 -0
- package/build/src/vendored/services/SlidesService.js.map +1 -0
- package/build/src/vendored/services/TasksService.d.ts +97 -0
- package/build/src/vendored/services/TasksService.d.ts.map +1 -0
- package/build/src/vendored/services/TasksService.js +234 -0
- package/build/src/vendored/services/TasksService.js.map +1 -0
- package/build/src/vendored/services/TimeService.d.ts +29 -0
- package/build/src/vendored/services/TimeService.d.ts.map +1 -0
- package/build/src/vendored/services/TimeService.js +71 -0
- package/build/src/vendored/services/TimeService.js.map +1 -0
- package/build/src/vendored/utils/DriveQueryBuilder.d.ts +15 -0
- package/build/src/vendored/utils/DriveQueryBuilder.d.ts.map +1 -0
- package/build/src/vendored/utils/DriveQueryBuilder.js +17 -0
- package/build/src/vendored/utils/DriveQueryBuilder.js.map +1 -0
- package/build/src/vendored/utils/GaxiosConfig.d.ts +9 -0
- package/build/src/vendored/utils/GaxiosConfig.d.ts.map +1 -0
- package/build/src/vendored/utils/GaxiosConfig.js +30 -0
- package/build/src/vendored/utils/GaxiosConfig.js.map +1 -0
- package/build/src/vendored/utils/IdUtils.d.ts +13 -0
- package/build/src/vendored/utils/IdUtils.d.ts.map +1 -0
- package/build/src/vendored/utils/IdUtils.js +29 -0
- package/build/src/vendored/utils/IdUtils.js.map +1 -0
- package/build/src/vendored/utils/MimeHelper.d.ts +64 -0
- package/build/src/vendored/utils/MimeHelper.d.ts.map +1 -0
- package/build/src/vendored/utils/MimeHelper.js +174 -0
- package/build/src/vendored/utils/MimeHelper.js.map +1 -0
- package/build/src/vendored/utils/MimeHelper.test.d.ts +2 -0
- package/build/src/vendored/utils/MimeHelper.test.d.ts.map +1 -0
- package/build/src/vendored/utils/MimeHelper.test.js +47 -0
- package/build/src/vendored/utils/MimeHelper.test.js.map +1 -0
- package/build/src/vendored/utils/constants.d.ts +9 -0
- package/build/src/vendored/utils/constants.d.ts.map +1 -0
- package/build/src/vendored/utils/constants.js +9 -0
- package/build/src/vendored/utils/constants.js.map +1 -0
- package/build/src/vendored/utils/logger.d.ts +3 -0
- package/build/src/vendored/utils/logger.d.ts.map +1 -0
- package/build/src/vendored/utils/logger.js +15 -0
- package/build/src/vendored/utils/logger.js.map +1 -0
- package/build/src/vendored/utils/paths.d.ts +2 -0
- package/build/src/vendored/utils/paths.d.ts.map +1 -0
- package/build/src/vendored/utils/paths.js +19 -0
- package/build/src/vendored/utils/paths.js.map +1 -0
- package/build/src/vendored/utils/validation.d.ts +100 -0
- package/build/src/vendored/utils/validation.d.ts.map +1 -0
- package/build/src/vendored/utils/validation.js +161 -0
- package/build/src/vendored/utils/validation.js.map +1 -0
- package/build/src/version.d.ts +2 -0
- package/build/src/version.d.ts.map +1 -0
- package/build/src/version.js +29 -0
- package/build/src/version.js.map +1 -0
- package/build/src/version.test.d.ts +2 -0
- package/build/src/version.test.d.ts.map +1 -0
- package/build/src/version.test.js +19 -0
- package/build/src/version.test.js.map +1 -0
- package/build/tsconfig.tsbuildinfo +1 -0
- 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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAExE,yEAAyE;AACzE,uEAAuE;AACvE,EAAE,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;IACjB,sBAAsB,EAAE,EAAE,CAAC,EAAE,EAAE;CAChC,CAAC,CAAC,CAAA;AACH,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;AACpE,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;AAClE,sFAAsF;AACtF,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;AAC/D,oFAAoF;AACpF,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;IAClD,GAAG,CAAC,MAAM,cAAc,EAAe,CAAC;IACxC,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAA;AACH,EAAE,CAAC,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1D,uEAAuE;IACvE,8DAA8D;IAC9D,oBAAoB,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,oBAAoB;QACvD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACnD,CAAC,CAAC;CACH,CAAC,CAAC,CAAA;AAEH,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAEhD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAA;IAC/B,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAA;IAEjC,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAA;QAChC,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,GAAG,GAAG,WAAW,CAAA;QACzB,OAAO,CAAC,IAAI,GAAG,YAAY,CAAA;QAC3B,EAAE,CAAC,aAAa,EAAE,CAAA;IACpB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,gBAAgB,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,gBAAgB,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;QACpC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAA;IAC/B,IAAI,QAAqC,CAAA;IAEzC,UAAU,CAAC,GAAG,EAAE;QACd,gFAAgF;QAChF,yDAAyD;QACzD,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAA;QAChC,EAAE,CAAC,aAAa,EAAE,CAAA;QAClB,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,GAAG,GAAG,WAAW,CAAA;QACzB,QAAQ,CAAC,WAAW,EAAE,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;QAC3F,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;QAEjD,MAAM,WAAW,CAAC,MAAM,CAAC,CAAA;QAEzB,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,CAAA;QACxC,qFAAqF;QACrF,2EAA2E;QAC3E,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAC5C,MAAM,CAAC,sBAAsB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QACrD,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAA;QACjE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAA;QAEjD,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;QAE1B,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAC5C,MAAM,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,EAAE,CAAA;QACrD,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAA;QACrE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAA;QACrD,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;QAErD,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;QAE1B,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,EAAE,CAAA;QAC5C,MAAM,CAAC,sBAAsB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACvD,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,MAAM,CAAA;QAEtD,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;QAE1D,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAA;QACjF,kFAAkF;QAClF,oFAAoF;QACpF,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QACxC,MAAM,CAAC,sBAAsB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QACrD,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;IAC9C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAA;IAC/B,IAAI,OAAoC,CAAA;IACxC,IAAI,QAAqC,CAAA;IAEzC,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAA;QAChC,EAAE,CAAC,aAAa,EAAE,CAAA;QAClB,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAkB,CAAC,CAAA;QAChF,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,GAAG,GAAG,WAAW,CAAA;QACzB,OAAO,CAAC,WAAW,EAAE,CAAA;QACrB,QAAQ,CAAC,WAAW,EAAE,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,uFAAuF;QACvF,+EAA+E;QAC/E,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,iBAAiB,CACpC,IAAI,KAAK,CACP,8GAA8G,CAC/G,CACF,CAAA;QAED,MAAM,SAAS,CAAC,MAAM,CAAC,CAAA;QAEvB,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CACnC,yBAAyB,EACzB,8GAA8G,CAC/G,CAAA;QACD,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAA;IACjC,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAA;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,IAAI,GAAG,YAAY,CAAA;QAC3B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QAC9D,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1C,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC,CAAA;QAC5D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAA;QACjE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAA;QACxC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,GAAY,CAAC,CAAA;QACjD,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAA;QACzC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAA;QACnE,mFAAmF;QACnF,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,MAAM,CAAA;QACtD,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC/E,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;YAC5C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAEhC,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAA8C,CAAA;YACnG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;YACrB,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAA;QACnF,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,QAAQ,GAAG,gBAAgB,CAAA;YACnC,QAAQ,CAAC,WAAW,EAAE,CAAA;YACtB,IAAI,aAAa,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAA;;gBAChF,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,aAAa,CAAA;QACpE,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAU,CAAC,CAAA;QAC1E,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC/E,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;YACvB,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAExD,CAAA;YACD,MAAM,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC3C,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,sDAAsD,CAAC,CAAA;QAC/F,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,WAAW,EAAE,CAAA;QACxB,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
|
|
@@ -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 @@
|
|
|
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
|