gdrivekit 1.0.7 → 1.0.9

package/README.md

@@ -80,14 +80,13 @@ main();
 
 | Method             | Description                               |
 | ------------------ | ----------------------------------------- |
+| `readFileData()`   | Read file content                         |
 | `uploadFile()`     | Upload a new file to Google Drive         |
 | `downloadFile()`   | Download a file from Drive                |
 | `deleteFile()`     | Permanently delete a file                 |
 | `renameFile()`     | Rename an existing file                   |
 | `updateFile()`     | Update file metadata or content           |
 | `getFileInfo()`    | Get details of a specific file            |
-| `getImageMetadata()` | Get image metadata (EXIF data, dimensions, etc.) |
-| `getVideoMetadata()` | Get video metadata (duration, dimensions, etc.) |
 | `getCompleteFileInfo()` | Get complete file metadata including all fields |
 | `moveFile()`       | Move file to another folder using file ID |
 | `moveFileByName()` | Move file by its name                     |
@@ -107,7 +106,7 @@ main();
 | --------------------- | --------------------------------------- |
 | `createFolder()`      | Create a new folder                     |
 | `deleteFolder()`      | Delete an existing folder               |
-| `listFoldersByName()` | List all folders with a specific name |
+| `listFoldersByName()` | List all folders with a specific name   |
 | `listAllFolders()`    | List all folders in Drive               |
 | `listFilesInFolder()` | List all files within a specific folder |
 | `listFoldersInFolder()` | List all folders within a specific folder |
@@ -144,8 +143,6 @@ main();
 | `listPresentations()`| List all presentation files           |
 | `listDocs()`        | List all docs files                   |
 
-
-
 ---
 
 ### 🧩 **Batch Operations**
@@ -162,13 +159,16 @@ main();
 
 | Method                | Description                 |
 | --------------------- | --------------------------- |
+| `shareFile()`        | Share a file with a user      |
 | `fileExists()`        | Check if a file exists      |
+| `getStorageQuota()`   | Get storage quota information |
 | `getFolderIdByName()` | Fetch folder ID by its name |
 | `getFileIdByName()`   | Fetch file ID by its name   |
 
 ---
 
 ### ❴❵ **Json Operation**
+
 | Method                  | Description                               |
 | ----------------------- | ----------------------------------------- |
 | `readJsonFileData()`    | Read JSON file content                    |
@@ -176,6 +176,30 @@ main();
 | `updateJsonFieldAndValues()`     | Update an existing field in a JSON file   |
 | `deleteJsonFieldAndKeys()`     | Delete a field from a JSON file           |
 
+---
+
+### ⚞ **Conversion Operation**
+
+| Method                  | Description                                               |
+| ----------------------- | --------------------------------------------------------- |
+| `convertTextToDocs()`   | Convert a text file (`.txt`) to Google Docs format        |
+| `convertDocsToPdf()`    | Convert a Google Docs file to PDF                         |
+| `convertDocsToWord()`   | Convert a Google Docs file to Microsoft Word (`.docx`)    |
+| `convertDocsToText()`   | Convert a Google Docs file to plain text (`.txt`)         |
+| `convertCsvToSheet()`   | Convert a CSV file to Google Sheets                       |
+| `convertExcelToSheet()` | Convert an Excel file (`.xlsx`) to Google Sheets          |
+| `convertSheetToCsv()`   | Convert a Google Sheet to CSV                             |
+| `convertSheetToPdf()`   | Convert a Google Sheet to PDF                             |
+| `convertPptToSlides()`  | Convert a PowerPoint file (`.pptx`) to Google Slides      |
+| `convertSlidesToPpt()`  | Convert a Google Slides file to PowerPoint (`.pptx`)      |
+| `convertSlidesToPdf()`  | Convert a Google Slides file to PDF                       |
+| `convertPdfToDocs()`    | Convert a PDF file to Google Docs (with OCR if supported) |
+| `convertDrawingToPng()` | Convert a Google Drawing to PNG image                     |
+| `convertDrawingToPdf()` | Convert a Google Drawing to PDF                           |
+
+
+---
+
 ### ⚡ Example: Upload a File
 
 ```ts

package/dist/index.js

@@ -778706,6 +778706,7 @@ __export(exports_operations, {
   uploadFile: () => uploadFile,
   updateJsonFieldAndValues: () => updateJsonFieldAndValues,
   updateFile: () => updateFile,
+  shareFile: () => shareFile,
   searchStarredFiles: () => searchStarredFiles,
   searchSharedFiles: () => searchSharedFiles,
   searchModifiedAfter: () => searchModifiedAfter,
@@ -778734,6 +778735,7 @@ __export(exports_operations, {
   listArchives: () => listArchives,
   listAllFolders: () => listAllFolders,
   getVideoMetadata: () => getVideoMetadata,
+  getStorageQuota: () => getStorageQuota,
   getImageMetadata: () => getImageMetadata,
   getFolderIdByName: () => getFolderIdByName,
   getFileInfo: () => getFileInfo,
@@ -778749,12 +778751,23 @@ __export(exports_operations, {
   deleteFile: () => deleteFile,
   createFolder: () => createFolder,
   copyFile: () => copyFile,
+  convertTextToDocs: () => convertTextToDocs,
+  convertSlidesToPpt: () => convertSlidesToPpt,
+  convertSlidesToPdf: () => convertSlidesToPdf,
+  convertSheetToPdf: () => convertSheetToPdf,
+  convertSheetToCsv: () => convertSheetToCsv,
+  convertPptToSlides: () => convertPptToSlides,
+  convertPdfToDocs: () => convertPdfToDocs,
+  convertExcelToSheet: () => convertExcelToSheet,
+  convertDrawingToPng: () => convertDrawingToPng,
+  convertDrawingToPdf: () => convertDrawingToPdf,
+  convertDocsToWord: () => convertDocsToWord,
+  convertDocsToText: () => convertDocsToText,
+  convertDocsToPdf: () => convertDocsToPdf,
+  convertCsvToSheet: () => convertCsvToSheet,
   addJsonKeyValue: () => addJsonKeyValue
 });
 
-// drivers/services.ts
-var driveService;
-
 // types/index.ts
 var MIME_TYPES = {
   FOLDER: "application/vnd.google-apps.folder",
@@ -778784,7 +778797,35 @@ var MIME_TYPES = {
   RAR: "application/x-rar-compressed"
 };
 
+// drivers/services.ts
+var driveService;
+
 // operations.ts
+async function searchByNameHelper(name, type, searchType = "exact") {
+  let query = searchType === "exact" ? `name='${name}'` : `name contains '${name}'`;
+  if (type === "folder") {
+    query += ` and mimeType='${MIME_TYPES.FOLDER}'`;
+  } else if (type === "file") {
+    query += ` and mimeType!='${MIME_TYPES.FOLDER}'`;
+  }
+  query += " and trashed=false";
+  return await driveService.listFiles({ query });
+}
+async function getIdByNameHelper(name, type) {
+  const result = await searchByNameHelper(name, type, "exact");
+  if (result.success && result.data?.files.length) {
+    const item = result.data.files[0];
+    return {
+      success: true,
+      id: item.id,
+      item
+    };
+  }
+  return {
+    success: false,
+    error: `${type ? type.charAt(0).toUpperCase() + type.slice(1) : "Item"} not found`
+  };
+}
 async function readFileData(fileId) {
   const response = await driveService.readFileData(fileId);
   if (response.success && response.data) {
@@ -778834,11 +778875,13 @@ async function moveFile(fileId, newFolderId) {
   });
 }
 async function moveFileByName(fileName, folderName) {
-  const fileResult = await getFileIdByName(fileName);
+  const [fileResult, folderResult] = await Promise.all([
+    getFileIdByName(fileName),
+    getFolderIdByName(folderName)
+  ]);
   if (!fileResult.success || !fileResult.fileId) {
     return { success: false, error: "File not found" };
   }
-  const folderResult = await getFolderIdByName(folderName);
   if (!folderResult.success || !folderResult.folderId) {
     return { success: false, error: "Destination folder not found" };
   }
@@ -778978,9 +779021,7 @@ async function deleteFolder(folderId) {
   return await driveService.deleteFile(folderId);
 }
 async function listFoldersByName(folderName) {
-  return await driveService.listFiles({
-    query: `name='${folderName}' and mimeType='${MIME_TYPES.FOLDER}' and trashed=false`
-  });
+  return await searchByNameHelper(folderName, "folder", "exact");
 }
 async function listAllFolders() {
   return await driveService.listFiles({
@@ -778998,14 +779039,10 @@ async function listFilesInFolder(folderId) {
   });
 }
 async function searchByName(fileName) {
-  return await driveService.listFiles({
-    query: `name contains '${fileName}' and trashed=false`
-  });
+  return await searchByNameHelper(fileName, "file", "contains");
 }
 async function searchByExactName(fileName) {
-  return await driveService.listFiles({
-    query: `name='${fileName}' and trashed=false`
-  });
+  return await searchByNameHelper(fileName, "file", "exact");
 }
 async function searchByType(type) {
   const mimeTypes = {
@@ -779131,30 +779168,117 @@ async function fileExists(fileName) {
   const result = await searchByExactName(fileName);
   return result.success && (result.data?.files.length || 0) > 0;
 }
+async function getStorageQuota() {
+  return await driveService.getStorageQuota();
+}
+async function shareFile(fileId, emailAddress, role = "reader") {
+  return await driveService.shareFile(fileId, emailAddress, role);
+}
 async function getFolderIdByName(folderName) {
-  const result = await driveService.listFiles({
-    query: `name='${folderName}' and mimeType='${MIME_TYPES.FOLDER}' and trashed=false`,
-    pageSize: 1
-  });
-  if (result.success && result.data?.files.length) {
+  const result = await getIdByNameHelper(folderName, "folder");
+  if (result.success) {
     return {
       success: true,
-      folderId: result.data.files[0]?.id || "",
-      folder: result.data.files[0]
+      folderId: result.id || "",
+      folder: result.item
     };
   }
-  return { success: false, error: "Folder not found" };
+  return { success: false, error: result.error };
 }
 async function getFileIdByName(fileName) {
-  const result = await searchByExactName(fileName);
-  if (result.success && result.data?.files.length) {
+  const result = await getIdByNameHelper(fileName, "file");
+  if (result.success) {
     return {
       success: true,
-      fileId: result.data.files[0]?.id || "",
-      file: result.data.files[0]
+      fileId: result.id || "",
+      file: result.item
     };
   }
-  return { success: false, error: "File not found" };
+  return { success: false, error: result.error };
+}
+async function convertTextToDocs(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.DOCUMENT);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Text → Google Docs");
+}
+async function convertDocsToPdf(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.PDF);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Docs → PDF");
+}
+async function convertDocsToWord(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.WORD);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Docs → Word");
+}
+async function convertDocsToText(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.TEXT);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Docs → Text");
+}
+async function convertCsvToSheet(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.SPREADSHEET);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert CSV → Google Sheet");
+}
+async function convertExcelToSheet(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.SPREADSHEET);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Excel → Google Sheet");
+}
+async function convertSheetToCsv(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.CSV);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Sheet → CSV");
+}
+async function convertSheetToPdf(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.PDF);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Sheet → PDF");
+}
+async function convertPptToSlides(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.PRESENTATION);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert PPT → Google Slides");
+}
+async function convertSlidesToPpt(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.POWERPOINT);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Slides → PPTX");
+}
+async function convertSlidesToPdf(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.PDF);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Slides → PDF");
+}
+async function convertPdfToDocs(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.DOCUMENT);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert PDF → Google Docs");
+}
+async function convertDrawingToPng(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.PNG);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Drawing → PNG");
+}
+async function convertDrawingToPdf(fileId) {
+  const response = await driveService.ConversionFunction(fileId, MIME_TYPES.PDF);
+  if (response.success && response.data)
+    return response.data;
+  throw new Error(response.error || "Failed to convert Drawing → PDF");
 }
 var driveOperations = {
   readFileData,
@@ -779191,12 +779315,35 @@ var driveOperations = {
   listRecentFiles,
   listPDFs,
   listImages,
+  listVideos,
+  listAudios,
+  listArchives,
+  listJSONs,
+  listSheets,
+  listPresentations,
+  listDocs,
   uploadMultipleFiles,
   deleteMultipleFiles,
   downloadMultipleFiles,
+  shareFile,
   fileExists,
+  getStorageQuota,
   getFolderIdByName,
-  getFileIdByName
+  getFileIdByName,
+  convertTextToDocs,
+  convertDocsToPdf,
+  convertDocsToWord,
+  convertDocsToText,
+  convertCsvToSheet,
+  convertExcelToSheet,
+  convertSheetToCsv,
+  convertSheetToPdf,
+  convertPptToSlides,
+  convertSlidesToPpt,
+  convertSlidesToPdf,
+  convertPdfToDocs,
+  convertDrawingToPng,
+  convertDrawingToPdf
 };
 
 // auth.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdrivekit",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "A lightweight Google Drive toolkit for File Management. Handle Google Drive operations easily — upload, download, and other file operations in a few lines of code.",
   "type": "module",
   "main": "dist/index.js",