tsoft-cli 3.12.1 → 3.12.3

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to T-Soft CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.12.3] - 2026-08-11
+
+### Fixed
+- A failed download no longer destroys the theme you already had on disk. `theme pull`, `theme create` and `theme init` deleted the target directory *before* fetching anything, so a download that arrived truncated or died mid-transfer left nothing behind but a `theme.zip` that could not be opened — the files you had been working on were already gone. Downloads now land in a temporary directory next to the target and are only put in place once the archive has been received and read successfully; if anything goes wrong the existing files stay exactly as they were.
+- A download cut off mid-transfer is now reported instead of hanging. Only the file being written was watched for errors, not the incoming data, so a dropped connection could leave the command waiting indefinitely or crash it outside its own error handling.
+- `theme section` no longer risks the theme it is updating: a corrupt archive is detected before any file in the theme is touched.
+
+## [3.12.2] - 2026-08-11
+
+### Fixed
+- `theme dev` no longer reports the theme you are working on as missing. Downloading a theme records which one is active, and `theme dev` then looked that record up by the theme's name — but what gets recorded is the theme's folder, so the lookup could never match and every run ended in "theme not found". Re-downloading the theme did not help, because the failure was in the lookup rather than in the files on disk. Both spellings are now accepted, so the record written by `theme pull`, `theme use` and `theme dev` resolves the same way. `theme use` also accepts a theme folder as its argument.
+- Theme lists no longer stop at the first page. `theme list`, `theme pull`, `theme use`, `theme init` and `theme section` asked the store for its themes and read only the first page of the answer, so on a store with many themes the rest were invisible: pickers showed a fraction of what was there and looking a theme up by name failed for anything further down. Every page is now read before the list is used.
+
 ## [3.12.1] - 2026-08-08
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsoft-cli",
-  "version": "3.12.1",
+  "version": "3.12.3",
   "description": "Command-line tool for tsoft360 theme development and management",
   "type": "module",
   "main": "src/index.js",

package/src/commands/theme-dev.js

@@ -1,8 +1,6 @@
 import chalk from 'chalk';
 import fs from 'fs/promises';
-import {createWriteStream} from 'fs';
 import path from 'path';
-import AdmZip from 'adm-zip';
 import chokidar from 'chokidar';
 import {createApiClient} from '../api-client.js';
 import open from 'open';
@@ -10,7 +8,9 @@ import {normalizeStoreDomain, slugify, setActiveTheme, getActiveTheme, getActive
 import {decorateThemeName} from '../ui/theme-choice.js';
 import {brandedConfirm, brandedSelect, showWarning, showError, showInfo} from '../ui/prompt-wrapper.js';
 import {themeSectionMenuCommand} from './theme-section.js';
+import {fetchAllThemes} from '../theme-list.js';
 import { t } from '../i18n.js';
+import {extractThemeArchive} from '../theme-download.js';
 
 function resolveSectionFolder(relativePath) {
     if (!relativePath) {
@@ -29,32 +29,11 @@ function resolveSectionFolder(relativePath) {
     return folder.includes('.') ? null : folder;
 }
 
-async function fetchAllThemes() {
-    const apiClient = await createApiClient();
-    const all = [];
-    let page = 1;
-
-    // Server ignores per_page; we walk every page until last_page is reached.
-    // Hard cap at 20 pages to avoid accidental infinite loops.
-    for (let i = 0; i < 20; i++) {
-        const response = await apiClient.get(`/theme?per_page=500&page=${page}`);
-        const batch = response.data || [];
-        all.push(...batch);
-
-        // Laravel paginator puts last_page at the top level (not under meta).
-        // Some envelopes wrap it under meta — support both.
-        const lastPage = response.last_page ?? response.meta?.last_page ?? 1;
-        if (page >= lastPage || batch.length === 0) break;
-        page++;
-    }
-
-    return all;
-}
-
 async function getThemeUuid(themeSlug) {
-    const themes = await fetchAllThemes();
+    const { themes } = await fetchAllThemes();
 
-    const theme = themes.find(t => slugify(t.name) === themeSlug);
+    const theme = themes.find(t => t.theme_folder === themeSlug)
+        ?? themes.find(t => slugify(t.name) === themeSlug);
 
     if (!theme) {
         throw new Error(`Tema bulunamadı: ${themeSlug}`);
@@ -81,20 +60,7 @@ async function pullAndSync(themeUuid, themePath) {
     console.log(chalk.yellow(t('dev.sync_pulling')));
     const response = await apiClient.download(`/theme/${themeUuid}/download`, {});
 
-    await fs.mkdir(themePath, {recursive: true});
-    const zipPath = path.join(themePath, 'theme.zip');
-    const writer = createWriteStream(zipPath);
-
-    response.data.pipe(writer);
-
-    await new Promise((resolve, reject) => {
-        writer.on('finish', resolve);
-        writer.on('error', reject);
-    });
-
-    const zip = new AdmZip(zipPath);
-    zip.extractAllTo(themePath, true);
-    await fs.unlink(zipPath);
+    await extractThemeArchive(response.data, themePath);
 
     console.log(chalk.green(t('dev.sync_updated')));
 
@@ -377,9 +343,8 @@ export async function themeDevCommand(themeName) {
         if (themeSlug && !themeName) {
             console.log(chalk.cyan(t('dev.active_site')) + ' ' + chalk.white(store));
 
-            const apiClient = await createApiClient();
             const tempThemeInfo = await getThemeUuid(themeSlug);
-            console.log(chalk.cyan(t('dev.active_theme')) + ' ' + chalk.white(`${themeSlug} (${tempThemeInfo.name} v${tempThemeInfo.version})`));
+            console.log(chalk.cyan(t('dev.active_theme')) + ' ' + chalk.white(`${slugify(tempThemeInfo.name)} (${tempThemeInfo.name} v${tempThemeInfo.version})`));
             console.log();
 
             const continueWithActive = await brandedConfirm({
@@ -388,8 +353,7 @@ export async function themeDevCommand(themeName) {
             }, t('dev.continue_title'));
 
             if (!continueWithActive) {
-                const response = await apiClient.get('/theme');
-                const themes = response.data || [];
+                const { themes } = await fetchAllThemes();
 
                 if (themes.length === 0) {
                     showWarning(t('dev.no_themes'));
@@ -407,12 +371,12 @@ export async function themeDevCommand(themeName) {
                     message: t('dev.select_theme_prompt'), choices: themeChoices
                 }, t('dev.select_theme_title'));
 
-                themeSlug = slugify(selectedTheme.name);
+                themeSlug = selectedTheme.theme_folder;
                 themeInfo = {
                     uuid: selectedTheme.theme_folder, name: selectedTheme.name, version: selectedTheme.version
                 };
 
-                await setActiveTheme(themeSlug);
+                await setActiveTheme(selectedTheme.theme_folder);
                 console.log();
             } else {
                 themeInfo = tempThemeInfo;
@@ -420,9 +384,7 @@ export async function themeDevCommand(themeName) {
         }
 
         if (!themeSlug) {
-            const apiClient = await createApiClient();
-            const response = await apiClient.get('/theme');
-            const themes = response.data || [];
+            const { themes } = await fetchAllThemes();
 
             if (themes.length === 0) {
                 showWarning(t('dev.no_themes'));
@@ -442,21 +404,23 @@ export async function themeDevCommand(themeName) {
                 uuid: selectedTheme.theme_folder, name: selectedTheme.name, version: selectedTheme.version
             };
 
-            await setActiveTheme(themeSlug);
+            await setActiveTheme(selectedTheme.theme_folder);
         } else if (!themeInfo) {
             themeInfo = await getThemeUuid(themeSlug);
         }
 
-        console.log(chalk.green(t('dev.active_theme_set', { slug: themeSlug })));
+        const themeDir = slugify(themeInfo.name);
+
+        console.log(chalk.green(t('dev.active_theme_set', { slug: themeDir })));
 
-        let themePath = path.join(getWorkspaceRoot(), storeSlug, themeSlug);
-        console.log(chalk.green(t('dev.working_dir', { path: `${storeSlug}/${themeSlug}/` }) + '\n'));
+        let themePath = path.join(getWorkspaceRoot(), storeSlug, themeDir);
+        console.log(chalk.green(t('dev.working_dir', { path: `${storeSlug}/${themeDir}/` }) + '\n'));
 
         // Fork check: foreign-org themes need fork before development
         {
             const apiClient = await createApiClient();
-            const orgResponse = await apiClient.get('/theme');
-            const currentTheme = (orgResponse.data || []).find(t => t.theme_folder === themeInfo.uuid);
+            const { themes: orgThemes, envelope: orgResponse } = await fetchAllThemes();
+            const currentTheme = orgThemes.find(t => t.theme_folder === themeInfo.uuid);
             const userOrg = orgResponse.user_organization;
 
             if (currentTheme && currentTheme.organization_id != null && userOrg && !userOrg.is_system && currentTheme.organization_id !== userOrg.id) {
@@ -480,8 +444,9 @@ export async function themeDevCommand(themeName) {
                 const forkedData = forkResult.data;
 
                 themeInfo = { uuid: forkedData.uuid, name: forkedData.name, version: forkedData.version };
-                themeSlug = slugify(forkedData.name);
-                themePath = path.join(getWorkspaceRoot(), storeSlug, themeSlug);
+                themePath = path.join(getWorkspaceRoot(), storeSlug, slugify(forkedData.name));
+
+                await setActiveTheme(forkedData.uuid);
 
                 console.log(chalk.green(t('dev.fork_success', { name: forkedData.name })));
                 console.log(chalk.gray('  ' + t('dev.fork_source', { source: forkedData.source.name, version: forkedData.source.version })));

package/src/commands/theme-init.js

@@ -1,21 +1,20 @@
 import chalk from 'chalk';
 import fs from 'fs/promises';
-import {createWriteStream} from 'fs';
 import path from 'path';
-import AdmZip from 'adm-zip';
 import {createApiClient} from '../api-client.js';
 import {slugify, getActiveStore, getWorkspaceRoot} from '../storage.js';
 import {brandedConfirm, brandedSelect, showWarning, showInfo, showError} from '../ui/prompt-wrapper.js';
+import {fetchAllThemes} from '../theme-list.js';
 import {normalizeStoreDomain} from '../storage.js';
 import {isJsonMode, jsonOut} from '../output-mode.js';
 import {mapError} from '../errors/error-mapper.js';
 import { t } from '../i18n.js';
+import {extractThemeArchive} from '../theme-download.js';
 
 export async function themeInitCommand(fromSlug) {
     try {
         const apiClient = await createApiClient();
-        const response = await apiClient.get('/theme');
-        const themes = response.data || [];
+        const { themes } = await fetchAllThemes(apiClient);
 
         let sourceTheme;
 
@@ -83,21 +82,15 @@ export async function themeInitCommand(fromSlug) {
 
         // Check if directory exists
         const exists = await fs.access(themePath).then(() => true).catch(() => false);
-        if (exists) {
-            if (isJsonMode()) {
-                // JSON modda otomatik overwrite
-                await fs.rm(themePath, { recursive: true, force: true });
-            } else {
-                const overwrite = await brandedConfirm({
-                    message: t('init.dir_exists_prompt', { path: themePath }),
-                    default: false,
-                }, t('init.dir_exists_title'));
-
-                if (!overwrite) {
-                    showWarning(t('init.dir_cancelled'));
-                    return;
-                }
-                await fs.rm(themePath, { recursive: true, force: true });
+        if (exists && !isJsonMode()) {
+            const overwrite = await brandedConfirm({
+                message: t('init.dir_exists_prompt', { path: themePath }),
+                default: false,
+            }, t('init.dir_exists_title'));
+
+            if (!overwrite) {
+                showWarning(t('init.dir_cancelled'));
+                return;
             }
         }
 
@@ -105,19 +98,9 @@ export async function themeInitCommand(fromSlug) {
         if (!isJsonMode()) {
             console.log(chalk.yellow(t('init.downloading')));
         }
-        await fs.mkdir(themePath, { recursive: true });
         const downloadResponse = await apiClient.download(`/theme/${forkedData.uuid}/download`, {});
-        const zipPath = path.join(themePath, 'theme.zip');
-        const writer = createWriteStream(zipPath);
-        downloadResponse.data.pipe(writer);
-        await new Promise((resolve, reject) => {
-            writer.on('finish', resolve);
-            writer.on('error', reject);
-        });
-
-        const zip = new AdmZip(zipPath);
-        zip.extractAllTo(themePath, true);
-        await fs.unlink(zipPath);
+
+        await extractThemeArchive(downloadResponse.data, themePath);
 
         // JSON mode success output
         if (isJsonMode()) {

package/src/commands/theme-section.js

@@ -1,13 +1,12 @@
 import chalk from 'chalk';
 import {checkbox} from '@inquirer/prompts';
 import fs from 'fs/promises';
-import {createWriteStream} from 'fs';
 import path from 'path';
-import AdmZip from 'adm-zip';
 import {createApiClient} from '../api-client.js';
 import {getActiveTheme, getThemeUuidBySlug, normalizeStoreDomain, getActiveStore, getWorkspaceRoot} from '../storage.js';
 import {brandedConfirm, brandedSelect, brandedSearch, brandedInput, showWarning, showSuccess, showInfo} from '../ui/prompt-wrapper.js';
 import { t } from '../i18n.js';
+import {mergeThemeArchive} from '../theme-download.js';
 
 const SECTION_NAME_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
 
@@ -294,31 +293,13 @@ export async function themeSectionAddCommand() {
             const themePath = path.join(getWorkspaceRoot(), storeSlug, activeTheme);
 
             try {
-                // Tema klasörü henüz lokalde yoksa (theme dev/pull yapılmamışsa)
-                // createWriteStream ENOENT verir — önce dizini garantiye al.
-                await fs.mkdir(themePath, { recursive: true });
-
                 // Temayı indir
                 const downloadResponse = await apiClient.download(`/theme/${themeInfo.uuid}/download`, {});
 
-                const zipPath = path.join(themePath, 'theme-update.zip');
-                const writer = createWriteStream(zipPath);
-
-                downloadResponse.data.pipe(writer);
-
-                await new Promise((resolve, reject) => {
-                    writer.on('finish', resolve);
-                    writer.on('error', reject);
-                });
-
                 console.log(chalk.green(t('section.add.files_downloaded')));
                 console.log(chalk.yellow(t('section.add.files_updating')));
 
-                // Extract
-                const zip = new AdmZip(zipPath);
-                zip.extractAllTo(themePath, true);
-
-                await fs.unlink(zipPath);
+                await mergeThemeArchive(downloadResponse.data, themePath);
 
                 console.log(chalk.green(t('section.add.files_updated') + '\n'));
                 console.log(chalk.bold.green(t('section.add.complete')));
@@ -337,24 +318,9 @@ export async function themeSectionAddCommand() {
 }
 
 async function downloadThemeFiles(apiClient, themeUuid, themePath) {
-    await fs.mkdir(themePath, { recursive: true });
-
     const downloadResponse = await apiClient.download(`/theme/${themeUuid}/download`, {});
 
-    const zipPath = path.join(themePath, 'theme-update.zip');
-    const writer = createWriteStream(zipPath);
-
-    downloadResponse.data.pipe(writer);
-
-    await new Promise((resolve, reject) => {
-        writer.on('finish', resolve);
-        writer.on('error', reject);
-    });
-
-    const zip = new AdmZip(zipPath);
-    zip.extractAllTo(themePath, true);
-
-    await fs.unlink(zipPath);
+    await mergeThemeArchive(downloadResponse.data, themePath);
 }
 
 export async function themeSectionCreateCommand() {

package/src/commands/theme.js

@@ -1,16 +1,16 @@
 import chalk from 'chalk';
 import {input} from '@inquirer/prompts';
 import fs from 'fs/promises';
-import {createWriteStream} from 'fs';
 import path from 'path';
-import AdmZip from 'adm-zip';
 import {createApiClient} from '../api-client.js';
 import {normalizeStoreDomain, slugify, setActiveTheme, getActiveTheme, getActiveStore, getWorkspaceRoot, getWorkspaceContext} from '../storage.js';
 import {brandedConfirm, brandedSelect, brandedSearch, showWarning} from '../ui/prompt-wrapper.js';
+import {fetchAllThemes} from '../theme-list.js';
 import {themeLabels, decorateThemeName} from '../ui/theme-choice.js';
 import { isJsonMode, jsonOut } from '../output-mode.js';
 import { mapError } from '../errors/error-mapper.js';
 import { t } from '../i18n.js';
+import {extractThemeArchive} from '../theme-download.js';
 
 const THEME_SEARCH_THRESHOLD = 7;
 
@@ -20,10 +20,7 @@ export async function themeListCommand() {
             console.log(chalk.cyan(t('theme.listing') + '\n'));
         }
 
-        const apiClient = await createApiClient();
-        const response = await apiClient.get('/theme');
-
-        const themes = response.data || [];
+        const { themes } = await fetchAllThemes();
 
         if (isJsonMode()) {
             jsonOut({
@@ -291,37 +288,20 @@ export async function themeCreateCommand(themeName) {
 
         const response = await apiClient.download('/theme/default/download', downloadParams);
 
-        await fs.mkdir(themePath, {recursive: true});
-
-        const zipPath = path.join(themePath, 'theme.zip');
-        const writer = createWriteStream(zipPath);
-
-        response.data.pipe(writer);
-
-        writer.on('finish', async () => {
-            console.log(chalk.green(t('theme.files_downloaded')));
-            console.log(chalk.yellow(t('theme.extracting')));
-
-            const zip = new AdmZip(zipPath);
-            zip.extractAllTo(themePath, true);
-
-            await fs.unlink(zipPath);
+        console.log(chalk.green(t('theme.files_downloaded')));
+        console.log(chalk.yellow(t('theme.extracting')));
 
-            console.log(chalk.green(t('theme.extracted', { path: `${storeSlug}/${themeSlug}/` })));
+        await extractThemeArchive(response.data, themePath);
 
-            await setActiveTheme(themeSlug);
-            console.log(chalk.green(t('theme.active_set') + '\n'));
+        console.log(chalk.green(t('theme.extracted', { path: `${storeSlug}/${themeSlug}/` })));
 
-            console.log(chalk.bold.green(t('theme.create_success')));
-            console.log(chalk.gray('   ' + t('theme.create_location', { path: `${storeSlug}/${themeSlug}/` }) + '\n'));
-            console.log(chalk.cyan(t('theme.dev_start_tip')));
-            console.log(chalk.white('  tsoft theme dev\n'));
-        });
+        await setActiveTheme(themeSlug);
+        console.log(chalk.green(t('theme.active_set') + '\n'));
 
-        writer.on('error', (error) => {
-            console.error(chalk.red('❌ Hata: ' + t('theme.file_write_error')), error.message);
-            process.exit(1);
-        });
+        console.log(chalk.bold.green(t('theme.create_success')));
+        console.log(chalk.gray('   ' + t('theme.create_location', { path: `${storeSlug}/${themeSlug}/` }) + '\n'));
+        console.log(chalk.cyan(t('theme.dev_start_tip')));
+        console.log(chalk.white('  tsoft theme dev\n'));
 
     } catch (error) {
         console.error(chalk.red('\n❌ Hata: ') + error.message);
@@ -344,9 +324,7 @@ export async function themePullCommand() {
         console.log(chalk.cyan(t('theme.pull.starting') + '\n'));
 
         const apiClient = await createApiClient();
-        const response = await apiClient.get('/theme');
-
-        const themes = response.data || [];
+        const { themes } = await fetchAllThemes(apiClient);
 
         if (themes.length === 0) {
             showWarning(t('theme.pull.no_themes'));
@@ -389,33 +367,16 @@ export async function themePullCommand() {
                 showWarning(t('theme.cancelled'));
                 return;
             }
-
-            await fs.rm(themePath, {recursive: true, force: true});
         }
 
         console.log(chalk.yellow(t('theme.downloading_files')));
 
         const downloadResponse = await apiClient.download(`/theme/${themeUuid}/download`, {});
 
-        await fs.mkdir(themePath, {recursive: true});
-
-        const zipPath = path.join(themePath, 'theme.zip');
-        const writer = createWriteStream(zipPath);
-
-        downloadResponse.data.pipe(writer);
-
-        await new Promise((resolve, reject) => {
-            writer.on('finish', resolve);
-            writer.on('error', reject);
-        });
-
         console.log(chalk.green(t('theme.files_downloaded')));
         console.log(chalk.yellow(t('theme.extracting')));
 
-        const zip = new AdmZip(zipPath);
-        zip.extractAllTo(themePath, true);
-
-        await fs.unlink(zipPath);
+        await extractThemeArchive(downloadResponse.data, themePath);
 
         console.log(chalk.green(t('theme.extracted', { path: `${storeSlug}/${themeSlug}/` })));
 
@@ -445,9 +406,7 @@ export async function themeUseCommand(themeName = null) {
             console.log(chalk.gray(t('theme.use.on_store', { store })) + '\n');
         }
 
-        const apiClient = await createApiClient();
-        const response = await apiClient.get('/theme');
-        const themes = response.data || [];
+        const { themes } = await fetchAllThemes();
 
         if (themes.length === 0) {
             showWarning(t('theme.use.no_themes'));
@@ -458,7 +417,8 @@ export async function themeUseCommand(themeName = null) {
 
         if (themeName) {
             const themeSlug = slugify(themeName);
-            selectedTheme = themes.find(t => slugify(t.name) === themeSlug);
+            selectedTheme = themes.find(t => t.theme_folder === themeName)
+                ?? themes.find(t => slugify(t.name) === themeSlug);
 
             if (!selectedTheme) {
                 console.error(chalk.red('\n' + t('theme.use.not_found', { name: themeName })));

package/src/storage.js

@@ -735,10 +735,8 @@ export async function resolveActiveThemeUuid() {
  * @returns {Promise<Object>} {uuid, name, version, active}
  */
 export async function getThemeUuidBySlug(themeSlug) {
-    const { createApiClient } = await import('./api-client.js');
-    const apiClient = await createApiClient();
-    const response = await apiClient.get('/theme');
-    const themes = response.data || [];
+    const { fetchAllThemes } = await import('./theme-list.js');
+    const { themes } = await fetchAllThemes();
 
     const theme = themes.find(t => t.theme_folder === themeSlug)
         ?? themes.find(t => slugify(t.name) === themeSlug);

package/src/theme-download.js

@@ -0,0 +1,99 @@
+import fs from 'fs/promises';
+import { createWriteStream } from 'fs';
+import path from 'path';
+import { pipeline } from 'stream/promises';
+import AdmZip from 'adm-zip';
+
+async function stageArchive(stream, stagingPath) {
+    const zipPath = path.join(stagingPath, 'theme.zip');
+
+    await pipeline(stream, createWriteStream(zipPath));
+
+    const { size } = await fs.stat(zipPath);
+
+    if (size === 0) {
+        throw new Error('EMPTY_ARCHIVE');
+    }
+
+    const zip = new AdmZip(zipPath);
+    zip.extractAllTo(stagingPath, true);
+
+    await fs.rm(zipPath, { force: true });
+}
+
+/**
+ * Tema arşivini indirir, doğrular ve ancak ondan sonra hedefin üzerine açar.
+ *
+ * Hedefteki dosyalar silinmez; arşivdekiler üzerine yazılır. Bozuk veya yarım
+ * inen bir arşiv hedefe hiç dokunmaz.
+ *
+ * @param {import('stream').Readable} stream - Arşiv veri akışı
+ * @param {string} themePath - Arşivin açılacağı dizin
+ * @returns {Promise<void>}
+ */
+export async function mergeThemeArchive(stream, themePath) {
+    await fs.mkdir(themePath, { recursive: true });
+
+    const staging = await fs.mkdtemp(path.join(themePath, '.tsoft-update-'));
+
+    try {
+        const zipPath = path.join(staging, 'theme.zip');
+
+        await pipeline(stream, createWriteStream(zipPath));
+
+        const { size } = await fs.stat(zipPath);
+
+        if (size === 0) {
+            throw new Error('EMPTY_ARCHIVE');
+        }
+
+        const zip = new AdmZip(zipPath);
+        zip.extractAllTo(themePath, true);
+    } finally {
+        await fs.rm(staging, { recursive: true, force: true });
+    }
+}
+
+/**
+ * Tema arşivini indirir, doğrular ve ancak ondan sonra hedefin üzerine koyar.
+ *
+ * Arşiv hedefin yanındaki geçici dizine açılır; indirme yarıda koparsa veya
+ * arşiv bozuksa hedef dizine dokunulmaz. Böylece başarısız bir indirme
+ * kullanıcının mevcut tema dosyalarını silmez.
+ *
+ * @param {import('stream').Readable} stream - Arşiv veri akışı
+ * @param {string} themePath - Temanın açılacağı hedef dizin
+ * @returns {Promise<void>}
+ */
+export async function extractThemeArchive(stream, themePath) {
+    const parent = path.dirname(themePath);
+    await fs.mkdir(parent, { recursive: true });
+
+    const staging = await fs.mkdtemp(path.join(parent, `.${path.basename(themePath)}-`));
+    const backup = `${staging}-previous`;
+
+    try {
+        await stageArchive(stream, staging);
+    } catch (error) {
+        await fs.rm(staging, { recursive: true, force: true });
+        throw error;
+    }
+
+    const hadPrevious = await fs.access(themePath).then(() => true).catch(() => false);
+
+    if (hadPrevious) {
+        await fs.rename(themePath, backup);
+    }
+
+    try {
+        await fs.rename(staging, themePath);
+    } catch (error) {
+        if (hadPrevious) {
+            await fs.rename(backup, themePath);
+        }
+        await fs.rm(staging, { recursive: true, force: true });
+        throw error;
+    }
+
+    await fs.rm(backup, { recursive: true, force: true });
+}

package/src/theme-list.js

@@ -0,0 +1,25 @@
+import { createApiClient } from './api-client.js';
+
+export async function fetchAllThemes(client = null) {
+    const apiClient = client ?? await createApiClient();
+    const all = [];
+    let envelope = {};
+    let page = 1;
+
+    // Server ignores per_page; we walk every page until last_page is reached.
+    // Hard cap at 20 pages to avoid accidental infinite loops.
+    for (let i = 0; i < 20; i++) {
+        const response = await apiClient.get(`/theme?per_page=500&page=${page}`);
+        const batch = response.data || [];
+        all.push(...batch);
+        envelope = response;
+
+        // Laravel paginator puts last_page at the top level (not under meta).
+        // Some envelopes wrap it under meta — support both.
+        const lastPage = response.last_page ?? response.meta?.last_page ?? 1;
+        if (page >= lastPage || batch.length === 0) break;
+        page++;
+    }
+
+    return { themes: all, envelope };
+}