@mcp-z/mcp-drive 1.0.6 → 1.0.8

package/dist/cjs/mcp/tools/folder-search.js

@@ -120,10 +120,6 @@ function _object_spread_props(target, source) {
 function _to_consumable_array(arr) {
     return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
 }
-function _type_of(obj) {
-    "@swc/helpers - typeof";
-    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
-}
 function _unsupported_iterable_to_array(o, minLen) {
     if (!o) return;
     if (typeof o === "string") return _array_like_to_array(o, minLen);
@@ -233,7 +229,7 @@ function _ts_generator(thisArg, body) {
 }
 var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
 var inputSchema = _zod.z.object(_object_spread_props(_object_spread({
-    query: _indexts.DriveQuerySchema.optional().describe('Drive query object with structured search fields. See DriveQuerySchema for detailed query syntax and examples.'),
+    query: _indexts.DriveQueryParameterSchema.optional().describe('Structured Drive query object or JSON string. Use rawDriveQuery for raw Drive syntax.'),
     fields: (0, _server.createFieldsSchema)({
         availableFields: _to_consumable_array(_indexts.DRIVE_FILE_FIELDS).concat([
             'path'
@@ -416,51 +412,49 @@ var config = {
 }
 function handler(_0, _1) {
     return _async_to_generator(function(param, extra) {
-        var query, _param_resolvePaths, resolvePaths, _param_pageSize, pageSize, pageToken, fields, _param_shape, shape, logger, requestedFields, validPageSize, drive, folderMimeType, qStr, q, listOptions, response, res, folders, parentIds, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, f, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, parentId, parentNameMap, parentFetches, folderCache, items, filteredItems, nextPageToken, result, error, message, isDriveValidationError, result1;
+        var query, _param_resolvePaths, resolvePaths, _param_pageSize, pageSize, pageToken, fields, _param_shape, shape, logger, parsedQuery, requestedFields, validPageSize, drive, folderMimeType, qStr, q, listOptions, response, res, folders, parentIds, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, f, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, parentId, parentNameMap, parentFetches, folderCache, items, filteredItems, nextPageToken, result, error, message;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
                     query = param.query, _param_resolvePaths = param.resolvePaths, resolvePaths = _param_resolvePaths === void 0 ? false : _param_resolvePaths, _param_pageSize = param.pageSize, pageSize = _param_pageSize === void 0 ? 50 : _param_pageSize, pageToken = param.pageToken, fields = param.fields, _param_shape = param.shape, shape = _param_shape === void 0 ? 'arrays' : _param_shape;
                     logger = extra.logger;
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        6,
+                        ,
+                        7
+                    ]);
+                    parsedQuery = (0, _indexts.parseDriveQueryParameter)(query);
                     requestedFields = (0, _server.parseFields)(fields, _to_consumable_array(_indexts.DRIVE_FILE_FIELDS).concat([
                         'path'
                     ]));
                     // Validate and clamp pageSize to Google Drive API limits (1-1000)
                     validPageSize = Math.max(1, Math.min(1000, Math.floor(pageSize || 50)));
                     logger.info('drive.folder.search called', {
-                        query: query,
+                        query: parsedQuery,
                         resolvePaths: resolvePaths,
                         pageSize: validPageSize,
                         pageToken: pageToken ? '[provided]' : undefined,
                         fields: fields || 'all'
                     });
-                    _state.label = 1;
-                case 1:
-                    _state.trys.push([
-                        1,
-                        6,
-                        ,
-                        7
-                    ]);
                     drive = _googleapis.google.drive({
                         version: 'v3',
                         auth: extra.authContext.auth
                     });
                     folderMimeType = 'application/vnd.google-apps.folder';
-                    if (typeof query === 'string') {
-                        // String query - treat as raw Drive query
-                        qStr = "(".concat(query, ") and mimeType='").concat(folderMimeType, "' and trashed = false");
-                    } else if (query && (typeof query === "undefined" ? "undefined" : _type_of(query)) === 'object' && 'rawDriveQuery' in query && query.rawDriveQuery) {
+                    if (parsedQuery && 'rawDriveQuery' in parsedQuery && parsedQuery.rawDriveQuery) {
                         // Object with rawDriveQuery field - use it directly
-                        qStr = "(".concat(query.rawDriveQuery, ") and mimeType='").concat(folderMimeType, "' and trashed = false");
-                    } else if (query) {
+                        qStr = parsedQuery.rawDriveQuery;
+                    } else if (parsedQuery) {
                         // Structured query object - convert to Drive query string
-                        q = (0, _querybuilderts.toDriveQuery)(query).q;
-                        qStr = q ? "(".concat(q, ") and mimeType='").concat(folderMimeType, "' and trashed = false") : "mimeType='".concat(folderMimeType, "' and trashed = false");
+                        q = (0, _querybuilderts.toDriveQuery)(parsedQuery).q;
+                        qStr = q || '';
                     } else {
-                        // No query - return all folders
-                        qStr = "mimeType='".concat(folderMimeType, "' and trashed = false");
+                        qStr = '';
                     }
+                    qStr = qStr ? "(".concat(qStr, ") and mimeType='").concat(folderMimeType, "'") : "mimeType='".concat(folderMimeType, "'");
                     listOptions = {
                         q: qStr,
                         pageSize: validPageSize,
@@ -661,7 +655,7 @@ function handler(_0, _1) {
                         return (0, _server.filterFields)(item, requestedFields);
                     });
                     logger.info('drive.folder.search returning', {
-                        query: query,
+                        query: parsedQuery,
                         pageSize: pageSize,
                         resultCount: filteredItems.length,
                         resolvePaths: resolvePaths,
@@ -706,39 +700,7 @@ function handler(_0, _1) {
                     logger.error('drive.folder.search error', {
                         error: message
                     });
-                    // Check if this is a Drive API validation error (invalid query, invalid pageToken, etc.)
-                    // These should return empty results rather than throw
-                    isDriveValidationError = message.includes('Invalid Value') || message.includes('Invalid value') || message.includes('File not found') || message.includes('Bad Request');
-                    if (isDriveValidationError) {
-                        // Return empty result set for validation errors
-                        result1 = shape === 'arrays' ? {
-                            type: 'success',
-                            shape: 'arrays',
-                            columns: [],
-                            rows: [],
-                            count: 0
-                        } : {
-                            type: 'success',
-                            shape: 'objects',
-                            items: [],
-                            count: 0
-                        };
-                        return [
-                            2,
-                            {
-                                content: [
-                                    {
-                                        type: 'text',
-                                        text: JSON.stringify(result1)
-                                    }
-                                ],
-                                structuredContent: {
-                                    result: result1
-                                }
-                            }
-                        ];
-                    }
-                    // Throw McpError for other errors
+                    // Throw McpError for all errors so callers can see Drive validation details
                     throw new _types.McpError(_types.ErrorCode.InternalError, "Error searching folders: ".concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });

package/dist/cjs/mcp/tools/folder-search.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/mcp/tools/folder-search.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, toColumnarFormat } from '@mcp-z/server';\nimport { type CallToolResult, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport type { drive_v3 } from 'googleapis';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { toDriveQuery } from '../../lib/query-builder.ts';\nimport { DRIVE_FILE_COMMON_PATTERNS, DRIVE_FILE_FIELD_DESCRIPTIONS, DRIVE_FILE_FIELDS, type DriveFile, DriveFileSchema, DriveQuerySchema } from '../../schemas/index.ts';\nimport type { Logger } from '../../types.ts';\n\nconst inputSchema = z.object({\n  query: DriveQuerySchema.optional().describe('Drive query object with structured search fields. See DriveQuerySchema for detailed query syntax and examples.'),\n  fields: createFieldsSchema({\n    availableFields: [...DRIVE_FILE_FIELDS, 'path'] as const,\n    fieldDescriptions: {\n      ...DRIVE_FILE_FIELD_DESCRIPTIONS,\n      path: 'Full folder path like /Work/Projects (requires resolvePaths=true)',\n    },\n    commonPatterns: DRIVE_FILE_COMMON_PATTERNS,\n    resourceName: 'Drive folder',\n  }),\n  resolvePaths: z.boolean().optional().describe('Resolve full folder paths like /Work/Projects/2024 (requires additional API calls per result)'),\n  ...createPaginationSchema({\n    defaultPageSize: 50,\n    maxPageSize: 1000,\n    provider: 'drive',\n  }).shape,\n  shape: createShapeSchema(),\n});\n\n// Success branch schemas for different shapes\nconst successObjectsBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('objects'),\n  items: z.array(DriveFileSchema.extend({ path: z.string().optional().describe('Full folder path (if resolvePaths=true)') })).describe('Matching Drive folders'),\n  count: z.number().describe('Number of folders in this page'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\nconst successArraysBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('arrays'),\n  columns: z.array(z.string()).describe('Column names in canonical order'),\n  rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),\n  count: z.number().describe('Number of folders in this page'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\n// Output schema with auth_required support\n// Using z.union instead of discriminatedUnion since we have two success branches with different shapes\nconst outputSchema = z.union([successObjectsBranchSchema, successArraysBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  title: 'Search Folders',\n  description: 'Search Google Drive folders with flexible field selection and optional path resolution.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Type for the raw Google Drive API response\ntype DriveFolder = {\n  id?: string;\n  name?: string;\n  mimeType?: string;\n  webViewLink?: string;\n  modifiedTime?: string;\n  parents?: string[];\n  shared?: boolean;\n  starred?: boolean;\n  owners?: Array<{\n    displayName?: string;\n    emailAddress?: string;\n    kind?: string;\n    me?: boolean;\n    permissionId?: string;\n    photoLink?: string;\n  }>;\n};\n\ntype DriveFolderResponse = {\n  files?: DriveFolder[];\n  nextPageToken?: string;\n};\n\n/**\n * Resolves the full path for a folder by walking up the parent chain\n * Caches folder names to reduce redundant API calls\n */\nasync function resolveFolderPath(drive: drive_v3.Drive, folderId: string, folderCache: Map<string, string>, logger: Logger): Promise<string> {\n  if (folderId === 'root') return '/';\n\n  const pathParts: string[] = [];\n  let currentId = folderId;\n  const visited = new Set<string>();\n\n  while (currentId && currentId !== 'root') {\n    // Prevent infinite loops\n    if (visited.has(currentId)) {\n      logger.info('Circular folder reference detected', {\n        folderId: currentId,\n      });\n      break;\n    }\n    visited.add(currentId);\n\n    // Check cache first\n    if (folderCache.has(currentId)) {\n      const cachedName = folderCache.get(currentId);\n      if (cachedName) {\n        pathParts.unshift(cachedName);\n      }\n\n      // Get parent of cached folder\n      try {\n        const response = await drive.files.get({\n          fileId: currentId,\n          fields: 'parents',\n        });\n        const parents = response.data.parents as string[] | undefined;\n        currentId = (parents && parents.length > 0 ? parents[0] : '') || '';\n      } catch (_e) {\n        logger.info('Failed to get parent for cached folder', {\n          folderId: currentId,\n        });\n        break;\n      }\n    } else {\n      // Fetch folder metadata\n      try {\n        const response = await drive.files.get({\n          fileId: currentId,\n          fields: 'name,parents',\n        });\n        const folderName = response.data.name as string | undefined;\n        const parents = response.data.parents as string[] | undefined;\n\n        if (folderName) {\n          folderCache.set(currentId, folderName);\n          pathParts.unshift(folderName);\n        }\n\n        currentId = (parents && parents.length > 0 ? parents[0] : '') || '';\n      } catch (e) {\n        logger.info('Failed to resolve folder path', {\n          folderId: currentId,\n          error: e,\n        });\n        break;\n      }\n    }\n  }\n\n  return `/${pathParts.join('/')}`;\n}\n\nasync function handler({ query, resolvePaths = false, pageSize = 50, pageToken, fields, shape = 'arrays' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n\n  const requestedFields = parseFields(fields, [...DRIVE_FILE_FIELDS, 'path'] as const);\n\n  // Validate and clamp pageSize to Google Drive API limits (1-1000)\n  const validPageSize = Math.max(1, Math.min(1000, Math.floor(pageSize || 50)));\n\n  logger.info('drive.folder.search called', {\n    query,\n    resolvePaths,\n    pageSize: validPageSize,\n    pageToken: pageToken ? '[provided]' : undefined,\n    fields: fields || 'all',\n  });\n\n  try {\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n    const folderMimeType = 'application/vnd.google-apps.folder';\n    let qStr: string;\n\n    if (typeof query === 'string') {\n      // String query - treat as raw Drive query\n      qStr = `(${query}) and mimeType='${folderMimeType}' and trashed = false`;\n    } else if (query && typeof query === 'object' && 'rawDriveQuery' in query && query.rawDriveQuery) {\n      // Object with rawDriveQuery field - use it directly\n      qStr = `(${query.rawDriveQuery}) and mimeType='${folderMimeType}' and trashed = false`;\n    } else if (query) {\n      // Structured query object - convert to Drive query string\n      const { q } = toDriveQuery(query);\n      qStr = q ? `(${q}) and mimeType='${folderMimeType}' and trashed = false` : `mimeType='${folderMimeType}' and trashed = false`;\n    } else {\n      // No query - return all folders\n      qStr = `mimeType='${folderMimeType}' and trashed = false`;\n    }\n\n    const listOptions: {\n      q: string;\n      pageSize: number;\n      fields: string;\n      orderBy: string;\n      pageToken?: string;\n    } = {\n      q: qStr,\n      pageSize: validPageSize,\n      fields: 'files(id,name,mimeType,webViewLink,modifiedTime,parents,shared,starred,owners),nextPageToken',\n      orderBy: 'modifiedTime desc',\n    };\n    if (pageToken && pageToken.trim().length > 0) {\n      listOptions.pageToken = pageToken;\n    }\n\n    const response = await drive.files.list(listOptions);\n\n    const res = response.data as DriveFolderResponse;\n    const folders = Array.isArray(res?.files) ? res.files : [];\n\n    const parentIds = new Set<string>();\n    for (const f of folders) {\n      if (f?.parents && f.parents.length > 0) {\n        for (const parentId of f.parents) {\n          if (parentId && parentId !== 'root') {\n            parentIds.add(parentId);\n          }\n        }\n      }\n    }\n\n    const parentNameMap = new Map<string, string>();\n    if (parentIds.size > 0) {\n      logger.info('Fetching parent names', { count: parentIds.size });\n      const parentFetches = Array.from(parentIds).map(async (parentId) => {\n        try {\n          const parentRes = await drive.files.get({\n            fileId: parentId,\n            fields: 'id,name',\n          });\n          const parentName = (parentRes.data.name as string | undefined) || parentId;\n          parentNameMap.set(parentId, parentName);\n        } catch (e) {\n          logger.info('Failed to fetch parent name', { parentId, error: e });\n          parentNameMap.set(parentId, parentId); // Fallback to ID\n        }\n      });\n      await Promise.all(parentFetches);\n    }\n\n    // Cache for folder names to reduce API calls during path resolution\n    const folderCache = new Map<string, string>();\n\n    const items: (DriveFile & { path?: string })[] = await Promise.all(\n      folders.map(async (f: DriveFolder) => {\n        const id = f?.id ? String(f.id) : 'unknown';\n        const name = f?.name || id;\n        const result: DriveFile & { path?: string } = { id, name };\n\n        // Only include properties that have actual values\n        if (f?.mimeType) result.mimeType = f.mimeType;\n        if (f?.webViewLink) result.webViewLink = f.webViewLink;\n        if (f?.modifiedTime) result.modifiedTime = f.modifiedTime;\n\n        // Build parent objects with names\n        if (f?.parents && f.parents.length > 0) {\n          result.parents = f.parents.map((parentId) => {\n            if (parentId === 'root') {\n              return { id: 'root', name: 'My Drive' };\n            }\n            const parentName = parentNameMap.get(parentId) || parentId;\n            return { id: parentId, name: parentName };\n          });\n        }\n\n        if (f?.shared !== undefined) result.shared = f.shared;\n        if (f?.starred !== undefined) result.starred = f.starred;\n\n        if (f?.owners && f.owners.length > 0) {\n          result.owners = f.owners.map((o) => {\n            const owner: NonNullable<DriveFile['owners']>[number] = {};\n            if (o?.displayName) owner.displayName = o.displayName;\n            if (o?.emailAddress) owner.emailAddress = o.emailAddress;\n            if (o?.kind) owner.kind = o.kind;\n            if (o?.me !== undefined) owner.me = o.me;\n            if (o?.permissionId) owner.permissionId = o.permissionId;\n            if (o?.photoLink) owner.photoLink = o.photoLink;\n            return owner;\n          });\n        }\n\n        // Resolve path if requested\n        if (resolvePaths && id !== 'unknown') {\n          result.path = await resolveFolderPath(drive, id, folderCache, logger);\n        }\n\n        return result;\n      })\n    );\n\n    const filteredItems = items.map((item) => filterFields(item, requestedFields));\n\n    logger.info('drive.folder.search returning', {\n      query,\n      pageSize,\n      resultCount: filteredItems.length,\n      resolvePaths,\n      fields: fields || 'all',\n    });\n\n    const nextPageToken = res.nextPageToken && res.nextPageToken.trim().length > 0 ? res.nextPageToken : undefined;\n\n    // Build result based on shape\n    const result: Output =\n      shape === 'arrays'\n        ? {\n            type: 'success' as const,\n            shape: 'arrays' as const,\n            ...toColumnarFormat(filteredItems, requestedFields, [...DRIVE_FILE_FIELDS, 'path'] as const),\n            count: filteredItems.length,\n            ...(nextPageToken && { nextPageToken }),\n          }\n        : {\n            type: 'success' as const,\n            shape: 'objects' as const,\n            items: filteredItems,\n            count: filteredItems.length,\n            ...(nextPageToken && { nextPageToken }),\n          };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('drive.folder.search error', { error: message });\n\n    // Check if this is a Drive API validation error (invalid query, invalid pageToken, etc.)\n    // These should return empty results rather than throw\n    const isDriveValidationError = message.includes('Invalid Value') || message.includes('Invalid value') || message.includes('File not found') || message.includes('Bad Request');\n\n    if (isDriveValidationError) {\n      // Return empty result set for validation errors\n      const result: Output =\n        shape === 'arrays'\n          ? {\n              type: 'success' as const,\n              shape: 'arrays' as const,\n              columns: [],\n              rows: [],\n              count: 0,\n            }\n          : {\n              type: 'success' as const,\n              shape: 'objects' as const,\n              items: [],\n              count: 0,\n            };\n\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify(result),\n          },\n        ],\n        structuredContent: { result },\n      };\n    }\n\n    // Throw McpError for other errors\n    throw new McpError(ErrorCode.InternalError, `Error searching folders: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'folder-search' as const,\n    config,\n    handler,\n  };\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","query","DriveQuerySchema","optional","describe","fields","createFieldsSchema","availableFields","DRIVE_FILE_FIELDS","fieldDescriptions","DRIVE_FILE_FIELD_DESCRIPTIONS","path","commonPatterns","DRIVE_FILE_COMMON_PATTERNS","resourceName","resolvePaths","boolean","createPaginationSchema","defaultPageSize","maxPageSize","provider","shape","createShapeSchema","successObjectsBranchSchema","type","literal","items","array","DriveFileSchema","extend","string","count","number","nextPageToken","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","title","description","result","resolveFolderPath","drive","folderId","folderCache","logger","pathParts","currentId","visited","cachedName","response","parents","_e","folderName","e","Set","has","info","add","get","unshift","files","fileId","data","length","name","set","error","join","handler","extra","pageSize","pageToken","requestedFields","validPageSize","folderMimeType","qStr","q","listOptions","res","folders","parentIds","f","parentId","parentNameMap","parentFetches","filteredItems","message","isDriveValidationError","parseFields","Math","max","min","floor","undefined","google","version","auth","authContext","rawDriveQuery","toDriveQuery","orderBy","trim","list","Array","isArray","Map","size","from","map","parentRes","parentName","Promise","all","id","String","mimeType","webViewLink","modifiedTime","shared","starred","owners","o","owner","displayName","emailAddress","kind","me","permissionId","photoLink","item","filterFields","resultCount","toColumnarFormat","content","text","JSON","stringify","structuredContent","Error","includes","McpError","ErrorCode","InternalError","stack"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/mcp/tools/folder-search.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, toColumnarFormat } from '@mcp-z/server';\nimport { type CallToolResult, ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport type { drive_v3 } from 'googleapis';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { toDriveQuery } from '../../lib/query-builder.ts';\nimport { DRIVE_FILE_COMMON_PATTERNS, DRIVE_FILE_FIELD_DESCRIPTIONS, DRIVE_FILE_FIELDS, type DriveFile, DriveFileSchema, DriveQueryParameterSchema, parseDriveQueryParameter } from '../../schemas/index.ts';\nimport type { Logger } from '../../types.ts';\n\nconst inputSchema = z.object({\n  query: DriveQueryParameterSchema.optional().describe('Structured Drive query object or JSON string. Use rawDriveQuery for raw Drive syntax.'),\n  fields: createFieldsSchema({\n    availableFields: [...DRIVE_FILE_FIELDS, 'path'] as const,\n    fieldDescriptions: {\n      ...DRIVE_FILE_FIELD_DESCRIPTIONS,\n      path: 'Full folder path like /Work/Projects (requires resolvePaths=true)',\n    },\n    commonPatterns: DRIVE_FILE_COMMON_PATTERNS,\n    resourceName: 'Drive folder',\n  }),\n  resolvePaths: z.boolean().optional().describe('Resolve full folder paths like /Work/Projects/2024 (requires additional API calls per result)'),\n  ...createPaginationSchema({\n    defaultPageSize: 50,\n    maxPageSize: 1000,\n    provider: 'drive',\n  }).shape,\n  shape: createShapeSchema(),\n});\n\n// Success branch schemas for different shapes\nconst successObjectsBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('objects'),\n  items: z.array(DriveFileSchema.extend({ path: z.string().optional().describe('Full folder path (if resolvePaths=true)') })).describe('Matching Drive folders'),\n  count: z.number().describe('Number of folders in this page'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\nconst successArraysBranchSchema = z.object({\n  type: z.literal('success'),\n  shape: z.literal('arrays'),\n  columns: z.array(z.string()).describe('Column names in canonical order'),\n  rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),\n  count: z.number().describe('Number of folders in this page'),\n  nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\n// Output schema with auth_required support\n// Using z.union instead of discriminatedUnion since we have two success branches with different shapes\nconst outputSchema = z.union([successObjectsBranchSchema, successArraysBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  title: 'Search Folders',\n  description: 'Search Google Drive folders with flexible field selection and optional path resolution.',\n  inputSchema: inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Type for the raw Google Drive API response\ntype DriveFolder = {\n  id?: string;\n  name?: string;\n  mimeType?: string;\n  webViewLink?: string;\n  modifiedTime?: string;\n  parents?: string[];\n  shared?: boolean;\n  starred?: boolean;\n  owners?: Array<{\n    displayName?: string;\n    emailAddress?: string;\n    kind?: string;\n    me?: boolean;\n    permissionId?: string;\n    photoLink?: string;\n  }>;\n};\n\ntype DriveFolderResponse = {\n  files?: DriveFolder[];\n  nextPageToken?: string;\n};\n\n/**\n * Resolves the full path for a folder by walking up the parent chain\n * Caches folder names to reduce redundant API calls\n */\nasync function resolveFolderPath(drive: drive_v3.Drive, folderId: string, folderCache: Map<string, string>, logger: Logger): Promise<string> {\n  if (folderId === 'root') return '/';\n\n  const pathParts: string[] = [];\n  let currentId = folderId;\n  const visited = new Set<string>();\n\n  while (currentId && currentId !== 'root') {\n    // Prevent infinite loops\n    if (visited.has(currentId)) {\n      logger.info('Circular folder reference detected', {\n        folderId: currentId,\n      });\n      break;\n    }\n    visited.add(currentId);\n\n    // Check cache first\n    if (folderCache.has(currentId)) {\n      const cachedName = folderCache.get(currentId);\n      if (cachedName) {\n        pathParts.unshift(cachedName);\n      }\n\n      // Get parent of cached folder\n      try {\n        const response = await drive.files.get({\n          fileId: currentId,\n          fields: 'parents',\n        });\n        const parents = response.data.parents as string[] | undefined;\n        currentId = (parents && parents.length > 0 ? parents[0] : '') || '';\n      } catch (_e) {\n        logger.info('Failed to get parent for cached folder', {\n          folderId: currentId,\n        });\n        break;\n      }\n    } else {\n      // Fetch folder metadata\n      try {\n        const response = await drive.files.get({\n          fileId: currentId,\n          fields: 'name,parents',\n        });\n        const folderName = response.data.name as string | undefined;\n        const parents = response.data.parents as string[] | undefined;\n\n        if (folderName) {\n          folderCache.set(currentId, folderName);\n          pathParts.unshift(folderName);\n        }\n\n        currentId = (parents && parents.length > 0 ? parents[0] : '') || '';\n      } catch (e) {\n        logger.info('Failed to resolve folder path', {\n          folderId: currentId,\n          error: e,\n        });\n        break;\n      }\n    }\n  }\n\n  return `/${pathParts.join('/')}`;\n}\n\nasync function handler({ query, resolvePaths = false, pageSize = 50, pageToken, fields, shape = 'arrays' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n\n  try {\n    const parsedQuery = parseDriveQueryParameter(query);\n    const requestedFields = parseFields(fields, [...DRIVE_FILE_FIELDS, 'path'] as const);\n\n    // Validate and clamp pageSize to Google Drive API limits (1-1000)\n    const validPageSize = Math.max(1, Math.min(1000, Math.floor(pageSize || 50)));\n\n    logger.info('drive.folder.search called', {\n      query: parsedQuery,\n      resolvePaths,\n      pageSize: validPageSize,\n      pageToken: pageToken ? '[provided]' : undefined,\n      fields: fields || 'all',\n    });\n\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n    const folderMimeType = 'application/vnd.google-apps.folder';\n    let qStr: string;\n\n    if (parsedQuery && 'rawDriveQuery' in parsedQuery && parsedQuery.rawDriveQuery) {\n      // Object with rawDriveQuery field - use it directly\n      qStr = parsedQuery.rawDriveQuery;\n    } else if (parsedQuery) {\n      // Structured query object - convert to Drive query string\n      const { q } = toDriveQuery(parsedQuery);\n      qStr = q || '';\n    } else {\n      qStr = '';\n    }\n\n    qStr = qStr ? `(${qStr}) and mimeType='${folderMimeType}'` : `mimeType='${folderMimeType}'`;\n\n    const listOptions: {\n      q: string;\n      pageSize: number;\n      fields: string;\n      orderBy: string;\n      pageToken?: string;\n    } = {\n      q: qStr,\n      pageSize: validPageSize,\n      fields: 'files(id,name,mimeType,webViewLink,modifiedTime,parents,shared,starred,owners),nextPageToken',\n      orderBy: 'modifiedTime desc',\n    };\n    if (pageToken && pageToken.trim().length > 0) {\n      listOptions.pageToken = pageToken;\n    }\n\n    const response = await drive.files.list(listOptions);\n\n    const res = response.data as DriveFolderResponse;\n    const folders = Array.isArray(res?.files) ? res.files : [];\n\n    const parentIds = new Set<string>();\n    for (const f of folders) {\n      if (f?.parents && f.parents.length > 0) {\n        for (const parentId of f.parents) {\n          if (parentId && parentId !== 'root') {\n            parentIds.add(parentId);\n          }\n        }\n      }\n    }\n\n    const parentNameMap = new Map<string, string>();\n    if (parentIds.size > 0) {\n      logger.info('Fetching parent names', { count: parentIds.size });\n      const parentFetches = Array.from(parentIds).map(async (parentId) => {\n        try {\n          const parentRes = await drive.files.get({\n            fileId: parentId,\n            fields: 'id,name',\n          });\n          const parentName = (parentRes.data.name as string | undefined) || parentId;\n          parentNameMap.set(parentId, parentName);\n        } catch (e) {\n          logger.info('Failed to fetch parent name', { parentId, error: e });\n          parentNameMap.set(parentId, parentId); // Fallback to ID\n        }\n      });\n      await Promise.all(parentFetches);\n    }\n\n    // Cache for folder names to reduce API calls during path resolution\n    const folderCache = new Map<string, string>();\n\n    const items: (DriveFile & { path?: string })[] = await Promise.all(\n      folders.map(async (f: DriveFolder) => {\n        const id = f?.id ? String(f.id) : 'unknown';\n        const name = f?.name || id;\n        const result: DriveFile & { path?: string } = { id, name };\n\n        // Only include properties that have actual values\n        if (f?.mimeType) result.mimeType = f.mimeType;\n        if (f?.webViewLink) result.webViewLink = f.webViewLink;\n        if (f?.modifiedTime) result.modifiedTime = f.modifiedTime;\n\n        // Build parent objects with names\n        if (f?.parents && f.parents.length > 0) {\n          result.parents = f.parents.map((parentId) => {\n            if (parentId === 'root') {\n              return { id: 'root', name: 'My Drive' };\n            }\n            const parentName = parentNameMap.get(parentId) || parentId;\n            return { id: parentId, name: parentName };\n          });\n        }\n\n        if (f?.shared !== undefined) result.shared = f.shared;\n        if (f?.starred !== undefined) result.starred = f.starred;\n\n        if (f?.owners && f.owners.length > 0) {\n          result.owners = f.owners.map((o) => {\n            const owner: NonNullable<DriveFile['owners']>[number] = {};\n            if (o?.displayName) owner.displayName = o.displayName;\n            if (o?.emailAddress) owner.emailAddress = o.emailAddress;\n            if (o?.kind) owner.kind = o.kind;\n            if (o?.me !== undefined) owner.me = o.me;\n            if (o?.permissionId) owner.permissionId = o.permissionId;\n            if (o?.photoLink) owner.photoLink = o.photoLink;\n            return owner;\n          });\n        }\n\n        // Resolve path if requested\n        if (resolvePaths && id !== 'unknown') {\n          result.path = await resolveFolderPath(drive, id, folderCache, logger);\n        }\n\n        return result;\n      })\n    );\n\n    const filteredItems = items.map((item) => filterFields(item, requestedFields));\n\n    logger.info('drive.folder.search returning', {\n      query: parsedQuery,\n      pageSize,\n      resultCount: filteredItems.length,\n      resolvePaths,\n      fields: fields || 'all',\n    });\n\n    const nextPageToken = res.nextPageToken && res.nextPageToken.trim().length > 0 ? res.nextPageToken : undefined;\n\n    // Build result based on shape\n    const result: Output =\n      shape === 'arrays'\n        ? {\n            type: 'success' as const,\n            shape: 'arrays' as const,\n            ...toColumnarFormat(filteredItems, requestedFields, [...DRIVE_FILE_FIELDS, 'path'] as const),\n            count: filteredItems.length,\n            ...(nextPageToken && { nextPageToken }),\n          }\n        : {\n            type: 'success' as const,\n            shape: 'objects' as const,\n            items: filteredItems,\n            count: filteredItems.length,\n            ...(nextPageToken && { nextPageToken }),\n          };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('drive.folder.search error', { error: message });\n\n    // Throw McpError for all errors so callers can see Drive validation details\n    throw new McpError(ErrorCode.InternalError, `Error searching folders: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'folder-search' as const,\n    config,\n    handler,\n  };\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","query","DriveQueryParameterSchema","optional","describe","fields","createFieldsSchema","availableFields","DRIVE_FILE_FIELDS","fieldDescriptions","DRIVE_FILE_FIELD_DESCRIPTIONS","path","commonPatterns","DRIVE_FILE_COMMON_PATTERNS","resourceName","resolvePaths","boolean","createPaginationSchema","defaultPageSize","maxPageSize","provider","shape","createShapeSchema","successObjectsBranchSchema","type","literal","items","array","DriveFileSchema","extend","string","count","number","nextPageToken","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","title","description","result","resolveFolderPath","drive","folderId","folderCache","logger","pathParts","currentId","visited","cachedName","response","parents","_e","folderName","e","Set","has","info","add","get","unshift","files","fileId","data","length","name","set","error","join","handler","extra","pageSize","pageToken","parsedQuery","requestedFields","validPageSize","folderMimeType","qStr","q","listOptions","res","folders","parentIds","f","parentId","parentNameMap","parentFetches","filteredItems","message","parseDriveQueryParameter","parseFields","Math","max","min","floor","undefined","google","version","auth","authContext","rawDriveQuery","toDriveQuery","orderBy","trim","list","Array","isArray","Map","size","from","map","parentRes","parentName","Promise","all","id","String","mimeType","webViewLink","modifiedTime","shared","starred","owners","o","owner","displayName","emailAddress","kind","me","permissionId","photoLink","item","filterFields","resultCount","toColumnarFormat","content","text","JSON","stringify","structuredContent","Error","McpError","ErrorCode","InternalError","stack"],"mappings":"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"}

package/dist/cjs/schemas/drive-query-schema.d.cts

@@ -9,6 +9,30 @@ export declare const FieldOperatorSchema: z.ZodObject<{
     $none: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type FieldOperator = z.infer<typeof FieldOperatorSchema>;
+/**
+ * Drive query object schema with recursive operators and Drive features.
+ *
+ * Includes Drive-specific features:
+ * - name: Search by file/folder name (supports string or field operators)
+ * - mimeType: Filter by MIME type (e.g., "application/pdf", "application/vnd.google-apps.folder")
+ * - fullText: Search file content and metadata
+ * - parentId: Search within specific folder (supports string or field operators)
+ * - starred: Filter by starred status
+ * - shared: Filter by shared status
+ * - modifiedTime: Date range filtering with $gte and $lt
+ * - owner: Filter by owner email (supports string or field operators)
+ * - rawDriveQuery: Escape hatch for advanced Drive query syntax
+ *
+ * Logical operators:
+ * - $and: Array of conditions that must ALL match (recursive)
+ * - $or: Array of conditions where ANY must match (recursive)
+ * - $not: Nested condition that must NOT match (recursive)
+ *
+ * Note: Cast through unknown to work around Zod's lazy schema type inference issue
+ * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures
+ * TypeScript sees the strict DriveQueryObject type everywhere the schema is used.
+ */
+export declare const DriveQuerySchema: z.ZodType<DriveQueryObject>;
 export type DriveQueryObject = {
     $and?: DriveQueryObject[];
     $or?: DriveQueryObject[];
@@ -27,13 +51,15 @@ export type DriveQueryObject = {
     owner?: string | FieldOperator;
     rawDriveQuery?: string;
 };
+export type DriveQuery = DriveQueryObject;
 /**
- * Drive query schema that accepts either:
- * - A structured DriveQueryObject with typed fields
- * - A raw Drive query string for advanced use cases
+ * Drive query parameter schema that accepts either:
+ * - A structured DriveQuery object with typed fields
+ * - A JSON string representing that object
  *
  * This provides type safety for common queries while allowing
- * direct Google Drive query syntax when needed.
+ * JSON string input from MCP clients when needed.
  */
-export declare const DriveQuerySchema: z.ZodUnion<readonly [z.ZodString, z.ZodType<DriveQueryObject, unknown, z.core.$ZodTypeInternals<DriveQueryObject, unknown>>]>;
-export type DriveQuery = string | DriveQueryObject;
+export declare const DriveQueryParameterSchema: z.ZodType<DriveQuery | string>;
+export type DriveQueryParameter = z.infer<typeof DriveQueryParameterSchema>;
+export declare function parseDriveQueryParameter(input: DriveQuery | string | undefined): DriveQuery | undefined;

package/dist/cjs/schemas/drive-query-schema.d.ts

@@ -9,6 +9,30 @@ export declare const FieldOperatorSchema: z.ZodObject<{
     $none: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type FieldOperator = z.infer<typeof FieldOperatorSchema>;
+/**
+ * Drive query object schema with recursive operators and Drive features.
+ *
+ * Includes Drive-specific features:
+ * - name: Search by file/folder name (supports string or field operators)
+ * - mimeType: Filter by MIME type (e.g., "application/pdf", "application/vnd.google-apps.folder")
+ * - fullText: Search file content and metadata
+ * - parentId: Search within specific folder (supports string or field operators)
+ * - starred: Filter by starred status
+ * - shared: Filter by shared status
+ * - modifiedTime: Date range filtering with $gte and $lt
+ * - owner: Filter by owner email (supports string or field operators)
+ * - rawDriveQuery: Escape hatch for advanced Drive query syntax
+ *
+ * Logical operators:
+ * - $and: Array of conditions that must ALL match (recursive)
+ * - $or: Array of conditions where ANY must match (recursive)
+ * - $not: Nested condition that must NOT match (recursive)
+ *
+ * Note: Cast through unknown to work around Zod's lazy schema type inference issue
+ * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures
+ * TypeScript sees the strict DriveQueryObject type everywhere the schema is used.
+ */
+export declare const DriveQuerySchema: z.ZodType<DriveQueryObject>;
 export type DriveQueryObject = {
     $and?: DriveQueryObject[];
     $or?: DriveQueryObject[];
@@ -27,13 +51,15 @@ export type DriveQueryObject = {
     owner?: string | FieldOperator;
     rawDriveQuery?: string;
 };
+export type DriveQuery = DriveQueryObject;
 /**
- * Drive query schema that accepts either:
- * - A structured DriveQueryObject with typed fields
- * - A raw Drive query string for advanced use cases
+ * Drive query parameter schema that accepts either:
+ * - A structured DriveQuery object with typed fields
+ * - A JSON string representing that object
  *
  * This provides type safety for common queries while allowing
- * direct Google Drive query syntax when needed.
+ * JSON string input from MCP clients when needed.
  */
-export declare const DriveQuerySchema: z.ZodUnion<readonly [z.ZodString, z.ZodType<DriveQueryObject, unknown, z.core.$ZodTypeInternals<DriveQueryObject, unknown>>]>;
-export type DriveQuery = string | DriveQueryObject;
+export declare const DriveQueryParameterSchema: z.ZodType<DriveQuery | string>;
+export type DriveQueryParameter = z.infer<typeof DriveQueryParameterSchema>;
+export declare function parseDriveQueryParameter(input: DriveQuery | string | undefined): DriveQuery | undefined;

package/dist/cjs/schemas/drive-query-schema.js

@@ -9,47 +9,38 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    get DriveQueryParameterSchema () {
+        return DriveQueryParameterSchema;
+    },
     get DriveQuerySchema () {
         return DriveQuerySchema;
     },
     get FieldOperatorSchema () {
         return FieldOperatorSchema;
+    },
+    get parseDriveQueryParameter () {
+        return parseDriveQueryParameter;
     }
 });
 var _zod = require("zod");
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
 var FieldOperatorSchema = _zod.z.object({
     $any: _zod.z.array(_zod.z.string()).optional().describe('OR within field - matches if ANY value matches'),
     $all: _zod.z.array(_zod.z.string()).optional().describe('AND within field - matches if ALL values match'),
     $none: _zod.z.array(_zod.z.string()).optional().describe('NOT within field - matches if NONE match')
 }).strict();
-/**
- * Drive query object schema with recursive operators and Drive features.
- *
- * Includes Drive-specific features:
- * - name: Search by file/folder name (supports string or field operators)
- * - mimeType: Filter by MIME type (e.g., "application/pdf", "application/vnd.google-apps.folder")
- * - fullText: Search file content and metadata
- * - parentId: Search within specific folder (supports string or field operators)
- * - starred: Filter by starred status
- * - shared: Filter by shared status
- * - modifiedTime: Date range filtering with $gte and $lt
- * - owner: Filter by owner email (supports string or field operators)
- * - rawDriveQuery: Escape hatch for advanced Drive query syntax
- *
- * Logical operators:
- * - $and: Array of conditions that must ALL match (recursive)
- * - $or: Array of conditions where ANY must match (recursive)
- * - $not: Nested condition that must NOT match (recursive)
- *
- * Note: Cast through unknown to work around Zod's lazy schema type inference issue
- * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures
- * TypeScript sees the strict DriveQueryObject type everywhere the schema is used.
- */ var DriveQueryObjectSchema = _zod.z.lazy(function() {
+var DriveQuerySchema = _zod.z.lazy(function() {
     return _zod.z.object({
         // Logical operators for combining conditions (recursive)
-        $and: _zod.z.array(DriveQueryObjectSchema).optional().describe('Array of conditions that must ALL match'),
-        $or: _zod.z.array(DriveQueryObjectSchema).optional().describe('Array of conditions where ANY must match'),
-        $not: DriveQueryObjectSchema.optional().describe('Nested condition that must NOT match'),
+        $and: _zod.z.array(DriveQuerySchema).optional().describe('Array of conditions that must ALL match'),
+        $or: _zod.z.array(DriveQuerySchema).optional().describe('Array of conditions where ANY must match'),
+        $not: DriveQuerySchema.optional().describe('Nested condition that must NOT match'),
         // File/folder name search
         name: _zod.z.union([
             _zod.z.string().min(1),
@@ -73,7 +64,7 @@ var FieldOperatorSchema = _zod.z.object({
         // Boolean flags
         starred: _zod.z.boolean().optional().describe('Filter by starred status (true = starred, false = not starred)'),
         sharedWithMe: _zod.z.boolean().optional().describe('Filter by "shared with me" collection (true = in shared collection, false = not shared)'),
-        trashed: _zod.z.boolean().optional().describe('Filter by trash status (true = in trash, false = not in trash). Note: Drive tools automatically filter out trashed files unless explicitly requested.'),
+        trashed: _zod.z.boolean().optional().describe('Filter by trash status (true = in trash, false = not in trash).'),
         // Date range filtering
         modifiedTime: _zod.z.object({
             $gte: _zod.z.string().regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{3})?Z)?$/).optional().describe('Files modified on or after this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)'),
@@ -88,8 +79,25 @@ var FieldOperatorSchema = _zod.z.object({
         rawDriveQuery: _zod.z.string().min(1).optional().describe("Raw Google Drive query syntax for advanced use cases. Bypasses schema validation - use sparingly. Example: \"name contains 'budget' and mimeType = 'application/pdf'\"")
     }).strict();
 });
-var DriveQuerySchema = _zod.z.union([
-    _zod.z.string().min(1),
-    DriveQueryObjectSchema
+var DriveQueryParameterSchema = _zod.z.union([
+    DriveQuerySchema,
+    _zod.z.string().min(1)
 ]);
+function parseDriveQueryParameter(input) {
+    if (input === undefined) return undefined;
+    var raw = typeof input === 'string' ? safeJsonParse(input, 'rawDriveQuery') : input;
+    var validated = DriveQuerySchema.safeParse(raw);
+    if (!validated.success) {
+        throw new Error("Invalid query JSON: ".concat(validated.error.message, '. Use {"rawDriveQuery":"<query>"} for Drive syntax.'));
+    }
+    return validated.data;
+}
+function safeJsonParse(value, rawField) {
+    try {
+        return JSON.parse(value);
+    } catch (error) {
+        var message = _instanceof(error, Error) ? error.message : 'Invalid JSON';
+        throw new Error("Query must be valid JSON. ".concat(message, '. Wrap Drive syntax in {"').concat(rawField, '":"<query>"} if needed.'));
+    }
+}
 /* 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/schemas/drive-query-schema.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/schemas/drive-query-schema.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Field operator schema for Drive query fields that support multiple values\n * Supports OR ($any), AND ($all), and NOT ($none) operations\n */\nexport const FieldOperatorSchema = z\n  .object({\n    $any: z.array(z.string()).optional().describe('OR within field - matches if ANY value matches'),\n    $all: z.array(z.string()).optional().describe('AND within field - matches if ALL values match'),\n    $none: z.array(z.string()).optional().describe('NOT within field - matches if NONE match'),\n  })\n  .strict();\n\nexport type FieldOperator = z.infer<typeof FieldOperatorSchema>;\n\n/**\n * Drive query object schema with recursive operators and Drive features.\n *\n * Includes Drive-specific features:\n * - name: Search by file/folder name (supports string or field operators)\n * - mimeType: Filter by MIME type (e.g., \"application/pdf\", \"application/vnd.google-apps.folder\")\n * - fullText: Search file content and metadata\n * - parentId: Search within specific folder (supports string or field operators)\n * - starred: Filter by starred status\n * - shared: Filter by shared status\n * - modifiedTime: Date range filtering with $gte and $lt\n * - owner: Filter by owner email (supports string or field operators)\n * - rawDriveQuery: Escape hatch for advanced Drive query syntax\n *\n * Logical operators:\n * - $and: Array of conditions that must ALL match (recursive)\n * - $or: Array of conditions where ANY must match (recursive)\n * - $not: Nested condition that must NOT match (recursive)\n *\n * Note: Cast through unknown to work around Zod's lazy schema type inference issue\n * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures\n * TypeScript sees the strict DriveQueryObject type everywhere the schema is used.\n */\nconst DriveQueryObjectSchema = z.lazy(() =>\n  z\n    .object({\n      // Logical operators for combining conditions (recursive)\n      $and: z.array(DriveQueryObjectSchema).optional().describe('Array of conditions that must ALL match'),\n      $or: z.array(DriveQueryObjectSchema).optional().describe('Array of conditions where ANY must match'),\n      $not: DriveQueryObjectSchema.optional().describe('Nested condition that must NOT match'),\n\n      // File/folder name search\n      name: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search by file or folder name (partial match, case-insensitive)'),\n\n      // MIME type filtering\n      mimeType: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Filter by MIME type (e.g., \"application/pdf\", \"application/vnd.google-apps.folder\", \"image/jpeg\")'),\n\n      // Full-text search across content and metadata\n      fullText: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search file content and metadata (full-text search)'),\n\n      // Parent folder filtering\n      parentId: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search within specific folder by folder ID (use \"root\" for My Drive root)'),\n\n      // Boolean flags\n      starred: z.boolean().optional().describe('Filter by starred status (true = starred, false = not starred)'),\n      sharedWithMe: z.boolean().optional().describe('Filter by \"shared with me\" collection (true = in shared collection, false = not shared)'),\n      trashed: z.boolean().optional().describe('Filter by trash status (true = in trash, false = not in trash). Note: Drive tools automatically filter out trashed files unless explicitly requested.'),\n\n      // Date range filtering\n      modifiedTime: z\n        .object({\n          $gte: z\n            .string()\n            .regex(/^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z)?$/)\n            .optional()\n            .describe('Files modified on or after this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)'),\n          $lt: z\n            .string()\n            .regex(/^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z)?$/)\n            .optional()\n            .describe('Files modified before this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)'),\n        })\n        .optional()\n        .describe('Filter by modification date range'),\n\n      // Owner filtering\n      owner: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Filter by owner email address (partial match)'),\n\n      // Raw Drive query string - escape hatch for advanced syntax\n      rawDriveQuery: z.string().min(1).optional().describe(\"Raw Google Drive query syntax for advanced use cases. Bypasses schema validation - use sparingly. Example: \\\"name contains 'budget' and mimeType = 'application/pdf'\\\"\"),\n    })\n    .strict()\n) as unknown as z.ZodType<DriveQueryObject>;\n\nexport type DriveQueryObject = {\n  $and?: DriveQueryObject[];\n  $or?: DriveQueryObject[];\n  $not?: DriveQueryObject;\n  name?: string | FieldOperator;\n  mimeType?: string | FieldOperator;\n  fullText?: string | FieldOperator;\n  parentId?: string | FieldOperator;\n  starred?: boolean;\n  sharedWithMe?: boolean;\n  trashed?: boolean;\n  modifiedTime?: {\n    $gte?: string;\n    $lt?: string;\n  };\n  owner?: string | FieldOperator;\n  rawDriveQuery?: string;\n};\n\n/**\n * Drive query schema that accepts either:\n * - A structured DriveQueryObject with typed fields\n * - A raw Drive query string for advanced use cases\n *\n * This provides type safety for common queries while allowing\n * direct Google Drive query syntax when needed.\n */\nexport const DriveQuerySchema = z.union([z.string().min(1), DriveQueryObjectSchema]);\n\nexport type DriveQuery = string | DriveQueryObject;\n"],"names":["DriveQuerySchema","FieldOperatorSchema","z","object","$any","array","string","optional","describe","$all","$none","strict","DriveQueryObjectSchema","lazy","$and","$or","$not","name","union","min","mimeType","fullText","parentId","starred","boolean","sharedWithMe","trashed","modifiedTime","$gte","regex","$lt","owner","rawDriveQuery"],"mappings":";;;;;;;;;;;QAoIaA;eAAAA;;QA9HAC;eAAAA;;;mBANK;AAMX,IAAMA,sBAAsBC,MAAC,CACjCC,MAAM,CAAC;IACNC,MAAMF,MAAC,CAACG,KAAK,CAACH,MAAC,CAACI,MAAM,IAAIC,QAAQ,GAAGC,QAAQ,CAAC;IAC9CC,MAAMP,MAAC,CAACG,KAAK,CAACH,MAAC,CAACI,MAAM,IAAIC,QAAQ,GAAGC,QAAQ,CAAC;IAC9CE,OAAOR,MAAC,CAACG,KAAK,CAACH,MAAC,CAACI,MAAM,IAAIC,QAAQ,GAAGC,QAAQ,CAAC;AACjD,GACCG,MAAM;AAIT;;;;;;;;;;;;;;;;;;;;;;CAsBC,GACD,IAAMC,yBAAyBV,MAAC,CAACW,IAAI,CAAC;WACpCX,MAAC,CACEC,MAAM,CAAC;QACN,yDAAyD;QACzDW,MAAMZ,MAAC,CAACG,KAAK,CAACO,wBAAwBL,QAAQ,GAAGC,QAAQ,CAAC;QAC1DO,KAAKb,MAAC,CAACG,KAAK,CAACO,wBAAwBL,QAAQ,GAAGC,QAAQ,CAAC;QACzDQ,MAAMJ,uBAAuBL,QAAQ,GAAGC,QAAQ,CAAC;QAEjD,0BAA0B;QAC1BS,MAAMf,MAAC,CACJgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,sBAAsB;QACtBY,UAAUlB,MAAC,CACRgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,+CAA+C;QAC/Ca,UAAUnB,MAAC,CACRgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,0BAA0B;QAC1Bc,UAAUpB,MAAC,CACRgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,gBAAgB;QAChBe,SAASrB,MAAC,CAACsB,OAAO,GAAGjB,QAAQ,GAAGC,QAAQ,CAAC;QACzCiB,cAAcvB,MAAC,CAACsB,OAAO,GAAGjB,QAAQ,GAAGC,QAAQ,CAAC;QAC9CkB,SAASxB,MAAC,CAACsB,OAAO,GAAGjB,QAAQ,GAAGC,QAAQ,CAAC;QAEzC,uBAAuB;QACvBmB,cAAczB,MAAC,CACZC,MAAM,CAAC;YACNyB,MAAM1B,MAAC,CACJI,MAAM,GACNuB,KAAK,CAAC,uDACNtB,QAAQ,GACRC,QAAQ,CAAC;YACZsB,KAAK5B,MAAC,CACHI,MAAM,GACNuB,KAAK,CAAC,uDACNtB,QAAQ,GACRC,QAAQ,CAAC;QACd,GACCD,QAAQ,GACRC,QAAQ,CAAC;QAEZ,kBAAkB;QAClBuB,OAAO7B,MAAC,CACLgB,KAAK,CAAC;YAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;YAAIlB;SAAoB,EAC9CM,QAAQ,GACRC,QAAQ,CAAC;QAEZ,4DAA4D;QAC5DwB,eAAe9B,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC,GAAGZ,QAAQ,GAAGC,QAAQ,CAAC;IACvD,GACCG,MAAM;;AA8BJ,IAAMX,mBAAmBE,MAAC,CAACgB,KAAK,CAAC;IAAChB,MAAC,CAACI,MAAM,GAAGa,GAAG,CAAC;IAAIP;CAAuB"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/schemas/drive-query-schema.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Field operator schema for Drive query fields that support multiple values\n * Supports OR ($any), AND ($all), and NOT ($none) operations\n */\nexport const FieldOperatorSchema = z\n  .object({\n    $any: z.array(z.string()).optional().describe('OR within field - matches if ANY value matches'),\n    $all: z.array(z.string()).optional().describe('AND within field - matches if ALL values match'),\n    $none: z.array(z.string()).optional().describe('NOT within field - matches if NONE match'),\n  })\n  .strict();\n\nexport type FieldOperator = z.infer<typeof FieldOperatorSchema>;\n\n/**\n * Drive query object schema with recursive operators and Drive features.\n *\n * Includes Drive-specific features:\n * - name: Search by file/folder name (supports string or field operators)\n * - mimeType: Filter by MIME type (e.g., \"application/pdf\", \"application/vnd.google-apps.folder\")\n * - fullText: Search file content and metadata\n * - parentId: Search within specific folder (supports string or field operators)\n * - starred: Filter by starred status\n * - shared: Filter by shared status\n * - modifiedTime: Date range filtering with $gte and $lt\n * - owner: Filter by owner email (supports string or field operators)\n * - rawDriveQuery: Escape hatch for advanced Drive query syntax\n *\n * Logical operators:\n * - $and: Array of conditions that must ALL match (recursive)\n * - $or: Array of conditions where ANY must match (recursive)\n * - $not: Nested condition that must NOT match (recursive)\n *\n * Note: Cast through unknown to work around Zod's lazy schema type inference issue\n * with exactOptionalPropertyTypes. The runtime schema is correct; this cast ensures\n * TypeScript sees the strict DriveQueryObject type everywhere the schema is used.\n */\nexport const DriveQuerySchema = z.lazy(() =>\n  z\n    .object({\n      // Logical operators for combining conditions (recursive)\n      $and: z.array(DriveQuerySchema).optional().describe('Array of conditions that must ALL match'),\n      $or: z.array(DriveQuerySchema).optional().describe('Array of conditions where ANY must match'),\n      $not: DriveQuerySchema.optional().describe('Nested condition that must NOT match'),\n\n      // File/folder name search\n      name: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search by file or folder name (partial match, case-insensitive)'),\n\n      // MIME type filtering\n      mimeType: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Filter by MIME type (e.g., \"application/pdf\", \"application/vnd.google-apps.folder\", \"image/jpeg\")'),\n\n      // Full-text search across content and metadata\n      fullText: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search file content and metadata (full-text search)'),\n\n      // Parent folder filtering\n      parentId: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Search within specific folder by folder ID (use \"root\" for My Drive root)'),\n\n      // Boolean flags\n      starred: z.boolean().optional().describe('Filter by starred status (true = starred, false = not starred)'),\n      sharedWithMe: z.boolean().optional().describe('Filter by \"shared with me\" collection (true = in shared collection, false = not shared)'),\n      trashed: z.boolean().optional().describe('Filter by trash status (true = in trash, false = not in trash).'),\n\n      // Date range filtering\n      modifiedTime: z\n        .object({\n          $gte: z\n            .string()\n            .regex(/^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z)?$/)\n            .optional()\n            .describe('Files modified on or after this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)'),\n          $lt: z\n            .string()\n            .regex(/^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z)?$/)\n            .optional()\n            .describe('Files modified before this date (ISO 8601: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.sssZ)'),\n        })\n        .optional()\n        .describe('Filter by modification date range'),\n\n      // Owner filtering\n      owner: z\n        .union([z.string().min(1), FieldOperatorSchema])\n        .optional()\n        .describe('Filter by owner email address (partial match)'),\n\n      // Raw Drive query string - escape hatch for advanced syntax\n      rawDriveQuery: z.string().min(1).optional().describe(\"Raw Google Drive query syntax for advanced use cases. Bypasses schema validation - use sparingly. Example: \\\"name contains 'budget' and mimeType = 'application/pdf'\\\"\"),\n    })\n    .strict()\n) as unknown as z.ZodType<DriveQueryObject>;\n\nexport type DriveQueryObject = {\n  $and?: DriveQueryObject[];\n  $or?: DriveQueryObject[];\n  $not?: DriveQueryObject;\n  name?: string | FieldOperator;\n  mimeType?: string | FieldOperator;\n  fullText?: string | FieldOperator;\n  parentId?: string | FieldOperator;\n  starred?: boolean;\n  sharedWithMe?: boolean;\n  trashed?: boolean;\n  modifiedTime?: {\n    $gte?: string;\n    $lt?: string;\n  };\n  owner?: string | FieldOperator;\n  rawDriveQuery?: string;\n};\n\nexport type DriveQuery = DriveQueryObject;\n\n/**\n * Drive query parameter schema that accepts either:\n * - A structured DriveQuery object with typed fields\n * - A JSON string representing that object\n *\n * This provides type safety for common queries while allowing\n * JSON string input from MCP clients when needed.\n */\nexport const DriveQueryParameterSchema = z.union([DriveQuerySchema, z.string().min(1)]) as z.ZodType<DriveQuery | string>;\nexport type DriveQueryParameter = z.infer<typeof DriveQueryParameterSchema>;\n\nexport function parseDriveQueryParameter(input: DriveQuery | string | undefined): DriveQuery | undefined {\n  if (input === undefined) return undefined;\n  const raw = typeof input === 'string' ? safeJsonParse(input, 'rawDriveQuery') : input;\n  const validated = DriveQuerySchema.safeParse(raw);\n  if (!validated.success) {\n    throw new Error(`Invalid query JSON: ${validated.error.message}. Use {\"rawDriveQuery\":\"<query>\"} for Drive syntax.`);\n  }\n  return validated.data;\n}\n\nfunction safeJsonParse(value: string, rawField: 'rawDriveQuery'): unknown {\n  try {\n    return JSON.parse(value);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Invalid JSON';\n    throw new Error(`Query must be valid JSON. ${message}. Wrap Drive syntax in {\"${rawField}\":\"<query>\"} if needed.`);\n  }\n}\n"],"names":["DriveQueryParameterSchema","DriveQuerySchema","FieldOperatorSchema","parseDriveQueryParameter","z","object","$any","array","string","optional","describe","$all","$none","strict","lazy","$and","$or","$not","name","union","min","mimeType","fullText","parentId","starred","boolean","sharedWithMe","trashed","modifiedTime","$gte","regex","$lt","owner","rawDriveQuery","input","undefined","raw","safeJsonParse","validated","safeParse","success","Error","error","message","data","value","rawField","JSON","parse"],"mappings":"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"}

package/dist/esm/lib/create-store.js

@@ -1,31 +1,6 @@
 import keyvRegistry from 'keyv-registry';
-function parseDefaultTtl(uri) {
-    try {
-        const url = new URL(uri);
-        const ttlParam = url.searchParams.get('ttl');
-        const ttlSecondsParam = url.searchParams.get('ttlSeconds');
-        const ttlMs = ttlSecondsParam ? Number(ttlSecondsParam) * 1000 : ttlParam ? Number(ttlParam) : undefined;
-        url.searchParams.delete('ttl');
-        url.searchParams.delete('ttlSeconds');
-        return Number.isFinite(ttlMs) && ttlMs > 0 ? {
-            uri: url.toString(),
-            ttl: ttlMs
-        } : {
-            uri: url.toString()
-        };
-    } catch  {
-        return {
-            uri
-        };
-    }
-}
 export default async function createStore(uri) {
-    const { uri: parsedUri, ttl: defaultTtl } = parseDefaultTtl(uri);
-    const store = await keyvRegistry(parsedUri);
+    const store = await keyvRegistry(uri);
     if (!store) throw new Error(`Failed to create store for URI: ${uri}`);
-    if (defaultTtl !== undefined) {
-        const originalSet = store.set.bind(store);
-        store.set = (key, value, ttl)=>originalSet(key, value, ttl !== null && ttl !== void 0 ? ttl : defaultTtl);
-    }
     return store;
 }

package/dist/esm/lib/create-store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\nfunction parseDefaultTtl(uri: string): { uri: string; ttl?: number } {\n  try {\n    const url = new URL(uri);\n    const ttlParam = url.searchParams.get('ttl');\n    const ttlSecondsParam = url.searchParams.get('ttlSeconds');\n    const ttlMs = ttlSecondsParam ? Number(ttlSecondsParam) * 1000 : ttlParam ? Number(ttlParam) : undefined;\n    url.searchParams.delete('ttl');\n    url.searchParams.delete('ttlSeconds');\n    return Number.isFinite(ttlMs) && (ttlMs as number) > 0 ? { uri: url.toString(), ttl: ttlMs } : { uri: url.toString() };\n  } catch {\n    return { uri };\n  }\n}\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const { uri: parsedUri, ttl: defaultTtl } = parseDefaultTtl(uri);\n  const store = await keyvRegistry<T>(parsedUri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  if (defaultTtl !== undefined) {\n    const originalSet = store.set.bind(store);\n    store.set = ((key, value, ttl) => originalSet(key, value, ttl ?? defaultTtl)) as typeof store.set;\n  }\n  return store;\n}\n"],"names":["keyvRegistry","parseDefaultTtl","uri","url","URL","ttlParam","searchParams","get","ttlSecondsParam","ttlMs","Number","undefined","delete","isFinite","toString","ttl","createStore","parsedUri","defaultTtl","store","Error","originalSet","set","bind","key","value"],"mappings":"AACA,OAAOA,kBAAkB,gBAAgB;AAEzC,SAASC,gBAAgBC,GAAW;IAClC,IAAI;QACF,MAAMC,MAAM,IAAIC,IAAIF;QACpB,MAAMG,WAAWF,IAAIG,YAAY,CAACC,GAAG,CAAC;QACtC,MAAMC,kBAAkBL,IAAIG,YAAY,CAACC,GAAG,CAAC;QAC7C,MAAME,QAAQD,kBAAkBE,OAAOF,mBAAmB,OAAOH,WAAWK,OAAOL,YAAYM;QAC/FR,IAAIG,YAAY,CAACM,MAAM,CAAC;QACxBT,IAAIG,YAAY,CAACM,MAAM,CAAC;QACxB,OAAOF,OAAOG,QAAQ,CAACJ,UAAU,AAACA,QAAmB,IAAI;YAAEP,KAAKC,IAAIW,QAAQ;YAAIC,KAAKN;QAAM,IAAI;YAAEP,KAAKC,IAAIW,QAAQ;QAAG;IACvH,EAAE,OAAM;QACN,OAAO;YAAEZ;QAAI;IACf;AACF;AAEA,eAAe,eAAec,YAAed,GAAW;IACtD,MAAM,EAAEA,KAAKe,SAAS,EAAEF,KAAKG,UAAU,EAAE,GAAGjB,gBAAgBC;IAC5D,MAAMiB,QAAQ,MAAMnB,aAAgBiB;IACpC,IAAI,CAACE,OAAO,MAAM,IAAIC,MAAM,CAAC,gCAAgC,EAAElB,KAAK;IACpE,IAAIgB,eAAeP,WAAW;QAC5B,MAAMU,cAAcF,MAAMG,GAAG,CAACC,IAAI,CAACJ;QACnCA,MAAMG,GAAG,GAAI,CAACE,KAAKC,OAAOV,MAAQM,YAAYG,KAAKC,OAAOV,gBAAAA,iBAAAA,MAAOG;IACnE;IACA,OAAOC;AACT"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-drive/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["keyvRegistry","createStore","uri","store","Error"],"mappings":"AACA,OAAOA,kBAAkB,gBAAgB;AAEzC,eAAe,eAAeC,YAAeC,GAAW;IACtD,MAAMC,QAAQ,MAAMH,aAAgBE;IACpC,IAAI,CAACC,OAAO,MAAM,IAAIC,MAAM,CAAC,gCAAgC,EAAEF,KAAK;IACpE,OAAOC;AACT"}

package/dist/esm/lib/query-builder.d.ts

@@ -36,9 +36,9 @@ interface FiltersObject {
  * - sharedWithMe = true - Filter by shared status
  * - modifiedTime >= 'date' - Date filtering
  * - 'email' in owners - Filter by owner
- * - trashed = false - Exclude trashed files (always added)
+ * - trashed = true/false - Filter by trash status
  */
-export declare function toDriveQuery(query: DriveQuery): {
+export declare function toDriveQuery(query: DriveQuery | string): {
     q: string;
     filters: FiltersObject;
 };

package/dist/esm/lib/query-builder.js

@@ -14,7 +14,7 @@
  * - sharedWithMe = true - Filter by shared status
  * - modifiedTime >= 'date' - Date filtering
  * - 'email' in owners - Filter by owner
- * - trashed = false - Exclude trashed files (always added)
+ * - trashed = true/false - Filter by trash status
  */ export function toDriveQuery(query) {
     // Handle string queries - return as raw query with empty filters
     if (typeof query === 'string') {