oraksoft-node-tools 0.1.6 → 0.1.30

package/.orak-dist/app-deploy-info.jsn

@@ -0,0 +1,4 @@
+{
+  "oa1TxVersion": "0.1.27",
+  "oa1TxUrl": "https://temp/test-0_1_27_j40vs285.txt"
+}

package/.orak-dist/app-deploy-info.json

@@ -0,0 +1,4 @@
+{
+  "oa1TxVersion": "0.1.25",
+  "oa1RemoteFile": "temp/test-0_1_25_c2jsfdui.txt"
+}

package/README.md

@@ -10,11 +10,12 @@ Node.js projeleriniz için kullanışlı CLI araçları koleksiyonu.
   - [Komutlar](#komutlar)
     - [orak-copy-deps](#orak-copy-deps)
     - [orak-deploy-ftp](#orak-deploy-ftp)
-    - [orak-deploy-zip](#orak-deploy-zip)
+    - [orak-zip-content](#orak-zip-content)
+    - [orak-zip-package](#orak-zip-package)
     - [orak-env-change](#orak-env-change)
   - [Kullanım Örnekleri](#kullanım-örnekleri)
     - [1. Bağımlılık Kopyalama](#1-bağımlılık-kopyalama)
-    - [2. Deployment İşlemi](#2-deployment-i̇şlemi)
+    - [2. Arşiv Oluşturma ve FTP Yükleme](#2-arşiv-oluşturma-ve-ftp-yükleme)
     - [3. Ortam Değiştirme](#3-ortam-değiştirme)
   - [Gereksinimler](#gereksinimler)
   - [Lisans](#lisans)
@@ -30,6 +31,7 @@ pnpm install -g oraksoft-node-tools
 ```
 
 ### Proje bazında kurulum
+
 ```bash
 pnpm install oraksoft-node-tools --save-dev
 ```
@@ -48,19 +50,17 @@ Bu araçlar `orak-config.json` dosyasını kullanarak konfigüre edilir. Bu dosy
   ],
   "copyDepsLibFolder": "lib",
   "copyDepsLibFolderEmpty": true,
-  "fiDeployZipFile": "orak-deploy-zip",
-  "fiDeployZipContent": [
-    "src/",
-    "public/",
-    "package.json"
-  ],
-  "fiEnvChangeStatus": "dev"
+  "zip_package": ["lib/", "bin/"],
+  "zip_package_out_file": ".orak-dist/deploy1.tar.gz",
+  "zip_content": ["bin", "lib"],
+  "zip_content_out_file": ".orak-dist/deploy.tar.gz"
 }
 ```
 
 ## Komutlar
 
 ### orak-copy-deps
+
 Node.js bağımlılıklarınızı belirtilen klasöre kopyalar.
 
 ```bash
@@ -68,6 +68,7 @@ orak-copy-deps
 ```
 
 **Gerekli orak-config.json ayarları:**
+
 ```json
 {
   "copyDepsModulesToCopy": [
@@ -79,55 +80,108 @@ orak-copy-deps
   "copyDepsLibFolder": "lib",
   "copyDepsLibFolderEmpty": true
 }
+
 ```
 
 ### orak-deploy-ftp
-Dist klasöründeki dosyaları FTP sunucusuna yükler.
+
+Belirtilen dosyayı FTP sunucusuna yükler.
 
 ```bash
-orak-deploy-ftp
+orak-deploy-ftp [--profile <name>] [--v]
 ```
 
-**Gerekli .env dosyası:**
+**Gerekli .env.orakconfig dosyası:**
 
-```env
+```bash
 osf_ftp_host=ftp.example.com
 osf_ftp_user=username
 osf_ftp_password=password
 osf_ftp_secure=false
-osf_local_file=orak-deploy-zip.tar.gz
-osf_remote_path=/public_html
+
 ```
 
-- `osf_local_file` belirtilmezse, `orak-config.json`'daki `fiDeployZipFile` değeri kullanılır
-- `osf_remote_path` uzak sunucudaki hedef klasör yolunu belirtir, dosya adı otomatik olarak `osf_local_file`'dan alınır
+**Gerekli orak-config.json dosyası:**
+
+```bash
+osf_ftp_local_file=deploy.tar.gz
+osf_ftp_remote_path=public_html
+
+```  
+
+
+- `osf_ftp_host`: FTP sunucusunun adresi
+- `osf_ftp_user`: FTP kullanıcı adı
+- `osf_ftp_password`: FTP şifresi
+- `osf_ftp_secure`: `true` FTPS kullanır, `false` FTP kullanır (varsayılan: `false`)
+- `osf_ftp_local_file`: Yüklenmek istenen dosyanın proje köküne göre yolu (**uzantılı** olarak yazın, ör: `deploy.tar.gz`)
+- `osf_ftp_remote_path`: Uzak sunucudaki hedef klasör yolu (varsayılan: `/`)
+- Dosya adı otomatik olarak `osf_ftp_local_file`'ın son bölümünden alınır
+
+Ek opsiyonlar:
+
+- `--profile <profil_name>`: Belirtilen profil için önce `osf_ftp_local_file_<profil_name>` (veya `orak-config.json` içinde aynı anahtar) aranır. Örnek: `--profile test` -> `osf_ftp_local_file_test`. Konsolda: `test profil uygulandı.`
+
+- `--v`: Paket sürümünü (`package.json` içindeki `version`) dosya adına ekler. Noktalar `_` ile değiştirilecek (örn. `1.2.3` -> `1_2_3`) ve çok parçalı uzantılar korunacaktır (`deploy.tar.gz` -> `deploy-1_2_3.tar.gz`). Konsolda: `📦 Versiyon eklendi: 1_2_3` ve `📄 Güncel dosya adı: ...`
 
 **❗ Güvenlik Notları:**
-- `.env` dosyası zaten .gitignore'da bulunuyor
-- Web sunucunuzda `.env` dosyalarına erişimi engelleyin (.htaccess)
-- Dosya izinlerini kısıtlayın: `chmod 600 .env`
+- `.env.orakconfig` dosyası zaten .gitignore'da bulunuyor
+- Web sunucunuzda `.env.orakconfig` dosyalarına erişimi engelleyin (.htaccess)
+- Dosya izinlerini kısıtlayın: `chmod 600 .env.orakconfig`
+
+📝 `osf_ftp_host, osf_ftp_local_file` ve `osf_ftp_remote_path` değerleri `orak-config.json` içinde de tanımlanabilir. `.env.orakconfig`'de yoksa `orak-config.json`'a bakar. Profil kullanılıyorsa `osf_ftp_local_file_<profile>` anahtarı da desteklenir.
+
+### orak-zip-content
 
-### orak-deploy-zip
 Belirtilen dosya ve klasörleri tar.gz formatında arşivler.
 
 ```bash
-orak-deploy-zip
+orak-zip-content [--profile <name>] [--v]
+```
+
+**Gerekli orak-config.json ayarları:**
+
+```json
+{
+  "zip_content": ["bin", "lib"],
+  "zip_content_out_file": ".orak-dist/deploy"
+}
+```
+
+- `zip_content`: Arşive dahil edilecek dosya ve klasörler
+- `zip_content_out_file`: Oluşturulacak arşiv dosyasının tam yolu (**uzantısız**; `.tar.gz` kod tarafından eklenir)
+
+Ek opsiyonlar:
+
+- `--profile <name>`: Profil adı verildiğinde `zip_content_out_file_<name>` anahtarı tercih edilir (örn: `zip_content_out_file_test`). Konsolda: `test profil uygulandı.`
+
+- `--v`: Paket sürümünü (`package.json` içindeki `version`) dosya adına ekler; noktalar `_` ile değişir ve dosya uzantısı korunur (örn. `.orak-dist/deploy` -> `.orak-dist/deploy-1_2_3.tar.gz`). Konsolda: `📦 Versiyon eklendi: 1_2_3`
+
+### orak-zip-package
+
+Belirtilen dosya ve klasörleri tar.gz formatında paket arşivi olarak oluşturur.
+
+```bash
+orak-zip-package [--profile <name>] [--v]
 ```
 
 **Gerekli orak-config.json ayarları:**
+
 ```json
 {
-  "fiDeployZipFile": "orak-deploy-zip",
-  "fiDeployZipContent": [
-    "src/",
-    "public/",
-    "package.json"
-  ]
+  "zip_package": ["lib/", "bin/"],
+  "zip_package_out_file": ".orak-dist/deploy1"
 }
 ```
 
-- `fiDeployZipFile`: Oluşturulacak arşiv dosyasının adı (.tar.gz uzantısı otomatik eklenir)
-- `fiDeployZipContent`: Arşive dahil edilecek dosya ve klasörler
+- `zip_package`: Paket arşivine dahil edilecek dosya ve klasörler
+- `zip_package_out_file`: Oluşturulacak paket arşiv dosyasının tam yolu (**uzantısız**; `.tar.gz` kod tarafından eklenir)
+
+Ek opsiyonlar:
+
+- `--profile <name>`: Profil adı verildiğinde `zip_package_out_file_<name>` anahtarı tercih edilir (örn: `zip_package_out_file_test`).
+
+- `--v`: Paket sürümünü (`package.json` içindeki `version`) dosya adına ekler; noktalar `_` ile değişir ve dosya uzantısı korunur (örn. `.orak-dist/deploy1` -> `.orak-dist/deploy1-1_2_3.tar.gz`).
 
 ### orak-env-change
 Ortam dosyalarını (.env) değiştirir.
@@ -155,14 +209,18 @@ Bu durumda parametre vermeden `orak-env-change` komutunu çalıştırabilirsiniz
 orak-copy-deps
 ```
 
-### 2. Deployment İşlemi
+### 2. Arşiv Oluşturma ve FTP Yükleme
 ```bash
-# .env dosyası oluşturun ve FTP bilgilerinizi ekleyin
-# Önce arşiv oluştur
-orak-deploy-zip
+# .env.orakconfig dosyası oluşturun ve FTP bilgilerinizi ekleyin
 
-# Sonra FTP'ye yükle
+# İçerik arşivi oluştur
+orak-zip-content
+
+# FTP'ye yükle
 orak-deploy-ftp
+
+# Alternatif olarak paket arşivi oluştur
+orak-zip-package
 ```
 
 ### 3. Ortam Değiştirme

package/bin/orak-deploy-ftp-files.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { deployFtpFiles } from '../lib/deploy-ftp-files.js';
+
+deployFtpFiles();

package/bin/orak-env-dev-change.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { envDevChange } from '../lib/env-dev-change.js';
 

package/bin/orak-zip-content.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { deployZipContent } from '../lib/zip-content.js';
+
+deployZipContent();

package/bin/orak-zip-package.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { zipPackage } from '../lib/zip-package.js';
+
+zipPackage();

package/{.env.example → env.example}

@@ -3,7 +3,7 @@ osf_ftp_host=ftp.example.com
 osf_ftp_user=username
 osf_ftp_password=password
 osf_ftp_secure=false
-osf_local_file=deployphp25.tar.gz
+osf_ftp_local_file=deployphp25.tar.gz
 osf_remote_file=/public_html/deploy.tar.gz
 
 # Bu dosyayı gerçek bilgilerinizle güncelleyin

package/jsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "es2020",
+    "module": "commonjs",
+    "checkJs": true,
+    "allowJs": true,
+    "moduleResolution": "node",
+    "baseUrl": ".",
+    "paths": {
+      "*": ["node_modules/*", "lib/*"]
+    }
+  },
+  "exclude": [
+    "node_modules",
+    "**/dist",
+    "**/build"
+  ]
+}

package/lib/args-parser.js

@@ -0,0 +1,22 @@
+import minimist from 'minimist';
+
+/**
+ * Komut satırı argümanlarını parse eder
+ * @param {string[]} argv - process.argv.slice(2) ile geçilir
+ * @param {object} options - minimist options (opsiyonel)
+ * @returns {object} Parsed argümanlar
+ */
+export function parseArgs(argv = process.argv.slice(2), options = {}) {
+  return minimist(argv, options);
+}
+
+/**
+ * Belirli bir argümanı alma (--key:value veya --key value formatları)
+ * @param {string} name - Argüman adı
+ * @param {string} defaultValue - Varsayılan değer
+ * @returns {string} Argüman değeri
+ */
+export function getArg(name, defaultValue = null) {
+  const args = parseArgs();
+  return args[name] || defaultValue;
+}

package/lib/copy-deps.js

@@ -1,13 +1,16 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { parseArgs } from './args-parser.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 export function copyDeps() {
+    const args = parseArgs();
+    
     // Argüman kontrolü ve yardım mesajı
-    if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    if (args.help || args.h) {
         // package.json'dan versiyon al
         const packageJsonPath = path.join(__dirname, '..', 'package.json');
         const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));

package/lib/deploy-ftp-files.js

@@ -0,0 +1,152 @@
+import { Client } from "basic-ftp";
+import path from "path";
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+import { parseArgs } from './args-parser.js';
+import { parseEnvContent, addVersionToFilename, DeployConfig } from './osf-node-utils.js';
+
+// @ts-ignore
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+//console.log("filename:" + __filename);
+//console.log("dirname:" + __dirname);
+
+export async function deployFtpFiles() {
+  const args = parseArgs();
+
+  let deployConfig = new DeployConfig();
+
+  const packageJsonPath = path.join(__dirname, '..', 'package.json');
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+  deployConfig.objPackageJson = packageJson;
+
+  // Argüman kontrolü ve yardım mesajı
+  if (args.help || args.h) {
+    // package.json'dan versiyon al
+    console.log(`orak-deploy-ftp-files version ${packageJson.version}`);
+    console.log('Kullanım: orak-deploy-ftp-files');
+    console.log('');
+    console.log('Konfigürasyon: .env dosyasında FTP bilgileri gerekli.');
+    process.exit(0);
+  }
+
+  console.log("🚀 FTP Deploy Files Başlatılıyor...");
+
+  const projectRoot = process.cwd();
+  deployConfig.pathProjectRoot = projectRoot;
+
+  //console.log("Project Root:"+ projectRoot);
+  //Project Root:Y:\devrepo-oraksoft-web\oraksoft-node-tools
+
+  // .env.orakconfig dosyasını oku
+  const pathEnvOrakConfig = path.join(projectRoot, '.env.orakconfig');
+
+  //console.log("envPath:" + pathEnvOrakConfig);
+  //envPath:Y:\devrepo-oraksoft-web\oraksoft-node-tools\.env.orakconfig
+
+  if (!fs.existsSync(pathEnvOrakConfig)) {
+    console.error(`
+❌ .env.orakconfig dosyası bulunamadı!
+
+.env.orakconfig dosyası oluşturun ve şu bilgileri ekleyin:
+osf_ftp_host=ftp.example.com
+osf_ftp_user=username
+osf_ftp_password=password
+osf_ftp_secure=false
+`);
+    process.exit(1);
+  }
+
+  // .env.xx dosyasını parse et
+  const envContent = fs.readFileSync(pathEnvOrakConfig, 'utf-8');
+  const envVars = parseEnvContent(envContent);
+
+  // ftp güvenlik bilgileri
+  let ftpHost = envVars.osf_ftp_host;
+  const ftpUser = envVars.osf_ftp_user;
+  const ftpPassword = envVars.osf_ftp_password;
+  const ftpSecure = envVars.osf_ftp_secure === 'true';
+
+  // osf_ftp_local_file support with profile suffix (osf_ftp_local_file_{profile})
+  let remotePathKey = 'dff_remote_path';
+
+  if (args.profile || args.p) {
+    args.profile = args.profile || args.p;
+    console.log(`🔖 Profil kullanılıyor: ${args.profile}`);
+    remotePathKey = remotePathKey + '_' + args.profile;
+  }
+
+  //let localFileName = envVars[localFileKey];
+  let remotePath = envVars[remotePathKey];
+
+  // if (!ftpHost || !remotePath) {
+  const pathOrakConfigJson = path.join(projectRoot, 'orak-config.json');
+
+  if (!fs.existsSync(pathOrakConfigJson)) {
+    console.error(`
+❌ orak-config.json dosyası bulunamadı!
+
+.orak-config.json dosyası oluşturun ve şu bilgileri ekleyin:
+${remotePathKey}=<remote_path>
+`);
+    process.exit(1);
+  }
+
+  //orak-config.json dosyasını oku
+  const jsonOrakConfig = JSON.parse(fs.readFileSync(pathOrakConfigJson, 'utf-8'));
+  deployConfig.objOrakConfig = jsonOrakConfig;
+
+  //ftpHost = ftpHost ?? jsonOrakConfig.osf_ftp_host;
+  remotePath = deployConfig.objOrakConfig[remotePathKey] ?? ''; //remotePath ??
+
+  if (!ftpHost || !ftpUser || !ftpPassword) {
+    console.error("Error: FTP bilgileri eksik. .env.orakconfig dosyasında osf_ftp_host, osf_ftp_user ve osf_ftp_password alanlarını kontrol edin.");
+    process.exit(1);
+  }
+
+  const client = new Client();
+  client.ftp.verbose = true;
+
+  /* @type {string[]} */
+  const filesToArchive = deployConfig.objOrakConfig.dff_list || [];
+
+  //  "dff_list": [
+  //   {
+  //     "local": ".orak-dist/test1.txt",
+  //     "remote": "temp"
+  //   }
+  // ]
+
+  try {
+    await client.access({
+      host: ftpHost,
+      user: ftpUser,
+      password: ftpPassword,
+      secure: ftpSecure
+    });
+
+    // dff_list içindeki dosyaları yükle
+    for (const objFile of filesToArchive) {
+      const localFilePath = path.join(projectRoot, objFile.local);
+      // remoteFilePath: remote klasör + dosya adı
+      const remoteFilePath = path.posix.join(remotePath, objFile.remote, path.basename(objFile.local));
+      if (!fs.existsSync(localFilePath)) {
+        console.error(`Error: Yerel dosya bulunamadı: ${localFilePath}`);
+        continue;
+      }
+      console.log(`Yükleniyor: ${localFilePath} -> ${remoteFilePath}`);
+      await client.uploadFrom(localFilePath, remoteFilePath);
+      console.log(`✅ Lokal: ${localFilePath}`);
+      console.log(`✅ Remote: ${remoteFilePath}`);
+      console.log('-----------------------------');
+    }
+    console.log("✅ FTP yükleme tamamlandı!");
+  }
+  catch (err) {
+    console.error("❌ FTP Hatası:", err);
+    process.exit(1);
+  }
+  client.close();
+
+}

package/lib/deploy-ftp-secure.js

@@ -25,7 +25,7 @@ export async function deployFtp() {
             ftpUser = ftpUser || oraksoftJson.osf_ftp_user;
             ftpPassword = ftpPassword || oraksoftJson.osf_ftp_password;
             ftpSecure = ftpSecure || oraksoftJson.osf_ftp_secure || false;
-            localFilePath = localFilePath || oraksoftJson.osf_local_file;
+            localFilePath = localFilePath || oraksoftJson.osf_ftp_local_file;
             remoteFilePath = remoteFilePath || oraksoftJson.osf_remote_file;
         }
     } else {