gdrivekit 1.0.0 → 1.0.2

package/README.md

@@ -1,15 +1,185 @@
-# googledrive
+## 🧩 gdrivekit
 
-To install dependencies:
+> **Google Drive file automation in just a few lines of code.**
+> Perform uploads, downloads, folder management, and advanced search operations effortlessly using TypeScript or Node.js.
+
+---
+
+### 🚀 Features
+
+* 📂 Upload, download, and manage Google Drive files
+* 🗂️ Create and organize folders
+* 🔍 Powerful search and filter utilities
+* ⚙️ Batch file operations
+* ⚡ Minimal setup, lightweight, and easy to use
+* 💡 Works with Node.js and Bun
+
+---
+
+### 📦 Installation
 
 ```bash
-bun install
+npm install gdrivekit
 ```
 
-To run:
+or
 
 ```bash
-bun run index.ts
+bun add gdrivekit
+```
+
+---
+
+### 💻 Example Usage
+
+### ⚙️ One-Time Setup (Token Generation)
+
+Before you can use Google Drive operations, you must generate **access and refresh tokens**.
+This only needs to be done **once** — the tokens will be stored locally and reused automatically.
+
+```ts
+import { generateCredentialsAndTokens } from "gdrivekit";
+
+await generateCredentialsAndTokens({
+  clientid: process.env.GOOGLE_CLIENT_ID!,
+  projectid: process.env.GOOGLE_PROJECT_ID!,
+  clientsecret: process.env.GOOGLE_CLIENT_SECRET!,
+  redirecturis: ["http://localhost:3000/oauth2callback"],
+});
+```
+
+✅ **Run this code once** to authenticate your app and save tokens (usually in `tokens.json`).
+After that, you **don’t need to call it again** unless you delete your tokens or change your Google credentials.
+
+---
+
+# 🔄 Initializing the Drive Service
+
+Once tokens are generated, you can initialize the Google Drive service and perform file operations:
+
+```ts
+import { operations } from "gdrivekit";
+import { initDriveService } from "./drivers/services";
+
+async function main() {
+  initDriveService();
+
+  // Example: Search files by name
+  const files = await operations.searchByName("test");
+  console.log(files.data?.files);
+}
+
+main();
+```
+
+---
+
+## 🧠 Available Operations
+
+### 📁 **File Operations**
+
+| Method             | Description                               |
+| ------------------ | ----------------------------------------- |
+| `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            |
+| `moveFile()`       | Move file to another folder using file ID |
+| `moveFileByName()` | Move file by its name                     |
+| `copyFile()`       | Make a copy of a file in Drive            |
+
+---
+
+### 🗂️ **Folder Operations**
+
+| Method                | Description                             |
+| --------------------- | --------------------------------------- |
+| `createFolder()`      | Create a new folder                     |
+| `deleteFolder()`      | Delete an existing folder               |
+| `listAllFolders()`    | List all folders in Drive               |
+| `listFilesInFolder()` | List all files within a specific folder |
+
+---
+
+### 🔍 **Search Operations**
+
+| Method                  | Description                            |
+| ----------------------- | -------------------------------------- |
+| `searchByName()`        | Search files containing a name         |
+| `searchByExactName()`   | Search files matching exact name       |
+| `searchByType()`        | Search by file type (e.g., PDF, image) |
+| `searchModifiedAfter()` | Find files modified after a given date |
+| `searchStarredFiles()`  | List all starred files                 |
+| `searchSharedFiles()`   | Find files shared with you             |
+| `searchByContent()`     | Search within file content             |
+
+---
+
+### 📋 **List Operations**
+
+| Method              | Description                           |
+| ------------------- | ------------------------------------- |
+| `listFiles()`       | List all files in Drive               |
+| `listRecentFiles()` | List recently modified or added files |
+| `listPDFs()`        | List all PDF files                    |
+| `listImages()`      | List all image files                  |
+
+---
+
+### 🧩 **Batch Operations**
+
+| Method                    | Description                          |
+| ------------------------- | ------------------------------------ |
+| `uploadMultipleFiles()`   | Upload multiple files at once        |
+| `deleteMultipleFiles()`   | Delete multiple files simultaneously |
+| `downloadMultipleFiles()` | Download multiple files in parallel  |
+
+---
+
+### 🧰 **Utility Operations**
+
+| Method                | Description                 |
+| --------------------- | --------------------------- |
+| `fileExists()`        | Check if a file exists      |
+| `getFolderIdByName()` | Fetch folder ID by its name |
+| `getFileIdByName()`   | Fetch file ID by its name   |
+
+---
+
+### ⚡ Example: Upload a File
+
+```ts
+await operations.uploadFile({
+  name: "report.pdf",
+  path: "./files/report.pdf",
+  mimeType: "application/pdf",
+});
+```
+
+---
+
+### ⚡ Example: Search and Download
+
+```ts
+const files = await operations.searchByName("invoice");
+if (files?.data?.files?.length) {
+  await operations.downloadFile(files.data.files[0].id, "./downloads/invoice.pdf");
+}
 ```
 
-This project was created using `bun init` in bun v1.3.0. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+---
+
+### 🧑‍💻 Author
+
+**Vikash Khati**
+[GitHub](https://github.com/vikashkhati007) • [NPM](https://www.npmjs.com/~vikashkhati007)
+
+---
+
+### ⚖️ License
+
+**MIT License** — free to use, modify, and distribute.
+
+---

package/dist/index.js

@@ -778992,10 +778992,8 @@ async function generateCredentialsAndTokens({
   clientid,
   projectid,
   clientsecret,
-  redirecturis = [
-    "http://localhost:3000/oauth2callback",
-    "http://localhost:3000/oauth2/callback"
-  ]
+  redirecturis,
+  javascript_origin
 }) {
   if (!fs2.existsSync(CREDENTIALS_PATH)) {
     const baseCredentials = {
@@ -779006,8 +779004,8 @@ async function generateCredentialsAndTokens({
         token_uri: "https://oauth2.googleapis.com/token",
         auth_provider_x509_cert_url: "https://www.googleapis.com/oauth2/v1/certs",
         client_secret: clientsecret,
-        redirect_uris: redirecturis,
-        javascript_origins: ["http://localhost:3000"]
+        redirect_uris: redirecturis || ["http://localhost:3000/oauth2callback", "http://localhost:3000/oauth2/callback"],
+        javascript_origins: javascript_origin || ["http://localhost:3000"]
       }
     };
     fs2.writeFileSync(CREDENTIALS_PATH, JSON.stringify(baseCredentials, null, 2));

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "gdrivekit",
-  "version": "1.0.0",
-  "description": "A lightweight Bun + TypeScript package for Google Drive OAuth2 authentication and file operations.",
+  "version": "1.0.2",
+  "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": "index.ts",
-  "types": "index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "scripts": {
     "dev": "bun run index.ts",
     "build": "bun build ./index.ts --outdir dist --target node",
@@ -12,13 +12,27 @@
   },
   "keywords": [
     "google-drive",
-    "bun",
-    "typescript",
+    "google drive",
+    "googledrive",
+    "gdrive",
+    "drive-api",
     "googleapis",
-    "oauth2"
+    "google drive api",
+    "google drive oauth2",
+    "google drive upload",
+    "google drive automation",
+    "gdrivekit"
   ],
   "author": "Vikash Khati",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vikashkhati007/gdrivekit"
+  },
+  "homepage": "https://www.npmjs.com/package/gdrivekit",
+  "bugs": {
+    "url": "https://github.com/vikashkhati007/gdrivekit/issues"
+  },
   "dependencies": {
     "googleapis": "^164.1.0"
   },

package/index.ts

@@ -1,3 +0,0 @@
-import * as operations from "./operations";
-import { generateCredentialsAndTokens } from "./auth";
-export { generateCredentialsAndTokens, operations };