tsoft-cli 2.6.15 → 3.4.1

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, '');
+}
+