@mustafa60x/gitpack 0.0.1 → 1.0.1

package/README.md

@@ -1,2 +1,76 @@
-# gitpack
-Smart project packer that respects `.gitignore`
+# Gitpack
+
+> Smart project packer that respects `.gitignore` or falls back to a sensible default exclusion list. Creates timestamped archives named after your package.
+
+## Features
+
+- ✅ **Smart Naming**:
+  - Uses `name` and `version` from `package.json` if available (e.g., `app-v1.3.0-2026-02-09_153045.zip`)
+  - Fallback to directory name + timestamp if `package.json` is missing.
+- ✅ **Git Aware**: 
+  - Uses `git ls-files` to include only tracked and non-ignored files.
+- ✅ **Multiple Formats**: Support for `.zip` and `.tar.gz`.
+- ✅ **Custom Output**: Control where your archive goes and what it includes.
+
+## Installation
+
+You can run it directly with `npx`:
+
+```bash
+npx @mustafa60x/gitpack
+```
+
+Or install it globally:
+
+```bash
+npm install -g @mustafa60x/gitpack
+```
+
+## Usage
+
+```bash
+gitpack [options]
+```
+
+### Options
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--format <type>` | Archive format (`zip` or `tar`). | `zip` |
+| `--out <path>` | Specify output directory. | `../` (Parent directory) |
+| `--include-env` | Include `.env` files (only in fallback mode). | `false` |
+| `--no-git` | Force fallback mode (ignore `.git` data). | `false` |
+
+### Examples
+
+**Standard Zip (Parent Directory)**
+```bash
+gitpack
+```
+
+**Custom Output to a 'backups' folder**
+```bash
+gitpack --out ./backups
+```
+
+**Generate a .tar.gz file**
+```bash
+gitpack --format tar
+```
+
+**Force fallback mode and include .env files**
+```bash
+gitpack --no-git --include-env
+```
+
+## Output Table
+
+| Scenario | `package.json` | Example Result |
+|----------|---------------|-----------------|
+| **Standard Zip** | `name: "app"`, `v1.3.0` | `app-v1.3.0-2026-02-09_032045.zip` |
+| **Tar Mode** | `name: "app"` | `app-2026-02-09_032045.tar.gz` |
+| **No Package** | (missing) | `folder_name-2026-02-09_032045.zip` |
+
+## License
+
+MIT © [mustafa60x](https://github.com/mustafa60x)

package/bin/gitpack.js

@@ -1,3 +1,157 @@
 #!/usr/bin/env node
 
-console.log("Hello World");
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+import archiver from "archiver";
+
+// ----------------------
+// ARG PARSE
+// ----------------------
+
+const args = process.argv.slice(2);
+
+let format = "zip";
+let outDir = path.dirname(process.cwd());
+let includeEnv = false;
+let noGit = false;
+
+for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--format" && args[i + 1]) {
+        format = args[i + 1];
+        i++;
+    } else if (args[i] === "--out" && args[i + 1]) {
+        outDir = path.resolve(args[i + 1]);
+        i++;
+    } else if (args[i] === "--include-env") {
+        includeEnv = true;
+    } else if (args[i] === "--no-git") {
+        noGit = true;
+    }
+}
+
+// ----------------------
+// PROJECT INFO
+// ----------------------
+
+const now = new Date();
+const pad = (n) => String(n).padStart(2, "0");
+const dateStr = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
+const timeStr = `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+const timestamp = `${dateStr}_${timeStr}`;
+
+const cwd = process.cwd();
+let projectName = path.basename(cwd);
+let version = "";
+
+const pkgPath = path.join(cwd, "package.json");
+
+if (fs.existsSync(pkgPath)) {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    if (pkg.name) projectName = pkg.name;
+    if (pkg.version) version = `-v${pkg.version.replace(/^v/, "")}`;
+}
+
+if (!fs.existsSync(outDir)) {
+    fs.mkdirSync(outDir, { recursive: true });
+}
+
+const extension = format === "tar" ? "tar.gz" : "zip";
+const safeProjectName = projectName.replace(/^@/, "").replace(/\//g, "-");
+const outputName = `${safeProjectName}${version}-${timestamp}.${extension}`;
+const outputPath = path.join(outDir, outputName);
+
+// ----------------------
+// ARCHIVER SETUP
+// ----------------------
+
+const output = fs.createWriteStream(outputPath);
+
+const archive =
+    format === "tar"
+        ? archiver("tar", { gzip: true, gzipOptions: { level: 9 } })
+        : archiver("zip", { zlib: { level: 9 } });
+
+archive.pipe(output);
+
+// ----------------------
+// FILE STRATEGY
+// ----------------------
+
+const gitAvailable = fs.existsSync(path.join(cwd, ".git")) && !noGit;
+
+// Calculate relative path of output to CWD for exclusion
+const relativeOutputPath = path.relative(cwd, outputPath);
+const isOutputInside = !relativeOutputPath.startsWith("..") && !path.isAbsolute(relativeOutputPath);
+
+if (gitAvailable) {
+    let gitCommand = "git ls-files --cached --others --exclude-standard";
+
+    // If output is inside, exclude it from git listing
+    if (isOutputInside) {
+        gitCommand += ` -- ":(exclude)${relativeOutputPath}"`;
+    }
+
+    const files = execSync(gitCommand)
+        .toString()
+        .split("\n")
+        .filter(Boolean);
+
+    files.forEach((file) => {
+        archive.file(path.join(cwd, file), { name: file });
+    });
+} else {
+    const ignoreList = [
+        "node_modules/**",
+        ".git/**",
+        ".nuxt/**",
+        "dist/**",
+        "build/**",
+        ".next/**",
+        "coverage/**"
+    ];
+
+    if (isOutputInside) {
+        ignoreList.push(relativeOutputPath);
+        // Also ignore the folder if specific outDir was used
+        const relativeOutDir = path.relative(cwd, outDir);
+        if (!relativeOutDir.startsWith("..") && relativeOutDir !== "") {
+            ignoreList.push(`${relativeOutDir}/**`);
+        }
+    }
+
+    if (!includeEnv) {
+        ignoreList.push(".env", ".env.*");
+    }
+
+    archive.glob("**/*", {
+        cwd,
+        ignore: ignoreList
+    });
+}
+
+// ----------------------
+
+function formatBytes(bytes) {
+    if (bytes === 0) return "0 Bytes";
+    const k = 1024;
+    const sizes = ["Bytes", "KB", "MB", "GB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + " " + sizes[i];
+}
+
+archive.finalize();
+
+output.on("close", () => {
+    const stats = fs.statSync(outputPath);
+    const size = formatBytes(stats.size);
+
+    console.log("\n──────────────────────────────────────────");
+    console.log(`  🎁 Project:  ${projectName}`);
+    if (version) console.log(`  🏷️  Version:  ${version.slice(1)}`);
+    console.log(`  📦 Format:   ${format === "tar" ? "tar.gz" : "zip"}`);
+    console.log(`  📏 Size:     ${size}`);
+    console.log(`  🚀 Path:     ${outputPath}`);
+    console.log("──────────────────────────────────────────");
+    console.log(`  ✔ Archive successfully created!\n`);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mustafa60x/gitpack",
-  "version": "0.0.1",
+  "version": "1.0.1",
   "overrides": {
     "glob": "^11.0.0"
   },
@@ -8,6 +8,12 @@
   "bin": {
     "gitpack": "bin/gitpack.js"
   },
+  "scripts": {
+    "release": "./scripts/publish.sh",
+    "release:patch": "./scripts/publish.sh patch",
+    "release:minor": "./scripts/publish.sh minor",
+    "release:major": "./scripts/publish.sh major"
+  },
   "type": "module",
   "repository": {
     "type": "git",
@@ -30,4 +36,4 @@
   "dependencies": {
     "archiver": "^7.0.1"
   }
-}
+}

package/scripts/publish.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}🚀 Starting Gitpack Release...${NC}"
+
+# Stop on error
+set -e
+
+# Version type (patch, minor, major) default: patch
+TYPE=${1:-patch}
+
+# 1. Check current git status
+if [ -n "$(git status --porcelain)" ]; then
+    echo -e "${YELLOW}⚠️  Uncommitted changes found. Please clean or commit your changes first.${NC}"
+    exit 1
+fi
+
+# 2. Run tests (if any)
+# npm test
+
+# 3. Update version
+echo -e "${BLUE}🔢 Updating version ($TYPE)...${NC}"
+NEW_VERSION=$(npm version $TYPE --no-git-tag-version)
+
+# 4. Commit changes and create tag
+git add package.json package-lock.json
+git commit -m "chore: release $NEW_VERSION"
+git tag -a $NEW_VERSION -m "Release $NEW_VERSION"
+
+# 5. Push to Git
+echo -e "${BLUE}📤 Pushing to Git...${NC}"
+CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+git push origin "$CURRENT_BRANCH" --follow-tags
+
+# 6. Publish to NPM
+echo -e "${BLUE}📦 Publishing to NPM...${NC}"
+npm publish --access public
+
+echo -e "${GREEN}🎉 Successfully published version $NEW_VERSION!${NC}"