@mcp-z/mcp-gmail 1.0.0

package/dist/cjs/setup/stdio.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "createStdioServer", {
+    enumerable: true,
+    get: function() {
+        return createStdioServer;
+    }
+});
+var _server = require("@mcp-z/server");
+var _mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var _runtime = require("./runtime.js");
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+function createStdioServer(config, overrides) {
+    return _async_to_generator(function() {
+        var runtime, modules, layers, composed, logger, tools, prompts, mcpServer, close;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    return [
+                        4,
+                        (0, _runtime.createDefaultRuntime)(config, overrides)
+                    ];
+                case 1:
+                    runtime = _state.sent();
+                    modules = runtime.createDomainModules();
+                    layers = runtime.middlewareFactories.map(function(factory) {
+                        return factory(runtime.deps);
+                    });
+                    composed = (0, _server.composeMiddleware)(modules, layers);
+                    logger = runtime.deps.logger;
+                    tools = _to_consumable_array(composed.tools).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountTools));
+                    prompts = _to_consumable_array(composed.prompts).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountPrompts));
+                    mcpServer = new _mcp.McpServer({
+                        name: config.name,
+                        version: config.version
+                    });
+                    (0, _server.registerTools)(mcpServer, tools);
+                    (0, _server.registerResources)(mcpServer, composed.resources);
+                    (0, _server.registerPrompts)(mcpServer, prompts);
+                    logger.info("Starting ".concat(config.name, " MCP server (stdio)"));
+                    return [
+                        4,
+                        (0, _server.connectStdio)(mcpServer, {
+                            logger: logger
+                        })
+                    ];
+                case 2:
+                    close = _state.sent().close;
+                    logger.info('stdio transport ready');
+                    return [
+                        2,
+                        {
+                            mcpServer: mcpServer,
+                            logger: logger,
+                            close: function() {
+                                return _async_to_generator(function() {
+                                    return _ts_generator(this, function(_state) {
+                                        switch(_state.label){
+                                            case 0:
+                                                return [
+                                                    4,
+                                                    close()
+                                                ];
+                                            case 1:
+                                                _state.sent();
+                                                return [
+                                                    4,
+                                                    runtime.close()
+                                                ];
+                                            case 2:
+                                                _state.sent();
+                                                return [
+                                                    2
+                                                ];
+                                        }
+                                    });
+                                })();
+                            }
+                        }
+                    ];
+            }
+        });
+    })();
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/setup/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/stdio.ts"],"sourcesContent":["import { composeMiddleware, connectStdio, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RuntimeOverrides, ServerConfig } from '../types.js';\nimport { createDefaultRuntime } from './runtime.js';\n\nexport async function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, tools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  logger.info(`Starting ${config.name} MCP server (stdio)`);\n  const { close } = await connectStdio(mcpServer, { logger });\n  logger.info('stdio transport ready');\n\n  return {\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createStdioServer","config","overrides","runtime","modules","layers","composed","logger","tools","prompts","mcpServer","close","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","oauthAdapters","accountTools","accountPrompts","McpServer","name","version","registerTools","registerResources","resources","registerPrompts","info","connectStdio"],"mappings":";;;;+BAKsBA;;;eAAAA;;;sBAL6E;mBACzE;uBAEW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,kBAAkBC,MAAoB,EAAEC,SAA4B;;YAClFC,SACAC,SACAC,QACAC,UACAC,QAEAC,OACAC,SAEAC,WAMEC;;;;oBAfQ;;wBAAMC,IAAAA,6BAAoB,EAACX,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQU,mBAAmB;oBACrCR,SAASF,QAAQW,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQb,QAAQc,IAAI;;oBAC1EX,WAAWY,IAAAA,yBAAiB,EAACd,SAASC;oBACtCE,SAASJ,QAAQc,IAAI,CAACV,MAAM;oBAE5BC,QAAQ,AAAC,qBAAGF,SAASE,KAAK,SAAE,qBAAGL,QAAQc,IAAI,CAACE,aAAa,CAACC,YAAY;oBACtEX,UAAU,AAAC,qBAAGH,SAASG,OAAO,SAAE,qBAAGN,QAAQc,IAAI,CAACE,aAAa,CAACE,cAAc;oBAE5EX,YAAY,IAAIY,cAAS,CAAC;wBAAEC,MAAMtB,OAAOsB,IAAI;wBAAEC,SAASvB,OAAOuB,OAAO;oBAAC;oBAC7EC,IAAAA,qBAAa,EAACf,WAAWF;oBACzBkB,IAAAA,yBAAiB,EAAChB,WAAWJ,SAASqB,SAAS;oBAC/CC,IAAAA,uBAAe,EAAClB,WAAWD;oBAE3BF,OAAOsB,IAAI,CAAC,AAAC,YAAuB,OAAZ5B,OAAOsB,IAAI,EAAC;oBAClB;;wBAAMO,IAAAA,oBAAY,EAACpB,WAAW;4BAAEH,QAAAA;wBAAO;;;oBAAjDI,QAAU,cAAVA;oBACRJ,OAAOsB,IAAI,CAAC;oBAEZ;;wBAAO;4BACLnB,WAAAA;4BACAH,QAAAA;4BACAI,OAAO;;;;;gDACL;;oDAAMA;;;gDAAN;gDACA;;oDAAMR,QAAQQ,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}

package/dist/cjs/types.d.cts

@@ -0,0 +1,54 @@
+import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';
+import type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';
+import type { Keyv } from 'keyv';
+import type { OAuthAdapters } from './setup/oauth-google.js';
+export type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;
+/**
+ * Composes transport config, OAuth config, and application-level config
+ */
+export interface ServerConfig extends BaseServerConfig, OAuthConfig {
+    logLevel: string;
+    baseDir: string;
+    name: string;
+    version: string;
+    repositoryUrl: string;
+    storageDir: string;
+    baseUrl?: string;
+    dcrConfig?: DcrConfig;
+}
+export interface StorageContext {
+    storageDir: string;
+    baseUrl?: string;
+    transport: BaseServerConfig['transport'];
+}
+export interface StorageExtra {
+    storageContext: StorageContext;
+}
+/** Runtime dependencies exposed to middleware/factories. */
+export interface RuntimeDeps {
+    config: ServerConfig;
+    logger: ServerLogger;
+    tokenStore: Keyv<CachedToken>;
+    oauthAdapters: OAuthAdapters;
+    baseUrl?: string;
+}
+/** Collections of MCP modules produced by domain factories. */
+export type DomainModules = {
+    tools: ToolModule[];
+    resources: ResourceModule[];
+    prompts: PromptModule[];
+};
+/** Factory that produces a middleware layer given runtime dependencies. */
+export type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;
+/** Shared runtime configuration returned by `createDefaultRuntime`. */
+export interface CommonRuntime {
+    deps: RuntimeDeps;
+    middlewareFactories: MiddlewareFactory[];
+    createDomainModules: () => DomainModules;
+    close: () => Promise<void>;
+}
+export interface RuntimeOverrides {
+    middlewareFactories?: MiddlewareFactory[];
+    createDomainModules?: () => DomainModules;
+}
+export type { GmailQuery } from './schemas/index.js';

package/dist/cjs/types.d.ts

@@ -0,0 +1,54 @@
+import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';
+import type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';
+import type { Keyv } from 'keyv';
+import type { OAuthAdapters } from './setup/oauth-google.js';
+export type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;
+/**
+ * Composes transport config, OAuth config, and application-level config
+ */
+export interface ServerConfig extends BaseServerConfig, OAuthConfig {
+    logLevel: string;
+    baseDir: string;
+    name: string;
+    version: string;
+    repositoryUrl: string;
+    storageDir: string;
+    baseUrl?: string;
+    dcrConfig?: DcrConfig;
+}
+export interface StorageContext {
+    storageDir: string;
+    baseUrl?: string;
+    transport: BaseServerConfig['transport'];
+}
+export interface StorageExtra {
+    storageContext: StorageContext;
+}
+/** Runtime dependencies exposed to middleware/factories. */
+export interface RuntimeDeps {
+    config: ServerConfig;
+    logger: ServerLogger;
+    tokenStore: Keyv<CachedToken>;
+    oauthAdapters: OAuthAdapters;
+    baseUrl?: string;
+}
+/** Collections of MCP modules produced by domain factories. */
+export type DomainModules = {
+    tools: ToolModule[];
+    resources: ResourceModule[];
+    prompts: PromptModule[];
+};
+/** Factory that produces a middleware layer given runtime dependencies. */
+export type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;
+/** Shared runtime configuration returned by `createDefaultRuntime`. */
+export interface CommonRuntime {
+    deps: RuntimeDeps;
+    middlewareFactories: MiddlewareFactory[];
+    createDomainModules: () => DomainModules;
+    close: () => Promise<void>;
+}
+export interface RuntimeOverrides {
+    middlewareFactories?: MiddlewareFactory[];
+    createDomainModules?: () => DomainModules;
+}
+export type { GmailQuery } from './schemas/index.js';

package/dist/cjs/types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/esm/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Gmail MCP Server Constants
+ *
+ * These scopes are required for Gmail functionality and are hardcoded
+ * rather than externally configured since this server knows its own requirements.
+ */
+export declare const GOOGLE_SCOPE = "openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/";
+export declare const CHUNK_SIZE = 10;
+export declare const MAX_BATCH_SIZE = 500;
+export declare const DEFAULT_PAGE_SIZE = 50;
+export declare const MAX_PAGE_SIZE = 1000;

package/dist/esm/constants.js

@@ -0,0 +1,14 @@
+/**
+ * Gmail MCP Server Constants
+ *
+ * These scopes are required for Gmail functionality and are hardcoded
+ * rather than externally configured since this server knows its own requirements.
+ */ import { EMAIL_CHUNK_SIZE, EMAIL_MAX_BATCH_SIZE } from '@mcp-z/email';
+// Google OAuth scopes required for Gmail operations
+export const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/';
+// Batch processing configuration (from shared email constants)
+export const CHUNK_SIZE = EMAIL_CHUNK_SIZE;
+export const MAX_BATCH_SIZE = EMAIL_MAX_BATCH_SIZE;
+// Pagination configuration
+export const DEFAULT_PAGE_SIZE = 50; // Default number of items per page
+export const MAX_PAGE_SIZE = 1000; // Maximum number of items per page

package/dist/esm/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/constants.ts"],"sourcesContent":["/**\n * Gmail MCP Server Constants\n *\n * These scopes are required for Gmail functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\nimport { EMAIL_CHUNK_SIZE, EMAIL_MAX_BATCH_SIZE } from '@mcp-z/email';\n\n// Google OAuth scopes required for Gmail operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://mail.google.com/';\n\n// Batch processing configuration (from shared email constants)\nexport const CHUNK_SIZE = EMAIL_CHUNK_SIZE;\nexport const MAX_BATCH_SIZE = EMAIL_MAX_BATCH_SIZE;\n\n// Pagination configuration\nexport const DEFAULT_PAGE_SIZE = 50; // Default number of items per page\nexport const MAX_PAGE_SIZE = 1000; // Maximum number of items per page\n"],"names":["EMAIL_CHUNK_SIZE","EMAIL_MAX_BATCH_SIZE","GOOGLE_SCOPE","CHUNK_SIZE","MAX_BATCH_SIZE","DEFAULT_PAGE_SIZE","MAX_PAGE_SIZE"],"mappings":"AAAA;;;;;CAKC,GAED,SAASA,gBAAgB,EAAEC,oBAAoB,QAAQ,eAAe;AAEtE,oDAAoD;AACpD,OAAO,MAAMC,eAAe,kIAAkI;AAE9J,+DAA+D;AAC/D,OAAO,MAAMC,aAAaH,iBAAiB;AAC3C,OAAO,MAAMI,iBAAiBH,qBAAqB;AAEnD,2BAA2B;AAC3B,OAAO,MAAMI,oBAAoB,GAAG,CAAC,mCAAmC;AACxE,OAAO,MAAMC,gBAAgB,KAAK,CAAC,mCAAmC"}

package/dist/esm/email/composition/rfc822-builder.d.ts

@@ -0,0 +1,11 @@
+export interface Rfc822Args {
+    to?: string | string[];
+    cc?: string | string[];
+    bcc?: string | string[];
+    subject?: string;
+    body?: string;
+    from?: string;
+    /** Content type for the email body */
+    contentType?: 'text' | 'html';
+}
+export declare function buildRfc822FromArgs(args: Rfc822Args): string;

package/dist/esm/email/composition/rfc822-builder.js

@@ -0,0 +1,13 @@
+export function buildRfc822FromArgs(args) {
+    const { to = [], cc = [], bcc = [], subject = '', body = '', from = '', contentType = 'text' } = args;
+    const headers = [];
+    if (from) headers.push(`From: ${from}`);
+    if (to && to.length) headers.push(`To: ${Array.isArray(to) ? to.join(', ') : to}`);
+    if (cc && cc.length) headers.push(`Cc: ${Array.isArray(cc) ? cc.join(', ') : cc}`);
+    if (bcc && bcc.length) headers.push(`Bcc: ${Array.isArray(bcc) ? bcc.join(', ') : bcc}`);
+    if (subject) headers.push(`Subject: ${subject}`);
+    headers.push('MIME-Version: 1.0');
+    const mimeType = contentType === 'html' ? 'text/html' : 'text/plain';
+    headers.push(`Content-Type: ${mimeType}; charset=utf-8`);
+    return `${headers.join('\r\n')}\r\n\r\n${body}`;
+}

package/dist/esm/email/composition/rfc822-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/email/composition/rfc822-builder.ts"],"sourcesContent":["export interface Rfc822Args {\n  to?: string | string[];\n  cc?: string | string[];\n  bcc?: string | string[];\n  subject?: string;\n  body?: string;\n  from?: string;\n  /** Content type for the email body */\n  contentType?: 'text' | 'html';\n}\n\nexport function buildRfc822FromArgs(args: Rfc822Args): string {\n  const { to = [], cc = [], bcc = [], subject = '', body = '', from = '', contentType = 'text' } = args;\n\n  const headers: string[] = [];\n\n  if (from) headers.push(`From: ${from}`);\n  if (to && to.length) headers.push(`To: ${Array.isArray(to) ? to.join(', ') : to}`);\n  if (cc && cc.length) headers.push(`Cc: ${Array.isArray(cc) ? cc.join(', ') : cc}`);\n  if (bcc && bcc.length) headers.push(`Bcc: ${Array.isArray(bcc) ? bcc.join(', ') : bcc}`);\n  if (subject) headers.push(`Subject: ${subject}`);\n\n  headers.push('MIME-Version: 1.0');\n  const mimeType = contentType === 'html' ? 'text/html' : 'text/plain';\n  headers.push(`Content-Type: ${mimeType}; charset=utf-8`);\n\n  return `${headers.join('\\r\\n')}\\r\\n\\r\\n${body}`;\n}\n"],"names":["buildRfc822FromArgs","args","to","cc","bcc","subject","body","from","contentType","headers","push","length","Array","isArray","join","mimeType"],"mappings":"AAWA,OAAO,SAASA,oBAAoBC,IAAgB;IAClD,MAAM,EAAEC,KAAK,EAAE,EAAEC,KAAK,EAAE,EAAEC,MAAM,EAAE,EAAEC,UAAU,EAAE,EAAEC,OAAO,EAAE,EAAEC,OAAO,EAAE,EAAEC,cAAc,MAAM,EAAE,GAAGP;IAEjG,MAAMQ,UAAoB,EAAE;IAE5B,IAAIF,MAAME,QAAQC,IAAI,CAAC,CAAC,MAAM,EAAEH,MAAM;IACtC,IAAIL,MAAMA,GAAGS,MAAM,EAAEF,QAAQC,IAAI,CAAC,CAAC,IAAI,EAAEE,MAAMC,OAAO,CAACX,MAAMA,GAAGY,IAAI,CAAC,QAAQZ,IAAI;IACjF,IAAIC,MAAMA,GAAGQ,MAAM,EAAEF,QAAQC,IAAI,CAAC,CAAC,IAAI,EAAEE,MAAMC,OAAO,CAACV,MAAMA,GAAGW,IAAI,CAAC,QAAQX,IAAI;IACjF,IAAIC,OAAOA,IAAIO,MAAM,EAAEF,QAAQC,IAAI,CAAC,CAAC,KAAK,EAAEE,MAAMC,OAAO,CAACT,OAAOA,IAAIU,IAAI,CAAC,QAAQV,KAAK;IACvF,IAAIC,SAASI,QAAQC,IAAI,CAAC,CAAC,SAAS,EAAEL,SAAS;IAE/CI,QAAQC,IAAI,CAAC;IACb,MAAMK,WAAWP,gBAAgB,SAAS,cAAc;IACxDC,QAAQC,IAAI,CAAC,CAAC,cAAc,EAAEK,SAAS,eAAe,CAAC;IAEvD,OAAO,GAAGN,QAAQK,IAAI,CAAC,QAAQ,QAAQ,EAAER,MAAM;AACjD"}

package/dist/esm/email/messages/fetch-message.d.ts

@@ -0,0 +1,24 @@
+import type { gmail_v1 } from 'googleapis';
+export type FetchMode = 'metadata' | 'full';
+export interface NormalizedAddress {
+    address?: string | undefined;
+    name?: string | undefined;
+}
+export interface NormalizedMessage {
+    id: string;
+    threadId?: string | undefined;
+    date?: string | undefined;
+    subject?: string | undefined;
+    from?: NormalizedAddress | undefined;
+    to?: string[] | undefined;
+    cc?: string[] | undefined;
+    bcc?: string[] | undefined;
+    snippet?: string | undefined;
+    labels?: string[] | undefined;
+    body?: string | undefined;
+}
+export interface GmailDeps {
+    /** googleapis Gmail client created via createGmailClient(provider). */
+    gmail: gmail_v1.Gmail;
+}
+export declare function fetchMessage(deps: GmailDeps, id: string, mode: FetchMode): Promise<NormalizedMessage>;

package/dist/esm/email/messages/fetch-message.js

@@ -0,0 +1,123 @@
+import { toIsoUtc } from '../../lib/date-conversion.js';
+import { extractEmails, extractFrom } from '../parsing/headers-utils.js';
+function extractHeader(headers, key) {
+    var _ref;
+    const h = headers === null || headers === void 0 ? void 0 : headers.find((x)=>{
+        var _x_name;
+        return ((_x_name = x.name) !== null && _x_name !== void 0 ? _x_name : '').toLowerCase() === key.toLowerCase();
+    });
+    return (_ref = h === null || h === void 0 ? void 0 : h.value) !== null && _ref !== void 0 ? _ref : undefined;
+}
+function base64UrlDecode(input) {
+    let s = String(input).replace(/-/g, '+').replace(/_/g, '/');
+    while(s.length % 4 !== 0)s += '=';
+    try {
+        return Buffer.from(s, 'base64').toString('utf8');
+    } catch  {
+        return '';
+    }
+}
+function extractBody(payload) {
+    const find = (parts, mime)=>{
+        for (const p of parts !== null && parts !== void 0 ? parts : []){
+            if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {
+                if (p.mimeType === mime && p.body && typeof p.body === 'object' && 'data' in p.body) {
+                    return base64UrlDecode(p.body.data);
+                }
+            }
+            if (p && typeof p === 'object' && 'parts' in p) {
+                const nested = find(p.parts, mime);
+                if (nested) return nested;
+            }
+        }
+        return undefined;
+    };
+    if (payload && typeof payload === 'object' && 'parts' in payload) {
+        var _find;
+        var _find1;
+        return (_find = find(payload.parts, 'text/plain')) !== null && _find !== void 0 ? _find : (_find1 = find(payload.parts, 'text/html')) === null || _find1 === void 0 ? void 0 : _find1.replace(/\r\n?/g, '\n');
+    }
+    return undefined;
+}
+export async function fetchMessage(deps, id, mode) {
+    var _ref, _toIsoUtc;
+    const { gmail } = deps;
+    // When only metadata is requested, ask Gmail for a reduced payload with just the headers we care about.
+    const metadataHeaders = [
+        'Date',
+        'Subject',
+        'From',
+        'To',
+        'Cc',
+        'Bcc'
+    ];
+    const format = mode === 'full' ? 'full' : 'metadata';
+    const baseParams = {
+        userId: 'me',
+        id,
+        format
+    };
+    const resp = format === 'metadata' ? await gmail.users.messages.get({
+        ...baseParams,
+        metadataHeaders
+    }) : await gmail.users.messages.get(baseParams);
+    const data = resp === null || resp === void 0 ? void 0 : resp.data;
+    const headers = data && typeof data === 'object' && 'payload' in data && data.payload && typeof data.payload === 'object' && 'headers' in data.payload ? data.payload.headers : undefined;
+    const dateRaw = extractHeader(headers, 'Date');
+    const fromRaw = extractHeader(headers, 'From');
+    const toRaw = extractHeader(headers, 'To');
+    const ccRaw = extractHeader(headers, 'Cc');
+    const bccRaw = extractHeader(headers, 'Bcc');
+    const fromObj = (_ref = fromRaw ? extractFrom(fromRaw) : undefined) !== null && _ref !== void 0 ? _ref : undefined;
+    const toArr = toRaw ? extractEmails(toRaw) : [];
+    const ccArr = ccRaw ? extractEmails(ccRaw) : [];
+    const bccArr = bccRaw ? extractEmails(bccRaw) : [];
+    const getId = ()=>{
+        if (data && typeof data === 'object' && 'id' in data) {
+            var _data_id;
+            return String((_data_id = data.id) !== null && _data_id !== void 0 ? _data_id : id);
+        }
+        return id;
+    };
+    const getThreadId = ()=>{
+        if (data && typeof data === 'object' && 'threadId' in data && data.threadId) {
+            return String(data.threadId);
+        }
+        return undefined;
+    };
+    const getSnippet = ()=>{
+        if (data && typeof data === 'object' && 'snippet' in data && data.snippet) {
+            return String(data.snippet);
+        }
+        return undefined;
+    };
+    const getLabelIds = ()=>{
+        if (data && typeof data === 'object' && 'labelIds' in data && Array.isArray(data.labelIds)) {
+            return data.labelIds.map(String);
+        }
+        return undefined;
+    };
+    const getPayload = ()=>{
+        if (data && typeof data === 'object' && 'payload' in data) {
+            return data.payload;
+        }
+        return undefined;
+    };
+    const msg = {
+        id: getId(),
+        threadId: getThreadId(),
+        date: dateRaw ? (_toIsoUtc = toIsoUtc(dateRaw)) !== null && _toIsoUtc !== void 0 ? _toIsoUtc : dateRaw : undefined,
+        subject: extractHeader(headers, 'Subject'),
+        from: fromObj,
+        to: toArr.length ? toArr : undefined,
+        cc: ccArr.length ? ccArr : undefined,
+        bcc: bccArr.length ? bccArr : undefined,
+        snippet: getSnippet(),
+        labels: getLabelIds()
+    };
+    if (mode === 'full') {
+        const body = extractBody(getPayload());
+        if (body) msg.body = body;
+    }
+    return msg;
+}

package/dist/esm/email/messages/fetch-message.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/email/messages/fetch-message.ts"],"sourcesContent":["import type { gmail_v1 } from 'googleapis';\nimport { toIsoUtc } from '../../lib/date-conversion.js';\nimport { extractEmails, extractFrom } from '../parsing/headers-utils.js';\n\nexport type FetchMode = 'metadata' | 'full';\n\nexport interface NormalizedAddress {\n  address?: string | undefined;\n  name?: string | undefined;\n}\nexport interface NormalizedMessage {\n  id: string;\n  threadId?: string | undefined;\n  date?: string | undefined;\n  subject?: string | undefined;\n  from?: NormalizedAddress | undefined;\n  to?: string[] | undefined;\n  cc?: string[] | undefined;\n  bcc?: string[] | undefined;\n  snippet?: string | undefined;\n  labels?: string[] | undefined;\n  body?: string | undefined;\n}\n\nexport interface GmailDeps {\n  /** googleapis Gmail client created via createGmailClient(provider). */\n  gmail: gmail_v1.Gmail;\n}\n\nfunction extractHeader(headers: Array<{ name?: string; value?: string }> | undefined, key: string): string | undefined {\n  const h = headers?.find((x) => (x.name ?? '').toLowerCase() === key.toLowerCase());\n  return h?.value ?? undefined;\n}\n\nfunction base64UrlDecode(input: string): string {\n  let s = String(input).replace(/-/g, '+').replace(/_/g, '/');\n  while (s.length % 4 !== 0) s += '=';\n  try {\n    return Buffer.from(s, 'base64').toString('utf8');\n  } catch {\n    return '';\n  }\n}\n\nfunction extractBody(payload: unknown): string | undefined {\n  const find = (parts: unknown[] | undefined, mime: string): string | undefined => {\n    for (const p of parts ?? []) {\n      if (p && typeof p === 'object' && 'mimeType' in p && 'body' in p) {\n        if (p.mimeType === mime && p.body && typeof p.body === 'object' && 'data' in p.body) {\n          return base64UrlDecode(p.body.data as string);\n        }\n      }\n      if (p && typeof p === 'object' && 'parts' in p) {\n        const nested = find(p.parts as unknown[], mime);\n        if (nested) return nested;\n      }\n    }\n    return undefined;\n  };\n  if (payload && typeof payload === 'object' && 'parts' in payload) {\n    return find(payload.parts as unknown[], 'text/plain') ?? find(payload.parts as unknown[], 'text/html')?.replace(/\\r\\n?/g, '\\n');\n  }\n  return undefined;\n}\n\nexport async function fetchMessage(deps: GmailDeps, id: string, mode: FetchMode): Promise<NormalizedMessage> {\n  const { gmail } = deps;\n  // When only metadata is requested, ask Gmail for a reduced payload with just the headers we care about.\n  const metadataHeaders = ['Date', 'Subject', 'From', 'To', 'Cc', 'Bcc'];\n  const format = mode === 'full' ? 'full' : 'metadata';\n  const baseParams = { userId: 'me' as const, id, format };\n  const resp = format === 'metadata' ? await gmail.users.messages.get({ ...baseParams, metadataHeaders }) : await gmail.users.messages.get(baseParams);\n  const data = resp?.data as unknown;\n  const headers = data && typeof data === 'object' && 'payload' in data && data.payload && typeof data.payload === 'object' && 'headers' in data.payload ? (data.payload.headers as Array<{ name?: string; value?: string }> | undefined) : undefined;\n  const dateRaw = extractHeader(headers, 'Date');\n  const fromRaw = extractHeader(headers, 'From');\n  const toRaw = extractHeader(headers, 'To');\n  const ccRaw = extractHeader(headers, 'Cc');\n  const bccRaw = extractHeader(headers, 'Bcc');\n\n  const fromObj = (fromRaw ? (extractFrom(fromRaw) as NormalizedAddress) : undefined) ?? undefined;\n  const toArr = toRaw ? extractEmails(toRaw) : [];\n  const ccArr = ccRaw ? extractEmails(ccRaw) : [];\n  const bccArr = bccRaw ? extractEmails(bccRaw) : [];\n\n  const getId = (): string => {\n    if (data && typeof data === 'object' && 'id' in data) {\n      return String(data.id ?? id);\n    }\n    return id;\n  };\n\n  const getThreadId = (): string | undefined => {\n    if (data && typeof data === 'object' && 'threadId' in data && data.threadId) {\n      return String(data.threadId);\n    }\n    return undefined;\n  };\n\n  const getSnippet = (): string | undefined => {\n    if (data && typeof data === 'object' && 'snippet' in data && data.snippet) {\n      return String(data.snippet);\n    }\n    return undefined;\n  };\n\n  const getLabelIds = (): string[] | undefined => {\n    if (data && typeof data === 'object' && 'labelIds' in data && Array.isArray(data.labelIds)) {\n      return data.labelIds.map(String);\n    }\n    return undefined;\n  };\n\n  const getPayload = (): unknown => {\n    if (data && typeof data === 'object' && 'payload' in data) {\n      return data.payload;\n    }\n    return undefined;\n  };\n\n  const msg: NormalizedMessage = {\n    id: getId(),\n    threadId: getThreadId(),\n    date: dateRaw ? (toIsoUtc(dateRaw) ?? dateRaw) : undefined,\n    subject: extractHeader(headers, 'Subject'),\n    from: fromObj,\n    to: toArr.length ? toArr : undefined,\n    cc: ccArr.length ? ccArr : undefined,\n    bcc: bccArr.length ? bccArr : undefined,\n    snippet: getSnippet(),\n    labels: getLabelIds(),\n  };\n  if (mode === 'full') {\n    const body = extractBody(getPayload());\n    if (body) msg.body = body;\n  }\n  return msg;\n}\n"],"names":["toIsoUtc","extractEmails","extractFrom","extractHeader","headers","key","h","find","x","name","toLowerCase","value","undefined","base64UrlDecode","input","s","String","replace","length","Buffer","from","toString","extractBody","payload","parts","mime","p","mimeType","body","data","nested","fetchMessage","deps","id","mode","fromRaw","gmail","metadataHeaders","format","baseParams","userId","resp","users","messages","get","dateRaw","toRaw","ccRaw","bccRaw","fromObj","toArr","ccArr","bccArr","getId","getThreadId","threadId","getSnippet","snippet","getLabelIds","Array","isArray","labelIds","map","getPayload","msg","date","subject","to","cc","bcc","labels"],"mappings":"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"}

package/dist/esm/email/messages/messages.d.ts

@@ -0,0 +1,7 @@
+import { buildContentForItems } from '@mcp-z/email';
+import type { gmail_v1 } from 'googleapis';
+export { buildContentForItems };
+export declare function toRowFromGmail(msg?: gmail_v1.Schema$Message, opts?: {
+    body?: boolean;
+    addressFormat?: 'email' | string;
+}): string[];