@mcp-z/mcp-sheets 1.0.0

package/dist/esm/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/setup/index.ts"],"sourcesContent":["export { createConfig, parseConfig } from './config.js';\nexport { createHTTPServer } from './http.js';\nexport { createOAuthAdapters } from './oauth-google.js';\nexport * from './runtime.js';\nexport { createStdioServer } from './stdio.js';\n"],"names":["createConfig","parseConfig","createHTTPServer","createOAuthAdapters","createStdioServer"],"mappings":"AAAA,SAASA,YAAY,EAAEC,WAAW,QAAQ,cAAc;AACxD,SAASC,gBAAgB,QAAQ,YAAY;AAC7C,SAASC,mBAAmB,QAAQ,oBAAoB;AACxD,cAAc,eAAe;AAC7B,SAASC,iBAAiB,QAAQ,aAAa"}

package/dist/esm/setup/oauth-google.d.ts

@@ -0,0 +1,54 @@
+import { type AuthEmailProvider } from '@mcp-z/oauth';
+import type { CachedToken } from '@mcp-z/oauth-google';
+import { DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';
+import type { Logger, PromptModule, ToolModule } from '@mcp-z/server';
+import type { Router } from 'express';
+import type { Keyv } from 'keyv';
+import type { ServerConfig } from '../types.js';
+/**
+ * Gmail OAuth runtime dependencies.
+ */
+export interface OAuthRuntimeDeps {
+    logger: Logger;
+    tokenStore: Keyv<CachedToken>;
+    dcrStore?: Keyv<unknown>;
+}
+/**
+ * Auth middleware helpers used to wrap MCP modules.
+ */
+export interface AuthMiddleware {
+    withToolAuth<T extends {
+        name: string;
+        config: unknown;
+        handler: unknown;
+    }>(module: T): T;
+    withResourceAuth<T extends {
+        name: string;
+        template?: unknown;
+        config?: unknown;
+        handler: unknown;
+    }>(module: T): T;
+    withPromptAuth<T extends {
+        name: string;
+        config: unknown;
+        handler: unknown;
+    }>(module: T): T;
+}
+/**
+ * Result returned by createOAuthAdapters.
+ */
+export interface OAuthAdapters {
+    primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;
+    middleware: AuthMiddleware;
+    authAdapter: AuthEmailProvider;
+    accountTools: ToolModule[];
+    accountPrompts: PromptModule[];
+    dcrRouter?: Router;
+}
+/**
+ * Create Sheets OAuth adapters and helpers.
+ *
+ * @param config Sheets server configuration.
+ * @param deps Runtime dependencies (logger, token store, optional DCR store).
+ */
+export declare function createOAuthAdapters(config: ServerConfig, deps: OAuthRuntimeDeps, baseUrl?: string): Promise<OAuthAdapters>;

package/dist/esm/setup/oauth-google.js

@@ -0,0 +1,142 @@
+import { AccountServer } from '@mcp-z/oauth';
+import { createDcrRouter, DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';
+import { GOOGLE_SCOPE } from '../constants.js';
+/**
+ * Create Sheets OAuth adapters and helpers.
+ *
+ * @param config Sheets server configuration.
+ * @param deps Runtime dependencies (logger, token store, optional DCR store).
+ */ export async function createOAuthAdapters(config, deps, baseUrl) {
+    const { logger, tokenStore, dcrStore } = deps;
+    const oauthStaticConfig = {
+        service: config.name,
+        clientId: config.clientId,
+        clientSecret: config.clientSecret,
+        scope: GOOGLE_SCOPE,
+        auth: config.auth,
+        headless: config.headless,
+        redirectUri: config.transport.type === 'stdio' ? undefined : config.redirectUri,
+        ...config.serviceAccountKeyFile && {
+            serviceAccountKeyFile: config.serviceAccountKeyFile
+        },
+        ...baseUrl && {
+            baseUrl
+        }
+    };
+    let primary;
+    if (oauthStaticConfig.auth === 'dcr') {
+        logger.debug('Creating DCR provider', {
+            service: oauthStaticConfig.service
+        });
+        if (!dcrStore) {
+            throw new Error('DCR mode requires dcrStore to be configured');
+        }
+        if (!oauthStaticConfig.baseUrl) {
+            throw new Error('DCR mode requires baseUrl to be configured');
+        }
+        primary = new DcrOAuthProvider({
+            clientId: oauthStaticConfig.clientId,
+            ...oauthStaticConfig.clientSecret && {
+                clientSecret: oauthStaticConfig.clientSecret
+            },
+            scope: oauthStaticConfig.scope,
+            verifyEndpoint: `${oauthStaticConfig.baseUrl}/oauth/verify`,
+            logger
+        });
+        const dcrRouter = createDcrRouter({
+            store: dcrStore,
+            issuerUrl: oauthStaticConfig.baseUrl,
+            baseUrl: oauthStaticConfig.baseUrl,
+            scopesSupported: oauthStaticConfig.scope.split(' '),
+            clientConfig: {
+                clientId: oauthStaticConfig.clientId,
+                ...oauthStaticConfig.clientSecret && {
+                    clientSecret: oauthStaticConfig.clientSecret
+                }
+            }
+        });
+        const middleware = primary.authMiddleware();
+        const authAdapter = {
+            getUserEmail: ()=>{
+                throw new Error('DCR mode does not support getUserEmail - tokens are provided via bearer auth');
+            }
+        };
+        return {
+            primary,
+            middleware: middleware,
+            authAdapter,
+            accountTools: [],
+            accountPrompts: [],
+            dcrRouter
+        };
+    }
+    if (oauthStaticConfig.auth === 'service-account') {
+        if (!oauthStaticConfig.serviceAccountKeyFile) {
+            throw new Error('Service account key file is required when auth mode is "service-account". Set GOOGLE_SERVICE_ACCOUNT_KEY_FILE environment variable or use --service-account-key-file flag.');
+        }
+        logger.debug('Creating service account provider', {
+            service: oauthStaticConfig.service
+        });
+        primary = new ServiceAccountProvider({
+            keyFilePath: oauthStaticConfig.serviceAccountKeyFile,
+            scopes: oauthStaticConfig.scope.split(' '),
+            logger
+        });
+    } else {
+        logger.debug('Creating loopback OAuth provider', {
+            service: oauthStaticConfig.service
+        });
+        primary = new LoopbackOAuthProvider({
+            service: oauthStaticConfig.service,
+            clientId: oauthStaticConfig.clientId,
+            clientSecret: oauthStaticConfig.clientSecret,
+            scope: oauthStaticConfig.scope,
+            headless: oauthStaticConfig.headless,
+            logger,
+            tokenStore,
+            ...oauthStaticConfig.redirectUri !== undefined && {
+                redirectUri: oauthStaticConfig.redirectUri
+            }
+        });
+    }
+    const authAdapter = {
+        getUserEmail: (accountId)=>primary.getUserEmail(accountId),
+        ...'authenticateNewAccount' in primary && primary.authenticateNewAccount ? {
+            authenticateNewAccount: ()=>{
+                var _primary_authenticateNewAccount;
+                return (_primary_authenticateNewAccount = primary.authenticateNewAccount) === null || _primary_authenticateNewAccount === void 0 ? void 0 : _primary_authenticateNewAccount.call(primary);
+            }
+        } : {}
+    };
+    let middleware;
+    let accountTools;
+    let accountPrompts;
+    if (oauthStaticConfig.auth === 'service-account') {
+        middleware = primary.authMiddleware();
+        accountTools = [];
+        accountPrompts = [];
+        logger.debug('Service account mode - no account tools', {
+            service: oauthStaticConfig.service
+        });
+    } else {
+        middleware = primary.authMiddleware();
+        const result = AccountServer.createLoopback({
+            service: oauthStaticConfig.service,
+            store: tokenStore,
+            logger,
+            auth: authAdapter
+        });
+        accountTools = result.tools;
+        accountPrompts = result.prompts;
+        logger.debug('Loopback OAuth (multi-account mode)', {
+            service: oauthStaticConfig.service
+        });
+    }
+    return {
+        primary,
+        middleware: middleware,
+        authAdapter,
+        accountTools,
+        accountPrompts
+    };
+}

package/dist/esm/setup/oauth-google.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/setup/oauth-google.ts"],"sourcesContent":["import { AccountServer, type AuthEmailProvider } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport { createDcrRouter, DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';\nimport type { Logger, PromptModule, ToolModule } from '@mcp-z/server';\nimport type { Router } from 'express';\nimport type { Keyv } from 'keyv';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.js';\n\n/**\n * Gmail OAuth runtime dependencies.\n */\nexport interface OAuthRuntimeDeps {\n  logger: Logger;\n  tokenStore: Keyv<CachedToken>;\n  dcrStore?: Keyv<unknown>;\n}\n\n/**\n * Auth middleware helpers used to wrap MCP modules.\n */\nexport interface AuthMiddleware {\n  withToolAuth<T extends { name: string; config: unknown; handler: unknown }>(module: T): T;\n  withResourceAuth<T extends { name: string; template?: unknown; config?: unknown; handler: unknown }>(module: T): T;\n  withPromptAuth<T extends { name: string; config: unknown; handler: unknown }>(module: T): T;\n}\n\n/**\n * Result returned by createOAuthAdapters.\n */\nexport interface OAuthAdapters {\n  primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;\n  middleware: AuthMiddleware;\n  authAdapter: AuthEmailProvider;\n  accountTools: ToolModule[];\n  accountPrompts: PromptModule[];\n  dcrRouter?: Router;\n}\n\n/**\n * Create Sheets OAuth adapters and helpers.\n *\n * @param config Sheets server configuration.\n * @param deps Runtime dependencies (logger, token store, optional DCR store).\n */\nexport async function createOAuthAdapters(config: ServerConfig, deps: OAuthRuntimeDeps, baseUrl?: string): Promise<OAuthAdapters> {\n  const { logger, tokenStore, dcrStore } = deps;\n  const oauthStaticConfig = {\n    service: config.name,\n    clientId: config.clientId,\n    clientSecret: config.clientSecret,\n    scope: GOOGLE_SCOPE,\n    auth: config.auth,\n    headless: config.headless,\n    redirectUri: config.transport.type === 'stdio' ? undefined : config.redirectUri,\n    ...(config.serviceAccountKeyFile && { serviceAccountKeyFile: config.serviceAccountKeyFile }),\n    ...(baseUrl && { baseUrl }),\n  };\n\n  let primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;\n\n  if (oauthStaticConfig.auth === 'dcr') {\n    logger.debug('Creating DCR provider', { service: oauthStaticConfig.service });\n\n    if (!dcrStore) {\n      throw new Error('DCR mode requires dcrStore to be configured');\n    }\n    if (!oauthStaticConfig.baseUrl) {\n      throw new Error('DCR mode requires baseUrl to be configured');\n    }\n\n    primary = new DcrOAuthProvider({\n      clientId: oauthStaticConfig.clientId,\n      ...(oauthStaticConfig.clientSecret && { clientSecret: oauthStaticConfig.clientSecret }),\n      scope: oauthStaticConfig.scope,\n      verifyEndpoint: `${oauthStaticConfig.baseUrl}/oauth/verify`,\n      logger,\n    });\n\n    const dcrRouter = createDcrRouter({\n      store: dcrStore,\n      issuerUrl: oauthStaticConfig.baseUrl,\n      baseUrl: oauthStaticConfig.baseUrl,\n      scopesSupported: oauthStaticConfig.scope.split(' '),\n      clientConfig: {\n        clientId: oauthStaticConfig.clientId,\n        ...(oauthStaticConfig.clientSecret && { clientSecret: oauthStaticConfig.clientSecret }),\n      },\n    });\n\n    const middleware = primary.authMiddleware();\n    const authAdapter: AuthEmailProvider = {\n      getUserEmail: () => {\n        throw new Error('DCR mode does not support getUserEmail - tokens are provided via bearer auth');\n      },\n    };\n\n    return {\n      primary,\n      middleware: middleware as unknown as AuthMiddleware,\n      authAdapter,\n      accountTools: [],\n      accountPrompts: [],\n      dcrRouter,\n    };\n  }\n\n  if (oauthStaticConfig.auth === 'service-account') {\n    if (!oauthStaticConfig.serviceAccountKeyFile) {\n      throw new Error('Service account key file is required when auth mode is \"service-account\". Set GOOGLE_SERVICE_ACCOUNT_KEY_FILE environment variable or use --service-account-key-file flag.');\n    }\n\n    logger.debug('Creating service account provider', { service: oauthStaticConfig.service });\n    primary = new ServiceAccountProvider({\n      keyFilePath: oauthStaticConfig.serviceAccountKeyFile,\n      scopes: oauthStaticConfig.scope.split(' '),\n      logger,\n    });\n  } else {\n    logger.debug('Creating loopback OAuth provider', { service: oauthStaticConfig.service });\n    primary = new LoopbackOAuthProvider({\n      service: oauthStaticConfig.service,\n      clientId: oauthStaticConfig.clientId,\n      clientSecret: oauthStaticConfig.clientSecret,\n      scope: oauthStaticConfig.scope,\n      headless: oauthStaticConfig.headless,\n      logger,\n      tokenStore,\n      ...(oauthStaticConfig.redirectUri !== undefined && { redirectUri: oauthStaticConfig.redirectUri }),\n    });\n  }\n\n  const authAdapter: AuthEmailProvider = {\n    getUserEmail: (accountId) => primary.getUserEmail(accountId),\n    ...('authenticateNewAccount' in primary && primary.authenticateNewAccount\n      ? {\n          authenticateNewAccount: () => primary.authenticateNewAccount?.(),\n        }\n      : {}),\n  };\n\n  let middleware: ReturnType<LoopbackOAuthProvider['authMiddleware']>;\n  let accountTools: ToolModule[];\n  let accountPrompts: PromptModule[];\n\n  if (oauthStaticConfig.auth === 'service-account') {\n    middleware = primary.authMiddleware();\n    accountTools = [];\n    accountPrompts = [];\n    logger.debug('Service account mode - no account tools', { service: oauthStaticConfig.service });\n  } else {\n    middleware = primary.authMiddleware();\n\n    const result = AccountServer.createLoopback({\n      service: oauthStaticConfig.service,\n      store: tokenStore,\n      logger,\n      auth: authAdapter,\n    });\n    accountTools = result.tools as ToolModule[];\n    accountPrompts = result.prompts as PromptModule[];\n    logger.debug('Loopback OAuth (multi-account mode)', { service: oauthStaticConfig.service });\n  }\n\n  return {\n    primary,\n    middleware: middleware as unknown as AuthMiddleware,\n    authAdapter,\n    accountTools,\n    accountPrompts,\n  };\n}\n"],"names":["AccountServer","createDcrRouter","DcrOAuthProvider","LoopbackOAuthProvider","ServiceAccountProvider","GOOGLE_SCOPE","createOAuthAdapters","config","deps","baseUrl","logger","tokenStore","dcrStore","oauthStaticConfig","service","name","clientId","clientSecret","scope","auth","headless","redirectUri","transport","type","undefined","serviceAccountKeyFile","primary","debug","Error","verifyEndpoint","dcrRouter","store","issuerUrl","scopesSupported","split","clientConfig","middleware","authMiddleware","authAdapter","getUserEmail","accountTools","accountPrompts","keyFilePath","scopes","accountId","authenticateNewAccount","result","createLoopback","tools","prompts"],"mappings":"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"}

package/dist/esm/setup/runtime.d.ts

@@ -0,0 +1,10 @@
+import type { CachedToken } from '@mcp-z/oauth-google';
+import type { Logger, MiddlewareLayer } from '@mcp-z/server';
+import type { CommonRuntime, RuntimeOverrides, ServerConfig } from '../types.js';
+import { type OAuthAdapters } from './oauth-google.js';
+export declare function createLogger(config: ServerConfig): Logger;
+export declare function createTokenStore(baseDir: string): Promise<import("keyv").Keyv<CachedToken>>;
+export declare function createDcrStore(baseDir: string, required: boolean): Promise<import("keyv").Keyv<unknown>>;
+export declare function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer;
+export declare function createLoggingLayer(logger: Logger): MiddlewareLayer;
+export declare function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime>;

package/dist/esm/setup/runtime.js

@@ -0,0 +1,84 @@
+import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';
+import { createLoggingMiddleware } from '@mcp-z/server';
+import * as fs from 'fs';
+import * as path from 'path';
+import pino from 'pino';
+import createStore from '../lib/create-store.js';
+import * as mcp from '../mcp/index.js';
+import { createOAuthAdapters } from './oauth-google.js';
+export function createLogger(config) {
+    var _config_logLevel;
+    const hasStdio = config.transport.type === 'stdio';
+    const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);
+    if (hasStdio) fs.mkdirSync(path.dirname(logsPath), {
+        recursive: true
+    });
+    return pino({
+        level: (_config_logLevel = config.logLevel) !== null && _config_logLevel !== void 0 ? _config_logLevel : 'info',
+        formatters: sanitizeForLoggingFormatter()
+    }, hasStdio ? pino.destination({
+        dest: logsPath,
+        sync: false
+    }) : pino.destination(1));
+}
+export async function createTokenStore(baseDir) {
+    const storeUri = process.env.STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;
+    return createStore(storeUri);
+}
+export async function createDcrStore(baseDir, required) {
+    if (!required) return undefined;
+    const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;
+    return createStore(dcrStoreUri);
+}
+export function createAuthLayer(authMiddleware) {
+    return {
+        withTool: authMiddleware.withToolAuth,
+        withResource: authMiddleware.withResourceAuth,
+        withPrompt: authMiddleware.withPromptAuth
+    };
+}
+export function createLoggingLayer(logger) {
+    const logging = createLoggingMiddleware({
+        logger
+    });
+    return {
+        withTool: logging.withToolLogging,
+        withResource: logging.withResourceLogging,
+        withPrompt: logging.withPromptLogging
+    };
+}
+export async function createDefaultRuntime(config, overrides) {
+    var _config_baseUrl, _ref, _ref1;
+    if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');
+    const logger = createLogger(config);
+    const tokenStore = await createTokenStore(config.baseDir);
+    const baseUrl = (_config_baseUrl = config.baseUrl) !== null && _config_baseUrl !== void 0 ? _config_baseUrl : config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined;
+    const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');
+    const oauthAdapters = await createOAuthAdapters(config, {
+        logger,
+        tokenStore,
+        dcrStore
+    }, baseUrl);
+    const deps = {
+        config,
+        logger,
+        tokenStore,
+        oauthAdapters,
+        baseUrl
+    };
+    const createDomainModules = (_ref = overrides === null || overrides === void 0 ? void 0 : overrides.createDomainModules) !== null && _ref !== void 0 ? _ref : ()=>({
+            tools: Object.values(mcp.toolFactories).map((factory)=>factory()),
+            resources: Object.values(mcp.resourceFactories).map((factory)=>factory()),
+            prompts: Object.values(mcp.promptFactories).map((factory)=>factory())
+        });
+    const middlewareFactories = (_ref1 = overrides === null || overrides === void 0 ? void 0 : overrides.middlewareFactories) !== null && _ref1 !== void 0 ? _ref1 : [
+        ()=>createAuthLayer(oauthAdapters.middleware),
+        ()=>createLoggingLayer(logger)
+    ];
+    return {
+        deps,
+        middlewareFactories,
+        createDomainModules,
+        close: async ()=>{}
+    };
+}

package/dist/esm/setup/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/setup/runtime.ts"],"sourcesContent":["import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.js';\nimport * as mcp from '../mcp/index.js';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig } from '../types.js';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.js';\n\nexport function createLogger(config: ServerConfig): Logger {\n  const hasStdio = config.transport.type === 'stdio';\n  const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n  if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n  return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string) {\n  const storeUri = process.env.STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;\n  return createStore<CachedToken>(storeUri);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean) {\n  if (!required) return undefined;\n  const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;\n  return createStore<unknown>(dcrStoreUri);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n  return {\n    withTool: authMiddleware.withToolAuth,\n    withResource: authMiddleware.withResourceAuth,\n    withPrompt: authMiddleware.withPromptAuth,\n  };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n  const logging = createLoggingMiddleware({ logger });\n  return {\n    withTool: logging.withToolLogging,\n    withResource: logging.withResourceLogging,\n    withPrompt: logging.withPromptLogging,\n  };\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n  if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n  const logger = createLogger(config);\n  const tokenStore = await createTokenStore(config.baseDir);\n  const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n  const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');\n  const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n  const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n  const createDomainModules =\n    overrides?.createDomainModules ??\n    (() => ({\n      tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n      resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n      prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n    }));\n  const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger)];\n\n  return {\n    deps,\n    middlewareFactories,\n    createDomainModules,\n    close: async () => {},\n  };\n}\n"],"names":["sanitizeForLoggingFormatter","createLoggingMiddleware","fs","path","pino","createStore","mcp","createOAuthAdapters","createLogger","config","hasStdio","transport","type","logsPath","join","baseDir","name","mkdirSync","dirname","recursive","level","logLevel","formatters","destination","dest","sync","createTokenStore","storeUri","process","env","STORE_URI","createDcrStore","required","undefined","dcrStoreUri","DCR_STORE_URI","createAuthLayer","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","createLoggingLayer","logger","logging","withToolLogging","withResourceLogging","withPromptLogging","createDefaultRuntime","overrides","auth","Error","tokenStore","baseUrl","port","dcrStore","oauthAdapters","deps","createDomainModules","tools","Object","values","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middlewareFactories","middleware","close"],"mappings":"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"}

package/dist/esm/setup/stdio.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RuntimeOverrides, ServerConfig } from '../types.js';
+export declare function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
+    mcpServer: McpServer;
+    logger: import("@mcp-z/server").Logger;
+    close: () => Promise<void>;
+}>;

package/dist/esm/setup/stdio.js

@@ -0,0 +1,38 @@
+import { composeMiddleware, connectStdio, registerPrompts, registerResources, registerTools } from '@mcp-z/server';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { createDefaultRuntime } from './runtime.js';
+export async function createStdioServer(config, overrides) {
+    const runtime = await createDefaultRuntime(config, overrides);
+    const modules = runtime.createDomainModules();
+    const layers = runtime.middlewareFactories.map((factory)=>factory(runtime.deps));
+    const composed = composeMiddleware(modules, layers);
+    const logger = runtime.deps.logger;
+    const tools = [
+        ...composed.tools,
+        ...runtime.deps.oauthAdapters.accountTools
+    ];
+    const prompts = [
+        ...composed.prompts,
+        ...runtime.deps.oauthAdapters.accountPrompts
+    ];
+    const mcpServer = new McpServer({
+        name: config.name,
+        version: config.version
+    });
+    registerTools(mcpServer, tools);
+    registerResources(mcpServer, composed.resources);
+    registerPrompts(mcpServer, prompts);
+    logger.info(`Starting ${config.name} MCP server (stdio)`);
+    const { close } = await connectStdio(mcpServer, {
+        logger
+    });
+    logger.info('stdio transport ready');
+    return {
+        mcpServer,
+        logger,
+        close: async ()=>{
+            await close();
+            await runtime.close();
+        }
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/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":["composeMiddleware","connectStdio","registerPrompts","registerResources","registerTools","McpServer","createDefaultRuntime","createStdioServer","config","overrides","runtime","modules","createDomainModules","layers","middlewareFactories","map","factory","deps","composed","logger","tools","oauthAdapters","accountTools","prompts","accountPrompts","mcpServer","name","version","resources","info","close"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,YAAY,EAAEC,eAAe,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,gBAAgB;AACnH,SAASC,SAAS,QAAQ,0CAA0C;AAEpE,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,OAAO,eAAeC,kBAAkBC,MAAoB,EAAEC,SAA4B;IACxF,MAAMC,UAAU,MAAMJ,qBAAqBE,QAAQC;IACnD,MAAME,UAAUD,QAAQE,mBAAmB;IAC3C,MAAMC,SAASH,QAAQI,mBAAmB,CAACC,GAAG,CAAC,CAACC,UAAYA,QAAQN,QAAQO,IAAI;IAChF,MAAMC,WAAWlB,kBAAkBW,SAASE;IAC5C,MAAMM,SAAST,QAAQO,IAAI,CAACE,MAAM;IAElC,MAAMC,QAAQ;WAAIF,SAASE,KAAK;WAAKV,QAAQO,IAAI,CAACI,aAAa,CAACC,YAAY;KAAC;IAC7E,MAAMC,UAAU;WAAIL,SAASK,OAAO;WAAKb,QAAQO,IAAI,CAACI,aAAa,CAACG,cAAc;KAAC;IAEnF,MAAMC,YAAY,IAAIpB,UAAU;QAAEqB,MAAMlB,OAAOkB,IAAI;QAAEC,SAASnB,OAAOmB,OAAO;IAAC;IAC7EvB,cAAcqB,WAAWL;IACzBjB,kBAAkBsB,WAAWP,SAASU,SAAS;IAC/C1B,gBAAgBuB,WAAWF;IAE3BJ,OAAOU,IAAI,CAAC,CAAC,SAAS,EAAErB,OAAOkB,IAAI,CAAC,mBAAmB,CAAC;IACxD,MAAM,EAAEI,KAAK,EAAE,GAAG,MAAM7B,aAAawB,WAAW;QAAEN;IAAO;IACzDA,OAAOU,IAAI,CAAC;IAEZ,OAAO;QACLJ;QACAN;QACAW,OAAO;YACL,MAAMA;YACN,MAAMpB,QAAQoB,KAAK;QACrB;IACF;AACF"}

package/dist/esm/spreadsheet/column-utilities.d.ts

@@ -0,0 +1 @@
+export declare function a1Col(colIndex: number): string;

package/dist/esm/spreadsheet/column-utilities.js

@@ -0,0 +1,10 @@
+export function a1Col(colIndex) {
+    let col = '';
+    let i = colIndex;
+    while(i > 0){
+        const rem = (i - 1) % 26;
+        col = String.fromCharCode(65 + rem) + col;
+        i = Math.floor((i - 1) / 26);
+    }
+    return col;
+}

package/dist/esm/spreadsheet/column-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/spreadsheet/column-utilities.ts"],"sourcesContent":["export function a1Col(colIndex: number): string {\n  let col = '';\n  let i = colIndex;\n  while (i > 0) {\n    const rem = (i - 1) % 26;\n    col = String.fromCharCode(65 + rem) + col;\n    i = Math.floor((i - 1) / 26);\n  }\n  return col;\n}\n"],"names":["a1Col","colIndex","col","i","rem","String","fromCharCode","Math","floor"],"mappings":"AAAA,OAAO,SAASA,MAAMC,QAAgB;IACpC,IAAIC,MAAM;IACV,IAAIC,IAAIF;IACR,MAAOE,IAAI,EAAG;QACZ,MAAMC,MAAM,AAACD,CAAAA,IAAI,CAAA,IAAK;QACtBD,MAAMG,OAAOC,YAAY,CAAC,KAAKF,OAAOF;QACtCC,IAAII,KAAKC,KAAK,CAAC,AAACL,CAAAA,IAAI,CAAA,IAAK;IAC3B;IACA,OAAOD;AACT"}

package/dist/esm/spreadsheet/csv-streaming.d.ts

@@ -0,0 +1,19 @@
+/** Streaming CSV parsing utilities for memory-efficient large file processing */
+import { Readable } from 'stream';
+/**
+ * Get readable stream from CSV URI
+ *
+ * Memory efficiency:
+ * - file:// URIs stream directly from disk
+ * - http:// URIs stream directly from response (no temp files!)
+ *
+ * @example
+ * ```ts
+ * const readStream = await getCsvReadStream(csvUri);
+ * const parser = readStream.pipe(parse({ columns: true }));
+ * for await (const record of parser) {
+ *   // Process record
+ * }
+ * ```
+ */
+export declare function getCsvReadStream(csvUri: string): Promise<Readable>;

package/dist/esm/spreadsheet/csv-streaming.js

@@ -0,0 +1,43 @@
+/** Streaming CSV parsing utilities for memory-efficient large file processing */ import { createReadStream } from 'fs';
+import { resolve } from 'path';
+import { Readable } from 'stream';
+/**
+ * Get readable stream from CSV URI
+ *
+ * Memory efficiency:
+ * - file:// URIs stream directly from disk
+ * - http:// URIs stream directly from response (no temp files!)
+ *
+ * @example
+ * ```ts
+ * const readStream = await getCsvReadStream(csvUri);
+ * const parser = readStream.pipe(parse({ columns: true }));
+ * for await (const record of parser) {
+ *   // Process record
+ * }
+ * ```
+ */ export async function getCsvReadStream(csvUri) {
+    if (csvUri.startsWith('file://')) {
+        // Local file - stream directly from disk
+        const filePath = csvUri.replace('file://', '');
+        const resolvedPath = resolve(filePath);
+        return createReadStream(resolvedPath, {
+            encoding: 'utf-8'
+        });
+    }
+    if (csvUri.startsWith('http://') || csvUri.startsWith('https://')) {
+        // Remote file - stream directly from fetch response
+        const response = await fetch(csvUri);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch CSV from ${csvUri}: ${response.statusText}`);
+        }
+        if (!response.body) {
+            throw new Error(`No response body from ${csvUri}`);
+        }
+        // Convert web stream to Node.js stream
+        // response.body is ReadableStream<Uint8Array> from fetch API
+        // Cast to Node.js ReadableStream type for compatibility with Readable.fromWeb
+        return Readable.fromWeb(response.body);
+    }
+    throw new Error(`Invalid CSV URI: ${csvUri}. Must start with file://, http://, or https://`);
+}

package/dist/esm/spreadsheet/csv-streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/spreadsheet/csv-streaming.ts"],"sourcesContent":["/** Streaming CSV parsing utilities for memory-efficient large file processing */\n\nimport { createReadStream } from 'fs';\nimport { resolve } from 'path';\nimport { Readable } from 'stream';\nimport type { ReadableStream as NodeReadableStream } from 'stream/web';\n\n/**\n * Get readable stream from CSV URI\n *\n * Memory efficiency:\n * - file:// URIs stream directly from disk\n * - http:// URIs stream directly from response (no temp files!)\n *\n * @example\n * ```ts\n * const readStream = await getCsvReadStream(csvUri);\n * const parser = readStream.pipe(parse({ columns: true }));\n * for await (const record of parser) {\n *   // Process record\n * }\n * ```\n */\nexport async function getCsvReadStream(csvUri: string): Promise<Readable> {\n  if (csvUri.startsWith('file://')) {\n    // Local file - stream directly from disk\n    const filePath = csvUri.replace('file://', '');\n    const resolvedPath = resolve(filePath);\n    return createReadStream(resolvedPath, { encoding: 'utf-8' });\n  }\n\n  if (csvUri.startsWith('http://') || csvUri.startsWith('https://')) {\n    // Remote file - stream directly from fetch response\n    const response = await fetch(csvUri);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch CSV from ${csvUri}: ${response.statusText}`);\n    }\n\n    if (!response.body) {\n      throw new Error(`No response body from ${csvUri}`);\n    }\n\n    // Convert web stream to Node.js stream\n    // response.body is ReadableStream<Uint8Array> from fetch API\n    // Cast to Node.js ReadableStream type for compatibility with Readable.fromWeb\n    return Readable.fromWeb(response.body as unknown as NodeReadableStream<Uint8Array>);\n  }\n\n  throw new Error(`Invalid CSV URI: ${csvUri}. Must start with file://, http://, or https://`);\n}\n"],"names":["createReadStream","resolve","Readable","getCsvReadStream","csvUri","startsWith","filePath","replace","resolvedPath","encoding","response","fetch","ok","Error","statusText","body","fromWeb"],"mappings":"AAAA,+EAA+E,GAE/E,SAASA,gBAAgB,QAAQ,KAAK;AACtC,SAASC,OAAO,QAAQ,OAAO;AAC/B,SAASC,QAAQ,QAAQ,SAAS;AAGlC;;;;;;;;;;;;;;;CAeC,GACD,OAAO,eAAeC,iBAAiBC,MAAc;IACnD,IAAIA,OAAOC,UAAU,CAAC,YAAY;QAChC,yCAAyC;QACzC,MAAMC,WAAWF,OAAOG,OAAO,CAAC,WAAW;QAC3C,MAAMC,eAAeP,QAAQK;QAC7B,OAAON,iBAAiBQ,cAAc;YAAEC,UAAU;QAAQ;IAC5D;IAEA,IAAIL,OAAOC,UAAU,CAAC,cAAcD,OAAOC,UAAU,CAAC,aAAa;QACjE,oDAAoD;QACpD,MAAMK,WAAW,MAAMC,MAAMP;QAC7B,IAAI,CAACM,SAASE,EAAE,EAAE;YAChB,MAAM,IAAIC,MAAM,CAAC,yBAAyB,EAAET,OAAO,EAAE,EAAEM,SAASI,UAAU,EAAE;QAC9E;QAEA,IAAI,CAACJ,SAASK,IAAI,EAAE;YAClB,MAAM,IAAIF,MAAM,CAAC,sBAAsB,EAAET,QAAQ;QACnD;QAEA,uCAAuC;QACvC,6DAA6D;QAC7D,8EAA8E;QAC9E,OAAOF,SAASc,OAAO,CAACN,SAASK,IAAI;IACvC;IAEA,MAAM,IAAIF,MAAM,CAAC,iBAAiB,EAAET,OAAO,+CAA+C,CAAC;AAC7F"}

package/dist/esm/spreadsheet/data-operations.d.ts

@@ -0,0 +1,115 @@
+import type { sheets_v4 } from 'googleapis';
+import type { Logger } from '../types.js';
+export type Cell = string | number | boolean | null | undefined;
+export type Row = Cell[];
+export interface ColumnMapping {
+    canonical: string;
+    sheet: string;
+    index: number;
+}
+export interface HeaderValidationResult {
+    valid: boolean;
+    missingColumns: string[];
+    extraColumns: string[];
+    mappings: ColumnMapping[];
+}
+export interface KeyGenerationStrategy {
+    keyColumns: string[];
+    useProviderIdLogic: boolean;
+    separator?: string;
+}
+export interface DataPartition {
+    toAppend: Row[];
+    toUpdate: Array<{
+        row: Row;
+        existingRowIndex: number;
+    }>;
+    skippedKeys: string[];
+}
+export interface BatchOperationResult {
+    updatedRows: number;
+    inserted: string[];
+    rowsSkipped: number;
+    errors?: string[];
+}
+export interface UpsertOptions {
+    keyStrategy: KeyGenerationStrategy;
+    allowUpdates: boolean;
+    batchSize?: number;
+    valueInputOption?: 'RAW' | 'USER_ENTERED';
+}
+export declare function discoverHeader(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string): Promise<string[]>;
+export declare function validateAndMapHeaders(sheetHeaders: string[], canonicalHeaders: string[], requiredColumns?: string[]): HeaderValidationResult;
+/** Ensures consistent key generation across all functions */
+export declare function generateRowKey(row: Row, header: string[], strategy: KeyGenerationStrategy): string;
+export declare function validateRowKeys(rows: Row[], header: string[], strategy: KeyGenerationStrategy): {
+    valid: boolean;
+    duplicateKeys: string[];
+    keyMap: Map<string, number[]>;
+};
+export declare function appendRows(sheets: sheets_v4.Sheets, params: {
+    spreadsheetId: string;
+    sheetTitle: string;
+    rows?: unknown[];
+    keySet?: Set<string> | null;
+    keyColumns?: string[];
+    header?: string[];
+    logger: Logger;
+}): Promise<{
+    updatedRows: number;
+    inserted: string[];
+    rowsSkipped?: number;
+}>;
+export declare function appendRows(sheets: sheets_v4.Sheets, params: {
+    spreadsheetId: string;
+    sheetRef: string;
+    rows?: unknown[];
+    keySet?: Set<string> | null;
+    keyColumns?: string[];
+    header?: string[];
+    logger: Logger;
+}): Promise<{
+    updatedRows: number;
+    inserted: string[];
+    rowsSkipped?: number;
+}>;
+export declare function mapRowsToHeader({ rows, header, canonical }: {
+    rows?: Row[];
+    header?: string[];
+    canonical?: string[];
+}): Row[];
+export declare function snapshotHeaderAndKeys(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns?: string[], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{
+    header: string[];
+    keySet: Set<string>;
+    keyIndices: number[];
+}>;
+/** Tracks row positions for updates in addition to keys */
+export declare function snapshotHeaderKeysAndPositions(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns?: string[], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{
+    header: string[];
+    keySet: Set<string>;
+    keyToRowMap: Map<string, number>;
+    keyIndices: number[];
+}>;
+/**
+ * Partitions data into updates vs appends based on existing keys with row position tracking
+ */
+export declare function partitionDataForUpsert(rows: Row[], header: string[], keyStrategy: KeyGenerationStrategy, existingKeys: Set<string>, allowUpdates?: boolean, keyToRowMap?: Map<string, number>): DataPartition;
+/**
+ * Performs batch updates on existing rows using batchUpdate API
+ */
+export declare function performBatchUpdates(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, updates: Array<{
+    row: Row;
+    existingRowIndex: number;
+}>, header: string[], batchSize: number, valueInputOption: 'RAW' | 'USER_ENTERED'): Promise<{
+    updatedRows: number;
+    errors?: string[];
+}>;
+export declare function upsertByKey(sheets: sheets_v4.Sheets, { spreadsheetId, sheetTitle, sheetRef, rows, canonicalHeaders, options, logger, }: {
+    spreadsheetId: string;
+    sheetTitle?: string;
+    sheetRef?: string;
+    rows: Row[];
+    canonicalHeaders?: string[];
+    options: UpsertOptions;
+    logger: Logger;
+}): Promise<BatchOperationResult>;