tsoft-cli 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -50,4 +50,23 @@
 
 ### Fixed
 - Yeni tema ekleme işlemi sırasında oluşan hatalar giderildi.
-- `start.js` `utils.js` ve `sync.js` dosyalarında iyileştirmeler yapıldı.
+- `start.js` `utils.js` ve `sync.js` dosyalarında iyileştirmeler yapıldı.
+
+# Changelog
+
+## [1.4.0] - 2024-06-16
+### Added
+- Zip dosyasının indirildiğinde ve çıkartıldığında oluşabilecek hatalar kontrol edilip anlamlı hata mesajları eklendi.
+- Kurtarma kodu girildikten ve dosyalar başarıyla senkronize edildikten sonra otomatik olarak geliştirme ortamını başlatma özelliği eklendi.
+
+### Changed
+- Proje genelinde SoC (Separation of Concerns) prensiplerine uygun olarak sınıf tabanlı yapıya geçildi.
+- `ClientCredentials`, `FileManager`, `Request`, `ThemeManager`, ve `Utils` dosyaları sınıf yapısına dönüştürüldü.
+- `SyncCommand` dosyasındaki `syncTheme` fonksiyonu, kurtarma işlemi ve zip dosyası işlemlerini yönetmek için güncellendi.
+- `StartCommand` ile senkronize şekilde çalışacak şekilde `syncTheme` fonksiyonu güncellendi.
+
+### Fixed
+- Zip dosyasının indirilmesi ve çıkartılması sırasında oluşabilecek hatalar için ek kontrol sağlandı.
+- Kurtarma işlemi sırasında çok fazla deneme yapılırsa kullanıcıyı doğru şekilde bilgilendirme ve işlemi durdurma.
+- Geliştirme ortamını başlatma işlemi sırasında oluşabilecek hatalar giderildi.
+- Proje genelinde hata yönetimi ve kullanıcı bilgilendirme mesajları iyileştirildi.

package/README.md

@@ -1,106 +1,118 @@
+T-Soft CLI Kullanım Kılavuzu body { font-family: Arial, sans-serif; line-height: 1.6; margin: 20px; } h1, h2, h3 { color: #2c3e50; } code { background: #f4f4f4; padding: 2px 4px; border-radius: 4px; } pre { background: #f4f4f4; padding: 10px; border-radius: 4px; }
+
 T-Soft CLI Kullanım Kılavuzu
 ============================
 
-Açıklama
---------
+T-Soft CLI, T-Soft temalarıyla çalışmak için geliştirilmiş bir komut satırı aracıdır. Bu kılavuz, T-Soft CLI'nin nasıl kullanılacağını adım adım açıklamaktadır.
+
+Gereksinimler
+-------------
 
-T-Soft CLI, T-Soft için tema geliştirmek isteyen geliştiriciler için özel olarak hazırlanmış bir komut satırı arayüzüdür. Bu araç ile yeni temalar oluşturabilir, mevcut temaları düzenleyebilir ve geliştirme ortamınızı kolaylıkla yönetebilirsiniz.
+*   Node.js (v14.0.0 veya üstü)
+*   NPM veya Yarn
 
 Kurulum
 -------
 
-CLI aracını kullanmaya başlamadan önce, aşağıdaki adımları izleyerek T-Soft CLI'yı kurmanız gerekmektedir:
+1.  Proje dosyalarını bilgisayarınıza indirin.
+2.  Proje dizinine gidin ve gerekli bağımlılıkları yükleyin:
+
+        npm install tsoft-cli
+
+    veya
 
-### NPM ile Kurulum
+        yarn add tsoft-cli
 
-T-Soft CLI'yı global olarak kurmak için aşağıdaki komutu çalıştırın:
+3.  Veya global olarak yükleyin:
 
-    npm install -g tsoft-cli
+        npm install -g tsoft-cli
 
-Kullanım
+    veya
+
+        yarn global add tsoft-cli
+Başlatma
 --------
 
-CLI arayüzünü çalıştırmak için terminale `tsoft-cli` yazmanız yeterlidir:
+CLI uygulamasını başlatmak için aşağıdaki komutu kullanın:
+
+    npx tsoft-cli
 
+veya global olarak yüklediyseniz:
+    
     tsoft-cli
 
-### Ana Menü
+Ana Menü
+--------
 
-CLI başlatıldığında aşağıdaki seçeneklerle ana menü görünür:
+CLI başlatıldığında ana menü karşınıza gelecektir. Ana menüde şu seçenekler bulunmaktadır:
 
-*   Yeni bir tema oluştur
-*   Geliştirme ortamını başlat
-*   Çıkış
+1.  Yeni bir tema oluştur
+2.  Geliştirme ortamını başlat
+3.  Uzak sunucudan dosyaları indir
+4.  Çıkış
 
-### Yeni Bir Tema Oluşturma
+### 1\. Yeni bir tema oluştur
 
-Yeni bir tema oluşturmak için aşağıdaki adımları izleyin:
+Yeni bir tema oluşturmak için bu seçeneği kullanabilirsiniz. Adımlar:
 
-1.  **Yeni Tema Oluşturma Seçeneğini Seçin**: Ana menüden `Yeni bir tema oluştur` seçeneğini seçin.
-2.  **Site Adı Seçimi**:
-    *   Mevcut sitelerden birini seçin veya `Yeni bir site oluştur` seçeneğini seçin.
-    *   Yeni bir site oluşturmak istiyorsanız, site adını girin. Bu ad, geçerliliği kontrol edilecektir.
-3.  **Tema Detayları**:
-    *   Tema adı, yazar adı (isteğe bağlı) ve versiyon numarasını girin.
-4.  **Tema Oluşturma**: Tema başarıyla oluşturulduktan sonra otomatik olarak geliştirme ortamına geçilir.
+1.  "Yeni bir tema oluştur" seçeneğini seçin.
+2.  Çalışmak istediğiniz siteyi seçin veya yeni bir site adı girin.
+3.  Tema adı, yazar adı ve tema versiyonunu girin.
+4.  Tema başarıyla oluşturulacaktır.
 
-### Geliştirme Ortamını Başlatma
+### 2\. Geliştirme ortamını başlat
 
-Mevcut bir temayı düzenlemek veya geliştirmek için geliştirme ortamını başlatabilirsiniz:
+Mevcut bir temayla çalışmak için geliştirme ortamını başlatabilirsiniz. Adımlar:
 
-1.  **Geliştirme Ortamını Başlatma Seçeneğini Seçin**: Ana menüden `Geliştirme ortamını başlat` seçeneğini seçin.
-2.  **Site ve Tema Seçimi**:
-    *   Mevcut sitelerden birini seçin.
-    *   Seçilen sitedeki temalardan birini seçin.
-3.  **Geliştirme Ortamı**: Seçilen tema için geliştirme ortamı başlatılır ve dosya değişiklikleri izlenir.
+1.  "Geliştirme ortamını başlat" seçeneğini seçin.
+2.  Çalışmak istediğiniz siteyi ve temayı seçin.
+3.  Eğer ilk defa başlatıyorsanız, onay kodunu girmeniz istenecektir.
+4.  Geliştirme ortamı başlatılacak ve dosya değişiklikleri izlenmeye başlanacaktır.
 
-### Geliştirme Ortamında Kullanılabilir Komutlar
+### 3\. Uzak sunucudan dosyaları indir
 
-Geliştirme ortamında aşağıdaki komutları kullanabilirsiniz:
+Uzak sunucudan tema dosyalarını indirmek için bu seçeneği kullanabilirsiniz. Adımlar:
 
-*   `q`: Dosya izlemeyi sonlandırır.
-*   `u`: Temayı günceller.
-*   `s`: Tüm dosyaları kaydeder.
-*   `e`: `.theme` dosyasını düzenler.
-*   `o`: Tema dizinini açar.
+1.  "Uzak sunucudan dosyaları indir" seçeneğini seçin.
+2.  İndirmek istediğiniz siteyi ve temayı seçin.
+3.  Kurtarma anahtarını girin.
+4.  Dosyalar indirilecek ve çıkarılacaktır.
 
-Proje Yapısı
-------------
+### 4\. Çıkış
 
-Projenizin dosya yapısı şu şekildedir:
+CLI uygulamasından çıkmak için bu seçeneği kullanabilirsiniz.
 
+Temel Komutlar ve Kullanımlar
+-----------------------------
 
-    tsoft-cli/
-    ├── bin/
-    │   └── index.js
-    ├── src/
-    │   ├── commands/
-    │   │   ├── create.js
-    │   │   └── start.js
-    │   ├── tsoft/
-    │   │   └── themeManager.js
-    │   ├── utils.js
-    │   └── constants.js
-    ├── CHANGELOG.md
-    ├── package.json
-    └── README.md
+**Tema Yaratma:**
 
+Ana menüden "Yeni bir tema oluştur" seçeneğini takip edin.
 
-### Dosya ve Klasör Açıklamaları
+**Geliştirme Ortamı Başlatma:**
 
-*   `bin/index.js`: Ana CLI giriş noktasıdır. Kullanıcı komutları burada işlenir ve ilgili komut dosyaları çalıştırılır.
-*   `src/commands/create.js`: Yeni bir tema oluşturmak için kullanılan komut dosyasıdır. Kullanıcıdan site ve tema adı alır ve temayı oluşturur.
-*   `src/commands/start.js`: Geliştirme ortamını başlatmak için kullanılan komut dosyasıdır. Dosya değişikliklerini izler ve temayı günceller.
-*   `src/tsoft/themeManager.js`: Tema yönetimi işlemlerini gerçekleştiren sınıftır. Temanın başlatılması, geçerliliğinin kontrol edilmesi ve ortamın oluşturulması işlemlerini yapar.
-*   `src/utils.js`: Yardımcı fonksiyonlar içerir.
-*   `src/constants.js`: Sabit değerleri içerir.
+Ana menüden "Geliştirme ortamını başlat" seçeneğini takip edin.
 
-Katkıda Bulunma
----------------
+**Uzak Sunucudan Dosya İndirme:**
 
-Proje açık kaynaklıdır ve katkılara açıktır. Katkıda bulunmak isterseniz, lütfen bir pull request gönderin veya bir issue açın.
+Ana menüden "Uzak sunucudan dosyaları indir" seçeneğini takip edin.
 
-Lisans
-------
+Dosya Yapısı
+------------
 
-Bu proje ISC lisansı altında lisanslanmıştır. Daha fazla bilgi için `LICENSE` dosyasına bakabilirsiniz.
+*   **bin/index.js:** Ana giriş noktası.
+*   **src/commands/create.js:** Tema oluşturma işlemleri.
+*   **src/commands/start.js:** Geliştirme ortamını başlatma işlemleri.
+*   **src/commands/sync.js:** Dosya senkronizasyon işlemleri.
+*   **src/constants.js:** Sabit değerler ve mesajlar.
+*   **src/request.js:** HTTP istekleri için yardımcı fonksiyonlar.
+*   **src/utils.js:** Yardımcı fonksiyonlar (örn: ekran temizleme, dosya izleme).
+*   **src/tsoft.js:** T-Soft ile ilgili ana işlemler.
+*   **src/theme-manager.js:** Tema yönetim işlemleri.
+*   **src/file-manager.js:** Dosya yönetim işlemleri.
+*   **src/client-credentials.js:** Müşteri kimlik bilgileri yönetimi.
+
+İletişim ve Destek
+------------------
+
+Bu kılavuz, T-Soft CLI'nin temel kullanımını ve işlevlerini kapsar. Daha fazla bilgi için proje dosyalarına göz atabilirsiniz. İyi çalışmalar!

package/bin/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
-const {Select} = require('enquirer');
-const {start} = require('../src/commands/start');
-const {syncTheme} = require('../src/commands/sync');  // Yeni komut dosyasını ekle
-const {createTheme} = require('../src/commands/create');
-const {clearScreen, displayAsciiArt} = require('../src/utils');
+const { Select } = require('enquirer');
+const StartCommand = require('../src/commands/StartCommand');
+const SyncCommand = require('../src/commands/SyncCommand');
+const CreateCommand = require('../src/commands/CreateCommand');
+const { clearScreen, displayAsciiArt } = require('../src/core/Utils');
 const fs = require('fs');
 const path = require('path');
 
@@ -43,7 +43,7 @@ async function selectSiteAndTheme() {
 
     const selectedTheme = await selectFromChoices('Bir tema seçin:', themes);
 
-    return {siteName: selectedSite, themeName: selectedTheme};
+    return { siteName: selectedSite, themeName: selectedTheme };
 }
 
 async function showMainMenu() {
@@ -51,20 +51,20 @@ async function showMainMenu() {
     await displayAsciiArt();
 
     const commandChoices = ['Yeni bir tema oluştur', 'Geliştirme ortamını başlat', 'Uzak sunucudan dosyaları indir', 'Çıkış'];
-    const selectedCommand = await selectFromChoices('Bir komut seçin', commandChoices);
+    const selectedCommand = await selectFromChoices('Bir komut seçin:', commandChoices);
 
     switch (selectedCommand) {
         case 'Yeni bir tema oluştur':
-            await createTheme();
+            await CreateCommand.createTheme();
             break;
         case 'Geliştirme ortamını başlat':
             const selection = await selectSiteAndTheme();
             if (selection) {
-                await start(selection.siteName, selection.themeName);
+                await StartCommand.start(selection.siteName, selection.themeName);
             }
             break;
         case 'Uzak sunucudan dosyaları indir':
-            await syncTheme();
+            await SyncCommand.syncTheme();
             break;
         case 'Çıkış':
             console.log('Programdan çıkılıyor. Hoşça kalın!');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsoft-cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "A theme development cli for developers who want to create themes for T-Soft.",
   "main": "index.js",
   "scripts": {
@@ -19,6 +19,7 @@
     "enquirer": "^2.4.1",
     "figlet": "^1.7.0",
     "fs": "^0.0.1-security",
+    "node-fetch": "^3.3.2",
     "unzipper": "^0.12.1"
   },
   "type": "commonjs",

package/src/{tsoft.js → Tsoft.js}

@@ -1,9 +1,9 @@
-const ClientCredentials = require('./client-credentials');
-const constants = require('./constants');
-const FileManager = require('./file-manager');
-const ThemeManager = require('./theme-manager');
+const ClientCredentials = require('./core/ClientCredentials');
+const Constants = require('./core/Constants');
+const FileManager = require('./core/FileManager');
+const ThemeManager = require('./core/ThemeManager');
 const path = require("path");
-const {buildPostRequest} = require('./request');
+const { buildPostRequest } = require('./core/Request');
 
 class Tsoft {
     static TSOFT_CLI_UUID = '7583a318-8542-4ec8-980c-48ea67031be3';
@@ -11,7 +11,6 @@ class Tsoft {
     static ONLINESTORE_DELETE_URI = 'api/v3/admin/online-store-2/theme/file-manager?q=delete';
     static UPDATE_THEME_URI = 'api/v3/admin/online-store-2/theme/update-theme';
 
-
     constructor(site) {
         this.site = site;
         this.themeManager = new ThemeManager(site);
@@ -38,7 +37,7 @@ class Tsoft {
 
     async register(CLIENT_UUID, clientConfiguration = {}) {
         const response = await this.clientCredentials.register(CLIENT_UUID, clientConfiguration);
-        return response === true ? constants.APPROVAL : null;
+        return response === true ? Constants.APPROVAL : null;
     }
 
     async saveOnlineStore(theme) {
@@ -78,7 +77,6 @@ class Tsoft {
     }
 
     async deleteFile(theme, fileName, bearerToken) {
-
         return await buildPostRequest(this.site, Tsoft.ONLINESTORE_DELETE_URI, {
             headers: {
                 Authorization: `Bearer ${bearerToken}`,
@@ -87,11 +85,10 @@ class Tsoft {
             body: JSON.stringify({
                 theme: theme,
                 items: [
-                    {type: 'file', path: fileName}
+                    { type: 'file', path: fileName }
                 ]
             })
         });
-
     }
 
     async deleteDirectory(theme, folderName, bearerToken) {
@@ -104,13 +101,12 @@ class Tsoft {
             body: JSON.stringify({
                 theme: theme,
                 items: [
-                    {type: 'dir', path: folderName}
+                    { type: 'dir', path: folderName }
                 ]
             })
         });
     }
 
-
     async isTokenValid(theme) {
         const env = this.themeManager.getEnvironment(theme);
         return await this.clientCredentials.validateToken(env.bearer);
@@ -136,7 +132,6 @@ class Tsoft {
     async startRecovery(token) {
         return await this.clientCredentials.recovery(token);
     }
-
 }
 
 module.exports = Tsoft;

package/src/commands/CreateCommand.js

@@ -0,0 +1,100 @@
+const fs = require('fs');
+const path = require('path');
+const { Select, Input } = require('enquirer');
+const { slugify, clearScreen } = require('../core/Utils');
+const ThemeManager = require('../core/ThemeManager');
+const { start } = require('./StartCommand');
+
+class CreateCommand {
+    static async getSites() {
+        const cwd = process.cwd();
+        return fs.readdirSync(cwd).filter(file => {
+            return file.charAt(0) !== '.' && !['node_modules', 'build', 'dist'].includes(file);
+        }).filter(file => fs.statSync(path.join(cwd, file)).isDirectory());
+    }
+
+    static async selectSite(sites) {
+        const siteChoices = [...sites, 'Yeni bir site oluştur'];
+        const sitePrompt = new Select({
+            name: 'site',
+            message: 'Çalışmak istediğiniz sitenin adı:',
+            choices: siteChoices
+        });
+        const selectedSite = await sitePrompt.run();
+        return selectedSite === 'Yeni bir site oluştur' ? await this.createNewSite() : selectedSite;
+    }
+
+    static async createNewSite() {
+        const newSitePrompt = new Input({
+            name: 'newSite',
+            message: 'Yeni site adı:'
+        });
+        const siteName = await newSitePrompt.run();
+        const themeManager = new ThemeManager(siteName);
+        const isValid = await this.validateSiteName(themeManager, siteName);
+        return isValid ? siteName : null;
+    }
+
+    static async validateSiteName(themeManager, siteName) {
+        try {
+            const isValid = await themeManager.checkSiteValidity(siteName);
+            if (!isValid) {
+                console.error('Geçersiz site adı. Lütfen geçerli bir site adı girin.');
+                return false;
+            }
+            return true;
+        } catch (error) {
+            console.error('Site doğrulaması sırasında hata oluştu:', error.message);
+            return false;
+        }
+    }
+
+    static async getThemeDetails() {
+        const themeNamePrompt = new Input({
+            name: 'themeName',
+            message: 'Tema adı:'
+        });
+        const authorPrompt = new Input({
+            name: 'author',
+            message: 'Author (isteğe bağlı):'
+        });
+        const versionPrompt = new Input({
+            name: 'version',
+            message: 'Version (isteğe bağlı, varsayılan 1.0.0):',
+            initial: '1.0.0'
+        });
+        const themeName = await themeNamePrompt.run();
+        const author = await authorPrompt.run();
+        const version = await versionPrompt.run();
+        return { themeName, author, version };
+    }
+
+    static async createThemeDirectory(siteName, themeNameSlug) {
+        const cwd = process.cwd();
+        const themePath = path.join(cwd, siteName, themeNameSlug);
+        if (!fs.existsSync(themePath)) {
+            fs.mkdirSync(themePath, { recursive: true });
+        }
+        return themePath;
+    }
+
+    static async saveThemeData(themePath, themeData) {
+        fs.writeFileSync(path.join(themePath, '.theme'), JSON.stringify(themeData, null, 2));
+    }
+
+    static async createTheme() {
+        const sites = await this.getSites();
+        const siteName = await this.selectSite(sites);
+        if (!siteName) return;
+        const { themeName, author, version } = await this.getThemeDetails();
+        const themeNameSlug = slugify(themeName);
+        const themePath = await this.createThemeDirectory(siteName, themeNameSlug);
+        const themeData = { site: siteName, name: themeName, author: author, version: version };
+        await this.saveThemeData(themePath, themeData);
+        clearScreen();
+        console.log(`Tema "${themeName}" başarıyla oluşturuldu.`);
+        await start(siteName, themeNameSlug, true);
+    }
+}
+
+module.exports = CreateCommand;