@ayush24k/telezipper 1.1.0 → 1.3.0

package/README.md

@@ -2,11 +2,27 @@
 
 Split folders into multiple 2GB zip files with optional Telegram upload.
 
+[![npm version](https://img.shields.io/npm/v/@ayush24k/telezipper.svg)](https://www.npmjs.com/package/@ayush24k/telezipper)
+[![npm downloads](https://img.shields.io/npm/dm/@ayush24k/telezipper.svg)](https://www.npmjs.com/package/@ayush24k/telezipper)
+
 ## Installation
 
-Install globally using npm link:
+### Option 1: Install from npm (Recommended)
+
+Install globally from npm:
+
+```bash
+npm install -g @ayush24k/telezipper
+```
+
+Now you can use `telezipper` from anywhere on your system!
+
+### Option 2: Install from source
+
+Clone the repository and link locally:
 
 ```bash
+git clone https://github.com/ayush24k/teleZipper.git
 cd /path/to/telezipper
 npm install
 npm run build
@@ -28,6 +44,17 @@ Example:
 telezipper ./my-folder -o ./output
 ```
 
+### With Password Protection
+
+```bash
+telezipper <source> -p <password> -o <output-directory>
+```
+
+Example:
+```bash
+telezipper ./my-folder -p MySecurePassword123 -o ./output
+```
+
 ### With Telegram Upload
 
 You can provide Telegram credentials in two ways:
@@ -61,6 +88,7 @@ telezipper ./my-folder --telegram
 
 - `<source>` - File or folder to zip (required)
 - `-o, --output <dir>` - Output directory (default: "output")
+- `-p, --password <password>` - Password to protect zip files (optional)
 - `--telegram` - Upload zip files to Telegram
 - `--bot-token <token>` - Telegram bot token (required if using --telegram without env vars)
 - `--chat-id <id>` - Telegram chat ID (required if using --telegram without env vars)
@@ -93,6 +121,16 @@ export TELEGRAM_CHAT_ID=987654321
 telezipper ./my-project --telegram
 ```
 
+### Zip with password protection
+```bash
+telezipper ./my-project -p MySecurePassword123
+```
+
+### Zip with password and upload to Telegram
+```bash
+telezipper ./my-project -p MySecurePassword123 --telegram --bot-token 123456:ABC-DEF --chat-id 987654321
+```
+
 ## How to Get Telegram Credentials
 
 1. **Bot Token**: Create a bot using [@BotFather](https://t.me/botfather) on Telegram
@@ -105,6 +143,7 @@ telezipper ./my-project --telegram
 
 - ✅ Automatically splits large folders into 2GB chunks
 - ✅ Creates zip files with maximum compression
+- ✅ Password protection with AES-256 encryption
 - ✅ Optional Telegram upload with progress bars
 - ✅ Works from any directory on your system
 - ✅ Flexible credential management (CLI args or env vars)

package/dist/bin/zipper.js

@@ -14,6 +14,7 @@ const program = new commander_1.Command();
 program
     .argument("<source>", "File or folder to zip")
     .option("-o, --output <dir>", "Output directory", "output")
+    .option("-p, --password <password>", "Password to protect zip files")
     .option("--telegram", "Upload zip files to Telegram")
     .option("--bot-token <token>", "Telegram bot token (required if using --telegram)")
     .option("--chat-id <id>", "Telegram chat ID (required if using --telegram)")
@@ -24,11 +25,12 @@ program
     const useTelegram = program.opts().telegram || false;
     const botToken = program.opts().botToken;
     const chatId = program.opts().chatId;
-    console.log(`🕸️ Crawling files in ${source}...`);
+    const password = program.opts().password;
+    console.log(`\n🕸️  Crawling files in ${source}...`);
     const files = await (0, crawler_1.crawl)(source);
-    console.log(`📂 Found ${files.length} files. Chunking...`);
+    console.log(`📂 Found ${files.length} file${files.length !== 1 ? 's' : ''}`);
     const chunks = (0, chunking_1.chunkFiles)(files);
-    console.log(`📦 Created ${chunks.length} chunks. Zipping...`);
-    await (0, zipper_1.zipChunks)(chunks, outputDir, useTelegram, botToken, chatId);
-    console.log("🎉 process done!");
+    console.log(`📦 Created ${chunks.length} chunk${chunks.length !== 1 ? 's' : ''} (max 2GB each)${password ? ' 🔒 Password protected' : ''}\n`);
+    await (0, zipper_1.zipChunks)(chunks, outputDir, useTelegram, botToken, chatId, password);
+    console.log(`\n🎉 All done! ${useTelegram ? 'Files uploaded to Telegram.' : `Zips saved to ${outputDir}`}`);
 })();

package/dist/src/telegramUploader.js

@@ -6,17 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadToTelegram = uploadToTelegram;
 const node_telegram_bot_api_1 = __importDefault(require("node-telegram-bot-api"));
 const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 const cli_progress_1 = __importDefault(require("cli-progress"));
+// Suppress the polling deprecation warning
+process.env.NTBA_FIX_350 = "1";
 // upload a zip file to telegram with progress bar
 async function uploadToTelegram(zipPath, botToken, chatId) {
     const bot_token = botToken || process.env.TELEGRAM_BOT_TOKEN || "";
     const chat_id = chatId || process.env.TELEGRAM_CHAT_ID || "";
     if (!bot_token || !chat_id) {
-        throw new Error("Telegram credentials are missing. Please provide --bot-token and --chat-id or set TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID environment variables.");
+        throw new Error("❌ Telegram credentials are missing. Please provide --bot-token and --chat-id or set TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID environment variables.");
     }
     const bot = new node_telegram_bot_api_1.default(bot_token, { polling: false });
     const totalSize = fs_1.default.statSync(zipPath).size;
-    console.log(`📤 Uploading ${zipPath}`);
+    const fileName = path_1.default.basename(zipPath);
+    const fileSizeMB = (totalSize / (1024 * 1024)).toFixed(2);
+    console.log(`\n📤 Uploading ${fileName} (${fileSizeMB} MB)`);
     const progressBar = new cli_progress_1.default.SingleBar({
         format: "Uploading [{bar}] {percentage}% | {value}/{total} Bytes",
     }, cli_progress_1.default.Presets.shades_classic);
@@ -29,5 +34,5 @@ async function uploadToTelegram(zipPath, botToken, chatId) {
     });
     await bot.sendDocument(chat_id, stream);
     progressBar.stop();
-    console.log("✅ Upload complete");
+    console.log(`✅ ${fileName} uploaded successfully`);
 }

package/dist/src/zipper.js

@@ -8,21 +8,32 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const cli_progress_1 = __importDefault(require("cli-progress"));
 const archiver_1 = __importDefault(require("archiver"));
+// @ts-ignore - archiver-zip-encrypted doesn't have types
+const archiver_zip_encrypted_1 = __importDefault(require("archiver-zip-encrypted"));
 const telegramUploader_1 = require("./telegramUploader");
-async function zipChunks(chunks, outputDir, useTelegram, botToken, chatId) {
+// Register the encrypted format
+archiver_1.default.registerFormat('zip-encrypted', archiver_zip_encrypted_1.default);
+async function zipChunks(chunks, outputDir, useTelegram, botToken, chatId, password) {
     fs_1.default.mkdirSync(outputDir, { recursive: true });
     const uploadQueue = [];
     for (let i = 0; i < chunks.length; i++) {
         const zipName = `chunk_${i + 1}.zip`;
         const zipPath = path_1.default.join(outputDir, zipName);
-        console.log(`📦 Zipping ${zipName}`);
+        console.log(`📦 Zipping ${zipName}...`);
         const progressBar = new cli_progress_1.default.SingleBar({
             format: `Zipping ${zipName} [{bar}] {percentage}% | {value}/{total} files`,
         }, cli_progress_1.default.Presets.shades_classic);
         progressBar.start(chunks[i].length, 0);
         await new Promise((resolve, reject) => {
             const output = fs_1.default.createWriteStream(zipPath);
-            const archive = (0, archiver_1.default)("zip", { zlib: { level: 9 } });
+            // Use encrypted archiver if password is provided
+            const archive = password
+                ? (0, archiver_1.default)("zip-encrypted", {
+                    zlib: { level: 9 },
+                    encryptionMethod: 'aes256',
+                    password: password
+                })
+                : (0, archiver_1.default)("zip", { zlib: { level: 9 } });
             archive.pipe(output);
             output.on("close", () => {
                 progressBar.stop();
@@ -41,7 +52,7 @@ async function zipChunks(chunks, outputDir, useTelegram, botToken, chatId) {
         });
     }
     if (useTelegram) {
-        console.log("🚀 Uploading all zips to Telegram...");
+        console.log("\n🚀 Uploading all files to Telegram...");
         await Promise.all(uploadQueue);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ayush24k/telezipper",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Split folders into multiple 2GB zip files with optional Telegram upload made for personal use.",
   "files": [
     "dist"
@@ -12,11 +12,26 @@
     "test": "echo \"Error: no test specified\" && exit 1",
     "build": "tsc"
   },
-  "keywords": [],
-  "author": "",
+  "keywords": [
+    "telegram",
+    "zip",
+    "file-upload",
+    "chunking",
+    "cli",
+    "telegram-bot",
+    "file-compression",
+    "archiver"
+  ],
+  "author": "ayush24k",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ayush24k/teleZipper.git"
+  },
+  "homepage": "https://github.com/ayush24k/teleZipper#readme",
   "license": "ISC",
   "dependencies": {
     "archiver": "^7.0.1",
+    "archiver-zip-encrypted": "^2.0.0",
     "cli-progress": "^3.12.0",
     "commander": "^14.0.2",
     "dotenv": "^17.2.3",