@aaronsb/google-workspace-mcp 2.7.1 → 4.0.0

package/build/google/client.js

@@ -0,0 +1,232 @@
+/**
+ * The Google API client.
+ *
+ * The whole of a resource operation: get a token, make the call, hand back the JSON.
+ *
+ * LOAD-BEARING CONSTRAINT — this layer has NO OPINIONS. It never reshapes, never
+ * "fixes", never fills in. It returns exactly what Google returned. Interpretation
+ * happens ABOVE it, in the layer we already own and aim at the MCP contract
+ * (patches / formatters / next-steps). The moment this file gets helpful, it
+ * becomes something that can be subtly wrong in a way no test catches — the exact
+ * defect class ADR-101 spent six review rounds learning to fear.
+ *
+ * Everything here is a consequence of something the DESCRIPTOR said. Where a rule
+ * looks arbitrary, it is not: it is a fact we learned by being wrong first, live,
+ * against Google (ADR-103, item 2).
+ *
+ * See ADR-103.
+ */
+import { createWriteStream } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { getAccessToken } from '../accounts/token-service.js';
+import { GoogleApiError } from './errors.js';
+import { loadDescriptor } from './descriptor.js';
+function resolve(descriptor, service, resourcePath) {
+    const svc = descriptor.services[service];
+    if (!svc)
+        throw new Error(`descriptor has no service '${service}'`);
+    const method = svc.methods[resourcePath];
+    if (!method)
+        throw new Error(`descriptor has no method '${service}.${resourcePath}'`);
+    return { svc, method };
+}
+/**
+ * Expand a path template.
+ *
+ * `{+var}` is RFC 6570 RESERVED expansion — reserved characters, notably `/`,
+ * must NOT be percent-encoded. Meet's identifiers ARE paths
+ * ("conferenceRecords/abc"), so encoding that slash to %2F 404s every Meet
+ * sub-resource operation. The `+` is the descriptor telling us this. Honour it.
+ */
+function expandPath(template, pathParams) {
+    return template.replace(/\{(\+?)([^}]+)\}/g, (_m, reserved, name) => {
+        if (!(name in pathParams))
+            throw new Error(`missing required path param '${name}'`);
+        const raw = String(pathParams[name]);
+        return reserved
+            ? raw.split('/').map(encodeURIComponent).join('/')
+            : encodeURIComponent(raw);
+    });
+}
+/**
+ * Split params into path / query / body by what the descriptor DECLARES.
+ *
+ * Global parameters (`fields`, `alt`, `quotaUser`, `prettyPrint`) are declared
+ * ONCE at the document root, not per method. A dispatcher that consults only the
+ * method's parameters cannot place `fields`, drops it into the body, and a GET
+ * silently discards it — which is exactly how drive.listComments died with
+ * "The 'fields' parameter is required". Merge both; the method wins on conflict.
+ */
+function splitParams(svc, method, params) {
+    const declared = { ...svc.globalParameters, ...method.parameters };
+    const path = {};
+    const query = {};
+    const body = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        const location = declared[key]?.location;
+        if (location === 'path')
+            path[key] = value;
+        else if (location === 'query')
+            query[key] = value;
+        else
+            body[key] = value; // undeclared -> request body; Google validates it, not us
+    }
+    return { path, query, body };
+}
+function applyQuery(url, query) {
+    for (const [key, value] of Object.entries(query)) {
+        if (Array.isArray(value))
+            value.forEach((v) => url.searchParams.append(key, String(v)));
+        else
+            url.searchParams.set(key, String(value));
+    }
+    return url;
+}
+/** Pure: descriptor + params -> the request. No I/O, so it is testable offline. */
+export function buildRequest(descriptor, service, resourcePath, params = {}) {
+    const { svc, method } = resolve(descriptor, service, resourcePath);
+    const { path, query, body } = splitParams(svc, method, params);
+    const base = svc.rootUrl.replace(/\/$/, '') + '/' + svc.servicePath.replace(/^\//, '');
+    const url = applyQuery(new URL((base.replace(/\/$/, '') + '/' + expandPath(method.path, path)).replace(/\/+$/, '')), query);
+    const hasBody = Object.keys(body).length > 0 && method.httpMethod !== 'GET';
+    return { url: url.toString(), method: method.httpMethod, body: hasBody ? body : undefined };
+}
+function parseJson(text) {
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { error: { message: text.slice(0, 300) } };
+    }
+}
+/**
+ * Call a Google API method. Returns RAW Google JSON — no envelope, no reshaping.
+ * Throws GoogleApiError carrying Google's real error body.
+ */
+export async function call(service, resourcePath, params, options) {
+    const descriptor = options.descriptor ?? await loadDescriptor();
+    const doFetch = options.fetchImpl ?? fetch;
+    const request = buildRequest(descriptor, service, resourcePath, params);
+    const token = await getAccessToken(options.account);
+    const response = await doFetch(request.url, {
+        method: request.method,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            ...(request.body ? { 'Content-Type': 'application/json' } : {}),
+        },
+        ...(request.body ? { body: JSON.stringify(request.body) } : {}),
+    });
+    const text = await response.text();
+    const json = parseJson(text);
+    if (!response.ok) {
+        throw new GoogleApiError(response.status, json, {
+            url: request.url,
+            method: request.method,
+        });
+    }
+    return json;
+}
+/**
+ * Download media to disk.
+ *
+ * STREAMED, deliberately. The bytes go from the socket to the file and are never a
+ * string at all. Never buffer a download through an in-memory string: accumulating
+ * the whole response and JSON.parse-ing it turns a 30 MB attachment into a ~40 MB
+ * string, then an object, then a Buffer — uncapped, for every download.
+ */
+export async function download(service, resourcePath, params, outputPath, options) {
+    const descriptor = options.descriptor ?? await loadDescriptor();
+    const doFetch = options.fetchImpl ?? fetch;
+    const request = buildRequest(descriptor, service, resourcePath, params);
+    const token = await getAccessToken(options.account);
+    const response = await doFetch(request.url, {
+        method: request.method,
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!response.ok) {
+        const json = parseJson(await response.text());
+        throw new GoogleApiError(response.status, json, {
+            url: request.url,
+            method: request.method,
+        });
+    }
+    if (!response.body)
+        throw new Error(`no response body for ${service}.${resourcePath}`);
+    await mkdir(dirname(outputPath), { recursive: true });
+    await pipeline(Readable.fromWeb(response.body), createWriteStream(outputPath));
+    return outputPath;
+}
+/**
+ * Resumable, chunked media upload.
+ *
+ * The descriptor carries the upload paths for both protocols because Discovery
+ * DECLARES them. Verified live (ADR-103 item 4): a 25 MB attachment — 34.2 MB as
+ * RFC822, 93% of Google's declared 36,700,160-byte cap — uploaded in 5 chunks and
+ * read back byte-for-byte identical.
+ */
+export async function upload(service, resourcePath, params, options) {
+    const descriptor = options.descriptor ?? await loadDescriptor();
+    const doFetch = options.fetchImpl ?? fetch;
+    const { svc, method } = resolve(descriptor, service, resourcePath);
+    if (!method.mediaUpload)
+        throw new Error(`${service}.${resourcePath} does not support media upload`);
+    // Google DECLARES the ceiling. Refusing locally beats a confusing 400 from a
+    // 35 MB request that already crossed the wire.
+    const max = Number(method.mediaUpload.maxSize);
+    if (max && options.media.length > max) {
+        throw new Error(`${service}.${resourcePath}: payload is ${options.media.length} bytes; ` +
+            `Google's declared limit is ${max} bytes`);
+    }
+    const token = await getAccessToken(options.account);
+    const { path, query } = splitParams(svc, method, params);
+    const uploadPath = method.mediaUpload.resumable ?? method.mediaUpload.simple;
+    if (!uploadPath)
+        throw new Error(`${service}.${resourcePath} declares no upload protocol`);
+    const initiateUrl = applyQuery(new URL(expandPath(uploadPath, path), svc.rootUrl), { ...query, uploadType: 'resumable' }).toString();
+    const initiate = await doFetch(initiateUrl, {
+        method: method.httpMethod,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json; charset=UTF-8',
+            'X-Upload-Content-Type': options.contentType,
+            'X-Upload-Content-Length': String(options.media.length),
+        },
+        body: JSON.stringify(options.metadata ?? {}),
+    });
+    if (!initiate.ok) {
+        const json = parseJson(await initiate.text());
+        throw new GoogleApiError(initiate.status, json, { url: initiateUrl, method: method.httpMethod });
+    }
+    const session = initiate.headers.get('location');
+    if (!session)
+        throw new Error('resumable upload: initiate returned no Location header');
+    const chunkSize = options.chunkSize ?? 8 * 1024 * 1024;
+    let offset = 0;
+    while (offset < options.media.length) {
+        const end = Math.min(offset + chunkSize, options.media.length);
+        const response = await doFetch(session, {
+            method: 'PUT',
+            headers: { 'Content-Range': `bytes ${offset}-${end - 1}/${options.media.length}` },
+            body: options.media.subarray(offset, end),
+        });
+        // 308 "Resume Incomplete" is the protocol working, not an error.
+        if (response.status === 308) {
+            offset = end;
+            continue;
+        }
+        const text = await response.text();
+        if (!response.ok) {
+            throw new GoogleApiError(response.status, parseJson(text), { url: session, method: 'PUT' });
+        }
+        return parseJson(text);
+    }
+    throw new Error('resumable upload: media consumed without a terminal response');
+}
+//# sourceMappingURL=client.js.map

package/build/google/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/google/client.ts"],"names":[],"mappings":"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"}

package/build/google/descriptor.d.ts

@@ -0,0 +1,40 @@
+export interface ApiParam {
+    location: 'path' | 'query';
+    required?: boolean;
+    repeated?: boolean;
+}
+export interface ApiMediaUpload {
+    maxSize?: string;
+    accept?: string[];
+    simple?: string;
+    resumable?: string;
+}
+export interface ApiMethod {
+    path: string;
+    httpMethod: string;
+    parameters: Record<string, ApiParam>;
+    scopes?: string[];
+    supportsMediaDownload?: boolean;
+    mediaUpload?: ApiMediaUpload;
+}
+export interface ApiService {
+    version: string;
+    rootUrl: string;
+    servicePath: string;
+    discoveryUrl: string;
+    /** `fields`, `alt`, `quotaUser`… declared once at the document root, not per method. */
+    globalParameters: Record<string, ApiParam>;
+    methods: Record<string, ApiMethod>;
+}
+export interface ApiDescriptor {
+    generatedFrom: string;
+    services: Record<string, ApiService>;
+}
+/**
+ * Load the descriptor. Resolved as a sibling of this module, which makes it work
+ * under `src/` (vitest) and under `build/` (the shipped server) alike — the same
+ * trick `loadManifest()` uses, and the reason `npx` works.
+ */
+export declare function loadDescriptor(): Promise<ApiDescriptor>;
+/** Tests only: drop the memoised descriptor. */
+export declare function resetDescriptorCache(): void;

package/build/google/descriptor.js

@@ -0,0 +1,37 @@
+/**
+ * The API descriptor: a generated, committed transcription of Google's Discovery
+ * documents, pruned to what making a REQUEST needs.
+ *
+ * Generated at BUILD time by `scripts/generate-descriptor.mjs` and committed, so
+ * there is no network dependency at startup and nothing breaks offline. Drift is a
+ * CI check, not a production surprise.
+ *
+ * It records what Discovery says about how to CALL Google. It records nothing
+ * about what a RESPONSE means — Discovery's `schemas` block (~90% of the raw
+ * document) is deliberately DISCARDED. A descriptor that knows response shapes is
+ * a descriptor that can start helpfully reshaping them.
+ *
+ * See ADR-103.
+ */
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+let cached;
+/**
+ * Load the descriptor. Resolved as a sibling of this module, which makes it work
+ * under `src/` (vitest) and under `build/` (the shipped server) alike — the same
+ * trick `loadManifest()` uses, and the reason `npx` works.
+ */
+export async function loadDescriptor() {
+    if (cached)
+        return cached;
+    const here = dirname(fileURLToPath(import.meta.url));
+    const raw = await readFile(resolve(here, 'descriptor.json'), 'utf-8');
+    cached = JSON.parse(raw);
+    return cached;
+}
+/** Tests only: drop the memoised descriptor. */
+export function resetDescriptorCache() {
+    cached = undefined;
+}
+//# sourceMappingURL=descriptor.js.map

package/build/google/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../src/google/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAuCzC,IAAI,MAAiC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,SAAS,CAAC;AACrB,CAAC"}