@mcp-z/mcp-sheets 1.0.0 → 1.0.1

package/dist/esm/spreadsheet/spreadsheet-management.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/spreadsheet/spreadsheet-management.ts"],"sourcesContent":["import type { drive_v3, sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../types.js';\n\nexport const SPREADSHEET_URL_RE = /https:\\/\\/docs.google.com\\/spreadsheets\\/d\\/([a-zA-Z0-9-_]{10,})/;\nexport const SPREADSHEET_ID_RE = /^[a-zA-Z0-9-_]{30,}$/;\n\nexport async function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string) {\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dmResp = await drive.files.get({ fileId: id, fields: 'modifiedTime,webViewLink,name' }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dm = dmResp?.data;\n  if (!ssResp) return null;\n  const ss = ssResp.data;\n  return {\n    id: id,\n    spreadsheetTitle: ss?.properties?.title ?? dm?.name,\n    url: ss?.spreadsheetUrl ?? dm?.webViewLink,\n    modifiedTime: dm?.modifiedTime,\n  };\n}\n\nexport async function findByName(drive: drive_v3.Drive, name: string) {\n  const escaped = String(name).replace(/['\"\\\\]/g, (m) => `\\\\${m}`);\n  const q = `mimeType='application/vnd.google-apps.spreadsheet' and name contains '${escaped}' and trashed = false`;\n  const resp = await drive.files.list({ q, pageSize: 50, fields: 'files(id,name,webViewLink,modifiedTime)' });\n  const files = resp.data?.files || [];\n  return files.map((f) => ({ id: String(f.id), spreadsheetTitle: String(f.name), url: String(f.webViewLink), modifiedTime: f.modifiedTime }));\n}\n\nexport async function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string) {\n  const trimmedRef = ref?.trim();\n  if (!trimmedRef) return [];\n\n  // Strategy 1: Try URL extraction (most specific)\n  const urlMatch = trimmedRef.match(SPREADSHEET_URL_RE);\n  if (urlMatch && typeof urlMatch[1] === 'string' && urlMatch[1].length > 0) {\n    const id = urlMatch[1];\n    const r = await findById(sheets, drive, id);\n    return r ? [r] : [];\n  }\n\n  // Strategy 2: Try direct ID match (if it looks like a spreadsheet ID)\n  if (SPREADSHEET_ID_RE.test(trimmedRef)) {\n    const r = await findById(sheets, drive, trimmedRef);\n    return r ? [r] : [];\n  }\n\n  // Strategy 3: Search by name\n  return await findByName(drive, trimmedRef);\n}\n"],"names":["SPREADSHEET_URL_RE","SPREADSHEET_ID_RE","findById","sheets","drive","id","ss","ssResp","spreadsheets","get","spreadsheetId","catch","e","error","status","response","code","Number","dmResp","files","fileId","fields","dm","data","spreadsheetTitle","properties","title","name","url","spreadsheetUrl","webViewLink","modifiedTime","findByName","resp","escaped","String","replace","m","q","list","pageSize","map","f","findSpreadsheetsByRef","ref","trimmedRef","trim","urlMatch","match","length","r","test"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/spreadsheet/spreadsheet-management.ts"],"sourcesContent":["import type { drive_v3, sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../types.ts';\n\nexport const SPREADSHEET_URL_RE = /https:\\/\\/docs.google.com\\/spreadsheets\\/d\\/([a-zA-Z0-9-_]{10,})/;\nexport const SPREADSHEET_ID_RE = /^[a-zA-Z0-9-_]{30,}$/;\n\nexport async function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string) {\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dmResp = await drive.files.get({ fileId: id, fields: 'modifiedTime,webViewLink,name' }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dm = dmResp?.data;\n  if (!ssResp) return null;\n  const ss = ssResp.data;\n  return {\n    id: id,\n    spreadsheetTitle: ss?.properties?.title ?? dm?.name,\n    url: ss?.spreadsheetUrl ?? dm?.webViewLink,\n    modifiedTime: dm?.modifiedTime,\n  };\n}\n\nexport async function findByName(drive: drive_v3.Drive, name: string) {\n  const escaped = String(name).replace(/['\"\\\\]/g, (m) => `\\\\${m}`);\n  const q = `mimeType='application/vnd.google-apps.spreadsheet' and name contains '${escaped}' and trashed = false`;\n  const resp = await drive.files.list({ q, pageSize: 50, fields: 'files(id,name,webViewLink,modifiedTime)' });\n  const files = resp.data?.files || [];\n  return files.map((f) => ({ id: String(f.id), spreadsheetTitle: String(f.name), url: String(f.webViewLink), modifiedTime: f.modifiedTime }));\n}\n\nexport async function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string) {\n  const trimmedRef = ref?.trim();\n  if (!trimmedRef) return [];\n\n  // Strategy 1: Try URL extraction (most specific)\n  const urlMatch = trimmedRef.match(SPREADSHEET_URL_RE);\n  if (urlMatch && typeof urlMatch[1] === 'string' && urlMatch[1].length > 0) {\n    const id = urlMatch[1];\n    const r = await findById(sheets, drive, id);\n    return r ? [r] : [];\n  }\n\n  // Strategy 2: Try direct ID match (if it looks like a spreadsheet ID)\n  if (SPREADSHEET_ID_RE.test(trimmedRef)) {\n    const r = await findById(sheets, drive, trimmedRef);\n    return r ? [r] : [];\n  }\n\n  // Strategy 3: Search by name\n  return await findByName(drive, trimmedRef);\n}\n"],"names":["SPREADSHEET_URL_RE","SPREADSHEET_ID_RE","findById","sheets","drive","id","ss","ssResp","spreadsheets","get","spreadsheetId","catch","e","error","status","response","code","Number","dmResp","files","fileId","fields","dm","data","spreadsheetTitle","properties","title","name","url","spreadsheetUrl","webViewLink","modifiedTime","findByName","resp","escaped","String","replace","m","q","list","pageSize","map","f","findSpreadsheetsByRef","ref","trimmedRef","trim","urlMatch","match","length","r","test"],"mappings":"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"}

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/types.ts"],"sourcesContent":["import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';\nimport type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';\nimport type { Keyv } from 'keyv';\nimport type { OAuthAdapters } from './setup/oauth-google.js';\n\nexport type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;\n\n/**\n * Composes transport config, OAuth config, and application-level config\n */\nexport interface ServerConfig extends BaseServerConfig, OAuthConfig {\n  logLevel: string;\n  baseDir: string;\n  name: string;\n  version: string;\n  repositoryUrl: string;\n  baseUrl?: string;\n\n  // DCR configuration (when auth === 'dcr')\n  dcrConfig?: DcrConfig;\n}\n\nexport interface GoogleApiError {\n  response?: { status?: number };\n  status?: number;\n  statusCode?: number;\n  code?: number | string;\n  message?: string;\n}\n\n/** Runtime dependencies exposed to middleware/factories. */\nexport interface RuntimeDeps {\n  config: ServerConfig;\n  logger: ServerLogger;\n  tokenStore: Keyv<CachedToken>;\n  oauthAdapters: OAuthAdapters;\n  baseUrl?: string;\n}\n\n/** Collections of MCP modules produced by domain factories. */\nexport type DomainModules = {\n  tools: ToolModule[];\n  resources: ResourceModule[];\n  prompts: PromptModule[];\n};\n\n/** Factory that produces a middleware layer given runtime dependencies. */\nexport type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;\n\n/** Shared runtime configuration returned by `createDefaultRuntime`. */\nexport interface CommonRuntime {\n  deps: RuntimeDeps;\n  middlewareFactories: MiddlewareFactory[];\n  createDomainModules: () => DomainModules;\n  close: () => Promise<void>;\n}\n\nexport interface RuntimeOverrides {\n  middlewareFactories?: MiddlewareFactory[];\n  createDomainModules?: () => DomainModules;\n}\n"],"names":[],"mappings":"AAyDA,WAGC"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/types.ts"],"sourcesContent":["import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';\nimport type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';\nimport type { Keyv } from 'keyv';\nimport type { OAuthAdapters } from './setup/oauth-google.ts';\n\nexport type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;\n\n/**\n * Composes transport config, OAuth config, and application-level config\n */\nexport interface ServerConfig extends BaseServerConfig, OAuthConfig {\n  logLevel: string;\n  baseDir: string;\n  name: string;\n  version: string;\n  repositoryUrl: string;\n  baseUrl?: string;\n\n  // DCR configuration (when auth === 'dcr')\n  dcrConfig?: DcrConfig;\n}\n\nexport interface GoogleApiError {\n  response?: { status?: number };\n  status?: number;\n  statusCode?: number;\n  code?: number | string;\n  message?: string;\n}\n\n/** Runtime dependencies exposed to middleware/factories. */\nexport interface RuntimeDeps {\n  config: ServerConfig;\n  logger: ServerLogger;\n  tokenStore: Keyv<CachedToken>;\n  oauthAdapters: OAuthAdapters;\n  baseUrl?: string;\n}\n\n/** Collections of MCP modules produced by domain factories. */\nexport type DomainModules = {\n  tools: ToolModule[];\n  resources: ResourceModule[];\n  prompts: PromptModule[];\n};\n\n/** Factory that produces a middleware layer given runtime dependencies. */\nexport type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;\n\n/** Shared runtime configuration returned by `createDefaultRuntime`. */\nexport interface CommonRuntime {\n  deps: RuntimeDeps;\n  middlewareFactories: MiddlewareFactory[];\n  createDomainModules: () => DomainModules;\n  close: () => Promise<void>;\n}\n\nexport interface RuntimeOverrides {\n  middlewareFactories?: MiddlewareFactory[];\n  createDomainModules?: () => DomainModules;\n}\n"],"names":[],"mappings":"AAyDA,WAGC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-z/mcp-sheets",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MCP server for Google Sheets integration with OAuth authentication, spreadsheet management, batch operations, and advanced formatting",
   "keywords": [
     "sheets",