@ayush24k/telezipper 1.1.0

package/README.md

@@ -0,0 +1,110 @@
+# TeleZipper
+
+Split folders into multiple 2GB zip files with optional Telegram upload.
+
+## Installation
+
+Install globally using npm link:
+
+```bash
+cd /path/to/telezipper
+npm install
+npm run build
+npm link
+```
+
+Now you can use `telezipper` from anywhere on your system!
+
+## Usage
+
+### Basic Usage (Zip only)
+
+```bash
+telezipper <source> -o <output-directory>
+```
+
+Example:
+```bash
+telezipper ./my-folder -o ./output
+```
+
+### With Telegram Upload
+
+You can provide Telegram credentials in two ways:
+
+#### Option 1: Command-line arguments (Recommended for flexibility)
+
+```bash
+telezipper <source> --telegram --bot-token YOUR_BOT_TOKEN --chat-id YOUR_CHAT_ID
+```
+
+Example:
+```bash
+telezipper ./my-folder --telegram --bot-token 123456:ABC-DEF1234ghIkl --chat-id 987654321
+```
+
+#### Option 2: Environment variables
+
+Create a `.env` file in the project directory or set environment variables:
+
+```bash
+TELEGRAM_BOT_TOKEN=your_bot_token_here
+TELEGRAM_CHAT_ID=your_chat_id_here
+```
+
+Then run:
+```bash
+telezipper ./my-folder --telegram
+```
+
+## Options
+
+- `<source>` - File or folder to zip (required)
+- `-o, --output <dir>` - Output directory (default: "output")
+- `--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)
+- `-h, --help` - Display help
+
+## Examples
+
+### Zip a folder to the default output directory
+```bash
+telezipper ./my-project
+```
+
+### Zip and specify custom output directory
+```bash
+telezipper ./my-project -o ./backups
+```
+
+### Zip and upload to Telegram with inline credentials
+```bash
+telezipper ./my-project --telegram --bot-token 123456:ABC-DEF --chat-id 987654321
+```
+
+### Zip and upload using environment variables
+```bash
+# Set environment variables first
+export TELEGRAM_BOT_TOKEN=123456:ABC-DEF
+export TELEGRAM_CHAT_ID=987654321
+
+# Then run
+telezipper ./my-project --telegram
+```
+
+## How to Get Telegram Credentials
+
+1. **Bot Token**: Create a bot using [@BotFather](https://t.me/botfather) on Telegram
+2. **Chat ID**: 
+   - Send a message to your bot
+   - Visit `https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates`
+   - Find your chat ID in the response
+
+## Features
+
+- ✅ Automatically splits large folders into 2GB chunks
+- ✅ Creates zip files with maximum compression
+- ✅ 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

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const path_1 = __importDefault(require("path"));
+const commander_1 = require("commander");
+const crawler_1 = require("../src/crawler");
+const chunking_1 = require("../src/chunking");
+const zipper_1 = require("../src/zipper");
+const program = new commander_1.Command();
+program
+    .argument("<source>", "File or folder to zip")
+    .option("-o, --output <dir>", "Output directory", "output")
+    .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)")
+    .parse();
+(async () => {
+    const source = path_1.default.resolve(program.args[0]);
+    const outputDir = path_1.default.resolve(program.opts().output);
+    const useTelegram = program.opts().telegram || false;
+    const botToken = program.opts().botToken;
+    const chatId = program.opts().chatId;
+    console.log(`🕸️ Crawling files in ${source}...`);
+    const files = await (0, crawler_1.crawl)(source);
+    console.log(`📂 Found ${files.length} files. Chunking...`);
+    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!");
+})();

package/dist/chunking.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chunking.d.ts.map

package/dist/chunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.d.ts","sourceRoot":"","sources":["../src/chunking.ts"],"names":[],"mappings":""}

package/dist/chunking.js

@@ -0,0 +1,4 @@
+import { FileInfro } from "./crawler";
+const CHUNK_SIZE = 2 * 1024 * 1024 * 1024; // 2 GB
+console.log("Using chunk size:", CHUNK_SIZE, "bytes");
+//# sourceMappingURL=chunking.js.map

package/dist/chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.js","sourceRoot":"","sources":["../src/chunking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;AAElD,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC"}

package/dist/crawler.d.ts

@@ -0,0 +1,6 @@
+export interface FileInfro {
+    path: string;
+    size: number;
+}
+export declare function crawl(target: string, files?: FileInfro[]): Promise<FileInfro[]>;
+//# sourceMappingURL=crawler.d.ts.map

package/dist/crawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.d.ts","sourceRoot":"","sources":["../src/crawler.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAID,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,EAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAezF"}

package/dist/crawler.js

@@ -0,0 +1,16 @@
+import fs from 'fs';
+import path from 'path';
+// walks folder recursively and returns list of files with their sizes
+export async function crawl(target, files = []) {
+    const stats = fs.statSync(target);
+    if (stats.isFile()) {
+        files.push({ path: target, size: stats.size });
+        return files;
+    }
+    const entries = fs.readdirSync(target);
+    for (const entry of entries) {
+        await crawl(path.join(target, entry), files);
+    }
+    return files;
+}
+//# sourceMappingURL=crawler.js.map

package/dist/crawler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.js","sourceRoot":"","sources":["../src/crawler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,MAAc,EAAE,QAAqB,EAAE;IAC/D,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAElC,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAC,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAC,CAAC;QACzB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/src/chunking.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chunkFiles = chunkFiles;
+const CHUNK_SIZE = 2 * 1024 * 1024 * 1024; // 2 GB
+// groups files into chunks where the total size of each chunk does not exceed CHUNK_SIZE
+function chunkFiles(files) {
+    const chunks = [];
+    let currentChunk = [];
+    let currentChunkSize = 0;
+    for (const file of files) {
+        if (file.size > CHUNK_SIZE) {
+            throw new Error(`File ${file.path} exceeds the maximum chunk size of 2GB.`);
+        }
+        if (currentChunkSize + file.size > CHUNK_SIZE) {
+            chunks.push(currentChunk);
+            currentChunk = [];
+            currentChunkSize = 0;
+        }
+        currentChunk.push(file);
+        currentChunkSize += file.size;
+    }
+    if (currentChunk.length > 0) {
+        chunks.push(currentChunk);
+    }
+    return chunks;
+}

package/dist/src/crawler.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.crawl = crawl;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// walks folder recursively and returns list of files with their sizes
+async function crawl(target, files = []) {
+    const stats = fs_1.default.statSync(target);
+    if (stats.isFile()) {
+        files.push({ path: target, size: stats.size });
+        return files;
+    }
+    const entries = fs_1.default.readdirSync(target);
+    for (const entry of entries) {
+        await crawl(path_1.default.join(target, entry), files);
+    }
+    return files;
+}

package/dist/src/telegramUploader.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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 cli_progress_1 = __importDefault(require("cli-progress"));
+// 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.");
+    }
+    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 progressBar = new cli_progress_1.default.SingleBar({
+        format: "Uploading [{bar}] {percentage}% | {value}/{total} Bytes",
+    }, cli_progress_1.default.Presets.shades_classic);
+    progressBar.start(totalSize, 0);
+    const stream = fs_1.default.createReadStream(zipPath);
+    let uploaded = 0;
+    stream.on("data", (chunk) => {
+        uploaded += chunk.length;
+        progressBar.update(uploaded);
+    });
+    await bot.sendDocument(chat_id, stream);
+    progressBar.stop();
+    console.log("✅ Upload complete");
+}

package/dist/src/zipper.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zipChunks = zipChunks;
+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"));
+const telegramUploader_1 = require("./telegramUploader");
+async function zipChunks(chunks, outputDir, useTelegram, botToken, chatId) {
+    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}`);
+        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 } });
+            archive.pipe(output);
+            output.on("close", () => {
+                progressBar.stop();
+                if (useTelegram) {
+                    uploadQueue.push((0, telegramUploader_1.uploadToTelegram)(zipPath, botToken, chatId));
+                }
+                ;
+                resolve();
+            });
+            archive.on("error", reject);
+            chunks[i].forEach((file, index) => {
+                archive.file(file.path, { name: path_1.default.basename(file.path) });
+                progressBar.increment();
+            });
+            archive.finalize();
+        });
+    }
+    if (useTelegram) {
+        console.log("🚀 Uploading all zips to Telegram...");
+        await Promise.all(uploadQueue);
+    }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@ayush24k/telezipper",
+  "version": "1.1.0",
+  "description": "Split folders into multiple 2GB zip files with optional Telegram upload made for personal use.",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "telezipper": "dist/bin/zipper.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "cli-progress": "^3.12.0",
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
+    "node-telegram-bot-api": "^0.67.0",
+    "tough-cookie": "^2.5.0"
+  },
+  "devDependencies": {
+    "@types/archiver": "^7.0.0",
+    "@types/cli-progress": "^3.11.6",
+    "@types/node": "^25.1.0",
+    "@types/node-telegram-bot-api": "^0.64.13",
+    "typescript": "^5.9.3"
+  }
+}