tsoft-cli 2.5.15 → 3.4.0

package/src/errors/error-mapper.js

@@ -0,0 +1,158 @@
+/**
+ * Push error code -> locale key mapper
+ */
+import { t } from '../i18n.js';
+
+const ERROR_MAP = {
+    'PUSH-PENDING-REVIEW': {
+        message: 'error.push.pending_review.message',
+        hint: 'error.push.pending_review.hint',
+    },
+    'PUSH-AUTH': {
+        message: 'error.push.auth.message',
+        hint: 'error.push.auth.hint',
+    },
+    'PUSH-BACKEND-ERROR': {
+        message: 'error.push.backend_error.message',
+        hint: 'error.push.backend_error.hint',
+    },
+    'PUSH-BACKEND-REJECT': {
+        message: 'error.push.backend_reject.message',
+        hint: 'error.push.backend_reject.hint',
+    },
+    'PUSH-UNEXPECTED': {
+        message: 'error.push.unexpected.message',
+        hint: 'error.push.unexpected.hint',
+    },
+};
+
+const HTTP_STATUS_MAP = {
+    401: {
+        message: 'error.http.401.message',
+        hint: 'error.http.401.hint',
+    },
+    403: {
+        message: 'error.http.403.message',
+        hint: 'error.http.403.hint',
+    },
+    404: {
+        message: 'error.http.404.message',
+        hint: 'error.http.404.hint',
+    },
+    409: {
+        message: 'error.http.409.message',
+        hint: 'error.http.409.hint',
+    },
+    423: {
+        message: 'error.http.423.message',
+        hint: 'error.http.423.hint',
+    },
+};
+
+/**
+ * Push hata kodunu mesaj ve hint'e maple
+ * @param {Error} error - Axios error veya genel Error
+ * @param {boolean} verbose - Detayli cikti
+ * @returns {{ message: string, hint: string|null, raw: object|null }}
+ */
+export function mapPushError(error, verbose = false) {
+    const responseData = error.response?.data;
+    const errorCode = responseData?.error_code;
+    const statusCode = error.response?.status;
+
+    // 1. error_code oncelikli
+    if (errorCode && ERROR_MAP[errorCode]) {
+        const mapped = ERROR_MAP[errorCode];
+        return {
+            message: t(mapped.message),
+            hint: t(mapped.hint),
+            raw: verbose ? responseData : null,
+        };
+    }
+
+    // 2. Sunucu mesaji varsa (error_code bilinmiyor ama mesaj var)
+    if (responseData?.message && errorCode) {
+        return {
+            message: responseData.message,
+            hint: t('error.push.verbose_hint'),
+            raw: verbose ? responseData : null,
+        };
+    }
+
+    // 3. HTTP status fallback
+    if (statusCode) {
+        // 5xx genel
+        if (statusCode >= 500 && !HTTP_STATUS_MAP[statusCode]) {
+            return {
+                message: t('error.http.5xx.message'),
+                hint: t('error.push.verbose_hint'),
+                raw: verbose ? responseData : null,
+            };
+        }
+
+        if (HTTP_STATUS_MAP[statusCode]) {
+            const mapped = HTTP_STATUS_MAP[statusCode];
+            return {
+                message: t(mapped.message),
+                hint: t(mapped.hint),
+                raw: verbose ? responseData : null,
+            };
+        }
+    }
+
+    // 4. Genel fallback
+    return {
+        message: error.message || t('error.fallback.message'),
+        hint: t('error.push.verbose_hint'),
+        raw: verbose ? responseData : null,
+    };
+}
+
+/**
+ * Komut-bagimsiz generic error mapper.
+ * Tum komutlarin catch bloklarinda kullanilir.
+ *
+ * @param {Error} error - Axios error veya genel Error
+ * @param {{ command?: string, verbose?: boolean }} options
+ * @returns {{ message: string, hint: string|null, raw: object|null }}
+ */
+export function mapError(error, { command = 'unknown', verbose = false } = {}) {
+    const responseData = error.response?.data;
+    const statusCode = error.response?.status;
+
+    // 1. HTTP status code — mevcut HTTP_STATUS_MAP kullan
+    if (statusCode && HTTP_STATUS_MAP[statusCode]) {
+        const mapped = HTTP_STATUS_MAP[statusCode];
+        return {
+            message: t(mapped.message),
+            hint: t(mapped.hint),
+            raw: verbose ? responseData : null,
+        };
+    }
+
+    // 2. 5xx genel sunucu hatasi
+    if (statusCode && statusCode >= 500) {
+        return {
+            message: t('error.http.5xx.message'),
+            hint: t('error.http.5xx.hint', { command }),
+            raw: verbose ? responseData : null,
+        };
+    }
+
+    // 3. Network/auth hatasi — error.message kontrolu
+    const msg = error.message || '';
+    if (msg.includes('Token bulunamadi') || msg.includes('RELOGIN_REQUIRED') || msg.includes('giris') || msg.includes('login')) {
+        return {
+            message: t('error.auth_required.message'),
+            hint: t('error.auth_required.hint'),
+            raw: null,
+        };
+    }
+
+    // 4. Genel fallback — error.message passthrough if not a locale key
+    return {
+        message: msg || t('error.fallback.message'),
+        hint: null,
+        raw: verbose ? responseData : null,
+    };
+}

package/src/i18n.js

@@ -0,0 +1,84 @@
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROJECT_ROOT = join(__dirname, '..');
+
+let messages = {};
+let currentLocale = 'tr';
+
+/**
+ * OS locale auto-detect: 'en' or 'tr', default 'tr'
+ */
+function detectOsLocale() {
+    const sources = [
+        process.env.LANG,
+        process.env.LC_ALL,
+        (() => {
+            try {
+                return Intl.DateTimeFormat().resolvedOptions().locale;
+            } catch {
+                return null;
+            }
+        })(),
+    ];
+
+    for (const src of sources) {
+        if (!src) continue;
+        const lower = src.toLowerCase();
+        if (lower.startsWith('en')) return 'en';
+        if (lower.startsWith('tr')) return 'tr';
+    }
+
+    return 'tr';
+}
+
+/**
+ * Initialize locale system. Must be called once before any t() calls.
+ * Priority: TSOFT_LANG env var → default 'tr'
+ */
+export function initLocale() {
+    const envLang = process.env.TSOFT_LANG;
+    if (envLang === 'en' || envLang === 'tr') {
+        currentLocale = envLang;
+    }
+
+    const localePath = join(PROJECT_ROOT, 'locales', `${currentLocale}.json`);
+    try {
+        messages = JSON.parse(readFileSync(localePath, 'utf-8'));
+    } catch (err) {
+        // Fallback to TR if locale file is missing
+        if (currentLocale !== 'tr') {
+            currentLocale = 'tr';
+            const fallbackPath = join(PROJECT_ROOT, 'locales', 'tr.json');
+            messages = JSON.parse(readFileSync(fallbackPath, 'utf-8'));
+        } else {
+            messages = {};
+        }
+    }
+}
+
+/**
+ * Translate a key. Returns the key itself as fallback if not found.
+ * Supports {{var}} placeholder interpolation.
+ *
+ * @param {string} key - Dot-notation locale key (e.g. 'error.push.auth.message')
+ * @param {Object} vars - Variables for {{var}} interpolation
+ * @returns {string}
+ */
+export function t(key, vars = {}) {
+    let value = messages[key];
+
+    if (value === undefined) {
+        if (process.env.TSOFT_DEBUG === '1') {
+            process.stderr.write(`[i18n] Missing key: ${key}\n`);
+        }
+        return key;
+    }
+
+    // Replace {{varName}} placeholders
+    return value.replace(/\{\{(\w+)\}\}/g, (_, name) => {
+        return vars[name] !== undefined ? vars[name] : `{{${name}}}`;
+    });
+}

package/src/index.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { setJsonMode } from './output-mode.js';
+import { initLocale } from './i18n.js';
+import { renderBrandedHelp } from './ui/help-renderer.js';
+import { loginCommand } from './commands/login.js';
+import { logoutCommand } from './commands/logout.js';
+import { whoamiCommand } from './commands/whoami.js';
+import { themeListCommand, themeCreateCommand, themePullCommand, themeUseCommand } from './commands/theme.js';
+import { themeDevCommand } from './commands/theme-dev.js';
+import { themeSectionListCommand, themeSectionAddCommand } from './commands/theme-section.js';
+import { themePublishCommand } from './commands/theme-publish.js';
+import { themePushCommand } from './commands/theme-push.js';
+import { themeSubmitCommand } from './commands/theme-submit.js';
+import { themeInitCommand } from './commands/theme-init.js';
+import { orgSwitchCommand } from './commands/org-switch.js';
+
+initLocale();
+
+const program = new Command();
+
+program
+  .name('tsoft')
+  .description('tsoft360 theme development and management tool')
+  .version('3.4.0');
+
+// Global --json flag for machine-readable output (CI/CD)
+program.option('--json', 'Machine-readable JSON output for CI/CD');
+
+// preAction hook: runs before every command
+program.hook('preAction', (thisCommand) => {
+  const opts = thisCommand.opts();
+  if (opts.json) {
+    setJsonMode(true);
+    chalk.level = 0; // Disable chalk colors — no ANSI codes inside JSON
+  }
+});
+
+// Show branded help when no arguments provided
+program.action(async () => {
+  await renderBrandedHelp(program);
+});
+
+// Intercept root --help before Commander.parse() to handle async branded help
+if (process.argv.length === 3 && process.argv[2] === '--help') {
+  await renderBrandedHelp(program);
+  process.exit(0);
+}
+
+// login command
+program
+  .command('login')
+  .description('Authenticate with your tsoft360 store via OAuth2')
+  .action(async () => {
+    await loginCommand();
+  });
+
+// logout command
+program
+  .command('logout')
+  .description('Sign out and clear local credentials')
+  .action(async () => {
+    await logoutCommand();
+  });
+
+// whoami command
+program
+  .command('whoami')
+  .description('Show the logged-in user and store info')
+  .action(async () => {
+    await whoamiCommand();
+  });
+
+const theme = program
+  .command('theme')
+  .description('Theme management commands');
+
+theme
+  .command('list')
+  .description('List all themes in your store')
+  .action(async () => {
+    await themeListCommand();
+  });
+
+theme
+  .command('create')
+  .description('Create a new theme')
+  .action(async () => {
+    await themeCreateCommand();
+  });
+
+theme
+  .command('pull')
+  .description('Download an existing theme')
+  .action(async () => {
+    await themePullCommand();
+  });
+
+theme
+  .command('dev [theme-name]')
+  .description('Start theme development server with live reload')
+  .action(async (themeName) => {
+    await themeDevCommand(themeName);
+  });
+
+theme
+  .command('use [theme-name]')
+  .description('Set the active theme')
+  .action(async (themeName) => {
+    await themeUseCommand(themeName);
+  });
+
+theme
+  .command('push [theme-name]')
+  .description('Push theme files to your store')
+  .option('--verbose', 'Verbose error output')
+  .action(async (themeName, options) => {
+    await themePushCommand(themeName, options);
+  });
+
+const publishCmd = theme
+  .command('publish [theme-name]')
+  .description('Push theme (deprecated command)')
+  .action(async (themeName) => {
+    await themePublishCommand(themeName);
+  });
+publishCmd._hidden = true;
+
+const submitCmd = theme
+  .command('submit [theme-name]')
+  .description('Submit for review (deprecated command)')
+  .action(async (themeName) => {
+    await themeSubmitCommand(themeName);
+  });
+submitCmd._hidden = true;
+
+theme
+  .command('init')
+  .description('Initialize a new theme by forking an existing one')
+  .option('--from [slug]', 'Slug or name of the theme to fork')
+  .action(async (options) => {
+    await themeInitCommand(options.from);
+  });
+
+// org commands
+const org = program
+  .command('org')
+  .description('Organization management commands');
+
+org
+  .command('switch')
+  .description('Switch the active organization')
+  .action(async () => {
+    await orgSwitchCommand();
+  });
+
+// section commands (under theme)
+const section = theme
+  .command('section')
+  .description('Section management commands');
+
+section
+  .command('list')
+  .description('List all sections in the active theme')
+  .action(async () => {
+    await themeSectionListCommand();
+  });
+
+section
+  .command('add')
+  .description('Add a new section to the active theme')
+  .action(async () => {
+    await themeSectionAddCommand();
+  });
+
+// Parse arguments
+program.parse(process.argv);

package/src/output-mode.js

@@ -0,0 +1,45 @@
+/**
+ * JSON output mode singleton — CI/CD destegi
+ * Her komut isJsonMode() import ederek kontrol eder.
+ * Node.js module cache sayesinde tek instance garanti.
+ */
+
+let _jsonMode = false;
+
+/**
+ * JSON modu aktif et (index.js preAction hook'undan cagrilir)
+ * @param {boolean} val
+ */
+export function setJsonMode(val) {
+  _jsonMode = Boolean(val);
+}
+
+/**
+ * JSON modu aktif mi?
+ * @returns {boolean}
+ */
+export function isJsonMode() {
+  return _jsonMode;
+}
+
+/**
+ * JSON modunda stdout'a JSON yaz.
+ * Cagri basi sadece BIR KERE cagrilmali — partial JSON'a dikkat.
+ * @param {object} data
+ */
+export function jsonOut(data) {
+  if (_jsonMode) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+  }
+}
+
+/**
+ * Insan-okunabilir output fonksiyonlarini sarmala.
+ * JSON modunda bu blok hicbir sey yazmaz.
+ * @param {Function} fn — calistirilacak fonksiyon
+ */
+export function humanOut(fn) {
+  if (!_jsonMode) {
+    fn();
+  }
+}

package/src/pkce.js

@@ -0,0 +1,34 @@
+import crypto from 'crypto';
+
+/**
+ * PKCE code verifier oluşturur (43-128 karakter arası random string)
+ * @returns {string} Base64URL encoded code verifier
+ */
+export function generateCodeVerifier() {
+  return base64URLEncode(crypto.randomBytes(32));
+}
+
+/**
+ * Code verifier'dan code challenge oluşturur
+ * @param {string} verifier - PKCE code verifier
+ * @returns {string} Base64URL encoded SHA256 hash
+ */
+export function generateCodeChallenge(verifier) {
+  return base64URLEncode(
+    crypto.createHash('sha256').update(verifier).digest()
+  );
+}
+
+/**
+ * Buffer'ı Base64URL formatına encode eder
+ * @param {Buffer} buffer
+ * @returns {string} Base64URL encoded string
+ */
+function base64URLEncode(buffer) {
+  return buffer
+    .toString('base64')
+    .replace(/\+/g, '-')
+    .replace(/\//g, '_')
+    .replace(/=/g, '');
+}
+

package/src/server.js

@@ -0,0 +1,209 @@
+import http from 'http';
+import { URL } from 'url';
+
+/**
+ * OAuth2 callback'i yakalamak için geçici HTTP server başlatır
+ * @param {number} port - Dinlenecek port
+ * @returns {Promise<{code: string, state: string, store: string}>}
+ */
+export function startCallbackServer(port) {
+  return new Promise((resolve, reject) => {
+    const server = http.createServer((req, res) => {
+      const url = new URL(req.url, `http://localhost:${port}`);
+
+      if (url.pathname === '/callback') {
+        const code = url.searchParams.get('code');
+        const state = url.searchParams.get('state');
+        const store = url.searchParams.get('store');
+        const error = url.searchParams.get('error');
+        const errorDescription = url.searchParams.get('error_description');
+
+        if (error) {
+          res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+          res.end(errorHtml(error, errorDescription));
+          server.close();
+          reject(new Error(`OAuth2 Error: ${error} - ${errorDescription || 'No description'}`));
+          return;
+        }
+
+        if (!code || !state || !store) {
+          res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+          res.end(errorHtml('invalid_request', 'code, state veya store parametresi eksik'));
+          server.close();
+          reject(new Error('Eksik parametreler: code, state veya store bulunamadı'));
+          return;
+        }
+
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(successHtml());
+        server.close();
+        resolve({ code, state, store });
+      } else {
+        res.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end('<h1>404 - Sayfa Bulunamadı</h1>');
+      }
+    });
+
+    server.on('error', (err) => {
+      reject(new Error(`Server başlatılamadı: ${err.message}`));
+    });
+
+    server.listen(port, () => {
+      console.log(`✓ Callback sunucusu başlatıldı (http://localhost:${port}/callback)`);
+    });
+  });
+}
+
+function successHtml() {
+  return `
+<!DOCTYPE html>
+<html lang="tr">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Giriş Başarılı - tsoft CLI</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      margin: 0;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    }
+    .container {
+      background: white;
+      padding: 3rem;
+      border-radius: 1rem;
+      box-shadow: 0 20px 60px rgba(0,0,0,0.3);
+      text-align: center;
+      max-width: 400px;
+    }
+    .success-icon {
+      width: 80px;
+      height: 80px;
+      margin: 0 auto 1.5rem;
+      background: #10b981;
+      border-radius: 50%;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 3rem;
+    }
+    h1 {
+      color: #1f2937;
+      margin: 0 0 1rem;
+      font-size: 1.875rem;
+    }
+    p {
+      color: #6b7280;
+      margin: 0;
+      font-size: 1rem;
+      line-height: 1.5;
+    }
+    .note {
+      margin-top: 2rem;
+      padding: 1rem;
+      background: #f3f4f6;
+      border-radius: 0.5rem;
+      font-size: 0.875rem;
+      color: #4b5563;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="success-icon">✓</div>
+    <h1>Giriş Başarılı!</h1>
+    <p>Yetkilendirme işlemi tamamlandı.</p>
+    <p>Artık bu pencereyi kapatabilirsiniz.</p>
+    <div class="note">
+      Terminal'e dönün ve işleme devam edin.
+    </div>
+  </div>
+  <script>
+    setTimeout(() => window.close(), 3000);
+  </script>
+</body>
+</html>
+  `;
+}
+
+function errorHtml(error, description) {
+  return `
+<!DOCTYPE html>
+<html lang="tr">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Hata - tsoft CLI</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      margin: 0;
+      background: linear-gradient(135deg, #f97316 0%, #dc2626 100%);
+    }
+    .container {
+      background: white;
+      padding: 3rem;
+      border-radius: 1rem;
+      box-shadow: 0 20px 60px rgba(0,0,0,0.3);
+      text-align: center;
+      max-width: 400px;
+    }
+    .error-icon {
+      width: 80px;
+      height: 80px;
+      margin: 0 auto 1.5rem;
+      background: #ef4444;
+      border-radius: 50%;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 3rem;
+      color: white;
+    }
+    h1 {
+      color: #1f2937;
+      margin: 0 0 1rem;
+      font-size: 1.875rem;
+    }
+    p {
+      color: #6b7280;
+      margin: 0.5rem 0;
+      font-size: 1rem;
+      line-height: 1.5;
+    }
+    .error-code {
+      margin-top: 1.5rem;
+      padding: 1rem;
+      background: #fee2e2;
+      border-radius: 0.5rem;
+      font-size: 0.875rem;
+      color: #991b1b;
+      font-family: monospace;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="error-icon">✗</div>
+    <h1>Yetkilendirme Hatası</h1>
+    <p>${description || 'Bir hata oluştu'}</p>
+    <div class="error-code">
+      Hata Kodu: ${error}
+    </div>
+    <p style="margin-top: 2rem; font-size: 0.875rem;">
+      Terminal'e dönün ve tekrar deneyin.
+    </p>
+  </div>
+</body>
+</html>
+  `;
+}
+