@shoper/cli 0.8.0 → 0.8.1-10

package/README.md

@@ -2,14 +2,4 @@
 
 # Shoper CLI
 
-Learn more in the [commands docs](https://storefront.developers.shoper.pl/cli/)
-
-## Features
-
-### .shoperignore
-
-Plik `.shoperignore` pozwala na wykluczenie określonych plików i katalogów z pakowania, uploadowania oraz weryfikacji checksum.
-
-Używa tej samej składni co `.gitignore`. Plik jest automatycznie tworzony podczas inicjalizacji lub pobierania motywu.
-
-Więcej informacji: [SHOPERIGNORE.md](docs/SHOPERIGNORE.md)
+Learn more in the [commands docs](https://storefront.developers.shoper.pl/cli/)

package/build/cli/class/errors/http/http_errors_factory.js

@@ -15,7 +15,7 @@ export class HttpErrorsFactory {
     }
     static createNotFoundError() {
         return new AppError({
-            message: 'Not found',
+            message: '404 Not found',
             code: HTTP_NOT_FOUND_ERROR_CODE
         });
     }

package/build/cli/core/cli_setup.js

@@ -29,7 +29,7 @@ export const cliSetup = async () => {
             LoggerInitializer,
             CliAuthTokensInitializer,
             CliAuthInitializer,
-            ...getCommandBaseInitializers()
+            ...getInitializersBasedOnCommand()
         ],
         options: {
             featuresTracking: false,
@@ -37,15 +37,15 @@ export const cliSetup = async () => {
         }
     });
 };
-const getCommandBaseInitializers = () => {
-    if (isCommandsTopic(process.argv[2]))
-        return getCommandWithTopicBaseInitializers();
+const getInitializersBasedOnCommand = () => {
+    if (isCommandWithTopic(process.argv[2]))
+        return getInitializersBasedOnCommandWithTopic();
     return [];
 };
-const isCommandsTopic = (arg) => {
+const isCommandWithTopic = (arg) => {
     return arg === THEME_TOPIC_NAME || arg === CLI_AUTH_TOPIC_NAME;
 };
-const getCommandWithTopicBaseInitializers = () => {
+const getInitializersBasedOnCommandWithTopic = () => {
     const topic = process.argv[2];
     const command = process.argv[3];
     switch (topic) {

package/build/cli/index.js

@@ -6,6 +6,7 @@ export const runCLI = async () => {
         await execute({ dir: import.meta.url });
     }
     catch (error) {
+        console.log('Error executing CLI command:', error);
         // TODO handle error
     }
 };

package/build/cli/utilities/features/logger/logs/app_logs_constants.js

@@ -3,5 +3,6 @@ export const APP_LOGS_TYPES = {
     error: 'error',
     warn: 'warn',
     info: 'info',
-    debug: 'debug'
+    debug: 'debug',
+    success: 'success'
 };

package/build/index.js

@@ -31,7 +31,7 @@ process.on('uncaughtException', (err) => {
     const loggerApi = getApiSync(LOGGER_API_NAME);
     if (loggerApi)
         loggerApi.fatal('Uncaught Exception', { error: err });
-    process.exit(1);
+    // process.exit(1);
 });
 process.on('unhandledRejection', (reason) => {
     console.error('Unhandled Rejection:', reason);
@@ -42,7 +42,7 @@ process.on('unhandledRejection', (reason) => {
                 reason
             }
         });
-    process.exit(1);
+    // process.exit(1);
 });
 const signals = ['SIGINT', 'SIGTERM', 'SIGQUIT'];
 signals.forEach((signal) => {

package/build/theme/class/archive/theme_archive.js

@@ -1,47 +1 @@
-import globs from 'fast-glob';
-import { createZip } from '../../../utils/zip/create_zip_utils.js';
-import { ThemeFilesStructureUtils } from '../../features/theme/utils/files_structure/theme_files_structure_utils.js';
-import { extname, join } from '../../../utils/path_utils.js';
-import { formatJSONFile } from '../../../utils/fs/fs_utils.js';
-import { ThemeArchiveErrorsFactory } from './theme_archive_errors_factory.js';
-import { ThemeFileStructureErrorsFactory } from '../../features/theme/utils/files_structure/theme_file_structure_errors_factory.js';
-import { ThemeActionsUtils } from '../../features/theme/actions/theme_actions_utils.js';
-import { filterFiles } from '../../utils/shoperignore/shoperignore_utils.js';
-export class ThemeArchive {
-    #themeRootDir;
-    constructor(themeRootDir) {
-        this.#themeRootDir = themeRootDir;
-    }
-    async createFullArchive({ dist, actionValue, actionType, logger }) {
-        const filesStructure = await ThemeFilesStructureUtils.getThemeFilesStructure(this.#themeRootDir);
-        if (!filesStructure)
-            throw ThemeFileStructureErrorsFactory.createNoFilesStructureError();
-        try {
-            const filesInThemeDirectory = await globs(ThemeActionsUtils.getFilesGlobsThatMatchesActionName({
-                actionType,
-                actionValue,
-                filesStructure
-            }), {
-                suppressErrors: true,
-                onlyFiles: true,
-                cwd: this.#themeRootDir
-            });
-            const filteredFiles = await filterFiles(filesInThemeDirectory, this.#themeRootDir);
-            await this._formatJsonFiles(this.#themeRootDir, filteredFiles);
-            await createZip({
-                baseDir: this.#themeRootDir,
-                dist,
-                files: filteredFiles,
-                logger
-            });
-        }
-        catch (err) {
-            throw ThemeArchiveErrorsFactory.createErrorWhileCreatingThemeArchive(err);
-        }
-    }
-    async _formatJsonFiles(themeRootDir, filesToUpload) {
-        await Promise.all(filesToUpload
-            .filter((path) => extname(path).toLowerCase() === '.json')
-            .map((jsonFile) => formatJSONFile(join(themeRootDir, jsonFile))));
-    }
-}
+export {};

package/build/theme/class/browser/browser.js

@@ -0,0 +1,114 @@
+import puppeteer from 'puppeteer';
+import { v4 as uuid } from 'uuid';
+export class Browser {
+    #browser = null;
+    #tabs = new Map();
+    #onError;
+    #onInfo;
+    #onDisconnected;
+    constructor({ onError, onInfo, onDisconnected } = {}) {
+        this.#onError = onError;
+        this.#onInfo = onInfo;
+        this.#onDisconnected = onDisconnected;
+    }
+    async launch() {
+        this.#onInfo?.(`Launching browser...`);
+        try {
+            if (!this.#browser) {
+                this.#onInfo?.(`Launching browser...`);
+                this.#browser = await puppeteer.launch({
+                    headless: false,
+                    defaultViewport: null,
+                    args: process.platform === 'linux' ? ['--no-sandbox'] : []
+                });
+                this.#browser.on('disconnected', () => {
+                    this.#onDisconnected?.('Browser disconnected');
+                    this.#browser = null;
+                    this.#tabs.clear();
+                });
+            }
+        }
+        catch (error) {
+            this.#onError?.(`Error launch browser:`, error);
+            throw error;
+        }
+    }
+    async openTab(url, tabId) {
+        try {
+            if (!this.#browser || !this.isBrowserOpen()) {
+                this.#onInfo?.(`Browser not open, launching browser...`);
+                await this.launch();
+            }
+            if (!this.#browser)
+                return;
+            const id = tabId ?? `tab-${uuid()}`;
+            this.#onInfo?.(`Opening new tab ${id}: ${url}`);
+            const page = await this.#browser.newPage();
+            await page.setCacheEnabled(false);
+            await page.goto(url, { waitUntil: 'networkidle2' });
+            this.#tabs.set(id, { page, url });
+            this.#onInfo?.(`Tab ${id} opened successfully`);
+        }
+        catch (error) {
+            this.#onError?.(`Error opening tab:`, error);
+            throw error;
+        }
+    }
+    async refresh(tabId) {
+        const tab = this.#tabs.get(tabId);
+        if (!tab) {
+            this.#onError?.(`Tab ${tabId} not found`);
+            return;
+        }
+        try {
+            this.#onInfo?.(`Refreshing tab ${tabId}...`);
+            await tab.page.reload({ waitUntil: 'networkidle2' });
+            this.#onInfo?.(`Tab ${tabId} refreshed`);
+        }
+        catch (error) {
+            this.#onError?.(`Error refreshing tab ${tabId}:`, error);
+            throw error;
+        }
+    }
+    async refreshAll() {
+        const openTabs = this.getOpenTabs();
+        await Promise.allSettled(openTabs.map((tabId) => this.refresh(tabId)));
+    }
+    async closeTab(tabId) {
+        const tab = this.#tabs.get(tabId);
+        if (!tab) {
+            this.#onError?.(`Tab ${tabId} not found`);
+            return;
+        }
+        try {
+            await tab.page.close();
+            this.#tabs.delete(tabId);
+            this.#onInfo?.(`Tab ${tabId} closed`);
+        }
+        catch (error) {
+            this.#onError?.(`Error closing tab ${tabId}:`, error);
+            throw error;
+        }
+    }
+    async close() {
+        if (!this.isBrowserOpen())
+            return;
+        await this.#browser?.close();
+        this.#browser = null;
+        this.#tabs.clear();
+        this.#onInfo?.('Browser closed with all tabs');
+    }
+    isBrowserOpen() {
+        return this.#browser !== null && this.#browser.connected;
+    }
+    isTabOpen(tabId) {
+        const tab = this.#tabs.get(tabId);
+        return tab !== undefined && !tab.page.isClosed();
+    }
+    getOpenTabs() {
+        return Array.from(this.#tabs.keys()).filter((tabId) => this.isTabOpen(tabId));
+    }
+    getTabUrl(tabId) {
+        return this.#tabs.get(tabId)?.url ?? null;
+    }
+}

package/build/theme/class/checksums/theme_checksums.js

@@ -10,6 +10,7 @@ import { normalize } from 'node:path';
 import { ThemePushUtils } from '../../features/theme/push/theme_push_utils.js';
 import { SHOPER_THEME_METADATA_DIR } from '../../constants/directory_contstants.js';
 import { THEME_CURRENT_CHECKSUMS_FILE_NAME, THEME_CURRENT_CHECKSUMS_VERITY_FILE_NAME, THEME_INITIAL_CHECKSUMS_FILE_NAME, THEME_INITIAL_CHECKSUMS_VERITY_FILE_NAME } from '../../features/theme/theme_constants.js';
+import { FILE_STATES } from '../../../utils/fs/fs_constants.js';
 export class ThemeChecksums {
     #themeDir;
     #loggerApi;
@@ -33,12 +34,6 @@ export class ThemeChecksums {
         this.#initialChecksums = await this._getChecksums(this.#initialChecksumsFilePath);
         return this.#initialChecksums;
     }
-    getInitialChecksumsSync() {
-        if (this.#initialChecksums)
-            return this.#initialChecksums;
-        this.#initialChecksums = this._getChecksumsSync(this.#initialChecksumsFilePath);
-        return this.#initialChecksums;
-    }
     async getCurrentChecksums() {
         if (this.#currentChecksums)
             return this.#currentChecksums;
@@ -72,10 +67,22 @@ export class ThemeChecksums {
         const initialChecksum = await this.getInitialChecksumFromPath(path);
         return !initialChecksum && (await fileExists(join(this.#themeDir, path)));
     }
-    async hasThemeFileBeenModified(path) {
-        const currentChecksum = await this.getCurrentChecksumFromPath(path);
+    async getFileState(path) {
         const initialChecksum = await this.getInitialChecksumFromPath(path);
-        return !!currentChecksum && !!initialChecksum && currentChecksum !== initialChecksum;
+        const currentChecksum = await this.getCurrentChecksumFromPath(path);
+        const fileExistsInFs = await fileExists(join(this.#themeDir, path));
+        if (!initialChecksum && fileExistsInFs) {
+            return FILE_STATES.created;
+        }
+        else if (initialChecksum && !fileExistsInFs) {
+            return FILE_STATES.deleted;
+        }
+        else if (initialChecksum && currentChecksum && initialChecksum !== currentChecksum) {
+            return FILE_STATES.modified;
+        }
+        else {
+            return FILE_STATES.unchanged;
+        }
     }
     async verify() {
         const initialChecksumFilePath = this.#initialChecksumsFilePath;
@@ -87,6 +94,8 @@ export class ThemeChecksums {
     async updateAllChecksums() {
         this.#loggerApi?.debug('Updating all checksums.');
         const checksums = await this.computeThemeChecksums();
+        this.#initialChecksums = checksums;
+        this.#currentChecksums = checksums;
         return new Promise((resolve, reject) => {
             const currentChecksumFilePath = this.#currentChecksumsFilePath;
             const initialChecksumFilePath = this.#initialChecksumsFilePath;
@@ -114,6 +123,7 @@ export class ThemeChecksums {
     async updateCurrentChecksums() {
         this.#loggerApi?.debug('Updating current checksums.');
         const checksums = await this.computeThemeChecksums();
+        this.#currentChecksums = checksums;
         return new Promise((resolve, reject) => {
             const currentChecksumFilePath = this.#currentChecksumsFilePath;
             const checksumStream = createWriteStream(currentChecksumFilePath);
@@ -144,8 +154,7 @@ export class ThemeChecksums {
             join(SHOPER_THEME_METADATA_DIR, THEME_INITIAL_CHECKSUMS_FILE_NAME),
             join(SHOPER_THEME_METADATA_DIR, THEME_INITIAL_CHECKSUMS_VERITY_FILE_NAME)
         ];
-        const allFiles = await ThemePushUtils.getAllFilesThatAreSendToRemote(this.#themeDir);
-        const filesToComputeChecksums = allFiles
+        const filesToComputeChecksums = (await ThemePushUtils.getAllFilesThatAreSendToRemote(this.#themeDir))
             .filter((path) => !filesToIgnoreInChecksums.some((ignorePath) => normalize(path) === ignorePath))
             .map((relativePath) => join(this.#themeDir, relativePath));
         this.#loggerApi?.debug('Computing checksums from file structure.', { details: { count: filesToComputeChecksums.length } });
@@ -155,6 +164,37 @@ export class ThemeChecksums {
         this.#loggerApi?.debug('Finished computing theme checksums.', { details: { count: Object.keys(allChecksums).length } });
         return allChecksums;
     }
+    async groupFilesByStatus(files) {
+        const initialChecksums = await this.getInitialChecksums();
+        const currentChecksums = await this.getCurrentChecksums();
+        return files.reduce((acc, filePath) => {
+            const initialChecksum = initialChecksums[toCurrentPlatformPath(filePath)];
+            const currentChecksum = currentChecksums[toCurrentPlatformPath(filePath)];
+            if (!initialChecksum) {
+                acc.created.push(filePath);
+            }
+            else if (currentChecksum && initialChecksum !== currentChecksum) {
+                acc.modified.push(filePath);
+            }
+            else if (initialChecksum && !currentChecksum) {
+                acc.deleted.push(filePath);
+            }
+            else {
+                acc.unchanged.push(filePath);
+            }
+            return acc;
+        }, {
+            created: [],
+            modified: [],
+            unchanged: [],
+            deleted: []
+        });
+    }
+    async getDeletedFiles() {
+        const initialChecksums = await this.getInitialChecksums();
+        const currentChecksums = await this.getCurrentChecksums();
+        return Object.keys(initialChecksums).filter((filePath) => !currentChecksums[filePath]);
+    }
     async _getInitialChecksumsVerification() {
         return await readJSONFile(this.#initialChecksumsVerificationFilePath);
     }

package/build/theme/commands/pull/theme_pull_command.js

@@ -24,8 +24,9 @@ import { Info } from '../../../ui/message_box/info.js';
 import { directoryExists } from '../../../utils/fs/fs_utils.js';
 import { ThemeMetaDataUtils } from '../../features/theme/utils/meta_data/theme_meta_data_utils.js';
 import { ThemeChecksums } from '../../class/checksums/theme_checksums.js';
-import { ThemeError } from '../ui/theme_error.js';
 import { LOGGER_API_NAME } from '../../../cli/utilities/features/logger/logger_constants.js';
+import { ThemeError } from '../ui/theme_error.js';
+import { MODULES_DIRECTORY_NAME } from '../../features/theme/theme_constants.js';
 //TODO jak jest error w pullu wowczas usuwamy docelowo pociagniety skin
 export class ThemePullCommand extends BaseThemeCommand {
     static summary = 'Downloads the current version of your theme from the store and overwrites your local theme files.';
@@ -160,9 +161,9 @@ export class ThemePullCommand extends BaseThemeCommand {
                 dist: tmpDir
             }
         });
-        const localModulesPath = join(executionContext.themeRootDir, 'modules');
+        const localModulesPath = join(executionContext.themeRootDir, MODULES_DIRECTORY_NAME);
         const fetchedThemePath = join(tmpDir, name);
-        const fetchedModulesPath = join(fetchedThemePath, 'modules');
+        const fetchedModulesPath = join(fetchedThemePath, MODULES_DIRECTORY_NAME);
         if ((await directoryExists(localModulesPath)) && (await directoryExists(fetchedModulesPath)))
             await ThemeResourcesWithIdDirectoryUtils.updateDirectoryNamesOfResourcesWithIdAccordingToLocalThemeNames(localModulesPath, fetchedModulesPath, fetchedThemePath, loggerApi);
         this.#spinner.stop();

package/build/theme/commands/push/theme_push_command.js

@@ -4,8 +4,6 @@ import { EXECUTION_CONTEXT_API_NAME, EXECUTION_CONTEXTS } from '../../../cli/fea
 import { THEME_ACTIONS_API_NAME, THEME_ACTIONS_TYPES } from '../../features/theme/actions/theme_actions_constants.js';
 import { THEME_PUSH_API_NAME } from '../../features/theme/push/theme_push_constants.js';
 import { ThemeMetaDataUtils } from '../../features/theme/utils/meta_data/theme_meta_data_utils.js';
-import { mapChecksumToTree } from '../../../utils/checksums/checksums_utils.js';
-import { mapToPermissionsTree } from '../../utils/directory_validator/directory_validator_utils.js';
 import { renderOnce } from '../../../ui/ui_utils.js';
 import { UnpermittedCommandError } from '../ui/unpermitted_command_error.js';
 import React from 'react';
@@ -14,7 +12,7 @@ import { MissingCredentialsError } from '../../../cli/commands/auth/ui/missing_c
 import { ThemePushedSuccess } from './ui/theme_pushed_success.js';
 import ora from 'ora';
 import { ThemePushSkipInfo } from './ui/theme_push_skip_into.js';
-import { ThemeFilesStructureUtils } from '../../features/theme/utils/files_structure/theme_files_structure_utils.js';
+import { ThemeFilesUtils } from '../../features/theme/utils/files/theme_files_utils.js';
 import { ThemeInfoUtils } from '../../features/theme/info/theme_info_utils.js';
 import { ThemeChecksums } from '../../class/checksums/theme_checksums.js';
 import { ThemeFilesUpload } from '../../class/files_upload/theme_files_upload.js';
@@ -24,6 +22,8 @@ import { MissingThemeFiles } from '../ui/missing_theme_files.js';
 import { SHOPER_THEME_METADATA_DIR } from '../../constants/directory_contstants.js';
 import { THEME_FILES_STRUCTURE_FILE_NAME } from '../../features/theme/theme_constants.js';
 import { ThemeError } from '../ui/theme_error.js';
+import { mapToPermissionsTree } from '../../utils/directory_validator/directory_validator_utils.js';
+import { mapChecksumToTree } from '../../../utils/checksums/checksums_utils.js';
 import { ThemeUnpermittedActionsError } from './ui/theme_unpermitted_actions_error.js';
 import { LOGGER_API_NAME } from '../../../cli/utilities/features/logger/logger_constants.js';
 export class ThemePushCommand extends BaseThemeCommand {
@@ -68,7 +68,7 @@ export class ThemePushCommand extends BaseThemeCommand {
                 return;
             }
             const initialChecksums = await themeChecksums.getInitialChecksums();
-            const permissions = await ThemeFilesStructureUtils.getFilesPermissions(executionContext.themeRootDir);
+            const permissions = await ThemeFilesUtils.getFilesPermissions(executionContext.themeRootDir);
             const themeFilesUploadApi = new ThemeFilesUpload({
                 themeRootDir: executionContext.themeRootDir,
                 credentials,
@@ -80,7 +80,7 @@ export class ThemePushCommand extends BaseThemeCommand {
                 renderOnce(React.createElement(ThemePushSkipInfo, null));
                 return;
             }
-            const validationResult = await ThemeFilesStructureUtils.validateThemeDirectoryStructure({
+            const validationResult = await ThemeFilesUtils.validateThemeDirectoryStructure({
                 //TDO przeniesc do theme checksums
                 checksums: mapChecksumToTree(initialChecksums),
                 permissions: mapToPermissionsTree(permissions),
@@ -92,16 +92,25 @@ export class ThemePushCommand extends BaseThemeCommand {
                 renderOnce(React.createElement(ThemeUnpermittedActionsError, { unpermittedActions: validationResult.unpermittedActions }));
                 return;
             }
-            const filesStructure = await ThemeFilesStructureUtils.getThemeFilesStructure(executionContext.themeRootDir);
+            const filesStructure = await ThemeFilesUtils.getThemeFilesStructure(executionContext.themeRootDir);
             if (!filesStructure) {
                 renderOnce(React.createElement(MissingThemeFiles, { files: `${SHOPER_THEME_METADATA_DIR}/${THEME_FILES_STRUCTURE_FILE_NAME}` }));
                 return;
             }
             spinner = ora('Pushing theme...').start();
-            await themePushApi.push({
+            const partialPushAction = themeActionsApi.getThemeAction({
+                actionType: THEME_ACTIONS_TYPES.partialPush,
+                themeId: executionContext.themeId,
+                credentials
+            });
+            if (!pushAction) {
+                renderOnce(React.createElement(UnpermittedCommandError, { themeId: executionContext.themeId, commandName: "push" }));
+                return;
+            }
+            await themePushApi.partialPush({
                 credentials,
                 filesStructure,
-                pushAction,
+                action: partialPushAction,
                 themeChecksums,
                 executionContext,
                 themeFilesUploadApi

package/build/theme/commands/theme_commands_constants.js

@@ -7,5 +7,6 @@ export const THEME_COMMANDS_NAME = {
     verify: `${THEME_TOPIC_NAME}:verify`,
     info: `${THEME_TOPIC_NAME}:info`,
     delete: `${THEME_TOPIC_NAME}:delete`,
-    publish: `${THEME_TOPIC_NAME}:publish`
+    publish: `${THEME_TOPIC_NAME}:publish`,
+    watch: `${THEME_TOPIC_NAME}:watch`
 };

package/build/theme/commands/theme_verify_command.js

@@ -1,7 +1,6 @@
 import { BaseThemeCommand } from '../class/base_theme_command.js';
 import { CLI_AUTH_API_NAME } from '../../cli/auth/cli_auth_constants.js';
 import { EXECUTION_CONTEXT_API_NAME, EXECUTION_CONTEXTS } from '../../cli/features/execution_context/execution_context_constants.js';
-import { ThemeFilesStructureUtils } from '../features/theme/utils/files_structure/theme_files_structure_utils.js';
 import { ThemeChecksums } from '../class/checksums/theme_checksums.js';
 import { THEME_VERIFY_API_NAME } from '../features/theme/verify/theme_verify_constants.js';
 import { THEME_ACTIONS_API_NAME, THEME_ACTIONS_TYPES } from '../features/theme/actions/theme_actions_constants.js';
@@ -18,6 +17,7 @@ import { MissingCredentialsError } from '../../cli/commands/auth/ui/missing_cred
 import { OutsideOfThemeDirectoryContextError } from './ui/ouside_of_theme_directory_context_error.js';
 import ora from 'ora';
 import { ThemeError } from './ui/theme_error.js';
+import { ThemeFilesUtils } from '../features/theme/utils/files/theme_files_utils.js';
 import { LOGGER_API_NAME } from '../../cli/utilities/features/logger/logger_constants.js';
 export class ThemeVerifyCommand extends BaseThemeCommand {
     static description = 'Verify theme files structure';
@@ -39,7 +39,7 @@ export class ThemeVerifyCommand extends BaseThemeCommand {
             themeDir: executionContext.themeRootDir,
             loggerApi
         });
-        const permissions = await ThemeFilesStructureUtils.getFilesPermissions(executionContext.themeRootDir);
+        const permissions = await ThemeFilesUtils.getFilesPermissions(executionContext.themeRootDir);
         if (!themeChecksums || !permissions)
             this.error('Theme checksums or permissions not found. Please ensure you are in the correct theme directory.');
         let spinner;
@@ -56,7 +56,7 @@ export class ThemeVerifyCommand extends BaseThemeCommand {
                 themeId: executionContext.themeId,
                 credentials
             });
-            const filesStructure = await ThemeFilesStructureUtils.getThemeFilesStructure(executionContext.themeRootDir);
+            const filesStructure = await ThemeFilesUtils.getThemeFilesStructure(executionContext.themeRootDir);
             if (!filesStructure) {
                 renderOnce(React.createElement(MissingThemeFiles, { files: `${SHOPER_THEME_METADATA_DIR}/${THEME_FILES_STRUCTURE_FILE_NAME}` }));
                 return;

package/build/theme/commands/ui/theme_error.js

@@ -9,18 +9,18 @@ import React from 'react';
 import { ThemeWorkUrlMismatch } from './theme_work_url_mismatch.js';
 import { EXECUTION_CONTEXTS } from '../../../cli/features/execution_context/execution_context_constants.js';
 export const ThemeError = ({ err, executionContext }) => {
-    if (err?.code === THEME_ACTION_NOT_FOUND_ERROR_CODE && executionContext?.type === EXECUTION_CONTEXTS.theme) {
+    if (err?.tags?.code === THEME_ACTION_NOT_FOUND_ERROR_CODE && executionContext?.type === EXECUTION_CONTEXTS.theme) {
         return (React.createElement(UnpermittedCommandError, { themeId: executionContext.themeId, commandName: "verify" }));
     }
-    if (err?.code === THEME_ARCHIVE_UPLOAD_ERROR) {
+    if (err?.tags?.code === THEME_ARCHIVE_UPLOAD_ERROR) {
         return React.createElement(ValidationErrors, { errors: err?.details });
     }
-    if (err?.code === THEME_WORK_URL_MISMATCH_ERROR) {
+    if (err?.tags?.code === THEME_WORK_URL_MISMATCH_ERROR) {
         return React.createElement(ThemeWorkUrlMismatch, { command: "verify" });
     }
-    if (err?.code === THEME_FILES_UPLOAD_ERROR) {
-        return (React.createElement(Error, { header: "Uploading theme files to the shop failed.\n" },
-            React.createElement(Text, null, "The rejected files have been removed locally. Please ensure that the files are not corrupted and that the file extensions are supported.")));
+    if (err?.tags?.code === THEME_FILES_UPLOAD_ERROR) {
+        return (React.createElement(Error, { header: "Uploading theme files to the shop failed." },
+            React.createElement(Text, null, "Please ensure that the files are not corrupted and that the file extensions are supported or file size is not too large.")));
     }
     if (err?.message) {
         return React.createElement(ValidationErrors, { errors: err.message });

package/build/theme/commands/watch/theme_watch_command.js

@@ -0,0 +1,89 @@
+import { BaseThemeCommand } from '../../class/base_theme_command.js';
+import { CLI_AUTH_API_NAME } from '../../../cli/auth/cli_auth_constants.js';
+import { THEME_ACTIONS_API_NAME, THEME_ACTIONS_TYPES } from '../../features/theme/actions/theme_actions_constants.js';
+import { EXECUTION_CONTEXT_API_NAME, EXECUTION_CONTEXTS } from '../../../cli/features/execution_context/execution_context_constants.js';
+import { THEME_WATCH_API_NAME } from '../../features/theme/watch/theme_watch_constants.js';
+import { render, renderOnce } from '../../../ui/ui_utils.js';
+import { MissingCredentialsError } from '../../../cli/commands/auth/ui/missing_credentials_error.js';
+import { OutsideOfThemeDirectoryContextError } from '../ui/ouside_of_theme_directory_context_error.js';
+import { UnpermittedCommandError } from '../ui/unpermitted_command_error.js';
+import React from 'react';
+import { ThemeChecksums } from '../../class/checksums/theme_checksums.js';
+import { ThemeMetaDataUtils } from '../../features/theme/utils/meta_data/theme_meta_data_utils.js';
+import { ThemeFilesUtils } from '../../features/theme/utils/files/theme_files_utils.js';
+import { MissingThemeFiles } from '../ui/missing_theme_files.js';
+import { SHOPER_THEME_METADATA_DIR } from '../../constants/directory_contstants.js';
+import { THEME_FILES_STRUCTURE_FILE_NAME } from '../../features/theme/theme_constants.js';
+import { ThemeFilesUpload } from '../../class/files_upload/theme_files_upload.js';
+import { ThemeFilesUploadHttpApi } from '../../class/files_upload/theme_files_upload_http_api.js';
+import { HTTP_REQUESTER_API_NAME } from '@dreamcommerce/star_core';
+import { LOGGER_API_NAME } from '../../../cli/utilities/features/logger/logger_constants.js';
+import { Watch } from './watch.js';
+import { Flags } from '@oclif/core';
+import { ThemeError } from '../ui/theme_error.js';
+import { retro } from 'gradient-string';
+export class ThemeWatchCommand extends BaseThemeCommand {
+    static summary = `Watch local theme files for changes and update your store preview in real time. ${retro('[BETA]')}`;
+    static description = `Continuously monitors your local theme files for any changes and uploads them automatically to your store. Your store preview will refresh in real time to reflect updates immediately.\n\nYou must run this command from a specific theme directory (ID not needed).`;
+    static examples = [
+        {
+            description: 'This will replace the store version with your local copy on files modification.',
+            command: '<%= config.bin %> <%= command.id %>'
+        }
+    ];
+    static flags = {
+        open: Flags.boolean({
+            description: 'Open the store preview in your default web browser when watching starts.',
+            required: false,
+            default: false
+        })
+    };
+    async run() {
+        const cliAuthApi = this.getApi(CLI_AUTH_API_NAME);
+        const loggerApi = this.getApi(LOGGER_API_NAME);
+        const themeWatchApi = this.getApi(THEME_WATCH_API_NAME);
+        const themeActionsApi = this.getApi(THEME_ACTIONS_API_NAME);
+        const executionContextApi = this.getApi(EXECUTION_CONTEXT_API_NAME);
+        const credentials = cliAuthApi.getCredentials();
+        const { flags } = await this.parse(ThemeWatchCommand);
+        if (!credentials) {
+            renderOnce(React.createElement(MissingCredentialsError, null));
+            return;
+        }
+        const executionContext = await executionContextApi.getExecutionContext();
+        if (executionContext.type !== EXECUTION_CONTEXTS.theme) {
+            renderOnce(React.createElement(OutsideOfThemeDirectoryContextError, null));
+            return;
+        }
+        try {
+            const themeChecksums = new ThemeChecksums({
+                themeDir: executionContext.themeRootDir,
+                loggerApi
+            });
+            await ThemeMetaDataUtils.ensureThemeWorkUrlMatch(executionContext.themeRootDir, credentials.shopUrl);
+            const watchAction = themeActionsApi.getThemeAction({
+                actionType: THEME_ACTIONS_TYPES.partialPush,
+                themeId: executionContext.themeId,
+                credentials
+            });
+            if (!watchAction) {
+                renderOnce(React.createElement(UnpermittedCommandError, { themeId: executionContext.themeId, commandName: "watch" }));
+                return;
+            }
+            const filesStructure = await ThemeFilesUtils.getThemeFilesStructure(executionContext.themeRootDir);
+            if (!filesStructure) {
+                renderOnce(React.createElement(MissingThemeFiles, { files: `${SHOPER_THEME_METADATA_DIR}/${THEME_FILES_STRUCTURE_FILE_NAME}` }));
+                return;
+            }
+            const themeFilesUploadApi = new ThemeFilesUpload({
+                themeRootDir: executionContext.themeRootDir,
+                credentials,
+                themeFilesUploadHttpApi: new ThemeFilesUploadHttpApi(this.getApi(HTTP_REQUESTER_API_NAME))
+            });
+            return render(React.createElement(Watch, { executionContext: executionContext, themeChecksums: themeChecksums, credentials: credentials, themeWatchApi: themeWatchApi, themeFilesUploadApi: themeFilesUploadApi, filesStructure: filesStructure, action: watchAction, openBrowser: flags.open }));
+        }
+        catch (err) {
+            renderOnce(React.createElement(ThemeError, { err: err, executionContext: executionContext }));
+        }
+    }
+}

package/build/theme/commands/watch/theme_watch_constants.js

@@ -0,0 +1,21 @@
+export const WATCH_COMMANDS_NAMES = {
+    quit: 'quit',
+    open: 'open',
+    clear: 'clear'
+};
+export const WATCH_COMMANDS = [
+    {
+        key: WATCH_COMMANDS_NAMES.quit,
+        description: 'Exit watch mode'
+    },
+    {
+        key: WATCH_COMMANDS_NAMES.open,
+        description: "Open the theme in a new tab in the browser if it's not already open."
+    },
+    {
+        key: WATCH_COMMANDS_NAMES.clear,
+        description: 'Clear the logs from the screen.'
+    }
+];
+export const MAX_WATCH_LOGS = 300;
+export const COMMAND_PREFIX = '/';